CAPABILITIES
Documentation Map
-
Capabilities
-
Channel:
stable -
Source repo:
JaddaHelpifyr/jhf-pattern
CAPABILITIES
This page is the repository-local capability index for jhf-pattern.
Fabric remains the governance source of truth for shared contract policy. This repository documents only:
- what is implemented here
- what this repository exposes
- what this repository consumes from Fabric and other systems
Stable External Capabilities
| Capability key | Title | Stability | Exposure | Primary API surface / command / artifact / file |
|---|---|---|---|---|
service-health-contract | Runtime health, readiness, version, and contract publication | stable | external read | /healthz, /readyz, /versionz, /contractz, /fabric-presencez, /fabric-compatibilityz, /fabric-manifest.json |
project-workflow-summary | Active workflow summary for operator and automation consumers | stable | external read | GET /api/v1/projects/{project_id}/active-workflow |
project-and-work-surface | Project, board, task, lane, handoff, and operation API family | stable | external read/write | /api/v1/projects/*, /api/v1/projects/{project_id}/tasks*, /api/v1/projects/{project_id}/lanes*, /api/v1/projects/{project_id}/handoffs*, `/api/v1/projects/{project_id}/freeze |
planning-surface | Planning cycles/modules/pages and repo sync controls | stable | external read/write | /api/v1/projects/{project_id}/planning/* |
delivery-review-surfaces | Delivery, environments, and review-oriented operator surfaces | stable | external read/write | /api/v1/projects/{project_id}/delivery/*, /api/v1/projects/{project_id}/integrations/{provider}/sync-* |
fabric-facts-publication | Pattern-owned Fabric pull facts for Plane bindings and membership visibility | stable | external read | /fabric-plane-workspace-facts, /fabric-plane-membership-facts |
adapter-sandbox-writes | Sandbox adapter write MVP for project/support/qa/release scenarios with idempotency/readback/evidence | stable | external write (sandbox-only) | POST /api/v1/projects/{project_id}/adapter-sandbox/writes, GET /api/v1/projects/{project_id}/adapter-sandbox/writes/{scenario}/{idempotency_key} |
reed-owner-facts | Authenticated read-only owner facts surface for Reed adapter consumption | stable | external read | GET /api/v1/reed/owner-facts, contracts/reed/module-adapter-manifest.v2.json |
Stable Internal Capabilities
| Capability key | Title | Stability | Exposure | Primary API surface / command / artifact / file |
|---|---|---|---|---|
mcp-mission-control-server | Internal MCP tool surface mapped to product contracts | stable | internal | backend.app.mcp.mission_control_server:main (mission-control-mcp) |
repo-task-issue-sync | Task-to-provider issue mirror logic | stable | internal | backend/app/services/repo_task_sync_service.py |
plane-sync-engine | Plane sync and guarded mode reconciliation engine | stable | internal | backend/app/services/plane_sync_service.py, backend/app/services/plane_read_sync_service.py |
audit-trace | Operator action, dispatch attempt, and sync audit records | stable | internal | GET /api/v1/projects/{project_id}/audit, backend/app/services/audit_service.py |
runtime-dispatch-bridge | Runtime dispatch webhook execution path from task/handoff changes | stable | internal | backend/app/services/runtime_bridge_service.py, OPENCLAW_RUNTIME_DISPATCH_WEBHOOK_URL |
reed-module-adapter-manifest-v2 | Pattern-owned Reed module adapter manifest v2 for project/support/product adapter boundaries | stable | internal contract | contracts/reed/module-adapter-manifest.v2.json, schemas/reed_module_adapter_manifest_v2.schema.json, bash scripts/reed-adapter-manifest-selfcheck.sh |
plane-identity-lane-contracts-v1 | Pattern-owned Plane projection boundary + disable/delete/revoke lane contract surfaces | stable | internal contract | contracts/plane/projection-contract.v1.json, contracts/plane/deprovisioning-contract.v1.json, python scripts/validate_plane_identity_contracts.py --strict |
oss-inventory-version-truth | Repo-owned OSS inventory, version truth, pinning policy, and drift verifier | stable | internal contract | maintenance/oss-inventory.json, maintenance/oss-version-truth.json, maintenance/oss-upgrade-policy.json, python scripts/verify_oss_inventory_version_truth.py --strict |
Experimental Or Transitional Capabilities
| Capability key | Title | Stability | Exposure | Primary API surface / command / artifact / file |
|---|---|---|---|---|
n8n-expert-bridge | n8n template build/publish/validation helper paths | transitional | external read/write | /api/v1/projects/{project_id}/integrations/n8n-expert*, /api/v1/projects/{project_id}/integrations/n8n-operator* |
approval-callback | Approval callback ingestion and operator continuation logic | transitional | external callback | /api/v1/approvals/clawledger |
full-live-wave-smoke | Full live host smoke matrix for broad runtime validation | transitional | internal | frontend/playwright.live.config.ts, npm run test:smoke:live:full |
Current Gaps
| Gap key | Description | Current state | Owning truth / next owner |
|---|---|---|---|
fabric-write-registration | Fabric write-side registration and metrics/event participation are not implemented here | gap | Fabric/platform side; Pattern remains read-only consumer/publisher of local facts |
global-contract-governance-authoring | Pattern cannot author global governance policy and version arbitration | gap | helpifyr-fabric contract governance surfaces |
provider-and-plane-runtime-availability | Live behavior depends on external provider and Plane availability/performance | gap | external systems + deployment/runtime operations |
shared-host-force-fault-paths | Some destructive or infra-level fault injections are intentionally not force-tested through public paths | gap | handled as explicit E2E gap issues when needed |
QA Feature Mapping
Detailed machine-readable feature and QA coverage mapping lives in:
MODULE_FEATURES.md(docs/MODULE_FEATURES.md)
Fabric Contract Consumer Declaration
Pattern consumes Fabric governance and support-orchestration contract truth from:
GET /api/v1/contracts/matrixGET /api/v1/contracts/docs-standardGET /api/v1/support-orchestration/pattern-consumer-contract
Pattern declares accepted contract families and versions in fabric-manifest.json (fabric-manifest.json).
Pattern must not create a local shadow truth for these Fabric-owned contract families.
License: AGPLv3
Helpifyr: https://helpifyr.com