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

package/dist/formatters/json.d.ts

@@ -0,0 +1,88 @@
+import { CICheckResult } from "../services/ci-check/types.js";
+
+//#region src/formatters/json.d.ts
+
+/**
+ * Options for JSON formatting.
+ */
+interface JsonFormatOptions {
+  /** Pretty print with indentation. */
+  pretty?: boolean;
+  /** Include full issue details. */
+  includeDetails?: boolean;
+  /** Include category summaries. */
+  includeSummaries?: boolean;
+}
+/**
+ * Compact JSON output structure.
+ */
+interface JsonCompactOutput {
+  success: boolean;
+  errors: number;
+  warnings: number;
+  duration: number;
+  timestamp: string;
+  commit?: string;
+  branch?: string;
+  issues: JsonIssueCompact[];
+}
+/**
+ * Compact issue representation.
+ */
+interface JsonIssueCompact {
+  rule: string;
+  severity: string;
+  message: string;
+  file?: string;
+  line?: number;
+}
+/**
+ * Full JSON output structure.
+ */
+interface JsonFullOutput {
+  success: boolean;
+  summary: {
+    totalErrors: number;
+    totalWarnings: number;
+    totalNotes: number;
+    durationMs: number;
+    timestamp: string;
+    commitSha?: string;
+    branch?: string;
+  };
+  categories: {
+    category: string;
+    label: string;
+    passed: boolean;
+    errors: number;
+    warnings: number;
+    notes: number;
+    durationMs: number;
+  }[];
+  issues: {
+    ruleId: string;
+    severity: string;
+    message: string;
+    category: string;
+    file?: string;
+    line?: number;
+    column?: number;
+    endLine?: number;
+    endColumn?: number;
+    context?: Record<string, unknown>;
+  }[];
+}
+/**
+ * Format CI check results as compact JSON.
+ */
+declare function formatAsJsonCompact(result: CICheckResult): JsonCompactOutput;
+/**
+ * Format CI check results as full JSON with all details.
+ */
+declare function formatAsJsonFull(result: CICheckResult): JsonFullOutput;
+/**
+ * Format CI check results as JSON.
+ */
+declare function formatAsJson(result: CICheckResult, options?: JsonFormatOptions): string;
+//#endregion
+export { JsonCompactOutput, JsonFormatOptions, JsonFullOutput, JsonIssueCompact, formatAsJson, formatAsJsonCompact, formatAsJsonFull };

package/dist/formatters/sarif.d.ts

@@ -0,0 +1,100 @@
+import { CICheckResult } from "../services/ci-check/types.js";
+
+//#region src/formatters/sarif.d.ts
+
+/**
+ * SARIF v2.1.0 output structure.
+ */
+interface SarifOutput {
+  $schema: string;
+  version: string;
+  runs: SarifRun[];
+}
+interface SarifRun {
+  tool: {
+    driver: {
+      name: string;
+      version: string;
+      informationUri: string;
+      rules: SarifRule[];
+    };
+  };
+  results: SarifResult[];
+  invocations: SarifInvocation[];
+  versionControlProvenance?: SarifVersionControl[];
+}
+interface SarifRule {
+  id: string;
+  name: string;
+  shortDescription: {
+    text: string;
+  };
+  fullDescription?: {
+    text: string;
+  };
+  defaultConfiguration: {
+    level: 'error' | 'warning' | 'note' | 'none';
+  };
+  helpUri?: string;
+}
+interface SarifResult {
+  ruleId: string;
+  ruleIndex: number;
+  level: 'error' | 'warning' | 'note' | 'none';
+  message: {
+    text: string;
+  };
+  locations?: SarifLocation[];
+  partialFingerprints?: Record<string, string>;
+}
+interface SarifLocation {
+  physicalLocation: {
+    artifactLocation: {
+      uri: string;
+      uriBaseId?: string;
+    };
+    region?: {
+      startLine?: number;
+      startColumn?: number;
+      endLine?: number;
+      endColumn?: number;
+    };
+  };
+}
+interface SarifInvocation {
+  executionSuccessful: boolean;
+  endTimeUtc: string;
+  workingDirectory?: {
+    uri: string;
+  };
+}
+interface SarifVersionControl {
+  repositoryUri?: string;
+  revisionId?: string;
+  branch?: string;
+}
+/**
+ * Options for SARIF formatting.
+ */
+interface SarifFormatOptions {
+  /** Tool name. */
+  toolName?: string;
+  /** Tool version. */
+  toolVersion?: string;
+  /** Tool information URI. */
+  toolUri?: string;
+  /** Repository URI for version control provenance. */
+  repositoryUri?: string;
+  /** Working directory. */
+  workingDirectory?: string;
+}
+/**
+ * Format CI check results as SARIF.
+ */
+declare function formatAsSarif(result: CICheckResult, options?: SarifFormatOptions): SarifOutput;
+/**
+ * Serialize SARIF output to JSON string.
+ */
+declare function sarifToJson(sarif: SarifOutput): string;
+//#endregion
+export { SarifFormatOptions, SarifOutput, formatAsSarif, sarifToJson };

