ai-prompt-guide-mcp 1.0.0

package/dist/tools/create/__tests__/file-creator.test.js

@@ -0,0 +1,138 @@
+/**
+ * Unit tests for file-creator.ts
+ * Tests document creation with Tasks section handling
+ */
+import { describe, it, expect, beforeEach, afterEach } from 'vitest';
+import { promises as fs } from 'node:fs';
+import path from 'node:path';
+import os from 'node:os';
+import { DocumentManager } from '../../../document-manager.js';
+import { DocumentCache } from '../../../document-cache.js';
+import { createDocumentFile } from '../file-creator.js';
+import { loadConfig } from '../../../config.js';
+import { rm, mkdir } from 'node:fs/promises';
+import { join } from 'node:path';
+describe('createDocumentFile', () => {
+    let manager;
+    let tempDir;
+    let cache;
+    let testDocsPath;
+    beforeEach(async () => {
+        // Create temporary directory for test files
+        tempDir = await fs.mkdtemp(path.join(os.tmpdir(), 'file-creator-test-'));
+        // Configure MCP_WORKSPACE_PATH for fsio PathHandler to use temp directory
+        process.env['MCP_WORKSPACE_PATH'] = tempDir;
+        const config = loadConfig();
+        testDocsPath = join(config.workspaceBasePath, 'test-file-creator');
+        // Create fresh test directory
+        try {
+            await rm(testDocsPath, { recursive: true, force: true });
+        }
+        catch {
+            // Ignore if doesn't exist
+        }
+        await mkdir(testDocsPath, { recursive: true });
+        cache = new DocumentCache(config.workspaceBasePath);
+        manager = new DocumentManager(config.workspaceBasePath, cache);
+    });
+    afterEach(async () => {
+        // Clean up temporary directory and all its contents
+        try {
+            await fs.rm(tempDir, { recursive: true, force: true });
+        }
+        catch {
+            // Ignore if directory doesn't exist
+        }
+    });
+    afterEach(async () => {
+        // Wait for any pending debounced operations (e.g., TOC updates)
+        await new Promise(resolve => setTimeout(resolve, 200));
+        // Destroy cache before cleanup
+        await cache.destroy();
+        // Clean up test directory
+        try {
+            await rm(testDocsPath, { recursive: true, force: true });
+        }
+        catch {
+            // Ignore cleanup errors
+        }
+    });
+    describe('Tasks section creation', () => {
+        it('should create document without Tasks section', async () => {
+            const content = '# Test Document\n\nTest overview.\n\n## Table of Contents\n';
+            const docPath = '/docs/test-file-creator/no-tasks.md';
+            const result = await createDocumentFile('test-file-creator', 'Test Document', 'Test overview', manager, content, docPath, 'test-document');
+            expect(result).toHaveProperty('success', true);
+            if ('success' in result && result.success) {
+                const document = await manager.getDocument(docPath);
+                expect(document).toBeDefined();
+                // Should not have Tasks section
+                const tasksHeading = document?.headings.find(h => h.title.toLowerCase() === 'tasks');
+                expect(tasksHeading).toBeUndefined();
+            }
+        });
+        it('should allow Tasks section to be created later via task tool', async () => {
+            // This test verifies that the task tool can auto-create the Tasks section
+            // when the first task is added (Unit 2 feature)
+            const content = '# Test Document\n\nTest overview.\n\n## Table of Contents\n';
+            const docPath = '/docs/test-file-creator/auto-tasks.md';
+            const result = await createDocumentFile('test-file-creator', 'Test Document', 'Test overview', manager, content, docPath, 'test-document');
+            expect(result).toHaveProperty('success', true);
+            if ('success' in result && result.success) {
+                // Import task tool functionality
+                const { subagentTask } = await import('../../implementations/subagent-task.js');
+                const mockSessionState = {
+                    sessionId: 'test-session',
+                    createDocumentStage: 0
+                };
+                // Create a task - should auto-create Tasks section (Unit 2 feature)
+                const taskResult = await subagentTask({
+                    document: docPath,
+                    operations: [{
+                            operation: 'create',
+                            title: 'First Task',
+                            content: 'Task description'
+                        }]
+                }, mockSessionState, manager);
+                // Verify task creation succeeded by checking operations_completed
+                expect(taskResult.operations_completed).toBe(1);
+                // Verify Tasks section was auto-created
+                const document = await manager.getDocument(docPath);
+                const tasksHeading = document?.headings.find(h => h.title.toLowerCase() === 'tasks');
+                expect(tasksHeading).toBeDefined();
+                expect(tasksHeading?.depth).toBe(2);
+            }
+        });
+    });
+    describe('Document creation validation', () => {
+        it('should reject invalid document path', async () => {
+            const content = '# Test\n\nContent\n';
+            const invalidPath = '../../../etc/passwd'; // Path traversal attempt
+            const result = await createDocumentFile('test-file-creator', 'Test', 'Content', manager, content, invalidPath, 'test');
+            expect(result).toHaveProperty('error');
+            if ('error' in result) {
+                expect(result.error).toContain('Invalid document path');
+            }
+        });
+        it('should handle empty content gracefully', async () => {
+            const content = '';
+            const docPath = '/docs/test-file-creator/empty.md';
+            const result = await createDocumentFile('test-file-creator', 'Empty Document', 'No content', manager, content, docPath, 'empty-document');
+            // Should succeed - empty documents are valid
+            expect(result).toHaveProperty('success', true);
+        });
+    });
+    describe('Cache refresh behavior', () => {
+        it('should refresh cache after document creation', async () => {
+            const content = '# Fresh Document\n\nContent here.\n\n## Table of Contents\n';
+            const docPath = '/docs/test-file-creator/fresh.md';
+            const result = await createDocumentFile('test-file-creator', 'Fresh Document', 'Content here', manager, content, docPath, 'fresh-document');
+            expect(result).toHaveProperty('success', true);
+            // Verify document is in cache and accessible
+            const document = await manager.getDocument(docPath);
+            expect(document).toBeDefined();
+            expect(document?.metadata.title).toBe('Fresh Document');
+        });
+    });
+});
+//# sourceMappingURL=file-creator.test.js.map

