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

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

@@ -1,117 +0,0 @@
-//#region src/services/doctor/types.d.ts
-/**
- * Doctor service types.
- *
- * Types for health checks and auto-fix functionality.
- */
-/**
- * Categories of health checks.
- */
-type CheckCategory = 'cli' | 'config' | 'mcp' | 'deps' | 'workspace' | 'ai';
-/**
- * All available check categories.
- */
-declare const ALL_CHECK_CATEGORIES: CheckCategory[];
-/**
- * Human-readable labels for check categories.
- */
-declare const CHECK_CATEGORY_LABELS: Record<CheckCategory, string>;
-/**
- * Status of a health check.
- */
-type CheckStatus = 'pass' | 'warn' | 'fail' | 'skip';
-/**
- * Result of applying a fix.
- */
-interface FixResult {
-  /** Whether the fix was successful. */
-  success: boolean;
-  /** Message describing the result. */
-  message: string;
-}
-/**
- * An action that can fix a failed check.
- */
-interface FixAction {
-  /** Description of what the fix will do. */
-  description: string;
-  /** Function to apply the fix. */
-  apply: () => Promise<FixResult>;
-}
-/**
- * Result of a single health check.
- */
-interface CheckResult {
-  /** Category of the check. */
-  category: CheckCategory;
-  /** Name of the specific check. */
-  name: string;
-  /** Status of the check. */
-  status: CheckStatus;
-  /** Human-readable message. */
-  message: string;
-  /** Optional fix action if status is 'fail' or 'warn'. */
-  fix?: FixAction;
-  /** Additional details for debugging. */
-  details?: string;
-}
-/**
- * Options for running the doctor.
- */
-interface DoctorOptions {
-  /** Root directory of the workspace. */
-  workspaceRoot: string;
-  /** Categories to check (defaults to all). */
-  categories?: CheckCategory[];
-  /** If true, auto-apply fixes without prompting. */
-  autoFix?: boolean;
-  /** Skip AI provider checks. */
-  skipAi?: boolean;
-  /** Verbose output. */
-  verbose?: boolean;
-}
-/**
- * Summary of doctor results.
- */
-interface DoctorResult {
-  /** All check results. */
-  checks: CheckResult[];
-  /** Number of passing checks. */
-  passed: number;
-  /** Number of warnings. */
-  warnings: number;
-  /** Number of failures. */
-  failures: number;
-  /** Number of skipped checks. */
-  skipped: number;
-  /** Overall health status. */
-  healthy: boolean;
-}
-/**
- * Callback for interactive prompts during doctor.
- */
-interface DoctorPromptCallbacks {
-  /** Confirm a fix action. */
-  confirm: (message: string) => Promise<boolean>;
-  /** Input a value (e.g., API key). */
-  input: (message: string, options?: {
-    password?: boolean;
-  }) => Promise<string>;
-}
-/**
- * Context passed to check functions.
- */
-interface CheckContext {
-  /** Workspace root path (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;
-  /** Current package name (if in a monorepo package). */
-  packageName?: string;
-  /** Whether verbose output is enabled. */
-  verbose: boolean;
-}
-//#endregion
-export { ALL_CHECK_CATEGORIES, CHECK_CATEGORY_LABELS, CheckCategory, CheckContext, CheckResult, CheckStatus, DoctorOptions, DoctorPromptCallbacks, DoctorResult, FixAction, FixResult };

package/dist/services/implementation/discovery.d.ts

@@ -1,29 +0,0 @@
-import { FsAdapter } from "../../ports/fs.js";
-import { DiscoveryOptions, SpecReferenceMatch } from "./types.js";
-import { ImplementationType } from "@lssm/lib.contracts";
-
-//#region src/services/implementation/discovery.d.ts
-
-/**
- * Infer implementation type from file path.
- */
-declare function inferImplementationType(filePath: string): ImplementationType;
-/**
- * Extract spec references from source code.
- */
-declare function extractSpecReferences(code: string, filePath: string): SpecReferenceMatch[];
-/**
- * Discover implementations that reference a specific spec.
- */
-declare function discoverImplementationsForSpec(specName: string, adapters: {
-  fs: FsAdapter;
-}, options?: DiscoveryOptions): Promise<SpecReferenceMatch[]>;
-/**
- * Discover all spec references in the workspace.
- * Returns a map of spec name to implementation references.
- */
-declare function discoverAllImplementations(adapters: {
-  fs: FsAdapter;
-}, options?: DiscoveryOptions): Promise<Map<string, SpecReferenceMatch[]>>;
-//#endregion
-export { discoverAllImplementations, discoverImplementationsForSpec, extractSpecReferences, inferImplementationType };

