ai-prompt-guide-mcp 1.0.0

package/dist/tools/implementations/complete-task.js

@@ -0,0 +1,122 @@
+/**
+ * Implementation for the complete_task tool
+ * Mark tasks as completed and show next available task
+ */
+import { ToolIntegration, AddressingError, DocumentNotFoundError } from '../../shared/addressing-system.js';
+import { findNextAvailableTask } from '../../shared/task-view-utilities.js';
+import { enrichTaskWithWorkflow } from '../../shared/workflow-prompt-utilities.js';
+import { completeTaskOperation } from '../../shared/task-operations.js';
+export async function completeTask(args, _state, manager) {
+    try {
+        // Mode Detection: Parse document parameter to detect mode
+        const documentParam = ToolIntegration.validateStringParameter(args['document'], 'document');
+        const note = ToolIntegration.validateStringParameter(args['note'], 'note');
+        let mode;
+        let docPath;
+        let taskSlug;
+        if (documentParam.includes('#')) {
+            // Ad-hoc mode: Parse document + slug
+            const parts = documentParam.split('#');
+            docPath = parts[0] ?? documentParam;
+            taskSlug = parts[1];
+            mode = 'adhoc';
+            if (taskSlug == null || taskSlug === '') {
+                throw new AddressingError('Task slug cannot be empty after #', 'EMPTY_TASK_SLUG');
+            }
+        }
+        else {
+            // Sequential mode: Document only
+            docPath = documentParam;
+            taskSlug = undefined;
+            mode = 'sequential';
+        }
+        // Use addressing system for validation and parsing
+        const { addresses } = ToolIntegration.validateAndParse({
+            document: docPath,
+            ...(taskSlug != null && { task: taskSlug })
+        });
+        // Get document and validate existence
+        const document = await manager.getDocument(addresses.document.path);
+        if (document == null) {
+            throw new DocumentNotFoundError(addresses.document.path);
+        }
+        // Determine target task based on mode
+        let targetTaskSlug;
+        if (mode === 'adhoc') {
+            // Ad-hoc mode: Use the provided task slug
+            if (addresses.task == null) {
+                throw new AddressingError('Task address required for ad-hoc mode', 'MISSING_TASK');
+            }
+            targetTaskSlug = addresses.task.slug;
+        }
+        else {
+            // Sequential mode: Find next available task
+            const nextTask = await findNextAvailableTask(manager, document, undefined);
+            if (nextTask == null) {
+                throw new AddressingError('No pending or in_progress tasks found in document', 'NO_AVAILABLE_TASKS', {
+                    document: addresses.document.path,
+                    suggestion: 'All tasks may be completed. Use view_task to check task status.'
+                });
+            }
+            targetTaskSlug = nextTask.slug;
+        }
+        // Complete the task using shared operation
+        const completedTaskData = await completeTaskOperation(manager, addresses.document.path, targetTaskSlug, note);
+        // Get next available task based on mode
+        let nextTaskData = null;
+        if (mode === 'sequential') {
+            // Sequential mode: Find next task after current one
+            nextTaskData = await findNextAvailableTask(manager, document, targetTaskSlug);
+        }
+        // In ad-hoc mode, nextTaskData remains null
+        let nextTask;
+        if (nextTaskData != null) {
+            // Get next task content for workflow extraction
+            const nextTaskContent = await manager.getSectionContent(addresses.document.path, nextTaskData.slug) ?? '';
+            // Enrich with task-specific workflow ONLY (no main workflow)
+            const enrichedNext = enrichTaskWithWorkflow({
+                slug: nextTaskData.slug,
+                title: nextTaskData.title,
+                content: nextTaskContent,
+                status: nextTaskData.status
+            }, nextTaskContent);
+            // Build next_task response
+            nextTask = {
+                slug: enrichedNext.slug,
+                title: enrichedNext.title,
+                ...(nextTaskData.link != null && { link: nextTaskData.link }),
+                // Add workflow if present (FULL object, not just name)
+                ...(enrichedNext.workflow != null && {
+                    workflow: {
+                        name: enrichedNext.workflow.name,
+                        description: enrichedNext.workflow.description,
+                        content: enrichedNext.workflow.content,
+                        whenToUse: enrichedNext.workflow.whenToUse
+                    }
+                }),
+                ...(nextTaskData.referencedDocuments != null && nextTaskData.referencedDocuments.length > 0 && {
+                    referenced_documents: nextTaskData.referencedDocuments
+                })
+            };
+        }
+        return {
+            mode,
+            completed_task: {
+                slug: completedTaskData.slug,
+                title: completedTaskData.title,
+                note: completedTaskData.note,
+                completed_date: completedTaskData.completed_date
+            },
+            ...(nextTask != null && { next_task: nextTask }),
+            timestamp: new Date().toISOString().split('T')[0] ?? new Date().toISOString()
+        };
+    }
+    catch (error) {
+        if (error instanceof AddressingError) {
+            throw error;
+        }
+        throw new AddressingError(`Task completion failed: ${error instanceof Error ? error.message : String(error)}`, 'COMPLETION_FAILED');
+    }
+}
+// Helper functions moved to shared/task-operations.ts and shared/task-view-utilities.ts
+//# sourceMappingURL=complete-task.js.map

