iaip-mcp-pde 2.0.2

package/dist/index.js

@@ -0,0 +1,34 @@
+#!/usr/bin/env node
+"use strict";
+/**
+ * PDE-MCP v2 Entry Point
+ * Starts the Model Context Protocol server for Prompt Decomposition Engine.
+ *
+ * Also re-exports core engine, parser, prompts, storage for programmatic use.
+ * CLI: ./cli.ts (bin: mcp-pde)
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.startServer = exports.decompositionToMarkdown = exports.listDecompositions = exports.loadDecomposition = exports.saveDecomposition = exports.formatUserMessage = exports.buildSystemPrompt = exports.actionStackToMarkdown = exports.parseDecompositionResponse = exports.PDEParseError = exports.PdeEngine = void 0;
+const mcp_server_js_1 = require("./mcp-server.js");
+(0, mcp_server_js_1.startServer)().catch((error) => {
+    console.error('Failed to start PDE MCP server:', error);
+    process.exit(1);
+});
+// Re-export for library usage
+var pde_engine_js_1 = require("./pde-engine.js");
+Object.defineProperty(exports, "PdeEngine", { enumerable: true, get: function () { return pde_engine_js_1.PdeEngine; } });
+Object.defineProperty(exports, "PDEParseError", { enumerable: true, get: function () { return pde_engine_js_1.PDEParseError; } });
+var parser_js_1 = require("./parser.js");
+Object.defineProperty(exports, "parseDecompositionResponse", { enumerable: true, get: function () { return parser_js_1.parseDecompositionResponse; } });
+Object.defineProperty(exports, "actionStackToMarkdown", { enumerable: true, get: function () { return parser_js_1.actionStackToMarkdown; } });
+var prompts_js_1 = require("./prompts.js");
+Object.defineProperty(exports, "buildSystemPrompt", { enumerable: true, get: function () { return prompts_js_1.buildSystemPrompt; } });
+Object.defineProperty(exports, "formatUserMessage", { enumerable: true, get: function () { return prompts_js_1.formatUserMessage; } });
+var storage_js_1 = require("./storage.js");
+Object.defineProperty(exports, "saveDecomposition", { enumerable: true, get: function () { return storage_js_1.saveDecomposition; } });
+Object.defineProperty(exports, "loadDecomposition", { enumerable: true, get: function () { return storage_js_1.loadDecomposition; } });
+Object.defineProperty(exports, "listDecompositions", { enumerable: true, get: function () { return storage_js_1.listDecompositions; } });
+Object.defineProperty(exports, "decompositionToMarkdown", { enumerable: true, get: function () { return storage_js_1.decompositionToMarkdown; } });
+var mcp_server_js_2 = require("./mcp-server.js");
+Object.defineProperty(exports, "startServer", { enumerable: true, get: function () { return mcp_server_js_2.startServer; } });
+//# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":";;AACA;;;;;;GAMG;;;AAEH,mDAA8C;AAE9C,IAAA,2BAAW,GAAE,CAAC,KAAK,CAAC,CAAC,KAAK,EAAE,EAAE;IAC5B,OAAO,CAAC,KAAK,CAAC,iCAAiC,EAAE,KAAK,CAAC,CAAC;IACxD,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC;AAClB,CAAC,CAAC,CAAC;AAEH,8BAA8B;AAC9B,iDAA2D;AAAlD,0GAAA,SAAS,OAAA;AAAE,8GAAA,aAAa,OAAA;AACjC,yCAAgF;AAAvE,uHAAA,0BAA0B,OAAA;AAAE,kHAAA,qBAAqB,OAAA;AAC1D,2CAAoE;AAA3D,+GAAA,iBAAiB,OAAA;AAAE,+GAAA,iBAAiB,OAAA;AAC7C,2CAAiH;AAAxG,+GAAA,iBAAiB,OAAA;AAAE,+GAAA,iBAAiB,OAAA;AAAE,gHAAA,kBAAkB,OAAA;AAAE,qHAAA,uBAAuB,OAAA;AAC1F,iDAA8C;AAArC,4GAAA,WAAW,OAAA"}

package/dist/mcp-server.d.ts

@@ -0,0 +1,59 @@
+/**
+ * MCP Server for PDE v2
+ *
+ * Implements Model Context Protocol server with LLM-driven Prompt Decomposition Engine.
+ *
+ * Tools:
+ *   pde_decompose     - Build system prompt for LLM decomposition, or parse LLM response
+ *   pde_parse_response - Parse an LLM response into DecompositionResult and store it
+ *   pde_get            - Retrieve a stored decomposition by ID
+ *   pde_list           - List stored decompositions
+ *   pde_export_markdown - Export a decomposition as markdown
+ *
+ * Resources:
+ *   pde://schema/decomposition-result - The DecompositionResult JSON schema
+ *   pde://directions                  - Four Directions metadata
+ *
+ * Prompts:
+ *   pde-decompose - The system prompt for LLM-driven decomposition
+ */
+import { Server } from '@modelcontextprotocol/sdk/server/index.js';
+import { PdeEngine } from './pde-engine.js';
+declare const engine: PdeEngine;
+declare const server: Server<{
+    method: string;
+    params?: {
+        [x: string]: unknown;
+        _meta?: {
+            [x: string]: unknown;
+            progressToken?: string | number | undefined;
+            "io.modelcontextprotocol/related-task"?: {
+                taskId: string;
+            } | undefined;
+        } | undefined;
+    } | undefined;
+}, {
+    method: string;
+    params?: {
+        [x: string]: unknown;
+        _meta?: {
+            [x: string]: unknown;
+            progressToken?: string | number | undefined;
+            "io.modelcontextprotocol/related-task"?: {
+                taskId: string;
+            } | undefined;
+        } | undefined;
+    } | undefined;
+}, {
+    [x: string]: unknown;
+    _meta?: {
+        [x: string]: unknown;
+        progressToken?: string | number | undefined;
+        "io.modelcontextprotocol/related-task"?: {
+            taskId: string;
+        } | undefined;
+    } | undefined;
+}>;
+export declare function startServer(): Promise<void>;
+export { server, engine };
+//# sourceMappingURL=mcp-server.d.ts.map

