@planu/cli 0.91.0 → 0.93.0

package/dist/engine/performance-analyzer.js

@@ -0,0 +1,152 @@
+// engine/performance-analyzer.ts — SPEC-300: Detect performance risks in spec text
+//
+// Analyzes spec content for common performance anti-patterns using keyword matching.
+// Detection is intentionally conservative: negate keywords prevent false positives.
+// ---------------------------------------------------------------------------
+// Risk pattern definitions
+// ---------------------------------------------------------------------------
+export const RISK_PATTERNS = [
+    {
+        category: 'n-plus-one',
+        severity: 'high',
+        triggerKeywords: [
+            'for each',
+            'per user',
+            'per item',
+            'loop through',
+            'every record',
+            'for every',
+            'iterate over all',
+        ],
+        negateIfPresent: ['batch', 'bulk', 'single query'],
+        description: 'Spec implies iterating over records with per-record DB queries, creating N+1 query risk.',
+        recommendation: 'Use batch/bulk queries or eager loading to fetch related data in a single query.',
+    },
+    {
+        category: 'large-data',
+        severity: 'high',
+        triggerKeywords: [
+            'import all',
+            'export all',
+            'bulk import',
+            'migrate all',
+            'all records',
+            'full table',
+            'entire dataset',
+        ],
+        negateIfPresent: ['paginated', 'chunked', 'streaming'],
+        description: 'Spec involves loading or transferring large volumes of data without chunking or streaming.',
+        recommendation: 'Process data in paginated chunks or use streaming to avoid memory exhaustion and timeouts.',
+    },
+    {
+        category: 'missing-pagination',
+        severity: 'medium',
+        triggerKeywords: ['list all', 'get all', 'fetch all', 'return all', 'show all'],
+        negateIfPresent: ['page', 'limit', 'cursor', 'paginate', 'offset'],
+        description: 'Spec returns unbounded lists of records without pagination, risking slow responses at scale.',
+        recommendation: 'Add page/limit or cursor-based pagination to all list endpoints from the start.',
+    },
+    {
+        category: 'missing-cache',
+        severity: 'medium',
+        triggerKeywords: ['real-time', 'always fresh', 'live data', 'no cache', 'every request'],
+        negateIfPresent: ['cache', 'ttl', 'redis', 'memoize', 'cdn'],
+        description: 'Spec requires fresh data on every request with no caching strategy, risking high DB load.',
+        recommendation: 'Define an appropriate TTL or cache invalidation strategy (Redis, CDN, in-memory).',
+    },
+    {
+        category: 'blocking-ops',
+        severity: 'medium',
+        triggerKeywords: ['synchronous', 'blocking call', 'wait for response', 'sequential processing'],
+        negateIfPresent: ['async', 'queue', 'background job', 'worker', 'non-blocking'],
+        description: 'Spec describes synchronous blocking operations that hold threads and degrade throughput.',
+        recommendation: 'Move heavy operations to async queues or background workers to keep the request thread free.',
+    },
+    {
+        category: 'missing-index',
+        severity: 'low',
+        triggerKeywords: ['filter by', 'search by', 'sort by', 'query by', 'find by'],
+        negateIfPresent: ['indexed', 'index on', 'composite index', 'b-tree'],
+        description: 'Spec queries data by fields that may lack database indexes, causing full-table scans.',
+        recommendation: 'Add database indexes on all filter/sort/search columns mentioned in acceptance criteria.',
+    },
+];
+// ---------------------------------------------------------------------------
+// Core analysis functions
+// ---------------------------------------------------------------------------
+/**
+ * Analyze text against the risk patterns and return all detected risks.
+ * Each pattern is checked independently; negate keywords suppress a match.
+ */
+export function analyzeText(text, patterns) {
+    const lower = text.toLowerCase();
+    const risks = [];
+    for (const pattern of patterns) {
+        const triggered = pattern.triggerKeywords.some((kw) => lower.includes(kw.toLowerCase()));
+        if (!triggered) {
+            continue;
+        }
+        const negated = (pattern.negateIfPresent ?? []).some((kw) => lower.includes(kw.toLowerCase()));
+        if (negated) {
+            continue;
+        }
+        risks.push({
+            category: pattern.category,
+            severity: pattern.severity,
+            description: pattern.description,
+            recommendation: pattern.recommendation,
+        });
+    }
+    return risks;
+}
+/**
+ * Compute overall risk level from a list of detected risks.
+ * 'high' if any high-severity, 'medium' if any medium, 'low' if any low, 'none' if empty.
+ */
+export function computeOverallRisk(risks) {
+    if (risks.length === 0) {
+        return 'none';
+    }
+    if (risks.some((r) => r.severity === 'high')) {
+        return 'high';
+    }
+    if (risks.some((r) => r.severity === 'medium')) {
+        return 'medium';
+    }
+    return 'low';
+}
+/**
+ * Analyze a spec for performance risks.
+ * Combines spec title with the raw markdown content for analysis.
+ */
+export function analyzeSpecPerformance(spec, specContent) {
+    const combinedText = `${spec.title} ${specContent}`;
+    const risks = analyzeText(combinedText, RISK_PATTERNS);
+    // Group by category
+    const risksByCategory = {};
+    const allCategories = [
+        'n-plus-one',
+        'large-data',
+        'missing-pagination',
+        'missing-cache',
+        'blocking-ops',
+        'missing-index',
+    ];
+    for (const cat of allCategories) {
+        risksByCategory[cat] = [];
+    }
+    for (const risk of risks) {
+        risksByCategory[risk.category].push(risk);
+    }
+    const overallRisk = computeOverallRisk(risks);
+    // Deduplicate recommendations
+    const recommendations = [...new Set(risks.map((r) => r.recommendation))];
+    return {
+        specId: spec.id,
+        riskCount: risks.length,
+        risksByCategory,
+        overallRisk,
+        recommendations,
+    };
+}
+//# sourceMappingURL=performance-analyzer.js.map

