ai-prompt-guide-mcp 1.0.0

package/dist/tools/schemas/__tests__/get-guide-schemas.test.js

@@ -0,0 +1,216 @@
+/**
+ * Unit tests for get_guide tool schema generation
+ *
+ * Tests the dynamic schema generation from loaded guide prompts,
+ * ensuring proper enum generation, description formatting, and schema structure.
+ */
+import { describe, test, expect, beforeAll } from 'vitest';
+import { tmpdir } from 'node:os';
+import { mkdtempSync } from 'node:fs';
+import { join } from 'node:path';
+import { loadWorkflowPrompts } from '../../../prompts/workflow-prompts.js';
+// Import the schema generator (will be implemented)
+import { generateGetGuideSchema } from '../get-guide-schemas.js';
+describe('generateGetGuideSchema', () => {
+    beforeAll(async () => {
+        // Set MCP_WORKSPACE_PATH if not already set
+        if (process.env['MCP_WORKSPACE_PATH'] == null) {
+            const tempDir = mkdtempSync(join(tmpdir(), 'get-guide-schema-test-'));
+            process.env['MCP_WORKSPACE_PATH'] = tempDir;
+        }
+        // Load workflow prompts (includes guide prompts) before running tests
+        await loadWorkflowPrompts();
+    });
+    describe('schema structure', () => {
+        test('should return a valid ToolDefinition', () => {
+            const schema = generateGetGuideSchema();
+            expect(schema).toHaveProperty('name');
+            expect(schema).toHaveProperty('description');
+            expect(schema).toHaveProperty('inputSchema');
+        });
+        test('should have correct tool name', () => {
+            const schema = generateGetGuideSchema();
+            expect(schema.name).toBe('get_guide');
+        });
+        test('should have descriptive tool description', () => {
+            const schema = generateGetGuideSchema();
+            expect(schema.description).toBeTruthy();
+            expect(schema.description.length).toBeGreaterThan(20);
+            expect(schema.description.toLowerCase()).toContain('guide');
+        });
+        test('should have valid inputSchema structure', () => {
+            const schema = generateGetGuideSchema();
+            expect(schema.inputSchema.type).toBe('object');
+            expect(schema.inputSchema).toHaveProperty('properties');
+            expect(schema.inputSchema).toHaveProperty('required');
+            expect(schema.inputSchema.additionalProperties).toBe(false);
+        });
+    });
+    describe('guide parameter', () => {
+        test('should define guide parameter', () => {
+            const schema = generateGetGuideSchema();
+            const properties = schema.inputSchema.properties;
+            expect(properties).toHaveProperty('guide');
+        });
+        test('should have string type for guide parameter', () => {
+            const schema = generateGetGuideSchema();
+            const properties = schema.inputSchema.properties;
+            const guide = properties['guide'];
+            expect(guide.type).toBe('string');
+        });
+        test('should mark guide as required', () => {
+            const schema = generateGetGuideSchema();
+            expect(schema.inputSchema.required).toContain('guide');
+            expect(schema.inputSchema.required?.length).toBe(1);
+        });
+        test('should have enum values for guide parameter', () => {
+            const schema = generateGetGuideSchema();
+            const properties = schema.inputSchema.properties;
+            const guide = properties['guide'];
+            expect(guide).toHaveProperty('enum');
+            expect(Array.isArray(guide.enum)).toBe(true);
+            expect(guide.enum.length).toBeGreaterThan(0);
+        });
+        test('should have description for guide parameter', () => {
+            const schema = generateGetGuideSchema();
+            const properties = schema.inputSchema.properties;
+            const guide = properties['guide'];
+            expect(guide).toHaveProperty('description');
+            expect(guide.description.length).toBeGreaterThan(0);
+        });
+    });
+    describe('enum generation from guide prompts', () => {
+        test('should filter only guide_ prefixed prompts', () => {
+            const schema = generateGetGuideSchema();
+            const properties = schema.inputSchema.properties;
+            const guide = properties['guide'];
+            // All enum values should be valid guide names (without prefix)
+            guide.enum.forEach(value => {
+                expect(value).not.toContain('guide_');
+                expect(typeof value).toBe('string');
+                expect(value.length).toBeGreaterThan(0);
+            });
+        });
+        test('should strip guide_ prefix from enum values', () => {
+            const schema = generateGetGuideSchema();
+            const properties = schema.inputSchema.properties;
+            const guide = properties['guide'];
+            // Check specific known guides (updated to match current guide files)
+            const expectedGuides = [
+                'research-guide',
+                'specification-writing',
+                'tutorial-writing',
+                'writing-standards'
+            ];
+            expectedGuides.forEach(expected => {
+                expect(guide.enum).toContain(expected);
+            });
+        });
+        test('should not include workflow_ prefixed prompts', () => {
+            const schema = generateGetGuideSchema();
+            const properties = schema.inputSchema.properties;
+            const guide = properties['guide'];
+            // No enum value should contain 'workflow'
+            guide.enum.forEach(value => {
+                expect(value).not.toContain('workflow_');
+            });
+        });
+        test('should have at least 4 guide options', () => {
+            const schema = generateGetGuideSchema();
+            const properties = schema.inputSchema.properties;
+            const guide = properties['guide'];
+            // We know there are at least 4 guide files
+            expect(guide.enum.length).toBeGreaterThanOrEqual(4);
+        });
+    });
+    describe('description formatting', () => {
+        test('should include all guides in description', () => {
+            const schema = generateGetGuideSchema();
+            const properties = schema.inputSchema.properties;
+            const guide = properties['guide'];
+            // Each enum value should appear in the description
+            guide.enum.forEach(value => {
+                expect(guide.description).toContain(value);
+            });
+        });
+        test('should format description with bullet points', () => {
+            const schema = generateGetGuideSchema();
+            const properties = schema.inputSchema.properties;
+            const guide = properties['guide'];
+            // Should use bullet points for listing guides
+            expect(guide.description).toContain('•');
+        });
+        test('should include guide names in description even without YAML frontmatter', () => {
+            const schema = generateGetGuideSchema();
+            const properties = schema.inputSchema.properties;
+            const guide = properties['guide'];
+            // Guide files don't have YAML frontmatter, so descriptions may be empty
+            // but all guide names should still be listed (updated to match current guide files)
+            expect(guide.description).toContain('research-guide');
+            expect(guide.description).toContain('specification-writing');
+        });
+        test('should start with "Available guides:" prefix', () => {
+            const schema = generateGetGuideSchema();
+            const properties = schema.inputSchema.properties;
+            const guide = properties['guide'];
+            expect(guide.description).toMatch(/^Available guides:/);
+        });
+    });
+    describe('consistency and quality', () => {
+        test('should generate consistent schema on multiple calls', () => {
+            const schema1 = generateGetGuideSchema();
+            const schema2 = generateGetGuideSchema();
+            expect(schema1).toEqual(schema2);
+        });
+        test('should have no empty or whitespace-only enum values', () => {
+            const schema = generateGetGuideSchema();
+            const properties = schema.inputSchema.properties;
+            const guide = properties['guide'];
+            guide.enum.forEach(value => {
+                expect(value.trim()).toBe(value);
+                expect(value.length).toBeGreaterThan(0);
+            });
+        });
+        test('should have unique enum values', () => {
+            const schema = generateGetGuideSchema();
+            const properties = schema.inputSchema.properties;
+            const guide = properties['guide'];
+            const unique = new Set(guide.enum);
+            expect(unique.size).toBe(guide.enum.length);
+        });
+        test('should match TypeScript ToolDefinition interface', () => {
+            const schema = generateGetGuideSchema();
+            // Type check - if this compiles, the structure is correct
+            const _typeCheck = schema;
+            expect(_typeCheck).toBeDefined();
+        });
+    });
+    describe('error handling', () => {
+        test('should throw helpful error if prompts not loaded', () => {
+            // This would require mocking the workflow prompts module
+            // For now, we ensure the function requires prompts to be loaded first
+            const schema = generateGetGuideSchema();
+            const properties = schema.inputSchema.properties;
+            const guide = properties['guide'];
+            // Should have enum values if prompts are loaded
+            expect(guide.enum.length).toBeGreaterThan(0);
+        });
+    });
+    describe('integration with existing patterns', () => {
+        test('should follow same schema pattern as other tools', () => {
+            const schema = generateGetGuideSchema();
+            // Check required fields present in all tool schemas
+            expect(schema).toHaveProperty('name');
+            expect(schema).toHaveProperty('description');
+            expect(schema.inputSchema).toHaveProperty('type');
+            expect(schema.inputSchema).toHaveProperty('properties');
+            expect(schema.inputSchema).toHaveProperty('required');
+        });
+        test('should have additionalProperties set to false', () => {
+            const schema = generateGetGuideSchema();
+            // Strict validation - no extra properties allowed
+            expect(schema.inputSchema.additionalProperties).toBe(false);
+        });
+    });
+});
+//# sourceMappingURL=get-guide-schemas.test.js.map

