@planu/cli 0.91.0 → 0.93.0

package/dist/engine/ai-integration/kiro/spec-exporter.js

@@ -0,0 +1,57 @@
+// engine/ai-integration/kiro/spec-exporter.ts — Kiro spec exporter (SPEC-270)
+import { writeFileSync, mkdirSync, existsSync } from 'node:fs';
+import { join } from 'node:path';
+function buildUserStories(spec) {
+    if (spec.acceptanceCriteria.length === 0) {
+        return [
+            {
+                id: 'US-001',
+                description: spec.description,
+                acceptanceCriteria: [],
+            },
+        ];
+    }
+    return spec.acceptanceCriteria.map((criterion, index) => ({
+        id: `US-${String(index + 1).padStart(3, '0')}`,
+        description: criterion,
+        acceptanceCriteria: [criterion],
+    }));
+}
+function buildTasks(spec) {
+    if (spec.acceptanceCriteria.length === 0) {
+        return [
+            {
+                id: 'T-001',
+                description: `Implement: ${spec.title}`,
+                status: 'pending',
+            },
+        ];
+    }
+    return spec.acceptanceCriteria.map((criterion, index) => ({
+        id: `T-${String(index + 1).padStart(3, '0')}`,
+        description: `Implement: ${criterion}`,
+        status: 'pending',
+    }));
+}
+/** Converts a Planu spec to Kiro format */
+export function exportSpecToKiro(spec) {
+    return {
+        id: spec.id,
+        title: spec.title,
+        status: 'approved',
+        userStories: buildUserStories(spec),
+        tasks: buildTasks(spec),
+    };
+}
+/** Writes a Kiro spec JSON to .kiro/specs/<id>.json */
+export function writeKiroSpec(projectPath, kiroSpec) {
+    const specsDir = join(projectPath, '.kiro', 'specs');
+    /* v8 ignore start */
+    if (!existsSync(specsDir)) {
+        mkdirSync(specsDir, { recursive: true });
+    }
+    /* v8 ignore stop */
+    const content = JSON.stringify(kiroSpec, null, 2);
+    writeFileSync(join(specsDir, `${kiroSpec.id}.json`), content + '\n', 'utf8');
+}
+//# sourceMappingURL=spec-exporter.js.map

package/dist/engine/ai-integration/kiro/spec-exporter.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"spec-exporter.js","sourceRoot":"","sources":["../../../../src/engine/ai-integration/kiro/spec-exporter.ts"],"names":[],"mappings":"AAAA,8EAA8E;AAE9E,OAAO,EAAE,aAAa,EAAE,SAAS,EAAE,UAAU,EAAE,MAAM,SAAS,CAAC;AAC/D,OAAO,EAAE,IAAI,EAAE,MAAM,WAAW,CAAC;AAGjC,SAAS,gBAAgB,CAAC,IAAe;IACvC,IAAI,IAAI,CAAC,kBAAkB,CAAC,MAAM,KAAK,CAAC,EAAE,CAAC;QACzC,OAAO;YACL;gBACE,EAAE,EAAE,QAAQ;gBACZ,WAAW,EAAE,IAAI,CAAC,WAAW;gBAC7B,kBAAkB,EAAE,EAAE;aACvB;SACF,CAAC;IACJ,CAAC;IAED,OAAO,IAAI,CAAC,kBAAkB,CAAC,GAAG,CAAC,CAAC,SAAS,EAAE,KAAK,EAAE,EAAE,CAAC,CAAC;QACxD,EAAE,EAAE,MAAM,MAAM,CAAC,KAAK,GAAG,CAAC,CAAC,CAAC,QAAQ,CAAC,CAAC,EAAE,GAAG,CAAC,EAAE;QAC9C,WAAW,EAAE,SAAS;QACtB,kBAAkB,EAAE,CAAC,SAAS,CAAC;KAChC,CAAC,CAAC,CAAC;AACN,CAAC;AAED,SAAS,UAAU,CAAC,IAAe;IACjC,IAAI,IAAI,CAAC,kBAAkB,CAAC,MAAM,KAAK,CAAC,EAAE,CAAC;QACzC,OAAO;YACL;gBACE,EAAE,EAAE,OAAO;gBACX,WAAW,EAAE,cAAc,IAAI,CAAC,KAAK,EAAE;gBACvC,MAAM,EAAE,SAAS;aAClB;SACF,CAAC;IACJ,CAAC;IAED,OAAO,IAAI,CAAC,kBAAkB,CAAC,GAAG,CAAC,CAAC,SAAS,EAAE,KAAK,EAAE,EAAE,CAAC,CAAC;QACxD,EAAE,EAAE,KAAK,MAAM,CAAC,KAAK,GAAG,CAAC,CAAC,CAAC,QAAQ,CAAC,CAAC,EAAE,GAAG,CAAC,EAAE;QAC7C,WAAW,EAAE,cAAc,SAAS,EAAE;QACtC,MAAM,EAAE,SAAkB;KAC3B,CAAC,CAAC,CAAC;AACN,CAAC;AAED,2CAA2C;AAC3C,MAAM,UAAU,gBAAgB,CAAC,IAAe;IAC9C,OAAO;QACL,EAAE,EAAE,IAAI,CAAC,EAAE;QACX,KAAK,EAAE,IAAI,CAAC,KAAK;QACjB,MAAM,EAAE,UAAU;QAClB,WAAW,EAAE,gBAAgB,CAAC,IAAI,CAAC;QACnC,KAAK,EAAE,UAAU,CAAC,IAAI,CAAC;KACxB,CAAC;AACJ,CAAC;AAED,uDAAuD;AACvD,MAAM,UAAU,aAAa,CAAC,WAAmB,EAAE,QAAwB;IACzE,MAAM,QAAQ,GAAG,IAAI,CAAC,WAAW,EAAE,OAAO,EAAE,OAAO,CAAC,CAAC;IAErD,qBAAqB;IACrB,IAAI,CAAC,UAAU,CAAC,QAAQ,CAAC,EAAE,CAAC;QAC1B,SAAS,CAAC,QAAQ,EAAE,EAAE,SAAS,EAAE,IAAI,EAAE,CAAC,CAAC;IAC3C,CAAC;IACD,oBAAoB;IAEpB,MAAM,OAAO,GAAG,IAAI,CAAC,SAAS,CAAC,QAAQ,EAAE,IAAI,EAAE,CAAC,CAAC,CAAC;IAClD,aAAa,CAAC,IAAI,CAAC,QAAQ,EAAE,GAAG,QAAQ,CAAC,EAAE,OAAO,CAAC,EAAE,OAAO,GAAG,IAAI,EAAE,MAAM,CAAC,CAAC;AAC/E,CAAC"}

