@nexera-systems/protocol 0.1.3

package/package.json

@@ -0,0 +1,85 @@
+{
+  "name": "@nexera-systems/protocol",
+  "version": "0.1.3",
+  "type": "module",
+  "description": "Coding agent CLI for protocol: — usage counts against your plan (free tier included)",
+  "main": "dist/index.js",
+  "bin": {
+    "protocol": "dist/index.js"
+  },
+  "scripts": {
+    "build": "npm run check && tsx build.ts",
+    "dev": "tsx watch src/index.ts",
+    "start": "node dist/index.js",
+    "typecheck": "tsc --noEmit",
+    "lint": "eslint src/",
+    "test": "vitest",
+    "test:native-pty": "PROTOCOL_REQUIRE_NATIVE_PTY=1 vitest --run src/session/session.test.ts",
+    "check": "node scripts/check-wiring.mjs",
+    "smoke": "tsx scripts/smoke.mjs",
+    "e2e:cowork-codex": "tsx scripts/cowork-codex-e2e.mts",
+    "postinstall": "node scripts/fix-pty-perms.mjs",
+    "prepublishOnly": "NODE_ENV=production npm run build"
+  },
+  "files": [
+    "dist/index.js",
+    "scripts/fix-pty-perms.mjs"
+  ],
+  "keywords": [
+    "cli",
+    "agent",
+    "llm",
+    "ai",
+    "coding-assistant"
+  ],
+  "author": "Nexera Systems",
+  "license": "MIT",
+  "dependencies": {
+    "@modelcontextprotocol/sdk": "^1.0.0",
+    "@xenova/transformers": "^2.17.0",
+    "chalk": "^5.3.0",
+    "clipboardy": "^5.3.1",
+    "commander": "^12.0.0",
+    "dotenv": "^16.6.1",
+    "eventemitter3": "^5.0.0",
+    "glob": "^10.0.0",
+    "gradient-string": "^3.0.0",
+    "ink": "^6.8.0",
+    "ink-text-input": "^6.0.0",
+    "inquirer": "^9.3.8",
+    "js-yaml": "^4.1.0",
+    "marked": "^12.0.0",
+    "marked-terminal": "^7.0.0",
+    "node-pty": "^1.1.0",
+    "ora": "^8.0.0",
+    "react": "^19.2.4",
+    "uuid": "^9.0.0",
+    "zod": "^3.22.0"
+  },
+  "devDependencies": {
+    "@types/inquirer": "^9.0.0",
+    "@types/js-yaml": "^4.0.0",
+    "@types/node": "^20.0.0",
+    "@types/react": "^19.2.14",
+    "@types/uuid": "^9.0.0",
+    "esbuild": "^0.20.0",
+    "tsx": "^4.7.0",
+    "typescript": "^5.4.0",
+    "vitest": "^1.0.0"
+  },
+  "engines": {
+    "node": ">=18.0.0"
+  },
+  "publishConfig": {
+    "access": "public"
+  },
+  "repository": {
+    "type": "git",
+    "url": "git+https://github.com/GALGALMawang/protocol-mvp.git",
+    "directory": "cli"
+  },
+  "homepage": "https://protocolai.tech",
+  "bugs": {
+    "url": "https://github.com/GALGALMawang/protocol-mvp/issues"
+  }
+}

package/scripts/fix-pty-perms.mjs

@@ -0,0 +1,63 @@
+#!/usr/bin/env node
+/**
+ * node-pty 의 prebuilt `spawn-helper` 에 실행 권한을 되돌린다.
+ *
+ * 왜 필요한가 (2026-08-17):
+ *   npm 이 tarball 을 풀면서 이 헬퍼의 실행 비트를 떨어뜨린다(644). 그러면 pty 가
+ *   `posix_spawnp failed` 로 죽는데, 에러 어디에도 "권한"이라는 말이 없어서
+ *   **"Node 24 라서 node-pty 가 안 되는구나"로 오진**하기 딱 좋다. 실제로 이 저장소는
+ *   그 오진 상태로 임베디드 터미널을 꺼둔 채 지냈다.
+ *
+ * ⚠️ 2026-08-23: 이 스크립트가 **실제 설치에선 한 번도 동작한 적이 없었다.**
+ *   예전엔 `process.cwd()/node_modules/node-pty` 만 봤는데, npm 은 의존성의
+ *   postinstall 을 **그 패키지 자기 디렉토리**를 cwd 로 실행한다. 그런데 node-pty 는
+ *   보통 최상위로 호이스팅되므로 그 경로엔 없다 → ENOENT 를 조용히 삼키고 끝났다.
+ *   즉 고치라고 만든 버그가 모든 유저에게 그대로 재현되고 있었다.
+ *   이제 import.meta.resolve / require.resolve 로 **실제 설치 위치**를 찾는다.
+ *
+ * 실패해도 설치를 막지는 않는다 — pty 는 있으면 좋은 기능이지 CLI 의 전제가 아니다.
+ */
+import fs from 'fs';
+import path from 'path';
+import { createRequire } from 'module';
+import { fileURLToPath } from 'url';
+
+/** node-pty 가 실제로 설치된 자리를 찾는다. 호이스팅·중첩 어느 쪽이든. */
+function findPrebuilds() {
+  const cands = [];
+  // ① 정석: 이 스크립트 위치 기준으로 node-pty 를 해석한다 (호이스팅돼도 찾아진다)
+  try {
+    const req = createRequire(import.meta.url);
+    cands.push(path.join(path.dirname(req.resolve('node-pty/package.json')), 'prebuilds'));
+  } catch { /* 아래 폴백 */ }
+  // ② 폴백: 스크립트에서 위로 올라가며 node_modules/node-pty 를 찾는다
+  let dir = path.dirname(fileURLToPath(import.meta.url));
+  for (let i = 0; i < 6; i++) {
+    cands.push(path.join(dir, 'node_modules', 'node-pty', 'prebuilds'));
+    dir = path.dirname(dir);
+  }
+  // ③ 마지막: 예전 동작(개발 저장소에서 직접 돌릴 때)
+  cands.push(path.join(process.cwd(), 'node_modules', 'node-pty', 'prebuilds'));
+  return cands.find((c) => { try { return fs.existsSync(c); } catch { return false; } }) ?? null;
+}
+
+const base = findPrebuilds();
+if (!base) {
+  // node-pty 가 아직 안 풀렸거나 설치 안 된 경우 — 조용히 넘어간다(설치를 막지 않는다)
+  process.exit(0);
+}
+
+let fixed = 0;
+try {
+  for (const dir of fs.readdirSync(base)) {
+    const helper = path.join(base, dir, 'spawn-helper');
+    if (!fs.existsSync(helper)) continue;
+    const mode = fs.statSync(helper).mode;
+    if (mode & 0o111) continue;          // 이미 실행 가능
+    fs.chmodSync(helper, 0o755);
+    fixed++;
+  }
+  if (fixed > 0) console.log(`[protocol] node-pty spawn-helper 실행 권한 복구 (${fixed}개)`);
+} catch (e) {
+  console.warn('[protocol] node-pty 권한 확인 건너뜀:', e.message);
+}