Skip to content

Commit 5d0d8d7

Browse files
authored
docs(contracts): 明确 Job 停止与可信记录读取边界 (#25)
1 parent 528d735 commit 5d0d8d7

2 files changed

Lines changed: 13 additions & 0 deletions

File tree

20-product-tdd/knowledge-capability-contract.md

Lines changed: 8 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -173,6 +173,14 @@ external API uses one of those words.
173173
capability-handler, eligibility, atomic-claim, execution, and closure path. A Job has no
174174
retry or business-specific completeness semantics; timeout is a per-attempt execution
175175
budget, while partial progress and checkpointing remain owned by the invoked capability.
176+
- Job admission only confirms persistence; the admitting Peer need not be an eligible executor.
177+
`abort_requested` records best-effort stop intent. Pending work may close as aborted immediately;
178+
running work stays running until its executor has exited and released its resources. Repeated
179+
requests do not rewrite terminal outcomes. Stopping never promises rollback, retry, or reversal
180+
of already dispatched external work. Each executor observes stop intent for its own active work.
181+
- An observer's wait budget is separate from the Job execution budget. Ending observation does not
182+
request cancellation. A final observed record is evidence of that observation, not a claim that
183+
the database has remained unchanged since it was read.
176184
- A Cron is global command-creation policy, not a hidden execution path or a Source-owned
177185
schedule. A due occurrence is materialized under database serialization with one
178186
`scheduled_for` identity and at most one outstanding Job. Missed occurrences remain missed;

20-product-tdd/system-state-and-authority.md

Lines changed: 5 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -17,6 +17,11 @@ Record durable ownership of authoritative state across units and distinguish it
1717
authority, not request-path or product-tier authority over other peers.
1818
- Production rows are operational recovery data and must never be reproduced as development
1919
seed.
20+
- Input validation belongs at the accepting boundary. A normal record read does not reapply
21+
business input validation or require the corresponding runtime schema to be loaded. An execution
22+
path may restore persisted representations into its language's types; it need not repeatedly
23+
revalidate values already restored by that owner. Runtime capability checks remain separate
24+
from the authority of saved records.
2025

2126
## Extension Installation Authority
2227

0 commit comments

Comments
 (0)