package/dist/tools/implementations/complete-task.js.map

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

package/dist/tools/implementations/continue-task.d.ts

@@ -0,0 +1,48 @@
+/**
+ * Implementation for the continue_task tool
+ *
+ * Signals "I'm starting work on this task" and provides FULL CONTEXT including:
+ * - Task-specific workflow (if present in task metadata)
+ * - Main workflow from first task (if present in first task metadata)
+ * - Referenced documents (hierarchical @reference loading)
+ *
+ * This tool is used for:
+ * - Starting work on a task (new session)
+ * - Resuming work after context compression
+ *
+ * Unlike view_task (passive inspection) or complete_task (work continuation),
+ * continue_task provides full workflow injection for new/resumed sessions.
+ */
+import type { SessionState } from '../../session/types.js';
+import type { DocumentManager } from '../../document-manager.js';
+import type { WorkflowPrompt } from '../../prompts/workflow-prompts.js';
+import type { HierarchicalContent } from '../../shared/reference-loader.js';
+/**
+ * Response interface for continue_task tool
+ */
+export interface ContinueTaskResponse {
+    document: string;
+    task: {
+        slug: string;
+        title: string;
+        content: string;
+        status: string;
+        priority: string;
+        full_path: string;
+        workflow?: WorkflowPrompt;
+        main_workflow?: WorkflowPrompt;
+        referenced_documents?: HierarchicalContent[];
+    };
+}
+/**
+ * Continue work on a task with full context injection
+ *
+ * @param args - Tool arguments containing document path and task slug
+ * @param _state - Session state (unused but required by tool signature)
+ * @param manager - Document manager for accessing documents
+ * @returns Promise resolving to enriched task data with full workflow context
+ * @throws {AddressingError} When parameters are invalid or task validation fails
+ * @throws {DocumentNotFoundError} When document doesn't exist
+ */
+export declare function continueTask(args: Record<string, unknown>, _state: SessionState, manager: DocumentManager): Promise<ContinueTaskResponse>;
+//# sourceMappingURL=continue-task.d.ts.map

