@vibecodetown/mcp-server 2.2.0 → 2.2.1

package/build/bootstrap/skills-installer.js

@@ -0,0 +1,365 @@
+// adapters/mcp-ts/src/bootstrap/skills-installer.ts
+// Skill bundle installation, activation, and health check
+// Skills are prebundled in the npm package (no network required)
+import fs from "node:fs";
+import path from "node:path";
+import crypto from "node:crypto";
+import { SKILL_SPEC } from "./registry.js";
+// ============================================================
+// Path Utilities
+// ============================================================
+/**
+ * Find package root by looking for package.json
+ */
+function findPackageRoot() {
+    // Start from current module's directory
+    let dir = path.dirname(new URL(import.meta.url).pathname);
+    // On Windows, remove leading slash from /C:/...
+    if (process.platform === "win32" && dir.startsWith("/")) {
+        dir = dir.slice(1);
+    }
+    for (let i = 0; i < 10; i++) {
+        const pkgPath = path.join(dir, "package.json");
+        try {
+            if (fs.existsSync(pkgPath)) {
+                return dir;
+            }
+        }
+        catch {
+            // ignore
+        }
+        const parent = path.dirname(dir);
+        if (parent === dir)
+            break;
+        dir = parent;
+    }
+    return null;
+}
+/**
+ * Get the path to the prebundled skills directory in the npm package
+ */
+export function getSkillsBundlePath() {
+    const pkgRoot = findPackageRoot();
+    if (!pkgRoot)
+        return null;
+    const skillsDir = path.join(pkgRoot, SKILL_SPEC.bundlePath);
+    try {
+        if (fs.existsSync(skillsDir) && fs.statSync(skillsDir).isDirectory()) {
+            return skillsDir;
+        }
+    }
+    catch {
+        // ignore
+    }
+    return null;
+}
+/**
+ * Get the path to the project's .vibe/skills/ directory
+ */
+export function getProjectSkillsPath(projectRoot) {
+    const root = projectRoot || process.cwd();
+    return path.join(root, ".vibe", "skills");
+}
+// ============================================================
+// Index Loading
+// ============================================================
+/**
+ * Load the skills index from the prebundled directory
+ */
+export function loadSkillsIndex() {
+    const bundlePath = getSkillsBundlePath();
+    if (!bundlePath)
+        return null;
+    const indexPath = path.join(bundlePath, "index.json");
+    try {
+        const content = fs.readFileSync(indexPath, "utf-8");
+        return JSON.parse(content);
+    }
+    catch {
+        return null;
+    }
+}
+/**
+ * Load the activated skills index from the project
+ */
+export function loadActivatedSkillsIndex(projectRoot) {
+    const skillsPath = getProjectSkillsPath(projectRoot);
+    const indexPath = path.join(skillsPath, "index.json");
+    try {
+        const content = fs.readFileSync(indexPath, "utf-8");
+        return JSON.parse(content);
+    }
+    catch {
+        return null;
+    }
+}
+// ============================================================
+// Health Check
+// ============================================================
+/**
+ * Calculate SHA256 hash of a file
+ */
+function calculateSha256(filePath) {
+    try {
+        const content = fs.readFileSync(filePath);
+        return crypto.createHash("sha256").update(content).digest("hex");
+    }
+    catch {
+        return null;
+    }
+}
+/**
+ * Check health of a single skill in the bundle
+ */
+function checkSkillHealth(bundlePath, skill) {
+    const filePath = path.join(bundlePath, skill.file);
+    if (!fs.existsSync(filePath)) {
+        return {
+            id: skill.id,
+            status: "missing",
+            version: skill.version,
+            path: null,
+            error: `Skill file not found: ${skill.file}`
+        };
+    }
+    const actualSha = calculateSha256(filePath);
+    if (!actualSha) {
+        return {
+            id: skill.id,
+            status: "sha_mismatch",
+            version: skill.version,
+            path: filePath,
+            error: "Failed to calculate SHA256"
+        };
+    }
+    if (actualSha !== skill.sha256) {
+        return {
+            id: skill.id,
+            status: "sha_mismatch",
+            version: skill.version,
+            path: filePath,
+            error: `SHA256 mismatch: expected ${skill.sha256}, got ${actualSha}`
+        };
+    }
+    return {
+        id: skill.id,
+        status: "ok",
+        version: skill.version,
+        path: filePath
+    };
+}
+/**
+ * Check health of the entire skills bundle
+ */
+export function getSkillsHealth() {
+    const bundlePath = getSkillsBundlePath();
+    if (!bundlePath) {
+        return {
+            installed: false,
+            bundlePath: null,
+            version: null,
+            skills: [],
+            summary: { total: 0, ok: 0, missing: 0, corrupted: 0 }
+        };
+    }
+    const index = loadSkillsIndex();
+    if (!index) {
+        return {
+            installed: true,
+            bundlePath,
+            version: null,
+            skills: [],
+            summary: { total: 0, ok: 0, missing: 0, corrupted: 0 }
+        };
+    }
+    const skills = index.skills.map(skill => checkSkillHealth(bundlePath, skill));
+    const summary = {
+        total: skills.length,
+        ok: skills.filter(s => s.status === "ok").length,
+        missing: skills.filter(s => s.status === "missing").length,
+        corrupted: skills.filter(s => s.status === "sha_mismatch").length
+    };
+    return {
+        installed: true,
+        bundlePath,
+        version: index.version,
+        skills,
+        summary
+    };
+}
+// ============================================================
+// Skill Listing
+// ============================================================
+/**
+ * List all available skills from the prebundled directory
+ */
+export function listAvailableSkills() {
+    const index = loadSkillsIndex();
+    return index?.skills ?? [];
+}
+/**
+ * List activated skills in the project
+ */
+export function listActivatedSkills(projectRoot) {
+    const index = loadActivatedSkillsIndex(projectRoot);
+    return index?.activated ?? [];
+}
+/**
+ * Get skill metadata by ID
+ */
+export function getSkillById(skillId) {
+    const skills = listAvailableSkills();
+    return skills.find(s => s.id === skillId) ?? null;
+}
+// ============================================================
+// Skill Activation
+// ============================================================
+/**
+ * Activate skills for a project by copying them to .vibe/skills/
+ */
+export async function activateSkills(projectRoot, skillIds) {
+    const bundlePath = getSkillsBundlePath();
+    if (!bundlePath) {
+        return { activated: [], errors: ["Skill bundle not found in package"] };
+    }
+    const index = loadSkillsIndex();
+    if (!index) {
+        return { activated: [], errors: ["Skills index not found or invalid"] };
+    }
+    // If no skillIds specified, activate all
+    const toActivate = skillIds ?? index.skills.map(s => s.id);
+    const skillsToActivate = toActivate
+        .map(id => index.skills.find(s => s.id === id))
+        .filter((s) => s !== undefined);
+    if (skillsToActivate.length === 0) {
+        return { activated: [], errors: ["No valid skills to activate"] };
+    }
+    const projectSkillsPath = getProjectSkillsPath(projectRoot);
+    // Ensure .vibe/skills/ directory exists
+    try {
+        await fs.promises.mkdir(projectSkillsPath, { recursive: true });
+    }
+    catch (e) {
+        return {
+            activated: [],
+            errors: [`Failed to create skills directory: ${e instanceof Error ? e.message : String(e)}`]
+        };
+    }
+    const activated = [];
+    const errors = [];
+    // Copy each skill file
+    for (const skill of skillsToActivate) {
+        const srcPath = path.join(bundlePath, skill.file);
+        const destPath = path.join(projectSkillsPath, skill.file);
+        try {
+            await fs.promises.copyFile(srcPath, destPath);
+            activated.push(skill.id);
+        }
+        catch (e) {
+            errors.push(`Failed to copy ${skill.id}: ${e instanceof Error ? e.message : String(e)}`);
+        }
+    }
+    // Write the activated skills index
+    if (activated.length > 0) {
+        const activatedIndex = {
+            version: index.version,
+            activated,
+            activated_at: new Date().toISOString(),
+            source: "prebundled",
+            skills: skillsToActivate.filter(s => activated.includes(s.id))
+        };
+        const indexPath = path.join(projectSkillsPath, "index.json");
+        try {
+            await fs.promises.writeFile(indexPath, JSON.stringify(activatedIndex, null, 2), "utf-8");
+        }
+        catch (e) {
+            errors.push(`Failed to write index.json: ${e instanceof Error ? e.message : String(e)}`);
+        }
+    }
+    return { activated, errors };
+}
+/**
+ * Deactivate a skill from the project
+ */
+export async function deactivateSkill(projectRoot, skillId) {
+    const projectSkillsPath = getProjectSkillsPath(projectRoot);
+    const activatedIndex = loadActivatedSkillsIndex(projectRoot);
+    if (!activatedIndex) {
+        return { success: false, error: "No activated skills found" };
+    }
+    const skillMeta = activatedIndex.skills.find(s => s.id === skillId);
+    if (!skillMeta) {
+        return { success: false, error: `Skill ${skillId} is not activated` };
+    }
+    // Remove the skill file
+    const skillPath = path.join(projectSkillsPath, skillMeta.file);
+    try {
+        if (fs.existsSync(skillPath)) {
+            await fs.promises.unlink(skillPath);
+        }
+    }
+    catch (e) {
+        return {
+            success: false,
+            error: `Failed to remove skill file: ${e instanceof Error ? e.message : String(e)}`
+        };
+    }
+    // Update the index
+    const newActivated = activatedIndex.activated.filter(id => id !== skillId);
+    const newSkills = activatedIndex.skills.filter(s => s.id !== skillId);
+    if (newActivated.length === 0) {
+        // Remove the index file if no skills remain
+        const indexPath = path.join(projectSkillsPath, "index.json");
+        try {
+            await fs.promises.unlink(indexPath);
+        }
+        catch {
+            // ignore
+        }
+    }
+    else {
+        // Update the index
+        const updatedIndex = {
+            ...activatedIndex,
+            activated: newActivated,
+            skills: newSkills
+        };
+        const indexPath = path.join(projectSkillsPath, "index.json");
+        await fs.promises.writeFile(indexPath, JSON.stringify(updatedIndex, null, 2), "utf-8");
+    }
+    return { success: true };
+}
+// ============================================================
+// Ensure Skills (for setup/update)
+// ============================================================
+/**
+ * Ensure skills are installed and healthy
+ * Returns the bundle path if successful
+ */
+export function ensureSkills() {
+    const health = getSkillsHealth();
+    // For prebundled skills, we can't "repair" - they're part of the package
+    // If they're corrupted, the user needs to reinstall the package
+    return {
+        path: health.bundlePath,
+        health
+    };
+}
+/**
+ * Get skill content by ID
+ */
+export function getSkillContent(skillId) {
+    const bundlePath = getSkillsBundlePath();
+    if (!bundlePath)
+        return null;
+    const skill = getSkillById(skillId);
+    if (!skill)
+        return null;
+    const filePath = path.join(bundlePath, skill.file);
+    try {
+        return fs.readFileSync(filePath, "utf-8");
+    }
+    catch {
+        return null;
+    }
+}

