SyslogSolution/prose-contracts
7
0
Fork 0
Code Issues Pull Requests Actions Packages Projects Releases Wiki Activity

feat: add contract-registry.yaml — OpenProse enforcement index #16

Closed
mumuni-bot wants to merge 5 commits from feat/contract-registry into master
pull from: feat/contract-registry
merge into: :master
Conversation 0 Commits 5 Files Changed 3
+2379 -256
mumuni-bot commented 2026-07-13 19:51:06 +00:00
Owner
Copy Link
Copy Source

Summary

Adds the Contract Registry — a single YAML index mapping all 28 OpenProse contracts to their enforcement category, trigger mechanism, dependencies, postconditions, and escalation rules.

What is in this PR

  • contract-registry.yaml (1463 lines, 28 contracts)
  • Full schema with: category, sensitivity, trigger, execution protocol, verification, receipt format, escalation tiers, circuit breaker, DAG dependencies
  • All existing contracts catalogued and categorized

Categories

Category Count Contracts
Compliance 3 hermes-key-enforcement, hermes-config-template, hermes-agent-baseline
Monitoring 5 proxmox-monitor, gpu-monitor, infrastructure-monitoring, zulip-health, litellm-health
Remediation 4 litellm-self-heal, pm2-self-heal, disk-gc-threat-response, hermes-zulip-restore
Build/Deploy 3 hermes-zulip-plugin, build-zulip-plugin, stirling-pdf-agent-access
Maintenance 3 memory-audit-maintenance, gpu-fleet, infrastructure-update
Reference 7 infrastructure-control, ra-h-os-custodianship-contract, mumuni-delegation, zulip-approval-fix, zulip-oidc-redirect-fix, hello-world, +2 retired
Retired 2 zulip-mention-reliability, zulip-self-heal

MVP Targets

  1. Wire hermes-key-enforcement as first compliance contract with daily cron + verification
  2. Wire proxmox-monitor -> disk-gc-threat-response relay handoff for remediation
  3. Build circuit breaker logic (3 retries/hour -> trip -> escalate to FATAL)
  4. Create RA-H OS graph nodes for receipts
  5. Deploy cron jobs via Hermes cronjob tool

Related

  • Relay #707: OpenProse Contract Enforcement Process — Draft for Review

Checklist

  • CI validate (frontmatter)
  • CI lint (structure)
  • Abiba review (CRITICAL — affects all contracts)
## Summary Adds the Contract Registry — a single YAML index mapping all 28 OpenProse contracts to their enforcement category, trigger mechanism, dependencies, postconditions, and escalation rules. ## What is in this PR - **contract-registry.yaml** (1463 lines, 28 contracts) - Full schema with: category, sensitivity, trigger, execution protocol, verification, receipt format, escalation tiers, circuit breaker, DAG dependencies - All existing contracts catalogued and categorized ## Categories | Category | Count | Contracts | |----------|-------|-----------| | Compliance | 3 | hermes-key-enforcement, hermes-config-template, hermes-agent-baseline | | Monitoring | 5 | proxmox-monitor, gpu-monitor, infrastructure-monitoring, zulip-health, litellm-health | | Remediation | 4 | litellm-self-heal, pm2-self-heal, disk-gc-threat-response, hermes-zulip-restore | | Build/Deploy | 3 | hermes-zulip-plugin, build-zulip-plugin, stirling-pdf-agent-access | | Maintenance | 3 | memory-audit-maintenance, gpu-fleet, infrastructure-update | | Reference | 7 | infrastructure-control, ra-h-os-custodianship-contract, mumuni-delegation, zulip-approval-fix, zulip-oidc-redirect-fix, hello-world, +2 retired | | Retired | 2 | zulip-mention-reliability, zulip-self-heal | ## MVP Targets 1. Wire `hermes-key-enforcement` as first compliance contract with daily cron + verification 2. Wire `proxmox-monitor` -> `disk-gc-threat-response` relay handoff for remediation 3. Build circuit breaker logic (3 retries/hour -> trip -> escalate to FATAL) 4. Create RA-H OS graph nodes for receipts 5. Deploy cron jobs via Hermes cronjob tool ## Related - Relay #707: OpenProse Contract Enforcement Process — Draft for Review ## Checklist - [ ] CI validate (frontmatter) - [ ] CI lint (structure) - [ ] Abiba review (CRITICAL — affects all contracts)
mumuni-bot added 2 commits 2026-07-13 19:51:06 +00:00
chore: remove orphan pre-merge file 4dc29289bb
feat: add contract-registry.yaml — OpenProse enforcement index
PR Pipeline — Authorize → Validate → Review → Merge / auth (pull_request) Successful in 5s
Details
PR Pipeline — Authorize → Validate → Review → Merge / validate (pull_request) Successful in 2s
Details
PR Pipeline — Authorize → Validate → Review → Merge / lint (pull_request) Successful in 1s
Details
PR Pipeline — Authorize → Validate → Review → Merge / ai-review (pull_request) Successful in 1s
Details
PR Pipeline — Authorize → Validate → Review → Merge / gate (pull_request) Successful in 1s
Details
cca5a57265 
Maps all 28 prose contracts to enforcement categories (compliance, monitoring,
remediation, build/deploy, maintenance, reference). Each entry includes:
- Trigger mechanism (scheduled, event-driven, passive, on-demand)
- Execution protocol (agent, timeout, requires, SOP)
- Verification postconditions with commands
- Receipt format and storage
- Escalation tiers (info/warning/critical/fatal)
- Circuit breaker configuration
- Dependency resolution (DAG)
- Last run status tracking