package/dist/engine/performance-analyzer.js.map

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

package/dist/engine/registry/composio-publisher.d.ts

@@ -0,0 +1,17 @@
+import type { ComposioSchema } from '../../types/registry-publishers.js';
+/**
+ * Generates a Composio schema from a list of tool names.
+ * Each tool gets a basic description derived from its name.
+ *
+ * @param tools  Array of tool names to include in the schema.
+ * @returns A ComposioSchema with mapped tool descriptors.
+ */
+export declare function generateComposioSchema(tools: string[]): ComposioSchema;
+/**
+ * Writes .composio-schema.json to the given project directory.
+ *
+ * @param projectPath  Absolute path to the project root.
+ * @param tools        Array of tool names to include.
+ */
+export declare function writeComposioSchema(projectPath: string, tools: string[]): void;
+//# sourceMappingURL=composio-publisher.d.ts.map

package/dist/engine/registry/composio-publisher.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"composio-publisher.d.ts","sourceRoot":"","sources":["../../../src/engine/registry/composio-publisher.ts"],"names":[],"mappings":"AAKA,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,oCAAoC,CAAC;AAczE;;;;;;GAMG;AACH,wBAAgB,sBAAsB,CAAC,KAAK,EAAE,MAAM,EAAE,GAAG,cAAc,CAQtE;AAED;;;;;GAKG;AACH,wBAAgB,mBAAmB,CAAC,WAAW,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM,EAAE,GAAG,IAAI,CAY9E"}

package/dist/engine/registry/composio-publisher.js

@@ -0,0 +1,51 @@
+// engine/registry/composio-publisher.ts — SPEC-273: Composio integration schema publisher
+// Generates .composio-schema.json for composio.dev tool integration platform.
+import { writeFileSync } from 'node:fs';
+import { join } from 'node:path';
+/** Current schema format version for Composio entries. */
+const COMPOSIO_SCHEMA_VERSION = '1.0';
+/**
+ * Converts a tool name (snake_case or kebab-case) into a human-readable description.
+ */
+function toolNameToDescription(name) {
+    return name
+        .replace(/[-_]/g, ' ')
+        .replace(/\b\w/g, (ch) => ch.toUpperCase());
+}
+/**
+ * Generates a Composio schema from a list of tool names.
+ * Each tool gets a basic description derived from its name.
+ *
+ * @param tools  Array of tool names to include in the schema.
+ * @returns A ComposioSchema with mapped tool descriptors.
+ */
+export function generateComposioSchema(tools) {
+    return {
+        tools: tools.map((name) => ({
+            name,
+            description: toolNameToDescription(name),
+        })),
+        version: COMPOSIO_SCHEMA_VERSION,
+    };
+}
+/**
+ * Writes .composio-schema.json to the given project directory.
+ *
+ * @param projectPath  Absolute path to the project root.
+ * @param tools        Array of tool names to include.
+ */
+export function writeComposioSchema(projectPath, tools) {
+    const filePath = join(projectPath, '.composio-schema.json');
+    const schema = generateComposioSchema(tools);
+    const content = JSON.stringify(schema, null, 2) + '\n';
+    /* v8 ignore start */
+    try {
+        writeFileSync(filePath, content, 'utf-8');
+    }
+    catch (err) {
+        const msg = err instanceof Error ? err.message : String(err);
+        throw new Error(`Failed to write .composio-schema.json to ${filePath}: ${msg}`, { cause: err });
+    }
+    /* v8 ignore stop */
+}
+//# sourceMappingURL=composio-publisher.js.map

