@opengsd/gsd-pi 1.0.2-dev.50223bc → 1.0.2-dev.5961fbf

package/packages/daemon/dist/project-scanner.test.js

@@ -0,0 +1,183 @@
+/**
+ * Tests for the project scanner module.
+ */
+import { describe, it, afterEach } from 'node:test';
+import assert from 'node:assert/strict';
+import { mkdtempSync, mkdirSync, writeFileSync, rmSync, existsSync, chmodSync } from 'node:fs';
+import { join } from 'node:path';
+import { tmpdir, platform } from 'node:os';
+import { randomUUID } from 'node:crypto';
+import { scanForProjects } from './project-scanner.js';
+// ---------- helpers ----------
+function tmpDir() {
+    return mkdtempSync(join(tmpdir(), `scanner-test-${randomUUID().slice(0, 8)}-`));
+}
+const cleanupDirs = [];
+afterEach(() => {
+    while (cleanupDirs.length) {
+        const d = cleanupDirs.pop();
+        if (existsSync(d))
+            rmSync(d, { recursive: true, force: true });
+    }
+});
+/** Create a project directory with specified marker files/dirs */
+function createProject(root, name, markers) {
+    const projDir = join(root, name);
+    mkdirSync(projDir, { recursive: true });
+    for (const marker of markers) {
+        const markerPath = join(projDir, marker);
+        if (marker.startsWith('.') && !marker.includes('.')) {
+            // Likely a directory marker (.git, .gsd)
+            mkdirSync(markerPath, { recursive: true });
+        }
+        else {
+            // File marker (package.json, Cargo.toml, etc.)
+            writeFileSync(markerPath, '{}');
+        }
+    }
+    return projDir;
+}
+// ---------- tests ----------
+describe('scanForProjects', () => {
+    it('finds projects with marker files', async () => {
+        const root = tmpDir();
+        cleanupDirs.push(root);
+        createProject(root, 'my-app', ['.git', 'package.json']);
+        const results = await scanForProjects([root]);
+        assert.equal(results.length, 1);
+        assert.equal(results[0].name, 'my-app');
+        assert.equal(results[0].path, join(root, 'my-app'));
+        assert.ok(results[0].markers.includes('git'));
+        assert.ok(results[0].markers.includes('node'));
+        assert.ok(results[0].lastModified > 0);
+    });
+    it('handles missing scan_root gracefully', async () => {
+        const results = await scanForProjects(['/nonexistent/path/that/does/not/exist']);
+        assert.deepEqual(results, []);
+    });
+    it('handles permission errors on entries', { skip: platform() === 'win32' ? 'chmod not reliable on Windows' : undefined }, async () => {
+        const root = tmpDir();
+        cleanupDirs.push(root);
+        // Create an accessible project
+        createProject(root, 'accessible', ['.git']);
+        // Create an inaccessible directory
+        const noAccess = join(root, 'locked');
+        mkdirSync(noAccess);
+        chmodSync(noAccess, 0o000);
+        const results = await scanForProjects([root]);
+        // Restore permissions for cleanup
+        chmodSync(noAccess, 0o755);
+        // Should find the accessible project but skip the locked one
+        assert.equal(results.length, 1);
+        assert.equal(results[0].name, 'accessible');
+    });
+    it('detects multiple marker types', async () => {
+        const root = tmpDir();
+        cleanupDirs.push(root);
+        createProject(root, 'full-stack', ['.git', 'package.json', '.gsd']);
+        const results = await scanForProjects([root]);
+        assert.equal(results.length, 1);
+        assert.equal(results[0].markers.length, 3);
+        assert.ok(results[0].markers.includes('git'));
+        assert.ok(results[0].markers.includes('node'));
+        assert.ok(results[0].markers.includes('gsd'));
+    });
+    it('returns results sorted alphabetically by name', async () => {
+        const root = tmpDir();
+        cleanupDirs.push(root);
+        createProject(root, 'zebra-project', ['.git']);
+        createProject(root, 'alpha-project', ['.git']);
+        createProject(root, 'middle-project', ['.git']);
+        const results = await scanForProjects([root]);
+        assert.equal(results.length, 3);
+        assert.equal(results[0].name, 'alpha-project');
+        assert.equal(results[1].name, 'middle-project');
+        assert.equal(results[2].name, 'zebra-project');
+    });
+    it('ignores hidden directories', async () => {
+        const root = tmpDir();
+        cleanupDirs.push(root);
+        createProject(root, 'visible', ['.git']);
+        createProject(root, '.hidden', ['.git']);
+        const results = await scanForProjects([root]);
+        assert.equal(results.length, 1);
+        assert.equal(results[0].name, 'visible');
+    });
+    it('ignores node_modules', async () => {
+        const root = tmpDir();
+        cleanupDirs.push(root);
+        createProject(root, 'real-project', ['package.json']);
+        createProject(root, 'node_modules', ['package.json']);
+        const results = await scanForProjects([root]);
+        assert.equal(results.length, 1);
+        assert.equal(results[0].name, 'real-project');
+    });
+    it('skips directories with no markers', async () => {
+        const root = tmpDir();
+        cleanupDirs.push(root);
+        createProject(root, 'has-markers', ['.git']);
+        // Create a plain directory with no markers
+        mkdirSync(join(root, 'no-markers'));
+        const results = await scanForProjects([root]);
+        assert.equal(results.length, 1);
+        assert.equal(results[0].name, 'has-markers');
+    });
+    it('scans multiple roots', async () => {
+        const root1 = tmpDir();
+        const root2 = tmpDir();
+        cleanupDirs.push(root1, root2);
+        createProject(root1, 'proj-a', ['.git']);
+        createProject(root2, 'proj-b', ['Cargo.toml']);
+        const results = await scanForProjects([root1, root2]);
+        assert.equal(results.length, 2);
+        assert.equal(results[0].name, 'proj-a');
+        assert.ok(results[0].markers.includes('git'));
+        assert.equal(results[1].name, 'proj-b');
+        assert.ok(results[1].markers.includes('rust'));
+    });
+    it('detects all supported marker types', async () => {
+        const root = tmpDir();
+        cleanupDirs.push(root);
+        createProject(root, 'git-proj', ['.git']);
+        createProject(root, 'node-proj', ['package.json']);
+        createProject(root, 'gsd-proj', ['.gsd']);
+        createProject(root, 'rust-proj', ['Cargo.toml']);
+        createProject(root, 'python-proj', ['pyproject.toml']);
+        createProject(root, 'go-proj', ['go.mod']);
+        const results = await scanForProjects([root]);
+        assert.equal(results.length, 6);
+        const byName = new Map(results.map(r => [r.name, r]));
+        assert.deepEqual(byName.get('git-proj').markers, ['git']);
+        assert.deepEqual(byName.get('node-proj').markers, ['node']);
+        assert.deepEqual(byName.get('gsd-proj').markers, ['gsd']);
+        assert.deepEqual(byName.get('rust-proj').markers, ['rust']);
+        assert.deepEqual(byName.get('python-proj').markers, ['python']);
+        assert.deepEqual(byName.get('go-proj').markers, ['go']);
+    });
+    it('skips non-directory entries', async () => {
+        const root = tmpDir();
+        cleanupDirs.push(root);
+        createProject(root, 'real-project', ['.git']);
+        // Create a regular file at the root level — should be ignored
+        writeFileSync(join(root, 'some-file.txt'), 'not a directory');
+        const results = await scanForProjects([root]);
+        assert.equal(results.length, 1);
+        assert.equal(results[0].name, 'real-project');
+    });
+    it('returns empty array for empty scan_roots', async () => {
+        const results = await scanForProjects([]);
+        assert.deepEqual(results, []);
+    });
+    it('deduplicates when same root appears twice', async () => {
+        const root = tmpDir();
+        cleanupDirs.push(root);
+        createProject(root, 'only-once', ['.git']);
+        const results = await scanForProjects([root, root]);
+        // Same directory scanned twice — results will have duplicates
+        // (this is acceptable; the caller can deduplicate by path if needed)
+        assert.equal(results.length, 2);
+        assert.equal(results[0].name, 'only-once');
+        assert.equal(results[1].name, 'only-once');
+    });
+});
+//# sourceMappingURL=project-scanner.test.js.map

