@planu/cli 0.72.0 → 0.73.0

package/dist/tools/schemas/workers-schema.d.ts

@@ -1,60 +1,5 @@
 import { z } from 'zod';
-export declare const WorkerTriggerSchema: z.ZodObject<{
-    type: z.ZodEnum<{
-        event: "event";
-        schedule: "schedule";
-        "file-change": "file-change";
-    }>;
-    patterns: z.ZodOptional<z.ZodArray<z.ZodString>>;
-    events: z.ZodOptional<z.ZodArray<z.ZodString>>;
-    intervalMs: z.ZodOptional<z.ZodNumber>;
-}, z.core.$strip>;
-export declare const WorkerDefinitionSchema: z.ZodObject<{
-    name: z.ZodString;
-    description: z.ZodString;
-    trigger: z.ZodObject<{
-        type: z.ZodEnum<{
-            event: "event";
-            schedule: "schedule";
-            "file-change": "file-change";
-        }>;
-        patterns: z.ZodOptional<z.ZodArray<z.ZodString>>;
-        events: z.ZodOptional<z.ZodArray<z.ZodString>>;
-        intervalMs: z.ZodOptional<z.ZodNumber>;
-    }, z.core.$strip>;
-    handler: z.ZodString;
-    priority: z.ZodNumber;
-    cooldownMs: z.ZodNumber;
-    enabled: z.ZodBoolean;
-    tier: z.ZodEnum<{
-        free: "free";
-        pro: "pro";
-    }>;
-}, z.core.$strip>;
-export declare const WorkerRegistrySchema: z.ZodObject<{
-    workers: z.ZodArray<z.ZodObject<{
-        name: z.ZodString;
-        description: z.ZodString;
-        trigger: z.ZodObject<{
-            type: z.ZodEnum<{
-                event: "event";
-                schedule: "schedule";
-                "file-change": "file-change";
-            }>;
-            patterns: z.ZodOptional<z.ZodArray<z.ZodString>>;
-            events: z.ZodOptional<z.ZodArray<z.ZodString>>;
-            intervalMs: z.ZodOptional<z.ZodNumber>;
-        }, z.core.$strip>;
-        handler: z.ZodString;
-        priority: z.ZodNumber;
-        cooldownMs: z.ZodNumber;
-        enabled: z.ZodBoolean;
-        tier: z.ZodEnum<{
-            free: "free";
-            pro: "pro";
-        }>;
-    }, z.core.$strip>>;
-}, z.core.$strip>;
+export { WorkerTriggerSchema, WorkerDefinitionSchema, WorkerRegistrySchema, } from '../../engine/workers/schema.js';
 export declare const WorkerStatusInputSchema: z.ZodObject<{
     projectId: z.ZodString;
     workerName: z.ZodOptional<z.ZodString>;

package/dist/tools/schemas/workers-schema.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"workers-schema.d.ts","sourceRoot":"","sources":["../../../src/tools/schemas/workers-schema.ts"],"names":[],"mappings":"AAEA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAMxB,eAAO,MAAM,mBAAmB;;;;;;;;;iBAoB9B,CAAC;AAEH,eAAO,MAAM,sBAAsB;;;;;;;;;;;;;;;;;;;;;iBAYjC,CAAC;AAEH,eAAO,MAAM,oBAAoB;;;;;;;;;;;;;;;;;;;;;;;iBAE/B,CAAC;AAMH,eAAO,MAAM,uBAAuB;;;iBAUlC,CAAC;AAEH,eAAO,MAAM,2BAA2B;;;;;;;;;;;;iBAkBtC,CAAC"}
+{"version":3,"file":"workers-schema.d.ts","sourceRoot":"","sources":["../../../src/tools/schemas/workers-schema.ts"],"names":[],"mappings":"AAIA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAGxB,OAAO,EACL,mBAAmB,EACnB,sBAAsB,EACtB,oBAAoB,GACrB,MAAM,gCAAgC,CAAC;AAMxC,eAAO,MAAM,uBAAuB;;;iBAUlC,CAAC;AAEH,eAAO,MAAM,2BAA2B;;;;;;;;;;;;iBAkBtC,CAAC"}

package/dist/tools/schemas/workers-schema.js

@@ -1,47 +1,11 @@
-// tools/schemas/workers-schema.ts — Zod schemas for worker tools (SPEC-078)
+// tools/schemas/workers-schema.ts — Worker tool input schemas (SPEC-078)
+// Registry schemas (WorkerTrigger/Definition/Registry) live in engine/workers/schema.ts
+// so engine/ modules can import them without violating architecture.
 import { z } from 'zod';
+// Re-export engine schemas so existing consumers of this file don't break
+export { WorkerTriggerSchema, WorkerDefinitionSchema, WorkerRegistrySchema, } from '../../engine/workers/schema.js';
 // ---------------------------------------------------------------------------