package/dist/engine/registry/composio-publisher.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"composio-publisher.js","sourceRoot":"","sources":["../../../src/engine/registry/composio-publisher.ts"],"names":[],"mappings":"AAAA,0FAA0F;AAC1F,8EAA8E;AAE9E,OAAO,EAAE,aAAa,EAAE,MAAM,SAAS,CAAC;AACxC,OAAO,EAAE,IAAI,EAAE,MAAM,WAAW,CAAC;AAGjC,0DAA0D;AAC1D,MAAM,uBAAuB,GAAG,KAAK,CAAC;AAEtC;;GAEG;AACH,SAAS,qBAAqB,CAAC,IAAY;IACzC,OAAO,IAAI;SACR,OAAO,CAAC,OAAO,EAAE,GAAG,CAAC;SACrB,OAAO,CAAC,OAAO,EAAE,CAAC,EAAE,EAAE,EAAE,CAAC,EAAE,CAAC,WAAW,EAAE,CAAC,CAAC;AAChD,CAAC;AAED;;;;;;GAMG;AACH,MAAM,UAAU,sBAAsB,CAAC,KAAe;IACpD,OAAO;QACL,KAAK,EAAE,KAAK,CAAC,GAAG,CAAC,CAAC,IAAI,EAAE,EAAE,CAAC,CAAC;YAC1B,IAAI;YACJ,WAAW,EAAE,qBAAqB,CAAC,IAAI,CAAC;SACzC,CAAC,CAAC;QACH,OAAO,EAAE,uBAAuB;KACjC,CAAC;AACJ,CAAC;AAED;;;;;GAKG;AACH,MAAM,UAAU,mBAAmB,CAAC,WAAmB,EAAE,KAAe;IACtE,MAAM,QAAQ,GAAG,IAAI,CAAC,WAAW,EAAE,uBAAuB,CAAC,CAAC;IAC5D,MAAM,MAAM,GAAG,sBAAsB,CAAC,KAAK,CAAC,CAAC;IAC7C,MAAM,OAAO,GAAG,IAAI,CAAC,SAAS,CAAC,MAAM,EAAE,IAAI,EAAE,CAAC,CAAC,GAAG,IAAI,CAAC;IACvD,qBAAqB;IACrB,IAAI,CAAC;QACH,aAAa,CAAC,QAAQ,EAAE,OAAO,EAAE,OAAO,CAAC,CAAC;IAC5C,CAAC;IAAC,OAAO,GAAG,EAAE,CAAC;QACb,MAAM,GAAG,GAAG,GAAG,YAAY,KAAK,CAAC,CAAC,CAAC,GAAG,CAAC,OAAO,CAAC,CAAC,CAAC,MAAM,CAAC,GAAG,CAAC,CAAC;QAC7D,MAAM,IAAI,KAAK,CAAC,4CAA4C,QAAQ,KAAK,GAAG,EAAE,EAAE,EAAE,KAAK,EAAE,GAAG,EAAE,CAAC,CAAC;IAClG,CAAC;IACD,oBAAoB;AACtB,CAAC"}

package/dist/engine/registry/glama-publisher.d.ts

@@ -0,0 +1,17 @@
+import type { GlamaOptions, GlamaEntry } from '../../types/registry-publishers.js';
+/**
+ * Generates a Glama directory entry from the given options.
+ * featured and verified default to false — these are set by Glama's team, not by the publisher.
+ *
+ * @param options  Configuration for the Glama entry.
+ * @returns A fully populated GlamaEntry.
+ */
+export declare function generateGlamaEntry(options: GlamaOptions): GlamaEntry;
+/**
+ * Writes .glama.json to the given project directory.
+ *
+ * @param projectPath  Absolute path to the project root.
+ * @param options      Glama directory options.
+ */
+export declare function writeGlamaEntry(projectPath: string, options: GlamaOptions): void;
+//# sourceMappingURL=glama-publisher.d.ts.map

package/dist/engine/registry/glama-publisher.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"glama-publisher.d.ts","sourceRoot":"","sources":["../../../src/engine/registry/glama-publisher.ts"],"names":[],"mappings":"AAKA,OAAO,KAAK,EAAE,YAAY,EAAE,UAAU,EAAE,MAAM,oCAAoC,CAAC;AAEnF;;;;;;GAMG;AACH,wBAAgB,kBAAkB,CAAC,OAAO,EAAE,YAAY,GAAG,UAAU,CAUpE;AAED;;;;;GAKG;AACH,wBAAgB,eAAe,CAAC,WAAW,EAAE,MAAM,EAAE,OAAO,EAAE,YAAY,GAAG,IAAI,CAYhF"}

package/dist/engine/registry/glama-publisher.js

