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.
- package/.claude-plugin/plugin.json +1 -1
- package/.codex-plugin/plugin.json +1 -1
- package/.kimi-plugin/plugin.json +1 -1
- package/CHANGELOG.md +13 -0
- package/INSTALL.md +10 -10
- package/README.md +11 -8
- package/README.zh-CN.md +7 -5
- package/adapters/claude/.claude-plugin/plugin.json +1 -1
- package/adapters/claude/INSTALL.md +10 -10
- package/adapters/claude/agent-methods/catalog.yaml +1 -1
- package/adapters/claude/compatibility.json +4 -4
- package/adapters/claude/family-apis/catalog.json +1 -1
- package/adapters/claude/skills/artifact-audit/SKILL.md +24 -13
- package/adapters/claude/skills/artifact-chain-help/SKILL.md +2 -2
- package/adapters/claude/skills/artifact-chain-quickstart/SKILL.md +10 -0
- package/adapters/codex/.codex-plugin/plugin.json +1 -1
- package/adapters/codex/INSTALL.md +10 -10
- package/adapters/codex/agent-methods/catalog.yaml +1 -1
- package/adapters/codex/compatibility.json +4 -4
- package/adapters/codex/family-apis/catalog.json +1 -1
- package/adapters/codex/skills/artifact-audit/SKILL.md +24 -13
- package/adapters/codex/skills/artifact-chain-help/SKILL.md +2 -2
- package/adapters/codex/skills/artifact-chain-quickstart/SKILL.md +10 -0
- package/adapters/kimi/.kimi-plugin/plugin.json +1 -1
- package/adapters/kimi/INSTALL.md +10 -10
- package/adapters/kimi/agent-methods/catalog.yaml +1 -1
- package/adapters/kimi/compatibility.json +4 -4
- package/adapters/kimi/family-apis/catalog.json +1 -1
- package/adapters/kimi/skills/artifact-audit/SKILL.md +24 -13
- package/adapters/kimi/skills/artifact-chain-help/SKILL.md +2 -2
- package/adapters/kimi/skills/artifact-chain-quickstart/SKILL.md +10 -0
- package/agent-methods/catalog.yaml +1 -1
- package/compatibility.json +4 -4
- package/family-apis/catalog.json +1 -1
- package/package.json +2 -2
- package/site/00-matrix.html +1 -1
- package/site/01-what.html +1 -1
- package/site/02-architecture.html +1 -1
- package/site/03-concepts.html +1 -1
- package/site/04-cli.html +1 -1
- package/site/05-scenarios.html +1 -1
- package/site/06-method-registry.html +1 -1
- package/site/07-glossary.html +1 -1
- package/site/08-maintainer.html +1 -1
- package/site/09-troubleshoot.html +2 -2
- package/site/10-roadmap.html +1 -1
- package/site/index.html +2 -2
- package/skills/artifact-audit/SKILL.md +24 -13
- package/skills/artifact-chain-help/SKILL.md +2 -2
- package/skills/artifact-chain-quickstart/SKILL.md +10 -0
- package/skills-src/artifact-audit/SKILL.md +24 -13
- package/skills-src/artifact-chain-help/SKILL.md +2 -2
- package/skills-src/artifact-chain-quickstart/SKILL.md +10 -0
|
@@ -1,7 +1,7 @@
|
|
|
1
1
|
{
|
|
2
2
|
"name": "artifact-chain-assistant",
|
|
3
3
|
"displayName": "Artifact Chain Assistant",
|
|
4
|
-
"version": "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": "广州市风荷科技有限公司"
|
package/.kimi-plugin/plugin.json
CHANGED
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.
|
|
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.
|
|
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.
|
|
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.
|
|
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.
|
|
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.
|
|
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.
|
|
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.
|
|
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.
|
|
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.
|
|
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.
|
|
86
|
-
|
|
87
|
-
|
|
88
|
-
|
|
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.
|
|
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.
|
|
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.
|
|
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.
|
|
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.
|
|
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.
|
|
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.
|
|
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.
|
|
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 技能。
|
|
@@ -18,7 +18,7 @@ instructions.
|
|
|
18
18
|
## Prerequisites
|
|
19
19
|
|
|
20
20
|
- Node.js `>=22.22.2 <23`.
|
|
21
|
-
- `artifact-graph` 0.
|
|
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.
|
|
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.
|
|
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.
|
|
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.
|
|
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.
|
|
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.
|
|
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.
|
|
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.
|
|
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.
|
|
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,9 +1,9 @@
|
|
|
1
1
|
{
|
|
2
2
|
"schemaVersion": "1.0",
|
|
3
|
-
"pluginVersion": "0.
|
|
3
|
+
"pluginVersion": "0.14.0",
|
|
4
4
|
"artifactGraph": {
|
|
5
|
-
"verifiedVersion": "0.
|
|
6
|
-
"installSpec": "artifact-graph@0.
|
|
7
|
-
"githubFallbackSpec": "github:ifoohoo/artifact-graph#artifact-graph-v0.
|
|
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
|
}
|
|
@@ -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。
|
|
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
|
|
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
|
-
|
|
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 |
|
|
52
|
-
| release-gate |
|
|
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
|
-
|
|
58
|
-
|
|
59
|
-
|
|
60
|
-
|
|
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
|
|
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
|
-
-
|
|
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
|
|
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.
|
|
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.
|
|
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.
|
|
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.
|
|
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.
|
|
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.
|
|
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.
|
|
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.
|
|
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.
|
|
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.
|
|
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.
|
|
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,9 +1,9 @@
|
|
|
1
1
|
{
|
|
2
2
|
"schemaVersion": "1.0",
|
|
3
|
-
"pluginVersion": "0.
|
|
3
|
+
"pluginVersion": "0.14.0",
|
|
4
4
|
"artifactGraph": {
|
|
5
|
-
"verifiedVersion": "0.
|
|
6
|
-
"installSpec": "artifact-graph@0.
|
|
7
|
-
"githubFallbackSpec": "github:ifoohoo/artifact-graph#artifact-graph-v0.
|
|
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
|
}
|