@planu/cli 0.91.0 → 0.93.0

package/dist/engine/ai-integration/gemini/settings-generator.js

@@ -0,0 +1,191 @@
+// engine/ai-integration/gemini/settings-generator.ts — Gemini settings generator (SPEC-267)
+import { writeFileSync, mkdirSync, existsSync, readFileSync } from 'node:fs';
+import { join } from 'node:path';
+const HOOK_SCRIPTS_DIR = '.gemini/hooks';
+// Shell scripts stored as plain strings — bash $ chars must NOT be template-interpolated
+const HOOK_SCRIPT_SESSION_START = [
+    '#!/usr/bin/env bash',
+    '# Injected by Planu — session-start.sh',
+    'BRANCH=$(git rev-parse --abbrev-ref HEAD 2>/dev/null || echo "")',
+    'SPEC=$(echo "$BRANCH" | grep -oE \'SPEC-[0-9]+\' || echo "")',
+    'if [ -n "$SPEC" ]; then',
+    '  echo "Active spec: $SPEC | Branch: $BRANCH"',
+    'else',
+    '  echo "No active spec branch. Create a spec first."',
+    'fi',
+].join('\n');
+const HOOK_SCRIPT_SESSION_END = [
+    '#!/usr/bin/env bash',
+    '# session-end.sh — auto-commit planu/ changes',
+    'if git diff --quiet HEAD -- planu/ 2>/dev/null; then',
+    '  exit 0',
+    'fi',
+    'git add planu/ && git commit -m "chore: auto-save planu session state" --no-verify 2>/dev/null || true',
+].join('\n');
+const HOOK_SCRIPT_BEFORE_AGENT = [
+    '#!/usr/bin/env bash',
+    '# before-agent.sh — inject active spec context',
+    'BRANCH=$(git rev-parse --abbrev-ref HEAD 2>/dev/null || echo "")',
+    'SPEC=$(echo "$BRANCH" | grep -oE \'SPEC-[0-9]+\' || echo "")',
+    '[ -n "$SPEC" ] && echo "Spec in scope: $SPEC" || echo "No spec branch active."',
+].join('\n');
+const HOOK_SCRIPT_NOOP = [
+    '#!/usr/bin/env bash',
+    '# noop.sh — placeholder for future hooks',
+    'exit 0',
+].join('\n');
+const HOOK_SCRIPT_BEFORE_TOOL_SELECTION = [
+    '#!/usr/bin/env bash',
+    '# before-tool-selection.sh — warn if no spec branch for write ops',
+    'BRANCH=$(git rev-parse --abbrev-ref HEAD 2>/dev/null || echo "")',
+    'if echo "$BRANCH" | grep -qE \'feat/SPEC-|fix/SPEC-\'; then',
+    '  exit 0',
+    'fi',
+    'echo "WARNING: No spec branch active. Writing code without a spec is discouraged."',
+].join('\n');
+const HOOK_SCRIPT_BEFORE_TOOL = [
+    '#!/usr/bin/env bash',
+    '# before-tool.sh — scan for destructive operations',
+    'TOOL_NAME="${TOOL_NAME:-}"',
+    'if echo "$TOOL_NAME" | grep -qiE \'delete|remove|drop|truncate\'; then',
+    '  echo "WARNING: Destructive operation detected: $TOOL_NAME"',
+    'fi',
+].join('\n');
+const HOOK_SCRIPT_AFTER_TOOL = [
+    '#!/usr/bin/env bash',
+    '# after-tool.sh — verify spec when modifying src/',
+    'TOOL_INPUT="${TOOL_INPUT:-}"',
+    'if echo "$TOOL_INPUT" | grep -q \'src/\'; then',
+    '  BRANCH=$(git rev-parse --abbrev-ref HEAD 2>/dev/null || echo "")',
+    '  if ! echo "$BRANCH" | grep -qE \'feat/SPEC-|fix/SPEC-\'; then',
+    '    echo "NOTICE: src/ modified outside a spec branch."',
+    '  fi',
+    'fi',
+].join('\n');
+const HOOK_SCRIPT_PRE_COMPRESS = [
+    '#!/usr/bin/env bash',
+    '# pre-compress.sh — trigger session_checkpoint',
+    'echo "Session checkpoint triggered before context compression."',
+].join('\n');
+const HOOK_SCRIPT_NOTIFICATION = [
+    '#!/usr/bin/env bash',
+    '# notification.sh — show approved specs queue when idle',
+    'echo "Planu queue: run \'list_specs --status approved\' to see pending specs."',
+].join('\n');
+function buildHooks() {
+    return [
+        {
+            event: 'SessionStart',
+            command: `bash ${HOOK_SCRIPTS_DIR}/session-start.sh`,
+            timeout: 5000,
+        },
+        {
+            event: 'SessionEnd',
+            command: `bash ${HOOK_SCRIPTS_DIR}/session-end.sh`,
+            timeout: 10000,
+        },
+        {
+            event: 'BeforeAgent',
+            command: `bash ${HOOK_SCRIPTS_DIR}/before-agent.sh`,
+            timeout: 5000,
+        },
+        {
+            event: 'AfterAgent',
+            command: `bash ${HOOK_SCRIPTS_DIR}/noop.sh`,
+            timeout: 1000,
+        },
+        {
+            event: 'BeforeModel',
+            command: `bash ${HOOK_SCRIPTS_DIR}/noop.sh`,
+            timeout: 1000,
+        },
+        {
+            event: 'AfterModel',
+            command: `bash ${HOOK_SCRIPTS_DIR}/noop.sh`,
+            timeout: 1000,
+        },
+        {
+            event: 'BeforeToolSelection',
+            command: `bash ${HOOK_SCRIPTS_DIR}/before-tool-selection.sh`,
+            timeout: 3000,
+        },
+        {
+            event: 'BeforeTool',
+            command: `bash ${HOOK_SCRIPTS_DIR}/before-tool.sh`,
+            timeout: 3000,
+        },
+        {
+            event: 'AfterTool',
+            command: `bash ${HOOK_SCRIPTS_DIR}/after-tool.sh`,
+            timeout: 3000,
+        },
+        {
+            event: 'PreCompress',
+            command: `bash ${HOOK_SCRIPTS_DIR}/pre-compress.sh`,
+            timeout: 10000,
+        },
+        {
+            event: 'Notification',
+            command: `bash ${HOOK_SCRIPTS_DIR}/notification.sh`,
+            timeout: 3000,
+        },
+    ];
+}
+function buildHookScripts() {
+    return {
+        'session-start.sh': HOOK_SCRIPT_SESSION_START,
+        'session-end.sh': HOOK_SCRIPT_SESSION_END,
+        'before-agent.sh': HOOK_SCRIPT_BEFORE_AGENT,
+        'noop.sh': HOOK_SCRIPT_NOOP,
+        'before-tool-selection.sh': HOOK_SCRIPT_BEFORE_TOOL_SELECTION,
+        'before-tool.sh': HOOK_SCRIPT_BEFORE_TOOL,
+        'after-tool.sh': HOOK_SCRIPT_AFTER_TOOL,
+        'pre-compress.sh': HOOK_SCRIPT_PRE_COMPRESS,
+        'notification.sh': HOOK_SCRIPT_NOTIFICATION,
+    };
+}
+export function generateGeminiSettings(_projectPath) {
+    return {
+        hooks: buildHooks(),
+    };
+}
+export function writeGeminiSettings(projectPath) {
+    const geminiDir = join(projectPath, '.gemini');
+    const hooksDir = join(projectPath, HOOK_SCRIPTS_DIR);
+    /* v8 ignore start */
+    if (!existsSync(geminiDir)) {
+        mkdirSync(geminiDir, { recursive: true });
+    }
+    if (!existsSync(hooksDir)) {
+        mkdirSync(hooksDir, { recursive: true });
+    }
+    /* v8 ignore stop */
+    const settingsPath = join(geminiDir, 'settings.json');
+    const settings = generateGeminiSettings(projectPath);
+    let existing = {};
+    /* v8 ignore start */
+    if (existsSync(settingsPath)) {
+        try {
+            existing = JSON.parse(readFileSync(settingsPath, 'utf8'));
+        }
+        catch {
+            // ignore malformed JSON — overwrite
+        }
+    }
+    /* v8 ignore stop */
+    const merged = {
+        ...existing,
+        hooks: settings.hooks,
+    };
+    writeFileSync(settingsPath, JSON.stringify(merged, null, 2) + '\n', 'utf8');
+    const scripts = buildHookScripts();
+    for (const [filename, content] of Object.entries(scripts)) {
+        const scriptPath = join(hooksDir, filename);
+        /* v8 ignore start */
+        if (!existsSync(scriptPath)) {
+            writeFileSync(scriptPath, content, { encoding: 'utf8', mode: 0o755 });
+        }
+        /* v8 ignore stop */
+    }
+}
+//# sourceMappingURL=settings-generator.js.map

