@empirical-gauzza/cli 1.0.24 → 1.0.26

package/lib/installers/skill-variants/SKILL.both.md

@@ -95,6 +95,7 @@ that only records memory when explicitly told to defeats the purpose of this ski
 Two rules that are not optional:
 
 - Record one memory per finding. A session that fixed three things records three memories, each with the fix phrase and the date in its summary. One combined summary is not recorded: it cannot be found by any question about one of its parts.
+- Tags are topics and project names, at most 6 per memory. Reuse tags that recall already returned for this project before inventing one. Never put workflow state (complete, pending, fixed, verified, in-progress), task or step numbers (task-5, us-3.2), or sentences into tags, whether via `empirical memory record --tags` or `record_graph_memory`: state belongs in data.status or in the summary, numbers belong in the summary.
 - Empirical first. A note in a local file, a scratchpad, or a host memory directory is not recorded; it is invisible to every other session, tool, and agent. Record in Empirical, then keep a local pointer if you want one.
 
 - Record durable decisions, project conventions, preferences, plans, and meaningful reflections

package/lib/installers/skill-variants/SKILL.cli.md

@@ -85,6 +85,7 @@ that only records memory when explicitly told to defeats the purpose of this ski
 Two rules that are not optional:
 
 - Record one memory per finding. A session that fixed three things records three memories, each with the fix phrase and the date in its summary. One combined summary is not recorded: it cannot be found by any question about one of its parts.
+- Tags are topics and project names, at most 6 per memory. Reuse tags that recall already returned for this project before inventing one. Never put workflow state (complete, pending, fixed, verified, in-progress), task or step numbers (task-5, us-3.2), or sentences into tags passed via `empirical memory record --tags`: state belongs in data.status or in the summary, numbers belong in the summary.
 - Empirical first. A note in a local file, a scratchpad, or a host memory directory is not recorded; it is invisible to every other session, tool, and agent. Record in Empirical, then keep a local pointer if you want one.
 
 - Record durable decisions, project conventions, preferences, plans, and meaningful reflections

package/lib/installers/skill-variants/SKILL.mcp.md

@@ -75,6 +75,7 @@ that only records memory when explicitly told to defeats the purpose of this ski
 Two rules that are not optional:
 
 - Record one memory per finding. A session that fixed three things records three memories, each with the fix phrase and the date in its summary. One combined summary is not recorded: it cannot be found by any question about one of its parts.
+- Tags are topics and project names, at most 6 per memory. Reuse tags that recall already returned for this project before inventing one. Never put workflow state (complete, pending, fixed, verified, in-progress), task or step numbers (task-5, us-3.2), or sentences into tags passed via `record_graph_memory`: state belongs in data.status or in the summary, numbers belong in the summary.
 - Empirical first. A note in a local file, a scratchpad, or a host memory directory is not recorded; it is invisible to every other session, tool, and agent. Record in Empirical, then keep a local pointer if you want one.
 
 - Record durable decisions, project conventions, preferences, plans, and meaningful reflections

package/lib/memoryCommands.js

@@ -44,7 +44,7 @@ function renderMemoryResultsTable(items) {
 // the 90-line global help wall bin/empirical.js otherwise short-circuits every --help to.
 
 const MEMORY_SUBCOMMAND_USAGE = {
-  query: 'Usage: empirical memory query --match <query> [--top-k 3] [--category <cat>] [--tags <t1,t2>] [--pretty] [--format table]',
+  query: 'Usage: empirical memory query --match <query> [--top-k 3] [--category <cat>] [--tags <t1,t2>] [--tags-all <t1,t2>] [--status <s1,s2>] [--pretty] [--format table]',
   get: 'Usage: empirical memory get --memory-id <id> [--pretty]',
   list: 'Usage: empirical memory list [--category <cat>] [--tags <t1,t2>] [--start-date <ISO>] [--end-date <ISO>] [--limit 20] [--cursor <cursor>] [--oldest] [--pretty] [--format table]',
   record: 'Usage: empirical memory record --category <cat> (--summary <text> | --summary - | --summary-file <path>) [--tags t1,t2] [--node-type observation] [--json-file <path>] [--no-dedupe] [--no-auto-link]',
@@ -179,7 +179,7 @@ function printMemoryResolveError(result) {
 async function runMemoryQuery(args) {
   const match = parseOption(args, '--match', '');
   if (!match) {
-    warn('Usage: empirical memory query --match <query> [--top-k 3] [--category <cat>] [--tags <t1,t2>] [--pretty]');
+    warn('Usage: empirical memory query --match <query> [--top-k 3] [--category <cat>] [--tags <t1,t2>] [--tags-all <t1,t2>] [--status <s1,s2>] [--pretty]');
     process.exit(1);
   }
 
@@ -188,6 +188,12 @@ async function runMemoryQuery(args) {
   const category = parseOption(args, '--category', '');
   const tagsRaw = parseOption(args, '--tags', '');
   const tags = tagsRaw ? tagsRaw.split(',').map((t) => t.trim()).filter(Boolean) : [];
+  // R3 (2026-09-06): --tags-all is an AND match (all must be present), unlike --tags' OR match;
+  // --status filters data.status. Both are optional and additive to --tags/--category.
+  const tagsAllRaw = parseOption(args, '--tags-all', '');
+  const tagsAll = tagsAllRaw ? tagsAllRaw.split(',').map((t) => t.trim()).filter(Boolean) : [];
+  const statusRaw = parseOption(args, '--status', '');
+  const status = statusRaw ? statusRaw.split(',').map((s) => s.trim()).filter(Boolean) : [];
   const pretty = parseFlag(args, '--pretty');
   const format = parseOption(args, '--format', 'json');
 
@@ -199,6 +205,8 @@ async function runMemoryQuery(args) {
   const filters = {};
   if (category) filters.category = category;
   if (tags.length) filters.tags = tags;
+  if (tagsAll.length) filters.tagsAll = tagsAll;
+  if (status.length) filters.status = status;
   if (Object.keys(filters).length) body.filters = filters;
 
   let response;

package/package.json

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