@wemuda/launchrail 1.0.0

package/dist/lib/diff.js

@@ -0,0 +1,99 @@
+/**
+ * Minimal line-based diff — enough for `launchrail diff` to preview upstream
+ * changes without a dependency. LCS is quadratic, which is fine at the size
+ * of the files Launchrail manages.
+ */
+function splitLines(text) {
+    const lines = text.split("\n");
+    if (lines[lines.length - 1] === "")
+        lines.pop();
+    return lines;
+}
+export function diffOps(oldText, newText) {
+    const a = splitLines(oldText);
+    const b = splitLines(newText);
+    const n = a.length;
+    const m = b.length;
+    const table = Array.from({ length: n + 1 }, () => new Uint32Array(m + 1));
+    for (let i = n - 1; i >= 0; i--) {
+        const row = table[i];
+        const next = table[i + 1];
+        for (let j = m - 1; j >= 0; j--) {
+            row[j] = a[i] === b[j] ? next[j + 1] + 1 : Math.max(next[j], row[j + 1]);
+        }
+    }
+    const ops = [];
+    let i = 0;
+    let j = 0;
+    while (i < n && j < m) {
+        if (a[i] === b[j]) {
+            ops.push({ kind: "context", text: a[i] });
+            i += 1;
+            j += 1;
+        }
+        else if (table[i + 1][j] >= table[i][j + 1]) {
+            ops.push({ kind: "del", text: a[i] });
+            i += 1;
+        }
+        else {
+            ops.push({ kind: "add", text: b[j] });
+            j += 1;
+        }
+    }
+    while (i < n)
+        ops.push({ kind: "del", text: a[i++] });
+    while (j < m)
+        ops.push({ kind: "add", text: b[j++] });
+    return ops;
+}
+const PREFIX = { context: " ", del: "-", add: "+" };
+/** Unified-diff hunks (no ---/+++ header). Empty string when the texts match. */
+export function formatUnifiedDiff(oldText, newText, context = 3) {
+    if (oldText === newText)
+        return "";
+    const ops = diffOps(oldText, newText);
+    const changed = ops.reduce((acc, op, index) => {
+        if (op.kind !== "context")
+            acc.push(index);
+        return acc;
+    }, []);
+    if (changed.length === 0)
+        return "(only a trailing-newline difference)\n";
+    const ranges = [];
+    for (const index of changed) {
+        const start = Math.max(0, index - context);
+        const end = Math.min(ops.length - 1, index + context);
+        const last = ranges[ranges.length - 1];
+        if (last && start <= last[1] + 1)
+            last[1] = end;
+        else
+            ranges.push([start, end]);
+    }
+    const lines = [];
+    let oldPos = 1;
+    let newPos = 1;
+    let cursor = 0;
+    for (const [start, end] of ranges) {
+        for (; cursor < start; cursor++) {
+            const op = ops[cursor];
+            if (op.kind !== "add")
+                oldPos += 1;
+            if (op.kind !== "del")
+                newPos += 1;
+        }
+        const hunk = ops.slice(start, end + 1);
+        const oldCount = hunk.filter((op) => op.kind !== "add").length;
+        const newCount = hunk.filter((op) => op.kind !== "del").length;
+        lines.push(`@@ -${oldCount === 0 ? oldPos - 1 : oldPos},${oldCount} +${newCount === 0 ? newPos - 1 : newPos},${newCount} @@`);
+        for (; cursor <= end; cursor++) {
+            const op = ops[cursor];
+            lines.push(PREFIX[op.kind] + op.text);
+            if (op.kind !== "add")
+                oldPos += 1;
+            if (op.kind !== "del")
+                newPos += 1;
+        }
+    }
+    return lines.join("\n") + "\n";
+}
+//# sourceMappingURL=diff.js.map

package/dist/lib/diff.js.map

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

package/dist/lib/lockfile.d.ts

