@contractspec/bundle.workspace 1.46.2 → 1.48.0

package/dist/ports/fs.d.mts

@@ -0,0 +1,81 @@
+//#region src/ports/fs.d.ts
+/**
+ * Filesystem adapter port.
+ */
+/**
+ * File statistics.
+ */
+interface FileStat {
+  size: number;
+  isFile: boolean;
+  isDirectory: boolean;
+  mtime: Date;
+}
+/**
+ * Options for file discovery.
+ */
+interface DiscoverOptions {
+  pattern?: string;
+  patterns?: string[];
+  ignore?: string[];
+  /** Working directory for glob patterns. Defaults to process.cwd(). */
+  cwd?: string;
+  /** Return absolute paths instead of relative. Defaults to true. */
+  absolute?: boolean;
+}
+/**
+ * Filesystem adapter interface.
+ */
+interface FsAdapter {
+  /**
+   * Check if a file or directory exists.
+   */
+  exists(path: string): Promise<boolean>;
+  /**
+   * Read file contents as string.
+   */
+  readFile(path: string): Promise<string>;
+  /**
+   * Write file contents.
+   */
+  writeFile(path: string, content: string): Promise<void>;
+  /**
+   * Delete a file or directory.
+   */
+  remove(path: string): Promise<void>;
+  /**
+   * Get file statistics.
+   */
+  stat(path: string): Promise<FileStat>;
+  /**
+   * Create directory (recursive).
+   */
+  mkdir(path: string): Promise<void>;
+  /**
+   * Discover files matching patterns.
+   */
+  glob(options: DiscoverOptions): Promise<string[]>;
+  /**
+   * Resolve path relative to cwd.
+   */
+  resolve(...paths: string[]): string;
+  /**
+   * Get directory name from path.
+   */
+  dirname(path: string): string;
+  /**
+   * Get base name from path.
+   */
+  basename(path: string): string;
+  /**
+   * Join path segments.
+   */
+  join(...paths: string[]): string;
+  /**
+   * Get relative path from base.
+   */
+  relative(from: string, to: string): string;
+}
+//#endregion
+export { DiscoverOptions, FileStat, FsAdapter };
+//# sourceMappingURL=fs.d.mts.map

package/dist/ports/fs.d.mts.map

@@ -0,0 +1 @@
+{"version":3,"file":"fs.d.mts","names":[],"sources":["../../src/ports/fs.ts"],"sourcesContent":[],"mappings":";;AAOA;AAUA;AAaA;;;AAc4C,UArC3B,QAAA,CAqC2B;EAKpB,IAAA,EAAA,MAAA;EAKM,MAAA,EAAA,OAAA;EAAR,WAAA,EAAA,OAAA;EAKC,KAAA,EAhDd,IAgDc;;;;;UA1CN,eAAA;;;;;;;;;;;;UAaA,SAAA;;;;wBAIO;;;;0BAKE;;;;4CAKkB;;;;wBAKpB;;;;sBAKF,QAAQ;;;;uBAKP;;;;gBAKP,kBAAkB"}

package/dist/ports/git.d.mts

@@ -0,0 +1,46 @@
+//#region src/ports/git.d.ts
+/**
+ * Git adapter port.
+ */
+/**
+ * Git adapter interface.
+ */
+interface GitAdapter {
+  /**
+   * Get file contents at a specific git ref (branch, tag, commit).
+   */
+  showFile(ref: string, filePath: string): Promise<string>;
+  /**
+   * Clean untracked files (dangerous operation).
+   */
+  clean(options?: GitCleanOptions): Promise<void>;
+  /**
+   * Check if path is inside a git repository.
+   */
+  isGitRepo(path?: string): Promise<boolean>;
+  /**
+   * Get commit log since a baseline ref.
+   */
+  log(baseline?: string): Promise<GitLogEntry[]>;
+}
+/**
+ * Entry from git log.
+ */
+interface GitLogEntry {
+  hash: string;
+  message: string;
+  author?: string;
+  date?: string;
+}
+/**
+ * Options for git clean.
+ */
+interface GitCleanOptions {
+  dryRun?: boolean;
+  force?: boolean;
+  directories?: boolean;
+  ignored?: boolean;
+}
+//#endregion
+export { GitAdapter, GitCleanOptions, GitLogEntry };
+//# sourceMappingURL=git.d.mts.map

