@teammates/cli 0.6.0 → 0.6.2

package/dist/adapter.js

@@ -260,7 +260,7 @@ export function buildTeammatePrompt(teammate, taskPrompt, options) {
         instrLines.push("", "### Folder Boundaries (ENFORCED)", "", `**You MUST NOT create, edit, or delete files inside another teammate's folder (\`.teammates/<other>/\`).** Your folder is \`.teammates/${teammate.name}/\` — you may only write inside it. Shared folders (\`.teammates/_*/\`) and ephemeral folders (\`.teammates/.*/\`) are also writable.`, "", "If your task requires changes to another teammate's files, you MUST hand off that work using the handoff block format above. Violation of this rule will cause your changes to be flagged and potentially reverted.");
     }
     // Memory updates
-    instrLines.push("", "### Memory Updates", "", "**After completing the task**, 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.");
+    instrLines.push("", "### Memory Updates", "", "**After completing the task**, 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. Always include YAML frontmatter with \`version: 0.6.0\` and \`type: daily\`.`, "   - 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 (\`version\`, \`name\`, \`description\`, \`type\`). Always include \`version: 0.6.0\` as the first field. 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.");

package/dist/cli-utils.d.ts

@@ -46,5 +46,11 @@ export declare function findSummarizationSplit(history: ConversationEntry[], bud
  * Build the summarization prompt text from entries being pushed out of the budget.
  */
 export declare function buildSummarizationPrompt(entries: ConversationEntry[], existingSummary: string): string;
+/**
+ * Mechanically compress conversation entries into a condensed bullet summary.
+ * Used for fast pre-dispatch compression when history exceeds the token budget.
+ * Each entry becomes a one-line bullet with truncated text.
+ */
+export declare function compressConversationEntries(entries: ConversationEntry[], existingSummary: string): string;
 /** Check if a string looks like an image file path. */
 export declare function isImagePath(text: string): boolean;

package/dist/cli-utils.js

@@ -135,6 +135,23 @@ export function buildSummarizationPrompt(entries, existingSummary) {
         ? `You are maintaining a running summary of an ongoing conversation between a user and their AI teammates. Update the existing summary to incorporate the new conversation entries below.\n\n## Current Summary\n\n${existingSummary}\n\n## New Entries to Incorporate\n\n${entriesText}\n\n${instructions}`
         : `You are maintaining a running summary of an ongoing conversation between a user and their AI teammates. Summarize the conversation entries below.\n\n## Entries to Summarize\n\n${entriesText}\n\n${instructions}`;
 }
+/**
+ * Mechanically compress conversation entries into a condensed bullet summary.
+ * Used for fast pre-dispatch compression when history exceeds the token budget.
+ * Each entry becomes a one-line bullet with truncated text.
+ */
+export function compressConversationEntries(entries, existingSummary) {
+    const bullets = entries.map((e) => {
+        const firstLine = e.text.split("\n")[0].slice(0, 150);
+        const ellipsis = e.text.length > 150 || e.text.includes("\n") ? "…" : "";
+        return `- **${e.role}:** ${firstLine}${ellipsis}`;
+    });
+    const compressed = bullets.join("\n");
+    if (existingSummary) {
+        return `${existingSummary}\n\n### Compressed\n${compressed}`;
+    }
+    return compressed;
+}
 /** Check if a string looks like an image file path. */
 export function isImagePath(text) {
     // Must look like a file path (contains slash or backslash, or starts with drive letter)

package/dist/cli-utils.test.js

@@ -1,5 +1,5 @@
 import { afterEach, beforeEach, describe, expect, it, vi } from "vitest";
-import { buildConversationContext, buildSummarizationPrompt, cleanResponseBody, findAtMention, findSummarizationSplit, formatConversationEntry, IMAGE_EXTS, isImagePath, relativeTime, wrapLine, } from "./cli-utils.js";
+import { buildConversationContext, buildSummarizationPrompt, compressConversationEntries, cleanResponseBody, findAtMention, findSummarizationSplit, formatConversationEntry, IMAGE_EXTS, isImagePath, relativeTime, wrapLine, } from "./cli-utils.js";
 // ── relativeTime ────────────────────────────────────────────────────
 describe("relativeTime", () => {
     beforeEach(() => {
@@ -361,3 +361,52 @@ describe("buildSummarizationPrompt", () => {
         expect(prompt).toContain("**scribe:**\nLine 1\nLine 2");
     });
 });
+// ── compressConversationEntries ──────────────────────────────────────
+describe("compressConversationEntries", () => {
+    it("compresses entries into bullet summaries", () => {
+        const entries = [
+            { role: "stevenic", text: "Build the feature" },
+            { role: "beacon", text: "Done, here's what I did" },
+        ];
+        const result = compressConversationEntries(entries, "");
+        expect(result).toContain("- **stevenic:** Build the feature");
+        expect(result).toContain("- **beacon:** Done, here's what I did");
+    });
+    it("truncates long text at 150 chars with ellipsis", () => {
+        const entries = [
+            { role: "scribe", text: "A".repeat(200) },
+        ];
+        const result = compressConversationEntries(entries, "");
+        expect(result).toContain("A".repeat(150));
+        expect(result).toContain("…");
+        expect(result).not.toContain("A".repeat(151));
+    });
+    it("adds ellipsis for multi-line text even if short", () => {
+        const entries = [
+            { role: "beacon", text: "Line 1\nLine 2" },
+        ];
+        const result = compressConversationEntries(entries, "");
+        expect(result).toContain("- **beacon:** Line 1…");
+    });
+    it("prepends existing summary with compressed section", () => {
+        const entries = [
+            { role: "stevenic", text: "Do the thing" },
+        ];
+        const result = compressConversationEntries(entries, "Earlier context here");
+        expect(result).toContain("Earlier context here");
+        expect(result).toContain("### Compressed");
+        expect(result).toContain("- **stevenic:** Do the thing");
+    });
+    it("returns plain bullets when no existing summary", () => {
+        const entries = [
+            { role: "user", text: "Hello" },
+        ];
+        const result = compressConversationEntries(entries, "");
+        expect(result).not.toContain("### Compressed");
+        expect(result).toBe("- **user:** Hello");
+    });
+    it("handles empty entries array", () => {
+        const result = compressConversationEntries([], "");
+        expect(result).toBe("");
+    });
+});

package/dist/cli.js

@@ -8,9 +8,9 @@
  *   teammates --dir <path>        Override .teammates/ location
  */
 import { exec as execCb, execSync, spawnSync } from "node:child_process";
-import { mkdirSync, readFileSync, writeFileSync } from "node:fs";
+import { existsSync, mkdirSync, readdirSync, readFileSync, writeFileSync, } from "node:fs";
 import { mkdir, readdir, rm, stat, unlink } from "node:fs/promises";
-import { dirname, join, resolve, sep } from "node:path";
+import { basename, dirname, join, resolve, sep } from "node:path";
 import { createInterface } from "node:readline";
 import { App, ChatView, concat, esc, pen, renderMarkdown, stripAnsi, } from "@teammates/consolonia";
 import chalk from "chalk";
@@ -18,7 +18,7 @@ import ora from "ora";
 import { DAILY_LOG_BUDGET_TOKENS, syncRecallIndex } from "./adapter.js";
 import { AnimatedBanner, } from "./banner.js";
 import { findTeammatesDir, PKG_VERSION, parseCliArgs, printUsage, resolveAdapter, } from "./cli-args.js";
-import { buildConversationContext as buildConvCtx, buildSummarizationPrompt, cleanResponseBody, findAtMention, findSummarizationSplit, isImagePath, relativeTime, wrapLine, } from "./cli-utils.js";
+import { buildConversationContext as buildConvCtx, buildSummarizationPrompt, cleanResponseBody, compressConversationEntries, findAtMention, findSummarizationSplit, formatConversationEntry, isImagePath, relativeTime, wrapLine, } from "./cli-utils.js";
 import { autoCompactForBudget, buildDailyCompressionPrompt, buildMigrationCompressionPrompt, buildWisdomPrompt, compactEpisodic, findUncompressedDailies, purgeStaleDailies, } from "./compact.js";
 import { PromptInput } from "./console/prompt-input.js";
 import { buildTitle } from "./console/startup.js";
@@ -121,8 +121,11 @@ class TeammatesREPL {
         if (this.chatView && cleaned) {
             const t = theme();
             const teammate = result.teammate;
-            const replyId = `reply-${teammate}-${Date.now()}`;
+            const ts = Date.now();
+            const replyId = `reply-${teammate}-${ts}`;
+            const copyId = `copy-${teammate}-${ts}`;
             this._replyContexts.set(replyId, { teammate, message: cleaned });
+            this._copyContexts.set(copyId, cleaned);
             this.chatView.appendActionList([
                 {
                     id: replyId,
@@ -136,7 +139,7 @@ class TeammatesREPL {
                     }),
                 },
                 {
-                    id: "copy",
+                    id: copyId,
                     normalStyle: this.makeSpan({
                         text: " [copy]",
                         style: { fg: t.textDim },
@@ -153,27 +156,25 @@ class TeammatesREPL {
         this.refreshTeammates();
         this.showPrompt();
     }
-    /** Token budget for recent conversation history (24k tokens ≈ 96k chars). */
-    static CONV_HISTORY_CHARS = 24_000 * 4;
-    /** Threshold (chars) above which conversation history is written to a temp file. */
-    static CONV_FILE_THRESHOLD = 8_000;
-    buildConversationContext() {
-        const context = buildConvCtx(this.conversationHistory, this.conversationSummary, TeammatesREPL.CONV_HISTORY_CHARS);
-        // If the conversation context is very long, write it to a temp file
-        // and return a pointer instead — reduces inline prompt noise.
-        if (context.length > TeammatesREPL.CONV_FILE_THRESHOLD) {
-            const tmpDir = join(this.teammatesDir, ".tmp");
-            mkdirSync(tmpDir, { recursive: true });
-            const convFile = join(tmpDir, "conversation.md");
-            writeFileSync(convFile, context, "utf-8");
-            return `## Conversation History\n\nThe full conversation history is in \`.teammates/.tmp/conversation.md\`. Read it before responding to understand prior context.`;
-        }
-        return context;
+    /** Target context window in tokens. Conversation history budget is derived from this. */
+    static TARGET_CONTEXT_TOKENS = 128_000;
+    /** Estimated tokens used by non-conversation prompt sections (identity, wisdom, logs, recall, instructions, task). */
+    static PROMPT_OVERHEAD_TOKENS = 32_000;
+    /** Chars-per-token approximation (matches adapter.ts). */
+    static CHARS_PER_TOKEN = 4;
+    /** Character budget for conversation history = (target − overhead) × chars/token. */
+    static CONV_HISTORY_CHARS = (TeammatesREPL.TARGET_CONTEXT_TOKENS -
+        TeammatesREPL.PROMPT_OVERHEAD_TOKENS) *
+        TeammatesREPL.CHARS_PER_TOKEN;
+    buildConversationContext(_teammate, snapshot) {
+        const history = snapshot ? snapshot.history : this.conversationHistory;
+        const summary = snapshot ? snapshot.summary : this.conversationSummary;
+        return buildConvCtx(history, summary, TeammatesREPL.CONV_HISTORY_CHARS);
     }
     /**
-     * Check if conversation history exceeds the 24k token budget.
+     * Check if conversation history exceeds the token budget.
      * If so, take the older entries that won't fit, combine with existing summary,
-     * and queue a summarization task to the coding agent.
+     * and queue a summarization task to the coding agent for high-quality compression.
      */
     maybeQueueSummarization() {
         const splitIdx = findSummarizationSplit(this.conversationHistory, TeammatesREPL.CONV_HISTORY_CHARS);
@@ -191,6 +192,23 @@ class TeammatesREPL {
         });
         this.kickDrain();
     }
+    /**
+     * Pre-dispatch compression: if conversation history exceeds the token budget,
+     * mechanically compress older entries into bullet summaries BEFORE building the
+     * prompt. This ensures the prompt always fits within the target context window,
+     * even if the async agent-quality summarization hasn't completed yet.
+     */
+    preDispatchCompress() {
+        const totalChars = this.conversationHistory.reduce((sum, e) => sum + formatConversationEntry(e.role, e.text).length, 0);
+        if (totalChars <= TeammatesREPL.CONV_HISTORY_CHARS)
+            return;
+        const splitIdx = findSummarizationSplit(this.conversationHistory, TeammatesREPL.CONV_HISTORY_CHARS);
+        if (splitIdx === 0)
+            return;
+        const toCompress = this.conversationHistory.slice(0, splitIdx);
+        this.conversationSummary = compressConversationEntries(toCompress, this.conversationSummary);
+        this.conversationHistory.splice(0, splitIdx);
+    }
     adapterName;
     teammatesDir;
     taskQueue = [];
@@ -214,6 +232,8 @@ class TeammatesREPL {
     ctrlcPending = false; // true after first Ctrl+C, waiting for second
     ctrlcTimer = null;
     lastCleanedOutput = ""; // last teammate output for clipboard copy
+    /** Maps copy action IDs to the cleaned output text for that response. */
+    _copyContexts = new Map();
     autoApproveHandoffs = false;
     /** Last debug log file path per teammate — for /debug analysis. */
     lastDebugFiles = new Map();
@@ -284,11 +304,12 @@ class TeammatesREPL {
         this.statusFrame = 0;
         this.statusRotateIndex = 0;
         this.renderStatusFrame();
-        // Animate spinner at ~80ms
+        // Animate spinner at ~200ms (fast enough for visual smoothness,
+        // slow enough to avoid saturating the render loop under load)
         this.statusTimer = setInterval(() => {
             this.statusFrame++;
             this.renderStatusFrame();
-        }, 80);
+        }, 200);
         // Rotate through teammates every 3 seconds
         this.statusRotateTimer = setInterval(() => {
             if (this.activeTasks.size > 1) {
@@ -375,7 +396,7 @@ class TeammatesREPL {
                 : cleanTask;
         if (this.chatView) {
             this.chatView.setProgress(concat(tp.accent(`${spinChar} ${displayName}... `), tp.muted(`${taskText}${suffix}`)));
-            this.app.refresh();
+            this.app.scheduleRefresh();
         }
         else {
             const spinColor = this.statusFrame % 8 === 0 ? chalk.blue : chalk.blueBright;
@@ -1122,8 +1143,14 @@ Do NOT modify any other teammate's files. Only edit your own SOUL.md and daily l
         if (everyoneMatch) {
             const task = everyoneMatch[1];
             const names = allNames.filter((n) => n !== this.selfName && n !== this.adapterName);
+            // Atomic snapshot: freeze conversation state ONCE so all agents see
+            // the same context regardless of concurrent preDispatchCompress mutations.
+            const contextSnapshot = {
+                history: this.conversationHistory.map((e) => ({ ...e })),
+                summary: this.conversationSummary,
+            };
             for (const teammate of names) {
-                this.taskQueue.push({ type: "agent", teammate, task });
+                this.taskQueue.push({ type: "agent", teammate, task, contextSnapshot });
             }
             const bg = this._userBg;
             const t = theme();
@@ -1271,6 +1298,8 @@ Do NOT modify any other teammate's files. Only edit your own SOUL.md and daily l
                     catch {
                         /* re-index failed — non-fatal, next startup will retry */
                     }
+                    // Persist version LAST — only after all migration tasks finish
+                    this.commitVersionUpdate();
                 }
             }
         }
@@ -1709,8 +1738,8 @@ Do NOT modify any other teammate's files. Only edit your own SOUL.md and daily l
         const userMdPath = join(teammatesDir, "USER.md");
         try {
             const content = readFileSync(userMdPath, "utf-8");
-            // Template placeholders contain "<your name>" — treat as not set up
-            return !content.trim() || content.includes("<your name>");
+            // Template placeholders contain "<Your name>" — treat as not set up
+            return !content.trim() || content.toLowerCase().includes("<your name>");
         }
         catch {
             // File doesn't exist
@@ -2112,9 +2141,51 @@ Do NOT modify any other teammate's files. Only edit your own SOUL.md and daily l
         compact: new Set([0]),
         debug: new Set([0]),
         retro: new Set([0]),
+        interrupt: new Set([0]),
+        int: new Set([0]),
     };
     /** Build param-completion items for the current line, if any. */
     getParamItems(cmdName, argsBefore, partial) {
+        // Script subcommand + name completion for /script
+        if (cmdName === "script") {
+            const completedArgs = argsBefore.trim()
+                ? argsBefore.trim().split(/\s+/).length
+                : 0;
+            const lower = partial.toLowerCase();
+            if (completedArgs === 0) {
+                // First arg — suggest subcommands
+                const subs = [
+                    { name: "list", desc: "List saved scripts" },
+                    { name: "run", desc: "Run an existing script" },
+                ];
+                return subs
+                    .filter((s) => s.name.startsWith(lower))
+                    .map((s) => ({
+                    label: s.name,
+                    description: s.desc,
+                    completion: `/script ${s.name} `,
+                }));
+            }
+            if (completedArgs === 1 && argsBefore.trim() === "run") {
+                // Second arg after "run" — suggest script filenames
+                const scriptsDir = join(this.teammatesDir, this.selfName, "scripts");
+                let files = [];
+                try {
+                    files = readdirSync(scriptsDir).filter((f) => !f.startsWith("."));
+                }
+                catch {
+                    // directory doesn't exist yet
+                }
+                return files
+                    .filter((f) => f.toLowerCase().startsWith(lower))
+                    .map((f) => ({
+                    label: f,
+                    description: "saved script",
+                    completion: `/script run ${f}`,
+                }));
+            }
+            return [];
+        }
         // Service name completion for /configure
         if (cmdName === "configure" || cmdName === "config") {
             const completedArgs = argsBefore.trim()
@@ -2703,8 +2774,9 @@ Do NOT modify any other teammate's files. Only edit your own SOUL.md and daily l
             if (id.startsWith("copy-cmd:")) {
                 this.doCopy(id.slice("copy-cmd:".length));
             }
-            else if (id === "copy") {
-                this.doCopy(this.lastCleanedOutput || undefined);
+            else if (id.startsWith("copy-")) {
+                const text = this._copyContexts.get(id);
+                this.doCopy(text || this.lastCleanedOutput || undefined);
             }
             else if (id.startsWith("retro-approve-") ||
                 id.startsWith("retro-reject-")) {
@@ -3212,7 +3284,7 @@ Do NOT modify any other teammate's files. Only edit your own SOUL.md and daily l
             {
                 name: "interrupt",
                 aliases: ["int"],
-                usage: "/interrupt <teammate> [message]",
+                usage: "/interrupt [teammate] [message]",
                 description: "Interrupt a running agent and resume with a steering message",
                 run: (args) => this.cmdInterrupt(args),
             },
@@ -3265,6 +3337,13 @@ Do NOT modify any other teammate's files. Only edit your own SOUL.md and daily l
                 description: "Ask a quick side question without interrupting the main conversation",
                 run: (args) => this.cmdBtw(args),
             },
+            {
+                name: "script",
+                aliases: [],
+                usage: "/script [description]",
+                description: "Write and run reusable scripts via the coding agent",
+                run: (args) => this.cmdScript(args),
+            },
             {
                 name: "theme",
                 aliases: [],
@@ -3536,7 +3615,7 @@ Do NOT modify any other teammate's files. Only edit your own SOUL.md and daily l
         this.refreshView();
     }
     /**
-     * /interrupt <teammate> [message] — Kill a running agent and resume with context.
+     * /interrupt [teammate] [message] — Kill a running agent and resume with context.
      */
     async cmdInterrupt(argsStr) {
         const parts = argsStr.trim().split(/\s+/);
@@ -3544,7 +3623,7 @@ Do NOT modify any other teammate's files. Only edit your own SOUL.md and daily l
         const steeringMessage = parts.slice(1).join(" ").trim() ||
             "Wrap up your current work and report what you've done so far.";
         if (!teammateName) {
-            this.feedLine(tp.warning("  Usage: /interrupt <teammate> [message]"));
+            this.feedLine(tp.warning("  Usage: /interrupt [teammate] [message]"));
             this.refreshView();
             return;
         }
@@ -3656,9 +3735,16 @@ Do NOT modify any other teammate's files. Only edit your own SOUL.md and daily l
             try {
                 {
                     // btw and debug tasks skip conversation context (not part of main thread)
-                    const extraContext = entry.type === "btw" || entry.type === "debug"
-                        ? ""
-                        : this.buildConversationContext();
+                    const isMainThread = entry.type !== "btw" && entry.type !== "debug";
+                    // Snapshot-aware context building: if the entry has a frozen snapshot
+                    // (@everyone), use it directly — no mutation of shared state.
+                    // Otherwise, compress live state as before.
+                    const snapshot = entry.type === "agent" ? entry.contextSnapshot : undefined;
+                    if (isMainThread && !snapshot)
+                        this.preDispatchCompress();
+                    const extraContext = isMainThread
+                        ? this.buildConversationContext(entry.teammate, snapshot)
+                        : "";
                     let result = await this.orchestrator.assign({
                         teammate: entry.teammate,
                         task: entry.task,
@@ -4307,6 +4393,14 @@ Issues that can't be resolved unilaterally — they need input from other teamma
                 }
             }
             this.pendingMigrationSyncs = migrationCount;
+            // If no migration tasks were actually queued, commit version now
+            if (migrationCount === 0) {
+                this.commitVersionUpdate();
+            }
+        }
+        else if (versionUpdate) {
+            // No migration needed — commit the version update immediately
+            this.commitVersionUpdate();
         }
         this.kickDrain();
         // 3. Purge daily logs older than 30 days (disk + Vectra)
@@ -4334,8 +4428,8 @@ Issues that can't be resolved unilaterally — they need input from other teamma
     }
     /**
      * Check if the CLI version has changed since last run.
-     * Updates settings.json with the current version.
-     * Returns the previous version if it changed, null otherwise.
+     * Does NOT update settings.json — call `commitVersionUpdate()` after
+     * migration tasks are complete to persist the new version.
      */
     checkVersionUpdate() {
         const settingsPath = join(this.teammatesDir, "settings.json");
@@ -4344,17 +4438,29 @@ Issues that can't be resolved unilaterally — they need input from other teamma
             settings = JSON.parse(readFileSync(settingsPath, "utf-8"));
         }
         catch {
-            // No settings file or invalid JSON — create one
+            // No settings file or invalid JSON
         }
         const previous = settings.cliVersion ?? "";
         const current = PKG_VERSION;
         if (previous === current)
             return null;
-        // Detect major/minor version change (not just patch)
-        const [prevMajor, prevMinor] = previous.split(".").map(Number);
-        const [curMajor, curMinor] = current.split(".").map(Number);
-        const isMajorMinor = previous !== "" && (prevMajor !== curMajor || prevMinor !== curMinor);
-        // Update the stored version
+        return { previous, current };
+    }
+    /**
+     * Persist the current CLI version to settings.json.
+     * Called after all migration tasks complete (or immediately if no migration needed).
+     */
+    commitVersionUpdate() {
+        const settingsPath = join(this.teammatesDir, "settings.json");
+        let settings = {};
+        try {
+            settings = JSON.parse(readFileSync(settingsPath, "utf-8"));
+        }
+        catch {
+            // No settings file or invalid JSON — create one
+        }
+        const previous = settings.cliVersion ?? "";
+        const current = PKG_VERSION;
         settings.cliVersion = current;
         if (!settings.version)
             settings.version = 1;
@@ -4364,12 +4470,15 @@ Issues that can't be resolved unilaterally — they need input from other teamma
         catch {
             /* write failed — non-fatal */
         }
+        // Detect major/minor version change (not just patch)
+        const [prevMajor, prevMinor] = previous.split(".").map(Number);
+        const [curMajor, curMinor] = current.split(".").map(Number);
+        const isMajorMinor = previous !== "" && (prevMajor !== curMajor || prevMinor !== curMinor);
         if (isMajorMinor) {
             this.feedLine(tp.accent(`  ✔  Updated from v${previous} → v${current}`));
             this.feedLine();
             this.refreshView();
         }
-        return { previous, current };
     }
     async cmdCopy() {
         this.doCopy(); // copies entire session
@@ -4524,6 +4633,116 @@ Issues that can't be resolved unilaterally — they need input from other teamma
         this.refreshView();
         this.kickDrain();
     }
+    async cmdScript(argsStr) {
+        const args = argsStr.trim();
+        const scriptsDir = join(this.teammatesDir, this.selfName, "scripts");
+        // /script (no args) — show usage
+        if (!args) {
+            this.feedLine();
+            this.feedLine(tp.bold("  /script — write and run reusable scripts"));
+            this.feedLine(tp.muted(`  ${"─".repeat(50)}`));
+            this.feedLine(concat(tp.accent("  /script list".padEnd(36)), tp.text("List saved scripts")));
+            this.feedLine(concat(tp.accent("  /script run <name>".padEnd(36)), tp.text("Run an existing script")));
+            this.feedLine(concat(tp.accent("  /script <description>".padEnd(36)), tp.text("Create and run a new script")));
+            this.feedLine();
+            this.feedLine(tp.muted(`  Scripts are saved to ${scriptsDir}`));
+            this.feedLine();
+            this.refreshView();
+            return;
+        }
+        // /script list — list saved scripts
+        if (args === "list") {
+            let files = [];
+            try {
+                files = readdirSync(scriptsDir).filter((f) => !f.startsWith("."));
+            }
+            catch {
+                // directory doesn't exist yet
+            }
+            this.feedLine();
+            if (files.length === 0) {
+                this.feedLine(tp.muted("  No scripts saved yet."));
+                this.feedLine(tp.muted("  Use /script <description> to create one."));
+            }
+            else {
+                this.feedLine(tp.bold("  Saved scripts"));
+                this.feedLine(tp.muted(`  ${"─".repeat(50)}`));
+                for (const f of files) {
+                    this.feedLine(concat(tp.accent(`  ${f}`)));
+                }
+            }
+            this.feedLine();
+            this.refreshView();
+            return;
+        }
+        // /script run <name> — run an existing script
+        if (args.startsWith("run ")) {
+            const name = args.slice(4).trim();
+            if (!name) {
+                this.feedLine(tp.muted("  Usage: /script run <name>"));
+                this.refreshView();
+                return;
+            }
+            // Find the script file (try exact match, then with common extensions)
+            const candidates = [
+                name,
+                `${name}.sh`,
+                `${name}.ts`,
+                `${name}.js`,
+                `${name}.ps1`,
+                `${name}.py`,
+            ];
+            let scriptPath = null;
+            for (const c of candidates) {
+                const p = join(scriptsDir, c);
+                if (existsSync(p)) {
+                    scriptPath = p;
+                    break;
+                }
+            }
+            if (!scriptPath) {
+                this.feedLine(tp.warning(`  Script not found: ${name}`));
+                this.feedLine(tp.muted("  Use /script list to see available scripts."));
+                this.refreshView();
+                return;
+            }
+            const scriptContent = readFileSync(scriptPath, "utf-8");
+            const task = `Run the following script located at ${scriptPath}:\n\n\`\`\`\n${scriptContent}\n\`\`\`\n\nExecute it and report the results. If it fails, diagnose the issue and fix it.`;
+            this.taskQueue.push({
+                type: "script",
+                teammate: this.selfName,
+                task,
+            });
+            this.feedLine(concat(tp.muted("  Running script "), tp.accent(basename(scriptPath)), tp.muted(" → "), tp.accent(`@${this.adapterName}`)));
+            this.feedLine();
+            this.refreshView();
+            this.kickDrain();
+            return;
+        }
+        // /script <description> — create and run a new script
+        const task = [
+            `The user wants a reusable script. Their request:`,
+            ``,
+            args,
+            ``,
+            `Instructions:`,
+            `1. Write the script and save it to the scripts directory: ${scriptsDir}`,
+            `2. Create the directory if it doesn't exist.`,
+            `3. Choose a short, descriptive filename (kebab-case, with appropriate extension like .sh, .ts, .js, .py, .ps1).`,
+            `4. Make the script executable if applicable.`,
+            `5. Run the script and report the results.`,
+            `6. If the script needs to be parameterized, use command-line arguments.`,
+        ].join("\n");
+        this.taskQueue.push({
+            type: "script",
+            teammate: this.selfName,
+            task,
+        });
+        this.feedLine(concat(tp.muted("  Script task → "), tp.accent(`@${this.adapterName}`)));
+        this.feedLine();
+        this.refreshView();
+        this.kickDrain();
+    }
     async cmdTheme() {
         const t = theme();
         this.feedLine();

package/dist/compact.js

@@ -84,6 +84,7 @@ function buildWeeklySummary(weekKey, dailies, partial = false) {
     const lastDate = sorted[sorted.length - 1].date;
     const lines = [];
     lines.push("---");
+    lines.push("version: 0.6.0");
     lines.push(`type: weekly`);
     lines.push(`week: ${weekKey}`);
     lines.push(`period: ${firstDate} to ${lastDate}`);
@@ -110,6 +111,7 @@ function buildMonthlySummary(monthKey, weeklies) {
     const lastWeek = sorted[sorted.length - 1].week;
     const lines = [];
     lines.push("---");
+    lines.push("version: 0.6.0");
     lines.push(`type: monthly`);
     lines.push(`month: ${monthKey}`);
     lines.push(`period: ${firstWeek} to ${lastWeek}`);
@@ -586,6 +588,8 @@ For EACH file listed below:
 5. Start the file with this frontmatter:
 \`\`\`
 ---
+version: 0.6.0
+type: daily
 compressed: true
 ---
 \`\`\`
@@ -650,6 +654,8 @@ Keep the same markdown structure (# date header, ## Task headers) but make each
 Write the compressed version to \`.teammates/${basename(teammateDir)}/memory/${yesterdayStr}.md\`. Start the file with this frontmatter:
 \`\`\`
 ---
+version: 0.6.0
+type: daily
 compressed: true
 ---
 \`\`\`

package/dist/onboard.js

@@ -108,6 +108,19 @@ async function isTeammateFolder(dirPath) {
         return false;
     }
 }
+/**
+ * Detect whether a teammate folder is a human avatar (**Type:** human in SOUL.md).
+ * Human avatars are user-specific and should not be imported to other projects.
+ */
+async function isHumanAvatar(dirPath) {
+    try {
+        const soul = await readFile(join(dirPath, "SOUL.md"), "utf-8");
+        return /\*\*Type:\*\*\s*human/i.test(soul);
+    }
+    catch {
+        return false;
+    }
+}
 /**
  * Import teammates from another project's .teammates/ dir.
  *
@@ -138,6 +151,9 @@ export async function importTeammates(sourceDir, targetDir) {
         if (entry.isDirectory() && !isNonTeammateEntry(entry.name)) {
             // Check if it's a teammate folder
             if (await isTeammateFolder(srcPath)) {
+                // Skip human avatar folders — those are user-specific, not team members
+                if (await isHumanAvatar(srcPath))
+                    continue;
                 // Skip if teammate already exists in target
                 try {
                     await stat(destPath);
@@ -165,18 +181,8 @@ export async function importTeammates(sourceDir, targetDir) {
                 teammates.push(entry.name);
             }
         }
-        else if (entry.isFile() && entry.name === "USER.md") {
-            // Only USER.md transfers — framework files (CROSS-TEAM.md, README.md,
-            // PROTOCOL.md, TEMPLATE.md) are project-specific and get created fresh
-            // from the template by copyTemplateFiles().
-            try {
-                await stat(destPath);
-            }
-            catch {
-                await copyFile(srcPath, destPath);
-                files.push(entry.name);
-            }
-        }
+        // USER.md is user-specific (gitignored) — never import it.
+        // The new user creates their own profile during setup.
     }
     // Ensure .gitignore exists
     const gitignoreDest = join(targetDir, ".gitignore");

package/dist/registry.js

@@ -100,8 +100,8 @@ async function loadDailyLogs(memoryDir) {
             // Only include daily logs (YYYY-MM-DD format), skip typed memory files
             if (!/^\d{4}-\d{2}-\d{2}$/.test(stem))
                 continue;
-            const content = await readFile(join(memoryDir, entry), "utf-8");
-            logs.push({ date: stem, content });
+            const raw = await readFile(join(memoryDir, entry), "utf-8");
+            logs.push({ date: stem, content: raw });
         }
         // Most recent first
         logs.sort((a, b) => b.date.localeCompare(a.date));
@@ -124,8 +124,8 @@ async function loadWeeklyLogs(memoryDir) {
             // Match YYYY-Wnn format
             if (!/^\d{4}-W\d{2}$/.test(stem))
                 continue;
-            const content = await readFile(join(weeklyDir, entry), "utf-8");
-            logs.push({ week: stem, content });
+            const raw = await readFile(join(weeklyDir, entry), "utf-8");
+            logs.push({ week: stem, content: raw });
         }
         // Most recent first
         logs.sort((a, b) => b.week.localeCompare(a.week));

package/dist/types.d.ts

@@ -124,6 +124,14 @@ export type QueueEntry = {
     task: string;
     system?: boolean;
     migration?: boolean;
+    /** Frozen conversation snapshot taken at queue time (used by @everyone). */
+    contextSnapshot?: {
+        history: {
+            role: string;
+            text: string;
+        }[];
+        summary: string;
+    };
 } | {
     type: "compact";
     teammate: string;
@@ -140,6 +148,10 @@ export type QueueEntry = {
     type: "debug";
     teammate: string;
     task: string;
+} | {
+    type: "script";
+    teammate: string;
+    task: string;
 } | {
     type: "summarize";
     teammate: string;

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@teammates/cli",
-  "version": "0.6.0",
+  "version": "0.6.2",
   "description": "Agent-agnostic CLI for teammates. Routes tasks, manages handoffs, and plugs into any coding agent backend.",
   "type": "module",
   "main": "dist/index.js",