@lssm/bundle.contractspec-workspace 0.0.0-canary-20251217083314 → 1.41.0

package/dist/services/openapi/types.d.ts

@@ -1,184 +0,0 @@
-//#region src/services/openapi/types.d.ts
-/**
- * Types for OpenAPI services.
- */
-/**
- * OpenAPI source configuration (from config file).
- */
-interface OpenApiSourceConfig {
-  /** Friendly name for the source */
-  name: string;
-  /** Remote URL to fetch OpenAPI spec from */
-  url?: string;
-  /** Local file path to OpenAPI spec */
-  file?: string;
-  /** Sync mode */
-  syncMode: 'import' | 'sync' | 'validate';
-  /** Only import operations with these tags */
-  tags?: string[];
-  /** Exclude operations with these operationIds */
-  exclude?: string[];
-  /** Prefix for generated spec names */
-  prefix?: string;
-  /** Default stability for imported specs */
-  defaultStability?: 'experimental' | 'beta' | 'stable' | 'deprecated';
-  /** Default auth level for imported specs */
-  defaultAuth?: 'anonymous' | 'user' | 'admin';
-}
-/**
- * Options for OpenAPI import.
- */
-interface OpenApiImportServiceOptions {
-  /** Source URL or file path */
-  source: string;
-  /** Output directory for generated spec files */
-  outputDir: string;
-  /** Prefix for generated spec names */
-  prefix?: string;
-  /** Only import operations with these tags */
-  tags?: string[];
-  /** Exclude operations with these operationIds */
-  exclude?: string[];
-  /** Default stability for imported specs */
-  defaultStability?: 'experimental' | 'beta' | 'stable' | 'deprecated';
-  /** Default owners for imported specs */
-  defaultOwners?: string[];
-  /** Default auth level for imported specs */
-  defaultAuth?: 'anonymous' | 'user' | 'admin';
-  /** Dry run - show what would be imported without writing files */
-  dryRun?: boolean;
-}
-/**
- * Result of OpenAPI import.
- */
-interface OpenApiImportServiceResult {
-  /** Number of specs successfully imported */
-  imported: number;
-  /** Number of specs skipped */
-  skipped: number;
-  /** Number of errors */
-  errors: number;
-  /** List of imported spec files */
-  files: Array<{
-    path: string;
-    operationId: string;
-    specName: string;
-  }>;
-  /** List of skipped operations */
-  skippedOperations: Array<{
-    operationId: string;
-    reason: string;
-  }>;
-  /** List of errors */
-  errorMessages: Array<{
-    operationId: string;
-    error: string;
-  }>;
-}
-/**
- * Options for OpenAPI sync.
- */
-interface OpenApiSyncServiceOptions {
-  /** Sources to sync (uses config if not provided) */
-  sources?: OpenApiSourceConfig[];
-  /** Source name to sync (if syncing single source) */
-  sourceName?: string;
-  /** Interactive mode - prompt for conflict resolution */
-  interactive?: boolean;
-  /** Force resolution mode */
-  force?: 'openapi' | 'contractspec';
-  /** Dry run - show what would change without writing */
-  dryRun?: boolean;
-}
-/**
- * Result of OpenAPI sync.
- */
-interface OpenApiSyncServiceResult {
-  /** Number of specs added */
-  added: number;
-  /** Number of specs updated */
-  updated: number;
-  /** Number of specs unchanged */
-  unchanged: number;
-  /** Number of conflicts */
-  conflicts: number;
-  /** Details of changes */
-  changes: Array<{
-    operationId: string;
-    action: 'added' | 'updated' | 'unchanged' | 'conflict';
-    path?: string;
-    changeCount?: number;
-  }>;
-}
-/**
- * Options for OpenAPI validation.
- */
-interface OpenApiValidateServiceOptions {
-  /** Spec file or directory to validate */
-  specPath: string;
-  /** OpenAPI source to validate against */
-  openApiSource: string;
-  /** Ignore description differences */
-  ignoreDescriptions?: boolean;
-  /** Ignore tag differences */
-  ignoreTags?: boolean;
-  /** Ignore transport differences (path, method) */
-  ignoreTransport?: boolean;
-}
-/**
- * Result of OpenAPI validation.
- */
-interface OpenApiValidateServiceResult {
-  /** Whether validation passed */
-  valid: boolean;
-  /** Number of specs validated */
-  specsValidated: number;
-  /** Number of specs with differences */
-  specsWithDiffs: number;
-  /** Validation details */
-  results: Array<{
-    specPath: string;
-    operationId?: string;
-    valid: boolean;
-    diffs: Array<{
-      path: string;
-      type: string;
-      description: string;
-    }>;
-  }>;
-}
-/**
- * Options for OpenAPI export.
- */
-interface OpenApiExportServiceOptions {
-  /** Path to module exporting SpecRegistry */
-  registryPath: string;
-  /** Output file path */
-  outputPath?: string;
-  /** Output format */
-  format?: 'json' | 'yaml';
-  /** OpenAPI title */
-  title?: string;
-  /** OpenAPI version */
-  version?: string;
-  /** OpenAPI description */
-  description?: string;
-  /** Server URLs to include */
-  servers?: Array<{
-    url: string;
-    description?: string;
-  }>;
-}
-/**
- * Result of OpenAPI export.
- */
-interface OpenApiExportServiceResult {
-  /** Output file path */
-  outputPath: string;
-  /** Generated content */
-  content: string;
-  /** Number of operations exported */
-  operationCount: number;
-}
-//#endregion
-export { OpenApiExportServiceOptions, OpenApiExportServiceResult, OpenApiImportServiceOptions, OpenApiImportServiceResult, OpenApiSourceConfig, OpenApiSyncServiceOptions, OpenApiSyncServiceResult, OpenApiValidateServiceOptions, OpenApiValidateServiceResult };

