artifact-chain-assistant 0.8.0

package/adapters/claude/agent-methods/catalog.yaml

@@ -0,0 +1,260 @@
+schemaVersion: 1
+catalog:
+  id: artifact-chain-assistant
+  version: "0.8.0"
+entries:
+  - ref: artifact.prd-feature.default
+    provider:
+      scope: plugin
+      plugin: artifact-chain-assistant
+      skill: prd-feature
+    kind: workflow
+    summary: "PRD feature 默认路由入口，按意图分派到 author/review/repair"
+    match:
+      domains: [artifact]
+      artifactTypes: [prd-feature]
+      intents: [route]
+    accepts:
+      - "用户需求描述或 PRD 制品变更请求"
+    produces:
+      - "PRD feature 制品草稿、审阅报告或修复补丁"
+    sideEffects:
+      - write-project-artifacts
+
+  - ref: artifact.prd-feature.author
+    provider:
+      scope: plugin
+      plugin: artifact-chain-assistant
+      skill: prd-feature/author
+    kind: workflow
+    summary: "PRD feature 制作入口，从需求描述生成 PRD feature 草稿"
+    match:
+      domains: [artifact]
+      artifactTypes: [prd-feature]
+      intents: [author]
+    accepts:
+      - "用户需求描述"
+    produces:
+      - "PRD feature 制品草稿"
+    sideEffects:
+      - write-project-artifacts
+
+  - ref: artifact.prd-feature.review
+    provider:
+      scope: plugin
+      plugin: artifact-chain-assistant
+      skill: prd-feature/review
+    kind: workflow
+    summary: "PRD feature 审阅入口，检查制品完整性、追溯性和一致性"
+    match:
+      domains: [artifact]
+      artifactTypes: [prd-feature]
+      intents: [review]
+    accepts:
+      - "PRD feature 制品"
+    produces:
+      - "审阅报告"
+    sideEffects:
+      - write-project-artifacts
+
+  - ref: artifact.prd-feature.repair
+    provider:
+      scope: plugin
+      plugin: artifact-chain-assistant
+      skill: prd-feature/repair
+    kind: workflow
+    summary: "PRD feature 修复入口，根据审阅报告修复制品问题"
+    match:
+      domains: [artifact]
+      artifactTypes: [prd-feature]
+      intents: [repair]
+    accepts:
+      - "审阅报告和待修复的 PRD feature 制品"
+    produces:
+      - "修复后的 PRD feature 制品"
+    sideEffects:
+      - write-project-artifacts
+
+  - ref: artifact.scenario-script.default
+    provider:
+      scope: plugin
+      plugin: artifact-chain-assistant
+      skill: scenario-script
+    kind: workflow
+    summary: "场景剧本默认路由入口，按意图分派到 author/review/repair"
+    match:
+      domains: [artifact]
+      artifactTypes: [scenario-script]
+      intents: [route]
+    accepts:
+      - "需求描述或场景剧本变更请求"
+    produces:
+      - "场景剧本草稿、审阅报告或修复补丁"
+    sideEffects:
+      - write-project-artifacts
+
+  - ref: artifact.scenario-script.author
+    provider:
+      scope: plugin
+      plugin: artifact-chain-assistant
+      skill: scenario-script/author
+    kind: workflow
+    summary: "场景剧作入口，从需求描述生成场景剧本草稿"
+    match:
+      domains: [artifact]
+      artifactTypes: [scenario-script]
+      intents: [author]
+    accepts:
+      - "需求描述"
+    produces:
+      - "场景剧本草稿"
+    sideEffects:
+      - write-project-artifacts
+
+  - ref: artifact.scenario-script.review
+    provider:
+      scope: plugin
+      plugin: artifact-chain-assistant
+      skill: scenario-script/review
+    kind: workflow
+    summary: "场景剧本审阅入口，检查剧本完整性、场景覆盖和追溯关系"
+    match:
+      domains: [artifact]
+      artifactTypes: [scenario-script]
+      intents: [review]
+    accepts:
+      - "场景剧本"
+    produces:
+      - "审阅报告"
+    sideEffects:
+      - write-project-artifacts
+
+  - ref: artifact.scenario-script.repair
+    provider:
+      scope: plugin
+      plugin: artifact-chain-assistant
+      skill: scenario-script/repair
+    kind: workflow
+    summary: "场景剧本修复入口，根据审阅报告修复剧本问题"
+    match:
+      domains: [artifact]
+      artifactTypes: [scenario-script]
+      intents: [repair]
+    accepts:
+      - "审阅报告和待修复的场景剧本"
+    produces:
+      - "修复后的场景剧本"
+    sideEffects:
+      - write-project-artifacts
+
+  # ── 通用跨类型入口 ──────────────────────────────────────────────────────
+
+  - ref: artifact.review
+    provider:
+      scope: plugin
+      plugin: artifact-chain-assistant
+      skill: artifact-review
+    kind: workflow
+    summary: "通用制品审阅路由，按 domain 分派到类型专用 worker"
+    match:
+      domains: [artifact]
+      artifactTypes: [design-spec, link, e2e, domain, contract, blueprint, verification]
+      intents: [review]
+    accepts:
+      - "制品文件或目录路径"
+    produces:
+      - "Review Result Protocol v1.0 审阅结果"
+    sideEffects:
+      - write-project-artifacts
+
+  - ref: artifact.repair
+    provider:
+      scope: plugin
+      plugin: artifact-chain-assistant
+      skill: artifact-repair
+    kind: workflow
+    summary: "通用制品修复入口，根据审阅结果修复 open findings"
+    match:
+      domains: [artifact]
+      artifactTypes: [design-spec, link, e2e, domain, contract, blueprint, verification]
+      intents: [repair]
+    accepts:
+      - "审阅结果 JSON 和待修复制品"
+    produces:
+      - "Review Result Protocol v1.0 修复结果"
+    sideEffects:
+      - write-project-artifacts
+
+  - ref: artifact.batch
+    provider:
+      scope: plugin
+      plugin: artifact-chain-assistant
+      skill: artifact-batch
+    kind: workflow
+    summary: "通用批处理编排，确定性切分与合并 Review Result"
+    match:
+      domains: [artifact]
+      artifactTypes: [design-spec, link, e2e, domain, contract, blueprint, verification]
+      intents: [batch]
+    accepts:
+      - "制品目录和批处理参数"
+    produces:
+      - "Review Result Protocol v1.0 批次汇总"
+    sideEffects:
+      - write-project-artifacts
+
+  - ref: artifact.audit
+    provider:
+      scope: plugin
+      plugin: artifact-chain-assistant
+      skill: artifact-audit
+    kind: workflow
+    summary: "制品链健康检查与能力审计"
+    match:
+      domains: [artifact]
+      artifactTypes: [design-spec, link, e2e, domain, contract, blueprint, verification]
+      intents: [audit, health]
+    accepts:
+      - "项目根路径"
+    produces:
+      - "健康检查报告或能力审计结果"
+    sideEffects:
+      - write-project-artifacts
+
+  - ref: artifact.generate
+    provider:
+      scope: plugin
+      plugin: artifact-chain-assistant
+      skill: artifact-generate
+    kind: workflow
+    summary: "通用制品生成入口，从模板和 profile 配置生成非 PRD/scenario 类型制品"
+    match:
+      domains: [artifact]
+      artifactTypes: [design-spec, link, e2e, domain, contract, blueprint, verification]
+      intents: [generate]
+    accepts:
+      - "制品类型、目标路径和模板配置"
+    produces:
+      - "从模板生成的制品文件"
+    sideEffects:
+      - write-project-artifacts
+
+  # ── 插件级发现入口 ──────────────────────────────────────────────────────
+
+  - ref: artifact-chain-help
+    provider:
+      scope: plugin
+      plugin: artifact-chain-assistant
+      skill: artifact-chain-help
+    kind: operation
+    summary: "展示标准 Family API、bundled legacy 方法和安装后采用步骤"
+    match:
+      domains: [artifact]
+      artifactTypes: [design-spec, link, e2e, domain, contract, blueprint, verification, prd-feature, scenario-script]
+      intents: [help]
+    accepts:
+      - "帮助请求或能力查询"
+    produces:
+      - "标准能力概览和采用指导"
+    sideEffects:
+      - read-only