package/packages/daemon/dist/project-scanner.test.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"project-scanner.test.js","sourceRoot":"","sources":["../src/project-scanner.test.ts"],"names":[],"mappings":"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","sourcesContent":["/**\n * Tests for the project scanner module.\n */\n\nimport { describe, it, afterEach } from 'node:test';\nimport assert from 'node:assert/strict';\nimport { mkdtempSync, mkdirSync, writeFileSync, rmSync, existsSync, chmodSync } from 'node:fs';\nimport { join } from 'node:path';\nimport { tmpdir, platform } from 'node:os';\nimport { randomUUID } from 'node:crypto';\nimport { scanForProjects } from './project-scanner.js';\n\n// ---------- helpers ----------\n\nfunction tmpDir(): string {\n  return mkdtempSync(join(tmpdir(), `scanner-test-${randomUUID().slice(0, 8)}-`));\n}\n\nconst cleanupDirs: string[] = [];\nafterEach(() => {\n  while (cleanupDirs.length) {\n    const d = cleanupDirs.pop()!;\n    if (existsSync(d)) rmSync(d, { recursive: true, force: true });\n  }\n});\n\n/** Create a project directory with specified marker files/dirs */\nfunction createProject(root: string, name: string, markers: string[]): string {\n  const projDir = join(root, name);\n  mkdirSync(projDir, { recursive: true });\n  for (const marker of markers) {\n    const markerPath = join(projDir, marker);\n    if (marker.startsWith('.') && !marker.includes('.')) {\n      // Likely a directory marker (.git, .gsd)\n      mkdirSync(markerPath, { recursive: true });\n    } else {\n      // File marker (package.json, Cargo.toml, etc.)\n      writeFileSync(markerPath, '{}');\n    }\n  }\n  return projDir;\n}\n\n// ---------- tests ----------\n\ndescribe('scanForProjects', () => {\n  it('finds projects with marker files', async () => {\n    const root = tmpDir();\n    cleanupDirs.push(root);\n\n    createProject(root, 'my-app', ['.git', 'package.json']);\n\n    const results = await scanForProjects([root]);\n\n    assert.equal(results.length, 1);\n    assert.equal(results[0]!.name, 'my-app');\n    assert.equal(results[0]!.path, join(root, 'my-app'));\n    assert.ok(results[0]!.markers.includes('git'));\n    assert.ok(results[0]!.markers.includes('node'));\n    assert.ok(results[0]!.lastModified > 0);\n  });\n\n  it('handles missing scan_root gracefully', async () => {\n    const results = await scanForProjects(['/nonexistent/path/that/does/not/exist']);\n    assert.deepEqual(results, []);\n  });\n\n  it('handles permission errors on entries', { skip: platform() === 'win32' ? 'chmod not reliable on Windows' : undefined }, async () => {\n    const root = tmpDir();\n    cleanupDirs.push(root);\n\n    // Create an accessible project\n    createProject(root, 'accessible', ['.git']);\n\n    // Create an inaccessible directory\n    const noAccess = join(root, 'locked');\n    mkdirSync(noAccess);\n    chmodSync(noAccess, 0o000);\n\n    const results = await scanForProjects([root]);\n\n    // Restore permissions for cleanup\n    chmodSync(noAccess, 0o755);\n\n    // Should find the accessible project but skip the locked one\n    assert.equal(results.length, 1);\n    assert.equal(results[0]!.name, 'accessible');\n  });\n\n  it('detects multiple marker types', async () => {\n    const root = tmpDir();\n    cleanupDirs.push(root);\n\n    createProject(root, 'full-stack', ['.git', 'package.json', '.gsd']);\n\n    const results = await scanForProjects([root]);\n\n    assert.equal(results.length, 1);\n    assert.equal(results[0]!.markers.length, 3);\n    assert.ok(results[0]!.markers.includes('git'));\n    assert.ok(results[0]!.markers.includes('node'));\n    assert.ok(results[0]!.markers.includes('gsd'));\n  });\n\n  it('returns results sorted alphabetically by name', async () => {\n    const root = tmpDir();\n    cleanupDirs.push(root);\n\n    createProject(root, 'zebra-project', ['.git']);\n    createProject(root, 'alpha-project', ['.git']);\n    createProject(root, 'middle-project', ['.git']);\n\n    const results = await scanForProjects([root]);\n\n    assert.equal(results.length, 3);\n    assert.equal(results[0]!.name, 'alpha-project');\n    assert.equal(results[1]!.name, 'middle-project');\n    assert.equal(results[2]!.name, 'zebra-project');\n  });\n\n  it('ignores hidden directories', async () => {\n    const root = tmpDir();\n    cleanupDirs.push(root);\n\n    createProject(root, 'visible', ['.git']);\n    createProject(root, '.hidden', ['.git']);\n\n    const results = await scanForProjects([root]);\n\n    assert.equal(results.length, 1);\n    assert.equal(results[0]!.name, 'visible');\n  });\n\n  it('ignores node_modules', async () => {\n    const root = tmpDir();\n    cleanupDirs.push(root);\n\n    createProject(root, 'real-project', ['package.json']);\n    createProject(root, 'node_modules', ['package.json']);\n\n    const results = await scanForProjects([root]);\n\n    assert.equal(results.length, 1);\n    assert.equal(results[0]!.name, 'real-project');\n  });\n\n  it('skips directories with no markers', async () => {\n    const root = tmpDir();\n    cleanupDirs.push(root);\n\n    createProject(root, 'has-markers', ['.git']);\n    // Create a plain directory with no markers\n    mkdirSync(join(root, 'no-markers'));\n\n    const results = await scanForProjects([root]);\n\n    assert.equal(results.length, 1);\n    assert.equal(results[0]!.name, 'has-markers');\n  });\n\n  it('scans multiple roots', async () => {\n    const root1 = tmpDir();\n    const root2 = tmpDir();\n    cleanupDirs.push(root1, root2);\n\n    createProject(root1, 'proj-a', ['.git']);\n    createProject(root2, 'proj-b', ['Cargo.toml']);\n\n    const results = await scanForProjects([root1, root2]);\n\n    assert.equal(results.length, 2);\n    assert.equal(results[0]!.name, 'proj-a');\n    assert.ok(results[0]!.markers.includes('git'));\n    assert.equal(results[1]!.name, 'proj-b');\n    assert.ok(results[1]!.markers.includes('rust'));\n  });\n\n  it('detects all supported marker types', async () => {\n    const root = tmpDir();\n    cleanupDirs.push(root);\n\n    createProject(root, 'git-proj', ['.git']);\n    createProject(root, 'node-proj', ['package.json']);\n    createProject(root, 'gsd-proj', ['.gsd']);\n    createProject(root, 'rust-proj', ['Cargo.toml']);\n    createProject(root, 'python-proj', ['pyproject.toml']);\n    createProject(root, 'go-proj', ['go.mod']);\n\n    const results = await scanForProjects([root]);\n\n    assert.equal(results.length, 6);\n\n    const byName = new Map(results.map(r => [r.name, r]));\n    assert.deepEqual(byName.get('git-proj')!.markers, ['git']);\n    assert.deepEqual(byName.get('node-proj')!.markers, ['node']);\n    assert.deepEqual(byName.get('gsd-proj')!.markers, ['gsd']);\n    assert.deepEqual(byName.get('rust-proj')!.markers, ['rust']);\n    assert.deepEqual(byName.get('python-proj')!.markers, ['python']);\n    assert.deepEqual(byName.get('go-proj')!.markers, ['go']);\n  });\n\n  it('skips non-directory entries', async () => {\n    const root = tmpDir();\n    cleanupDirs.push(root);\n\n    createProject(root, 'real-project', ['.git']);\n    // Create a regular file at the root level — should be ignored\n    writeFileSync(join(root, 'some-file.txt'), 'not a directory');\n\n    const results = await scanForProjects([root]);\n\n    assert.equal(results.length, 1);\n    assert.equal(results[0]!.name, 'real-project');\n  });\n\n  it('returns empty array for empty scan_roots', async () => {\n    const results = await scanForProjects([]);\n    assert.deepEqual(results, []);\n  });\n\n  it('deduplicates when same root appears twice', async () => {\n    const root = tmpDir();\n    cleanupDirs.push(root);\n\n    createProject(root, 'only-once', ['.git']);\n\n    const results = await scanForProjects([root, root]);\n\n    // Same directory scanned twice — results will have duplicates\n    // (this is acceptable; the caller can deduplicate by path if needed)\n    assert.equal(results.length, 2);\n    assert.equal(results[0]!.name, 'only-once');\n    assert.equal(results[1]!.name, 'only-once');\n  });\n});\n"]}