package/dist/engine/ai-integration/gemini/settings-generator.js.map

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

package/dist/engine/ai-integration/github-copilot/index.d.ts

@@ -0,0 +1,4 @@
+export { generateCopilotInstructions, writeCopilotInstructions, } from './instructions-generator.js';
+export { generatePromptFiles, writePromptFiles } from './prompt-files-generator.js';
+export { generateCopilotIssueBody } from './workspace-bridge.js';
+//# sourceMappingURL=index.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../../src/engine/ai-integration/github-copilot/index.ts"],"names":[],"mappings":"AAEA,OAAO,EACL,2BAA2B,EAC3B,wBAAwB,GACzB,MAAM,6BAA6B,CAAC;AAErC,OAAO,EAAE,mBAAmB,EAAE,gBAAgB,EAAE,MAAM,6BAA6B,CAAC;AAEpF,OAAO,EAAE,wBAAwB,EAAE,MAAM,uBAAuB,CAAC"}

package/dist/engine/ai-integration/github-copilot/index.js

@@ -0,0 +1,5 @@
+// engine/ai-integration/github-copilot/index.ts — barrel (SPEC-272)
+export { generateCopilotInstructions, writeCopilotInstructions, } from './instructions-generator.js';
+export { generatePromptFiles, writePromptFiles } from './prompt-files-generator.js';
+export { generateCopilotIssueBody } from './workspace-bridge.js';
+//# sourceMappingURL=index.js.map

