ai-prompt-guide-mcp 1.0.0

package/dist/shared/slug-utils.js

@@ -0,0 +1,302 @@
+/**
+ * Hierarchical slug utilities for the Document Linking System
+ */
+import { titleToSlug } from '../slug.js';
+/**
+ * Generate a hierarchical slug by combining parent slug with child title
+ *
+ * @param parentSlug - Parent slug path (e.g., "api/endpoints")
+ * @param childTitle - Title to convert to slug and append
+ * @returns Combined hierarchical slug (e.g., "api/endpoints/users")
+ */
+export function generateHierarchicalSlug(parentSlug, childTitle) {
+    // Input validation
+    if (typeof childTitle !== 'string' || childTitle.trim() === '') {
+        throw new Error('Child title is required for hierarchical slug generation');
+    }
+    const childSlug = titleToSlug(childTitle);
+    // Handle empty or invalid parent slug
+    if (typeof parentSlug !== 'string' || parentSlug.trim() === '') {
+        return childSlug;
+    }
+    const normalizedParent = normalizeSlugPath(parentSlug);
+    // Combine parent and child with separator
+    return normalizedParent === '' ? childSlug : `${normalizedParent}/${childSlug}`;
+}
+/**
+ * Split a hierarchical slug path into component parts
+ *
+ * @param slugPath - Hierarchical slug path (e.g., "api/authentication/jwt-tokens")
+ * @returns Array of slug components (e.g., ["api", "authentication", "jwt-tokens"])
+ */
+export function splitSlugPath(slugPath) {
+    if (typeof slugPath !== 'string') {
+        return [];
+    }
+    const normalized = normalizeSlugPath(slugPath);
+    if (normalized === '') {
+        return [];
+    }
+    return normalized.split('/').filter(part => part !== '');
+}
+/**
+ * Join slug path components into a hierarchical slug
+ *
+ * @param parts - Array of slug components
+ * @returns Combined slug path with normalized separators
+ */
+export function joinSlugPath(parts) {
+    if (!Array.isArray(parts)) {
+        return '';
+    }
+    // Filter out empty parts and join with separator
+    const validParts = parts.filter(part => typeof part === 'string' && part.trim() !== '');
+    return validParts.join('/');
+}
+/**
+ * Get the depth (nesting level) of a hierarchical slug
+ *
+ * @param slugPath - Hierarchical slug path
+ * @returns Number of levels in the hierarchy (e.g., "api/auth/jwt" returns 3)
+ */
+export function getSlugDepth(slugPath) {
+    if (typeof slugPath !== 'string') {
+        return 0;
+    }
+    const normalized = normalizeSlugPath(slugPath);
+    if (normalized === '') {
+        return 0;
+    }
+    // Count slashes and add 1 for the number of segments
+    return (normalized.match(/\//g) ?? []).length + 1;
+}
+/**
+ * Get the parent slug from a hierarchical slug path
+ *
+ * @param slugPath - Hierarchical slug path (e.g., "api/auth/jwt")
+ * @returns Parent slug path (e.g., "api/auth") or undefined for top-level
+ */
+export function getParentSlug(slugPath) {
+    if (typeof slugPath !== 'string') {
+        return undefined;
+    }
+    const normalized = normalizeSlugPath(slugPath);
+    if (normalized === '') {
+        return undefined;
+    }
+    const lastSlash = normalized.lastIndexOf('/');
+    return lastSlash > 0 ? normalized.substring(0, lastSlash) : undefined;
+}
+/**
+ * Get the leaf (final) component of a hierarchical slug
+ *
+ * @param slugPath - Hierarchical slug path (e.g., "api/auth/jwt-tokens")
+ * @returns Leaf component (e.g., "jwt-tokens")
+ */
+export function getSlugLeaf(slugPath) {
+    if (typeof slugPath !== 'string') {
+        return '';
+    }
+    const normalized = normalizeSlugPath(slugPath);
+    if (normalized === '') {
+        return '';
+    }
+    const lastSlash = normalized.lastIndexOf('/');
+    return lastSlash >= 0 ? normalized.substring(lastSlash + 1) : normalized;
+}
+/**
+ * Create a complete hierarchical slug structure with metadata
+ *
+ * @param slugPath - Hierarchical slug path
+ * @returns HierarchicalSlug object with full structure information
+ */
+export function createHierarchicalSlug(slugPath) {
+    const normalized = normalizeSlugPath(slugPath);
+    const parts = splitSlugPath(normalized);
+    const depth = parts.length;
+    const parent = getParentSlug(normalized);
+    const result = {
+        full: normalized,
+        parts,
+        depth
+    };
+    if (parent != null) {
+        result.parent = parent;
+    }
+    return result;
+}
+/**
+ * Check if one slug is an ancestor of another
+ *
+ * @param ancestorSlug - Potential ancestor slug path
+ * @param descendantSlug - Potential descendant slug path
+ * @returns True if ancestor is a parent/grandparent/etc. of descendant
+ */
+export function isSlugAncestor(ancestorSlug, descendantSlug) {
+    const ancestorParts = splitSlugPath(ancestorSlug);
+    const descendantParts = splitSlugPath(descendantSlug);
+    // Ancestor must be shorter than descendant
+    if (ancestorParts.length >= descendantParts.length) {
+        return false;
+    }
+    // Check if all ancestor parts match descendant parts
+    return ancestorParts.every((part, index) => part === descendantParts[index]);
+}
+/**
+ * Check if one slug is a direct child of another
+ *
+ * @param parentSlug - Potential parent slug path
+ * @param childSlug - Potential child slug path
+ * @returns True if child is a direct child of parent (one level deeper)
+ */
+export function isDirectChild(parentSlug, childSlug) {
+    const parentParts = splitSlugPath(parentSlug);
+    const childParts = splitSlugPath(childSlug);
+    // Child must be exactly one level deeper
+    if (childParts.length !== parentParts.length + 1) {
+        return false;
+    }
+    // Check if all parent parts match child parts
+    return parentParts.every((part, index) => part === childParts[index]);
+}
+/**
+ * Get all direct children of a slug from a list of slugs
+ *
+ * @param parentSlug - Parent slug path
+ * @param allSlugs - Array of all available slug paths
+ * @returns Array of direct child slug paths
+ */
+export function getDirectChildren(parentSlug, allSlugs) {
+    if (!Array.isArray(allSlugs)) {
+        return [];
+    }
+    return allSlugs.filter(slug => isDirectChild(parentSlug, slug));
+}
+/**
+ * Get all descendants (children, grandchildren, etc.) of a slug
+ *
+ * @param ancestorSlug - Ancestor slug path
+ * @param allSlugs - Array of all available slug paths
+ * @returns Array of descendant slug paths
+ */
+export function getAllDescendants(ancestorSlug, allSlugs) {
+    if (!Array.isArray(allSlugs)) {
+        return [];
+    }
+    return allSlugs.filter(slug => isSlugAncestor(ancestorSlug, slug));
+}
+/**
+ * Calculate the relative path between two slug paths
+ *
+ * @param fromSlug - Source slug path
+ * @param toSlug - Target slug path
+ * @returns Relative path or operation result with error details
+ */
+export function getRelativeSlugPath(fromSlug, toSlug) {
+    try {
+        const fromParts = splitSlugPath(fromSlug);
+        const toParts = splitSlugPath(toSlug);
+        // Find common ancestor
+        let commonLength = 0;
+        while (commonLength < fromParts.length &&
+            commonLength < toParts.length &&
+            fromParts[commonLength] === toParts[commonLength]) {
+            commonLength++;
+        }
+        // Calculate relative path
+        const upLevels = fromParts.length - commonLength;
+        const downParts = toParts.slice(commonLength);
+        let relativePath = '';
+        // Add "up" navigation if needed
+        if (upLevels > 0) {
+            relativePath = '../'.repeat(upLevels);
+        }
+        // Add "down" navigation
+        if (downParts.length > 0) {
+            relativePath += downParts.join('/');
+        }
+        // Handle same-level case
+        if (relativePath === '') {
+            relativePath = '.';
+        }
+        return {
+            success: true,
+            result: relativePath
+        };
+    }
+    catch (error) {
+        return {
+            success: false,
+            error: error instanceof Error ? error.message : String(error),
+            context: { fromSlug, toSlug }
+        };
+    }
+}
+/**
+ * Validate a hierarchical slug path structure
+ *
+ * @param slugPath - Slug path to validate
+ * @returns Validation result with success status and details
+ */
+export function validateSlugPath(slugPath) {
+    if (typeof slugPath !== 'string') {
+        return {
+            success: false,
+            error: 'Slug path must be a string',
+            context: { slugPath, type: typeof slugPath }
+        };
+    }
+    if (slugPath.trim() === '') {
+        return {
+            success: false,
+            error: 'Slug path cannot be empty',
+            context: { slugPath }
+        };
+    }
+    const normalized = normalizeSlugPath(slugPath);
+    const parts = splitSlugPath(normalized);
+    // Check each part is a valid slug
+    // Pattern matches GitHub Slugger output: lowercase letters, numbers, underscores, hyphens
+    // - Must start/end with alphanumeric
+    // - Can contain underscores and single/multiple hyphens
+    // - Examples: 'api_endpoint', 'test-slug', 'multiple---hyphens'
+    for (const part of parts) {
+        if (!/^[a-z0-9]+[a-z0-9_-]*[a-z0-9]+$|^[a-z0-9]$/.test(part)) {
+            return {
+                success: false,
+                error: `Invalid slug component: ${part}. Must contain only lowercase letters, numbers, underscores, and hyphens`,
+                context: { slugPath, invalidPart: part }
+            };
+        }
+    }
+    // Check reasonable depth limit
+    if (parts.length > 10) {
+        return {
+            success: false,
+            error: 'Slug path too deep (maximum 10 levels)',
+            context: { slugPath, depth: parts.length }
+        };
+    }
+    return {
+        success: true,
+        result: normalized
+    };
+}
+/**
+ * Normalize a slug path by removing extra separators and ensuring consistent format
+ *
+ * @param slugPath - Raw slug path to normalize
+ * @returns Normalized slug path
+ */
+export function normalizeSlugPath(slugPath) {
+    if (typeof slugPath !== 'string') {
+        return '';
+    }
+    let normalized = slugPath.trim();
+    // Remove leading/trailing slashes
+    normalized = normalized.replace(/^\/+|\/+$/g, '');
+    // Replace multiple slashes with single slash
+    normalized = normalized.replace(/\/+/g, '/');
+    return normalized;
+}
+//# sourceMappingURL=slug-utils.js.map

package/dist/shared/slug-utils.js.map

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

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

@@ -0,0 +1,152 @@
+/**
+ * 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 type { DocumentManager } from '../document-manager.js';
+import type { HierarchicalContent } from './reference-loader.js';
+/**
+ * Hierarchical context for tasks
+ */
+export interface TaskHierarchicalContext {
+    full_path: string;
+    parent_path: string;
+    phase: string;
+    category: string;
+    task_name: string;
+    depth: number;
+}
+/**
+ * Task data structure returned by operations
+ */
+export interface TaskData {
+    slug: string;
+    title: string;
+    status: string;
+    link?: string;
+    dependencies?: string[];
+    hierarchical_context?: TaskHierarchicalContext;
+    referenced_documents?: HierarchicalContent[];
+    has_references?: boolean;
+}
+/**
+ * Result of list tasks operation
+ */
+export interface ListTasksResult {
+    tasks: TaskData[];
+    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;
+    };
+}
+/**
+ * Result of create task operation
+ */
+export interface CreateTaskResult {
+    slug: string;
+    title: string;
+    hierarchical_context?: TaskHierarchicalContext;
+}
+/**
+ * Result of complete task operation
+ */
+export interface CompleteTaskResult {
+    slug: string;
+    title: string;
+    note: string;
+    completed_date: string;
+}
+/**
+ * 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 declare function createTaskOperation(manager: DocumentManager, documentPath: string, title: string, content: string, referenceSlug?: string): Promise<CreateTaskResult>;
+/**
+ * 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 declare function editTaskOperation(manager: DocumentManager, documentPath: string, taskSlug: string, content: string): Promise<void>;
+/**
+ * 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 declare function listTasksOperation(manager: DocumentManager, documentPath: string, statusFilter?: string, loadReferences?: boolean): Promise<ListTasksResult>;
+/**
+ * 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 declare function completeTaskOperation(manager: DocumentManager, documentPath: string, taskSlug: string, note: string): Promise<CompleteTaskResult>;
+/**
+ * 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 declare function ensureTasksSectionOperation(manager: DocumentManager, docPath: string): Promise<void>;
+/**
+ * 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 declare function updateTaskStatus(content: string, newStatus: string, note: string, completedDate: string): string;
+//# sourceMappingURL=task-operations.d.ts.map

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

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