package/packages/daemon/dist/session-manager.d.ts

@@ -0,0 +1,70 @@
+/**
+ * SessionManager — manages RpcClient lifecycle for daemon-driven GSD execution.
+ *
+ * Extends EventEmitter to emit typed session lifecycle events.
+ * One active session per projectDir. Tracks events in a ring buffer,
+ * detects blockers, tracks terminal state, and accumulates cost using
+ * the cumulative-max pattern (K004).
+ *
+ * Adapted from packages/mcp-server/src/session-manager.ts with:
+ * - Logger integration for structured logging
+ * - EventEmitter for session lifecycle events
+ * - getAllSessions() for cross-project status (R035)
+ * - projectName field on ManagedSession
+ */
+import { EventEmitter } from 'node:events';
+import type { ManagedSession, StartSessionOptions } from './types.js';
+import type { Logger } from './logger.js';
+export declare class SessionManager extends EventEmitter {
+    private readonly logger;
+    /** Sessions keyed by resolved projectDir for duplicate-start prevention */
+    private sessions;
+    constructor(logger: Logger);
+    /**
+     * Start a new GSD auto-mode session for the given project directory.
+     *
+     * Rejects if a session already exists for this projectDir.
+     * Creates an RpcClient, starts the process, performs the v2 init handshake,
+     * wires event tracking, and sends '/gsd auto' to begin execution.
+     */
+    startSession(options: StartSessionOptions): Promise<string>;
+    /**
+     * Look up a session by sessionId.
+     * Linear scan is fine — we expect <10 concurrent sessions.
+     */
+    getSession(sessionId: string): ManagedSession | undefined;
+    /**
+     * Look up a session by project directory (direct map lookup).
+     */
+    getSessionByDir(projectDir: string): ManagedSession | undefined;
+    /**
+     * Return all tracked sessions (R035 — cross-project status).
+     */
+    getAllSessions(): ManagedSession[];
+    /**
+     * Resolve a pending blocker by sending a UI response.
+     */
+    resolveBlocker(sessionId: string, response: string): Promise<void>;
+    /**
+     * Cancel a running session — abort current operation then stop the process.
+     */
+    cancelSession(sessionId: string): Promise<void>;
+    cancelSessionByDir(projectDir: string): Promise<void>;
+    /**
+     * Build a HeadlessJsonResult-shaped object from accumulated session state.
+     */
+    getResult(sessionId: string): Record<string, unknown>;
+    /**
+     * Stop all active sessions and clean up resources.
+     */
+    cleanup(): Promise<void>;
+    /**
+     * Resolve the GSD CLI path.
+     *
+     * 1. GSD_CLI_PATH env var (highest priority)
+     * 2. `which gsd` → resolve to the actual dist/cli.js
+     */
+    static resolveCLIPath(): string;
+    private handleEvent;
+}
+//# sourceMappingURL=session-manager.d.ts.map

