@metabob/minibob 0.1.2

package/dist/boredom.d.ts

@@ -0,0 +1,125 @@
+/**
+ * minibob Boredom Task System
+ *
+ * Enables autonomous operation by polling backend for tasks when idle.
+ * Transforms minibob from request-response to continuous autonomous agent.
+ *
+ * Two execution modes:
+ * 1. Template-based: Load and execute a specific template
+ * 2. Goal-based: Use SearchFirstExecutor for dynamic decomposition and reuse
+ */
+import type { ActivityTemplate } from "./types";
+export interface BoredomTask {
+    id: string;
+    templateId?: string;
+    goal?: string;
+    priority: "critical" | "high" | "medium" | "low";
+    variables: Record<string, unknown>;
+    reason?: string;
+    createdAt: number;
+    assignedTo?: string;
+}
+export interface BoredomTaskResult {
+    taskId: string;
+    success: boolean;
+    executionId?: string;
+    duration?: number;
+    error?: string;
+}
+export interface BoredomExecutorConfig {
+    pollInterval?: number;
+    idleThreshold?: number;
+    onExecuteTask: (template: ActivityTemplate, variables: Record<string, unknown>, reason?: string) => Promise<unknown>;
+    llmConfig: {
+        provider: "anthropic" | "openai";
+        apiKey: string;
+        model: string;
+        workingDirectory: string;
+    };
+}
+export declare class BoredomTaskExecutor {
+    private isRunning;
+    private pollInterval;
+    private idleThreshold;
+    private lastActivityTime;
+    private onExecuteTask;
+    private searchFirstExecutor;
+    constructor(config: BoredomExecutorConfig);
+    /**
+     * Start the boredom task executor loop
+     *
+     * Only starts if:
+     * 1. MCP is enabled (backend connection available)
+     * 2. Cluster mode is enabled (3+ pods)
+     *
+     * Boredom system is disabled in local/Docker/single-pod environments to avoid resource waste.
+     */
+    start(clusterMode?: boolean): void;
+    /**
+     * Stop the boredom task executor
+     */
+    stop(): void;
+    /**
+     * Mark activity (resets idle timer)
+     */
+    markActivity(): void;
+    /**
+     * Check if vessel is idle
+     */
+    isIdle(): boolean;
+    /**
+     * Main executor loop
+     */
+    private loop;
+    /**
+     * Fetch available boredom tasks from backend
+     */
+    private fetchTasks;
+    /**
+     * Convert template-based tasks to goal-based tasks when appropriate
+     *
+     * This enables backwards compatibility: the backend can still emit
+     * template-based tasks, but we convert debug/optimization tasks to
+     * use the SearchFirstExecutor for better reuse and decomposition.
+     */
+    private convertToGoalTaskIfApplicable;
+    /**
+     * Execute a boredom task
+     *
+     * Two execution modes:
+     * 1. Goal-based: Use SearchFirstExecutor for dynamic step decomposition
+     * 2. Template-based: Load and execute a specific template (legacy)
+     */
+    private executeTask;
+    /**
+     * Report task execution result to backend
+     */
+    private reportResult;
+    /**
+     * Sleep helper
+     */
+    private sleep;
+}
+/**
+ * Initialize boredom task executor
+ */
+export declare function initializeBoredom(config: BoredomExecutorConfig): BoredomTaskExecutor;
+/**
+ * Get boredom executor instance
+ */
+export declare function getBoredomExecutor(): BoredomTaskExecutor | null;
+/**
+ * Start boredom task execution
+ *
+ * @param clusterMode Whether cluster mode is enabled (required for boredom to start)
+ */
+export declare function startBoredom(clusterMode?: boolean): void;
+/**
+ * Stop boredom task execution
+ */
+export declare function stopBoredom(): void;
+/**
+ * Mark activity (called when handling user requests)
+ */
+export declare function markBoredomActivity(): void;
+//# sourceMappingURL=boredom.d.ts.map

