mcp-taskflow 0.1.0

package/dist/prompts/templates/v1/templates_en/toolsDescription/splitTasks.md

@@ -0,0 +1,83 @@
+Break down complex tasks into independent subtasks, establishing dependencies and priorities.
+
+## 1. **Granularity Control (Required Reading)**
+
+- ### **Minimum Viable Task**
+
+  Each subtask should be completable and verifiable by a single developer within **1–2 working days** (approximately 8–16 hours).
+
+- ### **Maximum Complexity Limitation**
+
+  A single subtask should not span multiple technical domains such as **frontend**, **backend**, and **database**.  
+  If cross-domain work is required, split it into multiple subtasks.
+
+- ### **Recommended Number of Tasks**
+
+  Avoid splitting into more than **10 subtasks** at once.  
+  If more are needed, submit them in prioritized batches (6–8 tasks per batch).
+
+- ### **Recommended Task Length**
+
+  Each split should not exceed **5,000 characters**.  
+  If it does, divide and submit in multiple batches.
+
+- ### **Depth Limitation**
+  The task tree should not exceed **3 levels**:
+  - **Level 1**: Functional Modules
+  - **Level 2**: Main Processes
+  - **Level 3**: Key Steps
+
+## 2. **Task Splitting Example**
+
+- Identify **core functionality points**, and create a subtask for each.
+- Annotate each subtask with:
+  - **Input/Output**
+  - **Acceptance Criteria**
+- If needed, provide **pseudocode**:
+  - Only outline high-level logic and key steps.
+  - Avoid providing complete source code.
+- Check **dependencies** between subtasks and specify them in the `dependencies` field.
+- If the task involves interface design, always provide a complete and consistent definition, including:
+
+  - Function/class/schema definitions (including names, parameters, return values)
+  - Data types, usage descriptions, and optional/required status for each item
+  - Error handling methods and expected exception scenarios
+  - Dependency and naming conventions (if any)
+  - Sample data and usage examples
+
+  This ensures consistency, readability, and development precision between tasks.
+
+## 3. **Dependencies and Prioritization**
+
+- Mark each subtask with its `dependencies` list.
+- Automatically compute and enforce execution order based on the dependency graph to prioritize the **critical path**.
+
+## 4. **Update Mode Explanation (`updateMode`)**
+
+When you need to create a new task that is not related to the current task list, be sure to use `clearAllTasks` to avoid task confusion.
+
+- `append`: Keep existing unfinished tasks and add new ones.
+- `overwrite`: Delete all unfinished tasks, keep completed ones.
+- `selective`: Smart-match and update tasks by name.
+- `clearAllTasks`: Clear all tasks and automatically back up the current list.
+
+---
+
+## 5. **Strict JSON Rules**
+
+- ### **No Comments Allowed**
+
+  JSON does not support comments.  
+  Any use of `#` or `//` will cause parsing failures.
+
+- ### **Proper Escaping Required**
+  All special characters (e.g., double quotes `\"`, backslashes `\\`) must be properly escaped,  
+  or they will be considered invalid.
+
+## 6. **Important Notes**
+
+These tasks will be executed by low-intelligence models, so please follow the guidelines below:
+
+- `Clear and Explicit Instructions`: This prevents the model from producing incorrect or inconsistent architecture/code styles. Provide clear commands or specifications.
+- `Encapsulated Interfaces`: Each task runs independently. Define the interfaces clearly — such as function names, parameters, return values — so that other task-executing models can easily understand how to interact with or integrate these functions.
+- `Dependencies`: If there are dependencies between tasks, define the interaction interfaces first. Tasks do not need to know each other's implementation, but must know how to interact with one another.

package/dist/prompts/templates/v1/templates_en/toolsDescription/updateTask.md

@@ -0,0 +1 @@
+Update task content, including name, description and notes, dependent tasks, related files, implementation guide, and verification criteria, completed tasks only allow updating summary and related files

