@vibeframe/mcp-server 0.83.0 → 0.84.0

package/dist/index.js

@@ -453873,8 +453873,9 @@ var init_ai_fill_gaps = __esm({
 // ../cli/src/commands/_shared/cost-tier.ts
 function applyTier(cmd, tier) {
   cmd[COST_TIER_KEY] = tier;
+  const colored = TIER_COLOR[tier](`Cost: ${tier} (${TIER_DESCRIPTION[tier]})`);
   cmd.addHelpText("after", `
-Cost: ${tier} (${TIER_DESCRIPTION[tier]})
+${colored}
 `);
   return cmd;
 }
@@ -453884,16 +453885,23 @@ function applyTiers(parent, tiers) {
     if (tier) applyTier(cmd, tier);
   }
 }
-var TIER_DESCRIPTION, COST_TIER_KEY;
+var TIER_DESCRIPTION, TIER_COLOR, COST_TIER_KEY;
 var init_cost_tier = __esm({
   "../cli/src/commands/_shared/cost-tier.ts"() {
     "use strict";
+    init_source();
     TIER_DESCRIPTION = {
       "free": "FFmpeg only, no API call",
       "low": "$0.01\u2013$0.10 per call",
       "high": "$1\u2013$5 per call",
       "very-high": "$5\u2013$50+ per call"
     };
+    TIER_COLOR = {
+      "free": source_default.green,
+      "low": source_default.cyan,
+      "high": source_default.yellow,
+      "very-high": source_default.red
+    };
     COST_TIER_KEY = /* @__PURE__ */ Symbol.for("@vibeframe/cli.costTier");
   }
 });
@@ -468168,6 +468176,59 @@ When the user has a working shell sequence, extract steps:
 The \`compose\` action is the catch-all assembly step (audio mux, video
 overlay, etc.) \u2014 useful at the tail of a pipeline.
 `;
+var ARCHITECTURE_WALKTHROUGH = `# vibe agent / build / run \u2014 when to pick which
+
+The CLI has three orchestrating commands that coordinate other primitives:
+\`vibe agent\`, \`vibe build\`, \`vibe run\`. New users routinely ask which one
+they want for a given task. The full audit lives in
+[\`docs/cli-architecture.md\`](../../../docs/cli-architecture.md); this
+walkthrough is the operator-facing summary.
+
+## TL;DR
+
+| | \`vibe agent\` | \`vibe build\` | \`vibe run\` |
+|---|---|---|---|
+| **Driving input** | natural-language prompt | \`STORYBOARD.md\` | YAML pipeline file |
+| **Interactivity** | REPL or one-shot | one-shot | one-shot |
+| **Reproducibility** | none | high (idempotent) | highest (checkpointed) |
+| **Budget caps** | per-session max-turns | none | \`--budget-usd\`, \`--budget-tokens\`, \`--max-errors\` |
+| **Resume after crash** | no | re-invoke | \`--resume\` |
+| **Best for** | exploration | finished script | repeatable workflows |
+
+## Decision tree
+
+- "I want to play, I'll know it when I see it" \u2192 \`vibe agent\`
+- "I have a finished script + visual identity" \u2192 \`vibe build\`
+- "I want this to run again next month" \u2192 \`vibe run\`
+
+If two seem to fit, pick the rightmost one \u2014 more reproducible, less surprise.
+
+## Cost-tier awareness (v0.83+)
+
+Every primitive subcommand carries a cost tier (\`free\` / \`low\` / \`high\` /
+\`very-high\`). \`vibe schema --list\` exposes the tier as JSON, and each
+\`vibe <group> <sub> --help\` page shows it as a colored footer. Use
+\`vibe doctor --test-keys\` before kicking off any high-cost orchestrator \u2014
+a single bad key wastes time and money.
+
+## Cross-command primitives
+
+All three commands ultimately call the same primitives:
+\`generate\` / \`edit\` / \`audio\` / \`inspect\` / \`detect\` / \`remix\`. The
+agent calls them through a tool manifest; \`build\` calls a curated subset
+(TTS + image + compose + render); \`run\` exposes 55+ actions one per primitive.
+
+## Known overlap
+
+- \`vibe build\` is conceptually a 4-step pipeline; \`vibe run\` could express
+  the same flow but build's STORYBOARD.md input + opinionated defaults are
+  the value-add.
+- \`vibe agent\`'s tool registry currently exposes primitives, not
+  orchestrators. Adding \`vibe.build\` / \`vibe.run\` as agent tools is on the
+  table for a future major.
+- \`vibe run --resume\` has no analog in build/agent; build's idempotent
+  re-invoke covers the common case.
+`;
 var META = {
   scene: {
     title: "Scene authoring with vibe",
@@ -468205,13 +468266,32 @@ var META = {
       "vibe schema --list",
       "vibe doctor"
     ]
+  },
+  architecture: {
+    title: "vibe agent / build / run \u2014 when to pick which",
+    summary: "Compare the three orchestrating commands on the dimensions that actually decide the choice",
+    steps: [
+      "Pick agent for exploration (NL prompt, REPL, no checkpoints).",
+      "Pick build for STORYBOARD.md \u2192 MP4 with opinionated defaults.",
+      "Pick run for repeatable, budget-capped, checkpointed YAML pipelines.",
+      "Run `vibe doctor --test-keys` before any high-cost orchestrator to validate keys upfront.",
+      "Use `vibe schema --list` (cost field, v0.84) to plan the budget per step before kicking off `vibe run --budget-usd`."
+    ],
+    relatedCommands: [
+      "vibe agent",
+      "vibe build",
+      "vibe run",
+      "vibe doctor",
+      "vibe schema --list"
+    ]
   }
 };
 var CONTENT2 = {
   scene: SCENE_WALKTHROUGH,
-  pipeline: PIPELINE_WALKTHROUGH
+  pipeline: PIPELINE_WALKTHROUGH,
+  architecture: ARCHITECTURE_WALKTHROUGH
 };
-var WALKTHROUGH_TOPICS = ["scene", "pipeline"];
+var WALKTHROUGH_TOPICS = ["scene", "pipeline", "architecture"];
 function loadWalkthrough(topic) {
   const meta = META[topic];
   const content = CONTENT2[topic];

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@vibeframe/mcp-server",
-  "version": "0.83.0",
+  "version": "0.84.0",
   "description": "VibeFrame MCP Server - AI-native video editing via Model Context Protocol",
   "type": "module",
   "bin": {
@@ -57,8 +57,8 @@
     "tsx": "^4.21.0",
     "typescript": "^5.3.3",
     "vitest": "^1.2.2",
-    "@vibeframe/cli": "0.83.0",
-    "@vibeframe/core": "0.83.0"
+    "@vibeframe/cli": "0.84.0",
+    "@vibeframe/core": "0.84.0"
   },
   "engines": {
     "node": ">=20"