ai-prompt-guide-mcp 1.0.0

package/dist/shared/task-operations.js

@@ -0,0 +1,416 @@
+/**
+ * Shared task operations layer
+ *
+ * Provides core CRUD operations for tasks that can be used by both
+ * subagent (ad-hoc) and coordinator (sequential) task systems.
+ *
+ * These operations are extracted from the original task.ts, complete-task.ts,
+ * and start-task.ts to eliminate duplication and provide a clean foundation
+ * for the dual task system architecture.
+ */
+import { performSectionEdit } from './utilities.js';
+import { titleToSlug } from '../slug.js';
+import { AddressingError, DocumentNotFoundError } from './addressing-system.js';
+import { getTaskHeadingsFromHeadings } from './task-utilities.js';
+import { ReferenceExtractor } from './reference-extractor.js';
+import { ReferenceLoader } from './reference-loader.js';
+import { loadConfig } from '../config.js';
+import { extractTaskField, extractTaskLink } from './task-view-utilities.js';
+/**
+ * Create a new task in the Tasks section
+ *
+ * @param manager - Document manager instance
+ * @param documentPath - Path to the document
+ * @param title - Task title
+ * @param content - Task content (should include Status field)
+ * @param referenceSlug - Optional slug to insert after (or undefined to append to Tasks section)
+ * @returns Created task slug and title
+ * @throws {AddressingError} When task creation fails
+ * @throws {DocumentNotFoundError} When document doesn't exist
+ */
+export async function createTaskOperation(manager, documentPath, title, content, referenceSlug) {
+    try {
+        const taskSlug = titleToSlug(title);
+        // Task slugs are just the title slug, not prefixed with "tasks/"
+        // The hierarchical relationship is maintained by document structure, not slug naming
+        // Build task content in our standard format
+        const taskContent = `### ${title}
+${content}`;
+        // Use section tool logic to insert the task with validated paths
+        // If referenceSlug provided, insert after it, otherwise append to Tasks section
+        const operation = referenceSlug != null && referenceSlug !== '' ? 'insert_after' : 'append_child';
+        const targetSection = referenceSlug ?? 'tasks';
+        // Create or update the Tasks section using addressing system validation
+        await ensureTasksSectionOperation(manager, documentPath);
+        // Insert the new task using validated document path
+        await performSectionEdit(manager, documentPath, targetSection, taskContent, operation, title);
+        // Get hierarchical context if task slug contains hierarchy
+        const hierarchicalContext = getTaskHierarchicalContext(taskSlug);
+        return {
+            slug: taskSlug, // Return the actual task slug without prefix
+            title,
+            ...(hierarchicalContext != null && { hierarchical_context: hierarchicalContext })
+        };
+    }
+    catch (error) {
+        throw new AddressingError(`Failed to create task: ${error instanceof Error ? error.message : String(error)}`, 'TASK_CREATE_FAILED', { document: documentPath, title });
+    }
+}
+/**
+ * Edit an existing task
+ *
+ * @param manager - Document manager instance
+ * @param documentPath - Path to the document
+ * @param taskSlug - Task slug to edit
+ * @param content - New task content
+ * @throws {AddressingError} When task edit fails
+ */
+export async function editTaskOperation(manager, documentPath, taskSlug, content) {
+    try {
+        // Update the task section with new content using validated addresses
+        await performSectionEdit(manager, documentPath, taskSlug, content, 'replace');
+    }
+    catch (error) {
+        throw new AddressingError(`Failed to edit task: ${error instanceof Error ? error.message : String(error)}`, 'TASK_EDIT_FAILED', { document: documentPath, task: taskSlug });
+    }
+}
+/**
+ * List tasks from Tasks section with optional filtering
+ *
+ * @param manager - Document manager instance
+ * @param documentPath - Path to the document
+ * @param statusFilter - Optional status filter (pending, in_progress, completed, blocked)
+ * @param loadReferences - Whether to load referenced documents (default: false for list operations)
+ * @returns List of tasks with metadata and optional hierarchical summary
+ * @throws {AddressingError} When task listing fails
+ * @throws {DocumentNotFoundError} When document doesn't exist
+ */
+export async function listTasksOperation(manager, documentPath, statusFilter, loadReferences = false) {
+    try {
+        // Get the document
+        const document = await manager.getDocument(documentPath);
+        if (document == null) {
+            throw new DocumentNotFoundError(documentPath);
+        }
+        // Find the Tasks section using consistent addressing logic
+        const tasksSection = document.headings.find(h => h.slug === 'tasks' ||
+            h.title.toLowerCase() === 'tasks');
+        if (tasksSection == null) {
+            return {
+                tasks: []
+            };
+        }
+        // Find all task headings using standardized task identification logic
+        const taskHeadings = await getTaskHeadingsFromHeadings(document, tasksSection);
+        // Parse task details from each task heading
+        let tasks = [];
+        try {
+            tasks = await Promise.all(taskHeadings.map(async (heading) => {
+                // Get the task content using validated document path
+                const taskContent = await manager.getSectionContent(documentPath, heading.slug) ?? '';
+                // Parse task metadata from content
+                const status = extractTaskField(taskContent, 'Status') ?? 'pending';
+                const link = extractTaskLink(taskContent);
+                // Check if task has references (always calculate this)
+                const hasReferences = taskContent.includes('@/');
+                // Conditionally load references based on loadReferences parameter
+                let referencedDocuments = [];
+                if (loadReferences && hasReferences) {
+                    const config = loadConfig();
+                    const extractor = new ReferenceExtractor();
+                    const loader = new ReferenceLoader();
+                    const refs = extractor.extractReferences(taskContent);
+                    const normalizedRefs = extractor.normalizeReferences(refs, documentPath);
+                    referencedDocuments = await loader.loadReferences(normalizedRefs, manager, config.referenceExtractionDepth);
+                }
+                // Get hierarchical context for the task
+                const hierarchicalContext = getTaskHierarchicalContext(heading.slug);
+                return {
+                    slug: heading.slug,
+                    title: heading.title,
+                    status,
+                    ...(link != null && link !== '' && { link }),
+                    ...(hasReferences && { has_references: true }),
+                    ...(referencedDocuments.length > 0 && { referenced_documents: referencedDocuments }),
+                    ...(hierarchicalContext != null && { hierarchical_context: hierarchicalContext })
+                };
+            }));
+        }
+        catch (error) {
+            // Critical operation failed - ensure cache consistency by invalidating document
+            try {
+                manager['cache'].invalidateDocument(documentPath);
+            }
+            catch (cleanupError) {
+                // Log cleanup failure but don't mask original error
+                console.warn(`Cache cleanup failed after task loading error: ${cleanupError}`);
+            }
+            // Re-throw original error to maintain expected behavior
+            throw error;
+        }
+        // Apply filters
+        let filteredTasks = tasks;
+        if (statusFilter != null && statusFilter !== '') {
+            filteredTasks = filteredTasks.filter(task => task.status === statusFilter);
+        }
+        // Find next available task (pending or in_progress, sequential order)
+        const nextTask = findNextTask(filteredTasks);
+        // Generate hierarchical summary
+        const hierarchicalSummary = generateHierarchicalSummary(filteredTasks);
+        return {
+            tasks: filteredTasks,
+            ...(hierarchicalSummary != null && { hierarchical_summary: hierarchicalSummary }),
+            ...(nextTask != null && { next_task: nextTask })
+        };
+    }
+    catch (error) {
+        throw new AddressingError(`Failed to list tasks: ${error instanceof Error ? error.message : String(error)}`, 'TASK_LIST_FAILED', { document: documentPath });
+    }
+}
+/**
+ * Complete a task by updating its status and adding completion metadata
+ *
+ * @param manager - Document manager instance
+ * @param documentPath - Path to the document
+ * @param taskSlug - Task slug to complete
+ * @param note - Completion note
+ * @returns Completion metadata
+ * @throws {AddressingError} When task completion fails
+ */
+export async function completeTaskOperation(manager, documentPath, taskSlug, note) {
+    try {
+        // Get current task content
+        const currentContent = await manager.getSectionContent(documentPath, taskSlug);
+        if (currentContent == null || currentContent === '') {
+            throw new AddressingError(`Task not found: ${taskSlug}`, 'TASK_NOT_FOUND', {
+                document: documentPath,
+                task: taskSlug
+            });
+        }
+        // Get task title for response
+        const taskHeading = (await manager.getDocument(documentPath))?.headings.find(h => h.slug === taskSlug);
+        const taskTitle = taskHeading?.title ?? taskSlug;
+        // Update task status to completed and add completion note
+        const completedDate = new Date().toISOString().substring(0, 10); // YYYY-MM-DD format
+        const updatedContent = updateTaskStatus(currentContent, 'completed', note, completedDate);
+        // Update the task section
+        await performSectionEdit(manager, documentPath, taskSlug, updatedContent, 'replace');
+        return {
+            slug: taskSlug,
+            title: taskTitle,
+            note,
+            completed_date: completedDate
+        };
+    }
+    catch (error) {
+        throw new AddressingError(`Failed to complete task: ${error instanceof Error ? error.message : String(error)}`, 'TASK_COMPLETE_FAILED', { document: documentPath, task: taskSlug });
+    }
+}
+/**
+ * Ensure Tasks section exists in document, creating it if necessary
+ *
+ * @param manager - Document manager instance
+ * @param docPath - Path to the document
+ * @throws {AddressingError} When Tasks section creation fails
+ * @throws {DocumentNotFoundError} When document doesn't exist
+ */
+export async function ensureTasksSectionOperation(manager, docPath) {
+    const document = await manager.getDocument(docPath);
+    if (document == null) {
+        throw new DocumentNotFoundError(docPath);
+    }
+    // Check if Tasks section already exists
+    const tasksSection = document.headings.find(h => h.slug === 'tasks' ||
+        h.title.toLowerCase() === 'tasks');
+    if (tasksSection == null) {
+        // No Tasks section exists - AUTO-CREATE IT
+        // Find the document title heading (H1) to append Tasks after it
+        const titleHeading = document.headings.find(h => h.depth === 1);
+        if (titleHeading == null) {
+            throw new AddressingError('Cannot auto-create Tasks section: document has no title heading (H1)', 'NO_TITLE_HEADING', { document: docPath });
+        }
+        const titleSlug = titleHeading.slug;
+        // Create Tasks section as child of document title
+        // This will create an H2 section (depth 2) with proper content
+        await performSectionEdit(manager, docPath, titleSlug, 'Task list for this document.', 'append_child', 'Tasks');
+        // Invalidate cache to ensure Tasks section is available for subsequent operations
+        manager['cache'].invalidateDocument(docPath);
+    }
+    // Tasks section exists (either found or just created), nothing more to do
+}
+/**
+ * Helper: Get hierarchical context for a task slug
+ */
+function getTaskHierarchicalContext(taskSlug) {
+    if (!taskSlug.includes('/')) {
+        return null; // No hierarchical context for flat tasks
+    }
+    const parts = taskSlug.split('/');
+    if (parts.length < 2) {
+        return null;
+    }
+    return {
+        full_path: taskSlug,
+        parent_path: parts.slice(0, -1).join('/'),
+        phase: parts[0] ?? '',
+        category: parts[1] ?? '',
+        task_name: parts[parts.length - 1] ?? '',
+        depth: parts.length
+    };
+}
+/**
+ * Helper: Find next available task (pending or in_progress)
+ */
+function findNextTask(tasks) {
+    // Find next available task (pending or in_progress) in sequential document order
+    const availableTasks = tasks.filter(task => task.status === 'pending' || task.status === 'in_progress');
+    if (availableTasks.length === 0)
+        return undefined;
+    // Return first available task (already in document order)
+    const nextTask = availableTasks[0];
+    if (nextTask == null)
+        return undefined;
+    return {
+        slug: nextTask.slug,
+        title: nextTask.title,
+        ...(nextTask.link != null && nextTask.link !== '' && { link: nextTask.link })
+    };
+}
+/**
+ * Helper: Generate hierarchical summary for tasks
+ */
+function generateHierarchicalSummary(tasks) {
+    const hierarchicalTasks = tasks.filter(t => t.hierarchical_context != null);
+    if (hierarchicalTasks.length === 0) {
+        return null; // No hierarchical tasks
+    }
+    // Group by phase
+    const byPhase = {};
+    const byCategory = {};
+    for (const task of hierarchicalTasks) {
+        const context = task.hierarchical_context;
+        if (context == null)
+            continue;
+        const phase = context.phase;
+        const category = context.category;
+        // Initialize phase stats
+        byPhase[phase] ??= { total: 0, pending: 0, in_progress: 0, completed: 0 };
+        // Initialize category stats
+        byCategory[category] ??= { total: 0, pending: 0 };
+        // Update counts
+        const phaseStats = byPhase[phase];
+        const categoryStats = byCategory[category];
+        if (phaseStats != null) {
+            phaseStats.total++;
+        }
+        if (categoryStats != null) {
+            categoryStats.total++;
+        }
+        if (task.status === 'pending') {
+            if (phaseStats != null) {
+                phaseStats.pending++;
+            }
+            if (categoryStats != null) {
+                categoryStats.pending++;
+            }
+        }
+        else if (task.status === 'in_progress') {
+            if (phaseStats != null) {
+                phaseStats.in_progress++;
+            }
+            if (categoryStats != null) {
+                categoryStats.in_progress ??= 0;
+                categoryStats.in_progress++;
+            }
+        }
+        else if (task.status === 'completed') {
+            if (phaseStats != null) {
+                phaseStats.completed++;
+            }
+            if (categoryStats != null) {
+                categoryStats.completed ??= 0;
+                categoryStats.completed++;
+            }
+        }
+    }
+    // Generate critical path (simplified - tasks in dependency order)
+    const criticalPath = hierarchicalTasks
+        .filter(task => task.hierarchical_context != null)
+        .sort((a, b) => {
+        // Sort by phase first, then by category, then by task name
+        const aContext = a.hierarchical_context;
+        const bContext = b.hierarchical_context;
+        if (aContext == null || bContext == null) {
+            return 0; // Should not happen due to filter above, but safety
+        }
+        if (aContext.phase !== bContext.phase) {
+            return aContext.phase.localeCompare(bContext.phase);
+        }
+        if (aContext.category !== bContext.category) {
+            return aContext.category.localeCompare(bContext.category);
+        }
+        return aContext.task_name.localeCompare(bContext.task_name);
+    })
+        .map(t => t.slug);
+    return {
+        by_phase: byPhase,
+        by_category: byCategory,
+        critical_path: criticalPath
+    };
+}
+/**
+ * Update task status with completion metadata
+ *
+ * Supports multiple status field formats:
+ * - Bold format: `**Status:** pending`
+ * - List format: `- Status: pending` or `* Status: pending`
+ * - Plain format: `Status: pending`
+ *
+ * Preserves the original format style when updating.
+ *
+ * @param content - Task content containing status field
+ * @param newStatus - New status value (e.g., 'completed', 'in_progress')
+ * @param note - Completion note to append
+ * @param completedDate - Completion date in YYYY-MM-DD format
+ * @returns Updated content with new status and completion metadata
+ */
+export function updateTaskStatus(content, newStatus, note, completedDate) {
+    // Regex to match all supported status field formats:
+    // - Bold format: **Status:** pending
+    // - List format: - Status: pending or * Status: pending
+    // - Plain format: Status: pending
+    const statusLineRegex = /^(\*\*)?([*-])?\s*Status:(\*\*)?\s*.+$/m;
+    const statusMatch = content.match(statusLineRegex);
+    if (statusMatch == null) {
+        // No status field found - this shouldn't happen in well-formed tasks
+        // Add status field at the beginning of content
+        const statusLine = `**Status:** ${newStatus}`;
+        const completionInfo = `\n- Completed: ${completedDate}\n- Note: ${note}`;
+        return `${statusLine}\n${content}${completionInfo}`;
+    }
+    // Extract format markers from matched line
+    const hasBoldMarker = statusMatch[1] != null; // Leading **
+    const listMarker = statusMatch[2]; // - or * or undefined
+    const hasTrailingBold = statusMatch[3] != null; // Trailing **
+    // Construct replacement line preserving original format
+    let replacementLine;
+    if (hasBoldMarker && hasTrailingBold) {
+        // Bold format: **Status:** value
+        replacementLine = `**Status:** ${newStatus}`;
+    }
+    else if (listMarker != null) {
+        // List format: - Status: value or * Status: value
+        replacementLine = `${listMarker} Status: ${newStatus}`;
+    }
+    else {
+        // Plain format: Status: value
+        replacementLine = `Status: ${newStatus}`;
+    }
+    // Replace the status line
+    let updated = content.replace(statusLineRegex, replacementLine);
+    // Add completion metadata using list format (standard for completion notes)
+    updated += `\n- Completed: ${completedDate}`;
+    updated += `\n- Note: ${note}`;
+    return updated;
+}
+//# sourceMappingURL=task-operations.js.map

