@planu/cli 0.96.5 → 0.97.0

package/dist/tools/linear-sync-handler.js

@@ -0,0 +1,212 @@
+import { hashProjectPath } from '../storage/base-store.js';
+import { getLinearConfig, saveLinearConfig, removeLinearConfig, getLinearSyncLog, appendLinearSyncEntry, getSyncedLinearIssues, upsertSyncedLinearIssue, } from '../storage/linear-store.js';
+import { LinearClient, mapSpecStatusToLinear } from '../engine/linear-exporter.js';
+import { listSpecs, getSpec } from '../storage/spec-store.js';
+// ---------------------------------------------------------------------------
+// configure_linear
+// ---------------------------------------------------------------------------
+export async function handleConfigureLinear(input) {
+    await saveLinearConfig(input.projectPath, {
+        apiKey: input.apiKey,
+        teamId: input.teamId,
+    });
+    const lines = [
+        'Linear integration configured.',
+        '',
+        '| Field | Value |',
+        '|-------|-------|',
+        `| Team ID | ${input.teamId} |`,
+        `| API Key | ${input.apiKey.slice(0, 8)}... |`,
+        '',
+        'Run `sync_to_linear` to push specs to Linear.',
+    ];
+    return { content: [{ type: 'text', text: lines.join('\n') }] };
+}
+// ---------------------------------------------------------------------------
+// sync_to_linear
+// ---------------------------------------------------------------------------
+export async function handleSyncToLinear(input) {
+    const config = await getLinearConfig(input.projectPath);
+    if (config === null) {
+        return {
+            content: [
+                {
+                    type: 'text',
+                    text: 'Linear is not configured for this project. Run `configure_linear` first.',
+                },
+            ],
+            isError: true,
+        };
+    }
+    const projectId = hashProjectPath(input.projectPath);
+    let specs = await listSpecs(projectId);
+    if (input.specId !== undefined) {
+        const single = await getSpec(projectId, input.specId);
+        if (single === null) {
+            return {
+                content: [
+                    {
+                        type: 'text',
+                        text: `Spec ${input.specId} not found. Check the ID and try again.`,
+                    },
+                ],
+                isError: true,
+            };
+        }
+        specs = [single];
+    }
+    else {
+        specs = specs.filter((s) => s.status === 'approved' || s.status === 'done');
+    }
+    if (specs.length === 0) {
+        return {
+            content: [
+                {
+                    type: 'text',
+                    text: 'No specs to sync. Only approved and done specs are synced automatically.',
+                },
+            ],
+        };
+    }
+    const client = new LinearClient(config);
+    const syncedIssues = await getSyncedLinearIssues(input.projectPath);
+    const result = { created: 0, updated: 0, failed: 0, issues: [] };
+    for (const spec of specs) {
+        try {
+            const existing = syncedIssues[spec.id];
+            if (existing !== undefined && input.mode !== 'pull') {
+                // Push: update status of existing issue
+                const linearStatus = mapSpecStatusToLinear(spec.status);
+                await client.updateIssueStatus(existing.issueId, linearStatus);
+                const issueRef = {
+                    specId: spec.id,
+                    issueId: existing.issueId,
+                    issueUrl: existing.issueUrl,
+                    title: `${spec.id}: ${spec.title}`,
+                };
+                result.issues.push(issueRef);
+                result.updated++;
+            }
+            else if (existing === undefined && input.mode !== 'pull') {
+                // Push: create new issue
+                const issueRef = await client.createProject(spec);
+                result.issues.push(issueRef);
+                result.created++;
+                await upsertSyncedLinearIssue(input.projectPath, {
+                    specId: spec.id,
+                    issueId: issueRef.issueId,
+                    issueUrl: issueRef.issueUrl,
+                    lastSyncedAt: new Date().toISOString(),
+                });
+            }
+            else if (input.mode === 'pull' && existing !== undefined) {
+                // Pull mode: report existing issue (status sync from Linear → Planu is informational)
+                const issueRef = {
+                    specId: spec.id,
+                    issueId: existing.issueId,
+                    issueUrl: existing.issueUrl,
+                    title: `${spec.id}: ${spec.title}`,
+                };
+                result.issues.push(issueRef);
+                result.updated++;
+            }
+        }
+        catch (err) {
+            result.failed++;
+            const msg = err instanceof Error ? err.message : String(err);
+            result.issues.push({
+                specId: spec.id,
+                issueId: '',
+                issueUrl: '',
+                title: `${spec.id} (FAILED: ${msg})`,
+            });
+        }
+    }
+    await appendLinearSyncEntry(input.projectPath, {
+        syncedAt: new Date().toISOString(),
+        mode: input.mode,
+        result,
+    });
+    const lines = [
+        `Linear sync complete (${input.mode}): ${result.created} created, ${result.updated} updated, ${result.failed} failed.`,
+        '',
+    ];
+    for (const issue of result.issues) {
+        if (issue.issueUrl !== '') {
+            lines.push(`- [${issue.specId}] ${issue.title} — ${issue.issueUrl}`);
+        }
+        else {
+            lines.push(`- [${issue.specId}] ${issue.title}`);
+        }
+    }
+    return {
+        content: [{ type: 'text', text: lines.join('\n') }],
+        isError: result.failed > 0 && result.created === 0 && result.updated === 0,
+    };
+}
+// ---------------------------------------------------------------------------
+// linear_status
+// ---------------------------------------------------------------------------
+export async function handleLinearStatus(input) {
+    const config = await getLinearConfig(input.projectPath);
+    if (config === null) {
+        return {
+            content: [
+                {
+                    type: 'text',
+                    text: 'Linear is not configured for this project. Run `configure_linear` to set it up.',
+                },
+            ],
+        };
+    }
+    const log = await getLinearSyncLog(input.projectPath);
+    const syncedIssues = await getSyncedLinearIssues(input.projectPath);
+    const issueCount = Object.keys(syncedIssues).length;
+    const lastEntry = log[log.length - 1];
+    const lastSync = lastEntry !== undefined ? lastEntry.syncedAt : 'never';
+    const lines = [
+        'Linear integration is active.',
+        '',
+        '| Field | Value |',
+        '|-------|-------|',
+        `| Team ID | ${config.teamId} |`,
+        `| API Key | ${config.apiKey.slice(0, 8)}... |`,
+        `| Synced Issues | ${issueCount} |`,
+        `| Last Sync | ${lastSync} |`,
+    ];
+    if (log.length > 0) {
+        lines.push('', '**Recent sync history:**', '');
+        const recent = log.slice(-5).reverse();
+        for (const entry of recent) {
+            const { result } = entry;
+            lines.push(`- ${entry.syncedAt.slice(0, 19)} [${entry.mode}] — created: ${result.created}, updated: ${result.updated}, failed: ${result.failed}`);
+        }
+    }
+    return { content: [{ type: 'text', text: lines.join('\n') }] };
+}
+// ---------------------------------------------------------------------------
+// remove_linear (convenience — exposed via register-spec-317.ts)
+// ---------------------------------------------------------------------------
+export async function handleRemoveLinear(input) {
+    const config = await getLinearConfig(input.projectPath);
+    if (config === null) {
+        return {
+            content: [
+                {
+                    type: 'text',
+                    text: 'Linear is not configured for this project. Nothing to remove.',
+                },
+            ],
+        };
+    }
+    await removeLinearConfig(input.projectPath);
+    return {
+        content: [
+            {
+                type: 'text',
+                text: 'Linear configuration removed. Synced issue records and logs are preserved.',
+            },
+        ],
+    };
+}
+//# sourceMappingURL=linear-sync-handler.js.map

