@c4a/context-cli 0.7.29 → 0.7.34

package/indexers/release-manifest.json

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

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@c4a/context-cli",
-  "version": "0.7.29",
+  "version": "0.7.34",
   "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.29",
-    "@c4a/extract": "0.7.29",
-    "@c4a/extract-contract": "0.7.29",
-    "@c4a/extract-go": "0.7.29",
-    "@c4a/extract-mdx": "0.7.29",
-    "@c4a/extract-proto": "0.7.29",
-    "@c4a/extract-rush": "0.7.29",
-    "@c4a/extract-sql": "0.7.29",
-    "@c4a/extract-style": "0.7.29",
-    "@c4a/extract-thrift": "0.7.29",
-    "@c4a/extract-ts": "0.7.29",
+    "@c4a/context": "0.7.34",
+    "@c4a/extract": "0.7.34",
+    "@c4a/extract-contract": "0.7.34",
+    "@c4a/extract-go": "0.7.34",
+    "@c4a/extract-mdx": "0.7.34",
+    "@c4a/extract-proto": "0.7.34",
+    "@c4a/extract-rush": "0.7.34",
+    "@c4a/extract-sql": "0.7.34",
+    "@c4a/extract-style": "0.7.34",
+    "@c4a/extract-thrift": "0.7.34",
+    "@c4a/extract-ts": "0.7.34",
     "@mermaid-js/layout-elk": "0.2.0",
     "commander": "^11.0.0",
     "fast-xml-parser": "^5.10.1",

package/plugins/VERSION

@@ -1 +1 @@
-0.7.29
+0.7.34

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.29",
+  "version": "0.7.34",
   "author": {
     "name": "c4a"
   },

package/plugins/claude/commands/context-inspect-search.md

@@ -13,6 +13,11 @@ language. The invocation authorizes read-only investigation of the selected
 knowledge packages, available workspace and identified sources within that scope,
 including isolated source retrieval and bounded non-destructive checks. The Skill
 can run from a global installation with host-provided packages and no workspace.
+The ordinary query path is contained in this file. Reuse instructions already
+read in this response; do not reopen them for each stage. When actual delivery
+requires separate host link or response Skills, read their still-unread main
+instructions together once, and open conditional references only for the case
+being handled. Do not prepare delivery that the host's progress mode skips.
 Resolve scope from the request, conversation and configuration before asking.
 Continue through non-blocking issues; ask only for missing access, genuinely
 unresolved scope or effects outside existing authorization.
@@ -29,9 +34,9 @@ registrations, snapshots, tasks, approvals or user checkouts.
 Resolve `CONTEXT_QUERY_SOURCE_MODE` from the host or Bot instance configuration
 before choosing the first retrieval path. Supported values are:
 
-- `repo-first` (default): inspect the configured knowledge workspace and
-  authorized repository sources first. Use an available package only when the
-  repository path is unavailable or leaves a material gap.
+- `repo-first` (default): search approved `knowledge/` in the configured knowledge
+  workspace first; trace authorized original sources only for material gaps.
+  Use an available package when approved knowledge is unavailable.
 - `package-first`: inspect the selected package first, then use its recorded
   workspace or repository sources for missing, stale or disputed evidence.
 - `dual`: inspect the package and repository paths concurrently, then reconcile
@@ -45,8 +50,10 @@ sources and identify only gaps that affect the answer.
 ## Search available material according to the configured mode
 
 Apply `CONTEXT_QUERY_SOURCE_MODE` before starting retrieval. In `repo-first`,
-start with the configured workspace and reusable source checkouts; do not fetch
-or install a package merely to begin the query. In `package-first`, start with
+start with approved knowledge, not original-code checkout preparation. With
+readable `knowledge/`, do not probe `dist/`, build inventories or installed
+packages: distribution output is not a query prerequisite. An explicit request
+to investigate delivered content is an exception. In `package-first`, start with
 the selected readable package. In `dual`, start both paths concurrently. Search
 each selected path as soon as it is readable; tool checks and authorized
 upgrades must not block independent reading. If a configured primary path is
