specmem-hardwicksoftware 3.5.99

package/dist/skills/skillsResource.js

@@ -0,0 +1,257 @@
+/**
+ * skillsResource.ts - MCP Resource Provider for Skills
+ *
+ * exposes all skills as MCP resources so  can access them
+ * provides list and read endpoints for the MCP protocol
+ *
+ * Features:
+ * - Dynamic resource listing from skill scanner
+ * - Individual skill content access
+ * - Category-based organization
+ * - Auto-update when skills change
+ */
+import { getSkillScanner } from './skillScanner.js';
+import { logger } from '../utils/logger.js';
+/**
+ * SkillResourceProvider - provides MCP resources for skills
+ */
+export class SkillResourceProvider {
+    scanner;
+    baseUri = 'specmem://skills';
+    constructor(scanner) {
+        this.scanner = scanner || getSkillScanner();
+    }
+    /**
+     * getResources - returns all skills as MCP resources
+     */
+    getResources() {
+        const resources = [];
+        // add master skill list resource
+        resources.push({
+            uri: `${this.baseUri}/list`,
+            name: 'All Skills',
+            description: 'Complete list of all available skills with descriptions',
+            mimeType: 'text/markdown'
+        });
+        // add category index resource
+        resources.push({
+            uri: `${this.baseUri}/categories`,
+            name: 'Skill Categories',
+            description: 'Index of all skill categories',
+            mimeType: 'text/markdown'
+        });
+        // add individual skill resources
+        const skills = this.scanner.getAllSkills();
+        for (const skill of skills) {
+            resources.push({
+                uri: `${this.baseUri}/${skill.id}`,
+                name: skill.name,
+                description: skill.description || `Skill: ${skill.name} (${skill.category})`,
+                mimeType: 'text/markdown'
+            });
+        }
+        // add category resources
+        const categories = this.scanner.getCategories();
+        for (const category of categories) {
+            resources.push({
+                uri: `${this.baseUri}/category/${category}`,
+                name: `Category: ${category}`,
+                description: `All skills in the ${category} category`,
+                mimeType: 'text/markdown'
+            });
+        }
+        return resources;
+    }
+    /**
+     * readResource - reads content for a specific resource URI
+     */
+    async readResource(uri) {
+        const path = uri.replace(this.baseUri, '').replace(/^\//, '');
+        logger.debug({ uri, path }, 'reading skill resource');
+        // handle master list
+        if (path === 'list' || path === '') {
+            return this.getSkillListContent(uri);
+        }
+        // handle categories index
+        if (path === 'categories') {
+            return this.getCategoriesContent(uri);
+        }
+        // handle category listing
+        if (path.startsWith('category/')) {
+            const category = path.replace('category/', '');
+            return this.getCategoryContent(uri, category);
+        }
+        // handle individual skill
+        const skill = this.scanner.getSkillById(path);
+        if (skill) {
+            return this.getSkillContent(uri, skill);
+        }
+        throw new Error(`Skill resource not found: ${uri}`);
+    }
+    /**
+     * getSkillListContent - generates master skill list
+     */
+    getSkillListContent(uri) {
+        const skills = this.scanner.getAllSkills();
+        const categories = this.scanner.getCategories();
+        let content = `# SpecMem Skills Library\n\n`;
+        content += `**Total Skills**: ${skills.length}\n`;
+        content += `**Categories**: ${categories.length}\n\n`;
+        content += `---\n\n`;
+        // table of contents
+        content += `## Table of Contents\n\n`;
+        for (const category of categories) {
+            const categorySkills = this.scanner.getSkillsByCategory(category);
+            content += `- [${this.capitalize(category)}](#${category}) (${categorySkills.length} skills)\n`;
+        }
+        content += '\n---\n\n';
+        // skill listings by category
+        for (const category of categories) {
+            const categorySkills = this.scanner.getSkillsByCategory(category);
+            content += `## ${this.capitalize(category)}\n\n`;
+            for (const skill of categorySkills) {
+                content += `### ${skill.name}\n`;
+                content += `- **ID**: \`${skill.id}\`\n`;
+                content += `- **File**: \`${skill.relativePath}\`\n`;
+                if (skill.description) {
+                    content += `- **Description**: ${skill.description}\n`;
+                }
+                content += `- **Tags**: ${skill.tags.join(', ')}\n`;
+                content += `- **URI**: \`specmem://skills/${skill.id}\`\n`;
+                content += '\n';
+            }
+        }
+        return {
+            uri,
+            mimeType: 'text/markdown',
+            text: content
+        };
+    }
+    /**
+     * getCategoriesContent - generates category index
+     */
+    getCategoriesContent(uri) {
+        const categories = this.scanner.getCategories();
+        let content = `# Skill Categories\n\n`;
+        content += `Total Categories: ${categories.length}\n\n`;
+        for (const category of categories) {
+            const skills = this.scanner.getSkillsByCategory(category);
+            content += `## ${this.capitalize(category)}\n`;
+            content += `- **Skills**: ${skills.length}\n`;
+            content += `- **URI**: \`specmem://skills/category/${category}\`\n`;
+            content += `- **Skills**: ${skills.map(s => s.name).join(', ')}\n\n`;
+        }
+        return {
+            uri,
+            mimeType: 'text/markdown',
+            text: content
+        };
+    }
+    /**
+     * getCategoryContent - generates content for a specific category
+     */
+    getCategoryContent(uri, category) {
+        const skills = this.scanner.getSkillsByCategory(category);
+        if (skills.length === 0) {
+            throw new Error(`Category not found: ${category}`);
+        }
+        let content = `# ${this.capitalize(category)} Skills\n\n`;
+        content += `Total Skills: ${skills.length}\n\n`;
+        content += `---\n\n`;
+        for (const skill of skills) {
+            content += `## ${skill.name}\n\n`;
+            if (skill.description) {
+                content += `> ${skill.description}\n\n`;
+            }
+            content += `**Tags**: ${skill.tags.join(', ')}\n\n`;
+            content += `**Full Content**:\n\n`;
+            content += '```markdown\n';
+            content += skill.content;
+            content += '\n```\n\n';
+            content += `---\n\n`;
+        }
+        return {
+            uri,
+            mimeType: 'text/markdown',
+            text: content
+        };
+    }
+    /**
+     * getSkillContent - returns full skill content
+     */
+    getSkillContent(uri, skill) {
+        let content = `# ${skill.name}\n\n`;
+        content += `**Category**: ${skill.category}\n`;
+        if (skill.subcategory) {
+            content += `**Subcategory**: ${skill.subcategory}\n`;
+        }
+        content += `**File**: ${skill.relativePath}\n`;
+        content += `**Tags**: ${skill.tags.join(', ')}\n`;
+        content += `**Last Modified**: ${skill.lastModified.toISOString()}\n`;
+        content += `**Size**: ${skill.sizeBytes} bytes\n\n`;
+        content += `---\n\n`;
+        content += skill.content;
+        return {
+            uri,
+            mimeType: 'text/markdown',
+            text: content
+        };
+    }
+    /**
+     * capitalize - capitalizes first letter
+     */
+    capitalize(str) {
+        return str.charAt(0).toUpperCase() + str.slice(1);
+    }
+    /**
+     * getSkillSummaryForPrompt - returns a compact summary for system prompts
+     */
+    getSkillSummaryForPrompt() {
+        const skills = this.scanner.getAllSkills();
+        const categories = this.scanner.getCategories();
+        let summary = `## Available Skills (${skills.length})\n\n`;
+        for (const category of categories) {
+            const categorySkills = this.scanner.getSkillsByCategory(category);
+            summary += `### ${this.capitalize(category)}\n`;
+            for (const skill of categorySkills) {
+                summary += `- **${skill.name}**: ${skill.description || 'No description'}\n`;
+                summary += `  - Access via: \`specmem://skills/${skill.id}\`\n`;
+            }
+            summary += '\n';
+        }
+        return summary;
+    }
+    /**
+     * getAllSkillsContent - returns ALL skill content combined (for context)
+     */
+    getAllSkillsContent() {
+        const skills = this.scanner.getAllSkills();
+        let content = `# Complete Skills Reference\n\n`;
+        content += `Total Skills: ${skills.length}\n\n`;
+        content += `---\n\n`;
+        for (const skill of skills) {
+            content += `# ${skill.name} (${skill.category})\n\n`;
+            content += skill.content;
+            content += '\n\n---\n\n';
+        }
+        return content;
+    }
+}
+// Singleton instance
+let resourceProviderInstance = null;
+/**
+ * getSkillResourceProvider - returns singleton provider
+ */
+export function getSkillResourceProvider(scanner) {
+    if (!resourceProviderInstance) {
+        resourceProviderInstance = new SkillResourceProvider(scanner);
+    }
+    return resourceProviderInstance;
+}
+/**
+ * resetSkillResourceProvider - resets singleton (for testing)
+ */
+export function resetSkillResourceProvider() {
+    resourceProviderInstance = null;
+}
+//# sourceMappingURL=skillsResource.js.map

package/dist/skills/skillsResource.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"skillsResource.js","sourceRoot":"","sources":["../../src/skills/skillsResource.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;GAWG;AAGH,OAAO,EAAuB,eAAe,EAAE,MAAM,mBAAmB,CAAC;AACzE,OAAO,EAAE,MAAM,EAAE,MAAM,oBAAoB,CAAC;AAK5C;;GAEG;AACH,MAAM,OAAO,qBAAqB;IACxB,OAAO,CAAe;IACtB,OAAO,GAAG,kBAAkB,CAAC;IAErC,YAAY,OAAsB;QAChC,IAAI,CAAC,OAAO,GAAG,OAAO,IAAI,eAAe,EAAE,CAAC;IAC9C,CAAC;IAED;;OAEG;IACH,YAAY;QACV,MAAM,SAAS,GAAe,EAAE,CAAC;QAEjC,iCAAiC;QACjC,SAAS,CAAC,IAAI,CAAC;YACb,GAAG,EAAE,GAAG,IAAI,CAAC,OAAO,OAAO;YAC3B,IAAI,EAAE,YAAY;YAClB,WAAW,EAAE,yDAAyD;YACtE,QAAQ,EAAE,eAAe;SAC1B,CAAC,CAAC;QAEH,8BAA8B;QAC9B,SAAS,CAAC,IAAI,CAAC;YACb,GAAG,EAAE,GAAG,IAAI,CAAC,OAAO,aAAa;YACjC,IAAI,EAAE,kBAAkB;YACxB,WAAW,EAAE,+BAA+B;YAC5C,QAAQ,EAAE,eAAe;SAC1B,CAAC,CAAC;QAEH,iCAAiC;QACjC,MAAM,MAAM,GAAG,IAAI,CAAC,OAAO,CAAC,YAAY,EAAE,CAAC;QAC3C,KAAK,MAAM,KAAK,IAAI,MAAM,EAAE,CAAC;YAC3B,SAAS,CAAC,IAAI,CAAC;gBACb,GAAG,EAAE,GAAG,IAAI,CAAC,OAAO,IAAI,KAAK,CAAC,EAAE,EAAE;gBAClC,IAAI,EAAE,KAAK,CAAC,IAAI;gBAChB,WAAW,EAAE,KAAK,CAAC,WAAW,IAAI,UAAU,KAAK,CAAC,IAAI,KAAK,KAAK,CAAC,QAAQ,GAAG;gBAC5E,QAAQ,EAAE,eAAe;aAC1B,CAAC,CAAC;QACL,CAAC;QAED,yBAAyB;QACzB,MAAM,UAAU,GAAG,IAAI,CAAC,OAAO,CAAC,aAAa,EAAE,CAAC;QAChD,KAAK,MAAM,QAAQ,IAAI,UAAU,EAAE,CAAC;YAClC,SAAS,CAAC,IAAI,CAAC;gBACb,GAAG,EAAE,GAAG,IAAI,CAAC,OAAO,aAAa,QAAQ,EAAE;gBAC3C,IAAI,EAAE,aAAa,QAAQ,EAAE;gBAC7B,WAAW,EAAE,qBAAqB,QAAQ,WAAW;gBACrD,QAAQ,EAAE,eAAe;aAC1B,CAAC,CAAC;QACL,CAAC;QAED,OAAO,SAAS,CAAC;IACnB,CAAC;IAED;;OAEG;IACH,KAAK,CAAC,YAAY,CAAC,GAAW;QAC5B,MAAM,IAAI,GAAG,GAAG,CAAC,OAAO,CAAC,IAAI,CAAC,OAAO,EAAE,EAAE,CAAC,CAAC,OAAO,CAAC,KAAK,EAAE,EAAE,CAAC,CAAC;QAE9D,MAAM,CAAC,KAAK,CAAC,EAAE,GAAG,EAAE,IAAI,EAAE,EAAE,wBAAwB,CAAC,CAAC;QAEtD,qBAAqB;QACrB,IAAI,IAAI,KAAK,MAAM,IAAI,IAAI,KAAK,EAAE,EAAE,CAAC;YACnC,OAAO,IAAI,CAAC,mBAAmB,CAAC,GAAG,CAAC,CAAC;QACvC,CAAC;QAED,0BAA0B;QAC1B,IAAI,IAAI,KAAK,YAAY,EAAE,CAAC;YAC1B,OAAO,IAAI,CAAC,oBAAoB,CAAC,GAAG,CAAC,CAAC;QACxC,CAAC;QAED,0BAA0B;QAC1B,IAAI,IAAI,CAAC,UAAU,CAAC,WAAW,CAAC,EAAE,CAAC;YACjC,MAAM,QAAQ,GAAG,IAAI,CAAC,OAAO,CAAC,WAAW,EAAE,EAAE,CAAC,CAAC;YAC/C,OAAO,IAAI,CAAC,kBAAkB,CAAC,GAAG,EAAE,QAAQ,CAAC,CAAC;QAChD,CAAC;QAED,0BAA0B;QAC1B,MAAM,KAAK,GAAG,IAAI,CAAC,OAAO,CAAC,YAAY,CAAC,IAAI,CAAC,CAAC;QAC9C,IAAI,KAAK,EAAE,CAAC;YACV,OAAO,IAAI,CAAC,eAAe,CAAC,GAAG,EAAE,KAAK,CAAC,CAAC;QAC1C,CAAC;QAED,MAAM,IAAI,KAAK,CAAC,6BAA6B,GAAG,EAAE,CAAC,CAAC;IACtD,CAAC;IAED;;OAEG;IACK,mBAAmB,CAAC,GAAW;QACrC,MAAM,MAAM,GAAG,IAAI,CAAC,OAAO,CAAC,YAAY,EAAE,CAAC;QAC3C,MAAM,UAAU,GAAG,IAAI,CAAC,OAAO,CAAC,aAAa,EAAE,CAAC;QAEhD,IAAI,OAAO,GAAG,8BAA8B,CAAC;QAC7C,OAAO,IAAI,qBAAqB,MAAM,CAAC,MAAM,IAAI,CAAC;QAClD,OAAO,IAAI,mBAAmB,UAAU,CAAC,MAAM,MAAM,CAAC;QACtD,OAAO,IAAI,SAAS,CAAC;QAErB,oBAAoB;QACpB,OAAO,IAAI,0BAA0B,CAAC;QACtC,KAAK,MAAM,QAAQ,IAAI,UAAU,EAAE,CAAC;YAClC,MAAM,cAAc,GAAG,IAAI,CAAC,OAAO,CAAC,mBAAmB,CAAC,QAAQ,CAAC,CAAC;YAClE,OAAO,IAAI,MAAM,IAAI,CAAC,UAAU,CAAC,QAAQ,CAAC,MAAM,QAAQ,MAAM,cAAc,CAAC,MAAM,YAAY,CAAC;QAClG,CAAC;QACD,OAAO,IAAI,WAAW,CAAC;QAEvB,6BAA6B;QAC7B,KAAK,MAAM,QAAQ,IAAI,UAAU,EAAE,CAAC;YAClC,MAAM,cAAc,GAAG,IAAI,CAAC,OAAO,CAAC,mBAAmB,CAAC,QAAQ,CAAC,CAAC;YAElE,OAAO,IAAI,MAAM,IAAI,CAAC,UAAU,CAAC,QAAQ,CAAC,MAAM,CAAC;YAEjD,KAAK,MAAM,KAAK,IAAI,cAAc,EAAE,CAAC;gBACnC,OAAO,IAAI,OAAO,KAAK,CAAC,IAAI,IAAI,CAAC;gBACjC,OAAO,IAAI,eAAe,KAAK,CAAC,EAAE,MAAM,CAAC;gBACzC,OAAO,IAAI,iBAAiB,KAAK,CAAC,YAAY,MAAM,CAAC;gBACrD,IAAI,KAAK,CAAC,WAAW,EAAE,CAAC;oBACtB,OAAO,IAAI,sBAAsB,KAAK,CAAC,WAAW,IAAI,CAAC;gBACzD,CAAC;gBACD,OAAO,IAAI,eAAe,KAAK,CAAC,IAAI,CAAC,IAAI,CAAC,IAAI,CAAC,IAAI,CAAC;gBACpD,OAAO,IAAI,iCAAiC,KAAK,CAAC,EAAE,MAAM,CAAC;gBAC3D,OAAO,IAAI,IAAI,CAAC;YAClB,CAAC;QACH,CAAC;QAED,OAAO;YACL,GAAG;YACH,QAAQ,EAAE,eAAe;YACzB,IAAI,EAAE,OAAO;SACd,CAAC;IACJ,CAAC;IAED;;OAEG;IACK,oBAAoB,CAAC,GAAW;QACtC,MAAM,UAAU,GAAG,IAAI,CAAC,OAAO,CAAC,aAAa,EAAE,CAAC;QAEhD,IAAI,OAAO,GAAG,wBAAwB,CAAC;QACvC,OAAO,IAAI,qBAAqB,UAAU,CAAC,MAAM,MAAM,CAAC;QAExD,KAAK,MAAM,QAAQ,IAAI,UAAU,EAAE,CAAC;YAClC,MAAM,MAAM,GAAG,IAAI,CAAC,OAAO,CAAC,mBAAmB,CAAC,QAAQ,CAAC,CAAC;YAC1D,OAAO,IAAI,MAAM,IAAI,CAAC,UAAU,CAAC,QAAQ,CAAC,IAAI,CAAC;YAC/C,OAAO,IAAI,iBAAiB,MAAM,CAAC,MAAM,IAAI,CAAC;YAC9C,OAAO,IAAI,0CAA0C,QAAQ,MAAM,CAAC;YACpE,OAAO,IAAI,iBAAiB,MAAM,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC,IAAI,CAAC,IAAI,CAAC,MAAM,CAAC;QACvE,CAAC;QAED,OAAO;YACL,GAAG;YACH,QAAQ,EAAE,eAAe;YACzB,IAAI,EAAE,OAAO;SACd,CAAC;IACJ,CAAC;IAED;;OAEG;IACK,kBAAkB,CAAC,GAAW,EAAE,QAAgB;QACtD,MAAM,MAAM,GAAG,IAAI,CAAC,OAAO,CAAC,mBAAmB,CAAC,QAAQ,CAAC,CAAC;QAE1D,IAAI,MAAM,CAAC,MAAM,KAAK,CAAC,EAAE,CAAC;YACxB,MAAM,IAAI,KAAK,CAAC,uBAAuB,QAAQ,EAAE,CAAC,CAAC;QACrD,CAAC;QAED,IAAI,OAAO,GAAG,KAAK,IAAI,CAAC,UAAU,CAAC,QAAQ,CAAC,aAAa,CAAC;QAC1D,OAAO,IAAI,iBAAiB,MAAM,CAAC,MAAM,MAAM,CAAC;QAChD,OAAO,IAAI,SAAS,CAAC;QAErB,KAAK,MAAM,KAAK,IAAI,MAAM,EAAE,CAAC;YAC3B,OAAO,IAAI,MAAM,KAAK,CAAC,IAAI,MAAM,CAAC;YAClC,IAAI,KAAK,CAAC,WAAW,EAAE,CAAC;gBACtB,OAAO,IAAI,KAAK,KAAK,CAAC,WAAW,MAAM,CAAC;YAC1C,CAAC;YACD,OAAO,IAAI,aAAa,KAAK,CAAC,IAAI,CAAC,IAAI,CAAC,IAAI,CAAC,MAAM,CAAC;YACpD,OAAO,IAAI,uBAAuB,CAAC;YACnC,OAAO,IAAI,eAAe,CAAC;YAC3B,OAAO,IAAI,KAAK,CAAC,OAAO,CAAC;YACzB,OAAO,IAAI,WAAW,CAAC;YACvB,OAAO,IAAI,SAAS,CAAC;QACvB,CAAC;QAED,OAAO;YACL,GAAG;YACH,QAAQ,EAAE,eAAe;YACzB,IAAI,EAAE,OAAO;SACd,CAAC;IACJ,CAAC;IAED;;OAEG;IACK,eAAe,CAAC,GAAW,EAAE,KAAY;QAC/C,IAAI,OAAO,GAAG,KAAK,KAAK,CAAC,IAAI,MAAM,CAAC;QACpC,OAAO,IAAI,iBAAiB,KAAK,CAAC,QAAQ,IAAI,CAAC;QAC/C,IAAI,KAAK,CAAC,WAAW,EAAE,CAAC;YACtB,OAAO,IAAI,oBAAoB,KAAK,CAAC,WAAW,IAAI,CAAC;QACvD,CAAC;QACD,OAAO,IAAI,aAAa,KAAK,CAAC,YAAY,IAAI,CAAC;QAC/C,OAAO,IAAI,aAAa,KAAK,CAAC,IAAI,CAAC,IAAI,CAAC,IAAI,CAAC,IAAI,CAAC;QAClD,OAAO,IAAI,sBAAsB,KAAK,CAAC,YAAY,CAAC,WAAW,EAAE,IAAI,CAAC;QACtE,OAAO,IAAI,aAAa,KAAK,CAAC,SAAS,YAAY,CAAC;QACpD,OAAO,IAAI,SAAS,CAAC;QACrB,OAAO,IAAI,KAAK,CAAC,OAAO,CAAC;QAEzB,OAAO;YACL,GAAG;YACH,QAAQ,EAAE,eAAe;YACzB,IAAI,EAAE,OAAO;SACd,CAAC;IACJ,CAAC;IAED;;OAEG;IACK,UAAU,CAAC,GAAW;QAC5B,OAAO,GAAG,CAAC,MAAM,CAAC,CAAC,CAAC,CAAC,WAAW,EAAE,GAAG,GAAG,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC;IACpD,CAAC;IAED;;OAEG;IACH,wBAAwB;QACtB,MAAM,MAAM,GAAG,IAAI,CAAC,OAAO,CAAC,YAAY,EAAE,CAAC;QAC3C,MAAM,UAAU,GAAG,IAAI,CAAC,OAAO,CAAC,aAAa,EAAE,CAAC;QAEhD,IAAI,OAAO,GAAG,wBAAwB,MAAM,CAAC,MAAM,OAAO,CAAC;QAE3D,KAAK,MAAM,QAAQ,IAAI,UAAU,EAAE,CAAC;YAClC,MAAM,cAAc,GAAG,IAAI,CAAC,OAAO,CAAC,mBAAmB,CAAC,QAAQ,CAAC,CAAC;YAClE,OAAO,IAAI,OAAO,IAAI,CAAC,UAAU,CAAC,QAAQ,CAAC,IAAI,CAAC;YAEhD,KAAK,MAAM,KAAK,IAAI,cAAc,EAAE,CAAC;gBACnC,OAAO,IAAI,OAAO,KAAK,CAAC,IAAI,OAAO,KAAK,CAAC,WAAW,IAAI,gBAAgB,IAAI,CAAC;gBAC7E,OAAO,IAAI,sCAAsC,KAAK,CAAC,EAAE,MAAM,CAAC;YAClE,CAAC;YACD,OAAO,IAAI,IAAI,CAAC;QAClB,CAAC;QAED,OAAO,OAAO,CAAC;IACjB,CAAC;IAED;;OAEG;IACH,mBAAmB;QACjB,MAAM,MAAM,GAAG,IAAI,CAAC,OAAO,CAAC,YAAY,EAAE,CAAC;QAE3C,IAAI,OAAO,GAAG,iCAAiC,CAAC;QAChD,OAAO,IAAI,iBAAiB,MAAM,CAAC,MAAM,MAAM,CAAC;QAChD,OAAO,IAAI,SAAS,CAAC;QAErB,KAAK,MAAM,KAAK,IAAI,MAAM,EAAE,CAAC;YAC3B,OAAO,IAAI,KAAK,KAAK,CAAC,IAAI,KAAK,KAAK,CAAC,QAAQ,OAAO,CAAC;YACrD,OAAO,IAAI,KAAK,CAAC,OAAO,CAAC;YACzB,OAAO,IAAI,aAAa,CAAC;QAC3B,CAAC;QAED,OAAO,OAAO,CAAC;IACjB,CAAC;CACF;AAED,qBAAqB;AACrB,IAAI,wBAAwB,GAAiC,IAAI,CAAC;AAElE;;GAEG;AACH,MAAM,UAAU,wBAAwB,CAAC,OAAsB;IAC7D,IAAI,CAAC,wBAAwB,EAAE,CAAC;QAC9B,wBAAwB,GAAG,IAAI,qBAAqB,CAAC,OAAO,CAAC,CAAC;IAChE,CAAC;IACD,OAAO,wBAAwB,CAAC;AAClC,CAAC;AAED;;GAEG;AACH,MAAM,UAAU,0BAA0B;IACxC,wBAAwB,GAAG,IAAI,CAAC;AAClC,CAAC"}

package/dist/startup/index.d.ts

@@ -0,0 +1,9 @@
+/**
+ * SpecMem Startup Module
+ *
+ * Pre-flight validation and initialization checks.
+ * Automatic indexing on startup.
+ */
+export { runStartupValidation, validateOrExit, quickValidation, fullValidation, formatValidationErrors, ValidationResult, ValidationError, ValidationOptions, ExitCode, EXIT_CODES, } from './validation.js';
+export { runStartupIndexing, checkCodebaseIndexStatus, checkSessionExtractionStatus, triggerBackgroundIndexing, triggerBackgroundSessionExtraction, getIndexingStatus, } from './startupIndexing.js';
+//# sourceMappingURL=index.d.ts.map

package/dist/startup/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/startup/index.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH,OAAO,EAEL,oBAAoB,EACpB,cAAc,EACd,eAAe,EACf,cAAc,EACd,sBAAsB,EAGtB,gBAAgB,EAChB,eAAe,EACf,iBAAiB,EACjB,QAAQ,EACR,UAAU,GACX,MAAM,iBAAiB,CAAC;AAGzB,OAAO,EACL,kBAAkB,EAClB,wBAAwB,EACxB,4BAA4B,EAC5B,yBAAyB,EACzB,kCAAkC,EAClC,iBAAiB,GAClB,MAAM,sBAAsB,CAAC"}

package/dist/startup/index.js

@@ -0,0 +1,12 @@
+/**
+ * SpecMem Startup Module
+ *
+ * Pre-flight validation and initialization checks.
+ * Automatic indexing on startup.
+ */
+export { 
+// Main validation functions
+runStartupValidation, validateOrExit, quickValidation, fullValidation, formatValidationErrors, EXIT_CODES, } from './validation.js';
+// Startup indexing - auto-index codebase and extract sessions
+export { runStartupIndexing, checkCodebaseIndexStatus, checkSessionExtractionStatus, triggerBackgroundIndexing, triggerBackgroundSessionExtraction, getIndexingStatus, } from './startupIndexing.js';
+//# sourceMappingURL=index.js.map

package/dist/startup/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/startup/index.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH,OAAO;AACL,4BAA4B;AAC5B,oBAAoB,EACpB,cAAc,EACd,eAAe,EACf,cAAc,EACd,sBAAsB,EAOtB,UAAU,GACX,MAAM,iBAAiB,CAAC;AAEzB,8DAA8D;AAC9D,OAAO,EACL,kBAAkB,EAClB,wBAAwB,EACxB,4BAA4B,EAC5B,yBAAyB,EACzB,kCAAkC,EAClC,iBAAiB,GAClB,MAAM,sBAAsB,CAAC"}

package/dist/startup/startupIndexing.d.ts

@@ -0,0 +1,80 @@
+/**
+ * startupIndexing.ts - Automatic Indexing on MCP Server Startup
+ *
+ * FIXES THE PROBLEM: When MCP server starts, it doesn't automatically index
+ * the codebase or extract sessions. This module provides:
+ *
+ * 1. Check if codebase is indexed (or stale)
+ * 2. Check if sessions are extracted (or new ones exist)
+ * 3. Trigger background indexing/extraction when needed
+ * 4. Report progress in server logs
+ *
+ * Everything is ready when  starts, not on-demand!
+ */
+import { DatabaseManager } from '../database.js';
+import { EmbeddingProvider } from '../tools/index.js';
+/**
+ * Check if codebase has been indexed for this project
+ * Returns stats about the current index state
+ */
+export declare function checkCodebaseIndexStatus(db: DatabaseManager): Promise<{
+    isIndexed: boolean;
+    fileCount: number;
+    lastIndexed: Date | null;
+    needsReindex: boolean;
+}>;
+/**
+ * Check if  sessions have been extracted
+ * Returns stats about extracted sessions
+ */
+export declare function checkSessionExtractionStatus(db: DatabaseManager): Promise<{
+    hasExtractedSessions: boolean;
+    sessionCount: number;
+    lastExtraction: Date | null;
+    needsExtraction: boolean;
+}>;
+/**
+ * Trigger background codebase indexing
+ * Runs asynchronously and logs progress
+ */
+export declare function triggerBackgroundIndexing(embeddingProvider: EmbeddingProvider, options?: {
+    force?: boolean;
+    silent?: boolean;
+}): Promise<void>;
+/**
+ * Trigger background session extraction
+ * Extracts  Code sessions asynchronously
+ */
+export declare function triggerBackgroundSessionExtraction(embeddingProvider: EmbeddingProvider, options?: {
+    force?: boolean;
+    silent?: boolean;
+    mode?: 'all' | 'new';
+}): Promise<void>;
+/**
+ * Run startup indexing checks and trigger background tasks
+ * This is called from main() after MCP connection is established
+ */
+export declare function runStartupIndexing(embeddingProvider: EmbeddingProvider, options?: {
+    skipCodebase?: boolean;
+    skipSessions?: boolean;
+    force?: boolean;
+}): Promise<{
+    codebaseStatus: {
+        wasIndexed: boolean;
+        triggeredIndexing: boolean;
+    };
+    sessionStatus: {
+        wasExtracted: boolean;
+        triggeredExtraction: boolean;
+    };
+}>;
+/**
+ * Get current indexing status for dashboard/status queries
+ */
+export declare function getIndexingStatus(projectPath?: string): {
+    codebaseIndexing: boolean;
+    sessionExtraction: boolean;
+    lastCodebaseCheck: Date | null;
+    lastSessionCheck: Date | null;
+};
+//# sourceMappingURL=startupIndexing.d.ts.map

package/dist/startup/startupIndexing.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"startupIndexing.d.ts","sourceRoot":"","sources":["../../src/startup/startupIndexing.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;GAYG;AAGH,OAAO,EAAE,eAAe,EAAe,MAAM,gBAAgB,CAAC;AAC9D,OAAO,EAAE,iBAAiB,EAAE,MAAM,mBAAmB,CAAC;AAmFtD;;;GAGG;AACH,wBAAsB,wBAAwB,CAAC,EAAE,EAAE,eAAe,GAAG,OAAO,CAAC;IAC3E,SAAS,EAAE,OAAO,CAAC;IACnB,SAAS,EAAE,MAAM,CAAC;IAClB,WAAW,EAAE,IAAI,GAAG,IAAI,CAAC;IACzB,YAAY,EAAE,OAAO,CAAC;CACvB,CAAC,CAqCD;AAED;;;GAGG;AACH,wBAAsB,4BAA4B,CAAC,EAAE,EAAE,eAAe,GAAG,OAAO,CAAC;IAC/E,oBAAoB,EAAE,OAAO,CAAC;IAC9B,YAAY,EAAE,MAAM,CAAC;IACrB,cAAc,EAAE,IAAI,GAAG,IAAI,CAAC;IAC5B,eAAe,EAAE,OAAO,CAAC;CAC1B,CAAC,CAsCD;AAED;;;GAGG;AACH,wBAAsB,yBAAyB,CAC7C,iBAAiB,EAAE,iBAAiB,EACpC,OAAO,GAAE;IACP,KAAK,CAAC,EAAE,OAAO,CAAC;IAChB,MAAM,CAAC,EAAE,OAAO,CAAC;CACb,GACL,OAAO,CAAC,IAAI,CAAC,CA0Ef;AAED;;;GAGG;AACH,wBAAsB,kCAAkC,CACtD,iBAAiB,EAAE,iBAAiB,EACpC,OAAO,GAAE;IACP,KAAK,CAAC,EAAE,OAAO,CAAC;IAChB,MAAM,CAAC,EAAE,OAAO,CAAC;IACjB,IAAI,CAAC,EAAE,KAAK,GAAG,KAAK,CAAC;CACjB,GACL,OAAO,CAAC,IAAI,CAAC,CAoNf;AAED;;;GAGG;AACH,wBAAsB,kBAAkB,CACtC,iBAAiB,EAAE,iBAAiB,EACpC,OAAO,GAAE;IACP,YAAY,CAAC,EAAE,OAAO,CAAC;IACvB,YAAY,CAAC,EAAE,OAAO,CAAC;IACvB,KAAK,CAAC,EAAE,OAAO,CAAC;CACZ,GACL,OAAO,CAAC;IACT,cAAc,EAAE;QACd,UAAU,EAAE,OAAO,CAAC;QACpB,iBAAiB,EAAE,OAAO,CAAC;KAC5B,CAAC;IACF,aAAa,EAAE;QACb,YAAY,EAAE,OAAO,CAAC;QACtB,mBAAmB,EAAE,OAAO,CAAC;KAC9B,CAAC;CACH,CAAC,CA4DD;AAED;;GAEG;AACH,wBAAgB,iBAAiB,CAAC,WAAW,CAAC,EAAE,MAAM,GAAG;IACvD,gBAAgB,EAAE,OAAO,CAAC;IAC1B,iBAAiB,EAAE,OAAO,CAAC;IAC3B,iBAAiB,EAAE,IAAI,GAAG,IAAI,CAAC;IAC/B,gBAAgB,EAAE,IAAI,GAAG,IAAI,CAAC;CAC/B,CAQA"}