@wooojin/forgen 0.4.13 → 0.5.0

package/dist/cli.js

@@ -20,7 +20,7 @@ const runtime = launchContext.runtime;
 const commands = [
     {
         name: 'forge',
-        description: 'Personalization profile (--profile|--export|--reset)',
+        description: 'Personalization single entry (--onboarding|--profile|--export|--reset)',
         handler: async (args) => {
             const { handleForge } = await import('./forge/cli.js');
             await handleForge(args);
@@ -28,8 +28,31 @@ const commands = [
     },
     {
         name: 'compound',
-        description: 'Preview/save compound insights and manage accumulated knowledge',
+        description: 'Preview/save compound insights and manage accumulated knowledge (subcmd: sweep)',
         handler: async (args) => {
+            // ADR-011: 시간-기반 compound backstop. cron 에서 `forgen compound sweep` 호출.
+            if (args[0] === 'sweep') {
+                const { compoundSweepCli } = await import('./core/compound-sweep-cli.js');
+                compoundSweepCli(args.slice(1));
+                return;
+            }
+            // ADR-012: Haiku 추출 동의 토글. `forgen compound consent on|off|status`
+            if (args[0] === 'consent') {
+                const { getHaikuConsentState, setHaikuCompoundConsent } = await import('./core/compound-consent.js');
+                const sub = args[1];
+                if (sub === 'on' || sub === 'off') {
+                    setHaikuCompoundConsent(sub === 'on');
+                    console.log(`[forgen] auto-compound Haiku 추출: ${sub === 'on' ? '활성(ON)' : '비활성(OFF)'}. (결정론 룰 승급은 항상 동작)`);
+                }
+                else {
+                    const s = getHaikuConsentState();
+                    console.log(`[forgen] auto-compound Haiku 추출: ${s.enabled ? 'ON' : 'OFF'} (source: ${s.source})\n` +
+                        '  ON  = 세션 요약을 Haiku 로 전송해 행동패턴 추론 (본인 쿼터, redaction 적용)\n' +
+                        '  OFF = 결정론 교정→룰 승급만 (egress 0, 입증된 δ 경로는 유지)\n' +
+                        '  변경: forgen compound consent on|off  (env: FORGEN_AUTO_COMPOUND=1 / FORGEN_NO_AUTO_COMPOUND=1)');
+                }
+                return;
+            }
             const { handleCompound } = await import('./engine/compound-loop.js');
             await handleCompound(args);
         },
@@ -72,11 +95,11 @@ const commands = [
         },
     },
     {
-        name: 'dashboard',
-        description: 'Compound system dashboard with rich overview',
-        handler: async (_args) => {
-            const { handleDashboard } = await import('./core/dashboard.js');
-            await handleDashboard();
+        name: 'status',
+        description: 'Unified status: forgen status [--compound|--profile|--rules|--blocks [N]|--overview|--live]',
+        handler: async (args) => {
+            const { handleStatus } = await import('./core/status-cli.js');
+            await handleStatus(args);
         },
     },
     {
@@ -87,14 +110,6 @@ const commands = [
             await handleLearn(args);
         },
     },
-    {
-        name: 'me',
-        description: 'Personal dashboard (→ inspect profile)',
-        handler: async (_args) => {
-            const { handleInspect } = await import('./core/inspect-cli.js');
-            await handleInspect(['profile']);
-        },
-    },
     {
         name: 'statusline',
         description: 'Compact HUD for Claude Code statusLine (reads stdin JSON)',
@@ -137,7 +152,7 @@ const commands = [
                     const { setDefaultHost } = await import('./store/profile-store.js');
                     const ok = setDefaultHost(value);
                     if (!ok) {
-                        console.log('  ✗ Profile not found. Run `forgen onboarding` first.');
+                        console.log('  ✗ Profile not found. Run `forgen forge --onboarding` first.');
                         process.exit(1);
                     }
                     console.log(`  ✓ default_host set to: ${value}`);
@@ -166,12 +181,12 @@ const commands = [
     },
     {
         name: 'install',
-        description: 'Install forgen into a host. Usage: forgen install [claude|codex|both] [--dry-run] [--no-mcp]',
+        description: 'Install forgen into a host. Usage: forgen install [claude|codex|opencode|both] [--dry-run] [--no-mcp]',
         handler: async (args) => {
-            const knownSubs = new Set(['claude', 'codex', 'both']);
+            const knownSubs = new Set(['claude', 'codex', 'opencode', 'both']);
             const target = args[0] && knownSubs.has(args[0]) ? args[0] : args[0]?.startsWith('--') ? undefined : args[0];
             if (target !== undefined && !knownSubs.has(target)) {
-                console.log('Usage:\n  forgen install [claude|codex|both] [--dry-run] [--no-mcp]\n\n  No arg → interactive 3-choice (Claude/Codex/Both).');
+                console.log('Usage:\n  forgen install [claude|codex|opencode|both] [--dry-run] [--no-mcp]\n\n  No arg → interactive 3-choice (Claude/Codex/Both). opencode: 명시 타겟(P1 실험적).');
                 return;
             }
             const dryRun = args.includes('--dry-run');
@@ -186,18 +201,6 @@ const commands = [
             console.log(renderResult(result, dryRun));
         },
     },
-    {
-        name: 'status',
-        description: 'Observability dashboard (--watch, --json, --interval N)',
-        handler: async (args) => {
-            const { runDashboard } = await import('./core/dashboard-cli.js');
-            const watch = args.includes('--watch');
-            const json = args.includes('--json');
-            const intervalIdx = args.indexOf('--interval');
-            const intervalSec = intervalIdx !== -1 ? Number(args[intervalIdx + 1]) || 5 : 5;
-            await runDashboard({ watch, json, intervalSec });
-        },
-    },
     {
         name: 'maintenance',
         description: 'Maintenance utilities (--backfill [--phase A|B|all] [--force] [--dry-run])',
@@ -229,28 +232,11 @@ const commands = [
         },
     },
     {
-        name: 'parity',
-        description: 'Run host parity checks. Usage: forgen parity codex [--dry-run]',
+        name: 'dev',
+        description: 'Developer/maintenance utilities: dev <probe-workflow|parity|migrate|regress-map>',
         handler: async (args) => {
-            const sub = args[0];
-            if (sub !== 'codex') {
-                console.log('Usage:\n  forgen parity codex [--dry-run]\n\nNotes:\n  - source 체크아웃에서만 작동합니다 (tests/ 디렉토리 필요).\n  - npm install 로 설치된 패키지에서는 run-parity.sh 가 없습니다.');
-                return;
-            }
-            const here = path.dirname(fileURLToPath(import.meta.url));
-            const scriptPath = path.resolve(here, '..', 'tests', 'e2e', 'codex', 'run-parity.sh');
-            if (!fs.existsSync(scriptPath)) {
-                console.error('[forgen] run-parity.sh 는 source 체크아웃에서만 작동. 직접 git clone 후 실행하세요.');
-                console.error(`  expected: ${scriptPath}`);
-                process.exit(1);
-            }
-            const { spawnSync } = await import('node:child_process');
-            const dryRun = args.includes('--dry-run');
-            const spawnArgs = dryRun ? ['--dry-run'] : [];
-            const result = spawnSync('bash', [scriptPath, ...spawnArgs], { stdio: 'inherit' });
-            if (result.status !== 0) {
-                process.exit(result.status ?? 1);
-            }
+            const { handleDev } = await import('./core/dev-cli.js');
+            await handleDev(args);
         },
     },
     {
@@ -269,23 +255,17 @@ const commands = [
             await handleInspect(args);
         },
     },
-    {
-        name: 'onboarding',
-        description: 'v1 4-question onboarding flow',
-        handler: async (_args) => {
-            const { runOnboarding } = await import('./forge/onboarding-cli.js');
-            await runOnboarding();
-        },
-    },
     {
         name: 'doctor',
-        description: 'Diagnostics (--quick for fast check, --prune-state to GC, --repair to auto-fix)',
+        description: 'Diagnostics (--quick fast check, --prune-state GC, --repair auto-fix, --reclaim legacy-rules scan)',
         handler: async (args) => {
             const { runDoctor } = await import('./core/doctor.js');
             await runDoctor({
                 pruneState: args.includes('--prune-state'),
                 repair: args.includes('--repair'),
                 quick: args.includes('--quick'),
+                reclaim: args.includes('--reclaim'),
+                verbose: args.includes('--verbose'),
             });
         },
     },
@@ -334,38 +314,6 @@ const commands = [
             await handleLifecycleScan(args);
         },
     },
-    {
-        name: 'stats',
-        description: 'One-screen dashboard: active rules, corrections, blocks/bypass/drift (7d).',
-        handler: async (args) => {
-            const { handleStats } = await import('./core/stats-cli.js');
-            await handleStats(args);
-        },
-    },
-    {
-        name: 'watch',
-        description: 'Real-time hook event stream (hook firings, blocks, solution matches)',
-        handler: async () => {
-            const { handleWatch } = await import('./core/watch-cli.js');
-            await handleWatch();
-        },
-    },
-    {
-        name: 'health',
-        description: 'Single-line health score (0-100) combining utilization, effectiveness, growth.',
-        handler: async () => {
-            const { handleHealth } = await import('./core/health-cli.js');
-            await handleHealth();
-        },
-    },
-    {
-        name: 'probe-workflow',
-        description: 'ADR-009 §1: measure whether dynamic-workflow subagents fire forgen hooks (arm|report|status).',
-        handler: async (args) => {
-            const { handleProbeWorkflow } = await import('./core/probe-workflow-cli.js');
-            await handleProbeWorkflow(args);
-        },
-    },
     {
         name: 'workflows',
         description: 'Install/list forgen dynamic-workflow templates (install [--project] | list).',
@@ -374,14 +322,6 @@ const commands = [
             await handleWorkflows(args);
         },
     },
-    {
-        name: 'explain',
-        description: 'Explain the most recent block — what rule, why, and how to resolve.',
-        handler: async (args) => {
-            const { handleExplain } = await import('./core/explain-cli.js');
-            await handleExplain(args);
-        },
-    },
     {
         name: 'changelog',
         description: 'Auto-summarize changes since last release tag (conventional commits).',
@@ -390,38 +330,6 @@ const commands = [
             await handleChangelog();
         },
     },
-    {
-        name: 'last-block',
-        description: 'Show the most recent Mech-A/B block event with rule detail (R6-UX2).',
-        handler: async (_args) => {
-            const { handleInspect } = await import('./core/inspect-cli.js');
-            await handleInspect(['violations', '--last', '1']);
-        },
-    },
-    {
-        name: 'recall',
-        description: 'Show recent compound recalls (matched solutions) with optional body preview.',
-        handler: async (args) => {
-            const { handleRecall } = await import('./core/recall-cli.js');
-            await handleRecall(args);
-        },
-    },
-    {
-        name: 'migrate',
-        description: 'One-shot schema migrations (implicit-feedback category backfill).',
-        handler: async (args) => {
-            const { handleMigrate } = await import('./core/migrate-cli.js');
-            await handleMigrate(args);
-        },
-    },
-    {
-        name: 'regress-map',
-        description: 'Top fix-touched files in the last N days (--days 30 --top 10 --json).',
-        handler: async (args) => {
-            const { handleRegressMap } = await import('./core/regress-map-cli.js');
-            await handleRegressMap(args);
-        },
-    },
     {
         name: 'suppress-rule',
         description: '[alias: rule suppress] Disable a rule by id/prefix. Hard rules refused.',
@@ -460,6 +368,7 @@ async function handleRuleNamespace(args) {
     forgen rule health-scan [--apply]      Scan drift → Mech downgrade candidates
     forgen rule classify [--apply] [--force]
                                            Propose enforce_via for legacy rules
+    forgen rule unmerge-cluster <id>       Undo a W3-2 correction-cluster merge (restore originals)
 `);
         return;
     }
@@ -494,6 +403,24 @@ async function handleRuleNamespace(args) {
             await handleClassifyEnforce(rest);
             return;
         }
+        case 'unmerge-cluster': {
+            // W3-2: 교정 클러스터 통합 취소 — 원본 룰 복원 + 재통합 억제.
+            const mergedId = rest[0];
+            if (!mergedId) {
+                console.error('[forgen] usage: forgen rule unmerge-cluster <merged-rule-id>');
+                process.exit(1);
+            }
+            const { unmergeCluster } = await import('./engine/correction-cluster-runner.js');
+            const res = unmergeCluster(mergedId);
+            if (res.ok) {
+                console.log(`✓ [forgen] 클러스터 통합 취소 — 원본 ${res.restored.length}룰 복원 (재통합 억제됨)`);
+            }
+            else {
+                console.error(`[forgen] unmerge 실패: ${res.reason}`);
+                process.exit(1);
+            }
+            return;
+        }
         default: {
             console.error(`[forgen] Unknown rule subcommand: ${sub}\n  Run "forgen rule help" for options.`);
             process.exit(1);
@@ -532,6 +459,18 @@ async function main() {
         console.log(PKG_VERSION);
         return;
     }
+    // W3-3: OpenCode plugin 슬림이 per-tool-call 로 호출하는 경량 브릿지 (heavy init 우회).
+    if (args[0] === 'opencode-guard') {
+        const { runOpencodeGuard } = await import('./host/opencode/guard-cli.js');
+        await runOpencodeGuard();
+        return;
+    }
+    // W3-3: OpenCode plugin 이 compaction 시 주입할 forgen context (forge-loop 상태) 출력.
+    if (args[0] === 'opencode-context') {
+        const { runOpencodeContext } = await import('./host/opencode/context-cli.js');
+        runOpencodeContext();
+        return;
+    }
     const cmd = findCommand(args[0]);
     if (cmd) {
         await cmd.handler(args.slice(1));
@@ -540,11 +479,24 @@ async function main() {
     // 등록되지 않은 서브커맨드는 에러 처리
     // 플래그(--resume 등), 따옴표 프롬프트, 인자 없는 실행은 하네스로 통과
     if (args[0] && !args[0].startsWith('-') && !args[0].startsWith('"') && !args[0].startsWith("'")) {
-        const suggestion = commands
-            .map(c => ({ name: c.name, dist: levenshtein(args[0], c.name) }))
-            .filter(c => c.dist <= 3)
-            .sort((a, b) => a.dist - b.dist)[0];
-        const hint = suggestion ? `\n  Did you mean: forgen ${suggestion.name}` : '';
+        // Wave 1 통합(feature-audit): 제거된 명령 → 새 위치 명시 매핑 (levenshtein 오유도 방지).
+        const RENAMED = {
+            stats: 'status', health: 'status', dashboard: 'status --overview', me: 'status --profile',
+            recall: 'status --compound', explain: 'status --blocks', 'last-block': 'status --blocks',
+            watch: 'status --live', 'probe-workflow': 'dev probe-workflow', parity: 'dev parity',
+            migrate: 'dev migrate', 'regress-map': 'dev regress-map', onboarding: 'forge --onboarding',
+        };
+        let hint;
+        if (RENAMED[args[0]]) {
+            hint = `\n  → moved: forgen ${RENAMED[args[0]]}`;
+        }
+        else {
+            const suggestion = commands
+                .map(c => ({ name: c.name, dist: levenshtein(args[0], c.name) }))
+                .filter(c => c.dist <= 3)
+                .sort((a, b) => a.dist - b.dist)[0];
+            hint = suggestion ? `\n  Did you mean: forgen ${suggestion.name}` : '';
+        }
         console.error(`[forgen] Unknown command: ${args[0]}${hint}\n  Run "forgen help" for available commands.`);
         process.exit(1);
     }
@@ -621,28 +573,22 @@ function printHelp() {
     forgen --runtime claude|codex   Select launch runtime
 
   Commands:
-    forgen forge                    Personalize your coding profile
-    forgen onboarding               Run 4-question onboarding
+    forgen forge [--onboarding|--profile|--reset]
+                                    Personalization single entry (first run = 4-question onboarding)
     forgen inspect [profile|rules|corrections|session]
                                     Inspect v1 state (alias: evidence → corrections)
     forgen rule <list|suppress|activate|scan|health-scan|classify>
                                     Rule management (see: forgen rule help)
-    forgen stats                    One-screen trust-layer dashboard (+ philosophy)
-    forgen health                   Single-line health score (0-100) with grade
-    forgen probe-workflow arm|report  Measure if dynamic-workflow subagents fire hooks (ADR-009 §1)
+    forgen status [view]            Unified status — one screen; views:
+                                      --compound  compound health + recent recalls
+                                      --profile   4-axis profile + recent corrections
+                                      --rules     active rules
+                                      --blocks [N] recent block(s): rule/reason/fix
+                                      --overview  rich dashboard (hooks·history·curve)
+                                      --live      real-time hook event stream
     forgen workflows install|list   Install forgen dynamic-workflow templates to .claude/workflows/
-    forgen watch                    Real-time hook event stream (tail logs live)
-    forgen explain [N]              Explain the last N block(s) — rule, reason, resolution
     forgen changelog                Auto-summarize commits since last release tag
-    forgen last-block               Show the most recent block event
-    forgen recall [--limit N] [--show]
-                                    최근 compound 주입 이력 (solution body preview)
-    forgen migrate [implicit-feedback|evidence-host|all]
-                                    One-shot schema migration (category backfill / host backfill)
-    forgen parity codex [--dry-run] Run codex parity checks (source checkout only)
     forgen compound                 Manage accumulated knowledge
-    forgen dashboard                Compound system dashboard
-    forgen me                       Personal dashboard
     forgen init                     Initialize project (+ starter-pack solutions)
     forgen config hooks             Hook management
     forgen mcp                      MCP server management

package/dist/core/auto-compound-runner.d.ts

@@ -10,15 +10,4 @@
  * 인자: [cwd] [transcriptPath] [sessionId]
  */
 import { type ExecFileOptions } from 'node:child_process';
-/**
- * 0.4.6 perf #12 — async 변형. 3 LLM 호출 (solution / user-pattern / learning) 을
- * Promise.allSettled 로 병렬 실행하여 wall-clock 을 sum → max 로 단축 (~3x).
- *
- * 0.4.6 에서는 adaptive cooldown 으로 wasted runs 차단을 우선 적용했고, 호출부
- * full parallelization 은 0.4.7 로 분리 (refactor surface 큼 — solution call 의
- * `--allowedTools` sandbox 와 file-write 순서 invariant 검증 필요).
- *
- * 본 함수는 0.4.7 작업의 foundation 으로 박제 — export 하여 unused warning 회피.
- * 동작은 sync 버전과 동일: Claude/Codex 분기 + retry on transient.
- */
 export declare function execClaudeRetryAsync(args: string[], opts: ExecFileOptions): Promise<string>;