package/dist/ports/git.d.mts.map

@@ -0,0 +1 @@
+{"version":3,"file":"git.d.mts","names":[],"sources":["../../src/ports/git.ts"],"sourcesContent":[],"mappings":";;AAOA;;;;;AAmBkC,UAnBjB,UAAA,CAmBiB;EAAR;;AAM1B;EAUiB,QAAA,CAAA,GAAA,EAAA,MAAe,EAAA,QAAA,EAAA,MAAA,CAAA,EA/BW,OA+BX,CAAA,MAAA,CAAA;;;;kBA1Bd,kBAAkB;;;;4BAKR;;;;0BAKF,QAAQ;;;;;UAMjB,WAAA;;;;;;;;;UAUA,eAAA"}

package/dist/ports/index.d.mts

@@ -0,0 +1,6 @@
+import { DiscoverOptions, FileStat, FsAdapter } from "./fs.mjs";
+import { GitAdapter, GitCleanOptions, GitLogEntry } from "./git.mjs";
+import { WatchEvent, WatchEventHandler, WatchEventType, WatchOptions, Watcher, WatcherAdapter } from "./watcher.mjs";
+import { AiAdapter, AiGenerateOptions, AiGenerateResult, AiGenerateStructuredOptions, AiValidationResult } from "./ai.mjs";
+import { LogLevel, LoggerAdapter, ProgressReporter, ProgressUpdate, WorkspaceAdapters } from "./logger.mjs";
+import { RuleSyncOptions, RuleSyncPort, RuleSyncResult } from "./rulesync.mjs";

package/dist/ports/logger.d.mts

@@ -0,0 +1,88 @@
+import { FsAdapter } from "./fs.mjs";
+import { GitAdapter } from "./git.mjs";
+import { WatcherAdapter } from "./watcher.mjs";
+import { AiAdapter } from "./ai.mjs";
+
+//#region src/ports/logger.d.ts
+/**
+ * Logger and progress reporter port.
+ */
+/**
+ * Log level.
+ */
+type LogLevel = 'debug' | 'info' | 'warn' | 'error';
+/**
+ * Progress update.
+ */
+interface ProgressUpdate {
+  message: string;
+  current?: number;
+  total?: number;
+}
+/**
+ * Progress reporter for long-running operations.
+ */
+interface ProgressReporter {
+  /**
+   * Start progress reporting.
+   */
+  start(message: string): void;
+  /**
+   * Update progress.
+   */
+  update(update: ProgressUpdate): void;
+  /**
+   * Mark as succeeded.
+   */
+  succeed(message?: string): void;
+  /**
+   * Mark as failed.
+   */
+  fail(message?: string): void;
+  /**
+   * Mark as warned.
+   */
+  warn(message?: string): void;
+  /**
+   * Stop progress reporting.
+   */
+  stop(): void;
+}
+/**
+ * Logger adapter interface.
+ */
+interface LoggerAdapter {
+  /**
+   * Log debug message.
+   */
+  debug(message: string, data?: Record<string, unknown>): void;
+  /**
+   * Log info message.
+   */
+  info(message: string, data?: Record<string, unknown>): void;
+  /**
+   * Log warning message.
+   */
+  warn(message: string, data?: Record<string, unknown>): void;
+  /**
+   * Log error message.
+   */
+  error(message: string, data?: Record<string, unknown>): void;
+  /**
+   * Create a progress reporter.
+   */
+  createProgress(): ProgressReporter;
+}
+/**
+ * Combined adapters for workspace services.
+ */
+interface WorkspaceAdapters {
+  fs: FsAdapter;
+  git: GitAdapter;
+  watcher: WatcherAdapter;
+  ai: AiAdapter;
+  logger: LoggerAdapter;
+}
+//#endregion
+export { LogLevel, LoggerAdapter, ProgressReporter, ProgressUpdate, WorkspaceAdapters };
+//# sourceMappingURL=logger.d.mts.map

