leerness 1.9.332 → 1.9.334

package/CHANGELOG.md

@@ -1,5 +1,39 @@
 # Changelog
 
+## 1.9.334 — 2026-06-05 — UR-0025(심층): intent-도메인 서브시스템 분리 (Codex 위임·검증)
+
+**🤖 남은 백로그 일부를 Codex CLI(gpt-5.5)에 위임하고 독립 검증까지 완료 — intent-도메인 서브시스템의 핵심(데이터 catalog + 순수 매처)을 1.9.333 constraints 패턴 그대로 모듈로 분리.** (사용자 지시: "남은 백로그 일부는 codex cli를 호출해서 업무 할당하고 검증까지 진행")
+
+### 배경 (위임 결정)
+직전 1.9.333 에서 확립한 "서브시스템 핵심(데이터·순수 로직) 추출" 패턴이 안정적으로 반복 가능 → 동형(同型) 작업인 intent-도메인 추출을 Codex CLI 에 위임. 위임 ≠ 무검증: 작업 명세를 backtick-free 파일로 작성 → `codex exec` 호출 → 결과를 하네스가 **독립 검증**(범위·금지파일·구문·selftest·동작·중복) 후 릴리스 확정.
+
+### 구현 (Codex 수행)
+1. **`_DEFAULT_DOMAIN_CATALOG`**(5도메인 catalog) → `lib/catalogs.js`(export 추가).
+2. **`_matchDomain(catalog, text)`**(순수 매처: text 소문자에 alias substring 포함되는 첫 도메인 → `{domain, alias, components}`, 없으면 `{domain:null}`) → `lib/pure-utils.js`. `_detectDomain(text, root)` = `_matchDomain(_loadDomainCatalog(root), text)`.
+
+### 검증 (하네스 독립)
+- **변경 범위 확인**: `bin/harness.js` + `lib/catalogs.js` + `lib/pure-utils.js` 만 변경 (VERSION/e2e/README/CHANGELOG/package.json 미변경 — 명세 금지사항 준수).
+- **무결성**: `node -c` 통과 · selftest 82/82 PASS · **E2E 279/279 PASS** (회귀 0).
+- **동작 실측**: `_matchDomain` game/web/null/no-match 정상 · intent expand("domain: game") 회귀 정상 · catalog 중복 없음 · exports 정상.
+- **테스트 견고화**: import 멤버십 체크(B 1.9.333/1.9.334)를 rigid 정규식 → importBlock 추출 패턴으로 통일 (이후 import 추가에 비의존).
+
+## 1.9.333 — 2026-06-05 — UR-0025(심층): constraints 서브시스템 핵심 분리
+
+**🧩 constraints 서브시스템의 핵심(데이터 catalog + 순수 매처)을 모듈로 분리 — command 서브시스템 추출의 안전한 첫 단계.** (사용자 선택: UR-0025 심층)
+
+### 배경 (방향 결정)
+순수 함수 micro-추출 소진 → 사용자가 "command 서브시스템 심층 추출"을 선택. command 함수의 factory+deps 주입은 **새 패턴 도입**(결정매트릭스: 기존 패턴 유지·안정성 우선)이라 위험 → **phase 1은 서브시스템의 핵심(데이터·순수 로직)을 기존 모듈 패턴으로 추출**, fs/command 박막은 harness 유지.
+
+### 구현 (UR-0025 심층 phase 1)
+1. **`_DEFAULT_PLATFORM_CONSTRAINTS`**(6플랫폼 제약 catalog, ~57줄) → `lib/catalogs.js`(기존 정적 데이터 모듈).
+2. **`_matchConstraints(catalog, text)`**(순수 매칭: 플랫폼 alias 매칭 + 제안) → `lib/pure-utils.js`. `_checkRequestConstraints(root, text)` = `_matchConstraints(_loadPlatformConstraints(root), text)` (fs load 만 주입).
+3. selftest 80→81 · e2e 277→278.
+
+### 검증
+- **selftest 81/81 PASS** · **E2E 278/278 PASS** (회귀 0).
+- 실측: catalog 6플랫폼 · `_matchConstraints(cat, 'stripe 결제')`→matched stripe/total 6 · `(null,…)`→빈 결과 · constraints check + review-request(_checkRequestConstraints) 정상.
+- 비고: command 함수(constraintsCmd) 자체의 lib 이전은 factory 패턴 필요 → 별도 결정. 핵심 데이터·로직은 분리·테스트화 완료.
+
 ## 1.9.332 — 2026-06-05 — UR-0025(증분): lessons.md 파서 분리
 
 **🧩 순수 lessons.md 파서(`_parseLessonEntries`)를 lib/pure-utils 로 이전 (인라인 파싱 → 재사용 가능 단일 출처).** (UR-0025 micro-증분 계속)

package/README.md

@@ -3,7 +3,7 @@
 > **AI 코딩 에이전트의 거짓 완료·중복·망각·충돌을 막아주는 검수·기억·협업 CLI 하네스.**
 > **A CLI harness that stops AI coding agents from faking completion, duplicating work, forgetting context, and colliding.**
 
