@flyin-ai/alloy 0.1.0

package/commands/alloy/status.md

@@ -0,0 +1,79 @@
+---
+name: "Alloy: Status"
+description: 查看 Alloy change 的当前阶段、制品状态和下一步操作
+category: Workflow
+tags: [alloy, workflow]
+---
+
+# alloy-status
+
+你是 Alloy 的状态查看器。你的职责是：读取 change 的状态文件，检查文件系统，输出结构化的状态报告。
+
+状态信息通过 `alloy _state` 命令读取（保证解析一致性），文件存在性通过文件系统检查。
+
+---
+
+## 参数
+
+- `/alloy:status` — 显示所有活跃 change 总览
+- `/alloy:status <name>` — 显示指定 change 详情
+
+---
+
+## 无参数：总览模式
+
+```
+Alloy · 状态查看
+──────────────────────────────────────
+```
+
+扫描 `openspec/changes/*/.alloy.yaml`，对每个活跃 change 读取 phase 并检查制品状态：
+
+```
+活跃 Change：
+  login-feature  planned    artifacts: draft ✓ proposal ✓ design ✓ specs ✓ tasks ✓ plans ✓
+  payment-fix    started    artifacts: draft ✓
+
+下一步：login-feature 等待 /alloy:apply，payment-fix 等待 /alloy:plan
+```
+
+---
+
+## 指定 name：详情模式
+
+读取指定 change 的完整信息。先通过 `alloy _state` 获取元数据：
+```bash
+alloy _state read openspec/changes/<name> phase
+alloy _state read openspec/changes/<name> worktree
+alloy _state read openspec/changes/<name> created_at
+alloy _state read openspec/changes/<name> updated_at
+```
+
+再检查文件系统中各制品是否存在，输出：
+
+```
+阶段:    planned
+Change:  login-feature
+路径:    openspec/changes/login-feature/
+创建时间: 2026-05-28
+更新时间: 2026-05-28
+Worktree: .worktrees/login-feature/
+制品状态:
+  draft     ✓
+  proposal  ✓
+  design    ✓
+  specs     ✓
+  tasks     ✓
+  plans     ✓
+下一步:   等待 /alloy:apply
+```
+
+---
+
+## 一致性检查（自动附带）
+
+每次 status 运行时自动检查：
+
+1. `.alloy.yaml` 中 `worktree` 字段有值但磁盘路径不存在 → "worktree 残留"
+2. `.alloy.yaml` 中 `worktree` 字段为 null 但 `.worktrees/<name>/` 目录存在 → "worktree 孤儿"（状态写入缺失，apply 阶段可能未正确记录 worktree 路径）
+3. `git worktree list` 中存在孤立 worktree（`.worktrees/` 下存在目录但没有对应的 `.alloy.yaml`）→ 提示可能存在可清理的残留

package/compat.yaml

@@ -0,0 +1,10 @@
+compatible:
+  node: ">=18.0.0"
+  openspec: ">=1.3.0 <2.0.0"
+  superpowers: ">=5.0.0 <6.0.0"
+  alloy: ">=0.1.0"
+  schema: 1
+
+install:
+  openspec: "@fission-ai/openspec@1"
+  superpowers: "obra/superpowers@5"

package/dist/cli/commands/completion.d.ts

@@ -0,0 +1 @@
+export declare function generateCompletion(shell: string): string;

package/dist/cli/commands/completion.js

