@codyswann/lisa 3.49.0 → 3.50.0

package/dist/cli/ui-gate-report.d.ts

@@ -0,0 +1,57 @@
+/**
+ * `GET /api/gate-report` — the Doctor tab's data, composed at serve time.
+ *
+ * The tab's markup is composed HERE rather than living inside
+ * `ui/index.html`, and that is the point of the route. That file is a single
+ * 13,000-line zero-build document with a known concurrent-edit hazard where
+ * union merges lose braces; a section of this size pasted into it would make a
+ * bad merge materially worse, and would put a second copy of the report's
+ * markup somewhere no test renders. The console instead gains a small block
+ * that asks this route for the fragment.
+ *
+ * The standalone property `ui/README.md` advertises survives untouched:
+ * opening `ui/index.html` from disk still works, and the tab then says — in
+ * the report's own three-state vocabulary — that the report could not be
+ * derived without a server. That is an honest `unknown`, not an empty panel.
+ *
+ * Lazy and single-flight, following `/api/setup-readiness`. Tier 2 shells out
+ * to `gh`, so building the report at server start would delay the console for
+ * a section the operator may never open, and two tabs opened at once must not
+ * become two `gh` invocations.
+ * @module cli/ui-gate-report
+ */
+import type * as http from "node:http";
+import type { GateReport } from "./gate-report-types.js";
+/** What the route returns. */
+export interface GateReportResponse {
+    /** The scoped fragment the console injects into the Doctor tab. */
+    readonly html: string;
+    /**
+     * The payload the fragment was rendered from.
+     *
+     * Served alongside the markup so an agent or a script can consume the same
+     * verdicts the operator is looking at, without a second derivation that
+     * could disagree with the first.
+     */
+    readonly report: GateReport;
+}
+/** Injectable boundaries, so tests never shell out or read a real project. */
+export interface GateReportDependencies {
+    /** Build the report. Defaults to the real emitter. */
+    readonly build?: (projectRoot: string) => Promise<GateReport>;
+}
+/**
+ * Build the response for one project.
+ * @param projectRoot - Project root served by this UI process
+ * @param dependencies - Injectable boundaries
+ * @returns The fragment and the payload it came from
+ */
+export declare function readGateReport(projectRoot: string, dependencies?: GateReportDependencies): Promise<GateReportResponse>;
+/**
+ * Create the `/api/gate-report` handler for one project.
+ * @param projectRoot - Project root served by this UI process
+ * @param dependencies - Injectable boundaries
+ * @returns A request handler
+ */
+export declare function createGateReportHandler(projectRoot: string, dependencies?: GateReportDependencies): (request: http.IncomingMessage, response: http.ServerResponse) => void;
+//# sourceMappingURL=ui-gate-report.d.ts.map

package/dist/cli/ui-gate-report.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"ui-gate-report.d.ts","sourceRoot":"","sources":["../../src/cli/ui-gate-report.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;GAqBG;AACH,OAAO,KAAK,KAAK,IAAI,MAAM,WAAW,CAAC;AAKvC,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,wBAAwB,CAAC;AAMzD,8BAA8B;AAC9B,MAAM,WAAW,kBAAkB;IACjC,mEAAmE;IACnE,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;IACtB;;;;;;OAMG;IACH,QAAQ,CAAC,MAAM,EAAE,UAAU,CAAC;CAC7B;AAED,8EAA8E;AAC9E,MAAM,WAAW,sBAAsB;IACrC,sDAAsD;IACtD,QAAQ,CAAC,KAAK,CAAC,EAAE,CAAC,WAAW,EAAE,MAAM,KAAK,OAAO,CAAC,UAAU,CAAC,CAAC;CAC/D;AAED;;;;;GAKG;AACH,wBAAsB,cAAc,CAClC,WAAW,EAAE,MAAM,EACnB,YAAY,GAAE,sBAA2B,GACxC,OAAO,CAAC,kBAAkB,CAAC,CAS7B;AA8BD;;;;;GAKG;AACH,wBAAgB,uBAAuB,CACrC,WAAW,EAAE,MAAM,EACnB,YAAY,GAAE,sBAA2B,GACxC,CAAC,OAAO,EAAE,IAAI,CAAC,eAAe,EAAE,QAAQ,EAAE,IAAI,CAAC,cAAc,KAAK,IAAI,CA8CxE"}

package/dist/cli/ui-gate-report.js

