linersh 0.5.0

package/README.md

@@ -0,0 +1,168 @@
+# Liner TUI
+
+Interactive authoring UI for [Liner](../..) — create, edit, compile, and share mixtape **project folders** from the keyboard.
+
+A *tape file* (`tape.yaml`) is the recipe. A *mixtape* is the project folder Liner builds from it. The TUI is for authoring: it scaffolds folders, edits tapes, surfaces the synthesis status, then runs `liner compile` to produce the consumable `MIXTAPE.md` + `sources/` artifacts.
+
+## Install
+
+```sh
+# One-shot:
+npx linersh
+
+# Persistent:
+npm install -g linersh    # adds `liner` to PATH
+liner
+```
+
+The npm package includes the TUI and resolves the Python core from a per-platform optional package (`linersh-<platform>-<arch>`). With no arguments, `liner` opens the TUI. CLI subcommands such as `liner setup-js`, `liner compile`, `liner share`, and `liner status` pass through to the bundled core.
+
+For JavaScript-rendered pages, run the setup command from the same npm install:
+
+```sh
+liner setup-js
+```
+
+That command is idempotent and downloads the Playwright browser used for `render: js` and automatic JS-wall fallback. For debugging or local development, `LINER_BIN=/path/to/liner liner` overrides the bundled binary.
+
+## Run
+
+```sh
+cd ~/projects/my-thing
+liner
+```
+
+The TUI looks for (and creates) a `./mixtapes/` folder in your current directory. Each subdirectory inside it is a mixtape project folder (must contain a `tape.yaml`).
+
+Override the workspace with `LINER_DIR`:
+
+```sh
+LINER_DIR=~/mixtapes liner
+```
+
+## Keys
+
+### Browser
+| Key | Action |
+|---|---|
+| `↑` `↓` or `j` `k` | move selection |
+| `enter` or `e` | open in editor |
+| `n` | new mixtape (prompts for slug) |
+| `c` | compile selected |
+| `s` | share selected (zip to `.mixtape`) |
+| `i` | import a `.mixtape` archive |
+| `d` | delete selected folder (with confirm) |
+| `r` | refresh |
+| `q` | quit |
+
+### Editor
+| Key | Action |
+|---|---|
+| `t` `d` `u` | edit title / description / curator |
+| `m` | toggle mode (`quick` ⇄ `methodology`) |
+| `g` | edit JTBD (job-to-be-done) |
+| `E` | open `synthesis.md` in `$EDITOR` |
+| `↑` `↓` | select source |
+| `a` `e` `x` | add / edit / remove source |
+| `K` `J` | reorder selected source up/down |
+| `s` | save `tape.yaml` |
+| `c` | save + compile (blocked if synthesis is empty or still a placeholder) |
+| `esc` | back (warns on unsaved changes) |
+
+A soft warning appears when any source is missing a curator note. Notes are load-bearing — see [CURATION.md](https://liner.sh) §6.
+
+#### Local sources
+
+`local_file` sources reference content you've placed under `<project>/personal/` — book chapter PDFs, Reader-Mode-saved articles, exported HIG pages. Use them for material that isn't on the public web or that lives behind a paywall you have legitimate access to.
+
+Workflow:
+
+1. Save the file into `<project>/personal/`. The TUI creates the folder lazily — the file picker offers a "new file (paste path)" option that you can use after saving the file manually with your OS file manager.
+2. Add a source in the editor; press `T` in the source modal to switch the type to `local_file`.
+3. Pick the file via the picker; supply a `citation` (author, title, publication, date — the AI uses this to weight the source).
+4. Compile. The CLI extracts the content (PDFs via `pdfplumber`, HTML via the same readability pipeline as web sources, `.md`/`.txt` as-is).
+
+`liner share` includes `personal/` by default. Pass `--no-personal` (or use the corresponding TUI flag) to exclude it — required for any tape intended as a library submission.
+
+The synthesis indicator shows one of:
+- `✗ missing` — `liner compile` will hard-fail
+- `⚠ placeholder` — file exists but still has the boilerplate from `liner init`
+- `⚠ empty` — file exists but is empty
+- `✓ N chars` — ready to compile
+
+### Source modal
+| Key | Action |
+|---|---|
+| `↑` `↓` | move between fields |
+| `enter` | edit the focused field (or open the file picker on the path field for `local_file` sources) |
+| `tab` | next field while editing |
+| `T` | toggle source type (`web` ⇄ `local_file`) |
+| `R` | toggle `render: server` ⇄ `render: js` (web sources only) |
+| `p` | toggle required/optional |
+| `s` | save source |
+| `esc` | cancel |
+
+For `web` sources the URL is the load-bearing field; the type is auto-detected as `youtube` or `web`. For `local_file` sources the modal shows `path`, `citation`, `note`, `section`, `priority` — pick the path via the file picker (lists files under `personal/`, with a "paste path" affordance for new files).
+
+### Compile
+| Key | Action |
+|---|---|
+| `esc` | cancel running compile |
+| `y` | copy compiled `MIXTAPE.md` to clipboard (`pbcopy` / `xclip`) |
+| `s` | share the compiled mixtape (zip to `.mixtape`) |
+| `r` | re-run compile |
+| `b` | back to editor |
+
+The compile writes `MIXTAPE.md` and `sources/NN-<slug>.md` files directly into the project folder. There's nothing to "save" afterwards — the artifacts are already on disk.
+
+## Uninstalling
+
+The TUI ships in the same `linersh` package as the CLI. The cleanest path is the repo's uninstaller:
+
+```sh
+./scripts/uninstall.sh         # interactive
+./scripts/uninstall.sh --yes   # no prompts
+```
+
+It removes the optional Playwright browser, the local cache, any pipx-installed CLI, and any globally installed TUI (`npm install -g linersh`). Your mixtape project folders are left alone unless you pass `--purge-workspace`. See the root [README — Uninstalling](../../README.md#uninstalling) for the manual recipe.
+
+## Develop
+
+```sh
+cd packages/tui
+npm install
+npm run dev          # tsx (no watch — Ctrl+C and re-run after code changes)
+npm run dev:built    # builds, then runs the compiled output (closer to ship)
+npm run typecheck
+npm test             # vitest
+npm run build        # emits dist/
+```
+
+**Why no `tsx watch`?** `tsx watch` keeps the TTY in raw mode for its own restart UI (Enter to restart, "rs" to force, Esc to clear). Ink TUIs also want raw stdin, and the two collide — typed characters get eaten, the app gets surprise-restarted, screens flicker. For interactive UIs, restart manually after code changes.
+
+In dev, the bin-resolver tries `LINER_BIN`, the bundled optional package, the repo-local `.venv/bin/liner`, then `liner` on `$PATH`. To point at a specific binary:
+
+```sh
+LINER_BIN=/path/to/liner npm run dev
+```
+
+## Architecture
+
+```
+TapeBrowser ────► NewProjectPrompt ─┐
+       │                            │
+       │          ImportPrompt ─────┤
+       │                            │
+       ├────► TapeEditor ⇄ SourceModal
+       │             │
+       │             ▼
+       │       CompileView (streams NDJSON from `liner compile --emit-events`)
+       │
+       └────► (share/delete inline)
+```
+
+State is global via `AppContext`. YAML is parsed and re-written in Node via the `yaml` package's `Document` API so user-written block comments survive edits. All folder operations (`init`, `compile`, `share`, `import`, `list`) go through the Python CLI as subprocesses — the TUI never reimplements them.
+
+The CLI's `compile --emit-events` streams NDJSON progress events to stdout; the TUI parses each line and updates per-source state live. The final `result` event reports the produced folder, `MIXTAPE.md` path, and per-source file paths.
+
+The same NDJSON protocol will power the planned MCP server, which calls into the same Python core directly without going through the CLI.

package/bin/liner.js

@@ -0,0 +1,126 @@
+#!/usr/bin/env node
+// Entry shim for `npx linersh` / `liner`.
+//
+// No args: launch the Ink TUI from dist/.
+// CLI args: forward to the bundled Python core (or LINER_BIN/dev fallback).
+//
+// This lets the npm package expose one binary name while still supporting
+// mechanical commands like `liner setup-js`, `liner compile`, and `liner status`.
+import { fileURLToPath } from "node:url";
+import { createRequire } from "node:module";
+import { spawn, spawnSync } from "node:child_process";
+import { existsSync } from "node:fs";
+import { dirname, join } from "node:path";
+
+const here = dirname(fileURLToPath(import.meta.url));
+const packageRoot = join(here, "..");
+const argv = process.argv.slice(2);
+
+const CLI_COMMANDS = new Set([
+  "init",
+  "replay",
+  "compile",
+  "share",
+  "import",
+  "clone",
+  "setup-js",
+  "list",
+  "cache",
+  "manifest",
+  "status",
+]);
+
+function wantsCli(args) {
+  if (args.length === 0) return false;
+  const first = args[0];
+  return first === "--help" || first === "--version" || first === "-h" || CLI_COMMANDS.has(first);
+}
+
+if (wantsCli(argv)) {
+  const resolved = resolveCliBinary();
+  const child = spawn(resolved.command, [...resolved.args, ...argv], {
+    stdio: "inherit",
+    env: { ...process.env, LINER_TUI_SHIM: "1" },
+  });
+  child.on("exit", (code, signal) => {
+    if (signal) {
+      process.kill(process.pid, signal);
+      return;
+    }
+    process.exit(code ?? 1);
+  });
+} else {
+  await import(join(packageRoot, "dist", "index.js"));
+}
+
+function resolveCliBinary() {
+  const envBin = process.env.LINER_BIN;
+  if (envBin && existsSync(envBin)) {
+    return { command: envBin, args: [] };
+  }
+
+  const bundled = findBundledBinary();
+  if (bundled) return { command: bundled, args: [] };
+
+  const repoVenv = findRepoVenvBinary();
+  if (repoVenv) return { command: repoVenv, args: [] };
+
+  const pathHit = findPathBinary();
+  if (pathHit) return { command: pathHit, args: [] };
+
+  console.error(
+    [
+      "Could not find the Liner CLI binary.",
+      "",
+      "Expected one of:",
+      "  - LINER_BIN=/path/to/liner",
+      "  - bundled platform package (linersh-<platform>-<arch>)",
+      "  - repo-local .venv/bin/liner",
+      "  - a separate liner on PATH",
+    ].join("\n"),
+  );
+  process.exit(1);
+}
+
+function findBundledBinary() {
+  const require = createRequire(import.meta.url);
+  const target = `linersh-${process.platform}-${process.arch}`;
+  try {
+    const pkgJson = require.resolve(`${target}/package.json`);
+    const baseDir = pkgJson.replace(/[\\/]package\.json$/, "");
+    const candidate = join(baseDir, exeName());
+    return existsSync(candidate) ? candidate : null;
+  } catch {
+    return null;
+  }
+}
+
+function findRepoVenvBinary() {
+  const venvBinDir = process.platform === "win32" ? "Scripts" : "bin";
+  let dir = packageRoot;
+  for (let i = 0; i < 12; i += 1) {
+    const candidate = join(dir, ".venv", venvBinDir, exeName());
+    if (existsSync(candidate)) return candidate;
+    const parent = dirname(dir);
+    if (parent === dir) break;
+    dir = parent;
+  }
+  return null;
+}
+
+function findPathBinary() {
+  const probe = spawnSync(process.platform === "win32" ? "where" : "which", ["liner"], {
+    encoding: "utf8",
+  });
+  if (probe.status !== 0) return null;
+  const hits = probe.stdout
+    .split(/\r?\n/)
+    .map((s) => s.trim())
+    .filter(Boolean);
+  const thisShim = fileURLToPath(import.meta.url);
+  return hits.find((hit) => hit !== thisShim) ?? null;
+}
+
+function exeName() {
+  return process.platform === "win32" ? "liner.exe" : "liner";
+}

package/dist/App.js

@@ -0,0 +1,195 @@
+import React, { useCallback, useEffect, useRef, useState } from "react";
+import { Box, Text } from "ink";
+import { AppContext } from "./store.js";
+import { ERROR } from "./colors.js";
+import { TapeBrowser } from "./screens/TapeBrowser.js";
+import { TapeEditor } from "./screens/TapeEditor.js";
+import { SourceModal } from "./screens/SourceModal.js";
+import { CompileView } from "./screens/CompileView.js";
+import { NewMixtapeWizard } from "./screens/NewMixtapeWizard.js";
+import { ProjectHub } from "./screens/ProjectHub.js";
+import { PhaseRunner } from "./screens/PhaseRunner.js";
+import { FramingConfirmReview } from "./screens/FramingConfirmReview.js";
+import { Gate1Review } from "./screens/Gate1Review.js";
+import { Gate2Review } from "./screens/Gate2Review.js";
+import { TapeDraftReview } from "./screens/TapeDraftReview.js";
+import { ImportPrompt } from "./screens/ImportPrompt.js";
+import { AgentSetup } from "./screens/AgentSetup.js";
+import { ProcessManifest } from "./screens/ProcessManifest.js";
+import { BootSplash, shouldShowSplash } from "./screens/BootSplash.js";
+import { configExists } from "./config.js";
+import { detectAgents } from "./agents/detect.js";
+import { listProjects } from "./ipc.js";
+import { existsSync, mkdirSync } from "node:fs";
+import { join } from "node:path";
+const NOTIFICATION_MS = 3500;
+/** Cap on the back stack — deeper history isn't useful and just costs memory. */
+const HISTORY_LIMIT = 10;
+export function App() {
+    const baseDir = useRef(resolveBaseDir()).current;
+    // Decide what the user sees first. Three states, in priority order:
+    //
+    //   1. Agent setup — first launch on a machine with multiple agents
+    //      installed AND no config file yet. Force a choice before the splash
+    //      so the methodology phases don't hit the mid-phase picker.
+    //   2. Splash — the normal greeting (cassette art + launch menu).
+    //   3. Browser — fallback when stdout isn't a TTY or LINER_NO_SPLASH is
+    //      set (CI runs, narrow terminals).
+    //
+    // Single-agent installs skip step 1: there's nothing to pick. Repeat runs
+    // skip it too because config.yaml exists.
+    const initialScreen = resolveInitialScreen();
+    const [screen, setScreen] = useState(initialScreen);
+    const [history, setHistory] = useState([]);
+    const [projects, setProjects] = useState([]);
+    const [notification, setNotification] = useState(null);
+    const [bootError, setBootError] = useState(null);
+    // navigate(next) pushes the current screen onto a back stack and replaces
+    // it with `next`. Side effect: clears the terminal scrollback when the
+    // user moves between meaningfully different surfaces (any kind change, or
+    // a phaseRunner re-entry with a different phaseId). Clearing happens
+    // before setScreen so Ink's next render lands on a fresh canvas — vs.
+    // clearing after, which would briefly show then erase the new screen.
+    const navigate = useCallback((next) => {
+        setScreen((current) => {
+            setHistory((h) => [...h, current].slice(-HISTORY_LIMIT));
+            if (process.stdout.isTTY && shouldClearOnNavigate(current, next)) {
+                process.stdout.write("\x1B[2J\x1B[3J\x1B[H");
+            }
+            return next;
+        });
+    }, []);
+    // back() pops the history stack and navigates to the prior screen. When
+    // the stack is empty (root) it falls back to the browser. We pop INSIDE
+    // setScreen so the two updates batch and Ink renders once.
+    const back = useCallback(() => {
+        setHistory((h) => {
+            if (h.length === 0) {
+                if (process.stdout.isTTY)
+                    process.stdout.write("\x1B[2J\x1B[3J\x1B[H");
+                setScreen({ kind: "browser" });
+                return h;
+            }
+            const prev = h[h.length - 1];
+            if (process.stdout.isTTY)
+                process.stdout.write("\x1B[2J\x1B[3J\x1B[H");
+            setScreen(prev);
+            return h.slice(0, -1);
+        });
+    }, []);
+    const refreshProjects = useCallback(async () => {
+        try {
+            const result = await listProjects(baseDir);
+            setProjects(result);
+        }
+        catch (e) {
+            setBootError(e.message);
+        }
+    }, [baseDir]);
+    useEffect(() => {
+        void refreshProjects();
+    }, [refreshProjects]);
+    useEffect(() => {
+        if (!notification)
+            return;
+        const timer = setTimeout(() => setNotification(null), NOTIFICATION_MS);
+        return () => clearTimeout(timer);
+    }, [notification]);
+    if (bootError) {
+        return (React.createElement(Box, { flexDirection: "column" },
+            React.createElement(Text, { color: ERROR }, bootError),
+            React.createElement(Text, { dimColor: true }, "Press Ctrl+C to exit.")));
+    }
+    const ctx = {
+        screen,
+        baseDir,
+        projects,
+        notification,
+        navigate,
+        back,
+        refreshProjects,
+        setNotification,
+    };
+    return (React.createElement(AppContext.Provider, { value: ctx },
+        React.createElement(ScreenRoot, { screen: screen })));
+}
+function ScreenRoot({ screen }) {
+    switch (screen.kind) {
+        case "splash":
+            return React.createElement(BootSplash, null);
+        case "agentSetup":
+            return React.createElement(AgentSetup, null);
+        case "browser":
+            return React.createElement(TapeBrowser, null);
+        case "newProject":
+            return React.createElement(NewMixtapeWizard, null);
+        case "hub":
+            return React.createElement(ProjectHub, { tape: screen.tape, folder: screen.folder });
+        case "phaseRunner":
+            // `key` forces React to unmount and remount when phaseId changes —
+            // PhaseRunner's auto-launch effect has empty deps and only fires on
+            // initial mount, so without the key, navigating Phase 2 → Phase 4 (both
+            // "phaseRunner" kind) leaves the component dormant: same DOM, no
+            // agent launch. The remount is also what resets the tool list,
+            // finalText, and stats from the previous phase.
+            return (React.createElement(PhaseRunner, { key: screen.phaseId, tape: screen.tape, folder: screen.folder, phaseId: screen.phaseId }));
+        case "gate0":
+            return React.createElement(FramingConfirmReview, { tape: screen.tape, folder: screen.folder });
+        case "gate1":
+            return React.createElement(Gate1Review, { tape: screen.tape, folder: screen.folder });
+        case "gate2":
+            return React.createElement(Gate2Review, { tape: screen.tape, folder: screen.folder });
+        case "tapeDraft":
+            return React.createElement(TapeDraftReview, { tape: screen.tape, folder: screen.folder });
+        case "import":
+            return React.createElement(ImportPrompt, null);
+        case "editor":
+            return React.createElement(TapeEditor, { tape: screen.tape, folder: screen.folder });
+        case "sourceModal":
+            return (React.createElement(SourceModal, { tape: screen.tape, folder: screen.folder, editingIndex: screen.editingIndex }));
+        case "compile":
+            return React.createElement(CompileView, { tape: screen.tape, folder: screen.folder });
+        case "manifest":
+            return React.createElement(ProcessManifest, { tape: screen.tape, folder: screen.folder });
+    }
+}
+/**
+ * Pick the screen the user lands on at startup. See the inline doc in
+ * `App()` for the priority order.
+ */
+function resolveInitialScreen() {
+    // If no splash (non-TTY / narrow / opted-out), don't show setup either —
+    // the user is probably in CI or scripting and just wants the browser.
+    if (!shouldShowSplash())
+        return { kind: "browser" };
+    // First-run setup only when we have a real choice to surface. One agent
+    // (or zero) → just go to splash; setup would be a no-op.
+    if (!configExists()) {
+        const installed = detectAgents();
+        if (installed.length >= 2)
+            return { kind: "agentSetup" };
+    }
+    return { kind: "splash" };
+}
+/**
+ * Decide whether navigation `prev → next` should clear the terminal. We clear
+ * on any kind change, and on phaseRunner re-entry with a different phaseId so
+ * "entering Phase 3" feels like starting fresh, not stacking on top of Phase 2.
+ */
+function shouldClearOnNavigate(prev, next) {
+    if (prev.kind !== next.kind)
+        return true;
+    if (prev.kind === "phaseRunner" && next.kind === "phaseRunner") {
+        return prev.phaseId !== next.phaseId;
+    }
+    return false;
+}
+function resolveBaseDir() {
+    const override = process.env["LINER_DIR"];
+    const dir = override || join(process.cwd(), "mixtapes");
+    if (!existsSync(dir)) {
+        mkdirSync(dir, { recursive: true });
+    }
+    return dir;
+}
+//# sourceMappingURL=App.js.map

package/dist/App.js.map

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

package/dist/agents/detect.js

@@ -0,0 +1,102 @@
+import { spawnSync } from "node:child_process";
+import { existsSync } from "node:fs";
+import { join, dirname } from "node:path";
+/**
+ * Resolve an agent binary path. Resolution order:
+ *
+ *   1. Explicit env override (`LINER_CLAUDE_BIN` / `LINER_CODEX_BIN`).
+ *      Honored even if the path is missing — we surface the path the user
+ *      named so they can see exactly what was tried.
+ *   2. `which <name>` against the inherited PATH. Fast and correct for the
+ *      common case (user launched the TUI from their normal shell).
+ *   3. `bash -lc 'command -v <name>'` against the *login* shell. Costs ~50ms
+ *      but sources the user's shell init (.bashrc / .zshrc / fnm / nvm /
+ *      asdf), catching version-manager shims that aren't in the TUI's
+ *      inherited PATH — e.g. cmux-launched sessions where fnm hasn't run.
+ *
+ * Returning null means "definitely not installed" — both shells failed and
+ * no env override was set.
+ */
+function resolveBin(name, envVar) {
+    const override = process.env[envVar];
+    if (override && override.trim())
+        return override.trim();
+    const direct = spawnSync("which", [name], { encoding: "utf8" });
+    if (direct.status === 0) {
+        const out = direct.stdout.trim();
+        if (out)
+            return out;
+    }
+    // Fall back to a login shell so shims (fnm / nvm / asdf / pyenv / etc.)
+    // get a chance to register. `command -v` is POSIX-portable; `-l` makes
+    // bash source the login profile that puts those shims on PATH.
+    const viaLoginShell = spawnSync("bash", ["-lc", `command -v ${name}`], {
+        encoding: "utf8",
+    });
+    if (viaLoginShell.status === 0) {
+        const out = viaLoginShell.stdout.trim();
+        if (out)
+            return out;
+    }
+    return null;
+}
+/**
+ * Names the env var that overrides binary detection for an agent. Mirrors
+ * the LINER_BIN pattern from bin-resolver — explicit > inferred.
+ */
+export function envVarForAgent(id) {
+    return id === "claude" ? "LINER_CLAUDE_BIN" : "LINER_CODEX_BIN";
+}
+/** Catalog of agents the TUI knows how to drive. Single source of truth so
+ *  `detectAgents` and the "not detected" UI in AgentSetup stay in sync. */
+export const KNOWN_AGENTS = [
+    { id: "claude", name: "Claude Code", envVar: "LINER_CLAUDE_BIN" },
+    { id: "codex", name: "OpenAI Codex", envVar: "LINER_CODEX_BIN" },
+];
+export function detectAgents() {
+    const found = [];
+    for (const meta of KNOWN_AGENTS) {
+        const bin = resolveBin(meta.id, meta.envVar);
+        if (bin)
+            found.push({ id: meta.id, name: meta.name, bin });
+    }
+    return found;
+}
+/**
+ * Find the curating-mixtapes skill bundle on disk.
+ *
+ * Resolution order:
+ *   1. `LINER_SKILL_PATH` env var (must contain SKILL.md).
+ *   2. Walk up from cwd looking for `cli-update-docs/SKILL.md` or
+ *      `skills/curating-mixtapes/SKILL.md`.
+ *   3. Walk up from the TUI binary location (covers the dev/global-install case).
+ */
+export function resolveSkillPath() {
+    const env = process.env["LINER_SKILL_PATH"];
+    if (env && existsSync(join(env, "SKILL.md")))
+        return env;
+    const candidates = ["cli-update-docs", "skills/curating-mixtapes"];
+    const searchFromRoots = [process.cwd(), dirname(process.argv[1] ?? "")].filter(Boolean);
+    for (const root of searchFromRoots) {
+        const hit = walkUp(root, candidates);
+        if (hit)
+            return hit;
+    }
+    return null;
+}
+function walkUp(start, candidates) {
+    let dir = start;
+    for (let i = 0; i < 12; i++) {
+        for (const rel of candidates) {
+            const guess = join(dir, rel);
+            if (existsSync(join(guess, "SKILL.md")))
+                return guess;
+        }
+        const parent = dirname(dir);
+        if (parent === dir)
+            return null;
+        dir = parent;
+    }
+    return null;
+}
+//# sourceMappingURL=detect.js.map

package/dist/agents/detect.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"detect.js","sourceRoot":"","sources":["../../src/agents/detect.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,SAAS,EAAE,MAAM,oBAAoB,CAAC;AAC/C,OAAO,EAAE,UAAU,EAAE,MAAM,SAAS,CAAC;AACrC,OAAO,EAAE,IAAI,EAAE,OAAO,EAAE,MAAM,WAAW,CAAC;AAG1C;;;;;;;;;;;;;;;GAeG;AACH,SAAS,UAAU,CAAC,IAAY,EAAE,MAAc;IAC9C,MAAM,QAAQ,GAAG,OAAO,CAAC,GAAG,CAAC,MAAM,CAAC,CAAC;IACrC,IAAI,QAAQ,IAAI,QAAQ,CAAC,IAAI,EAAE;QAAE,OAAO,QAAQ,CAAC,IAAI,EAAE,CAAC;IAExD,MAAM,MAAM,GAAG,SAAS,CAAC,OAAO,EAAE,CAAC,IAAI,CAAC,EAAE,EAAE,QAAQ,EAAE,MAAM,EAAE,CAAC,CAAC;IAChE,IAAI,MAAM,CAAC,MAAM,KAAK,CAAC,EAAE,CAAC;QACxB,MAAM,GAAG,GAAG,MAAM,CAAC,MAAM,CAAC,IAAI,EAAE,CAAC;QACjC,IAAI,GAAG;YAAE,OAAO,GAAG,CAAC;IACtB,CAAC;IAED,wEAAwE;IACxE,uEAAuE;IACvE,+DAA+D;IAC/D,MAAM,aAAa,GAAG,SAAS,CAAC,MAAM,EAAE,CAAC,KAAK,EAAE,cAAc,IAAI,EAAE,CAAC,EAAE;QACrE,QAAQ,EAAE,MAAM;KACjB,CAAC,CAAC;IACH,IAAI,aAAa,CAAC,MAAM,KAAK,CAAC,EAAE,CAAC;QAC/B,MAAM,GAAG,GAAG,aAAa,CAAC,MAAM,CAAC,IAAI,EAAE,CAAC;QACxC,IAAI,GAAG;YAAE,OAAO,GAAG,CAAC;IACtB,CAAC;IAED,OAAO,IAAI,CAAC;AACd,CAAC;AAED;;;GAGG;AACH,MAAM,UAAU,cAAc,CAAC,EAAW;IACxC,OAAO,EAAE,KAAK,QAAQ,CAAC,CAAC,CAAC,kBAAkB,CAAC,CAAC,CAAC,iBAAiB,CAAC;AAClE,CAAC;AAED;2EAC2E;AAC3E,MAAM,CAAC,MAAM,YAAY,GAAiE;IACxF,EAAE,EAAE,EAAE,QAAQ,EAAE,IAAI,EAAE,aAAa,EAAE,MAAM,EAAE,kBAAkB,EAAE;IACjE,EAAE,EAAE,EAAE,OAAO,EAAE,IAAI,EAAE,cAAc,EAAE,MAAM,EAAE,iBAAiB,EAAE;CACjE,CAAC;AAEF,MAAM,UAAU,YAAY;IAC1B,MAAM,KAAK,GAAsB,EAAE,CAAC;IACpC,KAAK,MAAM,IAAI,IAAI,YAAY,EAAE,CAAC;QAChC,MAAM,GAAG,GAAG,UAAU,CAAC,IAAI,CAAC,EAAE,EAAE,IAAI,CAAC,MAAM,CAAC,CAAC;QAC7C,IAAI,GAAG;YAAE,KAAK,CAAC,IAAI,CAAC,EAAE,EAAE,EAAE,IAAI,CAAC,EAAE,EAAE,IAAI,EAAE,IAAI,CAAC,IAAI,EAAE,GAAG,EAAE,CAAC,CAAC;IAC7D,CAAC;IACD,OAAO,KAAK,CAAC;AACf,CAAC;AAED;;;;;;;;GAQG;AACH,MAAM,UAAU,gBAAgB;IAC9B,MAAM,GAAG,GAAG,OAAO,CAAC,GAAG,CAAC,kBAAkB,CAAC,CAAC;IAC5C,IAAI,GAAG,IAAI,UAAU,CAAC,IAAI,CAAC,GAAG,EAAE,UAAU,CAAC,CAAC;QAAE,OAAO,GAAG,CAAC;IAEzD,MAAM,UAAU,GAAG,CAAC,iBAAiB,EAAE,0BAA0B,CAAC,CAAC;IAEnE,MAAM,eAAe,GAAG,CAAC,OAAO,CAAC,GAAG,EAAE,EAAE,OAAO,CAAC,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC,IAAI,EAAE,CAAC,CAAC,CAAC,MAAM,CAAC,OAAO,CAAC,CAAC;IACxF,KAAK,MAAM,IAAI,IAAI,eAAe,EAAE,CAAC;QACnC,MAAM,GAAG,GAAG,MAAM,CAAC,IAAI,EAAE,UAAU,CAAC,CAAC;QACrC,IAAI,GAAG;YAAE,OAAO,GAAG,CAAC;IACtB,CAAC;IACD,OAAO,IAAI,CAAC;AACd,CAAC;AAED,SAAS,MAAM,CAAC,KAAa,EAAE,UAA6B;IAC1D,IAAI,GAAG,GAAG,KAAK,CAAC;IAChB,KAAK,IAAI,CAAC,GAAG,CAAC,EAAE,CAAC,GAAG,EAAE,EAAE,CAAC,EAAE,EAAE,CAAC;QAC5B,KAAK,MAAM,GAAG,IAAI,UAAU,EAAE,CAAC;YAC7B,MAAM,KAAK,GAAG,IAAI,CAAC,GAAG,EAAE,GAAG,CAAC,CAAC;YAC7B,IAAI,UAAU,CAAC,IAAI,CAAC,KAAK,EAAE,UAAU,CAAC,CAAC;gBAAE,OAAO,KAAK,CAAC;QACxD,CAAC;QACD,MAAM,MAAM,GAAG,OAAO,CAAC,GAAG,CAAC,CAAC;QAC5B,IAAI,MAAM,KAAK,GAAG;YAAE,OAAO,IAAI,CAAC;QAChC,GAAG,GAAG,MAAM,CAAC;IACf,CAAC;IACD,OAAO,IAAI,CAAC;AACd,CAAC"}

package/dist/agents/events.js

@@ -0,0 +1,8 @@
+// Normalized event stream used by the TUI to render agent progress.
+//
+// Both Claude (`--output-format stream-json --verbose`) and Codex (`--json`)
+// emit newline-delimited JSON. Their schemas differ; per-CLI parsers in this
+// directory convert each line into one of the AgentEvent variants below so
+// the PhaseRunner UI is agent-agnostic.
+export {};
+//# sourceMappingURL=events.js.map

package/dist/agents/events.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"events.js","sourceRoot":"","sources":["../../src/agents/events.ts"],"names":[],"mappings":"AAAA,oEAAoE;AACpE,EAAE;AACF,6EAA6E;AAC7E,6EAA6E;AAC7E,2EAA2E;AAC3E,wCAAwC"}