hikoutei 0.5.13 → 0.5.15

package/README.ja.md

@@ -206,15 +206,46 @@ MikroORM は実装の詳細であり、Hikoutei の公開エンティティ API
 
 ## プロジェクトステータス
 
-Hikoutei は活発に開発中です。エンティティ API は利用可能ですが、シート編集の
-取り込みと競合表示はまだ発展途上です。マイナーバージョンのアップグレード前に
-リリースノートを確認してください。
+Hikoutei は活発に開発中です。現在の EntityManager は、スカラーエンティティの
+ライフサイクル操作、等価条件を使う `find()` / `findOne()`、`find()` の
+`limit` / `offset` ページネーション、コールバック形式の `transactional()` を
+サポートします。通常の読み取り元は常に SQLite であり、Google Sheets では
+ありません。
+シート編集の取り込みと競合表示はまだ発展途上です。マイナーバージョンの
+アップグレード前にリリースノートを確認してください。
 
 ## ロードマップ
 
+EntityManager のロードマップは、以下の実装順序に従います。段階の順序は確定
+していますが、日付やリリース番号は約束しません。
+
+1. **豊富なローカル読み取り**
+   - Hikoutei 独自の型付きクエリ契約に、明示的な `eq`、`ne`、`gt`、
+     `gte`、`lt`、`lte`、`in`、`nin`、`like` 条件と `orderBy`、
+     `count()`、`findAndCount()` を追加します。
+   - MikroORM のクエリ型を公開せず、これらを既存の `limit` / `offset`
+     ページネーションと組み合わせます。
+2. **ライフサイクル安全な書き込み**
+   - `upsert` と direct/bulk mutation 機能は、エンティティテーブル、
+     canonical state、永続的な Sheet effect outbox を 1 つの SQLite
+     トランザクションで処理する Hikoutei 独自の契約を通じてのみ追加します。
+   - この原子的なライフサイクルを迂回し得る、生の `nativeInsert`、
+     `nativeUpdate`、`nativeDelete`、または SQL パススルー API は約束しません。
+3. **リレーションとロード**
+   - many-to-one、one-to-many、`populate()` 機能を追加します。
+   - 公開前に、リレーションの SQLite マッピング、Sheets プロジェクション
+     表現、スキーマ動作、競合セマンティクスを一体として設計します。
+4. **スキーマ運用**
+   - マイグレーションとスキーマドリフト管理を追加します。
+   - 検証と運用フローを既存のセットアップツールと統合します。
+
+### 同期と運用
+
+以下の作業は EntityManager の各段階と並行して進めます。
+
 - Google Sheets からの意図的なユーザー編集の取り込みを完了する
 - 更新・削除の競合処理と表示を改善する