package/dist/shared/task-operations.js.map

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

package/dist/shared/task-utilities.d.ts

@@ -0,0 +1,63 @@
+/**
+ * Task Utilities - Shared task identification logic
+ *
+ * This module provides shared utilities for task identification across tools,
+ * eliminating code duplication between task.ts, complete-task.ts, view-task.ts, and view-document.ts.
+ *
+ * Used by task.ts, complete-task.ts, view-task.ts, and view-document.ts for consistent task identification.
+ */
+import type { Heading } from '../types/index.js';
+/**
+ * Minimal heading interface for task identification
+ * Supports both full Heading interface and minimal heading structures
+ */
+export interface HeadingInfo {
+    readonly slug: string;
+    readonly title: string;
+    readonly depth: number;
+}
+/**
+ * Minimal document interface for task identification
+ * Supports both CachedDocument and minimal document structures
+ */
+export interface TaskDocument {
+    readonly headings: readonly HeadingInfo[];
+}
+/**
+ * Minimal tasks section interface
+ * Supports various task section representations
+ */
+export interface TasksSection {
+    readonly slug: string;
+    readonly depth: number;
+}
+/**
+ * Extract task headings from a document's tasks section
+ *
+ * This function performs hierarchical task validation and depth calculations
+ * to identify task headings under a Tasks section. It uses the addressing system
+ * for consistent task validation across all tools.
+ *
+ * @param document - Document containing headings (supports CachedDocument or minimal interface)
+ * @param tasksSection - Tasks section heading (with slug and depth)
+ * @returns Promise resolving to array of task headings
+ *
+ * @example
+ * ```typescript
+ * const taskHeadings = await getTaskHeadings(document, tasksSection);
+ * console.log(`Found ${taskHeadings.length} tasks`);
+ * ```
+ */
+export declare function getTaskHeadings(document: TaskDocument, tasksSection: TasksSection): Promise<HeadingInfo[]>;
+/**
+ * Convenience function for working with full Heading objects
+ * Returns full Heading objects for compatibility with existing tool code
+ *
+ * @param document - Document with full Heading objects
+ * @param tasksSection - Full Heading object for tasks section
+ * @returns Promise resolving to array of full Heading objects that are tasks
+ */
+export declare function getTaskHeadingsFromHeadings(document: {
+    readonly headings: readonly Heading[];
+}, tasksSection: Heading): Promise<Heading[]>;
+//# sourceMappingURL=task-utilities.d.ts.map

