@wemuda/launchrail 1.0.0

package/dist/commands/add.js

@@ -0,0 +1,189 @@
+import { readFileSync, writeFileSync } from "node:fs";
+import { join } from "node:path";
+import * as p from "@clack/prompts";
+import { BROWSER_TESTING_MODULE, browserTestingFiles } from "../lib/browser-testing.js";
+import { detectRepo } from "../lib/detect.js";
+import { emptyLockfile, readLockfile, writeLockfile } from "../lib/lockfile.js";
+import { MANIFEST_FILENAME, parseManifest, setModuleEnabled } from "../lib/manifest.js";
+import { RALPH_MODULE, RALPH_WORKFLOW_PATH, ralphFiles } from "../lib/ralph.js";
+import { claudeGeneratedFile } from "../lib/seeds.js";
+import { ACTION_LABEL, applyPlan, planWrites } from "../lib/writer.js";
+import { VERSION } from "../version.js";
+export const AVAILABLE_MODULES = [BROWSER_TESTING_MODULE, RALPH_MODULE];
+function defaultAnswers(manifest, detection) {
+    const pm = detection.packageManager ?? "npm";
+    return {
+        appUrl: manifest.testing.appUrl ?? "http://localhost:3000",
+        devCommand: manifest.testing.devCommand ?? (detection.devScript ? `${pm} run dev` : null),
+        e2eCommand: manifest.testing.e2eCommand ?? "npx playwright test",
+        smokeCommand: manifest.testing.smokeCommand ?? "node scripts/smoke.mjs",
+    };
+}
+async function interview(defaults) {
+    p.intro("launchrail add browser-testing");
+    const answers = await p.group({
+        appUrl: () => p.text({
+            message: "App URL browser tests run against",
+            initialValue: defaults.appUrl,
+        }),
+        devCommand: () => p.text({
+            message: "Command that starts the app (empty to fill in later)",
+            initialValue: defaults.devCommand ?? "",
+            placeholder: "e.g. pnpm dev",
+        }),
+        e2eCommand: () => p.text({
+            message: "Deterministic browser-test command",
+            initialValue: defaults.e2eCommand,
+        }),
+        smokeCommand: () => p.text({
+            message: "Smoke entry command",
+            initialValue: defaults.smokeCommand,
+        }),
+    }, {
+        onCancel: () => {
+            p.cancel("Cancelled — nothing was written.");
+            process.exit(130);
+        },
+    });
+    return {
+        appUrl: answers.appUrl.trim() || defaults.appUrl,
+        devCommand: answers.devCommand.trim() === "" ? null : answers.devCommand.trim(),
+        e2eCommand: answers.e2eCommand.trim() || defaults.e2eCommand,
+        smokeCommand: answers.smokeCommand.trim() || defaults.smokeCommand,
+    };
+}
+function planBrowserTesting(parsed, detection, answers) {
+    const manifest = {
+        ...parsed,
+        testing: { ...parsed.testing, ...answers },
+        modules: { ...parsed.modules, [BROWSER_TESTING_MODULE]: true },
+    };
+    const notes = [];
+    if (detection.playwrightConfigFile) {
+        notes.push(`Existing ${detection.playwrightConfigFile} detected — keeping it; no config or baseline spec seeded.`);
+    }
+    const nextSteps = ["Run `node scripts/setup.mjs` — installs @playwright/test and browser binaries."];
+    if (!answers.devCommand) {
+        nextSteps.push("Set the dev command: edit scripts/dev.mjs (DEV_COMMAND) and testing.devCommand in .launchrail.yml.");
+    }
+    nextSteps.push("Review the seeded files — they are yours: playwright config, tests/e2e/, docs/testing/smoke-journeys.md.", "Verify: `node scripts/verify.mjs`, then `npx @wemuda/launchrail smoke` with the app running.");
+    return {
+        manifest,
+        testing: { ...answers },
+        specs: browserTestingFiles({ manifest, detection }),
+        decisions: { ...answers },
+        notes,
+        nextSteps,
+    };
+}
+function planRalph(parsed) {
+    const manifest = {
+        ...parsed,
+        modules: { ...parsed.modules, [RALPH_MODULE]: true },
+    };
+    const notes = [];
+    if (parsed.issueTracker === "none") {
+        notes.push("Warning: .launchrail.yml has issueTracker: none — Ralph runs off tracker tickets and will refuse to start until one is configured.");
+    }
+    if (!parsed.testing.unitCommand && !parsed.testing.e2eCommand) {
+        notes.push("Warning: no testing commands configured — `launchrail verify` fails on an empty contract, and Ralph refuses to start on a red gate.");
+    }
+    return {
+        manifest,
+        testing: {},
+        specs: ralphFiles(),
+        decisions: {},
+        notes,
+        nextSteps: [
+            "Create the tracker labels Ralph uses: ready-for-agent, ralph:building, needs-info.",
+            "Produce tickets with explicit `Blocked by: #n` edges and the ready-for-agent label (Matt Pocock's to-tickets, stage 8 of the workflow).",
+            "Run a campaign: the launchrail:ralph skill (watchable) or the `ralph` workflow (wide or long runs; scope with args, e.g. { width: 1 }).",
+            "Start with width 1 until a few tickets have landed cleanly, then widen.",
+        ],
+    };
+}
+export async function runAdd(opts) {
+    if (!AVAILABLE_MODULES.includes(opts.module)) {
+        console.error(`launchrail: unknown module "${opts.module}". Available modules: ${AVAILABLE_MODULES.join(", ")}`);
+        return { code: 1, actions: [] };
+    }
+    const detection = detectRepo(opts.cwd);
+    if (!detection.hasManifest) {
+        console.error(`launchrail: ${MANIFEST_FILENAME} not found — run \`launchrail init\` first.`);
+        return { code: 1, actions: [] };
+    }
+    const manifestSource = readFileSync(join(opts.cwd, MANIFEST_FILENAME), "utf8");
+    const parsed = parseManifest(manifestSource);
+    if (!parsed.manifest) {
+        console.error(`launchrail: ${MANIFEST_FILENAME} is invalid:`);
+        for (const error of parsed.errors)
+            console.error(`  - ${error}`);
+        return { code: 1, actions: [] };
+    }
+    let plan;
+    if (opts.module === BROWSER_TESTING_MODULE) {
+        const interactive = !opts.yes && process.stdin.isTTY === true && process.stdout.isTTY === true;
+        const answers = interactive
+            ? await interview(defaultAnswers(parsed.manifest, detection))
+            : defaultAnswers(parsed.manifest, detection);
+        plan = planBrowserTesting(parsed.manifest, detection, answers);
+    }
+    else {
+        plan = planRalph(parsed.manifest);
+    }
+    const manifestUpdate = setModuleEnabled(manifestSource, opts.module, plan.testing);
+    const existing = readLockfile(opts.cwd);
+    if (existing.error) {
+        console.error(`launchrail: ${existing.error} — refusing to continue. Fix or remove the lockfile first.`);
+        return { code: 1, actions: [] };
+    }
+    const lockfile = existing.lockfile ?? emptyLockfile(VERSION);
+    const lockBefore = JSON.stringify(lockfile);
+    const specs = [
+        ...plan.specs,
+        claudeGeneratedFile({ projectName: detection.projectName, manifest: plan.manifest, launchrailVersion: VERSION }),
+    ];
+    const actions = planWrites(opts.cwd, specs, lockfile);
+    console.log("");
+    console.log(manifestUpdate.changed
+        ? `  update    ${MANIFEST_FILENAME}  (enable ${opts.module}${Object.keys(plan.testing).length > 0 ? ", record testing commands" : ""})`
+        : `  ok        ${MANIFEST_FILENAME}  (${opts.module} already enabled)`);
+    for (const action of actions) {
+        console.log(`  ${ACTION_LABEL[action.kind]}  ${action.spec.relPath}  (${action.detail})`);
+    }
+    for (const note of plan.notes)
+        console.log(`\n${note}`);
+    if (opts.dryRun) {
+        console.log("\nDry run — nothing was written.");
+        return { code: 0, actions };
+    }
+    if (manifestUpdate.changed) {
+        writeFileSync(join(opts.cwd, MANIFEST_FILENAME), manifestUpdate.source, "utf8");
+    }
+    const written = applyPlan(opts.cwd, actions, lockfile);
+    lockfile.launchrailVersion = VERSION;
+    lockfile.decisions = {
+        ...lockfile.decisions,
+        [`module:${opts.module}`]: true,
+        ...plan.decisions,
+    };
+    if (JSON.stringify(lockfile) !== lockBefore || !existing.lockfile) {
+        writeLockfile(opts.cwd, lockfile);
+    }
+    const conflicts = actions.filter((a) => a.kind === "conflict");
+    if (conflicts.length > 0) {
+        console.log(`\nNot overwritten (locally modified managed file${conflicts.length > 1 ? "s" : ""}): ${conflicts
+            .map((a) => a.spec.relPath)
+            .join(", ")} — revert local edits to receive updates, or run \`launchrail eject <file>\` to own them permanently.`);
+    }
+    console.log(written.length > 0 || manifestUpdate.changed
+        ? `\nWrote ${written.length + (manifestUpdate.changed ? 1 : 0)} file(s).`
+        : "\nEverything already up to date — nothing written.");
+    console.log("\nNext steps:");
+    plan.nextSteps.forEach((step, i) => console.log(`  ${i + 1}. ${step}`));
+    if (opts.module === RALPH_MODULE) {
+        console.log(`\nThe campaign workflow lives at ${RALPH_WORKFLOW_PATH} (managed — do not hand-edit).`);
+    }
+    return { code: 0, actions };
+}
+//# sourceMappingURL=add.js.map