MVP targets: hermes-key-enforcement (compliance) and proxmox-monitor
(monitored → disk-gc-threat-response remediation)

Related to relay #707: OpenProse Contract Enforcement Process — Draft for Review
mumuni-bot added 1 commit 2026-07-13 20:39:54 +00:00
fix: add multi-dimensional index to contract-registry.yaml
PR Pipeline — Authorize → Validate → Review → Merge / auth (pull_request) Successful in 1s
Details
PR Pipeline — Authorize → Validate → Review → Merge / validate (pull_request) Successful in 1s
Details
PR Pipeline — Authorize → Validate → Review → Merge / lint (pull_request) Successful in 1s
Details
PR Pipeline — Authorize → Validate → Review → Merge / ai-review (pull_request) Successful in 1s
Details
PR Pipeline — Authorize → Validate → Review → Merge / gate (pull_request) Successful in 0s
Details
8abbd6f001 
Adds index.by_domain with pm2-self-heal and disk-gc-threat-response in
infrastructure group. All 28 contracts now accounted for in every index
dimension: by_category, by_domain, by_owner, by_trigger, by_sensitivity.
mumuni-bot added 1 commit 2026-07-13 23:07:24 +00:00
fix: resolve registry issues — placeholders, missing postconditions, DAG/escalation/CB injection
PR Pipeline — Authorize → Validate → Review → Merge / auth (pull_request) Successful in 1s
Details
PR Pipeline — Authorize → Validate → Review → Merge / validate (pull_request) Failing after 2s
Details
PR Pipeline — Authorize → Validate → Review → Merge / lint (pull_request) Has been skipped
Details
PR Pipeline — Authorize → Validate → Review → Merge / ai-review (pull_request) Has been skipped
Details
PR Pipeline — Authorize → Validate → Review → Merge / gate (pull_request) Has been skipped
Details
484ea00597 
- Replaced <pve-api> placeholder with actual Proxmox API endpoint
- Replaced <service-endpoints> with actual service URLs in infrastructure-monitoring
- Replaced vague 'send test DM' with actual API call in zulip-health
- Added 3 postconditions to hermes-agent-baseline (was empty)
- Simplified verify commands in hermes-config-template and hermes-agent-baseline
- Updated provision-cron-jobs.py to match actual registry schema for:
  - Circuit breaker: max_retries, trip_action, window
  - Escalation: severity levels (info/warning/critical/fatal)
  - DAG: depends_on array

All 10 scheduled contracts now pass validation.
mumuni-bot added 1 commit 2026-07-14 02:06:02 +00:00
docs: add cron-prompts-review.md — all 10 generated prompts for review
PR Pipeline — Authorize → Validate → Review → Merge / auth (pull_request) Successful in 4s
Details
PR Pipeline — Authorize → Validate → Review → Merge / validate (pull_request) Successful in 1s
Details
PR Pipeline — Authorize → Validate → Review → Merge / lint (pull_request) Successful in 3s
Details
PR Pipeline — Authorize → Validate → Review → Merge / ai-review (pull_request) Successful in 2s
Details
PR Pipeline — Authorize → Validate → Review → Merge / gate (pull_request) Successful in 0s
Details
0e6efdb627
mumuni-bot closed this pull request 2026-07-16 21:21:57 +00:00

Pull request closed

Please reopen this pull request to perform a merge.
Sign in to join this conversation.
Reviewers
No Reviewers
Labels
No items
No labels
Milestone
No items
No Milestone
Projects
Clear projects
No projects
Assignees
Clear assignees
abiba-bot jerome (Jerome Kwame Tabiri) kagentz-bot kwame (Kwame Tabiri) mumuni-bot (Mumuni 🦅 (Syslog Falcon)) tanko-bot theo
No Assignees
1 Participants
Notifications
Due Date
No due date set.
Dependencies

No dependencies set.

Reference: SyslogSolution/prose-contracts#16