@synaplink/orqlaude 0.5.6 → 0.7.0

package/README.md

@@ -226,17 +226,43 @@ False positives are acceptable here — we surface concerns, we don't auto-kill.
 
 ## CLI
 
-Two binaries are installed: `orqlaude` and the short alias `orql`. Use whichever feels right.
+Two binaries are installed: `orqlaude` and the short alias `orql`. Use whichever feels right. All commands work the same.
+
+### Live (v0.6+)
 
 ```sh
+orql watch <plan_id>            # live-updating dashboard (1Hz, Ctrl-C to exit)
+orql tail [plan_id]             # tail -f the audit log; filter by plan if given
+orql open <plan_id>             # open every PR from a plan in your browser
+orql doctor                     # end-to-end health check
+orql about                      # the easter egg
+```
+
+### Local desktop notifications (macOS)
+
+```sh
+orql notify on                  # enable; the Telegram bot will also fire osascript banners
+orql notify off                 # disable
+orql notify test                # send a test notification
+orql notify status              # is it on?
+```
+
+### Read-only inspection (`--json` on every one)
+
+
+
+```sh
+orql                            # banner + active-plan summary
 orql list                       # every plan in this project
-orql status <plan_id>           # refreshed status of one plan
-orql show <plan_id>             # raw plan JSON
+orql status [plan_id]           # if omitted, picker prompts
+orql show [plan_id]             # raw plan JSON
 orql history --limit 50         # tail audit log
 orql where                      # show resolved state dir
 orql help
 ```
 
+Every read command supports `--json` to emit machine-readable output for scripting.
+
 Read-only. For active orchestration, use the MCP from inside Claude Code.
 
 ### Branding & colors (v0.5+)
@@ -337,6 +363,13 @@ The bot uses raw `fetch` against Telegram's Bot API — zero extra deps. State i
 **Symptom: `ENOENT: no such file or directory, mkdir '/.orqlaude'` on `create_plan`.**
 Your MCP host launched orqlaude with `cwd=/`. v0.3.2+ auto-falls back to `~/.orqlaude/projects/...` but the explicit fix is to set `ORQLAUDE_STATE_DIR` in your `.mcp.json` env block (see `.mcp.json.template`). Verify with `mcp__orqlaude__ping` — it now returns `warnings` and `state_dir_source`.
 
+**Symptom: `spawn_via_cli` returned a PID but `status()` shows `died_at_launch` shortly after, with a stderr_excerpt + command_line.**
+This is the v0.7.0 hardening doing its job. The child `claude -p` process exited within the 1.5s healthcheck window. Read `stderr_excerpt` (or open `stderr_path` directly) for the cause. Common ones:
+1. `claude` isn't authenticated on this user account (`claude auth status` to check; `claude auth login --claudeai` to fix).
+2. The `--mcp-config` JSON references a server entry that doesn't exist (rare; orqlaude validates this pre-spawn).
+3. The user's environment lacks something `claude` needs (HOME, locale).
+Copy the `command_line` field and paste it into a shell to reproduce by hand.
+
 **Symptom: spawn_task chip appeared, agent ran, but `status()` shows the task as `dispatched` forever.**
 The child agent isn't calling `checkin` on its first turn — its prompt didn't get the orqlaude protocol block, or `mcp__orqlaude__checkin` isn't available in the spawned session. Manual unblock: `register_spawn(plan_id, task_id, session_id)` where session_id is the child's session UUID (find via `mcp__ccd_session_mgmt__list_sessions`). For the proper fix, make sure orqlaude is in the spawned worktree's `.mcp.json` (commit `.mcp.json` to the repo so worktrees inherit it).
 

package/dist/__tests__/v06.test.d.ts

@@ -0,0 +1 @@
+export {};

package/dist/__tests__/v06.test.js