package/dist/engine/ai-integration/kiro/steering-generator.d.ts

@@ -0,0 +1,6 @@
+import type { KiroSteeringOptions } from '../../../types/kiro-integration.js';
+/** Generates the content for .kiro/steering/planu-sdd.md */
+export declare function generateKiroSteering(options: KiroSteeringOptions): string;
+/** Writes .kiro/steering/planu-sdd.md to the given project path */
+export declare function writeKiroSteering(projectPath: string, options: KiroSteeringOptions): void;
+//# sourceMappingURL=steering-generator.d.ts.map

package/dist/engine/ai-integration/kiro/steering-generator.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"steering-generator.d.ts","sourceRoot":"","sources":["../../../../src/engine/ai-integration/kiro/steering-generator.ts"],"names":[],"mappings":"AAIA,OAAO,KAAK,EAAE,mBAAmB,EAAE,MAAM,oCAAoC,CAAC;AAsD9E,4DAA4D;AAC5D,wBAAgB,oBAAoB,CAAC,OAAO,EAAE,mBAAmB,GAAG,MAAM,CA4CzE;AAED,mEAAmE;AACnE,wBAAgB,iBAAiB,CAAC,WAAW,EAAE,MAAM,EAAE,OAAO,EAAE,mBAAmB,GAAG,IAAI,CAWzF"}

package/dist/engine/ai-integration/kiro/steering-generator.js

@@ -0,0 +1,112 @@
+// engine/ai-integration/kiro/steering-generator.ts — Kiro steering document generator (SPEC-270)
+import { writeFileSync, mkdirSync, existsSync } from 'node:fs';
+import { join } from 'node:path';
+function buildActiveSpecSection(options) {
+    if (!options.activeSpecId) {
+        return '';
+    }
+    const lines = [
+        '',
+        '## Active Spec',
+        '',
+        `- **ID**: ${options.activeSpecId}`,
+    ];
+    if (options.activeSpecTitle) {
+        lines.push(`- **Title**: ${options.activeSpecTitle}`);
+    }
+    lines.push('- **Branch**: `feat/' + options.activeSpecId + '-*`');
+    return lines.join('\n');
+}
+function buildApprovedSpecsSection(options) {
+    if (options.approvedSpecs.length === 0) {
+        return '';
+    }
+    const lines = ['', '## Approved Specs (ready to implement)', ''];
+    for (const spec of options.approvedSpecs) {
+        lines.push(`- **${spec.id}**: ${spec.title}`);
+    }
+    return lines.join('\n');
+}
+function buildStackSection(options) {
+    if (options.stack.length === 0) {
+        return '';
+    }
+    const lines = ['', '## Stack', ''];
+    for (const tech of options.stack) {
+        lines.push(`- ${tech}`);
+    }
+    return lines.join('\n');
+}
+function buildArchitectureSection(options) {
+    if (!options.architectureStyle) {
+        return '';
+    }
+    return [
+        '',
+        '## Architecture',
+        '',
+        `- **Style**: ${options.architectureStyle}`,
+        '- **Dependency rule**: types → engine → storage → tools (no reverse imports)',
+    ].join('\n');
+}
+/** Generates the content for .kiro/steering/planu-sdd.md */
+export function generateKiroSteering(options) {
+    const sections = [
+        '# Planu SDD — Kiro Steering Document',
+        '',
+        `> Project: **${options.projectName}**`,
+        '',
+        '## SDD Workflow',
+        '',
+        '1. Always create or reference a Planu spec before writing production code',
+        '2. Branch naming: `feat/SPEC-XXX-short-description` (from `develop`)',
+        '3. After implementation run `validate` to check spec compliance',
+        '4. Merge path: `feat/SPEC-XXX` → `develop` → `main`',
+        '',
+        '## Planu Commands',
+        '',
+        '- `create_spec` — create a new spec (brainstorm first)',
+        '- `list_specs` — show all specs with status',
+        '- `update_status` — move spec through: draft → review → approved → implementing → done',
+        '- `validate` — check implementation against spec acceptance criteria',
+        '- `challenge_spec` — stress-test a spec before approving',
+        '- `check_readiness` — verify detail level before implementing',
+        '',
+        '## Branch Conventions',
+        '',
+        '- `feat/SPEC-XXX-*` — spec implementation',
+        '- `fix/SPEC-XXX-*` — spec bugfix',
+        '- `develop` — integration branch (never commit directly)',
+        '- `main` — stable branch (only merges from develop)',
+    ];
+    const activeSection = buildActiveSpecSection(options);
+    if (activeSection) {
+        sections.push(activeSection);
+    }
+    const approvedSection = buildApprovedSpecsSection(options);
+    if (approvedSection) {
+        sections.push(approvedSection);
+    }
+    const stackSection = buildStackSection(options);
+    if (stackSection) {
+        sections.push(stackSection);
+    }
+    const archSection = buildArchitectureSection(options);
+    if (archSection) {
+        sections.push(archSection);
+    }
+    sections.push('');
+    return sections.join('\n');
+}
+/** Writes .kiro/steering/planu-sdd.md to the given project path */
+export function writeKiroSteering(projectPath, options) {
+    const steeringDir = join(projectPath, '.kiro', 'steering');
+    /* v8 ignore start */
+    if (!existsSync(steeringDir)) {
+        mkdirSync(steeringDir, { recursive: true });
+    }
+    /* v8 ignore stop */
+    const content = generateKiroSteering(options);
+    writeFileSync(join(steeringDir, 'planu-sdd.md'), content, 'utf8');
+}
+//# sourceMappingURL=steering-generator.js.map

