@fasl-work/caos-app-shell 0.19.11 → 0.19.12

package/CHANGELOG.md

@@ -1,3 +1,15 @@
+## [0.19.012] - 2026-11-01
+
+### Fixed
+
+- Verify complete JSON artifact documents when navigation interrupts a page-owned body read or a conditional response has no body. One bounded GET preserves the observed URL and credentials while removing range/cache preconditions; transport retries are recorded. HTML, empty, malformed and failed responses remain failures.
+- Keep artifact validation independent of page-context lifetime without changing readiness declarations, idle-rate limits, traversal rules or component styles.
+- Permit the gate self-test to use the configured external temporary root; CI uses its runner temporary root.
+
+### Adoption
+
+- Pin npm 0.19.12 and run the installed gate against the deployed origin. Components and scientific calculations are unchanged.
+
 ## [0.19.011] - 2026-11-01
 
 ### Fixed

package/VERSION

@@ -1 +1 @@
-0.19.011
+0.19.012

package/gate/artifacts.mjs

@@ -0,0 +1,29 @@
+/** Complete JSON verification, including a bounded retry after a page-owned read is interrupted. */
+export async function readJsonArtifact(response) {
+  const url = response.url();
+  let text = '', transportRetry = false, originalReadError;
+  try {
+    // The partial header map omits browser cookies; capture complete on-wire headers before teardown.
+    const headers = { ...(await response.request().allHeaders()) };
+    try {
+      if (response.status() === 304) throw new Error('Conditional response has no complete document body');
+      text = await response.text();
+    } catch (error) {
+      transportRetry = true;
+      originalReadError = String(error);
+      // Request the full original document, retaining credentials but not cache/range preconditions.
+      for (const name of Object.keys(headers)) {
+        if (['if-none-match', 'if-modified-since', 'range', 'if-range', 'content-length', 'host', 'connection'].includes(name.toLowerCase())) delete headers[name];
+      }
+      const retry = await fetch(url, { headers, redirect: 'error', cache: 'no-store', signal: AbortSignal.timeout(10000) });
+      if (!retry.ok) throw new Error(`Complete artifact GET answered HTTP ${retry.status}`);
+      text = await retry.text();
+    }
+    const first = text.trimStart().slice(0, 1);
+    const value = JSON.parse(text);
+    if (value === null || typeof value !== 'object') throw new Error('Artifact must be a JSON object or array');
+    return { ok: true, first, transportRetry, ...(originalReadError ? { originalReadError } : {}) };
+  } catch (error) {
+    return { ok: false, first: text.trimStart().slice(0, 1), transportRetry, error: String(error), ...(originalReadError ? { originalReadError } : {}) };
+  }
+}

package/gate/run.mjs

@@ -38,6 +38,7 @@
 // plus the ADR-0071 and ADR-0017 measures (viewport, one-row tabs, rail without scroll, centred prose, captions,
 // references).
 
+import { readJsonArtifact } from './artifacts.mjs';
 import { existsSync, mkdirSync, readdirSync, rmSync, writeFileSync } from 'node:fs';
 import { join } from 'node:path';
 import { decodePng, paintedBox, unionArea } from './png.mjs';