@@ -66,9 +73,11 @@ missing, use the host's configured, authorized package retrieval mechanism while
 other reading continues. Only check or prepare tools needed for the next actual
 operation; installation failure does not block independent local retrieval.
 
-For gaps or latest-content questions, also search approved knowledge when a workspace is available:
-use `knowledge/structure.yaml` and relevant `knowledge/` paths, trying business
-terms, symbols and synonyms, then read matching sections in context. Delivered
+Search relevant `knowledge/` paths using business terms, symbols and synonyms,
+then read matching sections in context; use `knowledge/structure.yaml` when
+navigation or associations are needed, not as an exhaustive preflight. In
+package-first or dual mode, approved knowledge can resolve gaps or freshness
+questions in delivered material. Delivered
 content may lag approved knowledge; they are not independent corroboration.
 Candidates and temporary reports are not approved pages. A search miss does not
 prove a capability is absent. Do not build merely to answer a query; a separately
@@ -78,8 +87,11 @@ When package or approved knowledge leaves a gap, directly trace relevant sources
 without asking whether to deepen the query. Use available document, code-search
 or extraction tools within the authorized scope, recording source identity and
 version. Prepare sources while continuing other reading.
-One failed source blocks only dependent claims. Answer when evidence is
-sufficient, without completing unnecessary preparation.
+One failed source blocks only dependent claims. If the read knowledge supports
+the requested conclusion, its conditions and scope, answer without restoring
+code or checking every associated source. Missing mechanisms, conflicting facts
+or unsupported current-behavior claims still require targeted investigation;
+an article title, search snippet or unread citation is not sufficient evidence.
 
 ## Trace and retrieve only relevant sources
 
@@ -90,18 +102,23 @@ registry is not a mandatory intermediate step. If the source identity or version
 cannot be established, retain package-grounded findings and qualify attribution;
 do not invent a repository or equate current source with the package's baseline.
 
-When a workspace and `context-build-inventory.json` are available, map a delivered page's
+Only when tracing a delivered page and a build inventory is already available, map its
 `dist_path` through `approved_knowledge.files` to its `approved_path`, relative
-to the workspace's `knowledge/` root. Follow the approved page's associations in
-`knowledge/structure.yaml` and `sources/*/index.yaml`. Without a reliable mapping,
+to the workspace's `knowledge/` root. For directly read approved pages, skip this
+mapping entirely. Follow relevant associations in `knowledge/structure.yaml`
+and `sources/*/index.yaml` only when source tracing is needed. Without a reliable mapping,
 continue package retrieval and follow explicit source references where available.
 Do not guess originals from similar filenames or claim attribution without
 checking the referenced material.
 
 Use the repository and recorded commit identified by the package or workspace
 as the source baseline.
-Reuse existing checkouts only after checking remote, commit, module coverage
-and local changes; do not reset them or change their sparse configuration.
+Before reusing a checkout for source reads, group checks of remote, commit,
+module coverage and local changes. Reuse those findings within this response
+instead of checking again before each search or file read. Recheck affected
+facts if the checkout/ref changes, sparse scope expands or there is evidence of
+concurrent edits; do not treat a previous response's checks as current. Do not
+reset user checkouts or change their sparse configuration.
 Missing code goes into a reusable query-owned path such as
 `.tmp/context-inspect/<host>/<repository-path>/<commit>/`, separate from user
 checkouts and production-managed sources. Use safe, credential-free path
@@ -130,10 +147,24 @@ capture/recovery actions. Production recovery gates do not block this independen
 inspection. Preserve unavailable-evidence gaps rather than changing production
 state to get past them.
 
