leerness 1.36.29 → 1.36.31

package/CHANGELOG.md

@@ -1,5 +1,26 @@
 # Changelog
 
+## 1.36.31 — 2026-07-15 — 동시성 직렬화 — 병렬 에이전트의 lost update 차단 (codex 미검토표면 헌트 이연분 #1/#2/#5/#7)
+
+1.36.28 헌트에서 이연했던 동시성 P1 계열. 기존 `_withLock`(원자 배타 생성 + stale 회수 + 재진입 안전)을 재사용 — 새 락 발명 아님.
+
+- **#1 P1 — 병렬 `state start` run 유실/충돌**: 두 병렬 start 가 같은 run-0001 을 배정해 한쪽 goal 이 덮이거나 EPERM 크래시(codex 12-trial 실측 6~9/12 발화). → stateCmd 변경 sub(start/record/verify/handoff) 전체를 state.json 락으로 직렬화(load→카운터→run 저장→state 저장이 한 임계구역). 실측: 병렬 8 start → run 파일 8/8·고유 goal 8/8·EPERM 0.
+- **#2 P1 — 병렬 `team add` 무성 유실**: 20 병렬 add 전부 exit 0 인데 16 팀만 잔존(4건 무성 소실). → 락 안 재로드→중복검사→추가→저장 + Windows 일시 EPERM(락 밖 병렬 읽기가 파일을 잠깐 여는 사이 원자 rename 실패) 소규모 재시도. 실측: **20/20 잔존 ×2회**.
+- **#5 P2 — record↔handoff 경합 stale handoff**: 같은 state.json 락으로 함께 직렬화. 실측 6-trial 에러 0.
+- **#7 P2 — pre-wake-audit 테이블형 in-progress 미인식**: `status: in-progress`(YAML형)만 매치해 CLI 가 생성하는 canonical 테이블(`| T-XXXX | in-progress |`)을 못 봄 — session-resume 과 동일 정규식 추가(YAML형 호환 유지). 실측: 3일 stale 테이블 픽스처에서 `stale-in-progress` 감지.
+- **검증**: selftest 301/301, codex 원 재현 스크립트 재실행(4건 전부 ✓, #2 는 2회 반복), 게이트 e2e, 게시본 클린룸. 이로써 1.36.28 헌트 10건 중 **9건 처리**(잔여: state 손상 시 quarantine 심화 — 저가치).
+
+## 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 들이 프로토콜을 받지 못하는 실제 갭이었다.

package/README.md

@@ -121,7 +121,7 @@ MIT
 <!-- leerness:project-readme:start -->
 ## Leerness Project Harness
 
-이 프로젝트는 Leerness v1.36.29 하네스를 사용합니다. AI 에이전트는 작업 전 `leerness handoff`로 컨텍스트를 적재하고, 작업 후 `leerness check`/`leerness audit`/`leerness session close`를 수행해야 합니다.
+이 프로젝트는 Leerness v1.36.31 하네스를 사용합니다. 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.29는 stdio JSON-RPC MCP server를 내장합니다 — Claude Code · Cursor · Codex CLI 등 외부 AI에 **86개 도구**를 노출:
+Leerness v1.36.31는 stdio JSON-RPC MCP server를 내장합니다 — Claude Code · Cursor · Codex CLI 등 외부 AI에 **86개 도구**를 노출:
 
 ```jsonc
 // 카테고리별
@@ -196,7 +196,7 @@ Leerness v1.36.29는 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.29)** · 매 라운드 GitHub release/태그 생성 · _reports/는 비공개 보존.
+현재 누적: **70 라운드 (1.9.40 → 1.36.31)** · 매 라운드 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.29: 2026-07-15
+Last synced by Leerness v1.36.31: 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.29';
+const VERSION = '1.36.31';
 
 // 1.9.290 (UR-0037, Codex gpt-5.5 #4 수렴): CLI 전용 부작용은 require 시 실행하지 않는다.
 //   이전: warning listener 제거 / NODE_OPTIONS 변경 / chcp IIFE 가 top-level 즉시 실행 → require('harness') 시 호스트 프로세스 오염.
@@ -2949,7 +2949,7 @@ 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'] }");
       // (4) 1.36.29 (사용자 보고): multi 도 브리프 접두 — --execute 실 spawn(_cliChat) + 명령 목록/JSON 3지점 전부 briefTask.
@@ -3072,6 +3072,52 @@ 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: '동시성 직렬화 (1.36.31, codex #1/#2/#5/#7): state 변경 락 + team add 락내 재로드 + EPERM 재시도 + pre-wake 테이블 매처 — 소스가드+행위', run: () => {
+      const s = read(__filename);
+      // #1/#5: stateCmd 변경 sub 가 state.json 락으로 재귀 직렬화 (재진입 가드 포함 — 무한재귀 방지 형태)
+      const stateLock = s.includes("const _mut = ['start', 'record', 'verify', 'handoff'].includes(sub || '')")
+        && s.includes("_withLock(path.join(_leernessStateDir(root), 'state.json'), () => stateCmd(root, sub, ...args))")
+        && s.includes("!_heldLocks.has(path.join(_leernessStateDir(root), 'state.json') + '.lock')");
+      // #2: team add 가 락 안 재로드→중복검사→저장 + EPERM 재시도
+      const teamSrc = read(path.join(path.dirname(__filename), '..', 'lib', 'team.js'));
+      const teamLock = teamSrc.includes('const cur = _loadTeams(root);') && teamSrc.includes("deps._withLock(require('path').join(root, '.harness', 'teams.json'), _doAdd)") && teamSrc.includes("e.code === 'EPERM'");
+      const teamWired = s.includes('_detectShellCtx, arg, has, _withLock }');
+      // #7: pre-wake 매처가 테이블형+YAML형 모두 (행위)
+      const both = ('| T-0001 | in-progress | x |\nstatus: in-progress\n'.match(/^\|\s*T-\d{4,}\s*\|\s*in-progress\s*\|/gm) || []).length === 1;
+      const pwWired = /_runPreWakeAudit[\s\S]{0,2200}\^\\\|\\s\*T-\\d\{4,\}\\s\*\\\|\\s\*in-progress/.test(s);
+      return stateLock && teamLock && teamWired && both && pwWired;
+    } },
     { 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;
@@ -4442,7 +4488,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: () => {
@@ -5404,6 +5450,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]) {
@@ -5698,7 +5749,10 @@ function _runPreWakeAudit(root) {
       const stat = fs.statSync(ptPath);
       const ageMin = Math.floor((Date.now() - stat.mtimeMs) / 60000);
       // in-progress 태그가 있는데 24h+ 갱신 없음
-      const inProgressCount = (content.match(/status:\s*in-progress/gi) || []).length;
+      // 1.36.31 (codex 미검토표면 #7): CLI 가 생성하는 canonical 테이블형(| T-XXXX | in-progress |)을 못 보던 매처 —
+      //   session-resume 의 테이블 정규식과 동일하게 인식(구 YAML 형도 호환 유지).
+      const inProgressCount = (content.match(/^\|\s*T-\d{4,}\s*\|\s*in-progress\s*\|/gm) || []).length
+        + (content.match(/status:\s*in-progress/gi) || []).length;
       if (inProgressCount > 0 && ageMin > 24 * 60) {
         audit.findings.warning.push({
           kind: 'stale-in-progress',
@@ -7875,7 +7929,8 @@ 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');
-function teamCmd(root, sub, id, opts = {}) { return _team.teamCmd(root, sub, id, opts, { VERSION, _loadTeams, _saveTeams, _detectShellCtx, arg, has }); }
+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, _withLock }); }   // 1.36.31: add 경합 락
 
 // 1.9.112: 전용 lessons.md (Memory Write Surface 5번째)
 const lessonsPath = root => path.join(root, '.harness/lessons.md');
@@ -9692,6 +9747,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);
@@ -13573,7 +13634,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());
@@ -13766,7 +13827,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).
@@ -14871,11 +14937,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));
@@ -18941,6 +19010,13 @@ function contextCmd(root, opts = {}) {
 }
 function stateCmd(root, sub, ...args) {
   root = absRoot(root || process.cwd());
+  // 1.36.31 (codex 미검토표면 #1/#5): 변경 sub 는 state.json 락으로 전체 직렬화 — 병렬 start 가 같은 run-0001 을
+  //   배정/덮어쓰거나(카운터 lost update), record↔handoff 경합으로 stale handoff 가 나오던 것을 차단.
+  //   load→카운터→run 저장→state 저장이 한 임계구역. _withLock 은 재진입 안전 + stale 락 자동 회수.
+  const _mut = ['start', 'record', 'verify', 'handoff'].includes(sub || '');
+  if (_mut && !_heldLocks.has(path.join(_leernessStateDir(root), 'state.json') + '.lock')) {
+    return _withLock(path.join(_leernessStateDir(root), 'state.json'), () => stateCmd(root, sub, ...args));
+  }
   const json = has('--json');
   sub = sub || 'show';
 
@@ -21194,14 +21270,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 {}
 }
@@ -21550,6 +21626,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/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/team.js

@@ -42,8 +42,24 @@ function teamCmd(root, sub, id, opts = {}, deps = {}) {
       status: 'active',
       createdAt: now()
     };
-    teams.push(team);
-    _saveTeams(root, teams);
+    // 1.36.31 (codex 미검토표면 #2): 병렬 team add 가 서로의 등록을 덮어쓰던 lost update — 락 안에서 재로드→중복검사→추가→저장.
+    const _doAdd = () => {
+      const cur = _loadTeams(root);
+      if (cur.some(t => t.id === teamId)) { warn(`이미 존재: ${teamId} (제거 후 재정의: leerness team remove ${teamId})`); return false; }
+      cur.push(team);
+      // Windows: 락 밖의 병렬 _loadTeams 읽기가 파일을 잠깐 열어둔 사이 원자 rename 이 EPERM(일시적) — 짧은 재시도.
+      let _lastErr = null;
+      for (let k = 0; k < 4; k++) {
+        try { _saveTeams(root, cur); _lastErr = null; break; }
+        catch (e) { _lastErr = e; if (e && e.code === 'EPERM') { const t0 = Date.now(); while (Date.now() - t0 < 25) {} continue; } throw e; }
+      }
+      if (_lastErr) throw _lastErr;
+      return true;
+    };
+    const _added = (typeof deps._withLock === 'function')
+      ? deps._withLock(require('path').join(root, '.harness', 'teams.json'), _doAdd)
+      : _doAdd();
+    if (!_added) return;
     ok(`team 정의: ${teamId} (personas:${team.personas.length} members:${team.members.length} schedule:${team.schedule} review:${team.review ? 'on' : 'off'})`);
     log(`  ⓘ 정의 전용 — 자동 실행 없음. 목록: leerness team list`);
     return;

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "leerness",
-  "version": "1.36.29",
+  "version": "1.36.31",
   "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",