@birdie_moblie/open_spec 2.1.7

package/.agents/plugins/marketplace.json

@@ -0,0 +1,13 @@
+{
+  "name": "openspec-bridge",
+  "owner": {
+    "name": "OpenSpec Contributors"
+  },
+  "plugins": [
+    {
+      "name": "openspec",
+      "description": "OpenSpec 确定性产品规格工作流",
+      "source": { "source": "local", "path": "." }
+    }
+  ]
+}

package/.claude-plugin/marketplace.json

@@ -0,0 +1,12 @@
+{
+  "name": "openspec-bridge",
+  "owner": {
+    "name": "OpenSpec Contributors"
+  },
+  "plugins": [
+    {
+      "name": "openspec",
+      "source": "./"
+    }
+  ]
+}

package/.claude-plugin/plugin.json

@@ -0,0 +1,9 @@
+{
+  "name": "openspec",
+  "description": "OpenSpec 确定性产品规格工作流",
+  "version": "2.1.7",
+  "author": {
+    "name": "OpenSpec Contributors"
+  },
+  "skills": "./skills/"
+}

package/.codex-plugin/plugin.json

@@ -0,0 +1,9 @@
+{
+  "name": "openspec",
+  "version": "2.1.7",
+  "description": "OpenSpec 确定性产品规格工作流",
+  "author": {
+    "name": "OpenSpec Contributors"
+  },
+  "skills": "./skills/"
+}

package/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2024 OpenSpec Contributors
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

package/README.md