package/dist/engine/ai-integration/kiro/steering-generator.js.map

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

package/dist/engine/ai-integration/mastra/agent-scaffold.d.ts

@@ -0,0 +1,16 @@
+import type { MastraScaffoldResult } from '../../../types/agent-frameworks.js';
+/**
+ * Returns a TypeScript template for a Mastra spec-implementer agent.
+ */
+export declare function generateMastraSpecAgent(): string;
+/**
+ * Returns a TypeScript template for a Mastra SDD workflow.
+ * The workflow covers: spec-approved → implement → validate → done.
+ */
+export declare function generateMastraWorkflow(): string;
+/**
+ * Creates `.mastra/` directory in the project and writes scaffold files.
+ * Returns list of created file paths and the config path.
+ */
+export declare function writeMastraScaffold(projectPath: string): MastraScaffoldResult;
+//# sourceMappingURL=agent-scaffold.d.ts.map

package/dist/engine/ai-integration/mastra/agent-scaffold.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"agent-scaffold.d.ts","sourceRoot":"","sources":["../../../../src/engine/ai-integration/mastra/agent-scaffold.ts"],"names":[],"mappings":"AAGA,OAAO,KAAK,EAAE,oBAAoB,EAAE,MAAM,oCAAoC,CAAC;AAE/E;;GAEG;AACH,wBAAgB,uBAAuB,IAAI,MAAM,CAgChD;AAED;;;GAGG;AACH,wBAAgB,sBAAsB,IAAI,MAAM,CA8C/C;AAED;;;GAGG;AACH,wBAAgB,mBAAmB,CAAC,WAAW,EAAE,MAAM,GAAG,oBAAoB,CAmB7E"}

package/dist/engine/ai-integration/mastra/agent-scaffold.js

