tracelattice 1.3.4 → 1.4.0

package/dist/__tests__/core/HistoryManager.dag.test.d.ts

@@ -1,9 +1,2 @@
-/**
- * Tests for flag-gated DAG edge emission in HistoryManager.
- *
- * Covers the seven metadata→edge mappings (sequence, branch, merge,
- * verifies, critiques, derives_from, revises) plus flag gating, missing
- * targets, missing ids, and session isolation.
- */
 export {};
 //# sourceMappingURL=HistoryManager.dag.test.d.ts.map

package/dist/__tests__/core/HistoryManager.dag.test.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"HistoryManager.dag.test.d.ts","sourceRoot":"","sources":["../../../src/__tests__/core/HistoryManager.dag.test.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG"}
+{"version":3,"file":"HistoryManager.dag.test.d.ts","sourceRoot":"","sources":["../../../src/__tests__/core/HistoryManager.dag.test.ts"],"names":[],"mappings":""}

package/dist/__tests__/errors.types.test-d.d.ts

@@ -0,0 +1,16 @@
+/**
+ * Compile-time exhaustiveness check between `ErrorCode` and the set of
+ * error codes actually used by error subclasses (or by direct
+ * `SequentialThinkingError` instantiations).
+ *
+ * Purpose: if a new code is added to `ERROR_CODES` without a corresponding
+ * subclass (or known direct usage) being added to the union below, this file
+ * fails type-checking. Likewise, if a subclass code is removed from
+ * `ERROR_CODES`, TypeScript flags the orphan literal.
+ *
+ * This file contains NO runtime tests. Vitest's `*.test-d.ts` convention
+ * is used purely so the file is type-checked by the project's tsc pass
+ * without being treated as a runnable test module.
+ */
+export {};
+//# sourceMappingURL=errors.types.test-d.d.ts.map

package/dist/__tests__/errors.types.test-d.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"errors.types.test-d.d.ts","sourceRoot":"","sources":["../../src/__tests__/errors.types.test-d.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;GAaG"}

package/dist/__tests__/eval/fixtures/scenarios.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"scenarios.d.ts","sourceRoot":"","sources":["../../../../src/__tests__/eval/fixtures/scenarios.ts"],"names":[],"mappings":"AAAA;;;;;;;;;GASG;AAEH,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,0BAA0B,CAAC;AAG5D;;;GAGG;AACH,MAAM,WAAW,gBAAgB;IAChC,QAAQ,CAAC,kBAAkB,CAAC,EAAE,OAAO,CAAC;IACtC,QAAQ,CAAC,eAAe,CAAC,EAAE,OAAO,CAAC;CACnC;AAED;;;;;;;GAOG;AACH,MAAM,WAAW,YAAY;IAC5B,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;IACtB,QAAQ,CAAC,QAAQ,EAAE,SAAS,WAAW,EAAE,CAAC;IAC1C,QAAQ,CAAC,gBAAgB,EAAE,gBAAgB,CAAC;IAC5C,8DAA8D;IAC9D,QAAQ,CAAC,WAAW,CAAC,EAAE,aAAa,CAAC,SAAS,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC,CAAC;CAChE;AA+BD,uCAAuC;AACvC,eAAO,MAAM,SAAS,EAAE,SAAS,YAAY,EA8F5C,CAAC"}
+{"version":3,"file":"scenarios.d.ts","sourceRoot":"","sources":["../../../../src/__tests__/eval/fixtures/scenarios.ts"],"names":[],"mappings":"AACA;;;;;;;;;GASG;AAEH,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,0BAA0B,CAAC;AAG5D;;;GAGG;AACH,MAAM,WAAW,gBAAgB;IAChC,QAAQ,CAAC,kBAAkB,CAAC,EAAE,OAAO,CAAC;IACtC,QAAQ,CAAC,eAAe,CAAC,EAAE,OAAO,CAAC;CACnC;AAED;;;;;;;GAOG;AACH,MAAM,WAAW,YAAY;IAC5B,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;IACtB,QAAQ,CAAC,QAAQ,EAAE,SAAS,WAAW,EAAE,CAAC;IAC1C,QAAQ,CAAC,gBAAgB,EAAE,gBAAgB,CAAC;IAC5C,8DAA8D;IAC9D,QAAQ,CAAC,WAAW,CAAC,EAAE,aAAa,CAAC,SAAS,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC,CAAC;CAChE;AA+BD,uCAAuC;AACvC,eAAO,MAAM,SAAS,EAAE,SAAS,YAAY,EA8F5C,CAAC"}

package/dist/__tests__/evaluator/EvaluatorBackwardCompat.test.d.ts

@@ -1,15 +1,2 @@
-/**
- * Backward-compatibility snapshot tests for the {@link ThoughtEvaluator} facade.
- *
- * These tests lock the public API of the post-refactor `ThoughtEvaluator`
- * (which composes `SignalComputer` + `Aggregator` + `PatternDetector` +
- * `Calibrator`) so that future changes cannot silently alter observable
- * behavior.
- *
- * Tests intentionally exercise only the public {@link ThoughtEvaluator} API —
- * no imports from `core/evaluator/*` internals.
- *
- * @module __tests__/evaluator/EvaluatorBackwardCompat
- */
 export {};
 //# sourceMappingURL=EvaluatorBackwardCompat.test.d.ts.map

package/dist/__tests__/evaluator/EvaluatorBackwardCompat.test.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"EvaluatorBackwardCompat.test.d.ts","sourceRoot":"","sources":["../../../src/__tests__/evaluator/EvaluatorBackwardCompat.test.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;GAYG"}
+{"version":3,"file":"EvaluatorBackwardCompat.test.d.ts","sourceRoot":"","sources":["../../../src/__tests__/evaluator/EvaluatorBackwardCompat.test.ts"],"names":[],"mappings":""}

package/dist/__tests__/helpers/factories.d.ts

@@ -1,6 +1,7 @@
 import type { ThoughtData } from '../../core/thought.js';
 import type { IToolRegistry } from '../../contracts/interfaces.js';
 import { type SessionId, type ThoughtId, type EdgeId, type SuspensionToken } from '../../contracts/ids.js';
+import { type BranchId } from '../../contracts/ids.js';
 import type { ToolRecommendation } from '../../types/tool.js';
 import type { SkillRecommendation } from '../../types/skill.js';
 import type { StepRecommendation } from '../../core/step.js';