package/build/dx/activity.js

@@ -1,5 +1,6 @@
 // adapters/mcp-ts/src/dx/activity.ts
 // Activity/DX helpers: branded header, status icons, optional desktop notifications
+import { getWaiterMapping, renderVerdictFromTemplateId, resolveLocaleFromData } from "../tools/vibe_pm/waiter_mapping.js";
 function boolEnv(name, defaultValue) {
     const raw = (process.env[name] ?? "").trim().toLowerCase();
     if (!raw)
@@ -91,14 +92,35 @@ function verdictIcon(data, outcome) {
     }
     return "✅";
 }
+function verdictLabel(data, outcome) {
+    if (outcome === "error")
+        return "";
+    if (!data || typeof data !== "object")
+        return "";
+    const obj = data;
+    const templateId = typeof obj.message_template_id === "string" ? String(obj.message_template_id) : "";
+    if (!templateId)
+        return "";
+    try {
+        const mapping = getWaiterMapping();
+        const locale = resolveLocaleFromData(data, mapping);
+        const label = renderVerdictFromTemplateId(templateId, locale, mapping);
+        return label ? label : "";
+    }
+    catch {
+        return "";
+    }
+}
 export function renderActivityHeader(toolName, data, outcome = "success", durationMs) {
     const badge = toolBadge(toolName, data);
     const status = verdictIcon(data, outcome);
+    const label = verdictLabel(data, outcome);
     const duration = typeof durationMs === "number" && durationMs >= 0 ? ` · ${Math.round(durationMs)}ms` : "";
+    const verdict = label ? ` · ${label}` : "";
     return [
         "╭──────────────────────────────╮",
         "│  VibePM ⚡️ Active            │",
-        `│  ${status} ${badge.icon} ${badge.label}${duration}`,
+        `│  ${status} ${badge.icon} ${badge.label}${verdict}${duration}`,
         "╰──────────────────────────────╯"
     ].join("\n");
 }
