@peterxiaoyang/superspec 0.1.13 → 0.1.15-alpha

package/dist/src/packet_schema.d.ts

@@ -1,58 +0,0 @@
-export type PacketOutputFormat = "agent" | "prompt";
-export type PinnedRef = {
-    root: "repo" | "change";
-    path: string;
-    blob_sha: string;
-};
-export type FindingSelector = {
-    evidence_id: string;
-    finding_uid: string;
-    evidence_ref: PinnedRef;
-};
-export type DecisionSelector = {
-    evidence_id: string;
-    decision_scope_key: string;
-    evidence_ref: PinnedRef;
-};
-export type WorkflowPacket = {
-    stage: string;
-    current_gate: string;
-    task_id?: string;
-    status: "allowed" | "blocked";
-    top_blockers?: string[];
-    blocker_count?: number;
-    has_more_blockers?: boolean;
-    next_action: string;
-    next_command?: string;
-    openspec_cli_surfaces?: string[];
-    must_read_refs: PinnedRef[];
-    must_read_verbatim_findings?: FindingSelector[];
-    must_read_verbatim_decisions?: DecisionSelector[];
-    diagnostic_command?: string;
-    discovery_template?: string;
-    discovery_rules?: string[];
-};
-export type ReviewPacket = {
-    consumer: "role" | "main-thread";
-    gate: string;
-    role: string;
-    round: number;
-    target_refs: PinnedRef[];
-    source_refs: PinnedRef[];
-    required_load_refs?: PinnedRef[];
-    required_claim_ids?: string[];
-    must_read_verbatim_findings?: FindingSelector[];
-    must_read_verbatim_decisions?: DecisionSelector[];
-    required_output_kind: string;
-    output_contract_fields: string[];
-    required_review_scope?: string[];
-    stop_conditions: string[];
-};
-export type ApplyWorkerPacket = Record<string, any>;
-export type PacketDispatchResult = {
-    output_format: "agent";
-    payload: WorkflowPacket | ReviewPacket | ApplyWorkerPacket;
-} | {
-    output_format: "prompt";
-    payload: string;
-};

package/dist/src/packet_schema.js

@@ -1 +0,0 @@
-export {};

package/dist/src/paths.d.ts

@@ -1,22 +0,0 @@
-import type { JsonMap, Reason } from "./util.ts";
-export declare function superspec_dir(changeRoot: string): string;
-export declare function project_superspec_dir(repoRoot: string): string;
-export declare function sidecar_artifacts_dir(changeRoot: string): string;
-export declare function sidecar_test_contract_path(changeRoot: string): string;
-export declare function sidecar_business_invariants_path(changeRoot: string): string;
-export declare function sidecar_discovery_path(changeRoot: string): string;
-export declare function sidecar_output_path(changeRoot: string, relPath: string): string;
-export declare function write_sidecar_text(changeRoot: string, relPath: string, text: string): string;
-export declare function write_sidecar_json(changeRoot: string, relPath: string, data: JsonMap): string;
-export declare function config_file(changeRoot: string): string;
-export declare function project_config_file(repoRoot: string): string;
-export declare function required_sidecar_paths(changeRoot: string): string[];
-export declare function ensure_sidecar_layout(changeRoot: string): void;
-export declare function ensure_state_layout(changeRoot: string): void;
-export declare function find_forbidden_aliases(repoRoot: string, changeRoot: string): string[];
-export declare function read_skill_frontmatter_name(skillPath: string): string | null;
-export declare function read_agent_toml_name(agentPath: string): string | null;
-export declare function parse_simple_yaml(filePath: string): JsonMap;
-export declare function merge_config(base: JsonMap, override: JsonMap): JsonMap;
-export declare function validate_config_keys(config: JsonMap, source: string): Reason[];
-export declare function load_config(repoRoot: string, changeRoot: string): [JsonMap, Reason[]];

package/dist/src/paths.js