package/dist/services/openapi/validate-service.d.ts

@@ -1,15 +0,0 @@
-import { FsAdapter } from "../../ports/fs.js";
-import { LoggerAdapter } from "../../ports/logger.js";
-import { OpenApiValidateServiceOptions, OpenApiValidateServiceResult } from "./types.js";
-
-//#region src/services/openapi/validate-service.d.ts
-
-/**
- * Validate ContractSpec specs against an OpenAPI source.
- */
-declare function validateAgainstOpenApiService(options: OpenApiValidateServiceOptions, adapters: {
-  fs: FsAdapter;
-  logger: LoggerAdapter;
-}): Promise<OpenApiValidateServiceResult>;
-//#endregion
-export { validateAgainstOpenApiService };

package/dist/services/regenerator.d.ts

@@ -1,17 +0,0 @@
-import { RegeneratorService } from "@lssm/lib.contracts/regenerator";
-import { ProposalSink, RegenerationContext, RegenerationRule } from "@lssm/lib.contracts/regenerator/types";
-import { SignalAdapters } from "@lssm/lib.contracts/regenerator/adapters";
-
-//#region src/services/regenerator.d.ts
-
-interface CreateRegeneratorOptions {
-  contexts: RegenerationContext[];
-  rules: RegenerationRule[];
-  sink: ProposalSink;
-  adapters?: SignalAdapters;
-  pollIntervalMs?: number;
-  batchDurationMs?: number;
-}
-declare function createRegeneratorService(options: CreateRegeneratorOptions): RegeneratorService;
-//#endregion
-export { CreateRegeneratorOptions, createRegeneratorService };

package/dist/services/registry.d.ts

