@planu/cli 0.91.0 → 0.93.0

package/dist/engine/ai-integration/agent-frameworks/crewai-exporter.js

@@ -0,0 +1,89 @@
+// engine/ai-integration/agent-frameworks/crewai-exporter.ts — CrewAI config exporter (SPEC-274)
+import { writeFileSync, mkdirSync, existsSync } from 'node:fs';
+import { join } from 'node:path';
+/**
+ * Converts a Planu spec into a CrewAI YAML configuration object.
+ * Produces 3 agents (spec-writer, implementer, reviewer) and 3 tasks.
+ */
+export function exportSpecToCrewai(spec) {
+    const stackNote = spec.stack.length > 0 ? ` Stack: ${spec.stack.join(', ')}.` : '';
+    return {
+        agents: [
+            {
+                name: 'spec-writer',
+                role: 'Spec Writer',
+                goal: `Create detailed Planu specs from user requirements for: ${spec.title}`,
+                backstory: 'You are an expert at translating business requirements into precise, testable acceptance criteria using the Spec Driven Development methodology.',
+            },
+            {
+                name: 'implementer',
+                role: 'Software Implementer',
+                goal: `Implement the approved spec: ${spec.id} — ${spec.title}.${stackNote}`,
+                backstory: 'You implement software according to approved specs. You never write code without a spec, and you always validate after implementation.',
+            },
+            {
+                name: 'reviewer',
+                role: 'Code Reviewer',
+                goal: `Review the implementation of spec ${spec.id} against its acceptance criteria`,
+                backstory: 'You perform thorough code reviews against spec criteria. You produce structured review reports and never modify code directly.',
+            },
+        ],
+        tasks: [
+            {
+                name: 'create-spec',
+                description: `Create a Planu spec for: ${spec.description}. Acceptance criteria: ${spec.acceptanceCriteria.join('; ')}.`,
+                agent: 'spec-writer',
+                expectedOutput: 'A complete Planu spec with id, title, description, and acceptance criteria.',
+            },
+            {
+                name: 'implement',
+                description: `Implement all acceptance criteria for spec ${spec.id}: ${spec.acceptanceCriteria.join('; ')}.`,
+                agent: 'implementer',
+                expectedOutput: 'Working code that satisfies all acceptance criteria, with passing tests.',
+            },
+            {
+                name: 'validate',
+                description: `Review implementation of spec ${spec.id} and confirm all criteria are met.`,
+                agent: 'reviewer',
+                expectedOutput: 'A review report listing covered and uncovered criteria with pass/fail status.',
+            },
+        ],
+    };
+}
+/**
+ * Serializes the CrewAI config to YAML and writes `planu-crew.yaml` to the project path.
+ */
+export function writeCrewaiConfig(projectPath, spec) {
+    const config = exportSpecToCrewai(spec);
+    /* v8 ignore start */
+    if (!existsSync(projectPath)) {
+        mkdirSync(projectPath, { recursive: true });
+    }
+    /* v8 ignore stop */
+    const yaml = buildCrewaiYaml(config);
+    writeFileSync(join(projectPath, 'planu-crew.yaml'), yaml, 'utf8');
+}
+function buildCrewaiYaml(config) {
+    const lines = ['# planu-crew.yaml — Generated by Planu (SPEC-274)', ''];
+    lines.push('agents:');
+    for (const agent of config.agents) {
+        lines.push(`  - name: ${agent.name}`);
+        lines.push(`    role: ${agent.role}`);
+        lines.push(`    goal: >-`);
+        lines.push(`      ${agent.goal}`);
+        lines.push(`    backstory: >-`);
+        lines.push(`      ${agent.backstory}`);
+    }
+    lines.push('');
+    lines.push('tasks:');
+    for (const task of config.tasks) {
+        lines.push(`  - name: ${task.name}`);
+        lines.push(`    description: >-`);
+        lines.push(`      ${task.description}`);
+        lines.push(`    agent: ${task.agent}`);
+        lines.push(`    expected_output: >-`);
+        lines.push(`      ${task.expectedOutput}`);
+    }
+    return lines.join('\n');
+}
+//# sourceMappingURL=crewai-exporter.js.map

package/dist/engine/ai-integration/agent-frameworks/crewai-exporter.js.map

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

package/dist/engine/ai-integration/agent-frameworks/index.d.ts

@@ -0,0 +1,4 @@
+export { exportSpecToCrewai, writeCrewaiConfig } from './crewai-exporter.js';
+export { exportSpecToLangGraph, writeLangGraphConfig } from './langgraph-exporter.js';
+export { exportSpecToAutogen, writeAutogenConfig } from './autogen-exporter.js';
+//# sourceMappingURL=index.d.ts.map

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

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

