@teammates/cli 0.5.0 → 0.5.1

package/dist/adapter.d.ts

@@ -75,6 +75,14 @@ export declare function queryRecallContext(teammatesDir: string, teammateName: s
  * Wrapper around the recall library's Indexer.
  */
 export declare function syncRecallIndex(teammatesDir: string, teammate?: string): Promise<void>;
+/**
+ * Context budget allocation:
+ * - Days 2-7 get up to DAILY_LOG_BUDGET tokens (whole entries)
+ * - Recall gets at least RECALL_MIN_BUDGET, plus whatever daily logs didn't use
+ * - Last recall entry can push total up to budget + RECALL_OVERFLOW (4k grace)
+ * - Weekly summaries are excluded (already indexed by recall)
+ */
+export declare const DAILY_LOG_BUDGET_TOKENS = 24000;
 /**
  * Build the full prompt for a teammate session.
  * Includes identity, memory, roster, output protocol, and the task.

package/dist/adapter.js

@@ -6,7 +6,7 @@
  * and translates between the orchestrator's protocol and the agent's native API.
  */
 import { platform } from "node:os";
-import { Indexer, buildQueryVariations, matchMemoryCatalog, multiSearch, } from "@teammates/recall";
+import { buildQueryVariations, Indexer, matchMemoryCatalog, multiSearch, } from "@teammates/recall";
 /**
  * Query the recall index for context relevant to the task prompt.
  *
@@ -58,23 +58,16 @@ export async function syncRecallIndex(teammatesDir, teammate) {
         await indexer.syncAll();
     }
 }
-/**
- * Default token budget for the prompt wrapper (everything except the task).
- * ~64k tokens ≈ 256k chars at ~4 chars/token.
- * The task prompt itself is excluded from this budget — if a user pastes
- * a large input, that's intentional and we don't trim it.
- */
-const DEFAULT_TOKEN_BUDGET = 64_000;
+/** Approximate chars per token for budget estimation. */
 const CHARS_PER_TOKEN = 4;
 /**
  * Context budget allocation:
  * - Days 2-7 get up to DAILY_LOG_BUDGET tokens (whole entries)
  * - Recall gets at least RECALL_MIN_BUDGET, plus whatever daily logs didn't use
- * - Last recall entry can push total up to CONTEXT_BUDGET + RECALL_OVERFLOW (36k)
+ * - Last recall entry can push total up to budget + RECALL_OVERFLOW (4k grace)
  * - Weekly summaries are excluded (already indexed by recall)
  */
-const CONTEXT_BUDGET_TOKENS = 32_000;
-const DAILY_LOG_BUDGET_TOKENS = 24_000;
+export const DAILY_LOG_BUDGET_TOKENS = 24_000;
 const RECALL_MIN_BUDGET_TOKENS = 8_000;
 const RECALL_OVERFLOW_TOKENS = 4_000;
 /** Estimate tokens from character count. */
@@ -97,57 +90,98 @@ function estimateTokens(text) {
  */
 export function buildTeammatePrompt(teammate, taskPrompt, options) {
     const parts = [];
-    // ── Identity (required) ─────────────────────────────────────────
-    parts.push(`# You are ${teammate.name}\n\n${teammate.soul}\n\n---\n`);
-    // ── Wisdom (required) ───────────────────────────────────────────
+    // ── Top edge (high attention) ─────────────────────────────────────
+    // <IDENTITY> — anchors persona
+    parts.push(`<IDENTITY>\n# You are ${teammate.name}\n\n${teammate.soul}\n`);
+    // <WISDOM> — stable knowledge
     if (teammate.wisdom.trim()) {
-        parts.push(`## Your Wisdom\n\n${teammate.wisdom}\n\n---\n`);
+        parts.push(`<WISDOM>\n${teammate.wisdom}\n`);
+    }
+    // ── Reference data (middle — acceptable for "lost in the middle") ──
+    // <TEAM> — roster for handoffs
+    if (options?.roster && options.roster.length > 0) {
+        const lines = [
+            "<TEAM>",
+            "These are the other teammates you can hand off work to:\n",
+        ];
+        for (const t of options.roster) {
+            if (t.name === teammate.name)
+                continue;
+            const owns = t.ownership.primary.length > 0
+                ? ` — owns: ${t.ownership.primary.join(", ")}`
+                : "";
+            lines.push(`- **@${t.name}**: ${t.role}${owns}`);
+        }
+        parts.push(`${lines.join("\n")}\n`);
+    }
+    // <SERVICES> — installed services
+    if (options?.services && options.services.length > 0) {
+        const lines = [
+            "<SERVICES>",
+            "These services are installed and available for you to use:\n",
+        ];
+        for (const svc of options.services) {
+            lines.push(`### ${svc.name}\n`);
+            lines.push(svc.description);
+            lines.push(`\n**Usage:** \`${svc.usage}\`\n`);
+        }
+        parts.push(`${lines.join("\n")}\n`);
     }
-    // ── Budget-allocated context (daily logs → recall) ──────────────
-    // Today's log: always included, outside budget
-    // Days 2-7: up to 24k tokens (whole entries)
-    // Recall: at least 8k + unused daily budget, last entry may overflow by 4k
+    // <RECALL_TOOL> — Pass 2: agent-driven search
+    parts.push(`<RECALL_TOOL>\nYou can search your own memories mid-task for additional context. This is useful when the pre-loaded memories don't cover what you need.\n\n**Usage:** Run this command via your shell/terminal tool:\n\`\`\`\nteammates-recall search "<your query>" --dir .teammates --teammate ${teammate.name} --no-sync --json\n\`\`\`\n\n**Tips:**\n- Use specific, descriptive queries ("hooks lifecycle event naming decision" not "hooks")\n- Search iteratively: query → read result → refine query\n- The \`--json\` flag returns structured results for easier parsing\n- Results include a \`score\` field (0-1) — higher is more relevant\n- You can omit \`--teammate\` to search across all teammates' memories\n`);
+    // <ENVIRONMENT> — date/time + platform
+    const now = new Date();
+    const today = now.toISOString().slice(0, 10);
+    const os = platform();
+    const osLabel = os === "win32" ? "Windows" : os === "darwin" ? "macOS" : "Linux";
+    const slashNote = os === "win32"
+        ? "Use backslashes (`\\`) in file paths."
+        : "Use forward slashes (`/`) in file paths.";
+    // Extract timezone from USER.md if available
+    const tzMatch = options?.userProfile?.match(/\*\*Primary Timezone:\*\*\s*(.+)/);
+    const userTimezone = tzMatch?.[1]?.trim();
+    const tzLine = userTimezone ? `\n**Timezone:** ${userTimezone}` : "";
+    parts.push(`<ENVIRONMENT>\n**Current date:** ${now.toLocaleDateString("en-US", { weekday: "long", year: "numeric", month: "long", day: "numeric" })} (${today})\n**Current time:** ${now.toLocaleTimeString("en-US", { hour: "2-digit", minute: "2-digit" })}${tzLine}\n**Environment:** ${osLabel} — ${slashNote}\n`);
+    // ── Session context (middle-to-lower) ─────────────────────────────
+    // <DAILY_LOGS> — today's log (never trimmed) + days 2-7 (budget-allocated)
     const todayLog = teammate.dailyLogs.slice(0, 1);
     const pastLogs = teammate.dailyLogs.slice(1, 7); // days 2-7
     let dailyBudget = DAILY_LOG_BUDGET_TOKENS;
-    // Current daily log (today) — never trimmed, always included
-    if (todayLog.length > 0) {
-        const todayLines = ["## Recent Daily Logs\n"];
+    if (todayLog.length > 0 || pastLogs.length > 0) {
+        const logLines = ["<DAILY_LOGS>"];
+        // Current daily log (today) — never trimmed, always included
         for (const log of todayLog) {
-            todayLines.push(`### ${log.date}\n${log.content}\n`);
+            logLines.push(`### ${log.date}\n${log.content}`);
         }
-        parts.push(todayLines.join("\n"));
-    }
-    // Days 2-7 — whole entries, up to 24k tokens
-    if (pastLogs.length > 0) {
-        const lines = [];
+        // Days 2-7 — whole entries, up to 24k tokens
         for (const log of pastLogs) {
-            const entry = `### ${log.date}\n${log.content}\n`;
+            const entry = `### ${log.date}\n${log.content}`;
             const cost = estimateTokens(entry);
             if (cost > dailyBudget)
                 break;
-            lines.push(entry);
+            logLines.push(entry);
             dailyBudget -= cost;
         }
-        if (lines.length > 0)
-            parts.push(lines.join("\n"));
+        parts.push(`${logLines.join("\n")}\n`);
+    }
+    // <USER_PROFILE> — always included when present
+    if (options?.userProfile?.trim()) {
+        parts.push(`<USER_PROFILE>\n${options.userProfile.trim()}\n`);
     }
-    // Recall results — gets at least 8k tokens, plus unused daily budget
-    // Last entry may overflow by up to 4k tokens
+    // ── Task-adjacent context (close to task for maximum relevance) ───
+    // <RECALL_RESULTS> — budget-allocated, adjacent to task
     const recallBudget = Math.max(RECALL_MIN_BUDGET_TOKENS, RECALL_MIN_BUDGET_TOKENS + dailyBudget);
     const recallResults = options?.recallResults ?? [];
     if (recallResults.length > 0) {
         const lines = [
-            "## Relevant Memories (from recall search)\n",
+            "<RECALL_RESULTS>",
             "These memories were retrieved based on relevance to the current task:\n",
         ];
         const headerCost = estimateTokens(lines.join("\n"));
         let recallUsed = headerCost;
         for (const r of recallResults) {
-            const label = r.contentType
-                ? `[${r.contentType}] ${r.uri}`
-                : r.uri;
-            const entry = `### ${label}\n${r.text}\n`;
+            const label = r.contentType ? `[${r.contentType}] ${r.uri}` : r.uri;
+            const entry = `### ${label}\n${r.text}`;
             const cost = estimateTokens(entry);
             if (recallUsed + cost > recallBudget + RECALL_OVERFLOW_TOKENS)
                 break;
@@ -158,85 +192,90 @@ export function buildTeammatePrompt(teammate, taskPrompt, options) {
                 break;
         }
         if (lines.length > 2) {
-            lines.push("\n---\n");
-            parts.push(lines.join("\n"));
+            parts.push(`${lines.join("\n")}\n`);
         }
     }
-    // Close context section with separator if needed
-    if (todayLog.length > 0 || pastLogs.length > 0) {
-        const lastPart = parts[parts.length - 1];
-        if (!lastPart.endsWith("---\n")) {
-            parts.push("\n---\n");
-        }
+    // <HANDOFF_CONTEXT> — directly task-relevant when present
+    if (options?.handoffContext) {
+        parts.push(`<HANDOFF_CONTEXT>\n${options.handoffContext}\n`);
+    }
+    // ── The question ──────────────────────────────────────────────────
+    // <TASK> — always included, excluded from budget
+    parts.push(`<TASK>\n${taskPrompt}\n`);
+    // ── Bottom edge (high attention) — all instructions merged ────────
+    // <INSTRUCTIONS> — output protocol, handoffs, session state, memory updates
+    const instrLines = [
+        "<INSTRUCTIONS>",
+        "",
+        "### Output Protocol (CRITICAL)",
+        "",
+        "**Your #1 job is to produce a visible text response.** Session updates and memory writes are secondary — they support continuity but are not the deliverable. The user sees ONLY your text output. If you update files but return no text, the user sees an empty message and your work is invisible.",
+        "",
+        "Format your response as:",
+        "",
+        "```",
+        "TO: user",
+        "# <Subject line>",
+        "",
+        "<Body — full markdown response>",
+        "```",
+        "",
+        "**Rules:**",
+        "- **You MUST end your turn with visible text output.** A turn that ends with only tool calls and no text is a failed turn.",
+        "- The `# Subject` line is REQUIRED — it becomes the message title.",
+        "- Always write a substantive body. Never return just the subject.",
+        "- Use markdown: headings, lists, code blocks, bold, etc.",
+        "- **Write your text response FIRST, then update session/memory files.** This ensures visible output even if the agent turn ends early.",
+        "",
+        "### Handoffs",
+        "",
+        "To delegate work to a teammate, you MUST include a fenced code block with the language tag `handoff` in your text output. **This is the ONLY way to trigger a handoff.** Mentioning a handoff in plain English does NOT work — the system parses the fenced block, not your prose.",
+        "",
+        "Exact format (include the triple backticks exactly as shown):",
+        "",
+        "    ```handoff",
+        "    @<teammate-name>",
+        "    <task description with full context>",
+        "    ```",
+        "",
+        "Rules:",
+        `- Only hand off to teammates listed in \`<TEAM>\`.`,
+        "- Do as much work as you can BEFORE handing off.",
+        '- Do NOT just say "I\'ll hand this off" in prose — that does nothing. You MUST use the fenced block.',
+    ];
+    // Session state (conditional)
+    if (options?.sessionFile) {
+        instrLines.push("", "### Session State", "", `Your session file is at: \`${options.sessionFile}\``, "", "**After writing your text response**, append a brief entry to this file with:", "- What you did", "- Key decisions made", "- Files changed", "- Anything the next task should know", "", "This is how you maintain continuity across tasks. Always read it, always update it.");
+    }
+    // Memory updates
+    instrLines.push("", "### Memory Updates", "", "**After writing your text response**, update your memory files:", "", `1. **Daily log** — Read \`.teammates/${teammate.name}/memory/${today}.md\` first (it may have entries from earlier tasks today), then write it back with your entry added. Create the file if it doesn't exist.`, "   - What you did", "   - Key decisions made", "   - Files changed", "   - Anything the next task should know", "", `2. **Typed memories** — If you learned something durable (a decision, pattern, feedback, or reference), create a typed memory file at \`.teammates/${teammate.name}/memory/<type>_<topic>.md\` with frontmatter (\`name\`, \`description\`, \`type\`). Update existing memory files if the topic already has one.`, "", "3. **WISDOM.md** — Do not edit directly. Wisdom entries are distilled from typed memories during compaction.", "", "These files are your persistent memory. Without them, your next session starts from scratch.");
+    // Section Reinforcement — back-references from high-attention bottom edge to each section tag
+    instrLines.push("", "### Section Reinforcement", "");
+    instrLines.push("- Stay in character as defined in `<IDENTITY>` — never break persona or speak as a generic assistant.");
+    if (teammate.wisdom.trim()) {
+        instrLines.push("- Apply lessons from `<WISDOM>` before proposing solutions — do not repeat past mistakes.");
     }
-    // ── Team roster (required, small) ───────────────────────────────
     if (options?.roster && options.roster.length > 0) {
-        const lines = [
-            "## Your Team\n",
-            "These are the other teammates you can hand off work to:\n",
-        ];
-        for (const t of options.roster) {
-            if (t.name === teammate.name)
-                continue;
-            const owns = t.ownership.primary.length > 0
-                ? ` — owns: ${t.ownership.primary.join(", ")}`
-                : "";
-            lines.push(`- **@${t.name}**: ${t.role}${owns}`);
-        }
-        lines.push("\n---\n");
-        parts.push(lines.join("\n"));
+        instrLines.push("- Only hand off to teammates listed in `<TEAM>` using the handoff block format above.");
     }
-    // ── Installed services (required, small) ────────────────────────
     if (options?.services && options.services.length > 0) {
-        const lines = [
-            "## Available Services\n",
-            "These services are installed and available for you to use:\n",
-        ];
-        for (const svc of options.services) {
-            lines.push(`### ${svc.name}\n`);
-            lines.push(svc.description);
-            lines.push(`\n**Usage:** \`${svc.usage}\`\n`);
-        }
-        lines.push("\n---\n");
-        parts.push(lines.join("\n"));
+        instrLines.push("- Use tools and services from `<SERVICES>` when they fit the task — do not reinvent what is already available.");
     }
-    // ── Recall tool (Pass 2 — agent-driven search) ─────────────────
-    // Tell the agent it can search memories mid-task via the CLI tool
-    parts.push(`## Recall — Memory Search Tool\n\nYou can search your own memories mid-task for additional context. This is useful when the pre-loaded memories don't cover what you need.\n\n**Usage:** Run this command via your shell/terminal tool:\n\`\`\`\nteammates-recall search "<your query>" --dir .teammates --teammate ${teammate.name} --no-sync --json\n\`\`\`\n\n**Tips:**\n- Use specific, descriptive queries ("hooks lifecycle event naming decision" not "hooks")\n- Search iteratively: query → read result → refine query\n- The \`--json\` flag returns structured results for easier parsing\n- Results include a \`score\` field (0-1) — higher is more relevant\n- You can omit \`--teammate\` to search across all teammates' memories\n\n---\n`);
-    // ── Handoff context (required when present) ─────────────────────
-    if (options?.handoffContext) {
-        parts.push(`## Handoff Context\n\n${options.handoffContext}\n\n---\n`);
-    }
-    // ── Output protocol (required — BEFORE session/memory updates) ──
-    // Placed first so agents produce text response before doing housekeeping.
-    // When output protocol is after memory updates, agents often end their turn
-    // with file edits and produce no visible text output.
-    parts.push(`## Output Protocol (CRITICAL)\n\n**Your #1 job is to produce a visible text response.** Session updates and memory writes are secondary — they support continuity but are not the deliverable. The user sees ONLY your text output. If you update files but return no text, the user sees an empty message and your work is invisible.\n\nFormat your response as:\n\n\`\`\`\nTO: user\n# <Subject line>\n\n<Body — full markdown response>\n\`\`\`\n\n**Handoffs:** To hand off work to a teammate, include a fenced handoff block anywhere in your response:\n\n\`\`\`\n\`\`\`handoff\n@<teammate>\n<task description — what you need them to do, with full context>\n\`\`\`\n\`\`\`\n\n**Rules:**\n- **You MUST end your turn with visible text output.** A turn that ends with only tool calls and no text is a failed turn.\n- The \`# Subject\` line is REQUIRED — it becomes the message title.\n- Always write a substantive body. Never return just the subject.\n- Use markdown: headings, lists, code blocks, bold, etc.\n- Do as much work as you can before handing off.\n- Only hand off to teammates listed in "Your Team" above.\n- The handoff block can appear anywhere in your response — it will be detected automatically.\n- **Write your text response FIRST, then update session/memory files.** This ensures visible output even if the agent turn ends early.\n\n---\n`);
-    // ── Session state (required) ────────────────────────────────────
-    if (options?.sessionFile) {
-        parts.push(`## Session State\n\nYour session file is at: \`${options.sessionFile}\`\n\n**After writing your text response**, append a brief entry to this file with:\n- What you did\n- Key decisions made\n- Files changed\n- Anything the next task should know\n\nThis is how you maintain continuity across tasks. Always read it, always update it.\n\n---\n`);
+    instrLines.push("- If pre-loaded context is insufficient, use `<RECALL_TOOL>` to search for additional memories before giving up.", "- Respect platform, date, and path conventions from `<ENVIRONMENT>`.");
+    if (todayLog.length > 0 || pastLogs.length > 0) {
+        instrLines.push("- Check `<DAILY_LOGS>` for prior work on this topic before starting — avoid duplicating what was already done today.");
     }
-    // ── Memory updates (required) ───────────────────────────────────
-    const today = new Date().toISOString().slice(0, 10);
-    parts.push(`## Memory Updates\n\n**After writing your text response**, update your memory files:\n\n1. **Daily log** — Read \`.teammates/${teammate.name}/memory/${today}.md\` first (it may have entries from earlier tasks today), then write it back with your entry added. Create the file if it doesn't exist.\n   - What you did\n   - Key decisions made\n   - Files changed\n   - Anything the next task should know\n\n2. **Typed memories** — If you learned something durable (a decision, pattern, feedback, or reference), create a typed memory file at \`.teammates/${teammate.name}/memory/<type>_<topic>.md\` with frontmatter (\`name\`, \`description\`, \`type\`). Update existing memory files if the topic already has one.\n\n3. **WISDOM.md** — Do not edit directly. Wisdom entries are distilled from typed memories during compaction.\n\nThese files are your persistent memory. Without them, your next session starts from scratch.\n\n---\n`);
-    // ── Current date/time + environment (required, small) ───────────
-    const now = new Date();
-    const os = platform();
-    const osLabel = os === "win32" ? "Windows" : os === "darwin" ? "macOS" : "Linux";
-    const slashNote = os === "win32"
-        ? "Use backslashes (`\\`) in file paths."
-        : "Use forward slashes (`/`) in file paths.";
-    // Extract timezone from USER.md if available
-    const tzMatch = options?.userProfile?.match(/\*\*Primary Timezone:\*\*\s*(.+)/);
-    const userTimezone = tzMatch?.[1]?.trim();
-    const tzLine = userTimezone ? `\n**Timezone:** ${userTimezone}` : "";
-    parts.push(`**Current date:** ${now.toLocaleDateString("en-US", { weekday: "long", year: "numeric", month: "long", day: "numeric" })} (${today})\n**Current time:** ${now.toLocaleTimeString("en-US", { hour: "2-digit", minute: "2-digit" })}${tzLine}\n**Environment:** ${osLabel} — ${slashNote}\n\n---\n`);
-    // ── User profile (always included when present) ────────────────
     if (options?.userProfile?.trim()) {
-        parts.push(`## User Profile\n\n${options.userProfile.trim()}\n\n---\n`);
+        instrLines.push("- Honor the user's role, preferences, and communication style from `<USER_PROFILE>`.");
+    }
+    if (recallResults.length > 0) {
+        instrLines.push("- Incorporate relevant context from `<RECALL_RESULTS>` into your response — these memories were retrieved for a reason.");
+    }
+    if (options?.handoffContext) {
+        instrLines.push("- When `<HANDOFF_CONTEXT>` is present, address its requirements and open questions directly.");
     }
-    // ── Task (always included, excluded from budget) ────────────────
-    parts.push(`## Task\n\n${taskPrompt}\n\n---\n\n**REMINDER: Write your text response (TO: user) FIRST, then update session/memory files. A turn with only file edits and no text output is a failed turn.**`);
+    instrLines.push("- Your response must answer `<TASK>` — everything else is supporting context.", "", "**REMINDER: Write your text response (TO: user) FIRST, then update session/memory files. A turn with only file edits and no text output is a failed turn.**");
+    parts.push(instrLines.join("\n"));
     return parts.join("\n");
 }
 /**

package/dist/adapter.test.js

@@ -25,27 +25,28 @@ describe("buildTeammatePrompt", () => {
     });
     it("includes the task", () => {
         const prompt = buildTeammatePrompt(makeConfig(), "fix the bug");
-        expect(prompt).toContain("## Task");
+        expect(prompt).toContain("<TASK>");
         expect(prompt).toContain("fix the bug");
     });
     it("includes output protocol", () => {
         const prompt = buildTeammatePrompt(makeConfig(), "task");
-        expect(prompt).toContain("## Output Protocol");
+        expect(prompt).toContain("<INSTRUCTIONS>");
+        expect(prompt).toContain("Output Protocol");
         expect(prompt).toContain("TO: user");
         expect(prompt).toContain("```handoff");
     });
     it("includes memory updates section", () => {
         const prompt = buildTeammatePrompt(makeConfig(), "task");
-        expect(prompt).toContain("## Memory Updates");
+        expect(prompt).toContain("### Memory Updates");
         expect(prompt).toContain(".teammates/beacon/memory/");
     });
     it("skips wisdom section when empty", () => {
         const prompt = buildTeammatePrompt(makeConfig({ wisdom: "" }), "task");
-        expect(prompt).not.toContain("## Your Wisdom");
+        expect(prompt).not.toContain("<WISDOM>");
     });
     it("includes wisdom when present", () => {
         const prompt = buildTeammatePrompt(makeConfig({ wisdom: "Some important wisdom" }), "task");
-        expect(prompt).toContain("## Your Wisdom");
+        expect(prompt).toContain("<WISDOM>");
         expect(prompt).toContain("Some important wisdom");
     });
     it("includes daily logs (up to 7)", () => {
@@ -60,7 +61,7 @@ describe("buildTeammatePrompt", () => {
             { date: "2026-03-06", content: "Should be excluded" },
         ];
         const prompt = buildTeammatePrompt(makeConfig({ dailyLogs: logs }), "task");
-        expect(prompt).toContain("## Recent Daily Logs");
+        expect(prompt).toContain("<DAILY_LOGS>");
         expect(prompt).toContain("2026-03-13");
         expect(prompt).toContain("2026-03-07");
         expect(prompt).not.toContain("2026-03-06");
@@ -80,7 +81,7 @@ describe("buildTeammatePrompt", () => {
             },
         ];
         const prompt = buildTeammatePrompt(makeConfig(), "task", { roster });
-        expect(prompt).toContain("## Your Team");
+        expect(prompt).toContain("<TEAM>");
         expect(prompt).toContain("@scribe");
         expect(prompt).toContain("Documentation writer.");
         // Should not list self in roster
@@ -90,14 +91,14 @@ describe("buildTeammatePrompt", () => {
         const prompt = buildTeammatePrompt(makeConfig(), "task", {
             handoffContext: "Handed off from scribe with files changed",
         });
-        expect(prompt).toContain("## Handoff Context");
+        expect(prompt).toContain("<HANDOFF_CONTEXT>");
         expect(prompt).toContain("Handed off from scribe");
     });
     it("includes session file when provided", () => {
         const prompt = buildTeammatePrompt(makeConfig(), "task", {
             sessionFile: "/tmp/beacon-session.md",
         });
-        expect(prompt).toContain("## Session State");
+        expect(prompt).toContain("### Session State");
         expect(prompt).toContain("/tmp/beacon-session.md");
     });
     it("drops daily logs that exceed the 24k daily budget", () => {
@@ -130,11 +131,17 @@ describe("buildTeammatePrompt", () => {
         const recallText = "R".repeat(20_000); // ~5k tokens — fits in 8k min
         const prompt = buildTeammatePrompt(config, "task", {
             recallResults: [
-                { teammate: "beacon", uri: "memory/decision_foo.md", text: recallText, score: 0.9, contentType: "typed_memory" },
+                {
+                    teammate: "beacon",
+                    uri: "memory/decision_foo.md",
+                    text: recallText,
+                    score: 0.9,
+                    contentType: "typed_memory",
+                },
             ],
         });
         expect(prompt).toContain("2026-03-17");
-        expect(prompt).toContain("## Relevant Memories");
+        expect(prompt).toContain("<RECALL_RESULTS>");
     });
     it("recall gets unused daily log budget", () => {
         // Small daily logs leave most of 24k unused — recall gets the surplus.
@@ -148,10 +155,16 @@ describe("buildTeammatePrompt", () => {
         const recallText = "R".repeat(80_000); // ~20k tokens — fits in (8k + ~24k unused)
         const prompt = buildTeammatePrompt(config, "task", {
             recallResults: [
-                { teammate: "beacon", uri: "memory/big.md", text: recallText, score: 0.9, contentType: "typed_memory" },
+                {
+                    teammate: "beacon",
+                    uri: "memory/big.md",
+                    text: recallText,
+                    score: 0.9,
+                    contentType: "typed_memory",
+                },
             ],
         });
-        expect(prompt).toContain("## Relevant Memories");
+        expect(prompt).toContain("<RECALL_RESULTS>");
         expect(prompt).toContain("memory/big.md");
     });
     it("weekly summaries are excluded (indexed by recall)", () => {
@@ -160,8 +173,8 @@ describe("buildTeammatePrompt", () => {
             weeklyLogs: [{ week: "2026-W11", content: "short summary" }],
         });
         const prompt = buildTeammatePrompt(config, "task");
-        expect(prompt).toContain("## Recent Daily Logs");
-        expect(prompt).not.toContain("## Recent Weekly Summaries");
+        expect(prompt).toContain("<DAILY_LOGS>");
+        expect(prompt).not.toContain("Weekly Summaries");
     });
     it("excludes task prompt from budget calculation", () => {
         // Large task prompt should not trigger trimming of wrapper sections
@@ -171,7 +184,7 @@ describe("buildTeammatePrompt", () => {
         });
         const prompt = buildTeammatePrompt(config, bigTask);
         // Daily logs should still be included despite the huge task
-        expect(prompt).toContain("## Recent Daily Logs");
+        expect(prompt).toContain("<DAILY_LOGS>");
         expect(prompt).toContain("small log");
     });
 });

package/dist/adapters/cli-proxy.js

@@ -20,7 +20,8 @@ import { mkdirSync } from "node:fs";
 import { mkdir, readFile, unlink, writeFile } from "node:fs/promises";
 import { tmpdir } from "node:os";
 import { join } from "node:path";
-import { buildTeammatePrompt, queryRecallContext } from "../adapter.js";
+import { DAILY_LOG_BUDGET_TOKENS, buildTeammatePrompt, queryRecallContext, } from "../adapter.js";
+import { autoCompactForBudget } from "../compact.js";
 export const PRESETS = {
     claude: {
         name: "claude",
@@ -152,6 +153,16 @@ export class CliProxyAdapter {
             const recall = teammatesDir
                 ? await queryRecallContext(teammatesDir, teammate.name, prompt)
                 : undefined;
+            // Auto-compact daily logs if they exceed the token budget
+            if (teammatesDir) {
+                const teammateDir = join(teammatesDir, teammate.name);
+                const compacted = await autoCompactForBudget(teammateDir, DAILY_LOG_BUDGET_TOKENS);
+                if (compacted) {
+                    // Filter compacted dates out of in-memory daily logs
+                    const compactedSet = new Set(compacted.compactedDates);
+                    teammate.dailyLogs = teammate.dailyLogs.filter((log) => !compactedSet.has(log.date));
+                }
+            }
             // Read USER.md for injection into the prompt
             let userProfile;
             if (teammatesDir) {
@@ -481,8 +492,12 @@ function parseMessageProtocol(output, teammateName, _teammateNames) {
             break;
         }
     }
-    // Find all ```handoff blocks
+    // Find all ```handoff blocks (primary) + natural-language fallback
     const handoffBlocks = findHandoffBlocks(output);
+    if (handoffBlocks.length === 0) {
+        // Fallback: detect natural-language handoff patterns mentioning known teammates
+        handoffBlocks.push(...findNaturalLanguageHandoffs(output, _teammateNames));
+    }
     const handoffs = handoffBlocks.map((h) => ({
         from: teammateName,
         to: h.target,
@@ -523,6 +538,47 @@ function findHandoffBlocks(output) {
     }
     return results;
 }
+/**
+ * Fallback handoff detector: catches natural-language handoff patterns when
+ * the agent fails to use the ```handoff fenced block format.
+ *
+ * Looks for sentences like:
+ *   - "hand off to @beacon: implement the feature"
+ *   - "handing this to @scribe for documentation"
+ *   - "I'll delegate to @pipeline"
+ *   - "queued a handoff to @beacon"
+ *
+ * Only triggers if the @mentioned name is in the known teammate list.
+ * Extracts the surrounding sentence as the task description.
+ */
+function findNaturalLanguageHandoffs(output, teammateNames) {
+    if (teammateNames.length === 0)
+        return [];
+    const results = [];
+    const seen = new Set();
+    // Pattern: handoff-related verb/noun near @teammate
+    const pattern = /(?:hand(?:off|ing off| off| this off)|delegat(?:e|ing)|pass(?:ing)? (?:this |it )?(?:to|off to)|queued? (?:a )?handoff (?:to|for))\s+@(\w+)\b[.:,]?\s*(.*)/gi;
+    let match;
+    while ((match = pattern.exec(output)) !== null) {
+        const target = match[1].toLowerCase();
+        if (!teammateNames.includes(target))
+            continue;
+        if (seen.has(target))
+            continue;
+        seen.add(target);
+        // Use the rest of the sentence as the task, or a generic description
+        let task = match[2]
+            .replace(/\n.*/s, "") // first line only
+            .replace(/[.!]+$/, "") // strip trailing punctuation
+            .trim();
+        if (!task || task.length < 5) {
+            task =
+                "(handoff detected from natural language — no task details provided)";
+        }
+        results.push({ target, task });
+    }
+    return results;
+}
 /** Extract file paths from agent output. */
 export function parseChangedFiles(output) {
     const files = new Set();

package/dist/adapters/copilot.js

@@ -12,7 +12,8 @@
 import { mkdir, readFile, writeFile } from "node:fs/promises";
 import { join } from "node:path";
 import { approveAll, CopilotClient, } from "@github/copilot-sdk";
-import { buildTeammatePrompt, queryRecallContext } from "../adapter.js";
+import { DAILY_LOG_BUDGET_TOKENS, buildTeammatePrompt, queryRecallContext, } from "../adapter.js";
+import { autoCompactForBudget } from "../compact.js";
 import { parseResult } from "./cli-proxy.js";
 // ─── Adapter ─────────────────────────────────────────────────────────
 let nextId = 1;
@@ -72,6 +73,15 @@ export class CopilotAdapter {
             const recall = teammatesDir
                 ? await queryRecallContext(teammatesDir, teammate.name, prompt)
                 : undefined;
+            // Auto-compact daily logs if they exceed the token budget
+            if (teammatesDir) {
+                const teammateDir = join(teammatesDir, teammate.name);
+                const compacted = await autoCompactForBudget(teammateDir, DAILY_LOG_BUDGET_TOKENS);
+                if (compacted) {
+                    const compactedSet = new Set(compacted.compactedDates);
+                    teammate.dailyLogs = teammate.dailyLogs.filter((log) => !compactedSet.has(log.date));
+                }
+            }
             // Read USER.md for injection into the prompt
             let userProfile;
             if (teammatesDir) {

package/dist/adapters/echo.js

@@ -12,7 +12,9 @@ export class EchoAdapter {
         return `echo-${teammate.name}-${nextId++}`;
     }
     async executeTask(_sessionId, teammate, prompt, options) {
-        const fullPrompt = options?.raw ? prompt : buildTeammatePrompt(teammate, prompt);
+        const fullPrompt = options?.raw
+            ? prompt
+            : buildTeammatePrompt(teammate, prompt);
         return {
             teammate: teammate.name,
             success: true,

package/dist/banner.js

@@ -78,7 +78,11 @@ export class AnimatedBanner extends Control {
         // Service status rows
         for (const svc of info.services) {
             const isBundledOrConfigured = svc.status === "bundled" || svc.status === "configured";
-            const icon = isBundledOrConfigured ? "● " : svc.status === "not-configured" ? "◐ " : "○ ";
+            const icon = isBundledOrConfigured
+                ? "● "
+                : svc.status === "not-configured"
+                    ? "◐ "
+                    : "○ ";
             const color = isBundledOrConfigured ? tp.success : tp.warning;
             const label = svc.status === "bundled"
                 ? "bundled"