borgmcp-shared 1.2.0 → 2.0.1
This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
- package/dist/conformance/adapter.d.ts +0 -3
- package/dist/conformance/adapter.d.ts.map +1 -1
- package/dist/conformance/adapter.js +3 -26
- package/dist/conformance/adapter.js.map +1 -1
- package/dist/protocol/contract.d.ts +1 -1
- package/dist/protocol/contract.js +1 -1
- package/dist/protocol/coordination.d.ts +0 -9
- package/dist/protocol/coordination.d.ts.map +1 -1
- package/dist/protocol/coordination.js +1 -33
- package/dist/protocol/coordination.js.map +1 -1
- package/dist/protocol/types.d.ts +0 -9
- package/dist/protocol/types.d.ts.map +1 -1
- package/dist/protocol/version.d.ts +1 -1
- package/dist/protocol/version.js +1 -1
- package/dist/templates.d.ts.map +1 -1
- package/dist/templates.js +10 -3
- package/dist/templates.js.map +1 -1
- package/docs/compatibility.md +8 -3
- package/docs/releases/2.0.0.md +22 -0
- package/docs/releases/2.0.1.md +7 -0
- package/package.json +1 -1
- package/src/conformance/adapter.ts +7 -39
- package/src/conformance/index.ts +1 -1
- package/src/protocol/contract.ts +1 -1
- package/src/protocol/coordination.ts +2 -48
- package/src/protocol/types.ts +0 -11
- package/src/protocol/version.ts +2 -2
- package/src/templates.ts +10 -3
package/src/protocol/types.ts
CHANGED
|
@@ -146,23 +146,12 @@ export interface RosterResponse {
|
|
|
146
146
|
since?: string | null;
|
|
147
147
|
}
|
|
148
148
|
|
|
149
|
-
export interface ReadLogClaim {
|
|
150
|
-
log_entry_id: string;
|
|
151
|
-
claimant_drone_id: string;
|
|
152
|
-
claimant_label: string | null;
|
|
153
|
-
claimant_role: string | null;
|
|
154
|
-
claimed_at: string;
|
|
155
|
-
stale: boolean;
|
|
156
|
-
}
|
|
157
|
-
|
|
158
149
|
export interface ReadLogResponse {
|
|
159
150
|
entries: ActivityLogEntry[];
|
|
160
151
|
drones: Drone[];
|
|
161
152
|
roles: PublicRole[];
|
|
162
153
|
behind_by?: number;
|
|
163
154
|
has_more?: boolean;
|
|
164
|
-
/** Added with advisory claims; optional when reading older servers. */
|
|
165
|
-
claims?: ReadLogClaim[];
|
|
166
155
|
}
|
|
167
156
|
|
|
168
157
|
export interface RoutingEcho {
|
package/src/protocol/version.ts
CHANGED
|
@@ -1,4 +1,4 @@
|
|
|
1
|
-
/** Current Borg coordination protocol generation. Clean-slate
|
|
2
|
-
export const PROTOCOL_VERSION = '
|
|
1
|
+
/** Current Borg coordination protocol generation. Clean-slate v14. */
|
|
2
|
+
export const PROTOCOL_VERSION = '14' as const;
|
|
3
3
|
|
|
4
4
|
export type ProtocolVersion = typeof PROTOCOL_VERSION;
|
package/src/templates.ts
CHANGED
|
@@ -192,7 +192,7 @@ Receipt and liveness:
|
|
|
192
192
|
const OPERATOR_CONTROLLED_OWNERSHIP_DISCIPLINE = `
|
|
193
193
|
|
|
194
194
|
Ownership and liveness:
|
|
195
|
-
- Follow active work through concrete milestones from the dispatch and acceptance evidence,
|
|
195
|
+
- Follow active work through concrete milestones from the dispatch and acceptance evidence, including any bounded activation or supervision deadline.
|
|
196
196
|
- If silence or liveness evidence makes status uncertain, send one direct status request and report the evidence to the human.
|
|
197
197
|
- Silence, delay, stale or disconnected state, and missed milestones never authorize rerouting or reassignment.
|
|
198
198
|
- Coordinator, Queen, or Director rerouting or reassignment requires explicit human operator approval for the exact work item and recipient.`;
|
|
@@ -279,10 +279,17 @@ Scope contract:
|
|
|
279
279
|
|
|
280
280
|
Activation:
|
|
281
281
|
- Order named drones to start exact authorized work with START NOW, RESUME NOW, REVIEW NOW, or HOLD; name the exact item and first concrete action.
|
|
282
|
-
|
|
282
|
+
1. Active read-log polling is allowed only from dispatch until the first receipt signal: \`borg_ack\`, CLAIM, STARTING, or substantive PROGRESS.
|
|
283
|
+
2. Polling stops immediately when the first receipt signal arrives.
|
|
284
|
+
3. ACK and CLAIM are receipt only; \`borg_ack\` records receipt; STARTING or substantive PROGRESS proves activation.
|
|
285
|
+
4. After receipt, end the active turn. Ordinary later transitions arrive through inbox/Monitor wake-ups; a dormant deadline does not keep the current turn open.
|
|
286
|
+
5. If receipt arrives without activation, arm exactly one dormant two-minute activation-deadline wake. Activation replaces or clears it; deadline wakes never stack.
|
|
287
|
+
6. Once STARTING or substantive PROGRESS proves active work, arm or reset exactly one dormant supervision wake for 12-15 minutes after the latest substantive signal. This enforces the ten-minute progress expectation with bounded grace.
|
|
288
|
+
7. On that wake, drain unread activity once. If no substantive progress, blocker, review-ready, verdict, or completion signal arrived by the deadline, send one direct status request and use read-only liveness checks.
|
|
289
|
+
8. Clear the supervision wake when work is complete, held, blocked on a known policy, harness, approval, or permission condition, awaiting human authority, or otherwise inactive.
|
|
290
|
+
9. Do not use shell sleeps, stacked deadlines, repeated read-log polling, repeated reminders for the same miss, process manipulation, or unauthorized reassignment while delegated work is running.
|
|
283
291
|
- When receipt is uncertain, use \`borg_ack-status\` for the routed entry; it reports acknowledgements and claims without advancing unread cursors.
|
|
284
292
|
- Verify activation and progress against the concrete milestones from the dispatch and acceptance evidence.
|
|
285
|
-
- When a milestone is missing and status is uncertain, follow the ownership and liveness discipline. Do not interrupt slow local work merely to satisfy a reporting cadence.
|
|
286
293
|
- Require BLOCKED when safe work stops, naming the missing input while independent work continues.
|
|
287
294
|
- Waiting is valid when work is complete, blocked, under active review, or awaiting human authority. Never manufacture work to avoid idleness.
|
|
288
295
|
|