chatroom-cli 1.30.1 → 1.32.1

package/dist/commands/handoff/index.test.js

@@ -0,0 +1,189 @@
+/**
+ * handoff Unit Tests
+ *
+ * Tests the handoff command using injected dependencies.
+ * Covers: auth validation, successful handoff, mutation failure,
+ * handoff restriction (suggested target), artifact validation.
+ */
+import { afterEach, beforeEach, describe, expect, it, vi } from 'vitest';
+import { handoff } from './index.js';
+// ---------------------------------------------------------------------------
+// Mock modules
+// ---------------------------------------------------------------------------
+vi.mock('@workspace/backend/prompts/cli/handoff/command.js', () => ({
+    handoffCommand: (opts) => `chatroom handoff --chatroom-id=${opts.chatroomId} --role=${opts.role} --next-role=${opts.nextRole}`,
+}));
+vi.mock('@workspace/backend/prompts/cli/get-next-task/command.js', () => ({
+    getNextTaskCommand: (opts) => `chatroom get-next-task --chatroom-id=${opts.chatroomId} --role=${opts.role}`,
+}));
+vi.mock('@workspace/backend/prompts/utils/env.js', () => ({
+    getCliEnvPrefix: () => 'CHATROOM_CONVEX_URL=http://test:3210 ',
+}));
+// ---------------------------------------------------------------------------
+// Helpers
+// ---------------------------------------------------------------------------
+const TEST_CHATROOM_ID = 'test_chatroom_id_12345678';
+const TEST_SESSION_ID = 'test-session-id';
+function createMockDeps(overrides) {
+    return {
+        backend: {
+            mutation: vi.fn().mockResolvedValue({ success: true }),
+            query: vi.fn().mockResolvedValue(true),
+        },
+        session: {
+            getSessionId: vi.fn().mockReturnValue(TEST_SESSION_ID),
+            getConvexUrl: vi.fn().mockReturnValue('http://test:3210'),
+            getOtherSessionUrls: vi.fn().mockReturnValue([]),
+        },
+        ...overrides,
+    };
+}
+function defaultOptions(overrides) {
+    return {
+        role: 'planner',
+        message: 'Task completed, handing off',
+        nextRole: 'builder',
+        ...overrides,
+    };
+}
+// ---------------------------------------------------------------------------
+// Setup / Teardown
+// ---------------------------------------------------------------------------
+let exitSpy;
+let logSpy;
+let errorSpy;
+beforeEach(() => {
+    exitSpy = vi.spyOn(process, 'exit').mockImplementation((() => { }));
+    logSpy = vi.spyOn(console, 'log').mockImplementation(() => { });
+    errorSpy = vi.spyOn(console, 'error').mockImplementation(() => { });
+});
+afterEach(() => {
+    vi.restoreAllMocks();
+});
+function getAllLogOutput() {
+    return logSpy.mock.calls.map((c) => c.join(' ')).join('\n');
+}
+function getAllErrorOutput() {
+    return errorSpy.mock.calls.map((c) => c.join(' ')).join('\n');
+}
+// ---------------------------------------------------------------------------
+// Tests
+// ---------------------------------------------------------------------------
+describe('handoff', () => {
+    describe('authentication', () => {
+        it('exits with code 1 when not authenticated', async () => {
+            const deps = createMockDeps({
+                session: {
+                    getSessionId: vi.fn().mockReturnValue(null),
+                    getConvexUrl: vi.fn().mockReturnValue('http://test:3210'),
+                    getOtherSessionUrls: vi.fn().mockReturnValue([]),
+                },
+            });
+            await handoff(TEST_CHATROOM_ID, defaultOptions(), deps);
+            expect(exitSpy).toHaveBeenCalledWith(1);
+        });
+    });
+    describe('successful handoff', () => {
+        it('calls sendHandoff mutation and logs success', async () => {
+            const deps = createMockDeps();
+            await handoff(TEST_CHATROOM_ID, defaultOptions(), deps);
+            expect(exitSpy).not.toHaveBeenCalled();
+            // sendHandoff only (heartbeat now fired by preAction hook, not handler)
+            expect(deps.backend.mutation).toHaveBeenCalledTimes(1);
+            const output = getAllLogOutput();
+            expect(output).toContain('Task completed and handed off to builder');
+            expect(output).toContain('Task completed, handing off');
+            expect(output).toContain('get-next-task');
+        });
+    });
+    describe('handoff restriction', () => {
+        it('exits with code 1 and shows suggested target', async () => {
+            const deps = createMockDeps();
+            deps.backend.mutation.mockResolvedValue({
+                success: false,
+                error: {
+                    message: 'Cannot hand off to user for new_feature tasks',
+                    suggestedTarget: 'builder',
+                },
+            });
+            await handoff(TEST_CHATROOM_ID, defaultOptions({ nextRole: 'user' }), deps);
+            expect(exitSpy).toHaveBeenCalledWith(1);
+            const errOutput = getAllErrorOutput();
+            expect(errOutput).toContain('Cannot hand off to user');
+            expect(errOutput).toContain('builder');
+        });
+        it('exits with code 1 and lists available targets for INVALID_TARGET_ROLE', async () => {
+            const deps = createMockDeps();
+            deps.backend.mutation.mockResolvedValue({
+                success: false,
+                error: {
+                    code: 'INVALID_TARGET_ROLE',
+                    message: 'Cannot hand off to "reviewer": this role is not part of the current team. Available targets: user, planner, builder.',
+                    suggestedTargets: ['user', 'planner', 'builder'],
+                },
+            });
+            await handoff(TEST_CHATROOM_ID, defaultOptions({ nextRole: 'reviewer' }), deps);
+            expect(exitSpy).toHaveBeenCalledWith(1);
+            const errOutput = getAllErrorOutput();
+            expect(errOutput).toContain('Cannot hand off to "reviewer"');
+            expect(errOutput).toContain('Available handoff targets for this team');
+            expect(errOutput).toContain('• user');
+            expect(errOutput).toContain('• planner');
+            expect(errOutput).toContain('• builder');
+            expect(errOutput).toContain("Check your team's workflow");
+        });
+    });
+    describe('mutation failure', () => {
+        it('exits with code 1 when sendHandoff throws', async () => {
+            const deps = createMockDeps();
+            deps.backend.mutation.mockRejectedValue(new Error('Network timeout'));
+            await handoff(TEST_CHATROOM_ID, defaultOptions(), deps);
+            expect(exitSpy).toHaveBeenCalledWith(1);
+            const errOutput = getAllErrorOutput();
+            expect(errOutput).toContain('Handoff failed');
+            expect(errOutput).toContain('Network timeout');
+        });
+    });
+    describe('artifact validation', () => {
+        it('exits with code 1 when artifacts are invalid', async () => {
+            const deps = createMockDeps();
+            deps.backend.query.mockResolvedValue(false);
+            await handoff(TEST_CHATROOM_ID, defaultOptions({ attachedArtifactIds: ['art_123'] }), deps);
+            expect(exitSpy).toHaveBeenCalledWith(1);
+        });
+    });
+    describe('workflow attachment', () => {
+        it('resolves workflow keys and passes attachedWorkflowIds to mutation', async () => {
+            const deps = createMockDeps();
+            const mockWorkflowId = 'wf_resolved_123';
+            deps.backend.query.mockImplementation((_endpoint, args) => {
+                // resolveWorkflowId query
+                if (args && 'workflowKey' in args) {
+                    return Promise.resolve({ workflowId: mockWorkflowId });
+                }
+                // validateArtifactIds or other queries
+                return Promise.resolve(true);
+            });
+            await handoff(TEST_CHATROOM_ID, defaultOptions({ attachedWorkflowKeys: ['my-workflow'] }), deps);
+            expect(exitSpy).not.toHaveBeenCalled();
+            // The mutation should be called with attachedWorkflowIds
+            expect(deps.backend.mutation).toHaveBeenCalledWith(expect.anything(), expect.objectContaining({
+                attachedWorkflowIds: [mockWorkflowId],
+            }));
+        });
+        it('exits with code 1 when workflow key not found', async () => {
+            const deps = createMockDeps();
+            deps.backend.query.mockImplementation((_endpoint, args) => {
+                if (args && 'workflowKey' in args) {
+                    return Promise.reject(new Error('Workflow not found'));
+                }
+                return Promise.resolve(true);
+            });
+            await handoff(TEST_CHATROOM_ID, defaultOptions({ attachedWorkflowKeys: ['nonexistent'] }), deps);
+            expect(exitSpy).toHaveBeenCalledWith(1);
+            const errOutput = getAllErrorOutput();
+            expect(errOutput).toContain('not found');
+        });
+    });
+});
+//# sourceMappingURL=index.test.js.map

