@elevasis/sdk 1.5.2 → 1.5.4

package/dist/cli.cjs

@@ -288,8 +288,8 @@ var require_main = __commonJS({
         const shortPaths = [];
         for (const filePath of optionPaths) {
           try {
-            const relative = path.relative(process.cwd(), filePath);
-            shortPaths.push(relative);
+            const relative2 = path.relative(process.cwd(), filePath);
+            shortPaths.push(relative2);
           } catch (e) {
             if (debug) {
               _debug(`Failed to load ${filePath} ${e.message}`);
@@ -5245,7 +5245,7 @@ var require_buffer_list = __commonJS({
         }
       }, {
         key: "join",
-        value: function join(s) {
+        value: function join4(s) {
           if (this.length === 0) return "";
           var p = this.head;
           var ret = "" + p.data;
@@ -6622,14 +6622,14 @@ var require_async_iterator = __commonJS({
       };
     }
     function readAndResolve(iter) {
-      var resolve4 = iter[kLastResolve];
-      if (resolve4 !== null) {
+      var resolve8 = iter[kLastResolve];
+      if (resolve8 !== null) {
         var data = iter[kStream].read();
         if (data !== null) {
           iter[kLastPromise] = null;
           iter[kLastResolve] = null;
           iter[kLastReject] = null;
-          resolve4(createIterResult(data, false));
+          resolve8(createIterResult(data, false));
         }
       }
     }
@@ -6637,13 +6637,13 @@ var require_async_iterator = __commonJS({
       process.nextTick(readAndResolve, iter);
     }
     function wrapForNext(lastPromise, iter) {
-      return function(resolve4, reject) {
+      return function(resolve8, reject) {
         lastPromise.then(function() {
           if (iter[kEnded]) {
-            resolve4(createIterResult(void 0, true));
+            resolve8(createIterResult(void 0, true));
             return;
           }
-          iter[kHandlePromise](resolve4, reject);
+          iter[kHandlePromise](resolve8, reject);
         }, reject);
       };
     }
@@ -6663,12 +6663,12 @@ var require_async_iterator = __commonJS({
           return Promise.resolve(createIterResult(void 0, true));
         }
         if (this[kStream].destroyed) {
-          return new Promise(function(resolve4, reject) {
+          return new Promise(function(resolve8, reject) {
             process.nextTick(function() {
               if (_this[kError]) {
                 reject(_this[kError]);
               } else {
-                resolve4(createIterResult(void 0, true));
+                resolve8(createIterResult(void 0, true));
               }
             });
           });
@@ -6691,13 +6691,13 @@ var require_async_iterator = __commonJS({
       return this;
     }), _defineProperty(_Object$setPrototypeO, "return", function _return() {
       var _this2 = this;
-      return new Promise(function(resolve4, reject) {
+      return new Promise(function(resolve8, reject) {
         _this2[kStream].destroy(null, function(err) {
           if (err) {
             reject(err);
             return;
           }
-          resolve4(createIterResult(void 0, true));
+          resolve8(createIterResult(void 0, true));
         });
       });
     }), _Object$setPrototypeO), AsyncIteratorPrototype);
@@ -6719,15 +6719,15 @@ var require_async_iterator = __commonJS({
         value: stream._readableState.endEmitted,
         writable: true
       }), _defineProperty(_Object$create, kHandlePromise, {
-        value: function value(resolve4, reject) {
+        value: function value(resolve8, reject) {
           var data = iterator[kStream].read();
           if (data) {
             iterator[kLastPromise] = null;
             iterator[kLastResolve] = null;
             iterator[kLastReject] = null;
-            resolve4(createIterResult(data, false));
+            resolve8(createIterResult(data, false));
           } else {
-            iterator[kLastResolve] = resolve4;
+            iterator[kLastResolve] = resolve8;
             iterator[kLastReject] = reject;
           }
         },
@@ -6746,12 +6746,12 @@ var require_async_iterator = __commonJS({
           iterator[kError] = err;
           return;
         }
-        var resolve4 = iterator[kLastResolve];
-        if (resolve4 !== null) {
+        var resolve8 = iterator[kLastResolve];
+        if (resolve8 !== null) {
           iterator[kLastPromise] = null;
           iterator[kLastResolve] = null;
           iterator[kLastReject] = null;
-          resolve4(createIterResult(void 0, true));
+          resolve8(createIterResult(void 0, true));
         }
         iterator[kEnded] = true;
       });
@@ -6766,7 +6766,7 @@ var require_async_iterator = __commonJS({
 var require_from = __commonJS({
   "../../node_modules/.pnpm/readable-stream@3.6.2/node_modules/readable-stream/lib/internal/streams/from.js"(exports2, module2) {
     "use strict";
-    function asyncGeneratorStep(gen, resolve4, reject, _next, _throw, key, arg) {
+    function asyncGeneratorStep(gen, resolve8, reject, _next, _throw, key, arg) {
       try {
         var info = gen[key](arg);
         var value = info.value;
@@ -6775,7 +6775,7 @@ var require_from = __commonJS({
         return;
       }
       if (info.done) {
-        resolve4(value);
+        resolve8(value);
       } else {
         Promise.resolve(value).then(_next, _throw);
       }
@@ -6783,13 +6783,13 @@ var require_from = __commonJS({
     function _asyncToGenerator(fn) {
       return function() {
         var self2 = this, args = arguments;
-        return new Promise(function(resolve4, reject) {
+        return new Promise(function(resolve8, reject) {
           var gen = fn.apply(self2, args);
           function _next(value) {
-            asyncGeneratorStep(gen, resolve4, reject, _next, _throw, "next", value);
+            asyncGeneratorStep(gen, resolve8, reject, _next, _throw, "next", value);
           }
           function _throw(err) {
-            asyncGeneratorStep(gen, resolve4, reject, _next, _throw, "throw", err);
+            asyncGeneratorStep(gen, resolve8, reject, _next, _throw, "throw", err);
           }
           _next(void 0);
         });
@@ -43990,7 +43990,7 @@ function wrapAction(commandName, fn) {
 // package.json
 var package_default = {
   name: "@elevasis/sdk",
-  version: "1.5.2",
+  version: "1.5.4",
   description: "SDK for building Elevasis organization resources",
   type: "module",
   bin: {
@@ -44508,7 +44508,7 @@ async function pollForCompletion(resourceId, executionId, apiUrl) {
   };
   process.on("SIGINT", cleanup);
   while (true) {
-    await new Promise((resolve4) => setTimeout(resolve4, POLL_INTERVAL_MS));
+    await new Promise((resolve8) => setTimeout(resolve8, POLL_INTERVAL_MS));
     const elapsed = Math.round((Date.now() - startTime) / 1e3);
     pollSpinner.text = `Waiting for completion... (${elapsed}s)`;
     try {
@@ -45096,10 +45096,10 @@ Credential renamed successfully!`));
 var import_readline = require("readline");
 function confirm(message) {
   const rl = (0, import_readline.createInterface)({ input: process.stdin, output: process.stdout });
-  return new Promise((resolve4) => {
+  return new Promise((resolve8) => {
     rl.question(message, (answer) => {
       rl.close();
-      resolve4(answer.toLowerCase() === "y" || answer.toLowerCase() === "yes");
+      resolve8(answer.toLowerCase() === "y" || answer.toLowerCase() === "yes");
     });
   });
 }
@@ -45230,38 +45230,320 @@ function registerRenameCommand(program3) {
   );
 }
 
+// src/cli/commands/project/resolve-project.ts
+function isUuid(value) {
+  return /^[0-9a-f]{8}-[0-9a-f]{4}-[1-5][0-9a-f]{3}-[89ab][0-9a-f]{3}-[0-9a-f]{12}$/i.test(value);
+}
+function normalize(value) {
+  return value.trim().toLowerCase();
+}
+function formatCandidates(projects) {
+  return projects.slice(0, 5).map((project) => `${project.name} (${project.id})`).join(", ");
+}
+async function resolveProject(query, apiUrlOverride) {
+  const trimmedQuery = query.trim();
+  if (!trimmedQuery) {
+    throw new Error("Project query is required");
+  }
+  const apiUrl = resolveApiUrl(apiUrlOverride);
+  if (isUuid(trimmedQuery)) {
+    try {
+      const result2 = await apiGet(`/api/external/projects/${trimmedQuery}`, apiUrl);
+      return result2.project;
+    } catch (error46) {
+      if (!(error46 instanceof Error) || !error46.message.includes("(404)")) {
+        throw error46;
+      }
+    }
+  }
+  const params = new URLSearchParams({ search: trimmedQuery });
+  const result = await apiGet(`/api/external/projects?${params.toString()}`, apiUrl);
+  const projects = result.projects;
+  if (projects.length === 0) {
+    throw new Error(`No project matched "${trimmedQuery}"`);
+  }
+  const normalizedQuery = normalize(trimmedQuery);
+  const exactNameMatches = projects.filter((project) => normalize(project.name) === normalizedQuery);
+  if (exactNameMatches.length === 1) {
+    return exactNameMatches[0];
+  }
+  if (exactNameMatches.length > 1) {
+    throw new Error(`Multiple projects matched "${trimmedQuery}": ${formatCandidates(exactNameMatches)}`);
+  }
+  if (projects.length === 1) {
+    return projects[0];
+  }
+  const prefixMatches = projects.filter((project) => normalize(project.name).startsWith(normalizedQuery));
+  if (prefixMatches.length === 1) {
+    return prefixMatches[0];
+  }
+  throw new Error(`Multiple projects matched "${trimmedQuery}": ${formatCandidates(projects)}`);
+}
+
+// src/cli/commands/project/work-project.ts
+var TASK_DONE_STATUSES = /* @__PURE__ */ new Set(["completed", "approved"]);
+var TASK_ACTIVE_STATUSES = /* @__PURE__ */ new Set(["in_progress", "submitted", "revision_requested"]);
+var TASK_BLOCKED_STATUSES = /* @__PURE__ */ new Set(["blocked", "rejected"]);
+var MILESTONE_BLOCKED_STATUSES = /* @__PURE__ */ new Set(["blocked", "overdue"]);
+function toText(value) {
+  return typeof value === "string" && value.trim() ? value.trim() : null;
+}
+function summarizeText(value, maxLength = 120) {
+  const text = value?.trim() ?? "";
+  if (!text) return "No recent summary recorded.";
+  return text.length > maxLength ? `${text.slice(0, maxLength - 3)}...` : text;
+}
+function getTaskSavedState(task) {
+  const resumeContext = task.resume_context;
+  return toText(resumeContext?.current_state);
+}
+function compareUpdatedDesc(a, b) {
+  return (b.updated_at ?? "").localeCompare(a.updated_at ?? "");
+}
+function deriveLifecycle(project, taskProgress, milestoneProgress) {
+  if (project.status === "completed") return "completed";
+  if (project.status === "blocked" || taskProgress.blocked > 0 || milestoneProgress.blocked > 0) {
+    return "blocked";
+  }
+  const hasStartedWork = taskProgress.completed > 0 || taskProgress.active > 0 || milestoneProgress.completed > 0 || milestoneProgress.inProgress > 0;
+  return hasStartedWork ? "active" : "planning";
+}
+function selectResumeTarget(project) {
+  const activeTasks = project.tasks.filter((task) => TASK_ACTIVE_STATUSES.has(task.status ?? "")).sort(compareUpdatedDesc);
+  const savedActiveTask = activeTasks.find((task) => getTaskSavedState(task));
+  if (savedActiveTask) {
+    return {
+      kind: "task",
+      id: savedActiveTask.id,
+      name: savedActiveTask.name,
+      status: savedActiveTask.status,
+      savedState: getTaskSavedState(savedActiveTask)
+    };
+  }
+  if (activeTasks[0]) {
+    return {
+      kind: "task",
+      id: activeTasks[0].id,
+      name: activeTasks[0].name,
+      status: activeTasks[0].status,
+      savedState: null
+    };
+  }
+  const plannedTask = [...project.tasks].filter((task) => task.status === "planned").sort(compareUpdatedDesc)[0];
+  if (plannedTask) {
+    return {
+      kind: "task",
+      id: plannedTask.id,
+      name: plannedTask.name,
+      status: plannedTask.status,
+      savedState: getTaskSavedState(plannedTask)
+    };
+  }
+  const nextMilestone = project.milestones.find((milestone) => milestone.status !== "completed");
+  if (nextMilestone) {
+    return {
+      kind: "milestone",
+      id: nextMilestone.id,
+      name: nextMilestone.name,
+      status: nextMilestone.status,
+      savedState: null
+    };
+  }
+  return null;
+}
+function recommendNextStep(lifecycle, project, notes, resumeTarget) {
+  const latestBlockerNote = notes.find((note) => note.type === "blocker" || note.type === "issue");
+  const blockedTask = [...project.tasks].filter((task) => TASK_BLOCKED_STATUSES.has(task.status ?? "")).sort(compareUpdatedDesc)[0];
+  if (lifecycle === "completed") {
+    return "Review the closeout state and decide whether to archive this project or open the next phase.";
+  }
+  if (lifecycle === "blocked") {
+    if (blockedTask) {
+      return `Resolve the blocker on "${blockedTask.name}" before starting new work.`;
+    }
+    if (latestBlockerNote) {
+      return `Address the latest ${latestBlockerNote.type ?? "blocker"} note, then update the project once it is cleared.`;
+    }
+    return "Clear the blocking issue first, then resume the next concrete task.";
+  }
+  if (resumeTarget?.kind === "task") {
+    if (resumeTarget.savedState) {
+      return `Resume "${resumeTarget.name}" from the saved task context.`;
+    }
+    return `Resume "${resumeTarget.name}" and record fresh resume context once the next checkpoint is stable.`;
+  }
+  if (resumeTarget?.kind === "milestone") {
+    return `Start milestone "${resumeTarget.name}" and create the first concrete task under it.`;
+  }
+  const latestNote = notes[0];
+  if (latestNote) {
+    return "Review the latest project note and turn it into the next concrete task or milestone.";
+  }
+  return "Add the next concrete task or milestone before resuming work.";
+}
+function buildProjectWorkBrief(project, notes) {
+  const taskProgress = {
+    total: project.tasks.length,
+    completed: project.tasks.filter((task) => TASK_DONE_STATUSES.has(task.status ?? "")).length,
+    active: project.tasks.filter((task) => TASK_ACTIVE_STATUSES.has(task.status ?? "")).length,
+    blocked: project.tasks.filter((task) => TASK_BLOCKED_STATUSES.has(task.status ?? "")).length
+  };
+  const milestoneProgress = {
+    total: project.milestones.length,
+    completed: project.milestones.filter((milestone) => milestone.status === "completed").length,
+    inProgress: project.milestones.filter((milestone) => milestone.status === "in_progress").length,
+    blocked: project.milestones.filter((milestone) => MILESTONE_BLOCKED_STATUSES.has(milestone.status ?? "")).length
+  };
+  const lifecycle = deriveLifecycle(project, taskProgress, milestoneProgress);
+  const resumeTarget = selectResumeTarget(project);
+  return {
+    project: {
+      id: project.id,
+      name: project.name,
+      kind: project.kind,
+      status: project.status,
+      description: project.description
+    },
+    lifecycle,
+    progress: {
+      milestones: milestoneProgress,
+      tasks: taskProgress
+    },
+    recentNotes: notes.slice(0, 3).map((note) => ({
+      id: note.id,
+      type: note.type,
+      occurredAt: note.occurred_at,
+      summary: summarizeText(note.summary ?? note.content)
+    })),
+    resumeTarget,
+    recommendedNextStep: recommendNextStep(lifecycle, project, notes, resumeTarget)
+  };
+}
+function renderProjectWorkBrief(brief) {
+  const lines = [
+    `Project work brief: ${brief.project.name}`,
+    `  ID: ${brief.project.id}`,
+    `  Lifecycle: ${brief.lifecycle}`,
+    `  Status: ${brief.project.status ?? "unknown"}`
+  ];
+  if (brief.project.kind) {
+    lines.push(`  Kind: ${brief.project.kind}`);
+  }
+  if (brief.project.description) {
+    lines.push(`  ${brief.project.description}`);
+  }
+  lines.push("");
+  lines.push("Progress");
+  lines.push(
+    `  Milestones: ${brief.progress.milestones.completed}/${brief.progress.milestones.total} completed, ${brief.progress.milestones.inProgress} in progress, ${brief.progress.milestones.blocked} blocked`
+  );
+  lines.push(
+    `  Tasks: ${brief.progress.tasks.completed}/${brief.progress.tasks.total} completed, ${brief.progress.tasks.active} active, ${brief.progress.tasks.blocked} blocked`
+  );
+  lines.push("");
+  lines.push("Recent notes");
+  if (brief.recentNotes.length === 0) {
+    lines.push("  No recent notes recorded.");
+  } else {
+    for (const note of brief.recentNotes) {
+      const dateLabel = note.occurredAt ? note.occurredAt.slice(0, 10) : "unknown-date";
+      lines.push(`  - ${dateLabel} ${note.type ?? "status_update"}: ${note.summary}`);
+    }
+  }
+  lines.push("");
+  lines.push("Resume target");
+  if (!brief.resumeTarget) {
+    lines.push("  No clear resume target yet.");
+  } else {
+    lines.push(
+      `  ${brief.resumeTarget.kind}: ${brief.resumeTarget.name} (${brief.resumeTarget.status ?? "unknown"})`
+    );
+    if (brief.resumeTarget.savedState) {
+      lines.push(`  Saved state: ${brief.resumeTarget.savedState}`);
+    }
+  }
+  lines.push("");
+  lines.push("Recommended next step");
+  lines.push(`  ${brief.recommendedNextStep}`);
+  return lines.join("\n");
+}
+
 // src/cli/commands/project/projects.ts
 function registerProjectList(program3) {
-  program3.command("project:list").description("List all projects\n  Example: elevasis-sdk project:list --kind internal").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("--api-url <url>", "API base URL").option("--pretty", "Render human-readable output instead of raw JSON").action(
-    wrapAction("project:list", async (options2) => {
-      const apiUrl = resolveApiUrl(options2.apiUrl);
-      const params = new URLSearchParams();
-      if (options2.kind) params.set("kind", options2.kind);
-      if (options2.status) params.set("status", options2.status);
-      const qs = params.toString();
-      const endpoint = `/api/external/projects${qs ? `?${qs}` : ""}`;
-      const result = await apiGet(endpoint, apiUrl);
-      if (options2.pretty) {
-        const projects = result.projects;
-        if (projects.length === 0) {
-          console.log(source_default.yellow("No projects found."));
-          return;
-        }
-        console.log(source_default.cyan(`
+  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("--api-url <url>", "API base URL").option("--pretty", "Render human-readable output instead of raw JSON").action(
+    wrapAction(
+      "project:list",
+      async (options2) => {
+        const apiUrl = resolveApiUrl(options2.apiUrl);
+        const params = new URLSearchParams();
+        if (options2.kind) params.set("kind", options2.kind);
+        if (options2.status) params.set("status", options2.status);
+        if (options2.search) params.set("search", options2.search);
+        const qs = params.toString();
+        const endpoint = `/api/external/projects${qs ? `?${qs}` : ""}`;
+        const result = await apiGet(endpoint, apiUrl);
+        if (options2.pretty) {
+          const projects = result.projects;
+          if (projects.length === 0) {
+            console.log(source_default.yellow("No projects found."));
+            return;
+          }
+          console.log(source_default.cyan(`
 Projects (${projects.length}):
 `));
-        for (const p of projects) {
-          console.log(`  ${source_default.bold(p.name)}  ${source_default.dim(p.kind)}  ${source_default.gray(p.status)}`);
-          console.log(source_default.gray(`    ID: ${p.id}`));
-          if (p.description) console.log(source_default.gray(`    ${p.description}`));
+          for (const p of projects) {
+            console.log(`  ${source_default.bold(p.name)}  ${source_default.dim(p.kind)}  ${source_default.gray(p.status)}`);
+            console.log(source_default.gray(`    ID: ${p.id}`));
+            if (p.description) console.log(source_default.gray(`    ${p.description}`));
+          }
+          console.log();
+        } else {
+          console.log(JSON.stringify(result, null, 2));
         }
+      }
+    )
+  );
+}
+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(
+    wrapAction("project:resolve", async (query, options2) => {
+      const project = await resolveProject(query, options2.apiUrl);
+      if (options2.pretty) {
+        console.log(source_default.cyan(`
+Resolved project: ${project.name}`));
+        console.log(source_default.gray(`  ID:     ${project.id}`));
+        if (project.kind) console.log(source_default.gray(`  Kind:   ${project.kind}`));
+        if (project.status) console.log(source_default.gray(`  Status: ${project.status}`));
+        if (project.description) console.log(source_default.gray(`  ${project.description}`));
         console.log();
       } else {
-        console.log(JSON.stringify(result, null, 2));
+        console.log(project.id);
       }
     })
   );
 }
+function registerProjectWork(program3) {
+  program3.command("project:work <query>").alias("project:open").description(
+    'Resolve a project and print a lifecycle-aware work brief\n  Example: elevasis-sdk project:work "Alpha"'
+  ).option("--api-url <url>", "API base URL").option("--json", "Render the structured work brief as JSON").action(
+    wrapAction("project:work", async (query, options2) => {
+      const apiUrl = resolveApiUrl(options2.apiUrl);
+      const resolved = await resolveProject(query, options2.apiUrl);
+      const [projectResult, notesResult] = await Promise.all([
+        apiGet(`/api/external/projects/${resolved.id}`, apiUrl),
+        apiGet(`/api/external/projects/${resolved.id}/notes`, apiUrl)
+      ]);
+      const brief = buildProjectWorkBrief(projectResult.project, notesResult.notes);
+      if (options2.json) {
+        console.log(JSON.stringify(brief, null, 2));
+        return;
+      }
+      console.log(source_default.cyan(`
+${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(
     wrapAction("project:get", async (id, options2) => {
@@ -45283,7 +45565,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("--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-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(
     wrapAction(
       "project:create",
       async (options2) => {
@@ -45294,6 +45576,12 @@ function registerProjectCreate(program3) {
         };
         if (options2.status) body.status = options2.status;
         if (options2.description) body.description = options2.description;
+        if (options2.dealId) body.deal_id = options2.dealId;
+        if (options2.clientCompanyId) body.client_company_id = options2.clientCompanyId;
+        if (options2.startDate) body.start_date = options2.startDate;
+        if (options2.targetEndDate) body.target_end_date = options2.targetEndDate;
+        if (options2.contractValue !== void 0) body.contract_value = options2.contractValue;
+        if (options2.metadata) body.metadata = JSON.parse(options2.metadata);
         const result = await apiPost("/api/external/projects", body, apiUrl);
         if (options2.pretty) {
           const p = result.project;
@@ -45311,7 +45599,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("--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-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(
     wrapAction(
       "project:update",
       async (id, options2) => {
@@ -45319,10 +45607,17 @@ function registerProjectUpdate(program3) {
         if (options2.name !== void 0) body.name = options2.name;
         if (options2.status !== void 0) body.status = options2.status;
         if (options2.description !== void 0) body.description = options2.description;
+        if (options2.dealId !== void 0) body.deal_id = options2.dealId;
+        if (options2.clientCompanyId !== void 0) body.client_company_id = options2.clientCompanyId;
+        if (options2.startDate !== void 0) body.start_date = options2.startDate;
+        if (options2.targetEndDate !== void 0) body.target_end_date = options2.targetEndDate;
+        if (options2.actualEndDate !== void 0) body.actual_end_date = options2.actualEndDate;
+        if (options2.contractValue !== void 0) body.contract_value = options2.contractValue;
+        if (options2.metadata !== void 0) body.metadata = JSON.parse(options2.metadata);
         if (Object.keys(body).length === 0) {
           process.stderr.write(
             JSON.stringify({
-              error: "At least one field must be provided (--name, --status, --description)",
+              error: "At least one field must be provided (--name, --status, --description, --deal-id, --client-company-id, --start-date, --target-end-date, --actual-end-date, --contract-value, --metadata)",
               code: "MISSING_FIELDS"
             }) + "\n"
           );
@@ -45419,7 +45714,7 @@ Milestone created: ${m.name}`));
   );
 }
 function registerMilestoneUpdate(program3) {
-  program3.command("project:milestone:update <id>").description("Update a milestone\n  Example: elevasis-sdk project:milestone:update <uuid> --status completed").option("--name <name>", "New milestone name").option("--status <status>", "New status: upcoming | in_progress | completed | overdue | blocked").option("--due-date <date>", "New due date (ISO 8601)").option("--api-url <url>", "API base URL").option("--pretty", "Render human-readable output instead of raw JSON").action(
+  program3.command("project:milestone:update <id>").description("Update a milestone\n  Example: elevasis-sdk project:milestone:update <uuid> --status completed").option("--name <name>", "New milestone name").option("--status <status>", "New status: upcoming | in_progress | completed | overdue | blocked").option("--due-date <date>", "New due date (ISO 8601)").option("--checklist <json>", `Replace checklist (full array): '[{"id":"1","label":"Step","completed":false}]'`).option("--api-url <url>", "API base URL").option("--pretty", "Render human-readable output instead of raw JSON").action(
     wrapAction(
       "project:milestone:update",
       async (id, options2) => {
@@ -45427,10 +45722,20 @@ function registerMilestoneUpdate(program3) {
         if (options2.name !== void 0) body.name = options2.name;
         if (options2.status !== void 0) body.status = options2.status;
         if (options2.dueDate !== void 0) body.due_date = options2.dueDate;
+        if (options2.checklist !== void 0) {
+          try {
+            body.checklist = JSON.parse(options2.checklist);
+          } catch {
+            process.stderr.write(
+              JSON.stringify({ error: "--checklist must be valid JSON", code: "INVALID_JSON" }) + "\n"
+            );
+            process.exit(1);
+          }
+        }
         if (Object.keys(body).length === 0) {
           process.stderr.write(
             JSON.stringify({
-              error: "At least one field must be provided (--name, --status, --due-date)",
+              error: "At least one field must be provided (--name, --status, --due-date, --checklist)",
               code: "MISSING_FIELDS"
             }) + "\n"
           );
@@ -45578,7 +45883,7 @@ function registerTaskUpdate(program3) {
   program3.command("project:task:update <id>").description("Update a task\n  Example: elevasis-sdk project:task:update <uuid> --status completed").option("--title <title>", "New task title").option(
     "--status <status>",
     "New status: planned | in_progress | blocked | completed | cancelled | submitted | approved | rejected | revision_requested"
-  ).option("--milestone <milestone-id>", "New milestone ID (UUID)").option("--description <description>", "New description").option("--api-url <url>", "API base URL").option("--pretty", "Render human-readable output instead of raw JSON").action(
+  ).option("--milestone <milestone-id>", "New milestone ID (UUID)").option("--description <description>", "New description").option("--checklist <json>", `Replace checklist (full array): '[{"id":"1","label":"Step","completed":false}]'`).option("--api-url <url>", "API base URL").option("--pretty", "Render human-readable output instead of raw JSON").action(
     wrapAction(
       "project:task:update",
       async (id, options2) => {
@@ -45587,10 +45892,20 @@ function registerTaskUpdate(program3) {
         if (options2.status !== void 0) body.status = options2.status;
         if (options2.milestone !== void 0) body.milestone_id = options2.milestone;
         if (options2.description !== void 0) body.description = options2.description;
+        if (options2.checklist !== void 0) {
+          try {
+            body.checklist = JSON.parse(options2.checklist);
+          } catch {
+            process.stderr.write(
+              JSON.stringify({ error: "--checklist must be valid JSON", code: "INVALID_JSON" }) + "\n"
+            );
+            process.exit(1);
+          }
+        }
         if (Object.keys(body).length === 0) {
           process.stderr.write(
             JSON.stringify({
-              error: "At least one field must be provided (--title, --status, --milestone, --description)",
+              error: "At least one field must be provided (--title, --status, --milestone, --description, --checklist)",
               code: "MISSING_FIELDS"
             }) + "\n"
           );
@@ -45766,7 +46081,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: call_note | status_update | issue | blocker").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: call_note | status_update | issue | blocker | agent_learning").option("--api-url <url>", "API base URL").option("--pretty", "Render human-readable output instead of raw JSON").action(
     wrapAction(
       "project:note:create",
       async (options2) => {
@@ -45827,6 +46142,8 @@ Note ${id} deleted.`));
 // src/cli/commands/project/project.ts
 function registerProjectCommands(program3) {
   registerProjectList(program3);
+  registerProjectResolve(program3);
+  registerProjectWork(program3);
   registerProjectGet(program3);
   registerProjectCreate(program3);
   registerProjectUpdate(program3);
@@ -45848,6 +46165,520 @@ function registerProjectCommands(program3) {
   registerNoteDelete(program3);
 }
 
+// src/cli/commands/init-claude.ts
+var import_path4 = require("path");
+var import_fs2 = require("fs");
+var import_url = require("url");
+var import_meta = {};
+var _filename = import_meta.url ? (0, import_url.fileURLToPath)(import_meta.url) : process.argv[1];
+var _dirname = (0, import_path4.dirname)(_filename);
+function copyDirectoryRecursive(sourceDir, targetDir) {
+  if (!(0, import_fs2.existsSync)(sourceDir)) return 0;
+  let count = 0;
+  for (const entry of (0, import_fs2.readdirSync)(sourceDir, { withFileTypes: true })) {
+    const srcPath = (0, import_path4.join)(sourceDir, entry.name);
+    const destPath = (0, import_path4.join)(targetDir, entry.name);
+    if (entry.isDirectory()) {
+      count += copyDirectoryRecursive(srcPath, destPath);
+    } else {
+      (0, import_fs2.mkdirSync)((0, import_path4.dirname)(destPath), { recursive: true });
+      (0, import_fs2.writeFileSync)(destPath, (0, import_fs2.readFileSync)(srcPath, "utf-8"), "utf-8");
+      count++;
+    }
+  }
+  return count;
+}
+function listFilesRecursive(dir, prefix = "") {
+  for (const entry of (0, import_fs2.readdirSync)(dir, { withFileTypes: true })) {
+    const rel = prefix ? `${prefix}/${entry.name}` : entry.name;
+    if (entry.isDirectory()) {
+      listFilesRecursive((0, import_path4.join)(dir, entry.name), rel);
+    } else {
+      console.log(source_default.gray(`  .claude/${rel}`));
+    }
+  }
+}
+function registerInitClaudeCommand(program3) {
+  program3.command("init-claude").description("Initialize or update .claude/ configuration from SDK defaults").option("--dry-run", "Show what would be copied without writing files").action(
+    wrapAction("init-claude", async (options2) => {
+      const spinner = ora("Initializing .claude/ configuration...").start();
+      const claudeConfigSource = (0, import_path4.resolve)(_dirname, "..", "reference", "claude-config");
+      if (!(0, import_fs2.existsSync)(claudeConfigSource)) {
+        spinner.fail("Claude config source not found in SDK package");
+        console.error(source_default.gray(`  Expected: ${claudeConfigSource}`));
+        console.error(source_default.gray("  This may indicate an incomplete SDK build."));
+        throw new Error("Claude config source not found");
+      }
+      const targetDir = (0, import_path4.resolve)(process.cwd(), ".claude");
+      if (options2.dryRun) {
+        spinner.info("Dry run -- listing files that would be copied:");
+        listFilesRecursive(claudeConfigSource);
+        return;
+      }
+      const count = copyDirectoryRecursive(claudeConfigSource, targetDir);
+      spinner.succeed(
+        source_default.green(".claude/ configuration initialized") + source_default.gray(` (${count} file${count !== 1 ? "s" : ""} written)`)
+      );
+    })
+  );
+}
+
+// src/cli/commands/generate-docs.ts
+var import_fs3 = require("fs");
+var import_path5 = require("path");
+var EXCLUDED_ROOT_FILES = /* @__PURE__ */ new Set(["platform-navigation-map.md"]);
+var SECTION_ORDER = ["ui", "operations", "knowledge"];
+var LAST_SECTIONS = ["in-progress"];
+function parseFrontmatter(content) {
+  const match = content.match(/^---\r?\n([\s\S]*?)\r?\n---/);
+  if (!match) return null;
+  const fm = {};
+  for (const line of match[1].split("\n")) {
+    const idx = line.indexOf(":");
+    if (idx === -1) continue;
+    const key = line.slice(0, idx).trim();
+    const val = line.slice(idx + 1).trim();
+    fm[key] = val;
+  }
+  return fm;
+}
+function findMdFiles(dir, docsDir, indexPath, files = []) {
+  for (const entry of (0, import_fs3.readdirSync)(dir)) {
+    if (entry.startsWith(".")) continue;
+    const full = (0, import_path5.join)(dir, entry);
+    const stat = (0, import_fs3.statSync)(full);
+    if (stat.isDirectory()) {
+      findMdFiles(full, docsDir, indexPath, files);
+    } else if (entry.endsWith(".md") && full !== indexPath) {
+      if (dir === docsDir && EXCLUDED_ROOT_FILES.has(entry)) continue;
+      files.push(full);
+    }
+  }
+  return files;
+}
+function sectionTitle(slug) {
+  if (slug === "ui") return "UI";
+  return slug.split("-").map((w) => w[0].toUpperCase() + w.slice(1)).join(" ");
+}
+function generateDocsIndex(docsDir) {
+  const indexPath = (0, import_path5.join)(docsDir, "index.md");
+  const files = findMdFiles(docsDir, docsDir, indexPath);
+  const sections = /* @__PURE__ */ new Map();
+  let warnings = 0;
+  for (const file2 of files) {
+    const rel = (0, import_path5.relative)(docsDir, file2).replace(/\\/g, "/");
+    const content2 = (0, import_fs3.readFileSync)(file2, "utf-8");
+    const fm = parseFrontmatter(content2);
+    if (!fm || !fm["title"]) {
+      console.warn(`WARNING: Missing frontmatter in ${rel} -- skipping`);
+      warnings++;
+      continue;
+    }
+    const topDir = rel.includes("/") ? rel.split("/")[0] : "_root";
+    if (!sections.has(topDir)) sections.set(topDir, []);
+    sections.get(topDir).push({ rel, title: fm["title"], description: fm["description"] || "", status: fm["status"] });
+  }
+  for (const entries of sections.values()) {
+    entries.sort((a, b) => a.title.localeCompare(b.title));
+  }
+  const orderedSections = [];
+  for (const s of SECTION_ORDER) {
+    if (sections.has(s)) orderedSections.push(s);
+  }
+  for (const s of [...sections.keys()].sort()) {
+    if (!SECTION_ORDER.includes(s) && !LAST_SECTIONS.includes(s) && s !== "_root") {
+      orderedSections.push(s);
+    }
+  }
+  for (const s of LAST_SECTIONS) {
+    if (sections.has(s)) orderedSections.push(s);
+  }
+  if (sections.has("_root")) orderedSections.push("_root");
+  const lines = [
+    "---",
+    "title: Documentation Index",
+    "description: Auto-generated navigation hub of all project documentation",
+    "---",
+    "",
+    "<!-- AUTO-GENERATED by elevasis-sdk generate-docs -- do not edit manually -->",
+    "",
+    "# Documentation Index",
+    "",
+    `> Last generated: ${(/* @__PURE__ */ new Date()).toISOString().split("T")[0]}`,
+    ""
+  ];
+  if (orderedSections.length === 0) {
+    lines.push("No documented files found. Add frontmatter (`title`, `description`) to `.md` files in `docs/`.");
+    lines.push("");
+  } else {
+    for (const section of orderedSections) {
+      const entries = sections.get(section);
+      if (!entries || entries.length === 0) continue;
+      const title = section === "_root" ? "General" : sectionTitle(section);
+      lines.push(`## ${title}`);
+      lines.push("");
+      for (const entry of entries) {
+        const status = entry.status ? ` -- *${entry.status}*` : "";
+        const desc = entry.description ? ` -- ${entry.description}` : "";
+        lines.push(`- [${entry.title}](${entry.rel})${desc}${status}`);
+      }
+      lines.push("");
+    }
+  }
+  const content = lines.join("\n");
+  const docCount = files.length - warnings;
+  console.log(
+    `Generated docs/index.md: ${docCount} doc(s) indexed across ${orderedSections.length} section(s)` + (warnings > 0 ? ` (${warnings} skipped -- missing frontmatter)` : "")
+  );
+  return content;
+}
+function registerGenerateDocsCommand(program3) {
+  program3.command("generate-docs").description("Generate docs/index.md from documentation frontmatter").option("--docs-dir <path>", "Path to docs directory (default: ./docs)").action(
+    wrapAction("generate-docs", async (options2) => {
+      const docsDir = (0, import_path5.resolve)(options2.docsDir ?? "./docs");
+      const indexPath = (0, import_path5.join)(docsDir, "index.md");
+      const spinner = ora("Generating docs/index.md...").start();
+      const content = generateDocsIndex(docsDir);
+      (0, import_fs3.writeFileSync)(indexPath, content);
+      spinner.succeed(source_default.green("Generated docs/index.md"));
+    })
+  );
+}
+
+// src/cli/commands/generate-resources.ts
+var import_promises2 = require("fs/promises");
+var import_path6 = require("path");
+function escapePipes(text) {
+  return text.replace(/\|/g, "\\|");
+}
+function noneIfEmpty(lines, body) {
+  const result = body();
+  if (result.length === 0) {
+    return [...lines, "_(none)_", ""];
+  }
+  return [...lines, ...result, ""];
+}
+function extractSchemaKeys(schema) {
+  if (!schema || typeof schema !== "object") return null;
+  const s = schema;
+  if (s.shape && typeof s.shape === "object") {
+    return Object.keys(s.shape).join(", ");
+  }
+  if (s._def && typeof s._def === "object") {
+    const def = s._def;
+    if (typeof def.shape === "function") {
+      try {
+        const shape = def.shape();
+        return Object.keys(shape).join(", ");
+      } catch {
+        return null;
+      }
+    }
+    if (Array.isArray(def.options) && def.options.every((o) => typeof o === "string")) {
+      return def.options.join(" | ");
+    }
+  }
+  if (s.properties && typeof s.properties === "object") {
+    return Object.keys(s.properties).join(", ");
+  }
+  return null;
+}
+async function generateResourcesContent(spec) {
+  const workflows = spec.workflows ?? [];
+  const agents = spec.agents ?? [];
+  const triggers = spec.triggers ?? [];
+  const integrations = spec.integrations ?? [];
+  const relationships = spec.relationships ?? {};
+  const externalResources = spec.externalResources ?? [];
+  const humanCheckpoints = spec.humanCheckpoints ?? [];
+  const lines = [
+    "---",
+    "title: Platform Topology Map",
+    "description: Auto-generated topology map for workflows, agents, relationships, triggers, integrations, and checkpoints declared in the DeploymentSpec",
+    "---",
+    "",
+    "<!-- AUTO-GENERATED by elevasis-sdk generate-resources -- do not edit manually -->",
+    "",
+    "# Platform Topology Map",
+    "",
+    "> Auto-generated from `operations/src/index.ts`. Regenerate with `pnpm exec elevasis-sdk generate-resources`.",
+    "",
+    "Use this as the scaffold topology map for operational impact analysis.",
+    "",
+    "- Start here to understand what `operations/src/index.ts` deploys and how those resources connect.",
+    "- Read it with `operations/src/README.md` when changing resource registration or deployment structure.",
+    "- Treat `elevasis-sdk generate-resources` and the current `DeploymentSpec` as the source of truth for what this map can and cannot show.",
+    ""
+  ];
+  const total = workflows.length + agents.length;
+  lines.push("## Topology Summary", "");
+  lines.push(`- Deployable resources: ${total}`);
+  lines.push(`- Workflows: ${workflows.length}`);
+  lines.push(`- Agents: ${agents.length}`);
+  lines.push(`- Triggers: ${triggers.length}`);
+  lines.push(`- Integrations: ${integrations.length}`);
+  lines.push(`- Human checkpoints: ${humanCheckpoints.length}`);
+  lines.push(`- External resources: ${externalResources.length}`);
+  lines.push(`- Relationship declarations: ${Object.keys(relationships).length}`);
+  lines.push("");
+  lines.push("## Deployed Resource Inventory", "");
+  lines.push(
+    ...noneIfEmpty([], () => {
+      if (workflows.length === 0 && agents.length === 0) return [];
+      const rows = [];
+      if (workflows.length > 0) {
+        rows.push("### Workflows", "");
+        rows.push("| Resource ID | Name | Version | Status | Description | Domains |");
+        rows.push("| --- | --- | --- | --- | --- | --- |");
+        for (const wf of workflows) {
+          const { resourceId, name, version: version2, status, description, domains } = wf.config;
+          const domainStr = domains?.join(", ") ?? "";
+          rows.push(
+            `| \`${escapePipes(resourceId)}\` | ${escapePipes(name)} | ${escapePipes(version2)} | ${escapePipes(status)} | ${escapePipes(description ?? "")} | ${escapePipes(domainStr)} |`
+          );
+        }
+        rows.push("");
+      }
+      if (agents.length > 0) {
+        rows.push("### Agents", "");
+        rows.push("| Resource ID | Name | Version | Status | Description | Domains | Session-Capable |");
+        rows.push("| --- | --- | --- | --- | --- | --- | --- |");
+        for (const ag of agents) {
+          const { resourceId, name, version: version2, status, description, domains } = ag.config;
+          const sessionCapable = ag.config.sessionCapable ? "Yes" : "No";
+          const domainStr = domains?.join(", ") ?? "";
+          rows.push(
+            `| \`${escapePipes(resourceId)}\` | ${escapePipes(name)} | ${escapePipes(version2)} | ${escapePipes(status)} | ${escapePipes(description ?? "")} | ${escapePipes(domainStr)} | ${sessionCapable} |`
+          );
+        }
+        rows.push("");
+      }
+      return rows;
+    })
+  );
+  lines.push("## Topology Relationships", "");
+  lines.push(
+    ...noneIfEmpty([], () => {
+      const entries = Object.entries(relationships).filter(([, decl]) => {
+        const hasTriggers = (decl.triggers?.agents?.length ?? 0) > 0 || (decl.triggers?.workflows?.length ?? 0) > 0;
+        const hasUses = (decl.uses?.integrations?.length ?? 0) > 0;
+        return hasTriggers || hasUses;
+      });
+      if (entries.length === 0) return [];
+      const rows = [];
+      for (const [resourceId, decl] of entries) {
+        rows.push(`- **\`${resourceId}\`**`);
+        const triggerAgents = decl.triggers?.agents ?? [];
+        const triggerWorkflows = decl.triggers?.workflows ?? [];
+        const usesIntegrations = decl.uses?.integrations ?? [];
+        if (triggerAgents.length > 0 || triggerWorkflows.length > 0) {
+          rows.push("  - Triggers:");
+          for (const id of triggerWorkflows) rows.push(`    - workflow \`${id}\``);
+          for (const id of triggerAgents) rows.push(`    - agent \`${id}\``);
+        }
+        if (usesIntegrations.length > 0) {
+          rows.push("  - Uses:");
+          for (const id of usesIntegrations) rows.push(`    - integration \`${id}\``);
+        }
+      }
+      return rows;
+    })
+  );
+  lines.push("## Triggers", "");
+  lines.push(
+    ...noneIfEmpty([], () => {
+      if (triggers.length === 0) return [];
+      const rows = [
+        "| Resource ID | Trigger Type | Webhook Path | Schedule | Event Type |",
+        "| --- | --- | --- | --- | --- |"
+      ];
+      for (const tr of triggers) {
+        const webhookPath = escapePipes(tr.webhookPath ?? "");
+        const schedule = escapePipes(tr.schedule ?? "");
+        const eventType = escapePipes(tr.eventType ?? "");
+        rows.push(
+          `| \`${escapePipes(tr.resourceId)}\` | ${escapePipes(tr.triggerType)} | ${webhookPath} | ${schedule} | ${eventType} |`
+        );
+      }
+      return rows;
+    })
+  );
+  lines.push("## Integrations", "");
+  lines.push(
+    ...noneIfEmpty([], () => {
+      if (integrations.length === 0) return [];
+      const rows = ["| Resource ID | Provider | Credential Name |", "| --- | --- | --- |"];
+      for (const ig of integrations) {
+        rows.push(
+          `| \`${escapePipes(ig.resourceId)}\` | ${escapePipes(ig.provider)} | \`${escapePipes(ig.credentialName)}\` |`
+        );
+      }
+      return rows;
+    })
+  );
+  lines.push("## Human Checkpoints", "");
+  lines.push(
+    ...noneIfEmpty([], () => {
+      if (humanCheckpoints.length === 0) return [];
+      const rows = [];
+      rows.push("| Resource ID | Requested By | Routes To |");
+      rows.push("| --- | --- | --- |");
+      for (const hc of humanCheckpoints) {
+        const requestedBy = [
+          ...(hc.requestedBy?.agents ?? []).map((id) => `agent \`${id}\``),
+          ...(hc.requestedBy?.workflows ?? []).map((id) => `workflow \`${id}\``)
+        ].join(", ");
+        const routesTo = [
+          ...(hc.routesTo?.agents ?? []).map((id) => `agent \`${id}\``),
+          ...(hc.routesTo?.workflows ?? []).map((id) => `workflow \`${id}\``)
+        ].join(", ");
+        rows.push(`| \`${escapePipes(hc.resourceId)}\` | ${escapePipes(requestedBy)} | ${escapePipes(routesTo)} |`);
+      }
+      return rows;
+    })
+  );
+  lines.push("## External Resources", "");
+  lines.push(
+    ...noneIfEmpty([], () => {
+      if (externalResources.length === 0) return [];
+      const rows = [
+        "| Resource ID | Platform | Platform URL | External ID | Triggers | Uses |",
+        "| --- | --- | --- | --- | --- | --- |"
+      ];
+      for (const er of externalResources) {
+        const triggersList = [
+          ...(er.triggers?.workflows ?? []).map((id) => `workflow \`${id}\``),
+          ...(er.triggers?.agents ?? []).map((id) => `agent \`${id}\``)
+        ].join(", ");
+        const usesList = (er.uses?.integrations ?? []).map((id) => `integration \`${id}\``).join(", ");
+        rows.push(
+          `| \`${escapePipes(er.resourceId)}\` | ${escapePipes(er.platform)} | ${escapePipes(er.platformUrl ?? "")} | ${escapePipes(er.externalId ?? "")} | ${escapePipes(triggersList)} | ${escapePipes(usesList)} |`
+        );
+      }
+      return rows;
+    })
+  );
+  lines.push("## Schema Signatures", "");
+  const allResources = [
+    ...workflows.map((wf) => ({ resourceId: wf.config.resourceId, contract: wf.contract })),
+    ...agents.map((ag) => ({ resourceId: ag.config.resourceId, contract: ag.contract }))
+  ];
+  lines.push(
+    ...noneIfEmpty([], () => {
+      if (allResources.length === 0) return [];
+      const rows = [];
+      for (const { resourceId, contract } of allResources) {
+        const inputKeys = contract?.inputSchema ? extractSchemaKeys(contract.inputSchema) : null;
+        const outputKeys = contract?.outputSchema ? extractSchemaKeys(contract.outputSchema) : null;
+        const inputSig = inputKeys !== null ? `\`{ ${inputKeys} }\`` : "_schema introspection unavailable \u2014 see source_";
+        const outputSig = outputKeys !== null ? `\`{ ${outputKeys} }\`` : "_schema introspection unavailable \u2014 see source_";
+        rows.push(`- **\`${resourceId}\`**`);
+        rows.push(`  - input: ${inputSig}`);
+        rows.push(`  - output: ${outputSig}`);
+      }
+      return rows;
+    })
+  );
+  lines.push(
+    `**Total:** ${total} resource${total !== 1 ? "s" : ""} (${workflows.length} workflow${workflows.length !== 1 ? "s" : ""}, ${agents.length} agent${agents.length !== 1 ? "s" : ""})`
+  );
+  lines.push("");
+  return lines.join("\n");
+}
+function registerGenerateResourcesCommand(program3) {
+  program3.command("generate-resources").description("Generate docs/resources.md from the DeploymentSpec").option("--entry <path>", "Path to operations entry file (default: ./src/index.ts)").option("--docs-dir <path>", "Path to docs directory (default: ../docs from entry)").action(
+    wrapAction("generate-resources", async (options2) => {
+      const entryPath = options2.entry ?? "./src/index.ts";
+      const spinner = ora("Generating resources documentation...").start();
+      const entryModule = await loadTsModule(entryPath);
+      const spec = entryModule.default;
+      if (!spec) {
+        spinner.fail("Invalid entry: no default export found");
+        throw new Error("Invalid entry");
+      }
+      const docsDir = (0, import_path6.resolve)(options2.docsDir ?? (0, import_path6.resolve)(entryPath, "../../docs"));
+      const docsPath = (0, import_path6.resolve)(docsDir, "resources.md");
+      const content = await generateResourcesContent(spec);
+      await (0, import_promises2.mkdir)(docsDir, { recursive: true });
+      await (0, import_promises2.writeFile)(docsPath, content, "utf-8");
+      const workflows = spec.workflows ?? [];
+      const agents = spec.agents ?? [];
+      const total = workflows.length + agents.length;
+      spinner.succeed(source_default.green("Generated docs/resources.md"));
+      console.log(source_default.gray(`  ${total} resource(s) (${workflows.length} workflow(s), ${agents.length} agent(s))`));
+    })
+  );
+}
+
+// src/cli/commands/validate-docs.ts
+var import_fs4 = require("fs");
+var import_path7 = require("path");
+var import_child_process = require("child_process");
+function normalizeEol(value) {
+  return value.replace(/\r\n/g, "\n");
+}
+function readRequiredFile(filePath) {
+  if (!(0, import_fs4.existsSync)(filePath)) {
+    throw new Error(`Missing generated file: ${filePath}`);
+  }
+  return normalizeEol((0, import_fs4.readFileSync)(filePath, "utf8"));
+}
+function runPnpmExec(args, cwd) {
+  if (process.platform === "win32") {
+    const command = `pnpm exec ${args.join(" ")}`;
+    (0, import_child_process.execFileSync)(process.env["ComSpec"] ?? "cmd.exe", ["/d", "/s", "/c", command], {
+      cwd,
+      stdio: "pipe",
+      encoding: "utf8"
+    });
+    return;
+  }
+  (0, import_child_process.execFileSync)("pnpm", ["exec", ...args], {
+    cwd,
+    stdio: "pipe",
+    encoding: "utf8"
+  });
+}
+function validateCommandOutput(filePath, commandDescription, sdkArgs, cwd) {
+  const before = readRequiredFile(filePath);
+  runPnpmExec(sdkArgs, cwd);
+  const after = readRequiredFile(filePath);
+  if (before !== after) {
+    throw new Error(`Drift detected in ${filePath}. Regenerate with \`${commandDescription}\`.`);
+  }
+}
+function registerValidateDocsCommand(program3) {
+  program3.command("validate-docs").description("Validate that auto-generated docs are up to date").option("--docs-dir <path>", "Path to docs directory (default: ./docs)").option("--entry <path>", "Path to operations entry file for resources validation (default: ./src/index.ts)").action(
+    wrapAction("validate-docs", async (options2) => {
+      const spinner = ora("Validating generated docs...").start();
+      const projectRoot = process.cwd();
+      const docsDir = (0, import_path7.resolve)(options2.docsDir ?? "./docs");
+      const entryPath = options2.entry ?? "./src/index.ts";
+      spinner.text = "Validating docs/index.md...";
+      const indexPath = (0, import_path7.join)(docsDir, "index.md");
+      const generateDocsArgs = ["elevasis-sdk", "generate-docs", "--docs-dir", docsDir];
+      validateCommandOutput(indexPath, "pnpm exec elevasis-sdk generate-docs", generateDocsArgs, projectRoot);
+      spinner.text = "Validating docs/resources.md...";
+      const resourcesPath = (0, import_path7.join)(docsDir, "resources.md");
+      const generateResourcesArgs = [
+        "elevasis-sdk",
+        "generate-resources",
+        "--entry",
+        entryPath,
+        "--docs-dir",
+        docsDir
+      ];
+      validateCommandOutput(
+        resourcesPath,
+        "pnpm exec elevasis-sdk generate-resources",
+        generateResourcesArgs,
+        projectRoot
+      );
+      spinner.succeed(source_default.green("Generated docs are fresh."));
+    })
+  );
+}
+
 // src/cli/index.ts
 var envPath = findEnvFile();
 if (envPath) {
@@ -45873,7 +46704,14 @@ Commands:
   elevasis-sdk executions <resourceId>              List execution history
   elevasis-sdk execution <resourceId> <id>          Get execution details
   elevasis-sdk deployments                          List deployments
+  elevasis-sdk project:list [--search <query>]      List projects with optional search
+  elevasis-sdk project:resolve <query>              Resolve a project ID from a name or UUID
+  elevasis-sdk project:work <query>                 Open a lifecycle-aware project work brief
   elevasis-sdk rename <id> --to <newId> [--prod]     Rename resource across platform tables
+  elevasis-sdk init-claude                            Initialize .claude/ config from SDK
+  elevasis-sdk generate-docs                         Generate docs/index.md from frontmatter
+  elevasis-sdk generate-resources                    Generate docs/resources.md from DeploymentSpec
+  elevasis-sdk validate-docs                         Validate generated docs are fresh
 
 Use "elevasis-sdk <command> --help" for more information about a command.`
 ).version(SDK_VERSION);
@@ -45889,6 +46727,10 @@ registerCredsCommand(program2);
 registerErrorCommand(program2);
 registerRenameCommand(program2);
 registerProjectCommands(program2);
+registerInitClaudeCommand(program2);
+registerGenerateDocsCommand(program2);
+registerGenerateResourcesCommand(program2);
+registerValidateDocsCommand(program2);
 program2.parse();
 /*! Bundled license information: