@cheongfish/bouncer 0.0.0-stage → 0.1.13

package/dist/pre-commit-hook.js

@@ -0,0 +1,170 @@
+'use strict';
+const fs = require('node:fs');
+const path = require('node:path');
+const { execFileSync: realExecFileSync } = require('node:child_process');
+const MARKER = '# bouncer-pre-commit v1';
+const INTERNAL_COMMIT_ENV = 'BOUNCER_INTERNAL_COMMIT';
+/**
+ * POSIX 단일 인용으로 경로를 hook 본문에 넣는다. 공백·글롭이 셸에서
+ * 다시 해석되면 다른 바이너리를 실행하므로, 런처 절대 경로는 데이터로만 둔다.
+ *
+ * @param {string} value - 인용할 절대 경로
+ * @returns {string} POSIX 단일 인용 문자열
+ */
+function shSingleQuote(value) {
+    return `'${value.replace(/'/g, '\'\\\'\'')}'`;
+}
+/**
+ * git hook 둘째 줄 마커인지 본다. 내용이 같아도 위치가 다르면 사용자 hook으로
+ * 본다 — 덮어쓰면 기존 검사가 사라지고 chained 이전이 유실된다.
+ *
+ * @param {string} content - hook 파일 본문
+ * @returns {boolean} 둘째 줄이 `# bouncer-pre-commit v1`이면 true
+ */
+function hasBouncerMarker(content) {
+    const lines = content.split(/\r?\n/);
+    return lines[1] === MARKER;
+}
+/**
+ * PATH의 `bouncer`를 먼저 쓰고, 없을 때만 설치 시점 런처로 폴백하는 hook 본문.
+ * 이전 hook은 내부 커밋 env와 무관하게 먼저 실행한다 — 표식은 Bouncer
+ * 검사만 건너뛰라는 뜻이지 사용자 hook을 끄라는 뜻이 아니다.
+ *
+ * @param {string} launcherPath - 기록할 런처 절대 경로
+ * @returns {string} POSIX sh hook 본문
+ */
+function renderHookScript(launcherPath) {
+    const quoted = shSingleQuote(launcherPath);
+    return `#!/bin/sh
+${MARKER}
+dir=$(dirname -- "$0")
+prev="$dir/pre-commit.bouncer-prev"
+if [ -f "$prev" ]; then
+  if [ -x "$prev" ]; then
+    "$prev" "$@"
+  else
+    sh "$prev" "$@"
+  fi
+  st=$?
+  if [ "$st" -ne 0 ]; then
+    exit "$st"
+  fi
+fi
+if [ "\${${INTERNAL_COMMIT_ENV}-}" = "1" ]; then
+  exit 0
+fi
+if command -v bouncer >/dev/null 2>&1; then
+  bouncer_bin=bouncer
+elif [ -x ${quoted} ]; then
+  bouncer_bin=${quoted}
+else
+  echo "bouncer pre-commit: CLI not found; allowing commit" >&2
+  exit 0
+fi
+"$bouncer_bin" commit-guard --staged
+`;
+}
+/**
+ * git spawn env에 내부 커밋 표식을 붙인다. hook이 이 값이면 commit-guard를
+ * 건너뛴다 — G17을 이미 통과한 bouncer 커밋이 인덱스 잔여로 다시 막히지
+ * 않게 하기 위함이다.
+ *
+ * @param {NodeJS.ProcessEnv} [base] - 복사할 env. 생략 시 process.env
+ * @returns {NodeJS.ProcessEnv} BOUNCER_INTERNAL_COMMIT=1 이 설정된 사본
+ */
+function internalCommitEnv(base = process.env) {
+    return { ...base, [INTERNAL_COMMIT_ENV]: '1' };
+}
+/**
+ * Git common dir의 hooks/pre-commit에 Bouncer hook을 설치한다.
+ * core.hooksPath가 있으면 git이 그 디렉터리만 보므로 기본 hooks/에 쓰면
+ * 죽은 파일이 되고, 사용자 hook을 옮기지도 못한 채 검사가 빠진다.
+ * 이미 `pre-commit.bouncer-prev`가 있고 현재 파일이 비-Bouncer면 throw한다.
+ * Linux `renameSync`는 대상을 덮어쓰므로, 막지 않으면 첫 설치가 저장한
+ * 사용자 hook이 사라진다. 공개 반환 상태를 늘리지 않기 위해 새 값을 두지 않는다.
+ *
+ * @param {object} opts
+ * @param {string} opts.repoRoot - 대상 저장소 루트
+ * @param {string} opts.launcherPath - PATH에 bouncer가 없을 때 쓸 런처 절대 경로
+ * @param {{ execFileSync?: Function, fs?: object }} [opts.deps] - git·fs 테스트 seam
+ * @returns {{ preCommitHook: PreCommitHookState, warning?: string }}
+ *   installed: 새 파일. chained: 기존 hook을 pre-commit.bouncer-prev로 옮김.
+ *   already-installed: 마커가 있어 본문만 갱신. skipped-hooks-path: core.hooksPath.
+ *   skipped-no-git: git common dir을 못 찾음.
+ *   prev가 이미 있으면 throw하므로 이 객체는 반환되지 않는다.
+ */
+function installPreCommitHook({ repoRoot, launcherPath, deps, }) {
+    const execFileSync = (cmd, args, opts) => String((deps && deps.execFileSync ? deps.execFileSync : realExecFileSync)(cmd, args, opts));
+    const io = {
+        existsSync: fs.existsSync,
+        readFileSync: fs.readFileSync,
+        writeFileSync: fs.writeFileSync,
+        renameSync: fs.renameSync,
+        chmodSync: fs.chmodSync,
+        mkdirSync: fs.mkdirSync,
+        ...(deps && deps.fs ? deps.fs : {}),
+    };
+    let commonDir;
+    try {
+        // 1. common dir이 있어야 worktree여도 같은 hooks/에 설치된다.
+        commonDir = execFileSync('git', ['rev-parse', '--git-common-dir'], {
+            cwd: repoRoot,
+            encoding: 'utf8',
+            stdio: ['ignore', 'pipe', 'pipe'],
+        }).trim();
+    }
+    catch (_error) {
+        // git이 아니거나 common dir 조회 실패만 흡수. 그 외 I/O는 호출부에 둔다.
+        return { preCommitHook: 'skipped-no-git' };
+    }
+    if (!commonDir)
+        return { preCommitHook: 'skipped-no-git' };
+    let hooksPath = '';
+    try {
+        hooksPath = execFileSync('git', ['config', '--get', 'core.hooksPath'], {
+            cwd: repoRoot,
+            encoding: 'utf8',
+            stdio: ['ignore', 'pipe', 'pipe'],
+        }).trim();
+    }
+    catch (_error) {
+        // git config --get 은 unset이면 exit 1. 설치를 진행한다.
+    }
+    if (hooksPath) {
+        return {
+            preCommitHook: 'skipped-hooks-path',
+            warning: `core.hooksPath is set (${hooksPath}); skipping Bouncer pre-commit hook install`,
+        };
+    }
+    const hookDir = path.join(path.resolve(repoRoot, commonDir), 'hooks');
+    const hookFile = path.join(hookDir, 'pre-commit');
+    const prevFile = path.join(hookDir, 'pre-commit.bouncer-prev');
+    io.mkdirSync(hookDir, { recursive: true });
+    let state = 'installed';
+    if (io.existsSync(hookFile)) {
+        const existing = io.readFileSync(hookFile, 'utf8');
+        if (hasBouncerMarker(existing)) {
+            state = 'already-installed';
+        }
+        else {
+            // 사용자 hook을 지우지 않는다. 새 본문이 이 파일을 먼저 실행한다.
+            // prev가 있으면 renameSync가 그 내용을 덮어쓴다(POSIX). 첫 설치가
+            // 맡긴 원본을 지키기 위해 거부하고, 현재 hook도 쓰지 않는다.
+            if (io.existsSync(prevFile)) {
+                throw new Error(`pre-commit.bouncer-prev already exists at ${prevFile}; refusing to overwrite the saved user hook`);
+            }
+            io.renameSync(hookFile, prevFile);
+            state = 'chained';
+        }
+    }
+    io.writeFileSync(hookFile, renderHookScript(launcherPath));
+    // git은 실행 비트가 없는 hook을 건너뛴다. 내용만 있으면 검사가 침묵한다.
+    io.chmodSync(hookFile, 0o755);
+    return { preCommitHook: state };
+}
+module.exports = {
+    installPreCommitHook,
+    internalCommitEnv,
+    MARKER,
+    INTERNAL_COMMIT_ENV,
+};

