Aller au contenu principal

Capabilities

Documentation Map​

Capabilities

This page is the wiki.js-oriented capability inventory for jhf-fabric. It lists only real capabilities that are represented by code, contracts, deployment assets, or live surfaces in this repository.

For QA derivation and failure-mode coverage per feature, use docs/MODULE_FEATURES.md as the machine-readable companion surface.

Stable External Capabilities​

control-plane-api​

  • Title: Versioned control-plane API
  • Stability: stable
  • Exposure: external
  • Primary API surface / command / artifact / file: GET /health, GET /api/v1/openapi.json, src/helpifyr_fabric/api/app.py

schema-governance-registry​

  • Title: Schema governance registry and contract catalogs
  • Stability: stable
  • Exposure: external
  • Primary API surface / command / artifact / file: GET /api/v1/contracts/registry, GET /api/v1/contracts/families, GET /api/v1/contracts/schemas, GET /api/v1/contracts/matrix, contracts/registry/index.json

admission-dry-run​

  • Title: Admission dry-run and compatibility evaluation
  • Stability: stable
  • Exposure: external
  • Primary API surface / command / artifact / file: POST /api/v1/tools/admission/dry-run, POST /api/v1/contracts/compatibility/check, contracts/admission/admission_dry_run_input.schema.json

combination-profile-publication​

  • Title: Combination profile and optional-slice publication
  • Stability: stable
  • Exposure: external
  • Primary API surface / command / artifact / file: GET /api/v1/combinations/profiles, GET /api/v1/combinations/optional-slices, docs/contracts/HELPIFYR_COMBINATION_PROFILE_CONTRACT.md

identity-policy-truth​

  • Title: Identity contract and entitlement-policy truth
  • Stability: stable
  • Exposure: external
  • Primary API surface / command / artifact / file: GET /api/v1/identity/contracts, GET /api/v1/identity/contracts/entitlement-policy, contracts/policies/entitlement_policy_contract.json

identity-surface-registry-and-projection​

  • Title: Surface admission, access projection, onboarding, lifecycle, and fail-closed verdict truth
  • Stability: stable
  • Exposure: external
  • Primary API surface / command / artifact / file: GET /api/v1/identity/contracts/surface-admission, GET /api/v1/identity/contracts/surface-access, GET /api/v1/identity/contracts/surface-lifecycle, GET /api/v1/identity/consumers/onboarding, contracts/policies/identity_surface_access_projection.json

access-mapping-truth​

  • Title: Access-mapping input, event, and verdict truth
  • Stability: stable
  • Exposure: external
  • Primary API surface / command / artifact / file: GET /api/v1/identity/contracts/access-mapping, GET /api/v1/identity/contracts/access-mapping/readiness, contracts/policies/access_mapping_contract.json

agent-federation-projection​

  • Title: Agent-federation projection and fail-closed readiness
  • Stability: stable
  • Exposure: external
  • Primary API surface / command / artifact / file: GET /api/v1/identity/agent-federation/projection, GET /api/v1/identity/agent-federation/readiness, docs/contracts/HELPIFYR_AGENT_FEDERATION_PROJECTION.md

plane-unified-access-projection​

  • Title: Plane unified access handoff truth
  • Stability: stable
  • Exposure: external
  • Primary API surface / command / artifact / file: GET /api/v1/projections/plane-unified-access, GET /api/v1/projections/plane-unified-access/readiness, docs/contracts/HELPIFYR_PLANE_UNIFIED_ACCESS_PROJECTION.md

runtime-memory-claims-contract​

  • Title: Runtime memory authorization claims contract
  • Stability: stable
  • Exposure: external
  • Primary API surface / command / artifact / file: GET /api/v1/memory/runtime-claims/contracts, GET /api/v1/memory/runtime-claims/readiness, contracts/policies/runtime_memory_claims_contract.json

support-orchestration-contracts​

  • Title: Support-case orchestration contract family
  • Stability: stable
  • Exposure: external
  • Primary API surface / command / artifact / file: GET /api/v1/support-orchestration/contracts, GET /api/v1/support-orchestration/readiness, docs/contracts/HELPIFYR_SUPPORT_CASE_ORCHESTRATION_FOUNDATION.md

voice-contract-publication​

  • Title: Voice event and readiness contracts
  • Stability: stable
  • Exposure: external
  • Primary API surface / command / artifact / file: GET /api/v1/voice/contracts/events, GET /api/v1/voice/integration/readiness, docs/contracts/HELPIFYR_VOICE_EVENTS_CONTRACT.md

acp-capability-registry​

  • Title: ACP capability registry and skill-pack event truth
  • Stability: stable
  • Exposure: external
  • Primary API surface / command / artifact / file: GET /api/v1/acp/contracts/capability-registry, GET /api/v1/acp/contracts/skill-pack-events, GET /api/v1/acp/projections/reed-read-only-capability, GET /api/v1/acp/projections/swatch-scenario-verdict, docs/contracts/HELPIFYR_ACP_CAPABILITY_REGISTRY_V1.md

