@amsterdamdatalabs/enact-factory 0.1.1

package/dist/cli/authHandler.js

@@ -0,0 +1,70 @@
+// ============================================
+// EnactFactory - Auth CLI Handler
+// `enact-factory auth login/status/logout`
+// ============================================
+import { readWorkspaceRootConfig } from '../core/workspaceConfig.js';
+function requireGatewayBaseUrl() {
+    const value = readWorkspaceRootConfig()?.gateway?.['gateway_url'];
+    if (typeof value === 'string' && value.trim())
+        return value;
+    throw new Error('Missing [gateway].gateway_url in workspace config.toml');
+}
+const DEFAULT_GATEWAY_BASE_URL = requireGatewayBaseUrl();
+const RESPONSES_BASE_URL = DEFAULT_GATEWAY_BASE_URL;
+const RESPONSES_API_KEY = process.env.ENACT_RESPONSES_API_KEY ?? process.env.ENACT_GATEWAY_API_KEY ?? '';
+function assertSupportedProvider(provider) {
+    if (provider === 'responses') {
+        return provider;
+    }
+    console.error(`Unsupported provider: "${provider}". Supported provider: "responses".`);
+    process.exit(1);
+}
+/**
+ * Env-based auth setup instructions
+ */
+export async function handleAuthLogin(provider, _opts) {
+    const normalized = assertSupportedProvider(provider);
+    console.log('OAuth login was removed for HTTP adapters.');
+    console.log('');
+    console.log('Set workspace config instead:');
+    console.log(`  [gateway] gateway_url = "${DEFAULT_GATEWAY_BASE_URL}"`);
+    console.log('  export ENACT_GATEWAY_API_KEY="your-api-key"');
+    console.log('');
+    if (normalized === 'responses') {
+        console.log('Optional provider-specific overrides:');
+        console.log(`  # responses adapter uses ${RESPONSES_BASE_URL}`);
+        console.log('  export ENACT_RESPONSES_API_KEY="your-api-key"');
+        console.log('');
+        console.log('Expected endpoint: POST /v1/responses');
+    }
+}
+/**
+ * Show env-based auth status
+ */
+export function handleAuthStatus() {
+    console.log('Responses provider:');
+    console.log(`  Base URL: ${RESPONSES_BASE_URL}`);
+    console.log(`  API key:  ${RESPONSES_API_KEY ? maskToken(RESPONSES_API_KEY) : '(not set)'}`);
+    console.log('');
+    console.log('Shared gateway config:');
+    console.log(`  [gateway].gateway_url=${DEFAULT_GATEWAY_BASE_URL}`);
+    console.log(`  ENACT_GATEWAY_API_KEY=${process.env.ENACT_GATEWAY_API_KEY ? maskToken(process.env.ENACT_GATEWAY_API_KEY) : '(not set)'}`);
+}
+/**
+ * Explain how to clear env-based auth
+ */
+export function handleAuthLogout(provider) {
+    const normalized = assertSupportedProvider(provider);
+    console.log(`No stored auth state exists for "${normalized}".`);
+    console.log('Unset the corresponding secret env vars in your shell instead:');
+    if (normalized === 'responses') {
+        console.log('  unset ENACT_RESPONSES_API_KEY');
+    }
+    console.log('  unset ENACT_GATEWAY_API_KEY');
+}
+function maskToken(token) {
+    if (token.length <= 8)
+        return '****';
+    return token.slice(0, 4) + '...' + token.slice(-4);
+}
+//# sourceMappingURL=authHandler.js.map

package/dist/cli/authHandler.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"authHandler.js","sourceRoot":"","sources":["../../src/cli/authHandler.ts"],"names":[],"mappings":"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"}

package/dist/cli/checkHandler.d.ts

@@ -0,0 +1,27 @@
+export declare function handleCheck(filePath: string | undefined, opts: {
+    stats?: boolean;
+    deprecated?: boolean;
+    untested?: boolean;
+    highRisk?: boolean;
+    tag?: string;
+    search?: string;
+    project?: string;
+    scan?: boolean;
+    bs?: boolean;
+    verbose?: boolean;
+    tree?: boolean;
+    ci?: boolean;
+}): Promise<void>;
+/**
+ * enact-factory annotate <qualifiedName> — 엔티티 어노테이션
+ */
+export declare function handleAnnotate(qualifiedName: string, opts: {
+    deprecate?: string | boolean;
+    status?: string;
+    tag?: string;
+    untag?: string;
+    note?: string;
+    risk?: string;
+    warn?: string;
+}): Promise<void>;
+//# sourceMappingURL=checkHandler.d.ts.map

