leerness 1.9.232 → 1.9.233

package/CHANGELOG.md

@@ -1,5 +1,43 @@
 # Changelog
 
+## 1.9.233 — 2026-05-23
+
+**📚 leerness commands 새 명령 (9 카테고리 51 CLI) + MCP 65번째 도구.**
+
+### 1. `leerness commands` 새 명령 — 카테고리화된 전체 CLI 목록
+- **9 카테고리 · 51 명령** 한 눈에:
+  - status (8) — handoff/health/pulse/round-history/milestones/session-resume/which/memory status
+  - task (5) — add/update/drop/export + next-action
+  - memory (4) — decision/rule/plan/lesson CRUD
+  - audit (10) — audit/drift/scan secrets/encoding/lazy/verify-claim/optimism/requests/pre-wake/idempotency
+  - workflow (7) — session close/resume/route/agents/review-request/review/brainstorm
+  - release (3) — sync-main/pack/publish
+  - skill (2) — list/info/learn/use/optimize/match/suggest + install/install-top/publish/search/discover
+  - bridge (3) — web/pc/lsp
+  - config (9) — init/migrate/update/wakeup-interval/workspace-dir/intent/constraints/provider/commands
+- `--json` 옵션 (외부 자동화)
+
+### 2. MCP 65번째 도구 — `leerness_commands`
+- 외부 AI 가 전체 CLI 목록을 직접 회수 → 매뉴얼/도움말 동적 생성
+- MCP 64 → 65 (+1)
+
+### 3. 실 측정 — leerness 전체 표면 가시화
+- 9 카테고리 × 평균 5.7 명령 = **51 CLI 명령**
+- handoff/health/pulse 등 핵심 status 명령은 status 카테고리에 그룹화
+
+### 4. 누적 회귀 (1.9.207~232) — 모두 유지
+
+### 5. stress-v178 — 16/16 PASS
+- 1.9.233 (6): VERSION + CLI + --json 카테고리 검증 + human 출력 + MCP 65 + 실 호출
+- 성능 (2): cold_start avg 413ms / commands 390ms (정적 데이터, 빠름)
+- 누적 회귀 (8): 1.9.207~232
+
+### 6. 자동 release (95 라운드 main-push streak · 56 라운드 npm publish streak)
+
+📚 **전체 표면 가시화** — 9 카테고리 × 51 CLI × 65 MCP 도구 한눈에
+
+---
+
 ## 1.9.232 — 2026-05-23
 
 **🐛 pulse memorySurface BUG fix + handoff --pulse 옵션 + session close 자동 pulse.**

package/README.md

@@ -2,7 +2,7 @@
 
 > **AI 코딩 에이전트의 거짓 완료·중복·망각·충돌을 막아주는 검수·기억·협업 CLI 하네스.**
 
