@vibecodetown/mcp-server 1.3.1

package/build/deps/pm-detect.js

@@ -0,0 +1,213 @@
+/**
+ * Package Manager Detection Module
+ *
+ * Detects npm/pnpm/yarn based on:
+ * 1. packageManager field in package.json (highest priority)
+ * 2. Lockfile presence (pnpm-lock.yaml > yarn.lock > package-lock.json)
+ * 3. Default: npm
+ */
+import { existsSync, readFileSync } from 'fs';
+import { join } from 'path';
+// ============================================================================
+// Constants
+// ============================================================================
+const LOCKFILES = {
+    npm: 'package-lock.json',
+    pnpm: 'pnpm-lock.yaml',
+    yarn: 'yarn.lock',
+};
+/**
+ * Command mapping for each package manager
+ * SSOT: PM_COMMANDS_SSOT.json
+ */
+export const PM_COMMANDS = {
+    install: {
+        npm: 'npm install',
+        pnpm: 'pnpm install',
+        yarn: 'yarn install',
+    },
+    install_frozen: {
+        npm: 'npm ci',
+        pnpm: 'pnpm install --frozen-lockfile',
+        yarn: 'yarn install --frozen-lockfile',
+    },
+    update: {
+        npm: 'npm update',
+        pnpm: 'pnpm update',
+        yarn: 'yarn upgrade',
+    },
+    prune: {
+        npm: 'npm prune',
+        pnpm: 'pnpm prune',
+        yarn: 'yarn autoclean --force',
+    },
+    outdated: {
+        npm: 'npm outdated --json',
+        pnpm: 'pnpm outdated --json',
+        yarn: 'yarn outdated --json',
+    },
+    list: {
+        npm: 'npm ls --all --json',
+        pnpm: 'pnpm ls --json',
+        yarn: 'yarn list --json',
+    },
+    run: {
+        npm: 'npm run',
+        pnpm: 'pnpm run',
+        yarn: 'yarn run',
+    },
+    test: {
+        npm: 'npm test',
+        pnpm: 'pnpm test',
+        yarn: 'yarn test',
+    },
+    exec: {
+        npm: 'npx',
+        pnpm: 'pnpm exec',
+        yarn: 'yarn exec',
+    },
+};
+// ============================================================================
+// Detection Functions
+// ============================================================================
+/**
+ * Read and parse package.json from project root
+ */
+function readPackageJson(projectRoot) {
+    const pkgPath = join(projectRoot, 'package.json');
+    if (!existsSync(pkgPath)) {
+        return null;
+    }
+    try {
+        const content = readFileSync(pkgPath, 'utf-8');
+        return JSON.parse(content);
+    }
+    catch {
+        return null;
+    }
+}
+/**
+ * Get list of existing lockfiles in project
+ */
+export function getLockfiles(projectRoot) {
+    const found = [];
+    for (const [, lockfile] of Object.entries(LOCKFILES)) {
+        if (existsSync(join(projectRoot, lockfile))) {
+            found.push(lockfile);
+        }
+    }
+    return found;
+}
+/**
+ * Extract PM name from packageManager field
+ * e.g., "pnpm@9.1.0" -> "pnpm"
+ */
+function parsePackageManagerField(field) {
+    const match = field.match(/^(npm|pnpm|yarn)(@|$)/);
+    if (match) {
+        return match[1];
+    }
+    return null;
+}
+/**
+ * Detect package manager from lockfile
+ */
+function detectFromLockfile(lockfiles) {
+    // Priority: pnpm > yarn > npm
+    if (lockfiles.includes('pnpm-lock.yaml'))
+        return 'pnpm';
+    if (lockfiles.includes('yarn.lock'))
+        return 'yarn';
+    if (lockfiles.includes('package-lock.json'))
+        return 'npm';
+    return null;
+}
+/**
+ * Main detection function
+ */
+export function detectPackageManager(projectRoot) {
+    const pkg = readPackageJson(projectRoot);
+    const lockfiles = getLockfiles(projectRoot);
+    // 1. Check packageManager field (highest priority)
+    if (pkg?.packageManager && typeof pkg.packageManager === 'string') {
+        const pm = parsePackageManagerField(pkg.packageManager);
+        if (pm) {
+            return {
+                detected: pm,
+                source: 'packageManager',
+                confidence: 'high',
+                packageManagerField: pkg.packageManager,
+                lockfiles,
+            };
+        }
+    }
+    // 2. Check lockfiles
+    const fromLockfile = detectFromLockfile(lockfiles);
+    if (fromLockfile) {
+        return {
+            detected: fromLockfile,
+            source: 'lockfile',
+            confidence: 'high',
+            lockfiles,
+        };
+    }
+    // 3. Default to npm
+    return {
+        detected: 'npm',
+        source: 'default',
+        confidence: 'low',
+        lockfiles,
+    };
+}
+/**
+ * Check for lockfile conflicts
+ */
+export function checkLockfileConflict(projectRoot) {
+    const lockfiles = getLockfiles(projectRoot);
+    if (lockfiles.length > 1) {
+        return {
+            conflict: true,
+            files: lockfiles,
+            verdict: 'BLOCK',
+        };
+    }
+    return {
+        conflict: false,
+        files: lockfiles,
+        verdict: 'GO',
+    };
+}
+/**
+ * Validate that detected PM matches packageManager field
+ */
+export function validatePmMatch(projectRoot, actualPm) {
+    const pkg = readPackageJson(projectRoot);
+    if (!pkg?.packageManager || typeof pkg.packageManager !== 'string') {
+        // No packageManager field, any PM is OK
+        return { matches: true, verdict: 'GO' };
+    }
+    const expectedPm = parsePackageManagerField(pkg.packageManager);
+    if (!expectedPm) {
+        return { matches: true, verdict: 'GO' };
+    }
+    if (expectedPm !== actualPm) {
+        return {
+            matches: false,
+            expected: expectedPm,
+            verdict: 'BLOCK',
+        };
+    }
+    return { matches: true, verdict: 'GO' };
+}
+/**
+ * Get the command for a specific operation
+ */
+export function getCommand(operation, pm) {
+    return PM_COMMANDS[operation]?.[pm] ?? PM_COMMANDS[operation]?.npm ?? '';
+}
+/**
+ * Get lockfile name for a package manager
+ */
+export function getLockfileName(pm) {
+    return LOCKFILES[pm];
+}

