@metabob/minibob 0.1.2

package/dist/understanding/explorer.d.ts

@@ -0,0 +1,73 @@
+/**
+ * CodeExplorer - Fast static analysis of codebase structure
+ *
+ * Uses Bun file APIs to analyze code without LLM calls.
+ * Provides foundation for semantic understanding.
+ */
+import type { CodeStructure, FileAnalysis } from './types';
+export declare class CodeExplorer {
+    private workingDir;
+    private ignorePatterns;
+    constructor(workingDir?: string, additionalIgnore?: string[]);
+    /**
+     * Safe wrapper for Bun.file() with better error handling
+     */
+    private safeReadFile;
+    /**
+     * Explore codebase and return comprehensive structure
+     */
+    explore(rootPath: string): Promise<CodeStructure>;
+    /**
+     * Analyze specific file in detail
+     */
+    analyzeFile(filePath: string): Promise<FileAnalysis>;
+    /**
+     * List all files in directory (non-ignored)
+     */
+    private listAllFiles;
+    /**
+     * Check if file should be ignored
+     */
+    private shouldIgnore;
+    /**
+     * Group files by extension
+     */
+    private groupByExtension;
+    /**
+     * Extract dependencies from package.json files
+     */
+    private extractDependencies;
+    /**
+     * Find application entry points
+     */
+    private findEntryPoints;
+    /**
+     * Calculate total size and lines of code
+     */
+    private calculateCodebaseSize;
+    /**
+     * Build directory structure tree
+     */
+    private analyzeDirectoryStructure;
+    /**
+     * Extract imports from file content
+     */
+    private extractImports;
+    /**
+     * Extract exports from file content
+     */
+    private extractExports;
+    /**
+     * Extract function declarations
+     */
+    private extractFunctions;
+    /**
+     * Extract React components
+     */
+    private extractReactComponents;
+    /**
+     * Resolve path relative to working directory
+     */
+    private resolvePath;
+}
+//# sourceMappingURL=explorer.d.ts.map

package/dist/understanding/explorer.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"explorer.d.ts","sourceRoot":"","sources":["../../src/understanding/explorer.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH,OAAO,KAAK,EACV,aAAa,EAGb,YAAY,EAKb,MAAM,SAAS,CAAA;AAEhB,qBAAa,YAAY;IAmBrB,OAAO,CAAC,UAAU;IAlBpB,OAAO,CAAC,cAAc,CAerB;gBAGS,UAAU,GAAE,MAAsB,EAC1C,gBAAgB,CAAC,EAAE,MAAM,EAAE;IAO7B;;OAEG;IACH,OAAO,CAAC,YAAY;IAWpB;;OAEG;IACG,OAAO,CAAC,QAAQ,EAAE,MAAM,GAAG,OAAO,CAAC,aAAa,CAAC;IAqBvD;;OAEG;IACG,WAAW,CAAC,QAAQ,EAAE,MAAM,GAAG,OAAO,CAAC,YAAY,CAAC;IAiB1D;;OAEG;YACW,YAAY;IAa1B;;OAEG;IACH,OAAO,CAAC,YAAY;IAWpB;;OAEG;IACH,OAAO,CAAC,gBAAgB;IAWxB;;OAEG;YACW,mBAAmB;IAiDjC;;OAEG;YACW,eAAe;IAuD7B;;OAEG;YACW,qBAAqB;IA2BnC;;OAEG;YACW,yBAAyB;IA8CvC;;OAEG;IACH,OAAO,CAAC,cAAc;IA6BtB;;OAEG;IACH,OAAO,CAAC,cAAc;IA6CtB;;OAEG;IACH,OAAO,CAAC,gBAAgB;IA6BxB;;OAEG;IACH,OAAO,CAAC,sBAAsB;IA2B9B;;OAEG;IACH,OAAO,CAAC,WAAW;CAMpB"}

package/dist/understanding/index.d.ts

