@vibecodetown/mcp-server 1.3.1

package/build/mcp/bootstrap/lock.d.ts

@@ -0,0 +1,5 @@
+/**
+ * Execute function with exclusive file lock
+ * Prevents multiple MCP tool calls from racing on installation
+ */
+export declare function withLock<T>(lockPath: string, fn: () => Promise<T>): Promise<T>;

package/build/mcp/bootstrap/lock.js

@@ -0,0 +1,37 @@
+// adapters/mcp-ts/src/bootstrap/lock.ts
+// Process lock to prevent concurrent installation
+import fs from "node:fs";
+import path from "node:path";
+/**
+ * Execute function with exclusive file lock
+ * Prevents multiple MCP tool calls from racing on installation
+ */
+export async function withLock(lockPath, fn) {
+    await fs.promises.mkdir(path.dirname(lockPath), { recursive: true });
+    // Best-effort exclusive lock (cross-platform)
+    const handle = await fs.promises.open(lockPath, "wx").catch(() => null);
+    if (!handle) {
+        // Another process holds the lock - wait and retry
+        for (let i = 0; i < 80; i++) {
+            await new Promise((r) => setTimeout(r, 250));
+            const h2 = await fs.promises.open(lockPath, "wx").catch(() => null);
+            if (h2) {
+                try {
+                    return await fn();
+                }
+                finally {
+                    await h2.close().catch(() => { });
+                    await fs.promises.unlink(lockPath).catch(() => { });
+                }
+            }
+        }
+        throw new Error("lock_timeout");
+    }
+    try {
+        return await fn();
+    }
+    finally {
+        await handle.close().catch(() => { });
+        await fs.promises.unlink(lockPath).catch(() => { });
+    }
+}

package/build/mcp/bootstrap/platform.d.ts

@@ -0,0 +1,9 @@
+export type Platform = "linux_x64" | "linux_arm64" | "darwin_x64" | "darwin_arm64" | "win_x64";
+/**
+ * Detect current platform for asset download
+ */
+export declare function detectPlatform(): Platform;
+/**
+ * Get executable name with platform-specific extension
+ */
+export declare function exeName(base: string): string;

package/build/mcp/bootstrap/platform.js

@@ -0,0 +1,26 @@
+// adapters/mcp-ts/src/bootstrap/platform.ts
+// Platform detection and executable naming
+/**
+ * Detect current platform for asset download
+ */
+export function detectPlatform() {
+    const p = process.platform;
+    const a = process.arch;
+    if (p === "win32")
+        return "win_x64"; // win arm64 out of scope for v1
+    if (p === "darwin") {
+        if (a === "arm64")
+            return "darwin_arm64";
+        return "darwin_x64";
+    }
+    // linux
+    if (a === "arm64")
+        return "linux_arm64";
+    return "linux_x64";
+}
+/**
+ * Get executable name with platform-specific extension
+ */
+export function exeName(base) {
+    return process.platform === "win32" ? `${base}.exe` : base;
+}

package/build/mcp/bootstrap/registry.d.ts

@@ -0,0 +1,46 @@
+export type EngineName = "spec-high" | "clinic" | "vpm-back" | "vibecoding-helper";
+export type EngineSpec = {
+    name: EngineName;
+    version: string;
+    repo: string;
+    assetPrefix: string;
+    shaSumsAsset: string;
+};
+/**
+ * Engine Registry (SSOT)
+ *
+ * VERSION_MATRIX.md와 동기화 필수.
+ * 여기 버전을 바꾸면 원클릭 설치 대상이 바뀐다.
+ */
+export declare const ENGINE_SPECS: Record<EngineName, EngineSpec>;
+/**
+ * Asset naming convention:
+ * {assetPrefix}_{version}_{platform}.tar.gz
+ *
+ * Example: spec-high_1.0.0_linux_x64.tar.gz
+ */
+export interface SkillMeta {
+    id: string;
+    file: string;
+    version: string;
+    description: string;
+    tags: string[];
+    sha256: string;
+}
+export interface SkillsIndex {
+    version: string;
+    skills: SkillMeta[];
+    created_at: string;
+}
+export interface SkillSpec {
+    version: string;
+    bundlePath: string;
+}
+/**
+ * Skill Bundle Specification (SSOT)
+ *
+ * 스킬 파일은 npm 패키지의 skills/ 디렉토리에 prebundled로 포함됨.
+ * - 오프라인 지원
+ * - CLI 버전과 스킬 버전 동기화 자동 보장
+ */
+export declare const SKILL_SPEC: SkillSpec;

package/build/mcp/bootstrap/registry.js

@@ -0,0 +1,49 @@
+// adapters/mcp-ts/src/bootstrap/registry.ts
+// SSOT: Engine versions and release asset naming
+/**
+ * Engine Registry (SSOT)
+ *
+ * VERSION_MATRIX.md와 동기화 필수.
+ * 여기 버전을 바꾸면 원클릭 설치 대상이 바뀐다.
+ */
+export const ENGINE_SPECS = {
+    "spec-high": {
+        name: "spec-high",
+        version: "1.0.0",
+        repo: "yellowhama/vibe-pm",
+        assetPrefix: "spec-high",
+        shaSumsAsset: "SHA256SUMS.txt"
+    },
+    "clinic": {
+        name: "clinic",
+        version: "2.3.0",
+        repo: "yellowhama/vibe-pm",
+        assetPrefix: "clinic",
+        shaSumsAsset: "SHA256SUMS.txt"
+    },
+    "vpm-back": {
+        name: "vpm-back",
+        version: "0.3.0", // Includes delta-scan command for Always-On Observer
+        repo: "yellowhama/vibe-pm",
+        assetPrefix: "vpm-back",
+        shaSumsAsset: "SHA256SUMS.txt"
+    },
+    "vibecoding-helper": {
+        name: "vibecoding-helper",
+        version: "0.1.0", // Initial helper release (Python execution, static analysis)
+        repo: "yellowhama/vibe-pm",
+        assetPrefix: "vibecoding-helper",
+        shaSumsAsset: "SHA256SUMS.txt"
+    }
+};
+/**
+ * Skill Bundle Specification (SSOT)
+ *
+ * 스킬 파일은 npm 패키지의 skills/ 디렉토리에 prebundled로 포함됨.
+ * - 오프라인 지원
+ * - CLI 버전과 스킬 버전 동기화 자동 보장
+ */
+export const SKILL_SPEC = {
+    version: "1.0.0",
+    bundlePath: "skills" // adapters/mcp-ts/skills/ (패키지 루트 기준)
+};

