FrontmatterVersion: 1 DocumentType: Guide Title: Fathym Reference Architecture (@fathym/common) Summary: Lean common package for Fathym runtimes (HTTP/path/matches/merge/tags/iterables/testing/types/third-party plus telemetry/log/build). Created: 2025-11-20 Updated: 2025-11-20 Owners: - fathym References: - Label: Projects: Ref-Arch README Path: ../README.md - Label: Projects: Ref-Arch AGENTS Path: ../AGENTS.md - Label: Projects: Ref-Arch Guide Path: ../GUIDE.md - Label: Root README Path: ../../../README.md - Label: Root Agents Guide Path: ../../../AGENTS.md - Label: Root Workspace Guide Path: ../../../WORKSPACE_GUIDE.md - Label: Project Agents Guide Path: ./AGENTS.md - Label: Project Guide Path: ./GUIDE.md

Fathym Reference Architecture (@fathym/common)

Lean common libraries that underpin Fathym runtimes (HTTP/path/matches/merge/tags/iterables/testing/types/third-party plus telemetry/log/build).

• Goal: provide a stable, well-tested common package for Fathym services, micro-frameworks, and supporting tools without CLI/DFS/runtime concerns.
• Outputs: published package(s), build/test scripts, and integration docs for downstream consumers.
• Code location: this folder (projects/ref-arch/reference-architecture/) hosts the common source; link any external repo if relocated.

Current Status

• Deno tasks available (see deno.jsonc): build, lint, fmt, test.
• Package exports defined for HTTP utilities, iterables, JWT helpers, matches/merge/path/tags/testing/types, third-party adapters, build helpers, telemetry, and log.
• Upstream and release channel not yet documented; add to UPSTREAM.md when pinned.

How to Work in This Pod

1. Read the parent portfolio docs plus this project’s AGENTS and GUIDE.
2. Declare intent before editing; summarize outcomes and open questions.
3. Capture provenance and pinning in UPSTREAM.md when publishing or vendoring.
4. Keep links relative and update references when code moves or APIs change.