package/dist/commands/handoff/index.test.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.test.js","sourceRoot":"","sources":["../../../src/commands/handoff/index.test.ts"],"names":[],"mappings":"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"}

package/dist/commands/init/deps.d.ts

@@ -0,0 +1,21 @@
+/**
+ * Init Deps — dependency interfaces for the init command.
+ *
+ * Applies interface segregation: the command declares exactly which
+ * dependencies it needs, so tests only mock what's relevant.
+ */
+/** File system operations for project initialization */
+export interface InitFsOps {
+    access: (path: string) => Promise<void>;
+    readFile: (path: string, encoding: BufferEncoding) => Promise<string>;
+    writeFile: (path: string, content: string, encoding: BufferEncoding) => Promise<void>;
+}
+/**
+ * All external dependencies for the init command.
+ *
+ * - `fs`: File system operations for reading and writing agent files
+ */
+export interface InitDeps {
+    fs: InitFsOps;
+}
+//# sourceMappingURL=deps.d.ts.map

package/dist/commands/init/deps.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"deps.d.ts","sourceRoot":"","sources":["../../../src/commands/init/deps.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH,wDAAwD;AACxD,MAAM,WAAW,SAAS;IACxB,MAAM,EAAE,CAAC,IAAI,EAAE,MAAM,KAAK,OAAO,CAAC,IAAI,CAAC,CAAC;IACxC,QAAQ,EAAE,CAAC,IAAI,EAAE,MAAM,EAAE,QAAQ,EAAE,cAAc,KAAK,OAAO,CAAC,MAAM,CAAC,CAAC;IACtE,SAAS,EAAE,CAAC,IAAI,EAAE,MAAM,EAAE,OAAO,EAAE,MAAM,EAAE,QAAQ,EAAE,cAAc,KAAK,OAAO,CAAC,IAAI,CAAC,CAAC;CACvF;AAED;;;;GAIG;AACH,MAAM,WAAW,QAAQ;IACvB,EAAE,EAAE,SAAS,CAAC;CACf"}

