@lssm/bundle.contractspec-workspace 0.0.0-canary-20251217063201 → 0.0.0-canary-20251217073102

package/dist/modules/contractspec-workspace/dist/templates/workflow.js

@@ -1,10 +1,18 @@
-import{i as e,t}from"./utils.js";function n(n){let i=t(n.name.split(`.`).pop()??`Workflow`)+`Workflow`,a=n.steps.map(e=>r(e)).join(`,
-`),o=n.transitions.map(t=>`    {
-      from: '${t.from}',
-      to: '${t.to}',
-${t.condition?`      condition: '${e(t.condition)}',`:``}
-    }`).join(`,
-`);return`import type { WorkflowSpec } from '@lssm/lib.contracts/workflow';
+import { escapeString, toPascalCase } from "./utils.js";
+
+//#region ../../modules/contractspec-workspace/dist/templates/workflow.js
+/**
+* Generate workflow spec TypeScript code.
+*/
+function generateWorkflowSpec(data) {
+	const specVarName = toPascalCase(data.name.split(".").pop() ?? "Workflow") + "Workflow";
+	const stepsCode = data.steps.map((step) => formatStep(step)).join(",\n");
+	const transitionsCode = data.transitions.map((transition) => `    {
+      from: '${transition.from}',
+      to: '${transition.to}',
+${transition.condition ? `      condition: '${escapeString(transition.condition)}',` : ""}
+    }`).join(",\n");
+	return `import type { WorkflowSpec } from '@lssm/lib.contracts/workflow';
 
 /**
  * Workflow generated via contractspec CLI.
@@ -14,28 +22,46 @@ ${t.condition?`      condition: '${e(t.condition)}',`:``}
  *  - Provide form renderers for human steps.
  *  - Add guards/conditions as needed.
  */
-export const ${i}: WorkflowSpec = {
+export const ${specVarName}: WorkflowSpec = {
   meta: {
-    name: '${n.name}',
-    version: ${n.version},
-    title: '${e(n.title)}',
-    description: '${e(n.description)}',
-    domain: '${e(n.domain)}',
-    stability: '${n.stability}',
-    owners: [${n.owners.map(e=>`'${e}'`).join(`, `)}],
-    tags: [${n.tags.map(e=>`'${e}'`).join(`, `)}],
+    name: '${data.name}',
+    version: ${data.version},
+    title: '${escapeString(data.title)}',
+    description: '${escapeString(data.description)}',
+    domain: '${escapeString(data.domain)}',
+    stability: '${data.stability}',
+    owners: [${data.owners.map((owner) => `'${owner}'`).join(", ")}],
+    tags: [${data.tags.map((tag) => `'${tag}'`).join(", ")}],
   },
   definition: {
-${n.entryStepId?`    entryStepId: '${n.entryStepId}',\n`:``}    steps: [
-${a}
+${data.entryStepId ? `    entryStepId: '${data.entryStepId}',\n` : ""}    steps: [
+${stepsCode}
     ],
     transitions: [
-${o}
+${transitionsCode}
     ],
   },
-  ${n.policyFlags.length>0?`policy: {
-    flags: [${n.policyFlags.map(e=>`'${e}'`).join(`, `)}],
-  },`:`// policy: { flags: [] },`}
+  ${data.policyFlags.length > 0 ? `policy: {
+    flags: [${data.policyFlags.map((flag) => `'${flag}'`).join(", ")}],
+  },` : "// policy: { flags: [] },"}
 };
-`}function r(t){let n=[`    {`,`      id: '${t.id}',`,`      type: '${t.type}',`,`      label: '${e(t.label)}',`];t.description&&n.push(`      description: '${e(t.description)}',`);let r=[];return t.operation&&r.push(`operation: { name: '${t.operation.name}', version: ${t.operation.version} }`),t.form&&r.push(`form: { key: '${t.form.key}', version: ${t.form.version} }`),r.length&&n.push(`      action: { ${r.join(`, `)} },`),n.push(`    }`),n.join(`
-`)}export{n};
+`;
+}
+function formatStep(step) {
+	const lines = [
+		`    {`,
+		`      id: '${step.id}',`,
+		`      type: '${step.type}',`,
+		`      label: '${escapeString(step.label)}',`
+	];
+	if (step.description) lines.push(`      description: '${escapeString(step.description)}',`);
+	const actionLines = [];
+	if (step.operation) actionLines.push(`operation: { name: '${step.operation.name}', version: ${step.operation.version} }`);
+	if (step.form) actionLines.push(`form: { key: '${step.form.key}', version: ${step.form.version} }`);
+	if (actionLines.length) lines.push(`      action: { ${actionLines.join(", ")} },`);
+	lines.push(`    }`);
+	return lines.join("\n");
+}
+
+//#endregion
+export { generateWorkflowSpec };

package/dist/modules/contractspec-workspace/dist/types/generation-types.js

@@ -1 +1,20 @@
-const e={aiProvider:`claude`,agentMode:`simple`,outputDir:`./src`,conventions:{operations:`interactions/commands|queries`,events:`events`,presentations:`presentations`,forms:`forms`},defaultOwners:[],defaultTags:[]};export{e};
+//#region ../../modules/contractspec-workspace/dist/types/generation-types.js
+/**
+* Default workspace configuration.
+*/
+const DEFAULT_WORKSPACE_CONFIG = {
+	aiProvider: "claude",
+	agentMode: "simple",
+	outputDir: "./src",
+	conventions: {
+		operations: "interactions/commands|queries",
+		events: "events",
+		presentations: "presentations",
+		forms: "forms"
+	},
+	defaultOwners: [],
+	defaultTags: []
+};
+
+//#endregion
+export { DEFAULT_WORKSPACE_CONFIG };

package/dist/services/agent-guide/adapters/claude-code.js

@@ -1,3 +1,144 @@
-import{n as e}from"../../../libs/contracts/dist/llm/prompts.js";import"../../../libs/contracts/dist/llm/index.js";var t=class{agentType=`claude-code`;formatPlan(t){let n=[];if(n.push(`# Implement: ${t.target.name}.v${t.target.version}`),n.push(``),n.push(`## Context`),n.push(``),n.push(`**Goal:** ${t.context.goal}`),n.push(``),n.push(`**Description:** ${t.context.description}`),n.push(``),t.context.background&&(n.push(`**Background:**`),n.push(t.context.background),n.push(``)),n.push(`## Specification`),n.push(``),n.push(t.specMarkdown),n.push(``),t.fileStructure.length>0){n.push(`## Files to Create/Modify`),n.push(``);for(let e of t.fileStructure){let t=e.type===`create`?`📝`:`✏️`;n.push(`${t} \`${e.path}\``),n.push(`   ${e.purpose}`),n.push(``)}}n.push(`## Implementation Steps`),n.push(``);for(let e of t.steps){n.push(`### ${e.order}. ${e.title}`),n.push(``),n.push(e.description),n.push(``),n.push(`**Acceptance Criteria:**`);for(let t of e.acceptanceCriteria)n.push(`- [ ] ${t}`);n.push(``)}if(t.constraints.policy.length>0||t.constraints.security.length>0||t.constraints.pii.length>0){if(n.push(`## Constraints`),n.push(``),t.constraints.policy.length>0){n.push(`### Policy`);for(let e of t.constraints.policy)n.push(`- ${e}`);n.push(``)}if(t.constraints.security.length>0){n.push(`### Security`);for(let e of t.constraints.security)n.push(`- ⚠️ ${e}`);n.push(``)}if(t.constraints.pii.length>0){n.push(`### PII Handling`),n.push(`The following fields contain personally identifiable information:`);for(let e of t.constraints.pii)n.push(`- \`${e}\``);n.push(``)}}n.push(`## Verification Checklist`),n.push(``),n.push(`Before submitting, verify:`);for(let e of t.verificationChecklist)n.push(`- [ ] ${e}`);return n.push(``),n.push(`## Instructions`),n.push(``),n.push(`1. Implement each step in order`),n.push("2. Use TypeScript with strict typing (no `any`)"),n.push(`3. Include JSDoc comments for public APIs`),n.push(`4. Handle all error cases defined in the spec`),n.push(`5. Emit events as specified`),n.push(`6. Mark checklist items as you complete them`),n.push(``),{agent:`claude-code`,systemPrompt:e[`claude-code`],taskPrompt:n.join(`
-`)}}generateConfig(e){let t=[];return t.push(`# ContractSpec Implementation Context`),t.push(``),t.push(`This codebase uses ContractSpec for spec-first development.`),t.push(``),t.push(`## Spec Details`),t.push(``),t.push(`- **Name:** ${e.meta.name}`),t.push(`- **Version:** ${e.meta.version}`),t.push(`- **Kind:** ${e.meta.kind}`),t.push(`- **Stability:** ${e.meta.stability}`),t.push(``),t.push(`## Implementation Requirements`),t.push(``),t.push(`1. Match input/output types exactly`),t.push(`2. Handle all defined error cases`),t.push(`3. Emit events as specified`),t.push(`4. Respect policy constraints`),t.push(``),t.join(`
-`)}parseOutput(e){let t=e.match(/```(?:typescript|ts|tsx)?\n([\s\S]*?)\n```/);if(t?.[1])return{code:t[1]};let n=[];for(let t of[/error:\s*(.+)/gi,/failed:\s*(.+)/gi,/cannot\s+(.+)/gi]){let r=e.matchAll(t);for(let e of r)e[1]&&n.push(e[1])}return n.length>0?{errors:n}:{code:e}}};const n=new t;export{t as ClaudeCodeAdapter,n as claudeCodeAdapter};
+import { AGENT_SYSTEM_PROMPTS } from "../../../libs/contracts/dist/llm/prompts.js";
+import "../../../libs/contracts/dist/llm/index.js";
+
+//#region src/services/agent-guide/adapters/claude-code.ts
+/**
+* Claude Code adapter implementation.
+* Optimized for Claude's extended thinking and code generation capabilities.
+*/
+var ClaudeCodeAdapter = class {
+	agentType = "claude-code";
+	/**
+	* Format an implementation plan for Claude Code.
+	* Uses structured markdown with clear sections and checklists.
+	*/
+	formatPlan(plan) {
+		const lines = [];
+		lines.push(`# Implement: ${plan.target.name}.v${plan.target.version}`);
+		lines.push("");
+		lines.push("## Context");
+		lines.push("");
+		lines.push(`**Goal:** ${plan.context.goal}`);
+		lines.push("");
+		lines.push(`**Description:** ${plan.context.description}`);
+		lines.push("");
+		if (plan.context.background) {
+			lines.push(`**Background:**`);
+			lines.push(plan.context.background);
+			lines.push("");
+		}
+		lines.push("## Specification");
+		lines.push("");
+		lines.push(plan.specMarkdown);
+		lines.push("");
+		if (plan.fileStructure.length > 0) {
+			lines.push("## Files to Create/Modify");
+			lines.push("");
+			for (const file of plan.fileStructure) {
+				const icon = file.type === "create" ? "📝" : "✏️";
+				lines.push(`${icon} \`${file.path}\``);
+				lines.push(`   ${file.purpose}`);
+				lines.push("");
+			}
+		}
+		lines.push("## Implementation Steps");
+		lines.push("");
+		for (const step of plan.steps) {
+			lines.push(`### ${step.order}. ${step.title}`);
+			lines.push("");
+			lines.push(step.description);
+			lines.push("");
+			lines.push("**Acceptance Criteria:**");
+			for (const criteria of step.acceptanceCriteria) lines.push(`- [ ] ${criteria}`);
+			lines.push("");
+		}
+		if (plan.constraints.policy.length > 0 || plan.constraints.security.length > 0 || plan.constraints.pii.length > 0) {
+			lines.push("## Constraints");
+			lines.push("");
+			if (plan.constraints.policy.length > 0) {
+				lines.push("### Policy");
+				for (const p of plan.constraints.policy) lines.push(`- ${p}`);
+				lines.push("");
+			}
+			if (plan.constraints.security.length > 0) {
+				lines.push("### Security");
+				for (const s of plan.constraints.security) lines.push(`- ⚠️ ${s}`);
+				lines.push("");
+			}
+			if (plan.constraints.pii.length > 0) {
+				lines.push("### PII Handling");
+				lines.push("The following fields contain personally identifiable information:");
+				for (const pii of plan.constraints.pii) lines.push(`- \`${pii}\``);
+				lines.push("");
+			}
+		}
+		lines.push("## Verification Checklist");
+		lines.push("");
+		lines.push("Before submitting, verify:");
+		for (const check of plan.verificationChecklist) lines.push(`- [ ] ${check}`);
+		lines.push("");
+		lines.push("## Instructions");
+		lines.push("");
+		lines.push("1. Implement each step in order");
+		lines.push("2. Use TypeScript with strict typing (no `any`)");
+		lines.push("3. Include JSDoc comments for public APIs");
+		lines.push("4. Handle all error cases defined in the spec");
+		lines.push("5. Emit events as specified");
+		lines.push("6. Mark checklist items as you complete them");
+		lines.push("");
+		return {
+			agent: "claude-code",
+			systemPrompt: AGENT_SYSTEM_PROMPTS["claude-code"],
+			taskPrompt: lines.join("\n")
+		};
+	}
+	/**
+	* Generate agent-specific configuration.
+	* For Claude Code, this generates a prompt that can be used as context.
+	*/
+	generateConfig(spec) {
+		const lines = [];
+		lines.push("# ContractSpec Implementation Context");
+		lines.push("");
+		lines.push("This codebase uses ContractSpec for spec-first development.");
+		lines.push("");
+		lines.push("## Spec Details");
+		lines.push("");
+		lines.push(`- **Name:** ${spec.meta.name}`);
+		lines.push(`- **Version:** ${spec.meta.version}`);
+		lines.push(`- **Kind:** ${spec.meta.kind}`);
+		lines.push(`- **Stability:** ${spec.meta.stability}`);
+		lines.push("");
+		lines.push("## Implementation Requirements");
+		lines.push("");
+		lines.push("1. Match input/output types exactly");
+		lines.push("2. Handle all defined error cases");
+		lines.push("3. Emit events as specified");
+		lines.push("4. Respect policy constraints");
+		lines.push("");
+		return lines.join("\n");
+	}
+	/**
+	* Parse Claude Code output to extract generated code.
+	*/
+	parseOutput(output) {
+		const codeBlockMatch = output.match(/```(?:typescript|ts|tsx)?\n([\s\S]*?)\n```/);
+		if (codeBlockMatch?.[1]) return { code: codeBlockMatch[1] };
+		const errors = [];
+		for (const pattern of [
+			/error:\s*(.+)/gi,
+			/failed:\s*(.+)/gi,
+			/cannot\s+(.+)/gi
+		]) {
+			const matches = output.matchAll(pattern);
+			for (const match of matches) if (match[1]) errors.push(match[1]);
+		}
+		if (errors.length > 0) return { errors };
+		return { code: output };
+	}
+};
+/** Singleton instance */
+const claudeCodeAdapter = new ClaudeCodeAdapter();
+
+//#endregion
+export { ClaudeCodeAdapter, claudeCodeAdapter };

package/dist/services/agent-guide/adapters/cursor-cli.js

@@ -1,3 +1,135 @@
-import{n as e}from"../../../libs/contracts/dist/llm/prompts.js";import"../../../libs/contracts/dist/llm/index.js";var t=class{agentType=`cursor-cli`;formatPlan(t){let n=[];if(n.push(`# ${t.target.name}.v${t.target.version}`),n.push(``),n.push(`> ${t.context.goal}`),n.push(``),t.fileStructure.length>0){n.push(`## Files`),n.push(``);for(let e of t.fileStructure)n.push(`- ${e.type}: \`${e.path}\` - ${e.purpose}`);n.push(``)}n.push(`## Spec`),n.push(``),n.push(t.specMarkdown),n.push(``),n.push(`## Steps`),n.push(``);for(let e of t.steps)n.push(`${e.order}. **${e.title}**: ${e.description}`);n.push(``);let r=[...t.constraints.policy,...t.constraints.security.map(e=>`⚠️ ${e}`)];if(r.length>0){n.push(`## Constraints`),n.push(``);for(let e of r)n.push(`- ${e}`);n.push(``)}return t.constraints.pii.length>0&&(n.push(`## PII Fields`),n.push(``),n.push(`Handle carefully: ${t.constraints.pii.map(e=>`\`${e}\``).join(`, `)}`),n.push(``)),{agent:`cursor-cli`,systemPrompt:e[`cursor-cli`],taskPrompt:n.join(`
-`)}}generateConfig(e){let t=e.meta,n=[];if(n.push(`---`),n.push(`description: Implementation rules for ${t.name}.v${t.version}`),n.push(`globs: ["**/${t.name.replace(/\./g,`/`)}/**"]`),n.push(`alwaysApply: false`),n.push(`---`),n.push(``),n.push(`# ${t.name} Implementation Rules`),n.push(``),n.push(`This ${t.kind} operation must follow the ContractSpec specification.`),n.push(``),n.push(`## Goal`),n.push(``),n.push(t.goal),n.push(``),n.push(`## Requirements`),n.push(``),n.push(`1. Input/output types MUST match the spec schema exactly`),n.push(`2. All error cases MUST be handled`),e.sideEffects?.emits?.length&&n.push(`3. Events MUST be emitted as specified`),n.push(`4. Auth level: ${e.policy.auth}`),e.policy.idempotent!==void 0&&n.push(`5. Idempotency: ${e.policy.idempotent}`),n.push(``),e.io.errors&&Object.keys(e.io.errors).length>0){n.push(`## Error Cases`),n.push(``);for(let[t,r]of Object.entries(e.io.errors))n.push(`- \`${t}\` (HTTP ${r.http??400}): ${r.when}`);n.push(``)}if(e.sideEffects?.emits?.length){n.push(`## Events to Emit`),n.push(``);for(let t of e.sideEffects.emits)`ref`in t?n.push(`- \`${t.ref.name}.v${t.ref.version}\`: ${t.when}`):n.push(`- \`${t.name}.v${t.version}\`: ${t.when}`);n.push(``)}if(e.policy.pii?.length){n.push(`## PII Handling`),n.push(``),n.push(`These fields contain PII and must be handled with care:`);for(let t of e.policy.pii)n.push(`- \`${t}\``);n.push(``)}if(e.acceptance?.scenarios?.length){n.push(`## Acceptance Scenarios`),n.push(``);for(let t of e.acceptance.scenarios)n.push(`### ${t.name}`),n.push(`- Given: ${t.given.join(`; `)}`),n.push(`- When: ${t.when.join(`; `)}`),n.push(`- Then: ${t.then.join(`; `)}`),n.push(``)}return n.join(`
-`)}getCursorRulesPath(e){return`.cursor/rules/${e.meta.name.replace(/\./g,`-`)}.mdc`}parseOutput(e){let t=e.match(/```(?:typescript|ts|tsx|javascript|js)?\n([\s\S]*?)\n```/);return t?.[1]?{code:t[1]}:{code:e}}};const n=new t;export{t as CursorCLIAdapter,n as cursorCLIAdapter};
+import { AGENT_SYSTEM_PROMPTS } from "../../../libs/contracts/dist/llm/prompts.js";
+import "../../../libs/contracts/dist/llm/index.js";
+
+//#region src/services/agent-guide/adapters/cursor-cli.ts
+/**
+* Cursor CLI adapter implementation.
+* Optimized for Cursor's background/composer mode.
+*/
+var CursorCLIAdapter = class {
+	agentType = "cursor-cli";
+	/**
+	* Format an implementation plan for Cursor CLI.
+	* Uses concise format optimized for Cursor's context window.
+	*/
+	formatPlan(plan) {
+		const lines = [];
+		lines.push(`# ${plan.target.name}.v${plan.target.version}`);
+		lines.push("");
+		lines.push(`> ${plan.context.goal}`);
+		lines.push("");
+		if (plan.fileStructure.length > 0) {
+			lines.push("## Files");
+			lines.push("");
+			for (const file of plan.fileStructure) lines.push(`- ${file.type}: \`${file.path}\` - ${file.purpose}`);
+			lines.push("");
+		}
+		lines.push("## Spec");
+		lines.push("");
+		lines.push(plan.specMarkdown);
+		lines.push("");
+		lines.push("## Steps");
+		lines.push("");
+		for (const step of plan.steps) lines.push(`${step.order}. **${step.title}**: ${step.description}`);
+		lines.push("");
+		const constraints = [...plan.constraints.policy, ...plan.constraints.security.map((s) => `⚠️ ${s}`)];
+		if (constraints.length > 0) {
+			lines.push("## Constraints");
+			lines.push("");
+			for (const c of constraints) lines.push(`- ${c}`);
+			lines.push("");
+		}
+		if (plan.constraints.pii.length > 0) {
+			lines.push("## PII Fields");
+			lines.push("");
+			lines.push(`Handle carefully: ${plan.constraints.pii.map((p) => `\`${p}\``).join(", ")}`);
+			lines.push("");
+		}
+		return {
+			agent: "cursor-cli",
+			systemPrompt: AGENT_SYSTEM_PROMPTS["cursor-cli"],
+			taskPrompt: lines.join("\n")
+		};
+	}
+	/**
+	* Generate Cursor rules (.mdc format) for a spec.
+	* Can be saved to .cursor/rules/ to provide persistent context.
+	*/
+	generateConfig(spec) {
+		const m = spec.meta;
+		const lines = [];
+		lines.push("---");
+		lines.push(`description: Implementation rules for ${m.name}.v${m.version}`);
+		lines.push(`globs: ["**/${m.name.replace(/\./g, "/")}/**"]`);
+		lines.push("alwaysApply: false");
+		lines.push("---");
+		lines.push("");
+		lines.push(`# ${m.name} Implementation Rules`);
+		lines.push("");
+		lines.push(`This ${m.kind} operation must follow the ContractSpec specification.`);
+		lines.push("");
+		lines.push("## Goal");
+		lines.push("");
+		lines.push(m.goal);
+		lines.push("");
+		lines.push("## Requirements");
+		lines.push("");
+		lines.push("1. Input/output types MUST match the spec schema exactly");
+		lines.push("2. All error cases MUST be handled");
+		if (spec.sideEffects?.emits?.length) lines.push("3. Events MUST be emitted as specified");
+		lines.push(`4. Auth level: ${spec.policy.auth}`);
+		if (spec.policy.idempotent !== void 0) lines.push(`5. Idempotency: ${spec.policy.idempotent}`);
+		lines.push("");
+		if (spec.io.errors && Object.keys(spec.io.errors).length > 0) {
+			lines.push("## Error Cases");
+			lines.push("");
+			for (const [code, err] of Object.entries(spec.io.errors)) lines.push(`- \`${code}\` (HTTP ${err.http ?? 400}): ${err.when}`);
+			lines.push("");
+		}
+		if (spec.sideEffects?.emits?.length) {
+			lines.push("## Events to Emit");
+			lines.push("");
+			for (const e of spec.sideEffects.emits) if ("ref" in e) lines.push(`- \`${e.ref.name}.v${e.ref.version}\`: ${e.when}`);
+			else lines.push(`- \`${e.name}.v${e.version}\`: ${e.when}`);
+			lines.push("");
+		}
+		if (spec.policy.pii?.length) {
+			lines.push("## PII Handling");
+			lines.push("");
+			lines.push("These fields contain PII and must be handled with care:");
+			for (const field of spec.policy.pii) lines.push(`- \`${field}\``);
+			lines.push("");
+		}
+		if (spec.acceptance?.scenarios?.length) {
+			lines.push("## Acceptance Scenarios");
+			lines.push("");
+			for (const s of spec.acceptance.scenarios) {
+				lines.push(`### ${s.name}`);
+				lines.push(`- Given: ${s.given.join("; ")}`);
+				lines.push(`- When: ${s.when.join("; ")}`);
+				lines.push(`- Then: ${s.then.join("; ")}`);
+				lines.push("");
+			}
+		}
+		return lines.join("\n");
+	}
+	/**
+	* Generate a cursor rules file path for a spec.
+	*/
+	getCursorRulesPath(spec) {
+		return `.cursor/rules/${spec.meta.name.replace(/\./g, "-")}.mdc`;
+	}
+	/**
+	* Parse Cursor output to extract generated code.
+	*/
+	parseOutput(output) {
+		const codeBlockMatch = output.match(/```(?:typescript|ts|tsx|javascript|js)?\n([\s\S]*?)\n```/);
+		if (codeBlockMatch?.[1]) return { code: codeBlockMatch[1] };
+		return { code: output };
+	}
+};
+/** Singleton instance */
+const cursorCLIAdapter = new CursorCLIAdapter();
+
+//#endregion
+export { CursorCLIAdapter, cursorCLIAdapter };

package/dist/services/agent-guide/adapters/generic-mcp.js

@@ -1,3 +1,159 @@
-import{n as e}from"../../../libs/contracts/dist/llm/prompts.js";import"../../../libs/contracts/dist/llm/index.js";var t=class{agentType=`generic-mcp`;formatPlan(t){let n=[];if(n.push(`# Implementation Task: ${t.target.name}.v${t.target.version}`),n.push(``),n.push(`## Task`),n.push(``),n.push(`Implement the ${t.target.type} \`${t.target.name}\` version ${t.target.version}.`),n.push(``),n.push(`## Context`),n.push(``),n.push(`**Goal:** ${t.context.goal}`),n.push(``),n.push(`**Description:** ${t.context.description}`),n.push(``),t.context.background&&(n.push(`**Background:**`),n.push(``),n.push(t.context.background),n.push(``)),n.push(`## Specification`),n.push(``),n.push(t.specMarkdown),n.push(``),t.fileStructure.length>0){n.push(`## Files`),n.push(``),n.push(`| Path | Action | Purpose |`),n.push(`|------|--------|---------|`);for(let e of t.fileStructure)n.push(`| \`${e.path}\` | ${e.type} | ${e.purpose} |`);n.push(``)}n.push(`## Implementation Steps`),n.push(``);for(let e of t.steps)if(n.push(`### Step ${e.order}: ${e.title}`),n.push(``),n.push(e.description),n.push(``),e.acceptanceCriteria.length>0){n.push(`**Acceptance Criteria:**`),n.push(``);for(let t of e.acceptanceCriteria)n.push(`- ${t}`);n.push(``)}if(n.push(`## Constraints`),n.push(``),t.constraints.policy.length>0){n.push(`**Policy:**`);for(let e of t.constraints.policy)n.push(`- ${e}`);n.push(``)}if(t.constraints.security.length>0){n.push(`**Security:**`);for(let e of t.constraints.security)n.push(`- ${e}`);n.push(``)}if(t.constraints.pii.length>0){n.push(`**PII Fields (handle with care):**`);for(let e of t.constraints.pii)n.push(`- \`${e}\``);n.push(``)}n.push(`## Verification`),n.push(``),n.push(`After implementation, verify:`),n.push(``);for(let e of t.verificationChecklist)n.push(`- [ ] ${e}`);return n.push(``),{agent:`generic-mcp`,systemPrompt:e[`generic-mcp`],taskPrompt:n.join(`
-`)}}formatAsResource(e){return{uri:`spec://${e.target.name}/v${e.target.version}/plan`,mimeType:`application/json`,data:JSON.stringify({target:e.target,context:e.context,fileStructure:e.fileStructure,steps:e.steps,constraints:e.constraints,verificationChecklist:e.verificationChecklist},null,2)}}formatAsPromptMessage(e){return{role:`user`,content:{type:`text`,text:this.formatPlan(e).taskPrompt}}}generateConfig(e){let t=e.meta,n=[];return n.push(`# ${t.name} v${t.version}`),n.push(``),n.push(`**Type:** ${t.kind}`),n.push(`**Stability:** ${t.stability}`),n.push(``),n.push(`## Goal`),n.push(``),n.push(t.goal),n.push(``),n.push(`## Description`),n.push(``),n.push(t.description),n.push(``),n.join(`
-`)}parseOutput(e){let t=e.match(/```(?:typescript|ts|tsx|javascript|js|python|go|rust)?\n([\s\S]*?)\n```/);if(t?.[1])return{code:t[1]};try{let t=JSON.parse(e);if(typeof t.code==`string`)return{code:t.code};if(typeof t.errors==`object`)return{errors:Array.isArray(t.errors)?t.errors:[String(t.errors)]}}catch{}return{code:e}}};const n=new t;export{t as GenericMCPAdapter,n as genericMCPAdapter};
+import { AGENT_SYSTEM_PROMPTS } from "../../../libs/contracts/dist/llm/prompts.js";
+import "../../../libs/contracts/dist/llm/index.js";
+
+//#region src/services/agent-guide/adapters/generic-mcp.ts
+/**
+* Generic MCP adapter implementation.
+* Works with any MCP-compatible agent (Cline, Aider, etc.).
+*/
+var GenericMCPAdapter = class {
+	agentType = "generic-mcp";
+	/**
+	* Format an implementation plan for generic MCP agents.
+	* Uses a standard markdown format that works across different agents.
+	*/
+	formatPlan(plan) {
+		const lines = [];
+		lines.push(`# Implementation Task: ${plan.target.name}.v${plan.target.version}`);
+		lines.push("");
+		lines.push("## Task");
+		lines.push("");
+		lines.push(`Implement the ${plan.target.type} \`${plan.target.name}\` version ${plan.target.version}.`);
+		lines.push("");
+		lines.push("## Context");
+		lines.push("");
+		lines.push(`**Goal:** ${plan.context.goal}`);
+		lines.push("");
+		lines.push(`**Description:** ${plan.context.description}`);
+		lines.push("");
+		if (plan.context.background) {
+			lines.push("**Background:**");
+			lines.push("");
+			lines.push(plan.context.background);
+			lines.push("");
+		}
+		lines.push("## Specification");
+		lines.push("");
+		lines.push(plan.specMarkdown);
+		lines.push("");
+		if (plan.fileStructure.length > 0) {
+			lines.push("## Files");
+			lines.push("");
+			lines.push("| Path | Action | Purpose |");
+			lines.push("|------|--------|---------|");
+			for (const file of plan.fileStructure) lines.push(`| \`${file.path}\` | ${file.type} | ${file.purpose} |`);
+			lines.push("");
+		}
+		lines.push("## Implementation Steps");
+		lines.push("");
+		for (const step of plan.steps) {
+			lines.push(`### Step ${step.order}: ${step.title}`);
+			lines.push("");
+			lines.push(step.description);
+			lines.push("");
+			if (step.acceptanceCriteria.length > 0) {
+				lines.push("**Acceptance Criteria:**");
+				lines.push("");
+				for (const criteria of step.acceptanceCriteria) lines.push(`- ${criteria}`);
+				lines.push("");
+			}
+		}
+		lines.push("## Constraints");
+		lines.push("");
+		if (plan.constraints.policy.length > 0) {
+			lines.push("**Policy:**");
+			for (const p of plan.constraints.policy) lines.push(`- ${p}`);
+			lines.push("");
+		}
+		if (plan.constraints.security.length > 0) {
+			lines.push("**Security:**");
+			for (const s of plan.constraints.security) lines.push(`- ${s}`);
+			lines.push("");
+		}
+		if (plan.constraints.pii.length > 0) {
+			lines.push("**PII Fields (handle with care):**");
+			for (const pii of plan.constraints.pii) lines.push(`- \`${pii}\``);
+			lines.push("");
+		}
+		lines.push("## Verification");
+		lines.push("");
+		lines.push("After implementation, verify:");
+		lines.push("");
+		for (const check of plan.verificationChecklist) lines.push(`- [ ] ${check}`);
+		lines.push("");
+		return {
+			agent: "generic-mcp",
+			systemPrompt: AGENT_SYSTEM_PROMPTS["generic-mcp"],
+			taskPrompt: lines.join("\n")
+		};
+	}
+	/**
+	* Format the plan as an MCP resource.
+	* Returns JSON that can be served as an MCP resource.
+	*/
+	formatAsResource(plan) {
+		return {
+			uri: `spec://${plan.target.name}/v${plan.target.version}/plan`,
+			mimeType: "application/json",
+			data: JSON.stringify({
+				target: plan.target,
+				context: plan.context,
+				fileStructure: plan.fileStructure,
+				steps: plan.steps,
+				constraints: plan.constraints,
+				verificationChecklist: plan.verificationChecklist
+			}, null, 2)
+		};
+	}
+	/**
+	* Format the plan as an MCP prompt message.
+	*/
+	formatAsPromptMessage(plan) {
+		return {
+			role: "user",
+			content: {
+				type: "text",
+				text: this.formatPlan(plan).taskPrompt
+			}
+		};
+	}
+	/**
+	* Generate configuration (generic markdown for any agent).
+	*/
+	generateConfig(spec) {
+		const m = spec.meta;
+		const lines = [];
+		lines.push(`# ${m.name} v${m.version}`);
+		lines.push("");
+		lines.push(`**Type:** ${m.kind}`);
+		lines.push(`**Stability:** ${m.stability}`);
+		lines.push("");
+		lines.push("## Goal");
+		lines.push("");
+		lines.push(m.goal);
+		lines.push("");
+		lines.push("## Description");
+		lines.push("");
+		lines.push(m.description);
+		lines.push("");
+		return lines.join("\n");
+	}
+	/**
+	* Parse agent output - generic implementation.
+	*/
+	parseOutput(output) {
+		const codeBlockMatch = output.match(/```(?:typescript|ts|tsx|javascript|js|python|go|rust)?\n([\s\S]*?)\n```/);
+		if (codeBlockMatch?.[1]) return { code: codeBlockMatch[1] };
+		try {
+			const parsed = JSON.parse(output);
+			if (typeof parsed.code === "string") return { code: parsed.code };
+			if (typeof parsed.errors === "object") return { errors: Array.isArray(parsed.errors) ? parsed.errors : [String(parsed.errors)] };
+		} catch {}
+		return { code: output };
+	}
+};
+/** Singleton instance */
+const genericMCPAdapter = new GenericMCPAdapter();
+
+//#endregion
+export { GenericMCPAdapter, genericMCPAdapter };

package/dist/services/agent-guide/adapters/index.js

@@ -1 +1,30 @@
-import{ClaudeCodeAdapter as e,claudeCodeAdapter as t}from"./claude-code.js";import{CursorCLIAdapter as n,cursorCLIAdapter as r}from"./cursor-cli.js";import{GenericMCPAdapter as i,genericMCPAdapter as a}from"./generic-mcp.js";const o={"claude-code":t,"cursor-cli":r,"generic-mcp":a};function s(e){let t=o[e];if(!t)throw Error(`Unknown agent type: ${e}`);return t}function c(){return Object.keys(o)}export{o as agentAdapters,s as getAgentAdapter,c as listAgentTypes};
+import { ClaudeCodeAdapter, claudeCodeAdapter } from "./claude-code.js";
+import { CursorCLIAdapter, cursorCLIAdapter } from "./cursor-cli.js";
+import { GenericMCPAdapter, genericMCPAdapter } from "./generic-mcp.js";
+
+//#region src/services/agent-guide/adapters/index.ts
+/**
+* Registry of all available agent adapters.
+*/
+const agentAdapters = {
+	"claude-code": claudeCodeAdapter,
+	"cursor-cli": cursorCLIAdapter,
+	"generic-mcp": genericMCPAdapter
+};
+/**
+* Get an adapter for a specific agent type.
+*/
+function getAgentAdapter(agent) {
+	const adapter = agentAdapters[agent];
+	if (!adapter) throw new Error(`Unknown agent type: ${agent}`);
+	return adapter;
+}
+/**
+* List all available agent types.
+*/
+function listAgentTypes() {
+	return Object.keys(agentAdapters);
+}
+
+//#endregion
+export { agentAdapters, getAgentAdapter, listAgentTypes };