@cluesmith/codev 2.0.0-rc.3 → 2.0.0-rc.33

package/dist/terminal/pty-session.js

@@ -0,0 +1,215 @@
+/**
+ * Single PTY session: wraps node-pty with ring buffer, disk logging,
+ * WebSocket broadcast, and reconnection support.
+ */
+import fs from 'node:fs';
+import path from 'node:path';
+import { EventEmitter } from 'node:events';
+import { RingBuffer } from './ring-buffer.js';
+export class PtySession extends EventEmitter {
+    config;
+    id;
+    label;
+    createdAt;
+    ringBuffer;
+    pty = null;
+    cols;
+    rows;
+    exitCode;
+    logFd = null;
+    logBytes = 0;
+    logPath;
+    diskLogEnabled;
+    diskLogMaxBytes;
+    reconnectTimeoutMs;
+    disconnectTimer = null;
+    clients = new Set();
+    constructor(config) {
+        super();
+        this.config = config;
+        this.id = config.id;
+        this.label = config.label;
+        this.cols = config.cols;
+        this.rows = config.rows;
+        this.createdAt = new Date().toISOString();
+        this.ringBuffer = new RingBuffer(config.ringBufferLines ?? 1000);
+        this.diskLogEnabled = config.diskLogEnabled ?? true;
+        this.diskLogMaxBytes = config.diskLogMaxBytes ?? 50 * 1024 * 1024;
+        this.reconnectTimeoutMs = config.reconnectTimeoutMs ?? 300_000;
+        this.logPath = path.join(config.logDir, `${config.id}.log`);
+    }
+    /** Spawn the PTY process. Must be called after construction. */
+    async spawn() {
+        // Dynamic import to avoid hard dependency at module level
+        const nodePty = await import('node-pty');
+        // Ensure log directory exists
+        if (this.diskLogEnabled) {
+            fs.mkdirSync(path.dirname(this.logPath), { recursive: true });
+            this.logFd = fs.openSync(this.logPath, 'a');
+        }
+        this.pty = nodePty.spawn(this.config.command, this.config.args, {
+            name: 'xterm-256color',
+            cols: this.cols,
+            rows: this.rows,
+            cwd: this.config.cwd,
+            env: this.config.env,
+        });
+        this.pty.onData((data) => {
+            this.onPtyData(data);
+        });
+        this.pty.onExit(({ exitCode }) => {
+            this.exitCode = exitCode;
+            this.emit('exit', exitCode);
+            this.cleanup();
+        });
+    }
+    onPtyData(data) {
+        // Store in ring buffer
+        this.ringBuffer.pushData(data);
+        // Write to disk log
+        if (this.diskLogEnabled && this.logFd !== null) {
+            const buf = Buffer.from(data, 'utf-8');
+            if (this.logBytes + buf.length <= this.diskLogMaxBytes) {
+                fs.writeSync(this.logFd, buf);
+                this.logBytes += buf.length;
+            }
+            else {
+                this.rotateDiskLog();
+                fs.writeSync(this.logFd, buf);
+                this.logBytes = buf.length;
+            }
+        }
+        // Broadcast to all connected WebSocket clients
+        for (const client of this.clients) {
+            try {
+                client.send(data);
+            }
+            catch {
+                this.clients.delete(client);
+            }
+        }
+        this.emit('data', data);
+    }
+    rotateDiskLog() {
+        if (this.logFd !== null) {
+            fs.closeSync(this.logFd);
+        }
+        const rotatedPath = this.logPath + '.1';
+        // Remove old rotation if exists
+        try {
+            fs.unlinkSync(rotatedPath + '.1');
+        }
+        catch { /* ignore */ }
+        try {
+            fs.renameSync(rotatedPath, rotatedPath + '.1');
+        }
+        catch { /* ignore */ }
+        try {
+            fs.renameSync(this.logPath, rotatedPath);
+        }
+        catch { /* ignore */ }
+        this.logFd = fs.openSync(this.logPath, 'a');
+        this.logBytes = 0;
+    }
+    /** Write user input to the PTY. */
+    write(data) {
+        if (this.pty && this.status === 'running') {
+            this.pty.write(data);
+        }
+    }
+    /** Resize the PTY. */
+    resize(cols, rows) {
+        this.cols = cols;
+        this.rows = rows;
+        if (this.pty && this.status === 'running') {
+            this.pty.resize(cols, rows);
+        }
+    }
+    /** Kill the PTY process. */
+    kill() {
+        if (this.pty && this.status === 'running') {
+            try {
+                // Kill process group to prevent orphans
+                process.kill(-this.pty.pid, 'SIGTERM');
+                setTimeout(() => {
+                    try {
+                        process.kill(-this.pty.pid, 'SIGKILL');
+                    }
+                    catch { /* already dead */ }
+                }, 5000);
+            }
+            catch {
+                // Process already exited
+            }
+        }
+        this.cleanup();
+    }
+    /** Attach a WebSocket client. Returns ring buffer contents for replay. */
+    attach(client) {
+        this.clients.add(client);
+        if (this.disconnectTimer) {
+            clearTimeout(this.disconnectTimer);
+            this.disconnectTimer = null;
+        }
+        return this.ringBuffer.getAll();
+    }
+    /** Attach with resume from a specific sequence number. */
+    attachResume(client, sinceSeq) {
+        this.clients.add(client);
+        if (this.disconnectTimer) {
+            clearTimeout(this.disconnectTimer);
+            this.disconnectTimer = null;
+        }
+        return this.ringBuffer.getSince(sinceSeq);
+    }
+    /** Detach a WebSocket client. Starts disconnect timer if no clients remain. */
+    detach(client) {
+        this.clients.delete(client);
+        if (this.clients.size === 0 && this.status === 'running') {
+            this.disconnectTimer = setTimeout(() => {
+                this.emit('timeout');
+                this.kill();
+            }, this.reconnectTimeoutMs);
+        }
+    }
+    get status() {
+        return this.exitCode === undefined ? 'running' : 'exited';
+    }
+    get pid() {
+        return this.pty?.pid ?? -1;
+    }
+    get info() {
+        return {
+            id: this.id,
+            pid: this.pid,
+            cols: this.cols,
+            rows: this.rows,
+            label: this.label,
+            status: this.status,
+            createdAt: this.createdAt,
+            exitCode: this.exitCode,
+        };
+    }
+    get clientCount() {
+        return this.clients.size;
+    }
+    cleanup() {
+        if (this.disconnectTimer) {
+            clearTimeout(this.disconnectTimer);
+            this.disconnectTimer = null;
+        }
+        // Release all WebSocket clients
+        this.clients.clear();
+        // Release ring buffer memory
+        this.ringBuffer.clear();
+        // Close disk log handle
+        if (this.logFd !== null) {
+            try {
+                fs.closeSync(this.logFd);
+            }
+            catch { /* ignore */ }
+            this.logFd = null;
+        }
+    }
+}
+//# sourceMappingURL=pty-session.js.map