package/dist/tools/create/__tests__/file-creator.test.js.map

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

package/dist/tools/create/__tests__/template-processor.test.d.ts

@@ -0,0 +1,6 @@
+/**
+ * Unit tests for template-processor.ts
+ * Tests template processing and document path construction
+ */
+export {};
+//# sourceMappingURL=template-processor.test.d.ts.map

package/dist/tools/create/__tests__/template-processor.test.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"template-processor.test.d.ts","sourceRoot":"","sources":["../../../../src/tools/create/__tests__/template-processor.test.ts"],"names":[],"mappings":"AAAA;;;GAGG"}

package/dist/tools/create/__tests__/template-processor.test.js

@@ -0,0 +1,130 @@
+/**
+ * Unit tests for template-processor.ts
+ * Tests template processing and document path construction
+ */
+import { describe, it, expect, beforeEach, afterEach } from 'vitest';
+import { promises as fs } from 'node:fs';
+import path from 'node:path';
+import os from 'node:os';
+import { DocumentManager } from '../../../document-manager.js';
+import { DocumentCache } from '../../../document-cache.js';
+import { processTemplate } from '../template-processor.js';
+import { loadConfig } from '../../../config.js';
+describe('processTemplate', () => {
+    let manager;
+    let tempDir;
+    let cache;
+    beforeEach(async () => {
+        // Create temporary directory for test files
+        tempDir = await fs.mkdtemp(path.join(os.tmpdir(), 'template-processor-test-'));
+        // Configure MCP_WORKSPACE_PATH for fsio PathHandler to use temp directory
+        process.env['MCP_WORKSPACE_PATH'] = tempDir;
+        const config = loadConfig();
+        cache = new DocumentCache(config.workspaceBasePath);
+        manager = new DocumentManager(config.workspaceBasePath, cache);
+    });
+    afterEach(async () => {
+        // Wait for any pending debounced operations
+        await new Promise(resolve => setTimeout(resolve, 200));
+        // Destroy cache before cleanup
+        await cache.destroy();
+        // Clean up temporary directory and all its contents
+        try {
+            await fs.rm(tempDir, { recursive: true, force: true });
+        }
+        catch {
+            // Ignore if directory doesn't exist
+        }
+    });
+    describe('Document path construction', () => {
+        it('should NOT include /docs/ prefix for simple namespace', async () => {
+            const result = await processTemplate('api', 'Authentication Guide', 'Overview of authentication', manager);
+            expect(result).not.toHaveProperty('error');
+            if ('docPath' in result) {
+                expect(result.docPath).toBe('/api/authentication-guide.md');
+                expect(result.docPath).not.toContain('/docs/api');
+            }
+        });
+        it('should NOT include /docs/ prefix for nested namespace', async () => {
+            const result = await processTemplate('api/endpoints', 'User Endpoints', 'User API endpoints', manager);
+            expect(result).not.toHaveProperty('error');
+            if ('docPath' in result) {
+                expect(result.docPath).toBe('/api/endpoints/user-endpoints.md');
+                expect(result.docPath).not.toContain('/docs/');
+            }
+        });
+        it('should NOT double-prefix when namespace already contains "docs"', async () => {
+            const result = await processTemplate('docs/api', 'Security Guide', 'Security documentation', manager);
+            expect(result).not.toHaveProperty('error');
+            if ('docPath' in result) {
+                expect(result.docPath).toBe('/docs/api/security-guide.md');
+                expect(result.docPath).not.toContain('/docs/docs/');
+            }
+        });
+        it('should handle context-optimization namespace without /docs/ prefix', async () => {
+            const result = await processTemplate('context-optimization', 'Optimization Guide', 'Context optimization techniques', manager);
+            expect(result).not.toHaveProperty('error');
+            if ('docPath' in result) {
+                expect(result.docPath).toBe('/context-optimization/optimization-guide.md');
+                expect(result.docPath).not.toContain('/docs/');
+            }
+        });
+        it('should maintain coordinator namespace handling', async () => {
+            const result = await processTemplate('coordinator', 'Active Tasks', 'Coordinator task list', manager);
+            expect(result).not.toHaveProperty('error');
+            if ('docPath' in result) {
+                expect(result.docPath).toBe('/coordinator/active-tasks.md');
+            }
+        });
+        it('should handle coordinator/subpath namespace', async () => {
+            const result = await processTemplate('coordinator/planning', 'Project Plan', 'Planning documents', manager);
+            expect(result).not.toHaveProperty('error');
+            if ('docPath' in result) {
+                expect(result.docPath).toBe('/coordinator/project-plan.md');
+            }
+        });
+    });
+    describe('Template content generation', () => {
+        it('should generate blank document with title and overview', async () => {
+            const result = await processTemplate('test', 'Test Document', 'Test overview content', manager);
+            expect(result).not.toHaveProperty('error');
+            expect(result.content).toBe('# Test Document\n\nTest overview content');
+            expect(result.slug).toBe('test-document');
+        });
+        it('should handle multi-line overview content', async () => {
+            const overview = 'First line\n\nSecond paragraph\n\nThird paragraph';
+            const result = await processTemplate('test', 'Multi-line Test', overview, manager);
+            expect(result).not.toHaveProperty('error');
+            expect(result.content).toContain(overview);
+        });
+        it('should generate consistent slugs from titles', async () => {
+            const result = await processTemplate('test', 'My API Documentation', 'Overview', manager);
+            expect(result).not.toHaveProperty('error');
+            expect(result.slug).toBe('my-api-documentation');
+        });
+    });
+    describe('Edge cases', () => {
+        it('should handle namespace with leading slash', async () => {
+            const result = await processTemplate('/api', 'Test', 'Overview', manager);
+            expect(result).not.toHaveProperty('error');
+            if ('docPath' in result) {
+                expect(result.docPath).toBe('/api/test.md');
+            }
+        });
+        it('should handle namespace with trailing slash', async () => {
+            const result = await processTemplate('api/', 'Test', 'Overview', manager);
+            expect(result).not.toHaveProperty('error');
+            if ('docPath' in result) {
+                expect(result.docPath).toBe('/api/test.md');
+            }
+        });
+        it('should handle empty namespace', async () => {
+            const result = await processTemplate('', 'Root Document', 'At root level', manager);
+            expect(result).not.toHaveProperty('error');
+            if ('docPath' in result) {
+                expect(result.docPath).toBe('/root-document.md');
+            }
+        });
+    });
+});
+//# sourceMappingURL=template-processor.test.js.map