@@ -0,0 +1,7 @@
+/**
+ * Understanding module exports
+ */
+export { CodeExplorer } from './explorer';
+export { ApplicationAnalyzer } from './analyzer';
+export type { CodeStructure, DirectoryNode, Dependencies, FileAnalysis, Import, Export, FunctionDeclaration, Component, AnalyzeOptions, Analysis, ArchitectureAnalysis, ComponentAnalysis, DataFlowAnalysis, EntryPointAnalysis, DependencyAnalysis, TechStackAnalysis, Diagnosis, Pattern } from './types';
+//# sourceMappingURL=index.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/understanding/index.ts"],"names":[],"mappings":"AAAA;;GAEG;AAEH,OAAO,EAAE,YAAY,EAAE,MAAM,YAAY,CAAA;AACzC,OAAO,EAAE,mBAAmB,EAAE,MAAM,YAAY,CAAA;AAEhD,YAAY,EACV,aAAa,EACb,aAAa,EACb,YAAY,EACZ,YAAY,EACZ,MAAM,EACN,MAAM,EACN,mBAAmB,EACnB,SAAS,EACT,cAAc,EACd,QAAQ,EACR,oBAAoB,EACpB,iBAAiB,EACjB,gBAAgB,EAChB,kBAAkB,EAClB,kBAAkB,EAClB,iBAAiB,EACjB,SAAS,EACT,OAAO,EACR,MAAM,SAAS,CAAA"}

package/dist/understanding/types.d.ts

@@ -0,0 +1,136 @@
+/**
+ * Type definitions for understanding capabilities
+ */
+export interface CodeStructure {
+    totalFiles: number;
+    filesByType: Record<string, number>;
+    directoryStructure: DirectoryNode;
+    dependencies: Dependencies;
+    entryPoints: string[];
+    totalSize: number;
+    totalLoc: number;
+}
+export interface DirectoryNode {
+    name: string;
+    path: string;
+    type: 'file' | 'directory';
+    children?: DirectoryNode[];
+    size?: number;
+    extension?: string;
+}
+export interface Dependencies {
+    runtime: Record<string, string>;
+    dev: Record<string, string>;
+    frameworks: string[];
+    internal: string[];
+}
+export interface FileAnalysis {
+    path: string;
+    imports: Import[];
+    exports: Export[];
+    functions: FunctionDeclaration[];
+    components: Component[];
+    loc: number;
+    size: number;
+}
+export interface Import {
+    named: string[];
+    default?: string;
+    source: string;
+    line?: number;
+}
+export interface Export {
+    name: string;
+    type: 'function' | 'class' | 'const' | 'default';
+    line?: number;
+}
+export interface FunctionDeclaration {
+    name: string;
+    isAsync: boolean;
+    parameters: string[];
+    line?: number;
+}
+export interface Component {
+    name: string;
+    type: 'functional' | 'class';
+    props?: string[];
+    line?: number;
+}
+export interface AnalyzeOptions {
+    rootPath: string;
+    focus?: 'architecture' | 'dependencies' | 'components' | 'all';
+    depth?: 'shallow' | 'medium' | 'deep';
+    ignorePatterns?: string[];
+}
+export interface Analysis {
+    architecture: ArchitectureAnalysis;
+    components: ComponentAnalysis;
+    dataFlow: DataFlowAnalysis;
+    entryPoints: EntryPointAnalysis;
+    dependencies: DependencyAnalysis;
+    techStack: TechStackAnalysis;
+}
+export interface ArchitectureAnalysis {
+    pattern: string;
+    description: string;
+    layers: string[];
+}
+export interface ComponentAnalysis {
+    summary: string;
+    keyModules: Array<{
+        name: string;
+        purpose: string;
+        files: string[];
+    }>;
+}
+export interface DataFlowAnalysis {
+    description: string;
+    flows: Array<{
+        source: string;
+        destination: string;
+        dataType: string;
+    }>;
+}
+export interface EntryPointAnalysis {
+    main: string[];
+    server?: string;
+    client?: string;
+    cli?: string;
+}
+export interface DependencyAnalysis {
+    external: Array<{
+        name: string;
+        version: string;
+        purpose: string;
+    }>;
+    internal: Array<{
+        module: string;
+        dependsOn: string[];
+    }>;
+}
+export interface TechStackAnalysis {
+    runtime: string;
+    framework: string[];
+    language: string[];
+    tools: string[];
+}
+export interface Diagnosis {
+    symptoms: string[];
+    rootCause: string;
+    affectedFiles: string[];
+    recommendedFix: string;
+    validationSteps: string[];
+    confidence: 'low' | 'medium' | 'high';
+}
+export interface Pattern {
+    type: 'architecture' | 'design' | 'security' | 'performance';
+    name: string;
+    description: string;
+    instances: Array<{
+        file: string;
+        line?: number;
+        context?: string;
+    }>;
+    recommendation?: string;
+}
+//# sourceMappingURL=types.d.ts.map

