Skip to main content

Capabilities

Documentation Map​

Capabilities

Tool / Contract Summary​

This page lists the real jhf-dobby capabilities that exist in the repository today. It follows the Fabric-facing capability split requested for repo documentation:

  • stable external capabilities
  • stable internal capabilities
  • experimental or transitional capabilities
  • current gaps

Fabric remains the source of truth for capability class, admission posture, and contract-family ownership. This page documents Dobby's repo-local implementation view only.

Stable External Capabilities​

Capability Key​

dobby.runtime.health

  • Title: Health and version surfaces
  • Stability: Stable
  • Exposure: External HTTP
  • Primary API surface / command / artifact / file: GET /health, GET /version, GET /fabric-manifest.json

Details:

  • returns service liveness and version metadata
  • does not require Fabric or Postgres to be healthy
  • used as the lowest-cost live smoke path

Capability Key​

dobby.runtime.readiness

  • Title: Runtime readiness and drift reporting
  • Stability: Stable
  • Exposure: External HTTP
  • Primary API surface / command / artifact / file: GET /ready, GET /api/v1/learning/readiness

Details:

  • reports effective service mode, Fabric alignment, queue-depth view, and backpressure state
  • degrades to warmup if persistence is unavailable
  • consumes canonical Fabric truth through the Fabric integration layer

Capability Key​

dobby.learning.intake

  • Title: Deterministic learning signal intake
  • Stability: Stable
  • Exposure: External HTTP
  • Primary API surface / command / artifact / file: POST /api/v1/learning/signals/intake

Details:

  • accepts tenant-scoped traces and guardrail decisions
  • blocks cross-tenant, BLOCK, and security-critical input
  • deterministically samples neutral success traces
  • persists run records and learning-signal posture

Capability Key​

dobby.learning.replay-evaluation

  • Title: Replay-backed candidate evaluation
  • Stability: Stable
  • Exposure: External HTTP
  • Primary API surface / command / artifact / file: POST /api/v1/learning/replay/evaluate

Details:

  • evaluates candidate metrics against a threshold contract
  • enforces workload-similarity and veto-metric rules
  • blocks when replay budget is exhausted

Capability Key​

dobby.learning.promotion-lifecycle

  • Title: Proposal, approval, activation, and rollback lifecycle
  • Stability: Stable
  • Exposure: External HTTP
  • Primary API surface / command / artifact / file: POST /api/v1/learning/promotions/propose, POST /api/v1/learning/promotions/approve-check, POST /api/v1/learning/promotions/activate, POST /api/v1/learning/promotions/rollback

Details:

  • keeps proposal state and lineage inside Dobby persistence
  • consumes Warp approval truth instead of request-local approval claims
  • enforces human approval for medium/high/critical risk
  • enforces tenant-scoped promotion velocity breaker

Capability Key​

dobby.runtime.metrics

  • Title: Metrics and bounded degradation metrics
  • Stability: Stable
  • Exposure: External HTTP
  • Primary API surface / command / artifact / file: GET /metrics

Details:

  • exports counters and gauges from durable metric storage
  • returns bounded degraded output when persistence is unavailable
  • includes dobby_persistence_ready and dobby_metrics_degraded

Stable Internal Capabilities​

Capability Key​

dobby.fabric-consumer

  • Title: Canonical Fabric truth consumer
  • Stability: Stable
  • Exposure: Internal runtime
  • Primary API surface / command / artifact / file: src/jhf_dobby/fabric/service.py (src/jhf_dobby/fabric/service.py)

Details:

  • reads:
    • GET /api/v1/contracts/jarvis
    • GET /api/v1/contracts/jarvis/readiness
    • GET /api/v1/contracts/registry
    • GET /api/v1/contracts/families
    • GET /api/v1/contracts/schemas
    • GET /api/v1/contracts/matrix
    • POST /api/v1/tools/admission/dry-run
  • materializes a local alignment/readiness view only
  • must not create local JARVIS or admission truth

Capability Key​

dobby.persistence.store

  • Title: Durable runtime store
  • Stability: Stable
  • Exposure: Internal runtime
  • Primary API surface / command / artifact / file: src/jhf_dobby/persistence/runtime.py (src/jhf_dobby/persistence/runtime.py), src/jhf_dobby/persistence/models.py (src/jhf_dobby/persistence/models.py)

