@planu/cli 0.96.5 → 0.97.1

package/dist/tools/register-spec-319.js

@@ -0,0 +1,59 @@
+// tools/register-spec-319.ts — Registers compliance tools (SPEC-319)
+import { z } from 'zod';
+import { safeTracked } from './safe-handler.js';
+import { handleCheckCompliance, handleConfigureCompliance } from './compliance-handler.js';
+const FRAMEWORK_ENUM = ['gdpr', 'hipaa', 'pci-dss', 'soc2', 'ccpa'];
+const frameworkSchema = z
+    .enum(FRAMEWORK_ENUM)
+    .describe('Compliance framework. Valid values: gdpr, hipaa, pci-dss, soc2, ccpa.');
+export function registerComplianceTools(server) {
+    // -------------------------------------------------------------------------
+    // check_compliance — evaluate a spec's AC against compliance frameworks
+    // -------------------------------------------------------------------------
+    server.registerTool('check_compliance', {
+        description: 'Evaluate a spec\'s acceptance criteria against regulatory compliance requirements. ' +
+            'Detects gaps for the specified frameworks (or auto-detects relevant frameworks from spec content). ' +
+            'Supported frameworks: gdpr, hipaa, pci-dss, soc2, ccpa.',
+        inputSchema: {
+            specId: z
+                .string()
+                .min(1)
+                .max(500)
+                .describe('Spec ID to check (e.g. SPEC-042).'),
+            projectPath: z
+                .string()
+                .min(1)
+                .max(4096)
+                .describe('Absolute path to the project root.'),
+            frameworks: z
+                .array(frameworkSchema)
+                .optional()
+                .describe('Compliance frameworks to check. If omitted, auto-detects from spec content ' +
+                'or uses project-level configuration. ' +
+                'Valid values: gdpr, hipaa, pci-dss, soc2, ccpa.'),
+        },
+        annotations: { title: 'Check Compliance', readOnlyHint: true },
+    }, safeTracked('check_compliance', (args) => handleCheckCompliance(args)));
+    // -------------------------------------------------------------------------
+    // configure_compliance — set project-level compliance frameworks
+    // -------------------------------------------------------------------------
+    server.registerTool('configure_compliance', {
+        description: 'Configure project-level compliance frameworks. ' +
+            'Once set, `check_compliance` uses these frameworks when none are specified. ' +
+            'Supported frameworks: gdpr, hipaa, pci-dss, soc2, ccpa.',
+        inputSchema: {
+            projectPath: z
+                .string()
+                .min(1)
+                .max(4096)
+                .describe('Absolute path to the project root.'),
+            frameworks: z
+                .array(frameworkSchema)
+                .min(1)
+                .describe('Compliance frameworks to activate for this project. ' +
+                'Valid values: gdpr, hipaa, pci-dss, soc2, ccpa.'),
+        },
+        annotations: { title: 'Configure Compliance', destructiveHint: false },
+    }, safeTracked('configure_compliance', (args) => handleConfigureCompliance(args)));
+}
+//# sourceMappingURL=register-spec-319.js.map

package/dist/tools/register-spec-319.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"register-spec-319.js","sourceRoot":"","sources":["../../src/tools/register-spec-319.ts"],"names":[],"mappings":"AAAA,qEAAqE;AAGrE,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AACxB,OAAO,EAAE,WAAW,EAAE,MAAM,mBAAmB,CAAC;AAChD,OAAO,EAAE,qBAAqB,EAAE,yBAAyB,EAAE,MAAM,yBAAyB,CAAC;AAG3F,MAAM,cAAc,GAAG,CAAC,MAAM,EAAE,OAAO,EAAE,SAAS,EAAE,MAAM,EAAE,MAAM,CAAU,CAAC;AAE7E,MAAM,eAAe,GAAG,CAAC;KACtB,IAAI,CAAC,cAAc,CAAC;KACpB,QAAQ,CACP,uEAAuE,CACxE,CAAC;AAEJ,MAAM,UAAU,uBAAuB,CAAC,MAAiB;IACvD,4EAA4E;IAC5E,wEAAwE;IACxE,4EAA4E;IAE5E,MAAM,CAAC,YAAY,CACjB,kBAAkB,EAClB;QACE,WAAW,EACT,qFAAqF;YACrF,qGAAqG;YACrG,yDAAyD;QAC3D,WAAW,EAAE;YACX,MAAM,EAAE,CAAC;iBACN,MAAM,EAAE;iBACR,GAAG,CAAC,CAAC,CAAC;iBACN,GAAG,CAAC,GAAG,CAAC;iBACR,QAAQ,CAAC,mCAAmC,CAAC;YAChD,WAAW,EAAE,CAAC;iBACX,MAAM,EAAE;iBACR,GAAG,CAAC,CAAC,CAAC;iBACN,GAAG,CAAC,IAAI,CAAC;iBACT,QAAQ,CAAC,oCAAoC,CAAC;YACjD,UAAU,EAAE,CAAC;iBACV,KAAK,CAAC,eAAe,CAAC;iBACtB,QAAQ,EAAE;iBACV,QAAQ,CACP,6EAA6E;gBAC7E,uCAAuC;gBACvC,iDAAiD,CAClD;SACJ;QACD,WAAW,EAAE,EAAE,KAAK,EAAE,kBAAkB,EAAE,YAAY,EAAE,IAAI,EAAE;KAC/D,EACD,WAAW,CAAC,kBAAkB,EAAE,CAAC,IAAI,EAAE,EAAE,CACvC,qBAAqB,CAAC,IAA4B,CAAC,CACpD,CACF,CAAC;IAEF,4EAA4E;IAC5E,iEAAiE;IACjE,4EAA4E;IAE5E,MAAM,CAAC,YAAY,CACjB,sBAAsB,EACtB;QACE,WAAW,EACT,iDAAiD;YACjD,8EAA8E;YAC9E,yDAAyD;QAC3D,WAAW,EAAE;YACX,WAAW,EAAE,CAAC;iBACX,MAAM,EAAE;iBACR,GAAG,CAAC,CAAC,CAAC;iBACN,GAAG,CAAC,IAAI,CAAC;iBACT,QAAQ,CAAC,oCAAoC,CAAC;YACjD,UAAU,EAAE,CAAC;iBACV,KAAK,CAAC,eAAe,CAAC;iBACtB,GAAG,CAAC,CAAC,CAAC;iBACN,QAAQ,CACP,sDAAsD;gBACtD,iDAAiD,CAClD;SACJ;QACD,WAAW,EAAE,EAAE,KAAK,EAAE,sBAAsB,EAAE,eAAe,EAAE,KAAK,EAAE;KACvE,EACD,WAAW,CAAC,sBAAsB,EAAE,CAAC,IAAI,EAAE,EAAE,CAC3C,yBAAyB,CAAC,IAAgC,CAAC,CAC5D,CACF,CAAC;AACJ,CAAC"}

