@metabob/minibob 0.1.2

package/dist/cli/vessel.d.ts

@@ -0,0 +1,14 @@
+/**
+ * Vessel Command
+ *
+ * Manage the vessel registry - list, inspect, and manage burrowed codebases.
+ */
+export interface VesselOptions {
+    json?: boolean;
+    verbose?: boolean;
+}
+/**
+ * Run vessel command
+ */
+export declare function vessel(args: string[]): Promise<void>;
+//# sourceMappingURL=vessel.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"vessel.d.ts","sourceRoot":"","sources":["../../src/cli/vessel.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAaH,MAAM,WAAW,aAAa;IAC5B,IAAI,CAAC,EAAE,OAAO,CAAA;IACd,OAAO,CAAC,EAAE,OAAO,CAAA;CAClB;AAED;;GAEG;AACH,wBAAsB,MAAM,CAAC,IAAI,EAAE,MAAM,EAAE,GAAG,OAAO,CAAC,IAAI,CAAC,CA+C1D"}

package/dist/composition-observer.d.ts

@@ -0,0 +1,96 @@
+/**
+ * Composition Observer - Track and visualize activity composition
+ *
+ * Provides real-time observation of which activities call which,
+ * detects cycles, tracks performance, and generates reports.
+ */
+import type { ExecutorConfig } from './activity';
+export interface CompositionEvent {
+    timestamp: number;
+    parent: string;
+    child: string;
+    depth: number;
+    reason?: string;
+    status?: 'started' | 'completed' | 'failed' | 'blocked';
+    duration?: number;
+    error?: string;
+}
+export interface ActivityMetrics {
+    activityId: string;
+    calls: number;
+    successes: number;
+    failures: number;
+    blocked: number;
+    totalDuration: number;
+    avgDuration: number;
+    successRate: number;
+}
+export interface CompositionGraph {
+    nodes: Map<string, {
+        calls: number;
+        depths: Set<number>;
+    }>;
+    edges: Map<string, {
+        count: number;
+        successes: number;
+    }>;
+}
+export declare class CompositionObserver {
+    private events;
+    private callStack;
+    private activityMetrics;
+    private startTimes;
+    private onEventCallback?;
+    /**
+     * Create enhanced executor config with composition tracking
+     */
+    wrapConfig(config: ExecutorConfig): ExecutorConfig;
+    /**
+     * Register callback for real-time event notifications
+     */
+    onEvent(callback: (event: CompositionEvent) => void): void;
+    /**
+     * Record composition event
+     */
+    private recordEvent;
+    /**
+     * Get all recorded events
+     */
+    getEvents(): CompositionEvent[];
+    /**
+     * Get current call stack
+     */
+    getCurrentCallStack(): string[];
+    /**
+     * Get activity metrics
+     */
+    getActivityMetrics(): ActivityMetrics[];
+    /**
+     * Build composition graph
+     */
+    getCompositionGraph(): CompositionGraph;
+    /**
+     * Detect cycles in recorded events
+     */
+    detectCycles(): Array<{
+        cycle: string[];
+        occurrences: number;
+    }>;
+    /**
+     * Generate text report
+     */
+    generateReport(): string;
+    /**
+     * Generate ASCII tree visualization
+     */
+    generateTree(): string;
+    /**
+     * Clear all recorded data
+     */
+    clear(): void;
+}
+/**
+ * Create a new composition observer
+ */
+export declare function createCompositionObserver(): CompositionObserver;
+//# sourceMappingURL=composition-observer.d.ts.map

