@wemuda/launchrail 1.0.0

package/dist/commands/init.js

@@ -0,0 +1,173 @@
+import { readFileSync } from "node:fs";
+import { join } from "node:path";
+import * as p from "@clack/prompts";
+import { applyPluginDeclaration, CLAUDE_SETTINGS_PATH, planPluginDeclaration, } from "../lib/claudeSettings.js";
+import { detectRepo } from "../lib/detect.js";
+import { emptyLockfile, readLockfile, writeLockfile } from "../lib/lockfile.js";
+import { migrationIds } from "../lib/migrations.js";
+import { ISSUE_TRACKERS, MANIFEST_FILENAME, parseManifest, serializeManifest, } from "../lib/manifest.js";
+import { seedFiles } from "../lib/seeds.js";
+import { ACTION_LABEL, applyPlan, planWrites } from "../lib/writer.js";
+import { VERSION } from "../version.js";
+function suggestedTestCommand(detection) {
+    if (!detection.testScript)
+        return null;
+    return `${detection.packageManager ?? "npm"} test`;
+}
+function defaultTesting(detection) {
+    return {
+        unitCommand: suggestedTestCommand(detection),
+        devCommand: detection.devScript ? `${detection.packageManager ?? "npm"} run dev` : null,
+        e2eCommand: null,
+        smokeCommand: null,
+        appUrl: null,
+    };
+}
+function defaultManifestFor(detection) {
+    return {
+        schemaVersion: 1,
+        mode: "standard-mvp",
+        issueTracker: detection.gitRemoteUrl?.includes("github.com") ? "github" : "none",
+        conventions: {
+            conventionalCommits: detection.conventionalCommitRatio === null ? true : detection.conventionalCommitRatio >= 0.5,
+        },
+        testing: defaultTesting(detection),
+        modules: { core: true },
+    };
+}
+async function interview(detection) {
+    const defaults = defaultManifestFor(detection);
+    p.intro("launchrail init");
+    if (!detection.isGitRepo) {
+        p.log.warn("This is not a git repository. Launchrail relies on git history for safe writes.");
+    }
+    const answers = await p.group({
+        mode: () => p.select({
+            message: "Project mode",
+            initialValue: defaults.mode,
+            options: [
+                { value: "standard-mvp", label: "Standard MVP", hint: "default product workflow" },
+                { value: "spike", label: "Spike", hint: "short experiment; disposable or highly uncertain" },
+                { value: "high-rigor", label: "High-rigor", hint: "security-sensitive, regulated, or multi-team" },
+            ],
+        }),
+        issueTracker: () => p.select({
+            message: "Issue tracker",
+            initialValue: defaults.issueTracker,
+            options: ISSUE_TRACKERS.map((t) => ({ value: t, label: t })),
+        }),
+        conventionalCommits: () => p.confirm({
+            message: "Use Conventional Commits? (recorded in the seeded AGENTS.md so agents follow it)",
+            initialValue: defaults.conventions.conventionalCommits,
+        }),
+        unitCommand: () => p.text({
+            message: "Deterministic test command (empty to decide later)",
+            initialValue: defaults.testing.unitCommand ?? "",
+            placeholder: "e.g. pnpm test",
+        }),
+    }, {
+        onCancel: () => {
+            p.cancel("Cancelled — nothing was written.");
+            process.exit(130);
+        },
+    });
+    return {
+        schemaVersion: 1,
+        mode: answers.mode,
+        issueTracker: answers.issueTracker,
+        conventions: { conventionalCommits: answers.conventionalCommits },
+        testing: {
+            ...defaultTesting(detection),
+            unitCommand: answers.unitCommand.trim() === "" ? null : answers.unitCommand.trim(),
+        },
+        modules: { core: true },
+    };
+}
+const SETTINGS_LABEL = {
+    create: "create  ",
+    merge: "update  ",
+    "skip-declared": "ok      ",
+    "skip-invalid": "conflict",
+};
+export async function runInit(opts) {
+    const detection = detectRepo(opts.cwd);
+    const settings = planPluginDeclaration(opts.cwd);
+    const interactive = !opts.yes && process.stdin.isTTY === true && process.stdout.isTTY === true;
+    let manifest;
+    if (detection.hasManifest) {
+        const parsed = parseManifest(readFileSync(join(opts.cwd, MANIFEST_FILENAME), "utf8"));
+        if (!parsed.manifest) {
+            console.error(`launchrail: existing ${MANIFEST_FILENAME} is invalid:`);
+            for (const error of parsed.errors)
+                console.error(`  - ${error}`);
+            return { code: 1, actions: [], settings };
+        }
+        manifest = parsed.manifest;
+        console.log(`Found existing ${MANIFEST_FILENAME} — using its configuration (init is idempotent).`);
+    }
+    else if (interactive) {
+        manifest = await interview(detection);
+    }
+    else if (opts.yes) {
+        manifest = defaultManifestFor(detection);
+    }
+    else {
+        console.error("launchrail: non-interactive session — re-run with --yes to accept defaults.");
+        return { code: 1, actions: [], settings };
+    }
+    const specs = [
+        { relPath: MANIFEST_FILENAME, content: serializeManifest(manifest), ownership: "seeded" },
+        ...seedFiles({ projectName: detection.projectName, manifest, launchrailVersion: VERSION }),
+    ];
+    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: [], settings };
+    }
+    const lockfile = existing.lockfile ?? emptyLockfile(VERSION);
+    if (!existing.lockfile) {
+        // A fresh init produces the current structure, so every shipped migration
+        // is satisfied by definition. Existing lockfiles are left to `sync`.
+        lockfile.migrations = migrationIds().sort();
+    }
+    const lockBefore = JSON.stringify(lockfile);
+    const actions = planWrites(opts.cwd, specs, lockfile);
+    console.log("");
+    for (const action of actions) {
+        console.log(`  ${ACTION_LABEL[action.kind]}  ${action.spec.relPath}  (${action.detail})`);
+    }
+    console.log(`  ${SETTINGS_LABEL[settings.kind]}  ${CLAUDE_SETTINGS_PATH}  (${settings.detail})`);
+    if (opts.dryRun) {
+        console.log("\nDry run — nothing was written.");
+        return { code: 0, actions, settings };
+    }
+    const written = applyPlan(opts.cwd, actions, lockfile);
+    if (applyPluginDeclaration(opts.cwd, settings))
+        written.push(CLAUDE_SETTINGS_PATH);
+    lockfile.launchrailVersion = VERSION;
+    lockfile.decisions = {
+        ...lockfile.decisions,
+        mode: manifest.mode,
+        issueTracker: manifest.issueTracker,
+        conventionalCommits: manifest.conventions.conventionalCommits,
+        unitCommand: manifest.testing.unitCommand,
+    };
+    if (JSON.stringify(lockfile) !== lockBefore || !existing.lockfile) {
+        writeLockfile(opts.cwd, lockfile);
+    }
+    console.log(written.length > 0
+        ? `\nWrote ${written.length} file(s).`
+        : "\nEverything already up to date — nothing written.");
+    if (!detection.isGitRepo) {
+        console.log("\n⚠ Not a git repository. Run `git init` before letting agents work here — Launchrail relies on git for safe writes.");
+    }
+    console.log("\nNext steps:");
+    console.log("  1. Review the seeded AGENTS.md and fill in the TODO sections.");
+    if (!detection.hasMattPocockSetup) {
+        console.log("  2. Install Matt Pocock's skills and run /setup-matt-pocock-skills (expected output: docs/agents/).");
+    }
+    console.log(`  ${detection.hasMattPocockSetup ? "2" : "3"}. Run \`npx @wemuda/launchrail doctor\` to validate the setup.`);
+    console.log(`  ${detection.hasMattPocockSetup ? "3" : "4"}. Commit the result.`);
+    return { code: 0, actions, settings };
+}
+//# sourceMappingURL=init.js.map

