@amsterdamdatalabs/enact-factory 0.1.1

package/dist/core/service.js

@@ -0,0 +1,297 @@
+// ============================================
+// Enact Factory - Main Service
+// ============================================
+import * as azdo from '../azdo/index.js';
+import * as scheduler from '../automation/scheduler.js';
+import * as web from '../support/web.js';
+import * as autonomous from '../automation/autonomousRunner.js';
+import { setLocalFetcher } from '../automation/runnerExecution.js';
+import { initMonitors } from '../automation/longRunningMonitor.js';
+import * as dailyReporter from '../automation/dailyReporter.js';
+import { initLocale, t } from '../locale/index.js';
+import { initRateLimiters, destroyRateLimiters } from '../support/rateLimiter.js';
+import { enrichWorkItemFromState, hydrateWorkItemStateFromComments, updateWorkItemAzdoState } from '../workItemState/store.js';
+import { requireWorkspaceUiPort } from '../core/workspaceConfig.js';
+import { initializeWorkItemStore, closeWorkItemStore, registerProjectPath, fetchLocalWorkItems } from '../workItems/index.js';
+import { resolveRuntimeConfig } from '../core/runtimeConfig.js';
+import { makePATFetcher, makeAzCliTokenFetcher } from '../workItems/azureDevOpsSync.js';
+import { ensureAzdoSyncStarted } from '../workItems/azdoSyncRuntime.js';
+import { createAzdoClient } from '../azureDevOps/client.js';
+let state = {
+    running: false,
+    projects: new Map(),
+    timers: new Map(),
+};
+let workItemSyncTimer = null;
+// The single UI port. The daemon serves the dashboard on the SAME port as
+// `enact-factory dash` so there is exactly one UI port.
+function defaultUiPort() {
+    return requireWorkspaceUiPort();
+}
+/**
+ * Start the service
+ */
+export async function startService(config) {
+    console.log('Starting Enact Factory service...');
+    initLocale(config.language);
+    console.log('⚡ Initializing rate limiters...');
+    initRateLimiters();
+    console.log('✅ Rate limiters ready');
+    const dbConfig = config.database ?? {
+        type: 'postgres',
+        host: 'localhost',
+        port: 45432,
+        database: 'enact_factory_dev',
+        user: 'enact',
+        password: 'enact',
+        schema: 'public',
+    };
+    if (dbConfig.type === 'postgres') {
+        console.log('🐘 Initializing PostgreSQL workItem store...');
+        const store = await initializeWorkItemStore({
+            type: 'postgres',
+            postgres: {
+                connectionString: dbConfig.url,
+                host: dbConfig.host,
+                port: dbConfig.port,
+                database: dbConfig.database,
+                user: dbConfig.user,
+                password: dbConfig.password,
+                schema: dbConfig.schema,
+            },
+        });
+        console.log('✅ PostgreSQL workItem store ready');
+        const runtimeConfig = await resolveRuntimeConfig(config, store);
+        config = runtimeConfig;
+    }
+    else {
+        console.log('🗄️ Using SQLite workItem store');
+        const store = await initializeWorkItemStore({ type: 'sqlite' });
+        const runtimeConfig = await resolveRuntimeConfig(config, store);
+        config = runtimeConfig;
+    }
+    for (const project of config.projects) {
+        const projectId = project.name;
+        registerProjectPath(projectId, project.path);
+        console.log(`[Service] Registered project: ${projectId} -> ${project.path}`);
+    }
+    const workItemSource = config.workItemSource;
+    const hasAzdoCreds = config.azdoApiKey && config.azdoTeamId;
+    const useAzdoWorkItemSource = workItemSource === 'azdo' || (workItemSource === 'auto' && hasAzdoCreds);
+    const useLocalWorkItemSource = workItemSource === 'local' || (workItemSource === 'auto' && !hasAzdoCreds);
+    if (useAzdoWorkItemSource) {
+        if (!hasAzdoCreds) {
+            throw new Error('workItemSource is "azdo" but Azdo credentials are not configured');
+        }
+        azdo.initAzdo(config.azdoApiKey, config.azdoTeamId);
+        console.log('🔗 Using Azure DevOps-backed local workItem mirror');
+        setLocalFetcher(fetchLocalWorkItems);
+        console.log('[Service] Local workItem fetcher registered for mirrored Azure DevOps workItems');
+    }
+    else if (useLocalWorkItemSource) {
+        console.log('📁 Using local workItem management');
+        setLocalFetcher(fetchLocalWorkItems);
+        console.log('[Service] Local workItem fetcher registered');
+    }
+    else if (workItemSource === 'disabled') {
+        console.log('⏭ WorkItem source disabled — autonomous mode will not fetch workItems');
+    }
+    else {
+        console.log(`⏭ Unknown workItem source "${workItemSource}" — no fetcher registered`);
+    }
+    console.log('🌐 Starting web interface...');
+    await web.startWebServer(defaultUiPort());
+    console.log('✅ Web interface ready');
+    if (config.pairMode) {
+        console.log(`Pair mode configured (maxAttempts: ${config.pairMode.maxAttempts})`);
+    }
+    for (const project of config.projects) {
+        if (!project.enabled)
+            continue;
+        state.projects.set(project.name, {
+            name: project.name,
+            state: project.paused ? 'paused' : 'idle',
+        });
+    }
+    state.running = true;
+    state.startedAt = Date.now();
+    await scheduler.startAllSchedules();
+    const schedules = await scheduler.listSchedules();
+    console.log(`Scheduler started with ${schedules.length} schedules`);
+    let azdoRepoCount = null;
+    if (config.azureDevOps?.enabled) {
+        const azdoCfg = config.azureDevOps;
+        try {
+            const probeToken = azdoCfg.authStrategy === 'pat'
+                ? makePATFetcher(azdoCfg.patEnvVar ?? 'AZDO_PAT')
+                : makeAzCliTokenFetcher('amsterdamdatalabs.com');
+            const probeClient = createAzdoClient({
+                organization: azdoCfg.organization,
+                project: azdoCfg.project,
+                fetchToken: probeToken,
+            });
+            const repos = await probeClient.listRepos();
+            azdoRepoCount = repos.length;
+        }
+        catch (err) {
+            console.warn('[Service] AzDO repo probe failed:', err instanceof Error ? err.message : err);
+        }
+    }
+    const azdoLine = config.azureDevOps?.enabled
+        ? `Azure DevOps: ${config.azureDevOps.organization}/${config.azureDevOps.project} — ${azdoRepoCount ?? '?'} repo${azdoRepoCount === 1 ? '' : 's'} (${config.azureDevOps.intervalMs / 1000}s heartbeat)`
+        : `Azure DevOps: disabled`;
+    console.log('');
+    console.log('🎉 ════════════════════════════════════════');
+    console.log(`🎉  ${t('service.startComplete')}`);
+    console.log(`🎉  ├─ ${t('service.agentCount', { n: config.projects.length })}`);
+    console.log(`🎉  ├─ ${azdoLine}`);
+    console.log(`🎉  └─ ${t('service.heartbeatInterval', { n: Math.floor(config.defaultHeartbeatMs / 1000 / 60) })}`);
+    console.log('🎉 ════════════════════════════════════════');
+    console.log('');
+    if (config.autonomous?.enabled) {
+        console.log('[Service] Autonomous mode auto-start enabled');
+        if (useAzdoWorkItemSource) {
+            autonomous.setAzdoFetcher(async () => {
+                const workItems = await fetchLocalWorkItems();
+                for (const workItem of workItems) {
+                    if (workItem.workItemId && workItem.azdoState) {
+                        updateWorkItemAzdoState(workItem.workItemId, workItem.azdoState);
+                        hydrateWorkItemStateFromComments(workItem.workItemId, []);
+                    }
+                }
+                return workItems.map((workItem) => enrichWorkItemFromState(workItem));
+            });
+            console.log('[Service] Azdo fetcher registered from local Azure DevOps mirror');
+        }
+        else if (useLocalWorkItemSource) {
+            console.log('[Service] Autonomous mode using already-registered local workItem fetcher');
+        }
+        else {
+            console.log('[Service] Autonomous mode did not register a workItem fetcher (disabled workItemSource).');
+        }
+        const runnerInstance = await autonomous.startAutonomous({
+            defaultAdapter: undefined,
+            azdoTeamId: config.azdoTeamId,
+            allowedProjects: config.autonomous.allowedProjects,
+            heartbeatSchedule: config.autonomous.schedule,
+            autoExecute: true,
+            maxConsecutiveWorkItems: 3,
+            cooldownSeconds: 300,
+            dryRun: false,
+            pairMode: config.autonomous.pairMode,
+            pairMaxAttempts: config.autonomous.maxAttempts,
+            executorModel: config.autonomous.models?.executor,
+            reviewerModel: config.autonomous.models?.reviewer,
+            executorTimeoutMs: config.autonomous.executorTimeoutMs || 0,
+            reviewerTimeoutMs: config.autonomous.reviewerTimeoutMs || 0,
+            triggerNow: true,
+            maxConcurrentWorkItems: config.autonomous.maxConcurrentWorkItems,
+            defaultStages: config.autonomous.defaultStages,
+            projectAgents: config.autonomous.projectAgents,
+            enableDecomposition: config.autonomous.decomposition?.enabled ?? false,
+            decompositionThresholdMinutes: config.autonomous.decomposition?.thresholdMinutes ?? 30,
+            plannerModel: config.autonomous.decomposition?.plannerModel,
+            plannerTimeoutMs: config.autonomous.decomposition?.plannerTimeoutMs,
+            worktreeMode: config.autonomous.worktreeMode ?? false,
+            dispatchBackend: config.autonomous.dispatchBackend,
+            paseo: config.autonomous.paseo,
+            guards: config.autonomous.guards,
+            dailyWorkItemCap: config.autonomous.dailyWorkItemCap ?? 6,
+            interWorkItemCooldownMs: config.autonomous.interWorkItemCooldownMs ?? 1_800_000,
+            jobProfiles: config.autonomous.jobProfiles,
+        });
+        web.setWebRunner(runnerInstance, config.projects);
+        const modelInfo = config.autonomous.models
+            ? `, Executor: ${config.autonomous.models.executor || 'default'}, Reviewer: ${config.autonomous.models.reviewer || 'default'}`
+            : '';
+        console.log(`[Service] Autonomous runner started (pairMode: ${config.autonomous.pairMode}, schedule: ${config.autonomous.schedule}${modelInfo})`);
+    }
+    if (config.monitors?.length) {
+        initMonitors(config.monitors);
+        console.log(`[Service] Long-running monitors initialized (${config.monitors.length} from config)`);
+    }
+    else {
+        initMonitors();
+    }
+    if (config.dailyReporter?.enabled) {
+        dailyReporter.setAzdoClient(null);
+        dailyReporter.setTeamId(config.azdoTeamId);
+        dailyReporter.startDailyReporter(config.dailyReporter);
+        console.log(`[Service] Daily reporter started (Feature rollup mode, schedule: ${config.dailyReporter.schedule || '18:00 daily'})`);
+    }
+    if (config.azureDevOps?.enabled) {
+        // Start (or reuse) the in-process AzDO heartbeat via the shared runtime.
+        // startWebServer above may already have started it; the singleton guard
+        // makes this a no-op in that case so we never run two heartbeats.
+        const service = await ensureAzdoSyncStarted(config.azureDevOps);
+        if (service) {
+            console.log(`[Service] AzDO sync ready (org: ${config.azureDevOps.organization}, project: ${config.azureDevOps.project}, interval: ${config.azureDevOps.intervalMs}ms)`);
+        }
+    }
+    else {
+        console.log('[Service] AzDO sync disabled — skipping');
+    }
+    const autoStatus = config.autonomous?.enabled
+        ? t('service.autoModeActive', { mode: config.autonomous.pairMode ? 'Pair' : 'Solo' })
+        : '';
+    console.log(t('service.startedMessage', {
+        agents: config.projects.length,
+        schedules: schedules.length,
+        autoStatus,
+    }));
+}
+export function pauseAgent(name) {
+    const status = state.projects.get(name);
+    if (status) {
+        status.state = 'paused';
+        console.log(`Agent ${name} paused`);
+    }
+}
+export function resumeAgent(name) {
+    const status = state.projects.get(name);
+    if (status && status.state === 'paused') {
+        status.state = 'idle';
+        console.log(`Agent ${name} resumed`);
+    }
+}
+export function getAgentStatuses(name) {
+    if (name) {
+        const status = state.projects.get(name);
+        return status ? [status] : [];
+    }
+    return Array.from(state.projects.values());
+}
+export async function stopService() {
+    console.log('Stopping Enact Factory service...');
+    // Stop the autonomous runner first so no new work-item claims are made
+    // while the rest of the service tears down. stopAutonomous() is a safe
+    // no-op when the runner was never started (autonomous.enabled=false).
+    autonomous.stopAutonomous();
+    console.log('Autonomous runner stopped');
+    if (workItemSyncTimer) {
+        clearInterval(workItemSyncTimer);
+        workItemSyncTimer = null;
+        console.log('WorkItem board sync stopped');
+    }
+    for (const [name, timer] of state.timers) {
+        clearInterval(timer);
+        console.log(`Timer stopped for ${name}`);
+    }
+    state.timers.clear();
+    // AzDO sync is owned by the web server (startWebServer starts it; stopWebServer
+    // below stops it) — symmetric lifecycle, so it is NOT stopped here.
+    scheduler.stopAllSchedules();
+    console.log('Scheduler stopped');
+    await web.stopWebServer();
+    destroyRateLimiters();
+    console.log('Rate limiters destroyed');
+    console.log('Web server stopped');
+    state.running = false;
+    // Close the work-item store (Postgres pool.end() / SQLite db.close()) last
+    // so that any in-flight store operations triggered by the runner or web
+    // server can still complete before the connection is torn down.
+    await closeWorkItemStore();
+    console.log('Work item store closed');
+    console.log('Service stopped');
+}
+//# sourceMappingURL=service.js.map

