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

package/dist/services/agent-guide/adapters/generic-mcp.d.ts

@@ -1,52 +0,0 @@
-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/generic-mcp.d.ts
-
-/**
- * Generic MCP adapter implementation.
- * Works with any MCP-compatible agent (Cline, Aider, etc.).
- */
-declare class GenericMCPAdapter implements AgentAdapter {
-  agentType: "generic-mcp";
-  /**
-   * Format an implementation plan for generic MCP agents.
-   * Uses a standard markdown format that works across different agents.
-   */
-  formatPlan(plan: ImplementationPlan): AgentPrompt;
-  /**
-   * Format the plan as an MCP resource.
-   * Returns JSON that can be served as an MCP resource.
-   */
-  formatAsResource(plan: ImplementationPlan): {
-    uri: string;
-    mimeType: string;
-    data: string;
-  };
-  /**
-   * Format the plan as an MCP prompt message.
-   */
-  formatAsPromptMessage(plan: ImplementationPlan): {
-    role: 'user' | 'assistant';
-    content: {
-      type: 'text';
-      text: string;
-    };
-  };
-  /**
-   * Generate configuration (generic markdown for any agent).
-   */
-  generateConfig(spec: AnyContractSpec): string;
-  /**
-   * Parse agent output - generic implementation.
-   */
-  parseOutput(output: string): {
-    code?: string;
-    errors?: string[];
-  };
-}
-/** Singleton instance */
-declare const genericMCPAdapter: GenericMCPAdapter;
-//#endregion
-export { GenericMCPAdapter, genericMCPAdapter };

package/dist/services/agent-guide/adapters/index.d.ts

@@ -1,22 +0,0 @@
-import { AgentAdapter } from "../types.js";
-import { ClaudeCodeAdapter, claudeCodeAdapter } from "./claude-code.js";
-import { CursorCLIAdapter, cursorCLIAdapter } from "./cursor-cli.js";
-import { GenericMCPAdapter, genericMCPAdapter } from "./generic-mcp.js";
-import { AgentType } from "@lssm/lib.contracts/llm";
-
-//#region src/services/agent-guide/adapters/index.d.ts
-
-/**
- * Registry of all available agent adapters.
- */
-declare const agentAdapters: Record<AgentType, AgentAdapter>;
-/**
- * Get an adapter for a specific agent type.
- */
-declare function getAgentAdapter(agent: AgentType): AgentAdapter;
-/**
- * List all available agent types.
- */
-declare function listAgentTypes(): AgentType[];
-//#endregion
-export { agentAdapters, getAgentAdapter, listAgentTypes };

package/dist/services/agent-guide/agent-guide-service.d.ts

@@ -1,55 +0,0 @@
-import { AgentGuideConfig, GuideOptions, GuideResult } from "./types.js";
-import { AnyContractSpec, PresentationRegistry, SpecRegistry } from "@lssm/lib.contracts";
-import { AgentType } from "@lssm/lib.contracts/llm";
-import { FeatureModuleSpec } from "@lssm/lib.contracts/features";
-
-//#region src/services/agent-guide/agent-guide-service.d.ts
-
-/**
- * Agent Guide Service
- *
- * Main service for generating implementation guidance for AI coding agents.
- */
-declare class AgentGuideService {
-  private config;
-  constructor(config?: Partial<AgentGuideConfig>);
-  /**
-   * Generate an implementation guide for a spec.
-   */
-  generateGuide(spec: AnyContractSpec, options?: GuideOptions): GuideResult;
-  /**
-   * Generate a guide for a feature (includes all related specs).
-   */
-  generateFeatureGuide(feature: FeatureModuleSpec, deps: {
-    specs?: SpecRegistry;
-    presentations?: PresentationRegistry;
-  }, options?: GuideOptions): GuideResult;
-  /**
-   * Generate agent-specific configuration (e.g., cursor rules).
-   */
-  generateAgentConfig(spec: AnyContractSpec, agent?: AgentType): string | undefined;
-  /**
-   * Export a spec in a specific format for an agent.
-   */
-  exportForAgent(spec: AnyContractSpec, agent: AgentType, taskType?: 'implement' | 'test' | 'refactor' | 'review', existingCode?: string): string;
-  /**
-   * List available agent types.
-   */
-  listAgentTypes(): AgentType[];
-  /**
-   * Get the default agent type.
-   */
-  getDefaultAgent(): AgentType;
-  /**
-   * Update configuration.
-   */
-  configure(config: Partial<AgentGuideConfig>): void;
-}
-/**
- * Create a new AgentGuideService instance.
- */
-declare function createAgentGuideService(config?: Partial<AgentGuideConfig>): AgentGuideService;
-/** Default singleton instance */
-declare const agentGuideService: AgentGuideService;
-//#endregion
-export { AgentGuideService, agentGuideService, createAgentGuideService };

