@metabob/minibob 0.1.2

package/dist/vessel-registry.d.ts

@@ -0,0 +1,229 @@
+/**
+ * Vessel Registry
+ *
+ * Tracks codebases that have been burrowed into and converted to vessels.
+ * Each vessel has:
+ * - Unique identity
+ * - Learned activities (from execution traces)
+ * - Defined impulses (context data)
+ * - Registered hooks (lifecycle events)
+ * - Provided tools (capabilities)
+ * - Composition graph (how activities relate)
+ *
+ * The registry enables:
+ * - Discovery: Find vessels available for use
+ * - Selection: Choose which vessel's activities to use
+ * - Learning: Track activity performance per vessel
+ * - Development: Debug and evolve vessel capabilities
+ */
+export interface VesselIdentity {
+    /** Unique vessel ID */
+    id: string;
+    /** Human-readable name */
+    name: string;
+    /** Path to the codebase */
+    path: string;
+    /** When the vessel was created (burrowed into) */
+    createdAt: number;
+    /** Last time the vessel was active */
+    lastActiveAt: number;
+    /** Version (from package.json or inferred) */
+    version?: string;
+    /** Description */
+    description?: string;
+}
+export interface VesselActivity {
+    /** Activity ID */
+    id: string;
+    /** Activity name */
+    name: string;
+    /** How the activity was created */
+    origin: 'extracted' | 'defined' | 'improvised';
+    /** Source location in code (if known) */
+    sourceLocation?: {
+        file: string;
+        line: number;
+        function?: string;
+    };
+    /** Execution count */
+    executions: number;
+    /** Success rate */
+    successRate: number;
+    /** Average duration (ms) */
+    avgDuration: number;
+    /** Thompson Sampling parameters */
+    thompson: {
+        alpha: number;
+        beta: number;
+    };
+}
+export interface VesselImpulse {
+    /** Impulse ID */
+    id: string;
+    /** Impulse type */
+    type: 'config' | 'context' | 'feature-flag' | 'mock' | 'override';
+    /** Description */
+    description?: string;
+    /** Default value */
+    defaultValue?: unknown;
+    /** Current value (if set) */
+    currentValue?: unknown;
+}
+export interface VesselHook {
+    /** Hook ID */
+    id: string;
+    /** Hook type */
+    type: 'startup' | 'shutdown' | 'error' | 'activity.before' | 'activity.after' | 'custom';
+    /** Handler location */
+    handler: string;
+    /** Whether the hook is enabled */
+    enabled: boolean;
+}
+export interface VesselTool {
+    /** Tool name */
+    name: string;
+    /** Tool description */
+    description: string;
+    /** Input schema */
+    inputSchema?: Record<string, unknown>;
+    /** How to invoke the tool */
+    invocation: {
+        type: 'function' | 'command' | 'http' | 'mcp';
+        target: string;
+    };
+}
+export interface VesselComposition {
+    /** Activity compositions recorded */
+    compositions: Array<{
+        parent: string;
+        child: string;
+        count: number;
+        successRate: number;
+    }>;
+    /** Inferred activity sequences */
+    sequences: Array<{
+        activities: string[];
+        count: number;
+        avgDuration: number;
+    }>;
+}
+export interface Vessel extends VesselIdentity {
+    /** Activities available in this vessel */
+    activities: VesselActivity[];
+    /** Impulses defined for this vessel */
+    impulses: VesselImpulse[];
+    /** Hooks registered for this vessel */
+    hooks: VesselHook[];
+    /** Tools provided by this vessel */
+    tools: VesselTool[];
+    /** Activity composition data */
+    composition: VesselComposition;
+    /** Runtime mapping data */
+    mapping: RuntimeMapping;
+}
+/**
+ * Maps runtime behavior to source code and intent
+ */
+export interface RuntimeMapping {
+    /** Function call → source location */
+    functionMap: Map<string, SourceLocation>;
+    /** Source location → inferred intent */
+    intentMap: Map<string, InferredIntent>;
+    /** Execution patterns → activities */
+    patternMap: Map<string, string>;
+}
+export interface SourceLocation {
+    file: string;
+    line: number;
+    column?: number;
+    functionName?: string;
+    className?: string;
+    moduleName?: string;
+}
+export interface InferredIntent {
+    /** What the code does */
+    purpose: string;
+    /** Why it exists */
+    rationale?: string;
+    /** Expected inputs */
+    inputs?: string[];
+    /** Expected outputs */
+    outputs?: string[];
+    /** Constraints */
+    constraints?: string[];
+    /** Success criteria */
+    successCriteria?: string[];
+    /** Confidence in this inference */
+    confidence: number;
+    /** How the intent was inferred */
+    source: 'function-name' | 'comment' | 'docstring' | 'variable-names' | 'data-flow' | 'llm-analysis';
+}
+/**
+ * Record activity execution to backend (for Thompson Sampling)
+ */
+export declare function recordActivityExecution(vesselId: string, activityId: string, success: boolean, durationMs: number): Promise<boolean>;
+/**
+ * Register a new vessel (after burrowing into a codebase)
+ */
+export declare function registerVessel(vessel: Omit<Vessel, 'id' | 'createdAt' | 'lastActiveAt' | 'mapping'>): Vessel;
+/**
+ * Get a vessel by ID
+ */
+export declare function getVessel(id: string): Vessel | null;
+/**
+ * Get vessel by path
+ */
+export declare function getVesselByPath(path: string): Vessel | null;
+/**
+ * List all registered vessels
+ */
+export declare function listVessels(): VesselIdentity[];
+/**
+ * Update vessel activity data
+ */
+export declare function updateVesselActivities(vesselId: string, activities: VesselActivity[]): void;
+/**
+ * Add an activity to a vessel
+ */
+export declare function addVesselActivity(vesselId: string, activity: VesselActivity): void;
+/**
+ * Update runtime mapping for a vessel
+ */
+export declare function updateVesselMapping(vesselId: string, type: 'function' | 'intent' | 'pattern', key: string, value: SourceLocation | InferredIntent | string): void;
+/**
+ * Record activity composition for a vessel
+ */
+export declare function recordVesselComposition(vesselId: string, parent: string, child: string, success: boolean): void;
+/**
+ * Deregister a vessel
+ */
+export declare function deregisterVessel(id: string): boolean;
+/**
+ * Register a vessel and sync to backend (async version)
+ */
+export declare function registerVesselWithSync(vessel: Omit<Vessel, 'id' | 'createdAt' | 'lastActiveAt' | 'mapping'>, functionMappings?: Array<{
+    functionName: string;
+    file: string;
+    line: number;
+    className?: string;
+    intent?: InferredIntent;
+}>): Promise<Vessel>;
+/**
+ * Fetch vessel from backend (if local not found)
+ */
+export declare function fetchVesselFromBackend(vesselId: string): Promise<Vessel | null>;
+export declare const vesselRegistry: {
+    register: typeof registerVessel;
+    registerWithSync: typeof registerVesselWithSync;
+    get: typeof getVessel;
+    getByPath: typeof getVesselByPath;
+    list: typeof listVessels;
+    updateActivities: typeof updateVesselActivities;
+    addActivity: typeof addVesselActivity;
+    updateMapping: typeof updateVesselMapping;
+    recordComposition: typeof recordVesselComposition;
+    recordExecution: typeof recordActivityExecution;
+    deregister: typeof deregisterVessel;
+    fetchFromBackend: typeof fetchVesselFromBackend;
+};
+//# sourceMappingURL=vessel-registry.d.ts.map

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

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