rea/docs
Kaoru0822 6218d289e2
fix(browser): advertise zero-based units for runtime source coordinates (#1085)
* fix(browser): advertise zero-based units for runtime source coordinates

inspect_web_event_listeners and observe_web_execution return CDP
callsite, listener and resource_start line_number/column_number values
unchanged: zero-based lines and UTF-16 columns. Neither the advertised
output schema nor docs/web-runtime.md said so. trace_web_source_location
takes one-based lines, so a caller chaining a listener location into it
lands one line early.

Describe the units on the shared schema fields, which reach both tools'
advertised output schemas, and document the conversion.

Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>

* fix(browser): describe runtime positions relative to the enclosing resource

For an inline <script>, CDP reports listener and callsite positions
relative to the HTML document, and resource_start is where the script
text starts in that document. A real headless Chromium 155 page showed
this: a listener on HTML line 6 came back as line_number 5, with
resource_start {3, 8}. Describe all positions as relative to the
enclosing resource. Document that inline-script positions must have
resource_start subtracted, plus one added to the line, before
trace_web_source_location.

Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>

* docs(browser): clarify runtime-to-source coordinate conversion

---------

Co-authored-by: Claude Opus 5.5 <noreply@anthropic.com>
Co-authored-by: N0zoM1z0 <1705004398@qq.com>
2026-10-09 00:22:18 +08:00
..
.vitepress docs: simplify the English README and organize guides (#1043) 2026-10-08 11:44:00 +08:00
adr refactor(binary): move production composition outside application workflows (#965) 2026-10-07 21:56:58 +08:00
assets docs: add Discord community links to README 2026-10-05 17:36:29 +08:00
android-analysis.md docs: publish VitePress documentation on GitHub Pages 2026-10-07 16:58:04 +08:00
apple-application-analysis.md fix(artifacts): propagate conditional loads and bind digests to parsed images 2026-10-07 12:58:20 +00:00
architecture.mermaid feat(native): inspect recorded crashes through pwntools and pwndbg (#1054) 2026-10-08 16:50:31 +08:00
binary-diagnostics.md fix(build): make catalogs and packaged skills generated outputs (#1086) 2026-10-08 22:43:51 +08:00
browser-observation.md fix(browser): preserve authorized redirect hops (#986) 2026-10-08 01:08:31 +08:00
browser-scenario-contract.md feat(browser): capture correlated network content and lifecycle evidence (#797) 2026-10-07 04:35:49 +08:00
capability-migration.md refactor(artifacts): move inventory and extraction into provider owners (#1032) 2026-10-08 05:51:14 +08:00
cli.md docs: simplify the English README and organize guides (#1043) 2026-10-08 11:44:00 +08:00
electron-observation.md fix(tools)!: simplify direct invocation and harden boundary contracts (#555) 2026-10-05 20:16:44 +08:00
error-contract.schema.json feat(evm): inspect offline bytecode interfaces through EVMole (#1051) 2026-10-08 15:32:05 +08:00
evm-bytecode.md fix(build): make catalogs and packaged skills generated outputs (#1086) 2026-10-08 22:43:51 +08:00
firmware-analysis.md docs: publish VitePress documentation on GitHub Pages 2026-10-07 16:58:04 +08:00
ghidra-dos.md fix(ghidra): admit the 12.1 line and the install's JDK range (#840) 2026-10-07 12:24:36 +08:00
ghidra-nativeaot.md fix(ghidra): admit the 12.1 line and the install's JDK range (#840) 2026-10-07 12:24:36 +08:00
ida-provider.md feat(ida): add read-only GUI and headless MCP providers (#754) 2026-10-07 01:47:05 +08:00
index.md docs: publish VitePress documentation on GitHub Pages 2026-10-07 16:58:04 +08:00
installation.md fix(build): make catalogs and packaged skills generated outputs (#1086) 2026-10-08 22:43:51 +08:00
javascript-application-graph.md refactor!: simplify runtime tools and remove replay engines (#572) 2026-10-05 21:15:04 +08:00
javascript-application-workflows.md fix(javascript): keep mutated object initializer values unknown (#752) 2026-10-07 10:51:44 +08:00
javascript-artifact-reconstruction.md fix(javascript): preserve HTML carriage return source ranges (#1092) 2026-10-09 00:15:24 +08:00
javascript-recovery.md feat(javascript): recover readable modules with Wakaru (#848) 2026-10-07 12:46:13 +08:00
javascript-runtime-observation.md docs: clarify onboarding and align provider guidance (#745) 2026-10-06 22:57:36 +08:00
javascript-runtime-reconciliation.md fix(tools)!: simplify direct invocation and harden boundary contracts (#555) 2026-10-05 20:16:44 +08:00
managed-code-analysis.md fix(build): make catalogs and packaged skills generated outputs (#1086) 2026-10-08 22:43:51 +08:00
mcp-contracts.md fix(mcp): retain complete application results across response limits 2026-10-08 23:46:02 +08:00
mcp-prompts.md fix(target): explain the JavaScript directory analysis route (#733) 2026-10-06 19:53:08 +08:00
native-investigation.md chore: merge main into feat/dylib-resolution 2026-10-08 06:23:44 +00:00
process-capture.md fix(process): name the reason two captures cannot be compared (#1080) 2026-10-09 00:04:35 +08:00
provider-evaluation.md feat(ghidra): support native x86 PE applications on Windows (#1030) 2026-10-08 05:11:47 +08:00
reconstruction-obligation-ledgers.md refactor: return complete analysis results inline 2026-09-29 08:07:24 +08:00
reconstruction-readiness.md fix(tools)!: simplify direct invocation and harden boundary contracts (#555) 2026-10-05 20:16:44 +08:00
recorded-crashes.md feat(native): inspect recorded crashes through pwntools and pwndbg (#1054) 2026-10-08 16:50:31 +08:00
releasing.md fix(build): make catalogs and packaged skills generated outputs (#1086) 2026-10-08 22:43:51 +08:00
roadmap.md docs: simplify the English README and organize guides (#1043) 2026-10-08 11:44:00 +08:00
testing.md docs: clarify evidence ownership and verification guidance 2026-10-08 23:29:43 +08:00
tool-design.md docs: clarify evidence ownership and verification guidance 2026-10-08 23:29:43 +08:00
user-visible-errors.csv refactor(process): separate capture implementation from analyst workflows (#988) 2026-10-08 00:46:21 +08:00
web-network-captures.md fix(domain): preserve prototype-named JSON members through Evidence boundaries (#1049) 2026-10-08 21:32:48 +08:00
web-runtime.md fix(browser): advertise zero-based units for runtime source coordinates (#1085) 2026-10-09 00:22:18 +08:00
web-source-location.md feat(browser): trace captured website source-map locations (#897) 2026-10-07 16:21:18 +08:00
website-module-trace.md feat(browser): trace captured website module imports (#879) 2026-10-07 14:59:52 +08:00
website-script-export.md feat(web): export captured scripts for JavaScript application analysis (#801) 2026-10-07 05:24:32 +08:00
windows-ghidra-p0.md feat(ghidra): support native x86 PE applications on Windows (#1030) 2026-10-08 05:11:47 +08:00