package/dist/services/agent-guide/types.d.ts

@@ -1,57 +0,0 @@
-import { AnyContractSpec } from "@lssm/lib.contracts";
-import { AgentPrompt, AgentType, ImplementationPlan } from "@lssm/lib.contracts/llm";
-
-//#region src/services/agent-guide/types.d.ts
-
-/** Configuration for the agent guide service */
-interface AgentGuideConfig {
-  /** Default agent to use if not specified */
-  defaultAgent: AgentType;
-  /** Project root path */
-  projectRoot?: string;
-  /** Enable verbose logging */
-  verbose?: boolean;
-}
-/** Options for generating an implementation guide */
-interface GuideOptions {
-  /** Target agent type */
-  agent?: AgentType;
-  /** Existing code to consider */
-  existingCode?: string;
-  /** Target file path for implementation */
-  targetPath?: string;
-  /** Include related specs */
-  includeRelated?: boolean;
-}
-/** Options for formatting output */
-interface FormatOptions {
-  /** Output format */
-  format: 'markdown' | 'json' | 'cursor-rules';
-  /** Include system prompt */
-  includeSystemPrompt?: boolean;
-}
-/** Result of generating a guide */
-interface GuideResult {
-  /** The generated plan */
-  plan: ImplementationPlan;
-  /** Formatted prompt for the target agent */
-  prompt: AgentPrompt;
-  /** Raw markdown for clipboard/export */
-  markdown: string;
-}
-/** Adapter interface for specific agent types */
-interface AgentAdapter {
-  /** Agent type this adapter handles */
-  agentType: AgentType;
-  /** Format a plan for this agent */
-  formatPlan(plan: ImplementationPlan): AgentPrompt;
-  /** Generate agent-specific configuration (e.g., cursor rules) */
-  generateConfig?(spec: AnyContractSpec): string;
-  /** Parse agent output to extract code */
-  parseOutput?(output: string): {
-    code?: string;
-    errors?: string[];
-  };
-}
-//#endregion
-export { AgentAdapter, AgentGuideConfig, FormatOptions, GuideOptions, GuideResult };

package/dist/services/build.d.ts

@@ -1,58 +0,0 @@
-import { FsAdapter } from "../ports/fs.js";
-import { LoggerAdapter } from "../ports/logger.js";
-import { SpecScanResult, WorkspaceConfig } from "@lssm/module.contractspec-workspace";
-
-//#region src/services/build.d.ts
-
-/**
- * Build target types.
- */
-type BuildTarget = 'handler' | 'component' | 'test';
-/**
- * Options for building from a spec.
- */
-interface BuildSpecOptions {
-  /**
-   * Which artifacts to generate.
-   */
-  targets?: BuildTarget[];
-  /**
-   * Override output directory.
-   */
-  outputDir?: string;
-  /**
-   * Whether to overwrite existing files.
-   */
-  overwrite?: boolean;
-  /**
-   * Skip writing files (dry run).
-   */
-  dryRun?: boolean;
-}
-/**
- * Result of a single build target.
- */
-interface BuildTargetResult {
-  target: BuildTarget;
-  outputPath: string;
-  success: boolean;
-  skipped?: boolean;
-  error?: string;
-}
-/**
- * Result of building from a spec.
- */
-interface BuildSpecResult {
-  specPath: string;
-  specInfo: SpecScanResult;
-  results: BuildTargetResult[];
-}
-/**
- * Build implementation files from a spec.
- */
-declare function buildSpec(specPath: string, adapters: {
-  fs: FsAdapter;
-  logger: LoggerAdapter;
-}, config: WorkspaceConfig, options?: BuildSpecOptions): Promise<BuildSpecResult>;
-//#endregion
-export { BuildSpecOptions, BuildSpecResult, BuildTarget, BuildTargetResult, buildSpec };

