ai-prompt-guide-mcp 1.0.0

package/dist/tools/create/suggestion-generator.d.ts

@@ -0,0 +1,47 @@
+/**
+ * Suggestion generator for create-document pipeline
+ * Handles Stage 2.5 (Smart Suggestions) analysis and recommendations
+ */
+import { analyzeDocumentSuggestions, analyzeNamespacePatterns } from '../../shared/utilities.js';
+/**
+ * Smart suggestions result for Stage 2.5
+ */
+export interface SmartSuggestionsResult {
+    stage: 'smart_suggestions';
+    suggestions: Awaited<ReturnType<typeof analyzeDocumentSuggestions>>;
+    namespace_patterns: Awaited<ReturnType<typeof analyzeNamespacePatterns>>;
+    next_step: string;
+    example: {
+        namespace: string;
+        title: string;
+        overview: string;
+        create: boolean;
+    };
+}
+/**
+ * Error result for suggestions analysis
+ */
+export interface SuggestionsErrorResult {
+    stage: 'error_fallback';
+    error: string;
+    details: string;
+    provided_parameters: {
+        namespace: string;
+        title: string;
+        overview: string;
+    };
+    help: string;
+    recovery_steps: string[];
+    example: {
+        namespace: string;
+        title: string;
+        overview: string;
+        create: boolean;
+    };
+}
+export type SuggestionsResult = SmartSuggestionsResult | SuggestionsErrorResult;
+/**
+ * Process Stage 2.5: Smart Suggestions - Analyze and suggest related documents
+ */
+export declare function processSuggestions(namespace: string, title: string, overview: string): Promise<SuggestionsResult>;
+//# sourceMappingURL=suggestion-generator.d.ts.map

package/dist/tools/create/suggestion-generator.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"suggestion-generator.d.ts","sourceRoot":"","sources":["../../../src/tools/create/suggestion-generator.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAEH,OAAO,EAAsB,0BAA0B,EAAE,wBAAwB,EAAE,MAAM,2BAA2B,CAAC;AAErH;;GAEG;AACH,MAAM,WAAW,sBAAsB;IACrC,KAAK,EAAE,mBAAmB,CAAC;IAC3B,WAAW,EAAE,OAAO,CAAC,UAAU,CAAC,OAAO,0BAA0B,CAAC,CAAC,CAAC;IACpE,kBAAkB,EAAE,OAAO,CAAC,UAAU,CAAC,OAAO,wBAAwB,CAAC,CAAC,CAAC;IACzE,SAAS,EAAE,MAAM,CAAC;IAClB,OAAO,EAAE;QACP,SAAS,EAAE,MAAM,CAAC;QAClB,KAAK,EAAE,MAAM,CAAC;QACd,QAAQ,EAAE,MAAM,CAAC;QACjB,MAAM,EAAE,OAAO,CAAC;KACjB,CAAC;CACH;AAED;;GAEG;AACH,MAAM,WAAW,sBAAsB;IACrC,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,cAAc,EAAE,MAAM,EAAE,CAAC;IACzB,OAAO,EAAE;QACP,SAAS,EAAE,MAAM,CAAC;QAClB,KAAK,EAAE,MAAM,CAAC;QACd,QAAQ,EAAE,MAAM,CAAC;QACjB,MAAM,EAAE,OAAO,CAAC;KACjB,CAAC;CACH;AAGD,MAAM,MAAM,iBAAiB,GAAG,sBAAsB,GAAG,sBAAsB,CAAC;AAEhF;;GAEG;AACH,wBAAsB,kBAAkB,CACtC,SAAS,EAAE,MAAM,EACjB,KAAK,EAAE,MAAM,EACb,QAAQ,EAAE,MAAM,GACf,OAAO,CAAC,iBAAiB,CAAC,CA2C5B"}

package/dist/tools/create/suggestion-generator.js

