@lssm/bundle.contractspec-workspace 0.0.0-canary-20251217052941 → 0.0.0-canary-20251217060433

package/dist/adapters/ai.d.ts

@@ -0,0 +1,11 @@
+import { AiAdapter } from "../ports/ai.js";
+import { WorkspaceConfig } from "@lssm/module.contractspec-workspace";
+
+//#region src/adapters/ai.d.ts
+
+/**
+ * Create a Node.js AI adapter using Vercel AI SDK.
+ */
+declare function createNodeAiAdapter(config: WorkspaceConfig): AiAdapter;
+//#endregion
+export { createNodeAiAdapter };

package/dist/adapters/factory.d.ts

@@ -0,0 +1,28 @@
+import { WorkspaceAdapters } from "../ports/logger.js";
+import { WorkspaceConfig } from "@lssm/module.contractspec-workspace";
+
+//#region src/adapters/factory.d.ts
+
+/**
+ * Options for creating adapters.
+ */
+interface CreateAdaptersOptions {
+  /**
+   * Working directory for file operations.
+   */
+  cwd?: string;
+  /**
+   * Workspace configuration for AI.
+   */
+  config?: WorkspaceConfig;
+  /**
+   * Use no-op logger (for testing).
+   */
+  silent?: boolean;
+}
+/**
+ * Create all Node.js adapters with default configuration.
+ */
+declare function createNodeAdapters(options?: CreateAdaptersOptions): WorkspaceAdapters;
+//#endregion
+export { CreateAdaptersOptions, createNodeAdapters };

package/dist/adapters/fs.d.ts

@@ -0,0 +1,10 @@
+import { FsAdapter } from "../ports/fs.js";
+
+//#region src/adapters/fs.d.ts
+
+/**
+ * Create a Node.js filesystem adapter.
+ */
+declare function createNodeFsAdapter(cwd?: string): FsAdapter;
+//#endregion
+export { createNodeFsAdapter };

package/dist/adapters/git.d.ts

@@ -0,0 +1,10 @@
+import { GitAdapter } from "../ports/git.js";
+
+//#region src/adapters/git.d.ts
+
+/**
+ * Create a Node.js git adapter.
+ */
+declare function createNodeGitAdapter(cwd?: string): GitAdapter;
+//#endregion
+export { createNodeGitAdapter };

package/dist/adapters/index.d.ts

@@ -0,0 +1,7 @@
+import { createNodeFsAdapter } from "./fs.js";
+import { createNodeGitAdapter } from "./git.js";
+import { createNodeWatcherAdapter } from "./watcher.js";
+import { createNodeAiAdapter } from "./ai.js";
+import { createConsoleLoggerAdapter, createNoopLoggerAdapter } from "./logger.js";
+import { CreateAdaptersOptions, createNodeAdapters } from "./factory.js";
+import { PackageManager, WorkspaceInfo, detectPackageManager, findPackageRoot, findWorkspaceRoot, getExecCommand, getInstallCommand, getPackageName, getRunCommand, getWorkspaceInfo, getWorkspacePackages, isMonorepo } from "./workspace.js";

package/dist/adapters/logger.d.ts

@@ -0,0 +1,17 @@
+import { LoggerAdapter } from "../ports/logger.js";
+
+//#region src/adapters/logger.d.ts
+
+/**
+ * Create a console-based logger adapter.
+ * This is a basic implementation - CLI apps should inject their own
+ * logger with chalk/ora for better terminal output.
+ */
+declare function createConsoleLoggerAdapter(): LoggerAdapter;
+/**
+ * Create a no-op logger adapter.
+ * Useful for testing or when logging is not desired.
+ */
+declare function createNoopLoggerAdapter(): LoggerAdapter;
+//#endregion
+export { createConsoleLoggerAdapter, createNoopLoggerAdapter };

package/dist/adapters/watcher.d.ts

@@ -0,0 +1,10 @@
+import { WatcherAdapter } from "../ports/watcher.js";
+
+//#region src/adapters/watcher.d.ts
+
+/**
+ * Create a Node.js file watcher adapter using chokidar.
+ */
+declare function createNodeWatcherAdapter(cwd?: string): WatcherAdapter;
+//#endregion
+export { createNodeWatcherAdapter };

package/dist/adapters/workspace.d.ts

