@flyin-ai/alloy 0.2.0-beta.1 → 0.2.0-beta.2

package/dist/cli/commands/completion.js

@@ -14,7 +14,7 @@ function bashCompletion() {
         '  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"))',
+        '    COMPREPLY=($(compgen -W "-v --version -h --help init status doctor update completion _spec-audit" -- "$cur"))',
         "    return 0",
         "  fi",
         "",
@@ -31,6 +31,9 @@ function bashCompletion() {
         "    completion)",
         '      COMPREPLY=($(compgen -W "bash zsh pwsh powershell" -- "$cur"))',
         "      ;;",
+        "    _spec-audit)",
+        '      COMPREPLY=($(compgen -W "--fix --help -h" -- "$cur"))',
+        "      ;;",
         "  esac",
         "}",
         "",
@@ -53,6 +56,7 @@ function zshCompletion() {
         "    'doctor:诊断——版本兼容性、文件一致性'",
         "    'update:更新 Alloy skill 文件到最新版'",
         "    'completion:生成 shell 补全脚本'",
+        "'_spec-audit:检测 spec/skill behaviors 差异'",
         "  )",
         "  _describe 'command' cmds",
         "}",
@@ -90,6 +94,12 @@ function zshCompletion() {
         "            '--help[显示帮助]' \\",
         "            '-h[显示帮助]'",
         "          ;;",
+        "        _spec-audit)",
+        "          _arguments \\",
+        "            '--fix[交互式修复差异]' \\",
+        "            '--help[显示帮助]' \\",
+        "            '-h[显示帮助]'",
+        "          ;;",
         "      esac",
         "      ;;",
         "  esac",
@@ -111,7 +121,7 @@ function powershellCompletion() {
         "Register-ArgumentCompleter -Native -CommandName alloy -ScriptBlock {",
         "  param($wordToComplete, $commandAst, $cursorPosition)",
         "",
-        "  $commands = @('init', 'status', 'doctor', 'update', 'completion')",
+        "  $commands = @('init', 'status', 'doctor', 'update', 'completion', '_spec-audit')",
         "  $globalOpts = @('--version', '-v', '--help', '-h')",
         "",
         "  $tokens = $commandAst.CommandElements",
@@ -143,6 +153,7 @@ function powershellCompletion() {
         "    'doctor'  { $opts = @('--json', '--help', '-h') }",
         "    'update'  { $opts = @('--help', '-h') }",
         "    'completion' { $opts = @('bash', 'zsh', 'pwsh', 'powershell', '--help', '-h') }",
+        "    '_spec-audit' { $opts = @('--fix', '--help', '-h') }",
         "  }",
         "",
         "  $opts | Where-Object { $_ -like \"$wordToComplete*\" } | ForEach-Object {",

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

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

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

@@ -0,0 +1,7 @@
+/**
+ * alloy _artifact <action> <change-dir> [artifact]
+ *
+ * 动作:
+ *   reset <change-dir> <artifact> — 清除指定制品的 hash 记录 + 删除文件
+ */
+export declare function artifactCommand(args: string[]): Promise<void>;

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

@@ -0,0 +1,70 @@
+// src/cli/commands/internal/artifact.ts
+import { existsSync, rmSync } from "node:fs";
+import { join } from "node:path";
+import { readState, writeState } from "../../utils/state.js";
+import { ARTIFACT_FILES } from "../../../core/artifacts.js";
+/**
+ * alloy _artifact <action> <change-dir> [artifact]
+ *
+ * 动作:
+ *   reset <change-dir> <artifact> — 清除指定制品的 hash 记录 + 删除文件
+ */
+export async function artifactCommand(args) {
+    const action = args[0];
+    if (!action) {
+        console.error("用法: alloy _artifact reset <change-dir> <artifact>");
+        return process.exit(1);
+    }
+    if (action === "reset") {
+        return artifactReset(args.slice(1));
+    }
+    console.error(`未知操作: ${action} (支持: reset)`);
+    return process.exit(1);
+}
+async function artifactReset(args) {
+    const changeDir = args[0];
+    const artifactId = args[1];
+    if (!changeDir || !artifactId) {
+        console.error("用法: alloy _artifact reset <change-dir> <artifact>");
+        return process.exit(1);
+    }
+    const fileName = ARTIFACT_FILES[artifactId];
+    if (!fileName) {
+        console.error(`未知制品: ${artifactId} (支持: ${Object.keys(ARTIFACT_FILES).join(", ")})`);
+        return process.exit(1);
+    }
+    // 1. 清除 hash 记录
+    let state;
+    try {
+        state = await readState(changeDir);
+    }
+    catch {
+        console.error(`无法读取状态: ${changeDir}`);
+        return process.exit(1);
+    }
+    const originalCount = state.records.length;
+    state.records = state.records.filter((r) => r.artifact !== artifactId);
+    if (state.records.length === originalCount) {
+        console.log(`${artifactId}: no hash record found`);
+    }
+    else {
+        await writeState(changeDir, state);
+        console.log(`${artifactId}: hash record cleared`);
+    }
+    // 2. 删除制品文件
+    const fullPath = join(changeDir, fileName);
+    if (existsSync(fullPath)) {
+        const st = await import("node:fs/promises").then((m) => m.stat(fullPath));
+        if (st.isDirectory()) {
+            rmSync(fullPath, { recursive: true, force: true });
+        }
+        else {
+            rmSync(fullPath, { force: true });
+        }
+        console.log(`${artifactId}: file deleted (${fileName})`);
+    }
+    else {
+        console.log(`${artifactId}: file not found (${fileName})`);
+    }
+}
+//# sourceMappingURL=artifact.js.map

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

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

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

@@ -1,7 +1,7 @@
-import { existsSync } from "node:fs";
+import { existsSync, readFileSync } from "node:fs";
 import { join, basename } from "node:path";
 import { execSync } from "node:child_process";
-import { readState, writeState } from "../../utils/state.js";
+import { readState, writeState, readProjectConfig } from "../../utils/state.js";
 import { computeArtifactHash } from "../../../core/artifacts.js";
 const VALID_TRANSITIONS = {
     started: ["planned"],
@@ -16,6 +16,21 @@ const ARTIFACT_CHECKS = {
     "archived->finished": ["retrospective.md"],
 };
 export async function guardCommand(args) {
+    // 子命令路由
+    const subCommand = args[0];
+    if (subCommand === "branch-position") {
+        return branchPositionGuard(args.slice(1));
+    }
+    if (subCommand === "verify-passed") {
+        return verifyPassedGuard(args.slice(1));
+    }
+    if (subCommand === "precheck") {
+        return precheckGuard(args.slice(1));
+    }
+    if (subCommand === "worktree-status") {
+        return worktreeStatusGuard(args.slice(1));
+    }
+    // 原有 phase 转换校验逻辑
     const changeDir = args[0];
     const targetPhase = args[1];
     const apply = args.includes("--apply");
@@ -93,4 +108,191 @@ export async function guardCommand(args) {
         console.log(`✓ phase: ${currentPhase} → ${targetPhase}`);
     }
 }
+// --- 子命令实现 ---
+/** 获取当前 git 分支名 */
+function getCurrentBranch() {
+    try {
+        return execSync("git branch --show-current", { stdio: "pipe" }).toString().trim();
+    }
+    catch {
+        return null;
+    }
+}
+/** 获取本地分支列表 */
+function getLocalBranches() {
+    try {
+        return execSync("git branch --list --format=%(refname:short)", { stdio: "pipe" })
+            .toString()
+            .trim()
+            .split("\n")
+            .map((s) => s.trim())
+            .filter(Boolean);
+    }
+    catch {
+        return [];
+    }
+}
+/** 获取 main 分支名 */
+async function getMainBranch() {
+    try {
+        const config = await readProjectConfig(process.cwd());
+        return config.alloy?.main_branch ?? null;
+    }
+    catch {
+        return null;
+    }
+}
+/** 猜测主分支名（config 无记录时从本地分支推断） */
+async function guessMainBranch() {
+    const candidates = ["main", "master"];
+    const localBranches = getLocalBranches();
+    for (const c of candidates) {
+        if (localBranches.includes(c))
+            return c;
+    }
+    return null;
+}
+/**
+ * alloy _guard branch-position <change-dir>
+ * 输出: on-feature|on-main|feature-missing|on-other:<current>|feature-lost:<feature>
+ * 退出码: 0=位置正确(on-feature), 1=位置不正确
+ */
+async function branchPositionGuard(args) {
+    const changeDir = args[0];
+    if (!changeDir) {
+        console.error("用法: alloy _guard branch-position <change-dir>");
+        return process.exit(1);
+    }
+    let state;
+    try {
+        state = await readState(changeDir);
+    }
+    catch {
+        console.error(`无法读取状态: ${changeDir}`);
+        return process.exit(1);
+    }
+    const featureBranch = state.feature_branch ?? null;
+    const currentBranch = getCurrentBranch();
+    const mainBranch = await getMainBranch();
+    console.log(`current=${currentBranch}  main=${mainBranch}  feature=${featureBranch}`);
+    // mainBranch 未配置时，尝试常见默认值
+    const effectiveMain = mainBranch ?? (await guessMainBranch());
+    if (effectiveMain && currentBranch === effectiveMain) {
+        console.log("on-main");
+        return process.exit(1);
+    }
+    if (featureBranch === null) {
+        console.log("feature-missing");
+        return process.exit(1);
+    }
+    if (currentBranch === featureBranch) {
+        console.log("on-feature");
+        return; // exit(0)
+    }
+    const localBranches = getLocalBranches();
+    if (!localBranches.includes(featureBranch)) {
+        console.log(`feature-lost:${featureBranch}`);
+        return process.exit(1);
+    }
+    console.log(`on-other:${currentBranch}`);
+    return process.exit(1);
+}
+/**
+ * alloy _guard verify-passed <change-dir>
+ * 输出: PASS|FAIL|WARNING
+ * 退出码: 0=通过(PASS/WARNING), 1=不通过(FAIL)
+ */
+async function verifyPassedGuard(args) {
+    const changeDir = args[0];
+    if (!changeDir) {
+        console.error("用法: alloy _guard verify-passed <change-dir>");
+        return process.exit(1);
+    }
+    const verifyPath = join(changeDir, "verify.md");
+    if (!existsSync(verifyPath)) {
+        console.log("FAIL");
+        return process.exit(1);
+    }
+    try {
+        const content = readFileSync(verifyPath, "utf-8");
+        const failMatch = content.match(/^- \[x\].*(?:❌\s*)?FAIL/mi);
+        if (failMatch) {
+            console.log("FAIL");
+            return process.exit(1);
+        }
+        const warnMatch = content.match(/^- \[x\].*(?:⚠️\s*)?WARNING/mi);
+        if (warnMatch) {
+            console.log("WARNING");
+            return; // exit(0)
+        }
+        console.log("PASS");
+        return; // exit(0)
+    }
+    catch {
+        console.log("FAIL");
+        return process.exit(1);
+    }
+}
+/**
+ * alloy _guard precheck <change-dir> <expected-phase>
+ * 输出: PASS:<phase>|FAIL:<reason>
+ * 退出码: 0=通过, 1=不通过
+ */
+async function precheckGuard(args) {
+    const changeDir = args[0];
+    const expectedPhase = args[1];
+    if (!changeDir || !expectedPhase) {
+        console.error("用法: alloy _guard precheck <change-dir> <expected-phase>");
+        return process.exit(1);
+    }
+    if (!existsSync(changeDir)) {
+        console.log(`FAIL:directory not found`);
+        return process.exit(1);
+    }
+    try {
+        const state = await readState(changeDir);
+        // 支持多阶段值（逗号分隔），如 "planned,applied"
+        const allowedPhases = expectedPhase.split(",").map((p) => p.trim());
+        if (allowedPhases.includes(state.phase)) {
+            console.log(`PASS:${state.phase}`);
+            return; // exit(0)
+        }
+        console.log(`FAIL:phase=${state.phase} expected=${expectedPhase}`);
+        return process.exit(1);
+    }
+    catch {
+        console.log("FAIL:state read error");
+        return process.exit(1);
+    }
+}
+/**
+ * alloy _guard worktree-status <change-dir>
+ * 输出: done:<path>:<branch>|stale:<path>|skipped|pending
+ * 退出码: 始终 0（查询命令）
+ */
+async function worktreeStatusGuard(args) {
+    const changeDir = args[0];
+    if (!changeDir) {
+        console.error("用法: alloy _guard worktree-status <change-dir>");
+        return process.exit(1);
+    }
+    const state = await readState(changeDir);
+    const worktree = state.worktree;
+    if (worktree === null || worktree === "null") {
+        console.log("pending");
+        return; // exit(0)
+    }
+    if (worktree === "skipped") {
+        console.log("skipped");
+        return; // exit(0)
+    }
+    // 有效路径
+    if (existsSync(worktree)) {
+        const branch = state.worktree_branch ?? "unknown";
+        console.log(`done:${worktree}:${branch}`);
+        return; // exit(0)
+    }
+    console.log(`stale:${worktree}`);
+    return; // exit(0)
+}
 //# sourceMappingURL=guard.js.map

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

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

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

@@ -0,0 +1,10 @@
+/**
+ * alloy _progress artifacts <change-dir>
+ * 输出每个制品的状态行：<artifact>:<status>[:<detail>]
+ *   done       — 文件存在 + hash 匹配
+ *   missing    — 文件不存在
+ *   hash-mismatch — 文件存在但 hash 不匹配
+ *   pending    — 文件存在但无 record（未审批）
+ * 退出码: 始终 0（查询命令）
+ */
+export declare function progressCommand(args: string[]): Promise<void>;

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

@@ -0,0 +1,70 @@
+// src/cli/commands/internal/progress.ts
+import { existsSync } from "node:fs";
+import { readState } from "../../utils/state.js";
+import { computeArtifactHash, ARTIFACT_FILES } from "../../../core/artifacts.js";
+/**
+ * alloy _progress artifacts <change-dir>
+ * 输出每个制品的状态行：<artifact>:<status>[:<detail>]
+ *   done       — 文件存在 + hash 匹配
+ *   missing    — 文件不存在
+ *   hash-mismatch — 文件存在但 hash 不匹配
+ *   pending    — 文件存在但无 record（未审批）
+ * 退出码: 始终 0（查询命令）
+ */
+export async function progressCommand(args) {
+    const action = args[0];
+    if (!action) {
+        console.error("用法: alloy _progress artifacts <change-dir>");
+        return process.exit(1);
+    }
+    if (action === "artifacts") {
+        return artifactsProgress(args.slice(1));
+    }
+    console.error(`未知操作: ${action} (支持: artifacts)`);
+    return process.exit(1);
+}
+async function artifactsProgress(args) {
+    const changeDir = args[0];
+    if (!changeDir) {
+        console.error("用法: alloy _progress artifacts <change-dir>");
+        return process.exit(1);
+    }
+    let state;
+    try {
+        state = await readState(changeDir);
+    }
+    catch {
+        console.error(`无法读取状态: ${changeDir}`);
+        return process.exit(1);
+    }
+    const records = state.records || [];
+    // 按制品定义顺序输出
+    const artifactOrder = ["draft", "proposal", "design", "specs", "tasks", "plans", "verify", "retrospective"];
+    for (const artifactId of artifactOrder) {
+        const fileName = ARTIFACT_FILES[artifactId];
+        if (!fileName)
+            continue;
+        const fullPath = `${changeDir}/${fileName}`;
+        const fileExists = existsSync(fullPath);
+        const record = records.find((r) => r.artifact === artifactId);
+        if (!fileExists) {
+            console.log(`${artifactId}:missing`);
+            continue;
+        }
+        if (!record) {
+            console.log(`${artifactId}:pending`);
+            continue;
+        }
+        const currentHash = await computeArtifactHash(changeDir, artifactId);
+        if (currentHash === null) {
+            console.log(`${artifactId}:missing`);
+            continue;
+        }
+        if (currentHash !== record.hash) {
+            console.log(`${artifactId}:hash-mismatch:${record.hash}!=${currentHash}`);
+            continue;
+        }
+        console.log(`${artifactId}:done:${record.hash}`);
+    }
+}
+//# sourceMappingURL=progress.js.map

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

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

package/dist/cli/commands/internal/spec-audit.d.ts

@@ -0,0 +1,42 @@
+export interface Behaviors {
+    stops?: number;
+    preconditions?: number;
+    hard_stops?: number;
+    user_gates?: number;
+    warns?: number;
+    artifacts: string[];
+    transitions_to: string;
+    external_calls: string[];
+}
+export interface SkillEntry {
+    skillName: string;
+    spec: string | undefined;
+    behaviors: Behaviors | undefined;
+}
+export interface SpecEntry {
+    behaviors: Behaviors | undefined;
+    content: string;
+}
+export type FieldDiffType = "number" | "string" | "array" | "missing-block";
+export interface FieldDiff {
+    field: string;
+    type: FieldDiffType;
+    skillValue: unknown;
+    specValue: unknown;
+    skillExtra?: string[];
+    specExtra?: string[];
+}
+export type AuditStatus = "ok" | "diff" | "no-spec-field" | "spec-not-found";
+export interface AuditResult {
+    skillName: string;
+    status: AuditStatus;
+    diffs: FieldDiff[];
+    specPath?: string;
+}
+export declare function scanSkills(projectRoot: string): Promise<SkillEntry[]>;
+export declare function readSpec(projectRoot: string, specPath: string): Promise<SpecEntry>;
+export declare function compareBehaviors(skillBehaviors: Behaviors, specBehaviors: Behaviors): FieldDiff[];
+export declare function audit(projectRoot: string): Promise<AuditResult[]>;
+export declare function formatDiff(diff: FieldDiff): string[];
+export declare function formatResult(result: AuditResult): string[];
+export declare function specAuditCommand(args: string[]): Promise<void>;