package/dist/core/service.js.map

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

package/dist/core/traceCollector.d.ts

@@ -0,0 +1,105 @@
+export type SpanStatus = 'running' | 'completed' | 'failed';
+/**
+ * 개별 작업 단위 (도구 호출, 에이전트 실행 등)
+ */
+export type Span = {
+    /** 고유 span ID */
+    spanId: string;
+    /** 소속 trace ID */
+    traceId: string;
+    /** 부모 span ID (없으면 root span) */
+    parentSpanId?: string;
+    /** span 이름 (예: 'executor', 'tool:git-commit') */
+    name: string;
+    /** 상태 */
+    status: SpanStatus;
+    /** 시작 시간 (epoch ms) */
+    startTime: number;
+    /** 종료 시간 (epoch ms) */
+    endTime?: number;
+    /** 추가 메타데이터 */
+    metadata: Record<string, unknown>;
+    /** 에러 정보 */
+    errorInfo?: {
+        message: string;
+        stack?: string;
+        code?: string;
+    };
+};
+/**
+ * 세션 레벨 trace (여러 span을 포함)
+ */
+export type Trace = {
+    /** trace ID */
+    traceId: string;
+    /** trace 이름 (예: 세션/이슈 식별자) */
+    name: string;
+    /** 시작 시간 */
+    startTime: number;
+    /** 종료 시간 */
+    endTime?: number;
+    /** 상태 */
+    status: SpanStatus;
+    /** 소속 span 목록 */
+    spans: Span[];
+    /** 추가 메타데이터 (에이전트명, 이슈 ID 등) */
+    metadata: Record<string, unknown>;
+};
+/**
+ * 에이전트 실행 추적 수집기
+ *
+ * 사용법:
+ *   const traceId = collector.startTrace('agent-run');
+ *   const spanId = collector.startSpan(traceId, 'executor');
+ *   const childId = collector.startSpan(traceId, 'tool:git', spanId);
+ *   collector.endSpan(traceId, childId);
+ *   collector.endSpan(traceId, spanId);
+ *   collector.endTrace(traceId);
+ */
+export declare class TraceCollector {
+    private traces;
+    /**
+     * 새 trace 시작
+     * @returns trace ID
+     */
+    startTrace(name: string, metadata?: Record<string, unknown>): string;
+    /**
+     * trace 종료
+     */
+    endTrace(traceId: string, status?: SpanStatus): Trace | undefined;
+    /**
+     * trace 내에 새 span 시작
+     * @param parentSpanId - 부모 span ID (계층 구조용)
+     * @returns span ID
+     */
+    startSpan(traceId: string, name: string, parentSpanId?: string, metadata?: Record<string, unknown>): string | undefined;
+    /**
+     * span 종료
+     */
+    endSpan(traceId: string, spanId: string, status?: SpanStatus): Span | undefined;
+    /**
+     * span에 에러 기록
+     */
+    recordError(traceId: string, spanId: string, error: {
+        message: string;
+        stack?: string;
+        code?: string;
+    }): boolean;
+    /**
+     * trace 조회
+     */
+    getTrace(traceId: string): Trace | undefined;
+    /**
+     * 특정 span의 자식 span 목록 조회
+     */
+    getChildSpans(traceId: string, parentSpanId: string): Span[];
+    /**
+     * 모든 trace 목록 조회
+     */
+    getAllTraces(): Trace[];
+    /**
+     * 완료된 trace 제거 (메모리 관리)
+     */
+    pruneCompleted(): number;
+}
+//# sourceMappingURL=traceCollector.d.ts.map

