@vibecodetown/mcp-server 1.3.1 → 1.5.0

package/templates/agents/worker-agent/src/main.rs

@@ -0,0 +1,120 @@
+//! {{DISPLAY_NAME}} — Worker Agent
+//! {{DESCRIPTION}}
+
+use serde::{Deserialize, Serialize};
+use tracing::{info, warn, Level};
+use tracing_subscriber::FmtSubscriber;
+
+#[derive(Debug, Serialize, Deserialize)]
+struct Task {
+    id: String,
+    action: String,
+    params: serde_json::Value,
+}
+
+#[derive(Debug, Serialize, Deserialize)]
+struct TaskResult {
+    task_id: String,
+    status: TaskStatus,
+    output: serde_json::Value,
+}
+
+#[derive(Debug, Serialize, Deserialize)]
+#[serde(rename_all = "snake_case")]
+enum TaskStatus {
+    Completed,
+    Failed,
+    Skipped,
+}
+
+async fn process_task(task: &Task) -> TaskResult {
+    info!(task_id = %task.id, action = %task.action, "Processing task");
+
+    // Dispatch by action type
+    let (status, output) = match task.action.as_str() {
+        "health" => (
+            TaskStatus::Completed,
+            serde_json::json!({"agent": "{{AGENT_ID}}", "status": "ok"}),
+        ),
+        "echo" => (TaskStatus::Completed, task.params.clone()),
+        unknown => {
+            warn!(action = unknown, "Unknown action");
+            (
+                TaskStatus::Skipped,
+                serde_json::json!({"error": format!("unknown action: {unknown}")}),
+            )
+        }
+    };
+
+    TaskResult {
+        task_id: task.id.clone(),
+        status,
+        output,
+    }
+}
+
+#[tokio::main]
+async fn main() -> anyhow::Result<()> {
+    let subscriber = FmtSubscriber::builder()
+        .with_max_level(Level::INFO)
+        .finish();
+    tracing::subscriber::set_global_default(subscriber)?;
+
+    info!("{{DISPLAY_NAME}} worker starting...");
+
+    // Main poll loop
+    loop {
+        tokio::select! {
+            _ = tokio::signal::ctrl_c() => {
+                info!("Shutting down...");
+                break;
+            }
+            _ = tokio::time::sleep(std::time::Duration::from_secs(5)) => {
+                info!("Polling for tasks...");
+                // In production: poll gateway/queue for tasks
+                // For now: idle loop demonstrating the pattern
+            }
+        }
+    }
+
+    Ok(())
+}
+
+#[cfg(test)]
+mod tests {
+    use super::*;
+
+    #[tokio::test]
+    async fn health_action_returns_ok() {
+        let task = Task {
+            id: "test-1".into(),
+            action: "health".into(),
+            params: serde_json::Value::Null,
+        };
+        let result = process_task(&task).await;
+        assert!(matches!(result.status, TaskStatus::Completed));
+    }
+
+    #[tokio::test]
+    async fn echo_action_returns_params() {
+        let task = Task {
+            id: "test-2".into(),
+            action: "echo".into(),
+            params: serde_json::json!({"hello": "world"}),
+        };
+        let result = process_task(&task).await;
+        assert!(matches!(result.status, TaskStatus::Completed));
+        assert_eq!(result.output, serde_json::json!({"hello": "world"}));
+    }
+
+    #[tokio::test]
+    async fn unknown_action_is_skipped() {
+        let task = Task {
+            id: "test-3".into(),
+            action: "nonexistent".into(),
+            params: serde_json::Value::Null,
+        };
+        let result = process_task(&task).await;
+        assert!(matches!(result.status, TaskStatus::Skipped));
+    }
+}

package/templates/docs-structure/README.md

