tracelattice 1.2.5

package/LICENSE

@@ -0,0 +1,24 @@
+This is free and unencumbered software released into the public domain.
+
+Anyone is free to copy, modify, publish, use, compile, sell, or
+distribute this software, either in source code form or as a compiled
+binary, for any purpose, commercial or non-commercial, and by any
+means.
+
+In jurisdictions that recognize copyright laws, the author or authors
+of this software dedicate any and all copyright interest in the
+software to the public domain. We make this dedication for the benefit
+of the public at large and to the detriment of our heirs and
+successors. We intend this dedication to be an overt act of
+relinquishment in perpetuity of all present and future rights to this
+software under copyright law.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND,
+EXPRESS OR IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF
+MERCHANTABILITY, FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT.
+IN NO EVENT SHALL THE AUTHORS BE LIABLE FOR ANY CLAIM, DAMAGES OR
+OTHER LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE,
+ARISING FROM, OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR
+OTHER DEALINGS IN THE SOFTWARE.
+
+For more information, please refer to <https://unlicense.org>

package/README.md

@@ -0,0 +1,112 @@
+# MCP Sequential Thinking Server
+
+An MCP (Model Context Protocol) server that provides sequential thinking capabilities with intelligent tool and skill recommendations for AI assistants.
+
+## Features
+
+- **Sequential Thinking Framework**: Break down complex problems into structured thought steps
+- **Tool Recommendations**: AI-driven tool selection with confidence scores and rationales
+- **Skill Integration**: Support for Claude Code skills with automatic discovery
+- **Branching & Revision**: Non-linear thinking paths with thought revision support
+- **History Management**: Configurable thought history with automatic trimming
+- **Type-Safe**: Full TypeScript support with Valibot validation
+
+## Install
+
+Requires [Node.js](https://nodejs.org/) v18+.
+
+From the project root:
+
+```
+> **Tip:** Use `./install.sh --link` for development mode (symlinks instead of copying, rebuild with `npm run build` after changes).
+
+## Configure MCP Client
+
+The server uses **stdio transport** by default — no extra configuration needed. Add it to your MCP client:
+
+### Claude Code
+
+**User-scoped** (`~/.claude.json`) or **project-scoped** (`.mcp.json` in project root):
+
+```json
+{
+  "mcpServers": {
+    "tracelattice": {
+      "command": "tracelattice"
+    }
+  }
+}
+```
+
+Or via CLI:
+
+```bash
+claude mcp add tracelattice -- tracelattice
+```
+
+### Codex CLI
+
+**User-scoped** (`~/.codex/config.toml`) or **project-scoped** (`.codex/config.toml`):
+
+```toml
+[mcp_servers.tracelattice]
+command = "tracelattice"
+```
+
+Or via CLI:
+
+```bash
+codex mcp add tracelattice -- tracelattice
+```
+
+### OpenCode
+
+**Global** (`~/.config/opencode/opencode.json`) or **project-scoped** (`.opencode.json`):
+
+```json
+{
+  "mcpServers": {
+    "tracelattice": {
+      "type": "local",
+      "command": [
+        "npx",
+        "-y",
+        "tracelattice"
+      ],
+      "enabled": true,
+      "environment": {
+        "MAX_HISTORY_SIZE": "10000"
+      }
+    },
+  }
+}
+```
+
+## Configuration
+
+| Variable | Default | Description |
+|----------|---------|-------------|
+| `MAX_HISTORY_SIZE` | `1000` | Maximum thoughts to keep in history |
+
+## Transports
+
+The server supports three transports via the `TRANSPORT_TYPE` environment variable:
+
+| Transport | Use Case | Command |
+|-----------|----------|---------|
+| `stdio` (default) | Local MCP clients | `tracelattice` |
+| `sse` (legacy) | Multi-user, backwards compat | `TRANSPORT_TYPE=sse tracelattice` |
+| `streamable-http` | Production deployments | `TRANSPORT_TYPE=streamable-http tracelattice` |
+## Development
+
+```bash
+npm install
+npm run dev        # MCP inspector
+npm test
+npm run type-check
+npm run lint
+```
+
+## License
+
+MIT

package/dist/ServerConfig.d.ts

@@ -0,0 +1,229 @@
+/**
+ * Server configuration management with validation.
+ *
+ * This module provides the `ServerConfig` class which handles all server configuration
+ * with built-in validation and sensible defaults. Configuration values are validated
+ * on construction and warnings are emitted for out-of-range values.
+ *
+ * @module ServerConfig
+ */
+import type { PersistenceConfig } from './persistence/PersistenceBackend.js';
+/**
+ * Configuration options for creating a `ServerConfig` instance.
+ *
+ * All properties are optional with sensible defaults applied during validation.
+ *
+ * @example
+ * ```typescript
+ * const options: ServerConfigOptions = {
+ *   maxHistorySize: 500,
+ *   maxBranches: 25,
+ *   skillDirs: ['./custom-skills'],
+ *   persistence: { enabled: true, backend: 'sqlite' }
+ * };
+ * ```
+ */
+export interface ServerConfigOptions {
+    /**
+     * Maximum number of thoughts to keep in history.
+     * @default 1000
+     */
+    maxHistorySize?: number;
+    /**
+     * Maximum number of branches to maintain.
+     * @default 50
+     */
+    maxBranches?: number;
+    /**
+     * Maximum size of each branch.
+     * @default 100
+     */
+    maxBranchSize?: number;
+    /**
+     * Directory paths to search for skills.
+     * @default ['.claude/skills', '~/.claude/skills']
+     */
+    skillDirs?: string[];
+    /**
+     * Discovery cache configuration.
+     */
+    discoveryCache?: {
+        /**
+         * Time-to-live for cache entries in milliseconds.
+         * @default 300000 (5 minutes)
+         */
+        ttl?: number;
+        /**
+         * Maximum number of entries in the cache.
+         * @default 100
+         */
+        maxSize?: number;
+    };
+    /**
+     * Persistence configuration for storing history and state.
+     */
+    persistence?: PersistenceConfig;
+    /**
+     * Maximum number of thoughts to buffer before flushing to persistence.
+     * @default 100
+     */
+    persistenceBufferSize?: number;
+    /**
+     * Interval in milliseconds between periodic persistence flushes.
+     * @default 1000
+     */
+    persistenceFlushInterval?: number;
+    /**
+     * Maximum number of retries for failed persistence flushes.
+     * @default 3
+     */
+    persistenceMaxRetries?: number;
+}
+/**
+ * Server configuration with validation and defaults.
+ *
+ * This class manages all server configuration including history limits,
+ * branch limits, skill directories, discovery cache settings, and persistence.
+ * All values are validated on construction with appropriate defaults applied.
+ *
+ * @remarks
+ * - Values outside recommended ranges trigger warnings but are still applied
+ * - Environment variables override file-based configuration
+ * - The `toJSON()` method provides a plain object representation
+ *
+ * @example
+ * ```typescript
+ * // Using defaults
+ * const config1 = new ServerConfig();
+ * console.log(config1.maxHistorySize); // 1000
+ *
+ * // With custom options
+ * const config2 = new ServerConfig({
+ *   maxHistorySize: 500,
+ *   persistence: { enabled: true, backend: 'file', options: { dataDir: './data' } }
+ * });
+ *
+ * // Export as plain object
+ * const json = config2.toJSON();
+ * ```
+ */
+export declare class ServerConfig {
+    /** Maximum number of thoughts to keep in history. */
+    maxHistorySize: number;
+    /** Maximum number of branches to maintain. */
+    maxBranches: number;
+    /** Maximum size of each branch. */
+    maxBranchSize: number;
+    /** Directory paths to search for skills. */
+    skillDirs: string[];
+    /** Discovery cache configuration. */
+    discoveryCache: {
+        ttl: number;
+        maxSize: number;
+    };
+    /** Persistence configuration. */
+    persistence: PersistenceConfig;
+    /** Maximum number of thoughts to buffer before flushing to persistence. */
+    persistenceBufferSize: number;
+    /** Interval in milliseconds between periodic persistence flushes. */
+    persistenceFlushInterval: number;
+    /** Maximum number of retries for failed persistence flushes. */
+    persistenceMaxRetries: number;
+    /**
+     * Creates a new ServerConfig instance with validation.
+     *
+     * All values are validated and defaults are applied for undefined options.
+     * Warnings are emitted to console for values outside recommended ranges.
+     *
+     * @param options - Optional configuration overrides
+     *
+     * @example
+     * ```typescript
+     * const config = new ServerConfig({
+     *   maxHistorySize: 500,
+     *   skillDirs: ['./my-skills']
+     * });
+     * ```
+     */
+    constructor(options?: ServerConfigOptions);
+    /**
+     * Validates the max history size value.
+     * @param value - The value to validate
+     * @returns The validated value or default (1000)
+     * @private
+     */
+    private validateMaxHistorySize;
+    /**
+     * Validates the max branches value.
+     * @param value - The value to validate
+     * @returns The validated value or default (50)
+     * @private
+     */
+    private validateMaxBranches;
+    /**
+     * Validates the max branch size value.
+     * @param value - The value to validate
+     * @returns The validated value or default (100)
+     * @private
+     */
+    private validateMaxBranchSize;
+    /**
+     * Validates the skill directories value.
+     * @param value - The value to validate
+     * @returns The validated value or default ['.claude/skills', '~/.claude/skills']
+     * @private
+     */
+    private validateSkillDirs;
+    /**
+     * Validates the discovery cache configuration.
+     * @param value - The value to validate
+     * @returns The validated value with defaults applied
+     * @private
+     */
+    private validateDiscoveryCache;
+    /**
+     * Validates the persistence configuration.
+     * @param value - The value to validate
+     * @returns The validated value with defaults applied
+     * @private
+     */
+    private validatePersistence;
+    /**
+     * Validates the persistence buffer size value.
+     * @param value - The value to validate
+     * @returns The validated value or default (100)
+     * @private
+     */
+    private validatePersistenceBufferSize;
+    /**
+     * Validates the persistence flush interval value.
+     * @param value - The value to validate
+     * @returns The validated value or default (1000)
+     * @private
+     */
+    private validatePersistenceFlushInterval;
+    /**
+     * Validates the persistence max retries value.
+     * @param value - The value to validate
+     * @returns The validated value or default (3)
+     * @private
+     */
+    private validatePersistenceMaxRetries;
+    /**
+     * Converts the configuration to a plain object.
+     *
+     * Useful for serialization, logging, or when a plain object representation
+     * is preferred over the ServerConfig instance.
+     *
+     * @returns A plain object representation of the configuration
+     *
+     * @example
+     * ```typescript
+     * const config = new ServerConfig({ maxHistorySize: 500 });
+     * const json = config.toJSON();
+     * console.log(JSON.stringify(json, null, 2));
+     * ```
+     */
+    toJSON(): ServerConfigOptions;
+}
+//# sourceMappingURL=ServerConfig.d.ts.map

package/dist/ServerConfig.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"ServerConfig.d.ts","sourceRoot":"","sources":["../src/ServerConfig.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AAKH,OAAO,KAAK,EAAE,iBAAiB,EAAE,MAAM,qCAAqC,CAAC;AAE7E;;;;;;;;;;;;;;GAcG;AACH,MAAM,WAAW,mBAAmB;IACnC;;;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,SAAS,CAAC,EAAE,MAAM,EAAE,CAAC;IAErB;;OAEG;IACH,cAAc,CAAC,EAAE;QAChB;;;WAGG;QACH,GAAG,CAAC,EAAE,MAAM,CAAC;QACb;;;WAGG;QACH,OAAO,CAAC,EAAE,MAAM,CAAC;KACjB,CAAC;IAEF;;OAEG;IACH,WAAW,CAAC,EAAE,iBAAiB,CAAC;IAEhC;;;OAGG;IACH,qBAAqB,CAAC,EAAE,MAAM,CAAC;IAE/B;;;OAGG;IACH,wBAAwB,CAAC,EAAE,MAAM,CAAC;IAElC;;;OAGG;IACH,qBAAqB,CAAC,EAAE,MAAM,CAAC;CAC/B;AAED;;;;;;;;;;;;;;;;;;;;;;;;;;;GA2BG;AACH,qBAAa,YAAY;IACxB,qDAAqD;IAC9C,cAAc,EAAE,MAAM,CAAC;IAE9B,8CAA8C;IACvC,WAAW,EAAE,MAAM,CAAC;IAE3B,mCAAmC;IAC5B,aAAa,EAAE,MAAM,CAAC;IAE7B,4CAA4C;IACrC,SAAS,EAAE,MAAM,EAAE,CAAC;IAE3B,qCAAqC;IAC9B,cAAc,EAAE;QAAE,GAAG,EAAE,MAAM,CAAC;QAAC,OAAO,EAAE,MAAM,CAAA;KAAE,CAAC;IAExD,iCAAiC;IAC1B,WAAW,EAAE,iBAAiB,CAAC;IAEtC,2EAA2E;IACpE,qBAAqB,EAAE,MAAM,CAAC;IAErC,qEAAqE;IAC9D,wBAAwB,EAAE,MAAM,CAAC;IAExC,gEAAgE;IACzD,qBAAqB,EAAE,MAAM,CAAC;IAErC;;;;;;;;;;;;;;;OAeG;gBACS,OAAO,GAAE,mBAAwB;IAc7C;;;;;OAKG;IACH,OAAO,CAAC,sBAAsB;IAe9B;;;;;OAKG;IACH,OAAO,CAAC,mBAAmB;IAe3B;;;;;OAKG;IACH,OAAO,CAAC,qBAAqB;IAe7B;;;;;OAKG;IACH,OAAO,CAAC,iBAAiB;IAMzB;;;;;OAKG;IACH,OAAO,CAAC,sBAAsB;IAU9B;;;;;OAKG;IACH,OAAO,CAAC,mBAAmB;IAyB3B;;;;;OAKG;IACH,OAAO,CAAC,6BAA6B;IAerC;;;;;OAKG;IACH,OAAO,CAAC,gCAAgC;IAiBxC;;;;;OAKG;IACH,OAAO,CAAC,6BAA6B;IAerC;;;;;;;;;;;;;;OAcG;IACI,MAAM,IAAI,mBAAmB;CAapC"}

package/dist/ServerConfig.js

@@ -0,0 +1,121 @@
+import { homedir } from "node:os";
+import { join } from "node:path";
+import { ConfigurationError } from "./errors.js";
+class ServerConfig {
+    maxHistorySize;
+    maxBranches;
+    maxBranchSize;
+    skillDirs;
+    discoveryCache;
+    persistence;
+    persistenceBufferSize;
+    persistenceFlushInterval;
+    persistenceMaxRetries;
+    constructor(options = {}){
+        this.maxHistorySize = this.validateMaxHistorySize(options.maxHistorySize);
+        this.maxBranches = this.validateMaxBranches(options.maxBranches);
+        this.maxBranchSize = this.validateMaxBranchSize(options.maxBranchSize);
+        this.skillDirs = this.validateSkillDirs(options.skillDirs);
+        this.discoveryCache = this.validateDiscoveryCache(options.discoveryCache);
+        this.persistence = this.validatePersistence(options.persistence);
+        this.persistenceBufferSize = this.validatePersistenceBufferSize(options.persistenceBufferSize);
+        this.persistenceFlushInterval = this.validatePersistenceFlushInterval(options.persistenceFlushInterval);
+        this.persistenceMaxRetries = this.validatePersistenceMaxRetries(options.persistenceMaxRetries);
+    }
+    validateMaxHistorySize(value) {
+        const defaultValue = 1000;
+        if (null == value) return defaultValue;
+        if ('number' != typeof value || !Number.isFinite(value)) throw new ConfigurationError(`maxHistorySize must be a finite number, got ${value}`);
+        if (value < 1) throw new ConfigurationError(`maxHistorySize must be at least 1, got ${value}`);
+        if (value > 10000) throw new ConfigurationError(`maxHistorySize must not exceed 10000, got ${value}`);
+        return value;
+    }
+    validateMaxBranches(value) {
+        const defaultValue = 50;
+        if (null == value) return defaultValue;
+        if ('number' != typeof value || !Number.isFinite(value)) throw new ConfigurationError(`maxBranches must be a finite number, got ${value}`);
+        if (value < 0) throw new ConfigurationError(`maxBranches must be non-negative, got ${value}`);
+        if (value > 1000) throw new ConfigurationError(`maxBranches must not exceed 1000, got ${value}`);
+        return value;
+    }
+    validateMaxBranchSize(value) {
+        const defaultValue = 100;
+        if (null == value) return defaultValue;
+        if ('number' != typeof value || !Number.isFinite(value)) throw new ConfigurationError(`maxBranchSize must be a finite number, got ${value}`);
+        if (value < 1) throw new ConfigurationError(`maxBranchSize must be at least 1, got ${value}`);
+        if (value > 1000) throw new ConfigurationError(`maxBranchSize must not exceed 1000, got ${value}`);
+        return value;
+    }
+    validateSkillDirs(value) {
+        const defaultValue = [
+            '.claude/skills',
+            join(homedir(), '.claude/skills')
+        ];
+        if (!value) return defaultValue;
+        return value;
+    }
+    validateDiscoveryCache(value) {
+        return {
+            ttl: value?.ttl ?? 300000,
+            maxSize: value?.maxSize ?? 100
+        };
+    }
+    validatePersistence(value) {
+        if (!value) return {
+            enabled: false,
+            backend: 'memory'
+        };
+        const validBackends = [
+            'file',
+            'sqlite',
+            'memory'
+        ];
+        const backend = value.backend ?? 'memory';
+        if (!validBackends.includes(backend)) throw new ConfigurationError(`persistence.backend must be one of ${validBackends.join(', ')}, got ${backend}`);
+        return {
+            enabled: value.enabled ?? false,
+            backend,
+            options: value.options ?? {}
+        };
+    }
+    validatePersistenceBufferSize(value) {
+        const defaultValue = 100;
+        if (null == value) return defaultValue;
+        if ('number' != typeof value || !Number.isFinite(value)) throw new ConfigurationError(`persistenceBufferSize must be a finite number, got ${value}`);
+        if (value < 1) throw new ConfigurationError(`persistenceBufferSize must be at least 1, got ${value}`);
+        if (value > 10000) throw new ConfigurationError(`persistenceBufferSize must not exceed 10000, got ${value}`);
+        return value;
+    }
+    validatePersistenceFlushInterval(value) {
+        const defaultValue = 1000;
+        if (null == value) return defaultValue;
+        if ('number' != typeof value || !Number.isFinite(value)) throw new ConfigurationError(`persistenceFlushInterval must be a finite number, got ${value}`);
+        if (value < 100) throw new ConfigurationError(`persistenceFlushInterval must be at least 100, got ${value}`);
+        if (value > 60000) throw new ConfigurationError(`persistenceFlushInterval must not exceed 60000, got ${value}`);
+        return value;
+    }
+    validatePersistenceMaxRetries(value) {
+        const defaultValue = 3;
+        if (null == value) return defaultValue;
+        if ('number' != typeof value || !Number.isFinite(value)) throw new ConfigurationError(`persistenceMaxRetries must be a finite number, got ${value}`);
+        if (value < 0) throw new ConfigurationError(`persistenceMaxRetries must be non-negative, got ${value}`);
+        if (value > 10) throw new ConfigurationError(`persistenceMaxRetries must not exceed 10, got ${value}`);
+        return value;
+    }
+    toJSON() {
+        return {
+            maxHistorySize: this.maxHistorySize,
+            maxBranches: this.maxBranches,
+            maxBranchSize: this.maxBranchSize,
+            skillDirs: this.skillDirs,
+            discoveryCache: this.discoveryCache,
+            persistence: this.persistence,
+            persistenceBufferSize: this.persistenceBufferSize,
+            persistenceFlushInterval: this.persistenceFlushInterval,
+            persistenceMaxRetries: this.persistenceMaxRetries
+        };
+    }
+}
+export { ServerConfig };
+
+//# sourceMappingURL=ServerConfig.js.map

package/dist/ServerConfig.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"ServerConfig.js","sources":["../src/ServerConfig.ts"],"sourcesContent":["/**\n * Server configuration management with validation.\n *\n * This module provides the `ServerConfig` class which handles all server configuration\n * with built-in validation and sensible defaults. Configuration values are validated\n * on construction and warnings are emitted for out-of-range values.\n *\n * @module ServerConfig\n */\n\nimport { homedir } from 'node:os';\nimport { join } from 'node:path';\nimport { ConfigurationError } from './errors.js';\nimport type { PersistenceConfig } from './persistence/PersistenceBackend.js';\n\n/**\n * Configuration options for creating a `ServerConfig` instance.\n *\n * All properties are optional with sensible defaults applied during validation.\n *\n * @example\n * ```typescript\n * const options: ServerConfigOptions = {\n *   maxHistorySize: 500,\n *   maxBranches: 25,\n *   skillDirs: ['./custom-skills'],\n *   persistence: { enabled: true, backend: 'sqlite' }\n * };\n * ```\n */\nexport interface ServerConfigOptions {\n\t/**\n\t * Maximum number of thoughts to keep in history.\n\t * @default 1000\n\t */\n\tmaxHistorySize?: number;\n\n\t/**\n\t * Maximum number of branches to maintain.\n\t * @default 50\n\t */\n\tmaxBranches?: number;\n\n\t/**\n\t * Maximum size of each branch.\n\t * @default 100\n\t */\n\tmaxBranchSize?: number;\n\n\t/**\n\t * Directory paths to search for skills.\n\t * @default ['.claude/skills', '~/.claude/skills']\n\t */\n\tskillDirs?: string[];\n\n\t/**\n\t * Discovery cache configuration.\n\t */\n\tdiscoveryCache?: {\n\t\t/**\n\t\t * Time-to-live for cache entries in milliseconds.\n\t\t * @default 300000 (5 minutes)\n\t\t */\n\t\tttl?: number;\n\t\t/**\n\t\t * Maximum number of entries in the cache.\n\t\t * @default 100\n\t\t */\n\t\tmaxSize?: number;\n\t};\n\n\t/**\n\t * Persistence configuration for storing history and state.\n\t */\n\tpersistence?: PersistenceConfig;\n\n\t/**\n\t * Maximum number of thoughts to buffer before flushing to persistence.\n\t * @default 100\n\t */\n\tpersistenceBufferSize?: number;\n\n\t/**\n\t * Interval in milliseconds between periodic persistence flushes.\n\t * @default 1000\n\t */\n\tpersistenceFlushInterval?: number;\n\n\t/**\n\t * Maximum number of retries for failed persistence flushes.\n\t * @default 3\n\t */\n\tpersistenceMaxRetries?: number;\n}\n\n/**\n * Server configuration with validation and defaults.\n *\n * This class manages all server configuration including history limits,\n * branch limits, skill directories, discovery cache settings, and persistence.\n * All values are validated on construction with appropriate defaults applied.\n *\n * @remarks\n * - Values outside recommended ranges trigger warnings but are still applied\n * - Environment variables override file-based configuration\n * - The `toJSON()` method provides a plain object representation\n *\n * @example\n * ```typescript\n * // Using defaults\n * const config1 = new ServerConfig();\n * console.log(config1.maxHistorySize); // 1000\n *\n * // With custom options\n * const config2 = new ServerConfig({\n *   maxHistorySize: 500,\n *   persistence: { enabled: true, backend: 'file', options: { dataDir: './data' } }\n * });\n *\n * // Export as plain object\n * const json = config2.toJSON();\n * ```\n */\nexport class ServerConfig {\n\t/** Maximum number of thoughts to keep in history. */\n\tpublic maxHistorySize: number;\n\n\t/** Maximum number of branches to maintain. */\n\tpublic maxBranches: number;\n\n\t/** Maximum size of each branch. */\n\tpublic maxBranchSize: number;\n\n\t/** Directory paths to search for skills. */\n\tpublic skillDirs: string[];\n\n\t/** Discovery cache configuration. */\n\tpublic discoveryCache: { ttl: number; maxSize: number };\n\n\t/** Persistence configuration. */\n\tpublic persistence: PersistenceConfig;\n\n\t/** Maximum number of thoughts to buffer before flushing to persistence. */\n\tpublic persistenceBufferSize: number;\n\n\t/** Interval in milliseconds between periodic persistence flushes. */\n\tpublic persistenceFlushInterval: number;\n\n\t/** Maximum number of retries for failed persistence flushes. */\n\tpublic persistenceMaxRetries: number;\n\n\t/**\n\t * Creates a new ServerConfig instance with validation.\n\t *\n\t * All values are validated and defaults are applied for undefined options.\n\t * Warnings are emitted to console for values outside recommended ranges.\n\t *\n\t * @param options - Optional configuration overrides\n\t *\n\t * @example\n\t * ```typescript\n\t * const config = new ServerConfig({\n\t *   maxHistorySize: 500,\n\t *   skillDirs: ['./my-skills']\n\t * });\n\t * ```\n\t */\n\tconstructor(options: ServerConfigOptions = {}) {\n\t\tthis.maxHistorySize = this.validateMaxHistorySize(options.maxHistorySize);\n\t\tthis.maxBranches = this.validateMaxBranches(options.maxBranches);\n\t\tthis.maxBranchSize = this.validateMaxBranchSize(options.maxBranchSize);\n\t\tthis.skillDirs = this.validateSkillDirs(options.skillDirs);\n\t\tthis.discoveryCache = this.validateDiscoveryCache(options.discoveryCache);\n\t\tthis.persistence = this.validatePersistence(options.persistence);\n\t\tthis.persistenceBufferSize = this.validatePersistenceBufferSize(options.persistenceBufferSize);\n\t\tthis.persistenceFlushInterval = this.validatePersistenceFlushInterval(\n\t\t\toptions.persistenceFlushInterval\n\t\t);\n\t\tthis.persistenceMaxRetries = this.validatePersistenceMaxRetries(options.persistenceMaxRetries);\n\t}\n\n\t/**\n\t * Validates the max history size value.\n\t * @param value - The value to validate\n\t * @returns The validated value or default (1000)\n\t * @private\n\t */\n\tprivate validateMaxHistorySize(value?: number): number {\n\t\tconst defaultValue = 1000;\n\t\tif (value === undefined || value === null) return defaultValue;\n\t\tif (typeof value !== 'number' || !Number.isFinite(value)) {\n\t\t\tthrow new ConfigurationError(`maxHistorySize must be a finite number, got ${value}`);\n\t\t}\n\t\tif (value < 1) {\n\t\t\tthrow new ConfigurationError(`maxHistorySize must be at least 1, got ${value}`);\n\t\t}\n\t\tif (value > 10000) {\n\t\t\tthrow new ConfigurationError(`maxHistorySize must not exceed 10000, got ${value}`);\n\t\t}\n\t\treturn value;\n\t}\n\n\t/**\n\t * Validates the max branches value.\n\t * @param value - The value to validate\n\t * @returns The validated value or default (50)\n\t * @private\n\t */\n\tprivate validateMaxBranches(value?: number): number {\n\t\tconst defaultValue = 50;\n\t\tif (value === undefined || value === null) return defaultValue;\n\t\tif (typeof value !== 'number' || !Number.isFinite(value)) {\n\t\t\tthrow new ConfigurationError(`maxBranches must be a finite number, got ${value}`);\n\t\t}\n\t\tif (value < 0) {\n\t\t\tthrow new ConfigurationError(`maxBranches must be non-negative, got ${value}`);\n\t\t}\n\t\tif (value > 1000) {\n\t\t\tthrow new ConfigurationError(`maxBranches must not exceed 1000, got ${value}`);\n\t\t}\n\t\treturn value;\n\t}\n\n\t/**\n\t * Validates the max branch size value.\n\t * @param value - The value to validate\n\t * @returns The validated value or default (100)\n\t * @private\n\t */\n\tprivate validateMaxBranchSize(value?: number): number {\n\t\tconst defaultValue = 100;\n\t\tif (value === undefined || value === null) return defaultValue;\n\t\tif (typeof value !== 'number' || !Number.isFinite(value)) {\n\t\t\tthrow new ConfigurationError(`maxBranchSize must be a finite number, got ${value}`);\n\t\t}\n\t\tif (value < 1) {\n\t\t\tthrow new ConfigurationError(`maxBranchSize must be at least 1, got ${value}`);\n\t\t}\n\t\tif (value > 1000) {\n\t\t\tthrow new ConfigurationError(`maxBranchSize must not exceed 1000, got ${value}`);\n\t\t}\n\t\treturn value;\n\t}\n\n\t/**\n\t * Validates the skill directories value.\n\t * @param value - The value to validate\n\t * @returns The validated value or default ['.claude/skills', '~/.claude/skills']\n\t * @private\n\t */\n\tprivate validateSkillDirs(value?: string[]): string[] {\n\t\tconst defaultValue = ['.claude/skills', join(homedir(), '.claude/skills')];\n\t\tif (!value) return defaultValue;\n\t\treturn value;\n\t}\n\n\t/**\n\t * Validates the discovery cache configuration.\n\t * @param value - The value to validate\n\t * @returns The validated value with defaults applied\n\t * @private\n\t */\n\tprivate validateDiscoveryCache(value?: { ttl?: number; maxSize?: number }): {\n\t\tttl: number;\n\t\tmaxSize: number;\n\t} {\n\t\treturn {\n\t\t\tttl: value?.ttl ?? 300000,\n\t\t\tmaxSize: value?.maxSize ?? 100,\n\t\t};\n\t}\n\n\t/**\n\t * Validates the persistence configuration.\n\t * @param value - The value to validate\n\t * @returns The validated value with defaults applied\n\t * @private\n\t */\n\tprivate validatePersistence(value?: PersistenceConfig): PersistenceConfig {\n\t\tif (!value) {\n\t\t\t// Default to in-memory (no actual persistence, just consistency)\n\t\t\treturn {\n\t\t\t\tenabled: false,\n\t\t\t\tbackend: 'memory',\n\t\t\t};\n\t\t}\n\n\t\t// Validate backend type\n\t\tconst validBackends = ['file', 'sqlite', 'memory'];\n\t\tconst backend = value.backend ?? 'memory';\n\t\tif (!validBackends.includes(backend)) {\n\t\t\tthrow new ConfigurationError(\n\t\t\t\t`persistence.backend must be one of ${validBackends.join(', ')}, got ${backend}`\n\t\t\t);\n\t\t}\n\n\t\treturn {\n\t\t\tenabled: value.enabled ?? false,\n\t\t\tbackend,\n\t\t\toptions: value.options ?? {},\n\t\t};\n\t}\n\n\t/**\n\t * Validates the persistence buffer size value.\n\t * @param value - The value to validate\n\t * @returns The validated value or default (100)\n\t * @private\n\t */\n\tprivate validatePersistenceBufferSize(value?: number): number {\n\t\tconst defaultValue = 100;\n\t\tif (value === undefined || value === null) return defaultValue;\n\t\tif (typeof value !== 'number' || !Number.isFinite(value)) {\n\t\t\tthrow new ConfigurationError(`persistenceBufferSize must be a finite number, got ${value}`);\n\t\t}\n\t\tif (value < 1) {\n\t\t\tthrow new ConfigurationError(`persistenceBufferSize must be at least 1, got ${value}`);\n\t\t}\n\t\tif (value > 10000) {\n\t\t\tthrow new ConfigurationError(`persistenceBufferSize must not exceed 10000, got ${value}`);\n\t\t}\n\t\treturn value;\n\t}\n\n\t/**\n\t * Validates the persistence flush interval value.\n\t * @param value - The value to validate\n\t * @returns The validated value or default (1000)\n\t * @private\n\t */\n\tprivate validatePersistenceFlushInterval(value?: number): number {\n\t\tconst defaultValue = 1000;\n\t\tif (value === undefined || value === null) return defaultValue;\n\t\tif (typeof value !== 'number' || !Number.isFinite(value)) {\n\t\t\tthrow new ConfigurationError(\n\t\t\t\t`persistenceFlushInterval must be a finite number, got ${value}`\n\t\t\t);\n\t\t}\n\t\tif (value < 100) {\n\t\t\tthrow new ConfigurationError(`persistenceFlushInterval must be at least 100, got ${value}`);\n\t\t}\n\t\tif (value > 60000) {\n\t\t\tthrow new ConfigurationError(`persistenceFlushInterval must not exceed 60000, got ${value}`);\n\t\t}\n\t\treturn value;\n\t}\n\n\t/**\n\t * Validates the persistence max retries value.\n\t * @param value - The value to validate\n\t * @returns The validated value or default (3)\n\t * @private\n\t */\n\tprivate validatePersistenceMaxRetries(value?: number): number {\n\t\tconst defaultValue = 3;\n\t\tif (value === undefined || value === null) return defaultValue;\n\t\tif (typeof value !== 'number' || !Number.isFinite(value)) {\n\t\t\tthrow new ConfigurationError(`persistenceMaxRetries must be a finite number, got ${value}`);\n\t\t}\n\t\tif (value < 0) {\n\t\t\tthrow new ConfigurationError(`persistenceMaxRetries must be non-negative, got ${value}`);\n\t\t}\n\t\tif (value > 10) {\n\t\t\tthrow new ConfigurationError(`persistenceMaxRetries must not exceed 10, got ${value}`);\n\t\t}\n\t\treturn value;\n\t}\n\n\t/**\n\t * Converts the configuration to a plain object.\n\t *\n\t * Useful for serialization, logging, or when a plain object representation\n\t * is preferred over the ServerConfig instance.\n\t *\n\t * @returns A plain object representation of the configuration\n\t *\n\t * @example\n\t * ```typescript\n\t * const config = new ServerConfig({ maxHistorySize: 500 });\n\t * const json = config.toJSON();\n\t * console.log(JSON.stringify(json, null, 2));\n\t * ```\n\t */\n\tpublic toJSON(): ServerConfigOptions {\n\t\treturn {\n\t\t\tmaxHistorySize: this.maxHistorySize,\n\t\t\tmaxBranches: this.maxBranches,\n\t\t\tmaxBranchSize: this.maxBranchSize,\n\t\t\tskillDirs: this.skillDirs,\n\t\t\tdiscoveryCache: this.discoveryCache,\n\t\t\tpersistence: this.persistence,\n\t\t\tpersistenceBufferSize: this.persistenceBufferSize,\n\t\t\tpersistenceFlushInterval: this.persistenceFlushInterval,\n\t\t\tpersistenceMaxRetries: this.persistenceMaxRetries,\n\t\t};\n\t}\n}\n"],"names":["ServerConfig","options","value","defaultValue","Number","ConfigurationError","join","homedir","validBackends","backend"],"mappings":"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"}

package/dist/__tests__/base-registry.test.d.ts

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=base-registry.test.d.ts.map

package/dist/__tests__/base-registry.test.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"base-registry.test.d.ts","sourceRoot":"","sources":["../../src/__tests__/base-registry.test.ts"],"names":[],"mappings":""}