package/dist/tools/implementations/continue-task.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"continue-task.d.ts","sourceRoot":"","sources":["../../../src/tools/implementations/continue-task.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;GAcG;AAEH,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,wBAAwB,CAAC;AAC3D,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,2BAA2B,CAAC;AAejE,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,mCAAmC,CAAC;AACxE,OAAO,KAAK,EAAE,mBAAmB,EAAE,MAAM,kCAAkC,CAAC;AAG5E;;GAEG;AACH,MAAM,WAAW,oBAAoB;IACnC,QAAQ,EAAE,MAAM,CAAC;IACjB,IAAI,EAAE;QACJ,IAAI,EAAE,MAAM,CAAC;QACb,KAAK,EAAE,MAAM,CAAC;QACd,OAAO,EAAE,MAAM,CAAC;QAChB,MAAM,EAAE,MAAM,CAAC;QACf,QAAQ,EAAE,MAAM,CAAC;QACjB,SAAS,EAAE,MAAM,CAAC;QAClB,QAAQ,CAAC,EAAE,cAAc,CAAC;QAC1B,aAAa,CAAC,EAAE,cAAc,CAAC;QAC/B,oBAAoB,CAAC,EAAE,mBAAmB,EAAE,CAAC;KAC9C,CAAC;CACH;AAED;;;;;;;;;GASG;AACH,wBAAsB,YAAY,CAChC,IAAI,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,EAC7B,MAAM,EAAE,YAAY,EACpB,OAAO,EAAE,eAAe,GACvB,OAAO,CAAC,oBAAoB,CAAC,CA4L/B"}

package/dist/tools/implementations/continue-task.js

