@barefootjs/jsx 0.15.2 → 0.16.0

package/dist/index.d.ts

@@ -183,8 +183,8 @@ export { isLowerableObjectRestDestructure } from './loop-destructure.ts';
 export { buildComponentGraph, buildComponentAnalysis, buildGraphFromIR, buildEventSummary, buildLoopSummary, buildWhyUpdate, traceUpdatePath, formatComponentGraph, formatUpdatePath, formatEventSummary, formatLoopSummary, formatWhyUpdate, describeFallback, formatFallbackExplanations, buildComponentSummary, formatComponentSummary, formatSignalTrace, generateStaticTrace, graphToJSON, resolveSetters, buildLocalFunctionSetterMap, makeIdCallRegex, } from './debug.ts';
 export type { ComponentGraph, ComponentAnalysis, SignalNode, MemoNode, EffectNode, DomBinding, UpdatePath, SignalTrace, EventBinding, SetterRef, FnSetterResolution, EventSummary, LoopInfo, LoopChildBinding, LoopSummary, WhyUpdateResult, WhyUpdateDep, WhyUpdateSource, FallbackExplanation, ComponentSummary } from './debug.ts';
 export type { WrapReason } from './ir-to-client-js/reactivity.ts';
-export { PROFILE_SCHEMA_VERSION, buildStaticBudget, formatStaticBudget, diffStaticBudget, formatBudgetDiff, buildProfileReport, formatProfileReport, buildIdIndex, joinProfilerEvents, parseProfilerId, analyzeHotSubscribers, formatHotSubscribers, findUninstrumentedEffects, analyzeWastedReReruns, formatWastedReReruns, analyzeBatchAdvisor, formatBatchAdvisor, } from './profiler.ts';
-export type { StaticBudget, StaticBudgetOptions, FanOutEntry, BudgetHandler, BudgetDiff, FanOutChange, ProfileReport, ProfileReportInput, ProfileCoverage, DiagnosticsSummary, EffectCandidate, IdIndex, ResolvedNode, JoinResult, JoinedEvent, UnattributedId, HotSubscribersResult, HotSubscriber, HotSubscribersOptions, WastedReRunsResult, WastedSubscriber, WastedReRunsOptions, BatchAdvisorResult, BatchCandidate, BatchSafety, } from './profiler.ts';
+export { PROFILE_SCHEMA_VERSION, buildStaticBudget, formatStaticBudget, diffStaticBudget, formatBudgetDiff, buildProfileReport, formatProfileReport, buildIdIndex, joinProfilerEvents, parseProfilerId, analyzeHotSubscribers, formatHotSubscribers, findUninstrumentedEffects, analyzeWastedReReruns, formatWastedReReruns, analyzeBatchAdvisor, formatBatchAdvisor, evaluateProfileGates, } from './profiler.ts';
+export type { StaticBudget, StaticBudgetOptions, FanOutEntry, BudgetHandler, BudgetDiff, FanOutChange, ProfileReport, ProfileReportInput, ProfileCoverage, DiagnosticsSummary, EffectCandidate, IdIndex, ResolvedNode, JoinResult, JoinedEvent, UnattributedId, HotSubscribersResult, HotSubscriber, HotSubscribersOptions, WastedReRunsResult, WastedSubscriber, WastedReRunsOptions, BatchAdvisorResult, BatchCandidate, BatchSafety, ProfileSeverity, ProfileStatus, AgentFinding, ScenarioGuidance, GateName, GateConfig, GateCheck, GateResult, } from './profiler.ts';
 export { buildReactiveProfile, buildProfileFromGraph, diffProfiles, formatSingleProfile, formatProfileTable, formatProfileDiff, profileToJSON, } from './debug-profile.ts';
 export type { ComponentProfile, ComponentProfileMetrics, ProfileFinding, ProfileDiff, ProfileDiffEntry, } from './debug-profile.ts';
 export { BOOLEAN_ATTRS, isBooleanAttr } from './html-constants.ts';

package/dist/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"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"}

package/dist/index.js

@@ -20725,6 +20725,71 @@ function turnToEventBinding(graph, events) {
   }
   return out;
 }
+function nextCommandsForSubscriber(fallbackComponent, subscriber) {
+  const cmds = [];
+  const parsed = parseProfilerId(subscriber);
+  const component = parsed?.component ?? fallbackComponent;
+  if (parsed) {
+    if (parsed.kind === "memo" || parsed.kind === "signal") {
+      cmds.push(`bf debug trace ${component} ${parsed.rest} --json`);
+    } else if (parsed.kind === "binding") {
+      cmds.push(`bf debug why-update ${component} ${parsed.rest} --json`);
+    }
+  }
+  cmds.push(`bf debug graph ${component} --json`);
+  return cmds;
+}
+function buildAgentFindings(component, hotSubscribers, wastedReReruns, batchAdvisor, unattributed) {
+  const findings = [];
+  for (const s of hotSubscribers.subscribers) {
+    if (!s.hot)
+      continue;
+    findings.push({
+      kind: "hot-subscriber",
+      severity: "warning",
+      actionable: s.loc !== undefined,
+      subscriber: s.subscriber,
+      loc: s.loc,
+      message: `${s.name ?? s.subscriber} ran ${s.runsPerTurn.toFixed(1)}×/turn — re-run pressure (split or batch).`,
+      nextCommands: nextCommandsForSubscriber(component, s.subscriber)
+    });
+  }
+  for (const s of wastedReReruns.subscribers) {
+    if (!s.wasted)
+      continue;
+    findings.push({
+      kind: "wasted-re-run",
+      severity: "warning",
+      actionable: s.loc !== undefined,
+      subscriber: s.subscriber,
+      loc: s.loc,
+      message: `${s.name ?? s.subscriber} produced identical output in ${Math.round(s.wastedRatio * 100)}% of runs — finer split.`,
+      nextCommands: nextCommandsForSubscriber(component, s.subscriber)
+    });
+  }
+  for (const c of batchAdvisor.candidates) {
+    findings.push({
+      kind: "batch-candidate",
+      severity: c.safety === "safe" ? "warning" : "info",
+      actionable: c.safety === "safe" && c.loc !== undefined,
+      subscriber: c.turn,
+      loc: c.loc,
+      message: `${c.handler ?? c.turn} re-ran shared effects ${c.savings}× extra across ${c.writes} writes — batch() candidate (${c.safety}).`,
+      nextCommands: nextCommandsForSubscriber(component, c.turn)
+    });
+  }
+  for (const u of unattributed) {
+    findings.push({
+      kind: "coverage-gap",
+      severity: "warning",
+      actionable: true,
+      subscriber: u.id,
+      message: `Unresolved subscriber id "${u.id}" — could not map to source (scope caveat).`,
+      nextCommands: nextCommandsForSubscriber(component, u.id)
+    });
+  }
+  return findings;
+}
 function buildProfileReport(input) {
   const { source, filePath, componentName, scenario, events } = input;
   const primary = buildComponentAnalysis(source, filePath, componentName).graph;
@@ -20801,6 +20866,27 @@ function buildProfileReport(input) {
       handlerIds.add(e.turn);
     }
   }