@@ -107,9 +129,10 @@ export function decorateToolOutputText(toolName, jsonText, data, outcome = "succ
         return [{ type: "text", text: jsonText }];
     }
     const header = renderActivityHeader(toolName, data, outcome, durationMs);
+    // Combine header and JSON into single block to ensure both are displayed
+    // (some MCP clients only show the first content block on error)
     return [
-        { type: "text", text: header },
-        { type: "text", text: jsonText }
+        { type: "text", text: header + "\n" + jsonText }
     ];
 }
 export async function notifyDesktopBestEffort(args) {

package/build/engine.js

@@ -1,5 +1,8 @@
 // adapters/mcp-ts/src/engine.ts
 // Engine execution using cached binaries (no PATH dependency)
+import { existsSync } from "node:fs";
+import { dirname, join, resolve } from "node:path";
+import { fileURLToPath } from "node:url";
 import { ensureEngines } from "./bootstrap/installer.js";
 import { runCmd } from "./cli.js";
 import { TieredCache, createCacheKey } from "./cache/index.js";
@@ -104,3 +107,151 @@ export function invalidateEngineCache(pattern) {
 export function getEngineCacheStats() {
     return engineResultCache.stats();
 }
+// ============================================================
+// Python CLI Support (vibecoding_helper package)
+// ============================================================
+/**
+ * Python CLI commands that are safe to cache (read-only operations)
+ */
+const PYTHON_CACHEABLE_COMMANDS = new Set([
+    "memory-status",
+    "kce-status",
+    "entity-gate",
+    "show-ask-queue",
+]);
+function isDebugMode() {
+    const v = (process.env.VIBECODE_DEBUG ?? "").trim().toLowerCase();
+    return v === "1" || v === "true" || v === "yes" || v === "on";
+}
+/**
+ * Find repo root for Python import.
+ *
+ * Priority order:
+ * 1. VIBECODE_PYTHONPATH environment variable (explicit override)
+ * 2. MCP server directory (fallback for when MCP runs from user project)
+ * 3. startDir upwards search (heuristic: nearest ancestor with pyproject.toml or vibecoding_helper/)
+ *
+ * @param startDir - Directory to start searching from
+ * @returns Repo root path or null if not found
+ */
+export function findPythonRepoRoot(startDir) {
+    // Priority 1: VIBECODE_PYTHONPATH explicit override
+    const override = process.env.VIBECODE_PYTHONPATH?.trim();
+    if (override && existsSync(override)) {
+        return override;
+    }
+    // Priority 2: MCP server directory fallback
+    // When MCP runs from user project, we need to find the package from MCP installation
+    try {
+        const mcpDir = dirname(fileURLToPath(import.meta.url));
+        // mcpDir is typically: .../adapters/mcp-ts/build/
+        // repo root is: .../adapters/mcp-ts/build/../../../.. = repo root
+        const repoFromMcp = resolve(mcpDir, "..", "..", "..", "..");
+        const pkgFromMcp = join(repoFromMcp, "vibecoding_helper");
+        if (existsSync(pkgFromMcp)) {
+            return repoFromMcp;
+        }
+    }
+    catch {
+        // import.meta.url failed, continue to next priority
+    }
+    // Priority 3: startDir upwards search (original heuristic)
+    let current = resolve(startDir);
+    // Walk up until filesystem root
+    while (true) {
+        const pyproject = join(current, "pyproject.toml");
+        const pkgDir = join(current, "vibecoding_helper");
+        // Check for pyproject.toml or vibecoding_helper/ directory
+        if (existsSync(pyproject) || existsSync(pkgDir)) {
+            return current;
+        }
+        const parent = dirname(current);
+        if (parent === current)
+            break; // Reached filesystem root
+        current = parent;
+    }
+    return null;
+}
+/**
+ * Build env for Python CLI so that 'python -m vibecoding_helper ...' can import
+ * even when MCP client ignores .mcp.json env (e.g., Claude Code).
+ *
+ * Priority:
+ * 1. VIBECODE_PYTHONPATH (explicit override)
+ * 2. Auto-detected repo root
+ * 3. Existing PYTHONPATH
+ *
+ * @param baseEnv - Base environment variables
+ * @param cwd - Current working directory for repo root detection
+ * @returns Environment with PYTHONPATH properly set
+ */
+export function buildPythonCliEnv(baseEnv, cwd) {
+    const env = { ...baseEnv };
+    const delim = process.platform === "win32" ? ";" : ":";
+    // Priority 1: Explicit override via VIBECODE_PYTHONPATH
+    const override = env.VIBECODE_PYTHONPATH?.trim();
+    // Priority 2: Auto-detect repo root
+    const repoRoot = override || findPythonRepoRoot(cwd);
+    if (!repoRoot)
+        return env;
+    // Parse existing PYTHONPATH
+    const existing = env.PYTHONPATH ?? "";
+    const parts = existing.split(delim).filter(Boolean);
+    // Avoid duplicate insertion
+    if (!parts.includes(repoRoot)) {
+        env.PYTHONPATH = [repoRoot, ...parts].join(delim);
+    }
+    else {
+        env.PYTHONPATH = parts.join(delim);
+    }
+    return env;
+}
+/**
+ * Run Python vibecoding_helper CLI command
+ * Uses `python -m vibecoding_helper` for cross-platform compatibility
+ *
+ * Automatically injects PYTHONPATH by detecting the package root,
+ * making it work without .mcp.json env configuration.
+ */
+export async function runPythonCli(args, opts) {
+    const pythonCmd = process.platform === "win32" ? "python" : "python3";
+    const fullArgs = ["-m", "vibecoding_helper", ...args];
+    const cwd = process.cwd();
+    // Auto-inject PYTHONPATH using buildPythonCliEnv
+    const env = buildPythonCliEnv(process.env, cwd);
+    if (isDebugMode()) {
+        const repoRoot = findPythonRepoRoot(cwd);
+        console.error(`[DEBUG runPythonCli] cmd=${pythonCmd} args=${JSON.stringify(fullArgs)}`);
+        console.error(`[DEBUG runPythonCli] PYTHONPATH=${env.PYTHONPATH ?? "(not set)"}`);
+        console.error(`[DEBUG runPythonCli] detected_root=${repoRoot ?? "(not found)"}`);
+        console.error(`[DEBUG runPythonCli] cwd=${cwd}`);
+    }
+    const result = await runCmd(pythonCmd, fullArgs, {
+        timeoutMs: opts?.timeoutMs ?? 120_000,
+        env,
+    });
+    if (isDebugMode()) {
+        console.error(`[DEBUG runPythonCli] code=${result.code} stdout=${result.stdout.slice(0, 200)} stderr=${result.stderr.slice(0, 200)}`);
+    }
+    return result;
+}
+/**
+ * Run Python CLI command with optional caching support
+ */
+export async function runPythonCliWithCache(args, opts) {
+    const subCommand = extractSubcommand(args);
+    const isCacheable = PYTHON_CACHEABLE_COMMANDS.has(subCommand) && !opts?.skipCache;
+    if (isCacheable) {
+        const cacheKey = createCacheKey("python-cli", ...args);
+        const cachedResult = engineResultCache.get(cacheKey);
+        if (cachedResult) {
+            return cachedResult;
+        }
+        const result = await runPythonCli(args, opts);
+        if (result.code === 0) {
+            engineResultCache.set(cacheKey, result);
+        }
+        return result;
+    }
+    return await runPythonCli(args, opts);
+}

package/build/errors.js

@@ -169,3 +169,110 @@ export function doNotTouchError(path, pattern) {
         recovery: "This path is protected and cannot be modified. Choose a different target.",
     });
 }
