roughbook 0.0.0-stage → 0.1.0

package/LICENSE

@@ -0,0 +1,201 @@
+Apache License
+                           Version 2.0, January 2004
+                        http://www.apache.org/licenses/
+
+   TERMS AND CONDITIONS FOR USE, REPRODUCTION, AND DISTRIBUTION
+
+   1. Definitions.
+
+      "License" shall mean the terms and conditions for use, reproduction,
+      and distribution as defined by Sections 1 through 9 of this document.
+
+      "Licensor" shall mean the copyright owner or entity authorized by
+      the copyright owner that is granting the License.
+
+      "Legal Entity" shall mean the union of the acting entity and all
+      other entities that control, are controlled by, or are under common
+      control with that entity. For the purposes of this definition,
+      "control" means (i) the power, direct or indirect, to cause the
+      direction or management of such entity, whether by contract or
+      otherwise, or (ii) ownership of fifty percent (50%) or more of the
+      outstanding shares, or (iii) beneficial ownership of such entity.
+
+      "You" (or "Your") shall mean an individual or Legal Entity
+      exercising permissions granted by this License.
+
+      "Source" form shall mean the preferred form for making modifications,
+      including but not limited to software source code, documentation
+      source, and configuration files.
+
+      "Object" form shall mean any form resulting from mechanical
+      transformation or translation of a Source form, including but
+      not limited to compiled object code, generated documentation,
+      and conversions to other media types.
+
+      "Work" shall mean the work of authorship, whether in Source or
+      Object form, made available under the License, as indicated by a
+      copyright notice that is included in or attached to the work
+      (an example is provided in the Appendix below).
+
+      "Derivative Works" shall mean any work, whether in Source or Object
+      form, that is based on (or derived from) the Work and for which the
+      editorial revisions, annotations, elaborations, or other modifications
+      represent, as a whole, an original work of authorship. For the purposes
+      of this License, Derivative Works shall not include works that remain
+      separable from, or merely link (or bind by name) to the interfaces of,
+      the Work and Derivative Works thereof.
+
+      "Contribution" shall mean any work of authorship, including
+      the original version of the Work and any modifications or additions
+      to that Work or Derivative Works thereof, that is intentionally
+      submitted to Licensor for inclusion in the Work by the copyright owner
+      or by an individual or Legal Entity authorized to submit on behalf of
+      the copyright owner. For the purposes of this definition, "submitted"
+      means any form of electronic, verbal, or written communication sent
+      to the Licensor or its representatives, including but not limited to
+      communication on electronic mailing lists, source code control systems,
+      and issue tracking systems that are managed by, or on behalf of, the
+      Licensor for the purpose of discussing and improving the Work, but
+      excluding communication that is conspicuously marked or otherwise
+      designated in writing by the copyright owner as "Not a Contribution."
+
+      "Contributor" shall mean Licensor and any individual or Legal Entity
+      on behalf of whom a Contribution has been received by Licensor and
+      subsequently incorporated within the Work.
+
+   2. Grant of Copyright License. Subject to the terms and conditions of
+      this License, each Contributor hereby grants to You a perpetual,
+      worldwide, non-exclusive, no-charge, royalty-free, irrevocable
+      copyright license to reproduce, prepare Derivative Works of,
+      publicly display, publicly perform, sublicense, and distribute the
+      Work and such Derivative Works in Source or Object form.
+
+   3. Grant of Patent License. Subject to the terms and conditions of
+      this License, each Contributor hereby grants to You a perpetual,
+      worldwide, non-exclusive, no-charge, royalty-free, irrevocable
+      (except as stated in this section) patent license to make, have made,
+      use, offer to sell, sell, import, and otherwise transfer the Work,
+      where such license applies only to those patent claims licensable
+      by such Contributor that are necessarily infringed by their
+      Contribution(s) alone or by combination of their Contribution(s)
+      with the Work to which such Contribution(s) was submitted. If You
+      institute patent litigation against any entity (including a
+      cross-claim or counterclaim in a lawsuit) alleging that the Work
+      or a Contribution incorporated within the Work constitutes direct
+      or contributory patent infringement, then any patent licenses
+      granted to You under this License for that Work shall terminate
+      as of the date such litigation is filed.
+
+   4. Redistribution. You may reproduce and distribute copies of the
+      Work or Derivative Works thereof in any medium, with or without
+      modifications, and in Source or Object form, provided that You
+      meet the following conditions:
+
+      (a) You must give any other recipients of the Work or
+          Derivative Works a copy of this License; and
+
+      (b) You must cause any modified files to carry prominent notices
+          stating that You changed the files; and
+
+      (c) You must retain, in the Source form of any Derivative Works
+          that You distribute, all copyright, patent, trademark, and
+          attribution notices from the Source form of the Work,
+          excluding those notices that do not pertain to any part of
+          the Derivative Works; and
+
+      (d) If the Work includes a "NOTICE" text file as part of its
+          distribution, then any Derivative Works that You distribute must
+          include a readable copy of the attribution notices contained
+          within such NOTICE file, excluding those notices that do not
+          pertain to any part of the Derivative Works, in at least one
+          of the following places: within a NOTICE text file distributed
+          as part of the Derivative Works; within the Source form or
+          documentation, if provided along with the Derivative Works; or,
+          within a display generated by the Derivative Works, if and
+          wherever such third-party notices normally appear. The contents
+          of the NOTICE file are for informational purposes only and
+          do not modify the License. You may add Your own attribution
+          notices within Derivative Works that You distribute, alongside
+          or as an addendum to the NOTICE text from the Work, provided
+          that such additional attribution notices cannot be construed
+          as modifying the License.
+
+      You may add Your own copyright statement to Your modifications and
+      may provide additional or different license terms and conditions
+      for use, reproduction, or distribution of Your modifications, or
+      for any such Derivative Works as a whole, provided Your use,
+      reproduction, and distribution of the Work otherwise complies with
+      the conditions stated in this License.
+
+   5. Submission of Contributions. Unless You explicitly state otherwise,
+      any Contribution intentionally submitted for inclusion in the Work
+      by You to the Licensor shall be under the terms and conditions of
+      this License, without any additional terms or conditions.
+      Notwithstanding the above, nothing herein shall supersede or modify
+      the terms of any separate license agreement you may have executed
+      with Licensor regarding such Contributions.
+
+   6. Trademarks. This License does not grant permission to use the trade
+      names, trademarks, service marks, or product names of the Licensor,
+      except as required for reasonable and customary use in describing the
+      origin of the Work and reproducing the content of the NOTICE file.
+
+   7. Disclaimer of Warranty. Unless required by applicable law or
+      agreed to in writing, Licensor provides the Work (and each
+      Contributor provides its Contributions) on an "AS IS" BASIS,
+      WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or
+      implied, including, without limitation, any warranties or conditions
+      of TITLE, NON-INFRINGEMENT, MERCHANTABILITY, or FITNESS FOR A
+      PARTICULAR PURPOSE. You are solely responsible for determining the
+      appropriateness of using or redistributing the Work and assume any
+      risks associated with Your exercise of permissions under this License.
+
+   8. Limitation of Liability. In no event and under no legal theory,
+      whether in tort (including negligence), contract, or otherwise,
+      unless required by applicable law (such as deliberate and grossly
+      negligent acts) or agreed to in writing, shall any Contributor be
+      liable to You for damages, including any direct, indirect, special,
+      incidental, or consequential damages of any character arising as a
+      result of this License or out of the use or inability to use the
+      Work (including but not limited to damages for loss of goodwill,
+      work stoppage, computer failure or malfunction, or any and all
+      other commercial damages or losses), even if such Contributor
+      has been advised of the possibility of such damages.
+
+   9. Accepting Warranty or Additional Liability. While redistributing
+      the Work or Derivative Works thereof, You may choose to offer,
+      and charge a fee for, acceptance of support, warranty, indemnity,
+      or other liability obligations and/or rights consistent with this
+      License. However, in accepting such obligations, You may act only
+      on Your own behalf and on Your sole responsibility, not on behalf
+      of any other Contributor, and only if You agree to indemnify,
+      defend, and hold each Contributor harmless for any liability
+      incurred by, or claims asserted against, such Contributor by reason
+      of your accepting any such warranty or additional liability.
+
+   END OF TERMS AND CONDITIONS
+
+   APPENDIX: How to apply the Apache License to your work.
+
+      To apply the Apache License to your work, attach the following
+      boilerplate notice, with the fields enclosed by brackets "[]"
+      replaced with your own identifying information. (Don't include
+      the brackets!)  The text should be enclosed in the appropriate
+      comment syntax for the file format. We also recommend that a
+      file or class name and description of purpose be included on the
+      same "printed page" as the copyright notice for easier
+      identification within third-party archives.
+
+   Copyright [yyyy] [name of copyright owner]
+
+   Licensed under the Apache License, Version 2.0 (the "License");
+   you may not use this file except in compliance with the License.
+   You may obtain a copy of the License at
+
+       http://www.apache.org/licenses/LICENSE-2.0
+
+   Unless required by applicable law or agreed to in writing, software
+   distributed under the License is distributed on an "AS IS" BASIS,
+   WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+   See the License for the specific language governing permissions and
+   limitations under the License.