package/dist/__tests__/base-transport-cov.test.d.ts

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=base-transport-cov.test.d.ts.map

package/dist/__tests__/base-transport-cov.test.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"base-transport-cov.test.d.ts","sourceRoot":"","sources":["../../src/__tests__/base-transport-cov.test.ts"],"names":[],"mappings":""}

package/dist/__tests__/base-transport.test.d.ts

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=base-transport.test.d.ts.map

package/dist/__tests__/base-transport.test.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"base-transport.test.d.ts","sourceRoot":"","sources":["../../src/__tests__/base-transport.test.ts"],"names":[],"mappings":""}

package/dist/__tests__/config-loader.test.d.ts

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=config-loader.test.d.ts.map

package/dist/__tests__/config-loader.test.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"config-loader.test.d.ts","sourceRoot":"","sources":["../../src/__tests__/config-loader.test.ts"],"names":[],"mappings":""}

package/dist/__tests__/connection-pool-cov.test.d.ts

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=connection-pool-cov.test.d.ts.map

package/dist/__tests__/connection-pool-cov.test.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"connection-pool-cov.test.d.ts","sourceRoot":"","sources":["../../src/__tests__/connection-pool-cov.test.ts"],"names":[],"mappings":""}

package/dist/__tests__/connection-pool.test.d.ts

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=connection-pool.test.d.ts.map

