@empirical-gauzza/cli 1.0.15 → 1.0.17

package/lib/constants.js

@@ -202,7 +202,7 @@ Invite commands operate on the active team workspace. Create prints a shareable
     empirical workspace delete <number|name|id>
     empirical workspace delete <number|name|id> --confirm
 
-Deletion dry-runs by default. \`--confirm\` calls the existing soft-delete endpoint; the Default Brain cannot be deleted. If the active workspace is deleted, the CLI selects the Default Brain.
+Deletion dry-runs by default. \`--confirm\` calls the existing soft-delete endpoint; the Default Workspace cannot be deleted. If the active workspace is deleted, the CLI selects the Default Workspace.
 `,
 
   doctor: `# Empirical Doctor

package/lib/help.js

@@ -19,26 +19,32 @@ function showHelp() {
   log('  empirical plugin check [--force]');
   log('  empirical policy show [--refresh]');
   log('  empirical policy set --json <policy>');
-  log('  empirical auth login');
-  log('  empirical auth logout');
+  log('  empirical auth login                         Interactive browser login');
+  log('  empirical auth logout                        Clear the locally stored session');
   log('  empirical oauth bootstrap headless [--print-access-token]');
+  log('                                                First-time token setup for CI/headless/API-key use');
   log('  empirical oauth bootstrap headless --write-env [--env-output <path>]');
   log('  empirical oauth refresh headless [--print-access-token]');
+  log('                                                Renew an existing headless token before/after it expires');
   log('  empirical oauth refresh headless --write-env [--env-output <path>]');
   log('  empirical oauth bootstrap docker [--print-access-token]');
+  log('                                                Same as bootstrap headless, tuned for container startup');
   log('  empirical oauth refresh docker [--print-access-token]');
   log('  empirical oauth client set [--client-id <id>] [--client-secret <secret>]');
   log('  empirical oauth client show');
   log('  empirical oauth client clear');
-  log('  empirical workspace list');
-  log('  empirical workspace current');
-  log('  empirical workspace select [<number|name>]');
-  log('  empirical workspace use <number|name|id>');
+  log('  empirical workspace list                     List workspaces you can select, and which one is active');
+  log('  empirical workspace current                  Show the currently active workspace');
+  log('  empirical workspace select [<number|name>]   Set the active workspace (prompts if omitted)');
+  log('  empirical workspace use <number|name|id>     Alias for `workspace select`');
   log('  empirical workspace create <name> [--description <text>]');
+  log('                                                Create a new shared team workspace');
   log('  empirical workspace invite create [--role reader|writer|manager] [--expires-in-days <n>] [--max-uses <n>]');
-  log('  empirical workspace invite list');
-  log('  empirical workspace invite revoke <token>');
+  log('                                                Create a shareable invite link for the active team workspace');
+  log('  empirical workspace invite list              List active invites for the active team workspace');
+  log('  empirical workspace invite revoke <token>    Revoke a previously created invite');
   log('  empirical workspace delete <number|name|id> [--confirm]');
+  log('                                                Soft-delete a team workspace (dry-run without --confirm)');
   log('  empirical oauth bootstrap openclaw [--print-access-token]   (legacy alias)');
   log('  empirical oauth refresh openclaw [--print-access-token]     (legacy alias)');
   log('  empirical --oauth-bootstrap-headless [--print-access-token]');

package/lib/pluginUpdateCheck.js

@@ -1,143 +1,148 @@
-'use strict';
-
-const { askYesNo, ask, log, warn, uiHeader, parseSelection } = require('./ui');
-const { runResolvedCommand, commandExists, summarizeProcessOutput } = require('./fsUtils');
-const { readDeviceConfig, writeDeviceConfig } = require('./deviceConfig');
-const { installNativePlugin } = require('./installers/nativePlugin');
-
-const PLUGIN_METADATA_URL = 'https://raw.githubusercontent.com/mattgauzza/empirical-memory-plugin/main/.claude-plugin/marketplace.json';
-const CHECK_INTERVAL_MS = 24 * 60 * 60 * 1000;
-const SUPPORTED_TARGETS = ['codex', 'claude', 'copilot'];
-
-function parseVersion(value) {
-  const match = String(value || '').trim().match(/^v?(\d+)\.(\d+)\.(\d+)/i);
-  return match ? match.slice(1).map(Number) : null;
-}
-
-function compareVersions(left, right) {
-  const a = parseVersion(left);
-  const b = parseVersion(right);
-  if (!a || !b) return null;
-  for (let i = 0; i < 3; i += 1) {
-    if (a[i] !== b[i]) return a[i] > b[i] ? 1 : -1;
-  }
-  return 0;
-}
-
-function extractVersion(output, pluginName = 'empirical-memory') {
-  const text = String(output || '');
-  const jsonCandidates = [text, ...text.split(/\r?\n/).map((line) => line.trim())];
-  for (const candidate of jsonCandidates) {
-    try {
-      const value = JSON.parse(candidate);
-      const rows = Array.isArray(value) ? value : [value, ...(Array.isArray(value?.plugins) ? value.plugins : [])];
-      const match = rows.find((row) => row && (row.name === pluginName || row.plugin === pluginName));
-      if (match?.version) return String(match.version);
-    } catch (_error) {
-      // Native CLIs may print a table instead of JSON.
-    }
-  }
-  const line = text.split(/\r?\n/).find((value) => value.toLowerCase().includes(pluginName.toLowerCase()));
-  const match = line && line.match(new RegExp(`${pluginName.replace(/[.*+?^${}()|[\]\\]/g, '\\$&')}[^\\d]*(\\d+\\.\\d+\\.\\d+)`, 'i'));
-  return match ? match[1] : null;
-}
-
-function readInstalledVersions(target, pluginNames) {
-  const commands = {
-    codex: ['codex', ['plugin', 'list']],
-    claude: ['claude', ['plugin', 'list']],
-    copilot: ['copilot', ['plugin', 'list']]
-  };
-  const [command, args] = commands[target];
-  if (!commandExists(command)) return null;
-  const result = runResolvedCommand(command, args, { stdio: 'pipe' });
-  if (!result || result.status !== 0) return null;
-  const output = `${result.stdout || ''}\n${result.stderr || ''}`;
-  return Object.fromEntries(pluginNames.map((name) => [name, extractVersion(output, name)]));
-}
-
-async function fetchLatestVersions(fetchImpl = globalThis.fetch) {
-  if (typeof fetchImpl !== 'function') return null;
-  const response = await fetchImpl(PLUGIN_METADATA_URL, { signal: AbortSignal.timeout(5000) });
-  if (!response.ok) throw new Error(`marketplace metadata returned HTTP ${response.status}`);
-  const data = await response.json();
-  if (Array.isArray(data?.plugins)) {
-    return Object.fromEntries(data.plugins.map((plugin) => [plugin.name, plugin.version]).filter(([, version]) => version));
-  }
-  return data?.version ? { 'empirical-memory': data.version } : {};
-}
-
-function shouldCheck(cache, now = Date.now(), force = false) {
-  return force || !cache?.checkedAt || now - Number(cache.checkedAt) >= CHECK_INTERVAL_MS;
-}
-
-async function checkNativePluginUpdates({ force = false, interactive = process.stdin.isTTY, fetchImpl } = {}) {
-  if (!interactive && !force) return { skipped: true, reason: 'noninteractive' };
-  const config = readDeviceConfig();
-  const cache = config.pluginUpdates || {};
-  if (!shouldCheck(cache, Date.now(), force)) return { skipped: true, reason: 'rate_limited' };
-
-  let latestVersion;
-  try {
-    latestVersion = await fetchLatestVersions(fetchImpl);
-  } catch (error) {
-    config.pluginUpdates = { ...cache, checkedAt: Date.now(), lastError: error.message };
-    writeDeviceConfig(config);
-    return { skipped: true, reason: 'marketplace_unavailable' };
-  }
-  const pluginNames = Object.keys(latestVersion);
-  const installed = {};
-  for (const target of SUPPORTED_TARGETS) installed[target] = readInstalledVersions(target, pluginNames);
-  config.pluginUpdates = { checkedAt: Date.now(), latestVersions: latestVersion, installed };
-  writeDeviceConfig(config);
-
-  const outdated = SUPPORTED_TARGETS.flatMap((target) => pluginNames
-    .filter((name) => compareVersions(latestVersion[name], installed[target][name]) === 1)
-    .map((name) => ({ target, name, installed: installed[target][name], latest: latestVersion[name] })));
-  const latestSignature = JSON.stringify(latestVersion);
-  if (outdated.length === 0 || cache.offeredVersion === latestSignature) {
-    return { latestVersion, installed, outdated };
-  }
-
-  if (!interactive) {
-    return { latestVersion, installed, outdated, promptSuppressed: true };
-  }
-
-  log(uiHeader(`A newer empirical-memory plugin is available (${latestVersion}).`));
-  log(`Installed versions: ${outdated.map((item) => `${item.target} ${item.name} ${item.installed} -> ${item.latest}`).join(', ')}`);
-  const update = await askYesNo('Update the native plugin now?', true);
-  if (!update) {
-    config.pluginUpdates = { ...config.pluginUpdates, offeredVersion: latestSignature, outcome: 'declined' };
-    writeDeviceConfig(config);
-    return { latestVersion, installed, outdated, declined: true };
-  }
-  const selection = (await ask('Which agents should be updated? (all, or numbers 1-' + outdated.length + ') ')).trim().toLowerCase();
-  const outdatedTargets = [...new Set(outdated.map((item) => item.target))];
-  const selectedTargets = selection === 'all' || !selection
-    ? outdatedTargets
-    : parseSelection(selection, outdatedTargets.length).map((index) => outdatedTargets[index]);
-  const results = {};
-  for (const target of selectedTargets) {
-    try {
-      installNativePlugin(target, [...new Set(outdated.filter((item) => item.target === target).map((item) => item.name))]);
-      results[target] = 'updated';
-    } catch (error) {
-      results[target] = `failed: ${summarizeProcessOutput({ stderr: error.message })}`;
-      warn(`Could not update ${target}: ${error.message}`);
-    }
-  }
-  config.pluginUpdates = { ...config.pluginUpdates, offeredVersion: latestSignature, outcome: results };
-  writeDeviceConfig(config);
-  return { latestVersion, installed, outdated, results };
-}
-
-module.exports = {
-  CHECK_INTERVAL_MS,
-  SUPPORTED_TARGETS,
-  parseVersion,
-  compareVersions,
-  extractVersion,
-  shouldCheck,
-  fetchLatestVersions,
-  checkNativePluginUpdates
-};
+'use strict';
+
+const { askYesNo, ask, log, warn, uiHeader, parseSelection } = require('./ui');
+const { runResolvedCommand, commandExists, summarizeProcessOutput } = require('./fsUtils');
+const { readDeviceConfig, writeDeviceConfig } = require('./deviceConfig');
+const { installNativePlugin } = require('./installers/nativePlugin');
+
+const PLUGIN_METADATA_URL = 'https://raw.githubusercontent.com/mattgauzza/empirical-memory-plugin/main/.claude-plugin/marketplace.json';
+const CHECK_INTERVAL_MS = 24 * 60 * 60 * 1000;
+const SUPPORTED_TARGETS = ['codex', 'claude', 'copilot'];
+
+function parseVersion(value) {
+  const match = String(value || '').trim().match(/^v?(\d+)\.(\d+)\.(\d+)/i);
+  return match ? match.slice(1).map(Number) : null;
+}
+
+function compareVersions(left, right) {
+  const a = parseVersion(left);
+  const b = parseVersion(right);
+  if (!a || !b) return null;
+  for (let i = 0; i < 3; i += 1) {
+    if (a[i] !== b[i]) return a[i] > b[i] ? 1 : -1;
+  }
+  return 0;
+}
+
+function extractVersion(output, pluginName = 'empirical-memory') {
+  const text = String(output || '');
+  const jsonCandidates = [text, ...text.split(/\r?\n/).map((line) => line.trim())];
+  for (const candidate of jsonCandidates) {
+    try {
+      const value = JSON.parse(candidate);
+      const rows = Array.isArray(value) ? value : [value, ...(Array.isArray(value?.plugins) ? value.plugins : [])];
+      const match = rows.find((row) => row && (row.name === pluginName || row.plugin === pluginName));
+      if (match?.version) return String(match.version);
+    } catch (_error) {
+      // Native CLIs may print a table instead of JSON.
+    }
+  }
+  const line = text.split(/\r?\n/).find((value) => value.toLowerCase().includes(pluginName.toLowerCase()));
+  const match = line && line.match(new RegExp(`${pluginName.replace(/[.*+?^${}()|[\]\\]/g, '\\$&')}[^\\d]*(\\d+\\.\\d+\\.\\d+)`, 'i'));
+  return match ? match[1] : null;
+}
+
+function readInstalledVersions(target, pluginNames) {
+  const commands = {
+    codex: ['codex', ['plugin', 'list']],
+    claude: ['claude', ['plugin', 'list']],
+    copilot: ['copilot', ['plugin', 'list']]
+  };
+  const [command, args] = commands[target];
+  if (!commandExists(command)) return null;
+  const result = runResolvedCommand(command, args, { stdio: 'pipe' });
+  if (!result || result.status !== 0) return null;
+  const output = `${result.stdout || ''}\n${result.stderr || ''}`;
+  return Object.fromEntries(pluginNames.map((name) => [name, extractVersion(output, name)]));
+}
+
+async function fetchLatestVersions(fetchImpl = globalThis.fetch) {
+  if (typeof fetchImpl !== 'function') return null;
+  const response = await fetchImpl(PLUGIN_METADATA_URL, { signal: AbortSignal.timeout(5000) });
+  if (!response.ok) throw new Error(`marketplace metadata returned HTTP ${response.status}`);
+  const data = await response.json();
+  if (Array.isArray(data?.plugins)) {
+    return Object.fromEntries(data.plugins.map((plugin) => [plugin.name, plugin.version]).filter(([, version]) => version));
+  }
+  return data?.version ? { 'empirical-memory': data.version } : {};
+}
+
+function shouldCheck(cache, now = Date.now(), force = false) {
+  return force || !cache?.checkedAt || now - Number(cache.checkedAt) >= CHECK_INTERVAL_MS;
+}
+
+async function checkNativePluginUpdates({ force = false, interactive = process.stdin.isTTY, fetchImpl } = {}) {
+  if (!interactive && !force) return { skipped: true, reason: 'noninteractive' };
+  const config = readDeviceConfig();
+  const cache = config.pluginUpdates || {};
+  if (!shouldCheck(cache, Date.now(), force)) return { skipped: true, reason: 'rate_limited' };
+
+  let latestVersion;
+  try {
+    latestVersion = await fetchLatestVersions(fetchImpl);
+  } catch (error) {
+    config.pluginUpdates = { ...cache, checkedAt: Date.now(), lastError: error.message };
+    writeDeviceConfig(config);
+    return { skipped: true, reason: 'marketplace_unavailable' };
+  }
+  const pluginNames = Object.keys(latestVersion);
+  const installed = {};
+  for (const target of SUPPORTED_TARGETS) installed[target] = readInstalledVersions(target, pluginNames);
+  config.pluginUpdates = { checkedAt: Date.now(), latestVersions: latestVersion, installed };
+  writeDeviceConfig(config);
+
+  const outdated = SUPPORTED_TARGETS.flatMap((target) => pluginNames
+    .filter((name) => compareVersions(latestVersion[name], installed[target][name]) === 1)
+    .map((name) => ({ target, name, installed: installed[target][name], latest: latestVersion[name] })));
+  const latestSignature = JSON.stringify(latestVersion);
+  if (outdated.length === 0 || cache.offeredVersion === latestSignature) {
+    return { latestVersion, installed, outdated };
+  }
+
+  if (!interactive) {
+    return { latestVersion, installed, outdated, promptSuppressed: true };
+  }
+
+  // latestVersion is a map of pluginName -> version (e.g. {'empirical-memory': '1.1.2', ...}),
+  // not a single scalar -- interpolating it directly stringified to "[object Object]". Prefer
+  // the core plugin's version since that's the one most users recognize; the per-target
+  // breakdown line right below already lists every outdated plugin/version precisely.
+  const headlineVersion = latestVersion['empirical-memory'] || Object.values(latestVersion)[0] || 'update available';
+  log(uiHeader(`A newer empirical-memory plugin is available (${headlineVersion}).`));
+  log(`Installed versions: ${outdated.map((item) => `${item.target} ${item.name} ${item.installed} -> ${item.latest}`).join(', ')}`);
+  const update = await askYesNo('Update the native plugin now?', true);
+  if (!update) {
+    config.pluginUpdates = { ...config.pluginUpdates, offeredVersion: latestSignature, outcome: 'declined' };
+    writeDeviceConfig(config);
+    return { latestVersion, installed, outdated, declined: true };
+  }
+  const selection = (await ask('Which agents should be updated? (all, or numbers 1-' + outdated.length + ') ')).trim().toLowerCase();
+  const outdatedTargets = [...new Set(outdated.map((item) => item.target))];
+  const selectedTargets = selection === 'all' || !selection
+    ? outdatedTargets
+    : parseSelection(selection, outdatedTargets.length).map((index) => outdatedTargets[index]);
+  const results = {};
+  for (const target of selectedTargets) {
+    try {
+      installNativePlugin(target, [...new Set(outdated.filter((item) => item.target === target).map((item) => item.name))]);
+      results[target] = 'updated';
+    } catch (error) {
+      results[target] = `failed: ${summarizeProcessOutput({ stderr: error.message })}`;
+      warn(`Could not update ${target}: ${error.message}`);
+    }
+  }
+  config.pluginUpdates = { ...config.pluginUpdates, offeredVersion: latestSignature, outcome: results };
+  writeDeviceConfig(config);
+  return { latestVersion, installed, outdated, results };
+}
+
+module.exports = {
+  CHECK_INTERVAL_MS,
+  SUPPORTED_TARGETS,
+  parseVersion,
+  compareVersions,
+  extractVersion,
+  shouldCheck,
+  fetchLatestVersions,
+  checkNativePluginUpdates
+};

package/lib/workspaceCommands.js

@@ -174,11 +174,11 @@ async function runWorkspaceCommand(args) {
           const selected = payload.defaultOption.selected
             ? payload.defaultOption
             : (payload.workspaces || []).find((ws) => ws.selected) || payload.defaultOption;
-          log(`Current workspace: ${selected.label || 'Default Brain'}`);
+          log(`Current workspace: ${selected.label || 'Default Workspace'}`);
           return;
         }
         const payload = await httpJson(currentUrl, 'GET', null, authHeaders);
-        log(`Current workspace: ${payload?.current?.label || 'Default Brain'}`);
+        log(`Current workspace: ${payload?.current?.label || 'Default Workspace'}`);
         if (payload?.locked) {
           log('This OAuth client is admin-locked to a workspace.');
         }
@@ -206,7 +206,7 @@ async function runWorkspaceCommand(args) {
         }
 
         if (!requested) {
-          throw new Error('Please provide a workspace selection, e.g. `empirical workspace use 1` or `empirical workspace use "Default Brain"`.');
+          throw new Error('Please provide a workspace selection, e.g. `empirical workspace use 1` or `empirical workspace use "Default Workspace"`.');
         }
 
         const target = resolveWorkspaceTarget(requested, payload, teamPayload);
@@ -250,7 +250,7 @@ async function runWorkspaceCommand(args) {
         if (target?.ambiguous) throw new Error(`Ambiguous workspace: ${requested}. Use its list number or workspace ID.`);
         if (!target) throw new Error(`Workspace not found: ${requested}`);
         if (target.isDefault || target.key === 'default_brain') {
-          throw new Error('The Default Brain cannot be deleted.');
+          throw new Error('The Default Workspace cannot be deleted.');
         }
         if (!target.workspaceId) throw new Error(`Workspace is not a deletable team brain: ${target.label}`);
 
@@ -265,7 +265,7 @@ async function runWorkspaceCommand(args) {
         if (target.selected && clientId) {
           const updateUrl = new URL(`/oauth/clients/${encodedClientId}/workspace-selection`, baseUrl).toString();
           const updated = await httpJson(updateUrl, 'POST', { key: 'default_brain' }, authHeaders);
-          log(uiSuccess(`Soft-deleted workspace ${targetDescription}. Active workspace reset to ${updated?.current?.label || 'Default Brain'}.`));
+          log(uiSuccess(`Soft-deleted workspace ${targetDescription}. Active workspace reset to ${updated?.current?.label || 'Default Workspace'}.`));
           clearSelectedWorkspace();
         } else {
           log(uiSuccess(`Soft-deleted workspace ${targetDescription}.`));

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@empirical-gauzza/cli",
-  "version": "1.0.15",
+  "version": "1.0.17",
   "description": "Empirical CLI installer and local MCP wiring helper",
   "type": "commonjs",
   "license": "MIT",