@accelerator-mzq/forge 1.4.0

package/dist/core/migrate/report.js

@@ -0,0 +1,154 @@
+// src/core/migrate/report.ts
+// journal NDJSON + 末态 fs.rename + reader 优先级 — Plan 8d Task 4.4
+// Spec §3.4 trace 格式 + journal 流程 v4
+import { existsSync } from 'node:fs';
+import { open, rename, unlink, writeFile, readFile } from 'node:fs/promises';
+import { join } from 'node:path';
+// 三个 trace 文件名常量
+const NDJSON_NAME = 'migrate-trace.json.ndjson';
+const TMP_NAME = 'migrate-trace.json.tmp';
+const FINAL_NAME = 'migrate-trace.json';
+/**
+ * Journal:NDJSON 行式写入 + 每步 fsync
+ * crash 时半完成 ops 仍可被 readTrace 重建
+ */
+export class Journal {
+    fh;
+    constructor(fh) {
+        this.fh = fh;
+    }
+    /** 打开 journal 文件(append 模式) */
+    static async open(filePath) {
+        const fh = await open(filePath, 'a'); // append 模式:crash 安全
+        return new Journal(fh);
+    }
+    /** 追加一个 op，立即 fsync 防 crash 丢数据 */
+    async append(op) {
+        const line = JSON.stringify(op) + '\n';
+        await this.fh.write(line, null, 'utf8');
+        await this.fh.sync(); // fsync — crash safety 关键步骤
+    }
+    /** 关闭文件句柄 */
+    async close() {
+        await this.fh.close();
+    }
+}
+/**
+ * reader 优先级:.json > .ndjson(重建)> .tmp(忽略,返 null)
+ * 说明:
+ * - .json 是末态原子 rename 写成的,可信
+ * - .ndjson 是 crash 半完成态,可重建 ops
+ * - .tmp 是崩溃中的写入,不可读(可能不完整)
+ */
+export async function readTrace(dir) {
+    const finalPath = join(dir, FINAL_NAME);
+    const ndjsonPath = join(dir, NDJSON_NAME);
+    // 优先级 1:.json 存在且可解析
+    if (existsSync(finalPath)) {
+        try {
+            const content = await readFile(finalPath, 'utf8');
+            return JSON.parse(content);
+        }
+        catch {
+            // .json 损坏(极少见)→ fallback 到 ndjson
+        }
+    }
+    // 优先级 2:.ndjson 存在 → 逐行重建 ops
+    if (existsSync(ndjsonPath)) {
+        const content = await readFile(ndjsonPath, 'utf8');
+        const ops = [];
+        for (const line of content.split('\n')) {
+            if (!line.trim())
+                continue;
+            try {
+                ops.push(JSON.parse(line));
+            }
+            catch {
+                // 容忍最后一行 truncate(crash 中途写入)
+            }
+        }
+        // 注意:.ndjson 行只含 TraceOp 字段,不含 source/sourceRoot/ts/cleanupHint 等 meta;
+        // 此处用占位值('openspec' / '' 等),P5 crash 恢复若需要这些 meta,应从 opts/detect 重新传入
+        // 而非依赖 readTrace 的 ndjson 重建路径。
+        return {
+            version: 1,
+            source: 'openspec',
+            sourceRoot: '',
+            ts: '',
+            ops,
+            conflicts: [],
+            downgrades: [],
+            cleanupHint: '',
+        };
+    }
+    // 优先级 3(最低):.tmp 只有或全无 → 崩溃中,不读
+    return null;
+}
+/**
+ * 末态原子 rename 三步走:
+ * 1. 写 .tmp(完整 final trace JSON)
+ * 2. fs.rename .tmp → .json(POSIX 原子)
+ * 3. 删 .ndjson(若存在)
+ */
+export async function finalizeAndRename(dir, finalTrace) {
+    const tmpPath = join(dir, TMP_NAME);
+    const finalPath = join(dir, FINAL_NAME);
+    const ndjsonPath = join(dir, NDJSON_NAME);
+    // 步骤 1:写 .tmp
+    await writeFile(tmpPath, JSON.stringify(finalTrace, null, 2), 'utf8');
+    // 步骤 2:原子 rename .tmp → .json
+    await rename(tmpPath, finalPath);
+    // 步骤 3:删 .ndjson(仅在存在时)
+    if (existsSync(ndjsonPath)) {
+        await unlink(ndjsonPath);
+    }
+}
+/**
+ * 写 migrate-report.md(spec §3.4)
+ * 磁盘满或写入失败时:降级 stderr 输出全文(spec §3.1)
+ */
+export async function writeReportMd(dir, finalTrace) {
+    const lines = [];
+    lines.push(`# Migration Report — ${finalTrace.source} @ ${finalTrace.ts}`);
+    lines.push('');
+    lines.push('## Summary');
+    lines.push(`- Source: ${finalTrace.source} (rootPath: ${finalTrace.sourceRoot})`);
+    lines.push(`- Total ops: ${finalTrace.ops.length}`);
+    lines.push(`- Conflicts: ${finalTrace.conflicts.length}`);
+    lines.push(`- Downgrades: ${finalTrace.downgrades.length}`);
+    lines.push('');
+    lines.push('## Plan');
+    lines.push('| From | To | Kind | Validate |');
+    lines.push('| ---- | -- | ---- | -------- |');
+    for (const op of finalTrace.ops) {
+        lines.push(`| ${op.from ?? '(missing)'} | ${op.to} | ${op.kind} | ${op.validate} |`);
+    }
+    // 冲突表(可选)
+    if (finalTrace.conflicts.length > 0) {
+        lines.push('');
+        lines.push('## Conflicts');
+        for (const c of finalTrace.conflicts) {
+            lines.push(`- ${c.target} → ${c.rename}`);
+        }
+    }
+    // 降级表(可选)
+    if (finalTrace.downgrades.length > 0) {
+        lines.push('');
+        lines.push('## Downgrades(M13)');
+        for (const d of finalTrace.downgrades) {
+            lines.push(`- ${d.change}: ${d.from} → ${d.to}(reason: ${d.reason})`);
+        }
+    }
+    lines.push('');
+    lines.push('## Cleanup');
+    lines.push(finalTrace.cleanupHint);
+    try {
+        await writeFile(join(dir, 'migrate-report.md'), lines.join('\n'), 'utf8');
+    }
+    catch {
+        // 磁盘满降级:stderr 输出(spec §3.1)
+        console.error('[migrate] report.md 写入失败,降级 stderr 输出:');
+        console.error(lines.join('\n'));
+    }
+}
+//# sourceMappingURL=report.js.map