package/dist/boredom.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"boredom.d.ts","sourceRoot":"","sources":["../src/boredom.ts"],"names":[],"mappings":"AAAA;;;;;;;;;GASG;AAKH,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,SAAS,CAAA;AAM/C,MAAM,WAAW,WAAW;IAC1B,EAAE,EAAE,MAAM,CAAA;IACV,UAAU,CAAC,EAAE,MAAM,CAAA;IACnB,IAAI,CAAC,EAAE,MAAM,CAAA;IACb,QAAQ,EAAE,UAAU,GAAG,MAAM,GAAG,QAAQ,GAAG,KAAK,CAAA;IAChD,SAAS,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAA;IAClC,MAAM,CAAC,EAAE,MAAM,CAAA;IACf,SAAS,EAAE,MAAM,CAAA;IACjB,UAAU,CAAC,EAAE,MAAM,CAAA;CACpB;AAED,MAAM,WAAW,iBAAiB;IAChC,MAAM,EAAE,MAAM,CAAA;IACd,OAAO,EAAE,OAAO,CAAA;IAChB,WAAW,CAAC,EAAE,MAAM,CAAA;IACpB,QAAQ,CAAC,EAAE,MAAM,CAAA;IACjB,KAAK,CAAC,EAAE,MAAM,CAAA;CACf;AAMD,MAAM,WAAW,qBAAqB;IACpC,YAAY,CAAC,EAAE,MAAM,CAAA;IACrB,aAAa,CAAC,EAAE,MAAM,CAAA;IAEtB,aAAa,EAAE,CAAC,QAAQ,EAAE,gBAAgB,EAAE,SAAS,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,EAAE,MAAM,CAAC,EAAE,MAAM,KAAK,OAAO,CAAC,OAAO,CAAC,CAAA;IAEpH,SAAS,EAAE;QACT,QAAQ,EAAE,WAAW,GAAG,QAAQ,CAAA;QAChC,MAAM,EAAE,MAAM,CAAA;QACd,KAAK,EAAE,MAAM,CAAA;QACb,gBAAgB,EAAE,MAAM,CAAA;KACzB,CAAA;CACF;AAED,qBAAa,mBAAmB;IAC9B,OAAO,CAAC,SAAS,CAAQ;IACzB,OAAO,CAAC,YAAY,CAAQ;IAC5B,OAAO,CAAC,aAAa,CAAQ;IAC7B,OAAO,CAAC,gBAAgB,CAAQ;IAChC,OAAO,CAAC,aAAa,CAAuG;IAC5H,OAAO,CAAC,mBAAmB,CAAqB;gBAEpC,MAAM,EAAE,qBAAqB;IAiBzC;;;;;;;;OAQG;IACH,KAAK,CAAC,WAAW,UAAQ,GAAG,IAAI;IAyBhC;;OAEG;IACH,IAAI,IAAI,IAAI;IAKZ;;OAEG;IACH,YAAY,IAAI,IAAI;IAIpB;;OAEG;IACH,MAAM,IAAI,OAAO;IAKjB;;OAEG;YACW,IAAI;IA+BlB;;OAEG;YACW,UAAU;IAqCxB;;;;;;OAMG;IACH,OAAO,CAAC,6BAA6B;IAuCrC;;;;;;OAMG;YACW,WAAW;IAuEzB;;OAEG;YACW,YAAY;IAqB1B;;OAEG;IACH,OAAO,CAAC,KAAK;CAGd;AAQD;;GAEG;AACH,wBAAgB,iBAAiB,CAAC,MAAM,EAAE,qBAAqB,GAAG,mBAAmB,CAQpF;AAED;;GAEG;AACH,wBAAgB,kBAAkB,IAAI,mBAAmB,GAAG,IAAI,CAE/D;AAED;;;;GAIG;AACH,wBAAgB,YAAY,CAAC,WAAW,UAAQ,GAAG,IAAI,CAItD;AAED;;GAEG;AACH,wBAAgB,WAAW,IAAI,IAAI,CAIlC;AAED;;GAEG;AACH,wBAAgB,mBAAmB,IAAI,IAAI,CAI1C"}

package/dist/boredom.js

