@contractspec/bundle.workspace 3.2.0 → 3.3.0

package/dist/node/index.js

@@ -9,8 +9,218 @@ var __export = (target, all) => {
       set: (newValue) => all[name] = () => newValue
     });
 };
+var __esm = (fn, res) => () => (fn && (res = fn(fn = 0)), res);
 var __require = /* @__PURE__ */ createRequire(import.meta.url);
 
+// src/services/config.ts
+import {
+  ContractsrcSchema,
+  DEFAULT_CONTRACTSRC as DEFAULT_CONTRACTSRC2
+} from "@contractspec/lib.contracts-spec/workspace-config";
+async function loadWorkspaceConfig(fs5, cwd) {
+  const configPath = fs5.join(cwd ?? ".", ".contractsrc.json");
+  const exists = await fs5.exists(configPath);
+  if (!exists) {
+    return DEFAULT_CONTRACTSRC2;
+  }
+  try {
+    const content = await fs5.readFile(configPath);
+    const parsed = JSON.parse(content);
+    const resolved = ContractsrcSchema.safeParse(parsed);
+    return {
+      ...DEFAULT_CONTRACTSRC2,
+      ...resolved.data,
+      conventions: {
+        ...DEFAULT_CONTRACTSRC2.conventions,
+        ...resolved.data?.conventions || {}
+      }
+    };
+  } catch {
+    return DEFAULT_CONTRACTSRC2;
+  }
+}
+function getApiKey(provider) {
+  switch (provider) {
+    case "claude":
+      return process.env["ANTHROPIC_API_KEY"];
+    case "openai":
+      return process.env["OPENAI_API_KEY"];
+    case "custom":
+      return process.env["CONTRACTSPEC_LLM_API_KEY"];
+    case "ollama":
+      return;
+    default:
+      return;
+  }
+}
+var init_config = () => {};
+
+// src/services/create/ai-generator.ts
+var exports_ai_generator = {};
+__export(exports_ai_generator, {
+  AIGenerator: () => AIGenerator
+});
+import { generateObject as generateObject2, generateText as generateText6, streamText as streamText2 } from "ai";
+import * as z2 from "zod";
+import {
+  createProvider
+} from "@contractspec/lib.ai-providers";
+import {
+  buildComponentPrompt as buildComponentPrompt2,
+  buildEventSpecPrompt,
+  buildFormPrompt as buildFormPrompt2,
+  buildHandlerPrompt as buildHandlerPrompt2,
+  buildOperationSpecPrompt,
+  buildPresentationSpecPrompt,
+  buildTestPrompt as buildTestPrompt2,
+  getCodeGenSystemPrompt as getCodeGenSystemPrompt2,
+  getSystemPrompt
+} from "@contractspec/module.workspace";
+
+class AIGenerator {
+  config;
+  constructor(config) {
+    this.config = config;
+  }
+  getModel() {
+    const providerName = this.config.aiProvider;
+    const apiKey = this.config.customApiKey || getApiKey(this.config.aiProvider);
+    const providerConfig = {
+      provider: providerName === "custom" ? "openai" : providerName,
+      model: this.config.aiModel,
+      apiKey,
+      baseUrl: this.config.customEndpoint || undefined
+    };
+    const provider = createProvider(providerConfig);
+    return provider.getModel();
+  }
+  async generateOperationSpec(description, kind) {
+    const model = this.getModel();
+    const schema = z2.object({
+      name: z2.string().describe('Dot notation name like "domain.operation"'),
+      version: z2.number().int().positive().default(1),
+      description: z2.string().describe("Clear, concise summary"),
+      goal: z2.string().describe("Business purpose"),
+      context: z2.string().describe("Background and constraints"),
+      stability: z2.enum(["experimental", "beta", "stable", "deprecated"]).default("beta"),
+      owners: z2.array(z2.string()).describe("Team/person owners with @ prefix"),
+      tags: z2.array(z2.string()).describe("Categorization tags"),
+      auth: z2.enum(["anonymous", "user", "admin"]).describe("Required auth level"),
+      inputShape: z2.string().describe("Description of input structure"),
+      outputShape: z2.string().describe("Description of output structure"),
+      flags: z2.array(z2.string()).describe("Feature flags").default([]),
+      possibleEvents: z2.array(z2.string()).describe("Events this may emit").default([]),
+      analytics: z2.array(z2.string()).describe("Analytics events to track").default([])
+    });
+    const prompt = buildOperationSpecPrompt(description, kind);
+    const result = await generateObject2({
+      model,
+      schema,
+      prompt,
+      system: getSystemPrompt()
+    });
+    return result.object;
+  }
+  async generateEventSpec(description) {
+    const model = this.getModel();
+    const schema = z2.object({
+      name: z2.string().describe('Dot notation name like "domain.event_name"'),
+      version: z2.number().int().positive().default(1),
+      description: z2.string().describe("When this event is emitted"),
+      stability: z2.enum(["experimental", "beta", "stable", "deprecated"]).default("beta"),
+      owners: z2.array(z2.string()).default([]),
+      tags: z2.array(z2.string()).default([]),
+      payloadShape: z2.string().describe("Description of event payload"),
+      piiFields: z2.array(z2.string()).describe("PII field paths").default([])
+    });
+    const prompt = buildEventSpecPrompt(description);
+    const result = await generateObject2({
+      model,
+      schema,
+      prompt,
+      system: getSystemPrompt()
+    });
+    return result.object;
+  }
+  async generatePresentationSpec(description, kind) {
+    const model = this.getModel();
+    const schema = z2.object({
+      name: z2.string(),
+      version: z2.number().int().positive().default(1),
+      description: z2.string(),
+      stability: z2.enum(["experimental", "beta", "stable", "deprecated"]).default("beta"),
+      owners: z2.array(z2.string()).default([]),
+      tags: z2.array(z2.string()).default([]),
+      componentKey: z2.string().optional(),
+      propsShape: z2.string().optional(),
+      content: z2.string().optional(),
+      mimeType: z2.string().optional(),
+      dataShape: z2.string().optional()
+    });
+    const prompt = buildPresentationSpecPrompt(description, kind);
+    const result = await generateObject2({
+      model,
+      schema,
+      prompt,
+      system: getSystemPrompt()
+    });
+    return result.object;
+  }
+  async generateHandler(specCode) {
+    const model = this.getModel();
+    const result = await generateText6({
+      model,
+      prompt: buildHandlerPrompt2(specCode),
+      system: getCodeGenSystemPrompt2()
+    });
+    return result.text;
+  }
+  async generateComponent(specCode) {
+    const model = this.getModel();
+    const result = await generateText6({
+      model,
+      prompt: buildComponentPrompt2(specCode),
+      system: getCodeGenSystemPrompt2()
+    });
+    return result.text;
+  }
+  async generateForm(specCode) {
+    const model = this.getModel();
+    const result = await generateText6({
+      model,
+      prompt: buildFormPrompt2(specCode),
+      system: getCodeGenSystemPrompt2()
+    });
+    return result.text;
+  }
+  async generateTests(specCode, implementationCode, testType) {
+    const model = this.getModel();
+    const result = await generateText6({
+      model,
+      prompt: buildTestPrompt2(specCode, implementationCode, testType),
+      system: getCodeGenSystemPrompt2()
+    });
+    return result.text;
+  }
+  async streamCodeGeneration(prompt, onChunk) {
+    const model = this.getModel();
+    const result = await streamText2({
+      model,
+      prompt,
+      system: getCodeGenSystemPrompt2()
+    });
+    let fullText = "";
+    for await (const chunk of result.textStream) {
+      fullText += chunk;
+      onChunk(chunk);
+    }
+    return fullText;
+  }
+}
+var init_ai_generator = __esm(() => {
+  init_config();
+});
+
 // src/index.ts
 import * as module from "@contractspec/module.workspace";
 // src/adapters/fs.node.ts