-- レジストリと直接 provider デプロイのセットアップツールを追加する
+- レジストリと direct-provider デプロイのセットアップツールを改善する
 
 現在の作業は[オープンな Issues](https://github.com/ManddarinShop/Hikoutei/issues)を
 参照してください。

package/README.ko.md

@@ -201,15 +201,44 @@ MikroORM은 구현 세부 사항이며 Hikoutei의 공개 엔티티 API에는
 
 ## 프로젝트 상태
 
-Hikoutei는 활발히 개발 중입니다. 엔티티 API는 사용 가능하지만, 시트 편집
-수집과 충돌 표시는 아직 발전 중입니다. 마이너 버전 업그레이드 전에 릴리스
-노트를 확인하세요.
+Hikoutei는 활발히 개발 중입니다. 현재 EntityManager는 스칼라 엔티티의 생명주기
+작업, 동등 조건을 사용하는 `find()` / `findOne()`, `find()`의 `limit` /
+`offset` 페이지네이션, 콜백형 `transactional()`을 지원합니다. 일반 읽기는
+Google Sheets가 아니라 항상 SQLite에서 수행됩니다. 시트 편집 수집과 충돌 표시는
+아직 발전 중입니다. 마이너 버전 업그레이드 전에 릴리스 노트를 확인하세요.
 
 ## 로드맵
 
+EntityManager 로드맵은 아래 구현 순서를 따릅니다. 단계 순서는 확정되어 있지만,
+일정이나 릴리스 번호는 약속하지 않습니다.
+
+1. **풍부한 로컬 읽기**
+   - Hikoutei가 정의한 타입 쿼리 계약에 명시적 `eq`, `ne`, `gt`, `gte`,
+     `lt`, `lte`, `in`, `nin`, `like` 조건과 `orderBy`, `count()`,
+     `findAndCount()`를 추가합니다.
+   - MikroORM 쿼리 타입을 노출하지 않고 이 기능들을 기존 `limit` / `offset`
+     페이지네이션과 조합합니다.
+2. **생명주기 안전 쓰기**
+   - `upsert`와 direct/bulk mutation 기능은 엔티티 테이블, canonical state,
+     내구성 있는 Sheet effect outbox를 하나의 SQLite 트랜잭션에서 처리하는
+     Hikoutei 정의 계약을 통해서만 추가합니다.
+   - 이 원자적 생명주기를 우회할 수 있는 원시 `nativeInsert`, `nativeUpdate`,
+     `nativeDelete` 또는 SQL 패스스루 API는 약속하지 않습니다.
+3. **관계와 로딩**
+   - many-to-one, one-to-many, `populate()` 기능을 추가합니다.
+   - 공개 전에 관계의 SQLite 매핑, Sheets 프로젝션 표현, 스키마 동작, 충돌
+     의미론을 함께 설계합니다.
+4. **스키마 운영**
+   - 마이그레이션과 스키마 드리프트 관리를 추가합니다.
+   - 검증 및 운영 흐름을 기존 설정 도구와 통합합니다.
+
+### 동기화 및 운영
+
+다음 작업은 EntityManager 단계와 병행합니다.
+
 - Google Sheets에서 의도적인 사용자 편집 수집 완성
 - 업데이트·삭제 충돌 처리와 표시 개선
-- 레지스트리 및 직접 provider 배포를 위한 설정 도구 추가
+- 레지스트리 및 direct-provider 배포를 위한 설정 도구 개선
 
 현재 작업은 [오픈 이슈](https://github.com/ManddarinShop/Hikoutei/issues)를
 참고하세요.

package/README.md

@@ -212,15 +212,47 @@ entity API.
 
 ## Project status
 
-Hikoutei is in active development. The entity API is usable, while Sheet edit
-ingestion and conflict presentation are still evolving. Review release notes
-before upgrading minor versions.
+Hikoutei is in active development. The current EntityManager supports scalar
+entity lifecycle operations, equality-filtered `find()` / `findOne()`,
+`limit` / `offset` pagination on `find()`, and callback-style
+`transactional()` work.
+Normal reads always come from SQLite, never Google Sheets. Sheet edit ingestion
+and conflict presentation are still evolving. Review release notes before
+upgrading minor versions.
 
 ## Roadmap
 
+The EntityManager roadmap follows the implementation order below. The sequence
+is committed, but no milestone is tied to a date or release number.
+
+1. **Rich local reads**
+   - Add a Hikoutei-owned typed query contract for explicit `eq`, `ne`, `gt`,
+     `gte`, `lt`, `lte`, `in`, `nin`, and `like` conditions, plus `orderBy`,
+     `count()`, and `findAndCount()`.
+   - Compose these capabilities with the existing `limit` / `offset`
+     pagination without exposing MikroORM query types.
+2. **Lifecycle-safe writes**
+   - Add `upsert` and direct/bulk mutation capabilities only through a
+     Hikoutei-owned contract that preserves one SQLite transaction across the
+     entity table, canonical state, and durable Sheet effect outbox.
+   - Do not promise raw `nativeInsert`, `nativeUpdate`, `nativeDelete`, or SQL
+     pass-through APIs that could bypass that atomic lifecycle.
+3. **Relationships and loading**
+   - Add many-to-one, one-to-many, and `populate()` capabilities.
+   - Design SQLite relationship mapping, Sheets projection representation,
+     schema behavior, and conflict semantics together before public release.
+4. **Schema operations**
+   - Add migration and schema drift management.
+   - Integrate validation and operational workflows with the existing setup
+     tooling.
+
+### Synchronization and operations
+
+The following work continues in parallel with the EntityManager milestones:
+
 - Complete ingestion of intentional user edits from Google Sheets.
 - Improve update/delete conflict handling and presentation.
-- Add setup tooling for registry and direct provider deployment.
+- Improve setup tooling for registry and direct-provider deployment.
 
 See the [open issues](https://github.com/ManddarinShop/Hikoutei/issues)
 for current work.

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "hikoutei",
-  "version": "0.5.13",
+  "version": "0.5.15",
   "description": "Typed repository and safe write layer for Google Sheets-backed MVPs. SQLite-authoritative entity lifecycle with asynchronous Google Sheets projection.",
   "repository": {
     "type": "git",