@@ -0,0 +1,74 @@
+import { test } from "node:test";
+import assert from "node:assert/strict";
+import { promises as fs } from "node:fs";
+import path from "node:path";
+import os from "node:os";
+/** v0.6.0 regression tests covering the polish-pack modules. */
+test("preferences: read/write/update round-trip", async () => {
+    const fakeHome = await fs.mkdtemp(path.join(os.tmpdir(), "orqlaude-prefs-"));
+    const realHome = process.env.HOME;
+    process.env.HOME = fakeHome;
+    try {
+        // Re-import so PREFS_PATH picks up the new HOME. The module caches the
+        // path at import time, so this technique only works in a fresh worker —
+        // we accept that and validate the shape rather than the path.
+        const { readPreferences, updatePreferences } = await import(`../lib/preferences.js?cache=${Date.now()}`);
+        let prefs = await readPreferences();
+        assert.deepEqual(prefs, {});
+        await updatePreferences((p) => {
+            p.welcomedAt = 1234;
+            p.localNotifications = true;
+        });
+        prefs = await readPreferences();
+        assert.equal(prefs.welcomedAt, 1234);
+        assert.equal(prefs.localNotifications, true);
+    }
+    finally {
+        if (realHome)
+            process.env.HOME = realHome;
+        else
+            delete process.env.HOME;
+    }
+});
+test("error_ui: formatError attaches suggestions for known patterns", async () => {
+    const { formatError } = await import("../lib/error_ui.js");
+    assert.match(formatError(new Error("Plan not found: abc")).suggestion, /orql list/);
+    assert.match(formatError(new Error("EACCES: write failed")).suggestion, /ORQLAUDE_STATE_DIR/);
+    assert.match(formatError(new Error("ENOENT: nope")).suggestion, /missing path|orql setup/);
+    // Unknown messages get no suggestion (returns undefined).
+    assert.equal(formatError(new Error("something obscure")).suggestion, undefined);
+});
+test("json_out: hasJsonFlag detects --json anywhere in args", async () => {
+    const { hasJsonFlag } = await import("../lib/json_out.js");
+    assert.equal(hasJsonFlag([]), false);
+    assert.equal(hasJsonFlag(["foo"]), false);
+    assert.equal(hasJsonFlag(["--json"]), true);
+    assert.equal(hasJsonFlag(["foo", "--json", "bar"]), true);
+});
+test("notifications: isNotificationsAvailable matches platform", async () => {
+    const { isNotificationsAvailable } = await import("../lib/notifications.js");
+    assert.equal(isNotificationsAvailable(), process.platform === "darwin");
+});
+test("error_ui: errorLine includes ✗ glyph and optional suggestion", async () => {
+    const { errorLine } = await import("../lib/error_ui.js");
+    const noSuggestion = errorLine("bad");
+    // String includes "bad" and the glyph "✗"
+    assert.ok(noSuggestion.includes("✗"));
+    assert.ok(noSuggestion.includes("bad"));
+    const withSuggestion = errorLine("bad", "try foo");
+    assert.ok(withSuggestion.includes("try foo"));
+    assert.ok(withSuggestion.includes("→"));
+});
+test("v0.6.1 taglines: exactly 149, all non-empty, no consecutive duplicates", async () => {
+    const { TAGLINES } = await import("../cli/taglines.js");
+    assert.equal(TAGLINES.length, 149);
+    for (let i = 0; i < TAGLINES.length; i++) {
+        assert.ok(typeof TAGLINES[i] === "string" && TAGLINES[i].length > 0, `tagline ${i} is empty`);
+    }
+    // The picker uses a never-repeat-last constraint, so duplicates between
+    // non-adjacent indices are fine — but adjacent duplicates would defeat it.
+    for (let i = 1; i < TAGLINES.length; i++) {
+        assert.notEqual(TAGLINES[i], TAGLINES[i - 1], `adjacent duplicate at ${i - 1}/${i}`);
+    }
+});
+//# sourceMappingURL=v06.test.js.map

package/dist/__tests__/v06.test.js.map

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

package/dist/__tests__/v07.test.d.ts

@@ -0,0 +1 @@
+export {};

package/dist/__tests__/v07.test.js