package/dist/terminal/pty-session.js.map

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

package/dist/terminal/ring-buffer.d.ts

@@ -0,0 +1,27 @@
+/**
+ * Fixed-size circular buffer for storing terminal output lines.
+ * Used for reconnection replay — stores last N lines in memory.
+ */
+export declare class RingBuffer {
+    private readonly capacity;
+    private buffer;
+    private head;
+    private count;
+    private seq;
+    constructor(capacity?: number);
+    /** Push a line into the buffer. Returns the assigned sequence number. */
+    push(line: string): number;
+    /** Push raw data, splitting on newlines. Returns last sequence number. */
+    pushData(data: string): number;
+    /** Get all stored lines in order. */
+    getAll(): string[];
+    /** Get lines starting from a given sequence number (for resume). */
+    getSince(sinceSeq: number): string[];
+    /** Current sequence number (last written). */
+    get currentSeq(): number;
+    /** Number of lines currently stored. */
+    get size(): number;
+    /** Clear the buffer and release memory. */
+    clear(): void;
+}
+//# sourceMappingURL=ring-buffer.d.ts.map

package/dist/terminal/ring-buffer.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"ring-buffer.d.ts","sourceRoot":"","sources":["../../src/terminal/ring-buffer.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAEH,qBAAa,UAAU;IAMT,OAAO,CAAC,QAAQ,CAAC,QAAQ;IALrC,OAAO,CAAC,MAAM,CAAW;IACzB,OAAO,CAAC,IAAI,CAAa;IACzB,OAAO,CAAC,KAAK,CAAa;IAC1B,OAAO,CAAC,GAAG,CAAa;gBAEK,QAAQ,GAAE,MAAa;IAIpD,yEAAyE;IACzE,IAAI,CAAC,IAAI,EAAE,MAAM,GAAG,MAAM;IAW1B,0EAA0E;IAC1E,QAAQ,CAAC,IAAI,EAAE,MAAM,GAAG,MAAM;IAS9B,qCAAqC;IACrC,MAAM,IAAI,MAAM,EAAE;IAQlB,oEAAoE;IACpE,QAAQ,CAAC,QAAQ,EAAE,MAAM,GAAG,MAAM,EAAE;IAcpC,8CAA8C;IAC9C,IAAI,UAAU,IAAI,MAAM,CAEvB;IAED,wCAAwC;IACxC,IAAI,IAAI,IAAI,MAAM,CAEjB;IAED,2CAA2C;IAC3C,KAAK,IAAI,IAAI;CAMd"}