@@ -1,41 +1,41 @@
-# Docs Structure Template
-
-This template provides the standard docs folder structure for Vibe PM projects.
-
-## Usage
-
-Run `vibe_pm.init_docs` to automatically create this structure in your project:
-
-```json
-{
-  "workspace_path": "/path/to/your/project"
-}
-```
-
-Or let it use the current working directory:
-
-```json
-{}
-```
-
-## Structure
-
-```
-docs/
-├── active/              # Current work in progress
-├── reference/           # Permanent reference (SSOT)
-│   ├── ssot/           # Operating rules
-│   ├── product-spec/   # Product definitions
-│   └── contracts/      # Engine/partnership contracts
-├── archived/            # Completed/deprecated
-│   ├── legacy/         # Old documents
-│   └── topics/         # Inactive topics
-├── INDEX.md            # Master index
-└── CLAUDE.md           # AI agent operating rules
-```
-
-## Workflow
-
-1. **New work**: Create in `active/<topic>/`
-2. **Complete**: Move to `archived/YYYY-MM/`
-3. **Reference changes**: Update in `reference/` with version bump
+# Docs Structure Template
+
+This template provides the standard docs folder structure for Vibe PM projects.
+
+## Usage
+
+Run `vibe_pm.init_docs` to automatically create this structure in your project:
+
+```json
+{
+  "workspace_path": "/path/to/your/project"
+}
+```
+
+Or let it use the current working directory:
+
+```json
+{}
+```
+
+## Structure
+
+```
+docs/
+├── active/              # Current work in progress
+├── reference/           # Permanent reference (SSOT)
+│   ├── ssot/           # Operating rules
+│   ├── product-spec/   # Product definitions
+│   └── contracts/      # Engine/partnership contracts
+├── archived/            # Completed/deprecated
+│   ├── legacy/         # Old documents
+│   └── topics/         # Inactive topics
+├── INDEX.md            # Master index
+└── CLAUDE.md           # AI agent operating rules
+```
+
+## Workflow
+
+1. **New work**: Create in `active/<topic>/`
+2. **Complete**: Move to `archived/YYYY-MM/`
+3. **Reference changes**: Update in `reference/` with version bump

package/build/dashboard/autostart.d.ts

@@ -1,45 +0,0 @@
-/**
- * Dashboard Autostart
- * ===================
- *
- * Singleton autostart module for local Dashboard server.
- * Provides sync packet receiving and statistics API.
- *
- * Environment:
- *   VIBE_DASHBOARD=1              - Enable Dashboard server
- *   VIBE_DASHBOARD_PORT=8787      - Server port (default: 8787)
- *   VIBE_DASHBOARD_HOST=127.0.0.1 - Server host
- *   VIBE_DASHBOARD_DIR=<path>     - Storage directory
- *   VIBE_CLOUD_SYNC_TOKEN=<token> - Auth token (optional)
- *
- * @module dashboard/autostart
- */
-import { type DashboardServerHandle } from "./server.js";
-/**
- * Check if Dashboard server is enabled.
- */
-export declare function isDashboardEnabled(): boolean;
-/**
- * Start Dashboard server if enabled via environment variable.
- * Safe to call multiple times (singleton pattern).
- *
- * @returns Server handle if started, null if disabled or already running
- */
-export declare function startDashboardIfEnabled(): Promise<DashboardServerHandle | null>;
-/**
- * Shutdown Dashboard server if running.
- * Safe to call multiple times.
- */
-export declare function shutdownDashboard(): Promise<void>;
-/**
- * Get the current server handle (if running).
- */
-export declare function getDashboardHandle(): DashboardServerHandle | null;
-/**
- * Check if Dashboard server is currently running.
- */
-export declare function isDashboardRunning(): boolean;
-/**
- * Get the Dashboard server URL (if running).
- */
-export declare function getDashboardUrl(): string | null;

package/build/dashboard/autostart.js