package/packages/daemon/dist/session-manager.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"session-manager.d.ts","sourceRoot":"","sources":["../src/session-manager.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;GAaG;AAIH,OAAO,EAAE,YAAY,EAAE,MAAM,aAAa,CAAC;AAG3C,OAAO,KAAK,EACV,cAAc,EACd,mBAAmB,EAEpB,MAAM,YAAY,CAAC;AAEpB,OAAO,KAAK,EAAE,MAAM,EAAE,MAAM,aAAa,CAAC;AAwC1C,qBAAa,cAAe,SAAQ,YAAY;IAIlC,OAAO,CAAC,QAAQ,CAAC,MAAM;IAHnC,2EAA2E;IAC3E,OAAO,CAAC,QAAQ,CAAqC;gBAExB,MAAM,EAAE,MAAM;IAI3C;;;;;;OAMG;IACG,YAAY,CAAC,OAAO,EAAE,mBAAmB,GAAG,OAAO,CAAC,MAAM,CAAC;IAyFjE;;;OAGG;IACH,UAAU,CAAC,SAAS,EAAE,MAAM,GAAG,cAAc,GAAG,SAAS;IAOzD;;OAEG;IACH,eAAe,CAAC,UAAU,EAAE,MAAM,GAAG,cAAc,GAAG,SAAS;IAI/D;;OAEG;IACH,cAAc,IAAI,cAAc,EAAE;IAIlC;;OAEG;IACG,cAAc,CAAC,SAAS,EAAE,MAAM,EAAE,QAAQ,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC;IAoBxE;;OAEG;IACG,aAAa,CAAC,SAAS,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC;IAkB/C,kBAAkB,CAAC,UAAU,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC;IAM3D;;OAEG;IACH,SAAS,CAAC,SAAS,EAAE,MAAM,GAAG,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC;IAqBrD;;OAEG;IACG,OAAO,IAAI,OAAO,CAAC,IAAI,CAAC;IAgB9B;;;;;OAKG;IACH,MAAM,CAAC,cAAc,IAAI,MAAM;IAoB/B,OAAO,CAAC,WAAW;CAuEpB"}

