@lssm/bundle.contractspec-workspace 0.0.0-canary-20251217060834 → 0.0.0-canary-20251217072406

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

@@ -0,0 +1,89 @@
+import { toPascalCase } from "./utils.js";
+
+//#region ../../modules/contractspec-workspace/dist/templates/telemetry.js
+function generateTelemetrySpec(data) {
+	const specVar = toPascalCase(data.name.split(".").pop() ?? "Telemetry") + "Telemetry";
+	const providers = data.providers?.length ? `providers: [
+${data.providers.map((provider) => `      {
+        type: '${provider.type}',
+        config: ${formatConfigValue(provider.config)},
+      }`).join(",\n")}
+    ],` : "";
+	const events = data.events.map((event) => {
+		const properties = event.properties.map((prop) => `      '${prop.name}': {
+        type: '${prop.type}',
+        ${prop.required ? "required: true," : ""}
+        ${prop.pii ? "pii: true," : ""}
+        ${prop.redact ? "redact: true," : ""}
+        ${prop.description ? `description: '${escapeString(prop.description)}',` : ""}
+      }`).join(",\n");
+		const anomalyRules = event.anomalyRules?.length ? `      anomalyDetection: {
+        enabled: true,
+        ${typeof event.anomalyMinimumSample === "number" ? `minimumSample: ${event.anomalyMinimumSample},` : ""}
+        thresholds: [
+${event.anomalyRules.map((rule) => `          {
+            metric: '${escapeString(rule.metric)}',
+            ${typeof rule.min === "number" ? `min: ${rule.min},` : ""}
+            ${typeof rule.max === "number" ? `max: ${rule.max},` : ""}
+          }`).join(",\n")}
+        ],
+        actions: [${(event.anomalyActions ?? []).map((action) => `'${action}'`).join(", ")}],
+      },` : event.anomalyEnabled ? `      anomalyDetection: {
+        enabled: true,
+        ${typeof event.anomalyMinimumSample === "number" ? `minimumSample: ${event.anomalyMinimumSample},` : ""}
+      },` : "";
+		return `    {
+      name: '${escapeString(event.name)}',
+      version: ${event.version},
+      semantics: {
+        what: '${escapeString(event.what)}',
+        ${event.who ? `who: '${escapeString(event.who)}',` : ""}
+        ${event.why ? `why: '${escapeString(event.why)}',` : ""}
+      },
+      privacy: '${event.privacy}',
+      properties: {
+${properties}
+      },
+      ${typeof event.retentionDays === "number" ? `retention: { days: ${event.retentionDays}, ${event.retentionPolicy ? `policy: '${event.retentionPolicy}'` : ""} },` : ""}
+      ${typeof event.samplingRate === "number" ? `sampling: { rate: ${event.samplingRate}${event.samplingConditions ? `, conditions: ['${escapeString(event.samplingConditions)}']` : ""} },` : ""}
+${anomalyRules}
+      ${event.tags?.length ? `tags: [${event.tags.map((tag) => `'${escapeString(tag)}'`).join(", ")}],` : ""}
+    }`;
+	}).join(",\n");
+	return `import type { TelemetrySpec } from '@lssm/lib.contracts/telemetry';
+
+export const ${specVar}: TelemetrySpec = {
+  meta: {
+    name: '${escapeString(data.name)}',
+    version: ${data.version},
+    title: '${escapeString(data.name)} telemetry',
+    description: '${escapeString(data.description || "Describe the purpose of this telemetry spec.")}',
+    domain: '${escapeString(data.domain)}',
+    owners: [${data.owners.map((owner) => `'${escapeString(owner)}'`).join(", ")}],
+    tags: [${data.tags.map((tag) => `'${escapeString(tag)}'`).join(", ")}],
+    stability: '${data.stability}',
+  },
+  config: {
+    ${typeof data.defaultRetentionDays === "number" ? `defaultRetentionDays: ${data.defaultRetentionDays},` : ""}
+    ${typeof data.defaultSamplingRate === "number" ? `defaultSamplingRate: ${data.defaultSamplingRate},` : ""}
+    ${data.anomalyEnabled ? `anomalyDetection: { enabled: true${typeof data.anomalyCheckIntervalMs === "number" ? `, checkIntervalMs: ${data.anomalyCheckIntervalMs}` : ""} },` : ""}
+${providers}
+  },
+  events: [
+${events}
+  ],
+};
+`;
+}
+function escapeString(value) {
+	return value.replace(/\\/g, "\\\\").replace(/'/g, "\\'");
+}
+function formatConfigValue(value) {
+	const trimmed = value.trim();
+	if (!trimmed) return "{}";
+	if (trimmed.startsWith("{") && trimmed.endsWith("}") || trimmed.startsWith("[") && trimmed.endsWith("]")) return trimmed;
+	return `'${escapeString(trimmed)}'`;
+}
+
+//#endregion
+export { generateTelemetrySpec };

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

@@ -0,0 +1,38 @@
+//#region ../../modules/contractspec-workspace/dist/templates/utils.js
+/**
+* Utility functions for template generation.
+*/
+/**
+* Convert string to camelCase.
+*/
+function toCamelCase(str) {
+	const pascal = toPascalCase(str);
+	return pascal.charAt(0).toLowerCase() + pascal.slice(1);
+}
+/**
+* Convert string to PascalCase.
+*/
+function toPascalCase(str) {
+	return str.split(/[-_.]/).map((word) => word.charAt(0).toUpperCase() + word.slice(1)).join("");
+}
+/**
+* Convert string to kebab-case.
+*/
+function toKebabCase(str) {
+	return str.replace(/\./g, "-").replace(/([a-z])([A-Z])/g, "$1-$2").toLowerCase();
+}
+/**
+* Capitalize first letter.
+*/
+function capitalize(str) {
+	return str.charAt(0).toUpperCase() + str.slice(1);
+}
+/**
+* Escape single quotes in string.
+*/
+function escapeString(value) {
+	return value.replace(/'/g, "\\'");
+}
+
+//#endregion
+export { capitalize, escapeString, toCamelCase, toKebabCase, toPascalCase };

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

@@ -0,0 +1,48 @@
+//#region ../../modules/contractspec-workspace/dist/templates/workflow-runner.js
+function generateWorkflowRunnerTemplate({ exportName, specImportPath, runnerName, workflowName }) {
+	return `import {
+  InMemoryStateStore,
+  WorkflowRegistry,
+  WorkflowRunner,
+} from '@lssm/lib.contracts/workflow';
+import { ${exportName} } from '${specImportPath}';
+
+/**
+ * Runner wiring for ${workflowName}.
+ *
+ * TODO:
+ *  - Replace the in-memory state store with a persistent adapter if needed.
+ *  - Implement opExecutor to invoke the correct contract handlers.
+ *  - Wire eventEmitter to telemetry sinks.
+ */
+const registry = new WorkflowRegistry();
+registry.register(${exportName});
+
+const stateStore = new InMemoryStateStore();
+
+export const ${runnerName} = new WorkflowRunner({
+  registry,
+  stateStore,
+  opExecutor: async (operation, input, ctx) => {
+    // TODO: route to the appropriate contract handler
+    // Example: return contractRegistry.execute(operation.name, operation.version, input, ctx);
+    throw new Error(
+      \`opExecutor for \${operation.name}.v\${operation.version} is not implemented\`
+    );
+  },
+  // appConfigProvider: async (state) => {
+  //   // TODO: return the ResolvedAppConfig for this workflow run (tenant/environment)
+  //   return undefined;
+  // },
+  // enforceCapabilities: async (operation, context) => {
+  //   // TODO: ensure required capabilities are satisfied using context.integrations/context.resolvedAppConfig
+  // },
+  eventEmitter: (_event, _payload) => {
+    // TODO: forward workflow events to telemetry or logging sinks
+  },
+});
+`;
+}
+
+//#endregion
+export { generateWorkflowRunnerTemplate };

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

@@ -0,0 +1,67 @@
+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.
+ * TODO:
+ *  - Review step definitions and descriptions.
+ *  - Wire automation steps to actual operations.
+ *  - Provide form renderers for human steps.
+ *  - Add guards/conditions as needed.
+ */
+export const ${specVarName}: WorkflowSpec = {
+  meta: {
+    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: {
+${data.entryStepId ? `    entryStepId: '${data.entryStepId}',\n` : ""}    steps: [
+${stepsCode}
+    ],
+    transitions: [
+${transitionsCode}
+    ],
+  },
+  ${data.policyFlags.length > 0 ? `policy: {
+    flags: [${data.policyFlags.map((flag) => `'${flag}'`).join(", ")}],
+  },` : "// policy: { flags: [] },"}
+};
+`;
+}
+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

@@ -0,0 +1,20 @@
+//#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{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};
+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{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};
+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 };