@iflow-mcp/jkheadley-instar 0.26.2

package/dist/monitoring/probes/PlatformProbe.js

@@ -0,0 +1,222 @@
+/**
+ * Platform Probe — Tier 3 (Environment Readiness)
+ *
+ * Verifies platform-specific prerequisites are met.
+ * On macOS, tests whether tmux sessions can access TCC-protected directories
+ * (Desktop, Documents, Downloads) without triggering permission popups.
+ * Skipped entirely on non-macOS platforms.
+ */
+import os from 'node:os';
+import fs from 'node:fs';
+import path from 'node:path';
+import { execSync } from 'node:child_process';
+/**
+ * Test whether a command run inside a tmux session can access
+ * TCC-protected directories without triggering a permission popup.
+ *
+ * Strategy: pass the test command directly to `tmux new-session` so the session
+ * runs it and exits. Results are written to a temp file — no race condition
+ * from send-keys + capture-pane.
+ */
+function testTmuxFdaAccess(tmuxPath) {
+    const testSessionName = `instar-fda-probe-${process.pid}`;
+    const testDir = `${os.homedir()}/Desktop`;
+    const tmpFile = path.join(os.tmpdir(), `instar-fda-probe-${process.pid}-${Date.now()}`);
+    try {
+        // Launch a tmux session that runs the test and writes results to a temp file.
+        // The session exits automatically when the command completes.
+        execSync(`${tmuxPath} new-session -d -s ${testSessionName} -x 80 -y 24 ` +
+            `"ls ${JSON.stringify(testDir)} >${JSON.stringify(tmpFile)} 2>&1; echo EXIT_CODE:\\$? >>${JSON.stringify(tmpFile)}"`, { encoding: 'utf-8', timeout: 5000 });
+        // Poll for session exit (command finished) — up to 5 seconds
+        const deadline = Date.now() + 5000;
+        while (Date.now() < deadline) {
+            try {
+                execSync(`${tmuxPath} has-session -t ${testSessionName} 2>/dev/null`, { timeout: 1000 });
+                // Session still alive — wait a bit
+                execSync('sleep 0.2', { timeout: 1000 });
+            }
+            catch {
+                // Session gone — command finished
+                break;
+            }
+        }
+        // Kill session if it's still hanging
+        try {
+            execSync(`${tmuxPath} kill-session -t ${testSessionName} 2>/dev/null`, { timeout: 3000 });
+        }
+        catch { /* ok */ }
+        // Read results
+        if (!fs.existsSync(tmpFile)) {
+            return { hasAccess: true, error: 'Probe temp file was not created — tmux session may have failed to start' };
+        }
+        const output = fs.readFileSync(tmpFile, 'utf-8');
+        // Clean up temp file
+        try {
+            fs.unlinkSync(tmpFile);
+        }
+        catch { /* ok */ }
+        // Parse exit code from output
+        const exitMatch = output.match(/EXIT_CODE:(\d+)/);
+        if (!exitMatch) {
+            return { hasAccess: true, error: 'Could not parse exit code from tmux probe output' };
+        }
+        const exitCode = parseInt(exitMatch[1], 10);
+        if (exitCode === 0) {
+            return { hasAccess: true };
+        }
+        // Check if it's specifically a TCC denial
+        if (output.includes('Operation not permitted')) {
+            return { hasAccess: false, detail: 'TCC denied: Operation not permitted' };
+        }
+        return { hasAccess: false, detail: `ls exited with code ${exitCode}: ${output.split('\n')[0]}` };
+    }
+    catch (err) {
+        // Clean up on any error
+        try {
+            execSync(`${tmuxPath} kill-session -t ${testSessionName} 2>/dev/null`, { timeout: 3000 });
+        }
+        catch { /* ok */ }
+        try {
+            fs.unlinkSync(tmpFile);
+        }
+        catch { /* ok */ }
+        return { hasAccess: true, error: `Probe failed: ${err instanceof Error ? err.message : String(err)}` };
+    }
+}
+/**
+ * Test FDA by running `ls ~/Desktop` directly (no tmux).
+ * This tests whether the current process tree has FDA.
+ */
+function testDirectFdaAccess() {
+    const testDir = `${os.homedir()}/Desktop`;
+    try {
+        execSync(`ls "${testDir}" > /dev/null 2>&1`, { timeout: 3000 });
+        return { hasAccess: true };
+    }
+    catch {
+        return { hasAccess: false };
+    }
+}
+export function createPlatformProbes(deps) {
+    const isMacOS = os.platform() === 'darwin';
+    if (!isMacOS) {
+        return [];
+    }
+    const tier = 3;
+    const feature = 'Platform Readiness';
+    const timeoutMs = 15000; // tmux session creation can be slow
+    const prerequisites = () => true;
+    const settingsUrl = 'x-apple.systempreferences:com.apple.preference.security?Privacy_AllFiles';
+    return [
+        {
+            id: 'instar.platform.tmux-fda',
+            name: 'tmux Full Disk Access',
+            tier,
+            feature,
+            timeoutMs,
+            prerequisites,
+            async run() {
+                const base = { probeId: this.id, name: this.name, tier, durationMs: 0 };
+                const start = Date.now();
+                try {
+                    const { hasAccess, error: testError, detail } = testTmuxFdaAccess(deps.tmuxPath);
+                    if (testError) {
+                        return {
+                            ...base,
+                            durationMs: Date.now() - start,
+                            passed: true, // Don't fail on probe infrastructure issues
+                            description: `Could not verify tmux FDA: ${testError}`,
+                            diagnostics: { tmuxPath: deps.tmuxPath, error: testError },
+                        };
+                    }
+                    if (!hasAccess) {
+                        return {
+                            ...base,
+                            durationMs: Date.now() - start,
+                            passed: false,
+                            description: 'tmux sessions cannot access protected directories — macOS will show recurring permission popups',
+                            error: detail ?? 'tmux session could not read ~/Desktop (TCC denied)',
+                            diagnostics: { tmuxPath: deps.tmuxPath },
+                            remediation: [
+                                'Open System Settings → Privacy & Security → Full Disk Access',
+                                'Add your terminal app (iTerm2, Terminal.app, Ghostty, etc.)',
+                                'And/or add /bin/zsh (or your shell)',
+                                `Tip: run \`open "${settingsUrl}"\` to jump to the right settings pane`,
+                                'This is a one-time setup that persists across reboots',
+                                'Note: After a macOS major update, you may need to re-grant this',
+                            ],
+                        };
+                    }
+                    return {
+                        ...base,
+                        durationMs: Date.now() - start,
+                        passed: true,
+                        description: 'tmux sessions can access protected directories',
+                        diagnostics: { tmuxPath: deps.tmuxPath },
+                    };
+                }
+                catch (err) {
+                    return {
+                        ...base,
+                        durationMs: Date.now() - start,
+                        passed: true,
+                        description: 'Could not verify tmux FDA status',
+                        error: err instanceof Error ? err.message : String(err),
+                        stack: err instanceof Error ? err.stack : undefined,
+                    };
+                }
+            },
+        },
+        {
+            id: 'instar.platform.shell-fda',
+            name: 'Shell Full Disk Access',
+            tier,
+            feature,
+            timeoutMs: 5000,
+            prerequisites,
+            async run() {
+                const base = { probeId: this.id, name: this.name, tier, durationMs: 0 };
+                const start = Date.now();
+                try {
+                    const { hasAccess } = testDirectFdaAccess();
+                    const shell = process.env.SHELL || '/bin/zsh';
+                    if (!hasAccess) {
+                        return {
+                            ...base,
+                            durationMs: Date.now() - start,
+                            passed: false,
+                            description: 'Current process cannot access protected directories — agent sessions will trigger macOS permission popups',
+                            error: `Process (shell: ${shell}) could not read ~/Desktop (TCC denied)`,
+                            diagnostics: { shell, pid: process.pid },
+                            remediation: [
+                                'Open System Settings → Privacy & Security → Full Disk Access',
+                                `Add your shell: ${shell}`,
+                                'Or add your terminal app (iTerm2, Terminal.app, Ghostty, etc.)',
+                                `Tip: run \`open "${settingsUrl}"\` to jump to the right settings pane`,
+                                'This is a one-time setup that persists across reboots',
+                            ],
+                        };
+                    }
+                    return {
+                        ...base,
+                        durationMs: Date.now() - start,
+                        passed: true,
+                        description: `Shell process has access to protected directories`,
+                        diagnostics: { shell, pid: process.pid },
+                    };
+                }
+                catch (err) {
+                    return {
+                        ...base,
+                        durationMs: Date.now() - start,
+                        passed: true,
+                        description: 'Could not verify shell FDA status',
+                        error: err instanceof Error ? err.message : String(err),
+                        stack: err instanceof Error ? err.stack : undefined,
+                    };
+                }
+            },
+        },
+    ];
+}
+//# sourceMappingURL=PlatformProbe.js.map

