@vibecodetown/mcp-server 1.3.1 → 1.4.0

package/build/bin/vibe-companion.d.ts

@@ -0,0 +1,15 @@
+#!/usr/bin/env node
+/**
+ * Musu Companion — Chat interface server
+ *
+ * Usage:
+ *   vibe-companion --port 3100
+ *
+ * Env:
+ *   MUSU_COMPANION_PORT       Server port (default: 3100)
+ *   MUSU_COMPANION_HOST       Bind host (default: 127.0.0.1)
+ *   MUSU_WORKER_URL           BitNet worker URL (default: http://127.0.0.1:9090)
+ *   MUSU_BITNET_MODEL         Model ID (default: musu-prime-v1)
+ *   MUSU_COMPANION_MAX_STEPS  Agent loop max iterations (default: 5)
+ */
+export {};

package/build/bin/vibe-companion.js

@@ -0,0 +1,134 @@
+#!/usr/bin/env node
+/**
+ * Musu Companion — Chat interface server
+ *
+ * Usage:
+ *   vibe-companion --port 3100
+ *
+ * Env:
+ *   MUSU_COMPANION_PORT       Server port (default: 3100)
+ *   MUSU_COMPANION_HOST       Bind host (default: 127.0.0.1)
+ *   MUSU_WORKER_URL           BitNet worker URL (default: http://127.0.0.1:9090)
+ *   MUSU_BITNET_MODEL         Model ID (default: musu-prime-v1)
+ *   MUSU_COMPANION_MAX_STEPS  Agent loop max iterations (default: 5)
+ */
+import { createCompanionServer } from '../companion/server.js';
+import { logger } from '../shared/logger.js';
+function parseArgs(argv) {
+    const out = {
+        host: process.env.MUSU_COMPANION_HOST ?? '127.0.0.1',
+        port: Number(process.env.MUSU_COMPANION_PORT || 3100),
+        bitnetUrl: process.env.MUSU_WORKER_URL,
+        bitnetModel: process.env.MUSU_BITNET_MODEL,
+        maxSteps: process.env.MUSU_COMPANION_MAX_STEPS
+            ? Number(process.env.MUSU_COMPANION_MAX_STEPS)
+            : undefined,
+        mobileRelayUrl: process.env.MUSU_COMPANION_MOBILE_RELAY_URL,
+        mobileRelayTimeoutMs: process.env.MUSU_COMPANION_MOBILE_RELAY_TIMEOUT_MS
+            ? Number(process.env.MUSU_COMPANION_MOBILE_RELAY_TIMEOUT_MS)
+            : undefined,
+        wardenAuditPath: process.env.MUSU_COMPANION_WARDEN_AUDIT_PATH,
+        mobileRetryIntervalMs: process.env.MUSU_COMPANION_MOBILE_RETRY_INTERVAL_MS
+            ? Number(process.env.MUSU_COMPANION_MOBILE_RETRY_INTERVAL_MS)
+            : undefined,
+    };
+    for (let i = 0; i < argv.length; i++) {
+        const a = argv[i];
+        const n = argv[i + 1];
+        if (a === '--host' && n) {
+            out.host = n;
+            i++;
+            continue;
+        }
+        if (a === '--port' && n) {
+            out.port = Number(n);
+            i++;
+            continue;
+        }
+        if (a === '--bitnet-url' && n) {
+            out.bitnetUrl = n;
+            i++;
+            continue;
+        }
+        if (a === '--model' && n) {
+            out.bitnetModel = n;
+            i++;
+            continue;
+        }
+        if (a === '--max-steps' && n) {
+            out.maxSteps = Number(n);
+            i++;
+            continue;
+        }
+        if (a === '--mobile-relay-url' && n) {
+            out.mobileRelayUrl = n;
+            i++;
+            continue;
+        }
+        if (a === '--mobile-relay-timeout-ms' && n) {
+            out.mobileRelayTimeoutMs = Number(n);
+            i++;
+            continue;
+        }
+        if (a === '--warden-audit-path' && n) {
+            out.wardenAuditPath = n;
+            i++;
+            continue;
+        }
+        if (a === '--mobile-retry-interval-ms' && n) {
+            out.mobileRetryIntervalMs = Number(n);
+            i++;
+            continue;
+        }
+        if (a === '--help' || a === '-h') {
+            console.log(`
+vibe-companion - Musu Companion chat server
+
+Options:
+  --host <host>         (default: 127.0.0.1)
+  --port <port>         (default: 3100)
+  --bitnet-url <url>    BitNet worker URL (default: http://127.0.0.1:9090)
+  --model <id>          Model ID (default: musu-prime-v1)
+  --max-steps <n>       Agent loop max steps (default: 5)
+  --mobile-relay-url <url>          Optional mobile relay endpoint
+  --mobile-relay-timeout-ms <n>     Relay timeout ms (default: 5000)
+  --warden-audit-path <path>        SEC-005 audit log path
+  --mobile-retry-interval-ms <n>    Retry queue flush interval ms (default: 3000)
+`);
+            process.exit(0);
+        }
+    }
+    if (!Number.isFinite(out.port) || out.port <= 0) {
+        throw new Error('Invalid --port');
+    }
+    return out;
+}
+async function main() {
+    const opts = parseArgs(process.argv.slice(2));
+    const handle = await createCompanionServer({
+        host: opts.host,
+        port: opts.port,
+        bitnetUrl: opts.bitnetUrl,
+        bitnetModel: opts.bitnetModel,
+        maxSteps: opts.maxSteps,
+        mobileRelayUrl: opts.mobileRelayUrl,
+        mobileRelayTimeoutMs: opts.mobileRelayTimeoutMs,
+        wardenAuditPath: opts.wardenAuditPath,
+        mobileRetryIntervalMs: opts.mobileRetryIntervalMs,
+    });
+    console.log(`Musu Companion listening: ${handle.url}`);
+    console.log(`POST ${handle.url}/chat`);
+    console.log(`GET  ${handle.url}/health`);
+    // Graceful shutdown
+    const shutdown = async () => {
+        logger.info('[Companion] Shutting down...');
+        await handle.close();
+        process.exit(0);
+    };
+    process.on('SIGINT', shutdown);
+    process.on('SIGTERM', shutdown);
+}
+main().catch(err => {
+    console.error('ERROR:', err instanceof Error ? err.message : String(err));
+    process.exit(1);
+});