package/dist/tools/register-spec-320.d.ts

@@ -0,0 +1,3 @@
+import type { McpServer } from '@modelcontextprotocol/sdk/server/mcp.js';
+export declare function registerSpecMarketplaceTools(server: McpServer): void;
+//# sourceMappingURL=register-spec-320.d.ts.map

package/dist/tools/register-spec-320.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"register-spec-320.d.ts","sourceRoot":"","sources":["../../src/tools/register-spec-320.ts"],"names":[],"mappings":"AAEA,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,yCAAyC,CAAC;AASzE,wBAAgB,4BAA4B,CAAC,MAAM,EAAE,SAAS,GAAG,IAAI,CAiFpE"}

package/dist/tools/register-spec-320.js

@@ -0,0 +1,60 @@
+// tools/register-spec-320.ts — Registers spec marketplace tools (SPEC-320)
+import { z } from 'zod';
+import { safeTracked } from './safe-handler.js';
+import { handleSearchSpecTemplates, handleApplySpecTemplate, handlePublishSpecTemplate, } from './spec-marketplace-handler.js';
+export function registerSpecMarketplaceTools(server) {
+    // search_spec_templates — SPEC-320
+    server.registerTool('search_spec_templates', {
+        description: 'Search community spec templates by keyword or tag. Returns built-in templates (stripe-payments, oauth-social-login, crud-rest-api, file-upload-s3, jwt-auth, rate-limiting, email-notifications, webhook-system). Use apply_spec_template to instantiate one.',
+        annotations: { readOnlyHint: true },
+        inputSchema: {
+            projectPath: z.string().min(1).max(4096).describe('Absolute path to the project root.'),
+            query: z
+                .string()
+                .max(200)
+                .optional()
+                .describe('Optional keyword to search templates by name, description, or tags. Leave empty to list all templates.'),
+        },
+    }, safeTracked('search_spec_templates', async (args) => handleSearchSpecTemplates(args)));
+    // apply_spec_template — SPEC-320
+    server.registerTool('apply_spec_template', {
+        description: 'Instantiate a spec template by substituting variables into the template content. Returns the rendered spec.md content ready to pass to create_spec. Valid template names: stripe-payments, oauth-social-login, crud-rest-api, file-upload-s3, jwt-auth, rate-limiting, email-notifications, webhook-system.',
+        inputSchema: {
+            projectPath: z.string().min(1).max(4096).describe('Absolute path to the project root.'),
+            templateName: z
+                .string()
+                .min(1)
+                .max(100)
+                .describe('Name of the template to apply. Valid values: stripe-payments, oauth-social-login, crud-rest-api, file-upload-s3, jwt-auth, rate-limiting, email-notifications, webhook-system.'),
+            variables: z
+                .record(z.string(), z.string().max(500))
+                .describe('Key-value map of variable substitutions. Keys must match the template variable names (e.g. { "entity": "Product", "base_path": "/api/products" }).'),
+        },
+    }, safeTracked('apply_spec_template', async (args) => handleApplySpecTemplate({
+        projectPath: args.projectPath,
+        templateName: args.templateName,
+        variables: args.variables,
+    })));
+    // publish_spec_template — SPEC-320
+    server.registerTool('publish_spec_template', {
+        description: 'Publish an existing spec as a reusable template by extracting variable placeholders. Returns the template manifest JSON that can be shared with the team.',
+        annotations: { destructiveHint: false },
+        inputSchema: {
+            projectPath: z.string().min(1).max(4096).describe('Absolute path to the project root.'),
+            specId: z
+                .string()
+                .min(1)
+                .max(100)
+                .describe('ID of the spec to publish as a template (e.g. SPEC-042).'),
+            templateName: z
+                .string()
+                .min(1)
+                .max(100)
+                .describe('Slug name for the new template (e.g. stripe-payments-v2).'),
+            variables: z
+                .array(z.string().max(100))
+                .describe('List of variable names that will become template placeholders in the spec content (e.g. ["entity", "base_path"]).'),
+        },
+    }, safeTracked('publish_spec_template', async (args) => handlePublishSpecTemplate(args)));
+}
+//# sourceMappingURL=register-spec-320.js.map

