@codyswann/lisa 2.283.0 → 2.285.0

package/ui/index.html

@@ -1522,68 +1522,65 @@
             card: "Required",
             items: [
               {
+                id: "setup.install",
                 label: "Install Lisa and apply templates",
                 desc: "Detects the project’s stacks, applies project-owned templates, agent surfaces, and git hooks. External plugin/runtime installation is reported separately and never inferred from project files.",
                 command: "bun add -d @codyswann/lisa && bunx lisa",
-                done: true,
               },
               {
+                id: "setup.sync",
                 label: "Populate configuration",
                 desc: "Fills every missing .lisa.config.json setting (absorbing existing artifact values first) and syncs mirrored files. No unset configs.",
                 command: "lisa sync",
-                done: true,
               },
               {
+                id: "setup.agent-ready",
                 label: "Make the project agent-ready (brownfield)",
                 desc: "Builds the knowledge wiki through read-only, redacted ingestion; records every source as complete, partial, or unavailable; and writes wiki/gaps.md. Answer inline, re-run in a new session, repeat until every source is complete and zero gaps remain. Greenfield projects are ready by construction.",
                 command: "/lisa:agent-ready",
-                done: false,
-                why: "wiki/gaps.md has 2 open gaps",
               },
               {
+                id: "setup.standards",
                 label: "Adopt the standards (conformance refactor)",
                 desc: "Apply Lisa's full lint rules, guardrails, and thresholds — the project goes red by design — then agents refactor to automated conformance without changing business logic. Empirical product verification remains a separate Verify-factory gate.",
                 command:
                   "/lisa:improve:* · /lisa:fix:linter-error · lisa standards-proof",
-                done: false,
-                why: "blocked by agent-ready",
               },
               {
+                id: "setup.tracker",
                 label: "Connect the work tracker",
                 desc: "Verifies the workflow status names and writes the tracker section. This project: JIRA, project ACME.",
                 command: "/lisa:setup:jira | github | linear",
-                done: true,
               },
               {
+                id: "setup.prd-source",
                 label: "Connect the PRD source",
                 desc: "Wires the product-requirements queue and its lifecycle vocabulary. This project: Notion.",
                 command: "/lisa:setup:notion | confluence | linear | github",
-                done: true,
               },
               {
+                id: "setup.github-governance",
                 label: "Apply GitHub repository governance",
                 desc: "Repo settings (merge-only), rulesets with required checks, write deploy key, deployment environments with approval gates.",
                 command: "/lisa:setup:github-repo",
-                done: true,
               },
               {
+                id: "setup.secrets",
                 label: "Provision CI secrets",
                 desc: "CLAUDE_CODE_OAUTH_TOKEN, GITGUARDIAN_API_KEY, SONAR_TOKEN, per-environment AWS accounts, and the optional scanners.",
                 command: "gh secret set …",
-                done: false,
-                why: "2 missing: SNYK_TOKEN, FOSSA_API_KEY",
               },
               {
+                id: "setup.automations",
                 label: "Schedule the automations",
                 desc: "Creates the six-automation fleet — intake, repair, and the QA / Product Planning / Monitoring loops — on the harness’s native scheduler.",
                 command: "/lisa:setup-automations",
-                done: false,
               },
               {
+                id: "setup.exploration",
                 label: "Configure exploration environments",
                 desc: "Per-environment mutation policy and test identity so agents can use the product safely (production defaults to forbidden).",
                 command: ".lisa.config.json exploration.*",
-                done: false,
               },
             ],
           },
@@ -1592,17 +1589,17 @@
             card: "Optional",
             items: [
               {
+                id: "setup.wiki",
                 label: "Install the LLM wiki",
                 desc: "In-repo knowledge base agents read and maintain.",
                 command: "/lisa:wiki:install",
-                done: false,
                 optional: true,
               },
               {
+                id: "setup.starter-provenance",
                 label: "Record starter provenance",
                 desc: "Which starter repo(s) this project descends from, enabling starter sync (planned).",
                 command: ".lisa.config.json starter.*",
-                done: false,
                 optional: true,
               },
             ],
@@ -5085,6 +5082,30 @@
       let healthChipState = { state: "idle" };
       /* Durable Health view model projected by every whole-page render. */
       let healthViewState = { state: "idle" };
