@planu/cli 5.7.5 → 5.7.7

package/dist/tools/semantic-search-handler.js

@@ -1,71 +0,0 @@
-// tools/semantic-search-handler.ts — Handler for semantic_search tool.
-// SPEC-075 AC-07: Generates TF-IDF embedding of query, searches backend.
-import { getOrCreateBackend } from '../storage/vector-store/backend-factory.js';
-import { SemanticIndexStore } from '../storage/semantic-index-store.js';
-/**
- * Handle a semantic_search request.
- * Embeds the query with TF-IDF, then searches the vector backend.
- */
-export async function handleSemanticSearch(args) {
-    const { projectId, query, scope = 'all', topK = 5, threshold = 0.3 } = args;
-    if (!projectId) {
-        return {
-            content: [
-                {
-                    type: 'text',
-                    text: 'Error: No project ID provided. Run init_project first.',
-                },
-            ],
-            isError: true,
-        };
-    }
-    const backend = await getOrCreateBackend(projectId);
-    // Build a TF-IDF engine from existing documents so IDF is accurate
-    const type = scope === 'all' ? undefined : scope;
-    const allDocs = await backend.getAll(type);
-    if (allDocs.length === 0) {
-        return {
-            content: [
-                {
-                    type: 'text',
-                    text: `No documents found in scope "${scope}". Add specs, patterns, or knowledge first.`,
-                },
-            ],
-        };
-    }
-    // SPEC-1345: load the persisted TF-IDF index for this scope, incrementally
-    // reconciled against the current corpus (no full rebuild for unchanged docs).
-    const indexStore = new SemanticIndexStore(projectId, scope);
-    const tfidf = await indexStore.loadOrBuild(allDocs.map((doc) => ({ id: doc.id, content: doc.content })));
-    // Embed the query
-    const queryEmbedding = tfidf.embed(query);
-    // Search
-    const results = await backend.searchSimilar(queryEmbedding, topK, threshold, type);
-    if (results.length === 0) {
-        return {
-            content: [
-                {
-                    type: 'text',
-                    text: `No results found for "${query}" in scope "${scope}" with threshold ${String(threshold)}. Try a lower threshold or broader scope.`,
-                },
-            ],
-        };
-    }
-    const formatted = results.map((r, i) => {
-        const truncated = r.entry.content.length > 200 ? `${r.entry.content.slice(0, 200)}...` : r.entry.content;
-        return [
-            `${String(i + 1)}. [${r.entry.type}] ${r.entry.id}`,
-            `   Similarity: ${r.similarity.toFixed(3)}`,
-            `   ${truncated}`,
-        ].join('\n');
-    });
-    return {
-        content: [
-            {
-                type: 'text',
-                text: `Found ${String(results.length)} results for "${query}":\n\n${formatted.join('\n\n')}`,
-            },
-        ],
-    };
-}
-//# sourceMappingURL=semantic-search-handler.js.map

package/dist/tools/skill-registry/search.d.ts

@@ -1,11 +0,0 @@
-import type { ToolResult, SkillRegistrySource } from '../../types/index.js';
-export declare function loadRegistries(): SkillRegistrySource[];
-export declare function handleSkillSearch(params: {
-    query: string;
-    registry?: string;
-    stack?: string;
-    limit?: number;
-    /** SPEC-606: Specific sources to search (universal engine). */
-    sources?: string[];
-}): Promise<ToolResult>;
-//# sourceMappingURL=search.d.ts.map

package/dist/tools/skill-registry/search.js