package/build/mcp/bootstrap/skills-installer.d.ts

@@ -0,0 +1,154 @@
+import { type SkillMeta, type SkillsIndex } from "./registry.js";
+export type SkillStatus = "ok" | "missing" | "sha_mismatch" | "index_invalid";
+export interface SkillHealth {
+    id: string;
+    status: SkillStatus;
+    version: string | null;
+    path: string | null;
+    error?: string;
+}
+export interface SkillsHealth {
+    installed: boolean;
+    bundlePath: string | null;
+    version: string | null;
+    skills: SkillHealth[];
+    summary: {
+        total: number;
+        ok: number;
+        missing: number;
+        corrupted: number;
+    };
+}
+export interface ActivatedSkillsIndex {
+    version: string;
+    activated: string[];
+    activated_at: string;
+    source: "prebundled";
+    skills: SkillMeta[];
+}
+/**
+ * Get the path to the prebundled skills directory in the npm package
+ */
+export declare function getSkillsBundlePath(): string | null;
+/**
+ * Get the path to the project's .vibe/skills/ directory
+ */
+export declare function getProjectSkillsPath(projectRoot?: string): string;
+/**
+ * Load the skills index from the prebundled directory
+ */
+export declare function loadSkillsIndex(): SkillsIndex | null;
+/**
+ * Load the activated skills index from the project
+ */
+export declare function loadActivatedSkillsIndex(projectRoot?: string): ActivatedSkillsIndex | null;
+/**
+ * Check health of the entire skills bundle
+ */
+export declare function getSkillsHealth(): SkillsHealth;
+/**
+ * List all available skills from the prebundled directory
+ */
+export declare function listAvailableSkills(): SkillMeta[];
+/**
+ * List activated skills in the project
+ */
+export declare function listActivatedSkills(projectRoot?: string): string[];
+/**
+ * Get skill metadata by ID
+ */
+export declare function getSkillById(skillId: string): SkillMeta | null;
+/**
+ * Activate skills for a project by copying them to .vibe/skills/
+ */
+export declare function activateSkills(projectRoot: string, skillIds?: string[]): Promise<{
+    activated: string[];
+    errors: string[];
+}>;
+/**
+ * Deactivate a skill from the project
+ */
+export declare function deactivateSkill(projectRoot: string, skillId: string): Promise<{
+    success: boolean;
+    error?: string;
+}>;
+/**
+ * Ensure skills are installed and healthy
+ * Returns the bundle path if successful
+ */
+export declare function ensureSkills(): {
+    path: string | null;
+    health: SkillsHealth;
+};
+/**
+ * Get skill content by ID
+ */
+export declare function getSkillContent(skillId: string): string | null;
+export interface SkillpackMeta {
+    id: string;
+    version: string;
+    title: string;
+    description: string;
+    skillCount: number;
+}
+export interface SkillpackHealth {
+    id: string;
+    status: SkillStatus;
+    version: string | null;
+    path: string | null;
+    skillCount: number;
+    error?: string;
+}
+export interface SkillpacksHealth {
+    installed: boolean;
+    bundlePath: string | null;
+    packs: SkillpackHealth[];
+    summary: {
+        total: number;
+        ok: number;
+        missing: number;
+        corrupted: number;
+    };
+}
+/**
+ * Get the path to the prebundled skillpacks directory in the npm package
+ */
+export declare function getSkillpacksBundlePath(): string | null;
+/**
+ * Get the path to the project's .vibe/skills_packs/ directory
+ */
+export declare function getProjectSkillpacksPath(projectRoot?: string): string;
+/**
+ * Get the path to the global ~/.vibe-pm/skills_packs/ directory
+ */
+export declare function getGlobalSkillpacksPath(): string;
+/**
+ * List available skillpacks from the bundle
+ */
+export declare function listBundledSkillpacks(): SkillpackMeta[];
+/**
+ * Get health of all bundled skillpacks
+ */
+export declare function getSkillpacksHealth(): SkillpacksHealth;
+/**
+ * Install (copy) skillpacks to the project directory
+ */
+export declare function installSkillpacksToProject(projectRoot: string, packIds?: string[]): Promise<{
+    installed: string[];
+    errors: string[];
+}>;
+/**
+ * Remove a skillpack from the project
+ */
+export declare function removeSkillpackFromProject(projectRoot: string, packId: string): Promise<{
+    success: boolean;
+    error?: string;
+}>;
+/**
+ * Ensure skillpacks are ready (for vibe setup)
+ * Returns health status without automatically copying
+ */
+export declare function ensureSkillpacks(): {
+    bundlePath: string | null;
+    health: SkillpacksHealth;
+};