package/dist/shared/task-utilities.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"task-utilities.d.ts","sourceRoot":"","sources":["../../src/shared/task-utilities.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAEH,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,mBAAmB,CAAC;AAGjD;;;GAGG;AACH,MAAM,WAAW,WAAW;IAC1B,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;IACtB,QAAQ,CAAC,KAAK,EAAE,MAAM,CAAC;IACvB,QAAQ,CAAC,KAAK,EAAE,MAAM,CAAC;CACxB;AAED;;;GAGG;AACH,MAAM,WAAW,YAAY;IAC3B,QAAQ,CAAC,QAAQ,EAAE,SAAS,WAAW,EAAE,CAAC;CAC3C;AAED;;;GAGG;AACH,MAAM,WAAW,YAAY;IAC3B,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;IACtB,QAAQ,CAAC,KAAK,EAAE,MAAM,CAAC;CACxB;AAED;;;;;;;;;;;;;;;;GAgBG;AACH,wBAAsB,eAAe,CACnC,QAAQ,EAAE,YAAY,EACtB,YAAY,EAAE,YAAY,GACzB,OAAO,CAAC,WAAW,EAAE,CAAC,CA4CxB;AAED;;;;;;;GAOG;AACH,wBAAsB,2BAA2B,CAC/C,QAAQ,EAAE;IAAE,QAAQ,CAAC,QAAQ,EAAE,SAAS,OAAO,EAAE,CAAA;CAAE,EACnD,YAAY,EAAE,OAAO,GACpB,OAAO,CAAC,OAAO,EAAE,CAAC,CAapB"}