package/dist/tools/schemas/__tests__/get-guide-schemas.test.js.map

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

package/dist/tools/schemas/__tests__/get-workflow-schemas.test.d.ts

@@ -0,0 +1,8 @@
+/**
+ * Unit tests for get_workflow tool schema generation
+ *
+ * Tests the dynamic schema generation from loaded workflow prompts,
+ * ensuring proper enum generation, description formatting, and schema structure.
+ */
+export {};
+//# sourceMappingURL=get-workflow-schemas.test.d.ts.map

package/dist/tools/schemas/__tests__/get-workflow-schemas.test.d.ts.map

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

package/dist/tools/schemas/__tests__/get-workflow-schemas.test.js

@@ -0,0 +1,229 @@
+/**
+ * Unit tests for get_workflow tool schema generation
+ *
+ * Tests the dynamic schema generation from loaded workflow prompts,
+ * ensuring proper enum generation, description formatting, and schema structure.
+ */
+import { describe, test, expect, beforeAll } from 'vitest';
+import { tmpdir } from 'node:os';
+import { mkdtempSync } from 'node:fs';
+import { join } from 'node:path';
+import { loadWorkflowPrompts } from '../../../prompts/workflow-prompts.js';
+// Import the schema generator (will be implemented)
+import { generateGetWorkflowSchema } from '../get-workflow-schemas.js';
+describe('generateGetWorkflowSchema', () => {
+    beforeAll(async () => {
+        // Set MCP_WORKSPACE_PATH if not already set
+        if (process.env['MCP_WORKSPACE_PATH'] == null) {
+            const tempDir = mkdtempSync(join(tmpdir(), 'get-workflow-schema-test-'));
+            process.env['MCP_WORKSPACE_PATH'] = tempDir;
+        }
+        // Load workflow prompts before running tests
+        await loadWorkflowPrompts();
+    });
+    describe('schema structure', () => {
+        test('should return a valid ToolDefinition', () => {
+            const schema = generateGetWorkflowSchema();
+            expect(schema).toHaveProperty('name');
+            expect(schema).toHaveProperty('description');
+            expect(schema).toHaveProperty('inputSchema');
+        });
+        test('should have correct tool name', () => {
+            const schema = generateGetWorkflowSchema();
+            expect(schema.name).toBe('get_workflow');
+        });
+        test('should have descriptive tool description', () => {
+            const schema = generateGetWorkflowSchema();
+            expect(schema.description).toBeTruthy();
+            expect(schema.description.length).toBeGreaterThan(20);
+            expect(schema.description.toLowerCase()).toContain('workflow');
+        });
+        test('should have valid inputSchema structure', () => {
+            const schema = generateGetWorkflowSchema();
+            expect(schema.inputSchema.type).toBe('object');
+            expect(schema.inputSchema).toHaveProperty('properties');
+            expect(schema.inputSchema).toHaveProperty('required');
+            expect(schema.inputSchema.additionalProperties).toBe(false);
+        });
+    });
+    describe('workflow parameter', () => {
+        test('should define workflow parameter', () => {
+            const schema = generateGetWorkflowSchema();
+            const properties = schema.inputSchema.properties;
+            expect(properties).toHaveProperty('workflow');
+        });
+        test('should have string type for workflow parameter', () => {
+            const schema = generateGetWorkflowSchema();
+            const properties = schema.inputSchema.properties;
+            const workflow = properties['workflow'];
+            expect(workflow.type).toBe('string');
+        });
+        test('should mark workflow as required', () => {
+            const schema = generateGetWorkflowSchema();
+            expect(schema.inputSchema.required).toContain('workflow');
+            expect(schema.inputSchema.required?.length).toBe(1);
+        });
+        test('should have enum values for workflow parameter', () => {
+            const schema = generateGetWorkflowSchema();
+            const properties = schema.inputSchema.properties;
+            const workflow = properties['workflow'];
+            expect(workflow).toHaveProperty('enum');
+            expect(Array.isArray(workflow.enum)).toBe(true);
+            expect(workflow.enum.length).toBeGreaterThan(0);
+        });
+        test('should have description for workflow parameter', () => {
+            const schema = generateGetWorkflowSchema();
+            const properties = schema.inputSchema.properties;
+            const workflow = properties['workflow'];
+            expect(workflow).toHaveProperty('description');
+            expect(workflow.description.length).toBeGreaterThan(0);
+        });
+    });
+    describe('enum generation from workflow prompts', () => {
+        test('should filter only workflow_ prefixed prompts', () => {
+            const schema = generateGetWorkflowSchema();
+            const properties = schema.inputSchema.properties;
+            const workflow = properties['workflow'];
+            // All enum values should be valid workflow names (without prefix)
+            workflow.enum.forEach(value => {
+                expect(value).not.toContain('workflow_');
+                expect(typeof value).toBe('string');
+                expect(value.length).toBeGreaterThan(0);
+            });
+        });
+        test('should strip workflow_ prefix from enum values', () => {
+            const schema = generateGetWorkflowSchema();
+            const properties = schema.inputSchema.properties;
+            const workflow = properties['workflow'];
+            // Verify that enum values are properly formatted (no prefix, valid strings)
+            // Don't hard-code specific workflow names as they may vary per installation
+            workflow.enum.forEach(value => {
+                // Should be kebab-case format (e.g., 'build-tdd', 'spec-external')
+                expect(value).toMatch(/^[a-z]+(-[a-z]+)*$/);
+                // Should not be empty
+                expect(value.length).toBeGreaterThan(2);
+            });
+            // Should have reasonable number of workflows loaded
+            expect(workflow.enum.length).toBeGreaterThanOrEqual(4);
+        });
+        test('should not include guide_ prefixed prompts', () => {
+            const schema = generateGetWorkflowSchema();
+            const properties = schema.inputSchema.properties;
+            const workflow = properties['workflow'];
+            // No enum value should contain 'guide'
+            workflow.enum.forEach(value => {
+                expect(value).not.toContain('guide_');
+            });
+        });
+        test('should have at least 4 workflow options', () => {
+            const schema = generateGetWorkflowSchema();
+            const properties = schema.inputSchema.properties;
+            const workflow = properties['workflow'];
+            // We know there are at least 4 workflow files
+            expect(workflow.enum.length).toBeGreaterThanOrEqual(4);
+        });
+    });
+    describe('description formatting', () => {
+        test('should include all workflows in description', () => {
+            const schema = generateGetWorkflowSchema();
+            const properties = schema.inputSchema.properties;
+            const workflow = properties['workflow'];
+            // Each enum value should appear in the description
+            workflow.enum.forEach(value => {
+                expect(workflow.description).toContain(value);
+            });
+        });
+        test('should include emojis in description', () => {
+            const schema = generateGetWorkflowSchema();
+            const properties = schema.inputSchema.properties;
+            const workflow = properties['workflow'];
+            // Check for emoji presence (common workflow emojis)
+            const emojiRegex = /[\u{1F300}-\u{1F9FF}]|[\u{2600}-\u{26FF}]/u;
+            expect(emojiRegex.test(workflow.description)).toBe(true);
+        });
+        test('should format description with bullet points', () => {
+            const schema = generateGetWorkflowSchema();
+            const properties = schema.inputSchema.properties;
+            const workflow = properties['workflow'];
+            // Should use bullet points for listing workflows
+            expect(workflow.description).toContain('•');
+        });
+        test('should include workflow descriptions from YAML frontmatter', () => {
+            const schema = generateGetWorkflowSchema();
+            const properties = schema.inputSchema.properties;
+            const workflow = properties['workflow'];
+            // Verify descriptions contain actual workflow-related content
+            // Don't hard-code specific workflow names/descriptions as they may vary
+            // Description should have meaningful content
+            expect(workflow.description.length).toBeGreaterThan(100);
+            // Should contain "Use for:" pattern from workflow frontmatter
+            expect(workflow.description).toContain('Use for:');
+            // Should have at least one workflow name from enum in the description
+            const hasWorkflowName = workflow.enum.some(name => workflow.description.includes(name));
+            expect(hasWorkflowName).toBe(true);
+        });
+        test('should start with "Available workflows:" prefix', () => {
+            const schema = generateGetWorkflowSchema();
+            const properties = schema.inputSchema.properties;
+            const workflow = properties['workflow'];
+            expect(workflow.description).toMatch(/^Available workflows:/);
+        });
+    });
+    describe('consistency and quality', () => {
+        test('should generate consistent schema on multiple calls', () => {
+            const schema1 = generateGetWorkflowSchema();
+            const schema2 = generateGetWorkflowSchema();
+            expect(schema1).toEqual(schema2);
+        });
+        test('should have no empty or whitespace-only enum values', () => {
+            const schema = generateGetWorkflowSchema();
+            const properties = schema.inputSchema.properties;
+            const workflow = properties['workflow'];
+            workflow.enum.forEach(value => {
+                expect(value.trim()).toBe(value);
+                expect(value.length).toBeGreaterThan(0);
+            });
+        });
+        test('should have unique enum values', () => {
+            const schema = generateGetWorkflowSchema();
+            const properties = schema.inputSchema.properties;
+            const workflow = properties['workflow'];
+            const unique = new Set(workflow.enum);
+            expect(unique.size).toBe(workflow.enum.length);
+        });
+        test('should match TypeScript ToolDefinition interface', () => {
+            const schema = generateGetWorkflowSchema();
+            // Type check - if this compiles, the structure is correct
+            const _typeCheck = schema;
+            expect(_typeCheck).toBeDefined();
+        });
+    });
+    describe('error handling', () => {
+        test('should throw helpful error if prompts not loaded', () => {
+            // This would require mocking the workflow prompts module
+            // For now, we ensure the function requires prompts to be loaded first
+            const schema = generateGetWorkflowSchema();
+            const properties = schema.inputSchema.properties;
+            const workflow = properties['workflow'];
+            // Should have enum values if prompts are loaded
+            expect(workflow.enum.length).toBeGreaterThan(0);
+        });
+    });
+    describe('integration with existing patterns', () => {
+        test('should follow same schema pattern as other tools', () => {
+            const schema = generateGetWorkflowSchema();
+            // Check required fields present in all tool schemas
+            expect(schema).toHaveProperty('name');
+            expect(schema).toHaveProperty('description');
+            expect(schema.inputSchema).toHaveProperty('type');
+            expect(schema.inputSchema).toHaveProperty('properties');
+            expect(schema.inputSchema).toHaveProperty('required');
+        });
+        test('should have additionalProperties set to false', () => {
+            const schema = generateGetWorkflowSchema();
+            // Strict validation - no extra properties allowed
+            expect(schema.inputSchema.additionalProperties).toBe(false);
+        });
+    });
+});
+//# sourceMappingURL=get-workflow-schemas.test.js.map

