@teammates/recall 0.1.0 → 0.1.1

package/README.md

@@ -93,6 +93,16 @@ teammates-recall status --dir ./.teammates
 4. **Stores** the index at `.teammates/.index/<teammate>/` (gitignored)
 5. **Searches** using Vectra's semantic similarity matching
 
+## Auto-Sync
+
+Every `search` call automatically detects new or changed memory files and indexes them before returning results. This is on by default — no manual `sync` or `index` step is needed.
+
+**How it works:** The indexer compares file modification times against stored metadata. Only files that are new or changed since the last sync get re-indexed, so the overhead is minimal for most queries.
+
+**Skip it when you need speed:** Pass `--no-sync` (CLI) or `skipSync: true` (library) to skip the check entirely. Useful for hot loops or large indexes where you control sync timing separately.
+
+**Why this matters for agents:** Agents write memory files as plain markdown — they shouldn't need to know about index state or remember to run a sync command. Auto-sync closes the gap between "file written" and "file searchable" so agents can write-then-search in a single workflow without extra steps.
+
 ## Use From Any Agent
 
 Any AI coding tool that can run shell commands can use recall:
@@ -134,6 +144,8 @@ const results = await search("database migration", {
   teammatesDir: "./.teammates",
   teammate: "atlas",
   maxResults: 5,
+  maxChunks: 3,    // max chunks per document (default: 3)
+  maxTokens: 500,  // max tokens per section (default: 500)
 });
 
 // Search without auto-sync

package/dist/cli.js

@@ -3,24 +3,24 @@ import * as path from "node:path";
 import * as fs from "node:fs/promises";
 import { Indexer } from "./indexer.js";
 import { search } from "./search.js";
