@memnexus-ai/mx-agent-cli 0.1.207 → 0.1.208

package/dist/__tests__/start-report-integration.test.d.ts

@@ -0,0 +1,12 @@
+/**
+ * Integration test: driving runStart to a successful hand-off writes ONE durable
+ * StartupReport JSONL line capturing the start-path output (platform v2.58 Phase
+ * 1, #4350).
+ *
+ * Every boundary is stubbed (git, network, filesystem sync, locking, launcher)
+ * so runStart reaches the `finalize('ok')` immediately before session launch.
+ * We then read the JSONL file from a temp HOME and assert the documented schema
+ * plus a non-empty entries[] captured from the start command's own output.
+ */
+export {};
+//# sourceMappingURL=start-report-integration.test.d.ts.map

package/dist/__tests__/start-report-integration.test.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"start-report-integration.test.d.ts","sourceRoot":"","sources":["../../src/__tests__/start-report-integration.test.ts"],"names":[],"mappings":"AAAA;;;;;;;;;GASG"}

package/dist/__tests__/start-report-integration.test.js

@@ -0,0 +1,123 @@
+/**
+ * Integration test: driving runStart to a successful hand-off writes ONE durable
+ * StartupReport JSONL line capturing the start-path output (platform v2.58 Phase
+ * 1, #4350).
+ *
+ * Every boundary is stubbed (git, network, filesystem sync, locking, launcher)
+ * so runStart reaches the `finalize('ok')` immediately before session launch.
+ * We then read the JSONL file from a temp HOME and assert the documented schema
+ * plus a non-empty entries[] captured from the start command's own output.
+ */
+import { describe, it, expect, beforeEach, afterEach, vi } from 'vitest';
+import { mkdtempSync, readFileSync, rmSync } from 'fs';
+import { tmpdir } from 'os';
+import { join } from 'path';
+// hasOrigin=false (git remote probe returns non-zero) → skip the fetch/rebase
+// block and land on the config-sync + launch tail deterministically.
+vi.mock('child_process', () => ({
+    spawnSync: vi.fn(() => ({ status: 1, stdout: '', stderr: '' })),
+}));
+vi.mock('../lib/worktree.js', () => ({
+    findProjectRoot: vi.fn(() => '/fake/project'),
+    findWorktreePath: vi.fn(() => '/fake/project/.worktrees/demo-wt'),
+    getSlot: vi.fn(() => 0),
+    getCurrentBranch: vi.fn(() => 'worktree/demo'),
+}));
+// claude.js is real for the log helpers but we don't want real config sync or a
+// real session launch, so stub the heavy operations to no-ops. The direct
+// console.log calls inside runStart itself still run and get captured by the tee.
+vi.mock('../lib/claude.js', () => ({
+    syncClaudeConfig: vi.fn(),
+    deployBaseHooks: vi.fn(),
+    deployClaudeMd: vi.fn(),
+    writeClaudeLocal: vi.fn(),
+    launchClaudeSession: vi.fn(async () => { }),
+    logSuccess: vi.fn(),
+    logDim: vi.fn(),
+    logWarning: vi.fn(),
+}));
+vi.mock('../lib/agent-session.js', () => ({
+    launchAgentSession: vi.fn(async () => { }),
+}));
+vi.mock('../lib/catalog.js', () => ({
+    getTeam: vi.fn(() => undefined),
+}));
+vi.mock('../lib/project-config.js', () => ({
+    loadProjectConfig: vi.fn(() => ({})),
+    resolveProjectConfig: vi.fn(() => ({
+        baseBranch: 'main',
+        worktreeDir: '.worktrees',
+        teamsDir: 'mx-agent-system/teams',
+        roleguidesDir: 'mx-agent-system/roleguides',
+        configSource: 'mx-agent-system/agent-config',
+        coordinationMode: 'off',
+    })),
+}));
+vi.mock('../lib/config-generation.js', () => ({
+    checkConfigGeneration: vi.fn(),
+}));
+vi.mock('../lib/config.js', () => ({
+    getConfigValue: vi.fn(() => undefined),
+    setConfigValue: vi.fn(),
+}));
+vi.mock('../lib/leader-lock.js', () => ({
+    claimLock: vi.fn(() => ({ ok: true })),
+    checkLiveness: vi.fn(() => ({ state: 'stale', lockAgeSeconds: null })),
+    formatLockEvidence: vi.fn(() => ''),
+    lockPath: vi.fn(() => '/fake/project/.worktrees/demo-wt/.leader.lock'),
+    readLock: vi.fn(() => ({ lock: null, parseError: null })),
+    removeLock: vi.fn(),
+    writeLock: vi.fn(),
+    updateChildPid: vi.fn(),
+}));
+vi.mock('../lib/coordination-token.js', () => ({
+    resolveCoordinationToken: vi.fn(() => ({ status: 'not-on-roster' })),
+}));
+import { runStart } from '../commands/start.js';
+import { startupReport } from '../lib/startup-report.js';
+let home;
+const OLD_HOME = process.env.HOME;
+let logSpy;
+beforeEach(() => {
+    home = mkdtempSync(join(tmpdir(), 'mx-startlog-int-'));
+    // Set HOME as a property so Node's env proxy stays intact (os.homedir()
+    // reads it); a wholesale `process.env = {...}` would break that.
+    process.env.HOME = home;
+    startupReport._reset();
+    vi.clearAllMocks();
+    // Neutralize the npm version check network call.
+    vi.stubGlobal('fetch', vi.fn().mockRejectedValue(new Error('no network in test')));
+    logSpy = vi.spyOn(console, 'log').mockImplementation(() => { });
+});
+afterEach(() => {
+    logSpy.mockRestore();
+    vi.unstubAllGlobals();
+    startupReport._reset();
+    rmSync(home, { recursive: true, force: true });
+    if (OLD_HOME === undefined)
+        delete process.env.HOME;
+    else
+        process.env.HOME = OLD_HOME;
+});
+describe('runStart → durable StartupReport', () => {
+    it('writes one JSONL report with schema_version, outcome ok, and entries[]', async () => {
+        await runStart({ name: 'demo' });
+        const file = join(home, '.mx-agent', 'logs', 'startup', 'demo-wt.jsonl');
+        const lines = readFileSync(file, 'utf-8').trim().split('\n');
+        expect(lines).toHaveLength(1);
+        const report = JSON.parse(lines[0]);
+        expect(report.schema_version).toBe(1);
+        expect(report.outcome).toBe('ok');
+        expect(report.team).toBe('demo');
+        expect(report.worktree).toBe('demo-wt');
+        expect(report.project).toBe('project'); // basename('/fake/project')
+        expect(typeof report.cli_version).toBe('string');
+        expect(Array.isArray(report.entries)).toBe(true);
+        expect(report.entries.length).toBeGreaterThan(0);
+        // The banner line the command prints is captured verbatim (ANSI stripped).
+        const messages = report.entries.map((e) => e.message).join('\n');
+        expect(messages).toContain('Starting Agent Team');
+        expect(messages).toContain('Team:');
+    });
+});
+//# sourceMappingURL=start-report-integration.test.js.map

