@contractspec/bundle.workspace 3.0.0 → 3.1.1

package/dist/contracts/operations/init.operation.d.ts

@@ -3,8 +3,8 @@ export declare const initOperation: import("@contractspec/lib.contracts-spec").O
     yes: z.ZodDefault<z.ZodBoolean>;
     targets: z.ZodOptional<z.ZodArray<z.ZodEnum<{
         cursor: "cursor";
-        cli: "cli";
         mcp: "mcp";
+        cli: "cli";
         vscode: "vscode";
         agents: "agents";
         github: "github";

package/dist/index.js

@@ -16334,6 +16334,177 @@ function generateCliReport(ir, verification) {
   return lines.join(`
 `);
 }
+// src/services/update.ts
+import {
+  scanSpecSource as scanSpecSource4
+} from "@contractspec/module.workspace";
+function unknownSpecResult(filePath) {
+  return {
+    specType: "unknown",
+    filePath,
+    hasMeta: false,
+    hasIo: false,
+    hasPolicy: false,
+    hasPayload: false,
+    hasContent: false,
+    hasDefinition: false
+  };
+}
+async function updateSpec(specPath, adapters2, options = {}) {
+  const { fs: fs5, logger: logger3 } = adapters2;
+  const exists = await fs5.exists(specPath);
+  if (!exists) {
+    return {
+      specPath,
+      specInfo: unknownSpecResult(specPath),
+      updated: false,
+      errors: [`Spec file not found: ${specPath}`],
+      warnings: []
+    };
+  }
+  const originalCode = await fs5.readFile(specPath);
+  let updatedCode;
+  if (options.content !== undefined) {
+    updatedCode = options.content;
+  } else if (options.fields?.length) {
+    updatedCode = applyFieldPatches(originalCode, options.fields);
+  } else {
+    return {
+      specPath,
+      specInfo: scanSpecSource4(originalCode, specPath),
+      updated: false,
+      errors: ["No update provided: supply `content` or `fields`"],
+      warnings: []
+    };
+  }
+  if (!options.skipValidation) {
+    await fs5.writeFile(specPath, updatedCode);
+    const validation3 = await validateSpec(specPath, adapters2);
+    if (validation3.errors.length > 0) {
+      await fs5.writeFile(specPath, originalCode);
+      return {
+        specPath,
+        specInfo: scanSpecSource4(updatedCode, specPath),
+        updated: false,
+        errors: validation3.errors,
+        warnings: validation3.warnings
+      };
+    }
+    if (validation3.warnings.length > 0 && !options.allowWarnings) {
+      await fs5.writeFile(specPath, originalCode);
+      return {
+        specPath,
+        specInfo: scanSpecSource4(updatedCode, specPath),
+        updated: false,
+        errors: [
+          "Validation produced warnings (use allowWarnings to override)"
+        ],
+        warnings: validation3.warnings
+      };
+    }
+    logger3.info(`Updated spec: ${specPath}`);
+    return {
+      specPath,
+      specInfo: scanSpecSource4(updatedCode, specPath),
+      updated: true,
+      errors: [],
+      warnings: validation3.warnings
+    };
+  }
+  await fs5.writeFile(specPath, updatedCode);
+  logger3.info(`Updated spec (validation skipped): ${specPath}`);
+  return {
+    specPath,
+    specInfo: scanSpecSource4(updatedCode, specPath),
+    updated: true,
+    errors: [],
+    warnings: []
+  };
+}
+function applyFieldPatches(code, fields) {
+  let result = code;
+  for (const { key, value } of fields) {
+    const fieldName = key.includes(".") ? key.split(".").pop() : key;
+    if (!fieldName)
+      continue;
+    const pattern = new RegExp(`(${escapeRegex2(fieldName)}\\s*:\\s*)(['"\`])([^'"\`]*?)\\2`, "g");
+    const needsQuotes = !/^(true|false|\d+(\.\d+)?)$/.test(value);
+    const replacement = needsQuotes ? `$1"${value}"` : `$1${value}`;
+    result = result.replace(pattern, replacement);
+  }
+  return result;
+}
+function escapeRegex2(str) {
+  return str.replace(/[.*+?^${}()|[\]\\]/g, "\\$&");
+}
+// src/services/delete.ts
+import {
+  scanSpecSource as scanSpecSource5
+} from "@contractspec/module.workspace";
+function unknownSpecResult2(filePath) {
+  return {
+    specType: "unknown",
+    filePath,
+    hasMeta: false,
+    hasIo: false,
+    hasPolicy: false,
+    hasPayload: false,
+    hasContent: false,
+    hasDefinition: false
+  };
+}
+async function deleteSpec(specPath, adapters2, options = {}) {
+  const { fs: fs5, logger: logger3 } = adapters2;
+  const exists = await fs5.exists(specPath);
+  if (!exists && !options.force) {
+    return {
+      specPath,
+      specInfo: unknownSpecResult2(specPath),
+      deleted: false,
+      cleanedFiles: [],
+      errors: [`Spec file not found: ${specPath}`]
+    };
+  }
+  let specInfo = unknownSpecResult2(specPath);
+  let specKey2;
+  if (exists) {
+    try {
+      const code = await fs5.readFile(specPath);
+      specInfo = scanSpecSource5(code, specPath);
+      specKey2 = specInfo.key;
+    } catch {}
+  }
+  const cleanedFiles = [];
+  if (options.clean && specKey2) {
+    try {
+      const implementations = await discoverImplementationsForSpec(specKey2, {
+        fs: fs5
+      });
+      for (const impl of implementations) {
+        try {
+          await fs5.remove(impl.filePath);
+          cleanedFiles.push(impl.filePath);
+          logger3.info(`Removed artifact: ${impl.filePath}`);
+        } catch {
+          logger3.warn(`Could not remove artifact: ${impl.filePath}`);
+        }
+      }
+    } catch {
+      logger3.warn("Could not discover implementations for cleanup");
+    }
+  }
+  if (exists) {
+    await fs5.remove(specPath);
+    logger3.info(`Deleted spec: ${specPath}`);
+  }
+  return {
+    specPath,
+    specInfo,
+    deleted: true,
+    cleanedFiles,
+    errors: []
+  };
+}
 // src/registry.ts
 import { OperationSpecRegistry as OperationSpecRegistry3 } from "@contractspec/lib.contracts-spec/operations";
 import { registerReportContracts } from "@contractspec/lib.contracts-spec/operations/report";
@@ -16836,6 +17007,7 @@ export {
   validateAgainstOpenApiService,
   exports_utils as utils,
   exports_upgrade as upgrade,
+  updateSpec,
   toKebabCase3 as toKebabCase,
   exports_templates as templates,
   syncWithOpenApiService,
@@ -16953,6 +17125,7 @@ export {
   determineStatus,
   detectRepositoryType,
   detectPackageManager,
+  deleteSpec,
   deepMergePreserve,
   deepMergeOverwrite,
   cursorCLIAdapter,

package/dist/node/index.js

@@ -16334,6 +16334,177 @@ function generateCliReport(ir, verification) {
   return lines.join(`
 `);
 }
+// src/services/update.ts
+import {
+  scanSpecSource as scanSpecSource4
+} from "@contractspec/module.workspace";
+function unknownSpecResult(filePath) {
+  return {
+    specType: "unknown",
+    filePath,
+    hasMeta: false,
+    hasIo: false,
+    hasPolicy: false,
+    hasPayload: false,
+    hasContent: false,
+    hasDefinition: false
+  };
+}
+async function updateSpec(specPath, adapters2, options = {}) {
+  const { fs: fs5, logger: logger3 } = adapters2;
+  const exists = await fs5.exists(specPath);
+  if (!exists) {
+    return {
+      specPath,
+      specInfo: unknownSpecResult(specPath),
+      updated: false,
+      errors: [`Spec file not found: ${specPath}`],
+      warnings: []
+    };
+  }
+  const originalCode = await fs5.readFile(specPath);
+  let updatedCode;
+  if (options.content !== undefined) {
+    updatedCode = options.content;
+  } else if (options.fields?.length) {
+    updatedCode = applyFieldPatches(originalCode, options.fields);
+  } else {
+    return {
+      specPath,
+      specInfo: scanSpecSource4(originalCode, specPath),
+      updated: false,
+      errors: ["No update provided: supply `content` or `fields`"],
+      warnings: []
+    };
+  }
+  if (!options.skipValidation) {
+    await fs5.writeFile(specPath, updatedCode);
+    const validation3 = await validateSpec(specPath, adapters2);
+    if (validation3.errors.length > 0) {
+      await fs5.writeFile(specPath, originalCode);
+      return {
+        specPath,
+        specInfo: scanSpecSource4(updatedCode, specPath),
+        updated: false,
+        errors: validation3.errors,
+        warnings: validation3.warnings
+      };
+    }
+    if (validation3.warnings.length > 0 && !options.allowWarnings) {
+      await fs5.writeFile(specPath, originalCode);
+      return {
+        specPath,
+        specInfo: scanSpecSource4(updatedCode, specPath),
+        updated: false,
+        errors: [
+          "Validation produced warnings (use allowWarnings to override)"
+        ],
+        warnings: validation3.warnings
+      };
+    }
+    logger3.info(`Updated spec: ${specPath}`);
+    return {
+      specPath,
+      specInfo: scanSpecSource4(updatedCode, specPath),
+      updated: true,
+      errors: [],
+      warnings: validation3.warnings
+    };
+  }
+  await fs5.writeFile(specPath, updatedCode);
+  logger3.info(`Updated spec (validation skipped): ${specPath}`);
+  return {
+    specPath,
+    specInfo: scanSpecSource4(updatedCode, specPath),
+    updated: true,
+    errors: [],
+    warnings: []
+  };
+}
+function applyFieldPatches(code, fields) {
+  let result = code;
+  for (const { key, value } of fields) {
+    const fieldName = key.includes(".") ? key.split(".").pop() : key;
+    if (!fieldName)
+      continue;
+    const pattern = new RegExp(`(${escapeRegex2(fieldName)}\\s*:\\s*)(['"\`])([^'"\`]*?)\\2`, "g");
+    const needsQuotes = !/^(true|false|\d+(\.\d+)?)$/.test(value);
+    const replacement = needsQuotes ? `$1"${value}"` : `$1${value}`;
+    result = result.replace(pattern, replacement);
+  }
+  return result;
+}
+function escapeRegex2(str) {
+  return str.replace(/[.*+?^${}()|[\]\\]/g, "\\$&");
+}
+// src/services/delete.ts
+import {
+  scanSpecSource as scanSpecSource5
+} from "@contractspec/module.workspace";
+function unknownSpecResult2(filePath) {
+  return {
+    specType: "unknown",
+    filePath,
+    hasMeta: false,
+    hasIo: false,
+    hasPolicy: false,
+    hasPayload: false,
+    hasContent: false,
+    hasDefinition: false
+  };
+}
+async function deleteSpec(specPath, adapters2, options = {}) {
+  const { fs: fs5, logger: logger3 } = adapters2;
+  const exists = await fs5.exists(specPath);
+  if (!exists && !options.force) {
+    return {
+      specPath,
+      specInfo: unknownSpecResult2(specPath),
+      deleted: false,
+      cleanedFiles: [],
+      errors: [`Spec file not found: ${specPath}`]
+    };
+  }
+  let specInfo = unknownSpecResult2(specPath);
+  let specKey2;
+  if (exists) {
+    try {
+      const code = await fs5.readFile(specPath);
+      specInfo = scanSpecSource5(code, specPath);
+      specKey2 = specInfo.key;
+    } catch {}
+  }
+  const cleanedFiles = [];
+  if (options.clean && specKey2) {
+    try {
+      const implementations = await discoverImplementationsForSpec(specKey2, {
+        fs: fs5
+      });
+      for (const impl of implementations) {
+        try {
+          await fs5.remove(impl.filePath);
+          cleanedFiles.push(impl.filePath);
+          logger3.info(`Removed artifact: ${impl.filePath}`);
+        } catch {
+          logger3.warn(`Could not remove artifact: ${impl.filePath}`);
+        }
+      }
+    } catch {
+      logger3.warn("Could not discover implementations for cleanup");
+    }
+  }
+  if (exists) {
+    await fs5.remove(specPath);
+    logger3.info(`Deleted spec: ${specPath}`);
+  }
+  return {
+    specPath,
+    specInfo,
+    deleted: true,
+    cleanedFiles,
+    errors: []
+  };
+}
 // src/registry.ts
 import { OperationSpecRegistry as OperationSpecRegistry3 } from "@contractspec/lib.contracts-spec/operations";
 import { registerReportContracts } from "@contractspec/lib.contracts-spec/operations/report";
@@ -16836,6 +17007,7 @@ export {
   validateAgainstOpenApiService,
   exports_utils as utils,
   exports_upgrade as upgrade,
+  updateSpec,
   toKebabCase3 as toKebabCase,
   exports_templates as templates,
   syncWithOpenApiService,
@@ -16953,6 +17125,7 @@ export {
   determineStatus,
   detectRepositoryType,
   detectPackageManager,
+  deleteSpec,
   deepMergePreserve,
   deepMergeOverwrite,
   cursorCLIAdapter,

package/dist/services/delete.d.ts

@@ -0,0 +1,29 @@
+/**
+ * Delete spec service.
+ *
+ * Removes a spec file and optionally cleans up generated artifacts
+ * (handlers, tests, components) that reference it.
+ */
+import { type SpecScanResult } from '@contractspec/module.workspace';
+import type { FsAdapter } from '../ports/fs';
+import type { LoggerAdapter } from '../ports/logger';
+export interface DeleteSpecOptions {
+    /** Also remove generated artifacts that reference this spec. */
+    clean?: boolean;
+    /** Skip the existence check (caller already confirmed). */
+    force?: boolean;
+}
+export interface DeleteSpecResult {
+    specPath: string;
+    specInfo: SpecScanResult;
+    deleted: boolean;
+    cleanedFiles: string[];
+    errors: string[];
+}
+/**
+ * Delete a spec file and optionally its generated artifacts.
+ */
+export declare function deleteSpec(specPath: string, adapters: {
+    fs: FsAdapter;
+    logger: LoggerAdapter;
+}, options?: DeleteSpecOptions): Promise<DeleteSpecResult>;

package/dist/services/index.d.ts

@@ -46,3 +46,5 @@ export * from './generate-artifacts';
 export * from './extract';
 export * as vibe from './vibe/index';
 export * from './import/index';
+export * from './update';
+export * from './delete';

package/dist/services/update.d.ts

@@ -0,0 +1,43 @@
+/**
+ * Update spec service.
+ *
+ * Reads an existing spec file, applies field-level patches or
+ * full-content replacement, re-validates, and writes back.
+ */
+import { type SpecScanResult } from '@contractspec/module.workspace';
+import type { FsAdapter } from '../ports/fs';
+import type { LoggerAdapter } from '../ports/logger';
+/**
+ * A single field patch: dot-path key and the replacement source text.
+ *
+ * Example: `{ key: "meta.stability", value: "stable" }`
+ * replaces the `stability: '...'` value in the `meta` block.
+ */
+export interface SpecFieldPatch {
+    key: string;
+    value: string;
+}
+export interface UpdateSpecOptions {
+    /** Replace spec file content entirely. */
+    content?: string;
+    /** Apply individual field patches (ignored when `content` is set). */
+    fields?: SpecFieldPatch[];
+    /** Skip post-update validation. */
+    skipValidation?: boolean;
+    /** Write even when validation produces warnings. */
+    allowWarnings?: boolean;
+}
+export interface UpdateSpecResult {
+    specPath: string;
+    specInfo: SpecScanResult;
+    updated: boolean;
+    errors: string[];
+    warnings: string[];
+}
+/**
+ * Update an existing spec file.
+ */
+export declare function updateSpec(specPath: string, adapters: {
+    fs: FsAdapter;
+    logger: LoggerAdapter;
+}, options?: UpdateSpecOptions): Promise<UpdateSpecResult>;

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@contractspec/bundle.workspace",
-  "version": "3.0.0",
+  "version": "3.1.1",
   "description": "Workspace utilities for monorepo development",
   "keywords": [
     "contractspec",
@@ -31,17 +31,17 @@
     "typecheck": "tsc --noEmit"
   },
   "dependencies": {
-    "@ai-sdk/anthropic": "3.0.48",
-    "@ai-sdk/openai": "3.0.36",
-    "@contractspec/lib.ai-agent": "3.0.0",
-    "@contractspec/lib.ai-providers": "3.0.0",
-    "@contractspec/lib.contracts-spec": "3.0.0",
-    "@contractspec/lib.contracts-integrations": "3.0.0",
-    "@contractspec/lib.contracts-transformers": "3.0.0",
-    "@contractspec/lib.source-extractors": "2.0.0",
-    "@contractspec/module.workspace": "3.0.0",
-    "@contractspec/lib.utils-typescript": "3.0.0",
-    "ai": "6.0.103",
+    "@ai-sdk/anthropic": "3.0.58",
+    "@ai-sdk/openai": "3.0.41",
+    "@contractspec/lib.ai-agent": "3.1.1",
+    "@contractspec/lib.ai-providers": "3.1.1",
+    "@contractspec/lib.contracts-spec": "3.1.1",
+    "@contractspec/lib.contracts-integrations": "3.1.1",
+    "@contractspec/lib.contracts-transformers": "3.1.1",
+    "@contractspec/lib.source-extractors": "2.1.1",
+    "@contractspec/module.workspace": "3.1.1",
+    "@contractspec/lib.utils-typescript": "3.1.0",
+    "ai": "6.0.116",
     "chalk": "^5.6.2",
     "chokidar": "^5.0.0",
     "glob": "^13.0.6",
@@ -52,12 +52,12 @@
     "zod": "^4.3.5"
   },
   "devDependencies": {
-    "@contractspec/tool.typescript": "3.0.0",
-    "@types/bun": "^1.3.9",
+    "@contractspec/tool.typescript": "3.1.0",
+    "@types/bun": "^1.3.10",
     "@types/micromatch": "^4.0.10",
-    "@types/node": "^25.3.2",
+    "@types/node": "^25.3.5",
     "typescript": "^5.9.3",
-    "@contractspec/tool.bun": "3.0.0"
+    "@contractspec/tool.bun": "3.1.0"
   },
   "exports": {
     ".": {