@wemuda/launchrail 1.0.0

package/dist/commands/verify.js

@@ -0,0 +1,50 @@
+import { spawnSync } from "node:child_process";
+import { existsSync, readFileSync } from "node:fs";
+import { join } from "node:path";
+import { BROWSER_TESTING_MODULE } from "../lib/browser-testing.js";
+import { MANIFEST_FILENAME, parseManifest } from "../lib/manifest.js";
+/**
+ * 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 function runVerify(cwd) {
+    const manifestPath = join(cwd, MANIFEST_FILENAME);
+    if (!existsSync(manifestPath)) {
+        console.error(`launchrail: ${MANIFEST_FILENAME} not found — run \`launchrail init\` first.`);
+        return { code: 1, results: [] };
+    }
+    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, results: [] };
+    }
+    const { testing, modules } = parsed.manifest;
+    const steps = [];
+    if (testing.unitCommand)
+        steps.push({ name: "unit", command: testing.unitCommand });
+    if (modules[BROWSER_TESTING_MODULE] && testing.e2eCommand) {
+        steps.push({ name: "e2e", command: testing.e2eCommand });
+    }
+    if (steps.length === 0) {
+        console.error("launchrail: no verification commands configured — set testing.unitCommand (and testing.e2eCommand) in " +
+            `${MANIFEST_FILENAME}. An empty verification contract cannot pass.`);
+        return { code: 1, results: [] };
+    }
+    const results = [];
+    for (const step of steps) {
+        console.log(`\n→ ${step.name}: ${step.command}`);
+        const run = spawnSync(step.command, { cwd, shell: true, stdio: "inherit" });
+        results.push({ step, status: run.status ?? 1 });
+    }
+    console.log("");
+    for (const { step, status } of results) {
+        console.log(`  ${status === 0 ? "✓" : "✗"} ${step.name} (${step.command})`);
+    }
+    const failed = results.filter((r) => r.status !== 0).length;
+    console.log(failed === 0 ? "\nVerification passed." : `\nVerification failed: ${failed} of ${results.length} step(s).`);
+    return { code: failed === 0 ? 0 : 1, results };
+}
+//# sourceMappingURL=verify.js.map

package/dist/commands/verify.js.map

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

package/dist/index.d.ts

@@ -0,0 +1,2 @@
+#!/usr/bin/env node
+export {};

package/dist/index.js

@@ -0,0 +1,127 @@
+#!/usr/bin/env node
+import { AVAILABLE_MODULES, runAdd } from "./commands/add.js";
+import { printDiff, runDiff } from "./commands/diff.js";
+import { runDoctor, printDoctor } from "./commands/doctor.js";
+import { runEject } from "./commands/eject.js";
+import { runInit } from "./commands/init.js";
+import { runSmoke } from "./commands/smoke.js";
+import { printStatus, runStatus } from "./commands/status.js";
+import { runSync } from "./commands/sync.js";
+import { runVerify } from "./commands/verify.js";
+import { VERSION } from "./version.js";
+const HELP = `launchrail ${VERSION} — an updatable development system for AI-assisted projects
+
+Usage: launchrail <command> [options]
+
+Commands:
+  init      Initialize Launchrail in a new or existing repository
+  doctor    Validate the repository and environment
+  add       Add a module to the project (available: ${AVAILABLE_MODULES.join(", ")})
+  verify    Run the deterministic verification contract
+  smoke     Scaffold an evidence bundle for an agentic browser smoke run
+  status    Inspect versions, enabled modules, drift, and missing requirements
+  diff      Preview upstream changes
+  sync      Synchronize managed capabilities and run migrations
+  eject     Stop managing a selected module or file
+  promote   Inspect potential reusable local improvements
+
+Options:
+  -h, --help       Show this help
+  -v, --version    Show version
+
+init / add options:
+  --dry-run        Show what would be written without writing
+  -y, --yes        Accept defaults; no interactive questions
+
+smoke options:
+  --url <url>      Test a specific URL (e.g. a preview environment)
+  --dry-run        Show what would be scaffolded without writing
+
+sync options:
+  --dry-run        Preview migrations and file updates without writing
+
+eject usage:
+  launchrail eject <module|file> [--dry-run]   Stop managing a module's files or one file
+  launchrail eject --all [--dry-run]           Vendor mode: eject everything`;
+const NOT_IMPLEMENTED = ["promote"];
+const args = process.argv.slice(2);
+const command = args[0];
+const flags = new Set(args.slice(1));
+if (command === undefined || command === "-h" || command === "--help" || command === "help") {
+    console.log(HELP);
+    process.exit(0);
+}
+if (command === "-v" || command === "--version" || command === "version") {
+    console.log(VERSION);
+    process.exit(0);
+}
+if (command === "init") {
+    const outcome = await runInit({
+        cwd: process.cwd(),
+        dryRun: flags.has("--dry-run"),
+        yes: flags.has("--yes") || flags.has("-y"),
+    });
+    process.exit(outcome.code);
+}
+if (command === "doctor") {
+    const outcome = runDoctor(process.cwd());
+    printDoctor(outcome);
+    process.exit(outcome.code);
+}
+if (command === "add") {
+    const module = args[1] !== undefined && !args[1].startsWith("-") ? args[1] : null;
+    if (!module) {
+        console.error(`launchrail: usage: launchrail add <module> — available modules: ${AVAILABLE_MODULES.join(", ")}`);
+        process.exit(1);
+    }
+    const outcome = await runAdd({
+        cwd: process.cwd(),
+        module,
+        dryRun: flags.has("--dry-run"),
+        yes: flags.has("--yes") || flags.has("-y"),
+    });
+    process.exit(outcome.code);
+}
+if (command === "verify") {
+    process.exit(runVerify(process.cwd()).code);
+}
+if (command === "status") {
+    const report = runStatus(process.cwd());
+    printStatus(report);
+    process.exit(report.code);
+}
+if (command === "diff") {
+    const outcome = runDiff(process.cwd());
+    printDiff(outcome);
+    process.exit(outcome.code);
+}
+if (command === "sync") {
+    process.exit(runSync({ cwd: process.cwd(), dryRun: flags.has("--dry-run") }).code);
+}
+if (command === "eject") {
+    const target = args[1] !== undefined && !args[1].startsWith("-") ? args[1] : null;
+    const outcome = runEject({
+        cwd: process.cwd(),
+        target,
+        all: flags.has("--all"),
+        dryRun: flags.has("--dry-run"),
+    });
+    process.exit(outcome.code);
+}
+if (command === "smoke") {
+    const urlIndex = args.indexOf("--url");
+    const outcome = await runSmoke({
+        cwd: process.cwd(),
+        url: urlIndex !== -1 ? (args[urlIndex + 1] ?? null) : null,
+        dryRun: flags.has("--dry-run"),
+    });
+    process.exit(outcome.code);
+}
+if (NOT_IMPLEMENTED.includes(command)) {
+    console.error(`launchrail: "${command}" is not implemented yet.`);
+    process.exit(1);
+}
+console.error(`launchrail: unknown command "${command}"\n`);
+console.error(HELP);
+process.exit(1);
+//# sourceMappingURL=index.js.map

package/dist/index.js.map

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

package/dist/lib/browser-testing.d.ts

@@ -0,0 +1,16 @@
+import type { RepoDetection } from "./detect.js";
+import type { Manifest } from "./manifest.js";
+import type { FileSpec } from "./writer.js";
+export declare const BROWSER_TESTING_MODULE = "browser-testing";
+export declare const SMOKE_JOURNEYS_PATH = "docs/testing/smoke-journeys.md";
+export declare const SEMANTIC_SCRIPTS: readonly ["setup", "dev", "verify", "smoke", "doctor"];
+export interface BrowserTestingContext {
+    manifest: Manifest;
+    detection: RepoDetection;
+}
+/**
+ * Everything `launchrail add browser-testing` seeds. All files are seeded-class:
+ * created once, then project-owned. An existing Playwright config means the
+ * project already has an E2E layer — keep it, seed neither config nor baseline.
+ */
+export declare function browserTestingFiles(ctx: BrowserTestingContext): FileSpec[];

