@c4a/context-cli 0.7.25 → 0.7.26

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
@@ -1,7 +1,7 @@
1
1
  {
2
2
  "protocol": "context.indexer.cli-release-manifest/v1",
3
3
  "package": "@c4a/context-cli",
4
- "version": "0.7.25",
4
+ "version": "0.7.26",
5
5
  "issuer": "context4ai/context",
6
6
  "bundles": [
7
7
  {
package/package.json CHANGED
@@ -1,6 +1,6 @@
1
1
  {
2
2
  "name": "@c4a/context-cli",
3
- "version": "0.7.25",
3
+ "version": "0.7.26",
4
4
  "type": "module",
5
5
  "description": "Local runtime and Agent integration for traceable knowledge production",
6
6
  "license": "MIT",
@@ -24,17 +24,17 @@
24
24
  },
25
25
  "dependencies": {
26
26
  "@c4a/agent-graph": "0.3.0",
27
- "@c4a/context": "0.7.25",
28
- "@c4a/extract": "0.7.25",
29
- "@c4a/extract-contract": "0.7.25",
30
- "@c4a/extract-go": "0.7.25",
31
- "@c4a/extract-mdx": "0.7.25",
32
- "@c4a/extract-proto": "0.7.25",
33
- "@c4a/extract-rush": "0.7.25",
34
- "@c4a/extract-sql": "0.7.25",
35
- "@c4a/extract-style": "0.7.25",
36
- "@c4a/extract-thrift": "0.7.25",
37
- "@c4a/extract-ts": "0.7.25",
27
+ "@c4a/context": "0.7.26",
28
+ "@c4a/extract": "0.7.26",
29
+ "@c4a/extract-contract": "0.7.26",
30
+ "@c4a/extract-go": "0.7.26",
31
+ "@c4a/extract-mdx": "0.7.26",
32
+ "@c4a/extract-proto": "0.7.26",
33
+ "@c4a/extract-rush": "0.7.26",
34
+ "@c4a/extract-sql": "0.7.26",
35
+ "@c4a/extract-style": "0.7.26",
36
+ "@c4a/extract-thrift": "0.7.26",
37
+ "@c4a/extract-ts": "0.7.26",
38
38
  "@mermaid-js/layout-elk": "0.2.0",
39
39
  "commander": "^11.0.0",
40
40
  "fast-xml-parser": "^5.10.1",
package/plugins/README.md CHANGED
@@ -5,7 +5,7 @@
5
5
  [简体中文](./README_CN.md)
6
6
 
7
7
  `plugins/context/` is the only human-maintained source for the Context Agent
8
- integration in this repository. It contains the Context production and explicit-only context-inspect-search Skills, the Code, Markdown, Note and Sessions
8
+ integration in this repository. It contains the Context production and host-routable context-inspect-search Skills, the Code, Markdown, Note and Sessions
9
9
  Indexer Provider Skills, host manifest templates, and shared assets.
10
10
 
11
11
  Run `bun run --filter @c4a/context-cli build:plugin` to regenerate the npm
@@ -30,11 +30,11 @@ Context workflow and Indexer Provider lifecycle.
30
30
 
31
31
  ## Query and attribute workspace knowledge
32
32
 
33
- Explicitly invoke `/c4a:context-inspect-search` (Cursor: `/c4a-context-inspect-search`)
34
- or the `context-inspect-search` Skill. It can start from a readable local, global or host-provided knowledge package and its query Skill without a local workspace. Without output, it
33
+ Explicitly invoke `/c4a:context-inspect-search` (Cursor: `/c4a-context-inspect-search`),
34
+ or let a host configuration route knowledge questions to the `context-inspect-search` Skill. It can start from a readable local, global or host-provided knowledge package and its query Skill without a local workspace. Without output, it
35
35
  queries approved `knowledge` directly; a package build requires prior authorization for that workspace write.
36
36
  Read-only investigation and bounded non-destructive checks need no further approval. For code attribution, it
37
37
  retrieves the registered revision and checks relevant differences against current code without asking the user to select a version.
38
38
  It traces package pages through the build inventory to approved originals and registered sources, without resetting production. Accepted suggestions hand off to `context`.
39
- Codex disables implicit invocation through Skill policy; Claude commands disable
40
- model invocation. Other hosts must honor the explicit-only instructions.
39
+ The user-facing Claude command remains explicit-only. Host skill manifests expose
40
+ the Skill so configured knowledge Bots can select it without searching plugin files.
@@ -4,7 +4,7 @@
4
4
 
5
5
  [English](./README.md)
6
6
 
7
- 仓库中的 `plugins/context/` 是 Context Agent 接入唯一的人工维护真源,包含 Context 生产入口和显式触发的 context-inspect-search 技能、
7
+ 仓库中的 `plugins/context/` 是 Context Agent 接入唯一的人工维护真源,包含 Context 生产入口和可由宿主路由的 context-inspect-search 技能、
8
8
  Code/Markdown/Note/Sessions Indexer Provider Skills、各宿主 manifest 模板和共享资产。
9
9
 
10
10
  运行 `bun run --filter @c4a/context-cli build:plugin` 可重新生成 npm 投影及提交到
@@ -27,10 +27,10 @@ Skills 只能通过完成校验的 Context Indexer Provider 生命周期激活
27
27
  ## 查询知识与来源归因
28
28
 
29
29
  主动调用 `/c4a:context-inspect-search`(Cursor:`/c4a-context-inspect-search`),
30
- 或指定 `context-inspect-search` 技能。无需本地工作区即可检索本地、全局或宿主提供的知识包,优先使用包内查询技能;没有产物但有工作区时,
30
+ 或由宿主配置将知识问答路由到 `context-inspect-search` 技能。无需本地工作区即可检索本地、全局或宿主提供的知识包,优先使用包内查询技能;没有产物但有工作区时,
31
31
  直接查询已批准的 `knowledge`,构建产物需事先获得写入工作区的授权。只读探索及有边界的
32
32
  非破坏性检查无需再次确认。代码归因自动取得登记版本,并核对相关文件与当前代码的差异,
33
33
  无需用户选择版本。通过构建清单关联批准原稿
34
34
  并追溯登记来源,不清理工作区、不为查询推进无关生产任务。证据充分时可建议更新,用户采纳后交给
35
- `context` 的当前流程。Codex 配置禁止隐式调用,Claude 命令配置禁止模型自动调用;
36
- 其他宿主依赖显式触发指引,不承诺其支持相同的自动调用控制。
35
+ `context` 的当前流程。面向用户的 Claude 命令仍只允许显式触发;宿主技能清单会公开该技能,
36
+ 使配置过的知识 Bot 无需搜索插件文件即可选择它。
package/plugins/VERSION CHANGED
@@ -1 +1 @@
1
- 0.7.25
1
+ 0.7.26
@@ -1,7 +1,7 @@
1
1
  {
2
2
  "name": "c4a",
3
3
  "description": "Start or continue a project-local knowledge workspace through one graph-routed entry.",
4
- "version": "0.7.25",
4
+ "version": "0.7.26",
5
5
  "author": {
6
6
  "name": "c4a"
7
7
  },
@@ -14,6 +14,7 @@
14
14
  "c4a"
15
15
  ],
16
16
  "skills": [
17
- "./skills/context-indexer-create"
17
+ "./skills/context-indexer-create",
18
+ "./skills/context-inspect-search"
18
19
  ]
19
20
  }
@@ -1,5 +1,5 @@
1
1
  ---
2
- description: "Use only when the user explicitly invokes context-inspect-search to query available Context knowledge packages or approved workspace knowledge and trace answers to their identified sources. A local workspace is optional. Do not auto-start for ordinary coding, planning, debugging, or an active Context production workflow."
2
+ description: "Query available Context knowledge packages or approved workspace knowledge and trace answers to their identified sources when the user asks a knowledge question or the host configuration routes the request here. A local workspace is optional. Do not auto-start for ordinary coding, planning, debugging, or an active Context production workflow."
3
3
  argument-hint: "[project-dir or user intent]"
4
4
  disable-model-invocation: true
5
5
  ---
@@ -0,0 +1,147 @@
1
+ ---
2
+ name: context-inspect-search
3
+ description: Query available Context knowledge packages or approved workspace knowledge and trace answers to their identified sources when the user asks a knowledge question or the host configuration routes the request here. A local workspace is optional. Do not auto-start for ordinary coding, planning, debugging, or an active Context production workflow.
4
+ ---
5
+
6
+ # Context Inspect Search
7
+
8
+ ## Entry and boundaries
9
+
10
+ Use on explicit invocation and related follow-up questions; use the conversation
11
+ language. The invocation authorizes read-only investigation of the selected
12
+ knowledge packages, available workspace and identified sources within that scope,
13
+ including isolated source retrieval and bounded non-destructive checks. The Skill
14
+ can run from a global installation with host-provided packages and no workspace.
15
+ Resolve scope from the request, conversation and configuration before asking.
16
+ Continue through non-blocking issues; ask only for missing access, genuinely
17
+ unresolved scope or effects outside existing authorization.
18
+
19
+ Start from the supplied package locations or workspace configuration. If a
20
+ workspace exists, read its `AGENTS.md` and relevant configuration;
21
+ `context entry [project-dir] --format json` may help locate instructions.
22
+ Neither a workspace nor a working Context CLI is required for package retrieval;
23
+ do not call entry in an arbitrary directory just to satisfy a prerequisite.
24
+ Do not execute returned production actions, initialize a replacement workspace,
25
+ or install tools without existing authorization. Querying must not alter source
26
+ registrations, snapshots, tasks, approvals or user checkouts.
27
+
28
+ ## Search available material concurrently
29
+
30
+ Check relevant knowledge packages, the workspace and reusable source checkouts
31
+ in parallel. Search each as soon as it is readable; tool checks and authorized
32
+ upgrades must not block independent reading. If a missing configured workspace
33
+ is needed for further attribution, recover it into an isolated directory while
34
+ package retrieval continues. Without a configured workspace, investigate the
35
+ available packages directly; do not request or create one merely to start.
36
+
37
+ A knowledge package may be workspace build output (usually `dist/`), a global
38
+ installation, or an equivalent host-provided directory. Locate it from available
39
+ configuration or installation metadata rather than assuming a fixed path.
40
+ Select packages relevant to the question. Follow their bundled query Skill when
41
+ present; otherwise search readable indexes and pages. Missing Skills or build
42
+ inventories do not block retrieval or justify rebuilding. If a needed package is
43
+ missing, use the host's configured, authorized package retrieval mechanism while
44
+ other reading continues. Only check or prepare tools needed for the next actual
45
+ operation; installation failure does not block independent local retrieval.
46
+
47
+ For gaps or latest-content questions, also search approved knowledge when a workspace is available:
48
+ use `knowledge/structure.yaml` and relevant `knowledge/` paths, trying business
49
+ terms, symbols and synonyms, then read matching sections in context. Delivered
50
+ content may lag approved knowledge; they are not independent corroboration.
51
+ Candidates and temporary reports are not approved pages. A search miss does not
52
+ prove a capability is absent. Do not build merely to answer a query; a separately
53
+ authorized build must follow its own workflow without advancing unrelated work.
54
+
55
+ When package or approved knowledge leaves a gap, directly trace relevant sources
56
+ without asking whether to deepen the query. Use available document, code-search
57
+ or extraction tools within the authorized scope, recording source identity and
58
+ version. Prepare sources while continuing other reading.
59
+ One failed source blocks only dependent claims. Answer when evidence is
60
+ sufficient, without completing unnecessary preparation.
61
+
62
+ ## Trace and retrieve only relevant sources
63
+
64
+ Without a workspace, use explicit source references in the package, its metadata
65
+ or user configuration to identify relevant documents or repository paths and
66
+ commits. Read or retrieve those sources directly within scope; the workspace
67
+ registry is not a mandatory intermediate step. If the source identity or version
68
+ cannot be established, retain package-grounded findings and qualify attribution;
69
+ do not invent a repository or equate current source with the package's baseline.
70
+
71
+ When a workspace and `context-build-inventory.json` are available, map a delivered page's
72
+ `dist_path` through `approved_knowledge.files` to its `approved_path`, relative
73
+ to the workspace's `knowledge/` root. Follow the approved page's associations in
74
+ `knowledge/structure.yaml` and `sources/*/index.yaml`. Without a reliable mapping,
75
+ continue package retrieval and follow explicit source references where available.
76
+ Do not guess originals from similar filenames or claim attribution without
77
+ checking the referenced material.
78
+
79
+ Use the repository and recorded commit identified by the package or workspace
80
+ as the source baseline.
81
+ Reuse existing checkouts only after checking remote, commit, module coverage
82
+ and local changes; do not reset them or change their sparse configuration.
83
+ Missing code goes into a reusable query-owned path such as
84
+ `.tmp/context-inspect/<host>/<repository-path>/<commit>/`, separate from user
85
+ checkouts and production-managed sources. Use safe, credential-free path
86
+ components and the full commit. Verify identity before reuse; never overwrite
87
+ a mismatched directory. Deduplicate recovery and use one writer per checkout;
88
+ that writer may append sparse paths without resetting existing files.
89
+
90
+ Default to lightweight retrieval and sparse checkout:
91
+
92
+ - Use shallow history (`--depth=1`) and deferred contents (`--filter=blob:none`)
93
+ where supported, with a complete partial-clone setup and named promisor remote.
94
+ Configure the sparse scope before checkout and verify the resulting commit.
95
+ - Start from known module paths. If unclear, inspect
96
+ `git ls-tree -r --name-only <commit>` for candidates, then read code to confirm
97
+ their relevance. Expand along imports, calls and service routes as needed;
98
+ deepen history only when needed. A sparse search miss is not a whole-repository miss.
99
+ - Read ready modules while other recovery proceeds. Allow sufficient command
100
+ time (for example 300 seconds or more), but investigate confirmed stalls
101
+ without waiting for timeout; silence alone is not a stall. If unsupported or
102
+ unsuccessful, try caches, commit-specific file retrieval or bounded shallow
103
+ retrieval; use a full clone only when necessary. Do not retry blindly or
104
+ silently substitute the default branch for an unavailable recorded commit.
105
+
106
+ Query retrieval never runs `context source restore`, `task prepare` or production
107
+ capture/recovery actions. Production recovery gates do not block this independent
108
+ inspection. Preserve unavailable-evidence gaps rather than changing production
109
+ state to get past them.
110
+
111
+ Compare relevant baseline files with current code when accessible, including
112
+ relevant local changes. Use actual diffs to assess impact; current code is not a
113
+ substitute for the baseline. Mention a missing comparison only when it limits
114
+ the answer. For documents, notes and sessions, read saved bodies and necessary
115
+ attachments; fetch missing accessible material within scope. A summary is not a
116
+ full transcript, an unread link is not evidence, and current remote content does
117
+ not prove a historical snapshot.
118
+
119
+ ## Answer with evidence and hand off updates
120
+
121
+ Lead with the conclusion and a concise evidence chain. Distinguish implementation,
122
+ declared contracts, test assertions, runtime observations and inferences. Perform
123
+ bounded non-destructive validation only when useful; inspect its effects first
124
+ and do not run unrelated scripts, builds or tests.
125
+
126
+ Link material actually read: source files at the inspected commit, knowledge
127
+ website articles and original documents. If no reliable clickable link exists,
128
+ give checkable local paths, symbols and short supporting excerpts with the
129
+ limitation. Do not dump internal reasoning, runtime identifiers or routine
130
+ version comparisons. Explain only differences affecting the answer; hashes may
131
+ appear in source URLs without requiring a separate version audit in the prose.
132
+
133
+ For website links, use `context-site-map.json` from the selected package or
134
+ sibling website output. Match `pages[].package_path` or `approved_path`, and
135
+ resolve `site_path` against `site_url` without prepending `base` again. Cite only
136
+ matched pages, deduplicate links and do not invent anchors. If mapping is absent
137
+ or invalid, retain local citations. Do not build, publish or probe remote sites
138
+ just to format citations; a local map is not proof of the current online content.
139
+
140
+ Suggest a knowledge update only with supporting evidence: identify the affected
141
+ page or gap, proposed change and bounded source scope. Check neighboring content
142
+ before proposing a new page. Only after user acceptance, hand the evidence and
143
+ scope to the installed `context` production Skill in the selected workspace and
144
+ its fresh Route. If no target workspace is known, resolve it at that handoff,
145
+ not as a prerequisite to answering. Do not edit approved knowledge, clear state
146
+ or reuse an earlier revision. If that entry
147
+ is unavailable, provide the handoff and state that no update has started.
@@ -0,0 +1,2 @@
1
+ policy:
2
+ allow_implicit_invocation: true
@@ -1,6 +1,6 @@
1
1
  {
2
2
  "name": "c4a",
3
- "version": "0.7.25",
3
+ "version": "0.7.26",
4
4
  "description": "Start or continue a project-local knowledge workspace through one graph-routed entry.",
5
5
  "author": { "name": "c4a" },
6
6
  "homepage": "https://github.com/context4ai/c4a",
@@ -10,7 +10,7 @@
10
10
  "skills": "./skills/",
11
11
  "interface": {
12
12
  "displayName": "C4A Context",
13
- "shortDescription": "Initialize and advance a local, source-linked project knowledge workspace.\nv0.7.25",
13
+ "shortDescription": "Initialize and advance a local, source-linked project knowledge workspace.\nv0.7.26",
14
14
  "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.",
15
15
  "developerName": "c4a",
16
16
  "category": "Productivity",
@@ -1,7 +1,6 @@
1
1
  ---
2
2
  name: context-inspect-search
3
- description: Use only when the user explicitly invokes context-inspect-search to query available Context knowledge packages or approved workspace knowledge and trace answers to their identified sources. A local workspace is optional. Do not auto-start for ordinary coding, planning, debugging, or an active Context production workflow.
4
- disable-model-invocation: true
3
+ description: Query available Context knowledge packages or approved workspace knowledge and trace answers to their identified sources when the user asks a knowledge question or the host configuration routes the request here. A local workspace is optional. Do not auto-start for ordinary coding, planning, debugging, or an active Context production workflow.
5
4
  ---
6
5
 
7
6
  # Context Inspect Search
@@ -1,2 +1,2 @@
1
1
  policy:
2
- allow_implicit_invocation: false
2
+ allow_implicit_invocation: true
@@ -1,7 +1,7 @@
1
1
  {
2
2
  "name": "c4a",
3
3
  "displayName": "C4A Context",
4
- "version": "0.7.25",
4
+ "version": "0.7.26",
5
5
  "description": "Start or continue a project-local knowledge workspace through one graph-routed entry.",
6
6
  "author": {
7
7
  "name": "Context4AI",
@@ -26,6 +26,7 @@
26
26
  ],
27
27
  "commands": "./commands/",
28
28
  "skills": [
29
- "./skills/context-indexer-create"
29
+ "./skills/context-indexer-create",
30
+ "./skills/context-inspect-search"
30
31
  ]
31
32
  }
@@ -1,5 +1,5 @@
1
1
  ---
2
- description: "Use only when the user explicitly invokes context-inspect-search to query available Context knowledge packages or approved workspace knowledge and trace answers to their identified sources. A local workspace is optional. Do not auto-start for ordinary coding, planning, debugging, or an active Context production workflow."
2
+ description: "Query available Context knowledge packages or approved workspace knowledge and trace answers to their identified sources when the user asks a knowledge question or the host configuration routes the request here. A local workspace is optional. Do not auto-start for ordinary coding, planning, debugging, or an active Context production workflow."
3
3
  ---
4
4
 
5
5
  # Context Inspect Search
@@ -0,0 +1,147 @@
1
+ ---
2
+ name: context-inspect-search
3
+ description: Query available Context knowledge packages or approved workspace knowledge and trace answers to their identified sources when the user asks a knowledge question or the host configuration routes the request here. A local workspace is optional. Do not auto-start for ordinary coding, planning, debugging, or an active Context production workflow.
4
+ ---
5
+
6
+ # Context Inspect Search
7
+
8
+ ## Entry and boundaries
9
+
10
+ Use on explicit invocation and related follow-up questions; use the conversation
11
+ language. The invocation authorizes read-only investigation of the selected
12
+ knowledge packages, available workspace and identified sources within that scope,
13
+ including isolated source retrieval and bounded non-destructive checks. The Skill
14
+ can run from a global installation with host-provided packages and no workspace.
15
+ Resolve scope from the request, conversation and configuration before asking.
16
+ Continue through non-blocking issues; ask only for missing access, genuinely
17
+ unresolved scope or effects outside existing authorization.
18
+
19
+ Start from the supplied package locations or workspace configuration. If a
20
+ workspace exists, read its `AGENTS.md` and relevant configuration;
21
+ `context entry [project-dir] --format json` may help locate instructions.
22
+ Neither a workspace nor a working Context CLI is required for package retrieval;
23
+ do not call entry in an arbitrary directory just to satisfy a prerequisite.
24
+ Do not execute returned production actions, initialize a replacement workspace,
25
+ or install tools without existing authorization. Querying must not alter source
26
+ registrations, snapshots, tasks, approvals or user checkouts.
27
+
28
+ ## Search available material concurrently
29
+
30
+ Check relevant knowledge packages, the workspace and reusable source checkouts
31
+ in parallel. Search each as soon as it is readable; tool checks and authorized
32
+ upgrades must not block independent reading. If a missing configured workspace
33
+ is needed for further attribution, recover it into an isolated directory while
34
+ package retrieval continues. Without a configured workspace, investigate the
35
+ available packages directly; do not request or create one merely to start.
36
+
37
+ A knowledge package may be workspace build output (usually `dist/`), a global
38
+ installation, or an equivalent host-provided directory. Locate it from available
39
+ configuration or installation metadata rather than assuming a fixed path.
40
+ Select packages relevant to the question. Follow their bundled query Skill when
41
+ present; otherwise search readable indexes and pages. Missing Skills or build
42
+ inventories do not block retrieval or justify rebuilding. If a needed package is
43
+ missing, use the host's configured, authorized package retrieval mechanism while
44
+ other reading continues. Only check or prepare tools needed for the next actual
45
+ operation; installation failure does not block independent local retrieval.
46
+
47
+ For gaps or latest-content questions, also search approved knowledge when a workspace is available:
48
+ use `knowledge/structure.yaml` and relevant `knowledge/` paths, trying business
49
+ terms, symbols and synonyms, then read matching sections in context. Delivered
50
+ content may lag approved knowledge; they are not independent corroboration.
51
+ Candidates and temporary reports are not approved pages. A search miss does not
52
+ prove a capability is absent. Do not build merely to answer a query; a separately
53
+ authorized build must follow its own workflow without advancing unrelated work.
54
+
55
+ When package or approved knowledge leaves a gap, directly trace relevant sources
56
+ without asking whether to deepen the query. Use available document, code-search
57
+ or extraction tools within the authorized scope, recording source identity and
58
+ version. Prepare sources while continuing other reading.
59
+ One failed source blocks only dependent claims. Answer when evidence is
60
+ sufficient, without completing unnecessary preparation.
61
+
62
+ ## Trace and retrieve only relevant sources
63
+
64
+ Without a workspace, use explicit source references in the package, its metadata
65
+ or user configuration to identify relevant documents or repository paths and
66
+ commits. Read or retrieve those sources directly within scope; the workspace
67
+ registry is not a mandatory intermediate step. If the source identity or version
68
+ cannot be established, retain package-grounded findings and qualify attribution;
69
+ do not invent a repository or equate current source with the package's baseline.
70
+
71
+ When a workspace and `context-build-inventory.json` are available, map a delivered page's
72
+ `dist_path` through `approved_knowledge.files` to its `approved_path`, relative
73
+ to the workspace's `knowledge/` root. Follow the approved page's associations in
74
+ `knowledge/structure.yaml` and `sources/*/index.yaml`. Without a reliable mapping,
75
+ continue package retrieval and follow explicit source references where available.
76
+ Do not guess originals from similar filenames or claim attribution without
77
+ checking the referenced material.
78
+
79
+ Use the repository and recorded commit identified by the package or workspace
80
+ as the source baseline.
81
+ Reuse existing checkouts only after checking remote, commit, module coverage
82
+ and local changes; do not reset them or change their sparse configuration.
83
+ Missing code goes into a reusable query-owned path such as
84
+ `.tmp/context-inspect/<host>/<repository-path>/<commit>/`, separate from user
85
+ checkouts and production-managed sources. Use safe, credential-free path
86
+ components and the full commit. Verify identity before reuse; never overwrite
87
+ a mismatched directory. Deduplicate recovery and use one writer per checkout;
88
+ that writer may append sparse paths without resetting existing files.
89
+
90
+ Default to lightweight retrieval and sparse checkout:
91
+
92
+ - Use shallow history (`--depth=1`) and deferred contents (`--filter=blob:none`)
93
+ where supported, with a complete partial-clone setup and named promisor remote.
94
+ Configure the sparse scope before checkout and verify the resulting commit.
95
+ - Start from known module paths. If unclear, inspect
96
+ `git ls-tree -r --name-only <commit>` for candidates, then read code to confirm
97
+ their relevance. Expand along imports, calls and service routes as needed;
98
+ deepen history only when needed. A sparse search miss is not a whole-repository miss.
99
+ - Read ready modules while other recovery proceeds. Allow sufficient command
100
+ time (for example 300 seconds or more), but investigate confirmed stalls
101
+ without waiting for timeout; silence alone is not a stall. If unsupported or
102
+ unsuccessful, try caches, commit-specific file retrieval or bounded shallow
103
+ retrieval; use a full clone only when necessary. Do not retry blindly or
104
+ silently substitute the default branch for an unavailable recorded commit.
105
+
106
+ Query retrieval never runs `context source restore`, `task prepare` or production
107
+ capture/recovery actions. Production recovery gates do not block this independent
108
+ inspection. Preserve unavailable-evidence gaps rather than changing production
109
+ state to get past them.
110
+
111
+ Compare relevant baseline files with current code when accessible, including
112
+ relevant local changes. Use actual diffs to assess impact; current code is not a
113
+ substitute for the baseline. Mention a missing comparison only when it limits
114
+ the answer. For documents, notes and sessions, read saved bodies and necessary
115
+ attachments; fetch missing accessible material within scope. A summary is not a
116
+ full transcript, an unread link is not evidence, and current remote content does
117
+ not prove a historical snapshot.
118
+
119
+ ## Answer with evidence and hand off updates
120
+
121
+ Lead with the conclusion and a concise evidence chain. Distinguish implementation,
122
+ declared contracts, test assertions, runtime observations and inferences. Perform
123
+ bounded non-destructive validation only when useful; inspect its effects first
124
+ and do not run unrelated scripts, builds or tests.
125
+
126
+ Link material actually read: source files at the inspected commit, knowledge
127
+ website articles and original documents. If no reliable clickable link exists,
128
+ give checkable local paths, symbols and short supporting excerpts with the
129
+ limitation. Do not dump internal reasoning, runtime identifiers or routine
130
+ version comparisons. Explain only differences affecting the answer; hashes may
131
+ appear in source URLs without requiring a separate version audit in the prose.
132
+
133
+ For website links, use `context-site-map.json` from the selected package or
134
+ sibling website output. Match `pages[].package_path` or `approved_path`, and
135
+ resolve `site_path` against `site_url` without prepending `base` again. Cite only
136
+ matched pages, deduplicate links and do not invent anchors. If mapping is absent
137
+ or invalid, retain local citations. Do not build, publish or probe remote sites
138
+ just to format citations; a local map is not proof of the current online content.
139
+
140
+ Suggest a knowledge update only with supporting evidence: identify the affected
141
+ page or gap, proposed change and bounded source scope. Check neighboring content
142
+ before proposing a new page. Only after user acceptance, hand the evidence and
143
+ scope to the installed `context` production Skill in the selected workspace and
144
+ its fresh Route. If no target workspace is known, resolve it at that handoff,
145
+ not as a prerequisite to answering. Do not edit approved knowledge, clear state
146
+ or reuse an earlier revision. If that entry
147
+ is unavailable, provide the handoff and state that no update has started.
@@ -0,0 +1,2 @@
1
+ policy:
2
+ allow_implicit_invocation: true
@@ -1,7 +1,6 @@
1
1
  ---
2
2
  name: context-inspect-search
3
- description: Use only when the user explicitly invokes context-inspect-search to query available Context knowledge packages or approved workspace knowledge and trace answers to their identified sources. A local workspace is optional. Do not auto-start for ordinary coding, planning, debugging, or an active Context production workflow.
4
- disable-model-invocation: true
3
+ description: Query available Context knowledge packages or approved workspace knowledge and trace answers to their identified sources when the user asks a knowledge question or the host configuration routes the request here. A local workspace is optional. Do not auto-start for ordinary coding, planning, debugging, or an active Context production workflow.
5
4
  ---
6
5
 
7
6
  # Context Inspect Search
@@ -1,2 +1,2 @@
1
1
  policy:
2
- allow_implicit_invocation: false
2
+ allow_implicit_invocation: true
@@ -2,7 +2,7 @@
2
2
  "schema": "agent-graph.bundle.v1",
3
3
  "provider": {
4
4
  "id": "c4a/context",
5
- "version": "0.7.25"
5
+ "version": "0.7.26"
6
6
  },
7
7
  "providerManifest": "provider.yaml",
8
8
  "graphs": [
@@ -570,7 +570,7 @@
570
570
  },
571
571
  {
572
572
  "path": "provider.yaml",
573
- "digest": "sha256:205a4786448c8825b10469fc7eda3b5e9e67caa7a0df528d14709c9c88f985bd"
573
+ "digest": "sha256:7e5a25e5636983a6fb881621e826c102680f44cde9d21086c627861e119d1f7a"
574
574
  },
575
575
  {
576
576
  "path": "resources/contracts/indexer-provider-guide.yaml",
@@ -869,5 +869,5 @@
869
869
  "indexer": [],
870
870
  "workspace": []
871
871
  },
872
- "digest": "sha256:1632415b812eb5fe95240d1e959d1f598ed060a9b923ba9dfa5dc5d88d02cfce"
872
+ "digest": "sha256:3f380c5b4a1adbc92847189b7072ec7515990dce621785bf25469268f9bbb252"
873
873
  }
@@ -1,6 +1,6 @@
1
1
  schema: agent-graph.provider.v1
2
2
  id: c4a/context
3
- version: 0.7.25
3
+ version: 0.7.26
4
4
  name: Context workflow
5
5
  description: Internal work contract for Context knowledge workspaces.
6
6
  graphs: