vectorvesper 2.0.0 → 2.0.1

package/dist/{chunk-32GDEAJM.js → chunk-HOJ3DQSV.js}

@@ -1,37 +1,10 @@
-// src/utils/logger.ts
-import pc from "picocolors";
-var verboseMode = false;
-function setVerbose(enabled) {
-  verboseMode = enabled;
-}
-var logger = {
-  /** Standard info message */
-  info(message) {
-    console.log(message);
-  },
-  /** Success message with green checkmark */
-  success(message) {
-    console.log(`${pc.green("\u2714")} ${message}`);
-  },
-  /** Warning message */
-  warn(message) {
-    console.log(pc.yellow(`\u26A0\uFE0F  ${message}`));
-  },
-  /** Error message */
-  error(message) {
-    console.error(pc.red(`\u274C ${message}`));
-  },
-  /** Debug message — only shown when --verbose is active */
-  debug(message) {
-    if (verboseMode) {
-      console.log(pc.dim(`  [debug] ${message}`));
-    }
-  },
-  /** Blank line */
-  break() {
-    console.log("");
-  }
-};
+import {
+  RegistryComponentSchema,
+  RegistryIndexSchema,
+  getAuthToken,
+  logger,
+  validateSlug
+} from "./chunk-SFP5K3ZO.js";
 
 // src/utils/project.ts
 import fs from "fs";
@@ -97,203 +70,9 @@ function detectProject(cwd = process.cwd()) {
   };
 }
 
-// src/utils/config.ts
+// src/utils/registry.ts
 import fs2 from "fs";
 import path2 from "path";