package/dist/tools/schemas/__tests__/get-workflow-schemas.test.js.map

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

package/dist/tools/schemas/browse-documents-schemas.d.ts

@@ -0,0 +1,47 @@
+/**
+ * Schema definitions for browse_documents tool
+ */
+export interface BrowseDocumentsInputSchema {
+    type: 'object';
+    properties: {
+        path: {
+            type: 'string';
+            description: 'Directory to browse (e.g., "/api", "/guides") or document path to view basic metadata';
+            default: '/';
+        };
+        include_related: {
+            type: 'boolean';
+            description: 'Whether to include related document analysis (forward/backward links, content similarity, dependency chains)';
+            default: false;
+        };
+        link_depth: {
+            type: 'number';
+            description: 'Maximum depth for link traversal analysis (1-6)';
+            minimum: 1;
+            maximum: 6;
+            default: 2;
+        };
+        verbose: {
+            type: 'boolean';
+            description: 'Show full section details (default: false for compact overview with section_count and word_count only)';
+            default: false;
+        };
+    };
+    additionalProperties: false;
+}
+/**
+ * Schema constants for browse_documents tool
+ */
+export declare const BROWSE_DOCUMENTS_CONSTANTS: {
+    readonly LINK_DEPTH: {
+        readonly MIN: 1;
+        readonly MAX: 6;
+        readonly DEFAULT: 2;
+    };
+    readonly DEFAULT_PATH: "/";
+};
+/**
+ * Get the input schema for browse_documents tool
+ */
+export declare function getBrowseDocumentsSchema(): BrowseDocumentsInputSchema;
+//# sourceMappingURL=browse-documents-schemas.d.ts.map

