npm - @teammates/cli - Versions diffs - 0.3.1 → 0.3.2 - Mend

@teammates/cli 0.3.1 → 0.3.2

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.

Files changed (19) hide show

package/dist/adapter.js +50 -50
package/dist/banner.d.ts +74 -0
package/dist/banner.js +284 -0
package/dist/cli-args.d.ts +19 -0
package/dist/cli-args.js +125 -0
package/dist/cli.js +286 -439
package/dist/index.d.ts +6 -1
package/dist/index.js +3 -0
package/dist/onboard.js +165 -165
package/dist/registry.test.js +23 -23
package/dist/theme.d.ts +13 -0
package/dist/theme.js +18 -0
package/dist/types.d.ts +30 -0
package/package.json +48 -48
package/template/CROSS-TEAM.md +31 -31
package/template/PROTOCOL.md +156 -156
package/template/README.md +48 -48
package/template/example/SOUL.md +82 -82
package/template/example/WISDOM.md +9 -9

package/dist/adapter.js CHANGED Viewed

@@ -125,66 +125,66 @@ export function buildTeammatePrompt(teammate, taskPrompt, options) {
     // ── Session state ────────────────────────────────────────────────
     if (options?.sessionFile) {
         parts.push("## Session State\n");
-        parts.push(`Your session file is at: \`${options.sessionFile}\`
-**Before returning your result**, 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.
+        parts.push(`Your session file is at: \`${options.sessionFile}\`
+**Before returning your result**, 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.
 `);
         parts.push("\n---\n");
     }
     // ── Memory updates ─────────────────────────────────────────────────
     const today = new Date().toISOString().slice(0, 10);
     parts.push("## Memory Updates\n");
-    parts.push(`**Before returning your result**, 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.
+    parts.push(`**Before returning your result**, 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.
 `);
     parts.push("\n---\n");
     // ── Output protocol ───────────────────────────────────────────────
     parts.push("## Output Protocol (CRITICAL)\n");
-    parts.push(`**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>
-\`\`\`
-**Handoffs:** To hand off work to a teammate, include a fenced handoff block anywhere in your response:
-\`\`\`
-\`\`\`handoff
-@<teammate>
-<task description — what you need them to do, with full context>
-\`\`\`
-\`\`\`
-**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.
-- Do as much work as you can before handing off.
-- Only hand off to teammates listed in "Your Team" above.
-- The handoff block can appear anywhere in your response — it will be detected automatically.
+    parts.push(`**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>
+\`\`\`
+**Handoffs:** To hand off work to a teammate, include a fenced handoff block anywhere in your response:
+\`\`\`
+\`\`\`handoff
+@<teammate>
+<task description — what you need them to do, with full context>
+\`\`\`
+\`\`\`
+**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.
+- Do as much work as you can before handing off.
+- Only hand off to teammates listed in "Your Team" above.
+- The handoff block can appear anywhere in your response — it will be detected automatically.
 `);
     parts.push("\n---\n");
     // ── Current date/time ────────────────────────────────────────────

package/dist/banner.d.ts ADDED Viewed

@@ -0,0 +1,74 @@
+/**
+ * Animated startup banner for @teammates/cli.
+ */
+import { type Constraint, Control, type DrawingContext, type Rect, type Size } from "@teammates/consolonia";
+export type ServiceStatus = "bundled" | "missing" | "not-configured" | "configured";
+export interface ServiceInfo {
+    name: string;
+    status: ServiceStatus;
+}
+export interface BannerInfo {
+    adapterName: string;
+    teammateCount: number;
+    cwd: string;
+    teammates: {
+        name: string;
+        role: string;
+    }[];
+    services: ServiceInfo[];
+}
+/**
+ * Custom banner widget that plays a reveal animation inside the
+ * consolonia rendering loop (alternate screen already active).
+ *
+ * Phases:
+ *  1. Reveal "teammates" letter by letter in block font
+ *  2. Collapse to "TM" + stats panel
+ *  3. Fade in teammate roster
+ *  4. Fade in command reference
+ */
+export declare class AnimatedBanner extends Control {
+    private _lines;
+    private _info;
+    private _phase;
+    private _inner;
+    private _timer;
+    private _onDirty;
+    private _word;
+    private _charIndex;
+    private _builtTop;
+    private _builtBot;
+    private _versionStr;
+    private _versionIndex;
+    private _revealIndex;
+    /** When true, the animation pauses after roster reveal (before commands). */
+    private _held;
+    private _finalLines;
+    private _rosterStart;
+    private _commandsStart;
+    private static GLYPHS;
+    constructor(info: BannerInfo);
+    /** Set a callback that fires when the banner needs a re-render. */
+    set onDirty(fn: () => void);
+    /** Start the animation sequence. */
+    start(): void;
+    private _buildFinalLines;
+    private _tick;
+    private _apply;
+    private _schedule;
+    /**
+     * Hold the animation — it will pause after the roster phase and
+     * not reveal the command reference until releaseHold() is called.
+     */
+    hold(): void;
+    /**
+     * Release the hold and continue to the commands phase.
+     * If the animation already reached the hold point, it resumes immediately.
+     */
+    releaseHold(): void;
+    /** Cancel any pending animation timer. */
+    dispose(): void;
+    measure(constraint: Constraint): Size;
+    arrange(rect: Rect): void;
+    render(ctx: DrawingContext): void;
+}

package/dist/banner.js ADDED Viewed

@@ -0,0 +1,284 @@
+/**
+ * Animated startup banner for @teammates/cli.
+ */
+import { Control, concat, StyledText, } from "@teammates/consolonia";
+import { PKG_VERSION } from "./cli-args.js";
+import { buildTitle } from "./console/startup.js";
+import { tp } from "./theme.js";
+// ─── Animated banner widget ─────────────────────────────────────────
+/**
+ * Custom banner widget that plays a reveal animation inside the
+ * consolonia rendering loop (alternate screen already active).
+ *
+ * Phases:
+ *  1. Reveal "teammates" letter by letter in block font
+ *  2. Collapse to "TM" + stats panel
+ *  3. Fade in teammate roster
+ *  4. Fade in command reference
+ */
+export class AnimatedBanner extends Control {
+    _lines = [];
+    _info;
+    _phase = "idle";
+    _inner;
+    _timer = null;
+    _onDirty = null;
+    // Spelling state
+    _word = "teammates";
+    _charIndex = 0;
+    _builtTop = "";
+    _builtBot = "";
+    _versionStr = ` v${PKG_VERSION}`;
+    _versionIndex = 0;
+    // Roster/command reveal state
+    _revealIndex = 0;
+    /** When true, the animation pauses after roster reveal (before commands). */
+    _held = false;
+    // The final lines (built once, revealed progressively)
+    _finalLines = [];
+    // Line index where roster starts and commands start
+    _rosterStart = 0;
+    _commandsStart = 0;
+    static GLYPHS = {
+        t: ["▀█▀", " █ "],
+        e: ["█▀▀", "██▄"],
+        a: ["▄▀█", "█▀█"],
+        m: ["█▀▄▀█", "█ ▀ █"],
+        s: ["█▀", "▄█"],
+    };
+    constructor(info) {
+        super();
+        this._info = info;
+        this._inner = new StyledText({ lines: [], wrap: true });
+        this.addChild(this._inner);
+        this._buildFinalLines();
+    }
+    /** Set a callback that fires when the banner needs a re-render. */
+    set onDirty(fn) {
+        this._onDirty = fn;
+    }
+    /** Start the animation sequence. */
+    start() {
+        this._phase = "spelling";
+        this._charIndex = 0;
+        this._builtTop = "";
+        this._builtBot = "";
+        this._tick();
+    }
+    _buildFinalLines() {
+        const info = this._info;
+        const [tmTop, tmBot] = buildTitle("tm");
+        const tmPad = " ".repeat(tmTop.length);
+        const gap = "   ";
+        const lines = [];
+        // TM logo row 1 + adapter info
+        lines.push(concat(tp.accent(tmTop), tp.text(gap + info.adapterName), tp.muted(` · ${info.teammateCount} teammate${info.teammateCount === 1 ? "" : "s"}`), tp.muted(` · v${PKG_VERSION}`)));
+        // TM logo row 2 + cwd
+        lines.push(concat(tp.accent(tmBot), tp.muted(gap + info.cwd)));
+        // 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 color = isBundledOrConfigured ? tp.success : tp.warning;
+            const label = svc.status === "bundled"
+                ? "bundled"
+                : svc.status === "configured"
+                    ? "configured"
+                    : svc.status === "not-configured"
+                        ? `not configured — /configure ${svc.name.toLowerCase()}`
+                        : `missing — /configure ${svc.name.toLowerCase()}`;
+            lines.push(concat(tp.text(tmPad + gap), color(icon), color(svc.name), tp.muted(` ${label}`)));
+        }
+        // blank
+        lines.push("");
+        this._rosterStart = lines.length;
+        // Teammate roster
+        for (const t of info.teammates) {
+            lines.push(concat(tp.accent("  ● "), tp.accent(`@${t.name}`.padEnd(14)), tp.muted(t.role)));
+        }
+        // blank
+        lines.push("");
+        this._commandsStart = lines.length;
+        // Command reference (must match printBanner normal-mode layout)
+        const col1 = [
+            ["@mention", "assign to teammate"],
+            ["text", "auto-route task"],
+            ["[image]", "drag & drop images"],
+        ];
+        const col2 = [
+            ["/status", "teammates & queue"],
+            ["/compact", "compact memory"],
+            ["/retro", "run retrospective"],
+        ];
+        const col3 = [
+            ["/copy", "copy session text"],
+            ["/help", "all commands"],
+            ["/exit", "exit session"],
+        ];
+        for (let i = 0; i < col1.length; i++) {
+            lines.push(concat(tp.accent(`  ${col1[i][0].padEnd(12)}`), tp.muted(col1[i][1].padEnd(22)), tp.accent(col2[i][0].padEnd(12)), tp.muted(col2[i][1].padEnd(22)), tp.accent(col3[i][0].padEnd(12)), tp.muted(col3[i][1])));
+        }
+        this._finalLines = lines;
+    }
+    _tick() {
+        switch (this._phase) {
+            case "spelling": {
+                const ch = this._word[this._charIndex];
+                const g = AnimatedBanner.GLYPHS[ch];
+                if (g) {
+                    if (this._builtTop.length > 0) {
+                        this._builtTop += " ";
+                        this._builtBot += " ";
+                    }
+                    this._builtTop += g[0];
+                    this._builtBot += g[1];
+                }
+                this._lines = [
+                    concat(tp.accent(this._builtTop)),
+                    concat(tp.accent(this._builtBot)),
+                ];
+                this._apply();
+                this._charIndex++;
+                if (this._charIndex >= this._word.length) {
+                    this._phase = "version";
+                    this._versionIndex = 0;
+                    this._schedule(60);
+                }
+                else {
+                    this._schedule(60);
+                }
+                break;
+            }
+            case "version": {
+                // Type out version string character by character on the bottom row
+                this._versionIndex++;
+                const partial = this._versionStr.slice(0, this._versionIndex);
+                this._lines = [
+                    concat(tp.accent(this._builtTop)),
+                    concat(tp.accent(this._builtBot), tp.muted(partial)),
+                ];
+                this._apply();
+                if (this._versionIndex >= this._versionStr.length) {
+                    this._phase = "pause";
+                    this._schedule(600);
+                }
+                else {
+                    this._schedule(60);
+                }
+                break;
+            }
+            case "pause": {
+                // Brief pause before transitioning to compact view
+                this._phase = "compact";
+                this._schedule(800);
+                break;
+            }
+            case "compact": {
+                // Switch to TM + stats — show first 4 lines of final
+                this._lines = this._finalLines.slice(0, 4);
+                this._apply();
+                this._phase = "roster";
+                this._revealIndex = 0;
+                this._schedule(80);
+                break;
+            }
+            case "roster": {
+                // Reveal roster lines one at a time
+                const end = this._rosterStart + this._revealIndex + 1;
+                this._lines = [
+                    ...this._finalLines.slice(0, this._rosterStart),
+                    ...this._finalLines.slice(this._rosterStart, end),
+                ];
+                this._apply();
+                this._revealIndex++;
+                const rosterCount = this._commandsStart - 1 - this._rosterStart; // -1 for blank line
+                if (this._revealIndex >= rosterCount) {
+                    if (this._held) {
+                        // Pause here until releaseHold() is called
+                        this._phase = "roster-held";
+                    }
+                    else {
+                        this._phase = "commands";
+                        this._revealIndex = 0;
+                        this._schedule(80);
+                    }
+                }
+                else {
+                    this._schedule(40);
+                }
+                break;
+            }
+            case "commands": {
+                // Add the blank line between roster and commands, then reveal commands
+                const rosterEnd = this._commandsStart; // includes the blank line
+                const cmdEnd = this._commandsStart + this._revealIndex + 1;
+                this._lines = [
+                    ...this._finalLines.slice(0, rosterEnd),
+                    ...this._finalLines.slice(this._commandsStart, cmdEnd),
+                ];
+                this._apply();
+                this._revealIndex++;
+                const cmdCount = this._finalLines.length - this._commandsStart;
+                if (this._revealIndex >= cmdCount) {
+                    this._phase = "done";
+                }
+                else {
+                    this._schedule(30);
+                }
+                break;
+            }
+        }
+    }
+    _apply() {
+        this._inner.lines = this._lines;
+        this.invalidate();
+        if (this._onDirty)
+            this._onDirty();
+    }
+    _schedule(ms) {
+        this._timer = setTimeout(() => {
+            this._timer = null;
+            this._tick();
+        }, ms);
+    }
+    /**
+     * Hold the animation — it will pause after the roster phase and
+     * not reveal the command reference until releaseHold() is called.
+     */
+    hold() {
+        this._held = true;
+    }
+    /**
+     * Release the hold and continue to the commands phase.
+     * If the animation already reached the hold point, it resumes immediately.
+     */
+    releaseHold() {
+        this._held = false;
+        // If we're waiting at the hold point, resume
+        if (this._phase === "roster-held") {
+            this._phase = "commands";
+            this._revealIndex = 0;
+            this._schedule(80);
+        }
+    }
+    /** Cancel any pending animation timer. */
+    dispose() {
+        if (this._timer) {
+            clearTimeout(this._timer);
+            this._timer = null;
+        }
+    }
+    // ── Layout delegation ───────────────────────────────────────────
+    measure(constraint) {
+        const size = this._inner.measure(constraint);
+        this.desiredSize = size;
+        return size;
+    }
+    arrange(rect) {
+        this.bounds = rect;
+        this._inner.arrange(rect);
+    }
+    render(ctx) {
+        this._inner.render(ctx);
+    }
+}

