@empirical-gauzza/cli 1.0.37 → 1.0.38

package/lib/workspaceContext.js

@@ -1,176 +1,176 @@
-'use strict';
-
-const os = require('os');
-const path = require('path');
-const fs = require('fs');
-const { execFileSync } = require('child_process');
-const { httpJson } = require('./http');
-const { getEnv } = require('./env');
-const { resolveAccessToken, resolveApiBaseUrl, buildApiAuthHeaders } = require('./auth');
-const { readStoredOAuthClient } = require('./oauthClient');
-const { readJsonIfExists, writeFile, ensureDir } = require('./fsUtils');
-
-const WORKSPACE_CONTEXT_TIMEOUT_MS = 2000;
-const SELECTED_WORKSPACE_PATH = path.join(os.homedir(), '.empirical', 'workspace-selection.json');
-
-// Per-project binding (2026-09-24). The global selection above is one file per machine, so any
-// session in any repo flips it for every other session: a WOB session left the CLI on the WOB team
-// workspace and every tag-scoped recall from an empirical_v2 session returned [] while the memories
-// existed. The unit that actually varies is the project directory, like git config, so a project
-// can pin its workspace in <repo>/.empirical/workspace.json and `use` writes there by default when
-// run inside a git repo. Resolution order, first hit wins: env, project, global, then the server's
-// per-client selection exactly as before. No project file and no env means today's behavior.
-const PROJECT_WORKSPACE_DIRNAME = '.empirical';
-const PROJECT_WORKSPACE_FILENAME = 'workspace.json';
-const WORKSPACE_ENV_VAR = 'EMPIRICAL_WORKSPACE_ID';
-
-function readSelectedWorkspace() {
-  const value = readJsonIfExists(SELECTED_WORKSPACE_PATH);
-  return value && typeof value.workspaceId === 'string' ? value : null;
-}
-
-function writeSelectedWorkspace(workspace) {
-  ensureDir(path.dirname(SELECTED_WORKSPACE_PATH));
-  writeFile(SELECTED_WORKSPACE_PATH, `${JSON.stringify(workspace, null, 2)}\n`);
-}
-
-function clearSelectedWorkspace() {
-  if (fs.existsSync(SELECTED_WORKSPACE_PATH)) fs.unlinkSync(SELECTED_WORKSPACE_PATH);
-}
-
-/**
- * Nearest <dir>/.empirical/workspace.json walking up from `startDir` to the filesystem root.
- * Returns { path, value } or null. A malformed file is ignored rather than fatal: a broken
- * binding must not take the CLI down, it just falls through to the next source.
- */
-function findProjectWorkspaceFile(startDir = process.cwd()) {
-  let dir = path.resolve(startDir);
-  for (;;) {
-    const candidate = path.join(dir, PROJECT_WORKSPACE_DIRNAME, PROJECT_WORKSPACE_FILENAME);
-    const value = readJsonIfExists(candidate);
-    if (value && typeof value.workspaceId === 'string' && value.workspaceId.trim()) {
-      return { path: candidate, value };
-    }
-    const parent = path.dirname(dir);
-    if (parent === dir) return null;
-    dir = parent;
-  }
-}
-
-/**
- * The git toplevel for `cwd`, or null outside a repo (or without git). Used to decide where
- * `workspace use` writes by default and where the project binding lives.
- */
-function findGitRoot(cwd = process.cwd()) {
-  try {
-    const out = execFileSync('git', ['rev-parse', '--show-toplevel'], {
-      cwd,
-      stdio: ['ignore', 'pipe', 'ignore'],
-      encoding: 'utf8'
-    });
-    const root = String(out || '').trim();
-    return root ? path.resolve(root) : null;
-  } catch (_error) {
-    return null;
-  }
-}
-
-function projectWorkspacePathFor(rootDir) {
-  return path.join(rootDir, PROJECT_WORKSPACE_DIRNAME, PROJECT_WORKSPACE_FILENAME);
-}
-
-function writeProjectWorkspace(rootDir, workspace) {
-  const filePath = projectWorkspacePathFor(rootDir);
-  ensureDir(path.dirname(filePath));
-  writeFile(filePath, `${JSON.stringify({ ...workspace, boundAt: new Date().toISOString() }, null, 2)}\n`);
-  return filePath;
-}
-
-function clearProjectWorkspace(rootDir) {
-  const filePath = projectWorkspacePathFor(rootDir);
-  if (fs.existsSync(filePath)) {
-    fs.unlinkSync(filePath);
-    return filePath;
-  }
-  return null;
-}
-
-/**
- * The single answer to "which workspace does this CLI invocation act on", before asking the
- * server. Every memory command and `workspace current` read this, so reads and writes can never
- * disagree again. Returns { workspaceId, label, key, source, path } or null when nothing local
- * is set (the caller then falls back to the server's per-client selection).
- */
-function resolveLocalWorkspaceSelection({ cwd = process.cwd(), env = process.env } = {}) {
-  const fromEnv = String(env[WORKSPACE_ENV_VAR] || '').trim();
-  if (fromEnv) {
-    return { workspaceId: fromEnv, label: null, key: null, source: 'env', path: WORKSPACE_ENV_VAR };
-  }
-  const project = findProjectWorkspaceFile(cwd);
-  if (project) {
-    const { workspaceId, label = null, key = null } = project.value;
-    return { workspaceId: workspaceId.trim(), label, key, source: 'project', path: project.path };
-  }
-  const global = readSelectedWorkspace();
-  if (global) {
-    return { workspaceId: global.workspaceId, label: global.label || null, key: global.key || null, source: 'global', path: SELECTED_WORKSPACE_PATH };
-  }
-  return null;
-}
-
-async function withSelectedWorkspaceContext(fn) {
-  const local = resolveLocalWorkspaceSelection();
-  if (local?.workspaceId) {
-    const previousWorkspaceId = globalThis.__empiricalCliWorkspaceId || null;
-    globalThis.__empiricalCliWorkspaceId = local.workspaceId;
-    try {
-      return await fn();
-    } finally {
-      globalThis.__empiricalCliWorkspaceId = previousWorkspaceId;
-    }
-  }
-
-  const accessToken = resolveAccessToken();
-  const clientId = getEnv('EMPIRICAL_CLIENT_ID') || readStoredOAuthClient()?.clientId;
-  if (!accessToken || !clientId) return fn();
-
-  const previousWorkspaceId = globalThis.__empiricalCliWorkspaceId || null;
-  globalThis.__empiricalCliWorkspaceId = null;
-  try {
-    const baseUrl = resolveApiBaseUrl();
-    const currentUrl = new URL(
-      `/oauth/clients/${encodeURIComponent(clientId)}/workspace-selection`,
-      baseUrl
-    ).toString();
-    try {
-      const payload = await httpJson(
-        currentUrl,
-        'GET',
-        null,
-        buildApiAuthHeaders(accessToken),
-        WORKSPACE_CONTEXT_TIMEOUT_MS
-      );
-      globalThis.__empiricalCliWorkspaceId = payload?.current?.workspaceId || null;
-    } catch (_error) {
-      globalThis.__empiricalCliWorkspaceId = null;
-    }
-    return await fn();
-  } finally {
-    globalThis.__empiricalCliWorkspaceId = previousWorkspaceId;
-  }
-}
-
-module.exports = {
-  withSelectedWorkspaceContext,
-  resolveLocalWorkspaceSelection,
-  readSelectedWorkspace,
-  writeSelectedWorkspace,
-  clearSelectedWorkspace,
-  findProjectWorkspaceFile,
-  findGitRoot,
-  projectWorkspacePathFor,
-  writeProjectWorkspace,
-  clearProjectWorkspace,
-  WORKSPACE_ENV_VAR,
-  SELECTED_WORKSPACE_PATH
-};
+'use strict';
+
+const os = require('os');
+const path = require('path');
+const fs = require('fs');
+const { execFileSync } = require('child_process');
+const { httpJson } = require('./http');
+const { getEnv } = require('./env');
+const { resolveAccessToken, resolveApiBaseUrl, buildApiAuthHeaders } = require('./auth');
+const { readStoredOAuthClient } = require('./oauthClient');
+const { readJsonIfExists, writeFile, ensureDir } = require('./fsUtils');
+
+const WORKSPACE_CONTEXT_TIMEOUT_MS = 2000;
+const SELECTED_WORKSPACE_PATH = path.join(os.homedir(), '.empirical', 'workspace-selection.json');
+
+// Per-project binding (2026-09-24). The global selection above is one file per machine, so any
+// session in any repo flips it for every other session: a WOB session left the CLI on the WOB team
+// workspace and every tag-scoped recall from an empirical_v2 session returned [] while the memories
+// existed. The unit that actually varies is the project directory, like git config, so a project
+// can pin its workspace in <repo>/.empirical/workspace.json and `use` writes there by default when
+// run inside a git repo. Resolution order, first hit wins: env, project, global, then the server's
+// per-client selection exactly as before. No project file and no env means today's behavior.
+const PROJECT_WORKSPACE_DIRNAME = '.empirical';
+const PROJECT_WORKSPACE_FILENAME = 'workspace.json';
+const WORKSPACE_ENV_VAR = 'EMPIRICAL_WORKSPACE_ID';
+
+function readSelectedWorkspace() {
+  const value = readJsonIfExists(SELECTED_WORKSPACE_PATH);
+  return value && typeof value.workspaceId === 'string' ? value : null;
+}
+
+function writeSelectedWorkspace(workspace) {
+  ensureDir(path.dirname(SELECTED_WORKSPACE_PATH));
+  writeFile(SELECTED_WORKSPACE_PATH, `${JSON.stringify(workspace, null, 2)}\n`);
+}
+
+function clearSelectedWorkspace() {
+  if (fs.existsSync(SELECTED_WORKSPACE_PATH)) fs.unlinkSync(SELECTED_WORKSPACE_PATH);
+}
+
+/**
+ * Nearest <dir>/.empirical/workspace.json walking up from `startDir` to the filesystem root.
+ * Returns { path, value } or null. A malformed file is ignored rather than fatal: a broken
+ * binding must not take the CLI down, it just falls through to the next source.
+ */
+function findProjectWorkspaceFile(startDir = process.cwd()) {
+  let dir = path.resolve(startDir);
+  for (;;) {
+    const candidate = path.join(dir, PROJECT_WORKSPACE_DIRNAME, PROJECT_WORKSPACE_FILENAME);
+    const value = readJsonIfExists(candidate);
+    if (value && typeof value.workspaceId === 'string' && value.workspaceId.trim()) {
+      return { path: candidate, value };
+    }
+    const parent = path.dirname(dir);
+    if (parent === dir) return null;
+    dir = parent;
+  }
+}
+
+/**
+ * The git toplevel for `cwd`, or null outside a repo (or without git). Used to decide where
+ * `workspace use` writes by default and where the project binding lives.
+ */
+function findGitRoot(cwd = process.cwd()) {
+  try {
+    const out = execFileSync('git', ['rev-parse', '--show-toplevel'], {
+      cwd,
+      stdio: ['ignore', 'pipe', 'ignore'],
+      encoding: 'utf8'
+    });
+    const root = String(out || '').trim();
+    return root ? path.resolve(root) : null;
+  } catch (_error) {
+    return null;
+  }
+}
+
+function projectWorkspacePathFor(rootDir) {
+  return path.join(rootDir, PROJECT_WORKSPACE_DIRNAME, PROJECT_WORKSPACE_FILENAME);
+}
+
+function writeProjectWorkspace(rootDir, workspace) {
+  const filePath = projectWorkspacePathFor(rootDir);
+  ensureDir(path.dirname(filePath));
+  writeFile(filePath, `${JSON.stringify({ ...workspace, boundAt: new Date().toISOString() }, null, 2)}\n`);
+  return filePath;
+}
+
+function clearProjectWorkspace(rootDir) {
+  const filePath = projectWorkspacePathFor(rootDir);
+  if (fs.existsSync(filePath)) {
+    fs.unlinkSync(filePath);
+    return filePath;
+  }
+  return null;
+}
+
+/**
+ * The single answer to "which workspace does this CLI invocation act on", before asking the
+ * server. Every memory command and `workspace current` read this, so reads and writes can never
+ * disagree again. Returns { workspaceId, label, key, source, path } or null when nothing local
+ * is set (the caller then falls back to the server's per-client selection).
+ */
+function resolveLocalWorkspaceSelection({ cwd = process.cwd(), env = process.env } = {}) {
+  const fromEnv = String(env[WORKSPACE_ENV_VAR] || '').trim();
+  if (fromEnv) {
+    return { workspaceId: fromEnv, label: null, key: null, source: 'env', path: WORKSPACE_ENV_VAR };
+  }
+  const project = findProjectWorkspaceFile(cwd);
+  if (project) {
+    const { workspaceId, label = null, key = null } = project.value;
+    return { workspaceId: workspaceId.trim(), label, key, source: 'project', path: project.path };
+  }
+  const global = readSelectedWorkspace();
+  if (global) {
+    return { workspaceId: global.workspaceId, label: global.label || null, key: global.key || null, source: 'global', path: SELECTED_WORKSPACE_PATH };
+  }
+  return null;
+}
+
+async function withSelectedWorkspaceContext(fn) {
+  const local = resolveLocalWorkspaceSelection();
+  if (local?.workspaceId) {
+    const previousWorkspaceId = globalThis.__empiricalCliWorkspaceId || null;
+    globalThis.__empiricalCliWorkspaceId = local.workspaceId;
+    try {
+      return await fn();
+    } finally {
+      globalThis.__empiricalCliWorkspaceId = previousWorkspaceId;
+    }
+  }
+
+  const accessToken = resolveAccessToken();
+  const clientId = getEnv('EMPIRICAL_CLIENT_ID') || readStoredOAuthClient()?.clientId;
+  if (!accessToken || !clientId) return fn();
+
+  const previousWorkspaceId = globalThis.__empiricalCliWorkspaceId || null;
+  globalThis.__empiricalCliWorkspaceId = null;
+  try {
+    const baseUrl = resolveApiBaseUrl();
+    const currentUrl = new URL(
+      `/oauth/clients/${encodeURIComponent(clientId)}/workspace-selection`,
+      baseUrl
+    ).toString();
+    try {
+      const payload = await httpJson(
+        currentUrl,
+        'GET',
+        null,
+        buildApiAuthHeaders(accessToken),
+        WORKSPACE_CONTEXT_TIMEOUT_MS
+      );
+      globalThis.__empiricalCliWorkspaceId = payload?.current?.workspaceId || null;
+    } catch (_error) {
+      globalThis.__empiricalCliWorkspaceId = null;
+    }
+    return await fn();
+  } finally {
+    globalThis.__empiricalCliWorkspaceId = previousWorkspaceId;
+  }
+}
+
+module.exports = {
+  withSelectedWorkspaceContext,
+  resolveLocalWorkspaceSelection,
+  readSelectedWorkspace,
+  writeSelectedWorkspace,
+  clearSelectedWorkspace,
+  findProjectWorkspaceFile,
+  findGitRoot,
+  projectWorkspacePathFor,
+  writeProjectWorkspace,
+  clearProjectWorkspace,
+  WORKSPACE_ENV_VAR,
+  SELECTED_WORKSPACE_PATH
+};

package/package.json

@@ -1,33 +1,33 @@
-{
-  "name": "@empirical-gauzza/cli",
-  "version": "1.0.37",
-  "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.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"
+  }
+}