package/dist/engine/ai-integration/agent-frameworks/index.js

@@ -0,0 +1,5 @@
+// engine/ai-integration/agent-frameworks/index.ts — barrel (SPEC-274)
+export { exportSpecToCrewai, writeCrewaiConfig } from './crewai-exporter.js';
+export { exportSpecToLangGraph, writeLangGraphConfig } from './langgraph-exporter.js';
+export { exportSpecToAutogen, writeAutogenConfig } from './autogen-exporter.js';
+//# sourceMappingURL=index.js.map

package/dist/engine/ai-integration/agent-frameworks/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../../src/engine/ai-integration/agent-frameworks/index.ts"],"names":[],"mappings":"AAAA,sEAAsE;AACtE,OAAO,EAAE,kBAAkB,EAAE,iBAAiB,EAAE,MAAM,sBAAsB,CAAC;AAC7E,OAAO,EAAE,qBAAqB,EAAE,oBAAoB,EAAE,MAAM,yBAAyB,CAAC;AACtF,OAAO,EAAE,mBAAmB,EAAE,kBAAkB,EAAE,MAAM,uBAAuB,CAAC"}

package/dist/engine/ai-integration/agent-frameworks/langgraph-exporter.d.ts

@@ -0,0 +1,11 @@
+import type { AgentFrameworkSpec, LangGraphConfig } from '../../../types/agent-frameworks.js';
+/**
+ * Converts a Planu spec into a LangGraph state machine configuration.
+ * The SDD workflow is represented as nodes + edges.
+ */
+export declare function exportSpecToLangGraph(spec: AgentFrameworkSpec): LangGraphConfig;
+/**
+ * Serializes the LangGraph config to JSON and writes `planu-graph.json` to the project path.
+ */
+export declare function writeLangGraphConfig(projectPath: string, spec: AgentFrameworkSpec): void;
+//# sourceMappingURL=langgraph-exporter.d.ts.map

package/dist/engine/ai-integration/agent-frameworks/langgraph-exporter.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"langgraph-exporter.d.ts","sourceRoot":"","sources":["../../../../src/engine/ai-integration/agent-frameworks/langgraph-exporter.ts"],"names":[],"mappings":"AAGA,OAAO,KAAK,EAAE,kBAAkB,EAAE,eAAe,EAAE,MAAM,oCAAoC,CAAC;AAE9F;;;GAGG;AACH,wBAAgB,qBAAqB,CAAC,IAAI,EAAE,kBAAkB,GAAG,eAAe,CAiD/E;AAED;;GAEG;AACH,wBAAgB,oBAAoB,CAAC,WAAW,EAAE,MAAM,EAAE,IAAI,EAAE,kBAAkB,GAAG,IAAI,CAWxF"}

package/dist/engine/ai-integration/agent-frameworks/langgraph-exporter.js

@@ -0,0 +1,71 @@
+// engine/ai-integration/agent-frameworks/langgraph-exporter.ts — LangGraph config exporter (SPEC-274)
+import { writeFileSync, mkdirSync, existsSync } from 'node:fs';
+import { join } from 'node:path';
+/**
+ * Converts a Planu spec into a LangGraph state machine configuration.
+ * The SDD workflow is represented as nodes + edges.
+ */
+export function exportSpecToLangGraph(spec) {
+    return {
+        nodes: [
+            {
+                id: 'spec-reader',
+                description: `Read spec ${spec.id} — ${spec.title} and extract acceptance criteria.`,
+            },
+            {
+                id: 'implementer',
+                description: `Implement all ${spec.acceptanceCriteria.length} acceptance criteria for spec ${spec.id}.`,
+            },
+            {
+                id: 'validator',
+                description: `Validate implementation against spec ${spec.id} criteria using mcp__planu__validate.`,
+            },
+            {
+                id: 'done',
+                description: `Mark spec ${spec.id} as done and update status in Planu.`,
+            },
+        ],
+        edges: [
+            {
+                from: 'spec-reader',
+                to: 'implementer',
+            },
+            {
+                from: 'implementer',
+                to: 'validator',
+            },
+            {
+                from: 'validator',
+                to: 'done',
+                condition: 'validation_passed',
+            },
+            {
+                from: 'validator',
+                to: 'implementer',
+                condition: 'validation_failed',
+            },
+        ],
+        entryPoint: 'spec-reader',
+        stateSchema: {
+            specId: 'string',
+            specTitle: 'string',
+            acceptanceCriteria: 'string[]',
+            implementationStatus: 'pending | in-progress | implemented | validated | done',
+            validationResult: 'passed | failed | pending',
+        },
+    };
+}
+/**
+ * Serializes the LangGraph config to JSON and writes `planu-graph.json` to the project path.
+ */
+export function writeLangGraphConfig(projectPath, spec) {
+    const config = exportSpecToLangGraph(spec);
+    /* v8 ignore start */
+    if (!existsSync(projectPath)) {
+        mkdirSync(projectPath, { recursive: true });
+    }
+    /* v8 ignore stop */
+    const json = JSON.stringify(config, null, 2);
+    writeFileSync(join(projectPath, 'planu-graph.json'), json, 'utf8');
+}
+//# sourceMappingURL=langgraph-exporter.js.map

