@cluesmith/codev 2.0.0-rc.69 → 2.0.0-rc.70

package/dist/terminal/shepherd-process.js

@@ -0,0 +1,279 @@
+/**
+ * ShepherdProcess: the testable core logic of the shepherd daemon.
+ *
+ * Owns a single PTY via the IShepherdPty interface (injected for testability).
+ * Listens on a Unix socket for a single Tower connection. Handles the binary
+ * wire protocol: HELLO/WELCOME handshake, DATA forwarding, RESIZE, SIGNAL,
+ * SPAWN, PING/PONG, and EXIT lifecycle.
+ *
+ * The shepherd accepts only one Tower connection at a time. A new connection
+ * replaces the old one (handles rapid Tower restarts cleanly).
+ */
+import fs from 'node:fs';
+import net from 'node:net';
+import { EventEmitter } from 'node:events';
+import { FrameType, PROTOCOL_VERSION, ALLOWED_SIGNALS, createFrameParser, encodeData, encodeWelcome, encodeExit, encodeReplay, encodePong, parseJsonPayload, isKnownFrameType, } from './shepherd-protocol.js';
+import { ShepherdReplayBuffer } from './shepherd-replay-buffer.js';
+// --- ShepherdProcess ---
+export class ShepherdProcess extends EventEmitter {
+    ptyFactory;
+    socketPath;
+    pty = null;
+    server = null;
+    currentConnection = null;
+    replayBuffer;
+    cols = 80;
+    rows = 24;
+    startTime = Date.now();
+    exited = false;
+    constructor(ptyFactory, socketPath, replayBufferLines = 10_000) {
+        super();
+        this.ptyFactory = ptyFactory;
+        this.socketPath = socketPath;
+        this.replayBuffer = new ShepherdReplayBuffer(replayBufferLines);
+    }
+    /**
+     * Start the shepherd: spawn the PTY and begin listening on the Unix socket.
+     */
+    async start(command, args, cwd, env, cols, rows) {
+        this.cols = cols;
+        this.rows = rows;
+        this.startTime = Date.now();
+        this.spawnPty(command, args, cwd, env, cols, rows);
+        await this.listen();
+    }
+    spawnPty(command, args, cwd, env, cols, rows) {
+        this.exited = false;
+        const pty = this.ptyFactory();
+        this.pty = pty;
+        pty.spawn(command, args, {
+            name: 'xterm-256color',
+            cols,
+            rows,
+            cwd,
+            env,
+        });
+        pty.onData((data) => {
+            // Guard: ignore data from a replaced PTY (after SPAWN)
+            if (this.pty !== pty)
+                return;
+            const buf = Buffer.from(data, 'utf-8');
+            this.replayBuffer.append(buf);
+            if (this.currentConnection && !this.currentConnection.destroyed) {
+                this.currentConnection.write(encodeData(buf));
+            }
+        });
+        pty.onExit((exitInfo) => {
+            // Guard: ignore exit from a replaced PTY (after SPAWN).
+            // Without this, the old PTY's exit would set this.exited = true
+            // and send an EXIT frame, corrupting the state of the new PTY.
+            if (this.pty !== pty)
+                return;
+            this.exited = true;
+            const exitFrame = encodeExit({
+                code: exitInfo.exitCode,
+                signal: exitInfo.signal != null ? String(exitInfo.signal) : null,
+            });
+            if (this.currentConnection && !this.currentConnection.destroyed) {
+                this.currentConnection.write(exitFrame);
+            }
+            this.emit('exit', exitInfo);
+        });
+    }
+    listen() {
+        return new Promise((resolve, reject) => {
+            this.server = net.createServer((socket) => {
+                this.handleConnection(socket);
+            });
+            this.server.on('error', (err) => {
+                this.emit('error', err);
+                reject(err);
+            });
+            this.server.listen(this.socketPath, () => {
+                // Enforce 0600 permissions on socket file (owner-only access).
+                // Unix sockets inherit permissions from umask; we override after creation.
+                try {
+                    fs.chmodSync(this.socketPath, 0o600);
+                }
+                catch {
+                    // Non-fatal: socket still works, just with default permissions
+                }
+                resolve();
+            });
+        });
+    }
+    /**
+     * Handle an incoming Tower connection. Only one connection is active at a
+     * time — a new connection closes the previous one.
+     */
+    handleConnection(socket) {
+        // Close previous connection if any
+        if (this.currentConnection && !this.currentConnection.destroyed) {
+            this.currentConnection.destroy();
+        }
+        this.currentConnection = socket;
+        const parser = createFrameParser();
+        socket.pipe(parser);
+        parser.on('data', (frame) => {
+            this.handleFrame(socket, frame);
+        });
+        parser.on('error', (err) => {
+            this.emit('protocol-error', err);
+            socket.destroy();
+        });
+        socket.on('close', () => {
+            if (this.currentConnection === socket) {
+                this.currentConnection = null;
+            }
+        });
+        socket.on('error', () => {
+            if (this.currentConnection === socket) {
+                this.currentConnection = null;
+            }
+        });
+    }
+    handleFrame(socket, frame) {
+        if (!isKnownFrameType(frame.type)) {
+            // Unknown frame types are silently ignored (forward compatibility)
+            return;
+        }
+        switch (frame.type) {
+            case FrameType.HELLO:
+                this.handleHello(socket, frame.payload);
+                break;
+            case FrameType.DATA:
+                this.handleData(frame.payload);
+                break;
+            case FrameType.RESIZE:
+                this.handleResize(socket, frame.payload);
+                break;
+            case FrameType.SIGNAL:
+                this.handleSignal(socket, frame.payload);
+                break;
+            case FrameType.SPAWN:
+                this.handleSpawn(socket, frame.payload);
+                break;
+            case FrameType.PING:
+                socket.write(encodePong());
+                break;
+            case FrameType.PONG:
+                // No-op: keepalive acknowledgement
+                break;
+            // Shepherd doesn't expect REPLAY, EXIT, WELCOME from Tower
+            default:
+                break;
+        }
+    }
+    handleHello(socket, payload) {
+        try {
+            const hello = parseJsonPayload(payload);
+            this.emit('hello', hello);
+        }
+        catch {
+            this.emit('protocol-error', new Error('Invalid HELLO payload'));
+            socket.destroy();
+            return;
+        }
+        // Send WELCOME response
+        const welcome = encodeWelcome({
+            version: PROTOCOL_VERSION,
+            pid: this.pty?.pid ?? -1,
+            cols: this.cols,
+            rows: this.rows,
+            startTime: this.startTime,
+        });
+        socket.write(welcome);
+        // Send replay buffer
+        const replayData = this.replayBuffer.getReplayData();
+        if (replayData.length > 0) {
+            socket.write(encodeReplay(replayData));
+        }
+    }
+    handleData(payload) {
+        if (this.pty && !this.exited) {
+            this.pty.write(payload.toString('utf-8'));
+        }
+    }
+    handleResize(socket, payload) {
+        try {
+            const msg = parseJsonPayload(payload);
+            this.cols = msg.cols;
+            this.rows = msg.rows;
+            if (this.pty && !this.exited) {
+                this.pty.resize(msg.cols, msg.rows);
+            }
+        }
+        catch {
+            this.emit('protocol-error', new Error('Invalid RESIZE payload'));
+            socket.destroy();
+        }
+    }
+    handleSignal(socket, payload) {
+        try {
+            const msg = parseJsonPayload(payload);
+            if (!ALLOWED_SIGNALS.has(msg.signal)) {
+                this.emit('protocol-error', new Error(`Signal ${msg.signal} not in allowlist`));
+                return;
+            }
+            if (this.pty && !this.exited) {
+                this.pty.kill(msg.signal);
+            }
+        }
+        catch {
+            this.emit('protocol-error', new Error('Invalid SIGNAL payload'));
+            socket.destroy();
+        }
+    }
+    handleSpawn(socket, payload) {
+        try {
+            const msg = parseJsonPayload(payload);
+            // Kill old PTY if still alive
+            if (this.pty && !this.exited) {
+                this.pty.kill(15); // SIGTERM
+            }
+            // Clear replay buffer for fresh session
+            this.replayBuffer.clear();
+            // Spawn new PTY
+            this.spawnPty(msg.command, msg.args, msg.cwd, msg.env, this.cols, this.rows);
+            this.emit('spawn', msg);
+        }
+        catch {
+            this.emit('protocol-error', new Error('Invalid SPAWN payload'));
+            socket.destroy();
+        }
+    }
+    /** Get the current replay buffer data. */
+    getReplayData() {
+        return this.replayBuffer.getReplayData();
+    }
+    /** Get the process start time (epoch ms). */
+    getStartTime() {
+        return this.startTime;
+    }
+    /** Get the current PTY PID. */
+    getPid() {
+        return this.pty?.pid ?? -1;
+    }
+    /** Whether the child process has exited. */
+    get hasExited() {
+        return this.exited;
+    }
+    /**
+     * Graceful shutdown: kill child process, close socket server, clean up.
+     */
+    shutdown() {
+        if (this.pty && !this.exited) {
+            this.pty.kill(15); // SIGTERM
+        }
+        if (this.currentConnection && !this.currentConnection.destroyed) {
+            this.currentConnection.destroy();
+        }
+        this.currentConnection = null;
+        if (this.server) {
+            this.server.close();
+            this.server = null;
+        }
+        this.emit('shutdown');
+    }
+}
+//# sourceMappingURL=shepherd-process.js.map

