vault

name	vault
description	Local research orchestration and state management. Use when starting projects, logging progress, or exporting findings.

Vault

Local orchestration engine for managing long-running research tasks with high reliability and zero external costs.

Core Concepts

• The Vault: A local SQLite database stored in ~/.researchvault/ (configurable via RESEARCHVAULT_DB).
• Project: A high-level research goal.
• Instrumentation: Every event tracks confidence (0.0-1.0), source, and tags.

Workflows

1. Initialize a Project

python3 scripts/vault.py init --id "proj-v1" --objective "Project goal"

2. Multi-Source Research

Use the unified scuttle command with SSRF protection:

python3 scripts/vault.py scuttle "https://example.com" --id "proj-v1"

3. Monitoring & Summary

python3 scripts/vault.py summary --id "proj-v1"
python3 scripts/vault.py status --id "proj-v1"

4. Export

python3 scripts/vault.py export --id "proj-v1" --format markdown --output summary.md

Maintenance

The database is local and excluded from version control.