-[![npm](https://img.shields.io/badge/npm-leerness-blue)](https://www.npmjs.com/package/leerness) [![version](https://img.shields.io/badge/version-1.9.332-green)]() [![tests](https://img.shields.io/badge/e2e-277%2F277-success)]() [![selftest](https://img.shields.io/badge/selftest-80-success)]() [![mcp](https://img.shields.io/badge/MCP--tools-83-brightgreen)]() [![providers](https://img.shields.io/badge/AI_providers-10-brightgreen)]() [![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.334-green)]() [![tests](https://img.shields.io/badge/e2e-279%2F279-success)]() [![selftest](https://img.shields.io/badge/selftest-82-success)]() [![mcp](https://img.shields.io/badge/MCP--tools-83-brightgreen)]() [![providers](https://img.shields.io/badge/AI_providers-10-brightgreen)]() [![license](https://img.shields.io/badge/license-MIT-lightgrey)]()
 
 ```
   ╔══════════════════════════════════════════════════════════════╗
@@ -471,7 +471,7 @@ MIT — © leerness contributors
 <!-- leerness:project-readme:start -->
 ## Leerness Project Harness
 
-이 프로젝트는 Leerness v1.9.332 하네스를 사용합니다. AI 에이전트는 작업 전 `leerness handoff`로 컨텍스트를 적재하고, 작업 후 `leerness check`/`leerness audit`/`leerness session close`를 수행해야 합니다.
+이 프로젝트는 Leerness v1.9.334 하네스를 사용합니다. AI 에이전트는 작업 전 `leerness handoff`로 컨텍스트를 적재하고, 작업 후 `leerness check`/`leerness audit`/`leerness session close`를 수행해야 합니다.
 
 ### 정체성 — AI 에이전트 운영 레이어 (UR-0030)
 
@@ -525,7 +525,7 @@ leerness memory restore decision <date|title>
 
 ### MCP server (외부 AI 통합)
 
-Leerness v1.9.332는 stdio JSON-RPC MCP server를 내장합니다 — Claude Code · Cursor · Codex CLI 등 외부 AI에 **83개 도구**를 노출:
+Leerness v1.9.334는 stdio JSON-RPC MCP server를 내장합니다 — Claude Code · Cursor · Codex CLI 등 외부 AI에 **83개 도구**를 노출:
 
 ```jsonc
 // 카테고리별
@@ -546,7 +546,7 @@ Leerness v1.9.332는 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 (1.9.140+) → 7) session close → 8) 다음 라운드 예약.
 
-현재 누적: **70 라운드 (1.9.40 → 1.9.332)** · 매 라운드 GitHub release/태그 생성 · _reports/는 비공개 보존.
+현재 누적: **70 라운드 (1.9.40 → 1.9.334)** · 매 라운드 GitHub release/태그 생성 · _reports/는 비공개 보존.
 
 ### 성능 가이드 (1.9.140 측정)
 
@@ -584,6 +584,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.9.332: 2026-06-05
+Last synced by Leerness v1.9.334: 2026-06-05
 <!-- leerness:project-readme:end -->
 

package/bin/harness.js

@@ -16,13 +16,13 @@ const { _isSecretKey, compareVer, parseHarnessVersion, _classifyCJK, _riskLabel,
   _roadmapMapStatus, _roadmapParseMilestones, _roadmapParseTokens,
   _BRIEF_FIELDS, _briefFilled,
   BRIEF_START, BRIEF_END, _briefReadmeBlock, _briefBlueprint,
-  _parseLessonEntries } = require('../lib/pure-utils');  // 1.9.318~332 (UR-0025): 순수 유틸 모듈 분리
+  _parseLessonEntries, _matchConstraints, _matchDomain } = require('../lib/pure-utils');  // 1.9.318~333 (UR-0025): 순수 유틸 모듈 분리
 // 1.9.304 (UR-0025): 순수 분석/검증 함수 모듈 분리.
 const { _evidenceQuality, _parseEvidenceStats, _shellGuardAnalyze, _claimFileInGit, _epistemicHonestyCheck } = require('../lib/analyzers');
 // 1.9.295 (UR-0025 4단계): 정적 데이터 카탈로그 모듈 분리 (비파괴, require-based).
-const { CAPABILITY_SURFACE, POWERFUL_COMMANDS, ADAPTERS, REUSE_CATEGORIES, REUSE_CHECKLIST } = require('../lib/catalogs');
+const { CAPABILITY_SURFACE, POWERFUL_COMMANDS, ADAPTERS, REUSE_CATEGORIES, REUSE_CHECKLIST, _DEFAULT_PLATFORM_CONSTRAINTS, _DEFAULT_DOMAIN_CATALOG } = require('../lib/catalogs');  // 1.9.333 (UR-0025): constraints catalog 분리
 
-const VERSION = '1.9.332';
+const VERSION = '1.9.334';
 
 // 1.9.290 (UR-0037, Codex gpt-5.5 #4 수렴): CLI 전용 부작용은 require 시 실행하지 않는다.
 //   이전: warning listener 제거 / NODE_OPTIONS 변경 / chcp IIFE 가 top-level 즉시 실행 → require('harness') 시 호스트 프로세스 오염.