@@ -0,0 +1,124 @@
+import { test } from "node:test";
+import assert from "node:assert/strict";
+import { promises as fs, existsSync } from "node:fs";
+import path from "node:path";
+import os from "node:os";
+import { execSync } from "node:child_process";
+import { isProcessAlive } from "../lib/process_lib.js";
+import { spawnAgnetViaCli } from "../lib/spawn_cli.js";
+/**
+ * v0.7.0: process-liveness + spawn robustness regression tests.
+ */
+test("isProcessAlive: own PID is alive", () => {
+    assert.equal(isProcessAlive(process.pid), true);
+});
+test("isProcessAlive: PID 1 reports alive (init exists on every OS)", () => {
+    // We don't OWN pid 1, but isProcessAlive should report true via EPERM
+    // detection rather than returning false.
+    assert.equal(isProcessAlive(1), true);
+});
+test("isProcessAlive: impossibly large PID is dead", () => {
+    // 2^31 - 1 is past any realistic process table.
+    assert.equal(isProcessAlive(2147483647), false);
+});
+test("isProcessAlive: 0 / negative / undefined are dead", () => {
+    assert.equal(isProcessAlive(0), false);
+    assert.equal(isProcessAlive(-1), false);
+    assert.equal(isProcessAlive(undefined), false);
+    assert.equal(isProcessAlive(null), false);
+});
+test("spawnAgnetViaCli: rejects when claude binary doesn't exist", async () => {
+    // Build a minimal fake git repo so createWorktreeForTask doesn't fail
+    // earlier on its own.
+    const dir = await mkTempGitRepo();
+    await assert.rejects(() => spawnAgnetViaCli({
+        projectRoot: dir,
+        stateDir: path.join(dir, ".orqlaude"),
+        planId: "deadbeef-1111-2222-3333-444444444444",
+        taskId: "11111111-2222-3333-4444-555555555555",
+        agnetName: "Test",
+        prompt: "noop",
+        claudeBin: "/nonexistent/path/to/claude",
+        healthCheckDelayMs: 0,
+    }), /not executable|ENOENT|EACCES/i);
+});
+test("spawnAgnetViaCli: when child dies at launch, throws with stderr + commandLine", async () => {
+    // Use /bin/false (or `false` on PATH) — it exits immediately with code 1.
+    // The healthcheck should detect the dead PID and throw with autopsy info.
+    const falseBin = existsSync("/bin/false") ? "/bin/false" : "/usr/bin/false";
+    if (!existsSync(falseBin)) {
+        // Skip on platforms without /bin/false; the contract is otherwise
+        // verified by the other tests.
+        return;
+    }
+    const dir = await mkTempGitRepo();
+    await assert.rejects(() => spawnAgnetViaCli({
+        projectRoot: dir,
+        stateDir: path.join(dir, ".orqlaude"),
+        planId: "deadbeef-1111-2222-3333-444444444444",
+        taskId: "22222222-3333-4444-5555-666666666666",
+        agnetName: "Dies",
+        prompt: "this prompt should appear in the command line echo",
+        claudeBin: falseBin,
+        healthCheckDelayMs: 500, // short
+    }), (err) => {
+        // The error message must include:
+        //   • "died at launch"
+        //   • the command line (so we can copy-paste to reproduce)
+        //   • mention of the prompt as the last arg
+        assert.match(err.message, /died at launch/i);
+        assert.match(err.message, /Command line:/i);
+        assert.match(err.message, /this prompt should appear in the command line echo/);
+        return true;
+    });
+    // After failure, the stderr log file should exist in the worktree.
+    const worktreeBase = path.join(dir, ".orqlaude-worktrees");
+    const found = await fs.readdir(worktreeBase);
+    assert.ok(found.length > 0, "expected a worktree to have been created before the spawn died");
+});
+test("spawnAgnetViaCli: prompt is the LAST positional argv element", async () => {
+    // Same /bin/false trick but assert on the exact shape of commandLine
+    // captured in the thrown error.
+    const falseBin = existsSync("/bin/false") ? "/bin/false" : "/usr/bin/false";
+    if (!existsSync(falseBin))
+        return;
+    const dir = await mkTempGitRepo();
+    let captured = null;
+    try {
+        await spawnAgnetViaCli({
+            projectRoot: dir,
+            stateDir: path.join(dir, ".orqlaude"),
+            planId: "deadbeef-aaaa-bbbb-cccc-dddddddddddd",
+            taskId: "33333333-4444-5555-6666-777777777777",
+            agnetName: "ArgOrder",
+            prompt: "ZZZ_PROMPT_SENTINEL_ZZZ",
+            claudeBin: falseBin,
+            healthCheckDelayMs: 500,
+        });
+    }
+    catch (err) {
+        captured = err.message;
+    }
+    assert.ok(captured, "expected the spawn to fail and surface the command line");
+    // Pull the command-line line from the error message.
+    const m = captured.match(/Command line:\n\s*(.+)/);
+    assert.ok(m, "error message should contain 'Command line:'");
+    const cmd = m[1];
+    // The last shell token should be the quoted prompt — i.e. the prompt
+    // sentinel should appear AFTER every --flag.
+    const promptIdx = cmd.lastIndexOf("ZZZ_PROMPT_SENTINEL_ZZZ");
+    const lastFlagIdx = Math.max(cmd.lastIndexOf("--session-id"), cmd.lastIndexOf("--output-format"), cmd.lastIndexOf("--permission-mode"), cmd.lastIndexOf("--mcp-config"));
+    assert.ok(promptIdx > lastFlagIdx, `prompt must appear after the last flag — got cmd=\n${cmd}`);
+});
+async function mkTempGitRepo() {
+    const raw = await fs.mkdtemp(path.join(os.tmpdir(), "orqlaude-v07-"));
+    const real = await fs.realpath(raw);
+    execSync("git init -q", { cwd: real });
+    execSync("git config user.email t@e", { cwd: real });
+    execSync("git config user.name t", { cwd: real });
+    // Need at least one commit so `git worktree add -b ...` succeeds.
+    await fs.writeFile(path.join(real, "README.md"), "test\n");
+    execSync("git add . && git commit -q -m init", { cwd: real });
+    return real;
+}
+//# sourceMappingURL=v07.test.js.map

