linersh 0.5.0

package/dist/progress.js

@@ -0,0 +1,185 @@
+// A single source of truth for "how far has the curator walked through the
+// methodology" — replaces the swiss-cheese per-artifact status detection
+// that produced check-marks out of order whenever a previous run or
+// hand-edit had touched a later artifact first.
+//
+// The file is dead-simple: one integer plus a timestamp.
+//
+//   { "step": 4, "lastTouched": "2026-05-19T22:00:00.000Z" }
+//
+// `step` is the count of completed phases. With 11 phases in PHASE_ORDER,
+// step ranges 0..11:
+//
+//   0  → nothing done; user is currently on PHASE_ORDER[0] (Framing)
+//   N  → N phases done; user is currently on PHASE_ORDER[N]
+//   11 → everything (including optional Phase 8) done
+import { existsSync, readFileSync, writeFileSync } from "node:fs";
+import { join } from "node:path";
+import { projectFolder } from "./yaml-io.js";
+const PROGRESS_FILE = ".liner-progress.json";
+/** Walk order. Position in this array IS the step value the user is "on". */
+export const PHASE_ORDER = [
+    "framing",
+    "gate0",
+    "candidates",
+    "gate1",
+    "evaluation",
+    "quality",
+    "gate2",
+    "synthesis",
+    "assembly",
+    "compile",
+    "empirical",
+];
+export const TOTAL_STEPS = PHASE_ORDER.length;
+export function readProgress(folder) {
+    const path = join(folder, PROGRESS_FILE);
+    if (!existsSync(path)) {
+        return { step: 0, lastTouched: new Date().toISOString() };
+    }
+    try {
+        const raw = JSON.parse(readFileSync(path, "utf8"));
+        return {
+            step: typeof raw.step === "number"
+                ? Math.max(0, Math.min(TOTAL_STEPS, Math.floor(raw.step)))
+                : 0,
+            lastTouched: typeof raw.lastTouched === "string"
+                ? raw.lastTouched
+                : new Date().toISOString(),
+        };
+    }
+    catch {
+        return { step: 0, lastTouched: new Date().toISOString() };
+    }
+}
+export function writeProgress(folder, state) {
+    const path = join(folder, PROGRESS_FILE);
+    writeFileSync(path, JSON.stringify(state, null, 2) + "\n", "utf8");
+}
+export function progressFileExists(folder) {
+    return existsSync(join(folder, PROGRESS_FILE));
+}
+/**
+ * Advance the progress cursor when a phase completes. Idempotent: calling
+ * twice for the same phase is a no-op. Calling for a phase that isn't the
+ * current one is also a no-op (we don't skip ahead silently).
+ */
+export function markPhaseComplete(folder, phaseId) {
+    const current = readProgress(folder);
+    const expected = PHASE_ORDER.indexOf(phaseId);
+    if (expected === -1)
+        return current;
+    if (current.step !== expected) {
+        // Out of sync — caller is asking us to advance from somewhere we aren't.
+        // Don't move the cursor. Caller should reconcile before retrying.
+        return current;
+    }
+    const next = {
+        step: Math.min(TOTAL_STEPS, current.step + 1),
+        lastTouched: new Date().toISOString(),
+    };
+    writeProgress(folder, next);
+    return next;
+}
+/**
+ * One-time inference for projects that predate progress.json. Walks
+ * PHASE_ORDER and finds the longest consecutive prefix of "done" phases,
+ * then commits that as the starting step.
+ *
+ * "Done" here uses the same artifact heuristics that drove status in the
+ * old per-phase model — so a project where the agent ran Phase 1 and Phase 2
+ * before this rewrite migrates to step = 2 cleanly. Out-of-order artifacts
+ * (Phase 7 done but Phase 2 empty) are ignored — the consecutive-prefix
+ * rule reflects what the curator has *actually walked through*, not what
+ * files happen to be on disk.
+ */
+export function migrateProgress(folder, tape) {
+    const project = projectFolder(folder);
+    const gateState = readGateStateInline(folder);
+    let step = 0;
+    for (const phaseId of PHASE_ORDER) {
+        if (!isPhaseComplete(phaseId, folder, project, tape, gateState))
+            break;
+        step++;
+    }
+    const state = {
+        step,
+        lastTouched: new Date().toISOString(),
+    };
+    writeProgress(folder, state);
+    return state;
+}
+function readGateStateInline(folder) {
+    // Cheap re-read — kept local to avoid a circular import with phases.ts.
+    const path = join(folder, ".liner-gates.json");
+    if (!existsSync(path)) {
+        return { gate0Accepted: false, gate1Accepted: false, gate2Accepted: false };
+    }
+    try {
+        const raw = JSON.parse(readFileSync(path, "utf8"));
+        return {
+            gate0Accepted: Boolean(raw.gate0Accepted),
+            gate1Accepted: Boolean(raw.gate1Accepted),
+            gate2Accepted: Boolean(raw.gate2Accepted),
+        };
+    }
+    catch {
+        return { gate0Accepted: false, gate1Accepted: false, gate2Accepted: false };
+    }
+}
+function isPhaseComplete(phaseId, folder, project, tape, gates) {
+    switch (phaseId) {
+        case "framing":
+            return artifactHasRealContent(join(folder, "working/01-jtbd-and-knowledge-map.md")) &&
+                Boolean(tape.jtbd?.trim());
+        case "gate0":
+            return gates.gate0Accepted;
+        case "candidates":
+            return artifactHasRealContent(join(folder, "working/02-candidate-longlist.md"));
+        case "gate1":
+            return gates.gate1Accepted;
+        case "evaluation":
+            return artifactHasRealContent(join(folder, "working/03-evaluation.yaml"));
+        case "quality":
+            return artifactHasRealContent(join(folder, "working/04-quality-checks.md"));
+        case "gate2":
+            return gates.gate2Accepted;
+        case "synthesis": {
+            if (!existsSync(project.synthesisPath))
+                return false;
+            const text = readFileSync(project.synthesisPath, "utf8");
+            return text.trim().length > 0 && !text.includes("Replace this placeholder");
+        }
+        case "assembly":
+            return tape.sources.length > 0;
+        case "compile":
+            return existsSync(project.mixtapePath);
+        case "empirical":
+            return artifactHasRealContent(join(folder, "working/05-empirical-test.md"));
+    }
+}
+const PLACEHOLDER_MARKERS = [
+    "TODO — a single specific sentence",
+    // Knowledge-map section placeholder — survives the wizard's JTBD pre-fill
+    // (which only strips the JTBD-specific TODO above) and gets removed by
+    // Phase 1 when the agent writes real sections. Without this marker, the
+    // freshly-pre-filled working/01 would falsely register as "Framing done."
+    "TODO — Phase 1 replaces this",
+    "Quantity over precision",
+    "candidates: []",
+    "Run each test deliberately",
+];
+function artifactHasRealContent(path) {
+    if (!existsSync(path))
+        return false;
+    const text = readFileSync(path, "utf8");
+    const trimmed = text.trim();
+    if (trimmed.length === 0)
+        return false;
+    for (const marker of PLACEHOLDER_MARKERS) {
+        if (text.includes(marker))
+            return false;
+    }
+    return true;
+}
+//# sourceMappingURL=progress.js.map