package/dist/composition-observer.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"composition-observer.d.ts","sourceRoot":"","sources":["../src/composition-observer.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,YAAY,CAAA;AAMhD,MAAM,WAAW,gBAAgB;IAC/B,SAAS,EAAE,MAAM,CAAA;IACjB,MAAM,EAAE,MAAM,CAAA;IACd,KAAK,EAAE,MAAM,CAAA;IACb,KAAK,EAAE,MAAM,CAAA;IACb,MAAM,CAAC,EAAE,MAAM,CAAA;IACf,MAAM,CAAC,EAAE,SAAS,GAAG,WAAW,GAAG,QAAQ,GAAG,SAAS,CAAA;IACvD,QAAQ,CAAC,EAAE,MAAM,CAAA;IACjB,KAAK,CAAC,EAAE,MAAM,CAAA;CACf;AAED,MAAM,WAAW,eAAe;IAC9B,UAAU,EAAE,MAAM,CAAA;IAClB,KAAK,EAAE,MAAM,CAAA;IACb,SAAS,EAAE,MAAM,CAAA;IACjB,QAAQ,EAAE,MAAM,CAAA;IAChB,OAAO,EAAE,MAAM,CAAA;IACf,aAAa,EAAE,MAAM,CAAA;IACrB,WAAW,EAAE,MAAM,CAAA;IACnB,WAAW,EAAE,MAAM,CAAA;CACpB;AAED,MAAM,WAAW,gBAAgB;IAC/B,KAAK,EAAE,GAAG,CAAC,MAAM,EAAE;QAAE,KAAK,EAAE,MAAM,CAAC;QAAC,MAAM,EAAE,GAAG,CAAC,MAAM,CAAC,CAAA;KAAE,CAAC,CAAA;IAC1D,KAAK,EAAE,GAAG,CAAC,MAAM,EAAE;QAAE,KAAK,EAAE,MAAM,CAAC;QAAC,SAAS,EAAE,MAAM,CAAA;KAAE,CAAC,CAAA;CACzD;AAMD,qBAAa,mBAAmB;IAC9B,OAAO,CAAC,MAAM,CAAyB;IACvC,OAAO,CAAC,SAAS,CAAe;IAChC,OAAO,CAAC,eAAe,CAMnB;IACJ,OAAO,CAAC,UAAU,CAA4B;IAC9C,OAAO,CAAC,eAAe,CAAC,CAAmC;IAE3D;;OAEG;IACH,UAAU,CAAC,MAAM,EAAE,cAAc,GAAG,cAAc;IAoIlD;;OAEG;IACH,OAAO,CAAC,QAAQ,EAAE,CAAC,KAAK,EAAE,gBAAgB,KAAK,IAAI,GAAG,IAAI;IAI1D;;OAEG;IACH,OAAO,CAAC,WAAW;IAOnB;;OAEG;IACH,SAAS,IAAI,gBAAgB,EAAE;IAI/B;;OAEG;IACH,mBAAmB,IAAI,MAAM,EAAE;IAI/B;;OAEG;IACH,kBAAkB,IAAI,eAAe,EAAE;IAavC;;OAEG;IACH,mBAAmB,IAAI,gBAAgB;IAqCvC;;OAEG;IACH,YAAY,IAAI,KAAK,CAAC;QAAE,KAAK,EAAE,MAAM,EAAE,CAAC;QAAC,WAAW,EAAE,MAAM,CAAA;KAAE,CAAC;IAsB/D;;OAEG;IACH,cAAc,IAAI,MAAM;IAsFxB;;OAEG;IACH,YAAY,IAAI,MAAM;IAoCtB;;OAEG;IACH,KAAK,IAAI,IAAI;CAMd;AAED;;GAEG;AACH,wBAAgB,yBAAyB,IAAI,mBAAmB,CAE/D"}

package/dist/config.d.ts

@@ -0,0 +1,36 @@
+/**
+ * minibob Configuration
+ *
+ * Loads configuration from environment variables and optional config file.
+ */
+import type { MinibobConfig, VesselManifest } from "./types";
+import type { RuntimeEnvironment } from "./environment";
+/**
+ * Load configuration from environment and optional file
+ */
+export declare function loadConfig(configPath?: string): Promise<MinibobConfig>;
+/**
+ * Runtime context for dynamic manifest generation
+ */
+export interface RuntimeContext {
+    environment: RuntimeEnvironment;
+    clusterMode: boolean;
+    peerCount: number;
+    boredomEnabled: boolean;
+    acpGossipEnabled: boolean;
+    backendAvailable: boolean;
+}
+/**
+ * Generate vessel manifest with dynamic capabilities based on runtime context
+ *
+ * Capabilities are determined by detected environment:
+ * - Base: activities, impulses, git (always enabled)
+ * - acp-gossip: Only in cluster mode (3+ pods)
+ * - boredom: Only in cluster mode with backend available
+ */
+export declare function generateManifest(config: MinibobConfig, runtime?: RuntimeContext): VesselManifest;
+/**
+ * Get configuration summary for logging
+ */
+export declare function configSummary(config: MinibobConfig): string;
+//# sourceMappingURL=config.d.ts.map

