@synaplink/orqlaude 0.3.0

package/.mcp.json.template

@@ -0,0 +1,8 @@
+{
+  "mcpServers": {
+    "orqlaude": {
+      "command": "npx",
+      "args": ["-y", "@synaplink/orqlaude"]
+    }
+  }
+}

package/README.md

@@ -0,0 +1,239 @@
+# @synaplink/orqlaude
+
+Multi-agent orchestrator for Claude Code. One primary Claude session decomposes a complex task into N parallel sub-tasks, gets a single user approval, then dispatches N child agents (each in its own session and worktree) via the Claude Desktop app's native `mcp__ccd_session__spawn_task`. Tracks cost/tokens via JSONL tails, brokers messages between agents, detects hallucination, manages PRs, and can spawn a reviewer agent per PR at the end.
+
+The name is **orq**hestrator + **Claude**.
+
+> Status: **v0.3.0** — 19 tools, 11 tests passing, CI green. Token-first budgets (Max-friendly), self-registering child agents, hallucination detection, file-claim broker, audit log, resumability, auto-review pipeline, and a **Telegram bot** for fleet notifications + remote control.
+
+## Why orqlaude exists
+
+A single Claude agent is great at focused work but slow at multi-region refactors. You can manually spawn parallel sessions via `spawn_task`, but you lose budget oversight, cross-agent coordination, and a single place to see "what's the fleet doing right now?"
+
+orqlaude is the thin layer that adds those things. It never spawns processes itself — the Desktop app's `spawn_task` does that — but it owns the *plan*, the *budget*, the *broker*, and the *aggregation*.
+
+## How it fits together
+
+```
+                          ┌──────────────────────┐
+                          │   PRIMARY CLAUDE     │
+                          └─────────┬────────────┘
+   ┌─── orqlaude.create_plan ──────►│
+   │   orqlaude.request_approval ──►│  (relays via AskUserQuestion)
+   │   orqlaude.confirm        ────►│
+   │   orqlaude.next_task      ────►│
+   │   ccd_session.spawn_task  ────►├─── chip ─► ┌──────────┐
+   │                                │            │ child #1 │ ─► auto-registers via checkin
+   │                                │            │ session  │
+   │   orqlaude.next_task      ────►│            └────┬─────┘
+   │   ccd_session.spawn_task  ────►├─── chip ─►      │
+   │                                │            ┌────▼─────┐
+   │                                │            │ child #2 │
+   │   orqlaude.status         ────►│ ◄────── claim_files, post_note
+   │   orqlaude.poll_notes     ────►│ ◄────── PR url via post_note
+   │   orqlaude.send_message   ────►│
+   │   orqlaude.collect        ────►│
+   │   orqlaude.review_prs     ────►├─── chip ─► reviewer #1
+   │                                ├─── chip ─► reviewer #2
+   └────────────────────────────────┘
+```
+
+## Install
+
+```sh
+npm install -g @synaplink/orqlaude   # CLI + MCP server
+```
+
+In your project, add to `.mcp.json` (or copy `.mcp.json.template`):
+
+```json
+{
+  "mcpServers": {
+    "orqlaude": {
+      "command": "npx",
+      "args": ["-y", "@synaplink/orqlaude"]
+    }
+  }
+}
+```
+
+Restart your Claude Code session. The `mcp__orqlaude__*` tools will appear.
+
+## Tool reference
+
+### Planning (primary Claude)
+
+| Tool | Purpose |
+|---|---|
+| `create_plan(root_task, tasks[], budget_cap_tokens?, model_for_estimate?, effort_multiplier?)` | Register a fleet. Returns `plan_id`. Budget is in TOKENS (Max-plan friendly); USD is informational. |
+| `estimate(plan_id, model?, effort_multiplier?)` | Recompute cost/duration estimates. |
+| `request_approval(plan_id)` | Returns `approval_token` and a prebuilt `ask_user_question` payload. Surfaces your daily token usage from the Desktop app's `buddy-tokens.json`. |
+| `confirm(plan_id, approval_token)` | Lock the plan after user approves. |
+
+### Dispatch (primary Claude)
+
+| Tool | Purpose |
+|---|---|
+| `next_task(plan_id)` | Pull the next pending task. Returned `prompt` embeds `plan_id` + `task_id` and instructs the agent to self-register via `checkin` on its first turn. |
+| `status(plan_id)` | Per-agent live snapshot: cost, tokens, last activity, current tool, terminated yes/no, **hallucination report**. Auto-cancels and STOPs all agents if total tokens exceed the cap. |
+| `collect(plan_id)` | Aggregated PR URLs, summaries, costs, exit reasons. |
+| `review_prs(plan_id, auto_approve?, budget_cap_tokens?)` | Spawn a reviewer agent against each PR produced by `plan_id`. Creates a new "review plan" auto-approved by default. |
+| `register_spawn(plan_id, task_id, session_id)` | Manual fallback if a child fails to self-register. Rarely needed. |
+
+### Broker
+
+| Tool | Caller | Purpose |
+|---|---|---|
+| `checkin(session_id, task_id?)` | child agent | **First call**: pass `task_id` to self-register. Subsequent calls: pull queued messages, see STOP signals, ack state of blocking notes. |
+| `post_note(session_id, text, blocking?, pr_url?)` | child agent | Share findings or report a PR URL. `blocking: true` pauses until acked. |
+| `claim_files(session_id, paths[], reason?)` | child agent | Register intent to edit specific files. Conflicting claims by other agents surface to the caller. |
+| `release_files(session_id, paths[])` | child agent | Release claims after finishing. |
+| `poll_notes(plan_id, since_ts?, mark_acked?)` | primary Claude | Read agent notes; ack blocking ones to unblock posters. |
+| `send_message(plan_id, to_session_id, text, from_task_id?, kind?)` | primary Claude | Queue a directed message. `kind: "stop"` triggers child commit-and-exit. |
+
+### Lifecycle
+
+| Tool | Purpose |
+|---|---|
+| `kill_task(plan_id, task_id, reason)` | Queue STOP broker message; returns session_id ready for `archive_session`. Use for hallucinating/looping agents. |
+| `resume_plan(plan_id)` | Pick up an in-flight plan after a Desktop-app restart or new session. Refreshes per-task status from JSONL, returns a "do this next" hint. |
+| `list_plans(include_collected?)` | All plans known to orqlaude in this project, active first. |
+
+### Health
+
+| Tool | Purpose |
+|---|---|
+| `ping(echo?)` | Returns version, cwd, node, pid. |
+
+## End-to-end walkthrough
+
+User says: *"Refactor the auth system — magic-link login, update the docs, add tests."* You judge it as parallelizable.
+
+1. `orqlaude.create_plan` with 3 subtasks (auth-core, docs, tests), `budget_cap_tokens: 600000`.
+2. `orqlaude.request_approval` → returns `approval_token` and a prebuilt question payload showing your remaining daily quota.
+3. You call `AskUserQuestion` with that payload. User picks "Approve and spawn".
+4. `orqlaude.confirm`.
+5. Loop three times:
+   - `orqlaude.next_task` → returns a task with the wrapped prompt
+   - `mcp__ccd_session__spawn_task` with the title/prompt/tldr → user clicks the chip
+   - The spawned agent calls `orqlaude.checkin(session_id, task_id)` on first turn → self-registers
+6. Periodically: `orqlaude.status` (shows hallucination scores) + `orqlaude.poll_notes`. Forward cross-cutting info via `send_message`. If an agent goes off the rails, `kill_task`.
+7. Agents call `orqlaude.post_note(..., pr_url=...)` when their PR is open.
+8. `orqlaude.collect` → three PR URLs and summaries.
+9. **NEW**: `orqlaude.review_prs(plan_id)` → spawns three reviewer agents, one per PR. Each reviews, runs tests, posts findings. You aggregate the second-round notes.
+
+## State
+
+State lives in `<project>/.orqlaude/`:
+
+- `orqlaude-state.json` — plans, tasks, notes, messages, claims. Atomic write via temp+rename.
+- `audit.jsonl` — append-only log of every tool call: `{ ts, tool, args (redacted), ok, durationMs, plan/session ids, summary }`. Inspect with `orqlaude history` or `tail -f .orqlaude/audit.jsonl | jq`.
+
+Both human-readable. Both `.gitignore`d.
+
+## Hallucination detection
+
+`status()` runs two deterministic checks per agent:
+
+1. **Path-existence**: every `file_path` referenced in `Read/Edit/Write/Grep` tool calls is checked against the worktree. >30% missing or ≥3 missing = `moderate`/`severe` flag.
+2. **Tool-pattern sanity**:
+   - Edit on a file that wasn't read first
+   - Same tool call repeated ≥3 times (loop)
+   - `git commit` without any prior `npm test`/`tsc`/`pytest`/etc.
+
+Each agent gets a `hallucination_score` (0–1) and `concerns: string[]`. The aggregated `hallucination_alerts` list surfaces to the primary Claude so it can `send_message` a nudge or `kill_task`. False positives are acceptable here — we surface concerns, we don't auto-kill.
+
+A future v0.3 can add a Check 3: periodic Haiku cross-validation of recent activity (costs tokens, opt-in).
+
+## CLI
+
+```sh
+orqlaude list                   # every plan in this project
+orqlaude status <plan_id>       # refreshed status of one plan
+orqlaude show <plan_id>         # raw plan JSON
+orqlaude history --limit 50     # tail audit log
+orqlaude help
+```
+
+Read-only. For active orchestration, use the MCP from inside Claude Code.
+
+## Repo layout
+
+```
+orqlaude/
+├── package.json                # @synaplink/orqlaude
+├── tsconfig.json
+├── .mcp.json                   # local dev wiring
+├── .mcp.json.template          # production wiring (npx-based)
+├── .github/workflows/ci.yml    # typecheck + build + test
+├── src/
+│   ├── server.ts               # MCP stdio entry
+│   ├── cli.ts                  # `orqlaude` CLI binary
+│   ├── lib/
+│   │   ├── state.ts            # JSON-backed ledger, schema v2
+│   │   ├── budgeting.ts        # token-first budget, daily quota reader
+│   │   ├── pricing.ts          # USD pricing table (informational)
+│   │   ├── hallucination.ts    # deterministic detectors
+│   │   ├── jsonl_tail.ts       # cached byte-offset session tail
+│   │   └── audit.ts            # append-only audit log
+│   ├── tools/
+│   │   ├── ping.ts
+│   │   ├── planning.ts         # create_plan, estimate, request_approval, confirm
+│   │   ├── dispatch.ts         # next_task, register_spawn, status, collect
+│   │   ├── broker.ts           # checkin, post_note, claim_files, release_files, poll_notes, send_message
+│   │   ├── lifecycle.ts        # kill_task, resume_plan, list_plans
+│   │   └── review.ts           # review_prs
+│   └── __tests__/
+│       ├── state.test.ts
+│       └── hallucination.test.ts
+└── dist/                       # tsc output (published to npm)
+```
+
+## Telegram bot
+
+orqlaude can notify you on Telegram when fleet events happen and accept commands from your phone.
+
+```sh
+# One-time setup (creates ~/.orqlaude/telegram.json, mode 600)
+orqlaude tg setup
+# (paste your bot token from @BotFather)
+
+# Message your bot /start in Telegram to learn your user id, then:
+orqlaude tg whitelist <your_user_id> --owner --label "you"
+
+# Run the bot (foreground; daemonize with launchctl / systemd / nohup as you prefer)
+cd /path/to/your/project
+orqlaude tg start
+```
+
+**Notifications pushed to you:**
+- 📋 New plan created
+- ✅ Plan approved (spawn imminent)
+- ✓ Task done (with PR URL)
+- ❌ Task failed / 🛑 cancelled
+- 📝 New agent note (with severity from `post_note`)
+- 💸 Auto-cancel on budget overrun
+- 🎉 Fleet collected
+
+**Commands you can send (whitelisted users only):**
+- `/plans` — active plans
+- `/status <plan_id>` — refreshed task list with token usage
+- `/show <plan_id>` — raw plan JSON
+- `/notes <plan_id>` — recent agent notes
+- `/kill <plan_id> <task_id> <reason>` — STOP a runaway agent
+- `/whitelist <user_id> [label]` (owner-only) — add another user
+- `/help` / `/whoami`
+
+The bot uses raw `fetch` against Telegram's Bot API — zero extra deps. State is shared with the MCP via the same `StateStore`, so commands take effect on the next status() / checkin().
+
+## Known gaps (v0.3 → v0.4 roadmap)
+
+- **Cost-learning estimates** — current baselines are tuned to a single Haiku probe. Future: write per-task realized costs to history and use moving averages.
+- **N chips = N clicks** — Anthropic's `spawn_task` is per-click by design. Worth filing as feedback. Until then, batch-spawn isn't possible through that API.
+- **Second-model hallucination check** — periodic Haiku cross-validation of recent activity, opt-in.
+- **Multi-project Telegram bot** — currently the bot watches a single project. Multi-project watching is a small extension to the config schema.
+- **Inline approve buttons in Telegram** — `/approve <plan_id>` and inline keyboards so you can confirm fleets from your phone.
+
+## License
+
+MIT.

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

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