package/packages/daemon/dist/session-manager.js

@@ -0,0 +1,358 @@
+/**
+ * SessionManager — manages RpcClient lifecycle for daemon-driven GSD execution.
+ *
+ * Extends EventEmitter to emit typed session lifecycle events.
+ * One active session per projectDir. Tracks events in a ring buffer,
+ * detects blockers, tracks terminal state, and accumulates cost using
+ * the cumulative-max pattern (K004).
+ *
+ * Adapted from packages/mcp-server/src/session-manager.ts with:
+ * - Logger integration for structured logging
+ * - EventEmitter for session lifecycle events
+ * - getAllSessions() for cross-project status (R035)
+ * - projectName field on ManagedSession
+ */
+import { execSync } from 'node:child_process';
+import { basename, resolve } from 'node:path';
+import { EventEmitter } from 'node:events';
+import { RpcClient } from '@opengsd/rpc-client';
+import { MAX_EVENTS, INIT_TIMEOUT_MS } from './types.js';
+// ---------------------------------------------------------------------------
+// Inlined detection logic (from headless-events.ts — no internal package imports)
+// ---------------------------------------------------------------------------
+const FIRE_AND_FORGET_METHODS = new Set([
+    'notify', 'setStatus', 'setWidget', 'setTitle', 'set_editor_text',
+]);
+const TERMINAL_PREFIXES = [
+    'auto-mode stopped',
+    'step-mode stopped',
+    'auto-mode complete',
+    'no active milestone',
+    'auto-mode idle',
+];
+function isTerminalNotification(event) {
+    if (event.type !== 'extension_ui_request' || event.method !== 'notify')
+        return false;
+    const message = String(event.message ?? '').toLowerCase();
+    return TERMINAL_PREFIXES.some((prefix) => message.startsWith(prefix));
+}
+function isBlockedNotification(event) {
+    if (event.type !== 'extension_ui_request' || event.method !== 'notify')
+        return false;
+    const message = String(event.message ?? '').toLowerCase();
+    return message.includes('blocked:');
+}
+function isBlockingUIRequest(event) {
+    if (event.type !== 'extension_ui_request')
+        return false;
+    const method = String(event.method ?? '');
+    return !FIRE_AND_FORGET_METHODS.has(method);
+}
+// ---------------------------------------------------------------------------
+// SessionManager
+// ---------------------------------------------------------------------------
+export class SessionManager extends EventEmitter {
+    logger;
+    /** Sessions keyed by resolved projectDir for duplicate-start prevention */
+    sessions = new Map();
+    constructor(logger) {
+        super();
+        this.logger = logger;
+    }
+    /**
+     * Start a new GSD auto-mode session for the given project directory.
+     *
+     * Rejects if a session already exists for this projectDir.
+     * Creates an RpcClient, starts the process, performs the v2 init handshake,
+     * wires event tracking, and sends '/gsd auto' to begin execution.
+     */
+    async startSession(options) {
+        const { projectDir } = options;
+        if (!projectDir || projectDir.trim() === '') {
+            throw new Error('projectDir is required and cannot be empty');
+        }
+        const resolvedDir = resolve(projectDir);
+        const projectName = basename(resolvedDir);
+        const existing = this.sessions.get(resolvedDir);
+        if (existing) {
+            throw new Error(`Session already active for ${resolvedDir} (sessionId: ${existing.sessionId}, status: ${existing.status})`);
+        }
+        const cliPath = options.cliPath ?? SessionManager.resolveCLIPath();
+        const args = ['--mode', 'rpc'];
+        if (options.model)
+            args.push('--model', options.model);
+        if (options.bare)
+            args.push('--bare');
+        const client = new RpcClient({
+            cliPath,
+            cwd: resolvedDir,
+            args,
+        });
+        // Build the session shell before async operations so we can track state
+        const session = {
+            sessionId: '', // filled after init
+            projectDir: resolvedDir,
+            projectName,
+            status: 'starting',
+            client,
+            events: [],
+            pendingBlocker: null,
+            cost: { totalCost: 0, tokens: { input: 0, output: 0, cacheRead: 0, cacheWrite: 0 } },
+            startTime: Date.now(),
+        };
+        // Insert into map early (keyed by dir) so concurrent starts are rejected
+        this.sessions.set(resolvedDir, session);
+        try {
+            // Start the process with timeout
+            await Promise.race([
+                client.start(),
+                timeout(INIT_TIMEOUT_MS, `RpcClient.start() timed out after ${INIT_TIMEOUT_MS}ms`),
+            ]);
+            // Perform v2 init handshake
+            const initResult = await Promise.race([
+                client.init(),
+                timeout(INIT_TIMEOUT_MS, `RpcClient.init() timed out after ${INIT_TIMEOUT_MS}ms`),
+            ]);
+            session.sessionId = initResult.sessionId;
+            session.status = 'running';
+            // Wire event tracking
+            session.unsubscribe = client.onEvent((event) => {
+                this.handleEvent(session, event);
+            });
+            // Kick off auto-mode
+            const command = options.command ?? '/gsd auto';
+            await client.prompt(command);
+            this.logger.info('session started', { sessionId: session.sessionId, projectDir: resolvedDir });
+            this.emit('session:started', { sessionId: session.sessionId, projectDir: resolvedDir, projectName });
+            return session.sessionId;
+        }
+        catch (err) {
+            session.status = 'error';
+            session.error = err instanceof Error ? err.message : String(err);
+            // Attempt cleanup
+            try {
+                await client.stop();
+            }
+            catch { /* swallow cleanup errors */ }
+            this.logger.error('session error', { sessionId: session.sessionId, projectDir: resolvedDir, error: session.error });
+            this.emit('session:error', { sessionId: session.sessionId, projectDir: resolvedDir, projectName, error: session.error });
+            // Keep session in map so callers can inspect the error
+            throw new Error(`Failed to start session for ${resolvedDir}: ${session.error}`);
+        }
+    }
+    /**
+     * Look up a session by sessionId.
+     * Linear scan is fine — we expect <10 concurrent sessions.
+     */
+    getSession(sessionId) {
+        for (const session of this.sessions.values()) {
+            if (session.sessionId === sessionId)
+                return session;
+        }
+        return undefined;
+    }
+    /**
+     * Look up a session by project directory (direct map lookup).
+     */
+    getSessionByDir(projectDir) {
+        return this.sessions.get(resolve(projectDir));
+    }
+    /**
+     * Return all tracked sessions (R035 — cross-project status).
+     */
+    getAllSessions() {
+        return Array.from(this.sessions.values());
+    }
+    /**
+     * Resolve a pending blocker by sending a UI response.
+     */
+    async resolveBlocker(sessionId, response) {
+        const session = this.getSession(sessionId);
+        if (!session)
+            throw new Error(`Session not found: ${sessionId}`);
+        if (!session.pendingBlocker)
+            throw new Error(`No pending blocker for session ${sessionId}`);
+        const blocker = session.pendingBlocker;
+        session.client.sendUIResponse(blocker.id, { value: response });
+        session.pendingBlocker = null;
+        if (session.status === 'blocked') {
+            session.status = 'running';
+        }
+        this.logger.info('blocker resolved', {
+            sessionId,
+            projectDir: session.projectDir,
+            blockerId: blocker.id,
+            blockerMethod: blocker.method,
+        });
+    }
+    /**
+     * Cancel a running session — abort current operation then stop the process.
+     */
+    async cancelSession(sessionId) {
+        const session = this.getSession(sessionId);
+        if (!session)
+            throw new Error(`Session not found: ${sessionId}`);
+        try {
+            await session.client.abort();
+        }
+        catch { /* may already be stopped */ }
+        try {
+            await session.client.stop();
+        }
+        catch { /* swallow */ }
+        session.status = 'cancelled';
+        session.unsubscribe?.();
+        this.logger.info('session cancelled', { sessionId, projectDir: session.projectDir });
+    }
+    async cancelSessionByDir(projectDir) {
+        const session = this.getSessionByDir(projectDir);
+        if (!session)
+            throw new Error(`Session not found for projectDir: ${projectDir}`);
+        await this.cancelSession(session.sessionId);
+    }
+    /**
+     * Build a HeadlessJsonResult-shaped object from accumulated session state.
+     */
+    getResult(sessionId) {
+        const session = this.getSession(sessionId);
+        if (!session)
+            throw new Error(`Session not found: ${sessionId}`);
+        const durationMs = Date.now() - session.startTime;
+        return {
+            sessionId: session.sessionId,
+            projectDir: session.projectDir,
+            projectName: session.projectName,
+            status: session.status,
+            durationMs,
+            cost: session.cost,
+            recentEvents: session.events.slice(-10),
+            pendingBlocker: session.pendingBlocker
+                ? { id: session.pendingBlocker.id, method: session.pendingBlocker.method, message: session.pendingBlocker.message }
+                : null,
+            error: session.error ?? null,
+        };
+    }
+    /**
+     * Stop all active sessions and clean up resources.
+     */
+    async cleanup() {
+        const stopPromises = [];
+        for (const session of this.sessions.values()) {
+            session.unsubscribe?.();
+            if (session.status === 'running' || session.status === 'starting' || session.status === 'blocked') {
+                stopPromises.push(session.client.stop().catch(() => { }));
+                session.status = 'cancelled';
+            }
+        }
+        await Promise.allSettled(stopPromises);
+    }
+    /**
+     * Resolve the GSD CLI path.
+     *
+     * 1. GSD_CLI_PATH env var (highest priority)
+     * 2. `which gsd` → resolve to the actual dist/cli.js
+     */
+    static resolveCLIPath() {
+        const envPath = process.env['GSD_CLI_PATH'];
+        if (envPath)
+            return resolve(envPath);
+        try {
+            const gsdBin = execSync('which gsd', { encoding: 'utf-8' }).trim();
+            if (gsdBin)
+                return resolve(gsdBin);
+        }
+        catch {
+            // which failed
+        }
+        throw new Error('Cannot find GSD CLI. Set GSD_CLI_PATH environment variable or ensure `gsd` is in PATH.');
+    }
+    // ---------------------------------------------------------------------------
+    // Private: Event Handling
+    // ---------------------------------------------------------------------------
+    handleEvent(session, event) {
+        // Ring buffer: push and trim
+        session.events.push(event);
+        if (session.events.length > MAX_EVENTS) {
+            session.events.splice(0, session.events.length - MAX_EVENTS);
+        }
+        // Forward event to listeners
+        this.logger.debug('session event', { sessionId: session.sessionId, type: event.type });
+        this.emit('session:event', { sessionId: session.sessionId, projectDir: session.projectDir, event });
+        // Cost tracking (K004 — cumulative-max)
+        if (event.type === 'cost_update') {
+            const costEvent = event;
+            session.cost.totalCost = Math.max(session.cost.totalCost, costEvent.cumulativeCost ?? 0);
+            if (costEvent.tokens) {
+                session.cost.tokens.input = Math.max(session.cost.tokens.input, costEvent.tokens.input ?? 0);
+                session.cost.tokens.output = Math.max(session.cost.tokens.output, costEvent.tokens.output ?? 0);
+                session.cost.tokens.cacheRead = Math.max(session.cost.tokens.cacheRead, costEvent.tokens.cacheRead ?? 0);
+                session.cost.tokens.cacheWrite = Math.max(session.cost.tokens.cacheWrite, costEvent.tokens.cacheWrite ?? 0);
+            }
+        }
+        // Terminal detection — auto-mode/step-mode stopped
+        if (isTerminalNotification(event)) {
+            if (isBlockedNotification(event)) {
+                session.status = 'blocked';
+                session.pendingBlocker = extractBlocker(event);
+                this.logger.info('session blocked', {
+                    sessionId: session.sessionId,
+                    projectDir: session.projectDir,
+                    blockerId: session.pendingBlocker.id,
+                    blockerMethod: session.pendingBlocker.method,
+                });
+                this.emit('session:blocked', {
+                    sessionId: session.sessionId,
+                    projectDir: session.projectDir,
+                    projectName: session.projectName,
+                    blocker: session.pendingBlocker,
+                });
+            }
+            else {
+                session.status = 'completed';
+                session.unsubscribe?.();
+                this.logger.info('session completed', { sessionId: session.sessionId, projectDir: session.projectDir });
+                this.emit('session:completed', {
+                    sessionId: session.sessionId,
+                    projectDir: session.projectDir,
+                    projectName: session.projectName,
+                });
+            }
+            return;
+        }
+        // Blocker detection — non-fire-and-forget extension_ui_request
+        if (isBlockingUIRequest(event)) {
+            session.status = 'blocked';
+            session.pendingBlocker = extractBlocker(event);
+            this.logger.info('session blocked', {
+                sessionId: session.sessionId,
+                projectDir: session.projectDir,
+                blockerId: session.pendingBlocker.id,
+                blockerMethod: session.pendingBlocker.method,
+            });
+            this.emit('session:blocked', {
+                sessionId: session.sessionId,
+                projectDir: session.projectDir,
+                projectName: session.projectName,
+                blocker: session.pendingBlocker,
+            });
+        }
+    }
+}
+// ---------------------------------------------------------------------------
+// Helpers
+// ---------------------------------------------------------------------------
+function timeout(ms, message) {
+    return new Promise((_, reject) => {
+        setTimeout(() => reject(new Error(message)), ms);
+    });
+}
+function extractBlocker(event) {
+    const uiEvent = event;
+    return {
+        id: String(uiEvent.id ?? ''),
+        method: uiEvent.method,
+        message: String(uiEvent.title ?? uiEvent.message ?? ''),
+        event: uiEvent,
+    };
+}
+//# sourceMappingURL=session-manager.js.map