@elevasis/sdk 1.8.3 → 1.9.0

package/dist/cli.cjs

@@ -6623,14 +6623,14 @@ var require_async_iterator = __commonJS({
       };
     }
     function readAndResolve(iter) {
-      var resolve5 = iter[kLastResolve];
-      if (resolve5 !== null) {
+      var resolve3 = iter[kLastResolve];
+      if (resolve3 !== null) {
         var data = iter[kStream].read();
         if (data !== null) {
           iter[kLastPromise] = null;
           iter[kLastResolve] = null;
           iter[kLastReject] = null;
-          resolve5(createIterResult(data, false));
+          resolve3(createIterResult(data, false));
         }
       }
     }
@@ -6638,13 +6638,13 @@ var require_async_iterator = __commonJS({
       process.nextTick(readAndResolve, iter);
     }
     function wrapForNext(lastPromise, iter) {
-      return function(resolve5, reject) {
+      return function(resolve3, reject) {
         lastPromise.then(function() {
           if (iter[kEnded]) {
-            resolve5(createIterResult(void 0, true));
+            resolve3(createIterResult(void 0, true));
             return;
           }
-          iter[kHandlePromise](resolve5, reject);
+          iter[kHandlePromise](resolve3, reject);
         }, reject);
       };
     }
@@ -6664,12 +6664,12 @@ var require_async_iterator = __commonJS({
           return Promise.resolve(createIterResult(void 0, true));
         }
         if (this[kStream].destroyed) {
-          return new Promise(function(resolve5, reject) {
+          return new Promise(function(resolve3, reject) {
             process.nextTick(function() {
               if (_this[kError]) {
                 reject(_this[kError]);
               } else {
-                resolve5(createIterResult(void 0, true));
+                resolve3(createIterResult(void 0, true));
               }
             });
           });
@@ -6692,13 +6692,13 @@ var require_async_iterator = __commonJS({
       return this;
     }), _defineProperty(_Object$setPrototypeO, "return", function _return() {
       var _this2 = this;
-      return new Promise(function(resolve5, reject) {
+      return new Promise(function(resolve3, reject) {
         _this2[kStream].destroy(null, function(err) {
           if (err) {
             reject(err);
             return;
           }
-          resolve5(createIterResult(void 0, true));
+          resolve3(createIterResult(void 0, true));
         });
       });
     }), _Object$setPrototypeO), AsyncIteratorPrototype);
@@ -6720,15 +6720,15 @@ var require_async_iterator = __commonJS({
         value: stream._readableState.endEmitted,
         writable: true
       }), _defineProperty(_Object$create, kHandlePromise, {
-        value: function value(resolve5, reject) {
+        value: function value(resolve3, reject) {
           var data = iterator[kStream].read();
           if (data) {
             iterator[kLastPromise] = null;
             iterator[kLastResolve] = null;
             iterator[kLastReject] = null;
-            resolve5(createIterResult(data, false));
+            resolve3(createIterResult(data, false));
           } else {
-            iterator[kLastResolve] = resolve5;
+            iterator[kLastResolve] = resolve3;
             iterator[kLastReject] = reject;
           }
         },
@@ -6747,12 +6747,12 @@ var require_async_iterator = __commonJS({
           iterator[kError] = err;
           return;
         }
-        var resolve5 = iterator[kLastResolve];
-        if (resolve5 !== null) {
+        var resolve3 = iterator[kLastResolve];
+        if (resolve3 !== null) {
           iterator[kLastPromise] = null;
           iterator[kLastResolve] = null;
           iterator[kLastReject] = null;
-          resolve5(createIterResult(void 0, true));
+          resolve3(createIterResult(void 0, true));
         }
         iterator[kEnded] = true;
       });
@@ -6767,7 +6767,7 @@ var require_async_iterator = __commonJS({
 var require_from = __commonJS({
   "../../node_modules/.pnpm/readable-stream@3.6.2/node_modules/readable-stream/lib/internal/streams/from.js"(exports2, module2) {
     "use strict";
-    function asyncGeneratorStep(gen, resolve5, reject, _next, _throw, key, arg) {
+    function asyncGeneratorStep(gen, resolve3, reject, _next, _throw, key, arg) {
       try {
         var info = gen[key](arg);
         var value = info.value;
@@ -6776,7 +6776,7 @@ var require_from = __commonJS({
         return;
       }
       if (info.done) {
-        resolve5(value);
+        resolve3(value);
       } else {
         Promise.resolve(value).then(_next, _throw);
       }
@@ -6784,13 +6784,13 @@ var require_from = __commonJS({
     function _asyncToGenerator(fn) {
       return function() {
         var self2 = this, args = arguments;
-        return new Promise(function(resolve5, reject) {
+        return new Promise(function(resolve3, reject) {
           var gen = fn.apply(self2, args);
           function _next(value) {
-            asyncGeneratorStep(gen, resolve5, reject, _next, _throw, "next", value);
+            asyncGeneratorStep(gen, resolve3, reject, _next, _throw, "next", value);
           }
           function _throw(err) {
-            asyncGeneratorStep(gen, resolve5, reject, _next, _throw, "throw", err);
+            asyncGeneratorStep(gen, resolve3, reject, _next, _throw, "throw", err);
           }
           _next(void 0);
         });
@@ -23012,6 +23012,8 @@ __export(index_exports, {
 });
 module.exports = __toCommonJS(index_exports);
 var import_dotenv = __toESM(require_main(), 1);
+var import_fs2 = require("fs");
+var import_path3 = require("path");
 
 // ../../node_modules/.pnpm/commander@11.1.0/node_modules/commander/esm.mjs
 var import_index = __toESM(require_commander(), 1);
@@ -23525,9 +23527,6 @@ var chalk = createChalk();
 var chalkStderr = createChalk({ level: stderrColor ? stderrColor.level : 0 });
 var source_default = chalk;
 
-// src/cli/commands/check.ts
-var import_path3 = require("path");
-
 // ../../node_modules/.pnpm/ora@7.0.1/node_modules/ora/index.js
 var import_node_process6 = __toESM(require("node:process"), 1);
 
@@ -36586,6 +36585,31 @@ config(en_default());
 // src/cli/commands/deploy.ts
 var import_module = require("module");
 
+// ../core/src/platform/utils/validation.ts
+var UuidSchema = external_exports.string().uuid();
+var NonEmptyStringSchema = external_exports.string().trim().min(1).max(1e3);
+var ResourceTypeSchema = external_exports.enum(["agent", "workflow"]);
+var OriginResourceTypeSchema = external_exports.enum(["agent", "workflow", "scheduler", "api"]);
+var CredentialNameSchema = external_exports.string().trim().toLowerCase().min(1, "Credential name required").max(100, "Credential name too long (max 100 chars)").regex(
+  /^[a-z0-9]+(-[a-z0-9]+)+$/,
+  "Credential name must be lowercase letters, numbers, and hyphens in format: service-environment (e.g., gmail-prod, attio-dev)"
+);
+var OAuthProviderSchema = external_exports.enum(["google-sheets", "dropbox"]);
+var OAuthCodeSchema = external_exports.string().min(10, "Authorization code too short").max(1e3, "Authorization code too long");
+var OAuthStateParamSchema = external_exports.string().min(10, "State parameter too short").max(2048, "State parameter too long");
+var SanitizedStringSchema = external_exports.string().trim().transform((str) => str.replace(/[<>'"]/g, ""));
+var EmailSchema = external_exports.string().email();
+var UrlSchema = external_exports.string().url();
+var PaginationSchema = external_exports.object({
+  limit: external_exports.coerce.number().int().min(1).max(100).default(20),
+  offset: external_exports.coerce.number().int().min(0).default(0)
+});
+var TimestampSchema = external_exports.string().datetime();
+var DateRangeSchema = external_exports.object({
+  startDate: external_exports.string().datetime(),
+  endDate: external_exports.string().datetime()
+});
+
 // ../core/src/platform/registry/domains.ts
 var DOMAINS = {
   // Business domains
@@ -40384,7 +40408,7 @@ function resolveApiKey(prod) {
   }
   return process.env.ELEVASIS_PLATFORM_KEY ?? "";
 }
-function findProjectRoot(startDir) {
+function tryFindProjectRoot(startDir) {
   const raw = (0, import_path.resolve)(startDir);
   let dir;
   try {
@@ -40398,6 +40422,11 @@ function findProjectRoot(startDir) {
     if (parent === dir) break;
     dir = parent;
   }
+  return null;
+}
+function findProjectRoot(startDir) {
+  const root = tryFindProjectRoot(startDir);
+  if (root !== null) return root;
   process.stderr.write(
     "Not inside an Elevasis project. Run this command from a project directory (an Elevasis project has a .elevasis file at its root).\n"
   );
@@ -40421,6 +40450,37 @@ function findEnvFile(_startDir) {
   const candidate = (0, import_path.join)(getProjectRoot(), ".env");
   return (0, import_fs.existsSync)(candidate) ? candidate : void 0;
 }
+function findPackageRoot(startDir) {
+  const raw = (0, import_path.resolve)(startDir);
+  let dir;
+  try {
+    dir = (0, import_fs.realpathSync)(raw);
+  } catch {
+    dir = raw;
+  }
+  const projectRoot = tryFindProjectRoot(dir);
+  while (true) {
+    if ((0, import_fs.existsSync)((0, import_path.join)(dir, "package.json"))) return dir;
+    const parent = (0, import_path.dirname)(dir);
+    if (parent === dir) break;
+    if (projectRoot !== null && dir === projectRoot) break;
+    dir = parent;
+  }
+  process.stderr.write(
+    "No package.json found between the current directory and the project root.\nRemediation: run this command from inside a package directory (one that contains package.json).\n"
+  );
+  process.exit(1);
+}
+var _packageRoot;
+function getPackageRoot() {
+  if (_packageRoot !== void 0) return _packageRoot;
+  _packageRoot = isHelpOrVersionOnly() ? process.cwd() : findPackageRoot(process.cwd());
+  return _packageRoot;
+}
+function resolvePackageRelative(relOrAbsPath) {
+  if ((0, import_path.isAbsolute)(relOrAbsPath)) return relOrAbsPath;
+  return (0, import_path.resolve)(getPackageRoot(), relOrAbsPath);
+}
 
 // src/cli/api-client.ts
 function getApiKey(apiUrl) {
@@ -40520,7 +40580,7 @@ function wrapAction(commandName, fn) {
 // package.json
 var package_default = {
   name: "@elevasis/sdk",
-  version: "1.8.3",
+  version: "1.9.0",
   description: "SDK for building Elevasis organization resources",
   type: "module",
   bin: {
@@ -40581,13 +40641,13 @@ var SDK_VERSION = package_default.version;
 
 // src/cli/commands/deploy.ts
 function getEsbuild() {
-  const consumerRequire = (0, import_module.createRequire)((0, import_path2.resolve)(process.cwd(), "package.json"));
+  const consumerRequire = (0, import_module.createRequire)(resolvePackageRelative("package.json"));
   return consumerRequire("esbuild");
 }
 async function loadTsModule(filePath) {
   const esbuild = getEsbuild();
-  const absPath = (0, import_path2.resolve)(filePath);
-  const tmpOut = (0, import_path2.resolve)(`.elevasis-tmp-${Date.now()}.mjs`);
+  const absPath = resolvePackageRelative(filePath);
+  const tmpOut = (0, import_path2.resolve)(getPackageRoot(), `.elevasis-tmp-${Date.now()}.mjs`);
   try {
     await esbuild.build({
       entryPoints: [absPath],
@@ -40685,7 +40745,7 @@ function registerDeployCommand(program3) {
           org = entryModule.default;
           if (!org) {
             validateSpinner.fail("Invalid entry: no default export found");
-            console.error(source_default.gray(`  Entry file: ${(0, import_path2.resolve)(entryPath)}`));
+            console.error(source_default.gray(`  Entry file: ${resolvePackageRelative(entryPath)}`));
             throw new Error("Invalid entry: no default export found");
           }
           new ResourceRegistry({ [orgName]: org });
@@ -40703,7 +40763,7 @@ function registerDeployCommand(program3) {
           const currentVersion = org.version;
           if (bumpType !== null) {
             const newVersion = bumpVersion(currentVersion, bumpType);
-            const absEntryPath = (0, import_path2.resolve)(entryPath);
+            const absEntryPath = resolvePackageRelative(entryPath);
             const entryContent = await (0, import_promises.readFile)(absEntryPath, "utf-8");
             const updatedContent = entryContent.replace(
               /version:\s*['"][\d]+\.[\d]+\.[\d]+['"]/,
@@ -40764,16 +40824,16 @@ function registerDeployCommand(program3) {
           console.log("");
         }
         const bundleSpinner = ora("Bundling...").start();
-        const wrapperPath = (0, import_path2.resolve)("__elevasis_worker.ts");
-        const bundleOutfile = (0, import_path2.resolve)("dist/bundle.js");
+        const wrapperPath = resolvePackageRelative("__elevasis_worker.ts");
+        const bundleOutfile = resolvePackageRelative("dist/bundle.js");
         try {
-          const entryImport = entryPath.replace(/\.ts$/, ".js");
-          const wrapperContent = `import org from ${JSON.stringify(entryImport)}
+          const absEntryForImport = resolvePackageRelative(entryPath).replace(/\.ts$/, ".js");
+          const wrapperContent = `import org from ${JSON.stringify(absEntryForImport)}
 import { startWorker } from '@elevasis/sdk/worker'
 startWorker(org)
 `;
           await (0, import_promises.writeFile)(wrapperPath, wrapperContent, "utf-8");
-          await (0, import_promises.mkdir)((0, import_path2.resolve)("dist"), { recursive: true });
+          await (0, import_promises.mkdir)(resolvePackageRelative("dist"), { recursive: true });
           const esbuild = getEsbuild();
           await esbuild.build({
             entryPoints: [wrapperPath],
@@ -40882,7 +40942,7 @@ function registerCheckCommand(program3) {
         const org = entryModule.default;
         if (!org) {
           spinner.fail("Invalid entry: no default export found");
-          console.error(source_default.gray(`  Entry file: ${(0, import_path3.resolve)(entryPath)}`));
+          console.error(source_default.gray(`  Entry file: ${resolvePackageRelative(entryPath)}`));
           console.error(source_default.gray("  Expected: export default { workflows: [...], agents: [...] }"));
           throw new Error("Invalid entry");
         }
@@ -40965,7 +41025,7 @@ async function pollForCompletion(resourceId, executionId, apiUrl) {
     if (interrupted) {
       return;
     }
-    await new Promise((resolve5) => setTimeout(resolve5, POLL_INTERVAL_MS));
+    await new Promise((resolve3) => setTimeout(resolve3, POLL_INTERVAL_MS));
     if (interrupted) {
       return;
     }
@@ -41580,10 +41640,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((resolve5) => {
+  return new Promise((resolve3) => {
     rl.question(message, (answer) => {
       rl.close();
-      resolve5(answer.toLowerCase() === "y" || answer.toLowerCase() === "yes");
+      resolve3(answer.toLowerCase() === "y" || answer.toLowerCase() === "yes");
     });
   });
 }
@@ -42198,13 +42258,14 @@ 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("--checklist <json>", `Replace checklist (full array): '[{"id":"1","label":"Step","completed":false}]'`).option("--api-url <url>", "API base URL").option("--pretty", "Render human-readable output instead of raw JSON").action(
+  program3.command("project:milestone:update <id>").description("Update a milestone\n  Example: elevasis-sdk project:milestone:update <uuid> --status completed").option("--name <name>", "New milestone name").option("--status <status>", "New status: upcoming | in_progress | completed | overdue | blocked").option("--description <description>", "New description").option("--due-date <date>", "New due date (ISO 8601)").option("--checklist <json>", `Replace checklist (full array): '[{"id":"1","label":"Step","completed":false}]'`).option("--api-url <url>", "API base URL").option("--pretty", "Render human-readable output instead of raw JSON").action(
     wrapAction(
       "project:milestone:update",
       async (id, options) => {
         const body = {};
         if (options.name !== void 0) body.name = options.name;
         if (options.status !== void 0) body.status = options.status;
+        if (options.description !== void 0) body.description = options.description;
         if (options.dueDate !== void 0) body.due_date = options.dueDate;
         if (options.checklist !== void 0) {
           try {
@@ -42219,7 +42280,7 @@ function registerMilestoneUpdate(program3) {
         if (Object.keys(body).length === 0) {
           process.stderr.write(
             JSON.stringify({
-              error: "At least one field must be provided (--name, --status, --due-date, --checklist)",
+              error: "At least one field must be provided (--name, --status, --description, --due-date, --checklist)",
               code: "MISSING_FIELDS"
             }) + "\n"
           );
@@ -42535,7 +42596,148 @@ Resume context saved for task ${id}`));
   );
 }
 
+// ../core/src/projects/api-schemas.ts
+var ProjectKindSchema = external_exports.enum(["client_engagement", "internal", "research", "other"]);
+var ProjectStatusSchema = external_exports.enum(["active", "on_track", "at_risk", "blocked", "completed", "paused"]);
+var MilestoneStatusSchema = external_exports.enum(["upcoming", "in_progress", "completed", "overdue", "blocked"]);
+var TaskStatusSchema = external_exports.enum([
+  "planned",
+  "in_progress",
+  "blocked",
+  "completed",
+  "cancelled",
+  "submitted",
+  "approved",
+  "rejected",
+  "revision_requested"
+]);
+var TaskTypeSchema = external_exports.enum([
+  "documentation",
+  "code",
+  "report",
+  "design",
+  "refactor",
+  "feature",
+  "bug",
+  "research",
+  "other"
+]);
+var NoteTypeSchema = external_exports.enum(["call_note", "status_update", "issue", "blocker", "agent_learning"]);
+var ChecklistItemSchema = external_exports.object({
+  id: external_exports.string(),
+  label: external_exports.string(),
+  completed: external_exports.boolean()
+});
+var ChecklistSchema = external_exports.array(ChecklistItemSchema);
+var ResumeContextSchema = external_exports.record(external_exports.string(), external_exports.unknown());
+var CreateProjectRequestSchema = external_exports.object({
+  name: external_exports.string().trim().min(1).max(255),
+  kind: ProjectKindSchema,
+  status: ProjectStatusSchema.optional(),
+  description: external_exports.string().nullable().optional(),
+  deal_id: UuidSchema.nullable().optional(),
+  client_company_id: UuidSchema.nullable().optional(),
+  start_date: external_exports.string().nullable().optional(),
+  target_end_date: external_exports.string().nullable().optional(),
+  contract_value: external_exports.number().nullable().optional(),
+  metadata: external_exports.record(external_exports.string(), external_exports.unknown()).nullable().optional()
+}).strict();
+var UpdateProjectRequestSchema = external_exports.object({
+  name: external_exports.string().trim().min(1).max(255).optional(),
+  kind: ProjectKindSchema.optional(),
+  status: ProjectStatusSchema.optional(),
+  description: external_exports.string().nullable().optional(),
+  deal_id: UuidSchema.nullable().optional(),
+  client_company_id: UuidSchema.nullable().optional(),
+  start_date: external_exports.string().nullable().optional(),
+  target_end_date: external_exports.string().nullable().optional(),
+  actual_end_date: external_exports.string().nullable().optional(),
+  contract_value: external_exports.number().nullable().optional(),
+  metadata: external_exports.record(external_exports.string(), external_exports.unknown()).nullable().optional()
+}).strict().refine((data) => Object.keys(data).length > 0, { message: "At least one field must be provided" });
+var GetProjectsQuerySchema = external_exports.object({
+  kind: ProjectKindSchema.optional(),
+  status: ProjectStatusSchema.optional(),
+  search: external_exports.string().trim().min(1).max(255).optional()
+}).strict();
+var ProjectIdParamsSchema = external_exports.object({ id: UuidSchema });
+var CreateMilestoneRequestSchema = external_exports.object({
+  name: external_exports.string().trim().min(1).max(255),
+  status: MilestoneStatusSchema.optional(),
+  description: external_exports.string().nullable().optional(),
+  due_date: external_exports.string().nullable().optional(),
+  sequence: external_exports.number().int().min(0).optional(),
+  metadata: external_exports.record(external_exports.string(), external_exports.unknown()).nullable().optional()
+}).strict();
+var UpdateMilestoneRequestSchema = external_exports.object({
+  name: external_exports.string().trim().min(1).max(255).optional(),
+  status: MilestoneStatusSchema.optional(),
+  description: external_exports.string().nullable().optional(),
+  due_date: external_exports.string().nullable().optional(),
+  completed_at: external_exports.string().nullable().optional(),
+  sequence: external_exports.number().int().min(0).optional(),
+  checklist: ChecklistSchema.optional(),
+  metadata: external_exports.record(external_exports.string(), external_exports.unknown()).nullable().optional()
+}).strict().refine((data) => Object.keys(data).length > 0, { message: "At least one field must be provided" });
+var ProjectIdPathParamsSchema = external_exports.object({ projectId: UuidSchema });
+var MilestoneIdParamsSchema = external_exports.object({ id: UuidSchema });
+var CreateTaskRequestSchema = external_exports.object({
+  project_id: UuidSchema,
+  name: external_exports.string().trim().min(1).max(255),
+  type: TaskTypeSchema.optional(),
+  status: TaskStatusSchema.optional(),
+  description: external_exports.string().nullable().optional(),
+  milestone_id: UuidSchema.nullable().optional(),
+  parent_task_id: UuidSchema.nullable().optional(),
+  due_date: external_exports.string().nullable().optional(),
+  checklist: ChecklistSchema.optional(),
+  resume_context: ResumeContextSchema.nullable().optional(),
+  metadata: external_exports.record(external_exports.string(), external_exports.unknown()).nullable().optional()
+}).strict();
+var UpdateTaskRequestSchema = external_exports.object({
+  name: external_exports.string().trim().min(1).max(255).optional(),
+  type: TaskTypeSchema.optional(),
+  status: TaskStatusSchema.optional(),
+  description: external_exports.string().nullable().optional(),
+  milestone_id: UuidSchema.nullable().optional(),
+  parent_task_id: UuidSchema.nullable().optional(),
+  due_date: external_exports.string().nullable().optional(),
+  completed_at: external_exports.string().nullable().optional(),
+  checklist: ChecklistSchema.optional(),
+  resume_context: ResumeContextSchema.nullable().optional(),
+  file_url: external_exports.string().nullable().optional(),
+  metadata: external_exports.record(external_exports.string(), external_exports.unknown()).nullable().optional()
+}).strict().refine((data) => Object.keys(data).length > 0, { message: "At least one field must be provided" });
+var MergeResumeContextRequestSchema = external_exports.record(external_exports.string(), external_exports.unknown()).refine((data) => Object.keys(data).length > 0, { message: "At least one field must be provided" });
+var GetTasksQuerySchema = external_exports.object({
+  status: TaskStatusSchema.optional(),
+  milestone_id: UuidSchema.optional(),
+  parent_task_id: UuidSchema.optional()
+}).strict();
+var TaskIdParamsSchema = external_exports.object({ id: UuidSchema });
+var CreateNoteRequestSchema = external_exports.object({
+  project_id: UuidSchema,
+  content: external_exports.string().trim().min(1),
+  type: NoteTypeSchema.optional(),
+  summary: external_exports.string().nullable().optional(),
+  task_id: UuidSchema.nullable().optional(),
+  milestone_id: UuidSchema.nullable().optional(),
+  occurred_at: external_exports.string().optional(),
+  metadata: external_exports.record(external_exports.string(), external_exports.unknown()).nullable().optional()
+}).strict();
+var UpdateNoteRequestSchema = external_exports.object({
+  content: external_exports.string().trim().min(1).optional(),
+  type: NoteTypeSchema.optional(),
+  summary: external_exports.string().nullable().optional(),
+  task_id: UuidSchema.nullable().optional(),
+  milestone_id: UuidSchema.nullable().optional(),
+  occurred_at: external_exports.string().optional(),
+  metadata: external_exports.record(external_exports.string(), external_exports.unknown()).nullable().optional()
+}).strict().refine((data) => Object.keys(data).length > 0, { message: "At least one field must be provided" });
+var NoteIdParamsSchema = external_exports.object({ id: UuidSchema });
+
 // src/cli/commands/project/notes.ts
+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(
     wrapAction("project:note:list", async (options) => {
@@ -42565,7 +42767,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 | agent_learning").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").action(
     wrapAction(
       "project:note:create",
       async (options) => {
@@ -42694,9 +42896,16 @@ var ListRequestsQuerySchema = external_exports.object({
 });
 
 // src/cli/commands/request/request.ts
+var REQUEST_TYPE_HELP = RequestTypeEnum.options.join(" | ");
+var REQUEST_CATEGORY_HELP = RequestCategoryEnum.options.join(" | ");
+var REQUEST_SEVERITY_HELP = RequestSeverityEnum.options.join(" | ");
 function registerRequestCommands(program3) {
   program3.command("request:submit").description(
-    "Submit a structured request report via POST /api/external/requests\n  Example: elevasis-sdk request:submit -f ./request-report.json"
+    `Submit a structured request report via POST /api/external/requests
+  Example: elevasis-sdk request:submit -f ./request-report.json
+  type: ${REQUEST_TYPE_HELP}
+  category: ${REQUEST_CATEGORY_HELP}
+  severity: ${REQUEST_SEVERITY_HELP}`
   ).option("-i, --input <json>", "Request body as JSON string").option(
     "-f, --input-file <path>",
     "Read request body from a JSON file (e.g. request-report.json, avoids shell escaping). Relative paths resolve against the project root."
@@ -42873,74 +43082,48 @@ function printSummary(failCount) {
   }
 }
 
-// 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++;
-    }
+// src/cli/index.ts
+var PREFLIGHT_SKIP_FLAGS = /* @__PURE__ */ new Set(["--help", "-h", "--version", "-V"]);
+function shouldSkipPreflight() {
+  const args = process.argv.slice(2);
+  if (args.length === 0) return true;
+  return args.every((a) => PREFLIGHT_SKIP_FLAGS.has(a));
+}
+function runPreflight() {
+  if (shouldSkipPreflight()) return;
+  const projectRoot = tryFindProjectRoot(process.cwd());
+  if (projectRoot === null) {
+    process.stderr.write(
+      source_default.red("Not inside an Elevasis project. Run from a directory under one containing `.elevasis`.\n")
+    );
+    process.stderr.write(
+      source_default.gray("Remediation: cd into your Elevasis project (e.g. external/my-project/) and retry.\n")
+    );
+    process.exit(1);
   }
-  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}`));
-    }
+  const envPath2 = (0, import_path3.join)(projectRoot, ".env");
+  if (!(0, import_fs2.existsSync)(envPath2)) {
+    process.stderr.write(source_default.red(`No \`.env\` found at \`${envPath2}\`. Set \`ELEVASIS_PLATFORM_KEY\`.
+`));
+    process.stderr.write(
+      source_default.gray(`Remediation: copy \`.env.example\` to \`${envPath2}\` and fill in ELEVASIS_PLATFORM_KEY.
+`)
+    );
+    process.exit(1);
+  }
+  if (!process.env.ELEVASIS_PLATFORM_KEY) {
+    process.stderr.write(source_default.red(`\`ELEVASIS_PLATFORM_KEY\` missing from \`${envPath2}\`.
+`));
+    process.stderr.write(source_default.gray("Remediation: add ELEVASIS_PLATFORM_KEY=sk_... to your .env file.\n"));
+    process.exit(1);
   }
 }
-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 (options) => {
-      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 (options.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/index.ts
 var envPath = findEnvFile();
 if (envPath) {
   const result = (0, import_dotenv.config)({ path: envPath, override: true });
   if (result.error) {
     console.error(source_default.yellow(`\u26A0 Found .env at ${envPath} but failed to load it: ${result.error.message}`));
   }
-} else if (!process.env.ELEVASIS_PLATFORM_KEY) {
-  console.error(source_default.yellow(`\u26A0 No .env file found at ${getProjectRoot()}/.env`));
-  console.error(source_default.gray("  Set ELEVASIS_PLATFORM_KEY in a .env at your project root."));
 }
 var program2 = new Command();
 program2.name("elevasis-sdk").description(
@@ -42960,11 +43143,13 @@ Commands:
   elevasis-sdk project:work <query>                 Open a lifecycle-aware project work brief
   elevasis-sdk request:submit -f <path>             Submit a structured request report
   elevasis-sdk rename <id> --to <newId> [--prod]     Rename resource across platform tables
-  elevasis-sdk init-claude                            Initialize .claude/ config from SDK
   elevasis-sdk doctor [--verbose]                    Check project environment and API connectivity
 
 Use "elevasis-sdk <command> --help" for more information about a command.`
 ).version(SDK_VERSION);
+program2.hook("preAction", () => {
+  runPreflight();
+});
 registerCheckCommand(program2);
 registerDeployCommand(program2);
 registerExecCommand(program2);
@@ -42979,7 +43164,6 @@ registerRenameCommand(program2);
 registerProjectCommands(program2);
 registerRequestCommands(program2);
 registerDoctorCommand(program2);
-registerInitClaudeCommand(program2);
 program2.parse();
 // Annotate the CommonJS export names for ESM import in node:
 0 && (module.exports = {