package/dist/services/implementation/resolver.d.ts

@@ -1,43 +0,0 @@
-import { FsAdapter } from "../../ports/fs.js";
-import { DiscoveryOptions, SpecImplementationResult } from "./types.js";
-import { WorkspaceConfig } from "@lssm/module.contractspec-workspace";
-
-//#region src/services/implementation/resolver.d.ts
-
-/**
- * Options for resolving implementations.
- */
-interface ResolverOptions extends DiscoveryOptions {
-  /** Include explicit implementations from spec */
-  includeExplicit?: boolean;
-  /** Include auto-discovered implementations */
-  includeDiscovered?: boolean;
-  /** Include convention-based implementations */
-  includeConvention?: boolean;
-  /** Output directory for convention-based paths */
-  outputDir?: string;
-}
-/**
- * Resolve all implementations for a spec file.
- */
-declare function resolveImplementations(specFile: string, adapters: {
-  fs: FsAdapter;
-}, config: WorkspaceConfig, options?: ResolverOptions): Promise<SpecImplementationResult>;
-/**
- * Resolve implementations for multiple spec files.
- */
-declare function resolveAllImplementations(specFiles: string[], adapters: {
-  fs: FsAdapter;
-}, config: WorkspaceConfig, options?: ResolverOptions): Promise<SpecImplementationResult[]>;
-/**
- * Get implementation summary statistics.
- */
-declare function getImplementationSummary(results: SpecImplementationResult[]): {
-  total: number;
-  implemented: number;
-  partial: number;
-  missing: number;
-  coverage: number;
-};
-//#endregion
-export { ResolverOptions, getImplementationSummary, resolveAllImplementations, resolveImplementations };

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

@@ -1,78 +0,0 @@
-import { ImplementationType } from "@lssm/lib.contracts";
-
-//#region src/services/implementation/types.d.ts
-
-/**
- * Source of how an implementation was discovered/linked.
- */
-type ImplementationSource = 'explicit' | 'discovered' | 'convention';
-/**
- * Status of a spec's implementation coverage.
- */
-type ImplementationStatus = 'implemented' | 'partial' | 'missing';
-/**
- * A resolved implementation file for a spec.
- */
-interface ResolvedImplementation {
-  /** Path to the implementation file (relative to workspace root) */
-  path: string;
-  /** Type of implementation artifact */
-  type: ImplementationType;
-  /** How this implementation was found */
-  source: ImplementationSource;
-  /** Whether the file exists on disk */
-  exists: boolean;
-  /** Content hash for cache invalidation (SHA256) */
-  contentHash?: string;
-  /** Optional description */
-  description?: string;
-}
-/**
- * Full resolution result for a spec's implementations.
- */
-interface SpecImplementationResult {
-  /** Spec name */
-  specName: string;
-  /** Spec version */
-  specVersion: number;
-  /** Path to the spec file */
-  specPath: string;
-  /** Spec type (operation, event, presentation, etc.) */
-  specType: string;
-  /** All resolved implementations */
-  implementations: ResolvedImplementation[];
-  /** Overall implementation status */
-  status: ImplementationStatus;
-  /** Content hash of the spec file */
-  specHash?: string;
-}
-/**
- * Options for implementation discovery.
- */
-interface DiscoveryOptions {
-  /** Workspace root directory */
-  workspaceRoot?: string;
-  /** Glob patterns to search */
-  includePatterns?: string[];
-  /** Glob patterns to exclude */
-  excludePatterns?: string[];
-  /** Whether to compute content hashes */
-  computeHashes?: boolean;
-}
-/**
- * Result of scanning for spec references in a file.
- */
-interface SpecReferenceMatch {
-  /** Path to the file containing the reference */
-  filePath: string;
-  /** Name of the spec being referenced */
-  specName: string;
-  /** Type of reference (import, typeof, handler) */
-  referenceType: 'import' | 'typeof' | 'handler' | 'unknown';
-  /** Line number where reference was found */
-  lineNumber?: number;
-  /** Inferred implementation type based on context */
-  inferredType: ImplementationType;
-}
-//#endregion
-export { DiscoveryOptions, ImplementationSource, ImplementationStatus, ResolvedImplementation, SpecImplementationResult, SpecReferenceMatch };

package/dist/services/integrity-diagram.d.ts

