jobarbiter 0.3.13 → 0.4.0

package/dist/lib/launchd.js

@@ -0,0 +1,171 @@
+/**
+ * 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");
+// ── Helpers ────────────────────────────────────────────────────────────
+function resolveJobarbiterPath() {
+    // 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) {
+    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;
+    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() {
+    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) {
+    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() {
+    // 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() {
+    const installed = existsSync(PLIST_PATH);
+    const loaded = isLoaded();
+    let interval = 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() {
+    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/dist/lib/observe.js

@@ -91,9 +91,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 = "";
@@ -249,8 +269,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/dist/lib/onboard.js

@@ -13,6 +13,7 @@ import { loadConfig, saveConfig, getConfigPath } from "./config.js";
 import { apiUnauthenticated, api, ApiError } from "./api.js";
 import { installObservers } from "./observe.js";
 import { detectAllTools, formatToolDisplay, } from "./detect-tools.js";
+import { installDaemon } from "./launchd.js";
 import { loadProviderKeys, saveProviderKey, validateProviderKey, } from "./providers.js";
 // ── ANSI Colors ────────────────────────────────────────────────────────
 const colors = {
@@ -645,6 +646,22 @@ async function runToolDetectionStep(prompt, config) {
             }
             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`);
@@ -653,6 +670,7 @@ async function runToolDetectionStep(prompt, config) {
                 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 {

package/dist/lib/poll-state.d.ts

@@ -0,0 +1,28 @@
+/**
+ * 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.
+ */
+export interface PauseWindow {
+    start: string;
+    end: string;
+}
+export interface PollState {
+    version: number;
+    lastPoll: Record<string, string>;
+    knownSessionIds: string[];
+    pauseWindows: PauseWindow[];
+    disabledSources: string[];
+    interval: number;
+}
+export declare function loadPollState(): PollState;
+export declare function savePollState(state: PollState): void;
+export declare function addPauseWindow(start: string, end: string): void;
+export declare function isInPauseWindow(timestamp: string): boolean;
+export declare function addKnownSession(sessionId: string): void;
+export declare function isKnownSession(sessionId: string): boolean;
+export declare function getDisabledSources(): string[];
+export declare function setDisabledSource(source: string): void;
+export declare function removeDisabledSource(source: string): void;

package/dist/lib/poll-state.js

@@ -0,0 +1,91 @@
+/**
+ * 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";
+// ── Paths ──────────────────────────────────────────────────────────────
+const OBSERVER_DIR = join(homedir(), ".config", "jobarbiter", "observer");
+const POLL_STATE_FILE = join(OBSERVER_DIR, "poll-state.json");
+function defaultPollState() {
+    return {
+        version: 1,
+        lastPoll: {},
+        knownSessionIds: [],
+        pauseWindows: [],
+        disabledSources: [],
+        interval: 7200,
+    };
+}
+// ── Core Functions ─────────────────────────────────────────────────────
+export function loadPollState() {
+    try {
+        if (!existsSync(POLL_STATE_FILE))
+            return defaultPollState();
+        const raw = readFileSync(POLL_STATE_FILE, "utf-8");
+        const data = JSON.parse(raw);
+        return {
+            ...defaultPollState(),
+            ...data,
+        };
+    }
+    catch {
+        return defaultPollState();
+    }
+}
+export function savePollState(state) {
+    mkdirSync(OBSERVER_DIR, { recursive: true });
+    writeFileSync(POLL_STATE_FILE, JSON.stringify(state, null, 2) + "\n");
+}
+export function addPauseWindow(start, end) {
+    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) {
+    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) {
+    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) {
+    const state = loadPollState();
+    return state.knownSessionIds.includes(sessionId);
+}
+export function getDisabledSources() {
+    return loadPollState().disabledSources;
+}
+export function setDisabledSource(source) {
+    const state = loadPollState();
+    if (!state.disabledSources.includes(source)) {
+        state.disabledSources.push(source);
+        savePollState(state);
+    }
+}
+export function removeDisabledSource(source) {
+    const state = loadPollState();
+    state.disabledSources = state.disabledSources.filter((s) => s !== source);
+    savePollState(state);
+}

package/dist/lib/privacy-pause.d.ts

@@ -0,0 +1,17 @@
+/**
+ * Privacy Pause Management
+ *
+ * Manages the PAUSED sentinel file at ~/.config/jobarbiter/observer/PAUSED
+ * When paused, all observation hooks and pollers exit immediately.
+ */
+import { type PauseWindow } from "./poll-state.js";
+export interface PauseStatus {
+    paused: boolean;
+    pausedAt: string | null;
+    expiresAt: string | null;
+    pauseWindows: PauseWindow[];
+}
+export declare function pauseObservation(expiresAt?: Date): void;
+export declare function resumeObservation(): void;
+export declare function isPaused(): boolean;
+export declare function getPauseStatus(): PauseStatus;

package/dist/lib/privacy-pause.js

