@elevasis/sdk 1.33.0 → 1.33.1

package/dist/cli.cjs

@@ -23715,7 +23715,6 @@ function emitSystemEntry(opts) {
   const apiInterfaceBlock = opts.apiBacked ? `
     apiInterface: {
       lifecycle: 'active',
-      readinessProfile: 'standard',
       resourceIds: []
     },` : "";
   const code = `  {
@@ -24210,7 +24209,6 @@ function emitApiInterfaceBlock(gap) {
 
 export const ${constName} = {
   lifecycle: 'active' as const,
-  readinessProfile: 'standard' as const,
   resourceIds: ${resourceIdsLiteral}
 }
 `;
@@ -37928,7 +37926,8 @@ var ONTOLOGY_REFERENCE_KEY_KINDS = {
   surfaceType: "surface",
   stepCatalog: "catalog"
 };
-function buildOmCrossRefIndex(model) {
+var omCompilationContextCache = /* @__PURE__ */ new WeakMap();
+function buildOmCrossRefIndexFromOntology(model, ontologyCompilation) {
   const systemsById = /* @__PURE__ */ new Map();
   for (const { path: path3, system } of listAllSystems(model)) {
     systemsById.set(path3, system);
@@ -37942,7 +37941,6 @@ function buildOmCrossRefIndex(model) {
   const actionIds = new Set(Object.keys(model.actions ?? {}));
   const customerSegmentIds = new Set(Object.keys(model.customers ?? {}));
   const offeringIds = new Set(Object.keys(model.offerings ?? {}));
-  const ontologyCompilation = compileOrganizationOntology(model);
   const ontologyIndexByKind = {
     object: ontologyCompilation.ontology.objectTypes,
     link: ontologyCompilation.ontology.linkTypes,
@@ -37981,6 +37979,15 @@ function buildOmCrossRefIndex(model) {
     stageIds
   };
 }
+function buildOmCompilationContext(model) {
+  const cached2 = omCompilationContextCache.get(model);
+  if (cached2 !== void 0) return cached2;
+  const ontologyCompilation = compileOrganizationOntology(model);
+  const crossRefIndex = buildOmCrossRefIndexFromOntology(model, ontologyCompilation);
+  const context = { crossRefIndex, ontologyCompilation };
+  omCompilationContextCache.set(model, context);
+  return context;
+}
 function knowledgeTargetExists(index, kind, id) {
   if (kind === "system") return index.systemsById.has(id);
   if (kind === "client") return index.clientIds.has(id);
@@ -38632,8 +38639,6 @@ var SystemEntrySchema = external_exports.object({
   path: PathSchema.optional(),
   /** @deprecated Use ui.icon. Kept for one-cycle Feature compatibility. */
   icon: IconNameSchema.optional(),
-  /** @deprecated Feature color token, retained for one-cycle compatibility. */
-  color: ColorTokenSchema.optional(),
   /** @deprecated UI placement hint, retained for one-cycle compatibility. */
   uiPosition: UiPositionSchema.optional(),
   /** @deprecated Use lifecycle. */
@@ -38730,7 +38735,7 @@ var ResourceOntologyBindingSchema = external_exports.object({
   /**
    * Optional typed contract binding for this resource's workflow I/O.
    * Each ref is a `package/subpath#ExportName` string that resolves to a
-   * Zod schema in `@repo/elevasis-core` (or the consumer's equivalent package).
+   * Zod schema in the tenant-owned organization model package.
    *
    * Absence of this field preserves all existing behavior — it is additive + optional.
    * Tier-1 validation (schema.ts): ref-string shape only (browser-safe, no imports).
@@ -39489,9 +39494,8 @@ function refineOrganizationModel(model, ctx) {
       }
     });
   });
-  const idx = buildOmCrossRefIndex(model);
+  const { crossRefIndex: idx, ontologyCompilation } = buildOmCompilationContext(model);
   const { ontologyIndexByKind, ontologyIds } = idx;
-  const ontologyCompilation = compileOrganizationOntology(model);
   function topologyTargetExists(ref) {
     if (ref.kind === "system") return systemsById.has(ref.id);
     if (ref.kind === "resource") return resourcesById.has(ref.id);
@@ -42173,6 +42177,20 @@ function validateDeclaredSystemInterfaceReadiness(orgName, organizationModel) {
   for (const { path: path3, system } of listAllSystems(model)) {
     if (system.apiInterface === void 0) continue;
     const interfaceKey = "api";
+    const resourceIds = system.apiInterface.resourceIds ?? [];
+    if (resourceIds.length === 0) {
+      const readinessProfile = system.apiInterface.readinessProfile;
+      if (readinessProfile !== void 0 && !SYSTEM_INTERFACE_PROFILES.some((profile) => profile.readinessProfile === readinessProfile)) {
+        addSystemInterfaceIssue(issues, orgName, path3, interfaceKey, {
+          family: "SYSTEM_INTERFACE_INVALID",
+          code: "unknown-readiness-profile",
+          path: `systems.${path3}.apiInterface.readinessProfile`,
+          ref: readinessProfile,
+          message: `System Interface "${path3}/${interfaceKey}" references unknown readiness profile "${readinessProfile}".`
+        });
+      }
+      continue;
+    }
     const result = computeInterfaceReadiness(model, { systemPath: path3, interfaceKey });
     for (const issue2 of result.issues) {
       addSystemInterfaceIssue(issues, orgName, path3, interfaceKey, issue2);
@@ -45716,7 +45734,7 @@ function wrapAction(commandName, fn) {
 // package.json
 var package_default = {
   name: "@elevasis/sdk",
-  version: "1.33.0",
+  version: "1.33.1",
   description: "SDK for building Elevasis organization resources",
   type: "module",
   bin: {
@@ -49392,6 +49410,155 @@ ${appliesLines.join("\n")}` : "";
   return join5([header, effectSection, appliesSection]);
 }
 
+// ../core/src/knowledge/cli-helpers.ts
+var OM_SEARCH_HIT_KINDS = ["system", "resource", "knowledge", "ontology", "role", "policy"];
+function parseKnowledgeSearchLimit(raw, commandName = "knowledge:search") {
+  if (raw === void 0) return 10;
+  const n = Number.parseInt(raw, 10);
+  if (Number.isNaN(n) || n < 0) {
+    throw new Error(`${commandName}: --limit must be a non-negative integer (got "${raw}")`);
+  }
+  return n;
+}
+function parseKnowledgeSearchKinds(raw, commandName = "knowledge:search") {
+  if (raw === void 0) return void 0;
+  const requested = raw.split(",").map((s) => s.trim().toLowerCase()).filter((s) => s.length > 0);
+  const valid = [];
+  const invalid = [];
+  for (const kind of requested) {
+    if (OM_SEARCH_HIT_KINDS.includes(kind)) {
+      valid.push(kind);
+    } else {
+      invalid.push(kind);
+    }
+  }
+  if (invalid.length > 0) {
+    throw new Error(`${commandName}: unknown kind(s) "${invalid.join(", ")}". Valid: ${OM_SEARCH_HIT_KINDS.join(", ")}`);
+  }
+  return valid.length > 0 ? valid : void 0;
+}
+function formatKnowledgeSystemsList(entries) {
+  if (entries.length === 0) return "(no results)";
+  const pathWidth = Math.max(...entries.map((e) => e.path.length), 4);
+  const header = `${"PATH".padEnd(pathWidth)}  LABEL`;
+  const divider = "-".repeat(header.length + 20);
+  const rows = entries.map((e) => {
+    const label = e.system.label ?? e.system.title ?? e.path;
+    return `${e.path.padEnd(pathWidth)}  ${label}`;
+  });
+  return [header, divider, ...rows].join("\n");
+}
+function formatKnowledgeResourcesList(resources) {
+  if (resources.length === 0) return "(no results)";
+  const idWidth = Math.max(...resources.map((r) => r.id.length), 4);
+  const kindWidth = Math.max(...resources.map((r) => r.kind.length), 4);
+  const header = `${"ID".padEnd(idWidth)}  ${"KIND".padEnd(kindWidth)}  TITLE`;
+  const divider = "-".repeat(header.length + 20);
+  const rows = resources.map((r) => {
+    const title = r.title ?? r.id;
+    return `${r.id.padEnd(idWidth)}  ${r.kind.padEnd(kindWidth)}  ${title}`;
+  });
+  return [header, divider, ...rows].join("\n");
+}
+function formatKnowledgeRolesList(roles) {
+  if (roles.length === 0) return "(no results)";
+  const idWidth = Math.max(...roles.map((r) => r.id.length), 4);
+  const header = `${"ID".padEnd(idWidth)}  TITLE`;
+  const divider = "-".repeat(header.length + 20);
+  const rows = roles.map((r) => `${r.id.padEnd(idWidth)}  ${r.title}`);
+  return [header, divider, ...rows].join("\n");
+}
+function normalizeKnowledgeNodeId(id) {
+  return id.startsWith("knowledge:") ? id.slice("knowledge:".length) : id;
+}
+function formatKnowledgeInvocationLabel(invocation) {
+  switch (invocation.kind) {
+    case "slash-command":
+      return invocation.command;
+    case "mcp-tool":
+      return `${invocation.server}/${invocation.name}`;
+    case "api-endpoint":
+      return `${invocation.method} ${invocation.path}`;
+    case "script-execution":
+      return invocation.resourceId;
+  }
+}
+function pushActionSource(sources, seen, action) {
+  if (!action || action.invocations.length === 0) return;
+  const key = `action:${action.id}`;
+  if (seen.has(key)) return;
+  seen.add(key);
+  sources.push({
+    kind: "action",
+    id: action.id,
+    label: action.label,
+    targetNodeId: `action:${action.id}`,
+    invocations: action.invocations
+  });
+}
+function pushAgentResourceSource(sources, seen, resource) {
+  if (!resource || resource.kind !== "agent" || resource.invocations.length === 0) return;
+  const agentResource = resource;
+  const key = `agent-resource:${agentResource.id}`;
+  if (seen.has(key)) return;
+  seen.add(key);
+  sources.push({
+    kind: "agent-resource",
+    id: agentResource.id,
+    label: agentResource.id,
+    targetNodeId: `resource:${agentResource.id}`,
+    invocations: agentResource.invocations
+  });
+}
+function resolveKnowledgeInvocationNeighbors(model, id) {
+  const normalizedNodeId = normalizeKnowledgeNodeId(id);
+  const node = model.knowledge[normalizedNodeId];
+  if (!node) return void 0;
+  const sources = [];
+  const seen = /* @__PURE__ */ new Set();
+  for (const link of node.links) {
+    const target = link.target;
+    if (target.kind === "action") {
+      pushActionSource(sources, seen, model.actions[target.id]);
+      continue;
+    }
+    if (target.kind === "resource") {
+      pushAgentResourceSource(sources, seen, model.resources[target.id]);
+      continue;
+    }
+    if (target.kind === "system") {
+      const system = getSystem(model, target.id);
+      for (const actionRef of system?.actions ?? []) {
+        pushActionSource(sources, seen, model.actions[actionRef.actionId]);
+      }
+      for (const resource of Object.values(model.resources)) {
+        if (resource.systemPath === target.id) {
+          pushAgentResourceSource(sources, seen, resource);
+        }
+      }
+    }
+  }
+  return {
+    id: node.id,
+    title: node.title,
+    invocationSources: sources.sort((a, b) => a.targetNodeId.localeCompare(b.targetNodeId))
+  };
+}
+function formatKnowledgeInvocationNeighbors(result) {
+  const lines = [`Invocation-bearing graph neighbors for ${result.id}`, ""];
+  if (result.invocationSources.length === 0) {
+    lines.push("  (none)");
+  } else {
+    for (const source of result.invocationSources) {
+      lines.push(`${source.kind}: ${source.id}`);
+      for (const invocation of source.invocations) {
+        lines.push(`  ${invocation.kind}: ${formatKnowledgeInvocationLabel(invocation)}`);
+      }
+    }
+  }
+  return lines.join("\n");
+}
+
 // src/cli/commands/knowledge/ls.ts
 init_config();
 
@@ -49450,34 +49617,6 @@ async function loadOrgModel(projectRoot) {
 }
 
 // src/cli/commands/knowledge/ls.ts
-function formatAllSystems(entries) {
-  if (entries.length === 0) return "(no results)";
-  const pathWidth = Math.max(...entries.map((e) => e.path.length), 4);
-  const header = `${"PATH".padEnd(pathWidth)}  LABEL`;
-  const divider = "-".repeat(header.length + 20);
-  const rows = entries.map((e) => {
-    const label = e.system.label ?? e.system.title ?? e.path;
-    return `${e.path.padEnd(pathWidth)}  ${label}`;
-  });
-  return [header, divider, ...rows].join("\n");
-}
-function formatAllResources(resources) {
-  if (resources.length === 0) return "(no results)";
-  const idWidth = Math.max(...resources.map((r) => r.id.length), 4);
-  const kindWidth = Math.max(...resources.map((r) => r.kind.length), 4);
-  const header = `${"ID".padEnd(idWidth)}  ${"KIND".padEnd(kindWidth)}  TITLE`;
-  const divider = "-".repeat(header.length + 20);
-  const rows = resources.map((r) => `${r.id.padEnd(idWidth)}  ${r.kind.padEnd(kindWidth)}  ${r.title}`);
-  return [header, divider, ...rows].join("\n");
-}
-function formatAllRoles(roles) {
-  if (roles.length === 0) return "(no results)";
-  const idWidth = Math.max(...roles.map((r) => r.id.length), 4);
-  const header = `${"ID".padEnd(idWidth)}  TITLE`;
-  const divider = "-".repeat(header.length + 20);
-  const rows = roles.map((r) => `${r.id.padEnd(idWidth)}  ${r.title}`);
-  return [header, divider, ...rows].join("\n");
-}
 function registerKnowledgeLs(program3) {
   program3.command("knowledge:ls <path>").alias("om:ls").description(
     "List knowledge nodes for a Knowledge Map path\n  Examples:\n    elevasis-sdk om:ls /by-kind/playbook\n    elevasis-sdk om:ls /by-system/sales.crm\n    elevasis-sdk om:ls /by-ontology/sales.crm:object/deal\n    elevasis-sdk om:ls /by-owner/role.ops-lead\n    elevasis-sdk om:ls /graph/knowledge.outreach-playbook/governs\n    elevasis-sdk om:ls /graph/system:sales.crm/governed-by\n    elevasis-sdk om:ls /all-systems\n    elevasis-sdk om:ls /all-resources\n    elevasis-sdk om:ls /all-roles"
@@ -49501,7 +49640,7 @@ function registerKnowledgeLs(program3) {
           const out = entries.map((e) => e.path).join("\n");
           if (out) process.stdout.write(out + "\n");
         } else {
-          process.stdout.write(formatAllSystems(entries) + "\n");
+          process.stdout.write(formatKnowledgeSystemsList(entries) + "\n");
         }
         return;
       }
@@ -49513,7 +49652,7 @@ function registerKnowledgeLs(program3) {
           const out = resources.map((r) => r.id).join("\n");
           if (out) process.stdout.write(out + "\n");
         } else {
-          process.stdout.write(formatAllResources(resources) + "\n");
+          process.stdout.write(formatKnowledgeResourcesList(resources) + "\n");
         }
         return;
       }
@@ -49525,7 +49664,7 @@ function registerKnowledgeLs(program3) {
           const out = roles.map((r) => r.id).join("\n");
           if (out) process.stdout.write(out + "\n");
         } else {
-          process.stdout.write(formatAllRoles(roles) + "\n");
+          process.stdout.write(formatKnowledgeRolesList(roles) + "\n");
         }
         return;
       }
@@ -49679,82 +49818,6 @@ function registerKnowledgeGraph(program3) {
 
 // src/cli/commands/knowledge/skills.ts
 init_config();
-function normalizeKnowledgeId(id) {
-  return id.startsWith("knowledge:") ? id.slice("knowledge:".length) : id;
-}
-function invocationLabel2(invocation) {
-  switch (invocation.kind) {
-    case "slash-command":
-      return invocation.command;
-    case "mcp-tool":
-      return `${invocation.server}/${invocation.name}`;
-    case "api-endpoint":
-      return `${invocation.method} ${invocation.path}`;
-    case "script-execution":
-      return invocation.resourceId;
-  }
-}
-function pushActionSource(sources, seen, action) {
-  if (!action || action.invocations.length === 0) return;
-  const key = `action:${action.id}`;
-  if (seen.has(key)) return;
-  seen.add(key);
-  sources.push({
-    kind: "action",
-    id: action.id,
-    label: action.label,
-    targetNodeId: `action:${action.id}`,
-    invocations: action.invocations
-  });
-}
-function pushAgentResourceSource(sources, seen, resource) {
-  if (!resource || resource.kind !== "agent" || resource.invocations.length === 0) return;
-  const agentResource = resource;
-  const key = `agent-resource:${agentResource.id}`;
-  if (seen.has(key)) return;
-  seen.add(key);
-  sources.push({
-    kind: "agent-resource",
-    id: agentResource.id,
-    label: agentResource.id,
-    targetNodeId: `resource:${agentResource.id}`,
-    invocations: agentResource.invocations
-  });
-}
-function resolveKnowledgeInvocationNeighbors(model, id) {
-  const normalizedNodeId = normalizeKnowledgeId(id);
-  const node = model.knowledge[normalizedNodeId];
-  if (!node) return void 0;
-  const sources = [];
-  const seen = /* @__PURE__ */ new Set();
-  for (const link of node.links) {
-    const target = link.target;
-    if (target.kind === "action") {
-      pushActionSource(sources, seen, model.actions[target.id]);
-      continue;
-    }
-    if (target.kind === "resource") {
-      pushAgentResourceSource(sources, seen, model.resources[target.id]);
-      continue;
-    }
-    if (target.kind === "system") {
-      const system = getSystem(model, target.id);
-      for (const actionRef of system?.actions ?? []) {
-        pushActionSource(sources, seen, model.actions[actionRef.actionId]);
-      }
-      for (const resource of Object.values(model.resources)) {
-        if (resource.systemPath === target.id) {
-          pushAgentResourceSource(sources, seen, resource);
-        }
-      }
-    }
-  }
-  return {
-    id: node.id,
-    title: node.title,
-    invocationSources: sources.sort((a, b) => a.targetNodeId.localeCompare(b.targetNodeId))
-  };
-}
 function registerKnowledgeSkills(program3) {
   program3.command("knowledge:skills <id>").alias("om:skills").description(
     "Show callable invocations on graph neighbors for a knowledge node\n  Example: elevasis-sdk om:skills knowledge.new-vertical-launch-playbook"
@@ -49772,18 +49835,7 @@ function registerKnowledgeSkills(program3) {
         process.stdout.write(JSON.stringify(result, null, 2) + "\n");
         return;
       }
-      const lines = [`Invocation-bearing graph neighbors for ${result.id}`, ""];
-      if (result.invocationSources.length === 0) {
-        lines.push("  (none)");
-      } else {
-        for (const source of result.invocationSources) {
-          lines.push(`${source.kind}: ${source.id}`);
-          for (const invocation of source.invocations) {
-            lines.push(`  ${invocation.kind}: ${invocationLabel2(invocation)}`);
-          }
-        }
-      }
-      process.stdout.write(lines.join("\n") + "\n");
+      process.stdout.write(formatKnowledgeInvocationNeighbors(result) + "\n");
     })
   );
 }
@@ -50199,39 +50251,13 @@ function registerKnowledgeGenerate(program3) {
 
 // src/cli/commands/knowledge/search.ts
 init_config();
-var ALL_KINDS = ["system", "resource", "knowledge", "ontology", "role", "policy"];
-function parseLimit(raw) {
-  if (raw === void 0) return 10;
-  const n = Number.parseInt(raw, 10);
-  if (Number.isNaN(n) || n < 0) {
-    throw new Error(`knowledge:search: --limit must be a non-negative integer (got "${raw}")`);
-  }
-  return n;
-}
-function parseKinds(raw) {
-  if (raw === void 0) return void 0;
-  const requested = raw.split(",").map((s) => s.trim().toLowerCase()).filter((s) => s.length > 0);
-  const valid = [];
-  const invalid = [];
-  for (const kind of requested) {
-    if (ALL_KINDS.includes(kind)) {
-      valid.push(kind);
-    } else {
-      invalid.push(kind);
-    }
-  }
-  if (invalid.length > 0) {
-    throw new Error(`knowledge:search: unknown kind(s) "${invalid.join(", ")}". Valid: ${ALL_KINDS.join(", ")}`);
-  }
-  return valid.length > 0 ? valid : void 0;
-}
 function registerKnowledgeSearch(program3) {
   program3.command("knowledge:search <query>").alias("om:search").description(
     'Universal keyword search across the entire Organization Model\n  (systems, resources, knowledge, ontology, roles, policies)\n  Example: elevasis-sdk om:search "lead gen"\n  Example: elevasis-sdk om:search outreach --kinds knowledge\n  Example: elevasis-sdk om:search apollo --ids-only'
   ).option("--limit <n>", "max number of hits to return (0 = unlimited)", "10").option("--kinds <list>", "comma-separated kinds filter (system,resource,knowledge,ontology,role,policy)").option("--json", "Print wrapped JSON envelope").option("--ids-only", "Print one ID per line (for piping)").action(
     wrapAction("knowledge:search", async (query, options) => {
-      const limit = parseLimit(options.limit);
-      const kinds = parseKinds(options.kinds);
+      const limit = parseKnowledgeSearchLimit(options.limit);
+      const kinds = parseKnowledgeSearchKinds(options.kinds);
       const projectRoot = getProjectRoot();
       const model = await loadOrgModel(projectRoot);
       const hits = omSearch(model, query, { limit, kinds });

package/dist/index.d.ts

@@ -6728,7 +6728,6 @@ interface SystemEntry {
     status?: 'active' | 'deprecated' | 'archived';
     path?: string;
     icon?: string;
-    color?: string;
     uiPosition?: 'sidebar-primary' | 'sidebar-bottom';
     enabled?: boolean;
     devOnly?: boolean;
@@ -12224,7 +12223,7 @@ declare const ResourceOntologyBindingSchema = z
     /**
      * Optional typed contract binding for this resource's workflow I/O.
      * Each ref is a `package/subpath#ExportName` string that resolves to a
-     * Zod schema in `@repo/elevasis-core` (or the consumer's equivalent package).
+     * Zod schema in the tenant-owned organization model package.
      *
      * Absence of this field preserves all existing behavior — it is additive + optional.
      * Tier-1 validation (schema.ts): ref-string shape only (browser-safe, no imports).
@@ -12476,7 +12475,7 @@ declare const ActionSchema = z.object({
 })
 type Action = z.infer<typeof ActionSchema>
 
-// CRM stage/state catalogs are model-owned (authored in @repo/elevasis-core
+// CRM stage/state catalogs are model-owned (authored in the tenant-owned organization model package
 // canonicalOrganizationModel). The published core schema validates only the
 // transport shape; closed-catalog membership is enforced by the caller/API
 // layer via model-injected validators (mirrors LeadGenStageKeySchema).
@@ -12517,7 +12516,7 @@ declare function projectDeploymentSpec(options: ProjectDeploymentSpecOptions): D
 /**
  * Browser-safe generic workflow config helper.
  *
- * Promoted from @repo/elevasis-core so any workflow family (lead-gen, CRM, etc.)
+ * Promoted from the tenant-owned organization model layer so any workflow family (lead-gen, CRM, etc.)
  * can derive resourceId, actions, primaryAction, name, and description from
  * the canonical OM Resource descriptor without duplicating validation logic.
  *

package/dist/index.js

@@ -682,8 +682,6 @@ var SystemEntrySchema = z.object({
   path: PathSchema.optional(),
   /** @deprecated Use ui.icon. Kept for one-cycle Feature compatibility. */
   icon: IconNameSchema.optional(),
-  /** @deprecated Feature color token, retained for one-cycle compatibility. */
-  color: ColorTokenSchema.optional(),
   /** @deprecated UI placement hint, retained for one-cycle compatibility. */
   uiPosition: UiPositionSchema.optional(),
   /** @deprecated Use lifecycle. */
@@ -779,7 +777,7 @@ var ResourceOntologyBindingSchema = z.object({
   /**
    * Optional typed contract binding for this resource's workflow I/O.
    * Each ref is a `package/subpath#ExportName` string that resolves to a
-   * Zod schema in `@repo/elevasis-core` (or the consumer's equivalent package).
+   * Zod schema in the tenant-owned organization model package.
    *
    * Absence of this field preserves all existing behavior — it is additive + optional.
    * Tier-1 validation (schema.ts): ref-string shape only (browser-safe, no imports).
@@ -2526,6 +2524,20 @@ function validateDeclaredSystemInterfaceReadiness(orgName, organizationModel) {
   for (const { path, system } of listAllSystems(model)) {
     if (system.apiInterface === void 0) continue;
     const interfaceKey = "api";
+    const resourceIds = system.apiInterface.resourceIds ?? [];
+    if (resourceIds.length === 0) {
+      const readinessProfile = system.apiInterface.readinessProfile;
+      if (readinessProfile !== void 0 && !SYSTEM_INTERFACE_PROFILES.some((profile) => profile.readinessProfile === readinessProfile)) {
+        addSystemInterfaceIssue(issues, orgName, path, interfaceKey, {
+          family: "SYSTEM_INTERFACE_INVALID",
+          code: "unknown-readiness-profile",
+          path: `systems.${path}.apiInterface.readinessProfile`,
+          ref: readinessProfile,
+          message: `System Interface "${path}/${interfaceKey}" references unknown readiness profile "${readinessProfile}".`
+        });
+      }
+      continue;
+    }
     const result = computeInterfaceReadiness(model, { systemPath: path, interfaceKey });
     for (const issue of result.issues) {
       addSystemInterfaceIssue(issues, orgName, path, interfaceKey, issue);

package/dist/node/index.d.ts

@@ -1436,7 +1436,6 @@ interface SystemEntry {
     status?: 'active' | 'deprecated' | 'archived';
     path?: string;
     icon?: string;
-    color?: string;
     uiPosition?: 'sidebar-primary' | 'sidebar-bottom';
     enabled?: boolean;
     devOnly?: boolean;
@@ -3222,7 +3221,7 @@ declare const ResourceOntologyBindingSchema = z
     /**
      * Optional typed contract binding for this resource's workflow I/O.
      * Each ref is a `package/subpath#ExportName` string that resolves to a
-     * Zod schema in `@repo/elevasis-core` (or the consumer's equivalent package).
+     * Zod schema in the tenant-owned organization model package.
      *
      * Absence of this field preserves all existing behavior — it is additive + optional.
      * Tier-1 validation (schema.ts): ref-string shape only (browser-safe, no imports).

package/dist/test-utils/index.d.ts

@@ -5923,7 +5923,6 @@ interface SystemEntry {
     status?: 'active' | 'deprecated' | 'archived';
     path?: string;
     icon?: string;
-    color?: string;
     uiPosition?: 'sidebar-primary' | 'sidebar-bottom';
     enabled?: boolean;
     devOnly?: boolean;

package/dist/test-utils/index.js

@@ -8735,8 +8735,6 @@ var SystemEntrySchema = z.object({
   path: PathSchema.optional(),
   /** @deprecated Use ui.icon. Kept for one-cycle Feature compatibility. */
   icon: IconNameSchema.optional(),
-  /** @deprecated Feature color token, retained for one-cycle compatibility. */
-  color: ColorTokenSchema.optional(),
   /** @deprecated UI placement hint, retained for one-cycle compatibility. */
   uiPosition: UiPositionSchema.optional(),
   /** @deprecated Use lifecycle. */
@@ -9660,6 +9658,20 @@ function validateDeclaredSystemInterfaceReadiness(orgName, organizationModel) {
   for (const { path, system } of listAllSystems(model)) {
     if (system.apiInterface === void 0) continue;
     const interfaceKey = "api";
+    const resourceIds = system.apiInterface.resourceIds ?? [];
+    if (resourceIds.length === 0) {
+      const readinessProfile = system.apiInterface.readinessProfile;
+      if (readinessProfile !== void 0 && !SYSTEM_INTERFACE_PROFILES.some((profile) => profile.readinessProfile === readinessProfile)) {
+        addSystemInterfaceIssue(issues, orgName, path, interfaceKey, {
+          family: "SYSTEM_INTERFACE_INVALID",
+          code: "unknown-readiness-profile",
+          path: `systems.${path}.apiInterface.readinessProfile`,
+          ref: readinessProfile,
+          message: `System Interface "${path}/${interfaceKey}" references unknown readiness profile "${readinessProfile}".`
+        });
+      }
+      continue;
+    }
     const result = computeInterfaceReadiness(model, { systemPath: path, interfaceKey });
     for (const issue of result.issues) {
       addSystemInterfaceIssue(issues, orgName, path, interfaceKey, issue);

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@elevasis/sdk",
-  "version": "1.33.0",
+  "version": "1.33.1",
   "description": "SDK for building Elevasis organization resources",
   "type": "module",
   "bin": {
@@ -58,7 +58,7 @@
     "tsup": "^8.0.0",
     "typescript": "5.9.2",
     "zod": "^4.1.0",
-    "@repo/core": "0.42.0",
+    "@repo/core": "0.43.0",
     "@repo/eslint-config": "0.0.0",
     "@repo/typescript-config": "0.0.0"
   },

package/reference/claude-config/sync-notes/2026-06-04-scaffold-registry-lane-severity.md

@@ -0,0 +1,34 @@
+# Scaffold registry lane severity annotations
+
+## Why this note exists
+
+This train adds `sync_lane_severity` annotations to the scaffold registry schema and moves external sync lane-severity ownership from hardcoded script sets into registry metadata.
+
+The change is intended to keep project sync behavior the same while making the registry the single edit point for paths that need critical manual-merge handling or optional-feature-selection treatment.
+
+## Applies to
+
+- Template-derived projects that use `/external sync` or `pnpm sync:apply` from the Elevasis monorepo.
+- Projects that receive `@elevasis/core` package-baseline updates through `core/package.json` or `operations/package.json`.
+- Operators reviewing external-sync plans that mention critical manual-merge or optional-feature-selection paths.
+
+## Required actions
+
+1. Run the prepared external sync from the release train so this note reaches derived projects.
+2. After the `@elevasis/core` publish stage, install the prepared core package baseline in template-derived project package files.
+3. Review any sync plan lane labels against the registry entry metadata before widening a manifest or applying catch-up work.
+
+No project-authored Organization Model content should be overwritten for this train.
+
+## Verification
+
+```bash
+pnpm sync:verify
+pnpm exec tsx scripts/external/sync-apply.ts --all --dry-run --manifest apps/docs/content/docs/in-progress/active-development/sdk-changes/ship/_external-sync-prep.json --strict-manifest
+```
+
+The strict manifest dry-run should authorize only the prepared sync note and the core package-baseline cascades.
+
+## Not handled by /git-sync
+
+`/git-sync` can deliver committed file changes, but it does not publish `@elevasis/core`, install package baselines, validate scaffold registry metadata, or enforce manifest-scoped external-sync write authorization.

package/reference/scaffold/core/organization-graph.mdx

@@ -46,17 +46,18 @@ Edge kinds:
 
 - `contains`
 - `references`
-- `maps_to`
-- `uses`
-- `governs`
-- `governed-by`
-- `links`
-- `affects`
-- `emits`
+- `maps_to`
+- `uses`
+- `governs`
+- `links`
+- `affects`
+- `emits`
 - `originates_from`
 - `triggers`
 - `applies_to`
-- `effects`
+- `effects`
+
+`governed-by` is a Knowledge Graph route verb for traversing incoming `governs` edges; it is not an Organization Graph edge kind.
 
 System nodes come from the id-keyed `OrganizationModel.systems` map. Their graph IDs use `system:<id>`, such as `system:sales.crm`.
 

package/reference/scaffold/operations/propagation-pipeline.md

@@ -31,15 +31,19 @@ Layer 3: Sync Verification (pnpm sync:verify)
 
 ## Layer 1: Source Generation
 
-`pnpm scaffold:sync` is the meta-script that regenerates all derived documentation and validates the output. It chains three sub-scripts:
-
-| Script                                  | Input                                                                                                                                         | Output                                                              |
-| --------------------------------------- | --------------------------------------------------------------------------------------------------------------------------------------------- | ------------------------------------------------------------------- |
-| `generate-scaffold-contracts.js`        | `packages/core/src/organization-model/types.ts`, `packages/ui/src/features/registry/types.ts`, `packages/core/src/platform/registry/types.ts` | `packages/core/src/reference/_generated/contracts.md`               |
-| `generate-scaffold-feature-registry.js` | `packages/ui/src/features/registry/manifests.ts`, `packages/ui/src/features/*/manifest.ts`                                                    | `packages/ui/src/scaffold/_generated/feature-registry.md`           |
-| `generate-reference-artifacts.js`       | SDK manifest, navigation sources                                                                                                              | `packages/sdk/reference/_reference-manifest.json`, `_navigation.md` |
-
-After generation, `validate-reference-artifacts.js` checks that the outputs are consistent. Exit 1 if drifted.
+`pnpm scaffold:sync` is the meta-script that regenerates all derived documentation and validates the output. It chains seven sub-scripts:
+
+| Script                 | Input                                                                                                                 | Output                                                                                                     |
+| ---------------------- | --------------------------------------------------------------------------------------------------------------------- | ---------------------------------------------------------------------------------------------------------- |
+| `scaffold:generate`    | Scaffold contract and feature-registry sources                                                                        | `packages/core/src/reference/_generated/**`, `packages/ui/src/scaffold/_generated/feature-registry.md`     |
+| `knowledge:generate`   | Elevasis core knowledge nodes and UI knowledge body sources                                                           | Generated knowledge nodes and UI knowledge bodies                                                          |
+| `gen:sdk-catalog`      | SDK catalog source definitions                                                                                         | SDK catalog artifacts                                                                                      |
+| `gen:sdk-adapters`     | SDK adapter definitions                                                                                                | SDK adapter artifacts                                                                                      |
+| `copy-docs`            | SDK docs, package-owned reference docs, scaffold docs, and `_template/.claude` config                                  | `packages/sdk/reference/**` copied docs and scaffold reference bundle                                       |
+| `sdk-ref:generate`     | SDK manifest and navigation sources                                                                                    | `packages/sdk/reference/_reference-manifest.json`, `packages/sdk/reference/_navigation.md`                  |
+| `sdk-ref:check`        | Generated SDK reference artifacts                                                                                      | Freshness validation for `packages/sdk/reference/_reference-manifest.json` and `_navigation.md`             |
+
+The final `sdk-ref:check` step validates that the reference artifacts are consistent. Exit 1 if drifted.
 
 ### Trigger Points
 

package/reference/scaffold/operations/scaffold-maintenance.md

@@ -99,13 +99,14 @@ Generated files should never be edited manually. If the output is wrong, fix the
 
 ## SDK Build Pipeline (Reference Copy)
 
-`packages/sdk/scripts/copy-reference-docs.mjs` runs during `pnpm --filter @elevasis/sdk build` and has three phases:
-
-1. **Phase 1:** Copies SDK public docs from `apps/docs/content/docs/sdk/` with link rewriting and MDX escape stripping
-2. **Phase 2:** Copies package-owned reference docs declared in reference manifests
-3. **Phase 3:** Copies scaffold docs from co-located package sources using the `SCAFFOLD_COPIES` map
-
-The output lands in `packages/sdk/reference/` which is included in the npm package's `files` array. External projects access it via `node_modules/@elevasis/sdk/reference/`.
+`packages/sdk/scripts/copy-reference-docs.mjs` runs during `pnpm --filter @elevasis/sdk build` and has four phases:
+
+1. **Phase 1:** Copies SDK public docs from `apps/docs/content/docs/sdk/` with link rewriting and MDX escape stripping
+2. **Phase 2:** Copies package-owned reference docs declared in reference manifests
+3. **Phase 3:** Copies scaffold docs from co-located package sources using the `SCAFFOLD_COPIES` map
+4. **Phase 4:** Copies `external/_template/.claude` into `packages/sdk/reference/claude-config` for tenant-facing agent configuration
+
+The output lands in `packages/sdk/reference/` which is included in the npm package's `files` array. External projects access it via `node_modules/@elevasis/sdk/reference/`.
 
 ---