devharness 0.8.0

package/build/server-claims.test.js

@@ -0,0 +1,197 @@
+import { describe, it, expect, beforeEach, afterEach } from 'vitest';
+import { mkdtempSync, rmSync, writeFileSync, readdirSync } from 'fs';
+import { tmpdir } from 'os';
+import { join } from 'path';
+import { ServerClaimsStore } from './server-claims.js';
+import { initializePaths } from './helpers/paths.js';
+/**
+ * Claims are written next to servers.json, which getOutputPath() resolves from
+ * the working directory - so these run in a scratch cwd.
+ */
+let workDir;
+let originalCwd;
+let originalGlobalDir;
+beforeEach(() => {
+    originalCwd = process.cwd();
+    workDir = mkdtempSync(join(tmpdir(), 'cdp-claims-test-'));
+    process.chdir(workDir);
+    // Point the global scope at the scratch dir too - without this the
+    // global-scope cases write claims into the developer's real ~/.cdp-tools.
+    originalGlobalDir = process.env.CDP_TOOLS_DIR;
+    process.env.CDP_TOOLS_DIR = join(workDir, 'global');
+    initializePaths();
+});
+afterEach(() => {
+    process.chdir(originalCwd);
+    if (originalGlobalDir === undefined)
+        delete process.env.CDP_TOOLS_DIR;
+    else
+        process.env.CDP_TOOLS_DIR = originalGlobalDir;
+    initializePaths();
+    rmSync(workDir, { recursive: true, force: true });
+});
+/** A store whose liveness and start times are entirely under the test's control. */
+function makeStore(supervisorPid, live) {
+    return new ServerClaimsStore({
+        supervisorPid,
+        isAlive: (pid) => live.has(pid),
+        startTimeReader: (pid) => live.get(pid) ?? '',
+    });
+}
+describe('ServerClaimsStore', () => {
+    it('claims a server and sees its own claim as live', async () => {
+        const live = new Map([[100, 'Mon Jan 1 00:00:00 2026']]);
+        const store = makeStore(100, live);
+        await store.claim('web', '/proj', false);
+        const claims = store.readAll(false);
+        expect(claims).toHaveLength(1);
+        expect(claims[0].claim).toMatchObject({ serverId: 'web', supervisorPid: 100 });
+        expect(store.isClaimLive(claims[0].claim)).toBe(true);
+    });
+    it('does not report its own claim as foreign', async () => {
+        const live = new Map([[100, 'start-100']]);
+        const store = makeStore(100, live);
+        await store.claim('web', '/proj', false);
+        expect(store.hasForeignLiveClaim('web', false)).toBe(false);
+    });
+    it('sees another live session as a foreign claim', async () => {
+        const live = new Map([[100, 'start-100'], [200, 'start-200']]);
+        await makeStore(200, live).claim('web', '/proj', false);
+        expect(makeStore(100, live).hasForeignLiveClaim('web', false)).toBe(true);
+    });
+    it('ignores a foreign claim whose session has died', async () => {
+        const live = new Map([[100, 'start-100'], [200, 'start-200']]);
+        await makeStore(200, live).claim('web', '/proj', false);
+        live.delete(200); // that session's supervisor is gone
+        expect(makeStore(100, live).hasForeignLiveClaim('web', false)).toBe(false);
+    });
+    it('ignores a claim whose pid was reused by a different process', async () => {
+        const live = new Map([[100, 'start-100'], [200, 'start-200']]);
+        await makeStore(200, live).claim('web', '/proj', false);
+        // Same pid, different process: alive, but not the one that claimed.
+        live.set(200, 'start-200-RECYCLED');
+        expect(makeStore(100, live).hasForeignLiveClaim('web', false)).toBe(false);
+    });
+    it('keeps a claim when start times cannot be read at all', async () => {
+        // No start time available (a platform without ps): a claim that cannot be
+        // disproved must count as live, since the cost of being wrong is stopping
+        // a running server.
+        const live = new Map([[200, '']]);
+        await makeStore(200, live).claim('web', '/proj', false);
+        expect(makeStore(100, new Map([[100, ''], [200, '']])).hasForeignLiveClaim('web', false)).toBe(true);
+    });
+    it('releases only its own claim', async () => {
+        const live = new Map([[100, 'start-100'], [200, 'start-200']]);
+        const mine = makeStore(100, live);
+        await mine.claim('web', '/proj', false);
+        await makeStore(200, live).claim('web', '/proj', false);
+        mine.release('web', false);
+        const remaining = mine.readAll(false);
+        expect(remaining).toHaveLength(1);
+        expect(remaining[0].claim.supervisorPid).toBe(200);
+    });
+    it('releases every claim it holds across both scopes', async () => {
+        const live = new Map([[100, 'start-100'], [200, 'start-200']]);
+        const mine = makeStore(100, live);
+        await mine.claim('web', '/proj', false);
+        await mine.claim('api', '/proj', false);
+        await makeStore(200, live).claim('web', '/proj', false);
+        mine.releaseAllOwn();
+        const remaining = mine.readAll(false);
+        expect(remaining.map((entry) => entry.claim.supervisorPid)).toEqual([200]);
+    });
+    it('collects dead claims and reports servers nobody is coming back for', async () => {
+        const live = new Map([[100, 'start-100'], [200, 'start-200'], [300, 'start-300']]);
+        await makeStore(200, live).claim('abandoned', '/proj', false);
+        await makeStore(300, live).claim('shared', '/proj', false);
+        await makeStore(100, live).claim('shared', '/proj', false);
+        live.delete(200); // the only claimant of 'abandoned' is gone
+        live.delete(300); // one of two claimants of 'shared' is gone
+        const store = makeStore(100, live);
+        const { removed, unclaimedServerIds } = store.collectDeadClaims(false);
+        expect(removed).toBe(2);
+        expect(unclaimedServerIds).toEqual(['abandoned']);
+        // The dead claims are gone from disk; the live one survives.
+        expect(store.readAll(false).map((entry) => entry.claim.supervisorPid)).toEqual([100]);
+    });
+    it('survives a corrupt claim file without throwing', async () => {
+        const live = new Map([[100, 'start-100']]);
+        const store = makeStore(100, live);
+        await store.claim('web', '/proj', false);
+        const dir = join(workDir, '.cdp-tools', 'server-claims');
+        writeFileSync(join(dir, 'garbage.json'), '{ not json');
+        expect(() => store.readAll(false)).not.toThrow();
+        expect(store.readAll(false)).toHaveLength(1);
+        expect(store.hasForeignLiveClaim('web', false)).toBe(false);
+    });
+    it('reports no claims when the directory does not exist', () => {
+        const store = makeStore(100, new Map([[100, 'start-100']]));
+        expect(store.readAll(false)).toEqual([]);
+        expect(store.hasForeignLiveClaim('web', false)).toBe(false);
+    });
+    it('keeps a claim for a server id containing path separators', async () => {
+        const live = new Map([[100, 'start-100']]);
+        const store = makeStore(100, live);
+        await store.claim('team/web', '/proj', false);
+        // The id must not escape the claims directory.
+        const dir = join(workDir, '.cdp-tools', 'server-claims');
+        expect(readdirSync(dir)).toHaveLength(1);
+        expect(store.hasForeignLiveClaim('team/web', false)).toBe(false);
+        expect(store.readAll(false)[0].claim.serverId).toBe('team/web');
+    });
+    it('protects a server while another live session works in its directory', async () => {
+        // The ordering that claims alone cannot cover: the other window was open
+        // first, so it never claimed the server, but it is plainly still using the
+        // project.
+        const live = new Map([[100, 'start-100'], [200, 'start-200']]);
+        await makeStore(200, live).registerSession('/proj');
+        const store = makeStore(100, live);
+        expect(store.hasOtherLiveSessionIn('/proj')).toBe(true);
+        expect(store.mayStop('web', '/proj', false)).toBe(false);
+        // A different project is unaffected.
+        expect(store.mayStop('web', '/other', false)).toBe(true);
+    });
+    it('ignores presence of a session that has died', async () => {
+        const live = new Map([[100, 'start-100'], [200, 'start-200']]);
+        await makeStore(200, live).registerSession('/proj');
+        live.delete(200);
+        expect(makeStore(100, live).mayStop('web', '/proj', false)).toBe(true);
+    });
+    it('ignores presence of a session whose pid was recycled', async () => {
+        const live = new Map([[100, 'start-100'], [200, 'start-200']]);
+        await makeStore(200, live).registerSession('/proj');
+        live.set(200, 'start-200-RECYCLED');
+        expect(makeStore(100, live).mayStop('web', '/proj', false)).toBe(true);
+    });
+    it('does not count its own presence against itself', async () => {
+        const live = new Map([[100, 'start-100']]);
+        const store = makeStore(100, live);
+        await store.registerSession('/proj');
+        expect(store.hasOtherLiveSessionIn('/proj')).toBe(false);
+        expect(store.mayStop('web', '/proj', false)).toBe(true);
+    });
+    it('collects presence records of dead sessions', async () => {
+        const live = new Map([[100, 'start-100'], [200, 'start-200'], [300, 'start-300']]);
+        await makeStore(200, live).registerSession('/proj');
+        await makeStore(300, live).registerSession('/proj');
+        live.delete(300);
+        const store = makeStore(100, live);
+        expect(store.collectDeadSessions()).toBe(1);
+        expect(store.readSessions().map((entry) => entry.presence.supervisorPid)).toEqual([200]);
+    });
+    it('withdraws its own presence on request', async () => {
+        const live = new Map([[100, 'start-100']]);
+        const store = makeStore(100, live);
+        await store.registerSession('/proj');
+        store.unregisterSession();
+        expect(makeStore(200, new Map([[100, 'start-100'], [200, 'start-200']])).hasOtherLiveSessionIn('/proj')).toBe(false);
+    });
+    it('keeps local and global claims apart', async () => {
+        const live = new Map([[100, 'start-100'], [200, 'start-200']]);
+        await makeStore(200, live).claim('web', '/proj', true);
+        const store = makeStore(100, live);
+        expect(store.hasForeignLiveClaim('web', false)).toBe(false);
+        expect(store.hasForeignLiveClaim('web', true)).toBe(true);
+    });
+});
+//# sourceMappingURL=server-claims.test.js.map

