@klevar/portal-cli 0.1.2 → 0.1.4

package/README.md

@@ -43,6 +43,54 @@ npx @klevar/portal-cli metrics push --external_ref "idealo:ksh.de" --source_ref
 npx @klevar/portal-cli portal me --portal-token "<client-token>"
 ```
 
+## Capacity And Usage
+
+Capacity commands manage included allowances for a project or client. They are not timesheets.
+
+```bash
+npx @klevar/portal-cli capacity list <projectId>
+npx @klevar/portal-cli capacity create <projectId> --name "Monthly Support" --laneKey support --unitType hours --periodType monthly --startDate 2026-06-01 --capacityAmount 12 --resetBehavior no_rollover --visibility client_visible_summary
+npx @klevar/portal-cli capacity update <budgetId> --capacityAmount 20
+npx @klevar/portal-cli capacity summary <projectId> --period 2026-06
+npx @klevar/portal-cli capacity budget-summary <budgetId> --period 2026-06
+npx @klevar/portal-cli capacity report <projectId> --period 2026-06
+npx @klevar/portal-cli capacity pause <budgetId>
+npx @klevar/portal-cli capacity resume <budgetId>
+npx @klevar/portal-cli capacity end <budgetId>
+npx @klevar/portal-cli capacity delete <budgetId>
+```
+
+Usage commands record consumed capacity.
+
+```bash
+npx @klevar/portal-cli usage record <taskId> --budgetId <budgetId> --units 1.5 --usageDate 2026-06-03 --title "Maintenance support"
+npx @klevar/portal-cli usage manual <projectId> --budgetId <budgetId> --units 1 --usageDate 2026-06-03 --title "Advisory call"
+npx @klevar/portal-cli usage update <usageId> --units 2 --notes "Adjusted after review"
+npx @klevar/portal-cli usage approve <usageId>
+npx @klevar/portal-cli usage reject <usageId>
+npx @klevar/portal-cli usage delete <usageId>
+```
+
+Current smoke-tested `unitType` values are `hours` and `credits`.
+
+Supported `periodType` values:
+
+- `monthly`: period keys use `YYYY-MM`.
+- `weekly`: ISO week period keys use `YYYY-Www`, for example `2026-W23`.
+
+Supported `visibility` values:
+
+- `internal_only`: hidden from client portal capacity APIs.
+- `client_visible_summary`: client can see summary totals only.
+- `client_visible_detail`: client can see summary totals and visible usage entries.
+
+Validation failures print API field details when the server returns them, for example:
+
+```text
+Error 400: Validation failed
+  periodType: Invalid option: expected one of "monthly"|"weekly"|...
+```
+
 ## Brain Usage
 
 Brain usage should prefer the published `npx @klevar/portal-cli` entrypoint.

package/dist/bin/klevar-portal.js

@@ -1,5 +1,22 @@
 #!/usr/bin/env node
-// @ts-expect-error legacy JavaScript execution engine is copied during post-build.
-await import('../lib/legacy-runner.js');
+try {
+    // @ts-expect-error legacy JavaScript execution engine is copied during post-build.
+    await import('../lib/legacy-runner.js');
+}
+catch (err) {
+    if (err &&
+        typeof err === 'object' &&
+        'message' in err &&
+        typeof err.message === 'string' &&
+        err.message.startsWith('CLI_EXIT_')) {
+        process.exitCode =
+            'code' in err && typeof err.code === 'number'
+                ? err.code
+                : Number(err.message.replace('CLI_EXIT_', '')) || 1;
+    }
+    else {
+        throw err;
+    }
+}
 export {};
 //# sourceMappingURL=klevar-portal.js.map

package/dist/bin/klevar-portal.js.map

@@ -1 +1 @@
-{"version":3,"file":"klevar-portal.js","sourceRoot":"","sources":["../../bin/klevar-portal.ts"],"names":[],"mappings":";AAEA,mFAAmF;AACnF,MAAM,MAAM,CAAC,yBAAyB,CAAC,CAAC"}
+{"version":3,"file":"klevar-portal.js","sourceRoot":"","sources":["../../bin/klevar-portal.ts"],"names":[],"mappings":";AAEA,IAAI,CAAC;IACH,mFAAmF;IACnF,MAAM,MAAM,CAAC,yBAAyB,CAAC,CAAC;AAC1C,CAAC;AAAC,OAAO,GAAG,EAAE,CAAC;IACb,IACE,GAAG;QACH,OAAO,GAAG,KAAK,QAAQ;QACvB,SAAS,IAAI,GAAG;QAChB,OAAO,GAAG,CAAC,OAAO,KAAK,QAAQ;QAC/B,GAAG,CAAC,OAAO,CAAC,UAAU,CAAC,WAAW,CAAC,EACnC,CAAC;QACD,OAAO,CAAC,QAAQ;YACd,MAAM,IAAI,GAAG,IAAI,OAAO,GAAG,CAAC,IAAI,KAAK,QAAQ;gBAC3C,CAAC,CAAC,GAAG,CAAC,IAAI;gBACV,CAAC,CAAC,MAAM,CAAC,GAAG,CAAC,OAAO,CAAC,OAAO,CAAC,WAAW,EAAE,EAAE,CAAC,CAAC,IAAI,CAAC,CAAC;IAC1D,CAAC;SAAM,CAAC;QACN,MAAM,GAAG,CAAC;IACZ,CAAC;AACH,CAAC"}

package/dist/commands/capacity.js

@@ -7,8 +7,8 @@ const budgetBody = [
 export const capacityCommands = {
     'capacity.list': { method: 'GET', path: '/api/admin/projects/:projectId/capacity-budgets', auth: 'apiKey', description: 'List project capacity budgets' },
     'capacity.get': { method: 'GET', path: '/api/admin/capacity-budgets/:id', auth: 'apiKey', description: 'Get a capacity budget' },
-    'capacity.create': { method: 'POST', path: '/api/admin/projects/:projectId/capacity-budgets', auth: 'apiKey', description: 'Create a capacity budget', body: budgetBody },
-    'capacity.update': { method: 'PATCH', path: '/api/admin/capacity-budgets/:id', auth: 'apiKey', description: 'Update a capacity budget', body: budgetBody },
+    'capacity.create': { method: 'POST', path: '/api/admin/projects/:projectId/capacity-budgets', auth: 'apiKey', description: 'Create a capacity budget; periodType monthly|weekly, unitType hours|credits, visibility internal_only|client_visible_summary|client_visible_detail', body: budgetBody },
+    'capacity.update': { method: 'PATCH', path: '/api/admin/capacity-budgets/:id', auth: 'apiKey', description: 'Update a capacity budget; periodType monthly|weekly, unitType hours|credits, visibility internal_only|client_visible_summary|client_visible_detail', body: budgetBody },
     'capacity.pause': { method: 'POST', path: '/api/admin/capacity-budgets/:id/pause', auth: 'apiKey', description: 'Pause a capacity budget' },
     'capacity.resume': { method: 'POST', path: '/api/admin/capacity-budgets/:id/resume', auth: 'apiKey', description: 'Resume a capacity budget' },
     'capacity.end': { method: 'POST', path: '/api/admin/capacity-budgets/:id/end', auth: 'apiKey', description: 'End a capacity budget' },

package/dist/commands/capacity.js.map

@@ -1 +1 @@
-{"version":3,"file":"capacity.js","sourceRoot":"","sources":["../../commands/capacity.ts"],"names":[],"mappings":"AAEA,MAAM,UAAU,GAAG;IACjB,MAAM,EAAE,aAAa,EAAE,UAAU,EAAE,SAAS,EAAE,UAAU,EAAE,iBAAiB;IAC3E,YAAY,EAAE,gBAAgB,EAAE,WAAW,EAAE,SAAS,EAAE,gBAAgB;IACxE,qBAAqB,EAAE,SAAS,EAAE,cAAc,EAAE,eAAe;IACjE,eAAe,EAAE,mBAAmB,EAAE,YAAY,EAAE,QAAQ,EAAE,WAAW;CAC1E,CAAC;AAEF,MAAM,CAAC,MAAM,gBAAgB,GAAG;IAC9B,eAAe,EAAE,EAAE,MAAM,EAAE,KAAK,EAAE,IAAI,EAAE,iDAAiD,EAAE,IAAI,EAAE,QAAQ,EAAE,WAAW,EAAE,+BAA+B,EAAE;IACzJ,cAAc,EAAE,EAAE,MAAM,EAAE,KAAK,EAAE,IAAI,EAAE,iCAAiC,EAAE,IAAI,EAAE,QAAQ,EAAE,WAAW,EAAE,uBAAuB,EAAE;IAChI,iBAAiB,EAAE,EAAE,MAAM,EAAE,MAAM,EAAE,IAAI,EAAE,iDAAiD,EAAE,IAAI,EAAE,QAAQ,EAAE,WAAW,EAAE,0BAA0B,EAAE,IAAI,EAAE,UAAU,EAAE;IACzK,iBAAiB,EAAE,EAAE,MAAM,EAAE,OAAO,EAAE,IAAI,EAAE,iCAAiC,EAAE,IAAI,EAAE,QAAQ,EAAE,WAAW,EAAE,0BAA0B,EAAE,IAAI,EAAE,UAAU,EAAE;IAC1J,gBAAgB,EAAE,EAAE,MAAM,EAAE,MAAM,EAAE,IAAI,EAAE,uCAAuC,EAAE,IAAI,EAAE,QAAQ,EAAE,WAAW,EAAE,yBAAyB,EAAE;IAC3I,iBAAiB,EAAE,EAAE,MAAM,EAAE,MAAM,EAAE,IAAI,EAAE,wCAAwC,EAAE,IAAI,EAAE,QAAQ,EAAE,WAAW,EAAE,0BAA0B,EAAE;IAC9I,cAAc,EAAE,EAAE,MAAM,EAAE,MAAM,EAAE,IAAI,EAAE,qCAAqC,EAAE,IAAI,EAAE,QAAQ,EAAE,WAAW,EAAE,uBAAuB,EAAE;IACrI,iBAAiB,EAAE,EAAE,MAAM,EAAE,QAAQ,EAAE,IAAI,EAAE,iCAAiC,EAAE,IAAI,EAAE,QAAQ,EAAE,WAAW,EAAE,0BAA0B,EAAE;IACzI,kBAAkB,EAAE,EAAE,MAAM,EAAE,KAAK,EAAE,IAAI,EAAE,iDAAiD,EAAE,IAAI,EAAE,QAAQ,EAAE,WAAW,EAAE,0BAA0B,EAAE,WAAW,EAAE,CAAC,QAAQ,CAAC,EAAE;IAChL,yBAAyB,EAAE,EAAE,MAAM,EAAE,KAAK,EAAE,IAAI,EAAE,+CAA+C,EAAE,IAAI,EAAE,QAAQ,EAAE,WAAW,EAAE,yBAAyB,EAAE,WAAW,EAAE,CAAC,QAAQ,CAAC,EAAE;IACpL,yBAAyB,EAAE,EAAE,MAAM,EAAE,KAAK,EAAE,IAAI,EAAE,yCAAyC,EAAE,IAAI,EAAE,QAAQ,EAAE,WAAW,EAAE,yBAAyB,EAAE,WAAW,EAAE,CAAC,QAAQ,CAAC,EAAE;IAC9K,iBAAiB,EAAE,EAAE,MAAM,EAAE,KAAK,EAAE,IAAI,EAAE,gDAAgD,EAAE,IAAI,EAAE,QAAQ,EAAE,WAAW,EAAE,yBAAyB,EAAE,WAAW,EAAE,CAAC,QAAQ,CAAC,EAAE;IAC7K,yBAAyB,EAAE,EAAE,MAAM,EAAE,KAAK,EAAE,IAAI,EAAE,kDAAkD,EAAE,IAAI,EAAE,aAAa,EAAE,WAAW,EAAE,yBAAyB,EAAE,WAAW,EAAE,CAAC,QAAQ,CAAC,EAAE;IAC5L,uBAAuB,EAAE,EAAE,MAAM,EAAE,KAAK,EAAE,IAAI,EAAE,gDAAgD,EAAE,IAAI,EAAE,aAAa,EAAE,WAAW,EAAE,+BAA+B,EAAE,WAAW,EAAE,CAAC,QAAQ,CAAC,EAAE;CACxK,CAAC"}
+{"version":3,"file":"capacity.js","sourceRoot":"","sources":["../../commands/capacity.ts"],"names":[],"mappings":"AAEA,MAAM,UAAU,GAAG;IACjB,MAAM,EAAE,aAAa,EAAE,UAAU,EAAE,SAAS,EAAE,UAAU,EAAE,iBAAiB;IAC3E,YAAY,EAAE,gBAAgB,EAAE,WAAW,EAAE,SAAS,EAAE,gBAAgB;IACxE,qBAAqB,EAAE,SAAS,EAAE,cAAc,EAAE,eAAe;IACjE,eAAe,EAAE,mBAAmB,EAAE,YAAY,EAAE,QAAQ,EAAE,WAAW;CAC1E,CAAC;AAEF,MAAM,CAAC,MAAM,gBAAgB,GAAG;IAC9B,eAAe,EAAE,EAAE,MAAM,EAAE,KAAK,EAAE,IAAI,EAAE,iDAAiD,EAAE,IAAI,EAAE,QAAQ,EAAE,WAAW,EAAE,+BAA+B,EAAE;IACzJ,cAAc,EAAE,EAAE,MAAM,EAAE,KAAK,EAAE,IAAI,EAAE,iCAAiC,EAAE,IAAI,EAAE,QAAQ,EAAE,WAAW,EAAE,uBAAuB,EAAE;IAChI,iBAAiB,EAAE,EAAE,MAAM,EAAE,MAAM,EAAE,IAAI,EAAE,iDAAiD,EAAE,IAAI,EAAE,QAAQ,EAAE,WAAW,EAAE,oJAAoJ,EAAE,IAAI,EAAE,UAAU,EAAE;IACnS,iBAAiB,EAAE,EAAE,MAAM,EAAE,OAAO,EAAE,IAAI,EAAE,iCAAiC,EAAE,IAAI,EAAE,QAAQ,EAAE,WAAW,EAAE,oJAAoJ,EAAE,IAAI,EAAE,UAAU,EAAE;IACpR,gBAAgB,EAAE,EAAE,MAAM,EAAE,MAAM,EAAE,IAAI,EAAE,uCAAuC,EAAE,IAAI,EAAE,QAAQ,EAAE,WAAW,EAAE,yBAAyB,EAAE;IAC3I,iBAAiB,EAAE,EAAE,MAAM,EAAE,MAAM,EAAE,IAAI,EAAE,wCAAwC,EAAE,IAAI,EAAE,QAAQ,EAAE,WAAW,EAAE,0BAA0B,EAAE;IAC9I,cAAc,EAAE,EAAE,MAAM,EAAE,MAAM,EAAE,IAAI,EAAE,qCAAqC,EAAE,IAAI,EAAE,QAAQ,EAAE,WAAW,EAAE,uBAAuB,EAAE;IACrI,iBAAiB,EAAE,EAAE,MAAM,EAAE,QAAQ,EAAE,IAAI,EAAE,iCAAiC,EAAE,IAAI,EAAE,QAAQ,EAAE,WAAW,EAAE,0BAA0B,EAAE;IACzI,kBAAkB,EAAE,EAAE,MAAM,EAAE,KAAK,EAAE,IAAI,EAAE,iDAAiD,EAAE,IAAI,EAAE,QAAQ,EAAE,WAAW,EAAE,0BAA0B,EAAE,WAAW,EAAE,CAAC,QAAQ,CAAC,EAAE;IAChL,yBAAyB,EAAE,EAAE,MAAM,EAAE,KAAK,EAAE,IAAI,EAAE,+CAA+C,EAAE,IAAI,EAAE,QAAQ,EAAE,WAAW,EAAE,yBAAyB,EAAE,WAAW,EAAE,CAAC,QAAQ,CAAC,EAAE;IACpL,yBAAyB,EAAE,EAAE,MAAM,EAAE,KAAK,EAAE,IAAI,EAAE,yCAAyC,EAAE,IAAI,EAAE,QAAQ,EAAE,WAAW,EAAE,yBAAyB,EAAE,WAAW,EAAE,CAAC,QAAQ,CAAC,EAAE;IAC9K,iBAAiB,EAAE,EAAE,MAAM,EAAE,KAAK,EAAE,IAAI,EAAE,gDAAgD,EAAE,IAAI,EAAE,QAAQ,EAAE,WAAW,EAAE,yBAAyB,EAAE,WAAW,EAAE,CAAC,QAAQ,CAAC,EAAE;IAC7K,yBAAyB,EAAE,EAAE,MAAM,EAAE,KAAK,EAAE,IAAI,EAAE,kDAAkD,EAAE,IAAI,EAAE,aAAa,EAAE,WAAW,EAAE,yBAAyB,EAAE,WAAW,EAAE,CAAC,QAAQ,CAAC,EAAE;IAC5L,uBAAuB,EAAE,EAAE,MAAM,EAAE,KAAK,EAAE,IAAI,EAAE,gDAAgD,EAAE,IAAI,EAAE,aAAa,EAAE,WAAW,EAAE,+BAA+B,EAAE,WAAW,EAAE,CAAC,QAAQ,CAAC,EAAE;CACxK,CAAC"}

package/dist/lib/legacy-runner.js

@@ -25,6 +25,18 @@ import { join } from 'node:path';
 import { homedir } from 'node:os';
 import { COMMANDS } from '../commands/index.js';
 
+class CliExit extends Error {
+  constructor(code = 1) {
+    super(`CLI_EXIT_${code}`);
+    this.code = code;
+  }
+}
+
+function exitGracefully(code = 1) {
+  process.exitCode = code;
+  throw new CliExit(code);
+}
+
 // ── Credential Loading ──────────────────────────────────────────
 
 function loadEnvFile(filePath) {
@@ -58,7 +70,7 @@ function requireApiKey() {
   if (!API_KEY) {
     console.error('Error: PORTAL_API_KEY is required');
     console.error('Set it via env var or create ~/.klevar/portal.env');
-    process.exit(2);
+    exitGracefully(2);
   }
 }
 
@@ -66,7 +78,7 @@ function requirePortalToken() {
   if (!PORTAL_TOKEN) {
     console.error('Error: PORTAL_TOKEN is required for portal commands');
     console.error('Set it via env var, --portal-token, or ~/.klevar/portal.env');
-    process.exit(2);
+    exitGracefully(2);
   }
 }
 
@@ -112,8 +124,8 @@ async function api(method, path, body, auth = 'apiKey') {
 
   if (!res.ok) {
     const err = await res.json().catch(() => ({ error: { message: res.statusText } }));
-    console.error(`Error ${res.status}: ${err.error?.message || 'Unknown error'}`);
-    process.exit(1);
+    printApiError(res.status, err);
+    exitGracefully(1);
   }
 
   if (res.status === 204) return null;
@@ -136,8 +148,8 @@ async function apiDownload(path, outputPath, auth = 'apiKey') {
 
   if (!res.ok) {
     const err = await res.json().catch(() => ({ error: { message: res.statusText } }));
-    console.error(`Error ${res.status}: ${err.error?.message || 'Unknown error'}`);
-    process.exit(1);
+    printApiError(res.status, err);
+    exitGracefully(1);
   }
 
   const contentType = res.headers.get('content-type') || '';
@@ -158,7 +170,7 @@ async function apiDownload(path, outputPath, auth = 'apiKey') {
 
   if (!outputPath) {
     console.error('Error: --output is required when the API returns PDF bytes');
-    process.exit(1);
+    exitGracefully(1);
   }
 
   const bytes = Buffer.from(await res.arrayBuffer());
@@ -170,7 +182,7 @@ async function downloadPublicUrl(url, outputPath) {
   const res = await fetch(url);
   if (!res.ok) {
     console.error(`Error ${res.status}: failed to download signed URL`);
-    process.exit(1);
+    exitGracefully(1);
   }
   const bytes = Buffer.from(await res.arrayBuffer());
   writeFileSync(outputPath, bytes);
@@ -208,8 +220,8 @@ async function apiMultipart(method, path, fields, filePaths) {
   });
   if (!res.ok) {
     const err = await res.json().catch(() => ({ error: { message: res.statusText } }));
-    console.error(`Error ${res.status}: ${err.error?.message || 'Unknown error'}`);
-    process.exit(1);
+    printApiError(res.status, err);
+    exitGracefully(1);
   }
   if (res.status === 204) return null;
   return res.json();
@@ -223,6 +235,20 @@ async function streamToBuffer(stream) {
 
 // ── Arg Parsing ─────────────────────────────────────────────────
 
+function printApiError(status, payload) {
+  const error = payload?.error ?? payload;
+  console.error(`Error ${status}: ${error?.message || 'Unknown error'}`);
+  if (Array.isArray(error?.details) && error.details.length > 0) {
+    for (const detail of error.details) {
+      const field = detail.field || detail.path || 'unknown';
+      const message = detail.message || JSON.stringify(detail);
+      console.error(`  ${field}: ${message}`);
+    }
+  } else if (payload && typeof payload === 'object' && !payload.error) {
+    console.error(JSON.stringify(payload, null, 2));
+  }
+}
+
 function parseArgs(args) {
   const positional = [];
   const flags = {};
@@ -599,7 +625,7 @@ if (!resource || resource === 'help' || resource === '--help') {
   }
   console.log(`\nConfig: PORTAL_API_URL, PORTAL_API_KEY, PORTAL_TOKEN (or ~/.klevar/portal.env)`);
   console.log(`Target: ${BASE_URL}`);
-  process.exit(0);
+  exitGracefully(0);
 }
 
 // Resolve command key — handle single-word commands (e.g. "search <term>")
@@ -623,7 +649,7 @@ if (!cmd && COMMANDS[resource]) {
 if (!cmd) {
   console.error(`Unknown command: ${commandKey}`);
   console.error(`Run 'klevar-portal help' for available commands.`);
-  process.exit(1);
+  exitGracefully(1);
 }
 
 // Parse remaining args
@@ -645,7 +671,7 @@ if (pathParams.length > 0) {
     if (!value) {
       const ordinal = index === 0 ? 'an ID argument' : `argument ${index + 1} for :${paramName}`;
       console.error(`Command '${commandKey}' requires ${ordinal}.`);
-      process.exit(1);
+      exitGracefully(1);
     }
     path = path.replace(`:${paramName}`, value);
   });
@@ -694,14 +720,14 @@ if (commandKey === 'search') {
   const q = [id, ...positional.slice(1)].filter(Boolean).join(' ');
   if (!q) {
     console.error('Usage: search <term>');
-    process.exit(1);
+    exitGracefully(1);
   }
   const data = await api('GET', `/api/admin/search?q=${encodeURIComponent(q)}`);
   const hasResults = data.projects.length + data.tasks.length + data.updates.length > 0;
 
   if (!hasResults) {
     console.log(`No results for "${q}"`);
-    process.exit(0);
+    exitGracefully(0);
   }
 
   console.log(`\nSearch: "${q}"`);
@@ -736,7 +762,7 @@ if (commandKey === 'search') {
     console.log('\nUpdates: (none)');
   }
 
-  process.exit(0);
+  exitGracefully(0);
 }
 
 // ── Milestone Commands (custom logic: fetch → modify → PATCH) ──
@@ -745,7 +771,7 @@ if (cmd.method === 'CUSTOM' && resource === 'milestones') {
   const projectId = id;
   if (!projectId) {
     console.error('Usage: milestones <action> <projectId> [--name "..."] or [index]');
-    process.exit(1);
+    exitGracefully(1);
   }
 
   // Fetch current project
@@ -763,23 +789,23 @@ if (cmd.method === 'CUSTOM' && resource === 'milestones') {
         console.log(`  ${i + 1}. ${icon} ${m.name} [${m.status}]`);
       });
     }
-    process.exit(0);
+    exitGracefully(0);
   }
 
   if (action === 'add') {
     const name = flags.name || positional[1];
-    if (!name) { console.error('Usage: milestones add <projectId> --name "Milestone name"'); process.exit(1); }
+    if (!name) { console.error('Usage: milestones add <projectId> --name "Milestone name"'); exitGracefully(1); }
     milestones.push({ name, status: 'pending' });
     await api('PATCH', `/api/admin/projects/${projectId}`, { milestonesJson: milestones });
     console.log(`Added milestone: ${name} (${milestones.length} total)`);
-    process.exit(0);
+    exitGracefully(0);
   }
 
   if (action === 'done' || action === 'undo' || action === 'remove') {
     const idx = parseInt(positional[1] || flags.index, 10) - 1;
     if (isNaN(idx) || idx < 0 || idx >= milestones.length) {
       console.error(`Invalid index. Use 1-${milestones.length}.`);
-      process.exit(1);
+      exitGracefully(1);
     }
     if (action === 'done') {
       milestones[idx].status = 'done';
@@ -794,11 +820,11 @@ if (cmd.method === 'CUSTOM' && resource === 'milestones') {
       await api('PATCH', `/api/admin/projects/${projectId}`, { milestonesJson: milestones });
       console.log(`Removed: ${removed[0].name} (${milestones.length} remaining)`);
     }
-    process.exit(0);
+    exitGracefully(0);
   }
 
   console.error(`Unknown milestone action: ${action}`);
-  process.exit(1);
+  exitGracefully(1);
 }
 
 // ── File Upload (multipart) ──
@@ -812,12 +838,12 @@ if (cmd.supportsFiles && flags.file) {
   if (!fields.visibility) fields.visibility = 'client';
   const data = await apiMultipart(cmd.method, path, fields, filePaths);
   formatOutput(data, commandKey);
-  process.exit(0);
+  exitGracefully(0);
 }
 
 if (cmd.method === 'DOWNLOAD') {
   await apiDownload(path, flags.output, cmd.auth);
-  process.exit(0);
+  exitGracefully(0);
 }
 
 // Execute

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@klevar/portal-cli",
-  "version": "0.1.2",
+  "version": "0.1.4",
   "description": "First-class npm CLI for the Klevar Client Management Portal",
   "type": "module",
   "bin": {