Skip to main content

jhf-reed OSS Version Truth

Documentation Map​

jhf-reed OSS Version Truth

This document defines the canonical repo-owned entry points for OSS inventory and upgrade readiness in jhf-reed.

Canonical Files​

  • maintenance/oss-inventory.json
  • maintenance/oss-version-truth.json
  • maintenance/oss-upgrade-policy.json
  • maintenance/fabric-oss-upgrade-consumer.json

These files are machine-readable and must stay aligned with ownership boundaries:

  • repo-owned runtime/verifier surfaces are pinned and validated locally
  • external-owner lanes are referenced explicitly and never shadowed locally
  • Fabric-owned OSS upgrade truth is consumed read-only from canonical upstream contracts

Owner Boundary Rules​

  • jhf-reed owns only its repo-local OSS/runtime verifier truth.
  • helpifyr-fabric#289, jhf-openclaw-env#209, and jhf-deployment#270 remain external owner lanes.
  • No local workaround or shadow truth is allowed for those external lanes.
  • helpifyr-fabric is canonical source for OSS update/upgrade contracts and module identity/directory truth.

Fabric Consumer Surfaces​

jhf-reed consumes these upstream Fabric surfaces fail-closed:

  • contracts/platform/platform_version_truth.json
  • contracts/platform/platform_projection_catalog.json
  • contracts/platform/platform_oss_upgrade_governance_v1.json
  • contracts/platform/platform_oss_upgrade_compatibility_matrix_v1.json
  • contracts/platform/platform_oss_upgrade_evidence_contract_v1.json
  • contracts/platform/helpifyr_stack_module_identity_v1.json
  • contracts/platform/stack_tool_oss_inventory_directory.json
  • docs/contracts/HELPIFYR_PLATFORM_OSS_UPGRADE_GOVERNANCE.md
  • docs/contracts/HELPIFYR_STACK_MODULE_IDENTITY.md
  • docs/contracts/HELPIFYR_STACK_TOOL_OSS_INVENTORY_DIRECTORY.md

Verify Path​

  • python scripts/verify_reed_oss_inventory.py
  • powershell -File scripts/verify-reed-oss-inventory.ps1
  • python scripts/verify_fabric_oss_upgrade_consumer.py
  • python scripts/verify_reed_templates.py
  • powershell -File scripts/verify-reed-templates.ps1

Acceptance Posture​

  • no floating latest markers on repo-owned components
  • each component has explicit ownership (repo_owned or external_owner)
  • each external lane has explicit owner repo + issue reference
  • missing/unreadable/version-mismatched Fabric OSS consumer surfaces fail verification

License​

This document is part of an AGPLv3 repository. Helpifyr project information is available at https://helpifyr.com.