package/dist/understanding/types.d.ts.map

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

package/dist/validation.d.ts

@@ -0,0 +1,29 @@
+/**
+ * Input validation utilities
+ *
+ * Lightweight validation without external dependencies.
+ * Prevents crashes from malformed input and provides clear error messages.
+ */
+export interface ValidationError {
+    field: string;
+    message: string;
+}
+export declare class ValidationException extends Error {
+    errors: ValidationError[];
+    constructor(errors: ValidationError[]);
+}
+/**
+ * Validate /run activity request body
+ */
+export declare function validateRunActivityRequest(body: unknown): {
+    template: string;
+    variables: Record<string, unknown>;
+    reason?: string;
+};
+/**
+ * Validate request body size (prevent DoS)
+ * @param contentLength Content-Length header value
+ * @param maxSizeBytes Maximum allowed size in bytes (default: 10MB)
+ */
+export declare function validateRequestSize(contentLength: string | null, maxSizeBytes?: number): void;
+//# sourceMappingURL=validation.d.ts.map

package/dist/validation.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"validation.d.ts","sourceRoot":"","sources":["../src/validation.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH,MAAM,WAAW,eAAe;IAC9B,KAAK,EAAE,MAAM,CAAA;IACb,OAAO,EAAE,MAAM,CAAA;CAChB;AAED,qBAAa,mBAAoB,SAAQ,KAAK;IACzB,MAAM,EAAE,eAAe,EAAE;gBAAzB,MAAM,EAAE,eAAe,EAAE;CAI7C;AAED;;GAEG;AACH,wBAAgB,0BAA0B,CAAC,IAAI,EAAE,OAAO,GAAG;IACzD,QAAQ,EAAE,MAAM,CAAA;IAChB,SAAS,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAA;IAClC,MAAM,CAAC,EAAE,MAAM,CAAA;CAChB,CAmEA;AAED;;;;GAIG;AACH,wBAAgB,mBAAmB,CACjC,aAAa,EAAE,MAAM,GAAG,IAAI,EAC5B,YAAY,GAAE,MAAyB,GACtC,IAAI,CAqBN"}

package/dist/validation.js