@@ -0,0 +1,25 @@
+export declare const LOCKFILE_FILENAME = ".launchrail-lock.json";
+export type OwnershipClass = "managed" | "seeded";
+/**
+ * Tracked files carry an ownership class, or "ejected": a path Launchrail once
+ * wrote and — after `launchrail eject` — will never write again.
+ */
+export type LockedClass = OwnershipClass | "ejected";
+export interface LockedFile {
+    class: LockedClass;
+    checksum: string;
+}
+export interface Lockfile {
+    schemaVersion: 1;
+    launchrailVersion: string;
+    files: Record<string, LockedFile>;
+    migrations: string[];
+    decisions: Record<string, string | number | boolean | null>;
+}
+export declare function emptyLockfile(launchrailVersion: string): Lockfile;
+export interface LockfileReadResult {
+    lockfile: Lockfile | null;
+    error: string | null;
+}
+export declare function readLockfile(root: string): LockfileReadResult;
+export declare function writeLockfile(root: string, lockfile: Lockfile): void;

package/dist/lib/lockfile.js

@@ -0,0 +1,44 @@
+import { existsSync, readFileSync, writeFileSync } from "node:fs";
+import { join } from "node:path";
+export const LOCKFILE_FILENAME = ".launchrail-lock.json";
+export function emptyLockfile(launchrailVersion) {
+    return {
+        schemaVersion: 1,
+        launchrailVersion,
+        files: {},
+        migrations: [],
+        decisions: {},
+    };
+}
+export function readLockfile(root) {
+    const path = join(root, LOCKFILE_FILENAME);
+    if (!existsSync(path))
+        return { lockfile: null, error: null };
+    let data;
+    try {
+        data = JSON.parse(readFileSync(path, "utf8"));
+    }
+    catch (err) {
+        return { lockfile: null, error: `unreadable JSON: ${err instanceof Error ? err.message : String(err)}` };
+    }
+    if (typeof data !== "object" || data === null || data.schemaVersion !== 1) {
+        return { lockfile: null, error: "unsupported lockfile schema" };
+    }
+    const raw = data;
+    return {
+        lockfile: {
+            schemaVersion: 1,
+            launchrailVersion: typeof raw.launchrailVersion === "string" ? raw.launchrailVersion : "0.0.0",
+            files: raw.files ?? {},
+            migrations: raw.migrations ?? [],
+            decisions: raw.decisions ?? {},
+        },
+        error: null,
+    };
+}
+export function writeLockfile(root, lockfile) {
+    const sortedFiles = Object.fromEntries(Object.entries(lockfile.files).sort(([a], [b]) => a.localeCompare(b)));
+    const content = JSON.stringify({ ...lockfile, files: sortedFiles }, null, 2) + "\n";
+    writeFileSync(join(root, LOCKFILE_FILENAME), content, "utf8");
+}
+//# sourceMappingURL=lockfile.js.map