@@ -0,0 +1,111 @@
+# OpenSpec v2
+
+OpenSpec 是面向 AI 编码协作的确定性产品规格工作流。v2 使用轻量 packet、统一 Hook、分层 Skill 和按 task category 初始化的 code Worker；每个 code task 拆成 scout → build → verify → repair 四个短命子代理阶段，控制会话只编排、不读代码与截图，宿主不支持 subagent 时主 agent 按同一组节点文件执行。
+
+## 工作流
+
+```text
+init
+  -> new change
+  -> sources add / collect
+  -> parse -> tech(可跳过) -> plan
+  -> Gate-A
+  -> code workers
+  -> Gate-B
+  -> verify / fix-verify
+  -> Gate-C
+  -> openspec/archive/YYYY-MM-DD-<change>/
+```
+
+Skill 入口与状态机节点的对应关系：
+
+- `/opsx-propose`：collect → parse → tech → plan，停在 Gate-A
+- `/opsx-apply`：批准 Gate-A 后逐个 code worker，停在 Gate-B
+- `/opsx-verify`：批准 Gate-B 后跑 QA，停在 Gate-C
+- `/opsx-fix-verify` / `/opsx-archive` / `/opsx-resume` / `/opsx-source-update` / `/opsx-gate-decision` / `/opsx-explore`
+
+## 快速开始
+
+需要 Node.js 22 或 24。本仓库通过 `package.json` 的 `packageManager` 字段钉住 pnpm 11。
+
+### 安装 pnpm
+
+先执行 `pnpm -v`。没有该命令时，已有 Node 的环境优先用 Corepack（会按仓库钉住的版本准备 pnpm）：
+
+```bash
+corepack enable
+```
+
+其他方式：
+
+- macOS（Homebrew）：`brew install pnpm`
+- POSIX 独立脚本：`curl -fsSL https://get.pnpm.io/install.sh | sh -`（pnpm 11 的独立脚本不支持 Intel Mac，可用 Homebrew）
+- npm：`npx get-pnpm`
+
+装完后新开一个终端，确认 `pnpm -v` 可用。
+
+### 构建并注册全局 `openspec` 命令
+
+在仓库根目录：
+
+```bash
+pnpm install
+pnpm run build
+pnpm add -g .
+```
+
+pnpm 11 已移除 `pnpm link --global`。把本地 CLI 注册成全局命令的方式是在包目录执行 `pnpm add -g .`：它读取 `package.json` 的 `bin.openspec`（`./bin/openspec.js`），之后任意目录都能直接跑 `openspec`。该入口依赖 `dist/`，必须先 `pnpm run build`。
+
+不想注册全局时，继续用 `node bin/openspec.js <命令>`。
+
+```bash
+openspec init --tools claude,codex,cursor --preset flutter-mobile --yes
+openspec new change improve-checkout
+openspec sources add --change improve-checkout --notes "简化结算确认" --json
+```
+
+### 全局命令常见问题
+
+**`pnpm link --global` 报错，或提示没有 `--global`。** pnpm 11 删除了该选项。改在仓库根目录执行 `pnpm add -g .`。卸载：`pnpm remove -g @birdie_moblie/open_spec`。
+
+**`ERR_PNPM_NO_GLOBAL_BIN_DIR`。** 全局 bin 目录未创建，或不在 `PATH` 里。执行 `pnpm setup`，再 `source ~/.zshrc`（bash 则 `~/.bashrc`）或重开终端。从 pnpm 10 升到 11 后通常要再跑一次 setup。不要用 `sudo`（会写到 root 的家目录，而不是当前用户）。
+
+**`openspec: command not found`。** `PATH` 没有包含 pnpm 全局 bin。看 `pnpm bin -g` 的输出，确认该目录出现在 `echo $PATH` 中。zsh 可能缓存了旧的命令位置，执行 `hash -r`。也可用 `ls "$(pnpm bin -g)/openspec"` 确认二进制是否已注册。
+
+**能跑但版本不对，或 `which openspec` 指向别处。** `which -a openspec` 看优先级。以前用 `npm install -g` 或项目里的 `install-cli.mjs` 装过的副本可能排在前面。卸掉冲突的 npm 全局包，或让 `pnpm bin -g` 在 `PATH` 里更靠前。包名是 `@birdie_moblie/open_spec`，命令名仍是 `openspec`。
+
+**`Cannot find module '.../dist/cli.js'`。** 还没 build，或 `dist/` 被删了。重新 `pnpm run build`。改 TypeScript 源码后也要再 build；一般不必重新 `pnpm add -g .`，除非改了 `bin` 字段。
+
+### 团队成员
+
+已初始化的业务项目里用安装脚本对齐 CLI 版本：
+
+```bash
+node openspec/install-cli.mjs
+openspec doctor --json
+```
+
+成本实验与只读用量分析见 [成本测试指南](docs/guides/cost-benchmark.md)。支持 Codex/Claude 日志去重、父子线程核算、明确费用口径，以及保留旧默认输出的精简协议。
+
+`init --yes` 才会调用 Claude/Codex 的原生 marketplace；Cursor 返回需要在 UI 完成的 `pending_user_action`。CI 或其他非 TTY 环境未给确认时也返回 pending（退出码 2），`--skip-plugins` 会把跳过决定写入项目 runtime receipt。可用 `OPENSPEC_HOME` 隔离 marketplace cache。
+
+## 开发验证
+
+```bash
+pnpm run lint
+pnpm run build
+pnpm run typecheck:test
+pnpm test
+```
+
+## 文档
+
+- [快速开始](docs/getting-started.md)
+- [工作流](docs/guides/workflow.md)
+- [项目配置](docs/guides/configuration.md)
+- [架构](docs/maintainers/architecture.md)
+- [Worker 回执](docs/guides/worker-evidence.md)
+- [成本实验](docs/guides/cost-benchmark.md)
+- [插件运行契约](docs/maintainers/plugin-runtime-contract.md)
+- [插件与宿主迁移](docs/guides/plugin-migration.md)
+- [版本沿革（V1 → V2）](docs/history/README.md)

package/bin/openspec.js

@@ -0,0 +1,3 @@
+#!/usr/bin/env node
+
+import '../dist/cli.js';

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

@@ -0,0 +1,3 @@
+import type { Command } from 'commander';
+export declare function registerChange(program: Command): void;
+//# sourceMappingURL=change.d.ts.map

package/dist/cli/commands/change.js

