specshield 3.3.1 → 3.3.3

package/README.md

@@ -55,6 +55,8 @@ OpenAPI diff  +  contract compatibility checks  +  HAR → consumer contract  +
 
 No broker. No Pact DSL. Language-agnostic. Works in 30 seconds. Local mode never uploads your specs.
 
+> 🤖 **Using an AI coding agent?** The [SpecShield MCP server](https://github.com/specshield26/specshield-mcp-server) brings the same `can-i-deploy` deploy gate into Claude, Cursor, and other MCP clients — ask *"is it safe to ship this API change to my consumers?"* right inside your agent. Same job, two entry points: this CLI for CI/CD, the MCP server for agents.
+
 ---
 
 ## The Problem

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "specshield",
-  "version": "3.3.1",
+  "version": "3.3.3",
   "description": "Contract compatibility testing for APIs — catch breaking OpenAPI changes before they reach your consumers, with can-i-deploy deploy gating and GitHub PR checks. (a.k.a. bidirectional contract testing.)",
   "main": "src/cli.js",
   "bin": {

package/src/core/diffEngine.js

@@ -2,7 +2,7 @@
 
 /**
  * Compare two normalized specs and return a flat list of raw diffs.
- * Each diff: { type, path, method, field, oldValue, newValue, description }
+ * Each diff: { type, changeId, path, method, field, oldValue, newValue, description }
  */
 function diffSpecs(base, target) {
   const diffs = [];
@@ -10,9 +10,30 @@ function diffSpecs(base, target) {
   diffEndpoints(base.endpoints || {}, target.endpoints || {}, diffs);
   diffSchemas(base.schemas || {}, target.schemas || {}, diffs);
 
+  // Stamp the canonical, public change ID on every diff so this engine and the
+  // backend emit the SAME id for the same change class. See the shared catalog:
+  // Docs/specshield-change-catalog.md (mirrors backend ChangeType.canonicalId).
+  for (const d of diffs) {
+    d.changeId = changeIdFor(d.type);
+  }
+
   return diffs;
 }
 
+// Only these CLI type names diverge from the canonical kebab; every other type
+// (field-became-required, parameter-became-optional, constraint-tightened,
+// schema-removed, request-type-changed, …) already kebab-cases to its canonical id.
+const CANONICAL_ID = {
+  RESPONSE_REMOVED: 'response-status-removed',
+  RESPONSE_ADDED: 'response-status-added',
+};
+
+/** Canonical public change ID. ENDPOINT_REMOVED -> "endpoint-removed". */
+function changeIdFor(type) {
+  if (!type) return null;
+  return CANONICAL_ID[type] || String(type).toLowerCase().replace(/_/g, '-');
+}
+
 // ─── Endpoints ──────────────────────────────────────────────────────────────
 
 function diffEndpoints(baseEndpoints, targetEndpoints, diffs) {