-Compare relevant baseline files with current code when accessible, including
-relevant local changes. Use actual diffs to assess impact; current code is not a
-substitute for the baseline. Mention a missing comparison only when it limits
-the answer. For documents, notes and sessions, read saved bodies and necessary
+Batch independent searches and related file reads once paths are known, such as
+the entrypoint, state update and controlling render logic for one mechanism.
+Read enough surrounding context and follow unresolved imports or calls; batching
+must not truncate decisive evidence or turn a partial read into a complete audit.
+Reuse already read evidence rather than rereading it to prepare each tool call.
+
+Let evidence sufficiency determine whether a version comparison is needed.
+When the available knowledge or identified baseline code resolves the question,
+answer without fetching the default branch, recovering a second checkout or
+reading history merely to confirm freshness. Compare narrowly when uncertainty,
+conflicting evidence, suspected changes or an explicit version-comparison request
+makes it useful. A question about current behavior requires judging whether the
+available evidence supports that claim, not automatically comparing every branch.
+Retain necessary source reads; do not equate a recorded baseline or branch HEAD
+with a verified live deployment. When comparing, use actual relevant diffs,
+including relevant local changes; current code is not a substitute for the baseline.
+Mention a missing comparison only when it limits the answer.
+For documents, notes and sessions, read saved bodies and necessary
 attachments; fetch missing accessible material within scope. A summary is not a
 full transcript, an unread link is not evidence, and current remote content does
 not prove a historical snapshot.
@@ -158,6 +189,10 @@ Distinguish implementation,
 declared contracts, test assertions, runtime observations and inferences. Perform
 bounded non-destructive validation only when useful; inspect its effects first
 and do not run unrelated scripts, builds or tests.
+Do not turn a symbolic constant or version-like name into a numeric value without
+checking its actual imported definition at the inspected revision. A mock value
+is not the production definition. Keep the symbol when its numeric value is not
+needed; verify the value when the user's concrete boundary depends on it.
 
 Link material actually read: source files at the inspected commit, knowledge
 website articles and original documents. If no reliable clickable link exists,
@@ -166,13 +201,34 @@ limitation. Do not dump internal reasoning, runtime identifiers or routine
 version comparisons. Explain only differences affecting the answer; hashes may
 appear in source URLs without requiring a separate version audit in the prose.
 
-For website links, use `context-site-map.json` from the selected package or
-sibling website output. Match `pages[].package_path` or `approved_path`, and
+Collect citation targets after the relevant evidence is established and resolve
+them in one batch using the host's existing link resolver when available. Reuse
+known workspace, repository and site parameters; do not rediscover them per link.
+Include knowledge pages and original-source locations in that same batch. For
+each source file, retain the actual inspected repository, full commit, path and
+line range from the investigation; a recorded source reference alone may resolve
+to an older baseline. Pass the inspected commit through the resolver's supported
+contract, or supply a verified commit-specific URL when needed. Never first
+resolve baseline links and then replace them with branch-head links merely as a
+formatting step. If the revision cannot be established, state the attribution
+limit rather than silently substituting another commit. Resolution formats
+citations; it does not prove file contents, accessibility or live deployment.
+If later evidence adds targets, resolve only those missing from the results.
+Without a host resolver, use an already available `context-site-map.json` from
+the selected package or website output. Do not search for `dist/` merely to
+obtain links for readable approved knowledge. Match `pages[].package_path` or `approved_path`, and
 resolve `site_path` against `site_url` without prepending `base` again. Cite only
 matched pages, deduplicate links and do not invent anchors. If mapping is absent
 or invalid, retain local citations. Do not build, publish or probe remote sites
 just to format citations; a local map is not proof of the current online content.
 
+Once the requested questions are supported or genuinely unavailable evidence is
+clearly bounded, synthesize the final answer directly. Do not add another planning,
+freshness-audit or summary round just to prepare it. Preserve necessary mechanisms,
+exceptions, citations and verification limits; fewer preparation steps must not
+mean weaker evidence or omitted questions. Host delivery and receipt requirements
+still apply, without repeating the completed investigation.
+
 Suggest a knowledge update only with supporting evidence: identify the affected
 page or gap, proposed change and bounded source scope. Check neighboring content
 before proposing a new page. Only after user acceptance, hand the evidence and

package/plugins/claude/skills/context-inspect-search/SKILL.md

@@ -12,6 +12,11 @@ language. The invocation authorizes read-only investigation of the selected
 knowledge packages, available workspace and identified sources within that scope,
 including isolated source retrieval and bounded non-destructive checks. The Skill
 can run from a global installation with host-provided packages and no workspace.