package/dist/terminal/shepherd-process.js.map

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

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

@@ -0,0 +1,115 @@
+/**
+ * Shepherd wire protocol: binary frame encoding/decoding for Unix socket
+ * communication between Tower and shepherd processes.
+ *
+ * Frame format: [1-byte type] [4-byte big-endian length] [payload]
+ *
+ * This module is imported by both the shepherd process (standalone) and
+ * Tower (within the main package). It has NO dependencies beyond Node.js
+ * built-ins to keep the shepherd process lightweight.
+ */
+import { Transform, type TransformCallback } from 'node:stream';
+export declare const FrameType: {
+    readonly DATA: 1;
+    readonly RESIZE: 2;
+    readonly SIGNAL: 3;
+    readonly EXIT: 4;
+    readonly REPLAY: 5;
+    readonly PING: 6;
+    readonly PONG: 7;
+    readonly HELLO: 8;
+    readonly WELCOME: 9;
+    readonly SPAWN: 10;
+};
+export type FrameTypeValue = (typeof FrameType)[keyof typeof FrameType];
+export declare const PROTOCOL_VERSION = 1;
+export declare const MAX_FRAME_SIZE: number;
+export declare const HEADER_SIZE = 5;
+export declare const ALLOWED_SIGNALS: Set<number>;
+export interface ResizeMessage {
+    cols: number;
+    rows: number;
+}
+export interface SignalMessage {
+    signal: number;
+}
+export interface ExitMessage {
+    code: number | null;
+    signal: string | null;
+}
+export interface HelloMessage {
+    version: number;
+}
+export interface WelcomeMessage {
+    version: number;
+    pid: number;
+    cols: number;
+    rows: number;
+    startTime: number;
+}
+export interface SpawnMessage {
+    command: string;
+    args: string[];
+    cwd: string;
+    env: Record<string, string>;
+}
+/**
+ * Encode a frame with the given type and payload.
+ */
+export declare function encodeFrame(type: FrameTypeValue, payload: Buffer): Buffer;
+/** Encode a DATA frame (raw PTY bytes). */
+export declare function encodeData(data: Buffer | string): Buffer;
+/** Encode a RESIZE frame. */
+export declare function encodeResize(msg: ResizeMessage): Buffer;
+/** Encode a SIGNAL frame. */
+export declare function encodeSignal(msg: SignalMessage): Buffer;
+/** Encode an EXIT frame. */
+export declare function encodeExit(msg: ExitMessage): Buffer;
+/** Encode a REPLAY frame (raw bytes). */
+export declare function encodeReplay(data: Buffer): Buffer;
+/** Encode a PING frame. */
+export declare function encodePing(): Buffer;
+/** Encode a PONG frame. */
+export declare function encodePong(): Buffer;
+/** Encode a HELLO frame. */
+export declare function encodeHello(msg: HelloMessage): Buffer;
+/** Encode a WELCOME frame. */
+export declare function encodeWelcome(msg: WelcomeMessage): Buffer;
+/** Encode a SPAWN frame. */
+export declare function encodeSpawn(msg: SpawnMessage): Buffer;
+export interface ParsedFrame {
+    type: FrameTypeValue | number;
+    payload: Buffer;
+}
+/**
+ * A Transform stream that parses the binary frame protocol.
+ *
+ * Input: raw socket data (may be fragmented across chunks)
+ * Output: ParsedFrame objects (in objectMode)
+ *
+ * Emits 'frame-error' event on protocol violations (oversized frames,
+ * malformed headers). The stream is destroyed on error.
+ */
+export declare class FrameParser extends Transform {
+    private chunks;
+    private bufferedLength;
+    constructor();
+    _transform(chunk: Buffer, _encoding: BufferEncoding, callback: TransformCallback): void;
+    _flush(callback: TransformCallback): void;
+    private drainFrames;
+    private peek;
+    private consume;
+}
+/**
+ * Create a streaming frame parser.
+ * Convenience factory matching the plan's API.
+ */
+export declare function createFrameParser(): FrameParser;
+/** Check if a frame type is a known type. */
+export declare function isKnownFrameType(type: number): type is FrameTypeValue;
+/**
+ * Parse a JSON payload from a control frame.
+ * Throws on invalid JSON.
+ */
+export declare function parseJsonPayload<T>(payload: Buffer): T;
+//# sourceMappingURL=shepherd-protocol.d.ts.map

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

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