package/dist/formatters/text.d.ts

@@ -0,0 +1,34 @@
+import { CICheckResult } from "../services/ci-check/types.js";
+
+//#region src/formatters/text.d.ts
+
+/**
+ * Options for text formatting.
+ */
+interface TextFormatOptions {
+  /** Show verbose output with all details. */
+  verbose?: boolean;
+  /** Include timing information. */
+  showTiming?: boolean;
+  /** Group issues by file. */
+  groupByFile?: boolean;
+}
+/**
+ * Text output lines with optional styling hints.
+ */
+interface TextLine {
+  text: string;
+  style?: 'normal' | 'bold' | 'error' | 'warning' | 'success' | 'muted';
+  indent?: number;
+}
+/**
+ * Format CI check results as text lines.
+ * Returns structured lines that can be styled by the CLI.
+ */
+declare function formatAsTextLines(result: CICheckResult, options?: TextFormatOptions): TextLine[];
+/**
+ * Format CI check results as plain text string.
+ */
+declare function formatAsText(result: CICheckResult, options?: TextFormatOptions): string;
+//#endregion
+export { TextFormatOptions, TextLine, formatAsText, formatAsTextLines };

package/dist/index.d.ts

@@ -0,0 +1,69 @@
+import { DiscoverOptions, FileStat, FsAdapter } from "./ports/fs.js";
+import { GitAdapter, GitCleanOptions } from "./ports/git.js";
+import { WatchEvent, WatchEventHandler, WatchEventType, WatchOptions, Watcher, WatcherAdapter } from "./ports/watcher.js";
+import { AiAdapter, AiGenerateOptions, AiGenerateResult, AiGenerateStructuredOptions, AiValidationResult } from "./ports/ai.js";
+import { LogLevel, LoggerAdapter, ProgressReporter, ProgressUpdate, WorkspaceAdapters } from "./ports/logger.js";
+import "./ports/index.js";
+import { createNodeFsAdapter } from "./adapters/fs.js";
+import { createNodeGitAdapter } from "./adapters/git.js";
+import { createNodeWatcherAdapter } from "./adapters/watcher.js";
+import { createNodeAiAdapter } from "./adapters/ai.js";
+import { createConsoleLoggerAdapter, createNoopLoggerAdapter } from "./adapters/logger.js";
+import { CreateAdaptersOptions, createNodeAdapters } from "./adapters/factory.js";
+import { PackageManager, WorkspaceInfo, detectPackageManager, findPackageRoot, findWorkspaceRoot, getExecCommand, getInstallCommand, getPackageName, getRunCommand, getWorkspaceInfo, getWorkspacePackages, isMonorepo } from "./adapters/workspace.js";
+import "./adapters/index.js";
+import { AgentMode, AiProvider, Config } from "./types/config.js";
+import { ValidateSpecOptions, ValidateSpecResult, validateSpec, validateSpecs } from "./services/validate.js";
+import { ValidateImplementationOptions, ValidateImplementationResult, validateImplementationFiles } from "./services/validate-implementation.js";
+import { CompareSpecsOptions, CompareSpecsResult, compareSpecs } from "./services/diff.js";
+import { AnalyzeDepsOptions, AnalyzeDepsResult, analyzeDeps, exportGraphAsDot, getContractNode, getGraphStats } from "./services/deps.js";
+import { ListSpecsOptions, groupSpecsByType, listSpecs } from "./services/list.js";
+import { getApiKey, loadWorkspaceConfig, mergeWorkspaceConfig } from "./services/config.js";
+import { BuildSpecOptions, BuildSpecResult, BuildTarget, BuildTargetResult, buildSpec } from "./services/build.js";
+import { OpenApiExportServiceOptions, OpenApiExportServiceResult, OpenApiImportServiceOptions, OpenApiImportServiceResult, OpenApiSourceConfig, OpenApiSyncServiceOptions, OpenApiSyncServiceResult, OpenApiValidateServiceOptions, OpenApiValidateServiceResult } from "./services/openapi/types.js";
+import { importFromOpenApiService } from "./services/openapi/import-service.js";
+import { syncWithOpenApiService } from "./services/openapi/sync-service.js";
+import { validateAgainstOpenApiService } from "./services/openapi/validate-service.js";
+import { OpenApiExportOptions, OpenApiExportResult, exportOpenApi } from "./services/openapi/export-service.js";
+import { RegistryClient, RegistryClientOptions, addToRegistry, listFromRegistry, resolveRegistryUrl, searchRegistry } from "./services/registry.js";
+import { SyncBuildFn, SyncSpecsOptions, SyncSpecsResult, SyncSpecsRunResult, SyncValidateFn, syncSpecs } from "./services/sync.js";
+import { WatchBuildFn, WatchSpecsOptions, WatchValidateFn, watchSpecs } from "./services/watch.js";
+import { CleanOptions, CleanResult, cleanArtifacts } from "./services/clean.js";
+import { RunTestsResult, TestRunResult, runTests } from "./services/test.js";
+import { CreateRegeneratorOptions, createRegeneratorService } from "./services/regenerator.js";
+import { ExtendedWorkspaceInfo, MonorepoConfig, findAllConfigFiles, formatWorkspaceInfo, getExtendedWorkspaceInfo, mergeMonorepoConfigs } from "./services/workspace-info.js";
+import { CoverageByType, IntegrityAnalysisOptions, IntegrityAnalysisResult, IntegrityIssue, SpecInventory, SpecLocation, analyzeIntegrity, filterIssuesBySeverity, filterIssuesByType, getAllSpecs } from "./services/integrity.js";
+import { DiagramOptions, DiagramType, generateMermaidDiagram } from "./services/integrity-diagram.js";
+import { ALL_SETUP_TARGETS, SETUP_TARGET_LABELS, SetupFileResult, SetupOptions, SetupPromptCallbacks, SetupResult, SetupScope, SetupTarget } from "./services/setup/types.js";
+import { runSetup } from "./services/setup/setup-service.js";
+import { generateAgentsMd, generateClaudeMcpConfig, generateContractsrcConfig, generateCursorMcpConfig, generateCursorRules, generateVscodeSettings, getClaudeDesktopConfigPath } from "./services/setup/config-generators.js";
+import { deepMergeOverwrite, deepMergePreserve, formatJson, safeParseJson } from "./services/setup/file-merger.js";
+import { ALL_CHECK_CATEGORIES, CHECK_CATEGORY_LABELS, CheckCategory, CheckContext, CheckResult, CheckStatus, DoctorOptions, DoctorPromptCallbacks, DoctorResult, FixAction, FixResult } from "./services/doctor/types.js";
+import { formatCheckResult, formatDoctorSummary, runDoctor } from "./services/doctor/doctor-service.js";
+import { ALL_CI_CHECK_CATEGORIES, CICheckCategory, CICheckCategorySummary, CICheckOptions, CICheckResult, CIFormatOptions, CIIssue, CIIssueSeverity, CIOutputFormat, CI_CHECK_CATEGORY_LABELS } from "./services/ci-check/types.js";
+import { runCIChecks } from "./services/ci-check/ci-check-service.js";
+import { AgentAdapter, AgentGuideConfig, FormatOptions, GuideOptions, GuideResult } from "./services/agent-guide/types.js";
+import { AgentGuideService, agentGuideService, createAgentGuideService } from "./services/agent-guide/agent-guide-service.js";
+import { ClaudeCodeAdapter, claudeCodeAdapter } from "./services/agent-guide/adapters/claude-code.js";
+import { CursorCLIAdapter, cursorCLIAdapter } from "./services/agent-guide/adapters/cursor-cli.js";
+import { GenericMCPAdapter, genericMCPAdapter } from "./services/agent-guide/adapters/generic-mcp.js";
+import { agentAdapters, getAgentAdapter, listAgentTypes } from "./services/agent-guide/adapters/index.js";
+import { AIReviewResult, BehaviorCheck, FieldMapping, FieldMatchType, IntentAlignment, SemanticVerificationResult, StructureCheck, VerifyConfig, VerifyInput, VerifyOptions, VerifyResult } from "./services/verify/types.js";
+import { VerifyService, createVerifyService, verifyService } from "./services/verify/verify-service.js";
+import { verifyStructure } from "./services/verify/structure-verifier.js";
+import { verifyBehavior } from "./services/verify/behavior-verifier.js";
+import { createQuickAIReview, verifySemanticFields, verifyWithAI, verifyWithAIEnhanced } from "./services/verify/ai-verifier.js";
+import { DiscoveryOptions, ImplementationSource, ImplementationStatus, ResolvedImplementation, SpecImplementationResult, SpecReferenceMatch } from "./services/implementation/types.js";
+import { discoverAllImplementations, discoverImplementationsForSpec, extractSpecReferences, inferImplementationType } from "./services/implementation/discovery.js";
+import { ResolverOptions, getImplementationSummary, resolveAllImplementations, resolveImplementations } from "./services/implementation/resolver.js";
+import { CacheEntryMeta, CacheKeyString, CacheLookupResult, CacheMissReason, CacheStats, CacheStorageAdapter, DEFAULT_CACHE_CONFIG, VerificationCacheConfig, VerificationCacheEntry, VerificationCacheKey } from "./services/verification-cache/types.js";
+import { VerificationCacheService, cacheKeyToString, computeContentHash, createVerificationCacheService, stringToCacheKey } from "./services/verification-cache/cache-service.js";
+import { InMemoryCacheStorage, createInMemoryCacheStorage } from "./services/verification-cache/adapters/in-memory.js";
+import { FileSystemCacheStorage, createFileSystemCacheStorage } from "./services/verification-cache/adapters/filesystem.js";
+import { KeyValueStore, WorkspaceStateCacheStorage, createWorkspaceStateCacheStorage } from "./services/verification-cache/adapters/workspace-state.js";
+import "./services/index.js";
+import { index_d_exports as index_d_exports$1 } from "./formatters/index.js";
+import { index_d_exports as index_d_exports$2 } from "./templates/index.js";
+import { index_d_exports } from "./ai/index.js";
+export * from "@lssm/module.contractspec-workspace";
+export { AIReviewResult, ALL_CHECK_CATEGORIES, ALL_CI_CHECK_CATEGORIES, ALL_SETUP_TARGETS, AgentAdapter, AgentGuideConfig, AgentGuideService, type AgentMode, AiAdapter, AiGenerateOptions, AiGenerateResult, AiGenerateStructuredOptions, type AiProvider, AiValidationResult, AnalyzeDepsOptions, AnalyzeDepsResult, BehaviorCheck, BuildSpecOptions, BuildSpecResult, BuildTarget, BuildTargetResult, CHECK_CATEGORY_LABELS, CICheckCategory, CICheckCategorySummary, CICheckOptions, CICheckResult, CIFormatOptions, CIIssue, CIIssueSeverity, CIOutputFormat, CI_CHECK_CATEGORY_LABELS, CacheEntryMeta, CacheKeyString, CacheLookupResult, CacheMissReason, CacheStats, CacheStorageAdapter, CheckCategory, CheckContext, CheckResult, CheckStatus, ClaudeCodeAdapter, CleanOptions, CleanResult, CompareSpecsOptions, CompareSpecsResult, type Config, CoverageByType, CreateAdaptersOptions, CreateRegeneratorOptions, CursorCLIAdapter, DEFAULT_CACHE_CONFIG, DiagramOptions, DiagramType, DiscoverOptions, DiscoveryOptions, DoctorOptions, DoctorPromptCallbacks, DoctorResult, ExtendedWorkspaceInfo, FieldMapping, FieldMatchType, FileStat, FileSystemCacheStorage, FixAction, FixResult, FormatOptions, FsAdapter, GenericMCPAdapter, GitAdapter, GitCleanOptions, GuideOptions, GuideResult, ImplementationSource, ImplementationStatus, InMemoryCacheStorage, IntegrityAnalysisOptions, IntegrityAnalysisResult, IntegrityIssue, IntentAlignment, KeyValueStore, OpenApiExportOptions as LegacyOpenApiExportOptions, OpenApiExportResult as LegacyOpenApiExportResult, ListSpecsOptions, LogLevel, LoggerAdapter, MonorepoConfig, OpenApiExportServiceOptions, OpenApiExportServiceResult, OpenApiImportServiceOptions, OpenApiImportServiceResult, OpenApiSourceConfig, OpenApiSyncServiceOptions, OpenApiSyncServiceResult, OpenApiValidateServiceOptions, OpenApiValidateServiceResult, PackageManager, ProgressReporter, ProgressUpdate, RegistryClient, RegistryClientOptions, ResolvedImplementation, ResolverOptions, RunTestsResult, SETUP_TARGET_LABELS, SemanticVerificationResult, SetupFileResult, SetupOptions, SetupPromptCallbacks, SetupResult, SetupScope, SetupTarget, SpecImplementationResult, SpecInventory, SpecLocation, SpecReferenceMatch, StructureCheck, SyncBuildFn, SyncSpecsOptions, SyncSpecsResult, SyncSpecsRunResult, SyncValidateFn, TestRunResult, ValidateImplementationOptions, ValidateImplementationResult, ValidateSpecOptions, ValidateSpecResult, VerificationCacheConfig, VerificationCacheEntry, VerificationCacheKey, VerificationCacheService, VerifyConfig, VerifyInput, VerifyOptions, VerifyResult, VerifyService, WatchBuildFn, WatchEvent, WatchEventHandler, WatchEventType, WatchOptions, WatchSpecsOptions, WatchValidateFn, Watcher, WatcherAdapter, WorkspaceAdapters, WorkspaceInfo, WorkspaceStateCacheStorage, addToRegistry, agentAdapters, agentGuideService, index_d_exports as ai, analyzeDeps, analyzeIntegrity, buildSpec, cacheKeyToString, claudeCodeAdapter, cleanArtifacts, compareSpecs, computeContentHash, createAgentGuideService, createConsoleLoggerAdapter, createFileSystemCacheStorage, createInMemoryCacheStorage, createNodeAdapters, createNodeAiAdapter, createNodeFsAdapter, createNodeGitAdapter, createNodeWatcherAdapter, createNoopLoggerAdapter, createQuickAIReview, createRegeneratorService, createVerificationCacheService, createVerifyService, createWorkspaceStateCacheStorage, cursorCLIAdapter, deepMergeOverwrite, deepMergePreserve, detectPackageManager, discoverAllImplementations, discoverImplementationsForSpec, exportGraphAsDot, exportOpenApi, extractSpecReferences, filterIssuesBySeverity, filterIssuesByType, findAllConfigFiles, findPackageRoot, findWorkspaceRoot, formatCheckResult, formatDoctorSummary, formatJson, formatWorkspaceInfo, index_d_exports$1 as formatters, generateAgentsMd, generateClaudeMcpConfig, generateContractsrcConfig, generateCursorMcpConfig, generateCursorRules, generateMermaidDiagram, generateVscodeSettings, genericMCPAdapter, getAgentAdapter, getAllSpecs, getApiKey, getClaudeDesktopConfigPath, getContractNode, getExecCommand, getExtendedWorkspaceInfo, getGraphStats, getImplementationSummary, getInstallCommand, getPackageName, getRunCommand, getWorkspaceInfo, getWorkspacePackages, groupSpecsByType, importFromOpenApiService, inferImplementationType, isMonorepo, listAgentTypes, listFromRegistry, listSpecs, loadWorkspaceConfig, mergeMonorepoConfigs, mergeWorkspaceConfig, resolveAllImplementations, resolveImplementations, resolveRegistryUrl, runCIChecks, runDoctor, runSetup, runTests, safeParseJson, searchRegistry, stringToCacheKey, syncSpecs, syncWithOpenApiService, index_d_exports$2 as templates, validateAgainstOpenApiService, validateImplementationFiles, validateSpec, validateSpecs, verifyBehavior, verifySemanticFields, verifyService, verifyStructure, verifyWithAI, verifyWithAIEnhanced, watchSpecs };