tooling-runtime-evidence​

  • Title: Tooling inventory, policy, runtime evidence, and deployment-consumer alignment
  • Stability: stable
  • Exposure: external
  • Primary API surface / command / artifact / file: GET /api/v1/tools/presence, GET /api/v1/tools/runtime-status, GET /api/v1/tools/runtime-contracts, GET /api/v1/tools/deployment-consumers

product-capability-registry​

  • Title: Product registration and capability catalog
  • Stability: stable
  • Exposure: external
  • Primary API surface / command / artifact / file: POST /api/v1/products/register, GET /api/v1/capabilities, fabric-manifest.json

update-and-rollout-gating​

  • Title: Update compatibility and rollout-gate evaluation
  • Stability: stable
  • Exposure: external
  • Primary API surface / command / artifact / file: POST /api/v1/updates/check, GET /api/v1/updates/compatibility-matrix, POST /api/v1/updates/rollout-gate

provider-runtime-discovery​

  • Title: Provider runtime discovery and guarded handoff previews
  • Stability: stable
  • Exposure: external
  • Primary API surface / command / artifact / file: GET /api/v1/providers/openclaw/discovery, GET /api/v1/providers/openclaw/runtime-status, POST /api/v1/providers/openclaw/topology/diff-plan, contracts/providers/provider_instance_registry.json

Stable Internal Capabilities​

