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

package/dist/modules/contractspec-workspace/dist/templates/telemetry.js

@@ -1,89 +0,0 @@
-import { toPascalCase } from "./utils.js";
-
-//#region ../../modules/contractspec-workspace/dist/templates/telemetry.js
-function generateTelemetrySpec(data) {
-	const specVar = toPascalCase(data.name.split(".").pop() ?? "Telemetry") + "Telemetry";
-	const providers = data.providers?.length ? `providers: [
-${data.providers.map((provider) => `      {
-        type: '${provider.type}',
-        config: ${formatConfigValue(provider.config)},
-      }`).join(",\n")}
-    ],` : "";
-	const events = data.events.map((event) => {
-		const properties = event.properties.map((prop) => `      '${prop.name}': {
-        type: '${prop.type}',
-        ${prop.required ? "required: true," : ""}
-        ${prop.pii ? "pii: true," : ""}
-        ${prop.redact ? "redact: true," : ""}
-        ${prop.description ? `description: '${escapeString(prop.description)}',` : ""}
-      }`).join(",\n");
-		const anomalyRules = event.anomalyRules?.length ? `      anomalyDetection: {
-        enabled: true,
-        ${typeof event.anomalyMinimumSample === "number" ? `minimumSample: ${event.anomalyMinimumSample},` : ""}
-        thresholds: [
-${event.anomalyRules.map((rule) => `          {
-            metric: '${escapeString(rule.metric)}',
-            ${typeof rule.min === "number" ? `min: ${rule.min},` : ""}
-            ${typeof rule.max === "number" ? `max: ${rule.max},` : ""}
-          }`).join(",\n")}
-        ],
-        actions: [${(event.anomalyActions ?? []).map((action) => `'${action}'`).join(", ")}],
-      },` : event.anomalyEnabled ? `      anomalyDetection: {
-        enabled: true,
-        ${typeof event.anomalyMinimumSample === "number" ? `minimumSample: ${event.anomalyMinimumSample},` : ""}
-      },` : "";
-		return `    {
-      name: '${escapeString(event.name)}',
-      version: ${event.version},
-      semantics: {
-        what: '${escapeString(event.what)}',
-        ${event.who ? `who: '${escapeString(event.who)}',` : ""}
-        ${event.why ? `why: '${escapeString(event.why)}',` : ""}
-      },
-      privacy: '${event.privacy}',
-      properties: {
-${properties}
-      },
-      ${typeof event.retentionDays === "number" ? `retention: { days: ${event.retentionDays}, ${event.retentionPolicy ? `policy: '${event.retentionPolicy}'` : ""} },` : ""}
-      ${typeof event.samplingRate === "number" ? `sampling: { rate: ${event.samplingRate}${event.samplingConditions ? `, conditions: ['${escapeString(event.samplingConditions)}']` : ""} },` : ""}
-${anomalyRules}
-      ${event.tags?.length ? `tags: [${event.tags.map((tag) => `'${escapeString(tag)}'`).join(", ")}],` : ""}
-    }`;
-	}).join(",\n");
-	return `import type { TelemetrySpec } from '@lssm/lib.contracts/telemetry';
-
-export const ${specVar}: TelemetrySpec = {
-  meta: {
-    name: '${escapeString(data.name)}',
-    version: ${data.version},
-    title: '${escapeString(data.name)} telemetry',
-    description: '${escapeString(data.description || "Describe the purpose of this telemetry spec.")}',
-    domain: '${escapeString(data.domain)}',
-    owners: [${data.owners.map((owner) => `'${escapeString(owner)}'`).join(", ")}],
-    tags: [${data.tags.map((tag) => `'${escapeString(tag)}'`).join(", ")}],
-    stability: '${data.stability}',
-  },
-  config: {
-    ${typeof data.defaultRetentionDays === "number" ? `defaultRetentionDays: ${data.defaultRetentionDays},` : ""}
-    ${typeof data.defaultSamplingRate === "number" ? `defaultSamplingRate: ${data.defaultSamplingRate},` : ""}
-    ${data.anomalyEnabled ? `anomalyDetection: { enabled: true${typeof data.anomalyCheckIntervalMs === "number" ? `, checkIntervalMs: ${data.anomalyCheckIntervalMs}` : ""} },` : ""}
-${providers}
-  },
-  events: [
-${events}
-  ],
-};
-`;
-}
-function escapeString(value) {
-	return value.replace(/\\/g, "\\\\").replace(/'/g, "\\'");
-}
-function formatConfigValue(value) {
-	const trimmed = value.trim();
-	if (!trimmed) return "{}";
-	if (trimmed.startsWith("{") && trimmed.endsWith("}") || trimmed.startsWith("[") && trimmed.endsWith("]")) return trimmed;
-	return `'${escapeString(trimmed)}'`;
-}
-
-//#endregion
-export { generateTelemetrySpec };

package/dist/modules/contractspec-workspace/dist/templates/utils.js

@@ -1,38 +0,0 @@
-//#region ../../modules/contractspec-workspace/dist/templates/utils.js
-/**
-* Utility functions for template generation.
-*/
-/**
-* Convert string to camelCase.
-*/
-function toCamelCase(str) {
-	const pascal = toPascalCase(str);
-	return pascal.charAt(0).toLowerCase() + pascal.slice(1);
-}
-/**
-* Convert string to PascalCase.
-*/
-function toPascalCase(str) {
-	return str.split(/[-_.]/).map((word) => word.charAt(0).toUpperCase() + word.slice(1)).join("");
-}
-/**
-* Convert string to kebab-case.
-*/
-function toKebabCase(str) {
-	return str.replace(/\./g, "-").replace(/([a-z])([A-Z])/g, "$1-$2").toLowerCase();
-}
-/**
-* Capitalize first letter.
-*/
-function capitalize(str) {
-	return str.charAt(0).toUpperCase() + str.slice(1);
-}
-/**
-* Escape single quotes in string.
-*/
-function escapeString(value) {
-	return value.replace(/'/g, "\\'");
-}
-
-//#endregion
-export { capitalize, escapeString, toCamelCase, toKebabCase, toPascalCase };

package/dist/modules/contractspec-workspace/dist/templates/workflow-runner.js

@@ -1,48 +0,0 @@
-//#region ../../modules/contractspec-workspace/dist/templates/workflow-runner.js
-function generateWorkflowRunnerTemplate({ exportName, specImportPath, runnerName, workflowName }) {
-	return `import {
-  InMemoryStateStore,
-  WorkflowRegistry,
-  WorkflowRunner,
-} from '@lssm/lib.contracts/workflow';
-import { ${exportName} } from '${specImportPath}';
-
-/**
- * Runner wiring for ${workflowName}.
- *
- * TODO:
- *  - Replace the in-memory state store with a persistent adapter if needed.
- *  - Implement opExecutor to invoke the correct contract handlers.
- *  - Wire eventEmitter to telemetry sinks.
- */
-const registry = new WorkflowRegistry();
-registry.register(${exportName});
-
-const stateStore = new InMemoryStateStore();
-
-export const ${runnerName} = new WorkflowRunner({
-  registry,
-  stateStore,
-  opExecutor: async (operation, input, ctx) => {
-    // TODO: route to the appropriate contract handler
-    // Example: return contractRegistry.execute(operation.name, operation.version, input, ctx);
-    throw new Error(
-      \`opExecutor for \${operation.name}.v\${operation.version} is not implemented\`
-    );
-  },
-  // appConfigProvider: async (state) => {
-  //   // TODO: return the ResolvedAppConfig for this workflow run (tenant/environment)
-  //   return undefined;
-  // },
-  // enforceCapabilities: async (operation, context) => {
-  //   // TODO: ensure required capabilities are satisfied using context.integrations/context.resolvedAppConfig
-  // },
-  eventEmitter: (_event, _payload) => {
-    // TODO: forward workflow events to telemetry or logging sinks
-  },
-});
-`;
-}
-
-//#endregion
-export { generateWorkflowRunnerTemplate };

package/dist/modules/contractspec-workspace/dist/templates/workflow.js

@@ -1,67 +0,0 @@
-import { escapeString, toPascalCase } from "./utils.js";
-
-//#region ../../modules/contractspec-workspace/dist/templates/workflow.js
-/**
-* Generate workflow spec TypeScript code.
-*/
-function generateWorkflowSpec(data) {
-	const specVarName = toPascalCase(data.name.split(".").pop() ?? "Workflow") + "Workflow";
-	const stepsCode = data.steps.map((step) => formatStep(step)).join(",\n");
-	const transitionsCode = data.transitions.map((transition) => `    {
-      from: '${transition.from}',
-      to: '${transition.to}',
-${transition.condition ? `      condition: '${escapeString(transition.condition)}',` : ""}
-    }`).join(",\n");
-	return `import type { WorkflowSpec } from '@lssm/lib.contracts/workflow';
-
-/**
- * Workflow generated via contractspec CLI.
- * TODO:
- *  - Review step definitions and descriptions.
- *  - Wire automation steps to actual operations.
- *  - Provide form renderers for human steps.
- *  - Add guards/conditions as needed.
- */
-export const ${specVarName}: WorkflowSpec = {
-  meta: {
-    name: '${data.name}',
-    version: ${data.version},
-    title: '${escapeString(data.title)}',
-    description: '${escapeString(data.description)}',
-    domain: '${escapeString(data.domain)}',
-    stability: '${data.stability}',
-    owners: [${data.owners.map((owner) => `'${owner}'`).join(", ")}],
-    tags: [${data.tags.map((tag) => `'${tag}'`).join(", ")}],
-  },
-  definition: {
-${data.entryStepId ? `    entryStepId: '${data.entryStepId}',\n` : ""}    steps: [
-${stepsCode}
-    ],
-    transitions: [
-${transitionsCode}
-    ],
-  },
-  ${data.policyFlags.length > 0 ? `policy: {
-    flags: [${data.policyFlags.map((flag) => `'${flag}'`).join(", ")}],
-  },` : "// policy: { flags: [] },"}
-};
-`;
-}
-function formatStep(step) {
-	const lines = [
-		`    {`,
-		`      id: '${step.id}',`,
-		`      type: '${step.type}',`,
-		`      label: '${escapeString(step.label)}',`
-	];
-	if (step.description) lines.push(`      description: '${escapeString(step.description)}',`);
-	const actionLines = [];
-	if (step.operation) actionLines.push(`operation: { name: '${step.operation.name}', version: ${step.operation.version} }`);
-	if (step.form) actionLines.push(`form: { key: '${step.form.key}', version: ${step.form.version} }`);
-	if (actionLines.length) lines.push(`      action: { ${actionLines.join(", ")} },`);
-	lines.push(`    }`);
-	return lines.join("\n");
-}
-
-//#endregion
-export { generateWorkflowSpec };

package/dist/modules/contractspec-workspace/dist/types/generation-types.js

@@ -1,20 +0,0 @@
-//#region ../../modules/contractspec-workspace/dist/types/generation-types.js
-/**
-* Default workspace configuration.
-*/
-const DEFAULT_WORKSPACE_CONFIG = {
-	aiProvider: "claude",
-	agentMode: "simple",
-	outputDir: "./src",
-	conventions: {
-		operations: "interactions/commands|queries",
-		events: "events",
-		presentations: "presentations",
-		forms: "forms"
-	},
-	defaultOwners: [],
-	defaultTags: []
-};
-
-//#endregion
-export { DEFAULT_WORKSPACE_CONFIG };

package/dist/ports/ai.d.ts

@@ -1,58 +0,0 @@
-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

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

@@ -1,32 +0,0 @@
-//#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/logger.d.ts

@@ -1,87 +0,0 @@
-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

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

@@ -1,34 +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/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 };

package/dist/services/agent-guide/adapters/cursor-cli.d.ts

@@ -1,38 +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/cursor-cli.d.ts
-
-/**
- * Cursor CLI adapter implementation.
- * Optimized for Cursor's background/composer mode.
- */
-declare class CursorCLIAdapter implements AgentAdapter {
-  agentType: "cursor-cli";
-  /**
-   * Format an implementation plan for Cursor CLI.
-   * Uses concise format optimized for Cursor's context window.
-   */
-  formatPlan(plan: ImplementationPlan): AgentPrompt;
-  /**
-   * Generate Cursor rules (.mdc format) for a spec.
-   * Can be saved to .cursor/rules/ to provide persistent context.
-   */
-  generateConfig(spec: AnyContractSpec): string;
-  /**
-   * Generate a cursor rules file path for a spec.
-   */
-  getCursorRulesPath(spec: AnyContractSpec): string;
-  /**
-   * Parse Cursor output to extract generated code.
-   */
-  parseOutput(output: string): {
-    code?: string;
-    errors?: string[];
-  };
-}
-/** Singleton instance */
-declare const cursorCLIAdapter: CursorCLIAdapter;
-//#endregion
-export { CursorCLIAdapter, cursorCLIAdapter };