@@ -0,0 +1,155 @@
+export function generateCompletion(shell) {
+    if (shell.includes("zsh"))
+        return zshCompletion();
+    if (shell.includes("pwsh") || shell.includes("powershell"))
+        return powershellCompletion();
+    return bashCompletion();
+}
+function bashCompletion() {
+    return [
+        "# alloy bash completion — 添加到 ~/.bashrc 或 ~/.bash_profile:",
+        "#   source <(alloy completion bash)",
+        "",
+        "_alloy_completion() {",
+        '  local cur="${COMP_WORDS[COMP_CWORD]}"',
+        "",
+        "  if [ \"$COMP_CWORD\" -eq 1 ]; then",
+        '    COMPREPLY=($(compgen -W "-v --version -h --help init status doctor update completion" -- "$cur"))',
+        "    return 0",
+        "  fi",
+        "",
+        '  case "${COMP_WORDS[1]}" in',
+        "    init)",
+        '      COMPREPLY=($(compgen -W "--scope --inject-claude-md --help -h" -- "$cur"))',
+        "      ;;",
+        "    status|doctor)",
+        '      COMPREPLY=($(compgen -W "--json --help -h" -- "$cur"))',
+        "      ;;",
+        "    update)",
+        '      COMPREPLY=($(compgen -W "--help -h" -- "$cur"))',
+        "      ;;",
+        "    completion)",
+        '      COMPREPLY=($(compgen -W "bash zsh pwsh powershell" -- "$cur"))',
+        "      ;;",
+        "  esac",
+        "}",
+        "",
+        "complete -F _alloy_completion alloy",
+        "",
+    ].join("\n");
+}
+function zshCompletion() {
+    return [
+        "# alloy zsh completion — 添加到 ~/.zshrc:",
+        "#   source <(alloy completion zsh)",
+        "",
+        "#compdef alloy",
+        "",
+        "_alloy_commands() {",
+        "  local -a cmds",
+        "  cmds=(",
+        "    'init:项目初始化——检测环境 → 安装依赖 → 部署 schema + skill'",
+        "    'status:查看所有活跃 change 总览'",
+        "    'doctor:诊断——版本兼容性、文件一致性'",
+        "    'update:更新 Alloy skill 文件到最新版'",
+        "    'completion:生成 shell 补全脚本'",
+        "  )",
+        "  _describe 'command' cmds",
+        "}",
+        "",
+        "_alloy() {",
+        "  local context state state_descr line",
+        "  typeset -A opt_args",
+        "",
+        "  _arguments -C \\",
+        "    '--version[显示版本号]' \\",
+        "    '-v[显示版本号]' \\",
+        "    '--help[显示帮助]' \\",
+        "    '-h[显示帮助]' \\",
+        "    '1: :_alloy_commands' \\",
+        "    '*:: :->args'",
+        "",
+        "  case $state in",
+        "    args)",
+        "      case $words[1] in",
+        "        init)",
+        "          _arguments \\",
+        "            '--scope[安装范围]:scope:(project global)' \\",
+        "            '--inject-claude-md[注入 CLAUDE.md]' \\",
+        "            '--help[显示帮助]' \\",
+        "            '-h[显示帮助]'",
+        "          ;;",
+        "        status|doctor)",
+        "          _arguments \\",
+        "            '--json[JSON 格式输出]' \\",
+        "            '--help[显示帮助]' \\",
+        "            '-h[显示帮助]'",
+        "          ;;",
+        "        update|completion)",
+        "          _arguments \\",
+        "            '--help[显示帮助]' \\",
+        "            '-h[显示帮助]'",
+        "          ;;",
+        "      esac",
+        "      ;;",
+        "  esac",
+        "}",
+        "",
+        "# 注册补全（source 和 compinit 两种方式均兼容）",
+        "compdef _alloy alloy 2>/dev/null",
+        "",
+    ].join("\n");
+}
+function powershellCompletion() {
+    return [
+        "# alloy PowerShell completion",
+        "# 添加到 PowerShell profile（$PROFILE 所在目录可能不存在，需先创建）:",
+        "#   New-Item -ItemType Directory -Force -Path (Split-Path $PROFILE)",
+        "#   alloy completion pwsh | Out-File -FilePath $PROFILE -Append",
+        "#   重新加载 profile 使之生效: . $PROFILE（或重启 PowerShell）",
+        "",
+        "Register-ArgumentCompleter -Native -CommandName alloy -ScriptBlock {",
+        "  param($wordToComplete, $commandAst, $cursorPosition)",
+        "",
+        "  $commands = @('init', 'status', 'doctor', 'update', 'completion')",
+        "  $globalOpts = @('--version', '-v', '--help', '-h')",
+        "",
+        "  $tokens = $commandAst.CommandElements",
+        "  $command = $null",
+        "",
+        "  foreach ($token in $tokens) {",
+        "    $value = $token.Value",
+        "    if ($value -in $commands) {",
+        "      $command = $value",
+        "    }",
+        "  }",
+        "",
+        "  if (-not $command) {",
+        "    $completionText = @()",
+        "    foreach ($cmd in $commands) {",
+        '      if ($cmd -like "$wordToComplete*") { $completionText += $cmd }',
+        "    }",
+        "    foreach ($opt in $globalOpts) {",
+        '      if ($opt -like "$wordToComplete*") { $completionText += $opt }',
+        "    }",
+        "    $completionText | ForEach-Object { [System.Management.Automation.CompletionResult]::new($_, $_, 'ParameterValue', $_) }",
+        "    return",
+        "  }",
+        "",
+        "  $opts = @()",
+        "  switch ($command) {",
+        "    'init'    { $opts = @('--scope', '--inject-claude-md', '--help', '-h') }",
+        "    'status'  { $opts = @('--json', '--help', '-h') }",
+        "    'doctor'  { $opts = @('--json', '--help', '-h') }",
+        "    'update'  { $opts = @('--help', '-h') }",
+        "    'completion' { $opts = @('bash', 'zsh', 'pwsh', 'powershell', '--help', '-h') }",
+        "  }",
+        "",
+        "  $opts | Where-Object { $_ -like \"$wordToComplete*\" } | ForEach-Object {",
+        "    [System.Management.Automation.CompletionResult]::new($_, $_, 'ParameterValue', $_)",
+        "  }",
+        "}",
+        "",
+    ].join("\n");
+}
+//# sourceMappingURL=completion.js.map