package/dist/commands/add.js.map

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

package/dist/commands/diff.d.ts

@@ -0,0 +1,13 @@
+export interface DiffEntry {
+    relPath: string;
+    kind: "create" | "update" | "conflict";
+    diff: string;
+}
+export interface DiffOutcome {
+    code: number;
+    errors: string[];
+    entries: DiffEntry[];
+}
+/** Preview what `launchrail sync` would write, as unified diffs against disk. */
+export declare function runDiff(cwd: string): DiffOutcome;
+export declare function printDiff(outcome: DiffOutcome): void;

package/dist/commands/diff.js

@@ -0,0 +1,44 @@
+import { readFileSync } from "node:fs";
+import { join } from "node:path";
+import { formatUnifiedDiff } from "../lib/diff.js";
+import { loadProject, desiredSpecs } from "../lib/project.js";
+import { planWrites } from "../lib/writer.js";
+/** Preview what `launchrail sync` would write, as unified diffs against disk. */
+export function runDiff(cwd) {
+    const { state, errors } = loadProject(cwd);
+    if (!state)
+        return { code: 1, errors, entries: [] };
+    const entries = [];
+    for (const action of planWrites(cwd, desiredSpecs(state), state.lockfile)) {
+        if (action.kind !== "create" && action.kind !== "update" && action.kind !== "conflict")
+            continue;
+        const current = action.kind === "create" ? "" : readFileSync(join(cwd, action.spec.relPath), "utf8");
+        entries.push({
+            relPath: action.spec.relPath,
+            kind: action.kind,
+            diff: formatUnifiedDiff(current, action.spec.content),
+        });
+    }
+    return { code: 0, errors: [], entries };
+}
+export function printDiff(outcome) {
+    if (outcome.errors.length > 0) {
+        for (const error of outcome.errors)
+            console.error(`launchrail: ${error}`);
+        return;
+    }
+    if (outcome.entries.length === 0) {
+        console.log("No upstream changes — managed files and seeds are up to date.");
+        return;
+    }
+    for (const entry of outcome.entries) {
+        console.log(`--- ${entry.kind === "create" ? "/dev/null" : `a/${entry.relPath}`}`);
+        console.log(`+++ b/${entry.relPath}`);
+        if (entry.kind === "conflict") {
+            console.log("(locally modified — sync will keep your version; shown for reference)");
+        }
+        process.stdout.write(entry.diff);
+        console.log("");
+    }
+}
+//# sourceMappingURL=diff.js.map

