Skip to main content

Dobby Overview

Documentation Map​

Dobby Overview

jhf-dobby is the Helpifyr adaptive-learning runtime. It turns governed runtime evidence into replay-backed recommendations, proposal records, and approval-aware adaptation flows.

What Dobby Solves​

  • keeps learning-state orchestration in one bounded service instead of scattered scripts
  • preserves provenance and replay evidence for each candidate change
  • consumes canonical governance truth from Fabric instead of inventing local contract or admission truth
  • forces approval and policy integrity through Warp before activation paths can proceed

What Exists Today​

  • FastAPI runtime with health, readiness, learning, promotion, and metrics surfaces
  • Postgres-backed run, replay, proposal, and metric persistence
  • replay evaluation with threshold contracts and bounded budget controls
  • evidence-to-proposal replay loops for agent-work improvements without direct truth mutation
  • proposal lifecycle with approval checks, activation, rollback, and fail-closed degradation
  • optional Shuttle evidence enrichment and Bobbin-marked provenance publication
  • low-pressure service and worker runtime guardrails for shared hosts
  • canonical docs platform v1.6 base family rooted at:
    • README.md
    • docs/OVERVIEW.md
    • docs/INSTALL.md
    • docs/CONFIGURATION.md
    • docs/OPERATIONS.md
    • docs/TROUBLESHOOTING.md
    • docs/RELEASE_NOTES.md
    • docs_manifest.yml

What Dobby Owns​

  • adaptive-learning orchestration
  • durable learning-state persistence
  • replay verdicts and proposal-state transitions
  • Dobby runtime health, readiness, and metrics

What Dobby Consumes​

  • Fabric governance and admission truth
  • Warp approval truth
  • Shuttle read-only evidence
  • Bobbin provenance sink semantics

What Dobby Does Not Own​

  • policy registry or admission ownership
  • ERP/CRM/procurement source-of-truth data
  • direct repo mutation or autonomous code editing
  • hidden black-box supplier or people scoring

License: AGPLv3. See ../LICENSE (LICENSE).
Learn more at helpifyr.com.

Where To Go Next​

  • Feature Registry (docs/MODULE_FEATURES.md)
  • API (docs/API.md)
  • Operations
  • Deployment And Verify (docs/DEPLOYMENT_VERIFY.md)
  • Contract Governance (docs/CONTRACT_GOVERNANCE.md)
  • Integrations (docs/INTEGRATIONS.md)

License: AGPLv3. See ../LICENSE (LICENSE).
Learn more at helpifyr.com.