package/build/server-claims.test.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"server-claims.test.js","sourceRoot":"","sources":["../src/server-claims.test.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,QAAQ,EAAE,EAAE,EAAE,MAAM,EAAE,UAAU,EAAE,SAAS,EAAM,MAAM,QAAQ,CAAC;AACzE,OAAO,EAAE,WAAW,EAAE,MAAM,EAAc,aAAa,EAAa,WAAW,EAAE,MAAM,IAAI,CAAC;AAC5F,OAAO,EAAE,MAAM,EAAE,MAAM,IAAI,CAAC;AAC5B,OAAO,EAAE,IAAI,EAAE,MAAM,MAAM,CAAC;AAC5B,OAAO,EAAE,iBAAiB,EAAE,MAAM,oBAAoB,CAAC;AACvD,OAAO,EAAE,eAAe,EAAE,MAAM,oBAAoB,CAAC;AAErD;;;GAGG;AACH,IAAI,OAAe,CAAC;AACpB,IAAI,WAAmB,CAAC;AACxB,IAAI,iBAAqC,CAAC;AAE1C,UAAU,CAAC,GAAG,EAAE;IACd,WAAW,GAAG,OAAO,CAAC,GAAG,EAAE,CAAC;IAC5B,OAAO,GAAG,WAAW,CAAC,IAAI,CAAC,MAAM,EAAE,EAAE,kBAAkB,CAAC,CAAC,CAAC;IAC1D,OAAO,CAAC,KAAK,CAAC,OAAO,CAAC,CAAC;IACvB,mEAAmE;IACnE,0EAA0E;IAC1E,iBAAiB,GAAG,OAAO,CAAC,GAAG,CAAC,aAAa,CAAC;IAC9C,OAAO,CAAC,GAAG,CAAC,aAAa,GAAG,IAAI,CAAC,OAAO,EAAE,QAAQ,CAAC,CAAC;IACpD,eAAe,EAAE,CAAC;AACpB,CAAC,CAAC,CAAC;AAEH,SAAS,CAAC,GAAG,EAAE;IACb,OAAO,CAAC,KAAK,CAAC,WAAW,CAAC,CAAC;IAC3B,IAAI,iBAAiB,KAAK,SAAS;QAAE,OAAO,OAAO,CAAC,GAAG,CAAC,aAAa,CAAC;;QACjE,OAAO,CAAC,GAAG,CAAC,aAAa,GAAG,iBAAiB,CAAC;IACnD,eAAe,EAAE,CAAC;IAClB,MAAM,CAAC,OAAO,EAAE,EAAE,SAAS,EAAE,IAAI,EAAE,KAAK,EAAE,IAAI,EAAE,CAAC,CAAC;AACpD,CAAC,CAAC,CAAC;AAEH,oFAAoF;AACpF,SAAS,SAAS,CAAC,aAAqB,EAAE,IAAyB;IACjE,OAAO,IAAI,iBAAiB,CAAC;QAC3B,aAAa;QACb,OAAO,EAAE,CAAC,GAAG,EAAE,EAAE,CAAC,IAAI,CAAC,GAAG,CAAC,GAAG,CAAC;QAC/B,eAAe,EAAE,CAAC,GAAG,EAAE,EAAE,CAAC,IAAI,CAAC,GAAG,CAAC,GAAG,CAAC,IAAI,EAAE;KAC9C,CAAC,CAAC;AACL,CAAC;AAED,QAAQ,CAAC,mBAAmB,EAAE,GAAG,EAAE;IACjC,EAAE,CAAC,gDAAgD,EAAE,KAAK,IAAI,EAAE;QAC9D,MAAM,IAAI,GAAG,IAAI,GAAG,CAAC,CAAC,CAAC,GAAG,EAAE,yBAAyB,CAAC,CAAC,CAAC,CAAC;QACzD,MAAM,KAAK,GAAG,SAAS,CAAC,GAAG,EAAE,IAAI,CAAC,CAAC;QAEnC,MAAM,KAAK,CAAC,KAAK,CAAC,KAAK,EAAE,OAAO,EAAE,KAAK,CAAC,CAAC;QAEzC,MAAM,MAAM,GAAG,KAAK,CAAC,OAAO,CAAC,KAAK,CAAC,CAAC;QACpC,MAAM,CAAC,MAAM,CAAC,CAAC,YAAY,CAAC,CAAC,CAAC,CAAC;QAC/B,MAAM,CAAC,MAAM,CAAC,CAAC,CAAC,CAAC,KAAK,CAAC,CAAC,aAAa,CAAC,EAAE,QAAQ,EAAE,KAAK,EAAE,aAAa,EAAE,GAAG,EAAE,CAAC,CAAC;QAC/E,MAAM,CAAC,KAAK,CAAC,WAAW,CAAC,MAAM,CAAC,CAAC,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;IACxD,CAAC,CAAC,CAAC;IAEH,EAAE,CAAC,0CAA0C,EAAE,KAAK,IAAI,EAAE;QACxD,MAAM,IAAI,GAAG,IAAI,GAAG,CAAC,CAAC,CAAC,GAAG,EAAE,WAAW,CAAC,CAAC,CAAC,CAAC;QAC3C,MAAM,KAAK,GAAG,SAAS,CAAC,GAAG,EAAE,IAAI,CAAC,CAAC;QACnC,MAAM,KAAK,CAAC,KAAK,CAAC,KAAK,EAAE,OAAO,EAAE,KAAK,CAAC,CAAC;QAEzC,MAAM,CAAC,KAAK,CAAC,mBAAmB,CAAC,KAAK,EAAE,KAAK,CAAC,CAAC,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC;IAC9D,CAAC,CAAC,CAAC;IAEH,EAAE,CAAC,8CAA8C,EAAE,KAAK,IAAI,EAAE;QAC5D,MAAM,IAAI,GAAG,IAAI,GAAG,CAAC,CAAC,CAAC,GAAG,EAAE,WAAW,CAAC,EAAE,CAAC,GAAG,EAAE,WAAW,CAAC,CAAC,CAAC,CAAC;QAC/D,MAAM,SAAS,CAAC,GAAG,EAAE,IAAI,CAAC,CAAC,KAAK,CAAC,KAAK,EAAE,OAAO,EAAE,KAAK,CAAC,CAAC;QAExD,MAAM,CAAC,SAAS,CAAC,GAAG,EAAE,IAAI,CAAC,CAAC,mBAAmB,CAAC,KAAK,EAAE,KAAK,CAAC,CAAC,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;IAC5E,CAAC,CAAC,CAAC;IAEH,EAAE,CAAC,gDAAgD,EAAE,KAAK,IAAI,EAAE;QAC9D,MAAM,IAAI,GAAG,IAAI,GAAG,CAAC,CAAC,CAAC,GAAG,EAAE,WAAW,CAAC,EAAE,CAAC,GAAG,EAAE,WAAW,CAAC,CAAC,CAAC,CAAC;QAC/D,MAAM,SAAS,CAAC,GAAG,EAAE,IAAI,CAAC,CAAC,KAAK,CAAC,KAAK,EAAE,OAAO,EAAE,KAAK,CAAC,CAAC;QAExD,IAAI,CAAC,MAAM,CAAC,GAAG,CAAC,CAAC,CAAC,oCAAoC;QACtD,MAAM,CAAC,SAAS,CAAC,GAAG,EAAE,IAAI,CAAC,CAAC,mBAAmB,CAAC,KAAK,EAAE,KAAK,CAAC,CAAC,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC;IAC7E,CAAC,CAAC,CAAC;IAEH,EAAE,CAAC,6DAA6D,EAAE,KAAK,IAAI,EAAE;QAC3E,MAAM,IAAI,GAAG,IAAI,GAAG,CAAC,CAAC,CAAC,GAAG,EAAE,WAAW,CAAC,EAAE,CAAC,GAAG,EAAE,WAAW,CAAC,CAAC,CAAC,CAAC;QAC/D,MAAM,SAAS,CAAC,GAAG,EAAE,IAAI,CAAC,CAAC,KAAK,CAAC,KAAK,EAAE,OAAO,EAAE,KAAK,CAAC,CAAC;QAExD,oEAAoE;QACpE,IAAI,CAAC,GAAG,CAAC,GAAG,EAAE,oBAAoB,CAAC,CAAC;QACpC,MAAM,CAAC,SAAS,CAAC,GAAG,EAAE,IAAI,CAAC,CAAC,mBAAmB,CAAC,KAAK,EAAE,KAAK,CAAC,CAAC,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC;IAC7E,CAAC,CAAC,CAAC;IAEH,EAAE,CAAC,sDAAsD,EAAE,KAAK,IAAI,EAAE;QACpE,0EAA0E;QAC1E,0EAA0E;QAC1E,oBAAoB;QACpB,MAAM,IAAI,GAAG,IAAI,GAAG,CAAC,CAAC,CAAC,GAAG,EAAE,EAAE,CAAC,CAAC,CAAC,CAAC;QAClC,MAAM,SAAS,CAAC,GAAG,EAAE,IAAI,CAAC,CAAC,KAAK,CAAC,KAAK,EAAE,OAAO,EAAE,KAAK,CAAC,CAAC;QAExD,MAAM,CAAC,SAAS,CAAC,GAAG,EAAE,IAAI,GAAG,CAAC,CAAC,CAAC,GAAG,EAAE,EAAE,CAAC,EAAE,CAAC,GAAG,EAAE,EAAE,CAAC,CAAC,CAAC,CAAC,CAAC,mBAAmB,CAAC,KAAK,EAAE,KAAK,CAAC,CAAC,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;IACvG,CAAC,CAAC,CAAC;IAEH,EAAE,CAAC,6BAA6B,EAAE,KAAK,IAAI,EAAE;QAC3C,MAAM,IAAI,GAAG,IAAI,GAAG,CAAC,CAAC,CAAC,GAAG,EAAE,WAAW,CAAC,EAAE,CAAC,GAAG,EAAE,WAAW,CAAC,CAAC,CAAC,CAAC;QAC/D,MAAM,IAAI,GAAG,SAAS,CAAC,GAAG,EAAE,IAAI,CAAC,CAAC;QAClC,MAAM,IAAI,CAAC,KAAK,CAAC,KAAK,EAAE,OAAO,EAAE,KAAK,CAAC,CAAC;QACxC,MAAM,SAAS,CAAC,GAAG,EAAE,IAAI,CAAC,CAAC,KAAK,CAAC,KAAK,EAAE,OAAO,EAAE,KAAK,CAAC,CAAC;QAExD,IAAI,CAAC,OAAO,CAAC,KAAK,EAAE,KAAK,CAAC,CAAC;QAE3B,MAAM,SAAS,GAAG,IAAI,CAAC,OAAO,CAAC,KAAK,CAAC,CAAC;QACtC,MAAM,CAAC,SAAS,CAAC,CAAC,YAAY,CAAC,CAAC,CAAC,CAAC;QAClC,MAAM,CAAC,SAAS,CAAC,CAAC,CAAC,CAAC,KAAK,CAAC,aAAa,CAAC,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC;IACrD,CAAC,CAAC,CAAC;IAEH,EAAE,CAAC,kDAAkD,EAAE,KAAK,IAAI,EAAE;QAChE,MAAM,IAAI,GAAG,IAAI,GAAG,CAAC,CAAC,CAAC,GAAG,EAAE,WAAW,CAAC,EAAE,CAAC,GAAG,EAAE,WAAW,CAAC,CAAC,CAAC,CAAC;QAC/D,MAAM,IAAI,GAAG,SAAS,CAAC,GAAG,EAAE,IAAI,CAAC,CAAC;QAClC,MAAM,IAAI,CAAC,KAAK,CAAC,KAAK,EAAE,OAAO,EAAE,KAAK,CAAC,CAAC;QACxC,MAAM,IAAI,CAAC,KAAK,CAAC,KAAK,EAAE,OAAO,EAAE,KAAK,CAAC,CAAC;QACxC,MAAM,SAAS,CAAC,GAAG,EAAE,IAAI,CAAC,CAAC,KAAK,CAAC,KAAK,EAAE,OAAO,EAAE,KAAK,CAAC,CAAC;QAExD,IAAI,CAAC,aAAa,EAAE,CAAC;QAErB,MAAM,SAAS,GAAG,IAAI,CAAC,OAAO,CAAC,KAAK,CAAC,CAAC;QACtC,MAAM,CAAC,SAAS,CAAC,GAAG,CAAC,CAAC,KAAK,EAAE,EAAE,CAAC,KAAK,CAAC,KAAK,CAAC,aAAa,CAAC,CAAC,CAAC,OAAO,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC;IAC7E,CAAC,CAAC,CAAC;IAEH,EAAE,CAAC,oEAAoE,EAAE,KAAK,IAAI,EAAE;QAClF,MAAM,IAAI,GAAG,IAAI,GAAG,CAAC,CAAC,CAAC,GAAG,EAAE,WAAW,CAAC,EAAE,CAAC,GAAG,EAAE,WAAW,CAAC,EAAE,CAAC,GAAG,EAAE,WAAW,CAAC,CAAC,CAAC,CAAC;QACnF,MAAM,SAAS,CAAC,GAAG,EAAE,IAAI,CAAC,CAAC,KAAK,CAAC,WAAW,EAAE,OAAO,EAAE,KAAK,CAAC,CAAC;QAC9D,MAAM,SAAS,CAAC,GAAG,EAAE,IAAI,CAAC,CAAC,KAAK,CAAC,QAAQ,EAAE,OAAO,EAAE,KAAK,CAAC,CAAC;QAC3D,MAAM,SAAS,CAAC,GAAG,EAAE,IAAI,CAAC,CAAC,KAAK,CAAC,QAAQ,EAAE,OAAO,EAAE,KAAK,CAAC,CAAC;QAE3D,IAAI,CAAC,MAAM,CAAC,GAAG,CAAC,CAAC,CAAC,2CAA2C;QAC7D,IAAI,CAAC,MAAM,CAAC,GAAG,CAAC,CAAC,CAAC,2CAA2C;QAE7D,MAAM,KAAK,GAAG,SAAS,CAAC,GAAG,EAAE,IAAI,CAAC,CAAC;QACnC,MAAM,EAAE,OAAO,EAAE,kBAAkB,EAAE,GAAG,KAAK,CAAC,iBAAiB,CAAC,KAAK,CAAC,CAAC;QAEvE,MAAM,CAAC,OAAO,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC;QACxB,MAAM,CAAC,kBAAkB,CAAC,CAAC,OAAO,CAAC,CAAC,WAAW,CAAC,CAAC,CAAC;QAClD,6DAA6D;QAC7D,MAAM,CAAC,KAAK,CAAC,OAAO,CAAC,KAAK,CAAC,CAAC,GAAG,CAAC,CAAC,KAAK,EAAE,EAAE,CAAC,KAAK,CAAC,KAAK,CAAC,aAAa,CAAC,CAAC,CAAC,OAAO,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC;IACxF,CAAC,CAAC,CAAC;IAEH,EAAE,CAAC,gDAAgD,EAAE,KAAK,IAAI,EAAE;QAC9D,MAAM,IAAI,GAAG,IAAI,GAAG,CAAC,CAAC,CAAC,GAAG,EAAE,WAAW,CAAC,CAAC,CAAC,CAAC;QAC3C,MAAM,KAAK,GAAG,SAAS,CAAC,GAAG,EAAE,IAAI,CAAC,CAAC;QACnC,MAAM,KAAK,CAAC,KAAK,CAAC,KAAK,EAAE,OAAO,EAAE,KAAK,CAAC,CAAC;QAEzC,MAAM,GAAG,GAAG,IAAI,CAAC,OAAO,EAAE,YAAY,EAAE,eAAe,CAAC,CAAC;QACzD,aAAa,CAAC,IAAI,CAAC,GAAG,EAAE,cAAc,CAAC,EAAE,YAAY,CAAC,CAAC;QAEvD,MAAM,CAAC,GAAG,EAAE,CAAC,KAAK,CAAC,OAAO,CAAC,KAAK,CAAC,CAAC,CAAC,GAAG,CAAC,OAAO,EAAE,CAAC;QACjD,MAAM,CAAC,KAAK,CAAC,OAAO,CAAC,KAAK,CAAC,CAAC,CAAC,YAAY,CAAC,CAAC,CAAC,CAAC;QAC7C,MAAM,CAAC,KAAK,CAAC,mBAAmB,CAAC,KAAK,EAAE,KAAK,CAAC,CAAC,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC;IAC9D,CAAC,CAAC,CAAC;IAEH,EAAE,CAAC,qDAAqD,EAAE,GAAG,EAAE;QAC7D,MAAM,KAAK,GAAG,SAAS,CAAC,GAAG,EAAE,IAAI,GAAG,CAAC,CAAC,CAAC,GAAG,EAAE,WAAW,CAAC,CAAC,CAAC,CAAC,CAAC;QAC5D,MAAM,CAAC,KAAK,CAAC,OAAO,CAAC,KAAK,CAAC,CAAC,CAAC,OAAO,CAAC,EAAE,CAAC,CAAC;QACzC,MAAM,CAAC,KAAK,CAAC,mBAAmB,CAAC,KAAK,EAAE,KAAK,CAAC,CAAC,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC;IAC9D,CAAC,CAAC,CAAC;IAEH,EAAE,CAAC,0DAA0D,EAAE,KAAK,IAAI,EAAE;QACxE,MAAM,IAAI,GAAG,IAAI,GAAG,CAAC,CAAC,CAAC,GAAG,EAAE,WAAW,CAAC,CAAC,CAAC,CAAC;QAC3C,MAAM,KAAK,GAAG,SAAS,CAAC,GAAG,EAAE,IAAI,CAAC,CAAC;QAEnC,MAAM,KAAK,CAAC,KAAK,CAAC,UAAU,EAAE,OAAO,EAAE,KAAK,CAAC,CAAC;QAE9C,+CAA+C;QAC/C,MAAM,GAAG,GAAG,IAAI,CAAC,OAAO,EAAE,YAAY,EAAE,eAAe,CAAC,CAAC;QACzD,MAAM,CAAC,WAAW,CAAC,GAAG,CAAC,CAAC,CAAC,YAAY,CAAC,CAAC,CAAC,CAAC;QACzC,MAAM,CAAC,KAAK,CAAC,mBAAmB,CAAC,UAAU,EAAE,KAAK,CAAC,CAAC,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC;QACjE,MAAM,CAAC,KAAK,CAAC,OAAO,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC,CAAC,KAAK,CAAC,QAAQ,CAAC,CAAC,IAAI,CAAC,UAAU,CAAC,CAAC;IAClE,CAAC,CAAC,CAAC;IAEH,EAAE,CAAC,qEAAqE,EAAE,KAAK,IAAI,EAAE;QACnF,yEAAyE;QACzE,2EAA2E;QAC3E,WAAW;QACX,MAAM,IAAI,GAAG,IAAI,GAAG,CAAC,CAAC,CAAC,GAAG,EAAE,WAAW,CAAC,EAAE,CAAC,GAAG,EAAE,WAAW,CAAC,CAAC,CAAC,CAAC;QAC/D,MAAM,SAAS,CAAC,GAAG,EAAE,IAAI,CAAC,CAAC,eAAe,CAAC,OAAO,CAAC,CAAC;QAEpD,MAAM,KAAK,GAAG,SAAS,CAAC,GAAG,EAAE,IAAI,CAAC,CAAC;QACnC,MAAM,CAAC,KAAK,CAAC,qBAAqB,CAAC,OAAO,CAAC,CAAC,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;QACxD,MAAM,CAAC,KAAK,CAAC,OAAO,CAAC,KAAK,EAAE,OAAO,EAAE,KAAK,CAAC,CAAC,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC;QACzD,qCAAqC;QACrC,MAAM,CAAC,KAAK,CAAC,OAAO,CAAC,KAAK,EAAE,QAAQ,EAAE,KAAK,CAAC,CAAC,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;IAC3D,CAAC,CAAC,CAAC;IAEH,EAAE,CAAC,6CAA6C,EAAE,KAAK,IAAI,EAAE;QAC3D,MAAM,IAAI,GAAG,IAAI,GAAG,CAAC,CAAC,CAAC,GAAG,EAAE,WAAW,CAAC,EAAE,CAAC,GAAG,EAAE,WAAW,CAAC,CAAC,CAAC,CAAC;QAC/D,MAAM,SAAS,CAAC,GAAG,EAAE,IAAI,CAAC,CAAC,eAAe,CAAC,OAAO,CAAC,CAAC;QAEpD,IAAI,CAAC,MAAM,CAAC,GAAG,CAAC,CAAC;QACjB,MAAM,CAAC,SAAS,CAAC,GAAG,EAAE,IAAI,CAAC,CAAC,OAAO,CAAC,KAAK,EAAE,OAAO,EAAE,KAAK,CAAC,CAAC,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;IACzE,CAAC,CAAC,CAAC;IAEH,EAAE,CAAC,sDAAsD,EAAE,KAAK,IAAI,EAAE;QACpE,MAAM,IAAI,GAAG,IAAI,GAAG,CAAC,CAAC,CAAC,GAAG,EAAE,WAAW,CAAC,EAAE,CAAC,GAAG,EAAE,WAAW,CAAC,CAAC,CAAC,CAAC;QAC/D,MAAM,SAAS,CAAC,GAAG,EAAE,IAAI,CAAC,CAAC,eAAe,CAAC,OAAO,CAAC,CAAC;QAEpD,IAAI,CAAC,GAAG,CAAC,GAAG,EAAE,oBAAoB,CAAC,CAAC;QACpC,MAAM,CAAC,SAAS,CAAC,GAAG,EAAE,IAAI,CAAC,CAAC,OAAO,CAAC,KAAK,EAAE,OAAO,EAAE,KAAK,CAAC,CAAC,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;IACzE,CAAC,CAAC,CAAC;IAEH,EAAE,CAAC,gDAAgD,EAAE,KAAK,IAAI,EAAE;QAC9D,MAAM,IAAI,GAAG,IAAI,GAAG,CAAC,CAAC,CAAC,GAAG,EAAE,WAAW,CAAC,CAAC,CAAC,CAAC;QAC3C,MAAM,KAAK,GAAG,SAAS,CAAC,GAAG,EAAE,IAAI,CAAC,CAAC;QACnC,MAAM,KAAK,CAAC,eAAe,CAAC,OAAO,CAAC,CAAC;QAErC,MAAM,CAAC,KAAK,CAAC,qBAAqB,CAAC,OAAO,CAAC,CAAC,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC;QACzD,MAAM,CAAC,KAAK,CAAC,OAAO,CAAC,KAAK,EAAE,OAAO,EAAE,KAAK,CAAC,CAAC,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;IAC1D,CAAC,CAAC,CAAC;IAEH,EAAE,CAAC,4CAA4C,EAAE,KAAK,IAAI,EAAE;QAC1D,MAAM,IAAI,GAAG,IAAI,GAAG,CAAC,CAAC,CAAC,GAAG,EAAE,WAAW,CAAC,EAAE,CAAC,GAAG,EAAE,WAAW,CAAC,EAAE,CAAC,GAAG,EAAE,WAAW,CAAC,CAAC,CAAC,CAAC;QACnF,MAAM,SAAS,CAAC,GAAG,EAAE,IAAI,CAAC,CAAC,eAAe,CAAC,OAAO,CAAC,CAAC;QACpD,MAAM,SAAS,CAAC,GAAG,EAAE,IAAI,CAAC,CAAC,eAAe,CAAC,OAAO,CAAC,CAAC;QACpD,IAAI,CAAC,MAAM,CAAC,GAAG,CAAC,CAAC;QAEjB,MAAM,KAAK,GAAG,SAAS,CAAC,GAAG,EAAE,IAAI,CAAC,CAAC;QACnC,MAAM,CAAC,KAAK,CAAC,mBAAmB,EAAE,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC;QAC5C,MAAM,CAAC,KAAK,CAAC,YAAY,EAAE,CAAC,GAAG,CAAC,CAAC,KAAK,EAAE,EAAE,CAAC,KAAK,CAAC,QAAQ,CAAC,aAAa,CAAC,CAAC,CAAC,OAAO,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC;IAC3F,CAAC,CAAC,CAAC;IAEH,EAAE,CAAC,uCAAuC,EAAE,KAAK,IAAI,EAAE;QACrD,MAAM,IAAI,GAAG,IAAI,GAAG,CAAC,CAAC,CAAC,GAAG,EAAE,WAAW,CAAC,CAAC,CAAC,CAAC;QAC3C,MAAM,KAAK,GAAG,SAAS,CAAC,GAAG,EAAE,IAAI,CAAC,CAAC;QACnC,MAAM,KAAK,CAAC,eAAe,CAAC,OAAO,CAAC,CAAC;QACrC,KAAK,CAAC,iBAAiB,EAAE,CAAC;QAE1B,MAAM,CAAC,SAAS,CAAC,GAAG,EAAE,IAAI,GAAG,CAAC,CAAC,CAAC,GAAG,EAAE,WAAW,CAAC,EAAE,CAAC,GAAG,EAAE,WAAW,CAAC,CAAC,CAAC,CAAC,CAAC,qBAAqB,CAAC,OAAO,CAAC,CAAC,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC;IACvH,CAAC,CAAC,CAAC;IAEH,EAAE,CAAC,qCAAqC,EAAE,KAAK,IAAI,EAAE;QACnD,MAAM,IAAI,GAAG,IAAI,GAAG,CAAC,CAAC,CAAC,GAAG,EAAE,WAAW,CAAC,EAAE,CAAC,GAAG,EAAE,WAAW,CAAC,CAAC,CAAC,CAAC;QAC/D,MAAM,SAAS,CAAC,GAAG,EAAE,IAAI,CAAC,CAAC,KAAK,CAAC,KAAK,EAAE,OAAO,EAAE,IAAI,CAAC,CAAC;QAEvD,MAAM,KAAK,GAAG,SAAS,CAAC,GAAG,EAAE,IAAI,CAAC,CAAC;QACnC,MAAM,CAAC,KAAK,CAAC,mBAAmB,CAAC,KAAK,EAAE,KAAK,CAAC,CAAC,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC;QAC5D,MAAM,CAAC,KAAK,CAAC,mBAAmB,CAAC,KAAK,EAAE,IAAI,CAAC,CAAC,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;IAC5D,CAAC,CAAC,CAAC;AACL,CAAC,CAAC,CAAC"}