@@ -0,0 +1,167 @@
+/**
+ * Implementation for the continue_task tool
+ *
+ * Signals "I'm starting work on this task" and provides FULL CONTEXT including:
+ * - Task-specific workflow (if present in task metadata)
+ * - Main workflow from first task (if present in first task metadata)
+ * - Referenced documents (hierarchical @reference loading)
+ *
+ * This tool is used for:
+ * - Starting work on a task (new session)
+ * - Resuming work after context compression
+ *
+ * Unlike view_task (passive inspection) or complete_task (work continuation),
+ * continue_task provides full workflow injection for new/resumed sessions.
+ */
+import { ToolIntegration, AddressingError, DocumentNotFoundError } from '../../shared/addressing-system.js';
+import { enrichTaskWithReferences, extractTaskField } from '../../shared/task-view-utilities.js';
+import { enrichTaskWithWorkflow, enrichTaskWithMainWorkflow } from '../../shared/workflow-prompt-utilities.js';
+import { getTaskHeadings } from '../../shared/task-utilities.js';
+/**
+ * Continue work on a task with full context injection
+ *
+ * @param args - Tool arguments containing document path and task slug
+ * @param _state - Session state (unused but required by tool signature)
+ * @param manager - Document manager for accessing documents
+ * @returns Promise resolving to enriched task data with full workflow context
+ * @throws {AddressingError} When parameters are invalid or task validation fails
+ * @throws {DocumentNotFoundError} When document doesn't exist
+ */
+export async function continueTask(args, _state, manager) {
+    try {
+        // ===== INPUT VALIDATION =====
+        const documentPath = ToolIntegration.validateStringParameter(args['document'], 'document');
+        const taskSlug = ToolIntegration.validateStringParameter(args['task'], 'task');
+        // ===== ADDRESS PARSING =====
+        const { addresses } = ToolIntegration.validateAndParse({
+            document: documentPath,
+            task: taskSlug
+        });
+        // Ensure task address is defined (type guard)
+        if (addresses.task == null) {
+            throw new AddressingError('Task address is required', 'MISSING_TASK_ADDRESS');
+        }
+        // ===== DOCUMENT LOADING =====
+        const document = await manager.getDocument(addresses.document.path);
+        if (document == null) {
+            throw new DocumentNotFoundError(addresses.document.path);
+        }
+        // ===== TASK VALIDATION =====
+        // Find tasks section
+        const tasksSection = document.headings.find(h => h.slug === 'tasks' || h.title.toLowerCase() === 'tasks');
+        if (tasksSection == null) {
+            throw new AddressingError('No tasks section found in document', 'NO_TASKS_SECTION', {
+                document: addresses.document.path,
+                available_sections: document.headings.map(h => h.slug)
+            });
+        }
+        // Validate task exists under tasks section (at any depth)
+        // This supports both direct children (depth 3) and nested subtasks (depth 4+)
+        // Type assertion: addresses.task is guaranteed to be defined after validation
+        const taskAddress = addresses.task;
+        const tasksIndex = document.headings.findIndex(h => h.slug === tasksSection.slug);
+        const taskIndex = document.headings.findIndex(h => h.slug === taskAddress.slug);
+        // Check if task exists after tasks section and is deeper than tasks section
+        const taskHeading = document.headings[taskIndex];
+        const isUnderTasksSection = taskIndex > tasksIndex &&
+            taskHeading != null &&
+            taskHeading.depth > tasksSection.depth;
+        if (!isUnderTasksSection) {
+            // Build list of available tasks for helpful error message
+            const taskHeadings = await getTaskHeadings(document, tasksSection);
+            throw new AddressingError(`Task not found: ${taskAddress.slug}`, 'TASK_NOT_FOUND', {
+                document: addresses.document.path,
+                task: taskAddress.slug,
+                available_tasks: taskHeadings.map(h => h.slug)
+            });
+        }
+        // Check if the next heading at same or shallower depth is still under tasks section
+        // This ensures we haven't gone past the tasks section boundary
+        let withinTasksSection = true;
+        for (let i = taskIndex + 1; i < document.headings.length; i++) {
+            const nextHeading = document.headings[i];
+            if (nextHeading != null && nextHeading.depth <= tasksSection.depth) {
+                // Hit a heading at same or shallower depth as tasks section
+                withinTasksSection = true;
+                break;
+            }
+        }
+        if (!withinTasksSection) {
+            throw new AddressingError(`Section ${taskAddress.slug} is not under tasks section`, 'NOT_A_TASK', {
+                document: addresses.document.path,
+                section: taskAddress.slug
+            });
+        }
+        // ===== TASK CONTENT LOADING =====
+        const taskContent = await manager.getSectionContent(addresses.document.path, taskAddress.slug);
+        if (taskContent == null) {
+            throw new AddressingError(`Task content not found for ${taskAddress.slug}`, 'TASK_CONTENT_NOT_FOUND', {
+                document: addresses.document.path,
+                task: taskAddress.slug
+            });
+        }
+        // ===== BASE TASK DATA EXTRACTION =====
+        const heading = document.headings.find(h => h.slug === taskAddress.slug);
+        const title = heading?.title ?? taskAddress.slug;
+        const status = extractTaskField(taskContent, 'Status') ?? 'pending';
+        const priority = extractTaskField(taskContent, 'Priority') ?? 'medium';
+        // Build base task data
+        const baseTaskData = {
+            slug: taskAddress.slug,
+            title,
+            content: taskContent,
+            status,
+            priority
+        };
+        // ===== WORKFLOW ENRICHMENT =====
+        // Enrich with task-specific workflow (if present in task metadata)
+        const taskWithWorkflow = enrichTaskWithWorkflow(baseTaskData, taskContent);
+        // Enrich with main workflow from first task (if present in first task metadata)
+        const taskWithBothWorkflows = await enrichTaskWithMainWorkflow(manager, document, taskWithWorkflow);
+        // ===== REFERENCE ENRICHMENT =====
+        // Enrich with hierarchical references from task content
+        const enrichedTask = await enrichTaskWithReferences(manager, addresses.document.path, taskAddress.slug, taskContent, heading, taskAddress);
+        // Merge workflow data with reference-enriched data
+        // Extract workflow data with explicit typing
+        const workflow = 'workflow' in taskWithBothWorkflows
+            ? taskWithBothWorkflows.workflow
+            : undefined;
+        const mainWorkflow = 'mainWorkflow' in taskWithBothWorkflows
+            ? taskWithBothWorkflows.mainWorkflow
+            : undefined;
+        const fullyEnriched = {
+            ...enrichedTask,
+            ...(workflow != null && { workflow }),
+            ...(mainWorkflow != null && { mainWorkflow })
+        };
+        // ===== OUTPUT CONSTRUCTION =====
+        return {
+            document: addresses.document.path,
+            task: {
+                slug: fullyEnriched.slug,
+                title: fullyEnriched.title,
+                content: fullyEnriched.content,
+                status: fullyEnriched.status,
+                priority: fullyEnriched.priority ?? 'medium',
+                full_path: fullyEnriched.fullPath ?? ToolIntegration.formatTaskPath(taskAddress),
+                ...(workflow != null && { workflow }),
+                ...(mainWorkflow != null && { main_workflow: mainWorkflow }),
+                ...(fullyEnriched.referencedDocuments != null &&
+                    fullyEnriched.referencedDocuments.length > 0 && {
+                    referenced_documents: fullyEnriched.referencedDocuments
+                })
+            }
+        };
+    }
+    catch (error) {
+        // Re-throw known error types
+        if (error instanceof AddressingError || error instanceof DocumentNotFoundError) {
+            throw error;
+        }
+        // Wrap unexpected errors
+        throw new AddressingError(`Failed to continue task: ${error instanceof Error ? error.message : String(error)}`, 'CONTINUE_TASK_FAILED', {
+            originalError: error instanceof Error ? error.message : String(error)
+        });
+    }
+}
+//# sourceMappingURL=continue-task.js.map

