Skip to main content

Operations

Documentation Map​

Operations

Purpose​

This repository is in admission-preparation mode for future fabric-all inclusion. The current operator path validates repo-side readiness only.

Targeted Checks​

  • python scripts/check_fabric_contracts.py
  • python scripts/export-fabric-metadata.py --pretty
  • python scripts/check_runtime_materialization.py
  • python scripts/verify_docs_inventory.py
  • python scripts/verify_event_modeling_wave5_safety_gate.py
  • python -m pytest -q

Readiness Rules​

  • primary capability class must remain compliance-governance
  • local bundle truth must not exist
  • local detection truth must not exist
  • no second truth family may be introduced
  • runtime admission must remain disabled until a later explicit slice

Monitoring Rules​

  • consume Fabric-authored combination truth read-only
  • if the canonical Fabric surface is unavailable, expose only:
    • unknown
    • degraded
    • optional last_known_truth
  • never infer active fabric-all membership locally

Non-HTTP Status Contract​

  • python scripts/export-fabric-metadata.py --pretty

This export is the repo-side machine-readable status contract for issue #1. It is not a runtime admission signal.

Runtime Materialization Drift​

jhf-selvage currently declares deployment.kind = admission-preparation-only.

That means live runtime materialization on <internal-runtime-redacted> must stay absent until a later explicit admission slice changes the contract.

Runtime drift rules:

  • no host runtime overrides are supported under ~/.config/helpifyr/runtime/jhf-selvage/
  • no active jhf-selvage compose materialization may appear on the host
  • no jhf-selvage containers or runtime networks may exist before explicit admission
  • no app readback surface may claim a live admitted runtime before explicit admission

Verify path:

  • repo-only: python scripts/check_runtime_materialization.py
  • live: python scripts/check_runtime_materialization.py --live-host <internal-runtime-redacted> --ssh-user administrator --pretty

AGPLv3 applies to this repository; see LICENSE and https://helpifyr.com for project context.