package/dist/tools/create/__tests__/template-processor.test.js.map

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

package/dist/tools/create/file-creator.d.ts

@@ -0,0 +1,35 @@
+/**
+ * File creator for create-document pipeline
+ * Handles Stage 1 (Creation) file system operations and finalization
+ */
+import type { DocumentManager } from '../../document-manager.js';
+/**
+ * Document creation result - simplified response
+ */
+export interface DocumentCreationResult {
+    success: boolean;
+    document: string;
+    slug: string;
+    next_step: string;
+}
+/**
+ * File creation error result
+ */
+export interface FileCreationError {
+    error: string;
+    details: string;
+    provided_parameters: {
+        namespace: string;
+        title: string;
+        overview: string;
+    };
+}
+/**
+ * Create document with structured content
+ */
+export declare function createDocumentFile(namespace: string, title: string, overview: string, manager: DocumentManager, content: string, docPath: string, slug: string): Promise<DocumentCreationResult | FileCreationError>;
+/**
+ * Validate document creation prerequisites
+ */
+export declare function validateCreationPrerequisites(namespace: string, title: string, overview: string, _manager: DocumentManager): Promise<string | null>;
+//# sourceMappingURL=file-creator.d.ts.map

package/dist/tools/create/file-creator.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"file-creator.d.ts","sourceRoot":"","sources":["../../../src/tools/create/file-creator.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAEH,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,2BAA2B,CAAC;AAGjE;;GAEG;AACH,MAAM,WAAW,sBAAsB;IACrC,OAAO,EAAE,OAAO,CAAC;IACjB,QAAQ,EAAE,MAAM,CAAC;IACjB,IAAI,EAAE,MAAM,CAAC;IACb,SAAS,EAAE,MAAM,CAAC;CACnB;AAED;;GAEG;AACH,MAAM,WAAW,iBAAiB;IAChC,KAAK,EAAE,MAAM,CAAC;IACd,OAAO,EAAE,MAAM,CAAC;IAChB,mBAAmB,EAAE;QACnB,SAAS,EAAE,MAAM,CAAC;QAClB,KAAK,EAAE,MAAM,CAAC;QACd,QAAQ,EAAE,MAAM,CAAC;KAClB,CAAC;CACH;AAED;;GAEG;AACH,wBAAsB,kBAAkB,CACtC,SAAS,EAAE,MAAM,EACjB,KAAK,EAAE,MAAM,EACb,QAAQ,EAAE,MAAM,EAChB,OAAO,EAAE,eAAe,EACxB,OAAO,EAAE,MAAM,EACf,OAAO,EAAE,MAAM,EACf,IAAI,EAAE,MAAM,GACX,OAAO,CAAC,sBAAsB,GAAG,iBAAiB,CAAC,CA2DrD;AA2BD;;GAEG;AACH,wBAAsB,6BAA6B,CACjD,SAAS,EAAE,MAAM,EACjB,KAAK,EAAE,MAAM,EACb,QAAQ,EAAE,MAAM,EAChB,QAAQ,EAAE,eAAe,GACxB,OAAO,CAAC,MAAM,GAAG,IAAI,CAAC,CAgBxB"}

