@empirical-gauzza/cli 1.0.23 → 1.0.24

package/README.md

@@ -1,63 +1,63 @@
-# @empirical-gauzza/cli
-
-Command-line installer and local MCP wiring helper for [Empirical](https://empirical.gauzza.com) — portable memory infrastructure for AI agents, assistants, and coding tools.
-
-Full documentation: **[empirical.gauzza.com/docs/cli-details](https://empirical.gauzza.com/docs/cli-details)**
-
-## Install
-
-```bash
-npm install -g @empirical-gauzza/cli
-```
-
-## Quick start
-
-```bash
-empirical install       # interactive setup for Claude Code, Codex, or Copilot CLI
-empirical auth login    # browser-based OAuth login
-empirical doctor        # verify token, API connectivity, and workspace status
-```
-
-Full walkthrough: [empirical.gauzza.com/docs/install](https://empirical.gauzza.com/docs/install)
-
-## What it does
-
-- Installs and configures the Empirical MCP plugin for supported coding agents (Claude Code, Codex CLI, Copilot CLI)
-- Manages OAuth login, including headless/CI bootstrap and Docker token flows
-- Reads, writes, and maintains memories from the command line
-- Manages Skills Kits — create, sync, and push authored Skills across machines
-- Manages workspaces, invites, and registered devices
-- Exposes agent-readable docs and a connectivity `doctor` check
-
-## Commands
-
-| Command | Docs |
-| --- | --- |
-| `empirical install` | [/docs/install](https://empirical.gauzza.com/docs/install#connect) |
-| `empirical plugin install / check` | [/docs/cli-plugins](https://empirical.gauzza.com/docs/cli-plugins) |
-| `empirical auth login / logout` | [/docs/cli-auth](https://empirical.gauzza.com/docs/cli-auth) |
-| `empirical oauth bootstrap / refresh` | [/docs/cli-oauth](https://empirical.gauzza.com/docs/cli-oauth) |
-| `empirical policy show / set` | [/docs/cli-policy](https://empirical.gauzza.com/docs/cli-policy) |
-| `empirical memory query / record / update / delete / export ...` | [/docs/cli-memory](https://empirical.gauzza.com/docs/cli-memory) |
-| `empirical workspace list / create / invite ...` | [/docs/cli-workspaces](https://empirical.gauzza.com/docs/cli-workspaces) |
-| `empirical kit create / sync / use ...` | [/docs/cli-kit](https://empirical.gauzza.com/docs/cli-kit) |
-| `empirical skill push / history / rollback` | [/docs/cli-skill](https://empirical.gauzza.com/docs/cli-skill) |
-| `empirical device list / show` | [/docs/cli-devices](https://empirical.gauzza.com/docs/cli-devices) |
-| `empirical doc [topic]` | [/docs/cli-doc-command](https://empirical.gauzza.com/docs/cli-doc-command) |
-| `empirical doctor` | [/docs/cli-doctor](https://empirical.gauzza.com/docs/cli-doctor) |
-
-Run `empirical --help` at any time for the full, current command list, or `empirical doc` for agent-readable topic docs.
-
-## Security model
-
-API keys and OAuth tokens are stored locally and are never printed in full after initial issuance. See [empirical.gauzza.com/docs/security-model](https://empirical.gauzza.com/docs/security-model) for details on credential handling and headless/CI usage.
-
-## Links
-
-- [Documentation](https://empirical.gauzza.com/docs/install)
-- [Homepage](https://empirical.gauzza.com)
-- [Support](https://empirical.gauzza.com/support/)
-
-## License
-
-MIT
+# @empirical-gauzza/cli
+
+Command-line installer and local MCP wiring helper for [Empirical](https://empirical.gauzza.com) — portable memory infrastructure for AI agents, assistants, and coding tools.
+
+Full documentation: **[empirical.gauzza.com/docs/cli-details](https://empirical.gauzza.com/docs/cli-details)**
+
+## Install
+
+```bash
+npm install -g @empirical-gauzza/cli
+```
+
+## Quick start
+
+```bash
+empirical install       # interactive setup for Claude Code, Codex, or Copilot CLI
+empirical auth login    # browser-based OAuth login
+empirical doctor        # verify token, API connectivity, and workspace status
+```
+
+Full walkthrough: [empirical.gauzza.com/docs/install](https://empirical.gauzza.com/docs/install)
+
+## What it does
+
+- Installs and configures the Empirical MCP plugin for supported coding agents (Claude Code, Codex CLI, Copilot CLI)
+- Manages OAuth login, including headless/CI bootstrap and Docker token flows
+- Reads, writes, and maintains memories from the command line
+- Manages Skills Kits — create, sync, and push authored Skills across machines
+- Manages workspaces, invites, and registered devices
+- Exposes agent-readable docs and a connectivity `doctor` check
+
+## Commands
+
+| Command | Docs |
+| --- | --- |
+| `empirical install` | [/docs/install](https://empirical.gauzza.com/docs/install#connect) |
+| `empirical plugin install / check` | [/docs/cli-plugins](https://empirical.gauzza.com/docs/cli-plugins) |
+| `empirical auth login / logout` | [/docs/cli-auth](https://empirical.gauzza.com/docs/cli-auth) |
+| `empirical oauth bootstrap / refresh` | [/docs/cli-oauth](https://empirical.gauzza.com/docs/cli-oauth) |
+| `empirical policy show / set` | [/docs/cli-policy](https://empirical.gauzza.com/docs/cli-policy) |
+| `empirical memory query / record / update / delete / export ...` | [/docs/cli-memory](https://empirical.gauzza.com/docs/cli-memory) |
+| `empirical workspace list / create / invite ...` | [/docs/cli-workspaces](https://empirical.gauzza.com/docs/cli-workspaces) |
+| `empirical kit create / sync / use ...` | [/docs/cli-kit](https://empirical.gauzza.com/docs/cli-kit) |
+| `empirical skill push / history / rollback` | [/docs/cli-skill](https://empirical.gauzza.com/docs/cli-skill) |
+| `empirical device list / show` | [/docs/cli-devices](https://empirical.gauzza.com/docs/cli-devices) |
+| `empirical doc [topic]` | [/docs/cli-doc-command](https://empirical.gauzza.com/docs/cli-doc-command) |
+| `empirical doctor` | [/docs/cli-doctor](https://empirical.gauzza.com/docs/cli-doctor) |
+
+Run `empirical --help` at any time for the full, current command list, or `empirical doc` for agent-readable topic docs.
+
+## Security model
+
+API keys and OAuth tokens are stored locally and are never printed in full after initial issuance. See [empirical.gauzza.com/docs/security-model](https://empirical.gauzza.com/docs/security-model) for details on credential handling and headless/CI usage.
+
+## Links
+
+- [Documentation](https://empirical.gauzza.com/docs/install)
+- [Homepage](https://empirical.gauzza.com)
+- [Support](https://empirical.gauzza.com/support/)
+
+## License
+
+MIT

package/bin/empirical.js

@@ -1,4 +1,4 @@
-#!/usr/bin/env node
+#!/usr/bin/env node
 
 'use strict';
 

package/lib/doc.js

@@ -11,7 +11,7 @@ function runDoc(args) {
     user: 'Get current user identity (MCP: get_user; CLI: doctor --output json)',
     workspace: 'List, view, and switch workspaces',
     doctor: 'Check token, connectivity, and workspace health',
-    agents: 'Supported agents, integration modes, and native plugin setup',
+    agents: 'Supported agents, integration modes, and native plugin setup',
     auth: 'Token types, bootstrap, refresh, resolution order',
     install: 'Install Empirical for Codex / Copilot / Claude Code',
     kit: 'Create, source, activate, and sync Skills Kits',

package/lib/env.js

@@ -1,49 +1,49 @@
-'use strict';
-
-const { ask } = require('./ui');
-
-function getEnv(name, fallback = '') {
-  return String(process.env[name] ?? fallback).trim();
-}
-
-function requireEnv(name) {
-  const value = getEnv(name);
-  if (!value) {
-    throw new Error(`Missing required env var: ${name}`);
-  }
-  return value;
-}
-
-async function resolveRequiredValueFromEnvOrPrompt(envName, promptLabel) {
-  const value = getEnv(envName);
-  if (value) return value;
-
-  if (!process.stdin.isTTY) {
-    throw new Error(`Missing required env var: ${envName}`);
-  }
-
-  const answer = (await ask(`${promptLabel}: `)).trim();
-  if (!answer) {
-    throw new Error(`${promptLabel} is required`);
-  }
-
-  return answer;
-}
-
-function parseFlag(args, flagName) {
-  return args.includes(flagName);
-}
-
-function parseOption(args, optionName, fallback = '') {
-  const index = args.indexOf(optionName);
-  if (index === -1) return fallback;
-  return String(args[index + 1] || '').trim() || fallback;
-}
-
-module.exports = {
-  getEnv,
-  requireEnv,
-  resolveRequiredValueFromEnvOrPrompt,
-  parseFlag,
-  parseOption
-};
+'use strict';
+
+const { ask } = require('./ui');
+
+function getEnv(name, fallback = '') {
+  return String(process.env[name] ?? fallback).trim();
+}
+
+function requireEnv(name) {
+  const value = getEnv(name);
+  if (!value) {
+    throw new Error(`Missing required env var: ${name}`);
+  }
+  return value;
+}
+
+async function resolveRequiredValueFromEnvOrPrompt(envName, promptLabel) {
+  const value = getEnv(envName);
+  if (value) return value;
+
+  if (!process.stdin.isTTY) {
+    throw new Error(`Missing required env var: ${envName}`);
+  }
+
+  const answer = (await ask(`${promptLabel}: `)).trim();
+  if (!answer) {
+    throw new Error(`${promptLabel} is required`);
+  }
+
+  return answer;
+}
+
+function parseFlag(args, flagName) {
+  return args.includes(flagName);
+}
+
+function parseOption(args, optionName, fallback = '') {
+  const index = args.indexOf(optionName);
+  if (index === -1) return fallback;
+  return String(args[index + 1] || '').trim() || fallback;
+}
+
+module.exports = {
+  getEnv,
+  requireEnv,
+  resolveRequiredValueFromEnvOrPrompt,
+  parseFlag,
+  parseOption
+};

package/lib/installers/detect.js

@@ -1,47 +1,47 @@
-'use strict';
-
-const fs = require('fs');
-const os = require('os');
-const path = require('path');
-const { commandExists } = require('../fsUtils');
-const { installCodex } = require('./codex');
-const { installCopilot } = require('./copilot');
-const { installClaude } = require('./claude');
-
-function detectInstallTargets() {
-  const home = os.homedir();
-  const targets = [];
-
-  const codexDetected = commandExists('codex') || fs.existsSync(path.join(home, '.codex'));
-  if (codexDetected) {
-    targets.push({
-      id: 'codex',
-      label: 'Codex CLI',
-      install: installCodex
-    });
-  }
-
-  const copilotDetected = commandExists('copilot') || fs.existsSync(path.join(home, '.copilot'));
-  if (copilotDetected) {
-    targets.push({
-      id: 'copilot',
-      label: 'GitHub Copilot CLI',
-      install: installCopilot
-    });
-  }
-
-  const claudeDetected = commandExists('claude') || fs.existsSync(path.join(home, '.claude'));
-  if (claudeDetected) {
-    targets.push({
-      id: 'claude',
-      label: 'Claude CLI',
-      install: installClaude
-    });
-  }
-
-  return targets;
-}
-
-module.exports = {
-  detectInstallTargets
-};
+'use strict';
+
+const fs = require('fs');
+const os = require('os');
+const path = require('path');
+const { commandExists } = require('../fsUtils');
+const { installCodex } = require('./codex');
+const { installCopilot } = require('./copilot');
+const { installClaude } = require('./claude');
+
+function detectInstallTargets() {
+  const home = os.homedir();
+  const targets = [];
+
+  const codexDetected = commandExists('codex') || fs.existsSync(path.join(home, '.codex'));
+  if (codexDetected) {
+    targets.push({
+      id: 'codex',
+      label: 'Codex CLI',
+      install: installCodex
+    });
+  }
+
+  const copilotDetected = commandExists('copilot') || fs.existsSync(path.join(home, '.copilot'));
+  if (copilotDetected) {
+    targets.push({
+      id: 'copilot',
+      label: 'GitHub Copilot CLI',
+      install: installCopilot
+    });
+  }
+
+  const claudeDetected = commandExists('claude') || fs.existsSync(path.join(home, '.claude'));
+  if (claudeDetected) {
+    targets.push({
+      id: 'claude',
+      label: 'Claude CLI',
+      install: installClaude
+    });
+  }
+
+  return targets;
+}
+
+module.exports = {
+  detectInstallTargets
+};

package/lib/installers/hooks.js

@@ -477,7 +477,7 @@ function main() {
   appendLog('stop hook fired (pid=' + process.pid + ', platform=' + process.platform + ')');
 
   console.log(JSON.stringify({
-    systemMessage: '[Empirical reminder] Before finishing: if this turn included a completed decision, a corrected mistake, or meaningful work worth remembering, record it now via the empirical-memory skill or \`empirical memory record\` - do not wait to be asked.'
+    systemMessage: '[Empirical reminder] Before finishing: if this turn included a completed decision, a corrected mistake, or meaningful work worth remembering, record it now, one memory per finding (a fix, a root cause, a decision, a lesson), via the empirical-memory, empirical-work-history, or empirical-scar-tissue skill or \`empirical memory record\`. Local notes are not recorded. Do not wait to be asked.'
   }));
   process.exit(0);
 }
@@ -545,7 +545,7 @@ function main() {
 
   console.log(JSON.stringify({
     decision: 'block',
-    reason: '[Empirical reminder] Before finishing: if this turn included a completed decision, a corrected mistake, or meaningful work worth remembering, record it now via the empirical-memory skill or \`empirical memory record\` - do not wait to be asked.'
+    reason: '[Empirical reminder] Before finishing: if this turn included a completed decision, a corrected mistake, or meaningful work worth remembering, record it now, one memory per finding (a fix, a root cause, a decision, a lesson), via the empirical-memory, empirical-work-history, or empirical-scar-tissue skill or \`empirical memory record\`. Local notes are not recorded. Do not wait to be asked.'
   }));
   process.exit(0);
 }
@@ -618,7 +618,7 @@ function main() {
   process.stdout.write(JSON.stringify({
     hookSpecificOutput: {
       hookEventName: 'Stop',
-      additionalContext: '[Empirical] Record memory-worthy work now via empirical-memory skill.'
+      additionalContext: '[Empirical] Record memory-worthy work now: one memory per finding (a fix, a root cause, a decision, a lesson) via the empirical-memory, empirical-work-history, or empirical-scar-tissue skill. Local notes are not recorded.'
     }
   }) + '\\n');
   process.exit(0);