@@ -0,0 +1,244 @@
+/**
+ * minibob Boredom Task System
+ *
+ * Enables autonomous operation by polling backend for tasks when idle.
+ * Transforms minibob from request-response to continuous autonomous agent.
+ */
+import { getMCPClient, isMCPEnabled } from "./mcp";
+import { loadTemplateFromMCPOrLocal } from "./activity";
+// =============================================================================
+// BOREDOM TASK EXECUTOR
+// =============================================================================
+export class BoredomTaskExecutor {
+    isRunning = false;
+    pollInterval;
+    idleThreshold;
+    lastActivityTime;
+    onExecuteTask;
+    constructor(config) {
+        this.pollInterval = config.pollInterval ?? 30000; // 30 seconds
+        this.idleThreshold = config.idleThreshold ?? 60000; // 60 seconds idle before fetching tasks
+        this.lastActivityTime = Date.now();
+        this.onExecuteTask = config.onExecuteTask;
+    }
+    /**
+     * Start the boredom task executor loop
+     *
+     * Only starts if:
+     * 1. MCP is enabled (backend connection available)
+     * 2. Cluster mode is enabled (3+ pods)
+     *
+     * Boredom system is disabled in local/Docker/single-pod environments to avoid resource waste.
+     */
+    start(clusterMode = false) {
+        if (this.isRunning) {
+            console.log("[Boredom] Already running");
+            return;
+        }
+        if (!isMCPEnabled()) {
+            console.log("[Boredom] MCP not enabled, boredom tasks disabled");
+            return;
+        }
+        if (!clusterMode) {
+            console.log("[Boredom] Not in cluster mode, boredom tasks disabled");
+            return;
+        }
+        this.isRunning = true;
+        console.log(`[Boredom] Starting task executor (poll interval: ${this.pollInterval}ms, idle threshold: ${this.idleThreshold}ms)`);
+        this.loop().catch((error) => {
+            console.error("[Boredom] Fatal error in loop:", error);
+            this.isRunning = false;
+        });
+    }
+    /**
+     * Stop the boredom task executor
+     */
+    stop() {
+        this.isRunning = false;
+        console.log("[Boredom] Stopping task executor");
+    }
+    /**
+     * Mark activity (resets idle timer)
+     */
+    markActivity() {
+        this.lastActivityTime = Date.now();
+    }
+    /**
+     * Check if vessel is idle
+     */
+    isIdle() {
+        const idleTime = Date.now() - this.lastActivityTime;
+        return idleTime >= this.idleThreshold;
+    }
+    /**
+     * Main executor loop
+     */
+    async loop() {
+        while (this.isRunning) {
+            try {
+                // Wait for poll interval
+                await this.sleep(this.pollInterval);
+                // Skip if not idle
+                if (!this.isIdle()) {
+                    continue;
+                }
+                // Fetch tasks from backend
+                const tasks = await this.fetchTasks();
+                if (tasks.length === 0) {
+                    continue;
+                }
+                console.log(`[Boredom] Found ${tasks.length} available task(s)`);
+                // Execute highest priority task
+                const task = tasks[0];
+                if (!task)
+                    continue;
+                await this.executeTask(task);
+            }
+            catch (error) {
+                console.error("[Boredom] Error in loop:", error);
+                // Continue running despite errors
+            }
+        }
+    }
+    /**
+     * Fetch available boredom tasks from backend
+     */
+    async fetchTasks() {
+        const mcp = getMCPClient();
+        if (!mcp)
+            return [];
+        try {
+            const response = await fetch(`${mcp.endpoint}/boredom-tasks`, {
+                method: "GET",
+                headers: {
+                    "Content-Type": "application/json",
+                },
+            });
+            if (!response.ok) {
+                if (response.status === 404) {
+                    // Endpoint not implemented yet
+                    return [];
+                }
+                throw new Error(`Failed to fetch tasks: ${response.status}`);
+            }
+            const data = await response.json();
+            const tasks = data.tasks ?? [];
+            // Sort by priority
+            return tasks.sort((a, b) => {
+                const priorityOrder = { critical: 0, high: 1, medium: 2, low: 3 };
+                return priorityOrder[a.priority] - priorityOrder[b.priority];
+            });
+        }
+        catch (error) {
+            console.error("[Boredom] Error fetching tasks:", error);
+            return [];
+        }
+    }
+    /**
+     * Execute a boredom task
+     */
+    async executeTask(task) {
+        console.log(`[Boredom] Executing task: ${task.id} (template: ${task.templateId})`);
+        const result = {
+            taskId: task.id,
+            success: false,
+        };
+        try {
+            // Load template
+            const template = await loadTemplateFromMCPOrLocal(task.templateId);
+            // Execute activity
+            const startTime = Date.now();
+            const execution = await this.onExecuteTask(template, task.variables, task.reason ?? `Boredom task: ${task.id}`);
+            result.success = true;
+            result.executionId = execution.id;
+            result.duration = Date.now() - startTime;
+            console.log(`[Boredom] ✓ Task completed: ${task.id} in ${result.duration}ms`);
+        }
+        catch (error) {
+            result.success = false;
+            result.error = error instanceof Error ? error.message : String(error);
+            console.error(`[Boredom] ✗ Task failed: ${task.id}`, error);
+        }
+        // Report result to backend
+        await this.reportResult(result);
+        // Mark activity to reset idle timer
+        this.markActivity();
+    }
+    /**
+     * Report task execution result to backend
+     */
+    async reportResult(result) {
+        const mcp = getMCPClient();
+        if (!mcp)
+            return;
+        try {
+            const response = await fetch(`${mcp.endpoint}/boredom-tasks/${result.taskId}/result`, {
+                method: "POST",
+                headers: {
+                    "Content-Type": "application/json",
+                },
+                body: JSON.stringify(result),
+            });
+            if (!response.ok) {
+                console.warn(`[Boredom] Failed to report result: ${response.status}`);
+            }
+        }
+        catch (error) {
+            console.error("[Boredom] Error reporting result:", error);
+        }
+    }
+    /**
+     * Sleep helper
+     */
+    sleep(ms) {
+        return new Promise((resolve) => setTimeout(resolve, ms));
+    }
+}
+// =============================================================================
+// SINGLETON BOREDOM EXECUTOR
+// =============================================================================
+let boredomExecutor = null;
+/**
+ * Initialize boredom task executor
+ */
+export function initializeBoredom(config) {
+    if (boredomExecutor) {
+        console.warn("[Boredom] Already initialized");
+        return boredomExecutor;
+    }
+    boredomExecutor = new BoredomTaskExecutor(config);
+    return boredomExecutor;
+}
+/**
+ * Get boredom executor instance
+ */
+export function getBoredomExecutor() {
+    return boredomExecutor;
+}
+/**
+ * Start boredom task execution
+ *
+ * @param clusterMode Whether cluster mode is enabled (required for boredom to start)
+ */
+export function startBoredom(clusterMode = false) {
+    if (boredomExecutor) {
+        boredomExecutor.start(clusterMode);
+    }
+}
+/**
+ * Stop boredom task execution
+ */
+export function stopBoredom() {
+    if (boredomExecutor) {
+        boredomExecutor.stop();
+    }
+}
+/**
+ * Mark activity (called when handling user requests)
+ */
+export function markBoredomActivity() {
+    if (boredomExecutor) {
+        boredomExecutor.markActivity();
+    }
+}
+//# sourceMappingURL=boredom.js.map

