@wairon/cli 5.1.1-dev.70 → 5.1.1-dev.71

package/dist/index.js

@@ -3542,6 +3542,7 @@ __export(src_exports, {
   deleteComponentSpec: () => deleteComponentSpec,
   deleteImplementationSpec: () => deleteImplementationSpec,
   deleteInterfaceSpec: () => deleteInterfaceSpec,
+  deleteSpec: () => deleteSpec,
   deleteSubsystemSpec: () => deleteSubsystemSpec,
   deleteTypeSpec: () => deleteTypeSpec,
   deregisterPackRef: () => deregisterPackRef,
@@ -3612,6 +3613,7 @@ __export(src_exports, {
   loadProjectConfig: () => loadProjectConfig4,
   loadProjectExtensions: () => loadProjectExtensions,
   loadRegistry: () => loadRegistry,
+  loadSpec: () => loadSpec,
   loadSpecGraph: () => loadSpecGraph,
   loadSubsystemSpec: () => loadSubsystemSpec,
   loadSubsystemSpecs: () => loadSubsystemSpecs,
@@ -3673,6 +3675,7 @@ __export(src_exports, {
   saveComponentSpec: () => saveComponentSpec,
   saveImplementationSpec: () => saveImplementationSpec,
   saveInterfaceSpec: () => saveInterfaceSpec,
+  saveSpec: () => saveSpec,
   saveSubsystemSpec: () => saveSubsystemSpec,
   saveSystemSpec: () => saveSystemSpec,
   saveTopologyConfig: () => saveTopologyConfig,
@@ -11593,7 +11596,7 @@ function defaultTargetConfig(type) {
     enabled: true
   };
 }
-var WAIRON_VERSION = "5.1.1-dev.70";
+var WAIRON_VERSION = "5.1.1-dev.71";
 var GITHUB_REPO = "SYW-Apps/Waffle-AIron";
 var ARCHITECT_AGENT_ID = "agent-architect";
 var ARCHITECT_TEMPLATE_ID = "architect";
@@ -21663,6 +21666,8 @@ function identityKeyOf(field, item) {
   const o = item;
   const str = (v) => typeof v === "string" && v.length > 0 ? v : null;
   switch (field) {
+    case "publicInterfaces":
+      return publicInterfaceKey(o);
     case "dispatch":
       return str(o.capability);
     // A listener mounts each portal once, so the portal IS the mount's identity.
@@ -21708,6 +21713,13 @@ function identityKeyOf(field, item) {
       return str(o.name) ?? str(o.id);
   }
 }
+function publicInterfaceKey(o) {
+  const str = (v) => typeof v === "string" && v.length > 0 ? v : null;
+  const component = str(o.component);
+  if (component) return str(o.interface) ? `${component}.${String(o.interface)}` : component;
+  if (typeof o.type === "string" && typeof o.details === "string") return `${o.type} ${o.details}`;
+  return null;
+}
 function reportIdentityOf(field, item) {
   if (item !== null && typeof item === "object") {
     const step = item.stepNumber;
@@ -21769,6 +21781,9 @@ function identityFieldsOf(field) {
   switch (field) {
     case "dispatch":
       return ["capability"];
+    // Bound: component + interface; not yet bound: type + details.
+    case "publicInterfaces":
+      return ["component", "interface", "type", "details"];
     case "lifecycle":
       return ["phase", "component", "method"];
     case "emits":
@@ -22934,6 +22949,76 @@ var SpecWorkspace = class {
     return true;
   }
   // -------------------------------------------------------------------------
+  // Kind-generic access (spec_index.load, spec_registry.save / delete)
+  //
+  // The one place a kind held as DATA becomes the typed loader, writer or
+  // delete of that kind. Every caller that holds the kind as a value — the
+  // gated whole-spec write, a delete by kind, the delta update, the method
+  // move — used to repeat this switch, and each copy could drift from the
+  // others (one of them forgot that a type's writer takes no status).
+  // -------------------------------------------------------------------------
+  /** One stored spec of the named kind, or null. The L0 is a singleton: its id is informational. */
+  load(kind, id) {
+    switch (kind) {
+      case "system":
+        return this.loadSystemSpec();
+      case "subsystem":
+        return this.loadSubsystemSpec(id);
+      case "component":
+        return this.loadComponentSpec(id);
+      case "interface":
+        return this.loadInterfaceSpec(id);
+      case "implementation":
+        return this.loadImplementationSpec(id);
+      case "type":
+        return this.loadTypeSpec(id);
+    }
+  }
+  /**
+   * Persist one spec through the typed writer of its kind, answering with that
+   * writer's placement notices (none for the L0 and a subsystem). A draft or
+   * status-less save keeps the stored status, exactly as the typed writers do.
+   */
+  save(kind, spec) {
+    return this.saveOfKind(kind, spec);
+  }
+  /** The typed writer of a kind, with the caller's save options — the delta update and the move state a demotion. */
+  saveOfKind(kind, spec, opts) {
+    switch (kind) {
+      case "system":
+        this.saveSystemSpec(spec);
+        return [];
+      case "subsystem":
+        this.saveSubsystemSpec(spec, opts);
+        return [];
+      case "component":
+        return this.saveComponentSpec(spec, opts);
+      case "interface":
+        return this.saveInterfaceSpec(spec, opts);
+      case "implementation":
+        return this.saveImplementationSpec(spec, opts);
+      case "type":
+        return this.saveTypeSpec(spec, opts);
+    }
+  }
+  /** Delete one spec document of the named kind; false when none was stored. The L0 cannot be deleted. */
+  delete(kind, id) {
+    switch (kind) {
+      case "system":
+        throw new Error("The L0 system spec cannot be deleted: it is the root every other spec hangs from.");
+      case "subsystem":
+        return this.deleteSubsystemSpec(id);
+      case "component":
+        return this.deleteComponentSpec(id);
+      case "interface":
+        return this.deleteInterfaceSpec(id);
+      case "implementation":
+        return this.deleteImplementationSpec(id);
+      case "type":
+        return this.deleteTypeSpec(id);
+    }
+  }
+  // -------------------------------------------------------------------------
   // Spec status promotion (draft/design → complete)
   // -------------------------------------------------------------------------
   /** Every spec whose status is not yet 'complete', with its current status captured. */
@@ -23154,23 +23239,7 @@ var SpecWorkspace = class {
    */
   updateSpec(kind, id, delta, hooks, dryRun = false) {
     const notices = [];
-    const result = (() => {
-      switch (kind) {
-        case "system":
-          return this.loadSystemSpec();
-        // singleton — id is informational
-        case "subsystem":
-          return this.loadSubsystemSpec(id);
-        case "component":
-          return this.loadComponentSpec(id);
-        case "interface":
-          return this.loadInterfaceSpec(id);
-        case "implementation":
-          return this.loadImplementationSpec(id);
-        case "type":
-          return this.loadTypeSpec(id);
-      }
-    })();
+    const result = this.load(kind, id);
     if (!result) {
       throw new Error(`Spec of kind "${kind}" with ID "${id}" does not exist. Define it first.`);
     }
@@ -23502,9 +23571,10 @@ var SpecWorkspace = class {
     const mergePublicInterfaces = (existing, delta2) => {
       const merged = [...existing];
       for (const deltaItem of delta2) {
-        const piKey = (i) => `${i?.component}.${i?.interface}`;
+        const piKey = (i) => String(identityKeyOf("publicInterfaces", i));
         assertDeltaMarkers(deltaItem, `publicInterface "${piKey(deltaItem)}"`);
-        const idx = merged.findIndex((item) => item.component === deltaItem.component && item.interface === deltaItem.interface);
+        const key = identityKeyOf("publicInterfaces", deltaItem);
+        const idx = key === null ? -1 : merged.findIndex((item) => identityKeyOf("publicInterfaces", item) === key);
         if (idx !== -1) {
           if (deltaItem.remove === true || deltaItem.action === "delete") {
             merged.splice(idx, 1);
@@ -23693,26 +23763,7 @@ var SpecWorkspace = class {
     const opts = {
       allowStatusDemotion: Object.prototype.hasOwnProperty.call(delta, "status")
     };
-    switch (kind) {
-      case "system":
-        this.saveSystemSpec(mergedResult);
-        break;
-      case "subsystem":
-        this.saveSubsystemSpec(mergedResult, opts);
-        break;
-      case "component":
-        notices.push(...this.saveComponentSpec(mergedResult, opts));
-        break;
-      case "interface":
-        notices.push(...this.saveInterfaceSpec(mergedResult, opts));
-        break;
-      case "implementation":
-        notices.push(...this.saveImplementationSpec(mergedResult, opts));
-        break;
-      case "type":
-        notices.push(...this.saveTypeSpec(mergedResult));
-        break;
-    }
+    notices.push(...this.saveOfKind(kind, mergedResult, opts));
     return {
       kind,
       id,
@@ -24073,23 +24124,7 @@ var SpecWorkspace = class {
   }
   /** Persist one moved spec through the store's own writer, and answer with its placement notices. */
   saveMovedSpec(kind, spec) {
-    const opts = { allowStatusDemotion: true };
-    switch (kind) {
-      case "system":
-        this.saveSystemSpec(spec);
-        return [];
-      case "subsystem":
-        this.saveSubsystemSpec(spec, opts);
-        return [];
-      case "component":
-        return this.saveComponentSpec(spec, opts);
-      case "interface":
-        return this.saveInterfaceSpec(spec, opts);
-      case "implementation":
-        return this.saveImplementationSpec(spec, opts);
-      case "type":
-        return this.saveTypeSpec(spec);
-    }
+    return this.saveOfKind(kind, spec, { allowStatusDemotion: true });
   }
 };
 var DEFAULT_DEPENDENCY_LIMIT = 8;
@@ -24371,6 +24406,18 @@ function specPathsInScope(scopeSubsystem) {
 function snapshotSpecFiles() {
   return current().snapshotSpecFiles();
 }
+function loadSpec(kind, id) {
+  const workspace = current();
+  return workspace.load(kind, id);
+}
+function saveSpec(kind, spec) {
+  const workspace = current();
+  return workspace.save(kind, spec);
+}
+function deleteSpec(kind, id) {
+  const workspace = current();
+  return workspace.delete(kind, id);
+}
 function updateSpec(kind, id, delta, hooks, dryRun) {
   return current().updateSpec(kind, id, delta, hooks, dryRun);
 }
@@ -27075,6 +27122,7 @@ function loadProjectConfig4() {
   deleteComponentSpec,
   deleteImplementationSpec,
   deleteInterfaceSpec,
+  deleteSpec,
   deleteSubsystemSpec,
   deleteTypeSpec,
   deregisterPackRef,
@@ -27145,6 +27193,7 @@ function loadProjectConfig4() {
   loadProjectConfig,
   loadProjectExtensions,
   loadRegistry,
+  loadSpec,
   loadSpecGraph,
   loadSubsystemSpec,
   loadSubsystemSpecs,
@@ -27206,6 +27255,7 @@ function loadProjectConfig4() {
   saveComponentSpec,
   saveImplementationSpec,
   saveInterfaceSpec,
+  saveSpec,
   saveSubsystemSpec,
   saveSystemSpec,
   saveTopologyConfig,