package/adapters/claude/bin/version-lock-audit.sh

@@ -0,0 +1,21 @@
+#!/bin/sh
+set -u
+
+artifact_graph() {
+  if [ -x ./node_modules/.bin/artifact-graph ]; then
+    ./node_modules/.bin/artifact-graph "$@"
+    return $?
+  fi
+  if command -v artifact-graph >/dev/null 2>&1; then
+    artifact-graph "$@"
+    return $?
+  fi
+  if [ -n "${ARTIFACT_GRAPH_LEGACY_CLI:-}" ] && [ -f "$ARTIFACT_GRAPH_LEGACY_CLI" ]; then
+    node "$ARTIFACT_GRAPH_LEGACY_CLI" "$@"
+    return $?
+  fi
+  echo "artifact-chain-assistant: artifact-graph CLI not found; install it in the project or PATH." >&2
+  return 127
+}
+
+artifact_graph version-lock audit --strict-missing-lock "$@"

package/adapters/claude/bin/version-lock-refresh.sh

@@ -0,0 +1,21 @@
+#!/bin/sh
+set -u
+
+artifact_graph() {
+  if [ -x ./node_modules/.bin/artifact-graph ]; then
+    ./node_modules/.bin/artifact-graph "$@"
+    return $?
+  fi
+  if command -v artifact-graph >/dev/null 2>&1; then
+    artifact-graph "$@"
+    return $?
+  fi
+  if [ -n "${ARTIFACT_GRAPH_LEGACY_CLI:-}" ] && [ -f "$ARTIFACT_GRAPH_LEGACY_CLI" ]; then
+    node "$ARTIFACT_GRAPH_LEGACY_CLI" "$@"
+    return $?
+  fi
+  echo "artifact-chain-assistant: artifact-graph CLI not found; install it in the project or PATH." >&2
+  return 127
+}
+
+artifact_graph version-lock refresh --changed-only --staged "$@"