@@ -0,0 +1,51 @@
+/**
+ * Suggestion generator for create-document pipeline
+ * Handles Stage 2.5 (Smart Suggestions) analysis and recommendations
+ */
+import { getDocumentManager, analyzeDocumentSuggestions, analyzeNamespacePatterns } from '../../shared/utilities.js';
+/**
+ * Process Stage 2.5: Smart Suggestions - Analyze and suggest related documents
+ */
+export async function processSuggestions(namespace, title, overview) {
+    try {
+        const manager = await getDocumentManager();
+        // Analyze suggestions in parallel with namespace patterns
+        const [suggestions, namespacePatterns] = await Promise.all([
+            analyzeDocumentSuggestions(manager, namespace, title, overview),
+            analyzeNamespacePatterns(manager, namespace)
+        ]);
+        return {
+            stage: 'smart_suggestions',
+            suggestions,
+            namespace_patterns: namespacePatterns,
+            next_step: "Review suggestions, then call again with 'create: true' to proceed with document creation",
+            example: {
+                namespace,
+                title,
+                overview,
+                create: true
+            }
+        };
+    }
+    catch (error) {
+        const message = error instanceof Error ? error.message : String(error);
+        return {
+            stage: 'error_fallback',
+            error: 'Failed to analyze suggestions',
+            details: message,
+            provided_parameters: {
+                namespace,
+                title,
+                overview
+            },
+            help: 'Suggestion analysis failed. You can still proceed with document creation.',
+            recovery_steps: [
+                "Call again with 'create: true' to skip suggestions and create the document",
+                'Check that the namespace, title, and overview are valid',
+                'Try with a simpler title or overview if the analysis is having issues'
+            ],
+            example: { namespace, title, overview, create: true }
+        };
+    }
+}
+//# sourceMappingURL=suggestion-generator.js.map

package/dist/tools/create/suggestion-generator.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"suggestion-generator.js","sourceRoot":"","sources":["../../../src/tools/create/suggestion-generator.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAEH,OAAO,EAAE,kBAAkB,EAAE,0BAA0B,EAAE,wBAAwB,EAAE,MAAM,2BAA2B,CAAC;AA2CrH;;GAEG;AACH,MAAM,CAAC,KAAK,UAAU,kBAAkB,CACtC,SAAiB,EACjB,KAAa,EACb,QAAgB;IAEhB,IAAI,CAAC;QACH,MAAM,OAAO,GAAG,MAAM,kBAAkB,EAAE,CAAC;QAE3C,0DAA0D;QAC1D,MAAM,CAAC,WAAW,EAAE,iBAAiB,CAAC,GAAG,MAAM,OAAO,CAAC,GAAG,CAAC;YACzD,0BAA0B,CAAC,OAAO,EAAE,SAAS,EAAE,KAAK,EAAE,QAAQ,CAAC;YAC/D,wBAAwB,CAAC,OAAO,EAAE,SAAS,CAAC;SAC7C,CAAC,CAAC;QAEH,OAAO;YACL,KAAK,EAAE,mBAAmB;YAC1B,WAAW;YACX,kBAAkB,EAAE,iBAAiB;YACrC,SAAS,EAAE,2FAA2F;YACtG,OAAO,EAAE;gBACP,SAAS;gBACT,KAAK;gBACL,QAAQ;gBACR,MAAM,EAAE,IAAI;aACb;SACF,CAAC;IAEJ,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;YACL,KAAK,EAAE,gBAAgB;YACvB,KAAK,EAAE,+BAA+B;YACtC,OAAO,EAAE,OAAO;YAChB,mBAAmB,EAAE;gBACnB,SAAS;gBACT,KAAK;gBACL,QAAQ;aACT;YACD,IAAI,EAAE,2EAA2E;YACjF,cAAc,EAAE;gBACd,4EAA4E;gBAC5E,yDAAyD;gBACzD,uEAAuE;aACxE;YACD,OAAO,EAAE,EAAE,SAAS,EAAE,KAAK,EAAE,QAAQ,EAAE,MAAM,EAAE,IAAI,EAAE;SACtD,CAAC;IACJ,CAAC;AACH,CAAC"}

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

@@ -0,0 +1,27 @@
+/**
+ * Template processor for create-document pipeline
+ * Handles template processing and content generation
+ */
+import type { DocumentManager } from '../../document-manager.js';
+/**
+ * Template processing result
+ */
+export interface TemplateProcessingResult {
+    content: string;
+    slug: string;
+    docPath: string;
+}
+/**
+ * Template processing error
+ */
+export interface TemplateProcessingError {
+    error: string;
+    details: string;
+    provided_namespace: string;
+}
+/**
+ * Process template content with variable substitution
+ * Generates a blank document with title and overview
+ */
+export declare function processTemplate(namespace: string, title: string, overview: string, _manager: DocumentManager): Promise<TemplateProcessingResult | TemplateProcessingError>;
+//# sourceMappingURL=template-processor.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"template-processor.d.ts","sourceRoot":"","sources":["../../../src/tools/create/template-processor.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAEH,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,2BAA2B,CAAC;AAGjE;;GAEG;AACH,MAAM,WAAW,wBAAwB;IACvC,OAAO,EAAE,MAAM,CAAC;IAChB,IAAI,EAAE,MAAM,CAAC;IACb,OAAO,EAAE,MAAM,CAAC;CACjB;AAED;;GAEG;AACH,MAAM,WAAW,uBAAuB;IACtC,KAAK,EAAE,MAAM,CAAC;IACd,OAAO,EAAE,MAAM,CAAC;IAChB,kBAAkB,EAAE,MAAM,CAAC;CAC5B;AASD;;;GAGG;AACH,wBAAsB,eAAe,CACnC,SAAS,EAAE,MAAM,EACjB,KAAK,EAAE,MAAM,EACb,QAAQ,EAAE,MAAM,EAChB,QAAQ,EAAE,eAAe,GACxB,OAAO,CAAC,wBAAwB,GAAG,uBAAuB,CAAC,CA4D7D"}

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