package/dist/lib/browser-testing.js

@@ -0,0 +1,170 @@
+export const BROWSER_TESTING_MODULE = "browser-testing";
+export const SMOKE_JOURNEYS_PATH = "docs/testing/smoke-journeys.md";
+export const SEMANTIC_SCRIPTS = ["setup", "dev", "verify", "smoke", "doctor"];
+const DEFAULT_APP_URL = "http://localhost:3000";
+function playwrightConfig(manifest) {
+    const appUrl = manifest.testing.appUrl ?? DEFAULT_APP_URL;
+    const webServer = manifest.testing.devCommand
+        ? `  webServer: {
+    command: ${JSON.stringify(manifest.testing.devCommand)},
+    url: baseURL,
+    reuseExistingServer: !process.env.CI,
+  },
+`
+        : `  // webServer: { command: "npm run dev", url: baseURL, reuseExistingServer: !process.env.CI },
+`;
+    return `import { defineConfig } from "@playwright/test";
+
+// Seeded by Launchrail — this file is yours to adapt.
+const baseURL = process.env.PLAYWRIGHT_BASE_URL ?? ${JSON.stringify(appUrl)};
+
+export default defineConfig({
+  testDir: "tests/e2e",
+  reporter: [["list"], ["html", { open: "never" }]],
+  use: {
+    baseURL,
+    trace: "retain-on-failure",
+    screenshot: "only-on-failure",
+  },
+${webServer}});
+`;
+}
+function smokeSpec() {
+    return `import { expect, test } from "@playwright/test";
+
+// Seeded by Launchrail — the E2E baseline: the app starts, responds, and renders
+// without console errors. Extend or replace with real journeys as they stabilize.
+test("app starts and renders without console errors", async ({ page }) => {
+  const errors: string[] = [];
+  page.on("pageerror", (error) => errors.push(String(error)));
+  page.on("console", (message) => {
+    if (message.type() === "error") errors.push(message.text());
+  });
+
+  const response = await page.goto("/");
+  expect(response?.ok(), "app must respond successfully on baseURL").toBe(true);
+  await expect(page.locator("body")).toBeVisible();
+  expect(errors).toEqual([]);
+});
+`;
+}
+function smokeJourneysDoc() {
+    return `# Smoke journeys
+
+Seeded by Launchrail — this file is yours. It is the smoke-journey contract: the
+concrete user journeys an agent drives through the real app in a browser before
+user-facing work counts as done.
+
+- Every ticket that changes user-facing behavior adds or updates a journey here
+  (or defines one in the ticket itself).
+- Each journey heading starts with \`## Journey:\` so tools can list them —
+  \`npx @wemuda/launchrail smoke\` scaffolds an evidence bundle from this file.
+- Agentic smoke testing supplements deterministic tests; it never replaces them.
+  When a smoke run finds a real bug: record the reproduction, add a failing
+  deterministic test, fix the bug, prove the test passes, re-run the journey.
+
+Every journey is verified against the standard checks plus its own list:
+
+- No uncaught console errors
+- No failed API requests
+- The success state is visible
+- Data remains after refresh
+
+## Journey: App loads
+
+- startAt: /
+- actor: anonymous
+
+Steps:
+
+1. Open the app root.
+2. Confirm the main content renders.
+
+Verify:
+
+- The page shows meaningful content, not an error screen.
+`;
+}
+const ADD_PLAYWRIGHT_DEP = {
+    pnpm: "pnpm add -D @playwright/test",
+    yarn: "yarn add -D @playwright/test",
+    bun: "bun add -d @playwright/test",
+    npm: "npm install -D @playwright/test",
+};
+function setupScript(pm) {
+    return `#!/usr/bin/env node
+// Seeded by Launchrail — yours to adapt. Prepares a fresh clone for local, CI, or cloud work.
+import { spawnSync } from "node:child_process";
+import { existsSync } from "node:fs";
+
+const cloud = process.argv.includes("--cloud") || process.env.CLAUDE_CODE_REMOTE === "true" || !!process.env.CI;
+
+function run(command) {
+  console.log("\\n$ " + command);
+  const result = spawnSync(command, { shell: true, stdio: "inherit" });
+  if (result.status !== 0) process.exit(result.status ?? 1);
+}
+
+run("${pm} install");
+if (!existsSync("node_modules/@playwright/test")) {
+  run("${ADD_PLAYWRIGHT_DEP[pm]}");
+}
+// Cloud and CI machines need browser OS dependencies; local machines usually have them.
+run(cloud ? "npx playwright install --with-deps chromium" : "npx playwright install chromium");
+console.log("\\nSetup complete. Next: node scripts/doctor.mjs");
+`;
+}
+function devScript(devCommand) {
+    return `#!/usr/bin/env node
+// Seeded by Launchrail — yours to adapt. Starts the app for development and testing.
+import { spawn, spawnSync } from "node:child_process";
+import { mkdirSync, openSync } from "node:fs";
+
+const DEV_COMMAND = ${JSON.stringify(devCommand ?? "")};
+if (DEV_COMMAND === "") {
+  console.error("No dev command configured. Edit scripts/dev.mjs and set DEV_COMMAND to whatever starts this app.");
+  process.exit(1);
+}
+
+if (process.argv.includes("--background")) {
+  // Cloud and CI sessions need the app running without holding the terminal.
+  mkdirSync(".launchrail/state", { recursive: true });
+  const log = openSync(".launchrail/state/dev.log", "a");
+  const child = spawn(DEV_COMMAND, { shell: true, detached: true, stdio: ["ignore", log, log] });
+  child.unref();
+  console.log("Started \`" + DEV_COMMAND + "\` in the background (pid " + child.pid + "). Logs: .launchrail/state/dev.log");
+} else {
+  const result = spawnSync(DEV_COMMAND, { shell: true, stdio: "inherit" });
+  process.exit(result.status ?? 0);
+}
+`;
+}
+/** Stable semantic entry point that delegates to the Launchrail CLI. */
+function delegatingScript(subcommand) {
+    return `#!/usr/bin/env node
+// Seeded by Launchrail — stable entry point for humans, CI, and agents; delegates to the Launchrail CLI.
+import { spawnSync } from "node:child_process";
+
+const result = spawnSync(
+  "npx",
+  ["@wemuda/launchrail", "${subcommand}", ...process.argv.slice(2)],
+  { shell: process.platform === "win32", stdio: "inherit" },
+);
+process.exit(result.status ?? 1);
+`;
+}
+/**
+ * Everything `launchrail add browser-testing` seeds. All files are seeded-class:
+ * created once, then project-owned. An existing Playwright config means the
+ * project already has an E2E layer — keep it, seed neither config nor baseline.
+ */
+export function browserTestingFiles(ctx) {
+    const pm = ctx.detection.packageManager ?? "npm";
+    const specs = [];
+    if (!ctx.detection.playwrightConfigFile) {
+        specs.push({ relPath: "playwright.config.ts", content: playwrightConfig(ctx.manifest), ownership: "seeded" }, { relPath: "tests/e2e/smoke.spec.ts", content: smokeSpec(), ownership: "seeded" });
+    }
+    specs.push({ relPath: SMOKE_JOURNEYS_PATH, content: smokeJourneysDoc(), ownership: "seeded" }, { relPath: "scripts/setup.mjs", content: setupScript(pm), ownership: "seeded", executable: true }, { relPath: "scripts/dev.mjs", content: devScript(ctx.manifest.testing.devCommand), ownership: "seeded", executable: true }, { relPath: "scripts/verify.mjs", content: delegatingScript("verify"), ownership: "seeded", executable: true }, { relPath: "scripts/smoke.mjs", content: delegatingScript("smoke"), ownership: "seeded", executable: true }, { relPath: "scripts/doctor.mjs", content: delegatingScript("doctor"), ownership: "seeded", executable: true });
+    return specs;
+}
+//# sourceMappingURL=browser-testing.js.map