@@ -0,0 +1,111 @@
+// engine/ai-integration/mastra/agent-scaffold.ts — Mastra agent scaffolding (SPEC-274)
+import { writeFileSync, mkdirSync, existsSync } from 'node:fs';
+import { join } from 'node:path';
+/**
+ * Returns a TypeScript template for a Mastra spec-implementer agent.
+ */
+export function generateMastraSpecAgent() {
+    return [
+        `// .mastra/spec-implementer.ts — Generated by Planu (SPEC-274)`,
+        `// Spec-implementer agent: reads approved specs and implements them.`,
+        ``,
+        `import { Agent } from '@mastra/core/agent';`,
+        `import { MCPClient } from '@mastra/mcp';`,
+        ``,
+        `const planuMcp = new MCPClient({`,
+        `  servers: {`,
+        `    planu: { command: 'npx @planu/cli start' },`,
+        `  },`,
+        `});`,
+        ``,
+        `export const specImplementer = new Agent({`,
+        `  name: 'spec-implementer',`,
+        `  instructions: [`,
+        `    'You implement software specs following the Spec Driven Development workflow.',`,
+        `    'Step 1: Call mcp__planu__list_specs to find specs with status=approved.',`,
+        `    'Step 2: Call mcp__planu__summarize_spec to understand requirements.',`,
+        `    'Step 3: Implement the code to satisfy all acceptance criteria.',`,
+        `    'Step 4: Call mcp__planu__validate to verify compliance.',`,
+        `    'Step 5: Call mcp__planu__update_status with status=done when validated.',`,
+        `    'Never skip validation — it is the gate between implementation and done.',`,
+        `  ].join(' '),`,
+        `  tools: await planuMcp.getTools(),`,
+        `  model: {`,
+        `    provider: 'ANTHROPIC',`,
+        `    name: 'claude-sonnet-4-5',`,
+        `  },`,
+        `});`,
+    ].join('\n');
+}
+/**
+ * Returns a TypeScript template for a Mastra SDD workflow.
+ * The workflow covers: spec-approved → implement → validate → done.
+ */
+export function generateMastraWorkflow() {
+    return [
+        `// .mastra/planu-workflow.ts — Generated by Planu (SPEC-274)`,
+        `// SDD workflow: spec-approved → implement → validate → done`,
+        ``,
+        `import { createWorkflow, createStep } from '@mastra/core/workflow';`,
+        `import { specImplementer } from './spec-implementer.js';`,
+        ``,
+        `const readSpecStep = createStep({`,
+        `  id: 'read-spec',`,
+        `  description: 'Reads the approved spec and extracts acceptance criteria.',`,
+        `  execute: async ({ context }) => {`,
+        `    const specId = context.triggerData?.specId as string;`,
+        `    return { specId, status: 'read' };`,
+        `  },`,
+        `});`,
+        ``,
+        `const implementStep = createStep({`,
+        `  id: 'implement',`,
+        `  description: 'Implements the spec using the planu-implementer agent.',`,
+        `  execute: async ({ context }) => {`,
+        `    const { specId } = context.getStepResult('read-spec') as { specId: string };`,
+        `    await specImplementer.generate(\`Implement spec \${specId}\`);`,
+        `    return { specId, status: 'implemented' };`,
+        `  },`,
+        `});`,
+        ``,
+        `const validateStep = createStep({`,
+        `  id: 'validate',`,
+        `  description: 'Validates implementation against spec criteria.',`,
+        `  execute: async ({ context }) => {`,
+        `    const { specId } = context.getStepResult('implement') as { specId: string };`,
+        `    await specImplementer.generate(\`Validate spec \${specId} with mcp__planu__validate\`);`,
+        `    return { specId, status: 'validated' };`,
+        `  },`,
+        `});`,
+        ``,
+        `export const planuWorkflow = createWorkflow({`,
+        `  name: 'planu-sdd-workflow',`,
+        `  triggerSchema: { specId: 'string' },`,
+        `})`,
+        `  .then(readSpecStep)`,
+        `  .then(implementStep)`,
+        `  .then(validateStep)`,
+        `  .commit();`,
+    ].join('\n');
+}
+/**
+ * Creates `.mastra/` directory in the project and writes scaffold files.
+ * Returns list of created file paths and the config path.
+ */
+export function writeMastraScaffold(projectPath) {
+    const mastraDir = join(projectPath, '.mastra');
+    /* v8 ignore start */
+    if (!existsSync(mastraDir)) {
+        mkdirSync(mastraDir, { recursive: true });
+    }
+    /* v8 ignore stop */
+    const agentPath = join(mastraDir, 'spec-implementer.ts');
+    const workflowPath = join(mastraDir, 'planu-workflow.ts');
+    writeFileSync(agentPath, generateMastraSpecAgent(), 'utf8');
+    writeFileSync(workflowPath, generateMastraWorkflow(), 'utf8');
+    return {
+        filesCreated: [agentPath, workflowPath],
+        configPath: mastraDir,
+    };
+}
+//# sourceMappingURL=agent-scaffold.js.map

