Repository navigation
v2 Stage 5: docs, versioning, hand-off #75
Description
Part of #69.
Stage 5 — docs, versioning, hand-off
Branch: feat/v2-stage5-docs-release
Deliverables:
README.mdrewrite: v2 model + four levels + Architecture & Tooling (incl. the Scalpel decision); drop the "queryable slicer" product framing.CLAUDE.md+AGENTS.mdrewrite describing schema v2 in detail (verifygit ls-files AGENTS.md; un-ignore if the global gitignore hides it)..claude/SCHEMA_DECISIONS.mdv2 entries:can://grammar, synthetic-vertexof/varvocabulary, Scalpel oracle.- Regenerate
schema.neo4j.jsonat2.0.0; updatetest_neo4j_schema. CHANGELOG.md+ MAJOR version bump inpyproject.toml; regenerate the README--helpblock.- Hand-off bundle (
docs/handoff/): sampleanalysis.jsonper level + agraph.cypher; the schema contract; the CLI--help; the published package name + version to pin (for the separatecldk-sdk-frontendfollow-up).
Gate: full suite green (pytest test/ -q); --emit schema yields 2.0.0; hand-off bundle present.
Expand into full bite-sized tasks with
superpowers:writing-plansat stage start.
Activity
rahlk commentedon Jul 7, 2026
Stage-5 schema task (surfaced in Stage 3 Task 3.6): the Neo4j CPG emitter now writes
PY_DDG.prov(list), but theneo4j/schema.pycatalog declaresPY_DDGwith onlyvar. Runtime-harmless (Neo4j props are schemaless; the catalog only feeds--emit schema+ the currently-skippedtest_neo4j_schema). When re-enablingtest_neo4j_schemain Stage 5: addprov: "string[]"to thePY_DDGRelType, regenerateschema.neo4j.json, and MAJOR-bump the Neo4j SCHEMA_VERSION to 2.0.0.rahlk commentedon Jul 13, 2026
Additional Stage-5 schema-regen cleanup (Task 4.6): the
PyCFGNodeNodeLabel inneo4j/schema.pydeclares a deadof: "string"prop that the emitter never produces (it mapsBodyNode.of→ thevarprop). Drop theofdeclaration before regeneratingschema.neo4j.json, else it surfaces to SDK consumers as an always-null queryable property. (Thecall_nodeint→string retype landed in 4.6 is correct — keep it.)