@isaacriehm/cairn-core 0.1.0

package/dist/init/brand-setup.js

@@ -0,0 +1,201 @@
+/**
+ * Phase 5b — interactive brand setup.
+ *
+ * After seedCairnLayout writes the templates with `status: draft`, ask the
+ * operator 4 quick questions and flip the answered files to `status: current`.
+ *
+ * Skipped questions stay draft. Ctrl+C / EOF anywhere mid-flow exits gracefully
+ * (whatever was answered before the abort sticks; the rest stay draft).
+ *
+ * Uses node:readline/promises — no new deps.
+ */
+import { existsSync, readFileSync, writeFileSync } from "node:fs";
+import { join } from "node:path";
+import { createInterface } from "node:readline/promises";
+import { stdin, stdout } from "node:process";
+const EMPTY = {
+    whatItDoes: "",
+    mainUsers: "",
+    voice: "",
+    avoid: "",
+};
+/**
+ * Run the 4-question wizard. Returns whatever answers the operator provided
+ * (empty string for skipped questions). Always resolves; never throws on
+ * Ctrl+C / EOF — the partial answers up to the abort are returned.
+ */
+export async function runBrandSetup(opts) {
+    if (opts.skip === true) {
+        return { ...EMPTY, ...(opts.scriptedAnswers ?? {}) };
+    }
+    if (opts.scriptedAnswers !== undefined) {
+        return { ...EMPTY, ...opts.scriptedAnswers };
+    }
+    stdout.write("\n  ✓ Files written.\n\n");
+    stdout.write("  Fill in your project brain — 4 quick questions.\n");
+    stdout.write("  Press Enter to skip any. Fill the rest later with: cairn configure\n\n");
+    const rl = createInterface({
+        input: stdin,
+        output: stdout,
+        terminal: stdin.isTTY === true,
+    });
+    // Ctrl+C inside readline emits SIGINT but rl.question() doesn't reject by
+    // default — install our own handler so the operator can abort cleanly.
+    rl.on("SIGINT", () => {
+        rl.close();
+        stdout.write(`\n  ⚠ cancelled\n`);
+        process.exit(130);
+    });
+    const answers = { ...EMPTY };
+    try {
+        answers.whatItDoes = await ask(rl, `  What does ${opts.projectName} do? (one sentence)\n  › `);
+        answers.mainUsers = await ask(rl, `\n  Who are the main users?\n  › `);
+        answers.voice = await ask(rl, `\n  How should Claude communicate in this project? (tone, style)\n  › `);
+        answers.avoid = await ask(rl, `\n  Anything Claude should never do here?\n  › `);
+    }
+    catch {
+        // EOF / Ctrl+C / readline closed — keep whatever we got, return.
+    }
+    finally {
+        rl.close();
+    }
+    return answers;
+}
+async function ask(rl, prompt) {
+    const reply = await rl.question(prompt);
+    return reply.trim();
+}
+/**
+ * Apply answers to the seeded templates. Empty answers are no-ops; only
+ * answered files flip from `status: draft` to `status: current`.
+ *
+ * Returns the list of files that were actually rewritten.
+ */
+export function applyBrandAnswers(repoRoot, answers) {
+    const updated = [];
+    const warnings = [];
+    if (answers.whatItDoes.length > 0) {
+        const rel = ".cairn/ground/product/positioning.md";
+        const ok = rewriteWithBody(join(repoRoot, rel), answers.whatItDoes, warnings, rel);
+        if (ok)
+            updated.push(rel);
+    }
+    if (answers.mainUsers.length > 0) {
+        const rel = ".cairn/ground/product/personas.yaml";
+        const ok = rewritePersonas(join(repoRoot, rel), answers.mainUsers, warnings, rel);
+        if (ok)
+            updated.push(rel);
+    }
+    if (answers.voice.length > 0 || answers.avoid.length > 0) {
+        const rel = ".cairn/ground/brand/voice.md";
+        const ok = rewriteVoice(join(repoRoot, rel), answers.voice, answers.avoid, warnings, rel);
+        if (ok)
+            updated.push(rel);
+    }
+    return { updated, warnings };
+}
+function rewriteWithBody(abs, body, warnings, rel) {
+    if (!existsSync(abs)) {
+        warnings.push(`brand-setup: ${rel} missing — skipping`);
+        return false;
+    }
+    let text;
+    try {
+        text = readFileSync(abs, "utf8");
+    }
+    catch (err) {
+        warnings.push(`brand-setup: ${rel} unreadable: ${stringifyErr(err)}`);
+        return false;
+    }
+    const flipped = flipStatus(text);
+    const out = replaceBodyAfterFrontmatter(flipped, body);
+    try {
+        writeFileSync(abs, out, "utf8");
+    }
+    catch (err) {
+        warnings.push(`brand-setup: ${rel} write failed: ${stringifyErr(err)}`);
+        return false;
+    }
+    return true;
+}
+function rewritePersonas(abs, description, warnings, rel) {
+    if (!existsSync(abs)) {
+        warnings.push(`brand-setup: ${rel} missing — skipping`);
+        return false;
+    }
+    const next = `# Product personas — who this is for. Read at every SessionStart.\n` +
+        `# See DOCS_SPEC.md §3.4 for shape.\n` +
+        `status: current\n` +
+        `personas:\n` +
+        `  - name: primary\n` +
+        `    description: ${yamlSingleLine(description)}\n`;
+    try {
+        writeFileSync(abs, next, "utf8");
+    }
+    catch (err) {
+        warnings.push(`brand-setup: ${rel} write failed: ${stringifyErr(err)}`);
+        return false;
+    }
+    return true;
+}
+function rewriteVoice(abs, body, avoid, warnings, rel) {
+    if (!existsSync(abs)) {
+        warnings.push(`brand-setup: ${rel} missing — skipping`);
+        return false;
+    }
+    let text;
+    try {
+        text = readFileSync(abs, "utf8");
+    }
+    catch (err) {
+        warnings.push(`brand-setup: ${rel} unreadable: ${stringifyErr(err)}`);
+        return false;
+    }
+    const flipped = flipStatus(text);
+    const main = body.length > 0 ? body : "(operator did not specify a voice — fill in later)";
+    const avoidBlock = avoid.length > 0 ? `\n\n## Avoid\n\n${avoid}\n` : "";
+    const out = replaceBodyAfterFrontmatter(flipped, `${main}${avoidBlock}`);
+    try {
+        writeFileSync(abs, out, "utf8");
+    }
+    catch (err) {
+        warnings.push(`brand-setup: ${rel} write failed: ${stringifyErr(err)}`);
+        return false;
+    }
+    return true;
+}
+const FRONTMATTER_RE = /^---\n([\s\S]*?\n)---\n?/;
+function flipStatus(text) {
+    const m = text.match(FRONTMATTER_RE);
+    if (!m)
+        return text;
+    const fm = m[1] ?? "";
+    const flipped = /^status:\s*draft\s*$/m.test(fm)
+        ? fm.replace(/^status:\s*draft\s*$/m, "status: current")
+        : /^status:\s*/m.test(fm)
+            ? fm
+            : `${fm}status: current\n`;
+    return text.replace(FRONTMATTER_RE, `---\n${flipped}---\n`);
+}
+function replaceBodyAfterFrontmatter(text, body) {
+    const m = text.match(FRONTMATTER_RE);
+    if (!m)
+        return `${text.trimEnd()}\n\n${body}\n`;
+    const fmBlock = m[0];
+    const rest = text.slice(fmBlock.length);
+    // Preserve the H1 line from the existing template, replace the rest.
+    const h1Match = rest.match(/^\n*(#\s+[^\n]+\n)/);
+    const headerLine = h1Match?.[1] ?? "# (untitled)\n";
+    return `${fmBlock}\n${headerLine}\n${body.trimEnd()}\n`;
+}
+function yamlSingleLine(s) {
+    // Quote when the value contains characters yaml would parse oddly.
+    if (/[:#&*!|>'"%@`?\-]/.test(s) || s.includes("\n")) {
+        return `"${s.replace(/"/g, '\\"')}"`;
+    }
+    return s;
+}
+function stringifyErr(err) {
+    return err instanceof Error ? err.message : String(err);
+}
+//# sourceMappingURL=brand-setup.js.map

package/dist/init/brand-setup.js.map

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

package/dist/init/daemon-autostart.d.ts

@@ -0,0 +1,16 @@
+/**
+ * Phase 5c — daemon autostart attempt.
+ *
+ * Spawns `harness daemon start --detach` (best-effort) and waits up to 1.5s
+ * for the project's `status.json` to appear. Returns a summary the init
+ * Phase-6 output can render. Never throws — autostart is opportunistic.
+ */
+export interface DaemonAutostartResult {
+    /** True when status.json materialised within the wait window. */
+    started: boolean;
+    /** PID parsed out of status.json when present. */
+    pid: number | null;
+    /** Reason the autostart was abandoned. Null on success. */
+    reason: string | null;
+}
+export declare function tryStartDaemon(repoRoot: string): Promise<DaemonAutostartResult>;

package/dist/init/daemon-autostart.js

@@ -0,0 +1,95 @@
+/**
+ * Phase 5c — daemon autostart attempt.
+ *
+ * Spawns `harness daemon start --detach` (best-effort) and waits up to 1.5s
+ * for the project's `status.json` to appear. Returns a summary the init
+ * Phase-6 output can render. Never throws — autostart is opportunistic.
+ */
+import { spawn } from "node:child_process";
+import { existsSync, readFileSync } from "node:fs";
+import { basename, join } from "node:path";
+import { normalizeProjectName, projectStatePath } from "../mirror/index.js";
+const WAIT_MS = 1_500;
+const POLL_INTERVAL_MS = 100;
+export async function tryStartDaemon(repoRoot) {
+    const slug = normalizeProjectName(basename(repoRoot));
+    const stateDir = projectStatePath(slug);
+    const statusFile = join(stateDir, "status.json");
+    // Pre-existing status.json + a recent updated_at means the daemon is already
+    // running. No need to spawn a duplicate.
+    if (existsSync(statusFile)) {
+        const pid = readPidFromState(stateDir, statusFile);
+        return { started: true, pid, reason: null };
+    }
+    let spawnFailed = null;
+    try {
+        const child = spawn("harness", ["daemon", "start", "--detach"], {
+            detached: true,
+            stdio: "ignore",
+            cwd: repoRoot,
+        });
+        child.on("error", (err) => {
+            spawnFailed = err instanceof Error ? err.message : String(err);
+        });
+        child.unref();
+    }
+    catch (err) {
+        spawnFailed = err instanceof Error ? err.message : String(err);
+    }
+    if (spawnFailed !== null) {
+        return {
+            started: false,
+            pid: null,
+            reason: `harness binary not on PATH (${spawnFailed})`,
+        };
+    }
+    const deadline = Date.now() + WAIT_MS;
+    while (Date.now() < deadline) {
+        if (spawnFailed !== null) {
+            return { started: false, pid: null, reason: spawnFailed };
+        }
+        if (existsSync(statusFile)) {
+            const pid = readPidFromState(stateDir, statusFile);
+            return { started: true, pid, reason: null };
+        }
+        await sleep(POLL_INTERVAL_MS);
+    }
+    if (spawnFailed !== null) {
+        return { started: false, pid: null, reason: spawnFailed };
+    }
+    return {
+        started: false,
+        pid: null,
+        reason: "status.json did not appear within 1.5s",
+    };
+}
+function readPidFromState(stateDir, statusFile) {
+    // Per STATUS_LINE_SPEC §3 the daemon's PID file is `daemon.pid` next to status.json.
+    const pidFile = join(stateDir, "daemon.pid");
+    if (existsSync(pidFile)) {
+        try {
+            const txt = readFileSync(pidFile, "utf8").trim();
+            const n = Number.parseInt(txt, 10);
+            if (Number.isFinite(n) && n > 0)
+                return n;
+        }
+        catch {
+            // fall through
+        }
+    }
+    // Some implementations carry pid directly in status.json under "pid".
+    try {
+        const parsed = JSON.parse(readFileSync(statusFile, "utf8"));
+        const pid = parsed["pid"];
+        if (typeof pid === "number" && Number.isFinite(pid) && pid > 0)
+            return pid;
+    }
+    catch {
+        // ignore
+    }
+    return null;
+}
+function sleep(ms) {
+    return new Promise((resolve) => setTimeout(resolve, ms));
+}
+//# sourceMappingURL=daemon-autostart.js.map

package/dist/init/daemon-autostart.js.map

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

package/dist/init/detect.d.ts

@@ -0,0 +1,25 @@
+/**
+ * Profile-free stack detection for `cairn init`.
+ *
+ * Each detection function returns plain data; the wizard composes them.
+ * No prompts, no side effects, no stdout writes. Detection is mechanical:
+ * read filesystem signatures, return arrays of findings.
+ */
+import type { DetectionResult, HookCapability, SensorProposal, StackSignature, StartCommand } from "./types.js";
+export declare function detectProjectSlug(args: {
+    repoRoot: string;
+    originUrl: string | null;
+}): string;
+export declare function detectOriginUrl(repoRoot: string): Promise<string | null>;
+export declare function detectStackSignatures(repoRoot: string): StackSignature[];
+export declare function detectAvailableSensors(args: {
+    repoRoot: string;
+    signatures: StackSignature[];
+}): SensorProposal[];
+export declare function detectStartCommand(args: {
+    repoRoot: string;
+    signatures: StackSignature[];
+}): StartCommand | null;
+export declare function detectHookCapability(repoRoot: string): HookCapability;
+export declare function detectEnvironment(): Promise<DetectionResult["environment"]>;
+export declare function detectAll(repoRoot: string): Promise<DetectionResult>;

package/dist/init/detect.js

@@ -0,0 +1,319 @@
+/**
+ * Profile-free stack detection for `cairn init`.
+ *
+ * Each detection function returns plain data; the wizard composes them.
+ * No prompts, no side effects, no stdout writes. Detection is mechanical:
+ * read filesystem signatures, return arrays of findings.
+ */
+import { existsSync, readFileSync, statSync } from "node:fs";
+import { basename, join } from "node:path";
+import { simpleGit } from "simple-git";
+import { claudeIsAvailable } from "../claude/index.js";
+import { normalizeProjectName } from "../paths/index.js";
+export function detectProjectSlug(args) {
+    const pkgPath = join(args.repoRoot, "package.json");
+    if (existsSync(pkgPath)) {
+        try {
+            const pkg = JSON.parse(readFileSync(pkgPath, "utf8"));
+            if (typeof pkg.name === "string" && pkg.name.length > 0) {
+                return normalizeProjectName(pkg.name);
+            }
+        }
+        catch {
+            // fall through
+        }
+    }
+    if (args.originUrl !== null) {
+        const match = args.originUrl.match(/[/:]([^/]+?)(?:\.git)?$/);
+        if (match?.[1])
+            return normalizeProjectName(match[1]);
+    }
+    return normalizeProjectName(basename(args.repoRoot));
+}
+export async function detectOriginUrl(repoRoot) {
+    if (!existsSync(join(repoRoot, ".git")))
+        return null;
+    try {
+        const remotes = await simpleGit(repoRoot).getRemotes(true);
+        const origin = remotes.find((r) => r.name === "origin");
+        return origin?.refs?.fetch ?? null;
+    }
+    catch {
+        return null;
+    }
+}
+export function detectStackSignatures(repoRoot) {
+    const signatures = [];
+    const flag = (kind, marker) => {
+        if (existsSync(join(repoRoot, marker))) {
+            signatures.push({ kind, marker });
+        }
+    };
+    flag("typescript", "package.json");
+    flag("python", "pyproject.toml");
+    if (signatures.find((s) => s.kind === "python") === undefined) {
+        flag("python", "requirements.txt");
+    }
+    flag("ruby", "Gemfile");
+    flag("go", "go.mod");
+    flag("rust", "Cargo.toml");
+    flag("elixir", "mix.exs");
+    if (signatures.length === 0) {
+        signatures.push({ kind: "unknown", marker: repoRoot });
+    }
+    return signatures;
+}
+export function detectAvailableSensors(args) {
+    const sensors = [];
+    const has = (path) => existsSync(join(args.repoRoot, path));
+    const hasAny = (paths) => paths.some(has);
+    // ── typescript ───────────────────────────────────────────
+    if (args.signatures.some((s) => s.kind === "typescript")) {
+        if (has("tsconfig.json") || has("tsconfig.base.json")) {
+            sensors.push({
+                id: "tsc",
+                command: "pnpm",
+                args: ["-w", "exec", "tsc", "-b", "--noEmit"],
+                applies_to: ["typescript"],
+                reason: "tsconfig.json present",
+            });
+        }
+        if (hasAny([
+            ".eslintrc",
+            ".eslintrc.js",
+            ".eslintrc.json",
+            ".eslintrc.cjs",
+            "eslint.config.js",
+            "eslint.config.mjs",
+        ])) {
+            sensors.push({
+                id: "eslint",
+                command: "pnpm",
+                args: ["-w", "exec", "eslint", "."],
+                applies_to: ["typescript"],
+                reason: "eslint config present",
+            });
+        }
+    }
+    // ── python ───────────────────────────────────────────────
+    if (args.signatures.some((s) => s.kind === "python")) {
+        const pyToml = readFileIfExists(join(args.repoRoot, "pyproject.toml"));
+        if (has("ruff.toml") || (pyToml && /\[tool\.ruff\]/.test(pyToml))) {
+            sensors.push({
+                id: "ruff",
+                command: "ruff",
+                args: ["check", "."],
+                applies_to: ["python"],
+                reason: "ruff config present",
+            });
+        }
+        if (has("mypy.ini") || (pyToml && /\[tool\.mypy\]/.test(pyToml))) {
+            sensors.push({
+                id: "mypy",
+                command: "mypy",
+                args: ["."],
+                applies_to: ["python"],
+                reason: "mypy config present",
+            });
+        }
+    }
+    // ── ruby ─────────────────────────────────────────────────
+    if (args.signatures.some((s) => s.kind === "ruby")) {
+        const gemfile = readFileIfExists(join(args.repoRoot, "Gemfile"));
+        if (has(".rubocop.yml") || (gemfile && /\brubocop\b/.test(gemfile))) {
+            sensors.push({
+                id: "rubocop",
+                command: "bundle",
+                args: ["exec", "rubocop"],
+                applies_to: ["ruby"],
+                reason: "rubocop config / dep present",
+            });
+        }
+        if (gemfile && /\brails\b/.test(gemfile)) {
+            sensors.push({
+                id: "brakeman",
+                command: "bundle",
+                args: ["exec", "brakeman", "--no-pager"],
+                applies_to: ["ruby"],
+                reason: "rails app detected",
+                needs_install: true,
+            });
+        }
+    }
+    // ── go ───────────────────────────────────────────────────
+    if (args.signatures.some((s) => s.kind === "go")) {
+        sensors.push({
+            id: "go-vet",
+            command: "go",
+            args: ["vet", "./..."],
+            applies_to: ["go"],
+            reason: "go.mod present",
+        });
+        sensors.push({
+            id: "gofmt",
+            command: "gofmt",
+            args: ["-l", "."],
+            applies_to: ["go"],
+            reason: "go.mod present",
+        });
+    }
+    // ── rust ─────────────────────────────────────────────────
+    if (args.signatures.some((s) => s.kind === "rust")) {
+        sensors.push({
+            id: "cargo-check",
+            command: "cargo",
+            args: ["check"],
+            applies_to: ["rust"],
+            reason: "Cargo.toml present",
+        });
+        sensors.push({
+            id: "cargo-clippy",
+            command: "cargo",
+            args: ["clippy", "--", "-D", "warnings"],
+            applies_to: ["rust"],
+            reason: "Cargo.toml present",
+        });
+    }
+    // ── elixir ───────────────────────────────────────────────
+    if (args.signatures.some((s) => s.kind === "elixir")) {
+        sensors.push({
+            id: "mix-compile-warnings",
+            command: "mix",
+            args: ["compile", "--warnings-as-errors"],
+            applies_to: ["elixir"],
+            reason: "mix.exs present",
+        });
+    }
+    return sensors;
+}
+export function detectStartCommand(args) {
+    // typescript: prefer package.json scripts.dev > scripts.start
+    if (args.signatures.some((s) => s.kind === "typescript")) {
+        const pkgPath = join(args.repoRoot, "package.json");
+        if (existsSync(pkgPath)) {
+            try {
+                const pkg = JSON.parse(readFileSync(pkgPath, "utf8"));
+                const script = pkg.scripts?.["dev"] ?? pkg.scripts?.["start"];
+                const scriptName = pkg.scripts?.["dev"] !== undefined ? "dev" : "start";
+                if (script !== undefined) {
+                    return {
+                        command: "pnpm",
+                        args: ["run", scriptName],
+                        reason: `package.json scripts.${scriptName}: \`${script}\``,
+                    };
+                }
+            }
+            catch {
+                // fall through
+            }
+        }
+    }
+    // python: manage.py runserver; FastAPI uvicorn from Procfile/dev.sh
+    if (args.signatures.some((s) => s.kind === "python")) {
+        if (existsSync(join(args.repoRoot, "manage.py"))) {
+            return {
+                command: "python",
+                args: ["manage.py", "runserver"],
+                reason: "Django manage.py detected",
+            };
+        }
+        const procfile = readFileIfExists(join(args.repoRoot, "Procfile"));
+        if (procfile) {
+            const webLine = procfile.split(/\r?\n/).find((l) => /^web:/i.test(l));
+            if (webLine) {
+                const cmdRaw = webLine.replace(/^web:\s*/i, "").trim();
+                const parts = cmdRaw.split(/\s+/);
+                if (parts.length > 0 && parts[0] !== undefined) {
+                    return {
+                        command: parts[0],
+                        args: parts.slice(1),
+                        reason: `Procfile web: ${cmdRaw}`,
+                    };
+                }
+            }
+        }
+    }
+    // ruby: bin/rails server
+    if (args.signatures.some((s) => s.kind === "ruby")) {
+        if (existsSync(join(args.repoRoot, "bin", "rails"))) {
+            return {
+                command: "bin/rails",
+                args: ["server"],
+                reason: "bin/rails detected",
+            };
+        }
+    }
+    // go: best-guess `go run ./...`
+    if (args.signatures.some((s) => s.kind === "go")) {
+        return {
+            command: "go",
+            args: ["run", "./..."],
+            reason: "go.mod present",
+        };
+    }
+    // rust: cargo run
+    if (args.signatures.some((s) => s.kind === "rust")) {
+        return {
+            command: "cargo",
+            args: ["run"],
+            reason: "Cargo.toml present",
+        };
+    }
+    return null;
+}
+export function detectHookCapability(repoRoot) {
+    const claudeDir = join(repoRoot, ".claude");
+    if (existsSync(claudeDir) && isDirectory(claudeDir))
+        return "claude-code";
+    if (existsSync(join(repoRoot, ".git")))
+        return "git-hooks";
+    return "cli-only";
+}
+export async function detectEnvironment() {
+    return {
+        claude_auth: claudeIsAvailable(),
+    };
+}
+export async function detectAll(repoRoot) {
+    const originUrl = await detectOriginUrl(repoRoot);
+    const project_slug = detectProjectSlug({ repoRoot, originUrl });
+    const stack_signatures = detectStackSignatures(repoRoot);
+    const proposed_sensors = detectAvailableSensors({
+        repoRoot,
+        signatures: stack_signatures,
+    });
+    const start_command = detectStartCommand({
+        repoRoot,
+        signatures: stack_signatures,
+    });
+    const hook_capability = detectHookCapability(repoRoot);
+    const environment = await detectEnvironment();
+    return {
+        repo_root: repoRoot,
+        project_slug,
+        origin_url: originUrl,
+        stack_signatures,
+        proposed_sensors,
+        start_command,
+        hook_capability,
+        environment,
+    };
+}
+/* ───────────────────────── helpers ───────────────────────── */
+function readFileIfExists(path) {
+    try {
+        return readFileSync(path, "utf8");
+    }
+    catch {
+        return null;
+    }
+}
+function isDirectory(path) {
+    try {
+        return statSync(path).isDirectory();
+    }
+    catch {
+        return false;
+    }
+}
+//# sourceMappingURL=detect.js.map