package/dist/lib/lockfile.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"lockfile.js","sourceRoot":"","sources":["../../src/lib/lockfile.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,UAAU,EAAE,YAAY,EAAE,aAAa,EAAE,MAAM,SAAS,CAAC;AAClE,OAAO,EAAE,IAAI,EAAE,MAAM,WAAW,CAAC;AAEjC,MAAM,CAAC,MAAM,iBAAiB,GAAG,uBAAuB,CAAC;AAuBzD,MAAM,UAAU,aAAa,CAAC,iBAAyB;IACrD,OAAO;QACL,aAAa,EAAE,CAAC;QAChB,iBAAiB;QACjB,KAAK,EAAE,EAAE;QACT,UAAU,EAAE,EAAE;QACd,SAAS,EAAE,EAAE;KACd,CAAC;AACJ,CAAC;AAOD,MAAM,UAAU,YAAY,CAAC,IAAY;IACvC,MAAM,IAAI,GAAG,IAAI,CAAC,IAAI,EAAE,iBAAiB,CAAC,CAAC;IAC3C,IAAI,CAAC,UAAU,CAAC,IAAI,CAAC;QAAE,OAAO,EAAE,QAAQ,EAAE,IAAI,EAAE,KAAK,EAAE,IAAI,EAAE,CAAC;IAC9D,IAAI,IAAa,CAAC;IAClB,IAAI,CAAC;QACH,IAAI,GAAG,IAAI,CAAC,KAAK,CAAC,YAAY,CAAC,IAAI,EAAE,MAAM,CAAC,CAAC,CAAC;IAChD,CAAC;IAAC,OAAO,GAAG,EAAE,CAAC;QACb,OAAO,EAAE,QAAQ,EAAE,IAAI,EAAE,KAAK,EAAE,oBAAoB,GAAG,YAAY,KAAK,CAAC,CAAC,CAAC,GAAG,CAAC,OAAO,CAAC,CAAC,CAAC,MAAM,CAAC,GAAG,CAAC,EAAE,EAAE,CAAC;IAC3G,CAAC;IACD,IAAI,OAAO,IAAI,KAAK,QAAQ,IAAI,IAAI,KAAK,IAAI,IAAK,IAAoC,CAAC,aAAa,KAAK,CAAC,EAAE,CAAC;QAC3G,OAAO,EAAE,QAAQ,EAAE,IAAI,EAAE,KAAK,EAAE,6BAA6B,EAAE,CAAC;IAClE,CAAC;IACD,MAAM,GAAG,GAAG,IAAyB,CAAC;IACtC,OAAO;QACL,QAAQ,EAAE;YACR,aAAa,EAAE,CAAC;YAChB,iBAAiB,EAAE,OAAO,GAAG,CAAC,iBAAiB,KAAK,QAAQ,CAAC,CAAC,CAAC,GAAG,CAAC,iBAAiB,CAAC,CAAC,CAAC,OAAO;YAC9F,KAAK,EAAE,GAAG,CAAC,KAAK,IAAI,EAAE;YACtB,UAAU,EAAE,GAAG,CAAC,UAAU,IAAI,EAAE;YAChC,SAAS,EAAE,GAAG,CAAC,SAAS,IAAI,EAAE;SAC/B;QACD,KAAK,EAAE,IAAI;KACZ,CAAC;AACJ,CAAC;AAED,MAAM,UAAU,aAAa,CAAC,IAAY,EAAE,QAAkB;IAC5D,MAAM,WAAW,GAAG,MAAM,CAAC,WAAW,CACpC,MAAM,CAAC,OAAO,CAAC,QAAQ,CAAC,KAAK,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,aAAa,CAAC,CAAC,CAAC,CAAC,CACtE,CAAC;IACF,MAAM,OAAO,GAAG,IAAI,CAAC,SAAS,CAAC,EAAE,GAAG,QAAQ,EAAE,KAAK,EAAE,WAAW,EAAE,EAAE,IAAI,EAAE,CAAC,CAAC,GAAG,IAAI,CAAC;IACpF,aAAa,CAAC,IAAI,CAAC,IAAI,EAAE,iBAAiB,CAAC,EAAE,OAAO,EAAE,MAAM,CAAC,CAAC;AAChE,CAAC"}

package/dist/lib/manifest.d.ts

@@ -0,0 +1,41 @@
+export declare const MANIFEST_FILENAME = ".launchrail.yml";
+export declare const MODES: readonly ["spike", "standard-mvp", "high-rigor"];
+export type Mode = (typeof MODES)[number];
+export declare const ISSUE_TRACKERS: readonly ["github", "linear", "none"];
+export type IssueTracker = (typeof ISSUE_TRACKERS)[number];
+export declare const TESTING_KEYS: readonly ["unitCommand", "devCommand", "e2eCommand", "smokeCommand", "appUrl"];
+export type TestingKey = (typeof TESTING_KEYS)[number];
+export interface Manifest {
+    schemaVersion: 1;
+    mode: Mode;
+    issueTracker: IssueTracker;
+    conventions: {
+        conventionalCommits: boolean;
+    };
+    testing: Record<TestingKey, string | null>;
+    modules: Record<string, boolean>;
+}
+export interface ManifestParseResult {
+    manifest: Manifest | null;
+    errors: string[];
+}
+/**
+ * Strict on the fields that change behavior (schemaVersion, mode), lenient
+ * with defaults on the rest so hand-edited manifests stay valid.
+ */
+export declare function validateManifest(data: unknown): ManifestParseResult;
+export declare function parseManifest(source: string): ManifestParseResult;
+export declare function serializeManifest(manifest: Manifest): string;
+export interface ModuleEnableResult {
+    source: string;
+    changed: boolean;
+}
+/**
+ * Enable a module and record testing commands in an existing manifest source.
+ *
+ * The manifest is seeded (project-owned once created), so this is the one
+ * deliberate exception to "never rewrite seeded files": a user-requested
+ * configuration change, applied via a YAML document round-trip that preserves
+ * the user's comments and formatting.
+ */
+export declare function setModuleEnabled(source: string, module: string, testing: Partial<Record<TestingKey, string | null>>): ModuleEnableResult;

package/dist/lib/manifest.js