package/dist/terminal/shepherd-protocol.js

@@ -0,0 +1,214 @@
+/**
+ * Shepherd wire protocol: binary frame encoding/decoding for Unix socket
+ * communication between Tower and shepherd processes.
+ *
+ * Frame format: [1-byte type] [4-byte big-endian length] [payload]
+ *
+ * This module is imported by both the shepherd process (standalone) and
+ * Tower (within the main package). It has NO dependencies beyond Node.js
+ * built-ins to keep the shepherd process lightweight.
+ */
+import { Transform } from 'node:stream';
+// --- Frame Types ---
+export const FrameType = {
+    DATA: 0x01,
+    RESIZE: 0x02,
+    SIGNAL: 0x03,
+    EXIT: 0x04,
+    REPLAY: 0x05,
+    PING: 0x06,
+    PONG: 0x07,
+    HELLO: 0x08,
+    WELCOME: 0x09,
+    SPAWN: 0x0a,
+};
+// --- Protocol Constants ---
+export const PROTOCOL_VERSION = 1;
+export const MAX_FRAME_SIZE = 16 * 1024 * 1024; // 16MB
+export const HEADER_SIZE = 5; // 1 byte type + 4 bytes length
+// --- Allowed Signals ---
+export const ALLOWED_SIGNALS = new Set([
+    1, // SIGHUP
+    2, // SIGINT
+    9, // SIGKILL
+    15, // SIGTERM
+    28, // SIGWINCH
+]);
+// --- Frame Encoding ---
+/**
+ * Encode a frame with the given type and payload.
+ */
+export function encodeFrame(type, payload) {
+    const frame = Buffer.allocUnsafe(HEADER_SIZE + payload.length);
+    frame[0] = type;
+    frame.writeUInt32BE(payload.length, 1);
+    payload.copy(frame, HEADER_SIZE);
+    return frame;
+}
+/** Encode a DATA frame (raw PTY bytes). */
+export function encodeData(data) {
+    const buf = typeof data === 'string' ? Buffer.from(data, 'utf-8') : data;
+    return encodeFrame(FrameType.DATA, buf);
+}
+/** Encode a RESIZE frame. */
+export function encodeResize(msg) {
+    return encodeFrame(FrameType.RESIZE, Buffer.from(JSON.stringify(msg)));
+}
+/** Encode a SIGNAL frame. */
+export function encodeSignal(msg) {
+    return encodeFrame(FrameType.SIGNAL, Buffer.from(JSON.stringify(msg)));
+}
+/** Encode an EXIT frame. */
+export function encodeExit(msg) {
+    return encodeFrame(FrameType.EXIT, Buffer.from(JSON.stringify(msg)));
+}
+/** Encode a REPLAY frame (raw bytes). */
+export function encodeReplay(data) {
+    return encodeFrame(FrameType.REPLAY, data);
+}
+/** Encode a PING frame. */
+export function encodePing() {
+    return encodeFrame(FrameType.PING, Buffer.alloc(0));
+}
+/** Encode a PONG frame. */
+export function encodePong() {
+    return encodeFrame(FrameType.PONG, Buffer.alloc(0));
+}
+/** Encode a HELLO frame. */
+export function encodeHello(msg) {
+    return encodeFrame(FrameType.HELLO, Buffer.from(JSON.stringify(msg)));
+}
+/** Encode a WELCOME frame. */
+export function encodeWelcome(msg) {
+    return encodeFrame(FrameType.WELCOME, Buffer.from(JSON.stringify(msg)));
+}
+/** Encode a SPAWN frame. */
+export function encodeSpawn(msg) {
+    return encodeFrame(FrameType.SPAWN, Buffer.from(JSON.stringify(msg)));
+}
+// --- Streaming Frame Parser ---
+/**
+ * A Transform stream that parses the binary frame protocol.
+ *
+ * Input: raw socket data (may be fragmented across chunks)
+ * Output: ParsedFrame objects (in objectMode)
+ *
+ * Emits 'frame-error' event on protocol violations (oversized frames,
+ * malformed headers). The stream is destroyed on error.
+ */
+export class FrameParser extends Transform {
+    chunks = [];
+    bufferedLength = 0;
+    constructor() {
+        super({ readableObjectMode: true });
+    }
+    _transform(chunk, _encoding, callback) {
+        this.chunks.push(chunk);
+        this.bufferedLength += chunk.length;
+        try {
+            this.drainFrames();
+            callback();
+        }
+        catch (err) {
+            callback(err);
+        }
+    }
+    _flush(callback) {
+        if (this.bufferedLength > 0) {
+            callback(new Error(`Incomplete frame: ${this.bufferedLength} bytes remaining at end of stream`));
+        }
+        else {
+            callback();
+        }
+    }
+    drainFrames() {
+        while (this.bufferedLength >= HEADER_SIZE) {
+            // Peek at the header without consuming
+            const header = this.peek(HEADER_SIZE);
+            const payloadLength = header.readUInt32BE(1);
+            if (payloadLength > MAX_FRAME_SIZE) {
+                throw new Error(`Frame payload size ${payloadLength} exceeds maximum ${MAX_FRAME_SIZE}`);
+            }
+            const totalLength = HEADER_SIZE + payloadLength;
+            if (this.bufferedLength < totalLength) {
+                // Need more data
+                break;
+            }
+            // Consume the full frame
+            const frameData = this.consume(totalLength);
+            const type = frameData[0];
+            const payload = frameData.subarray(HEADER_SIZE);
+            this.push({ type, payload });
+        }
+    }
+    peek(n) {
+        if (this.chunks.length === 1 && this.chunks[0].length >= n) {
+            return this.chunks[0].subarray(0, n);
+        }
+        // Slow path: concat needed bytes
+        const parts = [];
+        let remaining = n;
+        for (const chunk of this.chunks) {
+            if (remaining <= 0)
+                break;
+            const take = Math.min(chunk.length, remaining);
+            parts.push(chunk.subarray(0, take));
+            remaining -= take;
+        }
+        return Buffer.concat(parts);
+    }
+    consume(n) {
+        if (this.chunks.length === 1 && this.chunks[0].length === n) {
+            const buf = this.chunks[0];
+            this.chunks = [];
+            this.bufferedLength = 0;
+            return buf;
+        }
+        if (this.chunks.length === 1 && this.chunks[0].length > n) {
+            const buf = this.chunks[0].subarray(0, n);
+            this.chunks[0] = this.chunks[0].subarray(n);
+            this.bufferedLength -= n;
+            return Buffer.from(buf); // Copy so subarray doesn't pin original
+        }
+        // Slow path: gather from multiple chunks
+        const result = Buffer.allocUnsafe(n);
+        let offset = 0;
+        let remaining = n;
+        while (remaining > 0) {
+            const chunk = this.chunks[0];
+            const take = Math.min(chunk.length, remaining);
+            chunk.copy(result, offset, 0, take);
+            offset += take;
+            remaining -= take;
+            if (take === chunk.length) {
+                this.chunks.shift();
+            }
+            else {
+                this.chunks[0] = chunk.subarray(take);
+            }
+        }
+        this.bufferedLength -= n;
+        return result;
+    }
+}
+/**
+ * Create a streaming frame parser.
+ * Convenience factory matching the plan's API.
+ */
+export function createFrameParser() {
+    return new FrameParser();
+}
+// --- JSON Payload Helpers ---
+const KNOWN_FRAME_TYPES = new Set(Object.values(FrameType));
+/** Check if a frame type is a known type. */
+export function isKnownFrameType(type) {
+    return KNOWN_FRAME_TYPES.has(type);
+}
+/**
+ * Parse a JSON payload from a control frame.
+ * Throws on invalid JSON.
+ */
+export function parseJsonPayload(payload) {
+    return JSON.parse(payload.toString('utf-8'));
+}
+//# sourceMappingURL=shepherd-protocol.js.map

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

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