package/dist/lib/browser-testing.js.map

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

package/dist/lib/checksum.d.ts

@@ -0,0 +1 @@
+export declare function sha256(content: string): string;

package/dist/lib/checksum.js

@@ -0,0 +1,5 @@
+import { createHash } from "node:crypto";
+export function sha256(content) {
+    return createHash("sha256").update(content, "utf8").digest("hex");
+}
+//# sourceMappingURL=checksum.js.map

package/dist/lib/checksum.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"checksum.js","sourceRoot":"","sources":["../../src/lib/checksum.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,UAAU,EAAE,MAAM,aAAa,CAAC;AAEzC,MAAM,UAAU,MAAM,CAAC,OAAe;IACpC,OAAO,UAAU,CAAC,QAAQ,CAAC,CAAC,MAAM,CAAC,OAAO,EAAE,MAAM,CAAC,CAAC,MAAM,CAAC,KAAK,CAAC,CAAC;AACpE,CAAC"}

package/dist/lib/claudeSettings.d.ts

@@ -0,0 +1,21 @@
+/**
+ * Consuming projects subscribe to the Launchrail plugin through a committed,
+ * project-scoped declaration in .claude/settings.json (ADR-0003). The file is
+ * project-owned and shared with unrelated Claude Code configuration, so it is
+ * never tracked in the lockfile and never replaced: init only performs an
+ * additive merge of the two keys below, and an explicit opt-out
+ * (`"launchrail@launchrail": false`) is respected.
+ */
+export declare const CLAUDE_SETTINGS_PATH: string;
+export type DeclarationState = "declared" | "no-file" | "invalid-json" | "undeclared";
+export declare function declarationState(root: string): DeclarationState;
+export type SettingsPlanKind = "create" | "merge" | "skip-declared" | "skip-invalid";
+export interface SettingsPlan {
+    kind: SettingsPlanKind;
+    detail: string;
+    /** Full file content to write; null when nothing should change. */
+    content: string | null;
+}
+export declare function planPluginDeclaration(root: string): SettingsPlan;
+/** Execute a plan. Returns true when the file was written. */
+export declare function applyPluginDeclaration(root: string, plan: SettingsPlan): boolean;