@@ -1,203 +0,0 @@
-import { existsSync, mkdirSync, readFileSync, statSync, writeFileSync } from "node:fs";
-import { dirname, join } from "node:path";
-import { ALLOWED_CONFIG_KEYS, BUILTIN_CONFIG, CHANGE_CONFIG_ALIASES, CONFIG_FILENAME, GuardError, PROJECT_CONFIG_ALIASES, REQUIRED_SIDECAR_DIRS, STATE_ALIASES, isObject, reason, repr, safe_within, } from "./util.js";
-export function superspec_dir(changeRoot) {
-    return join(changeRoot, ".superspec");
-}
-export function project_superspec_dir(repoRoot) {
-    return join(repoRoot, ".superspec");
-}
-export function sidecar_artifacts_dir(changeRoot) {
-    return join(superspec_dir(changeRoot), "artifacts");
-}
-export function sidecar_test_contract_path(changeRoot) {
-    return join(sidecar_artifacts_dir(changeRoot), "test-contract.md");
-}
-export function sidecar_business_invariants_path(changeRoot) {
-    return join(sidecar_artifacts_dir(changeRoot), "business-invariants.md");
-}
-export function sidecar_discovery_path(changeRoot) {
-    return join(sidecar_artifacts_dir(changeRoot), "discovery.md");
-}
-export function sidecar_output_path(changeRoot, relPath) {
-    const target = safe_within(superspec_dir(changeRoot), relPath);
-    if (target === null)
-        throw new GuardError(`sidecar_path_invalid: ${relPath}`);
-    return target;
-}
-export function write_sidecar_text(changeRoot, relPath, text) {
-    const filePath = sidecar_output_path(changeRoot, relPath);
-    mkdirSync(dirname(filePath), { recursive: true });
-    writeFileSync(filePath, text, "utf8");
-    return filePath;
-}
-export function write_sidecar_json(changeRoot, relPath, data) {
-    return write_sidecar_text(changeRoot, relPath, `${JSON.stringify(data, null, 2)}\n`);
-}
-export function config_file(changeRoot) {
-    return join(superspec_dir(changeRoot), CONFIG_FILENAME);
-}
-export function project_config_file(repoRoot) {
-    return join(project_superspec_dir(repoRoot), CONFIG_FILENAME);
-}
-export function required_sidecar_paths(changeRoot) {
-    return REQUIRED_SIDECAR_DIRS.map((relPath) => join(superspec_dir(changeRoot), relPath));
-}
-export function ensure_sidecar_layout(changeRoot) {
-    ensure_state_layout(changeRoot);
-    for (const dirPath of required_sidecar_paths(changeRoot))
-        mkdirSync(dirPath, { recursive: true });
-}
-export function ensure_state_layout(changeRoot) {
-    const base = superspec_dir(changeRoot);
-    mkdirSync(base, { recursive: true });
-    const ledger = join(base, "ledger.jsonl");
-    if (!existsSync(ledger))
-        writeFileSync(ledger, "");
-}
-export function find_forbidden_aliases(repoRoot, changeRoot) {
-    const aliases = [];
-    for (const relPath of PROJECT_CONFIG_ALIASES) {
-        const candidate = join(repoRoot, relPath);
-        if (existsSync(candidate))
-            aliases.push(candidate);
-    }
-    for (const relPath of CHANGE_CONFIG_ALIASES) {
-        const candidate = join(changeRoot, relPath);
-        if (existsSync(candidate))
-            aliases.push(candidate);
-    }
-    for (const relPath of STATE_ALIASES) {
-        const candidate = join(changeRoot, relPath);
-        if (existsSync(candidate))
-            aliases.push(candidate);
-    }
-    return aliases;
-}
-export function read_skill_frontmatter_name(skillPath) {
-    let lines;
-    try {
-        lines = readFileSync(skillPath, "utf8").split(/\r?\n/);
-    }
-    catch {
-        return null;
-    }
-    if (lines.length === 0 || lines[0].trim() !== "---")
-        return null;
-    for (const raw of lines.slice(1)) {
-        const stripped = raw.trim();
-        if (stripped === "---")
-            return null;
-        if (stripped.startsWith("name:"))
-            return stripped.split(":", 2)[1].trim().replace(/^['"]|['"]$/g, "");
-    }
-    return null;
-}
-export function read_agent_toml_name(agentPath) {
-    let lines;
-    try {
-        lines = readFileSync(agentPath, "utf8").split(/\r?\n/);
-    }
-    catch {
-        return null;
-    }
-    for (const raw of lines) {
-        const match = raw.match(/^\s*name\s*=\s*["']([^"']+)["']\s*$/);
-        if (match)
-            return match[1];
-    }
-    return null;
-}
-function parseScalar(raw) {
-    const value = raw.trim();
-    if (!value)
-        return "";
-    if (value === "true")
-        return true;
-    if (value === "false")
-        return false;
-    if (value === "null" || value === "None")
-        return null;
-    if ((value.startsWith('"') && value.endsWith('"')) || (value.startsWith("'") && value.endsWith("'")))
-        return value.slice(1, -1);
-    if (/^-?\d+$/.test(value))
-        return Number.parseInt(value, 10);
-    return value;
-}
-export function parse_simple_yaml(filePath) {
-    const data = {};
-    let currentKey = null;
-    const lines = readFileSync(filePath, "utf8").split(/\r?\n/);
-    lines.forEach((raw, idx) => {
-        const stripped = raw.trim();
-        if (!stripped || stripped.startsWith("#"))
-            return;
-        const indent = raw.length - raw.trimStart().length;
-        if (!stripped.includes(":"))
-            throw new GuardError(`config_parse_error: ${filePath}:${idx + 1}: expected key: value`);
-        const [keyRaw, ...rest] = stripped.split(":");
-        const key = keyRaw.trim();
-        const value = rest.join(":");
-        if (!key)
-            throw new GuardError(`config_parse_error: ${filePath}:${idx + 1}: empty key`);
-        if (indent === 0) {
-            if (value.trim()) {
-                data[key] = parseScalar(value);
-                currentKey = null;
-            }
-            else {
-                data[key] = {};
-                currentKey = key;
-            }
-        }
-        else if (indent === 2 && currentKey) {
-            const parent = data[currentKey];
-            if (!isObject(parent))
-                throw new GuardError(`config_parse_error: ${filePath}:${idx + 1}: parent is not mapping`);
-            parent[key] = parseScalar(value);
-        }
-        else {
-            throw new GuardError(`config_parse_error: ${filePath}:${idx + 1}: unsupported indentation`);
-        }
-    });
-    return data;
-}
-export function merge_config(base, override) {
-    const merged = JSON.parse(JSON.stringify(base));
-    for (const [key, value] of Object.entries(override)) {
-        if (isObject(value) && isObject(merged[key]))
-            merged[key] = { ...merged[key], ...value };
-        else
-            merged[key] = value;
-    }
-    return merged;
-}
-export function validate_config_keys(config, source) {
-    const problems = [];
-    for (const key of Object.keys(config)) {
-        if (ALLOWED_CONFIG_KEYS.has(key) || key.startsWith("x-"))
-            continue;
-        problems.push(reason("unknown_config_key", `${source}: unknown config key ${repr(key)}`));
-    }
-    return problems;
-}
-export function load_config(repoRoot, changeRoot) {
-    const problems = [];
-    for (const aliasPath of find_forbidden_aliases(repoRoot, changeRoot)) {
-        problems.push(reason("forbidden_alias_path", `forbidden superspec alias exists: ${aliasPath}`));
-    }
-    let config = JSON.parse(JSON.stringify(BUILTIN_CONFIG));
-    const projectCfg = project_config_file(repoRoot);
-    if (existsSync(projectCfg) && statSync(projectCfg).isFile()) {
-        const parsed = parse_simple_yaml(projectCfg);
-        problems.push(...validate_config_keys(parsed, projectCfg));
-        config = merge_config(config, parsed);
-    }
-    const changeCfg = config_file(changeRoot);
-    if (existsSync(changeCfg) && statSync(changeCfg).isFile()) {
-        const parsed = parse_simple_yaml(changeCfg);
-        problems.push(...validate_config_keys(parsed, changeCfg));
-        config = merge_config(config, parsed);
-    }
-    return [config, problems];
-}

package/dist/src/project_init.d.ts

@@ -1,31 +0,0 @@
-import { type JsonMap, type OpenspecCliProbe } from "./core.ts";
-export declare const OPENSPEC_NPM_PACKAGE = "@fission-ai/openspec";
-export declare const OPENSPEC_INSTALL_DOC_URL = "https://github.com/Fission-AI/OpenSpec#readme";
-export type OpenspecInstallPlan = {
-    manager: "npm" | "pnpm" | "yarn" | "bun";
-    cmd: string;
-    args: string[];
-    rendered: string;
-};
-export declare function recommended_openspec_install_plan(opts?: {
-    cwd?: string;
-    commandExistsFn?: (cmd: string, meta?: {
-        cwd?: string;
-    }) => boolean;
-}): OpenspecInstallPlan | null;
-export declare function forced_openspec_install_plan(plan: OpenspecInstallPlan): OpenspecInstallPlan;
-export declare function missing_openspec_cli_message(opts?: {
-    cwd?: string;
-    commandExistsFn?: (cmd: string, meta?: {
-        cwd?: string;
-    }) => boolean;
-}): string;
-export declare function openspec_cli_requirement_message(probe: OpenspecCliProbe, opts?: {
-    cwd?: string;
-    commandExistsFn?: (cmd: string, meta?: {
-        cwd?: string;
-    }) => boolean;
-}): string;
-export declare function project_init(repoRootRaw?: string, opts?: {
-    force?: boolean;
-}): JsonMap;

package/dist/src/project_init.js

@@ -1,167 +0,0 @@
-import { existsSync, mkdirSync, readFileSync, statSync, writeFileSync } from "node:fs";
-import { join, resolve } from "node:path";
-import { REQUIRED_SUPERSPEC_AGENT_ROLES, REQUIRED_OPENSPEC_MIN_VERSION, block, commandExists, openspec_cli_probe, reason, read_agent_toml_name, } from "./core.js";
-import { install_workflow } from "./install_engine.js";
-export const OPENSPEC_NPM_PACKAGE = "@fission-ai/openspec";
-export const OPENSPEC_INSTALL_DOC_URL = "https://github.com/Fission-AI/OpenSpec#readme";
-const ROLE_DESCRIPTIONS = {
-    architect: "系统设计、边界、接口与长期取舍",
-    critic: "严格审查计划、证据、假设与范围漂移",
-    "test-engineer": "测试策略、覆盖率与 RED/GREEN 证据审查",
-    "code-reviewer": "代码 / 规格 / 安全审查",
-    verifier: "最终完成证据与验证审查",
-};
-function renderCommand(cmd, args) {
-    return [cmd, ...args].join(" ");
-}
-export function recommended_openspec_install_plan(opts = {}) {
-    const commandExistsFn = opts.commandExistsFn ?? ((cmd, meta) => commandExists(cmd, { cwd: meta?.cwd }));
-    const versionedPackage = `${OPENSPEC_NPM_PACKAGE}@latest`;
-    const candidates = [
-        { manager: "npm", cmd: "npm", args: ["install", "-g", versionedPackage] },
-        { manager: "pnpm", cmd: "pnpm", args: ["add", "-g", versionedPackage] },
-        { manager: "yarn", cmd: "yarn", args: ["global", "add", versionedPackage] },
-        { manager: "bun", cmd: "bun", args: ["add", "-g", versionedPackage] },
-    ];
-    for (const candidate of candidates) {
-        if (!commandExistsFn(candidate.cmd, { cwd: opts.cwd }))
-            continue;
-        return { ...candidate, rendered: renderCommand(candidate.cmd, candidate.args) };
-    }
-    return null;
-}
-export function forced_openspec_install_plan(plan) {
-    const versionedPackage = `${OPENSPEC_NPM_PACKAGE}@latest`;
-    const forced = {
-        npm: ["install", "-g", "--force", versionedPackage],
-        pnpm: ["add", "-g", "--force", versionedPackage],
-        yarn: ["global", "add", versionedPackage, "--force"],
-        bun: ["add", "-g", "--force", versionedPackage],
-    };
-    return { ...plan, args: forced[plan.manager], rendered: renderCommand(plan.cmd, forced[plan.manager]) };
-}
-export function missing_openspec_cli_message(opts = {}) {
-    return openspec_cli_requirement_message({
-        ok: false,
-        state: "missing",
-        version: null,
-        message: "PATH 中缺少 OpenSpec CLI（openspec）",
-    }, opts);
-}
-export function openspec_cli_requirement_message(probe, opts = {}) {
-    const plan = recommended_openspec_install_plan(opts);
-    if (plan) {
-        return `${probe.message}。需要 @fission-ai/openspec >= ${REQUIRED_OPENSPEC_MIN_VERSION}。可先运行 \`${plan.rendered}\` 安装或升级，然后重新运行 \`superspec init --scope project\`。`;
-    }
-    return `${probe.message}。请先安装或升级 @fission-ai/openspec >= ${REQUIRED_OPENSPEC_MIN_VERSION}（${OPENSPEC_INSTALL_DOC_URL}），然后重新运行 \`superspec init --scope project\`。`;
-}
-function writeSuperSpecAgent(repoRoot, name) {
-    const filePath = join(repoRoot, ".codex", "agents", `${name}.toml`);
-    mkdirSync(join(repoRoot, ".codex", "agents"), { recursive: true });
-    writeFileSync(filePath, [
-        `name = "${name}"`,
-        `description = "${ROLE_DESCRIPTIONS[name] ?? `superspec ${name} role`}"`,
-        'model_reasoning_effort = "high"',
-        'developer_instructions = """',
-        `你是仓库本地的 superspec ${name} native subagent。`,
-        "遵循分配给你的 superspec gate 证据任务，引用具体文件，并把未通过的问题上报主流程。",
-        "不要用主流程自审替代必须的角色证据。",
-        '"""',
-        "",
-    ].join("\n"), "utf8");
-    return filePath;
-}
-function writeSuperSpecPrompt(repoRoot, name) {
-    const filePath = join(repoRoot, ".codex", "prompts", `${name}.md`);
-    mkdirSync(join(repoRoot, ".codex", "prompts"), { recursive: true });
-    writeFileSync(filePath, [
-        "---",
-        `description: "${ROLE_DESCRIPTIONS[name] ?? `superspec ${name} role`}"`,
-        'argument-hint: "superspec gate evidence task"',
-        "---",
-        "",
-        `你是仓库本地的 superspec ${name} 角色。`,
-        "",
-        "请基于具体文件证据审查提供的 superspec gate 上下文，输出简洁的通过 / 未通过报告，引用 source anchors 与 target refs，并且不要用主流程自审替代必须的 native-subagent 证据。",
-        "",
-    ].join("\n"), "utf8");
-    return filePath;
-}
-function ensureOpenSpecCliSurface(repoRoot, actions) {
-    const probe = openspec_cli_probe({ cwd: repoRoot });
-    actions.push({
-        action: "openspec_cli_surface",
-        status: probe.ok ? "ok" : "failed",
-        detail: probe.message,
-    });
-    return probe.ok ? [] : [openspec_cli_requirement_message(probe, { cwd: repoRoot })];
-}
-function ensureSuperSpecRoles(repoRoot, actions) {
-    const problems = [];
-    const created = [];
-    for (const name of REQUIRED_SUPERSPEC_AGENT_ROLES) {
-        const agentPath = join(repoRoot, ".codex", "agents", `${name}.toml`);
-        if (!existsSync(agentPath) || !statSync(agentPath).isFile()) {
-            created.push(writeSuperSpecAgent(repoRoot, name));
-        }
-        else if (read_agent_toml_name(agentPath) !== name) {
-            problems.push(`agent 文件无效：${agentPath}`);
-        }
-        const promptPath = join(repoRoot, ".codex", "prompts", `${name}.md`);
-        if (!existsSync(promptPath) || !statSync(promptPath).isFile()) {
-            created.push(writeSuperSpecPrompt(repoRoot, name));
-        }
-        else if (!readFileSync(promptPath, "utf8").trim()) {
-            problems.push(`prompt 文件为空：${promptPath}`);
-        }
-    }
-    actions.push({
-        action: "superspec_repo_local_roles",
-        status: problems.length > 0 ? "failed" : created.length > 0 ? "created" : "ok",
-        refs: created.length > 0 ? created : undefined,
-    });
-    return problems;
-}
-// D4 (audit G-1): SuperSpec's own surfaces are installed manifest-driven from the install map;
-// it runs before the role fallback generator so canonical templates win on fresh installs.
-function ensureSuperSpecWorkflow(repoRoot, actions, force) {
-    const result = install_workflow(repoRoot, { force, scope: "project" });
-    for (const item of result.actions) {
-        actions.push({
-            action: item.action,
-            status: item.status === "removed" || item.status === "would_remove" ? "updated" : item.status,
-            refs: item.refs,
-            detail: item.detail,
-        });
-    }
-    return result.problems;
-}
-export function project_init(repoRootRaw = process.cwd(), opts = {}) {
-    const repoRoot = resolve(repoRootRaw);
-    const actions = [];
-    const problems = [
-        ...ensureOpenSpecCliSurface(repoRoot, actions),
-        ...ensureSuperSpecWorkflow(repoRoot, actions, opts.force === true),
-        ...ensureSuperSpecRoles(repoRoot, actions),
-    ];
-    if (problems.length > 0) {
-        const decision = block("project", "project_init", problems.map((item) => reason("project_init_failed", item)));
-        return {
-            ...decision,
-            project_root: repoRoot,
-            actions,
-            next_allowed_actions: ["fix project_init_failed reasons, then rerun superspec init --scope project"],
-        };
-    }
-    return {
-        allowed: true,
-        decision: "allow",
-        change_id: null,
-        gate: "project_init",
-        project_root: repoRoot,
-        actions,
-        block_reasons: [],
-        next_allowed_actions: ["create/select a change during superspec-explore, then run change-scoped guard checks"],
-        trust_warnings: ["project init installs project surfaces only; change sidecars are created lazily by later superspec phases"],
-    };
-}

package/dist/src/self_update.d.ts

@@ -1,14 +0,0 @@
-import { runCommand } from "./util.ts";
-type RunFn = typeof runCommand;
-type CommandExistsFn = (cmd: string, meta?: {
-    cwd?: string;
-}) => boolean;
-export declare function update_self_then_rerun(opts: {
-    args: string[];
-    cwd?: string;
-    run?: RunFn;
-    commandExistsFn?: CommandExistsFn;
-    writeStdout?: (text: string) => void;
-    writeStderr?: (text: string) => void;
-}): number;
-export {};

package/dist/src/self_update.js

@@ -1,56 +0,0 @@
-import { commandExists, runCommand } from "./util.js";
-const SUPERSPEC_NPM_PACKAGE = "@peterxiaoyang/superspec";
-function renderCommand(cmd, args) {
-    return [cmd, ...args].join(" ");
-}
-function commandFailure(proc) {
-    const output = (proc.error?.message ?? (proc.stderr || proc.stdout)).trim();
-    if (output)
-        return output;
-    return proc.status === null ? "command failed" : `command exited with status ${proc.status}`;
-}
-function shouldRetrySuperSpecInstallWithForce(proc) {
-    const output = `${proc.error?.message ?? ""}\n${proc.stderr}\n${proc.stdout}`;
-    const binConflict = /\bEEXIST\b|already exists|file exists|Refusing to delete|will not overwrite|would overwrite/iu.test(output);
-    const superspecBin = /\bsuperspec(?:\.(?:cmd|ps1))?\b/iu.test(output);
-    return binConflict && superspecBin;
-}
-export function update_self_then_rerun(opts) {
-    const cwd = opts.cwd ?? process.cwd();
-    const run = opts.run ?? runCommand;
-    const commandExistsFn = opts.commandExistsFn ?? ((cmd, meta) => commandExists(cmd, { cwd: meta?.cwd }));
-    const writeStdout = opts.writeStdout ?? ((text) => process.stdout.write(text));
-    const writeStderr = opts.writeStderr ?? ((text) => process.stderr.write(text));
-    if (!commandExistsFn("npm", { cwd })) {
-        writeStderr("SuperSpec update requires npm on PATH to install @peterxiaoyang/superspec@latest. Use `superspec update --local-only` to update surfaces from the currently installed package.\n");
-        return 1;
-    }
-    const installArgs = ["install", "-g", `${SUPERSPEC_NPM_PACKAGE}@latest`];
-    writeStderr(`Updating SuperSpec CLI: ${renderCommand("npm", installArgs)}\n`);
-    let install = run("npm", installArgs, { cwd, timeout: 300_000 });
-    if ((install.error || install.status !== 0) && shouldRetrySuperSpecInstallWithForce(install)) {
-        const forcedArgs = ["install", "-g", "--force", `${SUPERSPEC_NPM_PACKAGE}@latest`];
-        writeStderr(`SuperSpec CLI install hit a global bin conflict; retrying with: ${renderCommand("npm", forcedArgs)}\n`);
-        install = run("npm", forcedArgs, { cwd, timeout: 300_000 });
-    }
-    if (install.error || install.status !== 0) {
-        writeStderr(`SuperSpec CLI update failed: ${commandFailure(install)}\n`);
-        return 1;
-    }
-    if (!commandExistsFn("superspec", { cwd })) {
-        writeStderr("SuperSpec CLI update completed, but `superspec` is not resolvable from PATH. Reopen the shell or check npm global bin configuration.\n");
-        return 1;
-    }
-    const rerunArgs = ["update", ...opts.args, "--skip-self-update"];
-    const rerun = run("superspec", rerunArgs, { cwd, timeout: 300_000 });
-    if (rerun.stdout)
-        writeStdout(rerun.stdout);
-    if (rerun.stderr)
-        writeStderr(rerun.stderr);
-    if (rerun.error || rerun.status !== 0) {
-        if (rerun.error && !rerun.stderr)
-            writeStderr(`SuperSpec update rerun failed: ${rerun.error.message}\n`);
-        return rerun.status ?? 1;
-    }
-    return 0;
-}

package/dist/src/state.d.ts

@@ -1,37 +0,0 @@
-import type { JsonMap, Reason } from "./util.ts";
-export declare function state_file(changeRoot: string): string;
-export declare function ledger_file(changeRoot: string): string;
-export declare function load_state(changeRoot: string): JsonMap | null;
-export declare function state_file_corrupt(changeRoot: string): boolean;
-export declare function state_corrupt_reasons(changeRoot: string): Reason[];
-export declare function read_ledger_text(changeRoot: string): string;
-export declare function compute_fingerprints(changeRoot: string, status: JsonMap): JsonMap;
-export declare function state_stale_reasons(changeRoot: string, status: JsonMap): Reason[];
-export declare function materialize_ledger_event(event: JsonMap): JsonMap;
-export declare function ledger_event_line(event: JsonMap): string;
-export declare function with_state_lock<T>(changeRoot: string, fn: () => T): T;
-export declare function force_unlock_state(changeRoot: string): boolean;
-export declare function prepare_recomputed_state_write(change: string, changeRoot: string, status: JsonMap, guardRoutePhase: string, activeGate: string, decision: JsonMap, opts?: {
-    config?: JsonMap | null;
-    preset_upgrade_required?: boolean;
-    fingerprints?: JsonMap | null;
-}): JsonMap;
-export declare function write_prepared_state_locked(changeRoot: string, prepared: JsonMap): void;
-export declare function restore_state_snapshot_locked(changeRoot: string, snapshot: {
-    state_text: string | null;
-    ledger_text: string;
-}): void;
-export declare function write_state_atomic(changeRoot: string, state: JsonMap, opts?: {
-    expected_state_fingerprints?: JsonMap | null;
-    ledger_event?: JsonMap | null;
-}): void;
-export declare function append_ledger(changeRoot: string, event: JsonMap): void;
-export declare function record_supersede_ledger_events(change: string, changeRoot: string, evidences: JsonMap[]): void;
-export declare function recompute_and_write_state_locked(change: string, changeRoot: string, status: JsonMap, guardRoutePhase: string, activeGate: string, decision: JsonMap, opts?: {
-    config?: JsonMap | null;
-    preset_upgrade_required?: boolean;
-}): JsonMap;
-export declare function recompute_and_write_state(change: string, changeRoot: string, status: JsonMap, guardRoutePhase: string, activeGate: string, decision: JsonMap, opts?: {
-    config?: JsonMap | null;
-    preset_upgrade_required?: boolean;
-}): JsonMap;