+      const SETUP_READINESS_CHECKS = [
+        "setup.install",
+        "setup.sync",
+        "setup.agent-ready",
+        "setup.standards",
+        "setup.tracker",
+        "setup.prd-source",
+        "setup.github-governance",
+        "setup.secrets",
+        "setup.automations",
+        "setup.exploration",
+        "setup.wiki",
+        "setup.starter-provenance",
+      ];
+      const SETUP_READINESS_UNAVAILABLE =
+        "Setup readiness is unavailable. Re-open the console after checking the local Lisa service.";
+      /* Durable Setup state survives every whole-page live-status re-render. */
+      let setupReadinessState = {
+        state: "loading",
+        findings: new Map(),
+        message: "Checking current setup readiness.",
+      };
+      let setupReadinessGeneration = 0;
+      let setupReadinessInFlight = null;
 
       function el(tag, cls, html) {
         const node = document.createElement(tag);
@@ -5711,6 +5732,7 @@
 
       function buildChecklist(block) {
         const card = el("div", "card");
+        card.dataset.setupChecklist = block.card;
         const head = el("div", "card-head");
         const note = el("span", "note");
         const countDone = () =>
@@ -5724,35 +5746,38 @@
         card.appendChild(head);
         const body = el("div", "card-body");
         block.items.forEach(item => {
-          const row = el("div", "check-item" + (item.done ? " done" : ""));
+          const finding = setupReadinessState.findings.get(item.id);
+          const isDone = finding && finding.status === "pass";
+          const reason =
+            setupReadinessState.state === "result" && finding
+              ? finding.reason
+              : setupReadinessState.message;
+          const row = el("div", "check-item" + (isDone ? " done" : ""));
+          row.dataset.setupCheck = item.id;
           const right = el("div", "check-right");
-          const refreshRight = () => {
-            const isDone = row.classList.contains("done");
-            right.innerHTML = "";
-            right.appendChild(
-              el(
-                "span",
-                "badge " +
-                  (isDone ? "pass" : item.optional ? "default" : "warn"),
-                isDone ? "done" : item.optional ? "not set up" : "pending"
-              )
-            );
-            if (!isDone && item.why) {
-              right.appendChild(el("span", "status-why", esc(item.why)));
-            }
-            right.appendChild(
-              el(
-                "span",
-                "status-why",
-                "read-only: setup checklist state has not shipped yet"
-              )
-            );
-          };
+          right.appendChild(
+            el(
+              "span",
+              "badge " +
+                (isDone
+                  ? "pass"
+                  : finding?.status === "fail"
+                    ? "fail"
+                    : "warn"),
+              isDone ? "done" : "pending"
+            )
+          );
+          if (!isDone) {
+            right.appendChild(el("span", "status-why", esc(reason)));
+          }
           const ck = el("button", "ck");
           ck.type = "button";
           ck.disabled = true;
-          ck.title = "read-only: setup checklist state has not shipped yet";
-          ck.setAttribute("aria-label", item.label + " checklist status");
+          ck.title = reason;
+          ck.setAttribute(
+            "aria-label",
+            item.label + ": " + (isDone ? "done" : "pending") + ". " + reason
+          );
           row.appendChild(ck);
           const content = el("div", "check-content");
           const lab = el("div", "check-label", esc(item.label));
@@ -5765,7 +5790,6 @@
             content.appendChild(el("span", "keychip", esc(item.command)));
           }
           row.appendChild(content);
-          refreshRight();
           row.appendChild(right);
           body.appendChild(row);
         });
@@ -5947,6 +5971,7 @@
 
       let activeSection = "overview";
       function showSection(sid) {
+        const previousSection = activeSection;
         activeSection = sid;
         document
           .querySelectorAll(".section")
@@ -5962,6 +5987,11 @@
           history.replaceState(null, "", "#" + sid);
         applyFilter(document.getElementById("search").value);
         window.scrollTo({ top: 0 });
+        if (sid === "setup" && previousSection !== "setup") {
+          void hydrateSetupReadiness({
+            refresh: setupReadinessGeneration > 0,
+          });
+        }
       }
 
       function applyFilter(query) {
@@ -6677,6 +6707,128 @@
         }
       }
 