package/dist/tools/implementations/continue-task.js.map

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

package/dist/tools/implementations/coordinator-task.d.ts

@@ -0,0 +1,72 @@
+/**
+ * Implementation for the coordinator_task tool
+ * Manages sequential coordinator task lists in /coordinator/ namespace
+ *
+ * Sequential only - NO #slug allowed (use task reordering instead)
+ */
+import type { SessionState } from '../../session/types.js';
+import type { DocumentManager } from '../../document-manager.js';
+import { type TaskHierarchicalContext } from '../../shared/task-operations.js';
+import type { HierarchicalContent } from '../../shared/reference-loader.js';
+/**
+ * Individual task operation result
+ */
+interface TaskOperationResult {
+    task?: {
+        slug: string;
+        title: string;
+        hierarchical_context?: TaskHierarchicalContext;
+    };
+    tasks?: Array<{
+        slug: string;
+        title: string;
+        status: string;
+        link?: string;
+        referenced_documents?: HierarchicalContent[];
+        hierarchical_context?: TaskHierarchicalContext;
+    }>;
+    count?: number;
+    hierarchical_summary?: {
+        by_phase: Record<string, {
+            total: number;
+            pending: number;
+            in_progress: number;
+            completed: number;
+        }>;
+        by_category: Record<string, {
+            total: number;
+            pending: number;
+            in_progress?: number;
+            completed?: number;
+        }>;
+        critical_path: string[];
+    };
+    next_task?: {
+        slug: string;
+        title: string;
+        link?: string;
+    };
+    next_step?: string;
+    error?: string;
+}
+/**
+ * Bulk task operations response
+ */
+interface TaskBulkResponse {
+    operations_completed: number;
+    results: TaskOperationResult[];
+}
+/**
+ * Coordinator task tool - sequential task management
+ *
+ * Automatically creates /coordinator/active.md if it doesn't exist
+ * Validates coordinator namespace and sequential-only mode
+ *
+ * @param args - Tool arguments with operations array
+ * @param _state - Session state (unused)
+ * @param manager - Document manager
+ * @returns Bulk operation results
+ */
+export declare function coordinatorTask(args: Record<string, unknown>, _state: SessionState, manager: DocumentManager): Promise<TaskBulkResponse>;
+export {};
+//# sourceMappingURL=coordinator-task.d.ts.map