@@ -0,0 +1,127 @@
+import { parse, parseDocument, stringify } from "yaml";
+export const MANIFEST_FILENAME = ".launchrail.yml";
+export const MODES = ["spike", "standard-mvp", "high-rigor"];
+export const ISSUE_TRACKERS = ["github", "linear", "none"];
+export const TESTING_KEYS = ["unitCommand", "devCommand", "e2eCommand", "smokeCommand", "appUrl"];
+function isRecord(value) {
+    return typeof value === "object" && value !== null && !Array.isArray(value);
+}
+/**
+ * Strict on the fields that change behavior (schemaVersion, mode), lenient
+ * with defaults on the rest so hand-edited manifests stay valid.
+ */
+export function validateManifest(data) {
+    if (!isRecord(data)) {
+        return { manifest: null, errors: ["manifest must be a YAML mapping"] };
+    }
+    const errors = [];
+    if (data.schemaVersion !== 1) {
+        errors.push(`schemaVersion must be 1 (found ${JSON.stringify(data.schemaVersion ?? null)})`);
+    }
+    if (typeof data.mode !== "string" || !MODES.includes(data.mode)) {
+        errors.push(`mode must be one of: ${MODES.join(", ")}`);
+    }
+    let issueTracker = "none";
+    if (data.issueTracker !== undefined) {
+        if (typeof data.issueTracker === "string" && ISSUE_TRACKERS.includes(data.issueTracker)) {
+            issueTracker = data.issueTracker;
+        }
+        else {
+            errors.push(`issueTracker must be one of: ${ISSUE_TRACKERS.join(", ")}`);
+        }
+    }
+    let conventionalCommits = true;
+    if (data.conventions !== undefined) {
+        if (isRecord(data.conventions) && typeof data.conventions.conventionalCommits === "boolean") {
+            conventionalCommits = data.conventions.conventionalCommits;
+        }
+        else {
+            errors.push("conventions.conventionalCommits must be a boolean");
+        }
+    }
+    const testing = {
+        unitCommand: null,
+        devCommand: null,
+        e2eCommand: null,
+        smokeCommand: null,
+        appUrl: null,
+    };
+    if (data.testing !== undefined) {
+        if (isRecord(data.testing)) {
+            for (const key of TESTING_KEYS) {
+                const value = data.testing[key];
+                if (value === undefined || value === null)
+                    continue;
+                if (typeof value === "string")
+                    testing[key] = value;
+                else
+                    errors.push(`testing.${key} must be a string or null`);
+            }
+        }
+        else {
+            errors.push("testing must be a mapping");
+        }
+    }
+    let modules = { core: true };
+    if (data.modules !== undefined) {
+        if (isRecord(data.modules) && Object.values(data.modules).every((v) => typeof v === "boolean")) {
+            modules = data.modules;
+        }
+        else {
+            errors.push("modules must map module names to booleans");
+        }
+    }
+    if (errors.length > 0)
+        return { manifest: null, errors };
+    return {
+        manifest: {
+            schemaVersion: 1,
+            mode: data.mode,
+            issueTracker,
+            conventions: { conventionalCommits },
+            testing,
+            modules,
+        },
+        errors: [],
+    };
+}
+export function parseManifest(source) {
+    let data;
+    try {
+        data = parse(source);
+    }
+    catch (err) {
+        return { manifest: null, errors: [`invalid YAML: ${err instanceof Error ? err.message : String(err)}`] };
+    }
+    return validateManifest(data);
+}
+export function serializeManifest(manifest) {
+    const header = "# Launchrail project manifest — https://github.com/wemuda/launchrail\n" +
+        "# This file is yours to edit; Launchrail reads it and never force-overwrites it.\n";
+    return header + stringify(manifest);
+}
+/**
+ * Enable a module and record testing commands in an existing manifest source.
+ *
+ * The manifest is seeded (project-owned once created), so this is the one
+ * deliberate exception to "never rewrite seeded files": a user-requested
+ * configuration change, applied via a YAML document round-trip that preserves
+ * the user's comments and formatting.
+ */
+export function setModuleEnabled(source, module, testing) {
+    const doc = parseDocument(source);
+    let changed = false;
+    if (doc.getIn(["modules", module]) !== true) {
+        doc.setIn(["modules", module], true);
+        changed = true;
+    }
+    for (const [key, value] of Object.entries(testing)) {
+        const current = doc.getIn(["testing", key]);
+        if ((current ?? null) !== (value ?? null)) {
+            doc.setIn(["testing", key], value);
+            changed = true;
+        }
+    }
+    return { source: doc.toString(), changed };
+}
+//# sourceMappingURL=manifest.js.map