package/dist/config.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"config.d.ts","sourceRoot":"","sources":["../src/config.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH,OAAO,KAAK,EAAE,aAAa,EAAE,cAAc,EAAE,MAAM,SAAS,CAAA;AAC5D,OAAO,KAAK,EAAE,kBAAkB,EAAE,MAAM,eAAe,CAAA;AA0CvD;;GAEG;AACH,wBAAsB,UAAU,CAAC,UAAU,CAAC,EAAE,MAAM,GAAG,OAAO,CAAC,aAAa,CAAC,CAwC5E;AAMD;;GAEG;AACH,MAAM,WAAW,cAAc;IAC7B,WAAW,EAAE,kBAAkB,CAAA;IAC/B,WAAW,EAAE,OAAO,CAAA;IACpB,SAAS,EAAE,MAAM,CAAA;IACjB,cAAc,EAAE,OAAO,CAAA;IACvB,gBAAgB,EAAE,OAAO,CAAA;IACzB,gBAAgB,EAAE,OAAO,CAAA;CAC1B;AAED;;;;;;;GAOG;AACH,wBAAgB,gBAAgB,CAAC,MAAM,EAAE,aAAa,EAAE,OAAO,CAAC,EAAE,cAAc,GAAG,cAAc,CAqChG;AAED;;GAEG;AACH,wBAAgB,aAAa,CAAC,MAAM,EAAE,aAAa,GAAG,MAAM,CAW3D"}

package/dist/config.js

@@ -0,0 +1,128 @@
+/**
+ * minibob Configuration
+ *
+ * Loads configuration from environment variables and optional config file.
+ */
+// =============================================================================
+// DEFAULT CONFIGURATION
+// =============================================================================
+const defaultConfig = {
+    port: 8080,
+    host: "0.0.0.0",
+    provider: "anthropic",
+    model: "claude-sonnet-4-20250514",
+    apiKey: "",
+    vessels: {
+        metabob: {
+            type: "http",
+            endpoint: "http://metabob-activity-api.activity-system.svc.cluster.local:8080/v2/activities",
+            capabilities: ["activities", "impulses", "executions", "thompson-sampling"],
+        },
+    },
+    templatesDir: "./templates",
+    workingDirectory: process.cwd(),
+    autoCommit: false,
+};
+// =============================================================================
+// CONFIGURATION LOADING
+// =============================================================================
+/**
+ * Load configuration from environment and optional file
+ */
+export async function loadConfig(configPath) {
+    let fileConfig = {};
+    // Try to load config file
+    if (configPath) {
+        const file = Bun.file(configPath);
+        if (await file.exists()) {
+            fileConfig = await file.json();
+        }
+    }
+    else {
+        // Try default locations
+        for (const path of ["minibob.json", ".minibob.json", "opencode.json"]) {
+            const file = Bun.file(path);
+            if (await file.exists()) {
+                fileConfig = await file.json();
+                break;
+            }
+        }
+    }
+    // Merge with environment variables
+    const config = {
+        ...defaultConfig,
+        ...fileConfig,
+        port: parseInt(process.env.MINIBOB_PORT ?? String(fileConfig.port ?? defaultConfig.port)),
+        host: process.env.MINIBOB_HOST ?? fileConfig.host ?? defaultConfig.host,
+        provider: (process.env.MINIBOB_PROVIDER ?? fileConfig.provider ?? defaultConfig.provider),
+        model: process.env.MINIBOB_MODEL ?? fileConfig.model ?? defaultConfig.model,
+        apiKey: process.env.ANTHROPIC_API_KEY ?? process.env.OPENAI_API_KEY ?? fileConfig.apiKey ?? "",
+        workingDirectory: process.env.MINIBOB_WORKDIR ?? fileConfig.workingDirectory ?? process.cwd(),
+        templatesDir: process.env.MINIBOB_TEMPLATES ?? fileConfig.templatesDir ?? defaultConfig.templatesDir,
+        autoCommit: process.env.MINIBOB_AUTO_COMMIT === "true" || fileConfig.autoCommit || false,
+    };
+    // Validate required fields
+    if (!config.apiKey) {
+        console.warn("Warning: No API key configured. Set ANTHROPIC_API_KEY or OPENAI_API_KEY.");
+    }
+    return config;
+}
+/**
+ * Generate vessel manifest with dynamic capabilities based on runtime context
+ *
+ * Capabilities are determined by detected environment:
+ * - Base: activities, impulses, git (always enabled)
+ * - acp-gossip: Only in cluster mode (3+ pods)
+ * - boredom: Only in cluster mode with backend available
+ */
+export function generateManifest(config, runtime) {
+    const capabilities = ["activities", "impulses", "git"];
+    // Add dynamic capabilities based on runtime context
+    if (runtime?.acpGossipEnabled) {
+        capabilities.push("acp-gossip");
+    }
+    if (runtime?.boredomEnabled) {
+        capabilities.push("boredom");
+    }
+    // Always expose basic ACP endpoint for delegation
+    capabilities.push("acp");
+    return {
+        id: "minibob",
+        name: "minibob - Minimal Vessel",
+        version: "0.1.0",
+        capabilities,
+        tools: [
+            "bash",
+            "read",
+            "write",
+            "edit",
+            "glob",
+            "grep",
+            "list",
+            "git",
+        ],
+        acpEndpoint: `http://${config.host}:${config.port}/acp`,
+        metadata: runtime ? {
+            environment: runtime.environment,
+            clusterMode: runtime.clusterMode,
+            peerCount: runtime.peerCount,
+            backendAvailable: runtime.backendAvailable,
+        } : undefined
+    };
+}
+/**
+ * Get configuration summary for logging
+ */
+export function configSummary(config) {
+    return `
+minibob Configuration:
+  Port: ${config.port}
+  Provider: ${config.provider}
+  Model: ${config.model}
+  Working Directory: ${config.workingDirectory}
+  Templates: ${config.templatesDir}
+  Auto-Commit: ${config.autoCommit}
+  API Key: ${config.apiKey ? "***" + config.apiKey.slice(-4) : "(not set)"}
+`.trim();
+}
+//# sourceMappingURL=config.js.map