package/dist/commands/init/deps.js

@@ -0,0 +1,8 @@
+/**
+ * Init Deps — dependency interfaces for the init command.
+ *
+ * Applies interface segregation: the command declares exactly which
+ * dependencies it needs, so tests only mock what's relevant.
+ */
+export {};
+//# sourceMappingURL=deps.js.map

package/dist/commands/init/deps.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"deps.js","sourceRoot":"","sources":["../../../src/commands/init/deps.ts"],"names":[],"mappings":"AAAA;;;;;GAKG"}

package/dist/commands/init/index.d.ts

@@ -0,0 +1,22 @@
+/**
+ * Chatroom Init Command
+ *
+ * Detects AGENTS.md and CLAUDE.md in the target directory and updates the
+ * Chatroom Integration section (Section 6) in any it finds. If neither file
+ * exists, creates AGENTS.md with the section as its sole content.
+ */
+import type { InitDeps } from './deps.js';
+export type { InitDeps } from './deps.js';
+export interface InitOptions {
+    dir?: string;
+}
+export interface InitResult {
+    filesModified: string[];
+    filesSkipped: string[];
+    filesCreated: string[];
+}
+/**
+ * Initialize chatroom integration in a project directory.
+ */
+export declare function init(options?: InitOptions, deps?: InitDeps): Promise<InitResult>;
+//# sourceMappingURL=index.d.ts.map

