@wooojin/forgen 0.6.8 → 0.6.9

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
Files changed (221) hide show
  1. package/.claude-plugin/plugin.json +1 -1
  2. package/CHANGELOG.md +17 -0
  3. package/README.ja.md +15 -10
  4. package/README.ko.md +15 -10
  5. package/README.md +19 -14
  6. package/README.zh.md +13 -8
  7. package/dist/checks/dangerous-response-pattern.d.ts +2 -1
  8. package/dist/checks/dangerous-response-pattern.js +27 -3
  9. package/dist/cli.js +133 -17
  10. package/dist/core/auto-compound-runner.js +502 -397
  11. package/dist/core/block-cli.js +7 -3
  12. package/dist/core/compound-consent.d.ts +18 -0
  13. package/dist/core/compound-consent.js +101 -6
  14. package/dist/core/compound-sweep-cli.d.ts +16 -0
  15. package/dist/core/compound-sweep-cli.js +67 -5
  16. package/dist/core/config-hooks.js +28 -10
  17. package/dist/core/correction-signals.d.ts +9 -0
  18. package/dist/core/correction-signals.js +37 -0
  19. package/dist/core/dev-cli.d.ts +1 -2
  20. package/dist/core/dev-cli.js +9 -28
  21. package/dist/core/doctor-verify.d.ts +35 -0
  22. package/dist/core/doctor-verify.js +502 -0
  23. package/dist/core/doctor.d.ts +4 -6
  24. package/dist/core/doctor.js +103 -184
  25. package/dist/core/explain-cli.js +8 -0
  26. package/dist/core/extraction-haiku.d.ts +64 -0
  27. package/dist/core/extraction-haiku.js +208 -0
  28. package/dist/core/extraction-queue.d.ts +68 -0
  29. package/dist/core/extraction-queue.js +300 -0
  30. package/dist/core/flow-status.d.ts +93 -0
  31. package/dist/core/flow-status.js +368 -0
  32. package/dist/core/harness.js +14 -42
  33. package/dist/core/inspect-cli.js +37 -13
  34. package/dist/core/lifecycle-classifier.d.ts +5 -1
  35. package/dist/core/lifecycle-classifier.js +13 -2
  36. package/dist/core/migrate-cli.d.ts +1 -1
  37. package/dist/core/migrate-cli.js +11 -11
  38. package/dist/core/migrate-tenetx.d.ts +1 -1
  39. package/dist/core/migrate-tenetx.js +2 -2
  40. package/dist/core/node-engine.d.ts +3 -0
  41. package/dist/core/node-engine.js +8 -0
  42. package/dist/core/observability-store.d.ts +15 -0
  43. package/dist/core/observability-store.js +73 -0
  44. package/dist/core/paths.d.ts +2 -0
  45. package/dist/core/paths.js +2 -0
  46. package/dist/core/rendered-rules-manifest.d.ts +7 -1
  47. package/dist/core/rendered-rules-manifest.js +45 -1
  48. package/dist/core/session-store.d.ts +13 -11
  49. package/dist/core/session-store.js +103 -119
  50. package/dist/core/settings-injector.d.ts +5 -2
  51. package/dist/core/settings-injector.js +21 -88
  52. package/dist/core/spawn.d.ts +9 -1
  53. package/dist/core/spawn.js +33 -33
  54. package/dist/core/stats-cli.d.ts +7 -0
  55. package/dist/core/stats-cli.js +66 -93
  56. package/dist/core/status-cli.d.ts +1 -1
  57. package/dist/core/status-cli.js +23 -4
  58. package/dist/core/statusline-cli.js +5 -0
  59. package/dist/core/statusline-install.d.ts +10 -2
  60. package/dist/core/statusline-install.js +27 -4
  61. package/dist/core/transcript-summary.d.ts +84 -9
  62. package/dist/core/transcript-summary.js +283 -49
  63. package/dist/core/uninstall.d.ts +4 -0
  64. package/dist/core/uninstall.js +68 -36
  65. package/dist/core/v1-bootstrap.d.ts +1 -1
  66. package/dist/core/v1-bootstrap.js +38 -9
  67. package/dist/engine/acted-on-evidence.d.ts +8 -0
  68. package/dist/engine/acted-on-evidence.js +38 -0
  69. package/dist/engine/block-judge.d.ts +3 -1
  70. package/dist/engine/block-judge.js +4 -3
  71. package/dist/engine/compound-cli.d.ts +26 -2
  72. package/dist/engine/compound-cli.js +143 -19
  73. package/dist/engine/compound-lifecycle.d.ts +36 -2
  74. package/dist/engine/compound-lifecycle.js +131 -11
  75. package/dist/engine/compound-loop.d.ts +4 -0
  76. package/dist/engine/compound-loop.js +93 -18
  77. package/dist/engine/correction-cluster-runner.d.ts +11 -1
  78. package/dist/engine/correction-cluster-runner.js +39 -15
  79. package/dist/engine/correction-clustering.d.ts +11 -0
  80. package/dist/engine/correction-clustering.js +20 -3
  81. package/dist/engine/lifecycle/lifecycle-cli.js +10 -3
  82. package/dist/engine/lifecycle/meta-reclassifier.d.ts +9 -0
  83. package/dist/engine/lifecycle/meta-reclassifier.js +15 -3
  84. package/dist/engine/lifecycle/orchestrator.js +3 -2
  85. package/dist/engine/lifecycle/signals.d.ts +19 -1
  86. package/dist/engine/lifecycle/signals.js +61 -2
  87. package/dist/engine/lifecycle/trigger-t1-correction.d.ts +1 -1
  88. package/dist/engine/lifecycle/trigger-t1-correction.js +9 -28
  89. package/dist/engine/lifecycle/trigger-t5-conflict.d.ts +8 -0
  90. package/dist/engine/lifecycle/trigger-t5-conflict.js +60 -2
  91. package/dist/engine/roi-demotion.d.ts +11 -0
  92. package/dist/engine/roi-demotion.js +50 -8
  93. package/dist/engine/rule-detectability.d.ts +39 -0
  94. package/dist/engine/rule-detectability.js +66 -0
  95. package/dist/engine/rule-project-cli.d.ts +25 -0
  96. package/dist/engine/rule-project-cli.js +148 -0
  97. package/dist/engine/rule-recovery-cli.d.ts +21 -0
  98. package/dist/engine/rule-recovery-cli.js +265 -0
  99. package/dist/engine/rule-toggle-cli.d.ts +14 -2
  100. package/dist/engine/rule-toggle-cli.js +94 -6
  101. package/dist/engine/skill-promoter.d.ts +14 -8
  102. package/dist/engine/skill-promoter.js +57 -85
  103. package/dist/engine/solution-format.d.ts +26 -1
  104. package/dist/engine/solution-format.js +65 -3
  105. package/dist/engine/solution-habit.d.ts +1 -0
  106. package/dist/engine/solution-habit.js +22 -0
  107. package/dist/engine/solution-index.d.ts +5 -0
  108. package/dist/engine/solution-index.js +32 -0
  109. package/dist/engine/solution-matcher-eval.js +4 -4
  110. package/dist/engine/solution-matcher.js +15 -13
  111. package/dist/engine/solution-scope.d.ts +11 -0
  112. package/dist/engine/solution-scope.js +19 -0
  113. package/dist/engine/solution-writer.d.ts +3 -1
  114. package/dist/engine/solution-writer.js +3 -2
  115. package/dist/engine/term-normalizer.js +49 -0
  116. package/dist/fgx.js +1 -1
  117. package/dist/forge/cli.js +51 -8
  118. package/dist/forge/evidence-processor.js +6 -0
  119. package/dist/hooks/context-guard.d.ts +0 -22
  120. package/dist/hooks/context-guard.js +22 -55
  121. package/dist/hooks/context-usage.d.ts +21 -0
  122. package/dist/hooks/context-usage.js +103 -0
  123. package/dist/hooks/dangerous-patterns.json +1 -16
  124. package/dist/hooks/db-guard.d.ts +1 -1
  125. package/dist/hooks/db-guard.js +21 -30
  126. package/dist/hooks/hook-config.d.ts +2 -0
  127. package/dist/hooks/hook-config.js +5 -1
  128. package/dist/hooks/hooks-generator.d.ts +4 -0
  129. package/dist/hooks/hooks-generator.js +10 -4
  130. package/dist/hooks/permission-handler.js +23 -3
  131. package/dist/hooks/post-tool-use.js +14 -10
  132. package/dist/hooks/pre-tool-use.d.ts +17 -3
  133. package/dist/hooks/pre-tool-use.js +143 -30
  134. package/dist/hooks/rate-limiter.js +12 -7
  135. package/dist/hooks/secret-filter.js +15 -4
  136. package/dist/hooks/session-end.d.ts +2 -2
  137. package/dist/hooks/session-end.js +13 -7
  138. package/dist/hooks/session-recovery.js +79 -50
  139. package/dist/hooks/shared/command-analyzer.d.ts +45 -0
  140. package/dist/hooks/shared/command-analyzer.js +972 -0
  141. package/dist/hooks/shared/command-parser.d.ts +5 -29
  142. package/dist/hooks/shared/command-parser.js +65 -35
  143. package/dist/hooks/shared/commit-guard.d.ts +15 -0
  144. package/dist/hooks/shared/commit-guard.js +176 -0
  145. package/dist/hooks/shared/hook-response.d.ts +6 -0
  146. package/dist/hooks/shared/hook-response.js +12 -0
  147. package/dist/hooks/shared/hook-timing.js +9 -3
  148. package/dist/hooks/shared/injection-caps.d.ts +32 -2
  149. package/dist/hooks/shared/injection-caps.js +73 -2
  150. package/dist/hooks/shared/is-main.d.ts +8 -0
  151. package/dist/hooks/shared/is-main.js +20 -0
  152. package/dist/hooks/shared/tool-response.d.ts +6 -0
  153. package/dist/hooks/shared/tool-response.js +30 -0
  154. package/dist/hooks/slop-detector.js +6 -3
  155. package/dist/hooks/solution-injector.d.ts +23 -0
  156. package/dist/hooks/solution-injector.js +102 -101
  157. package/dist/hooks/stop-guard.d.ts +11 -1
  158. package/dist/hooks/stop-guard.js +28 -11
  159. package/dist/hooks/subagent-stop-guard.js +2 -1
  160. package/dist/hooks/subagent-tracker.js +2 -1
  161. package/dist/host/capabilities-codex.js +1 -0
  162. package/dist/host/claude-shim.d.ts +24 -0
  163. package/dist/host/claude-shim.js +68 -0
  164. package/dist/host/codex-hook-shim.d.ts +3 -1
  165. package/dist/host/codex-hook-shim.js +7 -5
  166. package/dist/host/codex-notify.js +1 -1
  167. package/dist/host/codex-rules-context.d.ts +6 -4
  168. package/dist/host/codex-rules-context.js +11 -24
  169. package/dist/host/exec-host.d.ts +5 -1
  170. package/dist/host/exec-host.js +15 -4
  171. package/dist/host/install-claude.d.ts +47 -14
  172. package/dist/host/install-claude.js +302 -155
  173. package/dist/host/install-codex.d.ts +20 -0
  174. package/dist/host/install-codex.js +32 -1
  175. package/dist/host/install-opencode.d.ts +3 -1
  176. package/dist/host/install-opencode.js +6 -3
  177. package/dist/host/install-orchestrator.js +14 -1
  178. package/dist/host/opencode/translate.d.ts +1 -1
  179. package/dist/host/opencode/translate.js +5 -3
  180. package/dist/host/projection.d.ts +9 -1
  181. package/dist/host/projection.js +19 -2
  182. package/dist/mcp/server.js +5 -0
  183. package/dist/mcp/solution-reader.d.ts +5 -5
  184. package/dist/mcp/solution-reader.js +13 -35
  185. package/dist/mcp/tools.js +18 -1
  186. package/dist/renderer/inspect-renderer.js +4 -2
  187. package/dist/renderer/render-report.d.ts +22 -0
  188. package/dist/renderer/render-report.js +29 -0
  189. package/dist/renderer/rule-renderer.d.ts +28 -2
  190. package/dist/renderer/rule-renderer.js +91 -76
  191. package/dist/store/evidence-store.js +34 -6
  192. package/dist/store/rule-lifecycle.d.ts +3 -1
  193. package/dist/store/rule-lifecycle.js +10 -0
  194. package/dist/store/rule-scope.d.ts +7 -0
  195. package/dist/store/rule-scope.js +54 -0
  196. package/dist/store/rule-store.d.ts +29 -3
  197. package/dist/store/rule-store.js +110 -26
  198. package/dist/store/types.d.ts +22 -2
  199. package/dist/way/cli.d.ts +1 -0
  200. package/dist/way/cli.js +313 -0
  201. package/dist/way/compile.d.ts +22 -0
  202. package/dist/way/compile.js +408 -0
  203. package/dist/way/conflict.d.ts +2 -0
  204. package/dist/way/conflict.js +18 -0
  205. package/dist/way/draft.d.ts +43 -0
  206. package/dist/way/draft.js +335 -0
  207. package/dist/way/extract.d.ts +17 -0
  208. package/dist/way/extract.js +172 -0
  209. package/dist/way/io.d.ts +79 -0
  210. package/dist/way/io.js +425 -0
  211. package/dist/way/similar.d.ts +2 -0
  212. package/dist/way/similar.js +30 -0
  213. package/dist/way/types.d.ts +98 -0
  214. package/dist/way/types.js +2 -0
  215. package/package.json +1 -1
  216. package/plugin.json +1 -1
  217. package/scripts/postinstall.js +76 -899
  218. package/dist/core/health-cli.d.ts +0 -25
  219. package/dist/core/health-cli.js +0 -90
  220. package/dist/host/parity-harness.d.ts +0 -70
  221. package/dist/host/parity-harness.js +0 -287