package/dist/prompts/templates/v1/templates_en/toolsDescription/verifyTask.md

@@ -0,0 +1,37 @@
+## Verify Task
+
+Please comprehensively check and score according to the requirements in verificationCriteria,
+If you are missing or have forgotten the verificationCriteria content, please use `get_task_detail` to obtain it.
+
+Please score according to the following rules:
+
+### Verification Standards
+
+1. **Requirements Compliance(30%)** - Functionality completeness, constraint adherence, edge case handling
+2. **Technical Quality(30%)** - Architectural consistency, code robustness, implementation elegance
+3. **Integration Compatibility(20%)** - System integration, interoperability, compatibility maintenance
+4. **Performance Scalability(20%)** - Performance optimization, load adaptability, resource management
+
+### score Parameter Guidelines
+
+Provide overall score and rating, assessment of each standard, issues and suggestions, and final conclusion.
+
+**Must use the following format to provide scoring results (for system parsing):**
+
+```Scoring
+score: [number from 0-100]
+```
+
+### summary Parameter Guidelines
+
+If the score is equal to or greater than 80 points, please provide a task summary
+
+```
+summary: 'Task completion summary, concise description of implementation results and important decisions'
+```
+
+If the score is less than 80 points, please provide correction suggestions
+
+```
+summary: 'List task issues and correction suggestions'
+```

package/dist/prompts/templates/v1/templates_en/updateTaskContent/emptyUpdate.md

@@ -0,0 +1,5 @@
+# Task Update Result
+
+## Operation Failed
+
+At least one field needs to be updated (name, description, notes, or related files)

package/dist/prompts/templates/v1/templates_en/updateTaskContent/fileDetails.md

@@ -0,0 +1 @@
+- **Related Files:** {fileType} ({fileCount}): {filesList}

package/dist/prompts/templates/v1/templates_en/updateTaskContent/index.md

@@ -0,0 +1,7 @@
+# Task Updated Successfully
+
+Task **{{taskName}}** (ID: `{{taskId}}`) has been updated.
+
+{{successDetails}}
+
+{{relatedFilesContent}}

package/dist/prompts/templates/v1/templates_en/updateTaskContent/notFound.md

@@ -0,0 +1,5 @@
+# Task Update Result
+
+## System Error
+
+Task with ID `{taskId}` not found. Please use the "list_tasks" tool to confirm valid task IDs and try again.

package/dist/prompts/templates/v1/templates_en/updateTaskContent/success.md

@@ -0,0 +1,9 @@
+### Updated Task Details
+
+- **Name:** {taskName}
+- **Description:** {taskDescription}
+  {taskNotes}
+- **Status:** {taskStatus}
+- **Update Time:** {taskUpdatedAt}
+
+{filesContent}

package/dist/prompts/templates/v1/templates_en/updateTaskContent/successDetails.md

@@ -0,0 +1,3 @@
+### Updated Fields
+
+{{fields}}

package/dist/prompts/templates/v1/templates_en/updateTaskContent/validation.md

@@ -0,0 +1,5 @@
+# Task Update Result
+
+## Operation Failed
+
+{error}

package/dist/prompts/templates/v1/templates_en/verifyTask/index.md

@@ -0,0 +1,19 @@
+**Please strictly follow the guidelines below**
+
+## Task Completion Confirmation
+
+Task "{{taskName}}" (ID: `{{taskId}}`) has been successfully marked as completed.
+
+**Task Summary:** {{taskSummary}}
+
+## Task Summary Requirements
+
+Please provide a summary of this completed task, including the following key points:
+
+1. Task objectives and main accomplishments
+2. Key points of the implemented solution
+3. Major challenges encountered and solutions
+
+**Important Note:**
+Please provide the task summary in the current response. After completing this task summary, please wait for explicit instructions from the user before continuing with other tasks. Do not automatically start executing the next task.
+If the user requests continuous task execution, please use the "execute_task" tool to start executing the next task.