@@ -1,159 +0,0 @@
-// @crash-shield-ignore-file — config/cache reader for Planu-controlled JSON; writer is this codebase, shape guaranteed by build/seed.
-// tools/skill-registry/search.ts — Handler for skill_search tool (SPEC-150, updated SPEC-606)
-import { searchAllRegistries } from '../../engine/skill-registry/index.js';
-import { searchSkillsUniversal } from '../../engine/skill-discovery/index.js';
-import { formatSuccess, toolResult } from '../response-helpers.js';
-import { ti } from '../../i18n/index.js';
-import { readFileSync } from 'node:fs';
-import { join, dirname } from 'node:path';
-import { fileURLToPath } from 'node:url';
-const __dirname = dirname(fileURLToPath(import.meta.url));
-const DEFAULT_REGISTRIES = [
-    {
-        id: 'builtin',
-        name: 'Planu Built-in Skills',
-        url: 'local://skill-catalog',
-        type: 'api',
-        priority: 0,
-        enabled: true,
-    },
-    {
-        id: 'anthropic',
-        name: 'Anthropic Official Skills',
-        url: 'https://github.com/anthropics/skills',
-        type: 'github',
-        priority: 1,
-        enabled: true,
-    },
-    {
-        id: 'agentskill',
-        name: 'AgentSkill.sh',
-        url: 'https://agentskill.sh',
-        type: 'api',
-        priority: 2,
-        enabled: true,
-    },
-    {
-        id: 'skillssh',
-        name: 'Skills.sh',
-        url: 'https://skills.sh',
-        type: 'npm',
-        priority: 3,
-        enabled: true,
-    },
-];
-export function loadRegistries() {
-    // Try compiled path first (dist/config/), then source path (src/config/)
-    const compiledPath = join(__dirname, '../../config/skill-registries.json');
-    const sourcePath = join(__dirname, '../../../src/config/skill-registries.json');
-    for (const configPath of [compiledPath, sourcePath]) {
-        let raw;
-        try {
-            raw = readFileSync(configPath, 'utf-8');
-        }
-        catch {
-            // File not found at this path — try next
-            continue;
-        }
-        if (!raw.trim()) {
-            // Empty file — skip, try next path
-            continue;
-        }
-        try {
-            return JSON.parse(raw);
-        }
-        catch {
-            console.warn('[skill_search] skill-registries.json is corrupted, using defaults');
-            return DEFAULT_REGISTRIES;
-        }
-    }
-    return DEFAULT_REGISTRIES;
-}
-export async function handleSkillSearch(params) {
-    try {
-        const registries = loadRegistries();
-        // Guard: query must be a non-empty string to avoid returning unfiltered catalog dumps
-        const query = typeof params.query === 'string' ? params.query.trim() : '';
-        if (query.length === 0) {
-            return toolResult(formatSuccess('No query provided', 'Provide a search term to find skills. Example: `skill_search({ query: "testing", projectPath: "..." })`'), { results: [], count: 0 });
-        }
-        const limit = Math.max(1, Math.min(params.limit ?? 10, 50));
-        // SPEC-606: When sources are specified, delegate to the universal discovery engine.
-        // Otherwise, use the existing registry-based search for backward compatibility.
-        if (params.sources && params.sources.length > 0) {
-            const universalResults = await searchSkillsUniversal(query, {
-                stack: params.stack,
-                limit,
-                sources: params.sources,
-            });
-            const lines = [];
-            if (universalResults.length === 0) {
-                lines.push(`No skills found matching **"${query}"** in sources: ${params.sources.join(', ')}.`);
-                lines.push('');
-                lines.push('Try a broader query or remove the sources filter.');
-            }
-            else {
-                lines.push('| # | Skill | Source | Description |');
-                lines.push('|---|-------|--------|-------------|');
-                universalResults.forEach((r, i) => {
-                    const desc = r.description.length > 80 ? r.description.slice(0, 77) + '...' : r.description;
-                    lines.push(`| ${String(i + 1)} | **${r.name}** | ${r.source} | ${desc} |`);
-                });
-                lines.push('');
-                lines.push('Install with: `skill_install({ name: "skill-name", projectPath: "..." })`');
-            }
-            const markdown = formatSuccess(`Found ${String(universalResults.length)} skill${universalResults.length !== 1 ? 's' : ''} (universal search)`, lines.join('\n'));
-            return toolResult(markdown, { results: universalResults, count: universalResults.length });
-        }
-        const searchParams = {
-            query,
-            registry: params.registry,
-            stack: params.stack,
-            limit,
-        };
-        const enabledCount = registries.filter((r) => {
-            if (!r.enabled) {
-                return false;
-            }
-            if (searchParams.registry &&
-                searchParams.registry !== 'all' &&
-                r.id !== searchParams.registry) {
-                return false;
-            }
-            return true;
-        }).length;
-        const results = await searchAllRegistries(searchParams, registries);
-        const lines = [];
-        if (results.length === 0) {
-            if (enabledCount === 0) {
-                lines.push('No skill registries are enabled. Check your `skill-registries.json` configuration.');
-            }
-            else {
-                lines.push(`No skills found matching **"${query}"**.`);
-                lines.push('');
-                lines.push('Suggestions:');
-                lines.push('- Try a broader search term (e.g., "test" instead of "unit-testing")');
-                lines.push('- Omit the `registry` filter to search all registries');
-                lines.push('- Check network connectivity to skill registries');
-                lines.push('- Use `sources: ["github"]` for broader universal search (SPEC-606)');
-            }
-        }
-        else {
-            lines.push('| # | Skill | Source | Description |');
-            lines.push('|---|-------|--------|-------------|');
-            results.forEach((r, i) => {
-                const desc = r.description.length > 80 ? r.description.slice(0, 77) + '...' : r.description;
-                lines.push(`| ${String(i + 1)} | **${r.name}** | ${r.source} | ${desc} |`);
-            });
-            lines.push('');
-            lines.push('Install with: `skill_install({ name: "skill-name", projectPath: "..." })`');
-        }
-        const markdown = formatSuccess(`Found ${String(results.length)} skill${results.length !== 1 ? 's' : ''}`, lines.join('\n'));
-        return toolResult(markdown, { results, count: results.length });
-    }
-    catch (error) {
-        const msg = error instanceof Error ? error.message : String(error);
-        return toolResult(ti('errors.internalError', { message: msg }) + (msg ? ` ${msg}` : ''), undefined, true);
-    }
-}
-//# sourceMappingURL=search.js.map