@@ -0,0 +1,74 @@
+/**
+ * Template processor for create-document pipeline
+ * Handles template processing and content generation
+ */
+import { parseDocumentAddress, AddressingError } from '../../shared/addressing-system.js';
+/**
+ * Blank document template with title and overview only
+ */
+const BLANK_TEMPLATE = `# {{title}}
+
+{{overview}}`;
+/**
+ * Process template content with variable substitution
+ * Generates a blank document with title and overview
+ */
+export async function processTemplate(namespace, title, overview, _manager) {
+    try {
+        // Import slug utilities
+        const { titleToSlug } = await import('../../slug.js');
+        const { PATH_PREFIXES } = await import('../../shared/namespace-constants.js');
+        const { normalizeNamespace } = await import('./validation-processor.js');
+        // Generate path from title and namespace
+        const slug = titleToSlug(title);
+        // Normalize namespace (strip leading slashes)
+        const cleanNamespace = normalizeNamespace(namespace);
+        // MCP paths are relative to base folders - no prefix in logical path
+        // Coordinator handling will be updated in separate task to make it symmetric
+        let docPath;
+        if (cleanNamespace.startsWith('coordinator')) {
+            // Keep coordinator explicit for now (will be updated to relative path later)
+            docPath = `/${PATH_PREFIXES.COORDINATOR.slice(1, -1)}/${slug}.md`;
+        }
+        else if (cleanNamespace === '') {
+            // Empty namespace - root level document
+            docPath = `/${slug}.md`;
+        }
+        else {
+            // Regular namespace - direct path without /docs/ prefix
+            docPath = `/${cleanNamespace}/${slug}.md`;
+        }
+        // Validate the generated document path using addressing system
+        try {
+            parseDocumentAddress(docPath);
+        }
+        catch (error) {
+            if (error instanceof AddressingError) {
+                return {
+                    error: 'Generated document path is invalid',
+                    details: error.message,
+                    provided_namespace: namespace
+                };
+            }
+            throw error; // Re-throw non-addressing errors
+        }
+        // Generate blank document with title and overview
+        const content = BLANK_TEMPLATE
+            .replace(/\{\{title\}\}/g, title)
+            .replace(/\{\{overview\}\}/g, overview);
+        return {
+            content,
+            slug,
+            docPath
+        };
+    }
+    catch (error) {
+        const message = error instanceof Error ? error.message : String(error);
+        return {
+            error: 'Template processing failed',
+            details: message,
+            provided_namespace: namespace
+        };
+    }
+}
+//# sourceMappingURL=template-processor.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"template-processor.js","sourceRoot":"","sources":["../../../src/tools/create/template-processor.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAGH,OAAO,EAAE,oBAAoB,EAAE,eAAe,EAAE,MAAM,mCAAmC,CAAC;AAoB1F;;GAEG;AACH,MAAM,cAAc,GAAG;;aAEV,CAAC;AAEd;;;GAGG;AACH,MAAM,CAAC,KAAK,UAAU,eAAe,CACnC,SAAiB,EACjB,KAAa,EACb,QAAgB,EAChB,QAAyB;IAEzB,IAAI,CAAC;QACH,wBAAwB;QACxB,MAAM,EAAE,WAAW,EAAE,GAAG,MAAM,MAAM,CAAC,eAAe,CAAC,CAAC;QACtD,MAAM,EAAE,aAAa,EAAE,GAAG,MAAM,MAAM,CAAC,qCAAqC,CAAC,CAAC;QAC9E,MAAM,EAAE,kBAAkB,EAAE,GAAG,MAAM,MAAM,CAAC,2BAA2B,CAAC,CAAC;QAEzE,yCAAyC;QACzC,MAAM,IAAI,GAAG,WAAW,CAAC,KAAK,CAAC,CAAC;QAEhC,8CAA8C;QAC9C,MAAM,cAAc,GAAG,kBAAkB,CAAC,SAAS,CAAC,CAAC;QAErD,qEAAqE;QACrE,6EAA6E;QAC7E,IAAI,OAAe,CAAC;QACpB,IAAI,cAAc,CAAC,UAAU,CAAC,aAAa,CAAC,EAAE,CAAC;YAC7C,6EAA6E;YAC7E,OAAO,GAAG,IAAI,aAAa,CAAC,WAAW,CAAC,KAAK,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,IAAI,IAAI,KAAK,CAAC;QACpE,CAAC;aAAM,IAAI,cAAc,KAAK,EAAE,EAAE,CAAC;YACjC,wCAAwC;YACxC,OAAO,GAAG,IAAI,IAAI,KAAK,CAAC;QAC1B,CAAC;aAAM,CAAC;YACN,wDAAwD;YACxD,OAAO,GAAG,IAAI,cAAc,IAAI,IAAI,KAAK,CAAC;QAC5C,CAAC;QAED,+DAA+D;QAC/D,IAAI,CAAC;YACH,oBAAoB,CAAC,OAAO,CAAC,CAAC;QAChC,CAAC;QAAC,OAAO,KAAK,EAAE,CAAC;YACf,IAAI,KAAK,YAAY,eAAe,EAAE,CAAC;gBACrC,OAAO;oBACL,KAAK,EAAE,oCAAoC;oBAC3C,OAAO,EAAE,KAAK,CAAC,OAAO;oBACtB,kBAAkB,EAAE,SAAS;iBAC9B,CAAC;YACJ,CAAC;YACD,MAAM,KAAK,CAAC,CAAC,iCAAiC;QAChD,CAAC;QAED,kDAAkD;QAClD,MAAM,OAAO,GAAG,cAAc;aAC3B,OAAO,CAAC,gBAAgB,EAAE,KAAK,CAAC;aAChC,OAAO,CAAC,mBAAmB,EAAE,QAAQ,CAAC,CAAC;QAE1C,OAAO;YACL,OAAO;YACP,IAAI;YACJ,OAAO;SACR,CAAC;IAEJ,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;YACL,KAAK,EAAE,4BAA4B;YACnC,OAAO,EAAE,OAAO;YAChB,kBAAkB,EAAE,SAAS;SAC9B,CAAC;IACJ,CAAC;AACH,CAAC"}