package/dist/commands/init.js.map

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

package/dist/commands/smoke.d.ts

@@ -0,0 +1,21 @@
+export interface SmokeOptions {
+    cwd: string;
+    url: string | null;
+    dryRun: boolean;
+}
+export interface SmokeOutcome {
+    code: number;
+    /** Absolute path of the created run directory, when one was created. */
+    runDir: string | null;
+}
+export type SmokeEnvironment = "local" | "ci" | "cloud";
+export declare function parseJourneyNames(source: string): string[];
+/**
+ * Prepare an agentic smoke run: confirm the app is reachable, then scaffold a
+ * traceable evidence bundle under artifacts/verification/<run-id>/. The agent
+ * (browser-smoke skill) drives the journeys and fills the bundle in.
+ *
+ * Only ever creates new files in a fresh run directory — it never modifies
+ * existing project files, so no checksum tracking is needed.
+ */
+export declare function runSmoke(opts: SmokeOptions): Promise<SmokeOutcome>;

package/dist/commands/smoke.js

@@ -0,0 +1,171 @@
+import { execFileSync } from "node:child_process";
+import { existsSync, mkdirSync, readFileSync, writeFileSync } from "node:fs";
+import { join } from "node:path";
+import { BROWSER_TESTING_MODULE, SMOKE_JOURNEYS_PATH } from "../lib/browser-testing.js";
+import { MANIFEST_FILENAME, parseManifest } from "../lib/manifest.js";
+import { VERSION } from "../version.js";
+function detectEnvironment(env) {
+    if (env.CLAUDE_CODE_REMOTE === "true")
+        return "cloud";
+    if (env.CI)
+        return "ci";
+    return "local";
+}
+function git(cwd, args) {
+    try {
+        return execFileSync("git", args, { cwd, encoding: "utf8", stdio: ["ignore", "pipe", "ignore"] }).trim();
+    }
+    catch {
+        return null;
+    }
+}
+export function parseJourneyNames(source) {
+    return source
+        .split("\n")
+        .filter((line) => line.startsWith("## Journey:"))
+        .map((line) => line.slice("## Journey:".length).trim())
+        .filter((name) => name.length > 0);
+}
+const EVIDENCE_GITIGNORE = `# Managed by Launchrail: keep summaries and deviations reviewable, ignore bulky evidence.
+*
+!.gitignore
+!*/
+!*/summary.md
+!*/deviations.md
+!*/meta.json
+`;
+function summaryTemplate(opts) {
+    const journeyLines = opts.journeys.length > 0
+        ? opts.journeys.map((name) => `- [ ] ${name}`).join("\n")
+        : `_No journeys defined in ${SMOKE_JOURNEYS_PATH} — record the journeys actually driven (e.g. from the ticket under verification)._`;
+    return `# Smoke verification — ${opts.runId}
+
+- Commit: ${opts.commitSha ?? "no git history"}${opts.gitDirty ? " (working tree dirty)" : ""}
+- Base URL: ${opts.baseUrl} (responded ${opts.appStatus})
+- Environment: ${opts.environment}
+- Launchrail: v${VERSION}
+- Spec / ticket references: _fill in_
+
+## Journeys
+
+${journeyLines}
+
+## Standard checks
+
+- [ ] No uncaught console errors
+- [ ] No failed API requests
+- [ ] Success state visible for each journey
+- [ ] Data remains after refresh
+
+## Evidence
+
+_Reference files in this directory: screenshots/, traces/, console.log, network-errors.json, test-results.json._
+
+## Deviations from spec or design
+
+_None recorded — add details here and in deviations.md when found._
+
+## New regression tests
+
+_Deterministic tests added from smoke findings._
+
+## Blockers
+
+_None._
+`;
+}
+/**
+ * Prepare an agentic smoke run: confirm the app is reachable, then scaffold a
+ * traceable evidence bundle under artifacts/verification/<run-id>/. The agent
+ * (browser-smoke skill) drives the journeys and fills the bundle in.
+ *
+ * Only ever creates new files in a fresh run directory — it never modifies
+ * existing project files, so no checksum tracking is needed.
+ */
+export async function runSmoke(opts) {
+    const manifestPath = join(opts.cwd, MANIFEST_FILENAME);
+    if (!existsSync(manifestPath)) {
+        console.error(`launchrail: ${MANIFEST_FILENAME} not found — run \`launchrail init\` first.`);
+        return { code: 1, runDir: null };
+    }
+    const parsed = parseManifest(readFileSync(manifestPath, "utf8"));
+    if (!parsed.manifest) {
+        console.error(`launchrail: ${MANIFEST_FILENAME} is invalid:`);
+        for (const error of parsed.errors)
+            console.error(`  - ${error}`);
+        return { code: 1, runDir: null };
+    }
+    if (!parsed.manifest.modules[BROWSER_TESTING_MODULE]) {
+        console.error(`launchrail: the ${BROWSER_TESTING_MODULE} module is not enabled — run \`launchrail add ${BROWSER_TESTING_MODULE}\` first.`);
+        return { code: 1, runDir: null };
+    }
+    const baseUrl = opts.url ?? parsed.manifest.testing.appUrl;
+    if (!baseUrl) {
+        console.error(`launchrail: no app URL — set testing.appUrl in ${MANIFEST_FILENAME} or pass --url <url>.`);
+        return { code: 1, runDir: null };
+    }
+    let appStatus = null;
+    try {
+        const response = await fetch(baseUrl, { signal: AbortSignal.timeout(3000), redirect: "manual" });
+        appStatus = `HTTP ${response.status}`;
+    }
+    catch {
+        // Any response counts as reachable; only a connection failure aborts the run.
+    }
+    if (appStatus === null) {
+        console.error(`launchrail: ${baseUrl} is not responding. Start the app first (\`node scripts/dev.mjs --background\`) or pass --url <url>.`);
+        return { code: 1, runDir: null };
+    }
+    const journeysPath = join(opts.cwd, SMOKE_JOURNEYS_PATH);
+    const journeys = existsSync(journeysPath) ? parseJourneyNames(readFileSync(journeysPath, "utf8")) : [];
+    const commitSha = git(opts.cwd, ["rev-parse", "HEAD"]);
+    const gitDirty = (git(opts.cwd, ["status", "--porcelain"]) ?? "") !== "";
+    const environment = detectEnvironment(process.env);
+    const stamp = new Date().toISOString().replace(/[-:]/g, "").replace("T", "-").slice(0, 15);
+    let runId = `${stamp}-${commitSha?.slice(0, 7) ?? "nogit"}`;
+    const verificationDir = join(opts.cwd, "artifacts", "verification");
+    for (let n = 2; existsSync(join(verificationDir, runId)); n += 1) {
+        runId = `${stamp}-${commitSha?.slice(0, 7) ?? "nogit"}-${n}`;
+    }
+    const runDir = join(verificationDir, runId);
+    console.log(`App responding at ${baseUrl} (${appStatus}).`);
+    if (journeys.length > 0) {
+        console.log(`\n${journeys.length} journey(s) from ${SMOKE_JOURNEYS_PATH}:`);
+        for (const name of journeys)
+            console.log(`  - ${name}`);
+    }
+    else {
+        console.log(`\nNo journeys defined in ${SMOKE_JOURNEYS_PATH} — drive the journeys defined by the work under verification.`);
+    }
+    if (opts.dryRun) {
+        console.log(`\nDry run — would create artifacts/verification/${runId}/ (meta.json, summary.md, screenshots/, traces/).`);
+        return { code: 0, runDir: null };
+    }
+    mkdirSync(join(runDir, "screenshots"), { recursive: true });
+    mkdirSync(join(runDir, "traces"), { recursive: true });
+    const gitignorePath = join(verificationDir, ".gitignore");
+    if (!existsSync(gitignorePath))
+        writeFileSync(gitignorePath, EVIDENCE_GITIGNORE, "utf8");
+    const meta = {
+        schemaVersion: 1,
+        runId,
+        createdAt: new Date().toISOString(),
+        commitSha,
+        gitDirty,
+        baseUrl,
+        appStatus,
+        environment,
+        launchrailVersion: VERSION,
+        journeys,
+    };
+    writeFileSync(join(runDir, "meta.json"), JSON.stringify(meta, null, 2) + "\n", "utf8");
+    writeFileSync(join(runDir, "summary.md"), summaryTemplate({ runId, baseUrl, commitSha, gitDirty, environment, appStatus, journeys }), "utf8");
+    console.log(`\nEvidence bundle scaffolded: artifacts/verification/${runId}/`);
+    console.log("  - summary.md        fill in as journeys complete; check every box you verified");
+    console.log("  - screenshots/      capture key states as you go");
+    console.log("  - traces/           Playwright traces where available");
+    console.log("  - console.log / network-errors.json / test-results.json — write these when relevant");
+    console.log("\nEvery journey must pass the standard checks. Convert real bugs into failing deterministic tests before fixing.");
+    return { code: 0, runDir };
+}
+//# sourceMappingURL=smoke.js.map

