@flyin-ai/alloy 0.1.0

package/dist/cli/commands/update.js

@@ -0,0 +1,162 @@
+import { readFile, writeFile } from "node:fs/promises";
+import { readFileSync, existsSync } from "node:fs";
+import { join } from "node:path";
+import { execSync } from "node:child_process";
+import { deployCommands, deploySchema } from "../../core/skills.js";
+import { detectDeployedAgents } from "../../core/agents.js";
+import { runHealthCheck } from "../../core/health.js";
+import { getPackageRoot } from "../../utils/fs.js";
+import { promptConfirm } from "../../utils/prompt.js";
+const CLAUDE_MD_MARKER_START = "<!-- ALLOY-WORKFLOW:START -->";
+const CLAUDE_MD_MARKER_END = "<!-- ALLOY-WORKFLOW:END -->";
+function isDevMode() {
+    // npm link 下包根目录不是 symlink，但 .git 存在标记了开发环境
+    return existsSync(join(getPackageRoot(), ".git"));
+}
+function detectScope(projectPath) {
+    const probe = (dir) => existsSync(join(dir, "commands", "alloy"));
+    // 先检测项目级别
+    if (probe(join(projectPath, ".claude")))
+        return "project";
+    // 再检测全局
+    const home = process.env.HOME || process.env.USERPROFILE || "~";
+    if (probe(join(home, ".claude")))
+        return "global";
+    return null;
+}
+async function checkLatestVersion() {
+    try {
+        return execSync("npm view @flyin-ai/alloy version", { stdio: "pipe" })
+            .toString()
+            .trim();
+    }
+    catch {
+        return null;
+    }
+}
+export async function updateCommand(projectPath) {
+    const results = [];
+    // 1. 自动检测 scope
+    const scope = detectScope(projectPath);
+    if (!scope) {
+        results.push("⚠️ Alloy 未初始化，请先运行 alloy init");
+        return results;
+    }
+    // 2. 开发模式 vs 用户模式
+    const dev = isDevMode();
+    if (dev) {
+        console.log("  🔧 开发模式，从本地构建重新部署…");
+    }
+    else {
+        const pkg = JSON.parse(readFileSync(join(getPackageRoot(), "package.json"), "utf-8"));
+        const currentVersion = pkg.version;
+        const latest = await checkLatestVersion();
+        if (latest && latest !== currentVersion) {
+            console.log(`\n  发现新版本: v${latest}（当前 v${currentVersion}）`);
+            // 兼容性检查
+            console.log("  🩺 兼容性检查…");
+            const health = await runHealthCheck(getPackageRoot(), projectPath);
+            const warnings = health.filter((h) => h.status !== "pass");
+            if (warnings.length > 0) {
+                for (const w of warnings) {
+                    console.log(`     ⚠ ${w.name}: ${w.current}`);
+                }
+            }
+            else {
+                console.log("     ✓ 兼容性检查通过");
+            }
+            // 询问确认
+            const doUpdate = await promptConfirm("是否升级 alloy？", false);
+            if (doUpdate) {
+                try {
+                    execSync("npm update -g @flyin-ai/alloy", { stdio: "pipe" });
+                    results.push("✓ alloy CLI 已升级");
+                }
+                catch {
+                    results.push("⚠️ CLI 升级失败");
+                }
+            }
+            else {
+                results.push("  已跳过 CLI 升级");
+            }
+        }
+        else if (latest) {
+            results.push(`✓ Alloy v${currentVersion} 已是最新`);
+        }
+        else {
+            results.push(`⚠️ 无法检查更新（npm registry 不可达）`);
+        }
+    }
+    // 3. 部署 commands
+    const deployedAgents = detectDeployedAgents(scope, projectPath);
+    if (deployedAgents.length === 0) {
+        results.push("⚠️ 未检测到已部署的 Alloy commands，请先运行 alloy init");
+        return results;
+    }
+    const deployOpts = {
+        scope,
+        injectClaudeMd: false,
+        projectPath,
+        targetAgents: deployedAgents,
+    };
+    try {
+        const paths = await deployCommands(deployOpts);
+        results.push(`✓ commands/ → 部署 ${paths.length} 个文件到 ${deployedAgents.length} 个 agent`);
+    }
+    catch {
+        results.push("⚠️ command 部署失败");
+    }
+    try {
+        await deploySchema(deployOpts);
+        results.push("✓ schema/ → 已部署");
+    }
+    catch {
+        results.push(`⚠️ schema 部署失败`);
+    }
+    // 4. 更新 CLAUDE.md 标记区域
+    const claudeMdPath = join(projectPath, "CLAUDE.md");
+    if (existsSync(claudeMdPath)) {
+        try {
+            let content = await readFile(claudeMdPath, "utf-8");
+            if (content.includes(CLAUDE_MD_MARKER_START)) {
+                const latestFragment = getLatestClaudeMdFragment();
+                const startIdx = content.indexOf(CLAUDE_MD_MARKER_START);
+                const endIdx = content.indexOf(CLAUDE_MD_MARKER_END);
+                if (endIdx > startIdx) {
+                    content =
+                        content.slice(0, startIdx) +
+                            latestFragment +
+                            content.slice(endIdx + CLAUDE_MD_MARKER_END.length);
+                    await writeFile(claudeMdPath, content, "utf-8");
+                    results.push("✓ CLAUDE.md → Alloy 标记区域已更新");
+                }
+            }
+        }
+        catch {
+            results.push("⚠️ CLAUDE.md 更新失败");
+        }
+    }
+    return results;
+}
+function getLatestClaudeMdFragment() {
+    return [
+        "",
+        CLAUDE_MD_MARKER_START,
+        "## Alloy 工作流",
+        "",
+        "本项目使用 [Alloy](https://github.com/Rushing0711/alloy) 管理开发工作流。",
+        "",
+        "常用命令：",
+        "- `/alloy-start [topic]` - 智能入口",
+        "- `/alloy-plan [name]` - 制品规划",
+        "- `/alloy-apply [name]` - 执行实现",
+        "- `/alloy-archive [name]` - 归档与收尾",
+        "- `/alloy-finish [name]` - 独立收尾",
+        "- `/alloy-fix` - Bug 修复",
+        "- `/alloy-status [name]` - 查看状态",
+        "",
+        CLAUDE_MD_MARKER_END,
+        "",
+    ].join("\n");
+}
+//# sourceMappingURL=update.js.map

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

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