package/build/deps/types.d.ts

@@ -0,0 +1,84 @@
+/**
+ * Dependency Management Types
+ */
+export type Verdict = 'GO' | 'FIX' | 'BLOCK';
+export interface VerdictResult {
+    verdict: Verdict;
+    reason?: string;
+    warning?: string;
+    failed_step?: string;
+    failed_gate?: string;
+}
+export type VerifyStepName = 'test' | 'typecheck' | 'lint';
+export type VerifyStatus = 'PASS' | 'FAIL' | 'SKIP';
+export interface VerifyStep {
+    name: VerifyStepName;
+    command?: string;
+    executed: boolean;
+    exit_code?: number;
+    status?: VerifyStatus;
+    duration_ms?: number;
+    log_file?: string;
+}
+export interface VerificationResult {
+    steps: VerifyStep[];
+    verdict: Verdict;
+    warning?: string;
+}
+export interface VersionCheck {
+    current: string;
+    required?: string;
+    satisfies: boolean;
+    severity?: 'major' | 'minor' | 'patch';
+}
+export interface EnvCheckResult {
+    node: VersionCheck;
+    packageManager: {
+        name: string;
+        current: string;
+        required?: string;
+        satisfies: boolean;
+    };
+    pmMatch: {
+        expected?: string;
+        actual: string;
+        matches: boolean;
+    };
+    verdict: Verdict;
+    recommendation?: string;
+}
+export type DriftRuleId = 'MANIFEST_LOCKFILE_SYNC' | 'PM_LOCKFILE_MATCH' | 'SINGLE_LOCKFILE';
+export interface DriftViolation {
+    rule: DriftRuleId;
+    message: string;
+    files?: string[];
+    verdict: Verdict;
+}
+export interface DriftCheckResult {
+    violations: DriftViolation[];
+    verdict: Verdict;
+    context: {
+        changedFiles: string[];
+        lockfiles: string[];
+        packageManager: {
+            detected: string;
+            source: string;
+        };
+    };
+    recommendation?: string;
+}
+export interface UpdateSummary {
+    packages_updated: number;
+    verification: VerificationResult;
+    verdict: Verdict;
+    evidence_path: string;
+}
+export interface DepsEvidence {
+    run_id: string;
+    timestamp: string;
+    verdict: Verdict;
+    env_check?: EnvCheckResult;
+    drift_check?: DriftCheckResult;
+    update_summary?: UpdateSummary;
+    verification?: VerificationResult;
+}

package/build/deps/types.js

@@ -0,0 +1,4 @@
+/**
+ * Dependency Management Types
+ */
+export {};

