@slowcook-ai/review-overlay 0.8.1 → 0.9.6

package/README.md

@@ -53,6 +53,37 @@ export default function RootLayout({ children }: { children: ReactNode }) {
 
 The `enabled` gate keeps the overlay out of production-style builds. Slowcook's preview-deploy workflow (0.16-α.5) sets `NEXT_PUBLIC_SLOWCOOK_REVIEW=1` plus the owner/repo/PR env vars when it builds the mock for a `slowcook-mockup` PR.
 
+## Hosting the built mock — cache headers (required)
+
+When you serve a **statically built** mock (Vite/Next export rsynced to a box, an
+S3 bucket, etc.), the HTML shell **must not be hard-cached**, or reviewers keep
+seeing a stale mock after every redeploy and your overlay fixes never reach them.
+
+Rule of thumb:
+
+- **`index.html` (and any app shell / chooser) → `Cache-Control: no-cache`** so the
+  browser revalidates each load and picks up the newest build immediately.
+- **Content-hashed assets (`/assets/*.js`, `*.css`) → long, immutable cache** —
+  their filename changes every build, so caching them is safe.
+
+nginx example (mirrors the delgoosh mock at `mock.delgoosh.com`):
+
+```nginx
+# hashed build assets are immutable — a new build emits new filenames
+location ~* /assets/ {
+  expires 30d;
+  add_header Cache-Control "public, max-age=2592000, immutable";
+}
+# app shell — always revalidate so a redeploy is seen on the next load
+location = /index.html { add_header Cache-Control "no-cache"; }
+location / { try_files $uri $uri/ /index.html; }   # SPA fallback
+```
+
+> If a CDN (Cloudflare, etc.) fronts the host, it may apply its own Browser-Cache-TTL
+> to cacheable responses — harmless for hashed assets, but make sure the shell stays
+> `no-cache` (don't let the CDN cache `index.html`). `slowcook run-mock` already serves
+> with no-store dev headers; this note is for **self-hosted static deploys**.
+
 ## How a comment lands in the PR
 
 1. PM clicks the floating toggle → **💬 Comment**.

package/dist/react/overlay.d.ts

@@ -22,6 +22,7 @@
  *    Tailwind in the host app
  */
 import { type JSX } from "react";
+import { type RepoCoord } from "../github.js";
 export interface SlowcookReviewOverlayProps {
     /**
      * GitHub owner. Optional — falls back to
@@ -83,6 +84,15 @@ export interface SlowcookReviewOverlayProps {
      * to `NEXT_PUBLIC_SLOWCOOK_SURFACES` (JSON). Empty hides the switcher.
      */
     surfaces?: ReviewSurface[];
+    /**
+     * 0.9.0 — URL of a `testing-surfaces.json` manifest (epic ▸ context ▸ scenario
+     * ▸ state). When set, the pill grows an EPSS router IN review mode (a 2×2
+     * dropdown) and shows a tiny PSS breadcrumb in nav mode. Picking a state writes
+     * the resolved selection to localStorage (`slowcook_test_surface`) for the
+     * mock's data-adaptor + navigates. Falls back to `NEXT_PUBLIC_SLOWCOOK_SURFACES_URL`.
+     * Empty disables the router.
+     */
+    testingSurfacesUrl?: string;
 }
 export interface ReviewSurface {
     label: string;
@@ -91,4 +101,12 @@ export interface ReviewSurface {
     blurb?: string;
 }
 export declare function SlowcookReviewOverlay(props: SlowcookReviewOverlayProps): JSX.Element | null;
+/**
+ * 0.8.1 — deterministic, in-code explanation of a write/auth failure. No LLM,
+ * no agent: the overlay itself tells the reviewer exactly why GitHub rejected
+ * the post and what to do (use a classic PAT with the `repo` scope), keyed off
+ * the HTTP status + GitHub's own message. Surfaced on every repo the overlay is
+ * mounted on.
+ */
+export declare function describeAuthError(status: number | undefined, message: string | undefined, repo: RepoCoord): string;
 //# sourceMappingURL=overlay.d.ts.map

package/dist/react/overlay.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"overlay.d.ts","sourceRoot":"","sources":["../../src/react/overlay.tsx"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;GAsBG;AAIH,OAAO,EAA4C,KAAK,GAAG,EAAE,MAAM,OAAO,CAAC;AA4C3E,MAAM,WAAW,0BAA0B;IACzC;;;;OAIG;IACH,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,8DAA8D;IAC9D,IAAI,CAAC,EAAE,MAAM,CAAC;IACd;;;OAGG;IACH,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,+DAA+D;IAC/D,OAAO,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;IACxB;;;;OAIG;IACH,OAAO,CAAC,EAAE,OAAO,CAAC;IAClB;;;;;;;;;;OAUG;IACH,UAAU,CAAC,EAAE,WAAW,GAAG,KAAK,CAAC;IACjC;;;;OAIG;IACH,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,6DAA6D;IAC7D,cAAc,CAAC,EAAE,MAAM,CAAC;IACxB;;;;OAIG;IACH,QAAQ,CAAC,EAAE,MAAM,EAAE,CAAC;IACpB;;;OAGG;IACH,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB;;;;;;OAMG;IACH,QAAQ,CAAC,EAAE,aAAa,EAAE,CAAC;CAC5B;AAED,MAAM,WAAW,aAAa;IAC5B,KAAK,EAAE,MAAM,CAAC;IACd,IAAI,EAAE,MAAM,CAAC;IACb,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,KAAK,CAAC,EAAE,MAAM,CAAC;CAChB;AAqBD,wBAAgB,qBAAqB,CAAC,KAAK,EAAE,0BAA0B,GAAG,GAAG,CAAC,OAAO,GAAG,IAAI,CA+3B3F"}
+{"version":3,"file":"overlay.d.ts","sourceRoot":"","sources":["../../src/react/overlay.tsx"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;GAsBG;AAIH,OAAO,EAA4C,KAAK,GAAG,EAAE,MAAM,OAAO,CAAC;AAU3E,OAAO,EAeL,KAAK,SAAS,EAGf,MAAM,cAAc,CAAC;AAiBtB,MAAM,WAAW,0BAA0B;IACzC;;;;OAIG;IACH,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,8DAA8D;IAC9D,IAAI,CAAC,EAAE,MAAM,CAAC;IACd;;;OAGG;IACH,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,+DAA+D;IAC/D,OAAO,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;IACxB;;;;OAIG;IACH,OAAO,CAAC,EAAE,OAAO,CAAC;IAClB;;;;;;;;;;OAUG;IACH,UAAU,CAAC,EAAE,WAAW,GAAG,KAAK,CAAC;IACjC;;;;OAIG;IACH,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,6DAA6D;IAC7D,cAAc,CAAC,EAAE,MAAM,CAAC;IACxB;;;;OAIG;IACH,QAAQ,CAAC,EAAE,MAAM,EAAE,CAAC;IACpB;;;OAGG;IACH,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB;;;;;;OAMG;IACH,QAAQ,CAAC,EAAE,aAAa,EAAE,CAAC;IAC3B;;;;;;;OAOG;IACH,kBAAkB,CAAC,EAAE,MAAM,CAAC;CAC7B;AAED,MAAM,WAAW,aAAa;IAC5B,KAAK,EAAE,MAAM,CAAC;IACd,IAAI,EAAE,MAAM,CAAC;IACb,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,KAAK,CAAC,EAAE,MAAM,CAAC;CAChB;AAoCD,wBAAgB,qBAAqB,CAAC,KAAK,EAAE,0BAA0B,GAAG,GAAG,CAAC,OAAO,GAAG,IAAI,CAo4B3F;AA4BD;;;;;;GAMG;AACH,wBAAgB,iBAAiB,CAAC,MAAM,EAAE,MAAM,GAAG,SAAS,EAAE,OAAO,EAAE,MAAM,GAAG,SAAS,EAAE,IAAI,EAAE,SAAS,GAAG,MAAM,CAelH"}