package/dist/core/migrate/report.js.map

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

package/dist/core/migrate/sources/index.d.ts

@@ -0,0 +1,4 @@
+import type { MigrateSource, SourceId } from '../types.js';
+export declare const SOURCES: Record<SourceId, MigrateSource>;
+export declare function getSource(id: SourceId): MigrateSource;
+//# sourceMappingURL=index.d.ts.map

package/dist/core/migrate/sources/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../../src/core/migrate/sources/index.ts"],"names":[],"mappings":"AAIA,OAAO,KAAK,EAAE,aAAa,EAAE,QAAQ,EAAE,MAAM,aAAa,CAAC;AAI3D,eAAO,MAAM,OAAO,EAAE,MAAM,CAAC,QAAQ,EAAE,aAAa,CAGnD,CAAC;AAEF,wBAAgB,SAAS,CAAC,EAAE,EAAE,QAAQ,GAAG,aAAa,CAMrD"}

package/dist/core/migrate/sources/index.js

@@ -0,0 +1,17 @@
+// src/core/migrate/sources/index.ts
+// source registry — Plan 8a Task 1.3
+// P2 在 openspec.ts 实施后注册 OpenSpecSource;P3 同理 SuperpowersSource
+import { OpenSpecSource } from './openspec.js';
+import { SuperpowersSource } from './superpowers.js';
+export const SOURCES = {
+    openspec: new OpenSpecSource(),
+    superpowers: new SuperpowersSource(),
+};
+export function getSource(id) {
+    const s = SOURCES[id];
+    if (!s) {
+        throw new Error(`unknown migrate source id: ${id}`);
+    }
+    return s;
+}
+//# sourceMappingURL=index.js.map