package/dist/__tests__/v07.test.js.map

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

package/dist/cli/about.d.ts

@@ -0,0 +1,5 @@
+/**
+ * `orql about` — the easter egg. Print a small stylized "what is this"
+ * blurb in the brand palette. Just because.
+ */
+export declare function showAbout(version: string): number;

package/dist/cli/about.js

@@ -0,0 +1,27 @@
+import { style } from "../lib/style.js";
+/**
+ * `orql about` — the easter egg. Print a small stylized "what is this"
+ * blurb in the brand palette. Just because.
+ */
+export function showAbout(version) {
+    const lines = [
+        "",
+        `  ${style.coral("◆")} ${style.bold(style.coral("orqlaude"))}`,
+        "",
+        `  ${style.sand("one Claude session decomposes a task,")}`,
+        `  ${style.sand("approves a budget,")}`,
+        `  ${style.sand("dispatches a fleet of")} ${style.coral("Agnets")} ${style.sand("—")}`,
+        `  ${style.sand("each in its own worktree, named, tracked,")}`,
+        `  ${style.sand("brokered, budgeted, watchable.")}`,
+        "",
+        `  ${style.dim(`v${version} · MIT · @synaplink/orqlaude`)}`,
+        "",
+        `  ${style.cream("\"More agents working on a task in parallel is just")}`,
+        `  ${style.cream("a faster way of reaching")} ${style.coral("the same insight")}.${style.cream("\"")}`,
+        `  ${style.dim("— Claude (probably)")}`,
+        "",
+    ];
+    process.stdout.write(lines.join("\n"));
+    return 0;
+}
+//# sourceMappingURL=about.js.map

package/dist/cli/about.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"about.js","sourceRoot":"","sources":["../../src/cli/about.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,KAAK,EAAE,MAAM,iBAAiB,CAAC;AAExC;;;GAGG;AAEH,MAAM,UAAU,SAAS,CAAC,OAAe;IACvC,MAAM,KAAK,GAAG;QACZ,EAAE;QACF,KAAK,KAAK,CAAC,KAAK,CAAC,GAAG,CAAC,IAAI,KAAK,CAAC,IAAI,CAAC,KAAK,CAAC,KAAK,CAAC,UAAU,CAAC,CAAC,EAAE;QAC9D,EAAE;QACF,KAAK,KAAK,CAAC,IAAI,CAAC,uCAAuC,CAAC,EAAE;QAC1D,KAAK,KAAK,CAAC,IAAI,CAAC,oBAAoB,CAAC,EAAE;QACvC,KAAK,KAAK,CAAC,IAAI,CAAC,uBAAuB,CAAC,IAAI,KAAK,CAAC,KAAK,CAAC,QAAQ,CAAC,IAAI,KAAK,CAAC,IAAI,CAAC,GAAG,CAAC,EAAE;QACtF,KAAK,KAAK,CAAC,IAAI,CAAC,2CAA2C,CAAC,EAAE;QAC9D,KAAK,KAAK,CAAC,IAAI,CAAC,gCAAgC,CAAC,EAAE;QACnD,EAAE;QACF,KAAK,KAAK,CAAC,GAAG,CAAC,IAAI,OAAO,8BAA8B,CAAC,EAAE;QAC3D,EAAE;QACF,KAAK,KAAK,CAAC,KAAK,CAAC,qDAAqD,CAAC,EAAE;QACzE,KAAK,KAAK,CAAC,KAAK,CAAC,0BAA0B,CAAC,IAAI,KAAK,CAAC,KAAK,CAAC,kBAAkB,CAAC,IAAI,KAAK,CAAC,KAAK,CAAC,IAAI,CAAC,EAAE;QACtG,KAAK,KAAK,CAAC,GAAG,CAAC,qBAAqB,CAAC,EAAE;QACvC,EAAE;KACH,CAAC;IACF,OAAO,CAAC,MAAM,CAAC,KAAK,CAAC,KAAK,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC,CAAC;IACvC,OAAO,CAAC,CAAC;AACX,CAAC"}