package/dist/engine/ai-integration/github-copilot/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../../src/engine/ai-integration/github-copilot/index.ts"],"names":[],"mappings":"AAAA,oEAAoE;AAEpE,OAAO,EACL,2BAA2B,EAC3B,wBAAwB,GACzB,MAAM,6BAA6B,CAAC;AAErC,OAAO,EAAE,mBAAmB,EAAE,gBAAgB,EAAE,MAAM,6BAA6B,CAAC;AAEpF,OAAO,EAAE,wBAAwB,EAAE,MAAM,uBAAuB,CAAC"}

package/dist/engine/ai-integration/github-copilot/instructions-generator.d.ts

@@ -0,0 +1,5 @@
+import type { CopilotInstructionsOptions } from '../../../types/github-copilot-integration.js';
+export type { CopilotInstructionsOptions };
+export declare function generateCopilotInstructions(options: CopilotInstructionsOptions): string;
+export declare function writeCopilotInstructions(projectPath: string, options: CopilotInstructionsOptions): void;
+//# sourceMappingURL=instructions-generator.d.ts.map

package/dist/engine/ai-integration/github-copilot/instructions-generator.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"instructions-generator.d.ts","sourceRoot":"","sources":["../../../../src/engine/ai-integration/github-copilot/instructions-generator.ts"],"names":[],"mappings":"AAKA,OAAO,KAAK,EAAE,0BAA0B,EAAE,MAAM,8CAA8C,CAAC;AAE/F,YAAY,EAAE,0BAA0B,EAAE,CAAC;AAwE3C,wBAAgB,2BAA2B,CAAC,OAAO,EAAE,0BAA0B,GAAG,MAAM,CAavF;AAED,wBAAgB,wBAAwB,CACtC,WAAW,EAAE,MAAM,EACnB,OAAO,EAAE,0BAA0B,GAClC,IAAI,CAyBN"}

package/dist/engine/ai-integration/github-copilot/instructions-generator.js

