Skip to main content

jhf-spool Capabilities

Documentation Map​

Capabilities

Version: 2026-04-19

This file documents real capabilities currently present in jhf-spool. It is aligned to Fabric read-first governance: local descriptions are derivative and must not replace Fabric-owned truth. For QA-grade per-feature acceptance and failure-mode mapping, see MODULE_FEATURES.md (docs/MODULE_FEATURES.md).

Stable External Capabilities​

Capability​

  • capability key: spool.ingest.jobs
  • Title: Ingestion Job Execution
  • Stability: stable
  • Exposure: external (authenticated)
  • Primary API surface / command / artifact / file:
    • POST /v1/ingest/*
    • GET /v1/jobs/{job_id}
    • scripts/smoke-test.py

Capability​

  • capability key: spool.search.retrieve
  • Title: Search and Article Retrieval
  • Stability: stable
  • Exposure: external (authenticated)
  • Primary API surface / command / artifact / file:
    • POST /v1/search/semantic
    • POST /v1/search/filter
    • GET /v1/articles/{article_id}
    • GET /v1/articles/{article_id}/versions
    • GET /v1/articles/{article_id}/dedupe-cluster

Capability​

  • capability key: spool.snapshot.export
  • Title: Snapshot and Export Artifact Delivery
  • Stability: stable
  • Exposure: external (authenticated)
  • Primary API surface / command / artifact / file:
    • POST /v1/datasets/snapshots
    • GET /v1/datasets/snapshots/{snapshot_id}*
    • POST /v1/exports/simulation
    • GET /v1/exports/{export_id}*

Capability​

  • capability key: spool.support.evidence-envelope
  • Title: Support Case Evidence Enrichment
  • Stability: stable
  • Exposure: external (authenticated)
  • Primary API surface / command / artifact / file:
    • GET /v1/support-cases/{case_id}/evidence
    • POST /v1/support-cases/{case_id}/evidence/enrich
    • docs/SUPPORT_EVIDENCE_CONTRACT.md

Capability​

  • capability key: spool.public.discovery
  • Title: Public Health and Contract Discovery
  • Stability: stable
  • Exposure: external (public read-only)
  • Primary API surface / command / artifact / file:
    • GET /v1/health/live
    • GET /v1/health/ready
    • GET /v1/health/info
    • GET /v1/fabric/metadata
    • GET /v1/external-api-contract
    • GET /openapi.json

Stable Internal Capabilities​

Capability​

  • capability key: spool.runtime.release-gates
  • Title: Operational Readiness and Release Gate Views
  • Stability: stable
  • Exposure: internal/operator (authenticated)
  • Primary API surface / command / artifact / file:
    • GET /v1/research/operational-slo-gates
    • GET /v1/research/security-compliance-gates
    • GET /v1/research/incident-readiness-gates
    • GET /v1/research/secret-readiness
    • scripts/ops/run_operational_release_checks.py

Capability​

  • capability key: spool.billing.webhook-sync
  • Title: Paddle Webhook Ingress and Billing Sync
  • Stability: stable (integration dependency external)
  • Exposure: external provider ingress + internal billing state
  • Primary API surface / command / artifact / file:
    • POST /v1/webhooks/paddle
    • GET /v1/research/paddle-readiness
    • docs/PADDLE_LIVE_SETUP.md

Capability​

  • capability key: spool.fabric.read-first-consumer
  • Title: Fabric Governance and Combination Truth Consumer
  • Stability: stable
  • Exposure: internal contract consumer
  • Primary API surface / command / artifact / file:
    • consumed:
      • GET api/v1/contracts/matrix
      • GET api/v1/contracts/docs-standard
      • GET api/v1/combinations/profiles
    • local projection:
      • GET /v1/fabric/metadata
    • tests:
      • tests/test_fabric_wave3_adoption_contract.py
      • tests/test_fabric_combination_consumer_contract.py

Experimental Or Transitional Capabilities​

Capability​

  • capability key: spool.n8n.orchestration-optional
  • Title: Optional n8n Workflow Orchestration
  • Stability: transitional
  • Exposure: internal operator integration
  • Primary API surface / command / artifact / file:
    • n8n-workflows/jhf-spool/*
    • scripts/deploy_news_memory_n8n_workflows.py
    • runtime env: NEWS_MEMORY_N8N_PORT, N8N_ENCRYPTION_KEY

Capability​

  • capability key: spool.paddle.production-rollout
  • Title: Paddle Production Rollout Bundle
  • Stability: transitional (external blocker)
  • Exposure: external commercial flow
  • Primary API surface / command / artifact / file:
    • GET /v1/research/paddle-readiness
    • issue state: solarisara/jhf-spool#29

Current Gaps​

Gap​

  • capability key: gap.paddle-production-ready
  • Title: Missing External Provider Handoff for Paddle Production Values
  • Stability: blocked-external
  • Exposure: cross-repo operator/provider dependency
  • Primary API surface / command / artifact / file:
    • solarisara/jhf-spool#29
    • JaddaHelpifyr/openclaw-environment#26

Gap​

  • capability key: gap.fabric-write-control-plane
  • Title: No Fabric Write/Control Integration in Maintained Scope
  • Stability: intentional-gap
  • Exposure: architecture boundary
  • Primary API surface / command / artifact / file:
    • not implemented by design
    • boundary docs: docs/FABRIC_WAVE3_ADOPTION.md

Gap​

  • capability key: gap.local-case-truth-engine
  • Title: No Local Case-Truth Engine
  • Stability: intentional-gap
  • Exposure: product boundary
  • Primary API surface / command / artifact / file:
    • evidence-only boundary:
      • docs/SUPPORT_EVIDENCE_CONTRACT.md
      • GET /v1/support-cases/{case_id}/evidence
      • POST /v1/support-cases/{case_id}/evidence/enrich

License: AGPLv3
Learn more: https://helpifyr.com