package/dist/tools/schemas/browse-documents-schemas.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"browse-documents-schemas.d.ts","sourceRoot":"","sources":["../../../src/tools/schemas/browse-documents-schemas.ts"],"names":[],"mappings":"AAAA;;GAEG;AAEH,MAAM,WAAW,0BAA0B;IACzC,IAAI,EAAE,QAAQ,CAAC;IACf,UAAU,EAAE;QACV,IAAI,EAAE;YACJ,IAAI,EAAE,QAAQ,CAAC;YACf,WAAW,EAAE,uFAAuF,CAAC;YACrG,OAAO,EAAE,GAAG,CAAC;SACd,CAAC;QACF,eAAe,EAAE;YACf,IAAI,EAAE,SAAS,CAAC;YAChB,WAAW,EAAE,8GAA8G,CAAC;YAC5H,OAAO,EAAE,KAAK,CAAC;SAChB,CAAC;QACF,UAAU,EAAE;YACV,IAAI,EAAE,QAAQ,CAAC;YACf,WAAW,EAAE,iDAAiD,CAAC;YAC/D,OAAO,EAAE,CAAC,CAAC;YACX,OAAO,EAAE,CAAC,CAAC;YACX,OAAO,EAAE,CAAC,CAAC;SACZ,CAAC;QACF,OAAO,EAAE;YACP,IAAI,EAAE,SAAS,CAAC;YAChB,WAAW,EAAE,wGAAwG,CAAC;YACtH,OAAO,EAAE,KAAK,CAAC;SAChB,CAAC;KACH,CAAC;IACF,oBAAoB,EAAE,KAAK,CAAC;CAC7B;AAED;;GAEG;AACH,eAAO,MAAM,0BAA0B;;;;;;;CAO7B,CAAC;AAEX;;GAEG;AACH,wBAAgB,wBAAwB,IAAI,0BAA0B,CA6BrE"}

