leerness 1.36.28 → 1.36.30

package/CHANGELOG.md

@@ -1,5 +1,24 @@
 # Changelog
 
+## 1.36.30 — 2026-07-15 — 온톨로지 그래프 기본 활성 + roadmap 통합 + 기능 토글 (사용자 요청)
+
+`leerness.html`(온톨로지 그래프)가 **컨트롤 타워**가 된다: install/session-close 자동생성 대상이 roadmap.html → leerness.html 로 전환(기본 활성), roadmap 기능은 그래프 파일의 탭으로 통합, 그래프 뷰에서 leerness 기능(gate 등)을 토글.
+
+- **탭 3종**: 그래프(기존 force-directed) | **로드맵**(milestone 진행률바 + 상태별 task + skills/rules — roadmap.html 기능 흡수, 수동 `leerness roadmap` 은 호환 유지) | **⚙ 토글**(스위치 UI).
+- **`leerness toggle list|set <id> on|off`** + `.harness/toggles.json` — 레지스트리: `gate` / `lens` / `auto-graph` / `delegation-brief`. 기본 전부 ON.
+- **AI 준수 배선**: gate·lens 는 토글 OFF 시 "🎛 토글 OFF — 건너뜀" 명시 후 exit 0(조용한 무시 아님, --json 은 `skipped:true`) · `delegation-brief` OFF 면 dispatch/multi 가 브리프 미접두 · **handoff 헤드라인에 `🎛 토글 OFF: …` 노출** — AI 가 세션 시작 시 상태를 보고 준수.
+- **⚙ 탭 정직성**: 정적 HTML 은 파일 쓰기가 불가 — 스위치 클릭 시 적용 명령(`leerness toggle set …`)을 표시+복사 버튼으로 제공하고 UI 에 명시.
+- **canonical feature 그래프 인식** (codex 미검토표면 #9 편입): `leerness feature add/link` 가 만드는 `## F-XXXX` 블록을 그래프 노드/엣지로 렌더 — 종전엔 ad-hoc "A -> B" 라인만 파싱해 CLI 생성 그래프가 HTML 에 0 노드였다.
+- **검증**: selftest 300/300(토글 저장/로드+기본 ON+레지스트리 4종+HTML 탭·데이터·임베드 JS 문법+배선 5종), 실측 6종(init 자동생성 전환 / 탭 임베드 / toggle CLI / gate·lens 스킵 / handoff 🎛 / brief 토글 0↔1 / canonical feature 노드), 게이트 e2e, 게시본 클린룸.
+
+## 1.36.29 — 2026-07-15 — `agents multi` 위임 브리프 접두 — 백그라운드 AI 도 leerness 프로토콜을 받도록 (사용자 보고)
+
+사용자 질문("백그라운드에서 호출된 AI 가 leerness 를 참조하는가?")에 대한 조사 결과: `agents dispatch` 는 1.35.6 부터 "[leerness 위임 프로토콜]" 브리프(handoff 적재→task 등록→evidence→verify-claim→session close)를 자동 접두하지만, **`agents multi`(--execute 실 spawn 포함)는 원문 그대로 위임** — 병렬 백그라운드 AI 들이 프로토콜을 받지 못하는 실제 갭이었다.
+
+- **multi 3지점 브리프 접두**: `--execute` 실 spawn(`_cliChat`) + 명령 목록 출력 + `--json` commands. dispatch 와 동일 규칙(`--raw` 로 원문 위임). 로그/`_recordRun` 의 task 표시는 원문 유지(기록 정직성).
+- 참조 경로 정리(조사 확정): ① dispatch/multi 프롬프트 접두(이번에 완성) ② AGENTS.md 자동 로드(codex 실측 준수 — cwd 가 루트가 아니거나 미지원 CLI 면 무력해서 접두가 안전망) ③ orchestrate 는 자체 JSON 계약 컨텍스트 포함.
+- **검증**: selftest 299/299(브리프 4단계 + dispatch 와이어 + **multi 3지점 와이어**), 실측(multi 출력에 프로토콜 1회 포함 · `--raw` 0회), 게이트 e2e, 게시본 클린룸.
+
 ## 1.36.28 — 2026-07-15 — 미검토 표면 헌트: 데이터 유실 클래스(손상 스토어 클로버 · URL 덮어쓰기) + 정확성(impact 전이 · alias 경계)
 
 rotate-review-targets 교훈 적용 — 최근 잘 검토된 표면(lens/memory/plan/requests/skill)을 **제외**하고 미검토 표면(state/team/api-skill/wakeup/intent/feature)을 codex 로 QA 헌트. 10 findings 중 결정적 5건을 맹신 X(전부 재현) 후, 데이터 유실 클래스 + 저위험 순수 교정 4건을 수정. 동시성 3건(크로스프로세스 락)은 0-deps rabbit-hole 위험이라 정직하게 이연.

package/README.md

@@ -121,7 +121,7 @@ MIT
 <!-- leerness:project-readme:start -->
 ## Leerness Project Harness
 
-이 프로젝트는 Leerness v1.36.28 하네스를 사용합니다. AI 에이전트는 작업 전 `leerness handoff`로 컨텍스트를 적재하고, 작업 후 `leerness check`/`leerness audit`/`leerness session close`를 수행해야 합니다.
+이 프로젝트는 Leerness v1.36.30 하네스를 사용합니다. AI 에이전트는 작업 전 `leerness handoff`로 컨텍스트를 적재하고, 작업 후 `leerness check`/`leerness audit`/`leerness session close`를 수행해야 합니다.
 
 ### 정체성 — AI 에이전트 운영 레이어 (UR-0030)
 
@@ -175,7 +175,7 @@ leerness memory restore decision <date|title>
 
 ### MCP server (외부 AI 통합)
 
-Leerness v1.36.28는 stdio JSON-RPC MCP server를 내장합니다 — Claude Code · Cursor · Codex CLI 등 외부 AI에 **86개 도구**를 노출:
+Leerness v1.36.30는 stdio JSON-RPC MCP server를 내장합니다 — Claude Code · Cursor · Codex CLI 등 외부 AI에 **86개 도구**를 노출:
 
 ```jsonc
 // 카테고리별
@@ -196,7 +196,7 @@ Leerness v1.36.28는 stdio JSON-RPC MCP server를 내장합니다 — Claude Cod
 `<<autonomous-loop-dynamic>>` 신호만 보내면 AI가:
 1) 다음 라운드 후보 선정 → 2) 코드 변경 → 3) stress-v* 신규 작성 + 누적 회귀 → 4) e2e 219/219 → 5) npm pack + git tag + GitHub release → 6) main 자동 push → 7) session close → 8) 다음 라운드 예약.
 
-현재 누적: **70 라운드 (1.9.40 → 1.36.28)** · 매 라운드 GitHub release/태그 생성 · _reports/는 비공개 보존.
+현재 누적: **70 라운드 (1.9.40 → 1.36.30)** · 매 라운드 GitHub release/태그 생성 · _reports/는 비공개 보존.
 
 ### 성능 가이드
 
@@ -234,6 +234,6 @@ leerness release pack --close --auto-main-push
 - `.harness/session-handoff.md`: 다음 세션 인수인계 (자동 작성)
 - `.harness/lessons.md` / `decisions.md` / `rules.md`: 영구 메모리 (5 surface)
 
-Last synced by Leerness v1.36.28: 2026-07-15
+Last synced by Leerness v1.36.30: 2026-07-15
 <!-- leerness:project-readme:end -->
 

package/bin/leerness.js

@@ -34,7 +34,7 @@ const { CAPABILITY_SURFACE, POWERFUL_COMMANDS, ADAPTERS, REUSE_CATEGORIES, REUSE
 const { tokenizeForRank: _tokenizeForRank, expandQuery: _expandQuery, scoreHits: _scoreHits, suggestTerms: _suggestTerms } = require('../lib/search-core');  // 1.36.23: memory search 랭킹 코어(순수·0-deps)
 const { findCorruptedStateJson: _findCorruptedStateJson } = require('../lib/state-integrity');  // 1.36.1 (클린룸 리뷰 FN): .harness/*.json 상태 무결성 (audit/health/check 공유)
 
-const VERSION = '1.36.28';
+const VERSION = '1.36.30';
 
 // 1.9.290 (UR-0037, Codex gpt-5.5 #4 수렴): CLI 전용 부작용은 require 시 실행하지 않는다.
 //   이전: warning listener 제거 / NODE_OPTIONS 변경 / chcp IIFE 가 top-level 즉시 실행 → require('harness') 시 호스트 프로세스 오염.
@@ -2949,10 +2949,14 @@ function _selfTestCases() {
       const briefOk = typeof b === 'string' && b.includes('leerness handoff .') && b.includes('task add') && b.includes('verify-claim') && b.includes('session close') && b.includes('--evidence') && !b.includes('`') && !b.includes('$') && !b.includes('"');
       // (2) dispatch 와이어: lib/agents.js 가 --raw 옵트아웃으로 브리프를 접두하고, DI 로 _harnessBrief 를 받음.
       const agentsSrc = read(path.join(__dirname, '..', 'lib', 'agents.js'));
-      const wired = /has\('--raw'\)[\s\S]{0,120}_harnessBrief\(\) \+ task/.test(agentsSrc) && /_harnessBrief,/.test(read(__filename));
+      const wired = /has\('--raw'\)[\s\S]{0,120}_harnessBrief\(\) \+ task/.test(agentsSrc) && read(__filename).includes("_harnessBrief: _tgl.toggleOn(root, 'delegation-brief')");   // 1.36.30: delegation-brief 토글 연동 형태 (리터럴 매치)
       // (3) bench stdin hang 수정: codex exec 가 열린 stdin 파이프에서 EOF 대기(실측) → spawn stdio ignore.
       const stdinFixed = agentsSrc.includes("{ shell: true, stdio: ['ignore', 'pipe', 'pipe'] }");
-      return briefOk && wired && stdinFixed;
+      // (4) 1.36.29 (사용자 보고): multi 도 브리프 접두 — --execute 실 spawn(_cliChat) + 명령 목록/JSON 3지점 전부 briefTask.
+      const multiWired = agentsSrc.includes('_cliChat(root, def.id, briefTask,')
+        && agentsSrc.includes('_dispatchCommand(x.def.id, briefTask, writeMode)')
+        && agentsSrc.includes('_dispatchCommand(def.id, briefTask, writeMode)');
+      return briefOk && wired && stdinFixed && multiWired;
     } },
     { name: '19th GPT5.5평가 (UR-0013): _parseTestStdout 러너 인식(jest/tap/spec/비율) + declared-pass 부풀림 3경로 게이팅 + json ok/reasons (1.35.7)', run: () => {
       // (1) 파서 행위: 기존 4형식 보존 + spec 리포터(패턴 6) 신규 — denom = pass + fail.
@@ -3068,6 +3072,37 @@ function _selfTestCases() {
       const owOk = p._managedMerge('x.md', next, prev, '.', new Set(['x.md'])) === next;
       return survived && idem && legacyOk && cleanOk && owOk;
     } },
+    { name: '온톨로지 그래프 통합+토글 (1.36.30, 사용자 요청): 탭 3종(그래프/로드맵/⚙)+기본 자동생성 전환+toggle CLI+gate/lens/brief 준수 — 행위검사', run: () => {
+      const tg = require('../lib/toggles');
+      if (typeof tg.toggleCmd !== 'function' || typeof tg.loadToggles !== 'function') return false;
+      const regOk = ['gate', 'lens', 'auto-graph', 'delegation-brief'].every(k => !!tg.TOGGLE_REGISTRY[k]);
+      const tmp = fs.mkdtempSync(path.join(os.tmpdir(), '__leerness_tgl_'));
+      let behavOk = false, htmlOk = false;
+      try {
+        fs.mkdirSync(path.join(tmp, '.harness'), { recursive: true });
+        // 토글 저장/로드 행위 + 기본 ON
+        const d0 = tg.loadToggles(tmp);
+        const defOn = Object.values(d0).every(v => v === true);
+        tg.saveToggles(tmp, Object.assign({}, d0, { gate: false }));
+        const offOk = tg.loadToggles(tmp).gate === false && tg.toggleOn(tmp, 'lens') === true;
+        behavOk = defOn && offOk;
+        // 그래프 HTML: 탭 3종 + roadmap/toggles 데이터 + 임베드 JS 문법
+        const m = require('../lib/graph');
+        const out = path.join(tmp, 'leerness.html');
+        m.graphHtmlCmd(tmp, { _roadmapData, _loadDecisions, _loadLessons, _parseFeatureGraph, _loadToggles: tg.loadToggles, _toggleRegistry: tg.TOGGLE_REGISTRY, quiet: true }, out);
+        const html = fs.readFileSync(out, 'utf8');
+        const o = '<scr' + 'ipt>', c = '</scr' + 'ipt>';
+        const js = html.slice(html.indexOf(o) + o.length, html.lastIndexOf(c));
+        let synOk = false; try { new Function(js); synOk = true; } catch {}
+        htmlOk = html.includes('data-v="roadmap"') && html.includes('data-v="toggles"') && html.includes('toggleRegistry') && synOk;
+      } catch { behavOk = false; } finally { try { fs.rmSync(tmp, { recursive: true, force: true }); } catch {} }
+      // 배선 소스가드: 자동생성이 leerness.html(온톨로지)로 전환 + gate/lens 토글 준수 + toggle dispatch
+      const s = read(__filename);
+      const wired = s.includes('온톨로지 그래프 자동 갱신 (' + '${trigger})')
+        && s.includes("_tgl.toggleOn(root, 'gate')") && s.includes("_tgl.toggleOn(root, 'lens')")
+        && s.includes("cmd === 'toggle'") && s.includes("_tgl.toggleOn(root, 'delegation-brief')");
+      return regOk && behavOk && htmlOk && wired;
+    } },
     { name: 'debug 렌즈 (1.36.27, obra/superpowers systematic-debugging): 자기질문 6문항 ko/en 락스텝 + affects 유효 + route bugfix 힌트 + 파일매핑 미확장 — 행위검사', run: () => {
       const d = LENS_CATALOG.debug;
       if (!d) return false;
@@ -4438,7 +4473,7 @@ function _selfTestCases() {
       const rowsEn = sc.includes("t('- 없음', '- none')") && sc.includes('_retroOneLine(agg, uiLang)');
       const retroEn = bin.includes('function _retroOneLine(agg, lang)') && bin.includes('`done ${done}/${total}') && bin.includes('decisions ${agg.decisionBlocks} accumulated');
       const roadmapEn = bin.includes('roadmap.html auto-updated (${trigger})');
-      const koPreserved = bin.includes('완료 ${done}/${total}') && bin.includes('roadmap.html 자동 갱신 (${trigger})') && sc.includes("t('- 없음', '- none')");  // ko 인자 보존
+      const koPreserved = bin.includes('완료 ${done}/${total}') && bin.includes('온톨로지 그래프 자동 갱신 (${trigger})') && sc.includes("t('- 없음', '- none')");  // ko 인자 보존
       return rowsEn && retroEn && roadmapEn && koPreserved;
     } },
     { name: 'CLI 영어화 Phase 9 (1.25.2, UR-0010): health 진단 영어/한국어 보존 + uiLang 주입 (소스 가드)', run: () => {
@@ -5400,6 +5435,11 @@ function lensCmd(domain, opts = {}) {
   if (domain != null) domain = String(domain).trim().toLowerCase();
   // 1.19.3: 내장 + 프로젝트 커스텀(.harness/quality-lenses.json) 병합 catalog.
   const root = opts.root || arg('--path', process.cwd());
+  // 1.36.30: 토글 준수 (⚙ 탭 / leerness toggle set lens off)
+  if (!_tgl.toggleOn(root, 'lens')) {
+    if (jsonMode) { log(JSON.stringify({ ok: true, skipped: true, reason: 'toggle_off', hint: 'leerness toggle set lens on' })); return; }
+    log('🎛 lens 토글 OFF — 건너뜀 (재활성: leerness toggle set lens on)'); return;
+  }
   const L = _uiLang(root); const t = (ko, en) => (L === 'en' ? en : ko);  // 1.24.2 (UR-0010 Phase 8): lens 영어 opt-in
   const catalog = _effectiveLensCatalog(root);
   if (domain && !catalog[domain]) {
@@ -7871,6 +7911,7 @@ function _saveTeams(root, teams) {
 // 1.9.389 (UR-0025 큰 핸들러 모듈화 2번째): teamCmd 핸들러를 lib/team.js 로 분리.
 //   harness 는 deps(VERSION · 공유 저장 _loadTeams/_saveTeams · _detectShellCtx · argv 파서 arg/has)를 구성해 위임(thin wrapper). 호출부/동작 무변경.
 const _team = require('../lib/team');
+const _tgl = require('../lib/toggles');   // 1.36.30: 기능 토글 (그래프 ⚙ 탭 연동 — gate/lens/auto-graph/delegation-brief)
 function teamCmd(root, sub, id, opts = {}) { return _team.teamCmd(root, sub, id, opts, { VERSION, _loadTeams, _saveTeams, _detectShellCtx, arg, has }); }
 
 // 1.9.112: 전용 lessons.md (Memory Write Surface 5번째)
@@ -9688,6 +9729,12 @@ function handoff(root) {
         else if (briefGap) parts.push(t('📋 project-brief 미작성', '📋 project-brief unfilled'));
         else if (planGap) parts.push(t('📋 plan Goal 미작성', '📋 plan Goal unfilled'));
       } catch {}
+      // 1.36.30: 기능 토글 OFF 헤드라인 — AI 가 이 상태를 보고 해당 기능을 스킵 준수 (그래프 ⚙ 탭과 동일 상태)
+      try {
+        const _tgs = _tgl.loadToggles(root);
+        const _offs = Object.keys(_tgs).filter(k => _tgs[k] === false);
+        if (_offs.length) parts.push(t(`🎛 토글 OFF: ${_offs.join(',')}`, `🎛 toggles OFF: ${_offs.join(',')}`));
+      } catch {}
       // 3) MCP 활동 누적
       try {
         const stats = _readUsageStats(root);
@@ -13569,7 +13616,7 @@ function _dispatchCommand(agentId, task, writeMode, model) {
 
 const _agents = require('../lib/agents');
 // 1.9.424 (UR-0025/UR-0125 큰 핸들러 모듈화 9번째): agentsCmd → lib/agents.js (DI 위임, rest→array)
-function agentsCmd(root, sub, ...args) { return _agents.agentsCmd(root, sub, args, { VERSION, has, arg, _agentSlashHint, _allProviders, _checkAgent, _cliChat, _dispatchCommand, _harnessBrief, _loadEnvFile, _normalizeRole, _policyEnforce, _readUserProviders, _recommendAgent, _recordRun, _resolveRole, _shellQuoteArg, lessonsPath, taskLogPath }); }
+function agentsCmd(root, sub, ...args) { return _agents.agentsCmd(root, sub, args, { VERSION, has, arg, _agentSlashHint, _allProviders, _checkAgent, _cliChat, _dispatchCommand, _harnessBrief: _tgl.toggleOn(root, 'delegation-brief') ? _harnessBrief : undefined, _loadEnvFile, _normalizeRole, _policyEnforce, _readUserProviders, _recommendAgent, _recordRun, _resolveRole, _shellQuoteArg, lessonsPath, taskLogPath }); }   // 1.36.30: delegation-brief 토글 OFF 면 브리프 미접두(=--raw 경로)
 
 function personaCmd(root, sub, idOrName, ...rest) {
   root = absRoot(root || process.cwd());
@@ -13762,7 +13809,12 @@ async function selfCheck(root) {
 // 1.9.2: 게이트 5종 한번에 실행 (verify + audit + scan secrets + encoding check + lazy detect).
 function gate(root) {
   root = absRoot(root);
-  const jsonMode = has('--json');  // 외부리뷰 C2: --json 일관성 — 이전엔 텍스트 헤더+단계별 JSON 혼재로 파싱 불가. 단일 객체로 집계.
+  const jsonMode = has('--json');
+  // 1.36.30: 토글 준수 — 그래프 ⚙ 탭/`leerness toggle set gate off` 시 스킵을 명시하고 exit 0 (조용한 무시 아님).
+  if (!_tgl.toggleOn(root, 'gate')) {
+    if (jsonMode) { log(JSON.stringify({ ok: true, skipped: true, reason: 'toggle_off', hint: 'leerness toggle set gate on' })); return; }
+    log('🎛 gate 토글 OFF — 건너뜀 (재활성: leerness toggle set gate on)'); return;
+  }  // 외부리뷰 C2: --json 일관성 — 이전엔 텍스트 헤더+단계별 JSON 혼재로 파싱 불가. 단일 객체로 집계.
   const checks = [];
   let bad = 0;
   // 1.33.3 (verify-claim+CI gate 슬라이스 강화): --claims opt-in — 모든 done 주장을 정밀 per-claim 검증(verify-claim --all)으로 추가(6번째). 기본 5체크는 무변경(기존 어댑터 회귀 0).
@@ -14867,11 +14919,14 @@ function _autoRoadmap(root, trigger) {
     const cfg = _autoRoadmapConfig(root);
     if (!cfg.enabled) return false;
     if (trigger === 'data-change' && !cfg.onEveryChange) return false;
-    const outFile = path.resolve(cfg.outFile || path.join(root, 'roadmap.html'));
-    const data = _roadmapData(root);
-    writeUtf8(outFile, _roadmapHTML(data));
-    const _en = _uiLang(root) === 'en';  // 1.24.1 (UR-0010): roadmap 로그 en
-    log(_en ? `✓ roadmap.html auto-updated (${trigger}) — ${rel(root, outFile)}` : `✓ roadmap.html 자동 갱신 (${trigger}) — ${rel(root, outFile)}`);
+    // 1.36.30 (사용자 요청): 자동 생성 대상을 roadmap.html → leerness.html(온톨로지 그래프 + 로드맵 탭 통합)로 전환.
+    //   roadmap.html 기능은 그래프 파일의 "로드맵" 탭에 통합됨. 수동 `leerness roadmap` 은 호환 유지.
+    //   토글 auto-graph OFF 시 생성 안 함(⚙ 탭/`leerness toggle`).
+    if (!_tgl.toggleOn(root, 'auto-graph')) return false;
+    const outFile = path.resolve(cfg.outFile || path.join(root, 'leerness.html'));
+    const s = _graph.graphHtmlCmd(root, { _roadmapData, _loadDecisions, _loadLessons, _parseFeatureGraph, _loadToggles: _tgl.loadToggles, _toggleRegistry: _tgl.TOGGLE_REGISTRY, quiet: true }, outFile);
+    const _en = _uiLang(root) === 'en';
+    log(_en ? `✓ ontology graph auto-updated (${trigger}) — ${rel(root, outFile)} (graph+roadmap+toggles)` : `✓ 온톨로지 그래프 자동 갱신 (${trigger}) — ${rel(root, outFile)} (그래프+로드맵+토글 탭)`);
     return true;
   } catch (e) {
     warn((_uiLang(root) === 'en' ? 'roadmap auto-update failed: ' : 'roadmap 자동 갱신 실패: ') + (e && e.message ? e.message : e));
@@ -21190,14 +21245,14 @@ function doctorCmd(opts = {}) { return _diag.doctorCmd(opts, { VERSION, uiLang:
 function whichCmd() { return _diag.whichCmd({ VERSION, uiLang: _uiLang(arg('--path', process.cwd())), has, harnessPath: __filename }); }
 // 1.34.3 (T-0077): `graph --html` → lib/graph.js 온톨로지 HTML(leerness.html) 생성기 위임. 데이터는 in-process 로더 주입(자식 프로세스 셸링 X).
 const _graph = require('../lib/graph');
-function graphHtmlCmd(root) { return _graph.graphHtmlCmd(root, { _roadmapData, _loadDecisions, _loadLessons, has, arg }); }
+function graphHtmlCmd(root) { return _graph.graphHtmlCmd(root, { _roadmapData, _loadDecisions, _loadLessons, _parseFeatureGraph, _loadToggles: _tgl.loadToggles, _toggleRegistry: _tgl.TOGGLE_REGISTRY, has, arg }); }   // 1.36.30: 로드맵 탭 + ⚙ 토글 탭 + canonical feature
 // 1.34.4 (T-0077 후속): handoff 시 leerness.html 자동 재생성 — opt-in(LEERNESS_AUTO_GRAPH=1, 기본 OFF / "Always-Off Opt-In"). 사용자 비전 "자동으로 작성되게" 충족. 비치명(try/catch) · 기본경로 무영향.
 function _maybeAutoGraph(root) {
   if (process.env.LEERNESS_AUTO_GRAPH !== '1') return;
   try {
     const r0 = absRoot(root || process.cwd());
     if (!exists(path.join(r0, '.harness'))) return;
-    const s = _graph.graphHtmlCmd(r0, { _roadmapData, _loadDecisions, _loadLessons, quiet: true });
+    const s = _graph.graphHtmlCmd(r0, { _roadmapData, _loadDecisions, _loadLessons, _parseFeatureGraph, _loadToggles: _tgl.loadToggles, _toggleRegistry: _tgl.TOGGLE_REGISTRY, quiet: true });
     if (!has('--json') && !has('--quiet') && !has('--compact')) log(`📊 ontology graph auto-regenerated: leerness.html (${s.nodes} nodes · ${s.edges} links) — LEERNESS_AUTO_GRAPH=1`);  // --json 출력 오염 방지
   } catch {}
 }
@@ -21546,6 +21601,7 @@ async function main() {
   if (cmd === 'milestones')                         return milestonesCmd(_resolveRoot(args[1]));
   // 1.9.231: leerness pulse — 한 줄 종합 요약 (10 핵심 지표)
   if (cmd === 'pulse')                              return pulseCmd(_resolveRoot(args[1]));
+  if (cmd === 'toggle')                            return _tgl.toggleCmd(arg('--path', process.cwd()), args[1], args[2], args[3], { has, VERSION });   // 1.36.30: 기능 토글 (그래프 ⚙ 탭 연동)
   if (cmd === 'lens')                               return lensCmd(args[1]);  // 1.18.3 (UR-0003): 분야별 자기질문 품질 렌즈
   // 1.9.233: leerness commands — 카테고리화된 전체 CLI 명령 목록
   if (cmd === 'commands')                           return commandsCmd(arg('--path', process.cwd()));

package/lib/agents.js

@@ -74,6 +74,9 @@ function agentsCmd(root, sub, args = [], deps = {}) {
   if (sub === 'multi') {
     const task = _taskArg();
     if (!task) { fail('multi "<task>" 또는 --task 필요'); return process.exit(1); }
+    // 1.36.29 (사용자 보고): dispatch 만 위임 브리프를 접두하고 multi(--execute 실 spawn 포함)는 원문 그대로 위임돼
+    //   백그라운드 AI 가 leerness 프로토콜(handoff 적재/task 등록/evidence/session close)을 받지 못했다. dispatch 와 동일 규칙: --raw 로 옵트아웃.
+    const briefTask = (has('--raw') || typeof _harnessBrief !== 'function') ? task : (_harnessBrief() + task);
     const onlyArg = arg('--only', null);  // 'claude,codex' 처럼 콤마 구분 — 활성 중에서 추가 필터
     const writeMode = has('--write');
     const execute = has('--execute');  // 1.9.156: 명령 출력 → 실제 spawn + consensus 합의
@@ -109,7 +112,7 @@ function agentsCmd(root, sub, args = [], deps = {}) {
         // 병렬 _cliChat 호출 (sandbox 자동: runCommandSafe + env scrub + observability)
         const results = await Promise.all(ready.map(async ({ def }) => {
           const start = Date.now();
-          const r = await _cliChat(root, def.id, task, { timeout });
+          const r = await _cliChat(root, def.id, briefTask, { timeout });
           return {
             agent: def.id,
             elapsed: Date.now() - start,
@@ -203,7 +206,7 @@ function agentsCmd(root, sub, args = [], deps = {}) {
       log(JSON.stringify({
         task, count: ready.length,
         agents: ready.map(x => ({ id: x.def.id, version: x.status.version })),
-        commands: ready.map(x => _dispatchCommand(x.def.id, task, writeMode)),
+        commands: ready.map(x => _dispatchCommand(x.def.id, briefTask, writeMode)),
         // 1.9.266 (UR-0021 2단계): 각 에이전트 슬래시 명령 힌트 — sub-agent 가 알맞은 슬래시 사용
         slashCommands: ready.reduce((acc, x) => { const h = _agentSlashHint(root, x.def.id); if (h) acc[x.def.id] = { invoke: h.invoke, commands: h.commands.map(c => c.cmd) }; return acc; }, {})
       }, null, 2));
@@ -219,7 +222,7 @@ function agentsCmd(root, sub, args = [], deps = {}) {
     for (const { def, status } of ready) {
       log(`### [${def.id}]  (v${status.version || '?'})`);
       log('```sh');
-      log(_dispatchCommand(def.id, task, writeMode));
+      log(_dispatchCommand(def.id, briefTask, writeMode));
       log('```');
       // 1.9.266 (UR-0021 2단계): 에이전트별 슬래시 명령 힌트
       try {

package/lib/graph.js

@@ -39,9 +39,33 @@ canvas{position:fixed;inset:0;top:46px}
 #panel .x{position:absolute;top:12px;right:14px;color:var(--mut);cursor:pointer;font-size:16px}
 #hint{position:fixed;bottom:12px;left:16px;color:var(--mut);font-size:11px;opacity:.7}
 #empty{position:fixed;inset:0;display:none;place-items:center;color:var(--mut);text-align:center}
+#tabs{display:flex;gap:2px;border:1px solid var(--line);border-radius:8px;padding:2px}
+.tab{padding:4px 12px;border-radius:6px;cursor:pointer;font-size:11px;color:var(--mut);user-select:none}
+.tab.on{background:#1a2230;color:#fff}
+.view{position:fixed;inset:0;top:46px;overflow:auto;background:var(--bg);display:none;padding:22px 26px;z-index:5}
+.view.on{display:block}
+.ms{border:1px solid var(--line);border-radius:10px;padding:14px 16px;margin:0 0 12px;background:var(--panel)}
+.ms h3{margin:0 0 8px;font-size:13px;color:#fff}
+.bar{height:7px;border-radius:5px;background:#1a2230;overflow:hidden;margin:6px 0}
+.bar i{display:block;height:100%;background:var(--brand)}
+.tk{display:flex;gap:8px;align-items:baseline;padding:3px 0;font-size:12px}
+.tk .st{width:86px;flex:none;font-size:10px;text-transform:uppercase;letter-spacing:.04em}
+.sec{color:var(--mut);font-size:11px;text-transform:uppercase;letter-spacing:.07em;margin:20px 0 8px}
+.tgrow{display:flex;align-items:center;gap:14px;border:1px solid var(--line);border-radius:10px;padding:14px 16px;margin:0 0 10px;background:var(--panel)}
+.sw2{position:relative;width:40px;height:22px;flex:none;border-radius:100px;background:#30363d;cursor:pointer;transition:background .15s}
+.sw2.on{background:var(--brand)}
+.sw2 i{position:absolute;top:3px;left:3px;width:16px;height:16px;border-radius:50%;background:#fff;transition:left .15s}
+.sw2.on i{left:21px}
+.tgname{font-weight:700;color:#fff;width:150px;flex:none}
+.tgdesc{color:var(--mut);font-size:11px;flex:1}
+.cmd{display:none;margin-top:8px;background:#0b0f14;border:1px solid var(--line);border-radius:7px;padding:8px 10px;font-size:11px;color:#7ee787}
+.cmd.show{display:flex;align-items:center;gap:10px}
+.cmd button{background:#1a2230;border:1px solid var(--line);color:var(--txt);border-radius:5px;padding:3px 9px;cursor:pointer;font:inherit;font-size:10px}
+.note{color:var(--mut);font-size:11px;margin:14px 0 18px;line-height:1.6}
 </style></head><body>
 <div id="bar">
   <div class="ttl"><span class="dot"></span><span id="proj">leerness</span><span style="color:var(--mut);font-weight:400">/ ontology</span></div>
+  <div id="tabs"><span class="tab on" data-v="graph">그래프</span><span class="tab" data-v="roadmap">로드맵</span><span class="tab" data-v="toggles">⚙ 토글</span></div>
   <span class="stat" id="stat"></span>
   <input id="search" placeholder="search nodes…" autocomplete="off">
   <div id="chips"></div>
@@ -50,6 +74,8 @@ canvas{position:fixed;inset:0;top:46px}
 <div id="panel"><span class="x" onclick="closePanel()">✕</span><div id="pbody"></div></div>
 <div id="empty">No nodes — run <b>leerness handoff .</b> to populate the harness, then regenerate.</div>
 <div id="hint">drag node · scroll zoom · drag bg pan · click node → details · search+Enter jump · f / dblclick fit · p export PNG · Esc close</div>
+<div id="vroadmap" class="view"></div>
+<div id="vtoggles" class="view"></div>
 <script>
 var DATA = /*__DATA__*/null;
 var COLORS={task:'#58a6ff',plan:'#d29922',decision:'#39d0d8',lesson:'#e3b341',rule:'#bc8cff',skill:'#2dd4bf',feature:'#6e7681'};
@@ -144,6 +170,55 @@ document.getElementById('search').addEventListener('keydown',function(ev){ if(ev
 function exportPng(){ try{ var t=document.createElement('canvas'); t.width=cv.width; t.height=cv.height; var tx=t.getContext('2d'); tx.fillStyle='#0a0d12'; tx.fillRect(0,0,t.width,t.height); tx.drawImage(cv,0,0); var a=document.createElement('a'); a.download='leerness-graph.png'; a.href=t.toDataURL('image/png'); a.click(); }catch(e){} }
 window.addEventListener('keydown',function(ev){ if(ev.target&&ev.target.tagName==='INPUT')return; if(ev.key==='f'||ev.key==='F'){_fit=true;fitView();} else if(ev.key==='p'||ev.key==='P'){exportPng();} else if(ev.key==='Escape'){closePanel();} });
 cv.addEventListener('dblclick',function(ev){ if(!hit(ev.offsetX,ev.offsetY)){_fit=true;fitView();} });
+
+// ── 탭 (1.36.30): 그래프 | 로드맵 | ⚙ 토글 ──
+var _views={roadmap:document.getElementById('vroadmap'),toggles:document.getElementById('vtoggles')};
+document.querySelectorAll('.tab').forEach(function(t){t.onclick=function(){
+  document.querySelectorAll('.tab').forEach(function(x){x.classList.toggle('on',x===t);});
+  var v=t.getAttribute('data-v');
+  Object.keys(_views).forEach(function(k){_views[k].classList.toggle('on',k===v);});
+  document.getElementById('hint').style.display=(v==='graph')?'':'none';
+  if(v!=='graph')closePanel();
+};});
+
+// 로드맵 뷰 — DATA.roadmap (roadmap.html 기능 통합)
+(function(){
+  var rd=(DATA&&DATA.roadmap)||{};var el=_views.roadmap;var h='';
+  var ms=rd.milestones||[],tk=rd.tasks||[];
+  h+='<div class="sec">Milestones ('+ms.length+')</div>';
+  if(!ms.length)h+='<div class="note">milestone 없음 — leerness plan add "제목" 으로 추가</div>';
+  ms.forEach(function(m){var pg=parseInt(m.progress,10)||0;
+    h+='<div class="ms"><h3>'+esc(m.id)+' · '+esc(m.title)+' <span style="color:var(--mut);font-weight:400">'+esc(m.status||'')+' '+pg+'%</span></h3>'
+      +'<div class="bar"><i style="width:'+Math.min(100,pg)+'%"></i></div>'
+      +(m.nextAction?'<div style="color:var(--mut);font-size:11px">next: '+esc(m.nextAction)+'</div>':'')+'</div>';});
+  var byS={};tk.forEach(function(t){(byS[t.status||'requested']=byS[t.status||'requested']||[]).push(t);});
+  h+='<div class="sec">Tasks ('+tk.length+')</div>';
+  ['in-progress','blocked','waiting','planned','requested','done','verified'].forEach(function(s){var arr=byS[s];if(!arr||!arr.length)return;
+    h+='<div class="ms"><h3 style="color:'+(STATUSCOL[s]||'#8b949e')+'">'+s+' ('+arr.length+')</h3>';
+    arr.slice(0,40).forEach(function(t){h+='<div class="tk"><span class="st" style="color:'+(STATUSCOL[s]||'#8b949e')+'">'+esc(t.id)+'</span><span>'+esc(t.request)+'</span></div>';});
+    if(arr.length>40)h+='<div class="note">… +'+(arr.length-40)+'</div>';h+='</div>';});
+  if(rd.skills&&rd.skills.length){h+='<div class="sec">Skills ('+rd.skills.length+')</div><div class="ms">'+rd.skills.map(function(s){return '<div class="tk"><span>'+esc(s.name||s.id||s)+'</span></div>';}).join('')+'</div>';}
+  if(rd.rules&&rd.rules.length){h+='<div class="sec">Active Rules</div><div class="ms">'+rd.rules.filter(function(r){return r.status==='active';}).map(function(r){return '<div class="tk"><span>'+esc(r.rule||r.text||'')+'</span></div>';}).join('')+'</div>';}
+  el.innerHTML=h;
+})();
+
+// ⚙ 토글 뷰 — DATA.toggles (생성 시점 상태). 정적 파일이라 실제 적용은 CLI — 스위치 클릭 시 적용 명령 표시+복사.
+(function(){
+  var tg=(DATA&&DATA.toggles)||{};var reg=(DATA&&DATA.toggleRegistry)||{};var el=_views.toggles;
+  var h='<div class="note">스위치를 누르면 적용 명령이 나타납니다 — 이 파일은 정적 HTML 이라 <b>실제 적용은 아래 명령을 터미널(또는 AI)에게 실행</b>시키세요. AI 는 handoff 헤드라인의 🎛 상태를 자동 준수합니다.</div>';
+  Object.keys(reg).forEach(function(id){var on=tg[id]!==false;var m=reg[id]||{};
+    h+='<div class="tgrow" id="tg-'+id+'"><div class="sw2'+(on?' on':'')+'" onclick="tgFlip(\''+id+'\')"><i></i></div>'
+      +'<div class="tgname">'+esc(id)+'</div><div class="tgdesc">'+esc(m.desc||'')+'<br><span style="opacity:.7">영향: '+esc(m.affects||'')+'</span>'
+      +'<div class="cmd" id="cmd-'+id+'"><span id="cmdtext-'+id+'"></span><button onclick="tgCopy(\''+id+'\')">복사</button></div></div></div>';});
+  el.innerHTML=h;
+  window._tg=tg;
+  window.tgFlip=function(id){var cur=window._tg[id]!==false;var nv=!cur;window._tg[id]=nv;
+    var row=document.getElementById('tg-'+id);row.querySelector('.sw2').classList.toggle('on',nv);
+    var c=document.getElementById('cmd-'+id);c.classList.add('show');
+    document.getElementById('cmdtext-'+id).textContent='leerness toggle set '+id+' '+(nv?'on':'off');};
+  window.tgCopy=function(id){var t=document.getElementById('cmdtext-'+id).textContent;
+    try{navigator.clipboard.writeText(t);}catch(e){var ta=document.createElement('textarea');ta.value=t;document.body.appendChild(ta);ta.select();document.execCommand('copy');ta.remove();}};
+})();
 </script></body></html>`;
 
 const _txt = v => (v == null ? '' : String(v));
@@ -190,17 +265,40 @@ function buildGraphData(root, deps = {}) {
   const fg = path.join(root, '.harness', 'feature-graph.md');
   if (exists(fg)) {
     try {
-      for (const line of read(fg).split(/\r?\n/)) {
+      const fgText = read(fg);
+      for (const line of fgText.split(/\r?\n/)) {
         const m = line.match(/([\w./-]+)\s*(?:->|→|depends on|uses)\s*([\w./-]+)/i);
         if (m) { const a = 'feat:' + m[1], b = 'feat:' + m[2]; add({ id: a, type: 'feature', status: '', label: _trunc(m[1], 40), detail: { feature: m[1] } }); add({ id: b, type: 'feature', status: '', label: _trunc(m[2], 40), detail: { feature: m[2] } }); linkIds(a, b, 'feature'); }
       }
+      // 1.36.30 (codex 미검토표면 #9): CLI 가 생성하는 canonical 형식(## F-XXXX 블록 + depends-on/affects 필드)도 인식.
+      //   종전엔 ad-hoc "A -> B" 라인만 파싱해 leerness feature add/link 로 만든 그래프가 HTML 에 0 노드였다.
+      if (typeof deps._parseFeatureGraph === 'function') {
+        const pf = deps._parseFeatureGraph(fgText) || [];
+        for (const f of pf) {
+          add({ id: f.id, type: 'feature', status: f.status || '', label: _trunc(f.title || f.id, 48), detail: { title: _txt(f.title), status: _txt(f.status), files: (f.files || []).join(', '), errorModes: (f.errorModes || []).join(', ') } });
+        }
+        for (const f of pf) {
+          for (const d of f.dependsOn || []) linkIds(f.id, d, 'feature');
+          for (const a of f.affects || []) linkIds(f.id, a, 'feature');
+          for (const c of f.coChangesWith || []) linkIds(f.id, c, 'feature');
+        }
+      }
     } catch {}
   }
 
   for (const n of nodes) delete n._ms;  // 내부 보조 필드 임베드 제외
   const counts = {};
   for (const n of nodes) counts[n.type] = (counts[n.type] || 0) + 1;
-  return { project: rd.project || path.basename(root), version: rd.version || '', root, counts, nodes, edges };
+  // 1.36.30: 로드맵 탭 데이터(roadmap.html 기능 통합) + 토글 상태(⚙ 탭) 임베드.
+  const roadmap = {
+    milestones: (rd.milestones || []).map(m => ({ id: m.id, title: _trunc(m.title, 90), status: m.status, progress: m.progress, nextAction: _trunc(m.nextAction, 120) })),
+    tasks: (rd.tasks || []).map(t => ({ id: t.id, request: _trunc(t.request, 110), status: t.status })),
+    skills: (rd.skills || []).map(s => ({ name: _trunc(s.name || s.id || s, 60) })),
+    rules: (rd.rules || []).map(r => ({ rule: _trunc(r.rule || r.text || '', 110), status: r.status })),
+  };
+  const toggles = (typeof deps._loadToggles === 'function' ? deps._loadToggles(root) : {}) || {};
+  const toggleRegistry = deps._toggleRegistry || {};
+  return { project: rd.project || path.basename(root), version: rd.version || '', root, counts, nodes, edges, roadmap, toggles, toggleRegistry };
 }
 
 // `leerness graph --html [path] [--out file] [--json]` 핸들러.

package/lib/toggles.js

@@ -0,0 +1,70 @@
+// lib/toggles.js — 기능 토글 (1.36.30, 사용자 요청): 온톨로지 그래프 뷰의 스위치와 연동되는 기능 on/off 스토어.
+//   .harness/toggles.json 에 저장. AI/CLI 는 여기 상태를 읽어 준수한다(gate/lens 스킵, 위임 브리프 생략, 자동 그래프).
+//   설계: 기본 전부 ON(파일 없으면 결손 아님). 손상 파일은 SAVE 시 덮어쓰기 거부(1.36.28 _assertStoreParsable 패턴).
+'use strict';
+const path = require('path');
+const { absRoot, exists, read, writeUtf8, mkdirp, log, ok, fail } = require('./io');
+
+// 토글 레지스트리 — id: { ko 설명, 영향 명령 }. 새 토글은 여기에 추가.
+const TOGGLE_REGISTRY = {
+  'gate': { desc: '완료 게이트 (verify+audit+scan+encoding+lazy 통합 점검)', affects: 'leerness gate' },
+  'lens': { desc: '품질 렌즈 자기질문 (완료 선언 전 분야별 점검)', affects: 'leerness lens' },
+  'auto-graph': { desc: '온톨로지 그래프(leerness.html) 자동 갱신 (install/session-close)', affects: 'install · session close' },
+  'delegation-brief': { desc: '백그라운드 AI 위임 시 leerness 프로토콜 브리프 자동 접두', affects: 'agents dispatch · agents multi' },
+};
+
+function _togglesPath(root) { return path.join(absRoot(root), '.harness', 'toggles.json'); }
+
+// 전체 토글 상태 로드 — 파일 없으면 전부 기본 ON. 손상 파일은 읽기에선 기본값(비변경 경로 resilient).
+function loadToggles(root) {
+  const out = {};
+  for (const id of Object.keys(TOGGLE_REGISTRY)) out[id] = true;
+  const f = _togglesPath(root);
+  if (!exists(f)) return out;
+  try {
+    const j = JSON.parse(read(f));
+    for (const [k, v] of Object.entries(j || {})) if (k in out) out[k] = v !== false;
+  } catch {}
+  return out;
+}
+
+// 단일 토글 조회 헬퍼 — 호출부 한 줄용.
+function toggleOn(root, id) { return loadToggles(root)[id] !== false; }
+
+function saveToggles(root, toggles) {
+  const f = _togglesPath(root);
+  // 1.36.28 패턴: 손상 파일 덮어쓰기 거부 — 단 토글은 전량 기본값 복원 가능하니 손상 시 재생성 허용이 사용자 친화적.
+  // (여기의 데이터는 bool 4개뿐 — 유실 비용이 0 에 가깝고, 거부하면 토글 자체가 잠긴다. 의도적 예외.)
+  mkdirp(path.dirname(f));
+  writeUtf8(f, JSON.stringify(toggles, null, 2) + '\n');
+}
+
+// `leerness toggle [list|set <id> on|off] [--json]`
+function toggleCmd(root, sub, id, val, deps = {}) {
+  const { has, VERSION } = deps;
+  root = absRoot(root);
+  const json = has && has('--json');
+  const cur = loadToggles(root);
+  if (!sub || sub === 'list') {
+    if (json) { log(JSON.stringify({ version: VERSION, toggles: cur, registry: TOGGLE_REGISTRY }, null, 2)); return; }
+    log(`# leerness toggle — 기능 토글 (온톨로지 그래프 뷰 ⚙ 탭과 연동)`);
+    for (const [k, meta] of Object.entries(TOGGLE_REGISTRY)) {
+      log(`  ${cur[k] ? '🟢 ON ' : '⚪ OFF'}  ${k.padEnd(17)} ${meta.desc}  [${meta.affects}]`);
+    }
+    log(`\n  변경: leerness toggle set <id> on|off  ·  그래프 뷰: leerness graph --html → leerness.html 의 ⚙ 탭`);
+    return;
+  }
+  if (sub === 'set') {
+    if (!TOGGLE_REGISTRY[id]) { fail(`알 수 없는 토글: ${id} (가능: ${Object.keys(TOGGLE_REGISTRY).join(', ')})`); process.exitCode = 1; return; }
+    const on = String(val).toLowerCase();
+    if (on !== 'on' && on !== 'off') { fail(`값은 on|off (받음: ${val})`); process.exitCode = 1; return; }
+    cur[id] = on === 'on';
+    saveToggles(root, cur);
+    if (json) { log(JSON.stringify({ ok: true, id, value: cur[id], toggles: cur }, null, 2)); return; }
+    ok(`toggle ${id} = ${on.toUpperCase()}${cur[id] ? '' : ' — 관련 명령이 스킵 동작으로 전환됩니다'}`);
+    return;
+  }
+  fail(`알 수 없는 하위명령: ${sub} (가능: list, set)`); process.exitCode = 1;
+}
+
+module.exports = { TOGGLE_REGISTRY, loadToggles, toggleOn, saveToggles, toggleCmd, _togglesPath };

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "leerness",
-  "version": "1.36.28",
+  "version": "1.36.30",
   "description": "The AI-coding operations layer that makes \"done\" require evidence — persistent memory, evidence-gated completion checks, and clean handoffs for any AI agent (Claude Code, Codex, Cursor). State lives as plain files in your repo. CLI + MCP, 0 runtime dependencies.",
   "keywords": [
     "leerness",