@@ -0,0 +1,37 @@
+import { createChange, listChangeNames, project, resolveChangeName, } from '../../index.js';
+import { changeStatus } from '../../core/status.js';
+import { emitJson, jsonMode } from '../output.js';
+export function registerChange(program) {
+    const created = program
+        .command('new')
+        .description('创建资源');
+    created
+        .command('change <name>')
+        .description('创建新的 change')
+        .option('--description <text>', '可选说明')
+        .action((name, options, command) => {
+        const { projectRoot } = project();
+        const state = createChange(projectRoot, name, options.description);
+        emitJson(jsonMode(command), state, () => `已创建 change ${name}`);
+    });
+    program
+        .command('list')
+        .description('列出 change')
+        .action((options, command) => {
+        const { projectRoot } = project();
+        const names = listChangeNames(projectRoot);
+        emitJson(jsonMode(command.parent ?? command), { changes: names }, () => names.join('\n') || '(empty)');
+        void options;
+    });
+    program
+        .command('status')
+        .description('查看 change 状态与下一步')
+        .option('--change <name>', 'change 名称')
+        .action((options, command) => {
+        const { projectRoot, config } = project();
+        const name = resolveChangeName(projectRoot, options.change);
+        const payload = changeStatus(projectRoot, name, config);
+        emitJson(jsonMode(command), payload, () => `${name} @ ${payload.node} → ${payload.next.action}`);
+    });
+}
+//# sourceMappingURL=change.js.map

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

@@ -0,0 +1,3 @@
+import { type Command } from 'commander';
+export declare function registerExt(program: Command): void;
+//# sourceMappingURL=ext.d.ts.map

package/dist/cli/commands/ext.js