package/dist/engine/ai-integration/agent-frameworks/langgraph-exporter.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"langgraph-exporter.js","sourceRoot":"","sources":["../../../../src/engine/ai-integration/agent-frameworks/langgraph-exporter.ts"],"names":[],"mappings":"AAAA,sGAAsG;AACtG,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,qBAAqB,CAAC,IAAwB;IAC5D,OAAO;QACL,KAAK,EAAE;YACL;gBACE,EAAE,EAAE,aAAa;gBACjB,WAAW,EAAE,aAAa,IAAI,CAAC,EAAE,MAAM,IAAI,CAAC,KAAK,mCAAmC;aACrF;YACD;gBACE,EAAE,EAAE,aAAa;gBACjB,WAAW,EAAE,iBAAiB,IAAI,CAAC,kBAAkB,CAAC,MAAM,iCAAiC,IAAI,CAAC,EAAE,GAAG;aACxG;YACD;gBACE,EAAE,EAAE,WAAW;gBACf,WAAW,EAAE,wCAAwC,IAAI,CAAC,EAAE,uCAAuC;aACpG;YACD;gBACE,EAAE,EAAE,MAAM;gBACV,WAAW,EAAE,aAAa,IAAI,CAAC,EAAE,sCAAsC;aACxE;SACF;QACD,KAAK,EAAE;YACL;gBACE,IAAI,EAAE,aAAa;gBACnB,EAAE,EAAE,aAAa;aAClB;YACD;gBACE,IAAI,EAAE,aAAa;gBACnB,EAAE,EAAE,WAAW;aAChB;YACD;gBACE,IAAI,EAAE,WAAW;gBACjB,EAAE,EAAE,MAAM;gBACV,SAAS,EAAE,mBAAmB;aAC/B;YACD;gBACE,IAAI,EAAE,WAAW;gBACjB,EAAE,EAAE,aAAa;gBACjB,SAAS,EAAE,mBAAmB;aAC/B;SACF;QACD,UAAU,EAAE,aAAa;QACzB,WAAW,EAAE;YACX,MAAM,EAAE,QAAQ;YAChB,SAAS,EAAE,QAAQ;YACnB,kBAAkB,EAAE,UAAU;YAC9B,oBAAoB,EAAE,wDAAwD;YAC9E,gBAAgB,EAAE,2BAA2B;SAC9C;KACF,CAAC;AACJ,CAAC;AAED;;GAEG;AACH,MAAM,UAAU,oBAAoB,CAAC,WAAmB,EAAE,IAAwB;IAChF,MAAM,MAAM,GAAG,qBAAqB,CAAC,IAAI,CAAC,CAAC;IAE3C,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,IAAI,GAAG,IAAI,CAAC,SAAS,CAAC,MAAM,EAAE,IAAI,EAAE,CAAC,CAAC,CAAC;IAC7C,aAAa,CAAC,IAAI,CAAC,WAAW,EAAE,kBAAkB,CAAC,EAAE,IAAI,EAAE,MAAM,CAAC,CAAC;AACrE,CAAC"}

package/dist/engine/ai-integration/agents-md/generator.d.ts

@@ -0,0 +1,11 @@
+import type { UniversalAgentsMdOptions } from '../../../types/agents-md.js';
+/** Generates the full universal AGENTS.md content for a project using Planu SDD. */
+export declare function generateUniversalAgentsMd(options: UniversalAgentsMdOptions): string;
+/**
+ * Writes AGENTS.md to projectPath.
+ * Idempotent: replaces the planu-sdd section if it already exists,
+ * appends if the file exists without the section,
+ * or creates the file from scratch.
+ */
+export declare function writeUniversalAgentsMd(projectPath: string, options: UniversalAgentsMdOptions): void;
+//# sourceMappingURL=generator.d.ts.map