+The ordinary query path is contained in this file. Reuse instructions already
+read in this response; do not reopen them for each stage. When actual delivery
+requires separate host link or response Skills, read their still-unread main
+instructions together once, and open conditional references only for the case
+being handled. Do not prepare delivery that the host's progress mode skips.
 Resolve scope from the request, conversation and configuration before asking.
 Continue through non-blocking issues; ask only for missing access, genuinely
 unresolved scope or effects outside existing authorization.
@@ -28,9 +33,9 @@ registrations, snapshots, tasks, approvals or user checkouts.
 Resolve `CONTEXT_QUERY_SOURCE_MODE` from the host or Bot instance configuration
 before choosing the first retrieval path. Supported values are:
 
-- `repo-first` (default): inspect the configured knowledge workspace and
-  authorized repository sources first. Use an available package only when the
-  repository path is unavailable or leaves a material gap.
+- `repo-first` (default): search approved `knowledge/` in the configured knowledge
+  workspace first; trace authorized original sources only for material gaps.
+  Use an available package when approved knowledge is unavailable.
 - `package-first`: inspect the selected package first, then use its recorded
   workspace or repository sources for missing, stale or disputed evidence.
 - `dual`: inspect the package and repository paths concurrently, then reconcile
@@ -44,8 +49,10 @@ sources and identify only gaps that affect the answer.
 ## Search available material according to the configured mode
 
 Apply `CONTEXT_QUERY_SOURCE_MODE` before starting retrieval. In `repo-first`,
-start with the configured workspace and reusable source checkouts; do not fetch
-or install a package merely to begin the query. In `package-first`, start with
+start with approved knowledge, not original-code checkout preparation. With
+readable `knowledge/`, do not probe `dist/`, build inventories or installed
+packages: distribution output is not a query prerequisite. An explicit request
+to investigate delivered content is an exception. In `package-first`, start with
 the selected readable package. In `dual`, start both paths concurrently. Search
 each selected path as soon as it is readable; tool checks and authorized
 upgrades must not block independent reading. If a configured primary path is
@@ -65,9 +72,11 @@ missing, use the host's configured, authorized package retrieval mechanism while
 other reading continues. Only check or prepare tools needed for the next actual
 operation; installation failure does not block independent local retrieval.
 
-For gaps or latest-content questions, also search approved knowledge when a workspace is available:
-use `knowledge/structure.yaml` and relevant `knowledge/` paths, trying business
-terms, symbols and synonyms, then read matching sections in context. Delivered
+Search relevant `knowledge/` paths using business terms, symbols and synonyms,
+then read matching sections in context; use `knowledge/structure.yaml` when
+navigation or associations are needed, not as an exhaustive preflight. In
+package-first or dual mode, approved knowledge can resolve gaps or freshness
+questions in delivered material. Delivered
 content may lag approved knowledge; they are not independent corroboration.
 Candidates and temporary reports are not approved pages. A search miss does not
 prove a capability is absent. Do not build merely to answer a query; a separately
@@ -77,8 +86,11 @@ When package or approved knowledge leaves a gap, directly trace relevant sources
 without asking whether to deepen the query. Use available document, code-search
 or extraction tools within the authorized scope, recording source identity and
 version. Prepare sources while continuing other reading.
-One failed source blocks only dependent claims. Answer when evidence is
-sufficient, without completing unnecessary preparation.
+One failed source blocks only dependent claims. If the read knowledge supports
+the requested conclusion, its conditions and scope, answer without restoring
+code or checking every associated source. Missing mechanisms, conflicting facts
+or unsupported current-behavior claims still require targeted investigation;
+an article title, search snippet or unread citation is not sufficient evidence.
 
 ## Trace and retrieve only relevant sources
 
@@ -89,18 +101,23 @@ registry is not a mandatory intermediate step. If the source identity or version
 cannot be established, retain package-grounded findings and qualify attribution;
 do not invent a repository or equate current source with the package's baseline.
 
-When a workspace and `context-build-inventory.json` are available, map a delivered page's
+Only when tracing a delivered page and a build inventory is already available, map its
 `dist_path` through `approved_knowledge.files` to its `approved_path`, relative