package/dist/cli.js CHANGED
@@ -38,7 +38,7 @@ const commands = [
38
38
  }
39
39
  // ADR-012: Haiku 추출 동의 토글. `forgen compound consent on|off|status`
40
40
  if (args[0] === 'consent') {
41
- const { getHaikuConsentState, setHaikuCompoundConsent } = await import('./core/compound-consent.js');
41
+ const { getHaikuConsentState, setHaikuCompoundConsent, HAIKU_SCOPE_TEXT, apiBillingNote } = await import('./core/compound-consent.js');
42
42
  const sub = args[1];
43
43
  if (sub === 'on' || sub === 'off') {
44
44
  setHaikuCompoundConsent(sub === 'on');
@@ -47,8 +47,9 @@ const commands = [
47
47
  else {
48
48
  const s = getHaikuConsentState();
49
49
  console.log(`[forgen] auto-compound Haiku 추출: ${s.enabled ? 'ON' : 'OFF'} (source: ${s.source})\n` +
50
- ' ON = 세션 요약을 Haiku 로 전송해 행동패턴 추론 (본인 쿼터, redaction 적용)\n' +
51
- ' OFF = 결정론 교정→룰 승급만 (egress 0, 입증된 δ 경로는 유지)\n' +
50
+ ` ON (기본값) = ${HAIKU_SCOPE_TEXT}\n` +
51
+ (apiBillingNote() ? ` ! ${apiBillingNote()}\n` : '') +
52
+ ' OFF = 결정론 교정→룰 승급·세션 검색만 (전송 없음)\n' +
52
53
  ' 변경: forgen compound consent on|off (env: FORGEN_AUTO_COMPOUND=1 / FORGEN_NO_AUTO_COMPOUND=1)');
53
54
  }
54
55
  return;
@@ -64,15 +65,18 @@ const commands = [
64
65
  const sub = args[0];
65
66
  if (sub === 'promote' && args[1]) {
66
67
  const { promoteSolution } = await import('./engine/skill-promoter.js');
67
- const triggers = args.includes('--trigger')
68
- ? args.slice(args.indexOf('--trigger') + 1).filter(a => !a.startsWith('-'))
69
- : undefined;
70
- const result = promoteSolution(args[1], triggers);
68
+ const outIdx = args.indexOf('--out');
69
+ const result = promoteSolution(args[1], {
70
+ install: args.includes('--install'),
71
+ out: outIdx >= 0 ? args[outIdx + 1] : undefined,
72
+ force: args.includes('--force'),
73
+ });
71
74
  if (result.success) {
72
- console.log(`\n ✓ Promoted: ${args[1]} → ${result.skillPath}\n`);
75
+ console.log(`\n ✓ Promoted: ${args[1]}\n${(result.paths ?? []).map((p) => ` ${p}`).join('\n')}\n`);
73
76
  }
74
77
  else {
75
78
  console.log(`\n ✗ ${result.reason}\n`);
79
+ process.exitCode = 1;
76
80
  }
77
81
  }
78
82
  else if (sub === 'list') {
@@ -84,16 +88,28 @@ const commands = [
84
88
  else {
85
89
  console.log(`\n Promoted Skills (${skills.length}):\n`);
86
90
  for (const s of skills) {
87
- console.log(` ${s.name} [${s.status}] triggers: ${s.triggers.join(', ')}`);
91
+ console.log(` ${s.name} [${s.status}] ${s.description}`);
88
92
  }
89
93
  console.log('');
90
94
  }
91
95
  }
92
96
  else {
93
- console.log(' Usage:\n forgen skill promote <solution-name> [--trigger "keyword"]\n forgen skill list');
97
+ console.log(' Usage:\n forgen skill promote <solution-name> [--install] [--out <dir>] [--force]\n forgen skill list');
98
+ if (sub) {
99
+ console.error(`[forgen] Unknown skill subcommand: ${sub}`);
100
+ process.exitCode = 1;
101
+ }
94
102
  }
95
103
  },
96
104
  },
105
+ {
106
+ name: 'way',
107
+ description: 'Your way of working: summary, export to other models, import, collect host memory',
108
+ handler: async (args) => {
109
+ const { handleWay } = await import('./way/cli.js');
110
+ await handleWay(args);
111
+ },
112
+ },
97
113
  {
98
114
  name: 'block',
99
115
  description: 'Judge a block receipt: forgen block <id|prefix> --ok | --fp [--reason "..."] (ADR-017 D1)',
@@ -173,6 +189,10 @@ const commands = [
173
189
  }
174
190
  else {
175
191
  console.log('Usage:\n forgen config hooks [--regenerate]\n forgen config default-host [claude|codex|ask]');
192
+ if (sub) {
193
+ console.error(`[forgen] Unknown config subcommand: ${sub}`);
194
+ process.exitCode = 1;
195
+ }
176
196
  }
177
197
  },
178
198
  },
@@ -200,6 +220,8 @@ const commands = [
200
220
  const target = args[0] && knownSubs.has(args[0]) ? args[0] : args[0]?.startsWith('--') ? undefined : args[0];
201
221
  if (target !== undefined && !knownSubs.has(target)) {
202
222
  console.log('Usage:\n forgen install [claude|codex|opencode|both] [--dry-run] [--no-mcp] [--no-notify] [--no-verify-skill]\n\n No arg → interactive 3-choice (Claude/Codex/Both). opencode: 명시 타겟(P1 실험적).\n --no-notify: Codex config.toml 에 notify 폴백을 등록하지 않음.\n --no-verify-skill: Claude ~/.claude/skills/verify 를 설치하지 않음.');
223
+ console.error(`[forgen] Unknown install target: ${target}`);
224
+ process.exitCode = 1;
203
225
  return;
204
226
  }
205
227
  const dryRun = args.includes('--dry-run');
@@ -216,6 +238,8 @@ const commands = [
216
238
  return;
217
239
  }
218
240
  console.log(renderResult(result, dryRun));
241
+ if (result.claude?.errors.length)
242
+ process.exitCode = 1;
219
243
  },
220
244
  },
221
245
  {
@@ -245,12 +269,16 @@ const commands = [
245
269
  }
246
270
  else {
247
271
  console.log('Usage:\n forgen maintenance --backfill [--phase A|B|all] [--force] [--dry-run]');
272
+ if (args.length > 0) {
273
+ console.error(`[forgen] Unknown maintenance option: ${args.join(' ')}`);
274
+ process.exitCode = 1;
275
+ }
248
276
  }
249
277
  },
250
278
  },
