@chrisdudek/yg 5.4.1 → 5.4.2

package/dist/bin.js

@@ -16157,6 +16157,7 @@ async function runFill(graph, opts) {
   }
   const detPairs = unverifiedPairs.filter((p2) => p2.kind === "deterministic");
   const llmPairs = onlyDeterministic ? [] : unverifiedPairs.filter((p2) => p2.kind === "llm");
+  const skippedLlmPairs = onlyDeterministic ? unverifiedPairs.filter((p2) => p2.kind === "llm").length : 0;
   const aspectById = /* @__PURE__ */ new Map();
   for (const a of graph.aspects) aspectById.set(a.id, a);
   const deterministicAspectIds = new Set(
@@ -16174,6 +16175,12 @@ async function runFill(graph, opts) {
     `Filling ${unverifiedPairs.length} unverified pairs across ${nodeSet.size} nodes \u2014 ${detPairs.length} deterministic (no cost), ${reviewerCallBudget} reviewer calls (consensus included)
 `
   );
+  if (skippedLlmPairs > 0) {
+    write(
+      `  Deterministic-only mode \u2014 ${skippedLlmPairs} LLM pair${skippedLlmPairs === 1 ? "" : "s"} will NOT be reviewed this run; run \`yg check --approve\` to review ${skippedLlmPairs === 1 ? "it" : "them"}.
+`
+    );
+  }
   if (dryRun) {
     const byNode = /* @__PURE__ */ new Map();
     for (const p2 of unverifiedPairs) {
@@ -16214,7 +16221,7 @@ async function runFill(graph, opts) {
     return writeChain;
   };
   const setEntry = async (aspectId, unitKey, entry) => {
-    (lock.verdicts[aspectId] ??= {})[unitKey] = entry;
+    (lock.verdicts[aspectId] ??= {})[toPosixPath(unitKey)] = entry;
     await persistLock();
   };
   const blockedNodes = /* @__PURE__ */ new Set();
@@ -16375,7 +16382,14 @@ async function runFill(graph, opts) {
   }
   await garbageCollectAndRewrite(graph, lock, persistLock);
   if (reviewerCallsMade === 0 && infraFailures === 0 && runtimeErrors === 0 && companionRuntimeErrors === 0) {
-    write("0 reviewer calls made \u2014 all expected pairs hold valid verdicts\n");
+    if (skippedLlmPairs > 0) {
+      write(
+        `0 reviewer calls made \u2014 deterministic-only mode; ${skippedLlmPairs} LLM pair${skippedLlmPairs === 1 ? "" : "s"} left unverified. Run \`yg check --approve\` to review ${skippedLlmPairs === 1 ? "it" : "them"}.
+`
+      );
+    } else {
+      write("0 reviewer calls made \u2014 all expected pairs hold valid verdicts\n");
+    }
   }
   if (infraFailures > 0) {
     const providers = [...new Set(infraReport.map((r) => r.provider).filter(Boolean))].join(", ");
@@ -16709,6 +16723,10 @@ function resolveTopValue(raw) {
   if (Number.isNaN(n) || n < 1) return null;
   return n;
 }
+function nextPointer(next) {
+  const firstLine = next.split("\n")[0];
+  return firstLine.trimEnd().endsWith(":") ? next : firstLine;
+}
 function residualAfterNext(result) {
   if (!result.suggestedNext?.startsWith("yg check --approve")) return "";
   const errors = result.issues.filter((i) => i.severity === "error");
@@ -16757,7 +16775,7 @@ function formatOutput(result, view = { kind: "full" }, autoFilled = false, emoji
     }
     const firstFiltered = [...filteredErrors, ...filteredWarnings][0];
     if (firstFiltered?.messageData.next) {
-      const nextCmd = firstFiltered.messageData.next.split("\n")[0];
+      const nextCmd = nextPointer(firstFiltered.messageData.next);
       sections.push("");
       sections.push(`Next (this group): ${nextCmd}`);
       sections.push("");
@@ -16787,7 +16805,7 @@ function formatOutput(result, view = { kind: "full" }, autoFilled = false, emoji
     }
   }
   if (result.suggestedNext) {
-    const nextCmd = result.suggestedNext.split("\n")[0];
+    const nextCmd = nextPointer(result.suggestedNext);
     const residual = view.kind === "full" || view.kind === "details" ? residualAfterNext(result) : "";
     sections.push("");
     sections.push(`Next: ${nextCmd}${residual}`);
@@ -21146,8 +21164,11 @@ cached and FINAL for unchanged inputs. Interrupting is safe \u2014 finished pair
 persist, the next run resumes.
 
 When nothing was unverified, the summary says \`0 reviewer calls made \u2014 all
-expected pairs hold valid verdicts\`. Use \`yg impact\` to predict cost before
-editing.
+expected pairs hold valid verdicts\`. Under \`--only-deterministic\` the header and
+summary instead name the LLM pairs left unverified \u2014 they are skipped by design,
+not reviewed \u2014 and point at a full \`yg check --approve\` to review them, so a
+deterministic-only run never reads as if it verified everything. Use \`yg impact\`
+to predict cost before editing.
 
 \`--dry-run\` (with \`--approve\`) is a free cost preview: it runs the same
 structural gate, pair classification, and budget computation, prints the
@@ -23236,16 +23257,6 @@ async function computePortalFreshness(graph, lock) {
 }
 
 // src/portal/derive-node-state.ts
-var PAIR_RANK = {
-  refused: 4,
-  unverified: 3,
-  warning: 2,
-  verified: 1,
-  "n/a": 0
-};
-function worstPairState(states) {
-  return states.reduce((worst, s) => PAIR_RANK[s] > PAIR_RANK[worst] ? s : worst, "verified");
-}
 var STATE_RANK = {
   refused: 4,
   unverified: 3,
@@ -23297,6 +23308,18 @@ function computeNotApplicable(node, graph, effectiveIds) {
   return out;
 }
 
+// src/portal/derive-pair-state.ts
+var PAIR_RANK = {
+  refused: 4,
+  unverified: 3,
+  warning: 2,
+  verified: 1,
+  "n/a": 0
+};
+function worstPairState(states) {
+  return states.reduce((worst, s) => PAIR_RANK[s] > PAIR_RANK[worst] ? s : worst, "verified");
+}
+
 // src/portal/derive-nodes.ts
 function displayPairState(rawKind, status) {
   if (rawKind === "verified") return "verified";
@@ -23614,28 +23637,6 @@ function buildTypes(graph) {
 }
 
 // src/portal/derive-rest.ts
-function buildBoundary(input) {
-  if (input === null) {
-    return { phantom: [], declaredOnly: [], forbiddenType: [], unknown: true };
-  }
-  return {
-    phantom: dedupeEdges(input.phantom),
-    declaredOnly: dedupeEdges(input.declaredOnly),
-    forbiddenType: dedupeEdges(input.forbiddenType),
-    unknown: false
-  };
-}
-function dedupeEdges(edges) {
-  const seen = /* @__PURE__ */ new Set();
-  const out = [];
-  for (const e of edges) {
-    const key = `${e.source}\0${e.target}`;
-    if (seen.has(key)) continue;
-    seen.add(key);
-    out.push(e);
-  }
-  return out.sort((a, b) => a.source.localeCompare(b.source, "en") || a.target.localeCompare(b.target, "en"));
-}
 function buildSuppressions(markers) {
   return markers.map((m) => ({
     aspectId: m.aspectId,
@@ -23677,6 +23678,30 @@ function buildWorklist(check) {
   }));
 }
 
+// src/portal/derive-boundary.ts
+function buildBoundary(input) {
+  if (input === null) {
+    return { phantom: [], declaredOnly: [], forbiddenType: [], unknown: true };
+  }
+  return {
+    phantom: dedupeEdges(input.phantom),
+    declaredOnly: dedupeEdges(input.declaredOnly),
+    forbiddenType: dedupeEdges(input.forbiddenType),
+    unknown: false
+  };
+}
+function dedupeEdges(edges) {
+  const seen = /* @__PURE__ */ new Set();
+  const out = [];
+  for (const e of edges) {
+    const key = `${e.source}\0${e.target}`;
+    if (seen.has(key)) continue;
+    seen.add(key);
+    out.push(e);
+  }
+  return out.sort((a, b) => a.source.localeCompare(b.source, "en") || a.target.localeCompare(b.target, "en"));
+}
+
 // src/portal/extract.ts
 async function extractPortalData(projectRoot, opts) {
   const graph = await loadPortalGraph(projectRoot);
@@ -23930,6 +23955,78 @@ async function readPortalAsset(relPath) {
 // src/portal/server/server.ts
 import { createServer } from "http";
 
+// src/portal/server/boot-pages.ts
+var BOOT_PAGE_CSS = `
+:root{color-scheme:light dark;--yg-bg:#fcfcfd;--yg-surface:#f9f9fb;--yg-fg:#1c2024;--yg-muted:#60646c;--yg-accent:#0090ff;--yg-border:#cdced6}
+@media (prefers-color-scheme:dark){:root{--yg-bg:#111113;--yg-surface:#18191b;--yg-fg:#edeef0;--yg-muted:#b0b4ba;--yg-accent:#3b9eff;--yg-border:#43484e}}
+html,body{height:100%}
+body{margin:0;background:var(--yg-bg);color:var(--yg-fg);font:15px/1.5 -apple-system,BlinkMacSystemFont,"Segoe UI",Roboto,Helvetica,Arial,sans-serif;display:grid;place-items:center;padding:24px;box-sizing:border-box}
+.yg-box{display:flex;flex-direction:column;align-items:center;gap:14px;text-align:center;max-width:56ch}
+.yg-title{font-weight:600;font-size:16px}
+.yg-sub{color:var(--yg-muted);font-size:13.5px;max-width:46ch}
+.yg-sub code,.yg-detail{font-family:ui-monospace,SFMono-Regular,Menlo,monospace}
+.yg-sub code{font-size:12px;background:var(--yg-surface);border:1px solid var(--yg-border);border-radius:4px;padding:1px 5px}`;
+function renderLoadingShell() {
+  return `<!doctype html>
+<html lang="en">
+<head>
+<meta charset="utf-8" />
+<meta name="viewport" content="width=device-width, initial-scale=1" />
+<title>Yggdrasil Portal</title>
+<style>${BOOT_PAGE_CSS}
+.yg-spinner{width:34px;height:34px;border-radius:50%;border:3px solid var(--yg-border);border-top-color:var(--yg-accent);animation:yg-spin .8s linear infinite}
+@keyframes yg-spin{to{transform:rotate(360deg)}}
+@media (prefers-reduced-motion:reduce){.yg-spinner{animation-duration:2.4s}}
+</style>
+</head>
+<body>
+<div class="yg-box" id="yg-boot">
+<div class="yg-spinner" role="status" aria-label="Loading"></div>
+<div class="yg-title">Reading your architecture\u2026</div>
+<div class="yg-sub">Checking the graph and rendering the portal. This can take a moment on a large project.</div>
+</div>
+<script>
+(function(){
+  fetch('/render' + location.search, { headers: { accept: 'text/html' } })
+    .then(function(r){ return r.text(); })
+    .then(function(html){ document.open(); document.write(html); document.close(); })
+    .catch(function(){
+      var b = document.getElementById('yg-boot');
+      if (b) { b.innerHTML =
+        '<div class="yg-title">Couldn\\u2019t reach the portal</div>' +
+        '<div class="yg-sub">The local portal process may have stopped. Restart it in your terminal, then reload this page.</div>'; }
+    });
+})();
+</script>
+</body>
+</html>
+`;
+}
+function renderErrorPage(message) {
+  return `<!doctype html>
+<html lang="en">
+<head>
+<meta charset="utf-8" />
+<meta name="viewport" content="width=device-width, initial-scale=1" />
+<title>Yggdrasil Portal \u2014 couldn\u2019t load</title>
+<style>${BOOT_PAGE_CSS}
+.yg-detail{margin-top:4px;max-width:74ch;text-align:left;white-space:pre-wrap;word-break:break-word;font-size:12px;line-height:1.5;color:var(--yg-muted);background:var(--yg-surface);border:1px solid var(--yg-border);border-radius:8px;padding:12px 14px}
+</style>
+</head>
+<body>
+<div class="yg-box">
+<div class="yg-title">The portal couldn\u2019t load your architecture</div>
+<div class="yg-sub">Something went wrong while reading the graph and building the page. Make sure this is a project with a <code>.yggdrasil/</code> graph, then reload. If it keeps happening, run <code>yg check</code> in your terminal to see the underlying problem.</div>
+<div class="yg-detail">${escapeHtmlText(message)}</div>
+</div>
+</body>
+</html>
+`;
+}
+function escapeHtmlText(s) {
+  return s.replace(/&/g, "&amp;").replace(/</g, "&lt;").replace(/>/g, "&gt;").replace(/"/g, "&quot;");
+}
+
 // src/portal/server/page.ts
 async function freshPortalData(projectRoot, writeEnabled) {
   return extractPortalData(projectRoot, { writeEnabled });
@@ -23937,6 +24034,12 @@ async function freshPortalData(projectRoot, writeEnabled) {
 async function renderLivePage(data) {
   return renderPortalPage(data);
 }
+function loadingShell() {
+  return renderLoadingShell();
+}
+function errorPage(message) {
+  return renderErrorPage(message);
+}
 async function readStaticAsset(relPath) {
   return readPortalAsset(relPath);
 }
@@ -24028,9 +24131,18 @@ async function handleRequest(req, res, config) {
   const pathname = url.pathname;
   try {
     if (method === "GET" && pathname === "/") {
-      const data = await freshPortalData(config.projectRoot, config.writeEnabled);
-      const html = await renderLivePage(data);
-      sendText(res, 200, "text/html; charset=utf-8", html);
+      sendText(res, 200, "text/html; charset=utf-8", loadingShell());
+      return;
+    }
+    if (method === "GET" && pathname === "/render") {
+      try {
+        const data = await freshPortalData(config.projectRoot, config.writeEnabled);
+        const html = await renderLivePage(data);
+        sendText(res, 200, "text/html; charset=utf-8", html);
+      } catch (err) {
+        const message = err instanceof Error ? err.message : String(err);
+        sendText(res, 500, "text/html; charset=utf-8", errorPage(message));
+      }
       return;
     }
     if (method === "GET" && pathname === "/data") {

package/dist/templates/portal/app.css

@@ -0,0 +1,278 @@
+/*
+ * Component styles — the count header, the tree, the node panel, the glossary tooltip,
+ * and the command-palette overlay.
+ *
+ * The reusable surface pieces the views compose. Tokens come from tokens.css; the shell
+ * frame from shell.css. Calm, dense, document-like; the only saturated color is a state
+ * (resolved through the state classes in tokens.css). This file stays focused on the
+ * in-stage components and the ⌘K overlay.
+ */
+
+/* ── Count header + chips ───────────────────────────────────────────────── */
+.stage-header {
+  border-bottom: 1px solid var(--border);
+  padding-bottom: 16px;
+  margin-bottom: 18px;
+}
+.stage-title {
+  font-size: 24px;
+  line-height: 32px;
+  font-weight: 600;
+  margin: 0 0 4px;
+  letter-spacing: -0.01em;
+}
+.stage-sub {
+  color: var(--text-secondary);
+  font-size: 12.5px;
+  margin: 0 0 16px;
+}
+.count-bar {
+  display: flex;
+  flex-wrap: wrap;
+  gap: 8px;
+}
+.count-chip {
+  display: inline-flex;
+  align-items: center;
+  gap: 6px;
+  padding: 4px 10px;
+  border-radius: 7px;
+  border: 1px solid var(--border-subtle);
+  background: var(--surface-1);
+  font-size: 13px;
+}
+.chip-count {
+  font-weight: 600;
+}
+.chip-label {
+  color: var(--text-secondary);
+}
+
+.stage-intro {
+  margin-bottom: 14px;
+}
+.stage-notfound {
+  margin: 10px 0 0;
+  padding: 8px 12px;
+  border: 1px solid var(--border);
+  border-left: 3px solid var(--unverified);
+  border-radius: 8px;
+  background: var(--surface-1);
+  color: var(--text-secondary);
+  font-size: 13px;
+}
+.stage-vtitle {
+  font-size: 16px;
+  margin: 0 0 2px;
+}
+.stage-vblurb {
+  margin: 0;
+  color: var(--text-secondary);
+  font-size: 13px;
+}
+.stage-note {
+  color: var(--text-muted);
+  font-size: 12.5px;
+  border: 1px dashed var(--border);
+  border-radius: 9px;
+  padding: 10px 12px;
+  margin: 4px 0 18px;
+}
+
+/* ── Tree (virtualized) ─────────────────────────────────────────────────── */
+.tree-filter {
+  margin: 4px 0 8px;
+}
+.tree-filter-input {
+  width: 100%;
+  padding: 7px 11px;
+  border: 1px solid var(--border);
+  border-radius: 8px;
+  background: var(--bg);
+  color: var(--text-primary);
+  font: inherit;
+  font-size: 13px;
+}
+/* "You are here" marker for a row revealed by a palette pick / deep-link. */
+.tree-row-revealed {
+  background: var(--surface-3);
+  box-shadow: inset 3px 0 0 var(--accent);
+}
+.tree-mount {
+  margin: 4px 0 18px;
+}
+.tree-scroller {
+  position: relative;
+  height: 60vh;
+  min-height: 280px;
+  overflow: auto;
+  border: 1px solid var(--border);
+  border-radius: 10px;
+  background: var(--surface-1);
+}
+.tree-spacer {
+  position: relative;
+  width: 100%;
+}
+.tree-window {
+  position: absolute;
+  top: 0;
+  left: 0;
+  right: 0;
+  will-change: transform;
+}
+.tree-row {
+  display: flex;
+  align-items: center;
+  gap: 9px;
+  height: 28px;
+  padding-right: 12px;
+  border-bottom: 1px solid var(--surface-2);
+  font-size: 13px;
+  cursor: pointer;
+}
+.tree-row:hover {
+  background: var(--surface-3);
+}
+.tree-name {
+  font-weight: 500;
+}
+.tree-type {
+  margin-left: auto;
+  color: var(--text-muted);
+  font-size: 11px;
+}
+
+/* ── Node panel ─────────────────────────────────────────────────────────── */
+.panel-title {
+  font-size: 13px;
+  margin: 0 0 10px;
+  font-family: 'JetBrains Mono', ui-monospace, monospace;
+  word-break: break-all;
+}
+.panel-head {
+  display: flex;
+  align-items: center;
+  gap: 9px;
+  font-size: 13px;
+  margin-bottom: 8px;
+}
+.panel-sub {
+  color: var(--text-secondary);
+  font-size: 12.5px;
+  margin: 0;
+}
+
+/* ── Glossary term tooltip ──────────────────────────────────────────────── */
+.term {
+  border-bottom: 1px dotted var(--border-strong);
+  cursor: help;
+}
+
+/* ── Command palette overlay ────────────────────────────────────────────── */
+.palette-backdrop {
+  position: fixed;
+  inset: 0;
+  display: flex;
+  align-items: flex-start;
+  justify-content: center;
+  padding-top: 60px;
+  background: rgba(0, 0, 0, 0.32);
+  z-index: 50;
+}
+.palette-box {
+  width: 640px;
+  max-width: 92vw;
+  background: var(--surface-1);
+  border: 1px solid var(--border);
+  border-radius: 14px;
+  box-shadow: 0 1px 1px rgba(0, 0, 0, 0.04), 0 16px 40px -10px rgba(0, 0, 0, 0.45);
+  overflow: hidden;
+}
+.palette-input {
+  display: flex;
+  align-items: center;
+  gap: 11px;
+  padding: 13px 16px;
+  border-bottom: 1px solid var(--border-subtle);
+}
+.palette-search-ic {
+  color: var(--text-muted);
+}
+.palette-field {
+  flex: 1;
+  border: 0;
+  background: none;
+  color: var(--text-primary);
+  font: inherit;
+  font-size: 16px;
+}
+.palette-field:focus {
+  outline: none;
+}
+.palette-results {
+  max-height: 380px;
+  overflow: auto;
+  padding: 6px;
+}
+.palette-empty {
+  padding: 16px;
+  color: var(--text-muted);
+  font-size: 13px;
+}
+.palette-row {
+  display: flex;
+  align-items: center;
+  gap: 11px;
+  padding: 8px 12px;
+  border-radius: 8px;
+  font-size: 13.5px;
+  cursor: pointer;
+}
+.palette-row.on {
+  background: var(--surface-3);
+}
+.palette-ic {
+  width: 18px;
+  text-align: center;
+  color: var(--text-muted);
+}
+.palette-nm {
+  font-weight: 500;
+}
+.palette-sub {
+  color: var(--text-muted);
+  font-size: 11.5px;
+}
+.palette-kind {
+  margin-left: auto;
+  font-size: 10px;
+  color: var(--text-muted);
+  border: 1px solid var(--border-subtle);
+  border-radius: 5px;
+  padding: 0 6px;
+}
+.palette-foot {
+  display: flex;
+  gap: 16px;
+  padding: 9px 14px;
+  border-top: 1px solid var(--border-subtle);
+  font-size: 11px;
+  color: var(--text-muted);
+}
+
+.portal-error {
+  color: var(--refused);
+  padding: 24px;
+  font-size: 14px;
+}
+
+@media (prefers-reduced-motion: reduce) {
+  *,
+  *::before,
+  *::after {
+    transition: none !important;
+    animation: none !important;
+    scroll-behavior: auto !important;
+  }
+}