-to the workspace's `knowledge/` root. Follow the approved page's associations in
-`knowledge/structure.yaml` and `sources/*/index.yaml`. Without a reliable mapping,
+to the workspace's `knowledge/` root. For directly read approved pages, skip this
+mapping entirely. Follow relevant associations in `knowledge/structure.yaml`
+and `sources/*/index.yaml` only when source tracing is needed. Without a reliable mapping,
 continue package retrieval and follow explicit source references where available.
 Do not guess originals from similar filenames or claim attribution without
 checking the referenced material.
 
 Use the repository and recorded commit identified by the package or workspace
 as the source baseline.
-Reuse existing checkouts only after checking remote, commit, module coverage
-and local changes; do not reset them or change their sparse configuration.
+Before reusing a checkout for source reads, group checks of remote, commit,
+module coverage and local changes. Reuse those findings within this response
+instead of checking again before each search or file read. Recheck affected
+facts if the checkout/ref changes, sparse scope expands or there is evidence of
+concurrent edits; do not treat a previous response's checks as current. Do not
+reset user checkouts or change their sparse configuration.
 Missing code goes into a reusable query-owned path such as
 `.tmp/context-inspect/<host>/<repository-path>/<commit>/`, separate from user
 checkouts and production-managed sources. Use safe, credential-free path
@@ -129,10 +146,24 @@ capture/recovery actions. Production recovery gates do not block this independen
 inspection. Preserve unavailable-evidence gaps rather than changing production
 state to get past them.
 
-Compare relevant baseline files with current code when accessible, including
-relevant local changes. Use actual diffs to assess impact; current code is not a
-substitute for the baseline. Mention a missing comparison only when it limits
-the answer. For documents, notes and sessions, read saved bodies and necessary
+Batch independent searches and related file reads once paths are known, such as
+the entrypoint, state update and controlling render logic for one mechanism.
+Read enough surrounding context and follow unresolved imports or calls; batching
+must not truncate decisive evidence or turn a partial read into a complete audit.
+Reuse already read evidence rather than rereading it to prepare each tool call.
+
+Let evidence sufficiency determine whether a version comparison is needed.
+When the available knowledge or identified baseline code resolves the question,
+answer without fetching the default branch, recovering a second checkout or
+reading history merely to confirm freshness. Compare narrowly when uncertainty,
+conflicting evidence, suspected changes or an explicit version-comparison request
+makes it useful. A question about current behavior requires judging whether the
+available evidence supports that claim, not automatically comparing every branch.
+Retain necessary source reads; do not equate a recorded baseline or branch HEAD
+with a verified live deployment. When comparing, use actual relevant diffs,
+including relevant local changes; current code is not a substitute for the baseline.
+Mention a missing comparison only when it limits the answer.
+For documents, notes and sessions, read saved bodies and necessary
 attachments; fetch missing accessible material within scope. A summary is not a
 full transcript, an unread link is not evidence, and current remote content does
 not prove a historical snapshot.
@@ -157,6 +188,10 @@ Distinguish implementation,
 declared contracts, test assertions, runtime observations and inferences. Perform
 bounded non-destructive validation only when useful; inspect its effects first
 and do not run unrelated scripts, builds or tests.
+Do not turn a symbolic constant or version-like name into a numeric value without
+checking its actual imported definition at the inspected revision. A mock value
+is not the production definition. Keep the symbol when its numeric value is not
+needed; verify the value when the user's concrete boundary depends on it.
 
 Link material actually read: source files at the inspected commit, knowledge
 website articles and original documents. If no reliable clickable link exists,
@@ -165,13 +200,34 @@ limitation. Do not dump internal reasoning, runtime identifiers or routine
 version comparisons. Explain only differences affecting the answer; hashes may
 appear in source URLs without requiring a separate version audit in the prose.
 