@@ -1,52 +0,0 @@
-import { LoggerAdapter } from "../ports/logger.js";
-
-//#region src/services/registry.d.ts
-
-/**
- * Registry client options.
- */
-interface RegistryClientOptions {
-  registryUrl: string;
-}
-/**
- * Registry client for interacting with ContractSpec registry.
- */
-declare class RegistryClient {
-  private readonly registryUrl;
-  constructor(opts: RegistryClientOptions);
-  /**
-   * Make GET request to registry.
-   */
-  getJson<T>(path: string): Promise<T>;
-}
-/**
- * Resolve registry URL from options or environment.
- */
-declare function resolveRegistryUrl(cliRegistryUrl?: string): string;
-/**
- * Add spec to registry.
- */
-declare function addToRegistry(specPath: string, options: {
-  registryUrl?: string;
-}, adapters: {
-  logger: LoggerAdapter;
-}): Promise<void>;
-/**
- * List specs from registry.
- */
-declare function listFromRegistry(options: {
-  registryUrl?: string;
-  filter?: string;
-}, adapters: {
-  logger: LoggerAdapter;
-}): Promise<unknown[]>;
-/**
- * Search registry for specs.
- */
-declare function searchRegistry(query: string, options: {
-  registryUrl?: string;
-}, adapters: {
-  logger: LoggerAdapter;
-}): Promise<unknown[]>;
-//#endregion
-export { RegistryClient, RegistryClientOptions, addToRegistry, listFromRegistry, resolveRegistryUrl, searchRegistry };

package/dist/services/setup/config-generators.d.ts

@@ -1,41 +0,0 @@
-import { SetupOptions } from "./types.js";
-
-//#region src/services/setup/config-generators.d.ts
-
-/**
- * Generate .contractsrc.json content.
- *
- * Adapts defaults based on monorepo scope.
- */
-declare function generateContractsrcConfig(options: SetupOptions): object;
-/**
- * Generate .vscode/settings.json ContractSpec settings.
- */
-declare function generateVscodeSettings(): object;
-/**
- * Generate .cursor/mcp.json content.
- */
-declare function generateCursorMcpConfig(): object;
-/**
- * Generate Claude Desktop MCP config.
- * Returns the mcpServers section to merge into claude_desktop_config.json.
- */
-declare function generateClaudeMcpConfig(): object;
-/**
- * Generate .cursor/rules/contractspec.mdc content.
- *
- * Adapts paths based on monorepo scope.
- */
-declare function generateCursorRules(options: SetupOptions): string;
-/**
- * Generate AGENTS.md content.
- *
- * Adapts paths and instructions based on monorepo scope.
- */
-declare function generateAgentsMd(options: SetupOptions): string;
-/**
- * Get the file path for Claude Desktop config based on platform.
- */
-declare function getClaudeDesktopConfigPath(): string;
-//#endregion
-export { generateAgentsMd, generateClaudeMcpConfig, generateContractsrcConfig, generateCursorMcpConfig, generateCursorRules, generateVscodeSettings, getClaudeDesktopConfigPath };

package/dist/services/setup/file-merger.d.ts

@@ -1,26 +0,0 @@
-//#region src/services/setup/file-merger.d.ts
-/**
- * File merger utilities.
- *
- * Deep-merges JSON files without losing user settings.
- */
-/**
- * Deep merge two objects, preserving existing user values.
- * New keys are added, but existing keys are NOT overwritten.
- */
-declare function deepMergePreserve<T extends Record<string, unknown>>(existing: T, defaults: T): T;
-/**
- * Deep merge two objects, with new values taking precedence.
- * Used when we want to update existing configs.
- */
-declare function deepMergeOverwrite<T extends Record<string, unknown>>(existing: T, updates: Partial<T>): T;
-/**
- * Parse JSON safely, returning null on failure.
- */
-declare function safeParseJson<T>(content: string): T | null;
-/**
- * Format JSON with consistent indentation.
- */
-declare function formatJson(obj: unknown): string;
-//#endregion
-export { deepMergeOverwrite, deepMergePreserve, formatJson, safeParseJson };

package/dist/services/setup/setup-service.d.ts

@@ -1,11 +0,0 @@
-import { FsAdapter } from "../../ports/fs.js";
-import { SetupOptions, SetupPromptCallbacks, SetupResult } from "./types.js";
-
-//#region src/services/setup/setup-service.d.ts
-
-/**
- * Run the ContractSpec setup.
- */
-declare function runSetup(fs: FsAdapter, options: SetupOptions, prompts?: SetupPromptCallbacks): Promise<SetupResult>;
-//#endregion
-export { runSetup };

package/dist/services/setup/types.d.ts