Details:

  • owns run, replay, proposal, and metric storage
  • supports SQLite for local/test and Postgres for live runtime
  • uses bounded Postgres connect timeout for degraded behavior

Capability Key​

dobby.worker.revalidation

  • Title: Revalidation expiry worker
  • Stability: Stable
  • Exposure: Internal runtime
  • Primary API surface / command / artifact / file: src/jhf_dobby/worker/service.py (src/jhf_dobby/worker/service.py)

Details:

  • scans proposals with revalidate_required=true
  • expires proposals that remain in active lifecycle states
  • uses low-pressure polling defaults plus bounded backoff/jitter under persistence errors

Capability Key​

dobby.runtime-guardrails

  • Title: CPU-safe runtime guardrails and bounded diagnostics
  • Stability: Stable
  • Exposure: Internal runtime / verify
  • Primary API surface / command / artifact / file: ../scripts/verify_runtime_guardrails.py (scripts/verify_runtime_guardrails.py), ../deploy/compose/jhf-dobby.stack.yml (deploy/compose/jhf-dobby.stack.yml)

Details:

  • keeps diagnostics bounded with --since, --tail, and one-shot stats
  • keeps worker defaults shared-host-safe
  • verifies repo-owned compose project identity and idempotent reruns

Capability Key​

dobby.governed-provenance

  • Title: Hash-bound lineage and marked provenance publication
  • Stability: Stable
  • Exposure: Internal runtime
  • Primary API surface / command / artifact / file: src/jhf_dobby/learning/service.py (src/jhf_dobby/learning/service.py), src/jhf_dobby/integrations/bobbin.py (src/jhf_dobby/integrations/bobbin.py)

Details:

  • computes candidate and provenance hashes
  • builds Bobbin-marked artifacts without transferring policy/proposal ownership
  • rejects prohibited ownership fields in Bobbin artifacts

Experimental Or Transitional Capabilities​

Capability Key​

dobby.shuttle-evidence-enrichment

  • Title: Optional Shuttle A2A/handoff evidence enrichment
  • Stability: Transitional
  • Exposure: Internal runtime
  • Primary API surface / command / artifact / file: src/jhf_dobby/integrations/shuttle.py (src/jhf_dobby/integrations/shuttle.py)

Details:

  • enriches intake priority using Shuttle evidence matches
  • materializes negative handoff outcomes into a Dobby-owned read-only learning view
  • remains read-only and optional
  • degrades safely when Shuttle is absent, 404, or unavailable

Capability Key​

dobby.spool-classification

  • Title: Spool scope classification
  • Stability: Transitional
  • Exposure: Internal runtime/documentation
  • Primary API surface / command / artifact / file: src/jhf_dobby/integrations/spool.py (src/jhf_dobby/integrations/spool.py)

Details:

  • documents Spool as optional read-only evidence only
  • does not affect policy, admission, or activation behavior

Current Gaps​

Capability Key​

dobby.authn-authz

  • Title: Dedicated API authentication and authorization layer
  • Stability: Not implemented
  • Exposure: Gap
  • Primary API surface / command / artifact / file: none

Details:

  • the codebase documents route intent through manifest metadata
  • the FastAPI service itself does not implement route-level auth enforcement
  • production access control must currently be provided by the surrounding stack

Capability Key​

dobby.async-work-queue

  • Title: Queue-backed asynchronous execution beyond the revalidation worker
  • Stability: Not implemented
  • Exposure: Gap
  • Primary API surface / command / artifact / file: none

Details:

  • queue depth metrics exist
  • there is no separate broker or queued replay execution subsystem in this repository

Capability Key​

dobby.weight-training

  • Title: Weight training candidate execution
  • Stability: Not implemented
  • Exposure: Gap
  • Primary API surface / command / artifact / file: blocked in src/jhf_dobby/learning/service.py (src/jhf_dobby/learning/service.py)

Details:

  • weight_training_candidate is explicitly rejected in v1
  • it must not be documented as available

Capability Key​

dobby.business-process-learning-signals

  • Title: Business-process self-learning signals
  • Stability: Planned
  • Exposure: Gap
  • Primary API surface / command / artifact / file: planned future feature tracked in jhf-dobby#41

Details:

  • intended future scope is evidence-backed supplier and workflow quality optimization
  • must stay recommendation-first, explainable, and governance-bound
  • must not become a shadow ERP/procurement truth source

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