package/dist/prompts/templates/v1/templates_en/verifyTask/noPass.md

@@ -0,0 +1,12 @@
+**Please strictly follow the guidelines below**
+
+## Verification Failed
+
+Task "{name}" (ID: `{id}`) verification failed
+
+### Correction Suggestions
+
+{summary}
+
+**Important Note:**
+Please attempt to fix the issues and call `verify_task` again to re-verify the task

package/dist/prompts/thoughtPromptBuilder.d.ts

@@ -0,0 +1,11 @@
+/**
+ * Prompt builder for structured thinking tool (process_thought).
+ * Supports metacognitive reasoning and chain-of-thought processing.
+ *
+ * @module prompts/thoughtPromptBuilder
+ */
+export declare class ProcessThoughtPromptBuilder {
+    build(thought: string, thoughtNumber: number, totalThoughts: number, stage: string, nextThoughtNeeded: boolean, tags?: string[], axiomsUsed?: string[], assumptionsChallenged?: string[]): Promise<string>;
+    private formatList;
+}
+//# sourceMappingURL=thoughtPromptBuilder.d.ts.map

package/dist/prompts/thoughtPromptBuilder.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"thoughtPromptBuilder.d.ts","sourceRoot":"","sources":["../../src/prompts/thoughtPromptBuilder.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAKH,qBAAa,2BAA2B;IAChC,KAAK,CACT,OAAO,EAAE,MAAM,EACf,aAAa,EAAE,MAAM,EACrB,aAAa,EAAE,MAAM,EACrB,KAAK,EAAE,MAAM,EACb,iBAAiB,EAAE,OAAO,EAC1B,IAAI,CAAC,EAAE,MAAM,EAAE,EACf,UAAU,CAAC,EAAE,MAAM,EAAE,EACrB,qBAAqB,CAAC,EAAE,MAAM,EAAE,GAC/B,OAAO,CAAC,MAAM,CAAC;IAelB,OAAO,CAAC,UAAU;CAMnB"}

package/dist/prompts/thoughtPromptBuilder.js

@@ -0,0 +1,30 @@
+/**
+ * Prompt builder for structured thinking tool (process_thought).
+ * Supports metacognitive reasoning and chain-of-thought processing.
+ *
+ * @module prompts/thoughtPromptBuilder
+ */
+import { loadTemplate } from './templateLoader.js';
+import { render } from './templateEngine.js';
+export class ProcessThoughtPromptBuilder {
+    async build(thought, thoughtNumber, totalThoughts, stage, nextThoughtNeeded, tags, axiomsUsed, assumptionsChallenged) {
+        const template = await loadTemplate('processThought/index.md');
+        return render(template, {
+            thought,
+            thoughtNumber,
+            totalThoughts,
+            stage,
+            nextThoughtNeeded: nextThoughtNeeded ? 'yes' : 'no',
+            tags: tags ? tags.join(', ') : 'none',
+            axioms: axiomsUsed ? this.formatList(axiomsUsed) : 'none',
+            assumptions: assumptionsChallenged ? this.formatList(assumptionsChallenged) : 'none'
+        });
+    }
+    formatList(items) {
+        if (items.length === 0) {
+            return 'none';
+        }
+        return items.map((item, index) => `${index + 1}. ${item}`).join('\n');
+    }
+}
+//# sourceMappingURL=thoughtPromptBuilder.js.map