package/dist/core/traceCollector.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"traceCollector.d.ts","sourceRoot":"","sources":["../../src/core/traceCollector.ts"],"names":[],"mappings":"AASA,MAAM,MAAM,UAAU,GAAG,SAAS,GAAG,WAAW,GAAG,QAAQ,CAAC;AAE5D;;GAEG;AACH,MAAM,MAAM,IAAI,GAAG;IACjB,iBAAiB;IACjB,MAAM,EAAE,MAAM,CAAC;IACf,kBAAkB;IAClB,OAAO,EAAE,MAAM,CAAC;IAChB,iCAAiC;IACjC,YAAY,CAAC,EAAE,MAAM,CAAC;IACtB,iDAAiD;IACjD,IAAI,EAAE,MAAM,CAAC;IACb,SAAS;IACT,MAAM,EAAE,UAAU,CAAC;IACnB,uBAAuB;IACvB,SAAS,EAAE,MAAM,CAAC;IAClB,uBAAuB;IACvB,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,eAAe;IACf,QAAQ,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;IAClC,YAAY;IACZ,SAAS,CAAC,EAAE;QACV,OAAO,EAAE,MAAM,CAAC;QAChB,KAAK,CAAC,EAAE,MAAM,CAAC;QACf,IAAI,CAAC,EAAE,MAAM,CAAC;KACf,CAAC;CACH,CAAC;AAEF;;GAEG;AACH,MAAM,MAAM,KAAK,GAAG;IAClB,eAAe;IACf,OAAO,EAAE,MAAM,CAAC;IAChB,8BAA8B;IAC9B,IAAI,EAAE,MAAM,CAAC;IACb,YAAY;IACZ,SAAS,EAAE,MAAM,CAAC;IAClB,YAAY;IACZ,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,SAAS;IACT,MAAM,EAAE,UAAU,CAAC;IACnB,iBAAiB;IACjB,KAAK,EAAE,IAAI,EAAE,CAAC;IACd,gCAAgC;IAChC,QAAQ,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;CACnC,CAAC;AAIF;;;;;;;;;;GAUG;AACH,qBAAa,cAAc;IACzB,OAAO,CAAC,MAAM,CAA4B;IAE1C;;;OAGG;IACH,UAAU,CAAC,IAAI,EAAE,MAAM,EAAE,QAAQ,GAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAM,GAAG,MAAM;IAcxE;;OAEG;IACH,QAAQ,CAAC,OAAO,EAAE,MAAM,EAAE,MAAM,GAAE,UAAwB,GAAG,KAAK,GAAG,SAAS;IAkB9E;;;;OAIG;IACH,SAAS,CACP,OAAO,EAAE,MAAM,EACf,IAAI,EAAE,MAAM,EACZ,YAAY,CAAC,EAAE,MAAM,EACrB,QAAQ,GAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAM,GACrC,MAAM,GAAG,SAAS;IAkBrB;;OAEG;IACH,OAAO,CAAC,OAAO,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,GAAE,UAAwB,GAAG,IAAI,GAAG,SAAS;IAY5F;;OAEG;IACH,WAAW,CACT,OAAO,EAAE,MAAM,EACf,MAAM,EAAE,MAAM,EACd,KAAK,EAAE;QAAE,OAAO,EAAE,MAAM,CAAC;QAAC,KAAK,CAAC,EAAE,MAAM,CAAC;QAAC,IAAI,CAAC,EAAE,MAAM,CAAA;KAAE,GACxD,OAAO;IAaV;;OAEG;IACH,QAAQ,CAAC,OAAO,EAAE,MAAM,GAAG,KAAK,GAAG,SAAS;IAI5C;;OAEG;IACH,aAAa,CAAC,OAAO,EAAE,MAAM,EAAE,YAAY,EAAE,MAAM,GAAG,IAAI,EAAE;IAM5D;;OAEG;IACH,YAAY,IAAI,KAAK,EAAE;IAIvB;;OAEG;IACH,cAAc,IAAI,MAAM;CAUzB"}