package/dist/tools/create/file-creator.js

@@ -0,0 +1,103 @@
+/**
+ * File creator for create-document pipeline
+ * Handles Stage 1 (Creation) file system operations and finalization
+ */
+import { parseDocumentAddress, AddressingError } from '../../shared/addressing-system.js';
+/**
+ * Create document with structured content
+ */
+export async function createDocumentFile(namespace, title, overview, manager, content, docPath, slug) {
+    try {
+        // Validate the document path using addressing system
+        try {
+            parseDocumentAddress(docPath);
+        }
+        catch (error) {
+            if (error instanceof AddressingError) {
+                return {
+                    error: 'Invalid document path for creation',
+                    details: error.message,
+                    provided_parameters: {
+                        namespace,
+                        title,
+                        overview
+                    }
+                };
+            }
+            throw error; // Re-throw non-addressing errors
+        }
+        // Create the document with basic structure first
+        await manager.createDocument(docPath, {
+            title,
+            template: 'blank', // We're providing our own structure
+            features: {
+                toc: false, // No TOC - user can add manually if needed
+                anchors: true,
+                codeHighlight: true,
+                mermaid: true,
+                searchIndex: true
+            }
+        });
+        // Write the structured content to the file
+        await writeDocumentContent(manager, docPath, content);
+        // Refresh the cache to get the updated document
+        await refreshDocumentCache(manager, docPath);
+        // Return simplified response with minimal next-step guidance
+        return {
+            success: true,
+            document: docPath,
+            slug,
+            next_step: 'Use section tool with append_child on the slug to add first section'
+        };
+    }
+    catch (error) {
+        const message = error instanceof Error ? error.message : String(error);
+        return {
+            error: 'Failed to create document',
+            details: message,
+            provided_parameters: {
+                namespace,
+                title,
+                overview
+            }
+        };
+    }
+}
+/**
+ * Write content to document file
+ */
+async function writeDocumentContent(manager, docPath, content) {
+    const fs = await import('node:fs/promises');
+    const path = await import('node:path');
+    // Get the docs root from the manager (supports testing with custom paths)
+    const docsRoot = manager.docsRoot;
+    const fullPath = path.join(docsRoot, docPath);
+    // Ensure parent directory exists
+    const parentDir = path.dirname(fullPath);
+    await fs.mkdir(parentDir, { recursive: true });
+    await fs.writeFile(fullPath, content, 'utf8');
+}
+/**
+ * Refresh document cache after creation
+ */
+async function refreshDocumentCache(manager, docPath) {
+    manager.cache.invalidateDocument(docPath);
+}
+/**
+ * Validate document creation prerequisites
+ */
+export async function validateCreationPrerequisites(namespace, title, overview, _manager) {
+    // Basic input validation
+    if (namespace.trim() === '') {
+        return 'Namespace cannot be empty';
+    }
+    if (title.trim() === '') {
+        return 'Title cannot be empty';
+    }
+    if (overview.trim() === '') {
+        return 'Overview cannot be empty';
+    }
+    // Manager is already validated at the pipeline level
+    return null; // No validation errors
+}
+//# sourceMappingURL=file-creator.js.map

