Skip to content

docs: cacheManager TTL rationale #537

Description

@nanaf6203-bit

Summary

src/lib/cacheManager.ts uses scattered TTL constants without a documented rationale. New contributors can't reason about why defaults were chosen.

Affected area

  • src/lib/cacheManager.ts
  • src/types/cache.ts
  • docs/ (ARCHITECTURE.md not present)

Acceptance criteria

  • Document every default TTL in a single table.
  • Add an ARCHITECTURE.md section explaining eviction order and capacity reasoning.
  • Add unit tests that lock the documented behaviour in.
  • Reference the doc from each TTL constant.

Filed automatically as part of the PropChain code-review sweep.

Metadata

Metadata

Assignees

No one assigned

    Labels

    documentationDocumentation or dev-experiencepriority/p3P3 — nice to have

    Type

    No type
    No fields configured for issues without a type.

    Projects

    No projects

    Milestone

    No milestone

    Relationships

    None yet

    Development

    No branches or pull requests

    Issue actions