@@ -1,84 +0,0 @@
-//#region src/services/setup/types.d.ts
-/**
- * Setup service types.
- */
-/**
- * Target components that can be configured during setup.
- */
-type SetupTarget = 'cli-config' | 'vscode-settings' | 'mcp-cursor' | 'mcp-claude' | 'cursor-rules' | 'agents-md';
-/**
- * All available setup targets.
- */
-declare const ALL_SETUP_TARGETS: SetupTarget[];
-/**
- * Human-readable labels for setup targets.
- */
-declare const SETUP_TARGET_LABELS: Record<SetupTarget, string>;
-/**
- * Scope of configuration in a monorepo.
- */
-type SetupScope = 'workspace' | 'package';
-/**
- * Options for the setup service.
- */
-interface SetupOptions {
-  /** Root directory of the workspace (monorepo root or single project root). */
-  workspaceRoot: string;
-  /** Current package root (may differ from workspaceRoot in monorepos). */
-  packageRoot?: string;
-  /** Whether this is a monorepo. */
-  isMonorepo?: boolean;
-  /** Where to create config: workspace level or package level. */
-  scope?: SetupScope;
-  /** Current package name (if in a monorepo package). */
-  packageName?: string;
-  /** If true, skip prompts and use defaults. */
-  interactive: boolean;
-  /** Specific targets to configure (defaults to all). */
-  targets: SetupTarget[];
-  /** Project name (defaults to directory name). */
-  projectName?: string;
-  /** Default code owners. */
-  defaultOwners?: string[];
-}
-/**
- * Result of a single file setup operation.
- */
-interface SetupFileResult {
-  /** Target that was configured. */
-  target: SetupTarget;
-  /** File path that was created or modified. */
-  filePath: string;
-  /** Action taken. */
-  action: 'created' | 'merged' | 'skipped' | 'error';
-  /** Message describing what happened. */
-  message: string;
-}
-/**
- * Full result of the setup operation.
- */
-interface SetupResult {
-  /** Whether all operations succeeded. */
-  success: boolean;
-  /** Results for each file. */
-  files: SetupFileResult[];
-  /** Summary message. */
-  summary: string;
-}
-/**
- * Callback for interactive prompts during setup.
- */
-interface SetupPromptCallbacks {
-  /** Confirm an action. */
-  confirm: (message: string) => Promise<boolean>;
-  /** Select multiple options. */
-  multiSelect: <T extends string>(message: string, options: {
-    value: T;
-    label: string;
-    selected?: boolean;
-  }[]) => Promise<T[]>;
-  /** Input a string value. */
-  input: (message: string, defaultValue?: string) => Promise<string>;
-}
-//#endregion
-export { ALL_SETUP_TARGETS, SETUP_TARGET_LABELS, SetupFileResult, SetupOptions, SetupPromptCallbacks, SetupResult, SetupScope, SetupTarget };

package/dist/services/sync.d.ts

@@ -1,40 +0,0 @@
-import { FsAdapter } from "../ports/fs.js";
-import { LoggerAdapter } from "../ports/logger.js";
-import { ValidateSpecResult } from "./validate.js";
-import { BuildSpecOptions } from "./build.js";
-import { WorkspaceConfig } from "@lssm/module.contractspec-workspace";
-
-//#region src/services/sync.d.ts
-
-interface SyncSpecsOptions {
-  pattern?: string;
-  outputDirs?: (string | undefined)[];
-  validate?: boolean;
-  buildOptions?: Omit<BuildSpecOptions, 'outputDir'>;
-  dryRun?: boolean;
-}
-interface SyncSpecsRunResult {
-  specPath: string;
-  outputDir?: string;
-  validation?: ValidateSpecResult;
-  build?: unknown;
-  error?: {
-    phase: 'validate' | 'build';
-    message: string;
-  };
-}
-interface SyncSpecsResult {
-  specs: string[];
-  runs: SyncSpecsRunResult[];
-}
-type SyncBuildFn<B> = (specPath: string, outputDir: string | undefined) => Promise<B>;
-type SyncValidateFn = (specPath: string) => Promise<ValidateSpecResult>;
-declare function syncSpecs(adapters: {
-  fs: FsAdapter;
-  logger: LoggerAdapter;
-}, config: WorkspaceConfig, options?: SyncSpecsOptions, overrides?: {
-  build?: SyncBuildFn<unknown>;
-  validate?: SyncValidateFn;
-}): Promise<SyncSpecsResult>;
-//#endregion
-export { SyncBuildFn, SyncSpecsOptions, SyncSpecsResult, SyncSpecsRunResult, SyncValidateFn, syncSpecs };