package/dist/engine/ai-integration/mastra/agent-scaffold.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"agent-scaffold.js","sourceRoot":"","sources":["../../../../src/engine/ai-integration/mastra/agent-scaffold.ts"],"names":[],"mappings":"AAAA,uFAAuF;AACvF,OAAO,EAAE,aAAa,EAAE,SAAS,EAAE,UAAU,EAAE,MAAM,SAAS,CAAC;AAC/D,OAAO,EAAE,IAAI,EAAE,MAAM,WAAW,CAAC;AAGjC;;GAEG;AACH,MAAM,UAAU,uBAAuB;IACrC,OAAO;QACL,gEAAgE;QAChE,sEAAsE;QACtE,EAAE;QACF,6CAA6C;QAC7C,0CAA0C;QAC1C,EAAE;QACF,kCAAkC;QAClC,cAAc;QACd,iDAAiD;QACjD,MAAM;QACN,KAAK;QACL,EAAE;QACF,4CAA4C;QAC5C,6BAA6B;QAC7B,mBAAmB;QACnB,qFAAqF;QACrF,gFAAgF;QAChF,4EAA4E;QAC5E,uEAAuE;QACvE,gEAAgE;QAChE,gFAAgF;QAChF,gFAAgF;QAChF,gBAAgB;QAChB,qCAAqC;QACrC,YAAY;QACZ,4BAA4B;QAC5B,gCAAgC;QAChC,MAAM;QACN,KAAK;KACN,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;AACf,CAAC;AAED;;;GAGG;AACH,MAAM,UAAU,sBAAsB;IACpC,OAAO;QACL,8DAA8D;QAC9D,8DAA8D;QAC9D,EAAE;QACF,qEAAqE;QACrE,0DAA0D;QAC1D,EAAE;QACF,mCAAmC;QACnC,oBAAoB;QACpB,6EAA6E;QAC7E,qCAAqC;QACrC,2DAA2D;QAC3D,wCAAwC;QACxC,MAAM;QACN,KAAK;QACL,EAAE;QACF,oCAAoC;QACpC,oBAAoB;QACpB,0EAA0E;QAC1E,qCAAqC;QACrC,kFAAkF;QAClF,oEAAoE;QACpE,+CAA+C;QAC/C,MAAM;QACN,KAAK;QACL,EAAE;QACF,mCAAmC;QACnC,mBAAmB;QACnB,mEAAmE;QACnE,qCAAqC;QACrC,kFAAkF;QAClF,6FAA6F;QAC7F,6CAA6C;QAC7C,MAAM;QACN,KAAK;QACL,EAAE;QACF,+CAA+C;QAC/C,+BAA+B;QAC/B,wCAAwC;QACxC,IAAI;QACJ,uBAAuB;QACvB,wBAAwB;QACxB,uBAAuB;QACvB,cAAc;KACf,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;AACf,CAAC;AAED;;;GAGG;AACH,MAAM,UAAU,mBAAmB,CAAC,WAAmB;IACrD,MAAM,SAAS,GAAG,IAAI,CAAC,WAAW,EAAE,SAAS,CAAC,CAAC;IAE/C,qBAAqB;IACrB,IAAI,CAAC,UAAU,CAAC,SAAS,CAAC,EAAE,CAAC;QAC3B,SAAS,CAAC,SAAS,EAAE,EAAE,SAAS,EAAE,IAAI,EAAE,CAAC,CAAC;IAC5C,CAAC;IACD,oBAAoB;IAEpB,MAAM,SAAS,GAAG,IAAI,CAAC,SAAS,EAAE,qBAAqB,CAAC,CAAC;IACzD,MAAM,YAAY,GAAG,IAAI,CAAC,SAAS,EAAE,mBAAmB,CAAC,CAAC;IAE1D,aAAa,CAAC,SAAS,EAAE,uBAAuB,EAAE,EAAE,MAAM,CAAC,CAAC;IAC5D,aAAa,CAAC,YAAY,EAAE,sBAAsB,EAAE,EAAE,MAAM,CAAC,CAAC;IAE9D,OAAO;QACL,YAAY,EAAE,CAAC,SAAS,EAAE,YAAY,CAAC;QACvC,UAAU,EAAE,SAAS;KACtB,CAAC;AACJ,CAAC"}

package/dist/engine/ai-integration/mastra/config-generator.d.ts

@@ -0,0 +1,12 @@
+import type { MastraConfigOptions } from '../../../types/agent-frameworks.js';
+/**
+ * Generates the content of a `planu.mastra.ts` config file for the user's project.
+ * This is a TypeScript template — not Planu's own code.
+ */
+export declare function generateMastraConfig(options: MastraConfigOptions): string;
+/**
+ * Writes `planu.mastra.ts` to the given project path.
+ * Creates the directory if it does not exist.
+ */
+export declare function writeMastraConfig(projectPath: string, options: MastraConfigOptions): void;
+//# sourceMappingURL=config-generator.d.ts.map

package/dist/engine/ai-integration/mastra/config-generator.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"config-generator.d.ts","sourceRoot":"","sources":["../../../../src/engine/ai-integration/mastra/config-generator.ts"],"names":[],"mappings":"AAGA,OAAO,KAAK,EAAE,mBAAmB,EAAE,MAAM,oCAAoC,CAAC;AAE9E;;;GAGG;AACH,wBAAgB,oBAAoB,CAAC,OAAO,EAAE,mBAAmB,GAAG,MAAM,CA2CzE;AAED;;;GAGG;AACH,wBAAgB,iBAAiB,CAAC,WAAW,EAAE,MAAM,EAAE,OAAO,EAAE,mBAAmB,GAAG,IAAI,CASzF"}

package/dist/engine/ai-integration/mastra/config-generator.js