package/dist/shared/task-utilities.js

@@ -0,0 +1,86 @@
+/**
+ * Task Utilities - Shared task identification logic
+ *
+ * This module provides shared utilities for task identification across tools,
+ * eliminating code duplication between task.ts, complete-task.ts, view-task.ts, and view-document.ts.
+ *
+ * Used by task.ts, complete-task.ts, view-task.ts, and view-document.ts for consistent task identification.
+ */
+import { isTaskSection } from './addressing-system.js';
+/**
+ * Extract task headings from a document's tasks section
+ *
+ * This function performs hierarchical task validation and depth calculations
+ * to identify task headings under a Tasks section. It uses the addressing system
+ * for consistent task validation across all tools.
+ *
+ * @param document - Document containing headings (supports CachedDocument or minimal interface)
+ * @param tasksSection - Tasks section heading (with slug and depth)
+ * @returns Promise resolving to array of task headings
+ *
+ * @example
+ * ```typescript
+ * const taskHeadings = await getTaskHeadings(document, tasksSection);
+ * console.log(`Found ${taskHeadings.length} tasks`);
+ * ```
+ */
+export async function getTaskHeadings(document, tasksSection) {
+    const taskHeadings = [];
+    const tasksIndex = document.headings.findIndex(h => h.slug === tasksSection.slug);
+    if (tasksIndex === -1)
+        return taskHeadings;
+    const targetDepth = tasksSection.depth + 1;
+    // Look at headings after the Tasks section using addressing system validation
+    for (let i = tasksIndex + 1; i < document.headings.length; i++) {
+        const heading = document.headings[i];
+        if (heading == null)
+            continue;
+        // If we hit a heading at the same or shallower depth as Tasks, we're done
+        if (heading.depth <= tasksSection.depth) {
+            break;
+        }
+        // If this is a direct child of Tasks section (depth = Tasks.depth + 1), it's a task
+        if (heading.depth === targetDepth) {
+            // Use addressing system to validate this is actually a task
+            // Convert headings to compatible format for isTaskSection
+            const compatibleDocument = {
+                headings: document.headings.map(h => ({
+                    slug: h.slug,
+                    title: h.title,
+                    depth: h.depth
+                }))
+            };
+            const isTask = await isTaskSection(heading.slug, compatibleDocument);
+            if (isTask) {
+                taskHeadings.push({
+                    slug: heading.slug,
+                    title: heading.title,
+                    depth: heading.depth
+                });
+            }
+        }
+        // Skip deeper nested headings (they are children of tasks, not tasks themselves)
+    }
+    return taskHeadings;
+}
+/**
+ * Convenience function for working with full Heading objects
+ * Returns full Heading objects for compatibility with existing tool code
+ *
+ * @param document - Document with full Heading objects
+ * @param tasksSection - Full Heading object for tasks section
+ * @returns Promise resolving to array of full Heading objects that are tasks
+ */
+export async function getTaskHeadingsFromHeadings(document, tasksSection) {
+    const taskHeadingInfos = await getTaskHeadings(document, tasksSection);
+    // Convert back to full Heading objects by finding matches in original headings
+    const taskHeadings = [];
+    for (const taskInfo of taskHeadingInfos) {
+        const fullHeading = document.headings.find(h => h.slug === taskInfo.slug);
+        if (fullHeading != null) {
+            taskHeadings.push(fullHeading);
+        }
+    }
+    return taskHeadings;
+}
+//# sourceMappingURL=task-utilities.js.map

