@memnexus-ai/mx-agent-cli 0.1.157 → 0.1.158

package/dist/__tests__/leader-lock.test.d.ts

@@ -0,0 +1,12 @@
+/**
+ * Tests for the leader-session start guard (Platform v2.30, #3946).
+ *
+ * Covers: lock write/format, refusal on a live lock (real child process whose
+ * cwd is the worktree), stale-lock replacement (dead pid), the fail-open path
+ * (indeterminate probe), and the unlock command. The "teammates never hit this
+ * lock" property is process-design (Task-tool sub-agents are not spawned via
+ * `mx-agent start`), so it is asserted as a documented invariant, not a runtime
+ * check — see the final describe block.
+ */
+export {};
+//# sourceMappingURL=leader-lock.test.d.ts.map

package/dist/__tests__/leader-lock.test.d.ts.map

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

package/dist/__tests__/leader-lock.test.js

@@ -0,0 +1,293 @@
+/**
+ * Tests for the leader-session start guard (Platform v2.30, #3946).
+ *
+ * Covers: lock write/format, refusal on a live lock (real child process whose
+ * cwd is the worktree), stale-lock replacement (dead pid), the fail-open path
+ * (indeterminate probe), and the unlock command. The "teammates never hit this
+ * lock" property is process-design (Task-tool sub-agents are not spawned via
+ * `mx-agent start`), so it is asserted as a documented invariant, not a runtime
+ * check — see the final describe block.
+ */
+import { describe, it, expect, beforeEach, afterEach, vi } from 'vitest';
+import { spawn, spawnSync } from 'child_process';
+import { existsSync, mkdtempSync, readFileSync, rmSync, writeFileSync } from 'fs';
+// Fail-open simulation: a hoisted flag lets a single test hide `/proc` from
+// existsSync (simulating a platform with no readable /proc) while every other
+// fs call — and every other test — uses the real implementation.
+const procHider = vi.hoisted(() => ({ hide: false }));
+vi.mock('fs', async (importActual) => {
+    const actual = await importActual();
+    return {
+        ...actual,
+        default: actual,
+        existsSync: (p) => procHider.hide && p === '/proc' ? false : actual.existsSync(p),
+    };
+});
+import { tmpdir } from 'os';
+import { join } from 'path';
+import { LOCK_FILENAME, MAX_LOCK_BYTES, checkLiveness, claimLock, formatLockEvidence, lockPath, probePid, readLock, removeLock, sanitizeField, updateChildPid, writeLock, } from '../lib/leader-lock.js';
+const hasProc = existsSync('/proc');
+let wt;
+function makeLock(over = {}) {
+    return {
+        team: 'platform',
+        worktreePath: wt,
+        wrapperPid: process.pid,
+        childPid: null,
+        startedAt: new Date().toISOString(),
+        version: '2.30.0',
+        ...over,
+    };
+}
+/** A pid guaranteed dead: spawn `true`, wait for it to exit, reuse its pid. */
+function deadPid() {
+    const r = spawnSync('true', []);
+    // r.pid is the pid of the now-exited process. It is overwhelmingly unlikely
+    // to be immediately recycled to a process whose cwd is our fixture worktree.
+    return r.pid ?? 999999;
+}
+beforeEach(() => {
+    wt = mkdtempSync(join(tmpdir(), 'mx-leaderlock-'));
+});
+afterEach(() => {
+    rmSync(wt, { recursive: true, force: true });
+});
+// ── Lock write / read / format ───────────────────────────────────────────────
+describe('lock write/read/format', () => {
+    it('writes a JSON lock with all required fields at <worktree>/.mx-leader.lock', () => {
+        const lock = makeLock({ childPid: 1234 });
+        writeLock(wt, lock);
+        expect(lockPath(wt)).toBe(join(wt, LOCK_FILENAME));
+        const parsed = JSON.parse(readFileSync(lockPath(wt), 'utf-8'));
+        expect(parsed.team).toBe('platform');
+        expect(parsed.worktreePath).toBe(wt);
+        expect(parsed.wrapperPid).toBe(process.pid);
+        expect(parsed.childPid).toBe(1234);
+        expect(parsed.version).toBe('2.30.0');
+        expect(typeof parsed.startedAt).toBe('string');
+    });
+    it('readLock reports absent when no lock exists', () => {
+        const r = readLock(wt);
+        expect(r.present).toBe(false);
+        expect(r.lock).toBeNull();
+    });
+    it('readLock reports malformed (present, null lock) on invalid JSON', () => {
+        writeFileSync(lockPath(wt), '{ not json', 'utf-8');
+        const r = readLock(wt);
+        expect(r.present).toBe(true);
+        expect(r.lock).toBeNull();
+        expect(r.parseError).toBeTruthy();
+    });
+    it('readLock rejects a JSON object missing required fields', () => {
+        writeFileSync(lockPath(wt), JSON.stringify({ team: 'x' }), 'utf-8');
+        const r = readLock(wt);
+        expect(r.present).toBe(true);
+        expect(r.lock).toBeNull();
+    });
+    it('updateChildPid patches the child pid in place', () => {
+        writeLock(wt, makeLock());
+        updateChildPid(wt, 5555);
+        expect(readLock(wt).lock?.childPid).toBe(5555);
+    });
+    it('formatLockEvidence includes pids, cwd/started-at, and version', () => {
+        const lock = makeLock({ childPid: 4242 });
+        const evidence = formatLockEvidence(lock);
+        expect(evidence).toContain(String(process.pid));
+        expect(evidence).toContain('4242');
+        expect(evidence).toContain(lock.startedAt);
+        expect(evidence).toContain(wt);
+        expect(evidence).toContain('2.30.0');
+    });
+});
+// ── Atomic claim (Should-Fix 1) ──────────────────────────────────────────────
+describe('claimLock — atomic mutual exclusion', () => {
+    it('a single exclusive create succeeds and writes the lock', () => {
+        const r = claimLock(wt, makeLock());
+        expect(r.ok).toBe(true);
+        expect(readLock(wt).present).toBe(true);
+    });
+    it('two concurrent claims for the same worktree → exactly one wins (EEXIST for the loser)', () => {
+        // O_CREAT|O_EXCL is atomic on a local FS: back-to-back claims model the race
+        // (the second observes the first's file). Exactly one ok, one reason=exists.
+        const a = claimLock(wt, makeLock({ team: 'A' }));
+        const b = claimLock(wt, makeLock({ team: 'B' }));
+        const wins = [a, b].filter((r) => r.ok).length;
+        const losers = [a, b].filter((r) => !r.ok && r.reason === 'exists').length;
+        expect(wins).toBe(1);
+        expect(losers).toBe(1);
+        // The winner's content is intact — the loser did not overwrite it.
+        expect(readLock(wt).lock?.team).toBe('A');
+    });
+    it('claim after removal succeeds (stale-replacement path)', () => {
+        expect(claimLock(wt, makeLock()).ok).toBe(true);
+        expect(claimLock(wt, makeLock()).ok).toBe(false); // EEXIST
+        removeLock(wt);
+        expect(claimLock(wt, makeLock()).ok).toBe(true); // room freed
+    });
+});
+// ── Evidence sanitization (Should-Fix 2) ─────────────────────────────────────
+describe('sanitizeField / formatLockEvidence — terminal-escape hardening', () => {
+    it('strips C0/C1/DEL control chars (OSC/CSI injection) from a crafted field', () => {
+        // Crafted team: OSC tab-title rewrite + CSI erase-line + a DEL char.
+        const evil = '\x1b]0;PWNED\x07\x1b[2Kplatform\x7f\x9b31m';
+        const clean = sanitizeField(evil);
+        // No ESC (0x1B), BEL (0x07), DEL (0x7F), or C1 (0x9B) survive.
+        expect(clean).not.toMatch(new RegExp("[\u0000-\u001F\u007F-\u009F]"));
+        expect(clean).toContain('platform');
+    });
+    it('caps field length', () => {
+        const long = 'x'.repeat(5000);
+        const out = sanitizeField(long, 256);
+        expect(out.length).toBeLessThanOrEqual(256 + '…(truncated)'.length);
+        expect(out).toContain('truncated');
+    });
+    it('formatLockEvidence output for an escape-bearing lock carries no control bytes', () => {
+        const lock = makeLock({
+            team: '\x1b]0;evil\x07',
+            version: 'v\x1b[31m2.30',
+            startedAt: '2026-01-01\x08T00:00',
+            worktreePath: wt + '\x1b[2K',
+        });
+        const evidence = formatLockEvidence(lock);
+        // Evidence is intentionally multi-line (\n is our own separator); assert no
+        // control chars OTHER than newline survive — all attacker escapes are stripped.
+        expect(evidence).not.toMatch(new RegExp("[\u0000-\u0009\u000B-\u001F\u007F-\u009F]"));
+    });
+});
+// ── Oversize lock file (INFO: resource-exhaustion guard) ──────────────────────
+describe('readLock — size guard', () => {
+    it('treats an oversize lock file as malformed (fail open), never reads it', () => {
+        // Write a lock file larger than the cap.
+        writeFileSync(lockPath(wt), 'x'.repeat(MAX_LOCK_BYTES + 1), 'utf-8');
+        const r = readLock(wt);
+        expect(r.present).toBe(true);
+        expect(r.lock).toBeNull();
+        expect(r.parseError).toMatch(/too large/);
+    });
+});
+// ── Refusal on a live lock (real child process) ──────────────────────────────
+describe('checkLiveness — live lock', () => {
+    let child;
+    afterEach(() => {
+        if (child && child.pid) {
+            try {
+                process.kill(child.pid, 'SIGKILL');
+            }
+            catch { /* already gone */ }
+        }
+        child = undefined;
+    });
+    it.skipIf(!hasProc)('detects a live child whose cwd is the worktree → state=live', async () => {
+        // Spawn a real, long-lived process with cwd set to the fixture worktree so
+        // the /proc/<pid>/cwd discriminator resolves to this worktree.
+        child = spawn(process.execPath, ['-e', 'setInterval(() => {}, 1000)'], {
+            cwd: wt,
+            stdio: 'ignore',
+        });
+        // Give the OS a moment to establish /proc/<pid>.
+        await new Promise((r) => setTimeout(r, 100));
+        const pid = child.pid;
+        // Probe directly.
+        const probe = probePid(pid, wt);
+        expect(probe.state).toBe('live');
+        expect(probe.matchedBy).toBe('cwd');
+        // And via the aggregate check (as the child pid on the lock).
+        const lock = makeLock({ wrapperPid: deadPid(), childPid: pid });
+        writeLock(wt, lock);
+        const result = checkLiveness(lock, wt);
+        expect(result.state).toBe('live');
+        expect(result.livePids).toContain(pid);
+    });
+});
+// ── Stale-lock replacement (dead pids) ───────────────────────────────────────
+describe('checkLiveness — stale lock', () => {
+    it.skipIf(!hasProc)('reports stale when all recorded pids are dead', () => {
+        const lock = makeLock({ wrapperPid: deadPid(), childPid: deadPid() });
+        writeLock(wt, lock);
+        const result = checkLiveness(lock, wt);
+        expect(result.state).toBe('stale');
+        expect(result.livePids).toHaveLength(0);
+    });
+    it.skipIf(!hasProc)('a live process in a DIFFERENT worktree is not a live match (mismatch → dead)', async () => {
+        const other = mkdtempSync(join(tmpdir(), 'mx-other-'));
+        const child = spawn(process.execPath, ['-e', 'setInterval(() => {}, 1000)'], {
+            cwd: other,
+            stdio: 'ignore',
+        });
+        try {
+            await new Promise((r) => setTimeout(r, 100));
+            const probe = probePid(child.pid, wt);
+            expect(probe.state).toBe('dead');
+            expect(probe.reason).toMatch(/different worktree/);
+        }
+        finally {
+            if (child.pid) {
+                try {
+                    process.kill(child.pid, 'SIGKILL');
+                }
+                catch { /* gone */ }
+            }
+            rmSync(other, { recursive: true, force: true });
+        }
+    });
+});
+// ── Fail-open path (indeterminate) ───────────────────────────────────────────
+describe('checkLiveness — fail open', () => {
+    afterEach(() => {
+        vi.restoreAllMocks();
+    });
+    it('probePid returns indeterminate when /proc is unavailable (fail open)', () => {
+        procHider.hide = true;
+        try {
+            // Aggregate must fail open (indeterminate), not declare stale/absent.
+            const lock = makeLock({ wrapperPid: process.pid, childPid: null });
+            expect(probePid(process.pid, wt).state).toBe('indeterminate');
+            expect(checkLiveness(lock, wt).state).toBe('indeterminate');
+        }
+        finally {
+            procHider.hide = false;
+        }
+    });
+    it('an invalid pid is treated as dead, not indeterminate', () => {
+        expect(probePid(-1, wt).state).toBe('dead');
+        expect(probePid(0, wt).state).toBe('dead');
+    });
+    it('a lock referencing only dead/invalid pids never reports live', () => {
+        const lock = makeLock({ wrapperPid: 0, childPid: null });
+        const result = checkLiveness(lock, wt);
+        expect(result.state).not.toBe('live');
+    });
+});
+// ── removeLock ───────────────────────────────────────────────────────────────
+describe('removeLock', () => {
+    it('removes an existing lock and is idempotent', () => {
+        writeLock(wt, makeLock());
+        expect(readLock(wt).present).toBe(true);
+        removeLock(wt);
+        expect(readLock(wt).present).toBe(false);
+        // Second call must not throw.
+        expect(() => removeLock(wt)).not.toThrow();
+    });
+});
+// ── Process-design invariant: teammates never hit this lock ───────────────────
+describe('invariant — sub-agent teammates never touch the leader lock', () => {
+    // Sub-agent teammates are spawned via the Task tool INSIDE a running leader
+    // session, never via `mx-agent start`. Only `mx-agent start` claims/checks the
+    // lock (see start.ts guardAndClaimLeaderLock + claude.ts launchClaudeSession).
+    // There is therefore no runtime code path from a teammate to the lock — this is
+    // a process-design property, asserted here as documentation + a guard against a
+    // future refactor wiring lock code into a shared launch path.
+    it('lock claim/read is only reachable from the start command surface', () => {
+        const startSrc = readFileSync(join(__dirname, '..', 'commands', 'start.ts'), 'utf-8');
+        const claudeSrc = readFileSync(join(__dirname, '..', 'lib', 'claude.ts'), 'utf-8');
+        // The lock is claimed atomically from the default launch path.
+        expect(startSrc).toContain('guardAndClaimLeaderLock');
+        expect(startSrc).toContain('claimLock');
+        // The launcher patches childPid and removes the lock, but does not claim it.
+        expect(claudeSrc).toContain('updateChildPid');
+        // agent-session (the SDK/teammate-adjacent path) must not import the lock.
+        const agentSrc = readFileSync(join(__dirname, '..', 'lib', 'agent-session.ts'), 'utf-8');
+        expect(agentSrc).not.toContain('leader-lock');
+    });
+});
+//# sourceMappingURL=leader-lock.test.js.map