@@ -0,0 +1,64 @@
+// engine/ai-integration/mastra/config-generator.ts — Mastra config template generator (SPEC-274)
+import { writeFileSync, mkdirSync, existsSync } from 'node:fs';
+import { join } from 'node:path';
+/**
+ * Generates the content of a `planu.mastra.ts` config file for the user's project.
+ * This is a TypeScript template — not Planu's own code.
+ */
+export function generateMastraConfig(options) {
+    const { projectName, stack, activeSpecId, mcpServerPath } = options;
+    const mcpPath = mcpServerPath ?? 'npx @planu/cli start';
+    const activeSpec = activeSpecId ? `\n  // Active spec: ${activeSpecId}` : '';
+    const stackComment = stack.length > 0 ? `\n  // Stack: ${stack.join(', ')}` : '';
+    return [
+        `// planu.mastra.ts — Generated by Planu for project: ${projectName}`,
+        `// Edit this file to customize the Planu agent for your workflow.`,
+        `// Docs: https://planu.dev/docs/mastra-integration`,
+        ``,
+        `import { Agent } from '@mastra/core/agent';`,
+        `import { MCPClient } from '@mastra/mcp';`,
+        ``,
+        `// Initialize Planu MCP client`,
+        `const planuMcp = new MCPClient({`,
+        `  servers: {`,
+        `    planu: {`,
+        `      command: '${mcpPath}',`,
+        `    },`,
+        `  },`,
+        `});`,
+        ``,
+        `// Planu implementer agent${activeSpec}${stackComment}`,
+        `export const planuImplementer = new Agent({`,
+        `  name: 'planu-implementer',`,
+        `  instructions: [`,
+        `    'Use Planu specs as the single source of truth.',`,
+        `    'Before writing any code, call mcp__planu__list_specs to find the approved spec.',`,
+        `    'After implementation, call mcp__planu__validate to verify compliance.',`,
+        `    'Never implement without an approved spec — create one first with mcp__planu__create_spec.',`,
+        `  ].join(' '),`,
+        `  tools: await planuMcp.getTools(),`,
+        `  model: {`,
+        `    provider: 'ANTHROPIC',`,
+        `    name: 'claude-sonnet-4-5',`,
+        `  },`,
+        `});`,
+        ``,
+        `export const mastra = {`,
+        `  agents: { planuImplementer },`,
+        `};`,
+    ].join('\n');
+}
+/**
+ * Writes `planu.mastra.ts` to the given project path.
+ * Creates the directory if it does not exist.
+ */
+export function writeMastraConfig(projectPath, options) {
+    /* v8 ignore start */
+    if (!existsSync(projectPath)) {
+        mkdirSync(projectPath, { recursive: true });
+    }
+    /* v8 ignore stop */
+    const configPath = join(projectPath, 'planu.mastra.ts');
+    writeFileSync(configPath, generateMastraConfig(options), 'utf8');
+}
+//# sourceMappingURL=config-generator.js.map

package/dist/engine/ai-integration/mastra/config-generator.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"config-generator.js","sourceRoot":"","sources":["../../../../src/engine/ai-integration/mastra/config-generator.ts"],"names":[],"mappings":"AAAA,iGAAiG;AACjG,OAAO,EAAE,aAAa,EAAE,SAAS,EAAE,UAAU,EAAE,MAAM,SAAS,CAAC;AAC/D,OAAO,EAAE,IAAI,EAAE,MAAM,WAAW,CAAC;AAGjC;;;GAGG;AACH,MAAM,UAAU,oBAAoB,CAAC,OAA4B;IAC/D,MAAM,EAAE,WAAW,EAAE,KAAK,EAAE,YAAY,EAAE,aAAa,EAAE,GAAG,OAAO,CAAC;IACpE,MAAM,OAAO,GAAG,aAAa,IAAI,sBAAsB,CAAC;IACxD,MAAM,UAAU,GAAG,YAAY,CAAC,CAAC,CAAC,uBAAuB,YAAY,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC;IAC7E,MAAM,YAAY,GAAG,KAAK,CAAC,MAAM,GAAG,CAAC,CAAC,CAAC,CAAC,iBAAiB,KAAK,CAAC,IAAI,CAAC,IAAI,CAAC,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC;IAEjF,OAAO;QACL,wDAAwD,WAAW,EAAE;QACrE,mEAAmE;QACnE,oDAAoD;QACpD,EAAE;QACF,6CAA6C;QAC7C,0CAA0C;QAC1C,EAAE;QACF,gCAAgC;QAChC,kCAAkC;QAClC,cAAc;QACd,cAAc;QACd,mBAAmB,OAAO,IAAI;QAC9B,QAAQ;QACR,MAAM;QACN,KAAK;QACL,EAAE;QACF,6BAA6B,UAAU,GAAG,YAAY,EAAE;QACxD,6CAA6C;QAC7C,8BAA8B;QAC9B,mBAAmB;QACnB,uDAAuD;QACvD,wFAAwF;QACxF,8EAA8E;QAC9E,kGAAkG;QAClG,gBAAgB;QAChB,qCAAqC;QACrC,YAAY;QACZ,4BAA4B;QAC5B,gCAAgC;QAChC,MAAM;QACN,KAAK;QACL,EAAE;QACF,yBAAyB;QACzB,iCAAiC;QACjC,IAAI;KACL,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;AACf,CAAC;AAED;;;GAGG;AACH,MAAM,UAAU,iBAAiB,CAAC,WAAmB,EAAE,OAA4B;IACjF,qBAAqB;IACrB,IAAI,CAAC,UAAU,CAAC,WAAW,CAAC,EAAE,CAAC;QAC7B,SAAS,CAAC,WAAW,EAAE,EAAE,SAAS,EAAE,IAAI,EAAE,CAAC,CAAC;IAC9C,CAAC;IACD,oBAAoB;IAEpB,MAAM,UAAU,GAAG,IAAI,CAAC,WAAW,EAAE,iBAAiB,CAAC,CAAC;IACxD,aAAa,CAAC,UAAU,EAAE,oBAAoB,CAAC,OAAO,CAAC,EAAE,MAAM,CAAC,CAAC;AACnE,CAAC"}

package/dist/engine/ai-integration/mastra/index.d.ts

@@ -0,0 +1,3 @@
+export { generateMastraConfig, writeMastraConfig } from './config-generator.js';
+export { generateMastraSpecAgent, generateMastraWorkflow, writeMastraScaffold } from './agent-scaffold.js';
+//# sourceMappingURL=index.d.ts.map

