@nanobpm/urban 0.77.4 → 0.79.0

package/src/runtime/index.ts

@@ -214,7 +214,100 @@ export type {
   LineageStoreOptions,
 } from "./core/modules/lineage-store.ts";
 
-// Phase — the framework-level *domain phase* primitive (issue #266): derive "which phase is this
+// ─────────────────────────────────────────── Read models ────────────────────────────────────────
+// The declare-once, compile-to-both derived read-model primitive (ADR 0065): a closed expression DSL
+// (`col`/`lit`/comparisons/`and`/`or`/`not`/`caseWhen`/`exists`) declared ONCE via `defineReadModel`,
+// compiled to BOTH a SQLite VIEW select-list (`compileToSqlSelect`) and an in-process TS function
+// (`compileToFn`) from the SAME AST, plus the framework-derived managed VIEW DDL and the parity guard
+// that replaces per-projection hand-written parity tests.
+//
+// SIBLING REGISTRATION POINTS (ADR 0065 rollout — see core/read-model.ts for the full seam docs):
+//   • `readModelRegistry`  — register a `defineReadModel(...)` result; the boot path (core/modules/
+//     workers.ts) applies its managed VIEW. The `writer-source-inversion` task registers here.
+//   • `projectionRegistry` — register a canonical engine-truth projection NAME usable in `exists(...)`.
+//     The `canonical-projections` task registers `urban_open_user_tasks` / `urban_instance_state`.
+export {
+  and,
+  assertReadModelParity,
+  assertSqlIdentifier,
+  caseWhen,
+  col,
+  compileToFn,
+  compileToSqlSelect,
+  defineReadModel,
+  deriveReadModelViewDdl,
+  eq,
+  exists,
+  gt,
+  gte,
+  lit,
+  lt,
+  lte,
+  neq,
+  not,
+  or,
+  pcol,
+  ProjectionRegistry,
+  projectionRegistry,
+  ReadModelRegistry,
+  readModelRegistry,
+  when,
+} from "./core/read-model.ts";
+export type {
+  AndExpr,
+  BaseRow,
+  CaseExpr,
+  ColExpr,
+  CompareExpr,
+  CompareOp,
+  DerivationFn,
+  ExistsExpr,
+  Expr,
+  Literal,
+  LitExpr,
+  NotExpr,
+  OrExpr,
+  ParityDb,
+  ParityOptions,
+  ParitySample,
+  ProjColExpr,
+  ProjectionRows,
+  ProjectionSource,
+  ReadModel,
+  ReadModelDecl,
+  SqlCompileOptions,
+  WhenClause,
+} from "./core/read-model.ts";
+
+// Canonical engine-truth projection sidecars (ADR 0065, proposal point #1): two framework-owned,
+// per-source projections the DSL `exists(...)` derives over — `urban_open_user_tasks` (which instances
+// are parked on a human) and `urban_instance_state` (per-instance engine lifecycle state). Provisioned
+// next to the lineage sidecar in core/modules/workers.ts; registered into `projectionRegistry` under
+// their stable DSL names via `registerCanonicalProjections()`.
+export {
+  CANONICAL_PROJECTIONS,
+  registerCanonicalProjections,
+} from "./core/modules/canonical-projections.ts";
+export {
+  OPEN_USER_TASKS_PROJECTION,
+  OPEN_USER_TASKS_SCHEMA_SQL,
+  OPEN_USER_TASKS_TABLE,
+  OpenUserTasksStore,
+} from "./core/modules/open-user-tasks-store.ts";
+export type {
+  OpenUserTaskRow,
+  OpenUserTasksStoreOptions,
+} from "./core/modules/open-user-tasks-store.ts";
+export {
+  INSTANCE_STATE_PROJECTION,
+  INSTANCE_STATE_SCHEMA_SQL,
+  INSTANCE_STATE_TABLE,
+  InstanceStateStore,
+} from "./core/modules/instance-state-store.ts";
+export type {
+  InstanceStateRow,
+  InstanceStateStoreOptions,
+} from "./core/modules/instance-state-store.ts";
 // instance in?" from the BPMN scope hierarchy + write-provenance (Tier 0, zero declaration), an
 // optional `nano:phase` override (Tier 1), and a lineage rollup for the epic frontier (Tier 2).
 export {