@vxil/cli 0.11.0 → 0.12.0

package/dist/vxil.js

@@ -4462,8 +4462,8 @@ function lowerAllTriggerBindings(def, name) {
 }
 var CONFIG_FILENAMES = ["vxil.config.ts", "vxil.config.mjs", "vxil.config.js"];
 var VXIL_CONFIG_PKG_VERSION = "0.7.0";
-var VXIL_SDK_PKG_VERSION = "0.11.0";
-var VXIL_CLI_PKG_VERSION = "0.11.0";
+var VXIL_SDK_PKG_VERSION = "0.12.0";
+var VXIL_CLI_PKG_VERSION = "0.12.0";
 function ensureScaffoldPackageJson(cwd, opts = {}) {
   const file = resolve(cwd, "package.json");
   const wanted = {
@@ -4748,6 +4748,7 @@ async function serverApply({ api, bundle, resume, allowDestructive, onPlan }) {
     `apply execute (resume with: vxil push --server --resume ${plan.apply_id})`
   );
 }
+var PUSH_READ_CONCURRENCY = 5;
 async function planOrPush({ api, features, apply, allowDestructive }) {
   const results = [];
   const destructiveQs = allowDestructive ? "&allow_destructive=true" : "";
@@ -4755,8 +4756,20 @@ async function planOrPush({ api, features, apply, allowDestructive }) {
     const v = r.body.data?.api_state;
     return v && typeof v === "object" && typeof v.ok === "boolean" ? v : void 0;
   };
-  for (const [feature, manifest] of Object.entries(features)) {
-    const dry = await api("PUT", `/v1/config/${feature}?dry_run=true${destructiveQs}`, manifest);
+  const entries = Object.entries(features);
+  const reads = await mapPool(entries, PUSH_READ_CONCURRENCY, async ([feature, manifest]) => {
+    try {
+      const dry = await api("PUT", `/v1/config/${feature}?dry_run=true${destructiveQs}`, manifest);
+      if (dry.status !== 200) return { dry };
+      return { dry, cur: await api("GET", `/v1/config/${feature}`) };
+    } catch (err) {
+      return { err };
+    }
+  });
+  for (const [i, [feature, manifest]] of entries.entries()) {
+    const read = reads[i];
+    if ("err" in read) throw read.err;
+    const dry = read.dry;
     if (dry.status !== 200) {
       const e = dry.body.error ?? {};
       throw new Error(
@@ -4765,7 +4778,7 @@ async function planOrPush({ api, features, apply, allowDestructive }) {
     }
     const effective = dry.body.data?.manifest;
     const apiStatePlan = apiStateOf(dry);
-    const cur = await api("GET", `/v1/config/${feature}`);
+    const cur = read.cur;
     const unavailable = readUnavailable(`GET /v1/config/${feature}`, cur);
     if (unavailable) {
       if (apply) {
@@ -7706,6 +7719,58 @@ function hookReconcileOf(data2) {
 function hookReconcileRemedy(fnName) {
   return fnName ? `re-run the reconcile with \`vxil functions deploy ${fnName} --force\` or \`vxil push --server\` (a plain re-push sends no deploy for an unchanged function, so it would not retry it)` : "re-run the reconcile with `vxil push --server` (a plain re-push sends no deploy, so it would not retry it)";
 }
+var WIRING_WARNING = /trigger subscription|cron schedule/i;
+function triggerWiringOf(data2) {
+  if (!data2) return null;
+  const counts = (v) => {
+    if (!v || typeof v !== "object" || Array.isArray(v)) return void 0;
+    const o = v;
+    const n = (x) => typeof x === "number" && Number.isFinite(x) ? x : 0;
+    const opt = (x) => typeof x === "number" && Number.isFinite(x) ? x : void 0;
+    const updated = opt(o.updated);
+    const unchanged = opt(o.unchanged);
+    return {
+      created: n(o.created),
+      ...updated !== void 0 ? { updated } : {},
+      ...unchanged !== void 0 ? { unchanged } : {},
+      deleted: n(o.deleted),
+      failed: n(o.failed)
+    };
+  };
+  const cms = counts(data2.cms_hook_subscriptions);
+  const webhook = counts(data2.webhook_subscriptions);
+  const cron = counts(data2.cron_schedules);
+  const total = counts(data2.hook_reconcile);
+  if (!total && !cms && !webhook && !cron) return null;
+  const warnings = Array.isArray(data2.warnings) ? data2.warnings.filter((w) => typeof w === "string" && WIRING_WARNING.test(w)) : [];
+  return {
+    total: total ?? { created: 0, deleted: 0, failed: (cms?.failed ?? 0) + (webhook?.failed ?? 0) + (cron?.failed ?? 0) },
+    ...cms ? { cms_hook_subscriptions: cms } : {},
+    ...webhook ? { webhook_subscriptions: webhook } : {},
+    ...cron ? { cron_schedules: cron } : {},
+    warnings
+  };
+}
+function formatTriggerWiring(r) {
+  const line = (c) => [
+    `${c.created} created`,
+    ...c.updated !== void 0 ? [`${c.updated} updated`] : [],
+    ...c.unchanged !== void 0 ? [`${c.unchanged} unchanged`] : [],
+    `${c.deleted} removed`,
+    `${c.failed} failed`
+  ].join(" \xB7 ");
+  const lanes = [
+    ["hook subscriptions (cms/auth)", r.cms_hook_subscriptions],
+    ["webhook-trigger subscriptions", r.webhook_subscriptions],
+    ["cron schedules", r.cron_schedules]
+  ];
+  const out = [r.total.failed > 0 ? `trigger wiring (reconciled by the server) \u2014 ${r.total.failed} FAILED:` : "trigger wiring (reconciled by the server):"];
+  const shown = lanes.filter(([, c]) => c);
+  if (shown.length) for (const [label, c] of shown) out.push(`  ${label.padEnd(30)}  ${line(c)}`);
+  else out.push(`  ${"all triggers".padEnd(30)}  ${line(r.total)}`);
+  for (const w of r.warnings) out.push(`  ! ${w}`);
+  return out;
+}
 function sourceSha12(source, runtime) {
   const suffix = runtime ? functionsRuntimeHashSuffix(runtime) : "";
   return createHash("sha256").update(source + suffix, "utf8").digest("hex").slice(0, 12);
@@ -12302,7 +12367,7 @@ var TOOLS = [
   {
     name: "search_query",
     feature: "vector-search",
-    description: "Retrieve the top-k most relevant chunks from a vector-search collection. mode 'hybrid' (default) fuses semantic + keyword via RRF; 'vector' is pure semantic; 'keyword' is lexical. filter is a JSON object of equality constraints over chunk metadata. Returns scored results with document/chunk attribution.",
+    description: "Retrieve the top-k most relevant chunks from a vector-search collection. mode 'hybrid' (default) fuses semantic + keyword via RRF; 'vector' is pure semantic; 'keyword' is lexical. filter is a JSON object of equality constraints over chunk metadata. Returns ranked results with document/chunk attribution: score is the fused rank value (orders the hits, not a similarity); similarity is the cosine similarity to the query (-1..1, null in keyword mode) \u2014 threshold on similarity.",
     inputSchema: {
       type: "object",
       properties: {
@@ -12496,7 +12561,7 @@ var TOOLS = [
         filter: { type: "object", additionalProperties: true, description: "Metadata equality filter applied to retrieval." },
         rerank: { type: "boolean", description: "Forward rerank:true to vector-search's BYO rerank pass (inert until configured there)." },
         boosts: { type: "object", additionalProperties: true, description: "Per-metadata-field boost specs: { field: { kind:'recency', halfLifeDays?, weight? } | { kind:'value', weights:{\u2026} } }." },
-        min_score: { type: "number", description: "Drop hits below this EFFECTIVE (post-boost) score." }
+        min_score: { type: "number", description: "Drop hits below this EFFECTIVE (post-boost) score. score is a rank value (about 0.016-0.033 at the top), so a floor above ~0.033 drops every hit; judge relevance by each hit's similarity instead." }
       },
       required: ["query"]
     },
@@ -13933,7 +13998,7 @@ var VERB_USAGE = {
   mcp: "usage: vxil mcp install [--client cursor|claude|vscode] [--project] [--print] [--key <api_key>] [--scopes a,b] [--name <server>]",
   plan: "usage: vxil plan [--dev|--target <name>] [--explain] [--skip-functions]  \u2014 what `vxil push` would change: cms schema, feature config, declared API state, functions (a deployed function the config no longer declares shows as `-`); writes nothing",
   diff: "usage: vxil diff [--against <target>|--exit-code] [--explain] [--ignore <k,\u2026>] [--strict-secrets] [--strict-api-state] [--api-state] [--json]  \u2014 the CI gate: exit 0 no drift \xB7 1 drift \xB7 2 error",
-  push: "usage: vxil push [--dev|--target <name>|--prod] [--allow-destructive] [--strict] [--server [--resume <apply_id>]] [--no-gen] [--skip-functions] [--yes]  \u2014 apply the config; --allow-destructive also deletes deployed functions and stored AI templates the config no longer declares; --strict exits 1 when anything declared was refused, deferred or left unwired",
+  push: "usage: vxil push [--dev|--target <name>|--prod] [--allow-destructive] [--strict] [--server [--resume <apply_id>]] [--no-gen] [--skip-functions] [--yes]  \u2014 apply the config; --allow-destructive also deletes deployed functions and stored AI templates the config no longer declares; --strict exits 1 when anything declared was refused, deferred or left unwired; --server prints the trigger wiring the server reconciled (--json: one result document on stdout)",
   gen: "usage: vxil gen [--check] [--offline] [--out <f>] [--no-mcp] [--mcp-out <f>]  \u2014 generate vxil.types.ts (+ vxil.mcp.json); --offline keeps an existing API_VERSIONS block; --check compares instead of writing",
   types: "usage: vxil types  \u2014 alias of `vxil gen` (run `vxil gen --help`)",
   doctor: "usage: vxil doctor [--dev|--target <name>]  \u2014 preflight: the binding's tenant vs the key's tenant, secrets referenced-vs-stored, per-function hashes, keys (read-only)",
@@ -14022,6 +14087,32 @@ function pushExitCode(p, strict) {
   if (p.strict.length) lines.push(`${p.strict.length} warning(s) \u2014 \`vxil push --strict\` turns them into exit 1 for CI`);
   return { code: 0, lines };
 }
+function serverApplyJson(input) {
+  const { view, triggerWiring, problems, exitCode, error } = input;
+  return {
+    ok: exitCode === 0,
+    exit_code: exitCode,
+    apply_id: view.apply_id,
+    status: view.status,
+    steps: view.steps,
+    ...view.failed_step ? { failed_step: view.failed_step } : {},
+    trigger_wiring: triggerWiring ?? null,
+    problems: { hard: problems.hard, strict: problems.strict },
+    ...error ? { error } : {}
+  };
+}
+function serverApplyErrorJson(input) {
+  return {
+    ok: false,
+    exit_code: input.exitCode,
+    apply_id: null,
+    status: null,
+    steps: [],
+    trigger_wiring: null,
+    problems: { hard: [], strict: [] },
+    error: input.error
+  };
+}
 
 // src/paymentsCmd.ts
 var SIMULATE_SCENARIOS = [
@@ -19669,12 +19760,19 @@ function hasFlag(name) {
   return rest.includes(`--${name}`);
 }
 var jsonOut = rest.includes("--json");
+var jsonFailDoc = null;
 function ttlFlag(fallback) {
   const parsed = parseTtlFlag(flag("ttl"), fallback);
   if ("error" in parsed) fail(parsed.error);
   return parsed.hours;
 }
 function fail(msg, code = 1) {
+  if (jsonFailDoc) {
+    const doc = jsonFailDoc;
+    jsonFailDoc = null;
+    process.stdout.write(`${doc(msg, code)}
+`);
+  }
   console.error(`vxil: ${msg}`);
   process.exit(code);
 }
@@ -20566,22 +20664,79 @@ async function backendListsFunctions(api) {
   }
 }
 async function runServerApply(sel) {
+  armServerApplyJsonFail();
   const { api, target } = requireApi(sel, { write: "push --server" });
+  const say = (s) => {
+    if (jsonOut) console.error(s);
+    else console.log(s);
+  };
+  const strict = hasFlag("strict");
+  const finish = async (done2, problems2, code, error) => {
+    jsonFailDoc = null;
+    if (jsonOut) {
+      const doc = JSON.stringify(serverApplyJson({
+        view: done2,
+        triggerWiring: triggerWiringOf(done2),
+        problems: problems2,
+        exitCode: code,
+        ...error ? { error } : {}
+      }));
+      await new Promise((r) => {
+        process.stdout.write(`${doc}
+`, () => r());
+      });
+    }
+    if (error) fail(error, code);
+    process.exit(code);
+  };
+  const armWith = (done2, problems2) => {
+    if (!jsonOut) return;
+    jsonFailDoc = (error, exitCode) => JSON.stringify(serverApplyJson({
+      view: done2,
+      triggerWiring: triggerWiringOf(done2),
+      problems: problems2,
+      exitCode,
+      error
+    }));
+  };
+  const report = (done2, wiring) => {
+    say(formatApplySteps(done2.steps));
+    say(`
+apply ${done2.apply_id}: ${done2.status}`);
+    if (!wiring) return;
+    const w = triggerWiringOf(done2);
+    if (w) say(`
+${formatTriggerWiring(w).join("\n")}`);
+  };
+  const gen = async () => {
+    if (hasFlag("no-gen")) return;
+    if (!jsonOut) {
+      await runGen(sel);
+      return;
+    }
+    const log = console.log;
+    console.log = (...a) => {
+      console.error(...a);
+    };
+    try {
+      await runGen(sel);
+    } finally {
+      console.log = log;
+    }
+  };
   const resume = flag("resume");
   if (resume) {
     const done2 = await serverApply({ api, resume });
-    console.log(formatApplySteps(done2.steps));
-    console.log(`
-apply ${done2.apply_id}: ${done2.status}`);
-    if (done2.status === "running") console.log(`resume with: vxil push --server --resume ${done2.apply_id}`);
-    if (done2.status !== "succeeded" && done2.status !== "running") process.exit(1);
-    if (done2.status === "succeeded" && !hasFlag("no-gen")) await runGen(sel);
+    report(done2, true);
     const resumed = { hard: [], strict: [] };
+    armWith(done2, resumed);
+    if (done2.status === "running") say(`resume with: vxil push --server --resume ${done2.apply_id}`);
+    if (done2.status !== "succeeded" && done2.status !== "running") return finish(done2, resumed, 1);
+    if (done2.status === "succeeded") await gen();
     applyHookProblems(done2, resumed);
-    const exitResumed = pushExitCode(resumed, hasFlag("strict"));
+    const exitResumed = pushExitCode(resumed, strict);
     for (const line of exitResumed.lines) console.error(`vxil: ${line}`);
-    if (exitResumed.code !== 0) process.exit(exitResumed.code);
-    return;
+    return finish(done2, resumed, exitResumed.code);
   }
   const loaded = await loadVxilConfig();
   const cwd = process.cwd();
@@ -20589,7 +20744,7 @@ apply ${done2.apply_id}: ${done2.status}`);
   const cfg = hasFlag("skip-functions") ? rest2 : loaded;
   const fnNames = Object.keys(cfg.functions ?? {});
   if (hasFlag("skip-functions") && declaredFns && Object.keys(declaredFns).length) {
-    console.log(`functions: skipped (--skip-functions) \u2014 ${Object.keys(declaredFns).length} declared function(s) not deployed`);
+    say(`functions: skipped (--skip-functions) \u2014 ${Object.keys(declaredFns).length} declared function(s) not deployed`);
   }
   if (fnNames.length) {
     const ent = await probeFunctionsEntitlement(api, fnNames[0]);
@@ -20614,33 +20769,30 @@ apply ${done2.apply_id}: ${done2.status}`);
     bundle,
     allowDestructive: hasFlag("allow-destructive"),
     onPlan: (plan) => {
-      console.log(`plan (apply ${plan.apply_id}):`);
-      console.log(formatApplySteps(plan.steps));
-      for (const w of plan.warnings ?? []) console.log(`  ! ${w}`);
-      console.log("\napplying server-side\u2026");
+      say(`plan (apply ${plan.apply_id}):`);
+      say(formatApplySteps(plan.steps));
+      for (const w of plan.warnings ?? []) say(`  ! ${w}`);
+      say("\napplying server-side\u2026");
     }
   });
-  console.log(formatApplySteps(done.steps));
-  console.log(`
-apply ${done.apply_id}: ${done.status}`);
   if (done.status === "running") {
     const errored = done.steps.filter((st) => st.status === "pending" && st.error);
     const onlyDeferredApiState = errored.length > 0 && errored.every((st) => st.kind === "api-state" && (st.error ?? "").startsWith("deferred:"));
     if (onlyDeferredApiState) {
-      console.log("  \u2026 declared API state deferred (the feature config is still propagating) \u2014 waiting 30 s, then resuming the same apply");
+      report(done, false);
+      say("  \u2026 declared API state deferred (the feature config is still propagating) \u2014 waiting 30 s, then resuming the same apply");
       await new Promise((r) => setTimeout(r, 3e4));
       done = await serverApply({ api, resume: done.apply_id });
-      console.log(formatApplySteps(done.steps));
-      console.log(`
-apply ${done.apply_id}: ${done.status}`);
     }
   }
+  report(done, true);
+  const problems = { hard: [], strict: [] };
+  armWith(done, problems);
   if (done.status === "running") {
-    fail(`a transient step failure interrupted the apply \u2014 resume with: vxil push --server --resume ${done.apply_id}`);
+    return finish(done, problems, 1, `a transient step failure interrupted the apply \u2014 resume with: vxil push --server --resume ${done.apply_id}`);
   }
   const standing = done.steps.filter((st) => st.kind === "api-state" && st.status === "failed");
   const onlyApiStateFailed = done.steps.every((st) => st.status !== "failed" || st.kind === "api-state");
-  const problems = { hard: [], strict: [] };
   if (done.status === "partial" && standing.length && onlyApiStateFailed && done.failed_step?.kind === "api-state" && done.steps.every((st) => st.status !== "rolled_back")) {
     for (const st of standing) {
       console.error(`vxil: warning \u2014 ${st.target} not converged: ${st.error ?? ""} (the config stands; fix the cause and re-push)`);
@@ -20648,7 +20800,7 @@ apply ${done.apply_id}: ${done.status}`);
     }
   } else if (done.status !== "succeeded") {
     const f = done.failed_step;
-    fail(`apply ${done.status}${f ? ` \u2014 step ${f.seq} (${f.kind} ${f.target}): ${f.error}` : ""} (config/functions were rolled back to their pre-apply versions; cms schema additions were kept)`);
+    return finish(done, problems, 1, `apply ${done.status}${f ? ` \u2014 step ${f.seq} (${f.kind} ${f.target}): ${f.error}` : ""} (config/functions were rolled back to their pre-apply versions; cms schema additions were kept)`);
   }
   applyHookProblems(done, problems);
   if (!hasFlag("skip-functions") && (fnNames.length || cfg.features.functions || await backendListsFunctions(api))) {
@@ -20662,24 +20814,26 @@ apply ${done.apply_id}: ${done.status}`);
       for (const name of deployed.filter((n) => !fnNames.includes(n)).sort()) {
         if (hasFlag("allow-destructive")) {
           const del = await deleteRemoteFunction(api, name);
-          console.log(`  - ${name} [deployed, not in vxil.config] \u2014 ${del.gone ? "already gone" : "deleted (--allow-destructive)"}`);
+          say(`  - ${name} [deployed, not in vxil.config] \u2014 ${del.gone ? "already gone" : "deleted (--allow-destructive)"}`);
           if (del.hook && del.hook.failed > 0) problems.hard.push(`trigger wiring: ${del.hook.failed} subscription(s) failed to reconcile after deleting ${name} \u2014 ${hookReconcileRemedy(fnNames[0])}`);
         } else {
-          console.log(`  - ${name} [deployed, not in vxil.config] \u2014 kept; \`vxil push --server --allow-destructive\` deletes it`);
+          say(`  - ${name} [deployed, not in vxil.config] \u2014 kept; \`vxil push --server --allow-destructive\` deletes it`);
           problems.strict.push(`deployed but not declared (kept): ${name}`);
         }
       }
     }
   }
-  if (!hasFlag("no-gen")) await runGen(sel);
-  const exitWith = pushExitCode(problems, hasFlag("strict"));
+  await gen();
+  const exitWith = pushExitCode(problems, strict);
   for (const line of exitWith.lines) console.error(`vxil: ${line}`);
-  if (exitWith.code !== 0) process.exit(exitWith.code);
+  return finish(done, problems, exitWith.code);
+}
+function armServerApplyJsonFail() {
+  if (jsonOut) jsonFailDoc = (error, exitCode) => JSON.stringify(serverApplyErrorJson({ error, exitCode }));
 }
 function applyHookProblems(done, problems) {
   const hook = hookReconcileOf(done);
   if (!hook || hook.failed === 0) return;
-  console.error(`  ! trigger wiring: ${hook.warning ?? `${hook.failed} trigger subscription(s) could not be written`}`);
   problems.hard.push(`trigger wiring: ${hook.failed} subscription(s) failed to reconcile \u2014 a function may be wired to nothing; re-run \`vxil push --server\` (every executed apply re-runs the reconcile)`);
 }
 async function runSeed(sel, opts = {}) {
@@ -21877,6 +22031,7 @@ ${formatSummary(state)}`);
       break;
     }
     case "push": {
+      if (hasFlag("server") || flag("resume") !== void 0) armServerApplyJsonFail();
       if (hasFlag("prod") && (hasFlag("dev") || flag("target") !== void 0)) fail("--prod cannot be combined with --dev / --target \u2014 pick one target");
       const sel = selector();
       const pushTarget = resolveTargetOrFail(sel);
@@ -22180,7 +22335,11 @@ export default defineConfig(${JSON.stringify({ features: featBlocks, cms: { coll
         console.log(`scaffolded functions/${name}.ts \u2014 declare it in vxil.config.ts \`functions\` and \`vxil push\``);
       } else if (sub === "list") {
         const { api } = requireApi(selector());
-        printEnvelope(await api("GET", "/v1/functions"));
+        const listRes = await api("GET", "/v1/functions");
+        printEnvelope(listRes);
+        if (listRes.status === 200 && listRes.body?.data?.enabled === false) {
+          console.error("vxil: these functions are PAUSED for the whole project (every invoke answers 404) \u2014 a Free project on the production workload, or a plan downgrade. `vxil projects workload <slug> staging` or an upgrade resumes them.");
+        }
       } else if (sub === "delete") {
         if (!name) fail("usage: vxil functions delete <name>");
         const { api } = requireApi(selector(), { write: `functions delete ${name}` });

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@vxil/cli",
-  "version": "0.11.0",
+  "version": "0.12.0",
   "private": false,
   "description": "The vxil CLI — init, quickstart, push, gen, secrets, keys, migrate, doctor, diff, functions, payments; installs the `vxil` command (npm i -g @vxil/cli).",
   "license": "MIT",
@@ -47,9 +47,9 @@
   "devDependencies": {
     "miniflare": "^4.20260611.0",
     "@vxil/config": "0.7.0",
-    "@vxil/feature-configs": "0.7.0",
     "@vxil/runtime": "0.0.1",
-    "@vxil/types": "0.0.1"
+    "@vxil/types": "0.0.1",
+    "@vxil/feature-configs": "0.7.0"
   },
   "scripts": {
     "build": "pnpm --filter @vxil/feature-configs run build && pnpm --filter @vxil/config run build && esbuild bin/vxil.ts --bundle --platform=node --format=esm --target=node24 --outfile=dist/vxil.js --banner:js='#!/usr/bin/env node' --external:esbuild --external:miniflare && esbuild src/config-entry.ts --bundle --platform=node --format=esm --target=node24 --outfile=dist/config.js && pnpm exec tsx scripts/build-config-dts.ts",