@lssm/bundle.contractspec-workspace 0.0.0-canary-20251217083314 → 1.41.0

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

@@ -1,144 +1,3 @@
-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 };
+import{AGENT_SYSTEM_PROMPTS as e}from"@lssm/lib.contracts/llm";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};

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

@@ -1,135 +1,3 @@
-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 };
+import{AGENT_SYSTEM_PROMPTS as e,specToFullMarkdown as t}from"@lssm/lib.contracts/llm";var n=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 r=new n;export{n as CursorCLIAdapter,r as cursorCLIAdapter};

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

@@ -1,159 +1,3 @@
-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 };
+import{AGENT_SYSTEM_PROMPTS as e}from"@lssm/lib.contracts/llm";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};

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

@@ -1,30 +1 @@
-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 };
+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};

package/dist/services/agent-guide/agent-guide-service.js

@@ -1,148 +1 @@
-import { featureToMarkdown, specToAgentPrompt, specToFullMarkdown } from "../../libs/contracts/dist/llm/exporters.js";
-import { generateImplementationPlan } from "../../libs/contracts/dist/llm/prompts.js";
-import "../../libs/contracts/dist/llm/index.js";
-import { getAgentAdapter, listAgentTypes } from "./adapters/index.js";
-
-//#region src/services/agent-guide/agent-guide-service.ts
-const DEFAULT_CONFIG = {
-	defaultAgent: "generic-mcp",
-	verbose: false
-};
-/**
-* Agent Guide Service
-*
-* Main service for generating implementation guidance for AI coding agents.
-*/
-var AgentGuideService = class {
-	config;
-	constructor(config = {}) {
-		this.config = {
-			...DEFAULT_CONFIG,
-			...config
-		};
-	}
-	/**
-	* Generate an implementation guide for a spec.
-	*/
-	generateGuide(spec, options = {}) {
-		const adapter = getAgentAdapter(options.agent ?? this.config.defaultAgent);
-		const plan = generateImplementationPlan(spec, {
-			projectRoot: this.config.projectRoot,
-			existingFiles: options.targetPath ? [options.targetPath] : void 0
-		});
-		return {
-			plan,
-			prompt: adapter.formatPlan(plan),
-			markdown: specToFullMarkdown(spec)
-		};
-	}
-	/**
-	* Generate a guide for a feature (includes all related specs).
-	*/
-	generateFeatureGuide(feature, deps, options = {}) {
-		const adapter = getAgentAdapter(options.agent ?? this.config.defaultAgent);
-		const firstOp = feature.operations?.[0];
-		const spec = firstOp ? deps.specs?.getSpec(firstOp.name, firstOp.version) : void 0;
-		let plan;
-		if (spec) {
-			plan = generateImplementationPlan(spec, { projectRoot: this.config.projectRoot });
-			plan.target = {
-				type: "feature",
-				name: feature.meta.key,
-				version: 1
-			};
-			plan.context.goal = feature.meta.description ?? plan.context.goal;
-		} else plan = {
-			target: {
-				type: "feature",
-				name: feature.meta.key,
-				version: 1
-			},
-			context: {
-				goal: feature.meta.description ?? `Implement feature ${feature.meta.key}`,
-				description: feature.meta.title ?? feature.meta.key,
-				background: ""
-			},
-			specMarkdown: featureToMarkdown(feature, deps),
-			fileStructure: [],
-			steps: [{
-				order: 1,
-				title: "Implement Feature",
-				description: `Implement the ${feature.meta.key} feature`,
-				acceptanceCriteria: []
-			}],
-			constraints: {
-				policy: [],
-				security: [],
-				pii: []
-			},
-			verificationChecklist: []
-		};
-		plan.specMarkdown = featureToMarkdown(feature, deps, {
-			format: "full",
-			includeRelatedSpecs: true,
-			includeRelatedEvents: true,
-			includeRelatedPresentations: true
-		});
-		if (feature.operations?.length) plan.steps = feature.operations.map((op, idx) => ({
-			order: idx + 1,
-			title: `Implement ${op.name}`,
-			description: `Implement operation ${op.name}.v${op.version}`,
-			acceptanceCriteria: [`Operation ${op.name} works as specified`]
-		}));
-		const prompt = adapter.formatPlan(plan);
-		const markdown = featureToMarkdown(feature, deps);
-		return {
-			plan,
-			prompt,
-			markdown
-		};
-	}
-	/**
-	* Generate agent-specific configuration (e.g., cursor rules).
-	*/
-	generateAgentConfig(spec, agent) {
-		return getAgentAdapter(agent ?? this.config.defaultAgent).generateConfig?.(spec);
-	}
-	/**
-	* Export a spec in a specific format for an agent.
-	*/
-	exportForAgent(spec, agent, taskType = "implement", existingCode) {
-		return specToAgentPrompt(spec, {
-			taskType,
-			existingCode
-		});
-	}
-	/**
-	* List available agent types.
-	*/
-	listAgentTypes() {
-		return listAgentTypes();
-	}
-	/**
-	* Get the default agent type.
-	*/
-	getDefaultAgent() {
-		return this.config.defaultAgent;
-	}
-	/**
-	* Update configuration.
-	*/
-	configure(config) {
-		this.config = {
-			...this.config,
-			...config
-		};
-	}
-};
-/**
-* Create a new AgentGuideService instance.
-*/
-function createAgentGuideService(config) {
-	return new AgentGuideService(config);
-}
-/** Default singleton instance */
-const agentGuideService = new AgentGuideService();
-
-//#endregion
-export { AgentGuideService, agentGuideService, createAgentGuideService };
+import{getAgentAdapter as e,listAgentTypes as t}from"./adapters/index.js";import{featureToMarkdown as n,generateImplementationPlan as r,specToAgentPrompt as i,specToFullMarkdown as a}from"@lssm/lib.contracts/llm";const o={defaultAgent:`generic-mcp`,verbose:!1};var s=class{config;constructor(e={}){this.config={...o,...e}}generateGuide(t,n={}){let i=e(n.agent??this.config.defaultAgent),o=r(t,{projectRoot:this.config.projectRoot,existingFiles:n.targetPath?[n.targetPath]:void 0});return{plan:o,prompt:i.formatPlan(o),markdown:a(t)}}generateFeatureGuide(t,i,a={}){let o=e(a.agent??this.config.defaultAgent),s=t.operations?.[0],c=s?i.specs?.getSpec(s.name,s.version):void 0,l;c?(l=r(c,{projectRoot:this.config.projectRoot}),l.target={type:`feature`,name:t.meta.key,version:1},l.context.goal=t.meta.description??l.context.goal):l={target:{type:`feature`,name:t.meta.key,version:1},context:{goal:t.meta.description??`Implement feature ${t.meta.key}`,description:t.meta.title??t.meta.key,background:``},specMarkdown:n(t,i),fileStructure:[],steps:[{order:1,title:`Implement Feature`,description:`Implement the ${t.meta.key} feature`,acceptanceCriteria:[]}],constraints:{policy:[],security:[],pii:[]},verificationChecklist:[]},l.specMarkdown=n(t,i,{format:`full`,includeRelatedSpecs:!0,includeRelatedEvents:!0,includeRelatedPresentations:!0}),t.operations?.length&&(l.steps=t.operations.map((e,t)=>({order:t+1,title:`Implement ${e.name}`,description:`Implement operation ${e.name}.v${e.version}`,acceptanceCriteria:[`Operation ${e.name} works as specified`]})));let u=o.formatPlan(l),d=n(t,i);return{plan:l,prompt:u,markdown:d}}generateAgentConfig(t,n){return e(n??this.config.defaultAgent).generateConfig?.(t)}exportForAgent(e,t,n=`implement`,r){return i(e,{taskType:n,existingCode:r})}listAgentTypes(){return t()}getDefaultAgent(){return this.config.defaultAgent}configure(e){this.config={...this.config,...e}}};function c(e){return new s(e)}const l=new s;export{s as AgentGuideService,l as agentGuideService,c as createAgentGuideService};

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

@@ -1,5 +1 @@
-import { ClaudeCodeAdapter, claudeCodeAdapter } from "./adapters/claude-code.js";
-import { CursorCLIAdapter, cursorCLIAdapter } from "./adapters/cursor-cli.js";
-import { GenericMCPAdapter, genericMCPAdapter } from "./adapters/generic-mcp.js";
-import { agentAdapters, getAgentAdapter, listAgentTypes } from "./adapters/index.js";
-import { AgentGuideService, agentGuideService, createAgentGuideService } from "./agent-guide-service.js";
+import{ClaudeCodeAdapter as e,claudeCodeAdapter as t}from"./adapters/claude-code.js";import{CursorCLIAdapter as n,cursorCLIAdapter as r}from"./adapters/cursor-cli.js";import{GenericMCPAdapter as i,genericMCPAdapter as a}from"./adapters/generic-mcp.js";import{agentAdapters as o,getAgentAdapter as s,listAgentTypes as c}from"./adapters/index.js";import{AgentGuideService as l,agentGuideService as u,createAgentGuideService as d}from"./agent-guide-service.js";