@namewta/speculo 0.7.0 → 0.7.1

package/dist/src/migrations.js

@@ -0,0 +1,470 @@
+import { createHash } from "node:crypto";
+import { cp, lstat, mkdir, readFile, readdir, readlink, rm, writeFile, } from "node:fs/promises";
+import { dirname, join, relative, sep } from "node:path";
+import { pathExists } from "./utils.js";
+const BACKUP_RELATIVE = ".speculo/back";
+const INSTALL_RELATIVE = ".speculo/install.json";
+const MIGRATION_RELATIVE = ".speculo/migration.json";
+const SNAPSHOT_DIR = ".migration-snapshot";
+const MANAGED_STATE_ENTRIES = new Set([
+    "README.md",
+    "workspace.json",
+    "install.json",
+    "migration.json",
+    "back",
+]);
+function toPosix(path) {
+    return path.split(sep).join("/");
+}
+async function readJson(path) {
+    return JSON.parse(await readFile(path, "utf8"));
+}
+async function readTargetVersion(packageRoot) {
+    const manifest = await readJson(join(packageRoot, "package.json"));
+    if (typeof manifest.version !== "string" || !/^\d+\.\d+\.\d+(?:[-+].+)?$/.test(manifest.version)) {
+        throw new Error("package.json has no valid semantic version");
+    }
+    return manifest.version;
+}
+function versionBefore07(version) {
+    const match = /^(\d+)\.(\d+)\.(\d+)/.exec(version);
+    if (!match)
+        return true;
+    const major = Number(match[1]);
+    const minor = Number(match[2]);
+    return major === 0 && minor < 7;
+}
+async function sourceVersion(snapshotState) {
+    const installPath = join(snapshotState, "install.json");
+    if (!(await pathExists(installPath)))
+        return { version: "0.7.0-unversioned", blockers: [] };
+    try {
+        const install = await readJson(installPath);
+        if (install.schema_version !== 1 || typeof install.package_version !== "string") {
+            return {
+                version: null,
+                blockers: [{ code: "invalid-install-manifest", path: ".speculo/install.json", message: "install manifest must use schema v1 and contain package_version" }],
+            };
+        }
+        return { version: install.package_version, blockers: [] };
+    }
+    catch (error) {
+        return {
+            version: null,
+            blockers: [{ code: "invalid-json", path: ".speculo/install.json", message: String(error) }],
+        };
+    }
+}
+async function copySnapshot(previousRoot, snapshotRoot) {
+    await mkdir(snapshotRoot, { recursive: true });
+    const configPath = join(previousRoot, "config.json");
+    if (await pathExists(configPath))
+        await cp(configPath, join(snapshotRoot, "config.json"), { force: true });
+    const previousState = join(previousRoot, ".speculo");
+    if (!(await pathExists(previousState)))
+        return;
+    await cp(previousState, join(snapshotRoot, "state"), {
+        recursive: true,
+        force: true,
+        filter: (source) => {
+            const item = toPosix(relative(previousState, source));
+            return item !== "back" && !item.startsWith("back/") && item !== "migration.json";
+        },
+    });
+}
+async function collectBackupEntries(root, current = root) {
+    if (!(await pathExists(current)))
+        return [];
+    const entries = [];
+    for (const entry of await readdir(current, { withFileTypes: true })) {
+        const path = join(current, entry.name);
+        if (entry.isDirectory()) {
+            entries.push(...await collectBackupEntries(root, path));
+            continue;
+        }
+        const itemPath = toPosix(relative(root, path));
+        if (entry.isSymbolicLink()) {
+            entries.push({ path: itemPath, type: "symlink", target: await readlink(path) });
+            continue;
+        }
+        if (!entry.isFile())
+            continue;
+        const content = await readFile(path);
+        entries.push({
+            path: itemPath,
+            type: "file",
+            bytes: content.byteLength,
+            sha256: createHash("sha256").update(content).digest("hex"),
+        });
+    }
+    return entries.sort((left, right) => left.path.localeCompare(right.path));
+}
+async function writeBackup(snapshotRoot, stagedRoot, source, target) {
+    const backupRoot = join(stagedRoot, BACKUP_RELATIVE);
+    await rm(backupRoot, { recursive: true, force: true });
+    await mkdir(backupRoot, { recursive: true });
+    const snapshotConfig = join(snapshotRoot, "config.json");
+    const snapshotState = join(snapshotRoot, "state");
+    if (await pathExists(snapshotConfig))
+        await cp(snapshotConfig, join(backupRoot, "config.json"), { force: true });
+    if (await pathExists(snapshotState))
+        await cp(snapshotState, join(backupRoot, "state"), { recursive: true, force: true });
+    const files = await collectBackupEntries(backupRoot);
+    await writeFile(join(backupRoot, "manifest.json"), JSON.stringify({
+        schema_version: 1,
+        source_version: source,
+        target_version: target,
+        created_at: new Date().toISOString(),
+        files,
+    }, null, 2) + "\n", "utf8");
+}
+async function inspectJsonTree(root) {
+    if (!(await pathExists(root)))
+        return [];
+    const blockers = [];
+    async function visit(current) {
+        for (const entry of await readdir(current, { withFileTypes: true })) {
+            const path = join(current, entry.name);
+            const label = toPosix(relative(dirname(root), path));
+            if (entry.isDirectory()) {
+                await visit(path);
+            }
+            else if (entry.isSymbolicLink()) {
+                blockers.push({ code: "state-symlink", path: label, message: "runtime state symlinks require manual migration review" });
+            }
+            else if (entry.isFile() && entry.name.endsWith(".json")) {
+                try {
+                    JSON.parse(await readFile(path, "utf8"));
+                }
+                catch (error) {
+                    blockers.push({ code: "invalid-json", path: label, message: String(error) });
+                }
+            }
+        }
+    }
+    await visit(root);
+    return blockers;
+}
+function expectArray(value) {
+    return Array.isArray(value);
+}
+async function inspectSpecdevState(stateRoot) {
+    const blockers = [];
+    const statusPath = join(stateRoot, "specdev", "status.json");
+    if (!(await pathExists(statusPath)))
+        return blockers;
+    let status;
+    try {
+        status = await readJson(statusPath);
+    }
+    catch {
+        return blockers;
+    }
+    if (status.schema_version !== 4 || status.workflow !== "specdev" || !expectArray(status.active) || !expectArray(status.archived)) {
+        blockers.push({ code: "unsupported-specdev-status", path: ".speculo/specdev/status.json", message: "automatic migration supports SpecDev global status schema v4 only" });
+        return blockers;
+    }
+    const activeNames = new Set();
+    for (const item of status.active) {
+        if (!item || typeof item !== "object" || typeof item.change !== "string") {
+            blockers.push({ code: "invalid-active-entry", path: ".speculo/specdev/status.json", message: "active entries must contain a change name" });
+            continue;
+        }
+        const name = item.change;
+        if (activeNames.has(name)) {
+            blockers.push({ code: "duplicate-active-change", path: ".speculo/specdev/status.json", message: `${name} appears more than once in active` });
+        }
+        activeNames.add(name);
+        const changeStatusPath = join(stateRoot, "specdev", "changes", name, ".status.json");
+        if (!(await pathExists(changeStatusPath))) {
+            blockers.push({ code: "missing-active-change", path: `.speculo/specdev/changes/${name}/.status.json`, message: "active status entry has no matching change state" });
+        }
+        else {
+            try {
+                const changeStatus = await readJson(changeStatusPath);
+                if (changeStatus.schema_version !== 3 ||
+                    changeStatus.artifact !== "change-status" ||
+                    changeStatus.change !== name ||
+                    !new Set(["active", "blocked", "completed"]).has(String(changeStatus.change_status))) {
+                    blockers.push({ code: "unsupported-change-status", path: `.speculo/specdev/changes/${name}/.status.json`, message: "active change state must use schema v3 and match its index entry" });
+                }
+            }
+            catch {
+                // The JSON tree check reports the parse failure with the precise path.
+            }
+        }
+    }
+    const archivedNames = new Set();
+    for (const item of status.archived) {
+        if (typeof item !== "string") {
+            blockers.push({ code: "invalid-archived-entry", path: ".speculo/specdev/status.json", message: "archived entries must be change names" });
+            continue;
+        }
+        if (archivedNames.has(item))
+            blockers.push({ code: "duplicate-archived-change", path: ".speculo/specdev/status.json", message: `${item} appears more than once in archived` });
+        archivedNames.add(item);
+        if (activeNames.has(item))
+            blockers.push({ code: "status-overlap", path: ".speculo/specdev/status.json", message: `${item} appears in both active and archived` });
+        const month = item.slice(0, 7);
+        const archivedStatusPath = join(stateRoot, "specdev", "archive", month, item, ".status.json");
+        if (!(await pathExists(archivedStatusPath))) {
+            blockers.push({ code: "missing-archived-change", path: `.speculo/specdev/archive/${month}/${item}/.status.json`, message: "archived status entry has no matching archived change state" });
+        }
+        else {
+            try {
+                const archivedStatus = await readJson(archivedStatusPath);
+                if (archivedStatus.schema_version !== 3 ||
+                    archivedStatus.artifact !== "change-status" ||
+                    archivedStatus.change !== item ||
+                    archivedStatus.change_status !== "archived") {
+                    blockers.push({ code: "unsupported-archived-status", path: `.speculo/specdev/archive/${month}/${item}/.status.json`, message: "archived change state must use schema v3 and match its index entry" });
+                }
+            }
+            catch {
+                // The JSON tree check reports the parse failure with the precise path.
+            }
+        }
+    }
+    const changesRoot = join(stateRoot, "specdev", "changes");
+    if (await pathExists(changesRoot)) {
+        for (const entry of await readdir(changesRoot, { withFileTypes: true })) {
+            if (!entry.isDirectory())
+                continue;
+            const changeStatusPath = join(changesRoot, entry.name, ".status.json");
+            if (!(await pathExists(changeStatusPath))) {
+                blockers.push({ code: "missing-change-status", path: `.speculo/specdev/changes/${entry.name}/.status.json`, message: "change directory has no status file" });
+            }
+            else if (!activeNames.has(entry.name)) {
+                blockers.push({ code: "unindexed-active-change", path: `.speculo/specdev/changes/${entry.name}`, message: "change directory is missing from the active index" });
+            }
+        }
+    }
+    const archiveRoot = join(stateRoot, "specdev", "archive");
+    if (await pathExists(archiveRoot)) {
+        for (const monthEntry of await readdir(archiveRoot, { withFileTypes: true })) {
+            if (!monthEntry.isDirectory())
+                continue;
+            const monthRoot = join(archiveRoot, monthEntry.name);
+            for (const changeEntry of await readdir(monthRoot, { withFileTypes: true })) {
+                if (!changeEntry.isDirectory())
+                    continue;
+                const archivedStatusPath = join(monthRoot, changeEntry.name, ".status.json");
+                if (!(await pathExists(archivedStatusPath))) {
+                    blockers.push({ code: "missing-archived-status", path: `.speculo/specdev/archive/${monthEntry.name}/${changeEntry.name}/.status.json`, message: "archived change directory has no status file" });
+                }
+                else if (!archivedNames.has(changeEntry.name)) {
+                    blockers.push({ code: "unindexed-archived-change", path: `.speculo/specdev/archive/${monthEntry.name}/${changeEntry.name}`, message: "archived change directory is missing from the archived index" });
+                }
+            }
+        }
+    }
+    const configPath = join(stateRoot, "specdev", "config.json");
+    if (await pathExists(configPath)) {
+        try {
+            const config = await readJson(configPath);
+            if (config.schema_version !== 3)
+                blockers.push({ code: "unsupported-specdev-config", path: ".speculo/specdev/config.json", message: "automatic migration supports SpecDev config schema v3 only" });
+        }
+        catch {
+            // The JSON tree check reports the parse failure with the precise path.
+        }
+    }
+    return blockers;
+}
+async function inspectCommandState(stateRoot) {
+    const commandsRoot = join(stateRoot, "commands");
+    if (!(await pathExists(commandsRoot)))
+        return [];
+    const blockers = [];
+    for (const entry of await readdir(commandsRoot, { withFileTypes: true })) {
+        if (!entry.isDirectory())
+            continue;
+        const statePath = join(commandsRoot, entry.name, "state.json");
+        if (!(await pathExists(statePath)))
+            continue;
+        if (entry.name !== "docs-sync") {
+            blockers.push({ code: "unknown-command-state", path: `.speculo/commands/${entry.name}/state.json`, message: "command state has no current migration contract" });
+            continue;
+        }
+        try {
+            const state = await readJson(statePath);
+            if (state.schema_version !== 4 || state.command !== "docs-sync") {
+                blockers.push({ code: "unsupported-command-state", path: ".speculo/commands/docs-sync/state.json", message: "automatic migration supports docs-sync state schema v4 only" });
+            }
+        }
+        catch {
+            // The JSON tree check reports the parse failure with the precise path.
+        }
+    }
+    return blockers;
+}
+async function inspectPersonState(stateRoot) {
+    const statusPath = join(stateRoot, "person", "status.json");
+    if (!(await pathExists(statusPath)))
+        return [];
+    try {
+        const status = await readJson(statusPath);
+        if (status.schema_version !== 1 || status.workflow !== "person" || !expectArray(status.active)) {
+            return [{ code: "unsupported-person-status", path: ".speculo/person/status.json", message: "automatic migration supports person status schema v1 only" }];
+        }
+    }
+    catch {
+        // The JSON tree check reports the parse failure with the precise path.
+    }
+    return [];
+}
+async function inspectSnapshot(snapshotRoot, source) {
+    const blockers = [];
+    const configPath = join(snapshotRoot, "config.json");
+    if (!(await pathExists(configPath))) {
+        blockers.push({ code: "missing-config", path: "config.json", message: "existing installation has no project configuration" });
+    }
+    else if ((await lstat(configPath)).isSymbolicLink()) {
+        blockers.push({ code: "state-symlink", path: "config.json", message: "project configuration symlinks require manual migration review" });
+    }
+    else {
+        try {
+            const config = await readJson(configPath);
+            if (config.schema_version !== 1)
+                blockers.push({ code: "unsupported-config", path: "config.json", message: "automatic migration supports project config schema v1 only" });
+        }
+        catch (error) {
+            blockers.push({ code: "invalid-json", path: "config.json", message: String(error) });
+        }
+    }
+    const stateRoot = join(snapshotRoot, "state");
+    const stateRootIsSymlink = await pathExists(stateRoot) && (await lstat(stateRoot)).isSymbolicLink();
+    if (stateRootIsSymlink) {
+        blockers.push({ code: "state-symlink", path: ".speculo", message: "runtime state root symlinks require manual migration review" });
+    }
+    const workspacePath = join(stateRoot, "workspace.json");
+    if (!stateRootIsSymlink && !(await pathExists(workspacePath))) {
+        blockers.push({ code: "missing-workspace", path: ".speculo/workspace.json", message: "existing installation has no workspace root manifest" });
+    }
+    else if (!stateRootIsSymlink) {
+        try {
+            const workspace = await readJson(workspacePath);
+            const roots = workspace.roots;
+            if (workspace.schema_version !== 1 || workspace.path_base !== "project-root" ||
+                !roots || typeof roots !== "object" ||
+                ["config", "speculo", "state", "commands", "skills", "workflows"].some((key) => typeof roots[key] !== "string")) {
+                blockers.push({ code: "unsupported-workspace", path: ".speculo/workspace.json", message: "automatic migration supports workspace schema v1 with project-root aliases only" });
+            }
+        }
+        catch {
+            // The JSON tree check reports the parse failure with the precise path.
+        }
+    }
+    if (source === null || versionBefore07(source)) {
+        blockers.push({ code: "unsupported-source-version", path: ".speculo/install.json", message: "automatic migration supports v0.7 and newer installations only" });
+    }
+    if (!stateRootIsSymlink) {
+        blockers.push(...await inspectJsonTree(stateRoot));
+        blockers.push(...await inspectSpecdevState(stateRoot));
+        blockers.push(...await inspectPersonState(stateRoot));
+        blockers.push(...await inspectCommandState(stateRoot));
+    }
+    return blockers;
+}
+function mergeDefaults(defaults, previous) {
+    if (defaults && typeof defaults === "object" && !Array.isArray(defaults) &&
+        previous && typeof previous === "object" && !Array.isArray(previous)) {
+        const merged = { ...defaults };
+        for (const [key, value] of Object.entries(previous)) {
+            merged[key] = key in merged ? mergeDefaults(merged[key], value) : value;
+        }
+        return merged;
+    }
+    return previous;
+}
+async function restoreCompatibleState(snapshotRoot, stagedRoot) {
+    const snapshotState = join(snapshotRoot, "state");
+    const stagedState = join(stagedRoot, ".speculo");
+    if (await pathExists(snapshotState)) {
+        for (const entry of await readdir(snapshotState, { withFileTypes: true })) {
+            if (MANAGED_STATE_ENTRIES.has(entry.name))
+                continue;
+            await cp(join(snapshotState, entry.name), join(stagedState, entry.name), {
+                recursive: entry.isDirectory(),
+                force: true,
+            });
+        }
+    }
+    const previousConfig = join(snapshotRoot, "config.json");
+    if (await pathExists(previousConfig)) {
+        const defaults = await readJson(join(stagedRoot, "config.json"));
+        const previous = await readJson(previousConfig);
+        await writeFile(join(stagedRoot, "config.json"), JSON.stringify(mergeDefaults(defaults, previous), null, 2) + "\n", "utf8");
+    }
+}
+async function restoreUnselectedState(snapshotRoot, stagedRoot, workflowIds) {
+    for (const workflowId of workflowIds) {
+        const source = join(snapshotRoot, "state", workflowId);
+        if (await pathExists(source))
+            await cp(source, join(stagedRoot, ".speculo", workflowId), { recursive: true, force: true });
+    }
+}
+async function writeInstallManifest(stagedRoot, targetVersion, workflowIds) {
+    await writeFile(join(stagedRoot, INSTALL_RELATIVE), JSON.stringify({
+        schema_version: 1,
+        package_version: targetVersion,
+        workflows: [...new Set(workflowIds)].sort(),
+    }, null, 2) + "\n", "utf8");
+}
+async function writePendingMarker(stagedRoot, source, target, blockers) {
+    await writeFile(join(stagedRoot, MIGRATION_RELATIVE), JSON.stringify({
+        schema_version: 1,
+        status: "pending",
+        source_version: source,
+        target_version: target,
+        backup_root: "speculo/.speculo/back",
+        created_at: new Date().toISOString(),
+        blockers,
+    }, null, 2) + "\n", "utf8");
+}
+export async function assertNoPendingMigration(previousRoot) {
+    const marker = join(previousRoot, MIGRATION_RELATIVE);
+    if (!(await pathExists(marker)))
+        return;
+    throw new Error("Speculo runtime migration is pending. Run the migrate-runtime-state command before speculo init.");
+}
+export async function migrateRuntimeState(options) {
+    const targetVersion = await readTargetVersion(options.packageRoot);
+    const snapshotRoot = join(options.stagedRoot, SNAPSHOT_DIR);
+    await copySnapshot(options.previousRoot, snapshotRoot);
+    const snapshotState = join(snapshotRoot, "state");
+    const snapshotStateIsSymlink = await pathExists(snapshotState) && (await lstat(snapshotState)).isSymbolicLink();
+    const versionResult = snapshotStateIsSymlink
+        ? { version: null, blockers: [] }
+        : await sourceVersion(snapshotState);
+    const blockers = [...versionResult.blockers, ...await inspectSnapshot(snapshotRoot, versionResult.version)];
+    await writeBackup(snapshotRoot, options.stagedRoot, versionResult.version, targetVersion);
+    if (blockers.length === 0) {
+        await restoreCompatibleState(snapshotRoot, options.stagedRoot);
+    }
+    else {
+        await restoreUnselectedState(snapshotRoot, options.stagedRoot, options.unselectedWorkflowIds);
+        await writePendingMarker(options.stagedRoot, versionResult.version, targetVersion, blockers);
+    }
+    await writeInstallManifest(options.stagedRoot, targetVersion, [...options.selectedWorkflowIds, ...options.unselectedWorkflowIds]);
+    await rm(snapshotRoot, { recursive: true, force: true });
+    return {
+        status: blockers.length === 0 ? "migrated" : "pending",
+        sourceVersion: versionResult.version,
+        targetVersion,
+        backupPath: "speculo/.speculo/back",
+        blockers,
+    };
+}
+export async function initializeRuntimeManifest(packageRoot, stagedRoot, workflowIds) {
+    const targetVersion = await readTargetVersion(packageRoot);
+    await writeInstallManifest(stagedRoot, targetVersion, workflowIds);
+    return {
+        status: "not-required",
+        sourceVersion: null,
+        targetVersion,
+        backupPath: null,
+        blockers: [],
+    };
+}
+//# sourceMappingURL=migrations.js.map