package/dist/prompts/thoughtPromptBuilder.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"thoughtPromptBuilder.js","sourceRoot":"","sources":["../../src/prompts/thoughtPromptBuilder.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH,OAAO,EAAE,YAAY,EAAE,MAAM,qBAAqB,CAAC;AACnD,OAAO,EAAE,MAAM,EAAE,MAAM,qBAAqB,CAAC;AAE7C,MAAM,OAAO,2BAA2B;IACtC,KAAK,CAAC,KAAK,CACT,OAAe,EACf,aAAqB,EACrB,aAAqB,EACrB,KAAa,EACb,iBAA0B,EAC1B,IAAe,EACf,UAAqB,EACrB,qBAAgC;QAEhC,MAAM,QAAQ,GAAG,MAAM,YAAY,CAAC,yBAAyB,CAAC,CAAC;QAE/D,OAAO,MAAM,CAAC,QAAQ,EAAE;YACtB,OAAO;YACP,aAAa;YACb,aAAa;YACb,KAAK;YACL,iBAAiB,EAAE,iBAAiB,CAAC,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC,IAAI;YACnD,IAAI,EAAE,IAAI,CAAC,CAAC,CAAC,IAAI,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC,MAAM;YACrC,MAAM,EAAE,UAAU,CAAC,CAAC,CAAC,IAAI,CAAC,UAAU,CAAC,UAAU,CAAC,CAAC,CAAC,CAAC,MAAM;YACzD,WAAW,EAAE,qBAAqB,CAAC,CAAC,CAAC,IAAI,CAAC,UAAU,CAAC,qBAAqB,CAAC,CAAC,CAAC,CAAC,MAAM;SACrF,CAAC,CAAC;IACL,CAAC;IAEO,UAAU,CAAC,KAAe;QAChC,IAAI,KAAK,CAAC,MAAM,KAAK,CAAC,EAAE,CAAC;YACvB,OAAO,MAAM,CAAC;QAChB,CAAC;QACD,OAAO,KAAK,CAAC,GAAG,CAAC,CAAC,IAAI,EAAE,KAAK,EAAE,EAAE,CAAC,GAAG,KAAK,GAAG,CAAC,KAAK,IAAI,EAAE,CAAC,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;IACxE,CAAC;CACF"}

package/dist/server/container.d.ts

@@ -0,0 +1,111 @@
+/**
+ * Dependency Injection Container
+ *
+ * Manual dependency injection implementation for the MCP server.
+ * All services are singletons - created once per container.
+ */
+import type { Logger } from 'pino';
+import { TaskStore } from '../data/taskStore.js';
+import { MemoryStore } from '../data/memoryStore.js';
+import { RulesStore } from '../data/rulesStore.js';
+import { TaskSearchService } from '../data/taskSearchService.js';
+/**
+ * Service container holding all application services
+ *
+ * All services are singletons - created once and reused
+ */
+export interface ServiceContainer {
+    readonly logger: Logger;
+    readonly taskStore: TaskStore;
+    readonly memoryStore: MemoryStore;
+    readonly rulesStore: RulesStore;
+    readonly taskSearchService: TaskSearchService;
+}
+/**
+ * Container options for configuration
+ */
+export interface ContainerOptions {
+    /**
+     * Data directory for persistence (optional override for testing)
+     */
+    readonly dataDir?: string;
+    /**
+     * Logger instance (optional override for testing)
+     */
+    readonly logger?: Logger;
+}
+/**
+ * Create and configure the service container
+ *
+ * This is the "Composition Root" - the single place where all
+ * dependencies are wired together.
+ *
+ * @param options - Container configuration options
+ * @returns Configured service container with all singleton services
+ *
+ * @example
+ * ```typescript
+ * // Production usage
+ * const container = createContainer();
+ * const server = createMcpServer(container);
+ *
+ * // Test usage with overrides
+ * const container = createContainer({
+ *   dataDir: '/tmp/test-data',
+ *   logger: testLogger
+ * });
+ * ```
+ */
+export declare function createContainer(options?: ContainerOptions): ServiceContainer;
+/**
+ * Initialize the global container
+ *
+ * Should be called once at application startup.
+ *
+ * @param options - Container configuration options
+ * @returns The initialized global container
+ * @throws Error if already initialized
+ *
+ * @example
+ * ```typescript
+ * // In main entry point
+ * const container = initializeGlobalContainer();
+ * const server = createMcpServer(container);
+ * ```
+ */
+export declare function initializeGlobalContainer(options?: ContainerOptions): ServiceContainer;
+/**
+ * Get the global container instance
+ *
+ * @returns The global container
+ * @throws Error if not initialized
+ *
+ * @example
+ * ```typescript
+ * const container = getGlobalContainer();
+ * const tasks = await container.taskStore.getAllAsync();
+ * ```
+ */
+export declare function getGlobalContainer(): ServiceContainer;
+/**
+ * Reset the global container (for testing)
+ *
+ * This allows tests to create fresh containers without
+ * shared state between test runs.
+ *
+ * @example
+ * ```typescript
+ * // In test teardown
+ * afterEach(() => {
+ *   resetGlobalContainer();
+ * });
+ * ```
+ */
+export declare function resetGlobalContainer(): void;
+/**
+ * Check if global container is initialized
+ *
+ * @returns True if initialized, false otherwise
+ */
+export declare function hasGlobalContainer(): boolean;
+//# sourceMappingURL=container.d.ts.map