package/dist/__tests__/start-report-integration.test.js.map

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

package/dist/__tests__/startup-report.test.d.ts

@@ -0,0 +1,13 @@
+/**
+ * Tests for the durable startup-log collector (platform v2.58 Phase 1, #4350).
+ *
+ * Covers the module's contract:
+ *  - entry recording (level + optional code)
+ *  - finalize writes one JSON line with the documented schema; idempotent
+ *  - two-generation rotation at the 5 MB threshold
+ *  - finalize NEVER throws, even when the log directory is unwritable
+ *  - level inference from glyphs and ANSI colors
+ *  - the console-capture tee records every print without altering output
+ */
+export {};
+//# sourceMappingURL=startup-report.test.d.ts.map

package/dist/__tests__/startup-report.test.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"startup-report.test.d.ts","sourceRoot":"","sources":["../../src/__tests__/startup-report.test.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;GAUG"}

package/dist/__tests__/startup-report.test.js

@@ -0,0 +1,245 @@
+/**
+ * Tests for the durable startup-log collector (platform v2.58 Phase 1, #4350).
+ *
+ * Covers the module's contract:
+ *  - entry recording (level + optional code)
+ *  - finalize writes one JSON line with the documented schema; idempotent
+ *  - two-generation rotation at the 5 MB threshold
+ *  - finalize NEVER throws, even when the log directory is unwritable
+ *  - level inference from glyphs and ANSI colors
+ *  - the console-capture tee records every print without altering output
+ */
+import { describe, it, expect, beforeEach, afterEach, vi } from 'vitest';
+import { mkdtempSync, mkdirSync, writeFileSync, readFileSync, existsSync, rmSync, chmodSync } from 'fs';
+import { tmpdir } from 'os';
+import { join } from 'path';
+import { startupReport, inferLevel, stripAnsi, redactUrlCredentials } from '../lib/startup-report.js';
+let home;
+const OLD_HOME = process.env.HOME;
+/** Path where finalize writes for a given worktree/team name under the temp HOME. */
+function logPath(name) {
+    return join(home, '.mx-agent', 'logs', 'startup', `${name}.jsonl`);
+}
+beforeEach(() => {
+    home = mkdtempSync(join(tmpdir(), 'mx-startlog-home-'));
+    // Set HOME as a property (keeps Node's env proxy → os.homedir() sees it).
+    // A wholesale `process.env = {...}` would drop the proxy and break homedir().
+    process.env.HOME = home; // os.homedir() honors $HOME on POSIX
+    startupReport._reset();
+});
+afterEach(() => {
+    startupReport._reset();
+    rmSync(home, { recursive: true, force: true });
+    if (OLD_HOME === undefined)
+        delete process.env.HOME;
+    else
+        process.env.HOME = OLD_HOME;
+});
+describe('stripAnsi', () => {
+    it('removes SGR color/style escapes', () => {
+        expect(stripAnsi('\x1b[32m✓ ok\x1b[39m')).toBe('✓ ok');
+        expect(stripAnsi('plain')).toBe('plain');
+    });
+});
+describe('inferLevel', () => {
+    it('reads glyph markers first (survives colors off)', () => {
+        expect(inferLevel('  ✓ Deployed AGENTS.md', 'out')).toBe('success');
+        expect(inferLevel('  ⚠ Could not fetch', 'out')).toBe('warning');
+        expect(inferLevel('  ✗ Refusing to start', 'out')).toBe('error');
+    });
+    it('falls back to ANSI color when no glyph', () => {
+        expect(inferLevel('\x1b[31mError: boom\x1b[39m', 'out')).toBe('error');
+        expect(inferLevel('\x1b[33mheads up\x1b[39m', 'out')).toBe('warning');
+        expect(inferLevel('\x1b[32mgreen\x1b[39m', 'out')).toBe('success');
+        expect(inferLevel('\x1b[2mdim line\x1b[22m', 'out')).toBe('dim');
+        expect(inferLevel('\x1b[90mgray\x1b[39m', 'out')).toBe('dim');
+    });
+    it('biases by stream when plain text has no marker', () => {
+        expect(inferLevel('Team: demo', 'out')).toBe('info');
+        expect(inferLevel('[mx-agent] skipping behavioral content', 'err')).toBe('warning');
+        expect(inferLevel('Error: not found', 'error-console')).toBe('error');
+    });
+});
+describe('URL credential redaction', () => {
+    it('strips userinfo from a credentialed https remote', () => {
+        expect(redactUrlCredentials('https://x-access-token:SECRET@github.com/org/repo.git'))
+            .toBe('https://***@github.com/org/repo.git');
+    });
+    it('leaves a plain https URL unchanged', () => {
+        expect(redactUrlCredentials('https://github.com/org/repo.git'))
+            .toBe('https://github.com/org/repo.git');
+    });
+    it('does NOT mangle an ssh-style git@github.com: remote (no scheme://)', () => {
+        expect(redactUrlCredentials('git@github.com:org/repo.git'))
+            .toBe('git@github.com:org/repo.git');
+    });
+    it('record() persists the scrubbed message', () => {
+        startupReport.record('warning', 'fatal: could not read from https://user:pw@example.com/x.git');
+        const entries = startupReport._entries();
+        expect(entries[0].message).toBe('fatal: could not read from https://***@example.com/x.git');
+        expect(entries[0].message).not.toContain('pw');
+    });
+});
+describe('record + finalize', () => {
+    it('buffers entries with level and optional code', () => {
+        startupReport.record('info', 'starting');
+        startupReport.record('warning', 'heads up', 'obs-token-missing');
+        const entries = startupReport._entries();
+        expect(entries).toHaveLength(2);
+        expect(entries[0]).toMatchObject({ level: 'info', message: 'starting' });
+        expect(entries[0].code).toBeUndefined();
+        expect(entries[1]).toMatchObject({ level: 'warning', message: 'heads up', code: 'obs-token-missing' });
+        expect(typeof entries[0].ts).toBe('string');
+    });
+    it('writes one JSON line with the documented schema', () => {
+        startupReport.setContext({
+            project: 'memnexus',
+            team: 'demo',
+            worktree: 'demo-20260721',
+            cliVersion: '9.9.9',
+            machine: 'test-host',
+        });
+        startupReport.record('info', 'line one');
+        startupReport.record('success', 'line two');
+        startupReport.finalize('ok');
+        const raw = readFileSync(logPath('demo-20260721'), 'utf-8').trim().split('\n');
+        expect(raw).toHaveLength(1);
+        const report = JSON.parse(raw[0]);
+        expect(report.schema_version).toBe(1);
+        expect(report.project).toBe('memnexus');
+        expect(report.team).toBe('demo');
+        expect(report.worktree).toBe('demo-20260721');
+        expect(report.cli_version).toBe('9.9.9');
+        expect(report.machine).toBe('test-host');
+        expect(report.outcome).toBe('ok');
+        expect(typeof report.started_at).toBe('string');
+        expect(typeof report.finished_at).toBe('string');
+        expect(report.entries).toHaveLength(2);
+        expect(report.entries[1]).toMatchObject({ level: 'success', message: 'line two' });
+    });
+    it('is idempotent — a second finalize is a no-op (single line total)', () => {
+        startupReport.setContext({ team: 'demo' });
+        startupReport.record('info', 'once');
+        startupReport.finalize('ok');
+        startupReport.finalize('error'); // must be ignored
+        const raw = readFileSync(logPath('demo'), 'utf-8').trim().split('\n');
+        expect(raw).toHaveLength(1);
+        expect(JSON.parse(raw[0]).outcome).toBe('ok');
+    });
+    it('falls back to team, then "unknown", for the file name', () => {
+        startupReport.setContext({ team: 'teamx' }); // no worktree
+        startupReport.record('info', 'x');
+        startupReport.finalize('refused');
+        expect(existsSync(logPath('teamx'))).toBe(true);
+    });
+    it('appends across invocations (multiple JSON lines accumulate)', () => {
+        startupReport.setContext({ worktree: 'wt' });
+        startupReport.record('info', 'first');
+        startupReport.finalize('ok');
+        startupReport._reset();
+        startupReport.setContext({ worktree: 'wt' });
+        startupReport.record('info', 'second');
+        startupReport.finalize('refused');
+        const lines = readFileSync(logPath('wt'), 'utf-8').trim().split('\n');
+        expect(lines).toHaveLength(2);
+        expect(JSON.parse(lines[0]).outcome).toBe('ok');
+        expect(JSON.parse(lines[1]).outcome).toBe('refused');
+    });
+});
+describe('rotation at the 5 MB threshold', () => {
+    it('renames the current file to .1 before appending when over 5 MB', () => {
+        const dir = join(home, '.mx-agent', 'logs', 'startup');
+        mkdirSync(dir, { recursive: true });
+        const target = logPath('big');
+        // Pre-seed a file just over 5 MB.
+        writeFileSync(target, 'x'.repeat(5 * 1024 * 1024 + 10));
+        startupReport.setContext({ worktree: 'big' });
+        startupReport.record('info', 'after rotation');
+        startupReport.finalize('ok');
+        expect(existsSync(`${target}.1`)).toBe(true);
+        // The new primary file holds exactly the one fresh report line.
+        const lines = readFileSync(target, 'utf-8').trim().split('\n');
+        expect(lines).toHaveLength(1);
+        expect(JSON.parse(lines[0]).entries[0].message).toBe('after rotation');
+    });
+    it('does not rotate a small file', () => {
+        startupReport.setContext({ worktree: 'small' });
+        startupReport.record('info', 'a');
+        startupReport.finalize('ok');
+        expect(existsSync(`${logPath('small')}.1`)).toBe(false);
+    });
+});
+describe('never throws on unwritable log dir', () => {
+    it('finalize swallows I/O errors when the home dir is read-only', () => {
+        // Make HOME read-only so mkdirSync(~/.mx-agent/...) fails with EACCES.
+        // (Skipped implicitly when running as root, where perms are ignored — the
+        // assertion below still holds because finalize never throws regardless.)
+        chmodSync(home, 0o555);
+        startupReport.setContext({ worktree: 'ro' });
+        startupReport.record('error', 'boom');
+        expect(() => startupReport.finalize('error')).not.toThrow();
+        // Restore perms so afterEach cleanup can remove the dir.
+        chmodSync(home, 0o755);
+    });
+    it('record never throws', () => {
+        expect(() => startupReport.record('info', 'ok')).not.toThrow();
+    });
+});
+describe('console-capture tee', () => {
+    it('records every print with an inferred level and still emits output', () => {
+        startupReport.setContext({ worktree: 'tee' });
+        // Spy the REAL console before installing the tee so we can prove output
+        // still reaches the terminal exactly once per call.
+        const logSpy = vi.spyOn(console, 'log').mockImplementation(() => { });
+        const errSpy = vi.spyOn(console, 'error').mockImplementation(() => { });
+        startupReport.installConsoleCapture();
+        console.log('\x1b[32m  ✓ Deployed\x1b[39m');
+        console.log('  Team: demo'); // plain info
+        console.log('\x1b[33m  ⚠ heads up\x1b[39m');
+        console.log('   '); // whitespace-only — must NOT be recorded
+        console.error('\x1b[31mError: nope\x1b[39m');
+        process.stderr.write('[mx-agent] skipping behavioral content\n');
+        startupReport.removeConsoleCapture();
+        const entries = startupReport._entries();
+        const levels = entries.map((e) => e.level);
+        expect(levels).toEqual(['success', 'info', 'warning', 'error', 'warning']);
+        expect(entries[0].message).toBe('  ✓ Deployed');
+        expect(entries.find((e) => e.message.includes('skipping behavioral'))).toBeTruthy();
+        // Output still went out: 4 console.log calls (incl. the whitespace one).
+        expect(logSpy).toHaveBeenCalledTimes(4);
+        expect(errSpy).toHaveBeenCalledTimes(1);
+        logSpy.mockRestore();
+        errSpy.mockRestore();
+    });
+    it('records a REAL console.error exactly ONCE (no double via stderr chain)', () => {
+        // Do NOT mock console.error — the native impl dispatches through the teed
+        // process.stderr.write, which is exactly the double-count path under test.
+        // Redirect the raw stderr fd write to a sink so the line does not clutter
+        // test output, but leave console.error / process.stderr.write real so the
+        // tee sees the genuine dispatch chain.
+        startupReport.setContext({ worktree: 'realerr' });
+        const realStderrWrite = process.stderr.write.bind(process.stderr);
+        const sink = vi.fn(() => true);
+        process.stderr.write = sink;
+        try {
+            startupReport.installConsoleCapture();
+            console.error('\x1b[31mTeam \'bogus\' not found.\x1b[39m');
+            startupReport.removeConsoleCapture();
+        }
+        finally {
+            process.stderr.write = realStderrWrite;
+        }
+        const entries = startupReport._entries();
+        expect(entries).toHaveLength(1);
+        expect(entries[0].level).toBe('error');
+        expect(entries[0].message).toBe("Team 'bogus' not found.");
+    });
+    it('removeConsoleCapture restores the original console.log', () => {
+        const before = console.log;
+        startupReport.installConsoleCapture();
+        expect(console.log).not.toBe(before);
+        startupReport.removeConsoleCapture();
+        expect(console.log).toBe(before);
+    });
+});
+//# sourceMappingURL=startup-report.test.js.map