@@ -0,0 +1,196 @@
+import { Option } from 'commander';
+import { costDoctor } from '../../usage/doctor.js';
+import { addMarketplace, assertPluginsPresent, BUILTIN_MARKETPLACE, installPlugin, inspectHookEntries, inspectMarketplaceDependencies, listMarketplaces, listPresets, loadPreset, project, verifyDelivery, verifyInstallCli, VERSION, PACKAGE_NAME, } from '../../index.js';
+import { keptMarketplaceRefs, mergePreset, scaffoldPreset } from '../../config/presets.js';
+import { upgradeMarketplace } from '../../marketplace/upgrade.js';
+import { saveConfig as writeConfig } from '../../config/load.js';
+import { emitJson, jsonMode } from '../output.js';
+import { AppError } from '../../shared/errors.js';
+import { readInstallReceipt, writeInstallReceipt } from '../../marketplace/install.js';
+const ENTRY_PENDING_CODES = new Set(['marketplace_not_locked', 'marketplace_cache_missing']);
+export function registerExt(program) {
+    program
+        .command('doctor')
+        .description('检查项目就绪度')
+        .option('--cost', '只读检查成本测试环境与实际用量')
+        .addOption(new Option('--host <host>', '成本诊断宿主').choices(['codex', 'claude']).default('codex'))
+        .option('--session <path...>', '实际 JSONL 日志，可重复', (value, previous) => [...previous, value], [])
+        .option('--capability <name>', '实验显式要求的能力，可重复', (value, previous) => [...previous, value], [])
+        .option('--evidence <path>', '能力与隔离探针证据清单')
+        .option('--expect-model <model>', '固定模型')
+        .option('--expect-effort <effort>', '固定推理配置')
+        .action((options, command) => {
+        if (options.cost) {
+            const payload = costDoctor({ host: options.host, sessions: options.session, evidence: options.evidence,
+                model: options.expectModel, effort: options.expectEffort, capabilities: options.capability, cwd: process.cwd() });
+            emitJson(jsonMode(command), payload, () => payload.ok ? 'cost doctor ok' : `cost doctor gaps: ${payload.gaps.join(', ')}`);
+            if (!payload.ok)
+                process.exitCode = 2;
+            return;
+        }
+        const { projectRoot, config } = project();
+        const hosts = (config.tools ?? []);
+        const delivery = hosts.map((host) => ({ host, ...verifyDelivery(projectRoot, host) }));
+        const installer = verifyInstallCli(projectRoot, VERSION, PACKAGE_NAME);
+        const dependencies = inspectMarketplaceDependencies(projectRoot, config.marketplaces ?? [], config.plugins ?? []);
+        const entries = inspectHookEntries(projectRoot, config);
+        const installReceipt = readInstallReceipt(projectRoot);
+        const pluginDelivery = (config.plugins ?? []).flatMap((plugin) => hosts.map((host) => {
+            const selector = `${plugin.name}@${plugin.marketplace}`;
+            const record = installReceipt.find((item) => item.plugin === plugin.name
+                && item.marketplace === plugin.marketplace
+                && item.host === host);
+            const dependency = dependencies.find((item) => item.kind === 'plugin' && item.id === selector);
+            const ok = record?.status === 'installed'
+                && dependency?.ok === true
+                && record.digest === dependency.digest
+                && record.resolvedSha === dependency.resolvedSha;
+            return {
+                plugin: selector,
+                host,
+                status: record?.status ?? 'missing',
+                ok,
+            };
+        }));
+        const payload = {
+            ok: installer.ok
+                && delivery.every((item) => item.ok || hosts.length === 0)
+                && dependencies.every((item) => item.ok)
+                && pluginDelivery.every((item) => item.ok)
+                && entries.every((item) => item.ok),
+            projectRoot,
+            schema: config.schema,
+            builtinMarketplace: BUILTIN_MARKETPLACE,
+            delivery,
+            installer,
+            dependencies,
+            pluginDelivery,
+            entries,
+        };
+        emitJson(jsonMode(command), payload, () => payload.ok ? 'doctor ok' : 'doctor found issues');
+        if (!payload.ok) {
+            const integrityFailure = delivery.some((item) => item.status === 'failed' || (item.status === 'installed' && !item.ok))
+                || Boolean(installer.actual && !installer.ok)
+                || dependencies.some((item) => item.code?.includes('mismatch') || item.code?.includes('digest') || item.code === 'plugin_conflict'
+                    || item.code === 'plugin_version_too_low')
+                || pluginDelivery.some((item) => item.status === 'failed' || (item.status === 'installed' && !item.ok))
+                // 未锁定/缓存缺失属于尚未安装（2）；入口缺失或类型阶段不符是已安装内容与配置不兼容（1）。
+                || entries.some((item) => !item.ok && !ENTRY_PENDING_CODES.has(item.code ?? ''));
+            process.exitCode = integrityFailure ? 1 : 2;
+        }
+        void options;
+    });
+    const preset = program.command('preset').description('团队 preset');
+    preset.command('list').action((opts, command) => {
+        const items = listPresets().map((item) => ({ id: item.id, title: item.title, version: item.version }));
+        emitJson(jsonMode(command), { presets: items }, () => items.map((item) => item.id).join('\n'));
+        void opts;
+    });
+    preset.command('show <id>').action((id, opts, command) => {
+        emitJson(jsonMode(command), loadPreset(id), () => id);
+        void opts;
+    });
+    preset.command('apply <id>').action((id, opts, command) => {
+        const { projectRoot, config } = project();
+        const preset = loadPreset(id);
+        const keptMarketplaces = keptMarketplaceRefs(config, preset);
+        writeConfig(projectRoot, mergePreset(config, preset));
+        const scaffold = scaffoldPreset(projectRoot, preset);
+        emitJson(jsonMode(command), { id, scaffold, keptMarketplaces }, () => [
+            `applied ${id}`,
+            ...scaffold.map((item) => `  ${item.status === 'created' ? '生成' : '保留已有'} ${item.path}`),
+            ...keptMarketplaces.map((item) => `  保留宿主 marketplace ${item.name}@${item.ref.slice(0, 12)}（preset 基线 ${item.presetRef.slice(0, 12)}）`),
+        ].join('\n'));
+        void opts;
+    });
+    const marketplace = program.command('marketplace').description('插件市场');
+    marketplace.command('list').action((opts, command) => {
+        const { projectRoot } = project();
+        const items = listMarketplaces(projectRoot);
+        emitJson(jsonMode(command), { marketplaces: items }, () => items.map((item) => `${item.name}@${item.ref}`).join('\n'));
+        void opts;
+    });
+    marketplace
+        .command('add [repo]')
+        .option('--name <name>', '名称')
+        .option('--ref <ref>', 'git ref')
+        .option('--dir <path>', '本地目录')
+        .action((repo, options, command) => {
+        const { projectRoot } = project();
+        const record = addMarketplace({
+            projectRoot,
+            repo,
+            name: options.name,
+            ref: options.ref,
+            dir: options.dir,
+        });
+        emitJson(jsonMode(command), record, () => `added ${record.name}@${record.ref}`);
+    });
+    marketplace
+        .command('upgrade <name>')
+        .description('把宿主 config 中的远端 marketplace 升级到新的不可变 ref：校验插件版本与入口后重装，失败时保持旧版本')
+        .requiredOption('--ref <ref>', '完整 Git SHA 或 refs/tags/<tag>')
+        .option('--allow-active-changes', '存在进行中的 change 时仍升级；这些 change 的来源与回执需重新采集或派发')
+        .action((name, options, command) => {
+        const { projectRoot } = project();
+        const result = upgradeMarketplace({
+            projectRoot, name, ref: options.ref, allowActiveChanges: Boolean(options.allowActiveChanges),
+        });
+        emitJson(jsonMode(command), result, () => [
+            `upgraded ${result.marketplace}: ${result.from.ref.slice(0, 12)} → ${result.to.ref.slice(0, 12)}（${result.status}）`,
+            ...result.plugins.map((item) => `  ${item.name} ${item.version ?? '未声明版本'}${item.minVersion ? `（最低 ${item.minVersion}）` : ''}`),
+            ...result.issues.map((item) => `  问题 ${item.scope}: ${item.error}`),
+            '  按插件 Skill 核对宿主工具依赖后，运行 openspec doctor',
+        ].join('\n'));
+        if (result.status === 'partial')
+            process.exitCode = 1;
+        else if (result.status === 'pending_user_action')
+            process.exitCode = 2;
+    });
+    const plugin = program.command('plugin').description('安装 marketplace 插件');
+    plugin
+        .command('install <selector>')
+        .option('--host <host>', 'claude | codex | cursor', 'claude')
+        .action((selector, options, command) => {
+        const { projectRoot, config } = project();
+        const host = parseHost(options.host);
+        const at = String(selector).indexOf('@');
+        const name = at >= 0 ? selector.slice(0, at) : selector;
+        const marketplace = at >= 0 ? selector.slice(at + 1) : BUILTIN_MARKETPLACE.name;
+        if (!name || !marketplace)
+            throw new AppError('invalid_plugin_selector', `插件 selector 不合法: ${selector}`);
+        const declared = (config.plugins ?? []).find((item) => item.name === name && item.marketplace === marketplace);
+        assertPluginsPresent(projectRoot, [{ name, marketplace, minVersion: declared?.minVersion }]);
+        const result = installPlugin({
+            plugin: name,
+            marketplace,
+            host,
+            projectRoot,
+        });
+        const retained = readInstallReceipt(projectRoot).filter((item) => item.plugin !== name
+            || item.marketplace !== marketplace || item.host !== host);
+        writeInstallReceipt(projectRoot, [...retained, result]);
+        emitJson(jsonMode(command), result, () => `${result.status} ${selector}`);
+        if (result.status === 'failed')
+            process.exitCode = 1;
+        else if (result.status === 'pending_user_action')
+            process.exitCode = 2;
+    });
+    const configCmd = program.command('config').description('项目配置');
+    configCmd.command('path').action((opts, command) => {
+        const { projectRoot } = project();
+        emitJson(jsonMode(command), { path: `${projectRoot}/openspec/config.yaml` }, () => `${projectRoot}/openspec/config.yaml`);
+        void opts;
+    });
+    configCmd.command('get').action((opts, command) => {
+        const { config } = project();
+        emitJson(jsonMode(command), config, () => 'ok');
+        void opts;
+    });
+}
+function parseHost(value) {
+    if (!['claude', 'codex', 'cursor'].includes(value))
+        throw new AppError('invalid_host', `未知宿主: ${value}`);
+    return value;
+}
+//# sourceMappingURL=ext.js.map

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