package/dist/engine/ai-integration/agents-md/generator.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"generator.d.ts","sourceRoot":"","sources":["../../../../src/engine/ai-integration/agents-md/generator.ts"],"names":[],"mappings":"AAIA,OAAO,KAAK,EAAE,wBAAwB,EAAE,MAAM,6BAA6B,CAAC;AAuI5E,oFAAoF;AACpF,wBAAgB,yBAAyB,CAAC,OAAO,EAAE,wBAAwB,GAAG,MAAM,CAEnF;AAED;;;;;GAKG;AACH,wBAAgB,sBAAsB,CACpC,WAAW,EAAE,MAAM,EACnB,OAAO,EAAE,wBAAwB,GAChC,IAAI,CAsBN"}

package/dist/engine/ai-integration/agents-md/generator.js

@@ -0,0 +1,139 @@
+// engine/ai-integration/agents-md/generator.ts — Universal AGENTS.md generator (SPEC-269)
+import { writeFileSync, readFileSync, existsSync } from 'node:fs';
+import { join } from 'node:path';
+const PLANU_SECTION_START = '<!-- planu-sdd:start -->';
+const PLANU_SECTION_END = '<!-- planu-sdd:end -->';
+function buildActiveSpecBlock(activeSpecId, activeSpecTitle) {
+    if (activeSpecId !== undefined && activeSpecTitle !== undefined) {
+        return [
+            '### Active Spec',
+            '',
+            `**${activeSpecId}**: ${activeSpecTitle}`,
+            '',
+            'Implement this spec next. Follow all criteria exactly.',
+        ].join('\n');
+    }
+    return [
+        '### Active Spec',
+        '',
+        'No active spec. Use `create_spec` to define the next feature before writing code.',
+    ].join('\n');
+}
+function buildApprovedQueueBlock(approvedSpecs) {
+    if (approvedSpecs.length === 0) {
+        return '';
+    }
+    const lines = ['### Approved Queue', ''];
+    for (const spec of approvedSpecs) {
+        lines.push(`- **${spec.id}**: ${spec.title}`);
+    }
+    lines.push('', 'Implement specs in order. Do not skip ahead.');
+    return lines.join('\n');
+}
+function buildWorkflowBlock() {
+    return [
+        '### SDD Workflow (MANDATORY)',
+        '',
+        '**Spec before code — no exceptions.**',
+        '',
+        '1. Describe the feature → Planu creates a spec via `create_spec`',
+        '2. Review + approve the spec (`update_status` → approved)',
+        '3. Implement on a `feat/SPEC-XXX-*` branch',
+        '4. Validate after implementation: `validate`',
+        '5. Merge and promote to done: `update_status` → done',
+    ].join('\n');
+}
+function buildToolsBlock() {
+    return [
+        '### Planu MCP Tools',
+        '',
+        'Compatible with 25+ AI tools (Codex, Copilot, Cursor, Windsurf, Kiro, Cline, Continue.dev, Aider).',
+        '',
+        '| Tool | Purpose |',
+        '|------|---------|',
+        '| `create_spec` | Create a new spec for a feature |',
+        '| `list_specs` | List all specs and their status |',
+        '| `update_status` | Move spec through workflow stages |',
+        '| `validate` | Check implementation against spec criteria |',
+        '| `challenge_spec` | Stress-test spec for gaps before implementation |',
+        '| `check_readiness` | Verify spec has enough detail to implement |',
+    ].join('\n');
+}
+function buildBranchBlock(branchConvention) {
+    return [
+        '### Branch Naming',
+        '',
+        '```',
+        branchConvention,
+        'fix/SPEC-XXX-bug-description      # bug fix spec',
+        '```',
+        '',
+        '- Always branch from `develop`',
+        '- Branch name must include the spec ID',
+        '- Never commit directly to `develop` or `main`',
+    ].join('\n');
+}
+function buildArchitectureBlock(options) {
+    const lines = ['### Architecture Rules'];
+    if (options.architectureStyle !== undefined && options.architectureStyle.length > 0) {
+        lines.push('', `**Style**: ${options.architectureStyle}`);
+    }
+    if (options.stack.length > 0) {
+        lines.push('', `**Stack**: ${options.stack.join(', ')}`);
+    }
+    lines.push('', '- `types/` → no imports from other layers', '- `engine/` → imports only from `types/`', '- `storage/` → imports only from `types/`', '- `tools/` → imports from `engine/` + `storage/` + `types/`', '- Cross-layer violations → ESLint error', '- Read the codebase before writing new files');
+    return lines.join('\n');
+}
+function buildSddSection(options) {
+    const branchConvention = options.branchConvention ?? 'feat/SPEC-XXX-short-description';
+    const activeSpecBlock = buildActiveSpecBlock(options.activeSpecId, options.activeSpecTitle);
+    const approvedQueueBlock = buildApprovedQueueBlock(options.approvedSpecs);
+    const workflowBlock = buildWorkflowBlock();
+    const toolsBlock = buildToolsBlock();
+    const branchBlock = buildBranchBlock(branchConvention);
+    const architectureBlock = buildArchitectureBlock(options);
+    const parts = [
+        PLANU_SECTION_START,
+        '',
+        `## Planu SDD — ${options.projectName}`,
+        '',
+        workflowBlock,
+        '',
+        activeSpecBlock,
+    ];
+    if (approvedQueueBlock.length > 0) {
+        parts.push('', approvedQueueBlock);
+    }
+    parts.push('', toolsBlock, '', branchBlock, '', architectureBlock, '', PLANU_SECTION_END);
+    return parts.join('\n');
+}
+/** Generates the full universal AGENTS.md content for a project using Planu SDD. */
+export function generateUniversalAgentsMd(options) {
+    return buildSddSection(options);
+}
+/**
+ * Writes AGENTS.md to projectPath.
+ * Idempotent: replaces the planu-sdd section if it already exists,
+ * appends if the file exists without the section,
+ * or creates the file from scratch.
+ */
+export function writeUniversalAgentsMd(projectPath, options) {
+    const filePath = join(projectPath, 'AGENTS.md');
+    const newSection = buildSddSection(options);
+    if (!existsSync(filePath)) {
+        writeFileSync(filePath, newSection + '\n', 'utf8');
+        return;
+    }
+    const existing = readFileSync(filePath, 'utf8');
+    const startIdx = existing.indexOf(PLANU_SECTION_START);
+    const endIdx = existing.indexOf(PLANU_SECTION_END);
+    if (startIdx === -1 || endIdx === -1) {
+        const separator = existing.endsWith('\n') ? '' : '\n';
+        writeFileSync(filePath, existing + separator + newSection + '\n', 'utf8');
+        return;
+    }
+    const before = existing.slice(0, startIdx);
+    const after = existing.slice(endIdx + PLANU_SECTION_END.length);
+    writeFileSync(filePath, before + newSection + after, 'utf8');
+}
+//# sourceMappingURL=generator.js.map