@@ -0,0 +1,93 @@
+//#region src/adapters/workspace.d.ts
+/**
+ * Workspace and monorepo detection utilities.
+ *
+ * Provides utilities for detecting workspace roots, package managers,
+ * and monorepo configurations across Bun, pnpm, Yarn, and npm.
+ */
+/**
+ * Supported package managers.
+ */
+type PackageManager = 'bun' | 'pnpm' | 'yarn' | 'npm';
+/**
+ * Workspace detection result.
+ */
+interface WorkspaceInfo {
+  /**
+   * The detected package manager.
+   */
+  packageManager: PackageManager;
+  /**
+   * Root of the workspace (monorepo root or single package root).
+   */
+  workspaceRoot: string;
+  /**
+   * Root of the current package (may differ from workspaceRoot in monorepos).
+   */
+  packageRoot: string;
+  /**
+   * Whether this is a monorepo.
+   */
+  isMonorepo: boolean;
+  /**
+   * List of package paths in monorepo (relative to workspaceRoot).
+   */
+  packages?: string[];
+  /**
+   * Name of the current package (from package.json).
+   */
+  packageName?: string;
+}
+/**
+ * Find the nearest directory containing a package.json.
+ */
+declare function findPackageRoot(startDir?: string): string;
+/**
+ * Find the workspace root (monorepo root or single package root).
+ *
+ * Walks up the directory tree looking for:
+ * 1. pnpm-workspace.yaml (pnpm monorepo)
+ * 2. package.json with "workspaces" field (yarn/npm/bun monorepo)
+ * 3. Lock files (bun.lockb, pnpm-lock.yaml, yarn.lock, package-lock.json)
+ */
+declare function findWorkspaceRoot(startDir?: string): string;
+/**
+ * Detect the package manager in use.
+ *
+ * Priority:
+ * 1. Lock file presence (most reliable)
+ * 2. packageManager field in package.json
+ * 3. COREPACK_ROOT environment variable
+ * 4. Default to npm
+ */
+declare function detectPackageManager(workspaceRoot?: string): PackageManager;
+/**
+ * Check if the workspace is a monorepo.
+ */
+declare function isMonorepo(workspaceRoot?: string): boolean;
+/**
+ * Get workspace package patterns from package.json or pnpm-workspace.yaml.
+ */
+declare function getWorkspacePackages(workspaceRoot: string): string[] | undefined;
+/**
+ * Get package name from package.json.
+ */
+declare function getPackageName(packageRoot: string): string | undefined;
+/**
+ * Get complete workspace information.
+ */
+declare function getWorkspaceInfo(startDir?: string): WorkspaceInfo;
+/**
+ * Get the run command for the detected package manager.
+ */
+declare function getRunCommand(packageManager: PackageManager, script: string): string;
+/**
+ * Get the exec command for the detected package manager.
+ */
+declare function getExecCommand(packageManager: PackageManager, command: string): string;
+/**
+ * Get the install command for the detected package manager.
+ */
+declare function getInstallCommand(packageManager: PackageManager, isDev?: boolean): string;
+//#endregion
+export { PackageManager, WorkspaceInfo, detectPackageManager, findPackageRoot, findWorkspaceRoot, getExecCommand, getInstallCommand, getPackageName, getRunCommand, getWorkspaceInfo, getWorkspacePackages, isMonorepo };

package/dist/ai/agents/claude-code-agent.d.ts

@@ -0,0 +1,21 @@
+import { AgentProvider, AgentResult, AgentTask } from "./types.js";
+
+//#region src/ai/agents/claude-code-agent.d.ts
+
+declare class ClaudeCodeAgent implements AgentProvider {
+  name: "claude-code";
+  private apiKey;
+  constructor();
+  canHandle(task: AgentTask): boolean;
+  generate(task: AgentTask): Promise<AgentResult>;
+  validate(task: AgentTask): Promise<AgentResult>;
+  private buildSystemPrompt;
+  private buildUserPrompt;
+  private extractCode;
+  private detectIssues;
+  private extractErrors;
+  private extractWarnings;
+  private extractSuggestions;
+}
+//#endregion
+export { ClaudeCodeAgent };

package/dist/ai/agents/cursor-agent.d.ts