package/dist/terminal/ring-buffer.js

@@ -0,0 +1,74 @@
+/**
+ * Fixed-size circular buffer for storing terminal output lines.
+ * Used for reconnection replay — stores last N lines in memory.
+ */
+export class RingBuffer {
+    capacity;
+    buffer;
+    head = 0;
+    count = 0;
+    seq = 0; // monotonically increasing sequence number
+    constructor(capacity = 1000) {
+        this.capacity = capacity;
+        this.buffer = new Array(capacity);
+    }
+    /** Push a line into the buffer. Returns the assigned sequence number. */
+    push(line) {
+        const index = (this.head + this.count) % this.capacity;
+        this.buffer[index] = line;
+        if (this.count < this.capacity) {
+            this.count++;
+        }
+        else {
+            this.head = (this.head + 1) % this.capacity;
+        }
+        return ++this.seq;
+    }
+    /** Push raw data, splitting on newlines. Returns last sequence number. */
+    pushData(data) {
+        const lines = data.split('\n');
+        let lastSeq = this.seq;
+        for (const line of lines) {
+            lastSeq = this.push(line);
+        }
+        return lastSeq;
+    }
+    /** Get all stored lines in order. */
+    getAll() {
+        const result = [];
+        for (let i = 0; i < this.count; i++) {
+            result.push(this.buffer[(this.head + i) % this.capacity]);
+        }
+        return result;
+    }
+    /** Get lines starting from a given sequence number (for resume). */
+    getSince(sinceSeq) {
+        const linesAvailable = this.count;
+        const oldestSeq = this.seq - linesAvailable + 1;
+        const startSeq = Math.max(sinceSeq + 1, oldestSeq);
+        if (startSeq > this.seq)
+            return [];
+        const skip = startSeq - oldestSeq;
+        const result = [];
+        for (let i = skip; i < this.count; i++) {
+            result.push(this.buffer[(this.head + i) % this.capacity]);
+        }
+        return result;
+    }
+    /** Current sequence number (last written). */
+    get currentSeq() {
+        return this.seq;
+    }
+    /** Number of lines currently stored. */
+    get size() {
+        return this.count;
+    }
+    /** Clear the buffer and release memory. */
+    clear() {
+        this.buffer = [];
+        this.head = 0;
+        this.count = 0;
+        // Don't reset seq — it should be monotonic
+    }
+}
+//# sourceMappingURL=ring-buffer.js.map

package/dist/terminal/ring-buffer.js.map

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

package/dist/terminal/ws-protocol.d.ts

@@ -0,0 +1,27 @@
+/**
+ * WebSocket frame encoding/decoding for terminal communication.
+ *
+ * Hybrid protocol:
+ * - 0x00 prefix: Control frame (remainder is UTF-8 JSON)
+ * - 0x01 prefix: Data frame (remainder is raw PTY bytes)
+ */
+export declare const FRAME_CONTROL = 0;
+export declare const FRAME_DATA = 1;
+export interface ControlMessage {
+    type: 'resize' | 'ping' | 'pong' | 'pause' | 'resume' | 'error';
+    payload: Record<string, unknown>;
+}
+/** Encode a control message into a binary frame. */
+export declare function encodeControl(msg: ControlMessage): Buffer;
+/** Encode raw PTY data into a binary frame. */
+export declare function encodeData(data: Buffer | string): Buffer;
+export type DecodedFrame = {
+    type: 'control';
+    message: ControlMessage;
+} | {
+    type: 'data';
+    data: Buffer;
+};
+/** Decode a received WebSocket frame. */
+export declare function decodeFrame(frame: Buffer): DecodedFrame;
+//# sourceMappingURL=ws-protocol.d.ts.map