+// ============================================================
+// Error Detection Patterns (P1-4: Normalized string-based error detection)
+// ============================================================
+/**
+ * Centralized error string patterns for consistent detection across the codebase.
+ * Use these constants instead of hardcoded strings for maintainability.
+ */
+export const ErrorPatterns = {
+    // Bootstrap/download errors
+    DOWNLOAD_TIMEOUT: ["download_timeout", "AbortError"],
+    DOWNLOAD_404: ["404", "no_matching_asset", "download_failed:404"],
+    DOWNLOAD_FAILED: ["download_failed", "fetch"],
+    SHA_MISMATCH: ["sha_mismatch"],
+    SHA_MISSING: ["sha_missing_for_asset"],
+    BIN_NOT_FOUND: ["bin_not_found_after_extract"],
+    // Git errors
+    GIT_CONFLICT: ["conflict", "CONFLICT"],
+    // OPA/Policy errors
+    OPA_EVAL_FAILED: ["eval_failed", "opa_eval_failed", "opa exception", "opa_exception", "eval failed"],
+    OPA_MISSING: ["missing"],
+};
+/**
+ * Check if a message matches any of the given patterns.
+ * Case-insensitive matching for OPA patterns, case-sensitive for others.
+ */
+export function matchesErrorPattern(message, patterns, options = {}) {
+    const normalizedMessage = options.caseInsensitive ? message.toLowerCase() : message;
+    return patterns.some((pattern) => {
+        const normalizedPattern = options.caseInsensitive ? pattern.toLowerCase() : pattern;
+        return normalizedMessage.includes(normalizedPattern);
+    });
+}
+/**
+ * Check if message indicates a download timeout error.
+ */
+export function isDownloadTimeoutError(message) {
+    return matchesErrorPattern(message, ErrorPatterns.DOWNLOAD_TIMEOUT);
+}
+/**
+ * Check if message indicates a 404/not found error.
+ */
+export function isDownload404Error(message) {
+    return matchesErrorPattern(message, ErrorPatterns.DOWNLOAD_404);
+}
+/**
+ * Check if message indicates a general download failure.
+ */
+export function isDownloadFailedError(message) {
+    return matchesErrorPattern(message, ErrorPatterns.DOWNLOAD_FAILED);
+}
+/**
+ * Check if message indicates a git conflict.
+ */
+export function isGitConflictError(message) {
+    return matchesErrorPattern(message, ErrorPatterns.GIT_CONFLICT);
+}
+/**
+ * Check if message indicates an OPA evaluation failure.
+ * Always case-insensitive for OPA patterns.
+ */
+export function isOpaEvalFailedError(message) {
+    return matchesErrorPattern(message, ErrorPatterns.OPA_EVAL_FAILED, { caseInsensitive: true });
+}
+/**
+ * Check if message indicates OPA is missing.
+ */
+export function isOpaMissingError(message) {
+    return matchesErrorPattern(message, ErrorPatterns.OPA_MISSING, { caseInsensitive: true });
+}
+// ============================================================
+// P2-23: Error Message Formatting Utilities
+// ============================================================
+/**
+ * Format CLI command failure error message.
+ * @param command - The command that failed (e.g., "kce-status", "zoekt-evidence")
+ * @param exitCode - Exit code from the process
+ * @param stderr - Standard error output
+ * @param stdout - Standard output (used as fallback)
+ */
+export function formatCliError(command, exitCode, stderr, stdout) {
+    const detail = stderr || stdout || `exit_code=${exitCode ?? "unknown"}`;
+    return `${command} failed: ${detail}`;
+}
+/**
+ * Format JSON parsing error message.
+ * @param context - Context where parsing failed (e.g., "kce-status", "config")
+ * @param error - The parsing error
+ */
+export function formatJsonParseError(context, error) {
+    const msg = error instanceof Error ? error.message : String(error);
+    return `${context} invalid_json: ${msg}`;
+}
+/**
+ * Format schema validation error message.
+ * @param context - Context where validation failed
+ */
+export function formatSchemaError(context) {
+    return `${context} schema mismatch`;
+}
+/**
+ * Format user-facing Korean error message.
+ * @param action - What action failed (e.g., "프로젝트 초기화", "작업 지시서 생성")
+ * @param detail - Additional detail (optional)
+ */
+export function formatKoreanError(action, detail) {
+    return `${action} 실패${detail ? `: ${detail}` : ""}`;
+}

package/build/generated/bridge_build_seed_input.js

@@ -0,0 +1,2 @@
+import { z } from "zod";
+export const BridgeBuildSeedInputSchema = z.object({ "project_id": z.string().min(1), "run_id": z.string().min(1).optional(), "raw_user_intent": z.string().min(1).max(4000).optional(), "goal": z.string().min(1).max(2000).optional(), "user_story": z.string().min(1).max(2000).optional(), "acceptance": z.array(z.string().min(1).max(300)).min(3).max(12).optional(), "constraints": z.array(z.string().min(1).max(200)).max(12).optional(), "non_goals": z.array(z.string().min(1).max(200)).max(8).optional(), "scope_seed": z.object({ "include": z.array(z.string().min(1).max(300)).min(1).max(20), "exclude": z.array(z.string().min(1).max(300)).max(20), "do_not_touch": z.array(z.string().min(1).max(300)).max(20).optional() }).strict().optional(), "preferred_stack_hint": z.string().max(200).optional(), "risk_notes": z.array(z.string().min(1).max(200)).max(8).optional(), "overwrite": z.boolean().default(true), "write_files": z.boolean().default(true) }).strict().describe("SSOT schema for vibe_pm.bridge_build_seed MCP tool input");