docs: propose service-owned work authority - #70
Conversation
|
🦞👀 Pull request received. I will update this pull request when review starts. ClawSweeper review completeClawSweeper finished reviewing this revision. The review result is being finalized. |
|
Codex review: blocked before merge. Reviewed September 11, 2026, 3:09 PM ET / 19:09 UTC (Revision 6). ClawSweeper reviewWhat this changesAdds a draft RFC, supporting specification, and diagrams proposing service-owned repository work with shared helper limits, cancellation, finite authority leases, and staged publication support. Merge readiness⛔ Blocked before merge - 3 items remain Keep open for RFC acceptance. The proposal adds distinct design work beyond the accepted Enterprise RFC, and the latest revision resolves the previously open initial-helper scope. No blocking patch defect was found. Priority: P3 Review scores
Verification
How this fits togetherThe proposed Work record sits between an authenticated request and Enterprise Agent execution. The OpenClaw Controller would bind repository operations to the original request, current permissions, cancellation, and recorded outcomes. flowchart LR
A[Authenticated request] --> B[Controller authorization]
B --> C[Durable root Work]
C --> D[Agent and subordinate helpers]
D --> E[Current authority check]
E --> F[Mediated repository operation]
F --> G[Durable outcome receipt]
Decision needed
Why: The revision now selects a concrete sequence, but accepting that architecture belongs to the repository's RFC decision process. Before merge
Agent review detailsSecurityNone. Review metricsNone. Merge-risk optionsMaintainer options:
Technical reviewBest possible solution: Adopt a clearly staged root Work contract that preserves existing authority boundaries and makes implementation qualification explicit before repository operations ship. Do we have a high-confidence way to reproduce the issue? Not applicable: this PR proposes an architecture rather than reporting an executable defect; its document rendering was inspected. Is this the best way to solve the issue? Yes, as a proposal: the root-first scope avoids requiring general durable orchestration for repository reads while preserving qualification requirements. Product acceptance remains a separate decision. AGENTS.md: not found in the target repository. Codex review notes: model internal, reasoning medium; reviewed against 967d9aac7472. LabelsLabel justifications:
EvidenceWhat I checked:
Likely related people:
Rating scale
Overall follows the weaker of proof and patch quality. Workflow
HistoryReview history (5 earlier review cycles)
|
What Problem This Solves
An Agent’s work can outlast a turn, coordinator process or provider token. Shared Agents need lasting scope and cancellation ownership while keeping requester, service-owner and workload permissions separate.
Why This Change Was Made
Define an initial root work record with requester attribution, immutable scope and any configured horizon, cancellation, execution assignment and effect receipts. Subordinate helpers share its scope, resource limits and stop ownership. This supports managed reads and subsequent approved publication without gating them on a complete public Work API. Separately admitted durable children, broader Work management and public lifecycle controls follow later, with preserved lineage and ancestor constraints.
User Impact
Execution defaults to uncapped under explicit admission policy; authority leases stay finite and renewal cannot extend configured limits, broaden scope or reopen terminal work. Every initial GitHub operation requires current online OCC authority. Durable receipts preserve original work and operation identity across replacement; unknown submission requires reconciliation without blind replay. MVP publication permits any configured, authorized human approver, including the requester, and excludes Agent approval.
This is a documentation proposal extending RFC 0027. It remains draft with a blank implementation issue pending acceptance.
Reading Guide
Evidence