npm - @klevar/portal-cli - Versions diffs - 0.1.0 → 0.1.2 - Mend

@klevar/portal-cli 0.1.0 → 0.1.2

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.

Files changed (14) hide show

package/README.md +12 -12
package/dist/commands/capacity.d.ts +94 -0
package/dist/commands/capacity.js +23 -0
package/dist/commands/capacity.js.map +1 -0
package/dist/commands/index.d.ts +142 -0
package/dist/commands/index.js +4 -0
package/dist/commands/index.js.map +1 -1
package/dist/commands/tasks.js +2 -2
package/dist/commands/tasks.js.map +1 -1
package/dist/commands/usage.d.ts +48 -0
package/dist/commands/usage.js +15 -0
package/dist/commands/usage.js.map +1 -0
package/dist/lib/legacy-runner.js +10 -5
package/package.json +1 -1

package/README.md CHANGED Viewed

@@ -7,7 +7,7 @@ First-class npm CLI for the Klevar Client Management Portal.
 Run without installing:
 ```bash
-npx klevar-portal help
+npx @klevar/portal-cli help
 ```
 Install globally for repeated use:
@@ -34,33 +34,33 @@ Do not paste API keys, portal tokens, or production secrets into chat logs, issu
 ## Command Examples
 ```bash
-npx klevar-portal health
-npx klevar-portal tenant info
-npx klevar-portal clients list
-npx klevar-portal clients create --name "Stefan" --email "stefan@example.de" --platform direct
-npx klevar-portal projects create <clientId> --name "Idealo" --externalRef "idealo:ksh.de"
-npx klevar-portal metrics push --external_ref "idealo:ksh.de" --source_ref "run:33" --snapshot_date "2026-04-12" --metrics '{"score":88}'
-npx klevar-portal portal me --portal-token "<client-token>"
+npx @klevar/portal-cli health
+npx @klevar/portal-cli tenant info
+npx @klevar/portal-cli clients list
+npx @klevar/portal-cli clients create --name "Stefan" --email "stefan@example.de" --platform direct
+npx @klevar/portal-cli projects create <clientId> --name "Idealo" --externalRef "idealo:ksh.de"
+npx @klevar/portal-cli metrics push --external_ref "idealo:ksh.de" --source_ref "run:33" --snapshot_date "2026-04-12" --metrics '{"score":88}'
+npx @klevar/portal-cli portal me --portal-token "<client-token>"
 ```
 ## Brain Usage
-Brain usage should prefer the published `npx klevar-portal` entrypoint.
+Brain usage should prefer the published `npx @klevar/portal-cli` entrypoint.
 Brain agents should call:
 ```bash
-npx klevar-portal <resource> <action> [id] [--key value]
+npx @klevar/portal-cli <resource> <action> [id] [--key value]
 ```
 The local compatibility wrapper remains available for old automation after a build:
 ```bash
 npm run cli:build
-node tools/client.js clients list
+klevar-portal clients list
 ```
-New automation should use `npx klevar-portal`.
+New automation should use `npx @klevar/portal-cli`.
 ## Auth Modes

package/dist/commands/capacity.d.ts ADDED Viewed