package/dist/lib/claudeSettings.js

@@ -0,0 +1,71 @@
+import { existsSync, mkdirSync, readFileSync, writeFileSync } from "node:fs";
+import { dirname, join } from "node:path";
+/**
+ * Consuming projects subscribe to the Launchrail plugin through a committed,
+ * project-scoped declaration in .claude/settings.json (ADR-0003). The file is
+ * project-owned and shared with unrelated Claude Code configuration, so it is
+ * never tracked in the lockfile and never replaced: init only performs an
+ * additive merge of the two keys below, and an explicit opt-out
+ * (`"launchrail@launchrail": false`) is respected.
+ */
+export const CLAUDE_SETTINGS_PATH = join(".claude", "settings.json");
+const MARKETPLACE_NAME = "launchrail";
+const PLUGIN_KEY = "launchrail@launchrail";
+const MARKETPLACE_SOURCE = { source: "github", repo: "wemuda/launchrail" };
+function readSettings(root) {
+    const path = join(root, CLAUDE_SETTINGS_PATH);
+    if (!existsSync(path))
+        return { settings: null, state: "no-file" };
+    let data;
+    try {
+        data = JSON.parse(readFileSync(path, "utf8"));
+    }
+    catch {
+        return { settings: null, state: "invalid-json" };
+    }
+    if (typeof data !== "object" || data === null || Array.isArray(data)) {
+        return { settings: null, state: "invalid-json" };
+    }
+    const settings = data;
+    const declared = settings.extraKnownMarketplaces?.[MARKETPLACE_NAME] !== undefined &&
+        settings.enabledPlugins?.[PLUGIN_KEY] !== undefined;
+    return { settings, state: declared ? "declared" : "undeclared" };
+}
+export function declarationState(root) {
+    return readSettings(root).state;
+}
+export function planPluginDeclaration(root) {
+    const { settings, state } = readSettings(root);
+    if (state === "invalid-json") {
+        return { kind: "skip-invalid", detail: "unparseable JSON — not touching it", content: null };
+    }
+    if (state === "declared") {
+        return { kind: "skip-declared", detail: "plugin already declared", content: null };
+    }
+    const merged = settings ? { ...settings } : {};
+    merged.extraKnownMarketplaces = { ...merged.extraKnownMarketplaces };
+    if (merged.extraKnownMarketplaces[MARKETPLACE_NAME] === undefined) {
+        merged.extraKnownMarketplaces[MARKETPLACE_NAME] = { source: MARKETPLACE_SOURCE };
+    }
+    merged.enabledPlugins = { ...merged.enabledPlugins };
+    if (merged.enabledPlugins[PLUGIN_KEY] === undefined) {
+        merged.enabledPlugins[PLUGIN_KEY] = true;
+    }
+    return {
+        kind: state === "no-file" ? "create" : "merge",
+        detail: state === "no-file"
+            ? "declares the Launchrail plugin for this project"
+            : "adding the Launchrail plugin declaration, keeping existing settings",
+        content: JSON.stringify(merged, null, 2) + "\n",
+    };
+}
+/** Execute a plan. Returns true when the file was written. */
+export function applyPluginDeclaration(root, plan) {
+    if (plan.content === null)
+        return false;
+    const abs = join(root, CLAUDE_SETTINGS_PATH);
+    mkdirSync(dirname(abs), { recursive: true });
+    writeFileSync(abs, plan.content, "utf8");
+    return true;
+}
+//# sourceMappingURL=claudeSettings.js.map

