jobarbiter 0.3.13 → 0.4.0

package/dist/index.js

@@ -6,6 +6,11 @@ import { output, outputList, success, error, setJsonMode } from "./lib/output.js
 import { runOnboardWizard } from "./lib/onboard.js";
 import { detectAgents, installObservers, removeObservers, getObservationStatus } from "./lib/observe.js";
 import { runAutoPipeline, analyzeFile, analyzeRecent } from "./lib/analysis-pipeline.js";
+import { pollAllSources } from "./lib/transcript-poller.js";
+import { pauseObservation, resumeObservation, isPaused, getPauseStatus } from "./lib/privacy-pause.js";
+import { loadPollState, savePollState, setDisabledSource, removeDisabledSource } from "./lib/poll-state.js";
+import { installDaemon, uninstallDaemon, getDaemonStatus } from "./lib/launchd.js";
+import { uninstallAll } from "./lib/uninstall.js";
 import { readFileSync } from "node:fs";
 import { join, dirname } from "node:path";
 import { fileURLToPath } from "node:url";
@@ -760,14 +765,40 @@ program
 const observe = program.command("observe").description("Manage AI tool proficiency observers");
 observe
     .command("status")
-    .description("Show observer status and accumulated data")
+    .description("Show observer status, pause state, daemon, and accumulated data")
     .action(async () => {
     try {
         const agents = detectAgents();
         const status = getObservationStatus();
-        const detected = agents.filter((a) => a.installed);
+        const pauseStatus = getPauseStatus();
+        const daemonStatus = getDaemonStatus();
+        const pollState = loadPollState();
         console.log("\n🔍 AI Agent Observers\n");
-        console.log("  Agents:");
+        // Pause state
+        if (pauseStatus.paused) {
+            console.log(`  ⏸️  Status: ${pauseStatus.expiresAt
+                ? `PAUSED (auto-resumes ${new Date(pauseStatus.expiresAt).toLocaleString()})`
+                : "PAUSED (indefinite)"}`);
+            console.log(`     Since: ${pauseStatus.pausedAt ? new Date(pauseStatus.pausedAt).toLocaleString() : "unknown"}`);
+        }
+        else {
+            console.log("  ▶️  Status: ACTIVE");
+        }
+        // Daemon state
+        console.log(`\n  Poller Daemon:`);
+        if (daemonStatus.installed) {
+            console.log(`    ${daemonStatus.loaded ? "✅" : "⚠️"}  ${daemonStatus.loaded ? "Running" : "Installed but not loaded"}`);
+            if (daemonStatus.interval) {
+                const hours = Math.floor(daemonStatus.interval / 3600);
+                const mins = Math.floor((daemonStatus.interval % 3600) / 60);
+                console.log(`    Interval: ${hours > 0 ? `${hours}h` : ""}${mins > 0 ? `${mins}m` : ""}`);
+            }
+        }
+        else {
+            console.log("    ⬚ Not installed (run: jobarbiter observe daemon install)");
+        }
+        // Agents
+        console.log("\n  Agents:");
         for (const agent of agents) {
             if (!agent.installed) {
                 console.log(`    ⬚ ${agent.name}  (not installed)`);
@@ -779,6 +810,18 @@ observe
                 console.log(`    ⚠️  ${agent.name}  (detected, no observer)`);
             }
         }
+        // Per-source poll stats
+        const pollEntries = Object.entries(pollState.lastPoll);
+        if (pollEntries.length > 0) {
+            console.log("\n  Last Poll Per Source:");
+            for (const [source, time] of pollEntries) {
+                console.log(`    ${source}: ${new Date(time).toLocaleString()}`);
+            }
+        }
+        // Disabled sources
+        if (pollState.disabledSources.length > 0) {
+            console.log(`\n  Disabled Sources: ${pollState.disabledSources.join(", ")}`);
+        }
         console.log("\n  Accumulated Data:");
         console.log(`    Sessions observed: ${status.totalSessions}`);
         console.log(`    Total tokens:      ${status.totalTokens.toLocaleString()}`);
@@ -790,8 +833,23 @@ observe
                 console.log(`    ${tool}: ${count} uses`);
             }
         }
+        // Pause history (last 5)
+        if (pauseStatus.pauseWindows.length > 0) {
+            console.log("\n  Pause History (last 5):");
+            const recent = pauseStatus.pauseWindows.slice(-5);
+            for (const w of recent) {
+                const start = new Date(w.start).toLocaleString();
+                const end = new Date(w.end).toLocaleString();
+                console.log(`    ${start} → ${end}`);
+            }
+        }
         console.log(`\n  Data file: ~/.config/jobarbiter/observer/observations.json\n`);
         output({
+            paused: pauseStatus.paused,
+            pausedAt: pauseStatus.pausedAt,
+            expiresAt: pauseStatus.expiresAt,
+            daemon: daemonStatus,
+            disabledSources: pollState.disabledSources,
             detectedAgents: agents.map((a) => ({
                 id: a.id,
                 name: a.name,
@@ -799,6 +857,7 @@ observe
                 observerActive: a.hookInstalled,
             })),
             ...status,
+            pauseWindows: pauseStatus.pauseWindows,
         });
     }
     catch (e) {
@@ -914,6 +973,270 @@ observe
         handleError(e);
     }
 });
