artifact-chain-assistant 0.13.0 → 0.14.0

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.
Files changed (53) hide show
  1. package/.claude-plugin/plugin.json +1 -1
  2. package/.codex-plugin/plugin.json +1 -1
  3. package/.kimi-plugin/plugin.json +1 -1
  4. package/CHANGELOG.md +13 -0
  5. package/INSTALL.md +10 -10
  6. package/README.md +11 -8
  7. package/README.zh-CN.md +7 -5
  8. package/adapters/claude/.claude-plugin/plugin.json +1 -1
  9. package/adapters/claude/INSTALL.md +10 -10
  10. package/adapters/claude/agent-methods/catalog.yaml +1 -1
  11. package/adapters/claude/compatibility.json +4 -4
  12. package/adapters/claude/family-apis/catalog.json +1 -1
  13. package/adapters/claude/skills/artifact-audit/SKILL.md +24 -13
  14. package/adapters/claude/skills/artifact-chain-help/SKILL.md +2 -2
  15. package/adapters/claude/skills/artifact-chain-quickstart/SKILL.md +10 -0
  16. package/adapters/codex/.codex-plugin/plugin.json +1 -1
  17. package/adapters/codex/INSTALL.md +10 -10
  18. package/adapters/codex/agent-methods/catalog.yaml +1 -1
  19. package/adapters/codex/compatibility.json +4 -4
  20. package/adapters/codex/family-apis/catalog.json +1 -1
  21. package/adapters/codex/skills/artifact-audit/SKILL.md +24 -13
  22. package/adapters/codex/skills/artifact-chain-help/SKILL.md +2 -2
  23. package/adapters/codex/skills/artifact-chain-quickstart/SKILL.md +10 -0
  24. package/adapters/kimi/.kimi-plugin/plugin.json +1 -1
  25. package/adapters/kimi/INSTALL.md +10 -10
  26. package/adapters/kimi/agent-methods/catalog.yaml +1 -1
  27. package/adapters/kimi/compatibility.json +4 -4
  28. package/adapters/kimi/family-apis/catalog.json +1 -1
  29. package/adapters/kimi/skills/artifact-audit/SKILL.md +24 -13
  30. package/adapters/kimi/skills/artifact-chain-help/SKILL.md +2 -2
  31. package/adapters/kimi/skills/artifact-chain-quickstart/SKILL.md +10 -0
  32. package/agent-methods/catalog.yaml +1 -1
  33. package/compatibility.json +4 -4
  34. package/family-apis/catalog.json +1 -1
  35. package/package.json +2 -2
  36. package/site/00-matrix.html +1 -1
  37. package/site/01-what.html +1 -1
  38. package/site/02-architecture.html +1 -1
  39. package/site/03-concepts.html +1 -1
  40. package/site/04-cli.html +1 -1
  41. package/site/05-scenarios.html +1 -1
  42. package/site/06-method-registry.html +1 -1
  43. package/site/07-glossary.html +1 -1
  44. package/site/08-maintainer.html +1 -1
  45. package/site/09-troubleshoot.html +2 -2
  46. package/site/10-roadmap.html +1 -1
  47. package/site/index.html +2 -2
  48. package/skills/artifact-audit/SKILL.md +24 -13
  49. package/skills/artifact-chain-help/SKILL.md +2 -2
  50. package/skills/artifact-chain-quickstart/SKILL.md +10 -0
  51. package/skills-src/artifact-audit/SKILL.md +24 -13
  52. package/skills-src/artifact-chain-help/SKILL.md +2 -2
  53. package/skills-src/artifact-chain-quickstart/SKILL.md +10 -0
