copperhead 0.7.0 → 0.8.1

package/README.md

@@ -10,6 +10,10 @@
 
 **Cursor for circuit boards.** An AI agent that designs, documents, and validates real PCBs from a prompt, working directly on existing KiCad repositories.
 
+<p align="center">
+  <img src="https://raw.githubusercontent.com/chouhanindustries/copperhead/main/assets/copperhead.gif" alt="copperhead agent shell demo" width="720">
+</p>
+
 > **Status: early.** Phase 1 is implemented and the CLI runs. The [technical specification](openspec/specs/SPEC.md) is the source of truth; expect the surface to move before 1.0.
 
 Full documentation lives at [docs.copperhead.sh](https://docs.copperhead.sh).
@@ -29,19 +33,35 @@ It reads and edits real `.kicad_sch` / `.kicad_pcb` files (s-expression text), m
 npm install -g copperhead   # or: npx copperhead check
 ```
 
+### Bootstrap script (macOS and Linux)
+
+Prefer a one-command setup? [`install.sh`](install.sh) checks the prerequisites below, installs copperhead (globally via npm, or built from source when run inside a checkout), and verifies the result with `copperhead doctor`:
+
+```bash
+./install.sh                # interactive: asks before installing anything
+./install.sh --yes          # assume yes to the install prompts
+./install.sh --check-only   # report what is missing, install nothing
+```
+
+The script is conservative by design: it never runs `sudo` and never edits shell config; whenever it cannot act safely on its own it prints the exact command for you to run instead. Rerunning is safe: on a ready machine it installs nothing and exits 0.
+
 ### Requirements
 
 - Node.js ≥ 20
 - [KiCad](https://www.kicad.org/) ≥ 8 with `kicad-cli` on PATH
-- One model backend: a locally installed, ChatGPT-authenticated [Codex CLI](https://learn.chatgpt.com/docs/codex/cli), a logged-in Claude Code (see [Saved login](#saved-login-claude-code)), or `ANTHROPIC_API_KEY`/`OPENAI_API_KEY` in the environment. `check` never calls an LLM.
+- One model backend: a locally installed, ChatGPT-authenticated [Codex CLI](https://learn.chatgpt.com/docs/codex/cli), a logged-in [Cursor Agent CLI](#saved-login-cursor-agent) (`agent login`), logged-in Claude Code (see [Saved login](#saved-login-claude-code)), or `ANTHROPIC_API_KEY`/`OPENAI_API_KEY` in the environment. `check` never calls an LLM.
 
 ## Quick start
 
 In an existing KiCad repository:
 
 ```bash
-export ANTHROPIC_API_KEY=...   # or OPENAI_API_KEY
+export ANTHROPIC_API_KEY=...   # or OPENAI_API_KEY; optional: with no key, `copperhead` offers a model picker
 copperhead init                # scaffold docs/ from the schematic; idempotent
+copperhead                     # interactive agent shell (Claude Code–style REPL)
+copperhead demo --tour          # what the agent does (no LLM)
+copperhead demo --model cursor # full USB-C breakout create pipeline
+# or one-shot:
 copperhead do "add reverse-polarity protection on VIN"
 copperhead check               # ERC + DRC + doc drift; no LLM, CI-safe
 ```
@@ -88,14 +108,26 @@ Spec-gated in, verification-gated out: the design can't drift from its requireme
 copperhead init [--path hardware/]   # scaffold docs/ from an existing schematic; idempotent
 copperhead do "<change request>"     # the core loop: propose, edit, verify, propagate, commit
 copperhead check                     # ERC + DRC + doc-drift + spec validation; no LLM calls (alias: verify)
+copperhead doctor                    # env preflight: kicad-cli, git, node, provider credential; no LLM/network
 copperhead sync [--dry-run]          # verify the whole design state, resolve drift
 copperhead create --brief brief.md   # brief → full output package
 copperhead export bom --supplier jlcpcb   # supplier-ready ordering file from docs/BOM.md
 ```
 
-Global flags: `--repo <path>` (default: cwd) and `--json` for machine-readable output. `do` and `create` take `--model` and `--interactive`; `do` also takes `--dry-run`, `--max-turns`, and `--allow-dirty`.
+Global flags: `--repo <path>` (default: cwd) and `--json` for machine-readable output. `--model` is available on `do`, `sync`, `create`, and `doctor`; `--interactive` only on `do` and `create`; `do` also takes `--dry-run`, `--max-turns`, and `--allow-dirty`.
+
+`--model` accepts `gpt-5` (OpenAI), `claude` / `claude-<id>` (Anthropic API), `claude-code` / `claude-code:<id>` (Claude Code, saved login), `cursor` / `cursor:<id>` (Cursor Agent CLI, saved login), and `codex` / `codex:<id>` (Codex CLI, saved login). Routing is by prefix; `claude-code` is matched before the `claude` prefix.
+
+### Saved login (Cursor Agent)
+
+`--model cursor` drives the Cursor Agent CLI with your saved login from `agent login`, so you can run copperhead with **no `OPENAI_API_KEY` or `ANTHROPIC_API_KEY`**. Cursor is used purely as a reasoning backend in plan mode: the agent loop, safety gates, and every file edit stay inside copperhead.
+
+```bash
+agent status
+copperhead do "add reverse-polarity protection on VIN" --model cursor
+```
 
-`--model` accepts `gpt-5` (OpenAI), `claude` / `claude-<id>` (Anthropic API), `claude-code` / `claude-code:<id>` (Claude Code, saved login), and `codex` / `codex:<id>` (Codex CLI, saved login). Routing is by prefix; `claude-code` is matched before the `claude` prefix.
+If `agent` is not on `PATH`, set `COPPERHEAD_CURSOR_PATH` to the CLI binary (also available as `cursor-agent` on some installs). Cursor's JSON schema does not report token usage, so run summaries show 0 tokens for `--model cursor`.
 
 ### Saved login (Claude Code)
 

package/dist/agent/animate.js

@@ -0,0 +1,76 @@
+/**
+ * Subtle TTY motion for attended copperhead chrome. Disabled when color is
+ * off, stdout is not a TTY, CI=1, or COPPERHEAD_NO_ANIM=1.
+ */
+import { copper, isColorEnabled } from './theme.js';
+export function prefersAnimation() {
+    return (isColorEnabled() &&
+        Boolean(process.stdout.isTTY) &&
+        !process.env.CI &&
+        !process.env.COPPERHEAD_NO_ANIM);
+}
+export function sleep(ms) {
+    return new Promise((r) => setTimeout(r, ms));
+}
+const HIDE = '\x1b[?25l';
+const SHOW = '\x1b[?25h';
+/** Growing fiducial frames (3 rows), converging on the block mark. Exported for tests. */
+export function fiducialBootFrames() {
+    return [
+        ['         ', '    ██   ', '         '],
+        ['   ▗▄▄▖  ', '   █  █  ', '   ▝▀▀▘  '],
+        ['   ▄▟▙▄  ', '  ██  ██ ', '   ▀▜▛▀  '],
+        ['   ▄▟▙▄  ', ' ███  ███', '   ▀▜▛▀  '],
+    ].map((frame) => frame.map((row) => copper(row)));
+}
+/**
+ * Pulse the fiducial mark in place over the already-rendered banner (rows
+ * `topRow..topRow+2`, column 1). The full screen loads first; this animates
+ * after, two grow cycles ending on the final mark. Frames are constant
+ * width so they overwrite each other without clearing the banner text
+ * beside them. Deliberately avoids DECSC/DECRC: the dock owns that slot for
+ * its caret-parking protocol; the caller repaints the dock afterwards to
+ * restore the caret.
+ */
+export async function animateMarkAt(out, topRow, opts) {
+    if (!prefersAnimation())
+        return;
+    const frames = fiducialBootFrames();
+    const frameMs = opts?.slow ? 110 : 45;
+    const holdMs = opts?.slow ? 220 : 90;
+    try {
+        for (let cycle = 0; cycle < 2; cycle++) {
+            for (const frame of frames) {
+                let seq = HIDE;
+                frame.forEach((row, i) => {
+                    seq += `\x1b[${topRow + i};1H${row}`;
+                });
+                out.write(seq);
+                await sleep(frameMs);
+            }
+        }
+        await sleep(holdMs);
+    }
+    finally {
+        // Never leave the terminal with a hidden cursor, even if a write or
+        // sleep throws mid-animation.
+        out.write(SHOW);
+    }
+}
+/** Copper horizontal rule (PCB-trace vibe). */
+export function traceRule(width = 32) {
+    return copper('  ' + '─'.repeat(Math.max(8, Math.min(width, 48))));
+}
+/** Cascade lines (help / demo sections). Instant when animation is off. */
+export async function staggerWrite(lines, write, delayMs = 12) {
+    if (!prefersAnimation()) {
+        for (const line of lines)
+            write(line);
+        return;
+    }
+    for (const line of lines) {
+        write(line);
+        await sleep(delayMs);
+    }
+}
+//# sourceMappingURL=animate.js.map

package/dist/agent/animate.js.map

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

package/dist/agent/box.js

@@ -0,0 +1,89 @@
+/**
+ * Box-drawing primitives for the bottom-docked REPL chrome: input box,
+ * status bar, and notice callouts. All width math ignores SGR sequences so
+ * colored segments never break padding or wrap accounting.
+ */
+import { copper, err, isColorEnabled, ruleDim, warn } from './theme.js';
+const SGR = /\x1b\[[0-9;]*m/g;
+/** Visible width ignoring SGR color codes. */
+export function visibleWidth(s) {
+    return s.replace(SGR, '').length;
+}
+/** Inverse video (synthetic caret / hover); no-op when color is off. */
+export function inverse(s) {
+    if (!isColorEnabled() || s === '')
+        return s;
+    return `\x1b[7m${s}\x1b[0m`;
+}
+/**
+ * Wrap styled spans into lines no wider than `width`. Styling is applied per
+ * slice, so a span can be cut at a wrap boundary without leaking SGR state.
+ */
+export function wrapSpans(spans, width) {
+    const w = Math.max(1, width);
+    const lines = [];
+    let cur = '';
+    let curLen = 0;
+    for (const span of spans) {
+        let text = span.text;
+        while (text.length) {
+            const take = text.slice(0, w - curLen);
+            cur += span.paint ? span.paint(take) : take;
+            curLen += take.length;
+            text = text.slice(take.length);
+            if (curLen >= w) {
+                lines.push(cur);
+                cur = '';
+                curLen = 0;
+            }
+        }
+    }
+    if (cur !== '' || !lines.length)
+        lines.push(cur);
+    return lines;
+}
+/** Full-width horizontal rule (the input-area separators), #888888. */
+export function rule(width) {
+    return ruleDim('─'.repeat(Math.max(1, width)));
+}
+/** Truncate to a visible width, keeping SGR sequences intact and closed. */
+export function truncateVisible(s, width) {
+    if (visibleWidth(s) <= width)
+        return s;
+    let out = '';
+    let vis = 0;
+    let i = 0;
+    let hadSgr = false;
+    while (i < s.length && vis < width) {
+        if (s[i] === '\x1b') {
+            const m = /^\x1b\[[0-9;]*m/.exec(s.slice(i));
+            if (m) {
+                out += m[0];
+                hadSgr = true;
+                i += m[0].length;
+                continue;
+            }
+        }
+        out += s[i];
+        vis++;
+        i++;
+    }
+    return out + (hadSgr ? '\x1b[0m' : '');
+}
+/** One status line with a left- and a right-justified half. */
+export function statusBar(left, right, width) {
+    const w = Math.max(8, width);
+    const l = visibleWidth(left);
+    const r = visibleWidth(right);
+    // Too narrow for both: the hints matter more than the meta.
+    if (l + r + 2 > w)
+        return truncateVisible(left, w);
+    return left + ' '.repeat(w - l - r) + right;
+}
+/** Notice block: thin colored left bar + title + dim body (banner callouts). */
+export function callout(kind, title, body) {
+    const paintBar = kind === 'err' ? err : kind === 'warn' ? warn : copper;
+    const bar = paintBar(' ▎');
+    return [`${bar} ${paintBar(title)}`, ...body.map((b) => `${bar} ${b}`)];
+}
+//# sourceMappingURL=box.js.map

package/dist/agent/box.js.map

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

package/dist/agent/dock-renderer.js

@@ -0,0 +1,173 @@
+/**
+ * REPL-session renderer: the single owner of the bottom dock during agent
+ * turns. Durable output (tool lines, turn markers, the outcome) flows into
+ * the content region through `emit`, which the REPL also records as
+ * scrollable history; the live observability line (spinner, turn, tokens,
+ * elapsed, busy text) is painted inside the dock, pinned to the bottom of
+ * the screen no matter how much output scrolls above it.
+ */
+import { rule, statusBar } from './box.js';
+import { copper, dim, styleOutcome, toolLine, warn } from './theme.js';
+import { fmtDuration, fmtTokens, turnMarker } from './render.js';
+const FRAMES = ['⠋', '⠙', '⠹', '⠸', '⠼', '⠴', '⠦', '⠧', '⠇', '⠏'];
+/** Claude Code-style working words, board-shop edition. One per turn. */
+const WORKING = [
+    'Routing',
+    'Etching',
+    'Reflowing',
+    'Soldering',
+    'Drilling',
+    'Plating',
+    'Probing',
+    'Fluxing',
+    'Tinning',
+    'Laminating',
+    'Silkscreening',
+    'Panelizing',
+];
+/** Fixed word-slot width: longest word plus the static dots. */
+const WORD_SLOT = Math.max(...WORKING.map((w) => w.length)) + 3;
+export class DockRenderer {
+    dock;
+    emit;
+    chrome;
+    turn = 0;
+    maxTurns = 0;
+    tokensIn = 0;
+    tokensOut = 0;
+    streamedChars = 0;
+    busy = null;
+    frame = 0;
+    runSeed = 0;
+    startMs = Date.now();
+    timer = null;
+    constructor(dock, 
+    /** Durable line sink: content region + session history. */
+    emit, 
+    /** Dock chrome around the status row (meta right, bottom hints). */
+    chrome) {
+        this.dock = dock;
+        this.emit = emit;
+        this.chrome = chrome;
+    }
+    log(line) {
+        this.emit(line);
+    }
+    toolResult(name, firstLine) {
+        this.emit(toolLine(name, firstLine));
+    }
+    turnStartMs = Date.now();
+    turnStart(turn, maxTurns, tokensIn, tokensOut) {
+        if (turn === 1) {
+            this.startMs = Date.now();
+            this.runSeed++;
+        }
+        this.turnStartMs = Date.now();
+        this.turn = turn;
+        this.maxTurns = maxTurns;
+        this.tokensIn = tokensIn;
+        this.tokensOut = tokensOut;
+        this.emit(dim(turnMarker(turn, maxTurns, tokensIn, tokensOut)));
+        this.arm();
+        this.paint();
+    }
+    status(text) {
+        this.busy = text;
+        if (text === null)
+            this.streamedChars = 0;
+        this.paint();
+    }
+    heartbeat(info) {
+        this.streamedChars = info.streamedChars;
+        this.paint();
+    }
+    finish(line) {
+        this.disarm();
+        this.busy = null;
+        this.emit(styleOutcome(line));
+        // The next prompt's renderDock() takes the dock back over.
+    }
+    /** Currently displayed working word; morphs letter by letter on change. */
+    shownWord = '';
+    targetWord = '';
+    /** -1 = settled; otherwise progress through erase-then-type transition. */
+    morph = -1;
+    arm() {
+        if (this.timer)
+            return;
+        this.timer = setInterval(() => {
+            this.frame++;
+            // Sweep three positions per tick: a full word crossfade in under a second.
+            if (this.morph >= 0)
+                this.morph += 3;
+            this.paint();
+        }, 120);
+        this.timer.unref?.();
+    }
+    disarm() {
+        if (this.timer)
+            clearInterval(this.timer);
+        this.timer = null;
+    }
+    /** Pinned observability row painted inside the dock (same layout as the prompt). */
+    paint() {
+        const w = Math.max(10, this.dock.cols() - 1);
+        const spinner = copper(FRAMES[this.frame % FRAMES.length]);
+        // Claude Code-style working word, board-shop themed: rotates every ~6s
+        // while a turn runs, with a shimmering highlight sweeping the letters.
+        // A word change morphs letter by letter: the old word is erased into
+        // `_` slots left to right, then the new word types over them.
+        const wordIdx = (this.runSeed + this.turn + Math.floor((Date.now() - this.turnStartMs) / 6000)) %
+            WORKING.length;
+        const target = WORKING[wordIdx];
+        if (this.shownWord === '')
+            this.shownWord = target;
+        if (target !== this.targetWord) {
+            this.targetWord = target;
+            if (target !== this.shownWord)
+                this.morph = 0;
+        }
+        let text = `${this.shownWord}...`;
+        if (this.morph >= 0) {
+            // Single left-to-right sweep over the whole dotted string (dots
+            // included): each position flips old char -> `_` -> new char, so the
+            // words cross-fade character by character.
+            const oldS = `${this.shownWord}...`;
+            const newS = `${this.targetWord}...`;
+            const width = Math.max(oldS.length, newS.length);
+            const k = this.morph;
+            if (k >= width) {
+                this.shownWord = this.targetWord;
+                this.morph = -1;
+                text = `${this.shownWord}...`;
+            }
+            else {
+                let out = '';
+                for (let i = 0; i < width; i++) {
+                    out += i < k ? (newS[i] ?? ' ') : i === k ? '_' : (oldS[i] ?? ' ');
+                }
+                text = out.trimEnd();
+            }
+        }
+        // Fixed-width slot (longest word + dots) so the stats after it never
+        // shift; dots and morph slots share the word's copper.
+        const word = copper(text.padEnd(WORD_SLOT));
+        const parts = [
+            dim(`turn ${this.turn}/${this.maxTurns}`),
+            dim(`${fmtTokens(this.tokensIn)} in / ${fmtTokens(this.tokensOut)} out`),
+            dim(fmtDuration(Date.now() - this.startMs)),
+        ];
+        if (this.busy) {
+            parts.push(warn(this.streamedChars ? `${this.busy} ~${fmtTokens(this.streamedChars)} ch` : this.busy));
+        }
+        const { meta, hints } = this.chrome();
+        this.dock.set([
+            ...(meta ? [statusBar('', `${meta} `, w)] : []),
+            rule(w),
+            statusBar(`${spinner} ${word}`, `${parts.join(dim(' · '))} `, w),
+            rule(w),
+            ...(hints ? [statusBar(`  ${hints}`, '', w)] : []),
+        ]);
+    }
+}
+//# sourceMappingURL=dock-renderer.js.map

package/dist/agent/dock-renderer.js.map

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

package/dist/agent/logo.js

@@ -0,0 +1,21 @@
+/**
+ * Terminal block-art mark derived from the website logo
+ * (docs/public/favicon.svg and docs.copperhead.sh): a via with a square
+ * drilled hole and long copper tracks routed out of both sides, copper
+ * #b87333 on dark. (`scripts/gen-logo.mjs` renders the exact favicon
+ * geometry at any size for reference.)
+ */
+import { copper } from './theme.js';
+/** 3-row quadrant-block via with long tracks; rows are equal width. */
+export function fiducialMark() {
+    return [
+        '   ▄▟▙▄  ',
+        ' ███  ███',
+        '   ▀▜▛▀  ',
+    ];
+}
+/** The mark painted in brand copper. */
+export function fiducialLines() {
+    return fiducialMark().map((line) => copper(line));
+}
+//# sourceMappingURL=logo.js.map

package/dist/agent/logo.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"logo.js","sourceRoot":"","sources":["../../src/agent/logo.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAEH,OAAO,EAAE,MAAM,EAAE,MAAM,YAAY,CAAC;AAEpC,uEAAuE;AACvE,MAAM,UAAU,YAAY;IAC1B,OAAO;QACL,WAAW;QACX,WAAW;QACX,WAAW;KACZ,CAAC;AACJ,CAAC;AAED,wCAAwC;AACxC,MAAM,UAAU,aAAa;IAC3B,OAAO,YAAY,EAAE,CAAC,GAAG,CAAC,CAAC,IAAI,EAAE,EAAE,CAAC,MAAM,CAAC,IAAI,CAAC,CAAC,CAAC;AACpD,CAAC"}

package/dist/agent/loop.js

@@ -10,6 +10,7 @@ import { loadConfig, CONFIG_DIR } from '../config.js';
 import { Transcript } from './transcript.js';
 import { collectRunMeta, renderCliHeader } from './runmeta.js';
 import { plainRenderer, fmtDuration, fmtTokens } from './render.js';
+import { styleHeaderLines } from './theme.js';
 import { ObligationsLedger } from './ledger.js';
 import { gitPreflight, isDirty, snapshot, restore, commitAll, changedFiles, preserveFailedRun } from '../util/git.js';
 import { withRetry, isRateLimit, sessionLimit } from '../util/retry.js';
@@ -19,6 +20,7 @@ import { OpenAIProvider } from './providers/openai.js';
 import { AnthropicProvider } from './providers/anthropic.js';
 import { CodexProvider } from './providers/codex.js';
 import { ClaudeCodeProvider } from './providers/claude-code.js';
+import { CursorProvider } from './providers/cursor.js';
 import { openSynapMemory } from '../memory/synap.js';
 export async function makeProvider(model, sessionResume = false) {
     if (model === 'codex' || model.startsWith('codex:')) {
@@ -46,6 +48,14 @@ export async function makeProvider(model, sessionResume = false) {
         }
         return new ClaudeCodeProvider(claudeCodeModel, undefined, undefined, sessionResume);
     }
+    // Saved-login Cursor Agent CLI (`agent login`). Matched as its own namespace.
+    if (model === 'cursor' || model.startsWith('cursor:')) {
+        const cursorModel = model.startsWith('cursor:') ? model.slice('cursor:'.length) : undefined;
+        if (cursorModel === '') {
+            throw new Error('cursor model override cannot be empty; use "cursor" or "cursor:<model-id>"');
+        }
+        return new CursorProvider(cursorModel, undefined, sessionResume);
+    }
     if (model === 'claude' || model.startsWith('claude')) {
         return new AnthropicProvider(model === 'claude' ? undefined : model);
     }
@@ -53,7 +63,7 @@ export async function makeProvider(model, sessionResume = false) {
 }
 function otherProvider(current) {
     // Only the two keyed providers fail over to each other. A rate-limited
-    // 'claude-code' run returns null here (no silent fallback to a paid API).
+    // 'claude-code' or 'cursor' run returns null here (no silent fallback to a paid API).
     if (current.name === 'openai' && process.env.ANTHROPIC_API_KEY)
         return new AnthropicProvider();
     if (current.name === 'anthropic' && process.env.OPENAI_API_KEY)
@@ -141,9 +151,9 @@ async function runWithMemory(opts, memory, providers) {
         repairCycles: 0,
         finishRequest: null,
     };
-    // Session resume for claude-code (1.1) is only correct when the response cache
-    // is off: the cache replays turns a resumed session never saw. So enable it
-    // only when the env flag is set AND config.llmCache is disabled — the same
+    // Session resume for claude-code / cursor is only correct when the response
+    // cache is off: the cache replays turns a resumed session never saw. So enable
+    // it only when the env flag is set AND config.llmCache is disabled — the same
     // condition under which we skip the CachingProvider wrap below.
     const sessionResume = process.env.COPPERHEAD_CC_SESSION_RESUME === '1' && !config.llmCache;
     let provider = opts.provider ?? (await makeProvider(opts.model, sessionResume));
@@ -173,7 +183,7 @@ async function runWithMemory(opts, memory, providers) {
         interactive: opts.interactive ?? false,
         input: opts.meta,
     });
-    for (const line of renderCliHeader(meta))
+    for (const line of styleHeaderLines(renderCliHeader(meta)))
         log(line);
     // Revisit obligations deferred while their artifact didn't exist re-open now
     // if it does (must run before loadConstraints so the prompt sees the updated