package/dist/engine/ai-integration/agents-md/generator.js.map

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

package/dist/engine/ai-integration/agents-md/index.d.ts

@@ -0,0 +1,3 @@
+export { generateUniversalAgentsMd, writeUniversalAgentsMd } from './generator.js';
+export { hasAgentsMd, updateAgentsMdSection } from './updater.js';
+//# sourceMappingURL=index.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../../src/engine/ai-integration/agents-md/index.ts"],"names":[],"mappings":"AAEA,OAAO,EAAE,yBAAyB,EAAE,sBAAsB,EAAE,MAAM,gBAAgB,CAAC;AACnF,OAAO,EAAE,WAAW,EAAE,qBAAqB,EAAE,MAAM,cAAc,CAAC"}

package/dist/engine/ai-integration/agents-md/index.js

@@ -0,0 +1,4 @@
+// engine/ai-integration/agents-md/index.ts — barrel (SPEC-269)
+export { generateUniversalAgentsMd, writeUniversalAgentsMd } from './generator.js';
+export { hasAgentsMd, updateAgentsMdSection } from './updater.js';
+//# sourceMappingURL=index.js.map

package/dist/engine/ai-integration/agents-md/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../../src/engine/ai-integration/agents-md/index.ts"],"names":[],"mappings":"AAAA,+DAA+D;AAE/D,OAAO,EAAE,yBAAyB,EAAE,sBAAsB,EAAE,MAAM,gBAAgB,CAAC;AACnF,OAAO,EAAE,WAAW,EAAE,qBAAqB,EAAE,MAAM,cAAc,CAAC"}

package/dist/engine/ai-integration/agents-md/updater.d.ts

@@ -0,0 +1,10 @@
+/** Returns true if AGENTS.md exists in the given project directory. */
+export declare function hasAgentsMd(projectPath: string): boolean;
+/**
+ * Updates the planu-sdd section in an existing AGENTS.md file without overwriting user content.
+ * If the file does not exist, it creates it with the new content.
+ * If the file exists but has no planu-sdd markers, the section is appended.
+ * If the file has existing markers, only the marked section is replaced.
+ */
+export declare function updateAgentsMdSection(filePath: string, newContent: string): void;
+//# sourceMappingURL=updater.d.ts.map

