@empirical-gauzza/cli 1.0.38 → 1.0.40

package/lib/workspaceCommands.js

@@ -8,6 +8,7 @@ const { readStoredOAuthClient } = require('./oauthClient');
 const { deriveBaseUrlFromMcpUrl } = require('./constants');
 const { withCliAnalyticsContext } = require('./memoryCommands');
 const { runWorkspaceInterview, sanitizeForTerminal } = require('./setupCommands');
+const { isManualShapeAction, runManualShapeCommand } = require('./shapeCommands');
 const { isInteractiveTerminal } = require('./empiricalTokensFormat');
 const {
   writeSelectedWorkspace,
@@ -52,7 +53,55 @@ async function resolveShapeTarget({ requested, local, answersFile, acceptCost, i
 function isWorkspaceCommand(args) {
   if (args[0] !== 'workspace') return false;
   if (['list', 'current', 'select', 'use', 'unbind', 'create', 'delete', 'shape'].includes(args[1])) return true;
-  return args[1] === 'invite' && ['create', 'list', 'revoke'].includes(args[2]);
+  return args[1] === 'invite' && ['create', 'list', 'revoke', 'email'].includes(args[2]);
+}
+
+// Mirrors WORKSPACE_INVITE_NOTE_MAX in @empirical/shared for a local pre-check only; the CLI is
+// published on its own and cannot import it. The server re-checks and is the one that decides.
+const INVITE_NOTE_MAX = 1000;
+
+const NOT_SENT_REASONS = {
+  invalid_email: 'not a valid email address',
+  already_member: 'already a member',
+  already_invited: 'already has a pending invite',
+  seat_limit: 'the workspace has no free seat',
+  recipient_suppressed: 'this address has bounced or unsubscribed before',
+  email_not_configured: 'email is not set up on this server',
+  send_failed: 'the email could not be sent'
+};
+
+// empirical workspace invite email <address...> [--role reader|writer] [--note <text> | --note-file <path>] [--from-name <name>]
+async function runInviteEmail({ args, inviteUrl, authHeaders, target }) {
+  const emails = positionalArgs(args, 3).join(' ').split(/[\s,;]+/).map((e) => e.trim()).filter(Boolean);
+  if (!emails.length) {
+    throw new Error('Usage: empirical workspace invite email <address...> [--role reader|writer] [--note <text> | --note-file <path>] [--from-name <name>] [--workspace-id <id>]');
+  }
+  const role = parseOption(args, '--role', 'reader');
+  if (!['reader', 'writer'].includes(role)) throw new Error('--role must be reader or writer for an emailed invite.');
+  const noteFile = parseOption(args, '--note-file', '');
+  let note = parseOption(args, '--note', '');
+  if (noteFile) {
+    if (note) throw new Error('Use --note or --note-file, not both.');
+    note = require('fs').readFileSync(noteFile, 'utf8');
+  }
+  note = String(note || '').replace(/\r\n?/g, '\n').trim();
+  if (note.length > INVITE_NOTE_MAX) throw new Error(`Keep the note under ${INVITE_NOTE_MAX} characters (it is ${note.length}).`);
+  // The name the email says it is from, for this send only. Empty means your account's display name.
+  const fromName = String(parseOption(args, '--from-name', '') || '').replace(/\s+/g, ' ').trim();
+  if (fromName && fromName.includes('@')) throw new Error('--from-name takes a name, not an email address.');
+  if (fromName && (fromName.length < 2 || fromName.length > 64)) throw new Error('--from-name must be 2 to 64 characters.');
+
+  const payload = await httpJson(`${inviteUrl}/email`, 'POST', { emails, accessRole: role, ...(note ? { note } : {}), ...(fromName ? { fromName } : {}) }, authHeaders);
+  const results = Array.isArray(payload?.results) ? payload.results : [];
+  const sent = results.filter((r) => r.sent);
+  const notSent = results.filter((r) => !r.sent);
+  if (sent.length) log(uiSuccess(`Invited to ${target.label} as ${role}: ${sent.map((r) => r.email).join(', ')}`));
+  for (const r of notSent) {
+    log(`Not sent to ${r.email}: ${NOT_SENT_REASONS[r.skippedReason] || r.skippedReason || 'unknown reason'}.${r.detail ? ` ${r.detail}` : ''}`);
+  }
+  if (sent.length && payload?.fromName) log(`Sent as ${payload.fromName}.`);
+  if (sent.length && note) log('Your note was included.');
+  if (!sent.length) process.exitCode = 1;
 }
 
 function describeSelectionSource(selection) {
@@ -71,7 +120,7 @@ function workspaceOptions(payload) {
 }
 
 function positionalArgs(args, startIndex) {
-  const valueOptions = new Set(['--description', '--role', '--expires-in-days', '--max-uses', '--answers', '--workspace-id']);
+  const valueOptions = new Set(['--description', '--role', '--expires-in-days', '--max-uses', '--answers', '--workspace-id', '--note', '--note-file', '--from-name']);
   const positional = [];
   for (let index = startIndex; index < args.length; index += 1) {
     if (valueOptions.has(args[index])) {
@@ -307,6 +356,13 @@ async function runWorkspaceCommand(args) {
         return;
       }
 
+      if (action === 'shape' && isManualShapeAction(args)) {
+        // Editing the shape by hand (show, set, edit, add-type, add-status, add-field): no interview, no charge.
+        // A dry run unless --apply, and a change is only applied to the shape that was previewed.
+        const bound = resolveLocalWorkspaceSelection();
+        return runManualShapeCommand({ args, baseUrl, authHeaders, resolveBound: () => (bound && bound.workspaceId) || '' });
+      }
+
       if (action === 'shape') {
         // Re-shapes a team workspace you manage through the interview. resolveShapeTarget decides which: an
         // explicit --workspace-id, or (at a terminal only, after a named yes) the bound workspace.
@@ -392,17 +448,23 @@ async function runWorkspaceCommand(args) {
       if (action === 'invite') {
         requireClientId(clientId);
         const inviteAction = args[2];
-        const currentPayload = await httpJson(currentUrl, 'GET', null, authHeaders);
-        const current = currentPayload?.current;
-        if (!current?.key || current.key === 'default_brain') {
-          throw new Error('Workspace invites require an active team workspace. Use `empirical workspace use <workspace>` first.');
+        const namedWorkspace = parseOption(args, '--workspace-id', '');
+        let target;
+        if (namedWorkspace) {
+          target = { workspaceId: namedWorkspace, label: namedWorkspace };
+        } else {
+          const currentPayload = await httpJson(currentUrl, 'GET', null, authHeaders);
+          const current = currentPayload?.current;
+          if (!current?.key || current.key === 'default_brain') {
+            throw new Error('Workspace invites require an active team workspace. Use `empirical workspace use <workspace>` first, or pass --workspace-id.');
+          }
+          const teamPayload = await httpJson(teamBrainsUrl, 'GET', null, authHeaders);
+          target = resolveWorkspaceTarget(
+            current.workspaceId || current.key,
+            { workspaces: [{ key: current.key, label: current.label, workspaceId: current.workspaceId }] },
+            teamPayload
+          );
         }
-        const teamPayload = await httpJson(teamBrainsUrl, 'GET', null, authHeaders);
-        const target = resolveWorkspaceTarget(
-          current.workspaceId || current.key,
-          { workspaces: [{ key: current.key, label: current.label, workspaceId: current.workspaceId }] },
-          teamPayload
-        );
         if (!target?.workspaceId) {
           throw new Error('The active workspace is not a team workspace available for invites.');
         }
@@ -426,6 +488,11 @@ async function runWorkspaceCommand(args) {
           return;
         }
 
+        if (inviteAction === 'email') {
+          await runInviteEmail({ args, inviteUrl, authHeaders, target });
+          return;
+        }
+
         if (inviteAction === 'list') {
           const payload = await httpJson(inviteUrl, 'GET', null, authHeaders);
           const invites = Array.isArray(payload?.invites) ? payload.invites : [];

package/package.json

@@ -1,33 +1,33 @@
-{
-  "name": "@empirical-gauzza/cli",
-  "version": "1.0.38",
-  "description": "Persistent cross-tool memory for AI agents. Give Claude Code, Codex, Copilot, Cursor, and ChatGPT one shared memory: save project context once, recall it everywhere via CLI or MCP.",
-  "keywords": [
-    "memory",
-    "mcp",
-    "agent memory",
-    "ai memory",
-    "claude",
-    "chatgpt",
-    "model context protocol",
-    "persistent memory",
-    "claude-code",
-    "codex",
-    "knowledge base"
-  ],
-  "type": "commonjs",
-  "license": "MIT",
-  "homepage": "https://empirical.gauzza.com/docs/cli-details",
-  "publishConfig": {
-    "access": "public"
-  },
-  "bin": {
-    "empirical": "bin/empirical.js"
-  },
-  "engines": {
-    "node": ">=18.0.0"
-  },
-  "dependencies": {
-    "gray-matter": "^4.0.3"
-  }
-}
+{
+  "name": "@empirical-gauzza/cli",
+  "version": "1.0.40",
+  "description": "Persistent cross-tool memory for AI agents. Give Claude Code, Codex, Copilot, Cursor, and ChatGPT one shared memory: save project context once, recall it everywhere via CLI or MCP.",
+  "keywords": [
+    "memory",
+    "mcp",
+    "agent memory",
+    "ai memory",
+    "claude",
+    "chatgpt",
+    "model context protocol",
+    "persistent memory",
+    "claude-code",
+    "codex",
+    "knowledge base"
+  ],
+  "type": "commonjs",
+  "license": "MIT",
+  "homepage": "https://empirical.gauzza.com/docs/cli-details",
+  "publishConfig": {
+    "access": "public"
+  },
+  "bin": {
+    "empirical": "bin/empirical.js"
+  },
+  "engines": {
+    "node": ">=18.0.0"
+  },
+  "dependencies": {
+    "gray-matter": "^4.0.3"
+  }
+}