@@ -135,6 +136,7 @@ export async function runGate(o) {
   let states = 0;
   const fail = (check, where, message) => failures.push({ check, route: where.route ?? '', mode: where.mode ?? '', trail: where.trail ?? '', message });
   const artifacts = new Map();
+  const artifactChecks = [];
 
   const browser = await chromium.launch();
   const openContext = async ([w, h], theme, lang, wide = false) => {
@@ -193,10 +195,7 @@ export async function runGate(o) {
       if ((type === 'fetch' || type === 'xhr') && pathname.endsWith('.json') && r.status() < 400 && !artifacts.has(pathname)) {
         artifacts.set(
           pathname,
-          r.text().then(
-            (t) => t.trimStart().slice(0, 1),
-            () => '',
-          ),
+          readJsonArtifact(r),
         );
       }
     });
@@ -444,8 +443,9 @@ export async function runGate(o) {
 
     // ---- G4: artifacts answered as JSON.
     for (const [pathname, first] of artifacts) {
-      const c = await first;
-      if (c !== '{' && c !== '[') fail('G4', { route: pathname }, `the artifact ${pathname} did not answer JSON (starts with "${c}"; the HTML fallback?)`);
+      const result = await first;
+      artifactChecks.push({ path: pathname, ...result });
+      if (!result.ok) fail('G4', { route: pathname }, `the artifact ${pathname} did not answer JSON (starts with "${result.first}"; ${result.error ?? 'the HTML fallback?'})`);
     }
   } finally {
     await browser.close();
@@ -1131,6 +1131,7 @@ export async function runGate(o) {
       checks,
       captures: captures.length,
       failures,
+      artifactChecks,
     };
     writeFileSync(join(opt.out, 'gate-report.json'), JSON.stringify(report, null, 2));
     // G14: the captures are for a person to read (the gate measures, it does not judge content); one page shows them.

package/package.json

@@ -1,100 +1,100 @@
-{
-  "name": "@fasl-work/caos-app-shell",
-  "version": "0.19.11",
-  "description": "Shared web-app shell, workbench primitives, content primitives, design system and measured gate for the CAOS / Faena public apps (ADR-0016, ADR-0017, ADR-0071).",
-  "license": "MIT",
-  "author": "Felipe Santibáñez-Leal",
-  "repository": {
-    "type": "git",
-    "url": "git+https://github.com/fsantibanezleal/CAOS_APP_SHELL.git"
-  },
-  "type": "module",
-  "publishConfig": {
-    "access": "public"
-  },
-  "sideEffects": [
-    "*.css"
-  ],
-  "exports": {
-    ".": {
-      "types": "./dist/index.d.ts",
-      "import": "./dist/index.js"
-    },
-    "./chart": {
-      "types": "./dist/chart.d.ts",
-      "import": "./dist/chart.js"
-    },
-    "./keys": {
-      "types": "./dist/keys.d.ts",
-      "import": "./dist/keys.js"
-    },
-    "./styles.css": "./styles.css",
-    "./chart.css": "./chart.css",
-    "./reserved-classes.json": "./reserved-classes.json",
-    "./executive.schema.json": "./src/content/executive.schema.json",
-    "./serve": "./gate/serve.mjs",
-    "./gate": "./gate/run.mjs",
-    "./package.json": "./package.json"
-  },
-  "files": [
-    "dist",
-    "styles.css",
-    "chart.css",
-    "bin",
-    "gate",
-    "reserved-classes.json",
-    "src/content/executive.schema.json",
-    "VERSION",
-    "CHANGELOG.md"
-  ],
-  "scripts": {
-    "build": "tsup",
-    "test": "node --import tsx --test \"test/**/*.test.ts\" \"test/**/*.test.tsx\"",
-    "test:browser": "node --import tsx --test \"e2e/**/*.test.ts\"",
-    "prepare": "npm run build",
-    "prepublishOnly": "npm run build",
-    "prebuild": "node scripts/reserved-classes.mjs",
-    "test:gate": "node --test test/gate-selftest.mjs",
-    "check:sdd": "python scripts/check_sdd.py ."
-  },
-  "peerDependencies": {
-    "katex": "^0.16.0 || ^0.17.0 || ^0.18.0 || ^0.19.0",
-    "lucide-react": ">=0.400.0",
-    "react": "^18 || ^19",
-    "react-dom": "^18 || ^19",
-    "react-router": "^6 || ^7 || ^8",
-    "zustand": "^4 || ^5",
-    "playwright": ">=1.40",
-    "uplot": "^1.6.30"
-  },
-  "devDependencies": {
-    "@playwright/test": "1.63.0",
-    "@types/react": "^19.0.0",
-    "@types/react-dom": "^19.0.0",
-    "esbuild": "0.28.1",
-    "katex": "0.19.0",
-    "lucide-react": "1.43.0",
-    "react": "^19.0.0",
-    "react-dom": "^19.0.0",
-    "react-router": "^8.3.0",
-    "tsup": "^8.3.5",
-    "tsx": "^4.23.0",
-    "typescript": "^5.7.3",
-    "zustand": "^5.0.2",
-    "uplot": "1.6.32"
-  },
-  "overrides": {
-    "esbuild": "0.28.1"
-  },
-  "bin": {
-    "caos-shell-gate": "bin/caos-shell-gate.mjs"
-  },
-  "peerDependenciesMeta": {
-    "playwright": {
-      "optional": true
-    },
-    "uplot": {
-      "optional": true
-    }
-  }
-}
+{
+  "name": "@fasl-work/caos-app-shell",
+  "version": "0.19.12",
+  "description": "Shared web-app shell, workbench primitives, content primitives, design system and measured gate for the CAOS / Faena public apps (ADR-0016, ADR-0017, ADR-0071).",
+  "license": "MIT",
+  "author": "Felipe Santibáñez-Leal",
+  "repository": {
+    "type": "git",
+    "url": "git+https://github.com/fsantibanezleal/CAOS_APP_SHELL.git"
+  },
+  "type": "module",
+  "publishConfig": {
+    "access": "public"
+  },
+  "sideEffects": [
+    "*.css"
+  ],
+  "exports": {
+    ".": {
+      "types": "./dist/index.d.ts",
+      "import": "./dist/index.js"
+    },
+    "./chart": {
+      "types": "./dist/chart.d.ts",
+      "import": "./dist/chart.js"
+    },
+    "./keys": {
+      "types": "./dist/keys.d.ts",
+      "import": "./dist/keys.js"
+    },
+    "./styles.css": "./styles.css",
+    "./chart.css": "./chart.css",
+    "./reserved-classes.json": "./reserved-classes.json",
+    "./executive.schema.json": "./src/content/executive.schema.json",
+    "./serve": "./gate/serve.mjs",
+    "./gate": "./gate/run.mjs",
+    "./package.json": "./package.json"
+  },
+  "files": [
+    "dist",
+    "styles.css",
+    "chart.css",
+    "bin",
+    "gate",
+    "reserved-classes.json",
+    "src/content/executive.schema.json",
+    "VERSION",
+    "CHANGELOG.md"
+  ],
+  "scripts": {
+    "build": "tsup",
+    "test": "node --import tsx --test \"test/**/*.test.ts\" \"test/**/*.test.tsx\"",
+    "test:browser": "node --import tsx --test \"e2e/**/*.test.ts\"",
+    "prepare": "npm run build",
+    "prepublishOnly": "npm run build",
+    "prebuild": "node scripts/reserved-classes.mjs",
+    "test:gate": "node --test test/gate-selftest.mjs",
+    "check:sdd": "python scripts/check_sdd.py ."
+  },
+  "peerDependencies": {
+    "katex": "^0.16.0 || ^0.17.0 || ^0.18.0 || ^0.19.0",
+    "lucide-react": ">=0.400.0",
+    "react": "^18 || ^19",
+    "react-dom": "^18 || ^19",
+    "react-router": "^6 || ^7 || ^8",
+    "zustand": "^4 || ^5",
+    "playwright": ">=1.40",
+    "uplot": "^1.6.30"
+  },
+  "devDependencies": {
+    "@playwright/test": "1.63.0",
+    "@types/react": "^19.0.0",
+    "@types/react-dom": "^19.0.0",
+    "esbuild": "0.28.1",
+    "katex": "0.19.0",
+    "lucide-react": "1.43.0",
+    "react": "^19.0.0",
+    "react-dom": "^19.0.0",
+    "react-router": "^8.3.0",
+    "tsup": "^8.3.5",
+    "tsx": "^4.23.0",
+    "typescript": "^5.7.3",
+    "zustand": "^5.0.2",
+    "uplot": "1.6.32"
+  },
+  "overrides": {
+    "esbuild": "0.28.1"
+  },
+  "bin": {
+    "caos-shell-gate": "bin/caos-shell-gate.mjs"
+  },
+  "peerDependenciesMeta": {
+    "playwright": {
+      "optional": true
+    },
+    "uplot": {
+      "optional": true
+    }
+  }
+}