package/dist/monitoring/probes/PlatformProbe.js.map

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

package/dist/monitoring/probes/SchedulerProbe.d.ts

@@ -0,0 +1,33 @@
+/**
+ * Scheduler Probe — Tier 1 (Core Survival)
+ *
+ * Verifies the job scheduler is correctly loading, scheduling, and tracking jobs.
+ * Does NOT execute jobs.
+ */
+import type { Probe } from '../SystemReviewer.js';
+export interface SchedulerProbeDeps {
+    /** Get loaded job definitions */
+    getJobs: () => Array<{
+        id: string;
+        name: string;
+        enabled?: boolean;
+    }>;
+    /** Get scheduler status */
+    getStatus: () => {
+        running: boolean;
+        paused: boolean;
+        jobCount: number;
+        enabledJobs: number;
+        queueLength: number;
+    };
+    /** Path to jobs.json for cross-reference */
+    jobsFilePath: string;
+    /** Get job execution history (recent entries) */
+    getHistory?: () => Array<{
+        jobId: string;
+        timestamp: string;
+        status: string;
+    }>;
+}
+export declare function createSchedulerProbes(deps: SchedulerProbeDeps): Probe[];
+//# sourceMappingURL=SchedulerProbe.d.ts.map

package/dist/monitoring/probes/SchedulerProbe.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"SchedulerProbe.d.ts","sourceRoot":"","sources":["../../../src/monitoring/probes/SchedulerProbe.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAGH,OAAO,KAAK,EAAE,KAAK,EAAe,MAAM,sBAAsB,CAAC;AAE/D,MAAM,WAAW,kBAAkB;IACjC,iCAAiC;IACjC,OAAO,EAAE,MAAM,KAAK,CAAC;QAAE,EAAE,EAAE,MAAM,CAAC;QAAC,IAAI,EAAE,MAAM,CAAC;QAAC,OAAO,CAAC,EAAE,OAAO,CAAA;KAAE,CAAC,CAAC;IACtE,2BAA2B;IAC3B,SAAS,EAAE,MAAM;QACf,OAAO,EAAE,OAAO,CAAC;QACjB,MAAM,EAAE,OAAO,CAAC;QAChB,QAAQ,EAAE,MAAM,CAAC;QACjB,WAAW,EAAE,MAAM,CAAC;QACpB,WAAW,EAAE,MAAM,CAAC;KACrB,CAAC;IACF,4CAA4C;IAC5C,YAAY,EAAE,MAAM,CAAC;IACrB,iDAAiD;IACjD,UAAU,CAAC,EAAE,MAAM,KAAK,CAAC;QAAE,KAAK,EAAE,MAAM,CAAC;QAAC,SAAS,EAAE,MAAM,CAAC;QAAC,MAAM,EAAE,MAAM,CAAA;KAAE,CAAC,CAAC;CAChF;AAED,wBAAgB,qBAAqB,CAAC,IAAI,EAAE,kBAAkB,GAAG,KAAK,EAAE,CAoMvE"}