package/dist/ports/logger.d.mts.map

@@ -0,0 +1 @@
+{"version":3,"file":"logger.d.mts","names":[],"sources":["../../src/ports/logger.ts"],"sourcesContent":[],"mappings":";;;;;;;;;;;;AAOY,KAAA,QAAA,GAAQ,OAAA,GAAA,MAAA,GAAA,MAAA,GAAA,OAAA;AAKpB;AASA;AAmCA;AAIgC,UAhDf,cAAA,CAgDe;EAKD,OAAA,EAAA,MAAA;EAKA,OAAA,CAAA,EAAA,MAAA;EAKC,KAAA,CAAA,EAAA,MAAA;;;AAWhC;;AAC8B,UAlEb,gBAAA,CAkEa;EACG;;;EAGV,KAAA,CAAA,OAAA,EAAA,MAAA,CAAA,EAAA,IAAA;;;;iBA7DN;;;;;;;;;;;;;;;;;;;;;UA0BA,aAAA;;;;gCAIe;;;;+BAKD;;;;+BAKA;;;;gCAKC;;;;oBAKZ;;;;;UAMH,iBAAA;MAAiB;OACJ;WACG;MACY;UAEnC"}

package/dist/ports/rulesync.d.mts

@@ -0,0 +1,38 @@
+import { RuleSyncConfig, RuleSyncTarget } from "@contractspec/lib.contracts";
+
+//#region src/ports/rulesync.d.ts
+
+interface RuleSyncOptions {
+  /** Root directory of the workspace */
+  cwd: string;
+  /** Configuration for rule synchronization */
+  config: RuleSyncConfig;
+  /** Specific targets to sync (overrides config.targets if provided) */
+  targets?: RuleSyncTarget[];
+  /** Dry run mode (don't write files) */
+  dryRun?: boolean;
+}
+interface RuleSyncResult {
+  /** Whether the synchronization was successful */
+  success: boolean;
+  /** List of files created or updated */
+  files: string[];
+  /** Errors encountered during synchronization */
+  errors?: string[];
+  /** Optional logs from the synchronization process */
+  logs?: string[];
+}
+interface RuleSyncPort {
+  /**
+   * Synchronize rules based on the provided options.
+   */
+  sync(options: RuleSyncOptions): Promise<RuleSyncResult>;
+  /**
+   * Generate the rulesync configuration without executing the sync.
+   * Useful for "ejecting" to raw rulesync usage.
+   */
+  generateConfig(options: RuleSyncOptions): Promise<string>;
+}
+//#endregion
+export { RuleSyncOptions, RuleSyncPort, RuleSyncResult };
+//# sourceMappingURL=rulesync.d.mts.map

package/dist/ports/rulesync.d.mts.map

@@ -0,0 +1 @@
+{"version":3,"file":"rulesync.d.mts","names":[],"sources":["../../src/ports/rulesync.ts"],"sourcesContent":[],"mappings":";;;;AAoBiB,UAXA,eAAA,CAWc;EAWd;EAID,GAAA,EAAA,MAAA;EAA0B;EAAR,MAAA,EAtBxB,cAsBwB;EAMR;EAAkB,OAAA,CAAA,EA1BhC,cA0BgC,EAAA;EAAO;;;UArBlC,cAAA;;;;;;;;;;UAWA,YAAA;;;;gBAID,kBAAkB,QAAQ;;;;;0BAMhB,kBAAkB"}

package/dist/ports/watcher.d.mts

