Why: frontend and ui contracts.ts are generated from this file by make contracts; editing the generated copies directly gets reverted by the next codegen run (the Dev CI build step proves it regenerates). Evidence: GOWORK=off go test green; the shape matches the Go Usage fields added earlier. Impact: additive to the contract mirror. Refs: Agent-System-Core#2, Agent-System-Frontend#48