package/dist/tools/register-spec-320.js.map

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

package/dist/tools/spec-marketplace-handler.d.ts

@@ -0,0 +1,6 @@
+import type { ToolResult } from '../types/index.js';
+import type { SearchSpecTemplatesInput, ApplySpecTemplateInput, PublishSpecTemplateInput } from '../types/spec-marketplace.js';
+export declare function handleSearchSpecTemplates(input: SearchSpecTemplatesInput): Promise<ToolResult>;
+export declare function handleApplySpecTemplate(input: ApplySpecTemplateInput): Promise<ToolResult>;
+export declare function handlePublishSpecTemplate(input: PublishSpecTemplateInput): Promise<ToolResult>;
+//# sourceMappingURL=spec-marketplace-handler.d.ts.map

package/dist/tools/spec-marketplace-handler.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"spec-marketplace-handler.d.ts","sourceRoot":"","sources":["../../src/tools/spec-marketplace-handler.ts"],"names":[],"mappings":"AAEA,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,mBAAmB,CAAC;AACpD,OAAO,KAAK,EACV,wBAAwB,EACxB,sBAAsB,EACtB,wBAAwB,EACzB,MAAM,8BAA8B,CAAC;AAetC,wBAAsB,yBAAyB,CAC7C,KAAK,EAAE,wBAAwB,GAC9B,OAAO,CAAC,UAAU,CAAC,CA8BrB;AAMD,wBAAsB,uBAAuB,CAC3C,KAAK,EAAE,sBAAsB,GAC5B,OAAO,CAAC,UAAU,CAAC,CAsCrB;AAMD,wBAAsB,yBAAyB,CAC7C,KAAK,EAAE,wBAAwB,GAC9B,OAAO,CAAC,UAAU,CAAC,CAoCrB"}

package/dist/tools/spec-marketplace-handler.js

@@ -0,0 +1,113 @@
+// tools/spec-marketplace-handler.ts — MCP tool handlers for SPEC-320 Spec Marketplace
+import { searchTemplates, applyTemplate, buildPublishManifest, } from '../engine/spec-template-engine.js';
+import { getSpec } from '../storage/spec-store.js';
+import { hashProjectPath } from '../storage/base-store.js';
+import { readFile } from 'node:fs/promises';
+import { existsSync } from 'node:fs';
+// ---------------------------------------------------------------------------
+// search_spec_templates
+// ---------------------------------------------------------------------------
+export async function handleSearchSpecTemplates(input) {
+    const query = input.query ?? '';
+    const templates = await searchTemplates(query);
+    if (templates.length === 0) {
+        const msg = query.length > 0
+            ? `No templates found matching "${query}". Try a different keyword.`
+            : 'No templates available.';
+        return { content: [{ type: 'text', text: msg }] };
+    }
+    const lines = [`Found ${String(templates.length)} template(s):`, ''];
+    for (const t of templates) {
+        const { manifest, source } = t;
+        const tags = manifest.tags.join(', ');
+        const varNames = manifest.variables.map((v) => v.name).join(', ');
+        lines.push(`### ${manifest.name} (${source})`);
+        lines.push(manifest.description);
+        lines.push(`**Tags:** ${tags}`);
+        if (varNames.length > 0) {
+            lines.push(`**Variables:** ${varNames}`);
+        }
+        lines.push('');
+    }
+    lines.push('Use `apply_spec_template` to instantiate a template.');
+    return { content: [{ type: 'text', text: lines.join('\n') }] };
+}
+// ---------------------------------------------------------------------------
+// apply_spec_template
+// ---------------------------------------------------------------------------
+export async function handleApplySpecTemplate(input) {
+    const content = await applyTemplate(input.templateName, input.variables);
+    if (content === null) {
+        return {
+            content: [
+                {
+                    type: 'text',
+                    text: `Template "${input.templateName}" not found. Run \`search_spec_templates\` to see available templates.`,
+                },
+            ],
+            isError: true,
+        };
+    }
+    if (content.trim().length === 0) {
+        return {
+            content: [
+                {
+                    type: 'text',
+                    text: `Template "${input.templateName}" has no spec content. This is a misconfigured built-in template.`,
+                },
+            ],
+            isError: true,
+        };
+    }
+    const lines = [
+        `Template \`${input.templateName}\` applied successfully.`,
+        '',
+        'Use the content below to create a spec with `create_spec`:',
+        '',
+        '```markdown',
+        content,
+        '```',
+    ];
+    return { content: [{ type: 'text', text: lines.join('\n') }] };
+}
+// ---------------------------------------------------------------------------
+// publish_spec_template
+// ---------------------------------------------------------------------------
+export async function handlePublishSpecTemplate(input) {
+    const projectId = hashProjectPath(input.projectPath);
+    const spec = await getSpec(projectId, input.specId);
+    if (spec === null) {
+        return {
+            content: [
+                {
+                    type: 'text',
+                    text: `Spec "${input.specId}" not found in project. Verify the spec ID and project path.`,
+                },
+            ],
+            isError: true,
+        };
+    }
+    const specContent = await readSpecContent(spec.specPath);
+    const manifest = buildPublishManifest(input.specId, input.templateName, input.variables, specContent);
+    const lines = [
+        `Template \`${manifest.name}\` published from spec \`${input.specId}\`.`,
+        '',
+        '**Manifest:**',
+        '```json',
+        JSON.stringify(manifest, null, 2),
+        '```',
+        '',
+        'Share the manifest with your team so they can use `apply_spec_template` to instantiate it.',
+    ];
+    return { content: [{ type: 'text', text: lines.join('\n') }] };
+}
+// ---------------------------------------------------------------------------
+// Internal helpers
+// ---------------------------------------------------------------------------
+async function readSpecContent(specPath) {
+    if (existsSync(specPath)) {
+        return readFile(specPath, 'utf-8');
+    }
+    return '';
+}
+//# sourceMappingURL=spec-marketplace-handler.js.map