package/dist/commands/init/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/commands/init/index.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAIH,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,WAAW,CAAC;AAI1C,YAAY,EAAE,QAAQ,EAAE,MAAM,WAAW,CAAC;AAqD1C,MAAM,WAAW,WAAW;IAC1B,GAAG,CAAC,EAAE,MAAM,CAAC;CACd;AAED,MAAM,WAAW,UAAU;IACzB,aAAa,EAAE,MAAM,EAAE,CAAC;IACxB,YAAY,EAAE,MAAM,EAAE,CAAC;IACvB,YAAY,EAAE,MAAM,EAAE,CAAC;CACxB;AAiDD;;GAEG;AACH,wBAAsB,IAAI,CAAC,OAAO,GAAE,WAAgB,EAAE,IAAI,CAAC,EAAE,QAAQ,GAAG,OAAO,CAAC,UAAU,CAAC,CAoF1F"}

package/dist/commands/init/index.js

@@ -0,0 +1,181 @@
+/**
+ * Chatroom Init Command
+ *
+ * Detects AGENTS.md and CLAUDE.md in the target directory and updates the
+ * Chatroom Integration section (Section 6) in any it finds. If neither file
+ * exists, creates AGENTS.md with the section as its sole content.
+ */
+import path from 'path';
+// ─── Constants ─────────────────────────────────────────────────────────────
+/** Files to scan for, in order */
+const SUPPORTED_FILES = ['AGENTS.md', 'CLAUDE.md'];
+/**
+ * The Section 6 text to append.
+ * Sourced from packages/cli/README.md lines 154–214 (between the ```markdown fences).
+ */
+const SECTION_6_TEXT = `<chatroom>
+## CHATROOM INTEGRATION
+
+### Workflow Loop
+
+\`\`\`
+get-next-task → do work → handoff → get-next-task → repeat
+\`\`\`
+
+1. **Run \`get-next-task\`** immediately via \`bash\` — block until task arrives
+2. **Process** the task
+3. **Run \`handoff\`** to signal completion
+4. **Run \`get-next-task\`** again to wait for next task
+
+### Reliability
+
+Always add these as the **last two todo items** for every task:
+
+1. **Handoff item** — contains the full handoff command (see Command Reference)
+2. **Get-next-task item** — contains the full get-next-task command (see Command Reference)
+
+This ensures you never forget to pass control back — just copy the command from the todo item and run it via \`bash\`.
+
+### Command Reference
+
+| Action | Command |
+|--------|---------|
+| Fetch next task | \`CHATROOM_CONVEX_URL=<endpoint> chatroom get-next-task --chatroom-id=<id> --role=<role>\` |
+| Pass control | \`CHATROOM_CONVEX_URL=<endpoint> chatroom handoff --chatroom-id=<id> --role=<role> --next-role=<role>\` |
+| Refresh system prompt (after compaction) | \`CHATROOM_CONVEX_URL=<endpoint> chatroom get-system-prompt --chatroom-id=<id> --role=<role>\` |
+
+### Context Recovery
+
+If you suspect compaction (context starts with "Summary of:", or you're unsure of your role):
+
+1. Run \`get-system-prompt\` to reload full instructions
+2. Check todo list for last known step
+3. Resume with \`get-next-task\` or \`handoff\`
+</chatroom>`;
+// ─── Default Deps Factory ──────────────────────────────────────────────────
+async function createDefaultDeps() {
+    const fs = await import('fs/promises');
+    return {
+        fs: {
+            access: async (p) => {
+                await fs.access(p);
+            },
+            readFile: async (p, encoding) => {
+                return fs.readFile(p, encoding);
+            },
+            writeFile: async (p, content, encoding) => {
+                await fs.writeFile(p, content, encoding);
+            },
+        },
+    };
+}
+// ─── Helpers ───────────────────────────────────────────────────────────────
+async function fileExists(fsOps, filePath) {
+    try {
+        await fsOps.access(filePath);
+        return true;
+    }
+    catch {
+        return false;
+    }
+}
+function hasIntegrationSection(content) {
+    return content.includes('<chatroom>');
+}
+function replaceIntegrationSection(content, newSection) {
+    const start = content.indexOf('<chatroom>');
+    const end = content.indexOf('</chatroom>');
+    if (start === -1 || end === -1) {
+        // Tags not found — fall back to append
+        return content + '\n\n' + newSection;
+    }
+    const before = content.slice(0, start).replace(/\s+$/, '');
+    return before + '\n\n' + newSection;
+}
+// ─── Entry Point ───────────────────────────────────────────────────────────
+/**
+ * Initialize chatroom integration in a project directory.
+ */
+export async function init(options = {}, deps) {
+    const d = deps ?? (await createDefaultDeps());
+    const targetDir = options.dir ?? process.cwd();
+    const result = {
+        filesModified: [],
+        filesSkipped: [],
+        filesCreated: [],
+    };
+    // Scan for supported files
+    const foundFiles = [];
+    for (const filename of SUPPORTED_FILES) {
+        const filePath = path.join(targetDir, filename);
+        if (await fileExists(d.fs, filePath)) {
+            foundFiles.push(filename);
+        }
+    }
+    if (foundFiles.length === 0) {
+        // No supported files found — create AGENTS.md
+        const agentsPath = path.join(targetDir, 'AGENTS.md');
+        try {
+            await d.fs.writeFile(agentsPath, SECTION_6_TEXT, 'utf-8');
+            result.filesCreated.push('AGENTS.md');
+            console.log('✅ Created AGENTS.md with CHATROOM INTEGRATION section');
+        }
+        catch (err) {
+            console.error(`❌ Failed to create AGENTS.md: ${err}`);
+        }
+    }
+    else {
+        // Process each found file
+        for (const filename of foundFiles) {
+            const filePath = path.join(targetDir, filename);
+            let content;
+            try {
+                content = await d.fs.readFile(filePath, 'utf-8');
+            }
+            catch (err) {
+                console.error(`❌ Failed to read ${filename}: ${err}`);
+                continue;
+            }
+            if (hasIntegrationSection(content)) {
+                try {
+                    const updatedContent = replaceIntegrationSection(content, SECTION_6_TEXT);
+                    await d.fs.writeFile(filePath, updatedContent, 'utf-8');
+                    result.filesModified.push(filename);
+                    console.log(`✅ Updated CHATROOM INTEGRATION section in ${filename}`);
+                }
+                catch (err) {
+                    console.error(`❌ Failed to update ${filename}: ${err}`);
+                }
+            }
+            else {
+                try {
+                    const appendText = '\n\n---\n\n' + SECTION_6_TEXT;
+                    await d.fs.writeFile(filePath, content + appendText, 'utf-8');
+                    result.filesModified.push(filename);
+                    console.log(`✅ Added CHATROOM INTEGRATION section to ${filename}`);
+                }
+                catch (err) {
+                    console.error(`❌ Failed to update ${filename}: ${err}`);
+                }
+            }
+        }
+    }
+    // Print summary
+    console.log('');
+    console.log('Summary:');
+    if (result.filesCreated.length > 0) {
+        console.log(`  Created : ${result.filesCreated.join(', ')}`);
+    }
+    if (result.filesModified.length > 0) {
+        console.log(`  Updated : ${result.filesModified.join(', ')}`);
+    }
+    if (result.filesSkipped.length > 0) {
+        console.log(`  Skipped : ${result.filesSkipped.join(', ')} (already has integration section)`);
+    }
+    const totalActions = result.filesCreated.length + result.filesModified.length + result.filesSkipped.length;
+    if (totalActions === 0) {
+        console.log('  Nothing to do.');
+    }
+    return result;
+}
+//# sourceMappingURL=index.js.map