@@ -0,0 +1,52 @@
+//#region src/ports/watcher.d.ts
+/**
+ * File watcher adapter port.
+ */
+/**
+ * Watcher event types.
+ */
+type WatchEventType = 'add' | 'change' | 'unlink';
+/**
+ * Watcher event.
+ */
+interface WatchEvent {
+  type: WatchEventType;
+  path: string;
+}
+/**
+ * Watcher event handler.
+ */
+type WatchEventHandler = (event: WatchEvent) => void | Promise<void>;
+/**
+ * Options for file watching.
+ */
+interface WatchOptions {
+  pattern: string;
+  ignore?: string[];
+  debounceMs?: number;
+}
+/**
+ * Watcher instance.
+ */
+interface Watcher {
+  /**
+   * Register event handler.
+   */
+  on(handler: WatchEventHandler): void;
+  /**
+   * Stop watching.
+   */
+  close(): Promise<void>;
+}
+/**
+ * File watcher adapter interface.
+ */
+interface WatcherAdapter {
+  /**
+   * Start watching files matching pattern.
+   */
+  watch(options: WatchOptions): Watcher;
+}
+//#endregion
+export { WatchEvent, WatchEventHandler, WatchEventType, WatchOptions, Watcher, WatcherAdapter };
+//# sourceMappingURL=watcher.d.mts.map

package/dist/ports/watcher.d.mts.map

@@ -0,0 +1 @@
+{"version":3,"file":"watcher.d.mts","names":[],"sources":["../../src/ports/watcher.ts"],"sourcesContent":[],"mappings":";;AAOA;AAKA;AAQA;AAKA;AASA;AAeiB,KA1CL,cAAA,GA0CmB,KAId,GAAA,QAAA,GAAe,QAAO;;;;UAzCtB,UAAA;QACT;;;;;;KAOI,iBAAA,WAA4B,sBAAsB;;;;UAK7C,YAAA;;;;;;;;UASA,OAAA;;;;cAIH;;;;WAKH;;;;;UAMM,cAAA;;;;iBAIA,eAAe"}

package/dist/services/agent-guide/adapters/claude-code.d.mts

@@ -0,0 +1,35 @@
+import { AgentAdapter } from "../types.mjs";
+import { AnyOperationSpec } from "@contractspec/lib.contracts";
+import { AgentPrompt, ImplementationPlan } from "@contractspec/lib.contracts/llm";
+
+//#region src/services/agent-guide/adapters/claude-code.d.ts
+
+/**
+ * Claude Code adapter implementation.
+ * Optimized for Claude's extended thinking and code generation capabilities.
+ */
+declare class ClaudeCodeAdapter implements AgentAdapter {
+  agentType: "claude-code";
+  /**
+   * Format an implementation plan for Claude Code.
+   * Uses structured markdown with clear sections and checklists.
+   */
+  formatPlan(plan: ImplementationPlan): AgentPrompt;
+  /**
+   * Generate agent-specific configuration.
+   * For Claude Code, this generates a prompt that can be used as context.
+   */
+  generateConfig(spec: AnyOperationSpec): string;
+  /**
+   * Parse Claude Code output to extract generated code.
+   */
+  parseOutput(output: string): {
+    code?: string;
+    errors?: string[];
+  };
+}
+/** Singleton instance */
+declare const claudeCodeAdapter: ClaudeCodeAdapter;
+//#endregion
+export { ClaudeCodeAdapter, claudeCodeAdapter };
+//# sourceMappingURL=claude-code.d.mts.map

package/dist/services/agent-guide/adapters/claude-code.d.mts.map

@@ -0,0 +1 @@
+{"version":3,"file":"claude-code.d.mts","names":[],"sources":["../../../../src/services/agent-guide/adapters/claude-code.ts"],"sourcesContent":[],"mappings":";;;;;;;;AAoNA;;cAjMa,iBAAA,YAA6B;;;;;;mBAOvB,qBAAqB;;;;;uBAyHjB;;;;;;;;;;cAiEV,mBAAiB"}

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

@@ -0,0 +1,144 @@
+import { AGENT_SYSTEM_PROMPTS } from "@contractspec/lib.contracts/llm";
+
+//#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.key}.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.key}`);
+		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 };
+//# sourceMappingURL=claude-code.mjs.map