-[![npm](https://img.shields.io/badge/npm-leerness-blue)](https://www.npmjs.com/package/leerness) [![version](https://img.shields.io/badge/version-1.9.232-green)]() [![tests](https://img.shields.io/badge/e2e-217%2F217-success)]() [![stress](https://img.shields.io/badge/stress--v177-13%2F13-success)]() [![mcp](https://img.shields.io/badge/MCP--tools-64-brightgreen)]() [![rounds](https://img.shields.io/badge/autonomous--rounds-188-blueviolet)]() [![main-push](https://img.shields.io/badge/release--main--push-94_rounds-success)]() [![goal-matrix](https://img.shields.io/badge/목적_매트릭스-100%2F100_(5축)-brightgreen)]() [![bugfix](https://img.shields.io/badge/🐛_pulse-BUG_fix-blueviolet)]() [![perf](https://img.shields.io/badge/cold_start-389ms-success)]() [![install](https://img.shields.io/badge/npm_i_leerness-즉시_사용_가능-success)]() [![sandbox](https://img.shields.io/badge/runCommandSafe-cwd_jail%2Benv_scrub-success)]() [![license](https://img.shields.io/badge/license-MIT-lightgrey)]()
+[![npm](https://img.shields.io/badge/npm-leerness-blue)](https://www.npmjs.com/package/leerness) [![version](https://img.shields.io/badge/version-1.9.233-green)]() [![tests](https://img.shields.io/badge/e2e-217%2F217-success)]() [![stress](https://img.shields.io/badge/stress--v178-16%2F16-success)]() [![mcp](https://img.shields.io/badge/MCP--tools-65-brightgreen)]() [![cli](https://img.shields.io/badge/CLI_commands-51-brightgreen)]() [![rounds](https://img.shields.io/badge/autonomous--rounds-189-blueviolet)]() [![main-push](https://img.shields.io/badge/release--main--push-95_rounds-success)]() [![goal-matrix](https://img.shields.io/badge/목적_매트릭스-100%2F100_(5축)-brightgreen)]() [![commands](https://img.shields.io/badge/📚_commands-9_카테고리_51_명령-blueviolet)]() [![perf](https://img.shields.io/badge/cold_start-413ms-success)]() [![license](https://img.shields.io/badge/license-MIT-lightgrey)]()
 
 ```
   ╔══════════════════════════════════════════════════════════════╗
@@ -12,9 +12,9 @@
   ║  ██║     ██╔══╝  ██╔══╝  ██╔══██╗██║╚██╗██║██╔══╝  ╚════██║  ║
   ║  ███████╗███████╗███████╗██║  ██║██║ ╚████║███████╗███████║  ║
   ║  ╚══════╝╚══════╝╚══════╝╚═╝  ╚═╝╚═╝  ╚═══╝╚══════╝╚══════╝  ║
-  ║  v1.9.232  AI Agent Reliability Harness + Sandbox            ║
+  ║  v1.9.233  AI Agent Reliability Harness + Sandbox            ║
   ║  verify · remember · orchestrate · audit · sandbox · drift   ║
-  ║  🐛 pulse BUG fix · handoff --pulse · session close 자동      ║
+  ║  📚 leerness commands · 9 카테고리 · 51 CLI · MCP 65          ║
   ╚══════════════════════════════════════════════════════════════╝
 ```
 

package/bin/harness.js

@@ -7,7 +7,7 @@ const cp = require('child_process');
 const os = require('os');  // 1.9.178: _publishToNpm 에서 os.tmpdir() 사용 (전역 import)
 const readline = require('readline');
 
-const VERSION = '1.9.232';
+const VERSION = '1.9.233';
 
 // 1.9.184: DEP0190 (child_process shell: true) deprecation warning 억제 (사용자 명시).
 //   leerness 는 cross-platform PATH resolution 을 위해 shell: true 를 의도적으로 사용 (claude.cmd / ollama.cmd 등 Windows .cmd 처리).
@@ -2278,6 +2278,114 @@ function pulseCmd(root) {
   log(dm(`  → 상세: leerness handoff . | health . | round-history | milestones`));
 }
 
+// 1.9.233: leerness commands — 카테고리화된 전체 CLI 명령 목록
+//   대화/AI/MCP/CI 가 빠르게 전체 기능을 파악할 수 있도록.
+//   카테고리: status (handoff/health/pulse/round-history/milestones/session-resume/which/memory status)
+//             task (task add/update/drop/export/sync)
+//             memory (decision/rule/plan/lesson add/list/drop)
+//             workflow (route/agents/orchestrate/review/persona)
+//             release (release pack/bump/note/publish/sync-main)
+//             audit (audit/scan secrets/encoding check/drift check/optimism-check/verify-claim/lazy detect)
+//             skill (skill list/info/learn/use/optimize/match/suggest/install/publish/discover)
+//             bridge (web/pc/lsp — opt-in)
+//             config (init/migrate/update/auto-update/setup-agents/install/workspace-dir/wakeup-interval)
+//             advanced (intent/requests/constraints/pre-wake-audit/idempotency/round-history/milestones/pulse)
+function commandsCmd(root) {
+  const isTty = process.stdout && process.stdout.isTTY;
+  const cy = s => isTty ? `\x1b[36m${s}\x1b[0m` : s;
+  const gr = s => isTty ? `\x1b[32m${s}\x1b[0m` : s;
+  const yl = s => isTty ? `\x1b[33m${s}\x1b[0m` : s;
+  const dm = s => isTty ? `\x1b[2m${s}\x1b[0m` : s;
+  const cats = {
+    status: [
+      { cmd: 'handoff [path] [--json] [--pulse] [--compact] [--quiet]', desc: '세션 시작 컨텍스트 + 7 통합 필드' },
+      { cmd: 'health [path] [--json] [--strict]', desc: '종합 헬스 + drift/security/skill/memory/featureGraph/roundHistory/milestones' },
+      { cmd: 'pulse [path] [--json]', desc: '한 줄 종합 요약 (1.9.231)' },
+      { cmd: 'round-history [path] [--json]', desc: 'git tag 기반 자율 라운드 통계 (1.9.226)' },
+      { cmd: 'milestones [path] [--json]', desc: '도달 마일스톤 + 다음 ETA (1.9.229)' },
+      { cmd: 'session-resume [path] [--auto-fix] [--json]', desc: '비정상 종료 감지 + 자율 재개 (1.9.220/222)' },
+      { cmd: 'which', desc: '활성 provider + 경로 진단' },
+      { cmd: 'memory status [path] [--json]', desc: 'T/D/R/P/L Memory Surface (1.9.114)' }
+    ],
+    task: [
+      { cmd: 'task add "<request>"', desc: 'task 추가 (자동 dedup 1.9.212, review trigger 1.9.177)' },
+      { cmd: 'task update <id> --status <S>', desc: 'task 상태 갱신' },
+      { cmd: 'task drop <id>', desc: 'task 드롭' },
+      { cmd: 'task export --to <path>', desc: 'TodoWrite JSON 형식 export (1.9.60)' },
+      { cmd: 'next-action take|list [--json]', desc: 'next-action queue (1.9.201)' }
+    ],
+    memory: [
+      { cmd: 'decision add|list|drop <id>', desc: 'decisions.md CRUD (1.9.108/118/125)' },
+      { cmd: 'rule add|list|pause|resume|remove', desc: 'rules.md CRUD (1.9.8/109)' },
+      { cmd: 'plan add|list <M-id>', desc: 'plan.md milestone CRUD (1.9.110/119)' },
+      { cmd: 'lesson save|list|drop', desc: 'lessons.md CRUD (1.9.112/117/124)' }
+    ],
+    audit: [
+      { cmd: 'audit [path] [--fix] [--strict] [--json]', desc: '메타 + 보안 + npm CVE 통합 감사' },
+      { cmd: 'drift check [path] [--auto-fix] [--json]', desc: 'drift 신호 + 자동 회복 (1.9.37/82/225)' },
+      { cmd: 'scan secrets [path]', desc: '시크릿 탐지' },
+      { cmd: 'encoding check [path]', desc: '인코딩 검증' },
+      { cmd: 'lazy detect [path] [--json]', desc: '게으른 작업 감지 (1.9.101)' },
+      { cmd: 'verify-claim <T-ID> [--run-tests] [--strict-claims]', desc: '주장 검증 (1.9.18~26)' },
+      { cmd: 'optimism-check <T-ID>', desc: '낙관적 API 감지 (1.9.26)' },
+      { cmd: 'requests audit|list|complete|drop|auto-complete', desc: '사용자 요청 추적 (1.9.207/223)' },
+      { cmd: 'pre-wake-audit [path] [--last]', desc: 'sleep 전 점검 (1.9.209)' },
+      { cmd: 'idempotency audit', desc: '멱등성 위반 탐지 (1.9.212)' }
+    ],
+    workflow: [
+      { cmd: 'session close [path] [--json] [--auto-apply-delivered]', desc: '세션 마감 + 9 카테고리 + 자동 통합' },
+      { cmd: 'resume [path]', desc: 'auto-resume-plan 적용 (1.9.203)' },
+      { cmd: 'route <task-type>', desc: '작업 유형 분류 (11종)' },
+      { cmd: 'agents list|check|quota|dispatch|multi', desc: '외부 AI CLI 오케스트레이션' },
+      { cmd: 'review-request "<request>"', desc: '사용자 요청 사전 검토 (1.9.176)' },
+      { cmd: 'review <file> --persona <ids>', desc: '페르소나 리뷰 (1.9.29)' },
+      { cmd: 'brainstorm "<topic>" [--include-code]', desc: '워크스페이스 회수 + 코드 grep' }
+    ],
+    release: [
+      { cmd: 'release sync-main [path]', desc: 'main merge + push + 자동 npm publish (1.9.140/178)' },
+      { cmd: 'release pack', desc: 'tarball 생성' },
+      { cmd: 'release publish', desc: 'GitHub release 발행' }
+    ],
+    skill: [
+      { cmd: 'skill list|info|learn|use|optimize|match|suggest', desc: 'skill 카탈로그 CRUD' },
+      { cmd: 'skill install|install-top|publish|search|discover', desc: 'skill 배포 + 검색' }
+    ],
+    bridge: [
+      { cmd: 'web check|screenshot|extract <url>', desc: 'playwright bridge (opt-in, 1.9.165)' },
+      { cmd: 'pc check|click|type|screenshot', desc: 'robotjs/nut-tree bridge (opt-in, 1.9.166)' },
+      { cmd: 'lsp check|symbols|references', desc: 'LSP 어댑터 (1.9.167)' }
+    ],
+    config: [
+      { cmd: 'init [path]', desc: '워크스페이스 초기화' },
+      { cmd: 'migrate [path] [--dry-run]', desc: '업데이트 마이그레이션' },
+      { cmd: 'update [--check|--yes|--force]', desc: '자가 업데이트' },
+      { cmd: 'wakeup-interval get|set|auto|history|record', desc: 'adaptive wakeup (1.9.210)' },
+      { cmd: 'workspace-dir get|guide', desc: '워크스페이스 디렉토리 (1.9.211)' },
+      { cmd: 'intent classify|expand|domains "<request>"', desc: '의도 파악 + scope (1.9.213)' },
+      { cmd: 'constraints list|check|add', desc: '플랫폼/API 제약 (1.9.208)' },
+      { cmd: 'provider list|add|remove|sync', desc: 'Provider Registry (1.9.157~160)' },
+      { cmd: 'commands [--json]', desc: '전체 명령 카테고리 목록 (1.9.233)' }
+    ]
+  };
+  if (has('--json')) {
+    log(JSON.stringify({ version: VERSION, totalCommands: Object.values(cats).reduce((s, a) => s + a.length, 0), categories: cats }, null, 2));
+    return;
+  }
+  log(cy(`# leerness commands (1.9.233) — 전체 CLI 명령 카테고리 목록`));
+  log('');
+  for (const [catName, list] of Object.entries(cats)) {
+    log(gr(`## ${catName} (${list.length}개)`));
+    list.forEach(c => {
+      log(`  • ${c.cmd}`);
+      log(dm(`    ${c.desc}`));
+    });
+    log('');
+  }
+  log(dm(`  → 총 ${Object.values(cats).reduce((s, a) => s + a.length, 0)} 명령 (9 카테고리)`));
+  log(dm(`  → MCP 도구: 65 (외부 AI 노출)`));
+  log(dm(`  → 빠른 시작: leerness pulse | handoff | health`));
+}
+
 function roundHistoryCmd(root) {
   root = absRoot(root);
   const isTty = process.stdout && process.stdout.isTTY;
@@ -14232,7 +14340,8 @@ function mcpServeCmd(root) {
     { name: 'leerness_requests_auto_complete', description: '1.9.224 (1.9.223 자동 회수) — delivered 패턴 자동 감지 + 자동 완료. "Round X.Y.Z — 구현 완료" / "implemented" / "delivered" 패턴이 있는 open 요청 중 현재 버전 이하인 것을 후보로 분류. 응답: { total, candidates: [{id, text, claimedVersion, currentVersion, deliveredKeyword, recordedAt}], currentVersion, applied (apply=true 시), completedIds[] }. 외부 AI가 "운영 누적된 가짜 미답 신호 정리 가능한가?"를 회수. 기본 dry-run, apply: true 명시 시에만 실 적용. 인자: { path?, apply? (default false) }', inputSchema: { type: 'object', properties: { path: { type: 'string' }, apply: { type: 'boolean' } } } },
     { name: 'leerness_round_history', description: '1.9.226 — 자율 라운드 통계. git tag v1.9.X 기반 누적 라운드 카운트 + 다음 마일스톤 (50/75/100/125/150/175/200/250/300/400/500) + 평균 rounds/day. 응답: { currentVersion, roundCount, baselineVersion, latestTags[], nextMilestone, roundsToNextMilestone, firstTagAt, latestTagAt, daysActive, avgRoundsPerDay }. 외부 AI가 "이 프로젝트는 얼마나 진행됐고 다음 마일스톤까지 몇 라운드 남았나?"를 회수. 인자: { path? }', inputSchema: { type: 'object', properties: { path: { type: 'string' } } } },
     { name: 'leerness_milestones', description: '1.9.229 (1.9.226 확장) — 도달 마일스톤 + 다음 ETA. git tag 순차 분석으로 25/50/75/100/125/150/175/200/250/300/400/500 마일스톤 도달 일자 + 다음 마일스톤 ETA (현재 속도 기준) 계산. 응답: { totalRounds, reached: [{milestone, version, reachedAt, daysFromBaseline}], next: {milestone, roundsRemaining, etaDays, etaDate}, baselineAt, avgRoundsPerDay }. 외부 AI가 "지금까지 어떤 마일스톤을 언제 달성했고 다음 마일스톤 예상 도달일은?"을 회수. 인자: { path? }', inputSchema: { type: 'object', properties: { path: { type: 'string' } } } },
-    { name: 'leerness_pulse', description: '1.9.231 — 한 줄 종합 요약 (10 핵심 지표). 응답: { version, roundCount, mcpTools, memorySurface, security, health, driftScore, nextMilestone, etaDays, abnormalShutdown }. 외부 AI가 "leerness 상태 한 눈에 보기"를 가벼운 단일 호출로 회수. handoff 보다 5배 빠름 (drift/health 계산 skip). 인자: { path? }', inputSchema: { type: 'object', properties: { path: { type: 'string' } } } }
+    { name: 'leerness_pulse', description: '1.9.231 — 한 줄 종합 요약 (10 핵심 지표). 응답: { version, roundCount, mcpTools, memorySurface, security, health, driftScore, nextMilestone, etaDays, abnormalShutdown }. 외부 AI가 "leerness 상태 한 눈에 보기"를 가벼운 단일 호출로 회수. handoff 보다 5배 빠름 (drift/health 계산 skip). 인자: { path? }', inputSchema: { type: 'object', properties: { path: { type: 'string' } } } },
+    { name: 'leerness_commands', description: '1.9.233 — 카테고리화된 전체 CLI 명령 목록 (9 카테고리). 응답: { version, totalCommands, categories: { status, task, memory, audit, workflow, release, skill, bridge, config } }. 외부 AI가 "leerness 가 제공하는 명령이 뭐가 있나"를 직접 회수. 매뉴얼/도움말 동적 생성. 인자: { path? }', inputSchema: { type: 'object', properties: { path: { type: 'string' } } } }
   ];
 
   function send(obj) {
@@ -14405,6 +14514,10 @@ function mcpServeCmd(root) {
             // 1.9.231: 한 줄 종합 요약 (10 핵심 지표)
             cliArgs = ['pulse', '--path', targetPath, '--json'];
             break;
+          case 'leerness_commands':
+            // 1.9.233: 카테고리화된 전체 CLI 명령 목록
+            cliArgs = ['commands', '--json'];
+            break;
           default:
             return send({ jsonrpc: '2.0', id, error: { code: -32601, message: `Unknown tool: ${name}` } });
         }
@@ -18064,6 +18177,8 @@ async function main() {
   if (cmd === 'milestones')                         return milestonesCmd(arg('--path', process.cwd()));
   // 1.9.231: leerness pulse — 한 줄 종합 요약 (10 핵심 지표)
   if (cmd === 'pulse')                              return pulseCmd(arg('--path', process.cwd()));
+  // 1.9.233: leerness commands — 카테고리화된 전체 CLI 명령 목록
+  if (cmd === 'commands')                           return commandsCmd(arg('--path', process.cwd()));
   // 1.9.208: leerness constraints <list|check|add> — 플랫폼/API 제약 사전 체크 (사용자 명시)
   if (cmd === 'constraints')                        return constraintsCmd(arg('--path', process.cwd()), args[1], ...args.slice(2));
   // 1.9.209: leerness pre-wake-audit — sleep 전 sub-agent audit (사용자 명시)

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "leerness",
-  "version": "1.9.232",
+  "version": "1.9.233",
   "description": "Leerness: 비파괴 마이그레이션, 자동 버전 감지·업데이트, 계획/진행/핸드오프 자동화, 게으름·시크릿·인코딩 자동 가드, Claude Code 슬래시 통합을 갖춘 한국어 우선 AI 개발 하네스.",
   "keywords": [
     "leerness",