degraded

Spec Workbench

Publish specification diffs, validation output, and implementation notes.

Demo handoff contract

Spec Workbench to OpenDocs

Spec can produce public-safe contract diffs and send them to OpenDocs for attribution and publication review.

Public routes
Read-only checks used by the demo. OpenDocs does not treat them as live unless a check is run.

Spec health

Read public health before showing spec validation status.

Spec OpenAPI

Read public API contract if exposed.

Boundary
Public dry-runs are allowed. Durable actions require PLATPHORM_API_KEY.

Public handoff actions

compare OpenAPIcompare MCP inventorycompare LLMS indexsend spec diff envelope

Protected actions

write canonical specapprove spec deltaexport private implementation report
Static example envelope
For docs and demo rehearsal only; it is not a stored or executed handoff.
{
  "schemaVersion": "platphorm.handoff.v1",
  "id": "handoff_spec_opendocs_demo",
  "from": "spec",
  "to": "docs",
  "capability": "compare OpenAPI",
  "intent": "Spec can produce public-safe contract diffs and send them to OpenDocs for attribution and publication review.",
  "transport": "openapi",
  "status": "preview_ready",
  "inputArtifactIds": [
    "https://spec.platphormnews.com/api/health",
    "/openapi.json",
    "/llms-index.json"
  ],
  "outputArtifactIds": [],
  "trace": {
    "traceId": "example-trace-id",
    "spanId": "example-span-id"
  },
  "links": {
    "receiver": "https://docs.platphormnews.com/api/docs/receive-handoff",
    "service": "https://spec.platphormnews.com"
  },
  "note": "Static example envelope for documentation and demos. It is not a stored or executed handoff."
}
Status and Actions
No protected connector credentials or durable import worker are configured in this checkout; public status and report schemas are available.
view public statuspreview import schemaprotected report publish
platphormctl
Repeatable operator evidence command.
platphormctl publish report <specRunId> --to docs