@@ -0,0 +1,95 @@
+import * as path from "node:path";
+import { renderGateReportFragment } from "./gate-report-fragment.js";
+import { buildGateReport } from "./gate-report.js";
+const JSON_CONTENT_TYPE = "application/json; charset=utf-8";
+const NO_STORE = "no-store";
+const TEXT_CONTENT_TYPE = "text/plain; charset=utf-8";
+/**
+ * Build the response for one project.
+ * @param projectRoot - Project root served by this UI process
+ * @param dependencies - Injectable boundaries
+ * @returns The fragment and the payload it came from
+ */
+export async function readGateReport(projectRoot, dependencies = {}) {
+    const build = dependencies.build ??
+        (async (root) => await buildGateReport({ projectRoot: root }));
+    const report = await build(projectRoot);
+    return {
+        report,
+        html: renderGateReportFragment(report, path.basename(projectRoot)),
+    };
+}
+/**
+ * Coalesce concurrent reads without caching a stale answer for later ones.
+ *
+ * The slot is a `current` holder rather than a reassigned binding, which is
+ * the shape the repository's immutability rules already sanction: the entry is
+ * set when a read starts and cleared when it settles, which is the same
+ * lifetime with none of the suppression.
+ * @param read - The underlying reader
+ * @returns A single-flight reader that clears after settlement
+ */
+function singleFlight(read) {
+    const slot = {
+        current: undefined,
+    };
+    return () => {
+        if (slot.current !== undefined)
+            return slot.current;
+        const pending = read();
+        slot.current = pending;
+        const clear = () => {
+            if (slot.current === pending)
+                slot.current = undefined;
+        };
+        void pending.then(clear, clear);
+        return pending;
+    };
+}
+/**
+ * Create the `/api/gate-report` handler for one project.
+ * @param projectRoot - Project root served by this UI process
+ * @param dependencies - Injectable boundaries
+ * @returns A request handler
+ */
+export function createGateReportHandler(projectRoot, dependencies = {}) {
+    const read = singleFlight(async () => await readGateReport(projectRoot, dependencies));
+    return (request, response) => {
+        if (request.method === "HEAD") {
+            response.writeHead(200, {
+                "cache-control": NO_STORE,
+                "content-type": JSON_CONTENT_TYPE,
+            });
+            response.end();
+            return;
+        }
+        if (request.method !== "GET") {
+            response.writeHead(405, {
+                allow: "GET, HEAD",
+                "cache-control": NO_STORE,
+                "content-type": TEXT_CONTENT_TYPE,
+            });
+            response.end("Method not allowed");
+            return;
+        }
+        void read().then(result => {
+            response.writeHead(200, {
+                "cache-control": NO_STORE,
+                "content-type": JSON_CONTENT_TYPE,
+            });
+            response.end(JSON.stringify(result));
+        }, error => {
+            // A failure here must not render as an empty report. The console shows
+            // the message, which keeps "the report could not be derived" distinct
+            // from "the report found nothing".
+            response.writeHead(500, {
+                "cache-control": NO_STORE,
+                "content-type": JSON_CONTENT_TYPE,
+            });
+            response.end(JSON.stringify({
+                error: error instanceof Error ? error.message : String(error),
+            }));
+        });
+    };
+}
+//# sourceMappingURL=ui-gate-report.js.map

package/dist/cli/ui-gate-report.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"ui-gate-report.js","sourceRoot":"","sources":["../../src/cli/ui-gate-report.ts"],"names":[],"mappings":"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"}

package/dist/core/upstream-evidence-manifest.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"upstream-evidence-manifest.d.ts","sourceRoot":"","sources":["../../src/core/upstream-evidence-manifest.ts"],"names":[],"mappings":"AACA,iFAAiF;AACjF,eAAO,MAAM,0BAA0B,EAAE,QAAQ,CAAC,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAg3EpE,CAAC;AAEL,4EAA4E;AAC5E,eAAO,MAAM,yBAAyB,EAAE,QAAQ,CAAC,MAAM,CAAC,MAAM,EAAE,IAAI,CAAC,CAu3OjE,CAAC;AAEL,sFAAsF;AACtF,eAAO,MAAM,uBAAuB,EAAE,QAAQ,CAAC,MAAM,CAAC,MAAM,EAAE,IAAI,CAAC,CAk6I/D,CAAC"}
+{"version":3,"file":"upstream-evidence-manifest.d.ts","sourceRoot":"","sources":["../../src/core/upstream-evidence-manifest.ts"],"names":[],"mappings":"AACA,iFAAiF;AACjF,eAAO,MAAM,0BAA0B,EAAE,QAAQ,CAAC,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAg3EpE,CAAC;AAEL,4EAA4E;AAC5E,eAAO,MAAM,yBAAyB,EAAE,QAAQ,CAAC,MAAM,CAAC,MAAM,EAAE,IAAI,CAAC,CAy4OjE,CAAC;AAEL,sFAAsF;AACtF,eAAO,MAAM,uBAAuB,EAAE,QAAQ,CAAC,MAAM,CAAC,MAAM,EAAE,IAAI,CAAC,CAk6I/D,CAAC"}

package/dist/core/upstream-evidence-manifest.js