@@ -1,6 +1,6 @@
1
1
  {
2
2
  "name": "artifact-chain-assistant",
3
- "version": "0.13.0",
3
+ "version": "0.14.0",
4
4
  "description": "Artifact-chain intake, review/repair/batch/audit workflows, diagnostics, hooks, and version-lock maintenance helpers.",
5
5
  "author": {
6
6
  "name": "广州市风荷科技有限公司"
@@ -1,7 +1,7 @@
1
1
  {
2
2
  "name": "artifact-chain-assistant",
3
3
  "displayName": "Artifact Chain Assistant",
4
- "version": "0.13.0",
4
+ "version": "0.14.0",
5
5
  "description": "Artifact-chain intake, review/repair/batch/audit workflows, diagnostics, and version-lock maintenance helpers.",
6
6
  "author": {
7
7
  "name": "广州市风荷科技有限公司"
@@ -1,6 +1,6 @@
1
1
  {
2
2
  "name": "artifact-chain-assistant",
3
- "version": "0.13.0",
3
+ "version": "0.14.0",
4
4
  "description": "Artifact-chain intake, review/repair/batch/audit workflows, diagnostics, and version-lock maintenance helpers.",
5
5
  "author": {
6
6
  "name": "广州市风荷科技有限公司"
package/CHANGELOG.md CHANGED
@@ -2,6 +2,19 @@
2
2
 
3
3
  ## Unreleased
4
4
 
5
+ ## 0.14.0
6
+
7
+ ### Added
8
+
9
+ - `artifact-audit health` now routes graph checks through `artifact-graph check-professional` and
10
+ reads existing graph proofs through `read-proof`. Its human-facing result distinguishes a graph
11
+ pass, findings, incomplete checks, and unavailable evidence; capability and release-gate audits
12
+ retain their existing scope.
13
+
14
+ ### Changed
15
+
16
+ - Synchronized runtime compatibility with `artifact-graph@0.14.0`.
17
+
5
18
  ## 0.13.0
6
19
 
7
20
  ### Added
package/INSTALL.md CHANGED
@@ -15,7 +15,7 @@ instructions.
15
15
  ## Prerequisites
16
16
 
17
17
  - Node.js `>=22.22.2 <23`.
18
- - `artifact-graph` 0.13.0 installed in the target project.
18
+ - `artifact-graph` 0.14.0 installed in the target project.
19
19
  - **GitHub SSH key** — Claude Code clones `source: github` entries over SSH by default. If you
20
20
  have not configured a GitHub SSH key, set `CLAUDE_CODE_PLUGIN_PREFER_HTTPS=1` in your shell
21
21
  profile, or add the marketplace with an explicit `https://` URL. Codex users can check
@@ -27,24 +27,24 @@ instructions.
27
27
 
28
28
  | Plugin | Verified Runtime | Install |
29
29
  | --- | --- | --- |
30
- | `artifact-chain-assistant` 0.13.0 | `artifact-graph` 0.13.0 | `pnpm add -D artifact-graph@0.13.0` |
30
+ | `artifact-chain-assistant` 0.14.0 | `artifact-graph` 0.14.0 | `pnpm add -D artifact-graph@0.14.0` |
31
31
 
32
32
  ### Install The Runtime
33
33
 
34
34
  The default installation path uses the npm registry with a precise version:
35
35
 
36
36
  ```bash
37
- pnpm add -D artifact-graph@0.13.0
37
+ pnpm add -D artifact-graph@0.14.0
38
38
  ```
39
39
 
40
40
  If the npm registry is unavailable, use the explicit GitHub fallback pinned to the verified tag:
41
41
 
42
42
  ```bash
43
- pnpm add -D github:ifoohoo/artifact-graph#artifact-graph-v0.13.0
43
+ pnpm add -D github:ifoohoo/artifact-graph#artifact-graph-v0.14.0
44
44
  ```
45
45
 
46
46
  > **Never** install with an unlocked range (`artifact-graph`, `artifact-graph@latest`,
47
- > `artifact-graph@^0.13.0`) or an unpinned GitHub URL (`github:ifoohoo/artifact-graph`).
47
+ > `artifact-graph@^0.14.0`) or an unpinned GitHub URL (`github:ifoohoo/artifact-graph`).
48
48
  > Unlocked installs produce non-reproducible dependency trees and break version-lock audit.
49
49
 
50
50
  With pnpm 10+, projects that install `artifact-graph` must allow the native `better-sqlite3`
@@ -71,7 +71,7 @@ allowBuilds:
71
71
 
72
72
  The plugin's `doctor` command validates the installed runtime version before running any
73
73
  diagnostic. If it detects a version mismatch or missing CLI, it reports the exact remediation
74
- command (`pnpm add -D artifact-graph@0.13.0`) and exits non-zero.
74
+ command (`pnpm add -D artifact-graph@0.14.0`) and exits non-zero.
75
75
 
76
76
  ### CLI Resolution Order
77
77
 
@@ -156,7 +156,7 @@ wrappers, and Stop-hook guardrail. These assistant controls do not replace Git h
156
156
 
157
157
  > **Marketplace note**: `ifoohoo/artifact-skill-set` is an external independent marketplace. The
158
158
  > plugin payload is still published from `ifoohoo/artifact-chain-assistant`. The marketplace entry
159
- > must publish and enable `artifact-chain-assistant` 0.13.0 before the install commands above will
159
+ > must publish and enable `artifact-chain-assistant` 0.14.0 before the install commands above will
160
160
  > succeed.
161
161
 
162
162
  ### Kimi Code
@@ -303,7 +303,7 @@ The plugin should not move these files into the plugin repository.
303
303
 
304
304
  For a first-time setup, the end-to-end sequence is:
305
305
 
306
- 1. **Install the CLI** — `pnpm add -D artifact-graph@0.13.0` (see Prerequisites above). The
306
+ 1. **Install the CLI** — `pnpm add -D artifact-graph@0.14.0` (see Prerequisites above). The
307
307
  `artifact-chain-setup` skill can run this and the other mechanical install steps for you
308
308
  after showing a plan and getting your confirmation.
309
309
  2. **Install the plugin** — follow the Codex or Claude Code section above.
@@ -1346,7 +1346,7 @@ with append-only behavior; it does not overwrite local rules.
1346
1346
  ### Recovery Steps
1347
1347
 
1348
1348
  ```bash
1349
- # 1. Install dependencies from lockfile (gets artifact-graph@0.13.0)
1349
+ # 1. Install dependencies from lockfile (gets artifact-graph@0.14.0)
1350
1350
  pnpm install --frozen-lockfile
1351
1351
 
1352
1352
  # 2. Install plugin per your host (Codex / Claude Code / Kimi Code)
@@ -1413,7 +1413,7 @@ pnpm exec artifact-graph hooks install-git --hook all
1413
1413
  ### Enterprise Mirror
1414
1414
 
1415
1415
  If the corporate environment cannot access the public npm registry or GitHub, mirror both
1416
- `artifact-graph@0.13.0` and the plugin marketplace repository on an internal registry. The mirror
1416
+ `artifact-graph@0.14.0` and the plugin marketplace repository on an internal registry. The mirror
1417
1417
  does not change the state ownership model: Git-tracked files remain authoritative, local caches
1418
1418
  remain derived.
1419
1419
 
package/README.md CHANGED
@@ -82,10 +82,13 @@ conformance, or release readiness. Release facts still come from the target proj
82
82
  and result records.
83
83
 
84
84
  Governance checks consume static checklists, project artifacts, and existing result records. They do
85
- not run target tests, builds, validators, hooks, or business workflows. If the selected specification
86
- is missing or unreadable, or a required public contract is not published, report the affected
87
- professional judgment as `unknown` or pending adoption rather than a target violation. Reuse explicit
88
- authorization already given for the same target and action; ask again when the scope expands.
85
+ not run target tests, builds, validators, hooks, or business workflows. `artifact-audit health`
86
+ routes to `artifact-graph check-professional` and `read-proof` for graph professional scan and proof
87
+ read; capability and release-gate keep their existing scopes. A graph `pass` does not prove content
88
+ semantics, method execution, or publication. If the selected specification is missing or unreadable,
89
+ or a required public contract is not published, report the affected professional judgment as
90
+ `unknown` or pending adoption rather than a target violation. Reuse explicit authorization already
91
+ given for the same target and action; ask again when the scope expands.
89
92
 
90
93
  ### Extended Artifact Catalog
91
94
 
@@ -201,13 +204,13 @@ override, compact query, fallback behavior, and `PLUGIN_ROOT` discovery, see
201
204
 
202
205
  | Plugin | Runtime | Install |
203
206
  | --- | --- | --- |
204
- | `artifact-chain-assistant` 0.13.0 | `artifact-graph` 0.13.0 | `pnpm add -D artifact-graph@0.13.0` |
207
+ | `artifact-chain-assistant` 0.14.0 | `artifact-graph` 0.14.0 | `pnpm add -D artifact-graph@0.14.0` |
205
208
 
206
209
  ## Install
207
210
 
208
211
  ```bash
209
212
  # Runtime (required)
210
- npm install --save-dev artifact-graph@0.13.0
213
+ npm install --save-dev artifact-graph@0.14.0
211
214
  ```
212
215
 
213
216
  ```bash
@@ -229,7 +232,7 @@ codex plugin add artifact-chain-assistant@artifact-skill-set
229
232
 
230
233
  > **Marketplace note**: `ifoohoo/artifact-skill-set` is an external independent marketplace. The
231
234
  > plugin payload is still published from `ifoohoo/artifact-chain-assistant`. The marketplace entry
232
- > must publish and enable `artifact-chain-assistant` 0.13.0 before the install commands above will
235
+ > must publish and enable `artifact-chain-assistant` 0.14.0 before the install commands above will
233
236
  > succeed.
234
237
 
235
238
  ```text
@@ -258,7 +261,7 @@ For the full installation guide, quick start, Agent prompts, and clone onboardin
258
261
 
259
262
  ## Quick Start
260
263
 
261
- 1. Install plugin 0.13.0 (above) and runtime: `pnpm add -D artifact-graph@0.13.0`.
264
+ 1. Install plugin 0.14.0 (above) and runtime: `pnpm add -D artifact-graph@0.14.0`.
262
265
  2. Run `artifact-graph doctor --root . --format json` to verify the runtime.
263
266
  3. For first-time setup, use the bootstrap skill.
264
267
  4. For daily work, use the maintainer skill.
package/README.zh-CN.md CHANGED
@@ -64,7 +64,9 @@ Audit 定义技能族制品规范,助手帮助项目采用适用的类型、
64
64
  发布工具和结果材料证明。
65
65
 
66
66
  治理检查只读取静态清单、项目制品和已有结果材料,不运行目标项目的测试、构建、validator、hook
67
- 或业务工作流。规范来源缺失、不可读,或所需公共合同尚未发布时,只把相应专业判断记为
67
+ 或业务工作流。`artifact-audit health` 路由到 `artifact-graph check-professional` 和 `read-proof`
68
+ 做图专业扫描与读证;capability 和 release-gate 仍走原范围。图检查 `pass` 不能证明内容语义、
69
+ 方法执行或已经发布。规范来源缺失、不可读,或所需公共合同尚未发布时,只把相应专业判断记为
68
70
  `unknown` 或待采用,不把目标判为违规。项目已经明确授权同一目标和动作时可以沿用该授权;范围
69
71
  扩大时仍需重新确认。
70
72
 
@@ -234,13 +236,13 @@ catalog 还包含 `artifact.generate`,用于从模板和 profile 配置生成
234
236
 
235
237
  | 插件 | 运行时 | 安装 |
236
238
  | --- | --- | --- |
237
- | `artifact-chain-assistant` 0.13.0 | `artifact-graph` 0.13.0 | `pnpm add -D artifact-graph@0.13.0` |
239
+ | `artifact-chain-assistant` 0.14.0 | `artifact-graph` 0.14.0 | `pnpm add -D artifact-graph@0.14.0` |
238
240
 
239
241
  ## 安装
240
242
 
241
243
  ```bash
242
244
  # 运行时(必需)
243
- npm install --save-dev artifact-graph@0.13.0
245
+ npm install --save-dev artifact-graph@0.14.0
244
246
  ```
245
247
 
246
248
  ```bash
@@ -262,7 +264,7 @@ codex plugin add artifact-chain-assistant@artifact-skill-set
262
264
 
263
265
  > **市场说明**:`ifoohoo/artifact-skill-set` 是外部独立市场,插件载荷仍由
264
266
  > `ifoohoo/artifact-chain-assistant` 发布。市场条目必须先发布并启用
265
- > `artifact-chain-assistant` 0.13.0,上述安装命令才能生效。
267
+ > `artifact-chain-assistant` 0.14.0,上述安装命令才能生效。
266
268
 
267
269
  ```text
268
270
  # Kimi Code 插件(交互式,user 作用域)
@@ -289,7 +291,7 @@ Qoder 当前承诺的边界是技能安装与发现;不提供 Claude Code 的
289
291
 
290
292
  ## 快速开始
291
293
 
292
- 1. 安装插件 0.13.0(见上文)和运行时:`pnpm add -D artifact-graph@0.13.0`。
294
+ 1. 安装插件 0.14.0(见上文)和运行时:`pnpm add -D artifact-graph@0.14.0`。
293
295
  2. 运行 `artifact-graph doctor --root . --format json` 验证运行时。
294
296
  3. 首次搭建,进入 bootstrap 技能。
295
297
  4. 日常工作,进入 maintainer 技能。
@@ -1,6 +1,6 @@
1
1
  {
2
2
  "name": "artifact-chain-assistant",
3
- "version": "0.13.0",
3
+ "version": "0.14.0",
4
4
  "description": "Artifact-chain intake, review/repair/batch/audit workflows, diagnostics, hooks, and version-lock maintenance helpers.",
5
5
  "author": {
6
6
  "name": "广州市风荷科技有限公司"
@@ -18,7 +18,7 @@ instructions.
18
18
  ## Prerequisites
19
19
 
20
20
  - Node.js `>=22.22.2 <23`.
21
- - `artifact-graph` 0.13.0 installed in the target project.
21
+ - `artifact-graph` 0.14.0 installed in the target project.
22
22
  - **GitHub SSH key** — Claude Code clones `source: github` entries over SSH by default. If you
23
23
  have not configured a GitHub SSH key, set `CLAUDE_CODE_PLUGIN_PREFER_HTTPS=1` in your shell
24
24
  profile, or add the marketplace with an explicit `https://` URL. Codex users can check
@@ -30,24 +30,24 @@ instructions.
30
30
 
31
31
  | Plugin | Verified Runtime | Install |
32
32
  | --- | --- | --- |
33
- | `artifact-chain-assistant` 0.13.0 | `artifact-graph` 0.13.0 | `pnpm add -D artifact-graph@0.13.0` |
33
+ | `artifact-chain-assistant` 0.14.0 | `artifact-graph` 0.14.0 | `pnpm add -D artifact-graph@0.14.0` |
34
34
 
35
35
  ### Install The Runtime
36
36
 
37
37
  The default installation path uses the npm registry with a precise version:
38
38
 
39
39
  ```bash
40
- pnpm add -D artifact-graph@0.13.0
40
+ pnpm add -D artifact-graph@0.14.0
41
41
  ```
42
42
 
43
43
  If the npm registry is unavailable, use the explicit GitHub fallback pinned to the verified tag:
44
44
 
45
45
  ```bash
46
- pnpm add -D github:ifoohoo/artifact-graph#artifact-graph-v0.13.0
46
+ pnpm add -D github:ifoohoo/artifact-graph#artifact-graph-v0.14.0
47
47
  ```
48
48
 
49
49
  > **Never** install with an unlocked range (`artifact-graph`, `artifact-graph@latest`,
50
- > `artifact-graph@^0.13.0`) or an unpinned GitHub URL (`github:ifoohoo/artifact-graph`).
50
+ > `artifact-graph@^0.14.0`) or an unpinned GitHub URL (`github:ifoohoo/artifact-graph`).
51
51
  > Unlocked installs produce non-reproducible dependency trees and break version-lock audit.
52
52
 
53
53
  With pnpm 10+, projects that install `artifact-graph` must allow the native `better-sqlite3`
@@ -74,7 +74,7 @@ allowBuilds:
74
74
 
75
75
  The plugin's `doctor` command validates the installed runtime version before running any
76
76
  diagnostic. If it detects a version mismatch or missing CLI, it reports the exact remediation
77
- command (`pnpm add -D artifact-graph@0.13.0`) and exits non-zero.
77
+ command (`pnpm add -D artifact-graph@0.14.0`) and exits non-zero.
78
78
 
79
79
  ### CLI Resolution Order
80
80
 
@@ -159,7 +159,7 @@ wrappers, and Stop-hook guardrail. These assistant controls do not replace Git h
159
159
 
160
160
  > **Marketplace note**: `ifoohoo/artifact-skill-set` is an external independent marketplace. The
161
161
  > plugin payload is still published from `ifoohoo/artifact-chain-assistant`. The marketplace entry
162
- > must publish and enable `artifact-chain-assistant` 0.13.0 before the install commands above will
162
+ > must publish and enable `artifact-chain-assistant` 0.14.0 before the install commands above will
163
163
  > succeed.
164
164
 
165
165
  ### Kimi Code
@@ -306,7 +306,7 @@ The plugin should not move these files into the plugin repository.
306
306
 
307
307
  For a first-time setup, the end-to-end sequence is:
308
308
 
309
- 1. **Install the CLI** — `pnpm add -D artifact-graph@0.13.0` (see Prerequisites above). The
309
+ 1. **Install the CLI** — `pnpm add -D artifact-graph@0.14.0` (see Prerequisites above). The
310
310
  `artifact-chain-setup` skill can run this and the other mechanical install steps for you
311
311
  after showing a plan and getting your confirmation.
312
312
  2. **Install the plugin** — follow the Codex or Claude Code section above.
@@ -1349,7 +1349,7 @@ with append-only behavior; it does not overwrite local rules.
1349
1349
  ### Recovery Steps
1350
1350
 
1351
1351
  ```bash
1352
- # 1. Install dependencies from lockfile (gets artifact-graph@0.13.0)
1352
+ # 1. Install dependencies from lockfile (gets artifact-graph@0.14.0)
1353
1353
  pnpm install --frozen-lockfile
1354
1354
 
1355
1355
  # 2. Install plugin per your host (Codex / Claude Code / Kimi Code)
@@ -1416,7 +1416,7 @@ pnpm exec artifact-graph hooks install-git --hook all
1416
1416
  ### Enterprise Mirror
1417
1417
 
1418
1418
  If the corporate environment cannot access the public npm registry or GitHub, mirror both
1419
- `artifact-graph@0.13.0` and the plugin marketplace repository on an internal registry. The mirror
1419
+ `artifact-graph@0.14.0` and the plugin marketplace repository on an internal registry. The mirror
1420
1420
  does not change the state ownership model: Git-tracked files remain authoritative, local caches
1421
1421
  remain derived.
1422
1422
 
@@ -1,7 +1,7 @@
1
1
  schemaVersion: 1
2
2
  catalog:
3
3
  id: artifact-chain-assistant
4
- version: "0.13.0"
4
+ version: "0.14.0"
5
5
  entries:
6
6
  - ref: artifact.prd-feature.default
7
7
  provider:
@@ -1,9 +1,9 @@
1
1
  {
2
2
  "schemaVersion": "1.0",
3
- "pluginVersion": "0.13.0",
3
+ "pluginVersion": "0.14.0",
4
4
  "artifactGraph": {
5
- "verifiedVersion": "0.13.0",
6
- "installSpec": "artifact-graph@0.13.0",
7
- "githubFallbackSpec": "github:ifoohoo/artifact-graph#artifact-graph-v0.13.0"
5
+ "verifiedVersion": "0.14.0",
6
+ "installSpec": "artifact-graph@0.14.0",
7
+ "githubFallbackSpec": "github:ifoohoo/artifact-graph#artifact-graph-v0.14.0"
8
8
  }
9
9
  }
@@ -2,7 +2,7 @@
2
2
  "schemaVersion": 1,
3
3
  "catalog": {
4
4
  "id": "artifact-chain-assistant",
5
- "version": "0.13.0"
5
+ "version": "0.14.0"
6
6
  },
7
7
  "families": [
8
8
  {
@@ -14,10 +14,10 @@ argument-hint: "<target> [--root <path>] [--format json|markdown]"
14
14
 
15
15
  本技能对三个审计域使用不同的配置要求:
16
16
 
17
- - **health**:可只依赖 `artifact-graph.config.yaml` 和运行时状态,不强制要求 profile。readiness check 确认项目标记存在即可。
17
+ - **health**:可只依赖 `artifact-graph.config.yaml` 和运行时状态,不强制要求 profile。health 先识别所选动作:专业扫描、刷新(扫描并写到新的绝对输出路径)或同族读证。扫描和刷新才检查项目标记;纯读证只使用调用方给出的证明根目录和相对路径。
18
18
  - **capability**:可只依赖 `artifact-graph.config.yaml` 和运行时状态,检查哪些 artifact type 有完整覆盖。
19
19
  - **release-gate**:必须存在 `workflows.audit.release-gate` 配置,并提供可读 checklist 作为发布材料。只有 validators 或项目 worker 声明时返回 `NEEDS_INPUT`,不得伪装为 health 检查。
20
- - **readiness check**:执行前调用 `check-workflow-profile.mjs` 确认必要配置就绪。该脚本只解析配置、worker 和资源,不启动 validator 或项目 worker。三个域分别调用,不混用。
20
+ - **readiness check**:扫描、刷新、capability 和 release-gate 在执行前调用 `check-workflow-profile.mjs` 确认必要配置就绪。该脚本只解析配置、worker 和资源,不启动 validator 或项目 worker。三个域分别调用,不混用。纯读证不调用该脚本。
21
21
 
22
22
  ```bash
23
23
  node <plugin-root>/scripts/check-workflow-profile.mjs \
@@ -27,7 +27,7 @@ node <plugin-root>/scripts/check-workflow-profile.mjs \
27
27
  --root <project-root> --action audit --domain release-gate --format json
28
28
  ```
29
29
 
30
- health/capability 返回 `NEEDS_INPUT` 时只报告缺失的项目标记;release-gate 返回 `NEEDS_INPUT` 时要求补齐配置和可读 checklist。
30
+ 扫描、刷新或 capability 返回 `NEEDS_INPUT` 时只报告缺失的项目标记;release-gate 返回 `NEEDS_INPUT` 时要求补齐配置和可读 checklist。纯读证不走这条项目就绪判定。
31
31
 
32
32
  ## 使用
33
33
 
@@ -37,27 +37,36 @@ health/capability 返回 `NEEDS_INPUT` 时只报告缺失的项目标记;relea
37
37
  /artifact-audit capability --root <path> [--format json|markdown]
38
38
  ```
39
39
 
40
- 先运行只读检查:
40
+ 先识别所选动作,再决定要不要做项目就绪检查。
41
+
42
+ 扫描或刷新时运行:
41
43
 
42
44
  ```bash
43
45
  node <plugin-root>/scripts/check-workflow-profile.mjs \
44
46
  --root <project-root> --action audit --domain health --format json
45
47
  ```
46
48
 
47
- 返回 `NEEDS_INPUT` 时只报告缺失的项目标记;不得继续输出发布就绪结论。
49
+ 返回 `NEEDS_INPUT` 时只报告缺失的项目标记;不得继续扫描或刷新。
50
+
51
+ 纯读证直接运行 `artifact-graph read-proof --proof-root <root> --proof <relative> --format json`。仅有证明文件、没有 `artifact-graph.config.yaml` 的目录也可以读证;不要对该目录调用 `check-workflow-profile.mjs`。
48
52
 
49
53
  | 子命令 | 说明 |
50
54
  |--------|------|
51
- | health | 制品链健康检查(validate + version-lock + 追溯覆盖率) |
52
- | release-gate | 发布材料检查(health + profile 提供的可读 checklist) |
55
+ | health | 路由到 `artifact-graph check-professional` / `read-proof` 的制品链健康检查 |
56
+ | release-gate | 发布材料检查(读取已有 health 结果 + profile 提供的可读 checklist) |
53
57
  | capability | 能力审计(哪些 artifact type 有完整覆盖、哪些缺失) |
54
58
 
55
59
  ## 健康检查项
56
60
 
57
- 1. **validate**:运行 `artifact-graph validate --root <path> --warning-only`。
58
- 2. **version-lock**:运行 `artifact-graph version-lock audit --root <path> --strict-missing-lock`。
59
- 3. **追溯覆盖率**:统计有代码/测试追溯的 artifact 比例。
60
- 4. **孤立检测**:无消费者或无生产者的 artifact。
61
+ health 只解释图内核已经组合好的只读检查,不增加领域规则,也不把 Review Result 当作新合同。
62
+
63
+ 1. **专业扫描**:运行 `artifact-graph check-professional --root <path> --format json`。该命令在内核组合已有 `validate`、`version-lock audit` 和 `coverage`,不先执行会写缓存的 `scan`。
64
+ 2. **共同证明**:调用方需要证明文件时再显式给出 `--conclusion-output <absolute-path>`。文件只在该绝对路径排他创建,不覆盖已有证明,也不写入目标图缓存。
65
+ 3. **同族读证**:运行 `artifact-graph read-proof --proof-root <root> --proof <relative> --format json`,只解释本族证明,不重新扫描目标,也不依赖当前目标配置或项目就绪检查。
66
+ 4. **领域码**:`GRAPH_CLEAR` 且 `completion=complete` 才是读证 `pass`。`GRAPH_FINDINGS`、`GRAPH_CHECK_INCOMPLETE`、`GRAPH_CHECK_UNAVAILABLE` 都是 `not_pass`。缺文件、损坏 JSON、非本族或未知领域码是 `unavailable`(退出 2)。
67
+ 5. **范围**:`complete` 只表示声明范围内的检查做完,不等于通过。warning-only 的原生退出 0 仍可能含 issues,必须读取原始 issues。
68
+
69
+ capability 与 release-gate 保持原范围,不改走新证明合同。
61
70
 
62
71
  ## 发布门检查项
63
72
 
@@ -68,7 +77,8 @@ node <plugin-root>/scripts/check-workflow-profile.mjs \
68
77
 
69
78
  ## 约束
70
79
 
71
- - health/capability 调用 artifact-graph CLI 读取通用图检查结果;`--warning-only` 退出 0 时仍读取并报告 issues。
80
+ - health 路由到 `check-professional` 与 `read-proof`;不要用 `scan` 冒充检查。capability 仍读取原图 CLI 的类型覆盖结果。
81
+ - `--warning-only` 退出 0 时仍读取并报告 issues;图结果不代替内容语义、方法执行或发布事实。
72
82
  - release-gate 只读取配置、checklist 和已有材料,不运行目标测试、构建、安全脚本、hooks 或项目 worker。
73
83
  - 不修改项目文件。
74
84
  - 结果以 JSON 或 Markdown 输出。
@@ -76,7 +86,8 @@ node <plugin-root>/scripts/check-workflow-profile.mjs \
76
86
 
77
87
  ## 故障诊断
78
88
 
79
- - 缺 `artifact-graph.config.yaml` 与 `artifacts/`:返回 `NEEDS_INPUT`。
89
+ - 扫描或刷新缺 `artifact-graph.config.yaml` 与 `artifacts/`:返回 `NEEDS_INPUT`。
90
+ - 纯读证缺文件、损坏 JSON、非本族或未知领域码:保留 `read-proof` 的 `unavailable`(退出 2),不改写成项目未就绪。
80
91
  - CLI validate/version-lock 非零:保留原始命令、退出码与诊断,release-gate 返回失败。
81
92
  - release-gate 只有 validator 或项目 worker、没有可读 checklist:返回 `NEEDS_INPUT`,并指向本入口的材料要求和 release-skill。
82
93
  - 项目专用发布材料:由项目 checklist 声明;本技能不推断或硬编码规则。
@@ -98,13 +98,13 @@ Registry projection: NOT_AVAILABLE (REGISTRY_V2_REQUIRED)
98
98
  ## 从需求到交付的公开分工
99
99
 
100
100
  - **技能负责工作方法**:`artifact-chain-requirements` 保存原始诉求、处置与 SPEC 承接;`artifact-chain-where-am-i` 盘点和定位;制作、审阅、修复技能根据可执行 profile 工作。
101
- - **artifact-graph CLI 负责确定性图操作**:用 `artifact-graph query --from <type>:<id>` 查询关系,用 `artifact-graph context --target <type>:<id> --mode implementation` 组装上下文,用 `artifact-graph validate --root <root> --warning-only` 检查图。
101
+ - **artifact-graph CLI 负责确定性图操作**:用 `artifact-graph query --from <type>:<id>` 查询关系,用 `artifact-graph context --target <type>:<id> --mode implementation` 组装上下文,用 `artifact-graph validate --root <root> --warning-only` 检查图。需要可复用的图专业证明时,用 `artifact-graph check-professional --root <root> --format json` 做只读扫描,再用 `artifact-graph read-proof --proof-root <root> --proof <relative> --format json` 解释本族证明;不要把 Review Result 或 `scan` 缓存当作该合同。
102
102
  - **制品重组技能只补语义判断**:`artifact-chain-restructure` 调用 `artifact-graph restructure inspect/plan` 生成候选;完整人工映射和纯确定性路径直接使用 CLI。授权覆盖且独立复审通过后,同一入口才路由 `restructure apply`、`recover`、`prune-recovery`:apply 需要操作者给出 `--confirm-cooperative-writers`,recover 需要两项维护确认,prune 的普通路径同样需要合作式声明。文件迁移与锁收尾分别报告;计划阶段结果不得报告为已经迁移。
103
103
  - **Node API 负责程序化组合**:从 `artifact-graph` 导入 `loadConfig`、`scanArtifacts` 与 `queryGraph`,读取项目配置后扫描,再按 `{ from: '<type>:<id>', schema }` 查询;调用方负责展示或消费结果。
104
104
  - **测试与 E2E 负责行为验证**:测试文件或 `verifies` 声明只表明验证意图;只有实际运行结果或验收记录能证明验证事实。
105
105
  - **目标项目的发布工具负责发布**:插件不代替 npm、GitHub、应用商店或部署系统。发布事实必须引用工具结果和精确版本。
106
106
 
107
- 环境问题用 `artifact-chain-setup` 和 `artifact-graph doctor`;图关系与覆盖健康用 `artifact-audit`。批准、实现、验证、发布四类事实分别给证据,缺证据时显示 `unknown`。
107
+ 环境问题用 `artifact-chain-setup` 和 `artifact-graph doctor`;图关系与覆盖健康用 `artifact-audit health`,它路由到上述专业扫描和读证。批准、实现、验证、发布四类事实分别给证据,缺证据时显示 `unknown`。
108
108
 
109
109
  ## Registry 不可用时的诚实降级
110
110
 
@@ -176,6 +176,16 @@ description: artifact-chain-assistant 插件内的统一路由入口。用户用
176
176
 
177
177
  **最小提示词**:`请先盘点项目事实和规范适用性,再说明配置采用、通用图检查与专业判断各由谁负责。`
178
178
 
179
+ ### 图专业证明或 health 扫描
180
+
181
+ **匹配关键词**:图专业证明、check-professional、read-proof、制品链 health、图健康扫描、读取图证明
182
+
183
+ **路由目标**:`artifact-audit`
184
+
185
+ **理由**:`artifact-audit health` 路由到 `artifact-graph check-professional` 与 `read-proof`。capability 和 release-gate 仍走原范围,不把图通过当成内容语义、方法执行或发布事实。
186
+
187
+ **最小提示词**:`请用 artifact-audit health 做图专业扫描;若需要证明文件,再给出绝对输出路径并用 read-proof 阅读。`
188
+
179
189
  ### 意图不明确
180
190
 
181
191
  **行为**:输出追问,不猜测路由。
@@ -1,7 +1,7 @@
1
1
  {
2
2
  "name": "artifact-chain-assistant",
3
3
  "displayName": "Artifact Chain Assistant",
4
- "version": "0.13.0",
4
+ "version": "0.14.0",
5
5
  "description": "Artifact-chain intake, review/repair/batch/audit workflows, diagnostics, and version-lock maintenance helpers.",
6
6
  "author": {
7
7
  "name": "广州市风荷科技有限公司"
@@ -18,7 +18,7 @@ instructions.
18
18
  ## Prerequisites
19
19
 
20
20
  - Node.js `>=22.22.2 <23`.
21
- - `artifact-graph` 0.13.0 installed in the target project.
21
+ - `artifact-graph` 0.14.0 installed in the target project.
22
22
  - **GitHub SSH key** — Claude Code clones `source: github` entries over SSH by default. If you
23
23
  have not configured a GitHub SSH key, set `CLAUDE_CODE_PLUGIN_PREFER_HTTPS=1` in your shell
24
24
  profile, or add the marketplace with an explicit `https://` URL. Codex users can check
@@ -30,24 +30,24 @@ instructions.
30
30
 
31
31
  | Plugin | Verified Runtime | Install |
32
32
  | --- | --- | --- |
33
- | `artifact-chain-assistant` 0.13.0 | `artifact-graph` 0.13.0 | `pnpm add -D artifact-graph@0.13.0` |
33
+ | `artifact-chain-assistant` 0.14.0 | `artifact-graph` 0.14.0 | `pnpm add -D artifact-graph@0.14.0` |
34
34
 
35
35
  ### Install The Runtime
36
36
 
37
37
  The default installation path uses the npm registry with a precise version:
38
38
 
39
39
  ```bash
40
- pnpm add -D artifact-graph@0.13.0
40
+ pnpm add -D artifact-graph@0.14.0
41
41
  ```
42
42
 
43
43
  If the npm registry is unavailable, use the explicit GitHub fallback pinned to the verified tag:
44
44
 
45
45
  ```bash
46
- pnpm add -D github:ifoohoo/artifact-graph#artifact-graph-v0.13.0
46
+ pnpm add -D github:ifoohoo/artifact-graph#artifact-graph-v0.14.0
47
47
  ```
48
48
 
49
49
  > **Never** install with an unlocked range (`artifact-graph`, `artifact-graph@latest`,
50
- > `artifact-graph@^0.13.0`) or an unpinned GitHub URL (`github:ifoohoo/artifact-graph`).
50
+ > `artifact-graph@^0.14.0`) or an unpinned GitHub URL (`github:ifoohoo/artifact-graph`).
51
51
  > Unlocked installs produce non-reproducible dependency trees and break version-lock audit.
52
52
 
53
53
  With pnpm 10+, projects that install `artifact-graph` must allow the native `better-sqlite3`
@@ -74,7 +74,7 @@ allowBuilds:
74
74
 
75
75
  The plugin's `doctor` command validates the installed runtime version before running any
76
76
  diagnostic. If it detects a version mismatch or missing CLI, it reports the exact remediation
77
- command (`pnpm add -D artifact-graph@0.13.0`) and exits non-zero.
77
+ command (`pnpm add -D artifact-graph@0.14.0`) and exits non-zero.
78
78
 
79
79
  ### CLI Resolution Order
80
80
 
@@ -159,7 +159,7 @@ wrappers, and Stop-hook guardrail. These assistant controls do not replace Git h
159
159
 
160
160
  > **Marketplace note**: `ifoohoo/artifact-skill-set` is an external independent marketplace. The
161
161
  > plugin payload is still published from `ifoohoo/artifact-chain-assistant`. The marketplace entry
162
- > must publish and enable `artifact-chain-assistant` 0.13.0 before the install commands above will
162
+ > must publish and enable `artifact-chain-assistant` 0.14.0 before the install commands above will
163
163
  > succeed.
164
164
 
165
165
  ### Kimi Code
@@ -306,7 +306,7 @@ The plugin should not move these files into the plugin repository.
306
306
 
307
307
  For a first-time setup, the end-to-end sequence is:
308
308
 
309
- 1. **Install the CLI** — `pnpm add -D artifact-graph@0.13.0` (see Prerequisites above). The
309
+ 1. **Install the CLI** — `pnpm add -D artifact-graph@0.14.0` (see Prerequisites above). The
310
310
  `artifact-chain-setup` skill can run this and the other mechanical install steps for you
311
311
  after showing a plan and getting your confirmation.
312
312
  2. **Install the plugin** — follow the Codex or Claude Code section above.
@@ -1349,7 +1349,7 @@ with append-only behavior; it does not overwrite local rules.
1349
1349
  ### Recovery Steps
1350
1350
 
1351
1351
  ```bash
1352
- # 1. Install dependencies from lockfile (gets artifact-graph@0.13.0)
1352
+ # 1. Install dependencies from lockfile (gets artifact-graph@0.14.0)
1353
1353
  pnpm install --frozen-lockfile
1354
1354
 
1355
1355
  # 2. Install plugin per your host (Codex / Claude Code / Kimi Code)
@@ -1416,7 +1416,7 @@ pnpm exec artifact-graph hooks install-git --hook all
1416
1416
  ### Enterprise Mirror
1417
1417
 
1418
1418
  If the corporate environment cannot access the public npm registry or GitHub, mirror both
1419
- `artifact-graph@0.13.0` and the plugin marketplace repository on an internal registry. The mirror
1419
+ `artifact-graph@0.14.0` and the plugin marketplace repository on an internal registry. The mirror
1420
1420
  does not change the state ownership model: Git-tracked files remain authoritative, local caches
1421
1421
  remain derived.
1422
1422
 
@@ -1,7 +1,7 @@
1
1
  schemaVersion: 1
2
2
  catalog:
3
3
  id: artifact-chain-assistant
4
- version: "0.13.0"
4
+ version: "0.14.0"
5
5
  entries:
6
6
  - ref: artifact.prd-feature.default
7
7
  provider:
@@ -1,9 +1,9 @@
1
1
  {
2
2
  "schemaVersion": "1.0",
3
- "pluginVersion": "0.13.0",
3
+ "pluginVersion": "0.14.0",
4
4
  "artifactGraph": {
5
- "verifiedVersion": "0.13.0",
6
- "installSpec": "artifact-graph@0.13.0",
7
- "githubFallbackSpec": "github:ifoohoo/artifact-graph#artifact-graph-v0.13.0"
5
+ "verifiedVersion": "0.14.0",
6
+ "installSpec": "artifact-graph@0.14.0",
7
+ "githubFallbackSpec": "github:ifoohoo/artifact-graph#artifact-graph-v0.14.0"
8
8
  }
9
9
  }
@@ -2,7 +2,7 @@
2
2
  "schemaVersion": 1,
3
3
  "catalog": {
4
4
  "id": "artifact-chain-assistant",
5
- "version": "0.13.0"
5
+ "version": "0.14.0"
6
6
  },
7
7
  "families": [
8
8
  {