package/build/server-manager.d.ts

@@ -0,0 +1,438 @@
+/**
+ * Server Manager
+ * Manages development servers (any language/framework) - start, stop, restart, and monitor
+ * Supports multiple runner types: native (spawn), docker, docker-compose
+ * Persists state to .cdp-tools/servers.json for recovery and auto-run
+ * Logs to .cdp-tools/logs/<server-id>/ for cross-MCP access (native runner only)
+ */
+import * as net from 'net';
+import { type ServerClaimsStore } from './server-claims.js';
+import { type RunnerType } from './runners/index.js';
+/**
+ * Returns the matched auto-restart pattern name if `command` looks like it
+ * self-restarts on file changes, or null otherwise.
+ */
+export declare function detectAutoRestartCommand(command: string): string | null;
+/**
+ * Extract the Node inspector port from a `--inspect`/`--inspect-brk` flag in
+ * a command string, if present. Falls back to Node's default port (9229)
+ * when the flag is given with no explicit port. Does not handle a separate
+ * `--inspect-port=` flag overriding a bare `--inspect`'s port - a rare
+ * combination not worth the extra complexity here.
+ */
+export declare function extractInspectorPort(command: string): number | null;
+export interface ServerStatus {
+    id: string;
+    command: string;
+    cwd: string;
+    pid: number;
+    containerId?: string;
+    startedAt: Date;
+    uptime: string;
+    port?: number;
+    running: boolean;
+    autoRun: boolean;
+    runnerType: RunnerType;
+    global: boolean;
+    watch: boolean;
+}
+export interface StartServerOptions {
+    command: string;
+    cwd: string;
+    id: string;
+    autoRun?: boolean;
+    env?: Record<string, string>;
+    port?: number;
+    /** Runner type - auto-detected from command if not specified */
+    runner?: RunnerType;
+    /** If true, auto-add detected port to monitoredPorts with default level 'block' */
+    monitorPort?: boolean;
+    /** If true, store server state in global ~/.cdp-tools/ instead of project directory */
+    global?: boolean;
+    /** If true, watch this server's files and auto-restart it (pause-aware) on change instead of relying on --watch/nodemon */
+    watch?: boolean;
+    /** Paths to watch when `watch` is true (default: [cwd]) */
+    watchPaths?: string[];
+}
+export interface LogStats {
+    serverId: string;
+    newStdout: number;
+    newStderr: number;
+}
+/** A watch-triggered restart that's queued behind a paused breakpoint debugger. */
+export interface PendingRestartInfo {
+    serverId: string;
+    queuedAt: Date;
+}
+export type MonitoringLevel = 'inform' | 'error' | 'block';
+export interface PersistedMonitoredPort {
+    port: number;
+    level: MonitoringLevel;
+    description?: string;
+    interval?: number;
+}
+export interface MonitoredPort {
+    port: number;
+    level: MonitoringLevel;
+    description?: string;
+    interval?: number;
+    status: 'up' | 'down' | 'connecting';
+    socket: net.Socket | null;
+    failedAt?: Date;
+    acknowledged: boolean;
+    reconnectTimer?: ReturnType<typeof setTimeout>;
+}
+export interface MonitoredPortStatus {
+    port: number;
+    level: MonitoringLevel;
+    description?: string;
+    interval?: number;
+    status: 'up' | 'down' | 'connecting';
+    failedAt?: Date;
+    acknowledged: boolean;
+}
+export interface PortFailureInfo {
+    port: number;
+    level: MonitoringLevel;
+    description?: string;
+    failedAt: Date;
+}
+/** Function type for getting interval for a monitoring level */
+export type GetIntervalForLevel = (level: MonitoringLevel) => number;
+export type PendingStartupReason = 'timeout' | 'died';
+export interface PendingStartup {
+    serverId: string;
+    startedAt: Date;
+    timeoutAt: Date;
+    acknowledged: boolean;
+    reason?: PendingStartupReason;
+}
+export interface PersistedPendingStartup {
+    serverId: string;
+    startedAt: string;
+    timeoutAt: string;
+    acknowledged: boolean;
+    reason?: PendingStartupReason;
+}
+export interface PendingStartupFailureInfo {
+    serverId: string;
+    startedAt: Date;
+    reason: PendingStartupReason;
+}
+/**
+ * Port Monitor - monitors ports using persistent TCP connections
+ */
+export declare class PortMonitor {
+    private ports;
+    private onFailureCallback?;
+    private getIntervalForLevel;
+    private pauseCount;
+    constructor(getIntervalForLevel?: GetIntervalForLevel);
+    onFailure(callback: (port: number, level: MonitoringLevel) => void): void;
+    startMonitoring(port: number, level: MonitoringLevel, description?: string, interval?: number): Promise<void>;
+    private connectToPort;
+    private scheduleReconnect;
+    stopMonitoring(port: number): Promise<boolean>;
+    acknowledgeFailure(port: number): Promise<boolean>;
+    getFailedPorts(): PortFailureInfo[];
+    getFailedPortsByLevel(level: MonitoringLevel): PortFailureInfo[];
+    hasBlockingFailures(): boolean;
+    isMonitoring(port: number): boolean;
+    getStatus(port?: number): MonitoredPortStatus[];
+    getPersistedState(): PersistedMonitoredPort[];
+    restoreFromState(ports: PersistedMonitoredPort[]): Promise<void>;
+    stopAll(): Promise<void>;
+    /**
+     * Pause all port monitoring (e.g., when paused at a breakpoint)
+     * Stops reconnection attempts but preserves port state
+     */
+    pauseMonitoring(): void;
+    /**
+     * Resume all port monitoring (e.g., when resuming from a breakpoint)
+     * Restarts connection attempts for all monitored ports, once every
+     * outstanding pauseMonitoring() call has a matching resumeMonitoring().
+     */
+    resumeMonitoring(): void;
+}
+export declare class ServerManager {
+    private servers;
+    private portMonitor;
+    private pendingStartups;
+    /** Mutex to serialize saveState calls - prevents concurrent file writes */
+    private saveMutex;
+    /** Injected from index.ts - decouples ServerManager from ConnectionManager directly */
+    private pauseChecker;
+    /** Watch-mode restart coordination, keyed by serverId - see WatchRestartState */
+    private watchState;
+    /** Ownership claims - who may stop a shared dev server (see server-claims.ts) */
+    private readonly claims;
+    constructor(claimsStore?: ServerClaimsStore);
+    /**
+     * Set the function used to check whether a CDP connection at a given
+     * inspector port is currently paused at a breakpoint. Mirrors the existing
+     * setChromeLauncher() injection pattern.
+     */
+    setPauseChecker(fn: (inspectorPort: number) => boolean): void;
+    /**
+     * Get the port monitor instance (lazy-initialized)
+     * Must be called after configManager.load() for config values to be used
+     */
+    getPortMonitor(): PortMonitor;
+    private getServersFilePath;
+    /**
+     * Initialize - load state and recover/start auto-run servers
+     * Loads from both local (project) and global (~/.cdp-tools/) storage
+     */
+    initialize(): Promise<{
+        recovered: string[];
+        started: string[];
+        failed: string[];
+        monitoredPorts: number[];
+        collected: string[];
+    }>;
+    /**
+     * Resume port detection for a server after MCP restart
+     * @param serverId The server to resume detection for
+     * @param remainingMs Time remaining until timeout
+     */
+    private resumePortDetection;
+    private loadState;
+    /**
+     * Save state to disk - serialized through mutex to prevent concurrent writes
+     */
+    saveState(): Promise<void>;
+    /**
+     * Internal save implementation - uses atomic writes to prevent corruption
+     */
+    private doSaveState;
+    private getRunnerCommand;
+    private getRunnerCwd;
+    /**
+     * Find the managed server whose command's --inspect/--inspect-brk port
+     * matches `port` - i.e. the server a CDP debugger connection at that port
+     * actually belongs to. This is deliberately NOT the server's own detected
+     * app/service port (e.g. an HTTP port parsed from "listening on port
+     * 3000") - a Node process's inspector port and its own app port are
+     * normally different numbers, so matching on the app port would almost
+     * never find anything real.
+     */
+    getManagedServerByInspectorPort(port: number): Promise<{
+        id: string;
+        command: string;
+    } | null>;
+    /** Sync core of getManagedServerByInspectorPort() - reused by watch-restart lookups, which run in a sync pre-execution hot path (checkBreakpointPause) and can't await. */
+    private findManagedServerByInspectorPortSync;
+    private isPortInUse;
+    /**
+     * Find PIDs of processes listening on a port using lsof
+     */
+    private findProcessesOnPort;
+    /**
+     * Get the working directory of a process by PID
+     */
+    private getProcessCwd;
+    /**
+     * Kill orphan processes holding a port, but only if they're in the expected directory
+     * Returns: { killed: PIDs killed, foreign: PIDs that are from a different directory }
+     */
+    private killOrphanProcessesOnPort;
+    private waitForPortRelease;
+    /**
+     * Start a server
+     */
+    startServer(options: StartServerOptions): Promise<{
+        id: string;
+        pid: number;
+        runnerType: RunnerType;
+        containerId?: string;
+        autoRestartWarning?: string;
+    }>;
+    /**
+     * Background port detection with timeout management
+     * @param serverId The server to detect port for
+     * @param timeoutMs How long to wait before triggering blocking (default 30s)
+     */
+    private detectPortInBackgroundWithTimeout;
+    /**
+     * @deprecated Use detectPortInBackgroundWithTimeout instead
+     */
+    private detectPortInBackground;
+    /**
+     * Get pending startup failures that should trigger blocking
+     * Returns only startups that have timed out or died and are not acknowledged
+     */
+    getPendingStartupFailures(): PendingStartupFailureInfo[];
+    /**
+     * Check if a server has a pending startup (regardless of state)
+     */
+    hasPendingStartup(serverId: string): boolean;
+    /**
+     * Get pending startup status for a server
+     */
+    getPendingStartup(serverId: string): PendingStartup | undefined;
+    /**
+     * Acknowledge a pending startup failure
+     * Clears the blocking state and starts background health monitoring
+     */
+    acknowledgeStartup(serverId: string): Promise<boolean>;
+    /**
+     * Monitor server health after acknowledgment
+     * Checks every 5 seconds for:
+     * - Port detection (sets up port monitoring when found)
+     * - Server death (re-triggers blocking)
+     * Runs until port is found, server dies, or server is removed
+     */
+    private monitorServerHealth;
+    /**
+     * Extend the startup timeout by another 30 seconds
+     * Resets the acknowledged flag and reason, resumes detection
+     */
+    extendStartupTimeout(serverId: string): Promise<boolean>;
+    /**
+     * Remove pending startup entry (called when server is stopped or removed)
+     */
+    private removePendingStartup;
+    /**
+     * Stop a server
+     */
+    stopServer(serverId: string): Promise<void>;
+    /**
+     * Restart a server
+     * Reloads config from persisted state to pick up any manual edits (e.g., port changes)
+     */
+    restartServer(serverId: string): Promise<{
+        id: string;
+        pid: number;
+        runnerType: RunnerType;
+        containerId?: string;
+    }>;
+    private getOrCreateWatchState;
+    private startWatcher;
+    private stopWatcher;
+    /**
+     * Single entry point for every watch-triggered restart (file-change,
+     * resume-triggered auto-fire, and its own re-entrant re-check once an
+     * in-flight restart finishes). Always re-checks pause state fresh rather
+     * than trusting a cached value - see issue #88.
+     */
+    requestWatchRestart(serverId: string): Promise<void>;
+    /**
+     * Explicit, forced restart (bypasses the pause-check entirely - the caller
+     * has already decided to end any paused debug session). Shares the same
+     * in-flight guard as requestWatchRestart(): if a watch-triggered restart is
+     * already running, piggybacks on its result instead of racing it.
+     */
+    forceRestart(serverId: string): Promise<{
+        id: string;
+        pid: number;
+        runnerType: RunnerType;
+        containerId?: string;
+    }>;
+    /** Shared restart guard used by both requestWatchRestart() and forceRestart(). */
+    private performGuardedRestart;
+    /** For checkBreakpointPause's lookup (via a paused connection's inspector port). */
+    getPendingRestartByInspectorPort(port: number): PendingRestartInfo | null;
+    /** Discard a queued watch-restart without performing it - keep debugging. */
+    cancelPendingRestart(serverId: string): boolean;
+    /**
+     * Re-check a port's pause state and let its queued watch-restart (if any)
+     * fire now that the debugger has resumed. Call this after any resume that
+     * un-pauses a connection - requestWatchRestart() only re-fires on the next
+     * file change otherwise, so without this hook a restart deferred by a
+     * pause would sit queued forever if no further edits happen.
+     */
+    retryPendingRestartByInspectorPort(port: number): void;
+    /**
+     * Set autoRun flag
+     */
+    setAutoRun(serverId: string, autoRun: boolean): Promise<void>;
+    /**
+     * Get status of servers
+     */
+    getStatus(serverId?: string): Promise<ServerStatus[]>;
+    /**
+     * Get log stats (for native runner only)
+     */
+    getLogStats(): LogStats[];
+    /**
+     * Get logs from a server
+     */
+    getLogs(serverId: string, options?: {
+        type?: 'stdout' | 'stderr' | 'all';
+        lines?: number;
+        delta?: boolean;
+    }): Promise<string[]>;
+    /**
+     * Clear logs (native runner only)
+     */
+    clearLogs(serverId: string): Promise<{
+        logDir: string;
+        stdoutPath: string;
+        stderrPath: string;
+    }>;
+    /**
+     * Get log access info (file paths for native, commands for docker)
+     */
+    getLogAccess(serverId: string): {
+        type: 'file';
+        logDir: string;
+        stdoutPath: string;
+        stderrPath: string;
+    } | {
+        type: 'command';
+        command: string;
+    } | null;
+    /**
+     * Stop every server this session owns outright - one no live session other
+     * than this one claims. Used when the session is going away for good (an
+     * idle suspend, or a client that closed), which is the only time it is safe
+     * to take a dev server down.
+     *
+     * A server another window is still using is left alone, and so is one whose
+     * ownership cannot be established: over-stopping destroys running work,
+     * under-stopping leaves a process for the next `initialize()` to collect.
+     */
+    stopOwnedServers(): Promise<{
+        stopped: string[];
+        keptForOthers: string[];
+    }>;
+    /**
+     * Server ids whose every claim was dead, per storage scope, with those dead
+     * claims deleted as a side effect.
+     *
+     * Must be read BEFORE this session claims anything during recovery -
+     * otherwise our own fresh claim makes an orphan look owned, and nothing is
+     * ever collected.
+     *
+     * A server with no claim file at all is absent from this: it predates
+     * claims, or was started outside cdp-tools, and neither is ours to kill.
+     */
+    private findAbandonedServerIds;
+    /**
+     * Stop all servers
+     */
+    stopAll(): Promise<string[]>;
+    /**
+     * Remove a server from config
+     */
+    removeServer(serverId: string): Promise<void>;
+    /**
+     * Get running server IDs
+     */
+    getRunningServerIds(): Promise<string[]>;
+    /**
+     * Cleanup - refresh status of all servers (no longer removes stopped servers)
+     * Stopped servers remain in config and can be manually restarted
+     */
+    cleanup(): Promise<number>;
+    /**
+     * Add running servers that appeared in persisted state since this session
+     * loaded, claiming each one: seeing a server is enough to depend on it.
+     */
+    private adoptNewlyPersistedServers;
+    /**
+     * Reload a server's config from persisted state (for picking up manual edits)
+     */
+    private reloadServerConfig;
+}
+//# sourceMappingURL=server-manager.d.ts.map

package/build/server-manager.d.ts.map

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