package/dist/cli/index.d.ts

@@ -0,0 +1,2 @@
+#!/usr/bin/env node
+export {};

package/dist/cli/index.js

@@ -0,0 +1,291 @@
+#!/usr/bin/env node
+import { parseArgs } from "node:util";
+import { existsSync, readFileSync } from "node:fs";
+import { readFile, writeFile } from "node:fs/promises";
+import { join, dirname } from "node:path";
+import { fileURLToPath } from "node:url";
+import { statusCommand } from "./commands/status.js";
+import { doctorCommand, formatDoctorResult } from "./commands/doctor.js";
+import { updateCommand } from "./commands/update.js";
+import { generateCompletion } from "./commands/completion.js";
+import { stateCommand } from "./commands/internal/state.js";
+import { guardCommand } from "./commands/internal/guard.js";
+import { recordCommand } from "./commands/internal/record.js";
+const USAGE = `
+alloy <command> [options]
+
+Commands:
+  init        [path] [--scope <project|global>] [--inject-claude-md]
+              项目初始化：检测环境 → 安装依赖 → 部署 schema + skill
+  status      [path|name] [--json]
+              查看活跃 change 总览，指定 name 查看详情
+  doctor      [path] [--json]
+              诊断：版本兼容性、文件一致性
+  update      [path]
+              从 alloy 包重新部署 skill + schema
+  completion  [bash|zsh|pwsh|powershell] [--install]
+              生成 shell 补全脚本，--install 自动注册
+
+Options:
+  --version, -v, -V  版本号
+  --help, -h         帮助（alloy -h 或 alloy <command> -h）
+`;
+function commandHelp(cmd) {
+    switch (cmd) {
+        case "init":
+            return `
+alloy init [path] [options]
+
+选项:
+  --scope <project|global>  安装范围，默认 project
+  --inject-claude-md        注入 CLAUDE.md 工作流标记（默认关闭）
+  --help, -h                显示本帮助
+`;
+        case "status":
+            return `
+alloy status [path|name] [options]
+
+参数:
+  path  项目路径（默认当前目录）
+  name  change 名称（查看详情）
+
+选项:
+  --json    JSON 格式输出
+  --help, -h    显示本帮助
+`;
+        case "doctor":
+            return `
+alloy doctor [path] [options]
+
+选项:
+  --json    JSON 格式输出
+  --help, -h    显示本帮助
+`;
+        case "update":
+            return `
+alloy update [path] [options]
+
+自动检测 scope（project/global），从 alloy 包重新部署 skill + schema。
+用户模式下会检查 npm registry 是否有新版本。
+
+选项:
+  --help, -h    显示本帮助
+`;
+        case "completion":
+            return `
+alloy completion [shell] [options]
+
+参数:
+  shell  目标 shell（bash / zsh / pwsh / powershell，默认从 $SHELL 检测）
+
+选项:
+  --install    自动注册到 shell 配置文件（~/.zshrc / ~/.bashrc / PowerShell profile）
+  --help, -h   显示本帮助
+
+示例:
+  source <(alloy completion)              # 当前 session 生效
+  alloy completion --install              # 自动注册并立即生效
+  alloy completion pwsh | Out-File -FilePath $PROFILE -Append  # PowerShell（需先确保目录存在，完成后 . $PROFILE）
+`;
+        default:
+            return `未知命令: ${cmd}\n使用 alloy --help 查看可用命令。`;
+    }
+}
+async function installCompletion(shell) {
+    const home = process.env.HOME || process.env.USERPROFILE || "~";
+    let rcFile = null;
+    let completionLine = "";
+    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)";
+    }
+    else if (shell.includes("pwsh") || shell.includes("powershell")) {
+        console.log("PowerShell 用户请依次运行:");
+        console.log("  New-Item -ItemType Directory -Force -Path (Split-Path $PROFILE)");
+        console.log("  alloy completion pwsh | Out-File -FilePath $PROFILE -Append");
+        console.log("  . $PROFILE  # 重新加载 profile，或重启 PowerShell");
+        return;
+    }
+    if (!rcFile) {
+        console.error("无法确定 shell 配置文件路径");
+        process.exit(1);
+    }
+    let content = "";
+    try {
+        content = await readFile(rcFile, "utf-8");
+    }
+    catch {
+        // 文件不存在
+    }
+    if (content.includes("alloy completion")) {
+        console.log(`✓ shell 补全已存在 → ${rcFile}`);
+        return;
+    }
+    const block = [
+        "",
+        "# Alloy shell 补全 — Tab 自动补全 alloy 命令",
+        completionLine,
+        "",
+    ].join("\n");
+    await writeFile(rcFile, content.trimEnd() + block, "utf-8");
+    console.log(`✓ shell 补全已注册 → ${rcFile}`);
+    console.log(`  运行 'source ${rcFile}' 或重新打开终端使其生效`);
+}
+async function main() {
+    const args = process.argv.slice(2);
+    const isHelp = (a) => a.includes("--help") || a.includes("-h");
+    const isVersion = (a) => a.includes("--version") || a.includes("-v") || a.includes("-V");
+    if (args.length === 0 || (args.length === 1 && isHelp(args))) {
+        console.log(USAGE);
+        process.exit(0);
+    }
+    if (args.length === 1 && isVersion(args)) {
+        try {
+            const pkg = JSON.parse(readFileSync(join(dirname(fileURLToPath(import.meta.url)), "..", "..", "package.json"), "utf-8"));
+            console.log(`alloy v${pkg.version}`);
+        }
+        catch {
+            console.log("alloy v0.1.0");
+        }
+        process.exit(0);
+    }
+    const command = args[0];
+    const restArgs = args.slice(1);
+    if (isHelp(restArgs)) {
+        console.log(commandHelp(command));
+        process.exit(0);
+    }
+    switch (command) {
+        case "init": {
+            const { values, positionals } = parseArgs({
+                args: restArgs,
+                options: {
+                    scope: { type: "string" },
+                    "inject-claude-md": { type: "boolean", default: false },
+                },
+                strict: true,
+                allowPositionals: true,
+            });
+            const projectPath = positionals[0] ?? process.cwd();
+            const { initCommand, selectScope, selectTargetAgents } = await import("./commands/init.js");
+            const scope = await selectScope(values.scope);
+            const targetAgents = await selectTargetAgents();
+            await initCommand({
+                scope,
+                injectClaudeMd: values["inject-claude-md"] || false,
+                projectPath,
+                targetAgents,
+            });
+            break;
+        }
+        case "status": {
+            const { positionals } = parseArgs({
+                args: restArgs,
+                options: { json: { type: "boolean", default: false } },
+                strict: true,
+                allowPositionals: true,
+            });
+            const useJson = restArgs.includes("--json");
+            let projectPath;
+            let changeName;
+            if (positionals.length === 1 && !existsSync(positionals[0])) {
+                // 单个参数且非路径 → 视为 change name
+                projectPath = process.cwd();
+                changeName = positionals[0];
+            }
+            else {
+                projectPath = positionals[0] ?? process.cwd();
+                changeName = positionals[1];
+            }
+            const result = await statusCommand(projectPath, changeName);
+            if (useJson) {
+                console.log(JSON.stringify({ output: result }, null, 2));
+            }
+            else {
+                console.log(result);
+            }
+            break;
+        }
+        case "doctor": {
+            const { positionals } = parseArgs({
+                args: restArgs,
+                options: { json: { type: "boolean", default: false } },
+                strict: true,
+                allowPositionals: true,
+            });
+            const useJson = restArgs.includes("--json");
+            const result = await doctorCommand(positionals[0] ?? process.cwd());
+            console.log(formatDoctorResult(result, useJson));
+            break;
+        }
+        case "update": {
+            const { positionals } = parseArgs({
+                args: restArgs,
+                options: {},
+                strict: true,
+                allowPositionals: true,
+            });
+            const results = await updateCommand(positionals[0] ?? process.cwd());
+            for (const r of results)
+                console.log(`  ${r}`);
+            break;
+        }
+        case "completion": {
+            const { values, positionals } = parseArgs({
+                args: restArgs,
+                options: {
+                    install: { type: "boolean", default: false },
+                },
+                strict: true,
+                allowPositionals: true,
+            });
+            if (values.install) {
+                const shell = positionals[0] ?? process.env.SHELL ?? "bash";
+                await installCompletion(shell);
+                break;
+            }
+            // 指定了 shell → 输出补全脚本（用于管道/重定向）
+            if (positionals[0]) {
+                console.log(generateCompletion(positionals[0]));
+                break;
+            }
+            // 无参数 → 显示友好使用说明
+            console.log("生成 shell 补全脚本，获取 Tab 自动补全能力。\n");
+            console.log("用法：");
+            console.log("  source <(alloy completion zsh)          # zsh 当前 session 生效");
+            console.log("  source <(alloy completion bash)         # bash 当前 session 生效");
+            console.log("  alloy completion --install              # 自动注册到 rc 文件，永久生效");
+            console.log("");
+            console.log("  # PowerShell（需先创建目录，再写入 profile，最后 . $PROFILE 或重启）");
+            console.log("  New-Item -ItemType Directory -Force -Path (Split-Path $PROFILE)");
+            console.log("  alloy completion pwsh | Out-File $PROFILE");
+            console.log("  . $PROFILE");
+            break;
+        }
+        case "_state": {
+            await stateCommand(restArgs);
+            break;
+        }
+        case "_guard": {
+            await guardCommand(restArgs);
+            break;
+        }
+        case "_record": {
+            await recordCommand(restArgs);
+            break;
+        }
+        default:
+            console.error(`未知命令: ${command}`);
+            console.log(USAGE);
+            process.exit(1);
+    }
+}
+main().catch((err) => {
+    console.error(err);
+    process.exit(1);
+});
+//# sourceMappingURL=index.js.map