package/dist/tools/schemas/browse-documents-schemas.js

@@ -0,0 +1,48 @@
+/**
+ * Schema definitions for browse_documents tool
+ */
+/**
+ * Schema constants for browse_documents tool
+ */
+export const BROWSE_DOCUMENTS_CONSTANTS = {
+    LINK_DEPTH: {
+        MIN: 1,
+        MAX: 6,
+        DEFAULT: 2,
+    },
+    DEFAULT_PATH: '/',
+};
+/**
+ * Get the input schema for browse_documents tool
+ */
+export function getBrowseDocumentsSchema() {
+    return {
+        type: 'object',
+        properties: {
+            path: {
+                type: 'string',
+                description: 'Directory to browse (e.g., "/api", "/guides") or document path to view basic metadata',
+                default: BROWSE_DOCUMENTS_CONSTANTS.DEFAULT_PATH,
+            },
+            include_related: {
+                type: 'boolean',
+                description: 'Whether to include related document analysis (forward/backward links, content similarity, dependency chains)',
+                default: false,
+            },
+            link_depth: {
+                type: 'number',
+                description: 'Maximum depth for link traversal analysis (1-6)',
+                minimum: BROWSE_DOCUMENTS_CONSTANTS.LINK_DEPTH.MIN,
+                maximum: BROWSE_DOCUMENTS_CONSTANTS.LINK_DEPTH.MAX,
+                default: BROWSE_DOCUMENTS_CONSTANTS.LINK_DEPTH.DEFAULT,
+            },
+            verbose: {
+                type: 'boolean',
+                description: 'Show full section details (default: false for compact overview with section_count and word_count only)',
+                default: false,
+            },
+        },
+        additionalProperties: false,
+    };
+}
+//# sourceMappingURL=browse-documents-schemas.js.map

