[wan9chi]

Motivation

The run plan that vp run --dry-run --json will print (#966) uses the same task IDs, paths, version and $schema copy as vp run --json. Moving that code out of the task graph module first keeps the JSON PR about the new document.

Changes

Code moves into session/json/, with no behaviour change; schemas/task-graph.json and every snapshot are unchanged:

• from task_graph_json/document.rs: task_id, encode_id_part and Version;
• from its mod.rs: path_key;
• from its schema.rs: file_url and the schema materialization, which now takes the artifact as an argument.

Version takes its number as a const parameter, Version<1> for the task graph, since each document has its own format version: a breaking change to one bumps only its own. The output and schema don't change.

The task graph uses the moved code.

🤖 Generated with Claude Code

---

Note

Low Risk
Pure refactor with tests moved alongside; task graph JSON output and schemas are unchanged per the PR intent.

Overview
Introduces a shared session/json module so multiple vp run JSON outputs can reuse the same task IDs, workspace-relative paths, format version, and $schema materialization logic instead of duplicating it in the task graph code.

The task graph JSON path is rewired to import those helpers: Version becomes a generic Version<N> (still Version<1> for the task graph), and task-graph-specific schema wiring now passes its Artifact into the shared schema_url / materialize helpers. No intended output or schema change—this is structural prep for additional JSON documents (e.g. dry-run run plan).

^{Reviewed by Cursor Bugbot for commit e75ba86. Bugbot is set up for automated code reviews on this repo. Configure here.}

[github-actions]

fspy benchmark

linux

dynamic/launch             change  +1.22%  [ -4.91% ..  +8.11%]  overhead   +60.27%
dynamic/access             change  +2.00%  [-16.30% .. +22.13%]  overhead   +26.56%
dynamic/access-relative    change  +0.00%  [ -5.71% ..  +6.52%]  overhead   +60.57%
dynamic/access-contended   change  -1.32%  [ -9.20% ..  +8.46%]  overhead   +11.07%
static/launch              change  -0.40%  [ -6.09% ..  +5.03%]  overhead  +201.50%
static/access              change  +0.58%  [-10.95% .. +11.65%]  overhead +1340.54%
static/access-relative     change  +0.00%  [ -3.10% ..  +4.58%]  overhead +1998.10%
static/access-contended    change  -0.55%  [ -7.10% ..  +0.99%]  overhead +1735.44%

macos

dynamic/launch             change  +0.33%  [ -2.15% ..  +3.29%]  overhead  +232.46%
dynamic/access             change  -0.01%  [ -3.21% ..  +2.54%]  overhead    +5.51%
dynamic/access-relative    change  +0.43%  [ -3.32% ..  +2.92%]  overhead  +266.79%
dynamic/access-contended   change  -0.29%  [ -2.79% ..  +2.00%]  overhead    +3.51%

windows

dynamic/launch             change  +0.26%  [ -1.57% ..  +1.68%]  overhead   +30.17%
dynamic/access             change  +0.00%  [ -0.42% ..  +0.42%]  overhead    +1.29%
dynamic/access-relative    change  +0.00%  [ -0.61% ..  +0.61%]  overhead    +1.25%
dynamic/access-contended   change  +0.00%  [ -0.78% ..  +0.61%]  overhead    +1.41%