@memstack/cli 0.6.4 → 0.7.0

package/README.md

@@ -1,6 +1,6 @@
 # @memstack/cli
 
-CLI for MemStack — shell-based agent memory. Use from bash scripts, Claude Code shell tool, CI pipelines, or any subprocess-capable agent.
+CLI for MemStack — shell-based agent memory. Use from bash scripts, opencode/Claude Code shell tools, CI pipelines, or any subprocess-capable agent.
 
 ## Installation
 
@@ -106,6 +106,18 @@ memstack import --actor "agent-1" --file ./backup.json
 # {"imported":1500}
 ```
 
+Each memory's original `createdAt` is preserved on import (round-trips exactly with `export`). Importing a snapshot with zero memories fails cleanly with a non-zero exit.
+
+## Input validation
+
+The CLI normalizes and validates input before storing:
+
+- **`--importance`** is clamped to the `0.0–1.0` range (e.g. `--importance 5` stores as `1`, `--importance=-1` stores as `0`).
+- **`--actor`** is trimmed of leading/trailing whitespace (`--actor "  a  "` and `--actor a` are the same actor).
+- **`--tags`** drops empty entries from trailing/double commas (`--tags "a,,b,"` → `["a","b"]`).
+- **`prune --type`** rejects unknown strategies with a non-zero exit instead of silently doing nothing. Valid: `byAge`, `byImportance`, `byCount`, `byType`, `custom`, `compose`.
+- **`prune --actor`** is scoped to that actor only — it never touches other actors' memories.
+
 ## Shell agent usage
 
 ```bash

package/dist/cli.d.ts

@@ -0,0 +1 @@
+#!/usr/bin/env node

package/dist/cli.js

