@hyperfixi/testing-framework 2.9.4 → 2.10.0

package/CHANGELOG.md

@@ -7,6 +7,21 @@ and this project adheres to [Semantic Versioning](https://semver.org/spec/v2.0.0
 
 ## [Unreleased]
 
+## [2.10.0] - 2026-08-01
+
+Full notes: [GitHub Releases](https://github.com/codetalcott/hyperfixi/releases/tag/v2.10.0).
+
+Highlights: `swap`/`process`/`morph … using view transition` across all 24
+languages (#870, #873, #875), typed command registration (#869, #871),
+`tell`/`process` parser fixes (#861, #872), the R1 role-fidelity burn-down
+(#864, #867, #868, #874, #878), and guards for the remaining hand-maintained
+CI package lists (#862, #865).
+
+## [2.9.0] - 2026-07-25
+
+> **Gap note:** 2.9.1 through 2.9.4 shipped without entries in this file; their
+> details live in [GitHub Releases](https://github.com/codetalcott/hyperfixi/releases).
+
 ### ⚠ BREAKING (types)
 
 - **Domain renderers return `string | null`.** `renderSQL`, `renderJSX`, `renderTodo`,
@@ -379,7 +394,12 @@ _Synchronized version release. See git history for details._
 - npm access token stored in GitHub Secrets
 - 2FA recommended for npm organization
 
-[Unreleased]: https://github.com/codetalcott/hyperfixi/compare/v2.4.0...HEAD
+[Unreleased]: https://github.com/codetalcott/hyperfixi/compare/v2.10.0...HEAD
+[2.10.0]: https://github.com/codetalcott/hyperfixi/compare/v2.9.0...v2.10.0
+[2.9.0]: https://github.com/codetalcott/hyperfixi/compare/v2.8.0...v2.9.0
+[2.8.0]: https://github.com/codetalcott/hyperfixi/compare/v2.5.1...v2.8.0
+[2.5.1]: https://github.com/codetalcott/hyperfixi/compare/v2.5.0...v2.5.1
+[2.5.0]: https://github.com/codetalcott/hyperfixi/compare/v2.4.0...v2.5.0
 [2.4.0]: https://github.com/codetalcott/hyperfixi/compare/v2.3.1...v2.4.0
 [2.3.1]: https://github.com/codetalcott/hyperfixi/compare/v2.3.0...v2.3.1
 [2.3.0]: https://github.com/codetalcott/hyperfixi/compare/v2.2.1...v2.3.0

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@hyperfixi/testing-framework",
-  "version": "2.9.4",
+  "version": "2.10.0",
   "description": "Cross-platform behavior testing suite for LokaScript applications",
   "main": "dist/index.js",
   "module": "dist/index.mjs",
@@ -57,10 +57,10 @@
   "author": "LokaScript Contributors",
   "license": "MIT",
   "dependencies": {
-    "@hyperfixi/core": "^2.9.4",
-    "@hyperfixi/patterns-reference": "^2.9.4",
-    "@lokascript/i18n": "^2.9.4",
-    "@lokascript/semantic": "^2.9.4",
+    "@hyperfixi/core": "^2.10.0",
+    "@hyperfixi/patterns-reference": "^2.10.0",
+    "@lokascript/i18n": "^2.10.0",
+    "@lokascript/semantic": "^2.10.0",
     "diff": "^8.0.3",
     "esbuild": "^0.28.0",
     "happy-dom": "^20.10.6",

package/src/multilingual/shipped-examples-execution.test.ts

@@ -87,16 +87,21 @@ describe('shipped-examples execution gate', () => {
   }, 240_000);
 
   it('walks pages and compares handlers (sanity: extraction and both engines working)', () => {
-    // Floors well below current values (55 / 333 / 162 / 74) but far above
+    // Floors well below current values (48 / 261 / 122 / 52) but far above
     // zero: a broken walk, extractor, or engine bootstrap fails loudly here
     // instead of making assertions 2-3 vacuously pass.
-    expect(result.pages).toBeGreaterThan(40);
-    expect(result.handlers).toBeGreaterThan(250);
-    expect(result.compared.length).toBeGreaterThan(120);
+    //
+    // Calibrated against the git-TRACKED corpus — the sweep ignores untracked
+    // examples/ dirs, so these numbers are the same on every machine and in
+    // CI. (The original floors were measured on a working tree with four
+    // gitignored dirs present and failed every clean checkout — #862.)
+    expect(result.pages).toBeGreaterThan(35);
+    expect(result.handlers).toBeGreaterThan(200);
+    expect(result.compared.length).toBeGreaterThan(90);
     // Vacuous (empty-vs-empty) pairs are NOT parity evidence — the floor is on
     // real, non-empty signature matches.
     const realMatches = result.compared.filter(c => c.match && !c.vacuous).length;
-    expect(realMatches).toBeGreaterThan(60);
+    expect(realMatches).toBeGreaterThan(40);
   });
 
   it('has no NEW divergence from upstream outside the allowlist', () => {

package/src/multilingual/shipped-examples-execution.ts

@@ -45,6 +45,7 @@
 
 import fs from 'node:fs';
 import path from 'node:path';
+import { execFileSync } from 'node:child_process';
 import { createHash } from 'node:crypto';
 import { createRequire } from 'node:module';
 import { fileURLToPath, pathToFileURL } from 'node:url';
@@ -168,22 +169,33 @@ export function triggerEventOf(source: string): string | null {
   return m ? (m[1] ?? null) : null;
 }
 
-function walkHtml(dir: string, acc: string[] = []): string[] {
-  let entries: fs.Dirent[];
-  try {
-    entries = fs.readdirSync(dir, { withFileTypes: true });
-  } catch {
-    return acc;
-  }
-  for (const entry of entries) {
-    if (entry.name === 'node_modules' || entry.name === 'dist' || entry.name.startsWith('.')) {
-      continue;
-    }
-    const full = path.join(dir, entry.name);
-    if (entry.isDirectory()) walkHtml(full, acc);
-    else if (entry.name.endsWith('.html')) acc.push(full);
-  }
-  return acc;
+/**
+ * Git-TRACKED .html files under `root` (repo-relative), as absolute paths.
+ *
+ * Tracked, not on-disk, because the corpus must be the SHIPPED tree: four
+ * `examples/` dirs are gitignored (experiments/, playground/,
+ * vite-plugin-test/, vite-plugin-multilingual/), and the disk walk this
+ * replaced counted whatever happened to be on the machine. That is how the
+ * gate's sanity floors and allowlist got calibrated against handlers that
+ * were never shipped — and why it failed on every clean checkout the first
+ * time CI ran it (#862). `git ls-files` sees the same corpus everywhere.
+ *
+ * git being unavailable is a THROW, not a fallback to the disk walk — a
+ * silent fallback would resurrect the corpus drift this exists to kill.
+ * A tracked file missing from disk (an uncommitted local deletion) is
+ * skipped: the working tree is mid-edit, and in CI checkout == index.
+ */
+function trackedHtml(repoRoot: string, root: string): string[] {
+  const out = execFileSync('git', ['ls-files', '-z', '--', root], {
+    cwd: repoRoot,
+    encoding: 'utf8',
+    maxBuffer: 64 * 1024 * 1024,
+  });
+  return out
+    .split('\0')
+    .filter(rel => rel.endsWith('.html'))
+    .map(rel => path.join(repoRoot, rel))
+    .filter(full => fs.existsSync(full));
 }
 
 /** Extract the page's `[_]` handlers in document order. */
@@ -398,9 +410,9 @@ async function runHandlerOnEngine(
 }
 
 /**
- * The sweep: walk `examples/**`, extract handlers, apply the fair-denominator
- * filters (each skip reasoned), and execute every eligible handler on both
- * engines.
+ * The sweep: walk the git-tracked `examples/**` corpus, extract handlers,
+ * apply the fair-denominator filters (each skip reasoned), and execute every
+ * eligible handler on both engines.
  */
 export async function runShippedExamplesExecution(opts?: {
   roots?: string[];
@@ -417,7 +429,7 @@ export async function runShippedExamplesExecution(opts?: {
   let handlers = 0;
 
   for (const root of roots) {
-    for (const full of walkHtml(path.join(repoRoot, root))) {
+    for (const full of trackedHtml(repoRoot, root)) {
       const rel = path.relative(repoRoot, full);
       const html = fs.readFileSync(full, 'utf8');
       const pageHandlers = extractHandlers(rel, html);