@@ -0,0 +1,106 @@
+/**
+ * Input validation utilities
+ *
+ * Lightweight validation without external dependencies.
+ * Prevents crashes from malformed input and provides clear error messages.
+ */
+export class ValidationException extends Error {
+    errors;
+    constructor(errors) {
+        super(`Validation failed: ${errors.map((e) => `${e.field}: ${e.message}`).join(", ")}`);
+        this.errors = errors;
+        this.name = "ValidationException";
+    }
+}
+/**
+ * Validate /run activity request body
+ */
+export function validateRunActivityRequest(body) {
+    const errors = [];
+    if (!body || typeof body !== "object") {
+        throw new ValidationException([
+            { field: "body", message: "Request body must be a JSON object" },
+        ]);
+    }
+    const data = body;
+    // Validate template (required)
+    const template = data.template ?? data.templatePath;
+    if (!template || typeof template !== "string") {
+        errors.push({
+            field: "template",
+            message: "Missing required field (string expected)",
+        });
+    }
+    if (template && typeof template === "string" && template.length > 1000) {
+        errors.push({
+            field: "template",
+            message: "Template path too long (max 1000 characters)",
+        });
+    }
+    // Validate variables (optional, default to empty object)
+    let variables = {};
+    if (data.variables !== undefined) {
+        if (typeof data.variables !== "object" || data.variables === null) {
+            errors.push({
+                field: "variables",
+                message: "Must be an object",
+            });
+        }
+        else {
+            variables = data.variables;
+        }
+    }
+    // Validate reason (optional)
+    let reason;
+    if (data.reason !== undefined) {
+        if (typeof data.reason !== "string") {
+            errors.push({
+                field: "reason",
+                message: "Must be a string",
+            });
+        }
+        else if (data.reason.length > 5000) {
+            errors.push({
+                field: "reason",
+                message: "Reason too long (max 5000 characters)",
+            });
+        }
+        else {
+            reason = data.reason;
+        }
+    }
+    if (errors.length > 0) {
+        throw new ValidationException(errors);
+    }
+    return {
+        template: template,
+        variables,
+        reason,
+    };
+}
+/**
+ * Validate request body size (prevent DoS)
+ * @param contentLength Content-Length header value
+ * @param maxSizeBytes Maximum allowed size in bytes (default: 10MB)
+ */
+export function validateRequestSize(contentLength, maxSizeBytes = 10 * 1024 * 1024) {
+    if (!contentLength) {
+        // No Content-Length header - will be checked during parsing
+        return;
+    }
+    const size = parseInt(contentLength, 10);
+    if (isNaN(size)) {
+        throw new ValidationException([
+            { field: "Content-Length", message: "Invalid header value" },
+        ]);
+    }
+    if (size > maxSizeBytes) {
+        throw new ValidationException([
+            {
+                field: "Content-Length",
+                message: `Request too large: ${size} bytes (max ${maxSizeBytes} bytes)`,
+            },
+        ]);
+    }
+}
+//# sourceMappingURL=validation.js.map

package/dist/validation.js.map

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

package/dist/vessel-bootstrap.d.ts

