@vgai/cli 0.5.20 → 0.5.21

package/dist/index.js

@@ -20163,6 +20163,13 @@ function readRegisteredSessions() {
     return [];
   }
 }
+function servedProjectPath(body) {
+  const b = body;
+  return {
+    path: b.project?.path ?? b.serving?.path ?? null,
+    manifestError: b.project ? null : b.serving?.error ?? null
+  };
+}
 async function fetchJson(url3, timeoutMs) {
   try {
     const res = await fetch(url3, { signal: AbortSignal.timeout(timeoutMs) });
@@ -20281,9 +20288,15 @@ var init_transport = __esm({
         const base = editorUrl.replace(/\/+$/, "");
         const body = await fetchJson(`${base}/__editor/project`, timeoutMs);
         if (body === void 0) return void 0;
-        const project = body.project?.path ?? null;
+        const served = servedProjectPath(body);
         const port = url3.port ? Number(url3.port) : url3.protocol === "https:" ? 443 : 80;
-        return { port, project, pid: null, url: base };
+        return {
+          port,
+          project: served.path,
+          pid: null,
+          url: base,
+          manifestError: served.manifestError
+        };
       }
       async listSessions(timeoutMs) {
         const registered = readRegisteredSessions();
@@ -20295,11 +20308,12 @@ var init_transport = __esm({
               perProbeTimeout
             );
             if (body === void 0) return void 0;
-            const project = body.project?.path ?? null;
+            const served = servedProjectPath(body);
             const info = {
               port: s.port,
-              project,
-              pid: s.pid
+              project: served.path,
+              pid: s.pid,
+              manifestError: served.manifestError
             };
             return info;
           })
@@ -42688,6 +42702,10 @@ function readRegisteredSessions2() {
     return [];
   }
 }
+function servedProjectPath2(body) {
+  const b = body;
+  return b.project?.path ?? b.serving?.path ?? null;
+}
 async function fetchJson2(url3, timeoutMs) {
   try {
     const res = await fetch(url3, { signal: AbortSignal.timeout(timeoutMs) });
@@ -42838,7 +42856,7 @@ var init_transport2 = __esm({
         const base = editorUrl.replace(/\/+$/, "");
         const body = await fetchJson2(`${base}/__editor/project`, timeoutMs);
         if (body === void 0) return void 0;
-        const project = body.project?.path ?? null;
+        const project = servedProjectPath2(body);
         const port = url3.port ? Number(url3.port) : url3.protocol === "https:" ? 443 : 80;
         return { port, project, pid: null, url: base };
       }
@@ -42852,7 +42870,7 @@ var init_transport2 = __esm({
               perProbeTimeout
             );
             if (body === void 0) return void 0;
-            const project = body.project?.path ?? null;
+            const project = servedProjectPath2(body);
             const info = {
               port: s.port,
               project,
@@ -45669,19 +45687,30 @@ function readProjectSession(projectRoot) {
     return null;
   }
 }
-async function verifyProjectSession(hint, projectRoot) {
+function servedProject(body) {
+  const b = body;
+  return {
+    path: b.project?.path ?? b.serving?.path ?? null,
+    manifestError: b.project ? null : b.serving?.error ?? null
+  };
+}
+async function probeServedProject(port) {
   try {
-    const response = await fetch(`http://127.0.0.1:${hint.port}/__editor/project`, {
+    const response = await fetch(`http://127.0.0.1:${port}/__editor/project`, {
       signal: AbortSignal.timeout(EDITOR_SESSION_DISCOVERY_TIMEOUT_MS)
     });
-    if (!response.ok) return false;
-    const body = await response.json();
-    const servedProject = body.project?.path;
-    return servedProject !== void 0 && canonicalPath(servedProject) === canonicalPath(projectRoot);
+    if (!response.ok) return void 0;
+    return servedProject(await response.json());
   } catch {
-    return false;
+    return void 0;
   }
 }
+function manifestRefusal(projectRoot, manifestError) {
+  return new Error(
+    `@vgai/live: the editor session for ${projectRoot} is live, but its vgai.project.json does not load, so there is no editor or game to drive \u2014 the editor page is showing this same error. Fix the manifest and retry; the session recovers on save, no restart needed.
+${manifestError}`
+  );
+}
 async function resolveSession(projectDir = process.cwd(), deps = {}) {
   const findRoot = deps.findProjectRootFrom ?? findProjectRootFrom;
   const transport = deps.transport ?? new HttpEditorTransport();
@@ -45692,8 +45721,18 @@ async function resolveSession(projectDir = process.cwd(), deps = {}) {
     );
   }
   const localHint = (deps.readProjectSession ?? readProjectSession)(projectRoot);
-  if (localHint && await (deps.verifyProjectSession ?? verifyProjectSession)(localHint, projectRoot)) {
-    return { port: localHint.port, projectRoot };
+  if (localHint) {
+    if (deps.verifyProjectSession) {
+      if (await deps.verifyProjectSession(localHint, projectRoot)) {
+        return { port: localHint.port, projectRoot };
+      }
+    } else {
+      const served = await probeServedProject(localHint.port);
+      if (served?.path != null && canonicalPath(served.path) === canonicalPath(projectRoot)) {
+        if (served.manifestError !== null) throw manifestRefusal(projectRoot, served.manifestError);
+        return { port: localHint.port, projectRoot };
+      }
+    }
   }
   let sessions2;
   try {
@@ -45713,6 +45752,7 @@ async function resolveSession(projectDir = process.cwd(), deps = {}) {
       `@vgai/live: no live editor session found for ${projectRoot}. @vgai/live only attaches to an already-running session \u2014 it never starts one \u2014 so run \`vgai edit\` in that project first, then retry.` + (otherCount > 0 ? ` (${otherCount} other live session(s) found, but none open this project \u2014 @vgai/live never silently attaches to a different project.)` : "")
     );
   }
+  if (match.manifestError != null) throw manifestRefusal(projectRoot, match.manifestError);
   return { port: match.port, projectRoot };
 }
 var init_session = __esm({
@@ -307087,6 +307127,9 @@ var require_lib = __commonJS({
 
 // src/index.ts
 init_src();
+init_src3();
+init_src2();
+init_inspection_node();
 import { execFileSync as execFileSync7, spawn as spawn4 } from "node:child_process";
 import {
   closeSync as closeSync3,
@@ -307106,234 +307149,6 @@ import { setTimeout as delay } from "node:timers/promises";
 import { fileURLToPath as fileURLToPath5, pathToFileURL as pathToFileURL2 } from "node:url";
 import { inspect } from "node:util";
 
-// ../editor/src/ingest/coverage-accounting.ts
-var CoverageReconcileError = class extends Error {
-  constructor(message) {
-    super(`coverage-accounting: ${message}`);
-    this.name = "CoverageReconcileError";
-  }
-};
-function coverageSeamFamily(seam) {
-  const dot = seam.indexOf(".");
-  return dot === -1 ? seam : seam.slice(0, dot);
-}
-function subjectFromDetail(detail) {
-  if (!detail) return null;
-  const match = /^\[([^\]]+)\] /.exec(detail);
-  return match?.[1] ?? null;
-}
-function rowSubject(row) {
-  if (row.subject !== void 0 && row.subject !== null && row.subject !== "") {
-    return row.subject;
-  }
-  return subjectFromDetail(row.detail);
-}
-function foldSeam(existing, status) {
-  const fold = existing ?? { gap: false, applicable: false };
-  if (status === "na") return fold;
-  return { gap: fold.gap || status === "gap", applicable: true };
-}
-function familyAccounting(family, rows) {
-  const folds = /* @__PURE__ */ new Map();
-  for (const row of rows) {
-    folds.set(row.seam, foldSeam(folds.get(row.seam), row.status));
-  }
-  let capabilities = 0;
-  let capabilityGaps = 0;
-  for (const fold of folds.values()) {
-    if (!fold.applicable) continue;
-    capabilities += 1;
-    if (fold.gap) capabilityGaps += 1;
-  }
-  return { family, capabilities, capabilityGaps, rootInstances: rows.length };
-}
-function deriveCoverageAccounting(rows) {
-  const subjects = /* @__PURE__ */ new Set();
-  const familyRows = /* @__PURE__ */ new Map();
-  for (const row of rows) {
-    const subject = rowSubject(row);
-    if (subject !== null) subjects.add(subject);
-    const family = coverageSeamFamily(row.seam);
-    const list = familyRows.get(family);
-    if (list) list.push(row);
-    else familyRows.set(family, [row]);
-  }
-  const families = [...familyRows].map(
-    ([family, familyList]) => familyAccounting(family, familyList)
-  );
-  const folds = /* @__PURE__ */ new Map();
-  for (const row of rows) {
-    folds.set(row.seam, foldSeam(folds.get(row.seam), row.status));
-  }
-  let capabilities = 0;
-  let capabilityGaps = 0;
-  for (const fold of folds.values()) {
-    if (!fold.applicable) continue;
-    capabilities += 1;
-    if (fold.gap) capabilityGaps += 1;
-  }
-  return {
-    capabilities,
-    capabilityGaps,
-    rootsGraded: subjects.size,
-    rootInstances: rows.length,
-    families
-  };
-}
-function formatCoverageMissingLead(accounting) {
-  return `${accounting.capabilityGaps} of ${accounting.capabilities} capabilities are MISSING`;
-}
-function formatCoverageDerivation(accounting) {
-  const roots = accounting.rootsGraded > 0 ? `${accounting.rootsGraded} roots graded; ` : "";
-  return `${roots}${accounting.rootInstances} root-instances`;
-}
-function formatCoverageFamilyBreakdown(family, opts = {}) {
-  const roots = opts.rootsGraded ?? 0;
-  const showInstances = family.rootInstances !== family.capabilities || roots > 1;
-  const head = `${family.family} ${family.capabilityGaps} of ${family.capabilities} capabilities`;
-  if (!showInstances) return head;
-  const rootsBit = roots > 1 ? `${roots} roots graded; ` : "";
-  return `${head} (${rootsBit}${family.rootInstances} root-instances)`;
-}
-function parseCoverageHeadline(headline) {
-  const lead = /(\d+) of (\d+) capabilities are MISSING/.exec(headline);
-  if (!lead) {
-    throw new CoverageReconcileError(
-      'headline does not state the capabilities unit (missing "N of M capabilities are MISSING")'
-    );
-  }
-  const roots = /(\d+) roots graded/.exec(headline);
-  const instances2 = /(\d+) root-instances/.exec(headline);
-  if (!instances2) {
-    throw new CoverageReconcileError("headline does not state root-instances");
-  }
-  return {
-    capabilityGaps: Number(lead[1]),
-    capabilities: Number(lead[2]),
-    rootsGraded: roots ? Number(roots[1]) : 0,
-    rootInstances: Number(instances2[1])
-  };
-}
-function assertCoverageReconciles(rows, headline) {
-  const derived = deriveCoverageAccounting(rows);
-  const parsed = parseCoverageHeadline(headline);
-  if (parsed.capabilityGaps !== derived.capabilityGaps) {
-    throw new CoverageReconcileError(
-      `headline capability-gaps ${parsed.capabilityGaps} !== row-derived ${derived.capabilityGaps}`
-    );
-  }
-  if (parsed.capabilities !== derived.capabilities) {
-    throw new CoverageReconcileError(
-      `headline capabilities ${parsed.capabilities} !== row-derived ${derived.capabilities}`
-    );
-  }
-  if (parsed.rootInstances !== derived.rootInstances) {
-    throw new CoverageReconcileError(
-      `headline root-instances ${parsed.rootInstances} !== row-derived ${derived.rootInstances}`
-    );
-  }
-  if (parsed.rootsGraded !== derived.rootsGraded) {
-    throw new CoverageReconcileError(
-      `headline roots-graded ${parsed.rootsGraded} !== row-derived ${derived.rootsGraded}`
-    );
-  }
-  const familyInstanceSum = derived.families.reduce((sum, family) => sum + family.rootInstances, 0);
-  if (familyInstanceSum !== derived.rootInstances) {
-    throw new CoverageReconcileError(
-      `family root-instances ${familyInstanceSum} !== ${derived.rootInstances}`
-    );
-  }
-  const familyCapabilitySum = derived.families.reduce(
-    (sum, family) => sum + family.capabilities,
-    0
-  );
-  if (familyCapabilitySum !== derived.capabilities) {
-    throw new CoverageReconcileError(
-      `family capabilities ${familyCapabilitySum} !== ${derived.capabilities}`
-    );
-  }
-}
-
-// src/coverage-warning.ts
-function coverageRowsOf(facet, subject) {
-  const rows = facet?.rows;
-  if (!Array.isArray(rows)) return [];
-  const read = [];
-  for (const row of rows) {
-    if (typeof row !== "object" || row === null) continue;
-    const candidate = row;
-    if (typeof candidate.seam !== "string" || typeof candidate.status !== "string") continue;
-    read.push({
-      seam: candidate.seam,
-      status: candidate.status,
-      ...typeof candidate.missing === "string" ? { missing: candidate.missing } : {},
-      ...typeof candidate.fix === "string" ? { fix: candidate.fix } : {},
-      subject
-    });
-  }
-  return read;
-}
-function coverageWarning(state) {
-  const ingest = state.ingest;
-  const ingestWorldId = typeof ingest?.worldId === "string" ? ingest.worldId : null;
-  const collected = [
-    // The ingest mount's own report first: it is the richest one, so where it
-    // and `rootCoverage` describe the same root, its row is the one kept.
-    ...coverageRowsOf(ingest?.coverage, ingestWorldId),
-    ...(Array.isArray(state.rootCoverage) ? state.rootCoverage : []).flatMap(
-      (entry) => coverageRowsOf(
-        entry,
-        typeof entry?.worldId === "string" ? entry.worldId ?? null : null
-      )
-    ),
-    ...coverageRowsOf(state.systemCoverage, null),
-    ...coverageRowsOf(state.projectCoverage, null),
-    ...coverageRowsOf(state.authoringCoverage, null)
-  ];
-  const seen = /* @__PURE__ */ new Set();
-  const rows = collected.filter((row) => {
-    const key = `${row.subject ?? ""}\0${row.seam}`;
-    if (seen.has(key)) return false;
-    seen.add(key);
-    return true;
-  });
-  const gaps = rows.filter((row) => row.status === "gap");
-  if (gaps.length === 0) return null;
-  const accounting = deriveCoverageAccounting(rows);
-  const lead = formatCoverageMissingLead(accounting);
-  assertCoverageReconciles(rows, `${lead} (${formatCoverageDerivation(accounting)})`);
-  const breakdown = accounting.families.map(
-    (family) => formatCoverageFamilyBreakdown(family, {
-      rootsGraded: family.family === "editor" ? accounting.rootsGraded : 0
-    })
-  ).join(", ");
-  const subject = ingestWorldId ?? state.projectName ?? "(this session)";
-  const lines = gaps.flatMap((gap) => [
-    `  \u2717 ${gap.subject ? `${gap.subject}: ` : ""}${gap.seam}`,
-    ...gap.missing ? [`      missing: ${gap.missing}`] : [],
-    ...gap.fix ? [`      fix: ${gap.fix}`] : []
-  ]);
-  return [
-    "================================================================",
-    `  COVERAGE \u2014 ${lead.toUpperCase()} IN "${subject}" (${formatCoverageDerivation(accounting)})`,
-    `  by family: ${breakdown}`,
-    "================================================================",
-    "  This game is mounted and running. It is what the editor CANNOT do",
-    "  with it that is listed here \u2014 each line names the mechanism that",
-    "  would close the gap:",
-    "",
-    ...lines,
-    "",
-    "  The seams that ARE present are in the coverage facets in the JSON below.",
-    "================================================================"
-  ].join("\n");
-}
-
-// src/index.ts
-init_src3();
-init_src2();
-init_inspection_node();
-
 // ../create-vgai-project/src/scaffold.ts
 import { spawnSync as spawnSync3 } from "node:child_process";
 import {
@@ -313317,6 +313132,229 @@ function emitJsonCompact(payload) {
   );
 }
 
+// ../editor/src/ingest/coverage-accounting.ts
+var CoverageReconcileError = class extends Error {
+  constructor(message) {
+    super(`coverage-accounting: ${message}`);
+    this.name = "CoverageReconcileError";
+  }
+};
+function coverageSeamFamily(seam) {
+  const dot = seam.indexOf(".");
+  return dot === -1 ? seam : seam.slice(0, dot);
+}
+function subjectFromDetail(detail) {
+  if (!detail) return null;
+  const match = /^\[([^\]]+)\] /.exec(detail);
+  return match?.[1] ?? null;
+}
+function rowSubject(row) {
+  if (row.subject !== void 0 && row.subject !== null && row.subject !== "") {
+    return row.subject;
+  }
+  return subjectFromDetail(row.detail);
+}
+function foldSeam(existing, status) {
+  const fold = existing ?? { gap: false, applicable: false };
+  if (status === "na") return fold;
+  return { gap: fold.gap || status === "gap", applicable: true };
+}
+function familyAccounting(family, rows) {
+  const folds = /* @__PURE__ */ new Map();
+  for (const row of rows) {
+    folds.set(row.seam, foldSeam(folds.get(row.seam), row.status));
+  }
+  let capabilities = 0;
+  let capabilityGaps = 0;
+  for (const fold of folds.values()) {
+    if (!fold.applicable) continue;
+    capabilities += 1;
+    if (fold.gap) capabilityGaps += 1;
+  }
+  return { family, capabilities, capabilityGaps, rootInstances: rows.length };
+}
+function deriveCoverageAccounting(rows) {
+  const subjects = /* @__PURE__ */ new Set();
+  const familyRows = /* @__PURE__ */ new Map();
+  for (const row of rows) {
+    const subject = rowSubject(row);
+    if (subject !== null) subjects.add(subject);
+    const family = coverageSeamFamily(row.seam);
+    const list = familyRows.get(family);
+    if (list) list.push(row);
+    else familyRows.set(family, [row]);
+  }
+  const families = [...familyRows].map(
+    ([family, familyList]) => familyAccounting(family, familyList)
+  );
+  const folds = /* @__PURE__ */ new Map();
+  for (const row of rows) {
+    folds.set(row.seam, foldSeam(folds.get(row.seam), row.status));
+  }
+  let capabilities = 0;
+  let capabilityGaps = 0;
+  for (const fold of folds.values()) {
+    if (!fold.applicable) continue;
+    capabilities += 1;
+    if (fold.gap) capabilityGaps += 1;
+  }
+  return {
+    capabilities,
+    capabilityGaps,
+    rootsGraded: subjects.size,
+    rootInstances: rows.length,
+    families
+  };
+}
+function formatCoverageMissingLead(accounting) {
+  return `${accounting.capabilityGaps} of ${accounting.capabilities} capabilities are MISSING`;
+}
+function formatCoverageDerivation(accounting) {
+  const roots = accounting.rootsGraded > 0 ? `${accounting.rootsGraded} roots graded; ` : "";
+  return `${roots}${accounting.rootInstances} root-instances`;
+}
+function formatCoverageFamilyBreakdown(family, opts = {}) {
+  const roots = opts.rootsGraded ?? 0;
+  const showInstances = family.rootInstances !== family.capabilities || roots > 1;
+  const head = `${family.family} ${family.capabilityGaps} of ${family.capabilities} capabilities`;
+  if (!showInstances) return head;
+  const rootsBit = roots > 1 ? `${roots} roots graded; ` : "";
+  return `${head} (${rootsBit}${family.rootInstances} root-instances)`;
+}
+function parseCoverageHeadline(headline) {
+  const lead = /(\d+) of (\d+) capabilities are MISSING/.exec(headline);
+  if (!lead) {
+    throw new CoverageReconcileError(
+      'headline does not state the capabilities unit (missing "N of M capabilities are MISSING")'
+    );
+  }
+  const roots = /(\d+) roots graded/.exec(headline);
+  const instances2 = /(\d+) root-instances/.exec(headline);
+  if (!instances2) {
+    throw new CoverageReconcileError("headline does not state root-instances");
+  }
+  return {
+    capabilityGaps: Number(lead[1]),
+    capabilities: Number(lead[2]),
+    rootsGraded: roots ? Number(roots[1]) : 0,
+    rootInstances: Number(instances2[1])
+  };
+}
+function assertCoverageReconciles(rows, headline) {
+  const derived = deriveCoverageAccounting(rows);
+  const parsed = parseCoverageHeadline(headline);
+  if (parsed.capabilityGaps !== derived.capabilityGaps) {
+    throw new CoverageReconcileError(
+      `headline capability-gaps ${parsed.capabilityGaps} !== row-derived ${derived.capabilityGaps}`
+    );
+  }
+  if (parsed.capabilities !== derived.capabilities) {
+    throw new CoverageReconcileError(
+      `headline capabilities ${parsed.capabilities} !== row-derived ${derived.capabilities}`
+    );
+  }
+  if (parsed.rootInstances !== derived.rootInstances) {
+    throw new CoverageReconcileError(
+      `headline root-instances ${parsed.rootInstances} !== row-derived ${derived.rootInstances}`
+    );
+  }
+  if (parsed.rootsGraded !== derived.rootsGraded) {
+    throw new CoverageReconcileError(
+      `headline roots-graded ${parsed.rootsGraded} !== row-derived ${derived.rootsGraded}`
+    );
+  }
+  const familyInstanceSum = derived.families.reduce((sum, family) => sum + family.rootInstances, 0);
+  if (familyInstanceSum !== derived.rootInstances) {
+    throw new CoverageReconcileError(
+      `family root-instances ${familyInstanceSum} !== ${derived.rootInstances}`
+    );
+  }
+  const familyCapabilitySum = derived.families.reduce(
+    (sum, family) => sum + family.capabilities,
+    0
+  );
+  if (familyCapabilitySum !== derived.capabilities) {
+    throw new CoverageReconcileError(
+      `family capabilities ${familyCapabilitySum} !== ${derived.capabilities}`
+    );
+  }
+}
+
+// src/coverage-warning.ts
+function coverageRowsOf(facet, subject) {
+  const rows = facet?.rows;
+  if (!Array.isArray(rows)) return [];
+  const read = [];
+  for (const row of rows) {
+    if (typeof row !== "object" || row === null) continue;
+    const candidate = row;
+    if (typeof candidate.seam !== "string" || typeof candidate.status !== "string") continue;
+    read.push({
+      seam: candidate.seam,
+      status: candidate.status,
+      ...typeof candidate.missing === "string" ? { missing: candidate.missing } : {},
+      ...typeof candidate.fix === "string" ? { fix: candidate.fix } : {},
+      subject
+    });
+  }
+  return read;
+}
+function coverageWarning(state) {
+  const ingest = state.ingest;
+  const ingestWorldId = typeof ingest?.worldId === "string" ? ingest.worldId : null;
+  const collected = [
+    // The ingest mount's own report first: it is the richest one, so where it
+    // and `rootCoverage` describe the same root, its row is the one kept.
+    ...coverageRowsOf(ingest?.coverage, ingestWorldId),
+    ...(Array.isArray(state.rootCoverage) ? state.rootCoverage : []).flatMap(
+      (entry) => coverageRowsOf(
+        entry,
+        typeof entry?.worldId === "string" ? entry.worldId ?? null : null
+      )
+    ),
+    ...coverageRowsOf(state.systemCoverage, null),
+    ...coverageRowsOf(state.projectCoverage, null),
+    ...coverageRowsOf(state.authoringCoverage, null)
+  ];
+  const seen = /* @__PURE__ */ new Set();
+  const rows = collected.filter((row) => {
+    const key = `${row.subject ?? ""}\0${row.seam}`;
+    if (seen.has(key)) return false;
+    seen.add(key);
+    return true;
+  });
+  const gaps = rows.filter((row) => row.status === "gap");
+  if (gaps.length === 0) return null;
+  const accounting = deriveCoverageAccounting(rows);
+  const lead = formatCoverageMissingLead(accounting);
+  assertCoverageReconciles(rows, `${lead} (${formatCoverageDerivation(accounting)})`);
+  const breakdown = accounting.families.map(
+    (family) => formatCoverageFamilyBreakdown(family, {
+      rootsGraded: family.family === "editor" ? accounting.rootsGraded : 0
+    })
+  ).join(", ");
+  const subject = ingestWorldId ?? state.projectName ?? "(this session)";
+  const lines = gaps.flatMap((gap) => [
+    `  \u2717 ${gap.subject ? `${gap.subject}: ` : ""}${gap.seam}`,
+    ...gap.missing ? [`      missing: ${gap.missing}`] : [],
+    ...gap.fix ? [`      fix: ${gap.fix}`] : []
+  ]);
+  return [
+    "================================================================",
+    `  COVERAGE \u2014 ${lead.toUpperCase()} IN "${subject}" (${formatCoverageDerivation(accounting)})`,
+    `  by family: ${breakdown}`,
+    "================================================================",
+    "  This game is mounted and running. It is what the editor CANNOT do",
+    "  with it that is listed here \u2014 each line names the mechanism that",
+    "  would close the gap:",
+    "",
+    ...lines,
+    "",
+    "  The seams that ARE present are in the coverage facets in the JSON below.",
+    "================================================================"
+  ].join("\n");
+}
+
 // src/create-auto-edit-gate.ts
 function shouldAutoLaunchEditor(input) {
   if (input.noEditFlag) return false;
@@ -313504,7 +313542,15 @@ async function fetchEditorSession(port, timeoutMs = 5e3) {
     const session = body.session;
     return {
       port,
-      project: body.project?.path ?? null,
+      // `serving` is the server's own statement of "I AM serving this project,
+      // I just cannot describe it" — see the `!configResult.ok` branch of
+      // `/__editor/project` (`editor-server.ts`), which added it precisely
+      // because a bare `{ project: null }` is indistinguishable from "no
+      // project open". Reading only `project.path` collapsed the two here too,
+      // so a session whose manifest a save had just broken reported as
+      // `(no project)` and every project-matched command lost it.
+      project: body.project?.path ?? body.serving?.path ?? null,
+      manifestError: body.project ? null : body.serving?.error ?? null,
       pid: typeof session?.["pid"] === "number" ? session["pid"] : null,
       sessionId: typeof session?.["sessionId"] === "string" ? session["sessionId"] : null,
       repositoryId: typeof session?.["repositoryId"] === "string" ? session["repositoryId"] : null,
@@ -313704,6 +313750,7 @@ async function verifiedSessions(alsoCheckPort) {
       branch: probed.branch,
       headCommit: probed.headCommit,
       baseCommit: probed.baseCommit,
+      manifestError: probed.manifestError,
       registered: true,
       ...probed.ephemeral !== void 0 ? { ephemeral: probed.ephemeral } : {}
     });
@@ -313723,6 +313770,7 @@ async function verifiedSessions(alsoCheckPort) {
         branch: probed.branch,
         headCommit: probed.headCommit,
         baseCommit: probed.baseCommit,
+        manifestError: probed.manifestError,
         registered: false,
         ...probed.ephemeral !== void 0 ? { ephemeral: probed.ephemeral } : {}
       });
@@ -323342,14 +323390,22 @@ function SessionsMonitor({
     /* @__PURE__ */ (0, import_jsx_runtime2.jsx)(Text, { bold: true, color: "magenta", children: "vgai sessions \u2014 live" }),
     /* @__PURE__ */ (0, import_jsx_runtime2.jsxs)(Box_default, { flexDirection: "column", marginTop: 1, children: [
       sessions2.length === 0 && /* @__PURE__ */ (0, import_jsx_runtime2.jsx)(Text, { dimColor: true, children: "No live editor sessions." }),
-      sessions2.map((s) => /* @__PURE__ */ (0, import_jsx_runtime2.jsxs)(Text, { children: [
-        "  ",
-        /* @__PURE__ */ (0, import_jsx_runtime2.jsx)(Text, { color: "green", children: "\u25CF" }),
-        " http://127.0.0.1:",
-        s.port,
-        "/ \u2192 ",
-        s.project ?? "(no project)",
-        s.pid === null ? "  (unregistered legacy server)" : ""
+      sessions2.map((s) => /* @__PURE__ */ (0, import_jsx_runtime2.jsxs)(Box_default, { flexDirection: "column", children: [
+        /* @__PURE__ */ (0, import_jsx_runtime2.jsxs)(Text, { children: [
+          "  ",
+          /* @__PURE__ */ (0, import_jsx_runtime2.jsx)(Text, { color: "green", children: "\u25CF" }),
+          " http://127.0.0.1:",
+          s.port,
+          "/ \u2192",
+          " ",
+          s.project ?? "(no project)",
+          s.pid === null ? "  (unregistered legacy server)" : ""
+        ] }),
+        s.manifestError != null && /* @__PURE__ */ (0, import_jsx_runtime2.jsxs)(Text, { color: "red", children: [
+          "      ",
+          "\u2716 vgai.project.json: ",
+          s.manifestError.split("\n").join(" ")
+        ] })
       ] }, s.port))
     ] }),
     /* @__PURE__ */ (0, import_jsx_runtime2.jsx)(Box_default, { marginTop: 1, children: error48 ? /* @__PURE__ */ (0, import_jsx_runtime2.jsxs)(Text, { color: "red", children: [
@@ -326946,8 +327002,8 @@ function catalogDistributionDir() {
   );
 }
 function cliVersion() {
-  if ("0.5.20") {
-    return "0.5.20";
+  if ("0.5.21") {
+    return "0.5.21";
   }
   try {
     const pkg = JSON.parse(readFileSync32(join39(__dirname4, "..", "package.json"), "utf8"));
@@ -326966,7 +327022,7 @@ function bakedTargetVersions() {
   if (false)
     return void 0;
   try {
-    return JSON.parse('{"@vgai/engine":"0.5.20","@vgai/editor":"0.5.20","@vgai/p2p-colyseus":"0.5.20","@vgai/live":"0.5.20","@vgai/sdk":"0.5.20","@vgai/editor-sdk":"0.5.20","@vgai/cli":"0.5.20"}');
+    return JSON.parse('{"@vgai/engine":"0.5.21","@vgai/editor":"0.5.21","@vgai/p2p-colyseus":"0.5.21","@vgai/live":"0.5.21","@vgai/sdk":"0.5.21","@vgai/editor-sdk":"0.5.21","@vgai/cli":"0.5.21"}');
   } catch {
     return void 0;
   }
@@ -327635,6 +327691,29 @@ function staleAssetCacheWarning(state) {
     "================================================================"
   ].join("\n");
 }
+function projectValidationFailureBanner(state) {
+  const validation = state.projectValidation;
+  if (!validation || typeof validation !== "object") return null;
+  const files = Object.entries(validation).filter(
+    ([, entry]) => Array.isArray(entry?.errors) ? entry.errors.length > 0 : false
+  );
+  if (files.length === 0) return null;
+  const lines = files.flatMap(([file2, entry]) => [
+    `  \u2716 ${file2}`,
+    ...entry.errors.map((err2) => `      ${err2}`)
+  ]);
+  return [
+    "================================================================",
+    `  ${files.length} PROJECT FILE(S) CURRENTLY FAIL VALIDATION`,
+    "================================================================",
+    ...lines,
+    "",
+    "  The dev server is still serving this project \u2014 it just cannot read",
+    "  these files. Fix them and the session recovers on save, with no",
+    "  restart: this list is recomputed on every read.",
+    "================================================================"
+  ].join("\n");
+}
 function authoringWarningsWarning(state) {
   const warnings = state.projectWarnings;
   if (!warnings || typeof warnings !== "object") return null;
@@ -327969,6 +328048,10 @@ function restartRequiredWarning(state) {
     "================================================================"
   ].join("\n");
 }
+function manifestErrorLines(manifestError) {
+  const [first = "", ...rest] = manifestError.split("\n");
+  return [`\u2716 vgai.project.json: ${first}`, ...rest];
+}
 async function findLiveEditorSession(projectRoot) {
   const canon = canonicalPath2(projectRoot);
   const sessions2 = await verifiedSessions(DEFAULT_PORT2);
@@ -331143,6 +331226,9 @@ checkout synchronization are separate. Sharing does not update another clone.`);
       for (const s of sessions2) {
         const tag = s.pid === null ? "  (unregistered legacy server)" : "";
         console.log(`  http://127.0.0.1:${s.port}/  \u2192  ${s.project ?? "(no project)"}${tag}`);
+        if (s.manifestError !== null) {
+          for (const line of manifestErrorLines(s.manifestError)) console.log(`      ${line}`);
+        }
       }
       break;
     }
@@ -331794,6 +331880,10 @@ Choose exactly one target: project, --port/--url, --all, or --everywhere.`
       if (coverage) {
         console.warn(coverage);
       }
+      const validationFailures = projectValidationFailureBanner(state);
+      if (validationFailures) {
+        console.warn(validationFailures);
+      }
       const authoringWarnings = authoringWarningsWarning(state);
       if (authoringWarnings) {
         console.warn(authoringWarnings);
@@ -331930,6 +332020,7 @@ export {
   playFailureReport,
   playLogErrorMessages,
   probeLoopTicks,
+  projectValidationFailureBanner,
   resolveCliEngineRoot,
   resolvePackagedEditorEntry,
   resolveUpgradeTargetVersions,

package/package.json

@@ -2,7 +2,7 @@
   "name": "@vgai/cli",
   "author": "Volter AI, Inc.",
   "license": "Apache-2.0",
-  "version": "0.5.20",
+  "version": "0.5.21",
   "description": "Create, open, control, validate, and playtest VGAI game projects.",
   "keywords": [
     "game-engine",
@@ -39,12 +39,12 @@
   },
   "dependencies": {
     "@oclif/core": "^4.11.14",
-    "@vgai/editor": "0.5.20",
-    "@vgai/editor-sdk": "0.5.20",
-    "@vgai/engine": "0.5.20",
-    "@vgai/live": "0.5.20",
-    "@vgai/p2p-colyseus": "0.5.20",
-    "@vgai/sdk": "0.5.20",
+    "@vgai/editor": "0.5.21",
+    "@vgai/editor-sdk": "0.5.21",
+    "@vgai/engine": "0.5.21",
+    "@vgai/live": "0.5.21",
+    "@vgai/p2p-colyseus": "0.5.21",
+    "@vgai/sdk": "0.5.21",
     "ink": "^7.1.0",
     "playwright": "^1.58.2",
     "react": "^19.2.4",