@holmes-lab/holmes-kit 0.1.0 → 0.1.2

package/dist/.build-id

@@ -1 +1 @@
-e26507b-msxetwff
+a81c431-msxg7g28

package/dist/holmes/cli/index.js

@@ -327,10 +327,12 @@ async function main(argv) {
             process.stderr.write(`--specs-dir ${specsDir} must be a plain relative path inside the target (no '..', no '~', no quotes or shell metacharacters)\n\n${USAGE}`);
             return 2;
         }
-        // @implements A-SPEC-193 — 모르는 하네스 이름은 조용히 무시하지 않는다. 배선했다는 보고와
-        // 실제가 어긋나는 것이 이 파일이 --mode·--settings 에서 이미 두 번 고친 실패 유형이다.
+        // @implements A-SPEC-193
+        // @implements A-SPEC-200 — World Top-Tier interactive TTY prompt & additive harness selection
         const { AGENTS } = require('./agents');
+        const { promptAgentSelection } = require('./interactive-prompt');
         let agents = [];
+        let isAdditive = false;
         if (typeof flags.agent === 'string' && flags.agent !== '') {
             const asked = flags.agent.split(',').map((s) => s.trim()).filter((s) => s !== '');
             const wanted = asked.includes('all') ? [...AGENTS] : asked;
@@ -340,9 +342,20 @@ async function main(argv) {
                 return 2;
             }
             agents = wanted;
+            isAdditive = true;
+        }
+        else if (process.stdin.isTTY && process.stdout.isTTY && flags['dry-run'] !== true && flags.remove !== true) {
+            agents = await promptAgentSelection(AGENTS, ['claude', 'antigravity']);
+            isAdditive = true;
+        }
+        else {
+            // Default to both primary AI harnesses (Claude Code & Antigravity) for seamless out-of-the-box UX
+            agents = ['claude', 'antigravity'];
+            isAdditive = true;
         }
         const opts = {
             agents,
+            allowAdditive: isAdditive,
             target: path.resolve(typeof flags.target === 'string' ? flags.target : process.cwd()),
             packageRoot: packageRoot(),
             mode,

package/dist/holmes/cli/init.js

@@ -237,7 +237,7 @@ function runInit(opts) {
     // way to take governance off. A session must not be able to unwire the gate that governs it,
     // whichever flag it reaches for. Wiring is asked of BOTH settings files.
     const wiredAnywhere = ['local', 'project'].some((which) => alreadyWired(readJson((0, exports.settingsPathOf)(opts.target, which)).value));
-    if (!opts.remove && wiredAnywhere && !opts.force) {
+    if (!opts.remove && wiredAnywhere && !opts.force && !opts.allowAdditive) {
         return { ok: false, exitCode: 2, changes, messages: [
                 'This target already has holmes-kit wiring. Re-run with --force to change it.',
             ] };

package/dist/holmes/cli/interactive-prompt.js

@@ -0,0 +1,151 @@
+"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.parseAgentList = parseAgentList;
+exports.promptAgentSelection = promptAgentSelection;
+// @implements A-SPEC-200
+const readline = __importStar(require("node:readline"));
+const agents_1 = require("./agents");
+/**
+ * Parses user input or CLI flag string into normalized Agent array.
+ */
+function parseAgentList(input) {
+    const asked = input.split(',').map((s) => s.trim()).filter((s) => s !== '');
+    if (asked.includes('all')) {
+        return [...agents_1.AGENTS];
+    }
+    const known = agents_1.AGENTS;
+    return asked.filter((a) => known.includes(a));
+}
+/**
+ * Renders an interactive TTY checkbox selection menu using standard readline & ANSI codes.
+ */
+async function promptAgentSelection(availableAgents = agents_1.AGENTS, currentWired = ['claude']) {
+    if (!process.stdin.isTTY || !process.stdout.isTTY) {
+        return ['claude', 'antigravity']; // Fallback for non-TTY
+    }
+    return new Promise((resolve) => {
+        const selected = new Set(currentWired.length ? currentWired : ['claude', 'antigravity']);
+        let cursor = 0;
+        const items = [...availableAgents, 'all'];
+        const rl = readline.createInterface({
+            input: process.stdin,
+            output: process.stdout,
+        });
+        readline.emitKeypressEvents(process.stdin, rl);
+        if (process.stdin.isTTY) {
+            process.stdin.setRawMode(true);
+        }
+        const render = () => {
+            process.stdout.write('\x1B[2J\x1B[0;0H'); // Clear screen
+            process.stdout.write('\n  🔮 Holmes-Kit Governance Harness Setup\n\n');
+            process.stdout.write('  ? Select the AI Agent harnesses to wire into this project:\n\n');
+            items.forEach((item, idx) => {
+                const isCurrent = idx === cursor;
+                const prefix = isCurrent ? '❯ ' : '  ';
+                let label = '';
+                let isChecked = false;
+                if (item === 'all') {
+                    isChecked = selected.size === availableAgents.length;
+                    label = '🌟 Select All (Recommended)';
+                }
+                else if (item === 'claude') {
+                    isChecked = selected.has('claude');
+                    label = '🤖 Claude Code          (.claude/settings.local.json, .mcp.json)';
+                }
+                else if (item === 'antigravity') {
+                    isChecked = selected.has('antigravity');
+                    label = '🚀 Antigravity CLI (AGY) (.agents/mcp_config.json, hooks.json, skills)';
+                }
+                else if (item === 'codex') {
+                    isChecked = selected.has('codex');
+                    label = '💻 Codex CLI            (.codex/mcp_config.json)';
+                }
+                const box = isChecked ? '[X]' : '[ ]';
+                const line = `${prefix}${box} ${label}\n`;
+                process.stdout.write(isCurrent ? `\x1B[36m${line}\x1B[0m` : line);
+            });
+            process.stdout.write('\n  Press <space> to toggle, <up/down> to navigate, <enter> to confirm\n');
+        };
+        const cleanup = () => {
+            if (process.stdin.isTTY) {
+                process.stdin.setRawMode(false);
+            }
+            rl.close();
+        };
+        const onKeypress = (_str, key) => {
+            if (key.name === 'up') {
+                cursor = (cursor - 1 + items.length) % items.length;
+                render();
+            }
+            else if (key.name === 'down') {
+                cursor = (cursor + 1) % items.length;
+                render();
+            }
+            else if (key.name === 'space') {
+                const target = items[cursor];
+                if (target === 'all') {
+                    if (selected.size === availableAgents.length) {
+                        selected.clear();
+                    }
+                    else {
+                        availableAgents.forEach((a) => selected.add(a));
+                    }
+                }
+                else {
+                    const agent = target;
+                    if (selected.has(agent)) {
+                        selected.delete(agent);
+                    }
+                    else {
+                        selected.add(agent);
+                    }
+                }
+                render();
+            }
+            else if (key.name === 'return' || key.name === 'enter') {
+                cleanup();
+                process.stdout.write('\n');
+                resolve(Array.from(selected));
+            }
+            else if (key.ctrl && key.name === 'c') {
+                cleanup();
+                process.exit(0);
+            }
+        };
+        process.stdin.on('keypress', onKeypress);
+        render();
+    });
+}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@holmes-lab/holmes-kit",
-  "version": "0.1.0",
+  "version": "0.1.2",
   "description": "Holmes-Kit — deterministic Agentic Software Engineering (ASE) harness with causal traceability (spec chain + D-CPG + RTM + phase guardrail)",
   "main": "dist/holmes/mcp/server.js",
   "bin": {
@@ -72,5 +72,8 @@
   "homepage": "https://github.com/snpark-io/holmes-kit#readme",
   "bugs": {
     "url": "https://github.com/snpark-io/holmes-kit/issues"
+  },
+  "publishConfig": {
+    "access": "public"
   }
 }

package/playbooks/publish/PLAYBOOK.md

@@ -0,0 +1,84 @@
+---
+name: holmes-publish
+description: >-
+  Use when asked to publish holmes-kit to NPM registry or run release workflow governed by
+  "HOLMES_APPROVAL", "hard-hitl", or "A-SPEC-133" with mandatory Human-In-The-Loop (HITL)
+  authorization by 박성남 그룹장님.
+---
+
+# holmes-publish — NPM 서버 배포 및 HITL 승인 절차
+
+이 플레이북은 `@holmes-lab/holmes-kit` 패키지를 NPM Registry에 안전하게 배포하기 위한 **5단계 규정 절차**를 정의합니다.
+배포 직전에는 반드시 **박성남 그룹장님**의 명시적 대역외 승인(HITL — Human-In-The-Loop)을 거쳐야만 실제 배포 명령어가 실행됩니다.
+
+---
+
+## 배포 5단계 절차 (5-Step Release Workflow)
+
+### 1단계: 사전 품질 감사 (Pre-flight Quality Audit)
+배포를 시작하기 전 코드베이스의 무결성과 타입 안전성을 검증합니다:
+1. `npm run typecheck` 실행 (타입 오류 0건 검증)
+2. `npm test` 실행 (전체 145+ 테스트 수트 100% PASS 검증)
+3. `npm run build` 실행 (`dist/` 최신 빌드 및 `.build-id` 생성)
+
+> [!IMPORTANT]
+> 단 하나의 테스트라도 실패하거나 타입 오류가 발생하면 즉시 배포 절차를 중단(Abort)합니다.
+
+---
+
+### 2단계: 패키지 타르볼 시뮬레이션 및 검수 (Tarball Inspection)
+NPM에 게시될 패키지 구성 요소를 사전 시뮬레이션하여 검수합니다:
+- `npm publish --dry-run` 실행
+- 출력된 타르볼 패키지 목록 검수:
+  - `package.json` (`@holmes-lab/holmes-kit` 명칭 및 버전 확인)
+  - `bin/` (`holmes-kit.js`, `holmes-mcp.js`, `holmes-hook-antigravity.js` 등)
+  - `dist/` (전체 컴파일 산출물)
+  - `playbooks/` (`adopt`, `author-slice`, `promote-slice`, `publish`)
+  - `CHANGELOG.md`, `README.md`
+
+---
+
+### 3단계: 필수 사람 승인 (Mandatory HITL Approval) — 보안 게이트
+**가장 중요한 보안 지점입니다.** AI Agent는 독단적으로 `npm publish`를 실행할 수 없으며, 반드시 **박성남 그룹장님**께 배포 요약을 보고하고 명시적 승인을 받아야 합니다.
+
+**[보고 양식]**:
+- **배포 패키지**: `@holmes-lab/holmes-kit`
+- **대상 버전**: `vX.Y.Z`
+- **테스트 결과**: PASS (100%)
+- **타르볼 파일 수 및 용량**: N개 / XXX kB
+
+> [!CAUTION]
+> **박성남 그룹장님**께서 승인을 내리지 않거나 거부 의사를 밝힌 경우, 즉시 배포 동작을 중단합니다.
+> 승인은 채팅을 통한 명시적 확인 또는 `HOLMES_APPROVAL` 환경변수를 통해 전달됩니다.
+
+---
+
+### 4단계: NPM 게시 실행 (NPM Publishing Execution)
+승인이 완료된 경우에만 실제 게시 명령을 수행합니다:
+```bash
+npm publish --access public
+```
+- 2FA / Web OTP 인증이 필요한 경우 터미널 인증 URL을 사용자에게 제공하고 대기합니다.
+
+---
+
+### 5단계: 배포 후 검증 및 Git 태깅 (Post-Release Verification)
+게시가 완료된 후 등록 상태를 최종 검증합니다:
+1. `npm view @holmes-lab/holmes-kit version` 실행하여 NPM Registry에 반영되었는지 확인
+2. Git 커밋 및 태그 생성:
+   ```bash
+   git add package.json
+   git commit -m "chore: release vX.Y.Z"
+   git tag -a vX.Y.Z -m "vX.Y.Z Release"
+   ```
+
+---
+
+## 플레이북 트리거 조건
+다음 요청 시 자동 트리거됩니다:
+- "npm publish"
+- "release to npm"
+- "HOLMES_APPROVAL"
+- "hard-hitl"
+- "A-SPEC-133"
+- "holmes-kit 배포해줘"