package/dist/core/migrate/sources/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../../src/core/migrate/sources/index.ts"],"names":[],"mappings":"AAAA,oCAAoC;AACpC,qCAAqC;AACrC,gEAAgE;AAGhE,OAAO,EAAE,cAAc,EAAE,MAAM,eAAe,CAAC;AAC/C,OAAO,EAAE,iBAAiB,EAAE,MAAM,kBAAkB,CAAC;AAErD,MAAM,CAAC,MAAM,OAAO,GAAoC;IACtD,QAAQ,EAAE,IAAI,cAAc,EAAE;IAC9B,WAAW,EAAE,IAAI,iBAAiB,EAAE;CACrC,CAAC;AAEF,MAAM,UAAU,SAAS,CAAC,EAAY;IACpC,MAAM,CAAC,GAAG,OAAO,CAAC,EAAE,CAAC,CAAC;IACtB,IAAI,CAAC,CAAC,EAAE,CAAC;QACP,MAAM,IAAI,KAAK,CAAC,8BAA8B,EAAE,EAAE,CAAC,CAAC;IACtD,CAAC;IACD,OAAO,CAAC,CAAC;AACX,CAAC"}

package/dist/core/migrate/sources/openspec.d.ts

@@ -0,0 +1,14 @@
+import type { MigrateSource, DetectResult, ScanResult, ClassificationPlan, ClassifyCtx, CopyOp, ArtifactKind, MissingArtifact } from '../types.js';
+export declare class OpenSpecSource implements MigrateSource {
+    readonly id: "openspec";
+    detect(cwd: string): Promise<DetectResult>;
+    scan(rootPath: string): Promise<ScanResult>;
+    classify(scan: ScanResult, _ctx: ClassifyCtx): Promise<ClassificationPlan>;
+    prepareCopy(plan: ClassificationPlan, target: string): CopyOp[];
+    transform(content: string, kind: ArtifactKind): string;
+    private transformSpec;
+    private transformProposal;
+    private transformTasks;
+    listMissingArtifacts(plan: ClassificationPlan): MissingArtifact[];
+}
+//# sourceMappingURL=openspec.d.ts.map

package/dist/core/migrate/sources/openspec.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"openspec.d.ts","sourceRoot":"","sources":["../../../../src/core/migrate/sources/openspec.ts"],"names":[],"mappings":"AAIA,OAAO,KAAK,EACV,aAAa,EACb,YAAY,EACZ,UAAU,EACV,kBAAkB,EAClB,WAAW,EACX,MAAM,EACN,YAAY,EACZ,eAAe,EAMhB,MAAM,aAAa,CAAC;AA4DrB,qBAAa,cAAe,YAAW,aAAa;IAClD,QAAQ,CAAC,EAAE,EAAG,UAAU,CAAU;IAE5B,MAAM,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO,CAAC,YAAY,CAAC;IAY1C,IAAI,CAAC,QAAQ,EAAE,MAAM,GAAG,OAAO,CAAC,UAAU,CAAC;IA+F3C,QAAQ,CAAC,IAAI,EAAE,UAAU,EAAE,IAAI,EAAE,WAAW,GAAG,OAAO,CAAC,kBAAkB,CAAC;IAqFhF,WAAW,CAAC,IAAI,EAAE,kBAAkB,EAAE,MAAM,EAAE,MAAM,GAAG,MAAM,EAAE;IAmE/D,SAAS,CAAC,OAAO,EAAE,MAAM,EAAE,IAAI,EAAE,YAAY,GAAG,MAAM;IAStD,OAAO,CAAC,aAAa;IAoDrB,OAAO,CAAC,iBAAiB;IAUzB,OAAO,CAAC,cAAc;IAatB,oBAAoB,CAAC,IAAI,EAAE,kBAAkB,GAAG,eAAe,EAAE;CAqDlE"}

package/dist/core/migrate/sources/openspec.js