package/dist/services/test.d.ts

@@ -1,14 +0,0 @@
-import { SpecRegistry } from "@lssm/lib.contracts";
-import { TestRunner, TestSpec } from "@lssm/lib.contracts/tests";
-
-//#region src/services/test.d.ts
-
-type TestRunResult = Awaited<ReturnType<TestRunner['run']>>;
-interface RunTestsResult {
-  results: TestRunResult[];
-  passed: number;
-  failed: number;
-}
-declare function runTests(specs: TestSpec[], registry: SpecRegistry): Promise<RunTestsResult>;
-//#endregion
-export { RunTestsResult, TestRunResult, runTests };

package/dist/services/validate-implementation.d.ts

@@ -1,31 +0,0 @@
-import { FsAdapter } from "../ports/fs.js";
-import { WorkspaceConfig } from "@lssm/module.contractspec-workspace";
-
-//#region src/services/validate-implementation.d.ts
-
-interface ValidateImplementationOptions {
-  checkHandlers?: boolean;
-  checkTests?: boolean;
-  /**
-   * Override workspace outputDir (defaults to config.outputDir).
-   */
-  outputDir?: string;
-}
-interface ValidateImplementationResult {
-  valid: boolean;
-  errors: string[];
-  warnings: string[];
-  expected: {
-    handlerPath?: string;
-    handlerTestPath?: string;
-    componentPath?: string;
-    componentTestPath?: string;
-    formPath?: string;
-    formTestPath?: string;
-  };
-}
-declare function validateImplementationFiles(specFile: string, adapters: {
-  fs: FsAdapter;
-}, config: WorkspaceConfig, options?: ValidateImplementationOptions): Promise<ValidateImplementationResult>;
-//#endregion
-export { ValidateImplementationOptions, ValidateImplementationResult, validateImplementationFiles };

package/dist/services/validate.d.ts

@@ -1,40 +0,0 @@
-import { FsAdapter } from "../ports/fs.js";
-import { LoggerAdapter } from "../ports/logger.js";
-import { ValidationResult } from "@lssm/module.contractspec-workspace";
-
-//#region src/services/validate.d.ts
-
-/**
- * Options for spec validation.
- */
-interface ValidateSpecOptions {
-  /**
-   * Skip spec structure validation (e.g., for blueprint files).
-   */
-  skipStructure?: boolean;
-}
-/**
- * Result of spec validation.
- */
-interface ValidateSpecResult {
-  valid: boolean;
-  structureResult?: ValidationResult;
-  errors: string[];
-  warnings: string[];
-}
-/**
- * Validate a spec file.
- */
-declare function validateSpec(specFile: string, adapters: {
-  fs: FsAdapter;
-  logger: LoggerAdapter;
-}, options?: ValidateSpecOptions): Promise<ValidateSpecResult>;
-/**
- * Validate multiple spec files.
- */
-declare function validateSpecs(specFiles: string[], adapters: {
-  fs: FsAdapter;
-  logger: LoggerAdapter;
-}, options?: ValidateSpecOptions): Promise<Map<string, ValidateSpecResult>>;
-//#endregion
-export { ValidateSpecOptions, ValidateSpecResult, validateSpec, validateSpecs };

package/dist/services/verification-cache/adapters/filesystem.d.ts

