@tienne/gestalt 0.108.0 → 0.110.0

package/dist/src/peer/ws.js

@@ -0,0 +1,308 @@
+import { createHash, randomBytes } from 'node:crypto';
+import { EventEmitter } from 'node:events';
+import { request as httpRequest } from 'node:http';
+import { request as httpsRequest } from 'node:https';
+/**
+ * 릴레이와 데몬이 쓰는 최소 WebSocket(RFC 6455). 글자 메시지만 주고받는다.
+ *
+ * 의존성을 더하지 않으려고 직접 짰다. Node 22에 클라이언트(`WebSocket` 전역)는 있지만
+ * 서버가 없어서 프레임 해석을 어차피 짜야 하고 양쪽이 같은 코드를 쓰면 밀린 양을
+ * `socket.writableLength`로 똑같이 잴 수 있다.
+ */
+const GUID = '258EAFA5-E914-47DA-95CA-C5AB0DC85B11';
+/** 메시지 하나의 상한. 넘으면 1009로 닫는다 */
+export const DEFAULT_MAX_MESSAGE_BYTES = 4 * 1024 * 1024;
+const OP_CONT = 0x0;
+const OP_TEXT = 0x1;
+const OP_BINARY = 0x2;
+const OP_CLOSE = 0x8;
+const OP_PING = 0x9;
+const OP_PONG = 0xa;
+/**
+ * 연결 하나. 이벤트는 `message`(글자), `close`(코드, 이유), `pong`이다.
+ * `error`는 내보내지 않는다 — 소켓 오류는 1006 close로 바꿔 한 길로만 끝나게 한다.
+ */
+export class WsConnection extends EventEmitter {
+    socket;
+    options;
+    buf = Buffer.alloc(0);
+    fragments = [];
+    fragmentBytes = 0;
+    closed = false;
+    closeSent = false;
+    maxMessageBytes;
+    constructor(socket, options, head) {
+        super();
+        this.socket = socket;
+        this.options = options;
+        this.maxMessageBytes = options.maxMessageBytes ?? DEFAULT_MAX_MESSAGE_BYTES;
+        socket.on('data', (chunk) => this.onData(chunk));
+        socket.on('close', () => this.finish(1006, ''));
+        socket.on('error', () => this.finish(1006, ''));
+        socket.on('drain', () => this.emit('drain'));
+        // 핸드셰이크 응답과 같은 패킷에 실려 온 첫 프레임이다. 버퍼에 먼저 넣어 차례를 지키고
+        // 해석은 부른 쪽이 message 리스너를 붙인 뒤로 미룬다
+        if (head && head.length > 0) {
+            this.buf = Buffer.from(head);
+            setImmediate(() => this.onData(Buffer.alloc(0)));
+        }
+    }
+    /** 소켓 버퍼에 밀려 있는 바이트 */
+    get bufferedAmount() {
+        return this.socket.writableLength ?? 0;
+    }
+    get isOpen() {
+        return !this.closed && !this.closeSent;
+    }
+    send(text) {
+        if (!this.isOpen)
+            return false;
+        return this.writeFrame(OP_TEXT, Buffer.from(text, 'utf8'));
+    }
+    ping() {
+        if (this.isOpen)
+            this.writeFrame(OP_PING, Buffer.alloc(0));
+    }
+    close(code = 1000, reason = '') {
+        if (this.closed)
+            return;
+        if (!this.closeSent) {
+            this.closeSent = true;
+            const r = Buffer.from(reason.slice(0, 100), 'utf8');
+            const body = Buffer.alloc(2 + r.length);
+            body.writeUInt16BE(code, 0);
+            r.copy(body, 2);
+            this.writeFrame(OP_CLOSE, body);
+        }
+        // 상대가 close로 답하지 않아도 오래 붙잡지 않는다
+        const timer = setTimeout(() => this.socket.destroy(), 1_000);
+        timer.unref();
+        this.socket.end();
+        this.finish(code, reason);
+    }
+    /** 상대에게 알리지 않고 끊는다. 안 읽는 상대를 떼어낼 때 쓴다 */
+    terminate(code = 1006, reason = '') {
+        this.socket.destroy();
+        this.finish(code, reason);
+    }
+    finish(code, reason) {
+        if (this.closed)
+            return;
+        this.closed = true;
+        this.buf = Buffer.alloc(0);
+        this.fragments = [];
+        this.emit('close', code, reason);
+    }
+    writeFrame(op, payload) {
+        const mask = this.options.client;
+        const len = payload.length;
+        const lenBytes = len < 126 ? 0 : len < 65536 ? 2 : 8;
+        const header = Buffer.alloc(2 + lenBytes + (mask ? 4 : 0));
+        header[0] = 0x80 | op;
+        header[1] = (mask ? 0x80 : 0) | (lenBytes === 0 ? len : lenBytes === 2 ? 126 : 127);
+        if (lenBytes === 2)
+            header.writeUInt16BE(len, 2);
+        else if (lenBytes === 8)
+            header.writeBigUInt64BE(BigInt(len), 2);
+        let body = payload;
+        if (mask) {
+            const key = randomBytes(4);
+            key.copy(header, 2 + lenBytes);
+            body = Buffer.allocUnsafe(len);
+            for (let i = 0; i < len; i++)
+                body[i] = payload[i] ^ key[i & 3];
+        }
+        try {
+            return this.socket.write(Buffer.concat([header, body]));
+        }
+        catch {
+            return false;
+        }
+    }
+    onData(chunk) {
+        if (this.closed)
+            return;
+        this.buf = this.buf.length === 0 ? chunk : Buffer.concat([this.buf, chunk]);
+        while (!this.closed) {
+            const frame = this.readFrame();
+            if (!frame)
+                return;
+            this.onFrame(frame.fin, frame.op, frame.payload);
+        }
+    }
+    readFrame() {
+        const b = this.buf;
+        if (b.length < 2)
+            return null;
+        const fin = (b[0] & 0x80) !== 0;
+        const op = b[0] & 0x0f;
+        const masked = (b[1] & 0x80) !== 0;
+        let len = b[1] & 0x7f;
+        let off = 2;
+        if (len === 126) {
+            if (b.length < 4)
+                return null;
+            len = b.readUInt16BE(2);
+            off = 4;
+        }
+        else if (len === 127) {
+            if (b.length < 10)
+                return null;
+            const big = b.readBigUInt64BE(2);
+            if (big > BigInt(this.maxMessageBytes)) {
+                this.close(1009, 'too big');
+                return null;
+            }
+            len = Number(big);
+            off = 10;
+        }
+        if (len > this.maxMessageBytes) {
+            this.close(1009, 'too big');
+            return null;
+        }
+        // 서버는 가린 프레임만, 클라이언트는 안 가린 프레임만 받는다(RFC 6455 5.1)
+        if (masked === this.options.client) {
+            this.close(1002, 'mask');
+            return null;
+        }
+        const maskLen = masked ? 4 : 0;
+        if (b.length < off + maskLen + len)
+            return null;
+        let payload = b.subarray(off + maskLen, off + maskLen + len);
+        if (masked) {
+            const key = b.subarray(off, off + 4);
+            const out = Buffer.allocUnsafe(len);
+            for (let i = 0; i < len; i++)
+                out[i] = payload[i] ^ key[i & 3];
+            payload = out;
+        }
+        else {
+            payload = Buffer.from(payload);
+        }
+        this.buf = b.subarray(off + maskLen + len);
+        return { fin, op, payload };
+    }
+    onFrame(fin, op, payload) {
+        switch (op) {
+            case OP_PING:
+                if (this.isOpen)
+                    this.writeFrame(OP_PONG, payload);
+                return;
+            case OP_PONG:
+                this.emit('pong');
+                return;
+            case OP_CLOSE: {
+                const code = payload.length >= 2 ? payload.readUInt16BE(0) : 1005;
+                const reason = payload.length > 2 ? payload.subarray(2).toString('utf8') : '';
+                this.close(code === 1005 ? 1000 : code, reason);
+                return;
+            }
+            case OP_BINARY:
+                this.close(1003, 'text only');
+                return;
+            case OP_TEXT:
+            case OP_CONT: {
+                if (op === OP_TEXT && this.fragments.length > 0) {
+                    this.close(1002, 'fragment');
+                    return;
+                }
+                if (op === OP_CONT && this.fragments.length === 0) {
+                    this.close(1002, 'continuation');
+                    return;
+                }
+                this.fragmentBytes += payload.length;
+                if (this.fragmentBytes > this.maxMessageBytes) {
+                    this.close(1009, 'too big');
+                    return;
+                }
+                this.fragments.push(payload);
+                if (!fin)
+                    return;
+                const text = Buffer.concat(this.fragments).toString('utf8');
+                this.fragments = [];
+                this.fragmentBytes = 0;
+                try {
+                    this.emit('message', text);
+                }
+                catch (err) {
+                    // 리스너가 던지면 소켓 data 핸들러 밖으로 나가 프로세스가 죽는다
+                    process.stderr.write(`[peer] ws message handler failed: ${String(err)}\n`);
+                }
+                return;
+            }
+            default:
+                this.close(1002, 'opcode');
+        }
+    }
+}
+/**
+ * http(s) 서버의 `upgrade` 이벤트에서 부른다. 핸드셰이크가 틀리면 400으로 닫고 null.
+ */
+export function acceptUpgrade(req, socket, head, options = {}) {
+    const key = req.headers['sec-websocket-key'];
+    const upgrade = String(req.headers.upgrade ?? '').toLowerCase();
+    if (req.method !== 'GET' ||
+        upgrade !== 'websocket' ||
+        typeof key !== 'string' ||
+        !/^[A-Za-z0-9+/]{22}==$/.test(key) ||
+        req.headers['sec-websocket-version'] !== '13') {
+        socket.end('HTTP/1.1 400 Bad Request\r\nConnection: close\r\n\r\n');
+        return null;
+    }
+    socket.write('HTTP/1.1 101 Switching Protocols\r\n' +
+        'Upgrade: websocket\r\n' +
+        'Connection: Upgrade\r\n' +
+        `Sec-WebSocket-Accept: ${acceptKey(key)}\r\n\r\n`);
+    return new WsConnection(socket, { ...options, client: false }, head);
+}
+/** `ws://` 또는 `wss://`로 붙는다 */
+export function connectWs(url, options = {}) {
+    return new Promise((resolve, reject) => {
+        const u = new URL(url);
+        if (u.protocol !== 'ws:' && u.protocol !== 'wss:') {
+            reject(new Error(`ws:// 또는 wss:// 주소여야 해요: ${url}`));
+            return;
+        }
+        const key = randomBytes(16).toString('base64');
+        const make = u.protocol === 'wss:' ? httpsRequest : httpRequest;
+        const req = make({
+            hostname: u.hostname,
+            port: u.port || (u.protocol === 'wss:' ? 443 : 80),
+            path: `${u.pathname}${u.search}`,
+            headers: {
+                Connection: 'Upgrade',
+                Upgrade: 'websocket',
+                'Sec-WebSocket-Key': key,
+                'Sec-WebSocket-Version': '13',
+            },
+        });
+        const timer = setTimeout(() => {
+            req.destroy(new Error(`릴레이가 ${options.timeoutMs ?? 10_000}ms 안에 답하지 않았어요`));
+        }, options.timeoutMs ?? 10_000);
+        req.once('upgrade', (res, socket, head) => {
+            clearTimeout(timer);
+            if (res.headers['sec-websocket-accept'] !== acceptKey(key)) {
+                socket.destroy();
+                reject(new Error('릴레이 핸드셰이크 응답이 맞지 않아요'));
+                return;
+            }
+            resolve(new WsConnection(socket, { ...options, client: true }, head));
+        });
+        req.once('response', (res) => {
+            clearTimeout(timer);
+            res.resume();
+            reject(new Error(`릴레이가 WebSocket을 거절했어요 (HTTP ${res.statusCode})`));
+        });
+        req.once('error', (err) => {
+            clearTimeout(timer);
+            reject(err);
+        });
+        req.end();
+    });
+}
+function acceptKey(key) {
+    return createHash('sha1')
+        .update(key + GUID)
+        .digest('base64');
+}
+//# sourceMappingURL=ws.js.map