package/dist/__tests__/startup-report.test.js.map

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

package/dist/commands/start.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"start.d.ts","sourceRoot":"","sources":["../../src/commands/start.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAyBH;;;;;;;;;;;;;;;;;GAiBG;AACH,eAAO,MAAM,8BAA8B,UAG1C,CAAC;AACF,eAAO,MAAM,2BAA2B,aAEtC,CAAC;AAEH;;;;GAIG;AACH,wBAAgB,qBAAqB,CAAC,IAAI,EAAE,MAAM,GAAG,OAAO,CAK3D;AA2BD;;;;;;;;;;;;;;;;;;;;GAoBG;AACH,wBAAgB,uBAAuB,CAAC,YAAY,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM,EAAE,OAAO,EAAE,MAAM,GAAG,IAAI,CAgFjG;AA4FD;;;;;;;;;;;;;;;;;;GAkBG;AACH,wBAAgB,eAAe,CAAC,YAAY,EAAE,MAAM,EAAE,QAAQ,EAAE,MAAM,GAAG,IAAI,CAsC5E;AAED,MAAM,WAAW,YAAY;IAC3B,IAAI,EAAE,MAAM,CAAC;IACb,gEAAgE;IAChE,YAAY,CAAC,EAAE,OAAO,CAAC;IACvB,6FAA6F;IAC7F,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,kGAAkG;IAClG,UAAU,CAAC,EAAE,OAAO,CAAC;CACtB;AAID,wBAAsB,QAAQ,CAAC,OAAO,EAAE,YAAY,GAAG,OAAO,CAAC,IAAI,CAAC,CAukBnE"}
+{"version":3,"file":"start.d.ts","sourceRoot":"","sources":["../../src/commands/start.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AA0BH;;;;;;;;;;;;;;;;;GAiBG;AACH,eAAO,MAAM,8BAA8B,UAG1C,CAAC;AACF,eAAO,MAAM,2BAA2B,aAEtC,CAAC;AAEH;;;;GAIG;AACH,wBAAgB,qBAAqB,CAAC,IAAI,EAAE,MAAM,GAAG,OAAO,CAK3D;AA4BD;;;;;;;;;;;;;;;;;;;;GAoBG;AACH,wBAAgB,uBAAuB,CAAC,YAAY,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM,EAAE,OAAO,EAAE,MAAM,GAAG,IAAI,CAgFjG;AA4FD;;;;;;;;;;;;;;;;;;GAkBG;AACH,wBAAgB,eAAe,CAAC,YAAY,EAAE,MAAM,EAAE,QAAQ,EAAE,MAAM,GAAG,IAAI,CAsC5E;AAED,MAAM,WAAW,YAAY;IAC3B,IAAI,EAAE,MAAM,CAAC;IACb,gEAAgE;IAChE,YAAY,CAAC,EAAE,OAAO,CAAC;IACvB,6FAA6F;IAC7F,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,kGAAkG;IAClG,UAAU,CAAC,EAAE,OAAO,CAAC;CACtB;AAID,wBAAsB,QAAQ,CAAC,OAAO,EAAE,YAAY,GAAG,OAAO,CAAC,IAAI,CAAC,CA0mBnE"}

package/dist/commands/start.js

@@ -18,6 +18,7 @@ import { checkConfigGeneration } from '../lib/config-generation.js';
 import { getConfigValue, setConfigValue } from '../lib/config.js';
 import { checkLiveness, claimLock, formatLockEvidence, lockPath, readLock, removeLock, writeLock } from '../lib/leader-lock.js';
 import { resolveCoordinationToken } from '../lib/coordination-token.js';
+import { startupReport } from '../lib/startup-report.js';
 const PACKAGE_NAME = '@memnexus-ai/mx-agent-cli';
 /**
  * Agent-config / hook paths whose rebase conflict must FAIL CLOSED
@@ -69,6 +70,7 @@ function refuseLiveLeader(worktreePath, team, lock, result) {
     console.log(chalk.yellow('  Two leaders in one worktree interleave writes and corrupt team state (#3946).'));
     console.log(chalk.yellow(`  If you are certain no other session is running: mx-agent unlock ${team}`));
     console.log();
+    startupReport.finalize('refused');
     process.exit(1);
 }
 /** Register a process-exit backstop that removes OUR lock on any exit path
@@ -322,6 +324,18 @@ export function restoreOwnStash(worktreePath, stashSha) {
 const MAX_DIRECTIVE_LENGTH = 2000;
 export async function runStart(options) {
     const { name, experimental = false, directive, testInject = false } = options;
+    // ── Startup log capture (#4350) ────────────────────────────────────
+    // Tee every line this command prints into ONE durable StartupReport, and
+    // register a process-exit safety net so any unhandled exit path still writes
+    // a terminal record. Seed the context we already know; worktree/project are
+    // filled in once resolved (finalize reads them then). Capture is installed
+    // FIRST so even the earliest checks below are recorded.
+    startupReport.setContext({
+        team: name,
+        cliVersion: getInstalledVersion(),
+    });
+    startupReport.registerExitSafetyNet();
+    startupReport.installConsoleCapture();
     // SECURITY: The directive is injected verbatim into the agent prompt.
     // This is safe only because the operator (the person running mx-agent start)
     // is the trust principal. If directive values ever come from untrusted
@@ -329,6 +343,7 @@ export async function runStart(options) {
     // structured prompting (e.g., XML-delimited user input blocks) is required.
     if (directive && directive.length > MAX_DIRECTIVE_LENGTH) {
         console.error(chalk.red(`Error: --directive exceeds ${MAX_DIRECTIVE_LENGTH} characters (got ${directive.length}).`));
+        startupReport.finalize('refused');
         process.exit(1);
     }
     let projectRoot;
@@ -337,8 +352,11 @@ export async function runStart(options) {
     }
     catch (err) {
         console.error(chalk.red(`Error: ${err instanceof Error ? err.message : String(err)}`));
+        startupReport.finalize('refused');
         process.exit(1);
     }
+    const { basename: basenamePath } = await import('path');
+    startupReport.setContext({ project: basenamePath(projectRoot) });
     const cfg = resolveProjectConfig(loadProjectConfig(projectRoot));
     // ── 0. Version staleness check (non-blocking) ──────────────────────
     await warnIfOutdated();
@@ -353,6 +371,7 @@ export async function runStart(options) {
         console.error(chalk.red(`Team '${name}' not found.`));
         console.error(chalk.dim(`  No worktree found in ${projectRoot}/.worktrees/ matching '${name}' or '${name}-*'`));
         console.error(chalk.dim(`  Run: agent create --roleguide <path> --name ${name}`));
+        startupReport.finalize('refused');
         process.exit(1);
     }
     // ── 2. Resolve slot ────────────────────────────────────────────────
@@ -360,6 +379,8 @@ export async function runStart(options) {
     // or just the team slug. Try both.
     const { basename } = await import('path');
     const worktreeDirName = basename(worktreePath);
+    // Worktree resolved — record it so finalize writes to the right log file.
+    startupReport.setContext({ worktree: worktreeDirName });
     let slot = getSlot(projectRoot, worktreeDirName, cfg.worktreeDir);
     if (slot === null) {
         // Try the short name
@@ -647,6 +668,7 @@ export async function runStart(options) {
                             },
                         });
                         removeLock(worktreePath);
+                        startupReport.finalize('refused');
                         process.exit(1);
                     }
                     // ── Tier 2: ordinary source conflict ────────────────────────
@@ -812,6 +834,18 @@ export async function runStart(options) {
             : '') +
         `After startup${directive ? ' and the directive' : ''}, act only within the authority, evidence tier, scope, and stop conditions defined by the roleguide.`;
     // ── 9. Launch session ──────────────────────────────────────────────
+    // Everything the start command does BEFORE handing off to the session has
+    // now succeeded. Finalize the durable startup log with 'ok' here (#4350):
+    // all config sync, warnings, and refusal-relevant output happen above this
+    // point, and finalizing before launch means a correct 'ok' outcome even
+    // though the launched session later drives process.exit with its own code
+    // (the exit safety net is a no-op once finalized). finalize also removes the
+    // console tee, so the session's own output is left completely untouched.
+    // KNOWN LIMITATION (#4350 Phase 2): finalize('ok') runs BEFORE the claude child
+    // is confirmed to spawn, so a post-finalize launch failure is not reflected in
+    // the recorded outcome. Phase 2 (central shipping + launch-result signal) will
+    // revisit whether the outcome should be deferred until spawn is confirmed.
+    startupReport.finalize('ok');
     if (experimental) {
         // Experimental: Agent SDK runtime with async Slack communication support.
         // Same setup (steps 1-8) — only the session launcher differs.