Runtime Docs Protocol

Config Pull

GET /runtime/config includes:

• docs.snapshotId
• docs.required[] with docType, targetFilename, version, artifactId, sha256, sizeBytes

Fetch Signed URLs

POST /runtime/docs/urls

Body:

• snapshotId
• optional artifactIds[]

Returns signed download URLs for required doc artifacts.

Apply Reports

POST /runtime/docs/report

phase values:

• started
• applied
• failed

Config ACK

POST /runtime/config accepts optional docsSnapshotId.

Returns 409 DOCS_SNAPSHOT_MISMATCH when stale.

USER.md Merge Rule

Runtime manages SOUL.md, TOOLS.md, and USER.md.

For dynamic context updates in USER.md:

• If reserved markers exist, replace only the reserved section.
• If markers do not exist, append a new marker section.