-const HELP = `
-teammates-recall — Semantic memory search for teammates
-
-Usage:
-  teammates-recall index   [options]              Full rebuild of all indexes
-  teammates-recall sync    [options]              Sync new/changed files into indexes
-  teammates-recall add     <file> [options]       Add a single file to a teammate's index
-  teammates-recall search  <query> [options]      Search teammate memories (auto-syncs)
-  teammates-recall status  [options]              Show index status
-
-Options:
-  --dir <path>         Path to .teammates directory (default: ./.teammates)
-  --teammate <name>    Limit to a specific teammate
-  --results <n>        Max results (default: 5)
-  --model <name>       Embedding model (default: Xenova/all-MiniLM-L6-v2)
-  --no-sync            Skip auto-sync before search
-  --json               Output as JSON
-  --help               Show this help
+const HELP = `
+teammates-recall — Semantic memory search for teammates
+
+Usage:
+  teammates-recall index   [options]              Full rebuild of all indexes
+  teammates-recall sync    [options]              Sync new/changed files into indexes
+  teammates-recall add     <file> [options]       Add a single file to a teammate's index
+  teammates-recall search  <query> [options]      Search teammate memories (auto-syncs)
+  teammates-recall status  [options]              Show index status
+
+Options:
+  --dir <path>         Path to .teammates directory (default: ./.teammates)
+  --teammate <name>    Limit to a specific teammate
+  --results <n>        Max results (default: 5)
+  --model <name>       Embedding model (default: Xenova/all-MiniLM-L6-v2)
+  --no-sync            Skip auto-sync before search
+  --json               Output as JSON
+  --help               Show this help
 `.trim();
 function parseArgs(argv) {
     const args = {
@@ -199,7 +199,7 @@ async function cmdStatus(args) {
     const status = {};
     for (const teammate of teammates) {
         const { files } = await indexer.collectFiles(teammate);
-        const indexPath = path.join(indexer.indexRoot, teammate);
+        const indexPath = indexer.indexPath(teammate);
         let indexed = false;
         try {
             await fs.access(indexPath);

package/dist/embeddings.js

@@ -13,7 +13,10 @@ export class LocalEmbeddings {
     async createEmbeddings(inputs) {
         try {
             const extractor = await this._getExtractor();
-            const texts = Array.isArray(inputs) ? inputs : [inputs];
+            const texts = (Array.isArray(inputs) ? inputs : [inputs]).filter((t) => t.trim().length > 0);
+            if (texts.length === 0) {
+                return { status: "success", output: [] };
+            }
             const output = await extractor(texts, {
                 pooling: "mean",
                 normalize: true,

package/dist/indexer.d.ts

@@ -13,13 +13,14 @@ interface TeammateFiles {
 }
 /**
  * Indexes teammate memory files (MEMORIES.md + memory/*.md) into Vectra.
- * One index per teammate, stored at .teammates/.index/<name>/
+ * One index per teammate, stored at .teammates/<name>/.index/
  */
 export declare class Indexer {
     private _config;
     private _embeddings;
     constructor(config: IndexerConfig);
-    get indexRoot(): string;
+    /** Get the index path for a specific teammate */
+    indexPath(teammate: string): string;
     /**
      * Discover all teammate directories (folders containing SOUL.md).
      */

package/dist/indexer.js

@@ -4,7 +4,7 @@ import * as fs from "node:fs/promises";
 import * as path from "node:path";
 /**
  * Indexes teammate memory files (MEMORIES.md + memory/*.md) into Vectra.
- * One index per teammate, stored at .teammates/.index/<name>/
+ * One index per teammate, stored at .teammates/<name>/.index/
  */
 export class Indexer {
     _config;
@@ -13,8 +13,9 @@ export class Indexer {
         this._config = config;
         this._embeddings = new LocalEmbeddings(config.model);
     }
-    get indexRoot() {
-        return path.join(this._config.teammatesDir, ".index");
+    /** Get the index path for a specific teammate */
+    indexPath(teammate) {
+        return path.join(this._config.teammatesDir, teammate, ".index");
     }
     /**
      * Discover all teammate directories (folders containing SOUL.md).
@@ -78,7 +79,7 @@ export class Indexer {
         const { files } = await this.collectFiles(teammate);
         if (files.length === 0)
             return 0;
-        const indexPath = path.join(this.indexRoot, teammate);
+        const indexPath = this.indexPath(teammate);
         const index = new LocalDocumentIndex({
             folderPath: indexPath,
             embeddings: this._embeddings,
@@ -119,7 +120,7 @@ export class Indexer {
         const text = await fs.readFile(absolutePath, "utf-8");
         if (text.trim().length === 0)
             return;
-        const indexPath = path.join(this.indexRoot, teammate);
+        const indexPath = this.indexPath(teammate);
         const index = new LocalDocumentIndex({
             folderPath: indexPath,
             embeddings: this._embeddings,
@@ -137,7 +138,7 @@ export class Indexer {
         const { files } = await this.collectFiles(teammate);
         if (files.length === 0)
             return 0;
-        const indexPath = path.join(this.indexRoot, teammate);
+        const indexPath = this.indexPath(teammate);
         const index = new LocalDocumentIndex({
             folderPath: indexPath,
             embeddings: this._embeddings,

package/dist/search.js

@@ -1,20 +1,18 @@
 import { LocalDocumentIndex } from "vectra";
 import { LocalEmbeddings } from "./embeddings.js";
 import { Indexer } from "./indexer.js";
-import * as path from "node:path";
 import * as fs from "node:fs/promises";
 /**
  * Search teammate memories using semantic + keyword search.
  */
 export async function search(query, options) {
-    const indexRoot = path.join(options.teammatesDir, ".index");
     const embeddings = new LocalEmbeddings(options.model);
+    const indexer = new Indexer({ teammatesDir: options.teammatesDir, model: options.model });
     const maxResults = options.maxResults ?? 5;
     const maxChunks = options.maxChunks ?? 3;
     const maxTokens = options.maxTokens ?? 500;
     // Auto-sync: upsert any new/changed files before searching
     if (!options.skipSync) {
-        const indexer = new Indexer({ teammatesDir: options.teammatesDir, model: options.model });
         if (options.teammate) {
             await indexer.syncTeammate(options.teammate);
         }
@@ -28,19 +26,11 @@ export async function search(query, options) {
         teammates = [options.teammate];
     }
     else {
-        try {
-            const entries = await fs.readdir(indexRoot, { withFileTypes: true });
-            teammates = entries
-                .filter((e) => e.isDirectory())
-                .map((e) => e.name);
-        }
-        catch {
-            return [];
-        }
+        teammates = await indexer.discoverTeammates();
     }
     const allResults = [];
     for (const teammate of teammates) {
-        const indexPath = path.join(indexRoot, teammate);
+        const indexPath = indexer.indexPath(teammate);
         try {
             await fs.access(indexPath);
         }

package/package.json

@@ -1,34 +1,34 @@
-{
-  "name": "@teammates/recall",
-  "version": "0.1.0",
-  "description": "Local semantic memory search for teammates. Indexes MEMORIES.md and daily logs using Vectra + transformers.js.",
-  "type": "module",
-  "main": "dist/index.js",
-  "types": "dist/index.d.ts",
-  "bin": {
-    "teammates-recall": "dist/cli.js"
-  },
-  "scripts": {
-    "build": "tsc",
-    "dev": "tsc --watch"
-  },
-  "keywords": [
-    "teammates",
-    "ai",
-    "memory",
-    "vector-search",
-    "embeddings"
-  ],
-  "license": "MIT",
-  "dependencies": {
-    "@huggingface/transformers": "^3.0.0",
-    "vectra": "^0.9.0"
-  },
-  "devDependencies": {
-    "@types/node": "^20.0.0",
-    "typescript": "^5.5.0"
-  },
-  "engines": {
-    "node": ">=20.0.0"
-  }
-}
+{
+  "name": "@teammates/recall",
+  "version": "0.1.1",
+  "description": "Local semantic memory search for teammates. Indexes MEMORIES.md and daily logs using Vectra + transformers.js.",
+  "type": "module",
+  "main": "dist/index.js",
+  "types": "dist/index.d.ts",
+  "bin": {
+    "teammates-recall": "dist/cli.js"
+  },
+  "scripts": {
+    "build": "tsc",
+    "dev": "tsc --watch"
+  },
+  "keywords": [
+    "teammates",
+    "ai",
+    "memory",
+    "vector-search",
+    "embeddings"
+  ],
+  "license": "MIT",
+  "dependencies": {
+    "@huggingface/transformers": "^3.0.0",
+    "vectra": "^0.9.0"
+  },
+  "devDependencies": {
+    "@types/node": "^20.0.0",
+    "typescript": "^5.5.0"
+  },
+  "engines": {
+    "node": ">=20.0.0"
+  }
+}