package/dist/print-dispatch.js

@@ -0,0 +1,285 @@
+'use strict';
+const guards = require("./guards");
+const { isRecord, isEnoentError } = guards;
+const fs = require('node:fs');
+const path = require('node:path');
+const { spawnSync } = require('node:child_process');
+const config = require("./config");
+const { readConfig } = config;
+const frontmatter = require("./frontmatter");
+const { parseFrontmatter } = frontmatter;
+const subagents = require("./subagents");
+const { resolveSubagentModel } = subagents;
+const codexAgents = require("./codex-agents");
+const { pluginAgentsDir } = codexAgents;
+const PRINT_ROLES = ['implementer', 'reviewer', 'debugger', 'context-reviewer', 'coordinator'];
+/**
+ * Cursor print 식별 줄. 문구는 `rules/cursor-print-dispatch.md` 3항과 바이트가
+ * 같아야 한다. 역할이 named agent를 다시 띄우지 못하게 고정한 문장이다.
+ *
+ * @param {string} role - implementer|reviewer|debugger|context-reviewer|coordinator
+ * @returns {string} prompt 첫 줄
+ */
+function identityLine(role) {
+    if (role === 'coordinator') {
+        // 식별 문구는 cursor-print-dispatch 3항과 바이트가 같아야 하므로 이어 붙인다.
+        return ('You are the dispatched bouncer-coordinator itself. '
+            + 'Dispatch only your workers, each under rules/cursor-print-dispatch.md.');
+    }
+    return (`You are the dispatched bouncer-${role} itself. `
+        + 'Do this role\'s work directly and never dispatch any Bouncer agent.');
+}
+/**
+ * 플러그인 루트 절대 경로를 prompt에 실을 한 줄로 만든다. 문구는
+ * `rules/cursor-print-dispatch.md` 3항과 바이트가 같아야 한다 — 세션이
+ * `references/...`를 워크스페이스에서 찾지 않고 이 루트에 붙이게 한다.
+ *
+ * @param {string} pluginRoot - 플러그인 루트 절대 경로
+ * @returns {string} `Plugin root: …` 한 줄
+ */
+function pluginRootLine(pluginRoot) {
+    return (`Plugin root: ${pluginRoot}. `
+        + 'Resolve plugin-relative paths (rules/..., references/..., agents/...) against it.');
+}
+/**
+ * 역할 본문·controller 입력을 prompt 파일 순서로 붙인다. 식별 줄을 맨 앞에
+ * 두는 이유는 payload가 `---`로 시작하면 CLI가 옵션으로 읽기 때문이다.
+ * 루트 줄은 식별 줄 바로 뒤 — 탐색 없이 `references/`·`rules/`를 열게 한다.
+ *
+ * @param {{ role: string, roleMarkdown: string, input: string, pluginRoot: string }} parts
+ * @param {string} parts.role - 짧은 역할 이름
+ * @param {string} parts.roleMarkdown - frontmatter가 있는 역할 문서 전체
+ * @param {string} parts.input - `--input` 파일 내용 그대로
+ * @param {string} parts.pluginRoot - 플러그인 루트 절대 경로(`agentsDir`의 부모)
+ * @returns {string} 디스크에 쓸 prompt 본문
+ */
+function assemblePrintPrompt({ role, roleMarkdown, input, pluginRoot, }) {
+    const { body } = parseFrontmatter(roleMarkdown);
+    const roleBody = body.replace(/^(?:\r?\n)+/, '').replace(/(?:\r?\n)+$/, '');
+    return `${identityLine(role)}\n\n${pluginRootLine(pluginRoot)}\n\n${roleBody}\n\n${input}`;
+}
+function fail(reason, cause, next, extra) {
+    return { ok: false, reason, cause, next, ...extra };
+}
+/**
+ * `.bouncer/config.json`이 cursor·print opt-in인지 본다. env provider 추론은
+ * 쓰지 않는다 — print는 명시 pin일 때만 켜지고, 그 외는 items 2-4다.
+ *
+ * @param {string} repoRoot - 설정을 읽을 저장소 루트
+ * @returns {boolean} provider가 cursor이고 dispatch가 print일 때만 true
+ */
+function isCursorPrintEnabled(repoRoot) {
+    const cfg = readConfig(repoRoot);
+    if (!isRecord(cfg) || !isRecord(cfg.subagents))
+        return false;
+    return cfg.subagents.provider === 'cursor' && cfg.subagents.dispatch === 'print';
+}
+function pathKind(absPath) {
+    try {
+        const st = fs.statSync(absPath);
+        if (st.isFile())
+            return 'file';
+        if (st.isDirectory())
+            return 'dir';
+        return 'missing';
+    }
+    catch (error) {
+        // ENOENT만 입력 부재. EACCES를 missing으로 접으면 권한 오류가 잘못된
+        // `--input`/`--cwd` 안내가 된다.
+        if (isEnoentError(error))
+            return 'missing';
+        throw error;
+    }
+}
+/**
+ * stdout jsonl에서 마지막 `type: "result"` 객체를 고른다. 중간 assistant 줄은
+ * report가 아니다 — 최종 result만 규칙 6항의 보고다.
+ *
+ * @param {string} raw - stdout 파일 내용
+ * @returns {Record<string, unknown> | null} 마지막 result 또는 없음
+ */
+function lastResultEvent(raw) {
+    let last = null;
+    for (const line of raw.split(/\r?\n/)) {
+        if (line.trim() === '')
+            continue;
+        let parsed;
+        try {
+            parsed = JSON.parse(line);
+        }
+        catch (_error) {
+            // stream-json이 아닌 줄은 건너뛴다. 한 줄 파손 때문에 전체 디스패치를
+            // result-missing으로 바꾸면 실제 result가 뒤에 있어도 잃는다.
+            continue;
+        }
+        if (isRecord(parsed) && parsed.type === 'result')
+            last = parsed;
+    }
+    return last;
+}
+/**
+ * Cursor print 한 건을 조립·실행하고 마지막 result를 돌려준다. Task
+ * subagent로는 절대 내려가지 않는다. cursor·print가 아니면 prompt 파일도
+ * 만들지 않는다.
+ *
+ * @param {{
+ *   repoRoot: string, role: string, cwd: string, inputFile: string,
+ *   outDir: string, deps?: PrintDispatchDeps
+ * }} opts
+ * @param {string} opts.repoRoot - `.bouncer/config.json`을 읽는 루트
+ * @param {string} opts.role - 짧은 역할 이름
+ * @param {string} opts.cwd - agent `--workspace`이자 spawn cwd
+ * @param {string} opts.inputFile - controller 입력 파일
+ * @param {string} opts.outDir - prompt·jsonl·log를 덮어쓸 디렉터리
+ * @param {PrintDispatchDeps} [opts.deps] - 테스트 seam (`agentBin`, `agentsDir`)
+ * @returns {PrintDispatchResult} 성공 객체 또는 `{ ok: false, reason, cause, next }`
+ */
+function runPrintDispatch({ repoRoot, role, cwd, inputFile, outDir, deps, }) {
+    // 1. 실행 전 경로. prompt를 쓰기 전에 거절해야 실패 run이 잔여 파일을 남기지 않는다.
+    if (pathKind(inputFile) !== 'file' || pathKind(cwd) !== 'dir') {
+        return fail('dispatch-input-invalid', '`--input` must be an existing file and `--cwd` an existing directory', 'create the input file and cwd, then retry `bouncer dispatch print`');
+    }
+    // 2. opt-in 아니면 여기서 끝. items 2-4(Task)로 조용히 내려가지 않는다.
+    if (!isCursorPrintEnabled(repoRoot)) {
+        return fail('print-dispatch-disabled', '`.bouncer/config.json` is not `subagents.provider: "cursor"` and `subagents.dispatch: "print"`', 'dispatch using `rules/subagent-model.md` items 2-4, or set those keys and retry');
+    }
+    let agentsDir;
+    if (deps && deps.agentsDir) {
+        agentsDir = deps.agentsDir;
+    }
+    else {
+        try {
+            agentsDir = pluginAgentsDir();
+        }
+        catch (error) {
+            // resolver의 Error(무효 BOUNCER_HOME, 유효 루트 없음)만 안내 가능한 실패로 바꾼다.
+            // 그 외 예외는 버그이므로 다시 던진다.
+            if (!(error instanceof Error))
+                throw error;
+            return fail('plugin-root-unresolved', error.message, 'set BOUNCER_HOME to the plugin install and retry');
+        }
+    }
+    // agentsDir 부모 = 플러그인 루트. 테스트 seam의 임시 root와 프로덕션 설치
+    // 루트가 같은 규칙으로 잡혀야 prompt의 Plugin root 줄이 탐색 없이 동작한다.
+    const pluginRoot = path.resolve(path.dirname(agentsDir));
+    const rolePath = path.join(agentsDir, `bouncer-${role}.md`);
+    let roleMarkdown;
+    try {
+        roleMarkdown = fs.readFileSync(rolePath, 'utf8');
+    }
+    catch (error) {
+        if (isEnoentError(error)) {
+            return fail('role-document-invalid', `role document missing: ${rolePath}`, 'install the plugin agents directory or pass a valid --role');
+        }
+        throw error;
+    }
+    let prompt;
+    try {
+        prompt = assemblePrintPrompt({
+            role,
+            roleMarkdown,
+            input: fs.readFileSync(inputFile, 'utf8'),
+            pluginRoot,
+        });
+    }
+    catch (error) {
+        // parseFrontmatter 실패(블록 없음)와 YAML 파손만 흡수한다. 그 외는 설정·IO 버그다.
+        const message = error instanceof Error ? error.message : String(error);
+        if (/frontmatter|YAMLException|duplicated mapping/i.test(message)
+            || (error instanceof Error && error.name === 'YAMLException')) {
+            return fail('role-document-invalid', `role document frontmatter is invalid: ${rolePath}`, 'fix the role markdown frontmatter, then retry');
+        }
+        throw error;
+    }
+    const agentBin = deps && deps.agentBin ? deps.agentBin : 'agent';
+    // 3. login 확인. print argv보다 먼저 — 미로그인 세션에 prompt를 남기지 않기 위함.
+    const status = spawnSync(agentBin, ['status'], {
+        encoding: 'utf8',
+        shell: false,
+    });
+    const statusText = `${status.stdout || ''}${status.stderr || ''}`;
+    if (status.error
+        || status.status !== 0
+        || /not logged in/i.test(statusText)) {
+        return fail('agent-unavailable', status.error
+            ? `cannot execute ${agentBin}: ${status.error.message}`
+            : 'agent status failed or reported not logged in', 'run `agent login`, then retry `bouncer dispatch print`');
+    }
+    const { model } = resolveSubagentModel({
+        repoRoot,
+        agentName: `bouncer-${role}`,
+    });
+    fs.mkdirSync(outDir, { recursive: true });
+    const promptPath = path.join(outDir, `bouncer-${role}.prompt.md`);
+    const stdoutPath = path.join(outDir, `bouncer-${role}.jsonl`);
+    const stderrPath = path.join(outDir, `bouncer-${role}.log`);
+    fs.writeFileSync(promptPath, prompt);
+    const argv = [
+        '--print',
+        '--force',
+        '--trust',
+        '--output-format',
+        'stream-json',
+        '--workspace',
+        cwd,
+    ];
+    if (model !== null) {
+        argv.push('--model', model);
+    }
+    // `--`는 prompt가 `-`로 시작해도 옵션으로 읽히지 않게 한다. 내용은 argv
+    // 칸으로만 넘기고 `$(cat …)` 셸은 만들지 않는다.
+    argv.push('--', prompt);
+    // 4. stdout/stderr는 pipe reader가 아니라 fd. tee가 파이프를 붙잡고 남는 회귀를 피한다.
+    const stdinFd = fs.openSync('/dev/null', 'r');
+    const stdoutFd = fs.openSync(stdoutPath, 'w');
+    const stderrFd = fs.openSync(stderrPath, 'w');
+    let spawned;
+    try {
+        spawned = spawnSync(agentBin, argv, {
+            cwd,
+            stdio: [stdinFd, stdoutFd, stderrFd],
+            shell: false,
+        });
+    }
+    finally {
+        fs.closeSync(stdinFd);
+        fs.closeSync(stdoutFd);
+        fs.closeSync(stderrFd);
+    }
+    const exitCode = spawned.status == null ? 1 : spawned.status;
+    if (spawned.error || exitCode !== 0) {
+        return fail('agent-exit-nonzero', spawned.error
+            ? spawned.error.message
+            : `agent --print exited ${exitCode}`, `inspect ${stdoutPath} and ${stderrPath}`, { exit_code: exitCode, stdout: stdoutPath, stderr: stderrPath });
+    }
+    const stdoutRaw = fs.readFileSync(stdoutPath, 'utf8');
+    const resultEvent = lastResultEvent(stdoutRaw);
+    if (!resultEvent) {
+        return fail('result-missing', `no stream-json result event in ${stdoutPath}`, `inspect ${stdoutPath} and retry the dispatch`, { stdout: stdoutPath, stderr: stderrPath });
+    }
+    const report = typeof resultEvent.result === 'string' ? resultEvent.result : '';
+    if (resultEvent.is_error === true) {
+        return fail('result-error', 'the final result event has is_error true', 'fix the dispatch input from the report, then retry', { report, stdout: stdoutPath, stderr: stderrPath });
+    }
+    // transport가 성공해도 보고서 문자열이 없으면 coordinator가 판정할 보고가 없다.
+    // result-error 뒤에 두어 is_error + 빈 result는 기존대로 result-error로 남기고,
+    // trim은 판정에만 쓰며 성공 시 report 원문은 그대로 돌려준다.
+    if (report.trim().length === 0) {
+        return fail('report-missing', 'the final result event has no report string', `inspect ${stdoutPath} and retry the dispatch`, { stdout: stdoutPath, stderr: stderrPath });
+    }
+    return {
+        ok: true,
+        role: role,
+        model,
+        exit_code: 0,
+        report,
+        prompt: promptPath,
+        stdout: stdoutPath,
+        stderr: stderrPath,
+    };
+}
+module.exports = {
+    PRINT_ROLES,
+    assemblePrintPrompt,
+    runPrintDispatch,
+};

package/dist/render.js

@@ -0,0 +1,8 @@
+'use strict';
+// 경로는 emit된 scripts/lib/ 기준(tsc는 require 문자열을 재작성하지 않음).
+const yaml = require('../vendor/js-yaml');
+function renderDoc(data, body) {
+    const front = yaml.dump(data, { lineWidth: -1, sortKeys: false });
+    return `---\n${front}---\n${body}`;
+}
+module.exports = { renderDoc };