tono 0.1.0 → 0.2.1

package/README.md

@@ -0,0 +1,300 @@
+# tono
+
+A self-hosted gateway that turns labeled GitHub issues and PRs into running CLI agents.
+
+> *The name is the middle of **au·tono·mous** — fitting for a tool whose whole job is letting agents run unattended.*
+
+> **Heads up: this project was entirely vibe-coded by AI.** Every line of code, every commit, every README revision (including this one). Read accordingly — there are no human-reviewed parts. Use at your own risk.
+
+---
+
+## What it does
+
+You add a label to a GitHub issue or PR. Tono notices, spins up the matching CLI agent (Claude Code, Codex CLI, or OpenCode) inside a fresh git worktree on your machine, points it at the issue or PR, and lets it open the PR / post the review when it's done. The browser UI streams the live terminal so you can watch the agent work or jump in.
+
+It's built to run quietly in the background on a machine of your choice — a Mac Mini under your desk, an old laptop, whatever — and pick up work as it comes.
+
+```
+GitHub issue (label: tono-claude)              GitHub PR (label: tono-claude-review)
+       │                                              │
+       ▼                                              ▼
+  gh issue list                                  gh pr list
+       │                                              │
+       ▼                                              ▼
+  worktree off baseBranch                  worktree at PR head (detached)
+       │                                              │
+       ▼                                              ▼
+  PTY: claude <prompt>                       PTY: claude <prompt>
+       │                                              │
+       ▼                                              ▼
+  gh pr create                              gh pr review --comment
+       │
+       ▼
+  gh pr view (poll for merge)
+```
+
+The crucial design choice: tono **does not implement an agent**. It orchestrates external CLI agents — Claude Code, Codex CLI, OpenCode — by spawning them in a real PTY so their full TUI output is preserved.
+
+## Two kinds of work, one orchestrator
+
+| Kind | Trigger | Worktree | Agent's job | Output |
+|---|---|---|---|---|
+| **implement** | label on issue | branch off `baseBranch` | implement the issue, push, run `gh pr create` | a new PR |
+| **review** | label on PR | detached HEAD at PR's head | read the diff, run `gh pr review --comment` (or `--approve` / `--request-changes`) | a review on the PR |
+
+Each agent has its own queue and its own concurrency cap **per kind**, so a slow implement doesn't starve fast reviews and vice versa.
+
+## Trigger labels (convention, not config)
+
+Labels are fixed by convention. There are six total — apply whichever you want and tono picks the right agent + kind:
+
+| Agent | Implement issues | Review PRs |
+|---|---|---|
+| `claude-code` | `tono-claude` | `tono-claude-review` |
+| `codex` | `tono-codex` | `tono-codex-review` |
+| `opencode` | `tono-opencode` | `tono-opencode-review` |
+
+Run `tono config labels` to print the table for your current config.
+
+## Requirements
+
+- **macOS.** Linux support is plausible but untested; the launchd integration is macOS-only.
+- **Node 20+**.
+- **[`gh`](https://cli.github.com)** installed and authenticated (`gh auth login`). Tono shells out to `gh` for issue polling, PR polling, and PR-merge tracking.
+- **The agent CLI(s) you want to use, on `$PATH`.** At least one of:
+  - **Claude Code** — [install instructions](https://docs.claude.com/en/docs/claude-code/quickstart). Verify `claude --version`.
+  - **Codex CLI** — `npm install -g @openai/codex` or follow the [Codex CLI repo](https://github.com/openai/codex). Verify `codex --version`.
+  - **OpenCode** — see [opencode.ai](https://opencode.ai). Verify `opencode --version`.
+
+## Install
+
+Tono is on npm — install it globally with whichever package manager you use:
+
+```bash
+# npm (recommended — runs install scripts by default, so native modules just work)
+npm install -g tono
+
+# yarn
+yarn global add tono
+
+# pnpm
+pnpm add -g tono
+pnpm approve-builds -g    # one-time: allow better-sqlite3 and node-pty to fetch prebuilds
+```
+
+Verify it landed on your `$PATH`:
+
+```bash
+tono --version    # → 0.2.0
+which tono        # → /usr/local/bin/tono (or your manager's bin path)
+```
+
+To upgrade later:
+
+```bash
+npm install -g tono@latest
+tono gateway restart    # picks up the new binary in the background daemon
+```
+
+To uninstall:
+
+```bash
+tono gateway uninstall  # remove the LaunchAgent first
+npm uninstall -g tono
+rm -rf ~/.tono          # optional — drops config, db, worktrees
+```
+
+> **About native modules:** tono pulls in `better-sqlite3` and `node-pty`, which need to compile or fetch a prebuilt binary. Both ship prebuilds for macOS arm64/x64; npm and yarn run their install scripts automatically. **pnpm v10 disables install scripts by default** for safety, hence the extra `pnpm approve-builds -g` step.
+
+## Get started
+
+### 1. Configure tono
+
+```bash
+tono configure
+```
+
+The wizard walks you through:
+
+- Bind host / port for the dashboard (defaults: `0.0.0.0:7040`)
+- Poll interval
+- Workspaces root (default: `~/.tono/workspaces`)
+- Which agents to enable (claude-code, codex, opencode) — for each:
+  - Command name
+  - Per-kind concurrency caps (implement / review)
+- Repos to watch — for each:
+  - GitHub slug (`owner/repo`)
+  - Path to your existing local clone, **or leave blank** to let tono bare-clone via `gh` into `~/.tono/workspaces/.bare/`
+  - Base branch
+  - Which of your enabled agents are enrolled on this repo
+
+Re-run `tono configure` later, edit `~/.tono/config.json` directly, or use the **Config** page in the web UI.
+
+### 2. Run the gateway
+
+```bash
+tono gateway start    # installs + loads a macOS LaunchAgent
+tono open             # opens the dashboard in your browser
+```
+
+The gateway runs as a background daemon (`com.tono.gateway`), survives reboots, and auto-restarts on crash. Logs go to `~/.tono/logs/daemon.{out,err}.log`.
+
+### 3. Trigger your first agent
+
+Two ways:
+
+- **From GitHub.** Apply one of the convention labels (`tono-claude`, `tono-codex-review`, etc.) to an issue or PR in a watched repo. Within `pollIntervalSeconds` (default 60s), tono queues a task and dispatches the matching agent.
+- **From the dashboard.** Click **+ Start session**, pick a repo, pick an agent, type the issue number. Tono fetches the issue body via `gh` and queues an implement task immediately. (Manual review-task trigger isn't wired through the UI yet — apply the review label on the PR.)
+
+Click into the task to watch the live terminal.
+
+## Reaching the dashboard
+
+- **From the gateway machine:** `tono open` (or `http://localhost:7040`).
+- **From another device on your LAN:** `http://<host-ip>:7040`. Find your host IP with `ipconfig getifaddr en0` on macOS.
+- **From anywhere via Tailscale:** install Tailscale on the gateway machine and any device you want to use, then visit `http://<gateway-tailnet-ip>:7040`.
+
+There is **no auth in v1.** Either bind to LAN-only or use Tailscale ACLs.
+
+## CLI reference
+
+| Command | Purpose |
+|---|---|
+| `tono init` | Write default config + schema + database to `~/.tono/`. |
+| `tono configure` | Interactive setup wizard. Edits or creates the config. |
+| `tono start` | Run the orchestrator in the **foreground** (dev mode). |
+| `tono gateway start` | Install + load the macOS LaunchAgent so the orchestrator runs in the background and at login. |
+| `tono gateway stop` | Unload the LaunchAgent (config kept). |
+| `tono gateway restart` | Reload after upgrading or changing the plist. |
+| `tono gateway status` | Show LaunchAgent state and HTTP health. |
+| `tono gateway uninstall` | Unload and remove the LaunchAgent. |
+| `tono gateway logs [out\|err]` | Tail the gateway log files. |
+| `tono open` | Open the web UI in your default browser. |
+| `tono config validate` | Validate `~/.tono/config.json` against the schema. |
+| `tono config labels` | Print the GitHub labels each configured agent listens for. |
+| `tono config path` | Print the config file path. |
+
+## Configuration
+
+Lives at `~/.tono/config.json`, validated against `~/.tono/config.schema.json`. Most fields are reachable from the **Config** page in the web UI; this is the underlying shape:
+
+```jsonc
+{
+  "$schema": "./config.schema.json",
+  "server":      { "host": "0.0.0.0", "port": 7040 },
+  "github":      { "pollIntervalSeconds": 60 },
+  "workspaces":  { "root": "~/.tono/workspaces" },
+  "repos": [
+    {
+      "slug": "owner/repo",
+      "path": "/Users/me/code/repo",   // optional; leave out to bare-clone via gh
+      "baseBranch": "main",
+      "agents": ["claude-code", "codex"] // optional; omit to enroll every declared agent
+    }
+  ],
+  "agents": {
+    "claude-code": {
+      "command": "claude",
+      "args": ["--dangerously-skip-permissions"],
+      "concurrency": { "implement": 2, "review": 4 },
+      "promptTemplates": {
+        "implement": "...",   // {issueNumber} {issueTitle} {issueBody} {repoSlug} {branch} {baseBranch}
+        "review":    "..."    // adds {prUrl} for review tasks
+      }
+    },
+    "codex":    { /* same shape; command "codex", args [] */ },
+    "opencode": { /* same shape; command "opencode", args ["run", "{prompt}"] */ }
+  }
+}
+```
+
+Notes:
+- **Labels are convention.** There is no `triggerLabel` field. Each enrolled agent listens for `tono-<short>` (implement) and `tono-<short>-review` (review), where `<short>` is `claude` for `claude-code` and the agent name otherwise.
+- **The `{prompt}` placeholder in `args`** lets agents that take prompts as flags (like `opencode run "<prompt>"`) coexist with agents that take prompts as final positionals (like `claude` and `codex`). If `{prompt}` is absent from `args`, tono appends the rendered prompt as the last arg.
+- **Per-(agent, kind) concurrency.** A `concurrency: { implement: 2, review: 4 }` block means up to 2 implement tasks and up to 4 review tasks of that agent run simultaneously. Set either to `0` to disable that kind for the agent.
+- **Live config reloads** (repo add/remove, prompt template edits, concurrency changes) take effect on the poller's next tick. Server host/port changes require `tono gateway restart`.
+
+## Web UI
+
+- **Dashboard.** Tasks grouped by phase: Running → Awaiting review (PR open) → Queued → Recent. Plus any live shells. Buttons: `+ Start session` (manual trigger) and `+ New terminal` (free shell on the host).
+- **Session view.** Full xterm.js terminal connected to the live PTY over WebSocket. Resume-safe (close the tab, come back later). Buttons: **Mark done** (free the slot without killing the agent), **Kill session**, **Cleanup worktree**, **Resume / Retry** (uses `claude --resume <id>` for Claude Code; codex / opencode start fresh on retry).
+- **Config.** Per-section forms (Server, GitHub, Workspaces, Repos, Agents). Add new agents from the **Add agent** card at the bottom. Each section has its own Save button. A "Show raw JSON" toggle reveals the unstructured editor.
+
+## Task lifecycle
+
+```
+implement task:
+  queued ──► running ──► (agent runs gh pr create)
+                    │
+                    ├──► pr_open ──► merged   (PR-watcher polls; auto-cleans worktree)
+                    │             ├─► pr_closed
+                    │
+                    └──► completed (no PR; Mark done or session exited 0)
+  failed       ← spawn / non-zero exit before any PR
+  cleaned      ← worktree manually removed
+
+review task:
+  queued ──► running ──► completed (agent posts review and exits)
+  failed       ← spawn / non-zero exit
+  cleaned      ← worktree manually removed (also drops refs/tono/pr-N)
+```
+
+The PR watcher polls every `pollIntervalSeconds` and uses `gh pr list --head <branch>` to discover PRs even when our streaming detection misses the URL. Once a PR is merged, tono runs `git worktree remove` automatically. Review tasks have nothing to merge, so the watcher ignores them.
+
+## Files on disk
+
+```
+~/.tono/
+├── config.json           # JSON-Schema-validated config
+├── config.schema.json
+├── tono.db               # SQLite: tasks (with kind), sessions, issues_seen
+├── logs/
+│   ├── daemon.out.log    # gateway stdout
+│   ├── daemon.err.log
+│   ├── task-N.log        # raw PTY bytes per task (4MB ring + tee to disk)
+│   └── shell-XXXX.log    # free shells from "+ New terminal"
+└── workspaces/
+    ├── .bare/<owner>__<repo>.git           # only if you didn't supply a `path`
+    ├── <owner>__<repo>__issue-N/           # implement worktree
+    └── <owner>__<repo>__pr-review-N/       # review worktree (detached HEAD)
+```
+
+## Stack
+
+| Layer | Pick |
+|---|---|
+| HTTP | [Hono](https://hono.dev) on the Node adapter |
+| WebSocket | `ws` |
+| PTY | `node-pty` |
+| DB | `better-sqlite3` |
+| Schema validation | `ajv` |
+| Frontend | React 19 + Vite 6 + Tailwind v4 + xterm.js (WebGL renderer) |
+
+A single Node process runs the HTTP server, GitHub poller (issues + PRs), task scheduler, PR-merge watcher, and owns every PTY.
+
+## Roadmap
+
+What works today:
+
+- Implement flow: GitHub issue → labeled trigger → agent runs in a worktree → PR opened → merge tracked → worktree cleaned.
+- Review flow: GitHub PR → labeled trigger → agent runs against the PR's head in a detached worktree → review posted via `gh pr review`.
+- Three agent types: Claude Code, Codex CLI, OpenCode.
+- Per-(agent, kind) queues and concurrency, so reviews never starve implements (and vice versa).
+- Manual implement triggering from the UI (no need to label first).
+- `claude --resume` for Claude Code retry; codex / opencode retry runs fresh.
+- Live PTY streaming with WebGL-rendered xterm.js, scrollback ring buffer, reconnect-safe.
+- Free-form `+ New terminal` shells (browser-based SSH-lite to the gateway machine).
+- macOS launchd background gateway with `tono gateway` lifecycle commands.
+- Live config edits via the web UI without restarting.
+
+What's next:
+
+- **Webhook triggers** to drop polling latency from ~60s to sub-second (Tailscale Funnel or smee.io).
+- **Manual review-task trigger** in the UI (today: label the PR).
+- **Distributed workers.** Designed but unbuilt. The gateway becomes a coordinator; workers connect over WebSocket and run agents on their own filesystems. Tailscale required, no app-level auth.
+- **Cost / token tracking.**
+- **Inline review comments** posted by tono itself rather than asking the agent to call `gh api`.
+
+## License
+
+[MIT](./LICENSE).

package/dist/cli/commands/config.js

@@ -0,0 +1,86 @@
+import { configPath, loadConfig, ConfigError, resolveRepoAgents } from "../../server/config/load.js";
+import { labelForAgentKind } from "../../shared/types.js";
+export function runConfigPath() {
+    console.log(configPath());
+}
+export function runConfigValidate() {
+    try {
+        const cfg = loadConfig();
+        console.log(`config valid: ${configPath()}`);
+        console.log(`  workspaces root: ${cfg.workspaces.root}`);
+        console.log(`  poll interval:   ${cfg.github.pollIntervalSeconds}s`);
+        const declaredAgents = Object.keys(cfg.agents);
+        console.log(`  agents declared: ${declaredAgents.length === 0 ? "(none)" : declaredAgents.join(", ")}`);
+        for (const [name, a] of Object.entries(cfg.agents)) {
+            if (!a)
+                continue;
+            console.log(`    - ${name}: command="${a.command}" implement=${a.concurrency.implement} review=${a.concurrency.review}`);
+        }
+        console.log(`  repos watched:   ${cfg.repos.length}`);
+        for (const r of cfg.repos) {
+            const enabled = resolveRepoAgents(cfg, r.agents);
+            console.log(`    - ${r.slug} (base=${r.baseBranch}, agents=[${enabled.join(", ")}])`);
+        }
+    }
+    catch (err) {
+        if (err instanceof ConfigError) {
+            console.error(err.message);
+            process.exit(1);
+        }
+        throw err;
+    }
+}
+export function runConfigLabels() {
+    try {
+        const cfg = loadConfig();
+        const declared = Object.keys(cfg.agents);
+        if (declared.length === 0) {
+            console.log("no agents declared in config; nothing to label.");
+            return;
+        }
+        console.log("Labels you can apply on GitHub to trigger tasks:");
+        console.log("");
+        const rows = [];
+        for (const agent of declared) {
+            rows.push({ agent, kind: "implement (issue)", label: labelForAgentKind(agent, "implement") });
+            rows.push({ agent, kind: "review (PR)", label: labelForAgentKind(agent, "review") });
+        }
+        const w = (s, n) => s.padEnd(n);
+        console.log(`  ${w("AGENT", 14)}${w("KIND", 20)}LABEL`);
+        for (const r of rows)
+            console.log(`  ${w(r.agent, 14)}${w(r.kind, 20)}${r.label}`);
+    }
+    catch (err) {
+        if (err instanceof ConfigError) {
+            console.error(err.message);
+            process.exit(1);
+        }
+        throw err;
+    }
+}
+export function runConfig(args) {
+    const sub = args[0];
+    switch (sub) {
+        case "path":
+            runConfigPath();
+            return;
+        case "validate":
+            runConfigValidate();
+            return;
+        case "labels":
+            runConfigLabels();
+            return;
+        case undefined:
+        case "--help":
+        case "-h":
+            console.log("tono config <subcommand>\n" +
+                "  path      print the config file path\n" +
+                "  validate  validate the current config against the schema\n" +
+                "  labels    print the GitHub labels each configured agent listens for");
+            return;
+        default:
+            console.error(`unknown subcommand: config ${sub}`);
+            process.exit(2);
+    }
+}
+//# sourceMappingURL=config.js.map

package/dist/cli/commands/config.js.map

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

package/dist/cli/commands/configure.js

@@ -0,0 +1,260 @@
+import { copyFileSync, existsSync, mkdirSync, readFileSync, writeFileSync } from "node:fs";
+import { dirname, join } from "node:path";
+import { ConfigError, configPath, SCHEMA_PATH, tonoHome, validate, } from "../../server/config/load.js";
+import { openDb } from "../../server/db/client.js";
+import { createPrompter } from "../prompt.js";
+import { AGENT_TYPES, labelForAgentKind, } from "../../shared/types.js";
+const SLUG_RE = /^[A-Za-z0-9._-]+\/[A-Za-z0-9._-]+$/;
+const IMPLEMENT_TEMPLATE_BASE = "You are working on GitHub issue #{issueNumber} in {repoSlug}.\n\n" +
+    "Title: {issueTitle}\n\n" +
+    "{issueBody}\n\n" +
+    "Implement the changes needed to resolve this issue. The current branch is " +
+    "{branch}, based on {baseBranch}. When implementation is complete, commit with " +
+    "a clear message, push the branch with `git push -u origin {branch}`, and open a " +
+    "pull request with `gh pr create --base {baseBranch} --fill`. If the issue is " +
+    "unclear or unsafe to proceed, leave a comment on the issue explaining why with " +
+    "`gh issue comment {issueNumber} --body \"<reason>\"` and stop.";
+const REVIEW_TEMPLATE_BASE = "You are reviewing GitHub PR #{issueNumber} in {repoSlug}: \"{issueTitle}\".\n" +
+    "PR URL: {prUrl}\n" +
+    "The PR's head branch ({branch}) is checked out at the current working directory.\n\n" +
+    "Description:\n{issueBody}\n\n" +
+    "Read the diff (`gh pr diff {issueNumber}`) and inspect the changed files. Form a " +
+    "thorough review: correctness, edge cases, security, performance, readability.\n\n" +
+    "When done, post your review with " +
+    "`gh pr review {issueNumber} --comment --body \"<review body>\"` (use --request-changes " +
+    "if blocking, or --approve if good to merge). For inline file/line comments use " +
+    "`gh api repos/{repoSlug}/pulls/{issueNumber}/comments`.\n\n" +
+    "Do not push commits. Do not create new PRs.";
+const DEFAULT_AGENT_COMMANDS = {
+    "claude-code": { command: "claude", args: ["--dangerously-skip-permissions"], conc: { implement: 2, review: 4 } },
+    codex: { command: "codex", args: [], conc: { implement: 1, review: 2 } },
+    opencode: { command: "opencode", args: ["run", "{prompt}"], conc: { implement: 1, review: 2 } },
+};
+function readExisting() {
+    const path = configPath();
+    if (!existsSync(path))
+        return null;
+    try {
+        return JSON.parse(readFileSync(path, "utf8"));
+    }
+    catch {
+        return null;
+    }
+}
+export async function runConfigure() {
+    const p = createPrompter();
+    try {
+        const existing = readExisting();
+        p.print("");
+        p.print("\x1b[1mtono configure\x1b[0m");
+        p.print("\x1b[2m" + (existing
+            ? `editing ${configPath()}`
+            : `creating ${configPath()}`) + "\x1b[0m");
+        p.print("");
+        // Server
+        const host = await p.ask("Bind host", {
+            default: existing?.server?.host ?? "0.0.0.0",
+            required: true,
+        });
+        const port = Number(await p.ask("Server port", {
+            default: String(existing?.server?.port ?? 7040),
+            validate: (s) => {
+                const n = Number(s);
+                if (!Number.isInteger(n) || n < 1 || n > 65535)
+                    return "must be 1–65535";
+                return null;
+            },
+        }));
+        // GitHub
+        const pollIntervalSeconds = Number(await p.ask("Poll interval (seconds)", {
+            default: String(existing?.github?.pollIntervalSeconds ?? 60),
+            validate: (s) => {
+                const n = Number(s);
+                if (!Number.isInteger(n) || n < 10 || n > 3600)
+                    return "must be 10–3600";
+                return null;
+            },
+        }));
+        // Workspaces
+        const workspacesRoot = await p.ask("Workspaces root", {
+            default: existing?.workspaces?.root ?? "~/.tono/workspaces",
+            required: true,
+        });
+        // Agents
+        p.print("");
+        p.print("\x1b[1mAgents\x1b[0m \x1b[2m(which agent CLIs to make available)\x1b[0m");
+        const enabledAgents = [];
+        for (const a of AGENT_TYPES) {
+            const wasEnabled = existing?.agents?.[a] !== undefined;
+            const yes = await p.askYesNo(`  enable ${a}?`, wasEnabled || a === "claude-code");
+            if (yes)
+                enabledAgents.push(a);
+        }
+        if (enabledAgents.length === 0) {
+            p.print("\x1b[31mat least one agent must be enabled.\x1b[0m");
+            process.exit(1);
+        }
+        const agentsConfig = {};
+        for (const a of enabledAgents) {
+            const seed = existing?.agents?.[a];
+            const dflt = DEFAULT_AGENT_COMMANDS[a];
+            const command = await p.ask(`  ${a} command`, {
+                default: seed?.command ?? dflt.command,
+                required: true,
+            });
+            const implement = Number(await p.ask(`  ${a} implement concurrency`, {
+                default: String(seed?.concurrency?.implement ?? dflt.conc.implement),
+                validate: (s) => {
+                    const n = Number(s);
+                    if (!Number.isInteger(n) || n < 0 || n > 32)
+                        return "0–32";
+                    return null;
+                },
+            }));
+            const review = Number(await p.ask(`  ${a} review concurrency`, {
+                default: String(seed?.concurrency?.review ?? dflt.conc.review),
+                validate: (s) => {
+                    const n = Number(s);
+                    if (!Number.isInteger(n) || n < 0 || n > 32)
+                        return "0–32";
+                    return null;
+                },
+            }));
+            agentsConfig[a] = {
+                command,
+                args: seed?.args ?? dflt.args,
+                concurrency: { implement, review },
+                promptTemplates: {
+                    implement: seed?.promptTemplates?.implement ?? IMPLEMENT_TEMPLATE_BASE,
+                    review: seed?.promptTemplates?.review ?? REVIEW_TEMPLATE_BASE,
+                },
+            };
+        }
+        // Repos
+        p.print("");
+        p.print("\x1b[1mRepos to watch\x1b[0m \x1b[2m(leave slug blank to finish)\x1b[0m");
+        const repos = [];
+        const seedRepos = existing?.repos ?? [];
+        let i = 0;
+        while (true) {
+            const seed = seedRepos[i];
+            const indexLabel = `Repo ${i + 1}`;
+            p.print("");
+            const slug = await p.ask(`${indexLabel} — owner/repo`, {
+                default: seed?.slug,
+                validate: (s) => {
+                    if (s === "")
+                        return null;
+                    if (!SLUG_RE.test(s))
+                        return "must be owner/repo";
+                    if (repos.some((r) => r.slug === s))
+                        return "already added";
+                    return null;
+                },
+            });
+            if (slug === "")
+                break;
+            const path = await p.ask(`${indexLabel} — path to local clone (blank = tono will bare-clone via gh)`, {
+                default: seed?.path ?? "",
+                validate: (s) => (s === "" || s.startsWith("/") ? null : "use an absolute path or leave blank"),
+            });
+            const baseBranch = await p.ask(`${indexLabel} — base branch`, {
+                default: seed?.baseBranch ?? "main",
+                required: true,
+            });
+            // Per-repo agent enrollment (subset of declared agents)
+            p.print(`${indexLabel} — which agents are enabled on this repo?`);
+            const seededRepoAgents = new Set(seed?.agents ?? enabledAgents);
+            const repoAgents = [];
+            for (const a of enabledAgents) {
+                const wasOn = seededRepoAgents.has(a);
+                const yes = await p.askYesNo(`    enroll ${a}?`, wasOn);
+                if (yes)
+                    repoAgents.push(a);
+            }
+            repos.push({
+                slug,
+                baseBranch,
+                ...(path ? { path } : {}),
+                ...(repoAgents.length > 0 && repoAgents.length < enabledAgents.length ? { agents: repoAgents } : {}),
+            });
+            i++;
+            const more = await p.askYesNo("Add another repo?", false);
+            if (!more)
+                break;
+        }
+        // Build the config
+        const cfg = {
+            $schema: "./config.schema.json",
+            server: { host, port },
+            github: { pollIntervalSeconds },
+            workspaces: { root: workspacesRoot },
+            repos,
+            agents: agentsConfig,
+        };
+        // Validate
+        try {
+            validate(cfg);
+        }
+        catch (err) {
+            if (err instanceof ConfigError) {
+                p.print("");
+                p.print("\x1b[31mConfiguration is invalid:\x1b[0m");
+                p.print(err.message);
+                process.exit(1);
+            }
+            throw err;
+        }
+        // Summary
+        p.print("");
+        p.print("\x1b[1mSummary\x1b[0m");
+        p.print(`  server:        http://${host}:${port}`);
+        p.print(`  poll interval: ${pollIntervalSeconds}s`);
+        p.print(`  workspaces:    ${workspacesRoot}`);
+        p.print(`  agents:`);
+        for (const [name, a] of Object.entries(agentsConfig)) {
+            if (!a)
+                continue;
+            p.print(`    - ${name}: command="${a.command}" implement=${a.concurrency.implement} review=${a.concurrency.review}`);
+        }
+        if (repos.length === 0) {
+            p.print(`  repos:         \x1b[2m(none — poller will idle)\x1b[0m`);
+        }
+        else {
+            p.print(`  repos:`);
+            for (const r of repos) {
+                const enabled = r.agents ?? enabledAgents;
+                p.print(`    - ${r.slug} (${r.baseBranch}, agents=[${enabled.join(", ")}])`);
+            }
+        }
+        p.print("");
+        p.print("\x1b[1mLabels you'll apply on GitHub:\x1b[0m");
+        for (const a of enabledAgents) {
+            p.print(`  ${a}: \x1b[36m${labelForAgentKind(a, "implement")}\x1b[0m for issues, \x1b[36m${labelForAgentKind(a, "review")}\x1b[0m for PRs`);
+        }
+        p.print("");
+        const ok = await p.askYesNo(`Write to ${configPath()}?`, true);
+        if (!ok) {
+            p.print("\x1b[2maborted; no changes written\x1b[0m");
+            return;
+        }
+        const home = tonoHome();
+        mkdirSync(home, { recursive: true });
+        mkdirSync(join(home, "logs"), { recursive: true });
+        mkdirSync(join(home, "workspaces"), { recursive: true });
+        const schemaDest = join(home, "config.schema.json");
+        copyFileSync(SCHEMA_PATH, schemaDest);
+        p.print(`wrote ${schemaDest}`);
+        mkdirSync(dirname(configPath()), { recursive: true });
+        writeFileSync(configPath(), JSON.stringify(cfg, null, 2) + "\n");
+        p.print(`wrote ${configPath()}`);
+        const db = openDb();
+        db.close();
+        p.print("");
+        p.print("\x1b[32mdone.\x1b[0m run \x1b[1mtono start\x1b[0m or \x1b[1mtono gateway install\x1b[0m");
+    }
+    finally {
+        p.close();
+    }
+}
+//# sourceMappingURL=configure.js.map