package/dist/mcp-server.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"mcp-server.d.ts","sourceRoot":"","sources":["../src/mcp-server.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;GAkBG;AAEH,OAAO,EAAE,MAAM,EAAE,MAAM,2CAA2C,CAAC;AAWnE,OAAO,EAAE,SAAS,EAAE,MAAM,iBAAiB,CAAC;AAY5C,QAAA,MAAM,MAAM,WAAkB,CAAC;AAE/B,QAAA,MAAM,MAAM;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;EAGX,CAAC;AA0RF,wBAAsB,WAAW,IAAI,OAAO,CAAC,IAAI,CAAC,CAIjD;AAED,OAAO,EAAE,MAAM,EAAE,MAAM,EAAE,CAAC"}

package/dist/mcp-server.js

@@ -0,0 +1,293 @@
+"use strict";
+/**
+ * MCP Server for PDE v2
+ *
+ * Implements Model Context Protocol server with LLM-driven Prompt Decomposition Engine.
+ *
+ * Tools:
+ *   pde_decompose     - Build system prompt for LLM decomposition, or parse LLM response
+ *   pde_parse_response - Parse an LLM response into DecompositionResult and store it
+ *   pde_get            - Retrieve a stored decomposition by ID
+ *   pde_list           - List stored decompositions
+ *   pde_export_markdown - Export a decomposition as markdown
+ *
+ * Resources:
+ *   pde://schema/decomposition-result - The DecompositionResult JSON schema
+ *   pde://directions                  - Four Directions metadata
+ *
+ * Prompts:
+ *   pde-decompose - The system prompt for LLM-driven decomposition
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.engine = exports.server = void 0;
+exports.startServer = startServer;
+const index_js_1 = require("@modelcontextprotocol/sdk/server/index.js");
+const stdio_js_1 = require("@modelcontextprotocol/sdk/server/stdio.js");
+const types_js_1 = require("@modelcontextprotocol/sdk/types.js");
+const pde_engine_js_1 = require("./pde-engine.js");
+const types_js_2 = require("./types.js");
+const prompts_js_1 = require("./prompts.js");
+const engine = new pde_engine_js_1.PdeEngine();
+exports.engine = engine;
+const server = new index_js_1.Server({ name: 'pde-mcp', version: '2.0.0' }, { capabilities: { tools: {}, resources: {}, prompts: {} } });
+exports.server = server;
+// ============================================================================
+// Tools
+// ============================================================================
+server.setRequestHandler(types_js_1.ListToolsRequestSchema, async () => ({
+    tools: [
+        {
+            name: 'pde_decompose',
+            description: 'Build system prompt + user message for LLM-driven prompt decomposition. Send the returned systemPrompt and userMessage to your LLM, then call pde_parse_response with the result.',
+            inputSchema: {
+                type: 'object',
+                properties: {
+                    prompt: { type: 'string', description: 'The complex prompt to decompose' },
+                    options: {
+                        type: 'object',
+                        properties: {
+                            extractImplicit: { type: 'boolean', default: true, description: 'Extract implicit intents from hedging language' },
+                            mapDependencies: { type: 'boolean', default: true, description: 'Map dependencies between actions' },
+                        },
+                    },
+                    parent_pde_id: { type: 'string', description: 'UUID of parent PDE for parent-child nesting' },
+                },
+                required: ['prompt'],
+            },
+        },
+        {
+            name: 'pde_parse_response',
+            description: 'Parse an LLM response (from pde_decompose prompt) into structured DecompositionResult JSON and store it in .pde/ folder.',
+            inputSchema: {
+                type: 'object',
+                properties: {
+                    llm_response: { type: 'string', description: 'The raw LLM response text containing the DecompositionResult JSON' },
+                    original_prompt: { type: 'string', description: 'The original user prompt that was decomposed' },
+                    workdir: { type: 'string', description: 'Working directory for .pde/ storage (defaults to cwd)' },
+                    parent_pde_id: { type: 'string', description: 'UUID of parent PDE for parent-child nesting' },
+                    options: {
+                        type: 'object',
+                        properties: {
+                            extractImplicit: { type: 'boolean', default: true },
+                            mapDependencies: { type: 'boolean', default: true },
+                        },
+                    },
+                },
+                required: ['llm_response', 'original_prompt'],
+            },
+        },
+        {
+            name: 'pde_get',
+            description: 'Retrieve a stored decomposition by ID from .pde/ folder',
+            inputSchema: {
+                type: 'object',
+                properties: {
+                    id: { type: 'string', description: 'Decomposition ID' },
+                    workdir: { type: 'string', description: 'Working directory' },
+                },
+                required: ['id'],
+            },
+        },
+        {
+            name: 'pde_list',
+            description: 'List stored decompositions from .pde/ folder',
+            inputSchema: {
+                type: 'object',
+                properties: {
+                    workdir: { type: 'string', description: 'Working directory' },
+                    limit: { type: 'number', default: 10 },
+                    parent_id: { type: 'string', description: 'Filter to children of a specific parent PDE UUID' },
+                },
+            },
+        },
+        {
+            name: 'pde_export_markdown',
+            description: 'Export a stored decomposition as a git-diffable markdown document with Four Directions headers',
+            inputSchema: {
+                type: 'object',
+                properties: {
+                    id: { type: 'string', description: 'Decomposition ID' },
+                    workdir: { type: 'string', description: 'Working directory' },
+                },
+                required: ['id'],
+            },
+        },
+    ],
+}));
+server.setRequestHandler(types_js_1.CallToolRequestSchema, async (request) => {
+    const { name, arguments: args } = request.params;
+    try {
+        switch (name) {
+            case 'pde_decompose': {
+                const input = args;
+                if (!input?.prompt) {
+                    return { content: [{ type: 'text', text: 'Missing required parameter: prompt' }], isError: true };
+                }
+                const { systemPrompt, userMessage } = engine.buildPrompt(input.prompt, input.options);
+                return {
+                    content: [{
+                            type: 'text',
+                            text: JSON.stringify({
+                                instructions: 'Send systemPrompt as system message and userMessage as user message to your LLM. Then call pde_parse_response with the LLM output.',
+                                systemPrompt,
+                                userMessage,
+                                original_prompt: input.prompt,
+                                ...(input.parent_pde_id ? { parent_pde_id: input.parent_pde_id } : {}),
+                            }, null, 2),
+                        }],
+                };
+            }
+            case 'pde_parse_response': {
+                const { llm_response, original_prompt, workdir, options, parent_pde_id } = args;
+                if (!llm_response || !original_prompt) {
+                    return { content: [{ type: 'text', text: 'Missing required: llm_response and original_prompt' }], isError: true };
+                }
+                const stored = engine.parseAndStore(llm_response, original_prompt, options, workdir, parent_pde_id);
+                return {
+                    content: [{ type: 'text', text: JSON.stringify(stored, null, 2) }],
+                };
+            }
+            case 'pde_get': {
+                const { id, workdir } = args;
+                const stored = engine.get(id, workdir);
+                if (!stored) {
+                    return { content: [{ type: 'text', text: `Decomposition ${id} not found` }], isError: true };
+                }
+                return { content: [{ type: 'text', text: JSON.stringify(stored, null, 2) }] };
+            }
+            case 'pde_list': {
+                const { workdir, limit, parent_id } = (args || {});
+                const items = parent_id
+                    ? engine.listChildren(parent_id, workdir)
+                    : engine.list(workdir, limit);
+                const limited = limit && !parent_id ? items.slice(0, limit) : items;
+                const summary = limited.map(d => ({
+                    id: d.id,
+                    timestamp: d.timestamp,
+                    primaryAction: `${d.result.primary.action} ${d.result.primary.target}`,
+                    secondaryCount: d.result.secondary.length,
+                    ambiguityCount: d.result.ambiguities.length,
+                    actionStackCount: d.result.actionStack.length,
+                    ...(d.parent_pde_id ? { parent_pde_id: d.parent_pde_id } : {}),
+                    ...(d.folder_name ? { folder_name: d.folder_name } : {}),
+                }));
+                return { content: [{ type: 'text', text: JSON.stringify(summary, null, 2) }] };
+            }
+            case 'pde_export_markdown': {
+                const { id, workdir } = args;
+                const md = engine.exportMarkdown(id, workdir);
+                if (!md) {
+                    return { content: [{ type: 'text', text: `Decomposition ${id} not found` }], isError: true };
+                }
+                return { content: [{ type: 'text', text: md }] };
+            }
+            default:
+                return { content: [{ type: 'text', text: `Unknown tool: ${name}` }], isError: true };
+        }
+    }
+    catch (error) {
+        return {
+            content: [{ type: 'text', text: `Error: ${error instanceof Error ? error.message : String(error)}` }],
+            isError: true,
+        };
+    }
+});
+// ============================================================================
+// Resources
+// ============================================================================
+server.setRequestHandler(types_js_1.ListResourcesRequestSchema, async () => ({
+    resources: [
+        {
+            uri: 'pde://schema/decomposition-result',
+            name: 'DecompositionResult Schema',
+            description: 'The canonical JSON schema for prompt decomposition output (primary/secondary intents, context, directions, action stack, ambiguities)',
+            mimeType: 'application/json',
+        },
+        {
+            uri: 'pde://directions',
+            name: 'Four Directions',
+            description: 'Medicine Wheel direction metadata: EAST=Vision, SOUTH=Analysis, WEST=Validation, NORTH=Action',
+            mimeType: 'application/json',
+        },
+    ],
+}));
+server.setRequestHandler(types_js_1.ReadResourceRequestSchema, async (request) => {
+    const { uri } = request.params;
+    switch (uri) {
+        case 'pde://schema/decomposition-result':
+            return {
+                contents: [{
+                        uri,
+                        mimeType: 'application/json',
+                        text: JSON.stringify({
+                            description: 'DecompositionResult — the output of PDE prompt decomposition',
+                            schema: {
+                                primary: { action: 'string', target: 'string', urgency: 'immediate|session|persistent', confidence: '0.0-1.0' },
+                                secondary: [{ action: 'string', target: 'string', implicit: 'boolean', dependency: 'string|null', confidence: '0.0-1.0' }],
+                                context: { files_needed: ['string'], tools_required: ['string'], assumptions: ['string'] },
+                                outputs: { artifacts: ['string'], updates: ['string'], communications: ['string'] },
+                                directions: { east: [{ text: 'string', confidence: '0.0-1.0', implicit: 'boolean' }], south: '...', west: '...', north: '...' },
+                                actionStack: [{ text: 'string', direction: 'east|south|west|north', dependency: 'string|null', completed: 'boolean' }],
+                                ambiguities: [{ text: 'string', suggestion: 'string' }],
+                            },
+                        }, null, 2),
+                    }],
+            };
+        case 'pde://directions':
+            return {
+                contents: [{
+                        uri,
+                        mimeType: 'application/json',
+                        text: JSON.stringify(types_js_2.DIRECTION_META, null, 2),
+                    }],
+            };
+        default:
+            throw new Error(`Unknown resource: ${uri}`);
+    }
+});
+// ============================================================================
+// Prompts
+// ============================================================================
+server.setRequestHandler(types_js_1.ListPromptsRequestSchema, async () => ({
+    prompts: [
+        {
+            name: 'pde-decompose',
+            description: 'System prompt for LLM-driven prompt decomposition. Returns system + user messages to send to your LLM.',
+            arguments: [
+                { name: 'userPrompt', description: 'The prompt to decompose', required: true },
+                { name: 'extractImplicit', description: 'Extract implicit intents (default: true)', required: false },
+                { name: 'mapDependencies', description: 'Map dependencies (default: true)', required: false },
+            ],
+        },
+    ],
+}));
+server.setRequestHandler(types_js_1.GetPromptRequestSchema, async (request) => {
+    const { name, arguments: promptArgs } = request.params;
+    if (name !== 'pde-decompose') {
+        throw new Error(`Unknown prompt: ${name}`);
+    }
+    const opts = {
+        extractImplicit: promptArgs?.extractImplicit !== 'false',
+        mapDependencies: promptArgs?.mapDependencies !== 'false',
+    };
+    return {
+        messages: [
+            {
+                role: 'user',
+                content: {
+                    type: 'text',
+                    text: `${(0, prompts_js_1.buildSystemPrompt)(opts)}\n\n${(0, prompts_js_1.formatUserMessage)(promptArgs?.userPrompt || '')}`,
+                },
+            },
+        ],
+    };
+});
+// ============================================================================
+// Server Startup
+// ============================================================================
+async function startServer() {
+    const transport = new stdio_js_1.StdioServerTransport();
+    await server.connect(transport);
+    console.error('PDE MCP Server v2 started');
+}
+//# sourceMappingURL=mcp-server.js.map

package/dist/mcp-server.js.map

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

package/dist/parser.d.ts

@@ -0,0 +1,19 @@
+/**
+ * PDE Parser - Response Parser for LLM text → DecompositionResult
+ *
+ * Lineage: IAIP/lib/pde/parser.ts → mcp-pde/src/parser.ts
+ * Handles JSON extraction from markdown code blocks, raw JSON, etc.
+ */
+import type { DecompositionResult } from "./types.js";
+export declare class PDEParseError extends Error {
+    rawResponse: string;
+    parseAttempt?: string | undefined;
+    constructor(message: string, rawResponse: string, parseAttempt?: string | undefined);
+}
+export declare function parseDecompositionResponse(responseText: string): DecompositionResult;
+export declare function actionStackToMarkdown(items: Array<{
+    text: string;
+    completed?: boolean;
+    dependency?: string | null;
+}>): string;
+//# sourceMappingURL=parser.d.ts.map