package/dist/tools/spec-marketplace-handler.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"spec-marketplace-handler.js","sourceRoot":"","sources":["../../src/tools/spec-marketplace-handler.ts"],"names":[],"mappings":"AAAA,sFAAsF;AAQtF,OAAO,EACL,eAAe,EACf,aAAa,EACb,oBAAoB,GACrB,MAAM,mCAAmC,CAAC;AAC3C,OAAO,EAAE,OAAO,EAAE,MAAM,0BAA0B,CAAC;AACnD,OAAO,EAAE,eAAe,EAAE,MAAM,0BAA0B,CAAC;AAC3D,OAAO,EAAE,QAAQ,EAAE,MAAM,kBAAkB,CAAC;AAC5C,OAAO,EAAE,UAAU,EAAE,MAAM,SAAS,CAAC;AAErC,8EAA8E;AAC9E,wBAAwB;AACxB,8EAA8E;AAE9E,MAAM,CAAC,KAAK,UAAU,yBAAyB,CAC7C,KAA+B;IAE/B,MAAM,KAAK,GAAG,KAAK,CAAC,KAAK,IAAI,EAAE,CAAC;IAChC,MAAM,SAAS,GAAG,MAAM,eAAe,CAAC,KAAK,CAAC,CAAC;IAE/C,IAAI,SAAS,CAAC,MAAM,KAAK,CAAC,EAAE,CAAC;QAC3B,MAAM,GAAG,GACP,KAAK,CAAC,MAAM,GAAG,CAAC;YACd,CAAC,CAAC,gCAAgC,KAAK,6BAA6B;YACpE,CAAC,CAAC,yBAAyB,CAAC;QAChC,OAAO,EAAE,OAAO,EAAE,CAAC,EAAE,IAAI,EAAE,MAAM,EAAE,IAAI,EAAE,GAAG,EAAE,CAAC,EAAE,CAAC;IACpD,CAAC;IAED,MAAM,KAAK,GAAa,CAAC,SAAS,MAAM,CAAC,SAAS,CAAC,MAAM,CAAC,eAAe,EAAE,EAAE,CAAC,CAAC;IAE/E,KAAK,MAAM,CAAC,IAAI,SAAS,EAAE,CAAC;QAC1B,MAAM,EAAE,QAAQ,EAAE,MAAM,EAAE,GAAG,CAAC,CAAC;QAC/B,MAAM,IAAI,GAAG,QAAQ,CAAC,IAAI,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;QACtC,MAAM,QAAQ,GAAG,QAAQ,CAAC,SAAS,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;QAClE,KAAK,CAAC,IAAI,CAAC,OAAO,QAAQ,CAAC,IAAI,KAAK,MAAM,GAAG,CAAC,CAAC;QAC/C,KAAK,CAAC,IAAI,CAAC,QAAQ,CAAC,WAAW,CAAC,CAAC;QACjC,KAAK,CAAC,IAAI,CAAC,aAAa,IAAI,EAAE,CAAC,CAAC;QAChC,IAAI,QAAQ,CAAC,MAAM,GAAG,CAAC,EAAE,CAAC;YACxB,KAAK,CAAC,IAAI,CAAC,kBAAkB,QAAQ,EAAE,CAAC,CAAC;QAC3C,CAAC;QACD,KAAK,CAAC,IAAI,CAAC,EAAE,CAAC,CAAC;IACjB,CAAC;IAED,KAAK,CAAC,IAAI,CAAC,sDAAsD,CAAC,CAAC;IAEnE,OAAO,EAAE,OAAO,EAAE,CAAC,EAAE,IAAI,EAAE,MAAM,EAAE,IAAI,EAAE,KAAK,CAAC,IAAI,CAAC,IAAI,CAAC,EAAE,CAAC,EAAE,CAAC;AACjE,CAAC;AAED,8EAA8E;AAC9E,sBAAsB;AACtB,8EAA8E;AAE9E,MAAM,CAAC,KAAK,UAAU,uBAAuB,CAC3C,KAA6B;IAE7B,MAAM,OAAO,GAAG,MAAM,aAAa,CAAC,KAAK,CAAC,YAAY,EAAE,KAAK,CAAC,SAAS,CAAC,CAAC;IAEzE,IAAI,OAAO,KAAK,IAAI,EAAE,CAAC;QACrB,OAAO;YACL,OAAO,EAAE;gBACP;oBACE,IAAI,EAAE,MAAM;oBACZ,IAAI,EAAE,aAAa,KAAK,CAAC,YAAY,wEAAwE;iBAC9G;aACF;YACD,OAAO,EAAE,IAAI;SACd,CAAC;IACJ,CAAC;IAED,IAAI,OAAO,CAAC,IAAI,EAAE,CAAC,MAAM,KAAK,CAAC,EAAE,CAAC;QAChC,OAAO;YACL,OAAO,EAAE;gBACP;oBACE,IAAI,EAAE,MAAM;oBACZ,IAAI,EAAE,aAAa,KAAK,CAAC,YAAY,mEAAmE;iBACzG;aACF;YACD,OAAO,EAAE,IAAI;SACd,CAAC;IACJ,CAAC;IAED,MAAM,KAAK,GAAG;QACZ,cAAc,KAAK,CAAC,YAAY,0BAA0B;QAC1D,EAAE;QACF,4DAA4D;QAC5D,EAAE;QACF,aAAa;QACb,OAAO;QACP,KAAK;KACN,CAAC;IAEF,OAAO,EAAE,OAAO,EAAE,CAAC,EAAE,IAAI,EAAE,MAAM,EAAE,IAAI,EAAE,KAAK,CAAC,IAAI,CAAC,IAAI,CAAC,EAAE,CAAC,EAAE,CAAC;AACjE,CAAC;AAED,8EAA8E;AAC9E,wBAAwB;AACxB,8EAA8E;AAE9E,MAAM,CAAC,KAAK,UAAU,yBAAyB,CAC7C,KAA+B;IAE/B,MAAM,SAAS,GAAG,eAAe,CAAC,KAAK,CAAC,WAAW,CAAC,CAAC;IACrD,MAAM,IAAI,GAAG,MAAM,OAAO,CAAC,SAAS,EAAE,KAAK,CAAC,MAAM,CAAC,CAAC;IAEpD,IAAI,IAAI,KAAK,IAAI,EAAE,CAAC;QAClB,OAAO;YACL,OAAO,EAAE;gBACP;oBACE,IAAI,EAAE,MAAM;oBACZ,IAAI,EAAE,SAAS,KAAK,CAAC,MAAM,8DAA8D;iBAC1F;aACF;YACD,OAAO,EAAE,IAAI;SACd,CAAC;IACJ,CAAC;IAED,MAAM,WAAW,GAAG,MAAM,eAAe,CAAC,IAAI,CAAC,QAAQ,CAAC,CAAC;IACzD,MAAM,QAAQ,GAAG,oBAAoB,CACnC,KAAK,CAAC,MAAM,EACZ,KAAK,CAAC,YAAY,EAClB,KAAK,CAAC,SAAS,EACf,WAAW,CACZ,CAAC;IAEF,MAAM,KAAK,GAAG;QACZ,cAAc,QAAQ,CAAC,IAAI,4BAA4B,KAAK,CAAC,MAAM,KAAK;QACxE,EAAE;QACF,eAAe;QACf,SAAS;QACT,IAAI,CAAC,SAAS,CAAC,QAAQ,EAAE,IAAI,EAAE,CAAC,CAAC;QACjC,KAAK;QACL,EAAE;QACF,4FAA4F;KAC7F,CAAC;IAEF,OAAO,EAAE,OAAO,EAAE,CAAC,EAAE,IAAI,EAAE,MAAM,EAAE,IAAI,EAAE,KAAK,CAAC,IAAI,CAAC,IAAI,CAAC,EAAE,CAAC,EAAE,CAAC;AACjE,CAAC;AAED,8EAA8E;AAC9E,mBAAmB;AACnB,8EAA8E;AAE9E,KAAK,UAAU,eAAe,CAAC,QAAgB;IAC7C,IAAI,UAAU,CAAC,QAAQ,CAAC,EAAE,CAAC;QACzB,OAAO,QAAQ,CAAC,QAAQ,EAAE,OAAO,CAAC,CAAC;IACrC,CAAC;IACD,OAAO,EAAE,CAAC;AACZ,CAAC"}