package/dist/cli/commands/completion.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"completion.js","sourceRoot":"","sources":["../../../src/cli/commands/completion.ts"],"names":[],"mappings":"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"}

package/dist/cli/commands/doctor.d.ts

@@ -0,0 +1,7 @@
+import type { HealthCheckResult } from "../../core/types.js";
+export interface DoctorResult {
+    healthResults: HealthCheckResult[];
+    consistencyWarnings: string[];
+}
+export declare function doctorCommand(projectPath: string): Promise<DoctorResult>;
+export declare function formatDoctorResult(result: DoctorResult, useJson: boolean): string;

package/dist/cli/commands/doctor.js

@@ -0,0 +1,93 @@
+import { join, dirname } from "node:path";
+import { fileURLToPath } from "node:url";
+import { existsSync } from "node:fs";
+import { runHealthCheck } from "../../core/health.js";
+import { findActiveChanges } from "../utils/state.js";
+function detectScope(projectPath) {
+    const home = process.env.HOME || process.env.USERPROFILE || "~";
+    const probe = (dir) => existsSync(join(dir, ".claude", "commands", "alloy"));
+    if (probe(projectPath))
+        return "project";
+    if (probe(home))
+        return "global";
+    return undefined;
+}
+export async function doctorCommand(projectPath) {
+    const packageDir = join(dirname(fileURLToPath(import.meta.url)), "..", "..", "..");
+    const scope = detectScope(projectPath);
+    // 1. 版本兼容性
+    const healthResults = await runHealthCheck(packageDir, projectPath, scope);
+    // 2. 文件一致性（双向检查）
+    const consistencyWarnings = [];
+    const changesDir = join(projectPath, "openspec", "changes");
+    const changes = await findActiveChanges(changesDir);
+    for (const [name, state] of changes) {
+        const changePath = join(changesDir, name);
+        // 检查 1: worktree 字段有值但磁盘路径不存在
+        // "skipped" 是用户明确选择不创建 worktree 的标记，跳过此项检查
+        if (state.worktree && state.worktree !== "skipped") {
+            const worktreePath = join(projectPath, state.worktree);
+            if (!existsSync(worktreePath)) {
+                consistencyWarnings.push(`${name}: worktree 残留 — .alloy.yaml 声称 worktree 在 ${state.worktree} 但路径不可达`);
+            }
+        }
+        // 检查 2: worktree 字段为 null（从未设置）但 .worktrees/<name>/ 目录存在
+        // "skipped" 不触发此检查——用户选择不创建，孤儿目录由 git worktree list 覆盖
+        if (!state.worktree) {
+            const orphanPath = join(projectPath, ".worktrees", name);
+            if (existsSync(orphanPath)) {
+                consistencyWarnings.push(`${name}: worktree 孤儿 — .alloy.yaml 中 worktree 为 null 但 .worktrees/${name}/ 目录存在（状态写入可能缺失）`);
+            }
+        }
+    }
+    // 检查 3: git worktree list 中有孤立 worktree
+    try {
+        const { execSync } = await import("node:child_process");
+        const output = execSync("git worktree list --porcelain", {
+            cwd: projectPath,
+            stdio: "pipe",
+        }).toString();
+        const listedPaths = output
+            .split("\n")
+            .filter((line) => line.startsWith("worktree "))
+            .map((line) => line.slice("worktree ".length));
+        for (const wtPath of listedPaths) {
+            if (wtPath === projectPath)
+                continue; // 主 worktree
+            // 检查此 worktree 路径是否属于已知 change
+            const isTracked = [...changes.keys()].some((name) => {
+                const expectedPath = join(projectPath, ".worktrees", name);
+                return wtPath.startsWith(expectedPath);
+            });
+            if (!isTracked) {
+                consistencyWarnings.push(`孤立 worktree: ${wtPath}（不属于任何活跃 change）`);
+            }
+        }
+    }
+    catch {
+        // 不在 git 仓库中或无 worktree，跳过
+    }
+    return { healthResults, consistencyWarnings };
+}
+export function formatDoctorResult(result, useJson) {
+    if (useJson) {
+        return JSON.stringify(result, null, 2);
+    }
+    const lines = [];
+    lines.push("健康检查：");
+    for (const r of result.healthResults) {
+        const mark = r.status === "pass" ? "✓" : r.status === "warn" ? "⚠️" : "✗";
+        lines.push(`  ${mark} ${r.name}: ${r.current}（要求 ${r.required}）`);
+    }
+    if (result.consistencyWarnings.length > 0) {
+        lines.push("\n文件一致性：");
+        for (const w of result.consistencyWarnings) {
+            lines.push(`  ⚠️ ${w}`);
+        }
+    }
+    else {
+        lines.push("\n文件一致性：✓ 无问题");
+    }
+    return lines.join("\n");
+}
+//# sourceMappingURL=doctor.js.map

