@klevar/portal-cli 0.1.20 → 0.1.22

package/dist/commands/_exemptions.d.ts

@@ -28,6 +28,12 @@ export declare const CLI_EXEMPTIONS: readonly [{
     readonly reason: "Inbound webhook consumer called by Klevar Docs, not by operators or clients.";
     readonly owner: "Klevar Docs";
     readonly trackedAs: "Phase 17 inbound-webhook exemption";
+}, {
+    readonly method: "GET";
+    readonly path: "/api/portal/projects/:id/timeline";
+    readonly reason: "Client-facing timeline used by the portal project UI; admin/operator timeline CLI already covers recall workflows.";
+    readonly owner: "Klevar Portal";
+    readonly trackedAs: "Phase 17 client timeline portal-ui exemption";
 }, {
     readonly method: "GET";
     readonly path: "/api/portal/projects/:projectId/recurring-checkpoints";

package/dist/commands/_exemptions.js

@@ -34,6 +34,13 @@ export const CLI_EXEMPTIONS = [
         owner: 'Klevar Docs',
         trackedAs: 'Phase 17 inbound-webhook exemption',
     },
+    {
+        method: 'GET',
+        path: '/api/portal/projects/:id/timeline',
+        reason: 'Client-facing timeline used by the portal project UI; admin/operator timeline CLI already covers recall workflows.',
+        owner: 'Klevar Portal',
+        trackedAs: 'Phase 17 client timeline portal-ui exemption',
+    },
     {
         method: 'GET',
         path: '/api/portal/projects/:projectId/recurring-checkpoints',

package/dist/commands/_exemptions.js.map

@@ -1 +1 @@
-{"version":3,"file":"_exemptions.js","sourceRoot":"","sources":["../../commands/_exemptions.ts"],"names":[],"mappings":"AAAA,MAAM,CAAC,MAAM,cAAc,GAAG;IAC5B;QACE,MAAM,EAAE,MAAM;QACd,IAAI,EAAE,kBAAkB;QACxB,MAAM,EAAE,uEAAuE;QAC/E,KAAK,EAAE,eAAe;QACtB,SAAS,EAAE,yCAAyC;KACrD;IACD;QACE,MAAM,EAAE,MAAM;QACd,IAAI,EAAE,mBAAmB;QACzB,MAAM,EAAE,uEAAuE;QAC/E,KAAK,EAAE,eAAe;QACtB,SAAS,EAAE,yCAAyC;KACrD;IACD;QACE,MAAM,EAAE,KAAK;QACb,IAAI,EAAE,eAAe;QACrB,MAAM,EAAE,0GAA0G;QAClH,KAAK,EAAE,eAAe;QACtB,SAAS,EAAE,yCAAyC;KACrD;IACD;QACE,MAAM,EAAE,MAAM;QACd,IAAI,EAAE,uBAAuB;QAC7B,MAAM,EAAE,yGAAyG;QACjH,KAAK,EAAE,eAAe;QACtB,SAAS,EAAE,qCAAqC;KACjD;IACD;QACE,MAAM,EAAE,MAAM;QACd,IAAI,EAAE,qCAAqC;QAC3C,MAAM,EAAE,8EAA8E;QACtF,KAAK,EAAE,aAAa;QACpB,SAAS,EAAE,oCAAoC;KAChD;IACD;QACE,MAAM,EAAE,KAAK;QACb,IAAI,EAAE,uDAAuD;QAC7D,MAAM,EAAE,qFAAqF;QAC7F,KAAK,EAAE,eAAe;QACtB,SAAS,EAAE,wCAAwC;KACpD;IACD;QACE,MAAM,EAAE,MAAM;QACd,IAAI,EAAE,uDAAuD;QAC7D,MAAM,EAAE,uFAAuF;QAC/F,KAAK,EAAE,eAAe;QACtB,SAAS,EAAE,wCAAwC;KACpD;IACD;QACE,MAAM,EAAE,MAAM;QACd,IAAI,EAAE,8CAA8C;QACpD,MAAM,EAAE,wDAAwD;QAChE,KAAK,EAAE,eAAe;QACtB,SAAS,EAAE,wCAAwC;KACpD;IACD;QACE,MAAM,EAAE,MAAM;QACd,IAAI,EAAE,8CAA8C;QACpD,MAAM,EAAE,uDAAuD;QAC/D,KAAK,EAAE,eAAe;QACtB,SAAS,EAAE,wCAAwC;KACpD;IACD;QACE,MAAM,EAAE,KAAK;QACb,IAAI,EAAE,mDAAmD;QACzD,MAAM,EAAE,yDAAyD;QACjE,KAAK,EAAE,eAAe;QACtB,SAAS,EAAE,wCAAwC;KACpD;CACO,CAAC"}
+{"version":3,"file":"_exemptions.js","sourceRoot":"","sources":["../../commands/_exemptions.ts"],"names":[],"mappings":"AAAA,MAAM,CAAC,MAAM,cAAc,GAAG;IAC5B;QACE,MAAM,EAAE,MAAM;QACd,IAAI,EAAE,kBAAkB;QACxB,MAAM,EAAE,uEAAuE;QAC/E,KAAK,EAAE,eAAe;QACtB,SAAS,EAAE,yCAAyC;KACrD;IACD;QACE,MAAM,EAAE,MAAM;QACd,IAAI,EAAE,mBAAmB;QACzB,MAAM,EAAE,uEAAuE;QAC/E,KAAK,EAAE,eAAe;QACtB,SAAS,EAAE,yCAAyC;KACrD;IACD;QACE,MAAM,EAAE,KAAK;QACb,IAAI,EAAE,eAAe;QACrB,MAAM,EAAE,0GAA0G;QAClH,KAAK,EAAE,eAAe;QACtB,SAAS,EAAE,yCAAyC;KACrD;IACD;QACE,MAAM,EAAE,MAAM;QACd,IAAI,EAAE,uBAAuB;QAC7B,MAAM,EAAE,yGAAyG;QACjH,KAAK,EAAE,eAAe;QACtB,SAAS,EAAE,qCAAqC;KACjD;IACD;QACE,MAAM,EAAE,MAAM;QACd,IAAI,EAAE,qCAAqC;QAC3C,MAAM,EAAE,8EAA8E;QACtF,KAAK,EAAE,aAAa;QACpB,SAAS,EAAE,oCAAoC;KAChD;IACD;QACE,MAAM,EAAE,KAAK;QACb,IAAI,EAAE,mCAAmC;QACzC,MAAM,EAAE,oHAAoH;QAC5H,KAAK,EAAE,eAAe;QACtB,SAAS,EAAE,8CAA8C;KAC1D;IACD;QACE,MAAM,EAAE,KAAK;QACb,IAAI,EAAE,uDAAuD;QAC7D,MAAM,EAAE,qFAAqF;QAC7F,KAAK,EAAE,eAAe;QACtB,SAAS,EAAE,wCAAwC;KACpD;IACD;QACE,MAAM,EAAE,MAAM;QACd,IAAI,EAAE,uDAAuD;QAC7D,MAAM,EAAE,uFAAuF;QAC/F,KAAK,EAAE,eAAe;QACtB,SAAS,EAAE,wCAAwC;KACpD;IACD;QACE,MAAM,EAAE,MAAM;QACd,IAAI,EAAE,8CAA8C;QACpD,MAAM,EAAE,wDAAwD;QAChE,KAAK,EAAE,eAAe;QACtB,SAAS,EAAE,wCAAwC;KACpD;IACD;QACE,MAAM,EAAE,MAAM;QACd,IAAI,EAAE,8CAA8C;QACpD,MAAM,EAAE,uDAAuD;QAC/D,KAAK,EAAE,eAAe;QACtB,SAAS,EAAE,wCAAwC;KACpD;IACD;QACE,MAAM,EAAE,KAAK;QACb,IAAI,EAAE,mDAAmD;QACzD,MAAM,EAAE,yDAAyD;QACjE,KAAK,EAAE,eAAe;QACtB,SAAS,EAAE,wCAAwC;KACpD;CACO,CAAC"}

package/dist/commands/index.d.ts

@@ -522,6 +522,144 @@ export declare const COMMAND_GROUPS: {
             description: string;
         };
     };
+    operator: {
+        inbox: {
+            method: "GET";
+            path: string;
+            auth: "apiKey";
+            description: string;
+            queryParams: string[];
+        };
+        'inbox.mark-read': {
+            method: "POST";
+            path: string;
+            auth: "apiKey";
+            description: string;
+        };
+        'inbox.mark-client-read': {
+            method: "POST";
+            path: string;
+            auth: "apiKey";
+            description: string;
+        };
+        'inbox.mark-project-read': {
+            method: "POST";
+            path: string;
+            auth: "apiKey";
+            description: string;
+        };
+        'inbox.mark-all-read': {
+            method: "POST";
+            path: string;
+            auth: "apiKey";
+            description: string;
+        };
+        'reports.monthly': {
+            method: "GET";
+            path: string;
+            auth: "apiKey";
+            description: string;
+            queryParams: string[];
+        };
+        'client.timeline': {
+            method: "GET";
+            path: string;
+            auth: "apiKey";
+            description: string;
+            queryParams: string[];
+        };
+        'project.timeline': {
+            method: "GET";
+            path: string;
+            auth: "apiKey";
+            description: string;
+            queryParams: string[];
+        };
+        'ops-health': {
+            method: "GET";
+            path: string;
+            auth: "apiKey";
+            description: string;
+            queryParams: string[];
+        };
+        'smoke.portal': {
+            method: "GET";
+            path: string;
+            auth: "apiKey";
+            description: string;
+        };
+        'smoke.docs': {
+            method: "GET";
+            path: string;
+            auth: "apiKey";
+            description: string;
+        };
+        'smoke.capacity': {
+            method: "GET";
+            path: string;
+            auth: "apiKey";
+            description: string;
+        };
+        'smoke.recurring': {
+            method: "GET";
+            path: string;
+            auth: "apiKey";
+            description: string;
+        };
+        'smoke.notifications': {
+            method: "GET";
+            path: string;
+            auth: "apiKey";
+            description: string;
+        };
+        'clients.notifications.get': {
+            method: "GET";
+            path: string;
+            auth: "apiKey";
+            description: string;
+        };
+        'clients.notifications.update': {
+            method: "PATCH";
+            path: string;
+            auth: "apiKey";
+            description: string;
+            body: string[];
+        };
+        'projects.notifications.get': {
+            method: "GET";
+            path: string;
+            auth: "apiKey";
+            description: string;
+        };
+        'projects.notifications.update': {
+            method: "PATCH";
+            path: string;
+            auth: "apiKey";
+            description: string;
+            body: string[];
+        };
+        'notifications.preview': {
+            method: "GET";
+            path: string;
+            auth: "apiKey";
+            description: string;
+            queryParams: string[];
+        };
+        'audit.list': {
+            method: "GET";
+            path: string;
+            auth: "apiKey";
+            description: string;
+            queryParams: string[];
+        };
+        'audit.target': {
+            method: "GET";
+            path: string;
+            auth: "apiKey";
+            description: string;
+            queryParams: string[];
+        };
+    };
     notes: {
         'notes.list': {
             method: "GET";

package/dist/commands/index.js

@@ -3,6 +3,7 @@ import { docsCommands } from './docs.js';
 import { capacityCommands } from './capacity.js';
 import { metricCommands } from './metrics.js';
 import { onboardingCommands } from './onboarding.js';
+import { operatorCommands } from './operator.js';
 import { noteCommands } from './notes.js';
 import { portalCommands } from './portal.js';
 import { projectCommands } from './projects.js';
@@ -20,6 +21,7 @@ export const COMMAND_GROUPS = {
     usage: usageCommands,
     updates: updateCommands,
     onboarding: onboardingCommands,
+    operator: operatorCommands,
     notes: noteCommands,
     recurring: recurringCommands,
     metrics: metricCommands,

package/dist/commands/index.js.map

@@ -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,gBAAgB,EAAE,MAAM,eAAe,CAAC;AACjD,OAAO,EAAE,cAAc,EAAE,MAAM,cAAc,CAAC;AAC9C,OAAO,EAAE,kBAAkB,EAAE,MAAM,iBAAiB,CAAC;AACrD,OAAO,EAAE,YAAY,EAAE,MAAM,YAAY,CAAC;AAC1C,OAAO,EAAE,cAAc,EAAE,MAAM,aAAa,CAAC;AAC7C,OAAO,EAAE,eAAe,EAAE,MAAM,eAAe,CAAC;AAChD,OAAO,EAAE,iBAAiB,EAAE,MAAM,gBAAgB,CAAC;AACnD,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,KAAK,EAAE,YAAY;IACnB,SAAS,EAAE,iBAAiB;IAC5B,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"}
+{"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,gBAAgB,EAAE,MAAM,eAAe,CAAC;AACjD,OAAO,EAAE,YAAY,EAAE,MAAM,YAAY,CAAC;AAC1C,OAAO,EAAE,cAAc,EAAE,MAAM,aAAa,CAAC;AAC7C,OAAO,EAAE,eAAe,EAAE,MAAM,eAAe,CAAC;AAChD,OAAO,EAAE,iBAAiB,EAAE,MAAM,gBAAgB,CAAC;AACnD,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,QAAQ,EAAE,gBAAgB;IAC1B,KAAK,EAAE,YAAY;IACnB,SAAS,EAAE,iBAAiB;IAC5B,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/operator.d.ts

@@ -0,0 +1,138 @@
+export declare const operatorCommands: {
+    inbox: {
+        method: "GET";
+        path: string;
+        auth: "apiKey";
+        description: string;
+        queryParams: string[];
+    };
+    'inbox.mark-read': {
+        method: "POST";
+        path: string;
+        auth: "apiKey";
+        description: string;
+    };
+    'inbox.mark-client-read': {
+        method: "POST";
+        path: string;
+        auth: "apiKey";
+        description: string;
+    };
+    'inbox.mark-project-read': {
+        method: "POST";
+        path: string;
+        auth: "apiKey";
+        description: string;
+    };
+    'inbox.mark-all-read': {
+        method: "POST";
+        path: string;
+        auth: "apiKey";
+        description: string;
+    };
+    'reports.monthly': {
+        method: "GET";
+        path: string;
+        auth: "apiKey";
+        description: string;
+        queryParams: string[];
+    };
+    'client.timeline': {
+        method: "GET";
+        path: string;
+        auth: "apiKey";
+        description: string;
+        queryParams: string[];
+    };
+    'project.timeline': {
+        method: "GET";
+        path: string;
+        auth: "apiKey";
+        description: string;
+        queryParams: string[];
+    };
+    'ops-health': {
+        method: "GET";
+        path: string;
+        auth: "apiKey";
+        description: string;
+        queryParams: string[];
+    };
+    'smoke.portal': {
+        method: "GET";
+        path: string;
+        auth: "apiKey";
+        description: string;
+    };
+    'smoke.docs': {
+        method: "GET";
+        path: string;
+        auth: "apiKey";
+        description: string;
+    };
+    'smoke.capacity': {
+        method: "GET";
+        path: string;
+        auth: "apiKey";
+        description: string;
+    };
+    'smoke.recurring': {
+        method: "GET";
+        path: string;
+        auth: "apiKey";
+        description: string;
+    };
+    'smoke.notifications': {
+        method: "GET";
+        path: string;
+        auth: "apiKey";
+        description: string;
+    };
+    'clients.notifications.get': {
+        method: "GET";
+        path: string;
+        auth: "apiKey";
+        description: string;
+    };
+    'clients.notifications.update': {
+        method: "PATCH";
+        path: string;
+        auth: "apiKey";
+        description: string;
+        body: string[];
+    };
+    'projects.notifications.get': {
+        method: "GET";
+        path: string;
+        auth: "apiKey";
+        description: string;
+    };
+    'projects.notifications.update': {
+        method: "PATCH";
+        path: string;
+        auth: "apiKey";
+        description: string;
+        body: string[];
+    };
+    'notifications.preview': {
+        method: "GET";
+        path: string;
+        auth: "apiKey";
+        description: string;
+        queryParams: string[];
+    };
+    'audit.list': {
+        method: "GET";
+        path: string;
+        auth: "apiKey";
+        description: string;
+        queryParams: string[];
+    };
+    'audit.target': {
+        method: "GET";
+        path: string;
+        auth: "apiKey";
+        description: string;
+        queryParams: string[];
+    };
+};

package/dist/commands/operator.js

@@ -0,0 +1,139 @@
+export const operatorCommands = {
+    inbox: {
+        method: 'GET',
+        path: '/api/admin/operator-inbox',
+        auth: 'apiKey',
+        description: 'Review operator inbox',
+        queryParams: ['clientId|client', 'projectId|project', 'since', 'unreadOnly|unread', 'limit'],
+    },
+    'inbox.mark-read': {
+        method: 'POST',
+        path: '/api/admin/operator-inbox/read/:itemId',
+        auth: 'apiKey',
+        description: 'Mark one inbox item read',
+    },
+    'inbox.mark-client-read': {
+        method: 'POST',
+        path: '/api/admin/operator-inbox/read-client/:clientId',
+        auth: 'apiKey',
+        description: 'Mark a client inbox section read',
+    },
+    'inbox.mark-project-read': {
+        method: 'POST',
+        path: '/api/admin/operator-inbox/read-project/:projectId',
+        auth: 'apiKey',
+        description: 'Mark a project inbox section read',
+    },
+    'inbox.mark-all-read': {
+        method: 'POST',
+        path: '/api/admin/operator-inbox/read-all',
+        auth: 'apiKey',
+        description: 'Mark all current inbox items read',
+    },
+    'reports.monthly': {
+        method: 'GET',
+        path: '/api/admin/clients/:clientId/reports/monthly',
+        auth: 'apiKey',
+        description: 'Generate monthly client report; optionally scope with --project',
+        queryParams: ['period', 'projectId|project'],
+    },
+    'client.timeline': {
+        method: 'GET',
+        path: '/api/admin/clients/:clientId/timeline',
+        auth: 'apiKey',
+        description: 'Show client timeline',
+        queryParams: ['projectId|project', 'type', 'since', 'until', 'limit'],
+    },
+    'project.timeline': {
+        method: 'GET',
+        path: '/api/admin/projects/:projectId/timeline',
+        auth: 'apiKey',
+        description: 'Show project timeline',
+        queryParams: ['type', 'since', 'until', 'limit'],
+    },
+    'ops-health': {
+        method: 'GET',
+        path: '/api/admin/ops-health',
+        auth: 'apiKey',
+        description: 'Show operational health summary; exits 1 only for critical unless --no-fail or --warn-only is set',
+        queryParams: ['noFail|no-fail', 'warnOnly|warn-only'],
+    },
+    'smoke.portal': {
+        method: 'GET',
+        path: '/api/admin/clients/:id',
+        auth: 'apiKey',
+        description: 'Read-only portal smoke check',
+    },
+    'smoke.docs': {
+        method: 'GET',
+        path: '/api/admin/clients/:id/docs/documents',
+        auth: 'apiKey',
+        description: 'Read-only Docs smoke check',
+    },
+    'smoke.capacity': {
+        method: 'GET',
+        path: '/api/admin/projects/:projectId/capacity-summary',
+        auth: 'apiKey',
+        description: 'Read-only capacity smoke check',
+    },
+    'smoke.recurring': {
+        method: 'GET',
+        path: '/api/admin/projects/:projectId/recurring-checkpoints',
+        auth: 'apiKey',
+        description: 'Read-only recurring smoke check',
+    },
+    'smoke.notifications': {
+        method: 'GET',
+        path: '/api/admin/smoke/notifications/:clientId',
+        auth: 'apiKey',
+        description: 'Read-only notification smoke check',
+    },
+    'clients.notifications.get': {
+        method: 'GET',
+        path: '/api/admin/clients/:id/notification-preferences',
+        auth: 'apiKey',
+        description: 'Show client notification preferences',
+    },
+    'clients.notifications.update': {
+        method: 'PATCH',
+        path: '/api/admin/clients/:id/notification-preferences',
+        auth: 'apiKey',
+        description: 'Update client notification preferences',
+        body: ['mode', 'digestFrequency'],
+    },
+    'projects.notifications.get': {
+        method: 'GET',
+        path: '/api/admin/projects/:id/notification-preferences',
+        auth: 'apiKey',
+        description: 'Show project notification preferences',
+    },
+    'projects.notifications.update': {
+        method: 'PATCH',
+        path: '/api/admin/projects/:id/notification-preferences',
+        auth: 'apiKey',
+        description: 'Update project notification preferences',
+        body: ['mode', 'digestFrequency'],
+    },
+    'notifications.preview': {
+        method: 'GET',
+        path: '/api/admin/notifications/preview/:eventType',
+        auth: 'apiKey',
+        description: 'Preview notification rendering without sending',
+        queryParams: ['clientId|client', 'projectId|project'],
+    },
+    'audit.list': {
+        method: 'GET',
+        path: '/api/admin/audit-events',
+        auth: 'apiKey',
+        description: 'List operational audit events',
+        queryParams: ['clientId|client', 'projectId|project', 'actorId|actor', 'action', 'targetType', 'targetId', 'since', 'until', 'limit'],
+    },
+    'audit.target': {
+        method: 'GET',
+        path: '/api/admin/audit-events',
+        auth: 'apiKey',
+        description: 'List audit events for one target',
+        queryParams: ['targetType', 'targetId', 'limit'],
+    },
+};
+//# sourceMappingURL=operator.js.map

package/dist/commands/operator.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"operator.js","sourceRoot":"","sources":["../../commands/operator.ts"],"names":[],"mappings":"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"}

package/dist/lib/legacy-runner.js

@@ -299,6 +299,50 @@ function interpolatePath(template, id) {
   return template.replace(':id', id);
 }
 
+function isUuid(value) {
+  return /^[0-9a-f]{8}-[0-9a-f]{4}-[1-5][0-9a-f]{3}-[89ab][0-9a-f]{3}-[0-9a-f]{12}$/i.test(value);
+}
+
+function looksLikeOpaqueId(value) {
+  return isUuid(value) || /^[a-z]+-\d+$/i.test(value);
+}
+
+function pathParamEntity(commandKey, paramName) {
+  if (paramName.toLowerCase().includes('client')) return 'client';
+  if (paramName.toLowerCase().includes('project')) return 'project';
+  if (paramName === 'id' && commandKey.startsWith('clients.')) return 'client';
+  if (paramName === 'id' && commandKey.startsWith('projects.')) return 'project';
+  if (paramName === 'id' && (commandKey === 'smoke.portal' || commandKey === 'smoke.docs')) return 'client';
+  return null;
+}
+
+async function resolveNameParam(commandKey, paramName, value, flags) {
+  if (!value || looksLikeOpaqueId(value)) return value;
+  const entity = pathParamEntity(commandKey, paramName);
+  if (!entity) return value;
+  const params = new URLSearchParams({ q: value, type: entity, limit: '10' });
+  if (entity === 'project' && flags.clientId) params.set('clientId', flags.clientId);
+  else if (entity === 'project' && flags.client) params.set('client', flags.client);
+  const data = await api('GET', `/api/admin/search?${params.toString()}`);
+  const rows = entity === 'client' ? (data.clients || []) : (data.projects || []);
+  const exact = rows.filter((row) => (row.name || '').toLowerCase() === value.toLowerCase());
+  const candidates = exact.length > 0 ? exact : rows;
+  if (candidates.length === 1) return candidates[0].id;
+  if (candidates.length === 0) console.error(`No ${entity} found for "${value}".`);
+  else {
+    console.error(`Ambiguous ${entity} name "${value}". Use an ID or narrow the search.`);
+    for (const row of candidates.slice(0, 5)) console.error(`  ${row.name} [${row.id}]`);
+  }
+  exitGracefully(2);
+}
+
+async function resolveQueryNameParam(commandKey, canonical, value, flags) {
+  if (!value || looksLikeOpaqueId(value)) return value;
+  if (canonical === 'clientId') return resolveNameParam(commandKey, 'clientId', value, flags);
+  if (canonical === 'projectId') return resolveNameParam(commandKey, 'projectId', value, flags);
+  return value;
+}
+
 const HELP_ENUMS = {
   priority: 'low|normal|high|urgent',
   submittedBy: 'client|admin|va|system',
@@ -323,6 +367,8 @@ const HELP_ENUMS = {
   owner: 'admin|client|shared',
   requiresClientAcceptance: 'true|false',
   requiresAdminAcceptance: 'true|false',
+  mode: 'muted|portal_only|admin_only|material_updates|digest|all',
+  digestFrequency: 'daily|weekly|monthly',
 };
 
 function helpFlag(commandKey, field) {
@@ -356,6 +402,11 @@ function helpQueryFlag(field) {
 // ── Output Formatting ───────────────────────────────────────────
 
 function formatOutput(data, commandKey) {
+  if (commandKey === 'ops-health' && OUTPUT_JSON) {
+    console.log(COMPACT_JSON ? JSON.stringify(data) : JSON.stringify(data, null, 2));
+    if (data.status === 'critical' && flags.noFail !== 'true' && flags['no-fail'] !== 'true' && flags.warnOnly !== 'true' && flags['warn-only'] !== 'true') exitGracefully(1);
+    return;
+  }
   if (OUTPUT_JSON) {
     console.log(COMPACT_JSON ? JSON.stringify(data) : JSON.stringify(data, null, 2));
     return;
@@ -422,6 +473,111 @@ function formatOutput(data, commandKey) {
     return;
   }
 
+  if (commandKey === 'inbox') {
+    const sections = data.sections || {};
+    console.log('\nOperator Inbox');
+    console.log('-'.repeat(80));
+    for (const [key, section] of Object.entries(sections)) {
+      const items = section.items || [];
+      if (items.length === 0) continue;
+      console.log(`\n${key} (${items.length})`);
+      for (const item of items) {
+        const unread = item.unread ? '*' : ' ';
+        const scope = [item.clientName, item.projectName].filter(Boolean).join(' / ');
+        console.log(`  ${unread} ${item.summary} ${scope ? `- ${scope}` : ''} [${item.id}]`);
+      }
+    }
+    return;
+  }
+
+  if (commandKey === 'reports.monthly') {
+    const report = data.report;
+    if (!report) { console.log(JSON.stringify(data, null, 2)); return; }
+    if (COMPACT_JSON) {
+      console.log(`${report.client.name}: ${report.period} - ${report.completedWork.length} done, ${report.openWork.length} open`);
+      return;
+    }
+    console.log(`\nMonthly Report: ${report.client.name} (${report.period})`);
+    console.log('-'.repeat(80));
+    console.log(`Completed work: ${report.completedWork.length}`);
+    for (const item of report.completedWork) console.log(`  - ${item.title}`);
+    console.log(`Open work: ${report.openWork.length}`);
+    for (const item of report.openWork) console.log(`  - ${item.title} [${item.status}]`);
+    console.log(`Updates: ${report.updates.length}`);
+    console.log(`Invoices: ${report.invoices.length}`);
+    console.log(`Capacity items: ${report.capacity.length}`);
+    return;
+  }
+
+  if (commandKey === 'client.timeline' || commandKey === 'project.timeline') {
+    const items = data.data || [];
+    if (items.length === 0) { console.log('No timeline events found.'); return; }
+    console.log(`\nTimeline (${items.length})`);
+    console.log('-'.repeat(80));
+    for (const item of items) {
+      const scope = [item.clientName, item.projectName].filter(Boolean).join(' / ');
+      console.log(`  ${item.type}: ${item.summary}${scope ? ` - ${scope}` : ''} [${item.sourceId}]`);
+    }
+    return;
+  }
+
+  if (commandKey === 'ops-health') {
+    console.log(`Operational health: ${data.status}`);
+    for (const [key, value] of Object.entries(data.failures || {})) {
+      console.log(`  ${key}: ${value}`);
+    }
+    if (data.status === 'critical' && flags.noFail !== 'true' && flags['no-fail'] !== 'true' && flags.warnOnly !== 'true' && flags['warn-only'] !== 'true') exitGracefully(1);
+    return;
+  }
+
+  if (commandKey === 'smoke.notifications') {
+    const smoke = data.smoke || {};
+    console.log(`Notification smoke: ${smoke.client?.name || 'client'}`);
+    console.log(`  Read-only dry run: ${smoke.dryRun === false ? 'false' : 'true'}`);
+    console.log(`  notificationsEnabled: ${smoke.client?.notificationsEnabled}`);
+    console.log(`  preference: ${smoke.preference?.mode || 'n/a'}`);
+    console.log(`  failed deliveries: ${smoke.failedCount ?? 0}`);
+    console.log('  Would send: none');
+    console.log('  Would create: none');
+    return;
+  }
+
+  if (
+    commandKey === 'clients.notifications.get' ||
+    commandKey === 'clients.notifications.update' ||
+    commandKey === 'projects.notifications.get' ||
+    commandKey === 'projects.notifications.update'
+  ) {
+    const preference = data.preference || {};
+    console.log(`Notification preference: ${preference.mode || 'n/a'}`);
+    if (preference.digestFrequency) console.log(`  Digest: ${preference.digestFrequency}`);
+    if (preference.inheritedFromClient) console.log('  Inherited from client preference.');
+    if (preference.inheritedFromNotificationsEnabled) console.log('  Inherited from notificationsEnabled.');
+    return;
+  }
+
+  if (commandKey === 'notifications.preview') {
+    const preview = data.preview || {};
+    console.log(`Notification preview: ${preview.subject || preview.eventType}`);
+    console.log(`  Audience: ${(preview.audience || []).join(', ') || 'none'}`);
+    console.log(`  Mode: ${preview.mode || 'n/a'}`);
+    console.log(`  Thread: ${preview.threadKey || 'n/a'}`);
+    console.log('');
+    console.log(preview.body || '');
+    return;
+  }
+
+  if (commandKey === 'audit.list' || commandKey === 'audit.target') {
+    const items = data.data || [];
+    if (items.length === 0) { console.log('No audit events found. Audit records operator actions from this release forward; older actions are not backfilled.'); return; }
+    console.log(`\nAudit Events (${items.length})`);
+    console.log('-'.repeat(80));
+    for (const item of items) {
+      console.log(`  ${item.action}: ${item.targetType}/${item.targetId} [${item.id}]`);
+    }
+    return;
+  }
+
   if (commandKey === 'projects.get') {
     const p = data.project;
     console.log(`\n${p.name} [${p.status}]`);
@@ -778,6 +934,11 @@ 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}`);
+  console.log('\nExamples:');
+  console.log('  klevar-portal inbox --unread --compact');
+  console.log('  klevar-portal client timeline "Acme Ltd" --type task');
+  console.log('  klevar-portal notifications preview project.status_changed --client "Acme Ltd" --project "Retainer"');
+  console.log('  klevar-portal audit target task <taskId>');
   exitGracefully(0);
 }
 
@@ -827,19 +988,25 @@ if (supportsCommentContentInput(commandKey)) {
   }
 }
 
+if (commandKey === 'audit.target' && positional.length >= 2) {
+  flags.targetType = positional[0];
+  flags.targetId = positional[1];
+}
+
 // Interpolate path
 let path = cmd.path;
 const pathParams = [...path.matchAll(/:([A-Za-z][A-Za-z0-9_]*)/g)].map((match) => match[1]);
 if (pathParams.length > 0) {
-  pathParams.forEach((paramName, index) => {
-    const value = positional[index];
+  for (const [index, paramName] of pathParams.entries()) {
+    let value = positional[index];
     if (!value) {
       const ordinal = index === 0 ? 'an ID argument' : `argument ${index + 1} for :${paramName}`;
       console.error(`Command '${commandKey}' requires ${ordinal}.`);
       exitGracefully(1);
     }
+    value = await resolveNameParam(commandKey, paramName, value, flags);
     path = path.replace(`:${paramName}`, value);
-  });
+  }
 }
 
 // Append query parameters for GET commands with filters
@@ -851,13 +1018,23 @@ if (cmd.queryParams || cmd.fixedQuery) {
   for (const key of cmd.queryParams || []) {
     const aliases = key.split('|');
     const canonical = aliases[0];
-    const value = aliases.map((alias) => flags[alias]).find((candidate) => candidate !== undefined);
-    if (value !== undefined) params.set(canonical, value);
+    let value = aliases.map((alias) => flags[alias]).find((candidate) => candidate !== undefined);
+    if (value !== undefined) {
+      value = await resolveQueryNameParam(commandKey, canonical, value, flags);
+      flags[canonical] = value;
+      for (const alias of aliases) flags[alias] = value;
+      params.set(canonical, value);
+    }
   }
   const qs = params.toString();
   if (qs) path += (path.includes('?') ? '&' : '?') + qs;
 }
 
+if (commandKey.startsWith('smoke.') && (flags.write === 'true' || flags.send === 'true')) {
+  console.error(`Command '${commandKey}' is read-only; --write/--send are not supported for this smoke check.`);
+  exitGracefully(2);
+}
+
 // Build body from flags or fixedBody
 let body = undefined;
 if (cmd.fixedBody) {
@@ -887,6 +1064,13 @@ if (supportsCommentContentInput(commandKey) && !body && positional[pathParams.le
   body = { content: normalizeCliMultiline(positional.slice(pathParams.length).join(' ')) };
 }
 
+if (flags['dry-run'] === 'true' && ['POST', 'PATCH', 'DELETE'].includes(cmd.method)) {
+  console.log(`Dry run: ${cmd.method} ${path}`);
+  if (body) console.log(COMPACT_JSON ? JSON.stringify(body) : JSON.stringify(body, null, 2));
+  else console.log('No request body.');
+  exitGracefully(0);
+}
+
 // ── Search Command ──
 if (commandKey === 'search') {
   const q = [id, ...positional.slice(1)].filter(Boolean).join(' ');
@@ -894,8 +1078,13 @@ if (commandKey === 'search') {
     console.error('Usage: search <term>');
     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;
+  const params = new URLSearchParams({ q });
+  for (const key of ['client', 'clientId', 'project', 'projectId', 'type', 'limit']) {
+    if (flags[key] !== undefined) params.set(key, flags[key]);
+  }
+  const data = await api('GET', `/api/admin/search?${params.toString()}`);
+  const resultGroups = ['clients', 'projects', 'tasks', 'updates', 'comments', 'notes', 'docs', 'capacity'];
+  const hasResults = resultGroups.some((group) => (data[group] || []).length > 0);
 
   if (!hasResults) {
     console.log(`No results for "${q}"`);
@@ -905,7 +1094,15 @@ if (commandKey === 'search') {
   console.log(`\nSearch: "${q}"`);
   console.log('─'.repeat(50));
 
-  if (data.projects.length > 0) {
+  if (data.clients?.length > 0) {
+    console.log('\nClients:');
+    data.clients.forEach((c) => {
+      const company = c.company ? ` (${c.company})` : '';
+      console.log(`  • ${c.name}${company} [${c.status}] [${c.id}]`);
+    });
+  }
+
+  if ((data.projects || []).length > 0) {
     console.log('\nProjects:');
     data.projects.forEach((p) => {
       const visibility = p.visibility ? ` [${p.visibility}]` : '';
@@ -915,7 +1112,7 @@ if (commandKey === 'search') {
     console.log('\nProjects: (none)');
   }
 
-  if (data.tasks.length > 0) {
+  if ((data.tasks || []).length > 0) {
     console.log('\nTasks:');
     data.tasks.forEach((t) => {
       const prio = t.priority && t.priority !== 'normal' ? ` (${t.priority})` : '';
@@ -925,7 +1122,7 @@ if (commandKey === 'search') {
     console.log('\nTasks: (none)');
   }
 
-  if (data.updates.length > 0) {
+  if ((data.updates || []).length > 0) {
     console.log('\nUpdates:');
     data.updates.forEach((u) => {
       const vis = u.visibility === 'internal' ? ' [INTERNAL]' : '';
@@ -935,6 +1132,16 @@ if (commandKey === 'search') {
     console.log('\nUpdates: (none)');
   }
 
+  for (const [label, key] of [['Comments', 'comments'], ['Notes', 'notes'], ['Docs', 'docs'], ['Capacity', 'capacity']]) {
+    const items = data[key] || [];
+    if (items.length === 0) continue;
+    console.log(`\n${label}:`);
+    items.forEach((item) => {
+      const text = item.title || item.contentPreview || item.documentNumber || item.documentType || item.status || item.billableStatus || item.id;
+      console.log(`  • ${text} [${item.id}]`);
+    });
+  }
+
   exitGracefully(0);
 }
 

package/package.json

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