specweave 1.0.32 → 1.0.33

package/dist/src/core/tools/tool-search-engine.js

@@ -0,0 +1,174 @@
+/**
+ * Tool Search Engine - BM25-inspired keyword matching
+ * @module core/tools/tool-search-engine
+ * @since v0.35.0
+ */
+const K1 = 1.2;
+const B = 0.75;
+const KEYWORD_EXACT_WEIGHT = 3.0;
+const KEYWORD_PARTIAL_WEIGHT = 1.5;
+const DESCRIPTION_WEIGHT = 1.0;
+const CAPABILITY_WEIGHT = 2.0;
+const NAME_WEIGHT = 2.5;
+export class ToolSearchEngine {
+    constructor() {
+        this.tools = new Map();
+        this.keywordIndex = new Map();
+        this.idfCache = new Map();
+        this.avgDocLength = 0;
+    }
+    buildIndex(tools) {
+        this.tools.clear();
+        this.keywordIndex.clear();
+        this.idfCache.clear();
+        let totalKeywords = 0;
+        for (const tool of tools) {
+            this.tools.set(tool.id, tool);
+            for (const keyword of tool.keywords) {
+                const lower = keyword.toLowerCase();
+                if (!this.keywordIndex.has(lower)) {
+                    this.keywordIndex.set(lower, new Set());
+                }
+                this.keywordIndex.get(lower).add(tool.id);
+            }
+            totalKeywords += tool.keywords.length;
+        }
+        this.avgDocLength = tools.length > 0 ? totalKeywords / tools.length : 0;
+        for (const keyword of this.keywordIndex.keys()) {
+            this.idfCache.set(keyword, this.calculateIDF(keyword));
+        }
+    }
+    search(query, options = {}) {
+        const { limit = 10, minScore = 0.1, type, plugin } = options;
+        const queryTerms = this.tokenize(query);
+        if (queryTerms.length === 0)
+            return [];
+        const results = [];
+        for (const tool of this.tools.values()) {
+            if (type) {
+                const types = Array.isArray(type) ? type : [type];
+                if (!types.includes(tool.type))
+                    continue;
+            }
+            if (plugin) {
+                const plugins = Array.isArray(plugin) ? plugin : [plugin];
+                if (!plugins.includes(tool.pluginName))
+                    continue;
+            }
+            const { score, matchedKeywords } = this.calculateScore(tool, queryTerms);
+            if (score >= minScore) {
+                results.push({
+                    tool: { ...tool },
+                    score: Math.min(score, 1),
+                    matchedKeywords,
+                    snippet: this.generateSnippet(tool, matchedKeywords),
+                });
+            }
+        }
+        results.sort((a, b) => b.score - a.score);
+        return results.slice(0, limit);
+    }
+    suggest(partialQuery, limit = 5) {
+        const queryLower = partialQuery.toLowerCase();
+        const suggestions = [];
+        for (const tool of this.tools.values()) {
+            let score = 0;
+            if (tool.name.toLowerCase().includes(queryLower))
+                score += NAME_WEIGHT;
+            for (const keyword of tool.keywords) {
+                if (keyword.toLowerCase().startsWith(queryLower))
+                    score += KEYWORD_PARTIAL_WEIGHT;
+            }
+            if (score > 0)
+                suggestions.push({ tool, score });
+        }
+        suggestions.sort((a, b) => b.score - a.score);
+        return suggestions.slice(0, limit).map((s) => s.tool);
+    }
+    getByKeyword(keyword) {
+        const lower = keyword.toLowerCase();
+        const toolIds = this.keywordIndex.get(lower);
+        if (!toolIds)
+            return [];
+        return Array.from(toolIds).map((id) => this.tools.get(id)).filter(Boolean);
+    }
+    tokenize(text) {
+        return text
+            .toLowerCase()
+            .split(/[\s,.:;!?()[\]{}'"]+/)
+            .map((t) => t.replace(/[^a-z0-9-]/g, ''))
+            .filter((t) => t.length >= 2);
+    }
+    calculateScore(tool, queryTerms) {
+        let score = 0;
+        const matchedKeywords = [];
+        const toolKeywordsLower = tool.keywords.map((k) => k.toLowerCase());
+        const nameLower = tool.name.toLowerCase();
+        const descLower = tool.description.toLowerCase();
+        for (const term of queryTerms) {
+            if (toolKeywordsLower.includes(term)) {
+                const idf = this.idfCache.get(term) ?? 1;
+                score += KEYWORD_EXACT_WEIGHT * idf;
+                matchedKeywords.push(term);
+                continue;
+            }
+            let partialMatch = false;
+            for (const keyword of toolKeywordsLower) {
+                if (keyword.includes(term) || term.includes(keyword)) {
+                    score += KEYWORD_PARTIAL_WEIGHT;
+                    matchedKeywords.push(keyword);
+                    partialMatch = true;
+                    break;
+                }
+            }
+            if (partialMatch)
+                continue;
+            if (nameLower.includes(term)) {
+                score += NAME_WEIGHT;
+                matchedKeywords.push(term);
+                continue;
+            }
+            if (descLower.includes(term)) {
+                score += DESCRIPTION_WEIGHT;
+                continue;
+            }
+            if (tool.capabilities) {
+                for (const cap of tool.capabilities) {
+                    if (cap.keywords.some((k) => k.toLowerCase().includes(term))) {
+                        score += CAPABILITY_WEIGHT;
+                        break;
+                    }
+                }
+            }
+        }
+        const docLength = tool.keywords.length;
+        if (docLength > 0 && this.avgDocLength > 0) {
+            const lengthNorm = 1 - B + B * (docLength / this.avgDocLength);
+            score = score / lengthNorm;
+        }
+        const maxPossibleScore = queryTerms.length * KEYWORD_EXACT_WEIGHT * 2;
+        const normalizedScore = maxPossibleScore > 0 ? score / maxPossibleScore : 0;
+        return { score: normalizedScore, matchedKeywords: [...new Set(matchedKeywords)] };
+    }
+    calculateIDF(term) {
+        const toolIds = this.keywordIndex.get(term);
+        if (!toolIds || toolIds.size === 0)
+            return 1;
+        const N = this.tools.size;
+        const df = toolIds.size;
+        return Math.log((N - df + 0.5) / (df + 0.5) + 1);
+    }
+    generateSnippet(tool, matchedKeywords) {
+        if (matchedKeywords.length === 0)
+            return tool.description.slice(0, 100);
+        let snippet = tool.description;
+        for (const keyword of matchedKeywords) {
+            // Escape regex special characters to prevent injection
+            const escaped = keyword.replace(/[.*+?^${}()|[\]\\]/g, '\\$&');
+            const regex = new RegExp(`\\b${escaped}\\b`, 'gi');
+            snippet = snippet.replace(regex, `**${keyword}**`);
+        }
+        return snippet.slice(0, 150);
+    }
+}
+//# sourceMappingURL=tool-search-engine.js.map

package/dist/src/core/tools/tool-search-engine.js.map

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

package/dist/src/core/tools/types/tool-registry-types.d.ts

@@ -0,0 +1,112 @@
+/**
+ * Tool Registry Type Definitions
+ * @module core/tools/types/tool-registry-types
+ * @since v0.35.0
+ */
+export type ToolType = 'skill' | 'agent' | 'command';
+export interface ToolCapability {
+    description: string;
+    keywords: string[];
+}
+export interface IndexedTool {
+    id: string;
+    name: string;
+    type: ToolType;
+    pluginName: string;
+    description: string;
+    keywords: string[];
+    capabilities?: ToolCapability[];
+    relativePath: string;
+    loaded: boolean;
+    indexedAt: string;
+    contentHash?: string;
+    modelPreference?: string;
+    allowedTools?: string[];
+}
+export interface LoadedTool extends IndexedTool {
+    content: string;
+    systemPrompt?: string;
+    loaded: true;
+}
+export interface ToolSearchResult {
+    tool: IndexedTool;
+    score: number;
+    matchedKeywords: string[];
+    snippet?: string;
+}
+export interface ToolSearchOptions {
+    limit?: number;
+    minScore?: number;
+    type?: ToolType | ToolType[];
+    plugin?: string | string[];
+    includeContent?: boolean;
+}
+export interface ToolRegistryData {
+    version: string;
+    tools: Record<string, IndexedTool>;
+    metadata: {
+        created: string;
+        lastUpdated: string;
+        toolCount: number;
+        buildDuration?: number;
+    };
+    keywordIndex?: Record<string, string[]>;
+}
+export interface IndexBuildOptions {
+    force?: boolean;
+    plugins?: string[];
+    emitEvents?: boolean;
+    pluginsDir?: string;
+}
+export interface IndexBuildResult {
+    success: boolean;
+    toolCount: number;
+    skillCount: number;
+    agentCount: number;
+    commandCount: number;
+    duration: number;
+    errors: string[];
+    warnings: string[];
+}
+export interface ToolEventBase {
+    timestamp: string;
+}
+export interface ToolIndexedEvent extends ToolEventBase {
+    type: 'ToolIndexed';
+    tool: IndexedTool;
+}
+export interface ToolLoadedEvent extends ToolEventBase {
+    type: 'ToolLoaded';
+    toolId: string;
+    tool: LoadedTool;
+}
+export interface RegistryRebuiltEvent extends ToolEventBase {
+    type: 'RegistryRebuilt';
+    result: IndexBuildResult;
+}
+export interface ToolSelectedEvent extends ToolEventBase {
+    type: 'ToolSelected';
+    toolId: string;
+    query: string;
+    score: number;
+    context?: string;
+}
+export type ToolEvent = ToolIndexedEvent | ToolLoadedEvent | RegistryRebuiltEvent | ToolSelectedEvent;
+export type ToolEventType = ToolEvent['type'];
+export type ToolEventHandler<T extends ToolEvent = ToolEvent> = (event: T) => void | Promise<void>;
+export interface ToolValidationResult {
+    valid: boolean;
+    errors: string[];
+    warnings: string[];
+}
+export interface ToolRegistryStats {
+    totalTools: number;
+    skillCount: number;
+    agentCount: number;
+    commandCount: number;
+    loadedCount: number;
+    pluginCount: number;
+    keywordCount: number;
+    lastUpdated: string;
+}
+//# sourceMappingURL=tool-registry-types.d.ts.map

package/dist/src/core/tools/types/tool-registry-types.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"tool-registry-types.d.ts","sourceRoot":"","sources":["../../../../../src/core/tools/types/tool-registry-types.ts"],"names":[],"mappings":"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"}

package/dist/src/core/tools/types/tool-registry-types.js

@@ -0,0 +1,7 @@
+/**
+ * Tool Registry Type Definitions
+ * @module core/tools/types/tool-registry-types
+ * @since v0.35.0
+ */
+export {};
+//# sourceMappingURL=tool-registry-types.js.map

package/dist/src/core/tools/types/tool-registry-types.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"tool-registry-types.js","sourceRoot":"","sources":["../../../../../src/core/tools/types/tool-registry-types.ts"],"names":[],"mappings":"AAAA;;;;GAIG"}