package/dist/engine/ai-integration/mastra/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../../src/engine/ai-integration/mastra/index.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,oBAAoB,EAAE,iBAAiB,EAAE,MAAM,uBAAuB,CAAC;AAChF,OAAO,EAAE,uBAAuB,EAAE,sBAAsB,EAAE,mBAAmB,EAAE,MAAM,qBAAqB,CAAC"}

package/dist/engine/ai-integration/mastra/index.js

@@ -0,0 +1,4 @@
+// engine/ai-integration/mastra/index.ts — barrel (SPEC-274)
+export { generateMastraConfig, writeMastraConfig } from './config-generator.js';
+export { generateMastraSpecAgent, generateMastraWorkflow, writeMastraScaffold } from './agent-scaffold.js';
+//# sourceMappingURL=index.js.map

package/dist/engine/ai-integration/mastra/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../../src/engine/ai-integration/mastra/index.ts"],"names":[],"mappings":"AAAA,4DAA4D;AAC5D,OAAO,EAAE,oBAAoB,EAAE,iBAAiB,EAAE,MAAM,uBAAuB,CAAC;AAChF,OAAO,EAAE,uBAAuB,EAAE,sBAAsB,EAAE,mBAAmB,EAAE,MAAM,qBAAqB,CAAC"}

package/dist/engine/ai-integration/universal-config-generator.d.ts

@@ -0,0 +1,4 @@
+import type { UniversalConfigOptions, GeneratedConfigs } from '../../types/ai-integration.js';
+export type { UniversalConfigOptions, GeneratedConfigs };
+export declare function generateConfigsForDetectedTools(options: UniversalConfigOptions): GeneratedConfigs[];
+//# sourceMappingURL=universal-config-generator.d.ts.map

package/dist/engine/ai-integration/universal-config-generator.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"universal-config-generator.d.ts","sourceRoot":"","sources":["../../../src/engine/ai-integration/universal-config-generator.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAEV,sBAAsB,EACtB,gBAAgB,EAEjB,MAAM,+BAA+B,CAAC;AAMvC,YAAY,EAAE,sBAAsB,EAAE,gBAAgB,EAAE,CAAC;AA2DzD,wBAAgB,+BAA+B,CAC7C,OAAO,EAAE,sBAAsB,GAC9B,gBAAgB,EAAE,CAiCpB"}

package/dist/engine/ai-integration/universal-config-generator.js

@@ -0,0 +1,87 @@
+import { getDetectedTools } from './detector.js';
+import { writeCursorRules } from './cursor/cursorrules-generator.js';
+import { writeWindsurfRules } from './windsurf/windsurfrules-generator.js';
+import { writeAiderConfig } from './aider/aider-config-generator.js';
+function generateForCursor(options) {
+    writeCursorRules(options.projectPath, {
+        projectName: options.projectName,
+        stack: options.stack,
+        activeSpecId: options.activeSpecId,
+        approvedSpecs: options.approvedSpecs,
+        architectureStyle: options.architectureStyle,
+    });
+    return {
+        tool: 'cursor',
+        filesGenerated: ['.cursorrules'],
+        skipped: false,
+    };
+}
+function generateForWindsurf(options) {
+    writeWindsurfRules(options.projectPath, {
+        projectName: options.projectName,
+        stack: options.stack,
+        activeSpecId: options.activeSpecId,
+        approvedSpecs: options.approvedSpecs,
+        architectureStyle: options.architectureStyle,
+    });
+    return {
+        tool: 'windsurf',
+        filesGenerated: ['.windsurfrules'],
+        skipped: false,
+    };
+}
+function generateForAider(options) {
+    writeAiderConfig(options.projectPath, {});
+    return {
+        tool: 'aider',
+        filesGenerated: ['.aider.conf.yml'],
+        skipped: false,
+    };
+}
+function skipTool(tool, reason) {
+    return { tool, filesGenerated: [], skipped: true, reason };
+}
+const GENERATORS = {
+    cursor: generateForCursor,
+    windsurf: generateForWindsurf,
+    aider: generateForAider,
+};
+const SKIPPED_TOOLS = {
+    'claude-code': 'Already managed by SPEC-263/265',
+    'codex-cli': 'Managed by SPEC-266 (codex worktree)',
+    'gemini-cli': 'Managed by SPEC-267 (gemini worktree)',
+    'github-copilot': 'No Planu config integration yet',
+    'continue-dev': 'No Planu config integration yet',
+};
+export function generateConfigsForDetectedTools(options) {
+    const tools = options.detectedTools ?? getDetectedTools(options.projectPath);
+    const results = [];
+    for (const tool of tools) {
+        const skipReason = SKIPPED_TOOLS[tool];
+        if (skipReason !== undefined) {
+            results.push(skipTool(tool, skipReason));
+            continue;
+        }
+        const generator = GENERATORS[tool];
+        if (generator === undefined) {
+            /* v8 ignore start */
+            results.push(skipTool(tool, 'No generator available'));
+            continue;
+            /* v8 ignore stop */
+        }
+        try {
+            results.push(generator(options));
+        }
+        catch (err) {
+            const message = err instanceof Error ? err.message : String(err);
+            results.push({
+                tool,
+                filesGenerated: [],
+                skipped: false,
+                reason: `Error: ${message}`,
+            });
+        }
+    }
+    return results;
+}
+//# sourceMappingURL=universal-config-generator.js.map