-// Registry validation schemas
-// ---------------------------------------------------------------------------
-export const WorkerTriggerSchema = z.object({
-    type: z
-        .enum(['file-change', 'event', 'schedule'])
-        .describe('Trigger type: file-change | event | schedule'),
-    patterns: z
-        .array(z.string().max(4096).describe('Glob pattern like **/*.ts'))
-        .max(100)
-        .optional()
-        .describe('Glob patterns for file-change triggers'),
-    events: z
-        .array(z.string().max(500).describe('Event name like post-create-spec'))
-        .max(100)
-        .optional()
-        .describe('Event names for event triggers'),
-    intervalMs: z
-        .number()
-        .int()
-        .positive()
-        .optional()
-        .describe('Interval in ms for schedule triggers'),
-});
-export const WorkerDefinitionSchema = z.object({
-    name: z.string().min(1).max(500).describe('Unique worker name'),
-    description: z
-        .string()
-        .max(10_000)
-        .describe('Human-readable description of what the worker does'),
-    trigger: WorkerTriggerSchema.describe('When this worker should be triggered'),
-    handler: z.string().max(4096).describe('Path to handler module'),
-    priority: z.number().int().min(1).max(10).describe('Priority 1-10, higher = more important'),
-    cooldownMs: z.number().int().min(0).describe('Minimum milliseconds between executions'),
-    enabled: z.boolean().describe('Whether the worker is active'),
-    tier: z.enum(['free', 'pro']).describe('License tier: free | pro'),
-});
-export const WorkerRegistrySchema = z.object({
-    workers: z.array(WorkerDefinitionSchema).max(1000).describe('List of worker definitions'),
-});
-// ---------------------------------------------------------------------------
-// Tool input schemas
+// Tool input schemas (tools/ only — not needed by engine/)
 // ---------------------------------------------------------------------------
 export const WorkerStatusInputSchema = z.object({
     projectId: z.string().min(1).max(500).describe('Project identifier'),

package/dist/tools/schemas/workers-schema.js.map

@@ -1 +1 @@
-{"version":3,"file":"workers-schema.js","sourceRoot":"","sources":["../../../src/tools/schemas/workers-schema.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"workers-schema.js","sourceRoot":"","sources":["../../../src/tools/schemas/workers-schema.ts"],"names":[],"mappings":"AAAA,yEAAyE;AACzE,wFAAwF;AACxF,qEAAqE;AAErE,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAExB,0EAA0E;AAC1E,OAAO,EACL,mBAAmB,EACnB,sBAAsB,EACtB,oBAAoB,GACrB,MAAM,gCAAgC,CAAC;AAExC,8EAA8E;AAC9E,2DAA2D;AAC3D,8EAA8E;AAE9E,MAAM,CAAC,MAAM,uBAAuB,GAAG,CAAC,CAAC,MAAM,CAAC;IAC9C,SAAS,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,GAAG,CAAC,GAAG,CAAC,CAAC,QAAQ,CAAC,oBAAoB,CAAC;IACpE,UAAU,EAAE,CAAC;SACV,MAAM,EAAE;SACR,GAAG,CAAC,GAAG,CAAC;SACR,QAAQ,EAAE;SACV,QAAQ,CACP,+CAA+C;QAC7C,qGAAqG,CACxG;CACJ,CAAC,CAAC;AAEH,MAAM,CAAC,MAAM,2BAA2B,GAAG,CAAC,CAAC,MAAM,CAAC;IAClD,SAAS,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,GAAG,CAAC,GAAG,CAAC,CAAC,QAAQ,CAAC,oBAAoB,CAAC;IACpE,UAAU,EAAE,CAAC;SACV,MAAM,EAAE;SACR,GAAG,CAAC,CAAC,CAAC;SACN,GAAG,CAAC,GAAG,CAAC;SACR,QAAQ,CACP,+GAA+G,CAChH;IACH,MAAM,EAAE,CAAC;SACN,IAAI,CAAC,CAAC,QAAQ,EAAE,SAAS,EAAE,cAAc,EAAE,cAAc,EAAE,aAAa,EAAE,gBAAgB,CAAC,CAAC;SAC5F,QAAQ,CACP,qGAAqG,CACtG;IACH,KAAK,EAAE,CAAC;SACL,KAAK,CAAC,CAAC,CAAC,CAAC,MAAM,EAAE,CAAC,GAAG,CAAC,IAAI,CAAC,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,CAAC;SACzC,QAAQ,EAAE;SACV,QAAQ,CAAC,8EAA8E,CAAC;CAC5F,CAAC,CAAC"}

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

@@ -1 +1 @@
-{"version":3,"file":"search.d.ts","sourceRoot":"","sources":["../../../src/tools/skill-registry/search.ts"],"names":[],"mappings":"AAEA,OAAO,KAAK,EAAE,UAAU,EAAqB,mBAAmB,EAAE,MAAM,sBAAsB,CAAC;AAqC/F,wBAAgB,cAAc,IAAI,mBAAmB,EAAE,CA4BtD;AAED,wBAAsB,iBAAiB,CAAC,MAAM,EAAE;IAC9C,KAAK,EAAE,MAAM,CAAC;IACd,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,KAAK,CAAC,EAAE,MAAM,CAAC;CAChB,GAAG,OAAO,CAAC,UAAU,CAAC,CAwCtB"}
+{"version":3,"file":"search.d.ts","sourceRoot":"","sources":["../../../src/tools/skill-registry/search.ts"],"names":[],"mappings":"AAEA,OAAO,KAAK,EAAE,UAAU,EAAqB,mBAAmB,EAAE,MAAM,sBAAsB,CAAC;AAqC/F,wBAAgB,cAAc,IAAI,mBAAmB,EAAE,CA4BtD;AAED,wBAAsB,iBAAiB,CAAC,MAAM,EAAE;IAC9C,KAAK,EAAE,MAAM,CAAC;IACd,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,KAAK,CAAC,EAAE,MAAM,CAAC;CAChB,GAAG,OAAO,CAAC,UAAU,CAAC,CA8EtB"}

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

@@ -62,16 +62,42 @@ export function loadRegistries() {
 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 searchParams = {
-            query: params.query,
+            query,
             registry: params.registry,
             stack: params.stack,
-            limit: params.limit ?? 10,
+            limit: Math.max(1, Math.min(params.limit ?? 10, 50)),
         };
+        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) {
-            lines.push('No skills found matching your query.');
+            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');
+            }
         }
         else {
             lines.push('| # | Skill | Source | Description |');

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

@@ -1 +1 @@
-{"version":3,"file":"search.js","sourceRoot":"","sources":["../../../src/tools/skill-registry/search.ts"],"names":[],"mappings":"AAAA,4EAA4E;AAG5E,OAAO,EAAE,mBAAmB,EAAE,MAAM,sCAAsC,CAAC;AAC3E,OAAO,EAAE,aAAa,EAAE,UAAU,EAAE,MAAM,wBAAwB,CAAC;AACnE,OAAO,EAAE,EAAE,EAAE,MAAM,qBAAqB,CAAC;AACzC,OAAO,EAAE,YAAY,EAAE,MAAM,SAAS,CAAC;AACvC,OAAO,EAAE,IAAI,EAAE,OAAO,EAAE,MAAM,WAAW,CAAC;AAC1C,OAAO,EAAE,aAAa,EAAE,MAAM,UAAU,CAAC;AAEzC,MAAM,SAAS,GAAG,OAAO,CAAC,aAAa,CAAC,MAAM,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC,CAAC;AAE1D,MAAM,kBAAkB,GAA0B;IAChD;QACE,EAAE,EAAE,WAAW;QACf,IAAI,EAAE,2BAA2B;QACjC,GAAG,EAAE,sCAAsC;QAC3C,IAAI,EAAE,QAAQ;QACd,QAAQ,EAAE,CAAC;QACX,OAAO,EAAE,IAAI;KACd;IACD;QACE,EAAE,EAAE,YAAY;QAChB,IAAI,EAAE,eAAe;QACrB,GAAG,EAAE,uBAAuB;QAC5B,IAAI,EAAE,KAAK;QACX,QAAQ,EAAE,CAAC;QACX,OAAO,EAAE,IAAI;KACd;IACD;QACE,EAAE,EAAE,UAAU;QACd,IAAI,EAAE,WAAW;QACjB,GAAG,EAAE,mBAAmB;QACxB,IAAI,EAAE,KAAK;QACX,QAAQ,EAAE,CAAC;QACX,OAAO,EAAE,IAAI;KACd;CACF,CAAC;AAEF,MAAM,UAAU,cAAc;IAC5B,yEAAyE;IACzE,MAAM,YAAY,GAAG,IAAI,CAAC,SAAS,EAAE,oCAAoC,CAAC,CAAC;IAC3E,MAAM,UAAU,GAAG,IAAI,CAAC,SAAS,EAAE,2CAA2C,CAAC,CAAC;IAEhF,KAAK,MAAM,UAAU,IAAI,CAAC,YAAY,EAAE,UAAU,CAAC,EAAE,CAAC;QACpD,IAAI,GAAW,CAAC;QAChB,IAAI,CAAC;YACH,GAAG,GAAG,YAAY,CAAC,UAAU,EAAE,OAAO,CAAC,CAAC;QAC1C,CAAC;QAAC,MAAM,CAAC;YACP,yCAAyC;YACzC,SAAS;QACX,CAAC;QAED,IAAI,CAAC,GAAG,CAAC,IAAI,EAAE,EAAE,CAAC;YAChB,mCAAmC;YACnC,SAAS;QACX,CAAC;QAED,IAAI,CAAC;YACH,OAAO,IAAI,CAAC,KAAK,CAAC,GAAG,CAA0B,CAAC;QAClD,CAAC;QAAC,MAAM,CAAC;YACP,OAAO,CAAC,IAAI,CAAC,mEAAmE,CAAC,CAAC;YAClF,OAAO,kBAAkB,CAAC;QAC5B,CAAC;IACH,CAAC;IAED,OAAO,kBAAkB,CAAC;AAC5B,CAAC;AAED,MAAM,CAAC,KAAK,UAAU,iBAAiB,CAAC,MAKvC;IACC,IAAI,CAAC;QACH,MAAM,UAAU,GAAG,cAAc,EAAE,CAAC;QACpC,MAAM,YAAY,GAAsB;YACtC,KAAK,EAAE,MAAM,CAAC,KAAK;YACnB,QAAQ,EAAE,MAAM,CAAC,QAAQ;YACzB,KAAK,EAAE,MAAM,CAAC,KAAK;YACnB,KAAK,EAAE,MAAM,CAAC,KAAK,IAAI,EAAE;SAC1B,CAAC;QAEF,MAAM,OAAO,GAAG,MAAM,mBAAmB,CAAC,YAAY,EAAE,UAAU,CAAC,CAAC;QAEpE,MAAM,KAAK,GAAa,EAAE,CAAC;QAC3B,IAAI,OAAO,CAAC,MAAM,KAAK,CAAC,EAAE,CAAC;YACzB,KAAK,CAAC,IAAI,CAAC,sCAAsC,CAAC,CAAC;QACrD,CAAC;aAAM,CAAC;YACN,KAAK,CAAC,IAAI,CAAC,sCAAsC,CAAC,CAAC;YACnD,KAAK,CAAC,IAAI,CAAC,sCAAsC,CAAC,CAAC;YACnD,OAAO,CAAC,OAAO,CAAC,CAAC,CAAC,EAAE,CAAC,EAAE,EAAE;gBACvB,MAAM,IAAI,GAAG,CAAC,CAAC,WAAW,CAAC,MAAM,GAAG,EAAE,CAAC,CAAC,CAAC,CAAC,CAAC,WAAW,CAAC,KAAK,CAAC,CAAC,EAAE,EAAE,CAAC,GAAG,KAAK,CAAC,CAAC,CAAC,CAAC,CAAC,WAAW,CAAC;gBAC5F,KAAK,CAAC,IAAI,CAAC,KAAK,MAAM,CAAC,CAAC,GAAG,CAAC,CAAC,QAAQ,CAAC,CAAC,IAAI,QAAQ,CAAC,CAAC,MAAM,MAAM,IAAI,IAAI,CAAC,CAAC;YAC7E,CAAC,CAAC,CAAC;YACH,KAAK,CAAC,IAAI,CAAC,EAAE,CAAC,CAAC;YACf,KAAK,CAAC,IAAI,CAAC,2EAA2E,CAAC,CAAC;QAC1F,CAAC;QAED,MAAM,QAAQ,GAAG,aAAa,CAC5B,SAAS,MAAM,CAAC,OAAO,CAAC,MAAM,CAAC,SAAS,OAAO,CAAC,MAAM,KAAK,CAAC,CAAC,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,EACzE,KAAK,CAAC,IAAI,CAAC,IAAI,CAAC,CACjB,CAAC;QAEF,OAAO,UAAU,CAAC,QAAQ,EAAE,EAAE,OAAO,EAAE,KAAK,EAAE,OAAO,CAAC,MAAM,EAAE,CAAC,CAAC;IAClE,CAAC;IAAC,OAAO,KAAK,EAAE,CAAC;QACf,MAAM,GAAG,GAAG,KAAK,YAAY,KAAK,CAAC,CAAC,CAAC,KAAK,CAAC,OAAO,CAAC,CAAC,CAAC,MAAM,CAAC,KAAK,CAAC,CAAC;QACnE,OAAO,UAAU,CACf,EAAE,CAAC,sBAAsB,EAAE,EAAE,OAAO,EAAE,GAAG,EAAE,CAAC,GAAG,CAAC,GAAG,CAAC,CAAC,CAAC,IAAI,GAAG,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC,EACrE,SAAS,EACT,IAAI,CACL,CAAC;IACJ,CAAC;AACH,CAAC"}
+{"version":3,"file":"search.js","sourceRoot":"","sources":["../../../src/tools/skill-registry/search.ts"],"names":[],"mappings":"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"}

package/dist/tools/suggest-tooling/skills-fetcher.d.ts

@@ -1,4 +1,2 @@
-import type { ProjectKnowledge, RecommendedSkill } from '../../types/index.js';
-export declare function isMcpServer(knowledge: ProjectKnowledge): boolean;
-export declare function fetchRecommendedSkills(knowledge: ProjectKnowledge): Promise<RecommendedSkill[]>;
+export { fetchRecommendedSkills, isMcpServer } from '../../engine/skills/skills-fetcher.js';
 //# sourceMappingURL=skills-fetcher.d.ts.map

package/dist/tools/suggest-tooling/skills-fetcher.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"skills-fetcher.d.ts","sourceRoot":"","sources":["../../../src/tools/suggest-tooling/skills-fetcher.ts"],"names":[],"mappings":"AAIA,OAAO,KAAK,EAAE,gBAAgB,EAAE,gBAAgB,EAAE,MAAM,sBAAsB,CAAC;AAG/E,wBAAgB,WAAW,CAAC,SAAS,EAAE,gBAAgB,GAAG,OAAO,CAQhE;AAED,wBAAsB,sBAAsB,CAC1C,SAAS,EAAE,gBAAgB,GAC1B,OAAO,CAAC,gBAAgB,EAAE,CAAC,CAgC7B"}
+{"version":3,"file":"skills-fetcher.d.ts","sourceRoot":"","sources":["../../../src/tools/suggest-tooling/skills-fetcher.ts"],"names":[],"mappings":"AAEA,OAAO,EAAE,sBAAsB,EAAE,WAAW,EAAE,MAAM,uCAAuC,CAAC"}

package/dist/tools/suggest-tooling/skills-fetcher.js

@@ -1,102 +1,4 @@
-// tools/suggest-tooling/skills-fetcher.ts — SPEC-022: skills.sh catalog fetcher
-// Fetches and recommends AI agent skills based on project stack.
-// Uses SPEC-003 web fetcher (fetchUrl) for HTTP — no direct node:https usage.
-import { fetchUrl } from '../../engine/web-fetcher/http-client.js';
-export function isMcpServer(knowledge) {
-    const stackLower = knowledge.stack.map((s) => s.toLowerCase());
-    const toolingStr = JSON.stringify(knowledge.tooling).toLowerCase();
-    return (stackLower.some((s) => s.includes('mcp') || s.includes('@modelcontextprotocol')) ||
-        toolingStr.includes('modelcontextprotocol') ||
-        toolingStr.includes('@modelcontextprotocol'));
-}
-export async function fetchRecommendedSkills(knowledge) {
-    const skills = [];
-    // Always add mcp-builder first for MCP server projects
-    if (isMcpServer(knowledge)) {
-        skills.push({
-            name: 'mcp-builder',
-            description: 'Best practices and conventions for building high-quality MCP servers',
-            installCommand: 'npx skills add mcp-builder',
-            justification: 'Project detected as an MCP server (@modelcontextprotocol detected in stack/tooling)',
-        });
-    }
-    // Fetch skills.sh catalog in real time (with graceful fallback to hardcoded skills)
-    const catalogSkills = await fetchSkillsShCatalog(knowledge.stack, knowledge.language);
-    if (catalogSkills.length > 0) {
-        skills.push(...catalogSkills);
-    }
-    else {
-        // Fallback: use hardcoded relevant skills when catalog is unavailable or empty
-        skills.push(...buildFallbackSkills(knowledge));
-    }
-    // Deduplicate by name
-    const seen = new Set();
-    return skills.filter((s) => {
-        if (seen.has(s.name)) {
-            return false;
-        }
-        seen.add(s.name);
-        return true;
-    });
-}
-async function fetchSkillsShCatalog(stack, language) {
-    const stackParam = encodeURIComponent([...stack, language].join(',').toLowerCase());
-    const url = `https://skills.sh/api/catalog?stack=${stackParam}`;
-    try {
-        const response = await fetchUrl(url);
-        if (!response) {
-            return [];
-        }
-        const parsed = JSON.parse(response.content);
-        return (parsed.skills ?? []).slice(0, 5).map((s) => ({
-            name: s.name,
-            description: s.description ?? `Skill: ${s.name}`,
-            installCommand: s.installCommand ?? `npx skills add ${s.name}`,
-            justification: `Relevant to your ${language} stack`,
-        }));
-    }
-    catch {
-        /* v8 ignore next */ // JSON.parse errors are unlikely with mocked fetchUrl in tests
-        return [];
-    }
-}
-function buildFallbackSkills(knowledge) {
-    const skills = [];
-    const stackLower = knowledge.stack.map((s) => s.toLowerCase());
-    const lang = knowledge.language.toLowerCase();
-    if (lang === 'typescript' || lang === 'javascript') {
-        skills.push({
-            name: 'typescript-patterns',
-            description: 'TypeScript best practices, strict mode patterns, and type safety conventions',
-            installCommand: 'npx skills add typescript-patterns',
-            justification: `Project uses ${knowledge.language}`,
-        });
-    }
-    if (stackLower.some((s) => s.includes('react'))) {
-        skills.push({
-            name: 'react-patterns',
-            description: 'React component patterns, hooks best practices, and performance optimization',
-            installCommand: 'npx skills add react-patterns',
-            justification: 'React detected in project stack',
-        });
-    }
-    if (stackLower.some((s) => s.includes('next'))) {
-        skills.push({
-            name: 'nextjs-patterns',
-            description: 'Next.js App Router patterns, server components, and deployment best practices',
-            installCommand: 'npx skills add nextjs-patterns',
-            justification: 'Next.js detected in project stack',
-        });
-    }
-    if (stackLower.some((s) => s.includes('python')) ||
-        knowledge.language.toLowerCase() === 'python') {
-        skills.push({
-            name: 'python-patterns',
-            description: 'Python best practices, type hints, async patterns, and testing conventions',
-            installCommand: 'npx skills add python-patterns',
-            justification: 'Python detected in project stack',
-        });
-    }
-    return skills;
-}
+// tools/suggest-tooling/skills-fetcher.ts — Re-export from engine
+// Business logic lives in engine/ so engine/ can import it without architecture violations.
+export { fetchRecommendedSkills, isMcpServer } from '../../engine/skills/skills-fetcher.js';
 //# sourceMappingURL=skills-fetcher.js.map

package/dist/tools/suggest-tooling/skills-fetcher.js.map

@@ -1 +1 @@
-{"version":3,"file":"skills-fetcher.js","sourceRoot":"","sources":["../../../src/tools/suggest-tooling/skills-fetcher.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"skills-fetcher.js","sourceRoot":"","sources":["../../../src/tools/suggest-tooling/skills-fetcher.ts"],"names":[],"mappings":"AAAA,kEAAkE;AAClE,4FAA4F;AAC5F,OAAO,EAAE,sBAAsB,EAAE,WAAW,EAAE,MAAM,uCAAuC,CAAC"}

package/dist/tools/token-recording.d.ts

@@ -0,0 +1,16 @@
+/**
+ * Record a tool call's token usage to the persistent ledger.
+ * Always fire-and-forget — never throws, never blocks the response.
+ */
+export declare function recordToolTokens(toolName: string, projectPath: string, inputArgs: unknown, outputText: string, sessionId: string): void;
+/**
+ * Extract output text from a ToolResult for token counting.
+ * Concatenates all text content items into a single string.
+ */
+export declare function extractOutputText(result: {
+    content: {
+        type: string;
+        text?: string;
+    }[];
+}): string;
+//# sourceMappingURL=token-recording.d.ts.map

package/dist/tools/token-recording.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"token-recording.d.ts","sourceRoot":"","sources":["../../src/tools/token-recording.ts"],"names":[],"mappings":"AAQA;;;GAGG;AACH,wBAAgB,gBAAgB,CAC9B,QAAQ,EAAE,MAAM,EAChB,WAAW,EAAE,MAAM,EACnB,SAAS,EAAE,OAAO,EAClB,UAAU,EAAE,MAAM,EAClB,SAAS,EAAE,MAAM,GAChB,IAAI,CA2BN;AAED;;;GAGG;AACH,wBAAgB,iBAAiB,CAAC,MAAM,EAAE;IAAE,OAAO,EAAE;QAAE,IAAI,EAAE,MAAM,CAAC;QAAC,IAAI,CAAC,EAAE,MAAM,CAAA;KAAE,EAAE,CAAA;CAAE,GAAG,MAAM,CAIhG"}

package/dist/tools/token-recording.js

@@ -0,0 +1,47 @@
+// tools/token-recording.ts — Fire-and-forget token usage recording for all tool calls.
+// Called by safeWithTelemetry() after each successful tool execution.
+import { join } from 'node:path';
+import { countTokens, estimateCost } from '../engine/token-optimizer/counter.js';
+import { recordEntry } from '../storage/token-ledger-store.js';
+import { hashProjectPath } from '../storage/base-store.js';
+/**
+ * Record a tool call's token usage to the persistent ledger.
+ * Always fire-and-forget — never throws, never blocks the response.
+ */
+export function recordToolTokens(toolName, projectPath, inputArgs, outputText, sessionId) {
+    try {
+        const inputStr = typeof inputArgs === 'string' ? inputArgs : JSON.stringify(inputArgs);
+        const inputCount = countTokens(inputStr);
+        const outputCount = countTokens(outputText);
+        const totalTokens = inputCount.tokens + outputCount.tokens;
+        const cost = estimateCost(totalTokens, 'claude-sonnet');
+        const entry = {
+            id: `TXN-${Date.now()}-${Math.random().toString(36).slice(2, 6)}`,
+            timestamp: new Date().toISOString(),
+            sessionId,
+            toolName,
+            model: 'claude-sonnet',
+            inputTokens: inputCount.tokens,
+            outputTokens: outputCount.tokens,
+            totalTokens,
+            costUsd: cost.totalCostUsd,
+            cached: false,
+        };
+        const projectHash = hashProjectPath(projectPath);
+        const dataDir = join(process.cwd(), 'data');
+        void recordEntry(projectHash, dataDir, entry);
+    }
+    catch {
+        // Never fail the tool call due to token recording errors
+    }
+}
+/**
+ * Extract output text from a ToolResult for token counting.
+ * Concatenates all text content items into a single string.
+ */
+export function extractOutputText(result) {
+    return result.content
+        .flatMap((item) => (item.type === 'text' && typeof item.text === 'string' ? [item.text] : []))
+        .join('\n');
+}
+//# sourceMappingURL=token-recording.js.map

package/dist/tools/token-recording.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"token-recording.js","sourceRoot":"","sources":["../../src/tools/token-recording.ts"],"names":[],"mappings":"AAAA,uFAAuF;AACvF,sEAAsE;AACtE,OAAO,EAAE,IAAI,EAAE,MAAM,WAAW,CAAC;AACjC,OAAO,EAAE,WAAW,EAAE,YAAY,EAAE,MAAM,sCAAsC,CAAC;AACjF,OAAO,EAAE,WAAW,EAAE,MAAM,kCAAkC,CAAC;AAC/D,OAAO,EAAE,eAAe,EAAE,MAAM,0BAA0B,CAAC;AAG3D;;;GAGG;AACH,MAAM,UAAU,gBAAgB,CAC9B,QAAgB,EAChB,WAAmB,EACnB,SAAkB,EAClB,UAAkB,EAClB,SAAiB;IAEjB,IAAI,CAAC;QACH,MAAM,QAAQ,GAAG,OAAO,SAAS,KAAK,QAAQ,CAAC,CAAC,CAAC,SAAS,CAAC,CAAC,CAAC,IAAI,CAAC,SAAS,CAAC,SAAS,CAAC,CAAC;QACvF,MAAM,UAAU,GAAG,WAAW,CAAC,QAAQ,CAAC,CAAC;QACzC,MAAM,WAAW,GAAG,WAAW,CAAC,UAAU,CAAC,CAAC;QAC5C,MAAM,WAAW,GAAG,UAAU,CAAC,MAAM,GAAG,WAAW,CAAC,MAAM,CAAC;QAC3D,MAAM,IAAI,GAAG,YAAY,CAAC,WAAW,EAAE,eAAe,CAAC,CAAC;QAExD,MAAM,KAAK,GAAgB;YACzB,EAAE,EAAE,OAAO,IAAI,CAAC,GAAG,EAAE,IAAI,IAAI,CAAC,MAAM,EAAE,CAAC,QAAQ,CAAC,EAAE,CAAC,CAAC,KAAK,CAAC,CAAC,EAAE,CAAC,CAAC,EAAE;YACjE,SAAS,EAAE,IAAI,IAAI,EAAE,CAAC,WAAW,EAAE;YACnC,SAAS;YACT,QAAQ;YACR,KAAK,EAAE,eAAe;YACtB,WAAW,EAAE,UAAU,CAAC,MAAM;YAC9B,YAAY,EAAE,WAAW,CAAC,MAAM;YAChC,WAAW;YACX,OAAO,EAAE,IAAI,CAAC,YAAY;YAC1B,MAAM,EAAE,KAAK;SACd,CAAC;QAEF,MAAM,WAAW,GAAG,eAAe,CAAC,WAAW,CAAC,CAAC;QACjD,MAAM,OAAO,GAAG,IAAI,CAAC,OAAO,CAAC,GAAG,EAAE,EAAE,MAAM,CAAC,CAAC;QAC5C,KAAK,WAAW,CAAC,WAAW,EAAE,OAAO,EAAE,KAAK,CAAC,CAAC;IAChD,CAAC;IAAC,MAAM,CAAC;QACP,yDAAyD;IAC3D,CAAC;AACH,CAAC;AAED;;;GAGG;AACH,MAAM,UAAU,iBAAiB,CAAC,MAAsD;IACtF,OAAO,MAAM,CAAC,OAAO;SAClB,OAAO,CAAC,CAAC,IAAI,EAAE,EAAE,CAAC,CAAC,IAAI,CAAC,IAAI,KAAK,MAAM,IAAI,OAAO,IAAI,CAAC,IAAI,KAAK,QAAQ,CAAC,CAAC,CAAC,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC;SAC7F,IAAI,CAAC,IAAI,CAAC,CAAC;AAChB,CAAC"}

package/dist/tools/update-status-convention-gate.d.ts

@@ -0,0 +1,12 @@
+import type { SpecStatus, ComplianceGateResult } from '../types/index.js';
+/**
+ * Checks for critical convention violations before allowing a spec to be marked as done.
+ * Returns warning messages for critical violations (non-blocking, best-effort).
+ */
+export declare function checkConventionGate(projectId: string): Promise<string[]>;
+/**
+ * Runs all non-blocking compliance gates (convention + constitution + compile + lint + test)
+ * in parallel. Extracts complexity from handleUpdateStatus.
+ */
+export declare function runComplianceGates(projectId: string, specTitle: string, specTags: string[], newStatus: SpecStatus): Promise<ComplianceGateResult>;
+//# sourceMappingURL=update-status-convention-gate.d.ts.map

package/dist/tools/update-status-convention-gate.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"update-status-convention-gate.d.ts","sourceRoot":"","sources":["../../src/tools/update-status-convention-gate.ts"],"names":[],"mappings":"AAIA,OAAO,KAAK,EAAE,UAAU,EAAE,oBAAoB,EAAE,MAAM,mBAAmB,CAAC;AAuH1E;;;GAGG;AACH,wBAAsB,mBAAmB,CAAC,SAAS,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,EAAE,CAAC,CAsB9E;AAMD;;;GAGG;AACH,wBAAsB,kBAAkB,CACtC,SAAS,EAAE,MAAM,EACjB,SAAS,EAAE,MAAM,EACjB,QAAQ,EAAE,MAAM,EAAE,EAClB,SAAS,EAAE,UAAU,GACpB,OAAO,CAAC,oBAAoB,CAAC,CA0B/B"}

package/dist/tools/update-status-convention-gate.js

@@ -0,0 +1,159 @@
+// tools/update-status-convention-gate.ts — SPEC-190
+// Convention and constitution compliance gates for update_status transitions.
+import { execSync } from 'node:child_process';
+import { knowledgeStore } from '../storage/index.js';
+import { parseConventions, scanConventions } from '../engine/convention-scanner/index.js';
+import { checkConstitutionOnTransition } from './update-status-actions.js';
+// ---------------------------------------------------------------------------
+// Helpers
+// ---------------------------------------------------------------------------
+/** Allowlist: alphanumerics, spaces, and safe shell chars. Rejects ; | $ ` & < > */
+const SAFE_COMMAND_RE = /^[\w\s./:@~=-]+$/;
+function isSafeCommand(cmd) {
+    return SAFE_COMMAND_RE.test(cmd);
+}
+function execGate(cmd, cwd, timeoutMs) {
+    try {
+        const raw = execSync(cmd, {
+            cwd,
+            stdio: ['pipe', 'pipe', 'pipe'],
+            timeout: timeoutMs,
+        });
+        return { output: raw.toString().trim(), ok: true };
+    }
+    catch (err) {
+        const output = err instanceof Error && 'stdout' in err
+            ? String(err.stdout ?? '')
+            : String(err);
+        return { output: output.trim(), ok: false };
+    }
+}
+function countLintIssues(output) {
+    // Handle eslint, tsc, and generic "N problem(s)" patterns
+    const problemMatch = /(\d+)\s+problem/i.exec(output);
+    if (problemMatch) {
+        return parseInt(problemMatch[1] ?? '0', 10);
+    }
+    // Count non-empty lines as a fallback for unknown lint formats
+    return output.split('\n').filter((l) => l.trim().length > 0).length;
+}
+// ---------------------------------------------------------------------------
+// Individual gates
+// ---------------------------------------------------------------------------
+function checkCompileGate(projectPath, lintCommand) {
+    // Prefer tsc --noEmit; fall back to checking if lint command already covers it
+    const hasTsc = lintCommand?.includes('tsc') ?? false;
+    if (hasTsc) {
+        return []; // lint will cover compile
+    }
+    const { output, ok } = execGate('npx tsc --noEmit', projectPath, 5_000);
+    if (ok) {
+        return [];
+    }
+    const lines = output.split('\n').filter((l) => l.includes('error TS'));
+    if (lines.length === 0) {
+        return [];
+    }
+    const preview = lines.slice(0, 3).join('; ');
+    return [`TypeScript compile: ${lines.length} error(s). ${preview}`];
+}
+function checkLintGate(projectPath, lintCmd) {
+    if (lintCmd !== null && !isSafeCommand(lintCmd)) {
+        console.warn(`[Planu] convention-gate: lintCommand contains unsafe characters — skipping`);
+        return [];
+    }
+    const cmd = lintCmd ?? 'npx eslint src --max-warnings=0 --format=compact 2>&1 || true';
+    const { output, ok } = execGate(cmd, projectPath, 10_000);
+    if (ok) {
+        return [];
+    }
+    const issueCount = countLintIssues(output);
+    if (issueCount === 0) {
+        return [];
+    }
+    const preview = output.split('\n').find((l) => l.trim().length > 0) ?? '';
+    return [`Lint: ${issueCount} issue(s). ${preview}`];
+}
+function checkTestGate(projectPath, testCmd) {
+    if (testCmd !== null && !isSafeCommand(testCmd)) {
+        console.warn(`[Planu] convention-gate: testCommand contains unsafe characters — skipping`);
+        return [];
+    }
+    // Run tests with a short timeout — only a warning if they fail
+    const cmd = testCmd ?? 'npx vitest run --reporter=verbose 2>&1 | tail -20 || true';
+    const { output, ok } = execGate(cmd, projectPath, 30_000);
+    if (ok) {
+        return [];
+    }
+    // Extract summary line (e.g. "5 failed" or "FAIL src/foo.test.ts")
+    const failLine = output
+        .split('\n')
+        .reverse()
+        .find((l) => /fail|error/i.test(l) && l.trim().length > 0);
+    const summary = failLine ??
+        output
+            .split('\n')
+            .filter((l) => l.trim())
+            .slice(-1)[0] ??
+        '';
+    return [`Tests: failed. ${summary.trim()}`];
+}
+// ---------------------------------------------------------------------------
+// Convention gate (existing logic, unchanged)
+// ---------------------------------------------------------------------------
+/**
+ * Checks for critical convention violations before allowing a spec to be marked as done.
+ * Returns warning messages for critical violations (non-blocking, best-effort).
+ */
+export async function checkConventionGate(projectId) {
+    try {
+        const knowledge = await knowledgeStore.getKnowledge(projectId);
+        if (!knowledge?.projectPath) {
+            return [];
+        }
+        const rules = parseConventions(knowledge.projectPath);
+        if (rules.length === 0) {
+            return [];
+        }
+        const violations = scanConventions(knowledge.projectPath, rules);
+        const critical = violations.filter((v) => v.severity === 'critical');
+        if (critical.length === 0) {
+            return [];
+        }
+        return critical.slice(0, 5).map((v) => `${v.category}: ${v.message} (${v.file})`);
+    }
+    catch {
+        return [];
+    }
+}
+// ---------------------------------------------------------------------------
+// Main gate runner
+// ---------------------------------------------------------------------------
+/**
+ * Runs all non-blocking compliance gates (convention + constitution + compile + lint + test)
+ * in parallel. Extracts complexity from handleUpdateStatus.
+ */
+export async function runComplianceGates(projectId, specTitle, specTags, newStatus) {
+    const isDone = newStatus === 'done';
+    const isApprovedOrDone = newStatus === 'approved' || isDone;
+    // Load knowledge once — needed for project path and commands
+    const knowledge = isDone ? await knowledgeStore.getKnowledge(projectId) : null;
+    const projectPath = knowledge?.projectPath ?? null;
+    const [conventionWarnings, constitutionWarnings, compileWarnings, lintWarnings, testWarnings] = await Promise.all([
+        isDone ? checkConventionGate(projectId) : Promise.resolve([]),
+        isApprovedOrDone
+            ? checkConstitutionOnTransition(projectId, specTitle, specTags)
+            : Promise.resolve([]),
+        isDone && projectPath
+            ? Promise.resolve(checkCompileGate(projectPath, knowledge?.lintCommand ?? null))
+            : Promise.resolve([]),
+        isDone && projectPath
+            ? Promise.resolve(checkLintGate(projectPath, knowledge?.lintCommand ?? null))
+            : Promise.resolve([]),
+        isDone && projectPath
+            ? Promise.resolve(checkTestGate(projectPath, knowledge?.testCommand ?? null))
+            : Promise.resolve([]),
+    ]);
+    return { conventionWarnings, constitutionWarnings, compileWarnings, lintWarnings, testWarnings };
+}
+//# sourceMappingURL=update-status-convention-gate.js.map

package/dist/tools/update-status-convention-gate.js.map

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

package/dist/tools/update-status-reconcile.d.ts

@@ -0,0 +1,7 @@
+/**
+ * Auto-reconcile token costs when a spec transitions to 'done'.
+ * Compares pre-execution estimates stored in ledger entries against actuals.
+ * Fire-and-forget safe: always returns null on any error.
+ */
+export declare function autoReconcileOnDone(specId: string, projectHash: string): Promise<string | null>;
+//# sourceMappingURL=update-status-reconcile.d.ts.map

package/dist/tools/update-status-reconcile.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"update-status-reconcile.d.ts","sourceRoot":"","sources":["../../src/tools/update-status-reconcile.ts"],"names":[],"mappings":"AAQA;;;;GAIG;AACH,wBAAsB,mBAAmB,CACvC,MAAM,EAAE,MAAM,EACd,WAAW,EAAE,MAAM,GAClB,OAAO,CAAC,MAAM,GAAG,IAAI,CAAC,CA4CxB"}