package/dist/lib/claudeSettings.js.map

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

package/dist/lib/detect.d.ts

@@ -0,0 +1,23 @@
+export type PackageManager = "pnpm" | "yarn" | "bun" | "npm";
+export interface RepoDetection {
+    isGitRepo: boolean;
+    gitRemoteUrl: string | null;
+    /** Share of the last 20 commit subjects following Conventional Commits; null when there is no history. */
+    conventionalCommitRatio: number | null;
+    packageManager: PackageManager | null;
+    hasPackageJson: boolean;
+    packageName: string | null;
+    testScript: string | null;
+    devScript: string | null;
+    /** `@playwright/test` (or `playwright`) declared in dependencies/devDependencies. */
+    hasPlaywrightDep: boolean;
+    /** First `playwright.config.*` found at the repo root, if any. */
+    playwrightConfigFile: string | null;
+    projectName: string;
+    hasAgentsMd: boolean;
+    hasClaudeMd: boolean;
+    hasManifest: boolean;
+    /** docs/agents/ is the output location of Matt Pocock's /setup-matt-pocock-skills. */
+    hasMattPocockSetup: boolean;
+}
+export declare function detectRepo(root: string): RepoDetection;

package/dist/lib/detect.js

@@ -0,0 +1,88 @@
+import { execFileSync } from "node:child_process";
+import { existsSync, readFileSync } from "node:fs";
+import { basename, join } from "node:path";
+import { MANIFEST_FILENAME } from "./manifest.js";
+function git(root, args) {
+    try {
+        return execFileSync("git", args, {
+            cwd: root,
+            encoding: "utf8",
+            stdio: ["ignore", "pipe", "ignore"],
+        }).trim();
+    }
+    catch {
+        return null;
+    }
+}
+const CONVENTIONAL_SUBJECT = /^(feat|fix|docs|style|refactor|perf|test|build|ci|chore|revert)(\([^)]*\))?!?:\s/;
+export function detectRepo(root) {
+    const isGitRepo = git(root, ["rev-parse", "--is-inside-work-tree"]) === "true";
+    const gitRemoteUrl = isGitRepo ? git(root, ["remote", "get-url", "origin"]) : null;
+    let conventionalCommitRatio = null;
+    if (isGitRepo) {
+        const log = git(root, ["log", "-n", "20", "--format=%s"]);
+        const subjects = log ? log.split("\n").filter(Boolean) : [];
+        if (subjects.length > 0) {
+            conventionalCommitRatio = subjects.filter((s) => CONVENTIONAL_SUBJECT.test(s)).length / subjects.length;
+        }
+    }
+    const hasPackageJson = existsSync(join(root, "package.json"));
+    let packageName = null;
+    let testScript = null;
+    let devScript = null;
+    let hasPlaywrightDep = false;
+    let packageManagerField = null;
+    if (hasPackageJson) {
+        try {
+            const pkg = JSON.parse(readFileSync(join(root, "package.json"), "utf8"));
+            if (typeof pkg.name === "string")
+                packageName = pkg.name;
+            if (typeof pkg.scripts?.test === "string")
+                testScript = pkg.scripts.test;
+            if (typeof pkg.scripts?.dev === "string")
+                devScript = pkg.scripts.dev;
+            if (typeof pkg.packageManager === "string")
+                packageManagerField = pkg.packageManager;
+            const deps = { ...pkg.dependencies, ...pkg.devDependencies };
+            hasPlaywrightDep = "@playwright/test" in deps || "playwright" in deps;
+        }
+        catch {
+            // Malformed package.json is doctor's problem, not detection's.
+        }
+    }
+    const playwrightConfigFile = ["ts", "js", "mjs", "cjs", "mts", "cts"]
+        .map((ext) => `playwright.config.${ext}`)
+        .find((file) => existsSync(join(root, file))) ?? null;
+    let packageManager = null;
+    if (existsSync(join(root, "pnpm-lock.yaml")))
+        packageManager = "pnpm";
+    else if (existsSync(join(root, "yarn.lock")))
+        packageManager = "yarn";
+    else if (existsSync(join(root, "bun.lock")) || existsSync(join(root, "bun.lockb")))
+        packageManager = "bun";
+    else if (existsSync(join(root, "package-lock.json")))
+        packageManager = "npm";
+    else if (packageManagerField) {
+        const prefix = packageManagerField.split("@")[0];
+        if (prefix === "pnpm" || prefix === "yarn" || prefix === "bun" || prefix === "npm")
+            packageManager = prefix;
+    }
+    return {
+        isGitRepo,
+        gitRemoteUrl,
+        conventionalCommitRatio,
+        packageManager,
+        hasPackageJson,
+        packageName,
+        testScript,
+        devScript,
+        hasPlaywrightDep,
+        playwrightConfigFile,
+        projectName: packageName ?? basename(root),
+        hasAgentsMd: existsSync(join(root, "AGENTS.md")),
+        hasClaudeMd: existsSync(join(root, "CLAUDE.md")),
+        hasManifest: existsSync(join(root, MANIFEST_FILENAME)),
+        hasMattPocockSetup: existsSync(join(root, "docs", "agents")),
+    };
+}
+//# sourceMappingURL=detect.js.map

package/dist/lib/detect.js.map

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

package/dist/lib/diff.d.ts

@@ -0,0 +1,12 @@
+/**
+ * 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.
+ */
+export interface DiffOp {
+    kind: "context" | "del" | "add";
+    text: string;
+}
+export declare function diffOps(oldText: string, newText: string): DiffOp[];
+/** Unified-diff hunks (no ---/+++ header). Empty string when the texts match. */
+export declare function formatUnifiedDiff(oldText: string, newText: string, context?: number): string;