package/dist/server/container.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"container.d.ts","sourceRoot":"","sources":["../../src/server/container.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH,OAAO,KAAK,EAAE,MAAM,EAAE,MAAM,MAAM,CAAC;AAEnC,OAAO,EAAE,SAAS,EAAE,MAAM,sBAAsB,CAAC;AACjD,OAAO,EAAE,WAAW,EAAE,MAAM,wBAAwB,CAAC;AACrD,OAAO,EAAE,UAAU,EAAE,MAAM,uBAAuB,CAAC;AACnD,OAAO,EAAE,iBAAiB,EAAE,MAAM,8BAA8B,CAAC;AAEjE;;;;GAIG;AACH,MAAM,WAAW,gBAAgB;IAC/B,QAAQ,CAAC,MAAM,EAAE,MAAM,CAAC;IACxB,QAAQ,CAAC,SAAS,EAAE,SAAS,CAAC;IAC9B,QAAQ,CAAC,WAAW,EAAE,WAAW,CAAC;IAClC,QAAQ,CAAC,UAAU,EAAE,UAAU,CAAC;IAChC,QAAQ,CAAC,iBAAiB,EAAE,iBAAiB,CAAC;CAC/C;AAED;;GAEG;AACH,MAAM,WAAW,gBAAgB;IAC/B;;OAEG;IACH,QAAQ,CAAC,OAAO,CAAC,EAAE,MAAM,CAAC;IAE1B;;OAEG;IACH,QAAQ,CAAC,MAAM,CAAC,EAAE,MAAM,CAAC;CAC1B;AAED;;;;;;;;;;;;;;;;;;;;;GAqBG;AACH,wBAAgB,eAAe,CAC7B,OAAO,GAAE,gBAAqB,GAC7B,gBAAgB,CAsBlB;AAkBD;;;;;;;;;;;;;;;GAeG;AACH,wBAAgB,yBAAyB,CACvC,OAAO,GAAE,gBAAqB,GAC7B,gBAAgB,CASlB;AAED;;;;;;;;;;;GAWG;AACH,wBAAgB,kBAAkB,IAAI,gBAAgB,CAQrD;AAED;;;;;;;;;;;;;GAaG;AACH,wBAAgB,oBAAoB,IAAI,IAAI,CAE3C;AAED;;;;GAIG;AACH,wBAAgB,kBAAkB,IAAI,OAAO,CAE5C"}

package/dist/server/container.js