package/dist/tools/create/validation-processor.d.ts

@@ -0,0 +1,48 @@
+/**
+ * Validation processor for create-document pipeline
+ * Handles Stage 0 (Discovery) and Stage 1 (Instructions) validation
+ */
+import { getDocumentNamespaces } from '../schemas/create-document-schemas.js';
+/**
+ * Stage 0: Discovery validation result
+ */
+export interface DiscoveryResult {
+    stage: 'discovery';
+    namespaces: ReturnType<typeof getDocumentNamespaces>;
+    next_step: string;
+    example: {
+        namespace: string;
+    };
+}
+/**
+ * Stage 1: Instructions validation result (removed - direct creation now)
+ */
+/**
+ * Error fallback result for validation issues
+ */
+export interface ValidationErrorResult {
+    stage: 'error_fallback';
+    error: string;
+    provided_namespace?: string;
+    valid_namespaces?: string[];
+    help: string;
+    namespaces?: ReturnType<typeof getDocumentNamespaces>;
+    next_step: string;
+    example: Record<string, unknown>;
+}
+export type ValidationResult = DiscoveryResult | ValidationErrorResult;
+/**
+ * Process Stage 0: Discovery - Return available namespaces
+ */
+export declare function processDiscovery(): DiscoveryResult;
+/**
+ * Validate and normalize namespace for creation stage
+ * Strips leading slashes to ensure relative paths
+ */
+export declare function validateNamespaceForCreation(namespace: string): ValidationErrorResult | null;
+/**
+ * Normalize namespace by removing leading slashes
+ * Used by template-processor.ts for path construction
+ */
+export declare function normalizeNamespace(namespace: string): string;
+//# sourceMappingURL=validation-processor.d.ts.map