package/dist/cli/index.js.map

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

package/dist/cli/utils/state.d.ts

@@ -0,0 +1,6 @@
+import type { AlloyState } from "../../core/types.js";
+export type { AlloyState };
+export declare function createInitialState(): AlloyState;
+export declare function readState(changePath: string): Promise<AlloyState>;
+export declare function writeState(changePath: string, state: AlloyState): Promise<void>;
+export declare function findActiveChanges(changesDir: string): Promise<Map<string, AlloyState>>;

package/dist/cli/utils/state.js

@@ -0,0 +1,64 @@
+import { readFile, writeFile, readdir } from "node:fs/promises";
+import { join } from "node:path";
+import { parse as parseYaml, stringify as stringifyYaml } from "yaml";
+function formatTimestamp() {
+    const d = new Date();
+    const pad = (n) => n.toString().padStart(2, "0");
+    // 本地时间，人类可读格式：YYYY-MM-DD HH:MM:SS
+    return `${d.getFullYear()}-${pad(d.getMonth() + 1)}-${pad(d.getDate())} ${pad(d.getHours())}:${pad(d.getMinutes())}:${pad(d.getSeconds())}`;
+}
+export function createInitialState() {
+    const now = formatTimestamp();
+    return {
+        phase: "started",
+        worktree: null,
+        schema_version: 1,
+        created_at: now,
+        updated_at: now,
+        records: [],
+    };
+}
+export async function readState(changePath) {
+    const yamlPath = join(changePath, ".alloy.yaml");
+    let content;
+    try {
+        content = await readFile(yamlPath, "utf-8");
+    }
+    catch (err) {
+        if (err.code === "ENOENT") {
+            throw new Error(`缺少 .alloy.yaml: ${changePath}`);
+        }
+        throw err;
+    }
+    return parseYaml(content);
+}
+export async function writeState(changePath, state) {
+    const yamlPath = join(changePath, ".alloy.yaml");
+    state.updated_at = formatTimestamp();
+    const content = stringifyYaml(state);
+    await writeFile(yamlPath, content, "utf-8");
+}
+export async function findActiveChanges(changesDir) {
+    const changes = new Map();
+    try {
+        const entries = await readdir(changesDir, { withFileTypes: true });
+        for (const entry of entries) {
+            if (!entry.isDirectory())
+                continue;
+            try {
+                const state = await readState(join(changesDir, entry.name));
+                if (state.phase !== "finished") {
+                    changes.set(entry.name, state);
+                }
+            }
+            catch {
+                // 目录存在但无 .alloy.yaml，跳过
+            }
+        }
+    }
+    catch {
+        // changes 目录可能不存在
+    }
+    return changes;
+}
+//# sourceMappingURL=state.js.map