@@ -0,0 +1,135 @@
+/**
+ * Dependency Injection Container
+ *
+ * Manual dependency injection implementation for the MCP server.
+ * All services are singletons - created once per container.
+ */
+import { getLogger } from './logger.js';
+import { TaskStore } from '../data/taskStore.js';
+import { MemoryStore } from '../data/memoryStore.js';
+import { RulesStore } from '../data/rulesStore.js';
+import { TaskSearchService } from '../data/taskSearchService.js';
+/**
+ * Create and configure the service container
+ *
+ * This is the "Composition Root" - the single place where all
+ * dependencies are wired together.
+ *
+ * @param options - Container configuration options
+ * @returns Configured service container with all singleton services
+ *
+ * @example
+ * ```typescript
+ * // Production usage
+ * const container = createContainer();
+ * const server = createMcpServer(container);
+ *
+ * // Test usage with overrides
+ * const container = createContainer({
+ *   dataDir: '/tmp/test-data',
+ *   logger: testLogger
+ * });
+ * ```
+ */
+export function createContainer(options = {}) {
+    const { dataDir, logger = getLogger() } = options;
+    // Create data layer services
+    // All accept optional dataDir for test isolation
+    const taskStore = new TaskStore(dataDir);
+    const memoryStore = new MemoryStore(dataDir);
+    const rulesStore = new RulesStore(dataDir);
+    // Create service layer services
+    // TaskSearchService is stateless - no dependencies needed
+    const taskSearchService = new TaskSearchService();
+    // Return immutable container
+    // Services are created once and reused (singleton lifetime)
+    return Object.freeze({
+        logger,
+        taskStore,
+        memoryStore,
+        rulesStore,
+        taskSearchService,
+    });
+}
+/**
+ * Global container instance (optional)
+ *
+ * While we support a global instance for convenience,
+ * prefer explicit dependency passing in production code.
+ *
+ * Use this only for:
+ * - Simple scripts
+ * - Top-level initialization
+ *
+ * Don't use this for:
+ * - Service implementations (use constructor injection)
+ * - Deep in the call stack (prefer explicit passing)
+ */
+let globalContainer = null;
+/**
+ * Initialize the global container
+ *
+ * Should be called once at application startup.
+ *
+ * @param options - Container configuration options
+ * @returns The initialized global container
+ * @throws Error if already initialized
+ *
+ * @example
+ * ```typescript
+ * // In main entry point
+ * const container = initializeGlobalContainer();
+ * const server = createMcpServer(container);
+ * ```
+ */
+export function initializeGlobalContainer(options = {}) {
+    if (globalContainer !== null) {
+        throw new Error('Global container already initialized. Call resetGlobalContainer() first if reinitializing.');
+    }
+    globalContainer = createContainer(options);
+    return globalContainer;
+}
+/**
+ * Get the global container instance
+ *
+ * @returns The global container
+ * @throws Error if not initialized
+ *
+ * @example
+ * ```typescript
+ * const container = getGlobalContainer();
+ * const tasks = await container.taskStore.getAllAsync();
+ * ```
+ */
+export function getGlobalContainer() {
+    if (globalContainer === null) {
+        throw new Error('Global container not initialized. Call initializeGlobalContainer() first.');
+    }
+    return globalContainer;
+}
+/**
+ * Reset the global container (for testing)
+ *
+ * This allows tests to create fresh containers without
+ * shared state between test runs.
+ *
+ * @example
+ * ```typescript
+ * // In test teardown
+ * afterEach(() => {
+ *   resetGlobalContainer();
+ * });
+ * ```
+ */
+export function resetGlobalContainer() {
+    globalContainer = null;
+}
+/**
+ * Check if global container is initialized
+ *
+ * @returns True if initialized, false otherwise
+ */
+export function hasGlobalContainer() {
+    return globalContainer !== null;
+}
+//# sourceMappingURL=container.js.map

