Skip to content

Add OpsHistory local-first contract hardening#88

Merged
mdheller merged 3 commits intomainfrom
ops-history-spec-hardening
May 7, 2026
Merged

Add OpsHistory local-first contract hardening#88
mdheller merged 3 commits intomainfrom
ops-history-spec-hardening

Conversation

@mdheller
Copy link
Copy Markdown
Contributor

@mdheller mdheller commented May 5, 2026

Summary

Adds the first branch-based hardening pass for the OpsHistory / BearHistory / local-first service contract family.

This PR builds on the initial OpsHistory contract seed by adding:

  • docs/contract-additions/ops-history-catalog.md
  • semantic/ops-history-vocabulary.jsonld
  • .github/workflows/validate-ops-history.yml

The existing contract seed already includes:

  • schemas/OpsHistoryEvent.json
  • schemas/OpsHistorySyncPolicy.json
  • schemas/LocalFirstServiceManifest.json
  • schemas/BearHistoryEvent.json
  • schemas/BearHistorySyncPolicy.json
  • schemas/ShellReceiptEvent.json
  • schemas/OpsHistoryContextPackRef.json
  • schemas/RedactionTombstone.json
  • canonical examples for the above
  • tools/validate_ops_history_examples.py
  • Makefile validation wiring
  • asyncapi.ops-history.patch.yaml
  • docs/contract-additions/ops-history.md

Why

OpsHistory is the shared local-first operational event fabric for governed multi-chat human/agent operations. The contract family captures:

  • topology-aware local-first sync policy;
  • local service activation and named endpoint posture;
  • BearBrowser profile-separated event export;
  • operational receipt metadata;
  • bounded context-pack references;
  • redaction/tombstone invalidation;
  • Policy Fabric and Agent Registry gate requirements.

Validation

Expected validation command:

make validate-ops-history-examples
make validate

This PR also adds a dedicated GitHub Actions workflow for OpsHistory validation.

Notes

The changelog still needs a small entry. A full-file changelog update was blocked by the tool filter during automation, so I am leaving that as follow-up rather than risking a bad large replacement.

Non-goals

  • No live sync implementation.
  • No browser data export implementation.
  • No terminal capture implementation.
  • No agent memory hydration implementation.

This is contract hardening only.

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