package/dist/engine/ai-integration/agents-md/updater.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"updater.d.ts","sourceRoot":"","sources":["../../../../src/engine/ai-integration/agents-md/updater.ts"],"names":[],"mappings":"AAQA,uEAAuE;AACvE,wBAAgB,WAAW,CAAC,WAAW,EAAE,MAAM,GAAG,OAAO,CAExD;AAED;;;;;GAKG;AACH,wBAAgB,qBAAqB,CAAC,QAAQ,EAAE,MAAM,EAAE,UAAU,EAAE,MAAM,GAAG,IAAI,CAmBhF"}

package/dist/engine/ai-integration/agents-md/updater.js

@@ -0,0 +1,33 @@
+// engine/ai-integration/agents-md/updater.ts — AGENTS.md section updater (SPEC-269)
+import { writeFileSync, readFileSync, existsSync } from 'node:fs';
+import { join } from 'node:path';
+const PLANU_SECTION_START = '<!-- planu-sdd:start -->';
+const PLANU_SECTION_END = '<!-- planu-sdd:end -->';
+/** Returns true if AGENTS.md exists in the given project directory. */
+export function hasAgentsMd(projectPath) {
+    return existsSync(join(projectPath, 'AGENTS.md'));
+}
+/**
+ * Updates the planu-sdd section in an existing AGENTS.md file without overwriting user content.
+ * If the file does not exist, it creates it with the new content.
+ * If the file exists but has no planu-sdd markers, the section is appended.
+ * If the file has existing markers, only the marked section is replaced.
+ */
+export function updateAgentsMdSection(filePath, newContent) {
+    if (!existsSync(filePath)) {
+        writeFileSync(filePath, newContent + '\n', 'utf8');
+        return;
+    }
+    const existing = readFileSync(filePath, 'utf8');
+    const startIdx = existing.indexOf(PLANU_SECTION_START);
+    const endIdx = existing.indexOf(PLANU_SECTION_END);
+    if (startIdx === -1 || endIdx === -1) {
+        const separator = existing.endsWith('\n') ? '' : '\n';
+        writeFileSync(filePath, existing + separator + newContent + '\n', 'utf8');
+        return;
+    }
+    const before = existing.slice(0, startIdx);
+    const after = existing.slice(endIdx + PLANU_SECTION_END.length);
+    writeFileSync(filePath, before + newContent + after, 'utf8');
+}
+//# sourceMappingURL=updater.js.map

package/dist/engine/ai-integration/agents-md/updater.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"updater.js","sourceRoot":"","sources":["../../../../src/engine/ai-integration/agents-md/updater.ts"],"names":[],"mappings":"AAAA,oFAAoF;AAEpF,OAAO,EAAE,aAAa,EAAE,YAAY,EAAE,UAAU,EAAE,MAAM,SAAS,CAAC;AAClE,OAAO,EAAE,IAAI,EAAE,MAAM,WAAW,CAAC;AAEjC,MAAM,mBAAmB,GAAG,0BAA0B,CAAC;AACvD,MAAM,iBAAiB,GAAG,wBAAwB,CAAC;AAEnD,uEAAuE;AACvE,MAAM,UAAU,WAAW,CAAC,WAAmB;IAC7C,OAAO,UAAU,CAAC,IAAI,CAAC,WAAW,EAAE,WAAW,CAAC,CAAC,CAAC;AACpD,CAAC;AAED;;;;;GAKG;AACH,MAAM,UAAU,qBAAqB,CAAC,QAAgB,EAAE,UAAkB;IACxE,IAAI,CAAC,UAAU,CAAC,QAAQ,CAAC,EAAE,CAAC;QAC1B,aAAa,CAAC,QAAQ,EAAE,UAAU,GAAG,IAAI,EAAE,MAAM,CAAC,CAAC;QACnD,OAAO;IACT,CAAC;IAED,MAAM,QAAQ,GAAG,YAAY,CAAC,QAAQ,EAAE,MAAM,CAAC,CAAC;IAChD,MAAM,QAAQ,GAAG,QAAQ,CAAC,OAAO,CAAC,mBAAmB,CAAC,CAAC;IACvD,MAAM,MAAM,GAAG,QAAQ,CAAC,OAAO,CAAC,iBAAiB,CAAC,CAAC;IAEnD,IAAI,QAAQ,KAAK,CAAC,CAAC,IAAI,MAAM,KAAK,CAAC,CAAC,EAAE,CAAC;QACrC,MAAM,SAAS,GAAG,QAAQ,CAAC,QAAQ,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,IAAI,CAAC;QACtD,aAAa,CAAC,QAAQ,EAAE,QAAQ,GAAG,SAAS,GAAG,UAAU,GAAG,IAAI,EAAE,MAAM,CAAC,CAAC;QAC1E,OAAO;IACT,CAAC;IAED,MAAM,MAAM,GAAG,QAAQ,CAAC,KAAK,CAAC,CAAC,EAAE,QAAQ,CAAC,CAAC;IAC3C,MAAM,KAAK,GAAG,QAAQ,CAAC,KAAK,CAAC,MAAM,GAAG,iBAAiB,CAAC,MAAM,CAAC,CAAC;IAChE,aAAa,CAAC,QAAQ,EAAE,MAAM,GAAG,UAAU,GAAG,KAAK,EAAE,MAAM,CAAC,CAAC;AAC/D,CAAC"}

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

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

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