package/dist/src/init/compliance/types.d.ts

@@ -61,12 +61,12 @@ export declare const ComplianceStandardSchema: z.ZodObject<{
         healthcare: "healthcare";
         personal: "personal";
         payment: "payment";
+        children: "children";
         location: "location";
         financial: "financial";
         government: "government";
         student: "student";
         biometric: "biometric";
-        children: "children";
         sensitive: "sensitive";
     }>>;
     regions: z.ZodArray<z.ZodString>;

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "specweave",
-  "version": "1.0.32",
+  "version": "1.0.33",
   "description": "Spec-driven development framework for Claude Code. AI-native workflow with living documentation, intelligent agents, and multilingual support (9 languages). Enterprise-grade traceability with permanent specs and temporary increments.",
   "type": "module",
   "main": "dist/index.js",

package/plugins/specweave/hooks/hooks.json

@@ -31,16 +31,6 @@
           }
         ]
       },
-      {
-        "matcher": "Write|Edit",
-        "matcher_content": "\\.specweave/docs/internal/specs/_features/",
-        "hooks": [
-          {
-            "type": "command",
-            "command": "bash -c 'W=\"${CLAUDE_PLUGIN_ROOT}/hooks/universal/fail-fast-wrapper.sh\"; S=\"${CLAUDE_PLUGIN_ROOT}/hooks/v2/guards/features-folder-guard.sh\"; [[ -x \"$W\" ]] && exec \"$W\" \"$S\" || (cat >/dev/null && printf \"{\\\"decision\\\":\\\"allow\\\"}\")'"
-          }
-        ]
-      },
       {
         "matcher": "Write",
         "matcher_content": "\\.specweave/increments/\\d{3,4}E?-[^/]+/",
@@ -52,12 +42,12 @@
         ]
       },
       {
-        "matcher": "Edit|Write",
-        "matcher_content": "/src/.*\\.ts$",
+        "matcher": "Write",
+        "matcher_content": "\\.specweave/(increments/\\d{3,4}E?-[^/]+/spec\\.md|docs/internal/specs/)",
         "hooks": [
           {
             "type": "command",
-            "command": "bash -c 'W=\"${CLAUDE_PLUGIN_ROOT}/hooks/universal/fail-fast-wrapper.sh\"; S=\"${CLAUDE_PLUGIN_ROOT}/hooks/config-env-separator.sh\"; [[ -x \"$W\" ]] && exec \"$W\" \"$S\" || (cat >/dev/null && printf \"{\\\"decision\\\":\\\"allow\\\"}\")'"
+            "command": "bash -c 'W=\"${CLAUDE_PLUGIN_ROOT}/hooks/universal/fail-fast-wrapper.sh\"; S=\"${CLAUDE_PLUGIN_ROOT}/hooks/v2/guards/spec-validation-guard.sh\"; [[ -x \"$W\" ]] && exec \"$W\" \"$S\" || (cat >/dev/null && printf \"{\\\"decision\\\":\\\"allow\\\"}\")'"
           }
         ]
       }