@teammates/cli 0.2.2 → 0.2.3

package/dist/adapter.d.ts

@@ -24,6 +24,8 @@ export interface AgentAdapter {
      * Falls back to startSession if not implemented.
      */
     resumeSession?(teammate: TeammateConfig, sessionId: string): Promise<string>;
+    /** Get the session file path for a teammate (if session is active). */
+    getSessionFile?(teammateName: string): string | undefined;
     /** Clean up a session. */
     destroySession?(sessionId: string): Promise<void>;
     /**

package/dist/adapters/cli-proxy.d.ts

@@ -70,6 +70,7 @@ export declare class CliProxyAdapter implements AgentAdapter {
     startSession(teammate: TeammateConfig): Promise<string>;
     executeTask(_sessionId: string, teammate: TeammateConfig, prompt: string): Promise<TaskResult>;
     routeTask(task: string, roster: RosterEntry[]): Promise<string | null>;
+    getSessionFile(teammateName: string): string | undefined;
     destroySession(_sessionId: string): Promise<void>;
     /**
      * Spawn the agent, stream its output live, and capture it.

package/dist/adapters/cli-proxy.js

@@ -269,6 +269,9 @@ export class CliProxyAdapter {
             await unlink(promptFile).catch(() => { });
         }
     }
+    getSessionFile(teammateName) {
+        return this.sessionFiles.get(teammateName);
+    }
     async destroySession(_sessionId) {
         // Clean up any leaked temp prompt files
         for (const file of this.pendingTempFiles) {

package/dist/adapters/copilot.d.ts

@@ -42,6 +42,7 @@ export declare class CopilotAdapter implements AgentAdapter {
     startSession(teammate: TeammateConfig): Promise<string>;
     executeTask(_sessionId: string, teammate: TeammateConfig, prompt: string): Promise<TaskResult>;
     routeTask(task: string, roster: RosterEntry[]): Promise<string | null>;
+    getSessionFile(teammateName: string): string | undefined;
     destroySession(_sessionId: string): Promise<void>;
     /**
      * Ensure the CopilotClient is started.

package/dist/adapters/copilot.js

@@ -173,6 +173,9 @@ export class CopilotAdapter {
             await session.disconnect().catch(() => { });
         }
     }
+    getSessionFile(teammateName) {
+        return this.sessionFiles.get(teammateName);
+    }
     async destroySession(_sessionId) {
         // Disconnect all sessions
         for (const [, session] of this.sessions) {

package/dist/cli.js

@@ -8,7 +8,7 @@
  *   teammates --dir <path>        Override .teammates/ location
  */
 import { spawn as cpSpawn, exec as execCb, execSync, } from "node:child_process";
-import { readFileSync, writeFileSync } from "node:fs";
+import { appendFileSync, readFileSync, writeFileSync } from "node:fs";
 import { mkdir, readdir, rm, stat, unlink } from "node:fs/promises";
 import { tmpdir } from "node:os";
 import { join, resolve } from "node:path";
@@ -24,7 +24,7 @@ import { findAtMention, isImagePath, relativeTime, wrapLine, } from "./cli-utils
 import { compactEpisodic } from "./compact.js";
 import { PromptInput } from "./console/prompt-input.js";
 import { buildTitle } from "./console/startup.js";
-import { buildAdaptationPrompt, copyTemplateFiles, getOnboardingPrompt, importTeammates, } from "./onboard.js";
+import { buildImportAdaptationPrompt, copyTemplateFiles, getOnboardingPrompt, importTeammates, } from "./onboard.js";
 import { Orchestrator } from "./orchestrator.js";
 import { colorToHex, theme } from "./theme.js";
 // ─── Version ─────────────────────────────────────────────────────────
@@ -465,6 +465,28 @@ class TeammatesREPL {
     lastCleanedOutput = ""; // last teammate output for clipboard copy
     dispatching = false;
     autoApproveHandoffs = false;
+    /** Read .teammates/settings.json (returns { version, services, ... } or defaults). */
+    readSettings() {
+        try {
+            const raw = JSON.parse(readFileSync(join(this.teammatesDir, "settings.json"), "utf-8"));
+            return {
+                version: raw.version ?? 1,
+                services: Array.isArray(raw.services) ? raw.services : [],
+                ...raw,
+            };
+        }
+        catch {
+            return { version: 1, services: [] };
+        }
+    }
+    /** Write .teammates/settings.json. */
+    writeSettings(settings) {
+        writeFileSync(join(this.teammatesDir, "settings.json"), `${JSON.stringify(settings, null, 2)}\n`);
+    }
+    /** Check whether a specific service is installed. */
+    isServiceInstalled(name) {
+        return this.readSettings().services.some((s) => s.name === name);
+    }
     /** Pending handoffs awaiting user approval. */
     pendingHandoffs = [];
     /** Pending retro proposals awaiting user approval. */
@@ -1420,14 +1442,17 @@ Do NOT modify any other teammate's files. Only edit your own SOUL.md and daily l
                 chalk.cyan(teammates.join(", ")));
             console.log(chalk.gray(`    (${files.length} files copied)`));
             console.log();
+            // Copy framework files so the agent has TEMPLATE.md etc. available
+            await copyTemplateFiles(teammatesDir);
             // Ask if user wants the agent to adapt teammates to this codebase
             console.log(chalk.white("  Adapt teammates to this codebase?"));
-            console.log(chalk.gray("  The agent will update ownership patterns, file paths, and boundaries."));
+            console.log(chalk.gray("  The agent will scan this project, evaluate which teammates are needed,"));
+            console.log(chalk.gray("  adapt their files, and create any new teammates the project needs."));
             console.log(chalk.gray("  You can also do this later with /init."));
             console.log();
             const adapt = await this.askChoice("Adapt now? (y/n): ", ["y", "n"]);
             if (adapt === "y") {
-                await this.runAdaptationAgent(this.adapter, projectDir, teammates);
+                await this.runAdaptationAgent(this.adapter, projectDir, teammates, sourceDir);
             }
             else {
                 console.log(chalk.gray("  Skipped adaptation. Run /init to adapt later."));
@@ -1439,53 +1464,52 @@ Do NOT modify any other teammate's files. Only edit your own SOUL.md and daily l
         console.log();
     }
     /**
-     * Run the agent to adapt imported teammates' ownership/boundaries
-     * to the current codebase. Queues one task per teammate so the user
-     * can review and approve each adaptation individually.
+     * Run the agent to adapt imported teammates to the current codebase.
+     * Uses a single comprehensive session that scans the project, evaluates
+     * which teammates to keep/drop/create, adapts kept teammates (with
+     * Previous Projects sections), and creates any new teammates needed.
      */
-    async runAdaptationAgent(adapter, projectDir, teammateNames) {
+    async runAdaptationAgent(adapter, projectDir, teammateNames, sourceProjectPath) {
         const teammatesDir = join(projectDir, ".teammates");
         console.log();
-        console.log(chalk.blue("  Queuing adaptation tasks...") +
-            chalk.gray(` ${this.adapterName} will adapt each teammate individually`));
+        console.log(chalk.blue("  Starting adaptation...") +
+            chalk.gray(` ${this.adapterName} will scan this project and adapt the team`));
         console.log();
-        for (const name of teammateNames) {
-            const prompt = await buildAdaptationPrompt(teammatesDir, name);
-            const tempConfig = {
-                name: this.adapterName,
-                role: "Adaptation agent",
-                soul: "",
-                wisdom: "",
-                dailyLogs: [],
-                weeklyLogs: [],
-                ownership: { primary: [], secondary: [] },
-                routingKeywords: [],
-            };
-            const sessionId = await adapter.startSession(tempConfig);
-            const spinner = ora({
-                text: chalk.blue(this.adapterName) +
-                    chalk.gray(` is adapting @${name} to this codebase...`),
-                spinner: "dots",
-            }).start();
-            try {
-                const result = await adapter.executeTask(sessionId, tempConfig, prompt);
-                spinner.stop();
-                this.printAgentOutput(result.rawOutput);
-                if (result.success) {
-                    console.log(chalk.green(`  ✔ @${name} adaptation complete!`));
-                }
-                else {
-                    console.log(chalk.yellow(`  ⚠ @${name} adaptation finished with issues: ${result.summary}`));
-                }
-            }
-            catch (err) {
-                spinner.fail(chalk.red(`@${name} adaptation failed: ${err.message}`));
+        const prompt = await buildImportAdaptationPrompt(teammatesDir, teammateNames, sourceProjectPath);
+        const tempConfig = {
+            name: this.adapterName,
+            role: "Adaptation agent",
+            soul: "",
+            wisdom: "",
+            dailyLogs: [],
+            weeklyLogs: [],
+            ownership: { primary: [], secondary: [] },
+            routingKeywords: [],
+        };
+        const sessionId = await adapter.startSession(tempConfig);
+        const spinner = ora({
+            text: chalk.blue(this.adapterName) +
+                chalk.gray(" is scanning the project and adapting teammates..."),
+            spinner: "dots",
+        }).start();
+        try {
+            const result = await adapter.executeTask(sessionId, tempConfig, prompt);
+            spinner.stop();
+            this.printAgentOutput(result.rawOutput);
+            if (result.success) {
+                console.log(chalk.green("  ✔ Team adaptation complete!"));
             }
-            if (adapter.destroySession) {
-                await adapter.destroySession(sessionId);
+            else {
+                console.log(chalk.yellow(`  ⚠ Adaptation finished with issues: ${result.summary}`));
             }
-            console.log();
         }
+        catch (err) {
+            spinner.fail(chalk.red(`Adaptation failed: ${err.message}`));
+        }
+        if (adapter.destroySession) {
+            await adapter.destroySession(sessionId);
+        }
+        console.log();
     }
     /**
      * Simple blocking prompt — reads one line from stdin and validates.
@@ -1963,21 +1987,15 @@ Do NOT modify any other teammate's files. Only edit your own SOUL.md and daily l
                 return { name: t.name, role: t.role, ownership: t.ownership };
             });
         }
-        // Detect installed services from services.json and tell the adapter
+        // Detect installed services from settings.json and tell the adapter
         if ("services" in this.adapter) {
             const services = [];
-            try {
-                const svcJson = JSON.parse(readFileSync(join(this.teammatesDir, "services.json"), "utf-8"));
-                if (svcJson && "recall" in svcJson) {
-                    services.push({
-                        name: "recall",
-                        description: "Local semantic search across teammate memories and daily logs. Use this to find relevant context before starting a task.",
-                        usage: 'teammates-recall search "your query" --dir .teammates',
-                    });
-                }
-            }
-            catch {
-                /* no services.json or invalid */
+            if (this.isServiceInstalled("recall")) {
+                services.push({
+                    name: "recall",
+                    description: "Local semantic search across teammate memories and daily logs. Use this to find relevant context before starting a task.",
+                    usage: 'teammates-recall search "your query" --dir .teammates',
+                });
             }
             this.adapter.services = services;
         }
@@ -2034,14 +2052,7 @@ Do NOT modify any other teammate's files. Only edit your own SOUL.md and daily l
         // ── Build animated banner for ChatView ─────────────────────────────
         const names = this.orchestrator.listTeammates();
         const reg = this.orchestrator.getRegistry();
-        let hasRecall = false;
-        try {
-            const svcJson = JSON.parse(readFileSync(join(this.teammatesDir, "services.json"), "utf-8"));
-            hasRecall = !!(svcJson && "recall" in svcJson);
-        }
-        catch {
-            /* no services.json */
-        }
+        const hasRecall = this.isServiceInstalled("recall");
         const bannerWidget = new AnimatedBanner({
             adapterName: this.adapterName,
             teammateCount: names.length,
@@ -2432,15 +2443,8 @@ Do NOT modify any other teammate's files. Only edit your own SOUL.md and daily l
     printBanner(teammates) {
         const registry = this.orchestrator.getRegistry();
         const termWidth = process.stdout.columns || 100;
-        // Detect recall from services.json
-        let recallInstalled = false;
-        try {
-            const svcJson = JSON.parse(readFileSync(join(this.teammatesDir, "services.json"), "utf-8"));
-            recallInstalled = !!(svcJson && "recall" in svcJson);
-        }
-        catch {
-            /* no services.json or invalid */
-        }
+        // Detect recall from settings.json
+        const recallInstalled = this.isServiceInstalled("recall");
         this.feedLine();
         this.feedLine(concat(tp.bold("  Teammates"), tp.muted(` v${PKG_VERSION}`)));
         this.feedLine(concat(tp.text(`  ${this.adapterName}`), tp.muted(` · ${teammates.length} teammate${teammates.length === 1 ? "" : "s"}`)));
@@ -2782,45 +2786,61 @@ Do NOT modify any other teammate's files. Only edit your own SOUL.md and daily l
     }
     async cmdDebug(argsStr) {
         const arg = argsStr.trim().replace(/^@/, "");
-        // Resolve targets
-        let targets;
+        // Resolve which teammates to show debug info for
+        let targetNames;
         if (arg === "everyone") {
-            targets = [];
-            for (const [name, result] of this.lastResults) {
-                if (name !== this.adapterName && result.rawOutput) {
-                    targets.push({ name, result });
-                }
+            targetNames = [];
+            for (const [name] of this.lastResults) {
+                if (name !== this.adapterName)
+                    targetNames.push(name);
             }
-            if (targets.length === 0) {
-                this.feedLine(tp.muted("  No raw output available from any teammate."));
+            if (targetNames.length === 0) {
+                this.feedLine(tp.muted("  No debug info available from any teammate."));
                 this.refreshView();
                 return;
             }
         }
+        else if (arg) {
+            targetNames = [arg];
+        }
+        else if (this.lastResult) {
+            targetNames = [this.lastResult.teammate];
+        }
         else {
-            const result = arg ? this.lastResults.get(arg) : this.lastResult;
-            if (!result?.rawOutput) {
-                this.feedLine(tp.muted("  No raw output available." +
-                    (arg ? "" : " Try: /debug <teammate>")));
-                this.refreshView();
-                return;
-            }
-            targets = [{ name: result.teammate, result }];
+            this.feedLine(tp.muted("  No debug info available. Try: /debug [teammate]"));
+            this.refreshView();
+            return;
         }
-        for (const { name, result } of targets) {
-            this.feedLine();
-            this.feedLine(tp.muted(`  ── raw output from ${name} ──`));
+        let debugText = "";
+        for (const name of targetNames) {
             this.feedLine();
-            this.feedMarkdown(result.rawOutput);
+            this.feedLine(tp.muted(`  ── debug for ${name} ──`));
+            // Read the last debug entry from the session file
+            const sessionEntry = this.readLastDebugEntry(name);
+            if (sessionEntry) {
+                this.feedLine();
+                this.feedMarkdown(sessionEntry);
+                debugText += (debugText ? "\n\n" : "") + sessionEntry;
+            }
+            else {
+                // Fall back to raw output from lastResults
+                const result = this.lastResults.get(name);
+                if (result?.rawOutput) {
+                    this.feedLine();
+                    this.feedMarkdown(result.rawOutput);
+                    debugText += (debugText ? "\n\n" : "") + result.rawOutput;
+                }
+                else {
+                    this.feedLine(tp.muted("  No debug info available."));
+                }
+            }
             this.feedLine();
-            this.feedLine(tp.muted("  ── end raw output ──"));
+            this.feedLine(tp.muted("  ── end debug ──"));
         }
         // [copy] action for the debug output
-        if (this.chatView) {
+        if (this.chatView && debugText) {
             const t = theme();
-            this.lastCleanedOutput = targets
-                .map((t) => t.result.rawOutput)
-                .join("\n\n");
+            this.lastCleanedOutput = debugText;
             this.chatView.appendActionList([
                 {
                     id: "copy",
@@ -2838,6 +2858,28 @@ Do NOT modify any other teammate's files. Only edit your own SOUL.md and daily l
         this.feedLine();
         this.refreshView();
     }
+    /**
+     * Read the last debug entry from a teammate's session file.
+     * Debug entries are delimited by "## Debug — " headings.
+     */
+    readLastDebugEntry(teammate) {
+        try {
+            const sessionFile = this.adapter.getSessionFile?.(teammate);
+            if (!sessionFile)
+                return null;
+            const content = readFileSync(sessionFile, "utf-8");
+            // Split on debug entry headings and return the last one
+            const entries = content.split(/(?=^## Debug — )/m);
+            const last = entries[entries.length - 1];
+            if (last && last.startsWith("## Debug — ")) {
+                return last.trim();
+            }
+            return null;
+        }
+        catch {
+            return null;
+        }
+    }
     async cmdCancel(argsStr) {
         const n = parseInt(argsStr.trim(), 10);
         if (Number.isNaN(n) || n < 1 || n > this.taskQueue.length) {
@@ -2862,6 +2904,7 @@ Do NOT modify any other teammate's files. Only edit your own SOUL.md and daily l
                 break;
             const entry = this.taskQueue.splice(idx, 1)[0];
             this.agentActive.set(agent, entry);
+            const startTime = Date.now();
             try {
                 if (entry.type === "compact") {
                     await this.runCompact(entry.teammate);
@@ -2874,6 +2917,8 @@ Do NOT modify any other teammate's files. Only edit your own SOUL.md and daily l
                         task: entry.task,
                         extraContext: extraContext || undefined,
                     });
+                    // Write debug entry to session file
+                    this.writeDebugEntry(entry.teammate, entry.task, result, startTime);
                     // btw results are not stored in conversation history
                     if (entry.type !== "btw") {
                         this.storeResult(result);
@@ -2884,6 +2929,8 @@ Do NOT modify any other teammate's files. Only edit your own SOUL.md and daily l
                 }
             }
             catch (err) {
+                // Write error debug entry to session file
+                this.writeDebugEntry(entry.teammate, entry.task, null, startTime, err);
                 // Handle spawn failures, network errors, etc. gracefully
                 this.activeTasks.delete(agent);
                 if (this.activeTasks.size === 0)
@@ -2895,6 +2942,52 @@ Do NOT modify any other teammate's files. Only edit your own SOUL.md and daily l
             this.agentActive.delete(agent);
         }
     }
+    /**
+     * Append a debug entry to the teammate's session file.
+     * Captures task prompt, result summary, raw output, timing, and errors.
+     */
+    writeDebugEntry(teammate, task, result, startTime, error) {
+        try {
+            const sessionFile = this.adapter.getSessionFile?.(teammate);
+            if (!sessionFile)
+                return;
+            const elapsed = ((Date.now() - startTime) / 1000).toFixed(1);
+            const timestamp = new Date().toISOString();
+            const lines = [
+                "",
+                `## Debug — ${timestamp}`,
+                "",
+                `**Duration:** ${elapsed}s`,
+                `**Task:** ${task.length > 200 ? `${task.slice(0, 200)}…` : task}`,
+                "",
+            ];
+            if (error) {
+                lines.push(`**Status:** ERROR`);
+                lines.push(`**Error:** ${error?.message ?? String(error)}`);
+            }
+            else if (result) {
+                lines.push(`**Status:** ${result.success ? "OK" : "FAILED"}`);
+                lines.push(`**Summary:** ${result.summary || "(no summary)"}`);
+                if (result.changedFiles.length > 0) {
+                    lines.push(`**Changed files:** ${result.changedFiles.join(", ")}`);
+                }
+                if (result.handoffs.length > 0) {
+                    lines.push(`**Handoffs:** ${result.handoffs.map((h) => `@${h.to}`).join(", ")}`);
+                }
+                lines.push("");
+                lines.push("<details><summary>Raw output</summary>");
+                lines.push("");
+                lines.push(result.rawOutput ?? "(empty)");
+                lines.push("");
+                lines.push("</details>");
+            }
+            lines.push("");
+            appendFileSync(sessionFile, lines.join("\n"), "utf-8");
+        }
+        catch {
+            // Don't let debug logging break task execution
+        }
+    }
     async cmdInit(argsStr) {
         const cwd = process.cwd();
         const teammatesDir = join(cwd, ".teammates");
@@ -2924,16 +3017,16 @@ Do NOT modify any other teammate's files. Only edit your own SOUL.md and daily l
                     return;
                 }
                 this.feedLine(tp.success(`  Imported ${teammates.length} teammate${teammates.length > 1 ? "s" : ""}: ${teammates.join(", ")} (${files.length} files)`));
-                // Queue one adaptation task per teammate
-                this.feedLine(tp.muted(`  Queuing ${this.adapterName} to adapt each teammate individually...`));
-                for (const name of teammates) {
-                    const prompt = await buildAdaptationPrompt(teammatesDir, name);
-                    this.taskQueue.push({
-                        type: "agent",
-                        teammate: this.adapterName,
-                        task: prompt,
-                    });
-                }
+                // Copy framework files so the agent has TEMPLATE.md etc. available
+                await copyTemplateFiles(teammatesDir);
+                // Queue a single adaptation task that handles all teammates
+                this.feedLine(tp.muted(`  Queuing ${this.adapterName} to scan this project and adapt the team...`));
+                const prompt = await buildImportAdaptationPrompt(teammatesDir, teammates, sourceDir);
+                this.taskQueue.push({
+                    type: "agent",
+                    teammate: this.adapterName,
+                    task: prompt,
+                });
                 this.kickDrain();
             }
             catch (err) {
@@ -3022,19 +3115,12 @@ Do NOT modify any other teammate's files. Only edit your own SOUL.md and daily l
             return;
         }
         this.feedLine(tp.success(`  ✔ ${serviceName} installed successfully`));
-        // Register in services.json
-        const svcPath = join(this.teammatesDir, "services.json");
-        let svcJson = {};
-        try {
-            svcJson = JSON.parse(readFileSync(svcPath, "utf-8"));
-        }
-        catch {
-            /* new file */
-        }
-        if (!(serviceName in svcJson)) {
-            svcJson[serviceName] = {};
-            writeFileSync(svcPath, `${JSON.stringify(svcJson, null, 2)}\n`);
-            this.feedLine(tp.muted(`  Registered in services.json`));
+        // Register in settings.json
+        const settings = this.readSettings();
+        if (!settings.services.some((s) => s.name === serviceName)) {
+            settings.services.push({ name: serviceName });
+            this.writeSettings(settings);
+            this.feedLine(tp.muted(`  Registered in settings.json`));
         }
         // Build initial index if this service supports it
         if (service.indexCmd) {
@@ -3133,15 +3219,9 @@ Do NOT modify any other teammate's files. Only edit your own SOUL.md and daily l
             .catch(() => { });
     }
     startRecallWatch() {
-        // Only start if recall is installed (check services.json)
-        try {
-            const svcJson = JSON.parse(readFileSync(join(this.teammatesDir, "services.json"), "utf-8"));
-            if (!svcJson || !("recall" in svcJson))
-                return;
-        }
-        catch {
-            return; // No services.json — recall not installed
-        }
+        // Only start if recall is installed (check settings.json)
+        if (!this.isServiceInstalled("recall"))
+            return;
         try {
             this.recallWatchProcess = cpSpawn("teammates-recall", ["watch", "--dir", this.teammatesDir, "--json"], {
                 stdio: ["ignore", "ignore", "ignore"],
@@ -3245,9 +3325,8 @@ Do NOT modify any other teammate's files. Only edit your own SOUL.md and daily l
             if (this.chatView)
                 this.chatView.setProgress(null);
             // Trigger recall sync if installed
-            try {
-                const svcJson = JSON.parse(readFileSync(join(this.teammatesDir, "services.json"), "utf-8"));
-                if (svcJson && "recall" in svcJson) {
+            if (this.isServiceInstalled("recall")) {
+                try {
                     if (this.chatView) {
                         this.chatView.setProgress(`Syncing ${name} index...`);
                         this.refreshView();
@@ -3267,9 +3346,9 @@ Do NOT modify any other teammate's files. Only edit your own SOUL.md and daily l
                         this.feedLine(tp.success(`  ✔ ${name}: index synced`));
                     }
                 }
-            }
-            catch {
-                /* recall not installed or sync failed — non-fatal */
+                catch {
+                    /* sync failed — non-fatal */
+                }
             }
         }
         catch (err) {
@@ -3394,14 +3473,7 @@ Issues that can't be resolved unilaterally — they need input from other teamma
         if (teammates.length === 0)
             return;
         // Check if recall is installed
-        let recallInstalled = false;
-        try {
-            const svcJson = JSON.parse(readFileSync(join(this.teammatesDir, "services.json"), "utf-8"));
-            recallInstalled = !!(svcJson && "recall" in svcJson);
-        }
-        catch {
-            /* no services.json */
-        }
+        const recallInstalled = this.isServiceInstalled("recall");
         // 1. Check each teammate for stale daily logs (older than 7 days)
         const oneWeekAgo = new Date();
         oneWeekAgo.setDate(oneWeekAgo.getDate() - 7);

package/dist/onboard.d.ts

@@ -28,14 +28,19 @@ export declare function importTeammates(sourceDir: string, targetDir: string): P
     files: string[];
 }>;
 /**
- * Build the adaptation prompt for a single imported teammate.
- * Tells the agent to update ownership patterns, file paths, and boundaries
- * for the new codebase while preserving identity, principles, and wisdom.
+ * Build a comprehensive import-adaptation prompt that runs as a single agent session.
+ * The agent will:
+ * 1. Scan the current project
+ * 2. Evaluate which imported teammates are needed
+ * 3. Adapt kept teammates (add Previous Projects section + rewrite for new project)
+ * 4. Create any new teammates the project needs
+ * 5. Remove teammates that don't apply
  *
  * @param teammatesDir - The .teammates/ directory in the target project
- * @param teammateName - The name of the teammate to adapt
+ * @param teammateNames - Names of all imported teammates
+ * @param sourceProjectPath - Path to the source project (for Previous Projects section)
  */
-export declare function buildAdaptationPrompt(teammatesDir: string, teammateName: string): Promise<string>;
+export declare function buildImportAdaptationPrompt(teammatesDir: string, teammateNames: string[], sourceProjectPath: string): Promise<string>;
 /**
  * Load ONBOARDING.md from the project dir, package root, or built-in fallback.
  */

package/dist/onboard.js

@@ -60,7 +60,7 @@ export async function copyTemplateFiles(teammatesDir) {
         await stat(gitignoreDest);
     }
     catch {
-        const gitignoreContent = "USER.md\n.index/\n";
+        const gitignoreContent = "USER.md\n.*/\n";
         const { writeFile } = await import("node:fs/promises");
         await writeFile(gitignoreDest, gitignoreContent, "utf-8");
         copied.push(".gitignore");
@@ -92,7 +92,7 @@ export async function copyTemplateFiles(teammatesDir) {
  * Directories starting with "_" are shared non-teammate folders.
  * Files (non-directories) and special names are also excluded.
  */
-const NON_TEAMMATE_NAMES = new Set(["example", "services.json"]);
+const NON_TEAMMATE_NAMES = new Set(["example", "settings.json"]);
 function isNonTeammateEntry(name) {
     return (name.startsWith(".") || name.startsWith("_") || NON_TEAMMATE_NAMES.has(name));
 }
@@ -182,66 +182,146 @@ export async function importTeammates(sourceDir, targetDir) {
         await stat(gitignoreDest);
     }
     catch {
-        await writeFile(gitignoreDest, "USER.md\n.index/\n", "utf-8");
+        await writeFile(gitignoreDest, "USER.md\n.*/\n", "utf-8");
         files.push(".gitignore");
     }
     return { teammates, files };
 }
 /**
- * Build the adaptation prompt for a single imported teammate.
- * Tells the agent to update ownership patterns, file paths, and boundaries
- * for the new codebase while preserving identity, principles, and wisdom.
+ * Build a comprehensive import-adaptation prompt that runs as a single agent session.
+ * The agent will:
+ * 1. Scan the current project
+ * 2. Evaluate which imported teammates are needed
+ * 3. Adapt kept teammates (add Previous Projects section + rewrite for new project)
+ * 4. Create any new teammates the project needs
+ * 5. Remove teammates that don't apply
  *
  * @param teammatesDir - The .teammates/ directory in the target project
- * @param teammateName - The name of the teammate to adapt
+ * @param teammateNames - Names of all imported teammates
+ * @param sourceProjectPath - Path to the source project (for Previous Projects section)
  */
-export async function buildAdaptationPrompt(teammatesDir, teammateName) {
-    const teammateDir = join(teammatesDir, teammateName);
-    // Read the teammate's current SOUL.md and WISDOM.md
-    let soulContent = "";
-    let wisdomContent = "";
-    try {
-        soulContent = await readFile(join(teammateDir, "SOUL.md"), "utf-8");
-    }
-    catch {
-        /* missing — agent will create from scratch */
-    }
-    try {
-        wisdomContent = await readFile(join(teammateDir, "WISDOM.md"), "utf-8");
-    }
-    catch {
-        /* missing — that's fine */
+export async function buildImportAdaptationPrompt(teammatesDir, teammateNames, sourceProjectPath) {
+    const teammateSections = [];
+    for (const name of teammateNames) {
+        const dir = join(teammatesDir, name);
+        let soulContent = "";
+        let wisdomContent = "";
+        try {
+            soulContent = await readFile(join(dir, "SOUL.md"), "utf-8");
+        }
+        catch {
+            /* missing */
+        }
+        try {
+            wisdomContent = await readFile(join(dir, "WISDOM.md"), "utf-8");
+        }
+        catch {
+            /* missing */
+        }
+        const soulBlock = soulContent
+            ? `**SOUL.md:**\n\`\`\`markdown\n${soulContent}\n\`\`\``
+            : "*No SOUL.md found*";
+        const wisdomBlock = wisdomContent
+            ? `\n**WISDOM.md:**\n\`\`\`markdown\n${wisdomContent}\n\`\`\``
+            : "";
+        teammateSections.push(`### @${name}\n${soulBlock}${wisdomBlock}`);
     }
-    const soulSection = soulContent
-        ? `\n\n## Current SOUL.md\n\n\`\`\`markdown\n${soulContent}\n\`\`\``
-        : "\n\n*No SOUL.md found — create one from the template.*";
-    const wisdomSection = wisdomContent
-        ? `\n\n## Current WISDOM.md\n\n\`\`\`markdown\n${wisdomContent}\n\`\`\``
-        : "";
-    return `You are adapting the imported teammate **${teammateName}** to this new codebase.
+    const projectDir = dirname(teammatesDir);
+    return `You are adapting an imported team to a new project.
+
+**Source project:** \`${sourceProjectPath}\`
+**Target project:** \`${projectDir}\`
+**Target .teammates/ directory:** \`${teammatesDir}\`
+**Imported teammates:** ${teammateNames.map((n) => `@${n}`).join(", ")}
+
+## Imported Teammates (from source project)
+
+${teammateSections.join("\n\n---\n\n")}
 
-**Teammate directory:** \`${teammateDir}\`
+## Instructions
 
-This teammate was imported from another project. Their SOUL.md and WISDOM.md contain identity, principles, and accumulated wisdom that should be preserved, but their **ownership patterns**, **file paths**, **boundaries**, **capabilities**, and **routing keywords** need to be updated for this codebase.
-${soulSection}${wisdomSection}
+Work through these phases in order. **Pause after Phase 1 and Phase 2** to present your analysis and get user approval before making changes.
 
-## Your job:
+### Phase 1: Scan This Project
 
-1. **Analyze this codebase** — read the project structure, entry points, package manifest, and key files to understand the architecture.
+Analyze the current project to understand its structure:
+- Read the project root: package manifest, README, config files
+- Identify major subsystems, languages, frameworks, file patterns
+- Understand the dependency flow and architecture
 
-2. **Update ${teammateName}'s SOUL.md**:
-   - **Preserve**: Identity, Core Principles, Ethics, personality, tone
-   - **Update**: Ownership patterns (primary/secondary file globs), Boundaries (reference correct teammate names), Capabilities (commands, file patterns, technologies), Routing keywords, Quality Bar
-   - **Adapt**: Any codebase-specific references (paths, package names, tools)
+**Present your analysis to the user and wait for confirmation.**
 
-3. **Update ${teammateName}'s WISDOM.md**:
-   - **Preserve**: Wisdom entries that are universal (principles, patterns, lessons)
-   - **Remove or update**: Entries referencing old project paths, file names, or architecture
-   - **Add**: A creation entry noting this teammate was imported and adapted
+### Phase 2: Evaluate Imported Teammates
 
-4. **Verify** that ownership globs are valid for this codebase.
+For each imported teammate, decide:
+- **KEEP** — their domain or expertise is relevant to this project (even if specific details need updating)
+- **DROP** — their domain doesn't exist here and their skills aren't transferable
 
-Present your proposed changes before applying them. Focus only on **${teammateName}** — other teammates will be adapted separately.`;
+Also identify **gaps** — major subsystems in this project that none of the imported teammates cover. Propose new teammates for these gaps.
+
+**Present your evaluation as a structured plan and wait for user approval:**
+\`\`\`
+KEEP: @name1, @name2
+DROP: @name3
+CREATE: @newname (role description)
+\`\`\`
+
+### Phase 3: Adapt Kept Teammates
+
+For each KEEP teammate, edit their SOUL.md and WISDOM.md:
+
+1. **Add a "Previous Projects" section** to SOUL.md (place it after Ethics, before any appendix). Compress what the teammate did in the source project into a portable summary:
+   \`\`\`markdown
+   ## Previous Projects
+
+   ### <project-name>
+   - **Role**: <one-line summary of what they did>
+   - **Stack**: <key technologies they worked with>
+   - **Domains**: <what they owned — file patterns or subsystem names>
+   - **Key learnings**: <1-3 bullets of notable patterns, decisions, or lessons>
+   \`\`\`
+
+2. **Rewrite the rest of SOUL.md** for this project:
+   - **Preserve**: Identity (name, personality), Core Principles, Ethics
+   - **Rewrite**: Ownership (primary/secondary file globs for THIS project), Boundaries, Capabilities (commands, file patterns, technologies), Routing keywords, Quality Bar
+   - **Update**: Any codebase-specific references (paths, package names, tools, teammate names)
+
+3. **Update WISDOM.md**:
+   - **Add** a "Previous Projects" section at the top with a compressed note:
+     \`\`\`markdown
+     ## Previous Projects
+
+     ### <project-name>
+     - Carried over universal wisdom entries from the source project
+     - Project-specific entries removed or adapted
+     \`\`\`
+   - **Keep** wisdom entries that are universal (general principles, patterns, lessons)
+   - **Remove** entries that reference source project paths, architecture, or tools not used here
+   - **Adapt** entries with transferable knowledge but old-project-specific details
+
+### Phase 4: Handle Dropped Teammates
+
+For each DROP teammate, delete their directory under \`${teammatesDir}\`.
+
+### Phase 5: Create New Teammates
+
+For each new teammate proposed in Phase 2 (after user approval):
+- Create \`${teammatesDir}/<name>/\` with SOUL.md, WISDOM.md, and \`memory/\`
+- Use the template at \`${teammatesDir}/TEMPLATE.md\` for structure
+- WISDOM.md starts with one creation entry
+
+### Phase 6: Update Framework Files
+
+- Update \`${teammatesDir}/README.md\` with the final roster
+- Update \`${teammatesDir}/CROSS-TEAM.md\` ownership table
+
+### Phase 7: Verify
+
+- Every kept/new teammate has SOUL.md and WISDOM.md
+- Ownership globs cover the codebase without major gaps
+- Boundaries reference the correct owning teammate
+- Previous Projects sections are present for all imported teammates
+- CROSS-TEAM.md has one row per teammate`;
 }
 /**
  * Load ONBOARDING.md from the project dir, package root, or built-in fallback.

package/dist/registry.js

@@ -5,7 +5,7 @@
  * (SOUL.md, WISDOM.md, daily logs, ownership rules).
  */
 import { readdir, readFile, stat } from "node:fs/promises";
-import { basename, join } from "node:path";
+import { basename, dirname, join } from "node:path";
 export class Registry {
     teammatesDir;
     teammates = new Map();
@@ -50,6 +50,7 @@ export class Registry {
             weeklyLogs,
             ownership,
             routingKeywords,
+            cwd: dirname(this.teammatesDir),
         };
         this.teammates.set(name, config);
         return config;

package/package.json

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