package/dist/tools/create/file-creator.js.map

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

package/dist/tools/create/index.d.ts

@@ -0,0 +1,6 @@
+/**
+ * Public API for create document pipeline
+ */
+export { executeCreateDocumentPipeline } from './pipeline.js';
+export type { PipelineResult, CreationErrorResult } from './pipeline.js';
+//# sourceMappingURL=index.d.ts.map

package/dist/tools/create/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/tools/create/index.ts"],"names":[],"mappings":"AAAA;;GAEG;AAEH,OAAO,EAAE,6BAA6B,EAAE,MAAM,eAAe,CAAC;AAC9D,YAAY,EAAE,cAAc,EAAE,mBAAmB,EAAE,MAAM,eAAe,CAAC"}

package/dist/tools/create/index.js

@@ -0,0 +1,7 @@
+/**
+ * Public API for create document pipeline
+ */
+export { executeCreateDocumentPipeline } from './pipeline.js';
+// All internal pipeline implementation details are now private
+// to maintain proper encapsulation and avoid over-exposing internals
+//# sourceMappingURL=index.js.map

package/dist/tools/create/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../src/tools/create/index.ts"],"names":[],"mappings":"AAAA;;GAEG;AAEH,OAAO,EAAE,6BAA6B,EAAE,MAAM,eAAe,CAAC;AAG9D,+DAA+D;AAC/D,qEAAqE"}

package/dist/tools/create/pipeline.d.ts

@@ -0,0 +1,39 @@
+/**
+ * Pipeline orchestrator for create-document
+ * Coordinates all stages of the progressive discovery flow (2-stage: discovery -> creation)
+ */
+import type { SessionState } from '../../session/types.js';
+import type { DocumentManager } from '../../document-manager.js';
+import { type ValidationResult } from './validation-processor.js';
+import { type DocumentCreationResult } from './file-creator.js';
+/**
+ * All possible pipeline results
+ */
+export type PipelineResult = ValidationResult | DocumentCreationResult | CreationErrorResult;
+/**
+ * Creation error result with helpful recovery guidance
+ */
+export interface CreationErrorResult {
+    stage: 'error_fallback';
+    error: string;
+    details: string;
+    provided_parameters: {
+        namespace: string;
+        title: string;
+        overview: string;
+    };
+    help: string;
+    suggestion: string;
+    recovery_steps: string[];
+    example: {
+        namespace: string;
+        title: string;
+        overview: string;
+    };
+}
+/**
+ * Main pipeline orchestrator function
+ * Handles all stages of the progressive discovery pattern (0 -> 1)
+ */
+export declare function executeCreateDocumentPipeline(args: Record<string, unknown>, state: SessionState, manager: DocumentManager, onStageChange?: () => void): Promise<PipelineResult>;
+//# sourceMappingURL=pipeline.d.ts.map

package/dist/tools/create/pipeline.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"pipeline.d.ts","sourceRoot":"","sources":["../../../src/tools/create/pipeline.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAEH,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,wBAAwB,CAAC;AAC3D,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,2BAA2B,CAAC;AAOjE,OAAO,EAGL,KAAK,gBAAgB,EACtB,MAAM,2BAA2B,CAAC;AAMnC,OAAO,EAGL,KAAK,sBAAsB,EAC5B,MAAM,mBAAmB,CAAC;AAE3B;;GAEG;AACH,MAAM,MAAM,cAAc,GACtB,gBAAgB,GAChB,sBAAsB,GACtB,mBAAmB,CAAC;AAExB;;GAEG;AACH,MAAM,WAAW,mBAAmB;IAClC,KAAK,EAAE,gBAAgB,CAAC;IACxB,KAAK,EAAE,MAAM,CAAC;IACd,OAAO,EAAE,MAAM,CAAC;IAChB,mBAAmB,EAAE;QACnB,SAAS,EAAE,MAAM,CAAC;QAClB,KAAK,EAAE,MAAM,CAAC;QACd,QAAQ,EAAE,MAAM,CAAC;KAClB,CAAC;IACF,IAAI,EAAE,MAAM,CAAC;IACb,UAAU,EAAE,MAAM,CAAC;IACnB,cAAc,EAAE,MAAM,EAAE,CAAC;IACzB,OAAO,EAAE;QACP,SAAS,EAAE,MAAM,CAAC;QAClB,KAAK,EAAE,MAAM,CAAC;QACd,QAAQ,EAAE,MAAM,CAAC;KAClB,CAAC;CACH;AAED;;;GAGG;AACH,wBAAsB,6BAA6B,CACjD,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,cAAc,CAAC,CA+CzB"}

