sp record

Phase: v2
When agents use this: Inspect what was recorded for a trace; verify agent behavior via logs.

Synopsis

Read-only access to stored recordings (not agent write APIs).

Subcommands

Subcommand	Description
query	Query mocker/record payload by trace or replay id
trace <traceId>	Trace tree and children
completeness <traceId>	Full-link recording completeness
view	Visualization query/view
logs overview	Record-phase log summary
logs download	Download record logs to --out-dir

Examples

sp record query --trace-id abc --out-dir .sp-work --json
sp record trace abc --json
sp record completeness abc --json
sp record logs overview --trace-id abc --json
sp record logs download --trace-id abc --out-dir .sp-work --json

REST mapping

Subcommand	Method	Path
query	POST	/api/storage/record/query
trace	GET	/api/storage/record/trace/{traceId}
trace children	GET	/api/storage/record/trace/{traceId}/children
completeness	GET	/api/storage/record/completeness
view	POST	/api/storage/visualization/query
logs overview	GET	/api/record-logs/overview
logs download	GET	/api/record-logs/download

Replaces sp_api

sp_api	sp
record_data	sp record query
record_log_overview	sp record logs overview
download_record_logs	sp record logs download

Non-goals

• POST /api/storage/record/save, batchSave* — agent instrumentation only

Related

• trace
• replay-diff