@@ -0,0 +1,224 @@
+#!/usr/bin/env node
+import { parseArgs } from 'util';
+import { readFile, writeFile } from 'fs/promises';
+import { MemStack } from '@memstack/core';
+import { loadConfigFromEnv } from '@memstack/config-env';
+
+async function loadConfig() {
+  const { config } = await loadConfigFromEnv();
+  return config;
+}
+
+// src/cli.ts
+async function main() {
+  const { positionals, values } = parseArgs({
+    allowPositionals: true,
+    options: {
+      actor: { type: "string" },
+      content: { type: "string" },
+      type: { type: "string" },
+      importance: { type: "string" },
+      tags: { type: "string" },
+      query: { type: "string" },
+      strategy: { type: "string" },
+      limit: { type: "string" },
+      "max-tokens": { type: "string" },
+      "older-than": { type: "string" },
+      "max-age": { type: "string" },
+      "min-importance": { type: "string" },
+      "max-count": { type: "string" },
+      ids: { type: "string" },
+      id: { type: "string" },
+      "created-after": { type: "string" },
+      "created-before": { type: "string" },
+      "dry-run": { type: "boolean" },
+      out: { type: "string" },
+      file: { type: "string" }
+    }
+  });
+  const command = positionals[0];
+  if (!command) {
+    printUsage();
+    process.exit(1);
+  }
+  const config = await loadConfig();
+  const ms = new MemStack(config);
+  let result;
+  switch (command) {
+    case "store": {
+      if (!values.actor) fail("--actor is required");
+      if (!values.content) fail("--content is required");
+      const importance = values.importance ? Math.max(0, Math.min(1, Number(values.importance))) : void 0;
+      result = await ms.memory.store({
+        actorId: String(values.actor).trim(),
+        content: String(values.content),
+        memoryType: values.type,
+        importance,
+        tags: values.tags ? String(values.tags).split(",").map((t) => t.trim()).filter((t) => t.length > 0) : void 0
+      });
+      break;
+    }
+    case "retrieve": {
+      if (!values.actor) fail("--actor is required");
+      result = await ms.memory.retrieve({
+        actorId: values.actor,
+        query: values.query,
+        strategy: values.strategy,
+        limit: values.limit ? Number(values.limit) : void 0,
+        tags: values.tags ? String(values.tags).split(",") : void 0,
+        createdAfter: values["created-after"] ? new Date(String(values["created-after"])) : void 0,
+        createdBefore: values["created-before"] ? new Date(String(values["created-before"])) : void 0
+      });
+      break;
+    }
+    case "context": {
+      if (!values.actor) fail("--actor is required");
+      result = await ms.memory.compileContext({
+        actorId: String(values.actor),
+        maxTokens: values["max-tokens"] ? Number(values["max-tokens"]) : void 0
+      });
+      break;
+    }
+    case "summarize": {
+      if (!values.actor) fail("--actor is required");
+      const durationMs = values["older-than"] ? parseDuration(String(values["older-than"])) : void 0;
+      const olderThan = durationMs ? new Date(Date.now() - durationMs) : void 0;
+      result = await ms.memory.summarize({
+        actorId: values.actor,
+        olderThan
+      });
+      break;
+    }
+    case "prune": {
+      if (!values.actor) fail("--actor is required");
+      const VALID_TYPES = ["byAge", "byImportance", "byCount", "byType", "custom", "compose"];
+      const pruneType = values.type ?? "byAge";
+      if (!VALID_TYPES.includes(String(pruneType))) {
+        fail(`Invalid prune type: ${pruneType}. Valid: ${VALID_TYPES.join(", ")}`);
+      }
+      const strategy = {
+        type: pruneType,
+        actorId: String(values.actor).trim(),
+        maxAge: values["max-age"] ? parseDuration(String(values["max-age"])) : void 0,
+        minImportance: values["min-importance"] ? Number(values["min-importance"]) : void 0,
+        maxPerActor: values["max-count"] ? Number(values["max-count"]) : void 0
+      };
+      if (values["dry-run"]) {
+        result = await ms.memory.dryRunPrune(strategy);
+      } else {
+        result = await ms.memory.prune(strategy);
+      }
+      break;
+    }
+    case "purge": {
+      if (!values.actor) fail("--actor is required");
+      result = await ms.memory.purgeActor(String(values.actor));
+      break;
+    }
+    case "merge": {
+      if (!values.ids) fail("--ids is required");
+      result = await ms.memory.merge(
+        String(values.ids).split(",").map((s) => s.trim())
+      );
+      break;
+    }
+    case "stats": {
+      result = await ms.memory.stats(values.actor);
+      break;
+    }
+    case "delete": {
+      if (!values.id) fail("--id is required");
+      await ms.memory.delete(String(values.id));
+      result = { deleted: true };
+      break;
+    }
+    case "health": {
+      result = await ms.health();
+      break;
+    }
+    case "export": {
+      const snapshot = await ms.export(values.actor);
+      const outPath = values.out;
+      if (outPath) {
+        await writeFile(outPath, JSON.stringify(snapshot, null, 2), "utf-8");
+      }
+      result = outPath ? { saved: outPath, count: snapshot.memories.length } : snapshot;
+      break;
+    }
+    case "import": {
+      if (!values.actor) fail("--actor is required");
+      if (!values.file) fail("--file is required");
+      const raw = await readFile(String(values.file), "utf-8");
+      let snapshot = JSON.parse(raw);
+      if (Array.isArray(snapshot)) {
+        snapshot = { version: 1, memories: snapshot, exportedAt: (/* @__PURE__ */ new Date()).toISOString() };
+      }
+      if (!snapshot.memories || !Array.isArray(snapshot.memories) || snapshot.memories.length === 0) {
+        fail("Snapshot contains no memories to import");
+      }
+      await ms.import(snapshot);
+      result = { imported: snapshot.memories.length };
+      break;
+    }
+    default:
+      printUsage();
+      process.exit(1);
+  }
+  process.stdout.write(JSON.stringify(result, null, 2) + "\n");
+  await ms.close();
+}
+function parseDuration(input) {
+  const match = input.match(/^(\d+)([smhd])$/);
+  if (!match) {
+    throw new Error(
+      `Invalid duration: ${input}. Use format like "7d", "24h", "30m".`
+    );
+  }
+  const value = Number(match[1]);
+  switch (match[2]) {
+    case "s":
+      return value * 1e3;
+    case "m":
+      return value * 60 * 1e3;
+    case "h":
+      return value * 3600 * 1e3;
+    case "d":
+      return value * 86400 * 1e3;
+    default:
+      return value;
+  }
+}
+function printUsage() {
+  process.stderr.write(`memstack <command> [flags]
+
+Commands:
+  store       Store a memory
+  retrieve    Retrieve memories
+  context     Compile LLM-ready context
+  summarize   Compress old interactions
+  prune       Remove stale memories
+  purge       Delete all memories for an actor
+  merge       Merge multiple memories
+  stats       Memory diagnostics
+  delete      Delete a single memory
+  health      Check connectivity
+  export      Export all memories
+  import      Import memories from a JSON snapshot
+
+Run memstack <command> --help for flags.
+`);
+}
+function fail(message) {
+  process.stderr.write(`Error: ${message}
+`);
+  process.exit(1);
+}
+main().catch((err) => {
+  process.stderr.write(
+    `Error: ${err instanceof Error ? err.message : String(err)}
+`
+  );
+  process.exit(1);
+});
+//# sourceMappingURL=cli.js.map
+//# sourceMappingURL=cli.js.map