@@ -1206,8 +1206,8 @@ export const UPSTREAM_EVIDENCE_MANIFEST = Object.freeze({
     "typescript/merge/.claude/settings.json": "834e6456cae81f45073bbbb08bf731fef043efb30cae2658cb4a59f17e66d165",
     "typescript/merge/.oxlintrc.json": "9504c20db80470c242c4ffe8cccad6951ed8141dfb5bf6503053e0b2712ab276",
     "typescript/package-lisa/package.lisa.json": "0da7069e5b7eb4e16e67201d047be1dd85b82c0e2bcf7cf0fa0ab0caff8a8b1a",
-    "ui/README.md": "deeb35e767ea5dd2883268835ea3ad21cbad9fa63ec8d8ff5e200f0e2a7d2751",
-    "ui/index.html": "8952fdef959d76c75cbb3aa50467f396e14a56cc8d092c543a6a2a0b88590520",
+    "ui/README.md": "ee05dac69cbba5f74a4ff945e78afdd54bd62d26087a255799dbbfc943f52b45",
+    "ui/index.html": "259e62a02f99c7957cb5f83cc9f5678971df8c6c37495566f88b919ccddc1ade",
 });
 /** Exact paths tracked by the public Lisa repository at generation time. */
 export const UPSTREAM_SURFACE_MANIFEST = Object.freeze({
@@ -7169,15 +7169,27 @@ export const UPSTREAM_SURFACE_MANIFEST = Object.freeze({
     "src/cli/file-upstream-cmd.ts": true,
     "src/cli/gate-commands.ts": true,
     "src/cli/gate-registry-source.ts": true,
+    "src/cli/gate-report-agent-hooks.ts": true,
+    "src/cli/gate-report-assemble.ts": true,
     "src/cli/gate-report-cells.ts": true,
     "src/cli/gate-report-config.ts": true,
+    "src/cli/gate-report-contexts.ts": true,
     "src/cli/gate-report-executors.ts": true,
+    "src/cli/gate-report-facade.ts": true,
+    "src/cli/gate-report-fragment.ts": true,
+    "src/cli/gate-report-html.ts": true,
+    "src/cli/gate-report-joins.ts": true,
+    "src/cli/gate-report-merge.ts": true,
     "src/cli/gate-report-preview.ts": true,
     "src/cli/gate-report-registry.ts": true,
+    "src/cli/gate-report-rows.ts": true,
     "src/cli/gate-report-ruleset.ts": true,
+    "src/cli/gate-report-sections.ts": true,
     "src/cli/gate-report-skip-jobs.ts": true,
+    "src/cli/gate-report-style.ts": true,
     "src/cli/gate-report-summary.ts": true,
     "src/cli/gate-report-types.ts": true,
+    "src/cli/gate-report-upstream.ts": true,
     "src/cli/gate-report.ts": true,
     "src/cli/health-cmd.ts": true,
     "src/cli/index.ts": true,
@@ -7210,6 +7222,7 @@ export const UPSTREAM_SURFACE_MANIFEST = Object.freeze({
     "src/cli/ui-deploy-pipeline.ts": true,
     "src/cli/ui-detected-stacks.ts": true,
     "src/cli/ui-enabled-plugins.ts": true,
+    "src/cli/ui-gate-report.ts": true,
     "src/cli/ui-github-repo-expected.ts": true,
     "src/cli/ui-github-repo-gh.ts": true,
     "src/cli/ui-github-repo-map.ts": true,
@@ -7697,11 +7710,13 @@ export const UPSTREAM_SURFACE_MANIFEST = Object.freeze({
     "tests/unit/cli/doctor.test.ts": true,
     "tests/unit/cli/file-upstream-contract.test.ts": true,
     "tests/unit/cli/gate-commands.test.ts": true,
+    "tests/unit/cli/gate-report-attribution.test.ts": true,
     "tests/unit/cli/gate-report-executors.test.ts": true,
     "tests/unit/cli/gate-report-fixtures.ts": true,
     "tests/unit/cli/gate-report-preview.test.ts": true,
     "tests/unit/cli/gate-report-ruleset.test.ts": true,
     "tests/unit/cli/gate-report-states.test.ts": true,
+    "tests/unit/cli/gate-report-workflows.ts": true,
     "tests/unit/cli/gate-report.test.ts": true,
     "tests/unit/cli/health-cmd.test.ts": true,
     "tests/unit/cli/index-maintenance.test.ts": true,
@@ -7730,6 +7745,7 @@ export const UPSTREAM_SURFACE_MANIFEST = Object.freeze({
     "tests/unit/cli/ui-deploy-pipeline-probe.test.ts": true,
     "tests/unit/cli/ui-detected-stacks-probe.test.ts": true,
     "tests/unit/cli/ui-enabled-plugins-probe.test.ts": true,
+    "tests/unit/cli/ui-gate-report.test.ts": true,
     "tests/unit/cli/ui-github-repo-map.test.ts": true,
     "tests/unit/cli/ui-github-repo.test.ts": true,
     "tests/unit/cli/ui-health-schedule-write.test.ts": true,
@@ -8014,6 +8030,8 @@ export const UPSTREAM_SURFACE_MANIFEST = Object.freeze({
     "tests/unit/scripts/cursor-artifact-helpers.ts": true,
     "tests/unit/scripts/derived-artifact-staleness.test.ts": true,
     "tests/unit/scripts/destructive-capability-compound-names.test.ts": true,
+    "tests/unit/scripts/destructive-guard-boundaries.test.ts": true,
+    "tests/unit/scripts/destructive-guard-source-shape.test.ts": true,
     "tests/unit/scripts/destructive-production-guard.test.ts": true,
     "tests/unit/scripts/destructive-production-unreachable.test.ts": true,
     "tests/unit/scripts/detect-stale-workflow-inputs-helpers.ts": true,