package/dist/cli/commands/doctor.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"doctor.js","sourceRoot":"","sources":["../../../src/cli/commands/doctor.ts"],"names":[],"mappings":"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"}

package/dist/cli/commands/init.d.ts

@@ -0,0 +1,6 @@
+import type { AgentInfo, DeployOptions } from "../../core/types.js";
+export declare function selectScope(passedScope?: string): Promise<"global" | "project">;
+export declare function selectTargetAgents(): Promise<AgentInfo[]>;
+export interface InitOptions extends DeployOptions {
+}
+export declare function initCommand(opts: InitOptions): Promise<void>;

package/dist/cli/commands/init.js

@@ -0,0 +1,168 @@
+import { readFile, writeFile } from "node:fs/promises";
+import { join } from "node:path";
+import { detectEnv } from "../../core/detect.js";
+import { runHealthCheck } from "../../core/health.js";
+import { installOpenSpecCli, initOpenSpecProject } from "../../core/openspec.js";
+import { installSuperpowers } from "../../core/superpowers.js";
+import { deployCommands, deploySchema } from "../../core/skills.js";
+import { injectClaudeMd } from "../../core/claude-md.js";
+import { KNOWN_AGENTS } from "../../core/agents.js";
+import { getPackageRoot } from "../../utils/fs.js";
+import { promptSelect, promptMultiSelect } from "../../utils/prompt.js";
+export async function selectScope(passedScope) {
+    if (passedScope)
+        return passedScope;
+    return promptSelect("Install scope:", [
+        { name: "Project (current directory)", value: "project" },
+        { name: "Global (home directory)", value: "global" },
+    ]);
+}
+export async function selectTargetAgents() {
+    const choices = KNOWN_AGENTS.map((a) => ({ name: a.label, value: a.id }));
+    const ids = await promptMultiSelect("请选择要安装的 AI 工具（可多选，至少选一项）：", choices, {
+        validate: (ids) => ids.length > 0 ? true : "请至少选择一个 AI 工具",
+    });
+    return KNOWN_AGENTS.filter((a) => ids.includes(a.id));
+}
+const GITIGNORE_RULES = ["docs/superpowers/", ".worktrees/", "worktrees/", "*.local.*", ".superpowers/"];
+async function ensureGitignore(projectPath) {
+    const gitignorePath = join(projectPath, ".gitignore");
+    let content = "";
+    try {
+        content = await readFile(gitignorePath, "utf-8");
+        if (!content.endsWith("\n"))
+            content += "\n";
+    }
+    catch {
+        // 文件不存在，稍后创建
+    }
+    const missing = GITIGNORE_RULES.filter((rule) => !content.includes(rule));
+    if (missing.length === 0)
+        return;
+    const block = `\n### Alloy + Superpowers 运行时 ###\n${missing.join("\n")}\n`;
+    await writeFile(gitignorePath, content + block, "utf-8");
+    console.log(`     ✓ .gitignore → 已追加 ${missing.length} 条规则`);
+}
+export async function initCommand(opts) {
+    console.log("\n  🔍 检测环境...");
+    // 1. 环境检测
+    const env = detectEnv();
+    console.log(`     Node.js ${env.nodeVersion} ✓`);
+    console.log(`     git ${env.gitInstalled ? "✓" : "✗ 未安装"}`);
+    console.log(`     Claude Code ${env.claudeCodeInstalled ? "✓" : "⚠ 未检测到 CLI，请确保已安装"}`);
+    if (!env.gitInstalled) {
+        console.error("\n  ❌ 缺少必要依赖，请先安装 git");
+        process.exit(1);
+    }
+    // 2. 安装 OpenSpec CLI（npm 全局包）
+    console.log("\n  📥 OpenSpec CLI...");
+    const openspecResult = await installOpenSpecCli();
+    if (openspecResult === "installed") {
+        console.log("     ✓ @fission-ai/openspec@1 已安装");
+    }
+    else if (openspecResult === "failed") {
+        console.error("     ✗ OpenSpec CLI 安装失败");
+        process.exit(1);
+    }
+    // "skipped" — 函数内部已输出跳过信息
+    // 3. 初始化 OpenSpec 项目结构（openspec/ 目录 + .claude/commands/opsx/）
+    console.log("\n  📂 初始化 OpenSpec 项目结构...");
+    const initResult = await initOpenSpecProject(opts.projectPath, opts.scope);
+    if (initResult === "failed") {
+        console.error("     ✗ OpenSpec 项目初始化失败");
+        process.exit(1);
+    }
+    // 4. 安装 Superpowers
+    console.log("\n  📥 Superpowers...");
+    const superpowersResult = await installSuperpowers(opts.scope);
+    if (superpowersResult === "installed") {
+        console.log("     ✓ obra/superpowers@5 已安装");
+    }
+    else if (superpowersResult === "skipped") {
+        console.log("     ✓ Superpowers 已安装，跳过");
+    }
+    else {
+        console.log("     ⚠ Superpowers 安装失败，请稍后手动运行 alloy init 重试");
+    }
+    // 5. 部署 Alloy commands
+    console.log("\n  🚀 部署 Alloy commands...");
+    if (opts.targetAgents.length === 0) {
+        console.log("     ⚠ 未选择任何 AI 工具，跳过 command 部署");
+    }
+    else {
+        try {
+            const paths = await deployCommands(opts);
+            for (const p of paths) {
+                console.log(`     ✓ ${p}`);
+            }
+        }
+        catch (e) {
+            console.error(`     ✗ command 部署失败: ${e.message}`);
+            process.exit(1);
+        }
+    }
+    const schemaPath = await deploySchema(opts);
+    console.log(`     ✓ 项目 schema → ${schemaPath}`);
+    // 6. 确保 .gitignore 包含 Alloy 运行时目录
+    await ensureGitignore(opts.projectPath);
+    // 7. 注入 CLAUDE.md
+    const injected = await injectClaudeMd(opts);
+    if (injected) {
+        console.log("     ✓ CLAUDE.md → 已追加 Alloy 工作流提示");
+    }
+    // 8. 兼容性检查
+    console.log("\n  🩺 兼容性检查...");
+    const packageDir = getPackageRoot();
+    const results = await runHealthCheck(packageDir, opts.projectPath, opts.scope);
+    for (const r of results) {
+        const mark = r.status === "pass" ? "✓" : r.status === "warn" ? "⚠️" : "✗";
+        console.log(`     ${mark} ${r.name} ${r.current}（要求 ${r.required}）`);
+    }
+    // 9. 自动注册 shell 补全（失败不阻断 init）
+    console.log("\n  🐚 注册 shell 补全...");
+    try {
+        const home = process.env.HOME || process.env.USERPROFILE || "~";
+        const shell = process.env.SHELL || "";
+        let completionLine = "source <(alloy completion bash)";
+        let rcFile = null;
+        if (shell.includes("zsh")) {
+            rcFile = join(home, ".zshrc");
+            completionLine = "source <(alloy completion zsh)";
+        }
+        else if (shell.includes("bash")) {
+            rcFile = join(home, ".bashrc");
+            completionLine = "source <(alloy completion bash)";
+        }
+        if (rcFile) {
+            let rcContent = "";
+            try {
+                rcContent = await readFile(rcFile, "utf-8");
+            }
+            catch {
+                // 文件不存在，稍后创建
+            }
+            if (!rcContent.includes("alloy completion")) {
+                const block = [
+                    "",
+                    "# Alloy shell 补全 — Tab 自动补全 alloy 命令",
+                    completionLine,
+                    "",
+                ].join("\n");
+                await writeFile(rcFile, rcContent.trimEnd() + block, "utf-8");
+                console.log(`     ✓ shell 补全已注册 → ${rcFile}`);
+            }
+            else {
+                console.log("     ✓ shell 补全已存在，跳过");
+            }
+        }
+        else {
+            console.log("     ⚠ 未检测到 bash/zsh，跳过补全注册");
+        }
+    }
+    catch {
+        // 注册失败不阻断 init，静默忽略
+    }
+    console.log("\n  ✅ Alloy 就绪！");
+    console.log("     在 Claude Code 中输入 /alloy:start <topic> 开始工作\n");
+}
+//# sourceMappingURL=init.js.map