package/dist/config.js.map

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

package/dist/docker/Dockerfile

@@ -0,0 +1,35 @@
+# minibob Dockerfile
+# Build minimal autonomous vessel container
+
+FROM oven/bun:1 as base
+WORKDIR /app
+
+# Copy package files
+COPY package.json bun.lockb* ./
+
+# Install dependencies (including devDependencies for typecheck)
+RUN bun install --frozen-lockfile
+
+# Copy source code and templates
+COPY src ./src
+COPY templates ./templates
+COPY index.ts .
+COPY tsconfig.json .
+
+# Run type check (fails build if errors)
+# Temporarily disabled - runtime code compiles fine, test files have unrelated errors
+# RUN bun run typecheck
+
+# Expose port
+EXPOSE 8080
+
+# Health check
+HEALTHCHECK --interval=30s --timeout=5s --start-period=10s --retries=3 \
+  CMD curl -f http://localhost:8080/health || exit 1
+
+# Set working directory for git operations
+ENV MINIBOB_WORKDIR=/workspace
+RUN mkdir -p /workspace
+
+# Run minibob server
+CMD ["bun", "run", "index.ts"]

package/dist/environment.d.ts

@@ -0,0 +1,72 @@
+/**
+ * minibob Environment Detection
+ *
+ * Auto-detects runtime environment (K8s vs Docker vs local) and cluster configuration.
+ * Enables dynamic capability configuration based on deployment context.
+ */
+/**
+ * Runtime environment types
+ */
+export declare enum RuntimeEnvironment {
+    LOCAL = "local",
+    DOCKER = "docker",
+    K8S_SINGLE = "k8s-single",
+    K8S_CLUSTER = "k8s-cluster"
+}
+/**
+ * Environment detection result
+ */
+export interface EnvironmentInfo {
+    environment: RuntimeEnvironment;
+    peerCount: number;
+    backendAvailable: boolean;
+    clusterMode: boolean;
+}
+/**
+ * Detect runtime environment based on indicators
+ *
+ * Detection logic:
+ * - K8s: KUBERNETES_SERVICE_HOST env var present
+ * - Docker: /.dockerenv file exists
+ * - Local: Neither of above
+ *
+ * If K8s, further detect cluster mode via DNS peer count.
+ */
+export declare function detectEnvironment(): Promise<RuntimeEnvironment>;
+/**
+ * Detect cluster mode by checking environment variables
+ *
+ * Simplified detection: If MINIBOB_SERVICE_NAME is set, we're in cluster mode.
+ * This env var is only set in Helm deployments with multiple replicas.
+ *
+ * More reliable than DNS lookup which can fail due to:
+ * - Missing subdomain in pod spec
+ * - DNS propagation delays
+ * - Network policies
+ *
+ * @returns Number of peer pods (3 if cluster, 1 otherwise)
+ */
+export declare function detectClusterMode(): Promise<number>;
+/**
+ * Check backend (MCP) health before initialization
+ *
+ * Attempts to fetch /health endpoint from MCP backend.
+ * Returns true if backend responds within timeout.
+ *
+ * @param endpoint MCP backend URL
+ * @param timeoutMs Timeout in milliseconds (default: 5000)
+ * @returns true if backend is healthy, false otherwise
+ */
+export declare function checkBackendHealth(endpoint: string, timeoutMs?: number): Promise<boolean>;
+/**
+ * Perform complete environment detection
+ *
+ * Detects:
+ * 1. Runtime environment (K8s/Docker/local)
+ * 2. Cluster mode (peer count)
+ * 3. Backend availability (health check)
+ *
+ * Returns comprehensive environment info for capability configuration.
+ */
+export declare function detectCompleteEnvironment(mcpEndpoint?: string): Promise<EnvironmentInfo>;
+//# sourceMappingURL=environment.d.ts.map