package/dist/shared/task-utilities.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"task-utilities.js","sourceRoot":"","sources":["../../src/shared/task-utilities.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAGH,OAAO,EAAE,aAAa,EAAE,MAAM,wBAAwB,CAAC;AA6BvD;;;;;;;;;;;;;;;;GAgBG;AACH,MAAM,CAAC,KAAK,UAAU,eAAe,CACnC,QAAsB,EACtB,YAA0B;IAE1B,MAAM,YAAY,GAAkB,EAAE,CAAC;IACvC,MAAM,UAAU,GAAG,QAAQ,CAAC,QAAQ,CAAC,SAAS,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,IAAI,KAAK,YAAY,CAAC,IAAI,CAAC,CAAC;IAElF,IAAI,UAAU,KAAK,CAAC,CAAC;QAAE,OAAO,YAAY,CAAC;IAE3C,MAAM,WAAW,GAAG,YAAY,CAAC,KAAK,GAAG,CAAC,CAAC;IAE3C,8EAA8E;IAC9E,KAAK,IAAI,CAAC,GAAG,UAAU,GAAG,CAAC,EAAE,CAAC,GAAG,QAAQ,CAAC,QAAQ,CAAC,MAAM,EAAE,CAAC,EAAE,EAAE,CAAC;QAC/D,MAAM,OAAO,GAAG,QAAQ,CAAC,QAAQ,CAAC,CAAC,CAAC,CAAC;QACrC,IAAI,OAAO,IAAI,IAAI;YAAE,SAAS;QAE9B,0EAA0E;QAC1E,IAAI,OAAO,CAAC,KAAK,IAAI,YAAY,CAAC,KAAK,EAAE,CAAC;YACxC,MAAM;QACR,CAAC;QAED,oFAAoF;QACpF,IAAI,OAAO,CAAC,KAAK,KAAK,WAAW,EAAE,CAAC;YAClC,4DAA4D;YAC5D,0DAA0D;YAC1D,MAAM,kBAAkB,GAAG;gBACzB,QAAQ,EAAE,QAAQ,CAAC,QAAQ,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC;oBACpC,IAAI,EAAE,CAAC,CAAC,IAAI;oBACZ,KAAK,EAAE,CAAC,CAAC,KAAK;oBACd,KAAK,EAAE,CAAC,CAAC,KAAK;iBACf,CAAC,CAAC;aACJ,CAAC;YAEF,MAAM,MAAM,GAAG,MAAM,aAAa,CAAC,OAAO,CAAC,IAAI,EAAE,kBAAkB,CAAC,CAAC;YACrE,IAAI,MAAM,EAAE,CAAC;gBACX,YAAY,CAAC,IAAI,CAAC;oBAChB,IAAI,EAAE,OAAO,CAAC,IAAI;oBAClB,KAAK,EAAE,OAAO,CAAC,KAAK;oBACpB,KAAK,EAAE,OAAO,CAAC,KAAK;iBACrB,CAAC,CAAC;YACL,CAAC;QACH,CAAC;QAED,iFAAiF;IACnF,CAAC;IAED,OAAO,YAAY,CAAC;AACtB,CAAC;AAED;;;;;;;GAOG;AACH,MAAM,CAAC,KAAK,UAAU,2BAA2B,CAC/C,QAAmD,EACnD,YAAqB;IAErB,MAAM,gBAAgB,GAAG,MAAM,eAAe,CAAC,QAAQ,EAAE,YAAY,CAAC,CAAC;IAEvE,+EAA+E;IAC/E,MAAM,YAAY,GAAc,EAAE,CAAC;IACnC,KAAK,MAAM,QAAQ,IAAI,gBAAgB,EAAE,CAAC;QACxC,MAAM,WAAW,GAAG,QAAQ,CAAC,QAAQ,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,IAAI,KAAK,QAAQ,CAAC,IAAI,CAAC,CAAC;QAC1E,IAAI,WAAW,IAAI,IAAI,EAAE,CAAC;YACxB,YAAY,CAAC,IAAI,CAAC,WAAW,CAAC,CAAC;QACjC,CAAC;IACH,CAAC;IAED,OAAO,YAAY,CAAC;AACtB,CAAC"}