@@ -0,0 +1,102 @@
+// engine/ai-integration/github-copilot/instructions-generator.ts — .github/copilot-instructions.md generator (SPEC-272)
+import { mkdirSync, 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('### Full SDD Flow');
+    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 exactly');
+    lines.push('5. Validate: `mcp__planu__validate`');
+    lines.push('6. Mark done: `mcp__planu__update_status`');
+    lines.push('');
+    lines.push('### Key Planu MCP Commands');
+    lines.push('');
+    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('- `mcp__planu__planu_status` — Show active spec, git state, and pending queue');
+    lines.push('');
+    lines.push('### Branch Convention');
+    lines.push('');
+    lines.push('```');
+    lines.push('feat/SPEC-XXX-short-description → develop → main');
+    lines.push('```');
+    lines.push('');
+    if (options.activeSpecId) {
+        const titlePart = options.activeSpecTitle ? ` — ${options.activeSpecTitle}` : '';
+        lines.push(`### Active Spec: ${options.activeSpecId}${titlePart}`);
+        lines.push('');
+        lines.push('Implement this spec next. Follow all acceptance 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('### Architectural Rules');
+    lines.push('');
+    lines.push('- `types/` has no imports from any other layer');
+    lines.push('- `engine/` imports only from `types/`');
+    lines.push('- `storage/` imports only from `types/`');
+    lines.push('- `tools/` imports from `engine/`, `storage/`, and `types/`');
+    lines.push('- Cross-layer violations are ESLint errors — do not bypass');
+    lines.push('');
+    lines.push(SECTION_END);
+    return lines.join('\n');
+}
+export function generateCopilotInstructions(options) {
+    const stackStr = options.stack.length > 0 ? options.stack.join(', ') : 'Not specified';
+    const header = [
+        `# GitHub Copilot Instructions — ${options.projectName}`,
+        '',
+        `Stack: ${stackStr}`,
+        '',
+        'This file provides workspace-level instructions for GitHub Copilot.',
+        'Instructions in the `<!-- planu-sdd:start -->` block are auto-managed by Planu.',
+        '',
+    ].join('\n');
+    return header + buildPlanuSection(options);
+}
+export function writeCopilotInstructions(projectPath, options) {
+    const githubDir = join(projectPath, '.github');
+    mkdirSync(githubDir, { recursive: true });
+    const filePath = join(githubDir, 'copilot-instructions.md');
+    const planuSection = buildPlanuSection(options);
+    /* v8 ignore start */
+    if (!existsSync(filePath)) {
+        writeFileSync(filePath, generateCopilotInstructions(options), 'utf8');
+        return;
+    }
+    /* v8 ignore stop */
+    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=instructions-generator.js.map

package/dist/engine/ai-integration/github-copilot/instructions-generator.js.map

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

package/dist/engine/ai-integration/github-copilot/prompt-files-generator.d.ts

@@ -0,0 +1,11 @@
+import type { CopilotPromptFile } from '../../../types/github-copilot-integration.js';
+export type { CopilotPromptFile };
+export declare function generatePromptFiles(options: {
+    projectName: string;
+    activeSpecId?: string;
+}): CopilotPromptFile[];
+export declare function writePromptFiles(projectPath: string, options: {
+    projectName: string;
+    activeSpecId?: string;
+}): void;
+//# sourceMappingURL=prompt-files-generator.d.ts.map

package/dist/engine/ai-integration/github-copilot/prompt-files-generator.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"prompt-files-generator.d.ts","sourceRoot":"","sources":["../../../../src/engine/ai-integration/github-copilot/prompt-files-generator.ts"],"names":[],"mappings":"AAKA,OAAO,KAAK,EAAE,iBAAiB,EAAE,MAAM,8CAA8C,CAAC;AAEtF,YAAY,EAAE,iBAAiB,EAAE,CAAC;AA4ElC,wBAAgB,mBAAmB,CAAC,OAAO,EAAE;IAC3C,WAAW,EAAE,MAAM,CAAC;IACpB,YAAY,CAAC,EAAE,MAAM,CAAC;CACvB,GAAG,iBAAiB,EAAE,CAMtB;AAED,wBAAgB,gBAAgB,CAC9B,WAAW,EAAE,MAAM,EACnB,OAAO,EAAE;IAAE,WAAW,EAAE,MAAM,CAAC;IAAC,YAAY,CAAC,EAAE,MAAM,CAAA;CAAE,GACtD,IAAI,CASN"}

package/dist/engine/ai-integration/github-copilot/prompt-files-generator.js

@@ -0,0 +1,86 @@
+// engine/ai-integration/github-copilot/prompt-files-generator.ts — .github/prompts/*.prompt.md generator (SPEC-272)
+import { mkdirSync, writeFileSync } from 'node:fs';
+import { join } from 'node:path';
+function buildCreateSpecPrompt(projectName, activeSpecId) {
+    const activeNote = activeSpecId !== undefined
+        ? `\nNote: There is currently an active spec (${activeSpecId}). Consider implementing it before creating a new one.\n`
+        : '';
+    const content = `---
+mode: agent
+description: Trigger the Planu create_spec workflow to define a new feature spec
+---
+Use the \`mcp__planu__create_spec\` tool for the **${projectName}** project.
+
+Pass the user's description as the \`description\` parameter.${activeNote}
+Always wait for user approval before implementing. The spec is a contract — implementation starts only after approval.
+
+After creation, suggest running \`mcp__planu__challenge_spec\` to stress-test the spec.
+`;
+    return {
+        name: 'create-spec',
+        filePath: '.github/prompts/create-spec.prompt.md',
+        content,
+        mode: 'agent',
+        description: 'Trigger create_spec workflow in Planu',
+    };
+}
+function buildValidateSpecPrompt() {
+    const content = `---
+mode: agent
+description: Trigger the Planu validate workflow to check implementation against spec criteria
+---
+Use the \`mcp__planu__validate\` tool with the current project path.
+
+Report any compliance gaps found. For each gap:
+1. Show which acceptance criterion is not met
+2. Suggest what needs to be changed
+
+If all criteria pass, suggest running \`mcp__planu__update_status\` to mark the spec as done.
+`;
+    return {
+        name: 'validate-spec',
+        filePath: '.github/prompts/validate-spec.prompt.md',
+        content,
+        mode: 'agent',
+        description: 'Trigger validate workflow to check spec compliance',
+    };
+}
+function buildSpecStatusPrompt() {
+    const content = `---
+mode: ask
+description: Show current Planu project status including active spec, git state, and pending queue
+---
+Use the \`mcp__planu__planu_status\` tool with the current project path.
+
+Present the results in a concise summary:
+- **Active spec**: ID and title of the spec currently being implemented
+- **Git state**: current branch and whether it matches the active spec
+- **Pending queue**: approved specs waiting to be implemented
+
+If there is no active spec, suggest the next approved spec in the queue.
+`;
+    return {
+        name: 'spec-status',
+        filePath: '.github/prompts/spec-status.prompt.md',
+        content,
+        mode: 'ask',
+        description: 'Show Planu project status with active spec and queue',
+    };
+}
+export function generatePromptFiles(options) {
+    return [
+        buildCreateSpecPrompt(options.projectName, options.activeSpecId),
+        buildValidateSpecPrompt(),
+        buildSpecStatusPrompt(),
+    ];
+}
+export function writePromptFiles(projectPath, options) {
+    const promptsDir = join(projectPath, '.github', 'prompts');
+    mkdirSync(promptsDir, { recursive: true });
+    const files = generatePromptFiles(options);
+    for (const file of files) {
+        const filePath = join(promptsDir, `${file.name}.prompt.md`);
+        writeFileSync(filePath, file.content, 'utf8');
+    }
+}
+//# sourceMappingURL=prompt-files-generator.js.map

package/dist/engine/ai-integration/github-copilot/prompt-files-generator.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"prompt-files-generator.js","sourceRoot":"","sources":["../../../../src/engine/ai-integration/github-copilot/prompt-files-generator.ts"],"names":[],"mappings":"AAAA,oHAAoH;AAEpH,OAAO,EAAE,SAAS,EAAE,aAAa,EAAE,MAAM,SAAS,CAAC;AACnD,OAAO,EAAE,IAAI,EAAE,MAAM,WAAW,CAAC;AAMjC,SAAS,qBAAqB,CAAC,WAAmB,EAAE,YAAqB;IACvE,MAAM,UAAU,GACd,YAAY,KAAK,SAAS;QACxB,CAAC,CAAC,8CAA8C,YAAY,0DAA0D;QACtH,CAAC,CAAC,EAAE,CAAC;IAET,MAAM,OAAO,GAAG;;;;qDAImC,WAAW;;+DAED,UAAU;;;;CAIxE,CAAC;IAEA,OAAO;QACL,IAAI,EAAE,aAAa;QACnB,QAAQ,EAAE,uCAAuC;QACjD,OAAO;QACP,IAAI,EAAE,OAAO;QACb,WAAW,EAAE,uCAAuC;KACrD,CAAC;AACJ,CAAC;AAED,SAAS,uBAAuB;IAC9B,MAAM,OAAO,GAAG;;;;;;;;;;;CAWjB,CAAC;IAEA,OAAO;QACL,IAAI,EAAE,eAAe;QACrB,QAAQ,EAAE,yCAAyC;QACnD,OAAO;QACP,IAAI,EAAE,OAAO;QACb,WAAW,EAAE,oDAAoD;KAClE,CAAC;AACJ,CAAC;AAED,SAAS,qBAAqB;IAC5B,MAAM,OAAO,GAAG;;;;;;;;;;;;CAYjB,CAAC;IAEA,OAAO;QACL,IAAI,EAAE,aAAa;QACnB,QAAQ,EAAE,uCAAuC;QACjD,OAAO;QACP,IAAI,EAAE,KAAK;QACX,WAAW,EAAE,sDAAsD;KACpE,CAAC;AACJ,CAAC;AAED,MAAM,UAAU,mBAAmB,CAAC,OAGnC;IACC,OAAO;QACL,qBAAqB,CAAC,OAAO,CAAC,WAAW,EAAE,OAAO,CAAC,YAAY,CAAC;QAChE,uBAAuB,EAAE;QACzB,qBAAqB,EAAE;KACxB,CAAC;AACJ,CAAC;AAED,MAAM,UAAU,gBAAgB,CAC9B,WAAmB,EACnB,OAAuD;IAEvD,MAAM,UAAU,GAAG,IAAI,CAAC,WAAW,EAAE,SAAS,EAAE,SAAS,CAAC,CAAC;IAC3D,SAAS,CAAC,UAAU,EAAE,EAAE,SAAS,EAAE,IAAI,EAAE,CAAC,CAAC;IAE3C,MAAM,KAAK,GAAG,mBAAmB,CAAC,OAAO,CAAC,CAAC;IAC3C,KAAK,MAAM,IAAI,IAAI,KAAK,EAAE,CAAC;QACzB,MAAM,QAAQ,GAAG,IAAI,CAAC,UAAU,EAAE,GAAG,IAAI,CAAC,IAAI,YAAY,CAAC,CAAC;QAC5D,aAAa,CAAC,QAAQ,EAAE,IAAI,CAAC,OAAO,EAAE,MAAM,CAAC,CAAC;IAChD,CAAC;AACH,CAAC"}

package/dist/engine/ai-integration/github-copilot/workspace-bridge.d.ts

@@ -0,0 +1,3 @@
+import type { CopilotIssueSpec } from '../../../types/github-copilot-integration.js';
+export declare function generateCopilotIssueBody(spec: CopilotIssueSpec): string;
+//# sourceMappingURL=workspace-bridge.d.ts.map

package/dist/engine/ai-integration/github-copilot/workspace-bridge.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"workspace-bridge.d.ts","sourceRoot":"","sources":["../../../../src/engine/ai-integration/github-copilot/workspace-bridge.ts"],"names":[],"mappings":"AAEA,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,8CAA8C,CAAC;AAErF,wBAAgB,wBAAwB,CAAC,IAAI,EAAE,gBAAgB,GAAG,MAAM,CAyCvE"}