package/dist/server/container.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"container.js","sourceRoot":"","sources":["../../src/server/container.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAGH,OAAO,EAAE,SAAS,EAAE,MAAM,aAAa,CAAC;AACxC,OAAO,EAAE,SAAS,EAAE,MAAM,sBAAsB,CAAC;AACjD,OAAO,EAAE,WAAW,EAAE,MAAM,wBAAwB,CAAC;AACrD,OAAO,EAAE,UAAU,EAAE,MAAM,uBAAuB,CAAC;AACnD,OAAO,EAAE,iBAAiB,EAAE,MAAM,8BAA8B,CAAC;AA8BjE;;;;;;;;;;;;;;;;;;;;;GAqBG;AACH,MAAM,UAAU,eAAe,CAC7B,UAA4B,EAAE;IAE9B,MAAM,EAAE,OAAO,EAAE,MAAM,GAAG,SAAS,EAAE,EAAE,GAAG,OAAO,CAAC;IAElD,6BAA6B;IAC7B,iDAAiD;IACjD,MAAM,SAAS,GAAG,IAAI,SAAS,CAAC,OAAO,CAAC,CAAC;IACzC,MAAM,WAAW,GAAG,IAAI,WAAW,CAAC,OAAO,CAAC,CAAC;IAC7C,MAAM,UAAU,GAAG,IAAI,UAAU,CAAC,OAAO,CAAC,CAAC;IAE3C,gCAAgC;IAChC,0DAA0D;IAC1D,MAAM,iBAAiB,GAAG,IAAI,iBAAiB,EAAE,CAAC;IAElD,6BAA6B;IAC7B,4DAA4D;IAC5D,OAAO,MAAM,CAAC,MAAM,CAAC;QACnB,MAAM;QACN,SAAS;QACT,WAAW;QACX,UAAU;QACV,iBAAiB;KAClB,CAAC,CAAC;AACL,CAAC;AAED;;;;;;;;;;;;;GAaG;AACH,IAAI,eAAe,GAA4B,IAAI,CAAC;AAEpD;;;;;;;;;;;;;;;GAeG;AACH,MAAM,UAAU,yBAAyB,CACvC,UAA4B,EAAE;IAE9B,IAAI,eAAe,KAAK,IAAI,EAAE,CAAC;QAC7B,MAAM,IAAI,KAAK,CACb,4FAA4F,CAC7F,CAAC;IACJ,CAAC;IAED,eAAe,GAAG,eAAe,CAAC,OAAO,CAAC,CAAC;IAC3C,OAAO,eAAe,CAAC;AACzB,CAAC;AAED;;;;;;;;;;;GAWG;AACH,MAAM,UAAU,kBAAkB;IAChC,IAAI,eAAe,KAAK,IAAI,EAAE,CAAC;QAC7B,MAAM,IAAI,KAAK,CACb,2EAA2E,CAC5E,CAAC;IACJ,CAAC;IAED,OAAO,eAAe,CAAC;AACzB,CAAC;AAED;;;;;;;;;;;;;GAaG;AACH,MAAM,UAAU,oBAAoB;IAClC,eAAe,GAAG,IAAI,CAAC;AACzB,CAAC;AAED;;;;GAIG;AACH,MAAM,UAAU,kBAAkB;IAChC,OAAO,eAAe,KAAK,IAAI,CAAC;AAClC,CAAC"}

package/dist/server/logger.d.ts

