@flemo/devtools 0.3.0 → 0.4.0

package/dist/noop.mjs

@@ -112,112 +112,82 @@ var e = 30, t = 1e4, n = 50, r = 120, i = 100, a = 48, o = (e) => {
 	values: "a pixel height",
 	fallback: "(the panel's default height)",
 	effect: "the drawer height this panel was last dragged to"
-}], _ = [
+}], _ = [], v = [..._, ...g], y = [
 	{
 		key: "flemo:sixty",
 		storage: "session",
-		kind: "production-state",
-		values: "\"high\" / a streak count",
-		fallback: "(learned)",
-		effect: "steady-60 desktop verdict seed — owned by steadySixtyCadence.ts"
+		retiredWith: "the steady-60 verdict seed, now document-scoped module state (2026-08-31)"
 	},
 	{
 		key: "flemo:settle-gate",
 		storage: "session",
-		kind: "production-default-with-override",
-		values: "\"on\" / \"off\"",
-		fallback: "touch WebKit + touch Blink + desktop macOS WebKit + steady-60 desktop",
-		effect: "render-settle entry gate, shared by the engine's routing and the binding"
+		retiredWith: "the engine diagnostic surface (2026-08-31)"
 	},
 	{
 		key: "flemo:arrivalhold",
 		storage: "session",
-		kind: "production-default-with-override",
-		values: "\"off\"",
-		fallback: "on",
-		effect: "the whole in-flight hold set (arrival, response, invisible animations, images)"
+		retiredWith: "the engine diagnostic surface (2026-08-31)"
 	},
 	{
 		key: "flemo:deskflip",
 		storage: "session",
-		kind: "production-default-with-override",
-		values: "\"on\" / \"off\"",
-		fallback: "desktop macOS WebKit",
-		effect: "atomic release flip: the hold attribute flips on the DOM inside the readiness rAF"
+		retiredWith: "the engine diagnostic surface (2026-08-31)"
 	},
 	{
 		key: "flemo:deskhead",
 		storage: "session",
-		kind: "production-default-with-override",
-		values: "\"on\" / \"off\"",
-		fallback: "desktop macOS WebKit",
-		effect: "desktop flat-head keyframes; arming it retires the desktop birth anchor"
+		retiredWith: "the engine diagnostic surface (2026-08-31)"
 	},
 	{
 		key: "flemo:creep",
 		storage: "session",
-		kind: "production-default-with-override",
-		values: "\"on\" / \"off\"",
-		fallback: "touch WebKit",
-		effect: "creep head: its end keyframe carries a hair of motion, so the compositor is already carrying the animation at the boundary"
+		retiredWith: "the engine diagnostic surface (2026-08-31)"
 	},
 	{
 		key: "flemo:relcommit",
 		storage: "session",
-		kind: "production-default-with-override",
-		values: "\"defer\" / \"sync\"",
-		fallback: "touch WebKit",
-		effect: "the release's reconcile lands next frame instead of synchronously"
+		retiredWith: "the engine diagnostic surface (2026-08-31)"
 	},
 	{
 		key: "flemo:imgoffload",
 		storage: "session",
-		kind: "production-default-with-override",
-		values: "\"on\" / \"off\"",
-		fallback: "on — the offloader decides per image, from the source's own size",
-		effect: "image decode offloader: an oversized source is fetched and downscaled in a worker so its decode never lands in a paint"
+		retiredWith: "the engine diagnostic surface (2026-08-31)"
 	},
 	{
 		key: "flemo:governed",
 		storage: "session",
-		kind: "production-default-with-override",
-		values: "\"on\" / \"off\"",
-		fallback: "legacy Android Blink (an old browser, not a slow device)",
-		effect: "the governed head kit on touch Blink — a flat head covering a compiled flight's opening. The auto-detection reads browser AGE, so a modern-but-weak phone falls through it; this is how such a device gets measured"
+		retiredWith: "the engine diagnostic surface (2026-08-31)"
 	},
 	{
 		key: "flemo:imghold",
 		storage: "session",
-		kind: "opt-in-diagnostic",
-		values: "\"on\" / \"off\"",
-		fallback: "off",
-		effect: "flight-scoped <img> reveal hold"
+		retiredWith: "the image reveal hold, whose only arming path it was (2026-08-31)"
 	},
 	{
 		key: "flemo:preraster",
 		storage: "session",
-		kind: "opt-in-diagnostic",
-		values: "\"on\"",
-		fallback: "off",
-		effect: "REST-time scope promotion, and the park-over hold variant. Flight-time promotion is the engine's own stamp and needs no flag"
+		retiredWith: "the REST-time scope promotion, whose only arming path it was (2026-08-31)"
+	},
+	{
+		key: "flemo:parkhead",
+		storage: "session",
+		retiredWith: "the engine diagnostic surface — the park head is unconditional (2026-08-31)"
 	},
 	{
 		key: "flemo:layers",
 		storage: "session",
-		kind: "opt-in-diagnostic",
-		values: "\"resident\" / \"off\"",
-		fallback: "off",
-		effect: "keep screen layers resident at rest — a resident layer is a PERMANENT stacking context over the consumer's screen"
+		retiredWith: "the resident-layer experiment (2026-08-31)"
+	},
+	{
+		key: "flemo:morph",
+		storage: "session",
+		retiredWith: "the morph decision trace (2026-08-31)"
 	},
 	{
 		key: "flemo:freeze",
 		storage: "session",
-		kind: "opt-in-diagnostic",
-		values: "\"shallow\"",
-		fallback: "off",
-		effect: "keep the direct prev screen live instead of freezing it"
-	}
-], v = [..._, ...g], y = [
+		retiredWith: "the shallow-freeze experiment (2026-08-31)"
+	},
 	{
 		key: "flemo:motion-driver",
 		storage: "local",
@@ -276,7 +246,7 @@ var e = 30, t = 1e4, n = 50, r = 120, i = 100, a = 48, o = (e) => {
 	} catch {
 		return null;
 	}
-}, C = new Set(v.map((e) => e.key)), w = new Set(y.map((e) => e.key)), T = new Set(g.map((e) => e.key)), E = () => {
+}, C = new Set(v.map((e) => e.key)), w = new Set(y.map((e) => e.key)), T = () => {
 	let e = {}, t = x("session"), n = x("local");
 	for (let r of v) {
 		let i = S(r.storage === "session" ? t : n, r.key);
@@ -293,19 +263,15 @@ var e = 30, t = 1e4, n = 50, r = 120, i = 100, a = 48, o = (e) => {
 		}
 	} catch {}
 	return e;
-}, D = (e) => {
+}, E = (e) => {
 	let t = [];
-	for (let [n, r] of Object.entries(e)) {
-		if (n.includes("(retired — the library no longer reads this)")) {
-			let e = n.slice(0, n.indexOf(" (")), i = y.find((t) => t.key === e);
-			t.push(`${n}=${r} — RETIRED residue: this key went with ${i?.retiredWith ?? "a removed feature"}. The library never reads it, so it cannot explain anything you are seeing. Safe to delete; it is listed only so it does not read as an unexplained lead.`);
-			continue;
-		}
-		let e = v.find((e) => n === e.key || n.startsWith(`${e.key} `));
-		!e || T.has(e.key) || (e.kind === "opt-in-diagnostic" ? t.push(`${n}=${r} — opt-in diagnostic active (${e.effect}); behavior differs from stock. Possible left-over A/B toggle from an earlier debugging session.`) : e.kind === "production-default-with-override" && t.push(`${n}=${r} — production default overridden for this session (${e.effect}). Stock behavior here is ${e.fallback}.`));
+	for (let [n, r] of Object.entries(e)) if (n.includes("(retired — the library no longer reads this)")) {
+		let e = n.slice(0, n.indexOf(" (")), i = y.find((t) => t.key === e);
+		t.push(`${n}=${r} — RETIRED residue: this key went with ${i?.retiredWith ?? "a removed feature"}. The library never reads it, so it cannot explain anything you are seeing. Safe to delete; it is listed only so it does not read as an unexplained lead.`);
+		continue;
 	}
 	return t;
-}, O = (e) => Math.round(e * 10) / 10, k = (e) => {
+}, D = (e) => Math.round(e * 10) / 10, O = (e) => {
 	if (e.length === 0) return {
 		count: 0,
 		medianGapMs: 0,
@@ -315,11 +281,11 @@ var e = 30, t = 1e4, n = 50, r = 120, i = 100, a = 48, o = (e) => {
 	let t = [...e].sort((e, t) => e - t);
 	return {
 		count: e.length,
-		medianGapMs: O(t[Math.floor(t.length / 2)]),
-		maxGapMs: O(t[t.length - 1]),
+		medianGapMs: D(t[Math.floor(t.length / 2)]),
+		maxGapMs: D(t[t.length - 1]),
 		over30Count: e.filter((e) => e >= 30).length
 	};
-}, A = (e, t = []) => {
+}, k = (e, t = []) => {
 	let n = [...e, ...t];
 	return {
 		...n.length === 0 ? {
@@ -330,21 +296,21 @@ var e = 30, t = 1e4, n = 50, r = 120, i = 100, a = 48, o = (e) => {
 			let e = [...n].sort((e, t) => e - t);
 			return {
 				count: n.length,
-				medianGapMs: O(e[Math.floor(e.length / 2)]),
-				maxGapMs: O(e[e.length - 1])
+				medianGapMs: D(e[Math.floor(e.length / 2)]),
+				maxGapMs: D(e[e.length - 1])
 			};
 		})(),
-		longGaps: n.filter((e) => e >= 30).map(O),
-		held: k(e),
-		released: k(t)
+		longGaps: n.filter((e) => e >= 30).map(D),
+		held: O(e),
+		released: O(t)
 	};
-}, j = (e) => e.length === 0 ? null : {
-	maxMs: O(Math.max(...e)),
+}, A = (e) => e.length === 0 ? null : {
+	maxMs: D(Math.max(...e)),
 	over30Count: e.filter((e) => e >= 30).length
-}, M = (e) => {
+}, j = (e) => {
 	let t = e.playerSuppression || e.playerAdvance;
 	return t && e.compiledAnimation ? "mixed" : t ? "player" : e.compiledAnimation ? "compiled" : "unknown";
-}, N = (e) => e === "PUSHING" ? "PUSH" : e === "POPPING" ? "POP" : e === "REPLACING" ? "REPLACE" : null, P = (e) => {
+}, M = (e) => e === "PUSHING" ? "PUSH" : e === "POPPING" ? "POP" : e === "REPLACING" ? "REPLACE" : null, N = (e) => {
 	let t = /^matrix3d\(([^)]+)\)$/.exec(e.trim());
 	if (t) {
 		let e = t[1].split(",").map((e) => Number(e.trim()));
@@ -356,7 +322,7 @@ var e = 30, t = 1e4, n = 50, r = 120, i = 100, a = 48, o = (e) => {
 		return e.length === 6 && Number.isFinite(e[4]) ? e[4] : null;
 	}
 	return null;
-}, F = "2", I = "@flemo/devtools resolved to its production entry: nothing was recorded. Run a development build to collect a real report.", L = () => {}, R = () => ({
+}, P = "2", F = "@flemo/devtools resolved to its production entry: nothing was recorded. Run a development build to collect a real report.", I = () => {}, L = () => ({
 	generatedAt: (/* @__PURE__ */ new Date()).toISOString(),
 	version: "inert",
 	environment: {
@@ -389,15 +355,15 @@ var e = 30, t = 1e4, n = 50, r = 120, i = 100, a = 48, o = (e) => {
 	},
 	overrides: {
 		active: {},
-		warnings: [I]
+		warnings: [F]
 	},
 	flights: [],
-	anomalies: [I],
+	anomalies: [F],
 	blindSpots: [],
-	judgingProtocol: [I]
-}), z = (e) => ({
-	detach: L,
-	report: R
-}), B = (e) => ({ detach: L });
+	judgingProtocol: [F]
+}), R = (e) => ({
+	detach: I,
+	report: L
+}), z = (e) => ({ detach: I });
 //#endregion
-export { c as BLIND_SPOTS, _ as CORE_FLAGS, g as DEVTOOLS_OWNED_FLAGS, v as FLAG_REGISTRY, e as LONG_GAP_MS, i as MID_FLIGHT_TASK_MS, n as OPENING_WINDOW_LEAD_MS, r as OPENING_WINDOW_TAIL_MS, h as PANEL_HEIGHT_KEY, F as REPORT_SCHEMA_VERSION, y as RETIRED_FLAGS, b as RETIRED_MARKER, a as STALL_MS, t as STUCK_STATUS_MS, B as attachDevtoolsPanel, z as attachFlightRecorder, m as captureEnvironment, M as classifyDriver, A as computeFrameStats, k as computePhaseStats, j as computePlayerGapStats, o as deriveFlightAnomalies, D as deriveOverrideWarnings, s as deriveReportAnomalies, u as detectEngine, d as isEmulationSuspected, N as kindFromStatus, P as parseTranslateX, f as sampleRafCadence, E as snapshotOverrides };
+export { c as BLIND_SPOTS, _ as CORE_FLAGS, g as DEVTOOLS_OWNED_FLAGS, v as FLAG_REGISTRY, e as LONG_GAP_MS, i as MID_FLIGHT_TASK_MS, n as OPENING_WINDOW_LEAD_MS, r as OPENING_WINDOW_TAIL_MS, h as PANEL_HEIGHT_KEY, P as REPORT_SCHEMA_VERSION, y as RETIRED_FLAGS, b as RETIRED_MARKER, a as STALL_MS, t as STUCK_STATUS_MS, z as attachDevtoolsPanel, R as attachFlightRecorder, m as captureEnvironment, j as classifyDriver, k as computeFrameStats, O as computePhaseStats, A as computePlayerGapStats, o as deriveFlightAnomalies, E as deriveOverrideWarnings, s as deriveReportAnomalies, u as detectEngine, d as isEmulationSuspected, M as kindFromStatus, N as parseTranslateX, f as sampleRafCadence, T as snapshotOverrides };

package/dist/overrides.d.ts

@@ -23,7 +23,12 @@ export interface FlagDescriptor {
  * recorder generating its own false lead.
  */
 export declare const DEVTOOLS_OWNED_FLAGS: readonly FlagDescriptor[];
-/** Every `flemo:*` key the library reads, mirrored from core. */
+/**
+ * Every `flemo:*` key the library reads. EMPTY since 2026-08-31: the engine's
+ * diagnostic surface was removed from the shipped package outright, so a
+ * session key can no longer change what a flight does. The array stays as the
+ * shape a report reads, and so this file keeps saying so out loud.
+ */
 export declare const CORE_FLAGS: readonly FlagDescriptor[];
 export declare const FLAG_REGISTRY: readonly FlagDescriptor[];
 /**

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@flemo/devtools",
-  "version": "0.3.0",
+  "version": "0.4.0",
   "description": "Zero-config flight recorder for flemo screen transitions: captures per-flight driver routing, frame pacing, long tasks, landing residues, active debug overrides, and environment/observation-trap fingerprints into one JSON report readable by humans and coding agents.",
   "main": "./dist/index.mjs",
   "module": "./dist/index.mjs",
@@ -34,17 +34,17 @@
   "homepage": "https://flemo.dev",
   "license": "MIT",
   "devDependencies": {
+    "@flemo/core": "2.2.0",
+    "@flemo/eslint-config": "0.0.0",
+    "@flemo/tsconfig": "0.0.0",
     "@types/node": "^24.13.1",
-    "@vitest/coverage-v8": "^4.1.10",
+    "@vitest/coverage-v8": "^4.1.11",
     "eslint": "^9.39.5",
     "jsdom": "^29.1.1",
     "typescript": "^6.0.3",
-    "vite": "^8.2.1",
+    "vite": "^8.2.2",
     "vite-plugin-dts": "^5.0.3",
-    "vitest": "^4.1.10",
-    "@flemo/core": "1.30.0",
-    "@flemo/eslint-config": "0.0.0",
-    "@flemo/tsconfig": "0.0.0"
+    "vitest": "^4.1.11"
   },
   "publishConfig": {
     "access": "public"

package/dist/__tests__/overridesRegistry.test.d.ts

@@ -1 +0,0 @@
-export {};