package/dist/cli/commands/init.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"init.js","sourceRoot":"","sources":["../../../src/cli/commands/init.ts"],"names":[],"mappings":"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"}

package/dist/cli/commands/internal/archive.d.ts

@@ -0,0 +1 @@
+export declare function archiveCommand(args: string[]): Promise<void>;

package/dist/cli/commands/internal/archive.js

@@ -0,0 +1,91 @@
+// src/cli/commands/internal/archive.ts
+import { join } from "node:path";
+import { readFile, access } from "node:fs/promises";
+import { execSync } from "node:child_process";
+import { readState, writeState } from "../../utils/state.js";
+const FAIL_MARKER = "- [x] ❌ FAIL";
+function isCommandNotFound(err) {
+    const msg = err?.stderr?.toString() || err?.message || "";
+    return /command not found|not recognized|no such file/i.test(msg);
+}
+export async function archiveCommand(args) {
+    const projectDir = args[0];
+    const changeName = args[1];
+    const dryRun = args.includes("--dry-run");
+    if (!projectDir || !changeName) {
+        console.error("用法: alloy _archive <project-dir> <change-name> [--dry-run]");
+        process.exit(1);
+    }
+    const changeDir = join(projectDir, "openspec", "changes", changeName);
+    // 1. 验证 phase = applied
+    const state = await readState(changeDir);
+    if (state.phase !== "applied") {
+        console.error(`[HARD STOP] phase 必须为 applied，当前为 ${state.phase}`);
+        process.exit(1);
+    }
+    // 2. 验证 verify.md 存在且 Overall Decision 不是 FAIL
+    let verifyContent;
+    try {
+        await access(join(changeDir, "verify.md"));
+        verifyContent = await readFile(join(changeDir, "verify.md"), "utf-8");
+    }
+    catch (e) {
+        if (e.code === "ENOENT") {
+            console.error("[HARD STOP] verify.md 不存在，无法归档。请先运行 /alloy:apply 完成执行阶段。");
+            process.exit(1);
+        }
+        console.error(`[HARD STOP] 无法读取 verify.md: ${e.message}`);
+        process.exit(1);
+    }
+    if (verifyContent.includes(FAIL_MARKER)) {
+        console.error("[HARD STOP] verify.md Overall Decision 为 FAIL，无法归档。请先修复阻塞问题。");
+        process.exit(1);
+    }
+    if (dryRun) {
+        console.log(`[DRY RUN] 将归档 change '${changeName}' (phase=${state.phase})`);
+        console.log(`[DRY RUN] openspec archive -y ${changeName}`);
+        return;
+    }
+    // 3. 执行 openspec archive
+    try {
+        execSync(`openspec archive -y "${changeName}"`, {
+            stdio: "pipe",
+            cwd: projectDir,
+        });
+        console.log("✓ delta spec 已同步，change 已归档");
+    }
+    catch (e) {
+        const msg = e.stderr?.toString() || e.message || "";
+        if (isCommandNotFound(e)) {
+            // openspec CLI 不可用：警告但不阻断（skill 层已验证过，这里做兜底）
+            console.log(`⚠️  openspec CLI 不可用，跳过 delta spec 同步（错误: ${msg.trim()}）`);
+        }
+        else {
+            // 实际归档操作失败：HARD STOP，不推进 phase
+            console.error(`[HARD STOP] openspec archive 失败: ${msg.trim()}`);
+            process.exit(1);
+        }
+    }
+    // 4. 更新 phase → archived
+    state.phase = "archived";
+    await writeState(changeDir, state);
+    console.log("✓ phase → archived");
+    // 5. 提交归档变更
+    try {
+        execSync("git diff --quiet && git diff --cached --quiet", {
+            stdio: "pipe",
+            cwd: projectDir,
+        });
+        console.log("⚠️  没有需要提交的变更");
+    }
+    catch {
+        try {
+            execSync("git add openspec/specs/ openspec/changes/archive/ 2>/dev/null; " +
+                `git commit -m "chore(${changeName}): Delta Spec 已同步并归档" 2>/dev/null`, { stdio: "pipe", cwd: projectDir });
+        }
+        catch {
+            console.log("⚠️  git commit 失败（可能不是 git 仓库）");
+        }
+    }
+}
+//# sourceMappingURL=archive.js.map

package/dist/cli/commands/internal/archive.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"archive.js","sourceRoot":"","sources":["../../../../src/cli/commands/internal/archive.ts"],"names":[],"mappings":"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"}