package/dist/src/peer/ws.js.map

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

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@tienne/gestalt",
-  "version": "0.108.0",
+  "version": "0.110.0",
   "description": "TypeScript AI Development Harness - Gestalt psychology-driven requirement clarification",
   "repository": {
     "type": "git",

package/plugin/.codex-plugin/plugin.json

@@ -1,6 +1,6 @@
 {
   "name": "gestalt",
-  "version": "0.108.0",
+  "version": "0.110.0",
   "description": "Gestalt psychology-driven AI development harness. Transforms scattered requirements into structured, validated specifications through interactive interviews.",
   "author": {
     "name": "tienne"

package/plugin/.mcp.json

@@ -2,7 +2,7 @@
   "mcpServers": {
     "gestalt": {
       "command": "npx",
-      "args": ["-y", "@tienne/gestalt@0.108.0", "serve"],
+      "args": ["-y", "@tienne/gestalt@0.110.0", "serve"],
       "startup_timeout_sec": 180,
       "tool_timeout_sec": 900
     }

package/plugin/mcp.json

@@ -2,7 +2,7 @@
   "mcpServers": {
     "gestalt": {
       "command": "npx",
-      "args": ["-y", "@tienne/gestalt@0.108.0", "serve"],
+      "args": ["-y", "@tienne/gestalt@0.110.0", "serve"],
       "startup_timeout_sec": 180,
       "tool_timeout_sec": 900
     }