@birdie_moblie/open_spec 2.1.7 → 2.2.0

package/.claude-plugin/plugin.json

@@ -1,7 +1,7 @@
 {
   "name": "openspec",
   "description": "OpenSpec 确定性产品规格工作流",
-  "version": "2.1.7",
+  "version": "2.2.0",
   "author": {
     "name": "OpenSpec Contributors"
   },

package/.codex-plugin/plugin.json

@@ -1,6 +1,6 @@
 {
   "name": "openspec",
-  "version": "2.1.7",
+  "version": "2.2.0",
   "description": "OpenSpec 确定性产品规格工作流",
   "author": {
     "name": "OpenSpec Contributors"

package/README.md

@@ -59,7 +59,7 @@ pnpm 11 已移除 `pnpm link --global`。把本地 CLI 注册成全局命令的
 不想注册全局时，继续用 `node bin/openspec.js <命令>`。
 
 ```bash
-openspec init --tools claude,codex,cursor --preset flutter-mobile --yes
+openspec init --tools claude,codex,cursor --preset flutter-mobile --preset-repo <preset 仓库> --preset-ref refs/tags/<tag> --yes
 openspec new change improve-checkout
 openspec sources add --change improve-checkout --notes "简化结算确认" --json
 ```

package/dist/cli/commands/ext.js

@@ -1,9 +1,13 @@
+import path from 'node:path';
 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 { addMarketplace, assertPluginsPresent, BUILTIN_MARKETPLACE, installPlugin, inspectHookEntries, inspectMarketplaceDependencies, listMarketplaces, project, verifyDelivery, verifyInstallCli, VERSION, PACKAGE_NAME, } from '../../index.js';
+import { describeOrigins } from '../../config/presets.js';
 import { upgradeMarketplace } from '../../marketplace/upgrade.js';
-import { saveConfig as writeConfig } from '../../config/load.js';
+import { findProjectRoot, loadProjectConfig } from '../../config/load.js';
+import { fetchPresetRepo, inspectPreset, listRepoPresets, loadPresetBaseline, presetRootForProject, readPresetLock, readRepoPreset } from '../../config/preset-repo.js';
+import { migratePreset, upgradePreset, usePreset } from '../../config/preset-use.js';
+import { validatePresetRepo, writePresetIndex } from '../../config/preset-repo-tools.js';
 import { emitJson, jsonMode } from '../output.js';
 import { AppError } from '../../shared/errors.js';
 import { readInstallReceipt, writeInstallReceipt } from '../../marketplace/install.js';
@@ -28,7 +32,17 @@ export function registerExt(program) {
                 process.exitCode = 2;
             return;
         }
-        const { projectRoot, config } = project();
+        const projectRoot = findProjectRoot();
+        const layer = loadProjectConfig(projectRoot);
+        const presetCheck = layer.preset ? inspectPreset(projectRoot, layer.preset) : null;
+        if (presetCheck && !presetCheck.ok) {
+            // 生效配置依赖 preset 基线；基线不可用时其余检查没有可靠输入，只报告 preset。
+            const payload = { ok: false, projectRoot, preset: presetCheck };
+            emitJson(jsonMode(command), payload, () => `doctor found issues: preset ${presetCheck.code}: ${presetCheck.message}`);
+            process.exitCode = presetCheck.code === 'preset_not_locked' || presetCheck.code === 'preset_cache_missing' ? 2 : 1;
+            return;
+        }
+        const { config } = project();
         const hosts = (config.tools ?? []);
         const delivery = hosts.map((host) => ({ host, ...verifyDelivery(projectRoot, host) }));
         const installer = verifyInstallCli(projectRoot, VERSION, PACKAGE_NAME);
@@ -60,6 +74,7 @@ export function registerExt(program) {
                 && entries.every((item) => item.ok),
             projectRoot,
             schema: config.schema,
+            ...(presetCheck ? { preset: presetCheck } : {}),
             builtinMarketplace: BUILTIN_MARKETPLACE,
             delivery,
             installer,
@@ -81,28 +96,132 @@ export function registerExt(program) {
         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;
+    /** --repo/--ref 指定时读该仓库快照，否则读项目引用并锁定的仓库。 */
+    const presetRepoRoot = (opts) => {
+        if (Boolean(opts.repo) !== Boolean(opts.ref))
+            throw new AppError('invalid_arguments', '--repo 与 --ref 需要同时指定');
+        if (opts.repo && opts.ref)
+            return fetchPresetRepo(opts.repo, opts.ref).cachePath;
+        const projectRoot = findProjectRoot();
+        const layer = loadProjectConfig(projectRoot);
+        if (!layer.preset)
+            throw new AppError('preset_repo_required', '项目未引用 preset；用 --repo 与 --ref 指定 preset 仓库');
+        return presetRootForProject(projectRoot, layer.preset).root;
+    };
+    preset.command('list')
+        .description('列出 preset：指定 --repo/--ref 时读该仓库，否则读项目引用的仓库')
+        .option('--repo <repo>', 'preset 仓库地址')
+        .option('--ref <ref>', '不可变 ref：完整 Git SHA 或 refs/tags/<tag>')
+        .action((opts, command) => {
+        const items = listRepoPresets(presetRepoRoot(opts));
+        emitJson(jsonMode(command), { presets: items }, () => items.map((item) => `${item.id}\t${item.title}`).join('\n'));
     });
-    preset.command('show <id>').action((id, opts, command) => {
-        emitJson(jsonMode(command), loadPreset(id), () => id);
-        void opts;
+    preset.command('upgrade')
+        .description('把项目引用的 preset 升级到新 ref，列出变化与被项目覆盖遮住的更新')
+        .requiredOption('--ref <ref>', '不可变 ref：完整 Git SHA 或 refs/tags/<tag>')
+        .option('--allow-active-changes', '存在进行中的 change 时仍然升级')
+        .action((opts, command) => {
+        const result = upgradePreset({ projectRoot: findProjectRoot(), ref: opts.ref, allowActiveChanges: opts.allowActiveChanges });
+        emitJson(jsonMode(command), result, () => {
+            if (result.status === 'unchanged')
+                return `preset ${result.id} 已是 ${result.to.ref}`;
+            const lines = [`preset ${result.id}: ${result.from.ref} → ${result.to.ref}（${result.to.resolvedSha.slice(0, 12)}）`];
+            for (const [section, diff] of Object.entries(result.changes)) {
+                for (const [kind, ids] of Object.entries(diff))
+                    if (ids.length > 0)
+                        lines.push(`  ${section} ${kind}: ${ids.join(', ')}`);
+            }
+            if (result.shadowed.length > 0) {
+                lines.push('  以下更新被项目层覆盖，不会生效，请核对是否同步修改：');
+                lines.push(...result.shadowed.map((item) => `    ${item.section}.${item.id}`));
+            }
+            lines.push(...result.scaffold.filter((item) => item.status === 'created').map((item) => `  生成 ${item.path}`));
+            lines.push('运行 openspec init --yes 安装或更新 preset 声明的插件');
+            return lines.join('\n');
+        });
     });
-    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)}）`),
+    preset.command('migrate <id>')
+        .description('把拷贝式配置迁移为引用 preset + 项目层；生效配置必须与迁移前一致')
+        .requiredOption('--repo <repo>', 'preset 仓库地址')
+        .requiredOption('--ref <ref>', '不可变 ref：完整 Git SHA 或 refs/tags/<tag>')
+        .option('--dry-run', '只预览迁移结果，不写文件')
+        .action((id, opts, command) => {
+        const result = migratePreset({ projectRoot: findProjectRoot(), id, repo: opts.repo, ref: opts.ref, dryRun: opts.dryRun });
+        emitJson(jsonMode(command), result, () => [
+            `${result.written ? '已迁移' : '预览'} ${id}@${opts.ref}（${result.resolvedSha.slice(0, 12)}），生效配置与迁移前一致`,
+            `  改为继承 preset：hooks ${result.inherited.hooks.length}、分类 ${result.inherited.taskCategories.length}、插件 ${result.inherited.plugins.length}、marketplace ${result.inherited.marketplaces.length}`,
+            `  项目层保留：hooks ${(result.layer.hooks ?? []).map((hook) => hook.id).join(', ') || '无'}`,
+            `  禁用 preset hook：${(result.layer.disableHooks ?? []).join(', ') || '无'}`,
+            ...Object.entries(result.layer.hookOrder ?? {}).map(([stage, ids]) => `  固定 ${stage} 阶段 hook 顺序：${ids.join(', ')}`),
+            ...result.raisedMinVersions.map((item) => `  插件最低版本提高：${item.plugin} ${item.from ?? '未声明'} → ${item.to}（preset 要求，迁移后安装与 doctor 会检查）`),
+            ...(result.removedLegacyLock ? [`  ${result.written ? '已删除' : '将删除'} openspec/preset-lock.yaml（由 preset-lock.json 取代）`] : []),
+        ].join('\n'));
+    });
+    preset.command('index')
+        .description('在 preset 仓库中生成索引 openspec-presets.json')
+        .option('--dir <path>', 'preset 仓库根目录，默认当前目录')
+        .action((opts, command) => {
+        const index = writePresetIndex(path.resolve(opts.dir ?? process.cwd()));
+        emitJson(jsonMode(command), index, () => index.presets.map((item) => `${item.id}\t${item.digest.slice(0, 12)}`).join('\n'));
+    });
+    preset.command('validate')
+        .description('校验 preset 仓库：规则、模板、插件引用与索引一致性（供 CI 使用）')
+        .option('--dir <path>', 'preset 仓库根目录，默认当前目录')
+        .action((opts, command) => {
+        const result = validatePresetRepo(path.resolve(opts.dir ?? process.cwd()));
+        emitJson(jsonMode(command), result, () => [
+            result.ok ? 'preset repo ok' : 'preset repo has issues',
+            ...result.presets.flatMap((item) => item.issues.map((issue) => `  ${item.id}: ${issue.code} ${issue.message}`)),
+            ...(result.index.ok ? [] : [`  index: ${result.index.code} ${result.index.message}`]),
         ].join('\n'));
+        if (!result.ok)
+            process.exitCode = 1;
+    });
+    preset.command('status')
+        .description('查看项目引用的 preset 与生效配置中每项的来源')
+        .action((opts, command) => {
+        const projectRoot = findProjectRoot();
+        const layer = loadProjectConfig(projectRoot);
+        const baseline = loadPresetBaseline(projectRoot, layer);
+        const lock = layer.preset ? readPresetLock(projectRoot) : null;
+        const origins = describeOrigins(layer, baseline);
+        const payload = {
+            preset: layer.preset && lock ? { ...layer.preset, resolvedSha: lock.resolvedSha, digest: lock.digest } : null,
+            origins,
+        };
+        emitJson(jsonMode(command), payload, () => {
+            const lines = [payload.preset ? `preset ${payload.preset.id}@${payload.preset.ref}（${payload.preset.resolvedSha.slice(0, 12)}）` : '未引用 preset'];
+            for (const [section, items] of Object.entries(origins)) {
+                for (const [id, origin] of Object.entries(items))
+                    lines.push(`  ${section}.${id}: ${origin}`);
+            }
+            return lines.join('\n');
+        });
         void opts;
     });
+    preset.command('show <id>')
+        .description('查看 preset 内容：指定 --repo/--ref 时读该仓库，否则读项目引用的仓库')
+        .option('--repo <repo>', 'preset 仓库地址')
+        .option('--ref <ref>', '不可变 ref：完整 Git SHA 或 refs/tags/<tag>')
+        .action((id, opts, command) => {
+        const preset = readRepoPreset(presetRepoRoot(opts), id);
+        emitJson(jsonMode(command), preset, () => `${preset.id}\t${preset.title}`);
+    });
+    preset.command('use <id>')
+        .description('引用 preset 仓库中的 preset')
+        .requiredOption('--repo <repo>', 'preset 仓库地址')
+        .requiredOption('--ref <ref>', '不可变 ref：完整 Git SHA 或 refs/tags/<tag>')
+        .action((id, opts, command) => {
+        const projectRoot = findProjectRoot();
+        const result = usePreset({ projectRoot, id, repo: opts.repo, ref: opts.ref });
+        emitJson(jsonMode(command), result, () => [
+            `using ${id}@${opts.ref}（${result.resolvedSha.slice(0, 12)}）`,
+            ...result.scaffold.map((item) => `  ${item.status === 'created' ? '生成' : '保留已有'} ${item.path}`),
+            ...result.warnings.map((item) => `  注意：${item}`),
+            ...result.notes.map((item) => `  说明：${item}`),
+            '运行 openspec init --yes 安装 preset 声明的插件',
+        ].join('\n'));
+    });
     const marketplace = program.command('marketplace').description('插件市场');
     marketplace.command('list').action((opts, command) => {
         const { projectRoot } = project();

package/dist/cli/commands/init.js

@@ -1,23 +1,26 @@
 import path from 'node:path';
-import { initProject, loadPreset } from '../../index.js';
+import { initProject } from '../../index.js';
 import { AppError } from '../../shared/errors.js';
 import { emitJson, jsonMode } from '../output.js';
-import { configPathOf, loadConfig } from '../../config/load.js';
+import { configPathOf, loadProjectConfig } 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('--preset <id>', '引用 preset 仓库中的团队 preset（需同时指定 --preset-repo 与 --preset-ref）')
+        .option('--preset-repo <repo>', 'preset 仓库地址')
+        .option('--preset-ref <ref>', 'preset 的不可变 ref：完整 Git SHA 或 refs/tags/<tag>')
         .option('--yes', '非交互确认（安装 preset 插件）')
         .option('--skip-plugins', '跳过 marketplace 插件安装')
         .action(async (targetPath, options, command) => {
         const tools = parseTools(options.tools);
+        const preset = parsePreset(options.preset, options.presetRepo, options.presetRef);
         let confirmed = Boolean(options.yes);
         const projectRoot = path.resolve(targetPath ?? process.cwd());
         if (!confirmed
             && !options.skipPlugins
-            && needsConfirmation(projectRoot, tools, options.preset)
+            && needsConfirmation(projectRoot, tools, Boolean(preset))
             && process.stdin.isTTY
             && process.stdout.isTTY) {
             const { confirm } = await import('@inquirer/prompts');
@@ -28,7 +31,7 @@ export function registerInit(program) {
         const result = initProject({
             cwd: targetPath,
             tools,
-            preset: options.preset,
+            preset,
             yes: confirmed,
             skipPlugins: Boolean(options.skipPlugins),
             onProgress: json ? undefined : (message) => process.stderr.write(`${message}\n`),
@@ -49,14 +52,21 @@ export function registerInit(program) {
             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
+function needsConfirmation(projectRoot, tools, withPreset) {
+    // preset 在拉取前不知道声明了哪些插件，引用了 preset 就按需要确认处理。
+    const existing = configPathOf(projectRoot) ? loadProjectConfig(projectRoot) : null;
+    return withPreset
+        || Boolean(existing?.preset)
+        || (tools ?? existing?.tools ?? []).length > 0
         || (existing?.plugins ?? []).length > 0
-        || (existing?.marketplaces ?? []).length > 0
-        || (preset?.plugins ?? []).length > 0
-        || (preset?.marketplaces ?? []).length > 0;
+        || (existing?.marketplaces ?? []).length > 0;
+}
+function parsePreset(id, repo, ref) {
+    if (!id && !repo && !ref)
+        return undefined;
+    if (!id || !repo || !ref)
+        throw new AppError('invalid_arguments', '--preset、--preset-repo 与 --preset-ref 需要同时指定');
+    return { id, repo, ref };
 }
 function parseTools(raw) {
     if (!raw)

package/dist/config/load.d.ts

@@ -1,7 +1,11 @@
 import { type ProjectConfig } from './schema.js';
 export declare function findProjectRoot(start?: string): string;
 export declare function configPathOf(projectRoot: string): string | null;
+/** 项目层：config.yaml 的原样内容，只做结构与重复校验。会写配置的命令只读写这一层。 */
+export declare function loadProjectConfig(projectRoot: string): ProjectConfig;
+/** 生效配置：preset 基线与项目层合成后的结果，工作流一律读取这一份。 */
 export declare function loadConfig(projectRoot: string): ProjectConfig;
+/** 只写项目层；写入前确认它与基线合成后仍是合法的生效配置。 */
 export declare function saveConfig(projectRoot: string, config: ProjectConfig): void;
 export declare function defaultConfig(): ProjectConfig;
 //# sourceMappingURL=load.d.ts.map

package/dist/config/load.js

@@ -1,9 +1,11 @@
 import path from 'node:path';
 import { parse as parseYaml, stringify as stringifyYaml } from 'yaml';
 import { exists, readText, writeText } from '../shared/fs.js';
-import { AppError } from '../shared/errors.js';
+import { AppError, isAppError } from '../shared/errors.js';
 import { CONFIG_FILES, OPENSPEC_DIR, resolveInside } from '../shared/paths.js';
-import { ProjectConfigSchema } from './schema.js';
+import { ProjectConfigLayerSchema } from './schema.js';
+import { resolveEffectiveConfig } from './presets.js';
+import { loadPresetBaseline } from './preset-repo.js';
 export function findProjectRoot(start = process.cwd()) {
     let dir = path.resolve(start);
     while (true) {
@@ -24,7 +26,8 @@ export function configPathOf(projectRoot) {
     }
     return null;
 }
-export function loadConfig(projectRoot) {
+/** 项目层：config.yaml 的原样内容，只做结构与重复校验。会写配置的命令只读写这一层。 */
+export function loadProjectConfig(projectRoot) {
     const file = configPathOf(projectRoot);
     if (!file)
         throw new AppError('project_uninitialized', '缺少 openspec/config.yaml');
@@ -35,16 +38,31 @@ export function loadConfig(projectRoot) {
     catch (error) {
         throw new AppError('invalid_config', '项目配置 YAML 无法解析', error instanceof Error ? error.message : String(error));
     }
-    const result = ProjectConfigSchema.safeParse(parsed);
+    const result = ProjectConfigLayerSchema.safeParse(parsed);
     if (!result.success) {
         throw new AppError('invalid_config', '项目配置不合法', result.error.issues);
     }
     return result.data;
 }
+/** 生效配置：preset 基线与项目层合成后的结果，工作流一律读取这一份。 */
+export function loadConfig(projectRoot) {
+    const layer = loadProjectConfig(projectRoot);
+    return resolveEffectiveConfig(layer, loadPresetBaseline(projectRoot, layer));
+}
+/** 只写项目层；写入前确认它与基线合成后仍是合法的生效配置。 */
 export function saveConfig(projectRoot, config) {
-    const parsed = ProjectConfigSchema.safeParse(config);
+    const parsed = ProjectConfigLayerSchema.safeParse(config);
     if (!parsed.success)
         throw new AppError('invalid_config', '拒绝写入不合法的项目配置', parsed.error.issues);
+    try {
+        resolveEffectiveConfig(parsed.data, loadPresetBaseline(projectRoot, parsed.data));
+    }
+    catch (error) {
+        if (isAppError(error) && error.code === 'invalid_config') {
+            throw new AppError('invalid_config', '拒绝写入不合法的项目配置', error.details);
+        }
+        throw error;
+    }
     const file = configPathOf(projectRoot)
         ?? resolveInside(projectRoot, path.posix.join(OPENSPEC_DIR, 'config.yaml'), 'config_path_outside_project');
     writeText(file, stringifyYaml(parsed.data, { lineWidth: 0 }));

package/dist/config/preset-repo-tools.d.ts

@@ -0,0 +1,36 @@
+import { type RepoPreset } from './preset-repo.js';
+/** preset 仓库根部的索引：由 `openspec preset index` 生成，CI 用 `openspec preset validate` 核对与内容一致。 */
+export declare const PRESET_INDEX_FILE = "openspec-presets.json";
+export interface PresetIndex {
+    schemaVersion: 'openspec.preset-index.v1';
+    presets: Array<{
+        id: string;
+        title: string;
+        description?: string;
+        requires?: RepoPreset['requires'];
+        digest: string;
+    }>;
+}
+export declare function buildPresetIndex(root: string): PresetIndex;
+export declare function writePresetIndex(root: string): PresetIndex;
+type Issue = {
+    code: string;
+    message: string;
+    details?: unknown;
+};
+/** 校验整个 preset 仓库：每个 preset 的检查，加上索引存在且与当前内容一致。 */
+export declare function validatePresetRepo(root: string): {
+    ok: boolean;
+    presets: Array<{
+        id: string;
+        ok: boolean;
+        issues: Issue[];
+    }>;
+    index: {
+        ok: boolean;
+        code?: string;
+        message?: string;
+    };
+};
+export {};
+//# sourceMappingURL=preset-repo-tools.d.ts.map

package/dist/config/preset-repo-tools.js

@@ -0,0 +1,114 @@
+import path from 'node:path';
+import { isDeepStrictEqual } from 'node:util';
+import { exists, listDirs, readJson, readText, writeJson } from '../shared/fs.js';
+import { digestDirectory } from '../shared/hash.js';
+import { AppError } from '../shared/errors.js';
+import { resolveInside } from '../shared/paths.js';
+import { TEMPLATE_MARKER } from '../hooks/engine.js';
+import { defaultConfig } from './load.js';
+import { resolveEffectiveConfig } from './presets.js';
+import { listRepoPresets, presetBaseline, readRepoPreset, REPO_PRESET_FILE } from './preset-repo.js';
+/** preset 仓库根部的索引：由 `openspec preset index` 生成，CI 用 `openspec preset validate` 核对与内容一致。 */
+export const PRESET_INDEX_FILE = 'openspec-presets.json';
+export function buildPresetIndex(root) {
+    return {
+        schemaVersion: 'openspec.preset-index.v1',
+        presets: listRepoPresets(root).map((item) => {
+            const preset = readRepoPreset(root, item.id);
+            return {
+                ...item,
+                ...(preset.requires ? { requires: preset.requires } : {}),
+                digest: digestDirectory(path.join(root, item.id)),
+            };
+        }),
+    };
+}
+export function writePresetIndex(root) {
+    const index = buildPresetIndex(root);
+    writeJson(resolveInside(root, PRESET_INDEX_FILE, 'preset_index_outside_repo'), index);
+    return index;
+}
+/** 单个 preset 的发布前检查：规则能与空项目合成为合法配置、模板存在且带待填写标记、插件入口的 marketplace 已声明。 */
+function checkPreset(root, id) {
+    let preset;
+    try {
+        preset = readRepoPreset(root, id);
+    }
+    catch (error) {
+        if (error instanceof AppError)
+            return [{ code: error.code, message: error.message, details: error.details }];
+        throw error;
+    }
+    const issues = [];
+    try {
+        resolveEffectiveConfig(defaultConfig(), presetBaseline(preset));
+    }
+    catch (error) {
+        if (!(error instanceof AppError))
+            throw error;
+        issues.push({ code: error.code, message: error.message, details: error.details });
+    }
+    const presetDir = path.join(root, id);
+    for (const entry of preset.scaffold ?? []) {
+        let template;
+        try {
+            template = resolveInside(presetDir, entry.template, 'preset_template_outside_presets');
+        }
+        catch (error) {
+            if (!(error instanceof AppError))
+                throw error;
+            issues.push({ code: error.code, message: error.message });
+            continue;
+        }
+        if (!exists(template))
+            issues.push({ code: 'preset_template_missing', message: `缺少模板文件: ${entry.template}` });
+        else if (!readText(template).startsWith(TEMPLATE_MARKER)) {
+            issues.push({ code: 'preset_template_unmarked', message: `模板首行必须是 ${TEMPLATE_MARKER}: ${entry.template}` });
+        }
+    }
+    const markets = new Set((preset.marketplaces ?? []).map((item) => item.name));
+    for (const plugin of preset.plugins ?? []) {
+        if (!markets.has(plugin.marketplace)) {
+            issues.push({ code: 'preset_marketplace_undeclared', message: `插件 ${plugin.name} 的 marketplace 未在 preset 中声明: ${plugin.marketplace}` });
+        }
+    }
+    for (const hook of preset.configPatch?.hooks ?? []) {
+        const marketplace = hook.use?.split('@')[1];
+        if (marketplace && !markets.has(marketplace)) {
+            issues.push({ code: 'preset_marketplace_undeclared', message: `hook ${hook.id} 引用的 marketplace 未在 preset 中声明: ${marketplace}` });
+        }
+    }
+    return issues;
+}
+/** 校验整个 preset 仓库：每个 preset 的检查，加上索引存在且与当前内容一致。 */
+export function validatePresetRepo(root) {
+    const ids = listPresetDirs(root);
+    const presets = ids.map((id) => {
+        const issues = checkPreset(root, id);
+        return { id, ok: issues.length === 0, issues };
+    });
+    let index;
+    const indexFile = path.join(root, PRESET_INDEX_FILE);
+    if (!exists(indexFile))
+        index = { ok: false, code: 'preset_index_missing', message: `缺少 ${PRESET_INDEX_FILE}，运行 openspec preset index` };
+    else if (presets.some((item) => !item.ok))
+        index = { ok: false, code: 'preset_index_unchecked', message: '存在不合法的 preset，未核对索引' };
+    else if (!isDeepStrictEqual(readJson(indexFile), buildPresetIndex(root))) {
+        index = { ok: false, code: 'preset_index_stale', message: `${PRESET_INDEX_FILE} 与内容不一致，运行 openspec preset index 后提交` };
+    }
+    else
+        index = { ok: true };
+    if (ids.length === 0) {
+        return { ok: false, presets, index: { ok: false, code: 'preset_repo_empty', message: `仓库中没有任何 <id>/${REPO_PRESET_FILE}` } };
+    }
+    return { ok: presets.every((item) => item.ok) && index.ok, presets, index };
+}
+/** 含 preset.yaml 的顶层目录；不解析内容，解析错误留给逐项检查报告。 */
+function listPresetDirs(root) {
+    if (!exists(root))
+        throw new AppError('preset_repo_missing', `目录不存在: ${root}`);
+    return listDirs(root)
+        .filter((id) => !id.startsWith('.') && exists(path.join(root, id, REPO_PRESET_FILE)))
+        .sort();
+}
+//# sourceMappingURL=preset-repo-tools.js.map