+  const findings = buildAgentFindings(primary.componentName, hotSubscribers, wastedReReruns, batchAdvisor, unattributed);
+  const status = findings.some((f) => f.severity === "warning" || f.severity === "error") ? "warning" : "ok";
+  const ratio = handlersTotal > 0 ? Math.min(1, handlerIds.size / handlersTotal) : 1;
+  let guidance;
+  if (turnSeqs.size === 0) {
+    guidance = handlersTotal === 0 ? {
+      reason: "no-handlers",
+      message: "No event handlers — use the static budget instead of a dynamic run.",
+      nextCommands: [`bf debug profile ${primary.componentName} --json`]
+    } : {
+      reason: "no-interactions",
+      message: "Handlers exist but none fired — they likely live in composed children. Drive the component with a story/scenario file.",
+      nextCommands: [`bf debug profile ${primary.componentName} --scenario <story.tsx> --json`]
+    };
+  } else if (ratio < 1) {
+    guidance = {
+      reason: "partial-coverage",
+      message: `Only ${handlerIds.size}/${handlersTotal} handlers exercised — a story/scenario file can cover the rest.`,
+      nextCommands: [`bf debug profile ${primary.componentName} --scenario <story.tsx> --json`]
+    };
+  }
   return {
     kind: "profile",
     schemaVersion: PROFILE_SCHEMA_VERSION,
@@ -20815,9 +20901,13 @@ function buildProfileReport(input) {
     coverage: {
       handlersFired: handlerIds.size,
       handlersTotal,
+      ratio,
       unattributed,
       diagnostics: { count: diagnostics.length, sample: diagnostics.slice(0, 3).map((d) => d.id) }
-    }
+    },
+    status,
+    findings,
+    ...guidance ? { guidance } : {}
   };
 }
 function formatProfileReport(r) {
@@ -20842,9 +20932,67 @@ function formatProfileReport(r) {
   if (c.diagnostics.count > 0) {
     lines.push(`  · ${c.diagnostics.count} anonymous runtime id(s) (non-actionable bookkeeping)`);
   }
+  lines.push("");
+  lines.push(`status: ${r.status} (${r.findings.length} finding(s))`);
+  if (r.guidance) {
+    lines.push(`  guidance: ${r.guidance.message}`);
+    lines.push(`  next: ${r.guidance.nextCommands[0]}`);
+  } else if (r.findings.length > 0) {
+    lines.push(`  next: ${r.findings[0].nextCommands[0]}`);
+  }
   return lines.join(`
 `);
 }
+function evaluateProfileGates(report, config) {
+  const failOn = new Set(config.failOn ?? []);
+  const checks = [];
+  if (failOn.has("coverage") || config.minCoverage !== undefined) {
+    const threshold = config.minCoverage ?? 1;
+    const observed = report.coverage.ratio;
+    checks.push({
+      gate: "coverage",
+      passed: observed >= threshold,
+      observed,
+      threshold,
+      message: `coverage ${(observed * 100).toFixed(0)}% ${observed >= threshold ? "≥" : "<"} required ${(threshold * 100).toFixed(0)}%`
+    });
+  }
+  if (failOn.has("unresolved") || config.maxUnresolved !== undefined) {
+    const threshold = config.maxUnresolved ?? 0;
+    const observed = report.coverage.unattributed.length;
+    checks.push({
+      gate: "unresolved",
+      passed: observed <= threshold,
+      observed,
+      threshold,
+      message: `${observed} unresolved id(s) ${observed <= threshold ? "≤" : ">"} allowed ${threshold}`
+    });
+  }
+  if (failOn.has("hot") || config.maxRunsPerTurn !== undefined) {
+    const observed = report.hotSubscribers.subscribers.reduce((m, s) => Math.max(m, s.runsPerTurn), 0);
+    if (config.maxRunsPerTurn !== undefined) {
+      const threshold = config.maxRunsPerTurn;
+      checks.push({
+        gate: "hot",
+        passed: observed <= threshold,
+        observed,
+        threshold,
+        message: `max ${observed.toFixed(1)} runs/turn ${observed <= threshold ? "≤" : ">"} budget ${threshold}`
+      });
+    } else {
+      const anyHot = report.hotSubscribers.subscribers.some((s) => s.hot);
+      checks.push({
+        gate: "hot",
+        passed: !anyHot,
+        observed,
+        threshold: null,
+        message: anyHot ? `hot subscriber(s) present (max ${observed.toFixed(1)} runs/turn)` : "no hot subscribers"
+      });
+    }
+  }
+  const failed = checks.filter((c) => !c.passed).map((c) => c.gate);
+  return { passed: failed.length === 0, failed, checks };
+}
 // src/debug-profile.ts
 var THRESHOLDS = {
   highFanOut: 3,
@@ -21572,6 +21720,7 @@ export {
   extractFunctionParams,
   extractArrowBodyExpression,
   exprToString,
+  evaluateProfileGates,
   evalStringArrayJoin,
   enableCompilerInstrumentation,
   emitParsedExpr,

package/dist/profiler.d.ts

@@ -476,6 +476,13 @@ export interface ProfileCoverage {
     handlersFired: number;
     /** Handlers the IR knows about (`buildEventSummary`). */
     handlersTotal: number;
+    /**
+     * `handlersFired / handlersTotal` in `[0,1]` — the fraction of known handlers
+     * this run exercised, so an agent can gate on it (`--min-coverage`) without
+     * dividing the two counts itself (#1841). `1` when the component has no
+     * handlers (nothing to cover ⇒ trivially complete, not a gap).
+     */
+    ratio: number;
     /** SR4 ids the IR could not resolve — the honest, actionable gap. */
     unattributed: UnattributedId[];
     /**
@@ -501,6 +508,76 @@ export interface ProfileReport {
     wastedReReruns: WastedReRunsResult;
     batchAdvisor: BatchAdvisorResult;
     coverage: ProfileCoverage;
+    /**
+     * Normalized run status an agent can branch on without parsing prose (#1841):
+     * `ok` when nothing is flagged, `warning` when any finding is severity
+     * `warning` or higher — regardless of its `actionable` flag, since an
+     * unresolved-but-real cost (e.g. a hot subscriber with no source loc) is still
+     * worth surfacing. A failed *gate* escalates this to `error` — but gates are
+     * policy applied by the CLI from flags, so the builder only ever sets
+     * `ok`/`warning` here.
+     */
+    status: ProfileStatus;
+    /**
+     * Flattened, normalized findings (#1841): the hot/wasted/batch/coverage tables
+     * re-expressed with a single `severity` scale, an explicit `actionable` flag,
+     * and `nextCommands` — the exact follow-up `bf debug …` invocations to run.
+     * The structured tables above stay the source of truth; this is the agent view.
+     */
+    findings: AgentFinding[];
+    /**
+     * Coverage guidance for an under-exercised run (#1841): present only when the
+     * scenario fired no or only some handlers, which usually means a story file is
+     * needed (handlers live in composed children).
+     */
+    guidance?: ScenarioGuidance;
+}
+/** Normalized finding severity an agent can branch on without parsing prose. */
+export type ProfileSeverity = 'info' | 'warning' | 'error';
+/** Top-level run status: `ok` (clean), `warning` (findings), `error` (gate failed). */
+export type ProfileStatus = 'ok' | 'warning' | 'error';
+/**
+ * One normalized, machine-actionable finding flattened from the per-analysis
+ * tables (hot subscribers / wasted re-runs / batch advisor / coverage gaps).
+ * Carries the agent contract fields the issue asks for: a normalized `severity`,
+ * an explicit `actionable` flag (`false` ⇒ no safe direct fix — e.g. an
+ * unverified advisory), and `nextCommands` — valid, ready-to-run `bf debug …`
+ * follow-ups.
+ */
+export interface AgentFinding {
+    kind: 'hot-subscriber' | 'wasted-re-run' | 'batch-candidate' | 'coverage-gap';
+    severity: ProfileSeverity;
+    /**
+     * Whether this finding has a concrete fix worth acting on directly. `false`
+     * marks a finding an agent should *not* apply blindly — an unverified `batch()`
+     * advisory (the wrap could change behavior) or a finding whose source location
+     * the id index couldn't resolve. A coverage gap is `actionable: true`: the next
+     * step (widen the scenario, inspect the graph) is clear even without a `loc`.
+     */
+    actionable: boolean;
+    /** The compiler subscriber/turn id this finding is about, when it has one. */
+    subscriber?: string;
+    /** Source location, when the id resolved to an IR node. */
+    loc?: {
+        file: string;
+        line: number;
+    };
+    /** One-line human summary — the same sentence the text report would print. */
+    message: string;
+    /** Follow-up commands to run next — valid, ready-to-run `bf debug …` lines. */
+    nextCommands: string[];
+}
+/**
+ * Coverage guidance for an under-exercised run (#1841). `--scenario auto` can
+ * only fire handlers the IR exposes on *this* component; for a compound/context
+ * component whose handlers live in composed children it fires `0/N`, and the
+ * honest next step is a story/scenario file rather than trusting a thin run.
+ */
+export interface ScenarioGuidance {
+    /** Why coverage was incomplete — drives the suggested next step. */
+    reason: 'no-handlers' | 'no-interactions' | 'partial-coverage';
+    message: string;
+    nextCommands: string[];
 }
 export interface ProfileReportInput {
     source: string;
@@ -536,4 +613,42 @@ export interface ProfileReportInput {
  */
 export declare function buildProfileReport(input: ProfileReportInput): ProfileReport;
 export declare function formatProfileReport(r: ProfileReport): string;
+/** The gate names `--fail-on` accepts. `regression` applies to `--diff` mode. */
+export type GateName = 'unresolved' | 'hot' | 'coverage' | 'regression';
+/**
+ * Gate thresholds an agent/CI supplies via flags. A gate is *active* when it is
+ * named in `failOn` or its numeric threshold is set — so `--max-unresolved 0`
+ * enforces the unresolved gate without also passing `--fail-on unresolved`.
+ */
+export interface GateConfig {
+    failOn?: readonly GateName[];
+    /** `--min-coverage`: minimum `coverage.ratio` in `[0,1]`. */
+    minCoverage?: number;
+    /** `--max-runs-per-turn`: budget for the hottest subscriber's runs/turn. */
+    maxRunsPerTurn?: number;
+    /** `--max-unresolved`: maximum allowed unresolved (actionable) coverage gaps. */
+    maxUnresolved?: number;
+}
+export interface GateCheck {
+    gate: GateName;
+    passed: boolean;
+    /** The measured value the gate compared (ratio, count, or runs/turn). */
+    observed: number;
+    /** The threshold it was compared against; `null` for a boolean gate. */
+    threshold: number | null;
+    message: string;
+}
+export interface GateResult {
+    passed: boolean;
+    /** Names of the gates that failed — the `gates.failed` an agent branches on. */
+    failed: GateName[];
+    checks: GateCheck[];
+}
+/**
+ * Evaluate the dynamic-run gates (#1841) against a measured report. Pure: maps a
+ * `ProfileReport` + thresholds to a pass/fail decision the CLI turns into an
+ * exit code. The `regression` gate is *not* evaluated here — it belongs to
+ * `--diff` mode, which the CLI gates directly off the `BudgetDiff`.
+ */
+export declare function evaluateProfileGates(report: ProfileReport, config: GateConfig): GateResult;
 //# sourceMappingURL=profiler.d.ts.map

package/dist/profiler.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"profiler.d.ts","sourceRoot":"","sources":["../src/profiler.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"profiler.d.ts","sourceRoot":"","sources":["../src/profiler.ts"],"names":[],"mappings":"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"}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@barefootjs/jsx",
-  "version": "0.15.2",
+  "version": "0.16.0",
   "description": "JSX compiler for BarefootJS - transforms JSX to server HTML + client JS",
   "type": "module",
   "main": "./dist/index.js",
@@ -53,7 +53,7 @@
     "directory": "packages/jsx"
   },
   "dependencies": {
-    "@barefootjs/shared": "0.15.2"
+    "@barefootjs/shared": "0.16.0"
   },
   "peerDependencies": {
     "@barefootjs/client": ">=0.2.0",

package/src/__tests__/profiler.test.ts

@@ -20,6 +20,7 @@ import {
   buildIdIndex,
   joinProfilerEvents,
   findUninstrumentedEffects,
+  evaluateProfileGates,
 } from '../profiler'
 import { buildComponentAnalysis } from '../debug'
 import type { ProfilerEvent } from '@barefootjs/shared'
@@ -533,3 +534,151 @@ describe('findUninstrumentedEffects (#1849 B6)', () => {
     expect(e1.candidates).toEqual([{ file: 'C.tsx', line: 8 }])
   })
 })
+
+describe('agent contract: status, findings, guidance (#1841)', () => {
+  const src = `
+    'use client'
+    import { createSignal, createMemo } from '@barefootjs/client'
+    export function Calc() {
+      const [count, setCount] = createSignal(0)
+      const a = createMemo(() => count() * 2)
+      return <button onClick={() => setCount(count() + 1)}>{a()}</button>
+    }
+  `
+  let n = 0
+  const ev = (type: ProfilerEvent['type'], f: Partial<ProfilerEvent> = {}): ProfilerEvent =>
+    ({ type, seq: n++, turn: null, ...f })
+
+  // A memo that re-runs 3× in a single turn → runsPerTurn 3 → flagged `hot`.
+  function hotRunEvents(): ProfilerEvent[] {
+    n = 0
+    const turn = 'Calc#handler:s0:click'
+    const events: ProfilerEvent[] = [ev('turnBegin', { handlerId: turn })]
+    for (let i = 0; i < 3; i++) {
+      events.push(ev('effectEnter', { subscriber: 'Calc#memo:a', turn }))
+      events.push(ev('effectExit', { subscriber: 'Calc#memo:a', dur: 1, turn }))
+    }
+    events.push(ev('turnEnd', {}))
+    return events
+  }
+
+  test('a clean run is status ok with no findings', () => {
+    n = 0
+    // One memo run in a turn → runsPerTurn 1 → not hot, nothing flagged.
+    const turn = 'Calc#handler:s0:click'
+    const events: ProfilerEvent[] = [
+      ev('turnBegin', { handlerId: turn }),
+      ev('effectEnter', { subscriber: 'Calc#memo:a', turn }),
+      ev('effectExit', { subscriber: 'Calc#memo:a', dur: 1, turn }),
+      ev('turnEnd', {}),
+    ]
+    const r = buildProfileReport({ source: src, filePath: 'Calc.tsx', scenario: 'auto', events })
+    expect(r.status).toBe('ok')
+    expect(r.findings).toHaveLength(0)
+    expect(r.coverage.ratio).toBe(1)
+    expect(r.guidance).toBeUndefined()
+  })
+
+  test('a hot subscriber becomes a warning finding with valid nextCommands', () => {
+    const r = buildProfileReport({ source: src, filePath: 'Calc.tsx', scenario: 'auto', events: hotRunEvents() })
+    expect(r.status).toBe('warning')
+    const hot = r.findings.find(f => f.kind === 'hot-subscriber')!
+    expect(hot.severity).toBe('warning')
+    expect(hot.actionable).toBe(true)
+    expect(hot.subscriber).toBe('Calc#memo:a')
+    // A memo id maps to a name `bf debug trace` accepts; graph is the fallback.
+    expect(hot.nextCommands).toContain('bf debug trace Calc a --json')
+    expect(hot.nextCommands).toContain('bf debug graph Calc --json')
+  })
+
+  test('an unresolved id is an actionable coverage-gap finding', () => {
+    n = 0
+    // A profiler-shaped id with no matching IR node → SR4 coverage gap.
+    const events: ProfilerEvent[] = [ev('effectEnter', { subscriber: 'Calc#memo:ghost' })]
+    const r = buildProfileReport({ source: src, filePath: 'Calc.tsx', scenario: 'auto', events })
+    const gap = r.findings.find(f => f.kind === 'coverage-gap')!
+    expect(gap.actionable).toBe(true)
+    expect(gap.subscriber).toBe('Calc#memo:ghost')
+  })
+
+  test('nextCommands target the component parsed from the id, not the root', () => {
+    n = 0
+    // A scenario-file run resolves subscribers from composed children: the id's
+    // component (`Child`) differs from the profiled root (`Calc`). Follow-up
+    // commands must target `Child`, or they point an agent at the wrong file.
+    const events: ProfilerEvent[] = [ev('effectEnter', { subscriber: 'Child#memo:ghost' })]
+    const r = buildProfileReport({ source: src, filePath: 'Calc.tsx', scenario: 'auto', events })
+    const gap = r.findings.find(f => f.kind === 'coverage-gap')!
+    expect(gap.nextCommands).toContain('bf debug trace Child ghost --json')
+    expect(gap.nextCommands).toContain('bf debug graph Child --json')
+    expect(gap.nextCommands.every(c => !c.includes('graph Calc'))).toBe(true)
+  })
+
+  test('coverage.ratio is clamped to 1 when the stream over-counts handlers', () => {
+    n = 0
+    // Calc exposes a single handler (handlersTotal 1), but a malformed stream
+    // reports two distinct turn ids — without clamping the ratio would be 2.0
+    // and silently pass a `--min-coverage` gate it shouldn't.
+    const events: ProfilerEvent[] = [
+      ev('effectEnter', { subscriber: 'Calc#memo:a', turn: 'Calc#handler:s0:click' }),
+      ev('effectEnter', { subscriber: 'Calc#memo:a', turn: 'Calc#handler:s9:click' }),
+    ]
+    const r = buildProfileReport({ source: src, filePath: 'Calc.tsx', scenario: 'auto', events })
+    expect(r.coverage.ratio).toBe(1)
+    expect(r.coverage.ratio).toBeLessThanOrEqual(1)
+  })
+
+  test('a zero-turn run emits guidance pointing at a story file', () => {
+    n = 0
+    // Handlers exist (the onClick) but none fired → no-interactions guidance.
+    const events: ProfilerEvent[] = [ev('effectEnter', { subscriber: 'Calc#memo:a' })]
+    const r = buildProfileReport({ source: src, filePath: 'Calc.tsx', scenario: 'auto', events })
+    expect(r.turns).toBe(0)
+    expect(r.guidance?.reason).toBe('no-interactions')
+    expect(r.guidance?.nextCommands[0]).toContain('--scenario <story.tsx>')
+  })
+
+  describe('evaluateProfileGates', () => {
+    test('hot gate fails when a subscriber exceeds the runs/turn budget', () => {
+      const r = buildProfileReport({ source: src, filePath: 'Calc.tsx', scenario: 'auto', events: hotRunEvents() })
+      const fail = evaluateProfileGates(r, { maxRunsPerTurn: 2 })
+      expect(fail.passed).toBe(false)
+      expect(fail.failed).toContain('hot')
+      const pass = evaluateProfileGates(r, { maxRunsPerTurn: 5 })
+      expect(pass.passed).toBe(true)
+    })
+
+    test('bare --fail-on hot trips on any flagged hot subscriber', () => {
+      const r = buildProfileReport({ source: src, filePath: 'Calc.tsx', scenario: 'auto', events: hotRunEvents() })
+      const g = evaluateProfileGates(r, { failOn: ['hot'] })
+      expect(g.passed).toBe(false)
+      expect(g.checks[0].threshold).toBeNull()
+    })
+
+    test('coverage gate compares ratio against --min-coverage', () => {
+      n = 0
+      // Handlers exist but only mount runs, no turn → ratio 0.
+      const events: ProfilerEvent[] = [ev('effectEnter', { subscriber: 'Calc#memo:a' })]
+      const r = buildProfileReport({ source: src, filePath: 'Calc.tsx', scenario: 'auto', events })
+      expect(r.coverage.ratio).toBe(0)
+      const g = evaluateProfileGates(r, { minCoverage: 0.8 })
+      expect(g.passed).toBe(false)
+      expect(g.failed).toContain('coverage')
+    })
+
+    test('unresolved gate counts actionable gaps against --max-unresolved', () => {
+      n = 0
+      const events: ProfilerEvent[] = [ev('effectEnter', { subscriber: 'Calc#memo:ghost' })]
+      const r = buildProfileReport({ source: src, filePath: 'Calc.tsx', scenario: 'auto', events })
+      expect(evaluateProfileGates(r, { maxUnresolved: 0 }).passed).toBe(false)
+      expect(evaluateProfileGates(r, { maxUnresolved: 5 }).passed).toBe(true)
+    })
+
+    test('no configured gate yields an empty, passing result', () => {
+      const r = buildProfileReport({ source: src, filePath: 'Calc.tsx', scenario: 'auto', events: hotRunEvents() })
+      const g = evaluateProfileGates(r, {})
+      expect(g.passed).toBe(true)
+      expect(g.checks).toHaveLength(0)
+    })
+  })
+})

package/src/index.ts

@@ -308,6 +308,7 @@ export {
   formatWastedReReruns,
   analyzeBatchAdvisor,
   formatBatchAdvisor,
+  evaluateProfileGates,
 } from './profiler.ts'
 export type {
   StaticBudget,
@@ -335,6 +336,14 @@ export type {
   BatchAdvisorResult,
   BatchCandidate,
   BatchSafety,
+  ProfileSeverity,
+  ProfileStatus,
+  AgentFinding,
+  ScenarioGuidance,
+  GateName,
+  GateConfig,
+  GateCheck,
+  GateResult,
 } from './profiler.ts'
 
 // Reactive profile — findings layer (#1690 dogfood: Bug A/C/D fixes, batch-candidate dedup,

package/src/profiler.ts

@@ -1360,6 +1360,13 @@ export interface ProfileCoverage {
   handlersFired: number
   /** Handlers the IR knows about (`buildEventSummary`). */
   handlersTotal: number
+  /**
+   * `handlersFired / handlersTotal` in `[0,1]` — the fraction of known handlers
+   * this run exercised, so an agent can gate on it (`--min-coverage`) without
+   * dividing the two counts itself (#1841). `1` when the component has no
+   * handlers (nothing to cover ⇒ trivially complete, not a gap).
+   */
+  ratio: number
   /** SR4 ids the IR could not resolve — the honest, actionable gap. */
   unattributed: UnattributedId[]
   /**
@@ -1386,6 +1393,79 @@ export interface ProfileReport {
   wastedReReruns: WastedReRunsResult
   batchAdvisor: BatchAdvisorResult
   coverage: ProfileCoverage
+  /**
+   * Normalized run status an agent can branch on without parsing prose (#1841):
+   * `ok` when nothing is flagged, `warning` when any finding is severity
+   * `warning` or higher — regardless of its `actionable` flag, since an
+   * unresolved-but-real cost (e.g. a hot subscriber with no source loc) is still
+   * worth surfacing. A failed *gate* escalates this to `error` — but gates are
+   * policy applied by the CLI from flags, so the builder only ever sets
+   * `ok`/`warning` here.
+   */
+  status: ProfileStatus
+  /**
+   * Flattened, normalized findings (#1841): the hot/wasted/batch/coverage tables
+   * re-expressed with a single `severity` scale, an explicit `actionable` flag,
+   * and `nextCommands` — the exact follow-up `bf debug …` invocations to run.
+   * The structured tables above stay the source of truth; this is the agent view.
+   */
+  findings: AgentFinding[]
+  /**
+   * Coverage guidance for an under-exercised run (#1841): present only when the
+   * scenario fired no or only some handlers, which usually means a story file is
+   * needed (handlers live in composed children).
+   */
+  guidance?: ScenarioGuidance
+}
+
+// -- Agent contract (#1841): normalized severity, actionable findings, guidance
+
+/** Normalized finding severity an agent can branch on without parsing prose. */
+export type ProfileSeverity = 'info' | 'warning' | 'error'
+
+/** Top-level run status: `ok` (clean), `warning` (findings), `error` (gate failed). */
+export type ProfileStatus = 'ok' | 'warning' | 'error'
+
+/**
+ * One normalized, machine-actionable finding flattened from the per-analysis
+ * tables (hot subscribers / wasted re-runs / batch advisor / coverage gaps).
+ * Carries the agent contract fields the issue asks for: a normalized `severity`,
+ * an explicit `actionable` flag (`false` ⇒ no safe direct fix — e.g. an
+ * unverified advisory), and `nextCommands` — valid, ready-to-run `bf debug …`
+ * follow-ups.
+ */
+export interface AgentFinding {
+  kind: 'hot-subscriber' | 'wasted-re-run' | 'batch-candidate' | 'coverage-gap'
+  severity: ProfileSeverity
+  /**
+   * Whether this finding has a concrete fix worth acting on directly. `false`
+   * marks a finding an agent should *not* apply blindly — an unverified `batch()`
+   * advisory (the wrap could change behavior) or a finding whose source location
+   * the id index couldn't resolve. A coverage gap is `actionable: true`: the next
+   * step (widen the scenario, inspect the graph) is clear even without a `loc`.
+   */
+  actionable: boolean
+  /** The compiler subscriber/turn id this finding is about, when it has one. */
+  subscriber?: string
+  /** Source location, when the id resolved to an IR node. */
+  loc?: { file: string; line: number }
+  /** One-line human summary — the same sentence the text report would print. */
+  message: string
+  /** Follow-up commands to run next — valid, ready-to-run `bf debug …` lines. */
+  nextCommands: string[]
+}
+
+/**
+ * Coverage guidance for an under-exercised run (#1841). `--scenario auto` can
+ * only fire handlers the IR exposes on *this* component; for a compound/context
+ * component whose handlers live in composed children it fires `0/N`, and the
+ * honest next step is a story/scenario file rather than trusting a thin run.
+ */
+export interface ScenarioGuidance {
+  /** Why coverage was incomplete — drives the suggested next step. */
+  reason: 'no-handlers' | 'no-interactions' | 'partial-coverage'
+  message: string
+  nextCommands: string[]
 }
 
 export interface ProfileReportInput {
@@ -1412,6 +1492,104 @@ export interface ProfileReportInput {
   wastedRatio?: number
 }
 
+/**
+ * The follow-up `bf debug …` commands an agent should run to investigate a
+ * subscriber finding (#1841). Every command is valid and ready to run: a
+ * memo/signal id resolves to a name `bf debug trace` accepts; a DOM-binding id
+ * resolves to a slotId `bf debug why-update` accepts; `bf debug graph` is always
+ * applicable, so it is the universal fallback.
+ *
+ * Commands target the component parsed *from the id* (`<Component>#…`), not the
+ * primary component — a scenario-file run resolves subscribers from composed
+ * children (`extraSources`), so a child's finding must point at the child. The
+ * passed `fallbackComponent` is used only for ids that don't parse (e.g. an
+ * anonymous `e1`).
+ */
+function nextCommandsForSubscriber(fallbackComponent: string, subscriber: string): string[] {
+  const cmds: string[] = []
+  const parsed = parseProfilerId(subscriber)
+  const component = parsed?.component ?? fallbackComponent
+  if (parsed) {
+    if (parsed.kind === 'memo' || parsed.kind === 'signal') {
+      cmds.push(`bf debug trace ${component} ${parsed.rest} --json`)
+    } else if (parsed.kind === 'binding') {
+      cmds.push(`bf debug why-update ${component} ${parsed.rest} --json`)
+    }
+  }
+  cmds.push(`bf debug graph ${component} --json`)
+  return cmds
+}
+
+/**
+ * Flatten the per-analysis tables into the normalized agent findings (#1841).
+ * Only *flagged* rows become findings — a hot subscriber that isn't `hot`, or a
+ * subscriber below the wasted threshold, is data in the tables but not something
+ * the agent must act on. Coverage gaps (unresolved ids) are actionable findings;
+ * the non-actionable bookkeeping ids stay in `coverage.diagnostics`.
+ */
+function buildAgentFindings(
+  component: string,
+  hotSubscribers: HotSubscribersResult,
+  wastedReReruns: WastedReRunsResult,
+  batchAdvisor: BatchAdvisorResult,
+  unattributed: readonly UnattributedId[],
+): AgentFinding[] {
+  const findings: AgentFinding[] = []
+  for (const s of hotSubscribers.subscribers) {
+    if (!s.hot) continue
+    findings.push({
+      kind: 'hot-subscriber',
+      severity: 'warning',
+      actionable: s.loc !== undefined,
+      subscriber: s.subscriber,
+      loc: s.loc,
+      message: `${s.name ?? s.subscriber} ran ${s.runsPerTurn.toFixed(1)}×/turn — re-run pressure (split or batch).`,
+      nextCommands: nextCommandsForSubscriber(component, s.subscriber),
+    })
+  }
+  for (const s of wastedReReruns.subscribers) {
+    if (!s.wasted) continue
+    findings.push({
+      kind: 'wasted-re-run',
+      severity: 'warning',
+      actionable: s.loc !== undefined,
+      subscriber: s.subscriber,
+      loc: s.loc,
+      message: `${s.name ?? s.subscriber} produced identical output in ${Math.round(s.wastedRatio * 100)}% of runs — finer split.`,
+      nextCommands: nextCommandsForSubscriber(component, s.subscriber),
+    })
+  }
+  for (const c of batchAdvisor.candidates) {
+    findings.push({
+      kind: 'batch-candidate',
+      // Only a *proven-safe* batch is advised as actionable warning; an
+      // unverified one is surfaced as info so an agent doesn't apply a wrap that
+      // could change behavior (mirrors the batch advisor's own safety gate).
+      severity: c.safety === 'safe' ? 'warning' : 'info',
+      actionable: c.safety === 'safe' && c.loc !== undefined,
+      subscriber: c.turn,
+      loc: c.loc,
+      message: `${c.handler ?? c.turn} re-ran shared effects ${c.savings}× extra across ${c.writes} writes — batch() candidate (${c.safety}).`,
+      // The turn id is `<Component>#handler:…` — for a scenario-file run it can be
+      // a composed child, so route through the helper to target the right one.
+      nextCommands: nextCommandsForSubscriber(component, c.turn),
+    })
+  }
+  for (const u of unattributed) {
+    findings.push({
+      kind: 'coverage-gap',
+      severity: 'warning',
+      actionable: true,
+      subscriber: u.id,
+      message: `Unresolved subscriber id "${u.id}" — could not map to source (scope caveat).`,
+      // `u.id` is shaped `<Component>#…` and may name a composed child — route
+      // through the helper so the command targets that component, not the root.
+      nextCommands: nextCommandsForSubscriber(component, u.id),
+    })
+  }
+  return findings
+}
+
 /**
  * Assemble a dynamic profile (SR1–SR4 + analyses, SR7) from a recorded event
  * stream. Pure: the DOM run that *produces* `events` lives in the driver (the
@@ -1524,6 +1702,41 @@ export function buildProfileReport(input: ProfileReportInput): ProfileReport {
     }
   }
 
+  const findings = buildAgentFindings(primary.componentName, hotSubscribers, wastedReReruns, batchAdvisor, unattributed)
+  // Status is measurement-only here: any warning/error finding ⇒ `warning`. A
+  // failed gate escalates to `error`, but gates are CLI policy (flags), so the
+  // builder never sets `error` itself.
+  const status: ProfileStatus = findings.some(f => f.severity === 'warning' || f.severity === 'error') ? 'warning' : 'ok'
+
+  // Coverage ratio: 1 when there is nothing to cover (no handlers), else the
+  // exercised fraction. Clamped to `[0,1]` — a malformed stream (more distinct
+  // turn ids than `buildEventSummary` knows about, e.g. missing `extraSources`)
+  // must not push the ratio past 1 and break a gate's assumptions. Drives
+  // `--min-coverage` and the guidance below.
+  const ratio = handlersTotal > 0 ? Math.min(1, handlerIds.size / handlersTotal) : 1
+  let guidance: ScenarioGuidance | undefined
+  if (turnSeqs.size === 0) {
+    guidance =
+      handlersTotal === 0
+        ? {
+            reason: 'no-handlers',
+            message: 'No event handlers — use the static budget instead of a dynamic run.',
+            nextCommands: [`bf debug profile ${primary.componentName} --json`],
+          }
+        : {
+            reason: 'no-interactions',
+            message:
+              'Handlers exist but none fired — they likely live in composed children. Drive the component with a story/scenario file.',
+            nextCommands: [`bf debug profile ${primary.componentName} --scenario <story.tsx> --json`],
+          }
+  } else if (ratio < 1) {
+    guidance = {
+      reason: 'partial-coverage',
+      message: `Only ${handlerIds.size}/${handlersTotal} handlers exercised — a story/scenario file can cover the rest.`,
+      nextCommands: [`bf debug profile ${primary.componentName} --scenario <story.tsx> --json`],
+    }
+  }
+
   return {
     kind: 'profile',
     schemaVersion: PROFILE_SCHEMA_VERSION,
@@ -1538,12 +1751,16 @@ export function buildProfileReport(input: ProfileReportInput): ProfileReport {
     coverage: {
       handlersFired: handlerIds.size,
       handlersTotal,
+      ratio,
       unattributed,
       // Roll the (potentially hundreds of) bookkeeping ids up to a count + a
       // small sample so JSON consumers aren't flooded (#1849 B7). `diagnostics`
       // is already sorted hottest-first by `joinProfilerEvents`.
       diagnostics: { count: diagnostics.length, sample: diagnostics.slice(0, 3).map(d => d.id) },
     },
+    status,
+    findings,
+    ...(guidance ? { guidance } : {}),
   }
 }
 
@@ -1579,5 +1796,116 @@ export function formatProfileReport(r: ProfileReport): string {
   if (c.diagnostics.count > 0) {
     lines.push(`  · ${c.diagnostics.count} anonymous runtime id(s) (non-actionable bookkeeping)`)
   }
+  // Agent contract footer (#1841): a normalized status and the single most
+  // useful next command, so a human reading the text output sees the same
+  // signal `--json` consumers branch on.
+  lines.push('')
+  lines.push(`status: ${r.status} (${r.findings.length} finding(s))`)
+  if (r.guidance) {
+    lines.push(`  guidance: ${r.guidance.message}`)
+    lines.push(`  next: ${r.guidance.nextCommands[0]}`)
+  } else if (r.findings.length > 0) {
+    lines.push(`  next: ${r.findings[0].nextCommands[0]}`)
+  }
   return lines.join('\n')
 }
+
+// -- Gates (#1841): turn a measured report into a pass/fail CI decision --------
+
+/** The gate names `--fail-on` accepts. `regression` applies to `--diff` mode. */
+export type GateName = 'unresolved' | 'hot' | 'coverage' | 'regression'
+
+/**
+ * Gate thresholds an agent/CI supplies via flags. A gate is *active* when it is
+ * named in `failOn` or its numeric threshold is set — so `--max-unresolved 0`
+ * enforces the unresolved gate without also passing `--fail-on unresolved`.
+ */
+export interface GateConfig {
+  failOn?: readonly GateName[]
+  /** `--min-coverage`: minimum `coverage.ratio` in `[0,1]`. */
+  minCoverage?: number
+  /** `--max-runs-per-turn`: budget for the hottest subscriber's runs/turn. */
+  maxRunsPerTurn?: number
+  /** `--max-unresolved`: maximum allowed unresolved (actionable) coverage gaps. */
+  maxUnresolved?: number
+}
+
+export interface GateCheck {
+  gate: GateName
+  passed: boolean
+  /** The measured value the gate compared (ratio, count, or runs/turn). */
+  observed: number
+  /** The threshold it was compared against; `null` for a boolean gate. */
+  threshold: number | null
+  message: string
+}
+
+export interface GateResult {
+  passed: boolean
+  /** Names of the gates that failed — the `gates.failed` an agent branches on. */
+  failed: GateName[]
+  checks: GateCheck[]
+}
+
+/**
+ * Evaluate the dynamic-run gates (#1841) against a measured report. Pure: maps a
+ * `ProfileReport` + thresholds to a pass/fail decision the CLI turns into an
+ * exit code. The `regression` gate is *not* evaluated here — it belongs to
+ * `--diff` mode, which the CLI gates directly off the `BudgetDiff`.
+ */
+export function evaluateProfileGates(report: ProfileReport, config: GateConfig): GateResult {
+  const failOn = new Set(config.failOn ?? [])
+  const checks: GateCheck[] = []
+
+  if (failOn.has('coverage') || config.minCoverage !== undefined) {
+    const threshold = config.minCoverage ?? 1
+    const observed = report.coverage.ratio
+    checks.push({
+      gate: 'coverage',
+      passed: observed >= threshold,
+      observed,
+      threshold,
+      message: `coverage ${(observed * 100).toFixed(0)}% ${observed >= threshold ? '≥' : '<'} required ${(threshold * 100).toFixed(0)}%`,
+    })
+  }
+
+  if (failOn.has('unresolved') || config.maxUnresolved !== undefined) {
+    const threshold = config.maxUnresolved ?? 0
+    const observed = report.coverage.unattributed.length
+    checks.push({
+      gate: 'unresolved',
+      passed: observed <= threshold,
+      observed,
+      threshold,
+      message: `${observed} unresolved id(s) ${observed <= threshold ? '≤' : '>'} allowed ${threshold}`,
+    })
+  }
+
+  if (failOn.has('hot') || config.maxRunsPerTurn !== undefined) {
+    const observed = report.hotSubscribers.subscribers.reduce((m, s) => Math.max(m, s.runsPerTurn), 0)
+    if (config.maxRunsPerTurn !== undefined) {
+      // Numeric budget: the hottest subscriber must not exceed it.
+      const threshold = config.maxRunsPerTurn
+      checks.push({
+        gate: 'hot',
+        passed: observed <= threshold,
+        observed,
+        threshold,
+        message: `max ${observed.toFixed(1)} runs/turn ${observed <= threshold ? '≤' : '>'} budget ${threshold}`,
+      })
+    } else {
+      // Bare `--fail-on hot`: any subscriber the analysis flagged `hot` fails it.
+      const anyHot = report.hotSubscribers.subscribers.some(s => s.hot)
+      checks.push({
+        gate: 'hot',
+        passed: !anyHot,
+        observed,
+        threshold: null,
+        message: anyHot ? `hot subscriber(s) present (max ${observed.toFixed(1)} runs/turn)` : 'no hot subscribers',
+      })
+    }
+  }
+
+  const failed = checks.filter(c => !c.passed).map(c => c.gate)
+  return { passed: failed.length === 0, failed, checks }
+}