@@ -36,10 +37,10 @@ export declare class MockHistoryManager implements IHistoryManager {
     addThought(thought: ThoughtData): void;
     getHistory(sessionId?: string): ThoughtData[];
     getHistoryLength(sessionId?: string): number;
-    getBranches(sessionId?: string): Record<string, ThoughtData[]>;
-    getBranchIds(sessionId?: string): string[];
-    registerBranch(_sessionId: string | undefined, _branchId: string): void;
-    branchExists(sessionId: string | undefined, branchId: string): boolean;
+    getBranches(sessionId?: string): Record<BranchId, ThoughtData[]>;
+    getBranchIds(sessionId?: string): BranchId[];
+    registerBranch(_sessionId: string | undefined, _branchId: BranchId): void;
+    branchExists(sessionId: string | undefined, branchId: BranchId): boolean;
     clear(sessionId?: string): void;
     getClearCallCount(): number;
     getAvailableMcpTools(sessionId?: string): string[] | undefined;

package/dist/__tests__/helpers/factories.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"factories.d.ts","sourceRoot":"","sources":["../../../src/__tests__/helpers/factories.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"factories.d.ts","sourceRoot":"","sources":["../../../src/__tests__/helpers/factories.ts"],"names":[],"mappings":"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"}

package/dist/__tests__/integration/CompressionAutoTrigger.test.d.ts

@@ -1,11 +1,2 @@
-/**
- * Integration tests for the auto-compression trigger in ThoughtProcessor.
- *
- * Verifies that when a reasoning strategy returns `action: 'terminate'` AND
- * the compression service is wired AND the current thought has a `branch_id`,
- * the processor invokes `CompressionService.compressBranch()` to produce a
- * Summary in the SummaryStore. Also verifies that compression failures never
- * break the thought pipeline.
- */
 export {};
 //# sourceMappingURL=CompressionAutoTrigger.test.d.ts.map

package/dist/__tests__/integration/CompressionAutoTrigger.test.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"CompressionAutoTrigger.test.d.ts","sourceRoot":"","sources":["../../../src/__tests__/integration/CompressionAutoTrigger.test.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG"}
+{"version":3,"file":"CompressionAutoTrigger.test.d.ts","sourceRoot":"","sources":["../../../src/__tests__/integration/CompressionAutoTrigger.test.ts"],"names":[],"mappings":""}

package/dist/__tests__/integration/CompressionPersistence.test.d.ts

@@ -1,17 +1,2 @@
-/**
- * Integration tests for compression persistence across all 3 backends.
- *
- * Verifies the end-to-end flow:
- *   1. Build a branched session in HistoryManager (with dagEdges so the
- *      compression service can walk descendants).
- *   2. Run CompressionService.compressBranch() to produce a Summary in the
- *      InMemorySummaryStore (flag-ON path).
- *   3. Persist via persistence.saveSummaries(...) and round-trip via
- *      persistence.loadSummaries(...) — assert structural equality.
- *
- * Matrix: 3 backends (Memory / File / SQLite) × 2 flag states (on / off).
- *
- * SQLite: skipped at module level when `better-sqlite3` is unavailable.
- */
 export {};
 //# sourceMappingURL=CompressionPersistence.test.d.ts.map

package/dist/__tests__/integration/CompressionPersistence.test.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"CompressionPersistence.test.d.ts","sourceRoot":"","sources":["../../../src/__tests__/integration/CompressionPersistence.test.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;GAcG"}
+{"version":3,"file":"CompressionPersistence.test.d.ts","sourceRoot":"","sources":["../../../src/__tests__/integration/CompressionPersistence.test.ts"],"names":[],"mappings":""}

package/dist/__tests__/integration/StrategyIntegration.test.d.ts

@@ -1,10 +1,2 @@
-/**
- * End-to-end integration tests for the Strategy layer.
- *
- * Tests the full Strategy integration from {@link ThoughtProcessor} through
- * the MCP response shape. Covers default strategy wiring, terminal vs. ongoing
- * thought hint emission, branch handling, multi-thought sequences, backward
- * compatible response shape, and graceful degradation when a strategy throws.
- */
 export {};
 //# sourceMappingURL=StrategyIntegration.test.d.ts.map

package/dist/__tests__/integration/StrategyIntegration.test.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"StrategyIntegration.test.d.ts","sourceRoot":"","sources":["../../../src/__tests__/integration/StrategyIntegration.test.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG"}
+{"version":3,"file":"StrategyIntegration.test.d.ts","sourceRoot":"","sources":["../../../src/__tests__/integration/StrategyIntegration.test.ts"],"names":[],"mappings":""}

package/dist/__tests__/integration/ToTStrategyIntegration.test.d.ts

@@ -1,18 +1,2 @@
-/**
- * End-to-end integration tests for the {@link TreeOfThoughtStrategy}.
- *
- * Drives the strategy through the full {@link ThoughtProcessor} pipeline
- * with a real {@link HistoryManager} + {@link EdgeStore} + {@link MemoryPersistence}
- * so that `ctx.graph.leaves(sessionId)` reflects the actual DAG built from
- * processed thoughts.
- *
- * Scenarios covered:
- *   a. Single thought  → no strategy_hint (frontier empty → continue)
- *   b. High-confidence frontier → terminate with reason 'confidence threshold'
- *   c. Wide frontier (branches) → branch hint emitted when current is outside beam
- *   d. Flag-off (SequentialStrategy) → no strategy_hint for ongoing thoughts
- *   e. Plateau across low-score thoughts → terminate with reason 'plateau'
- *   f. Strategy throws → graceful degradation: response intact, no strategy_hint
- */
 export {};
 //# sourceMappingURL=ToTStrategyIntegration.test.d.ts.map

package/dist/__tests__/integration/ToTStrategyIntegration.test.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"ToTStrategyIntegration.test.d.ts","sourceRoot":"","sources":["../../../src/__tests__/integration/ToTStrategyIntegration.test.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;GAeG"}
+{"version":3,"file":"ToTStrategyIntegration.test.d.ts","sourceRoot":"","sources":["../../../src/__tests__/integration/ToTStrategyIntegration.test.ts"],"names":[],"mappings":""}

package/dist/__tests__/integration/dag-edges.test.d.ts

@@ -1,17 +1,2 @@
-/**
- * Integration tests for DAG edge emission and persistence.
- *
- * Covers end-to-end behavior across all 3 persistence backends:
- *   - Memory (MemoryPersistence)
- *   - File   (FilePersistence with os.tmpdir())
- *   - SQLite (SqlitePersistence with :memory:)
- *
- * Scenarios:
- *   1. Flag-OFF parity     — no edges emitted/persisted when dagEdges=false
- *   2. Flag-ON edge kinds   — every relational edge kind (except tool_invocation)
- *   3. Three-backend roundtrip — flush + load preserves edges across all backends
- *   4. Multi-session isolation — edges stay scoped to their session
- *   5. Restart roundtrip with GraphView — restored edges traverse correctly
- */
 export {};
 //# sourceMappingURL=dag-edges.test.d.ts.map

package/dist/__tests__/integration/dag-edges.test.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"dag-edges.test.d.ts","sourceRoot":"","sources":["../../../src/__tests__/integration/dag-edges.test.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;GAcG"}
+{"version":3,"file":"dag-edges.test.d.ts","sourceRoot":"","sources":["../../../src/__tests__/integration/dag-edges.test.ts"],"names":[],"mappings":""}

package/dist/__tests__/reasoning-integration.test.d.ts

@@ -1,11 +1,2 @@
-/**
- * Integration tests for the full reasoning pipeline.
- *
- * Exercises ThoughtProcessor + ThoughtEvaluator together across multi-step
- * reasoning chains: hypothesis → verification → synthesis, branching + merge,
- * backward compatibility, metacognitive observations, and confidence tracking.
- *
- * @module __tests__/reasoning-integration
- */
 export {};
 //# sourceMappingURL=reasoning-integration.test.d.ts.map

package/dist/__tests__/reasoning-integration.test.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"reasoning-integration.test.d.ts","sourceRoot":"","sources":["../../src/__tests__/reasoning-integration.test.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG"}
+{"version":3,"file":"reasoning-integration.test.d.ts","sourceRoot":"","sources":["../../src/__tests__/reasoning-integration.test.ts"],"names":[],"mappings":""}

package/dist/__tests__/strategies/StrategyContract.test.d.ts

@@ -1,18 +1,2 @@
-/**
- * Strategy Contract Tests — enforces purity constraints on all
- * {@link IReasoningStrategy} implementations (Oracle review concern C2).
- *
- * Every strategy MUST be:
- *   - Idempotent: repeated `decide()` calls with identical context produce
- *     deeply-equal output.
- *   - Stateless: instances hold no own mutable fields (only the readonly
- *     `name` discriminator is allowed).
- *   - Deterministic: separate instances yield identical decisions for the
- *     same context.
- *   - Side-effect free: `decide()` must not mutate the input
- *     {@link StrategyContext}.
- *
- * @module __tests__/strategies/StrategyContract.test
- */
 export {};
 //# sourceMappingURL=StrategyContract.test.d.ts.map

package/dist/__tests__/strategies/StrategyContract.test.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"StrategyContract.test.d.ts","sourceRoot":"","sources":["../../../src/__tests__/strategies/StrategyContract.test.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;GAeG"}
+{"version":3,"file":"StrategyContract.test.d.ts","sourceRoot":"","sources":["../../../src/__tests__/strategies/StrategyContract.test.ts"],"names":[],"mappings":""}

package/dist/__tests__/thought-processor.test.d.ts

@@ -1,8 +1,2 @@
-/**
- * Comprehensive tests for ThoughtProcessor.
- *
- * This test file covers input validation, error handling, history integration,
- * response formatting, and edge cases for the ThoughtProcessor class.
- */
 export {};
 //# sourceMappingURL=thought-processor.test.d.ts.map

package/dist/__tests__/thought-processor.test.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"thought-processor.test.d.ts","sourceRoot":"","sources":["../../src/__tests__/thought-processor.test.ts"],"names":[],"mappings":"AAAA;;;;;GAKG"}
+{"version":3,"file":"thought-processor.test.d.ts","sourceRoot":"","sources":["../../src/__tests__/thought-processor.test.ts"],"names":[],"mappings":""}

package/dist/cli.js

@@ -11,7 +11,7 @@ import * as __rspack_external_node_fs_5ea92f0c from "node:fs";
 import * as __rspack_external_node_path_c5b9b54f from "node:path";
 import * as __rspack_external_tmcp from "tmcp";
 var __webpack_modules__ = ({
-923(__unused_rspack_module, __webpack_exports__, __webpack_require__) {
+502(__unused_rspack_module, __webpack_exports__, __webpack_require__) {
 
 // EXPORTS
 __webpack_require__.d(__webpack_exports__, {
@@ -1629,7 +1629,7 @@ You should:
 
 
 },
-419(__unused_rspack_module, __webpack_exports__, __webpack_require__) {
+130(__unused_rspack_module, __webpack_exports__, __webpack_require__) {
 
 // EXPORTS
 __webpack_require__.d(__webpack_exports__, {
@@ -2013,8 +2013,8 @@ __webpack_require__.d(__webpack_exports__, {
 /* import */ var node_url__rspack_import_2 = __webpack_require__(61);
 /* import */ var valibot__rspack_import_3 = __webpack_require__(821);
 /* import */ var _schema_js__rspack_import_4 = __webpack_require__(613);
-/* import */ var _BaseTransport_js__rspack_import_5 = __webpack_require__(419);
-/* import */ var _context_RequestContext_js__rspack_import_6 = __webpack_require__(923);
+/* import */ var _BaseTransport_js__rspack_import_5 = __webpack_require__(130);
+/* import */ var _context_RequestContext_js__rspack_import_6 = __webpack_require__(502);
 /**
  * SSE (Server-Sent Events) Transport implementation.
  *
@@ -2310,8 +2310,9 @@ __webpack_require__.d(__webpack_exports__, {
             body += chunk.toString();
         }
         try {
-            const jsonRpcRequest = JSON.parse(body);
-            const parseResult = (0,valibot__rspack_import_3.safeParse)(_schema_js__rspack_import_4/* .JsonRpcRequestSchema */.Uv, jsonRpcRequest);
+            const rawBody = JSON.parse(body);
+            const parseResult = (0,valibot__rspack_import_3.safeParse)(_schema_js__rspack_import_4/* .JsonRpcRequestSchema */.Uv, rawBody);
+            const rawId = rawBody && typeof rawBody === 'object' && 'id' in rawBody ? rawBody.id ?? null : null;
             if (!parseResult.success) {
                 this._metrics?.counter('http_request_errors_total', 1, {
                     transport: 'sse',
@@ -2322,7 +2323,7 @@ __webpack_require__.d(__webpack_exports__, {
                 });
                 res.end(JSON.stringify({
                     jsonrpc: '2.0',
-                    id: jsonRpcRequest?.id ?? null,
+                    id: rawId,
                     error: {
                         code: -32600,
                         message: 'Invalid Request',
@@ -2331,6 +2332,7 @@ __webpack_require__.d(__webpack_exports__, {
                 }));
                 return;
             }
+            const jsonRpcRequest = parseResult.output;
             // Process message through MCP server with owner context
             if (this._mcpServer) {
                 const sessionId = this._clientSessionMap.get(res);
@@ -2349,7 +2351,7 @@ __webpack_require__.d(__webpack_exports__, {
                 } else {
                     res.end(JSON.stringify({
                         jsonrpc: '2.0',
-                        id: jsonRpcRequest?.id ?? null,
+                        id: jsonRpcRequest.id ?? null,
                         result: null
                     }));
                 }
@@ -2473,7 +2475,7 @@ __webpack_require__.d(__webpack_exports__, {
 
 
 },
-34(__unused_rspack_module, __webpack_exports__, __webpack_require__) {
+803(__unused_rspack_module, __webpack_exports__, __webpack_require__) {
 
 // EXPORTS
 __webpack_require__.d(__webpack_exports__, {
@@ -2493,7 +2495,7 @@ var errors = __webpack_require__(937);
 // EXTERNAL MODULE: ./src/schema.ts
 var schema = __webpack_require__(613);
 // EXTERNAL MODULE: ./src/transport/BaseTransport.ts + 1 modules
-var BaseTransport = __webpack_require__(419);
+var BaseTransport = __webpack_require__(130);
 ;// CONCATENATED MODULE: ./src/transport/HttpHelpers.ts
 /**
  * Shared HTTP helper utilities for MCP transport implementations.
@@ -2586,7 +2588,7 @@ var BaseTransport = __webpack_require__(419);
 }
 
 // EXTERNAL MODULE: ./src/context/RequestContext.ts + 1 modules
-var RequestContext = __webpack_require__(923);
+var RequestContext = __webpack_require__(502);
 ;// CONCATENATED MODULE: ./src/transport/StreamableHttpTransport.ts
 /**
  * Streamable HTTP Transport implementation (MCP spec recommended transport).
@@ -2829,9 +2831,9 @@ var RequestContext = __webpack_require__(923);
                 return;
             }
             // Parse JSON
-            let jsonRpcRequest;
+            let rawBody;
             try {
-                jsonRpcRequest = JSON.parse(body);
+                rawBody = JSON.parse(body);
             } catch  {
                 clearTimeout(timeout);
                 this._activeRequests--;
@@ -2839,15 +2841,17 @@ var RequestContext = __webpack_require__(923);
                 return;
             }
             // Validate JSON-RPC schema
-            const parseResult = (0,external_valibot_.safeParse)(schema/* .JsonRpcRequestSchema */.Uv, jsonRpcRequest);
+            const parseResult = (0,external_valibot_.safeParse)(schema/* .JsonRpcRequestSchema */.Uv, rawBody);
+            const rawId = rawBody && typeof rawBody === 'object' && 'id' in rawBody ? rawBody.id ?? null : null;
             if (!parseResult.success) {
                 clearTimeout(timeout);
                 this._activeRequests--;
-                this._sendJsonRpcError(res, 200, -32600, 'Invalid Request', jsonRpcRequest?.id ?? null, {
+                this._sendJsonRpcError(res, 200, -32600, 'Invalid Request', rawId, {
                     data: parseResult.issues
                 });
                 return;
             }
+            const jsonRpcRequest = parseResult.output;
             // Session management (stateful mode)
             let sessionId;
             if (this._stateful) {
@@ -3271,7 +3275,7 @@ var external_node_url_ = __webpack_require__(61);
 // EXTERNAL MODULE: external "./lib.js"
 var external_lib_js_ = __webpack_require__(65);
 // EXTERNAL MODULE: ./src/context/RequestContext.ts + 1 modules
-var RequestContext = __webpack_require__(923);
+var RequestContext = __webpack_require__(502);
 ;// CONCATENATED MODULE: ./src/logger/StructuredLogger.ts
 /**
  * Lightweight structured logging without external dependencies.
@@ -3633,7 +3637,7 @@ async function main() {
 /**
  * Start Streamable HTTP transport (MCP spec recommended)
  */ async function startStreamableHttpTransport(server, thinkingServer) {
-    const { StreamableHttpTransport } = await Promise.resolve(/* import() */).then(__webpack_require__.bind(__webpack_require__, 34));
+    const { StreamableHttpTransport } = await Promise.resolve(/* import() */).then(__webpack_require__.bind(__webpack_require__, 803));
     const port = parseInt(process.env.STREAMABLE_HTTP_PORT || process.env.SSE_PORT || '3000', 10);
     const host = process.env.STREAMABLE_HTTP_HOST || process.env.SSE_HOST || 'localhost';
     const transportMetrics = thinkingServer.getContainer().resolve('Metrics');

package/dist/cli.js.map

@@ -1 +1 @@
-{"version":3,"file":"cli.js","sources":["../src/cli.ts"],"sourcesContent":["#!/usr/bin/env bun\n\n// CLI entry point for tracelattice MCP server.\n// This file handles CLI argument parsing, transport selection, and signal handlers.\n// For library usage, import from './lib.js' or './index.js' instead.\n\nimport { ValibotJsonSchemaAdapter } from '@tmcp/adapter-valibot';\nimport { StdioTransport } from '@tmcp/transport-stdio';\nimport { readFileSync } from 'node:fs';\nimport { dirname, join } from 'node:path';\nimport { fileURLToPath } from 'node:url';\nimport { McpServer } from 'tmcp';\nimport type { ToolAwareSequentialThinkingServer } from './lib.js';\nimport { initializeServer } from './lib.js';\nimport { StructuredLogger } from './logger/StructuredLogger.js';\nimport { getErrorMessage } from './errors.js';\nimport { Metrics } from './metrics/metrics.impl.js';\nimport { SEQUENTIAL_THINKING_TOOL, SequentialThinkingSchema } from './schema.js';\n\n// Get version from package.json\nconst __filename = fileURLToPath(import.meta.url);\nconst __dirname = dirname(__filename);\nconst package_json = JSON.parse(readFileSync(join(__dirname, '../package.json'), 'utf-8'));\nconst { name, version } = package_json;\n// Handle CLI arguments\nconst args = process.argv.slice(2);\nconst shouldShowVersion = args.includes('--version') || args.includes('-v');\n\nif (shouldShowVersion) {\n\tconsole.log(`${name} v${version}`);\n\tprocess.exit(0);\n}\nasync function main() {\n\tconst adapter = new ValibotJsonSchemaAdapter();\n\tconst server = new McpServer(\n\t\t{\n\t\t\tname,\n\t\t\tversion,\n\t\t\tdescription: 'Semantic Sequential Thinking MCP Server',\n\t\t},\n\t\t{\n\t\t\tadapter,\n\t\t\tcapabilities: {\n\t\t\t\ttools: { listChanged: true },\n\t\t\t},\n\t\t}\n\t);\n\n\tconst thinkingServer = await initializeServer();\n\n\tserver.tool(\n\t\t{\n\t\t\tname: 'sequentialthinking_tools',\n\t\t\tdescription: SEQUENTIAL_THINKING_TOOL.description,\n\t\t\tschema: SequentialThinkingSchema,\n\t\t},\n\t\tasync (input) => {\n\t\t\treturn thinkingServer.processThought(input);\n\t\t}\n\t);\n\n\tconst transportType = process.env.TRANSPORT_TYPE || 'stdio';\n\tif (transportType === 'sse') {\n\t\tawait startSseTransport(server, thinkingServer);\n\t} else if (transportType === 'streamable-http') {\n\t\tawait startStreamableHttpTransport(server, thinkingServer);\n\t} else {\n\t\tawait startStdioTransport(server, thinkingServer);\n\t}\n}\n/**\n * Start SSE transport for multi-user support\n */\nasync function startSseTransport(server: McpServer, thinkingServer: ToolAwareSequentialThinkingServer): Promise<void> {\n    const { SseTransport } = await import('./transport/SseTransport.js');\n    const { createConnectionPool } = await import('./pool/ConnectionPool.js');\n    const port = parseInt(process.env.SSE_PORT || '3000', 10);\n    const host = process.env.SSE_HOST || 'localhost';\n    const transportMetrics = thinkingServer.getContainer().resolve<Metrics>('Metrics');\n    const enablePool = process.env.SSE_ENABLE_POOL !== 'false';\n    const maxSessions = parseInt(process.env.SSE_MAX_SESSIONS || '100', 10);\n    const sessionTimeout = parseInt(process.env.SSE_SESSION_TIMEOUT || '300000', 10);\n    const connectionPool = enablePool\n        ? createConnectionPool({\n            maxSessions,\n            sessionTimeout,\n            logger: thinkingServer['_logger'],\n            serverFactory: async () => {\n                const { createServer: createThinkingServer } = await import('./lib.js');\n                const sessionServer = await createThinkingServer({ autoDiscover: true });\n                return sessionServer;\n            },\n          })\n        : undefined;\n    const sseTransport = new SseTransport({\n        port,\n        host,\n        corsOrigin: process.env.CORS_ORIGIN || '*',\n        enableCors: process.env.ENABLE_CORS !== 'false',\n        allowedHosts: process.env.ALLOWED_HOSTS?.split(',').map((hostValue) => hostValue.trim()),\n        metrics: transportMetrics,\n        connectionPool,\n    });\n    // Connect the SSE transport\n    await sseTransport.connect(server);\n    const shutdown = async (): Promise<void> => {\n        await sseTransport.stop();\n        await thinkingServer.stop();\n    };\n    registerShutdownHandlers(shutdown);\n    thinkingServer['_logger'].info(\n        `Sequential Thinking MCP Server running on SSE transport at http://${host}:${port}`\n    );\n}\n/**\n * Start Streamable HTTP transport (MCP spec recommended)\n */\nasync function startStreamableHttpTransport(server: McpServer, thinkingServer: ToolAwareSequentialThinkingServer): Promise<void> {\n    const { StreamableHttpTransport } = await import('./transport/StreamableHttpTransport.js');\n    const port = parseInt(process.env.STREAMABLE_HTTP_PORT || process.env.SSE_PORT || '3000', 10);\n    const host = process.env.STREAMABLE_HTTP_HOST || process.env.SSE_HOST || 'localhost';\n    const transportMetrics = thinkingServer.getContainer().resolve<Metrics>('Metrics');\n    const stateful = process.env.STREAMABLE_HTTP_STATEFUL !== 'false';\n    const streamableTransport = new StreamableHttpTransport({\n\t    port,\n        host,\n        corsOrigin: process.env.CORS_ORIGIN || '*',\n        enableCors: process.env.ENABLE_CORS !== 'false',\n        allowedHosts: process.env.ALLOWED_HOSTS?.split(',').map((hostValue) => hostValue.trim()),\n\t    metrics: transportMetrics,\n\t    stateful,\n    });\n    // Connect the Streamable HTTP transport\n    await streamableTransport.connect(server);\n    const shutdown = async (): Promise<void> => {\n        await streamableTransport.stop();\n        await thinkingServer.stop();\n    };\n    registerShutdownHandlers(shutdown);\n    thinkingServer['_logger'].info(\n        `Sequential Thinking MCP Server running on Streamable HTTP transport at http://${host}:${port}`\n    );\n}\n/**\n * Start stdio transport (default, single-user)\n */\nasync function startStdioTransport(server: McpServer, thinkingServer: ToolAwareSequentialThinkingServer): Promise<void> {\n    const transport = new StdioTransport(server);\n    transport.listen();\n    const shutdown = async (): Promise<void> => {\n        const forceExit = setTimeout(() => {\n            thinkingServer['_logger'].error('Graceful shutdown timed out after 30s - forcing exit');\n            process.exit(1);\n        }, 30_000).unref(); // 30s timeout, don't keep process alive\n        try {\n            await thinkingServer.stop();\n            clearTimeout(forceExit);\n            process.exit(0);\n        } catch (error) {\n            thinkingServer['_logger'].error('Error during shutdown', {\n                error: getErrorMessage(error),\n            });\n            process.exit(1);\n        }\n    };\n    // Register signal handlers ONCE (fixes double-registration bug)\n    process.once('SIGINT', () => void shutdown());\n    process.once('SIGTERM', () => void shutdown());\n    thinkingServer['_logger'].info('Sequential Thinking MCP Server running on stdio');\n}\n/**\n * Register shutdown signal handlers for a common pattern\n */\nfunction registerShutdownHandlers(shutdown: () => Promise<void>): void {\n    process.once('SIGINT', () => {\n        shutdown()\n            .then(() => process.exit(0))\n            .catch(() => process.exit(1));\n    });\n    process.once('SIGTERM', () => {\n        shutdown()\n            .then(() => process.exit(0))\n            .catch(() => process.exit(1));\n    });\n}\nmain().catch((error) => {\n    const logger = new StructuredLogger({\n        level: 'error',\n        context: 'SequentialThinking',\n        pretty: true,\n    });\n    logger.error('Fatal error running server', {\n        error: getErrorMessage(error),\n    });\n    process.exit(1);\n});\n"],"names":["__filename","fileURLToPath","__dirname","dirname","package_json","JSON","readFileSync","join","name","version","args","process","shouldShowVersion","console","main","adapter","ValibotJsonSchemaAdapter","server","McpServer","thinkingServer","initializeServer","SEQUENTIAL_THINKING_TOOL","SequentialThinkingSchema","input","transportType","startSseTransport","startStreamableHttpTransport","startStdioTransport","SseTransport","createConnectionPool","port","parseInt","host","transportMetrics","enablePool","maxSessions","sessionTimeout","connectionPool","createThinkingServer","sessionServer","undefined","sseTransport","hostValue","shutdown","registerShutdownHandlers","StreamableHttpTransport","stateful","streamableTransport","transport","StdioTransport","forceExit","setTimeout","clearTimeout","error","getErrorMessage","logger","StructuredLogger"],"mappings":"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"}
+{"version":3,"file":"cli.js","sources":["../src/cli.ts"],"sourcesContent":["#!/usr/bin/env bun\n\n// CLI entry point for tracelattice MCP server.\n// This file handles CLI argument parsing, transport selection, and signal handlers.\n// For library usage, import from './lib.js' or './index.js' instead.\n\nimport { ValibotJsonSchemaAdapter } from '@tmcp/adapter-valibot';\nimport { StdioTransport } from '@tmcp/transport-stdio';\nimport { readFileSync } from 'node:fs';\nimport { dirname, join } from 'node:path';\nimport { fileURLToPath } from 'node:url';\nimport { McpServer } from 'tmcp';\nimport type { ToolAwareSequentialThinkingServer } from './lib.js';\nimport { initializeServer } from './lib.js';\nimport { StructuredLogger } from './logger/StructuredLogger.js';\nimport { getErrorMessage } from './errors.js';\nimport { SEQUENTIAL_THINKING_TOOL, SequentialThinkingSchema } from './schema.js';\n\n// Get version from package.json\nconst __filename = fileURLToPath(import.meta.url);\nconst __dirname = dirname(__filename);\nconst package_json = JSON.parse(readFileSync(join(__dirname, '../package.json'), 'utf-8'));\nconst { name, version } = package_json;\n// Handle CLI arguments\nconst args = process.argv.slice(2);\nconst shouldShowVersion = args.includes('--version') || args.includes('-v');\n\nif (shouldShowVersion) {\n\tconsole.log(`${name} v${version}`);\n\tprocess.exit(0);\n}\nasync function main() {\n\tconst adapter = new ValibotJsonSchemaAdapter();\n\tconst server = new McpServer(\n\t\t{\n\t\t\tname,\n\t\t\tversion,\n\t\t\tdescription: 'Semantic Sequential Thinking MCP Server',\n\t\t},\n\t\t{\n\t\t\tadapter,\n\t\t\tcapabilities: {\n\t\t\t\ttools: { listChanged: true },\n\t\t\t},\n\t\t}\n\t);\n\n\tconst thinkingServer = await initializeServer();\n\n\tserver.tool(\n\t\t{\n\t\t\tname: 'sequentialthinking_tools',\n\t\t\tdescription: SEQUENTIAL_THINKING_TOOL.description,\n\t\t\tschema: SequentialThinkingSchema,\n\t\t},\n\t\tasync (input) => {\n\t\t\treturn thinkingServer.processThought(input);\n\t\t}\n\t);\n\n\tconst transportType = process.env.TRANSPORT_TYPE || 'stdio';\n\tif (transportType === 'sse') {\n\t\tawait startSseTransport(server, thinkingServer);\n\t} else if (transportType === 'streamable-http') {\n\t\tawait startStreamableHttpTransport(server, thinkingServer);\n\t} else {\n\t\tawait startStdioTransport(server, thinkingServer);\n\t}\n}\n/**\n * Start SSE transport for multi-user support\n */\nasync function startSseTransport(server: McpServer, thinkingServer: ToolAwareSequentialThinkingServer): Promise<void> {\n    const { SseTransport } = await import('./transport/SseTransport.js');\n    const { createConnectionPool } = await import('./pool/ConnectionPool.js');\n    const port = parseInt(process.env.SSE_PORT || '3000', 10);\n    const host = process.env.SSE_HOST || 'localhost';\n    const transportMetrics = thinkingServer.getContainer().resolve('Metrics');\n    const enablePool = process.env.SSE_ENABLE_POOL !== 'false';\n    const maxSessions = parseInt(process.env.SSE_MAX_SESSIONS || '100', 10);\n    const sessionTimeout = parseInt(process.env.SSE_SESSION_TIMEOUT || '300000', 10);\n    const connectionPool = enablePool\n        ? createConnectionPool({\n            maxSessions,\n            sessionTimeout,\n            logger: thinkingServer['_logger'],\n            serverFactory: async () => {\n                const { createServer: createThinkingServer } = await import('./lib.js');\n                const sessionServer = await createThinkingServer({ autoDiscover: true });\n                return sessionServer;\n            },\n          })\n        : undefined;\n    const sseTransport = new SseTransport({\n        port,\n        host,\n        corsOrigin: process.env.CORS_ORIGIN || '*',\n        enableCors: process.env.ENABLE_CORS !== 'false',\n        allowedHosts: process.env.ALLOWED_HOSTS?.split(',').map((hostValue) => hostValue.trim()),\n        metrics: transportMetrics,\n        connectionPool,\n    });\n    // Connect the SSE transport\n    await sseTransport.connect(server);\n    const shutdown = async (): Promise<void> => {\n        await sseTransport.stop();\n        await thinkingServer.stop();\n    };\n    registerShutdownHandlers(shutdown);\n    thinkingServer['_logger'].info(\n        `Sequential Thinking MCP Server running on SSE transport at http://${host}:${port}`\n    );\n}\n/**\n * Start Streamable HTTP transport (MCP spec recommended)\n */\nasync function startStreamableHttpTransport(server: McpServer, thinkingServer: ToolAwareSequentialThinkingServer): Promise<void> {\n    const { StreamableHttpTransport } = await import('./transport/StreamableHttpTransport.js');\n    const port = parseInt(process.env.STREAMABLE_HTTP_PORT || process.env.SSE_PORT || '3000', 10);\n    const host = process.env.STREAMABLE_HTTP_HOST || process.env.SSE_HOST || 'localhost';\n    const transportMetrics = thinkingServer.getContainer().resolve('Metrics');\n    const stateful = process.env.STREAMABLE_HTTP_STATEFUL !== 'false';\n    const streamableTransport = new StreamableHttpTransport({\n\t    port,\n        host,\n        corsOrigin: process.env.CORS_ORIGIN || '*',\n        enableCors: process.env.ENABLE_CORS !== 'false',\n        allowedHosts: process.env.ALLOWED_HOSTS?.split(',').map((hostValue) => hostValue.trim()),\n\t    metrics: transportMetrics,\n\t    stateful,\n    });\n    // Connect the Streamable HTTP transport\n    await streamableTransport.connect(server);\n    const shutdown = async (): Promise<void> => {\n        await streamableTransport.stop();\n        await thinkingServer.stop();\n    };\n    registerShutdownHandlers(shutdown);\n    thinkingServer['_logger'].info(\n        `Sequential Thinking MCP Server running on Streamable HTTP transport at http://${host}:${port}`\n    );\n}\n/**\n * Start stdio transport (default, single-user)\n */\nasync function startStdioTransport(server: McpServer, thinkingServer: ToolAwareSequentialThinkingServer): Promise<void> {\n    const transport = new StdioTransport(server);\n    transport.listen();\n    const shutdown = async (): Promise<void> => {\n        const forceExit = setTimeout(() => {\n            thinkingServer['_logger'].error('Graceful shutdown timed out after 30s - forcing exit');\n            process.exit(1);\n        }, 30_000).unref(); // 30s timeout, don't keep process alive\n        try {\n            await thinkingServer.stop();\n            clearTimeout(forceExit);\n            process.exit(0);\n        } catch (error) {\n            thinkingServer['_logger'].error('Error during shutdown', {\n                error: getErrorMessage(error),\n            });\n            process.exit(1);\n        }\n    };\n    // Register signal handlers ONCE (fixes double-registration bug)\n    process.once('SIGINT', () => void shutdown());\n    process.once('SIGTERM', () => void shutdown());\n    thinkingServer['_logger'].info('Sequential Thinking MCP Server running on stdio');\n}\n/**\n * Register shutdown signal handlers for a common pattern\n */\nfunction registerShutdownHandlers(shutdown: () => Promise<void>): void {\n    process.once('SIGINT', () => {\n        shutdown()\n            .then(() => process.exit(0))\n            .catch(() => process.exit(1));\n    });\n    process.once('SIGTERM', () => {\n        shutdown()\n            .then(() => process.exit(0))\n            .catch(() => process.exit(1));\n    });\n}\nmain().catch((error) => {\n    const logger = new StructuredLogger({\n        level: 'error',\n        context: 'SequentialThinking',\n        pretty: true,\n    });\n    logger.error('Fatal error running server', {\n        error: getErrorMessage(error),\n    });\n    process.exit(1);\n});\n"],"names":["__filename","fileURLToPath","__dirname","dirname","package_json","JSON","readFileSync","join","name","version","args","process","shouldShowVersion","console","main","adapter","ValibotJsonSchemaAdapter","server","McpServer","thinkingServer","initializeServer","SEQUENTIAL_THINKING_TOOL","SequentialThinkingSchema","input","transportType","startSseTransport","startStreamableHttpTransport","startStdioTransport","SseTransport","createConnectionPool","port","parseInt","host","transportMetrics","enablePool","maxSessions","sessionTimeout","connectionPool","createThinkingServer","sessionServer","undefined","sseTransport","hostValue","shutdown","registerShutdownHandlers","StreamableHttpTransport","stateful","streamableTransport","transport","StdioTransport","forceExit","setTimeout","clearTimeout","error","getErrorMessage","logger","StructuredLogger"],"mappings":"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"}

package/dist/config/ConfigLoader.d.ts

@@ -40,72 +40,72 @@ export interface ConfigFileOptions {
      * Maximum number of thoughts to keep in history.
      * Can be overridden by `MAX_HISTORY_SIZE` environment variable.
      */
-    maxHistorySize?: number;
+    readonly maxHistorySize?: number;
     /**
      * Maximum number of branches to maintain.
      * Can be overridden by `MAX_BRANCHES` environment variable.
      */
-    maxBranches?: number;
+    readonly maxBranches?: number;
     /**
      * Maximum size of each branch.
      * Can be overridden by `MAX_BRANCH_SIZE` environment variable.
      */
-    maxBranchSize?: number;
+    readonly maxBranchSize?: number;
     /**
      * Logging level for the application.
      * Can be overridden by `LOG_LEVEL` environment variable.
      */
-    logLevel?: 'debug' | 'info' | 'warn' | 'error';
+    readonly logLevel?: 'debug' | 'info' | 'warn' | 'error';
     /**
      * Whether to enable pretty (formatted) logging output.
      * Can be overridden by `PRETTY_LOG` environment variable (set to "false" to disable).
      */
-    prettyLog?: boolean;
+    readonly prettyLog?: boolean;
     /**
      * Directory paths to search for skills.
      * Can be overridden by `SKILL_DIRS` environment variable (colon-separated).
      */
-    skillDirs?: string[];
+    readonly skillDirs?: string[];
     /**
      * Discovery cache configuration.
      * Can be overridden by `DISCOVERY_CACHE_TTL` and `DISCOVERY_CACHE_MAX_SIZE` environment variables.
      */
-    discoveryCache?: {
+    readonly discoveryCache?: {
         /**
          * Time-to-live for cache entries in milliseconds.
          * Environment variable `DISCOVERY_CACHE_TTL` accepts seconds.
          */
-        ttl?: number;
+        readonly ttl?: number;
         /**
          * Maximum number of entries in the cache.
          */
-        maxSize?: number;
+        readonly maxSize?: number;
     };
     /**
      * Persistence configuration for storing history and state.
      */
-    persistence?: PersistenceConfig;
+    readonly persistence?: PersistenceConfig;
     /**
      * Feature flag overrides. Each field can be set independently.
      * Can be overridden by `TRACELATTICE_FEATURES_*` environment variables.
      */
-    features?: Partial<FeatureFlags>;
+    readonly features?: Partial<FeatureFlags>;
     /**
      * TTL in milliseconds for suspended tool-interleave entries.
      * Can be overridden by `TRACELATTICE_TOOL_INTERLEAVE_TTL_MS` environment variable.
      */
-    toolInterleaveTtlMs?: number;
+    readonly toolInterleaveTtlMs?: number;
     /**
      * Sweep interval in milliseconds for SuspensionStore expiration cleanup.
      * Can be overridden by `TRACELATTICE_TOOL_INTERLEAVE_SWEEP_MS` environment variable.
      */
-    toolInterleaveSweepMs?: number;
+    readonly toolInterleaveSweepMs?: number;
     /**
      * Maximum sessions per owner. Per-owner LRU bucket prevents one user from
      * consuming all session slots.
      * Can be overridden by `SESSION_MAX_PER_OWNER` environment variable.
      */
-    maxSessionsPerOwner?: number;
+    readonly maxSessionsPerOwner?: number;
 }
 /**
  * Loads configuration from files with environment variable overrides.

package/dist/config/ConfigLoader.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"ConfigLoader.d.ts","sourceRoot":"","sources":["../../src/config/ConfigLoader.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AAMH,OAAO,KAAK,EAAE,iBAAiB,EAAE,MAAM,oCAAoC,CAAC;AAE5E,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,0BAA0B,CAAC;AAE7D;;;;;;;;;;;;;;;;;;;;;;;;;GAyBG;AACH,MAAM,WAAW,iBAAiB;IACjC;;;OAGG;IACH,cAAc,CAAC,EAAE,MAAM,CAAC;IAExB;;;OAGG;IACH,WAAW,CAAC,EAAE,MAAM,CAAC;IAErB;;;OAGG;IACH,aAAa,CAAC,EAAE,MAAM,CAAC;IAEvB;;;OAGG;IACH,QAAQ,CAAC,EAAE,OAAO,GAAG,MAAM,GAAG,MAAM,GAAG,OAAO,CAAC;IAE/C;;;OAGG;IACH,SAAS,CAAC,EAAE,OAAO,CAAC;IAEpB;;;OAGG;IACH,SAAS,CAAC,EAAE,MAAM,EAAE,CAAC;IAErB;;;OAGG;IACH,cAAc,CAAC,EAAE;QAChB;;;WAGG;QACH,GAAG,CAAC,EAAE,MAAM,CAAC;QACb;;WAEG;QACH,OAAO,CAAC,EAAE,MAAM,CAAC;KACjB,CAAC;IAEF;;OAEG;IACH,WAAW,CAAC,EAAE,iBAAiB,CAAC;IAEhC;;;OAGG;IACH,QAAQ,CAAC,EAAE,OAAO,CAAC,YAAY,CAAC,CAAC;IAEjC;;;OAGG;IACH,mBAAmB,CAAC,EAAE,MAAM,CAAC;IAE7B;;;OAGG;IACH,qBAAqB,CAAC,EAAE,MAAM,CAAC;IAE/B;;;;OAIG;IACH,mBAAmB,CAAC,EAAE,MAAM,CAAC;CAC7B;AAED;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GA0CG;AACH,qBAAa,YAAY;IACxB,+DAA+D;IAC/D,OAAO,CAAC,YAAY,CAAW;IAE/B;;;;;;;;;;;;;OAaG;gBACS,UAAU,CAAC,EAAE,MAAM;IAa/B;;;;;;;;;;;;;;;;;;;OAmBG;IACH,IAAI,IAAI,iBAAiB,GAAG,IAAI;IAoBhC;;;;;;;;;;;;;;;OAeG;IACH,OAAO,CAAC,yBAAyB;IAuEjC;;;;;;;OAOG;IACH,OAAO,CAAC,yBAAyB;IA0CjC;;;;;;;OAOG;IACH,OAAO,CAAC,YAAY;IAOpB;;;;;;;;;;OAUG;IACH,OAAO,CAAC,WAAW;IAWnB;;;;;;;;;;;;;;;;;;OAkBG;IACH,qBAAqB,CAAC,MAAM,EAAE,iBAAiB,GAAG;QACjD,cAAc,CAAC,EAAE,MAAM,CAAC;QACxB,WAAW,CAAC,EAAE,MAAM,CAAC;QACrB,aAAa,CAAC,EAAE,MAAM,CAAC;QACvB,QAAQ,CAAC,EAAE,OAAO,CAAC,YAAY,CAAC,CAAC;QACjC,mBAAmB,CAAC,EAAE,MAAM,CAAC;QAC7B,qBAAqB,CAAC,EAAE,MAAM,CAAC;QAC/B,mBAAmB,CAAC,EAAE,MAAM,CAAC;KAC7B;CAWD"}
+{"version":3,"file":"ConfigLoader.d.ts","sourceRoot":"","sources":["../../src/config/ConfigLoader.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AAMH,OAAO,KAAK,EAAE,iBAAiB,EAAE,MAAM,oCAAoC,CAAC;AAE5E,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,0BAA0B,CAAC;AAI7D;;;;;;;;;;;;;;;;;;;;;;;;;GAyBG;AACH,MAAM,WAAW,iBAAiB;IACjC;;;OAGG;IACH,QAAQ,CAAC,cAAc,CAAC,EAAE,MAAM,CAAC;IAEjC;;;OAGG;IACH,QAAQ,CAAC,WAAW,CAAC,EAAE,MAAM,CAAC;IAE9B;;;OAGG;IACH,QAAQ,CAAC,aAAa,CAAC,EAAE,MAAM,CAAC;IAEhC;;;OAGG;IACH,QAAQ,CAAC,QAAQ,CAAC,EAAE,OAAO,GAAG,MAAM,GAAG,MAAM,GAAG,OAAO,CAAC;IAExD;;;OAGG;IACH,QAAQ,CAAC,SAAS,CAAC,EAAE,OAAO,CAAC;IAE7B;;;OAGG;IACH,QAAQ,CAAC,SAAS,CAAC,EAAE,MAAM,EAAE,CAAC;IAE9B;;;OAGG;IACH,QAAQ,CAAC,cAAc,CAAC,EAAE;QACzB;;;WAGG;QACH,QAAQ,CAAC,GAAG,CAAC,EAAE,MAAM,CAAC;QACtB;;WAEG;QACH,QAAQ,CAAC,OAAO,CAAC,EAAE,MAAM,CAAC;KAC1B,CAAC;IAEF;;OAEG;IACH,QAAQ,CAAC,WAAW,CAAC,EAAE,iBAAiB,CAAC;IAEzC;;;OAGG;IACH,QAAQ,CAAC,QAAQ,CAAC,EAAE,OAAO,CAAC,YAAY,CAAC,CAAC;IAE1C;;;OAGG;IACH,QAAQ,CAAC,mBAAmB,CAAC,EAAE,MAAM,CAAC;IAEtC;;;OAGG;IACH,QAAQ,CAAC,qBAAqB,CAAC,EAAE,MAAM,CAAC;IAExC;;;;OAIG;IACH,QAAQ,CAAC,mBAAmB,CAAC,EAAE,MAAM,CAAC;CACtC;AAED;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GA0CG;AACH,qBAAa,YAAY;IACxB,+DAA+D;IAC/D,OAAO,CAAC,YAAY,CAAW;IAE/B;;;;;;;;;;;;;OAaG;gBACS,UAAU,CAAC,EAAE,MAAM;IAa/B;;;;;;;;;;;;;;;;;;;OAmBG;IACH,IAAI,IAAI,iBAAiB,GAAG,IAAI;IAoBhC;;;;;;;;;;;;;;;OAeG;IACH,OAAO,CAAC,yBAAyB;IAqEjC;;;;;;;OAOG;IACH,OAAO,CAAC,yBAAyB;IA0CjC;;;;;;;OAOG;IACH,OAAO,CAAC,YAAY;IAOpB;;;;;;;;;;OAUG;IACH,OAAO,CAAC,WAAW;IAWnB;;;;;;;;;;;;;;;;;;OAkBG;IACH,qBAAqB,CAAC,MAAM,EAAE,iBAAiB,GAAG;QACjD,cAAc,CAAC,EAAE,MAAM,CAAC;QACxB,WAAW,CAAC,EAAE,MAAM,CAAC;QACrB,aAAa,CAAC,EAAE,MAAM,CAAC;QACvB,QAAQ,CAAC,EAAE,OAAO,CAAC,YAAY,CAAC,CAAC;QACjC,mBAAmB,CAAC,EAAE,MAAM,CAAC;QAC7B,qBAAqB,CAAC,EAAE,MAAM,CAAC;QAC/B,mBAAmB,CAAC,EAAE,MAAM,CAAC;KAC7B;CAWD"}

package/dist/config/ConfigLoader.js

@@ -53,17 +53,17 @@ class ConfigLoader {
         if (process.env.SKILL_DIRS) result.skillDirs = process.env.SKILL_DIRS.split(':');
         if (process.env.DISCOVERY_CACHE_TTL) {
             const parsed = parseInt(process.env.DISCOVERY_CACHE_TTL, 10);
-            if (Number.isFinite(parsed)) {
-                result.discoveryCache = result.discoveryCache || {};
-                result.discoveryCache.ttl = 1000 * parsed;
-            }
+            if (Number.isFinite(parsed)) result.discoveryCache = {
+                ...result.discoveryCache ?? {},
+                ttl: 1000 * parsed
+            };
         }
         if (process.env.DISCOVERY_CACHE_MAX_SIZE) {
             const parsed = parseInt(process.env.DISCOVERY_CACHE_MAX_SIZE, 10);
-            if (Number.isFinite(parsed)) {
-                result.discoveryCache = result.discoveryCache || {};
-                result.discoveryCache.maxSize = parsed;
-            }
+            if (Number.isFinite(parsed)) result.discoveryCache = {
+                ...result.discoveryCache ?? {},
+                maxSize: parsed
+            };
         }
         if (process.env.TRACELATTICE_TOOL_INTERLEAVE_TTL_MS) {
             const parsed = parseInt(process.env.TRACELATTICE_TOOL_INTERLEAVE_TTL_MS, 10);