package/dist/engine/ai-integration/github-copilot/workspace-bridge.js

@@ -0,0 +1,39 @@
+// engine/ai-integration/github-copilot/workspace-bridge.ts — Copilot Workspace issue formatter (SPEC-272)
+export function generateCopilotIssueBody(spec) {
+    const lines = [];
+    lines.push('## Overview');
+    lines.push('');
+    lines.push(spec.description);
+    lines.push('');
+    lines.push('## Acceptance Criteria');
+    lines.push('');
+    for (const criterion of spec.acceptanceCriteria) {
+        lines.push(`- [ ] ${criterion}`);
+    }
+    lines.push('');
+    lines.push('## Implementation Notes');
+    lines.push('');
+    lines.push('This issue is linked to a Planu spec. Follow these steps:');
+    lines.push('');
+    lines.push('1. Read the full spec before writing any code');
+    lines.push('2. Implement each acceptance criterion exactly as written');
+    lines.push('3. Run `mcp__planu__validate` after implementation to verify compliance');
+    lines.push('4. Do not close this issue until all checkboxes above are checked');
+    lines.push('');
+    lines.push('## Planu Context');
+    lines.push('');
+    lines.push(`**Spec ID**: \`${spec.id}\``);
+    lines.push(`**Title**: ${spec.title}`);
+    lines.push('');
+    lines.push('To view the full spec details, run:');
+    lines.push('```');
+    lines.push(`mcp__planu__list_specs — filter by id: ${spec.id}`);
+    lines.push('```');
+    lines.push('');
+    lines.push('To validate implementation against this spec:');
+    lines.push('```');
+    lines.push('mcp__planu__validate');
+    lines.push('```');
+    return lines.join('\n');
+}
+//# sourceMappingURL=workspace-bridge.js.map