package/dist/tools/spec-quality-score-handler.d.ts

@@ -0,0 +1,7 @@
+import type { ToolResult } from '../types/index.js';
+export declare function handleSpecQualityScore(args: {
+    specId: string;
+    projectPath?: string;
+    projectId?: string;
+}): Promise<ToolResult>;
+//# sourceMappingURL=spec-quality-score-handler.d.ts.map

package/dist/tools/spec-quality-score-handler.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"spec-quality-score-handler.d.ts","sourceRoot":"","sources":["../../src/tools/spec-quality-score-handler.ts"],"names":[],"mappings":"AAMA,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,mBAAmB,CAAC;AA6FpD,wBAAsB,sBAAsB,CAAC,IAAI,EAAE;IACjD,MAAM,EAAE,MAAM,CAAC;IACf,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,SAAS,CAAC,EAAE,MAAM,CAAC;CACpB,GAAG,OAAO,CAAC,UAAU,CAAC,CA0BtB"}

package/dist/tools/spec-quality-score-handler.js

@@ -0,0 +1,106 @@
+// tools/spec-quality-score-handler.ts — spec_quality_score tool handler (SPEC-314)
+import { specStore } from '../storage/index.js';
+import { scoreSpecQuality } from '../engine/spec-quality-scorer.js';
+import { resolveProjectId, missingProjectIdError } from './resolve-project-id.js';
+import { toolResult, errText } from './response-helpers.js';
+// ── Formatting ───────────────────────────────────────────────────────────────
+function gradeLabel(grade) {
+    switch (grade) {
+        case 'A': return 'Excellent';
+        case 'B': return 'Good';
+        case 'C': return 'Fair';
+        case 'D': return 'Poor';
+        case 'F': return 'Failing';
+    }
+}
+function scoreBar(score, max) {
+    const filled = Math.round((score / max) * 10);
+    const empty = 10 - filled;
+    return `[${'#'.repeat(filled)}${'.'.repeat(empty)}] ${String(score)}/${String(max)}`;
+}
+function formatReport(report) {
+    const { score, dimensions } = report;
+    const lines = [];
+    lines.push(`# Quality Score — ${report.specId}`);
+    lines.push('');
+    lines.push(`**Grade**: ${score.grade} (${gradeLabel(score.grade)}) — ${String(score.total)}/100`);
+    lines.push('');
+    lines.push('## Score Breakdown');
+    lines.push('');
+    lines.push(`| Dimension | Score | Bar |`);
+    lines.push(`|-----------|-------|-----|`);
+    lines.push(`| Completeness | ${String(score.completeness)}/25 | ${scoreBar(score.completeness, 25)} |`);
+    lines.push(`| Testability | ${String(score.testability)}/25 | ${scoreBar(score.testability, 25)} |`);
+    lines.push(`| Ambiguity | ${String(score.ambiguity)}/25 | ${scoreBar(score.ambiguity, 25)} |`);
+    lines.push(`| Risk | ${String(score.risk)}/25 | ${scoreBar(score.risk, 25)} |`);
+    lines.push(`| **Total** | **${String(score.total)}/100** | ${scoreBar(score.total, 100)} |`);
+    lines.push('');
+    // Per-dimension issues
+    const dimensionEntries = [
+        ['Completeness', dimensions.completeness],
+        ['Testability', dimensions.testability],
+        ['Ambiguity', dimensions.ambiguity],
+        ['Risk', dimensions.risk],
+    ];
+    const allIssues = [];
+    const allRecs = [];
+    for (const [name, detail] of dimensionEntries) {
+        if (detail.issues.length > 0) {
+            lines.push(`## ${name} Issues`);
+            lines.push('');
+            for (const issue of detail.issues) {
+                lines.push(`- ${issue}`);
+                allIssues.push(issue);
+            }
+            lines.push('');
+        }
+        for (const rec of detail.recommendations) {
+            allRecs.push(rec);
+        }
+    }
+    if (allRecs.length > 0) {
+        lines.push('## Recommendations');
+        lines.push('');
+        const deduped = [...new Set(allRecs)];
+        for (const rec of deduped) {
+            lines.push(`- ${rec}`);
+        }
+        lines.push('');
+    }
+    // Grade interpretation
+    lines.push('## Grade Interpretation');
+    lines.push('');
+    lines.push('| Grade | Range | Meaning |');
+    lines.push('|-------|-------|---------|');
+    lines.push('| A | 90-100 | Ready for implementation |');
+    lines.push('| B | 75-89 | Minor improvements recommended |');
+    lines.push('| C | 60-74 | Needs work before implementation |');
+    lines.push('| D | 45-59 | Significant gaps — do not implement yet |');
+    lines.push('| F | 0-44 | Spec requires major revision |');
+    return lines.join('\n');
+}
+// ── Handler ──────────────────────────────────────────────────────────────────
+export async function handleSpecQualityScore(args) {
+    const projectId = resolveProjectId(args);
+    if (!projectId) {
+        return missingProjectIdError;
+    }
+    const { specId } = args;
+    const spec = await specStore.getSpec(projectId, specId);
+    if (!spec) {
+        return errText(`Spec '${specId}' not found in project '${projectId}'`);
+    }
+    const report = await scoreSpecQuality(spec);
+    const formatted = formatReport(report);
+    return toolResult(formatted, {
+        specId: report.specId,
+        score: report.score,
+        dimensions: {
+            completeness: { score: report.dimensions.completeness.score, issues: report.dimensions.completeness.issues },
+            testability: { score: report.dimensions.testability.score, issues: report.dimensions.testability.issues },
+            ambiguity: { score: report.dimensions.ambiguity.score, issues: report.dimensions.ambiguity.issues },
+            risk: { score: report.dimensions.risk.score, issues: report.dimensions.risk.issues },
+        },
+    });
+}
+//# sourceMappingURL=spec-quality-score-handler.js.map