package/dist/services/agent-guide/adapters/claude-code.mjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"claude-code.mjs","names":[],"sources":["../../../../src/services/agent-guide/adapters/claude-code.ts"],"sourcesContent":["/**\n * Claude Code Agent Adapter\n *\n * Formats implementation plans and prompts for Claude Code (Anthropic's\n * advanced coding agent mode).\n */\n\nimport type { AnyOperationSpec } from '@contractspec/lib.contracts';\nimport type {\n  AgentPrompt,\n  ImplementationPlan,\n} from '@contractspec/lib.contracts/llm';\nimport { AGENT_SYSTEM_PROMPTS } from '@contractspec/lib.contracts/llm';\nimport type { AgentAdapter } from '../types';\n\n/**\n * Claude Code adapter implementation.\n * Optimized for Claude's extended thinking and code generation capabilities.\n */\nexport class ClaudeCodeAdapter implements AgentAdapter {\n  agentType = 'claude-code' as const;\n\n  /**\n   * Format an implementation plan for Claude Code.\n   * Uses structured markdown with clear sections and checklists.\n   */\n  formatPlan(plan: ImplementationPlan): AgentPrompt {\n    const lines: string[] = [];\n\n    // Header\n    lines.push(`# Implement: ${plan.target.key}.v${plan.target.version}`);\n    lines.push('');\n\n    // Context section\n    lines.push('## Context');\n    lines.push('');\n    lines.push(`**Goal:** ${plan.context.goal}`);\n    lines.push('');\n    lines.push(`**Description:** ${plan.context.description}`);\n    lines.push('');\n    if (plan.context.background) {\n      lines.push(`**Background:**`);\n      lines.push(plan.context.background);\n      lines.push('');\n    }\n\n    // Full specification\n    lines.push('## Specification');\n    lines.push('');\n    lines.push(plan.specMarkdown);\n    lines.push('');\n\n    // File structure\n    if (plan.fileStructure.length > 0) {\n      lines.push('## Files to Create/Modify');\n      lines.push('');\n      for (const file of plan.fileStructure) {\n        const icon = file.type === 'create' ? '📝' : '✏️';\n        lines.push(`${icon} \\`${file.path}\\``);\n        lines.push(`   ${file.purpose}`);\n        lines.push('');\n      }\n    }\n\n    // Implementation steps\n    lines.push('## Implementation Steps');\n    lines.push('');\n    for (const step of plan.steps) {\n      lines.push(`### ${step.order}. ${step.title}`);\n      lines.push('');\n      lines.push(step.description);\n      lines.push('');\n      lines.push('**Acceptance Criteria:**');\n      for (const criteria of step.acceptanceCriteria) {\n        lines.push(`- [ ] ${criteria}`);\n      }\n      lines.push('');\n    }\n\n    // Constraints\n    if (\n      plan.constraints.policy.length > 0 ||\n      plan.constraints.security.length > 0 ||\n      plan.constraints.pii.length > 0\n    ) {\n      lines.push('## Constraints');\n      lines.push('');\n\n      if (plan.constraints.policy.length > 0) {\n        lines.push('### Policy');\n        for (const p of plan.constraints.policy) {\n          lines.push(`- ${p}`);\n        }\n        lines.push('');\n      }\n\n      if (plan.constraints.security.length > 0) {\n        lines.push('### Security');\n        for (const s of plan.constraints.security) {\n          lines.push(`- ⚠️ ${s}`);\n        }\n        lines.push('');\n      }\n\n      if (plan.constraints.pii.length > 0) {\n        lines.push('### PII Handling');\n        lines.push(\n          'The following fields contain personally identifiable information:'\n        );\n        for (const pii of plan.constraints.pii) {\n          lines.push(`- \\`${pii}\\``);\n        }\n        lines.push('');\n      }\n    }\n\n    // Verification checklist\n    lines.push('## Verification Checklist');\n    lines.push('');\n    lines.push('Before submitting, verify:');\n    for (const check of plan.verificationChecklist) {\n      lines.push(`- [ ] ${check}`);\n    }\n    lines.push('');\n\n    // Instructions\n    lines.push('## Instructions');\n    lines.push('');\n    lines.push('1. Implement each step in order');\n    lines.push('2. Use TypeScript with strict typing (no `any`)');\n    lines.push('3. Include JSDoc comments for public APIs');\n    lines.push('4. Handle all error cases defined in the spec');\n    lines.push('5. Emit events as specified');\n    lines.push('6. Mark checklist items as you complete them');\n    lines.push('');\n\n    return {\n      agent: 'claude-code',\n      systemPrompt: AGENT_SYSTEM_PROMPTS['claude-code'],\n      taskPrompt: lines.join('\\n'),\n    };\n  }\n\n  /**\n   * Generate agent-specific configuration.\n   * For Claude Code, this generates a prompt that can be used as context.\n   */\n  generateConfig(spec: AnyOperationSpec): string {\n    const lines: string[] = [];\n\n    lines.push('# ContractSpec Implementation Context');\n    lines.push('');\n    lines.push('This codebase uses ContractSpec for spec-first development.');\n    lines.push('');\n    lines.push('## Spec Details');\n    lines.push('');\n    lines.push(`- **Name:** ${spec.meta.key}`);\n    lines.push(`- **Version:** ${spec.meta.version}`);\n    lines.push(`- **Kind:** ${spec.meta.kind}`);\n    lines.push(`- **Stability:** ${spec.meta.stability}`);\n    lines.push('');\n    lines.push('## Implementation Requirements');\n    lines.push('');\n    lines.push('1. Match input/output types exactly');\n    lines.push('2. Handle all defined error cases');\n    lines.push('3. Emit events as specified');\n    lines.push('4. Respect policy constraints');\n    lines.push('');\n\n    return lines.join('\\n');\n  }\n\n  /**\n   * Parse Claude Code output to extract generated code.\n   */\n  parseOutput(output: string): { code?: string; errors?: string[] } {\n    // Extract code from markdown code blocks\n    const codeBlockMatch = output.match(\n      /```(?:typescript|ts|tsx)?\\n([\\s\\S]*?)\\n```/\n    );\n\n    if (codeBlockMatch?.[1]) {\n      return { code: codeBlockMatch[1] };\n    }\n\n    // Check for error indicators\n    const errors: string[] = [];\n    const errorPatterns = [\n      /error:\\s*(.+)/gi,\n      /failed:\\s*(.+)/gi,\n      /cannot\\s+(.+)/gi,\n    ];\n\n    for (const pattern of errorPatterns) {\n      const matches = output.matchAll(pattern);\n      for (const match of matches) {\n        if (match[1]) {\n          errors.push(match[1]);\n        }\n      }\n    }\n\n    if (errors.length > 0) {\n      return { errors };\n    }\n\n    // Return raw output if no code block found\n    return { code: output };\n  }\n}\n\n/** Singleton instance */\nexport const claudeCodeAdapter = new ClaudeCodeAdapter();\n"],"mappings":";;;;;;;AAmBA,IAAa,oBAAb,MAAuD;CACrD,YAAY;;;;;CAMZ,WAAW,MAAuC;EAChD,MAAM,QAAkB,EAAE;AAG1B,QAAM,KAAK,gBAAgB,KAAK,OAAO,IAAI,IAAI,KAAK,OAAO,UAAU;AACrE,QAAM,KAAK,GAAG;AAGd,QAAM,KAAK,aAAa;AACxB,QAAM,KAAK,GAAG;AACd,QAAM,KAAK,aAAa,KAAK,QAAQ,OAAO;AAC5C,QAAM,KAAK,GAAG;AACd,QAAM,KAAK,oBAAoB,KAAK,QAAQ,cAAc;AAC1D,QAAM,KAAK,GAAG;AACd,MAAI,KAAK,QAAQ,YAAY;AAC3B,SAAM,KAAK,kBAAkB;AAC7B,SAAM,KAAK,KAAK,QAAQ,WAAW;AACnC,SAAM,KAAK,GAAG;;AAIhB,QAAM,KAAK,mBAAmB;AAC9B,QAAM,KAAK,GAAG;AACd,QAAM,KAAK,KAAK,aAAa;AAC7B,QAAM,KAAK,GAAG;AAGd,MAAI,KAAK,cAAc,SAAS,GAAG;AACjC,SAAM,KAAK,4BAA4B;AACvC,SAAM,KAAK,GAAG;AACd,QAAK,MAAM,QAAQ,KAAK,eAAe;IACrC,MAAM,OAAO,KAAK,SAAS,WAAW,OAAO;AAC7C,UAAM,KAAK,GAAG,KAAK,KAAK,KAAK,KAAK,IAAI;AACtC,UAAM,KAAK,MAAM,KAAK,UAAU;AAChC,UAAM,KAAK,GAAG;;;AAKlB,QAAM,KAAK,0BAA0B;AACrC,QAAM,KAAK,GAAG;AACd,OAAK,MAAM,QAAQ,KAAK,OAAO;AAC7B,SAAM,KAAK,OAAO,KAAK,MAAM,IAAI,KAAK,QAAQ;AAC9C,SAAM,KAAK,GAAG;AACd,SAAM,KAAK,KAAK,YAAY;AAC5B,SAAM,KAAK,GAAG;AACd,SAAM,KAAK,2BAA2B;AACtC,QAAK,MAAM,YAAY,KAAK,mBAC1B,OAAM,KAAK,SAAS,WAAW;AAEjC,SAAM,KAAK,GAAG;;AAIhB,MACE,KAAK,YAAY,OAAO,SAAS,KACjC,KAAK,YAAY,SAAS,SAAS,KACnC,KAAK,YAAY,IAAI,SAAS,GAC9B;AACA,SAAM,KAAK,iBAAiB;AAC5B,SAAM,KAAK,GAAG;AAEd,OAAI,KAAK,YAAY,OAAO,SAAS,GAAG;AACtC,UAAM,KAAK,aAAa;AACxB,SAAK,MAAM,KAAK,KAAK,YAAY,OAC/B,OAAM,KAAK,KAAK,IAAI;AAEtB,UAAM,KAAK,GAAG;;AAGhB,OAAI,KAAK,YAAY,SAAS,SAAS,GAAG;AACxC,UAAM,KAAK,eAAe;AAC1B,SAAK,MAAM,KAAK,KAAK,YAAY,SAC/B,OAAM,KAAK,QAAQ,IAAI;AAEzB,UAAM,KAAK,GAAG;;AAGhB,OAAI,KAAK,YAAY,IAAI,SAAS,GAAG;AACnC,UAAM,KAAK,mBAAmB;AAC9B,UAAM,KACJ,oEACD;AACD,SAAK,MAAM,OAAO,KAAK,YAAY,IACjC,OAAM,KAAK,OAAO,IAAI,IAAI;AAE5B,UAAM,KAAK,GAAG;;;AAKlB,QAAM,KAAK,4BAA4B;AACvC,QAAM,KAAK,GAAG;AACd,QAAM,KAAK,6BAA6B;AACxC,OAAK,MAAM,SAAS,KAAK,sBACvB,OAAM,KAAK,SAAS,QAAQ;AAE9B,QAAM,KAAK,GAAG;AAGd,QAAM,KAAK,kBAAkB;AAC7B,QAAM,KAAK,GAAG;AACd,QAAM,KAAK,kCAAkC;AAC7C,QAAM,KAAK,kDAAkD;AAC7D,QAAM,KAAK,4CAA4C;AACvD,QAAM,KAAK,gDAAgD;AAC3D,QAAM,KAAK,8BAA8B;AACzC,QAAM,KAAK,+CAA+C;AAC1D,QAAM,KAAK,GAAG;AAEd,SAAO;GACL,OAAO;GACP,cAAc,qBAAqB;GACnC,YAAY,MAAM,KAAK,KAAK;GAC7B;;;;;;CAOH,eAAe,MAAgC;EAC7C,MAAM,QAAkB,EAAE;AAE1B,QAAM,KAAK,wCAAwC;AACnD,QAAM,KAAK,GAAG;AACd,QAAM,KAAK,8DAA8D;AACzE,QAAM,KAAK,GAAG;AACd,QAAM,KAAK,kBAAkB;AAC7B,QAAM,KAAK,GAAG;AACd,QAAM,KAAK,eAAe,KAAK,KAAK,MAAM;AAC1C,QAAM,KAAK,kBAAkB,KAAK,KAAK,UAAU;AACjD,QAAM,KAAK,eAAe,KAAK,KAAK,OAAO;AAC3C,QAAM,KAAK,oBAAoB,KAAK,KAAK,YAAY;AACrD,QAAM,KAAK,GAAG;AACd,QAAM,KAAK,iCAAiC;AAC5C,QAAM,KAAK,GAAG;AACd,QAAM,KAAK,sCAAsC;AACjD,QAAM,KAAK,oCAAoC;AAC/C,QAAM,KAAK,8BAA8B;AACzC,QAAM,KAAK,gCAAgC;AAC3C,QAAM,KAAK,GAAG;AAEd,SAAO,MAAM,KAAK,KAAK;;;;;CAMzB,YAAY,QAAsD;EAEhE,MAAM,iBAAiB,OAAO,MAC5B,6CACD;AAED,MAAI,iBAAiB,GACnB,QAAO,EAAE,MAAM,eAAe,IAAI;EAIpC,MAAM,SAAmB,EAAE;AAO3B,OAAK,MAAM,WANW;GACpB;GACA;GACA;GACD,EAEoC;GACnC,MAAM,UAAU,OAAO,SAAS,QAAQ;AACxC,QAAK,MAAM,SAAS,QAClB,KAAI,MAAM,GACR,QAAO,KAAK,MAAM,GAAG;;AAK3B,MAAI,OAAO,SAAS,EAClB,QAAO,EAAE,QAAQ;AAInB,SAAO,EAAE,MAAM,QAAQ;;;;AAK3B,MAAa,oBAAoB,IAAI,mBAAmB"}

