@teammates/cli 0.5.0 → 0.5.2

package/dist/index.js

@@ -1,5 +1,6 @@
 // Public API for @teammates/cli
-export { buildTeammatePrompt, formatHandoffContext, queryRecallContext, syncRecallIndex, } from "./adapter.js";
+export { buildTeammatePrompt, DAILY_LOG_BUDGET_TOKENS, formatHandoffContext, queryRecallContext, syncRecallIndex, } from "./adapter.js";
+export { autoCompactForBudget } from "./compact.js";
 export { CliProxyAdapter, PRESETS, } from "./adapters/cli-proxy.js";
 export { EchoAdapter } from "./adapters/echo.js";
 export { AnimatedBanner } from "./banner.js";

package/dist/onboard.js

@@ -225,82 +225,82 @@ export async function buildImportAdaptationPrompt(teammatesDir, teammateNames, s
         teammateSections.push(`### @${name}\n${soulBlock}${wisdomBlock}`);
     }
     const projectDir = dirname(teammatesDir);
-    return `You are adapting an imported team to a new project. This is a non-interactive session — complete ALL work without pausing. Do not ask for confirmation or wait for user input.
-
-**Source project:** \`${sourceProjectPath}\`
-**Target project:** \`${projectDir}\`
-**Target .teammates/ directory:** \`${teammatesDir}\`
-**Imported teammates:** ${teammateNames.map((n) => `@${n}`).join(", ")}
-
-> **IMPORTANT:** The \`example/\` directory inside \`.teammates/\` is a **template reference**, NOT a teammate. Do not adapt it, rename it, or treat it as a teammate. When creating new teammates, never use "example" as a folder name.
-
-## Imported Teammates (from source project)
-
-${teammateSections.join("\n\n---\n\n")}
-
-## Instructions
-
-Complete these steps in order. Do NOT pause, ask questions, or wait for approval. Make all changes directly.
-
-### Step 1: Scan This Project
-
-Read the project root to understand its structure:
-- Package manifest, README, config files
-- Major subsystems, languages, frameworks, file patterns
-- Dependency flow and architecture
-
-### Step 2: Adapt EVERY Imported Teammate
-
-This is the most important step. For EACH imported teammate listed above, you MUST edit their SOUL.md and WISDOM.md to reflect THIS project, not the source project.
-
-For each teammate's **SOUL.md**:
-
-1. **Add a "Previous Projects" section** (place it after Ethics). Compress what the teammate did in the source project:
-   \`\`\`markdown
-   ## Previous Projects
-
-   ### <source-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 project-specific sections** for THIS project:
-   - **Preserve**: Identity (name, personality), Core Principles, Ethics
-   - **Rewrite completely**: Ownership (primary/secondary file globs for THIS project's actual files), Boundaries, Capabilities (commands, file patterns, technologies for THIS project), Routing keywords, Quality Bar
-   - **Update**: All codebase-specific references — paths, package names, tools, teammate names must reference THIS project
-
-For each teammate's **WISDOM.md**:
-- Add a "Previous Projects" note at the top
-- Keep universal wisdom entries (general principles, patterns)
-- Remove entries that reference source project paths, architecture, or tools not used here
-- Adapt entries with transferable knowledge but old-project-specific details
-
-### Step 3: Evaluate Gaps and Create New Teammates
-
-After adapting all existing teammates, check if THIS project has major subsystems that no teammate covers. If so, create new teammates:
-- 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
-
-If a teammate's domain doesn't exist at all in this project and their skills aren't transferable, delete their directory under \`${teammatesDir}\`.
-
-### Step 4: Update Framework Files
-
-- Update \`${teammatesDir}/README.md\` with the final roster
-- Update \`${teammatesDir}/CROSS-TEAM.md\` ownership table
-
-### Step 5: Verify
-
-- Every teammate has SOUL.md and WISDOM.md adapted to THIS project
-- Ownership globs reference actual files in THIS project
-- Boundaries reference correct teammate names
-- Previous Projects sections are present for all imported teammates
-- CROSS-TEAM.md has one row per teammate
-
-## Critical Reminder
-
+    return `You are adapting an imported team to a new project. This is a non-interactive session — complete ALL work without pausing. Do not ask for confirmation or wait for user input.
+
+**Source project:** \`${sourceProjectPath}\`
+**Target project:** \`${projectDir}\`
+**Target .teammates/ directory:** \`${teammatesDir}\`
+**Imported teammates:** ${teammateNames.map((n) => `@${n}`).join(", ")}
+
+> **IMPORTANT:** The \`example/\` directory inside \`.teammates/\` is a **template reference**, NOT a teammate. Do not adapt it, rename it, or treat it as a teammate. When creating new teammates, never use "example" as a folder name.
+
+## Imported Teammates (from source project)
+
+${teammateSections.join("\n\n---\n\n")}
+
+## Instructions
+
+Complete these steps in order. Do NOT pause, ask questions, or wait for approval. Make all changes directly.
+
+### Step 1: Scan This Project
+
+Read the project root to understand its structure:
+- Package manifest, README, config files
+- Major subsystems, languages, frameworks, file patterns
+- Dependency flow and architecture
+
+### Step 2: Adapt EVERY Imported Teammate
+
+This is the most important step. For EACH imported teammate listed above, you MUST edit their SOUL.md and WISDOM.md to reflect THIS project, not the source project.
+
+For each teammate's **SOUL.md**:
+
+1. **Add a "Previous Projects" section** (place it after Ethics). Compress what the teammate did in the source project:
+   \`\`\`markdown
+   ## Previous Projects
+
+   ### <source-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 project-specific sections** for THIS project:
+   - **Preserve**: Identity (name, personality), Core Principles, Ethics
+   - **Rewrite completely**: Ownership (primary/secondary file globs for THIS project's actual files), Boundaries, Capabilities (commands, file patterns, technologies for THIS project), Routing keywords, Quality Bar
+   - **Update**: All codebase-specific references — paths, package names, tools, teammate names must reference THIS project
+
+For each teammate's **WISDOM.md**:
+- Add a "Previous Projects" note at the top
+- Keep universal wisdom entries (general principles, patterns)
+- Remove entries that reference source project paths, architecture, or tools not used here
+- Adapt entries with transferable knowledge but old-project-specific details
+
+### Step 3: Evaluate Gaps and Create New Teammates
+
+After adapting all existing teammates, check if THIS project has major subsystems that no teammate covers. If so, create new teammates:
+- 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
+
+If a teammate's domain doesn't exist at all in this project and their skills aren't transferable, delete their directory under \`${teammatesDir}\`.
+
+### Step 4: Update Framework Files
+
+- Update \`${teammatesDir}/README.md\` with the final roster
+- Update \`${teammatesDir}/CROSS-TEAM.md\` ownership table
+
+### Step 5: Verify
+
+- Every teammate has SOUL.md and WISDOM.md adapted to THIS project
+- Ownership globs reference actual files in THIS project
+- Boundaries reference correct teammate names
+- Previous Projects sections are present for all imported teammates
+- CROSS-TEAM.md has one row per teammate
+
+## Critical Reminder
+
 The PRIMARY goal is adapting the imported teammates. Every SOUL.md must be rewritten so the teammate understands THIS project's codebase, not the source project's. If you only have time for one thing, adapt the existing teammates — that is more important than creating new ones.`;
 }
 /**
@@ -326,95 +326,95 @@ export async function getOnboardingPrompt(projectDir) {
     return wrapPrompt(BUILTIN_ONBOARDING, projectDir);
 }
 function wrapPrompt(onboardingContent, projectDir) {
-    return `You are setting up the teammates framework for a project.
-
-**Target project directory:** ${projectDir}
-
-**Framework files have already been copied** into \`${projectDir}/.teammates/\` from the template. The following files are already in place:
-- CROSS-TEAM.md — fill in the Ownership Scopes table as you create teammates
-- PROTOCOL.md — team protocol (ready to use)
-- TEMPLATE.md — reference for creating teammate SOUL.md and WISDOM.md files
-- USER.md — user profile (gitignored, user fills in later)
-- README.md — update with project-specific roster and info
-- .gitignore — configured for USER.md and .index/
-- example/ — example SOUL.md and WISDOM.md for reference
-
-**Your job is to:**
-1. Analyze the codebase (Step 1)
-2. Design the team roster (Step 2)
-3. Create teammate folders with SOUL.md and WISDOM.md (Step 3) — use TEMPLATE.md for the structure
-4. Update README.md and CROSS-TEAM.md with the roster info (Step 3)
-5. Verify everything is in place (Step 4)
-
-You do NOT need to create the framework files listed above — they're already there.
-
-> **IMPORTANT:** The \`example/\` directory is a **template reference**, NOT a teammate. Do not modify it or treat it as a teammate. Never name a new teammate "example".
-
-Follow the onboarding instructions below. This is a non-interactive session — complete ALL work without pausing. Do not ask for confirmation or wait for user input. Work through each step and make all changes directly.
-
----
-
+    return `You are setting up the teammates framework for a project.
+
+**Target project directory:** ${projectDir}
+
+**Framework files have already been copied** into \`${projectDir}/.teammates/\` from the template. The following files are already in place:
+- CROSS-TEAM.md — fill in the Ownership Scopes table as you create teammates
+- PROTOCOL.md — team protocol (ready to use)
+- TEMPLATE.md — reference for creating teammate SOUL.md and WISDOM.md files
+- USER.md — user profile (gitignored, user fills in later)
+- README.md — update with project-specific roster and info
+- .gitignore — configured for USER.md and .index/
+- example/ — example SOUL.md and WISDOM.md for reference
+
+**Your job is to:**
+1. Analyze the codebase (Step 1)
+2. Design the team roster (Step 2)
+3. Create teammate folders with SOUL.md and WISDOM.md (Step 3) — use TEMPLATE.md for the structure
+4. Update README.md and CROSS-TEAM.md with the roster info (Step 3)
+5. Verify everything is in place (Step 4)
+
+You do NOT need to create the framework files listed above — they're already there.
+
+> **IMPORTANT:** The \`example/\` directory is a **template reference**, NOT a teammate. Do not modify it or treat it as a teammate. Never name a new teammate "example".
+
+Follow the onboarding instructions below. This is a non-interactive session — complete ALL work without pausing. Do not ask for confirmation or wait for user input. Work through each step and make all changes directly.
+
+---
+
 ${onboardingContent}`;
 }
-const BUILTIN_ONBOARDING = `# Teammates Onboarding
-
-You are going to analyze a codebase and create a set of AI teammates — persistent personas that each own a slice of the project. Follow these steps in order.
-
-## Step 1: Analyze the Codebase
-
-Read the project's entry points to understand its structure:
-- README, CONTRIBUTING, or similar docs
-- Package manifest (package.json, Cargo.toml, pyproject.toml, go.mod, etc.)
-- Top-level directory structure
-- Key configuration files
-
-Identify:
-1. **Major domains/subsystems** — distinct areas of the codebase
-2. **Dependency flow** — which layers depend on which
-3. **Key technologies** — languages, frameworks, tools per area
-4. **File patterns** — glob patterns for each domain
-
-## Step 2: Design the Team
-
-Based on your analysis, design a roster of teammates:
-- **Aim for 3–7 teammates.** Fewer for small projects, more for monorepos.
-- **Each teammate owns a distinct domain** with minimal overlap.
-- **Pick short, memorable names** — one word, evocative of the domain.
-
-For each teammate, define:
-- Name and one-line persona
-- Primary ownership (file patterns)
-- Key technologies
-- Boundaries (what they do NOT own)
-
-## Step 3: Create the Directory Structure
-
-Create teammate folders under \`.teammates/\`:
-
-### Teammate folders
-For each teammate, create \`.teammates/<name>/\` with:
-
-**SOUL.md** — Use the template from \`.teammates/TEMPLATE.md\`. Fill in identity, core principles, boundaries, capabilities, ownership, ethics.
-
-**WISDOM.md** — Start with one entry recording creation and key decisions.
-
-**memory/** — Empty directory for daily logs.
-
-### Update framework files
-- Update \`.teammates/README.md\` with the roster table, dependency flow, and routing guide
-- Update \`.teammates/CROSS-TEAM.md\` Ownership Scopes table with one row per teammate
-
-## Step 4: Verify
-
-Check:
-- Every roster teammate has a folder with SOUL.md and WISDOM.md
-- Ownership globs cover the codebase without major gaps
-- Boundaries reference the correct owning teammate
-- CROSS-TEAM.md Ownership Scopes table has one row per teammate with correct paths
-- .gitignore is in place (USER.md not committed)
-
-## Tips
-- Small projects are fine with 2–3 teammates
-- WISDOM.md starts light — just one creation entry
-- Prompt the user to fill in USER.md after setup
+const BUILTIN_ONBOARDING = `# Teammates Onboarding
+
+You are going to analyze a codebase and create a set of AI teammates — persistent personas that each own a slice of the project. Follow these steps in order.
+
+## Step 1: Analyze the Codebase
+
+Read the project's entry points to understand its structure:
+- README, CONTRIBUTING, or similar docs
+- Package manifest (package.json, Cargo.toml, pyproject.toml, go.mod, etc.)
+- Top-level directory structure
+- Key configuration files
+
+Identify:
+1. **Major domains/subsystems** — distinct areas of the codebase
+2. **Dependency flow** — which layers depend on which
+3. **Key technologies** — languages, frameworks, tools per area
+4. **File patterns** — glob patterns for each domain
+
+## Step 2: Design the Team
+
+Based on your analysis, design a roster of teammates:
+- **Aim for 3–7 teammates.** Fewer for small projects, more for monorepos.
+- **Each teammate owns a distinct domain** with minimal overlap.
+- **Pick short, memorable names** — one word, evocative of the domain.
+
+For each teammate, define:
+- Name and one-line persona
+- Primary ownership (file patterns)
+- Key technologies
+- Boundaries (what they do NOT own)
+
+## Step 3: Create the Directory Structure
+
+Create teammate folders under \`.teammates/\`:
+
+### Teammate folders
+For each teammate, create \`.teammates/<name>/\` with:
+
+**SOUL.md** — Use the template from \`.teammates/TEMPLATE.md\`. Fill in identity, core principles, boundaries, capabilities, ownership, ethics.
+
+**WISDOM.md** — Start with one entry recording creation and key decisions.
+
+**memory/** — Empty directory for daily logs.
+
+### Update framework files
+- Update \`.teammates/README.md\` with the roster table, dependency flow, and routing guide
+- Update \`.teammates/CROSS-TEAM.md\` Ownership Scopes table with one row per teammate
+
+## Step 4: Verify
+
+Check:
+- Every roster teammate has a folder with SOUL.md and WISDOM.md
+- Ownership globs cover the codebase without major gaps
+- Boundaries reference the correct owning teammate
+- CROSS-TEAM.md Ownership Scopes table has one row per teammate with correct paths
+- .gitignore is in place (USER.md not committed)
+
+## Tips
+- Small projects are fine with 2–3 teammates
+- WISDOM.md starts light — just one creation entry
+- Prompt the user to fill in USER.md after setup
 `;

package/dist/orchestrator.js

@@ -63,7 +63,10 @@ export class Orchestrator {
         }
         this.onEvent({ type: "task_assigned", assignment });
         const prevPresence = this.statuses.get(assignment.teammate)?.presence ?? "online";
-        this.statuses.set(assignment.teammate, { state: "working", presence: prevPresence });
+        this.statuses.set(assignment.teammate, {
+            state: "working",
+            presence: prevPresence,
+        });
         // Get or create session
         let sessionId = this.sessions.get(assignment.teammate);
         if (!sessionId) {
@@ -79,6 +82,9 @@ export class Orchestrator {
         const result = await this.adapter.executeTask(sessionId, teammate, prompt, {
             raw: assignment.raw,
         });
+        // Propagate system flag so event handlers can distinguish system vs user tasks
+        if (assignment.system)
+            result.system = true;
         this.onEvent({ type: "task_completed", result });
         // Update status (preserve presence)
         const postPresence = this.statuses.get(assignment.teammate)?.presence ?? "online";

package/dist/personas.test.d.ts

@@ -0,0 +1 @@
+export {};

package/dist/personas.test.js

@@ -0,0 +1,88 @@
+import { mkdir, readFile, rm } from "node:fs/promises";
+import { tmpdir } from "node:os";
+import { join } from "node:path";
+import { afterEach, beforeEach, describe, expect, it } from "vitest";
+import { loadPersonas, scaffoldFromPersona } from "./personas.js";
+// ── scaffoldFromPersona ─────────────────────────────────────────────
+let testDir;
+beforeEach(async () => {
+    testDir = join(tmpdir(), `personas-test-${Date.now()}-${Math.random().toString(36).slice(2)}`);
+    await mkdir(testDir, { recursive: true });
+});
+afterEach(async () => {
+    await rm(testDir, { recursive: true, force: true });
+});
+const samplePersona = {
+    persona: "Software Engineer",
+    alias: "beacon",
+    tier: 1,
+    description: "Architecture and implementation",
+    body: "# <Name> — Software Engineer\n\n## Identity\n<Name> is the team's SWE.",
+};
+describe("scaffoldFromPersona", () => {
+    it("creates teammate folder with SOUL.md and WISDOM.md", async () => {
+        const teamDir = await scaffoldFromPersona(testDir, "beacon", samplePersona);
+        const soul = await readFile(join(teamDir, "SOUL.md"), "utf-8");
+        const wisdom = await readFile(join(teamDir, "WISDOM.md"), "utf-8");
+        expect(soul).toContain("# Beacon — Software Engineer");
+        expect(soul).toContain("Beacon is the team's SWE.");
+        expect(wisdom).toContain("# Beacon — Wisdom");
+        expect(wisdom).toContain("Last compacted: never");
+    });
+    it("normalizes folder name to lowercase with safe chars", async () => {
+        const teamDir = await scaffoldFromPersona(testDir, "My Cool Bot!", samplePersona);
+        // Should strip spaces, uppercase, and special chars
+        expect(teamDir).toContain("mycoolbot");
+    });
+    it("replaces all <Name> placeholders in SOUL.md", async () => {
+        const teamDir = await scaffoldFromPersona(testDir, "atlas", samplePersona);
+        const soul = await readFile(join(teamDir, "SOUL.md"), "utf-8");
+        expect(soul).not.toContain("<Name>");
+        expect(soul).toContain("Atlas");
+    });
+    it("creates memory subdirectory", async () => {
+        const teamDir = await scaffoldFromPersona(testDir, "test", samplePersona);
+        // Should not throw — directory exists
+        const memDir = join(teamDir, "memory");
+        await mkdir(memDir, { recursive: true }); // no-op if exists
+    });
+    it("capitalizes display name in WISDOM.md", async () => {
+        const teamDir = await scaffoldFromPersona(testDir, "forge", samplePersona);
+        const wisdom = await readFile(join(teamDir, "WISDOM.md"), "utf-8");
+        expect(wisdom).toContain("# Forge — Wisdom");
+    });
+});
+// ── loadPersonas ────────────────────────────────────────────────────
+describe("loadPersonas", () => {
+    it("loads persona files from the bundled directory", async () => {
+        const personas = await loadPersonas();
+        // Should find at least the built-in personas
+        expect(personas.length).toBeGreaterThan(0);
+    });
+    it("sorts by tier then alphabetically", async () => {
+        const personas = await loadPersonas();
+        // Verify ordering: all tier 1 before tier 2
+        let lastTier = 0;
+        let lastName = "";
+        for (const p of personas) {
+            if (p.tier > lastTier) {
+                lastTier = p.tier;
+                lastName = "";
+            }
+            if (p.tier === lastTier && lastName) {
+                expect(p.persona.localeCompare(lastName)).toBeGreaterThanOrEqual(0);
+            }
+            lastName = p.persona;
+        }
+    });
+    it("each persona has required fields", async () => {
+        const personas = await loadPersonas();
+        for (const p of personas) {
+            expect(p.persona).toBeTruthy();
+            expect(p.alias).toBeTruthy();
+            expect(p.description).toBeTruthy();
+            expect(typeof p.tier).toBe("number");
+            expect(p.body.length).toBeGreaterThan(0);
+        }
+    });
+});

package/dist/registry.test.js

@@ -142,18 +142,18 @@ describe("Registry role parsing", () => {
 });
 describe("Registry ownership parsing", () => {
     it("parses primary ownership patterns", async () => {
-        const soul = `# Beacon
-
-## Ownership
-
-### Primary
-
-- \`recall/src/**\` — All source files
-- \`recall/package.json\` — Package manifest
-
-### Secondary
-
-- \`.teammates/.index/**\` — Vector indexes
+        const soul = `# Beacon
+
+## Ownership
+
+### Primary
+
+- \`recall/src/**\` — All source files
+- \`recall/package.json\` — Package manifest
+
+### Secondary
+
+- \`.teammates/.index/**\` — Vector indexes
 `;
         await createTeammate("beacon", soul);
         const registry = new Registry(tempDir);
@@ -174,17 +174,17 @@ describe("Registry ownership parsing", () => {
 });
 describe("Registry routing keyword parsing", () => {
     it("parses routing keywords from ### Routing section", async () => {
-        const soul = `# Beacon
-
-## Ownership
-
-### Primary
-
-- \`recall/src/**\` — All source files
-
-### Routing
-
-- \`search\`, \`embeddings\`, \`vector\`, \`semantic\`
+        const soul = `# Beacon
+
+## Ownership
+
+### Primary
+
+- \`recall/src/**\` — All source files
+
+### Routing
+
+- \`search\`, \`embeddings\`, \`vector\`, \`semantic\`
 `;
         await createTeammate("beacon", soul);
         const registry = new Registry(tempDir);

package/dist/theme.test.d.ts

@@ -0,0 +1 @@
+export {};

package/dist/theme.test.js

@@ -0,0 +1,113 @@
+import { afterEach, describe, expect, it } from "vitest";
+import { colorToHex, DEFAULT_THEME, setTheme, theme, tp } from "./theme.js";
+describe("theme", () => {
+    afterEach(() => {
+        // Restore default theme after each test
+        setTheme(DEFAULT_THEME);
+    });
+    it("returns the default theme initially", () => {
+        const t = theme();
+        expect(t.accent).toEqual(DEFAULT_THEME.accent);
+        expect(t.text).toEqual(DEFAULT_THEME.text);
+        expect(t.success).toEqual(DEFAULT_THEME.success);
+    });
+    it("setTheme replaces the active theme", () => {
+        const custom = {
+            ...DEFAULT_THEME,
+            accent: { r: 255, g: 0, b: 0, a: 255 },
+        };
+        setTheme(custom);
+        expect(theme().accent).toEqual({ r: 255, g: 0, b: 0, a: 255 });
+    });
+    it("setTheme creates a copy (not a reference)", () => {
+        const custom = { ...DEFAULT_THEME };
+        setTheme(custom);
+        custom.accent = { r: 0, g: 0, b: 0, a: 255 };
+        // Should not be affected by mutation
+        expect(theme().accent).toEqual(DEFAULT_THEME.accent);
+    });
+});
+describe("colorToHex", () => {
+    it("converts RGB to uppercase hex string", () => {
+        expect(colorToHex({ r: 58, g: 150, b: 221, a: 255 })).toBe("#3A96DD");
+    });
+    it("pads single-digit hex values with zero", () => {
+        expect(colorToHex({ r: 0, g: 0, b: 0, a: 255 })).toBe("#000000");
+    });
+    it("converts white correctly", () => {
+        expect(colorToHex({ r: 255, g: 255, b: 255, a: 255 })).toBe("#FFFFFF");
+    });
+    it("converts mid-range values", () => {
+        expect(colorToHex({ r: 128, g: 64, b: 32, a: 255 })).toBe("#804020");
+    });
+});
+describe("tp (themed pen shortcuts)", () => {
+    // tp functions return StyledSpan (StyledSegment[] with __brand)
+    // Each span contains segments with { text, style } entries
+    it("accent returns a styled span with correct text", () => {
+        const result = tp.accent("hello");
+        expect(Array.isArray(result)).toBe(true);
+        expect(result).toHaveLength(1);
+        expect(result[0].text).toBe("hello");
+    });
+    it("muted returns a styled span with correct text", () => {
+        const result = tp.muted("test");
+        expect(Array.isArray(result)).toBe(true);
+        expect(result[0].text).toBe("test");
+    });
+    it("success returns a styled span with correct text", () => {
+        const result = tp.success("ok");
+        expect(Array.isArray(result)).toBe(true);
+        expect(result[0].text).toBe("ok");
+    });
+    it("error returns a styled span with correct text", () => {
+        const result = tp.error("fail");
+        expect(Array.isArray(result)).toBe(true);
+        expect(result[0].text).toBe("fail");
+    });
+    it("bold returns a styled span with correct text", () => {
+        const result = tp.bold("strong");
+        expect(Array.isArray(result)).toBe(true);
+        expect(result[0].text).toBe("strong");
+    });
+    it("accent uses the current theme color", () => {
+        const result = tp.accent("x");
+        expect(result[0].style.fg).toEqual(DEFAULT_THEME.accent);
+    });
+    it("picks up theme changes", () => {
+        const custom = { ...DEFAULT_THEME, error: { r: 1, g: 2, b: 3, a: 255 } };
+        setTheme(custom);
+        const result = tp.error("x");
+        expect(result[0].style.fg).toEqual({ r: 1, g: 2, b: 3, a: 255 });
+    });
+    it("accentBright returns a styled span", () => {
+        const result = tp.accentBright("x");
+        expect(result[0].text).toBe("x");
+        expect(result[0].style.fg).toEqual(DEFAULT_THEME.accentBright);
+    });
+    it("accentDim returns a styled span", () => {
+        const result = tp.accentDim("x");
+        expect(result[0].text).toBe("x");
+        expect(result[0].style.fg).toEqual(DEFAULT_THEME.accentDim);
+    });
+    it("text returns a styled span", () => {
+        const result = tp.text("x");
+        expect(result[0].text).toBe("x");
+        expect(result[0].style.fg).toEqual(DEFAULT_THEME.text);
+    });
+    it("dim returns a styled span", () => {
+        const result = tp.dim("x");
+        expect(result[0].text).toBe("x");
+        expect(result[0].style.fg).toEqual(DEFAULT_THEME.textDim);
+    });
+    it("info returns a styled span", () => {
+        const result = tp.info("x");
+        expect(result[0].text).toBe("x");
+        expect(result[0].style.fg).toEqual(DEFAULT_THEME.info);
+    });
+    it("warning returns a styled span", () => {
+        const result = tp.warning("x");
+        expect(result[0].text).toBe("x");
+        expect(result[0].style.fg).toEqual(DEFAULT_THEME.warning);
+    });
+});