package/dist/services/ci-check/ci-check-service.d.ts

@@ -1,15 +0,0 @@
-import { FsAdapter } from "../../ports/fs.js";
-import { LoggerAdapter } from "../../ports/logger.js";
-import { CICheckOptions, CICheckResult } from "./types.js";
-
-//#region src/services/ci-check/ci-check-service.d.ts
-
-/**
- * Run all CI checks and return structured results.
- */
-declare function runCIChecks(adapters: {
-  fs: FsAdapter;
-  logger: LoggerAdapter;
-}, options?: CICheckOptions): Promise<CICheckResult>;
-//#endregion
-export { runCIChecks };

package/dist/services/ci-check/types.d.ts

@@ -1,142 +0,0 @@
-//#region src/services/ci-check/types.d.ts
-/**
- * CI Check service types.
- *
- * Types for CI/CD validation checks with support for multiple output formats.
- */
-/**
- * Categories of CI checks.
- */
-type CICheckCategory = 'structure' | 'integrity' | 'deps' | 'doctor' | 'handlers' | 'tests' | 'implementation';
-/**
- * All available CI check categories.
- */
-declare const ALL_CI_CHECK_CATEGORIES: CICheckCategory[];
-/**
- * Human-readable labels for CI check categories.
- */
-declare const CI_CHECK_CATEGORY_LABELS: Record<CICheckCategory, string>;
-/**
- * Severity of a CI check issue.
- */
-type CIIssueSeverity = 'error' | 'warning' | 'note';
-/**
- * A single issue found during CI checks.
- */
-interface CIIssue {
-  /** Unique ID for the issue type. */
-  ruleId: string;
-  /** Severity level. */
-  severity: CIIssueSeverity;
-  /** Human-readable message. */
-  message: string;
-  /** Category of the check. */
-  category: CICheckCategory;
-  /** File path where the issue was found. */
-  file?: string;
-  /** Line number (1-based). */
-  line?: number;
-  /** Column number (1-based). */
-  column?: number;
-  /** End line number (1-based). */
-  endLine?: number;
-  /** End column number (1-based). */
-  endColumn?: number;
-  /** Additional context. */
-  context?: Record<string, unknown>;
-}
-/**
- * Summary statistics for a CI check category.
- */
-interface CICheckCategorySummary {
-  /** Category name. */
-  category: CICheckCategory;
-  /** Human-readable label. */
-  label: string;
-  /** Number of errors. */
-  errors: number;
-  /** Number of warnings. */
-  warnings: number;
-  /** Number of notes. */
-  notes: number;
-  /** Whether this category passed. */
-  passed: boolean;
-  /** Duration in milliseconds. */
-  durationMs: number;
-}
-/**
- * Overall CI check result.
- */
-interface CICheckResult {
-  /** Whether all checks passed (no errors). */
-  success: boolean;
-  /** Total number of errors. */
-  totalErrors: number;
-  /** Total number of warnings. */
-  totalWarnings: number;
-  /** Total number of notes. */
-  totalNotes: number;
-  /** All issues found. */
-  issues: CIIssue[];
-  /** Summary by category. */
-  categories: CICheckCategorySummary[];
-  /** Total duration in milliseconds. */
-  durationMs: number;
-  /** Timestamp when the check was run. */
-  timestamp: string;
-  /** Git commit SHA if available. */
-  commitSha?: string;
-  /** Git branch if available. */
-  branch?: string;
-}
-/**
- * Options for running CI checks.
- */
-interface CICheckOptions {
-  /** Glob pattern for spec discovery. */
-  pattern?: string;
-  /** Check categories to run (defaults to all). */
-  checks?: CICheckCategory[];
-  /** Skip specific categories. */
-  skip?: CICheckCategory[];
-  /** Include handler existence checks. */
-  checkHandlers?: boolean;
-  /** Include test coverage checks. */
-  checkTests?: boolean;
-  /** Fail on warnings (treat warnings as errors). */
-  failOnWarnings?: boolean;
-  /** Workspace root directory. */
-  workspaceRoot?: string;
-  /** Implementation check options. */
-  implementation?: {
-    /** Require all specs to be implemented. */
-    requireImplemented?: boolean;
-    /** Verification tier to run. */
-    verificationTier?: 'structure' | 'behavior' | 'ai';
-    /** Use cache for verification results. */
-    useCache?: boolean;
-    /** Allow partial implementations. */
-    allowPartial?: boolean;
-  };
-}
-/**
- * Output format for CI check results.
- */
-type CIOutputFormat = 'text' | 'json' | 'sarif';
-/**
- * Options for formatting CI check output.
- */
-interface CIFormatOptions {
-  /** Output format. */
-  format: CIOutputFormat;
-  /** Whether to use colors (for text format). */
-  colors?: boolean;
-  /** Tool name for SARIF output. */
-  toolName?: string;
-  /** Tool version for SARIF output. */
-  toolVersion?: string;
-  /** Repository URI for SARIF output. */
-  repositoryUri?: string;
-}
-//#endregion
-export { ALL_CI_CHECK_CATEGORIES, CICheckCategory, CICheckCategorySummary, CICheckOptions, CICheckResult, CIFormatOptions, CIIssue, CIIssueSeverity, CIOutputFormat, CI_CHECK_CATEGORY_LABELS };