package/dist/commands/diff.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"diff.js","sourceRoot":"","sources":["../../src/commands/diff.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,YAAY,EAAE,MAAM,SAAS,CAAC;AACvC,OAAO,EAAE,IAAI,EAAE,MAAM,WAAW,CAAC;AACjC,OAAO,EAAE,iBAAiB,EAAE,MAAM,gBAAgB,CAAC;AACnD,OAAO,EAAE,WAAW,EAAE,YAAY,EAAE,MAAM,mBAAmB,CAAC;AAC9D,OAAO,EAAE,UAAU,EAAE,MAAM,kBAAkB,CAAC;AAc9C,iFAAiF;AACjF,MAAM,UAAU,OAAO,CAAC,GAAW;IACjC,MAAM,EAAE,KAAK,EAAE,MAAM,EAAE,GAAG,WAAW,CAAC,GAAG,CAAC,CAAC;IAC3C,IAAI,CAAC,KAAK;QAAE,OAAO,EAAE,IAAI,EAAE,CAAC,EAAE,MAAM,EAAE,OAAO,EAAE,EAAE,EAAE,CAAC;IAEpD,MAAM,OAAO,GAAgB,EAAE,CAAC;IAChC,KAAK,MAAM,MAAM,IAAI,UAAU,CAAC,GAAG,EAAE,YAAY,CAAC,KAAK,CAAC,EAAE,KAAK,CAAC,QAAQ,CAAC,EAAE,CAAC;QAC1E,IAAI,MAAM,CAAC,IAAI,KAAK,QAAQ,IAAI,MAAM,CAAC,IAAI,KAAK,QAAQ,IAAI,MAAM,CAAC,IAAI,KAAK,UAAU;YAAE,SAAS;QACjG,MAAM,OAAO,GAAG,MAAM,CAAC,IAAI,KAAK,QAAQ,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,YAAY,CAAC,IAAI,CAAC,GAAG,EAAE,MAAM,CAAC,IAAI,CAAC,OAAO,CAAC,EAAE,MAAM,CAAC,CAAC;QACrG,OAAO,CAAC,IAAI,CAAC;YACX,OAAO,EAAE,MAAM,CAAC,IAAI,CAAC,OAAO;YAC5B,IAAI,EAAE,MAAM,CAAC,IAAI;YACjB,IAAI,EAAE,iBAAiB,CAAC,OAAO,EAAE,MAAM,CAAC,IAAI,CAAC,OAAO,CAAC;SACtD,CAAC,CAAC;IACL,CAAC;IACD,OAAO,EAAE,IAAI,EAAE,CAAC,EAAE,MAAM,EAAE,EAAE,EAAE,OAAO,EAAE,CAAC;AAC1C,CAAC;AAED,MAAM,UAAU,SAAS,CAAC,OAAoB;IAC5C,IAAI,OAAO,CAAC,MAAM,CAAC,MAAM,GAAG,CAAC,EAAE,CAAC;QAC9B,KAAK,MAAM,KAAK,IAAI,OAAO,CAAC,MAAM;YAAE,OAAO,CAAC,KAAK,CAAC,eAAe,KAAK,EAAE,CAAC,CAAC;QAC1E,OAAO;IACT,CAAC;IACD,IAAI,OAAO,CAAC,OAAO,CAAC,MAAM,KAAK,CAAC,EAAE,CAAC;QACjC,OAAO,CAAC,GAAG,CAAC,+DAA+D,CAAC,CAAC;QAC7E,OAAO;IACT,CAAC;IACD,KAAK,MAAM,KAAK,IAAI,OAAO,CAAC,OAAO,EAAE,CAAC;QACpC,OAAO,CAAC,GAAG,CAAC,OAAO,KAAK,CAAC,IAAI,KAAK,QAAQ,CAAC,CAAC,CAAC,WAAW,CAAC,CAAC,CAAC,KAAK,KAAK,CAAC,OAAO,EAAE,EAAE,CAAC,CAAC;QACnF,OAAO,CAAC,GAAG,CAAC,SAAS,KAAK,CAAC,OAAO,EAAE,CAAC,CAAC;QACtC,IAAI,KAAK,CAAC,IAAI,KAAK,UAAU,EAAE,CAAC;YAC9B,OAAO,CAAC,GAAG,CAAC,uEAAuE,CAAC,CAAC;QACvF,CAAC;QACD,OAAO,CAAC,MAAM,CAAC,KAAK,CAAC,KAAK,CAAC,IAAI,CAAC,CAAC;QACjC,OAAO,CAAC,GAAG,CAAC,EAAE,CAAC,CAAC;IAClB,CAAC;AACH,CAAC"}