-For website links, use `context-site-map.json` from the selected package or
-sibling website output. Match `pages[].package_path` or `approved_path`, and
+Collect citation targets after the relevant evidence is established and resolve
+them in one batch using the host's existing link resolver when available. Reuse
+known workspace, repository and site parameters; do not rediscover them per link.
+Include knowledge pages and original-source locations in that same batch. For
+each source file, retain the actual inspected repository, full commit, path and
+line range from the investigation; a recorded source reference alone may resolve
+to an older baseline. Pass the inspected commit through the resolver's supported
+contract, or supply a verified commit-specific URL when needed. Never first
+resolve baseline links and then replace them with branch-head links merely as a
+formatting step. If the revision cannot be established, state the attribution
+limit rather than silently substituting another commit. Resolution formats
+citations; it does not prove file contents, accessibility or live deployment.
+If later evidence adds targets, resolve only those missing from the results.
+Without a host resolver, use an already available `context-site-map.json` from
+the selected package or website output. Do not search for `dist/` merely to
+obtain links for readable approved knowledge. Match `pages[].package_path` or `approved_path`, and
 resolve `site_path` against `site_url` without prepending `base` again. Cite only
 matched pages, deduplicate links and do not invent anchors. If mapping is absent
 or invalid, retain local citations. Do not build, publish or probe remote sites
 just to format citations; a local map is not proof of the current online content.
 
+Once the requested questions are supported or genuinely unavailable evidence is
+clearly bounded, synthesize the final answer directly. Do not add another planning,
+freshness-audit or summary round just to prepare it. Preserve necessary mechanisms,
+exceptions, citations and verification limits; fewer preparation steps must not
+mean weaker evidence or omitted questions. Host delivery and receipt requirements
+still apply, without repeating the completed investigation.
+
 Suggest a knowledge update only with supporting evidence: identify the affected
 page or gap, proposed change and bounded source scope. Check neighboring content
 before proposing a new page. Only after user acceptance, hand the evidence and

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

