Commands (v2)

Investigation, diagnosis, and console parity — primary surface for AI agents after v1 platform commands.

Command	Synopsis
record	Query recorded data, traces, logs
trace	Find traces by business attributes
replay-case	List cases, metadata, failed items
replay-diff	Diff detail, compare, replay logs
workspace	Filesystem cases and interfaces
extraction-rule	Business attribute extraction rules
group	User groups and app grants
config-legacy	Legacy /api/config/* CRUD (deprecated)
system	System config and scheduled tasks
ops	Storage/schedule diagnostics

All v2 commands support --json, --out-dir, --page, --limit unless noted.

Agent diagnosis pipeline

sp app list
  → sp replay list / sp app replays
  → sp replay case list --plan <id> --failed
  → sp replay diff get <diffId> --out-dir .sp-work
  → (optional) sp record logs download --trace-id <id>

Or when user gives business ID:

sp trace find --app <id> --attr-name orderId --attr-value ORD-123
  → sp trace get <traceId>
  → sp record query --trace <traceId>

See examples.