@@ -0,0 +1,3 @@
+import type { Command } from 'commander';
+export declare function registerFigma(sources: Command): void;
+//# sourceMappingURL=figma.d.ts.map

package/dist/cli/commands/figma.js

@@ -0,0 +1,73 @@
+import { readFileSync, writeFileSync, mkdirSync } from 'node:fs';
+import path from 'node:path';
+import { fileURLToPath } from 'node:url';
+import { project } from '../../index.js';
+import { artifactPath, artifactRel } from '../../core/change.js';
+import { resolveInside } from '../../shared/paths.js';
+import { figmaSource, projectMetadata, indexPage } from '../../figma/index.js';
+import { claudeFigmaSettings, figmaHook } from '../../figma/claude.js';
+import { imagePixelLimit } from '../../figma/media.js';
+export function registerFigma(sources) {
+    const figma = sources.command('figma').description('内建 Smart Figma：页面索引与会话级官方 MCP 接入');
+    figma.command('index').requiredOption('--source <url>', 'Figma 来源 URL')
+        .requiredOption('--input <path>', '项目内完整 metadata JSON/XML 文件')
+        .option('--output <path>', '完整机器索引保存到项目内文件；stdout 只返回有界分页')
+        .action(options => {
+        const file = resolveInside(process.cwd(), options.input);
+        const text = readFileSync(file, 'utf8');
+        const response = text.trimStart().startsWith('<') ? text : JSON.parse(text);
+        const index = projectMetadata(response, figmaSource(options.source));
+        if (options.output) {
+            const output = resolveInside(process.cwd(), options.output);
+            mkdirSync(path.dirname(output), { recursive: true });
+            writeFileSync(output, JSON.stringify(index, null, 2) + '\n');
+        }
+        console.log(JSON.stringify({ indexPath: options.output ?? null, ...indexPage(index) }));
+    });
+    figma.command('show').requiredOption('--index <path>', '项目内页面索引文件')
+        .option('--offset <n>', '下一页偏移', '0')
+        .action(options => {
+        const index = JSON.parse(readFileSync(resolveInside(process.cwd(), options.index), 'utf8'));
+        console.log(JSON.stringify(indexPage({ ...index, unresolved: index.unresolved ?? [] }, Number(options.offset))));
+    });
+    figma.command('setup').requiredOption('--change <name>', 'change 名称')
+        .option('--min-image-pixels <n>', '当前提供商 PNG 最小总像素；省略则不限制', imagePixelLimit)
+        .description('生成此 change 的 Claude --settings 文件；不修改全局设置或认证')
+        .action(options => {
+        const { projectRoot } = project();
+        const cli = fileURLToPath(new URL('../../../bin/openspec.js', import.meta.url));
+        const settings = claudeFigmaSettings(cli, projectRoot, options.change, options.minImagePixels);
+        const relative = '.opsx/figma-claude-settings.json';
+        const file = artifactPath(projectRoot, options.change, relative);
+        mkdirSync(path.dirname(file), { recursive: true });
+        writeFileSync(file, JSON.stringify(settings, null, 2));
+        console.log(JSON.stringify({ settingsPath: artifactRel(options.change, relative),
+            instruction: '本次 Claude 会话通过 --settings 加载此文件；官方 Figma MCP 需已认证。索引是候选，coding 仍需详情与截图。' }));
+    });
+    figma.command('hook').requiredOption('--project-root <path>', '固定项目根目录')
+        .requiredOption('--change <name>', '固定 change')
+        .option('--min-image-pixels <n>', '当前提供商 PNG 最小总像素；省略则不限制', imagePixelLimit)
+        .action(async (options) => {
+        const chunks = [];
+        let bytes = 0;
+        for await (const chunk of process.stdin) {
+            const buffer = Buffer.isBuffer(chunk) ? chunk : Buffer.from(chunk);
+            bytes += buffer.length;
+            if (bytes > 20 * 1024 * 1024)
+                throw new Error('Smart Figma hook input exceeds 20 MiB');
+            chunks.push(buffer);
+        }
+        const event = JSON.parse(Buffer.concat(chunks).toString('utf8'));
+        try {
+            console.log(JSON.stringify(figmaHook(options.projectRoot, options.change, event, options.minImagePixels)));
+        }
+        catch (error) {
+            const message = `Smart Figma 接入失败，未形成可用索引: ${error.message}`;
+            const hookSpecificOutput = event.hook_event_name === 'PreToolUse'
+                ? { hookEventName: 'PreToolUse', permissionDecision: 'deny', permissionDecisionReason: message }
+                : { hookEventName: 'PostToolUse', updatedMCPToolOutput: [{ type: 'text', text: JSON.stringify({ ok: false, error: message }) }] };
+            console.log(JSON.stringify({ hookSpecificOutput }));
+        }
+    });
+}
+//# sourceMappingURL=figma.js.map

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