@@ -0,0 +1,67 @@
+import { AgentProvider, AgentResult, AgentTask } from "./types.js";
+
+//#region src/ai/agents/cursor-agent.d.ts
+
+declare class CursorAgent implements AgentProvider {
+  name: "cursor";
+  private cursorPath;
+  private isWindsurf;
+  private composerPort;
+  constructor();
+  canHandle(task: AgentTask): boolean;
+  generate(task: AgentTask): Promise<AgentResult>;
+  validate(task: AgentTask): Promise<AgentResult>;
+  /**
+   * Detect if running in Cursor/Windsurf environment
+   */
+  private detectEnvironment;
+  /**
+   * Execute task using the best available method
+   */
+  private executeWithBestMethod;
+  /**
+   * Use Windsurf's native API
+   */
+  /**
+   * Use Cursor Composer API
+   */
+  /**
+   * Use Cursor CLI directly
+   */
+  private useCursorCLI;
+  /**
+   * File-based approach - create workspace and instructions for manual completion
+   */
+  private useFileBasedApproach;
+  /**
+   * Setup workspace for validation
+   */
+  private setupValidationWorkspace;
+  /**
+   * Prepare files for API submission
+   */
+  private prepareFilesForAPI;
+  /**
+   * Build detailed prompt for cursor
+   */
+  private buildDetailedPrompt;
+  /**
+   * Build validation-specific prompt
+   */
+  private buildValidationPrompt;
+  /**
+   * Generate basic template for task
+   */
+  private generateTemplate;
+  /**
+   * Cleanup temporary work directory
+   */
+  private cleanupWorkDir;
+  private isCursorAvailable;
+  /**
+   * Check if Cursor Composer API might be available
+   */
+  private hasComposerAPI;
+}
+//#endregion
+export { CursorAgent };

package/dist/ai/agents/openai-codex-agent.d.ts

@@ -0,0 +1,21 @@
+import { AgentProvider, AgentResult, AgentTask } from "./types.js";
+
+//#region src/ai/agents/openai-codex-agent.d.ts
+
+declare class OpenAICodexAgent implements AgentProvider {
+  name: "openai-codex";
+  private apiKey;
+  constructor();
+  canHandle(task: AgentTask): boolean;
+  generate(task: AgentTask): Promise<AgentResult>;
+  validate(task: AgentTask): Promise<AgentResult>;
+  private isComplexTask;
+  private buildSystemPrompt;
+  private buildUserPrompt;
+  private extractCode;
+  private detectIssues;
+  private extractErrors;
+  private extractWarnings;
+}
+//#endregion
+export { OpenAICodexAgent };

package/dist/ai/agents/orchestrator.d.ts

@@ -0,0 +1,49 @@
+import { Config } from "../../types/config.js";
+import { AgentMode, AgentResult, AgentTask } from "./types.js";
+
+//#region src/ai/agents/orchestrator.d.ts
+
+declare class AgentOrchestrator {
+  private config;
+  private agents;
+  private defaultAgent;
+  constructor(config: Config);
+  /**
+   * Execute a task using the configured agent with fallback support
+   */
+  executeTask(task: AgentTask): Promise<AgentResult>;
+  /**
+   * Generate code from specification
+   */
+  generate(specCode: string, targetPath?: string): Promise<AgentResult>;
+  /**
+   * Generate tests for implementation
+   */
+  generateTests(specCode: string, implementationCode: string): Promise<AgentResult>;
+  /**
+   * Validate implementation against specification
+   */
+  validate(specCode: string, implementationCode: string): Promise<AgentResult>;
+  /**
+   * Refactor existing code
+   */
+  refactor(specCode: string, existingCode: string): Promise<AgentResult>;
+  /**
+   * List available agents and their status
+   */
+  getAvailableAgents(): Promise<{
+    mode: AgentMode;
+    available: boolean;
+    reason?: string;
+  }[]>;
+  /**
+   * Get the configured agent mode
+   */
+  private getAgentMode;
+  /**
+   * Get fallback mode for an agent
+   */
+  private getFallbackMode;
+}
+//#endregion
+export { AgentOrchestrator };

package/dist/ai/agents/simple-agent.d.ts

@@ -0,0 +1,16 @@
+import { Config } from "../../types/config.js";
+import { AgentProvider, AgentResult, AgentTask } from "./types.js";
+
+//#region src/ai/agents/simple-agent.d.ts
+
+declare class SimpleAgent implements AgentProvider {
+  private config;
+  name: "simple";
+  constructor(config: Config);
+  canHandle(task: AgentTask): boolean;
+  generate(task: AgentTask): Promise<AgentResult>;
+  validate(task: AgentTask): Promise<AgentResult>;
+  private buildPrompt;
+}
+//#endregion
+export { SimpleAgent };

package/dist/ai/agents/types.d.ts

