@elevasis/sdk 1.33.1 → 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 ?? ""));
     });
   });
 }
@@ -23741,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);
     }
@@ -23752,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 {
         }
       }
@@ -23773,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));
@@ -23790,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");
   }
 });
@@ -24168,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();
@@ -24261,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.
@@ -24273,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(
@@ -24394,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.`
@@ -24408,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();
@@ -37533,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);
@@ -37605,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({
@@ -37618,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: {
@@ -37654,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) {
@@ -37690,7 +37687,7 @@ function createEmptyIndex() {
     valueTypes: {},
     sharedProperties: {},
     groups: {},
-    surfaces: {}
+    endpoints: {}
   };
 }
 function sortResolvedOntologyIndex(index) {
@@ -37923,7 +37920,7 @@ var ONTOLOGY_REFERENCE_KEY_KINDS = {
   interfaceType: "interface",
   propertyType: "property",
   groupType: "group",
-  surfaceType: "surface",
+  endpointType: "endpoint",
   stepCatalog: "catalog"
 };
 var omCompilationContextCache = /* @__PURE__ */ new WeakMap();
@@ -37951,7 +37948,7 @@ function buildOmCrossRefIndexFromOntology(model, ontologyCompilation) {
     "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();
@@ -41873,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) {
@@ -45734,7 +45731,7 @@ function wrapAction(commandName, fn) {
 // package.json
 var package_default = {
   name: "@elevasis/sdk",
-  version: "1.33.1",
+  version: "1.34.0",
   description: "SDK for building Elevasis organization resources",
   type: "module",
   bin: {
@@ -46577,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;
     }
@@ -47213,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");
     });
   });
 }
@@ -47970,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) => {
@@ -48031,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) => {
@@ -48040,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"
           );
@@ -48091,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"
@@ -48160,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) => {
@@ -48173,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) {
@@ -48203,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) => {
@@ -48212,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"
           );
@@ -48652,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}`;
 }
@@ -48800,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 = {}) {
@@ -48989,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;
@@ -49013,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;
@@ -49051,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) {
@@ -49087,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;
@@ -49165,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;
@@ -49226,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) {
@@ -49287,6 +49426,8 @@ function formatOmDescribe(result) {
       return formatRoleDescribe(result);
     case "policy":
       return formatPolicyDescribe(result);
+    case "domain-item":
+      return formatDomainItemDescribe(result);
   }
 }
 function section(title, body) {
@@ -49409,6 +49550,31 @@ 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"];
@@ -49619,7 +49785,7 @@ async function loadOrgModel(projectRoot) {
 // src/cli/commands/knowledge/ls.ts
 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;
@@ -49668,6 +49834,49 @@ function registerKnowledgeLs(program3) {
         }
         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;
+      }
       const graph = buildOrganizationGraph({ organizationModel: model });
       const knowledgeNodes = Object.values(model.knowledge);
       let results;
@@ -49841,11 +50050,11 @@ function registerKnowledgeSkills(program3) {
 }
 
 // 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(":");
@@ -49864,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] : [];
@@ -50062,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),
@@ -50177,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,
@@ -50189,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, {
@@ -50228,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;
@@ -50280,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();
@@ -50288,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);
@@ -50314,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();
@@ -50379,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");
@@ -50403,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 {
@@ -50472,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) {
@@ -50483,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) {
@@ -50497,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;
@@ -50505,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;
@@ -50522,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 });
     }
   }
 }
@@ -50550,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}`);
   }
@@ -50588,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);
@@ -50614,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();
@@ -50654,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}`);
@@ -51877,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"]);
@@ -52012,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