[process-manager PM-9] ProcessManagerContract v1: the 18-route table

[rickylabs]

Summary

The typed oRPC contract: exactly the normative 18-route table (E4/F-2) — describe · listProcesses · getProcess · status · health · getState · logs · followLogs · start · stop · restart · block · unblock · terminate · applyGraph · subscribeEvents · mintToken · revokeToken — with Zod schemas, spreading BASE_PLUGIN_CONTRACT_ROUTES, satisfies, no erasure cast.

Scope

• Archetype / area: packages/plugin-process-manager-core contracts/v1
• Part of Epic: NetScript Process Manager — bare-metal supervisor + admin console (pup/pm2 done right) #510
• Depends on: [process-manager PM-1] Process-graph contract v1 (ProcessGraphShape/ProcessSpecShape + state vocabulary + restart policies) #512 · Blocks: PM-10, PM-13, PM-25, PM-29

Design source

• research/design/d2-control-plane-contract.md §1.3 (normative) · plan.md §4 PM-9, E4

Acceptance criteria

• gate: exactly the 18 routes — no hidden routes minted; CLI-only verbs (reload, enable-service, disable-service) map in PM-26, never here
• gate: extends the base plugin contract seam (BASE_PLUGIN_CONTRACT_ROUTES spread + satisfies; only the 2 accepted casts)
• gate: lifecycle actions are accepted-style async (ActionResult {id, action, accepted, state, correlationId})
• gate: deno doc --lint clean on the full export map
• gate: scoped check/lint/fmt wrappers green (--ext ts,tsx)

Non-scope

• Handlers (PM-10); transport (PM-11); auth (PM-12).

Drift / Debt

• none