Plan: first-class HyperVault integration (bootstrap, sync, sovereign archive)#65
Merged
Merged
Conversation
Plans first-class integration of johnnyclem/hypervault into AgentVault: - Three-tier mind architecture (HyperVault cloud / ICP canister / Arweave) - One-line bootstrap: hypervault bootstrap (memories + mind DAG + indices) - One-line sovereign archive: hypervault.store -> encrypted thoughtform bundle -> memory_repo canister -> Arweave, with verify/restore loop - Native MCP server (agentvault mcp serve) exposing the full pipeline - Backbone MemoryStore/KnowledgeStore/WikiStore adapters over HyperVault - Companion hypervault PRs: bulk /api/export, export_vault MCP tool, /api/import/vault restore, archive receipts - Security plan gated on audit finding C-1 (VetKeys GCM tag validation) - 5 implementation phases (~3 weeks), acceptance criteria, risks Co-Authored-By: Claude Fable 5 <noreply@anthropic.com> Claude-Session: https://claude.ai/code/session_01Wu4eXJHiEE1zpDZhArtr7J
|
The latest updates on your projects. Learn more about Vercel for GitHub.
|
This file contains hidden or bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
Sign up for free
to join this conversation on GitHub.
Already have an account?
Sign in to comment
2 participants
Add this suggestion to a batch that can be applied as a single commit.This suggestion is invalid because no changes were made to the code.Suggestions cannot be applied while the pull request is closed.Suggestions cannot be applied while viewing a subset of changes.Only one suggestion per line can be applied in a batch.Add this suggestion to a batch that can be applied as a single commit.Applying suggestions on deleted lines is not supported.You must change the existing code in this line in order to create a valid suggestion.Outdated suggestions cannot be applied.This suggestion has been applied or marked resolved.Suggestions cannot be applied from pending reviews.Suggestions cannot be applied on multi-line comments.Suggestions cannot be applied while the pull request is queued to merge.Suggestion cannot be applied right now. Please check back later.
Summary
Adds
PLAN_HYPERVAULT_INTEGRATION.md— a comprehensive plan for integrating johnnyclem/hypervault into AgentVault as a first-class subsystem, grounded in a full architectural mapping of both codebases.Core thesis
Three tiers of the same agent mind, each able to rebuild the layer above it:
hypervault.store, Supabase): live memories, git-versioned mind, pgvector indices, artifacts, MCP toolsmemory-repo.mogit-style canister mirrors HyperVault's mind DAG commit-for-commitagentvault-hypervault-snapshot-v1thoughtform-bundles with on-chain verification receiptsHeadline one-liners the plan delivers
All pipeline steps are also MCP-available via a proposed native
agentvault mcp serveserver (hypervault_bootstrap,hypervault_archive,hypervault_restore, plus finally serving the existingwiki_*tool definitions).What the plan covers
src/hypervault/module (typed client, snapshot/restore, mind-DAG canister sync, local HNSW + FTS indices, native MCP server) exported asagentvault/hypervaultagentvault hypervaultCLI command group (connect · status · bootstrap · pull · push · snapshot · archive · verify · restore · reindex)MemoryStore/KnowledgeStore/WikiStoreadapters backed by HyperVault (the interfaces were designed for exactly this injection)GET /api/export(currently no wholesale export exists),export_vaultMCP tool,POST /api/import/vaultrestore, archive receiptshv_keys only via env/secrets-vault, AES-256-GCM via the audited-correctCanisterEncryption, and an explicit gate on audit finding C-1 (VetKeysdecryptJSONGCM tag validation) before VetKeys-wrapped keys shipRelationship to existing work
PLAN_VAULT_INTEGRATION.md(HashiCorp-style secrets vault, largely implemented insrc/vault/) is orthogonal and composes with this: HyperVault API keys are stored in that secrets vault.Test plan
tests/hypervault/,tests/mcp-server/) and acceptance criteria🤖 Generated with Claude Code
https://claude.ai/code/session_01Wu4eXJHiEE1zpDZhArtr7J
Generated by Claude Code