package/dist/engine/ai-integration/github-copilot/workspace-bridge.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"workspace-bridge.js","sourceRoot":"","sources":["../../../../src/engine/ai-integration/github-copilot/workspace-bridge.ts"],"names":[],"mappings":"AAAA,0GAA0G;AAI1G,MAAM,UAAU,wBAAwB,CAAC,IAAsB;IAC7D,MAAM,KAAK,GAAa,EAAE,CAAC;IAE3B,KAAK,CAAC,IAAI,CAAC,aAAa,CAAC,CAAC;IAC1B,KAAK,CAAC,IAAI,CAAC,EAAE,CAAC,CAAC;IACf,KAAK,CAAC,IAAI,CAAC,IAAI,CAAC,WAAW,CAAC,CAAC;IAC7B,KAAK,CAAC,IAAI,CAAC,EAAE,CAAC,CAAC;IAEf,KAAK,CAAC,IAAI,CAAC,wBAAwB,CAAC,CAAC;IACrC,KAAK,CAAC,IAAI,CAAC,EAAE,CAAC,CAAC;IACf,KAAK,MAAM,SAAS,IAAI,IAAI,CAAC,kBAAkB,EAAE,CAAC;QAChD,KAAK,CAAC,IAAI,CAAC,SAAS,SAAS,EAAE,CAAC,CAAC;IACnC,CAAC;IACD,KAAK,CAAC,IAAI,CAAC,EAAE,CAAC,CAAC;IAEf,KAAK,CAAC,IAAI,CAAC,yBAAyB,CAAC,CAAC;IACtC,KAAK,CAAC,IAAI,CAAC,EAAE,CAAC,CAAC;IACf,KAAK,CAAC,IAAI,CAAC,2DAA2D,CAAC,CAAC;IACxE,KAAK,CAAC,IAAI,CAAC,EAAE,CAAC,CAAC;IACf,KAAK,CAAC,IAAI,CAAC,+CAA+C,CAAC,CAAC;IAC5D,KAAK,CAAC,IAAI,CAAC,2DAA2D,CAAC,CAAC;IACxE,KAAK,CAAC,IAAI,CAAC,yEAAyE,CAAC,CAAC;IACtF,KAAK,CAAC,IAAI,CAAC,mEAAmE,CAAC,CAAC;IAChF,KAAK,CAAC,IAAI,CAAC,EAAE,CAAC,CAAC;IAEf,KAAK,CAAC,IAAI,CAAC,kBAAkB,CAAC,CAAC;IAC/B,KAAK,CAAC,IAAI,CAAC,EAAE,CAAC,CAAC;IACf,KAAK,CAAC,IAAI,CAAC,kBAAkB,IAAI,CAAC,EAAE,IAAI,CAAC,CAAC;IAC1C,KAAK,CAAC,IAAI,CAAC,cAAc,IAAI,CAAC,KAAK,EAAE,CAAC,CAAC;IACvC,KAAK,CAAC,IAAI,CAAC,EAAE,CAAC,CAAC;IACf,KAAK,CAAC,IAAI,CAAC,qCAAqC,CAAC,CAAC;IAClD,KAAK,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC;IAClB,KAAK,CAAC,IAAI,CAAC,0CAA0C,IAAI,CAAC,EAAE,EAAE,CAAC,CAAC;IAChE,KAAK,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC;IAClB,KAAK,CAAC,IAAI,CAAC,EAAE,CAAC,CAAC;IACf,KAAK,CAAC,IAAI,CAAC,+CAA+C,CAAC,CAAC;IAC5D,KAAK,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC;IAClB,KAAK,CAAC,IAAI,CAAC,sBAAsB,CAAC,CAAC;IACnC,KAAK,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC;IAElB,OAAO,KAAK,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;AAC1B,CAAC"}

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

@@ -0,0 +1,6 @@
+import type { KiroHookDefinition } from '../../../types/kiro-integration.js';
+/** Returns the standard set of Kiro hooks for Planu SDD workflow. */
+export declare function generateKiroHooks(): KiroHookDefinition[];
+/** Writes .kiro/hooks/planu-*.yaml files to the given project path */
+export declare function writeKiroHooks(projectPath: string): void;
+//# sourceMappingURL=hooks-generator.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"hooks-generator.d.ts","sourceRoot":"","sources":["../../../../src/engine/ai-integration/kiro/hooks-generator.ts"],"names":[],"mappings":"AAIA,OAAO,KAAK,EAAE,kBAAkB,EAAE,MAAM,oCAAoC,CAAC;AA0B7E,qEAAqE;AACrE,wBAAgB,iBAAiB,IAAI,kBAAkB,EAAE,CAqBxD;AAeD,sEAAsE;AACtE,wBAAgB,cAAc,CAAC,WAAW,EAAE,MAAM,GAAG,IAAI,CAcxD"}

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