package/dist/tools/implementations/coordinator-task.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"coordinator-task.d.ts","sourceRoot":"","sources":["../../../src/tools/implementations/coordinator-task.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,wBAAwB,CAAC;AAC3D,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,2BAA2B,CAAC;AAMjE,OAAO,EAIL,KAAK,uBAAuB,EAC7B,MAAM,iCAAiC,CAAC;AACzC,OAAO,KAAK,EAAE,mBAAmB,EAAE,MAAM,kCAAkC,CAAC;AAqB5E;;GAEG;AACH,UAAU,mBAAmB;IAC3B,IAAI,CAAC,EAAE;QACL,IAAI,EAAE,MAAM,CAAC;QACb,KAAK,EAAE,MAAM,CAAC;QACd,oBAAoB,CAAC,EAAE,uBAAuB,CAAC;KAChD,CAAC;IACF,KAAK,CAAC,EAAE,KAAK,CAAC;QACZ,IAAI,EAAE,MAAM,CAAC;QACb,KAAK,EAAE,MAAM,CAAC;QACd,MAAM,EAAE,MAAM,CAAC;QACf,IAAI,CAAC,EAAE,MAAM,CAAC;QACd,oBAAoB,CAAC,EAAE,mBAAmB,EAAE,CAAC;QAC7C,oBAAoB,CAAC,EAAE,uBAAuB,CAAC;KAChD,CAAC,CAAC;IACH,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,oBAAoB,CAAC,EAAE;QACrB,QAAQ,EAAE,MAAM,CAAC,MAAM,EAAE;YAAE,KAAK,EAAE,MAAM,CAAC;YAAC,OAAO,EAAE,MAAM,CAAC;YAAC,WAAW,EAAE,MAAM,CAAC;YAAC,SAAS,EAAE,MAAM,CAAA;SAAE,CAAC,CAAC;QACrG,WAAW,EAAE,MAAM,CAAC,MAAM,EAAE;YAAE,KAAK,EAAE,MAAM,CAAC;YAAC,OAAO,EAAE,MAAM,CAAC;YAAC,WAAW,CAAC,EAAE,MAAM,CAAC;YAAC,SAAS,CAAC,EAAE,MAAM,CAAA;SAAE,CAAC,CAAC;QAC1G,aAAa,EAAE,MAAM,EAAE,CAAC;KACzB,CAAC;IACF,SAAS,CAAC,EAAE;QACV,IAAI,EAAE,MAAM,CAAC;QACb,KAAK,EAAE,MAAM,CAAC;QACd,IAAI,CAAC,EAAE,MAAM,CAAC;KACf,CAAC;IACF,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,KAAK,CAAC,EAAE,MAAM,CAAC;CAChB;AAED;;GAEG;AACH,UAAU,gBAAgB;IACxB,oBAAoB,EAAE,MAAM,CAAC;IAC7B,OAAO,EAAE,mBAAmB,EAAE,CAAC;CAChC;AAED;;;;;;;;;;GAUG;AACH,wBAAsB,eAAe,CACnC,IAAI,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,EAC7B,MAAM,EAAE,YAAY,EACpB,OAAO,EAAE,eAAe,GACvB,OAAO,CAAC,gBAAgB,CAAC,CAkI3B"}

package/dist/tools/implementations/coordinator-task.js