package/dist/lib/manifest.js.map

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

package/dist/lib/migrations.d.ts

@@ -0,0 +1,47 @@
+import type { Lockfile } from "./lockfile.js";
+export interface MigrationContext {
+    cwd: string;
+    lockfile: Lockfile;
+}
+export interface MigrationPlan {
+    /** Human-readable changes this run would make; empty when already satisfied. */
+    changes: string[];
+    apply: () => void;
+}
+export interface Migration {
+    /** Date-prefixed (`2026-08-plugin-declaration`), so lexicographic order is chronological order. */
+    id: string;
+    description: string;
+    plan(ctx: MigrationContext): MigrationPlan;
+}
+/**
+ * Every structural change ever shipped, in order. Entries must be idempotent —
+ * planning against an already-migrated repository yields no changes — and every
+ * migration's end state must also be produced by the current `init`, which is
+ * why a fresh init stamps the whole registry as applied.
+ */
+export declare const MIGRATIONS: Migration[];
+export declare function migrationIds(registry?: Migration[]): string[];
+/** Migrations not yet recorded in the lockfile, in the order they must run. */
+export declare function pendingMigrations(lockfile: Lockfile, registry?: Migration[]): Migration[];
+export interface PlannedMigration {
+    id: string;
+    description: string;
+    changes: string[];
+}
+/** Dry-run view of what `applyPendingMigrations` would do. Touches nothing. */
+export declare function planPendingMigrations(ctx: MigrationContext, registry?: Migration[]): PlannedMigration[];
+export type MigrationStatus = "applied" | "already-satisfied" | "failed";
+export interface MigrationResult {
+    id: string;
+    description: string;
+    status: MigrationStatus;
+    changes: string[];
+    error: string | null;
+}
+/**
+ * Apply pending migrations in order, recording each in `lockfile.migrations`.
+ * A failure stops the run and is reported; earlier migrations stay recorded so
+ * a re-run resumes exactly where this one stopped.
+ */
+export declare function applyPendingMigrations(ctx: MigrationContext, registry?: Migration[]): MigrationResult[];

package/dist/lib/migrations.js

@@ -0,0 +1,76 @@
+import { applyPluginDeclaration, CLAUDE_SETTINGS_PATH, planPluginDeclaration } from "./claudeSettings.js";
+/**
+ * Every structural change ever shipped, in order. Entries must be idempotent —
+ * planning against an already-migrated repository yields no changes — and every
+ * migration's end state must also be produced by the current `init`, which is
+ * why a fresh init stamps the whole registry as applied.
+ */
+export const MIGRATIONS = [
+    {
+        id: "2026-08-plugin-declaration",
+        description: `declare the Launchrail Claude plugin in ${CLAUDE_SETTINGS_PATH} (ADR-0003)`,
+        plan(ctx) {
+            const settings = planPluginDeclaration(ctx.cwd);
+            if (settings.content === null)
+                return { changes: [], apply: () => { } };
+            return {
+                changes: [`${CLAUDE_SETTINGS_PATH} — ${settings.detail}`],
+                apply: () => {
+                    applyPluginDeclaration(ctx.cwd, settings);
+                },
+            };
+        },
+    },
+];
+export function migrationIds(registry = MIGRATIONS) {
+    return registry.map((migration) => migration.id);
+}
+/** Migrations not yet recorded in the lockfile, in the order they must run. */
+export function pendingMigrations(lockfile, registry = MIGRATIONS) {
+    const applied = new Set(lockfile.migrations);
+    return [...registry].sort((a, b) => a.id.localeCompare(b.id)).filter((m) => !applied.has(m.id));
+}
+/** Dry-run view of what `applyPendingMigrations` would do. Touches nothing. */
+export function planPendingMigrations(ctx, registry = MIGRATIONS) {
+    return pendingMigrations(ctx.lockfile, registry).map((migration) => ({
+        id: migration.id,
+        description: migration.description,
+        changes: migration.plan(ctx).changes,
+    }));
+}
+/**
+ * Apply pending migrations in order, recording each in `lockfile.migrations`.
+ * A failure stops the run and is reported; earlier migrations stay recorded so
+ * a re-run resumes exactly where this one stopped.
+ */
+export function applyPendingMigrations(ctx, registry = MIGRATIONS) {
+    const results = [];
+    for (const migration of pendingMigrations(ctx.lockfile, registry)) {
+        let changes = [];
+        try {
+            const plan = migration.plan(ctx);
+            changes = plan.changes;
+            plan.apply();
+        }
+        catch (err) {
+            results.push({
+                id: migration.id,
+                description: migration.description,
+                status: "failed",
+                changes,
+                error: err instanceof Error ? err.message : String(err),
+            });
+            return results;
+        }
+        ctx.lockfile.migrations.push(migration.id);
+        results.push({
+            id: migration.id,
+            description: migration.description,
+            status: changes.length > 0 ? "applied" : "already-satisfied",
+            changes,
+            error: null,
+        });
+    }
+    return results;
+}
+//# sourceMappingURL=migrations.js.map

