docs: record workflow contract manifest

This commit is contained in:
lda
2026-08-03 08:01:29 +07:00 Verified
parent fe3889c9b4
commit c52ad6998f
7 changed files with 36 additions and 154 deletions
+7
View File
@@ -737,6 +737,13 @@ stable.
## Recently Completed Platform Milestones
- Completed: the composed Python OpenRPC contract now has a checked,
transport-neutral manifest with a deterministic drift gate. Design:
[`workflow contract manifest design`](superpowers/specs/2026-08-01-workflow-contract-manifest-design.md).
Artifact: [`workflow-api.manifest.json`](../contracts/workflow-api.manifest.json).
Generated TypeScript operation names/raw types and a fail-closed
representative JSON Schema-to-Effect translator are the next contract-parity
slice; TypeScript parity is not complete.
- `WorkflowApiSurface` is the protocol-neutral workflow operation contract.
- `wf_transport_rpc_http` exposes local/static and MCP-backed `WorkflowServer`
over JSON-RPC HTTP.
+3
View File
@@ -28,6 +28,7 @@ For verified Python 3.14 dependency constraints and their removal criteria, see
| `wf_sources_mcp` | MCP-as-upstream-source implementation: ids, registry DTOs, auth/catalog stores, discovery, SDK client/facade, runtime pool, wrappers. | `wf_server`, broker glue, MCP source tests. |
| `wf_mcp` | MCP frontend/compatibility package: legacy `wf-mcp` entrypoints, broker glue, proxy/admin tools, and shims while extraction continues. | Compatibility callers and MCP transport work. |
| `wf_cli` | Command-line frontend over local or remote workflow APIs. | Humans, scripts, agent skills. |
| `wf_contract_manifest` | Tooling that normalizes the composed workflow OpenRPC document into the checked transport-neutral contract manifest and detects drift. | Contract generation, tests, and future TypeScript generators. |
| `@lda/presentation-sync` | Shared, bounded wire contract for ephemeral LAN presentation rooms. | Browser `@lda/console` and Hono `@lda/web-server`. |
The TypeScript presentation synchronization boundary is deliberately narrow.
@@ -65,6 +66,8 @@ can continue to reach a loopback-only workflow RPC server.
- `wf-mcp`: legacy/special-purpose MCP script from `pyproject.toml`.
- `wf-rpc-server`: preferred durable workflow server script for CLI/API clients,
implemented by `wf_server.cli`.
- `python -m wf_contract_manifest write|check`: regenerate or verify
`contracts/workflow-api.manifest.json` from the real composed workflow server.
- `wf_mcp.broker.WfMcpService.get_catalog()`: backend MCP catalog snapshots.
- `wf_mcp.broker.WfMcpService.get_planner_catalog()`: backend snapshots plus
broker-local workflow sources such as `wf.std` and `wf.mcp`.