@elevasis/sdk 1.36.4 → 1.36.5

package/dist/cli.cjs

@@ -45808,7 +45808,7 @@ function wrapAction(commandName, fn) {
 // package.json
 var package_default = {
   name: "@elevasis/sdk",
-  version: "1.36.4",
+  version: "1.36.5",
   description: "SDK for building Elevasis organization resources",
   type: "module",
   bin: {
@@ -47834,8 +47834,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 +47856,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 +47885,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 +47929,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 +47953,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 +47977,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 +47997,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 +48040,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 +48058,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 +48081,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 +48104,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 +48136,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 +48150,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 +48173,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 +48195,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 +48213,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 +48236,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 +48264,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 +48276,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 +48303,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 +48336,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 +48360,10 @@ function registerTaskCreate(program3) {
             )
           );
         }
+        if (options.json) {
+          printJson4(result);
+          return;
+        }
         if (options.pretty) {
           const t = result.task;
           console.log(source_default.green(`
@@ -48324,7 +48385,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 +48407,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 +48425,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 +48446,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 +48499,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 +48541,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 +48723,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 +48760,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 +48773,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 +48792,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 +48800,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 +48815,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 +51151,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 +51182,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 +51210,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 +51232,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 +51262,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 +51290,7 @@ function registerAcquisitionListList(program3) {
           apiUrl
         );
         if (!options.pretty) {
-          printJson3(result);
+          printJson7(result);
           return;
         }
         if (result.length === 0) {
@@ -51225,7 +51321,7 @@ function registerAcquisitionListGet(program3) {
           apiUrl
         );
         if (!options.pretty) {
-          printJson3(result);
+          printJson7(result);
           return;
         }
         console.log(source_default.cyan(`
@@ -51247,7 +51343,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 +51508,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 +51549,7 @@ function registerQueueList(program3) {
           apiUrl
         );
         if (!options.pretty) {
-          printJson4(result);
+          printJson8(result);
           return;
         }
         if (result.tasks.length === 0) {
@@ -51481,7 +51577,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 +51610,7 @@ function registerQueueSelect(program3) {
           apiUrl
         );
         if (!options.pretty) {
-          printJson4(result);
+          printJson8(result);
           return;
         }
         console.log(source_default.green(`
@@ -51535,7 +51631,7 @@ function registerQueueExpire(program3) {
         apiUrl
       );
       if (!options.pretty) {
-        printJson4(result);
+        printJson8(result);
         return;
       }
       console.log(source_default.green(`
@@ -51561,7 +51657,7 @@ function registerQueueStatus(program3) {
           apiUrl
         );
         if (!options.pretty) {
-          printJson4(result);
+          printJson8(result);
           return;
         }
         console.log(source_default.cyan("\nQueue status"));
@@ -51599,7 +51695,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 +51737,7 @@ function registerScheduleList(program3) {
           apiUrl
         );
         if (!options.pretty) {
-          printJson5(result);
+          printJson9(result);
           return;
         }
         if (result.schedules.length === 0) {
@@ -51668,7 +51764,7 @@ function registerScheduleGet(program3) {
         apiUrl
       );
       if (!options.pretty) {
-        printJson5(result);
+        printJson9(result);
         return;
       }
       console.log(source_default.cyan(`
@@ -51718,7 +51814,7 @@ function registerScheduleCreate(program3) {
           apiUrl
         );
         if (!options.pretty) {
-          printJson5(result);
+          printJson9(result);
           return;
         }
         console.log(source_default.green(`
@@ -51770,7 +51866,7 @@ function registerScheduleUpdate(program3) {
           apiUrl
         );
         if (!options.pretty) {
-          printJson5(result);
+          printJson9(result);
           return;
         }
         console.log(source_default.green(`
@@ -51793,7 +51889,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 +52006,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 +52016,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 +52044,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 +52078,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 +52186,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 +52206,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 +52232,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 +52254,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 +52286,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 +52312,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 +52333,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 +52408,7 @@ function registerGrantList(program3) {
         apiUrl
       );
       if (options.json) {
-        printJson8(result);
+        printJson12(result);
         return;
       }
       if (result.grants.length === 0) {
@@ -52360,7 +52456,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 +52499,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 +52518,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}.`));

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@elevasis/sdk",
-  "version": "1.36.4",
+  "version": "1.36.5",
   "description": "SDK for building Elevasis organization resources",
   "type": "module",
   "bin": {
@@ -58,9 +58,9 @@
     "tsup": "^8.0.0",
     "typescript": "5.9.2",
     "zod": "^4.1.0",
-    "@repo/core": "0.50.0",
-    "@repo/eslint-config": "0.0.0",
-    "@repo/typescript-config": "0.0.0"
+    "@repo/core": "0.51.0",
+    "@repo/typescript-config": "0.0.0",
+    "@repo/eslint-config": "0.0.0"
   },
   "scripts": {
     "lint": "eslint src --max-warnings 0",

package/reference/claude-config/skills/project/SKILL.md

@@ -256,6 +256,28 @@ Organization scoping is handled server-side via `ELEVASIS_PLATFORM_KEY`. No org
 
 ---
 
+## Output Flags
+
+All `project:*` commands support three output modes via flags:
+
+| Flag        | Behavior                   | Use when                                            |
+| ----------- | -------------------------- | --------------------------------------------------- |
+| _(no flag)_ | Raw JSON (legacy default)  | Existing scripts that parse default stdout          |
+| `--json`    | Clean JSON via `printJson` | Agent automation — the preferred machine-parse flag |
+| `--pretty`  | Human-readable text        | Interactive / debugging output                      |
+
+**Canonical machine-parse recipe:**
+
+```bash
+pnpm -s elevasis-sdk project:task:list --project <uuid> --json
+```
+
+The `-s` / `--silent` flag suppresses the pnpm lifecycle preamble (`> project@... elevasis-sdk ...`) so stdout is pure JSON with no wrapper noise. Use `--json` and `-s` together for all agent automation.
+
+**Defensive parse fallback** (if any wrapper noise remains): slice from the first `{` or `[` to the last `}` or `]` before calling `JSON.parse`.
+
+---
+
 ## Database Schema
 
 ### Tables

package/reference/claude-config/sync-notes/2026-06-14-session-ux-and-project-cli-json.md

@@ -0,0 +1,33 @@
+# Session UX fixes + project CLI `--json`
+
+## Why this note exists
+
+This train bumps both `@elevasis/ui` and `@elevasis/sdk` with several tenant-facing changes beyond the shared `SessionConversationView` adoption (see the companion `2026-06-14-shared-session-conversation-view.md` note):
+
+- **Lazy agent-session creation** (`@elevasis/ui`) — the Agent Sessions surface and the public agent-chat surface no longer create a `sessions` row on open/mount. The row is created on the first message-send ("create-on-first-turn"), so opened-then-abandoned chats no longer leave phantom "0 turns" rows.
+- **Agent Sessions list refresh-after-delete fix** (`@elevasis/ui`) — a query-key factory bug (`sessionsKeys.sessions` appended a literal `undefined`) broke partial-match invalidation, so delete/create/archive left the list stale until a manual reload. Fixed; the list now refreshes automatically.
+- **Project milestone progress badge fix** (`@elevasis/ui`) — the `/projects` milestone header badge counted the milestone's own (empty) checklist, showing `0/0 COMPLETE`. It now counts completed child tasks, with a checklist fallback for task-free milestones.
+- **`project:*` CLI `--json` flag** (`@elevasis/sdk`) — every `project:*` command (project/task/milestone/note) now accepts `--json` for clean machine-parseable output, matching `grant:*`/`session:*`. The `/project` skill SKILL.md gains an Output Flags reference and the canonical `pnpm -s elevasis-sdk … --json` parse recipe (auto-propagated as a managed `.claude` write).
+
+## Applies to
+
+- All template-derived projects that expose the agent-sessions page (`ui/src/features/operations/sessions/`) or the public agent-chat surface.
+- All projects that drive work via the `elevasis-sdk project:*` CLI or surface the `/projects` delivery page.
+
+## Required actions
+
+- Bump `@elevasis/ui` to `^2.55.0` and `@elevasis/sdk` to `^1.36.5` (or later) and install. The ship train's `external-sync` stage does this automatically via the package-cascade baselines — manual `pnpm update` is not required.
+- No source changes are required to receive the lazy-session, delete-refresh, or milestone-badge fixes — they ship inside `@elevasis/ui`.
+- Agents may now invoke `pnpm -s elevasis-sdk project:<cmd> … --json` for clean JSON; the propagated `/project` SKILL.md Output Flags table documents the parse recipe.
+
+## Verification
+
+- `pnpm -C ui check-types` passes against `@elevasis/ui@^2.55.0`.
+- Open an agent-session chat without sending → no new `sessions` row appears in the list; send one message → exactly one row with `1 turn`.
+- Delete a session → the list refreshes without a manual reload.
+- `pnpm -s elevasis-sdk project:task:list --project <id> --json` exits 0 with parseable JSON and no `unknown option` error.
+
+## Not handled by /git-sync
+
+- `/git-sync` surfaces this note and pulls the propagated `/project` SKILL.md baseline, but it does not run the `@elevasis/ui` / `@elevasis/sdk` install for you when reconciling manually outside the ship train.
+- The lazy-session change does NOT retroactively clean up pre-existing "0 turns" rows; those are left in place by design.

package/reference/claude-config/sync-notes/2026-06-14-shared-session-conversation-view.md

@@ -0,0 +1,26 @@
+# Shared Session ConversationView
+
+## Why this note exists
+
+`@elevasis/ui` now ships a shared `SessionConversationView` component (WebSocket-backed session-detail chat body). The template's session-detail page previously filled the `renderConversationView` slot with a local stub (`ui/src/features/assistant/components/ConversationView.tsx`) that returned `null`, so the agent-sessions chat page (`/operations/sessions/$sessionId`) rendered blank and the `DISCONNECTED` badge never cleared. The template `SessionChatPage` now renders the shared component directly, so derived projects get a working session chat with no local implementation.
+
+## Applies to
+
+- All template-derived projects that expose the agent-sessions page (`ui/src/features/operations/sessions/SessionChatPage.tsx`).
+- Any project still carrying the `null`-returning `ConversationView` stub in `ui/src/features/assistant/components/`.
+
+## Required actions
+
+- Bump `@elevasis/ui` to `^2.55.0` (or later) in `ui/package.json` and install. (The ship train's `external-sync` stage does this automatically via the package-cascade baseline; manual `pnpm update` is not required.)
+- Adopt the new `SessionChatPage` slot wiring: render `<SessionConversationView apiUrl={API_URL} sessionId={...} ... />` from `@elevasis/ui/features/operations`, reading `API_URL` from `@/lib/constants/api`, instead of the local `ConversationView` stub.
+- The local `ConversationView` stub is now unused by the session page. It remains a generic placeholder for an AI-assistant feature; keep it only if you are building such a feature, otherwise it can be removed.
+
+## Verification
+
+- `pnpm -C ui check-types` passes against `@elevasis/ui@^2.55.0`.
+- The session-detail chat page renders history + live messages and the `DISCONNECTED` badge clears (connects) once `apiUrl` is wired.
+
+## Not handled by /git-sync
+
+- `/git-sync` surfaces this note and pulls the template `SessionChatPage` baseline, but it does not delete the now-unused local `ConversationView` stub. Remove it manually if you do not intend to build an assistant feature.
+- `/git-sync` does not run the `@elevasis/ui` install for you; run the install after the baseline bump if you are reconciling manually outside the ship train.