@teammates/cli 0.2.7 → 0.3.0

package/dist/compact.d.ts

@@ -37,3 +37,10 @@ export declare function compactWeeklies(teammateDir: string): Promise<{
  * 2. Compact weeklies older than 52 weeks → monthly summaries
  */
 export declare function compactEpisodic(teammateDir: string, teammateName: string): Promise<CompactionResult>;
+/**
+ * Build a prompt that tells a teammate to distill their WISDOM.md
+ * from typed memories, daily logs, and weekly summaries.
+ *
+ * Returns null if there are no typed memories to distill from.
+ */
+export declare function buildWisdomPrompt(teammateDir: string, teammateName: string): Promise<string | null>;

package/dist/compact.js

@@ -267,3 +267,100 @@ export async function compactEpisodic(teammateDir, teammateName) {
         weekliesRemoved: weeklyResult.removed,
     };
 }
+/**
+ * Build a prompt that tells a teammate to distill their WISDOM.md
+ * from typed memories, daily logs, and weekly summaries.
+ *
+ * Returns null if there are no typed memories to distill from.
+ */
+export async function buildWisdomPrompt(teammateDir, teammateName) {
+    const memoryDir = join(teammateDir, "memory");
+    const wisdomPath = join(teammateDir, "WISDOM.md");
+    // Read current WISDOM.md
+    let currentWisdom = "";
+    try {
+        currentWisdom = await readFile(wisdomPath, "utf-8");
+    }
+    catch {
+        // No WISDOM.md yet — that's fine, we'll create one
+    }
+    // Read typed memory files (anything in memory/ that isn't a daily log)
+    const typedMemories = [];
+    try {
+        const entries = await readdir(memoryDir);
+        for (const entry of entries) {
+            if (!entry.endsWith(".md"))
+                continue;
+            // Skip daily logs (YYYY-MM-DD.md)
+            if (/^\d{4}-\d{2}-\d{2}\.md$/.test(entry))
+                continue;
+            // Skip subdirectories (weekly/, monthly/) — readdir only returns files here
+            const content = await readFile(join(memoryDir, entry), "utf-8");
+            typedMemories.push({ file: entry, content });
+        }
+    }
+    catch {
+        // No memory dir
+    }
+    // Read recent daily logs (current week)
+    const recentDailies = [];
+    try {
+        const entries = await readdir(memoryDir);
+        for (const entry of entries) {
+            if (!entry.endsWith(".md"))
+                continue;
+            const stem = basename(entry, ".md");
+            if (!/^\d{4}-\d{2}-\d{2}$/.test(stem))
+                continue;
+            const content = await readFile(join(memoryDir, entry), "utf-8");
+            recentDailies.push({ date: stem, content });
+        }
+        recentDailies.sort((a, b) => b.date.localeCompare(a.date));
+    }
+    catch {
+        // No memory dir
+    }
+    // If there's nothing to distill from, skip
+    if (typedMemories.length === 0 && recentDailies.length === 0) {
+        return null;
+    }
+    const today = new Date().toISOString().slice(0, 10);
+    const parts = [];
+    parts.push("# Wisdom Distillation Task\n");
+    parts.push("Update your WISDOM.md by distilling durable knowledge from your typed memories, recent daily logs, and weekly summaries.\n");
+    parts.push("## Rules\n");
+    parts.push("- WISDOM.md contains **distilled principles and patterns** — not a changelog or task list");
+    parts.push("- Each entry should be a reusable insight: a convention, decision, pattern, gotcha, or codebase fact");
+    parts.push("- Keep entries concise (2-4 lines each) with a bold title");
+    parts.push("- Remove entries that are outdated or no longer accurate");
+    parts.push("- Update entries whose details have changed (e.g., line counts, file counts)");
+    parts.push("- Add new entries for durable knowledge not yet captured");
+    parts.push(`- Set \`Last compacted: ${today}\` at the top`);
+    parts.push("- Do NOT include task-specific details, conversation history, or ephemeral state");
+    parts.push("- Do NOT include anything already in your SOUL.md (ownership, routing, technologies, etc.)\n");
+    if (currentWisdom) {
+        parts.push("## Current WISDOM.md\n");
+        parts.push("```markdown");
+        parts.push(currentWisdom.trim());
+        parts.push("```\n");
+    }
+    if (typedMemories.length > 0) {
+        parts.push("## Typed Memories\n");
+        for (const mem of typedMemories) {
+            parts.push(`### ${mem.file}\n`);
+            parts.push(mem.content.trim());
+            parts.push("");
+        }
+    }
+    if (recentDailies.length > 0) {
+        parts.push("## Recent Daily Logs\n");
+        for (const daily of recentDailies.slice(0, 7)) {
+            parts.push(`### ${daily.date}\n`);
+            parts.push(daily.content.trim());
+            parts.push("");
+        }
+    }
+    parts.push("\n## Instructions\n");
+    parts.push(`Read your current WISDOM.md at \`.teammates/${teammateName}/WISDOM.md\` and rewrite it with updated, distilled entries. Write the file directly — this is the one time you are allowed to edit WISDOM.md.`);
+    return parts.join("\n");
+}

