Premain

[aron23]

This pull request introduces FaceTheory ISR (Incremental Static Regeneration) support to TableTheory, providing standardized cache metadata schemas, regeneration lease helpers, and documentation for idempotency and TTL patterns. The changes are aimed at enabling FaceTheory to implement SSG + ISR on AWS with strong correctness guarantees and minimal custom code. The update includes new documentation, model definitions for Go/TS/Python, and a detailed enablement roadmap.

FaceTheory ISR Enablement

• Added a comprehensive enablement roadmap for FaceTheory support, detailing milestones for cache schema guidance, lease/lock helpers, transactional update recipes, TTL-first cache patterns, and idempotency patterns in theorydb-facetheory-support-roadmap.md.

ISR Cache Schema and Patterns

• Documented the recommended DynamoDB schema for ISR cache metadata and regeneration locks, including partition/sort key design, metadata and lease item shapes, TTL strategy, transaction guidance, and runnable model definitions for Go, TypeScript, and Python in isr-cache-schema.md.
• Added documentation for TTL cache patterns and transaction recipes for ISR in the main docs index.

Idempotency and Regeneration Safety

• Provided guidance for request-id driven idempotency patterns to prevent duplicate work and stale overwrites during ISR, including recommended item shapes and safe orchestration of lock and idempotency records in isr-idempotency.md.

Planning and Roadmap Updates

• Linked the new FaceTheory support roadmap in the development planning docs for visibility and tracking.

Release and Changelog

• Bumped the prerelease version to 1.3.0-rc.1 and added a changelog entry summarizing new features (ISR support, lease helpers, transaction builder mocks) and bug fixes (security, transaction handling, CI improvements). (.release-please-manifest.premain.json, CHANGELOG.md) [1] [2]