@@ -2900,47 +3110,10 @@ function getGraphStats(graph) {
     unused: unused.length
   };
 }
-// src/services/config.ts
-import {
-  ContractsrcSchema,
-  DEFAULT_CONTRACTSRC as DEFAULT_CONTRACTSRC2
-} from "@contractspec/lib.contracts-spec/workspace-config";
-async function loadWorkspaceConfig(fs5, cwd) {
-  const configPath = fs5.join(cwd ?? ".", ".contractsrc.json");
-  const exists = await fs5.exists(configPath);
-  if (!exists) {
-    return DEFAULT_CONTRACTSRC2;
-  }
-  try {
-    const content = await fs5.readFile(configPath);
-    const parsed = JSON.parse(content);
-    const resolved = ContractsrcSchema.safeParse(parsed);
-    return {
-      ...DEFAULT_CONTRACTSRC2,
-      ...resolved.data,
-      conventions: {
-        ...DEFAULT_CONTRACTSRC2.conventions,
-        ...resolved.data?.conventions || {}
-      }
-    };
-  } catch {
-    return DEFAULT_CONTRACTSRC2;
-  }
-}
-function getApiKey(provider) {
-  switch (provider) {
-    case "claude":
-      return process.env["ANTHROPIC_API_KEY"];
-    case "openai":
-      return process.env["OPENAI_API_KEY"];
-    case "custom":
-      return process.env["CONTRACTSPEC_LLM_API_KEY"];
-    case "ollama":
-      return;
-    default:
-      return;
-  }
-}
+
+// src/services/index.ts
+init_config();
+
 // src/services/build.ts
 import {
   generateComponentTemplate,
@@ -7473,6 +7646,7 @@ async function runDoctorChecks(adapters, options) {
   return issues;
 }
 // src/services/ci-check/checks/handlers.ts
+init_config();
 async function runHandlerChecks(adapters, specFiles) {
   const { fs: fs5 } = adapters;
   const issues = [];
@@ -7506,6 +7680,7 @@ async function runHandlerChecks(adapters, specFiles) {
   return issues;
 }
 // src/services/ci-check/checks/tests.ts
+init_config();
 async function runTestChecks(adapters, specFiles) {
   const { fs: fs5 } = adapters;
   const issues = [];
@@ -7834,6 +8009,9 @@ async function runCoverageChecks(adapters, specFiles, options) {
   }
   return issues;
 }
+// src/services/ci-check/checks/implementation.ts
+init_config();
+
 // src/services/implementation/resolver/index.ts
 import { createHash } from "crypto";
 
@@ -8392,6 +8570,9 @@ async function runLayerChecks2(adapters, _options) {
   }
   return issues;
 }
+// src/services/ci-check/checks/drift.ts
+init_config();
+
 // src/services/drift.ts
 import path4 from "path";
 import { mkdtemp, rm as rm3 } from "node:fs/promises";
@@ -9709,163 +9890,8 @@ function exportSpecForLLM(spec, format, agent = "generic-mcp") {
       return specToMarkdown(spec, "full");
   }
 }