package/dist/parser.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"parser.d.ts","sourceRoot":"","sources":["../src/parser.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH,OAAO,KAAK,EAAE,mBAAmB,EAAE,MAAM,YAAY,CAAC;AAEtD,qBAAa,aAAc,SAAQ,KAAK;IAG7B,WAAW,EAAE,MAAM;IACnB,YAAY,CAAC,EAAE,MAAM;gBAF5B,OAAO,EAAE,MAAM,EACR,WAAW,EAAE,MAAM,EACnB,YAAY,CAAC,EAAE,MAAM,YAAA;CAK/B;AAwDD,wBAAgB,0BAA0B,CAAC,YAAY,EAAE,MAAM,GAAG,mBAAmB,CASpF;AAED,wBAAgB,qBAAqB,CACnC,KAAK,EAAE,KAAK,CAAC;IAAE,IAAI,EAAE,MAAM,CAAC;IAAC,SAAS,CAAC,EAAE,OAAO,CAAC;IAAC,UAAU,CAAC,EAAE,MAAM,GAAG,IAAI,CAAA;CAAE,CAAC,GAC9E,MAAM,CAQR"}

package/dist/parser.js

@@ -0,0 +1,89 @@
+"use strict";
+/**
+ * PDE Parser - Response Parser for LLM text → DecompositionResult
+ *
+ * Lineage: IAIP/lib/pde/parser.ts → mcp-pde/src/parser.ts
+ * Handles JSON extraction from markdown code blocks, raw JSON, etc.
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.PDEParseError = void 0;
+exports.parseDecompositionResponse = parseDecompositionResponse;
+exports.actionStackToMarkdown = actionStackToMarkdown;
+class PDEParseError extends Error {
+    rawResponse;
+    parseAttempt;
+    constructor(message, rawResponse, parseAttempt) {
+        super(message);
+        this.rawResponse = rawResponse;
+        this.parseAttempt = parseAttempt;
+        this.name = "PDEParseError";
+    }
+}
+exports.PDEParseError = PDEParseError;
+function extractJsonString(responseText) {
+    const codeBlockMatch = responseText.match(/```(?:json)?\s*([\s\S]*?)```/);
+    if (codeBlockMatch)
+        return codeBlockMatch[1].trim();
+    const trimmed = responseText.trim();
+    if (trimmed.startsWith("{"))
+        return trimmed;
+    const firstBrace = responseText.indexOf("{");
+    const lastBrace = responseText.lastIndexOf("}");
+    if (firstBrace !== -1 && lastBrace > firstBrace) {
+        return responseText.substring(firstBrace, lastBrace + 1);
+    }
+    throw new PDEParseError("No JSON found in LLM response", responseText);
+}
+function normalizeResult(raw) {
+    const primary = raw.primary;
+    if (!primary || !primary.action || !primary.target) {
+        throw new PDEParseError("Missing or invalid 'primary' field", JSON.stringify(raw));
+    }
+    if (typeof primary.confidence !== "number")
+        primary.confidence = 0.8;
+    if (!primary.urgency)
+        primary.urgency = "session";
+    const ensureArray = (val) => Array.isArray(val) ? val : [];
+    const context = (raw.context || {});
+    const outputs = (raw.outputs || {});
+    const directions = (raw.directions || {});
+    return {
+        primary,
+        secondary: ensureArray(raw.secondary),
+        context: {
+            files_needed: ensureArray(context.files_needed),
+            tools_required: ensureArray(context.tools_required),
+            assumptions: ensureArray(context.assumptions),
+        },
+        outputs: {
+            artifacts: ensureArray(outputs.artifacts),
+            updates: ensureArray(outputs.updates),
+            communications: ensureArray(outputs.communications),
+        },
+        directions: {
+            east: ensureArray(directions.east),
+            south: ensureArray(directions.south),
+            west: ensureArray(directions.west),
+            north: ensureArray(directions.north),
+        },
+        actionStack: ensureArray(raw.actionStack),
+        ambiguities: ensureArray(raw.ambiguities),
+    };
+}
+function parseDecompositionResponse(responseText) {
+    const jsonString = extractJsonString(responseText);
+    let parsed;
+    try {
+        parsed = JSON.parse(jsonString);
+    }
+    catch (e) {
+        throw new PDEParseError(`Invalid JSON: ${e.message}`, responseText, jsonString);
+    }
+    return normalizeResult(parsed);
+}
+function actionStackToMarkdown(items) {
+    return items
+        .map((item) => `- [${item.completed ? "x" : " "}] ${item.text}${item.dependency ? ` (depends on: ${item.dependency})` : ""}`)
+        .join("\n");
+}
+//# sourceMappingURL=parser.js.map

package/dist/parser.js.map

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

package/dist/pde-engine.d.ts

@@ -0,0 +1,54 @@
+/**
+ * PDE Engine v2
+ *
+ * LLM-driven Prompt Decomposition Engine.
+ * Uses system prompts (from IAIP/lib/pde lineage) to instruct an LLM to produce
+ * structured DecompositionResult JSON, then parses and stores the result.
+ *
+ * The LLM call itself is NOT embedded here — the MCP tool receives the prompt,
+ * builds the system prompt, and the calling agent (Copilot, Gemini, mia-code)
+ * feeds it to their LLM. The engine then parses the LLM response.
+ *
+ * For direct decomposition without external LLM, use decomposeWithResponse()
+ * after getting the LLM response yourself.
+ */
+import { type DecompositionResult, type DecompositionOptions, type StoredDecomposition } from './types.js';
+import { PDEParseError } from './parser.js';
+export declare class PdeEngine {
+    private defaultWorkdir;
+    constructor(workdir?: string);
+    /**
+     * Build the system prompt + user message for the calling LLM.
+     * The caller sends these to their LLM provider, then calls parseAndStore() with the response.
+     */
+    buildPrompt(prompt: string, options?: Partial<DecompositionOptions>): {
+        systemPrompt: string;
+        userMessage: string;
+    };
+    /**
+     * Parse an LLM response text into DecompositionResult and persist it.
+     */
+    parseAndStore(llmResponse: string, originalPrompt: string, options?: Partial<DecompositionOptions>, workdir?: string, parentPdeId?: string): StoredDecomposition;
+    /**
+     * Parse an LLM response text into DecompositionResult without storing.
+     */
+    parse(llmResponse: string): DecompositionResult;
+    /**
+     * Get a stored decomposition by ID.
+     */
+    get(id: string, workdir?: string): StoredDecomposition | null;
+    /**
+     * List stored decompositions.
+     */
+    list(workdir?: string, limit?: number): StoredDecomposition[];
+    /**
+     * List children of a specific parent PDE.
+     */
+    listChildren(parentId: string, workdir?: string): StoredDecomposition[];
+    /**
+     * Export a decomposition to markdown.
+     */
+    exportMarkdown(id: string, workdir?: string): string | null;
+}
+export { PDEParseError };
+//# sourceMappingURL=pde-engine.d.ts.map