package/dist/core/traceCollector.js

@@ -0,0 +1,141 @@
+// ============================================
+// EnactFactory - Trace Collector
+// 에이전트 실행 추적을 위한 Span 모델 및 TraceCollector
+// ============================================
+import { randomUUID } from 'node:crypto';
+// TraceCollector
+/**
+ * 에이전트 실행 추적 수집기
+ *
+ * 사용법:
+ *   const traceId = collector.startTrace('agent-run');
+ *   const spanId = collector.startSpan(traceId, 'executor');
+ *   const childId = collector.startSpan(traceId, 'tool:git', spanId);
+ *   collector.endSpan(traceId, childId);
+ *   collector.endSpan(traceId, spanId);
+ *   collector.endTrace(traceId);
+ */
+export class TraceCollector {
+    traces = new Map();
+    /**
+     * 새 trace 시작
+     * @returns trace ID
+     */
+    startTrace(name, metadata = {}) {
+        const traceId = randomUUID();
+        const trace = {
+            traceId,
+            name,
+            startTime: Date.now(),
+            status: 'running',
+            spans: [],
+            metadata,
+        };
+        this.traces.set(traceId, trace);
+        return traceId;
+    }
+    /**
+     * trace 종료
+     */
+    endTrace(traceId, status = 'completed') {
+        const trace = this.traces.get(traceId);
+        if (!trace)
+            return undefined;
+        trace.endTime = Date.now();
+        trace.status = status;
+        // 아직 running인 span을 모두 종료
+        for (const span of trace.spans) {
+            if (span.status === 'running') {
+                span.endTime = trace.endTime;
+                span.status = status;
+            }
+        }
+        return trace;
+    }
+    /**
+     * trace 내에 새 span 시작
+     * @param parentSpanId - 부모 span ID (계층 구조용)
+     * @returns span ID
+     */
+    startSpan(traceId, name, parentSpanId, metadata = {}) {
+        const trace = this.traces.get(traceId);
+        if (!trace)
+            return undefined;
+        const spanId = randomUUID();
+        const span = {
+            spanId,
+            traceId,
+            parentSpanId,
+            name,
+            status: 'running',
+            startTime: Date.now(),
+            metadata,
+        };
+        trace.spans.push(span);
+        return spanId;
+    }
+    /**
+     * span 종료
+     */
+    endSpan(traceId, spanId, status = 'completed') {
+        const trace = this.traces.get(traceId);
+        if (!trace)
+            return undefined;
+        const span = trace.spans.find((s) => s.spanId === spanId);
+        if (!span)
+            return undefined;
+        span.endTime = Date.now();
+        span.status = status;
+        return span;
+    }
+    /**
+     * span에 에러 기록
+     */
+    recordError(traceId, spanId, error) {
+        const trace = this.traces.get(traceId);
+        if (!trace)
+            return false;
+        const span = trace.spans.find((s) => s.spanId === spanId);
+        if (!span)
+            return false;
+        span.errorInfo = error;
+        span.status = 'failed';
+        span.endTime = span.endTime ?? Date.now();
+        return true;
+    }
+    /**
+     * trace 조회
+     */
+    getTrace(traceId) {
+        return this.traces.get(traceId);
+    }
+    /**
+     * 특정 span의 자식 span 목록 조회
+     */
+    getChildSpans(traceId, parentSpanId) {
+        const trace = this.traces.get(traceId);
+        if (!trace)
+            return [];
+        return trace.spans.filter((s) => s.parentSpanId === parentSpanId);
+    }
+    /**
+     * 모든 trace 목록 조회
+     */
+    getAllTraces() {
+        return Array.from(this.traces.values());
+    }
+    /**
+     * 완료된 trace 제거 (메모리 관리)
+     */
+    pruneCompleted() {
+        let pruned = 0;
+        for (const [id, trace] of this.traces) {
+            if (trace.status !== 'running') {
+                this.traces.delete(id);
+                pruned++;
+            }
+        }
+        return pruned;
+    }
+}
+//# sourceMappingURL=traceCollector.js.map

package/dist/core/traceCollector.js.map

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