@flemo/devtools 0.2.1 → 0.3.0

package/dist/noop.d.ts

@@ -10,4 +10,4 @@ export declare const attachFlightRecorder: (_options?: FlightRecorderOptions) =>
 export declare const attachDevtoolsPanel: (_options?: DevtoolsPanelOptions) => DevtoolsPanelHandle;
 export type { FlemoGlobal } from './recorder';
 export type { DevtoolsPanelHandle, DevtoolsPanelOptions } from './panel';
-export type { DriverPolicySection, EnvironmentFingerprint, FlemoReport, FlightDriver, FlightHolds, FlightKind, FlightParticipants, FlightRecord, FlightRecorderHandle, FlightRecorderOptions, FlightTimestamp, FramePhaseStats, FrameSampleStats, LandingAudit, LongTaskSpan, ObservationCapabilities, OverridesSection, PlayerGapStats, UaBrand } from './types';
+export type { EnvironmentFingerprint, FlemoReport, FlightDriver, FlightHolds, FlightKind, FlightParticipants, FlightRecord, FlightRecorderHandle, FlightRecorderOptions, FlightTimestamp, FramePhaseStats, FrameSampleStats, LandingAudit, LongTaskSpan, ObservationCapabilities, OverridesSection, PlayerGapStats, UaBrand } from './types';

package/dist/noop.mjs