package/dist/tools/schemas/browse-documents-schemas.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"browse-documents-schemas.js","sourceRoot":"","sources":["../../../src/tools/schemas/browse-documents-schemas.ts"],"names":[],"mappings":"AAAA;;GAEG;AA+BH;;GAEG;AACH,MAAM,CAAC,MAAM,0BAA0B,GAAG;IACxC,UAAU,EAAE;QACV,GAAG,EAAE,CAAC;QACN,GAAG,EAAE,CAAC;QACN,OAAO,EAAE,CAAC;KACX;IACD,YAAY,EAAE,GAAG;CACT,CAAC;AAEX;;GAEG;AACH,MAAM,UAAU,wBAAwB;IACtC,OAAO;QACL,IAAI,EAAE,QAAQ;QACd,UAAU,EAAE;YACV,IAAI,EAAE;gBACJ,IAAI,EAAE,QAAQ;gBACd,WAAW,EAAE,uFAAuF;gBACpG,OAAO,EAAE,0BAA0B,CAAC,YAAY;aACjD;YACD,eAAe,EAAE;gBACf,IAAI,EAAE,SAAS;gBACf,WAAW,EAAE,8GAA8G;gBAC3H,OAAO,EAAE,KAAK;aACf;YACD,UAAU,EAAE;gBACV,IAAI,EAAE,QAAQ;gBACd,WAAW,EAAE,iDAAiD;gBAC9D,OAAO,EAAE,0BAA0B,CAAC,UAAU,CAAC,GAAG;gBAClD,OAAO,EAAE,0BAA0B,CAAC,UAAU,CAAC,GAAG;gBAClD,OAAO,EAAE,0BAA0B,CAAC,UAAU,CAAC,OAAO;aACvD;YACD,OAAO,EAAE;gBACP,IAAI,EAAE,SAAS;gBACf,WAAW,EAAE,wGAAwG;gBACrH,OAAO,EAAE,KAAK;aACf;SACF;QACD,oBAAoB,EAAE,KAAK;KAC5B,CAAC;AACJ,CAAC"}