package/dist/monitoring/probes/SchedulerProbe.js

@@ -0,0 +1,196 @@
+/**
+ * Scheduler Probe — Tier 1 (Core Survival)
+ *
+ * Verifies the job scheduler is correctly loading, scheduling, and tracking jobs.
+ * Does NOT execute jobs.
+ */
+import fs from 'node:fs';
+export function createSchedulerProbes(deps) {
+    const tier = 1;
+    const feature = 'Job Scheduler';
+    const timeoutMs = 5000;
+    const prerequisites = () => {
+        // Scheduler may not be enabled in all setups
+        try {
+            deps.getStatus();
+            return true;
+        }
+        catch { // @silent-fallback-ok — prerequisites return false to skip probe, not a degradation
+            return false;
+        }
+    };
+    return [
+        {
+            id: 'instar.scheduler.loaded',
+            name: 'Scheduler Jobs Loaded',
+            tier,
+            feature,
+            timeoutMs,
+            prerequisites,
+            async run() {
+                const base = { probeId: this.id, name: this.name, tier, durationMs: 0 };
+                try {
+                    const jobs = deps.getJobs();
+                    if (!Array.isArray(jobs)) {
+                        return {
+                            ...base,
+                            passed: false,
+                            description: 'getJobs() returned non-array',
+                            error: `Expected array, got ${typeof jobs}`,
+                            remediation: ['Check JobScheduler initialization'],
+                        };
+                    }
+                    // Cross-reference with jobs.json if it exists
+                    let fileJobCount = null;
+                    try {
+                        if (fs.existsSync(deps.jobsFilePath)) {
+                            const content = fs.readFileSync(deps.jobsFilePath, 'utf-8');
+                            const parsed = JSON.parse(content);
+                            fileJobCount = Array.isArray(parsed) ? parsed.length
+                                : Array.isArray(parsed.jobs) ? parsed.jobs.length
+                                    : null;
+                        }
+                    }
+                    catch {
+                        // jobs.json may not be valid JSON — that's a signal worth reporting
+                    }
+                    const mismatch = fileJobCount !== null && fileJobCount !== jobs.length;
+                    if (mismatch) {
+                        return {
+                            ...base,
+                            passed: false,
+                            description: `Job count mismatch: scheduler has ${jobs.length}, jobs.json has ${fileJobCount}`,
+                            expected: `${fileJobCount} jobs (from jobs.json)`,
+                            actual: `${jobs.length} jobs loaded in scheduler`,
+                            diagnostics: { schedulerCount: jobs.length, fileCount: fileJobCount },
+                            remediation: [
+                                'jobs.json may have been edited while the scheduler was running',
+                                'Restart the server to reload job definitions',
+                            ],
+                        };
+                    }
+                    return {
+                        ...base,
+                        passed: true,
+                        description: `${jobs.length} job(s) loaded${fileJobCount !== null ? ' (matches jobs.json)' : ''}`,
+                        diagnostics: { count: jobs.length },
+                    };
+                }
+                catch (err) {
+                    return {
+                        ...base,
+                        passed: false,
+                        description: 'Failed to get job definitions',
+                        error: err instanceof Error ? err.message : String(err),
+                        stack: err instanceof Error ? err.stack : undefined,
+                        remediation: ['Check JobScheduler initialization and jobs.json format'],
+                    };
+                }
+            },
+        },
+        {
+            id: 'instar.scheduler.running',
+            name: 'Scheduler Running',
+            tier,
+            feature,
+            timeoutMs,
+            prerequisites,
+            async run() {
+                const base = { probeId: this.id, name: this.name, tier, durationMs: 0 };
+                try {
+                    const status = deps.getStatus();
+                    if (!status.running) {
+                        return {
+                            ...base,
+                            passed: false,
+                            description: 'Scheduler is not running',
+                            error: 'Scheduler stopped — jobs are not being executed',
+                            diagnostics: { status },
+                            remediation: [
+                                'Scheduler may have hit an unhandled exception',
+                                'Check server logs for scheduler errors',
+                                'Restart the server',
+                            ],
+                        };
+                    }
+                    if (status.paused) {
+                        return {
+                            ...base,
+                            passed: false,
+                            description: 'Scheduler is paused',
+                            error: 'Scheduler is running but paused — jobs are queued but not executing',
+                            diagnostics: { status },
+                            remediation: [
+                                'This may be intentional (e.g., during maintenance)',
+                                'Unpause via API: POST /scheduler/resume',
+                            ],
+                        };
+                    }
+                    return {
+                        ...base,
+                        passed: true,
+                        description: `Scheduler running: ${status.enabledJobs} enabled jobs, ${status.queueLength} queued`,
+                        diagnostics: { status },
+                    };
+                }
+                catch (err) {
+                    return {
+                        ...base,
+                        passed: false,
+                        description: 'Failed to get scheduler status',
+                        error: err instanceof Error ? err.message : String(err),
+                        stack: err instanceof Error ? err.stack : undefined,
+                        remediation: ['Check JobScheduler — may not be properly initialized'],
+                    };
+                }
+            },
+        },
+        {
+            id: 'instar.scheduler.queue',
+            name: 'Scheduler Queue Health',
+            tier,
+            feature,
+            timeoutMs,
+            prerequisites,
+            async run() {
+                const base = { probeId: this.id, name: this.name, tier, durationMs: 0 };
+                try {
+                    const status = deps.getStatus();
+                    // A very large queue suggests jobs are backing up
+                    const queueThreshold = 20;
+                    if (status.queueLength > queueThreshold) {
+                        return {
+                            ...base,
+                            passed: false,
+                            description: `Queue backlog: ${status.queueLength} jobs queued`,
+                            error: `Queue has ${status.queueLength} items (threshold: ${queueThreshold})`,
+                            diagnostics: { queueLength: status.queueLength, threshold: queueThreshold },
+                            remediation: [
+                                'Jobs may be queuing faster than they can execute',
+                                'Check if sessions are at capacity (job execution requires sessions)',
+                                'Consider increasing maxSessions or reducing job frequency',
+                            ],
+                        };
+                    }
+                    return {
+                        ...base,
+                        passed: true,
+                        description: `Queue healthy: ${status.queueLength} pending`,
+                        diagnostics: { queueLength: status.queueLength },
+                    };
+                }
+                catch (err) {
+                    return {
+                        ...base,
+                        passed: false,
+                        description: 'Failed to check scheduler queue',
+                        error: err instanceof Error ? err.message : String(err),
+                        stack: err instanceof Error ? err.stack : undefined,
+                        remediation: ['Check JobScheduler queue state'],
+                    };
+                }
+            },
+        },
+    ];
+}
+//# sourceMappingURL=SchedulerProbe.js.map