@@ -1,6 +1,6 @@
 {
   "name": "c4a",
-  "version": "0.7.29",
+  "version": "0.7.34",
   "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.29",
+    "shortDescription": "Initialize and advance a local, source-linked project knowledge workspace.\nv0.7.34",
     "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/codex/skills/context-inspect-search/SKILL.md

@@ -12,6 +12,11 @@ language. The invocation authorizes read-only investigation of the selected
 knowledge packages, available workspace and identified sources within that scope,
 including isolated source retrieval and bounded non-destructive checks. The Skill
 can run from a global installation with host-provided packages and no workspace.
+The ordinary query path is contained in this file. Reuse instructions already
+read in this response; do not reopen them for each stage. When actual delivery
+requires separate host link or response Skills, read their still-unread main
+instructions together once, and open conditional references only for the case
+being handled. Do not prepare delivery that the host's progress mode skips.
 Resolve scope from the request, conversation and configuration before asking.
 Continue through non-blocking issues; ask only for missing access, genuinely
 unresolved scope or effects outside existing authorization.
@@ -28,9 +33,9 @@ registrations, snapshots, tasks, approvals or user checkouts.
 Resolve `CONTEXT_QUERY_SOURCE_MODE` from the host or Bot instance configuration
 before choosing the first retrieval path. Supported values are:
 
-- `repo-first` (default): inspect the configured knowledge workspace and
-  authorized repository sources first. Use an available package only when the
-  repository path is unavailable or leaves a material gap.
+- `repo-first` (default): search approved `knowledge/` in the configured knowledge
+  workspace first; trace authorized original sources only for material gaps.
+  Use an available package when approved knowledge is unavailable.
 - `package-first`: inspect the selected package first, then use its recorded
   workspace or repository sources for missing, stale or disputed evidence.
 - `dual`: inspect the package and repository paths concurrently, then reconcile
@@ -44,8 +49,10 @@ sources and identify only gaps that affect the answer.
 ## Search available material according to the configured mode
 
 Apply `CONTEXT_QUERY_SOURCE_MODE` before starting retrieval. In `repo-first`,
-start with the configured workspace and reusable source checkouts; do not fetch
-or install a package merely to begin the query. In `package-first`, start with
+start with approved knowledge, not original-code checkout preparation. With
+readable `knowledge/`, do not probe `dist/`, build inventories or installed
+packages: distribution output is not a query prerequisite. An explicit request
+to investigate delivered content is an exception. In `package-first`, start with
 the selected readable package. In `dual`, start both paths concurrently. Search
 each selected path as soon as it is readable; tool checks and authorized
 upgrades must not block independent reading. If a configured primary path is
@@ -65,9 +72,11 @@ missing, use the host's configured, authorized package retrieval mechanism while
 other reading continues. Only check or prepare tools needed for the next actual
 operation; installation failure does not block independent local retrieval.
 
-For gaps or latest-content questions, also search approved knowledge when a workspace is available:
-use `knowledge/structure.yaml` and relevant `knowledge/` paths, trying business
-terms, symbols and synonyms, then read matching sections in context. Delivered
+Search relevant `knowledge/` paths using business terms, symbols and synonyms,
+then read matching sections in context; use `knowledge/structure.yaml` when
+navigation or associations are needed, not as an exhaustive preflight. In
+package-first or dual mode, approved knowledge can resolve gaps or freshness
+questions in delivered material. Delivered
 content may lag approved knowledge; they are not independent corroboration.
 Candidates and temporary reports are not approved pages. A search miss does not
 prove a capability is absent. Do not build merely to answer a query; a separately
@@ -77,8 +86,11 @@ When package or approved knowledge leaves a gap, directly trace relevant sources
 without asking whether to deepen the query. Use available document, code-search
 or extraction tools within the authorized scope, recording source identity and
 version. Prepare sources while continuing other reading.
-One failed source blocks only dependent claims. Answer when evidence is
-sufficient, without completing unnecessary preparation.
+One failed source blocks only dependent claims. If the read knowledge supports
+the requested conclusion, its conditions and scope, answer without restoring
+code or checking every associated source. Missing mechanisms, conflicting facts
+or unsupported current-behavior claims still require targeted investigation;
+an article title, search snippet or unread citation is not sufficient evidence.
 
 ## Trace and retrieve only relevant sources
 
@@ -89,18 +101,23 @@ registry is not a mandatory intermediate step. If the source identity or version
 cannot be established, retain package-grounded findings and qualify attribution;
 do not invent a repository or equate current source with the package's baseline.
 
-When a workspace and `context-build-inventory.json` are available, map a delivered page's
+Only when tracing a delivered page and a build inventory is already available, map its
 `dist_path` through `approved_knowledge.files` to its `approved_path`, relative
-to the workspace's `knowledge/` root. Follow the approved page's associations in
-`knowledge/structure.yaml` and `sources/*/index.yaml`. Without a reliable mapping,
+to the workspace's `knowledge/` root. For directly read approved pages, skip this
+mapping entirely. Follow relevant associations in `knowledge/structure.yaml`
+and `sources/*/index.yaml` only when source tracing is needed. Without a reliable mapping,
 continue package retrieval and follow explicit source references where available.
 Do not guess originals from similar filenames or claim attribution without
 checking the referenced material.
 
 Use the repository and recorded commit identified by the package or workspace
 as the source baseline.
-Reuse existing checkouts only after checking remote, commit, module coverage
-and local changes; do not reset them or change their sparse configuration.
+Before reusing a checkout for source reads, group checks of remote, commit,
+module coverage and local changes. Reuse those findings within this response
+instead of checking again before each search or file read. Recheck affected
+facts if the checkout/ref changes, sparse scope expands or there is evidence of
+concurrent edits; do not treat a previous response's checks as current. Do not
+reset user checkouts or change their sparse configuration.
 Missing code goes into a reusable query-owned path such as
 `.tmp/context-inspect/<host>/<repository-path>/<commit>/`, separate from user
 checkouts and production-managed sources. Use safe, credential-free path
@@ -129,10 +146,24 @@ capture/recovery actions. Production recovery gates do not block this independen
 inspection. Preserve unavailable-evidence gaps rather than changing production
 state to get past them.
 
-Compare relevant baseline files with current code when accessible, including
-relevant local changes. Use actual diffs to assess impact; current code is not a
-substitute for the baseline. Mention a missing comparison only when it limits
-the answer. For documents, notes and sessions, read saved bodies and necessary
+Batch independent searches and related file reads once paths are known, such as
+the entrypoint, state update and controlling render logic for one mechanism.
+Read enough surrounding context and follow unresolved imports or calls; batching
+must not truncate decisive evidence or turn a partial read into a complete audit.
+Reuse already read evidence rather than rereading it to prepare each tool call.
+
+Let evidence sufficiency determine whether a version comparison is needed.
+When the available knowledge or identified baseline code resolves the question,
+answer without fetching the default branch, recovering a second checkout or
+reading history merely to confirm freshness. Compare narrowly when uncertainty,
+conflicting evidence, suspected changes or an explicit version-comparison request
+makes it useful. A question about current behavior requires judging whether the
+available evidence supports that claim, not automatically comparing every branch.
+Retain necessary source reads; do not equate a recorded baseline or branch HEAD
+with a verified live deployment. When comparing, use actual relevant diffs,
+including relevant local changes; current code is not a substitute for the baseline.
+Mention a missing comparison only when it limits the answer.
+For documents, notes and sessions, read saved bodies and necessary
 attachments; fetch missing accessible material within scope. A summary is not a
 full transcript, an unread link is not evidence, and current remote content does
 not prove a historical snapshot.
@@ -157,6 +188,10 @@ Distinguish implementation,
 declared contracts, test assertions, runtime observations and inferences. Perform
 bounded non-destructive validation only when useful; inspect its effects first
 and do not run unrelated scripts, builds or tests.
+Do not turn a symbolic constant or version-like name into a numeric value without
+checking its actual imported definition at the inspected revision. A mock value
+is not the production definition. Keep the symbol when its numeric value is not
+needed; verify the value when the user's concrete boundary depends on it.
 
 Link material actually read: source files at the inspected commit, knowledge
 website articles and original documents. If no reliable clickable link exists,
@@ -165,13 +200,34 @@ limitation. Do not dump internal reasoning, runtime identifiers or routine
 version comparisons. Explain only differences affecting the answer; hashes may
 appear in source URLs without requiring a separate version audit in the prose.
 
-For website links, use `context-site-map.json` from the selected package or
-sibling website output. Match `pages[].package_path` or `approved_path`, and
+Collect citation targets after the relevant evidence is established and resolve
+them in one batch using the host's existing link resolver when available. Reuse
+known workspace, repository and site parameters; do not rediscover them per link.
+Include knowledge pages and original-source locations in that same batch. For
+each source file, retain the actual inspected repository, full commit, path and
+line range from the investigation; a recorded source reference alone may resolve
+to an older baseline. Pass the inspected commit through the resolver's supported
+contract, or supply a verified commit-specific URL when needed. Never first
+resolve baseline links and then replace them with branch-head links merely as a
+formatting step. If the revision cannot be established, state the attribution
+limit rather than silently substituting another commit. Resolution formats
+citations; it does not prove file contents, accessibility or live deployment.
+If later evidence adds targets, resolve only those missing from the results.
+Without a host resolver, use an already available `context-site-map.json` from
+the selected package or website output. Do not search for `dist/` merely to
+obtain links for readable approved knowledge. Match `pages[].package_path` or `approved_path`, and
 resolve `site_path` against `site_url` without prepending `base` again. Cite only
 matched pages, deduplicate links and do not invent anchors. If mapping is absent
 or invalid, retain local citations. Do not build, publish or probe remote sites
 just to format citations; a local map is not proof of the current online content.
 
+Once the requested questions are supported or genuinely unavailable evidence is
+clearly bounded, synthesize the final answer directly. Do not add another planning,
+freshness-audit or summary round just to prepare it. Preserve necessary mechanisms,
+exceptions, citations and verification limits; fewer preparation steps must not
+mean weaker evidence or omitted questions. Host delivery and receipt requirements
+still apply, without repeating the completed investigation.
+
 Suggest a knowledge update only with supporting evidence: identify the affected
 page or gap, proposed change and bounded source scope. Check neighboring content
 before proposing a new page. Only after user acceptance, hand the evidence and

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

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