@@ -0,0 +1,35 @@
+//#region src/ai/agents/types.d.ts
+/**
+ * Agent types and interfaces for code generation and validation
+ */
+type AgentMode = 'simple' | 'cursor' | 'claude-code' | 'openai-codex';
+interface AgentTask {
+  type: 'generate' | 'validate' | 'refactor' | 'test';
+  specCode: string;
+  existingCode?: string;
+  targetPath?: string;
+  options?: Record<string, unknown>;
+}
+interface AgentResult {
+  success: boolean;
+  code?: string;
+  errors?: string[];
+  warnings?: string[];
+  suggestions?: string[];
+  metadata?: Record<string, unknown>;
+}
+interface AgentProvider {
+  name: AgentMode;
+  generate(task: AgentTask): Promise<AgentResult>;
+  validate(task: AgentTask): Promise<AgentResult>;
+  canHandle(task: AgentTask): boolean;
+}
+interface AgentConfig {
+  mode: AgentMode;
+  fallbackMode?: AgentMode;
+  timeout?: number;
+  retries?: number;
+  options?: Record<string, unknown>;
+}
+//#endregion
+export { AgentConfig, AgentMode, AgentProvider, AgentResult, AgentTask };

package/dist/ai/client.d.ts

@@ -0,0 +1,82 @@
+import { Config } from "../types/config.js";
+import { OpKind, PresentationKind } from "../types.js";
+
+//#region src/ai/client.d.ts
+
+/**
+ * AI Client for spec creation and code generation
+ */
+declare class AIClient {
+  private config;
+  constructor(config: Config);
+  /**
+   * Generate operation spec from natural language description
+   */
+  generateOperationSpec(description: string, kind: OpKind): Promise<{
+    name: string;
+    version: number;
+    description: string;
+    goal: string;
+    context: string;
+    stability: "experimental" | "beta" | "stable" | "deprecated";
+    owners: string[];
+    tags: string[];
+    auth: "anonymous" | "user" | "admin";
+    inputShape: string;
+    outputShape: string;
+    flags: string[];
+    possibleEvents: string[];
+    analytics: string[];
+  }>;
+  /**
+   * Generate event spec from description
+   */
+  generateEventSpec(description: string): Promise<{
+    name: string;
+    version: number;
+    description: string;
+    stability: "experimental" | "beta" | "stable" | "deprecated";
+    owners: string[];
+    tags: string[];
+    payloadShape: string;
+    piiFields: string[];
+  }>;
+  /**
+   * Generate presentation spec from description
+   */
+  generatePresentationSpec(description: string, kind: PresentationKind): Promise<{
+    name: string;
+    version: number;
+    description: string;
+    stability: "experimental" | "beta" | "stable" | "deprecated";
+    owners: string[];
+    tags: string[];
+    componentKey?: string | undefined;
+    propsShape?: string | undefined;
+    content?: string | undefined;
+    mimeType?: string | undefined;
+    dataShape?: string | undefined;
+  }>;
+  /**
+   * Generate handler implementation from spec
+   */
+  generateHandler(specCode: string): Promise<string>;
+  /**
+   * Generate React component from presentation spec
+   */
+  generateComponent(specCode: string): Promise<string>;
+  /**
+   * Generate form component from form spec
+   */
+  generateForm(specCode: string): Promise<string>;
+  /**
+   * Generate tests for implementation
+   */
+  generateTests(specCode: string, implementationCode: string, testType: 'handler' | 'component'): Promise<string>;
+  /**
+   * Stream code generation for better UX
+   */
+  streamCodeGeneration(prompt: string, onChunk: (text: string) => void): Promise<string>;
+}
+//#endregion
+export { AIClient };

package/dist/ai/index.d.ts

@@ -0,0 +1,16 @@
+import { AIClient } from "./client.js";
+import { getAIProvider, getRecommendedModels, validateProvider } from "./providers.js";
+import { AgentConfig, AgentMode, AgentProvider, AgentResult, AgentTask } from "./agents/types.js";
+import { AgentOrchestrator } from "./agents/orchestrator.js";
+import { SimpleAgent } from "./agents/simple-agent.js";
+import { CursorAgent } from "./agents/cursor-agent.js";
+import { ClaudeCodeAgent } from "./agents/claude-code-agent.js";
+import { OpenAICodexAgent } from "./agents/openai-codex-agent.js";
+import { index_d_exports as index_d_exports$1 } from "./prompts/index.js";
+
+//#region src/ai/index.d.ts
+declare namespace index_d_exports {
+  export { AIClient, AgentConfig, AgentMode, AgentOrchestrator, AgentProvider, AgentResult, AgentTask, ClaudeCodeAgent, CursorAgent, OpenAICodexAgent, SimpleAgent, getAIProvider, getRecommendedModels, index_d_exports$1 as prompts, validateProvider };
+}
+//#endregion
+export { index_d_exports };

