@c4a/context-cli 0.7.37 → 0.7.38

package/indexers/release-manifest.json

@@ -1,7 +1,7 @@
 {
   "protocol": "context.indexer.cli-release-manifest/v1",
   "package": "@c4a/context-cli",
-  "version": "0.7.37",
+  "version": "0.7.38",
   "issuer": "context4ai/context",
   "bundles": [
     {

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@c4a/context-cli",
-  "version": "0.7.37",
+  "version": "0.7.38",
   "type": "module",
   "description": "Local runtime and Agent integration for traceable knowledge production",
   "license": "MIT",
@@ -24,17 +24,17 @@
   },
   "dependencies": {
     "@c4a/agent-graph": "0.3.0",
-    "@c4a/context": "0.7.37",
-    "@c4a/extract": "0.7.37",
-    "@c4a/extract-contract": "0.7.37",
-    "@c4a/extract-go": "0.7.37",
-    "@c4a/extract-mdx": "0.7.37",
-    "@c4a/extract-proto": "0.7.37",
-    "@c4a/extract-rush": "0.7.37",
-    "@c4a/extract-sql": "0.7.37",
-    "@c4a/extract-style": "0.7.37",
-    "@c4a/extract-thrift": "0.7.37",
-    "@c4a/extract-ts": "0.7.37",
+    "@c4a/context": "0.7.38",
+    "@c4a/extract": "0.7.38",
+    "@c4a/extract-contract": "0.7.38",
+    "@c4a/extract-go": "0.7.38",
+    "@c4a/extract-mdx": "0.7.38",
+    "@c4a/extract-proto": "0.7.38",
+    "@c4a/extract-rush": "0.7.38",
+    "@c4a/extract-sql": "0.7.38",
+    "@c4a/extract-style": "0.7.38",
+    "@c4a/extract-thrift": "0.7.38",
+    "@c4a/extract-ts": "0.7.38",
     "@mermaid-js/layout-elk": "0.2.0",
     "commander": "^11.0.0",
     "fast-xml-parser": "^5.10.1",

package/plugins/VERSION

@@ -1 +1 @@
-0.7.37
+0.7.38

package/plugins/claude/.claude-plugin/plugin.json

@@ -1,7 +1,7 @@
 {
   "name": "c4a",
   "description": "Start or continue a project-local knowledge workspace through one graph-routed entry.",
-  "version": "0.7.37",
+  "version": "0.7.38",
   "author": {
     "name": "c4a"
   },

package/plugins/codex/.codex-plugin/plugin.json

@@ -1,6 +1,6 @@
 {
   "name": "c4a",
-  "version": "0.7.37",
+  "version": "0.7.38",
   "description": "Start or continue a project-local knowledge workspace through one graph-routed entry.",
   "author": { "name": "c4a" },
   "homepage": "https://github.com/context4ai/c4a",
@@ -10,7 +10,7 @@
   "skills": "./skills/",
   "interface": {
     "displayName": "C4A Context",
-    "shortDescription": "Initialize and advance a local, source-linked project knowledge workspace.\nv0.7.37",
+    "shortDescription": "Initialize and advance a local, source-linked project knowledge workspace.\nv0.7.38",
     "longDescription": "Create a Context workspace and use agent-guided next steps to register sources, run extraction, review candidates, build package outputs, and verify health without silently mutating source repositories.",
     "developerName": "c4a",
     "category": "Productivity",

package/plugins/cursor/.cursor-plugin/plugin.json

@@ -1,7 +1,7 @@
 {
   "name": "c4a",
   "displayName": "C4A Context",
-  "version": "0.7.37",
+  "version": "0.7.38",
   "description": "Start or continue a project-local knowledge workspace through one graph-routed entry.",
   "author": {
     "name": "Context4AI",

package/providers/context/manifest.json

@@ -2,7 +2,7 @@
   "schema": "agent-graph.bundle.v1",
   "provider": {
     "id": "c4a/context",
-    "version": "0.7.37"
+    "version": "0.7.38"
   },
   "providerManifest": "provider.yaml",
   "graphs": [
@@ -333,12 +333,12 @@
     {
       "id": "procedure.production-requirements",
       "path": "resources/procedures/production-requirements.md",
-      "digest": "sha256:d881da8d538efdcef18b7a876f595f0b0098bbac5ea1fd3148e476f63a435dfb"
+      "digest": "sha256:af042f16b3cdbb33db48f4ab318293a96e23eeb10b82686bc54ec7d0372afbbd"
     },
     {
       "id": "procedure.production-stage-files",
       "path": "resources/procedures/production-stage-files.md",
-      "digest": "sha256:d093acf81a07b85cfe2a78e71f7ab301fa8c72e3edac3f5de990b1ff7eaf12f0"
+      "digest": "sha256:7c9264c45631751754e4abdee15db7ca2930859a718fd70459dfd101372df030"
     },
     {
       "id": "procedure.project-configuration",
@@ -388,7 +388,7 @@
     {
       "id": "procedure.work-start-report",
       "path": "resources/procedures/work-start-report.md",
-      "digest": "sha256:1d1bbd3ecc0cb6baf5bd07e51ce3837094741b815ae935129f70363c37257ad8"
+      "digest": "sha256:1c97fc5ceb75c0debc9d042f957e7647d6a4eb270bc1d9670693aae4627f67f4"
     },
     {
       "id": "procedure.workspace-commit",
@@ -575,7 +575,7 @@
     },
     {
       "path": "provider.yaml",
-      "digest": "sha256:8a74deb769bb16186805bdf9e56b7eb7eca8e921a637337643f1ecc447a69d28"
+      "digest": "sha256:46010f2f23a011544cf4c7ef38df0743e44a6d6111b88b6c25d6528de3c71784"
     },
     {
       "path": "resources/contracts/indexer-provider-guide.yaml",
@@ -735,11 +735,11 @@
     },
     {
       "path": "resources/procedures/production-requirements.md",
-      "digest": "sha256:d881da8d538efdcef18b7a876f595f0b0098bbac5ea1fd3148e476f63a435dfb"
+      "digest": "sha256:af042f16b3cdbb33db48f4ab318293a96e23eeb10b82686bc54ec7d0372afbbd"
     },
     {
       "path": "resources/procedures/production-stage-files.md",
-      "digest": "sha256:d093acf81a07b85cfe2a78e71f7ab301fa8c72e3edac3f5de990b1ff7eaf12f0"
+      "digest": "sha256:7c9264c45631751754e4abdee15db7ca2930859a718fd70459dfd101372df030"
     },
     {
       "path": "resources/procedures/project-configuration.md",
@@ -779,7 +779,7 @@
     },
     {
       "path": "resources/procedures/work-start-report.md",
-      "digest": "sha256:1d1bbd3ecc0cb6baf5bd07e51ce3837094741b815ae935129f70363c37257ad8"
+      "digest": "sha256:1c97fc5ceb75c0debc9d042f957e7647d6a4eb270bc1d9670693aae4627f67f4"
     },
     {
       "path": "resources/procedures/workspace-commit.md",
@@ -882,5 +882,5 @@
     "indexer": [],
     "workspace": []
   },
-  "digest": "sha256:bda37ec8c50797ca3c5eb3ceab11095cd51bb1f591a80eb4dcb3957a1447a9cf"
+  "digest": "sha256:a684dded0a4a109355d8c6615b40ff0d55cdd82ed2ee3781bccfc063632c3619"
 }

package/providers/context/provider.yaml

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

package/providers/context/resources/procedures/production-requirements.md

@@ -52,6 +52,9 @@ writing batches are declared in the temporary investigation plan.
 
 After editing, run `context status --format json` and consume its current Route.
 
+Read `context action prepare-current --schema --format json` for the complete
+known-task input contract before creating a stage; no workspace or revision is required.
+
 When article targets and source grouping are already clear, put the existing
 plan fields (`capabilities`, `articles`, optional `indexer_usage`) in a file under
 `.tmp/agent-work/`, omitting only `stage`, which does not exist yet. Each article
@@ -60,27 +63,17 @@ contains `path`, `question`, `sources` and `batch`, with optional `brief` and
 command to prepare those tasks without a separate investigation-plan submission.
 This does not approve the report or permit writing before its applicable scope
 decision.
-When targets are unclear, use normal preparation and investigate the skeletons.
-
-## Configured coverage and the current request
-
-`src/indexers.yaml` describes the workspace's standing coverage configuration.
-Source registration or presence in that configuration does not, by itself, mean
-that the source needs investigation again for this request. For a bounded document
-addition or revision, identify its reader task and actual evidence dependencies;
-reuse existing approved articles and applicable completed work. Do not broaden a
-document task to unrelated code repositories merely because they are configured.
-
-In planning and completion reports distinguish:
-- work requested and completed in this task;
-- specific content gaps established by reading, with their affected reader tasks;
-- source/environment failures, and whether this task depends on those sources.
+When targets are unclear, repeat `--source <source-ref>` on the preparation command
+for the sources selected by this request. Without a selection, only a sole
+configured target is inferred; multiple targets require the Agent to select
+from the user's request, not to ask the user to understand CLI source IDs.
+The CLI prepares only this scope. A source in `evidence_source_scope` remains
+available without becoming an investigation assignment. A later article plan
+can select it in `articles[].sources`; the CLI validates and prepares that
+actual dependency before allowing writing. Missing required evidence still
+blocks the dependent article.
 
-A `pending_scopes` count is workflow state, not a count of missing topics,
-repositories to rewrite, or articles to produce. A Git spawn/baseline-read error
-means source availability could not be checked; it does not prove that existing
-knowledge is absent or obsolete. If unrelated configured sources remain blocked,
-say so as a workflow limitation rather than announcing new investigation work.
-Do not delete configured sources, invent exclusions, clear stage files, or mark
-unread material investigated to make the current task appear complete. Follow the
-returned resolution action when the workflow still needs a decision.
+Long-term configuration additions do not restart an unchanged stage. Plans and
+refreshes track this request's selected investigation and actual article inputs.
+Preserve genuinely unfinished work when extending a multi-stage request; do not
+turn an incremental addition into a whole-workspace refresh.

package/providers/context/resources/procedures/production-stage-files.md

@@ -11,7 +11,9 @@ directories. Read relevant source text before writing; a skeleton is navigation,
 not semantic evidence. Skill names guide work, not article ownership or versions.
 
 Use the [reader organization guidance](knowledge-updates.md#reader-tasks-names-and-reading-order)
-for article names, placement and manually arranged navigation. Check the draft's
+for article names, placement and manually arranged navigation.
+Use `context task adjust --inspect --format json` to obtain current categories,
+reading order and the exact revision before preparing a navigation adjustment. Check the draft's
 main reader task against its planned title and group; adjust through the existing
 plan, revision or knowledge-map flow when needed. A navigation change alone does
 not call for rewriting valid prose.
@@ -57,7 +59,7 @@ current task does not mean other authorized work is finished. New source or purp
 authorization still follows the current Route.
 
 Write results under the returned Agent directory. All submission paths are
-relative to that stage directory, even when the manifest is in `submissions/`.
+relative to `.tmp/agent-work/production-stages/<stage>/`, even when the manifest is in `submissions/`. They are never relative to `.tmp/context-runtime/` or to the manifest location. Each task lists the complete workspace-relative Markdown and reference output paths.
 Copy the CLI's submission template, keep completed tasks only, and keep each
 task's prefilled `input`. Submit the manifest using the returned command.
 Do not edit submitted files until the command returns.

package/providers/context/resources/procedures/work-start-report.md

@@ -184,32 +184,20 @@ a top-level navigation change already required by this procedure.
 
 ## Configured coverage and the current request
 
-`src/indexers.yaml` describes the workspace's standing coverage configuration.
-Source registration or presence in that configuration does not, by itself, mean
-that the source needs investigation again for this request. For a bounded document
-addition or revision, identify its reader task and actual evidence dependencies;
-reuse existing approved articles and applicable completed work. Do not broaden a
-document task to unrelated code repositories merely because they are configured.
-
-In planning and completion reports distinguish:
-- work requested and completed in this task;
-- specific content gaps established by reading, with their affected reader tasks;
-- source/environment failures, and whether this task depends on those sources.
-
-A `pending_scopes` count is workflow state, not a count of missing topics,
-repositories to rewrite, or articles to produce. A Git spawn/baseline-read error
-means source availability could not be checked; it does not prove that existing
-knowledge is absent or obsolete. If unrelated configured sources remain blocked,
-say so as a workflow limitation rather than announcing new investigation work.
-Do not delete configured sources, invent exclusions, clear stage files, or mark
-unread material investigated to make the current task appear complete. Follow the
-returned resolution action when the workflow still needs a decision.
-
-For a bounded addition inside an existing production stage, completed articles can
-enter Review with `context run --deliver --format json`. This retains pending
-configured scopes and unfinished tasks; it does not authorize approval or publish.
-Use this existing delivery path when remaining source failures are unrelated to
-the requested articles. If the selected articles need the missing repository, use
-`context source recovery-plan` and `context source restore` with an explicit local
-checkout or clone decision. Do not ask users to investigate unrelated repositories
-just to deliver saved notes, and do not clear gaps to imitate task completion.
+Long-term source configuration is the authorized reading boundary, not the work
+requested in every conversation. Prepare this request's selected investigation
+sources or known article tasks. Keep unused supporting material available for
+later article plans without treating it as unfinished work. For an addition to
+an existing article, prefer the existing article-revision workflow with the
+selected supporting sources rather than starting unrelated production.
+
+Report this request's planned and completed work. Restore missing sources that
+its investigation or articles actually require. Reference material not selected
+for this work does not need restoration just to complete an independent note.
+Never infer missing knowledge merely from unavailable source-code checkouts.
+
+For an explicitly requested partial delivery, `context run --deliver --format json`
+reviews completed articles while retaining genuine remaining tasks and selected
+investigation. It does not approve or publish articles, and is unnecessary for
+an otherwise completed bounded request. Do not clear unfinished work to force
+completion; ordinary source authorization and citation checks still apply.