@elevasis/sdk 1.36.4 → 1.37.0

package/dist/cli.cjs

@@ -38577,17 +38577,48 @@ var SYSTEM_INTERFACE_PROFILES = [
 var SYSTEM_INTERFACE_READINESS_PROFILES = SYSTEM_INTERFACE_PROFILES.map(
   (profile) => profile.readinessProfile
 );
-var SystemInterfaceReadinessProfileSchema = external_exports.enum(SYSTEM_INTERFACE_READINESS_PROFILES);
+var SystemInterfaceReadinessProfileSchema = external_exports.string().trim().min(1);
 var SystemInterfaceResourceScopeSchema = external_exports.array(ModelIdSchema).default([]);
+var SystemApiInterfaceReadinessContractSchema = external_exports.object({
+  /** Ontology IDs of object types the interface depends on. */
+  requiredObjects: external_exports.array(external_exports.string().trim().min(1)).default([]),
+  /** Ontology IDs of catalog types the interface requires (must be non-empty). */
+  requiredCatalogs: external_exports.array(external_exports.string().trim().min(1)).default([]),
+  /** Optional ontology kind filters (reserved for future profile extensions). */
+  requiredKinds: external_exports.array(external_exports.string().trim().min(1)).optional()
+}).strict();
 var SystemApiInterfaceSchema = external_exports.object({
   lifecycle: SystemInterfaceLifecycleSchema.default("active"),
+  /**
+   * Open-string profile id. Built-in platform presets are looked up through
+   * the profile registry; custom ids are validated structurally via
+   * `readinessContract`. Optional — `profileForInterface` provides a default.
+   */
   readinessProfile: SystemInterfaceReadinessProfileSchema.optional(),
   /**
    * Resource ids that participate in this API interface. This scopes readiness
    * derivation without duplicating authored required/provided contract refs.
    */
-  resourceIds: SystemInterfaceResourceScopeSchema.optional()
+  resourceIds: SystemInterfaceResourceScopeSchema.optional(),
+  /**
+   * Tenant-authorable readiness declaration. Required for custom
+   * (non-built-in) profile ids so structural validation can proceed. Built-in
+   * profiles ignore this field (requirements are derived from platform code).
+   */
+  readinessContract: SystemApiInterfaceReadinessContractSchema.optional()
 }).strict();
+var _profileRegistry = new Map(
+  SYSTEM_INTERFACE_READINESS_PROFILES.map((profileId) => [
+    profileId,
+    { profileId, kind: "built-in" }
+  ])
+);
+function profileForInterface(systemPath, interfaceKey, readinessProfile) {
+  return readinessProfile ?? `${systemPath}.${interfaceKey}`;
+}
+function isBuiltInReadinessProfile(profileId) {
+  return _profileRegistry.get(profileId)?.kind === "built-in";
+}
 var SystemInterfaceRefSchema = external_exports.object({
   systemPath: SystemPathSchema,
   interfaceKey: SystemInterfaceKeySchema
@@ -41491,14 +41522,11 @@ function addReadinessIssue(issues, family, code, message, details = {}) {
 function formatInterfaceIdentity(systemPath, interfaceKey) {
   return `${systemPath}/${interfaceKey}`;
 }
-function profileForInterface(systemPath, interfaceKey, readinessProfile) {
-  return readinessProfile ?? `${systemPath}.${interfaceKey}`;
-}
 function readinessMarkerPath(context) {
   return context.interfaceKey === "api" ? `systems.${context.systemPath}.apiInterface` : `systems.${context.systemPath}.derivedCrmHandoffReadiness`;
 }
 function formatSupportedReadinessProfiles() {
-  return SYSTEM_INTERFACE_READINESS_PROFILES.map((profile) => `"${profile}"`).join(", ");
+  return SYSTEM_INTERFACE_PROFILES.map((p) => `"${p.readinessProfile}"`).join(", ");
 }
 function getActiveScopedResources(model, resourceIds, issues, context) {
   const resources = [];
@@ -41690,9 +41718,6 @@ function getLeadGenCrmHandoffResourceIds(model) {
 function getSystemInterfaceReadinessMarker(model, request) {
   const system = getSystem(model, request.systemPath);
   if (system === void 0) return void 0;
-  if (request.interfaceKey === LEAD_GEN_API_INTERFACE.interfaceKey) {
-    return system.apiInterface;
-  }
   if (request.systemPath === LEAD_GEN_CRM_HANDOFF_INTERFACE.systemPath && request.interfaceKey === LEAD_GEN_CRM_HANDOFF_INTERFACE.interfaceKey) {
     return {
       lifecycle: "active",
@@ -41700,6 +41725,9 @@ function getSystemInterfaceReadinessMarker(model, request) {
       resourceIds: getLeadGenCrmHandoffResourceIds(model)
     };
   }
+  if (request.interfaceKey === "api" && system.apiInterface !== void 0) {
+    return system.apiInterface;
+  }
   return void 0;
 }
 function mergeLeadGenDerivedCatalogs(model) {
@@ -41744,6 +41772,18 @@ function tryCompileBusinessOntology(model, readinessProfile, issues) {
     return void 0;
   }
 }
+function requireContractReadiness(issues, index, resources, contract, context) {
+  const reads = resourceBindingIds(resources, "reads");
+  const catalogs = resourceBindingIds(resources, "usesCatalogs");
+  for (const objectId of contract.requiredObjects) {
+    requireObjectReadiness(issues, index, objectId, context);
+    requireScopedBinding(issues, reads, "reads", objectId, context);
+  }
+  for (const catalogId of contract.requiredCatalogs) {
+    requireCatalogReadiness(issues, index, catalogId, context);
+    requireScopedBinding(issues, catalogs, "usesCatalogs", catalogId, context);
+  }
+}
 function computeInterfaceReadiness(model, request) {
   const issues = [];
   const system = getSystem(model, request.systemPath);
@@ -41791,20 +41831,22 @@ function computeInterfaceReadiness(model, request) {
       { path: `${readinessMarkerPath(request)}.lifecycle` }
     );
   }
-  const supportedProfile = readinessProfile !== void 0 && SYSTEM_INTERFACE_PROFILES.some((profile) => profile.readinessProfile === readinessProfile);
-  if (!supportedProfile) {
+  const checkedReadinessProfile = readinessProfile ?? profileForInterface(request.systemPath, request.interfaceKey);
+  const isBuiltIn = isBuiltInReadinessProfile(checkedReadinessProfile);
+  const readinessContract = systemInterface.readinessContract;
+  if (!isBuiltIn && readinessContract === void 0) {
     addReadinessIssue(
       issues,
       "SYSTEM_INTERFACE_INVALID",
-      "unknown-readiness-profile",
-      `System Interface "${formatInterfaceIdentity(request.systemPath, request.interfaceKey)}" references unknown readiness profile "${readinessProfile}". Supported profiles: ${formatSupportedReadinessProfiles()}. Custom Systems should not declare apiInterface; route custom behavior through workflows/operations plus ontology, resources, and topology.`,
-      { path: `${readinessMarkerPath(request)}.readinessProfile`, ref: readinessProfile }
+      "missing-readiness-contract",
+      `System Interface "${formatInterfaceIdentity(request.systemPath, request.interfaceKey)}" uses custom readiness profile "${checkedReadinessProfile}" but declares no readinessContract. Built-in profiles: ${formatSupportedReadinessProfiles()}.`,
+      { path: `${readinessMarkerPath(request)}.readinessContract`, ref: checkedReadinessProfile }
     );
     return {
       ready: false,
       systemPath: request.systemPath,
       interfaceKey: request.interfaceKey,
-      readinessProfile,
+      readinessProfile: checkedReadinessProfile,
       scopedResourceIds,
       issues
     };
@@ -41818,10 +41860,6 @@ function computeInterfaceReadiness(model, request) {
       { path: `${readinessMarkerPath(request)}.resourceIds` }
     );
   }
-  const checkedReadinessProfile = readinessProfile;
-  if (checkedReadinessProfile === void 0) {
-    throw new Error("Supported readiness profile unexpectedly resolved to undefined");
-  }
   const resources = getActiveScopedResources(model, scopedResourceIds, issues, request);
   const index = tryCompileBusinessOntology(model, checkedReadinessProfile, issues);
   if (index !== void 0) {
@@ -41833,13 +41871,15 @@ function computeInterfaceReadiness(model, request) {
       requireLeadGenInterfaceReadiness(issues, index, resources, request);
       requireCrmInterfaceReadiness(issues, index, resources, { ...request, allowForeignOwner: true });
       requireHandoffBridgeReadiness(issues, model, request);
+    } else if (readinessContract !== void 0) {
+      requireContractReadiness(issues, index, resources, readinessContract, request);
     }
   }
   return {
     ready: issues.length === 0,
     systemPath: request.systemPath,
     interfaceKey: request.interfaceKey,
-    readinessProfile,
+    readinessProfile: checkedReadinessProfile,
     scopedResourceIds,
     issues
   };
@@ -45808,7 +45848,7 @@ function wrapAction(commandName, fn) {
 // package.json
 var package_default = {
   name: "@elevasis/sdk",
-  version: "1.36.4",
+  version: "1.37.0",
   description: "SDK for building Elevasis organization resources",
   type: "module",
   bin: {
@@ -47834,8 +47874,11 @@ Resolved client: ${client.name}`));
 }
 
 // src/cli/commands/project/projects.ts
+function printJson2(value) {
+  console.log(JSON.stringify(value, null, 2));
+}
 function registerProjectList(program3) {
-  program3.command("project:list").description("List projects\n  Example: elevasis-sdk project:list --search alpha").option("--kind <kind>", "Filter by kind: client_engagement | internal | research | other").option("--status <status>", "Filter by status: active | on_track | at_risk | blocked | completed | paused").option("--search <query>", "Search by project name or description").option("--client <id-or-name>", "Filter by client hub record (UUID or fuzzy name)").option("--api-url <url>", "API base URL").option("--pretty", "Render human-readable output instead of raw JSON").action(
+  program3.command("project:list").description("List projects\n  Example: elevasis-sdk project:list --search alpha").option("--kind <kind>", "Filter by kind: client_engagement | internal | research | other").option("--status <status>", "Filter by status: active | on_track | at_risk | blocked | completed | paused").option("--search <query>", "Search by project name or description").option("--client <id-or-name>", "Filter by client hub record (UUID or fuzzy name)").option("--api-url <url>", "API base URL").option("--pretty", "Render human-readable output instead of raw JSON").option("--json", "Output as JSON").action(
     wrapAction(
       "project:list",
       async (options) => {
@@ -47853,6 +47896,10 @@ function registerProjectList(program3) {
         const qs = params.toString();
         const endpoint = `/api/external/projects${qs ? `?${qs}` : ""}`;
         const result = await apiGet(endpoint, apiUrl);
+        if (options.json) {
+          printJson2(result);
+          return;
+        }
         if (options.pretty) {
           const projects = result.projects;
           if (projects.length === 0) {
@@ -47878,9 +47925,13 @@ Projects (${projects.length}):
 function registerProjectResolve(program3) {
   program3.command("project:resolve <query>").description(
     'Resolve a project ID from a name, UUID, or search query\n  Example: elevasis-sdk project:resolve "Alpha"'
-  ).option("--api-url <url>", "API base URL").option("--pretty", "Render project details instead of only the resolved ID").action(
+  ).option("--api-url <url>", "API base URL").option("--pretty", "Render project details instead of only the resolved ID").option("--json", "Output as JSON").action(
     wrapAction("project:resolve", async (query, options) => {
       const project = await resolveProject(query, options.apiUrl);
+      if (options.json) {
+        printJson2(project);
+        return;
+      }
       if (options.pretty) {
         console.log(source_default.cyan(`
 Resolved project: ${project.name}`));
@@ -47918,10 +47969,14 @@ ${renderProjectWorkBrief(brief)}
   );
 }
 function registerProjectGet(program3) {
-  program3.command("project:get <id>").description("Get a project by ID\n  Example: elevasis-sdk project:get <uuid>").option("--api-url <url>", "API base URL").option("--pretty", "Render human-readable output instead of raw JSON").action(
+  program3.command("project:get <id>").description("Get a project by ID\n  Example: elevasis-sdk project:get <uuid>").option("--api-url <url>", "API base URL").option("--pretty", "Render human-readable output instead of raw JSON").option("--json", "Output as JSON").action(
     wrapAction("project:get", async (id, options) => {
       const apiUrl = resolveApiUrl(options.apiUrl);
       const result = await apiGet(`/api/external/projects/${id}`, apiUrl);
+      if (options.json) {
+        printJson2(result);
+        return;
+      }
       if (options.pretty) {
         const p = result.project;
         console.log(source_default.cyan(`
@@ -47938,7 +47993,7 @@ Project: ${p.name}`));
   );
 }
 function registerProjectCreate(program3) {
-  program3.command("project:create").description('Create a new project\n  Example: elevasis-sdk project:create --name "My Project" --kind internal').requiredOption("--name <name>", "Project name").requiredOption("--kind <kind>", "Project kind: client_engagement | internal | research | other").option("--status <status>", "Project status: active | on_track | at_risk | blocked | completed | paused").option("--description <description>", "Project description").option("--deal-id <uuid>", "Link to a deal (UUID)").option("--client <id-or-name>", "Link to a client hub record (UUID or fuzzy name)").option("--client-company-id <uuid>", "Link to a client company (UUID)").option("--start-date <date>", "Start date (ISO 8601, e.g. 2026-06-01)").option("--target-end-date <date>", "Target end date (ISO 8601, e.g. 2026-12-31)").option("--contract-value <amount>", "Contract value (number)", parseFloat).option("--metadata <json>", "Arbitrary metadata (JSON string)").option("--api-url <url>", "API base URL").option("--pretty", "Render human-readable output instead of raw JSON").action(
+  program3.command("project:create").description('Create a new project\n  Example: elevasis-sdk project:create --name "My Project" --kind internal').requiredOption("--name <name>", "Project name").requiredOption("--kind <kind>", "Project kind: client_engagement | internal | research | other").option("--status <status>", "Project status: active | on_track | at_risk | blocked | completed | paused").option("--description <description>", "Project description").option("--deal-id <uuid>", "Link to a deal (UUID)").option("--client <id-or-name>", "Link to a client hub record (UUID or fuzzy name)").option("--client-company-id <uuid>", "Link to a client company (UUID)").option("--start-date <date>", "Start date (ISO 8601, e.g. 2026-06-01)").option("--target-end-date <date>", "Target end date (ISO 8601, e.g. 2026-12-31)").option("--contract-value <amount>", "Contract value (number)", parseFloat).option("--metadata <json>", "Arbitrary metadata (JSON string)").option("--api-url <url>", "API base URL").option("--pretty", "Render human-readable output instead of raw JSON").option("--json", "Output as JSON").action(
     wrapAction(
       "project:create",
       async (options) => {
@@ -47962,6 +48017,10 @@ function registerProjectCreate(program3) {
         if (options.contractValue !== void 0) body.contract_value = options.contractValue;
         if (options.metadata) body.metadata = JSON.parse(options.metadata);
         const result = await apiPost("/api/external/projects", body, apiUrl);
+        if (options.json) {
+          printJson2(result);
+          return;
+        }
         if (options.pretty) {
           const p = result.project;
           console.log(source_default.green(`
@@ -47978,7 +48037,7 @@ Project created: ${p.name}`));
   );
 }
 function registerProjectUpdate(program3) {
-  program3.command("project:update <id>").description("Update a project\n  Example: elevasis-sdk project:update <uuid> --status completed").option("--name <name>", "New project name").option("--status <status>", "New status: active | on_track | at_risk | blocked | completed | paused").option("--description <description>", "New description").option("--deal-id <uuid>", "Link to a deal (UUID)").option("--client <id-or-name>", "Link to a client hub record (UUID or fuzzy name)").option("--clear-client", "Remove the client hub link (sets client_id to null)").option("--client-company-id <uuid>", "Link to a client company (UUID)").option("--start-date <date>", "Start date (ISO 8601, e.g. 2026-06-01)").option("--target-end-date <date>", "Target end date (ISO 8601, e.g. 2026-12-31)").option("--actual-end-date <date>", "Actual end date (ISO 8601)").option("--contract-value <amount>", "Contract value (number)", parseFloat).option("--metadata <json>", "Arbitrary metadata (JSON string)").option("--api-url <url>", "API base URL").option("--pretty", "Render human-readable output instead of raw JSON").action(
+  program3.command("project:update <id>").description("Update a project\n  Example: elevasis-sdk project:update <uuid> --status completed").option("--name <name>", "New project name").option("--status <status>", "New status: active | on_track | at_risk | blocked | completed | paused").option("--description <description>", "New description").option("--deal-id <uuid>", "Link to a deal (UUID)").option("--client <id-or-name>", "Link to a client hub record (UUID or fuzzy name)").option("--clear-client", "Remove the client hub link (sets client_id to null)").option("--client-company-id <uuid>", "Link to a client company (UUID)").option("--start-date <date>", "Start date (ISO 8601, e.g. 2026-06-01)").option("--target-end-date <date>", "Target end date (ISO 8601, e.g. 2026-12-31)").option("--actual-end-date <date>", "Actual end date (ISO 8601)").option("--contract-value <amount>", "Contract value (number)", parseFloat).option("--metadata <json>", "Arbitrary metadata (JSON string)").option("--api-url <url>", "API base URL").option("--pretty", "Render human-readable output instead of raw JSON").option("--json", "Output as JSON").action(
     wrapAction(
       "project:update",
       async (id, options) => {
@@ -48021,6 +48080,10 @@ function registerProjectUpdate(program3) {
         }
         const apiUrl = resolveApiUrl(options.apiUrl);
         const result = await apiPatch(`/api/external/projects/${id}`, body, apiUrl);
+        if (options.json) {
+          printJson2(result);
+          return;
+        }
         if (options.pretty) {
           const p = result.project;
           console.log(source_default.green(`
@@ -48035,10 +48098,14 @@ Project updated: ${p.name}`));
   );
 }
 function registerProjectDelete(program3) {
-  program3.command("project:delete <id>").description("Delete a project\n  Example: elevasis-sdk project:delete <uuid>").option("--api-url <url>", "API base URL").option("--pretty", "Render human-readable output instead of raw JSON").action(
+  program3.command("project:delete <id>").description("Delete a project\n  Example: elevasis-sdk project:delete <uuid>").option("--api-url <url>", "API base URL").option("--pretty", "Render human-readable output instead of raw JSON").option("--json", "Output as JSON").action(
     wrapAction("project:delete", async (id, options) => {
       const apiUrl = resolveApiUrl(options.apiUrl);
       const result = await apiDelete(`/api/external/projects/${id}`, apiUrl);
+      if (options.json) {
+        printJson2(result);
+        return;
+      }
       if (options.pretty) {
         console.log(source_default.green(`
 Project ${id} deleted.`));
@@ -48054,6 +48121,9 @@ Project ${id} deleted.`));
 var import_node_fs3 = require("node:fs");
 init_source();
 init_config();
+function printJson3(value) {
+  console.log(JSON.stringify(value, null, 2));
+}
 function parseChecklistOption(options) {
   if (options.checklist !== void 0 && options.checklistFile !== void 0) {
     process.stderr.write(
@@ -48074,10 +48144,14 @@ function parseChecklistOption(options) {
   }
 }
 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(
+  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").option("--json", "Output as JSON").action(
     wrapAction("project:milestone:list", async (options) => {
       const apiUrl = resolveApiUrl(options.apiUrl);
       const result = await apiGet(`/api/external/projects/${options.project}/milestones`, apiUrl);
+      if (options.json) {
+        printJson3(result);
+        return;
+      }
       if (options.pretty) {
         const milestones = result.milestones;
         if (milestones.length === 0) {
@@ -48102,7 +48176,7 @@ Milestones (${milestones.length}):
 function registerMilestoneCreate(program3) {
   program3.command("project:milestone:create").description(
     'Create a milestone\n  Example: elevasis-sdk project:milestone:create --project <uuid> --name "Phase 1"'
-  ).requiredOption("--project <project-id>", "Project ID (UUID)").requiredOption("--name <name>", "Milestone name").option("--status <status>", "Status: upcoming | in_progress | completed | overdue | blocked").option("--due-date <date>", "Due date (ISO 8601, e.g. 2026-06-01)").option("--description <description>", "Milestone description").option("--api-url <url>", "API base URL").option("--pretty", "Render human-readable output instead of raw JSON").action(
+  ).requiredOption("--project <project-id>", "Project ID (UUID)").requiredOption("--name <name>", "Milestone name").option("--status <status>", "Status: upcoming | in_progress | completed | overdue | blocked").option("--due-date <date>", "Due date (ISO 8601, e.g. 2026-06-01)").option("--description <description>", "Milestone description").option("--api-url <url>", "API base URL").option("--pretty", "Render human-readable output instead of raw JSON").option("--json", "Output as JSON").action(
     wrapAction(
       "project:milestone:create",
       async (options) => {
@@ -48116,6 +48190,10 @@ function registerMilestoneCreate(program3) {
           body,
           apiUrl
         );
+        if (options.json) {
+          printJson3(result);
+          return;
+        }
         if (options.pretty) {
           const m = result.milestone;
           console.log(source_default.green(`
@@ -48135,7 +48213,7 @@ 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(
     "--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(
+  ).option("--api-url <url>", "API base URL").option("--pretty", "Render human-readable output instead of raw JSON").option("--json", "Output as JSON").action(
     wrapAction(
       "project:milestone:update",
       async (id, options) => {
@@ -48157,6 +48235,10 @@ function registerMilestoneUpdate(program3) {
         }
         const apiUrl = resolveApiUrl(options.apiUrl);
         const result = await apiPatch(`/api/external/milestones/${id}`, body, apiUrl);
+        if (options.json) {
+          printJson3(result);
+          return;
+        }
         if (options.pretty) {
           const m = result.milestone;
           console.log(source_default.green(`
@@ -48171,10 +48253,14 @@ Milestone updated: ${m.name}`));
   );
 }
 function registerMilestoneDelete(program3) {
-  program3.command("project:milestone:delete <id>").description("Delete a milestone\n  Example: elevasis-sdk project:milestone:delete <uuid>").option("--api-url <url>", "API base URL").option("--pretty", "Render human-readable output instead of raw JSON").action(
+  program3.command("project:milestone:delete <id>").description("Delete a milestone\n  Example: elevasis-sdk project:milestone:delete <uuid>").option("--api-url <url>", "API base URL").option("--pretty", "Render human-readable output instead of raw JSON").option("--json", "Output as JSON").action(
     wrapAction("project:milestone:delete", async (id, options) => {
       const apiUrl = resolveApiUrl(options.apiUrl);
       const result = await apiDelete(`/api/external/milestones/${id}`, apiUrl);
+      if (options.json) {
+        printJson3(result);
+        return;
+      }
       if (options.pretty) {
         console.log(source_default.green(`
 Milestone ${id} deleted.`));
@@ -48190,6 +48276,9 @@ Milestone ${id} deleted.`));
 var import_node_fs4 = require("node:fs");
 init_source();
 init_config();
+function printJson4(value) {
+  console.log(JSON.stringify(value, null, 2));
+}
 function parseChecklistOption2(options) {
   if (options.checklist !== void 0 && options.checklistFile !== void 0) {
     process.stderr.write(
@@ -48215,7 +48304,7 @@ function registerTaskList(program3) {
   ).requiredOption("--project <project-id>", "Project ID (UUID)").option(
     "--status <status>",
     "Filter by status: planned | in_progress | blocked | completed | cancelled | submitted | approved | rejected | revision_requested"
-  ).option("--milestone <milestone-id>", "Filter by milestone ID (UUID)").option("--parent <parent-task-id>", "Filter by parent task ID (UUID)").option("--api-url <url>", "API base URL").option("--pretty", "Render human-readable output instead of raw JSON").action(
+  ).option("--milestone <milestone-id>", "Filter by milestone ID (UUID)").option("--parent <parent-task-id>", "Filter by parent task ID (UUID)").option("--api-url <url>", "API base URL").option("--pretty", "Render human-readable output instead of raw JSON").option("--json", "Output as JSON").action(
     wrapAction(
       "project:task:list",
       async (options) => {
@@ -48227,6 +48316,10 @@ function registerTaskList(program3) {
         const qs = params.toString();
         const endpoint = `/api/external/projects/${options.project}/tasks${qs ? `?${qs}` : ""}`;
         const result = await apiGet(endpoint, apiUrl);
+        if (options.json) {
+          printJson4(result);
+          return;
+        }
         if (options.pretty) {
           const tasks = result.tasks;
           if (tasks.length === 0) {
@@ -48250,10 +48343,14 @@ Tasks (${tasks.length}):
   );
 }
 function registerTaskGet(program3) {
-  program3.command("project:task:get <id>").description("Get a task by ID\n  Example: elevasis-sdk project:task:get <uuid>").option("--api-url <url>", "API base URL").option("--pretty", "Render human-readable output instead of raw JSON").action(
+  program3.command("project:task:get <id>").description("Get a task by ID\n  Example: elevasis-sdk project:task:get <uuid>").option("--api-url <url>", "API base URL").option("--pretty", "Render human-readable output instead of raw JSON").option("--json", "Output as JSON").action(
     wrapAction("project:task:get", async (id, options) => {
       const apiUrl = resolveApiUrl(options.apiUrl);
       const result = await apiGet(`/api/external/project-tasks/${id}`, apiUrl);
+      if (options.json) {
+        printJson4(result);
+        return;
+      }
       if (options.pretty) {
         const t = result.task;
         console.log(source_default.cyan(`
@@ -48279,7 +48376,7 @@ function registerTaskCreate(program3) {
   ).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(
+  ).option("--api-url <url>", "API base URL").option("--pretty", "Render human-readable output instead of raw JSON").option("--json", "Output as JSON").action(
     wrapAction(
       "project:task:create",
       async (options) => {
@@ -48303,6 +48400,10 @@ function registerTaskCreate(program3) {
             )
           );
         }
+        if (options.json) {
+          printJson4(result);
+          return;
+        }
         if (options.pretty) {
           const t = result.task;
           console.log(source_default.green(`
@@ -48324,7 +48425,7 @@ function registerTaskUpdate(program3) {
   ).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(
+  ).option("--api-url <url>", "API base URL").option("--pretty", "Render human-readable output instead of raw JSON").option("--json", "Output as JSON").action(
     wrapAction(
       "project:task:update",
       async (id, options) => {
@@ -48346,6 +48447,10 @@ function registerTaskUpdate(program3) {
         }
         const apiUrl = resolveApiUrl(options.apiUrl);
         const result = await apiPatch(`/api/external/project-tasks/${id}`, body, apiUrl);
+        if (options.json) {
+          printJson4(result);
+          return;
+        }
         if (options.pretty) {
           const t = result.task;
           console.log(source_default.green(`
@@ -48360,10 +48465,14 @@ Task updated: ${t.name}`));
   );
 }
 function registerTaskDelete(program3) {
-  program3.command("project:task:delete <id>").description("Delete a task\n  Example: elevasis-sdk project:task:delete <uuid>").option("--api-url <url>", "API base URL").option("--pretty", "Render human-readable output instead of raw JSON").action(
+  program3.command("project:task:delete <id>").description("Delete a task\n  Example: elevasis-sdk project:task:delete <uuid>").option("--api-url <url>", "API base URL").option("--pretty", "Render human-readable output instead of raw JSON").option("--json", "Output as JSON").action(
     wrapAction("project:task:delete", async (id, options) => {
       const apiUrl = resolveApiUrl(options.apiUrl);
       const result = await apiDelete(`/api/external/project-tasks/${id}`, apiUrl);
+      if (options.json) {
+        printJson4(result);
+        return;
+      }
       if (options.pretty) {
         console.log(source_default.green(`
 Task ${id} deleted.`));
@@ -48377,12 +48486,16 @@ Task ${id} deleted.`));
 function registerTaskResume(program3) {
   program3.command("project:task:resume <id>").description(
     "Fetch the resume_context JSONB for a task (used by /work resume)\n  Example: elevasis-sdk project:task:resume <uuid>"
-  ).option("--api-url <url>", "API base URL").option("--pretty", "Render a human-readable resume briefing instead of raw JSON").action(
+  ).option("--api-url <url>", "API base URL").option("--pretty", "Render a human-readable resume briefing instead of raw JSON").option("--json", "Output as JSON").action(
     wrapAction("project:task:resume", async (id, options) => {
       const apiUrl = resolveApiUrl(options.apiUrl);
       const result = await apiGet(`/api/external/project-tasks/${id}`, apiUrl);
       const task = result.task;
       const ctx = task.resume_context ?? {};
+      if (options.json) {
+        printJson4(ctx);
+        return;
+      }
       if (options.pretty) {
         console.log(source_default.cyan(`
 Resume briefing for task: ${task.name}`));
@@ -48426,7 +48539,7 @@ function registerTaskSave(program3) {
   program3.command("project:task:save <id>").description(
     `Merge fields into resume_context for a task (used by /work save)
   Example: elevasis-sdk project:task:save <uuid> --current-state "Implemented X" --files-modified '["src/foo.ts"]'`
-  ).requiredOption("--current-state <text>", "Current state description").option("--files-modified <json>", "JSON array of modified file paths").option("--next-steps <text>", "Next steps description").option("--key-docs <json>", "JSON array of key doc paths").option("--tools <json>", "JSON array of tool names used").option("--api-url <url>", "API base URL").option("--pretty", "Render human-readable output instead of raw JSON").action(
+  ).requiredOption("--current-state <text>", "Current state description").option("--files-modified <json>", "JSON array of modified file paths").option("--next-steps <text>", "Next steps description").option("--key-docs <json>", "JSON array of key doc paths").option("--tools <json>", "JSON array of tool names used").option("--api-url <url>", "API base URL").option("--pretty", "Render human-readable output instead of raw JSON").option("--json", "Output as JSON").action(
     wrapAction(
       "project:task:save",
       async (id, options) => {
@@ -48468,6 +48581,10 @@ function registerTaskSave(program3) {
         }
         const apiUrl = resolveApiUrl(options.apiUrl);
         const result = await apiPatch(`/api/external/project-tasks/${id}/resume-context`, body, apiUrl);
+        if (options.json) {
+          printJson4(result);
+          return;
+        }
         if (options.pretty) {
           console.log(source_default.green(`
 Resume context saved for task ${id}`));
@@ -48646,12 +48763,19 @@ var NoteIdParamsSchema = external_exports.object({ id: UuidSchema });
 
 // src/cli/commands/project/notes.ts
 init_config();
+function printJson5(value) {
+  console.log(JSON.stringify(value, null, 2));
+}
 var NOTE_TYPE_HELP = NoteTypeSchema.options.join(" | ");
 function registerNoteList(program3) {
-  program3.command("project:note:list").description("List notes for a project\n  Example: elevasis-sdk project:note: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(
+  program3.command("project:note:list").description("List notes for a project\n  Example: elevasis-sdk project:note: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").option("--json", "Output as JSON").action(
     wrapAction("project:note:list", async (options) => {
       const apiUrl = resolveApiUrl(options.apiUrl);
       const result = await apiGet(`/api/external/projects/${options.project}/notes`, apiUrl);
+      if (options.json) {
+        printJson5(result);
+        return;
+      }
       if (options.pretty) {
         const notes = result.notes;
         if (notes.length === 0) {
@@ -48676,7 +48800,7 @@ Notes (${notes.length}):
 function registerNoteCreate(program3) {
   program3.command("project:note:create").description(
     'Create a note\n  Example: elevasis-sdk project:note:create --project <uuid> --content "Status update"'
-  ).requiredOption("--project <project-id>", "Project ID (UUID)").requiredOption("--content <content>", "Note content").option("--task <task-id>", "Attach to a task (UUID)").option("--milestone <milestone-id>", "Attach to a milestone (UUID)").option("--type <type>", `Note type: ${NOTE_TYPE_HELP}`).option("--api-url <url>", "API base URL").option("--pretty", "Render human-readable output instead of raw JSON").action(
+  ).requiredOption("--project <project-id>", "Project ID (UUID)").requiredOption("--content <content>", "Note content").option("--task <task-id>", "Attach to a task (UUID)").option("--milestone <milestone-id>", "Attach to a milestone (UUID)").option("--type <type>", `Note type: ${NOTE_TYPE_HELP}`).option("--api-url <url>", "API base URL").option("--pretty", "Render human-readable output instead of raw JSON").option("--json", "Output as JSON").action(
     wrapAction(
       "project:note:create",
       async (options) => {
@@ -48689,6 +48813,10 @@ function registerNoteCreate(program3) {
         if (options.type) body.type = options.type;
         const apiUrl = resolveApiUrl(options.apiUrl);
         const result = await apiPost("/api/external/project-notes", body, apiUrl);
+        if (options.json) {
+          printJson5(result);
+          return;
+        }
         if (options.pretty) {
           const n = result.note;
           console.log(source_default.green(`
@@ -48704,7 +48832,7 @@ Note created`));
   );
 }
 function registerNoteUpdate(program3) {
-  program3.command("project:note:update <id>").description('Update a note\n  Example: elevasis-sdk project:note:update <uuid> --content "Updated content"').requiredOption("--content <content>", "New note content").option("--api-url <url>", "API base URL").option("--pretty", "Render human-readable output instead of raw JSON").action(
+  program3.command("project:note:update <id>").description('Update a note\n  Example: elevasis-sdk project:note:update <uuid> --content "Updated content"').requiredOption("--content <content>", "New note content").option("--api-url <url>", "API base URL").option("--pretty", "Render human-readable output instead of raw JSON").option("--json", "Output as JSON").action(
     wrapAction("project:note:update", async (id, options) => {
       const apiUrl = resolveApiUrl(options.apiUrl);
       const result = await apiPatch(
@@ -48712,6 +48840,10 @@ function registerNoteUpdate(program3) {
         { content: options.content },
         apiUrl
       );
+      if (options.json) {
+        printJson5(result);
+        return;
+      }
       if (options.pretty) {
         console.log(source_default.green(`
 Note ${id} updated.`));
@@ -48723,10 +48855,14 @@ Note ${id} updated.`));
   );
 }
 function registerNoteDelete(program3) {
-  program3.command("project:note:delete <id>").description("Delete a note\n  Example: elevasis-sdk project:note:delete <uuid>").option("--api-url <url>", "API base URL").option("--pretty", "Render human-readable output instead of raw JSON").action(
+  program3.command("project:note:delete <id>").description("Delete a note\n  Example: elevasis-sdk project:note:delete <uuid>").option("--api-url <url>", "API base URL").option("--pretty", "Render human-readable output instead of raw JSON").option("--json", "Output as JSON").action(
     wrapAction("project:note:delete", async (id, options) => {
       const apiUrl = resolveApiUrl(options.apiUrl);
       const result = await apiDelete(`/api/external/project-notes/${id}`, apiUrl);
+      if (options.json) {
+        printJson5(result);
+        return;
+      }
       if (options.pretty) {
         console.log(source_default.green(`
 Note ${id} deleted.`));
@@ -51055,7 +51191,7 @@ function endpointWithQuery2(endpoint, params) {
   const query = params.toString();
   return query ? `${endpoint}?${query}` : endpoint;
 }
-function printJson2(value) {
+function printJson6(value) {
   console.log(JSON.stringify(value, null, 2));
 }
 function dealEmail(deal) {
@@ -51086,7 +51222,7 @@ function registerAcquisitionDealList(program3) {
         appendQuery2(params, "offset", options.offset);
         const result = await apiGet(endpointWithQuery2("/api/external/deals", params), apiUrl);
         if (!options.pretty) {
-          printJson2(result);
+          printJson6(result);
           return;
         }
         if (result.data.length === 0) {
@@ -51114,7 +51250,7 @@ function registerAcquisitionDealGet(program3) {
       const apiUrl = resolveApiUrl(options.apiUrl);
       const result = await apiGet("/api/external/deals/" + id, apiUrl);
       if (!options.pretty) {
-        printJson2(result);
+        printJson6(result);
         return;
       }
       console.log(source_default.cyan(`
@@ -51136,7 +51272,7 @@ function registerAcquisitionDealStatus(program3) {
       const apiUrl = resolveApiUrl(options.apiUrl);
       const result = await apiGet("/api/external/deals/summary", apiUrl);
       if (!options.pretty) {
-        printJson2(result);
+        printJson6(result);
         return;
       }
       console.log(source_default.cyan("\nAcquisition deal status"));
@@ -51166,7 +51302,7 @@ function endpointWithQuery3(endpoint, params) {
   const query = params.toString();
   return query ? `${endpoint}?${query}` : endpoint;
 }
-function printJson3(value) {
+function printJson7(value) {
   console.log(JSON.stringify(value, null, 2));
 }
 function renderListSummary(list) {
@@ -51194,7 +51330,7 @@ function registerAcquisitionListList(program3) {
           apiUrl
         );
         if (!options.pretty) {
-          printJson3(result);
+          printJson7(result);
           return;
         }
         if (result.length === 0) {
@@ -51225,7 +51361,7 @@ function registerAcquisitionListGet(program3) {
           apiUrl
         );
         if (!options.pretty) {
-          printJson3(result);
+          printJson7(result);
           return;
         }
         console.log(source_default.cyan(`
@@ -51247,7 +51383,7 @@ function registerAcquisitionListStatus(program3) {
       const apiUrl = resolveApiUrl(options.apiUrl);
       const result = await apiGet("/api/external/acquisition/lists/status", apiUrl);
       if (!options.pretty) {
-        printJson3(result);
+        printJson7(result);
         return;
       }
       console.log(source_default.cyan("\nAcquisition list status"));
@@ -51412,7 +51548,7 @@ function registerClientCommands(program3) {
 // src/cli/commands/queue/queue.ts
 init_source();
 init_config();
-function printJson4(value) {
+function printJson8(value) {
   console.log(JSON.stringify(value, null, 2));
 }
 function appendQuery4(params, key, value) {
@@ -51453,7 +51589,7 @@ function registerQueueList(program3) {
           apiUrl
         );
         if (!options.pretty) {
-          printJson4(result);
+          printJson8(result);
           return;
         }
         if (result.tasks.length === 0) {
@@ -51481,7 +51617,7 @@ function registerQueueGet(program3) {
       const apiUrl = resolveApiUrl(options.apiUrl);
       const result = await apiGet(`/api/external/command-queue/${id}`, apiUrl);
       if (!options.pretty) {
-        printJson4(result);
+        printJson8(result);
         return;
       }
       const task = result.task;
@@ -51514,7 +51650,7 @@ function registerQueueSelect(program3) {
           apiUrl
         );
         if (!options.pretty) {
-          printJson4(result);
+          printJson8(result);
           return;
         }
         console.log(source_default.green(`
@@ -51535,7 +51671,7 @@ function registerQueueExpire(program3) {
         apiUrl
       );
       if (!options.pretty) {
-        printJson4(result);
+        printJson8(result);
         return;
       }
       console.log(source_default.green(`
@@ -51561,7 +51697,7 @@ function registerQueueStatus(program3) {
           apiUrl
         );
         if (!options.pretty) {
-          printJson4(result);
+          printJson8(result);
           return;
         }
         console.log(source_default.cyan("\nQueue status"));
@@ -51599,7 +51735,7 @@ function registerQueueCommands(program3) {
 // src/cli/commands/schedule/schedule.ts
 init_source();
 init_config();
-function printJson5(value) {
+function printJson9(value) {
   console.log(JSON.stringify(value, null, 2));
 }
 function appendQuery5(params, key, value) {
@@ -51641,7 +51777,7 @@ function registerScheduleList(program3) {
           apiUrl
         );
         if (!options.pretty) {
-          printJson5(result);
+          printJson9(result);
           return;
         }
         if (result.schedules.length === 0) {
@@ -51668,7 +51804,7 @@ function registerScheduleGet(program3) {
         apiUrl
       );
       if (!options.pretty) {
-        printJson5(result);
+        printJson9(result);
         return;
       }
       console.log(source_default.cyan(`
@@ -51718,7 +51854,7 @@ function registerScheduleCreate(program3) {
           apiUrl
         );
         if (!options.pretty) {
-          printJson5(result);
+          printJson9(result);
           return;
         }
         console.log(source_default.green(`
@@ -51770,7 +51906,7 @@ function registerScheduleUpdate(program3) {
           apiUrl
         );
         if (!options.pretty) {
-          printJson5(result);
+          printJson9(result);
           return;
         }
         console.log(source_default.green(`
@@ -51793,7 +51929,7 @@ function registerScheduleStatusMutation(program3, commandName, description) {
         apiUrl
       );
       if (!options.pretty) {
-        printJson5(result);
+        printJson9(result);
         return;
       }
       const verb = commandName === "pause" ? "paused" : commandName === "resume" ? "resumed" : "cancelled";
@@ -51910,7 +52046,7 @@ init_config();
 function getResourceType2(resource) {
   return resource.type ?? resource.resourceType;
 }
-function printJson6(value) {
+function printJson10(value) {
   console.log(JSON.stringify(value, null, 2));
 }
 function registerAgentList(program3) {
@@ -51920,7 +52056,7 @@ function registerAgentList(program3) {
       const result = await apiGet("/api/external/resources", apiUrl);
       const agents = result.resources.filter((resource) => getResourceType2(resource) === "agent");
       if (options.json) {
-        printJson6({ agents, total: agents.length });
+        printJson10({ agents, total: agents.length });
         return;
       }
       if (agents.length === 0) {
@@ -51948,7 +52084,7 @@ function registerAgentGet(program3) {
       const apiUrl = resolveApiUrl(options.apiUrl);
       const definition = await apiGet(`/api/external/resources/${id}/definition`, apiUrl);
       if (options.json) {
-        printJson6(definition);
+        printJson10(definition);
         return;
       }
       const config3 = definition.config ?? {};
@@ -51982,7 +52118,7 @@ function registerAgentCommands(program3) {
 var import_node_fs10 = require("node:fs");
 init_source();
 init_config();
-function printJson7(value) {
+function printJson11(value) {
   console.log(JSON.stringify(value, null, 2));
 }
 function appendQuery6(params, key, value) {
@@ -52090,7 +52226,7 @@ function registerSessionCreate(program3) {
       if (options.metadata) body.metadata = parseJson(options.metadata, "--metadata");
       const session = await apiPost("/api/external/sessions", body, apiUrl);
       if (options.json) {
-        printJson7(session);
+        printJson11(session);
         return;
       }
       console.log(source_default.green(`Created session ${session.sessionId}.`));
@@ -52110,7 +52246,7 @@ function registerSessionList(program3) {
       appendQuery6(params, "limit", options.limit);
       const result = await apiGet(endpointWithQuery6("/api/external/sessions", params), apiUrl);
       if (options.json) {
-        printJson7(result);
+        printJson11(result);
         return;
       }
       if (result.sessions.length === 0) {
@@ -52136,7 +52272,7 @@ function registerSessionGet(program3) {
       const apiUrl = resolveApiUrl(options.apiUrl);
       const session = await apiGet(`/api/external/sessions/${id}`, apiUrl);
       if (options.json) {
-        printJson7(session);
+        printJson11(session);
         return;
       }
       console.log(source_default.cyan(`Session: ${session.title ?? session.sessionId}`));
@@ -52158,7 +52294,7 @@ function registerSessionTurn(program3) {
       const input = resolveTurnInput(options);
       const result = await apiPost(`/api/external/sessions/${id}/turns`, { input }, apiUrl);
       if (options.json) {
-        printJson7(result);
+        printJson11(result);
         return;
       }
       console.log(source_default.green(`Turn ${result.turnNumber} complete.`));
@@ -52190,7 +52326,7 @@ function registerSessionMessages(program3) {
       const apiUrl = resolveApiUrl(options.apiUrl);
       const result = await fetchSessionMessages(id, apiUrl, options);
       if (options.json) {
-        printJson7(result);
+        printJson11(result);
         return;
       }
       const total = result.total === void 0 ? result.messages.length : result.total;
@@ -52216,7 +52352,7 @@ function registerSessionEnd(program3) {
         apiUrl
       );
       if (options.json) {
-        printJson7(result);
+        printJson11(result);
         return;
       }
       console.log(source_default.green(`Ended session ${result.sessionId ?? id}.`));
@@ -52237,7 +52373,7 @@ function registerSessionCommands(program3) {
 // src/cli/commands/grant/grant.ts
 init_source();
 init_config();
-function printJson8(value) {
+function printJson12(value) {
   console.log(JSON.stringify(value, null, 2));
 }
 function appendQuery7(params, key, value) {
@@ -52312,7 +52448,7 @@ function registerGrantList(program3) {
         apiUrl
       );
       if (options.json) {
-        printJson8(result);
+        printJson12(result);
         return;
       }
       if (result.grants.length === 0) {
@@ -52360,7 +52496,7 @@ function registerGrantCreate(program3) {
       const apiUrl = resolveApiUrl(options.apiUrl);
       const result = await apiPost("/api/external/agent-access-grants", body, apiUrl);
       if (options.json) {
-        printJson8(result.grant);
+        printJson12(result.grant);
         return;
       }
       console.log(source_default.green(`Created agent access grant ${result.grant.slug}.`));
@@ -52403,7 +52539,7 @@ function registerGrantUpdate(program3) {
         apiUrl
       );
       if (options.json) {
-        printJson8(result.grant);
+        printJson12(result.grant);
         return;
       }
       console.log(source_default.green(`Updated agent access grant ${result.grant.slug}.`));
@@ -52422,7 +52558,7 @@ function registerGrantDisable(program3) {
         apiUrl
       );
       if (options.json) {
-        printJson8(result.grant);
+        printJson12(result.grant);
         return;
       }
       console.log(source_default.green(`Disabled agent access grant ${result.grant.slug}.`));