+// ── observe poll ────────────────────────────────────────────────────────
+observe
+    .command("poll")
+    .description("One-shot poll for new transcripts from all sources")
+    .option("--source <id>", "Poll a specific source only")
+    .option("--dry-run", "Show what would be processed without writing")
+    .option("--since <date>", "Only process transcripts since this date (ISO 8601)")
+    .option("--verbose", "Show detailed output")
+    .action(async (opts) => {
+    try {
+        const since = opts.since ? new Date(opts.since) : undefined;
+        const result = await pollAllSources({
+            source: opts.source,
+            dryRun: opts.dryRun,
+            since,
+            verbose: opts.verbose,
+        });
+        if (!opts.verbose) {
+            if (result.newSessions > 0) {
+                success(`Found ${result.newSessions} new session(s) from ${result.sourcesPolled.length} source(s)`);
+            }
+            else {
+                console.log(`No new sessions found (polled ${result.sourcesPolled.length} sources)`);
+            }
+            if (result.skippedDuplicate > 0) {
+                console.log(`  Skipped ${result.skippedDuplicate} duplicate(s)`);
+            }
+            if (result.skippedPaused > 0) {
+                console.log(`  Skipped ${result.skippedPaused} from pause window(s)`);
+            }
+        }
+        if (result.errors.length > 0) {
+            for (const e of result.errors) {
+                console.log(`  ⚠️  ${e}`);
+            }
+        }
+        output(result);
+    }
+    catch (e) {
+        handleError(e);
+    }
+});
+// ── observe pause/resume ───────────────────────────────────────────────
+observe
+    .command("pause")
+    .description("Pause all observation (hooks + poller)")
+    .option("--for <duration>", "Auto-resume after duration (e.g. 2h, 30m, 1d)")
+    .action(async (opts) => {
+    try {
+        let expiresAt;
+        if (opts.for) {
+            const seconds = parseDuration(opts.for);
+            if (seconds <= 0) {
+                error("Invalid duration. Use format like '2h', '30m', '1d'");
+                process.exit(1);
+            }
+            expiresAt = new Date(Date.now() + seconds * 1000);
+        }
+        pauseObservation(expiresAt);
+        if (expiresAt) {
+            success(`Observation paused until ${expiresAt.toLocaleString()}`);
+        }
+        else {
+            success("Observation paused indefinitely. Run 'jobarbiter observe resume' to resume.");
+        }
+        output({ paused: true, expiresAt: expiresAt?.toISOString() || null });
+    }
+    catch (e) {
+        handleError(e);
+    }
+});
+observe
+    .command("resume")
+    .description("Resume observation after a pause")
+    .action(async () => {
+    try {
+        if (!isPaused()) {
+            console.log("Observation is not paused.");
+            output({ resumed: false, reason: "not_paused" });
+            process.exit(0);
+        }
+        resumeObservation();
+        success("Observation resumed. Pause window recorded.");
+        output({ resumed: true });
+    }
+    catch (e) {
+        handleError(e);
+    }
+});
+// ── observe interval ───────────────────────────────────────────────────
+observe
+    .command("interval <duration>")
+    .description("Change poll frequency (e.g. 2h, 30m, 1d)")
+    .action(async (duration) => {
+    try {
+        const seconds = parseDuration(duration);
+        if (seconds <= 0) {
+            error("Invalid duration. Use format like '2h', '30m', '1d'");
+            process.exit(1);
+        }
+        const state = loadPollState();
+        state.interval = seconds;
+        savePollState(state);
+        // Reload daemon if installed
+        const daemonStatus = getDaemonStatus();
+        if (daemonStatus.installed) {
+            installDaemon(seconds);
+            success(`Poll interval set to ${duration} and daemon reloaded`);
+        }
+        else {
+            success(`Poll interval set to ${duration}`);
+        }
+        output({ interval: seconds });
+    }
+    catch (e) {
+        handleError(e);
+    }
+});
+// ── observe enable/disable ─────────────────────────────────────────────
+observe
+    .command("enable <source>")
+    .description("Re-enable a disabled observation source")
+    .action(async (source) => {
+    try {
+        removeDisabledSource(source);
+        success(`Source '${source}' enabled`);
+        output({ source, enabled: true });
+    }
+    catch (e) {
+        handleError(e);
+    }
+});
+observe
+    .command("disable <source>")
+    .description("Disable observation for a specific source")
+    .action(async (source) => {
+    try {
+        setDisabledSource(source);
+        success(`Source '${source}' disabled`);
+        output({ source, disabled: true });
+    }
+    catch (e) {
+        handleError(e);
+    }
+});
+// ── observe daemon ─────────────────────────────────────────────────────
+const daemon = observe.command("daemon").description("Manage the background polling daemon (macOS LaunchAgent)");
+daemon
+    .command("install")
+    .description("Install the background polling daemon")
+    .option("--interval <duration>", "Poll interval (e.g. 2h, 30m)", "2h")
+    .action(async (opts) => {
+    try {
+        const seconds = parseDuration(opts.interval);
+        if (seconds <= 0) {
+            error("Invalid interval. Use format like '2h', '30m', '1d'");
+            process.exit(1);
+        }
+        installDaemon(seconds);
+        success(`Polling daemon installed (interval: ${opts.interval})`);
+        console.log("  The daemon will poll for new transcripts in the background.");
+        console.log("  Log: ~/.config/jobarbiter/observer/poll.log");
+        output({ installed: true, interval: seconds });
+    }
+    catch (e) {
+        handleError(e);
+    }
+});
+daemon
+    .command("uninstall")
+    .description("Remove the background polling daemon")
+    .action(async () => {
+    try {
+        uninstallDaemon();
+        success("Polling daemon uninstalled");
+        output({ uninstalled: true });
+    }
+    catch (e) {
+        handleError(e);
+    }
+});
+daemon
+    .command("status")
+    .description("Show daemon status")
+    .action(async () => {
+    try {
+        const status = getDaemonStatus();
+        if (!status.installed) {
+            console.log("\nDaemon not installed. Run: jobarbiter observe daemon install\n");
+        }
+        else {
+            console.log(`\nDaemon: ${status.loaded ? "✅ Running" : "⚠️  Installed but not loaded"}`);
+            if (status.interval) {
+                const hours = Math.floor(status.interval / 3600);
+                const mins = Math.floor((status.interval % 3600) / 60);
+                console.log(`Interval: ${hours > 0 ? `${hours}h` : ""}${mins > 0 ? `${mins}m` : ""}`);
+            }
+            console.log(`Plist: ${status.plistPath}\n`);
+        }
+        output(status);
+    }
+    catch (e) {
+        handleError(e);
+    }
+});
+// ============================================================
+// uninstall (clean removal)
+// ============================================================
+program
+    .command("uninstall")
+    .description("Remove all JobArbiter components from this system")
+    .option("--keep-data", "Keep observation data")
+    .option("--keep-config", "Keep configuration files")
+    .option("--force", "Skip confirmation prompts")
+    .action(async (opts) => {
+    try {
+        if (!opts.force) {
+            console.log("\n⚠️  This will remove:");
+            console.log("  - Observer hooks from all AI tools");
+            console.log("  - Background polling daemon");
+            console.log("  - Hook scripts");
+            if (!opts.keepData)
+                console.log("  - Observation data");
+            if (!opts.keepConfig)
+                console.log("  - Configuration and API keys");
+            console.log();
+            const readline = await import("node:readline");
+            const rl = readline.createInterface({ input: process.stdin, output: process.stdout });
+            const answer = await new Promise((resolve) => {
+                rl.question("Continue? [y/N] ", (ans) => { rl.close(); resolve(ans); });
+            });
+            if (!answer.toLowerCase().startsWith("y")) {
+                console.log("Cancelled.");
+                process.exit(0);
+            }
+        }
+        const result = uninstallAll({
+            keepData: opts.keepData,
+            keepConfig: opts.keepConfig,
+            force: opts.force,
+        });
+        if (result.observersRemoved.length > 0) {
+            success(`Removed observers: ${result.observersRemoved.join(", ")}`);
+        }
+        if (result.daemonUninstalled)
+            success("Daemon uninstalled");
+        if (result.hooksDeleted)
+            success("Hook scripts deleted");
+        if (result.dataDeleted)
+            success("Observation data deleted");
+        if (result.configDeleted)
+            success("Configuration deleted");
+        for (const e of result.errors) {
+            error(e);
+        }
+        if (result.errors.length === 0) {
+            console.log("\n✅ JobArbiter fully uninstalled.\n");
+        }
+        output(result);
+    }
+    catch (e) {
+        handleError(e);
+    }
+});
 // ============================================================
 // analyze (session analysis and report submission)
 // ============================================================