@@ -0,0 +1,43 @@
+// engine/registry/glama-publisher.ts — SPEC-273: Glama MCP directory publisher
+// Generates .glama.json for glama.ai/mcp community directory.
+import { writeFileSync } from 'node:fs';
+import { join } from 'node:path';
+/**
+ * Generates a Glama directory entry from the given options.
+ * featured and verified default to false — these are set by Glama's team, not by the publisher.
+ *
+ * @param options  Configuration for the Glama entry.
+ * @returns A fully populated GlamaEntry.
+ */
+export function generateGlamaEntry(options) {
+    return {
+        name: options.name,
+        description: options.description,
+        repository: options.repository,
+        tags: options.tags,
+        author: options.author,
+        featured: false,
+        verified: false,
+    };
+}
+/**
+ * Writes .glama.json to the given project directory.
+ *
+ * @param projectPath  Absolute path to the project root.
+ * @param options      Glama directory options.
+ */
+export function writeGlamaEntry(projectPath, options) {
+    const filePath = join(projectPath, '.glama.json');
+    const entry = generateGlamaEntry(options);
+    const content = JSON.stringify(entry, null, 2) + '\n';
+    /* v8 ignore start */
+    try {
+        writeFileSync(filePath, content, 'utf-8');
+    }
+    catch (err) {
+        const msg = err instanceof Error ? err.message : String(err);
+        throw new Error(`Failed to write .glama.json to ${filePath}: ${msg}`, { cause: err });
+    }
+    /* v8 ignore stop */
+}
+//# sourceMappingURL=glama-publisher.js.map

package/dist/engine/registry/glama-publisher.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"glama-publisher.js","sourceRoot":"","sources":["../../../src/engine/registry/glama-publisher.ts"],"names":[],"mappings":"AAAA,+EAA+E;AAC/E,8DAA8D;AAE9D,OAAO,EAAE,aAAa,EAAE,MAAM,SAAS,CAAC;AACxC,OAAO,EAAE,IAAI,EAAE,MAAM,WAAW,CAAC;AAGjC;;;;;;GAMG;AACH,MAAM,UAAU,kBAAkB,CAAC,OAAqB;IACtD,OAAO;QACL,IAAI,EAAE,OAAO,CAAC,IAAI;QAClB,WAAW,EAAE,OAAO,CAAC,WAAW;QAChC,UAAU,EAAE,OAAO,CAAC,UAAU;QAC9B,IAAI,EAAE,OAAO,CAAC,IAAI;QAClB,MAAM,EAAE,OAAO,CAAC,MAAM;QACtB,QAAQ,EAAE,KAAK;QACf,QAAQ,EAAE,KAAK;KAChB,CAAC;AACJ,CAAC;AAED;;;;;GAKG;AACH,MAAM,UAAU,eAAe,CAAC,WAAmB,EAAE,OAAqB;IACxE,MAAM,QAAQ,GAAG,IAAI,CAAC,WAAW,EAAE,aAAa,CAAC,CAAC;IAClD,MAAM,KAAK,GAAG,kBAAkB,CAAC,OAAO,CAAC,CAAC;IAC1C,MAAM,OAAO,GAAG,IAAI,CAAC,SAAS,CAAC,KAAK,EAAE,IAAI,EAAE,CAAC,CAAC,GAAG,IAAI,CAAC;IACtD,qBAAqB;IACrB,IAAI,CAAC;QACH,aAAa,CAAC,QAAQ,EAAE,OAAO,EAAE,OAAO,CAAC,CAAC;IAC5C,CAAC;IAAC,OAAO,GAAG,EAAE,CAAC;QACb,MAAM,GAAG,GAAG,GAAG,YAAY,KAAK,CAAC,CAAC,CAAC,GAAG,CAAC,OAAO,CAAC,CAAC,CAAC,MAAM,CAAC,GAAG,CAAC,CAAC;QAC7D,MAAM,IAAI,KAAK,CAAC,kCAAkC,QAAQ,KAAK,GAAG,EAAE,EAAE,EAAE,KAAK,EAAE,GAAG,EAAE,CAAC,CAAC;IACxF,CAAC;IACD,oBAAoB;AACtB,CAAC"}

package/dist/engine/registry/index.d.ts

@@ -3,4 +3,8 @@ export { loadBaseRegistry, loadCustomRegistry, loadRegistry } from './loader.js'
 export { detectFrameworks, extractReferences, detectUnknownFrameworks } from './matcher.js';
 export { validateReference, validateReferences, detectStaleEntries } from './validator.js';
 export { buildReport } from './reporter.js';
+export { generateSmitheryYaml, writeSmitheryYaml } from './smithery-generator.js';
+export { generateMcpRegistryEntry, writeMcpRegistryEntry } from './mcp-official-publisher.js';
+export { generateGlamaEntry, writeGlamaEntry } from './glama-publisher.js';
+export { generateComposioSchema, writeComposioSchema } from './composio-publisher.js';
 //# sourceMappingURL=index.d.ts.map