package/dist/commands/init/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../src/commands/init/index.ts"],"names":[],"mappings":"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"}

package/dist/commands/init/index.test.d.ts

@@ -0,0 +1,8 @@
+/**
+ * init Unit Tests
+ *
+ * Tests the init command using injected dependencies (fake in-memory fs).
+ * Covers: no files exist, section absent, section already present (idempotent).
+ */
+export {};
+//# sourceMappingURL=index.test.d.ts.map

package/dist/commands/init/index.test.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.test.d.ts","sourceRoot":"","sources":["../../../src/commands/init/index.test.ts"],"names":[],"mappings":"AAAA;;;;;GAKG"}

package/dist/commands/init/index.test.js

@@ -0,0 +1,170 @@
+/**
+ * init Unit Tests
+ *
+ * Tests the init command using injected dependencies (fake in-memory fs).
+ * Covers: no files exist, section absent, section already present (idempotent).
+ */
+import { afterEach, beforeEach, describe, expect, it, vi } from 'vitest';
+import { init } from './index.js';
+// ---------------------------------------------------------------------------
+// Helpers
+// ---------------------------------------------------------------------------
+/** Creates an in-memory fake fs backed by a Map<path, content>. */
+function createFakeFs(initialFiles = {}) {
+    const store = new Map(Object.entries(initialFiles));
+    const deps = {
+        fs: {
+            access: async (p) => {
+                if (!store.has(p))
+                    throw new Error(`ENOENT: ${p}`);
+            },
+            readFile: async (p, _encoding) => {
+                const content = store.get(p);
+                if (content === undefined)
+                    throw new Error(`ENOENT: ${p}`);
+                return content;
+            },
+            writeFile: async (p, content, _encoding) => {
+                store.set(p, content);
+            },
+        },
+    };
+    return { store, deps };
+}
+// ---------------------------------------------------------------------------
+// Setup / Teardown
+// ---------------------------------------------------------------------------
+let _logSpy;
+let _errorSpy;
+beforeEach(() => {
+    _logSpy = vi.spyOn(console, 'log').mockImplementation(() => { });
+    _errorSpy = vi.spyOn(console, 'error').mockImplementation(() => { });
+});
+afterEach(() => {
+    vi.restoreAllMocks();
+});
+// ---------------------------------------------------------------------------
+// Tests
+// ---------------------------------------------------------------------------
+describe('init', () => {
+    describe('no files exist', () => {
+        it('creates AGENTS.md with the CHATROOM INTEGRATION section', async () => {
+            const { store, deps } = createFakeFs();
+            const dir = '/fake/project';
+            const result = await init({ dir }, deps);
+            expect(result.filesCreated).toContain('AGENTS.md');
+            expect(result.filesModified).toHaveLength(0);
+            expect(result.filesSkipped).toHaveLength(0);
+            const written = store.get(`${dir}/AGENTS.md`);
+            expect(written).toBeDefined();
+            expect(written).toContain('<chatroom>');
+            expect(written).toContain('</chatroom>');
+            expect(written).toContain('CHATROOM INTEGRATION');
+            expect(written).toContain('Workflow Loop');
+            expect(written).toContain('Reliability');
+            expect(written).toContain('Command Reference');
+            expect(written).toContain('Context Recovery');
+        });
+    });
+    describe('file exists, section absent', () => {
+        it('appends section and file is in filesModified', async () => {
+            const dir = '/fake/project';
+            const existingContent = '# My Project\n\nSome existing content here.\n';
+            const { store, deps } = createFakeFs({
+                [`${dir}/AGENTS.md`]: existingContent,
+            });
+            const result = await init({ dir }, deps);
+            expect(result.filesModified).toContain('AGENTS.md');
+            expect(result.filesCreated).toHaveLength(0);
+            expect(result.filesSkipped).toHaveLength(0);
+            const written = store.get(`${dir}/AGENTS.md`);
+            expect(written).toBeDefined();
+            // Original content preserved
+            expect(written).toContain('My Project');
+            expect(written).toContain('Some existing content here.');
+            // Section appended with tags
+            expect(written).toContain('<chatroom>');
+            expect(written).toContain('</chatroom>');
+            expect(written).toContain('CHATROOM INTEGRATION');
+            expect(written).toContain('Workflow Loop');
+            expect(written).toContain('Reliability');
+            expect(written).toContain('Command Reference');
+            expect(written).toContain('Context Recovery');
+        });
+    });
+    describe('file exists, section already present', () => {
+        it('replaces the section in place using <chatroom> tags, file is in filesModified (not filesSkipped)', async () => {
+            const dir = '/fake/project';
+            const oldSection = '<chatroom>\n## CHATROOM INTEGRATION\n\nOld content here that should be replaced.\n</chatroom>';
+            const existingContent = `# My Project\n\nMain content.\n\n---\n\n${oldSection}`;
+            const { store, deps } = createFakeFs({
+                [`${dir}/AGENTS.md`]: existingContent,
+            });
+            const result = await init({ dir }, deps);
+            expect(result.filesModified).toContain('AGENTS.md');
+            expect(result.filesCreated).toHaveLength(0);
+            expect(result.filesSkipped).toHaveLength(0);
+            const written = store.get(`${dir}/AGENTS.md`);
+            expect(written).toBeDefined();
+            // Original preamble preserved
+            expect(written).toContain('My Project');
+            expect(written).toContain('Main content.');
+            // Old section content gone
+            expect(written).not.toContain('Old content here that should be replaced.');
+            // New section present with tags
+            expect(written).toContain('<chatroom>');
+            expect(written).toContain('</chatroom>');
+            expect(written).toContain('CHATROOM INTEGRATION');
+            expect(written).toContain('Workflow Loop');
+            expect(written).toContain('Reliability');
+            expect(written).toContain('Command Reference');
+            expect(written).toContain('Context Recovery');
+            // No duplicate chatroom tags
+            const openMatches = (written ?? '').match(/<chatroom>/g);
+            expect(openMatches).toHaveLength(1);
+        });
+        it('gracefully appends when old heading-only format (no tags) is present', async () => {
+            const dir = '/fake/project';
+            // Old format: heading but no <chatroom> tags
+            const oldSection = '## 6. CHATROOM INTEGRATION\n\nOld heading-only format.\n';
+            const existingContent = `# My Project\n\nMain content.\n\n---\n\n${oldSection}`;
+            const { store, deps } = createFakeFs({
+                [`${dir}/AGENTS.md`]: existingContent,
+            });
+            const result = await init({ dir }, deps);
+            // No <chatroom> tag in old content → hasIntegrationSection returns false → append
+            expect(result.filesModified).toContain('AGENTS.md');
+            const written = store.get(`${dir}/AGENTS.md`);
+            expect(written).toBeDefined();
+            expect(written).toContain('<chatroom>');
+            expect(written).toContain('</chatroom>');
+            expect(written).toContain('Workflow Loop');
+        });
+    });
+    describe('idempotency', () => {
+        it('running init twice produces the same result without duplication', async () => {
+            const dir = '/fake/project';
+            const existingContent = '# My Project\n\nMain content.\n';
+            const { store, deps } = createFakeFs({
+                [`${dir}/AGENTS.md`]: existingContent,
+            });
+            // First run — appends section
+            const result1 = await init({ dir }, deps);
+            expect(result1.filesModified).toContain('AGENTS.md');
+            // Second run — replaces section in place
+            const result2 = await init({ dir }, deps);
+            expect(result2.filesModified).toContain('AGENTS.md');
+            expect(result2.filesSkipped).toHaveLength(0);
+            const finalContent = store.get(`${dir}/AGENTS.md`) ?? '';
+            // <chatroom> tag appears exactly once
+            const openMatches = finalContent.match(/<chatroom>/g);
+            expect(openMatches).toHaveLength(1);
+            const closeMatches = finalContent.match(/<\/chatroom>/g);
+            expect(closeMatches).toHaveLength(1);
+            // New section content present
+            expect(finalContent).toContain('Workflow Loop');
+            expect(finalContent).toContain('Context Recovery');
+        });
+    });
+});
+//# sourceMappingURL=index.test.js.map