@elevasis/sdk 1.33.0 → 1.34.0

package/dist/cli.cjs

@@ -7142,14 +7142,14 @@ var require_async_iterator = __commonJS({
       };
     }
     function readAndResolve(iter) {
-      var resolve5 = iter[kLastResolve];
-      if (resolve5 !== null) {
+      var resolve6 = iter[kLastResolve];
+      if (resolve6 !== null) {
         var data = iter[kStream].read();
         if (data !== null) {
           iter[kLastPromise] = null;
           iter[kLastResolve] = null;
           iter[kLastReject] = null;
-          resolve5(createIterResult(data, false));
+          resolve6(createIterResult(data, false));
         }
       }
     }
@@ -7157,13 +7157,13 @@ var require_async_iterator = __commonJS({
       process.nextTick(readAndResolve, iter);
     }
     function wrapForNext(lastPromise, iter) {
-      return function(resolve5, reject) {
+      return function(resolve6, reject) {
         lastPromise.then(function() {
           if (iter[kEnded]) {
-            resolve5(createIterResult(void 0, true));
+            resolve6(createIterResult(void 0, true));
             return;
           }
-          iter[kHandlePromise](resolve5, reject);
+          iter[kHandlePromise](resolve6, reject);
         }, reject);
       };
     }
@@ -7183,12 +7183,12 @@ var require_async_iterator = __commonJS({
           return Promise.resolve(createIterResult(void 0, true));
         }
         if (this[kStream].destroyed) {
-          return new Promise(function(resolve5, reject) {
+          return new Promise(function(resolve6, reject) {
             process.nextTick(function() {
               if (_this[kError]) {
                 reject(_this[kError]);
               } else {
-                resolve5(createIterResult(void 0, true));
+                resolve6(createIterResult(void 0, true));
               }
             });
           });
@@ -7211,13 +7211,13 @@ var require_async_iterator = __commonJS({
       return this;
     }), _defineProperty(_Object$setPrototypeO, "return", function _return() {
       var _this2 = this;
-      return new Promise(function(resolve5, reject) {
+      return new Promise(function(resolve6, reject) {
         _this2[kStream].destroy(null, function(err) {
           if (err) {
             reject(err);
             return;
           }
-          resolve5(createIterResult(void 0, true));
+          resolve6(createIterResult(void 0, true));
         });
       });
     }), _Object$setPrototypeO), AsyncIteratorPrototype);
@@ -7239,15 +7239,15 @@ var require_async_iterator = __commonJS({
         value: stream._readableState.endEmitted,
         writable: true
       }), _defineProperty(_Object$create, kHandlePromise, {
-        value: function value(resolve5, reject) {
+        value: function value(resolve6, reject) {
           var data = iterator[kStream].read();
           if (data) {
             iterator[kLastPromise] = null;
             iterator[kLastResolve] = null;
             iterator[kLastReject] = null;
-            resolve5(createIterResult(data, false));
+            resolve6(createIterResult(data, false));
           } else {
-            iterator[kLastResolve] = resolve5;
+            iterator[kLastResolve] = resolve6;
             iterator[kLastReject] = reject;
           }
         },
@@ -7266,12 +7266,12 @@ var require_async_iterator = __commonJS({
           iterator[kError] = err;
           return;
         }
-        var resolve5 = iterator[kLastResolve];
-        if (resolve5 !== null) {
+        var resolve6 = iterator[kLastResolve];
+        if (resolve6 !== null) {
           iterator[kLastPromise] = null;
           iterator[kLastResolve] = null;
           iterator[kLastReject] = null;
-          resolve5(createIterResult(void 0, true));
+          resolve6(createIterResult(void 0, true));
         }
         iterator[kEnded] = true;
       });
@@ -7286,7 +7286,7 @@ var require_async_iterator = __commonJS({
 var require_from = __commonJS({
   "../../node_modules/.pnpm/readable-stream@3.6.2/node_modules/readable-stream/lib/internal/streams/from.js"(exports2, module2) {
     "use strict";
-    function asyncGeneratorStep(gen, resolve5, reject, _next, _throw, key, arg) {
+    function asyncGeneratorStep(gen, resolve6, reject, _next, _throw, key, arg) {
       try {
         var info = gen[key](arg);
         var value = info.value;
@@ -7295,7 +7295,7 @@ var require_from = __commonJS({
         return;
       }
       if (info.done) {
-        resolve5(value);
+        resolve6(value);
       } else {
         Promise.resolve(value).then(_next, _throw);
       }
@@ -7303,13 +7303,13 @@ var require_from = __commonJS({
     function _asyncToGenerator(fn) {
       return function() {
         var self2 = this, args = arguments;
-        return new Promise(function(resolve5, reject) {
+        return new Promise(function(resolve6, reject) {
           var gen = fn.apply(self2, args);
           function _next(value) {
-            asyncGeneratorStep(gen, resolve5, reject, _next, _throw, "next", value);
+            asyncGeneratorStep(gen, resolve6, reject, _next, _throw, "next", value);
           }
           function _throw(err) {
-            asyncGeneratorStep(gen, resolve5, reject, _next, _throw, "throw", err);
+            asyncGeneratorStep(gen, resolve6, reject, _next, _throw, "throw", err);
           }
           _next(void 0);
         });
@@ -23629,18 +23629,18 @@ var init_config = __esm({
 // src/cli/commands/om/project-layout.ts
 function assertSplitLayout(projectDir) {
   const omDir = (0, import_node_path9.join)(projectDir, "core", "config", "organization-model");
-  const missing = REQUIRED_FILES.filter((f) => !(0, import_node_fs8.existsSync)((0, import_node_path9.join)(omDir, f)));
+  const missing = REQUIRED_FILES.filter((f) => !(0, import_node_fs10.existsSync)((0, import_node_path9.join)(omDir, f)));
   if (missing.length > 0) {
     throw new Error(
       "Legacy single-file OM layout detected. Split into `core/config/organization-model/{profile.ts, systems.ts, navigation.ts}` before scaffolding."
     );
   }
 }
-var import_node_fs8, import_node_path9, REQUIRED_FILES;
+var import_node_fs10, import_node_path9, REQUIRED_FILES;
 var init_project_layout = __esm({
   "src/cli/commands/om/project-layout.ts"() {
     "use strict";
-    import_node_fs8 = require("node:fs");
+    import_node_fs10 = require("node:fs");
     import_node_path9 = require("node:path");
     REQUIRED_FILES = ["profile.ts", "systems.ts", "navigation.ts"];
   }
@@ -23656,11 +23656,11 @@ async function promptIfAbsent(value, question, options) {
     input: process.stdin,
     output: process.stdout
   });
-  return new Promise((resolve5) => {
+  return new Promise((resolve6) => {
     const prompt = options?.default ? `${question} [${options.default}]: ` : `${question}: `;
     rl.question(prompt, (answer) => {
       rl.close();
-      resolve5(answer.trim() || (options?.default ?? ""));
+      resolve6(answer.trim() || (options?.default ?? ""));
     });
   });
 }
@@ -23715,7 +23715,6 @@ function emitSystemEntry(opts) {
   const apiInterfaceBlock = opts.apiBacked ? `
     apiInterface: {
       lifecycle: 'active',
-      readinessProfile: 'standard',
       resourceIds: []
     },` : "";
   const code = `  {
@@ -23742,7 +23741,7 @@ async function withSnapshotRollback(filePaths, op) {
   const snapshots = /* @__PURE__ */ new Map();
   for (const filePath of filePaths) {
     try {
-      snapshots.set(filePath, (0, import_node_fs9.readFileSync)(filePath, "utf8"));
+      snapshots.set(filePath, (0, import_node_fs11.readFileSync)(filePath, "utf8"));
     } catch {
       snapshots.set(filePath, null);
     }
@@ -23753,7 +23752,7 @@ async function withSnapshotRollback(filePaths, op) {
     for (const [filePath, snapshot] of snapshots) {
       if (snapshot !== null) {
         try {
-          (0, import_node_fs9.writeFileSync)(filePath, snapshot, "utf8");
+          (0, import_node_fs11.writeFileSync)(filePath, snapshot, "utf8");
         } catch {
         }
       }
@@ -23774,14 +23773,14 @@ function insertBeforeAnchorInContent(content, code, anchor) {
   return lines.join("\n");
 }
 async function appendBeforeAnchor(filePath, code, anchor) {
-  const content = (0, import_node_fs9.readFileSync)(filePath, "utf8");
+  const content = (0, import_node_fs11.readFileSync)(filePath, "utf8");
   const updated = insertBeforeAnchorInContent(content, code, anchor);
-  (0, import_node_fs9.writeFileSync)(filePath, updated, "utf8");
+  (0, import_node_fs11.writeFileSync)(filePath, updated, "utf8");
 }
 async function applyConstImport(systemsFilePath, importLine, fieldLine, importAnchor, fieldAnchor, newConstFilePath, newConstFileCode) {
-  (0, import_node_fs9.mkdirSync)((0, import_node_path10.dirname)(newConstFilePath), { recursive: true });
-  (0, import_node_fs9.writeFileSync)(newConstFilePath, newConstFileCode, "utf8");
-  const systemsContent = (0, import_node_fs9.readFileSync)(systemsFilePath, "utf8");
+  (0, import_node_fs11.mkdirSync)((0, import_node_path10.dirname)(newConstFilePath), { recursive: true });
+  (0, import_node_fs11.writeFileSync)(newConstFilePath, newConstFileCode, "utf8");
+  const systemsContent = (0, import_node_fs11.readFileSync)(systemsFilePath, "utf8");
   const afterImport = insertBeforeAnchorInContent(systemsContent, importLine + "\n", importAnchor);
   const lines = afterImport.split("\n");
   const fieldAnchorIndex = lines.findIndex((line) => fieldAnchor.test(line));
@@ -23791,13 +23790,13 @@ async function applyConstImport(systemsFilePath, importLine, fieldLine, importAn
     );
   }
   lines.splice(fieldAnchorIndex + 1, 0, fieldLine);
-  (0, import_node_fs9.writeFileSync)(systemsFilePath, lines.join("\n"), "utf8");
+  (0, import_node_fs11.writeFileSync)(systemsFilePath, lines.join("\n"), "utf8");
 }
-var import_node_fs9, import_node_path10;
+var import_node_fs11, import_node_path10;
 var init_splice = __esm({
   "src/cli/commands/om/splice.ts"() {
     "use strict";
-    import_node_fs9 = require("node:fs");
+    import_node_fs11 = require("node:fs");
     import_node_path10 = require("node:path");
   }
 });
@@ -24169,24 +24168,24 @@ async function scaffoldKnowledge(opts) {
     return;
   }
   const absoluteFilePath = (0, import_node_path14.join)(projectDir, relativeFilePath);
-  if ((0, import_node_fs10.existsSync)(absoluteFilePath)) {
+  if ((0, import_node_fs12.existsSync)(absoluteFilePath)) {
     process.stderr.write(
       source_default.red(`Knowledge node file already exists at \`${relativeFilePath}\`. Choose a different id.
 `)
     );
     process.exit(1);
   }
-  (0, import_node_fs10.mkdirSync)((0, import_node_path14.join)(projectDir, "core", "config", "knowledge", "nodes"), { recursive: true });
-  (0, import_node_fs10.writeFileSync)(absoluteFilePath, content, "utf8");
+  (0, import_node_fs12.mkdirSync)((0, import_node_path14.join)(projectDir, "core", "config", "knowledge", "nodes"), { recursive: true });
+  (0, import_node_fs12.writeFileSync)(absoluteFilePath, content, "utf8");
   console.log(source_default.green(`Knowledge node \`${id}\` written to \`${relativeFilePath}\``));
   console.log(source_default.yellow("Run `elevasis-sdk om:generate` to register this node."));
 }
-var import_node_path14, import_node_fs10, VALID_KINDS;
+var import_node_path14, import_node_fs12, VALID_KINDS;
 var init_scaffold_knowledge = __esm({
   "src/cli/commands/om/scaffold-knowledge.ts"() {
     "use strict";
     import_node_path14 = require("node:path");
-    import_node_fs10 = require("node:fs");
+    import_node_fs12 = require("node:fs");
     init_source();
     init_config();
     init_project_layout();
@@ -24210,7 +24209,6 @@ function emitApiInterfaceBlock(gap) {
 
 export const ${constName} = {
   lifecycle: 'active' as const,
-  readinessProfile: 'standard' as const,
   resourceIds: ${resourceIdsLiteral}
 }
 `;
@@ -24263,7 +24261,7 @@ async function scaffoldFill(opts) {
     process.stderr.write(source_default.red("Missing gaps file. Pass --gaps <path> pointing to a conformance gap JSON file.\n"));
     process.exit(1);
   }
-  if (!(0, import_node_fs11.existsSync)(options.gaps)) {
+  if (!(0, import_node_fs13.existsSync)(options.gaps)) {
     process.stderr.write(
       source_default.red(
         `Missing gaps file. Pass --gaps <path> pointing to a conformance gap JSON file.
@@ -24275,7 +24273,7 @@ async function scaffoldFill(opts) {
   }
   let payload;
   try {
-    const raw = (0, import_node_fs11.readFileSync)(options.gaps, "utf8");
+    const raw = (0, import_node_fs13.readFileSync)(options.gaps, "utf8");
     payload = JSON.parse(raw);
   } catch {
     process.stderr.write(
@@ -24396,7 +24394,7 @@ async function scaffoldFill(opts) {
   }
   if (skippedGaps.length > 0) {
     const skippedPath = options.skipped ?? (0, import_node_path15.join)(os2.tmpdir(), `elevasis-fill-skipped-${systemPath}-${Date.now()}.json`);
-    (0, import_node_fs11.writeFileSync)(skippedPath, JSON.stringify({ systemPath, skipped: skippedGaps }, null, 2), "utf8");
+    (0, import_node_fs13.writeFileSync)(skippedPath, JSON.stringify({ systemPath, skipped: skippedGaps }, null, 2), "utf8");
     console.log(
       source_default.yellow(
         `Partial fill: ${appliedGaps.length} gap(s) applied, ${skippedGaps.length} skipped \u2014 see \`${skippedPath}\` for fields requiring manual input.`
@@ -24410,13 +24408,13 @@ async function scaffoldFill(opts) {
     )
   );
 }
-var import_node_path15, os2, import_node_fs11, import_node_child_process5;
+var import_node_path15, os2, import_node_fs13, import_node_child_process5;
 var init_scaffold_fill = __esm({
   "src/cli/commands/om/scaffold-fill.ts"() {
     "use strict";
     import_node_path15 = require("node:path");
     os2 = __toESM(require("node:os"), 1);
-    import_node_fs11 = require("node:fs");
+    import_node_fs13 = require("node:fs");
     import_node_child_process5 = require("node:child_process");
     init_source();
     init_config();
@@ -37535,16 +37533,13 @@ var OntologyKindSchema = external_exports.enum([
   "value-type",
   "property",
   "group",
-  "surface"
+  "endpoint"
 ]);
 var SYSTEM_PATH_PATTERN = "[a-z0-9][a-z0-9-]*(?:\\.[a-z0-9][a-z0-9-]*)*";
 var LOCAL_ID_PATTERN = "[a-z0-9][a-z0-9._-]*";
 var ONTOLOGY_ID_PATTERN = `^(global|${SYSTEM_PATH_PATTERN}):(${OntologyKindSchema.options.join("|")})\\/(${LOCAL_ID_PATTERN})$`;
 var ONTOLOGY_ID_REGEX = new RegExp(ONTOLOGY_ID_PATTERN);
-var OntologyIdSchema = external_exports.string().trim().min(1).max(300).regex(
-  ONTOLOGY_ID_REGEX,
-  "Ontology IDs must use <system-path>:<kind>/<local-id> or global:<kind>/<local-id>"
-);
+var OntologyIdSchema = external_exports.string().trim().min(1).max(300).regex(ONTOLOGY_ID_REGEX, "Ontology IDs must use <system-path>:<kind>/<local-id> or global:<kind>/<local-id>");
 function parseOntologyId(id) {
   const normalized = OntologyIdSchema.parse(id);
   const match = ONTOLOGY_ID_REGEX.exec(normalized);
@@ -37607,7 +37602,7 @@ var OntologySharedPropertySchema = OntologyRecordBaseSchema.extend({
 var OntologyGroupSchema = OntologyRecordBaseSchema.extend({
   members: OntologyReferenceListSchema
 });
-var OntologySurfaceTypeSchema = OntologyRecordBaseSchema.extend({
+var OntologyEndpointTypeSchema = OntologyRecordBaseSchema.extend({
   route: external_exports.string().trim().min(1).max(500).optional()
 });
 var OntologyScopeSchema = external_exports.object({
@@ -37620,7 +37615,7 @@ var OntologyScopeSchema = external_exports.object({
   valueTypes: external_exports.record(OntologyIdSchema, OntologyValueTypeSchema).default({}).optional(),
   sharedProperties: external_exports.record(OntologyIdSchema, OntologySharedPropertySchema).default({}).optional(),
   groups: external_exports.record(OntologyIdSchema, OntologyGroupSchema).default({}).optional(),
-  surfaces: external_exports.record(OntologyIdSchema, OntologySurfaceTypeSchema).default({}).optional()
+  endpoints: external_exports.record(OntologyIdSchema, OntologyEndpointTypeSchema).default({}).optional()
 }).default({});
 var DEFAULT_ONTOLOGY_SCOPE = {
   valueTypes: {
@@ -37656,7 +37651,7 @@ var SCOPE_KIND = {
   valueTypes: "value-type",
   sharedProperties: "property",
   groups: "group",
-  surfaces: "surface"
+  endpoints: "endpoint"
 };
 var SCOPE_KEYS = Object.keys(SCOPE_KIND);
 function ontologyGraphNodeId(id) {
@@ -37692,7 +37687,7 @@ function createEmptyIndex() {
     valueTypes: {},
     sharedProperties: {},
     groups: {},
-    surfaces: {}
+    endpoints: {}
   };
 }
 function sortResolvedOntologyIndex(index) {
@@ -37925,10 +37920,11 @@ var ONTOLOGY_REFERENCE_KEY_KINDS = {
   interfaceType: "interface",
   propertyType: "property",
   groupType: "group",
-  surfaceType: "surface",
+  endpointType: "endpoint",
   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 +37938,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,
@@ -37953,7 +37948,7 @@ function buildOmCrossRefIndex(model) {
     "value-type": ontologyCompilation.ontology.valueTypes,
     property: ontologyCompilation.ontology.sharedProperties,
     group: ontologyCompilation.ontology.groups,
-    surface: ontologyCompilation.ontology.surfaces
+    endpoint: ontologyCompilation.ontology.endpoints
   };
   const ontologyIds = new Set(Object.values(ontologyIndexByKind).flatMap((index) => Object.keys(index)));
   const stageIds = /* @__PURE__ */ new Set();
@@ -37981,6 +37976,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 +38636,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 +38732,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 +39491,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);
@@ -41869,8 +41870,8 @@ function ontologyIndexForKind(index, kind) {
       return index.sharedProperties;
     case "group":
       return index.groups;
-    case "surface":
-      return index.surfaces;
+    case "endpoint":
+      return index.endpoints;
   }
 }
 function sameJson(left, right) {
@@ -42173,6 +42174,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 +45731,7 @@ function wrapAction(commandName, fn) {
 // package.json
 var package_default = {
   name: "@elevasis/sdk",
-  version: "1.33.0",
+  version: "1.34.0",
   description: "SDK for building Elevasis organization resources",
   type: "module",
   bin: {
@@ -46559,7 +46574,7 @@ async function pollForCompletion(resourceId, executionId, apiUrl) {
     if (interrupted) {
       return;
     }
-    await new Promise((resolve5) => setTimeout(resolve5, POLL_INTERVAL_MS));
+    await new Promise((resolve6) => setTimeout(resolve6, POLL_INTERVAL_MS));
     if (interrupted) {
       return;
     }
@@ -47195,10 +47210,10 @@ init_source();
 var import_readline = require("readline");
 function confirm(message) {
   const rl = (0, import_readline.createInterface)({ input: process.stdin, output: process.stdout });
-  return new Promise((resolve5) => {
+  return new Promise((resolve6) => {
     rl.question(message, (answer) => {
       rl.close();
-      resolve5(answer.toLowerCase() === "y" || answer.toLowerCase() === "yes");
+      resolve6(answer.toLowerCase() === "y" || answer.toLowerCase() === "yes");
     });
   });
 }
@@ -47952,8 +47967,28 @@ Project ${id} deleted.`));
 }
 
 // src/cli/commands/project/milestones.ts
+var import_node_fs3 = require("node:fs");
 init_source();
 init_config();
+function parseChecklistOption(options) {
+  if (options.checklist !== void 0 && options.checklistFile !== void 0) {
+    process.stderr.write(
+      JSON.stringify({
+        error: "Provide only one of --checklist or --checklist-file",
+        code: "CONFLICTING_FLAGS"
+      }) + "\n"
+    );
+    process.exit(1);
+  }
+  const raw = options.checklistFile !== void 0 ? (0, import_node_fs3.readFileSync)(resolveProjectRelative(options.checklistFile), "utf8") : options.checklist;
+  if (raw === void 0) return void 0;
+  try {
+    return JSON.parse(raw);
+  } catch {
+    process.stderr.write(JSON.stringify({ error: "Checklist must be valid JSON", code: "INVALID_JSON" }) + "\n");
+    process.exit(1);
+  }
+}
 function registerMilestoneList(program3) {
   program3.command("project:milestone:list").description("List milestones for a project\n  Example: elevasis-sdk project:milestone:list --project <uuid>").requiredOption("--project <project-id>", "Project ID (UUID)").option("--api-url <url>", "API base URL").option("--pretty", "Render human-readable output instead of raw JSON").action(
     wrapAction("project:milestone:list", async (options) => {
@@ -48013,7 +48048,10 @@ Milestone created: ${m.name}`));
   );
 }
 function registerMilestoneUpdate(program3) {
-  program3.command("project:milestone:update <id>").description("Update a milestone\n  Example: elevasis-sdk project:milestone:update <uuid> --status completed").option("--name <name>", "New milestone name").option("--status <status>", "New status: upcoming | in_progress | completed | overdue | blocked").option("--description <description>", "New description").option("--due-date <date>", "New due date (ISO 8601)").option("--checklist <json>", `Replace checklist (full array): '[{"id":"1","label":"Step","completed":false}]'`).option("--api-url <url>", "API base URL").option("--pretty", "Render human-readable output instead of raw JSON").action(
+  program3.command("project:milestone:update <id>").description("Update a milestone\n  Example: elevasis-sdk project:milestone:update <uuid> --status completed").option("--name <name>", "New milestone name").option("--status <status>", "New status: upcoming | in_progress | completed | overdue | blocked").option("--description <description>", "New description").option("--due-date <date>", "New due date (ISO 8601)").option("--checklist <json>", `Replace checklist (full array): '[{"id":"1","label":"Step","completed":false}]'`).option(
+    "--checklist-file <path>",
+    "Read replacement checklist from a JSON file. Relative paths resolve against the project root."
+  ).option("--api-url <url>", "API base URL").option("--pretty", "Render human-readable output instead of raw JSON").action(
     wrapAction(
       "project:milestone:update",
       async (id, options) => {
@@ -48022,20 +48060,12 @@ function registerMilestoneUpdate(program3) {
         if (options.status !== void 0) body.status = options.status;
         if (options.description !== void 0) body.description = options.description;
         if (options.dueDate !== void 0) body.due_date = options.dueDate;
-        if (options.checklist !== void 0) {
-          try {
-            body.checklist = JSON.parse(options.checklist);
-          } catch {
-            process.stderr.write(
-              JSON.stringify({ error: "--checklist must be valid JSON", code: "INVALID_JSON" }) + "\n"
-            );
-            process.exit(1);
-          }
-        }
+        const checklist = parseChecklistOption(options);
+        if (checklist !== void 0) body.checklist = checklist;
         if (Object.keys(body).length === 0) {
           process.stderr.write(
             JSON.stringify({
-              error: "At least one field must be provided (--name, --status, --description, --due-date, --checklist)",
+              error: "At least one field must be provided (--name, --status, --description, --due-date, --checklist, --checklist-file)",
               code: "MISSING_FIELDS"
             }) + "\n"
           );
@@ -48073,8 +48103,28 @@ Milestone ${id} deleted.`));
 }
 
 // src/cli/commands/project/tasks.ts
+var import_node_fs4 = require("node:fs");
 init_source();
 init_config();
+function parseChecklistOption2(options) {
+  if (options.checklist !== void 0 && options.checklistFile !== void 0) {
+    process.stderr.write(
+      JSON.stringify({
+        error: "Provide only one of --checklist or --checklist-file",
+        code: "CONFLICTING_FLAGS"
+      }) + "\n"
+    );
+    process.exit(1);
+  }
+  const raw = options.checklistFile !== void 0 ? (0, import_node_fs4.readFileSync)(resolveProjectRelative(options.checklistFile), "utf8") : options.checklist;
+  if (raw === void 0) return void 0;
+  try {
+    return JSON.parse(raw);
+  } catch {
+    process.stderr.write(JSON.stringify({ error: "Checklist must be valid JSON", code: "INVALID_JSON" }) + "\n");
+    process.exit(1);
+  }
+}
 function registerTaskList(program3) {
   program3.command("project:task:list").description(
     "List tasks for a project\n  Example: elevasis-sdk project:task:list --project <uuid> --status in_progress"
@@ -48142,7 +48192,10 @@ function registerTaskCreate(program3) {
   ).requiredOption("--project <project-id>", "Project ID (UUID)").requiredOption("--title <title>", "Task title / name").option("--status <status>", "Status: planned | in_progress | blocked | completed | cancelled").option(
     "--type <type>",
     "Type: documentation | code | report | design | refactor | feature | bug | research | other"
-  ).option("--milestone <milestone-id>", "Milestone ID (UUID)").option("--parent <parent-task-id>", "Parent task ID (UUID) for subtasks").option("--description <description>", "Task description").option("--checklist <json>", `Checklist items as JSON array: '[{"id":"1","label":"Step","completed":false}]'`).option("--api-url <url>", "API base URL").option("--pretty", "Render human-readable output instead of raw JSON").action(
+  ).option("--milestone <milestone-id>", "Milestone ID (UUID)").option("--parent <parent-task-id>", "Parent task ID (UUID) for subtasks").option("--description <description>", "Task description").option("--checklist <json>", `Checklist items as JSON array: '[{"id":"1","label":"Step","completed":false}]'`).option(
+    "--checklist-file <path>",
+    "Read checklist items from a JSON file. Relative paths resolve against the project root."
+  ).option("--api-url <url>", "API base URL").option("--pretty", "Render human-readable output instead of raw JSON").action(
     wrapAction(
       "project:task:create",
       async (options) => {
@@ -48155,16 +48208,8 @@ function registerTaskCreate(program3) {
         if (options.milestone) body.milestone_id = options.milestone;
         if (options.parent) body.parent_task_id = options.parent;
         if (options.description) body.description = options.description;
-        if (options.checklist) {
-          try {
-            body.checklist = JSON.parse(options.checklist);
-          } catch {
-            process.stderr.write(
-              JSON.stringify({ error: "--checklist must be valid JSON", code: "INVALID_JSON" }) + "\n"
-            );
-            process.exit(1);
-          }
-        }
+        const checklist = parseChecklistOption2(options);
+        if (checklist !== void 0) body.checklist = checklist;
         const apiUrl = resolveApiUrl(options.apiUrl);
         const result = await apiPost("/api/external/project-tasks", body, apiUrl);
         if (options.pretty) {
@@ -48185,7 +48230,10 @@ function registerTaskUpdate(program3) {
   program3.command("project:task:update <id>").description("Update a task\n  Example: elevasis-sdk project:task:update <uuid> --status completed").option("--title <title>", "New task title").option(
     "--status <status>",
     "New status: planned | in_progress | blocked | completed | cancelled | submitted | approved | rejected | revision_requested"
-  ).option("--milestone <milestone-id>", "New milestone ID (UUID)").option("--description <description>", "New description").option("--checklist <json>", `Replace checklist (full array): '[{"id":"1","label":"Step","completed":false}]'`).option("--api-url <url>", "API base URL").option("--pretty", "Render human-readable output instead of raw JSON").action(
+  ).option("--milestone <milestone-id>", "New milestone ID (UUID)").option("--description <description>", "New description").option("--checklist <json>", `Replace checklist (full array): '[{"id":"1","label":"Step","completed":false}]'`).option(
+    "--checklist-file <path>",
+    "Read replacement checklist from a JSON file. Relative paths resolve against the project root."
+  ).option("--api-url <url>", "API base URL").option("--pretty", "Render human-readable output instead of raw JSON").action(
     wrapAction(
       "project:task:update",
       async (id, options) => {
@@ -48194,20 +48242,12 @@ function registerTaskUpdate(program3) {
         if (options.status !== void 0) body.status = options.status;
         if (options.milestone !== void 0) body.milestone_id = options.milestone;
         if (options.description !== void 0) body.description = options.description;
-        if (options.checklist !== void 0) {
-          try {
-            body.checklist = JSON.parse(options.checklist);
-          } catch {
-            process.stderr.write(
-              JSON.stringify({ error: "--checklist must be valid JSON", code: "INVALID_JSON" }) + "\n"
-            );
-            process.exit(1);
-          }
-        }
+        const checklist = parseChecklistOption2(options);
+        if (checklist !== void 0) body.checklist = checklist;
         if (Object.keys(body).length === 0) {
           process.stderr.write(
             JSON.stringify({
-              error: "At least one field must be provided (--title, --status, --milestone, --description, --checklist)",
+              error: "At least one field must be provided (--title, --status, --milestone, --description, --checklist, --checklist-file)",
               code: "MISSING_FIELDS"
             }) + "\n"
           );
@@ -48634,6 +48674,15 @@ function registerProjectCommands(program3) {
 }
 
 // ../core/src/knowledge/queries.ts
+var DOMAIN_ITEM_KINDS = ["clients", "roles", "policies", "customers", "offerings", "goals"];
+var BARE_PREFIX_TO_DOMAIN = {
+  client: "clients",
+  role: "roles",
+  policy: "policies",
+  customer: "customers",
+  offering: "offerings",
+  goal: "goals"
+};
 function toGraphNodeId(omNodeId) {
   return `knowledge:${omNodeId}`;
 }
@@ -48782,11 +48831,32 @@ function parsePath(pathString) {
   if (first === "all-roles" && rest.length === 0) {
     return { mount: "all-roles", args: [] };
   }
+  if (first === "by-domain") {
+    if (rest.length === 0) {
+      throw new Error(`parsePath: /by-domain requires a domain argument, got: "${pathString}"`);
+    }
+    const domain2 = rest[0];
+    if (!DOMAIN_ITEM_KINDS.includes(domain2)) {
+      throw new Error(`parsePath: /by-domain unknown domain "${domain2}". Supported: ${DOMAIN_ITEM_KINDS.join(", ")}`);
+    }
+    return { mount: "by-domain", args: [domain2] };
+  }
+  if (first === "by-item") {
+    if (rest.length < 2) {
+      throw new Error(`parsePath: /by-item requires <domain>/<itemId>, got: "${pathString}"`);
+    }
+    const domain2 = rest[0];
+    if (!DOMAIN_ITEM_KINDS.includes(domain2)) {
+      throw new Error(`parsePath: /by-item unknown domain "${domain2}". Supported: ${DOMAIN_ITEM_KINDS.join(", ")}`);
+    }
+    const itemId = rest.slice(1).join("/");
+    return { mount: "by-item", args: [domain2, itemId] };
+  }
   if (segments.length === 1) {
     return { mount: "node", args: [first] };
   }
   throw new Error(
-    `parsePath: unrecognized path pattern "${pathString}". Supported: /by-system/<id>, /by-kind/<kind>, /by-owner/<id>, /graph/<nodeId>/governs, /graph/<nodeId>/governed-by, /<nodeId>, /all-systems, /all-resources, /all-roles`
+    `parsePath: unrecognized path pattern "${pathString}". Supported: /by-system/<id>, /by-kind/<kind>, /by-owner/<id>, /by-domain/<domain>, /by-item/<domain>/<itemId>, /graph/<nodeId>/governs, /graph/<nodeId>/governed-by, /<nodeId>, /all-systems, /all-resources, /all-roles`
   );
 }
 function omSearch(model, query, options = {}) {
@@ -48971,7 +49041,7 @@ function collectOntologyEntries(scope) {
     ["value-type", scope.valueTypes],
     ["property", scope.sharedProperties],
     ["group", scope.groups],
-    ["surface", scope.surfaces]
+    ["endpoint", scope.endpoints]
   ];
   for (const [subKind, records] of buckets) {
     if (!records) continue;
@@ -48995,12 +49065,26 @@ function collectOntologyEntries(scope) {
   return entries;
 }
 function detectKind(model, id) {
-  if (/:(object|action|event|catalog|link|interface|value-type|property|group|surface)\//.test(id)) {
+  if (/:(object|action|event|catalog|link|interface|value-type|property|group|endpoint)\//.test(id)) {
     return "ontology";
   }
   if (id.startsWith("knowledge.")) return "knowledge";
   if (id.startsWith("role.")) return "role";
   if (id.startsWith("policy.")) return "policy";
+  if (id.startsWith("item:")) {
+    const afterItem = id.slice("item:".length);
+    const colonIdx = afterItem.indexOf(":");
+    if (colonIdx > 0) {
+      const domain2 = afterItem.slice(0, colonIdx);
+      if (DOMAIN_ITEM_KINDS.includes(domain2)) return "domain-item";
+    }
+    return void 0;
+  }
+  const firstColon = id.indexOf(":");
+  if (firstColon > 0) {
+    const prefix = id.slice(0, firstColon);
+    if (prefix in BARE_PREFIX_TO_DOMAIN) return "domain-item";
+  }
   if (model.systems && getSystemByPath(model.systems, id)) return "system";
   if (model.resources?.[id]) return "resource";
   return void 0;
@@ -49033,6 +49117,8 @@ function omDescribe(model, id) {
       return describeRole(model, id);
     case "policy":
       return describePolicy(model, id);
+    case "domain-item":
+      return describeDomainItem(model, id);
   }
 }
 function describeSystem(model, path3) {
@@ -49069,7 +49155,7 @@ function describeSystem(model, path3) {
       ["value-type", ontology.valueTypes],
       ["property", ontology.sharedProperties],
       ["group", ontology.groups],
-      ["surface", ontology.surfaces]
+      ["endpoint", ontology.endpoints]
     ];
     for (const [k, records] of buckets) {
       const count = records ? Object.keys(records).length : 0;
@@ -49147,7 +49233,7 @@ function describeOntology(model, id) {
     ["value-type", "valueTypes"],
     ["property", "sharedProperties"],
     ["group", "groups"],
-    ["surface", "surfaces"]
+    ["endpoint", "endpoints"]
   ];
   const bucketKey = buckets.find((b) => b[0] === ontologyKind)?.[1];
   if (!bucketKey) return void 0;
@@ -49208,6 +49294,77 @@ function describePolicy(model, id) {
     effectKinds: (policy.actions ?? []).map((a) => a.kind)
   };
 }
+var DOMAIN_LABEL = {
+  clients: "Clients",
+  roles: "Roles",
+  policies: "Policies",
+  customers: "Customers",
+  offerings: "Offerings",
+  goals: "Goals"
+};
+var DOMAIN_GRAPH_PREFIX = {
+  clients: "client",
+  roles: "role",
+  policies: "policy",
+  customers: "customer-segment",
+  offerings: "offering",
+  goals: "goal"
+};
+function parseDomainItemRef(id) {
+  if (id.startsWith("item:")) {
+    const afterItem = id.slice("item:".length);
+    const colonIdx = afterItem.indexOf(":");
+    if (colonIdx <= 0) return void 0;
+    const domain3 = afterItem.slice(0, colonIdx);
+    const itemId2 = afterItem.slice(colonIdx + 1);
+    if (!DOMAIN_ITEM_KINDS.includes(domain3) || !itemId2) return void 0;
+    return { domain: domain3, itemId: itemId2 };
+  }
+  const firstColon = id.indexOf(":");
+  if (firstColon <= 0) return void 0;
+  const prefix = id.slice(0, firstColon);
+  const domain2 = BARE_PREFIX_TO_DOMAIN[prefix];
+  if (!domain2) return void 0;
+  const itemId = id.slice(firstColon + 1);
+  if (!itemId) return void 0;
+  return { domain: domain2, itemId };
+}
+function describeDomainItem(model, id) {
+  const parsed = parseDomainItemRef(id);
+  if (!parsed) return void 0;
+  const { domain: domain2, itemId } = parsed;
+  const collection = model[domain2];
+  const record2 = collection?.[itemId];
+  if (!record2) return void 0;
+  const name = domain2 === "clients" ? String(record2["name"] ?? itemId) : domain2 === "roles" ? String(record2["title"] ?? itemId) : domain2 === "policies" ? String(record2["label"] ?? itemId) : domain2 === "goals" ? String(record2["description"] ?? itemId) : String(record2["name"] ?? itemId);
+  const graphNodeId = `${DOMAIN_GRAPH_PREFIX[domain2]}:${itemId}`;
+  const containsParentIds = ["organization-model"];
+  const governingKnowledge = [];
+  for (const node of Object.values(model.knowledge ?? {})) {
+    const governs2 = (node.links ?? []).some((link) => link.nodeId === graphNodeId);
+    if (governs2) {
+      governingKnowledge.push({
+        id: node.id,
+        title: node.title,
+        knowledgeKind: node.kind
+      });
+    }
+  }
+  const canonicalId = `item:${domain2}:${itemId}`;
+  return {
+    kind: "domain-item",
+    id: canonicalId,
+    domain: domain2,
+    name,
+    location: {
+      domainLabel: DOMAIN_LABEL[domain2],
+      graphNodeId,
+      containsParentIds
+    },
+    record: record2,
+    governingKnowledge
+  };
+}
 
 // ../core/src/knowledge/format.ts
 function formatText(results) {
@@ -49269,6 +49426,8 @@ function formatOmDescribe(result) {
       return formatRoleDescribe(result);
     case "policy":
       return formatPolicyDescribe(result);
+    case "domain-item":
+      return formatDomainItemDescribe(result);
   }
 }
 function section(title, body) {
@@ -49391,6 +49550,180 @@ function formatPolicyDescribe(r) {
 ${appliesLines.join("\n")}` : "";
   return join5([header, effectSection, appliesSection]);
 }
+function formatDomainItemDescribe(r) {
+  const header = join5([
+    `Domain Item: ${r.id}`,
+    [
+      field("Domain", r.location.domainLabel),
+      field("Name", r.name),
+      field("Graph node", r.location.graphNodeId),
+      field("Parent nodes", r.location.containsParentIds.join(", "))
+    ].filter((s) => s.length > 0).join("\n")
+  ]);
+  const recordLines = [];
+  for (const [k, v] of Object.entries(r.record)) {
+    if (v === void 0 || v === null) continue;
+    if (typeof v === "object" && !Array.isArray(v) && Object.keys(v).length === 0) continue;
+    const display = Array.isArray(v) ? v.length === 0 ? null : `[${v.slice(0, 5).join(", ")}${v.length > 5 ? `, ...+${v.length - 5}` : ""}]` : typeof v === "object" ? JSON.stringify(v).slice(0, 120) : String(v);
+    if (display === null) continue;
+    recordLines.push(`  ${k}: ${display}`);
+  }
+  const recordSection = recordLines.length ? `Record:
+${recordLines.join("\n")}` : "";
+  const govLines = r.governingKnowledge.map((g) => `  - ${g.id} [${g.knowledgeKind}] ${g.title}`);
+  const govSection = govLines.length ? `Governing knowledge:
+${govLines.join("\n")}` : "Governing knowledge:\n  (none)";
+  return join5([header, recordSection, govSection]);
+}
+
+// ../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,37 +49783,9 @@ 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"
+    "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\n    elevasis-sdk om:ls /by-domain/clients\n    elevasis-sdk om:ls /by-item/clients/<uuid>"
   ).option("--json", "Print wrapped JSON envelope { path, mount, args, results }").option("--ids-only", "Print one ID per line (for piping)").action(
     wrapAction("knowledge:ls", async (pathArg, options) => {
       let parsed;
@@ -49501,7 +49806,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 +49818,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 +49830,50 @@ 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;
+      }
+      if (parsed.mount === "by-domain") {
+        const domain2 = parsed.args[0];
+        const collection = model[domain2] ?? {};
+        const ids = Object.keys(collection).map((id) => `item:${domain2}:${id}`);
+        if (options.json) {
+          process.stdout.write(formatJson({ path: pathArg, parsed, results: ids }) + "\n");
+        } else if (options.idsOnly) {
+          if (ids.length > 0) process.stdout.write(ids.join("\n") + "\n");
+        } else {
+          if (ids.length === 0) {
+            process.stdout.write(`(no items in domain "${domain2}")
+`);
+          } else {
+            process.stdout.write(`Domain: ${domain2}  (${ids.length} item${ids.length === 1 ? "" : "s"})
+`);
+            for (const id of ids) process.stdout.write(`  ${id}
+`);
+          }
+        }
+        return;
+      }
+      if (parsed.mount === "by-item") {
+        const domain2 = parsed.args[0];
+        const itemId = parsed.args[1];
+        const canonicalId = `item:${domain2}:${itemId}`;
+        const result = omDescribe(model, canonicalId);
+        if (!result) {
+          process.stderr.write(
+            `knowledge:ls: no item found for "${canonicalId}".
+  Use om:ls /by-domain/${domain2} to list all items in this domain.
+`
+          );
+          process.exit(1);
+        }
+        if (options.json) {
+          process.stdout.write(JSON.stringify(result, null, 2) + "\n");
+        } else if (options.idsOnly) {
+          process.stdout.write(result.id + "\n");
+        } else {
+          process.stdout.write(formatOmDescribe(result) + "\n");
         }
         return;
       }
@@ -49679,82 +50027,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,28 +50044,17 @@ 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");
     })
   );
 }
 
 // src/cli/commands/knowledge/generate.ts
-var import_node_fs4 = require("node:fs");
+var import_node_fs6 = require("node:fs");
 var import_node_path5 = require("node:path");
 
 // src/knowledge-codegen.ts
-var import_node_fs3 = require("node:fs");
+var import_node_fs5 = require("node:fs");
 var import_node_path4 = require("node:path");
 function targetFromNodeId2(nodeId2) {
   const [kind, ...idParts] = nodeId2.split(":");
@@ -49812,7 +50073,7 @@ function canonicalizeKnowledgeNodeLinks(node) {
   };
 }
 function listMdxFiles(directory) {
-  return (0, import_node_fs3.readdirSync)(directory, { withFileTypes: true }).flatMap((entry) => {
+  return (0, import_node_fs5.readdirSync)(directory, { withFileTypes: true }).flatMap((entry) => {
     const path3 = (0, import_node_path4.join)(directory, entry.name);
     if (entry.isDirectory()) return listMdxFiles(path3);
     return entry.isFile() && (0, import_node_path4.extname)(entry.name) === ".mdx" ? [path3] : [];
@@ -50010,7 +50271,7 @@ function readCommandForNode(node, cliCommand = "elevasis") {
   ];
 }
 function readKnowledgeNodeMdx(filePath) {
-  const raw = (0, import_node_fs3.readFileSync)(filePath, "utf8");
+  const raw = (0, import_node_fs5.readFileSync)(filePath, "utf8");
   const { frontmatter, body } = parseFrontmatter(raw, filePath);
   return {
     id: assertString(frontmatter, "id", filePath),
@@ -50125,8 +50386,8 @@ function generateKnowledgeNodes(options) {
     if (ids.has(node.id)) throw new Error(`[knowledge-node-codegen] Duplicate knowledge node id: ${node.id}`);
     ids.add(node.id);
   }
-  (0, import_node_fs3.mkdirSync)((0, import_node_path4.dirname)(options.outputPath), { recursive: true });
-  (0, import_node_fs3.writeFileSync)(
+  (0, import_node_fs5.mkdirSync)((0, import_node_path4.dirname)(options.outputPath), { recursive: true });
+  (0, import_node_fs5.writeFileSync)(
     options.outputPath,
     generateKnowledgeNodesTs({
       nodes,
@@ -50137,8 +50398,8 @@ function generateKnowledgeNodes(options) {
     "utf8"
   );
   if (options.knowledgeFlagsOutputPath) {
-    (0, import_node_fs3.mkdirSync)((0, import_node_path4.dirname)(options.knowledgeFlagsOutputPath), { recursive: true });
-    (0, import_node_fs3.writeFileSync)(
+    (0, import_node_fs5.mkdirSync)((0, import_node_path4.dirname)(options.knowledgeFlagsOutputPath), { recursive: true });
+    (0, import_node_fs5.writeFileSync)(
       options.knowledgeFlagsOutputPath,
       `${JSON.stringify(
         generateKnowledgeFlagRegistry(nodes, sourcePaths, {
@@ -50176,7 +50437,7 @@ function registerKnowledgeGenerate(program3) {
         projectRoot,
         options.flagsOutput ?? ".claude/registries/knowledge-flags.json"
       );
-      if (!(0, import_node_fs4.existsSync)(sourceDir)) {
+      if (!(0, import_node_fs6.existsSync)(sourceDir)) {
         process.stderr.write(`knowledge:generate: source directory not found: ${sourceDir}
 `);
         process.exitCode = 1;
@@ -50199,39 +50460,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 });
@@ -50254,7 +50489,7 @@ function registerKnowledgeSearch(program3) {
 init_config();
 function registerKnowledgeDescribe(program3) {
   program3.command("knowledge:describe <nodeId>").alias("om:describe").description(
-    "Show a structured neighborhood view for any OM node id\n  (system, resource, knowledge, ontology, role, policy \u2014 auto-detected from id shape)\n  Example: elevasis-sdk om:describe sales.lead-gen\n  Example: elevasis-sdk om:describe knowledge.outreach-playbook"
+    "Show a structured neighborhood view for any OM node id\n  (system, resource, knowledge, ontology, role, policy, domain-item \u2014 auto-detected)\n  Domain items: item:<domain>:<id>  OR bare client:<uuid>, role:<id>, etc.\n  Example: elevasis-sdk om:describe sales.lead-gen\n  Example: elevasis-sdk om:describe knowledge.outreach-playbook\n  Example: elevasis-sdk om:describe item:clients:<uuid>\n  Example: elevasis-sdk om:describe client:<uuid>  (back-compat bare form)\n  Note: for portfolio/DB data (deals, lineage) use client:get <id> instead."
   ).option("--json", "Print as JSON").action(
     wrapAction("knowledge:describe", async (nodeId2, options) => {
       const projectRoot = getProjectRoot();
@@ -50262,7 +50497,11 @@ function registerKnowledgeDescribe(program3) {
       const result = omDescribe(model, nodeId2);
       if (!result) {
         process.stderr.write(
-          `knowledge:describe: no OM node found for id "${nodeId2}". Use knowledge:search (alias: om:search) to discover nodes by keyword.
+          `knowledge:describe: no OM node found for id "${nodeId2}".
+  - For domain items use: om:describe item:<domain>:<id>  (domains: clients, roles, policies, customers, offerings, goals)
+  - Bare forms also work:  om:describe client:<uuid>, om:describe role:<id>, etc.
+  - To find nodes by keyword: om:search <keyword>
+  - To list all items in a domain: om:ls /by-domain/<domain>
 `
         );
         process.exit(1);
@@ -50288,7 +50527,7 @@ function registerKnowledgeCommands(program3) {
 }
 
 // src/cli/commands/request/request.ts
-var import_node_fs5 = require("node:fs");
+var import_node_fs7 = require("node:fs");
 var import_node_path6 = require("node:path");
 init_source();
 init_config();
@@ -50353,7 +50592,7 @@ function registerRequestCommands(program3) {
         throw new Error("Provide --input <json> or --input-file <path>");
       }
       const resolvedInputFile = options.inputFile ? resolveProjectRelative(options.inputFile) : void 0;
-      const raw = resolvedInputFile ? JSON.parse((0, import_node_fs5.readFileSync)(resolvedInputFile, "utf8")) : JSON.parse(options.input);
+      const raw = resolvedInputFile ? JSON.parse((0, import_node_fs7.readFileSync)(resolvedInputFile, "utf8")) : JSON.parse(options.input);
       const parsed = CreateRequestInputSchema.safeParse(raw);
       if (!parsed.success) {
         const issues = parsed.error.issues.map((i) => `  - ${i.path.join(".") || "(root)"}: ${i.message}`).join("\n");
@@ -50377,7 +50616,7 @@ ${issues}`);
         const tmpDir = (0, import_node_path6.join)(getProjectRoot(), "tmp");
         if (resolvedInputFile.startsWith(tmpDir + "/") || resolvedInputFile.startsWith(tmpDir + "\\")) {
           try {
-            (0, import_node_fs5.unlinkSync)(resolvedInputFile);
+            (0, import_node_fs7.unlinkSync)(resolvedInputFile);
           } catch {
           }
         } else {
@@ -50446,7 +50685,7 @@ ${rows.length} request${rows.length === 1 ? "" : "s"}`));
 
 // src/cli/commands/ui/ui-switcher.ts
 var import_node_child_process = require("node:child_process");
-var import_node_fs6 = __toESM(require("node:fs"), 1);
+var import_node_fs8 = __toESM(require("node:fs"), 1);
 var import_node_path7 = __toESM(require("node:path"), 1);
 init_config();
 function run(command, args, cwd) {
@@ -50457,10 +50696,10 @@ function run(command, args, cwd) {
   });
 }
 function readJson(filePath) {
-  return JSON.parse(import_node_fs6.default.readFileSync(filePath, "utf8"));
+  return JSON.parse(import_node_fs8.default.readFileSync(filePath, "utf8"));
 }
 function writeJson(filePath, value) {
-  import_node_fs6.default.writeFileSync(filePath, `${JSON.stringify(value, null, 2)}
+  import_node_fs8.default.writeFileSync(filePath, `${JSON.stringify(value, null, 2)}
 `);
 }
 function requireDependencies(packageJson, filePath) {
@@ -50471,7 +50710,7 @@ function requireDependencies(packageJson, filePath) {
 }
 function resolveExistingDir(label, dir) {
   const resolved = import_node_path7.default.resolve(dir);
-  if (!import_node_fs6.default.existsSync(resolved) || !import_node_fs6.default.statSync(resolved).isDirectory()) {
+  if (!import_node_fs8.default.existsSync(resolved) || !import_node_fs8.default.statSync(resolved).isDirectory()) {
     throw new Error(`${label} not found: ${resolved}`);
   }
   return resolved;
@@ -50479,7 +50718,7 @@ function resolveExistingDir(label, dir) {
 function findRepoRootFromProject(projectRoot) {
   let dir = projectRoot;
   while (true) {
-    if (import_node_fs6.default.existsSync(import_node_path7.default.join(dir, "packages", "ui", "package.json"))) return dir;
+    if (import_node_fs8.default.existsSync(import_node_path7.default.join(dir, "packages", "ui", "package.json"))) return dir;
     const parent = import_node_path7.default.dirname(dir);
     if (parent === dir) return null;
     dir = parent;
@@ -50496,10 +50735,10 @@ function resolveUiPackageRoot(projectRoot, explicitRoot) {
   return import_node_path7.default.join(repoRoot, "packages", "ui");
 }
 function removeLocalUiTarballs(templateTmpDir) {
-  if (!import_node_fs6.default.existsSync(templateTmpDir)) return;
-  for (const entry of import_node_fs6.default.readdirSync(templateTmpDir)) {
+  if (!import_node_fs8.default.existsSync(templateTmpDir)) return;
+  for (const entry of import_node_fs8.default.readdirSync(templateTmpDir)) {
     if (entry.startsWith("elevasis-ui-") && entry.endsWith(".tgz")) {
-      import_node_fs6.default.rmSync(import_node_path7.default.join(templateTmpDir, entry), { force: true });
+      import_node_fs8.default.rmSync(import_node_path7.default.join(templateTmpDir, entry), { force: true });
     }
   }
 }
@@ -50524,24 +50763,24 @@ function useLocalUi(options = {}) {
   const templateTmpDir = import_node_path7.default.join(projectRoot, "tmp");
   const uiPackageJsonPath = import_node_path7.default.join(uiPackageRoot, "package.json");
   const uiPackageBackupPath = import_node_path7.default.join(uiPackageRoot, "package.json.local-pack.bak");
-  if (!import_node_fs6.default.existsSync(templateUiPackageJsonPath)) {
+  if (!import_node_fs8.default.existsSync(templateUiPackageJsonPath)) {
     throw new Error(`Template UI package.json not found: ${templateUiPackageJsonPath}`);
   }
-  import_node_fs6.default.mkdirSync(templateTmpDir, { recursive: true });
+  import_node_fs8.default.mkdirSync(templateTmpDir, { recursive: true });
   removeLocalUiTarballs(templateTmpDir);
   run("pnpm", ["--filter", "@repo/ui", "build:publish"], commandRoot);
   try {
-    const raw = import_node_fs6.default.readFileSync(uiPackageJsonPath, "utf8");
-    import_node_fs6.default.writeFileSync(uiPackageBackupPath, raw);
+    const raw = import_node_fs8.default.readFileSync(uiPackageJsonPath, "utf8");
+    import_node_fs8.default.writeFileSync(uiPackageBackupPath, raw);
     writeJson(uiPackageJsonPath, prepareUiPackageForPack(JSON.parse(raw)));
     run("pnpm", ["-C", uiPackageRoot, "pack", "--pack-destination", templateTmpDir], commandRoot);
   } finally {
-    if (import_node_fs6.default.existsSync(uiPackageBackupPath)) {
-      import_node_fs6.default.copyFileSync(uiPackageBackupPath, uiPackageJsonPath);
-      import_node_fs6.default.rmSync(uiPackageBackupPath, { force: true });
+    if (import_node_fs8.default.existsSync(uiPackageBackupPath)) {
+      import_node_fs8.default.copyFileSync(uiPackageBackupPath, uiPackageJsonPath);
+      import_node_fs8.default.rmSync(uiPackageBackupPath, { force: true });
     }
   }
-  const tarballName = import_node_fs6.default.readdirSync(templateTmpDir).find((entry) => entry.startsWith("elevasis-ui-") && entry.endsWith(".tgz"));
+  const tarballName = import_node_fs8.default.readdirSync(templateTmpDir).find((entry) => entry.startsWith("elevasis-ui-") && entry.endsWith(".tgz"));
   if (!tarballName) {
     throw new Error(`Failed to create local @elevasis/ui tarball in ${templateTmpDir}`);
   }
@@ -50562,7 +50801,7 @@ function usePublishedUi(options = {}) {
   if (!uiVersion) {
     throw new Error("Could not determine @elevasis/ui version. Pass --version <version>.");
   }
-  if (!import_node_fs6.default.existsSync(templateUiPackageJsonPath)) {
+  if (!import_node_fs8.default.existsSync(templateUiPackageJsonPath)) {
     throw new Error(`Template UI package.json not found: ${templateUiPackageJsonPath}`);
   }
   const templateUiPackageJson = readJson(templateUiPackageJsonPath);
@@ -50588,7 +50827,7 @@ function registerUiCommands(program3) {
 }
 
 // src/cli/commands/doctor.ts
-var import_node_fs7 = require("node:fs");
+var import_node_fs9 = require("node:fs");
 var import_node_path8 = __toESM(require("node:path"), 1);
 init_source();
 init_config();
@@ -50628,7 +50867,7 @@ function registerDoctorCommand(program3) {
       process.exit(1);
     }
     const envPath2 = import_node_path8.default.join(projectRoot, ".env");
-    const envExists = (0, import_node_fs7.existsSync)(envPath2);
+    const envExists = (0, import_node_fs9.existsSync)(envPath2);
     if (!envExists) {
       fail(".env", `Not found at ${envPath2}. Create it from .env.example and fill in ELEVASIS_PLATFORM_KEY.`);
       if (isVerbose) verbose(`Checked: ${envPath2}`);
@@ -51851,6 +52090,52 @@ function registerSkillScaffoldCommand(program3) {
   );
 }
 
+// src/cli/json-file-argv.ts
+var import_node_fs14 = require("node:fs");
+var import_node_path16 = require("node:path");
+init_config();
+var JSON_FILE_PREFIX = "@json:";
+var JsonFileArgError = class extends Error {
+  constructor(message, code) {
+    super(message);
+    this.code = code;
+    this.name = "JsonFileArgError";
+  }
+};
+function resolveJsonFilePath(path3, options) {
+  if (path3.trim() === "") {
+    throw new JsonFileArgError("@json: requires a file path", "EMPTY_JSON_FILE_REF");
+  }
+  if ((0, import_node_path16.isAbsolute)(path3)) return path3;
+  const cwd = options.cwd ?? process.cwd();
+  const projectRoot = (options.findProjectRoot ?? tryFindProjectRoot)(cwd);
+  return (0, import_node_path16.resolve)(projectRoot ?? cwd, path3);
+}
+function readJsonFileReference(ref, options) {
+  const relativeOrAbsolutePath = ref.slice(JSON_FILE_PREFIX.length);
+  const resolvedPath = resolveJsonFilePath(relativeOrAbsolutePath, options);
+  const raw = (options.readFile ?? ((path3) => (0, import_node_fs14.readFileSync)(path3, "utf8")))(resolvedPath);
+  try {
+    JSON.parse(raw);
+  } catch {
+    throw new JsonFileArgError(`@json file must contain valid JSON: ${relativeOrAbsolutePath}`, "INVALID_JSON_FILE");
+  }
+  return raw;
+}
+function expandArg(arg, options) {
+  if (arg.startsWith(JSON_FILE_PREFIX)) {
+    return readJsonFileReference(arg, options);
+  }
+  const equalsRefIndex = arg.indexOf(`=${JSON_FILE_PREFIX}`);
+  if (equalsRefIndex === -1) return arg;
+  const prefix = arg.slice(0, equalsRefIndex + 1);
+  const ref = arg.slice(equalsRefIndex + 1);
+  return `${prefix}${readJsonFileReference(ref, options)}`;
+}
+function expandJsonFileArgs(args, options = {}) {
+  return args.map((arg) => expandArg(arg, options));
+}
+
 // src/cli/index.ts
 init_config();
 var PREFLIGHT_SKIP_FLAGS = /* @__PURE__ */ new Set(["--help", "-h", "--version", "-V"]);
@@ -51986,7 +52271,15 @@ registerCliCatalogCommand(program2);
 registerOmScaffoldCommands(program2);
 registerSkillScaffoldCommand(program2);
 registerSkillCheckCoverageCommand(program2);
-program2.parse();
+try {
+  program2.parse(expandJsonFileArgs(process.argv), { from: "node" });
+} catch (error46) {
+  if (error46 instanceof JsonFileArgError) {
+    process.stderr.write(JSON.stringify({ error: error46.message, code: error46.code }) + "\n");
+    process.exit(1);
+  }
+  throw error46;
+}
 // Annotate the CommonJS export names for ESM import in node:
 0 && (module.exports = {
   getProjectRoot