package/dist/cli-args.d.ts ADDED Viewed

@@ -0,0 +1,19 @@
+/**
+ * CLI argument parsing, version, and startup helpers for @teammates/cli.
+ */
+import type { AgentAdapter } from "./adapter.js";
+export declare const PKG_VERSION: string;
+export interface CliArgs {
+    showHelp: boolean;
+    modelOverride: string | undefined;
+    dirOverride: string | undefined;
+    adapterName: string;
+    agentPassthrough: string[];
+}
+export declare function parseCliArgs(argv?: string[]): CliArgs;
+export declare function findTeammatesDir(dirOverride: string | undefined): Promise<string | null>;
+export declare function resolveAdapter(name: string, opts?: {
+    modelOverride?: string;
+    agentPassthrough?: string[];
+}): Promise<AgentAdapter>;
+export declare function printUsage(): void;

package/dist/cli-args.js ADDED Viewed

@@ -0,0 +1,125 @@
+/**
+ * CLI argument parsing, version, and startup helpers for @teammates/cli.
+ */
+import { readFileSync } from "node:fs";
+import { stat } from "node:fs/promises";
+import { join, resolve } from "node:path";
+import chalk from "chalk";
+import { CliProxyAdapter, PRESETS } from "./adapters/cli-proxy.js";
+import { EchoAdapter } from "./adapters/echo.js";
+// ─── Version ─────────────────────────────────────────────────────────
+export const PKG_VERSION = (() => {
+    try {
+        const pkg = JSON.parse(readFileSync(new URL("../package.json", import.meta.url), "utf-8"));
+        return pkg.version ?? "0.0.0";
+    }
+    catch {
+        return "0.0.0";
+    }
+})();
+export function parseCliArgs(argv = process.argv.slice(2)) {
+    const args = [...argv];
+    function getFlag(name) {
+        const idx = args.indexOf(`--${name}`);
+        if (idx >= 0) {
+            args.splice(idx, 1);
+            return true;
+        }
+        return false;
+    }
+    function getOption(name) {
+        const idx = args.indexOf(`--${name}`);
+        if (idx >= 0 && idx + 1 < args.length) {
+            const val = args[idx + 1];
+            args.splice(idx, 2);
+            return val;
+        }
+        return undefined;
+    }
+    const showHelp = getFlag("help");
+    const modelOverride = getOption("model");
+    const dirOverride = getOption("dir");
+    const adapterName = args.shift() ?? "echo";
+    const agentPassthrough = [...args];
+    return {
+        showHelp,
+        modelOverride,
+        dirOverride,
+        adapterName,
+        agentPassthrough,
+    };
+}
+// ─── Helpers ─────────────────────────────────────────────────────────
+export async function findTeammatesDir(dirOverride) {
+    if (dirOverride)
+        return resolve(dirOverride);
+    let dir = process.cwd();
+    while (true) {
+        const candidate = join(dir, ".teammates");
+        try {
+            const s = await stat(candidate);
+            if (s.isDirectory())
+                return candidate;
+        }
+        catch {
+            /* keep looking */
+        }
+        const parent = resolve(dir, "..");
+        if (parent === dir)
+            break;
+        dir = parent;
+    }
+    return null;
+}
+export async function resolveAdapter(name, opts = {}) {
+    if (name === "echo")
+        return new EchoAdapter();
+    // GitHub Copilot SDK adapter — lazy-loaded to avoid pulling in
+    // @github/copilot-sdk (and vscode-jsonrpc) when not needed.
+    if (name === "copilot") {
+        const { CopilotAdapter } = await import("./adapters/copilot.js");
+        return new CopilotAdapter({
+            model: opts.modelOverride,
+        });
+    }
+    // All other adapters go through the CLI proxy
+    if (PRESETS[name]) {
+        return new CliProxyAdapter({
+            preset: name,
+            model: opts.modelOverride,
+            extraFlags: opts.agentPassthrough,
+        });
+    }
+    const available = ["echo", "copilot", ...Object.keys(PRESETS)].join(", ");
+    console.error(chalk.red(`Unknown adapter: ${name}`));
+    console.error(`Available adapters: ${available}`);
+    process.exit(1);
+}
+// ─── Usage ───────────────────────────────────────────────────────────
+export function printUsage() {
+    console.log(`
+${chalk.bold("@teammates/cli")} — Agent-agnostic teammate orchestrator
+${chalk.bold("Usage:")}
+  teammates <agent>          Launch session with an agent
+  teammates claude           Use Claude Code
+  teammates codex            Use OpenAI Codex
+  teammates aider            Use Aider
+${chalk.bold("Options:")}
+  --model <model>            Override the agent model
+  --dir <path>               Override .teammates/ location
+${chalk.bold("Agents:")}
+  claude     Claude Code CLI (requires 'claude' on PATH)
+  codex      OpenAI Codex CLI (requires 'codex' on PATH)
+  aider      Aider CLI (requires 'aider' on PATH)
+  echo       Test adapter — echoes prompts (no external agent)
+${chalk.bold("In-session:")}
+  @teammate <task>           Assign directly via @mention
+  <text>                     Auto-route to the best teammate
+  /status                    Session overview
+  /help                      All commands
+`.trim());
+}