-// src/services/create/ai-generator.ts
-import { generateObject as generateObject2, generateText as generateText6, streamText as streamText2 } from "ai";
-import * as z2 from "zod";
-import {
-  createProvider
-} from "@contractspec/lib.ai-providers";
-import {
-  buildComponentPrompt as buildComponentPrompt2,
-  buildEventSpecPrompt,
-  buildFormPrompt as buildFormPrompt2,
-  buildHandlerPrompt as buildHandlerPrompt2,
-  buildOperationSpecPrompt,
-  buildPresentationSpecPrompt,
-  buildTestPrompt as buildTestPrompt2,
-  getCodeGenSystemPrompt as getCodeGenSystemPrompt2,
-  getSystemPrompt
-} from "@contractspec/module.workspace";
-class AIGenerator {
-  config;
-  constructor(config) {
-    this.config = config;
-  }
-  getModel() {
-    const providerName = this.config.aiProvider;
-    const apiKey = this.config.customApiKey || getApiKey(this.config.aiProvider);
-    const providerConfig = {
-      provider: providerName === "custom" ? "openai" : providerName,
-      model: this.config.aiModel,
-      apiKey,
-      baseUrl: this.config.customEndpoint || undefined
-    };
-    const provider = createProvider(providerConfig);
-    return provider.getModel();
-  }
-  async generateOperationSpec(description, kind) {
-    const model = this.getModel();
-    const schema = z2.object({
-      name: z2.string().describe('Dot notation name like "domain.operation"'),
-      version: z2.number().int().positive().default(1),
-      description: z2.string().describe("Clear, concise summary"),
-      goal: z2.string().describe("Business purpose"),
-      context: z2.string().describe("Background and constraints"),
-      stability: z2.enum(["experimental", "beta", "stable", "deprecated"]).default("beta"),
-      owners: z2.array(z2.string()).describe("Team/person owners with @ prefix"),
-      tags: z2.array(z2.string()).describe("Categorization tags"),
-      auth: z2.enum(["anonymous", "user", "admin"]).describe("Required auth level"),
-      inputShape: z2.string().describe("Description of input structure"),
-      outputShape: z2.string().describe("Description of output structure"),
-      flags: z2.array(z2.string()).describe("Feature flags").default([]),
-      possibleEvents: z2.array(z2.string()).describe("Events this may emit").default([]),
-      analytics: z2.array(z2.string()).describe("Analytics events to track").default([])
-    });
-    const prompt = buildOperationSpecPrompt(description, kind);
-    const result = await generateObject2({
-      model,
-      schema,
-      prompt,
-      system: getSystemPrompt()
-    });
-    return result.object;
-  }
-  async generateEventSpec(description) {
-    const model = this.getModel();
-    const schema = z2.object({
-      name: z2.string().describe('Dot notation name like "domain.event_name"'),
-      version: z2.number().int().positive().default(1),
-      description: z2.string().describe("When this event is emitted"),
-      stability: z2.enum(["experimental", "beta", "stable", "deprecated"]).default("beta"),
-      owners: z2.array(z2.string()).default([]),
-      tags: z2.array(z2.string()).default([]),
-      payloadShape: z2.string().describe("Description of event payload"),
-      piiFields: z2.array(z2.string()).describe("PII field paths").default([])
-    });
-    const prompt = buildEventSpecPrompt(description);
-    const result = await generateObject2({
-      model,
-      schema,
-      prompt,
-      system: getSystemPrompt()
-    });
-    return result.object;
-  }
-  async generatePresentationSpec(description, kind) {
-    const model = this.getModel();
-    const schema = z2.object({
-      name: z2.string(),
-      version: z2.number().int().positive().default(1),
-      description: z2.string(),
-      stability: z2.enum(["experimental", "beta", "stable", "deprecated"]).default("beta"),
-      owners: z2.array(z2.string()).default([]),
-      tags: z2.array(z2.string()).default([]),
-      componentKey: z2.string().optional(),
-      propsShape: z2.string().optional(),
-      content: z2.string().optional(),
-      mimeType: z2.string().optional(),
-      dataShape: z2.string().optional()
-    });
-    const prompt = buildPresentationSpecPrompt(description, kind);
-    const result = await generateObject2({
-      model,
-      schema,
-      prompt,
-      system: getSystemPrompt()
-    });
-    return result.object;
-  }
-  async generateHandler(specCode) {
-    const model = this.getModel();
-    const result = await generateText6({
-      model,
-      prompt: buildHandlerPrompt2(specCode),
-      system: getCodeGenSystemPrompt2()
-    });
-    return result.text;
-  }
-  async generateComponent(specCode) {
-    const model = this.getModel();
-    const result = await generateText6({
-      model,
-      prompt: buildComponentPrompt2(specCode),
-      system: getCodeGenSystemPrompt2()
-    });
-    return result.text;
-  }
-  async generateForm(specCode) {
-    const model = this.getModel();
-    const result = await generateText6({
-      model,
-      prompt: buildFormPrompt2(specCode),
-      system: getCodeGenSystemPrompt2()
-    });
-    return result.text;
-  }
-  async generateTests(specCode, implementationCode, testType) {
-    const model = this.getModel();
-    const result = await generateText6({
-      model,
-      prompt: buildTestPrompt2(specCode, implementationCode, testType),
-      system: getCodeGenSystemPrompt2()
-    });
-    return result.text;
-  }
-  async streamCodeGeneration(prompt, onChunk) {
-    const model = this.getModel();
-    const result = await streamText2({
-      model,
-      prompt,
-      system: getCodeGenSystemPrompt2()
-    });
-    let fullText = "";
-    for await (const chunk of result.textStream) {
-      fullText += chunk;
-      onChunk(chunk);
-    }
-    return fullText;
-  }
-}
+// src/services/create/index.ts
+init_ai_generator();
 
 // src/services/create/templates.ts
 var exports_templates2 = {};