package/dist/__tests__/leader-lock.test.js.map

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

package/dist/__tests__/team-name-propagation.test.d.ts

@@ -5,6 +5,9 @@
  * child process env under CLAUDE_TEAM_NAME so that v2.10/v2.11 hook telemetry
  * can attribute data to the consumer team. See issue #3083 and dev-log
  * product/dev-log/platform-team/v2.11-hook-telemetry-and-team-name-inspection.md.
+ *
+ * v2.30 (#3946): launchClaudeSession switched spawnSync → async spawn to expose
+ * the child pid for the leader-session lock. The mock now models the async child.
  */
 export {};
 //# sourceMappingURL=team-name-propagation.test.d.ts.map

package/dist/__tests__/team-name-propagation.test.d.ts.map

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

package/dist/__tests__/team-name-propagation.test.js

@@ -5,64 +5,122 @@
  * child process env under CLAUDE_TEAM_NAME so that v2.10/v2.11 hook telemetry
  * can attribute data to the consumer team. See issue #3083 and dev-log
  * product/dev-log/platform-team/v2.11-hook-telemetry-and-team-name-inspection.md.
+ *
+ * v2.30 (#3946): launchClaudeSession switched spawnSync → async spawn to expose
+ * the child pid for the leader-session lock. The mock now models the async child.
  */
 import { describe, it, expect, vi, beforeEach, afterEach } from 'vitest';
-import { readFileSync } from 'fs';
+import { mkdtempSync, readFileSync, rmSync } from 'fs';
+import { tmpdir } from 'os';
 import { dirname, join } from 'path';
 import { fileURLToPath } from 'url';
+import { readLock, writeLock } from '../lib/leader-lock.js';
 const __dirname = dirname(fileURLToPath(import.meta.url));
 // -- Mock child_process so launchClaudeSession can be tested in isolation. ---
-// The mock captures the env dict passed to spawnSync and returns a no-op result
-// so the function returns without exiting the test process.
-const spawnSyncMock = vi.fn();
+// The mock captures the env dict passed to spawn and returns a fake child that
+// exits so the function resolves without exiting the test process.
+const spawnMock = vi.fn();
 vi.mock('child_process', () => ({
-    spawnSync: (...args) => spawnSyncMock(...args),
+    spawn: (...args) => spawnMock(...args),
+    spawnSync: vi.fn(),
     execSync: vi.fn(),
 }));
+/** Fake child process that reports a pid and fires the given exit asynchronously. */
+function makeFakeChild(code = 0, signal = null) {
+    return {
+        pid: 4242,
+        once(event, cb) {
+            if (event === 'exit')
+                setImmediate(() => cb(code, signal));
+            // 'error' never fires in these fakes.
+        },
+    };
+}
 describe('launchClaudeSession — CLAUDE_TEAM_NAME propagation', () => {
+    let wt;
     beforeEach(() => {
-        spawnSyncMock.mockReset();
-        spawnSyncMock.mockReturnValue({ status: 0, error: undefined });
+        wt = mkdtempSync(join(tmpdir(), 'mx-launch-'));
+        spawnMock.mockReset();
+        spawnMock.mockReturnValue(makeFakeChild());
     });
     afterEach(() => {
         vi.restoreAllMocks();
+        rmSync(wt, { recursive: true, force: true });
     });
     it('passes CLAUDE_TEAM_NAME into the child env when spawning claude', async () => {
         const { launchClaudeSession } = await import('../lib/claude.js');
-        launchClaudeSession({
-            worktreePath: '/tmp/wt',
+        await launchClaudeSession({
+            worktreePath: wt,
             worktreeName: 'wt-test',
             branch: 'main',
             slot: 0,
             initialPrompt: 'hello',
             teamName: 'platform-team',
         });
-        expect(spawnSyncMock).toHaveBeenCalledTimes(1);
-        const [, , opts] = spawnSyncMock.mock.calls[0];
+        expect(spawnMock).toHaveBeenCalledTimes(1);
+        const [, , opts] = spawnMock.mock.calls[0];
         expect(opts.env).toBeDefined();
         expect(opts.env.CLAUDE_TEAM_NAME).toBe('platform-team');
         // Sanity: existing worktree vars still present
-        expect(opts.env.CLAUDE_WORKTREE_PATH).toBe('/tmp/wt');
+        expect(opts.env.CLAUDE_WORKTREE_PATH).toBe(wt);
         expect(opts.env.CLAUDE_WORKTREE_NAME).toBe('wt-test');
         expect(opts.env.CLAUDE_WORKTREE_SLOT).toBe('0');
         expect(opts.env.CLAUDE_WORKTREE_BRANCH).toBe('main');
     });
     it('passes an empty-string branch through but still sets CLAUDE_TEAM_NAME', async () => {
         const { launchClaudeSession } = await import('../lib/claude.js');
-        launchClaudeSession({
-            worktreePath: '/tmp/wt',
+        await launchClaudeSession({
+            worktreePath: wt,
             worktreeName: 'wt-test',
             branch: null,
             slot: 2,
             initialPrompt: 'hi',
             teamName: 'extraction-team',
         });
-        const [, , opts] = spawnSyncMock.mock.calls[0];
+        const [, , opts] = spawnMock.mock.calls[0];
         expect(opts.env.CLAUDE_TEAM_NAME).toBe('extraction-team');
         expect(opts.env.CLAUDE_WORKTREE_BRANCH).toBe('');
         expect(opts.env.CLAUDE_WORKTREE_SLOT).toBe('2');
     });
 });
+describe('launchClaudeSession — leader-lock cleanup on exit (#3946 Should-Fix 3)', () => {
+    let wt;
+    beforeEach(() => {
+        wt = mkdtempSync(join(tmpdir(), 'mx-launch-exit-'));
+        spawnMock.mockReset();
+    });
+    afterEach(() => {
+        vi.restoreAllMocks();
+        rmSync(wt, { recursive: true, force: true });
+    });
+    function seedLock() {
+        const lock = {
+            team: 'platform', worktreePath: wt, wrapperPid: process.pid,
+            childPid: null, startedAt: new Date().toISOString(), version: 't',
+        };
+        writeLock(wt, lock);
+        expect(readLock(wt).present).toBe(true);
+    }
+    it('removes the lock on a NON-ZERO child exit (process.exit path skips finally)', async () => {
+        seedLock();
+        spawnMock.mockReturnValue(makeFakeChild(3, null)); // child exits code 3
+        const exitSpy = vi.spyOn(process, 'exit').mockImplementation((() => {
+            throw new Error('process.exit called');
+        }));
+        const { launchClaudeSession } = await import('../lib/claude.js');
+        await expect(launchClaudeSession({ worktreePath: wt, worktreeName: 'w', branch: 'main', slot: 0, initialPrompt: 'x', teamName: 'platform' })).rejects.toThrow('process.exit called');
+        expect(exitSpy).toHaveBeenCalledWith(3);
+        // The explicit removeLock before process.exit must have cleaned the lock.
+        expect(readLock(wt).present).toBe(false);
+    });
+    it('removes the lock on a clean (zero) exit via finally', async () => {
+        seedLock();
+        spawnMock.mockReturnValue(makeFakeChild(0, null));
+        const { launchClaudeSession } = await import('../lib/claude.js');
+        await launchClaudeSession({ worktreePath: wt, worktreeName: 'w', branch: 'main', slot: 0, initialPrompt: 'x', teamName: 'platform' });
+        expect(readLock(wt).present).toBe(false);
+    });
+});
 describe('launchAgentSession — CLAUDE_TEAM_NAME propagation (source-level)', () => {
     // launchAgentSession drives an interactive Agent SDK loop with stdin raw
     // mode, a MessageBus, and an async iterator. Full behavioral testing would

package/dist/__tests__/team-name-propagation.test.js.map

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

package/dist/__tests__/unlock.test.d.ts

@@ -0,0 +1,11 @@
+/**
+ * Tests for `mx-agent unlock <team>` (Platform v2.30, #3946).
+ *
+ * The command resolves the team worktree, enforces a containment check (the
+ * resolved worktree must live under <projectRoot>/<worktreeDir>), prints lock
+ * evidence, and removes the lock after confirmation. We mock worktree/project
+ * resolution so the test targets a temp fixture, and assert removal, the
+ * confirmation gate, and the containment guard.
+ */
+export {};
+//# sourceMappingURL=unlock.test.d.ts.map

package/dist/__tests__/unlock.test.d.ts.map

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

package/dist/__tests__/unlock.test.js

@@ -0,0 +1,100 @@
+/**
+ * Tests for `mx-agent unlock <team>` (Platform v2.30, #3946).
+ *
+ * The command resolves the team worktree, enforces a containment check (the
+ * resolved worktree must live under <projectRoot>/<worktreeDir>), prints lock
+ * evidence, and removes the lock after confirmation. We mock worktree/project
+ * resolution so the test targets a temp fixture, and assert removal, the
+ * confirmation gate, and the containment guard.
+ */
+import { describe, it, expect, beforeEach, afterEach, vi } from 'vitest';
+import { mkdirSync, mkdtempSync, rmSync } from 'fs';
+import { tmpdir } from 'os';
+import { join } from 'path';
+import { readLock, writeLock } from '../lib/leader-lock.js';
+let projectRoot;
+let wt;
+// Overridable per-test: what findWorktreePath returns (defaults to the in-tree wt).
+let resolvedWorktree;
+vi.mock('../lib/worktree.js', () => ({
+    findProjectRoot: () => projectRoot,
+    findWorktreePath: () => resolvedWorktree,
+}));
+vi.mock('../lib/project-config.js', () => ({
+    loadProjectConfig: () => ({}),
+    resolveProjectConfig: () => ({ worktreeDir: '.worktrees' }),
+}));
+function makeLock() {
+    return {
+        team: 'platform',
+        worktreePath: wt,
+        wrapperPid: 0, // invalid → never "live", so no scary output paths break the test
+        childPid: null,
+        startedAt: new Date().toISOString(),
+        version: '2.30.0',
+    };
+}
+beforeEach(() => {
+    projectRoot = mkdtempSync(join(tmpdir(), 'mx-unlock-root-'));
+    wt = join(projectRoot, '.worktrees', 'platform');
+    mkdirSync(wt, { recursive: true });
+    resolvedWorktree = wt;
+    vi.spyOn(console, 'log').mockImplementation(() => { });
+    vi.spyOn(console, 'error').mockImplementation(() => { });
+});
+afterEach(() => {
+    vi.restoreAllMocks();
+    rmSync(projectRoot, { recursive: true, force: true });
+});
+describe('runUnlock', () => {
+    it('removes the lock when --yes is passed (non-interactive)', async () => {
+        writeLock(wt, makeLock());
+        expect(readLock(wt).present).toBe(true);
+        const { runUnlock } = await import('../commands/unlock.js');
+        await runUnlock({ name: 'platform', yes: true });
+        expect(readLock(wt).present).toBe(false);
+    });
+    it('no-ops cleanly when no lock is present', async () => {
+        const { runUnlock } = await import('../commands/unlock.js');
+        await expect(runUnlock({ name: 'platform', yes: true })).resolves.toBeUndefined();
+        expect(readLock(wt).present).toBe(false);
+    });
+    it('refuses without --yes when stdin is not a TTY (leaves lock in place)', async () => {
+        writeLock(wt, makeLock());
+        const isTTY = process.stdin.isTTY;
+        Object.defineProperty(process.stdin, 'isTTY', { value: false, configurable: true });
+        const exitSpy = vi.spyOn(process, 'exit').mockImplementation((() => {
+            throw new Error('process.exit called');
+        }));
+        try {
+            const { runUnlock } = await import('../commands/unlock.js');
+            await expect(runUnlock({ name: 'platform', yes: false })).rejects.toThrow('process.exit called');
+            expect(exitSpy).toHaveBeenCalledWith(1);
+            // Lock must remain — refusal must not remove it.
+            expect(readLock(wt).present).toBe(true);
+        }
+        finally {
+            Object.defineProperty(process.stdin, 'isTTY', { value: isTTY, configurable: true });
+        }
+    });
+    it('refuses to operate on a worktree outside the worktrees directory (containment guard)', async () => {
+        // Point resolution at a path OUTSIDE <projectRoot>/.worktrees and seed a lock there.
+        const outside = mkdtempSync(join(tmpdir(), 'mx-unlock-outside-'));
+        resolvedWorktree = outside;
+        writeLock(outside, makeLock());
+        const exitSpy = vi.spyOn(process, 'exit').mockImplementation((() => {
+            throw new Error('process.exit called');
+        }));
+        try {
+            const { runUnlock } = await import('../commands/unlock.js');
+            await expect(runUnlock({ name: 'platform', yes: true })).rejects.toThrow('process.exit called');
+            expect(exitSpy).toHaveBeenCalledWith(1);
+            // The out-of-tree lock must be untouched — containment refused before removal.
+            expect(readLock(outside).present).toBe(true);
+        }
+        finally {
+            rmSync(outside, { recursive: true, force: true });
+        }
+    });
+});
+//# sourceMappingURL=unlock.test.js.map

package/dist/__tests__/unlock.test.js.map

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