jobarbiter 0.3.13 → 0.4.1

package/src/lib/detect-tools.ts

@@ -17,6 +17,8 @@ import { execSync } from "node:child_process";
 
 export type ToolCategory = "ai-agent" | "chat" | "orchestration" | "api-provider";
 
+export type ObservationMethod = "hook" | "extension" | "poller" | "both" | "none";
+
 export interface DetectedTool {
 	id: string;
 	name: string;
@@ -26,6 +28,7 @@ export interface DetectedTool {
 	configDir?: string;
 	observerAvailable: boolean;
 	observerActive: boolean;
+	observationMethod: ObservationMethod;
 }
 
 interface ToolDefinition {
@@ -41,6 +44,7 @@ interface ToolDefinition {
 	npmPackage?: string;
 	envVars?: string[];
 	observerAvailable: boolean;
+	observationMethod: ObservationMethod;
 }
 
 // ── Tool Definitions ───────────────────────────────────────────────────
@@ -54,6 +58,7 @@ const TOOL_DEFINITIONS: ToolDefinition[] = [
 		binary: "claude",
 		configDir: join(homedir(), ".claude"),
 		observerAvailable: true,
+		observationMethod: "hook",
 	},
 	{
 		id: "cursor",
@@ -63,6 +68,7 @@ const TOOL_DEFINITIONS: ToolDefinition[] = [
 		configDir: join(homedir(), ".cursor"),
 		macApp: "/Applications/Cursor.app",
 		observerAvailable: true,
+		observationMethod: "hook",
 	},
 	{
 		id: "github-copilot",
@@ -72,6 +78,7 @@ const TOOL_DEFINITIONS: ToolDefinition[] = [
 		vscodeExtension: "github.copilot",
 		cursorExtension: "github.copilot",
 		observerAvailable: false,
+		observationMethod: "extension",
 	},
 	{
 		id: "codex",
@@ -80,6 +87,7 @@ const TOOL_DEFINITIONS: ToolDefinition[] = [
 		binary: "codex",
 		configDir: join(homedir(), ".codex"),
 		observerAvailable: true,
+		observationMethod: "hook",
 	},
 	{
 		id: "opencode",
@@ -88,6 +96,7 @@ const TOOL_DEFINITIONS: ToolDefinition[] = [
 		binary: "opencode",
 		configDir: join(homedir(), ".config", "opencode"),
 		observerAvailable: true,
+		observationMethod: "hook",
 	},
 	{
 		id: "aider",
@@ -97,6 +106,7 @@ const TOOL_DEFINITIONS: ToolDefinition[] = [
 		configDir: join(homedir(), ".aider"),
 		pipPackage: "aider-chat",
 		observerAvailable: false,
+		observationMethod: "poller",
 	},
 	{
 		id: "continue",
@@ -105,6 +115,7 @@ const TOOL_DEFINITIONS: ToolDefinition[] = [
 		vscodeExtension: "continue.continue",
 		cursorExtension: "continue.continue",
 		observerAvailable: false,
+		observationMethod: "extension",
 	},
 	{
 		id: "cline",
@@ -113,6 +124,7 @@ const TOOL_DEFINITIONS: ToolDefinition[] = [
 		vscodeExtension: "saoudrizwan.claude-dev",
 		cursorExtension: "saoudrizwan.claude-dev",
 		observerAvailable: false,
+		observationMethod: "extension",
 	},
 	{
 		id: "windsurf",
@@ -121,6 +133,7 @@ const TOOL_DEFINITIONS: ToolDefinition[] = [
 		binary: "windsurf",
 		macApp: "/Applications/Windsurf.app",
 		observerAvailable: false,
+		observationMethod: "extension",
 	},
 	{
 		id: "copilot-chat",
@@ -129,6 +142,7 @@ const TOOL_DEFINITIONS: ToolDefinition[] = [
 		vscodeExtension: "github.copilot-chat",
 		cursorExtension: "github.copilot-chat",
 		observerAvailable: false,
+		observationMethod: "extension",
 	},
 	{
 		id: "zed-ai",
@@ -137,6 +151,7 @@ const TOOL_DEFINITIONS: ToolDefinition[] = [
 		macApp: "/Applications/Zed.app",
 		configDir: join(homedir(), platform() === "darwin" ? "Library/Application Support/Zed" : ".config/zed"),
 		observerAvailable: false,
+		observationMethod: "poller",
 	},
 	{
 		id: "amazon-q",
@@ -145,6 +160,7 @@ const TOOL_DEFINITIONS: ToolDefinition[] = [
 		binary: "q",
 		configDir: join(homedir(), ".aws", "amazonq"),
 		observerAvailable: false,
+		observationMethod: "poller",
 	},
 	{
 		id: "warp-ai",
@@ -153,6 +169,7 @@ const TOOL_DEFINITIONS: ToolDefinition[] = [
 		macApp: "/Applications/Warp.app",
 		configDir: join(homedir(), "Library", "Application Support", "dev.warp.Warp-Stable"),
 		observerAvailable: false,
+		observationMethod: "none",
 	},
 	{
 		id: "letta",
@@ -162,6 +179,7 @@ const TOOL_DEFINITIONS: ToolDefinition[] = [
 		configDir: join(homedir(), ".letta"),
 		pipPackage: "letta",
 		observerAvailable: false,
+		observationMethod: "poller",
 	},
 	{
 		id: "goose",
@@ -170,6 +188,7 @@ const TOOL_DEFINITIONS: ToolDefinition[] = [
 		binary: "goose",
 		configDir: join(homedir(), ".config", "goose"),
 		observerAvailable: false,
+		observationMethod: "poller",
 	},
 	{
 		id: "idx",
@@ -178,6 +197,7 @@ const TOOL_DEFINITIONS: ToolDefinition[] = [
 		// 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",
@@ -186,6 +206,7 @@ const TOOL_DEFINITIONS: ToolDefinition[] = [
 		binary: "gemini",
 		configDir: join(homedir(), ".gemini"),
 		observerAvailable: true,
+		observationMethod: "hook",
 	},
 
 	// AI Chat/Desktop
@@ -195,6 +216,7 @@ const TOOL_DEFINITIONS: ToolDefinition[] = [
 		category: "chat",
 		macApp: "/Applications/ChatGPT.app",
 		observerAvailable: false,
+		observationMethod: "none",
 	},
 	{
 		id: "claude-desktop",
@@ -202,6 +224,7 @@ const TOOL_DEFINITIONS: ToolDefinition[] = [
 		category: "chat",
 		macApp: "/Applications/Claude.app",
 		observerAvailable: false,
+		observationMethod: "none",
 	},
 	{
 		id: "ollama",
@@ -210,6 +233,7 @@ const TOOL_DEFINITIONS: ToolDefinition[] = [
 		binary: "ollama",
 		configDir: join(homedir(), ".ollama"),
 		observerAvailable: false,
+		observationMethod: "none",
 	},
 
 	// AI Orchestration
@@ -220,6 +244,7 @@ const TOOL_DEFINITIONS: ToolDefinition[] = [
 		binary: "openclaw",
 		configDir: join(homedir(), ".openclaw"),
 		observerAvailable: false,
+		observationMethod: "none",
 	},
 	{
 		id: "langchain",
@@ -227,6 +252,7 @@ const TOOL_DEFINITIONS: ToolDefinition[] = [
 		category: "orchestration",
 		pipPackage: "langchain",
 		observerAvailable: false,
+		observationMethod: "none",
 	},
 	{
 		id: "crewai",
@@ -234,6 +260,7 @@ const TOOL_DEFINITIONS: ToolDefinition[] = [
 		category: "orchestration",
 		pipPackage: "crewai",
 		observerAvailable: false,
+		observationMethod: "none",
 	},
 
 	// API Providers (detected via env vars)
@@ -243,6 +270,7 @@ const TOOL_DEFINITIONS: ToolDefinition[] = [
 		category: "api-provider",
 		envVars: ["ANTHROPIC_API_KEY"],
 		observerAvailable: false,
+		observationMethod: "none",
 	},
 	{
 		id: "openai-api",
@@ -250,6 +278,7 @@ const TOOL_DEFINITIONS: ToolDefinition[] = [
 		category: "api-provider",
 		envVars: ["OPENAI_API_KEY"],
 		observerAvailable: false,
+		observationMethod: "none",
 	},
 	{
 		id: "google-api",
@@ -257,6 +286,7 @@ const TOOL_DEFINITIONS: ToolDefinition[] = [
 		category: "api-provider",
 		envVars: ["GOOGLE_API_KEY", "GEMINI_API_KEY"],
 		observerAvailable: false,
+		observationMethod: "none",
 	},
 	{
 		id: "groq-api",
@@ -264,6 +294,7 @@ const TOOL_DEFINITIONS: ToolDefinition[] = [
 		category: "api-provider",
 		envVars: ["GROQ_API_KEY"],
 		observerAvailable: false,
+		observationMethod: "none",
 	},
 	{
 		id: "mistral-api",
@@ -271,6 +302,7 @@ const TOOL_DEFINITIONS: ToolDefinition[] = [
 		category: "api-provider",
 		envVars: ["MISTRAL_API_KEY"],
 		observerAvailable: false,
+		observationMethod: "none",
 	},
 ];
 
@@ -526,6 +558,7 @@ export function detectAllTools(): DetectedTool[] {
 			configDir: installed ? configDir : undefined,
 			observerAvailable: def.observerAvailable,
 			observerActive,
+			observationMethod: def.observationMethod,
 		});
 	}
 

package/src/lib/launchd.ts

@@ -0,0 +1,193 @@
+/**
+ * LaunchAgent Management for macOS
+ *
+ * Manages the ai.jobarbiter.observer LaunchAgent for periodic transcript polling.
+ * Generates plist, writes to ~/Library/LaunchAgents/, manages via launchctl.
+ */
+
+import { existsSync, readFileSync, writeFileSync, unlinkSync, mkdirSync } from "node:fs";
+import { join } from "node:path";
+import { homedir } from "node:os";
+import { execSync } from "node:child_process";
+
+// ── Constants ──────────────────────────────────────────────────────────
+
+const LABEL = "ai.jobarbiter.observer";
+const LAUNCH_AGENTS_DIR = join(homedir(), "Library", "LaunchAgents");
+const PLIST_PATH = join(LAUNCH_AGENTS_DIR, `${LABEL}.plist`);
+const OBSERVER_DIR = join(homedir(), ".config", "jobarbiter", "observer");
+const LOG_PATH = join(OBSERVER_DIR, "poll.log");
+
+// ── Types ──────────────────────────────────────────────────────────────
+
+export interface DaemonStatus {
+	installed: boolean;
+	loaded: boolean;
+	interval: number | null;
+	plistPath: string;
+}
+
+// ── Helpers ────────────────────────────────────────────────────────────
+
+function resolveJobarbiterPath(): string {
+	// Try to find the jobarbiter binary
+	try {
+		const path = execSync("command -v jobarbiter", { encoding: "utf-8", timeout: 3000 }).trim();
+		if (path) return path;
+	} catch {
+		// Fall through
+	}
+
+	// Fallback: use process.execPath with the dist path
+	// This covers the case where jobarbiter is run via node directly
+	return process.execPath;
+}
+
+function generatePlist(intervalSeconds: number): string {
+	const binaryPath = resolveJobarbiterPath();
+
+	// If the binary is node itself, we need to figure out the script path
+	const isNodeBinary = binaryPath.includes("node") || binaryPath.includes("bun");
+	let programArgs: string;
+
+	if (isNodeBinary) {
+		// Find the actual CLI entry point
+		const cliPath = join(__dirname, "..", "index.js");
+		programArgs = `    <string>${binaryPath}</string>
+    <string>${cliPath}</string>
+    <string>observe</string>
+    <string>poll</string>`;
+	} else {
+		programArgs = `    <string>${binaryPath}</string>
+    <string>observe</string>
+    <string>poll</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>
+  <key>Label</key>
+  <string>${LABEL}</string>
+  <key>ProgramArguments</key>
+  <array>
+${programArgs}
+  </array>
+  <key>StartInterval</key>
+  <integer>${intervalSeconds}</integer>
+  <key>StandardOutPath</key>
+  <string>${LOG_PATH}</string>
+  <key>StandardErrorPath</key>
+  <string>${LOG_PATH}</string>
+  <key>EnvironmentVariables</key>
+  <dict>
+    <key>PATH</key>
+    <string>/usr/local/bin:/opt/homebrew/bin:/usr/bin:/bin</string>
+  </dict>
+  <key>RunAtLoad</key>
+  <true/>
+  <key>Nice</key>
+  <integer>10</integer>
+</dict>
+</plist>
+`;
+}
+
+function isLoaded(): boolean {
+	try {
+		const output = execSync(`launchctl list 2>/dev/null`, { encoding: "utf-8", timeout: 5000 });
+		return output.includes(LABEL);
+	} catch {
+		return false;
+	}
+}
+
+// ── Public API ─────────────────────────────────────────────────────────
+
+export function installDaemon(intervalSeconds = 7200): void {
+	mkdirSync(LAUNCH_AGENTS_DIR, { recursive: true });
+	mkdirSync(OBSERVER_DIR, { recursive: true });
+
+	// Unload existing if present
+	if (isLoaded()) {
+		try {
+			execSync(`launchctl unload "${PLIST_PATH}" 2>/dev/null`, { timeout: 5000 });
+		} catch {
+			// May not be loaded
+		}
+	}
+
+	// Write plist
+	const plist = generatePlist(intervalSeconds);
+	writeFileSync(PLIST_PATH, plist);
+
+	// Load
+	try {
+		execSync(`launchctl load "${PLIST_PATH}"`, { timeout: 5000 });
+	} catch (err) {
+		throw new Error(`Failed to load LaunchAgent: ${err instanceof Error ? err.message : String(err)}`);
+	}
+}
+
+export function uninstallDaemon(): void {
+	// Unload
+	if (isLoaded()) {
+		try {
+			execSync(`launchctl unload "${PLIST_PATH}" 2>/dev/null`, { timeout: 5000 });
+		} catch {
+			// Best effort
+		}
+	}
+
+	// Delete plist
+	if (existsSync(PLIST_PATH)) {
+		try {
+			unlinkSync(PLIST_PATH);
+		} catch {
+			// Best effort
+		}
+	}
+}
+
+export function getDaemonStatus(): DaemonStatus {
+	const installed = existsSync(PLIST_PATH);
+	const loaded = isLoaded();
+
+	let interval: number | null = null;
+	if (installed) {
+		try {
+			const content = readFileSync(PLIST_PATH, "utf-8");
+			const match = content.match(/<key>StartInterval<\/key>\s*<integer>(\d+)<\/integer>/);
+			if (match) {
+				interval = parseInt(match[1], 10);
+			}
+		} catch {
+			// Best effort
+		}
+	}
+
+	return {
+		installed,
+		loaded,
+		interval,
+		plistPath: PLIST_PATH,
+	};
+}
+
+export function reloadDaemon(): void {
+	if (!existsSync(PLIST_PATH)) {
+		throw new Error("Daemon not installed. Run 'jobarbiter observe daemon install' first.");
+	}
+
+	try {
+		execSync(`launchctl unload "${PLIST_PATH}" 2>/dev/null`, { timeout: 5000 });
+	} catch {
+		// May not be loaded
+	}
+
+	try {
+		execSync(`launchctl load "${PLIST_PATH}"`, { timeout: 5000 });
+	} catch (err) {
+		throw new Error(`Failed to reload daemon: ${err instanceof Error ? err.message : String(err)}`);
+	}
+}

package/src/lib/observe.ts

@@ -125,9 +125,29 @@ const fs = require("fs");
 const path = require("path");
 const os = require("os");
 
-const OBSERVATIONS_FILE = path.join(
-  os.homedir(), ".config", "jobarbiter", "observer", "observations.json"
-);
+const OBSERVER_DIR = path.join(os.homedir(), ".config", "jobarbiter", "observer");
+const OBSERVATIONS_FILE = path.join(OBSERVER_DIR, "observations.json");
+const PAUSED_FILE = path.join(OBSERVER_DIR, "PAUSED");
+
+// Check PAUSED sentinel FIRST — if paused, exit immediately
+try {
+  if (fs.existsSync(PAUSED_FILE)) {
+    const raw = fs.readFileSync(PAUSED_FILE, "utf-8");
+    const pauseData = JSON.parse(raw);
+    if (pauseData.expiresAt) {
+      const expiresAt = new Date(pauseData.expiresAt).getTime();
+      if (Date.now() < expiresAt) {
+        process.exit(0); // Still paused
+      }
+      // Expired — clean up and continue
+      fs.unlinkSync(PAUSED_FILE);
+    } else {
+      process.exit(0); // Paused indefinitely
+    }
+  }
+} catch {
+  // If PAUSED file is corrupted, continue
+}
 
 // Read stdin
 let input = "";
@@ -283,8 +303,14 @@ function appendObservation(obs) {
   // Fire-and-forget: trigger analysis pipeline via CLI
   // Spawns detached process so the AI tool is never blocked
   try {
-    const { spawn } = require("child_process");
-    // Try npx jobarbiter first, fall back to direct node invocation
+    const { spawn, execSync } = require("child_process");
+    // Self-healing: verify jobarbiter binary exists before spawning
+    try {
+      execSync("command -v jobarbiter", { stdio: "ignore", timeout: 3000 });
+    } catch {
+      // jobarbiter CLI not found — exit silently
+      return;
+    }
     const child = spawn("jobarbiter", ["analyze", "--auto"], {
       detached: true,
       stdio: "ignore",

package/src/lib/onboard.ts

@@ -21,6 +21,7 @@ import {
 	type DetectedTool,
 	type ToolCategory,
 } from "./detect-tools.js";
+import { installDaemon } from "./launchd.js";
 import {
 	loadProviderKeys,
 	saveProviderKey,
@@ -764,6 +765,24 @@ async function runToolDetectionStep(
 
 			if (result.installed.length > 0) {
 				console.log(`\n  ${sym.check} ${c.success(`${result.installed.length} observer${result.installed.length > 1 ? "s" : ""} installed!`)}`);
+
+				// Install background polling daemon
+				try {
+					installDaemon(7200);
+					console.log(`  ${sym.check} ${c.success("Background poller installed (every 2 hours)")}`);
+				} catch {
+					console.log(`  ${c.dim("Background poller skipped (install later: jobarbiter observe daemon install)")}`);
+				}
+
+				// Show poller-observable tools
+				const pollerTools = allTools.filter((t) => t.installed && t.observationMethod === "poller");
+				if (pollerTools.length > 0) {
+					console.log(`\n  ${c.bold("Poller will also scan these tools:")}`);
+					for (const t of pollerTools) {
+						console.log(`    ${sym.bullet} ${formatToolDisplay(t)}`);
+					}
+				}
+
 				console.log(`\n  ${c.bold("What happens now?")}`);
 			console.log(`  Observers activate each time you use your AI tools.`);
 			console.log(`  Just work normally — every session builds your profile.\n`);
@@ -772,6 +791,8 @@ async function runToolDetectionStep(
 			console.log(`  a work report to JobArbiter. Our agents interpret these reports`);
 			console.log(`  to build and evolve your narrative profile over time.`);
 			console.log(`  Raw session data never leaves your machine.\n`);
+
+			console.log(`  ${c.dim("Manage observers: jobarbiter observe --help")}`);
 			}
 		} else {
 			console.log(c.dim("\n  Skipped — you can install observers later with 'jobarbiter observe install'.\n"));

package/src/lib/poll-state.ts

@@ -0,0 +1,119 @@
+/**
+ * Poll State Management
+ *
+ * Read/write ~/.config/jobarbiter/observer/poll-state.json
+ * Tracks per-source poll times, known sessions, pause windows,
+ * disabled sources, and interval configuration.
+ */
+
+import { existsSync, readFileSync, writeFileSync, mkdirSync } from "node:fs";
+import { join } from "node:path";
+import { homedir } from "node:os";
+
+// ── Types ──────────────────────────────────────────────────────────────
+
+export interface PauseWindow {
+	start: string; // ISO timestamp
+	end: string;   // ISO timestamp
+}
+
+export interface PollState {
+	version: number;
+	lastPoll: Record<string, string>; // source -> ISO timestamp
+	knownSessionIds: string[];        // rolling 1000
+	pauseWindows: PauseWindow[];
+	disabledSources: string[];
+	interval: number;                 // seconds
+}
+
+// ── Paths ──────────────────────────────────────────────────────────────
+
+const OBSERVER_DIR = join(homedir(), ".config", "jobarbiter", "observer");
+const POLL_STATE_FILE = join(OBSERVER_DIR, "poll-state.json");
+
+function defaultPollState(): PollState {
+	return {
+		version: 1,
+		lastPoll: {},
+		knownSessionIds: [],
+		pauseWindows: [],
+		disabledSources: [],
+		interval: 7200,
+	};
+}
+
+// ── Core Functions ─────────────────────────────────────────────────────
+
+export function loadPollState(): PollState {
+	try {
+		if (!existsSync(POLL_STATE_FILE)) return defaultPollState();
+		const raw = readFileSync(POLL_STATE_FILE, "utf-8");
+		const data = JSON.parse(raw) as Partial<PollState>;
+		return {
+			...defaultPollState(),
+			...data,
+		};
+	} catch {
+		return defaultPollState();
+	}
+}
+
+export function savePollState(state: PollState): void {
+	mkdirSync(OBSERVER_DIR, { recursive: true });
+	writeFileSync(POLL_STATE_FILE, JSON.stringify(state, null, 2) + "\n");
+}
+
+export function addPauseWindow(start: string, end: string): void {
+	const state = loadPollState();
+	state.pauseWindows.push({ start, end });
+	// Keep last 50 windows
+	if (state.pauseWindows.length > 50) {
+		state.pauseWindows = state.pauseWindows.slice(-50);
+	}
+	savePollState(state);
+}
+
+export function isInPauseWindow(timestamp: string): boolean {
+	const state = loadPollState();
+	const ts = new Date(timestamp).getTime();
+	return state.pauseWindows.some((w) => {
+		const start = new Date(w.start).getTime();
+		const end = new Date(w.end).getTime();
+		return ts >= start && ts <= end;
+	});
+}
+
+export function addKnownSession(sessionId: string): void {
+	const state = loadPollState();
+	if (!state.knownSessionIds.includes(sessionId)) {
+		state.knownSessionIds.push(sessionId);
+		// Rolling window of 1000
+		if (state.knownSessionIds.length > 1000) {
+			state.knownSessionIds = state.knownSessionIds.slice(-1000);
+		}
+		savePollState(state);
+	}
+}
+
+export function isKnownSession(sessionId: string): boolean {
+	const state = loadPollState();
+	return state.knownSessionIds.includes(sessionId);
+}
+
+export function getDisabledSources(): string[] {
+	return loadPollState().disabledSources;
+}
+
+export function setDisabledSource(source: string): void {
+	const state = loadPollState();
+	if (!state.disabledSources.includes(source)) {
+		state.disabledSources.push(source);
+		savePollState(state);
+	}
+}
+
+export function removeDisabledSource(source: string): void {
+	const state = loadPollState();
+	state.disabledSources = state.disabledSources.filter((s) => s !== source);
+	savePollState(state);
+}