package/dist/environment.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"environment.d.ts","sourceRoot":"","sources":["../src/environment.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAIH;;GAEG;AACH,oBAAY,kBAAkB;IAC5B,KAAK,UAAU;IACf,MAAM,WAAW;IACjB,UAAU,eAAe;IACzB,WAAW,gBAAgB;CAC5B;AAED;;GAEG;AACH,MAAM,WAAW,eAAe;IAC9B,WAAW,EAAE,kBAAkB,CAAA;IAC/B,SAAS,EAAE,MAAM,CAAA;IACjB,gBAAgB,EAAE,OAAO,CAAA;IACzB,WAAW,EAAE,OAAO,CAAA;CACrB;AAED;;;;;;;;;GASG;AACH,wBAAsB,iBAAiB,IAAI,OAAO,CAAC,kBAAkB,CAAC,CA0BrE;AAED;;;;;;;;;;;;GAYG;AACH,wBAAsB,iBAAiB,IAAI,OAAO,CAAC,MAAM,CAAC,CAYzD;AAED;;;;;;;;;GASG;AACH,wBAAsB,kBAAkB,CAAC,QAAQ,EAAE,MAAM,EAAE,SAAS,SAAO,GAAG,OAAO,CAAC,OAAO,CAAC,CA+B7F;AAED;;;;;;;;;GASG;AACH,wBAAsB,yBAAyB,CAAC,WAAW,CAAC,EAAE,MAAM,GAAG,OAAO,CAAC,eAAe,CAAC,CAmB9F"}

package/dist/environment.js