@@ -0,0 +1,74 @@
+// engine/ai-integration/kiro/hooks-generator.ts — Kiro hooks generator (SPEC-270)
+import { writeFileSync, mkdirSync, existsSync } from 'node:fs';
+import { join } from 'node:path';
+const PROMPT_INJECT_SCRIPT = [
+    'SPEC=$(planu list --status=approved --compact 2>/dev/null | head -5 || echo "No approved specs");',
+    'BRANCH=$(git branch --show-current 2>/dev/null || echo "unknown");',
+    'echo "=== Planu Context ===";',
+    'echo "Branch: $BRANCH";',
+    'echo "Approved specs: $SPEC"',
+].join(' ');
+const POST_TOOL_SCRIPT = [
+    'if echo "$KIRO_TOOL_NAME" | grep -qE "write|edit|create"; then',
+    '  if echo "$KIRO_TOOL_PATH" | grep -qE "^src/"; then',
+    '    planu validate --quick 2>/dev/null || echo "Reminder: validate spec compliance after editing src/";',
+    '  fi;',
+    'fi',
+].join(' ');
+const STOP_SCRIPT = [
+    'planu session_checkpoint --auto 2>/dev/null;',
+    'if [ -d "planu/" ]; then',
+    '  git add planu/ 2>/dev/null;',
+    '  git diff --staged --quiet || git commit -m "chore: auto-save planu state [kiro]" 2>/dev/null;',
+    'fi',
+].join(' ');
+/** Returns the standard set of Kiro hooks for Planu SDD workflow. */
+export function generateKiroHooks() {
+    return [
+        {
+            id: 'planu-prompt-inject',
+            event: 'userPromptSubmit',
+            description: 'Inject active spec context into every Kiro prompt',
+            script: PROMPT_INJECT_SCRIPT,
+        },
+        {
+            id: 'planu-post-tool',
+            event: 'postToolUse',
+            description: 'Auto-validate spec compliance after file writes to src/',
+            script: POST_TOOL_SCRIPT,
+        },
+        {
+            id: 'planu-stop',
+            event: 'stop',
+            description: 'Save session checkpoint and auto-commit planu state on session end',
+            script: STOP_SCRIPT,
+        },
+    ];
+}
+function buildHookYaml(hook) {
+    const lines = [
+        `id: ${hook.id}`,
+        `event: ${hook.event}`,
+        `description: "${hook.description}"`,
+        'script: |',
+    ];
+    for (const line of hook.script.split(' ')) {
+        lines.push(`  ${line}`);
+    }
+    return lines.join('\n');
+}
+/** Writes .kiro/hooks/planu-*.yaml files to the given project path */
+export function writeKiroHooks(projectPath) {
+    const hooksDir = join(projectPath, '.kiro', 'hooks');
+    /* v8 ignore start */
+    if (!existsSync(hooksDir)) {
+        mkdirSync(hooksDir, { recursive: true });
+    }
+    /* v8 ignore stop */
+    const hooks = generateKiroHooks();
+    for (const hook of hooks) {
+        const yaml = buildHookYaml(hook);
+        writeFileSync(join(hooksDir, `${hook.id}.yaml`), yaml + '\n', 'utf8');
+    }
+}
+//# sourceMappingURL=hooks-generator.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"hooks-generator.js","sourceRoot":"","sources":["../../../../src/engine/ai-integration/kiro/hooks-generator.ts"],"names":[],"mappings":"AAAA,kFAAkF;AAElF,OAAO,EAAE,aAAa,EAAE,SAAS,EAAE,UAAU,EAAE,MAAM,SAAS,CAAC;AAC/D,OAAO,EAAE,IAAI,EAAE,MAAM,WAAW,CAAC;AAGjC,MAAM,oBAAoB,GAAG;IAC3B,mGAAmG;IACnG,oEAAoE;IACpE,+BAA+B;IAC/B,yBAAyB;IACzB,8BAA8B;CAC/B,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC;AAEZ,MAAM,gBAAgB,GAAG;IACvB,gEAAgE;IAChE,sDAAsD;IACtD,yGAAyG;IACzG,OAAO;IACP,IAAI;CACL,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC;AAEZ,MAAM,WAAW,GAAG;IAClB,8CAA8C;IAC9C,0BAA0B;IAC1B,+BAA+B;IAC/B,iGAAiG;IACjG,IAAI;CACL,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC;AAEZ,qEAAqE;AACrE,MAAM,UAAU,iBAAiB;IAC/B,OAAO;QACL;YACE,EAAE,EAAE,qBAAqB;YACzB,KAAK,EAAE,kBAAkB;YACzB,WAAW,EAAE,mDAAmD;YAChE,MAAM,EAAE,oBAAoB;SAC7B;QACD;YACE,EAAE,EAAE,iBAAiB;YACrB,KAAK,EAAE,aAAa;YACpB,WAAW,EAAE,yDAAyD;YACtE,MAAM,EAAE,gBAAgB;SACzB;QACD;YACE,EAAE,EAAE,YAAY;YAChB,KAAK,EAAE,MAAM;YACb,WAAW,EAAE,oEAAoE;YACjF,MAAM,EAAE,WAAW;SACpB;KACF,CAAC;AACJ,CAAC;AAED,SAAS,aAAa,CAAC,IAAwB;IAC7C,MAAM,KAAK,GAAG;QACZ,OAAO,IAAI,CAAC,EAAE,EAAE;QAChB,UAAU,IAAI,CAAC,KAAK,EAAE;QACtB,iBAAiB,IAAI,CAAC,WAAW,GAAG;QACpC,WAAW;KACZ,CAAC;IACF,KAAK,MAAM,IAAI,IAAI,IAAI,CAAC,MAAM,CAAC,KAAK,CAAC,GAAG,CAAC,EAAE,CAAC;QAC1C,KAAK,CAAC,IAAI,CAAC,KAAK,IAAI,EAAE,CAAC,CAAC;IAC1B,CAAC;IACD,OAAO,KAAK,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;AAC1B,CAAC;AAED,sEAAsE;AACtE,MAAM,UAAU,cAAc,CAAC,WAAmB;IAChD,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,KAAK,GAAG,iBAAiB,EAAE,CAAC;IAClC,KAAK,MAAM,IAAI,IAAI,KAAK,EAAE,CAAC;QACzB,MAAM,IAAI,GAAG,aAAa,CAAC,IAAI,CAAC,CAAC;QACjC,aAAa,CAAC,IAAI,CAAC,QAAQ,EAAE,GAAG,IAAI,CAAC,EAAE,OAAO,CAAC,EAAE,IAAI,GAAG,IAAI,EAAE,MAAM,CAAC,CAAC;IACxE,CAAC;AACH,CAAC"}

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