package/dist/services/clean.d.ts

@@ -1,40 +0,0 @@
-import { FsAdapter } from "../ports/fs.js";
-import { LoggerAdapter } from "../ports/logger.js";
-
-//#region src/services/clean.d.ts
-
-interface CleanOptions {
-  /**
-   * When true, only remove known build artifact directories and known generated
-   * suffixes (safe-by-default).
-   */
-  generatedOnly?: boolean;
-  /**
-   * Skip deletions; just report.
-   */
-  dryRun?: boolean;
-  /**
-   * Only delete files older than this many days.
-   */
-  olderThanDays?: number;
-  /**
-   * Output directory used for generated artifacts (handlers/components/forms).
-   */
-  outputDir?: string;
-}
-interface CleanResult {
-  removed: {
-    path: string;
-    size: number;
-  }[];
-  skipped: {
-    path: string;
-    reason: string;
-  }[];
-}
-declare function cleanArtifacts(adapters: {
-  fs: FsAdapter;
-  logger: LoggerAdapter;
-}, options?: CleanOptions): Promise<CleanResult>;
-//#endregion
-export { CleanOptions, CleanResult, cleanArtifacts };

package/dist/services/config.d.ts

@@ -1,25 +0,0 @@
-import { FsAdapter } from "../ports/fs.js";
-import { WorkspaceConfig } from "@lssm/module.contractspec-workspace";
-
-//#region src/services/config.d.ts
-
-/**
- * Load workspace configuration from .contractsrc.json.
- */
-declare function loadWorkspaceConfig(fs: FsAdapter, cwd?: string): Promise<WorkspaceConfig>;
-/**
- * Merge config with CLI options and environment variables.
- */
-declare function mergeWorkspaceConfig(config: WorkspaceConfig, options: {
-  provider?: string;
-  model?: string;
-  agentMode?: string;
-  endpoint?: string;
-  outputDir?: string;
-}): WorkspaceConfig;
-/**
- * Get API key for the configured provider.
- */
-declare function getApiKey(provider: WorkspaceConfig['aiProvider']): string | undefined;
-//#endregion
-export { getApiKey, loadWorkspaceConfig, mergeWorkspaceConfig };

