Skip to content
Open
Show file tree
Hide file tree
Changes from all commits
Commits
File filter

Filter by extension

Filter by extension


Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
3 changes: 3 additions & 0 deletions AGENTS.md
Original file line number Diff line number Diff line change
Expand Up @@ -105,6 +105,8 @@ Keep it short, stable, and helper-oriented. Deep runbooks belong in checked-in d
`tests/results/_agent/handoff/autonomous-governor-summary.json`.
- `node tools/npm/run-script.mjs priority:governor:portfolio` refreshes the cross-repo operating receipt at
`tests/results/_agent/handoff/autonomous-governor-portfolio-summary.json`.
- `node tools/npm/run-script.mjs priority:context:concentrate` refreshes the compact durable memory receipt at
`tests/results/_agent/handoff/sagan-context-concentrator.json`.
- `node tools/npm/run-script.mjs priority:continuity` refreshes the continuity receipts at
`tests/results/_agent/runtime/continuity-telemetry.json` and
`tests/results/_agent/handoff/continuity-summary.json`.
Expand All @@ -116,6 +118,7 @@ Keep it short, stable, and helper-oriented. Deep runbooks belong in checked-in d
- `tests/results/_agent/issue/no-standing-priority.json`
- `tests/results/_agent/handoff/autonomous-governor-summary.json`
- `tests/results/_agent/handoff/autonomous-governor-portfolio-summary.json`
- `tests/results/_agent/handoff/sagan-context-concentrator.json`
- `tests/results/_agent/handoff/continuity-summary.json`
- `tests/results/_agent/handoff/entrypoint-status.json`
- `tests/results/_agent/runtime/`
Expand Down
13 changes: 8 additions & 5 deletions AGENT_HANDOFF.txt
Original file line number Diff line number Diff line change
Expand Up @@ -9,8 +9,7 @@ Live repository state belongs in the machine-generated artifacts under
## First Actions

1. Run `pwsh -NoLogo -NoProfile -File tools/priority/bootstrap.ps1`.
2. Check `.agent_priority_cache.json` and
`tests/results/_agent/issue/router.json`.
2. Check `.agent_priority_cache.json` and `tests/results/_agent/issue/router.json`.
3. Run `pwsh -NoLogo -NoProfile -File tools/Print-AgentHandoff.ps1
-ApplyToggles -AutoTrim` when you need the current watcher/handoff snapshot.
4. When human disposition surfaces are in play, run
Expand All @@ -25,7 +24,9 @@ Live repository state belongs in the machine-generated artifacts under
`tests/results/_agent/handoff/autonomous-governor-summary.json` for the
current repo owner decision and
`tests/results/_agent/handoff/autonomous-governor-portfolio-summary.json`
for the cross-repo owner decision.
for the cross-repo owner decision, and
`tests/results/_agent/handoff/sagan-context-concentrator.json` for the compact
hot/warm durable memory view of subagent work and blockers.

## Live State Surfaces

Expand All @@ -43,6 +44,8 @@ Live repository state belongs in the machine-generated artifacts under
`node tools/npm/run-script.mjs priority:governor:summary`
- Governor portfolio:
`node tools/npm/run-script.mjs priority:governor:portfolio`
- Context concentrator:
`node tools/npm/run-script.mjs priority:context:concentrate`

## Current-State Artifacts

Expand All @@ -54,6 +57,7 @@ Live repository state belongs in the machine-generated artifacts under
- `tests/results/_agent/handoff/entrypoint-status.json`
- `tests/results/_agent/handoff/monitoring-mode.json`
- `tests/results/_agent/handoff/autonomous-governor-summary.json`
- `tests/results/_agent/handoff/sagan-context-concentrator.json`
- `tests/results/_agent/handoff/autonomous-governor-portfolio-summary.json`
- `tests/results/_agent/handoff/human-go-no-go-latest.json`
- `tests/results/_agent/handoff/*.json`
Expand All @@ -65,8 +69,7 @@ Live repository state belongs in the machine-generated artifacts under
- The project board is visibility only.
- Treat `queue-empty` as a valid idle state; do not invent a null issue context.
- Treat `queue-empty + safe-idle + pivot-ready` as an explicit monitoring state.
- Prefer sanitized repo helpers (`node tools/npm/run-script.mjs ...`) over raw
`npm`.
- Prefer sanitized repo helpers (`node tools/npm/run-script.mjs ...`) over raw `npm`.

## When Handoff Looks Wrong