package/dist/tools/create/pipeline.js

@@ -0,0 +1,112 @@
+/**
+ * Pipeline orchestrator for create-document
+ * Coordinates all stages of the progressive discovery flow (2-stage: discovery -> creation)
+ */
+import { determineCreateDocumentStage, getNextCreateDocumentStage } from '../schemas/create-document-schemas.js';
+import { getGlobalSessionStore } from '../../session/session-store.js';
+import { processDiscovery, validateNamespaceForCreation } from './validation-processor.js';
+import { processTemplate } from './template-processor.js';
+import { createDocumentFile, validateCreationPrerequisites } from './file-creator.js';
+/**
+ * Main pipeline orchestrator function
+ * Handles all stages of the progressive discovery pattern (0 -> 1)
+ */
+export async function executeCreateDocumentPipeline(args, state, manager, onStageChange) {
+    // Extract parameters
+    const namespace = args['namespace'];
+    const title = args['title'];
+    const overview = args['overview'];
+    // Get the global session store singleton
+    const sessionStore = getGlobalSessionStore();
+    // Determine current stage and update session if needed
+    const currentStage = determineCreateDocumentStage(args);
+    if (currentStage !== state.createDocumentStage) {
+        sessionStore.updateSession(state.sessionId, { createDocumentStage: currentStage });
+        // Trigger tool list update notification
+        if (onStageChange != null) {
+            onStageChange();
+        }
+    }
+    // STAGE 0: Discovery - Return available document namespaces
+    if (namespace == null || title == null || overview == null) {
+        // Update to next stage for tool list
+        const nextStage = getNextCreateDocumentStage(currentStage);
+        if (nextStage !== currentStage) {
+            sessionStore.updateSession(state.sessionId, { createDocumentStage: nextStage });
+            if (onStageChange != null) {
+                onStageChange();
+            }
+        }
+        return processDiscovery();
+    }
+    // STAGE 1: Creation - Create the document immediately
+    // Update to creation stage for tool list
+    const nextStage = getNextCreateDocumentStage(1);
+    if (nextStage !== state.createDocumentStage) {
+        sessionStore.updateSession(state.sessionId, { createDocumentStage: nextStage });
+        if (onStageChange != null) {
+            onStageChange();
+        }
+    }
+    return await executeCreationStage(namespace, title, overview, manager);
+}
+/**
+ * Execute Stage 1: Document Creation
+ */
+async function executeCreationStage(namespace, title, overview, manager) {
+    try {
+        // Validate prerequisites
+        const validationError = await validateCreationPrerequisites(namespace, title, overview, manager);
+        if (validationError != null) {
+            return createCreationErrorResult('Prerequisites validation failed', validationError, namespace, title, overview);
+        }
+        // Validate namespace for creation
+        const namespaceError = validateNamespaceForCreation(namespace);
+        if (namespaceError != null) {
+            return createCreationErrorResult(namespaceError.error, namespaceError.help, namespace, title, overview);
+        }
+        // Process template
+        const templateResult = await processTemplate(namespace, title, overview, manager);
+        if ('error' in templateResult) {
+            return createCreationErrorResult(templateResult.error, templateResult.details, namespace, title, overview);
+        }
+        // Create document file
+        const creationResult = await createDocumentFile(namespace, title, overview, manager, templateResult.content, templateResult.docPath, templateResult.slug);
+        if ('error' in creationResult) {
+            return createCreationErrorResult(creationResult.error, creationResult.details, namespace, title, overview);
+        }
+        return creationResult;
+    }
+    catch (error) {
+        const message = error instanceof Error ? error.message : String(error);
+        return createCreationErrorResult('Unexpected error during creation', message, namespace, title, overview);
+    }
+}
+/**
+ * Create standardized creation error result
+ */
+function createCreationErrorResult(error, details, namespace, title, overview) {
+    return {
+        stage: 'error_fallback',
+        error,
+        details,
+        provided_parameters: {
+            namespace,
+            title,
+            overview
+        },
+        help: 'Document creation failed. Please check your parameters and try again.',
+        suggestion: 'Start over with the discovery flow for guidance',
+        recovery_steps: [
+            'Call create_document with no parameters to see available namespaces',
+            'Call create_document with just { "namespace": "your_namespace" } for instructions',
+            'Call create_document with all required parameters: namespace, title, and overview'
+        ],
+        example: {
+            namespace: "api/specs",
+            title: "Search API",
+            overview: "Full-text search capabilities"
+        }
+    };
+}
+//# sourceMappingURL=pipeline.js.map