package/dist/terminal/ws-protocol.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"ws-protocol.d.ts","sourceRoot":"","sources":["../../src/terminal/ws-protocol.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAEH,eAAO,MAAM,aAAa,IAAO,CAAC;AAClC,eAAO,MAAM,UAAU,IAAO,CAAC;AAE/B,MAAM,WAAW,cAAc;IAC7B,IAAI,EAAE,QAAQ,GAAG,MAAM,GAAG,MAAM,GAAG,OAAO,GAAG,QAAQ,GAAG,OAAO,CAAC;IAChE,OAAO,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;CAClC;AAED,oDAAoD;AACpD,wBAAgB,aAAa,CAAC,GAAG,EAAE,cAAc,GAAG,MAAM,CAOzD;AAED,+CAA+C;AAC/C,wBAAgB,UAAU,CAAC,IAAI,EAAE,MAAM,GAAG,MAAM,GAAG,MAAM,CAMxD;AAED,MAAM,MAAM,YAAY,GACpB;IAAE,IAAI,EAAE,SAAS,CAAC;IAAC,OAAO,EAAE,cAAc,CAAA;CAAE,GAC5C;IAAE,IAAI,EAAE,MAAM,CAAC;IAAC,IAAI,EAAE,MAAM,CAAA;CAAE,CAAC;AAEnC,yCAAyC;AACzC,wBAAgB,WAAW,CAAC,KAAK,EAAE,MAAM,GAAG,YAAY,CAmBvD"}

package/dist/terminal/ws-protocol.js

@@ -0,0 +1,44 @@
+/**
+ * WebSocket frame encoding/decoding for terminal communication.
+ *
+ * Hybrid protocol:
+ * - 0x00 prefix: Control frame (remainder is UTF-8 JSON)
+ * - 0x01 prefix: Data frame (remainder is raw PTY bytes)
+ */
+export const FRAME_CONTROL = 0x00;
+export const FRAME_DATA = 0x01;
+/** Encode a control message into a binary frame. */
+export function encodeControl(msg) {
+    const json = JSON.stringify(msg);
+    const jsonBuf = Buffer.from(json, 'utf-8');
+    const frame = Buffer.allocUnsafe(1 + jsonBuf.length);
+    frame[0] = FRAME_CONTROL;
+    jsonBuf.copy(frame, 1);
+    return frame;
+}
+/** Encode raw PTY data into a binary frame. */
+export function encodeData(data) {
+    const dataBuf = typeof data === 'string' ? Buffer.from(data, 'utf-8') : data;
+    const frame = Buffer.allocUnsafe(1 + dataBuf.length);
+    frame[0] = FRAME_DATA;
+    dataBuf.copy(frame, 1);
+    return frame;
+}
+/** Decode a received WebSocket frame. */
+export function decodeFrame(frame) {
+    if (frame.length === 0) {
+        throw new Error('Empty frame');
+    }
+    const prefix = frame[0];
+    const payload = frame.subarray(1);
+    if (prefix === FRAME_CONTROL) {
+        const json = payload.toString('utf-8');
+        const message = JSON.parse(json);
+        return { type: 'control', message };
+    }
+    if (prefix === FRAME_DATA) {
+        return { type: 'data', data: payload };
+    }
+    throw new Error(`Unknown frame prefix: 0x${prefix.toString(16)}`);
+}
+//# sourceMappingURL=ws-protocol.js.map