Expand Down
3 changes: 3 additions & 0 deletions docs/DEVELOPER_GUIDE.md
Original file line number Diff line number Diff line change
Expand Up @@ -661,6 +661,9 @@ pwsh -File tools/Print-AgentHandoff.ps1 -ApplyToggles -AutoTrim
`node tools/npm/run-script.mjs priority:handoff`, which now prints the
entrypoint index alongside the standing-priority snapshot and other handoff
summaries.
- Refresh the compact hot/warm durable memory view directly with
`node tools/npm/run-script.mjs priority:context:concentrate`, which writes
`tests/results/_agent/handoff/sagan-context-concentrator.json`.
- The overall future-agent handoff contract is summarized in
[`docs/knowledgebase/Agent-Handoff-Surfaces.md`](./knowledgebase/Agent-Handoff-Surfaces.md).
- See [`WATCHER_TELEMETRY_DX.md`](./WATCHER_TELEMETRY_DX.md) for automation response expectations.
Expand Down
13 changes: 13 additions & 0 deletions docs/knowledgebase/Agent-Handoff-Surfaces.md
Original file line number Diff line number Diff line change
Expand Up @@ -25,6 +25,10 @@ entrypoint and machine-generated live state.
which is the top-level machine-readable rollup for the autonomous governor's
current mode, wake disposition, funding-quality posture, release-signing
readiness, and next owner.
- It refreshes `tests/results/_agent/handoff/sagan-context-concentrator.json`,
which is the machine-readable hot/warm memory concentrator for the current
standing issue, current owner decision, recent subagent episodes, and durable
blocker context.
- It refreshes
`tests/results/_agent/handoff/autonomous-governor-portfolio-summary.json`,
which is the cross-repo machine-readable rollup for compare, canonical
Expand All @@ -44,6 +48,9 @@ entrypoint and machine-generated live state.
- `node tools/npm/run-script.mjs priority:handoff`
imports the handoff bundle and prints the entrypoint index, standing-priority
snapshot, and other current summaries.
- `node tools/npm/run-script.mjs priority:context:concentrate`
rebuilds the compact context concentrator directly when you need the
synthesized hot/warm memory view without the full handoff bundle.
- `node tools/npm/run-script.mjs priority:handoff-tests`
exercises the contract lane used to keep these handoff surfaces from drifting.

Expand All @@ -59,6 +66,7 @@ entrypoint and machine-generated live state.
- `tests/results/_agent/handoff/entrypoint-status.json`
- `tests/results/_agent/handoff/monitoring-mode.json`
- `tests/results/_agent/handoff/autonomous-governor-summary.json`
- `tests/results/_agent/handoff/sagan-context-concentrator.json`
- `tests/results/_agent/handoff/autonomous-governor-portfolio-summary.json`
- `tests/results/_agent/handoff/downstream-repo-graph-truth.json`
- `tests/results/_agent/release/release-signing-readiness.json`
Expand All @@ -83,6 +91,9 @@ entrypoint and machine-generated live state.
event-driven monitoring mode.
- `tests/results/_agent/handoff/autonomous-governor-summary.json` is the
top-level operating summary for the autonomous governor.
- `tests/results/_agent/handoff/sagan-context-concentrator.json` is the compact
durable memory view that keeps subagent findings, hot blockers, and current
owner decisions close to the active handoff surface.
- `tests/results/_agent/handoff/autonomous-governor-portfolio-summary.json` is
the cross-repo operating summary for compare, canonical template, and proving
forks together.
Expand All @@ -100,6 +111,8 @@ entrypoint and machine-generated live state.
- funding-quality posture for the latest wake
- release-signing readiness, including explicit external blockers when workflow
signing material is absent
- concentrated subagent episode memory, including hot working set,
warm recent memory, archive count, and lower-bound blended spend
- cross-repo owner and next-owner decisions
- repo graph truth for producer lineage, canonical development, and consumer proving
- wake conditions that should reopen compare or template work
Expand Down
28 changes: 28 additions & 0 deletions docs/schemas/delivery-agent-runtime-state-v1.schema.json
Original file line number Diff line number Diff line change
Expand Up @@ -322,6 +322,34 @@
"requiresLocalCheckout": { "type": ["boolean", "null"] }
}
},
"executionTopology": {
"type": ["object", "null"],
"additionalProperties": true,
"properties": {
"status": { "type": ["string", "null"] },
"executionPlane": { "type": ["string", "null"] },
"providerId": { "type": ["string", "null"] },
"workerSlotId": { "type": ["string", "null"] },
"cellId": { "type": ["string", "null"] },
"laneId": { "type": ["string", "null"] },
"cellClass": { "type": ["string", "null"] },
"suiteClass": { "type": ["string", "null"] },
"planeBinding": { "type": ["string", "null"] },
"harnessKind": { "type": ["string", "null"] },
"harnessInstanceId": { "type": ["string", "null"] },
"executionCellLeaseId": { "type": ["string", "null"] },
"dockerLaneLeaseId": { "type": ["string", "null"] },
"premiumSaganMode": { "type": "boolean" },
"reciprocalLinkReady": { "type": "boolean" },
"operatorAuthorizationRef": { "type": ["string", "null"] },
"activeLogicalLaneCount": { "type": ["integer", "null"], "minimum": 0 },
"seededLogicalLaneCount": { "type": ["integer", "null"], "minimum": 0 },
"runtimeSurface": { "type": ["string", "null"] },
"processModelClass": { "type": ["string", "null"] },
"windowsOnly": { "type": "boolean" },
"requestedSimultaneous": { "type": "boolean" }
}
},
"providerDispatch": {
"type": ["object", "null"],
"additionalProperties": true,
Expand Down
Loading
Loading