Skip to content

docs(har): document HAR truncation signal and default bump#584

Merged
mcfn merged 1 commit into
mainfrom
docs/har-truncation-signal
Apr 22, 2026
Merged

docs(har): document HAR truncation signal and default bump#584
mcfn merged 1 commit into
mainfrom
docs/har-truncation-signal

Conversation

@asensagent
Copy link
Copy Markdown
Contributor

Summary

Surfaces updated

  • skills/actionbook/references/command-reference.md--max-entries default, har stop return shape, truncation signal section
  • docs/api-reference/cli.mdx--max-entries default, Note block with truncation envelope details
  • docs/guides/browser.mdx--max-entries default, Tip on truncation detection
  • skills/actionbook/SKILL.md — new "HAR Recording" section with truncation guidance

Source of truth

  • packages/cli/src/browser/observation/network_har.rsDEFAULT_MAX_ENTRIES = 10000, execute_stop emits __truncated + __warnings
  • packages/cli/src/output.rs:31-48 — envelope bridge for meta.truncated / meta.warnings

Test plan

  • Verify command-reference.md truncation signal section renders correctly
  • Verify cli.mdx Note block renders in docs site
  • Verify browser.mdx Tip renders in docs site
  • Verify SKILL.md HAR Recording section parses correctly as skill context
  • Cross-check default (10000), warning message format, and field names against source of truth

Sync HAR truncation envelope behavior (ACT-970, PR #583) across all
four doc surfaces: command-reference.md, cli.mdx, browser.mdx, SKILL.md.
Documents --max-entries default bump (10000), meta.truncated,
meta.warnings HAR_TRUNCATED message, and data.max_entries field.
@mcfn mcfn merged commit e10cab4 into main Apr 22, 2026
6 checks passed
@mcfn mcfn deleted the docs/har-truncation-signal branch April 22, 2026 06:23
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

2 participants