graphddb 0.2.5 → 0.3.1

package/README.md

@@ -657,7 +657,12 @@ Relation traversal は、Entity 上に定義されたアクセスパスのみを
   （`entityWrites`: 参照整合性、一意性、edge effect、派生カウンタ、outbox event、冪等性）を
   一度宣言すると、`mutation` が1つ以上の write fragment を合成し、コンパイラがそれらを単一の
   atomic な `TransactWriteItems` にマージする。すべての書き込みパスは1つの共有された
-  `commitTransaction` オーケストレーションを経由する。
+  `commitTransaction` オーケストレーションを経由する。**リレーション維持アクセスパス**
+  （Epic #118）はこれを拡張する: リレーションの `write.maintainedOn` やスカラ `@aggregate`
+  フィールドが、source エンティティのライフサイクルに同期して *別の* 行を維持する —— 射影された
+  **snapshot**（`SET`）、上限付き **collection**（`list_append`）、スカラ **counter**
+  （`@aggregate` `count()` → atomic `ADD ±1`）—— を source write と同一の atomic transaction に
+  合成する（[aggregate-counter](./examples/aggregate-counter/) 例を参照）。
 - **[Opt-in class hydration](./docs/class-hydration.md)** —— `options.hydrate` ファクトリを
   渡すと、read 結果をデフォルトの Typed Plain Object ではなく、ホスト言語のドメインオブジェクトに
   ロードできる。ホスト専用で、bridge SSoT にシリアライズされることはない。Phase 1
@@ -675,6 +680,7 @@ Relation traversal は、Entity 上に定義されたアクセスパスのみを
 | ドキュメント | 内容 |
 |----------|-------------|
 | [Specification](./docs/spec.md) | コア API: entity、structured keys/GSIs、query/filter、relation、batch/transaction、design rule、runtime の挙動。 |
+| [Design patterns](./docs/design-patterns.md) | DynamoDB の代表的な 10 設計パターン（RFC #118 §1）を graphddb の機能にマッピング: same-partition / embedded snapshot / edge / materialized view / sparse view / aggregate counter / versioned / reverse lookup / external projection。各パターンの用途・宣言方法（`pattern` / `defineView` / `defineVersioned` / `defineProjection` / `@aggregate`）・read & write 維持の挙動・Phase 別の対応状況。 |
 | [CQRS contract layer](./docs/cqrs-contract.md) | public な Query/Command contract、cardinality matrix、N+1 安全性、contract をまたぐ合成、context 境界。 |
 | [Mutation → command derivation](./docs/mutation-command-derivation.md) | Command IF の背後にある内部的な write-plan 合成 DSL: モデルの write セマンティクス（`entityWrites`）、fragment 合成、atomic な `TransactWriteItems` の導出。 |
 | [Class hydration](./docs/class-hydration.md) | read 結果をホスト言語のオブジェクトにロードする opt-in な `options.hydrate` ファクトリ（Phase 1: `query` トップレベル; Phase 2–3 は今後）。 |
@@ -689,6 +695,8 @@ Relation traversal は、Entity 上に定義されたアクセスパスのみを
 |---------|-------------|
 | [user-permissions](./examples/user-permissions/) | Single Table Design でユーザー・グループ・パーミッションを管理する。隣接リスト、転置インデックス、relation traversal、`explain` を含む。 |
 | [aggregate-tree-pattern](./examples/aggregate-tree-pattern/) | CDC emulator で駆動される差分的なツリー集計（`siteScoreAverage`）: dirty 伝播、throttle 付き sweep、再計算。 |
+| [embedded-snapshot-pattern](./examples/embedded-snapshot-pattern/) | リレーションを **維持アクセスパス** として扱う（Epic #118）: `pattern: 'embeddedSnapshot'` のリレーションが、source write と同一の atomic transaction で、非正規化された collection / snapshot を owner 行に同期維持する。 |
+| [aggregate-counter](./examples/aggregate-counter/) | RFC §5.2 の `@aggregate` **counter**: `ThreadPost.created`/`removed` のライフサイクルが、source write と同一の `TransactWriteItems` 内で atomic な `ADD ±1` により `ThreadCounter.postCount` を同期維持する。 |
 
 ## ✨ Features
 
@@ -703,6 +711,7 @@ Relation traversal は、Entity 上に定義されたアクセスパスのみを
 - 構造化 segment キー（`k` タグ）: partial key は segment 境界で `begins_with` にコンパイルされる
 - 説明可能な実行計画
 - Relation（hasMany, belongsTo, hasOne, depth 制限, traversal）
+- 維持アクセスパス（Epic #118）: `pattern: 'embeddedSnapshot'` のリレーションが非正規化された collection / 単一行 snapshot を owner 行に同期維持し、`@aggregate` `count()` カウンタが atomic な `ADD ±1` で同期する。いずれも source write の atomic transaction に合成される（`maintainedOn` cross-entity トリガ、関数形 `projection`）。同期（`updateMode: 'mutation'`）の維持は TS / Python 両方で動作（conformance 検証済み）。stream / trim / `max()` / `materializedView` / `sparseView` は後続フェーズ
 - BatchGet 最適化
 - 並列 relation 実行（独立したサブクエリ、BatchGet チャンク、ネストした解決を上限付きの
   並列度で同時にディスパッチ）