@@ -0,0 +1,98 @@
+/**
+ * Logging Infrastructure with Pino
+ *
+ * Provides structured logging with:
+ * - Sensitive data redaction
+ * - Correlation IDs
+ * - Environment-aware formatting
+ * - Error serialization
+ */
+import { type Logger } from 'pino';
+export type { Logger } from 'pino';
+/**
+ * Get or create the root logger
+ *
+ * Singleton pattern ensures consistent configuration across application
+ */
+export declare function getLogger(): Logger;
+/**
+ * Create child logger with correlation ID
+ *
+ * Child loggers inherit parent configuration but can add context.
+ * Correlation IDs enable request tracing across async operations.
+ *
+ * @param correlationId - Optional correlation ID (generates UUID if not provided)
+ * @param context - Additional context to include in all logs
+ * @returns Child logger with correlation context
+ *
+ * @example
+ * ```typescript
+ * const logger = createLogger();
+ * logger.info('Processing request');
+ *
+ * // Later in async operation:
+ * logger.debug({ taskId: '123' }, 'Task created');
+ * ```
+ */
+export declare function createLogger(correlationId?: string, context?: Record<string, unknown>): Logger;
+/**
+ * Create logger with automatic context
+ *
+ * Factory function for dependency injection pattern.
+ * Each module can create its own logger with appropriate context.
+ *
+ * @param moduleName - Name of the module (e.g., 'TaskStore', 'MCPServer')
+ * @returns Logger configured for the module
+ *
+ * @example
+ * ```typescript
+ * export class TaskStore {
+ *   private readonly logger = createModuleLogger('TaskStore');
+ *
+ *   async createAsync(task: TaskItem): Promise<TaskItem> {
+ *     this.logger.info({ taskId: task.id }, 'Creating task');
+ *     // ... implementation
+ *   }
+ * }
+ * ```
+ */
+export declare function createModuleLogger(moduleName: string): Logger;
+/**
+ * Log and rethrow error with context
+ *
+ * Utility for consistent error logging before rethrowing.
+ *
+ * @param logger - Logger instance
+ * @param error - Error to log
+ * @param context - Additional context about the error
+ * @param message - Custom error message
+ * @throws The original error after logging
+ *
+ * @example
+ * ```typescript
+ * try {
+ *   await riskyOperation();
+ * } catch (error) {
+ *   logAndThrow(logger, error, { taskId }, 'Failed to create task');
+ * }
+ * ```
+ */
+export declare function logAndThrow(logger: Logger, error: unknown, context: Record<string, unknown>, message: string): never;
+/**
+ * Sanitize log data before logging
+ *
+ * Use this to sanitize data that may contain sensitive information
+ * before passing to logger.
+ *
+ * @param data - Data to sanitize
+ * @returns Sanitized copy of data
+ *
+ * @example
+ * ```typescript
+ * const userData = { name: 'Alice', password: 'secret123' };
+ * logger.info(sanitizeLogData(userData), 'User logged in');
+ * // Logs: { name: 'Alice', password: '[REDACTED]' }
+ * ```
+ */
+export declare function sanitizeLogData<T>(data: T): T;
+//# sourceMappingURL=logger.d.ts.map

package/dist/server/logger.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"logger.d.ts","sourceRoot":"","sources":["../../src/server/logger.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AAEH,OAAa,EAAE,KAAK,MAAM,EAAsB,MAAM,MAAM,CAAC;AAI7D,YAAY,EAAE,MAAM,EAAE,MAAM,MAAM,CAAC;AA4MnC;;;;GAIG;AACH,wBAAgB,SAAS,IAAI,MAAM,CAKlC;AAED;;;;;;;;;;;;;;;;;;GAkBG;AACH,wBAAgB,YAAY,CAC1B,aAAa,CAAC,EAAE,MAAM,EACtB,OAAO,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAChC,MAAM,CASR;AAED;;;;;;;;;;;;;;;;;;;;GAoBG;AACH,wBAAgB,kBAAkB,CAAC,UAAU,EAAE,MAAM,GAAG,MAAM,CAE7D;AAED;;;;;;;;;;;;;;;;;;;GAmBG;AACH,wBAAgB,WAAW,CACzB,MAAM,EAAE,MAAM,EACd,KAAK,EAAE,OAAO,EACd,OAAO,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,EAChC,OAAO,EAAE,MAAM,GACd,KAAK,CAaP;AAED;;;;;;;;;;;;;;;GAeG;AACH,wBAAgB,eAAe,CAAC,CAAC,EAAE,IAAI,EAAE,CAAC,GAAG,CAAC,CAE7C"}