package/dist/cli/checkHandler.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"checkHandler.d.ts","sourceRoot":"","sources":["../../src/cli/checkHandler.ts"],"names":[],"mappings":"AAwIA,wBAAsB,WAAW,CAC/B,QAAQ,EAAE,MAAM,GAAG,SAAS,EAC5B,IAAI,EAAE;IACJ,KAAK,CAAC,EAAE,OAAO,CAAC;IAChB,UAAU,CAAC,EAAE,OAAO,CAAC;IACrB,QAAQ,CAAC,EAAE,OAAO,CAAC;IACnB,QAAQ,CAAC,EAAE,OAAO,CAAC;IACnB,GAAG,CAAC,EAAE,MAAM,CAAC;IACb,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,IAAI,CAAC,EAAE,OAAO,CAAC;IACf,EAAE,CAAC,EAAE,OAAO,CAAC;IACb,OAAO,CAAC,EAAE,OAAO,CAAC;IAClB,IAAI,CAAC,EAAE,OAAO,CAAC;IACf,EAAE,CAAC,EAAE,OAAO,CAAC;CACd,GACA,OAAO,CAAC,IAAI,CAAC,CAyVf;AAED;;GAEG;AACH,wBAAsB,cAAc,CAClC,aAAa,EAAE,MAAM,EACrB,IAAI,EAAE;IACJ,SAAS,CAAC,EAAE,MAAM,GAAG,OAAO,CAAC;IAC7B,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,GAAG,CAAC,EAAE,MAAM,CAAC;IACb,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,IAAI,CAAC,EAAE,MAAM,CAAC;CACf,GACA,OAAO,CAAC,IAAI,CAAC,CAgHf"}

package/dist/cli/checkHandler.js

