For AI agents: the complete documentation index is available at https://mfdoctor.kevinbeier.com/1.0.0/llms.txt, the full documentation bundle is available at https://mfdoctor.kevinbeier.com/1.0.0/llms-full.txt, and this page is available as Markdown at https://mfdoctor.kevinbeier.com/1.0.0/runtime-capture.md.
MFDoctor
  • English
  • 1.0.0

      • External runtime capture contract

      The runtime capture contract is an explicit handoff boundary for a future external capture tool. It is not a MFDoctor runtime agent.

      Capture must be invoked by a user with an approved target or export file. It must not run from check, a bundler adapter, application startup, or a client bundle. Capture reads existing public Observability or DevTools exports and strictly projected fallback evidence. It never injects plugins, calls runtime mutators, reads storage, or exports headers, bodies, cookies, source, props, factories, or raw stacks.

      The contract records source capabilities as exact, partial, unavailable, not-applicable, or unknown. Missing old/preview fields stay unknown. It also scopes every record by capture, navigation, realm, and sequence so equal trace IDs from separate realms do not merge.

      The default limits are 5 MiB, 100 reports, 5,000 events, 500 snapshots, 100 instances, 2,000 network records, 200 errors, 4 KiB strings, depth 12, and 100 object keys. The hard total ceiling is 25 MiB; truncation must be recorded.

      The contract and bounded file-only import are the first safe slice. Browser transport, safe snapshot projections, network/error fallback, and automatic capture remain separate stacked slices for issue #84. The bounded file-only import is now available through the existing offline runtime command:

      mfdoctor runtime ./capture.json

      The command accepts only contract version 1, rejects oversized or unsafe files before analysis, and keeps the existing runtime output shape. Browser and DevTools transport, snapshot probing, network/error fallback, and runtime mutation remain deferred.