package/dist/progress.js.map

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

package/dist/screens/AgentSetup.js

@@ -0,0 +1,217 @@
+import React, { useMemo, useState } from "react";
+import { Box, Text, useInput } from "ink";
+import { Header } from "../components/Header.js";
+import { KeyHints } from "../components/KeyHints.js";
+import { LabeledBox } from "../components/LabeledBox.js";
+import { useApp } from "../store.js";
+import { detectAgents, KNOWN_AGENTS } from "../agents/detect.js";
+import { readConfig, writeConfig } from "../config.js";
+import { CURRENT, ERROR, HEADING, STRUCTURE, SUCCESS } from "../colors.js";
+// One-time picker for "which AI agent should drive the methodology phases?"
+// — runs as the first screen on a fresh install when both Claude Code and
+// Codex are present, and is reachable later via the splash Settings entry.
+//
+// Persists the choice to ~/.liner/config.yaml (via the config module). The
+// LINER_AGENT env var still overrides — power users / CI keep the escape
+// hatch. The mid-phase picker becomes dead code in practice but stays bound
+// as a defensive fallback (e.g. config file disappears, env var names a
+// non-installed agent).
+/**
+ * Source of truth for what the screen says about each agent. Kept inline so
+ * the copy lives with the screen that shows it, rather than in agents/types
+ * (which is where the cold type lives).
+ */
+const AGENT_BLURBS = {
+    claude: {
+        tagline: "Anthropic's Claude Code — strong at long-context tasks and at writing prose.",
+        install: "npm install -g @anthropic-ai/claude-code",
+    },
+    codex: {
+        tagline: "OpenAI Codex — fast for code-heavy phases, snappy on shorter prompts.",
+        install: "see https://github.com/openai/codex",
+    },
+};
+export function AgentSetup() {
+    const app = useApp();
+    const installed = useMemo(() => detectAgents(), []);
+    const config = useMemo(() => readConfig(), []);
+    // Agents the TUI knows about but didn't find on this machine. Surfaced as
+    // a footer so a user with (e.g.) Codex installed via fnm but unreachable
+    // from the TUI's PATH has a concrete unblock path rather than just "not
+    // detected." The KNOWN_AGENTS catalog is the single source of truth.
+    const undetected = useMemo(() => KNOWN_AGENTS.filter((meta) => !installed.some((a) => a.id === meta.id)), [installed]);
+    // Where the cursor lands by default: the currently-configured agent if
+    // it's installed, otherwise the first one. New installs start at index 0.
+    const initialIndex = useMemo(() => {
+        if (config.agent) {
+            const idx = installed.findIndex((a) => a.id === config.agent);
+            if (idx >= 0)
+                return idx;
+        }
+        return 0;
+    }, [installed, config.agent]);
+    const [cursor, setCursor] = useState(initialIndex);
+    const [error, setError] = useState(null);
+    /** Return to wherever launched this screen. First-run has an empty back
+     *  stack, so back() falls through to the browser. From the splash settings
+     *  entry, back() pops to the splash. */
+    function done() {
+        app.back();
+    }
+    function pick(agent) {
+        try {
+            writeConfig({ agent: agent.id });
+            app.setNotification({
+                kind: "info",
+                message: `Agent set to ${agent.name}. Change anytime from the splash menu.`,
+            });
+            done();
+        }
+        catch (e) {
+            setError(`Could not write config: ${e.message}`);
+        }
+    }
+    function clearChoice() {
+        try {
+            writeConfig({ agent: null });
+            app.setNotification({
+                kind: "info",
+                message: "Cleared agent preference. The mid-phase picker will appear when needed.",
+            });
+            done();
+        }
+        catch (e) {
+            setError(`Could not write config: ${e.message}`);
+        }
+    }
+    useInput((input, key) => {
+        if (installed.length === 0) {
+            if (key.escape || input === "b")
+                done();
+            return;
+        }
+        if (key.upArrow || input === "k") {
+            setCursor((c) => Math.max(0, c - 1));
+        }
+        else if (key.downArrow || input === "j") {
+            setCursor((c) => Math.min(installed.length - 1, c + 1));
+        }
+        else if (key.return || input === " ") {
+            const agent = installed[cursor];
+            if (agent)
+                pick(agent);
+        }
+        else if (input === "u" && config.agent) {
+            clearChoice();
+        }
+        else if (key.escape || input === "b") {
+            done();
+        }
+    });
+    // Zero-agent state: instructions, no picker. User can't proceed without
+    // an agent for methodology phases — but they can still browse compiled
+    // mixtapes, so we let them through to the browser.
+    if (installed.length === 0) {
+        return (React.createElement(Box, { flexDirection: "column" },
+            React.createElement(Header, { title: "choose your AI agent", subtitle: "first-run setup" }),
+            React.createElement(Box, { marginBottom: 1 },
+                React.createElement(LabeledBox, { label: "no agent installed", color: ERROR },
+                    React.createElement(Text, { color: ERROR, bold: true }, "Neither Claude Code nor Codex was found on your PATH."),
+                    React.createElement(Box, { marginTop: 1, flexDirection: "column" },
+                        React.createElement(Text, null, "Liner can run the methodology with either:"),
+                        React.createElement(Box, { marginTop: 1, flexDirection: "column" },
+                            React.createElement(Text, null,
+                                "  ",
+                                React.createElement(Text, { color: STRUCTURE, bold: true }, "Claude Code"),
+                                React.createElement(Text, { dimColor: true },
+                                    " — ",
+                                    AGENT_BLURBS.claude.install)),
+                            React.createElement(Text, null,
+                                "  ",
+                                React.createElement(Text, { color: STRUCTURE, bold: true }, "OpenAI Codex"),
+                                React.createElement(Text, { dimColor: true },
+                                    " — ",
+                                    AGENT_BLURBS.codex.install)))),
+                    React.createElement(Box, { marginTop: 1 },
+                        React.createElement(Text, { dimColor: true },
+                            "You can still browse compiled mixtapes without an agent \u2014 just press ",
+                            React.createElement(Text, { color: STRUCTURE }, "esc"),
+                            " to continue.")))),
+            React.createElement(KeyHints, { hints: [{ key: "esc", label: "skip to browser" }] })));
+    }
+    return (React.createElement(Box, { flexDirection: "column" },
+        React.createElement(Header, { title: "choose your AI agent", subtitle: config.agent
+                ? `current: ${config.agent} · change anytime`
+                : "first-run setup · pick once, change anytime" }),
+        React.createElement(Box, { marginBottom: 1, flexDirection: "column" },
+            React.createElement(Text, { color: HEADING, bold: true }, "Which agent should drive the methodology?"),
+            React.createElement(Box, { marginTop: 1 },
+                React.createElement(Text, { dimColor: true }, "Liner spawns the agent CLI for each methodology phase (framing, candidate discovery, evaluation, \u2026). Both options run the same skill bundle and produce the same artifacts \u2014 pick the one you already use, or default to whichever is faster on your hardware. You can change this later from the splash menu's Settings entry."))),
+        React.createElement(Box, { marginBottom: 1 },
+            React.createElement(LabeledBox, { label: "installed agents", color: STRUCTURE }, installed.map((agent, i) => {
+                const active = i === cursor;
+                const blurb = AGENT_BLURBS[agent.id];
+                const isConfigured = config.agent === agent.id;
+                return (React.createElement(Box, { key: agent.id, flexDirection: "column", marginBottom: i === installed.length - 1 ? 0 : 1 },
+                    React.createElement(Box, null,
+                        React.createElement(Text, { color: active ? CURRENT : undefined, bold: active }, active ? "> " : "  "),
+                        React.createElement(Text, { color: STRUCTURE }, `[${i + 1}]`),
+                        React.createElement(Text, null, "  "),
+                        React.createElement(Text, { color: active ? CURRENT : undefined, bold: active }, agent.name),
+                        isConfigured ? (React.createElement(Text, { color: SUCCESS }, "  ·  current")) : null),
+                    blurb ? (React.createElement(Box, { paddingLeft: 6 },
+                        React.createElement(Text, { dimColor: true }, blurb.tagline))) : null,
+                    React.createElement(Box, { paddingLeft: 6 },
+                        React.createElement(Text, { dimColor: true }, agent.bin))));
+            }))),
+        React.createElement(Box, { marginBottom: 1 },
+            React.createElement(Text, { color: STRUCTURE }, "enter"),
+            React.createElement(Text, { dimColor: true }, ` → pick ${installed[cursor]?.name ?? "agent"} and continue`)),
+        undetected.length > 0 ? (React.createElement(Box, { marginBottom: 1 },
+            React.createElement(LabeledBox, { label: "not detected", color: STRUCTURE },
+                React.createElement(Text, { dimColor: true },
+                    undetected.length === 1
+                        ? `${undetected[0].name} isn't on Liner's PATH right now.`
+                        : `${undetected.map((u) => u.name).join(" and ")} aren't on Liner's PATH right now.`,
+                    " ",
+                    "If you have one installed but it's not showing up \u2014 usually fnm / nvm / asdf shims that aren't loaded in the launcher's environment \u2014 try one of:"),
+                React.createElement(Box, { marginTop: 1, flexDirection: "column" },
+                    React.createElement(Text, { dimColor: true },
+                        "  • ",
+                        "Restart the TUI from a shell where",
+                        " ",
+                        React.createElement(Text, { color: STRUCTURE },
+                            "which ",
+                            undetected[0].id),
+                        " ",
+                        "returns a path."),
+                    React.createElement(Text, { dimColor: true },
+                        "  • ",
+                        "Set",
+                        " ",
+                        React.createElement(Text, { color: STRUCTURE },
+                            undetected[0].envVar,
+                            "=/full/path/to/",
+                            undetected[0].id),
+                        " ",
+                        "in your shell config (or pass it inline:",
+                        " ",
+                        React.createElement(Text, { color: STRUCTURE },
+                            undetected[0].envVar,
+                            "=\u2026 npm run dev"),
+                        ")."),
+                    React.createElement(Text, { dimColor: true },
+                        "  • ",
+                        "If you don't have it installed yet:",
+                        " ",
+                        React.createElement(Text, { color: STRUCTURE }, AGENT_BLURBS[undetected[0].id]?.install ?? "(install instructions vary)")))))) : null,
+        error ? (React.createElement(Box, { marginBottom: 1 },
+            React.createElement(Text, { color: ERROR }, error))) : null,
+        React.createElement(KeyHints, { hints: [
+                { key: "↑↓", label: "select" },
+                { key: "enter", label: "pick + save" },
+                ...(config.agent ? [{ key: "u", label: "clear preference" }] : []),
+                { key: "esc", label: "skip" },
+            ] })));
+}
+//# sourceMappingURL=AgentSetup.js.map