package/dist/tools/create/validation-processor.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"validation-processor.d.ts","sourceRoot":"","sources":["../../../src/tools/create/validation-processor.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAEH,OAAO,EACL,qBAAqB,EACtB,MAAM,uCAAuC,CAAC;AAE/C;;GAEG;AACH,MAAM,WAAW,eAAe;IAC9B,KAAK,EAAE,WAAW,CAAC;IACnB,UAAU,EAAE,UAAU,CAAC,OAAO,qBAAqB,CAAC,CAAC;IACrD,SAAS,EAAE,MAAM,CAAC;IAClB,OAAO,EAAE;QAAE,SAAS,EAAE,MAAM,CAAA;KAAE,CAAC;CAChC;AAED;;GAEG;AAEH;;GAEG;AACH,MAAM,WAAW,qBAAqB;IACpC,KAAK,EAAE,gBAAgB,CAAC;IACxB,KAAK,EAAE,MAAM,CAAC;IACd,kBAAkB,CAAC,EAAE,MAAM,CAAC;IAC5B,gBAAgB,CAAC,EAAE,MAAM,EAAE,CAAC;IAC5B,IAAI,EAAE,MAAM,CAAC;IACb,UAAU,CAAC,EAAE,UAAU,CAAC,OAAO,qBAAqB,CAAC,CAAC;IACtD,SAAS,EAAE,MAAM,CAAC;IAClB,OAAO,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;CAClC;AAED,MAAM,MAAM,gBAAgB,GAAG,eAAe,GAAG,qBAAqB,CAAC;AAIvE;;GAEG;AACH,wBAAgB,gBAAgB,IAAI,eAAe,CAOlD;AAID;;;GAGG;AACH,wBAAgB,4BAA4B,CAAC,SAAS,EAAE,MAAM,GAAG,qBAAqB,GAAG,IAAI,CAM5F;AAED;;;GAGG;AAEH,wBAAgB,kBAAkB,CAAC,SAAS,EAAE,MAAM,GAAG,MAAM,CAG5D"}

package/dist/tools/create/validation-processor.js