@@ -1,121 +0,0 @@
-/**
- * Dashboard Autostart
- * ===================
- *
- * Singleton autostart module for local Dashboard server.
- * Provides sync packet receiving and statistics API.
- *
- * Environment:
- *   VIBE_DASHBOARD=1              - Enable Dashboard server
- *   VIBE_DASHBOARD_PORT=8787      - Server port (default: 8787)
- *   VIBE_DASHBOARD_HOST=127.0.0.1 - Server host
- *   VIBE_DASHBOARD_DIR=<path>     - Storage directory
- *   VIBE_CLOUD_SYNC_TOKEN=<token> - Auth token (optional)
- *
- * @module dashboard/autostart
- */
-import { startDashboardServer } from "./server.js";
-// ============================================================
-// Singleton State
-// ============================================================
-let _handle = null;
-let _startPromise = null;
-// ============================================================
-// Environment Helpers
-// ============================================================
-/**
- * Check if Dashboard server is enabled.
- */
-export function isDashboardEnabled() {
-    return process.env.VIBE_DASHBOARD === "1";
-}
-// ============================================================
-// Autostart Functions
-// ============================================================
-/**
- * Start Dashboard server if enabled via environment variable.
- * Safe to call multiple times (singleton pattern).
- *
- * @returns Server handle if started, null if disabled or already running
- */
-export async function startDashboardIfEnabled() {
-    // Return existing handle if already started
-    if (_handle) {
-        return _handle;
-    }
-    // Return existing promise if startup in progress
-    if (_startPromise) {
-        return _startPromise;
-    }
-    // Check if enabled
-    if (!isDashboardEnabled()) {
-        return null;
-    }
-    // Start with deduplication
-    _startPromise = (async () => {
-        try {
-            const host = process.env.VIBE_DASHBOARD_HOST ?? "127.0.0.1";
-            const port = parseInt(process.env.VIBE_DASHBOARD_PORT ?? "8787", 10);
-            const storageDir = process.env.VIBE_DASHBOARD_DIR;
-            const authToken = process.env.VIBE_CLOUD_SYNC_TOKEN ?? null;
-            _handle = startDashboardServer({
-                host,
-                port,
-                storageDir,
-                authToken,
-                secretKey: authToken,
-            });
-            console.error(`[Dashboard] Started on ${_handle.url}`);
-            return _handle;
-        }
-        catch (e) {
-            console.error(`[Dashboard] Failed to start: ${e instanceof Error ? e.message : String(e)}`);
-            return null;
-        }
-        finally {
-            _startPromise = null;
-        }
-    })();
-    return _startPromise;
-}
-/**
- * Shutdown Dashboard server if running.
- * Safe to call multiple times.
- */
-export async function shutdownDashboard() {
-    // Wait for any pending startup
-    if (_startPromise) {
-        await _startPromise;
-    }
-    if (!_handle) {
-        return;
-    }
-    try {
-        await _handle.close();
-        console.error(`[Dashboard] Shutdown complete`);
-    }
-    catch (e) {
-        console.error(`[Dashboard] Shutdown error: ${e instanceof Error ? e.message : String(e)}`);
-    }
-    finally {
-        _handle = null;
-    }
-}
-/**
- * Get the current server handle (if running).
- */
-export function getDashboardHandle() {
-    return _handle;
-}
-/**
- * Check if Dashboard server is currently running.
- */
-export function isDashboardRunning() {
-    return _handle !== null;
-}
-/**
- * Get the Dashboard server URL (if running).
- */
-export function getDashboardUrl() {
-    return _handle?.url ?? null;
-}

package/build/mcp/paths.d.ts

@@ -1,29 +0,0 @@
-export type SpecMapPathSource = "vibe_config_dir" | "legacy_vibe_root";
-export declare function getVibeDir(workspaceRoot: string): string;
-export declare function getVibeConfigDir(workspaceRoot: string): string;
-export declare function getVibeCacheDir(workspaceRoot: string): string;
-export declare function getVibeChromaCacheDir(workspaceRoot: string): string;
-export declare function getVibeBitnetCacheDir(workspaceRoot: string): string;
-export declare function getBitnetTracePath(workspaceRoot: string): string;
-export declare function ensureDirSync(dirPath: string): void;
-export declare function resolveSpecMapPath(workspaceRoot: string): {
-    absPath: string;
-    source: SpecMapPathSource;
-};
-export declare function getPmRunsDir(workspaceRoot: string): string;
-export declare function getLegacyRunsDir(workspaceRoot: string): string;
-export declare function getEngineRunsDir(workspaceRoot: string): string;
-export declare function getEngineRunDir(workspaceRoot: string, runId: string): string;
-export declare function getPmRunDir(workspaceRoot: string, runId: string): string;
-/**
- * Resolve run directory for reading, checking multiple locations.
- * Priority order:
- *   1. .vibe/runs/<runId>           (PM 표준)
- *   2. engines/spec_high/runs/<runId> (엔진 출력)
- *   3. runs/<runId>                 (레거시)
- *
- * @param workspaceRoot - Workspace root path
- * @param runId - Run ID to resolve
- * @returns Resolved run directory path (may not exist)
- */
-export declare function resolvePmRunDirForRead(workspaceRoot: string, runId: string): string;

package/build/mcp/paths.js