package/dist/tools/schemas/complete-coordinator-task-schemas.d.ts

@@ -0,0 +1,41 @@
+/**
+ * Schema definitions for complete_coordinator_task tool
+ *
+ * COORDINATOR MODE:
+ * - Sequential only (NO #slug allowed)
+ * - Works with /coordinator/ namespace
+ * - Completes next pending task automatically
+ * - Conditionally returns next task based on return_next_task parameter (default: false)
+ * - When returning next task: includes task workflow only (NO main_workflow - use start_coordinator_task for full context)
+ * - Auto-archives when all tasks complete
+ */
+export interface CompleteCoordinatorTaskInputSchema {
+    type: 'object';
+    properties: {
+        note: {
+            type: 'string';
+            description: 'Completion notes or implementation details';
+        };
+        return_next_task: {
+            type: 'boolean';
+            description: 'Return next task with workflow (default: false). Set to true to get next task info across context compression. When true, returns task workflow only (NOT main_workflow - use start_coordinator_task for full context after compression).';
+        };
+        include_full_workflow: {
+            type: 'boolean';
+            description: 'Include full workflow content in next_task response (default: false). When false, returns only workflow name and description, saving 3,000+ characters. When true, includes full workflow.content field. Only applies when return_next_task is true.';
+        };
+    };
+    required: ['note'];
+    additionalProperties: false;
+}
+/**
+ * Schema constants for complete_coordinator_task tool
+ */
+export declare const COMPLETE_COORDINATOR_TASK_CONSTANTS: {
+    readonly MAX_NOTE_LENGTH: 1000;
+};
+/**
+ * Get the input schema for complete_coordinator_task tool
+ */
+export declare function getCompleteCoordinatorTaskSchema(): CompleteCoordinatorTaskInputSchema;
+//# sourceMappingURL=complete-coordinator-task-schemas.d.ts.map

package/dist/tools/schemas/complete-coordinator-task-schemas.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"complete-coordinator-task-schemas.d.ts","sourceRoot":"","sources":["../../../src/tools/schemas/complete-coordinator-task-schemas.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;GAUG;AAEH,MAAM,WAAW,kCAAkC;IACjD,IAAI,EAAE,QAAQ,CAAC;IACf,UAAU,EAAE;QACV,IAAI,EAAE;YACJ,IAAI,EAAE,QAAQ,CAAC;YACf,WAAW,EAAE,4CAA4C,CAAC;SAC3D,CAAC;QACF,gBAAgB,EAAE;YAChB,IAAI,EAAE,SAAS,CAAC;YAChB,WAAW,EAAE,2OAA2O,CAAC;SAC1P,CAAC;QACF,qBAAqB,EAAE;YACrB,IAAI,EAAE,SAAS,CAAC;YAChB,WAAW,EAAE,sPAAsP,CAAC;SACrQ,CAAC;KACH,CAAC;IACF,QAAQ,EAAE,CAAC,MAAM,CAAC,CAAC;IACnB,oBAAoB,EAAE,KAAK,CAAC;CAC7B;AAED;;GAEG;AACH,eAAO,MAAM,mCAAmC;;CAEtC,CAAC;AAEX;;GAEG;AACH,wBAAgB,gCAAgC,IAAI,kCAAkC,CAoBrF"}