-import os from "os";
-
-// src/utils/types.ts
-import { z } from "zod";
-var SLUG_REGEX = /^[a-z0-9][a-z0-9-]*$/;
-function validateSlug(slug) {
-  if (!SLUG_REGEX.test(slug)) {
-    throw new Error(
-      `Invalid component slug "${slug}". Slugs must contain only lowercase letters, numbers, and hyphens, and cannot start with a hyphen.`
-    );
-  }
-}
-var ComponentFileSchema = z.object({
-  path: z.string(),
-  target: z.string(),
-  type: z.enum(["component", "types", "shader", "lib", "docs"]),
-  content: z.string()
-});
-var RegistryComponentSchema = z.object({
-  slug: z.string(),
-  name: z.string(),
-  title: z.string(),
-  description: z.string(),
-  version: z.string(),
-  tier: z.enum(["free", "pro"]),
-  category: z.string(),
-  type: z.string(),
-  frameworks: z.array(z.string()),
-  files: z.array(ComponentFileSchema),
-  dependencies: z.array(z.string()),
-  devDependencies: z.array(z.string()),
-  registryDependencies: z.array(z.string()),
-  requiresClient: z.boolean(),
-  supportsReducedMotion: z.boolean(),
-  usesWebGL: z.boolean(),
-  usesPointer: z.boolean(),
-  usesScroll: z.boolean(),
-  // Optional metadata — kept in sync with the registry builder schema.
-  // Declared here (rather than relying on .passthrough()) so the CLI can
-  // read them with full type-safety for post-install guidance.
-  entry: z.string().optional(),
-  exportName: z.string().optional(),
-  usesTailwind: z.boolean().optional(),
-  fallbacks: z.array(z.string()).optional(),
-  recipes: z.array(z.string()).optional(),
-  docsUrl: z.string().optional(),
-  previewUrl: z.string().optional()
-}).passthrough();
-var IndexComponentSchema = z.object({
-  slug: z.string(),
-  name: z.string(),
-  title: z.string(),
-  description: z.string(),
-  version: z.string(),
-  tier: z.enum(["free", "pro"]),
-  category: z.string(),
-  type: z.string(),
-  frameworks: z.array(z.string()),
-  files: z.array(z.object({
-    path: z.string(),
-    target: z.string(),
-    type: z.enum(["component", "types", "shader", "lib", "docs"])
-  })),
-  dependencies: z.array(z.string()),
-  devDependencies: z.array(z.string()),
-  registryDependencies: z.array(z.string()),
-  requiresClient: z.boolean(),
-  supportsReducedMotion: z.boolean(),
-  usesWebGL: z.boolean(),
-  usesPointer: z.boolean(),
-  usesScroll: z.boolean(),
-  entry: z.string().optional(),
-  exportName: z.string().optional(),
-  usesTailwind: z.boolean().optional(),
-  // These are emitted by the registry build and were reaching consumers only
-  // through .passthrough(), i.e. typed as unknown. Declared optional rather
-  // than required so an older published registry still validates.
-  fallbacks: z.array(z.string()).optional(),
-  recipes: z.array(z.string()).optional(),
-  docsUrl: z.string().optional(),
-  previewUrl: z.string().optional()
-}).passthrough();
-var RegistryIndexSchema = z.object({
-  version: z.string(),
-  components: z.array(IndexComponentSchema)
-});
-var VVConfigSchema = z.object({
-  tsx: z.boolean(),
-  framework: z.enum(["next", "vite", "unknown"]),
-  aliases: z.object({
-    vv: z.string()
-  })
-});
-var VVGlobalConfigSchema = z.object({
-  // Auth — license key for paid components
-  auth: z.object({
-    token: z.string().optional(),
-    email: z.string().optional(),
-    tier: z.enum(["free", "pro", "team"]).optional(),
-    expiresAt: z.string().optional()
-  }).optional(),
-  // Preferences
-  telemetry: z.boolean().optional()
-}).passthrough();
-var ManifestEntrySchema = z.object({
-  version: z.string(),
-  installedAt: z.string(),
-  installedOn: z.string(),
-  files: z.array(z.string())
-});
-var ManifestSchema = z.object({
-  components: z.record(z.string(), ManifestEntrySchema)
-});
-
-// src/utils/config.ts
-var CONFIG_FILE_NAME = "vv.config.json";
-function getConfigPath(cwd = process.cwd()) {
-  return path2.join(cwd, CONFIG_FILE_NAME);
-}
-function loadConfig(cwd = process.cwd()) {
-  const configPath = getConfigPath(cwd);
-  if (!fs2.existsSync(configPath)) {
-    return null;
-  }
-  let raw;
-  try {
-    const content = fs2.readFileSync(configPath, "utf-8");
-    raw = JSON.parse(content);
-  } catch {
-    throw new Error(
-      `Failed to parse vv.config.json \u2014 the file contains invalid JSON. Delete it and run "npx vectorvesper init" to regenerate.`
-    );
-  }
-  const result = VVConfigSchema.safeParse(raw);
-  if (!result.success) {
-    const issues = result.error.issues.map((i) => `  \u2022 ${i.path.join(".")}: ${i.message}`).join("\n");
-    throw new Error(
-      `Invalid vv.config.json \u2014 schema validation failed:
-${issues}
-Delete the file and run "npx vectorvesper init" to regenerate.`
-    );
-  }
-  return result.data;
-}
-function writeConfig(config, cwd = process.cwd()) {
-  const configPath = getConfigPath(cwd);
-  fs2.writeFileSync(configPath, JSON.stringify(config, null, 2), "utf-8");
-}
-var GLOBAL_CONFIG_DIR = path2.join(os.homedir(), ".vv");
-var GLOBAL_CONFIG_PATH = path2.join(GLOBAL_CONFIG_DIR, "config.json");
-function getGlobalConfigPath() {
-  return GLOBAL_CONFIG_PATH;
-}
-function loadGlobalConfig() {
-  if (!fs2.existsSync(GLOBAL_CONFIG_PATH)) {
-    return {};
-  }
-  try {
-    const content = fs2.readFileSync(GLOBAL_CONFIG_PATH, "utf-8");
-    const raw = JSON.parse(content);
-    const result = VVGlobalConfigSchema.safeParse(raw);
-    if (!result.success) {
-      logger.debug(`Global config validation failed: ${result.error.message}`);
-      return {};
-    }
-    return result.data;
-  } catch {
-    logger.debug("Failed to parse global config, using defaults.");
-    return {};
-  }
-}
-function saveGlobalConfig(config) {
-  if (!fs2.existsSync(GLOBAL_CONFIG_DIR)) {
-    fs2.mkdirSync(GLOBAL_CONFIG_DIR, { recursive: true });
-  }
-  fs2.writeFileSync(GLOBAL_CONFIG_PATH, JSON.stringify(config, null, 2), "utf-8");
-}
-function getAuthToken() {
-  const config = loadGlobalConfig();
-  return config.auth?.token;
-}
-function resolveAlias(alias, hasSrcDir) {
-  if (alias.startsWith("@/")) {
-    return alias.replace("@/", hasSrcDir ? "src/" : "");
-  }
-  if (alias.startsWith("~/")) {
-    return alias.replace("~/", hasSrcDir ? "src/" : "");
-  }
-  return alias;
-}
-
-// src/utils/registry.ts
-import fs3 from "fs";
-import path3 from "path";
 import { fileURLToPath } from "url";
 var DEFAULT_REGISTRY_URL = "https://raw.githubusercontent.com/vectorvesper/vv-components/main/r";
 var DEFAULT_PRO_API_URL = "https://vectorvesper.dev/api/cli/registry";
@@ -402,12 +181,12 @@ async function fetchRegistryData(urlOrPath) {
   if (urlOrPath.startsWith("file://")) {
     cleanPath = fileURLToPath(urlOrPath);
   }
-  cleanPath = path3.resolve(cleanPath);
-  if (!fs3.existsSync(cleanPath)) {
+  cleanPath = path2.resolve(cleanPath);
+  if (!fs2.existsSync(cleanPath)) {
     throw new Error(`Registry path not found: ${cleanPath}`);
   }
   logger.debug(`Reading local registry: ${cleanPath}`);
-  return fs3.readFileSync(cleanPath, "utf-8");
+  return fs2.readFileSync(cleanPath, "utf-8");
 }
 async function fetchRegistryIndex() {
   const baseUrl = getRegistryBaseUrl();
@@ -482,17 +261,7 @@ ${issues}`);
 }
 
 export {
-  setVerbose,
-  logger,
   detectProject,
-  validateSlug,
-  loadConfig,
-  writeConfig,
-  getGlobalConfigPath,
-  loadGlobalConfig,
-  saveGlobalConfig,
-  getAuthToken,
-  resolveAlias,
   fetchRegistryIndex,
   fetchComponent
 };

package/dist/chunk-SFP5K3ZO.js

@@ -0,0 +1,243 @@
+// src/utils/logger.ts
+import pc from "picocolors";
+var verboseMode = false;
+function setVerbose(enabled) {
+  verboseMode = enabled;
+}
+var logger = {
+  /** Standard info message */
+  info(message) {
+    console.log(message);
+  },
+  /** Success message with green checkmark */
+  success(message) {
+    console.log(`${pc.green("\u2714")} ${message}`);
+  },
+  /** Warning message */
+  warn(message) {
+    console.log(pc.yellow(`\u26A0\uFE0F  ${message}`));
+  },
+  /** Error message */
+  error(message) {
+    console.error(pc.red(`\u274C ${message}`));
+  },
+  /** Debug message — only shown when --verbose is active */
+  debug(message) {
+    if (verboseMode) {
+      console.log(pc.dim(`  [debug] ${message}`));
+    }
+  },
+  /** Blank line */
+  break() {
+    console.log("");
+  }
+};
+
+// src/utils/config.ts
+import fs from "fs";
+import path from "path";
+import os from "os";
+
+// src/utils/types.ts
+import { z } from "zod";
+var SLUG_REGEX = /^[a-z0-9][a-z0-9-]*$/;
+function validateSlug(slug) {
+  if (!SLUG_REGEX.test(slug)) {
+    throw new Error(
+      `Invalid component slug "${slug}". Slugs must contain only lowercase letters, numbers, and hyphens, and cannot start with a hyphen.`
+    );
+  }
+}
+var ComponentFileSchema = z.object({
+  path: z.string(),
+  target: z.string(),
+  type: z.enum(["component", "types", "shader", "lib", "docs"]),
+  content: z.string()
+});
+var RegistryComponentSchema = z.object({
+  slug: z.string(),
+  name: z.string(),
+  title: z.string(),
+  description: z.string(),
+  version: z.string(),
+  tier: z.enum(["free", "pro"]),
+  category: z.string(),
+  type: z.string(),
+  frameworks: z.array(z.string()),
+  files: z.array(ComponentFileSchema),
+  dependencies: z.array(z.string()),
+  devDependencies: z.array(z.string()),
+  registryDependencies: z.array(z.string()),
+  requiresClient: z.boolean(),
+  supportsReducedMotion: z.boolean(),
+  usesWebGL: z.boolean(),
+  usesPointer: z.boolean(),
+  usesScroll: z.boolean(),
+  // Optional metadata — kept in sync with the registry builder schema.
+  // Declared here (rather than relying on .passthrough()) so the CLI can
+  // read them with full type-safety for post-install guidance.
+  entry: z.string().optional(),
+  exportName: z.string().optional(),
+  usesTailwind: z.boolean().optional(),
+  fallbacks: z.array(z.string()).optional(),
+  recipes: z.array(z.string()).optional(),
+  docsUrl: z.string().optional(),
+  previewUrl: z.string().optional()
+}).passthrough();
+var IndexComponentSchema = z.object({
+  slug: z.string(),
+  name: z.string(),
+  title: z.string(),
+  description: z.string(),
+  version: z.string(),
+  tier: z.enum(["free", "pro"]),
+  category: z.string(),
+  type: z.string(),
+  frameworks: z.array(z.string()),
+  files: z.array(z.object({
+    path: z.string(),
+    target: z.string(),
+    type: z.enum(["component", "types", "shader", "lib", "docs"])
+  })),
+  dependencies: z.array(z.string()),
+  devDependencies: z.array(z.string()),
+  registryDependencies: z.array(z.string()),
+  requiresClient: z.boolean(),
+  supportsReducedMotion: z.boolean(),
+  usesWebGL: z.boolean(),
+  usesPointer: z.boolean(),
+  usesScroll: z.boolean(),
+  entry: z.string().optional(),
+  exportName: z.string().optional(),
+  usesTailwind: z.boolean().optional(),
+  // These are emitted by the registry build and were reaching consumers only
+  // through .passthrough(), i.e. typed as unknown. Declared optional rather
+  // than required so an older published registry still validates.
+  fallbacks: z.array(z.string()).optional(),
+  recipes: z.array(z.string()).optional(),
+  docsUrl: z.string().optional(),
+  previewUrl: z.string().optional()
+}).passthrough();
+var RegistryIndexSchema = z.object({
+  version: z.string(),
+  components: z.array(IndexComponentSchema)
+});
+var VVConfigSchema = z.object({
+  tsx: z.boolean(),
+  framework: z.enum(["next", "vite", "unknown"]),
+  aliases: z.object({
+    vv: z.string()
+  })
+});
+var VVGlobalConfigSchema = z.object({
+  // Auth — license key for paid components
+  auth: z.object({
+    token: z.string().optional(),
+    email: z.string().optional(),
+    tier: z.enum(["free", "pro", "team"]).optional(),
+    expiresAt: z.string().optional()
+  }).optional(),
+  // Preferences
+  telemetry: z.boolean().optional()
+}).passthrough();
+var ManifestEntrySchema = z.object({
+  version: z.string(),
+  installedAt: z.string(),
+  installedOn: z.string(),
+  files: z.array(z.string())
+});
+var ManifestSchema = z.object({
+  components: z.record(z.string(), ManifestEntrySchema)
+});
+
+// src/utils/config.ts
+var CONFIG_FILE_NAME = "vv.config.json";
+function getConfigPath(cwd = process.cwd()) {
+  return path.join(cwd, CONFIG_FILE_NAME);
+}
+function loadConfig(cwd = process.cwd()) {
+  const configPath = getConfigPath(cwd);
+  if (!fs.existsSync(configPath)) {
+    return null;
+  }
+  let raw;
+  try {
+    const content = fs.readFileSync(configPath, "utf-8");
+    raw = JSON.parse(content);
+  } catch {
+    throw new Error(
+      `Failed to parse vv.config.json \u2014 the file contains invalid JSON. Delete it and run "npx vectorvesper init" to regenerate.`
+    );
+  }
+  const result = VVConfigSchema.safeParse(raw);
+  if (!result.success) {
+    const issues = result.error.issues.map((i) => `  \u2022 ${i.path.join(".")}: ${i.message}`).join("\n");
+    throw new Error(
+      `Invalid vv.config.json \u2014 schema validation failed:
+${issues}
+Delete the file and run "npx vectorvesper init" to regenerate.`
+    );
+  }
+  return result.data;
+}
+function writeConfig(config, cwd = process.cwd()) {
+  const configPath = getConfigPath(cwd);
+  fs.writeFileSync(configPath, JSON.stringify(config, null, 2), "utf-8");
+}
+var GLOBAL_CONFIG_DIR = path.join(os.homedir(), ".vv");
+var GLOBAL_CONFIG_PATH = path.join(GLOBAL_CONFIG_DIR, "config.json");
+function getGlobalConfigPath() {
+  return GLOBAL_CONFIG_PATH;
+}
+function loadGlobalConfig() {
+  if (!fs.existsSync(GLOBAL_CONFIG_PATH)) {
+    return {};
+  }
+  try {
+    const content = fs.readFileSync(GLOBAL_CONFIG_PATH, "utf-8");
+    const raw = JSON.parse(content);
+    const result = VVGlobalConfigSchema.safeParse(raw);
+    if (!result.success) {
+      logger.debug(`Global config validation failed: ${result.error.message}`);
+      return {};
+    }
+    return result.data;
+  } catch {
+    logger.debug("Failed to parse global config, using defaults.");
+    return {};
+  }
+}
+function saveGlobalConfig(config) {
+  if (!fs.existsSync(GLOBAL_CONFIG_DIR)) {
+    fs.mkdirSync(GLOBAL_CONFIG_DIR, { recursive: true });
+  }
+  fs.writeFileSync(GLOBAL_CONFIG_PATH, JSON.stringify(config, null, 2), "utf-8");
+}
+function getAuthToken() {
+  const config = loadGlobalConfig();
+  return config.auth?.token;
+}
+function resolveAlias(alias, hasSrcDir) {
+  if (alias.startsWith("@/")) {
+    return alias.replace("@/", hasSrcDir ? "src/" : "");
+  }
+  if (alias.startsWith("~/")) {
+    return alias.replace("~/", hasSrcDir ? "src/" : "");
+  }
+  return alias;
+}
+
+export {
+  setVerbose,
+  logger,
+  validateSlug,
+  RegistryComponentSchema,
+  RegistryIndexSchema,
+  loadConfig,
+  writeConfig,
+  getGlobalConfigPath,
+  loadGlobalConfig,
+  saveGlobalConfig,
+  getAuthToken,
+  resolveAlias
+};

package/dist/chunk-XN3PPCIM.js

@@ -0,0 +1,41 @@
+// src/mcp/manifest.ts
+import fs from "fs";
+import path from "path";
+import { fileURLToPath } from "url";
+var __dirname = path.dirname(fileURLToPath(import.meta.url));
+var CANDIDATES = [
+  path.join(__dirname, "hooks.json"),
+  path.join(__dirname, "../hooks.json"),
+  path.resolve(__dirname, "../../../registry/generated/hooks.lean.json"),
+  path.resolve(__dirname, "../../registry/generated/hooks.lean.json")
+];
+var cached = null;
+function loadHookManifest() {
+  if (cached) return cached;
+  for (const candidate of CANDIDATES) {
+    if (!fs.existsSync(candidate)) continue;
+    try {
+      const parsed = JSON.parse(fs.readFileSync(candidate, "utf-8"));
+      if (Array.isArray(parsed?.hooks)) {
+        cached = parsed;
+        return cached;
+      }
+    } catch {
+    }
+  }
+  return null;
+}
+function findHook(name) {
+  const manifest = loadHookManifest();
+  if (!manifest) return null;
+  const wanted = name.toLowerCase();
+  return manifest.hooks.find((h) => h.name.toLowerCase() === wanted) ?? // Tolerate "sensor-bus" / "sensorbus" / "SensorBus" for "useSensorBus".
+  manifest.hooks.find(
+    (h) => h.name.toLowerCase().replace(/^use/, "") === wanted.replace(/^use/, "").replace(/-/g, "")
+  ) ?? null;
+}
+
+export {
+  loadHookManifest,
+  findHook
+};

package/dist/index.js

@@ -2,7 +2,9 @@
 import {
   detectProject,
   fetchComponent,
-  fetchRegistryIndex,
+  fetchRegistryIndex
+} from "./chunk-HOJ3DQSV.js";
+import {
   getAuthToken,
   getGlobalConfigPath,
   loadConfig,
@@ -13,7 +15,7 @@ import {
   setVerbose,
   validateSlug,
   writeConfig
-} from "./chunk-32GDEAJM.js";
+} from "./chunk-SFP5K3ZO.js";
 
 // src/index.ts
 import { Command } from "commander";
@@ -968,7 +970,7 @@ Remove ${slug}
 import fs6 from "fs";
 import path6 from "path";
 import pc8 from "picocolors";
-var CLI_VERSION = true ? "1.2.0" : "0.0.0-dev";
+var CLI_VERSION = true ? "2.0.1" : "0.0.0-dev";
 async function infoCommand() {
   console.log(pc8.bold(pc8.cyan("\nVector Vesper Diagnostics\n")));
   const projectInfo = detectProject();
@@ -1266,7 +1268,7 @@ async function whoamiCommand() {
 }
 
 // src/index.ts
-var version = true ? "1.2.0" : "0.0.0-dev";
+var version = true ? "2.0.1" : "0.0.0-dev";
 var program = new Command();
 program.name("vv").description("Vector Vesper CLI \u2014 add visual components to your React project").version(version).option("--verbose", "Show detailed debug output").hook("preAction", (thisCommand) => {
   const opts = thisCommand.opts();
@@ -1304,9 +1306,9 @@ program.command("logout", { hidden: true }).description("Clear stored license cr
 program.command("whoami", { hidden: true }).description("Show current authentication status").action(async () => {
   await whoamiCommand();
 });
-program.command("mcp").description("Run as an MCP server (stdio) for AI coding agents").action(async () => {
-  const { mcpCommand } = await import("./mcp-DOUIUZGA.js");
-  await mcpCommand();
+program.command("mcp [action]").description("Run as an MCP server (stdio) for AI coding agents. `vv mcp status` checks the setup.").option("--stdio", "Force server mode even from an interactive terminal").action(async (action, options) => {
+  const { mcpCommand } = await import("./mcp-ZGA5K5VW.js");
+  await mcpCommand(action, options);
 });
 process.on("unhandledRejection", (error) => {
   console.error("An unexpected error occurred:", error instanceof Error ? error.message : error);

package/dist/mcp-ZGA5K5VW.js

@@ -0,0 +1,107 @@
+import {
+  loadHookManifest
+} from "./chunk-XN3PPCIM.js";
+import {
+  getAuthToken
+} from "./chunk-SFP5K3ZO.js";
+
+// src/commands/mcp.ts
+import pc from "picocolors";
+var VERSION = true ? "2.0.1" : "0.0.0-dev";
+var CONFIG_SNIPPET = `{
+  "mcpServers": {
+    "vectorvesper": {
+      "command": "npx",
+      "args": ["-y", "vectorvesper", "mcp"]
+    }
+  }
+}`;
+function protectStdout() {
+  const toStderr = (...args) => {
+    console.error(...args);
+  };
+  console.log = toStderr;
+  console.info = toStderr;
+  console.debug = toStderr;
+}
+function printStatus() {
+  const manifest = loadHookManifest();
+  const authed = Boolean(getAuthToken());
+  const ok = (s) => `${pc.green("\u2714")} ${s}`;
+  const bad = (s) => `${pc.red("\u2717")} ${s}`;
+  console.log("");
+  console.log(pc.bold(pc.cyan("  Vector Vesper MCP\n")));
+  console.log(`  ${pc.bold("CLI version:")}   ${VERSION}`);
+  if (manifest) {
+    console.log(`  ${ok(`Hook manifest: ${manifest.hooks.length} hooks, engine v${manifest.engineVersion}`)}`);
+    console.log(`  ${pc.dim(`Contract level: ${manifest.contractLevel}`)}`);
+  } else {
+    console.log(`  ${bad("Hook manifest: MISSING")}`);
+    console.log(`  ${pc.dim("Reinstall with: npm i -g vectorvesper@latest")}`);
+  }
+  console.log(
+    `  ${authed ? ok("Authenticated \u2014 Pro components available") : pc.dim("\u25CB Not authenticated \u2014 free components only")}`
+  );
+  console.log("");
+  console.log(pc.bold("  Register with an agent"));
+  console.log(pc.dim("  Claude Code:"));
+  console.log(`    ${pc.cyan("claude mcp add vectorvesper -- npx -y vectorvesper mcp")}`);
+  console.log(pc.dim("  Cursor / Claude Desktop / other \u2014 add to the client's MCP config:"));
+  console.log(
+    CONFIG_SNIPPET.split("\n").map((l) => `    ${pc.dim(l)}`).join("\n")
+  );
+  console.log("");
+  console.log(
+    pc.dim("  Tools: list_hooks \xB7 get_hook \xB7 list_components \xB7 get_component \xB7 get_setup_guidance \xB7 search")
+  );
+  console.log("");
+}
+function printInteractiveHelp() {
+  console.log("");
+  console.log(pc.bold(pc.cyan("  Vector Vesper MCP server")));
+  console.log("");
+  console.log("  This command speaks the Model Context Protocol over stdin/stdout.");
+  console.log("  It is meant to be launched by an AI coding agent, not run by hand \u2014");
+  console.log("  started from a terminal it would just wait for a client that never connects.");
+  console.log("");
+  console.log(`  ${pc.bold("Check your setup:")}  ${pc.cyan("vv mcp status")}`);
+  console.log(`  ${pc.bold("Add to Claude Code:")} ${pc.cyan("claude mcp add vectorvesper -- npx -y vectorvesper mcp")}`);
+  console.log("");
+  console.log(pc.dim("  To run the server here anyway (for debugging): vv mcp --stdio"));
+  console.log("");
+}
+async function mcpCommand(action, options = {}) {
+  if (action === "status" || action === "info") {
+    printStatus();
+    return;
+  }
+  if (action !== void 0) {
+    console.error(
+      `
+${pc.red("\u2717")} Unknown argument "${action}" for \`vv mcp\`.
+
+  ${pc.cyan("vv mcp")}         start the MCP server (for agents)
+  ${pc.cyan("vv mcp status")}  check the setup and print client config
+`
+    );
+    process.exitCode = 1;
+    return;
+  }
+  if (process.stdin.isTTY && !options.stdio) {
+    printInteractiveHelp();
+    return;
+  }
+  protectStdout();
+  const { startMcpServer } = await import("./server-5CFZ6BS7.js");
+  try {
+    await startMcpServer();
+  } catch (error) {
+    console.error(
+      `vectorvesper mcp: failed to start \u2014 ${error instanceof Error ? error.message : String(error)}`
+    );
+    process.exit(1);
+  }
+}
+export {
+  mcpCommand
+};