event-outbox-and-publication​

  • Title: Event outbox persistence and publish evidence
  • Stability: stable
  • Exposure: internal
  • Primary API surface / command / artifact / file: POST /api/v1/events/outbox/*, GET /api/v1/events/outbox/recent, contracts/asyncapi/event_catalog.json

persistence-and-migrations​

  • Title: PostgreSQL persistence layer and migration posture
  • Stability: stable
  • Exposure: internal
  • Primary API surface / command / artifact / file: GET /api/v1/persistence/status, GET /api/v1/persistence/migrations/status, alembic/

dapr-runtime-probing​

  • Title: Dapr status, state probing, and invocation readiness
  • Stability: stable
  • Exposure: internal
  • Primary API surface / command / artifact / file: GET /api/v1/dapr/status, POST /api/v1/dapr/state/probe, POST /api/v1/dapr/invocation/self-health/probe

governance-and-signoff​

  • Title: Governance dashboards, review evidence, and production signoff readiness
  • Stability: stable
  • Exposure: internal
  • Primary API surface / command / artifact / file: GET /api/v1/governance/*, GET /api/v1/signoff/*, contracts/policies/governance_run_standard.json

observability-and-recovery​

  • Title: Observability dashboards and recovery posture
  • Stability: stable
  • Exposure: internal
  • Primary API surface / command / artifact / file: GET /api/v1/observability/*, GET /api/v1/recovery/*, deploy/compose/platform-plane/grafana

security-control-plane​

  • Title: Security summary, operator safety, and remediation posture
  • Stability: stable
  • Exposure: internal
  • Primary API surface / command / artifact / file: GET /api/v1/security/*, docs/SECURITY.md

wikijs-doc-bootstrap​

  • Title: Wiki.js documentation bootstrap and theming assets
  • Stability: stable
  • Exposure: internal
  • Primary API surface / command / artifact / file: scripts/bootstrap_wikijs_docs.py, deploy/compose/platform-plane/wiki/HELPIFYR_WIKI_HOME.md

platform-plane-provisioning​

  • Title: Platform-plane provisioning and dashboard activation
  • Stability: stable
  • Exposure: internal
  • Primary API surface / command / artifact / file: scripts/prepare-platform-plane-assets.sh, deploy/compose/jhf-fabric.platform-plane.yml

mcp-read-tools​

  • Title: MCP read tools backed by API truth
  • Stability: stable
  • Exposure: internal
  • Primary API surface / command / artifact / file: GET /api/v1/mcp/read-tools, GET /api/v1/mcp/read-tools/readiness, GET /api/v1/mcp/production-catalog, GET /api/v1/mcp/gitea-safe-lane, GET /api/v1/mcp/grafana-readonly, GET /api/v1/agent/workflow/delivery-loop

mcp-production-mvp-catalog​

  • Title: MCP Production MVP catalog and admission posture
  • Stability: stable
  • Exposure: internal
  • Primary API surface / command / artifact / file: GET /api/v1/mcp/production-catalog, GET /api/v1/mcp/production-catalog/readiness, GET /api/v1/agent/bootstrap, fabric-manifest.json#mcp, docs/contracts/HELPIFYR_MCP_CONTRACT_ALIGNMENT_GUARDRAILS.md

mcp-contract-alignment-guardrails​

  • Title: Cross-repository MCP contract alignment and promotion gates
  • Stability: stable
  • Exposure: internal
  • Primary API surface / command / artifact / file: GET /api/v1/mcp/production-catalog, GET /api/v1/mcp/alignment-records, docs/contracts/HELPIFYR_MCP_CONTRACT_ALIGNMENT_GUARDRAILS.md, contracts/mcp/mcp_contract_alignment_record_v1.schema.json, scripts/validate_mcp_contract_alignment_record.py, templates/mcp/mcp_contract_alignment_record.template.json, docs/MODULE_FEATURES.md

mcp-gitea-safe-lane​

  • Title: Gitea issue safe lane for MCP agents
  • Stability: stable
  • Exposure: internal
  • Primary API surface / command / artifact / file: GET /api/v1/mcp/gitea-safe-lane, GET /api/v1/mcp/gitea-safe-lane/readiness

mcp-autonomous-delivery-loop​

  • Title: Autonomous delivery-loop checkpoint contract
  • Stability: stable
  • Exposure: internal
  • Primary API surface / command / artifact / file: GET /api/v1/agent/workflow/delivery-loop, docs/plans/PLAN_HELPIFYR_MCP_PRODUCTION_MVP_AND_AUTONOMOUS_DELIVERY.md

mcp-openclaw-skill-context​

  • Title: Fabric-filtered OpenClaw Skill Context admission
  • Stability: stable
  • Exposure: internal
  • Primary API surface / command / artifact / file: GET /api/v1/mcp/production-catalog, GET /api/v1/agent/bootstrap, jhf-warp openclaw-skill policy-pack

mcp-pattern-evidence-readback​

  • Title: Pattern MCP MVP action evidence readback
  • Stability: stable
  • Exposure: internal
  • Primary API surface / command / artifact / file: GET /api/v1/mcp/production-catalog, jhf-pattern /fabric-mcp-mvp-action-evidence-readback

mcp-n8n-workflow-readback​

  • Title: Shuttle/n8n read-only workflow readback
  • Stability: stable
  • Exposure: internal
  • Primary API surface / command / artifact / file: GET /api/v1/mcp/production-catalog, jhf-shuttle scripts/verify_mcp_readback_lane.py

mcp-spindle-business-operations​

  • Title: Spindle business MCP operations contract
  • Stability: stable
  • Exposure: internal
  • Primary API surface / command / artifact / file: GET /api/v1/mcp/production-catalog, jhf-spindle MCP health/init/tools discovery

mcp-grafana-readonly-observability​

  • Title: Grafana readonly MCP observability readback
  • Stability: stable
  • Exposure: internal
  • Primary API surface / command / artifact / file: GET /api/v1/mcp/grafana-readonly, GET /api/v1/observability/dashboard-registry, GET /api/v1/observability/grafana-provisioning, GET /api/v1/observability/alert-summary

mcp-safe-actions​

  • Title: MCP safe-action tools with guarded posture
  • Stability: stable
  • Exposure: internal
  • Primary API surface / command / artifact / file: GET /api/v1/mcp/safe-actions, GET /api/v1/mcp/safe-actions/readiness

Experimental Or Transitional Capabilities​

cross-repository-onboarding​

  • Title: Cross-repository onboarding and adoption guidance
  • Stability: transitional
  • Exposure: internal
  • Primary API surface / command / artifact / file: docs/NEW_TOOL_ONBOARDING.md, contracts/adoption/cross_repo_adoption_matrix.json

provider-federation-posture​

  • Title: Provider federation posture and downstream adoption synchronization
  • Stability: transitional
  • Exposure: external
  • Primary API surface / command / artifact / file: GET /api/v1/contracts/providers, GET /api/v1/contracts/providers/drift, contracts/federation/fabric_federation_posture.json

schema-tolerant-normalization​

  • Title: Schema-tolerant normalization for repo and tool metadata
  • Stability: transitional
  • Exposure: internal
  • Primary API surface / command / artifact / file: tooling catalog and compliance surfaces under /api/v1/tools/*

standalone-fallback-guidance​

  • Title: Standalone fallback guidance for downstream SDK consumers
  • Stability: transitional
  • Exposure: internal
  • Primary API surface / command / artifact / file: docs/operations/FABRIC_SDK_STANDALONE_FALLBACK.md

Current Gaps​

  • not every external Helpifyr repository publishes the same level of live readiness and drift evidence as this repository
  • some provider-facing flows intentionally remain preview-only and do not grant direct host mutation
  • legacy aliasing around helpifyr-fabric still exists at package and repository boundaries while runtime truth uses jhf-fabric
  • later governance-plan waves marked out of current scope are documented as planned, not as live features

License​