@@ -1,35 +0,0 @@
-import { IntegrityAnalysisResult } from "./integrity.js";
-
-//#region src/services/integrity-diagram.d.ts
-
-/**
- * Type of diagram to generate.
- */
-type DiagramType = 'feature-map' | 'orphans' | 'dependencies' | 'full';
-/**
- * Options for diagram generation.
- */
-interface DiagramOptions {
-  /**
-   * Maximum number of nodes to display.
-   */
-  maxNodes?: number;
-  /**
-   * Include only specific features.
-   */
-  featureKeys?: string[];
-  /**
-   * Show spec versions in labels.
-   */
-  showVersions?: boolean;
-  /**
-   * Direction for the flowchart.
-   */
-  direction?: 'LR' | 'TB' | 'RL' | 'BT';
-}
-/**
- * Generate a Mermaid diagram from integrity analysis results.
- */
-declare function generateMermaidDiagram(result: IntegrityAnalysisResult, type?: DiagramType, options?: DiagramOptions): string;
-//#endregion
-export { DiagramOptions, DiagramType, generateMermaidDiagram };

package/dist/services/integrity.d.ts

@@ -1,133 +0,0 @@
-import { FsAdapter } from "../ports/fs.js";
-import { LoggerAdapter } from "../ports/logger.js";
-import { AnalyzedSpecType, FeatureScanResult, RefInfo } from "@lssm/module.contractspec-workspace";
-
-//#region src/services/integrity.d.ts
-
-/**
- * Options for integrity analysis.
- */
-interface IntegrityAnalysisOptions {
-  /**
-   * Glob pattern for file discovery.
-   */
-  pattern?: string;
-  /**
-   * Scan all packages in monorepo.
-   */
-  all?: boolean;
-  /**
-   * Analyze only a specific feature by key.
-   */
-  featureKey?: string;
-  /**
-   * Filter by spec type.
-   */
-  specType?: AnalyzedSpecType;
-}
-/**
- * Location of a spec in the codebase.
- */
-interface SpecLocation {
-  name: string;
-  version: number;
-  file: string;
-  type: AnalyzedSpecType;
-  stability?: string;
-}
-/**
- * Inventory of all discovered specs organized by type.
- */
-interface SpecInventory {
-  operations: Map<string, SpecLocation>;
-  events: Map<string, SpecLocation>;
-  presentations: Map<string, SpecLocation>;
-  capabilities: Map<string, SpecLocation>;
-  workflows: Map<string, SpecLocation>;
-  dataViews: Map<string, SpecLocation>;
-  forms: Map<string, SpecLocation>;
-  migrations: Map<string, SpecLocation>;
-  experiments: Map<string, SpecLocation>;
-  integrations: Map<string, SpecLocation>;
-  knowledge: Map<string, SpecLocation>;
-  telemetry: Map<string, SpecLocation>;
-  appConfigs: Map<string, SpecLocation>;
-  policies: Map<string, SpecLocation>;
-  testSpecs: Map<string, SpecLocation>;
-}
-/**
- * An integrity issue found during analysis.
- */
-interface IntegrityIssue {
-  severity: 'error' | 'warning';
-  type: 'orphaned' | 'unresolved-ref' | 'missing-feature' | 'broken-link';
-  message: string;
-  file: string;
-  specName?: string;
-  specType?: AnalyzedSpecType;
-  ref?: RefInfo;
-  featureKey?: string;
-}
-/**
- * Coverage metrics by spec type.
- */
-interface CoverageByType {
-  total: number;
-  covered: number;
-  orphaned: number;
-}
-/**
- * Result of integrity analysis.
- */
-interface IntegrityAnalysisResult {
-  /**
-   * All discovered specs organized by type.
-   */
-  inventory: SpecInventory;
-  /**
-   * All discovered features.
-   */
-  features: FeatureScanResult[];
-  /**
-   * Coverage metrics.
-   */
-  coverage: {
-    total: number;
-    linkedToFeature: number;
-    orphaned: number;
-    byType: Record<string, CoverageByType>;
-  };
-  /**
-   * Issues found during analysis.
-   */
-  issues: IntegrityIssue[];
-  /**
-   * Specs not linked to any feature.
-   */
-  orphanedSpecs: SpecLocation[];
-  /**
-   * Overall health status.
-   */
-  healthy: boolean;
-}
-/**
- * Analyze contract integrity.
- */
-declare function analyzeIntegrity(adapters: {
-  fs: FsAdapter;
-  logger: LoggerAdapter;
-}, options?: IntegrityAnalysisOptions): Promise<IntegrityAnalysisResult>;
-/**
- * Get all specs from inventory as a flat list.
- */
-declare function getAllSpecs(inventory: SpecInventory): SpecLocation[];
-/**
- * Filter issues by type.
- */
-declare function filterIssuesByType(issues: IntegrityIssue[], type: IntegrityIssue['type']): IntegrityIssue[];
-/**
- * Filter issues by severity.
- */
-declare function filterIssuesBySeverity(issues: IntegrityIssue[], severity: IntegrityIssue['severity']): IntegrityIssue[];
-//#endregion
-export { CoverageByType, IntegrityAnalysisOptions, IntegrityAnalysisResult, IntegrityIssue, SpecInventory, SpecLocation, analyzeIntegrity, filterIssuesBySeverity, filterIssuesByType, getAllSpecs };