@@ -0,0 +1,4 @@
+export { generateKiroSteering, writeKiroSteering } from './steering-generator.js';
+export { generateKiroHooks, writeKiroHooks } from './hooks-generator.js';
+export { exportSpecToKiro, writeKiroSpec } from './spec-exporter.js';
+//# sourceMappingURL=index.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../../src/engine/ai-integration/kiro/index.ts"],"names":[],"mappings":"AAEA,OAAO,EAAE,oBAAoB,EAAE,iBAAiB,EAAE,MAAM,yBAAyB,CAAC;AAClF,OAAO,EAAE,iBAAiB,EAAE,cAAc,EAAE,MAAM,sBAAsB,CAAC;AACzE,OAAO,EAAE,gBAAgB,EAAE,aAAa,EAAE,MAAM,oBAAoB,CAAC"}

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

@@ -0,0 +1,5 @@
+// engine/ai-integration/kiro/index.ts — Kiro Compatibility Layer barrel (SPEC-270)
+export { generateKiroSteering, writeKiroSteering } from './steering-generator.js';
+export { generateKiroHooks, writeKiroHooks } from './hooks-generator.js';
+export { exportSpecToKiro, writeKiroSpec } from './spec-exporter.js';
+//# sourceMappingURL=index.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../../src/engine/ai-integration/kiro/index.ts"],"names":[],"mappings":"AAAA,mFAAmF;AAEnF,OAAO,EAAE,oBAAoB,EAAE,iBAAiB,EAAE,MAAM,yBAAyB,CAAC;AAClF,OAAO,EAAE,iBAAiB,EAAE,cAAc,EAAE,MAAM,sBAAsB,CAAC;AACzE,OAAO,EAAE,gBAAgB,EAAE,aAAa,EAAE,MAAM,oBAAoB,CAAC"}

package/dist/engine/ai-integration/kiro/spec-exporter.d.ts

@@ -0,0 +1,6 @@
+import type { KiroSpecFormat, PlanuSpec } from '../../../types/kiro-integration.js';
+/** Converts a Planu spec to Kiro format */
+export declare function exportSpecToKiro(spec: PlanuSpec): KiroSpecFormat;
+/** Writes a Kiro spec JSON to .kiro/specs/<id>.json */
+export declare function writeKiroSpec(projectPath: string, kiroSpec: KiroSpecFormat): void;
+//# sourceMappingURL=spec-exporter.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"spec-exporter.d.ts","sourceRoot":"","sources":["../../../../src/engine/ai-integration/kiro/spec-exporter.ts"],"names":[],"mappings":"AAIA,OAAO,KAAK,EAAE,cAAc,EAAE,SAAS,EAAE,MAAM,oCAAoC,CAAC;AAsCpF,2CAA2C;AAC3C,wBAAgB,gBAAgB,CAAC,IAAI,EAAE,SAAS,GAAG,cAAc,CAQhE;AAED,uDAAuD;AACvD,wBAAgB,aAAa,CAAC,WAAW,EAAE,MAAM,EAAE,QAAQ,EAAE,cAAc,GAAG,IAAI,CAWjF"}