package/dist/__tests__/hallucination.test.js

@@ -0,0 +1,65 @@
+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";
+import { detectHallucination } from "../lib/hallucination.js";
+async function tmpRepo() {
+    return fs.mkdtemp(path.join(os.tmpdir(), "orqlaude-hallu-"));
+}
+test("clean session scores 0", async () => {
+    const cwd = await tmpRepo();
+    const real = path.join(cwd, "real.ts");
+    await fs.writeFile(real, "// hi");
+    const tools = [
+        { name: "Read", input: { file_path: real } },
+        { name: "Edit", input: { file_path: real, old_string: "hi", new_string: "hello" } },
+        { name: "Bash", input: { command: "npm test" } },
+        { name: "Bash", input: { command: "git commit -m 'fix'" } },
+    ];
+    const report = await detectHallucination(tools, cwd);
+    assert.equal(report.score, 0);
+    assert.equal(report.level, "clean");
+});
+test("references to nonexistent paths score moderate-or-higher", async () => {
+    const cwd = await tmpRepo();
+    const tools = [
+        { name: "Read", input: { file_path: path.join(cwd, "nope-a.ts") } },
+        { name: "Read", input: { file_path: path.join(cwd, "nope-b.ts") } },
+        { name: "Read", input: { file_path: path.join(cwd, "nope-c.ts") } },
+        { name: "Edit", input: { file_path: path.join(cwd, "nope-d.ts"), old_string: "x", new_string: "y" } },
+    ];
+    const report = await detectHallucination(tools, cwd);
+    assert.ok(report.score >= 0.3, `expected score >= 0.3 (moderate), got ${report.score}`);
+    assert.match(report.concerns[0] ?? "", /don't exist/);
+});
+test("edit without prior read flags concern", async () => {
+    const cwd = await tmpRepo();
+    const real = path.join(cwd, "real.ts");
+    await fs.writeFile(real, "x");
+    const tools = [{ name: "Edit", input: { file_path: real, old_string: "x", new_string: "y" } }];
+    const report = await detectHallucination(tools, cwd);
+    assert.ok(report.concerns.some((c) => /without first reading/.test(c)));
+});
+test("tight loop of identical tool calls flags concern", async () => {
+    const cwd = await tmpRepo();
+    const real = path.join(cwd, "real.ts");
+    await fs.writeFile(real, "x");
+    const sameCall = { name: "Read", input: { file_path: real } };
+    const tools = [sameCall, sameCall, sameCall, sameCall, sameCall];
+    const report = await detectHallucination(tools, cwd);
+    assert.ok(report.concerns.some((c) => /loop/i.test(c) || /Repeated/.test(c)));
+});
+test("commit without tests flags concern", async () => {
+    const cwd = await tmpRepo();
+    const real = path.join(cwd, "real.ts");
+    await fs.writeFile(real, "x");
+    const tools = [
+        { name: "Read", input: { file_path: real } },
+        { name: "Edit", input: { file_path: real, old_string: "x", new_string: "y" } },
+        { name: "Bash", input: { command: "git add -A && git commit -m 'wip'" } },
+    ];
+    const report = await detectHallucination(tools, cwd);
+    assert.ok(report.concerns.some((c) => /without running tests/.test(c)));
+});
+//# sourceMappingURL=hallucination.test.js.map

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

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

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

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

package/dist/__tests__/state.test.js

@@ -0,0 +1,124 @@
+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";
+import { StateStore, newPlan, findPlan, unclaimedTaskById, normalizeClaimPath, } from "../lib/state.js";
+async function tmpStore() {
+    const dir = await fs.mkdtemp(path.join(os.tmpdir(), "orqlaude-test-"));
+    return { store: new StateStore(dir), dir };
+}
+test("create plan + persist + reload preserves shape", async () => {
+    const { store, dir } = await tmpStore();
+    const plan = await store.update((s) => {
+        const p = newPlan("root task", 100_000, [
+            { title: "T1", prompt: "p1", tldr: "tldr1" },
+            { title: "T2", prompt: "p2", tldr: "tldr2" },
+        ]);
+        s.plans[p.id] = p;
+        return p;
+    });
+    // New store instance: forces reload from disk.
+    const fresh = new StateStore(dir);
+    const reloaded = await fresh.read((s) => findPlan(s, plan.id));
+    assert.equal(reloaded.tasks.length, 2);
+    assert.equal(reloaded.budgetCapTokens, 100_000);
+    assert.equal(reloaded.perAgentCapTokens, 50_000);
+    assert.equal(reloaded.tasks[0].status, "pending");
+});
+test("approval token mismatch is rejected", async () => {
+    const { store } = await tmpStore();
+    const plan = await store.update((s) => {
+        const p = newPlan("root", 50_000, [{ title: "T", prompt: "p", tldr: "tl" }]);
+        p.status = "awaiting_approval";
+        p.approvalToken = "the-real-token";
+        s.plans[p.id] = p;
+        return p;
+    });
+    await assert.rejects(async () => {
+        await store.update((s) => {
+            const p = findPlan(s, plan.id);
+            if (p.approvalToken !== "wrong")
+                throw new Error("Approval token mismatch.");
+            p.status = "approved";
+        });
+    }, /Approval token mismatch/);
+});
+test("unclaimedTaskById finds dispatched-but-unowned task", async () => {
+    const { store } = await tmpStore();
+    let taskId = "";
+    await store.update((s) => {
+        const p = newPlan("root", 50_000, [{ title: "T", prompt: "p", tldr: "tl" }]);
+        p.tasks[0].status = "dispatched";
+        taskId = p.tasks[0].id;
+        s.plans[p.id] = p;
+    });
+    const found = await store.read((s) => unclaimedTaskById(s, taskId));
+    assert.ok(found, "should find unclaimed task");
+    assert.equal(found.task.id, taskId);
+    // After claiming, it no longer appears.
+    await store.update((s) => {
+        const f = unclaimedTaskById(s, taskId);
+        f.task.spawnedSessionId = "some-uuid";
+    });
+    const found2 = await store.read((s) => unclaimedTaskById(s, taskId));
+    assert.equal(found2, undefined);
+});
+test("normalizeClaimPath: relative paths resolve against cwd", () => {
+    const cwd = "/repo/root";
+    assert.equal(normalizeClaimPath("src/foo.ts", cwd), "/repo/root/src/foo.ts");
+    assert.equal(normalizeClaimPath("/abs/path.ts", cwd), "/abs/path.ts");
+    assert.equal(normalizeClaimPath("./a/../b.ts", cwd), "/repo/root/b.ts");
+});
+test("concurrent updates serialize correctly", async () => {
+    const { store } = await tmpStore();
+    let planId = "";
+    await store.update((s) => {
+        const p = newPlan("root", 100_000, [{ title: "T", prompt: "p", tldr: "tl" }]);
+        planId = p.id;
+        s.plans[p.id] = p;
+    });
+    // Fire 20 concurrent appends to the notes array. With serialization, all 20 land.
+    const writes = Array.from({ length: 20 }, (_, i) => store.update((s) => {
+        findPlan(s, planId).notes.push({
+            id: `note-${i}`,
+            fromSessionId: "x",
+            taskId: "y",
+            text: `n${i}`,
+            blocking: false,
+            postedAt: Date.now(),
+            acked: false,
+        });
+    }));
+    await Promise.all(writes);
+    const final = await store.read((s) => findPlan(s, planId));
+    assert.equal(final.notes.length, 20);
+});
+test("schema v1 migrates to v2 with token caps synthesized", async () => {
+    const { store, dir } = await tmpStore();
+    // Write a v1-shaped state file directly.
+    const v1 = {
+        schemaVersion: 1,
+        plans: {
+            "p1": {
+                id: "p1",
+                createdAt: 1,
+                rootTask: "old",
+                budgetCapUsd: 4,
+                perAgentCapUsd: 2,
+                status: "draft",
+                tasks: [],
+                notes: [],
+                messages: [],
+            },
+        },
+    };
+    await fs.writeFile(path.join(dir, "orqlaude-state.json"), JSON.stringify(v1));
+    // Reload via a new store (the test store already cached empty).
+    const fresh = new StateStore(dir);
+    const migrated = await fresh.read((s) => s);
+    assert.equal(migrated.schemaVersion, 2);
+    assert.equal(migrated.plans["p1"].budgetCapTokens, 4 * 25_000);
+    assert.deepEqual(migrated.plans["p1"].claims, []);
+});
+//# sourceMappingURL=state.test.js.map

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

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

package/dist/cli.d.ts

@@ -0,0 +1,2 @@
+#!/usr/bin/env node
+export {};