@tyndall/shared

Overview

Shared utility package for hashing, file operations, timing, cache keys, and platform metadata.

Responsibilities

• Provide deterministic hashing and stable serialization helpers
• Provide safe file and cache utility primitives
• Keep reusable cross-package helpers independent of framework layers
• Provide shared logger primitives with severity filtering and readable level-based formatting

Public API Highlights

• hash and normalizePath
• readFileSafe and writeFileAtomic
• computeCacheRootKey and resolveCacheRoot

Development

• Build: bun run --filter @tyndall/shared build
• Test (from workspace root): bun test

Documentation

• Package specification: spec.md
• Package architecture: architecture.md
• Package changes: CHANGELOG.md

Maintenance Rules

• Keep this document aligned with implemented package behavior.
• Update spec.md and architecture.md whenever package contracts or design boundaries change.
• Record user-visible package changes in CHANGELOG.md.