package/build/bin/vibe-dashboard.js

@@ -9,10 +9,10 @@
  *   VIBE_DASHBOARD_DIR       저장 경로 (default: ~/.vibe/dashboard)
  *   VIBE_CLOUD_SYNC_TOKEN    설정 시, Authorization Bearer 토큰 검증 + 복호화 secret으로 사용
  */
-import { startDashboardServer } from "../dashboard/server.js";
+import { startDashboardServer } from '../dashboard/server.js';
 function parseArgs(argv) {
     const out = {
-        host: "127.0.0.1",
+        host: '127.0.0.1',
         port: Number(process.env.VIBE_DASHBOARD_PORT || 8787),
         dir: process.env.VIBE_DASHBOARD_DIR || undefined,
         token: process.env.VIBE_CLOUD_SYNC_TOKEN || undefined,
@@ -20,27 +20,27 @@ function parseArgs(argv) {
     for (let i = 0; i < argv.length; i++) {
         const a = argv[i];
         const n = argv[i + 1];
-        if (a === "--host" && n) {
+        if (a === '--host' && n) {
             out.host = n;
             i++;
             continue;
         }
-        if (a === "--port" && n) {
+        if (a === '--port' && n) {
             out.port = Number(n);
             i++;
             continue;
         }
-        if (a === "--dir" && n) {
+        if (a === '--dir' && n) {
             out.dir = n;
             i++;
             continue;
         }
-        if (a === "--token" && n) {
+        if (a === '--token' && n) {
             out.token = n;
             i++;
             continue;
         }
-        if (a === "--help" || a === "-h") {
+        if (a === '--help' || a === '-h') {
             console.log(`
 vibe-dashboard - Local dashboard server (MVP)
 
@@ -54,13 +54,13 @@ Options:
         }
     }
     if (!Number.isFinite(out.port) || out.port <= 0) {
-        throw new Error("Invalid --port");
+        throw new Error('Invalid --port');
     }
     return out;
 }
 async function main() {
     const opts = parseArgs(process.argv.slice(2));
-    const handle = startDashboardServer({
+    const handle = await startDashboardServer({
         host: opts.host,
         port: opts.port,
         storageDir: opts.dir,
@@ -70,7 +70,7 @@ async function main() {
     console.log(`Vibe Dashboard (local) listening: ${handle.url}`);
     console.log(`POST ${handle.url}/api/v1/sync`);
 }
-main().catch((err) => {
-    console.error("ERROR:", err instanceof Error ? err.message : String(err));
+main().catch(err => {
+    console.error('ERROR:', err instanceof Error ? err.message : String(err));
     process.exit(1);
 });

package/build/bin/vibe-mapper-worker.js

@@ -12,18 +12,33 @@
  * Environment:
  *   VIBE_MAPPER_WORKER_PORT - Override default port
  */
-import { startMapperWorkerServer } from "../mapper-worker/server.js";
+import { startMapperWorkerServer } from '../mapper-worker/server.js';
+import { logger } from '../shared/logger.js';
 // Parse command line arguments
 function parseArgs() {
     const args = process.argv.slice(2);
+    let host = '127.0.0.1';
     let port = 8850;
     let help = false;
     for (let i = 0; i < args.length; i++) {
         const arg = args[i];
-        if (arg === "--help" || arg === "-h") {
+        if (arg === '--help' || arg === '-h') {
             help = true;
         }
-        else if (arg === "--port" || arg === "-p") {
+        else if (arg === '--host') {
+            const nextArg = args[i + 1];
+            if (nextArg) {
+                host = nextArg;
+                i++;
+            }
+        }
+        else if (arg.startsWith('--host=')) {
+            const [, value = ''] = arg.split('=', 2);
+            if (value.trim()) {
+                host = value.trim();
+            }
+        }
+        else if (arg === '--port' || arg === '-p') {
             const nextArg = args[i + 1];
             if (nextArg) {
                 const parsed = parseInt(nextArg, 10);
@@ -34,6 +49,10 @@ function parseArgs() {
             }
         }
     }
+    const envHost = process.env.VIBE_MAPPER_WORKER_HOST;
+    if (envHost && !args.some(a => a === '--host' || a.startsWith('--host='))) {
+        host = envHost;
+    }
     // Environment override
     const envPort = process.env.VIBE_MAPPER_WORKER_PORT;
     if (envPort) {
@@ -42,7 +61,7 @@ function parseArgs() {
             port = parsed;
         }
     }
-    return { port, help };
+    return { host, port, help };
 }
 function showHelp() {
     console.log(`
@@ -52,10 +71,12 @@ Usage:
   vibe-mapper-worker [options]
 
 Options:
+  --host <host>      Host to bind to (default: 127.0.0.1)
   -p, --port <port>  Port to listen on (default: 8850)
   -h, --help         Show this help message
 
 Environment Variables:
+  VIBE_MAPPER_WORKER_HOST  Override default host
   VIBE_MAPPER_WORKER_PORT  Override default port
 
 Endpoints:
@@ -63,30 +84,31 @@ Endpoints:
   POST /scan         Run mapping operation
 
 Examples:
+  vibe-mapper-worker --host 0.0.0.0 --port 8850
   vibe-mapper-worker --port 8850
-  VIBE_MAPPER_WORKER_PORT=9000 vibe-mapper-worker
+  VIBE_MAPPER_WORKER_HOST=0.0.0.0 VIBE_MAPPER_WORKER_PORT=9000 vibe-mapper-worker
 `);
 }
 async function main() {
-    const { port, help } = parseArgs();
+    const { host, port, help } = parseArgs();
     if (help) {
         showHelp();
         process.exit(0);
     }
-    console.log(`[vibe-mapper-worker] Starting on port ${port}...`);
-    const handle = startMapperWorkerServer({ port });
+    logger.info(`[vibe-mapper-worker] Starting on ${host}:${port}...`);
+    const handle = startMapperWorkerServer({ host, port });
     // Handle graceful shutdown
     const shutdown = async () => {
-        console.log("\n[vibe-mapper-worker] Shutting down...");
+        logger.info('[vibe-mapper-worker] Shutting down...');
         await handle.close();
         process.exit(0);
     };
-    process.on("SIGINT", shutdown);
-    process.on("SIGTERM", shutdown);
-    console.log(`[vibe-mapper-worker] Ready at http://127.0.0.1:${port}`);
-    console.log("[vibe-mapper-worker] Press Ctrl+C to stop");
+    process.on('SIGINT', shutdown);
+    process.on('SIGTERM', shutdown);
+    console.log(`[vibe-mapper-worker] Ready at http://${host}:${port}`);
+    console.log('[vibe-mapper-worker] Press Ctrl+C to stop');
 }
-main().catch((err) => {
-    console.error("[vibe-mapper-worker] Fatal error:", err);
+main().catch(err => {
+    console.error('[vibe-mapper-worker] Fatal error:', err);
     process.exit(1);
 });

package/build/bitnet-worker/autostart.js

@@ -13,6 +13,7 @@
  */
 import { startBitNetWorkerServer } from "./server.js";
 import { isBitNetPoolEnabled } from "./types.js";
+import { logger } from '../shared/logger.js';
 // ============================================================
 // Singleton State
 // ============================================================
@@ -64,7 +65,7 @@ export async function startBitNetWorkerIfEnabled() {
             return _handle;
         }
         catch (e) {
-            console.error(`[BitNet Worker] Failed to start: ${e instanceof Error ? e.message : String(e)}`);
+            logger.error(`[BitNet Worker] Failed to start: ${e instanceof Error ? e.message : String(e)}`);
             return null;
         }
         finally {
@@ -87,10 +88,10 @@ export async function shutdownBitNetWorker() {
     }
     try {
         await _handle.close();
-        console.error(`[BitNet Worker] Shutdown complete`);
+        logger.info(`[BitNet Worker] Shutdown complete`);
     }
     catch (e) {
-        console.error(`[BitNet Worker] Shutdown error: ${e instanceof Error ? e.message : String(e)}`);
+        logger.error(`[BitNet Worker] Shutdown error: ${e instanceof Error ? e.message : String(e)}`);
     }
     finally {
         _handle = null;

package/build/bitnet-worker/client.js

@@ -18,6 +18,7 @@
  *   VIBE_BITNET_POOL_ENABLED    - Enable pool mode (default: 0)
  */
 import { isBitNetWorkerEnabled, isBitNetPoolEnabled, getBitNetWorkerUrl, getBitNetTimeout, isBitNetFallbackEnabled, } from "./types.js";
+import { logger } from '../shared/logger.js';
 // ============================================================
 // Environment Helpers (re-export from types.ts)
 // ============================================================
@@ -200,7 +201,7 @@ export async function checkViaWorkerOrFallback(files, context, fallbackFn) {
         const errorMsg = e instanceof Error ? e.message : String(e);
         // If fallback enabled, try in-process
         if (client.shouldFallback()) {
-            console.warn(`[BitNet Worker] Worker failed (${errorMsg}), falling back to in-process`);
+            logger.warn(`[BitNet Worker] Worker failed (${errorMsg}), falling back to in-process`);
             try {
                 const data = await fallbackFn();
                 return { success: true, data, usedWorker: false };
@@ -246,7 +247,7 @@ export async function signalViaWorkerOrFallback(includeAutopilot, fallbackFn) {
     catch (e) {
         const errorMsg = e instanceof Error ? e.message : String(e);
         if (client.shouldFallback()) {
-            console.warn(`[BitNet Worker] Worker failed (${errorMsg}), falling back to in-process`);
+            logger.warn(`[BitNet Worker] Worker failed (${errorMsg}), falling back to in-process`);
             try {
                 const data = await fallbackFn();
                 return { success: true, data, usedWorker: false };

package/build/bitnet-worker/cpu_brake.js

@@ -6,6 +6,7 @@
  * Different thresholds for free and paid tiers.
  */
 import os from "node:os";
+import { logger } from '../shared/logger.js';
 // ============================================================
 // Constants
 // ============================================================
@@ -171,7 +172,7 @@ export function createOverloadResponse(tier) {
 export function logCpuStatus() {
     const { loadAvg1m, cores, normalized } = getCpuLoad();
     const config = getBrakeConfig();
-    console.log(`[BitNet Brake] CPU: ${(normalized * 100).toFixed(1)}% (${loadAvg1m.toFixed(2)}/${cores} cores)`);
-    console.log(`[BitNet Brake] Thresholds: free=${(config.freeThreshold * 100).toFixed(0)}%, paid=${(config.paidThreshold * 100).toFixed(0)}%`);
-    console.log(`[BitNet Brake] Enabled: ${config.enabled}`);
+    logger.info(`[BitNet Brake] CPU: ${(normalized * 100).toFixed(1)}% (${loadAvg1m.toFixed(2)}/${cores} cores)`);
+    logger.info(`[BitNet Brake] Thresholds: free=${(config.freeThreshold * 100).toFixed(0)}%, paid=${(config.paidThreshold * 100).toFixed(0)}%`);
+    logger.info(`[BitNet Brake] Enabled: ${config.enabled}`);
 }

package/build/bitnet-worker/hw_slots.js

@@ -6,6 +6,7 @@
  * available hardware (CPU cores, RAM) for free/paid tiers.
  */
 import os from "node:os";
+import { logger } from '../shared/logger.js';
 // ============================================================
 // Constants
 // ============================================================
@@ -162,6 +163,6 @@ export function extractTierFromHeaders(headers) {
  */
 export function logSlotLimits() {
     const limits = calcSlotLimits();
-    console.log(`[BitNet] Hardware: ${limits.cpuCores} cores, ${limits.totalRamGB}GB RAM`);
-    console.log(`[BitNet] Slot limits: free=${limits.free}, paid=${limits.paid} (hwMax=${limits.hwMax})`);
+    logger.info(`[BitNet] Hardware: ${limits.cpuCores} cores, ${limits.totalRamGB}GB RAM`);
+    logger.info(`[BitNet] Slot limits: free=${limits.free}, paid=${limits.paid} (hwMax=${limits.hwMax})`);
 }

package/build/bitnet-worker/index.d.ts

@@ -18,7 +18,7 @@ export { Metrics, getMetrics, resetMetrics, type MetricsSnapshot } from "./metri
 export { BitNetWorkerClient, PooledBitNetWorkerClient, getWorkerClient, getPooledBitNetClient, initPooledBitNetClient, resetPooledBitNetClient, isWorkerEnabled, isFallbackEnabled, isBitNetPoolEnabled, getWorkerUrl, getWorkerTimeout, checkViaWorkerOrFallback, signalViaWorkerOrFallback, type BitNetWorkerClientOptions, type HealthResponse, type WorkerCallResult, } from "./client.js";
 export { BITNET_ENV_VARS, isBitNetWorkerEnabled, isBitNetPoolEnabled as isPoolEnabled, getBitNetWorkerUrl, getBitNetTimeout, isBitNetFallbackEnabled, getBitNetPoolMin, getBitNetPoolMax, getBitNetPoolBasePort, getBitNetHealthPollMs, getBitNetExternalEndpoints, getBitNetOptionsFromEnv, type BitNetHealthResponse, type BitNetCheckRequest, type BitNetSignalRequest, type BitNetWorkerStatus, type BitNetPoolWorker, type BitNetPoolOptions, type BitNetPoolHandle, type BitNetClientOptions, type BitNetCallResult, } from "./types.js";
 export { NativeInference, getNativeInference, isNativeInferenceEnabled, buildNativePrompt, parseNativeOutput, type NativeInferenceConfig, type InferenceResult, } from "./native_inference.js";
-export { LlamaServerManager, getServerManager, isServerModeEnabled, ensureServerRunning, type LlamaServerConfig, type ServerStatus, type CompletionRequest, type CompletionResponse, } from "./server_manager.js";
+export { LlamaServerManager, getServerManager, ensureServerRunning, type BitNetConfig, type ServerStatus, type CompletionRequest, type CompletionResponse, } from "./server_manager.js";
 export { startBitNetWorkerIfEnabled, shutdownBitNetWorker, isBitNetWorkerStandaloneEnabled, isBitNetWorkerRunning, getBitNetWorkerHandle, } from "./autostart.js";
 export { startBitNetPoolIfEnabled, shutdownBitNetPool, isBitNetPoolRunning, isBitNetPoolAvailable, getBitNetPool, } from "./pool-autostart.js";
 export { startLlamaServerIfEnabled, shutdownLlamaServer, isLlamaServerEnabled, isLlamaServerRunning, isLlamaServerAvailable, getLlamaServerManager, } from "./server-autostart.js";

package/build/bitnet-worker/index.js

@@ -20,7 +20,7 @@ export { BITNET_ENV_VARS, isBitNetWorkerEnabled, isBitNetPoolEnabled as isPoolEn
 // Native inference (optional, for optimized performance)
 export { NativeInference, getNativeInference, isNativeInferenceEnabled, buildNativePrompt, parseNativeOutput, } from "./native_inference.js";
 // LlamaServer daemon mode (optional, eliminates cold start)
-export { LlamaServerManager, getServerManager, isServerModeEnabled, ensureServerRunning, } from "./server_manager.js";
+export { LlamaServerManager, getServerManager, ensureServerRunning, } from "./server_manager.js";
 // Autostart modules (lifecycle management)
 export { startBitNetWorkerIfEnabled, shutdownBitNetWorker, isBitNetWorkerStandaloneEnabled, isBitNetWorkerRunning, getBitNetWorkerHandle, } from "./autostart.js";
 export { startBitNetPoolIfEnabled, shutdownBitNetPool, isBitNetPoolRunning, isBitNetPoolAvailable, getBitNetPool, } from "./pool-autostart.js";

package/build/bitnet-worker/native_inference.d.ts

@@ -20,7 +20,7 @@
  *
  * @module bitnet-worker/native_inference
  */
-import { EventEmitter } from "node:events";
+import { EventEmitter } from 'node:events';
 export interface NativeInferenceConfig {
     /** Path to bitnet CLI binary */
     binaryPath: string;