package/dist/commands/doctor.d.ts

@@ -0,0 +1,12 @@
+export type CheckStatus = "pass" | "warn" | "fail";
+export interface DoctorCheck {
+    status: CheckStatus;
+    name: string;
+    message: string;
+}
+export interface DoctorOutcome {
+    code: number;
+    checks: DoctorCheck[];
+}
+export declare function runDoctor(cwd: string): DoctorOutcome;
+export declare function printDoctor(outcome: DoctorOutcome): void;

package/dist/commands/doctor.js

@@ -0,0 +1,171 @@
+import { existsSync, readFileSync } from "node:fs";
+import { join } from "node:path";
+import { BROWSER_TESTING_MODULE, SEMANTIC_SCRIPTS, SMOKE_JOURNEYS_PATH } from "../lib/browser-testing.js";
+import { sha256 } from "../lib/checksum.js";
+import { CLAUDE_SETTINGS_PATH, declarationState } from "../lib/claudeSettings.js";
+import { detectRepo } from "../lib/detect.js";
+import { readLockfile } from "../lib/lockfile.js";
+import { pendingMigrations } from "../lib/migrations.js";
+import { MANIFEST_FILENAME, parseManifest } from "../lib/manifest.js";
+import { RALPH_MODULE, RALPH_WORKFLOW_PATH } from "../lib/ralph.js";
+export function runDoctor(cwd) {
+    const checks = [];
+    const add = (status, name, message = "") => {
+        checks.push({ status, name, message });
+    };
+    const detection = detectRepo(cwd);
+    if (detection.isGitRepo)
+        add("pass", "git repository");
+    else
+        add("warn", "git repository", "not a git repo — Launchrail relies on git history for safe writes");
+    const nodeMajor = Number(process.versions.node.split(".")[0]);
+    if (nodeMajor >= 22)
+        add("pass", "node version", `v${process.versions.node}`);
+    else
+        add("warn", "node version", `v${process.versions.node} — Launchrail targets Node >= 22`);
+    if (detection.packageManager)
+        add("pass", "package manager", detection.packageManager);
+    else
+        add("warn", "package manager", "none detected (no lockfile or packageManager field)");
+    let manifest = null;
+    if (!existsSync(join(cwd, MANIFEST_FILENAME))) {
+        add("fail", "manifest", `${MANIFEST_FILENAME} missing — run \`launchrail init\``);
+    }
+    else {
+        const parsed = parseManifest(readFileSync(join(cwd, MANIFEST_FILENAME), "utf8"));
+        if (parsed.manifest) {
+            manifest = parsed.manifest;
+            add("pass", "manifest", `valid (mode: ${parsed.manifest.mode})`);
+        }
+        else {
+            add("fail", "manifest", `invalid: ${parsed.errors.join("; ")}`);
+        }
+    }
+    const { lockfile, error: lockError } = readLockfile(cwd);
+    if (lockError) {
+        add("fail", "lockfile", lockError);
+    }
+    else if (!lockfile) {
+        add("fail", "lockfile", "missing — run `launchrail init`");
+    }
+    else {
+        add("pass", "lockfile", `${Object.keys(lockfile.files).length} tracked file(s)`);
+        const managed = Object.entries(lockfile.files).filter(([, f]) => f.class === "managed");
+        const drifted = [];
+        let missing = 0;
+        for (const [relPath, locked] of managed) {
+            const abs = join(cwd, relPath);
+            if (!existsSync(abs)) {
+                add("fail", "managed file", `${relPath} is tracked but missing`);
+                missing += 1;
+            }
+            else if (sha256(readFileSync(abs, "utf8")) !== locked.checksum) {
+                drifted.push(relPath);
+            }
+        }
+        if (drifted.length > 0) {
+            add("warn", "managed drift", `${drifted.join(", ")} locally modified — sync will ask before replacing`);
+        }
+        else if (missing === 0 && managed.length > 0) {
+            add("pass", "managed files", "match lockfile checksums");
+        }
+        const pending = pendingMigrations(lockfile);
+        if (pending.length > 0) {
+            add("warn", "migrations", `${pending.length} pending (${pending.map((m) => m.id).join(", ")}) — run \`launchrail sync\``);
+        }
+        else {
+            add("pass", "migrations", "all applied");
+        }
+    }
+    if (detection.hasAgentsMd)
+        add("pass", "AGENTS.md");
+    else
+        add("fail", "AGENTS.md", "missing — run `launchrail init`");
+    if (!detection.hasClaudeMd) {
+        add("fail", "CLAUDE.md", "missing — run `launchrail init`");
+    }
+    else if (readFileSync(join(cwd, "CLAUDE.md"), "utf8").includes("@AGENTS.md")) {
+        add("pass", "CLAUDE.md", "imports @AGENTS.md");
+    }
+    else {
+        add("warn", "CLAUDE.md", "does not import @AGENTS.md — Claude will not see the shared agent contract");
+    }
+    if (detection.hasMattPocockSetup)
+        add("pass", "Matt Pocock setup", "docs/agents/ present");
+    else
+        add("warn", "Matt Pocock setup", "docs/agents/ not found — install the skills and run /setup-matt-pocock-skills");
+    const declaration = declarationState(cwd);
+    if (declaration === "declared") {
+        add("pass", "plugin declaration", `${CLAUDE_SETTINGS_PATH} declares the Launchrail plugin`);
+    }
+    else if (declaration === "invalid-json") {
+        add("warn", "plugin declaration", `${CLAUDE_SETTINGS_PATH} is not valid JSON`);
+    }
+    else {
+        add("warn", "plugin declaration", `Launchrail plugin not declared in ${CLAUDE_SETTINGS_PATH} — run \`launchrail init\``);
+    }
+    if (manifest?.modules[BROWSER_TESTING_MODULE]) {
+        if (detection.hasPlaywrightDep) {
+            add("pass", "playwright dependency", "@playwright/test declared");
+        }
+        else {
+            add("fail", "playwright dependency", "@playwright/test not declared — run `node scripts/setup.mjs`");
+        }
+        if (detection.playwrightConfigFile) {
+            add("pass", "playwright config", detection.playwrightConfigFile);
+        }
+        else {
+            add("fail", "playwright config", "no playwright.config.* found — re-run `launchrail add browser-testing`");
+        }
+        if (existsSync(join(cwd, SMOKE_JOURNEYS_PATH))) {
+            add("pass", "smoke journeys", SMOKE_JOURNEYS_PATH);
+        }
+        else {
+            add("warn", "smoke journeys", `${SMOKE_JOURNEYS_PATH} missing — smoke runs will have no defined journeys`);
+        }
+        const missingScripts = SEMANTIC_SCRIPTS.filter((name) => !existsSync(join(cwd, "scripts", `${name}.mjs`)));
+        if (missingScripts.length === 0) {
+            add("pass", "semantic scripts", "scripts/{setup,dev,verify,smoke,doctor}.mjs");
+        }
+        else {
+            add("warn", "semantic scripts", `missing: ${missingScripts.map((name) => `scripts/${name}.mjs`).join(", ")}`);
+        }
+        if (manifest.testing.e2eCommand && manifest.testing.smokeCommand) {
+            add("pass", "testing commands", "e2e and smoke commands configured");
+        }
+        else {
+            add("warn", "testing commands", `set testing.e2eCommand and testing.smokeCommand in ${MANIFEST_FILENAME}`);
+        }
+    }
+    if (manifest?.modules[RALPH_MODULE]) {
+        if (existsSync(join(cwd, RALPH_WORKFLOW_PATH))) {
+            add("pass", "ralph workflow", RALPH_WORKFLOW_PATH);
+        }
+        else {
+            add("fail", "ralph workflow", `${RALPH_WORKFLOW_PATH} missing — re-run \`launchrail add ralph\``);
+        }
+        if (manifest.issueTracker !== "none") {
+            add("pass", "ralph tracker", `issueTracker: ${manifest.issueTracker}`);
+        }
+        else {
+            add("warn", "ralph tracker", `issueTracker is none — Ralph runs off tickets; set it in ${MANIFEST_FILENAME}`);
+        }
+        if (manifest.testing.unitCommand || manifest.testing.e2eCommand) {
+            add("pass", "ralph verification gate", "testing commands configured");
+        }
+        else {
+            add("warn", "ralph verification gate", `no testing commands in ${MANIFEST_FILENAME} — \`verify\` fails on an empty contract and Ralph refuses to start`);
+        }
+    }
+    return { code: checks.some((c) => c.status === "fail") ? 1 : 0, checks };
+}
+const SYMBOL = { pass: "✓", warn: "!", fail: "✗" };
+export function printDoctor(outcome) {
+    for (const check of outcome.checks) {
+        console.log(`  ${SYMBOL[check.status]} ${check.name}${check.message ? ` — ${check.message}` : ""}`);
+    }
+    const failed = outcome.checks.filter((c) => c.status === "fail").length;
+    const warned = outcome.checks.filter((c) => c.status === "warn").length;
+    console.log(`\n${failed === 0 ? "Healthy" : "Unhealthy"}: ${outcome.checks.length} checks, ${failed} failed, ${warned} warning(s).`);
+}
+//# sourceMappingURL=doctor.js.map