@@ -1,90 +0,0 @@
-// Centralized storage paths SSOT for repo-local `.vibe/` layout.
-//
-// Goals:
-// - Prevent "random folder sprawl" by routing all system writes under `.vibe/`.
-// - Support gradual migration from legacy `runs/<run_id>/...` to `.vibe/runs/<run_id>/...`.
-// - Keep path computation in one place (no ad-hoc string joins).
-import * as fs from "node:fs";
-import * as path from "node:path";
-export function getVibeDir(workspaceRoot) {
-    return path.join(workspaceRoot, ".vibe");
-}
-export function getVibeConfigDir(workspaceRoot) {
-    return path.join(getVibeDir(workspaceRoot), "config");
-}
-export function getVibeCacheDir(workspaceRoot) {
-    return path.join(getVibeDir(workspaceRoot), "cache");
-}
-export function getVibeChromaCacheDir(workspaceRoot) {
-    // NOTE: This is a repo-local cache directory (not run-local).
-    return path.join(getVibeCacheDir(workspaceRoot), "chroma");
-}
-export function getVibeBitnetCacheDir(workspaceRoot) {
-    return path.join(getVibeCacheDir(workspaceRoot), "bitnet");
-}
-export function getBitnetTracePath(workspaceRoot) {
-    return path.join(getVibeBitnetCacheDir(workspaceRoot), "bitnet_traces.json");
-}
-export function ensureDirSync(dirPath) {
-    if (!fs.existsSync(dirPath))
-        fs.mkdirSync(dirPath, { recursive: true });
-}
-export function resolveSpecMapPath(workspaceRoot) {
-    const primary = path.join(getVibeConfigDir(workspaceRoot), "spec_map.v1.json");
-    if (fs.existsSync(primary))
-        return { absPath: primary, source: "vibe_config_dir" };
-    const legacy = path.join(getVibeDir(workspaceRoot), "spec_map.v1.json");
-    return { absPath: legacy, source: "legacy_vibe_root" };
-}
-export function getPmRunsDir(workspaceRoot) {
-    return path.join(getVibeDir(workspaceRoot), "runs");
-}
-export function getLegacyRunsDir(workspaceRoot) {
-    return path.join(workspaceRoot, "runs");
-}
-// ============================================================
-// Engine Paths (spec-high 엔진 출력 경로)
-// ============================================================
-export function getEngineRunsDir(workspaceRoot) {
-    return path.join(workspaceRoot, "engines", "spec_high", "runs");
-}
-export function getEngineRunDir(workspaceRoot, runId) {
-    return path.join(getEngineRunsDir(workspaceRoot), runId);
-}
-// ============================================================
-// Run Directory Resolution
-// ============================================================
-export function getPmRunDir(workspaceRoot, runId) {
-    return path.join(getPmRunsDir(workspaceRoot), runId);
-}
-/**
- * Resolve run directory for reading, checking multiple locations.
- * Priority order:
- *   1. .vibe/runs/<runId>           (PM 표준)
- *   2. engines/spec_high/runs/<runId> (엔진 출력)
- *   3. runs/<runId>                 (레거시)
- *
- * @param workspaceRoot - Workspace root path
- * @param runId - Run ID to resolve
- * @returns Resolved run directory path (may not exist)
- */
-export function resolvePmRunDirForRead(workspaceRoot, runId) {
-    // Skip engine path check if legacy-only mode is enabled
-    const legacyOnly = process.env.VIBE_LEGACY_PATH_ONLY === "1";
-    // 1. PM 표준 경로 (.vibe/runs/)
-    const pm = getPmRunDir(workspaceRoot, runId);
-    if (fs.existsSync(pm))
-        return pm;
-    // 2. 엔진 출력 경로 (engines/spec_high/runs/)
-    if (!legacyOnly) {
-        const engine = getEngineRunDir(workspaceRoot, runId);
-        if (fs.existsSync(engine))
-            return engine;
-    }
-    // 3. 레거시 경로 (runs/)
-    const legacy = path.join(getLegacyRunsDir(workspaceRoot), runId);
-    if (fs.existsSync(legacy))
-        return legacy;
-    // Default to target location (even if it doesn't exist yet)
-    return pm;
-}

package/build/mcp/runtime/musu_adapter.d.ts