package/dist/engine/ai-integration/universal-config-generator.js.map

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

package/dist/engine/ai-integration/windsurf/windsurfrules-generator.d.ts

@@ -0,0 +1,5 @@
+import type { CursorRulesOptions } from '../../../types/ai-integration.js';
+export type { CursorRulesOptions };
+export declare function generateWindsurfRules(options: CursorRulesOptions): string;
+export declare function writeWindsurfRules(projectPath: string, options: CursorRulesOptions): void;
+//# sourceMappingURL=windsurfrules-generator.d.ts.map

package/dist/engine/ai-integration/windsurf/windsurfrules-generator.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"windsurfrules-generator.d.ts","sourceRoot":"","sources":["../../../../src/engine/ai-integration/windsurf/windsurfrules-generator.ts"],"names":[],"mappings":"AAGA,OAAO,KAAK,EAAE,kBAAkB,EAAE,MAAM,kCAAkC,CAAC;AAE3E,YAAY,EAAE,kBAAkB,EAAE,CAAC;AAwDnC,wBAAgB,qBAAqB,CAAC,OAAO,EAAE,kBAAkB,GAAG,MAAM,CAOzE;AAED,wBAAgB,kBAAkB,CAAC,WAAW,EAAE,MAAM,EAAE,OAAO,EAAE,kBAAkB,GAAG,IAAI,CAoBzF"}

package/dist/engine/ai-integration/windsurf/windsurfrules-generator.js

@@ -0,0 +1,75 @@
+// engine/ai-integration/windsurf/windsurfrules-generator.ts — .windsurfrules generator (SPEC-268)
+import { readFileSync, writeFileSync, existsSync } from 'node:fs';
+import { join } from 'node:path';
+const SECTION_START = '<!-- planu-sdd:start -->';
+const SECTION_END = '<!-- planu-sdd:end -->';
+function buildPlanuSection(options) {
+    const lines = [SECTION_START, ''];
+    lines.push('## Planu SDD Workflow (MANDATORY)');
+    lines.push('');
+    lines.push('Never write production code without an approved Planu spec.');
+    lines.push('');
+    lines.push('1. Describe what you want to build');
+    lines.push('2. Planu creates a spec via MCP: `mcp__planu__create_spec`');
+    lines.push('3. Review and approve the spec');
+    lines.push('4. Implement following the spec criteria');
+    lines.push('5. Validate: `mcp__planu__validate`');
+    lines.push('');
+    lines.push('### Key Planu MCP Tools');
+    lines.push('- `mcp__planu__create_spec` — Create a new spec from a description');
+    lines.push('- `mcp__planu__list_specs` — List all specs and their status');
+    lines.push('- `mcp__planu__update_status` — Move a spec through the workflow');
+    lines.push('- `mcp__planu__validate` — Validate implementation against spec criteria');
+    lines.push('- `mcp__planu__challenge_spec` — Stress-test a spec before implementation');
+    lines.push('');
+    lines.push('### Branch Convention');
+    lines.push('```');
+    lines.push('feat/SPEC-XXX-short-description → develop → main');
+    lines.push('```');
+    lines.push('');
+    if (options.activeSpecId) {
+        lines.push(`### Active Spec: ${options.activeSpecId}`);
+        lines.push('');
+        lines.push('Implement this spec next. Follow all criteria exactly.');
+        lines.push('');
+    }
+    if (options.approvedSpecs.length > 0) {
+        lines.push('### Approved Queue');
+        lines.push('');
+        for (const spec of options.approvedSpecs) {
+            lines.push(`- **${spec.id}**: ${spec.title}`);
+        }
+        lines.push('');
+    }
+    if (options.architectureStyle) {
+        lines.push(`### Architecture: ${options.architectureStyle}`);
+        lines.push('');
+    }
+    lines.push(SECTION_END);
+    return lines.join('\n');
+}
+export function generateWindsurfRules(options) {
+    const stackStr = options.stack.length > 0 ? options.stack.join(', ') : 'Not specified';
+    const header = [`# Windsurf Rules — ${options.projectName}`, '', `Stack: ${stackStr}`, ''].join('\n');
+    return header + buildPlanuSection(options);
+}
+export function writeWindsurfRules(projectPath, options) {
+    const filePath = join(projectPath, '.windsurfrules');
+    const planuSection = buildPlanuSection(options);
+    if (!existsSync(filePath)) {
+        writeFileSync(filePath, generateWindsurfRules(options), 'utf8');
+        return;
+    }
+    const existing = readFileSync(filePath, 'utf8');
+    const startIdx = existing.indexOf(SECTION_START);
+    const endIdx = existing.indexOf(SECTION_END);
+    if (startIdx !== -1 && endIdx !== -1) {
+        const before = existing.slice(0, startIdx);
+        const after = existing.slice(endIdx + SECTION_END.length);
+        writeFileSync(filePath, before + planuSection + after, 'utf8');
+    }
+    else {
+        writeFileSync(filePath, existing + '\n' + planuSection, 'utf8');
+    }
+}
+//# sourceMappingURL=windsurfrules-generator.js.map

package/dist/engine/ai-integration/windsurf/windsurfrules-generator.js.map

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