@@ -3077,6 +3077,8 @@ function _selfTestCases() {
     { name: 'lib/pure-utils: project-brief config 분리(_BRIEF_FIELDS/_briefFilled) + 인라인 제거 (UR-0025 1.9.330)', run: () => { const m = require('../lib/pure-utils'); const cfgOk = Array.isArray(m._BRIEF_FIELDS) && m._BRIEF_FIELDS.length === 10 && m._BRIEF_FIELDS[0].key === 'intro'; const work = m._briefFilled({ intro: 'x', features: ['a'] }) === 2 && m._briefFilled({}) === 0; const src = read(__filename); const moved = m._briefFilled === _briefFilled && m._BRIEF_FIELDS === _BRIEF_FIELDS && !/^const _BRIEF_FIELDS = \[/m.test(src) && !/^function _briefFilled\(/m.test(src); return cfgOk && work && moved; } },
     { name: 'lib/pure-utils: brief 빌더 분리(_briefReadmeBlock/_briefBlueprint + BRIEF 마커, VERSION 주입) (UR-0025 1.9.331)', run: () => { const m = require('../lib/pure-utils'); const fnOk = typeof m._briefReadmeBlock === 'function' && typeof m._briefBlueprint === 'function' && m.BRIEF_START.includes('project-brief:start'); const b = { project: 'X', intro: 'i', features: ['f1'] }; const rb = m._briefReadmeBlock(b); const bp = m._briefBlueprint(b, '9.9.9'); const work = rb.includes(m.BRIEF_START) && rb.includes(m.BRIEF_END) && /f1/.test(rb) && /Blueprint/.test(bp) && /leerness v9\.9\.9/.test(bp); const src = read(__filename); const moved = m._briefBlueprint === _briefBlueprint && m.BRIEF_START === BRIEF_START && !/^function _briefReadmeBlock\(/m.test(src) && !/^function _briefBlueprint\(/m.test(src) && !/^const BRIEF_START =/m.test(src); return fnOk && work && moved; } },
     { name: 'lib/pure-utils: lessons.md 파서 분리(_parseLessonEntries) + 인라인 제거 (UR-0025 1.9.332)', run: () => { const m = require('../lib/pure-utils'); const r = m._parseLessonEntries('### 2026-06-05\n- Lesson: A\n- Tag: t\n\n### 2026-06-04\n- Lesson: B'); const work = r.length === 2 && r[0].text === 'A' && r[0].tag === 't' && r[1].tag === null && r[0].date === '2026-06-05'; const src = read(__filename); const moved = m._parseLessonEntries === _parseLessonEntries && !/^function _parseLessonEntries\(/m.test(src) && src.includes('for (const lesson of _parseLessonEntries(text))'); return work && moved; } },
+    { name: 'UR-0025 심층: constraints catalog→lib/catalogs + _matchConstraints→pure-utils 분리 (1.9.333)', run: () => { const c = require('../lib/catalogs'); const m = require('../lib/pure-utils'); const catOk = c._DEFAULT_PLATFORM_CONSTRAINTS && Object.keys(c._DEFAULT_PLATFORM_CONSTRAINTS.platforms).length === 6 && !!c._DEFAULT_PLATFORM_CONSTRAINTS.platforms.stripe; const r = m._matchConstraints(c._DEFAULT_PLATFORM_CONSTRAINTS, 'stripe 결제'); const work = r.matched.length === 1 && r.matched[0].platform === 'stripe' && r.totalPlatforms === 6 && m._matchConstraints(null, 'x').matched.length === 0; const src = read(__filename); const moved = _DEFAULT_PLATFORM_CONSTRAINTS === c._DEFAULT_PLATFORM_CONSTRAINTS && _matchConstraints === m._matchConstraints && !/const _DEFAULT_PLATFORM_CONSTRAINTS = \{/.test(src) && src.includes('_matchConstraints(_loadPlatformConstraints(root), text)'); return catOk && work && moved; } },
+    { name: 'UR-0025 심층(Codex 위임·검증): intent domain catalog→lib/catalogs + _matchDomain→pure-utils 분리 (1.9.334)', run: () => { const c = require('../lib/catalogs'); const m = require('../lib/pure-utils'); const catOk = c._DEFAULT_DOMAIN_CATALOG && Object.keys(c._DEFAULT_DOMAIN_CATALOG.domains).length === 5 && !!c._DEFAULT_DOMAIN_CATALOG.domains.game; const r = m._matchDomain(c._DEFAULT_DOMAIN_CATALOG, 'unity 게임'); const work = r.domain === 'game' && Array.isArray(r.components) && m._matchDomain(c._DEFAULT_DOMAIN_CATALOG, 'zzz없음').domain === null && m._matchDomain(null, 'x').domain === null; const src = read(__filename); const moved = _DEFAULT_DOMAIN_CATALOG === c._DEFAULT_DOMAIN_CATALOG && _matchDomain === m._matchDomain && !/const _DEFAULT_DOMAIN_CATALOG = \{/.test(src) && src.includes('_matchDomain(_loadDomainCatalog(root), text)'); return catOk && work && moved; } },
     { name: 'VERSION 형식 (x.y.z)', run: () => /^\d+\.\d+\.\d+$/.test(VERSION) }
   ];
 }
@@ -3754,63 +3756,7 @@ function roundHistoryCmd(root) {
 //   .harness/platform-constraints.json 에 플랫폼별 제약 catalog 저장 → 요청 텍스트 키워드 매칭 → 적용 가능한 제약 보고
 //   기본 catalog 6종: Stripe / OpenAI / Anthropic / GitHub / Discord / Twitter
 function _platformConstraintsPath(root) { return path.join(root, '.harness', 'platform-constraints.json'); }
-const _DEFAULT_PLATFORM_CONSTRAINTS = {
-  version: '1.9.208',
-  platforms: {
-    stripe: {
-      aliases: ['stripe', 'stripe api', 'payment', '결제'],
-      docs: 'https://stripe.com/docs/rate-limits',
-      constraints: [
-        { kind: 'rate-limit', detail: 'read: 100 req/s, write: 100 req/s (live mode), test mode: 25 req/s' },
-        { kind: 'idempotency', detail: 'Idempotency-Key 헤더 24h 유지 — 중복 결제 방지 필수' },
-        { kind: 'webhook', detail: 'webhook 서명 검증 필수 (Stripe-Signature header + endpoint secret)' }
-      ]
-    },
-    openai: {
-      aliases: ['openai', 'gpt', 'chatgpt', 'gpt-4', 'gpt-3'],
-      docs: 'https://platform.openai.com/docs/guides/rate-limits',
-      constraints: [
-        { kind: 'rate-limit', detail: 'tier-based: Free 3 RPM / Tier 1 500 RPM / Tier 5 10,000 RPM' },
-        { kind: 'token-limit', detail: 'TPM (tokens/min) 별도 — 큰 입력 시 RPM 도달 전 차단 가능' },
-        { kind: 'cost', detail: 'gpt-4: $30/$60 per 1M input/output tokens — 대량 호출 전 비용 추정 필수' }
-      ]
-    },
-    anthropic: {
-      aliases: ['anthropic', 'claude', 'claude api', 'sonnet', 'opus', 'haiku'],
-      docs: 'https://docs.anthropic.com/claude/reference/rate-limits',
-      constraints: [
-        { kind: 'rate-limit', detail: 'tier-based: Free 5 RPM / Tier 1 50 RPM / Tier 4 4,000 RPM' },
-        { kind: 'context-window', detail: 'claude-sonnet 200K context, claude-opus 200K, 1M tier 별도' },
-        { kind: 'cost', detail: 'sonnet: $3/$15 per 1M tokens (1M context tier 2x)' }
-      ]
-    },
-    github: {
-      aliases: ['github', 'github api', 'gh api', 'octokit'],
-      docs: 'https://docs.github.com/en/rest/rate-limit',
-      constraints: [
-        { kind: 'rate-limit', detail: 'authenticated: 5,000 req/hr, unauthenticated: 60 req/hr' },
-        { kind: 'rate-limit', detail: 'search API: 30 req/min (authenticated)' },
-        { kind: 'secondary', detail: 'secondary rate limit — concurrent + content creation 별도 가드' }
-      ]
-    },
-    discord: {
-      aliases: ['discord', 'discord api', 'discord bot'],
-      docs: 'https://discord.com/developers/docs/topics/rate-limits',
-      constraints: [
-        { kind: 'rate-limit', detail: 'global: 50 req/s, per-route 별도' },
-        { kind: 'invalid', detail: '10,000 invalid req/10min → 1h ban 위험' }
-      ]
-    },
-    twitter: {
-      aliases: ['twitter', 'twitter api', 'x api', 'x.com api'],
-      docs: 'https://developer.twitter.com/en/docs/twitter-api/rate-limits',
-      constraints: [
-        { kind: 'rate-limit', detail: 'tier-based: Free 1,500 posts/month, Basic 50,000 posts/month' },
-        { kind: 'auth', detail: 'OAuth 2.0 PKCE 필수 (user context), App-only는 별도 endpoint' }
-      ]
-    }
-  }
-};
+// 1.9.333 (UR-0025 심층): _DEFAULT_PLATFORM_CONSTRAINTS → lib/catalogs.js 로 이동 (순수 데이터, require 사용).
 function _loadPlatformConstraints(root) {
   try {
     const fp = _platformConstraintsPath(root);
@@ -3834,23 +3780,9 @@ function _writePlatformConstraints(root, catalog) {
   } catch { return false; }
 }
 // 사용자 요청 텍스트에서 플랫폼 alias 매칭 → 적용 제약 목록 반환
+// 1.9.333 (UR-0025 심층): 매칭 로직은 순수 _matchConstraints(catalog, text) (lib/pure-utils) — fs(load)는 여기서 주입.
 function _checkRequestConstraints(root, text) {
-  if (!text || typeof text !== 'string') return { matched: [], suggestions: [] };
-  const catalog = _loadPlatformConstraints(root);
-  const lower = text.toLowerCase();
-  const matched = [];
-  for (const [pid, plat] of Object.entries(catalog.platforms)) {
-    const aliases = plat.aliases || [];
-    const hit = aliases.find(a => lower.includes(a.toLowerCase()));
-    if (hit) matched.push({ platform: pid, matchedAlias: hit, docs: plat.docs, constraints: plat.constraints });
-  }
-  // suggestions — 보편 키워드 (api/rate/limit/integration) 시 catalog 검토 권장
-  const suggestions = [];
-  const generic = /\bapi\b|연동|integration|호출|rate|limit|quota|webhook/i.test(text);
-  if (generic && matched.length === 0) {
-    suggestions.push('일반적 API 연동 키워드 감지 — leerness constraints list 로 사전 등록된 플랫폼 catalog 확인 권장');
-  }
-  return { matched, suggestions, totalPlatforms: Object.keys(catalog.platforms).length };
+  return _matchConstraints(_loadPlatformConstraints(root), text);
 }
 
 // 1.9.209: pre-wake sub-agent audit (사용자 명시)
@@ -4408,73 +4340,7 @@ function _buildWorkspaceReferenceGuide(root, dirName) {
 //   3원칙: (1) Always-Off Opt-In, (2) Dry-run 기본 (실행 X), (3) 명시 vs 추론 분리 라벨링
 //   .harness/domain-catalog.json 사용자 편집 가능 + default catalog 5종 (game/web/api/cli/data)
 function _domainCatalogPath(root) { return path.join(root, '.harness', 'domain-catalog.json'); }
-const _DEFAULT_DOMAIN_CATALOG = {
-  version: '1.9.213',
-  domains: {
-    game: {
-      aliases: ['게임', 'game', 'unity', 'unreal', 'godot', 'phaser', 'gamedev'],
-      components: [
-        { key: 'map', desc: '맵/타일 시스템 + 영역/스폰' },
-        { key: 'character', desc: '캐릭터/스프라이트 + 애니메이션 상태머신' },
-        { key: 'gameLoop', desc: '게임 루프 (tick/render/update)' },
-        { key: 'collision', desc: '충돌 감지 (AABB/SAT/grid)' },
-        { key: 'camera', desc: '카메라 follow + 영역 제한' },
-        { key: 'hud', desc: 'HUD/UI (HP/score/inventory)' },
-        { key: 'audio', desc: '사운드 매니저 (BGM/SFX)' },
-        { key: 'save', desc: '저장/로드 (slot 시스템)' },
-        { key: 'menu', desc: '메뉴 (메인/일시정지/설정)' },
-        { key: 'input', desc: '입력 핸들러 (키보드/패드/터치)' }
-      ]
-    },
-    web: {
-      aliases: ['웹', 'web', 'website', 'webapp', 'nextjs', 'react', 'vue', 'svelte', 'frontend'],
-      components: [
-        { key: 'routing', desc: '라우팅 (path/dynamic/nested)' },
-        { key: 'state', desc: '상태 관리 (context/redux/zustand)' },
-        { key: 'auth', desc: '인증 (OAuth/JWT/session)' },
-        { key: 'api', desc: 'API 클라이언트 (fetch/axios/tanstack-query)' },
-        { key: 'db', desc: 'DB 연동 (ORM/migration/seed)' },
-        { key: 'ui', desc: 'UI 컴포넌트 라이브러리' },
-        { key: 'test', desc: '테스트 (unit/e2e/visual)' },
-        { key: 'deploy', desc: '배포 (Vercel/Netlify/Cloudflare)' }
-      ]
-    },
-    api: {
-      aliases: ['api', 'rest', 'graphql', 'endpoint', 'backend', 'server'],
-      components: [
-        { key: 'endpoint', desc: '엔드포인트 라우팅 + HTTP method' },
-        { key: 'auth', desc: '인증/인가 (API key/OAuth/JWT)' },
-        { key: 'rate-limit', desc: 'rate limit (RPS/RPM/token bucket)' },
-        { key: 'validation', desc: '입력 검증 (zod/joi/yup)' },
-        { key: 'error', desc: '에러 핸들링 + 응답 형식' },
-        { key: 'logging', desc: '로깅 + 모니터링 (structured logs)' },
-        { key: 'docs', desc: 'API 문서 (OpenAPI/Swagger)' }
-      ]
-    },
-    cli: {
-      aliases: ['cli', 'command-line', 'tool', 'utility', 'shell'],
-      components: [
-        { key: 'argParser', desc: '인자 파싱 (yargs/commander/clipanion)' },
-        { key: 'help', desc: 'help / man / examples 텍스트' },
-        { key: 'config', desc: '설정 파일 + env 변수' },
-        { key: 'output', desc: '출력 (TTY 색상/JSON/quiet)' },
-        { key: 'error', desc: '에러 처리 + exit code 규약' },
-        { key: 'completion', desc: 'shell completion (bash/zsh/fish)' }
-      ]
-    },
-    data: {
-      aliases: ['data', 'pipeline', 'etl', 'analytics', 'ingest'],
-      components: [
-        { key: 'ingest', desc: '데이터 수집 (file/API/stream)' },
-        { key: 'transform', desc: '변환 (cleaning/normalization/joining)' },
-        { key: 'storage', desc: '저장소 (parquet/db/blob)' },
-        { key: 'query', desc: '쿼리/분석 (SQL/aggregations)' },
-        { key: 'validation', desc: '데이터 검증 (schema/contracts)' },
-        { key: 'lineage', desc: '데이터 lineage 추적' }
-      ]
-    }
-  }
-};
+// 1.9.333 패턴 적용: _DEFAULT_DOMAIN_CATALOG → lib/catalogs.js 로 이동 (순수 데이터, require 사용).
 function _loadDomainCatalog(root) {
   try {
     const fp = _domainCatalogPath(root);
@@ -4497,17 +4363,7 @@ function _writeDomainCatalog(root, catalog) {
 }
 // 1.9.325 (UR-0025): _classifyIntent → lib/pure-utils.js 로 이동 (순수 intent 분류, require 사용).
 function _detectDomain(text, root) {
-  if (!text) return { domain: null, alias: null };
-  const lower = text.toLowerCase();
-  const catalog = _loadDomainCatalog(root);
-  for (const [domain, info] of Object.entries(catalog.domains)) {
-    for (const a of info.aliases || []) {
-      if (lower.includes(a.toLowerCase())) {
-        return { domain, alias: a, components: info.components };
-      }
-    }
-  }
-  return { domain: null, alias: null };
+  return _matchDomain(_loadDomainCatalog(root), text);
 }
 function _inferScopeExpansion(text, root) {
   const classify = _classifyIntent(text);

package/lib/catalogs.js

@@ -57,4 +57,132 @@ const REUSE_CHECKLIST = [
   '제어: 핵심 로직이면 외부 의존 리스크를 감수할 가치가 있는가'
 ];
 
-module.exports = { CAPABILITY_SURFACE, POWERFUL_COMMANDS, ADAPTERS, REUSE_CATEGORIES, REUSE_CHECKLIST };
+// 1.9.333 (UR-0025 심층): 플랫폼/API 제약 기본 catalog (순수 데이터) — constraints 서브시스템 핵심 데이터.
+const _DEFAULT_PLATFORM_CONSTRAINTS = {
+  version: '1.9.208',
+  platforms: {
+    stripe: {
+      aliases: ['stripe', 'stripe api', 'payment', '결제'],
+      docs: 'https://stripe.com/docs/rate-limits',
+      constraints: [
+        { kind: 'rate-limit', detail: 'read: 100 req/s, write: 100 req/s (live mode), test mode: 25 req/s' },
+        { kind: 'idempotency', detail: 'Idempotency-Key 헤더 24h 유지 — 중복 결제 방지 필수' },
+        { kind: 'webhook', detail: 'webhook 서명 검증 필수 (Stripe-Signature header + endpoint secret)' }
+      ]
+    },
+    openai: {
+      aliases: ['openai', 'gpt', 'chatgpt', 'gpt-4', 'gpt-3'],
+      docs: 'https://platform.openai.com/docs/guides/rate-limits',
+      constraints: [
+        { kind: 'rate-limit', detail: 'tier-based: Free 3 RPM / Tier 1 500 RPM / Tier 5 10,000 RPM' },
+        { kind: 'token-limit', detail: 'TPM (tokens/min) 별도 — 큰 입력 시 RPM 도달 전 차단 가능' },
+        { kind: 'cost', detail: 'gpt-4: $30/$60 per 1M input/output tokens — 대량 호출 전 비용 추정 필수' }
+      ]
+    },
+    anthropic: {
+      aliases: ['anthropic', 'claude', 'claude api', 'sonnet', 'opus', 'haiku'],
+      docs: 'https://docs.anthropic.com/claude/reference/rate-limits',
+      constraints: [
+        { kind: 'rate-limit', detail: 'tier-based: Free 5 RPM / Tier 1 50 RPM / Tier 4 4,000 RPM' },
+        { kind: 'context-window', detail: 'claude-sonnet 200K context, claude-opus 200K, 1M tier 별도' },
+        { kind: 'cost', detail: 'sonnet: $3/$15 per 1M tokens (1M context tier 2x)' }
+      ]
+    },
+    github: {
+      aliases: ['github', 'github api', 'gh api', 'octokit'],
+      docs: 'https://docs.github.com/en/rest/rate-limit',
+      constraints: [
+        { kind: 'rate-limit', detail: 'authenticated: 5,000 req/hr, unauthenticated: 60 req/hr' },
+        { kind: 'rate-limit', detail: 'search API: 30 req/min (authenticated)' },
+        { kind: 'secondary', detail: 'secondary rate limit — concurrent + content creation 별도 가드' }
+      ]
+    },
+    discord: {
+      aliases: ['discord', 'discord api', 'discord bot'],
+      docs: 'https://discord.com/developers/docs/topics/rate-limits',
+      constraints: [
+        { kind: 'rate-limit', detail: 'global: 50 req/s, per-route 별도' },
+        { kind: 'invalid', detail: '10,000 invalid req/10min → 1h ban 위험' }
+      ]
+    },
+    twitter: {
+      aliases: ['twitter', 'twitter api', 'x api', 'x.com api'],
+      docs: 'https://developer.twitter.com/en/docs/twitter-api/rate-limits',
+      constraints: [
+        { kind: 'rate-limit', detail: 'tier-based: Free 1,500 posts/month, Basic 50,000 posts/month' },
+        { kind: 'auth', detail: 'OAuth 2.0 PKCE 필수 (user context), App-only는 별도 endpoint' }
+      ]
+    }
+  }
+};
+
+// 1.9.333 패턴 적용: intent 도메인 기본 catalog (순수 데이터) — intent-domain 서브시스템 핵심 데이터.
+const _DEFAULT_DOMAIN_CATALOG = {
+  version: '1.9.213',
+  domains: {
+    game: {
+      aliases: ['게임', 'game', 'unity', 'unreal', 'godot', 'phaser', 'gamedev'],
+      components: [
+        { key: 'map', desc: '맵/타일 시스템 + 영역/스폰' },
+        { key: 'character', desc: '캐릭터/스프라이트 + 애니메이션 상태머신' },
+        { key: 'gameLoop', desc: '게임 루프 (tick/render/update)' },
+        { key: 'collision', desc: '충돌 감지 (AABB/SAT/grid)' },
+        { key: 'camera', desc: '카메라 follow + 영역 제한' },
+        { key: 'hud', desc: 'HUD/UI (HP/score/inventory)' },
+        { key: 'audio', desc: '사운드 매니저 (BGM/SFX)' },
+        { key: 'save', desc: '저장/로드 (slot 시스템)' },
+        { key: 'menu', desc: '메뉴 (메인/일시정지/설정)' },
+        { key: 'input', desc: '입력 핸들러 (키보드/패드/터치)' }
+      ]
+    },
+    web: {
+      aliases: ['웹', 'web', 'website', 'webapp', 'nextjs', 'react', 'vue', 'svelte', 'frontend'],
+      components: [
+        { key: 'routing', desc: '라우팅 (path/dynamic/nested)' },
+        { key: 'state', desc: '상태 관리 (context/redux/zustand)' },
+        { key: 'auth', desc: '인증 (OAuth/JWT/session)' },
+        { key: 'api', desc: 'API 클라이언트 (fetch/axios/tanstack-query)' },
+        { key: 'db', desc: 'DB 연동 (ORM/migration/seed)' },
+        { key: 'ui', desc: 'UI 컴포넌트 라이브러리' },
+        { key: 'test', desc: '테스트 (unit/e2e/visual)' },
+        { key: 'deploy', desc: '배포 (Vercel/Netlify/Cloudflare)' }
+      ]
+    },
+    api: {
+      aliases: ['api', 'rest', 'graphql', 'endpoint', 'backend', 'server'],
+      components: [
+        { key: 'endpoint', desc: '엔드포인트 라우팅 + HTTP method' },
+        { key: 'auth', desc: '인증/인가 (API key/OAuth/JWT)' },
+        { key: 'rate-limit', desc: 'rate limit (RPS/RPM/token bucket)' },
+        { key: 'validation', desc: '입력 검증 (zod/joi/yup)' },
+        { key: 'error', desc: '에러 핸들링 + 응답 형식' },
+        { key: 'logging', desc: '로깅 + 모니터링 (structured logs)' },
+        { key: 'docs', desc: 'API 문서 (OpenAPI/Swagger)' }
+      ]
+    },
+    cli: {
+      aliases: ['cli', 'command-line', 'tool', 'utility', 'shell'],
+      components: [
+        { key: 'argParser', desc: '인자 파싱 (yargs/commander/clipanion)' },
+        { key: 'help', desc: 'help / man / examples 텍스트' },
+        { key: 'config', desc: '설정 파일 + env 변수' },
+        { key: 'output', desc: '출력 (TTY 색상/JSON/quiet)' },
+        { key: 'error', desc: '에러 처리 + exit code 규약' },
+        { key: 'completion', desc: 'shell completion (bash/zsh/fish)' }
+      ]
+    },
+    data: {
+      aliases: ['data', 'pipeline', 'etl', 'analytics', 'ingest'],
+      components: [
+        { key: 'ingest', desc: '데이터 수집 (file/API/stream)' },
+        { key: 'transform', desc: '변환 (cleaning/normalization/joining)' },
+        { key: 'storage', desc: '저장소 (parquet/db/blob)' },
+        { key: 'query', desc: '쿼리/분석 (SQL/aggregations)' },
+        { key: 'validation', desc: '데이터 검증 (schema/contracts)' },
+        { key: 'lineage', desc: '데이터 lineage 추적' }
+      ]
+    }
+  }
+};
+
+module.exports = { CAPABILITY_SURFACE, POWERFUL_COMMANDS, ADAPTERS, REUSE_CATEGORIES, REUSE_CHECKLIST, _DEFAULT_PLATFORM_CONSTRAINTS, _DEFAULT_DOMAIN_CATALOG };

package/lib/pure-utils.js

@@ -375,6 +375,38 @@ function _parseLessonEntries(text) {
   return out;
 }
 
+// 1.9.333 (UR-0025 심층): 순수 플랫폼 제약 매칭 — catalog + 텍스트 → 매칭 플랫폼/제약/제안 (fs 의존 0, catalog 주입).
+function _matchConstraints(catalog, text) {
+  if (!text || typeof text !== 'string' || !catalog || !catalog.platforms) return { matched: [], suggestions: [] };
+  const lower = text.toLowerCase();
+  const matched = [];
+  for (const [pid, plat] of Object.entries(catalog.platforms)) {
+    const aliases = plat.aliases || [];
+    const hit = aliases.find(a => lower.includes(a.toLowerCase()));
+    if (hit) matched.push({ platform: pid, matchedAlias: hit, docs: plat.docs, constraints: plat.constraints });
+  }
+  const suggestions = [];
+  const generic = /\bapi\b|연동|integration|호출|rate|limit|quota|webhook/i.test(text);
+  if (generic && matched.length === 0) {
+    suggestions.push('일반적 API 연동 키워드 감지 — leerness constraints list 로 사전 등록된 플랫폼 catalog 확인 권장');
+  }
+  return { matched, suggestions, totalPlatforms: Object.keys(catalog.platforms).length };
+}
+
+// 1.9.333 패턴 적용: 순수 도메인 매칭 — catalog + 텍스트 → 첫 매칭 domain/alias/components (fs 의존 0, catalog 주입).
+function _matchDomain(catalog, text) {
+  if (!text || typeof text !== 'string' || !catalog || !catalog.domains) return { domain: null, alias: null };
+  const lower = text.toLowerCase();
+  for (const [domain, info] of Object.entries(catalog.domains)) {
+    for (const a of info.aliases || []) {
+      if (lower.includes(a.toLowerCase())) {
+        return { domain, alias: a, components: info.components };
+      }
+    }
+  }
+  return { domain: null, alias: null };
+}
+
 module.exports = {
   _isSecretKey, compareVer, parseHarnessVersion,
   _classifyCJK, _riskLabel, _detectSystemLang, _parseSlashFromHelp,
@@ -399,5 +431,9 @@ module.exports = {
   // 1.9.331 (UR-0025): project-brief 텍스트 빌더 + 마커
   BRIEF_START, BRIEF_END, _briefReadmeBlock, _briefBlueprint,
   // 1.9.332 (UR-0025): 순수 lessons.md 파서
-  _parseLessonEntries
+  _parseLessonEntries,
+  // 1.9.333 (UR-0025 심층): 순수 플랫폼 제약 매칭
+  _matchConstraints,
+  // 1.9.333 패턴 적용: 순수 도메인 매칭
+  _matchDomain
 };

package/package.json

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

package/scripts/e2e.js

@@ -4107,5 +4107,58 @@ total++;
   if (!ok) failed++;
 }
 
+// 1.9.333 회귀 (UR-0025 심층): constraints 서브시스템 핵심 분리 — catalog→lib/catalogs + _matchConstraints→pure-utils + constraints 명령 회귀
+total++;
+{
+  let ok = false;
+  try {
+    const c = require(path.resolve(__dirname, '..', 'lib', 'catalogs.js'));
+    const m = require(path.resolve(__dirname, '..', 'lib', 'pure-utils.js'));
+    const catOk = c._DEFAULT_PLATFORM_CONSTRAINTS && Object.keys(c._DEFAULT_PLATFORM_CONSTRAINTS.platforms).length === 6;
+    const r = m._matchConstraints(c._DEFAULT_PLATFORM_CONSTRAINTS, 'stripe 결제');
+    const work = catOk && r.matched.length === 1 && r.matched[0].platform === 'stripe' && r.totalPlatforms === 6 && m._matchConstraints(null, 'x').matched.length === 0;
+    const harnessSrc = fs.readFileSync(path.resolve(__dirname, '..', 'bin', 'harness.js'), 'utf8');
+    // 1.9.334: catalogs import 블록 추출 후 이름 포함 확인(순서/추가 비의존 — 이후 import 추가 허용)
+    const _catImp = (harnessSrc.match(/const \{[\s\S]*?\} = require\('\.\.\/lib\/catalogs'\)/) || [''])[0];
+    const movedOut = !/const _DEFAULT_PLATFORM_CONSTRAINTS = \{/.test(harnessSrc) && harnessSrc.includes('_matchConstraints(_loadPlatformConstraints(root), text)')
+      && _catImp.includes('_DEFAULT_PLATFORM_CONSTRAINTS');
+    // 소비 명령 회귀: constraints check (review-request 도 _checkRequestConstraints 사용)
+    const cd = fs.mkdtempSync(path.join(os.tmpdir(), 'leerness-con-'));
+    cp.spawnSync(process.execPath, [CLI, 'init', cd, '--yes', '--language', 'ko', '--skills', 'recommended'], { encoding: 'utf8', timeout: 30000 });
+    const cr = cp.spawnSync(process.execPath, [CLI, 'constraints', 'check', 'stripe 결제 구현', '--path', cd], { encoding: 'utf8', timeout: 20000 });
+    const cmdOk = /stripe|플랫폼 매칭/.test(cr.stdout || '');
+    ok = work && movedOut && cmdOk;
+    fs.rmSync(cd, { recursive: true, force: true });
+  } catch {}
+  console.log(ok ? '✓ B(1.9.333) UR-0025 심층: constraints catalog/_matchConstraints 분리 + constraints check 회귀 (UR-0025)' : '✗ constraints 서브시스템 분리 실패');
+  if (!ok) failed++;
+}
+
+// 1.9.334 회귀 (UR-0025 심층, Codex 위임·검증): intent domain catalog→lib/catalogs + _matchDomain→pure-utils + intent expand 회귀
+total++;
+{
+  let ok = false;
+  try {
+    const c = require(path.resolve(__dirname, '..', 'lib', 'catalogs.js'));
+    const m = require(path.resolve(__dirname, '..', 'lib', 'pure-utils.js'));
+    const catOk = c._DEFAULT_DOMAIN_CATALOG && Object.keys(c._DEFAULT_DOMAIN_CATALOG.domains).length === 5;
+    const r = m._matchDomain(c._DEFAULT_DOMAIN_CATALOG, 'unity 게임');
+    const work = catOk && typeof m._matchDomain === 'function' && r.domain === 'game' && Array.isArray(r.components) && m._matchDomain(null, 'x').domain === null;
+    const harnessSrc = fs.readFileSync(path.resolve(__dirname, '..', 'bin', 'harness.js'), 'utf8');
+    const _catImp = (harnessSrc.match(/const \{[\s\S]*?\} = require\('\.\.\/lib\/catalogs'\)/) || [''])[0];  // import 순서/추가 비의존
+    const movedOut = !/const _DEFAULT_DOMAIN_CATALOG = \{/.test(harnessSrc) && harnessSrc.includes('_matchDomain(_loadDomainCatalog(root), text)')
+      && _catImp.includes('_DEFAULT_DOMAIN_CATALOG');
+    // 소비 명령 회귀: intent expand 도메인 감지(_detectDomain → _matchDomain)
+    const id = fs.mkdtempSync(path.join(os.tmpdir(), 'leerness-dom-'));
+    cp.spawnSync(process.execPath, [CLI, 'init', id, '--yes', '--language', 'ko', '--skills', 'recommended'], { encoding: 'utf8', timeout: 30000 });
+    const ir = cp.spawnSync(process.execPath, [CLI, 'intent', 'expand', 'unity 게임 맵', '--path', id], { encoding: 'utf8', timeout: 20000 });
+    const cmdOk = /game/.test(ir.stdout || '');
+    ok = work && movedOut && cmdOk;
+    fs.rmSync(id, { recursive: true, force: true });
+  } catch {}
+  console.log(ok ? '✓ B(1.9.334) UR-0025 심층(Codex 위임·검증): domain catalog/_matchDomain 분리 + intent expand 회귀 (UR-0025)' : '✗ domain 서브시스템 분리 실패');
+  if (!ok) failed++;
+}
+
 console.log(`\nE2E result: ${total - failed}/${total} passed · ${((Date.now() - _e2eStart) / 1000).toFixed(0)}s`);
 if (failed > 0) process.exit(1);