package/dist/tools/tool-registry/deprecated-stubs.d.ts

@@ -1,19 +0,0 @@
-import type { McpToolEntry } from '../tool-entry.js';
-/** Template for the deprecation message. Interpolated at runtime. */
-export declare const DEPRECATION_MESSAGE_TEMPLATE = "This tool has been migrated to a skill. Use the {skill} skill instead: {path}";
-/**
- * The 5 MCP tool names that have been migrated to skills.
- * Used in smoke tests (Scenario 6) and anywhere a guard on migrated tools is needed.
- */
-export declare const DEPRECATED_TOOLS: readonly ['execute_sdd_flow', 'implement_plan', 'multi_teammate_review', 'run_healing_loop', 'generate_orchestration_plan'];
-export type DeprecatedToolName = (typeof DEPRECATED_TOOLS)[number];
-/**
- * Create a McpToolEntry-compatible deprecation stub.
- *
- * - Tool stays registered → callers never see "unknown tool".
- * - Description starts with `[Deprecated]` → LLMs stop calling it.
- * - Handler always returns success (no `isError`) regardless of input.
- * - One stderr warning per process per tool (deduped).
- */
-export declare function makeDeprecationStub(toolName: string, replacementSkillPath: string, replacementSkillName: string): McpToolEntry;
-//# sourceMappingURL=deprecated-stubs.d.ts.map

package/dist/tools/tool-registry/deprecated-stubs.js

@@ -1,65 +0,0 @@
-// tools/tool-registry/deprecated-stubs.ts — Shared factory for MCP deprecation stubs (SPEC-658).
-//
-// Tools migrated to skills stay registered so callers receive a helpful message
-// instead of "unknown tool". The stub handler never throws and always returns
-// HTTP 200 with a plain-text deprecation notice.
-import { z } from 'zod';
-import { compactResult } from '../output-formatter.js';
-// ---------------------------------------------------------------------------
-// Constants
-// ---------------------------------------------------------------------------
-/** Template for the deprecation message. Interpolated at runtime. */
-export const DEPRECATION_MESSAGE_TEMPLATE = 'This tool has been migrated to a skill. Use the {skill} skill instead: {path}';
-/**
- * The 5 MCP tool names that have been migrated to skills.
- * Used in smoke tests (Scenario 6) and anywhere a guard on migrated tools is needed.
- */
-export const DEPRECATED_TOOLS = [
-    'execute_sdd_flow',
-    'implement_plan',
-    'multi_teammate_review',
-    'run_healing_loop',
-    'generate_orchestration_plan',
-];
-// ---------------------------------------------------------------------------
-// Per-process warning dedup (one stderr line per tool name per process)
-// ---------------------------------------------------------------------------
-const _warned = new Set();
-function warnOnce(toolName, skillPath) {
-    if (!_warned.has(toolName)) {
-        _warned.add(toolName);
-        process.stderr.write(`[planu] DEPRECATION: MCP tool "${toolName}" has been migrated to skill "${skillPath}". ` +
-            'Update callers to use the skill directly.\n');
-    }
-}
-// ---------------------------------------------------------------------------
-// Factory
-// ---------------------------------------------------------------------------
-/**
- * Create a McpToolEntry-compatible deprecation stub.
- *
- * - Tool stays registered → callers never see "unknown tool".
- * - Description starts with `[Deprecated]` → LLMs stop calling it.
- * - Handler always returns success (no `isError`) regardless of input.
- * - One stderr warning per process per tool (deduped).
- */
-export function makeDeprecationStub(toolName, replacementSkillPath, replacementSkillName) {
-    const message = DEPRECATION_MESSAGE_TEMPLATE.replace('{skill}', replacementSkillName).replace('{path}', replacementSkillPath);
-    return {
-        name: toolName,
-        description: `[Deprecated] Migrated to ${replacementSkillName} skill. See ${replacementSkillPath}`,
-        // eslint-disable-next-line @typescript-eslint/no-deprecated
-        schema: z.object({}).passthrough().shape,
-        // eslint-disable-next-line @typescript-eslint/no-explicit-any
-        handler: (_args) => {
-            warnOnce(toolName, replacementSkillPath);
-            return Promise.resolve(compactResult(message));
-        },
-        annotations: {
-            readOnlyHint: true,
-            title: `[Deprecated] ${toolName}`,
-        },
-        wrap: 'safe',
-    };
-}
-//# sourceMappingURL=deprecated-stubs.js.map