@@ -0,0 +1,107 @@
+/**
+ * Validation processor for create-document pipeline
+ * Handles Stage 0 (Discovery) and Stage 1 (Instructions) validation
+ */
+import { getDocumentNamespaces } from '../schemas/create-document-schemas.js';
+// NAMESPACE_INSTRUCTIONS removed - no longer using hardcoded templates
+/**
+ * Process Stage 0: Discovery - Return available namespaces
+ */
+export function processDiscovery() {
+    return {
+        stage: 'discovery',
+        namespaces: getDocumentNamespaces(),
+        next_step: "Call again with 'namespace', 'title', and 'overview' to create a blank document",
+        example: { namespace: "specs" }
+    };
+}
+// processInstructions removed - Stage 1 no longer exists (direct creation)
+/**
+ * Validate and normalize namespace for creation stage
+ * Strips leading slashes to ensure relative paths
+ */
+export function validateNamespaceForCreation(namespace) {
+    // Normalize: remove leading slashes (namespace should be relative)
+    const normalized = namespace.replace(/^\/+/, '');
+    // Use the normalized namespace for validation
+    return validateCustomNamespacePath(normalized);
+}
+/**
+ * Normalize namespace by removing leading slashes
+ * Used by template-processor.ts for path construction
+ */
+// ts-unused-exports:disable-next-line
+export function normalizeNamespace(namespace) {
+    // Strip both leading and trailing slashes
+    return namespace.replace(/^\/+/, '').replace(/\/+$/, '');
+}
+// Helper functions removed - no longer generating examples for instructions stage
+/**
+ * Validate custom namespace path for security and structure
+ */
+function validateCustomNamespacePath(namespace) {
+    // Check for empty namespace
+    if (namespace.trim() === '') {
+        return {
+            stage: 'error_fallback',
+            error: 'Empty namespace not allowed',
+            help: 'Please provide a valid namespace. Use predefined namespaces or create custom ones like "myproject/docs"',
+            namespaces: getDocumentNamespaces(),
+            next_step: "Call again with a valid 'namespace' parameter",
+            example: { namespace: "custom/my-namespace" }
+        };
+    }
+    // Check for path traversal attempts
+    if (namespace.includes('..') || namespace.includes('\\')) {
+        return {
+            stage: 'error_fallback',
+            error: 'Invalid namespace path',
+            provided_namespace: namespace,
+            help: 'Namespace cannot contain ".." or "\\" characters for security reasons',
+            namespaces: getDocumentNamespaces(),
+            next_step: "Call again with a safe namespace path",
+            example: { namespace: "custom/safe-namespace" }
+        };
+    }
+    // Check for Windows drive letters (colons in paths)
+    // Note: Leading / is allowed - addressing system normalizes paths
+    if (namespace.includes(':')) {
+        return {
+            stage: 'error_fallback',
+            error: 'Windows drive letters not allowed in namespace',
+            provided_namespace: namespace,
+            help: 'Use relative namespace paths only, such as "custom/my-namespace"',
+            namespaces: getDocumentNamespaces(),
+            next_step: "Call again with a relative namespace path",
+            example: { namespace: "custom/my-namespace" }
+        };
+    }
+    // Check for invalid characters
+    const invalidChars = /[<>"|*?:]/;
+    if (invalidChars.test(namespace)) {
+        return {
+            stage: 'error_fallback',
+            error: 'Invalid characters in namespace',
+            provided_namespace: namespace,
+            help: 'Namespace can only contain letters, numbers, hyphens, underscores, and forward slashes',
+            namespaces: getDocumentNamespaces(),
+            next_step: "Call again with a valid namespace using only allowed characters",
+            example: { namespace: "custom/my-namespace" }
+        };
+    }
+    // Validate length and structure
+    if (namespace.length > 100) {
+        return {
+            stage: 'error_fallback',
+            error: 'Namespace too long',
+            provided_namespace: namespace,
+            help: 'Namespace must be 100 characters or less',
+            namespaces: getDocumentNamespaces(),
+            next_step: "Call again with a shorter namespace",
+            example: { namespace: "custom/shorter-name" }
+        };
+    }
+    // No validation errors
+    return null;
+}
+//# sourceMappingURL=validation-processor.js.map

package/dist/tools/create/validation-processor.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"validation-processor.js","sourceRoot":"","sources":["../../../src/tools/create/validation-processor.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAEH,OAAO,EACL,qBAAqB,EACtB,MAAM,uCAAuC,CAAC;AAgC/C,uEAAuE;AAEvE;;GAEG;AACH,MAAM,UAAU,gBAAgB;IAC9B,OAAO;QACL,KAAK,EAAE,WAAW;QAClB,UAAU,EAAE,qBAAqB,EAAE;QACnC,SAAS,EAAE,iFAAiF;QAC5F,OAAO,EAAE,EAAE,SAAS,EAAE,OAAO,EAAE;KAChC,CAAC;AACJ,CAAC;AAED,2EAA2E;AAE3E;;;GAGG;AACH,MAAM,UAAU,4BAA4B,CAAC,SAAiB;IAC5D,mEAAmE;IACnE,MAAM,UAAU,GAAG,SAAS,CAAC,OAAO,CAAC,MAAM,EAAE,EAAE,CAAC,CAAC;IAEjD,8CAA8C;IAC9C,OAAO,2BAA2B,CAAC,UAAU,CAAC,CAAC;AACjD,CAAC;AAED;;;GAGG;AACH,sCAAsC;AACtC,MAAM,UAAU,kBAAkB,CAAC,SAAiB;IAClD,0CAA0C;IAC1C,OAAO,SAAS,CAAC,OAAO,CAAC,MAAM,EAAE,EAAE,CAAC,CAAC,OAAO,CAAC,MAAM,EAAE,EAAE,CAAC,CAAC;AAC3D,CAAC;AAGD,kFAAkF;AAElF;;GAEG;AACH,SAAS,2BAA2B,CAAC,SAAiB;IACpD,4BAA4B;IAC5B,IAAI,SAAS,CAAC,IAAI,EAAE,KAAK,EAAE,EAAE,CAAC;QAC5B,OAAO;YACL,KAAK,EAAE,gBAAgB;YACvB,KAAK,EAAE,6BAA6B;YACpC,IAAI,EAAE,yGAAyG;YAC/G,UAAU,EAAE,qBAAqB,EAAE;YACnC,SAAS,EAAE,+CAA+C;YAC1D,OAAO,EAAE,EAAE,SAAS,EAAE,qBAAqB,EAAE;SAC9C,CAAC;IACJ,CAAC;IAED,oCAAoC;IACpC,IAAI,SAAS,CAAC,QAAQ,CAAC,IAAI,CAAC,IAAI,SAAS,CAAC,QAAQ,CAAC,IAAI,CAAC,EAAE,CAAC;QACzD,OAAO;YACL,KAAK,EAAE,gBAAgB;YACvB,KAAK,EAAE,wBAAwB;YAC/B,kBAAkB,EAAE,SAAS;YAC7B,IAAI,EAAE,uEAAuE;YAC7E,UAAU,EAAE,qBAAqB,EAAE;YACnC,SAAS,EAAE,uCAAuC;YAClD,OAAO,EAAE,EAAE,SAAS,EAAE,uBAAuB,EAAE;SAChD,CAAC;IACJ,CAAC;IAED,oDAAoD;IACpD,kEAAkE;IAClE,IAAI,SAAS,CAAC,QAAQ,CAAC,GAAG,CAAC,EAAE,CAAC;QAC5B,OAAO;YACL,KAAK,EAAE,gBAAgB;YACvB,KAAK,EAAE,gDAAgD;YACvD,kBAAkB,EAAE,SAAS;YAC7B,IAAI,EAAE,kEAAkE;YACxE,UAAU,EAAE,qBAAqB,EAAE;YACnC,SAAS,EAAE,2CAA2C;YACtD,OAAO,EAAE,EAAE,SAAS,EAAE,qBAAqB,EAAE;SAC9C,CAAC;IACJ,CAAC;IAED,+BAA+B;IAC/B,MAAM,YAAY,GAAG,WAAW,CAAC;IACjC,IAAI,YAAY,CAAC,IAAI,CAAC,SAAS,CAAC,EAAE,CAAC;QACjC,OAAO;YACL,KAAK,EAAE,gBAAgB;YACvB,KAAK,EAAE,iCAAiC;YACxC,kBAAkB,EAAE,SAAS;YAC7B,IAAI,EAAE,wFAAwF;YAC9F,UAAU,EAAE,qBAAqB,EAAE;YACnC,SAAS,EAAE,iEAAiE;YAC5E,OAAO,EAAE,EAAE,SAAS,EAAE,qBAAqB,EAAE;SAC9C,CAAC;IACJ,CAAC;IAED,gCAAgC;IAChC,IAAI,SAAS,CAAC,MAAM,GAAG,GAAG,EAAE,CAAC;QAC3B,OAAO;YACL,KAAK,EAAE,gBAAgB;YACvB,KAAK,EAAE,oBAAoB;YAC3B,kBAAkB,EAAE,SAAS;YAC7B,IAAI,EAAE,0CAA0C;YAChD,UAAU,EAAE,qBAAqB,EAAE;YACnC,SAAS,EAAE,qCAAqC;YAChD,OAAO,EAAE,EAAE,SAAS,EAAE,qBAAqB,EAAE;SAC9C,CAAC;IACJ,CAAC;IAED,uBAAuB;IACvB,OAAO,IAAI,CAAC;AACd,CAAC"}

package/dist/tools/executor.d.ts

@@ -0,0 +1,19 @@
+/**
+ * Tool execution dispatcher using registry-based pattern for Open/Closed Principle compliance
+ *
+ * Updated to support dependency injection of DocumentManager
+ */
+import type { SessionState } from '../session/types.js';
+import type { DocumentManager } from '../document-manager.js';
+/**
+ * Execute tool based on name and session state using registry pattern with dependency injection
+ *
+ * @param toolName - Name of the tool to execute
+ * @param args - Tool arguments
+ * @param state - Session state
+ * @param manager - DocumentManager instance (injected dependency)
+ * @param onListChanged - Optional callback for tool list changes
+ * @returns Tool execution result
+ */
+export declare function executeTool(toolName: string, args: Record<string, unknown>, state: SessionState, manager: DocumentManager, onListChanged?: () => void): Promise<unknown>;
+//# sourceMappingURL=executor.d.ts.map

package/dist/tools/executor.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"executor.d.ts","sourceRoot":"","sources":["../../src/tools/executor.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,qBAAqB,CAAC;AACxD,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,wBAAwB,CAAC;AA6D9D;;;;;;;;;GASG;AACH,wBAAsB,WAAW,CAC/B,QAAQ,EAAE,MAAM,EAChB,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,CAalB"}

package/dist/tools/executor.js

@@ -0,0 +1,53 @@
+/**
+ * Tool execution dispatcher using registry-based pattern for Open/Closed Principle compliance
+ *
+ * Updated to support dependency injection of DocumentManager
+ */
+import { createDocument, browseDocuments, searchDocuments, section, move, deleteDocument, moveDocument, viewDocument, viewSection, viewSubagentTask, viewCoordinatorTask, subagentTask, completeSubagentTask, startSubagentTask, coordinatorTask, completeCoordinatorTask, startCoordinatorTask, editDocument, executeGetWorkflow, executeGetGuide } from './implementations/index.js';
+/**
+ * Registry of tool implementations - follows Open/Closed Principle
+ * New tools can be added without modifying the executor logic
+ */
+const TOOL_REGISTRY = {
+    'create_document': createDocument,
+    'edit_document': editDocument,
+    'browse_documents': browseDocuments,
+    'search_documents': searchDocuments,
+    section,
+    move,
+    'delete_document': deleteDocument,
+    'move_document': moveDocument,
+    'view_document': viewDocument,
+    'view_section': viewSection,
+    'view_subagent_task': viewSubagentTask,
+    'view_coordinator_task': viewCoordinatorTask,
+    'subagent_task': subagentTask,
+    'complete_subagent_task': completeSubagentTask,
+    'start_subagent_task': startSubagentTask,
+    'coordinator_task': coordinatorTask,
+    'complete_coordinator_task': completeCoordinatorTask,
+    'start_coordinator_task': startCoordinatorTask,
+    'get_workflow': executeGetWorkflow,
+    'get_guide': executeGetGuide
+};
+/**
+ * Execute tool based on name and session state using registry pattern with dependency injection
+ *
+ * @param toolName - Name of the tool to execute
+ * @param args - Tool arguments
+ * @param state - Session state
+ * @param manager - DocumentManager instance (injected dependency)
+ * @param onListChanged - Optional callback for tool list changes
+ * @returns Tool execution result
+ */
+export async function executeTool(toolName, args, state, manager, onListChanged) {
+    const implementation = TOOL_REGISTRY[toolName];
+    if (implementation == null) {
+        throw new Error(JSON.stringify({
+            code: -32601,
+            message: `Unknown tool: ${toolName}`,
+        }));
+    }
+    return await implementation(args, state, manager, onListChanged);
+}
+//# sourceMappingURL=executor.js.map

package/dist/tools/executor.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"executor.js","sourceRoot":"","sources":["../../src/tools/executor.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAIH,OAAO,EACL,cAAc,EACd,eAAe,EACf,eAAe,EACf,OAAO,EACP,IAAI,EACJ,cAAc,EACd,YAAY,EACZ,YAAY,EACZ,WAAW,EACX,gBAAgB,EAChB,mBAAmB,EACnB,YAAY,EACZ,oBAAoB,EACpB,iBAAiB,EACjB,eAAe,EACf,uBAAuB,EACvB,oBAAoB,EACpB,YAAY,EACZ,kBAAkB,EAClB,eAAe,EAChB,MAAM,4BAA4B,CAAC;AAYpC;;;GAGG;AACH,MAAM,aAAa,GAAuC;IACxD,iBAAiB,EAAE,cAAc;IACjC,eAAe,EAAE,YAAY;IAC7B,kBAAkB,EAAE,eAAe;IACnC,kBAAkB,EAAE,eAAe;IACnC,OAAO;IACP,IAAI;IACJ,iBAAiB,EAAE,cAAc;IACjC,eAAe,EAAE,YAAY;IAC7B,eAAe,EAAE,YAAY;IAC7B,cAAc,EAAE,WAAW;IAC3B,oBAAoB,EAAE,gBAAgB;IACtC,uBAAuB,EAAE,mBAAmB;IAC5C,eAAe,EAAE,YAAY;IAC7B,wBAAwB,EAAE,oBAAoB;IAC9C,qBAAqB,EAAE,iBAAiB;IACxC,kBAAkB,EAAE,eAAe;IACnC,2BAA2B,EAAE,uBAAuB;IACpD,wBAAwB,EAAE,oBAAoB;IAC9C,cAAc,EAAE,kBAAkB;IAClC,WAAW,EAAE,eAAe;CAC7B,CAAC;AAEF;;;;;;;;;GASG;AACH,MAAM,CAAC,KAAK,UAAU,WAAW,CAC/B,QAAgB,EAChB,IAA6B,EAC7B,KAAmB,EACnB,OAAwB,EACxB,aAA0B;IAE1B,MAAM,cAAc,GAAG,aAAa,CAAC,QAAQ,CAAC,CAAC;IAE/C,IAAI,cAAc,IAAI,IAAI,EAAE,CAAC;QAC3B,MAAM,IAAI,KAAK,CACb,IAAI,CAAC,SAAS,CAAC;YACb,IAAI,EAAE,CAAC,KAAK;YACZ,OAAO,EAAE,iBAAiB,QAAQ,EAAE;SACrC,CAAC,CACH,CAAC;IACJ,CAAC;IAED,OAAO,MAAM,cAAc,CAAC,IAAI,EAAE,KAAK,EAAE,OAAO,EAAE,aAAa,CAAC,CAAC;AACnE,CAAC"}

package/dist/tools/implementations/__tests__/browse-documents.test.d.ts

@@ -0,0 +1,8 @@
+/**
+ * Unit tests for browse_documents tool
+ *
+ * Tests the browse_documents tool which provides unified browsing and searching
+ * with namespace awareness and verbose mode control.
+ */
+export {};
+//# sourceMappingURL=browse-documents.test.d.ts.map

package/dist/tools/implementations/__tests__/browse-documents.test.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"browse-documents.test.d.ts","sourceRoot":"","sources":["../../../../src/tools/implementations/__tests__/browse-documents.test.ts"],"names":[],"mappings":"AAAA;;;;;GAKG"}