package/README.md

@@ -1,3 +1,167 @@
-# Temporary Holding Version
+# Roughbook studio
 
-This version is a temporary placeholder for this package. An operational version to replace this has been submitted for review and is awaiting a staged release.
+Design iterations inside your own repo, with the coding agent and editor you already use. The
+studio links a repo to a Roughbook project, writes each iteration's prompt into `rough/`, hands it
+to your agent, checks what came back, and lets you review, select and promote from a local UI.
+Your code stays on your machine: the server only ever sees ids, review decisions and run metadata.
+
+Runs on Windows, macOS and Linux, with Node 22 or later.
+
+## Commands
+
+| Command                                                  | Does                                                                                                                                                                                       |
+| -------------------------------------------------------- | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------ |
+| `roughbook login [--server <url>] [--no-browser]`        | Signs this machine in: shows a code to enter at the web's `/link` page and opens it                                                                                                        |
+| `roughbook init`                                         | In an app's repo: links it to a project and prepares it, showing every change first                                                                                                        |
+| `roughbook start [--port <port>] [--dev-url <url>]`      | Opens the local UI in your browser: the project's components, their iterations live, compare, review, runs with the built-in terminal, Done and promote                                    |
+| `roughbook run <page>/<component> …`                     | Starts iterations: `--direction <idea>` (up to eight), `--fork <iteration>`, or `--refine <iteration> --intent <text>`; opens your agent in a terminal, or `--headless` runs it unattended |
+| `roughbook done [<run or iteration>]`                    | Finishes a run: checks the iteration, lists files changed outside it, takes screenshots, reports it                                                                                        |
+| `roughbook review <page>/<component>/<iteration> …`      | `--select`, `--reject <reason> [--why <text>]`, or `--note <observation>`; saved on the server, so the next prompt remembers                                                               |
+| `roughbook revert <page>/<component>/<iteration> <file>` | Puts back a file the run changed outside its iteration                                                                                                                                     |
+| `roughbook pull <page>/<component>[/<sketch>]`           | Lists the component's web sketches, or brings one into `rough/` as the next local iteration                                                                                                |
+| `roughbook promote <page>/<component>`                   | Hands the selected iteration to your agent to write the real component (`--to <file>`, `--iteration <id>`)                                                                                 |
+| `roughbook agents [--default <agent>]`                   | Lists the coding agents found here, their sign-in and whether they can run unattended; sets the default                                                                                    |
+| `roughbook status`                                       | The sign-in, the linked project, and what is waiting to be sent                                                                                                                            |
+| `roughbook logout`                                       | Signs this machine out, here and on the server                                                                                                                                             |
+
+`init` asks which project the repo works on (or `--project <slug>`, `--new <name>`, with
+`--org <id>` when two organizations share a slug) and whether to commit `rough/` (`--commit`, the
+default, or `--no-commit`); `--yes` applies without asking. `--scratch <dir>` first makes a minimal
+Next.js 16 app with Tailwind v4 and a git repository there. It then:
+
+- writes `rough/` with `README.md`, `AGENTS.md` (the iteration rules every agent reads),
+  `CLAUDE.md` (pointing at them) and `roughbook.json` (the organization and project, no paths);
+- adds the development-only preview route under the App Router, `rough/preview.tsx` for the app's
+  providers, and the generated `rough/preview-registry.ts`;
+- excludes `rough/` and the route from TypeScript and ESLint, and adds an `@source` line so
+  Tailwind v4 sees the classes in `rough/`;
+- tells git what to keep: run state, screenshots, the registry and the route are never committed,
+  and `rough/` itself only when you choose not to commit it.
+
+A file the studio did not write is never replaced; it is listed for you to change by hand. Running
+`init` again changes nothing, and it adopts a repo prepared by Roughbook v2.
+
+## Local UI
+
+`roughbook start` serves the local UI on `127.0.0.1` (port 4848, or `--port`, which is kept
+for next time) and opens it. It shows each component's iterations rendered live by the app's own
+dev server (`--dev-url`, `ROUGHBOOK_DEV_URL`, or `http://localhost:3000`), with the last
+screenshot when the dev server is not answering; Compare; the review drawer, notes, select, reject
+and refine; a run panel for new directions, forks and refinements with the agent of your choice;
+each run's Done, its report, and Put it back for files changed outside it; the component's web
+sketches, each with Pull; and Deliver. The brief is read-only here, with a link to edit it on the web. While it runs, it keeps
+`rough/preview-registry.ts` in step with the iteration folders and sends what waits in the
+outbox.
+
+Runs open in the **built-in terminal** in the page (xterm.js on `node-pty`), or in your own
+terminal if you choose. A session runs the agent itself, never a shell, and belongs to its run:
+closing or reloading the page leaves it running, and joining again replays what it printed. It is
+used on Windows, macOS and glibc Linux, where `node-pty` installs and starts; elsewhere, and with
+`ROUGHBOOK_TERMINAL=external`, runs open in your own terminal.
+
+The server answers only `127.0.0.1` and `localhost` as its Host, and its API and terminal only
+the page it opened: a token made at each start reaches the page in the link's fragment, and every
+call carries it. Iterations load the project's and library's asset files from
+`http://127.0.0.1:<port>/api/files/…`, which this server fetches from the backend with your
+sign-in; prompts name that address, so keep the port.
+
+## Development
+
+```bash
+npm install
+npm run dev -- --help
+```
+
+| Script               | Does                                                     |
+| -------------------- | -------------------------------------------------------- |
+| `npm run dev -- <…>` | Runs the CLI from source through `tsx`                   |
+| `npm test`           | `node --test` over `src/**/*.test.ts`, never the network |
+| `npm run type-check` | `tsc --noEmit` for the CLI and the local UI              |
+| `npm run lint`       | ESLint, including the studio's own rules (`AGENTS.md`)   |
+| `npm run build`      | Compiles to `dist/` and the UI to `dist/ui/`             |
+| `npm run build:ui`   | The local UI alone, with Vite                            |
+
+The backend is `roughbook-backend`. The studio talks to `http://localhost:4000` unless
+`ROUGHBOOK_SERVER` or `roughbook login --server` says otherwise; anything but this machine must be
+https.
+
+## Where things are kept
+
+| What                           | Where                                                |
+| ------------------------------ | ---------------------------------------------------- |
+| Your sign-in (install token)   | The user config folder (below), readable only by you |
+| The repo's link to its project | `rough/roughbook.json`, committed with `rough/`      |
+| The default agent, local port  | `settings.json` in the user config folder            |
+| Runs, snapshots, the outbox    | `rough/.roughbook/`, never committed                 |
+| Screenshots                    | `rough/.screenshots/`, never committed               |
+
+The user config folder is `%APPDATA%\Roughbook` on Windows, `~/Library/Application Support/Roughbook`
+on macOS, and `$XDG_CONFIG_HOME/roughbook` (or `~/.config/roughbook`) on Linux.
+`ROUGHBOOK_CONFIG_DIR` overrides it.
+
+## Runs
+
+A run starts with the backend: it allocates the iteration and compiles the prompt. The studio then
+records every file in the repo by hash (copying aside any with uncommitted changes), writes the
+iteration's folder (a placeholder, or a copy of the parent for a fork or refinement) and the prompt
+in `rough/<page>/<component>/prompts/<run>.md`, and hands the agent one line:
+`Follow the instructions in <prompt file>`. At Done it applies the backend's checks (the entry
+file exists and is not the placeholder, a fork changed from its parent, the approved headline
+appears) and its own (nothing outside `rough/` imports from it), lists every file changed outside
+the run's folder, and sends the outcome, warning codes and counts. Any such file can be put back:
+a new one is removed, an uncommitted one comes back from its copy, a committed one from git.
+
+Reviews and run results are written to the outbox first and sent in order when the backend can be
+reached, so nothing is lost offline; the server applies one sent twice once. `run` sends what is
+waiting before it asks for a prompt, so a rejection always reaches the next one.
+
+Claude Code and Codex are supported. A run opens the agent in a terminal: Windows Terminal or a
+console window on Windows, Terminal or iTerm on macOS (`ROUGHBOOK_TERMINAL=iterm`), and
+`$TERMINAL`, `x-terminal-emulator`, GNOME Terminal, Konsole or xterm on Linux; otherwise it prints
+the command to paste. `--headless` runs the agent unattended, only with your own API key
+(`ANTHROPIC_API_KEY` for Claude Code, `CODEX_API_KEY` or `OPENAI_API_KEY` for Codex), confined
+to the run's folder, and reports its token counts. `done` takes desktop and phone screenshots
+through the app's dev server (`--dev-url`, `ROUGHBOOK_DEV_URL`, or `http://localhost:3000`) with
+Chrome, Chromium or Edge (`ROUGHBOOK_BROWSER` names another), into `rough/.screenshots/`.
+
+## Pull
+
+`pull` brings a web sketch into the repo as the starting point of a local iteration: a fork whose
+parent is the sketch. The backend allocates the next number and sends the sketch's files; the
+studio checks every path before writing (its own folder only, known file types, a few folders
+deep), never writes over an iteration, points the sketch's `/api/files/…` URLs at the local server,
+and regenerates the preview registry. The iteration is generated already, so it can be reviewed,
+refined (`run --refine`) and promoted like any other. Sketches use React, Tailwind and a few allowed
+packages (motion, lucide-react, clsx, three, model-viewer); `pull` names any the app's
+`package.json` does not list, with the command that adds them. A run going at the time does not
+count the pulled files as its own writes. Nothing local goes up.
+
+## Promote
+
+`promote` takes the component's selected iteration (or `--iteration`). The backend writes the
+prompt from the brief; the studio copies the project and library assets the iteration uses into
+`public/rough/<page>/<component>/` (beside the app's `package.json`, or `--public <folder>`), the
+approved copy to `rough/<page>/<component>/copy.md`, fills in the component file
+(`src/components/<Name>.tsx` by default, or `--to <file>`), and opens your agent with the prompt.
+The server never hears the file's path. An existing file is never overwritten, and nothing is
+committed: you review the diff.
+
+## Layout
+
+```text
+src/
+  cli.ts        the only process.cwd(); finds the repo root; runs a command
+  commands/     one file per command, and the registry
+  api/          the typed client for /studio, its errors, and the outbox
+  config/       sign-in, server address, the user config folder
+  agents/       one adapter per coding agent: finding it, terminal sessions, unattended runs
+  launch/       everything that differs by OS: terminals, opening a browser, naming the OS
+  screenshot/   headless Chrome, Chromium or Edge, at desktop and phone widths
+  runs/         local runs: slots and prompt files, the checks, snapshots and revert, the watcher,
+                review decisions, sketch pulls, and promotion
+  repo/         the repo root, repo prep and the preview route, the link file, scratch apps
+  fs/           whole-file JSON writes and the lock the CLI and local server share
+  server/       the local server: its API, the built-in terminal's sessions, who may ask
+  tests/
+ui/             the local UI: Vite, React and @roughbook/ui, built into dist/ui
+```

package/dist/agents/claude.js

@@ -0,0 +1,214 @@
+// Claude Code. Flags checked against `claude --help` in Claude Code 2.1.286 (2026-10-05), and
+// the permission rules against its permissions docs: `--permission-mode` no longer takes
+// "default", so a headless run uses "dontAsk", which refuses anything not allowed instead of
+// asking, with one allow rule for the run's folder. `--bare` makes the CLI use only an Anthropic
+// API key (ANTHROPIC_API_KEY), never a claude.ai login, which is the split plan's rule for
+// unattended runs. The stream-json field names follow its docs; check them against the first
+// real headless run.
+import path from 'node:path';
+import { compareVersions, findNpmScript, findOnPath, fromEnv } from '../launch/which.js';
+import { diskProbe } from '../launch/platform.js';
+import { count, record, runCommand } from './command.js';
+const NOT_FOUND = 'Claude Code was not found. Install it, or set ROUGHBOOK_CLAUDE_BIN to the full path of claude.';
+/** The copy the Claude desktop app keeps: <data>/Claude/claude-code/<version>/[<build>/]claude. */
+function desktopCopy(lookup) {
+    const windows = lookup.platform === 'win32';
+    const p = windows ? path.win32 : path.posix;
+    const probe = lookup.probe ?? diskProbe;
+    const data = windows
+        ? lookup.env.APPDATA
+        : lookup.platform === 'darwin'
+            ? p.join(lookup.home, 'Library', 'Application Support')
+            : null;
+    if (!data)
+        return null;
+    const root = p.join(data, 'Claude', 'claude-code');
+    const executable = windows ? 'claude.exe' : 'claude';
+    for (const version of probe.dirs(root).sort((a, b) => compareVersions(b, a))) {
+        const direct = p.join(root, version, executable);
+        if (probe.exists(direct))
+            return direct;
+        for (const build of probe.dirs(p.join(root, version))) {
+            const nested = p.join(root, version, build, executable);
+            if (probe.exists(nested))
+                return nested;
+        }
+    }
+    return null;
+}
+/** What a headless run may do: write its folder; never run commands, fetch, or read secrets. */
+export function headlessSettings(targetFolder) {
+    return {
+        permissions: {
+            allow: [`Edit(./${targetFolder}/**)`],
+            deny: [
+                'Bash',
+                'PowerShell',
+                'WebFetch',
+                'WebSearch',
+                'Read(./.env)',
+                'Read(./.env.*)',
+                'Read(./**/.env)',
+                'Read(./**/.env.*)'
+            ]
+        }
+    };
+}
+export function parseClaudeLine(line) {
+    let parsed;
+    try {
+        parsed = record(JSON.parse(line.trim()));
+    }
+    catch {
+        return {};
+    }
+    switch (parsed.type) {
+        case 'system':
+            return parsed.subtype === 'init' && typeof parsed.session_id === 'string'
+                ? { event: { kind: 'session', id: parsed.session_id } }
+                : {};
+        case 'assistant': {
+            const content = record(parsed.message).content;
+            for (const block of Array.isArray(content) ? content.map(record) : []) {
+                if (block.type === 'text' && typeof block.text === 'string' && block.text.trim()) {
+                    return { event: { kind: 'message', text: block.text } };
+                }
+                if (block.type === 'tool_use' && typeof block.name === 'string') {
+                    return { event: { kind: 'tool', name: block.name } };
+                }
+            }
+            return {};
+        }
+        case 'result': {
+            const usage = record(parsed.usage);
+            const models = Object.keys(record(parsed.modelUsage));
+            const text = typeof parsed.result === 'string' && parsed.result.trim() ? parsed.result.trim() : null;
+            return {
+                event: {
+                    kind: 'result',
+                    ok: parsed.subtype === 'success' && parsed.is_error !== true,
+                    text
+                },
+                usage: {
+                    model: models[0] ?? '',
+                    inputTokens: count(usage.input_tokens),
+                    outputTokens: count(usage.output_tokens),
+                    cacheReadTokens: count(usage.cache_read_input_tokens),
+                    cacheWriteTokens: count(usage.cache_creation_input_tokens)
+                }
+            };
+        }
+        default:
+            return {};
+    }
+}
+export const claudeCode = {
+    id: 'claude-code',
+    name: 'Claude Code',
+    kind: 'terminal',
+    capabilities: { interactive: true, headless: true, permissions: true, usage: true },
+    notFound: NOT_FOUND,
+    find(lookup) {
+        const p = lookup.platform === 'win32' ? path.win32 : path.posix;
+        const probe = lookup.probe ?? diskProbe;
+        const explicit = fromEnv('ROUGHBOOK_CLAUDE_BIN', lookup);
+        if (explicit)
+            return explicit;
+        const onPath = findOnPath('claude', lookup);
+        if (onPath)
+            return { command: onPath, prefixArgs: [], source: 'PATH' };
+        const npm = findNpmScript('claude', '@anthropic-ai/claude-code', 'cli.js', lookup);
+        if (npm)
+            return npm;
+        const native = p.join(lookup.home, '.local', 'bin', lookup.platform === 'win32' ? 'claude.exe' : 'claude');
+        if (probe.exists(native))
+            return { command: native, prefixArgs: [], source: 'native install' };
+        const desktop = desktopCopy(lookup);
+        return desktop ? { command: desktop, prefixArgs: [], source: 'Claude desktop app' } : null;
+    },
+    async detect(lookup) {
+        const base = {
+            id: this.id,
+            name: this.name,
+            kind: this.kind,
+            capabilities: this.capabilities
+        };
+        const executable = this.find(lookup);
+        if (!executable) {
+            return {
+                ...base,
+                found: false,
+                executable: null,
+                version: null,
+                signedIn: null,
+                signIn: null,
+                headless: { ready: false, reason: NOT_FOUND }
+            };
+        }
+        const version = await runCommand(executable, ['--version']);
+        let signedIn = null;
+        let signIn = null;
+        const status = await runCommand(executable, ['auth', 'status', '--json']);
+        try {
+            const parsed = record(JSON.parse(status.stdout));
+            if (typeof parsed.loggedIn === 'boolean')
+                signedIn = parsed.loggedIn;
+            if (parsed.loggedIn === true)
+                signIn = typeof parsed.authMethod === 'string' ? parsed.authMethod : 'signed in';
+            else if (parsed.loggedIn === false)
+                signIn = 'not signed in';
+        }
+        catch {
+            signIn = null;
+        }
+        const headless = lookup.env.ANTHROPIC_API_KEY?.trim()
+            ? { ready: true }
+            : {
+                ready: false,
+                reason: 'Unattended runs use your own Anthropic API key: set ANTHROPIC_API_KEY. A claude.ai login works for terminal sessions.'
+            };
+        return {
+            ...base,
+            found: version.ok,
+            executable,
+            version: (version.stdout || version.stderr).trim().split(/\s+/)[0] || null,
+            signedIn,
+            signIn,
+            headless: version.ok ? headless : { ready: false, reason: 'Claude Code could not be run.' }
+        };
+    },
+    interactiveArgs(run) {
+        return [...(run.model ? ['--model', run.model] : []), '--name', run.title, run.instruction];
+    },
+    headless(run, executable, env) {
+        if (!env.ANTHROPIC_API_KEY?.trim()) {
+            return {
+                refused: 'Unattended runs use your own Anthropic API key: set ANTHROPIC_API_KEY, or run it in a terminal session.'
+            };
+        }
+        return {
+            command: executable.command,
+            args: [
+                ...executable.prefixArgs,
+                '--bare',
+                '-p',
+                '--output-format',
+                'stream-json',
+                '--verbose',
+                '--session-id',
+                run.sessionId,
+                '--permission-mode',
+                'dontAsk',
+                '--settings',
+                JSON.stringify(headlessSettings(run.targetFolder)),
+                ...(run.model ? ['--model', run.model] : []),
+                run.instruction
+            ],
+            cwd: run.repoRoot,
+            stdin: null,
+            env: {}
+        };
+    },
+    parseLine: parseClaudeLine
+};
+//# sourceMappingURL=claude.js.map

package/dist/agents/claude.js.map

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