package/dist/engine/registry/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/engine/registry/index.ts"],"names":[],"mappings":"AAGA,OAAO,EAAE,mBAAmB,EAAE,kBAAkB,EAAE,eAAe,EAAE,YAAY,EAAE,MAAM,WAAW,CAAC;AACnG,OAAO,EAAE,gBAAgB,EAAE,kBAAkB,EAAE,YAAY,EAAE,MAAM,aAAa,CAAC;AACjF,OAAO,EAAE,gBAAgB,EAAE,iBAAiB,EAAE,uBAAuB,EAAE,MAAM,cAAc,CAAC;AAC5F,OAAO,EAAE,iBAAiB,EAAE,kBAAkB,EAAE,kBAAkB,EAAE,MAAM,gBAAgB,CAAC;AAC3F,OAAO,EAAE,WAAW,EAAE,MAAM,eAAe,CAAC"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/engine/registry/index.ts"],"names":[],"mappings":"AAGA,OAAO,EAAE,mBAAmB,EAAE,kBAAkB,EAAE,eAAe,EAAE,YAAY,EAAE,MAAM,WAAW,CAAC;AACnG,OAAO,EAAE,gBAAgB,EAAE,kBAAkB,EAAE,YAAY,EAAE,MAAM,aAAa,CAAC;AACjF,OAAO,EAAE,gBAAgB,EAAE,iBAAiB,EAAE,uBAAuB,EAAE,MAAM,cAAc,CAAC;AAC5F,OAAO,EAAE,iBAAiB,EAAE,kBAAkB,EAAE,kBAAkB,EAAE,MAAM,gBAAgB,CAAC;AAC3F,OAAO,EAAE,WAAW,EAAE,MAAM,eAAe,CAAC;AAG5C,OAAO,EAAE,oBAAoB,EAAE,iBAAiB,EAAE,MAAM,yBAAyB,CAAC;AAClF,OAAO,EAAE,wBAAwB,EAAE,qBAAqB,EAAE,MAAM,6BAA6B,CAAC;AAC9F,OAAO,EAAE,kBAAkB,EAAE,eAAe,EAAE,MAAM,sBAAsB,CAAC;AAC3E,OAAO,EAAE,sBAAsB,EAAE,mBAAmB,EAAE,MAAM,yBAAyB,CAAC"}

package/dist/engine/registry/index.js

@@ -5,4 +5,9 @@ export { loadBaseRegistry, loadCustomRegistry, loadRegistry } from './loader.js'
 export { detectFrameworks, extractReferences, detectUnknownFrameworks } from './matcher.js';
 export { validateReference, validateReferences, detectStaleEntries } from './validator.js';
 export { buildReport } from './reporter.js';
+// SPEC-273: MCP Registry & Smithery publication publishers
+export { generateSmitheryYaml, writeSmitheryYaml } from './smithery-generator.js';
+export { generateMcpRegistryEntry, writeMcpRegistryEntry } from './mcp-official-publisher.js';
+export { generateGlamaEntry, writeGlamaEntry } from './glama-publisher.js';
+export { generateComposioSchema, writeComposioSchema } from './composio-publisher.js';
 //# sourceMappingURL=index.js.map

package/dist/engine/registry/index.js.map