package/dist/services/deps.d.ts

@@ -1,52 +0,0 @@
-import { FsAdapter } from "../ports/fs.js";
-import { ContractGraph, ContractNode } from "@lssm/module.contractspec-workspace";
-
-//#region src/services/deps.d.ts
-
-/**
- * Options for dependency analysis.
- */
-interface AnalyzeDepsOptions {
-  /**
-   * File pattern to search.
-   */
-  pattern?: string;
-}
-/**
- * Result of dependency analysis.
- */
-interface AnalyzeDepsResult {
-  graph: ContractGraph;
-  total: number;
-  cycles: string[][];
-  missing: {
-    contract: string;
-    missing: string[];
-  }[];
-}
-/**
- * Analyze contract dependencies.
- */
-declare function analyzeDeps(adapters: {
-  fs: FsAdapter;
-}, options?: AnalyzeDepsOptions): Promise<AnalyzeDepsResult>;
-/**
- * Get contract node by name.
- */
-declare function getContractNode(graph: ContractGraph, name: string): ContractNode | undefined;
-/**
- * Export graph as DOT format.
- */
-declare function exportGraphAsDot(graph: ContractGraph): string;
-/**
- * Get graph statistics.
- */
-declare function getGraphStats(graph: ContractGraph): {
-  total: number;
-  withDeps: number;
-  withoutDeps: number;
-  used: number;
-  unused: number;
-};
-//#endregion
-export { AnalyzeDepsOptions, AnalyzeDepsResult, analyzeDeps, exportGraphAsDot, getContractNode, getGraphStats };

package/dist/services/diff.d.ts

@@ -1,33 +0,0 @@
-import { FsAdapter } from "../ports/fs.js";
-import { GitAdapter } from "../ports/git.js";
-import { SemanticDiffItem, SemanticDiffOptions } from "@lssm/module.contractspec-workspace";
-
-//#region src/services/diff.d.ts
-
-/**
- * Options for comparing specs.
- */
-interface CompareSpecsOptions extends SemanticDiffOptions {
-  /**
-   * Git ref to compare against (branch, tag, commit).
-   * If provided, spec2 is loaded from this ref instead of filesystem.
-   */
-  baseline?: string;
-}
-/**
- * Result of spec comparison.
- */
-interface CompareSpecsResult {
-  spec1: string;
-  spec2: string;
-  differences: SemanticDiffItem[];
-}
-/**
- * Compare two spec files semantically.
- */
-declare function compareSpecs(spec1Path: string, spec2Path: string, adapters: {
-  fs: FsAdapter;
-  git: GitAdapter;
-}, options?: CompareSpecsOptions): Promise<CompareSpecsResult>;
-//#endregion
-export { CompareSpecsOptions, CompareSpecsResult, compareSpecs };

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

@@ -1,23 +0,0 @@
-import { FsAdapter } from "../../ports/fs.js";
-import { LoggerAdapter } from "../../ports/logger.js";
-import { CheckResult, DoctorOptions, DoctorPromptCallbacks, DoctorResult } from "./types.js";
-
-//#region src/services/doctor/doctor-service.d.ts
-
-/**
- * Run all health checks and optionally apply fixes.
- */
-declare function runDoctor(adapters: {
-  fs: FsAdapter;
-  logger: LoggerAdapter;
-}, options: DoctorOptions, prompts?: DoctorPromptCallbacks): Promise<DoctorResult>;
-/**
- * Get a summary string for the doctor result.
- */
-declare function formatDoctorSummary(result: DoctorResult): string;
-/**
- * Format a single check result for display.
- */
-declare function formatCheckResult(result: CheckResult): string;
-//#endregion
-export { formatCheckResult, formatDoctorSummary, runDoctor };