package/dist/tools/spec-quality-score-handler.js.map

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

package/dist/tools/start-hooks/configure.d.ts

@@ -0,0 +1,4 @@
+import type { ToolResult } from '../../types/index.js';
+import type { ConfigureHooksInput } from '../../types/file-hooks.js';
+export declare function handleConfigureHooks(args: ConfigureHooksInput): Promise<ToolResult>;
+//# sourceMappingURL=configure.d.ts.map

package/dist/tools/start-hooks/configure.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"configure.d.ts","sourceRoot":"","sources":["../../../src/tools/start-hooks/configure.ts"],"names":[],"mappings":"AAEA,OAAO,KAAK,EAAE,UAAU,EAA6B,MAAM,sBAAsB,CAAC;AAClF,OAAO,KAAK,EAAE,mBAAmB,EAAE,MAAM,2BAA2B,CAAC;AAQrE,wBAAsB,oBAAoB,CAAC,IAAI,EAAE,mBAAmB,GAAG,OAAO,CAAC,UAAU,CAAC,CA6CzF"}

package/dist/tools/start-hooks/configure.js

@@ -0,0 +1,122 @@
+// tools/start-hooks/configure.ts — handleConfigureHooks + plan-mode integration + template apply.
+import { readFile, writeFile, mkdir } from 'node:fs/promises';
+import { join } from 'node:path';
+import { generateHookTemplate, mergeHookConfig } from '../../engine/hooks/hook-templates.js';
+import { buildPlanModeHookScripts } from '../../engine/hooks/plan-mode-scripts.js';
+import { ConfigLoader } from '../../engine/hooks/config-loader.js';
+import { getConfigLoaderInstance, getEngineInstance } from './engine.js';
+export async function handleConfigureHooks(args) {
+    if (args.action === 'enable-plan-mode-integration') {
+        return enablePlanModeIntegration(args.projectPath);
+    }
+    if (args.template) {
+        return applyHookTemplate(args);
+    }
+    const configLoader = getConfigLoaderInstance();
+    if (!configLoader) {
+        const loader = new ConfigLoader(args.projectPath);
+        const config = await loader.load();
+        loader.close();
+        return {
+            content: [
+                {
+                    type: 'text',
+                    text: JSON.stringify({ message: 'Hook engine not running. Current config:', config }, null, 2),
+                },
+            ],
+        };
+    }
+    const config = await configLoader.load();
+    return {
+        content: [
+            {
+                type: 'text',
+                text: JSON.stringify({
+                    message: 'Configuration reloaded',
+                    config,
+                    engineRunning: getEngineInstance()?.status().running ?? false,
+                }, null, 2),
+            },
+        ],
+    };
+}
+async function enablePlanModeIntegration(projectPath) {
+    const hooksDir = join(projectPath, '.claude', 'hooks');
+    await mkdir(hooksDir, { recursive: true });
+    const scripts = buildPlanModeHookScripts();
+    const preHookPath = join(hooksDir, 'planu-pre-plan.sh');
+    const postHookPath = join(hooksDir, 'planu-post-plan.sh');
+    await writeFile(preHookPath, scripts.preScript, { mode: 0o755 });
+    await writeFile(postHookPath, scripts.postScript, { mode: 0o755 });
+    const settingsPath = join(projectPath, '.claude', 'settings.json');
+    let existing = {};
+    try {
+        const raw = await readFile(settingsPath, 'utf-8');
+        existing = JSON.parse(raw);
+    }
+    catch {
+        // File doesn't exist yet — start from empty
+    }
+    const preEntry = {
+        matcher: 'Task',
+        hooks: [{ type: 'command', command: `bash "${preHookPath}"` }],
+    };
+    const postEntry = {
+        matcher: 'exit_plan_mode',
+        hooks: [{ type: 'command', command: `bash "${postHookPath}"` }],
+    };
+    const existingHooks = (existing.hooks ?? {});
+    const merged = {
+        ...existing,
+        hooks: {
+            ...existingHooks,
+            PreToolUse: [...(existingHooks.PreToolUse ?? []), preEntry],
+            PostToolUse: [...(existingHooks.PostToolUse ?? []), postEntry],
+        },
+    };
+    await writeFile(settingsPath, JSON.stringify(merged, null, 2) + '\n', 'utf-8');
+    const result = {
+        action: 'enable-plan-mode-integration',
+        preHookPath,
+        postHookPath,
+        settingsPath,
+        message: 'Plan Mode integration enabled. Planu context will be injected automatically when Claude enters Plan Mode.',
+    };
+    return { content: [{ type: 'text', text: JSON.stringify(result, null, 2) }] };
+}
+async function applyHookTemplate(args) {
+    /* c8 ignore next 3 */
+    if (!args.template) {
+        return { content: [{ type: 'text', text: 'template is required' }], isError: true };
+    }
+    const generated = generateHookTemplate({
+        template: args.template,
+        notificationMatcher: args.notificationMatcher,
+    });
+    const settingsPath = join(args.projectPath, '.claude', 'settings.json');
+    let existing = {};
+    try {
+        const raw = await readFile(settingsPath, 'utf-8');
+        existing = JSON.parse(raw);
+    }
+    catch {
+        // File doesn't exist yet or is not valid JSON — start from empty object
+    }
+    const merged = mergeHookConfig(existing, generated);
+    await writeFile(settingsPath, JSON.stringify(merged, null, 2) + '\n', 'utf-8');
+    return {
+        content: [
+            {
+                type: 'text',
+                text: JSON.stringify({
+                    message: `Hook template '${args.template}' applied`,
+                    settingsPath,
+                    description: generated.description,
+                    mergeInstructions: generated.mergeInstructions,
+                    generatedConfig: generated.hooks,
+                }, null, 2),
+            },
+        ],
+    };
+}
+//# sourceMappingURL=configure.js.map