package/dist/ports/ai.d.ts

@@ -0,0 +1,58 @@
+import { WorkspaceConfig } from "@lssm/module.contractspec-workspace";
+
+//#region src/ports/ai.d.ts
+
+/**
+ * AI generation options.
+ */
+interface AiGenerateOptions {
+  prompt: string;
+  systemPrompt?: string;
+  stream?: boolean;
+}
+/**
+ * AI structured generation options.
+ */
+interface AiGenerateStructuredOptions<_T> {
+  prompt: string;
+  systemPrompt?: string;
+  schema: unknown;
+}
+/**
+ * AI generation result.
+ */
+interface AiGenerateResult {
+  text: string;
+}
+/**
+ * AI validation result.
+ */
+interface AiValidationResult {
+  success: boolean;
+  error?: string;
+}
+/**
+ * AI adapter interface.
+ */
+interface AiAdapter {
+  /**
+   * Validate provider configuration.
+   */
+  validateProvider(config: WorkspaceConfig): Promise<AiValidationResult>;
+  /**
+   * Generate text from prompt.
+   */
+  generateText(options: AiGenerateOptions): Promise<AiGenerateResult>;
+  /**
+   * Generate structured data from prompt.
+   */
+  generateStructured<T>(options: AiGenerateStructuredOptions<T>): Promise<{
+    object: T;
+  }>;
+  /**
+   * Stream text generation.
+   */
+  streamText(options: AiGenerateOptions, onChunk: (text: string) => void): Promise<string>;
+}
+//#endregion
+export { AiAdapter, AiGenerateOptions, AiGenerateResult, AiGenerateStructuredOptions, AiValidationResult };

package/dist/ports/fs.d.ts

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

package/dist/ports/git.d.ts

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

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

package/dist/ports/watcher.d.ts

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

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

@@ -0,0 +1,34 @@
+import { AgentAdapter } from "../types.js";
+import { AnyContractSpec } from "@lssm/lib.contracts";
+import { AgentPrompt, ImplementationPlan } from "@lssm/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: AnyContractSpec): 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 };