package/adapters/claude/commands/version-lock-audit.md

@@ -0,0 +1,9 @@
+---
+description: Run strict artifact-chain version lock audit
+---
+
+Run this command from the project root:
+
+```bash
+artifact-graph version-lock audit --strict-missing-lock
+```

package/adapters/claude/commands/version-lock-refresh.md

@@ -0,0 +1,9 @@
+---
+description: Refresh staged artifact-chain version locks
+---
+
+Run this command from the project root, then review and stage the lock file if it changes:
+
+```bash
+artifact-graph version-lock refresh --changed-only --staged --format markdown
+```

package/adapters/claude/compatibility.json

@@ -0,0 +1,9 @@
+{
+  "schemaVersion": "1.0",
+  "pluginVersion": "0.8.0",
+  "artifactGraph": {
+    "verifiedVersion": "0.8.0",
+    "installSpec": "artifact-graph@0.8.0",
+    "githubFallbackSpec": "github:ifoohoo/artifact-graph#artifact-graph-v0.8.0"
+  }
+}

package/adapters/claude/hooks/hooks.json

@@ -0,0 +1,16 @@
+{
+  "hooks": {
+    "Stop": [
+      {
+        "matcher": "*",
+        "hooks": [
+          {
+            "type": "command",
+            "command": "node",
+            "args": ["${CLAUDE_PLUGIN_ROOT}/hooks/version-lock-stop.mjs"]
+          }
+        ]
+      }
+    ]
+  }
+}

package/adapters/claude/hooks/version-lock-stop.mjs