@@ -1 +1 @@
-{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../src/engine/registry/index.ts"],"names":[],"mappings":"AAAA,yEAAyE;AACzE,kGAAkG;AAElG,OAAO,EAAE,mBAAmB,EAAE,kBAAkB,EAAE,eAAe,EAAE,YAAY,EAAE,MAAM,WAAW,CAAC;AACnG,OAAO,EAAE,gBAAgB,EAAE,kBAAkB,EAAE,YAAY,EAAE,MAAM,aAAa,CAAC;AACjF,OAAO,EAAE,gBAAgB,EAAE,iBAAiB,EAAE,uBAAuB,EAAE,MAAM,cAAc,CAAC;AAC5F,OAAO,EAAE,iBAAiB,EAAE,kBAAkB,EAAE,kBAAkB,EAAE,MAAM,gBAAgB,CAAC;AAC3F,OAAO,EAAE,WAAW,EAAE,MAAM,eAAe,CAAC"}
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../src/engine/registry/index.ts"],"names":[],"mappings":"AAAA,yEAAyE;AACzE,kGAAkG;AAElG,OAAO,EAAE,mBAAmB,EAAE,kBAAkB,EAAE,eAAe,EAAE,YAAY,EAAE,MAAM,WAAW,CAAC;AACnG,OAAO,EAAE,gBAAgB,EAAE,kBAAkB,EAAE,YAAY,EAAE,MAAM,aAAa,CAAC;AACjF,OAAO,EAAE,gBAAgB,EAAE,iBAAiB,EAAE,uBAAuB,EAAE,MAAM,cAAc,CAAC;AAC5F,OAAO,EAAE,iBAAiB,EAAE,kBAAkB,EAAE,kBAAkB,EAAE,MAAM,gBAAgB,CAAC;AAC3F,OAAO,EAAE,WAAW,EAAE,MAAM,eAAe,CAAC;AAE5C,2DAA2D;AAC3D,OAAO,EAAE,oBAAoB,EAAE,iBAAiB,EAAE,MAAM,yBAAyB,CAAC;AAClF,OAAO,EAAE,wBAAwB,EAAE,qBAAqB,EAAE,MAAM,6BAA6B,CAAC;AAC9F,OAAO,EAAE,kBAAkB,EAAE,eAAe,EAAE,MAAM,sBAAsB,CAAC;AAC3E,OAAO,EAAE,sBAAsB,EAAE,mBAAmB,EAAE,MAAM,yBAAyB,CAAC"}

package/dist/engine/registry/mcp-official-publisher.d.ts

@@ -0,0 +1,16 @@
+import type { McpRegistryOptions, McpRegistryEntry } from '../../types/registry-publishers.js';
+/**
+ * Generates an MCP Official Registry entry object from the given options.
+ *
+ * @param options  Configuration for the MCP registry entry.
+ * @returns A fully populated McpRegistryEntry ready for serialization.
+ */
+export declare function generateMcpRegistryEntry(options: McpRegistryOptions): McpRegistryEntry;
+/**
+ * Writes mcp-registry-entry.json to the given project directory.
+ *
+ * @param projectPath  Absolute path to the project root.
+ * @param options      MCP registry options.
+ */
+export declare function writeMcpRegistryEntry(projectPath: string, options: McpRegistryOptions): void;
+//# sourceMappingURL=mcp-official-publisher.d.ts.map

package/dist/engine/registry/mcp-official-publisher.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"mcp-official-publisher.d.ts","sourceRoot":"","sources":["../../../src/engine/registry/mcp-official-publisher.ts"],"names":[],"mappings":"AAKA,OAAO,KAAK,EAAE,kBAAkB,EAAE,gBAAgB,EAAE,MAAM,oCAAoC,CAAC;AAE/F;;;;;GAKG;AACH,wBAAgB,wBAAwB,CAAC,OAAO,EAAE,kBAAkB,GAAG,gBAAgB,CAYtF;AAED;;;;;GAKG;AACH,wBAAgB,qBAAqB,CAAC,WAAW,EAAE,MAAM,EAAE,OAAO,EAAE,kBAAkB,GAAG,IAAI,CAY5F"}

package/dist/engine/registry/mcp-official-publisher.js

@@ -0,0 +1,44 @@
+// engine/registry/mcp-official-publisher.ts — SPEC-273: MCP Official Registry publisher
+// Generates mcp-registry-entry.json for registry.modelcontextprotocol.io (Linux Foundation).
+import { writeFileSync } from 'node:fs';
+import { join } from 'node:path';
+/**
+ * Generates an MCP Official Registry entry object from the given options.
+ *
+ * @param options  Configuration for the MCP registry entry.
+ * @returns A fully populated McpRegistryEntry ready for serialization.
+ */
+export function generateMcpRegistryEntry(options) {
+    return {
+        id: options.id,
+        name: options.name,
+        description: options.description,
+        version: options.version,
+        repository: options.repository,
+        author: options.author,
+        transportTypes: ['stdio'],
+        categories: options.categories,
+        toolCount: options.tools.length,
+    };
+}
+/**
+ * Writes mcp-registry-entry.json to the given project directory.
+ *
+ * @param projectPath  Absolute path to the project root.
+ * @param options      MCP registry options.
+ */
+export function writeMcpRegistryEntry(projectPath, options) {
+    const filePath = join(projectPath, 'mcp-registry-entry.json');
+    const entry = generateMcpRegistryEntry(options);
+    const content = JSON.stringify(entry, null, 2) + '\n';
+    /* v8 ignore start */
+    try {
+        writeFileSync(filePath, content, 'utf-8');
+    }
+    catch (err) {
+        const msg = err instanceof Error ? err.message : String(err);
+        throw new Error(`Failed to write mcp-registry-entry.json to ${filePath}: ${msg}`, { cause: err });
+    }
+    /* v8 ignore stop */
+}
+//# sourceMappingURL=mcp-official-publisher.js.map