@@ -0,0 +1,94 @@
+export declare const capacityCommands: {
+    'capacity.list': {
+        method: "GET";
+        path: string;
+        auth: "apiKey";
+        description: string;
+    };
+    'capacity.get': {
+        method: "GET";
+        path: string;
+        auth: "apiKey";
+        description: string;
+    };
+    'capacity.create': {
+        method: "POST";
+        path: string;
+        auth: "apiKey";
+        description: string;
+        body: string[];
+    };
+    'capacity.update': {
+        method: "PATCH";
+        path: string;
+        auth: "apiKey";
+        description: string;
+        body: string[];
+    };
+    'capacity.pause': {
+        method: "POST";
+        path: string;
+        auth: "apiKey";
+        description: string;
+    };
+    'capacity.resume': {
+        method: "POST";
+        path: string;
+        auth: "apiKey";
+        description: string;
+    };
+    'capacity.end': {
+        method: "POST";
+        path: string;
+        auth: "apiKey";
+        description: string;
+    };
+    'capacity.delete': {
+        method: "DELETE";
+        path: string;
+        auth: "apiKey";
+        description: string;
+    };
+    'capacity.summary': {
+        method: "GET";
+        path: string;
+        auth: "apiKey";
+        description: string;
+        queryParams: string[];
+    };
+    'capacity.client-summary': {
+        method: "GET";
+        path: string;
+        auth: "apiKey";
+        description: string;
+        queryParams: string[];
+    };
+    'capacity.budget-summary': {
+        method: "GET";
+        path: string;
+        auth: "apiKey";
+        description: string;
+        queryParams: string[];
+    };
+    'capacity.report': {
+        method: "GET";
+        path: string;
+        auth: "apiKey";
+        description: string;
+        queryParams: string[];
+    };
+    'capacity.portal-summary': {
+        method: "GET";
+        path: string;
+        auth: "portalToken";
+        description: string;
+        queryParams: string[];
+    };
+    'capacity.portal-usage': {
+        method: "GET";
+        path: string;
+        auth: "portalToken";
+        description: string;
+        queryParams: string[];
+    };
+};

package/dist/commands/capacity.js ADDED Viewed

@@ -0,0 +1,23 @@
+const budgetBody = [
+    'name', 'description', 'clientId', 'laneKey', 'unitType', 'customUnitLabel',
+    'periodType', 'periodStartDay', 'startDate', 'endDate', 'capacityAmount',
+    'warningThresholdPct', 'hardCap', 'allowOverage', 'overagePolicy',
+    'resetBehavior', 'rolloverCapAmount', 'visibility', 'status', 'sortOrder',
+];
+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.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.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'] },
+    'capacity.portal-usage': { method: 'GET', path: '/api/portal/projects/:projectId/capacity-usage', auth: 'portalToken', description: 'Portal visible capacity usage', queryParams: ['period'] },
+};
+//# sourceMappingURL=capacity.js.map

package/dist/commands/capacity.js.map ADDED Viewed

@@ -0,0 +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"}

package/dist/commands/index.d.ts CHANGED Viewed

@@ -275,6 +275,148 @@ export declare const COMMAND_GROUPS: {
             body: string[];
         };
     };