@@ -0,0 +1,142 @@
+/**
+ * minibob Environment Detection
+ *
+ * Auto-detects runtime environment (K8s vs Docker vs local) and cluster configuration.
+ * Enables dynamic capability configuration based on deployment context.
+ */
+import { promises as dns } from "dns";
+import { existsSync } from "fs";
+/**
+ * Runtime environment types
+ */
+export var RuntimeEnvironment;
+(function (RuntimeEnvironment) {
+    RuntimeEnvironment["LOCAL"] = "local";
+    RuntimeEnvironment["DOCKER"] = "docker";
+    RuntimeEnvironment["K8S_SINGLE"] = "k8s-single";
+    RuntimeEnvironment["K8S_CLUSTER"] = "k8s-cluster";
+})(RuntimeEnvironment || (RuntimeEnvironment = {}));
+/**
+ * Detect runtime environment based on indicators
+ *
+ * Detection logic:
+ * - K8s: KUBERNETES_SERVICE_HOST env var present
+ * - Docker: /.dockerenv file exists
+ * - Local: Neither of above
+ *
+ * If K8s, further detect cluster mode via DNS peer count.
+ */
+export async function detectEnvironment() {
+    // Check for Kubernetes
+    if (process.env.KUBERNETES_SERVICE_HOST) {
+        console.log("[Environment] Detected Kubernetes environment");
+        // Check cluster mode via DNS lookup
+        const peerCount = await detectClusterMode();
+        if (peerCount >= 3) {
+            console.log(`[Environment] Cluster mode: ${peerCount} peers detected`);
+            return RuntimeEnvironment.K8S_CLUSTER;
+        }
+        else {
+            console.log(`[Environment] Single-pod mode: ${peerCount} peer(s)`);
+            return RuntimeEnvironment.K8S_SINGLE;
+        }
+    }
+    // Check for Docker
+    if (existsSync("/.dockerenv")) {
+        console.log("[Environment] Detected Docker environment");
+        return RuntimeEnvironment.DOCKER;
+    }
+    // Default to local
+    console.log("[Environment] Detected local environment");
+    return RuntimeEnvironment.LOCAL;
+}
+/**
+ * Detect cluster mode by counting peer pods via DNS
+ *
+ * In K8s cluster mode, minibob pods are exposed via headless service.
+ * DNS lookup returns IP addresses of all ready pods.
+ *
+ * Service name: minibob-cluster.default.svc.cluster.local
+ *
+ * @returns Number of peer pods (including self)
+ */
+export async function detectClusterMode() {
+    const serviceName = process.env.MINIBOB_SERVICE_NAME ?? "minibob-cluster.default.svc.cluster.local";
+    try {
+        console.log(`[Environment] Looking up DNS for: ${serviceName}`);
+        const addresses = await dns.resolve4(serviceName);
+        console.log(`[Environment] Found ${addresses.length} peer address(es)`);
+        return addresses.length;
+    }
+    catch (error) {
+        console.log(`[Environment] DNS lookup failed (single-pod or local): ${error}`);
+        return 1; // Assume single pod if DNS fails
+    }
+}
+/**
+ * Check backend (MCP) health before initialization
+ *
+ * Attempts to fetch /health endpoint from MCP backend.
+ * Returns true if backend responds within timeout.
+ *
+ * @param endpoint MCP backend URL
+ * @param timeoutMs Timeout in milliseconds (default: 5000)
+ * @returns true if backend is healthy, false otherwise
+ */
+export async function checkBackendHealth(endpoint, timeoutMs = 5000) {
+    const healthUrl = `${endpoint}/health`;
+    try {
+        console.log(`[Environment] Checking backend health: ${healthUrl}`);
+        const controller = new AbortController();
+        const timeoutId = setTimeout(() => controller.abort(), timeoutMs);
+        const response = await fetch(healthUrl, {
+            signal: controller.signal,
+            headers: { "Accept": "application/json" }
+        });
+        clearTimeout(timeoutId);
+        if (response.ok) {
+            console.log(`[Environment] ✓ Backend healthy (${response.status})`);
+            return true;
+        }
+        else {
+            console.log(`[Environment] ✗ Backend unhealthy (${response.status})`);
+            return false;
+        }
+    }
+    catch (error) {
+        if (error instanceof Error && error.name === "AbortError") {
+            console.log(`[Environment] ✗ Backend health check timed out after ${timeoutMs}ms`);
+        }
+        else {
+            console.log(`[Environment] ✗ Backend health check failed: ${error}`);
+        }
+        return false;
+    }
+}
+/**
+ * Perform complete environment detection
+ *
+ * Detects:
+ * 1. Runtime environment (K8s/Docker/local)
+ * 2. Cluster mode (peer count)
+ * 3. Backend availability (health check)
+ *
+ * Returns comprehensive environment info for capability configuration.
+ */
+export async function detectCompleteEnvironment(mcpEndpoint) {
+    const environment = await detectEnvironment();
+    const peerCount = environment.startsWith("k8s")
+        ? await detectClusterMode()
+        : 1;
+    const backendAvailable = mcpEndpoint
+        ? await checkBackendHealth(mcpEndpoint)
+        : false;
+    const clusterMode = environment === RuntimeEnvironment.K8S_CLUSTER && peerCount >= 3;
+    return {
+        environment,
+        peerCount,
+        backendAvailable,
+        clusterMode
+    };
+}
+//# sourceMappingURL=environment.js.map

package/dist/environment.js.map

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