Skip to content

docs(executive-loop): M21 Executive Operating Loop — Hermes-side contracts - #8

Merged
chadsm-sys merged 1 commit into
mainfrom
docs/executive-operating-loop-contracts
Jul 6, 2026
Merged

docs(executive-loop): M21 Executive Operating Loop — Hermes-side contracts#8
chadsm-sys merged 1 commit into
mainfrom
docs/executive-operating-loop-contracts

Conversation

@chadsm-sys

Copy link
Copy Markdown
Owner

What this is

The Hermes counterpart of mission-control-v0 PR #20 (M21: Executive Operating Loop). One new document — docs/executive-operating-loop-contract.md — recording the Mission Control ⇄ Hermes seams as contracts only. This document is the entire diff.

Seams specified

Seam Contract
Morning/Evening Packets MC packets are the producer side of the chief_of_staff MorningBrief/EveningReport consumer contracts (PR #5, interface-only). Schema major 1; all M21 fields additive at contract_version: 1.1; all-or-nothing parsing preserved.
Escalation ⇄ State Machine CONTINUE/PAUSE/NEEDS_CHAD map 1:1 onto MC's executive_state.py events; SafetyRisk ≥ HIGHESCALATE → a state with no CONTINUE row (safety is never waved through). UNKNOWN semantics aligned with degraded/contradicted.
Opportunity Scout → MC feeds the existing reserved EXTENSION_POINTS["opportunity-scout"] slot (POST /opportunities, allowed sources only, expert-witness rejected). Deterministic rankings on both sides; neither reranks the other.
Memory Graph → MC reserved evidence feed via MC's governed recorder with the already-allowlisted hermes-agent source; MC's knowledge-growth dimension stays UNKNOWN until wired.
Executive Coach the LEARNING conversation intent consumes the Morning Packet's learning_recommendation; EXECUTIVE_COACH.md doctrine satisfied by construction.

Hard rules honored

  • Docs-only: zero code changes, zero packaging changes (chief_of_staff stays out of the wheel), zero new dependencies (uv.lock untouched).
  • No runtime deployment / desktop install / Telegram / OAuth / gateway / LaunchAgent / DGX.
  • Preserves: evidence-first, UNKNOWN-remains-UNKNOWN, deterministic ranking, mutation boundaries (each side writes only its own store), attention economy, never-chase-autonomously, expert-witness isolation.
  • Leave OPEN — do not merge (M21 rule).

🤖 Generated with Claude Code

…racts

Counterpart to mission-control-v0 PR #20 (m21-executive-operating-loop).
Records the Mission Control <-> Hermes seams as contracts only:

* Morning/Evening Packet consumer mapping onto the chief_of_staff
  MorningBrief/EveningReport contracts (schema major 1; all M21 fields
  additive at 1.1; all-or-nothing parsing preserved).
* Escalation <-> Executive State Machine mapping (CONTINUE/PAUSE/
  NEEDS_CHAD -> events; SafetyRisk >= HIGH -> ESCALATE; safety is never
  waved through; UNKNOWN semantics aligned with degraded/contradicted).
* Opportunity Scout as the reserved MC inbox feed (existing
  EXTENSION_POINTS slot; deterministic both sides; no reranking;
  expert-witness rejection; engine never fetches).
* Memory Graph as a reserved evidence feed via MC's governed recorder
  (source hermes-agent already allowlisted; knowledge-growth stays
  UNKNOWN until wired).
* Executive Coach consumption through the LEARNING intent.
* Invariants: evidence or silence; determinism; mutation boundaries
  (each side writes only its own store); attention economy; never chase
  autonomously; expert-witness isolation.

No runtime coupling, no code changes, no packaging change, no new
dependencies — this document is the entire diff.

Co-Authored-By: Claude Fable 5 <noreply@anthropic.com>
@github-actions

github-actions Bot commented Jul 6, 2026

Copy link
Copy Markdown

🔎 Lint report: docs/executive-operating-loop-contracts vs origin/main

ruff

Total: 0 on HEAD, 0 on base (➖ 0)

🆕 New issues: none

✅ Fixed issues: none

Unchanged: 0 pre-existing issues carried over.

ty (type checker)

Total: 10608 on HEAD, 10608 on base (➖ 0)

🆕 New issues: none

✅ Fixed issues: none

Unchanged: 5554 pre-existing issues carried over.

Diagnostics are surfaced as warnings — this check never fails the build.

@chadsm-sys
chadsm-sys merged commit 93b565b into main Jul 6, 2026
35 checks passed
@chadsm-sys
chadsm-sys deleted the docs/executive-operating-loop-contracts branch July 6, 2026 09:35
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

1 participant