+    capacity: {
+        'capacity.list': {
+            method: "GET";
+            path: string;
+            auth: "apiKey";
+            description: string;
+        };
+        'capacity.get': {
+            method: "GET";
+            path: string;
+            auth: "apiKey";
+            description: string;
+        };
+        'capacity.create': {
+            method: "POST";
+            path: string;
+            auth: "apiKey";
+            description: string;
+            body: string[];
+        };
+        'capacity.update': {
+            method: "PATCH";
+            path: string;
+            auth: "apiKey";
+            description: string;
+            body: string[];
+        };
+        'capacity.pause': {
+            method: "POST";
+            path: string;
+            auth: "apiKey";
+            description: string;
+        };
+        'capacity.resume': {
+            method: "POST";
+            path: string;
+            auth: "apiKey";
+            description: string;
+        };
+        'capacity.end': {
+            method: "POST";
+            path: string;
+            auth: "apiKey";
+            description: string;
+        };
+        'capacity.delete': {
+            method: "DELETE";
+            path: string;
+            auth: "apiKey";
+            description: string;
+        };
+        'capacity.summary': {
+            method: "GET";
+            path: string;
+            auth: "apiKey";
+            description: string;
+            queryParams: string[];
+        };
+        'capacity.client-summary': {
+            method: "GET";
+            path: string;
+            auth: "apiKey";
+            description: string;
+            queryParams: string[];
+        };
+        'capacity.budget-summary': {
+            method: "GET";
+            path: string;
+            auth: "apiKey";
+            description: string;
+            queryParams: string[];
+        };
+        'capacity.report': {
+            method: "GET";
+            path: string;
+            auth: "apiKey";
+            description: string;
+            queryParams: string[];
+        };
+        'capacity.portal-summary': {
+            method: "GET";
+            path: string;
+            auth: "portalToken";
+            description: string;
+            queryParams: string[];
+        };
+        'capacity.portal-usage': {
+            method: "GET";
+            path: string;
+            auth: "portalToken";
+            description: string;
+            queryParams: string[];
+        };
+    };
+    usage: {
+        'usage.list': {
+            method: "GET";
+            path: string;
+            auth: "apiKey";
+            description: string;
+            queryParams: string[];
+        };
+        'usage.record': {
+            method: "POST";
+            path: string;
+            auth: "apiKey";
+            description: string;
+            body: string[];
+        };
+        'usage.manual': {
+            method: "POST";
+            path: string;
+            auth: "apiKey";
+            description: string;
+            body: string[];
+        };
+        'usage.update': {
+            method: "PATCH";
+            path: string;
+            auth: "apiKey";
+            description: string;
+            body: string[];
+        };
+        'usage.approve': {
+            method: "POST";
+            path: string;
+            auth: "apiKey";
+            description: string;
+        };
+        'usage.reject': {
+            method: "POST";
+            path: string;
+            auth: "apiKey";
+            description: string;
+        };
+        'usage.delete': {
+            method: "DELETE";
+            path: string;
+            auth: "apiKey";
+            description: string;
+        };
+    };
     updates: {
         'updates.list': {
             method: "GET";

package/dist/commands/index.js CHANGED Viewed

@@ -1,17 +1,21 @@
 import { clientCommands } from './clients.js';
 import { docsCommands } from './docs.js';
+import { capacityCommands } from './capacity.js';
 import { metricCommands } from './metrics.js';
 import { onboardingCommands } from './onboarding.js';
 import { portalCommands } from './portal.js';
 import { projectCommands } from './projects.js';
 import { systemCommands } from './system.js';
 import { taskCommands } from './tasks.js';
+import { usageCommands } from './usage.js';
 import { updateCommands } from './updates.js';
 export const COMMAND_GROUPS = {
     system: systemCommands,
     clients: clientCommands,
     projects: projectCommands,
     tasks: taskCommands,
+    capacity: capacityCommands,
+    usage: usageCommands,
     updates: updateCommands,
     onboarding: onboardingCommands,
     metrics: metricCommands,

package/dist/commands/index.js.map CHANGED Viewed

	@@ -1 +1 @@
1	- {"version":3,"file":"index.js","sourceRoot":"","sources":["../../commands/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,cAAc,EAAE,MAAM,cAAc,CAAC;AAC9C,OAAO,EAAE,YAAY,EAAE,MAAM,WAAW,CAAC;AACzC,OAAO,EAAE,cAAc,EAAE,MAAM,cAAc,CAAC;AAC9C,OAAO,EAAE,kBAAkB,EAAE,MAAM,iBAAiB,CAAC;AACrD,OAAO,EAAE,cAAc,EAAE,MAAM,aAAa,CAAC;AAC7C,OAAO,EAAE,eAAe,EAAE,MAAM,eAAe,CAAC;AAChD,OAAO,EAAE,cAAc,EAAE,MAAM,aAAa,CAAC;AAC7C,OAAO,EAAE,YAAY,EAAE,MAAM,YAAY,CAAC;AAC1C,OAAO,EAAE,cAAc,EAAE,MAAM,cAAc,CAAC;AAK9C,MAAM,CAAC,MAAM,cAAc,GAAG;IAC5B,MAAM,EAAE,cAAc;IACtB,OAAO,EAAE,cAAc;IACvB,QAAQ,EAAE,eAAe;IACzB,KAAK,EAAE,YAAY;IACnB,OAAO,EAAE,cAAc;IACvB,UAAU,EAAE,kBAAkB;IAC9B,OAAO,EAAE,cAAc;IACvB,IAAI,EAAE,YAAY;IAClB,MAAM,EAAE,cAAc;CACgB,CAAC;AAEzC,MAAM,CAAC,MAAM,QAAQ,GAA+B,MAAM,CAAC,MAAM,CAAC,EAAE,EAAE,GAAG,MAAM,CAAC,MAAM,CAAC,cAAc,CAAC,CAAC,CAAC"}
1	+ {"version":3,"file":"index.js","sourceRoot":"","sources":["../../commands/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,cAAc,EAAE,MAAM,cAAc,CAAC;AAC9C,OAAO,EAAE,YAAY,EAAE,MAAM,WAAW,CAAC;AACzC,OAAO,EAAE,gBAAgB,EAAE,MAAM,eAAe,CAAC;AACjD,OAAO,EAAE,cAAc,EAAE,MAAM,cAAc,CAAC;AAC9C,OAAO,EAAE,kBAAkB,EAAE,MAAM,iBAAiB,CAAC;AACrD,OAAO,EAAE,cAAc,EAAE,MAAM,aAAa,CAAC;AAC7C,OAAO,EAAE,eAAe,EAAE,MAAM,eAAe,CAAC;AAChD,OAAO,EAAE,cAAc,EAAE,MAAM,aAAa,CAAC;AAC7C,OAAO,EAAE,YAAY,EAAE,MAAM,YAAY,CAAC;AAC1C,OAAO,EAAE,aAAa,EAAE,MAAM,YAAY,CAAC;AAC3C,OAAO,EAAE,cAAc,EAAE,MAAM,cAAc,CAAC;AAK9C,MAAM,CAAC,MAAM,cAAc,GAAG;IAC5B,MAAM,EAAE,cAAc;IACtB,OAAO,EAAE,cAAc;IACvB,QAAQ,EAAE,eAAe;IACzB,KAAK,EAAE,YAAY;IACnB,QAAQ,EAAE,gBAAgB;IAC1B,KAAK,EAAE,aAAa;IACpB,OAAO,EAAE,cAAc;IACvB,UAAU,EAAE,kBAAkB;IAC9B,OAAO,EAAE,cAAc;IACvB,IAAI,EAAE,YAAY;IAClB,MAAM,EAAE,cAAc;CACgB,CAAC;AAEzC,MAAM,CAAC,MAAM,QAAQ,GAA+B,MAAM,CAAC,MAAM,CAAC,EAAE,EAAE,GAAG,MAAM,CAAC,MAAM,CAAC,cAAc,CAAC,CAAC,CAAC"}

package/dist/commands/tasks.js CHANGED Viewed

@@ -1,8 +1,8 @@
 export const taskCommands = {
     'tasks.all': { method: 'GET', path: '/api/admin/tasks', auth: 'apiKey', description: 'List all tasks', queryParams: ['status', 'phase', 'priority', 'clientId'] },
     'tasks.list': { method: 'GET', path: '/api/admin/projects/:id/tasks', auth: 'apiKey', description: 'List project tasks' },
-    'tasks.create': { method: 'POST', path: '/api/admin/projects/:id/tasks', auth: 'apiKey', description: 'Create a task', body: ['title', 'description', 'priority', 'submittedBy', 'phase'] },
+    'tasks.create': { method: 'POST', path: '/api/admin/projects/:id/tasks', auth: 'apiKey', description: 'Create a task', body: ['title', 'description', 'priority', 'submittedBy', 'phase', 'laneKey', 'capacityBudgetId', 'estimatedUnits', 'actualUnits', 'countsAgainstCapacity', 'outOfScopeReason'] },
     'tasks.delete': { method: 'DELETE', path: '/api/admin/tasks/:id', auth: 'apiKey', description: 'Delete a task' },
-    'tasks.update': { method: 'PATCH', path: '/api/admin/tasks/:id', auth: 'apiKey', description: 'Update a task', body: ['status', 'priority', 'description', 'phase'] },
+    'tasks.update': { method: 'PATCH', path: '/api/admin/tasks/:id', auth: 'apiKey', description: 'Update a task', body: ['status', 'priority', 'description', 'phase', 'laneKey', 'capacityBudgetId', 'estimatedUnits', 'actualUnits', 'countsAgainstCapacity', 'outOfScopeReason'] },
 };
 //# sourceMappingURL=tasks.js.map

package/dist/commands/tasks.js.map CHANGED Viewed

	@@ -1 +1 @@
1	- {"version":3,"file":"tasks.js","sourceRoot":"","sources":["../../commands/tasks.ts"],"names":[],"mappings":"AAEA,MAAM,CAAC,MAAM,YAAY,GAAG;IAC1B,WAAW,EAAE,EAAE,MAAM,EAAE,KAAK,EAAE,IAAI,EAAE,kBAAkB,EAAE,IAAI,EAAE,QAAQ,EAAE,WAAW,EAAE,gBAAgB,EAAE,WAAW,EAAE,CAAC,QAAQ,EAAE,OAAO,EAAE,UAAU,EAAE,UAAU,CAAC,EAAE;IACjK,YAAY,EAAE,EAAE,MAAM,EAAE,KAAK,EAAE,IAAI,EAAE,+BAA+B,EAAE,IAAI,EAAE,QAAQ,EAAE,WAAW,EAAE,oBAAoB,EAAE;IACzH,cAAc,EAAE,EAAE,MAAM,EAAE,MAAM,EAAE,IAAI,EAAE,+BAA+B,EAAE,IAAI,EAAE,QAAQ,EAAE,WAAW,EAAE,eAAe,EAAE,IAAI,EAAE,CAAC,OAAO,EAAE,aAAa,EAAE,UAAU,EAAE,aAAa,EAAE,OAAO,CAAC,EAAE;~~IAC3L~~,cAAc,EAAE,EAAE,MAAM,EAAE,QAAQ,EAAE,IAAI,EAAE,sBAAsB,EAAE,IAAI,EAAE,QAAQ,EAAE,WAAW,EAAE,eAAe,EAAE;IAChH,cAAc,EAAE,EAAE,MAAM,EAAE,OAAO,EAAE,IAAI,EAAE,sBAAsB,EAAE,IAAI,EAAE,QAAQ,EAAE,WAAW,EAAE,eAAe,EAAE,IAAI,EAAE,CAAC,QAAQ,EAAE,UAAU,EAAE,aAAa,EAAE,OAAO,CAAC,EAAE;~~CAC/I~~,CAAC"}
1	+ {"version":3,"file":"tasks.js","sourceRoot":"","sources":["../../commands/tasks.ts"],"names":[],"mappings":"AAEA,MAAM,CAAC,MAAM,YAAY,GAAG;IAC1B,WAAW,EAAE,EAAE,MAAM,EAAE,KAAK,EAAE,IAAI,EAAE,kBAAkB,EAAE,IAAI,EAAE,QAAQ,EAAE,WAAW,EAAE,gBAAgB,EAAE,WAAW,EAAE,CAAC,QAAQ,EAAE,OAAO,EAAE,UAAU,EAAE,UAAU,CAAC,EAAE;IACjK,YAAY,EAAE,EAAE,MAAM,EAAE,KAAK,EAAE,IAAI,EAAE,+BAA+B,EAAE,IAAI,EAAE,QAAQ,EAAE,WAAW,EAAE,oBAAoB,EAAE;IACzH,cAAc,EAAE,EAAE,MAAM,EAAE,MAAM,EAAE,IAAI,EAAE,+BAA+B,EAAE,IAAI,EAAE,QAAQ,EAAE,WAAW,EAAE,eAAe,EAAE,IAAI,EAAE,CAAC,OAAO,EAAE,aAAa,EAAE,UAAU,EAAE,aAAa,EAAE,OAAO,EAAE,SAAS,EAAE,kBAAkB,EAAE,gBAAgB,EAAE,aAAa,EAAE,uBAAuB,EAAE,kBAAkB,CAAC,EAAE;IACxS,cAAc,EAAE,EAAE,MAAM,EAAE,QAAQ,EAAE,IAAI,EAAE,sBAAsB,EAAE,IAAI,EAAE,QAAQ,EAAE,WAAW,EAAE,eAAe,EAAE;IAChH,cAAc,EAAE,EAAE,MAAM,EAAE,OAAO,EAAE,IAAI,EAAE,sBAAsB,EAAE,IAAI,EAAE,QAAQ,EAAE,WAAW,EAAE,eAAe,EAAE,IAAI,EAAE,CAAC,QAAQ,EAAE,UAAU,EAAE,aAAa,EAAE,OAAO,EAAE,SAAS,EAAE,kBAAkB,EAAE,gBAAgB,EAAE,aAAa,EAAE,uBAAuB,EAAE,kBAAkB,CAAC,EAAE;CAC5P,CAAC"}

package/dist/commands/usage.d.ts ADDED Viewed

@@ -0,0 +1,48 @@
+export declare const usageCommands: {
+    'usage.list': {
+        method: "GET";
+        path: string;
+        auth: "apiKey";
+        description: string;
+        queryParams: string[];
+    };
+    'usage.record': {
+        method: "POST";
+        path: string;
+        auth: "apiKey";
+        description: string;
+        body: string[];
+    };
+    'usage.manual': {
+        method: "POST";
+        path: string;
+        auth: "apiKey";
+        description: string;
+        body: string[];
+    };
+    'usage.update': {
+        method: "PATCH";
+        path: string;
+        auth: "apiKey";
+        description: string;
+        body: string[];
+    };
+    'usage.approve': {
+        method: "POST";
+        path: string;
+        auth: "apiKey";
+        description: string;
+    };
+    'usage.reject': {
+        method: "POST";
+        path: string;
+        auth: "apiKey";
+        description: string;
+    };
+    'usage.delete': {
+        method: "DELETE";
+        path: string;
+        auth: "apiKey";
+        description: string;
+    };
+};

package/dist/commands/usage.js ADDED Viewed

@@ -0,0 +1,15 @@
+const usageBody = [
+    'budgetId', 'clientId', 'projectId', 'updateId', 'units', 'usageDate',
+    'title', 'notes', 'internalNotes', 'billableStatus', 'approvalStatus',
+    'visibleToClient', 'countsAgainstCapacity',
+];
+export const usageCommands = {
+    'usage.list': { method: 'GET', path: '/api/admin/projects/:projectId/capacity-usage', auth: 'apiKey', description: 'List project capacity usage', queryParams: ['period'] },
+    'usage.record': { method: 'POST', path: '/api/admin/tasks/:taskId/capacity-usage', auth: 'apiKey', description: 'Record usage for a task', body: usageBody },
+    'usage.manual': { method: 'POST', path: '/api/admin/capacity-usage', auth: 'apiKey', description: 'Record manual usage', body: usageBody },
+    'usage.update': { method: 'PATCH', path: '/api/admin/capacity-usage/:id', auth: 'apiKey', description: 'Update usage', body: usageBody },
+    'usage.approve': { method: 'POST', path: '/api/admin/capacity-usage/:id/approve', auth: 'apiKey', description: 'Approve pending usage' },
+    'usage.reject': { method: 'POST', path: '/api/admin/capacity-usage/:id/reject', auth: 'apiKey', description: 'Reject pending usage' },
+    'usage.delete': { method: 'DELETE', path: '/api/admin/capacity-usage/:id', auth: 'apiKey', description: 'Delete usage' },
+};
+//# sourceMappingURL=usage.js.map

package/dist/commands/usage.js.map ADDED Viewed

@@ -0,0 +1 @@

+ {"version":3,"file":"usage.js","sourceRoot":"","sources":["../../commands/usage.ts"],"names":[],"mappings":"AAEA,MAAM,SAAS,GAAG;IAChB,UAAU,EAAE,UAAU,EAAE,WAAW,EAAE,UAAU,EAAE,OAAO,EAAE,WAAW;IACrE,OAAO,EAAE,OAAO,EAAE,eAAe,EAAE,gBAAgB,EAAE,gBAAgB;IACrE,iBAAiB,EAAE,uBAAuB;CAC3C,CAAC;AAEF,MAAM,CAAC,MAAM,aAAa,GAAG;IAC3B,YAAY,EAAE,EAAE,MAAM,EAAE,KAAK,EAAE,IAAI,EAAE,+CAA+C,EAAE,IAAI,EAAE,QAAQ,EAAE,WAAW,EAAE,6BAA6B,EAAE,WAAW,EAAE,CAAC,QAAQ,CAAC,EAAE;IAC3K,cAAc,EAAE,EAAE,MAAM,EAAE,MAAM,EAAE,IAAI,EAAE,yCAAyC,EAAE,IAAI,EAAE,QAAQ,EAAE,WAAW,EAAE,yBAAyB,EAAE,IAAI,EAAE,SAAS,EAAE;IAC5J,cAAc,EAAE,EAAE,MAAM,EAAE,MAAM,EAAE,IAAI,EAAE,2BAA2B,EAAE,IAAI,EAAE,QAAQ,EAAE,WAAW,EAAE,qBAAqB,EAAE,IAAI,EAAE,SAAS,EAAE;IAC1I,cAAc,EAAE,EAAE,MAAM,EAAE,OAAO,EAAE,IAAI,EAAE,+BAA+B,EAAE,IAAI,EAAE,QAAQ,EAAE,WAAW,EAAE,cAAc,EAAE,IAAI,EAAE,SAAS,EAAE;IACxI,eAAe,EAAE,EAAE,MAAM,EAAE,MAAM,EAAE,IAAI,EAAE,uCAAuC,EAAE,IAAI,EAAE,QAAQ,EAAE,WAAW,EAAE,uBAAuB,EAAE;IACxI,cAAc,EAAE,EAAE,MAAM,EAAE,MAAM,EAAE,IAAI,EAAE,sCAAsC,EAAE,IAAI,EAAE,QAAQ,EAAE,WAAW,EAAE,sBAAsB,EAAE;IACrI,cAAc,EAAE,EAAE,MAAM,EAAE,QAAQ,EAAE,IAAI,EAAE,+BAA+B,EAAE,IAAI,EAAE,QAAQ,EAAE,WAAW,EAAE,cAAc,EAAE;CAClG,CAAC"}

package/dist/lib/legacy-runner.js CHANGED Viewed

@@ -5,13 +5,15 @@
  * Uses X-API-Key header for authentication.
  *
  * Usage:
- *   node client.js <resource> <action> [id] [--key value ...]
+ *   klevar-portal <resource> <action> [id] [--key value ...]
+ *   npx @klevar/portal-cli <resource> <action> [id] [--key value ...]
  *
  * Resources: clients, projects, tasks, updates, onboarding, dashboard, token
  *
  * Config:
  *   PORTAL_API_KEY  — API key (env var or ~/.klevar/portal.env)
- *   PORTAL_URL      — API base URL (default: http://localhost:3000)
+ *   PORTAL_API_URL  - API base URL (default: http://127.0.0.1:3100)
+ *   PORTAL_TOKEN    - client portal token for portal commands
  *
  * To add a new API endpoint:
  *   1. Add an entry to COMMANDS: 'resource.action': { method, path, body? }
@@ -579,7 +581,8 @@ let [,, resource, action, ...rest] = process.argv;
 if (!resource || resource === 'help' || resource === '--help') {
   console.log('Klevar Client Portal CLI\n');
-  console.log('Usage: node client.js <resource> <action> [id] [--key value ...]\n');
+  console.log('Usage: klevar-portal <resource> <action> [id] [--key value ...]');
+  console.log('       npx @klevar/portal-cli <resource> <action> [id] [--key value ...]\n');
   console.log('Commands:');
   const grouped = {};
   for (const [key, cmd] of Object.entries(COMMANDS)) {
@@ -594,7 +597,7 @@ if (!resource || resource === 'help' || resource === '--help') {
       console.log(`    ${c.action || '(default)'}  — ${c.desc}${bodyHint}`);
     }
   }
-  console.log(`\nConfig: PORTAL_API_KEY, PORTAL_URL (or ~/.klevar/portal.env)`);
+  console.log(`\nConfig: PORTAL_API_URL, PORTAL_API_KEY, PORTAL_TOKEN (or ~/.klevar/portal.env)`);
   console.log(`Target: ${BASE_URL}`);
   process.exit(0);
 }
@@ -619,7 +622,7 @@ if (!cmd && COMMANDS[resource]) {
 if (!cmd) {
   console.error(`Unknown command: ${commandKey}`);
-  console.error(`Run 'node client.js help' for available commands.`);
+  console.error(`Run 'klevar-portal help' for available commands.`);
   process.exit(1);
 }
@@ -674,6 +677,8 @@ if (cmd.fixedBody) {
       if (typeof val === 'string' && (val.startsWith('{') || val.startsWith('['))) {
         try { val = JSON.parse(val); } catch { /* keep as string */ }
       }
+      if (val === 'true') val = true;
+      if (val === 'false') val = false;
       body[key] = val;
     }
   }

package/package.json CHANGED Viewed

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