@todoforai/tfa-memory 0.2.1 → 0.4.0

package/dist/cli.js

@@ -462,8 +462,8 @@ function checkForUpdates(pkg) {
 // package.json
 var package_default = {
   name: "@todoforai/tfa-memory",
-  version: "0.2.1",
-  description: "Zero-config TODOforAI memory CLI — add/search/ls/get/rm text memory rows addressed as source/ref, with full-text and semantic search. Reuses bridge credentials.",
+  version: "0.4.0",
+  description: "Zero-config TODOforAI memory CLI — add/search/ls/get/rm text memory rows addressed as source/ref, plus federated search over every message of every past TODO (read-only `todo` source), with full-text and semantic search. Reuses bridge credentials.",
   type: "module",
   bin: {
     "tfa-memory": "dist/cli.js"
@@ -497,7 +497,12 @@ function printHelp() {
 
 Every row's address is \`source/ref\` — sources are directories, refs are
 filenames. A source exists once the first row names it. Re-adding the same
-address updates in place; identical content is skipped (no re-embed).
+address updates in place; identical content+meta is skipped (no re-embed).
+
+\`search\` covers two corpora at once: rows you saved, plus every message of
+every TODO under the read-only \`todo\` source (\`todo/<todoId>:<messageId>\`,
+live from the backend index, nothing separate to sync). \`--source todo\` searches
+past TODOs only; \`get todo/<todoId>:<messageId>\` prints the whole message.
 
 Usage:
   tfa-memory <command> [options] [args...]
@@ -505,8 +510,8 @@ Usage:
 Commands:
   add [source/ref] <text|->     Save a row. Without an address → manual/<timestamp>.
                                 "-" reads stdin.
-  search <query>                Full-text search (newest first)
-  ls                            List rows, newest first
+  search <query>                Full-text search over saved rows + past TODO messages
+  ls                            List saved rows, newest first (todo messages excluded)
   get <source/ref>              Print full content of one row
   rm <source/ref>               Delete one row
   rm --source <name>            Delete every row in a source
@@ -515,9 +520,11 @@ Commands:
   whoami                        Print resolved auth context
 
 Options:
-  -s, --source <a,b>            Restrict search/ls to sources (comma-separated)
+  -s, --source <a,b>            Restrict search/ls to sources (comma-separated; "todo" = TODO messages)
+      --todo <id>               Restrict a todo-message search to one TODO
       --semantic                Embedding KNN search (meaning, not keywords)
-  -n, --limit <n>               Max rows (default 10, max 50)
+      --meta <json>             Attach JSON metadata to the row (e.g. '{"todoId":"..."}')
+  -n, --limit <n>               Max rows (default 5, max 50)
   -j, --json                    Machine-readable output
   --api-token <token>           Override API token
   --api-url <url>               Override backend URL (used to derive memory URL)
@@ -531,6 +538,8 @@ Examples:
   cat docs/auth.md | tfa-memory add acme/docs/auth.md -
   tfa-memory search "rollback procedure"
   tfa-memory search "how do we deploy" --semantic
+  tfa-memory search "android build" --source todo
+  tfa-memory get todo/<todoId>:<messageId>
   tfa-memory ls --source deploy-notes
   tfa-memory get deploy-notes/rollback
   tfa-memory rm deploy-notes/rollback
@@ -604,6 +613,8 @@ async function main() {
     args: process.argv.slice(2),
     options: {
       source: { type: "string", short: "s" },
+      todo: { type: "string" },
+      meta: { type: "string" },
       semantic: { type: "boolean", default: false },
       limit: { type: "string", short: "n" },
       json: { type: "boolean", short: "j", default: false },
@@ -647,8 +658,8 @@ async function main() {
   }
   const json = values.json;
   const limit = values.limit !== undefined ? Number(values.limit) : undefined;
-  if (limit !== undefined && (!Number.isInteger(limit) || limit < 1))
-    die(`--limit must be a positive integer`, 2);
+  if (limit !== undefined && (!Number.isInteger(limit) || limit < 1 || limit > 50))
+    die(`--limit must be an integer from 1 to 50`, 2);
   const sources = values.source;
   switch (cmd) {
     case "add": {
@@ -665,13 +676,25 @@ async function main() {
       text = text.trim();
       if (!text)
         die("empty content");
-      const res = await api(ctx, "POST", "/memory", { source, ref, content: text });
+      let meta;
+      if (values.meta !== undefined) {
+        try {
+          meta = JSON.parse(values.meta);
+        } catch {
+          die(`--meta must be valid JSON`, 2);
+        }
+        if (typeof meta !== "object" || meta === null || Array.isArray(meta))
+          die(`--meta must be a JSON object`, 2);
+      }
+      const res = await api(ctx, "POST", "/memory", { source, ref, content: text, meta });
       console.log(json ? JSON.stringify(res) : `${res.status} ${res.address}`);
       break;
     }
     case "search": {
       const query = rest[0] ?? die(`usage: tfa-memory search "query"`, 2);
-      const res = await api(ctx, "GET", `/memory/search${qs({ query, semantic: values.semantic ? true : undefined, sources, limit })}`);
+      const res = await api(ctx, "GET", `/memory/search${qs({ query, semantic: values.semantic ? true : undefined, sources, limit, todoId: values.todo })}`);
+      for (const w of res.warnings ?? [])
+        console.error(`Warning: ${w}`);
       printRows(res.rows, json, 200);
       break;
     }
@@ -716,8 +739,8 @@ async function main() {
         break;
       }
       const w = Math.max(...res.sources.map((s) => s.source.length));
-      for (const s of res.sources.sort((a, b) => b.lastWrite - a.lastWrite))
-        console.log(`${s.source.padEnd(w)}  ${String(s.count).padStart(4)}  ${new Date(s.lastWrite).toISOString().slice(0, 16)}`);
+      for (const s of res.sources.sort((a, b) => (b.lastWrite ?? Infinity) - (a.lastWrite ?? Infinity)))
+        console.log(`${s.source.padEnd(w)}  ${String(s.count ?? "live").padStart(4)}  ${s.lastWrite ? new Date(s.lastWrite).toISOString().slice(0, 16) : "live"}`);
       break;
     }
     default:

package/package.json

@@ -1,7 +1,7 @@
 {
   "name": "@todoforai/tfa-memory",
-  "version": "0.2.1",
-  "description": "Zero-config TODOforAI memory CLI \u2014 add/search/ls/get/rm text memory rows addressed as source/ref, with full-text and semantic search. Reuses bridge credentials.",
+  "version": "0.4.0",
+  "description": "Zero-config TODOforAI memory CLI — add/search/ls/get/rm text memory rows addressed as source/ref, plus federated search over every message of every past TODO (read-only `todo` source), with full-text and semantic search. Reuses bridge credentials.",
   "type": "module",
   "bin": {
     "tfa-memory": "dist/cli.js"