package/dist/tools/linear-sync-handler.js.map

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

package/dist/tools/register-export-tools.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"register-export-tools.d.ts","sourceRoot":"","sources":["../../src/tools/register-export-tools.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,yCAAyC,CAAC;AAKzE,wBAAgB,mBAAmB,CAAC,MAAM,EAAE,SAAS,GAAG,IAAI,CAsB3D"}
+{"version":3,"file":"register-export-tools.d.ts","sourceRoot":"","sources":["../../src/tools/register-export-tools.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,yCAAyC,CAAC;AAKzE,wBAAgB,mBAAmB,CAAC,MAAM,EAAE,SAAS,GAAG,IAAI,CA+B3D"}

package/dist/tools/register-export-tools.js

@@ -3,19 +3,26 @@ import { handleExportSpec } from './export-spec.js';
 import { safeLicensed } from './safe-handler.js';
 export function registerExportTools(server) {
     server.registerTool('export_spec', {
-        description: 'Export a spec to an external format. Currently supports spec-kit format ' +
-            '(GitHub spec-kit compatible: spec.md, plan.md, tasks.md). ' +
+        description: 'Export a spec to an external format. Supports spec-kit format ' +
+            '(GitHub spec-kit compatible: spec.md, plan.md, tasks.md) and agent-ready format ' +
+            '(structured JSON optimized for autonomous coding agents: Devin, Kiro, SWE-agent, generic). ' +
             'Writes files to .specify/specs/{slug}/ by default.',
         annotations: { readOnlyHint: false },
         inputSchema: {
             specId: z.string().min(1).max(500).describe('Spec ID to export (e.g. "SPEC-001")'),
             projectPath: z.string().min(1).max(2000).describe('Absolute path to the project root'),
-            format: z.enum(['spec-kit']).describe('Export format. Valid values: spec-kit'),
+            format: z
+                .enum(['spec-kit', 'agent-ready'])
+                .describe('Export format. Valid values: spec-kit, agent-ready'),
             outputDir: z
                 .string()
                 .max(2000)
                 .optional()
                 .describe('Custom output directory (default: .specify/specs/{slug}/ inside projectPath)'),
+            agentTarget: z
+                .enum(['devin', 'kiro', 'swe-agent', 'generic'])
+                .optional()
+                .describe('Target agent for agent-ready format. Valid values: devin, kiro, swe-agent, generic. Defaults to generic. Only used when format is agent-ready.'),
         },
     }, safeLicensed('export_spec', async (args) => handleExportSpec(args)));
 }

package/dist/tools/register-export-tools.js.map

@@ -1 +1 @@
-{"version":3,"file":"register-export-tools.js","sourceRoot":"","sources":["../../src/tools/register-export-tools.ts"],"names":[],"mappings":"AAEA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AACxB,OAAO,EAAE,gBAAgB,EAAE,MAAM,kBAAkB,CAAC;AACpD,OAAO,EAAE,YAAY,EAAE,MAAM,mBAAmB,CAAC;AAEjD,MAAM,UAAU,mBAAmB,CAAC,MAAiB;IACnD,MAAM,CAAC,YAAY,CACjB,aAAa,EACb;QACE,WAAW,EACT,0EAA0E;YAC1E,4DAA4D;YAC5D,oDAAoD;QACtD,WAAW,EAAE,EAAE,YAAY,EAAE,KAAK,EAAE;QACpC,WAAW,EAAE;YACX,MAAM,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,GAAG,CAAC,GAAG,CAAC,CAAC,QAAQ,CAAC,qCAAqC,CAAC;YAClF,WAAW,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,GAAG,CAAC,IAAI,CAAC,CAAC,QAAQ,CAAC,mCAAmC,CAAC;YACtF,MAAM,EAAE,CAAC,CAAC,IAAI,CAAC,CAAC,UAAU,CAAC,CAAC,CAAC,QAAQ,CAAC,uCAAuC,CAAC;YAC9E,SAAS,EAAE,CAAC;iBACT,MAAM,EAAE;iBACR,GAAG,CAAC,IAAI,CAAC;iBACT,QAAQ,EAAE;iBACV,QAAQ,CAAC,8EAA8E,CAAC;SAC5F;KACF,EACD,YAAY,CAAC,aAAa,EAAE,KAAK,EAAE,IAAI,EAAE,EAAE,CAAC,gBAAgB,CAAC,IAAI,CAAC,CAAC,CACpE,CAAC;AACJ,CAAC"}
+{"version":3,"file":"register-export-tools.js","sourceRoot":"","sources":["../../src/tools/register-export-tools.ts"],"names":[],"mappings":"AAEA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AACxB,OAAO,EAAE,gBAAgB,EAAE,MAAM,kBAAkB,CAAC;AACpD,OAAO,EAAE,YAAY,EAAE,MAAM,mBAAmB,CAAC;AAEjD,MAAM,UAAU,mBAAmB,CAAC,MAAiB;IACnD,MAAM,CAAC,YAAY,CACjB,aAAa,EACb;QACE,WAAW,EACT,gEAAgE;YAChE,kFAAkF;YAClF,6FAA6F;YAC7F,oDAAoD;QACtD,WAAW,EAAE,EAAE,YAAY,EAAE,KAAK,EAAE;QACpC,WAAW,EAAE;YACX,MAAM,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,GAAG,CAAC,GAAG,CAAC,CAAC,QAAQ,CAAC,qCAAqC,CAAC;YAClF,WAAW,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,GAAG,CAAC,IAAI,CAAC,CAAC,QAAQ,CAAC,mCAAmC,CAAC;YACtF,MAAM,EAAE,CAAC;iBACN,IAAI,CAAC,CAAC,UAAU,EAAE,aAAa,CAAC,CAAC;iBACjC,QAAQ,CAAC,oDAAoD,CAAC;YACjE,SAAS,EAAE,CAAC;iBACT,MAAM,EAAE;iBACR,GAAG,CAAC,IAAI,CAAC;iBACT,QAAQ,EAAE;iBACV,QAAQ,CAAC,8EAA8E,CAAC;YAC3F,WAAW,EAAE,CAAC;iBACX,IAAI,CAAC,CAAC,OAAO,EAAE,MAAM,EAAE,WAAW,EAAE,SAAS,CAAC,CAAC;iBAC/C,QAAQ,EAAE;iBACV,QAAQ,CACP,gJAAgJ,CACjJ;SACJ;KACF,EACD,YAAY,CAAC,aAAa,EAAE,KAAK,EAAE,IAAI,EAAE,EAAE,CAAC,gBAAgB,CAAC,IAAI,CAAC,CAAC,CACpE,CAAC;AACJ,CAAC"}

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

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

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

@@ -0,0 +1 @@
+{"version":3,"file":"register-spec-314.d.ts","sourceRoot":"","sources":["../../src/tools/register-spec-314.ts"],"names":[],"mappings":"AAEA,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,yCAAyC,CAAC;AAKzE,wBAAgB,6BAA6B,CAAC,MAAM,EAAE,SAAS,GAAG,IAAI,CA0CrE"}

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

@@ -0,0 +1,38 @@
+// tools/register-spec-314.ts — Registers SPEC-314 quality score tool
+import { z } from 'zod';
+import { safeTracked } from './safe-handler.js';
+import { handleSpecQualityScore } from './spec-quality-score-handler.js';
+export function registerSpecQualityScoreTools(server) {
+    // -------------------------------------------------------------------------
+    // spec_quality_score — compute 0-100 quality score with 4 dimensions
+    // -------------------------------------------------------------------------
+    server.registerTool('spec_quality_score', {
+        description: 'Compute a 0-100 quality score for a spec across 4 dimensions: ' +
+            'completeness (title, description, AC, scope, estimation), ' +
+            'testability (verifiable AC, no vague words), ' +
+            'ambiguity (no contradictions, terms defined, edge cases covered), ' +
+            'and risk (cross-module deps, architectural scope, NFRs present). ' +
+            'Returns a letter grade (A-F) and actionable recommendations.',
+        inputSchema: {
+            specId: z
+                .string()
+                .min(1)
+                .max(500)
+                .describe('Spec ID to evaluate (e.g. SPEC-042).'),
+            projectPath: z
+                .string()
+                .min(1)
+                .max(4096)
+                .optional()
+                .describe('Absolute path to the project root (preferred over projectId).'),
+            projectId: z
+                .string()
+                .min(1)
+                .max(500)
+                .optional()
+                .describe('Project hash ID (use projectPath instead when possible).'),
+        },
+        annotations: { title: 'Spec Quality Score', readOnlyHint: true },
+    }, safeTracked('spec_quality_score', (args) => handleSpecQualityScore(args)));
+}
+//# sourceMappingURL=register-spec-314.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"register-spec-314.js","sourceRoot":"","sources":["../../src/tools/register-spec-314.ts"],"names":[],"mappings":"AAAA,qEAAqE;AAGrE,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AACxB,OAAO,EAAE,WAAW,EAAE,MAAM,mBAAmB,CAAC;AAChD,OAAO,EAAE,sBAAsB,EAAE,MAAM,iCAAiC,CAAC;AAEzE,MAAM,UAAU,6BAA6B,CAAC,MAAiB;IAC7D,4EAA4E;IAC5E,qEAAqE;IACrE,4EAA4E;IAE5E,MAAM,CAAC,YAAY,CACjB,oBAAoB,EACpB;QACE,WAAW,EACT,gEAAgE;YAChE,4DAA4D;YAC5D,+CAA+C;YAC/C,oEAAoE;YACpE,mEAAmE;YACnE,8DAA8D;QAChE,WAAW,EAAE;YACX,MAAM,EAAE,CAAC;iBACN,MAAM,EAAE;iBACR,GAAG,CAAC,CAAC,CAAC;iBACN,GAAG,CAAC,GAAG,CAAC;iBACR,QAAQ,CAAC,sCAAsC,CAAC;YACnD,WAAW,EAAE,CAAC;iBACX,MAAM,EAAE;iBACR,GAAG,CAAC,CAAC,CAAC;iBACN,GAAG,CAAC,IAAI,CAAC;iBACT,QAAQ,EAAE;iBACV,QAAQ,CAAC,+DAA+D,CAAC;YAC5E,SAAS,EAAE,CAAC;iBACT,MAAM,EAAE;iBACR,GAAG,CAAC,CAAC,CAAC;iBACN,GAAG,CAAC,GAAG,CAAC;iBACR,QAAQ,EAAE;iBACV,QAAQ,CAAC,0DAA0D,CAAC;SACxE;QACD,WAAW,EAAE,EAAE,KAAK,EAAE,oBAAoB,EAAE,YAAY,EAAE,IAAI,EAAE;KACjE,EACD,WAAW,CAAC,oBAAoB,EAAE,CAAC,IAAI,EAAE,EAAE,CACzC,sBAAsB,CACpB,IAAoE,CACrE,CACF,CACF,CAAC;AACJ,CAAC"}

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

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

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

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

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

@@ -0,0 +1,71 @@
+// tools/register-spec-316.ts — Registers eval_skill and eval_rule tools (SPEC-316)
+import { z } from 'zod';
+import { safeTracked } from './safe-handler.js';
+import { handleEvalSkill, handleEvalRule } from './eval-skill-handler.js';
+const evalScenarioSchema = z.object({
+    input: z.string().min(1).max(2000).describe('Natural language description of the user input or trigger for this scenario.'),
+    expectedOutput: z
+        .string()
+        .min(1)
+        .max(4000)
+        .describe('The expected text fragment or output that the skill/rule should produce or reference.'),
+    criteria: z
+        .array(z.string().min(1).max(500))
+        .min(1)
+        .describe('List of keyword or phrase criteria that must appear in the skill/rule content to pass this scenario.'),
+});
+export function registerEvalSkillTools(server) {
+    // -------------------------------------------------------------------------
+    // eval_skill — evaluate a skill file against test scenarios
+    // -------------------------------------------------------------------------
+    server.registerTool('eval_skill', {
+        description: 'Evaluate the quality of a Claude skill file against a set of test scenarios. ' +
+            'Reads the skill from .claude/skills/{skillName}.md and checks whether each scenario\'s ' +
+            'criteria appear in the skill content. ' +
+            'Returns a pass rate, average score, per-scenario results, and recommendations for improvement.',
+        inputSchema: {
+            skillName: z
+                .string()
+                .min(1)
+                .max(500)
+                .describe('Skill file name without extension (e.g. "vitest") or with extension (e.g. "vitest.md").'),
+            projectPath: z
+                .string()
+                .min(1)
+                .max(4096)
+                .describe('Absolute path to the project root. Skills are read from {projectPath}/.claude/skills/.'),
+            testScenarios: z
+                .array(evalScenarioSchema)
+                .min(1)
+                .describe('One or more test scenarios to evaluate the skill against.'),
+        },
+        annotations: { title: 'Evaluate Skill Quality', readOnlyHint: true },
+    }, safeTracked('eval_skill', (args) => handleEvalSkill(args)));
+    // -------------------------------------------------------------------------
+    // eval_rule — evaluate a rule file against test scenarios
+    // -------------------------------------------------------------------------
+    server.registerTool('eval_rule', {
+        description: 'Evaluate the quality of a Claude rule file against a set of test scenarios. ' +
+            'Reads the rule from .claude/rules/{ruleName}.md and checks whether each scenario\'s ' +
+            'criteria appear in the rule content. ' +
+            'Returns a pass rate, average score, per-scenario results, and recommendations for improvement.',
+        inputSchema: {
+            ruleName: z
+                .string()
+                .min(1)
+                .max(500)
+                .describe('Rule file name without extension (e.g. "testing") or with extension (e.g. "testing.md").'),
+            projectPath: z
+                .string()
+                .min(1)
+                .max(4096)
+                .describe('Absolute path to the project root. Rules are read from {projectPath}/.claude/rules/.'),
+            testScenarios: z
+                .array(evalScenarioSchema)
+                .min(1)
+                .describe('One or more test scenarios to evaluate the rule against.'),
+        },
+        annotations: { title: 'Evaluate Rule Quality', readOnlyHint: true },
+    }, safeTracked('eval_rule', (args) => handleEvalRule(args)));
+}
+//# sourceMappingURL=register-spec-316.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"register-spec-316.js","sourceRoot":"","sources":["../../src/tools/register-spec-316.ts"],"names":[],"mappings":"AAAA,mFAAmF;AAGnF,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AACxB,OAAO,EAAE,WAAW,EAAE,MAAM,mBAAmB,CAAC;AAChD,OAAO,EAAE,eAAe,EAAE,cAAc,EAAE,MAAM,yBAAyB,CAAC;AAG1E,MAAM,kBAAkB,GAAG,CAAC,CAAC,MAAM,CAAC;IAClC,KAAK,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,GAAG,CAAC,IAAI,CAAC,CAAC,QAAQ,CAAC,8EAA8E,CAAC;IAC3H,cAAc,EAAE,CAAC;SACd,MAAM,EAAE;SACR,GAAG,CAAC,CAAC,CAAC;SACN,GAAG,CAAC,IAAI,CAAC;SACT,QAAQ,CAAC,uFAAuF,CAAC;IACpG,QAAQ,EAAE,CAAC;SACR,KAAK,CAAC,CAAC,CAAC,MAAM,EAAE,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,GAAG,CAAC,GAAG,CAAC,CAAC;SACjC,GAAG,CAAC,CAAC,CAAC;SACN,QAAQ,CAAC,sGAAsG,CAAC;CACpH,CAAC,CAAC;AAEH,MAAM,UAAU,sBAAsB,CAAC,MAAiB;IACtD,4EAA4E;IAC5E,4DAA4D;IAC5D,4EAA4E;IAE5E,MAAM,CAAC,YAAY,CACjB,YAAY,EACZ;QACE,WAAW,EACT,+EAA+E;YAC/E,yFAAyF;YACzF,wCAAwC;YACxC,gGAAgG;QAClG,WAAW,EAAE;YACX,SAAS,EAAE,CAAC;iBACT,MAAM,EAAE;iBACR,GAAG,CAAC,CAAC,CAAC;iBACN,GAAG,CAAC,GAAG,CAAC;iBACR,QAAQ,CAAC,yFAAyF,CAAC;YACtG,WAAW,EAAE,CAAC;iBACX,MAAM,EAAE;iBACR,GAAG,CAAC,CAAC,CAAC;iBACN,GAAG,CAAC,IAAI,CAAC;iBACT,QAAQ,CAAC,wFAAwF,CAAC;YACrG,aAAa,EAAE,CAAC;iBACb,KAAK,CAAC,kBAAkB,CAAC;iBACzB,GAAG,CAAC,CAAC,CAAC;iBACN,QAAQ,CAAC,2DAA2D,CAAC;SACzE;QACD,WAAW,EAAE,EAAE,KAAK,EAAE,wBAAwB,EAAE,YAAY,EAAE,IAAI,EAAE;KACrE,EACD,WAAW,CAAC,YAAY,EAAE,CAAC,IAAI,EAAE,EAAE,CAAC,eAAe,CAAC,IAAsB,CAAC,CAAC,CAC7E,CAAC;IAEF,4EAA4E;IAC5E,0DAA0D;IAC1D,4EAA4E;IAE5E,MAAM,CAAC,YAAY,CACjB,WAAW,EACX;QACE,WAAW,EACT,8EAA8E;YAC9E,sFAAsF;YACtF,uCAAuC;YACvC,gGAAgG;QAClG,WAAW,EAAE;YACX,QAAQ,EAAE,CAAC;iBACR,MAAM,EAAE;iBACR,GAAG,CAAC,CAAC,CAAC;iBACN,GAAG,CAAC,GAAG,CAAC;iBACR,QAAQ,CAAC,0FAA0F,CAAC;YACvG,WAAW,EAAE,CAAC;iBACX,MAAM,EAAE;iBACR,GAAG,CAAC,CAAC,CAAC;iBACN,GAAG,CAAC,IAAI,CAAC;iBACT,QAAQ,CAAC,sFAAsF,CAAC;YACnG,aAAa,EAAE,CAAC;iBACb,KAAK,CAAC,kBAAkB,CAAC;iBACzB,GAAG,CAAC,CAAC,CAAC;iBACN,QAAQ,CAAC,0DAA0D,CAAC;SACxE;QACD,WAAW,EAAE,EAAE,KAAK,EAAE,uBAAuB,EAAE,YAAY,EAAE,IAAI,EAAE;KACpE,EACD,WAAW,CAAC,WAAW,EAAE,CAAC,IAAI,EAAE,EAAE,CAAC,cAAc,CAAC,IAAqB,CAAC,CAAC,CAC1E,CAAC;AACJ,CAAC"}

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

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

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

@@ -0,0 +1 @@
+{"version":3,"file":"register-spec-317.d.ts","sourceRoot":"","sources":["../../src/tools/register-spec-317.ts"],"names":[],"mappings":"AAEA,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,yCAAyC,CAAC;AA+CzE,wBAAgB,uBAAuB,CAAC,MAAM,EAAE,SAAS,GAAG,IAAI,CAmM/D"}

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

@@ -0,0 +1,158 @@
+// tools/register-spec-317.ts — Registers Jira and Linear bidirectional sync tools (SPEC-317)
+import { z } from 'zod';
+import { safeTracked } from './safe-handler.js';
+import { handleConfigureJira, handleSyncToJira, handleJiraStatus, handleRemoveJira, } from './jira-sync-handler.js';
+import { handleConfigureLinear, handleSyncToLinear, handleLinearStatus, handleRemoveLinear, } from './linear-sync-handler.js';
+const syncModeSchema = z
+    .enum(['push', 'pull', 'bidirectional'])
+    .describe('Sync direction. ' +
+    '"push" sends Planu spec data to the external tool. ' +
+    '"pull" reads status from the external tool (informational). ' +
+    '"bidirectional" performs push then pull.');
+const projectPathSchema = z
+    .string()
+    .min(1)
+    .max(4096)
+    .describe('Absolute path to the project root where Planu stores its data.');
+const specIdSchema = z
+    .string()
+    .min(1)
+    .max(50)
+    .optional()
+    .describe('Optional SPEC-XXX identifier. Omit to sync all approved and done specs.');
+export function registerJiraLinearTools(server) {
+    // ---------------------------------------------------------------------------
+    // configure_jira
+    // ---------------------------------------------------------------------------
+    server.registerTool('configure_jira', {
+        description: 'Configure Jira Cloud integration for a project. ' +
+            'Credentials are stored locally and used by sync_to_jira. ' +
+            'Requires a Jira Cloud domain, project key, email, and API token. ' +
+            'Get your API token at: https://id.atlassian.com/manage-profile/security/api-tokens',
+        inputSchema: {
+            projectPath: projectPathSchema,
+            domain: z
+                .string()
+                .min(1)
+                .max(253)
+                .describe('Jira Cloud domain without suffix, e.g. "mycompany" for mycompany.atlassian.net.'),
+            email: z
+                .string()
+                .min(5)
+                .max(254)
+                .describe('Email address associated with the Atlassian API token.'),
+            apiToken: z
+                .string()
+                .min(1)
+                .max(500)
+                .describe('Atlassian API token. Generate at id.atlassian.com/manage-profile/security/api-tokens.'),
+            projectKey: z
+                .string()
+                .min(1)
+                .max(20)
+                .describe('Jira project key where epics and stories will be created, e.g. "ENG" or "PLAT".'),
+        },
+        annotations: { title: 'Configure Jira Integration' },
+    }, safeTracked('configure_jira', (args) => handleConfigureJira(args)));
+    // ---------------------------------------------------------------------------
+    // sync_to_jira
+    // ---------------------------------------------------------------------------
+    server.registerTool('sync_to_jira', {
+        description: 'Sync Planu specs to Jira Cloud as Epics. ' +
+            'By default syncs all approved and done specs. ' +
+            'Supports push (Planu → Jira), pull (Jira → Planu informational), and bidirectional modes. ' +
+            'Run configure_jira first.',
+        inputSchema: {
+            projectPath: projectPathSchema,
+            specId: specIdSchema,
+            mode: syncModeSchema,
+        },
+        annotations: { title: 'Sync Specs to Jira' },
+    }, safeTracked('sync_to_jira', (args) => handleSyncToJira(args)));
+    // ---------------------------------------------------------------------------
+    // jira_status
+    // ---------------------------------------------------------------------------
+    server.registerTool('jira_status', {
+        description: 'Show the current Jira integration status for a project: configuration, ' +
+            'number of synced issues, and recent sync history.',
+        inputSchema: {
+            projectPath: projectPathSchema,
+        },
+        annotations: { title: 'Jira Integration Status', readOnlyHint: true },
+    }, safeTracked('jira_status', (args) => handleJiraStatus(args)));
+    // ---------------------------------------------------------------------------
+    // remove_jira
+    // ---------------------------------------------------------------------------
+    server.registerTool('remove_jira', {
+        description: 'Remove the Jira integration configuration for a project. ' +
+            'Synced issue records and logs are preserved for reference. ' +
+            'Run configure_jira to re-enable the integration.',
+        inputSchema: {
+            projectPath: projectPathSchema,
+        },
+        annotations: { title: 'Remove Jira Integration', destructiveHint: true },
+    }, safeTracked('remove_jira', (args) => handleRemoveJira(args)));
+    // ---------------------------------------------------------------------------
+    // configure_linear
+    // ---------------------------------------------------------------------------
+    server.registerTool('configure_linear', {
+        description: 'Configure Linear integration for a project. ' +
+            'Credentials are stored locally and used by sync_to_linear. ' +
+            'Requires a Linear personal API key and team ID. ' +
+            'Get your API key at: https://linear.app/settings/api',
+        inputSchema: {
+            projectPath: projectPathSchema,
+            apiKey: z
+                .string()
+                .min(1)
+                .max(500)
+                .describe('Linear personal API key. Generate at https://linear.app/settings/api.'),
+            teamId: z
+                .string()
+                .min(1)
+                .max(100)
+                .describe('Linear team ID (UUID) where issues will be created. ' +
+                'Find it in Linear Settings → Team → General.'),
+        },
+        annotations: { title: 'Configure Linear Integration' },
+    }, safeTracked('configure_linear', (args) => handleConfigureLinear(args)));
+    // ---------------------------------------------------------------------------
+    // sync_to_linear
+    // ---------------------------------------------------------------------------
+    server.registerTool('sync_to_linear', {
+        description: 'Sync Planu specs to Linear as issues. ' +
+            'By default syncs all approved and done specs. ' +
+            'Supports push (Planu → Linear), pull (Linear → Planu informational), and bidirectional modes. ' +
+            'Run configure_linear first.',
+        inputSchema: {
+            projectPath: projectPathSchema,
+            specId: specIdSchema,
+            mode: syncModeSchema,
+        },
+        annotations: { title: 'Sync Specs to Linear' },
+    }, safeTracked('sync_to_linear', (args) => handleSyncToLinear(args)));
+    // ---------------------------------------------------------------------------
+    // linear_status
+    // ---------------------------------------------------------------------------
+    server.registerTool('linear_status', {
+        description: 'Show the current Linear integration status for a project: configuration, ' +
+            'number of synced issues, and recent sync history.',
+        inputSchema: {
+            projectPath: projectPathSchema,
+        },
+        annotations: { title: 'Linear Integration Status', readOnlyHint: true },
+    }, safeTracked('linear_status', (args) => handleLinearStatus(args)));
+    // ---------------------------------------------------------------------------
+    // remove_linear
+    // ---------------------------------------------------------------------------
+    server.registerTool('remove_linear', {
+        description: 'Remove the Linear integration configuration for a project. ' +
+            'Synced issue records and logs are preserved for reference. ' +
+            'Run configure_linear to re-enable the integration.',
+        inputSchema: {
+            projectPath: projectPathSchema,
+        },
+        annotations: { title: 'Remove Linear Integration', destructiveHint: true },
+    }, safeTracked('remove_linear', (args) => handleRemoveLinear(args)));
+}
+//# sourceMappingURL=register-spec-317.js.map

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

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

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

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

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

@@ -0,0 +1 @@
+{"version":3,"file":"register-spec-319.d.ts","sourceRoot":"","sources":["../../src/tools/register-spec-319.ts"],"names":[],"mappings":"AAEA,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,yCAAyC,CAAC;AAczE,wBAAgB,uBAAuB,CAAC,MAAM,EAAE,SAAS,GAAG,IAAI,CAsE/D"}