package/dist/cli/doctor.d.ts

@@ -0,0 +1 @@
+export declare function runDoctor(currentVersion: string): Promise<number>;

package/dist/cli/doctor.js

@@ -0,0 +1,180 @@
+import { execSync } from "node:child_process";
+import { existsSync } from "node:fs";
+import path from "node:path";
+import { style, banner } from "../lib/style.js";
+import { discoverClaudeBinary } from "../lib/spawn_cli.js";
+import { resolveStateDir } from "../lib/state_dir.js";
+import { probeTelegramStatus } from "../lib/telegram_status.js";
+import { findDesktopConfigPath, readDesktopConfig } from "../lib/desktop_config.js";
+export async function runDoctor(currentVersion) {
+    console.log(banner());
+    console.log("");
+    console.log(style.bold(style.cream("doctor")));
+    console.log("");
+    const checks = [];
+    // 1. Node version
+    const nodeVer = process.version.replace(/^v/, "");
+    const major = parseInt(nodeVer.split(".")[0], 10);
+    checks.push({
+        name: "Node.js >= 22",
+        status: major >= 22 ? "ok" : "fail",
+        detail: `Node ${nodeVer}`,
+        fix: major < 22 ? "Install Node 22+ (brew install node@22)" : undefined,
+    });
+    // 2. claude binary
+    try {
+        const claudeBin = discoverClaudeBinary();
+        let claudeVer = "(version probe failed)";
+        try {
+            claudeVer = execSync(`"${claudeBin}" --version`, { encoding: "utf8", timeout: 3000 }).trim();
+        }
+        catch {
+            /* ignore */
+        }
+        checks.push({ name: "claude binary", status: "ok", detail: `${claudeBin} (${claudeVer})` });
+    }
+    catch (err) {
+        checks.push({
+            name: "claude binary",
+            status: "fail",
+            detail: err.message,
+            fix: "Install Claude Code, or set CLAUDE_BIN env var to its path. spawn_via_cli won't work without this.",
+        });
+    }
+    // 3. gh CLI
+    try {
+        const ghVer = execSync("gh --version", { encoding: "utf8", timeout: 3000 }).split("\n")[0];
+        let authed = false;
+        try {
+            execSync("gh auth status", { encoding: "utf8", timeout: 3000, stdio: "pipe" });
+            authed = true;
+        }
+        catch {
+            authed = false;
+        }
+        checks.push({
+            name: "gh CLI + auth",
+            status: authed ? "ok" : "warn",
+            detail: authed ? ghVer : `${ghVer} (not authenticated)`,
+            fix: authed ? undefined : "Run `gh auth login` so Agnets can open PRs.",
+        });
+    }
+    catch {
+        checks.push({
+            name: "gh CLI + auth",
+            status: "warn",
+            detail: "gh not installed",
+            fix: "brew install gh; gh auth login. Agnets can still run without it, but PRs won't auto-open.",
+        });
+    }
+    // 4. Resolved state dir
+    const stateRes = resolveStateDir();
+    const stateOk = stateRes.source === "env" || stateRes.source === "project-root" || stateRes.source === "worktree";
+    checks.push({
+        name: "state dir",
+        status: stateOk ? "ok" : "warn",
+        detail: `${stateRes.path} (source: ${stateRes.source})`,
+        fix: stateOk
+            ? undefined
+            : `Run \`orql setup\` from your project to pin state via ORQLAUDE_STATE_DIR in the Desktop MCP config.`,
+    });
+    // 5. Claude Desktop MCP config
+    const cfgPath = findDesktopConfigPath();
+    if (existsSync(cfgPath)) {
+        try {
+            const cfg = await readDesktopConfig(cfgPath);
+            const entry = cfg?.mcpServers?.orqlaude;
+            if (!entry) {
+                checks.push({
+                    name: "Desktop MCP config",
+                    status: "fail",
+                    detail: `${cfgPath} exists, but no orqlaude entry`,
+                    fix: "Run `orql setup` in your project to add the entry.",
+                });
+            }
+            else if (!entry.env?.ORQLAUDE_STATE_DIR) {
+                checks.push({
+                    name: "Desktop MCP config",
+                    status: "warn",
+                    detail: "orqlaude entry present but has no ORQLAUDE_STATE_DIR env",
+                    fix: "Run `orql setup` to pin a state dir; without it, MCP cwd=/ can split state.",
+                });
+            }
+            else {
+                checks.push({
+                    name: "Desktop MCP config",
+                    status: "ok",
+                    detail: `ORQLAUDE_STATE_DIR → ${entry.env.ORQLAUDE_STATE_DIR}`,
+                });
+            }
+        }
+        catch (err) {
+            checks.push({
+                name: "Desktop MCP config",
+                status: "fail",
+                detail: err.message,
+            });
+        }
+    }
+    else {
+        checks.push({
+            name: "Desktop MCP config",
+            status: "warn",
+            detail: `${cfgPath} does not exist`,
+            fix: "Run `orql setup` to create it.",
+        });
+    }
+    // 6. Telegram
+    const tg = await probeTelegramStatus(stateRes.path);
+    let tgStatus = "ok";
+    if (tg.status === "unconfigured")
+        tgStatus = "warn";
+    else if (tg.status === "stale" || tg.status === "configured" || tg.status === "started")
+        tgStatus = "warn";
+    checks.push({
+        name: "Telegram bot",
+        status: tgStatus,
+        detail: `${tg.status} (token: ${tg.hasToken ? "set" : "missing"}, whitelist: ${tg.whitelistSize})`,
+        fix: tg.status === "unconfigured"
+            ? "`orql tg setup` to wire a bot — optional but recommended."
+            : tg.status === "stale" || tg.status === "configured" || tg.status === "started"
+                ? "Run `orql tg start` from your project to bring the bot online."
+                : undefined,
+    });
+    // 7. orqlaude self-test (MCP server startup)
+    try {
+        const serverPath = path.resolve(path.dirname(new URL(import.meta.url).pathname), "..", "server.js");
+        if (existsSync(serverPath)) {
+            checks.push({ name: "orqlaude MCP server", status: "ok", detail: `${serverPath}` });
+        }
+        else {
+            checks.push({
+                name: "orqlaude MCP server",
+                status: "fail",
+                detail: `Missing ${serverPath}`,
+                fix: "Reinstall: npm i -g @synaplink/orqlaude@latest",
+            });
+        }
+    }
+    catch (err) {
+        checks.push({ name: "orqlaude MCP server", status: "warn", detail: err.message });
+    }
+    // Render
+    const counts = { ok: 0, warn: 0, fail: 0 };
+    for (const c of checks) {
+        counts[c.status]++;
+        const glyph = c.status === "ok"
+            ? style.coral("✓")
+            : c.status === "warn"
+                ? style.crimson("⚠")
+                : style.crimson("✗");
+        console.log(`  ${glyph} ${style.bold(c.name.padEnd(26))} ${c.detail}`);
+        if (c.fix)
+            console.log(`     ${style.coral("→")} ${style.sand(c.fix)}`);
+    }
+    console.log("");
+    const summary = `${style.coral(`${counts.ok} ok`)} · ${style.crimson(`${counts.warn} warn`)} · ${style.crimson(`${counts.fail} fail`)}`;
+    console.log(`  ${summary}  ${style.dim(`(orqlaude ${currentVersion})`)}`);
+    return counts.fail > 0 ? 1 : 0;
+}
+//# sourceMappingURL=doctor.js.map