package/dist/terminal/ws-protocol.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"ws-protocol.js","sourceRoot":"","sources":["../../src/terminal/ws-protocol.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAEH,MAAM,CAAC,MAAM,aAAa,GAAG,IAAI,CAAC;AAClC,MAAM,CAAC,MAAM,UAAU,GAAG,IAAI,CAAC;AAO/B,oDAAoD;AACpD,MAAM,UAAU,aAAa,CAAC,GAAmB;IAC/C,MAAM,IAAI,GAAG,IAAI,CAAC,SAAS,CAAC,GAAG,CAAC,CAAC;IACjC,MAAM,OAAO,GAAG,MAAM,CAAC,IAAI,CAAC,IAAI,EAAE,OAAO,CAAC,CAAC;IAC3C,MAAM,KAAK,GAAG,MAAM,CAAC,WAAW,CAAC,CAAC,GAAG,OAAO,CAAC,MAAM,CAAC,CAAC;IACrD,KAAK,CAAC,CAAC,CAAC,GAAG,aAAa,CAAC;IACzB,OAAO,CAAC,IAAI,CAAC,KAAK,EAAE,CAAC,CAAC,CAAC;IACvB,OAAO,KAAK,CAAC;AACf,CAAC;AAED,+CAA+C;AAC/C,MAAM,UAAU,UAAU,CAAC,IAAqB;IAC9C,MAAM,OAAO,GAAG,OAAO,IAAI,KAAK,QAAQ,CAAC,CAAC,CAAC,MAAM,CAAC,IAAI,CAAC,IAAI,EAAE,OAAO,CAAC,CAAC,CAAC,CAAC,IAAI,CAAC;IAC7E,MAAM,KAAK,GAAG,MAAM,CAAC,WAAW,CAAC,CAAC,GAAG,OAAO,CAAC,MAAM,CAAC,CAAC;IACrD,KAAK,CAAC,CAAC,CAAC,GAAG,UAAU,CAAC;IACtB,OAAO,CAAC,IAAI,CAAC,KAAK,EAAE,CAAC,CAAC,CAAC;IACvB,OAAO,KAAK,CAAC;AACf,CAAC;AAMD,yCAAyC;AACzC,MAAM,UAAU,WAAW,CAAC,KAAa;IACvC,IAAI,KAAK,CAAC,MAAM,KAAK,CAAC,EAAE,CAAC;QACvB,MAAM,IAAI,KAAK,CAAC,aAAa,CAAC,CAAC;IACjC,CAAC;IAED,MAAM,MAAM,GAAG,KAAK,CAAC,CAAC,CAAC,CAAC;IACxB,MAAM,OAAO,GAAG,KAAK,CAAC,QAAQ,CAAC,CAAC,CAAC,CAAC;IAElC,IAAI,MAAM,KAAK,aAAa,EAAE,CAAC;QAC7B,MAAM,IAAI,GAAG,OAAO,CAAC,QAAQ,CAAC,OAAO,CAAC,CAAC;QACvC,MAAM,OAAO,GAAG,IAAI,CAAC,KAAK,CAAC,IAAI,CAAmB,CAAC;QACnD,OAAO,EAAE,IAAI,EAAE,SAAS,EAAE,OAAO,EAAE,CAAC;IACtC,CAAC;IAED,IAAI,MAAM,KAAK,UAAU,EAAE,CAAC;QAC1B,OAAO,EAAE,IAAI,EAAE,MAAM,EAAE,IAAI,EAAE,OAAO,EAAE,CAAC;IACzC,CAAC;IAED,MAAM,IAAI,KAAK,CAAC,2BAA2B,MAAM,CAAC,QAAQ,CAAC,EAAE,CAAC,EAAE,CAAC,CAAC;AACpE,CAAC"}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@cluesmith/codev",
-  "version": "2.0.0-rc.3",
+  "version": "2.0.0-rc.33",
   "description": "Codev CLI - AI-assisted software development framework",
   "type": "module",
   "bin": {
@@ -14,32 +14,47 @@
     "dist",
     "bin",
     "skeleton",
-    "templates"
+    "templates",
+    "dashboard/dist"
   ],
   "scripts": {
-    "build": "tsc && npm run copy-skeleton",
+    "clean": "rm -rf dist",
+    "build": "npm run clean && tsc && npm run build:dashboard && npm run copy-skeleton",
+    "build:dashboard": "cd dashboard && npm install && npm run build",
+    "dev:dashboard": "cd dashboard && npm run dev",
     "copy-skeleton": "rm -rf skeleton && cp -r ../../codev-skeleton skeleton",
     "dev": "tsx src/cli.ts",
     "start": "node dist/cli.js",
     "test": "vitest",
+    "test:e2e": "vitest run --config vitest.e2e.config.ts",
+    "test:e2e:watch": "vitest --config vitest.e2e.config.ts",
+    "postinstall": "node -e \"try{require('fs').chmodSync(require('path').join(require.resolve('node-pty'),'..','..','prebuilds',process.platform+'-'+process.arch,'spawn-helper'),0o755)}catch{}\"",
     "prepublishOnly": "npm run build"
   },
   "dependencies": {
+    "@anthropic-ai/claude-agent-sdk": "^0.2.25",
     "@google/genai": "^1.0.0",
     "better-sqlite3": "^12.5.0",
     "chalk": "^5.3.0",
     "commander": "^12.1.0",
     "glob": "^11.0.0",
     "http-proxy": "^1.18.1",
+    "js-yaml": "^4.1.0",
+    "node-pty": "^1.1.0",
     "open": "^10.1.0",
+    "qrcode-terminal": "^0.12.0",
     "tree-kill": "^1.2.2",
     "ws": "^8.18.0"
   },
   "devDependencies": {
+    "@playwright/test": "^1.58.0",
     "@types/better-sqlite3": "^7.6.13",
     "@types/http-proxy": "^1.17.17",
+    "@types/js-yaml": "^4.0.9",
     "@types/node": "^22.10.1",
+    "@types/qrcode-terminal": "^0.12.2",
     "@types/ws": "^8.18.1",
+    "playwright": "^1.58.0",
     "tsx": "^4.19.2",
     "typescript": "^5.7.2",
     "vitest": "^4.0.15"

package/skeleton/DEPENDENCIES.md

@@ -57,29 +57,6 @@ sudo apt install tmux
 tmux -V  # Should show tmux 3.x or higher
 ```
 
-### ttyd
-
-| Requirement | Value |
-|-------------|-------|
-| Minimum Version | 1.7.0 |
-| Purpose | Web-based terminal for dashboard access |
-
-**Installation:**
-
-```bash
-# macOS
-brew install ttyd
-
-# Ubuntu/Debian (build from source)
-sudo apt install build-essential cmake git libjson-c-dev libwebsockets-dev
-git clone https://github.com/tsl0922/ttyd.git
-cd ttyd && mkdir build && cd build
-cmake .. && make && sudo make install
-
-# Verify
-ttyd --version  # Should show 1.7.x or higher
-```
-
 ### git
 
 | Requirement | Value |
@@ -193,7 +170,6 @@ codex --version
 |------------|-----------------|-----------|
 | Node.js | 18.0.0 | Yes |
 | tmux | 3.0 | Yes |
-| ttyd | 1.7.0 | Yes |
 | git | 2.5.0 | Yes |
 | gh | latest | Yes |
 | Claude Code | latest | At least one AI CLI |
@@ -210,7 +186,7 @@ All dependencies are available via Homebrew:
 
 ```bash
 # Install all core dependencies at once
-brew install node tmux ttyd gh
+brew install node tmux gh
 
 # Git is included with Xcode command line tools
 xcode-select --install
@@ -218,15 +194,13 @@ xcode-select --install
 
 ### Ubuntu/Debian
 
-Most dependencies are available via apt, except ttyd which must be built from source:
+Most dependencies are available via apt:
 
 ```bash
 # Core dependencies
 sudo apt install nodejs npm tmux git
 
 # gh requires adding GitHub's apt repository (see above)
-
-# ttyd must be built from source (see above)
 ```
 
 ### Windows
@@ -267,7 +241,7 @@ sudo apt update
 sudo apt install tmux
 ```
 
-### ttyd connection issues
+### Terminal connection issues
 
 Ensure no firewall is blocking the ports (default: 4200-4299):
 

package/skeleton/builders.md

@@ -4,7 +4,7 @@ Track active builder agents here. Update manually or via `architect status`.
 
 ## Status Values
 
-- **spawning**: Worktree being created, ttyd starting
+- **spawning**: Worktree being created, terminal starting
 - **implementing**: Builder is working
 - **blocked**: Builder waiting for architect input
 - **pr-ready**: Builder has created a PR