package/dist/pde-engine.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"pde-engine.d.ts","sourceRoot":"","sources":["../src/pde-engine.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;GAaG;AAGH,OAAO,EACL,KAAK,mBAAmB,EACxB,KAAK,oBAAoB,EACzB,KAAK,mBAAmB,EAEzB,MAAM,YAAY,CAAC;AAEpB,OAAO,EAA8B,aAAa,EAAE,MAAM,aAAa,CAAC;AAGxE,qBAAa,SAAS;IACpB,OAAO,CAAC,cAAc,CAAS;gBAEnB,OAAO,CAAC,EAAE,MAAM;IAI5B;;;OAGG;IACH,WAAW,CACT,MAAM,EAAE,MAAM,EACd,OAAO,CAAC,EAAE,OAAO,CAAC,oBAAoB,CAAC,GACtC;QAAE,YAAY,EAAE,MAAM,CAAC;QAAC,WAAW,EAAE,MAAM,CAAA;KAAE;IAQhD;;OAEG;IACH,aAAa,CACX,WAAW,EAAE,MAAM,EACnB,cAAc,EAAE,MAAM,EACtB,OAAO,CAAC,EAAE,OAAO,CAAC,oBAAoB,CAAC,EACvC,OAAO,CAAC,EAAE,MAAM,EAChB,WAAW,CAAC,EAAE,MAAM,GACnB,mBAAmB;IAQtB;;OAEG;IACH,KAAK,CAAC,WAAW,EAAE,MAAM,GAAG,mBAAmB;IAI/C;;OAEG;IACH,GAAG,CAAC,EAAE,EAAE,MAAM,EAAE,OAAO,CAAC,EAAE,MAAM,GAAG,mBAAmB,GAAG,IAAI;IAI7D;;OAEG;IACH,IAAI,CAAC,OAAO,CAAC,EAAE,MAAM,EAAE,KAAK,CAAC,EAAE,MAAM,GAAG,mBAAmB,EAAE;IAI7D;;OAEG;IACH,YAAY,CAAC,QAAQ,EAAE,MAAM,EAAE,OAAO,CAAC,EAAE,MAAM,GAAG,mBAAmB,EAAE;IAIvE;;OAEG;IACH,cAAc,CAAC,EAAE,EAAE,MAAM,EAAE,OAAO,CAAC,EAAE,MAAM,GAAG,MAAM,GAAG,IAAI;CAK5D;AAED,OAAO,EAAE,aAAa,EAAE,CAAC"}