@@ -1,193 +0,0 @@
-/**
- * Musu Adapter - MCP Integration for bitnet-musu Rust Engine
- * ===========================================================
- *
- * This module provides the MCP server integration with the musu binary:
- * - Process lifecycle management (start/stop)
- * - HTTP API communication for work submission
- * - Telemetry retrieval
- * - Health monitoring
- *
- * @since v1.6.0
- */
-/**
- * Job types supported by musu (Bee 4종 보직)
- */
-export type MusuJobType = 'semantic_grep' | 'sanity_check' | 'dependency_scan' | 'doc_draft';
-/**
- * Job priority levels
- */
-export type MusuPriority = 'low' | 'normal' | 'high';
-/**
- * Scope definition for work requests
- */
-export interface MusuScope {
-    workspace: string;
-    paths?: string[];
-    globs?: string[];
-    exclude_globs?: string[];
-    max_files?: number;
-    max_lines_per_file?: number;
-}
-/**
- * Work request to musu
- */
-export interface MusuWorkRequest {
-    job_id: string;
-    job_type: MusuJobType;
-    scope: MusuScope;
-    params?: Record<string, unknown>;
-    priority?: MusuPriority;
-    timeout_ms?: number;
-}
-/**
- * Job status from musu
- */
-export type MusuJobStatus = 'pending' | 'running' | 'completed' | 'failed' | 'cancelled';
-/**
- * Response metadata
- */
-export interface MusuResponseMeta {
-    files_scanned: number;
-    scope_hash: string;
-    job_params_hash: string;
-    started_at: string;
-    completed_at: string;
-    duration_ms: number;
-    tokens_used: number;
-    engine: string;
-    model: string;
-}
-/**
- * Response artifacts
- */
-export interface MusuArtifacts {
-    log_path?: string;
-    evidence_files: string[];
-    written_to: string[];
-}
-/**
- * Work response from musu
- */
-export interface MusuWorkResponse {
-    job_id: string;
-    job_type: MusuJobType;
-    status: MusuJobStatus;
-    result?: unknown;
-    cached: boolean;
-    duration_ms: number;
-    timestamp: string;
-    meta?: MusuResponseMeta;
-    artifacts?: MusuArtifacts;
-}
-/**
- * Health status
- */
-export interface MusuHealth {
-    status: 'ok' | 'degraded' | 'error';
-    version?: string;
-    mode?: string;
-    uptime_ms?: number;
-}
-/**
- * Telemetry data
- */
-export interface MusuTelemetry {
-    cpu_percent: number;
-    memory_percent: number;
-    active_jobs: number;
-    queued_jobs: number;
-    completed_jobs: number;
-    failed_jobs: number;
-}
-/**
- * Adapter status
- */
-export type MusuAdapterStatus = 'stopped' | 'starting' | 'running' | 'error';
-/**
- * Musu Adapter for MCP integration
- *
- * @example
- * ```typescript
- * const adapter = new MusuAdapter();
- *
- * // Start the musu process
- * await adapter.start();
- *
- * // Submit work
- * const response = await adapter.submitWork({
- *   job_id: "job-001",
- *   job_type: "semantic_grep",
- *   scope: { workspace: "/path/to/project" },
- *   params: { query: "authentication logic" },
- * });
- *
- * // Stop when done
- * await adapter.stop();
- * ```
- */
-export declare class MusuAdapter {
-    private process;
-    private port;
-    private baseUrl;
-    private status;
-    private binaryPath;
-    private startPromise;
-    constructor(port?: number);
-    /**
-     * Get current adapter status
-     */
-    getStatus(): MusuAdapterStatus;
-    /**
-     * Get binary path (for diagnostics)
-     */
-    getBinaryPath(): string | null;
-    /**
-     * Check if musu binary is available
-     */
-    isAvailable(): boolean;
-    /**
-     * Start the musu process in standalone mode
-     */
-    start(): Promise<void>;
-    /**
-     * Wait for the HTTP server to be ready
-     */
-    private waitForReady;
-    /**
-     * Stop the musu process
-     */
-    stop(): Promise<void>;
-    /**
-     * Check musu health
-     */
-    health(): Promise<MusuHealth>;
-    /**
-     * Submit work to musu
-     */
-    submitWork(request: MusuWorkRequest): Promise<MusuWorkResponse>;
-    /**
-     * Get telemetry data
-     */
-    getTelemetry(): Promise<MusuTelemetry>;
-}
-/**
- * Get the default Musu adapter instance
- */
-export declare function getMusuAdapter(port?: number): MusuAdapter;
-/**
- * Reset the default adapter (for testing)
- */
-export declare function resetMusuAdapter(): Promise<void>;
-/**
- * Check if musu is available
- */
-export declare function isMusuAvailable(): boolean;
-/**
- * Get musu binary path
- */
-export declare function getMusuBinaryPath(): string | null;
-/**
- * Quick work submission (auto-starts adapter if needed)
- */
-export declare function submitMusuWork(request: MusuWorkRequest): Promise<MusuWorkResponse>;