@@ -0,0 +1,560 @@
+// ============================================
+// EnactFactory - CLI Check Handler
+// Created: 2026-04-10
+// Purpose: `enact-factory check` 명령어 — 코드 레지스트리 조회
+// ============================================
+import { readFileSync, existsSync } from 'node:fs';
+import { join } from 'node:path';
+import { getRegistryStore, closeRegistryStore } from '../registry/sqliteStore.js';
+import { scanRepository } from '../registry/entityScanner.js';
+/** package.json name → Cargo.toml → go.mod → 폴더명 순으로 프로젝트 ID 추론 */
+function resolveProjectId(projectPath) {
+    // 1. package.json의 name 필드
+    const pkgPath = join(projectPath, 'package.json');
+    if (existsSync(pkgPath)) {
+        try {
+            const pkg = JSON.parse(readFileSync(pkgPath, 'utf-8'));
+            if (pkg.name && typeof pkg.name === 'string') {
+                return pkg.name.replace(/^@[^/]+\//, '');
+            }
+        }
+        catch (err) {
+            console.warn(`[check] package.json 파싱 실패: ${err instanceof Error ? err.message : String(err)}`);
+        }
+    }
+    // 2. Cargo.toml의 name (Rust)
+    const cargoPath = join(projectPath, 'Cargo.toml');
+    if (existsSync(cargoPath)) {
+        try {
+            const cargo = readFileSync(cargoPath, 'utf-8');
+            const nameMatch = cargo.match(/^\s*name\s*=\s*"([^"]+)"/m);
+            if (nameMatch)
+                return nameMatch[1];
+        }
+        catch (err) {
+            console.warn(`[check] Cargo.toml 파싱 실패: ${err instanceof Error ? err.message : String(err)}`);
+        }
+    }
+    // 3. go.mod의 module path (Go)
+    const goModPath = join(projectPath, 'go.mod');
+    if (existsSync(goModPath)) {
+        try {
+            const goMod = readFileSync(goModPath, 'utf-8');
+            const modMatch = goMod.match(/^module\s+(\S+)/m);
+            if (modMatch) {
+                const lastSegment = modMatch[1].split('/').pop();
+                if (lastSegment)
+                    return lastSegment;
+            }
+        }
+        catch (err) {
+            console.warn(`[check] go.mod 파싱 실패: ${err instanceof Error ? err.message : String(err)}`);
+        }
+    }
+    // 4. 폴더명 폴백
+    return projectPath.split('/').pop() ?? 'unknown';
+}
+// 색상 헬퍼 (ANSI)
+const c = {
+    reset: '\x1b[0m',
+    bold: '\x1b[1m',
+    dim: '\x1b[2m',
+    red: '\x1b[31m',
+    green: '\x1b[32m',
+    yellow: '\x1b[33m',
+    blue: '\x1b[34m',
+    magenta: '\x1b[35m',
+    cyan: '\x1b[36m',
+    gray: '\x1b[90m',
+};
+function statusBadge(status) {
+    switch (status) {
+        case 'active': return `${c.green}●${c.reset} active`;
+        case 'deprecated': return `${c.red}✗${c.reset} deprecated`;
+        case 'experimental': return `${c.yellow}◎${c.reset} experimental`;
+        case 'planned': return `${c.blue}○${c.reset} planned`;
+        case 'broken': return `${c.red}⚠${c.reset} broken`;
+        default: return status;
+    }
+}
+function riskBadge(risk) {
+    switch (risk) {
+        case 'high': return `${c.red}HIGH${c.reset}`;
+        case 'medium': return `${c.yellow}MED${c.reset}`;
+        case 'low': return `${c.green}LOW${c.reset}`;
+        default: return risk;
+    }
+}
+function severityBadge(sev) {
+    switch (sev) {
+        case 'critical': return `${c.red}${c.bold}CRITICAL${c.reset}`;
+        case 'error': return `${c.red}ERROR${c.reset}`;
+        case 'warning': return `${c.yellow}WARNING${c.reset}`;
+        case 'info': return `${c.blue}INFO${c.reset}`;
+        default: return sev;
+    }
+}
+function formatEntity(e, verbose = true) {
+    const lines = [];
+    const loc = e.lineStart ? `:${e.lineStart}${e.lineEnd ? `-${e.lineEnd}` : ''}` : '';
+    const testIcon = e.hasTests ? `${c.green}✓${c.reset}` : `${c.red}✗${c.reset}`;
+    lines.push(`  ${c.bold}${e.kind}${c.reset} ${c.cyan}${e.name}${c.reset}${c.dim}${loc}${c.reset}` +
+        `  ${statusBadge(e.status)}  test:${testIcon}  risk:${riskBadge(e.riskLevel)}`);
+    if (verbose) {
+        if (e.signature)
+            lines.push(`    ${c.dim}sig: ${e.signature}${c.reset}`);
+        if (e.author)
+            lines.push(`    ${c.dim}author: ${e.author}${c.reset}`);
+        if (e.description)
+            lines.push(`    ${c.dim}${e.description}${c.reset}`);
+        if (e.deprecatedReason)
+            lines.push(`    ${c.red}reason: ${e.deprecatedReason}${c.reset}`);
+        if (e.tags.length > 0) {
+            lines.push(`    ${c.magenta}tags: ${e.tags.map(t => t.value ? `${t.tag}=${t.value}` : t.tag).join(', ')}${c.reset}`);
+        }
+        for (const w of e.warnings.filter(w => !w.resolved)) {
+            lines.push(`    ${severityBadge(w.severity)} [${w.category}] ${w.message}`);
+        }
+    }
+    return lines.join('\n');
+}
+function formatEntityCompact(e) {
+    const loc = e.lineStart ? `:${e.lineStart}` : '';
+    const testIcon = e.hasTests ? '✓' : '✗';
+    return `  ${e.kind.padEnd(9)} ${e.name.padEnd(30)} ${e.filePath}${loc}  ${e.status.padEnd(12)} test:${testIcon}  risk:${e.riskLevel}`;
+}
+export async function handleCheck(filePath, opts) {
+    try {
+        const store = getRegistryStore();
+        // --scan: 레포 전체 스캔 → 레지스트리 동기화
+        if (opts.scan) {
+            const projectPath = process.cwd();
+            const projectId = opts.project ?? resolveProjectId(projectPath);
+            console.log(`\n${c.bold}Scanning repository...${c.reset}`);
+            console.log(`  ${c.dim}path: ${projectPath}${c.reset}`);
+            console.log(`  ${c.dim}project: ${projectId}${c.reset}\n`);
+            const result = await scanRepository(projectPath, projectId, {
+                verbose: opts.verbose,
+            });
+            console.log(`${c.bold}Scan Complete${c.reset}`);
+            console.log(`${'─'.repeat(40)}`);
+            console.log(`  Files scanned:  ${c.bold}${result.scanned}${c.reset}`);
+            console.log(`  Entities found: ${c.bold}${result.extracted}${c.reset}`);
+            console.log(`  New registered: ${c.green}+${result.registered}${c.reset}`);
+            console.log(`  Updated:        ${c.yellow}~${result.updated}${c.reset}`);
+            console.log(`  Marked broken:  ${result.removed > 0 ? c.red : c.dim}${result.removed}${c.reset}`);
+            console.log(`  Tests mapped:   ${c.cyan}${result.testsMapped}${c.reset}`);
+            console.log(`  Duration:       ${c.dim}${result.durationMs}ms${c.reset}`);
+            if (Object.keys(result.languageBreakdown).length > 0) {
+                console.log(`\n  ${c.dim}By language:${c.reset}`);
+                for (const [lang, count] of Object.entries(result.languageBreakdown).sort((a, b) => b[1] - a[1])) {
+                    console.log(`    ${lang.padEnd(12)} ${count} files`);
+                }
+            }
+            if (result.errors.length > 0) {
+                console.log(`\n  ${c.red}Errors (${result.errors.length}):${c.reset}`);
+                for (const err of result.errors.slice(0, 10)) {
+                    console.log(`    ${c.dim}${err}${c.reset}`);
+                }
+                if (result.errors.length > 10) {
+                    console.log(`    ${c.dim}...and ${result.errors.length - 10} more${c.reset}`);
+                }
+            }
+            // 스캔 후 통계 표시
+            const stats = store.getStats(projectId);
+            console.log(`\n${c.bold}Registry Status${c.reset}`);
+            console.log(`  Total: ${stats.total}  deprecated: ${stats.deprecated}  untested: ${stats.untested}  high-risk: ${stats.highRisk}  warnings: ${stats.withWarnings}\n`);
+            return;
+        }
+        // --bs: BS 패턴 탐지
+        if (opts.bs) {
+            const { scanRepository: scanBs } = await import('../registry/bsDetector.js');
+            const projectPath = process.cwd();
+            console.log(`\n${c.bold}BS Detector${c.reset} — scanning for bad code patterns...`);
+            console.log(`  ${c.dim}path: ${projectPath}${c.reset}\n`);
+            const result = await scanBs(projectPath, { verbose: opts.verbose });
+            // 결과 출력
+            const statusColor = result.critical > 0 ? c.red : result.warning > 0 ? c.yellow : c.green;
+            const statusText = result.critical > 0 ? 'FAIL' : result.warning > 0 ? 'WARN' : 'CLEAN';
+            console.log(`${c.bold}BS Scan Result${c.reset}`);
+            console.log(`${'─'.repeat(50)}`);
+            console.log(`  Files scanned: ${c.bold}${result.filesScanned}${c.reset}`);
+            console.log(`  BS Score:      ${statusColor}${c.bold}${result.bsScore.toFixed(1)}${c.reset} / 5.0`);
+            console.log(`  Status:        ${statusColor}${c.bold}${statusText}${c.reset}`);
+            console.log(`  CRITICAL:      ${result.critical > 0 ? c.red : c.green}${result.critical}${c.reset}`);
+            console.log(`  WARNING:       ${result.warning > 0 ? c.yellow : c.green}${result.warning}${c.reset}`);
+            console.log(`  MINOR:         ${result.minor > 0 ? c.dim : c.green}${result.minor}${c.reset}`);
+            if (result.workItems.length > 0) {
+                // CRITICAL 먼저
+                const criticals = result.workItems.filter(i => i.severity === 'critical');
+                if (criticals.length > 0) {
+                    console.log(`\n  ${c.red}${c.bold}CRITICAL (즉시 수정 필요)${c.reset}`);
+                    for (const workItem of criticals) {
+                        console.log(`    ${c.red}${workItem.filePath}:${workItem.line}${c.reset} — ${workItem.message}`);
+                        console.log(`      ${c.dim}${workItem.matchedText}${c.reset}`);
+                    }
+                }
+                const warnings = result.workItems.filter(i => i.severity === 'warning');
+                if (warnings.length > 0) {
+                    console.log(`\n  ${c.yellow}WARNING (권장 수정)${c.reset}`);
+                    for (const workItem of warnings.slice(0, 30)) {
+                        console.log(`    ${c.yellow}${workItem.filePath}:${workItem.line}${c.reset} — ${workItem.message}`);
+                    }
+                    if (warnings.length > 30) {
+                        console.log(`    ${c.dim}...and ${warnings.length - 30} more${c.reset}`);
+                    }
+                }
+                const minors = result.workItems.filter(i => i.severity === 'minor');
+                if (minors.length > 0) {
+                    console.log(`\n  ${c.dim}MINOR (${minors.length}건)${c.reset}`);
+                    for (const workItem of minors.slice(0, 10)) {
+                        console.log(`    ${c.dim}${workItem.filePath}:${workItem.line} — ${workItem.message}${c.reset}`);
+                    }
+                    if (minors.length > 10) {
+                        console.log(`    ${c.dim}...and ${minors.length - 10} more${c.reset}`);
+                    }
+                }
+            }
+            console.log();
+            return;
+        }
+        // --tree: directory tree with entity counts and risk indicators
+        if (opts.tree) {
+            const projectId = opts.project ?? resolveProjectId(process.cwd());
+            const scopePath = filePath || ''; // optional dir scope
+            const { entities } = store.listEntities({ projectId, limit: 50000, offset: 0 });
+            // Group entities by directory → file
+            const tree = new Map();
+            for (const e of entities) {
+                if (scopePath && !e.filePath.startsWith(scopePath))
+                    continue;
+                const parts = e.filePath.split('/');
+                const fileName = parts.pop();
+                const dirPath = parts.join('/') || '.';
+                if (!tree.has(dirPath))
+                    tree.set(dirPath, new Map());
+                const dir = tree.get(dirPath);
+                if (!dir.has(fileName)) {
+                    dir.set(fileName, { total: 0, untested: 0, highRisk: 0, deprecated: 0, kinds: new Map() });
+                }
+                const file = dir.get(fileName);
+                file.total++;
+                if (!e.hasTests)
+                    file.untested++;
+                if (e.riskLevel === 'high')
+                    file.highRisk++;
+                if (e.status === 'deprecated')
+                    file.deprecated++;
+                file.kinds.set(e.kind, (file.kinds.get(e.kind) || 0) + 1);
+            }
+            // Sort directories
+            const sortedDirs = [...tree.keys()].sort();
+            const totalFiles = [...tree.values()].reduce((s, d) => s + d.size, 0);
+            const totalEntities = entities.filter(e => !scopePath || e.filePath.startsWith(scopePath)).length;
+            console.log(`\n${c.bold}Code Tree${c.reset}${scopePath ? ` (${scopePath})` : ''} — ${totalFiles} files, ${totalEntities} entities\n`);
+            for (const dirPath of sortedDirs) {
+                const files = tree.get(dirPath);
+                const dirTotal = [...files.values()].reduce((s, f) => s + f.total, 0);
+                const dirUntested = [...files.values()].reduce((s, f) => s + f.untested, 0);
+                const dirHighRisk = [...files.values()].reduce((s, f) => s + f.highRisk, 0);
+                // Directory header
+                const riskFlag = dirHighRisk > 0 ? ` ${c.red}${dirHighRisk} high-risk${c.reset}` : '';
+                console.log(`${c.bold}${dirPath}/${c.reset} ${c.dim}(${dirTotal} entities, ${dirUntested} untested${riskFlag})${c.reset}`);
+                // Files in directory
+                const sortedFiles = [...files.entries()].sort((a, b) => b[1].total - a[1].total);
+                for (const [fileName, info] of sortedFiles) {
+                    const kindStr = [...info.kinds.entries()].map(([k, n]) => `${n} ${k}`).join(', ');
+                    const flags = [];
+                    if (info.highRisk > 0)
+                        flags.push(`${c.red}${info.highRisk} high-risk${c.reset}`);
+                    if (info.deprecated > 0)
+                        flags.push(`${c.red}${info.deprecated} deprecated${c.reset}`);
+                    const flagStr = flags.length ? ' ' + flags.join(' ') : '';
+                    const testPct = info.total > 0 ? Math.round(((info.total - info.untested) / info.total) * 100) : 0;
+                    const testColor = testPct === 100 ? c.green : testPct > 50 ? c.yellow : c.red;
+                    console.log(`  ${c.cyan}${fileName}${c.reset} ${c.dim}${kindStr}${c.reset} ${testColor}${testPct}% tested${c.reset}${flagStr}`);
+                }
+            }
+            console.log();
+            return;
+        }
+        // --ci: CI/CD mode — machine-readable JSON, exit code 1 on critical workItems
+        if (opts.ci) {
+            const projectPath = process.cwd();
+            const projectId = opts.project ?? resolveProjectId(projectPath);
+            // Run BS scan
+            const { scanRepository: scanBs } = await import('../registry/bsDetector.js');
+            const bsResult = await scanBs(projectPath, { verbose: false });
+            // Registry stats
+            const stats = store.getStats(projectId);
+            const result = {
+                project: projectId,
+                path: projectPath,
+                registry: {
+                    total: stats.total,
+                    deprecated: stats.deprecated,
+                    untested: stats.untested,
+                    highRisk: stats.highRisk,
+                    warnings: stats.withWarnings,
+                },
+                bs: {
+                    filesScanned: bsResult.filesScanned,
+                    score: bsResult.bsScore,
+                    critical: bsResult.critical,
+                    warning: bsResult.warning,
+                    minor: bsResult.minor,
+                },
+                pass: bsResult.critical === 0,
+            };
+            console.log(JSON.stringify(result, null, 2));
+            // Exit code 1 if critical workItems
+            if (bsResult.critical > 0) {
+                process.exitCode = 1;
+            }
+            return;
+        }
+        // --stats: full statistics
+        if (opts.stats) {
+            const stats = store.getStats(opts.project);
+            console.log(`\n${c.bold}Registry Stats${c.reset}`);
+            console.log(`${'─'.repeat(40)}`);
+            console.log(`  Total entities:  ${c.bold}${stats.total}${c.reset}`);
+            console.log(`  Deprecated:      ${stats.deprecated > 0 ? c.red : c.green}${stats.deprecated}${c.reset}`);
+            console.log(`  Untested:        ${stats.untested > 0 ? c.yellow : c.green}${stats.untested}${c.reset}`);
+            console.log(`  High risk:       ${stats.highRisk > 0 ? c.red : c.green}${stats.highRisk}${c.reset}`);
+            console.log(`  With warnings:   ${stats.withWarnings > 0 ? c.yellow : c.green}${stats.withWarnings}${c.reset}`);
+            if (stats.byKind.length > 0) {
+                console.log(`\n  ${c.dim}By kind:${c.reset}`);
+                for (const { kind, count } of stats.byKind) {
+                    console.log(`    ${kind.padEnd(12)} ${count}`);
+                }
+            }
+            if (stats.byStatus.length > 0) {
+                console.log(`\n  ${c.dim}By status:${c.reset}`);
+                for (const { status, count } of stats.byStatus) {
+                    console.log(`    ${status.padEnd(14)} ${count}`);
+                }
+            }
+            console.log();
+            return;
+        }
+        // --deprecated
+        if (opts.deprecated) {
+            const entities = store.deprecatedEntities(opts.project);
+            console.log(`\n${c.bold}Deprecated Entities${c.reset} (${entities.length})\n`);
+            if (entities.length === 0) {
+                console.log(`  ${c.green}None${c.reset}\n`);
+            }
+            else {
+                for (const e of entities)
+                    console.log(formatEntity(e));
+                console.log();
+            }
+            return;
+        }
+        // --untested
+        if (opts.untested) {
+            const entities = store.untestedEntities(opts.project);
+            console.log(`\n${c.bold}Untested Active Entities${c.reset} (${entities.length})\n`);
+            if (entities.length === 0) {
+                console.log(`  ${c.green}All tested${c.reset}\n`);
+            }
+            else {
+                for (const e of entities)
+                    console.log(formatEntityCompact(e));
+                console.log();
+            }
+            return;
+        }
+        // --high-risk
+        if (opts.highRisk) {
+            const entities = store.highRiskEntities(opts.project);
+            console.log(`\n${c.bold}High Risk Entities${c.reset} (${entities.length})\n`);
+            if (entities.length === 0) {
+                console.log(`  ${c.green}None${c.reset}\n`);
+            }
+            else {
+                for (const e of entities)
+                    console.log(formatEntity(e));
+                console.log();
+            }
+            return;
+        }
+        // --tag
+        if (opts.tag) {
+            const entities = store.entitiesByTag(opts.tag);
+            console.log(`\n${c.bold}Entities tagged "${opts.tag}"${c.reset} (${entities.length})\n`);
+            if (entities.length === 0) {
+                console.log(`  ${c.dim}No entities with tag "${opts.tag}"${c.reset}\n`);
+            }
+            else {
+                for (const e of entities)
+                    console.log(formatEntityCompact(e));
+                console.log();
+            }
+            return;
+        }
+        // --search
+        if (opts.search) {
+            const entities = store.searchEntities(opts.search);
+            console.log(`\n${c.bold}Search: "${opts.search}"${c.reset} (${entities.length} results)\n`);
+            if (entities.length === 0) {
+                console.log(`  ${c.dim}No matches${c.reset}\n`);
+            }
+            else {
+                for (const e of entities)
+                    console.log(formatEntity(e));
+                console.log();
+            }
+            return;
+        }
+        // 파일 경로 지정: fileBrief
+        if (filePath) {
+            const brief = store.fileBrief(filePath);
+            console.log(`\n${c.bold}File Brief: ${filePath}${c.reset}`);
+            console.log(`${'─'.repeat(40)}`);
+            console.log(`  ${c.dim}${brief.summary}${c.reset}\n`);
+            if (brief.entities.length === 0) {
+                console.log(`  ${c.dim}No registered entities for this file.${c.reset}`);
+                console.log(`  ${c.dim}Use \`registerEntity\` mutation to add entries.${c.reset}\n`);
+            }
+            else {
+                for (const e of brief.entities)
+                    console.log(formatEntity(e));
+                console.log();
+            }
+            return;
+        }
+        // 인자 없이 호출 시: 간단 통계 + 도움말
+        const stats = store.getStats();
+        if (stats.total === 0) {
+            console.log(`\n${c.bold}Code Registry${c.reset}: empty`);
+            console.log(`  ${c.dim}Register entities via: enact-factory check --scan${c.reset}`);
+            console.log(`  ${c.dim}or use: enact-factory check --help${c.reset}\n`);
+        }
+        else {
+            console.log(`\n${c.bold}Code Registry${c.reset}: ${stats.total} entities`);
+            console.log(`  ${stats.deprecated} deprecated, ${stats.untested} untested, ${stats.highRisk} high-risk, ${stats.withWarnings} with warnings`);
+            console.log(`\n  ${c.dim}Usage:${c.reset}`);
+            console.log(`  ${c.dim}  enact-factory check <file>       ${c.reset}File brief`);
+            console.log(`  ${c.dim}  enact-factory check --stats       ${c.reset}Full statistics`);
+            console.log(`  ${c.dim}  enact-factory check --deprecated  ${c.reset}Deprecated list`);
+            console.log(`  ${c.dim}  enact-factory check --untested    ${c.reset}Untested list`);
+            console.log(`  ${c.dim}  enact-factory check --search <q>  ${c.reset}Full-text search\n`);
+        }
+    }
+    finally {
+        closeRegistryStore();
+    }
+}
+/**
+ * enact-factory annotate <qualifiedName> — 엔티티 어노테이션
+ */
+export async function handleAnnotate(qualifiedName, opts) {
+    try {
+        const store = getRegistryStore();
+        // qualified name으로 검색, 없으면 FTS 검색
+        let entity = store.getEntityByName(qualifiedName);
+        if (!entity) {
+            // 부분 매칭 시도: name만으로 검색
+            const results = store.searchEntities(qualifiedName, 5);
+            if (results.length === 0) {
+                console.error(`${c.red}Entity not found: "${qualifiedName}"${c.reset}`);
+                console.error(`${c.dim}Use qualified name (file::name) or search with: enact-factory check --search <query>${c.reset}`);
+                process.exit(1);
+            }
+            if (results.length === 1) {
+                entity = results[0];
+            }
+            else {
+                console.log(`${c.yellow}Multiple matches for "${qualifiedName}":${c.reset}\n`);
+                for (const e of results) {
+                    console.log(`  ${c.cyan}${e.qualifiedName}${c.reset}  ${e.kind}  ${statusBadge(e.status)}`);
+                }
+                console.log(`\n${c.dim}Use the full qualified name to annotate a specific entity.${c.reset}`);
+                return;
+            }
+        }
+        console.log(`\n${c.bold}Annotating:${c.reset} ${c.cyan}${entity.qualifiedName}${c.reset}\n`);
+        let changed = false;
+        // --deprecate
+        if (opts.deprecate !== undefined) {
+            const reason = typeof opts.deprecate === 'string' ? opts.deprecate : undefined;
+            store.deprecateEntity(entity.id, reason);
+            console.log(`  ${c.red}✗${c.reset} Deprecated${reason ? `: ${reason}` : ''}`);
+            changed = true;
+        }
+        // --status
+        if (opts.status) {
+            const validStatuses = ['active', 'deprecated', 'experimental', 'planned', 'broken'];
+            if (!validStatuses.includes(opts.status)) {
+                console.error(`  ${c.red}Invalid status: ${opts.status}. Valid: ${validStatuses.join(', ')}${c.reset}`);
+            }
+            else {
+                store.changeEntityStatus(entity.id, opts.status);
+                console.log(`  ${statusBadge(opts.status)} Status changed`);
+                changed = true;
+            }
+        }
+        // --tag
+        if (opts.tag) {
+            const [tagKey, tagValue] = opts.tag.split('=', 2);
+            store.addTag(entity.id, tagKey, tagValue);
+            console.log(`  ${c.magenta}+${c.reset} Tag: ${tagKey}${tagValue ? `=${tagValue}` : ''}`);
+            changed = true;
+        }
+        // --untag
+        if (opts.untag) {
+            store.removeTag(entity.id, opts.untag);
+            console.log(`  ${c.dim}-${c.reset} Removed tag: ${opts.untag}`);
+            changed = true;
+        }
+        // --note
+        if (opts.note) {
+            store.addEvent(entity.id, 'note_added', { content: opts.note, actor: 'cli' });
+            console.log(`  ${c.blue}📝${c.reset} Note added`);
+            changed = true;
+        }
+        // --risk
+        if (opts.risk) {
+            const validRisks = ['low', 'medium', 'high'];
+            if (!validRisks.includes(opts.risk)) {
+                console.error(`  ${c.red}Invalid risk: ${opts.risk}. Valid: ${validRisks.join(', ')}${c.reset}`);
+            }
+            else {
+                store.updateEntity(entity.id, { riskLevel: opts.risk }, 'cli');
+                console.log(`  Risk: ${riskBadge(opts.risk)}`);
+                changed = true;
+            }
+        }
+        // --warn "severity/category: message"
+        if (opts.warn) {
+            const warnMatch = opts.warn.match(/^(info|warning|error|critical)\/(security|performance|correctness|style):\s*(.+)/);
+            if (!warnMatch) {
+                console.error(`  ${c.red}Invalid warning format. Use: severity/category: message${c.reset}`);
+                console.error(`  ${c.dim}Example: --warn "error/security: SQL injection risk"${c.reset}`);
+            }
+            else {
+                store.addWarning(entity.id, warnMatch[1], warnMatch[2], warnMatch[3]);
+                console.log(`  ${severityBadge(warnMatch[1])} [${warnMatch[2]}] ${warnMatch[3]}`);
+                changed = true;
+            }
+        }
+        if (!changed) {
+            console.log(`  ${c.dim}No changes. Use --deprecate, --status, --tag, --note, --risk, or --warn${c.reset}`);
+        }
+        // 변경 후 엔티티 상태 표시
+        if (changed) {
+            const updated = store.getEntity(entity.id);
+            if (updated) {
+                console.log(`\n${c.dim}Updated state:${c.reset}`);
+                console.log(formatEntity(updated));
+            }
+        }
+        console.log();
+    }
+    finally {
+        closeRegistryStore();
+    }
+}
+//# sourceMappingURL=checkHandler.js.map