package/dist/ai/prompts/code-generation.d.ts

@@ -0,0 +1,25 @@
+declare namespace code_generation_d_exports {
+  export { buildComponentPrompt, buildFormPrompt, buildHandlerPrompt, buildTestPrompt, getCodeGenSystemPrompt };
+}
+/**
+ * Build prompt for generating handler implementation
+ */
+declare function buildHandlerPrompt(specCode: string): string;
+/**
+ * Build prompt for generating React component from presentation spec
+ */
+declare function buildComponentPrompt(specCode: string): string;
+/**
+ * Build prompt for generating form component
+ */
+declare function buildFormPrompt(specCode: string): string;
+/**
+ * Build prompt for generating tests
+ */
+declare function buildTestPrompt(specCode: string, implementationCode: string, testType: 'handler' | 'component'): string;
+/**
+ * System prompt for code generation
+ */
+declare function getCodeGenSystemPrompt(): string;
+//#endregion
+export { code_generation_d_exports };

package/dist/ai/prompts/index.d.ts

@@ -0,0 +1,9 @@
+import { code_generation_d_exports } from "./code-generation.js";
+import { spec_creation_d_exports } from "./spec-creation.js";
+
+//#region src/ai/prompts/index.d.ts
+declare namespace index_d_exports {
+  export { code_generation_d_exports as codeGeneration, spec_creation_d_exports as specCreation };
+}
+//#endregion
+export { index_d_exports };

package/dist/ai/prompts/spec-creation.d.ts

@@ -0,0 +1,28 @@
+import { OpKind, PresentationKind } from "../../types.js";
+
+//#region src/ai/prompts/spec-creation.d.ts
+declare namespace spec_creation_d_exports {
+  export { addExampleContext, buildEventSpecPrompt, buildOperationSpecPrompt, buildPresentationSpecPrompt, getSystemPrompt };
+}
+/**
+ * Build prompt for creating operation spec from description
+ */
+declare function buildOperationSpecPrompt(description: string, kind: OpKind): string;
+/**
+ * Build prompt for creating event spec from description
+ */
+declare function buildEventSpecPrompt(description: string): string;
+/**
+ * Build prompt for creating presentation spec from description
+ */
+declare function buildPresentationSpecPrompt(description: string, kind: PresentationKind): string;
+/**
+ * Build system prompt for all spec generation
+ */
+declare function getSystemPrompt(): string;
+/**
+ * Create example-based prompt for better results
+ */
+declare function addExampleContext(basePrompt: string, examples: string[]): string;
+//#endregion
+export { spec_creation_d_exports };

package/dist/ai/providers.d.ts

@@ -0,0 +1,28 @@
+import { Config } from "../types/config.js";
+import { LanguageModel } from "ai";
+
+//#region src/ai/providers.d.ts
+
+/**
+ * Initialize AI provider based on configuration
+ *
+ * @deprecated Use createProvider() from @lssm/lib.ai-providers instead
+ */
+declare function getAIProvider(config: Config): LanguageModel;
+/**
+ * Validate that the provider is accessible and working
+ *
+ * @deprecated Use validateProvider() from @lssm/lib.ai-providers instead
+ */
+declare function validateProvider(config: Config): Promise<{
+  success: boolean;
+  error?: string;
+}>;
+/**
+ * Get recommended models for each provider
+ *
+ * @deprecated Use getModelsForProvider() from @lssm/lib.ai-providers instead
+ */
+declare function getRecommendedModels(provider: Config['aiProvider']): string[];
+//#endregion
+export { getAIProvider, getRecommendedModels, validateProvider };

package/dist/formatters/index.d.ts

@@ -0,0 +1,10 @@
+import { SarifFormatOptions, SarifOutput, formatAsSarif, sarifToJson } from "./sarif.js";
+import { JsonCompactOutput, JsonFormatOptions, JsonFullOutput, JsonIssueCompact, formatAsJson, formatAsJsonCompact, formatAsJsonFull } from "./json.js";
+import { TextFormatOptions, TextLine, formatAsText, formatAsTextLines } from "./text.js";
+
+//#region src/formatters/index.d.ts
+declare namespace index_d_exports {
+  export { JsonCompactOutput, JsonFormatOptions, JsonFullOutput, JsonIssueCompact, SarifFormatOptions, SarifOutput, TextFormatOptions, TextLine, formatAsJson, formatAsJsonCompact, formatAsJsonFull, formatAsSarif, formatAsText, formatAsTextLines, sarifToJson };
+}
+//#endregion
+export { index_d_exports };