Skip to main content

jhf-loom Overview

Documentation Map​

Overview

Tool / Contract Summary​

jhf-loom is the live Helpifyr ECM runtime. The repository owns the Loom stack definition, runtime contracts, repo-owned validation scripts, and documentation for the live Alfresco CE service on <internal-runtime-redacted>.

Business Value​

Loom gives the Helpifyr stack one governed place for:

  • content storage
  • metadata updates
  • version-aware content handling
  • Share-based human access
  • repository/API-based machine access
  • search-backed retrieval
  • transform-backed document renditions

Current Verified State​

The following are live and verified now:

  • runtime: Alfresco Community Edition 26.1
  • hostname: <internal-runtime-redacted>
  • canonical human path: Share behind proxy-SSO
  • canonical machine path: repository/API behind the same trusted ingress
  • repo-owned live smoke and resilience validators are green

Available Now​

  • repo-owned compose runtime for DB, broker, transform, search, repo, and Share
  • runtime contracts in config/runtime/*
  • Fabric consumer posture in config/fabric/*
  • public Share and repository surfaces through the trusted ingress path
  • repo-owned verify paths for smoke, restart, and cold start
  • canonical docs platform v1.6 base family rooted at:
    • README.md
    • docs/OVERVIEW.md
    • docs/INSTALL.md
    • docs/CONFIGURATION.md
    • docs/OPERATIONS.md
    • docs/TROUBLESHOOTING.md
    • docs/RELEASE_NOTES.md
    • docs_manifest.yml

Optional / Extended​

  • direct Alfresco-to-Keycloak integration remains non-canonical
  • domain and boundary docs describe policy and model posture, but they do not claim a custom deployed content model exists in the live runtime

Planned / Not in Current Scope​

  • new Fabric-produced shared contract families from Loom
  • new repo-owned workflow workers outside the Alfresco platform services
  • new custom content model rollout beyond the documented domain vocabulary

Public Surfaces​

  • https://<internal-runtime-redacted>/
  • https://<internal-runtime-redacted>/share/
  • https://<internal-runtime-redacted>/alfresco/

Producer-/Consumer-Zuordnung​

Producer boundary:

  • no shared Fabric truth is produced here today

Consumer boundary:

  • Loom consumes Fabric-owned docs standard, matrix, registry, families, schemas, JARVIS, and admission surfaces read-only
  • Loom consumes identity from jhf-heddle
  • Loom consumes ingress/TLS/DNS from jhf-openclaw-env

Lifecycle Status​

  • runtime state: live
  • public path state: live
  • SSO state: proxy-sso-live
  • repo maturity: active-runtime-with-boundary-docs

Readiness / Drift / Monitoring​

  • search is mandatory for green readiness
  • no partial-green state is allowed while search is red
  • current host drift must still be tracked if Docker marks jhf-loom-search unhealthy while functional probes remain green

License: AGPLv3.

Helpifyr: https://helpifyr.com