@c4a/context-cli 0.6.1-beta.3 → 0.6.1-beta.4

package/providers/context/manifest.json

@@ -2,21 +2,26 @@
   "schema": "agent-graph.bundle.v1",
   "provider": {
     "id": "c4a/context",
-    "version": "0.6.1-beta.3"
+    "version": "0.6.1-beta.4"
   },
   "providerManifest": "provider.yaml",
   "graphs": [
     {
       "id": "workspace",
       "path": "graphs/workspace.yaml",
-      "digest": "sha256:3c4b97d96ce824e179b358e45e471b91269749d397b07ff6cb3cea0646024e80"
+      "digest": "sha256:9f434f63af920ad70aee7bb7b74c3a4be2ecfdad1c9c39a5ee0927f917857325"
     }
   ],
   "actions": [
+    {
+      "id": "accept-package-templates",
+      "path": "actions/accept-package-templates.yaml",
+      "digest": "sha256:e3de218f2dc37c9d3ab9546e408598c7b320f7151e8c520a00770919088a6a66"
+    },
     {
       "id": "align-next",
       "path": "actions/align-next.yaml",
-      "digest": "sha256:6370fc4db94177da33b3343c5a83bb8c1162637f676a05ff5a674afd98959e59"
+      "digest": "sha256:8f2a7203d5b631c0b1e6cc14d4d70acbf8ac0197b3cfd19fa3111212ffb47498"
     },
     {
       "id": "apply-managed-review",
@@ -138,22 +143,22 @@
     {
       "id": "context.sdk.package-outputs",
       "path": "resources/manuals/guides/package-outputs.md",
-      "digest": "sha256:8d126ee768aeaea62a176b7d3cf8ca4d822b540fbdce362c5474f487f37c203a"
+      "digest": "sha256:bddba5a43edd230583dc286f74992e28a29bda73382799fa0ca0bf1a23014ec5"
     },
     {
       "id": "context.sdk.package-templates",
       "path": "resources/manuals/reference/package-templates.md",
-      "digest": "sha256:18ffe52eafbece3a8d3595377e26aeb3aba8078a83161e942bb3093495cc6610"
+      "digest": "sha256:ea34fa9a683915c8508d95423e3d87111349fc927accad4761ecfa3bd3204db1"
     },
     {
       "id": "context.sdk.project-api",
       "path": "resources/manuals/reference/project-api.md",
-      "digest": "sha256:fa9e6d2eb48f4ae74b560b77c8f490ca723d6e070be30217643f0515cebc6cf1"
+      "digest": "sha256:9156aeb7142cfe1412d20378564f6c04645015d86bde51d004852d3478c2013c"
     },
     {
       "id": "context.sdk.template-variables",
       "path": "resources/manuals/reference/template-variables.md",
-      "digest": "sha256:96c060cf4b70c3d4d49f88b4eebc19c47f2f1d4525deaaae72e784eabc850b9e"
+      "digest": "sha256:7986bb2604ea72fd485d9b6188974f225139a2c976b2bb37e28d2b43f09868d2"
     },
     {
       "id": "context.semantic.align.align-gates",
@@ -163,7 +168,7 @@
     {
       "id": "context.semantic.align.candidate-resolution",
       "path": "resources/semantic/align/candidate-resolution.md",
-      "digest": "sha256:138b81c0a393cce25da442951d8a23eafdef5279d18caf6d6f9f50772b65ef11"
+      "digest": "sha256:5c34122ec74ebd33b99b73c6c23b11dc7d80bd370133ed5fc77dee7ddadb1598"
     },
     {
       "id": "context.semantic.align.density-profile",
@@ -173,7 +178,7 @@
     {
       "id": "context.semantic.align.structure-planning",
       "path": "resources/semantic/align/structure-planning.md",
-      "digest": "sha256:08f4dab4f53583415155a869be821b4ce2f275bc197be8976a38d3b30a66aa39"
+      "digest": "sha256:c6d8902f7f70857596d3486307bb5e58ffaac6efd6021451e487c92ceb86f87d"
     },
     {
       "id": "context.semantic.compile.index",
@@ -200,6 +205,11 @@
       "path": "resources/views/workspace-current.yaml",
       "digest": "sha256:712d146a1538e47d09c0cfad9961c5ad1c7ebb7e9796a52c0b0bdb6007f50dc1"
     },
+    {
+      "id": "diagnostic.projection-stale",
+      "path": "resources/diagnostics/projection-stale.md",
+      "digest": "sha256:7152211db8b97ab5b1982fec2a18954c4f04823ee383451a7fcc20713dbc567e"
+    },
     {
       "id": "diagnostic.verification",
       "path": "resources/diagnostics/verification.md",
@@ -223,7 +233,7 @@
     {
       "id": "dialogue.document-classification",
       "path": "resources/dialogue/document-classification.md",
-      "digest": "sha256:f7299c80f5db59ee7f14434747dd2f127638e0775ae794d6f2f456c14b80e84a"
+      "digest": "sha256:679db260d5c496fae2a1526ea27c76220e62e782259ef21a216a30cf868d791f"
     },
     {
       "id": "dialogue.evidence-maintenance",
@@ -243,7 +253,7 @@
     {
       "id": "dialogue.package-output",
       "path": "resources/dialogue/package-output.md",
-      "digest": "sha256:12a8756d74240a6f705592498bf8b3f19e6708146db395ed3eea691751e2519d"
+      "digest": "sha256:0ca7a9e56397f9acc62d92777d91e0203e2d6caa7f08268dca8037987e5911a5"
     },
     {
       "id": "dialogue.source-boundary",
@@ -258,22 +268,22 @@
     {
       "id": "procedure.close-and-build",
       "path": "resources/procedures/close-and-build.md",
-      "digest": "sha256:02e91b42cf9faec65bbbb27de512298b4715b9808f1ec364022b34145173dd3d"
+      "digest": "sha256:19c630e9c4c05f5b430df603fb705731427d2ef4bfcaf83a1b653d364164cae2"
     },
     {
       "id": "procedure.code-extraction",
       "path": "resources/procedures/code-extraction.md",
-      "digest": "sha256:08128c7447f0d36ea57ed8c16844974305fef1bd6ca6c2b395a19182d3b25a67"
+      "digest": "sha256:35e32f68c2e3142271e178964fb08079e340cf2b7ea3f7714121e951248d2e08"
     },
     {
       "id": "procedure.document-capture",
       "path": "resources/procedures/document-capture.md",
-      "digest": "sha256:a9e26b26a230f2b3ee4d06c978080aba21e2a4cf60cbadb1454141cb7a269edf"
+      "digest": "sha256:07f8ccfe3429c28f7dd6b732821911b9636e9a0a9f1b6034986dce669b416248"
     },
     {
       "id": "procedure.document-classification",
       "path": "resources/procedures/document-classification.md",
-      "digest": "sha256:eae7ce95e0e61e90b71be5b020e49f64f14a04833ecb618509ca5fd3cfb34176"
+      "digest": "sha256:d248973ad671531334cd0c9f485183f40a9a78d0125186de5980d6b1099b940b"
     },
     {
       "id": "procedure.evidence-maintenance",
@@ -288,7 +298,7 @@
     {
       "id": "procedure.package-output",
       "path": "resources/procedures/package-output.md",
-      "digest": "sha256:71a0383807009ec69127e2f2c5eaf2faa353c6ddbbd473f7212f9aa3deb09e73"
+      "digest": "sha256:c088c2341fa64caa25a04c3cef75635b2f635a932bfc7326b35cff59fc390b29"
     },
     {
       "id": "procedure.project-configuration",
@@ -298,7 +308,7 @@
     {
       "id": "procedure.prose-align",
       "path": "resources/procedures/prose-align.md",
-      "digest": "sha256:4ea3cb46268d4bfdb3848f6028b25a7645524ac75965528cccce52b32afb1e89"
+      "digest": "sha256:e8357e1e0100d4de39a7c96bb910cdd14e806d0847153ffed6c9a5e784ab72b4"
     },
     {
       "id": "procedure.prose-compile",
@@ -327,6 +337,11 @@
       "path": "schemas/evidence-maintenance-input.schema.json",
       "digest": "sha256:7d1c0a9cc20200b90495bea82337d2c0e42d9eff3c1e3eeeb7258226fd96c542"
     },
+    {
+      "id": "schemas/prose-structure-batch.schema.json",
+      "path": "schemas/prose-structure-batch.schema.json",
+      "digest": "sha256:fc4ebbb5ee81ae77238cd60350ebac16f55e8a5adf3f5f5db411040474e01842"
+    },
     {
       "id": "schemas/source-batch-input.schema.json",
       "path": "schemas/source-batch-input.schema.json",
@@ -334,9 +349,13 @@
     }
   ],
   "files": [
+    {
+      "path": "actions/accept-package-templates.yaml",
+      "digest": "sha256:e3de218f2dc37c9d3ab9546e408598c7b320f7151e8c520a00770919088a6a66"
+    },
     {
       "path": "actions/align-next.yaml",
-      "digest": "sha256:6370fc4db94177da33b3343c5a83bb8c1162637f676a05ff5a674afd98959e59"
+      "digest": "sha256:8f2a7203d5b631c0b1e6cc14d4d70acbf8ac0197b3cfd19fa3111212ffb47498"
     },
     {
       "path": "actions/apply-managed-review.yaml",
@@ -424,15 +443,19 @@
     },
     {
       "path": "codes.yaml",
-      "digest": "sha256:6531ae89477878227e487dde7caf986c58cfdae63034548ff3f140f3777a2a4b"
+      "digest": "sha256:cee059821edb0cf7601189649172418031ec145438e0647a248813c6255f0d55"
     },
     {
       "path": "graphs/workspace.yaml",
-      "digest": "sha256:3c4b97d96ce824e179b358e45e471b91269749d397b07ff6cb3cea0646024e80"
+      "digest": "sha256:9f434f63af920ad70aee7bb7b74c3a4be2ecfdad1c9c39a5ee0927f917857325"
     },
     {
       "path": "provider.yaml",
-      "digest": "sha256:f05c81fbb86e6e34289d0828c04a15336dafaa8fcc122e49afc7496a00e97ac3"
+      "digest": "sha256:eeb8cce29af50ee696ff1594ab705992afac9c04ac2ad48831f0bd69aeb99f78"
+    },
+    {
+      "path": "resources/diagnostics/projection-stale.md",
+      "digest": "sha256:7152211db8b97ab5b1982fec2a18954c4f04823ee383451a7fcc20713dbc567e"
     },
     {
       "path": "resources/diagnostics/verification.md",
@@ -452,7 +475,7 @@
     },
     {
       "path": "resources/dialogue/document-classification.md",
-      "digest": "sha256:f7299c80f5db59ee7f14434747dd2f127638e0775ae794d6f2f456c14b80e84a"
+      "digest": "sha256:679db260d5c496fae2a1526ea27c76220e62e782259ef21a216a30cf868d791f"
     },
     {
       "path": "resources/dialogue/evidence-maintenance.md",
@@ -468,7 +491,7 @@
     },
     {
       "path": "resources/dialogue/package-output.md",
-      "digest": "sha256:12a8756d74240a6f705592498bf8b3f19e6708146db395ed3eea691751e2519d"
+      "digest": "sha256:0ca7a9e56397f9acc62d92777d91e0203e2d6caa7f08268dca8037987e5911a5"
     },
     {
       "path": "resources/dialogue/source-boundary.md",
@@ -480,35 +503,35 @@
     },
     {
       "path": "resources/manuals/guides/package-outputs.md",
-      "digest": "sha256:8d126ee768aeaea62a176b7d3cf8ca4d822b540fbdce362c5474f487f37c203a"
+      "digest": "sha256:bddba5a43edd230583dc286f74992e28a29bda73382799fa0ca0bf1a23014ec5"
     },
     {
       "path": "resources/manuals/reference/package-templates.md",
-      "digest": "sha256:18ffe52eafbece3a8d3595377e26aeb3aba8078a83161e942bb3093495cc6610"
+      "digest": "sha256:ea34fa9a683915c8508d95423e3d87111349fc927accad4761ecfa3bd3204db1"
     },
     {
       "path": "resources/manuals/reference/project-api.md",
-      "digest": "sha256:fa9e6d2eb48f4ae74b560b77c8f490ca723d6e070be30217643f0515cebc6cf1"
+      "digest": "sha256:9156aeb7142cfe1412d20378564f6c04645015d86bde51d004852d3478c2013c"
     },
     {
       "path": "resources/manuals/reference/template-variables.md",
-      "digest": "sha256:96c060cf4b70c3d4d49f88b4eebc19c47f2f1d4525deaaae72e784eabc850b9e"
+      "digest": "sha256:7986bb2604ea72fd485d9b6188974f225139a2c976b2bb37e28d2b43f09868d2"
     },
     {
       "path": "resources/procedures/close-and-build.md",
-      "digest": "sha256:02e91b42cf9faec65bbbb27de512298b4715b9808f1ec364022b34145173dd3d"
+      "digest": "sha256:19c630e9c4c05f5b430df603fb705731427d2ef4bfcaf83a1b653d364164cae2"
     },
     {
       "path": "resources/procedures/code-extraction.md",
-      "digest": "sha256:08128c7447f0d36ea57ed8c16844974305fef1bd6ca6c2b395a19182d3b25a67"
+      "digest": "sha256:35e32f68c2e3142271e178964fb08079e340cf2b7ea3f7714121e951248d2e08"
     },
     {
       "path": "resources/procedures/document-capture.md",
-      "digest": "sha256:a9e26b26a230f2b3ee4d06c978080aba21e2a4cf60cbadb1454141cb7a269edf"
+      "digest": "sha256:07f8ccfe3429c28f7dd6b732821911b9636e9a0a9f1b6034986dce669b416248"
     },
     {
       "path": "resources/procedures/document-classification.md",
-      "digest": "sha256:eae7ce95e0e61e90b71be5b020e49f64f14a04833ecb618509ca5fd3cfb34176"
+      "digest": "sha256:d248973ad671531334cd0c9f485183f40a9a78d0125186de5980d6b1099b940b"
     },
     {
       "path": "resources/procedures/evidence-maintenance.md",
@@ -520,7 +543,7 @@
     },
     {
       "path": "resources/procedures/package-output.md",
-      "digest": "sha256:71a0383807009ec69127e2f2c5eaf2faa353c6ddbbd473f7212f9aa3deb09e73"
+      "digest": "sha256:c088c2341fa64caa25a04c3cef75635b2f635a932bfc7326b35cff59fc390b29"
     },
     {
       "path": "resources/procedures/project-configuration.md",
@@ -528,7 +551,7 @@
     },
     {
       "path": "resources/procedures/prose-align.md",
-      "digest": "sha256:4ea3cb46268d4bfdb3848f6028b25a7645524ac75965528cccce52b32afb1e89"
+      "digest": "sha256:e8357e1e0100d4de39a7c96bb910cdd14e806d0847153ffed6c9a5e784ab72b4"
     },
     {
       "path": "resources/procedures/prose-compile.md",
@@ -548,7 +571,7 @@
     },
     {
       "path": "resources/semantic/align/candidate-resolution.md",
-      "digest": "sha256:138b81c0a393cce25da442951d8a23eafdef5279d18caf6d6f9f50772b65ef11"
+      "digest": "sha256:5c34122ec74ebd33b99b73c6c23b11dc7d80bd370133ed5fc77dee7ddadb1598"
     },
     {
       "path": "resources/semantic/align/density-profile.md",
@@ -560,7 +583,7 @@
     },
     {
       "path": "resources/semantic/align/structure-planning.md",
-      "digest": "sha256:08f4dab4f53583415155a869be821b4ce2f275bc197be8976a38d3b30a66aa39"
+      "digest": "sha256:c6d8902f7f70857596d3486307bb5e58ffaac6efd6021451e487c92ceb86f87d"
     },
     {
       "path": "resources/semantic/compile/index.md",
@@ -594,6 +617,10 @@
       "path": "schemas/evidence-maintenance-input.schema.json",
       "digest": "sha256:7d1c0a9cc20200b90495bea82337d2c0e42d9eff3c1e3eeeb7258226fd96c542"
     },
+    {
+      "path": "schemas/prose-structure-batch.schema.json",
+      "digest": "sha256:fc4ebbb5ee81ae77238cd60350ebac16f55e8a5adf3f5f5db411040474e01842"
+    },
     {
       "path": "schemas/source-batch-input.schema.json",
       "digest": "sha256:aa5f1a1bf6a6573982e89e50c9d991f6aa72a5cbbda0867d1f483e30315c4409"
@@ -606,5 +633,5 @@
   "graphDependencies": {
     "workspace": []
   },
-  "digest": "sha256:04d64bac7e963b9074ab27a621487b0980e09bf4be0c383fc6a3f240e5ee16d5"
+  "digest": "sha256:205b1a6b67593d9ef793fb6468bb5bb03f534bd37a16aa762cb6689a43bc2a00"
 }

package/providers/context/provider.yaml

@@ -1,6 +1,6 @@
 schema: agent-graph.provider.v1
 id: c4a/context
-version: 0.6.1-beta.3
+version: 0.6.1-beta.4
 name: Context workflow
 description: Internal work contract for Context knowledge workspaces.
 graphs:

package/providers/context/resources/diagnostics/projection-stale.md

@@ -0,0 +1,13 @@
+---
+schema: agent-graph.resource.v1
+id: diagnostic.projection-stale
+kind: diagnostic
+mediaType: text/markdown
+---
+
+# Approved projection is stale
+
+Approved Markdown changed successfully. Its derived `knowledge/structure.yaml`
+projection has not been rebuilt yet. Run only the revision-bound close command
+selected by the current Route. This is an expected lifecycle transition, not a
+content verification failure.

package/providers/context/resources/dialogue/document-classification.md

@@ -7,7 +7,8 @@ mediaType: text/markdown
 # Document-classification dialogue
 
 Do not recommend a collection before reading the collection-neutral evidence
-view. Summarize the observed document shape, explain one evidence-backed
+view and every required source-body resource. Summarize the observed document
+shape, explain one evidence-backed
 recommendation, and describe its package root:
 
 | Collection | Use when the evidence primarily represents | Package root |

package/providers/context/resources/dialogue/package-output.md

@@ -19,13 +19,11 @@ with more than the configured threshold gets its own child index. Templates
 under `src/package-templates/` are editable presentation, not a second factual
 source.
 
-After the user chooses an Agent knowledge-base package, explain that the
-package name is its default single-level knowledge namespace. Ask for an
-override only when the user needs another single- or multi-segment path. Each
-segment may use lowercase letters and numbers joined by hyphens or dots. Ask
-separately whether Skills need a short optional prefix, then maintain their
-complete final names in the template. Do not expose downstream layout-version
-terminology or ask for platform-specific identity fields.
+After the user chooses an Agent knowledge-base package, explain that its
+knowledge roots are flat inside `dist/<package-name>/`; do not ask for a second
+package namespace. Ask whether Skills need a short optional prefix, then
+maintain their complete final names in the template. Do not expose downstream
+layout terminology or ask for platform-specific identity fields.
 
 Do not offer a hidden `both` shortcut. If the user wants multiple outputs,
 declare and inspect one first, then obtain confirmation for the next. Mention

package/providers/context/resources/manuals/guides/package-outputs.md

@@ -49,8 +49,7 @@ least one `SKILL.md` and `wikis/index.md`.
 The default `src/package-templates/kb/` template is only a starting point.
 Inspect the generated `dist/<package-name>/` before calling it usable.
 
-KB packages use their package name as a single-level knowledge namespace by
-default:
+KB packages use flat package-relative knowledge roots:
 
 ```ts
 kbPackage({
@@ -59,44 +58,43 @@ kbPackage({
 });
 ```
 
-This keeps the build folder name independent from install paths and produces
-paths such as:
+The package name already identifies the surrounding build folder, so the
+output does not repeat it inside each root:
 
 ```text
 skills/knowledge-query/SKILL.md
-wikis/component-lib-kb/index.md
-guides/component-lib-kb/...
-rules/component-lib-kb/...
-feats/component-lib-kb/...
+wikis/index.md
+guides/...
+rules/...
+feats/...
 ```
 
-Ask for a custom namespace only when the user needs something other than the
-package name. An explicit value may contain multiple safe lowercase path
-segments:
-
-```ts
-distribution: { knowledgeNamespace: "platform/component-lib" }
-```
-
-Each segment may contain letters and numbers joined by hyphens or dots; keep
-the complete value concise and stable. Context treats it as an opaque knowledge
-path and does not infer downstream platform identifiers or classify package
-content.
+Do not ask for another distribution namespace. Older workspaces may still
+contain `distribution.knowledgeNamespace`; Context accepts that legacy input
+without using it to shape the package.
 
 Skill names are separate. Ask whether the author wants a short optional Skill
 prefix, then maintain the complete final template directory name directly—for
-example `skills/android-query/SKILL.md`. Context never prepends the knowledge
-namespace to a Skill name.
+example `skills/android-query/SKILL.md`. Package-root layout never renames a
+Skill.
 
-The default `knowledge-query` skill carries the structure-first query
-discipline: start from OKF directory indexes, use
+The default `knowledge-query` Skill is a complete generic query entry. It
+carries the structure-first query discipline: start from OKF directory indexes, use
 `context-build-inventory.json` edge records for package-visible relationships,
 inspect page `sources` / `context:section` source_ref metadata, cite
 page/section evidence, and report explicit gaps when the package does not cover
 a requested fact. It does not treat direct grep over bundled OKF root
-directories as the primary discovery path. Users can edit any template file
-under `src/package-templates/kb/` before build to create their own skills,
-prompts, routing rules, or package instructions.
+directories as the primary discovery path. Its final template-author section
+requires package authors to replace or edit the generic routing when the
+package needs project-specific terminology, entry points, known limits, or
+task workflows. Authors may explicitly accept the generic default when it is
+intentionally sufficient.
+
+The same inventory exposes `structure.relationship_coverage`. It records
+whether selected codegraph pages have current source-backed AST relationship
+metadata, how many codegraph views were selected, and how many package-visible
+edges were emitted. An empty edge list is therefore explicit evidence of a
+coverage state, not permission to invent a dependency.
 
 The generated `wikis/` directory is the default OKF root and follows the C4A OKF
 Profile. Internal production collections are mapped into package OKF roots such
@@ -109,9 +107,8 @@ contain Markdown with OKF fields and C4A extension fields at the top level, plus
 `visibility`, and `code_symbols` are not nested under `context`, and page
 frontmatter does not contain `source_refs`. The package root is an agent
 package; the OKF-compatible interchange surface is the selected OKF root
-subtrees under `dist/<package-name>/`. The required logical template entry is
-`wikis/index.md`; a namespaced package writes it to
-`wikis/<knowledge-namespace>/index.md`.
+subtrees under `dist/<package-name>/`. The required template entry and final
+output path are both `wikis/index.md`.
 
 Current collection mapping:
 
@@ -142,7 +139,8 @@ occupies `wikis/**/index.md`.
 Tell the user it can be edited before build to describe the package scope,
 intended users, and query guidance.
 
-The default root index is a starter, not a finished information architecture.
+The default root index is a usable generic entry, not a project-specific
+information architecture.
 It links directly to pages in small child directories and to a child
 `index.md` when that directory exceeds the configured navigation threshold.
 The default threshold is 50 selected knowledge pages. Use Handlebars variables such as
@@ -150,6 +148,13 @@ The default threshold is 50 selected knowledge pages. Use Handlebars variables s
 custom navigation. Before customizing it, read
 `node_modules/@c4a/context/docs/reference/template-variables.md`.
 
+Newly initialized generic templates must be replaced, edited, or explicitly
+accepted before the first build. `context status` exposes that choice as a
+package template Review Gate. Use only the revision-bound command returned by
+that Route to accept an unchanged generic default; edit files under
+`src/package-templates/` when customizing. Context compares file digests and
+records the decision without evaluating the meaning of template prose.
+
 Template paths are rendered before selected knowledge is copied. A rendered
 template path must not collide with a selected knowledge path. If the build
 reports a collision, rename the template file or exclude that knowledge path
@@ -236,12 +241,10 @@ We can also skip package output for now and keep only knowledge/.
 Which one should I declare first?
 ```
 
-If the user chooses the Agent knowledge-base package, explain that its package
-name is already the default knowledge namespace. Ask for an override only when
-the user needs a different single- or multi-segment path. Ask separately whether
-its Skills need a short prefix. Treat these as independent choices: the
-knowledge namespace controls only OKF roots, while the author maintains final
-Skill names.
+If the user chooses the Agent knowledge-base package, explain that its OKF
+roots are flat within `dist/<package-name>/`; do not ask for a second namespace.
+Ask whether its Skills need a short prefix. The author maintains final Skill
+names independently from package paths.
 
 Do not offer `both` as a shortcut. If the user wants multiple outputs, add one
 package first, verify the shape, then add another package after confirmation.