@@ -0,0 +1,453 @@
+// src/core/migrate/sources/openspec.ts
+// OpenSpecSource detect/scan/classify/prepareCopy 实施 — Plan 8b Task 2.2-2.5
+// 实际 transform/listMissingArtifacts 由 P2/P5 继续落实
+import { walkLines } from '../markdown-aware.js';
+import { detectEncoding } from '../utils.js';
+import { existsSync } from 'node:fs';
+import { readdir, stat } from 'node:fs/promises';
+import { join, posix as posixPath } from 'node:path';
+// 处理 change 子目录：把 proposal.md / tasks.md / design.md / specs/*.md 加入列表
+async function addChangeFiles(absDir, relDir, out) {
+    const SCALAR_FILES = [
+        { name: 'proposal.md', kind: 'proposal' },
+        { name: 'tasks.md', kind: 'tasks' },
+        { name: 'design.md', kind: 'design' },
+    ];
+    for (const { name, kind } of SCALAR_FILES) {
+        const absPath = join(absDir, name);
+        if (!existsSync(absPath))
+            continue;
+        const stats = await stat(absPath);
+        out.push({
+            absPath,
+            // relPath 必须 posix slash(逻辑路径 key,classify 阶段会按 '/' 切分)
+            relPath: posixPath.join(relDir, name),
+            kind,
+            size: stats.size,
+            mtime: stats.mtime.toISOString(),
+            encoding: await detectEncoding(absPath),
+        });
+    }
+    // specs/<area>.md
+    const specsSubDir = join(absDir, 'specs');
+    if (existsSync(specsSubDir)) {
+        const entries = await readdir(specsSubDir, { withFileTypes: true });
+        for (const e of entries) {
+            if (e.isDirectory() || !e.name.endsWith('.md'))
+                continue;
+            const absPath = join(specsSubDir, e.name);
+            const stats = await stat(absPath);
+            out.push({
+                absPath,
+                // relPath 必须 posix slash(逻辑路径 key)
+                relPath: posixPath.join(relDir, 'specs', e.name),
+                kind: 'spec',
+                size: stats.size,
+                mtime: stats.mtime.toISOString(),
+                encoding: await detectEncoding(absPath),
+            });
+        }
+    }
+}
+// 保留的 slug 列表 — classify 阶段跳过这些
+const RESERVED_SLUGS = new Set(['.cache', '.forge-trash', '.forge-ack', 'archive']);
+// 判断 slug 是否不安全
+function isUnsafeSlug(slug) {
+    if (slug === '..' || slug === '.')
+        return true;
+    if (RESERVED_SLUGS.has(slug))
+        return true;
+    if (slug.includes('/') || slug.includes('\\'))
+        return true;
+    return false;
+}
+export class OpenSpecSource {
+    id = 'openspec';
+    async detect(cwd) {
+        // detect 阶段：检查 openspec/ 是否存在
+        const root = join(cwd, 'openspec');
+        if (!existsSync(root)) {
+            return {
+                found: false,
+                message: `<cwd>/openspec/ 不存在;预期路径:${root}`,
+            };
+        }
+        return { found: true, rootPath: root };
+    }
+    async scan(rootPath) {
+        // scan 阶段：枚举源目录产物(specs / changes / explorations / config.yaml)
+        const files = [];
+        // 1. specs/<n>/spec.md
+        const specsDir = join(rootPath, 'specs');
+        if (existsSync(specsDir)) {
+            const dirs = await readdir(specsDir, { withFileTypes: true });
+            for (const d of dirs) {
+                if (!d.isDirectory())
+                    continue;
+                const specPath = join(specsDir, d.name, 'spec.md');
+                if (!existsSync(specPath))
+                    continue;
+                const stats = await stat(specPath);
+                const encoding = await detectEncoding(specPath);
+                files.push({
+                    absPath: specPath,
+                    // relPath 必须 posix slash(逻辑路径 key)
+                    relPath: posixPath.join('specs', d.name, 'spec.md'),
+                    kind: 'spec',
+                    size: stats.size,
+                    mtime: stats.mtime.toISOString(),
+                    encoding,
+                });
+            }
+        }
+        // 2. changes/<n>/(active 与 archive)
+        const changesDir = join(rootPath, 'changes');
+        if (existsSync(changesDir)) {
+            const entries = await readdir(changesDir, { withFileTypes: true });
+            for (const e of entries) {
+                if (!e.isDirectory())
+                    continue;
+                const changeName = e.name;
+                const isArchive = changeName === 'archive';
+                const changeRoot = join(changesDir, changeName);
+                if (isArchive) {
+                    // archive 子目录：再 readdir 一层
+                    const archiveEntries = await readdir(changeRoot, {
+                        withFileTypes: true,
+                    });
+                    for (const ae of archiveEntries) {
+                        if (!ae.isDirectory())
+                            continue;
+                        await addChangeFiles(join(changeRoot, ae.name), 
+                        // relDir 走 posix(addChangeFiles 内会继续 posix 拼接)
+                        posixPath.join('changes', 'archive', ae.name), files);
+                    }
+                }
+                else {
+                    // relDir 走 posix(addChangeFiles 内会继续 posix 拼接)
+                    await addChangeFiles(changeRoot, posixPath.join('changes', changeName), files);
+                }
+            }
+        }
+        // 3. explorations/*.md
+        const explorationsDir = join(rootPath, 'explorations');
+        if (existsSync(explorationsDir)) {
+            const entries = await readdir(explorationsDir, { withFileTypes: true });
+            for (const e of entries) {
+                if (e.isDirectory() || !e.name.endsWith('.md'))
+                    continue;
+                const absPath = join(explorationsDir, e.name);
+                const stats = await stat(absPath);
+                const encoding = await detectEncoding(absPath);
+                files.push({
+                    absPath,
+                    // relPath 必须 posix slash(逻辑路径 key)
+                    relPath: posixPath.join('explorations', e.name),
+                    kind: 'draft',
+                    size: stats.size,
+                    mtime: stats.mtime.toISOString(),
+                    encoding,
+                });
+            }
+        }
+        // 4. config.yaml
+        const configPath = join(rootPath, 'config.yaml');
+        if (existsSync(configPath)) {
+            const stats = await stat(configPath);
+            files.push({
+                absPath: configPath,
+                relPath: 'config.yaml',
+                kind: 'config',
+                size: stats.size,
+                mtime: stats.mtime.toISOString(),
+                encoding: await detectEncoding(configPath),
+            });
+        }
+        return { isEmpty: files.length === 0, files };
+    }
+    async classify(scan, _ctx) {
+        // classify 阶段：为 scan 结果分类并判定目标位置
+        const changesMap = new Map();
+        const specs = [];
+        const drafts = [];
+        const configFiles = [];
+        const skipped = [];
+        for (const f of scan.files) {
+            // 编码检查：非 UTF-8 直接跳过
+            if (f.encoding === 'non-utf8') {
+                skipped.push({ source: f.relPath, reason: '[skip:encoding-not-utf8]' });
+                continue;
+            }
+            // spec 顶层(specs/<n>/spec.md)
+            if (f.kind === 'spec' && f.relPath.startsWith('specs/')) {
+                specs.push({
+                    relPath: f.relPath.replace(/^specs\//, ''),
+                    source: f,
+                });
+                continue;
+            }
+            // change(active 或 archive)
+            if (f.relPath.startsWith('changes/')) {
+                const parts = f.relPath.split('/');
+                const isArchive = parts[1] === 'archive';
+                const slug = isArchive ? parts[2] : parts[1];
+                if (!slug)
+                    continue;
+                if (isUnsafeSlug(slug)) {
+                    skipped.push({
+                        source: f.relPath,
+                        reason: `[unsafe-slug: ${slug}]`,
+                    });
+                    continue;
+                }
+                let change = changesMap.get(slug);
+                if (!change) {
+                    change = {
+                        slug,
+                        classification: isArchive ? 'archive' : 'active',
+                        artifacts: {},
+                    };
+                    changesMap.set(slug, change);
+                }
+                // spec 文件累积到数组(支持多 area.md);其余 kind 单文件赋值
+                if (f.kind === 'spec') {
+                    change.artifacts.specs = [...(change.artifacts.specs ?? []), f];
+                }
+                else if (f.kind === 'proposal' || f.kind === 'tasks' || f.kind === 'design') {
+                    change.artifacts[f.kind] = f;
+                }
+                // config / draft 的 kind 不进 change.artifacts
+                continue;
+            }
+            // draft(explorations/)
+            if (f.kind === 'draft') {
+                drafts.push({
+                    targetName: f.relPath.replace(/^explorations\//, ''),
+                    source: f,
+                });
+                continue;
+            }
+            // config.yaml
+            if (f.kind === 'config') {
+                configFiles.push({
+                    source: f,
+                    strategy: 'fresh',
+                    targetName: 'config.yaml',
+                });
+                continue;
+            }
+        }
+        return {
+            changes: Array.from(changesMap.values()),
+            specs,
+            drafts,
+            configFiles,
+            skipped,
+        };
+    }
+    prepareCopy(plan, target) {
+        // prepareCopy 阶段：计划 → 具体复制操作
+        const ops = [];
+        // changes（分 active 与 archive）
+        for (const c of plan.changes) {
+            const baseDir = c.classification === 'archive'
+                ? join(target, 'changes', 'archive', c.slug)
+                : join(target, 'changes', c.slug);
+            // proposal / tasks / design 单文件各自 kind.md
+            for (const kind of ['proposal', 'tasks', 'design']) {
+                const f = c.artifacts[kind];
+                if (!f)
+                    continue;
+                ops.push({
+                    source: f.absPath,
+                    target: join(baseDir, `${kind}.md`),
+                    kind,
+                    changeSlug: c.slug,
+                });
+            }
+            // specs 多文件:relPath 是 posix slash,split('/').pop() 安全取文件名
+            if (c.artifacts.specs) {
+                for (const f of c.artifacts.specs) {
+                    const fileName = f.relPath.split('/').pop() ?? 'spec.md';
+                    ops.push({
+                        source: f.absPath,
+                        target: join(baseDir, 'specs', fileName),
+                        kind: 'spec',
+                        changeSlug: c.slug,
+                    });
+                }
+            }
+        }
+        // specs
+        for (const s of plan.specs) {
+            ops.push({
+                source: s.source.absPath,
+                target: join(target, 'specs', s.relPath),
+                kind: 'spec',
+            });
+        }
+        // drafts
+        for (const d of plan.drafts) {
+            ops.push({
+                source: d.source.absPath,
+                target: join(target, 'drafts', d.targetName),
+                kind: 'draft',
+            });
+        }
+        // config
+        for (const cf of plan.configFiles) {
+            ops.push({
+                source: cf.source.absPath,
+                target: join(target, cf.targetName),
+                kind: 'config',
+            });
+        }
+        return ops;
+    }
+    transform(content, kind) {
+        // Task 2.6-2.8 实施三套规则 transform
+        if (kind === 'spec')
+            return this.transformSpec(content);
+        if (kind === 'proposal')
+            return this.transformProposal(content);
+        if (kind === 'tasks')
+            return this.transformTasks(content);
+        return content; // design / config / draft 不 transform
+    }
+    // Task 2.6 spec.md 规则:### Requirement → ## Requirement / #### Scenario → ## Scenario / list-prefix WHEN/THEN/GIVEN → **When**/... / 多行续行合并
+    transformSpec(content) {
+        // 第一步:单次 walker 收集每行的 (line, ctx) 信息数组,后续 stage 复用
+        const rows = [];
+        walkLines(content, (line, ctx) => {
+            rows.push({ line, inFenced: ctx.inFenced, isTableRow: ctx.isTableRow });
+        });
+        // 第二步:stage1 行替换(只在 !inFenced && !isTableRow 行)
+        const stage1Lines = rows.map((r) => {
+            if (r.inFenced || r.isTableRow)
+                return r.line;
+            let l = r.line;
+            // ### Requirement → ## Requirement
+            l = l.replace(/^### Requirement:/, '## Requirement:');
+            // #### Scenario → ## Scenario
+            l = l.replace(/^#### Scenario:/, '## Scenario:');
+            // list-prefix WHEN/THEN/GIVEN/AND/BUT → **When**/**Then**/...
+            const m = l.match(/^(\s*)- \*\*(WHEN|THEN|GIVEN|AND|BUT)\*\*\s+(.+)$/i);
+            if (m) {
+                const [, indent, kw, rest] = m;
+                // 标题大小写:首字母大写,其余小写
+                const titleCase = (kw ?? '').charAt(0).toUpperCase() + (kw ?? '').slice(1).toLowerCase();
+                l = `${indent ?? ''}**${titleCase}** ${rest ?? ''}`;
+            }
+            return l;
+        });
+        // 第三步:fence-aware 多行续行合并 — fenced 内不合并(C #1 fix)
+        const out = [];
+        for (let i = 0; i < stage1Lines.length; i++) {
+            const cur = stage1Lines[i] ?? '';
+            const isFenced = rows[i]?.inFenced;
+            const isStep = !isFenced && /^(\s*)\*\*(When|Then|Given|And|But)\*\*\s/.test(cur);
+            if (isStep) {
+                let merged = cur;
+                // 续行:2+ 空格缩进 + 非 `-` 起始 + 非 heading + 非空 + 非 fenced
+                while (i + 1 < stage1Lines.length) {
+                    const next = stage1Lines[i + 1] ?? '';
+                    const nextFenced = rows[i + 1]?.inFenced;
+                    if (!nextFenced && /^\s{2,}[^-#\s]/.test(next) && next.trim().length > 0) {
+                        merged += ' ' + next.trim();
+                        i++;
+                    }
+                    else
+                        break;
+                }
+                out.push(merged);
+            }
+            else {
+                out.push(cur);
+            }
+        }
+        return out.join('\n');
+    }
+    // Task 2.7 proposal.md 规则:## Problem → ## Why / ## Proposed Solution → ## What
+    transformProposal(content) {
+        // 加 isTableRow 检查,与 transformSpec / transformTasks 保持一致(spec §2.5 / Minor 7 fix)
+        return walkLines(content, (line, ctx) => {
+            if (ctx.inFenced || ctx.isTableRow)
+                return;
+            if (line === '## Problem')
+                return '## Why';
+            if (line === '## Proposed Solution')
+                return '## What';
+        });
+    }
+    // Task 2.8 tasks.md 规则:数字编号 → task-N: / 三层 1.2.3 → task-1-2-3:
+    transformTasks(content) {
+        return walkLines(content, (line, ctx) => {
+            if (ctx.inFenced || ctx.isTableRow)
+                return;
+            // 匹配 `- [x] N.M.K. text` 格式(最多三层编号)
+            const m = line.match(/^(\s*)- \[([ x])\] (\d+(?:\.\d+){0,2})\.\s+(.+)$/);
+            if (!m)
+                return;
+            const [, indent, checked, num, rest] = m;
+            // 将 `1.2.3` 变为 `task-1-2-3`
+            const taskId = `task-${(num ?? '').replace(/\./g, '-')}`;
+            return `${indent ?? ''}- [${checked ?? ' '}] ${taskId}: ${rest ?? ''}`;
+        });
+    }
+    listMissingArtifacts(plan) {
+        // 枚举 Plan 中缺件的 artifacts;for each change,检查 proposal + spec(specs) 是否齐全
+        // C2 修:用目标分桶(proposal 优先 design,fallback tasks/'self';specs 优先 tasks,fallback design/'self')
+        const missing = [];
+        for (const c of plan.changes) {
+            const archivePrefix = c.classification === 'archive' ? 'archive/' : '';
+            // 检查 proposal — facts source 优先 design,fallback tasks,最后 self(附 sourceAbsPath)
+            if (!c.artifacts.proposal) {
+                let factsSource;
+                let sourceAbsPath;
+                if (c.artifacts.design) {
+                    factsSource = 'design';
+                }
+                else if (c.artifacts.tasks) {
+                    factsSource = 'tasks';
+                }
+                else {
+                    // 都没有 — 用 specs 数组第一个(若有)作 self 路径
+                    factsSource = 'self';
+                    sourceAbsPath = c.artifacts.specs?.[0]?.absPath;
+                }
+                missing.push({
+                    changeSlug: c.slug,
+                    kind: 'proposal',
+                    targetPath: `forge/changes/${archivePrefix}${c.slug}/proposal.md`,
+                    factsSource,
+                    sourceAbsPath,
+                });
+            }
+            // 检查 specs 数组 — facts source 优先 tasks,fallback design,最后 self(附 sourceAbsPath)
+            if (!c.artifacts.specs || c.artifacts.specs.length === 0) {
+                let factsSource;
+                let sourceAbsPath;
+                if (c.artifacts.tasks) {
+                    factsSource = 'tasks';
+                }
+                else if (c.artifacts.design) {
+                    factsSource = 'design';
+                }
+                else {
+                    // 都没有 — 用 proposal(若有)作 self 路径
+                    factsSource = 'self';
+                    sourceAbsPath = c.artifacts.proposal?.absPath;
+                }
+                missing.push({
+                    changeSlug: c.slug,
+                    kind: 'specs',
+                    targetPath: `forge/changes/${archivePrefix}${c.slug}/specs/${c.slug}.md`,
+                    factsSource,
+                    sourceAbsPath,
+                });
+            }
+        }
+        return missing;
+    }
+}
+//# sourceMappingURL=openspec.js.map