docs: SeiNodeTask CRD operator reference (PLT-488)#404
Conversation
Adds docs/seinode-task.md — the operator/automation reference for SeiNodeTask: kinds + non-obvious behavior notes, lifecycle (deterministic task ID, terminal requirePhase timeout), conditions + reason enums, the 3-branch operator-key signing chain, chain-vs-controller idempotency, the status.outputs-unpopulated reality (overrides the godoc), GitOps patterns, reconciliation cadence + the fee-floor / value-encoding / voting-window gotchas, and a vote-fan-out example. Links it from the README and notes in CLAUDE.md that its headings are cited anchors for PLT-489. Design: bdchatham-designs designs/wave/seinode-task-crd-docs.md (Coral-signed-off). Co-Authored-By: Claude Opus 4.8 (1M context) <noreply@anthropic.com>
PR SummaryLow Risk Overview README links to the new doc under a SeiNodeTask subsection. CLAUDE.md requires keeping
Reviewed by Cursor Bugbot for commit 1a3b1a3. Bugbot is set up for automated code reviews on this repo. Configure here. |
- Add RestartSeid + MarkReady kinds (now wired in the enum) - timeoutSeconds measured from status.task.executionStartedAt; 0 = per-kind default (RestartSeid 10m / MarkReady 2m), not universally unbounded - TargetReady reasons are PhaseMet/PhaseNotMet only; Failed adds ParamsBuildFailed - ObservedGeneration IS set (setCondition harmonized) — drop the stale caveat - Signing: resolveSigningUID takes explicit keyName, else ResolveOperatorKeyringUID - Stabilize the status.outputs heading; trim a redundant trailing line
…Met) Comment-only: the controller no longer emits Resolving/ResolveTimeout; drop them from the ConditionSeiNodeTaskTargetReady godoc so it matches docs/seinode-task.md.
1 participant
Adds
docs/seinode-task.md, the operator/automation reference for theSeiNodeTaskCRD. Captures the operational knowledge that isn't derivable from the godoc/LLD — surfaced during the arctic-1 governance op (platform #995).Covers: kinds + non-obvious behavior notes; lifecycle (deterministic task ID = UUIDv5(UID,kind,0), terminal
requirePhasetimeout); conditions + reason enums; the 3-branch operator-key signing chain; chain-vs-controller idempotency; thestatus.outputs-unpopulated reality (overrides the misleading godoc); GitOps patterns; reconciliation cadence + the fee-floor / value-encoding / voting-window gotchas; a vote-fan-out example. README link + a CLAUDE.md note (its headings are cited anchors for the PLT-489 gov-ops skill).Design (Coral-signed-off by kubernetes-specialist, prose-steward, product-manager):
bdchatham-designs designs/wave/seinode-task-crd-docs.md.Closes PLT-488.
🤖 Generated with Claude Code