Skip to main content

Capabilities

Documentation Map​

Capabilities

This file is the capability inventory for jhf-wire.
Fabric-owned governance and profile truth remains external; this file does not redefine Fabric truth.

Capability Inventory​

The inventory is split into stable external, stable internal, experimental/transitional, and current gaps. Each capability entry keeps the same minimum fields: Title, Stability, Exposure, Typical Consumer, Input, Output, and primary surface references.

Stable External Capabilities​

delivery-bridge​

  • Title: Dispatch-to-provider delivery bridge
  • Stability: stable
  • Exposure: external (bundle boundary jhf-spindle-wire)
  • Typical Consumer: jhf-spindle
  • Primary API surface / command / artifact / file:
    • inbound: /webhook/clawledger/*
    • outbound: signed callback to callback.url
    • workflow files under n8n-workflows/

bank-sync​

  • Title: FinAPI bank sync and MCP statement import
  • Stability: stable
  • Exposure: external (triggered by jhf-spindle)
  • Typical Consumer: jhf-spindle
  • Primary API surface / command / artifact / file:
    • workflow ingress: /webhook/clawledger/bank/sync
    • FinAPI surfaces: /api/v2/bankConnections, /api/v2/accounts, /api/v2/transactions, /api/v2/pendingTransactions
    • MCP surface: ${CLAWLEDGER_MCP_URL}/mcp

support-notification-bridge​

  • Title: Support-case notification projection
  • Stability: stable
  • Exposure: external read intake (Fabric/ops consumers)
  • Typical Consumer: jhf-fabric, operator teams
  • Primary API surface / command / artifact / file:
    • command: python scripts/validate_support_case_delivery.py --pretty
    • artifact: artifacts/support-case-delivery-validation.json
    • contract doc: docs/SUPPORT_CASE_DELIVERY_CONTRACT.md

delivery-evidence-export​

  • Title: Delivery evidence export for retries and recovery
  • Stability: stable
  • Exposure: external read intake
  • Typical Consumer: jhf-fabric, audit operators
  • Primary API surface / command / artifact / file:
    • command: python scripts/validate_support_case_delivery.py --pretty
    • artifact: artifacts/support-case-delivery-validation.json
    • verify helper: bash scripts/check_support_case_delivery.sh

Stable Internal Capabilities​

callback-bridge​

  • Title: Signed callback transport
  • Stability: stable
  • Exposure: internal bundle boundary support capability
  • Typical Consumer: jhf-spindle
  • Primary API surface / command / artifact / file:
    • callback headers: X-Signature, X-Idempotency-Key
    • callback emit logic in workflow JSON files
    • verify path: docs/API.md

connector-webhook-ingress​

  • Title: Webhook ingress authorization and dispatch intake
  • Stability: stable
  • Exposure: internal ingress surface for trusted callers
  • Typical Consumer: jhf-spindle dispatch runtime
  • Primary API surface / command / artifact / file:
    • /webhook/clawledger/sepa/submit
    • /webhook/clawledger/bank/sync
    • /webhook/clawledger/invoice/dispatch
    • /webhook/clawledger/tax/submit

runtime-health-readiness-view​

  • Title: Runtime health/readiness/status projection
  • Stability: stable
  • Exposure: internal operator and fabric-facing read-only support
  • Typical Consumer: operators, jhf-fabric read intake
  • Primary API surface / command / artifact / file:
    • ${N8N_BASE_URL}/healthz
    • ${ERIC_HEALTHCHECK_URL}/health
    • bash scripts/check_runtime_readiness.sh
    • bash scripts/check_stack_state.sh
    • python scripts/export-fabric-metadata.py --pretty

reed-module-adapter-manifest-v2​

  • Title: Reed module adapter manifest v2 contract truth
  • Stability: stable
  • Exposure: internal contract governance
  • Typical Consumer: jhf-reed, jhf-warp, helpifyr-fabric, jhf-heddle, deployment/QA operators
  • Primary API surface / command / artifact / file:
    • contracts/reed/module-adapter-manifest.v2.json
    • schemas/reed_module_adapter_manifest_v2.schema.json
    • python scripts/validate_reed_adapter_manifest_v2.py --strict

reed-sandbox-write-lanes-v1​

  • Title: Reed sandbox submission/receipt/rejection/retry write lanes
  • Stability: stable
  • Exposure: internal contract governance + sandbox simulation
  • Typical Consumer: ACP test/QA lanes (jhf-swatch program context), adapter maintainers
  • Primary API surface / command / artifact / file:
    • contracts/reed/sandbox-write-lanes.v1.json
    • schemas/reed_sandbox_write_lanes_v1.schema.json
    • python scripts/validate_reed_sandbox_write_lanes.py --strict --emit-evidence artifacts/reed-sandbox-write-evidence.json

oss-inventory-version-truth-v1​

  • Title: Repo-owned OSS inventory and upgrade-readiness truth
  • Stability: stable
  • Exposure: internal governance + release gate
  • Typical Consumer: maintainers, CI gate, deployment intake
  • Primary API surface / command / artifact / file:
    • maintenance/oss-inventory.json
    • maintenance/oss-version-truth.json
    • maintenance/oss-upgrade-policy.json
    • maintenance/oss-drift-contract.json
    • maintenance/upgrade-paths.json
    • python scripts/check_oss_inventory_versions.py --strict
    • python scripts/check_oss_maintenance_contracts.py --strict

wire-outbound-delivery-event-model-w4​

  • Title: Wave-4 outbound-delivery event model contract adoption
  • Stability: stable
  • Exposure: internal contract governance (read-only)
  • Typical Consumer: helpifyr-fabric, adapter/audit maintainers
  • Primary API surface / command / artifact / file:
    • contracts/reed/outbound-delivery-event-model.w4.json
    • schemas/wire_outbound_delivery_event_model_w4.schema.json
    • python scripts/validate_outbound_delivery_event_model.py --strict

Experimental Or Transitional Capabilities​

invoice-dispatch​

  • Title: Invoice/XRechnung dispatch provider path
  • Stability: pilot
  • Exposure: external
  • Typical Consumer: jhf-spindle finance dispatch
  • Primary API surface / command / artifact / file:
    • ingress: /webhook/clawledger/invoice/dispatch
    • provider config via STORECOVE_* environment variables
    • workflow file: n8n-workflows/jhf-spindle-xrechnung-dispatch.workflow.json

tax-submit​

  • Title: ELSTER/ERiC submit path
  • Stability: pilot
  • Exposure: external
  • Typical Consumer: jhf-spindle tax dispatch
  • Primary API surface / command / artifact / file:
    • ingress: /webhook/clawledger/tax/submit
    • runtime service: ${ERIC_SERVICE_URL}
    • workflow file: n8n-workflows/jhf-spindle-elster-submit.workflow.json

Current Gaps​

  • Productive provider onboarding is external and not repo-solvable (Storecove/ELSTER credentials and runtime materials).
  • ERiC productive submit readiness depends on external runtime binary/cert handoff.
  • Fabric write-back execution control is intentionally out of scope; only read-first consumption is implemented.
  • No local fallback truth for Fabric contract matrix/docs-standard/profiles is allowed.

Stability Rules​

  • stable means CI-guarded and part of the documented operator/runtime contract.
  • pilot means implemented and useful, but still more exposed to provider/runtime edge cases.
  • Capabilities are listed as stable only when a concrete contract surface exists.

Scope Boundaries​

  • Capabilities describe runtime behavior and public/adjacent contracts.
  • They do not redefine Fabric-owned policy or contract truth.
  • Planned capabilities are excluded until a real contract surface exists in this repo.

License: AGPLv3 Project website: https://helpifyr.com