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

package/packages/daemon/dist/launchd.js

@@ -0,0 +1,188 @@
+import { writeFileSync, unlinkSync, existsSync, chmodSync } from 'node:fs';
+import { resolve } from 'node:path';
+import { homedir } from 'node:os';
+import { execSync } from 'node:child_process';
+import { dirname } from 'node:path';
+// --------------- constants ---------------
+const LABEL = 'com.gsd.daemon';
+const PLIST_FILENAME = `${LABEL}.plist`;
+// --------------- helpers ---------------
+/** Escape special XML characters in a string. */
+export function escapeXml(str) {
+    return str
+        .replace(/&/g, '&')
+        .replace(/</g, '&lt;')
+        .replace(/>/g, '&gt;')
+        .replace(/"/g, '&quot;')
+        .replace(/'/g, '&apos;');
+}
+/** Return the canonical plist path under ~/Library/LaunchAgents/. */
+export function getPlistPath() {
+    return resolve(homedir(), 'Library', 'LaunchAgents', PLIST_FILENAME);
+}
+/**
+ * Build the NVM-aware PATH string.
+ * Includes the directory containing the Node binary so that launchd can find node
+ * even when launched outside a shell session (where NVM isn't sourced).
+ */
+function buildEnvPath(nodePath) {
+    const nodeBinDir = dirname(nodePath);
+    // Keep system essentials and prepend the node binary's directory
+    return `${nodeBinDir}:/usr/local/bin:/usr/bin:/bin:/usr/sbin:/sbin`;
+}
+// --------------- plist generation ---------------
+/** Generate valid launchd plist XML for the GSD daemon. */
+export function generatePlist(opts) {
+    const home = homedir();
+    const workDir = opts.workingDirectory ?? home;
+    const stdoutPath = opts.stdoutPath ?? resolve(home, '.gsd', 'daemon-stdout.log');
+    const stderrPath = opts.stderrPath ?? resolve(home, '.gsd', 'daemon-stderr.log');
+    const envPath = buildEnvPath(opts.nodePath);
+    // Forward ANTHROPIC_API_KEY so the orchestrator LLM can authenticate.
+    // Captured at install time from the current process environment.
+    const anthropicKey = process.env.ANTHROPIC_API_KEY;
+    const anthropicKeyXml = anthropicKey
+        ? `\n\t\t<key>ANTHROPIC_API_KEY</key>\n\t\t<string>${escapeXml(anthropicKey)}</string>`
+        : '';
+    return `<?xml version="1.0" encoding="UTF-8"?>
+<!DOCTYPE plist PUBLIC "-//Apple//DTD PLIST 1.0//EN" "http://www.apple.com/DTDs/PropertyList-1.0.dtd">
+<plist version="1.0">
+<dict>
+\t<key>Label</key>
+\t<string>${escapeXml(LABEL)}</string>
+
+\t<key>ProgramArguments</key>
+\t<array>
+\t\t<string>${escapeXml(opts.nodePath)}</string>
+\t\t<string>${escapeXml(opts.scriptPath)}</string>
+\t\t<string>--config</string>
+\t\t<string>${escapeXml(opts.configPath)}</string>
+\t</array>
+
+\t<key>KeepAlive</key>
+\t<dict>
+\t\t<key>SuccessfulExit</key>
+\t\t<false/>
+\t</dict>
+
+\t<key>RunAtLoad</key>
+\t<true/>
+
+\t<key>EnvironmentVariables</key>
+\t<dict>
+\t\t<key>PATH</key>
+\t\t<string>${escapeXml(envPath)}</string>
+\t\t<key>HOME</key>
+\t\t<string>${escapeXml(home)}</string>${anthropicKeyXml}
+\t</dict>
+
+\t<key>WorkingDirectory</key>
+\t<string>${escapeXml(workDir)}</string>
+
+\t<key>StandardOutPath</key>
+\t<string>${escapeXml(stdoutPath)}</string>
+
+\t<key>StandardErrorPath</key>
+\t<string>${escapeXml(stderrPath)}</string>
+</dict>
+</plist>
+`;
+}
+// --------------- install / uninstall / status ---------------
+/** Default runCommand using execSync. */
+function defaultRunCommand(cmd) {
+    return execSync(cmd, { encoding: 'utf-8', stdio: ['pipe', 'pipe', 'pipe'] });
+}
+/**
+ * Install the launchd agent: write plist and load it.
+ * Idempotent — unloads first if already loaded.
+ */
+export function install(opts, runCommand = defaultRunCommand) {
+    const plistPath = getPlistPath();
+    const xml = generatePlist(opts);
+    // Unload first if already present (ignore errors)
+    if (existsSync(plistPath)) {
+        try {
+            runCommand(`launchctl unload ${plistPath}`);
+        }
+        catch {
+            // already unloaded — fine
+        }
+    }
+    writeFileSync(plistPath, xml, 'utf-8');
+    chmodSync(plistPath, 0o644);
+    runCommand(`launchctl load ${plistPath}`);
+    // Verify it loaded
+    try {
+        runCommand(`launchctl list ${LABEL}`);
+    }
+    catch {
+        throw new Error(`Plist was written to ${plistPath} and launchctl load succeeded, but launchctl list ${LABEL} failed. The agent may not have started.`);
+    }
+}
+/**
+ * Uninstall the launchd agent: unload and remove plist.
+ * Graceful — does not throw if already uninstalled.
+ */
+export function uninstall(runCommand = defaultRunCommand) {
+    const plistPath = getPlistPath();
+    if (existsSync(plistPath)) {
+        try {
+            runCommand(`launchctl unload ${plistPath}`);
+        }
+        catch {
+            // already unloaded — that's fine
+        }
+        unlinkSync(plistPath);
+    }
+    // If plist doesn't exist, nothing to do — already uninstalled
+}
+/**
+ * Query launchd for the daemon's status.
+ * Returns structured information about registration, PID, and last exit code.
+ *
+ * Handles two launchctl output formats:
+ * 1. Tabular: "PID\tStatus\tLabel" (older macOS)
+ * 2. JSON-style dict: `"PID" = 1234;` / `"LastExitStatus" = 0;` (newer macOS)
+ */
+export function status(runCommand = defaultRunCommand) {
+    try {
+        const output = runCommand(`launchctl list ${LABEL}`);
+        // --- Try tabular format first ---
+        const lines = output.trim().split('\n');
+        for (const line of lines) {
+            const parts = line.trim().split(/\t+/);
+            if (parts.length >= 3 && parts[2] === LABEL) {
+                const pidStr = parts[0];
+                const statusStr = parts[1];
+                const pid = pidStr === '-' ? null : parseInt(pidStr, 10);
+                const lastExitStatus = statusStr != null ? parseInt(statusStr, 10) : null;
+                return {
+                    registered: true,
+                    pid: Number.isNaN(pid) ? null : pid,
+                    lastExitStatus: Number.isNaN(lastExitStatus) ? null : lastExitStatus,
+                };
+            }
+        }
+        // --- Try JSON-style dict format ---
+        // Matches: "PID" = 1234;  or  "LastExitStatus" = 0;
+        const pidMatch = output.match(/"PID"\s*=\s*(\d+)\s*;/);
+        const exitMatch = output.match(/"LastExitStatus"\s*=\s*(\d+)\s*;/);
+        if (pidMatch || exitMatch) {
+            const pid = pidMatch ? parseInt(pidMatch[1], 10) : null;
+            const lastExitStatus = exitMatch ? parseInt(exitMatch[1], 10) : null;
+            return {
+                registered: true,
+                pid: Number.isNaN(pid) ? null : pid,
+                lastExitStatus: Number.isNaN(lastExitStatus) ? null : lastExitStatus,
+            };
+        }
+        // Label resolved (no error) but no parseable output — still registered
+        return { registered: true, pid: null, lastExitStatus: null };
+    }
+    catch {
+        // launchctl list exits non-zero when the label isn't found
+        return { registered: false, pid: null, lastExitStatus: null };
+    }
+}
+//# sourceMappingURL=launchd.js.map

package/packages/daemon/dist/launchd.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"launchd.js","sourceRoot":"","sources":["../src/launchd.ts"],"names":[],"mappings":"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","sourcesContent":["import { writeFileSync, unlinkSync, existsSync, chmodSync } from 'node:fs';\nimport { resolve } from 'node:path';\nimport { homedir } from 'node:os';\nimport { execSync } from 'node:child_process';\nimport { dirname } from 'node:path';\n\n// --------------- types ---------------\n\nexport interface PlistOptions {\n  /** Absolute path to the Node.js binary */\n  nodePath: string;\n  /** Absolute path to the daemon script (cli.js) */\n  scriptPath: string;\n  /** Absolute path to the config file */\n  configPath: string;\n  /** Directory to use as WorkingDirectory in the plist (defaults to homedir) */\n  workingDirectory?: string;\n  /** Override stdout log path */\n  stdoutPath?: string;\n  /** Override stderr log path */\n  stderrPath?: string;\n}\n\nexport interface LaunchdStatus {\n  /** Whether the daemon is registered with launchd */\n  registered: boolean;\n  /** PID if currently running, null otherwise */\n  pid: number | null;\n  /** Last exit status code, null if never exited or not available */\n  lastExitStatus: number | null;\n}\n\nexport type RunCommandFn = (cmd: string) => string;\n\n// --------------- constants ---------------\n\nconst LABEL = 'com.gsd.daemon';\nconst PLIST_FILENAME = `${LABEL}.plist`;\n\n// --------------- helpers ---------------\n\n/** Escape special XML characters in a string. */\nexport function escapeXml(str: string): string {\n  return str\n    .replace(/&/g, '&amp;')\n    .replace(/</g, '&lt;')\n    .replace(/>/g, '&gt;')\n    .replace(/\"/g, '&quot;')\n    .replace(/'/g, '&apos;');\n}\n\n/** Return the canonical plist path under ~/Library/LaunchAgents/. */\nexport function getPlistPath(): string {\n  return resolve(homedir(), 'Library', 'LaunchAgents', PLIST_FILENAME);\n}\n\n/**\n * Build the NVM-aware PATH string.\n * Includes the directory containing the Node binary so that launchd can find node\n * even when launched outside a shell session (where NVM isn't sourced).\n */\nfunction buildEnvPath(nodePath: string): string {\n  const nodeBinDir = dirname(nodePath);\n  // Keep system essentials and prepend the node binary's directory\n  return `${nodeBinDir}:/usr/local/bin:/usr/bin:/bin:/usr/sbin:/sbin`;\n}\n\n// --------------- plist generation ---------------\n\n/** Generate valid launchd plist XML for the GSD daemon. */\nexport function generatePlist(opts: PlistOptions): string {\n  const home = homedir();\n  const workDir = opts.workingDirectory ?? home;\n  const stdoutPath = opts.stdoutPath ?? resolve(home, '.gsd', 'daemon-stdout.log');\n  const stderrPath = opts.stderrPath ?? resolve(home, '.gsd', 'daemon-stderr.log');\n  const envPath = buildEnvPath(opts.nodePath);\n\n  // Forward ANTHROPIC_API_KEY so the orchestrator LLM can authenticate.\n  // Captured at install time from the current process environment.\n  const anthropicKey = process.env.ANTHROPIC_API_KEY;\n  const anthropicKeyXml = anthropicKey\n    ? `\\n\\t\\t<key>ANTHROPIC_API_KEY</key>\\n\\t\\t<string>${escapeXml(anthropicKey)}</string>`\n    : '';\n\n  return `<?xml version=\"1.0\" encoding=\"UTF-8\"?>\n<!DOCTYPE plist PUBLIC \"-//Apple//DTD PLIST 1.0//EN\" \"http://www.apple.com/DTDs/PropertyList-1.0.dtd\">\n<plist version=\"1.0\">\n<dict>\n\\t<key>Label</key>\n\\t<string>${escapeXml(LABEL)}</string>\n\n\\t<key>ProgramArguments</key>\n\\t<array>\n\\t\\t<string>${escapeXml(opts.nodePath)}</string>\n\\t\\t<string>${escapeXml(opts.scriptPath)}</string>\n\\t\\t<string>--config</string>\n\\t\\t<string>${escapeXml(opts.configPath)}</string>\n\\t</array>\n\n\\t<key>KeepAlive</key>\n\\t<dict>\n\\t\\t<key>SuccessfulExit</key>\n\\t\\t<false/>\n\\t</dict>\n\n\\t<key>RunAtLoad</key>\n\\t<true/>\n\n\\t<key>EnvironmentVariables</key>\n\\t<dict>\n\\t\\t<key>PATH</key>\n\\t\\t<string>${escapeXml(envPath)}</string>\n\\t\\t<key>HOME</key>\n\\t\\t<string>${escapeXml(home)}</string>${anthropicKeyXml}\n\\t</dict>\n\n\\t<key>WorkingDirectory</key>\n\\t<string>${escapeXml(workDir)}</string>\n\n\\t<key>StandardOutPath</key>\n\\t<string>${escapeXml(stdoutPath)}</string>\n\n\\t<key>StandardErrorPath</key>\n\\t<string>${escapeXml(stderrPath)}</string>\n</dict>\n</plist>\n`;\n}\n\n// --------------- install / uninstall / status ---------------\n\n/** Default runCommand using execSync. */\nfunction defaultRunCommand(cmd: string): string {\n  return execSync(cmd, { encoding: 'utf-8', stdio: ['pipe', 'pipe', 'pipe'] });\n}\n\n/**\n * Install the launchd agent: write plist and load it.\n * Idempotent — unloads first if already loaded.\n */\nexport function install(\n  opts: PlistOptions,\n  runCommand: RunCommandFn = defaultRunCommand,\n): void {\n  const plistPath = getPlistPath();\n  const xml = generatePlist(opts);\n\n  // Unload first if already present (ignore errors)\n  if (existsSync(plistPath)) {\n    try {\n      runCommand(`launchctl unload ${plistPath}`);\n    } catch {\n      // already unloaded — fine\n    }\n  }\n\n  writeFileSync(plistPath, xml, 'utf-8');\n  chmodSync(plistPath, 0o644);\n\n  runCommand(`launchctl load ${plistPath}`);\n\n  // Verify it loaded\n  try {\n    runCommand(`launchctl list ${LABEL}`);\n  } catch {\n    throw new Error(\n      `Plist was written to ${plistPath} and launchctl load succeeded, but launchctl list ${LABEL} failed. The agent may not have started.`,\n    );\n  }\n}\n\n/**\n * Uninstall the launchd agent: unload and remove plist.\n * Graceful — does not throw if already uninstalled.\n */\nexport function uninstall(runCommand: RunCommandFn = defaultRunCommand): void {\n  const plistPath = getPlistPath();\n\n  if (existsSync(plistPath)) {\n    try {\n      runCommand(`launchctl unload ${plistPath}`);\n    } catch {\n      // already unloaded — that's fine\n    }\n    unlinkSync(plistPath);\n  }\n  // If plist doesn't exist, nothing to do — already uninstalled\n}\n\n/**\n * Query launchd for the daemon's status.\n * Returns structured information about registration, PID, and last exit code.\n *\n * Handles two launchctl output formats:\n * 1. Tabular: \"PID\\tStatus\\tLabel\" (older macOS)\n * 2. JSON-style dict: `\"PID\" = 1234;` / `\"LastExitStatus\" = 0;` (newer macOS)\n */\nexport function status(runCommand: RunCommandFn = defaultRunCommand): LaunchdStatus {\n  try {\n    const output = runCommand(`launchctl list ${LABEL}`);\n\n    // --- Try tabular format first ---\n    const lines = output.trim().split('\\n');\n    for (const line of lines) {\n      const parts = line.trim().split(/\\t+/);\n      if (parts.length >= 3 && parts[2] === LABEL) {\n        const pidStr = parts[0];\n        const statusStr = parts[1];\n\n        const pid = pidStr === '-' ? null : parseInt(pidStr, 10);\n        const lastExitStatus = statusStr != null ? parseInt(statusStr, 10) : null;\n\n        return {\n          registered: true,\n          pid: Number.isNaN(pid!) ? null : pid,\n          lastExitStatus: Number.isNaN(lastExitStatus!) ? null : lastExitStatus,\n        };\n      }\n    }\n\n    // --- Try JSON-style dict format ---\n    // Matches: \"PID\" = 1234;  or  \"LastExitStatus\" = 0;\n    const pidMatch = output.match(/\"PID\"\\s*=\\s*(\\d+)\\s*;/);\n    const exitMatch = output.match(/\"LastExitStatus\"\\s*=\\s*(\\d+)\\s*;/);\n\n    if (pidMatch || exitMatch) {\n      const pid = pidMatch ? parseInt(pidMatch[1], 10) : null;\n      const lastExitStatus = exitMatch ? parseInt(exitMatch[1], 10) : null;\n      return {\n        registered: true,\n        pid: Number.isNaN(pid!) ? null : pid,\n        lastExitStatus: Number.isNaN(lastExitStatus!) ? null : lastExitStatus,\n      };\n    }\n\n    // Label resolved (no error) but no parseable output — still registered\n    return { registered: true, pid: null, lastExitStatus: null };\n  } catch {\n    // launchctl list exits non-zero when the label isn't found\n    return { registered: false, pid: null, lastExitStatus: null };\n  }\n}\n"]}

package/packages/daemon/dist/launchd.test.d.ts

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=launchd.test.d.ts.map

package/packages/daemon/dist/launchd.test.d.ts.map

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

package/packages/daemon/dist/launchd.test.js

@@ -0,0 +1,296 @@
+import { describe, it, afterEach } from 'node:test';
+import assert from 'node:assert/strict';
+import { mkdtempSync, existsSync, rmSync } from 'node:fs';
+import { join } from 'node:path';
+import { tmpdir, homedir } from 'node:os';
+import { randomUUID } from 'node:crypto';
+import { escapeXml, generatePlist, getPlistPath, install, uninstall, status, } from './launchd.js';
+// ---------- helpers ----------
+function tmpDir() {
+    return mkdtempSync(join(tmpdir(), `launchd-test-${randomUUID().slice(0, 8)}-`));
+}
+const cleanupDirs = [];
+afterEach(() => {
+    while (cleanupDirs.length) {
+        const d = cleanupDirs.pop();
+        if (existsSync(d))
+            rmSync(d, { recursive: true, force: true });
+    }
+});
+function basePlistOpts(overrides) {
+    return {
+        nodePath: '/usr/local/bin/node',
+        scriptPath: '/usr/local/lib/gsd-daemon/dist/cli.js',
+        configPath: join(homedir(), '.gsd', 'daemon.yaml'),
+        ...overrides,
+    };
+}
+// ---------- escapeXml ----------
+describe('escapeXml', () => {
+    it('escapes & < > " \'', () => {
+        assert.equal(escapeXml('a&b<c>d"e\'f'), 'a&amp;b&lt;c&gt;d&quot;e&apos;f');
+    });
+    it('leaves plain strings untouched', () => {
+        assert.equal(escapeXml('/usr/local/bin/node'), '/usr/local/bin/node');
+    });
+    it('escapes paths with spaces and special chars', () => {
+        const input = '/Users/John & Jane/my "project"/file.js';
+        const output = escapeXml(input);
+        assert.ok(output.includes('&amp;'));
+        assert.ok(output.includes('&quot;'));
+        // Verify no raw unescaped & remain (all & are part of &amp; &lt; etc.)
+        assert.equal(output, '/Users/John &amp; Jane/my &quot;project&quot;/file.js');
+    });
+});
+// ---------- generatePlist ----------
+describe('generatePlist', () => {
+    it('produces valid XML with plist header', () => {
+        const xml = generatePlist(basePlistOpts());
+        assert.ok(xml.startsWith('<?xml version="1.0"'));
+        assert.ok(xml.includes('<!DOCTYPE plist'));
+        assert.ok(xml.includes('<plist version="1.0">'));
+        assert.ok(xml.includes('</plist>'));
+    });
+    it('includes label com.gsd.daemon', () => {
+        const xml = generatePlist(basePlistOpts());
+        assert.ok(xml.includes('<string>com.gsd.daemon</string>'));
+    });
+    it('uses the absolute node path from opts', () => {
+        const opts = basePlistOpts({ nodePath: '/home/user/.nvm/versions/node/v22.0.0/bin/node' });
+        const xml = generatePlist(opts);
+        assert.ok(xml.includes('<string>/home/user/.nvm/versions/node/v22.0.0/bin/node</string>'));
+    });
+    it('includes NVM bin directory in PATH', () => {
+        const opts = basePlistOpts({ nodePath: '/home/user/.nvm/versions/node/v22.0.0/bin/node' });
+        const xml = generatePlist(opts);
+        assert.ok(xml.includes('/home/user/.nvm/versions/node/v22.0.0/bin'));
+    });
+    it('sets KeepAlive with SuccessfulExit false', () => {
+        const xml = generatePlist(basePlistOpts());
+        assert.ok(xml.includes('<key>KeepAlive</key>'));
+        assert.ok(xml.includes('<key>SuccessfulExit</key>'));
+        assert.ok(xml.includes('<false/>'));
+    });
+    it('sets RunAtLoad true', () => {
+        const xml = generatePlist(basePlistOpts());
+        assert.ok(xml.includes('<key>RunAtLoad</key>'));
+        assert.ok(xml.includes('<true/>'));
+    });
+    it('includes --config with the config path', () => {
+        const configPath = '/custom/path/daemon.yaml';
+        const xml = generatePlist(basePlistOpts({ configPath }));
+        assert.ok(xml.includes('<string>--config</string>'));
+        assert.ok(xml.includes(`<string>${configPath}</string>`));
+    });
+    it('includes HOME environment variable', () => {
+        const xml = generatePlist(basePlistOpts());
+        assert.ok(xml.includes('<key>HOME</key>'));
+        assert.ok(xml.includes(`<string>${homedir()}</string>`));
+    });
+    it('includes StandardOutPath and StandardErrorPath', () => {
+        const xml = generatePlist(basePlistOpts());
+        assert.ok(xml.includes('<key>StandardOutPath</key>'));
+        assert.ok(xml.includes('<key>StandardErrorPath</key>'));
+    });
+    it('escapes special characters in paths', () => {
+        const opts = basePlistOpts({
+            configPath: '/Users/John & Jane/config.yaml',
+        });
+        const xml = generatePlist(opts);
+        assert.ok(xml.includes('John &amp; Jane'));
+        assert.ok(!xml.includes('John & Jane'));
+    });
+    it('uses custom stdout/stderr paths when provided', () => {
+        const opts = basePlistOpts({
+            stdoutPath: '/tmp/my-stdout.log',
+            stderrPath: '/tmp/my-stderr.log',
+        });
+        const xml = generatePlist(opts);
+        assert.ok(xml.includes('<string>/tmp/my-stdout.log</string>'));
+        assert.ok(xml.includes('<string>/tmp/my-stderr.log</string>'));
+    });
+    it('uses custom working directory when provided', () => {
+        const opts = basePlistOpts({
+            workingDirectory: '/custom/work/dir',
+        });
+        const xml = generatePlist(opts);
+        assert.ok(xml.includes('<string>/custom/work/dir</string>'));
+    });
+});
+// ---------- getPlistPath ----------
+describe('getPlistPath', () => {
+    it('returns ~/Library/LaunchAgents/com.gsd.daemon.plist', () => {
+        const expected = join(homedir(), 'Library', 'LaunchAgents', 'com.gsd.daemon.plist');
+        assert.equal(getPlistPath(), expected);
+    });
+});
+// ---------- install ----------
+describe('install', () => {
+    let tmp;
+    let fakePlistPath;
+    // We can't mock getPlistPath directly, but we can verify the commands
+    // issued and the plist content by intercepting runCommand and filesystem ops.
+    // For filesystem testing, we test the functions that call writeFileSync indirectly
+    // by verifying the runCommand calls and returned values.
+    it('calls launchctl load with the plist path', () => {
+        const calls = [];
+        const mockRun = (cmd) => {
+            calls.push(cmd);
+            return '';
+        };
+        // install will try to write to the real plist path, so we need to be careful.
+        // We test the command flow by catching the writeFileSync error (dir may not exist in CI)
+        // or by letting it proceed in local dev.
+        try {
+            install(basePlistOpts(), mockRun);
+        }
+        catch {
+            // writeFileSync may fail if ~/Library/LaunchAgents doesn't exist in test env
+        }
+        const loadCalls = calls.filter(c => c.startsWith('launchctl load'));
+        const listCalls = calls.filter(c => c.startsWith('launchctl list'));
+        // Should have at least attempted launchctl load
+        assert.ok(loadCalls.length > 0 || calls.length > 0, 'Expected launchctl commands to be called');
+    });
+    it('generates valid plist content when called', () => {
+        // Test that the plist content would be correct by testing generatePlist
+        // (install is a thin wrapper around generatePlist + writeFile + launchctl)
+        const xml = generatePlist(basePlistOpts());
+        assert.ok(xml.includes('<key>Label</key>'));
+        assert.ok(xml.includes('<string>com.gsd.daemon</string>'));
+    });
+    it('handles idempotent install (unloads first if plist exists)', () => {
+        const calls = [];
+        const mockRun = (cmd) => {
+            calls.push(cmd);
+            return '';
+        };
+        // To simulate idempotent install, we need an existing plist file.
+        // Since install writes to getPlistPath(), we test the command sequence.
+        try {
+            install(basePlistOpts(), mockRun);
+            // Second install
+            install(basePlistOpts(), mockRun);
+        }
+        catch {
+            // filesystem may not be writable
+        }
+        // The second install should have tried to unload first
+        const unloadCalls = calls.filter(c => c.startsWith('launchctl unload'));
+        // If the plist path exists, we expect at least one unload attempt on second call
+        // This is a command-level check; filesystem existence depends on environment
+    });
+});
+// ---------- uninstall ----------
+describe('uninstall', () => {
+    it('calls launchctl unload when plist would exist', () => {
+        const calls = [];
+        const mockRun = (cmd) => {
+            calls.push(cmd);
+            return '';
+        };
+        // uninstall checks existsSync(plistPath) — if plist doesn't exist, it's a no-op
+        uninstall(mockRun);
+        // If plist doesn't exist in test environment, calls should be empty (graceful)
+        // That's the "handles missing plist gracefully" case
+    });
+    it('handles missing plist gracefully (no-op)', () => {
+        const calls = [];
+        const mockRun = (cmd) => {
+            calls.push(cmd);
+            return '';
+        };
+        // Shouldn't throw even if plist doesn't exist
+        assert.doesNotThrow(() => uninstall(mockRun));
+    });
+    it('handles already-unloaded agent gracefully', () => {
+        const mockRun = (cmd) => {
+            if (cmd.includes('launchctl unload')) {
+                throw new Error('Could not find specified service');
+            }
+            return '';
+        };
+        // Should not throw even if launchctl unload fails
+        assert.doesNotThrow(() => uninstall(mockRun));
+    });
+});
+// ---------- status ----------
+describe('status', () => {
+    it('parses running daemon output (PID present)', () => {
+        const mockRun = (_cmd) => {
+            return '{\n\t"PID" = 1234;\n\t"Label" = "com.gsd.daemon";\n}\nPID\tStatus\tLabel\n1234\t0\tcom.gsd.daemon\n';
+        };
+        const result = status(mockRun);
+        assert.equal(result.registered, true);
+        assert.equal(result.pid, 1234);
+        assert.equal(result.lastExitStatus, 0);
+    });
+    it('parses stopped daemon output (no PID)', () => {
+        const mockRun = (_cmd) => {
+            return 'PID\tStatus\tLabel\n-\t78\tcom.gsd.daemon\n';
+        };
+        const result = status(mockRun);
+        assert.equal(result.registered, true);
+        assert.equal(result.pid, null);
+        assert.equal(result.lastExitStatus, 78);
+    });
+    it('returns not-registered when launchctl list fails', () => {
+        const mockRun = (_cmd) => {
+            throw new Error('Could not find service "com.gsd.daemon" in domain for port');
+        };
+        const result = status(mockRun);
+        assert.equal(result.registered, false);
+        assert.equal(result.pid, null);
+        assert.equal(result.lastExitStatus, null);
+    });
+    it('returns structured result with all fields', () => {
+        const mockRun = (_cmd) => {
+            return 'PID\tStatus\tLabel\n5678\t0\tcom.gsd.daemon\n';
+        };
+        const result = status(mockRun);
+        assert.ok('registered' in result);
+        assert.ok('pid' in result);
+        assert.ok('lastExitStatus' in result);
+    });
+    it('parses JSON-style dict output (newer macOS)', () => {
+        const mockRun = (_cmd) => {
+            return `{
+\t"StandardOutPath" = "/Users/me/.gsd/daemon-stdout.log";
+\t"LimitLoadToSessionType" = "Aqua";
+\t"StandardErrorPath" = "/Users/me/.gsd/daemon-stderr.log";
+\t"Label" = "com.gsd.daemon";
+\t"OnDemand" = true;
+\t"LastExitStatus" = 0;
+\t"PID" = 23802;
+\t"Program" = "/usr/local/bin/node";
+};`;
+        };
+        const result = status(mockRun);
+        assert.equal(result.registered, true);
+        assert.equal(result.pid, 23802);
+        assert.equal(result.lastExitStatus, 0);
+    });
+    it('parses JSON-style dict output when daemon stopped (no PID key)', () => {
+        const mockRun = (_cmd) => {
+            return `{
+\t"Label" = "com.gsd.daemon";
+\t"LastExitStatus" = 1;
+\t"OnDemand" = true;
+};`;
+        };
+        const result = status(mockRun);
+        assert.equal(result.registered, true);
+        assert.equal(result.pid, null);
+        assert.equal(result.lastExitStatus, 1);
+    });
+    it('handles unexpected output format gracefully', () => {
+        const mockRun = (_cmd) => {
+            return 'some unexpected output without the label';
+        };
+        // Should not throw — should return registered:true but with null fields
+        // since the command succeeded (label was found) but output didn't match
+        const result = status(mockRun);
+        assert.equal(result.registered, true);
+    });
+});
+//# sourceMappingURL=launchd.test.js.map

package/packages/daemon/dist/launchd.test.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"launchd.test.js","sourceRoot":"","sources":["../src/launchd.test.ts"],"names":[],"mappings":"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","sourcesContent":["import { describe, it, beforeEach, afterEach } from 'node:test';\nimport assert from 'node:assert/strict';\nimport { mkdtempSync, existsSync, readFileSync, writeFileSync, rmSync, mkdirSync, statSync } from 'node:fs';\nimport { join, dirname } from 'node:path';\nimport { tmpdir, homedir } from 'node:os';\nimport { randomUUID } from 'node:crypto';\nimport {\n  escapeXml,\n  generatePlist,\n  getPlistPath,\n  install,\n  uninstall,\n  status,\n} from './launchd.js';\nimport type { PlistOptions, RunCommandFn, LaunchdStatus } from './launchd.js';\n\n// ---------- helpers ----------\n\nfunction tmpDir(): string {\n  return mkdtempSync(join(tmpdir(), `launchd-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\nfunction basePlistOpts(overrides?: Partial<PlistOptions>): PlistOptions {\n  return {\n    nodePath: '/usr/local/bin/node',\n    scriptPath: '/usr/local/lib/gsd-daemon/dist/cli.js',\n    configPath: join(homedir(), '.gsd', 'daemon.yaml'),\n    ...overrides,\n  };\n}\n\n// ---------- escapeXml ----------\n\ndescribe('escapeXml', () => {\n  it('escapes & < > \" \\'', () => {\n    assert.equal(escapeXml('a&b<c>d\"e\\'f'), 'a&amp;b&lt;c&gt;d&quot;e&apos;f');\n  });\n\n  it('leaves plain strings untouched', () => {\n    assert.equal(escapeXml('/usr/local/bin/node'), '/usr/local/bin/node');\n  });\n\n  it('escapes paths with spaces and special chars', () => {\n    const input = '/Users/John & Jane/my \"project\"/file.js';\n    const output = escapeXml(input);\n    assert.ok(output.includes('&amp;'));\n    assert.ok(output.includes('&quot;'));\n    // Verify no raw unescaped & remain (all & are part of &amp; &lt; etc.)\n    assert.equal(output, '/Users/John &amp; Jane/my &quot;project&quot;/file.js');\n  });\n});\n\n// ---------- generatePlist ----------\n\ndescribe('generatePlist', () => {\n  it('produces valid XML with plist header', () => {\n    const xml = generatePlist(basePlistOpts());\n    assert.ok(xml.startsWith('<?xml version=\"1.0\"'));\n    assert.ok(xml.includes('<!DOCTYPE plist'));\n    assert.ok(xml.includes('<plist version=\"1.0\">'));\n    assert.ok(xml.includes('</plist>'));\n  });\n\n  it('includes label com.gsd.daemon', () => {\n    const xml = generatePlist(basePlistOpts());\n    assert.ok(xml.includes('<string>com.gsd.daemon</string>'));\n  });\n\n  it('uses the absolute node path from opts', () => {\n    const opts = basePlistOpts({ nodePath: '/home/user/.nvm/versions/node/v22.0.0/bin/node' });\n    const xml = generatePlist(opts);\n    assert.ok(xml.includes('<string>/home/user/.nvm/versions/node/v22.0.0/bin/node</string>'));\n  });\n\n  it('includes NVM bin directory in PATH', () => {\n    const opts = basePlistOpts({ nodePath: '/home/user/.nvm/versions/node/v22.0.0/bin/node' });\n    const xml = generatePlist(opts);\n    assert.ok(xml.includes('/home/user/.nvm/versions/node/v22.0.0/bin'));\n  });\n\n  it('sets KeepAlive with SuccessfulExit false', () => {\n    const xml = generatePlist(basePlistOpts());\n    assert.ok(xml.includes('<key>KeepAlive</key>'));\n    assert.ok(xml.includes('<key>SuccessfulExit</key>'));\n    assert.ok(xml.includes('<false/>'));\n  });\n\n  it('sets RunAtLoad true', () => {\n    const xml = generatePlist(basePlistOpts());\n    assert.ok(xml.includes('<key>RunAtLoad</key>'));\n    assert.ok(xml.includes('<true/>'));\n  });\n\n  it('includes --config with the config path', () => {\n    const configPath = '/custom/path/daemon.yaml';\n    const xml = generatePlist(basePlistOpts({ configPath }));\n    assert.ok(xml.includes('<string>--config</string>'));\n    assert.ok(xml.includes(`<string>${configPath}</string>`));\n  });\n\n  it('includes HOME environment variable', () => {\n    const xml = generatePlist(basePlistOpts());\n    assert.ok(xml.includes('<key>HOME</key>'));\n    assert.ok(xml.includes(`<string>${homedir()}</string>`));\n  });\n\n  it('includes StandardOutPath and StandardErrorPath', () => {\n    const xml = generatePlist(basePlistOpts());\n    assert.ok(xml.includes('<key>StandardOutPath</key>'));\n    assert.ok(xml.includes('<key>StandardErrorPath</key>'));\n  });\n\n  it('escapes special characters in paths', () => {\n    const opts = basePlistOpts({\n      configPath: '/Users/John & Jane/config.yaml',\n    });\n    const xml = generatePlist(opts);\n    assert.ok(xml.includes('John &amp; Jane'));\n    assert.ok(!xml.includes('John & Jane'));\n  });\n\n  it('uses custom stdout/stderr paths when provided', () => {\n    const opts = basePlistOpts({\n      stdoutPath: '/tmp/my-stdout.log',\n      stderrPath: '/tmp/my-stderr.log',\n    });\n    const xml = generatePlist(opts);\n    assert.ok(xml.includes('<string>/tmp/my-stdout.log</string>'));\n    assert.ok(xml.includes('<string>/tmp/my-stderr.log</string>'));\n  });\n\n  it('uses custom working directory when provided', () => {\n    const opts = basePlistOpts({\n      workingDirectory: '/custom/work/dir',\n    });\n    const xml = generatePlist(opts);\n    assert.ok(xml.includes('<string>/custom/work/dir</string>'));\n  });\n});\n\n// ---------- getPlistPath ----------\n\ndescribe('getPlistPath', () => {\n  it('returns ~/Library/LaunchAgents/com.gsd.daemon.plist', () => {\n    const expected = join(homedir(), 'Library', 'LaunchAgents', 'com.gsd.daemon.plist');\n    assert.equal(getPlistPath(), expected);\n  });\n});\n\n// ---------- install ----------\n\ndescribe('install', () => {\n  let tmp: string;\n  let fakePlistPath: string;\n\n  // We can't mock getPlistPath directly, but we can verify the commands\n  // issued and the plist content by intercepting runCommand and filesystem ops.\n  // For filesystem testing, we test the functions that call writeFileSync indirectly\n  // by verifying the runCommand calls and returned values.\n\n  it('calls launchctl load with the plist path', () => {\n    const calls: string[] = [];\n    const mockRun: RunCommandFn = (cmd: string) => {\n      calls.push(cmd);\n      return '';\n    };\n\n    // install will try to write to the real plist path, so we need to be careful.\n    // We test the command flow by catching the writeFileSync error (dir may not exist in CI)\n    // or by letting it proceed in local dev.\n    try {\n      install(basePlistOpts(), mockRun);\n    } catch {\n      // writeFileSync may fail if ~/Library/LaunchAgents doesn't exist in test env\n    }\n\n    const loadCalls = calls.filter(c => c.startsWith('launchctl load'));\n    const listCalls = calls.filter(c => c.startsWith('launchctl list'));\n    // Should have at least attempted launchctl load\n    assert.ok(loadCalls.length > 0 || calls.length > 0, 'Expected launchctl commands to be called');\n  });\n\n  it('generates valid plist content when called', () => {\n    // Test that the plist content would be correct by testing generatePlist\n    // (install is a thin wrapper around generatePlist + writeFile + launchctl)\n    const xml = generatePlist(basePlistOpts());\n    assert.ok(xml.includes('<key>Label</key>'));\n    assert.ok(xml.includes('<string>com.gsd.daemon</string>'));\n  });\n\n  it('handles idempotent install (unloads first if plist exists)', () => {\n    const calls: string[] = [];\n    const mockRun: RunCommandFn = (cmd: string) => {\n      calls.push(cmd);\n      return '';\n    };\n\n    // To simulate idempotent install, we need an existing plist file.\n    // Since install writes to getPlistPath(), we test the command sequence.\n    try {\n      install(basePlistOpts(), mockRun);\n      // Second install\n      install(basePlistOpts(), mockRun);\n    } catch {\n      // filesystem may not be writable\n    }\n\n    // The second install should have tried to unload first\n    const unloadCalls = calls.filter(c => c.startsWith('launchctl unload'));\n    // If the plist path exists, we expect at least one unload attempt on second call\n    // This is a command-level check; filesystem existence depends on environment\n  });\n});\n\n// ---------- uninstall ----------\n\ndescribe('uninstall', () => {\n  it('calls launchctl unload when plist would exist', () => {\n    const calls: string[] = [];\n    const mockRun: RunCommandFn = (cmd: string) => {\n      calls.push(cmd);\n      return '';\n    };\n\n    // uninstall checks existsSync(plistPath) — if plist doesn't exist, it's a no-op\n    uninstall(mockRun);\n\n    // If plist doesn't exist in test environment, calls should be empty (graceful)\n    // That's the \"handles missing plist gracefully\" case\n  });\n\n  it('handles missing plist gracefully (no-op)', () => {\n    const calls: string[] = [];\n    const mockRun: RunCommandFn = (cmd: string) => {\n      calls.push(cmd);\n      return '';\n    };\n\n    // Shouldn't throw even if plist doesn't exist\n    assert.doesNotThrow(() => uninstall(mockRun));\n  });\n\n  it('handles already-unloaded agent gracefully', () => {\n    const mockRun: RunCommandFn = (cmd: string) => {\n      if (cmd.includes('launchctl unload')) {\n        throw new Error('Could not find specified service');\n      }\n      return '';\n    };\n\n    // Should not throw even if launchctl unload fails\n    assert.doesNotThrow(() => uninstall(mockRun));\n  });\n});\n\n// ---------- status ----------\n\ndescribe('status', () => {\n  it('parses running daemon output (PID present)', () => {\n    const mockRun: RunCommandFn = (_cmd: string) => {\n      return '{\\n\\t\"PID\" = 1234;\\n\\t\"Label\" = \"com.gsd.daemon\";\\n}\\nPID\\tStatus\\tLabel\\n1234\\t0\\tcom.gsd.daemon\\n';\n    };\n\n    const result = status(mockRun);\n    assert.equal(result.registered, true);\n    assert.equal(result.pid, 1234);\n    assert.equal(result.lastExitStatus, 0);\n  });\n\n  it('parses stopped daemon output (no PID)', () => {\n    const mockRun: RunCommandFn = (_cmd: string) => {\n      return 'PID\\tStatus\\tLabel\\n-\\t78\\tcom.gsd.daemon\\n';\n    };\n\n    const result = status(mockRun);\n    assert.equal(result.registered, true);\n    assert.equal(result.pid, null);\n    assert.equal(result.lastExitStatus, 78);\n  });\n\n  it('returns not-registered when launchctl list fails', () => {\n    const mockRun: RunCommandFn = (_cmd: string) => {\n      throw new Error('Could not find service \"com.gsd.daemon\" in domain for port');\n    };\n\n    const result = status(mockRun);\n    assert.equal(result.registered, false);\n    assert.equal(result.pid, null);\n    assert.equal(result.lastExitStatus, null);\n  });\n\n  it('returns structured result with all fields', () => {\n    const mockRun: RunCommandFn = (_cmd: string) => {\n      return 'PID\\tStatus\\tLabel\\n5678\\t0\\tcom.gsd.daemon\\n';\n    };\n\n    const result = status(mockRun);\n    assert.ok('registered' in result);\n    assert.ok('pid' in result);\n    assert.ok('lastExitStatus' in result);\n  });\n\n  it('parses JSON-style dict output (newer macOS)', () => {\n    const mockRun: RunCommandFn = (_cmd: string) => {\n      return `{\n\\t\"StandardOutPath\" = \"/Users/me/.gsd/daemon-stdout.log\";\n\\t\"LimitLoadToSessionType\" = \"Aqua\";\n\\t\"StandardErrorPath\" = \"/Users/me/.gsd/daemon-stderr.log\";\n\\t\"Label\" = \"com.gsd.daemon\";\n\\t\"OnDemand\" = true;\n\\t\"LastExitStatus\" = 0;\n\\t\"PID\" = 23802;\n\\t\"Program\" = \"/usr/local/bin/node\";\n};`;\n    };\n\n    const result = status(mockRun);\n    assert.equal(result.registered, true);\n    assert.equal(result.pid, 23802);\n    assert.equal(result.lastExitStatus, 0);\n  });\n\n  it('parses JSON-style dict output when daemon stopped (no PID key)', () => {\n    const mockRun: RunCommandFn = (_cmd: string) => {\n      return `{\n\\t\"Label\" = \"com.gsd.daemon\";\n\\t\"LastExitStatus\" = 1;\n\\t\"OnDemand\" = true;\n};`;\n    };\n\n    const result = status(mockRun);\n    assert.equal(result.registered, true);\n    assert.equal(result.pid, null);\n    assert.equal(result.lastExitStatus, 1);\n  });\n\n  it('handles unexpected output format gracefully', () => {\n    const mockRun: RunCommandFn = (_cmd: string) => {\n      return 'some unexpected output without the label';\n    };\n\n    // Should not throw — should return registered:true but with null fields\n    // since the command succeeded (label was found) but output didn't match\n    const result = status(mockRun);\n    assert.equal(result.registered, true);\n  });\n});\n"]}