package/dist/terminal/shepherd-replay-buffer.d.ts

@@ -0,0 +1,38 @@
+/**
+ * Standalone replay buffer for the shepherd process.
+ *
+ * Unlike RingBuffer (which stores lines), this stores raw byte chunks
+ * to preserve exact terminal output including escape sequences. It tracks
+ * the total bytes stored and evicts oldest chunks when the limit is exceeded.
+ *
+ * This module has NO dependencies beyond Node.js built-ins so the shepherd
+ * process doesn't need to pull in the full package dependency tree.
+ */
+export declare class ShepherdReplayBuffer {
+    private chunks;
+    private totalBytes;
+    private readonly maxLines;
+    private lineCount;
+    /**
+     * @param maxLines Maximum number of lines to retain. Lines are delimited
+     *   by newline characters in the raw data stream.
+     */
+    constructor(maxLines?: number);
+    /**
+     * Append raw PTY output data to the buffer.
+     * Evicts oldest chunks if the line count exceeds maxLines.
+     */
+    append(data: Buffer | string): void;
+    /**
+     * Get all buffered data as a single concatenated Buffer.
+     * Used for the REPLAY frame on reconnection.
+     */
+    getReplayData(): Buffer;
+    /** Current number of bytes stored. */
+    get size(): number;
+    /** Approximate number of lines stored. */
+    get lines(): number;
+    /** Clear all buffered data. */
+    clear(): void;
+}
+//# sourceMappingURL=shepherd-replay-buffer.d.ts.map