@@ -1090,6 +1413,27 @@ function handleError(e) {
     }
     process.exit(1);
 }
+/**
+ * Parse duration strings like '2h', '30m', '1d' into seconds.
+ */
+function parseDuration(input) {
+    const match = input.match(/^(\d+(?:\.\d+)?)\s*(s|m|h|d|w)$/i);
+    if (!match) {
+        // Try bare number as seconds
+        const n = parseFloat(input);
+        return isNaN(n) ? 0 : n;
+    }
+    const value = parseFloat(match[1]);
+    const unit = match[2].toLowerCase();
+    switch (unit) {
+        case "s": return value;
+        case "m": return value * 60;
+        case "h": return value * 3600;
+        case "d": return value * 86400;
+        case "w": return value * 604800;
+        default: return 0;
+    }
+}
 function formatCompensation(comp) {
     if (!comp)
         return "Not listed";

package/dist/lib/detect-tools.d.ts

@@ -8,6 +8,7 @@
  * Never logs or stores API key values — only checks for existence.
  */
 export type ToolCategory = "ai-agent" | "chat" | "orchestration" | "api-provider";
+export type ObservationMethod = "hook" | "extension" | "poller" | "both" | "none";
 export interface DetectedTool {
     id: string;
     name: string;
@@ -17,6 +18,7 @@ export interface DetectedTool {
     configDir?: string;
     observerAvailable: boolean;
     observerActive: boolean;
+    observationMethod: ObservationMethod;
 }
 /**
  * Detect all AI tools on the system.

package/dist/lib/detect-tools.js

@@ -21,6 +21,7 @@ const TOOL_DEFINITIONS = [
         binary: "claude",
         configDir: join(homedir(), ".claude"),
         observerAvailable: true,
+        observationMethod: "hook",
     },
     {
         id: "cursor",
@@ -30,6 +31,7 @@ const TOOL_DEFINITIONS = [
         configDir: join(homedir(), ".cursor"),
         macApp: "/Applications/Cursor.app",
         observerAvailable: true,
+        observationMethod: "hook",
     },
     {
         id: "github-copilot",
@@ -39,6 +41,7 @@ const TOOL_DEFINITIONS = [
         vscodeExtension: "github.copilot",
         cursorExtension: "github.copilot",
         observerAvailable: false,
+        observationMethod: "extension",
     },
     {
         id: "codex",
@@ -47,6 +50,7 @@ const TOOL_DEFINITIONS = [
         binary: "codex",
         configDir: join(homedir(), ".codex"),
         observerAvailable: true,
+        observationMethod: "hook",
     },
     {
         id: "opencode",
@@ -55,6 +59,7 @@ const TOOL_DEFINITIONS = [
         binary: "opencode",
         configDir: join(homedir(), ".config", "opencode"),
         observerAvailable: true,
+        observationMethod: "hook",
     },
     {
         id: "aider",
@@ -64,6 +69,7 @@ const TOOL_DEFINITIONS = [
         configDir: join(homedir(), ".aider"),
         pipPackage: "aider-chat",
         observerAvailable: false,
+        observationMethod: "poller",
     },
     {
         id: "continue",
@@ -72,6 +78,7 @@ const TOOL_DEFINITIONS = [
         vscodeExtension: "continue.continue",
         cursorExtension: "continue.continue",
         observerAvailable: false,
+        observationMethod: "extension",
     },
     {
         id: "cline",
@@ -80,6 +87,7 @@ const TOOL_DEFINITIONS = [
         vscodeExtension: "saoudrizwan.claude-dev",
         cursorExtension: "saoudrizwan.claude-dev",
         observerAvailable: false,
+        observationMethod: "extension",
     },
     {
         id: "windsurf",
@@ -88,6 +96,7 @@ const TOOL_DEFINITIONS = [
         binary: "windsurf",
         macApp: "/Applications/Windsurf.app",
         observerAvailable: false,
+        observationMethod: "extension",
     },
     {
         id: "copilot-chat",
@@ -96,6 +105,7 @@ const TOOL_DEFINITIONS = [
         vscodeExtension: "github.copilot-chat",
         cursorExtension: "github.copilot-chat",
         observerAvailable: false,
+        observationMethod: "extension",
     },
     {
         id: "zed-ai",
@@ -104,6 +114,7 @@ const TOOL_DEFINITIONS = [
         macApp: "/Applications/Zed.app",
         configDir: join(homedir(), platform() === "darwin" ? "Library/Application Support/Zed" : ".config/zed"),
         observerAvailable: false,
+        observationMethod: "poller",
     },
     {
         id: "amazon-q",
@@ -112,6 +123,7 @@ const TOOL_DEFINITIONS = [
         binary: "q",
         configDir: join(homedir(), ".aws", "amazonq"),
         observerAvailable: false,
+        observationMethod: "poller",
     },
     {
         id: "warp-ai",
@@ -120,6 +132,7 @@ const TOOL_DEFINITIONS = [
         macApp: "/Applications/Warp.app",
         configDir: join(homedir(), "Library", "Application Support", "dev.warp.Warp-Stable"),
         observerAvailable: false,
+        observationMethod: "none",
     },
     {
         id: "letta",
@@ -129,6 +142,7 @@ const TOOL_DEFINITIONS = [
         configDir: join(homedir(), ".letta"),
         pipPackage: "letta",
         observerAvailable: false,
+        observationMethod: "poller",
     },
     {
         id: "goose",
@@ -137,6 +151,7 @@ const TOOL_DEFINITIONS = [
         binary: "goose",
         configDir: join(homedir(), ".config", "goose"),
         observerAvailable: false,
+        observationMethod: "poller",
     },
     {
         id: "idx",
@@ -145,6 +160,7 @@ const TOOL_DEFINITIONS = [
         // IDX is cloud-based; no local binary. Detect via config dir if any local cache exists.
         configDir: join(homedir(), ".idx"),
         observerAvailable: false,
+        observationMethod: "none",
     },
     {
         id: "gemini",
@@ -153,6 +169,7 @@ const TOOL_DEFINITIONS = [
         binary: "gemini",
         configDir: join(homedir(), ".gemini"),
         observerAvailable: true,
+        observationMethod: "hook",
     },
     // AI Chat/Desktop
     {
@@ -161,6 +178,7 @@ const TOOL_DEFINITIONS = [
         category: "chat",
         macApp: "/Applications/ChatGPT.app",
         observerAvailable: false,
+        observationMethod: "none",
     },
     {
         id: "claude-desktop",
@@ -168,6 +186,7 @@ const TOOL_DEFINITIONS = [
         category: "chat",
         macApp: "/Applications/Claude.app",
         observerAvailable: false,
+        observationMethod: "none",
     },
     {
         id: "ollama",
@@ -176,6 +195,7 @@ const TOOL_DEFINITIONS = [
         binary: "ollama",
         configDir: join(homedir(), ".ollama"),
         observerAvailable: false,
+        observationMethod: "none",
     },
     // AI Orchestration
     {
@@ -185,6 +205,7 @@ const TOOL_DEFINITIONS = [
         binary: "openclaw",
         configDir: join(homedir(), ".openclaw"),
         observerAvailable: false,
+        observationMethod: "none",
     },
     {
         id: "langchain",
@@ -192,6 +213,7 @@ const TOOL_DEFINITIONS = [
         category: "orchestration",
         pipPackage: "langchain",
         observerAvailable: false,
+        observationMethod: "none",
     },
     {
         id: "crewai",
@@ -199,6 +221,7 @@ const TOOL_DEFINITIONS = [
         category: "orchestration",
         pipPackage: "crewai",
         observerAvailable: false,
+        observationMethod: "none",
     },
     // API Providers (detected via env vars)
     {
@@ -207,6 +230,7 @@ const TOOL_DEFINITIONS = [
         category: "api-provider",
         envVars: ["ANTHROPIC_API_KEY"],
         observerAvailable: false,
+        observationMethod: "none",
     },
     {
         id: "openai-api",
@@ -214,6 +238,7 @@ const TOOL_DEFINITIONS = [
         category: "api-provider",
         envVars: ["OPENAI_API_KEY"],
         observerAvailable: false,
+        observationMethod: "none",
     },
     {
         id: "google-api",
@@ -221,6 +246,7 @@ const TOOL_DEFINITIONS = [
         category: "api-provider",
         envVars: ["GOOGLE_API_KEY", "GEMINI_API_KEY"],
         observerAvailable: false,
+        observationMethod: "none",
     },
     {
         id: "groq-api",
@@ -228,6 +254,7 @@ const TOOL_DEFINITIONS = [
         category: "api-provider",
         envVars: ["GROQ_API_KEY"],
         observerAvailable: false,
+        observationMethod: "none",
     },
     {
         id: "mistral-api",
@@ -235,6 +262,7 @@ const TOOL_DEFINITIONS = [
         category: "api-provider",
         envVars: ["MISTRAL_API_KEY"],
         observerAvailable: false,
+        observationMethod: "none",
     },
 ];
 // ── Detection Helpers ──────────────────────────────────────────────────
@@ -481,6 +509,7 @@ export function detectAllTools() {
             configDir: installed ? configDir : undefined,
             observerAvailable: def.observerAvailable,
             observerActive,
+            observationMethod: def.observationMethod,
         });
     }
     return results;

package/dist/lib/launchd.d.ts

@@ -0,0 +1,16 @@
+/**
+ * LaunchAgent Management for macOS
+ *
+ * Manages the ai.jobarbiter.observer LaunchAgent for periodic transcript polling.
+ * Generates plist, writes to ~/Library/LaunchAgents/, manages via launchctl.
+ */
+export interface DaemonStatus {
+    installed: boolean;
+    loaded: boolean;
+    interval: number | null;
+    plistPath: string;
+}
+export declare function installDaemon(intervalSeconds?: number): void;
+export declare function uninstallDaemon(): void;
+export declare function getDaemonStatus(): DaemonStatus;
+export declare function reloadDaemon(): void;