package/packages/daemon/dist/local-tool-executor.d.ts

@@ -0,0 +1,22 @@
+import type { SessionManager } from "./session-manager.js";
+import type { ProjectInfo } from "./types.js";
+export declare class LocalToolExecutor {
+    private readonly sessionManager;
+    private readonly scanProjects;
+    private readonly workflowHandlers;
+    constructor(sessionManager: SessionManager, scanProjects: () => Promise<ProjectInfo[]>);
+    execute(toolName: string, rawArgs: Record<string, unknown>, projectAlias?: string): Promise<unknown>;
+    advertisedProjects(): Promise<Array<{
+        alias: string;
+        path: string;
+        repoIdentity: string;
+        remoteLabel?: string;
+        markers: string[];
+    }>>;
+    private requiredProjectDir;
+    private resolveProjectPath;
+    private executeWorkflowTool;
+    private invokeRegisteredWorkflowTool;
+    private executeGraph;
+}
+//# sourceMappingURL=local-tool-executor.d.ts.map

package/packages/daemon/dist/local-tool-executor.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"local-tool-executor.d.ts","sourceRoot":"","sources":["../src/local-tool-executor.ts"],"names":[],"mappings":"AAqBA,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,sBAAsB,CAAC;AAC3D,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,YAAY,CAAC;AAgB9C,qBAAa,iBAAiB;IAI1B,OAAO,CAAC,QAAQ,CAAC,cAAc;IAC/B,OAAO,CAAC,QAAQ,CAAC,YAAY;IAJ/B,OAAO,CAAC,QAAQ,CAAC,gBAAgB,CAAkC;gBAGhD,cAAc,EAAE,cAAc,EAC9B,YAAY,EAAE,MAAM,OAAO,CAAC,WAAW,EAAE,CAAC;IAUvD,OAAO,CAAC,QAAQ,EAAE,MAAM,EAAE,OAAO,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,EAAE,YAAY,CAAC,EAAE,MAAM,GAAG,OAAO,CAAC,OAAO,CAAC;IAiFpG,kBAAkB,IAAI,OAAO,CAAC,KAAK,CAAC;QACxC,KAAK,EAAE,MAAM,CAAC;QACd,IAAI,EAAE,MAAM,CAAC;QACb,YAAY,EAAE,MAAM,CAAC;QACrB,WAAW,CAAC,EAAE,MAAM,CAAC;QACrB,OAAO,EAAE,MAAM,EAAE,CAAC;KACnB,CAAC,CAAC;YAcW,kBAAkB;YAMlB,kBAAkB;IAOhC,OAAO,CAAC,mBAAmB;IAmD3B,OAAO,CAAC,4BAA4B;YAMtB,YAAY;CAgC3B"}