@@ -0,0 +1,190 @@
+/**
+ * Vessel Bootstrap
+ *
+ * Universal vessel conversion module.
+ * Import this into any application to make it self-aware and activity-controlled.
+ *
+ * Core Concept: Continuous Learning
+ * ---------------------------------
+ * The vessel doesn't have a separate "observation mode" - it continuously learns
+ * during normal operation. When activities execute:
+ *
+ *   Intent → Code       (instructional → functional, choosing what to execute)
+ *   Code → Outcome      (instructional → functional, execution results)
+ *
+ * Both transformations are mediated by activities. The existing infrastructure
+ * handles this automatically:
+ *
+ * 1. ActivityExecutor captures execution traces
+ * 2. Backend stores traces and applies Thompson Sampling
+ * 3. runtime-mapping maps traces to source and infers intent
+ *
+ * The burrow command lays the groundwork (injects bootstrap, creates config).
+ * Normal operation continuously builds understanding through execution traces.
+ *
+ * Usage:
+ * ```typescript
+ * import { initializeVessel } from '@metabob/minibob/vessel-bootstrap'
+ *
+ * const vessel = await initializeVessel({
+ *   workingDirectory: __dirname,
+ *   provider: 'anthropic',
+ *   apiKey: process.env.ANTHROPIC_API_KEY!,
+ *   model: 'claude-sonnet-4-20250514',
+ *   vesselType: 'my-app',
+ * })
+ *
+ * // Register components for runtime access
+ * vessel.state.register('myComponent', myComponentInstance)
+ *
+ * // Run activities - learning happens automatically via execution traces
+ * await vessel.runGoal('Optimize database query performance')
+ * ```
+ */
+import { type ExecutorConfig } from './activity';
+import type { ActivityTemplate } from './types';
+export interface VesselConfig extends ExecutorConfig {
+    /**
+     * Vessel type identifier (for telemetry)
+     */
+    vesselType?: string;
+    /**
+     * Enable self-improvement loop
+     * Vessel will periodically run optimization activities on itself
+     */
+    enableSelfImprovement?: boolean;
+    /**
+     * Self-improvement interval (ms)
+     * Default: 5 minutes
+     */
+    selfImprovementInterval?: number;
+}
+export interface VesselState {
+    /**
+     * Components registered for runtime access
+     */
+    registry: Map<string, any>;
+    /**
+     * Vessel metadata
+     */
+    metadata: {
+        type: string;
+        startTime: number;
+        workingDirectory: string;
+    };
+    /**
+     * Performance metrics
+     */
+    metrics: {
+        activitiesExecuted: number;
+        goalsExecuted: number;
+        totalCost: number;
+        avgDuration: number;
+        uptime: number;
+    };
+}
+/**
+ * Vessel Bootstrap
+ *
+ * Converts any application into a self-aware, activity-controlled vessel.
+ * Continuous learning happens automatically through execution traces.
+ */
+export declare class VesselBootstrap {
+    private executor;
+    private goalProcessor;
+    state: VesselStateManager;
+    private selfImprovementInterval?;
+    private config;
+    constructor(config: VesselConfig);
+    /**
+     * Run activity on this vessel
+     *
+     * @param template Activity template or template ID
+     * @param variables Variables for the activity
+     * @returns Activity execution result
+     */
+    runActivity(template: ActivityTemplate | string, variables?: any): Promise<import("./types").ActivityExecution>;
+    /**
+     * Run goal on this vessel
+     *
+     * Execution traces are automatically captured and sent to the backend
+     * where Thompson Sampling learns which activities work best.
+     *
+     * @param goal Natural language goal description
+     * @param context Additional context for the goal
+     * @param options Goal execution options
+     * @returns Goal execution result
+     */
+    runGoal(goal: string, context?: any, options?: any): Promise<import("./goal-processor").GoalResult>;
+    /**
+     * Start self-improvement loop
+     * Vessel periodically analyzes and optimizes itself
+     */
+    private startSelfImprovementLoop;
+    /**
+     * Shutdown vessel
+     */
+    shutdown(): void;
+}
+/**
+ * Vessel State Manager
+ *
+ * Manages observable state for the vessel
+ * Components register themselves for runtime access
+ */
+export declare class VesselStateManager {
+    private registry;
+    private metadata;
+    private metrics;
+    constructor(config: {
+        type: string;
+        workingDirectory: string;
+    });
+    /**
+     * Register component for runtime access
+     *
+     * @param name Component identifier
+     * @param component Any object to make accessible
+     */
+    register(name: string, component: any): void;
+    /**
+     * Get registered component
+     */
+    get(name: string): any;
+    /**
+     * List all registered components
+     */
+    list(): string[];
+    /**
+     * Get full state snapshot
+     */
+    snapshot(): VesselState;
+    /**
+     * Increment metric
+     */
+    incrementMetric(metric: keyof VesselState['metrics']): void;
+    /**
+     * Update metrics
+     */
+    updateMetrics(updates: Partial<VesselState['metrics']>): void;
+}
+/**
+ * Global vessel instance
+ * Applications can access via globalThis.__vessel
+ */
+declare global {
+    var __vessel: VesselBootstrap | undefined;
+}
+/**
+ * Initialize vessel globally
+ * Convenience function for applications
+ *
+ * @param config Vessel configuration
+ * @returns Vessel instance
+ */
+export declare function initializeVessel(config: VesselConfig): Promise<VesselBootstrap>;
+/**
+ * Get global vessel instance
+ */
+export declare function getVessel(): VesselBootstrap | undefined;
+//# sourceMappingURL=vessel-bootstrap.d.ts.map