package/dist/cli/utils/state.js.map

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

package/dist/core/agents.d.ts

@@ -0,0 +1,8 @@
+import type { AgentInfo } from "./types.js";
+export declare const KNOWN_AGENTS: AgentInfo[];
+declare const COMMAND_IDS: string[];
+/** 反向推导：检查哪些 agent 已有 alloy command 部署 */
+export declare function detectDeployedAgents(scope: "global" | "project", projectPath: string): AgentInfo[];
+/** 获取 agent command 部署的目标路径 */
+export declare function getCommandTargetDir(agent: AgentInfo, scope: "global" | "project", projectPath: string): string;
+export { COMMAND_IDS };

package/dist/core/agents.js

@@ -0,0 +1,85 @@
+import { join } from "node:path";
+import { existsSync } from "node:fs";
+export const KNOWN_AGENTS = [
+    {
+        id: "claude-code",
+        label: "Claude Code",
+        supportsColonCommands: true,
+        commandsDir: ".claude/commands/",
+    },
+    {
+        id: "codebuddy",
+        label: "CodeBuddy",
+        supportsColonCommands: true,
+        commandsDir: ".codebuddy/commands/",
+    },
+    {
+        id: "qoder",
+        label: "Qoder",
+        supportsColonCommands: true,
+        commandsDir: ".qoder/commands/",
+    },
+    {
+        id: "cursor",
+        label: "Cursor",
+        supportsColonCommands: false,
+        commandsDir: ".cursor/commands/",
+    },
+    {
+        id: "opencode",
+        label: "OpenCode",
+        supportsColonCommands: false,
+        commandsDir: ".opencode/commands/",
+    },
+    {
+        id: "codex",
+        label: "Codex",
+        supportsColonCommands: false,
+        commandsDir: ".codex/prompts/",
+        globalOnly: true,
+    },
+    {
+        id: "trae",
+        label: "Trae",
+        supportsColonCommands: false,
+        commandsDir: ".trae/commands/",
+    },
+    {
+        id: "pi",
+        label: "Pi",
+        supportsColonCommands: false,
+        commandsDir: ".pi/prompts/",
+    },
+];
+const COMMAND_IDS = [
+    "start", "plan", "apply", "archive",
+    "finish", "fix", "discard", "status",
+];
+function basePath(scope, projectPath) {
+    if (scope === "global") {
+        return process.env.HOME || process.env.USERPROFILE || "~";
+    }
+    return projectPath;
+}
+/** 反向推导：检查哪些 agent 已有 alloy command 部署 */
+export function detectDeployedAgents(scope, projectPath) {
+    const base = basePath(scope, projectPath);
+    return KNOWN_AGENTS.filter((agent) => {
+        const dir = join(base, agent.commandsDir);
+        if (agent.supportsColonCommands) {
+            const alloyDir = join(dir, "alloy");
+            return existsSync(alloyDir) && existsSync(join(alloyDir, "start.md"));
+        }
+        return existsSync(join(dir, "alloy-start.md"));
+    });
+}
+/** 获取 agent command 部署的目标路径 */
+export function getCommandTargetDir(agent, scope, projectPath) {
+    const base = basePath(scope, projectPath);
+    if (agent.supportsColonCommands) {
+        return join(base, agent.commandsDir, "alloy");
+    }
+    return join(base, agent.commandsDir);
+}
+export { COMMAND_IDS };
+//# sourceMappingURL=agents.js.map

package/dist/core/agents.js.map

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

package/dist/core/claude-md.d.ts

@@ -0,0 +1,4 @@
+import type { DeployOptions } from "./types.js";
+export declare const CLAUDE_MD_MARKER_START = "<!-- ALLOY-WORKFLOW:START -->";
+export declare const CLAUDE_MD_MARKER_END = "<!-- ALLOY-WORKFLOW:END -->";
+export declare function injectClaudeMd(opts: DeployOptions): Promise<boolean>;