Skip to content

chore: rename to @reaatech/llm-cache* and conform to a2a-reference-ts standards#1

Merged
reaatech merged 11 commits into
mainfrom
dev
Apr 30, 2026
Merged

chore: rename to @reaatech/llm-cache* and conform to a2a-reference-ts standards#1
reaatech merged 11 commits into
mainfrom
dev

Conversation

@reaatech
Copy link
Copy Markdown
Owner

Summary

  • Rename all internal package references from @llm-cache/* to @reaatech/llm-cache*
  • Dual ESM/CJS builds via tsup for all 7 packages
  • Biome replaces eslint+prettier+husky+lint-staged
  • Simplified tsconfigs (dropped composite mode), added tsconfig.typecheck.json
  • Comprehensive package and root READMEs matching a2a-reference-ts format
  • Publishing infrastructure: changesets, release workflow, LICENSE files
  • Bumped tooling versions: typescript 5.8, vitest 3, pnpm 10
  • CI aligned with reference repo (Node 20/22 matrix, streamlined jobs)

Commits

  1. docs: overhaul package and root READMEs for uniformity — Badges, API reference tables, usage patterns, related packages on every README
  2. chore: rename to @reaatech/llm-cache and conform to a2a-reference-ts standards* — All source, config, build, and tooling changes

After merge

Run pnpm install to regenerate the lockfile and install new tooling (biome, tsup, bumped versions).

reaatech added 11 commits April 30, 2026 05:45
Match the a2a-reference-ts README format:
- Badges (npm version, License, CI) on every package README
- Status note, Feature Overview bullet list, Quick Start code example
- Full API Reference tables documenting constructors, configs, methods, types
- Usage Patterns with practical examples
- Related Packages linking to sibling packages
- Root README restructured with packages table, architecture diagram, abbreviated config
… standards

rename packages (@llm-cache/* → @reaatech/llm-cache*):
- All source/test/example imports updated
- All package.json dependency references updated
- Dockerfile, CI workflow, pnpm-lock.yaml, devops skills updated

dual ESM/CJS via tsup (H1):
- All packages: main→.cjs, added module→.js, exports→types/import/require
- Build scripts: tsc --build → tsup --format cjs,esm --dts --clean
- tsup@^8.4.0 added to each package devDependencies

tooling conformity (M1-M6, M8):
- Biome replaces eslint+prettier+husky+lint-staged
- tsconfigs simplified (dropped composite mode, references, excludes)
- tsconfig.typecheck.json with workspace path aliases
- .npmrc with shamefully-hoist=false, strict-peer-dependencies=true
- versions bumped: typescript@^5.8.3, vitest@^3.1.1, coverage@3.2.4
- packageManager: pnpm@10.22.0, engines pnpm>=10.0.0

publishing infrastructure:
- .changeset/config.json with public access, GitHub changelog
- .github/workflows/release.yml with changesets/action, provenance, mirror
- LICENSE files copied to all 7 publishable packages
- homepage URLs include /tree/main/packages subdirectory paths
- .gitignore: added stray build output patterns, removed stale tsbuildinfo files

CI alignment (M9):
- Node version matrix: [20, 22], pnpm/action-setup@v4 (auto-detects)
- Removed format:check, build dep ordering no longer needed (tsup independent)
…ockfile

The lockfile was manually updated during the package rename and its
internal hash no longer matches the current configuration. Remove
--frozen-lockfile so pnpm 10 can auto-migrate and fix the lockfile.
- Auto-formatted 47 files with biome (JSON whitespace, import ordering, etc.)
- Fixed 8 noExplicitAny violations with biome-ignore comments in test mocks
- Fixed 1 noNonNullAssertion in QdrantAdapter.ts (hit.payload! -> hit.payload ?? {})
- Migrated biome.json from v1 to v2 schema format
CI installs @biomejs/biome ^1.9.4 which uses the v1 configuration schema.
The v2 schema (auto-migrated by local npx biome 2.4.13) is incompatible.
The tsconfig.typecheck.json path aliases now catch unknown-type errors
from JSON.parse that were previously hidden by per-package typecheck.
Record<string, unknown> still yields unknown on property access.
Use any with biome-ignore since it's a test response fixture.
Packages with self-imports resolve via exports→dist/ which needs tsup output.
deploy-staging, deploy-production, and publish jobs used job-level if:
conditions that skip on PR branches, cluttering the checks list with
skipped statuses. These belong in release.yml, not ci.yml.
@reaatech reaatech merged commit b233959 into main Apr 30, 2026
18 checks passed
@reaatech reaatech deleted the dev branch April 30, 2026 13:17
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

1 participant