@@ -11171,6 +11197,8 @@ ${formatRefs(params.experiments) || "    // Add experiments here"}
 `;
 }
 // src/services/create/index.ts
+init_ai_generator();
+
 class SpecCreatorService {
   ai;
   templates = exports_templates2;
@@ -13109,6 +13137,7 @@ import {
 } from "@contractspec/lib.contracts-spec";
 
 // src/services/versioning/changelog-formatter.ts
+import { dirname as dirname10, basename as basename5 } from "node:path";
 function formatKeepAChangelog(entries) {
   const lines = [
     "# Changelog",
@@ -13231,9 +13260,55 @@ function formatChangelogJson(analysis, baseline) {
         }
       ]
     })),
-    libraries: []
+    libraries: groupSpecsByLibrary(specsNeedingBump, isoDate)
   };
 }
+function extractLibraryPath(specPath) {
+  const parts = specPath.split("/");
+  const packagesIdx = parts.lastIndexOf("packages");
+  if (packagesIdx >= 0 && packagesIdx + 2 < parts.length) {
+    return parts.slice(0, packagesIdx + 3).join("/");
+  }
+  return dirname10(specPath);
+}
+var BUMP_RANK = { major: 3, minor: 2, patch: 1 };
+function groupSpecsByLibrary(specs, isoDate) {
+  const groups = new Map;
+  for (const spec of specs) {
+    const libPath = extractLibraryPath(spec.specPath);
+    const existing = groups.get(libPath);
+    if (existing) {
+      existing.push(spec);
+    } else {
+      groups.set(libPath, [spec]);
+    }
+  }
+  return Array.from(groups.entries()).flatMap(([libPath, libSpecs]) => {
+    const first = libSpecs[0];
+    if (!first)
+      return [];
+    const highestBump = libSpecs.reduce((max, s) => {
+      const rank = BUMP_RANK[s.bumpType] ?? 0;
+      return rank > (BUMP_RANK[max.bumpType] ?? 0) ? s : max;
+    }, first);
+    return [
+      {
+        name: basename5(libPath),
+        path: libPath,
+        version: highestBump.suggestedVersion,
+        entries: [
+          {
+            version: highestBump.suggestedVersion,
+            date: isoDate,
+            bumpType: highestBump.bumpType,
+            changes: libSpecs.flatMap((s) => s.changes),
+            breakingChanges: libSpecs.flatMap((s) => s.changes).filter((c) => c.type === "breaking")
+          }
+        ]
+      }
+    ];
+  });
+}
 function compareVersionsDescending(a, b) {
   const parseVer = (v) => {
     const parts = v.split(".").map((p) => parseInt(p, 10) || 0);
@@ -14838,11 +14913,50 @@ async function implementAiStrategy(issue, options, adapters2) {
     };
   }
 }
-async function enrichWithAI(ctx, _options, logger3) {
+async function enrichWithAI(ctx, options, logger3) {
   logger3.info("Generating AI content for spec", {
     key: ctx.key,
     type: ctx.specType
   });
+  if (options.aiConfig) {
+    try {
+      const { AIGenerator: AIGenerator2 } = await Promise.resolve().then(() => (init_ai_generator(), exports_ai_generator));
+      const config = buildResolvedConfig(options);
+      const generator = new AIGenerator2(config);
+      const kind = ctx.specType === "operation" ? "command" : ctx.specType;
+      const description = `${capitalize2(ctx.specType)} for ${ctx.key}`;
+      if (ctx.specType === "operation") {
+        const result = await generator.generateOperationSpec(description, kind);
+        return {
+          ...ctx,
+          description: result.description,
+          enrichment: {
+            goal: result.goal,
+            context: result.context,
+            owners: result.owners,
+            tags: result.tags
+          }
+        };
+      }
+      if (ctx.specType === "event") {
+        const result = await generator.generateEventSpec(description);
+        return {
+          ...ctx,
+          description: result.description,
+          enrichment: {
+            goal: `Emit ${ctx.key} event`,
+            context: result.description,
+            owners: ["@team"],
+            tags: result.tags
+          }
+        };
+      }
+    } catch (aiError) {
+      logger3.warn("AIGenerator call failed, falling back to heuristics", {
+        error: aiError instanceof Error ? aiError.message : String(aiError)
+      });
+    }
+  }
   const enrichment = inferEnrichmentFromKey(ctx.key, ctx.specType);
   return {
     ...ctx,
@@ -14855,6 +14969,21 @@ async function enrichWithAI(ctx, _options, logger3) {
     }
   };
 }
+function buildResolvedConfig(options) {
+  const ai3 = options.aiConfig;
+  const providerMap = {
+    claude: "anthropic",
+    openai: "openai",
+    ollama: "ollama",
+    custom: "custom"
+  };
+  return {
+    aiProvider: providerMap[ai3?.provider ?? "openai"] ?? "openai",
+    aiModel: ai3?.model ?? "gpt-4-turbo",
+    customApiKey: ai3?.apiKey ?? "",
+    customEndpoint: ai3?.endpoint ?? ""
+  };
+}
 function inferEnrichmentFromKey(key, specType) {
   const parts = key.split(".");
   const domain = parts[0] || "unknown";
@@ -15376,6 +15505,7 @@ async function analyzeGap(adapters2, cwd) {
   };
 }
 // src/services/extract.ts
+init_config();
 async function extractContracts(adapters2, options, cwd) {
   const { fs: fs5, logger: logger3 } = adapters2;
   const { source, outputDir } = options;
@@ -15766,7 +15896,7 @@ async function getWorkflow(id, cwd) {
 // src/services/vibe/context.ts
 import { mkdir as mkdir4, readFile as readFile7, writeFile as writeFile3, copyFile } from "node:fs/promises";
 import { existsSync as existsSync6 } from "node:fs";
-import { join as join11, dirname as dirname10 } from "node:path";
+import { join as join11, dirname as dirname11 } from "node:path";
 import { glob } from "glob";
 var DEFAULT_IGNORES2 = [
   "**/node_modules/**",
@@ -15817,7 +15947,7 @@ async function exportContext(cwd) {
   for (const file of uniqueFiles) {
     const absSource = join11(root, file);
     const absDest = join11(contextFilesDir, file);
-    await mkdir4(dirname10(absDest), { recursive: true });
+    await mkdir4(dirname11(absDest), { recursive: true });
     await copyFile(absSource, absDest);
     exportedFiles.push({ path: file, size: 0 });
   }
@@ -15909,7 +16039,7 @@ import {
   generateRegistry,
   generateSchemas
 } from "@contractspec/lib.source-extractors/codegen";
-import { dirname as dirname11, join as join13 } from "path";
+import { dirname as dirname12, join as join13 } from "path";
 async function importFromSourceService(config, options, adapters2, cwd) {
   const { fs: fs5, logger: logger3 } = adapters2;
   const rootPath = cwd ?? process.cwd();
@@ -15972,7 +16102,7 @@ async function importFromSourceService(config, options, adapters2, cwd) {
   if (!options.dryRun) {
     for (const file of allFiles) {
       const fullPath = join13(outputDir, file.path);
-      const dir = dirname11(fullPath);
+      const dir = dirname12(fullPath);
       if (!await fs5.exists(dir)) {
         await fs5.mkdir(dir);
       }
@@ -16697,7 +16827,7 @@ function sarifToJson(sarif) {
 }
 // src/formatters/json.ts
 function formatAsJson(result, options = {}) {
-  const { pretty = true } = options;
+  const { pretty = true, driftResult } = options;
   const checks = result.issues.map((issue) => ({
     name: issue.ruleId,
     status: issue.severity === "error" ? "fail" : issue.severity === "warning" ? "warn" : "pass",
@@ -16713,8 +16843,8 @@ function formatAsJson(result, options = {}) {
     schemaVersion: "1.0",
     checks,
     drift: {
-      status: "none",
-      files: []
+      status: driftResult?.hasDrift ? "detected" : "none",
+      files: driftResult?.files ?? []
     },
     summary: {
       pass: 0,