package/dist/services/agent-guide/adapters/cursor-cli.d.mts

@@ -0,0 +1,39 @@
+import { AgentAdapter } from "../types.mjs";
+import { AnyOperationSpec } from "@contractspec/lib.contracts";
+import { AgentPrompt, ImplementationPlan } from "@contractspec/lib.contracts/llm";
+
+//#region src/services/agent-guide/adapters/cursor-cli.d.ts
+
+/**
+ * Cursor CLI adapter implementation.
+ * Optimized for Cursor's background/composer mode.
+ */
+declare class CursorCLIAdapter implements AgentAdapter {
+  agentType: "cursor-cli";
+  /**
+   * Format an implementation plan for Cursor CLI.
+   * Uses concise format optimized for Cursor's context window.
+   */
+  formatPlan(plan: ImplementationPlan): AgentPrompt;
+  /**
+   * Generate Cursor rules (.mdc format) for a spec.
+   * Can be saved to .cursor/rules/ to provide persistent context.
+   */
+  generateConfig(spec: AnyOperationSpec): string;
+  /**
+   * Generate a cursor rules file path for a spec.
+   */
+  getCursorRulesPath(spec: AnyOperationSpec): string;
+  /**
+   * Parse Cursor output to extract generated code.
+   */
+  parseOutput(output: string): {
+    code?: string;
+    errors?: string[];
+  };
+}
+/** Singleton instance */
+declare const cursorCLIAdapter: CursorCLIAdapter;
+//#endregion
+export { CursorCLIAdapter, cursorCLIAdapter };
+//# sourceMappingURL=cursor-cli.d.mts.map

package/dist/services/agent-guide/adapters/cursor-cli.d.mts.map

@@ -0,0 +1 @@
+{"version":3,"file":"cursor-cli.d.mts","names":[],"sources":["../../../../src/services/agent-guide/adapters/cursor-cli.ts"],"sourcesContent":[],"mappings":";;;;;;;;;AAqNA;cAlMa,gBAAA,YAA4B;;;;;;mBAOtB,qBAAqB;;;;;uBAoEjB;;;;2BA+FI;;;;;;;;;;cAwBd,kBAAgB"}