@@ -1,45 +0,0 @@
-import { CacheKeyString, CacheStorageAdapter, VerificationCacheEntry } from "../types.js";
-
-//#region src/services/verification-cache/adapters/filesystem.d.ts
-
-/**
- * Filesystem storage adapter.
- */
-declare class FileSystemCacheStorage implements CacheStorageAdapter {
-  private filePath;
-  private cache;
-  private isDirty;
-  constructor(filePath?: string, workspaceRoot?: string);
-  /**
-   * Load cache from disk synchronously.
-   */
-  private loadSync;
-  /**
-   * Save cache to disk.
-   */
-  private saveSync;
-  get(key: CacheKeyString): Promise<VerificationCacheEntry | null>;
-  set(key: CacheKeyString, entry: VerificationCacheEntry): Promise<void>;
-  delete(key: CacheKeyString): Promise<boolean>;
-  has(key: CacheKeyString): Promise<boolean>;
-  keys(): Promise<CacheKeyString[]>;
-  clear(): Promise<void>;
-  stats(): Promise<{
-    entryCount: number;
-    memoryUsage?: number;
-  }>;
-  /**
-   * Force save any pending changes.
-   */
-  flush(): void;
-  /**
-   * Reload cache from disk.
-   */
-  reload(): void;
-}
-/**
- * Create a filesystem cache storage adapter.
- */
-declare function createFileSystemCacheStorage(filePath?: string, workspaceRoot?: string): FileSystemCacheStorage;
-//#endregion
-export { FileSystemCacheStorage, createFileSystemCacheStorage };

package/dist/services/verification-cache/adapters/in-memory.d.ts

@@ -1,26 +0,0 @@
-import { CacheKeyString, CacheStorageAdapter, VerificationCacheEntry } from "../types.js";
-
-//#region src/services/verification-cache/adapters/in-memory.d.ts
-
-/**
- * In-memory storage adapter using a Map.
- */
-declare class InMemoryCacheStorage implements CacheStorageAdapter {
-  private cache;
-  get(key: CacheKeyString): Promise<VerificationCacheEntry | null>;
-  set(key: CacheKeyString, entry: VerificationCacheEntry): Promise<void>;
-  delete(key: CacheKeyString): Promise<boolean>;
-  has(key: CacheKeyString): Promise<boolean>;
-  keys(): Promise<CacheKeyString[]>;
-  clear(): Promise<void>;
-  stats(): Promise<{
-    entryCount: number;
-    memoryUsage?: number;
-  }>;
-}
-/**
- * Create an in-memory cache storage adapter.
- */
-declare function createInMemoryCacheStorage(): InMemoryCacheStorage;
-//#endregion
-export { InMemoryCacheStorage, createInMemoryCacheStorage };

package/dist/services/verification-cache/adapters/workspace-state.d.ts

@@ -1,48 +0,0 @@
-import { CacheKeyString, CacheStorageAdapter, VerificationCacheEntry } from "../types.js";
-
-//#region src/services/verification-cache/adapters/workspace-state.d.ts
-
-/**
- * Interface for key-value store (compatible with VSCode's Memento).
- */
-interface KeyValueStore {
-  get<T>(key: string): T | undefined;
-  update(key: string, value: unknown): Thenable<void>;
-  keys?(): readonly string[];
-}
-/**
- * Workspace state storage adapter.
- */
-declare class WorkspaceStateCacheStorage implements CacheStorageAdapter {
-  private store;
-  private keyIndex;
-  constructor(store: KeyValueStore);
-  /**
-   * Load the key index from storage.
-   */
-  private loadKeyIndex;
-  /**
-   * Save the key index to storage.
-   */
-  private saveKeyIndex;
-  /**
-   * Get the storage key for a cache key.
-   */
-  private getStorageKey;
-  get(key: CacheKeyString): Promise<VerificationCacheEntry | null>;
-  set(key: CacheKeyString, entry: VerificationCacheEntry): Promise<void>;
-  delete(key: CacheKeyString): Promise<boolean>;
-  has(key: CacheKeyString): Promise<boolean>;
-  keys(): Promise<CacheKeyString[]>;
-  clear(): Promise<void>;
-  stats(): Promise<{
-    entryCount: number;
-    memoryUsage?: number;
-  }>;
-}
-/**
- * Create a workspace state cache storage adapter.
- */
-declare function createWorkspaceStateCacheStorage(store: KeyValueStore): WorkspaceStateCacheStorage;
-//#endregion
-export { KeyValueStore, WorkspaceStateCacheStorage, createWorkspaceStateCacheStorage };