rrt/docs/shell-load-graph.md

Shell Load Graph

Generated shell-load startup graph artifacts live under artifacts/exports/rt3-1.06/:

• shell-load-subgraph.dot
• shell-load-subgraph.md
• setup-window-subgraph.dot
• setup-window-subgraph.md
• setup-window-submodes-depth5-subgraph.dot
• setup-window-submodes-depth5-subgraph.md
• setup-window-submodes-depth5-forward-subgraph.dot
• setup-window-submodes-depth5-forward-subgraph.md
• runtime-effect-service-depth7-subgraph.dot
• runtime-effect-service-depth7-subgraph.md
• runtime-effect-service-depth7-forward-subgraph.dot
• runtime-effect-service-depth7-forward-subgraph.md

The current graph is intentionally bounded rather than whole-program:

• seed nodes:
  • 0x00438890 shell_active_mode_run_profile_startup_and_load_dispatch
  • 0x00482ec0 shell_transition_mode
• traversal:
  • note-address references in function-map.csv
  • depth 2
  • backreferences enabled

This keeps the artifact useful for naming and branch comparison instead of exploding into generic utility helpers.

The paired Setup.win graph is a narrower owner-family export:

• seeds:
  • 0x00504010 shell_setup_window_construct
  • 0x005033d0 shell_setup_window_handle_message
  • 0x00502c00 shell_setup_window_select_launch_mode_and_apply_shell_state
  • 0x00502910 shell_setup_window_refresh_mode_dependent_lists
  • 0x00502550 shell_setup_window_refresh_selection_lists_and_summary_fields
  • 0x00502220 shell_setup_window_publish_selected_profile_labels_and_preview_surface

Regenerate it with:

python3 tools/py/export_function_subgraph.py \
  artifacts/exports/rt3-1.06/function-map.csv \
  artifacts/exports/rt3-1.06/shell-load-subgraph \
  --seed 0x00438890 \
  --seed 0x00482ec0 \
  --depth 2 \
  --include-backrefs \
  --title "Shell Load Startup Subgraph"

And for the narrower Setup.win graph:

python3 tools/py/export_function_subgraph.py \
  artifacts/exports/rt3-1.06/function-map.csv \
  artifacts/exports/rt3-1.06/setup-window-subgraph \
  --seed 0x00504010 \
  --seed 0x005033d0 \
  --seed 0x00502c00 \
  --seed 0x00502910 \
  --seed 0x00502550 \
  --seed 0x00502220 \
  --depth 2 \
  --include-backrefs \
  --title "Setup Window Dispatch Subgraph"

The current exporter is intentionally note-driven:

• nodes come from function-map.csv
• edges come from address references embedded in notes
• so it is best used as a bounded reasoning aid over already-curated rows, not as a substitute for raw disassembly or xref recovery

There is now also a deeper Setup.win submode export:

• the backref-enabled depth-5 variant is exploratory and broad
  • seeds: the same constructor, dispatcher, selector, and refresh owners
  • depth: 5
  • backrefs: enabled
  • current size: 369 nodes / 753 edges
• the forward-only depth-5 variant is the recommended artifact for submode work
  • seeds: the same constructor, dispatcher, selector, and refresh owners
  • depth: 5
  • backrefs: disabled
  • current size: 126 nodes / 246 edges

Generate the exploratory backref-enabled graph with:

python3 tools/py/export_function_subgraph.py \
  artifacts/exports/rt3-1.06/function-map.csv \
  artifacts/exports/rt3-1.06/setup-window-submodes-depth5-subgraph \
  --seed 0x00504010 \
  --seed 0x005033d0 \
  --seed 0x00502c00 \
  --seed 0x00502910 \
  --seed 0x005027b0 \
  --seed 0x00502550 \
  --seed 0x00502220 \
  --depth 5 \
  --include-backrefs \
  --title "Setup Window Submode Subgraph (Depth 5)"

Generate the narrower forward-only graph with:

python3 tools/py/export_function_subgraph.py \
  artifacts/exports/rt3-1.06/function-map.csv \
  artifacts/exports/rt3-1.06/setup-window-submodes-depth5-forward-subgraph \
  --seed 0x00504010 \
  --seed 0x005033d0 \
  --seed 0x00502c00 \
  --seed 0x00502910 \
  --seed 0x005027b0 \
  --seed 0x00502550 \
  --seed 0x00502220 \
  --depth 5 \
  --title "Setup Window Submode Subgraph (Depth 5, Forward Only)"

There is now also a deeper runtime-effect export around the scenario event collection service loop:

• the backref-enabled depth-7 variant is exploratory and broad
  • seeds:
    • 0x004323a0 scenario_runtime_effect_record_service_and_dispatch_linked_compact_effects
    • 0x00431b20 world_apply_compact_runtime_effect_record_to_resolved_targets
    • 0x00430b50 scenario_runtime_effect_record_build_followon_effect_from_compact_record_and_targets
    • 0x00432ea0 scenario_event_collection_allocate_runtime_effect_record_from_compact_payload
  • depth: 7
  • backrefs: enabled
  • current size: 525 nodes / 1235 edges
• the forward-only depth-7 variant is the recommended artifact for this branch
  • same seeds
  • depth: 7
  • backrefs: disabled
  • current size: 293 nodes / 752 edges

Generate the exploratory backref-enabled graph with:

python3 tools/py/export_function_subgraph.py \
  artifacts/exports/rt3-1.06/function-map.csv \
  artifacts/exports/rt3-1.06/runtime-effect-service-depth7-subgraph \
  --seed 0x004323a0 \
  --seed 0x00431b20 \
  --seed 0x00430b50 \
  --seed 0x00432ea0 \
  --depth 7 \
  --include-backrefs \
  --title "Scenario Runtime Effect Service Subgraph (Depth 7)"

Generate the narrower forward-only graph with:

python3 tools/py/export_function_subgraph.py \
  artifacts/exports/rt3-1.06/function-map.csv \
  artifacts/exports/rt3-1.06/runtime-effect-service-depth7-forward-subgraph \
  --seed 0x004323a0 \
  --seed 0x00431b20 \
  --seed 0x00430b50 \
  --seed 0x00432ea0 \
  --depth 7 \
  --title "Scenario Runtime Effect Service Subgraph (Depth 7, Forward Only)"

There is now also a narrower startup-kind-8 export for the ordinary bring-up lane:

• artifact:
  • artifacts/exports/rt3-1.06/runtime-effect-kind8-startup-subgraph.{dot,md}
• seeds:
  • 0x00444d92
  • 0x00432f40
  • 0x004323a0
  • 0x00431b20
  • 0x00433130
• depth:
  • 5
• current size:
  • 702 nodes / 2076 edges

Generate it with:

python3 tools/py/export_function_subgraph.py \
  artifacts/exports/rt3-1.06/function-map.csv \
  artifacts/exports/rt3-1.06/runtime-effect-kind8-startup-subgraph \
  --seed 0x00444d92 \
  --seed 0x00432f40 \
  --seed 0x004323a0 \
  --seed 0x00431b20 \
  --seed 0x00433130 \
  --depth 5 \
  --title "Startup Kind-8 Runtime Effect Subgraph"