package/dist/index.d.ts

@@ -1,5 +1,5 @@
-export type { AgentAdapter, InstalledService, RosterEntry } from "./adapter.js";
-export { buildTeammatePrompt, formatHandoffContext } from "./adapter.js";
+export type { AgentAdapter, InstalledService, RecallContext, RosterEntry, } from "./adapter.js";
+export { buildTeammatePrompt, formatHandoffContext, queryRecallContext, syncRecallIndex, } from "./adapter.js";
 export { type AgentPreset, CliProxyAdapter, type CliProxyOptions, PRESETS, } from "./adapters/cli-proxy.js";
 export { EchoAdapter } from "./adapters/echo.js";
 export { Orchestrator, type OrchestratorConfig, type TeammateStatus, } from "./orchestrator.js";

package/dist/index.js

@@ -1,5 +1,5 @@
 // Public API for @teammates/cli
-export { buildTeammatePrompt, formatHandoffContext } from "./adapter.js";
+export { buildTeammatePrompt, formatHandoffContext, queryRecallContext, syncRecallIndex, } from "./adapter.js";
 export { CliProxyAdapter, PRESETS, } from "./adapters/cli-proxy.js";
 export { EchoAdapter } from "./adapters/echo.js";
 export { Orchestrator, } from "./orchestrator.js";

package/dist/types.d.ts

@@ -68,6 +68,19 @@ export interface TaskResult {
     handoffs: HandoffEnvelope[];
     /** Raw output from the agent */
     rawOutput?: string;
+    /** Process diagnostics for debugging empty/failed responses */
+    diagnostics?: {
+        /** Process exit code (null if killed by signal) */
+        exitCode: number | null;
+        /** Signal that killed the process (null if exited normally) */
+        signal: string | null;
+        /** stderr output (separate from stdout) */
+        stderr: string;
+        /** Whether the process was killed by timeout */
+        timedOut: boolean;
+        /** Path to the agent's debug log file, if written */
+        debugFile?: string;
+    };
 }
 /** Task assignment to a teammate */
 export interface TaskAssignment {

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@teammates/cli",
-  "version": "0.2.7",
+  "version": "0.3.0",
   "description": "Agent-agnostic CLI for teammates. Routes tasks, manages handoffs, and plugs into any coding agent backend.",
   "type": "module",
   "main": "dist/index.js",
@@ -31,7 +31,8 @@
   "license": "MIT",
   "dependencies": {
     "@github/copilot-sdk": "^0.1.32",
-    "@teammates/consolonia": "0.2.7",
+    "@teammates/consolonia": "0.3.0",
+    "@teammates/recall": "0.3.0",
     "chalk": "^5.6.2",
     "ora": "^9.3.0"
   },

package/template/TEMPLATE.md

@@ -20,7 +20,7 @@ Each session, you wake up fresh. These files _are_ your memory. Read them. Updat
 - Read your SOUL.md and WISDOM.md at the start of every session.
 - Read `memory/YYYY-MM-DD.md` for today and yesterday.
 - Read USER.md to understand who you're working with.
-- Browse `memory/` for typed memory files relevant to the current task (or use recall search if available).
+- Relevant memories from past work are automatically provided in your context via recall search.
 - Update your files as you learn. If you change SOUL.md, tell the user.
 - You may create additional private docs under your folder (e.g., `.teammates/<name>/notes/`, `.teammates/<name>/specs/`). To share a doc with other teammates, add a pointer to it in [CROSS-TEAM.md](../CROSS-TEAM.md).
 

package/template/example/SOUL.md

@@ -11,7 +11,7 @@ Each session, you wake up fresh. These files _are_ your memory. Read them. Updat
 - Read your SOUL.md and WISDOM.md at the start of every session.
 - Read `memory/YYYY-MM-DD.md` for today and yesterday.
 - Read USER.md to understand who you're working with.
-- Browse `memory/` for typed memory files relevant to the current task (or use recall search if available).
+- Relevant memories from past work are automatically provided in your context via recall search.
 - Update your files as you learn. If you change SOUL.md, tell the user.
 
 ## Core Principles