@@ -0,0 +1,3 @@
+import type { Command } from 'commander';
+export declare function registerInit(program: Command): void;
+//# sourceMappingURL=init.d.ts.map

package/dist/cli/commands/init.js

@@ -0,0 +1,71 @@
+import path from 'node:path';
+import { initProject, loadPreset } from '../../index.js';
+import { AppError } from '../../shared/errors.js';
+import { emitJson, jsonMode } from '../output.js';
+import { configPathOf, loadConfig } from '../../config/load.js';
+export function registerInit(program) {
+    program
+        .command('init [path]')
+        .description('初始化 OpenSpec 项目')
+        .option('--tools <list>', '宿主工具，逗号分隔：claude,codex,cursor')
+        .option('--preset <id>', '应用团队 preset')
+        .option('--yes', '非交互确认（安装 preset 插件）')
+        .option('--skip-plugins', '跳过 marketplace 插件安装')
+        .action(async (targetPath, options, command) => {
+        const tools = parseTools(options.tools);
+        let confirmed = Boolean(options.yes);
+        const projectRoot = path.resolve(targetPath ?? process.cwd());
+        if (!confirmed
+            && !options.skipPlugins
+            && needsConfirmation(projectRoot, tools, options.preset)
+            && process.stdin.isTTY
+            && process.stdout.isTTY) {
+            const { confirm } = await import('@inquirer/prompts');
+            confirmed = await confirm({ message: '使用宿主原生 marketplace 安装或更新 OpenSpec 及 preset 插件？' });
+        }
+        // 进度只在文本模式打印，且走 stderr：--json 的 stdout/stderr 都留给机器消费
+        const json = jsonMode(command);
+        const result = initProject({
+            cwd: targetPath,
+            tools,
+            preset: options.preset,
+            yes: confirmed,
+            skipPlugins: Boolean(options.skipPlugins),
+            onProgress: json ? undefined : (message) => process.stderr.write(`${message}\n`),
+        });
+        const unfilled = result.scaffold.filter((item) => item.status === 'created');
+        emitJson(json, result, () => [
+            `${result.status}: ${result.projectRoot}`,
+            ...result.issues.map((issue) => `  - ${issue.scope}: ${issue.error.trim().split('\n').join('\n      ')}`),
+            ...(result.issues.length > 0 ? ['  详情见 openspec/.runtime/init.json；修复后重跑同一条 init 命令即可。'] : []),
+            ...(unfilled.length > 0
+                ? ['  下一步：填写以下模板并删除其中的 openspec:fill-me 标记，否则相关 Worker 会以 blocked 停下：',
+                    ...unfilled.map((item) => `    - ${item.path}${item.description ? `（${item.description}）` : ''}`)]
+                : []),
+        ].join('\n'));
+        if (result.status === 'partial')
+            process.exitCode = 1;
+        else if (result.status === 'pending_user_action')
+            process.exitCode = 2;
+    });
+}
+function needsConfirmation(projectRoot, tools, presetId) {
+    const existing = configPathOf(projectRoot) ? loadConfig(projectRoot) : null;
+    const preset = presetId ? loadPreset(presetId) : null;
+    return (tools ?? existing?.tools ?? []).length > 0
+        || (existing?.plugins ?? []).length > 0
+        || (existing?.marketplaces ?? []).length > 0
+        || (preset?.plugins ?? []).length > 0
+        || (preset?.marketplaces ?? []).length > 0;
+}
+function parseTools(raw) {
+    if (!raw)
+        return undefined;
+    const allowed = ['claude', 'codex', 'cursor'];
+    const values = raw.split(',').map((item) => item.trim()).filter(Boolean);
+    const invalid = values.filter((item) => !allowed.includes(item));
+    if (invalid.length > 0)
+        throw new AppError('invalid_host', `未知宿主: ${invalid.join(', ')}`);
+    return [...new Set(values)];
+}
+//# sourceMappingURL=init.js.map

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

@@ -0,0 +1,3 @@
+import { type Command } from 'commander';
+export declare function registerOpsx(program: Command): void;
+//# sourceMappingURL=opsx.d.ts.map