package/dist/screens/AgentSetup.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"AgentSetup.js","sourceRoot":"","sources":["../../src/screens/AgentSetup.tsx"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,EAAE,OAAO,EAAE,QAAQ,EAAE,MAAM,OAAO,CAAC;AACjD,OAAO,EAAE,GAAG,EAAE,IAAI,EAAE,QAAQ,EAAE,MAAM,KAAK,CAAC;AAC1C,OAAO,EAAE,MAAM,EAAE,MAAM,yBAAyB,CAAC;AACjD,OAAO,EAAE,QAAQ,EAAE,MAAM,2BAA2B,CAAC;AACrD,OAAO,EAAE,UAAU,EAAE,MAAM,6BAA6B,CAAC;AACzD,OAAO,EAAE,MAAM,EAAE,MAAM,aAAa,CAAC;AACrC,OAAO,EAAE,YAAY,EAAE,YAAY,EAAE,MAAM,qBAAqB,CAAC;AACjE,OAAO,EAAE,UAAU,EAAE,WAAW,EAAE,MAAM,cAAc,CAAC;AACvD,OAAO,EAAE,OAAO,EAAE,KAAK,EAAE,OAAO,EAAE,SAAS,EAAE,OAAO,EAAE,MAAM,cAAc,CAAC;AAG3E,4EAA4E;AAC5E,0EAA0E;AAC1E,2EAA2E;AAC3E,EAAE;AACF,2EAA2E;AAC3E,yEAAyE;AACzE,4EAA4E;AAC5E,wEAAwE;AACxE,wBAAwB;AAExB;;;;GAIG;AACH,MAAM,YAAY,GAAyD;IACzE,MAAM,EAAE;QACN,OAAO,EAAE,8EAA8E;QACvF,OAAO,EAAE,0CAA0C;KACpD;IACD,KAAK,EAAE;QACL,OAAO,EAAE,uEAAuE;QAChF,OAAO,EAAE,qCAAqC;KAC/C;CACF,CAAC;AAEF,MAAM,UAAU,UAAU;IACxB,MAAM,GAAG,GAAG,MAAM,EAAE,CAAC;IACrB,MAAM,SAAS,GAAG,OAAO,CAAC,GAAG,EAAE,CAAC,YAAY,EAAE,EAAE,EAAE,CAAC,CAAC;IACpD,MAAM,MAAM,GAAG,OAAO,CAAC,GAAG,EAAE,CAAC,UAAU,EAAE,EAAE,EAAE,CAAC,CAAC;IAC/C,0EAA0E;IAC1E,yEAAyE;IACzE,wEAAwE;IACxE,qEAAqE;IACrE,MAAM,UAAU,GAAG,OAAO,CACxB,GAAG,EAAE,CACH,YAAY,CAAC,MAAM,CAAC,CAAC,IAAI,EAAE,EAAE,CAAC,CAAC,SAAS,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,EAAE,KAAK,IAAI,CAAC,EAAE,CAAC,CAAC,EACzE,CAAC,SAAS,CAAC,CACZ,CAAC;IAEF,uEAAuE;IACvE,0EAA0E;IAC1E,MAAM,YAAY,GAAG,OAAO,CAAC,GAAG,EAAE;QAChC,IAAI,MAAM,CAAC,KAAK,EAAE,CAAC;YACjB,MAAM,GAAG,GAAG,SAAS,CAAC,SAAS,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,EAAE,KAAK,MAAM,CAAC,KAAK,CAAC,CAAC;YAC9D,IAAI,GAAG,IAAI,CAAC;gBAAE,OAAO,GAAG,CAAC;QAC3B,CAAC;QACD,OAAO,CAAC,CAAC;IACX,CAAC,EAAE,CAAC,SAAS,EAAE,MAAM,CAAC,KAAK,CAAC,CAAC,CAAC;IAC9B,MAAM,CAAC,MAAM,EAAE,SAAS,CAAC,GAAG,QAAQ,CAAC,YAAY,CAAC,CAAC;IACnD,MAAM,CAAC,KAAK,EAAE,QAAQ,CAAC,GAAG,QAAQ,CAAgB,IAAI,CAAC,CAAC;IAExD;;4CAEwC;IACxC,SAAS,IAAI;QACX,GAAG,CAAC,IAAI,EAAE,CAAC;IACb,CAAC;IAED,SAAS,IAAI,CAAC,KAAsB;QAClC,IAAI,CAAC;YACH,WAAW,CAAC,EAAE,KAAK,EAAE,KAAK,CAAC,EAAE,EAAE,CAAC,CAAC;YACjC,GAAG,CAAC,eAAe,CAAC;gBAClB,IAAI,EAAE,MAAM;gBACZ,OAAO,EAAE,gBAAgB,KAAK,CAAC,IAAI,wCAAwC;aAC5E,CAAC,CAAC;YACH,IAAI,EAAE,CAAC;QACT,CAAC;QAAC,OAAO,CAAC,EAAE,CAAC;YACX,QAAQ,CAAC,2BAA4B,CAAW,CAAC,OAAO,EAAE,CAAC,CAAC;QAC9D,CAAC;IACH,CAAC;IAED,SAAS,WAAW;QAClB,IAAI,CAAC;YACH,WAAW,CAAC,EAAE,KAAK,EAAE,IAAI,EAAE,CAAC,CAAC;YAC7B,GAAG,CAAC,eAAe,CAAC;gBAClB,IAAI,EAAE,MAAM;gBACZ,OAAO,EAAE,yEAAyE;aACnF,CAAC,CAAC;YACH,IAAI,EAAE,CAAC;QACT,CAAC;QAAC,OAAO,CAAC,EAAE,CAAC;YACX,QAAQ,CAAC,2BAA4B,CAAW,CAAC,OAAO,EAAE,CAAC,CAAC;QAC9D,CAAC;IACH,CAAC;IAED,QAAQ,CAAC,CAAC,KAAK,EAAE,GAAG,EAAE,EAAE;QACtB,IAAI,SAAS,CAAC,MAAM,KAAK,CAAC,EAAE,CAAC;YAC3B,IAAI,GAAG,CAAC,MAAM,IAAI,KAAK,KAAK,GAAG;gBAAE,IAAI,EAAE,CAAC;YACxC,OAAO;QACT,CAAC;QACD,IAAI,GAAG,CAAC,OAAO,IAAI,KAAK,KAAK,GAAG,EAAE,CAAC;YACjC,SAAS,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC,EAAE,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC;QACvC,CAAC;aAAM,IAAI,GAAG,CAAC,SAAS,IAAI,KAAK,KAAK,GAAG,EAAE,CAAC;YAC1C,SAAS,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,IAAI,CAAC,GAAG,CAAC,SAAS,CAAC,MAAM,GAAG,CAAC,EAAE,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC;QAC1D,CAAC;aAAM,IAAI,GAAG,CAAC,MAAM,IAAI,KAAK,KAAK,GAAG,EAAE,CAAC;YACvC,MAAM,KAAK,GAAG,SAAS,CAAC,MAAM,CAAC,CAAC;YAChC,IAAI,KAAK;gBAAE,IAAI,CAAC,KAAK,CAAC,CAAC;QACzB,CAAC;aAAM,IAAI,KAAK,KAAK,GAAG,IAAI,MAAM,CAAC,KAAK,EAAE,CAAC;YACzC,WAAW,EAAE,CAAC;QAChB,CAAC;aAAM,IAAI,GAAG,CAAC,MAAM,IAAI,KAAK,KAAK,GAAG,EAAE,CAAC;YACvC,IAAI,EAAE,CAAC;QACT,CAAC;IACH,CAAC,CAAC,CAAC;IAEH,wEAAwE;IACxE,uEAAuE;IACvE,mDAAmD;IACnD,IAAI,SAAS,CAAC,MAAM,KAAK,CAAC,EAAE,CAAC;QAC3B,OAAO,CACL,oBAAC,GAAG,IAAC,aAAa,EAAC,QAAQ;YACzB,oBAAC,MAAM,IAAC,KAAK,EAAC,sBAAsB,EAAC,QAAQ,EAAC,iBAAiB,GAAG;YAClE,oBAAC,GAAG,IAAC,YAAY,EAAE,CAAC;gBAClB,oBAAC,UAAU,IAAC,KAAK,EAAC,oBAAoB,EAAC,KAAK,EAAE,KAAK;oBACjD,oBAAC,IAAI,IAAC,KAAK,EAAE,KAAK,EAAE,IAAI,kEAEjB;oBACP,oBAAC,GAAG,IAAC,SAAS,EAAE,CAAC,EAAE,aAAa,EAAC,QAAQ;wBACvC,oBAAC,IAAI,qDAAkD;wBACvD,oBAAC,GAAG,IAAC,SAAS,EAAE,CAAC,EAAE,aAAa,EAAC,QAAQ;4BACvC,oBAAC,IAAI;gCACF,IAAI;gCACL,oBAAC,IAAI,IAAC,KAAK,EAAE,SAAS,EAAE,IAAI,wBAAmB;gCAC/C,oBAAC,IAAI,IAAC,QAAQ;oCAAE,KAAK;oCAAE,YAAY,CAAC,MAAO,CAAC,OAAO,CAAQ,CACtD;4BACP,oBAAC,IAAI;gCACF,IAAI;gCACL,oBAAC,IAAI,IAAC,KAAK,EAAE,SAAS,EAAE,IAAI,yBAAoB;gCAChD,oBAAC,IAAI,IAAC,QAAQ;oCAAE,KAAK;oCAAE,YAAY,CAAC,KAAM,CAAC,OAAO,CAAQ,CACrD,CACH,CACF;oBACN,oBAAC,GAAG,IAAC,SAAS,EAAE,CAAC;wBACf,oBAAC,IAAI,IAAC,QAAQ;;4BAEN,oBAAC,IAAI,IAAC,KAAK,EAAE,SAAS,UAAY;4CACnC,CACH,CACK,CACT;YAEN,oBAAC,QAAQ,IAAC,KAAK,EAAE,CAAC,EAAE,GAAG,EAAE,KAAK,EAAE,KAAK,EAAE,iBAAiB,EAAE,CAAC,GAAI,CAC3D,CACP,CAAC;IACJ,CAAC;IAED,OAAO,CACL,oBAAC,GAAG,IAAC,aAAa,EAAC,QAAQ;QACzB,oBAAC,MAAM,IACL,KAAK,EAAC,sBAAsB,EAC5B,QAAQ,EACN,MAAM,CAAC,KAAK;gBACV,CAAC,CAAC,YAAY,MAAM,CAAC,KAAK,mBAAmB;gBAC7C,CAAC,CAAC,6CAA6C,GAEnD;QAEF,oBAAC,GAAG,IAAC,YAAY,EAAE,CAAC,EAAE,aAAa,EAAC,QAAQ;YAC1C,oBAAC,IAAI,IAAC,KAAK,EAAE,OAAO,EAAE,IAAI,sDAAiD;YAC3E,oBAAC,GAAG,IAAC,SAAS,EAAE,CAAC;gBACf,oBAAC,IAAI,IAAC,QAAQ,sVAMP,CACH,CACF;QAEN,oBAAC,GAAG,IAAC,YAAY,EAAE,CAAC;YAClB,oBAAC,UAAU,IAAC,KAAK,EAAC,kBAAkB,EAAC,KAAK,EAAE,SAAS,IAClD,SAAS,CAAC,GAAG,CAAC,CAAC,KAAK,EAAE,CAAC,EAAE,EAAE;gBAC1B,MAAM,MAAM,GAAG,CAAC,KAAK,MAAM,CAAC;gBAC5B,MAAM,KAAK,GAAG,YAAY,CAAC,KAAK,CAAC,EAAE,CAAC,CAAC;gBACrC,MAAM,YAAY,GAAG,MAAM,CAAC,KAAK,KAAK,KAAK,CAAC,EAAE,CAAC;gBAC/C,OAAO,CACL,oBAAC,GAAG,IAAC,GAAG,EAAE,KAAK,CAAC,EAAE,EAAE,aAAa,EAAC,QAAQ,EAAC,YAAY,EAAE,CAAC,KAAK,SAAS,CAAC,MAAM,GAAG,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC;oBACzF,oBAAC,GAAG;wBACF,oBAAC,IAAI,IAAC,KAAK,EAAE,MAAM,CAAC,CAAC,CAAC,OAAO,CAAC,CAAC,CAAC,SAAS,EAAE,IAAI,EAAE,MAAM,IACpD,MAAM,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC,IAAI,CAChB;wBACP,oBAAC,IAAI,IAAC,KAAK,EAAE,SAAS,IAAG,IAAI,CAAC,GAAG,CAAC,GAAG,CAAQ;wBAC7C,oBAAC,IAAI,QAAE,IAAI,CAAQ;wBACnB,oBAAC,IAAI,IAAC,KAAK,EAAE,MAAM,CAAC,CAAC,CAAC,OAAO,CAAC,CAAC,CAAC,SAAS,EAAE,IAAI,EAAE,MAAM,IACpD,KAAK,CAAC,IAAI,CACN;wBACN,YAAY,CAAC,CAAC,CAAC,CACd,oBAAC,IAAI,IAAC,KAAK,EAAE,OAAO,IAAG,cAAc,CAAQ,CAC9C,CAAC,CAAC,CAAC,IAAI,CACJ;oBACL,KAAK,CAAC,CAAC,CAAC,CACP,oBAAC,GAAG,IAAC,WAAW,EAAE,CAAC;wBACjB,oBAAC,IAAI,IAAC,QAAQ,UAAE,KAAK,CAAC,OAAO,CAAQ,CACjC,CACP,CAAC,CAAC,CAAC,IAAI;oBACR,oBAAC,GAAG,IAAC,WAAW,EAAE,CAAC;wBACjB,oBAAC,IAAI,IAAC,QAAQ,UAAE,KAAK,CAAC,GAAG,CAAQ,CAC7B,CACF,CACP,CAAC;YACJ,CAAC,CAAC,CACS,CACT;QAEN,oBAAC,GAAG,IAAC,YAAY,EAAE,CAAC;YAClB,oBAAC,IAAI,IAAC,KAAK,EAAE,SAAS,YAAc;YACpC,oBAAC,IAAI,IAAC,QAAQ,UAAE,WAAW,SAAS,CAAC,MAAM,CAAC,EAAE,IAAI,IAAI,OAAO,eAAe,CAAQ,CAChF;QAEL,UAAU,CAAC,MAAM,GAAG,CAAC,CAAC,CAAC,CAAC,CACvB,oBAAC,GAAG,IAAC,YAAY,EAAE,CAAC;YAClB,oBAAC,UAAU,IAAC,KAAK,EAAC,cAAc,EAAC,KAAK,EAAE,SAAS;gBAC/C,oBAAC,IAAI,IAAC,QAAQ;oBACX,UAAU,CAAC,MAAM,KAAK,CAAC;wBACtB,CAAC,CAAC,GAAG,UAAU,CAAC,CAAC,CAAE,CAAC,IAAI,mCAAmC;wBAC3D,CAAC,CAAC,GAAG,UAAU,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC,IAAI,CAAC,OAAO,CAAC,oCAAoC;oBACrF,GAAG;kLAGC;gBACP,oBAAC,GAAG,IAAC,SAAS,EAAE,CAAC,EAAE,aAAa,EAAC,QAAQ;oBACvC,oBAAC,IAAI,IAAC,QAAQ;wBACX,MAAM;;wBAAoC,GAAG;wBAC9C,oBAAC,IAAI,IAAC,KAAK,EAAE,SAAS;;4BAAS,UAAU,CAAC,CAAC,CAAE,CAAC,EAAE,CAAQ;wBAAC,GAAG;0CAEvD;oBACP,oBAAC,IAAI,IAAC,QAAQ;wBACX,MAAM;;wBAAK,GAAG;wBACf,oBAAC,IAAI,IAAC,KAAK,EAAE,SAAS;4BAAG,UAAU,CAAC,CAAC,CAAE,CAAC,MAAM;;4BAAiB,UAAU,CAAC,CAAC,CAAE,CAAC,EAAE,CAAQ;wBAAC,GAAG;;wBACnD,GAAG;wBAC5C,oBAAC,IAAI,IAAC,KAAK,EAAE,SAAS;4BAAG,UAAU,CAAC,CAAC,CAAE,CAAC,MAAM;kDAAsB;6BAC/D;oBACP,oBAAC,IAAI,IAAC,QAAQ;wBACX,MAAM;;wBAAqC,GAAG;wBAC/C,oBAAC,IAAI,IAAC,KAAK,EAAE,SAAS,IAAG,YAAY,CAAC,UAAU,CAAC,CAAC,CAAE,CAAC,EAAE,CAAC,EAAE,OAAO,IAAI,6BAA6B,CAAQ,CACrG,CACH,CACK,CACT,CACP,CAAC,CAAC,CAAC,IAAI;QAEP,KAAK,CAAC,CAAC,CAAC,CACP,oBAAC,GAAG,IAAC,YAAY,EAAE,CAAC;YAClB,oBAAC,IAAI,IAAC,KAAK,EAAE,KAAK,IAAG,KAAK,CAAQ,CAC9B,CACP,CAAC,CAAC,CAAC,IAAI;QAER,oBAAC,QAAQ,IACP,KAAK,EAAE;gBACL,EAAE,GAAG,EAAE,IAAI,EAAE,KAAK,EAAE,QAAQ,EAAE;gBAC9B,EAAE,GAAG,EAAE,OAAO,EAAE,KAAK,EAAE,aAAa,EAAE;gBACtC,GAAG,CAAC,MAAM,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC,EAAE,GAAG,EAAE,GAAG,EAAE,KAAK,EAAE,kBAAkB,EAAE,CAAC,CAAC,CAAC,CAAC,EAAE,CAAC;gBAClE,EAAE,GAAG,EAAE,KAAK,EAAE,KAAK,EAAE,MAAM,EAAE;aAC9B,GACD,CACE,CACP,CAAC;AACJ,CAAC"}

package/dist/screens/BootSplash.js

@@ -0,0 +1,159 @@
+import React, { useMemo, useState } from "react";
+import { Box, Text, useInput, useStdout } from "ink";
+import BigText from "ink-big-text";
+import Gradient from "ink-gradient";
+import { useApp } from "../store.js";
+import { CURRENT, HEADING, PALETTE, STRUCTURE } from "../colors.js";
+import { SMALL_CASSETTE_ROWS, SMALL_CASSETTE_WIDTH, } from "./cassette-art.js";
+// First-paint splash. An ASCII-art logo (rendered as foreground text in the
+// brand color) above a real interactive launch menu. Arrows move the
+// selection; Enter activates it; `n` / `i` / `o` are direct hotkeys.
+//
+// The compact (~66×19) cassette is the default — it fits comfortably in
+// every reasonable terminal width and the visual balance against the menu
+// rows below is tighter than the maximalist 100×29 version. The full
+// CASSETTE_ROWS export still lives in cassette-art.ts for any future
+// "show the big one" affordance, but the splash never auto-promotes.
+// Skipped via `shouldShowSplash()` when stdout isn't a TTY or
+// LINER_NO_SPLASH is set.
+const VERSION = "0.5.0"; // mirrors package.json — header pin tracked in TUI-BACKLOG
+const ITEMS = [
+    { action: "new", hotkey: "n", label: "New mixtape", hint: "open the curation wizard" },
+    { action: "import", hotkey: "i", label: "Import archive", hint: "load a .mixtape file" },
+    { action: "open", hotkey: "o", label: "Open existing", hint: "browse your mixtapes folder" },
+    { action: "settings", hotkey: "s", label: "Settings", hint: "change AI agent" },
+];
+export function BootSplash() {
+    const app = useApp();
+    const { stdout } = useStdout();
+    const cols = stdout?.columns ?? 80;
+    // Show the compact cassette whenever it fits; fall back to the wordmark
+    // on terminals too narrow for it.
+    const showCassette = cols >= SMALL_CASSETTE_WIDTH;
+    const [selected, setSelected] = useState(0);
+    function dispatch(action) {
+        switch (action) {
+            case "new":
+                app.navigate({ kind: "newProject" });
+                return;
+            case "import":
+                app.navigate({ kind: "import" });
+                return;
+            case "open":
+                app.navigate({ kind: "browser" });
+                return;
+            case "settings":
+                app.navigate({ kind: "agentSetup" });
+                return;
+        }
+    }
+    useInput((input, key) => {
+        if (key.upArrow || input === "k") {
+            setSelected((i) => (i - 1 + ITEMS.length) % ITEMS.length);
+        }
+        else if (key.downArrow || input === "j") {
+            setSelected((i) => (i + 1) % ITEMS.length);
+        }
+        else if (input === "n") {
+            dispatch("new");
+        }
+        else if (input === "i") {
+            dispatch("import");
+        }
+        else if (input === "o") {
+            dispatch("open");
+        }
+        else if (input === "s") {
+            dispatch("settings");
+        }
+        else if (key.return || input === " ") {
+            dispatch(ITEMS[selected].action);
+        }
+        else if (key.escape) {
+            dispatch("open");
+        }
+    });
+    return (React.createElement(Box, { flexDirection: "column", paddingY: 1 },
+        showCassette ? (React.createElement(CassetteLogo, { rows: SMALL_CASSETTE_ROWS })) : (React.createElement(Gradient, { name: "vice" },
+            React.createElement(BigText, { text: "liner", font: "block" }))),
+        React.createElement(Box, { flexDirection: "column", paddingLeft: 2, marginTop: showCassette ? 1 : -1 },
+            React.createElement(Box, null,
+                React.createElement(Text, { color: STRUCTURE, bold: true }, "liner"),
+                React.createElement(Text, { dimColor: true }, "  \u00B7  curate AI-ready mixtapes from any set of sources")),
+            React.createElement(Text, { dimColor: true },
+                "v",
+                VERSION)),
+        React.createElement(Box, { flexDirection: "column", paddingLeft: 2, marginTop: 1 },
+            React.createElement(Text, { color: HEADING, bold: true }, "Get started"),
+            React.createElement(Box, { marginTop: 1, flexDirection: "column" }, ITEMS.map((item, i) => (React.createElement(MenuRow, { key: item.action, item: item, active: i === selected }))))),
+        React.createElement(Box, { marginTop: 1, paddingLeft: 2 },
+            React.createElement(Text, { dimColor: true }, "\u2191\u2193 navigate  \u00B7  "),
+            React.createElement(Text, { color: STRUCTURE }, "enter"),
+            React.createElement(Text, { dimColor: true }, " select  \u00B7  "),
+            React.createElement(Text, { color: STRUCTURE }, "[n]"),
+            React.createElement(Text, { dimColor: true }, " "),
+            React.createElement(Text, { color: STRUCTURE }, "[i]"),
+            React.createElement(Text, { dimColor: true }, " "),
+            React.createElement(Text, { color: STRUCTURE }, "[o]"),
+            React.createElement(Text, { dimColor: true }, " "),
+            React.createElement(Text, { color: STRUCTURE }, "[s]"),
+            React.createElement(Text, { dimColor: true }, " direct shortcuts"))));
+}
+/**
+ * Render the ASCII cassette logo with every non-space character painted in
+ * a randomly-chosen palette color. The randomization is computed once per
+ * mount (via useMemo) — re-randomizing on every re-render would flicker.
+ *
+ * For perf we group consecutive characters that landed on the same color
+ * into runs so each row ships a handful of `Text` nodes instead of one per
+ * character — Ink mounts a separate element per `<Text>`, and 66 elements
+ * × 19 rows × every re-paint adds up.
+ *
+ * Spaces are emitted as their own color-less run so we don't burn nodes
+ * coloring invisible cells.
+ */
+function CassetteLogo({ rows }) {
+    const colored = useMemo(() => rows.map(colorizeRow), [rows]);
+    return (React.createElement(Box, { flexDirection: "column" }, colored.map((runs, rowIdx) => (React.createElement(Box, { key: rowIdx }, runs.map((run, runIdx) => (React.createElement(Text, { key: runIdx, color: run.color }, run.chars))))))));
+}
+function colorizeRow(row) {
+    const runs = [];
+    for (const ch of row) {
+        // Spaces don't need coloring — collapse them into uncolored runs so we
+        // don't allocate a random color per blank cell.
+        const color = ch === " " ? undefined : PALETTE[Math.floor(Math.random() * PALETTE.length)];
+        const tail = runs[runs.length - 1];
+        if (tail && tail.color === color) {
+            tail.chars += ch;
+        }
+        else {
+            runs.push({ color, chars: ch });
+        }
+    }
+    return runs;
+}
+function MenuRow({ item, active }) {
+    // ASCII ">" is guaranteed single-cell. The unicode ▶ glyph renders
+    // double-wide in many terminal fonts, which made the inactive rows shift
+    // every time the user moved the selection. Using a fixed two-char prefix
+    // ("> " or "  ") keeps every row anchored at the same column.
+    return (React.createElement(Box, null,
+        React.createElement(Text, { color: active ? CURRENT : undefined, bold: active }, active ? "> " : "  "),
+        React.createElement(Text, { color: STRUCTURE }, `[${item.hotkey}]`),
+        React.createElement(Text, null, "  "),
+        React.createElement(Text, { color: active ? CURRENT : undefined, bold: active }, item.label.padEnd(18, " ")),
+        React.createElement(Text, { dimColor: true }, item.hint)));
+}
+export function shouldShowSplash() {
+    if (process.env["LINER_NO_SPLASH"])
+        return false;
+    if (!process.stdout.isTTY)
+        return false;
+    // Narrow terminals (< 60 cols) can't render the big-text wordmark well —
+    // skip rather than show a clipped logo.
+    const cols = process.stdout.columns ?? 80;
+    if (cols < 60)
+        return false;
+    return true;
+}
+//# sourceMappingURL=BootSplash.js.map

package/dist/screens/BootSplash.js.map

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