@contractspec/bundle.workspace 1.44.0

package/dist/ports/fs.d.ts

@@ -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.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"fs.d.ts","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.ts

@@ -0,0 +1,33 @@
+//#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>;
+}
+/**
+ * Options for git clean.
+ */
+interface GitCleanOptions {
+  dryRun?: boolean;
+  force?: boolean;
+  directories?: boolean;
+  ignored?: boolean;
+}
+//#endregion
+export { GitAdapter, GitCleanOptions };
+//# sourceMappingURL=git.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"git.d.ts","names":[],"sources":["../../src/ports/git.ts"],"sourcesContent":[],"mappings":";;AAOA;;;;;AAcmC,UAdlB,UAAA,CAckB;EAMlB;;;2CAhB0B;;;;kBAKzB,kBAAkB;;;;4BAKR;;;;;UAMX,eAAA"}

package/dist/ports/index.d.ts

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

package/dist/ports/logger.d.ts

@@ -0,0 +1,88 @@
+import { FsAdapter } from "./fs.js";
+import { GitAdapter } from "./git.js";
+import { WatcherAdapter } from "./watcher.js";
+import { AiAdapter } from "./ai.js";
+
+//#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.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"logger.d.ts","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/watcher.d.ts

@@ -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.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"watcher.d.ts","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.ts

@@ -0,0 +1,35 @@
+import { AgentAdapter } from "../types.js";
+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.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"claude-code.d.ts","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.js

@@ -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.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"claude-code.js","names":["lines: string[]","errors: string[]"],"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":"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"}

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

@@ -0,0 +1,39 @@
+import { AgentAdapter } from "../types.js";
+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.ts.map

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

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

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

@@ -0,0 +1,135 @@
+import { AGENT_SYSTEM_PROMPTS } from "@contractspec/lib.contracts/llm";
+
+//#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.key}.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.key}.v${m.version}`);
+		lines.push(`globs: ["**/${m.key.replace(/\./g, "/")}/**"]`);
+		lines.push("alwaysApply: false");
+		lines.push("---");
+		lines.push("");
+		lines.push(`# ${m.key} 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.key}.v${e.ref.version}\`: ${e.when}`);
+			else lines.push(`- \`${e.key}.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.key}`);
+				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.key.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 };
+//# sourceMappingURL=cursor-cli.js.map