package/dist/commands/smoke.js.map

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

package/dist/commands/status.d.ts

@@ -0,0 +1,15 @@
+import { type UpstreamAdvisory } from "../lib/upstream.js";
+import { type PlannedAction } from "../lib/writer.js";
+export interface StatusReport {
+    code: number;
+    errors: string[];
+    cliVersion: string;
+    lockfileVersion: string | null;
+    modules: string[];
+    ejected: string[];
+    actions: PlannedAction[];
+    pendingMigrationIds: string[];
+    advisories: UpstreamAdvisory[];
+}
+export declare function runStatus(cwd: string): StatusReport;
+export declare function printStatus(report: StatusReport): void;

package/dist/commands/status.js

@@ -0,0 +1,91 @@
+import { loadProject, desiredSpecs } from "../lib/project.js";
+import { pendingMigrations } from "../lib/migrations.js";
+import { scanUpstreamReferences } from "../lib/upstream.js";
+import { planWrites } from "../lib/writer.js";
+import { VERSION } from "../version.js";
+export function runStatus(cwd) {
+    const { state, errors } = loadProject(cwd);
+    if (!state) {
+        return {
+            code: 1,
+            errors,
+            cliVersion: VERSION,
+            lockfileVersion: null,
+            modules: [],
+            ejected: [],
+            actions: [],
+            pendingMigrationIds: [],
+            advisories: [],
+        };
+    }
+    return {
+        code: 0,
+        errors: [],
+        cliVersion: VERSION,
+        lockfileVersion: state.lockfile.launchrailVersion,
+        modules: Object.entries(state.manifest.modules)
+            .filter(([, enabled]) => enabled)
+            .map(([name]) => name),
+        ejected: Object.entries(state.lockfile.files)
+            .filter(([, file]) => file.class === "ejected")
+            .map(([relPath]) => relPath),
+        actions: planWrites(cwd, desiredSpecs(state), state.lockfile),
+        pendingMigrationIds: pendingMigrations(state.lockfile).map((m) => m.id),
+        advisories: scanUpstreamReferences(cwd),
+    };
+}
+function fileLine(action) {
+    const path = action.spec.relPath;
+    switch (action.kind) {
+        case "create":
+            return `  missing   ${path} — sync will create it`;
+        case "update":
+            return `  outdated  ${path} — sync will update it`;
+        case "conflict":
+            return `  modified  ${path} — locally modified managed file; sync keeps your version`;
+        case "skip-seeded-exists":
+        case "skip-unchanged":
+            return `  ok        ${path}`;
+        case "skip-ejected":
+            return `  ejected   ${path}`;
+    }
+}
+export function printStatus(report) {
+    if (report.errors.length > 0) {
+        for (const error of report.errors)
+            console.error(`launchrail: ${error}`);
+        return;
+    }
+    console.log(`launchrail ${report.cliVersion} — lockfile written by ${report.lockfileVersion}`);
+    console.log(`  modules: ${report.modules.join(", ")}`);
+    if (report.ejected.length > 0) {
+        console.log(`  ejected: ${report.ejected.join(", ")}`);
+    }
+    console.log("\nFiles:");
+    for (const action of report.actions)
+        console.log(fileLine(action));
+    if (report.pendingMigrationIds.length > 0) {
+        console.log("\nPending migrations:");
+        for (const id of report.pendingMigrationIds)
+            console.log(`  ${id}`);
+    }
+    if (report.advisories.length > 0) {
+        console.log("\nUpstream renames:");
+        for (const advisory of report.advisories) {
+            const note = advisory.rename.note ? ` (${advisory.rename.note})` : "";
+            console.log(`  ${advisory.relPath} references \`${advisory.rename.from}\` — renamed upstream to \`${advisory.rename.to}\`${note}`);
+        }
+    }
+    const updates = report.actions.filter((a) => a.kind === "create" || a.kind === "update").length;
+    const conflicts = report.actions.filter((a) => a.kind === "conflict").length;
+    if (updates + report.pendingMigrationIds.length > 0) {
+        console.log(`\n${updates} update(s) and ${report.pendingMigrationIds.length} migration(s) available — run \`launchrail sync\` (or \`launchrail diff\` to preview).`);
+    }
+    else if (conflicts > 0) {
+        console.log(`\nUp to date; ${conflicts} file(s) carry local modifications (run \`launchrail eject <file>\` to own them permanently).`);
+    }
+    else {
+        console.log("\nEverything up to date.");
+    }
+}
+//# sourceMappingURL=status.js.map