package/dist/boredom.js.map

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

package/dist/cli/acp-server.d.ts

@@ -0,0 +1,23 @@
+/**
+ * ACP Server Command
+ *
+ * Launch standalone ACP server for external agent integration.
+ *
+ * Modes:
+ * - stdio: JSON-RPC over stdin/stdout (for editor extensions, CLI piping)
+ * - http: HTTP server on specified port (default)
+ * - websocket: WebSocket server for streaming
+ */
+export interface ACPServerOptions {
+    mode?: 'stdio' | 'http' | 'websocket';
+    port?: number;
+    noTools?: boolean;
+    tools?: string[];
+    denyTools?: string[];
+    system?: string;
+}
+/**
+ * Run ACP server command
+ */
+export declare function launchACPServer(args: string[]): Promise<void>;
+//# sourceMappingURL=acp-server.d.ts.map

package/dist/cli/acp-server.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"acp-server.d.ts","sourceRoot":"","sources":["../../src/cli/acp-server.ts"],"names":[],"mappings":"AAAA;;;;;;;;;GASG;AAQH,MAAM,WAAW,gBAAgB;IAC/B,IAAI,CAAC,EAAE,OAAO,GAAG,MAAM,GAAG,WAAW,CAAA;IACrC,IAAI,CAAC,EAAE,MAAM,CAAA;IACb,OAAO,CAAC,EAAE,OAAO,CAAA;IACjB,KAAK,CAAC,EAAE,MAAM,EAAE,CAAA;IAChB,SAAS,CAAC,EAAE,MAAM,EAAE,CAAA;IACpB,MAAM,CAAC,EAAE,MAAM,CAAA;CAChB;AAED;;GAEG;AACH,wBAAsB,eAAe,CAAC,IAAI,EAAE,MAAM,EAAE,GAAG,OAAO,CAAC,IAAI,CAAC,CA8DnE"}