package/dist/src/migrations.js.map

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

package/package.json

@@ -1,7 +1,7 @@
 {
   "name": "@namewta/speculo",
-  "version": "0.7.0",
-  "description": "Workflow-packaged specification-driven development assets with direct refresh tooling.",
+  "version": "0.7.1",
+  "description": "Workflow-packaged specification-driven development assets with state-safe refresh tooling.",
   "type": "module",
   "bin": {
     "speculo": "./dist/src/cli.js"

package/template/.speculo/README.md

@@ -4,16 +4,21 @@
 
 ## 刷新契约
 
-重新运行 `speculo init` 会直接以当前模板刷新 Speculo 管理的配置与静态资产，不执行旧状态迁移或兼容。对本次选中的 workflow，刷新只保留 `changes/` 与 `archive/` 历史；workflow 配置、sidecar、未知运行文件与 command `state.json` 会被删除。Command Markdown 报告保留作审计记录，但不保证旧工件可被新 workflow 恢复。
+重新运行 `speculo init` 会以当前模板刷新 commands、skills 与选中的 workflow 静态资产，并对 v0.7+ 运行时执行兼容检查。兼容时递归合并项目配置的当前默认值，并完整保留 workflow 配置、状态索引、`changes/`、`archive/`、永久知识、sidecar、command 报告和具有当前合同的 command `state.json`。
+
+每次刷新先把旧 `config.json` 和旧 `.speculo/` 快照写入 `back/`，排除上一份 `back/` 与旧 pending marker，因此只保留最近一次刷新前备份。`install.json` 记录当前包版本和已安装 workflows；`back/manifest.json` 记录来源/目标版本及每个备份文件的 hash 和大小。
+
+若来源版本、核心 schema、JSON、符号链接、command state owner 或 workflow 索引无法证明兼容，刷新安装当前干净模板状态并创建 `migration.json`，其 `status` 为 `pending`。此时所有 workflow 读取和状态写入都必须停止；只能运行 `migrate-runtime-state` command，基于只读 `back/` 逐项对账、确认并原子迁移。再次运行 `speculo init` 会在任何修改前阻塞。
 
 ## 读取顺序
 
 1. 读取 `workspace.json`，以当前打开项目为 `project_root` 解析公共 roots。
-2. 从 `../workflows/<workflow>/INDEX.md` 进入 workflow，再通过 `<Path>` 指针进入具体 work 入口文件。
-3. 读取 `<workflow>/status.json`，再读取 `changes/<change>/.status.json` 和当前 work 产物。
-4. 历史 change 只从 `<workflow>/archive/YYYY-MM/<change>/` 读取。
-5. Command 报告位于 `commands/<command>/*.md`，command state 位于 `commands/<command>/state.json`。
-6. 首次 docs-sync 确认后读取 `<workflow>/docs-sync.json`；它分列该 workflow 的项目文档和私有 state 更新范围。
+2. 检查 `migration.json`；存在 pending 时停止，仅路由到 `migrate-runtime-state` command。
+3. 从 `../workflows/<workflow>/INDEX.md` 进入 workflow，再通过 `<Path>` 指针进入具体 work 入口文件。
+4. 读取 `<workflow>/status.json`，再读取 `changes/<change>/.status.json` 和当前 work 产物。
+5. 历史 change 只从 `<workflow>/archive/YYYY-MM/<change>/` 读取。
+6. Command 报告位于 `commands/<command>/*.md`，command state 位于 `commands/<command>/state.json`。
+7. 首次 docs-sync 确认后读取 `<workflow>/docs-sync.json`；它分列该 workflow 的项目文档和私有 state 更新范围。
 
 ## 写入边界
 
@@ -21,3 +26,5 @@
 - `docs-sync.json` 是 docs-sync command 拥有的延迟 sidecar，不进入 `_state`，也不授予越过 workflow 确认规则的权限。
 - `.config` 不是标准目录；只有 workflow 声明时才可使用。
 - Command 报告命名为 `<YYYY-MM-DD>-<scope>-<topic>[-NN].md`，禁止覆盖。
+- `back/` 由 `speculo init` 单一写入，迁移 command 只读；workflow 和其他 commands 不得修改。
+- `install.json` 与 `migration.json` 由 CLI/迁移脚本拥有，workflow 不得创建、修改或删除。

package/template/commands/migrate-runtime-state.md

@@ -0,0 +1,43 @@
+---
+id: migrate-runtime-state
+type: command
+name: Migrate Runtime State
+description: 盘点 pending Speculo 运行时备份，生成可确认迁移计划，并在明确授权后原子修复配置与持久状态。
+keywords: [runtime-migration, pending, back, 状态迁移, 配置修复]
+---
+
+# Migrate Runtime State 命令
+
+本命令只处理 `speculo init` 已标记为 pending 的运行时迁移。它不替代 `speculo init`，不迁移静态 commands、skills 或 workflow 包，也不修改 `<Path>{roots.state}/back/</Path>`。
+
+## 报告
+
+写入：`<Path>{roots.state}/commands/migrate-runtime-state/<YYYY-MM-DD>-workspace-runtime-state[-NN].md</Path>`。
+
+报告记录 command id、生成时间、project root、源/目标版本、pending blockers、备份 manifest hash 结论、逐路径动作、冲突决策、确认状态、执行结果、回滚结果和残余风险。同名报告从 `-01` 选择最小未占用编号，禁止覆盖。
+
+## 执行
+
+1. 从当前目录向上解析唯一 `speculo/.speculo/workspace.json`，读取 `speculo/.speculo/migration.json`、`speculo/.speculo/back/manifest.json`、`speculo/config.json` 和已安装 workflow INDEX。缺少 pending marker 或 marker 不为 `status: pending` 时停止，不创建可执行计划。
+2. 读取 `<Path>{roots.skills}/migrate-runtime-state/SKILL.md</Path>`，传入 project root、state root、backup root、pending marker、允许写入的 `speculo/config.json` 与 runtime state 边界，以及本 command 的报告路径。
+3. 先调用 skill 的 inspect/dry-run 分支，穷尽备份中的每个文件并生成 `restore | merge-json | replace-json | keep-current | remove-current | unresolved` 映射。任何 `unresolved` 都阻塞执行；可执行 plan 的 `source_decisions` 必须恰好覆盖 backup manifest，且锁定 manifest sha256。
+4. 把完整映射、覆盖/删除动作、验证命令和预期副作用写入报告并展示摘要。初始“修复迁移”请求不算执行确认。
+5. 只有用户明确批准当前计划后，把同一计划以 `confirmed` 模式交回 skill。执行前必须重验 marker、manifest hashes、每个 action 的 `expected_target` 和计划内容未漂移。
+6. skill 返回后重读 `speculo/config.json`、`<Path>{roots.state}/install.json</Path>`、pending marker、所有迁移目标和备份 manifest；运行已安装 workflow 的包级校验。pending marker 仍存在或任一验证失败时报告 blocked，不宣称完成。
+7. 将执行结果和 rollback 状态追加到原报告。成功时返回报告路径、保留的 backup 路径和已迁移 namespace；失败时返回原 active 安装是否恢复、未完成动作与恢复条件。
+
+## 确认边界
+
+- Dry-run 只允许创建本 command 的 Markdown 报告和进程外临时 plan；不得修改配置、workflow state、command state 或备份。
+- `replace-json`、`remove-current` 和任何覆盖动作必须在计划中逐项列出并取得确认。
+- 备份 hash 不一致、路径越界、目标漂移、未知 owner、JSON 无法修复或验证失败时停止。
+- `back/` 始终只读并保留为最近一次 rollback 来源；成功迁移不删除它。
+
+## 完成标准
+
+- pending marker、backup manifest 和全部文件均有结论；
+- 未确认路径除报告外无写入；
+- 已确认执行通过 staging、原子替换和失败回滚；
+- 配置与所有已安装 workflow 状态满足当前合同；
+- pending marker 已清除，最近备份仍完整；
+- 报告不覆盖且足以重建每个决策与动作。

package/template/skills/github-npm-ops/references/preflight-checklist.md

@@ -16,7 +16,7 @@
 | 7 | 包管理器 | `pnpm --version` (或 `npm` / `yarn`) | 版本 ≥ 仓库 lockfile 隐含版本 | 安装匹配版本；不要随意切换包管理器 |
 | 8 | release.yml 存在 | `test -f .github/workflows/release.yml` | 文件存在 | 转 `github-npm-ops` skill 的 `references/workflow-yaml-reference.md` 先落该文件 |
 | 9 | release.yml 形态 | 见 [publish-detection.md](publish-detection.md) | 输出 `PUBLISH_TO_NPM=true` 或 `false` | 见 publish-detection 文档的判定矩阵 |
-| 10 | docs-sync state | `test -f speculo/.speculo/commands/docs-sync/state.json && jq . speculo/.speculo/commands/docs-sync/state.json` | schema v4、scope 已确认，baseline 可解析 | 不存在/未确认 → 走 docs-sync command bootstrap；旧 schema 或损坏 → 重新运行 `speculo init` 刷新受管理状态后再确认范围 |
+| 10 | docs-sync state | `test -f speculo/.speculo/commands/docs-sync/state.json && jq . speculo/.speculo/commands/docs-sync/state.json` | schema v4、scope 已确认，baseline 可解析 | 不存在/未确认 → 走 docs-sync command bootstrap；旧 schema 或损坏 → 运行 `speculo init` 建立 pending 备份，再以 `migrate-runtime-state` command 修复后确认范围 |
 | 11 | tag 名称冲突 | `git rev-parse vX.Y.Z 2>/dev/null` | 退出码非 0（tag 不存在） | 同 tag 已存在：先确认是否真的失败需要重发；若是则 `git tag -d` + `git push origin :refs/tags/vX.Y.Z`，否则 bump 到下一版本 |
 
 ## 失败处理总策略