package/dist/vessel-bootstrap.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"vessel-bootstrap.d.ts","sourceRoot":"","sources":["../src/vessel-bootstrap.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GA0CG;AAEH,OAAO,EAAoB,KAAK,cAAc,EAAE,MAAM,YAAY,CAAA;AAElE,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,SAAS,CAAA;AAU/C,MAAM,WAAW,YAAa,SAAQ,cAAc;IAClD;;OAEG;IACH,UAAU,CAAC,EAAE,MAAM,CAAA;IAEnB;;;OAGG;IACH,qBAAqB,CAAC,EAAE,OAAO,CAAA;IAE/B;;;OAGG;IACH,uBAAuB,CAAC,EAAE,MAAM,CAAA;CACjC;AAED,MAAM,WAAW,WAAW;IAC1B;;OAEG;IACH,QAAQ,EAAE,GAAG,CAAC,MAAM,EAAE,GAAG,CAAC,CAAA;IAE1B;;OAEG;IACH,QAAQ,EAAE;QACR,IAAI,EAAE,MAAM,CAAA;QACZ,SAAS,EAAE,MAAM,CAAA;QACjB,gBAAgB,EAAE,MAAM,CAAA;KACzB,CAAA;IAED;;OAEG;IACH,OAAO,EAAE;QACP,kBAAkB,EAAE,MAAM,CAAA;QAC1B,aAAa,EAAE,MAAM,CAAA;QACrB,SAAS,EAAE,MAAM,CAAA;QACjB,WAAW,EAAE,MAAM,CAAA;QACnB,MAAM,EAAE,MAAM,CAAA;KACf,CAAA;CACF;AAED;;;;;GAKG;AACH,qBAAa,eAAe;IAC1B,OAAO,CAAC,QAAQ,CAAkB;IAClC,OAAO,CAAC,aAAa,CAAe;IAC7B,KAAK,EAAE,kBAAkB,CAAA;IAChC,OAAO,CAAC,uBAAuB,CAAC,CAAgB;IAChD,OAAO,CAAC,MAAM,CAAc;gBAEhB,MAAM,EAAE,YAAY;IAyDhC;;;;;;OAMG;IACG,WAAW,CAAC,QAAQ,EAAE,gBAAgB,GAAG,MAAM,EAAE,SAAS,GAAE,GAAQ;IAsC1E;;;;;;;;;;OAUG;IACG,OAAO,CAAC,IAAI,EAAE,MAAM,EAAE,OAAO,GAAE,GAAQ,EAAE,OAAO,GAAE,GAAQ;IAoBhE;;;OAGG;IACH,OAAO,CAAC,wBAAwB;IA4BhC;;OAEG;IACH,QAAQ;CAST;AAED;;;;;GAKG;AACH,qBAAa,kBAAkB;IAC7B,OAAO,CAAC,QAAQ,CAA8B;IAC9C,OAAO,CAAC,QAAQ,CAAyB;IACzC,OAAO,CAAC,OAAO,CAAwB;gBAE3B,MAAM,EAAE;QAAE,IAAI,EAAE,MAAM,CAAC;QAAC,gBAAgB,EAAE,MAAM,CAAA;KAAE;IAgB9D;;;;;OAKG;IACH,QAAQ,CAAC,IAAI,EAAE,MAAM,EAAE,SAAS,EAAE,GAAG;IAKrC;;OAEG;IACH,GAAG,CAAC,IAAI,EAAE,MAAM,GAAG,GAAG;IAItB;;OAEG;IACH,IAAI,IAAI,MAAM,EAAE;IAIhB;;OAEG;IACH,QAAQ,IAAI,WAAW;IAUvB;;OAEG;IACH,eAAe,CAAC,MAAM,EAAE,MAAM,WAAW,CAAC,SAAS,CAAC;IAMpD;;OAEG;IACH,aAAa,CAAC,OAAO,EAAE,OAAO,CAAC,WAAW,CAAC,SAAS,CAAC,CAAC;CAYvD;AAED;;;GAGG;AACH,OAAO,CAAC,MAAM,CAAC;IACb,IAAI,QAAQ,EAAE,eAAe,GAAG,SAAS,CAAA;CAC1C;AAED;;;;;;GAMG;AACH,wBAAsB,gBAAgB,CAAC,MAAM,EAAE,YAAY,GAAG,OAAO,CAAC,eAAe,CAAC,CAgCrF;AAED;;GAEG;AACH,wBAAgB,SAAS,IAAI,eAAe,GAAG,SAAS,CAEvD"}