@klevar/portal-cli 0.1.4 → 0.1.6

package/README.md

@@ -54,6 +54,9 @@ 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 notifications <budgetId>
+npx @klevar/portal-cli capacity notifications-update <budgetId> --notifyAtWarning true --warningThresholdPct 80 --notifyAtCap true --notifyOverCap true --notifyClient false --notifyAdmin true
+npx @klevar/portal-cli capacity notification-state <budgetId> --period 2026-06
 npx @klevar/portal-cli capacity pause <budgetId>
 npx @klevar/portal-cli capacity resume <budgetId>
 npx @klevar/portal-cli capacity end <budgetId>
@@ -84,6 +87,16 @@ Supported `visibility` values:
 - `client_visible_summary`: client can see summary totals only.
 - `client_visible_detail`: client can see summary totals and visible usage entries.
 
+Capacity notification flags are writable on `capacity create`, `capacity update`, and `capacity notifications-update`:
+
+- `notifyAtWarning`: default `true`.
+- `notifyAtCap`: default `true`.
+- `notifyOverCap`: default `false`.
+- `notifyOnReset`: stored for future reset notifications; no scheduler is active yet.
+- `notifyClient`: default `false`; client capacity emails require explicit opt-in and non-internal visibility.
+- `notifyAdmin`: default `true`.
+- `warningThresholdPct`: default `80`.
+
 Validation failures print API field details when the server returns them, for example:
 
 ```text

package/dist/commands/capacity.d.ts

@@ -25,6 +25,26 @@ export declare const capacityCommands: {
         description: string;
         body: string[];
     };
+    'capacity.notifications': {
+        method: "GET";
+        path: string;
+        auth: "apiKey";
+        description: string;
+    };
+    'capacity.notifications-update': {
+        method: "PATCH";
+        path: string;
+        auth: "apiKey";
+        description: string;
+        body: string[];
+    };
+    'capacity.notification-state': {
+        method: "GET";
+        path: string;
+        auth: "apiKey";
+        description: string;
+        queryParams: string[];
+    };
     'capacity.pause': {
         method: "POST";
         path: string;

package/dist/commands/capacity.js

@@ -1,20 +1,28 @@
 const budgetBody = [
     'name', 'description', 'clientId', 'laneKey', 'unitType', 'customUnitLabel',
     'periodType', 'periodStartDay', 'startDate', 'endDate', 'capacityAmount',
-    'warningThresholdPct', 'hardCap', 'allowOverage', 'overagePolicy',
+    'warningThresholdPct', 'notifyAtWarning', 'notifyAtCap', 'notifyOverCap',
+    'notifyOnReset', 'notifyClient', 'notifyAdmin', 'hardCap', 'allowOverage', 'overagePolicy',
     'resetBehavior', 'rolloverCapAmount', 'visibility', 'status', 'sortOrder',
 ];
+const notificationBody = [
+    'warningThresholdPct', 'notifyAtWarning', 'notifyAtCap', 'notifyOverCap',
+    'notifyOnReset', 'notifyClient', 'notifyAdmin',
+];
 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; 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.notifications': { method: 'GET', path: '/api/admin/capacity-budgets/:id/notifications', auth: 'apiKey', description: 'Show capacity notification settings' },
+    'capacity.notifications-update': { method: 'PATCH', path: '/api/admin/capacity-budgets/:id/notifications', auth: 'apiKey', description: 'Update capacity notification settings', body: notificationBody },
+    'capacity.notification-state': { method: 'GET', path: '/api/admin/capacity-budgets/:id/notification-state', auth: 'apiKey', description: 'List capacity notification dedupe state', queryParams: ['period'] },
     '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' },
     'capacity.delete': { method: 'DELETE', path: '/api/admin/capacity-budgets/:id', auth: 'apiKey', description: 'Delete a capacity budget' },
     'capacity.summary': { method: 'GET', path: '/api/admin/projects/:projectId/capacity-summary', auth: 'apiKey', description: 'Project capacity summary', queryParams: ['period'] },
-    'capacity.client-summary': { method: 'GET', path: '/api/admin/clients/:clientId/capacity-summary', auth: 'apiKey', description: 'Client capacity summary', queryParams: ['period'] },
+    'capacity.client-summary': { method: 'GET', path: '/api/admin/clients/:clientId/capacity-summary', auth: 'apiKey', description: 'Client capacity summary', queryParams: ['period', 'monthlyPeriod', 'weeklyPeriod'] },
     'capacity.budget-summary': { method: 'GET', path: '/api/admin/capacity-budgets/:id/summary', auth: 'apiKey', description: 'Budget capacity summary', queryParams: ['period'] },
     'capacity.report': { method: 'GET', path: '/api/admin/projects/:projectId/capacity-report', auth: 'apiKey', description: 'Project capacity report', queryParams: ['period'] },
     'capacity.portal-summary': { method: 'GET', path: '/api/portal/projects/:projectId/capacity-summary', auth: 'portalToken', description: 'Portal capacity summary', queryParams: ['period'] },

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,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"}
+{"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,iBAAiB,EAAE,aAAa,EAAE,eAAe;IACxE,eAAe,EAAE,cAAc,EAAE,aAAa,EAAE,SAAS,EAAE,cAAc,EAAE,eAAe;IAC1F,eAAe,EAAE,mBAAmB,EAAE,YAAY,EAAE,QAAQ,EAAE,WAAW;CAC1E,CAAC;AAEF,MAAM,gBAAgB,GAAG;IACvB,qBAAqB,EAAE,iBAAiB,EAAE,aAAa,EAAE,eAAe;IACxE,eAAe,EAAE,cAAc,EAAE,aAAa;CAC/C,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,wBAAwB,EAAE,EAAE,MAAM,EAAE,KAAK,EAAE,IAAI,EAAE,+CAA+C,EAAE,IAAI,EAAE,QAAQ,EAAE,WAAW,EAAE,qCAAqC,EAAE;IACtK,+BAA+B,EAAE,EAAE,MAAM,EAAE,OAAO,EAAE,IAAI,EAAE,+CAA+C,EAAE,IAAI,EAAE,QAAQ,EAAE,WAAW,EAAE,uCAAuC,EAAE,IAAI,EAAE,gBAAgB,EAAE;IACzM,6BAA6B,EAAE,EAAE,MAAM,EAAE,KAAK,EAAE,IAAI,EAAE,oDAAoD,EAAE,IAAI,EAAE,QAAQ,EAAE,WAAW,EAAE,yCAAyC,EAAE,WAAW,EAAE,CAAC,QAAQ,CAAC,EAAE;IAC7M,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,EAAE,eAAe,EAAE,cAAc,CAAC,EAAE;IACrN,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/commands/index.d.ts

@@ -302,6 +302,26 @@ export declare const COMMAND_GROUPS: {
             description: string;
             body: string[];
         };
+        'capacity.notifications': {
+            method: "GET";
+            path: string;
+            auth: "apiKey";
+            description: string;
+        };
+        'capacity.notifications-update': {
+            method: "PATCH";
+            path: string;
+            auth: "apiKey";
+            description: string;
+            body: string[];
+        };
+        'capacity.notification-state': {
+            method: "GET";
+            path: string;
+            auth: "apiKey";
+            description: string;
+            queryParams: string[];
+        };
         'capacity.pause': {
             method: "POST";
             path: string;

package/dist/commands/projects.js

@@ -1,9 +1,9 @@
 export const projectCommands = {
     'projects.all': { method: 'GET', path: '/api/admin/projects', auth: 'apiKey', description: 'List all projects', queryParams: ['status', 'clientId'] },
     'projects.list': { method: 'GET', path: '/api/admin/clients/:id/projects', auth: 'apiKey', description: 'List client projects' },
-    'projects.create': { method: 'POST', path: '/api/admin/clients/:id/projects', auth: 'apiKey', description: 'Create a project', body: ['name', 'description', 'startDate', 'targetDate', 'valueEur', 'externalRef', 'metricsConfig', 'itemsConfig'] },
+    'projects.create': { method: 'POST', path: '/api/admin/clients/:id/projects', auth: 'apiKey', description: 'Create a project', body: ['name', 'status', 'visibility', 'description', 'startDate', 'targetDate', 'valueEur', 'externalRef', 'metricsConfig', 'itemsConfig'] },
     'projects.get': { method: 'GET', path: '/api/admin/projects/:id', auth: 'apiKey', description: 'Get a project' },
-    'projects.update': { method: 'PATCH', path: '/api/admin/projects/:id', auth: 'apiKey', description: 'Update a project', body: ['name', 'status', 'description', 'startDate', 'targetDate', 'valueEur', 'externalRef', 'metricsConfig', 'itemsConfig'] },
+    'projects.update': { method: 'PATCH', path: '/api/admin/projects/:id', auth: 'apiKey', description: 'Update a project', body: ['name', 'status', 'visibility', 'description', 'startDate', 'targetDate', 'valueEur', 'externalRef', 'metricsConfig', 'itemsConfig'] },
     'projects.delete': { method: 'DELETE', path: '/api/admin/projects/:id', auth: 'apiKey', description: 'Delete a project' },
     'projects.docs-invoices': { method: 'GET', path: '/api/admin/projects/:id/docs/invoices', auth: 'apiKey', description: 'List project invoices' },
     'projects.docs-documents': { method: 'GET', path: '/api/admin/projects/:id/docs/documents', auth: 'apiKey', description: 'List project documents' },

package/dist/commands/projects.js.map

@@ -1 +1 @@
-{"version":3,"file":"projects.js","sourceRoot":"","sources":["../../commands/projects.ts"],"names":[],"mappings":"AAEA,MAAM,CAAC,MAAM,eAAe,GAAG;IAC7B,cAAc,EAAE,EAAE,MAAM,EAAE,KAAK,EAAE,IAAI,EAAE,qBAAqB,EAAE,IAAI,EAAE,QAAQ,EAAE,WAAW,EAAE,mBAAmB,EAAE,WAAW,EAAE,CAAC,QAAQ,EAAE,UAAU,CAAC,EAAE;IACrJ,eAAe,EAAE,EAAE,MAAM,EAAE,KAAK,EAAE,IAAI,EAAE,iCAAiC,EAAE,IAAI,EAAE,QAAQ,EAAE,WAAW,EAAE,sBAAsB,EAAE;IAChI,iBAAiB,EAAE,EAAE,MAAM,EAAE,MAAM,EAAE,IAAI,EAAE,iCAAiC,EAAE,IAAI,EAAE,QAAQ,EAAE,WAAW,EAAE,kBAAkB,EAAE,IAAI,EAAE,CAAC,MAAM,EAAE,aAAa,EAAE,WAAW,EAAE,YAAY,EAAE,UAAU,EAAE,aAAa,EAAE,eAAe,EAAE,aAAa,CAAC,EAAE;IACpP,cAAc,EAAE,EAAE,MAAM,EAAE,KAAK,EAAE,IAAI,EAAE,yBAAyB,EAAE,IAAI,EAAE,QAAQ,EAAE,WAAW,EAAE,eAAe,EAAE;IAChH,iBAAiB,EAAE,EAAE,MAAM,EAAE,OAAO,EAAE,IAAI,EAAE,yBAAyB,EAAE,IAAI,EAAE,QAAQ,EAAE,WAAW,EAAE,kBAAkB,EAAE,IAAI,EAAE,CAAC,MAAM,EAAE,QAAQ,EAAE,aAAa,EAAE,WAAW,EAAE,YAAY,EAAE,UAAU,EAAE,aAAa,EAAE,eAAe,EAAE,aAAa,CAAC,EAAE;IACvP,iBAAiB,EAAE,EAAE,MAAM,EAAE,QAAQ,EAAE,IAAI,EAAE,yBAAyB,EAAE,IAAI,EAAE,QAAQ,EAAE,WAAW,EAAE,kBAAkB,EAAE;IACzH,wBAAwB,EAAE,EAAE,MAAM,EAAE,KAAK,EAAE,IAAI,EAAE,uCAAuC,EAAE,IAAI,EAAE,QAAQ,EAAE,WAAW,EAAE,uBAAuB,EAAE;IAChJ,yBAAyB,EAAE,EAAE,MAAM,EAAE,KAAK,EAAE,IAAI,EAAE,wCAAwC,EAAE,IAAI,EAAE,QAAQ,EAAE,WAAW,EAAE,wBAAwB,EAAE;IACnJ,iBAAiB,EAAE,EAAE,MAAM,EAAE,QAAQ,EAAE,IAAI,EAAE,EAAE,EAAE,IAAI,EAAE,QAAQ,EAAE,WAAW,EAAE,yBAAyB,EAAE;IACzG,gBAAgB,EAAE,EAAE,MAAM,EAAE,QAAQ,EAAE,IAAI,EAAE,EAAE,EAAE,IAAI,EAAE,QAAQ,EAAE,WAAW,EAAE,yBAAyB,EAAE,IAAI,EAAE,CAAC,MAAM,CAAC,EAAE;IACxH,iBAAiB,EAAE,EAAE,MAAM,EAAE,QAAQ,EAAE,IAAI,EAAE,EAAE,EAAE,IAAI,EAAE,QAAQ,EAAE,WAAW,EAAE,+BAA+B,EAAE;IAC/G,iBAAiB,EAAE,EAAE,MAAM,EAAE,QAAQ,EAAE,IAAI,EAAE,EAAE,EAAE,IAAI,EAAE,QAAQ,EAAE,WAAW,EAAE,uCAAuC,EAAE;IACvH,mBAAmB,EAAE,EAAE,MAAM,EAAE,QAAQ,EAAE,IAAI,EAAE,EAAE,EAAE,IAAI,EAAE,QAAQ,EAAE,WAAW,EAAE,4BAA4B,EAAE;CACxF,CAAC"}
+{"version":3,"file":"projects.js","sourceRoot":"","sources":["../../commands/projects.ts"],"names":[],"mappings":"AAEA,MAAM,CAAC,MAAM,eAAe,GAAG;IAC7B,cAAc,EAAE,EAAE,MAAM,EAAE,KAAK,EAAE,IAAI,EAAE,qBAAqB,EAAE,IAAI,EAAE,QAAQ,EAAE,WAAW,EAAE,mBAAmB,EAAE,WAAW,EAAE,CAAC,QAAQ,EAAE,UAAU,CAAC,EAAE;IACrJ,eAAe,EAAE,EAAE,MAAM,EAAE,KAAK,EAAE,IAAI,EAAE,iCAAiC,EAAE,IAAI,EAAE,QAAQ,EAAE,WAAW,EAAE,sBAAsB,EAAE;IAChI,iBAAiB,EAAE,EAAE,MAAM,EAAE,MAAM,EAAE,IAAI,EAAE,iCAAiC,EAAE,IAAI,EAAE,QAAQ,EAAE,WAAW,EAAE,kBAAkB,EAAE,IAAI,EAAE,CAAC,MAAM,EAAE,QAAQ,EAAE,YAAY,EAAE,aAAa,EAAE,WAAW,EAAE,YAAY,EAAE,UAAU,EAAE,aAAa,EAAE,eAAe,EAAE,aAAa,CAAC,EAAE;IAC5Q,cAAc,EAAE,EAAE,MAAM,EAAE,KAAK,EAAE,IAAI,EAAE,yBAAyB,EAAE,IAAI,EAAE,QAAQ,EAAE,WAAW,EAAE,eAAe,EAAE;IAChH,iBAAiB,EAAE,EAAE,MAAM,EAAE,OAAO,EAAE,IAAI,EAAE,yBAAyB,EAAE,IAAI,EAAE,QAAQ,EAAE,WAAW,EAAE,kBAAkB,EAAE,IAAI,EAAE,CAAC,MAAM,EAAE,QAAQ,EAAE,YAAY,EAAE,aAAa,EAAE,WAAW,EAAE,YAAY,EAAE,UAAU,EAAE,aAAa,EAAE,eAAe,EAAE,aAAa,CAAC,EAAE;IACrQ,iBAAiB,EAAE,EAAE,MAAM,EAAE,QAAQ,EAAE,IAAI,EAAE,yBAAyB,EAAE,IAAI,EAAE,QAAQ,EAAE,WAAW,EAAE,kBAAkB,EAAE;IACzH,wBAAwB,EAAE,EAAE,MAAM,EAAE,KAAK,EAAE,IAAI,EAAE,uCAAuC,EAAE,IAAI,EAAE,QAAQ,EAAE,WAAW,EAAE,uBAAuB,EAAE;IAChJ,yBAAyB,EAAE,EAAE,MAAM,EAAE,KAAK,EAAE,IAAI,EAAE,wCAAwC,EAAE,IAAI,EAAE,QAAQ,EAAE,WAAW,EAAE,wBAAwB,EAAE;IACnJ,iBAAiB,EAAE,EAAE,MAAM,EAAE,QAAQ,EAAE,IAAI,EAAE,EAAE,EAAE,IAAI,EAAE,QAAQ,EAAE,WAAW,EAAE,yBAAyB,EAAE;IACzG,gBAAgB,EAAE,EAAE,MAAM,EAAE,QAAQ,EAAE,IAAI,EAAE,EAAE,EAAE,IAAI,EAAE,QAAQ,EAAE,WAAW,EAAE,yBAAyB,EAAE,IAAI,EAAE,CAAC,MAAM,CAAC,EAAE;IACxH,iBAAiB,EAAE,EAAE,MAAM,EAAE,QAAQ,EAAE,IAAI,EAAE,EAAE,EAAE,IAAI,EAAE,QAAQ,EAAE,WAAW,EAAE,+BAA+B,EAAE;IAC/G,iBAAiB,EAAE,EAAE,MAAM,EAAE,QAAQ,EAAE,IAAI,EAAE,EAAE,EAAE,IAAI,EAAE,QAAQ,EAAE,WAAW,EAAE,uCAAuC,EAAE;IACvH,mBAAmB,EAAE,EAAE,MAAM,EAAE,QAAQ,EAAE,IAAI,EAAE,EAAE,EAAE,IAAI,EAAE,QAAQ,EAAE,WAAW,EAAE,4BAA4B,EAAE;CACxF,CAAC"}

package/dist/lib/legacy-runner.js

@@ -271,6 +271,41 @@ function interpolatePath(template, id) {
   return template.replace(':id', id);
 }
 
+const HELP_ENUMS = {
+  priority: 'low|normal|high|urgent',
+  submittedBy: 'client|admin|va',
+  phase: 'current|next|future',
+  billableStatus: 'included|goodwill|non_billable|out_of_scope|separate_quote',
+  approvalStatus: 'pending|approved|rejected',
+  visibleToClient: 'true|false',
+  countsAgainstCapacity: 'true|false',
+  author: 'kingsley|va|system',
+  unitType: 'hours|credits',
+  periodType: 'monthly|weekly',
+  resetBehavior: 'reset|rollover|no_rollover',
+  notifyAtWarning: 'true|false',
+  notifyAtCap: 'true|false',
+  notifyOverCap: 'true|false',
+  notifyOnReset: 'true|false',
+  notifyClient: 'true|false',
+  notifyAdmin: 'true|false',
+};
+
+function helpFlag(commandKey, field) {
+  let hint = HELP_ENUMS[field];
+  if (field === 'visibility') {
+    if (commandKey.startsWith('projects.')) hint = 'client_visible|internal_only';
+    else if (commandKey.startsWith('capacity.')) hint = 'internal_only|client_visible_summary|client_visible_detail';
+    else hint = 'client|internal';
+  }
+  if (field === 'status') {
+    if (commandKey.startsWith('projects.')) hint = 'discovery|in_progress|review|delivered|maintenance|on_hold';
+    else if (commandKey.startsWith('capacity.')) hint = 'active|paused|ended';
+    else if (commandKey.startsWith('tasks.')) hint = 'open|in_progress|done|blocked';
+  }
+  return hint ? `--${field} ${hint}` : `--${field}`;
+}
+
 // ── Output Formatting ───────────────────────────────────────────
 
 function formatOutput(data, commandKey) {
@@ -328,7 +363,10 @@ function formatOutput(data, commandKey) {
     console.log(`  Portal: /c/${c.portalSlug}?token=${c.portalToken}`);
     if (data.projects?.length > 0) {
       console.log(`\n  Projects (${data.projects.length}):`);
-      for (const p of data.projects) console.log(`    • ${p.name} [${p.status}] [${p.id}]`);
+      for (const p of data.projects) {
+        const visibility = p.visibility ? ` [${p.visibility}]` : '';
+        console.log(`    • ${p.name} [${p.status}]${visibility} [${p.id}]`);
+      }
     }
     return;
   }
@@ -337,6 +375,7 @@ function formatOutput(data, commandKey) {
     const p = data.project;
     console.log(`\n${p.name} [${p.status}]`);
     console.log(`  ID: ${p.id}`);
+    if (p.visibility) console.log(`  Visibility: ${p.visibility}`);
     if (p.description) console.log(`  ${p.description}`);
     if (p.startDate) console.log(`  Start: ${p.startDate} | Target: ${p.targetDate || '—'}`);
     if (p.valueEur) console.log(`  Value: €${p.valueEur}`);
@@ -483,7 +522,8 @@ function formatOutput(data, commandKey) {
       console.log('\nProjects:');
       for (const p of items) {
         const client = p.clientName ? ` (${p.clientName})` : '';
-        console.log(`  • ${p.name}${client} [${p.status}] [${p.id}]`);
+        const visibility = p.visibility ? ` [${p.visibility}]` : '';
+        console.log(`  • ${p.name}${client} [${p.status}]${visibility} [${p.id}]`);
       }
     } else if (commandKey === 'onboarding.list') {
       console.log('\nPending Submissions:');
@@ -546,7 +586,8 @@ function formatOutput(data, commandKey) {
   }
   if (data.project) {
     const p = data.project;
-    console.log(`Project: ${p.name} [${p.status}] [${p.id}]`);
+    const visibility = p.visibility ? ` [${p.visibility}]` : '';
+    console.log(`Project: ${p.name} [${p.status}]${visibility} [${p.id}]`);
     if (p.valueEur) console.log(`  Value: €${p.valueEur}`);
     return;
   }
@@ -614,12 +655,12 @@ if (!resource || resource === 'help' || resource === '--help') {
   for (const [key, cmd] of Object.entries(COMMANDS)) {
     const [res, act] = key.includes('.') ? key.split('.') : [key, ''];
     if (!grouped[res]) grouped[res] = [];
-    grouped[res].push({ action: act, desc: (cmd.description || cmd.desc), body: cmd.body });
+    grouped[res].push({ key, action: act, desc: (cmd.description || cmd.desc), body: cmd.body });
   }
   for (const [res, cmds] of Object.entries(grouped)) {
     console.log(`\n  ${res}:`);
     for (const c of cmds) {
-      const bodyHint = c.body ? ` [${c.body.map(b => '--' + b).join(' ')}]` : '';
+      const bodyHint = c.body ? ` [${c.body.map(b => helpFlag(c.key, b)).join(' ')}]` : '';
       console.log(`    ${c.action || '(default)'}  — ${c.desc}${bodyHint}`);
     }
   }
@@ -736,7 +777,8 @@ if (commandKey === 'search') {
   if (data.projects.length > 0) {
     console.log('\nProjects:');
     data.projects.forEach((p) => {
-      console.log(`  • ${p.name} (${p.clientName}) [${p.status}] [${p.id}]`);
+      const visibility = p.visibility ? ` [${p.visibility}]` : '';
+      console.log(`  • ${p.name} (${p.clientName}) [${p.status}]${visibility} [${p.id}]`);
     });
   } else {
     console.log('\nProjects: (none)');

package/package.json

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