@@ -0,0 +1,169 @@
+/**
+ * Implementation for the coordinator_task tool
+ * Manages sequential coordinator task lists in /coordinator/ namespace
+ *
+ * Sequential only - NO #slug allowed (use task reordering instead)
+ */
+import { ToolIntegration, AddressingError, DocumentNotFoundError } from '../../shared/addressing-system.js';
+import { createTaskOperation, editTaskOperation, listTasksOperation } from '../../shared/task-operations.js';
+import { validateCoordinatorTaskAccess } from '../../shared/task-validation.js';
+import { PATH_PREFIXES } from '../../shared/namespace-constants.js';
+/**
+ * Maximum number of operations allowed in a single batch request
+ * Prevents performance issues and potential DoS attacks
+ */
+const MAX_BATCH_SIZE = 100;
+/**
+ * Check if this is the first task in the document
+ * A document has its first task if it has no H2+ sections yet
+ */
+function isFirstTaskInDocument(document) {
+    if (document == null)
+        return true;
+    return !document.headings.some(h => h.depth >= 2);
+}
+/**
+ * Coordinator task tool - sequential task management
+ *
+ * Automatically creates /coordinator/active.md if it doesn't exist
+ * Validates coordinator namespace and sequential-only mode
+ *
+ * @param args - Tool arguments with operations array
+ * @param _state - Session state (unused)
+ * @param manager - Document manager
+ * @returns Bulk operation results
+ */
+export async function coordinatorTask(args, _state, manager) {
+    try {
+        // Validate operations array
+        const operations = args['operations'];
+        if (!Array.isArray(operations) || operations.length === 0) {
+            throw new AddressingError('operations array is required and must not be empty', 'MISSING_OPERATIONS');
+        }
+        if (operations.length > MAX_BATCH_SIZE) {
+            throw new AddressingError(`Batch size ${operations.length} exceeds maximum of ${MAX_BATCH_SIZE}`, 'BATCH_TOO_LARGE');
+        }
+        // COORDINATOR-SPECIFIC: Fixed document path using explicit path prefix
+        const documentPath = `${PATH_PREFIXES.COORDINATOR}active.md`;
+        // Validate coordinator access (no #slug allowed, /coordinator/ namespace)
+        validateCoordinatorTaskAccess(documentPath, undefined);
+        // Auto-create /coordinator/active.md if it doesn't exist
+        await ensureCoordinatorDocument(manager, documentPath);
+        // Get document and validate existence
+        const document = await manager.getDocument(documentPath);
+        if (document == null) {
+            throw new DocumentNotFoundError(documentPath);
+        }
+        // Process operations using shared task-operations.ts functions
+        const results = [];
+        for (const op of operations) {
+            try {
+                const operation = ToolIntegration.validateOperation(op['operation'] ?? '', ['create', 'edit', 'list'], 'coordinator_task');
+                if (operation === 'create') {
+                    const title = ToolIntegration.validateOptionalStringParameter(op['title'], 'title');
+                    const content = ToolIntegration.validateOptionalStringParameter(op['content'], 'content');
+                    if (title == null || content == null) {
+                        throw new AddressingError('Missing required parameters for create: title and content', 'MISSING_PARAMETER');
+                    }
+                    // Check if this is the first task in the document (before creating)
+                    const currentDocument = await manager.getDocument(documentPath);
+                    const isFirstTask = isFirstTaskInDocument(currentDocument);
+                    const createResult = await createTaskOperation(manager, documentPath, title, content, undefined);
+                    const result = {
+                        task: {
+                            slug: createResult.slug,
+                            title: createResult.title
+                        }
+                    };
+                    // Only show next_step on first task in document
+                    if (isFirstTask) {
+                        result.next_step = 'Call start_coordinator_task() to begin (omit return_task_context on first start)';
+                    }
+                    results.push(result);
+                }
+                else if (operation === 'edit') {
+                    const taskSlug = ToolIntegration.validateOptionalStringParameter(op['task'], 'task');
+                    const content = ToolIntegration.validateOptionalStringParameter(op['content'], 'content');
+                    if (taskSlug == null || content == null) {
+                        throw new AddressingError('Missing required parameters for edit: task and content', 'MISSING_PARAMETER');
+                    }
+                    await editTaskOperation(manager, documentPath, taskSlug, content);
+                    results.push({});
+                }
+                else if (operation === 'list') {
+                    const statusFilter = ToolIntegration.validateOptionalStringParameter(op['status'], 'status');
+                    const listResult = await listTasksOperation(manager, documentPath, statusFilter);
+                    const result = {
+                        count: listResult.tasks.length
+                    };
+                    if (listResult.tasks.length > 0) {
+                        result.tasks = listResult.tasks.map(t => ({
+                            slug: t.slug,
+                            title: t.title,
+                            status: t.status,
+                            ...(t.link != null && { link: t.link }),
+                            ...(t.referenced_documents != null && { referenced_documents: t.referenced_documents }),
+                            ...(t.hierarchical_context != null && { hierarchical_context: t.hierarchical_context })
+                        }));
+                    }
+                    if (listResult.hierarchical_summary != null) {
+                        result.hierarchical_summary = listResult.hierarchical_summary;
+                    }
+                    if (listResult.next_task != null) {
+                        result.next_task = listResult.next_task;
+                    }
+                    results.push(result);
+                }
+            }
+            catch (error) {
+                const message = error instanceof Error ? error.message : String(error);
+                results.push({
+                    error: message
+                });
+            }
+        }
+        return {
+            operations_completed: results.filter(r => r.error == null).length,
+            results
+        };
+    }
+    catch (error) {
+        throw new AddressingError(`Coordinator task operation failed: ${error instanceof Error ? error.message : String(error)}`, 'COORDINATOR_OPERATION_FAILED');
+    }
+}
+/**
+ * Ensure /coordinator/active.md exists, creating it if necessary
+ */
+async function ensureCoordinatorDocument(manager, docPath) {
+    const document = await manager.getDocument(docPath);
+    if (document == null) {
+        // Document doesn't exist - create it
+        // First ensure /coordinator/ directory exists
+        const fs = await import('fs/promises');
+        const path = await import('path');
+        const coordinatorRoot = manager.pathResolver.getCoordinatorRoot();
+        try {
+            await fs.mkdir(coordinatorRoot, { recursive: true });
+        }
+        catch (error) {
+            // Ignore if already exists
+            if (error.code !== 'EEXIST') {
+                throw error;
+            }
+        }
+        // Create blank document with title and overview
+        // Use DocumentManager's createDocument (creates with template)
+        await manager.createDocument(docPath, {
+            title: 'Coordinator Tasks',
+            template: 'blank'
+        });
+        // Add overview content after creation
+        const docFilePath = path.join(coordinatorRoot, 'active.md');
+        const content = await fs.readFile(docFilePath, 'utf8');
+        const withOverview = content.replace(/^(# Coordinator Tasks\n\n)/, '$1Sequential coordinator task list. Auto-archives when all tasks complete.\n\n');
+        await fs.writeFile(docFilePath, withOverview, 'utf8');
+        // Invalidate cache to pick up the overview
+        manager.cache.invalidateDocument(docPath);
+    }
+}
+//# sourceMappingURL=coordinator-task.js.map

package/dist/tools/implementations/coordinator-task.js.map

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

package/dist/tools/implementations/create-document.d.ts

@@ -0,0 +1,12 @@
+/**
+ * Implementation for the create_document tool
+ * Refactored to use stage-based pipeline architecture
+ */
+import type { SessionState } from '../../session/types.js';
+import type { DocumentManager } from '../../document-manager.js';
+/**
+ * Create document using the stage-based pipeline with dependency injection
+ * Handles progressive discovery pattern with 4 stages (0, 1, 2.5, 3)
+ */
+export declare function createDocument(args: Record<string, unknown>, state: SessionState, manager: DocumentManager, onStageChange?: () => void): Promise<unknown>;
+//# sourceMappingURL=create-document.d.ts.map

package/dist/tools/implementations/create-document.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"create-document.d.ts","sourceRoot":"","sources":["../../../src/tools/implementations/create-document.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAEH,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,wBAAwB,CAAC;AAC3D,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,2BAA2B,CAAC;AAGjE;;;GAGG;AACH,wBAAsB,cAAc,CAClC,IAAI,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,EAC7B,KAAK,EAAE,YAAY,EACnB,OAAO,EAAE,eAAe,EACxB,aAAa,CAAC,EAAE,MAAM,IAAI,GACzB,OAAO,CAAC,OAAO,CAAC,CAElB"}