sp replay diff & logs

Phase: v2
When agents use this: Deep dive on a failed case — diff bodies, compare JSON, replay-phase logs.

Subcommands

Subcommand	Description
diff get <diffId>	Base vs test messages (artifact)
compare	Full-link compare result
logs overview	Replay log summary
logs download	Download replay logs
mock-tree <replayId>	Mock tree for replay
noise query	Query noise rules
noise exclude	Exclude noise
realtime …	Real-time replay queue (see below)

Examples

sp replay diff get diff-abc --out-dir .sp-work --json
sp replay compare --trace-id t1 --replay-id r1 --out-dir .sp-work --json
sp replay logs overview --replay-id r1 --json
sp replay logs download --replay-id r1 --out-dir .sp-work --json
sp replay mock-tree replay-uuid --json

JSON output (diff get)

{
  "ok": true,
  "command": "replay diff get",
  "data": {
    "artifact": ".sp-work/diff-abc.json",
    "summary": {
      "diffId": "abc",
      "diffResultCode": 1,
      "categoryName": "ResponseBody"
    }
  }
}

Artifact contains decoded baseMsg and testMsg (JSON when parseable).

REST mapping

Subcommand	Method	Path
diff get	GET	/api/report/queryDiffMsgById/{id}
compare	POST	Schedule /api/compareCase + report APIs
logs overview	GET	/api/replay-logs/overview
logs download	GET	/api/replay-logs/download
mock-tree	GET	/api/storage/replay-mock-tree/{replayId}
noise query	GET	/api/queryNoise
noise exclude	POST	/api/excludeNoise

Real-time replay (v2)

Subcommand	Path
realtime create	POST /api/createRealTimePlan
realtime queue pause	GET /api/queue/control/pause
realtime queue resume	GET /api/queue/control/resume
realtime log query	POST /api/realtime/log/query

Replaces sp_api

sp_api	sp
diff_detail	sp replay diff get
compare_result	sp replay compare
replay_log_overview	sp replay logs overview
download_replay_logs	sp replay logs download

Related

• Output contract
• Diagnose replay failure