package/dist/cli/burrow.d.ts

@@ -0,0 +1,26 @@
+/**
+ * Burrow Command
+ *
+ * Inject minibob into an existing codebase, making it a vessel.
+ *
+ * Steps:
+ * 1. Analyze codebase structure (frameworks, entry points)
+ * 2. Add @metabob/minibob as dependency
+ * 3. Create minibob.json config file
+ * 4. Create .minibob/ directory for local state
+ * 5. Optionally inject vessel bootstrap into entry point
+ * 6. Generate initial activities based on detected patterns
+ */
+export interface BurrowOptions {
+    dryRun?: boolean;
+    configOnly?: boolean;
+    analyze?: boolean;
+    force?: boolean;
+    entry?: string;
+    noInject?: boolean;
+}
+/**
+ * Run burrow command
+ */
+export declare function burrow(args: string[]): Promise<void>;
+//# sourceMappingURL=burrow.d.ts.map

package/dist/cli/burrow.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"burrow.d.ts","sourceRoot":"","sources":["../../src/cli/burrow.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;GAYG;AAuBH,MAAM,WAAW,aAAa;IAC5B,MAAM,CAAC,EAAE,OAAO,CAAA;IAChB,UAAU,CAAC,EAAE,OAAO,CAAA;IACpB,OAAO,CAAC,EAAE,OAAO,CAAA;IACjB,KAAK,CAAC,EAAE,OAAO,CAAA;IACf,KAAK,CAAC,EAAE,MAAM,CAAA;IACd,QAAQ,CAAC,EAAE,OAAO,CAAA;CACnB;AAwBD;;GAEG;AACH,wBAAsB,MAAM,CAAC,IAAI,EAAE,MAAM,EAAE,GAAG,OAAO,CAAC,IAAI,CAAC,CA0G1D"}

package/dist/cli/doctor.d.ts

@@ -0,0 +1,22 @@
+/**
+ * Doctor Command
+ *
+ * Health check and configuration management for minibob.
+ *
+ * Checks:
+ * 1. Configuration - API key, config file, working directory
+ * 2. Backend - MCP endpoint reachability and health
+ * 3. Templates - Local templates directory and validity
+ * 4. Vessels - Configured vessels and their status
+ */
+export interface DoctorOptions {
+    fix?: boolean;
+    verbose?: boolean;
+    json?: boolean;
+    check?: string;
+}
+/**
+ * Run doctor command
+ */
+export declare function doctor(args: string[]): Promise<void>;
+//# sourceMappingURL=doctor.d.ts.map

package/dist/cli/doctor.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"doctor.d.ts","sourceRoot":"","sources":["../../src/cli/doctor.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;GAUG;AAKH,MAAM,WAAW,aAAa;IAC5B,GAAG,CAAC,EAAE,OAAO,CAAA;IACb,OAAO,CAAC,EAAE,OAAO,CAAA;IACjB,IAAI,CAAC,EAAE,OAAO,CAAA;IACd,KAAK,CAAC,EAAE,MAAM,CAAA;CACf;AAWD;;GAEG;AACH,wBAAsB,MAAM,CAAC,IAAI,EAAE,MAAM,EAAE,GAAG,OAAO,CAAC,IAAI,CAAC,CA4D1D"}

package/dist/cli/goal.d.ts

@@ -0,0 +1,22 @@
+/**
+ * Goal Command
+ *
+ * Set a goal and achieve it using available vessels.
+ *
+ * Uses existing infrastructure:
+ * - GoalProcessor for goal-driven execution
+ * - SearchFirstExecutor for dynamic decomposition
+ * - MCP backend for Thompson Sampling recommendations
+ */
+export interface GoalOptions {
+    searchFirst?: boolean;
+    maxActivities?: number;
+    maxCost?: number;
+    context?: Record<string, unknown>;
+    dryRun?: boolean;
+}
+/**
+ * Run goal command
+ */
+export declare function goal(args: string[]): Promise<void>;
+//# sourceMappingURL=goal.d.ts.map

