@klevar/portal-cli 0.1.11 → 0.1.13

package/dist/commands/index.d.ts

@@ -522,6 +522,74 @@ export declare const COMMAND_GROUPS: {
             description: string;
         };
     };
+    notes: {
+        'notes.list': {
+            method: "GET";
+            path: string;
+            auth: "apiKey";
+            description: string;
+            queryParams: string[];
+        };
+        'notes.create': {
+            method: "POST";
+            path: string;
+            auth: "apiKey";
+            description: string;
+            body: string[];
+        };
+        'notes.update': {
+            method: "PATCH";
+            path: string;
+            auth: "apiKey";
+            description: string;
+            body: string[];
+        };
+        'notes.comments': {
+            method: "GET";
+            path: string;
+            auth: "apiKey";
+            description: string;
+        };
+        'notes.reply': {
+            method: "POST";
+            path: string;
+            auth: "apiKey";
+            description: string;
+            body: string[];
+        };
+        'portal.notes': {
+            method: "GET";
+            path: string;
+            auth: "portalToken";
+            description: string;
+        };
+        'portal.notes.project': {
+            method: "GET";
+            path: string;
+            auth: "portalToken";
+            description: string;
+        };
+        'portal.notes.create': {
+            method: "POST";
+            path: string;
+            auth: "portalToken";
+            description: string;
+            body: string[];
+        };
+        'portal.notes.comments': {
+            method: "GET";
+            path: string;
+            auth: "portalToken";
+            description: string;
+        };
+        'portal.notes.reply': {
+            method: "POST";
+            path: string;
+            auth: "portalToken";
+            description: string;
+            body: string[];
+        };
+    };
     metrics: {
         'metrics.push': {
             method: "POST";

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 { noteCommands } from './notes.js';
 import { portalCommands } from './portal.js';
 import { projectCommands } from './projects.js';
 import { systemCommands } from './system.js';
@@ -18,6 +19,7 @@ export const COMMAND_GROUPS = {
     usage: usageCommands,
     updates: updateCommands,
     onboarding: onboardingCommands,
+    notes: noteCommands,
     metrics: metricCommands,
     docs: docsCommands,
     portal: portalCommands,

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,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"}
+{"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,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,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/notes.d.ts

@@ -0,0 +1,68 @@
+export declare const noteCommands: {
+    'notes.list': {
+        method: "GET";
+        path: string;
+        auth: "apiKey";
+        description: string;
+        queryParams: string[];
+    };
+    'notes.create': {
+        method: "POST";
+        path: string;
+        auth: "apiKey";
+        description: string;
+        body: string[];
+    };
+    'notes.update': {
+        method: "PATCH";
+        path: string;
+        auth: "apiKey";
+        description: string;
+        body: string[];
+    };
+    'notes.comments': {
+        method: "GET";
+        path: string;
+        auth: "apiKey";
+        description: string;
+    };
+    'notes.reply': {
+        method: "POST";
+        path: string;
+        auth: "apiKey";
+        description: string;
+        body: string[];
+    };
+    'portal.notes': {
+        method: "GET";
+        path: string;
+        auth: "portalToken";
+        description: string;
+    };
+    'portal.notes.project': {
+        method: "GET";
+        path: string;
+        auth: "portalToken";
+        description: string;
+    };
+    'portal.notes.create': {
+        method: "POST";
+        path: string;
+        auth: "portalToken";
+        description: string;
+        body: string[];
+    };
+    'portal.notes.comments': {
+        method: "GET";
+        path: string;
+        auth: "portalToken";
+        description: string;
+    };
+    'portal.notes.reply': {
+        method: "POST";
+        path: string;
+        auth: "portalToken";
+        description: string;
+        body: string[];
+    };
+};

package/dist/commands/notes.js

@@ -0,0 +1,13 @@
+export const noteCommands = {
+    'notes.list': { method: 'GET', path: '/api/admin/notes', auth: 'apiKey', description: 'List client notes', queryParams: ['clientId', 'projectId', 'status'] },
+    'notes.create': { method: 'POST', path: '/api/admin/notes', auth: 'apiKey', description: 'Create client note (--clientId --title --content/--content-file/--stdin --projectIds)', body: ['clientId', 'title', 'content', 'projectIds'] },
+    'notes.update': { method: 'PATCH', path: '/api/admin/notes/:noteId', auth: 'apiKey', description: 'Update client note', body: ['title', 'content', 'status', 'projectIds'] },
+    'notes.comments': { method: 'GET', path: '/api/admin/notes/:noteId/comments', auth: 'apiKey', description: 'List note comments' },
+    'notes.reply': { method: 'POST', path: '/api/admin/notes/:noteId/comments', auth: 'apiKey', description: 'Reply to client note (--content, --content-file, or --stdin)', body: ['content'] },
+    'portal.notes': { method: 'GET', path: '/api/portal/notes', auth: 'portalToken', description: 'List portal notes' },
+    'portal.notes.project': { method: 'GET', path: '/api/portal/projects/:id/notes', auth: 'portalToken', description: 'List portal notes for a project' },
+    'portal.notes.create': { method: 'POST', path: '/api/portal/notes', auth: 'portalToken', description: 'Create portal note (--title --content/--content-file/--stdin --projectIds)', body: ['title', 'content', 'projectIds'] },
+    'portal.notes.comments': { method: 'GET', path: '/api/portal/notes/:noteId/comments', auth: 'portalToken', description: 'List portal note comments' },
+    'portal.notes.reply': { method: 'POST', path: '/api/portal/notes/:noteId/comments', auth: 'portalToken', description: 'Reply to portal note (--content, --content-file, or --stdin)', body: ['content'] },
+};
+//# sourceMappingURL=notes.js.map

package/dist/commands/notes.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"notes.js","sourceRoot":"","sources":["../../commands/notes.ts"],"names":[],"mappings":"AAEA,MAAM,CAAC,MAAM,YAAY,GAAG;IAC1B,YAAY,EAAE,EAAE,MAAM,EAAE,KAAK,EAAE,IAAI,EAAE,kBAAkB,EAAE,IAAI,EAAE,QAAQ,EAAE,WAAW,EAAE,mBAAmB,EAAE,WAAW,EAAE,CAAC,UAAU,EAAE,WAAW,EAAE,QAAQ,CAAC,EAAE;IAC7J,cAAc,EAAE,EAAE,MAAM,EAAE,MAAM,EAAE,IAAI,EAAE,kBAAkB,EAAE,IAAI,EAAE,QAAQ,EAAE,WAAW,EAAE,uFAAuF,EAAE,IAAI,EAAE,CAAC,UAAU,EAAE,OAAO,EAAE,SAAS,EAAE,YAAY,CAAC,EAAE;IACxO,cAAc,EAAE,EAAE,MAAM,EAAE,OAAO,EAAE,IAAI,EAAE,0BAA0B,EAAE,IAAI,EAAE,QAAQ,EAAE,WAAW,EAAE,oBAAoB,EAAE,IAAI,EAAE,CAAC,OAAO,EAAE,SAAS,EAAE,QAAQ,EAAE,YAAY,CAAC,EAAE;IAC5K,gBAAgB,EAAE,EAAE,MAAM,EAAE,KAAK,EAAE,IAAI,EAAE,mCAAmC,EAAE,IAAI,EAAE,QAAQ,EAAE,WAAW,EAAE,oBAAoB,EAAE;IACjI,aAAa,EAAE,EAAE,MAAM,EAAE,MAAM,EAAE,IAAI,EAAE,mCAAmC,EAAE,IAAI,EAAE,QAAQ,EAAE,WAAW,EAAE,8DAA8D,EAAE,IAAI,EAAE,CAAC,SAAS,CAAC,EAAE;IAC5L,cAAc,EAAE,EAAE,MAAM,EAAE,KAAK,EAAE,IAAI,EAAE,mBAAmB,EAAE,IAAI,EAAE,aAAa,EAAE,WAAW,EAAE,mBAAmB,EAAE;IACnH,sBAAsB,EAAE,EAAE,MAAM,EAAE,KAAK,EAAE,IAAI,EAAE,gCAAgC,EAAE,IAAI,EAAE,aAAa,EAAE,WAAW,EAAE,iCAAiC,EAAE;IACtJ,qBAAqB,EAAE,EAAE,MAAM,EAAE,MAAM,EAAE,IAAI,EAAE,mBAAmB,EAAE,IAAI,EAAE,aAAa,EAAE,WAAW,EAAE,4EAA4E,EAAE,IAAI,EAAE,CAAC,OAAO,EAAE,SAAS,EAAE,YAAY,CAAC,EAAE;IAC9N,uBAAuB,EAAE,EAAE,MAAM,EAAE,KAAK,EAAE,IAAI,EAAE,oCAAoC,EAAE,IAAI,EAAE,aAAa,EAAE,WAAW,EAAE,2BAA2B,EAAE;IACrJ,oBAAoB,EAAE,EAAE,MAAM,EAAE,MAAM,EAAE,IAAI,EAAE,oCAAoC,EAAE,IAAI,EAAE,aAAa,EAAE,WAAW,EAAE,8DAA8D,EAAE,IAAI,EAAE,CAAC,SAAS,CAAC,EAAE;CACnL,CAAC"}

package/dist/lib/legacy-runner.js

@@ -275,10 +275,24 @@ function normalizeCliMultiline(value) {
     : value;
 }
 
+function normalizeCsvList(value) {
+  if (Array.isArray(value)) return value;
+  if (typeof value !== 'string') return value;
+  return value
+    .split(',')
+    .map((item) => item.trim())
+    .filter(Boolean);
+}
+
 function supportsCommentContentInput(commandKey) {
   return commandKey === 'comments.create' ||
     commandKey === 'comments.update' ||
-    commandKey === 'portal.comments.create';
+    commandKey === 'portal.comments.create' ||
+    commandKey === 'notes.create' ||
+    commandKey === 'notes.update' ||
+    commandKey === 'notes.reply' ||
+    commandKey === 'portal.notes.create' ||
+    commandKey === 'portal.notes.reply';
 }
 
 function interpolatePath(template, id) {
@@ -499,6 +513,33 @@ function formatOutput(data, commandKey) {
     return;
   }
 
+  if (commandKey === 'notes.list' || commandKey === 'portal.notes' || commandKey === 'portal.notes.project') {
+    const items = data.data || [];
+    if (items.length === 0) { console.log('No notes found.'); return; }
+    console.log(`\nClient Notes (${items.length}):`);
+    console.log('-'.repeat(80));
+    for (const note of items) {
+      const projects = note.projects?.length
+        ? ` -> ${note.projects.map((project) => project.name).join(', ')}`
+        : '';
+      console.log(`  ${note.title} [${note.status}]${projects} [${note.id}]`);
+      if (note.commentCount) console.log(`    Discussion: ${note.commentCount} repl${note.commentCount === 1 ? 'y' : 'ies'}`);
+    }
+    return;
+  }
+
+  if (commandKey === 'notes.comments' || commandKey === 'portal.notes.comments') {
+    const items = data.data || [];
+    if (items.length === 0) { console.log('No note replies yet.'); return; }
+    console.log(`\nNote Discussion (${items.length}):`);
+    for (const comment of items) {
+      const badge = comment.authorType === 'admin' ? '[klevar]' : '[client]';
+      console.log(`  ${comment.authorName} ${badge} - ${timeAgo(comment.createdAt)}`);
+      console.log(`    ${comment.content}`);
+    }
+    return;
+  }
+
   if (
     commandKey === 'clients.docs-invoices' ||
     commandKey === 'projects.docs-invoices'
@@ -593,6 +634,12 @@ function formatOutput(data, commandKey) {
     return;
   }
 
+  if ((commandKey === 'notes.reply' || commandKey === 'portal.notes.reply') && data.comment) {
+    const c = data.comment;
+    console.log(`Note reply posted by ${c.authorName} [${c.authorType}] [${c.id}]`);
+    return;
+  }
+
   // Onboarding create/process/reject
   if (commandKey === 'onboarding.create' && data.id) {
     console.log(`Submission created: ${data.id} [${data.status}]`);
@@ -646,6 +693,13 @@ function formatOutput(data, commandKey) {
     console.log(`${action}${vis}: ${u.content.slice(0, 80)}${u.content.length > 80 ? '...' : ''} [${u.id}]${edited}`);
     return;
   }
+  if (data.note) {
+    const n = data.note;
+    const projects = n.projects?.length ? ` (${n.projects.map((project) => project.name).join(', ')})` : '';
+    const action = commandKey === 'notes.update' ? 'Note updated' : 'Note created';
+    console.log(`${action}: ${n.title} [${n.status}]${projects} [${n.id}]`);
+    return;
+  }
   if (data.portalToken) {
     console.log(`New token: ${data.portalToken}`);
     return;
@@ -696,7 +750,9 @@ if (!resource || resource === 'help' || resource === '--help') {
   console.log('Commands:');
   const grouped = {};
   for (const [key, cmd] of Object.entries(COMMANDS)) {
-    const [res, act] = key.includes('.') ? key.split('.') : [key, ''];
+    const parts = key.split('.');
+    const res = parts[0];
+    const act = parts.length > 1 ? parts.slice(1).join('.') : '';
     if (!grouped[res]) grouped[res] = [];
     grouped[res].push({ key, action: act, desc: (cmd.description || cmd.desc), body: cmd.body, queryParams: cmd.queryParams });
   }
@@ -804,6 +860,7 @@ if (cmd.fixedBody) {
       if (typeof val === 'string' && (val.startsWith('{') || val.startsWith('['))) {
         try { val = JSON.parse(val); } catch { /* keep as string */ }
       }
+      if (key === 'projectIds') val = normalizeCsvList(val);
       if (val === 'true') val = true;
       if (val === 'false') val = false;
       body[key] = val;

package/package.json

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