@synaplink/orqlaude 0.5.6 → 0.6.1

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+)

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/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>;

package/dist/cli/open.js

@@ -0,0 +1,57 @@
+import { execSync } from "node:child_process";
+import { StateStore } from "../lib/state.js";
+import { style } from "../lib/style.js";
+/**
+ * `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 async function openPlan(stateDir, planId) {
+    const store = new StateStore(stateDir);
+    let plan;
+    try {
+        plan = await store.read((s) => {
+            const p = s.plans[planId] ?? Object.values(s.plans).find((x) => x.id.startsWith(planId));
+            if (!p)
+                throw new Error(`Plan not found: ${planId}`);
+            return p;
+        });
+    }
+    catch (err) {
+        process.stderr.write(style.crimson(`✗ ${err.message}\n`));
+        return 1;
+    }
+    const withPr = plan.tasks.filter((t) => t.prUrl);
+    const withoutPr = plan.tasks.filter((t) => !t.prUrl);
+    if (withPr.length === 0 && withoutPr.length === 0) {
+        process.stdout.write(style.sand("Plan has no tasks.\n"));
+        return 0;
+    }
+    if (withPr.length > 0) {
+        process.stdout.write(`${style.bold(style.cream("Opening"))} ${withPr.length} PR(s) in your default browser:\n`);
+        for (const t of withPr) {
+            process.stdout.write(`  ${style.coral("→")} ${t.prUrl}  ${style.dim(`(${t.agnetName ? "Agnet " + t.agnetName : t.title})`)}\n`);
+            openUrl(t.prUrl);
+        }
+    }
+    if (withoutPr.length > 0) {
+        process.stdout.write("\n" + style.sand("Tasks without PRs yet:") + "\n");
+        for (const t of withoutPr) {
+            const agnet = t.agnetName ? "Agnet " + t.agnetName : "Agnet";
+            process.stdout.write(`  ${style.sand("·")} ${agnet}  ${style.dim(t.title)}\n`);
+            if (t.worktreePath)
+                process.stdout.write(`     ${style.sand("worktree:")} ${t.worktreePath}\n`);
+        }
+    }
+    return 0;
+}
+function openUrl(url) {
+    try {
+        const cmd = process.platform === "darwin" ? "open" : process.platform === "win32" ? "start" : "xdg-open";
+        execSync(`${cmd} "${url}"`, { stdio: "ignore" });
+    }
+    catch {
+        /* swallow */
+    }
+}
+//# sourceMappingURL=open.js.map

package/dist/cli/open.js.map

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

package/dist/cli/taglines.d.ts

@@ -0,0 +1,12 @@
+/**
+ * 149 creative variants of the orqlaude tagline.
+ *
+ * Used by the bare-`orql` easter egg (src/cli/easter_egg.ts): a random
+ * tagline is typed out, paused, erased, and the cycle repeats. The
+ * picker guarantees consecutive picks are never the same string.
+ *
+ * Index 0 is the "canonical" descriptive tagline used elsewhere as a
+ * watermark fallback. The rest are intentionally varied — technical,
+ * playful, poetic, self-aware — to keep the easter egg interesting.
+ */
+export declare const TAGLINES: readonly string[];