@@ -0,0 +1 @@
+{"version":3,"file":"aider-config-generator.d.ts","sourceRoot":"","sources":["../../../../src/engine/ai-integration/aider/aider-config-generator.ts"],"names":[],"mappings":"AAGA,OAAO,KAAK,EAAE,kBAAkB,EAAE,MAAM,kCAAkC,CAAC;AAE3E,YAAY,EAAE,kBAAkB,EAAE,CAAC;AAEnC,wBAAgB,mBAAmB,CAAC,OAAO,EAAE,kBAAkB,GAAG,MAAM,CA0BvE;AAED,wBAAgB,gBAAgB,CAAC,WAAW,EAAE,MAAM,EAAE,OAAO,EAAE,kBAAkB,GAAG,IAAI,CAIvF"}

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

@@ -0,0 +1,34 @@
+// engine/ai-integration/aider/aider-config-generator.ts — .aider.conf.yml generator (SPEC-268)
+import { writeFileSync } from 'node:fs';
+import { join } from 'node:path';
+export function generateAiderConfig(options) {
+    const model = options.model ?? 'gpt-4o';
+    const autoCommits = options.autoCommits ?? false;
+    const lines = [
+        '# Aider configuration — managed by Planu (SPEC-268)',
+        '#',
+        '# Planu manages the spec-driven workflow. Aider handles implementation.',
+        '# Do not enable auto-commits — Planu controls the commit lifecycle.',
+        '',
+        `model: ${model}`,
+        `auto-commits: ${String(autoCommits)}`,
+        '',
+        '# Planu context files — always loaded for SDD awareness',
+        'read:',
+        '  - CLAUDE.md',
+        '  - planu/specs/active-spec.md',
+        '',
+        '# Conventional commits enforced by commitlint',
+        'commit-prompt: |',
+        '  Write a conventional commit message (feat/fix/docs/chore).',
+        '  Header max 100 chars. Subject required.',
+        '',
+    ];
+    return lines.join('\n');
+}
+export function writeAiderConfig(projectPath, options) {
+    const filePath = join(projectPath, '.aider.conf.yml');
+    // Idempotent: always overwrite with latest Planu-managed config
+    writeFileSync(filePath, generateAiderConfig(options), 'utf8');
+}
+//# sourceMappingURL=aider-config-generator.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"aider-config-generator.js","sourceRoot":"","sources":["../../../../src/engine/ai-integration/aider/aider-config-generator.ts"],"names":[],"mappings":"AAAA,+FAA+F;AAC/F,OAAO,EAAE,aAAa,EAAE,MAAM,SAAS,CAAC;AACxC,OAAO,EAAE,IAAI,EAAE,MAAM,WAAW,CAAC;AAKjC,MAAM,UAAU,mBAAmB,CAAC,OAA2B;IAC7D,MAAM,KAAK,GAAG,OAAO,CAAC,KAAK,IAAI,QAAQ,CAAC;IACxC,MAAM,WAAW,GAAG,OAAO,CAAC,WAAW,IAAI,KAAK,CAAC;IAEjD,MAAM,KAAK,GAAa;QACtB,qDAAqD;QACrD,GAAG;QACH,yEAAyE;QACzE,qEAAqE;QACrE,EAAE;QACF,UAAU,KAAK,EAAE;QACjB,iBAAiB,MAAM,CAAC,WAAW,CAAC,EAAE;QACtC,EAAE;QACF,yDAAyD;QACzD,OAAO;QACP,eAAe;QACf,gCAAgC;QAChC,EAAE;QACF,+CAA+C;QAC/C,kBAAkB;QAClB,8DAA8D;QAC9D,2CAA2C;QAC3C,EAAE;KACH,CAAC;IAEF,OAAO,KAAK,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;AAC1B,CAAC;AAED,MAAM,UAAU,gBAAgB,CAAC,WAAmB,EAAE,OAA2B;IAC/E,MAAM,QAAQ,GAAG,IAAI,CAAC,WAAW,EAAE,iBAAiB,CAAC,CAAC;IACtD,gEAAgE;IAChE,aAAa,CAAC,QAAQ,EAAE,mBAAmB,CAAC,OAAO,CAAC,EAAE,MAAM,CAAC,CAAC;AAChE,CAAC"}