package/dist/{server-7WN7N3ZG.js → server-5CFZ6BS7.js}

@@ -1,51 +1,18 @@
 import {
   detectProject,
-  fetchRegistryIndex,
+  fetchRegistryIndex
+} from "./chunk-HOJ3DQSV.js";
+import {
+  findHook,
+  loadHookManifest
+} from "./chunk-XN3PPCIM.js";
+import {
   getAuthToken
-} from "./chunk-32GDEAJM.js";
+} from "./chunk-SFP5K3ZO.js";
 
 // src/mcp/server.ts
 import { z } from "zod";
-
-// src/mcp/manifest.ts
-import fs from "fs";
-import path from "path";
-import { fileURLToPath } from "url";
-var __dirname = path.dirname(fileURLToPath(import.meta.url));
-var CANDIDATES = [
-  path.join(__dirname, "hooks.json"),
-  path.join(__dirname, "../hooks.json"),
-  path.resolve(__dirname, "../../../registry/generated/hooks.lean.json"),
-  path.resolve(__dirname, "../../registry/generated/hooks.lean.json")
-];
-var cached = null;
-function loadHookManifest() {
-  if (cached) return cached;
-  for (const candidate of CANDIDATES) {
-    if (!fs.existsSync(candidate)) continue;
-    try {
-      const parsed = JSON.parse(fs.readFileSync(candidate, "utf-8"));
-      if (Array.isArray(parsed?.hooks)) {
-        cached = parsed;
-        return cached;
-      }
-    } catch {
-    }
-  }
-  return null;
-}
-function findHook(name) {
-  const manifest = loadHookManifest();
-  if (!manifest) return null;
-  const wanted = name.toLowerCase();
-  return manifest.hooks.find((h) => h.name.toLowerCase() === wanted) ?? // Tolerate "sensor-bus" / "sensorbus" / "SensorBus" for "useSensorBus".
-  manifest.hooks.find(
-    (h) => h.name.toLowerCase().replace(/^use/, "") === wanted.replace(/^use/, "").replace(/-/g, "")
-  ) ?? null;
-}
-
-// src/mcp/server.ts
-var VERSION = true ? "1.2.0" : "0.0.0-dev";
+var VERSION = true ? "2.0.1" : "0.0.0-dev";
 function text(body) {
   return { content: [{ type: "text", text: body }] };
 }

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "vectorvesper",
-  "version": "2.0.0",
+  "version": "2.0.1",
   "description": "Add WebGL, React Three Fiber & advanced motion components to your project via CLI.",
   "type": "module",
   "license": "MIT",
@@ -44,7 +44,8 @@
     "typecheck": "tsc --noEmit",
     "test": "vitest run",
     "test:watch": "vitest",
-    "postbuild": "node scripts/bundle-manifest.mjs"
+    "postbuild": "node scripts/bundle-manifest.mjs",
+    "prepublishOnly": "npm run build"
   },
   "dependencies": {
     "@babel/core": "^7.24.0",

package/dist/mcp-DOUIUZGA.js

@@ -1,24 +0,0 @@
-// src/commands/mcp.ts
-function protectStdout() {
-  const toStderr = (...args) => {
-    console.error(...args);
-  };
-  console.log = toStderr;
-  console.info = toStderr;
-  console.debug = toStderr;
-}
-async function mcpCommand() {
-  protectStdout();
-  const { startMcpServer } = await import("./server-7WN7N3ZG.js");
-  try {
-    await startMcpServer();
-  } catch (error) {
-    console.error(
-      `vectorvesper mcp: failed to start \u2014 ${error instanceof Error ? error.message : String(error)}`
-    );
-    process.exit(1);
-  }
-}
-export {
-  mcpCommand
-};