@wooojin/forgen 0.2.0 → 0.3.0

package/dist/mcp/solution-reader.d.ts

@@ -13,8 +13,8 @@
  *   - 인덱스 캐시는 isIndexStale()에 의존 (resetIndexCache 미사용)
  *     → 디렉토리 mtime이 변하지 않으면 캐시 재사용 (성능)
  */
-import type { SolutionDirConfig } from '../engine/solution-index.js';
 import type { SolutionStatus, SolutionType } from '../engine/solution-format.js';
+import type { SolutionDirConfig } from '../engine/solution-index.js';
 export interface SearchOptions {
     dirs?: SolutionDirConfig[];
     type?: SolutionType;
@@ -25,7 +25,7 @@ export interface ListOptions {
     dirs?: SolutionDirConfig[];
     status?: SolutionStatus;
     type?: SolutionType;
-    scope?: 'me' | 'team' | 'project';
+    scope?: 'me' | 'team' | 'project' | 'universal';
     sort?: 'confidence' | 'updated' | 'name';
 }
 export interface SolutionSummary {
@@ -33,7 +33,7 @@ export interface SolutionSummary {
     status: SolutionStatus;
     confidence: number;
     type: SolutionType;
-    scope: 'me' | 'team' | 'project';
+    scope: 'me' | 'team' | 'project' | 'universal';
     tags: string[];
 }
 export interface SearchResult extends SolutionSummary {
@@ -45,7 +45,7 @@ export interface SolutionDetail {
     status: SolutionStatus;
     confidence: number;
     type: SolutionType;
-    scope: 'me' | 'team' | 'project';
+    scope: 'me' | 'team' | 'project' | 'universal';
     tags: string[];
     identifiers: string[];
     context: string;
@@ -55,7 +55,7 @@ export interface SolutionStats {
     total: number;
     byStatus: Record<SolutionStatus, number>;
     byType: Record<SolutionType, number>;
-    byScope: Record<'me' | 'team' | 'project', number>;
+    byScope: Record<'me' | 'team' | 'project' | 'universal', number>;
 }
 /**
  * 기본 솔루션 디렉토리 목록 생성.

package/dist/mcp/solution-reader.js

@@ -16,14 +16,13 @@
 import * as fs from 'node:fs';
 import * as path from 'node:path';
 import { ME_SOLUTIONS, PACKS_DIR } from '../core/paths.js';
-import { getOrBuildIndex } from '../engine/solution-index.js';
-import { extractTags, expandCompoundTags, expandQueryBigrams } from '../engine/solution-format.js';
-import { parseSolutionV3 } from '../engine/solution-format.js';
+import { logMatchDecision } from '../engine/match-eval-log.js';
 import { maskBlockedTokens } from '../engine/phrase-blocklist.js';
-import { mutateSolutionFile } from '../engine/solution-writer.js';
+import { expandCompoundTags, expandQueryBigrams, extractTags, parseSolutionV3, } from '../engine/solution-format.js';
+import { getOrBuildIndex } from '../engine/solution-index.js';
 import { calculateRelevance, shouldRejectByR4T3Rules } from '../engine/solution-matcher.js';
+import { mutateSolutionFile } from '../engine/solution-writer.js';
 import { defaultNormalizer } from '../engine/term-normalizer.js';
-import { logMatchDecision } from '../engine/match-eval-log.js';
 import { filterSolutionContent } from '../hooks/prompt-injection-filter.js';
 // ── 디렉토리 해석 ──
 /**
@@ -31,9 +30,7 @@ import { filterSolutionContent } from '../hooks/prompt-injection-filter.js';
  * MCP 서버에서 cwd를 전달받으면 project 스코프도 포함.
  */
 export function defaultSolutionDirs(cwd) {
-    const dirs = [
-        { dir: ME_SOLUTIONS, scope: 'me' },
-    ];
+    const dirs = [{ dir: ME_SOLUTIONS, scope: 'me' }];
     // 팩 디렉토리 스캔 — 하위에 solutions/ 디렉토리가 있는 팩만 포함
     // PR2c-2 (M7 fix): readdirSync 결과를 정렬해 결정적 순서 보장.
     // 정렬 안 하면 같은 팩 집합도 파일시스템 순서에 따라 다른 cache key/precedence
@@ -107,12 +104,15 @@ export function searchSolutions(query, options) {
         // R4-T2: pass `queryTags` (already masked above) so the union
         // denominator inside calculateRelevance uses the post-mask set, in
         // sync with the matching step.
-        const result = calculateRelevance(queryTags, entry.tags, entry.confidence, { normalizedPromptTags, solutionTagsExpanded: entryTagsExpanded });
+        const result = calculateRelevance(queryTags, entry.tags, entry.confidence, {
+            normalizedPromptTags,
+            solutionTagsExpanded: entryTagsExpanded,
+        });
         // 태그 매칭 + 이름 매칭: 솔루션 이름에 쿼리 단어가 포함되면 boost
         // Compute name match FIRST so R4-T3 cannot silently drop a candidate
         // with strong name-match evidence.
         const nameWords = entry.name.toLowerCase().split(/[-_]/);
-        const nameMatchCount = queryTags.filter(t => nameWords.includes(t)).length;
+        const nameMatchCount = queryTags.filter((t) => nameWords.includes(t)).length;
         const nameBoost = nameMatchCount * 0.1;
         // R4-T3: orchestration-layer specificity guards (mirror of the
         // matching block in solution-matcher.rankCandidates). Reject single-
@@ -121,9 +121,9 @@ export function searchSolutions(query, options) {
         // bypass the R4-T3 gate — a nameMatchCount > 0 is strong evidence.
         let tagRelevance = result.relevance;
         let tagMatches = result.matchedTags;
-        if (nameMatchCount === 0
-            && tagMatches.length > 0
-            && shouldRejectByR4T3Rules(queryTags, tagMatches)) {
+        if (nameMatchCount === 0 &&
+            tagMatches.length > 0 &&
+            shouldRejectByR4T3Rules(queryTags, tagMatches)) {
             tagRelevance = 0;
             tagMatches = [];
         }
@@ -137,7 +137,10 @@ export function searchSolutions(query, options) {
             scope: entry.scope,
             tags: entry.tags,
             relevance: tagRelevance + nameBoost,
-            matchedTags: [...tagMatches, ...queryTags.filter(t => nameWords.includes(t) && !tagMatches.includes(t))],
+            matchedTags: [
+                ...tagMatches,
+                ...queryTags.filter((t) => nameWords.includes(t) && !tagMatches.includes(t)),
+            ],
         });
     }
     results.sort((a, b) => b.relevance - a.relevance);
@@ -152,12 +155,12 @@ export function searchSolutions(query, options) {
             source: 'mcp',
             rawQuery: query,
             normalizedQuery: normalizedPromptTags,
-            candidates: top.map(r => ({
+            candidates: top.map((r) => ({
                 name: r.name,
                 relevance: r.relevance,
                 matchedTerms: r.matchedTags,
             })),
-            rankedTopN: top.slice(0, 5).map(r => r.name),
+            rankedTopN: top.slice(0, 5).map((r) => r.name),
         });
     }
     return top;
@@ -167,7 +170,7 @@ export function searchSolutions(query, options) {
 export function listSolutions(options) {
     const dirs = options?.dirs ?? defaultSolutionDirs();
     const index = getOrBuildIndex(dirs);
-    let entries = index.entries.map(e => ({
+    let entries = index.entries.map((e) => ({
         name: e.name,
         status: e.status,
         confidence: e.confidence,
@@ -176,11 +179,11 @@ export function listSolutions(options) {
         tags: e.tags,
     }));
     if (options?.status)
-        entries = entries.filter(e => e.status === options.status);
+        entries = entries.filter((e) => e.status === options.status);
     if (options?.type)
-        entries = entries.filter(e => e.type === options.type);
+        entries = entries.filter((e) => e.type === options.type);
     if (options?.scope)
-        entries = entries.filter(e => e.scope === options.scope);
+        entries = entries.filter((e) => e.scope === options.scope);
     const sort = options?.sort ?? 'confidence';
     if (sort === 'confidence') {
         entries.sort((a, b) => b.confidence - a.confidence);
@@ -201,7 +204,7 @@ export function listSolutions(options) {
 export function readSolution(name, options) {
     const dirs = options?.dirs ?? defaultSolutionDirs();
     const index = getOrBuildIndex(dirs);
-    const entry = index.entries.find(e => e.name === name);
+    const entry = index.entries.find((e) => e.name === name);
     if (!entry)
         return null;
     let fileContent;
@@ -231,7 +234,7 @@ export function readSolution(name, options) {
     // Pull(MCP) 경로: evidence에 기여 — sessions + reflected 카운트 증가
     // PR2b: solution-writer.mutateSolutionFile로 통합. lock + fresh re-read로 race 방지.
     if (!options?.skipEvidence) {
-        mutateSolutionFile(entry.filePath, sol => {
+        mutateSolutionFile(entry.filePath, (sol) => {
             sol.frontmatter.evidence.sessions += 1;
             sol.frontmatter.evidence.reflected += 1;
             return true;
@@ -258,8 +261,15 @@ export function getSolutionStats(options) {
         total: index.entries.length,
         // retired는 인덱스에서 제외되므로 항상 0 (solution-index.ts:73)
         byStatus: { experiment: 0, candidate: 0, verified: 0, mature: 0, retired: 0 },
-        byType: { pattern: 0, solution: 0, decision: 0, troubleshoot: 0, 'anti-pattern': 0, convention: 0 },
-        byScope: { me: 0, team: 0, project: 0 },
+        byType: {
+            pattern: 0,
+            solution: 0,
+            decision: 0,
+            troubleshoot: 0,
+            'anti-pattern': 0,
+            convention: 0,
+        },
+        byScope: { me: 0, team: 0, project: 0, universal: 0 },
     };
     for (const entry of index.entries) {
         if (entry.status in stats.byStatus)

package/dist/renderer/rule-renderer.js

@@ -6,12 +6,12 @@
  *
  * 파이프라인: filter → dedupe(render_key) → group(category) → order → template → budget
  */
-import { initLocaleFromConfig, getLocale, qualityName, autonomyName, judgmentName, communicationName, RULE_RENDERER } from '../i18n/index.js';
+import { initLocaleFromConfig, getLocale, RULE_RENDERER } from '../i18n/index.js';
 export const DEFAULT_CONTEXT = {
     surface: 'session_start',
     max_rules: 30,
     max_chars: 4000,
-    include_pack_summary: true,
+    include_pack_summary: false,
 };
 // ── Output Sections ──
 const SECTION_ORDER = ['Must Not', 'Working Defaults', 'When To Ask', 'How To Validate', 'How To Report'];
@@ -61,9 +61,11 @@ function dedupeByRenderKey(rules) {
 }
 // ── Template ──
 function ruleToText(rule) {
-    // policy 필드가 이미 사람이 읽을 수 있는 문장이면 그대로 사용
-    // render_key로 템플릿을 찾을 수도 있지만 v1은 policy 직접 사용
-    return rule.policy;
+    // AI-optimized: [category|strength] 태그로 축약하여 토큰 절감
+    // hard 강도는 태그 생략 (Must Not 섹션이 이미 의미를 전달)
+    if (rule.strength === 'hard')
+        return rule.policy;
+    return `[${rule.category}|${rule.strength}] ${rule.policy}`;
 }
 function trustPolicySummary(policy) {
     const s = RULE_RENDERER[getLocale()];
@@ -121,13 +123,9 @@ export function renderRules(rules, state, _profile, ctx = DEFAULT_CONTEXT) {
             sections.get('How To Report').push(rule);
         }
     }
-    // 6. 섹션 조립
+    // 6. 섹션 조립 (AI-optimized: 간결한 태그 형식)
     const parts = [];
-    if (ctx.include_pack_summary) {
-        const l = getLocale();
-        parts.push(`[${qualityName(state.quality_pack, l)} quality / ${autonomyName(state.autonomy_pack, l)} autonomy / ${judgmentName(state.judgment_pack, l)} judgment / ${communicationName(state.communication_pack, l)} communication]`);
-    }
-    let totalChars = parts.reduce((sum, p) => sum + p.length, 0);
+    let totalChars = 0;
     let totalRules = 0;
     for (const name of SECTION_ORDER) {
         const items = sections.get(name);

package/dist/services/session.d.ts

@@ -0,0 +1,19 @@
+/**
+ * Launch-time runtime selection helpers.
+ *
+ * 기본 동작:
+ * - --runtime claude|codex 플래그 우선
+ * - 설정되지 않으면 FORGEN_RUNTIME 환경변수 사용
+ * - 환경변수 미설정 시 claude 기본값
+ *
+ * 목표:
+ * - launch context(런타임 + 정제된 args)를 단일 타입으로 통일
+ * - CLI/fgx에서 수집한 런타임 값을 Harness, Spawn, Hook Generator에 일관되게 전달
+ */
+import { type LaunchContext } from '../core/types.js';
+/**
+ * CLI 인자를 파싱해 런타임 결정 + 런타임 플래그 제거
+ * - --runtime codex
+ * - --runtime=codex
+ */
+export declare function resolveLaunchContext(args: string[]): LaunchContext;

package/dist/services/session.js

@@ -0,0 +1,62 @@
+/**
+ * Launch-time runtime selection helpers.
+ *
+ * 기본 동작:
+ * - --runtime claude|codex 플래그 우선
+ * - 설정되지 않으면 FORGEN_RUNTIME 환경변수 사용
+ * - 환경변수 미설정 시 claude 기본값
+ *
+ * 목표:
+ * - launch context(런타임 + 정제된 args)를 단일 타입으로 통일
+ * - CLI/fgx에서 수집한 런타임 값을 Harness, Spawn, Hook Generator에 일관되게 전달
+ */
+/** 런타임 정규화: 외부 문자열을 내부 enum으로 변환 */
+function parseRuntime(raw) {
+    if (!raw)
+        return null;
+    switch (raw.trim().toLowerCase()) {
+        case 'claude':
+            return 'claude';
+        case 'codex':
+            return 'codex';
+        default:
+            return null;
+    }
+}
+const DEFAULT_RUNTIME = 'claude';
+/**
+ * CLI 인자를 파싱해 런타임 결정 + 런타임 플래그 제거
+ * - --runtime codex
+ * - --runtime=codex
+ */
+export function resolveLaunchContext(args) {
+    const runtimeFromEnv = parseRuntime(process.env.FORGEN_RUNTIME);
+    const result = {
+        runtime: runtimeFromEnv ?? DEFAULT_RUNTIME,
+        args: [],
+        runtimeSource: runtimeFromEnv ? 'env' : 'default',
+    };
+    for (let i = 0; i < args.length; i += 1) {
+        const arg = args[i];
+        if (arg === '--runtime') {
+            const next = args[i + 1];
+            const parsed = parseRuntime(next);
+            if (parsed) {
+                result.runtime = parsed;
+                result.runtimeSource = 'flag';
+                i += 1;
+            }
+            continue;
+        }
+        if (arg.startsWith('--runtime=')) {
+            const parsed = parseRuntime(arg.slice('--runtime='.length));
+            if (parsed) {
+                result.runtime = parsed;
+                result.runtimeSource = 'flag';
+            }
+            continue;
+        }
+        result.args.push(arg);
+    }
+    return result;
+}

package/hooks/hooks.json

@@ -151,7 +151,7 @@
         "hooks": [
           {
             "type": "command",
-            "command": "node \"${CLAUDE_PLUGIN_ROOT}/dist/hooks/subagent-tracker.js\" start",
+            "command": "node \"${CLAUDE_PLUGIN_ROOT}/dist/hooks/subagent-tracker.js\" \"start\"",
             "timeout": 2
           }
         ]
@@ -163,7 +163,7 @@
         "hooks": [
           {
             "type": "command",
-            "command": "node \"${CLAUDE_PLUGIN_ROOT}/dist/hooks/subagent-tracker.js\" stop",
+            "command": "node \"${CLAUDE_PLUGIN_ROOT}/dist/hooks/subagent-tracker.js\" \"stop\"",
             "timeout": 2
           }
         ]

package/package.json

@@ -1,6 +1,7 @@
 {
   "name": "@wooojin/forgen",
-  "version": "0.2.0",
+  "version": "0.3.0",
+  "preferGlobal": true,
   "main": "dist/lib.js",
   "types": "./dist/lib.d.ts",
   "exports": {