package/dist/tools/create/pipeline.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"pipeline.js","sourceRoot":"","sources":["../../../src/tools/create/pipeline.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAIH,OAAO,EACL,4BAA4B,EAC5B,0BAA0B,EAC3B,MAAM,uCAAuC,CAAC;AAC/C,OAAO,EAAE,qBAAqB,EAAE,MAAM,gCAAgC,CAAC;AAEvE,OAAO,EACL,gBAAgB,EAChB,4BAA4B,EAE7B,MAAM,2BAA2B,CAAC;AAEnC,OAAO,EACL,eAAe,EAChB,MAAM,yBAAyB,CAAC;AAEjC,OAAO,EACL,kBAAkB,EAClB,6BAA6B,EAE9B,MAAM,mBAAmB,CAAC;AAgC3B;;;GAGG;AACH,MAAM,CAAC,KAAK,UAAU,6BAA6B,CACjD,IAA6B,EAC7B,KAAmB,EACnB,OAAwB,EACxB,aAA0B;IAE1B,qBAAqB;IACrB,MAAM,SAAS,GAAG,IAAI,CAAC,WAAW,CAAuB,CAAC;IAC1D,MAAM,KAAK,GAAG,IAAI,CAAC,OAAO,CAAuB,CAAC;IAClD,MAAM,QAAQ,GAAG,IAAI,CAAC,UAAU,CAAuB,CAAC;IAExD,yCAAyC;IACzC,MAAM,YAAY,GAAG,qBAAqB,EAAE,CAAC;IAE7C,uDAAuD;IACvD,MAAM,YAAY,GAAG,4BAA4B,CAAC,IAAI,CAAC,CAAC;IACxD,IAAI,YAAY,KAAK,KAAK,CAAC,mBAAmB,EAAE,CAAC;QAC/C,YAAY,CAAC,aAAa,CAAC,KAAK,CAAC,SAAS,EAAE,EAAE,mBAAmB,EAAE,YAAY,EAAE,CAAC,CAAC;QAEnF,wCAAwC;QACxC,IAAI,aAAa,IAAI,IAAI,EAAE,CAAC;YAC1B,aAAa,EAAE,CAAC;QAClB,CAAC;IACH,CAAC;IAED,4DAA4D;IAC5D,IAAI,SAAS,IAAI,IAAI,IAAI,KAAK,IAAI,IAAI,IAAI,QAAQ,IAAI,IAAI,EAAE,CAAC;QAC3D,qCAAqC;QACrC,MAAM,SAAS,GAAG,0BAA0B,CAAC,YAAY,CAAC,CAAC;QAC3D,IAAI,SAAS,KAAK,YAAY,EAAE,CAAC;YAC/B,YAAY,CAAC,aAAa,CAAC,KAAK,CAAC,SAAS,EAAE,EAAE,mBAAmB,EAAE,SAAS,EAAE,CAAC,CAAC;YAEhF,IAAI,aAAa,IAAI,IAAI,EAAE,CAAC;gBAC1B,aAAa,EAAE,CAAC;YAClB,CAAC;QACH,CAAC;QAED,OAAO,gBAAgB,EAAE,CAAC;IAC5B,CAAC;IAED,sDAAsD;IACtD,yCAAyC;IACzC,MAAM,SAAS,GAAG,0BAA0B,CAAC,CAAC,CAAC,CAAC;IAChD,IAAI,SAAS,KAAK,KAAK,CAAC,mBAAmB,EAAE,CAAC;QAC5C,YAAY,CAAC,aAAa,CAAC,KAAK,CAAC,SAAS,EAAE,EAAE,mBAAmB,EAAE,SAAS,EAAE,CAAC,CAAC;QAEhF,IAAI,aAAa,IAAI,IAAI,EAAE,CAAC;YAC1B,aAAa,EAAE,CAAC;QAClB,CAAC;IACH,CAAC;IAED,OAAO,MAAM,oBAAoB,CAAC,SAAS,EAAE,KAAK,EAAE,QAAQ,EAAE,OAAO,CAAC,CAAC;AACzE,CAAC;AAED;;GAEG;AACH,KAAK,UAAU,oBAAoB,CACjC,SAAiB,EACjB,KAAa,EACb,QAAgB,EAChB,OAAwB;IAExB,IAAI,CAAC;QACH,yBAAyB;QACzB,MAAM,eAAe,GAAG,MAAM,6BAA6B,CAAC,SAAS,EAAE,KAAK,EAAE,QAAQ,EAAE,OAAO,CAAC,CAAC;QACjG,IAAI,eAAe,IAAI,IAAI,EAAE,CAAC;YAC5B,OAAO,yBAAyB,CAC9B,iCAAiC,EACjC,eAAe,EACf,SAAS,EACT,KAAK,EACL,QAAQ,CACT,CAAC;QACJ,CAAC;QAED,kCAAkC;QAClC,MAAM,cAAc,GAAG,4BAA4B,CAAC,SAAS,CAAC,CAAC;QAC/D,IAAI,cAAc,IAAI,IAAI,EAAE,CAAC;YAC3B,OAAO,yBAAyB,CAC9B,cAAc,CAAC,KAAK,EACpB,cAAc,CAAC,IAAI,EACnB,SAAS,EACT,KAAK,EACL,QAAQ,CACT,CAAC;QACJ,CAAC;QAED,mBAAmB;QACnB,MAAM,cAAc,GAAG,MAAM,eAAe,CAAC,SAAS,EAAE,KAAK,EAAE,QAAQ,EAAE,OAAO,CAAC,CAAC;QAClF,IAAI,OAAO,IAAI,cAAc,EAAE,CAAC;YAC9B,OAAO,yBAAyB,CAC9B,cAAc,CAAC,KAAK,EACpB,cAAc,CAAC,OAAO,EACtB,SAAS,EACT,KAAK,EACL,QAAQ,CACT,CAAC;QACJ,CAAC;QAED,uBAAuB;QACvB,MAAM,cAAc,GAAG,MAAM,kBAAkB,CAC7C,SAAS,EACT,KAAK,EACL,QAAQ,EACR,OAAO,EACP,cAAc,CAAC,OAAO,EACtB,cAAc,CAAC,OAAO,EACtB,cAAc,CAAC,IAAI,CACpB,CAAC;QAEF,IAAI,OAAO,IAAI,cAAc,EAAE,CAAC;YAC9B,OAAO,yBAAyB,CAC9B,cAAc,CAAC,KAAK,EACpB,cAAc,CAAC,OAAO,EACtB,SAAS,EACT,KAAK,EACL,QAAQ,CACT,CAAC;QACJ,CAAC;QAED,OAAO,cAAc,CAAC;IAExB,CAAC;IAAC,OAAO,KAAK,EAAE,CAAC;QACf,MAAM,OAAO,GAAG,KAAK,YAAY,KAAK,CAAC,CAAC,CAAC,KAAK,CAAC,OAAO,CAAC,CAAC,CAAC,MAAM,CAAC,KAAK,CAAC,CAAC;QACvE,OAAO,yBAAyB,CAC9B,kCAAkC,EAClC,OAAO,EACP,SAAS,EACT,KAAK,EACL,QAAQ,CACT,CAAC;IACJ,CAAC;AACH,CAAC;AAED;;GAEG;AACH,SAAS,yBAAyB,CAChC,KAAa,EACb,OAAe,EACf,SAAiB,EACjB,KAAa,EACb,QAAgB;IAEhB,OAAO;QACL,KAAK,EAAE,gBAAgB;QACvB,KAAK;QACL,OAAO;QACP,mBAAmB,EAAE;YACnB,SAAS;YACT,KAAK;YACL,QAAQ;SACT;QACD,IAAI,EAAE,uEAAuE;QAC7E,UAAU,EAAE,iDAAiD;QAC7D,cAAc,EAAE;YACd,qEAAqE;YACrE,mFAAmF;YACnF,mFAAmF;SACpF;QACD,OAAO,EAAE;YACP,SAAS,EAAE,WAAW;YACtB,KAAK,EAAE,YAAY;YACnB,QAAQ,EAAE,+BAA+B;SAC1C;KACF,CAAC;AACJ,CAAC"}