@@ -0,0 +1,77 @@
+#!/usr/bin/env node
+import { spawnSync } from 'node:child_process';
+import { existsSync } from 'node:fs';
+import { isAbsolute, join, resolve } from 'node:path';
+import { pathToFileURL } from 'node:url';
+
+export async function readHookEvent(input) {
+  let source = '';
+  for await (const chunk of input) {
+    source += chunk;
+  }
+  if (source.trim() === '') return {};
+
+  const event = JSON.parse(source);
+  if (event === null || Array.isArray(event) || typeof event !== 'object') {
+    throw new Error('Claude hook input must be a JSON object');
+  }
+  return event;
+}
+
+export function buildCliCandidates(root, env) {
+  const candidates = [
+    { command: join(root, 'node_modules', '.bin', 'artifact-graph'), prefix: [] },
+    { command: 'artifact-graph', prefix: [] },
+  ];
+  const legacyCli = env.ARTIFACT_GRAPH_LEGACY_CLI;
+  if (legacyCli) {
+    const legacyPath = isAbsolute(legacyCli) ? legacyCli : resolve(root, legacyCli);
+    if (existsSync(legacyPath)) {
+      candidates.push({ command: process.execPath, prefix: [legacyPath] });
+    }
+  }
+  return candidates;
+}
+
+export async function runStopAudit({
+  input = process.stdin,
+  env = process.env,
+  cwd = process.cwd(),
+  spawn = spawnSync,
+  stderr = (text) => process.stderr.write(text),
+} = {}) {
+  let event;
+  try {
+    event = await readHookEvent(input);
+  } catch (error) {
+    stderr(`artifact-chain-assistant: invalid Claude hook input: ${error.message}\n`);
+    return 2;
+  }
+  if (event.stop_hook_active === true) return 0;
+
+  const root = resolve(env.CLAUDE_PROJECT_DIR || cwd);
+  if (!existsSync(join(root, 'artifact-graph.config.yaml')) &&
+      !existsSync(join(root, 'artifacts', 'traceability-version-lock.json'))) {
+    return 0;
+  }
+
+  for (const candidate of buildCliCandidates(root, env)) {
+    const result = spawn(candidate.command, [
+      ...candidate.prefix,
+      'version-lock', 'audit', '--root', root, '--strict-missing-lock',
+    ], { cwd: root, env, stdio: ['ignore', 'ignore', 'inherit'] });
+    if (result.error?.code === 'ENOENT') continue;
+    if (result.error || result.status !== 0) {
+      stderr('artifact-chain-assistant: version-lock audit failed; repair the lock before stopping.\n');
+      return 2;
+    }
+    return 0;
+  }
+
+  stderr('artifact-chain-assistant: artifact-graph CLI not found.\n');
+  return 2;
+}
+
+if (process.argv[1] && import.meta.url === pathToFileURL(process.argv[1]).href) {
+  process.exitCode = await runStopAudit();
+}

package/adapters/claude/schemas/artifact-workflow-profile.schema.json

@@ -0,0 +1,72 @@
+{
+  "$schema": "http://json-schema.org/draft-07/schema#",
+  "$id": "https://artifact-graph.dev/schemas/artifact-workflow-profile.schema.json",
+  "title": "Artifact Workflow Profile",
+  "description": "Project workflow profile for artifact-chain-assistant",
+  "type": "object",
+  "required": ["schema_version", "project", "workflows"],
+  "additionalProperties": false,
+  "properties": {
+    "schema_version": {
+      "type": "integer",
+      "const": 1
+    },
+    "project": {
+      "type": "object",
+      "required": ["id", "language"],
+      "additionalProperties": false,
+      "properties": {
+        "id": {
+          "type": "string",
+          "minLength": 1,
+          "pattern": "^[a-z][a-z0-9-]*$"
+        },
+        "language": {
+          "type": "string",
+          "minLength": 1
+        },
+        "name": {
+          "type": "string"
+        }
+      }
+    },
+    "workflows": {
+      "type": "object",
+      "propertyNames": {
+        "enum": ["generate", "review", "repair", "audit", "batch"]
+      },
+      "additionalProperties": {
+        "type": "object",
+        "additionalProperties": {
+          "type": "object",
+          "additionalProperties": false,
+          "properties": {
+            "checklists": {
+              "type": "array",
+              "items": { "type": "string" }
+            },
+            "validators": {
+              "type": "array",
+              "items": { "type": "string" }
+            },
+            "templates": {
+              "type": "array",
+              "items": { "type": "string" }
+            },
+            "worker": {
+              "type": "object",
+              "additionalProperties": false,
+              "properties": {
+                "skill": {
+                  "type": "string",
+                  "minLength": 1,
+                  "description": "Project workflow skill name, not a filesystem path"
+                }
+              }
+            }
+          }
+        }
+      }
+    }
+  }
+}