@@ -11,7 +11,7 @@ var e = 30, t = 1e4, n = 50, r = 120, i = 100, a = 48, o = (e) => {
 	return d.holdReassertedAtMs !== null && n.push(`hold re-asserted ${d.holdReassertedAtMs}ms into the flight, after it had already released (an interleaved commit wrote the stale paused hold attribute over a running flight — the flemo 2026-08-18 release-race signature; the motion pauses while every timing metric stays clean)`), d.pausedAfterRelease && n.push("compiled animation reported playState=paused after its release (the flight was posed and then stopped mid-motion, not merely starved of frames)"), d.longestStallMs >= 48 && n.push(`motion stalled ${d.longestStallMs}ms mid-flight (${d.stalledFrames}/${d.sampledFrames} released frames advanced neither the animation clock nor the pose — freeze, or freeze-then-leap if the flight still landed on time)`), d.sampledFrames === 0 && e.releasedAtMs !== null && n.push("no released frames were sampled (the flight ended at or before its own hold release — the visible motion, if any, was never observed)"), f.completedUnheld > 0 && n.push(`${f.completedUnheld} image(s) finished loading mid-flight without a hold (${f.completedDuringFlight} completed, ${f.heldDuringFlight} held; ${f.loadingAtStart} were loading at t0, ${f.addedDuringFlight} arrived mid-flight) — each decode rasters on the moving layer and costs a present; this is the warm-side image-hold regression`), l.orphanedHolds.length > 0 && n.push(`hold markers left on the page at rest: ${l.orphanedHolds.join("; ")} (whatever they hide has no owner left to reveal it — the permanently-blank-avatar class)`), l.residualInlineTransforms.length > 0 && n.push(`residual inline style after COMPLETED: ${l.residualInlineTransforms.join("; ")} (landing cleanup failure — the landed scope belongs to the compiled rest rules)`), l.offViewportAtRest && n.push("screen resting at from-pose while COMPLETED+active (blank-viewport signature — the flemo PR #259 class: a residual pose left the landed screen parked off-viewport)"), l.stuckStatuses.length > 0 && n.push(`transitional status stuck >${t / 1e3}s: ${l.stuckStatuses.join(", ")} (navigation queue lock or missed animationend — later navigations will be swallowed)`), i === "unknown" && n.push("driver could not be classified (no running flemo-* CSSAnimation and no player inline-style signature observed — zero-duration flight, or the sampler attached after motion ended)"), n;
 }, s = (e) => {
 	let n = [];
-	if (e.forcePin !== null && n.push(`active force pin flemo:motion-driver-force=${e.forcePin} — every transition this session is pinned to one driver (A/B residue? pins expire after 24h; clear the key before judging behavior)`), e.clearedForcePin !== null && e.forcePin === null && n.push(`force pin flemo:motion-driver-force=${e.clearedForcePin} was present at attach and has since been cleared (the library strips malformed/expired pins on sight) — early driver decisions in this session may still have been shaped by it`), e.legacyLocalForcePin !== null && n.push(`legacy localStorage driver pin present (flemo:motion-driver-force=${e.legacyLocalForcePin}) — never honored, but it marks A/B residue on this profile`), e.emulationSuspected) {
+	if (e.emulationSuspected) {
 		let t = /Win/i.test(e.platform) ? " (Windows touch hardware makes this signal ambiguous — confirm the DevTools device toolbar state)" : "";
 		n.push("DevTools device emulation suspected — the page composites to a rescaled surface, so visual reports from this session are untrustworthy; judge motion in a plain window or on a real device" + t);
 	}
@@ -98,163 +98,214 @@ var e = 30, t = 1e4, n = 50, r = 120, i = 100, a = 48, o = (e) => {
 			playerGapMirror: Array.isArray(n?.__flemoPlayerGaps)
 		}
 	};
-}, h = [
+}, h = "flemo:devtools-panel-height", g = [{
+	key: "flemo:devtools",
+	storage: "session",
+	kind: "opt-in-diagnostic",
+	values: "\"on\" / \"off\"",
+	fallback: "off",
+	effect: "arms this flight recorder in the playground (?devtools=on)"
+}, {
+	key: h,
+	storage: "session",
+	kind: "production-state",
+	values: "a pixel height",
+	fallback: "(the panel's default height)",
+	effect: "the drawer height this panel was last dragged to"
+}], _ = [
 	{
-		key: "flemo:motion-driver",
-		storage: "local",
+		key: "flemo:sixty",
+		storage: "session",
 		kind: "production-state",
-		description: "learned driver ledger ('css' = player demoted on this device, 'raf' = clean probe)"
+		values: "\"high\" / a streak count",
+		fallback: "(learned)",
+		effect: "steady-60 desktop verdict seed — owned by steadySixtyCadence.ts"
 	},
 	{
-		key: "flemo:motion-driver-force",
+		key: "flemo:settle-gate",
 		storage: "session",
-		kind: "opt-in-diagnostic",
-		description: "hard driver pin ('css@<epoch-ms>' / 'raf@<epoch-ms>', 24h TTL) — pins EVERY transition"
+		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"
 	},
 	{
-		key: "flemo:lpm",
+		key: "flemo:arrivalhold",
 		storage: "session",
-		kind: "production-state",
-		description: "low-power-mode cadence seed (learned)"
+		kind: "production-default-with-override",
+		values: "\"off\"",
+		fallback: "on",
+		effect: "the whole in-flight hold set (arrival, response, invisible animations, images)"
 	},
 	{
-		key: "flemo:sixty",
+		key: "flemo:deskflip",
 		storage: "session",
-		kind: "production-state",
-		description: "steady-60 display verdict seed ('high' latches, a count seeds the streak)"
+		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"
 	},
 	{
-		key: "flemo:lat",
+		key: "flemo:deskhead",
 		storage: "session",
-		kind: "production-state",
-		description: "LPM release-latency seed (learned)"
+		kind: "production-default-with-override",
+		values: "\"on\" / \"off\"",
+		fallback: "desktop macOS WebKit",
+		effect: "desktop flat-head keyframes; arming it retires the desktop birth anchor"
 	},
 	{
-		key: "flemo:landing-snap",
+		key: "flemo:creep",
 		storage: "session",
-		kind: "opt-in-diagnostic",
-		description: "Blink landing pixel-snap easing A/B"
+		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"
 	},
 	{
-		key: "flemo:imghold",
+		key: "flemo:relcommit",
 		storage: "session",
-		kind: "opt-in-diagnostic",
-		description: "flight-scoped <img> reveal hold"
+		kind: "production-default-with-override",
+		values: "\"defer\" / \"sync\"",
+		fallback: "touch WebKit",
+		effect: "the release's reconcile lands next frame instead of synchronously"
 	},
 	{
-		key: "flemo:settle-gate",
+		key: "flemo:imgoffload",
 		storage: "session",
 		kind: "production-default-with-override",
-		description: "render-settle entry gate 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"
 	},
 	{
-		key: "flemo:handoff",
+		key: "flemo:governed",
 		storage: "session",
-		kind: "opt-in-diagnostic",
-		description: "anchored-opening handoff (POP-scoped)"
+		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"
 	},
 	{
-		key: "flemo:handoffms",
+		key: "flemo:imghold",
 		storage: "session",
 		kind: "opt-in-diagnostic",
-		description: "handoff point override (ms)"
+		values: "\"on\" / \"off\"",
+		fallback: "off",
+		effect: "flight-scoped <img> reveal hold"
 	},
 	{
-		key: "flemo:apply",
+		key: "flemo:preraster",
 		storage: "session",
 		kind: "opt-in-diagnostic",
-		description: "force the scrub-WAAPI value-application tier"
+		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"
 	},
 	{
-		key: "flemo:snap",
+		key: "flemo:layers",
 		storage: "session",
-		kind: "production-default-with-override",
-		description: "player device-pixel snap policy override"
+		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"
 	},
 	{
-		key: "flemo:snapband",
+		key: "flemo:freeze",
 		storage: "session",
 		kind: "opt-in-diagnostic",
-		description: "'hybrid' snap jitter-band width (device px)"
+		values: "\"shallow\"",
+		fallback: "off",
+		effect: "keep the direct prev screen live instead of freezing it"
+	}
+], v = [..._, ...g], y = [
+	{
+		key: "flemo:motion-driver",
+		storage: "local",
+		retiredWith: "the per-origin driver demotion ledger (2026-08-19)"
 	},
 	{
-		key: "flemo:layers",
+		key: "flemo:motion-driver-force",
 		storage: "session",
-		kind: "opt-in-diagnostic",
-		description: "resident screen layers at rest"
+		retiredWith: "the hard driver pin, with the rAF player (2026-08-22)"
 	},
 	{
-		key: "flemo:freeze",
+		key: "flemo:landing-snap",
 		storage: "session",
-		kind: "opt-in-diagnostic",
-		description: "keep the direct prev screen live"
+		retiredWith: "the integer-device-pixel landing snap, falsified on device (2026-08-22)"
 	},
 	{
-		key: "flemo:preraster",
+		key: "flemo:handoff",
 		storage: "session",
-		kind: "opt-in-diagnostic",
-		description: "promote the entering content layer through the hold"
+		retiredWith: "the player's anchored-opening handoff (2026-08-22)"
 	},
 	{
-		key: "flemo:imgoffload",
+		key: "flemo:handoffms",
 		storage: "session",
-		kind: "production-default-with-override",
-		description: "image decode offloader override"
+		retiredWith: "the player's anchored-opening handoff (2026-08-22)"
 	},
 	{
-		key: "flemo:devtools",
+		key: "flemo:apply",
 		storage: "session",
-		kind: "opt-in-diagnostic",
-		description: "arms this flight recorder in the playground (?devtools=on)"
+		retiredWith: "the scrub-WAAPI value-application tier (2026-08-22)"
+	},
+	{
+		key: "flemo:snap",
+		storage: "session",
+		retiredWith: "the player's device-pixel snap policy (2026-08-22)"
+	},
+	{
+		key: "flemo:snapband",
+		storage: "session",
+		retiredWith: "the player's device-pixel snap policy (2026-08-22)"
+	},
+	{
+		key: "flemo:lat",
+		storage: "session",
+		retiredWith: "the Low Power Mode release-latency probe (2026-08-22)"
 	}
-], g = "flemo:motion-driver-force", _ = `${g} (localStorage — legacy location)`, v = (e) => {
+], b = "(retired — the library no longer reads this)", x = (e) => {
 	try {
 		let t = e === "session" ? sessionStorage : localStorage;
 		return t.length, t;
 	} catch {
 		return null;
 	}
-}, y = (e, t) => {
+}, S = (e, t) => {
 	try {
 		return e ? e.getItem(t) : null;
 	} catch {
 		return null;
 	}
-}, b = new Set(h.map((e) => e.key)), x = () => {
-	let e = {}, t = v("session"), n = v("local");
-	for (let r of h) {
-		let i = y(r.storage === "session" ? t : n, r.key);
+}, 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 = () => {
+	let e = {}, t = x("session"), n = x("local");
+	for (let r of v) {
+		let i = S(r.storage === "session" ? t : n, r.key);
 		i !== null && (e[r.key] = i);
 	}
-	let r = y(n, g);
-	r !== null && (e[_] = r);
+	for (let r of y) for (let [i, a] of [[t, "sessionStorage"], [n, "localStorage"]]) {
+		let t = S(i, r.key);
+		t !== null && (e[`${r.key} (${a}) ${b}`] = t);
+	}
 	for (let [r, i] of [[t, "sessionStorage"], [n, "localStorage"]]) if (r) try {
 		for (let t = 0; t < r.length; t += 1) {
 			let n = r.key(t);
-			!n || !n.startsWith("flemo:") || b.has(n) || (e[`${n} (${i}, unknown key)`] = r.getItem(n) ?? "");
+			!n || !n.startsWith("flemo:") || C.has(n) || w.has(n) || (e[`${n} (${i}, unknown key)`] = r.getItem(n) ?? "");
 		}
 	} catch {}
 	return e;
-}, S = (e) => {
+}, D = (e) => {
 	let t = [];
 	for (let [n, r] of Object.entries(e)) {
-		if (n === g) {
-			t.push(`${n}=${r} — A DRIVER PIN IS ACTIVE: every transition this session is forced onto one driver, bypassing measurement and demotion. If you did not set it deliberately just now, it is A/B residue (mobile tab restoration resurrects sessionStorage across days; pins expire after 24h). This exact residue once burned a multi-day investigation — clear the key before judging any behavior.`);
-			continue;
-		}
-		if (n === _) {
-			t.push(`${n}=${r} — legacy localStorage driver pin present. The library removes it on sight and never honors it, but its existence means an old A/B session left residue on this profile.`);
+		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;
 		}
-		if (n.startsWith(`${g} `)) {
-			t.push(`${n}=${r} — a driver force pin was observed this session (see marker in the key). Even a since-cleared pin may have shaped early driver decisions; treat this session's routing as suspect.`);
-			continue;
-		}
-		let e = h.find((e) => n === e.key || n.startsWith(`${e.key} `));
-		!e || e.key === "flemo:devtools" || (e.kind === "opt-in-diagnostic" ? t.push(`${n}=${r} — opt-in diagnostic active (${e.description}); 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.description}).`));
+		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}.`));
 	}
 	return t;
-}, C = (e) => Math.round(e * 10) / 10, w = (e) => {
+}, O = (e) => Math.round(e * 10) / 10, k = (e) => {
 	if (e.length === 0) return {
 		count: 0,
 		medianGapMs: 0,
@@ -264,11 +315,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: C(t[Math.floor(t.length / 2)]),
-		maxGapMs: C(t[t.length - 1]),
+		medianGapMs: O(t[Math.floor(t.length / 2)]),
+		maxGapMs: O(t[t.length - 1]),
 		over30Count: e.filter((e) => e >= 30).length
 	};
-}, T = (e, t = []) => {
+}, A = (e, t = []) => {
 	let n = [...e, ...t];
 	return {
 		...n.length === 0 ? {
@@ -279,21 +330,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: C(e[Math.floor(e.length / 2)]),
-				maxGapMs: C(e[e.length - 1])
+				medianGapMs: O(e[Math.floor(e.length / 2)]),
+				maxGapMs: O(e[e.length - 1])
 			};
 		})(),
-		longGaps: n.filter((e) => e >= 30).map(C),
-		held: w(e),
-		released: w(t)
+		longGaps: n.filter((e) => e >= 30).map(O),
+		held: k(e),
+		released: k(t)
 	};
-}, E = (e) => e.length === 0 ? null : {
-	maxMs: C(Math.max(...e)),
+}, j = (e) => e.length === 0 ? null : {
+	maxMs: O(Math.max(...e)),
 	over30Count: e.filter((e) => e >= 30).length
-}, D = (e) => {
+}, M = (e) => {
 	let t = e.playerSuppression || e.playerAdvance;
 	return t && e.compiledAnimation ? "mixed" : t ? "player" : e.compiledAnimation ? "compiled" : "unknown";
-}, O = (e) => e === "PUSHING" ? "PUSH" : e === "POPPING" ? "POP" : e === "REPLACING" ? "REPLACE" : null, k = (e) => {
+}, N = (e) => e === "PUSHING" ? "PUSH" : e === "POPPING" ? "POP" : e === "REPLACING" ? "REPLACE" : null, P = (e) => {
 	let t = /^matrix3d\(([^)]+)\)$/.exec(e.trim());
 	if (t) {
 		let e = t[1].split(",").map((e) => Number(e.trim()));
@@ -305,7 +356,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;
-}, A = "2", j = "@flemo/devtools resolved to its production entry: nothing was recorded. Run a development build to collect a real report.", M = () => {}, N = () => ({
+}, F = "2", I = "@flemo/devtools resolved to its production entry: nothing was recorded. Run a development build to collect a real report.", L = () => {}, R = () => ({
 	generatedAt: (/* @__PURE__ */ new Date()).toISOString(),
 	version: "inert",
 	environment: {
@@ -338,19 +389,15 @@ var e = 30, t = 1e4, n = 50, r = 120, i = 100, a = 48, o = (e) => {
 	},
 	overrides: {
 		active: {},
-		warnings: [j]
-	},
-	driverPolicy: {
-		demotion: null,
-		forcePin: null
+		warnings: [I]
 	},
 	flights: [],
-	anomalies: [j],
+	anomalies: [I],
 	blindSpots: [],
-	judgingProtocol: [j]
-}), P = (e) => ({
-	detach: M,
-	report: N
-}), F = (e) => ({ detach: M });
+	judgingProtocol: [I]
+}), z = (e) => ({
+	detach: L,
+	report: R
+}), B = (e) => ({ detach: L });
 //#endregion
-export { c as BLIND_SPOTS, h as FLAG_REGISTRY, _ as LEGACY_LOCAL_PIN_KEY, e as LONG_GAP_MS, i as MID_FLIGHT_TASK_MS, n as OPENING_WINDOW_LEAD_MS, r as OPENING_WINDOW_TAIL_MS, A as REPORT_SCHEMA_VERSION, a as STALL_MS, t as STUCK_STATUS_MS, F as attachDevtoolsPanel, P as attachFlightRecorder, m as captureEnvironment, D as classifyDriver, T as computeFrameStats, w as computePhaseStats, E as computePlayerGapStats, o as deriveFlightAnomalies, S as deriveOverrideWarnings, s as deriveReportAnomalies, u as detectEngine, d as isEmulationSuspected, O as kindFromStatus, k as parseTranslateX, f as sampleRafCadence, x 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, 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 };

package/dist/overrides.d.ts

@@ -1,18 +1,50 @@
 export type FlagClass = "production-state" | "production-default-with-override" | "opt-in-diagnostic";
+/**
+ * The panel's drawer height. Declared HERE rather than in the panel so the
+ * registry below can name it: a `flemo:` key the recorder writes but does not
+ * declare shows up in its own reports as an unknown key.
+ */
+export declare const PANEL_HEIGHT_KEY = "flemo:devtools-panel-height";
 export interface FlagDescriptor {
     key: string;
     storage: "session" | "local";
     kind: FlagClass;
-    description: string;
+    /** Accepted values, for a report to spell out. */
+    values: string;
+    /** The default when the key is unset. */
+    fallback: string;
+    /** What arming it changes. */
+    effect: string;
 }
+/**
+ * Keys DEVTOOLS itself owns. Core neither reads nor declares them, so they are
+ * listed here and excluded from the comparison against core — without a row
+ * each one would surface in every report as an unknown key, which is the
+ * recorder generating its own false lead.
+ */
+export declare const DEVTOOLS_OWNED_FLAGS: readonly FlagDescriptor[];
+/** Every `flemo:*` key the library reads, mirrored from core. */
+export declare const CORE_FLAGS: readonly FlagDescriptor[];
 export declare const FLAG_REGISTRY: readonly FlagDescriptor[];
-/** Marker suffix for the legacy-location residue of the force pin. */
-export declare const LEGACY_LOCAL_PIN_KEY = "flemo:motion-driver-force (localStorage \u2014 legacy location)";
 /**
- * Snapshot every `flemo:*` key currently set, from both storages: the
- * registry keys from their native storage, the legacy localStorage location
- * of the force pin, and any UNKNOWN `flemo:`-prefixed key either storage
- * holds (a future flag, or hand-set residue).
+ * Keys the library once read and no longer does. They are still ENUMERATED so
+ * a report can say "this is set, and it does nothing" — residue that is merely
+ * unknown reads as a lead worth chasing.
+ */
+export interface RetiredFlag {
+    key: string;
+    storage: "session" | "local";
+    /** What it used to do, and when it stopped doing it. */
+    retiredWith: string;
+}
+export declare const RETIRED_FLAGS: readonly RetiredFlag[];
+/** Marker suffix appended to a retired key so a report reads as a verdict. */
+export declare const RETIRED_MARKER = "(retired \u2014 the library no longer reads this)";
+/**
+ * Snapshot every `flemo:*` key currently set, from both storages: the live
+ * registry keys from their native storage, any RETIRED key still persisted
+ * (marked as such), and any UNKNOWN `flemo:`-prefixed key either storage holds
+ * (a future flag, or hand-set residue).
  */
 export declare const snapshotOverrides: () => Record<string, string>;
 /**

package/dist/types.d.ts

@@ -238,26 +238,12 @@ export interface OverridesSection {
     /** Derived, prominent warnings — read these before trusting anything. */
     warnings: string[];
 }
-export interface DriverPolicySection {
-    /**
-     * localStorage `flemo:motion-driver` — the learned ledger. "css" means the
-     * device earned a persisted player demotion; "raf" means a clean probe.
-     */
-    demotion: string | null;
-    /**
-     * sessionStorage `flemo:motion-driver-force` raw value. NON-NULL MEANS A
-     * PIN IS ACTIVE: every transition is forced onto one driver. Almost always
-     * A/B residue when found unexpectedly.
-     */
-    forcePin: string | null;
-}
 export interface FlemoReport {
     generatedAt: string;
     /** Report schema version (not the package version). */
     version: string;
     environment: EnvironmentFingerprint;
     overrides: OverridesSection;
-    driverPolicy: DriverPolicySection;
     flights: FlightRecord[];
     /** Session-level findings (observation traps, active pins, stuck flights). */
     anomalies: string[];

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@flemo/devtools",
-  "version": "0.2.1",
+  "version": "0.3.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",
@@ -42,6 +42,7 @@
     "vite": "^8.2.1",
     "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"
   },