package/dist/cli.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../src/config.ts","../src/cli.ts"],"names":[],"mappings":"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","file":"cli.js","sourcesContent":["import type { MemStackConfig } from \"@memstack/core\";\nimport { loadConfigFromEnv } from \"@memstack/config-env\";\n\nexport async function loadConfig(): Promise<MemStackConfig> {\n  const { config } = await loadConfigFromEnv();\n  return config;\n}\n","#!/usr/bin/env node\nimport { parseArgs } from \"node:util\";\nimport { writeFile, readFile } from \"node:fs/promises\";\nimport { MemStack } from \"@memstack/core\";\nimport type { MemStackConfig, MemoryType, PruneStrategy } from \"@memstack/core\";\nimport { loadConfig } from \"./config.js\";\n\nasync function main() {\n  const { positionals, values } = parseArgs({\n    allowPositionals: true,\n    options: {\n      actor: { type: \"string\" },\n      content: { type: \"string\" },\n      type: { type: \"string\" },\n      importance: { type: \"string\" },\n      tags: { type: \"string\" },\n      query: { type: \"string\" },\n      strategy: { type: \"string\" },\n      limit: { type: \"string\" },\n      \"max-tokens\": { type: \"string\" },\n      \"older-than\": { type: \"string\" },\n      \"max-age\": { type: \"string\" },\n      \"min-importance\": { type: \"string\" },\n      \"max-count\": { type: \"string\" },\n      ids: { type: \"string\" },\n      id: { type: \"string\" },\n      \"created-after\": { type: \"string\" },\n      \"created-before\": { type: \"string\" },\n      \"dry-run\": { type: \"boolean\" },\n      out: { type: \"string\" },\n      file: { type: \"string\" },\n    },\n  });\n\n  const command = positionals[0];\n  if (!command) {\n    printUsage();\n    process.exit(1);\n  }\n\n  const config: MemStackConfig = await loadConfig();\n  const ms = new MemStack(config);\n\n  let result: unknown;\n  switch (command) {\n    case \"store\": {\n      if (!values.actor) fail(\"--actor is required\");\n      if (!values.content) fail(\"--content is required\");\n      const importance = values.importance ? Math.max(0, Math.min(1, Number(values.importance))) : undefined;\n      result = await ms.memory.store({\n        actorId: String(values.actor).trim(),\n        content: String(values.content),\n        memoryType: values.type as MemoryType | undefined,\n        importance,\n        tags: values.tags\n          ? String(values.tags)\n              .split(\",\")\n              .map((t) => t.trim())\n              .filter((t) => t.length > 0)\n          : undefined,\n      });\n      break;\n    }\n\n    case \"retrieve\": {\n      if (!values.actor) fail(\"--actor is required\");\n      result = await ms.memory.retrieve({\n        actorId: values.actor as string | undefined,\n        query: values.query as string | undefined,\n        strategy: values.strategy as \"recent\" | \"important\" | \"semantic\" | \"hybrid\" | undefined,\n        limit: values.limit ? Number(values.limit) : undefined,\n        tags: values.tags ? String(values.tags).split(\",\") : undefined,\n        createdAfter: values[\"created-after\"]\n          ? new Date(String(values[\"created-after\"]))\n          : undefined,\n        createdBefore: values[\"created-before\"]\n          ? new Date(String(values[\"created-before\"]))\n          : undefined,\n      });\n      break;\n    }\n\n    case \"context\": {\n      if (!values.actor) fail(\"--actor is required\");\n      result = await ms.memory.compileContext({\n        actorId: String(values.actor),\n        maxTokens: values[\"max-tokens\"] ? Number(values[\"max-tokens\"]) : undefined,\n      });\n      break;\n    }\n\n    case \"summarize\": {\n      if (!values.actor) fail(\"--actor is required\");\n      const durationMs = values[\"older-than\"]\n        ? parseDuration(String(values[\"older-than\"]))\n        : undefined;\n      const olderThan = durationMs ? new Date(Date.now() - durationMs) : undefined;\n      result = await ms.memory.summarize({\n        actorId: values.actor as string | undefined,\n        olderThan,\n      });\n      break;\n    }\n\n    case \"prune\": {\n      if (!values.actor) fail(\"--actor is required\");\n      const VALID_TYPES = [\"byAge\", \"byImportance\", \"byCount\", \"byType\", \"custom\", \"compose\"];\n      const pruneType = values.type ?? \"byAge\";\n      if (!VALID_TYPES.includes(String(pruneType))) {\n        fail(`Invalid prune type: ${pruneType}. Valid: ${VALID_TYPES.join(\", \")}`);\n      }\n      const strategy: PruneStrategy = {\n        type: pruneType as PruneStrategy[\"type\"],\n        actorId: String(values.actor).trim(),\n        maxAge: values[\"max-age\"]\n          ? parseDuration(String(values[\"max-age\"]))\n          : undefined,\n        minImportance: values[\"min-importance\"]\n          ? Number(values[\"min-importance\"])\n          : undefined,\n        maxPerActor: values[\"max-count\"]\n          ? Number(values[\"max-count\"])\n          : undefined,\n      };\n\n      if (values[\"dry-run\"]) {\n        result = await ms.memory.dryRunPrune(strategy);\n      } else {\n        result = await ms.memory.prune(strategy);\n      }\n      break;\n    }\n\n    case \"purge\": {\n      if (!values.actor) fail(\"--actor is required\");\n      result = await ms.memory.purgeActor(String(values.actor));\n      break;\n    }\n\n    case \"merge\": {\n      if (!values.ids) fail(\"--ids is required\");\n      result = await ms.memory.merge(\n        String(values.ids)\n          .split(\",\")\n          .map((s) => s.trim()),\n      );\n      break;\n    }\n\n    case \"stats\": {\n      result = await ms.memory.stats(values.actor as string | undefined);\n      break;\n    }\n\n    case \"delete\": {\n      if (!values.id) fail(\"--id is required\");\n      await ms.memory.delete(String(values.id));\n      result = { deleted: true };\n      break;\n    }\n\n    case \"health\": {\n      result = await ms.health();\n      break;\n    }\n\n    case \"export\": {\n      const snapshot = await ms.export(values.actor as string | undefined);\n      const outPath = values.out as string | undefined;\n      if (outPath) {\n        await writeFile(outPath, JSON.stringify(snapshot, null, 2), \"utf-8\");\n      }\n      result = outPath ? { saved: outPath, count: snapshot.memories.length } : snapshot;\n      break;\n    }\n\n    case \"import\": {\n      if (!values.actor) fail(\"--actor is required\");\n      if (!values.file) fail(\"--file is required\");\n      const raw = await readFile(String(values.file), \"utf-8\");\n      let snapshot = JSON.parse(raw);\n      if (Array.isArray(snapshot)) {\n        snapshot = { version: 1 as const, memories: snapshot, exportedAt: new Date().toISOString() };\n      }\n      if (!snapshot.memories || !Array.isArray(snapshot.memories) || snapshot.memories.length === 0) {\n        fail(\"Snapshot contains no memories to import\");\n      }\n      await ms.import(snapshot);\n      result = { imported: snapshot.memories.length };\n      break;\n    }\n\n    default:\n      printUsage();\n      process.exit(1);\n  }\n\n  process.stdout.write(JSON.stringify(result, null, 2) + \"\\n\");\n  await ms.close();\n}\n\nfunction parseDuration(input: string): number {\n  const match = input.match(/^(\\d+)([smhd])$/);\n  if (!match) {\n    throw new Error(\n      `Invalid duration: ${input}. Use format like \"7d\", \"24h\", \"30m\".`,\n    );\n  }\n  const value = Number(match[1]);\n  switch (match[2]) {\n    case \"s\":\n      return value * 1000;\n    case \"m\":\n      return value * 60 * 1000;\n    case \"h\":\n      return value * 3600 * 1000;\n    case \"d\":\n      return value * 86400 * 1000;\n    default:\n      return value;\n  }\n}\n\nfunction printUsage() {\n  process.stderr.write(`memstack <command> [flags]\n\nCommands:\n  store       Store a memory\n  retrieve    Retrieve memories\n  context     Compile LLM-ready context\n  summarize   Compress old interactions\n  prune       Remove stale memories\n  purge       Delete all memories for an actor\n  merge       Merge multiple memories\n  stats       Memory diagnostics\n  delete      Delete a single memory\n  health      Check connectivity\n  export      Export all memories\n  import      Import memories from a JSON snapshot\n\nRun memstack <command> --help for flags.\n`);\n}\n\nfunction fail(message: string): never {\n  process.stderr.write(`Error: ${message}\\n`);\n  process.exit(1);\n}\n\nmain().catch((err) => {\n  process.stderr.write(\n    `Error: ${err instanceof Error ? err.message : String(err)}\\n`,\n  );\n  process.exit(1);\n});\n"]}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@memstack/cli",
-  "version": "0.6.4",
+  "version": "0.7.0",
   "description": "CLI for MemStack — shell-based agent memory",
   "type": "module",
   "main": "dist/cli.js",
@@ -29,7 +29,8 @@
   },
   "homepage": "https://github.com/isiomaC/memstack",
   "dependencies": {
-    "@memstack/core": "0.6.4"
+    "@memstack/config-env": "0.7.0",
+    "@memstack/core": "0.7.0"
   },
   "devDependencies": {
     "tsup": "^8.0.0",