package/dist/commands/status.js.map

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

package/dist/commands/sync.d.ts

@@ -0,0 +1,19 @@
+import { type Migration, type MigrationResult } from "../lib/migrations.js";
+import { type PlannedAction } from "../lib/writer.js";
+export interface SyncOptions {
+    cwd: string;
+    dryRun: boolean;
+    /** Migration registry override for tests; defaults to all shipped migrations. */
+    registry?: Migration[];
+}
+export interface SyncOutcome {
+    code: number;
+    actions: PlannedAction[];
+    migrations: MigrationResult[];
+}
+/**
+ * Bring an initialized project up to the current toolchain: run pending
+ * migrations in order, then regenerate the managed/seeded surface through the
+ * safe writer (unmodified managed files update, local modifications win).
+ */
+export declare function runSync(opts: SyncOptions): SyncOutcome;

package/dist/commands/sync.js

@@ -0,0 +1,83 @@
+import { writeLockfile } from "../lib/lockfile.js";
+import { applyPendingMigrations, MIGRATIONS, planPendingMigrations, } from "../lib/migrations.js";
+import { loadProject, desiredSpecs } from "../lib/project.js";
+import { ACTION_LABEL, applyPlan, planWrites } from "../lib/writer.js";
+import { VERSION } from "../version.js";
+function printActions(actions) {
+    for (const action of actions) {
+        console.log(`  ${ACTION_LABEL[action.kind]}  ${action.spec.relPath}  (${action.detail})`);
+    }
+}
+function reportConflicts(actions) {
+    const conflicts = actions.filter((a) => a.kind === "conflict");
+    if (conflicts.length === 0)
+        return;
+    console.log(`\n${conflicts.length} managed file(s) kept local modifications:`);
+    for (const action of conflicts)
+        console.log(`  ${action.spec.relPath}`);
+    console.log("Revert the local edits to receive updates, or run `launchrail eject <file>` to own them permanently.");
+}
+/**
+ * Bring an initialized project up to the current toolchain: run pending
+ * migrations in order, then regenerate the managed/seeded surface through the
+ * safe writer (unmodified managed files update, local modifications win).
+ */
+export function runSync(opts) {
+    const registry = opts.registry ?? MIGRATIONS;
+    const { state, errors } = loadProject(opts.cwd);
+    if (!state) {
+        for (const error of errors)
+            console.error(`launchrail: ${error}`);
+        return { code: 1, actions: [], migrations: [] };
+    }
+    const ctx = { cwd: opts.cwd, lockfile: state.lockfile };
+    const lockBefore = JSON.stringify(state.lockfile);
+    if (opts.dryRun) {
+        const planned = planPendingMigrations(ctx, registry);
+        if (planned.length > 0) {
+            console.log("Pending migrations:");
+            for (const migration of planned) {
+                console.log(`  ${migration.id} — ${migration.description}`);
+                for (const change of migration.changes)
+                    console.log(`      ${change}`);
+                if (migration.changes.length === 0)
+                    console.log("      already satisfied — will be recorded");
+            }
+            console.log("");
+        }
+        const actions = planWrites(opts.cwd, desiredSpecs(state), state.lockfile);
+        printActions(actions);
+        reportConflicts(actions);
+        console.log("\nDry run — nothing was written.");
+        return { code: 0, actions, migrations: [] };
+    }
+    // Migrations first: structural changes land before the file surface regenerates.
+    const migrations = applyPendingMigrations(ctx, registry);
+    for (const result of migrations) {
+        if (result.status === "failed")
+            continue;
+        const detail = result.status === "applied" ? result.changes.join("; ") : "already satisfied";
+        console.log(`  migrate   ${result.id}  (${detail})`);
+    }
+    const failed = migrations.find((result) => result.status === "failed");
+    if (failed) {
+        if (JSON.stringify(state.lockfile) !== lockBefore)
+            writeLockfile(opts.cwd, state.lockfile);
+        console.error(`\nlaunchrail: migration ${failed.id} failed: ${failed.error}`);
+        console.error("Migrations applied before the failure are recorded; fix the cause and re-run `launchrail sync`.");
+        return { code: 1, actions: [], migrations };
+    }
+    const actions = planWrites(opts.cwd, desiredSpecs(state), state.lockfile);
+    printActions(actions);
+    const written = applyPlan(opts.cwd, actions, state.lockfile);
+    state.lockfile.launchrailVersion = VERSION;
+    if (JSON.stringify(state.lockfile) !== lockBefore)
+        writeLockfile(opts.cwd, state.lockfile);
+    reportConflicts(actions);
+    const migrated = migrations.filter((result) => result.status === "applied").length;
+    console.log(written.length + migrated > 0
+        ? `\nApplied ${migrated} migration(s), wrote ${written.length} file(s).`
+        : "\nEverything already up to date — nothing written.");
+    return { code: 0, actions, migrations };
+}
+//# sourceMappingURL=sync.js.map

package/dist/commands/sync.js.map

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

package/dist/commands/verify.d.ts

@@ -0,0 +1,18 @@
+export interface VerifyStep {
+    name: string;
+    command: string;
+}
+export interface VerifyResult {
+    step: VerifyStep;
+    status: number;
+}
+export interface VerifyOutcome {
+    code: number;
+    results: VerifyResult[];
+}
+/**
+ * Run the project's deterministic verification contract: every configured
+ * check, in order, with a pass/fail summary. Agentic smoke testing is separate
+ * (`launchrail smoke`) — verify is the stable release gate.
+ */
+export declare function runVerify(cwd: string): VerifyOutcome;