package/dist/cli/goal.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"goal.d.ts","sourceRoot":"","sources":["../../src/cli/goal.ts"],"names":[],"mappings":"AAAA;;;;;;;;;GASG;AAUH,MAAM,WAAW,WAAW;IAC1B,WAAW,CAAC,EAAE,OAAO,CAAA;IACrB,aAAa,CAAC,EAAE,MAAM,CAAA;IACtB,OAAO,CAAC,EAAE,MAAM,CAAA;IAChB,OAAO,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAA;IACjC,MAAM,CAAC,EAAE,OAAO,CAAA;CACjB;AAED;;GAEG;AACH,wBAAsB,IAAI,CAAC,IAAI,EAAE,MAAM,EAAE,GAAG,OAAO,CAAC,IAAI,CAAC,CAiDxD"}

package/dist/cli/index.d.ts

@@ -0,0 +1,47 @@
+/**
+ * CLI Utilities and Router
+ *
+ * Common utilities for all CLI commands
+ */
+export interface ParsedOptions {
+    flags: Record<string, boolean>;
+    values: Record<string, string>;
+    positional: string[];
+}
+/**
+ * Parse command line arguments into structured options
+ */
+export declare function parseArgs(args: string[]): ParsedOptions;
+/**
+ * Format help text with consistent styling
+ */
+export declare function formatHelp(command: string, description: string, options: Array<{
+    flag: string;
+    description: string;
+    default?: string;
+}>): string;
+/**
+ * Print error and exit
+ */
+export declare function exitWithError(message: string, exitCode?: number): never;
+/**
+ * Print success message
+ */
+export declare function printSuccess(message: string): void;
+/**
+ * Print warning message
+ */
+export declare function printWarning(message: string): void;
+/**
+ * Print info message
+ */
+export declare function printInfo(message: string): void;
+/**
+ * Get home directory path for minibob data
+ */
+export declare function getMinibobHome(): string;
+/**
+ * Ensure minibob home directory exists
+ */
+export declare function ensureMinibobHome(): Promise<string>;
+//# sourceMappingURL=index.d.ts.map

package/dist/cli/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/cli/index.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH,MAAM,WAAW,aAAa;IAC5B,KAAK,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAA;IAC9B,MAAM,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAA;IAC9B,UAAU,EAAE,MAAM,EAAE,CAAA;CACrB;AAmBD;;GAEG;AACH,wBAAgB,SAAS,CAAC,IAAI,EAAE,MAAM,EAAE,GAAG,aAAa,CAkCvD;AAED;;GAEG;AACH,wBAAgB,UAAU,CAAC,OAAO,EAAE,MAAM,EAAE,WAAW,EAAE,MAAM,EAAE,OAAO,EAAE,KAAK,CAAC;IAC9E,IAAI,EAAE,MAAM,CAAA;IACZ,WAAW,EAAE,MAAM,CAAA;IACnB,OAAO,CAAC,EAAE,MAAM,CAAA;CACjB,CAAC,GAAG,MAAM,CAgBV;AAED;;GAEG;AACH,wBAAgB,aAAa,CAAC,OAAO,EAAE,MAAM,EAAE,QAAQ,SAAI,GAAG,KAAK,CAGlE;AAED;;GAEG;AACH,wBAAgB,YAAY,CAAC,OAAO,EAAE,MAAM,GAAG,IAAI,CAElD;AAED;;GAEG;AACH,wBAAgB,YAAY,CAAC,OAAO,EAAE,MAAM,GAAG,IAAI,CAElD;AAED;;GAEG;AACH,wBAAgB,SAAS,CAAC,OAAO,EAAE,MAAM,GAAG,IAAI,CAE/C;AAED;;GAEG;AACH,wBAAgB,cAAc,IAAI,MAAM,CAGvC;AAED;;GAEG;AACH,wBAAsB,iBAAiB,IAAI,OAAO,CAAC,MAAM,CAAC,CAazD"}

package/dist/cli/instance-registry.d.ts