package/dist/engine/ai-integration/cline/clinerules-generator.d.ts

@@ -0,0 +1,5 @@
+import type { ClineRulesOptions } from '../../../types/cline-integration.js';
+export type { ClineRulesOptions };
+export declare function generateClineRules(options: ClineRulesOptions): string;
+export declare function writeClineRules(projectPath: string, options: ClineRulesOptions): void;
+//# sourceMappingURL=clinerules-generator.d.ts.map

package/dist/engine/ai-integration/cline/clinerules-generator.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"clinerules-generator.d.ts","sourceRoot":"","sources":["../../../../src/engine/ai-integration/cline/clinerules-generator.ts"],"names":[],"mappings":"AAGA,OAAO,KAAK,EAAE,iBAAiB,EAAE,MAAM,qCAAqC,CAAC;AAE7E,YAAY,EAAE,iBAAiB,EAAE,CAAC;AA+DlC,wBAAgB,kBAAkB,CAAC,OAAO,EAAE,iBAAiB,GAAG,MAAM,CAUrE;AAED,wBAAgB,eAAe,CAAC,WAAW,EAAE,MAAM,EAAE,OAAO,EAAE,iBAAiB,GAAG,IAAI,CAoBrF"}

package/dist/engine/ai-integration/cline/clinerules-generator.js

@@ -0,0 +1,86 @@
+// engine/ai-integration/cline/clinerules-generator.ts — .clinerules generator (SPEC-271)
+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) {
+        const title = options.activeSpecTitle ? ` — ${options.activeSpecTitle}` : '';
+        lines.push(`### Active Spec: ${options.activeSpecId}${title}`);
+        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('### Roo Code Compatibility');
+    lines.push('');
+    lines.push('This file is compatible with Roo Code (fork of Cline).');
+    lines.push('Place in `.clinerules` at project root or in `.clinerules/` directory.');
+    lines.push('');
+    lines.push(SECTION_END);
+    return lines.join('\n');
+}
+export function generateClineRules(options) {
+    const stackStr = options.stack.length > 0 ? options.stack.join(', ') : 'Not specified';
+    const header = [
+        `# Cline Rules — ${options.projectName}`,
+        '',
+        `Stack: ${stackStr}`,
+        '',
+    ].join('\n');
+    return header + buildPlanuSection(options);
+}
+export function writeClineRules(projectPath, options) {
+    const filePath = join(projectPath, '.clinerules');
+    const planuSection = buildPlanuSection(options);
+    if (!existsSync(filePath)) {
+        writeFileSync(filePath, generateClineRules(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=clinerules-generator.js.map

package/dist/engine/ai-integration/cline/clinerules-generator.js.map

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

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

@@ -0,0 +1,3 @@
+export { generateClineRules, writeClineRules } from './clinerules-generator.js';
+export type { ClineRulesOptions } from './clinerules-generator.js';
+//# sourceMappingURL=index.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../../src/engine/ai-integration/cline/index.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,kBAAkB,EAAE,eAAe,EAAE,MAAM,2BAA2B,CAAC;AAChF,YAAY,EAAE,iBAAiB,EAAE,MAAM,2BAA2B,CAAC"}

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

@@ -0,0 +1,3 @@
+// engine/ai-integration/cline/index.ts — barrel (SPEC-271)
+export { generateClineRules, writeClineRules } from './clinerules-generator.js';
+//# sourceMappingURL=index.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../../src/engine/ai-integration/cline/index.ts"],"names":[],"mappings":"AAAA,2DAA2D;AAC3D,OAAO,EAAE,kBAAkB,EAAE,eAAe,EAAE,MAAM,2BAA2B,CAAC"}