package/dist/cli/doctor.js.map

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

package/dist/cli/easter_egg.d.ts

@@ -0,0 +1 @@
+export declare function runEasterEgg(): Promise<number>;

package/dist/cli/easter_egg.js

@@ -0,0 +1,92 @@
+import { TAGLINES } from "./taglines.js";
+import { style } from "../lib/style.js";
+/**
+ * Bare `orql` easter egg — a never-repeating typewriter cycling through
+ * 149 tagline variants under the orqlaude diamond logo. Runs until Ctrl-C.
+ *
+ * The natural terminal cursor sits at the end of each tagline while it's
+ * displayed and blinks on its own — no explicit blink animation needed.
+ */
+const ESC = "\x1b[";
+const SAVE = `${ESC}s`;
+const RESTORE = `${ESC}u`;
+const CLEAR_TO_EOL = `${ESC}K`;
+const SAND_FG = `${ESC}38;2;185;182;171m`;
+const RESET = `${ESC}0m`;
+const TYPE_MIN_MS = 28;
+const TYPE_MAX_MS = 90;
+const HOLD_MIN_MS = 1100;
+const HOLD_MAX_MS = 2200;
+const ERASE_MIN_MS = 12;
+const ERASE_MAX_MS = 30;
+const BETWEEN_MIN_MS = 280;
+const BETWEEN_MAX_MS = 600;
+export async function runEasterEgg() {
+    return new Promise((resolve) => {
+        let stopped = false;
+        const onSig = () => {
+            stopped = true;
+            // Move cursor below the tagline line and reset, then exit.
+            process.stdout.write(RESET + "\n\n");
+            resolve(0);
+        };
+        process.on("SIGINT", onSig);
+        // Static logo + wordmark. Last line ends without a newline so the
+        // cursor sits where taglines should animate.
+        const logo = [
+            `   ${style.coral("◆◆◆")}`,
+            `  ${style.coral("◆   ◆")}     ${style.bold(style.coral("orqlaude"))}`,
+            `   ${style.coral("◆◆◆")}      `, // trailing spaces are the "padding" before the tagline
+        ];
+        process.stdout.write("\n" + logo.join("\n"));
+        process.stdout.write(SAVE);
+        // Animate in a loop. We do this without `await` in the main scope so
+        // SIGINT can interrupt cleanly via the `stopped` flag check between
+        // sleeps.
+        (async () => {
+            let lastIdx = -1;
+            while (!stopped) {
+                let idx = Math.floor(Math.random() * TAGLINES.length);
+                // Never repeat the previous tagline.
+                while (idx === lastIdx) {
+                    idx = Math.floor(Math.random() * TAGLINES.length);
+                }
+                lastIdx = idx;
+                const tagline = TAGLINES[idx];
+                // Reset cursor + clear any leftover from the previous tagline.
+                process.stdout.write(RESTORE + CLEAR_TO_EOL + SAND_FG);
+                // Type out character by character. Each char is plain text — the
+                // SAND_FG above persists until we reset, so a single \b backspace
+                // erases one visible character.
+                for (let i = 0; i < tagline.length; i++) {
+                    if (stopped)
+                        return;
+                    process.stdout.write(tagline[i]);
+                    await sleep(rand(TYPE_MIN_MS, TYPE_MAX_MS));
+                }
+                // Hold while the natural terminal cursor blinks at the end.
+                await sleep(rand(HOLD_MIN_MS, HOLD_MAX_MS));
+                if (stopped)
+                    return;
+                // Erase backwards for a satisfying "delete" feel.
+                for (let i = tagline.length; i > 0; i--) {
+                    if (stopped)
+                        return;
+                    process.stdout.write("\b \b");
+                    await sleep(rand(ERASE_MIN_MS, ERASE_MAX_MS));
+                }
+                process.stdout.write(RESET);
+                await sleep(rand(BETWEEN_MIN_MS, BETWEEN_MAX_MS));
+            }
+        })().catch(() => {
+            /* swallow — never crash on the easter egg */
+        });
+    });
+}
+function sleep(ms) {
+    return new Promise((res) => setTimeout(res, ms));
+}
+function rand(min, max) {
+    return min + Math.random() * (max - min);
+}
+//# sourceMappingURL=easter_egg.js.map

package/dist/cli/easter_egg.js.map

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

package/dist/cli/open.d.ts

@@ -0,0 +1,6 @@
+/**
+ * `orql open <plan_id>` — open every PR URL the fleet produced in the
+ * default browser, plus print worktree paths for tasks that don't yet
+ * have PRs.
+ */
+export declare function openPlan(stateDir: string, planId: string): Promise<number>;