@@ -0,0 +1,78 @@
+/**
+ * Instance Registry
+ *
+ * Tracks running minibob instances for the observe command.
+ * Instances register on startup and deregister on shutdown.
+ *
+ * Storage: ~/.minibob/instances.json
+ */
+export interface MinibobInstance {
+    id: string;
+    pid?: number;
+    port: number;
+    host: string;
+    startTime: number;
+    workingDirectory: string;
+    status: 'running' | 'idle' | 'busy' | 'unknown';
+    lastActivity?: string;
+    lastActivityTime?: number;
+    vesselType?: string;
+    capabilities?: string[];
+}
+export interface InstanceStatus {
+    id: string;
+    status: 'idle' | 'executing' | 'boredom';
+    currentActivity?: {
+        id: string;
+        name?: string;
+        task?: string;
+        progress?: number;
+    };
+    metrics: {
+        activitiesExecuted: number;
+        uptime: number;
+        totalCost?: number;
+    };
+    config: {
+        workingDirectory: string;
+        model: string;
+        port: number;
+    };
+}
+/**
+ * Register a minibob instance
+ */
+export declare function registerInstance(instance: MinibobInstance): Promise<void>;
+/**
+ * Deregister a minibob instance
+ */
+export declare function deregisterInstance(instanceId: string): Promise<void>;
+/**
+ * Update instance status
+ */
+export declare function updateInstanceStatus(instanceId: string, update: Partial<MinibobInstance>): Promise<void>;
+/**
+ * Get all registered instances
+ */
+export declare function listInstances(): Promise<MinibobInstance[]>;
+/**
+ * Get instance by ID
+ */
+export declare function getInstance(instanceId: string): Promise<MinibobInstance | null>;
+/**
+ * Clean up stale instances (processes that no longer exist)
+ */
+export declare function cleanupStaleInstances(): Promise<number>;
+/**
+ * Fetch status from a running instance
+ */
+export declare function fetchInstanceStatus(instance: MinibobInstance): Promise<InstanceStatus | null>;
+/**
+ * Scan localhost ports for minibob instances
+ */
+export declare function scanForInstances(startPort?: number, endPort?: number): Promise<MinibobInstance[]>;
+/**
+ * Generate unique instance ID
+ */
+export declare function generateInstanceId(): string;
+//# sourceMappingURL=instance-registry.d.ts.map

package/dist/cli/instance-registry.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"instance-registry.d.ts","sourceRoot":"","sources":["../../src/cli/instance-registry.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAIH,MAAM,WAAW,eAAe;IAC9B,EAAE,EAAE,MAAM,CAAA;IACV,GAAG,CAAC,EAAE,MAAM,CAAA;IACZ,IAAI,EAAE,MAAM,CAAA;IACZ,IAAI,EAAE,MAAM,CAAA;IACZ,SAAS,EAAE,MAAM,CAAA;IACjB,gBAAgB,EAAE,MAAM,CAAA;IACxB,MAAM,EAAE,SAAS,GAAG,MAAM,GAAG,MAAM,GAAG,SAAS,CAAA;IAC/C,YAAY,CAAC,EAAE,MAAM,CAAA;IACrB,gBAAgB,CAAC,EAAE,MAAM,CAAA;IACzB,UAAU,CAAC,EAAE,MAAM,CAAA;IACnB,YAAY,CAAC,EAAE,MAAM,EAAE,CAAA;CACxB;AAED,MAAM,WAAW,cAAc;IAC7B,EAAE,EAAE,MAAM,CAAA;IACV,MAAM,EAAE,MAAM,GAAG,WAAW,GAAG,SAAS,CAAA;IACxC,eAAe,CAAC,EAAE;QAChB,EAAE,EAAE,MAAM,CAAA;QACV,IAAI,CAAC,EAAE,MAAM,CAAA;QACb,IAAI,CAAC,EAAE,MAAM,CAAA;QACb,QAAQ,CAAC,EAAE,MAAM,CAAA;KAClB,CAAA;IACD,OAAO,EAAE;QACP,kBAAkB,EAAE,MAAM,CAAA;QAC1B,MAAM,EAAE,MAAM,CAAA;QACd,SAAS,CAAC,EAAE,MAAM,CAAA;KACnB,CAAA;IACD,MAAM,EAAE;QACN,gBAAgB,EAAE,MAAM,CAAA;QACxB,KAAK,EAAE,MAAM,CAAA;QACb,IAAI,EAAE,MAAM,CAAA;KACb,CAAA;CACF;AAiCD;;GAEG;AACH,wBAAsB,gBAAgB,CAAC,QAAQ,EAAE,eAAe,GAAG,OAAO,CAAC,IAAI,CAAC,CAI/E;AAED;;GAEG;AACH,wBAAsB,kBAAkB,CAAC,UAAU,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC,CAI1E;AAED;;GAEG;AACH,wBAAsB,oBAAoB,CACxC,UAAU,EAAE,MAAM,EAClB,MAAM,EAAE,OAAO,CAAC,eAAe,CAAC,GAC/B,OAAO,CAAC,IAAI,CAAC,CAQf;AAED;;GAEG;AACH,wBAAsB,aAAa,IAAI,OAAO,CAAC,eAAe,EAAE,CAAC,CAGhE;AAED;;GAEG;AACH,wBAAsB,WAAW,CAAC,UAAU,EAAE,MAAM,GAAG,OAAO,CAAC,eAAe,GAAG,IAAI,CAAC,CAGrF;AAED;;GAEG;AACH,wBAAsB,qBAAqB,IAAI,OAAO,CAAC,MAAM,CAAC,CAoC7D;AAED;;GAEG;AACH,wBAAsB,mBAAmB,CAAC,QAAQ,EAAE,eAAe,GAAG,OAAO,CAAC,cAAc,GAAG,IAAI,CAAC,CAmCnG;AAED;;GAEG;AACH,wBAAsB,gBAAgB,CACpC,SAAS,GAAE,MAAa,EACxB,OAAO,GAAE,MAAa,GACrB,OAAO,CAAC,eAAe,EAAE,CAAC,CAiD5B;AAED;;GAEG;AACH,wBAAgB,kBAAkB,IAAI,MAAM,CAE3C"}