package/dist/tools/start-hooks/configure.js.map

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

package/dist/tools/start-hooks/engine.d.ts

@@ -0,0 +1,13 @@
+import type { ToolResult } from '../../types/index.js';
+import type { StartHooksInput, StopHooksInput } from '../../types/file-hooks.js';
+import { HookEngine } from '../../engine/hooks/hook-engine.js';
+import { FileWatcher } from '../../engine/hooks/file-watcher.js';
+import { ConfigLoader } from '../../engine/hooks/config-loader.js';
+export declare function getEngineInstance(): HookEngine | null;
+export declare function getWatcherInstance(): FileWatcher | null;
+export declare function getConfigLoaderInstance(): ConfigLoader | null;
+export declare function ensureHooksStarted(projectPath: string): void;
+export declare function handleStartHooks(args: StartHooksInput): Promise<ToolResult>;
+export declare function handleStopHooks(_args: StopHooksInput): Promise<ToolResult>;
+export declare function handleHookStatus(): Promise<ToolResult>;
+//# sourceMappingURL=engine.d.ts.map

package/dist/tools/start-hooks/engine.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"engine.d.ts","sourceRoot":"","sources":["../../../src/tools/start-hooks/engine.ts"],"names":[],"mappings":"AAEA,OAAO,KAAK,EAAE,UAAU,EAAQ,MAAM,sBAAsB,CAAC;AAC7D,OAAO,KAAK,EAGV,eAAe,EACf,cAAc,EAGf,MAAM,2BAA2B,CAAC;AACnC,OAAO,EAAE,UAAU,EAAE,MAAM,mCAAmC,CAAC;AAE/D,OAAO,EAAE,WAAW,EAAE,MAAM,oCAAoC,CAAC;AACjE,OAAO,EAAE,YAAY,EAAE,MAAM,qCAAqC,CAAC;AA0BnE,wBAAgB,iBAAiB,IAAI,UAAU,GAAG,IAAI,CAErD;AAED,wBAAgB,kBAAkB,IAAI,WAAW,GAAG,IAAI,CAEvD;AAED,wBAAgB,uBAAuB,IAAI,YAAY,GAAG,IAAI,CAE7D;AAED,wBAAgB,kBAAkB,CAAC,WAAW,EAAE,MAAM,GAAG,IAAI,CAmB5D;AAMD,wBAAsB,gBAAgB,CAAC,IAAI,EAAE,eAAe,GAAG,OAAO,CAAC,UAAU,CAAC,CAwFjF;AAMD,wBAAsB,eAAe,CAAC,KAAK,EAAE,cAAc,GAAG,OAAO,CAAC,UAAU,CAAC,CAoBhF;AAMD,wBAAsB,gBAAgB,IAAI,OAAO,CAAC,UAAU,CAAC,CAkC5D"}