package/dist/engine/registry/mcp-official-publisher.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"mcp-official-publisher.js","sourceRoot":"","sources":["../../../src/engine/registry/mcp-official-publisher.ts"],"names":[],"mappings":"AAAA,wFAAwF;AACxF,6FAA6F;AAE7F,OAAO,EAAE,aAAa,EAAE,MAAM,SAAS,CAAC;AACxC,OAAO,EAAE,IAAI,EAAE,MAAM,WAAW,CAAC;AAGjC;;;;;GAKG;AACH,MAAM,UAAU,wBAAwB,CAAC,OAA2B;IAClE,OAAO;QACL,EAAE,EAAE,OAAO,CAAC,EAAE;QACd,IAAI,EAAE,OAAO,CAAC,IAAI;QAClB,WAAW,EAAE,OAAO,CAAC,WAAW;QAChC,OAAO,EAAE,OAAO,CAAC,OAAO;QACxB,UAAU,EAAE,OAAO,CAAC,UAAU;QAC9B,MAAM,EAAE,OAAO,CAAC,MAAM;QACtB,cAAc,EAAE,CAAC,OAAO,CAAC;QACzB,UAAU,EAAE,OAAO,CAAC,UAAU;QAC9B,SAAS,EAAE,OAAO,CAAC,KAAK,CAAC,MAAM;KAChC,CAAC;AACJ,CAAC;AAED;;;;;GAKG;AACH,MAAM,UAAU,qBAAqB,CAAC,WAAmB,EAAE,OAA2B;IACpF,MAAM,QAAQ,GAAG,IAAI,CAAC,WAAW,EAAE,yBAAyB,CAAC,CAAC;IAC9D,MAAM,KAAK,GAAG,wBAAwB,CAAC,OAAO,CAAC,CAAC;IAChD,MAAM,OAAO,GAAG,IAAI,CAAC,SAAS,CAAC,KAAK,EAAE,IAAI,EAAE,CAAC,CAAC,GAAG,IAAI,CAAC;IACtD,qBAAqB;IACrB,IAAI,CAAC;QACH,aAAa,CAAC,QAAQ,EAAE,OAAO,EAAE,OAAO,CAAC,CAAC;IAC5C,CAAC;IAAC,OAAO,GAAG,EAAE,CAAC;QACb,MAAM,GAAG,GAAG,GAAG,YAAY,KAAK,CAAC,CAAC,CAAC,GAAG,CAAC,OAAO,CAAC,CAAC,CAAC,MAAM,CAAC,GAAG,CAAC,CAAC;QAC7D,MAAM,IAAI,KAAK,CAAC,8CAA8C,QAAQ,KAAK,GAAG,EAAE,EAAE,EAAE,KAAK,EAAE,GAAG,EAAE,CAAC,CAAC;IACpG,CAAC;IACD,oBAAoB;AACtB,CAAC"}

package/dist/engine/registry/smithery-generator.d.ts

@@ -0,0 +1,16 @@
+import type { SmitheryOptions } from '../../types/registry-publishers.js';
+/**
+ * Generates a smithery.yaml string from the given options.
+ *
+ * @param options  Configuration for the Smithery registry entry.
+ * @returns YAML string suitable for writing to disk.
+ */
+export declare function generateSmitheryYaml(options: SmitheryOptions): string;
+/**
+ * Writes smithery.yaml to the given project directory.
+ *
+ * @param projectPath  Absolute path to the project root.
+ * @param options      Smithery registry options.
+ */
+export declare function writeSmitheryYaml(projectPath: string, options: SmitheryOptions): void;
+//# sourceMappingURL=smithery-generator.d.ts.map

package/dist/engine/registry/smithery-generator.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"smithery-generator.d.ts","sourceRoot":"","sources":["../../../src/engine/registry/smithery-generator.ts"],"names":[],"mappings":"AAKA,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,oCAAoC,CAAC;AAoB1E;;;;;GAKG;AACH,wBAAgB,oBAAoB,CAAC,OAAO,EAAE,eAAe,GAAG,MAAM,CA6BrE;AAED;;;;;GAKG;AACH,wBAAgB,iBAAiB,CAAC,WAAW,EAAE,MAAM,EAAE,OAAO,EAAE,eAAe,GAAG,IAAI,CAWrF"}

package/dist/engine/registry/smithery-generator.js

