@holmes-lab/holmes-kit 0.1.0

package/dist/holmes/hooks/adapters/antigravity.js

@@ -0,0 +1,194 @@
+"use strict";
+var __createBinding = (this && this.__createBinding) || (Object.create ? (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    var desc = Object.getOwnPropertyDescriptor(m, k);
+    if (!desc || ("get" in desc ? !m.__esModule : desc.writable || desc.configurable)) {
+      desc = { enumerable: true, get: function() { return m[k]; } };
+    }
+    Object.defineProperty(o, k2, desc);
+}) : (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    o[k2] = m[k];
+}));
+var __setModuleDefault = (this && this.__setModuleDefault) || (Object.create ? (function(o, v) {
+    Object.defineProperty(o, "default", { enumerable: true, value: v });
+}) : function(o, v) {
+    o["default"] = v;
+});
+var __importStar = (this && this.__importStar) || (function () {
+    var ownKeys = function(o) {
+        ownKeys = Object.getOwnPropertyNames || function (o) {
+            var ar = [];
+            for (var k in o) if (Object.prototype.hasOwnProperty.call(o, k)) ar[ar.length] = k;
+            return ar;
+        };
+        return ownKeys(o);
+    };
+    return function (mod) {
+        if (mod && mod.__esModule) return mod;
+        var result = {};
+        if (mod != null) for (var k = ownKeys(mod), i = 0; i < k.length; i++) if (k[i] !== "default") __createBinding(result, mod, k[i]);
+        __setModuleDefault(result, mod);
+        return result;
+    };
+})();
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.TOOL_MAP = void 0;
+exports.adaptPreToolUse = adaptPreToolUse;
+exports.adaptStop = adaptStop;
+// @implements A-SPEC-193
+const fs = __importStar(require("node:fs"));
+const path = __importStar(require("node:path"));
+const node_child_process_1 = require("node:child_process");
+/**
+ * 실측한 도구만 등재한다.
+ *
+ * 이름과 인자 키는 이 기계에 설치된 Antigravity CLI 의 실제 대화 기록에서 뽑았다
+ * (run_command{CommandLine,Cwd} 101건, view_file{AbsolutePath} 99건,
+ * replace_file_content{TargetFile,ReplacementContent,TargetContent} 46건, grep_search, list_dir).
+ * **추측으로 이름을 더하지 않는다** — 읽기로 잘못 등재하면 쓰기가 게이트를 지나가고, 쓰기로
+ * 잘못 등재하면 읽기가 막힌다. 등재되지 않은 이름은 그대로 게이트에 넘겨 fail-closed 로 받는다
+ * (A-SPEC-163: 읽기 전용이라고 알려지지 않은 도구가 경로를 들고 오면 그것은 쓰기다).
+ */
+exports.TOOL_MAP = {
+    run_command: { as: 'Bash', commandArg: 'CommandLine' },
+    replace_file_content: { as: 'Edit', pathArg: 'TargetFile', contentArg: 'ReplacementContent' },
+    view_file: { as: 'Read', pathArg: 'AbsolutePath' },
+    grep_search: { as: 'Grep' },
+    list_dir: { as: 'Glob' },
+};
+const str = (v) => (typeof v === 'string' ? v : undefined);
+/** 출하된 훅 프로그램의 자리 — 이 파일에서 패키지 뿌리로 올라간다. */
+const shippedHook = (name) => path.resolve(__dirname, '..', '..', '..', '..', 'dist', 'holmes', 'hooks', name);
+const runShippedHook = (hookPath, payload, cwd) => {
+    const r = (0, node_child_process_1.spawnSync)(process.execPath, [hookPath], {
+        cwd, input: payload, encoding: 'utf8', timeout: 30_000,
+        env: { ...process.env },
+    });
+    const out = String(r.stdout ?? '').trim();
+    if (out === '')
+        return null;
+    try {
+        return JSON.parse(out);
+    }
+    catch {
+        return null;
+    }
+};
+/**
+ * 이 호출이 판정하는 프로젝트.
+ *
+ * 하네스가 `workspacePaths` 로 말해 주면 그것을 쓴다 — 훅을 부른 쪽이 어느 작업공간인지 아는
+ * 유일한 주체다. 말해 주지 않으면 훅 자신이 제 순서(A-SPEC-191 §24: 표지 → 배선된 스펙
+ * 디렉터리 → cwd)로 찾도록 cwd 를 그대로 넘긴다 — 여기서 다른 순서를 쓰면 두 하네스가 같은
+ * 저장소를 다른 프로젝트로 읽는다.
+ */
+function workspaceOf(payload, cwd) {
+    const first = Array.isArray(payload.workspacePaths) ? str(payload.workspacePaths[0]) : undefined;
+    if (first === undefined || first === '')
+        return cwd;
+    try {
+        return fs.statSync(first).isDirectory() ? first : cwd;
+    }
+    catch {
+        return cwd;
+    }
+}
+/** 게이트의 결정 문면에서 사유를 꺼낸다 — 훅은 두 모양 중 하나로 답한다. */
+function decisionOf(out) {
+    if (out === null)
+        return {};
+    const nested = out.hookSpecificOutput;
+    if (nested !== undefined && typeof nested === 'object') {
+        return {
+            decision: str(nested.permissionDecision),
+            reason: str(nested.permissionDecisionReason),
+        };
+    }
+    return { decision: str(out.permissionDecision) ?? str(out.decision), reason: str(out.permissionDecisionReason) ?? str(out.reason) };
+}
+/**
+ * PreToolUse: Antigravity 의 말 → 게이트 → Antigravity 의 말.
+ *
+ * 번역할 수 없는 입력은 **닫는 쪽**으로 답한다. 어댑터가 조용히 `allow` 를 돌려주면 게이트가
+ * 없는 것과 같고, 그 사실은 아무 데도 나타나지 않는다 — REQ-144 가 같은 방향으로 세운 규율이다.
+ */
+function adaptPreToolUse(stdin, cwd = process.cwd(), run = runShippedHook) {
+    let payload;
+    try {
+        payload = JSON.parse(stdin);
+    }
+    catch {
+        return { decision: 'deny', reason: '[Holmes-Kit] 훅 입력을 읽을 수 없습니다(JSON 아님) — 무엇을 판정하는지 알 수 없어 허용하지 않습니다.' };
+    }
+    const call = payload?.toolCall;
+    const name = str(call?.name);
+    if (call === null || call === undefined || name === undefined || name === '') {
+        return { decision: 'deny', reason: '[Holmes-Kit] 훅 입력에 toolCall.name 이 없습니다 — 무엇을 판정하는지 알 수 없어 허용하지 않습니다.' };
+    }
+    const args = (call.args ?? {});
+    const map = exports.TOOL_MAP[name];
+    const toolInput = {};
+    if (map?.commandArg !== undefined) {
+        const command = str(args[map.commandArg]);
+        if (command === undefined) {
+            return { decision: 'deny', reason: `[Holmes-Kit] ${name} 의 ${map.commandArg} 를 읽을 수 없습니다 — 판정할 수 없는 호출은 허용하지 않습니다.` };
+        }
+        toolInput.command = command;
+    }
+    if (map?.pathArg !== undefined) {
+        const p = str(args[map.pathArg]);
+        if (p !== undefined)
+            toolInput.file_path = p;
+    }
+    if (map?.contentArg !== undefined) {
+        const c = str(args[map.contentArg]);
+        if (c !== undefined) {
+            toolInput.content = c;
+            toolInput.new_string = c;
+        }
+    }
+    // 등재되지 않은 도구: 이름을 그대로 넘기고 인자에서 경로처럼 보이는 것을 실어 준다.
+    // 게이트가 "읽기 전용으로 알려지지 않았는데 경로를 들고 왔다 → 쓰기"로 받는다.
+    if (map === undefined) {
+        for (const key of ['TargetFile', 'AbsolutePath', 'FilePath', 'Path']) {
+            const p = str(args[key]);
+            if (p !== undefined) {
+                toolInput.file_path = p;
+                break;
+            }
+        }
+    }
+    const root = workspaceOf(payload, cwd);
+    const out = decisionOf(run(shippedHook('pre-tool-use.js'), JSON.stringify({
+        tool_name: map?.as ?? name,
+        tool_input: toolInput,
+        cwd: root,
+    }), root));
+    if (out.decision === undefined) {
+        return { decision: 'deny', reason: '[Holmes-Kit] 게이트가 답하지 않았습니다 — 판정 없이 진행하지 않습니다.' };
+    }
+    return out.decision === 'deny' ? { decision: 'deny', reason: out.reason } : { decision: 'allow' };
+}
+/**
+ * Stop: 게이트가 "막아라"라고 하면, 이 하네스에서 막는 말은 `continue` 다.
+ *
+ * 이름이 반대라서 헷갈리기 쉽다 — Claude Code 의 `block` 은 "정지를 막아라"이고 Antigravity 의
+ * `continue` 도 "정지하지 말고 계속하라"이다. 같은 뜻, 다른 낱말이다.
+ *
+ * 여기서는 실행 실패를 **열어 준다**. Stop 훅은 이미 fail-open 계약이다(턴을 죽이지 않는다).
+ */
+function adaptStop(stdin, cwd = process.cwd(), run = runShippedHook) {
+    let payload;
+    try {
+        payload = JSON.parse(stdin);
+    }
+    catch {
+        payload = {};
+    }
+    const root = workspaceOf(payload, cwd);
+    const out = decisionOf(run(shippedHook('stop.js'), JSON.stringify({
+        session_id: str(payload.conversationId) ?? 'antigravity',
+    }), root));
+    return out.decision === 'block' ? { decision: 'continue', reason: out.reason } : {};
+}