package/dist/lib/migrations.js.map

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

package/dist/lib/project.d.ts

@@ -0,0 +1,22 @@
+import { type RepoDetection } from "./detect.js";
+import { type Lockfile } from "./lockfile.js";
+import { type Manifest } from "./manifest.js";
+import type { FileSpec } from "./writer.js";
+export interface ProjectState {
+    manifest: Manifest;
+    lockfile: Lockfile;
+    detection: RepoDetection;
+}
+export interface ProjectLoadResult {
+    state: ProjectState | null;
+    errors: string[];
+}
+/** Load manifest and lockfile — the precondition for status, diff, sync, and eject. */
+export declare function loadProject(cwd: string): ProjectLoadResult;
+/** The files each enabled module contributes at the current version, rendered for this project. */
+export declare function moduleSpecs(state: ProjectState): Record<string, FileSpec[]>;
+/**
+ * The full file surface Launchrail maintains for this configuration —
+ * everything init/add would write today — minus paths the project has ejected.
+ */
+export declare function desiredSpecs(state: ProjectState): FileSpec[];

package/dist/lib/project.js

@@ -0,0 +1,53 @@
+import { readFileSync } from "node:fs";
+import { join } from "node:path";
+import { BROWSER_TESTING_MODULE, browserTestingFiles } from "./browser-testing.js";
+import { detectRepo } from "./detect.js";
+import { LOCKFILE_FILENAME, readLockfile } from "./lockfile.js";
+import { MANIFEST_FILENAME, parseManifest } from "./manifest.js";
+import { RALPH_MODULE, ralphFiles } from "./ralph.js";
+import { seedFiles } from "./seeds.js";
+import { VERSION } from "../version.js";
+/** Load manifest and lockfile — the precondition for status, diff, sync, and eject. */
+export function loadProject(cwd) {
+    const detection = detectRepo(cwd);
+    if (!detection.hasManifest) {
+        return { state: null, errors: [`${MANIFEST_FILENAME} not found — run \`launchrail init\` first.`] };
+    }
+    const parsed = parseManifest(readFileSync(join(cwd, MANIFEST_FILENAME), "utf8"));
+    if (!parsed.manifest) {
+        return { state: null, errors: [`${MANIFEST_FILENAME} is invalid: ${parsed.errors.join("; ")}`] };
+    }
+    const { lockfile, error } = readLockfile(cwd);
+    if (error)
+        return { state: null, errors: [`${LOCKFILE_FILENAME}: ${error}`] };
+    if (!lockfile) {
+        return { state: null, errors: [`${LOCKFILE_FILENAME} not found — run \`launchrail init\` first.`] };
+    }
+    return { state: { manifest: parsed.manifest, lockfile, detection }, errors: [] };
+}
+/** The files each enabled module contributes at the current version, rendered for this project. */
+export function moduleSpecs(state) {
+    const ctx = {
+        projectName: state.detection.projectName,
+        manifest: state.manifest,
+        launchrailVersion: VERSION,
+    };
+    const modules = { core: seedFiles(ctx) };
+    if (state.manifest.modules[BROWSER_TESTING_MODULE]) {
+        modules[BROWSER_TESTING_MODULE] = browserTestingFiles({ manifest: state.manifest, detection: state.detection });
+    }
+    if (state.manifest.modules[RALPH_MODULE]) {
+        modules[RALPH_MODULE] = ralphFiles();
+    }
+    return modules;
+}
+/**
+ * The full file surface Launchrail maintains for this configuration —
+ * everything init/add would write today — minus paths the project has ejected.
+ */
+export function desiredSpecs(state) {
+    return Object.values(moduleSpecs(state))
+        .flat()
+        .filter((spec) => state.lockfile.files[spec.relPath]?.class !== "ejected");
+}
+//# sourceMappingURL=project.js.map