+      /** Validate the strict three-field Setup readiness transport contract. */
+      function requireSetupReadinessResult(candidate) {
+        const isObject = value =>
+          value !== null && typeof value === "object" && !Array.isArray(value);
+        const hasExactKeys = (value, keys) =>
+          isObject(value) &&
+          Object.keys(value).sort().join(",") === [...keys].sort().join(",");
+        const canonicalUtc = value => {
+          if (
+            typeof value !== "string" ||
+            !/^\d{4}-\d{2}-\d{2}T\d{2}:\d{2}:\d{2}\.\d{3}Z$/u.test(value)
+          ) {
+            return false;
+          }
+          const instant = new Date(value);
+          return (
+            !Number.isNaN(instant.valueOf()) && instant.toISOString() === value
+          );
+        };
+        const readableReason = value =>
+          typeof value === "string" &&
+          value.trim() === value &&
+          value.length > 0 &&
+          new TextEncoder().encode(value).length <= 2000 &&
+          !Array.from(value).some(character => {
+            const codePoint = character.codePointAt(0) ?? 0;
+            return (
+              codePoint <= 0x1f ||
+              (codePoint >= 0x7f && codePoint <= 0x9f) ||
+              (codePoint >= 0x202a && codePoint <= 0x202e) ||
+              (codePoint >= 0x2066 && codePoint <= 0x2069)
+            );
+          });
+        if (
+          !hasExactKeys(candidate, [
+            "schemaVersion",
+            "observedAt",
+            "findings",
+          ]) ||
+          candidate.schemaVersion !== 1 ||
+          !canonicalUtc(candidate.observedAt) ||
+          !Array.isArray(candidate.findings) ||
+          candidate.findings.length !== SETUP_READINESS_CHECKS.length
+        ) {
+          throw new TypeError(
+            "Setup readiness response is not valid schema v1 JSON"
+          );
+        }
+        const findings = new Map();
+        candidate.findings.forEach((finding, index) => {
+          if (
+            !hasExactKeys(finding, ["check", "layer", "status", "reason"]) ||
+            finding.check !== SETUP_READINESS_CHECKS[index] ||
+            finding.layer !== "deterministic" ||
+            !["pass", "warn", "fail"].includes(finding.status) ||
+            !readableReason(finding.reason)
+          ) {
+            throw new TypeError(
+              "Setup readiness response contains an invalid finding"
+            );
+          }
+          findings.set(finding.check, finding);
+        });
+        return findings;
+      }
+
+      /** Rebuild only the two Setup checklist cards from durable readiness state. */
+      function repaintSetupChecklist() {
+        const section = document.getElementById("section-setup");
+        if (!section) return;
+        const blocks = DATA.sections.setup.blocks.filter(
+          block => block.type === "checklist"
+        );
+        const cards = section.querySelectorAll("[data-setup-checklist]");
+        blocks.forEach((block, index) => {
+          if (cards[index]) cards[index].replaceWith(buildChecklist(block));
+        });
+      }
+
+      /** Read current Setup readiness with same-entry dedupe and stale-response protection. */
+      function hydrateSetupReadiness({ refresh = false } = {}) {
+        if (!refresh && setupReadinessInFlight) {
+          return setupReadinessInFlight;
+        }
+        setupReadinessState = {
+          state: "loading",
+          findings: new Map(),
+          message: "Checking current setup readiness.",
+        };
+        repaintSetupChecklist();
+        const generation = ++setupReadinessGeneration;
+        const request = (async () => {
+          let nextState;
+          try {
+            const response = await fetch("/api/setup-readiness", {
+              cache: "no-store",
+            });
+            if (!response.ok) throw new Error(SETUP_READINESS_UNAVAILABLE);
+            nextState = {
+              state: "result",
+              findings: requireSetupReadinessResult(await response.json()),
+              message: "",
+            };
+          } catch {
+            nextState = {
+              state: "error",
+              findings: new Map(),
+              message: SETUP_READINESS_UNAVAILABLE,
+            };
+          }
+          if (generation === setupReadinessGeneration) {
+            setupReadinessState = nextState;
+            repaintSetupChecklist();
+          }
+          if (setupReadinessInFlight === request) {
+            setupReadinessInFlight = null;
+          }
+        })();
+        setupReadinessInFlight = request;
+        return request;
+      }
+
       /** Run exactly one deterministic Health v1 check through the local server. */
       async function runHealthCheck() {
         const button = document.getElementById("runHealthCheckButton");
@@ -7224,11 +7376,11 @@
       function boot() {
         hydrateFromLiveConfig();
         renderAll();
-        void hydrateLiveStatuses();
-        void hydrateHealth();
         showSection(location.hash ? location.hash.slice(1) : "overview");
         if (!document.getElementById("section-" + activeSection))
           showSection("overview");
+        void hydrateLiveStatuses();
+        void hydrateHealth();
       }
       if (document.readyState === "loading") {
         document.addEventListener("DOMContentLoaded", boot);