package/dist/services/list.d.ts

@@ -1,30 +0,0 @@
-import { FsAdapter } from "../ports/fs.js";
-import { SpecScanResult } from "@lssm/module.contractspec-workspace";
-
-//#region src/services/list.d.ts
-
-/**
- * Options for listing specs.
- */
-interface ListSpecsOptions {
-  /**
-   * File pattern to search.
-   */
-  pattern?: string;
-  /**
-   * Filter by spec type.
-   */
-  type?: string;
-}
-/**
- * List all spec files in the workspace.
- */
-declare function listSpecs(adapters: {
-  fs: FsAdapter;
-}, options?: ListSpecsOptions): Promise<SpecScanResult[]>;
-/**
- * Group specs by type.
- */
-declare function groupSpecsByType(specs: SpecScanResult[]): Map<string, SpecScanResult[]>;
-//#endregion
-export { ListSpecsOptions, groupSpecsByType, listSpecs };

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

@@ -1,52 +0,0 @@
-import { FsAdapter } from "../../ports/fs.js";
-import { LoggerAdapter } from "../../ports/logger.js";
-import { OpenApiDocument, OpenApiServer } from "@lssm/lib.contracts";
-
-//#region src/services/openapi/export-service.d.ts
-
-/**
- * Options for OpenAPI export.
- */
-interface OpenApiExportOptions {
-  /**
-   * Path to module exporting SpecRegistry.
-   */
-  registryPath: string;
-  /**
-   * Output file path.
-   */
-  outputPath?: string;
-  /**
-   * OpenAPI title.
-   */
-  title?: string;
-  /**
-   * OpenAPI version.
-   */
-  version?: string;
-  /**
-   * OpenAPI description.
-   */
-  description?: string;
-  /**
-   * Server URLs to include.
-   */
-  servers?: OpenApiServer[];
-}
-/**
- * Result of OpenAPI export.
- */
-interface OpenApiExportResult {
-  document: OpenApiDocument;
-  outputPath: string;
-  json: string;
-}
-/**
- * Export OpenAPI document from a SpecRegistry.
- */
-declare function exportOpenApi(options: OpenApiExportOptions, adapters: {
-  fs: FsAdapter;
-  logger: LoggerAdapter;
-}): Promise<OpenApiExportResult>;
-//#endregion
-export { OpenApiExportOptions, OpenApiExportResult, exportOpenApi };

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

@@ -1,15 +0,0 @@
-import { FsAdapter } from "../../ports/fs.js";
-import { LoggerAdapter } from "../../ports/logger.js";
-import { OpenApiImportServiceOptions, OpenApiImportServiceResult } from "./types.js";
-
-//#region src/services/openapi/import-service.d.ts
-
-/**
- * Import ContractSpec specs from an OpenAPI document.
- */
-declare function importFromOpenApiService(options: OpenApiImportServiceOptions, adapters: {
-  fs: FsAdapter;
-  logger: LoggerAdapter;
-}): Promise<OpenApiImportServiceResult>;
-//#endregion
-export { importFromOpenApiService };

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

@@ -1,18 +0,0 @@
-import { FsAdapter } from "../../ports/fs.js";
-import { LoggerAdapter } from "../../ports/logger.js";
-import { OpenApiSourceConfig, OpenApiSyncServiceOptions, OpenApiSyncServiceResult } from "./types.js";
-
-//#region src/services/openapi/sync-service.d.ts
-
-/**
- * Sync ContractSpec specs with OpenAPI sources.
- */
-declare function syncWithOpenApiService(options: OpenApiSyncServiceOptions, config: {
-  sources?: OpenApiSourceConfig[];
-  outputDir: string;
-}, adapters: {
-  fs: FsAdapter;
-  logger: LoggerAdapter;
-}): Promise<OpenApiSyncServiceResult>;
-//#endregion
-export { syncWithOpenApiService };