docs(feat-027, enh-005): port the 0.4 upstream specs#121
Merged
Conversation
Finalize + canonicalize the two framework pieces the agentforge-graph dogfood needs, both accepted for the 0.4 train. Specs only — no code yet. - feat-027 — `KuzuGraphStore`, an embedded file-backed `GraphStore` driver (zero-ops, in-process; the graph analogue of the SQLite MemoryStore). Implements the locked `GraphStore` ABC + passes run_graph_conformance, so it's swap-compatible with Neo4j/SurrealDB. New `agentforge-memory-kuzu` package. No ABC change. Added to the feature catalogue (accepted / 0.4). - enh-005 — `direction: in|out|any` on `GraphExpansion`, so GraphRAG expansion follows asymmetric edges correctly (callers vs callees). Rides the already-locked `get_edges(direction=...)`; defaults to `any` → byte-for-byte backward compatible. No ABC change, no new package. Both ported verbatim from the house-style drafts; canonical numbers already aligned (enh-005 = directional expansion; feat-027 next free). Co-Authored-By: Claude Opus 4.8 (1M context) <noreply@anthropic.com>
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
1 participant
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
Canonicalizes the two framework pieces the
agentforge-graphdogfood needs, both accepted for the 0.4 train. Specs only — no code yet. Ported verbatim from the house-style drafts; canonical numbers already aligned (enh-005 = directional expansion, the reserved slot; feat-027 = next free feature number).Specs
KuzuGraphStore, an embedded, file-backedGraphStoredriver: zero-ops, in-process, persistent at a path (path: .ckg) — the graph analogue of the SQLiteMemoryStore. Implements the lockedGraphStoreABC and passesrun_graph_conformance, so it's swap-compatible with Neo4j/SurrealDB. Newagentforge-memory-kuzupackage. No ABC change (adding a conformant driver is the standard contribution shape — no ADR needed). Makes the whole graph + GraphRAG path testable offline. Added to the feature catalogue.direction: in | out | anyonGraphExpansion, so GraphRAG expansion follows asymmetric edges the right way (callers vs callees, who-cites vs what-it-cites). Rides the already-lockedget_edges(direction=...); no ABC change, no new package;directiondefaults toany→ byte-for-byte backward compatible.Context
These are the only two framework pieces coming out of the code-graph agent epic (~90% of that work lands in the agent itself). They're the first items on the finalized 0.4 roadmap (0.5 = governance Identity + Registry; 0.5/0.6 = durable-execution + Policy; 0.6 = Audit).
Pre-commit green (docs-only; full unit + integration + coverage gates pass unchanged).
🤖 Generated with Claude Code