@@ -0,0 +1,71 @@
+// engine/registry/smithery-generator.ts — SPEC-273: Smithery YAML generator
+// Generates smithery.yaml for publishing MCP servers to smithery.ai marketplace.
+import { writeFileSync } from 'node:fs';
+import { join } from 'node:path';
+/**
+ * Escapes a YAML string value, wrapping in quotes when necessary.
+ */
+function yamlEscapeValue(value) {
+    const needsQuotes = /[:#[\]{},&*?|<>=!%@`'"\n\r\t]/.test(value) || value.trim() !== value;
+    if (needsQuotes) {
+        return `"${value.replace(/\\/g, '\\\\').replace(/"/g, '\\"')}"`;
+    }
+    return value;
+}
+/**
+ * Serializes a string array into YAML block sequence lines.
+ */
+function yamlStringList(items, indent) {
+    return items.map((item) => `${indent}- ${yamlEscapeValue(item)}`).join('\n');
+}
+/**
+ * Generates a smithery.yaml string from the given options.
+ *
+ * @param options  Configuration for the Smithery registry entry.
+ * @returns YAML string suitable for writing to disk.
+ */
+export function generateSmitheryYaml(options) {
+    const lines = [
+        '# smithery.yaml — MCP server registry entry for smithery.ai',
+        '# Auto-generated by Planu (SPEC-273). Do not edit manually.',
+        '',
+        `name: ${yamlEscapeValue(options.name)}`,
+        `description: ${yamlEscapeValue(options.description)}`,
+        `version: ${yamlEscapeValue(options.version)}`,
+        `author: ${yamlEscapeValue(options.author)}`,
+        `repository: ${yamlEscapeValue(options.repository)}`,
+    ];
+    if (options.homepage !== undefined) {
+        lines.push(`homepage: ${yamlEscapeValue(options.homepage)}`);
+    }
+    if (options.license !== undefined) {
+        lines.push(`license: ${yamlEscapeValue(options.license)}`);
+    }
+    lines.push('');
+    lines.push('tools:');
+    lines.push(yamlStringList(options.tools, '  '));
+    lines.push('');
+    lines.push('categories:');
+    lines.push(yamlStringList(options.categories, '  '));
+    return lines.join('\n') + '\n';
+}
+/**
+ * Writes smithery.yaml to the given project directory.
+ *
+ * @param projectPath  Absolute path to the project root.
+ * @param options      Smithery registry options.
+ */
+export function writeSmitheryYaml(projectPath, options) {
+    const filePath = join(projectPath, 'smithery.yaml');
+    const content = generateSmitheryYaml(options);
+    /* v8 ignore start */
+    try {
+        writeFileSync(filePath, content, 'utf-8');
+    }
+    catch (err) {
+        const msg = err instanceof Error ? err.message : String(err);
+        throw new Error(`Failed to write smithery.yaml to ${filePath}: ${msg}`, { cause: err });
+    }
+    /* v8 ignore stop */
+}
+//# sourceMappingURL=smithery-generator.js.map

package/dist/engine/registry/smithery-generator.js.map

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

package/dist/engine/reverse-engineer/test-file-parser.d.ts

@@ -0,0 +1,26 @@
+import type { TestFramework, TestReverseEngineerResult } from '../../types/test-reverse-engineer.js';
+/**
+ * Detect the test framework from file content.
+ */
+export declare function detectFramework(content: string): TestFramework;
+/**
+ * Clean an AC text from a test description:
+ * - Remove leading "should " (case-insensitive)
+ * - Remove leading "it "
+ * - Capitalize first letter
+ * - Trim whitespace
+ */
+export declare function cleanAcText(description: string): string;
+/**
+ * Suggest a spec title from an array of describe group names.
+ */
+export declare function suggestTitle(groups: string[]): string;
+/**
+ * Suggest tags from the file path and detected framework.
+ */
+export declare function suggestTags(filePath: string, framework: TestFramework): string[];
+/**
+ * Parse a test file and extract acceptance criteria.
+ */
+export declare function parseTestFile(filePath: string): Promise<TestReverseEngineerResult>;
+//# sourceMappingURL=test-file-parser.d.ts.map

package/dist/engine/reverse-engineer/test-file-parser.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"test-file-parser.d.ts","sourceRoot":"","sources":["../../../src/engine/reverse-engineer/test-file-parser.ts"],"names":[],"mappings":"AAIA,OAAO,KAAK,EACV,aAAa,EAEb,yBAAyB,EAG1B,MAAM,sCAAsC,CAAC;AAE9C;;GAEG;AACH,wBAAgB,eAAe,CAAC,OAAO,EAAE,MAAM,GAAG,aAAa,CA0B9D;AAED;;;;;;GAMG;AACH,wBAAgB,WAAW,CAAC,WAAW,EAAE,MAAM,GAAG,MAAM,CASvD;AAED;;GAEG;AACH,wBAAgB,YAAY,CAAC,MAAM,EAAE,MAAM,EAAE,GAAG,MAAM,CASrD;AAED;;GAEG;AACH,wBAAgB,WAAW,CAAC,QAAQ,EAAE,MAAM,EAAE,SAAS,EAAE,aAAa,GAAG,MAAM,EAAE,CAwBhF;AAmED;;GAEG;AACH,wBAAsB,aAAa,CAAC,QAAQ,EAAE,MAAM,GAAG,OAAO,CAAC,yBAAyB,CAAC,CAyBxF"}