package/dist/commands/doctor.js.map

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

package/dist/commands/eject.d.ts

@@ -0,0 +1,17 @@
+export interface EjectOptions {
+    cwd: string;
+    /** A module name or a tracked file path; null with `all` for vendor mode. */
+    target: string | null;
+    all: boolean;
+    dryRun: boolean;
+}
+export interface EjectOutcome {
+    code: number;
+    ejected: string[];
+}
+/**
+ * Stop managing paths: mark them "ejected" in the lockfile so no future init,
+ * sync, or add ever writes them again — not even to recreate them if deleted.
+ * `--all` is vendor mode: eject everything Launchrail has ever written here.
+ */
+export declare function runEject(opts: EjectOptions): EjectOutcome;

package/dist/commands/eject.js

@@ -0,0 +1,80 @@
+import { existsSync, readFileSync, writeFileSync } from "node:fs";
+import { join } from "node:path";
+import { sha256 } from "../lib/checksum.js";
+import { writeLockfile } from "../lib/lockfile.js";
+import { loadProject, moduleSpecs } from "../lib/project.js";
+const MANAGED_HEADER = /^<!-- Managed by Launchrail[\s\S]*?-->\n?/;
+const EJECTED_HEADER = "<!-- Ejected from Launchrail management — this file is yours to edit. -->\n";
+/**
+ * Stop managing paths: mark them "ejected" in the lockfile so no future init,
+ * sync, or add ever writes them again — not even to recreate them if deleted.
+ * `--all` is vendor mode: eject everything Launchrail has ever written here.
+ */
+export function runEject(opts) {
+    const { state, errors } = loadProject(opts.cwd);
+    if (!state) {
+        for (const error of errors)
+            console.error(`launchrail: ${error}`);
+        return { code: 1, ejected: [] };
+    }
+    if (!opts.all && opts.target === null) {
+        console.error("launchrail: usage: launchrail eject <module|file> [--dry-run], or launchrail eject --all");
+        return { code: 1, ejected: [] };
+    }
+    const { lockfile } = state;
+    const tracked = (relPath) => lockfile.files[relPath] !== undefined;
+    const notEjected = (relPath) => lockfile.files[relPath]?.class !== "ejected";
+    const modules = moduleSpecs(state);
+    let targets;
+    if (opts.all) {
+        targets = Object.keys(lockfile.files).filter(notEjected);
+    }
+    else if (opts.target !== null && modules[opts.target] !== undefined) {
+        targets = modules[opts.target].map((spec) => spec.relPath).filter(tracked).filter(notEjected);
+    }
+    else if (opts.target !== null && tracked(opts.target)) {
+        targets = [opts.target].filter(notEjected);
+    }
+    else {
+        console.error(`launchrail: "${opts.target}" is neither an enabled module (${Object.keys(modules).join(", ")}) nor a file tracked in the lockfile.`);
+        return { code: 1, ejected: [] };
+    }
+    if (targets.length === 0) {
+        console.log("Nothing to eject — the selected path(s) are already ejected.");
+        return { code: 0, ejected: [] };
+    }
+    // The managed do-not-edit header becomes wrong the moment a file is ejected.
+    // Rewrite it only when the file is provably unmodified; otherwise the file is
+    // already the user's and is left byte-for-byte alone.
+    const headerRewrites = new Map();
+    for (const relPath of targets) {
+        const locked = lockfile.files[relPath];
+        const abs = join(opts.cwd, relPath);
+        if (locked.class !== "managed" || !existsSync(abs))
+            continue;
+        const current = readFileSync(abs, "utf8");
+        if (sha256(current) === locked.checksum && MANAGED_HEADER.test(current)) {
+            headerRewrites.set(relPath, current.replace(MANAGED_HEADER, EJECTED_HEADER));
+        }
+    }
+    for (const relPath of targets) {
+        console.log(`  eject     ${relPath}${headerRewrites.has(relPath) ? "  (managed header rewritten)" : ""}`);
+    }
+    if (opts.dryRun) {
+        console.log("\nDry run — nothing was written.");
+        return { code: 0, ejected: [] };
+    }
+    for (const relPath of targets) {
+        const rewritten = headerRewrites.get(relPath);
+        if (rewritten !== undefined)
+            writeFileSync(join(opts.cwd, relPath), rewritten, "utf8");
+        lockfile.files[relPath] = {
+            class: "ejected",
+            checksum: rewritten !== undefined ? sha256(rewritten) : lockfile.files[relPath].checksum,
+        };
+    }
+    writeLockfile(opts.cwd, lockfile);
+    console.log(`\nEjected ${targets.length} file(s) — Launchrail will never write them again.`);
+    return { code: 0, ejected: targets };
+}
+//# sourceMappingURL=eject.js.map

package/dist/commands/eject.js.map

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

package/dist/commands/init.d.ts

@@ -0,0 +1,13 @@
+import { type SettingsPlan } from "../lib/claudeSettings.js";
+import { type PlannedAction } from "../lib/writer.js";
+export interface InitOptions {
+    cwd: string;
+    dryRun: boolean;
+    yes: boolean;
+}
+export interface InitOutcome {
+    code: number;
+    actions: PlannedAction[];
+    settings: SettingsPlan;
+}
+export declare function runInit(opts: InitOptions): Promise<InitOutcome>;