251
279
  {
252
280
  name: 'dev',
253
- description: 'Developer/maintenance utilities: dev <probe-workflow|parity|migrate|regress-map>',
281
+ description: 'Developer/maintenance utilities: dev <probe-workflow|migrate|regress-map>',
254
282
  handler: async (args) => {
255
283
  const { handleDev } = await import('./core/dev-cli.js');
256
284
  await handleDev(args);
@@ -277,13 +305,15 @@ const commands = [
277
305
  description: 'Diagnostics (--quick fast check, --prune-state GC, --repair auto-fix, --reclaim legacy-rules scan)',
278
306
  handler: async (args) => {
279
307
  const { runDoctor } = await import('./core/doctor.js');
280
- await runDoctor({
308
+ const failed = await runDoctor({
281
309
  pruneState: args.includes('--prune-state'),
282
310
  repair: args.includes('--repair'),
283
311
  quick: args.includes('--quick'),
284
312
  reclaim: args.includes('--reclaim'),
285
313
  verbose: args.includes('--verbose'),
286
314
  });
315
+ if (failed > 0)
316
+ process.exitCode = 1;
287
317
  },
288
318
  },
289
319
  // install --plugin 제거됨 — postinstall이 유일한 설치 경로
@@ -387,10 +417,19 @@ async function handleRuleNamespace(args) {
387
417
  forgen rule classify [--apply] [--force]
388
418
  Propose enforce_via for legacy rules
389
419
  forgen rule unmerge-cluster <id> Undo a W3-2 correction-cluster merge (restore originals)
420
+ forgen rule revive <id-or-prefix> [--reason ".."] Bring a removed/archived rule back as permanent
421
+ forgen rule snapshot Snapshot rules, corrections, solutions
422
+ forgen rule restore [<name> --yes] List snapshots or restore one
423
+ forgen rule set-project <id> <key>|--global Limit a rule to one project
424
+ forgen rule classify-projects --project <key> --keywords a,b [--apply]
425
+ forgen rule import-pack <pack> [--project <key>] [--apply]
390
426
  forgen rule merge-mined [--apply] ADR-017 D3: merge mined (auto:) rules among themselves,
391
427
  link same-concept ones to explicit rules (dry-run by default)
392
428
  forgen rule unmerge <id> Restore originals of a merged/linked rule (alias of unmerge-cluster)
393
- forgen rule enforce <id-or-prefix> ADR-017 D1: restore blocking for a rule auto-demoted to advise
429
+ forgen rule recover [--apply <id...>] Find your corrections that did not survive as active rules
430
+ forgen rule enforce <id-or-prefix> Turn on blocking for a rule (semantic rules only record by default)
431
+ forgen rule merge-explicit [--apply <id...>] list proposed merges (with ids); apply only the listed ids
432
+ forgen rule restore-demoted [--apply] restore precision-auto-demoted (advise) rules to their previous mode (preview by default)
394
433
  forgen rule advise <id-or-prefix> Record-only mode (no block); hard rules refused
395
434
  `);
396
435
  return;
@@ -432,6 +471,48 @@ async function handleRuleNamespace(args) {
432
471
  await handleEnforceMode(rest, sub === 'advise' ? 'advise' : 'block');
433
472
  return;
434
473
  }
474
+ case 'merge-explicit': {
475
+ const { handleMergeExplicit } = await import('./engine/rule-toggle-cli.js');
476
+ await handleMergeExplicit(rest);
477
+ return;
478
+ }
479
+ case 'restore-demoted': {
480
+ const { handleRestoreDemoted } = await import('./engine/rule-toggle-cli.js');
481
+ await handleRestoreDemoted(rest);
482
+ return;
483
+ }
484
+ case 'set-project':
485
+ case 'classify-projects':
486
+ case 'import-pack': {
487
+ const { handleSetProject, handleClassifyProjects, handleImportPack } = await import('./engine/rule-project-cli.js');
488
+ if (sub === 'set-project')
489
+ handleSetProject(rest);
490
+ else if (sub === 'classify-projects')
491
+ handleClassifyProjects(rest);
492
+ else
493
+ handleImportPack(rest);
494
+ return;
495
+ }
496
+ case 'revive': {
497
+ const { handleRuleRevive } = await import('./engine/rule-recovery-cli.js');
498
+ handleRuleRevive(rest);
499
+ return;
500
+ }
501
+ case 'recover': {
502
+ const { handleRuleRecover } = await import('./engine/rule-recovery-cli.js');
503
+ handleRuleRecover(rest);
504
+ return;
505
+ }
506
+ case 'snapshot': {
507
+ const { handleRuleSnapshot } = await import('./engine/rule-recovery-cli.js');
508
+ handleRuleSnapshot();
509
+ return;
510
+ }
511
+ case 'restore': {
512
+ const { handleRuleRestore } = await import('./engine/rule-recovery-cli.js');
513
+ handleRuleRestore(rest);
514
+ return;
515
+ }
435
516
  case 'merge-mined': {
436
517
  // ADR-017 D3: 채굴 룰 병합(채굴끼리) + explicit 동개념 링크. 기본 dry-run.
437
518
  const { handleMergeMined } = await import('./engine/mined-rule-merge-cli.js');
@@ -496,6 +577,12 @@ async function main() {
496
577
  console.log(PKG_VERSION);
497
578
  return;
498
579
  }
580
+ if (args[0] !== 'statusline') {
581
+ const { nodeEngineWarning } = await import('./core/node-engine.js');
582
+ const w = nodeEngineWarning();
583
+ if (w)
584
+ console.error(w);
585
+ }
499
586
  // W3-3: OpenCode plugin 슬림이 per-tool-call 로 호출하는 경량 브릿지 (heavy init 우회).
500
587
  if (args[0] === 'opencode-guard') {
501
588
  const { runOpencodeGuard } = await import('./host/opencode/guard-cli.js');
@@ -520,7 +607,7 @@ async function main() {
520
607
  const RENAMED = {
521
608
  stats: 'status', health: 'status', dashboard: 'status --overview', me: 'status --profile',
522
609
  recall: 'status --compound', explain: 'status --blocks', 'last-block': 'status --blocks',
523
- watch: 'status --live', 'probe-workflow': 'dev probe-workflow', parity: 'dev parity',
610
+ watch: 'status --live', 'probe-workflow': 'dev probe-workflow',
524
611
  migrate: 'dev migrate', 'regress-map': 'dev regress-map', onboarding: 'forge --onboarding',
525
612
  };
526
613
  let hint;
@@ -630,15 +717,44 @@ function printHelp() {
630
717
  forgen init Initialize project (+ starter-pack solutions)
631
718
  forgen config hooks Hook management
632
719
  forgen mcp MCP server management
633
- forgen skill promote|list Skill management
720
+ forgen skill promote|list Skill management (promote writes a standard SKILL.md; --install → ~/.claude/skills)
721
+ forgen way [--all|--json] Your way of working in one screen: rules you said vs inferred, enforced vs advisory
722
+ forgen way export --target <agents-md|claude-rules|skill|system-prompt|gemini|cursor|workflow|json>
723
+ [--project k] [--budget n] [--out dir] [--force] (stdout preview unless --out)
724
+ forgen way import <file.json> [--apply] Round-trip edits back into rules (preview by default)
725
+ forgen way collect-memory [--dir path] [--apply] Read Claude memory feedback_*.md as rule candidates
726
+ forgen way draft <skill|workflow> "<topic>" [--project k] [--out dir] [--no-llm]
727
+ Gather related rules/solutions/corrections and draft a SKILL.md or host-neutral workflow checklist
728
+ with an isolated Haiku call (preview unless --out; evidence ids go in a sidecar file)
634
729
  forgen notepad show|add|clear Session notepad
635
- forgen doctor [--quick|--prune-state|--repair] System diagnostics
730
+ forgen doctor [--quick|--prune-state|--repair] System diagnostics (runs hooks/MCP/statusLine for real; exit 1 on failure)
636
731
  forgen uninstall Remove forgen
732
+ forgen install [claude|codex|opencode|both] Register forgen into a host (hooks·MCP·statusLine)
733
+ forgen statusline [install] Claude Code HUD; \`install\` registers it in settings.json
734
+ forgen block <id> --ok|--fp Judge a block receipt (correct / false positive)
735
+ forgen learn fix-up|quarantine|fitness Solution maintenance
736
+ forgen maintenance --backfill Observability backfill
737
+ forgen dev <probe-workflow|migrate|regress-map> Developer/maintenance utilities
738
+
739
+ Rule shortcuts (same as \`forgen rule <sub>\`; kept for scripts):
740
+ forgen classify-enforce = rule classify
741
+ forgen rule-meta-scan = rule health-scan
742
+ forgen lifecycle-scan = rule scan
743
+ forgen suppress-rule <id> = rule suppress
744
+ forgen activate-rule <id> = rule activate
745
+
746
+ Host bridges (called by editors/plugins, not by hand):
747
+ forgen opencode-guard OpenCode per-tool-call guard
748
+ forgen opencode-context OpenCode compaction context
637
749
 
638
750
  Harness mode (default):
639
751
  Wraps Claude (or Codex) with personalization, auto-compound, and safety hooks.
640
752
  `);
641
753
  }
642
- main().catch(() => {
754
+ main().catch((err) => {
755
+ // 이전에는 사유 없이 exit 1 만 해서 권한·파싱 오류가 "출력 0바이트 실패" 로 보였다.
756
+ const msg = err instanceof Error ? (process.env.FORGEN_DEBUG ? (err.stack ?? err.message) : err.message) : String(err);
757
+ console.error(`[forgen] 오류: ${msg}`);
758
+ console.error(' 자세한 스택: FORGEN_DEBUG=1 forgen <명령> 진단: forgen doctor');
643
759
  process.exit(1);
644
760
  });