package/dist/shared/task-validation.d.ts

@@ -0,0 +1,50 @@
+/**
+ * Task validation layer for dual task system
+ *
+ * Provides validation functions for subagent (ad-hoc) and coordinator (sequential)
+ * task tools. These validators enforce namespace and mode restrictions to ensure
+ * correct tool usage.
+ *
+ * Validation Rules:
+ * - Subagent tasks: MUST include #slug, MUST be in /docs/ namespace
+ * - Coordinator tasks: MUST NOT include #slug, MUST be in /coordinator/ namespace
+ */
+/**
+ * Validate subagent task access (ad-hoc only)
+ *
+ * Rules:
+ * - MUST include taskSlug (ad-hoc mode required)
+ * - MUST be within /docs/ namespace
+ * - ERROR if sequential mode attempted
+ *
+ * @param documentPath - Path to the document
+ * @param taskSlug - Task slug (required for subagent)
+ * @throws {AddressingError} When validation fails
+ */
+export declare function validateSubagentTaskAccess(documentPath: string, taskSlug?: string): void;
+/**
+ * Validate coordinator task access (sequential only)
+ *
+ * Rules:
+ * - MUST NOT include taskSlug (sequential mode required)
+ * - MUST be in /.ai-prompt-guide/coordinator/ namespace
+ * - ERROR if ad-hoc mode attempted
+ *
+ * @param documentPath - Path to the document
+ * @param taskSlug - Task slug (must be undefined for coordinator)
+ * @throws {AddressingError} When validation fails
+ */
+export declare function validateCoordinatorTaskAccess(documentPath: string, taskSlug?: string): void;
+/**
+ * Validate Main-Workflow requirement for coordinator first task
+ * Warning only - doesn't throw, just logs
+ *
+ * This checks if the first task in a coordinator document has a Main-Workflow
+ * field. If missing, it logs a warning but doesn't block execution.
+ *
+ * @param isFirstTask - Whether this is the first task in the document
+ * @param hasMainWorkflow - Whether the task has a Main-Workflow field
+ * @param taskTitle - Title of the task for logging
+ */
+export declare function validateMainWorkflowPresence(isFirstTask: boolean, hasMainWorkflow: boolean, taskTitle: string): void;
+//# sourceMappingURL=task-validation.d.ts.map

package/dist/shared/task-validation.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"task-validation.d.ts","sourceRoot":"","sources":["../../src/shared/task-validation.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;GAUG;AAMH;;;;;;;;;;;GAWG;AACH,wBAAgB,0BAA0B,CACxC,YAAY,EAAE,MAAM,EACpB,QAAQ,CAAC,EAAE,MAAM,GAChB,IAAI,CAqBN;AAED;;;;;;;;;;;GAWG;AACH,wBAAgB,6BAA6B,CAC3C,YAAY,EAAE,MAAM,EACpB,QAAQ,CAAC,EAAE,MAAM,GAChB,IAAI,CAyBN;AAED;;;;;;;;;;GAUG;AACH,wBAAgB,4BAA4B,CAC1C,WAAW,EAAE,OAAO,EACpB,eAAe,EAAE,OAAO,EACxB,SAAS,EAAE,MAAM,GAChB,IAAI,CAgBN"}