package/dist/monitoring/probes/SchedulerProbe.js.map

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

package/dist/monitoring/probes/SessionProbe.d.ts

@@ -0,0 +1,28 @@
+/**
+ * Session Probe — Tier 1 (Core Survival)
+ *
+ * Verifies the session management system can track, query, and report on sessions.
+ * Does NOT spawn sessions (expensive, uses quota).
+ */
+import type { Probe } from '../SystemReviewer.js';
+export interface SessionProbeDeps {
+    /** List running sessions */
+    listRunningSessions: () => Array<{
+        id: string;
+        tmuxSession: string;
+        name: string;
+    }>;
+    /** Get session diagnostics */
+    getSessionDiagnostics: () => {
+        sessions: Array<{
+            name: string;
+            ageMinutes: number;
+        }>;
+    };
+    /** Max sessions config */
+    maxSessions: number;
+    /** tmux binary path */
+    tmuxPath: string;
+}
+export declare function createSessionProbes(deps: SessionProbeDeps): Probe[];
+//# sourceMappingURL=SessionProbe.d.ts.map

package/dist/monitoring/probes/SessionProbe.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"SessionProbe.d.ts","sourceRoot":"","sources":["../../../src/monitoring/probes/SessionProbe.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAGH,OAAO,KAAK,EAAE,KAAK,EAAe,MAAM,sBAAsB,CAAC;AAE/D,MAAM,WAAW,gBAAgB;IAC/B,4BAA4B;IAC5B,mBAAmB,EAAE,MAAM,KAAK,CAAC;QAAE,EAAE,EAAE,MAAM,CAAC;QAAC,WAAW,EAAE,MAAM,CAAC;QAAC,IAAI,EAAE,MAAM,CAAA;KAAE,CAAC,CAAC;IACpF,8BAA8B;IAC9B,qBAAqB,EAAE,MAAM;QAAE,QAAQ,EAAE,KAAK,CAAC;YAAE,IAAI,EAAE,MAAM,CAAC;YAAC,UAAU,EAAE,MAAM,CAAA;SAAE,CAAC,CAAA;KAAE,CAAC;IACvF,0BAA0B;IAC1B,WAAW,EAAE,MAAM,CAAC;IACpB,uBAAuB;IACvB,QAAQ,EAAE,MAAM,CAAC;CAClB;AAED,wBAAgB,mBAAmB,CAAC,IAAI,EAAE,gBAAgB,GAAG,KAAK,EAAE,CAsOnE"}