@@ -0,0 +1,137 @@
+/**
+ * Privacy Pause Management
+ *
+ * Manages the PAUSED sentinel file at ~/.config/jobarbiter/observer/PAUSED
+ * When paused, all observation hooks and pollers exit immediately.
+ */
+import { existsSync, readFileSync, writeFileSync, unlinkSync, mkdirSync } from "node:fs";
+import { join } from "node:path";
+import { homedir } from "node:os";
+import { addPauseWindow, loadPollState } from "./poll-state.js";
+// ── Paths ──────────────────────────────────────────────────────────────
+const OBSERVER_DIR = join(homedir(), ".config", "jobarbiter", "observer");
+const PAUSED_FILE = join(OBSERVER_DIR, "PAUSED");
+const OBSERVATIONS_FILE = join(OBSERVER_DIR, "observations.json");
+// ── Functions ──────────────────────────────────────────────────────────
+export function pauseObservation(expiresAt) {
+    mkdirSync(OBSERVER_DIR, { recursive: true });
+    const data = {
+        pausedAt: new Date().toISOString(),
+        expiresAt: expiresAt ? expiresAt.toISOString() : null,
+    };
+    writeFileSync(PAUSED_FILE, JSON.stringify(data, null, 2) + "\n");
+}
+export function resumeObservation() {
+    if (!existsSync(PAUSED_FILE))
+        return;
+    // Read pause data to record pause window
+    try {
+        const raw = readFileSync(PAUSED_FILE, "utf-8");
+        const data = JSON.parse(raw);
+        const now = new Date().toISOString();
+        addPauseWindow(data.pausedAt, now);
+    }
+    catch {
+        // Best effort
+    }
+    // Remove PAUSED file
+    try {
+        unlinkSync(PAUSED_FILE);
+    }
+    catch {
+        // Already removed
+    }
+    // Sweep observations.json for entries that leaked during pause
+    sweepLeakedObservations();
+}
+export function isPaused() {
+    if (!existsSync(PAUSED_FILE))
+        return false;
+    try {
+        const raw = readFileSync(PAUSED_FILE, "utf-8");
+        const data = JSON.parse(raw);
+        // Check if expired
+        if (data.expiresAt) {
+            const expiresAt = new Date(data.expiresAt).getTime();
+            if (Date.now() >= expiresAt) {
+                // Auto-resume: expired
+                autoResume(data);
+                return false;
+            }
+        }
+        return true;
+    }
+    catch {
+        return false;
+    }
+}
+export function getPauseStatus() {
+    const state = loadPollState();
+    const result = {
+        paused: false,
+        pausedAt: null,
+        expiresAt: null,
+        pauseWindows: state.pauseWindows,
+    };
+    if (!existsSync(PAUSED_FILE))
+        return result;
+    try {
+        const raw = readFileSync(PAUSED_FILE, "utf-8");
+        const data = JSON.parse(raw);
+        // Check for expiry
+        if (data.expiresAt) {
+            const expiresAt = new Date(data.expiresAt).getTime();
+            if (Date.now() >= expiresAt) {
+                autoResume(data);
+                return result;
+            }
+        }
+        result.paused = true;
+        result.pausedAt = data.pausedAt;
+        result.expiresAt = data.expiresAt;
+    }
+    catch {
+        // Corrupted PAUSED file
+    }
+    return result;
+}
+// ── Internal Helpers ───────────────────────────────────────────────────
+function autoResume(data) {
+    const now = new Date().toISOString();
+    addPauseWindow(data.pausedAt, data.expiresAt || now);
+    try {
+        unlinkSync(PAUSED_FILE);
+    }
+    catch {
+        // Already removed
+    }
+    sweepLeakedObservations();
+}
+function sweepLeakedObservations() {
+    if (!existsSync(OBSERVATIONS_FILE))
+        return;
+    try {
+        const raw = readFileSync(OBSERVATIONS_FILE, "utf-8");
+        const data = JSON.parse(raw);
+        if (!Array.isArray(data.sessions))
+            return;
+        const state = loadPollState();
+        const originalCount = data.sessions.length;
+        data.sessions = data.sessions.filter((session) => {
+            if (!session.timestamp)
+                return true;
+            const ts = new Date(session.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;
+            });
+        });
+        if (data.sessions.length !== originalCount) {
+            writeFileSync(OBSERVATIONS_FILE, JSON.stringify(data, null, 2) + "\n");
+        }
+    }
+    catch {
+        // Best effort
+    }
+}

package/dist/lib/transcript-poller.d.ts

@@ -0,0 +1,23 @@
+/**
+ * Transcript Poller
+ *
+ * Core polling logic that discovers and processes new transcripts
+ * from AI tools that don't support hooks (aider, goose, letta, etc.).
+ * Uses existing discoverTranscripts() and parseTranscriptFile() from
+ * transcript-reader.ts.
+ */
+export interface PollResult {
+    sourcesPolled: string[];
+    newSessions: number;
+    skippedPaused: number;
+    skippedDuplicate: number;
+    errors: string[];
+}
+interface PollOptions {
+    dryRun?: boolean;
+    source?: string;
+    verbose?: boolean;
+    since?: Date;
+}
+export declare function pollAllSources(options?: PollOptions): Promise<PollResult>;
+export {};