package/dist/__tests__/connection-pool.test.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"connection-pool.test.d.ts","sourceRoot":"","sources":["../../src/__tests__/connection-pool.test.ts"],"names":[],"mappings":""}

package/dist/__tests__/container.test.d.ts

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=container.test.d.ts.map

package/dist/__tests__/container.test.d.ts.map

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

package/dist/__tests__/crud.test.d.ts

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=crud.test.d.ts.map

package/dist/__tests__/crud.test.d.ts.map

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

package/dist/__tests__/discovery-cache.test.d.ts

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=discovery-cache.test.d.ts.map

package/dist/__tests__/discovery-cache.test.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"discovery-cache.test.d.ts","sourceRoot":"","sources":["../../src/__tests__/discovery-cache.test.ts"],"names":[],"mappings":""}

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

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=errors.test.d.ts.map

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

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

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

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=factories.test.d.ts.map

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

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

package/dist/__tests__/health-checker-cov.test.d.ts

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=health-checker-cov.test.d.ts.map

package/dist/__tests__/health-checker-cov.test.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"health-checker-cov.test.d.ts","sourceRoot":"","sources":["../../src/__tests__/health-checker-cov.test.ts"],"names":[],"mappings":""}

package/dist/__tests__/health-checker.test.d.ts

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=health-checker.test.d.ts.map

package/dist/__tests__/health-checker.test.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"health-checker.test.d.ts","sourceRoot":"","sources":["../../src/__tests__/health-checker.test.ts"],"names":[],"mappings":""}