package/build/deps/ux-renderer.d.ts

@@ -0,0 +1,102 @@
+/**
+ * UX Renderer Module
+ *
+ * Transforms internal engine states to user-friendly messages.
+ * Implements Template ID system for consistent UI messaging.
+ *
+ * Key principle: "blocked by #2" is good for engine, bad for user UX.
+ * User sees: "WAITING" / "FIX_REQUIRED" / "READY" instead.
+ */
+import type { Verdict, VerifyStep, EnvCheckResult, DriftCheckResult } from './types.js';
+/**
+ * Template IDs for consistent messaging across all tools
+ */
+export type TemplateId = 'STATUS_READY' | 'STATUS_WAITING' | 'STATUS_IN_PROGRESS' | 'STATUS_COMPLETED' | 'STATUS_FAILED' | 'VERDICT_GO' | 'VERDICT_FIX' | 'VERDICT_BLOCK' | 'STEP_PASS' | 'STEP_FAIL' | 'STEP_SKIP' | 'STEP_WAITING' | 'ACTION_INSTALL' | 'ACTION_UPDATE' | 'ACTION_FIX' | 'ACTION_RETRY' | 'ERROR_ENV_MISMATCH' | 'ERROR_PM_NOT_INSTALLED' | 'ERROR_LOCKFILE_CONFLICT' | 'ERROR_DRIFT_DETECTED';
+/**
+ * User-facing status (translated from internal states)
+ */
+export type UserStatus = 'READY' | 'WAITING' | 'RUNNING' | 'DONE' | 'FIX_NEEDED' | 'BLOCKED';
+/**
+ * Unified tool status output (vibe_tool_status.schema.json)
+ */
+export interface ToolStatus {
+    /** Tool name */
+    tool: string;
+    /** User-facing status */
+    status: UserStatus;
+    /** Template ID for rendering */
+    template_id: TemplateId;
+    /** Verdict (GO/FIX/BLOCK) */
+    verdict: Verdict;
+    /** Human-readable summary */
+    summary: string;
+    /** Detailed items */
+    items?: ToolStatusItem[];
+    /** Recommended next action */
+    next_action?: {
+        template_id: TemplateId;
+        command?: string;
+        description: string;
+    };
+    /** Dependencies (for pipeline display) */
+    depends_on?: string[];
+    /** Is this blocking other steps? */
+    blocks?: string[];
+}
+export interface ToolStatusItem {
+    /** Item name */
+    name: string;
+    /** Item status */
+    status: 'pass' | 'fail' | 'skip' | 'waiting';
+    /** Template ID for this item */
+    template_id: TemplateId;
+    /** Additional details */
+    details?: string;
+    /** Duration in ms (if applicable) */
+    duration_ms?: number;
+}
+/**
+ * Get template by ID
+ */
+export declare function getTemplate(id: TemplateId, lang?: 'ko' | 'en'): {
+    icon: string;
+    label: string;
+    description?: string;
+};
+/**
+ * Translate verdict to template ID
+ */
+export declare function verdictToTemplateId(verdict: Verdict): TemplateId;
+/**
+ * Translate verdict to user status
+ */
+export declare function verdictToUserStatus(verdict: Verdict): UserStatus;
+/**
+ * Translate verify step status to template ID
+ */
+export declare function verifyStatusToTemplateId(status: 'PASS' | 'FAIL' | 'SKIP' | undefined): TemplateId;
+/**
+ * Translate blocked_by array to user status
+ * Key UX improvement: "blocked by #2" → "WAITING"
+ */
+export declare function blockedByToUserStatus(blockedBy?: string[]): UserStatus;
+/**
+ * Build ToolStatus from EnvCheckResult
+ */
+export declare function buildEnvCheckStatus(result: EnvCheckResult): ToolStatus;
+/**
+ * Build ToolStatus from DriftCheckResult
+ */
+export declare function buildDriftCheckStatus(result: DriftCheckResult): ToolStatus;
+/**
+ * Build ToolStatus from verification steps
+ */
+export declare function buildVerificationStatus(steps: VerifyStep[], verdict: Verdict, warning?: string): ToolStatus;
+/**
+ * Render ToolStatus to CLI lines
+ */
+export declare function renderToolStatus(status: ToolStatus, lang?: 'ko' | 'en'): string[];
+/**
+ * Render pipeline status (multiple tools with dependencies)
+ */
+export declare function renderPipelineStatus(statuses: ToolStatus[], lang?: 'ko' | 'en'): string[];