package/dist/lib/project.js.map

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

package/dist/lib/ralph.d.ts

@@ -0,0 +1,12 @@
+import type { FileSpec } from "./writer.js";
+export declare const RALPH_MODULE = "ralph";
+export declare const RALPH_WORKFLOW_PATH = ".claude/workflows/ralph.js";
+export declare function ralphWorkflowContent(): string;
+/**
+ * Everything `launchrail add ralph` writes. The workflow script is managed-class —
+ * it contains toolchain logic only (policy is overridden per run via workflow args,
+ * never by editing the file), so Launchrail may replace it as the loop improves.
+ * The skills half of Ralph (`ralph`, `ralph-implement`, `resolving-merge-conflicts`)
+ * ships through the plugin and writes no files here.
+ */
+export declare function ralphFiles(): FileSpec[];

package/dist/lib/ralph.js

@@ -0,0 +1,21 @@
+import { readFileSync } from "node:fs";
+export const RALPH_MODULE = "ralph";
+export const RALPH_WORKFLOW_PATH = ".claude/workflows/ralph.js";
+// The workflow script ships as a real .js asset (readable, reviewable, syntax-checkable)
+// rather than an inline template string. It resolves from both src/ (tests) and dist/
+// (published CLI) because the two are sibling directories of assets/.
+const WORKFLOW_ASSET_URL = new URL("../../assets/ralph.workflow.js", import.meta.url);
+export function ralphWorkflowContent() {
+    return readFileSync(WORKFLOW_ASSET_URL, "utf8");
+}
+/**
+ * Everything `launchrail add ralph` writes. The workflow script is managed-class —
+ * it contains toolchain logic only (policy is overridden per run via workflow args,
+ * never by editing the file), so Launchrail may replace it as the loop improves.
+ * The skills half of Ralph (`ralph`, `ralph-implement`, `resolving-merge-conflicts`)
+ * ships through the plugin and writes no files here.
+ */
+export function ralphFiles() {
+    return [{ relPath: RALPH_WORKFLOW_PATH, content: ralphWorkflowContent(), ownership: "managed" }];
+}
+//# sourceMappingURL=ralph.js.map

package/dist/lib/ralph.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"ralph.js","sourceRoot":"","sources":["../../src/lib/ralph.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,YAAY,EAAE,MAAM,SAAS,CAAC;AAGvC,MAAM,CAAC,MAAM,YAAY,GAAG,OAAO,CAAC;AACpC,MAAM,CAAC,MAAM,mBAAmB,GAAG,4BAA4B,CAAC;AAEhE,yFAAyF;AACzF,sFAAsF;AACtF,sEAAsE;AACtE,MAAM,kBAAkB,GAAG,IAAI,GAAG,CAAC,gCAAgC,EAAE,MAAM,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC;AAEtF,MAAM,UAAU,oBAAoB;IAClC,OAAO,YAAY,CAAC,kBAAkB,EAAE,MAAM,CAAC,CAAC;AAClD,CAAC;AAED;;;;;;GAMG;AACH,MAAM,UAAU,UAAU;IACxB,OAAO,CAAC,EAAE,OAAO,EAAE,mBAAmB,EAAE,OAAO,EAAE,oBAAoB,EAAE,EAAE,SAAS,EAAE,SAAS,EAAE,CAAC,CAAC;AACnG,CAAC"}

package/dist/lib/seeds.d.ts

@@ -0,0 +1,11 @@
+import type { Manifest } from "./manifest.js";
+import type { FileSpec } from "./writer.js";
+export interface SeedContext {
+    projectName: string;
+    manifest: Manifest;
+    launchrailVersion: string;
+}
+/** The managed Claude instructions file — regenerated whenever module configuration changes. */
+export declare function claudeGeneratedFile(ctx: SeedContext): FileSpec;
+/** Everything init seeds beyond the manifest and lockfile. */
+export declare function seedFiles(ctx: SeedContext): FileSpec[];