package/dist/cli/observe.d.ts

@@ -0,0 +1,35 @@
+/**
+ * Observe Command
+ *
+ * Observe running instances OR codebases to extract/validate activities.
+ *
+ * Two modes:
+ * 1. Instance mode (default): View execution state of running minibob instances
+ * 2. Codebase mode (--codebase): Observe a codebase to extract activities
+ *
+ * The codebase mode extracts the instructional→functional mappings:
+ * - Developer Intent → Written Code (activities inferred from functions)
+ * - Written Code → Runtime (traced via execution)
+ *
+ * Discovery mechanisms for instance mode:
+ * 1. Explicit targets (--target flag)
+ * 2. Local registry (~/.minibob/instances.json)
+ * 3. Port scanning (--scan flag)
+ * 4. Backend query (--backend flag) - centralized view from metabob-activity-api
+ */
+export interface ObserveOptions {
+    target?: string;
+    codebase?: string;
+    list?: boolean;
+    follow?: boolean;
+    scan?: boolean;
+    backend?: boolean;
+    json?: boolean;
+    interval?: number;
+    validate?: boolean;
+}
+/**
+ * Run observe command
+ */
+export declare function observe(args: string[]): Promise<void>;
+//# sourceMappingURL=observe.d.ts.map

package/dist/cli/observe.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"observe.d.ts","sourceRoot":"","sources":["../../src/cli/observe.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;GAkBG;AAkBH,MAAM,WAAW,cAAc;IAC7B,MAAM,CAAC,EAAE,MAAM,CAAA;IACf,QAAQ,CAAC,EAAE,MAAM,CAAA;IACjB,IAAI,CAAC,EAAE,OAAO,CAAA;IACd,MAAM,CAAC,EAAE,OAAO,CAAA;IAChB,IAAI,CAAC,EAAE,OAAO,CAAA;IACd,OAAO,CAAC,EAAE,OAAO,CAAA;IACjB,IAAI,CAAC,EAAE,OAAO,CAAA;IACd,QAAQ,CAAC,EAAE,MAAM,CAAA;IACjB,QAAQ,CAAC,EAAE,OAAO,CAAA;CACnB;AAED;;GAEG;AACH,wBAAsB,OAAO,CAAC,IAAI,EAAE,MAAM,EAAE,GAAG,OAAO,CAAC,IAAI,CAAC,CAyD3D"}