Roadmap: continue Arc for TypeScript parity and integrations #114

Where Arc for TypeScript (and the Chronicle.TypeScript work it depends on) stands, what is in flight, and how to continue. Each item links to the issue that holds its details.

Recently released

Arc.TypeScript (GitHub prereleases; npm publication is still disabled):

• v0.44.0: PostgreSQL observation recovery (Recover PostgreSQL observation of Drizzle read models after a lost listener #125, closes Observe Drizzle read models across processes with PostgreSQL LISTEN/NOTIFY #92)
• v0.45.0: shutdown participants (Let integrations take part in shutdown before Arc disposes services #127)
• v0.45.1: service registry disposed when closing WebSockets throws synchronously (Dispose the service registry when closing WebSockets throws synchronously #129, Dispose the service registry when closing WebSockets fails synchronously #121)
• v0.46.0: scoped fallbacks for reactors and reducers (Register discovered reactors and reducers as scoped fallbacks #131)
• v0.47.0: protected read models released on raw MongoDB read paths (Release protected read models on raw MongoDB read paths #132, Release protected read models on raw MongoDB read paths #111)
• v0.48.0: preview scoped activation (Activate Chronicle reactors and reducers in Arc scopes (preview) #135)
• v0.49.0: delivery-store pinning (Pin Chronicle access to the delivery store in scoped activation #136)
• v0.50.0: caller-owned clients and a Chronicle 6.17 floor (Complete scoped activation of Chronicle reactors and reducers #137, closes Construct Chronicle reactors and reducers through Arc dependency injection #93)

Earlier: v0.40.0 through v0.43.0 (runInScope, PostgreSQL LISTEN/NOTIFY observation, co-located vertical slices, projection-backed given events).

Also merged without a release: AI corpus update (#117), CI fix for pull requests with an empty diff (#138, #109), documentation correction (#139, #133). Closed #35.

Chronicle.TypeScript (npm on merge), for #129 (EventScenario and ReactorScenario):

• Update the shared Cratis AI corpus to Cratis/AI e7dc6fe #142 increment 4: unique constraints in kernel-free scenarios
• Update the shared Cratis AI corpus #143 key domain (5.0/5.1)
• Store Chronicle read models in the collection Arc reads them from #144 replacement and removal (5.2)
• Update the shared Cratis AI corpus to Cratis/AI cc84741 #145 unique event-type cycles (5.3)
• Update the shared Cratis AI corpus #146 composite and case-insensitive keys (5.4)
• Verify that pull request descriptions are publishable release notes #147 deterministic 403 retry spec (fixes flaky auth spec, Docs overstate which Chronicle artifacts discovered before withChronicle are picked up #133)
• Align metric names and scope version with the .NET Arc #148 explicit child key for the child-type form of @childrenFrom (Let integrations take part in shutdown before Arc disposes services #127)

In flight

• Make React hooks in generated proxies opt-in #112 opt-out React hooks in generated proxies
• Map external types and packages in generated proxies #113 external type and package mappings in generated proxies (decision: Decide how far the source proxy generator grows toward the .NET generator #50)

Next

Arc parity and integrations:

• Decide whether activateArtifactsInScopes should be on by default
• Decide how far the source proxy generator grows toward the .NET generator #50, Decide whether validators take command read models as constructor parameters #51, Decide which identity-provider integrations come next #52 open decisions
• Composite unique constraints collide when a component contains the separator Chronicle#4131 composite key collisions (kernel)

Chronicle.TypeScript parity with the .NET client (umbrella Cratis/Chronicle.TypeScript#58):

• Dispose the service registry when closing WebSockets throws synchronously #129 part 5.5 scoped constraints: blocked on Testing: in-memory constraint storage drops constraint scopes Chronicle#4361
• Dispose the service registry when closing WebSockets throws synchronously #129 part 5.6 Unicode and numeric keys: needs an owner decision (Unicode case folding, numeric culture)
• Dispose the service registry when closing WebSockets throws synchronously #129 increments 6 (composition) and 7 (replay and redelivery)
• Evaluate projections in-process in ReadModelScenario Chronicle.TypeScript#106 projection evaluator: arithmetic, children, joins
• Prove unique constraints under concurrent appends against a kernel Chronicle.TypeScript#136 unique constraints under concurrent appends
• Test PII from append through release and erasure against a kernel Chronicle.TypeScript#137 PII from append through erasure
• Verify event type migrations when replaying older generations Chronicle.TypeScript#138 event type migrations on replay
• Add inbound webhook captures Chronicle.TypeScript#139 inbound webhook captures
• Cover the job not-replayable/not-active assertion and outbound webhook delivery against a kernel Chronicle.TypeScript#140 jobs and outbound webhooks against a kernel
• Add an ergonomic 'patterns at a moment' query over the facet-set API Chronicle.TypeScript#57 patterns at a moment

How the work is done

• One issue per change, assigned to its owner; one branch and worktree per change.
• Arc for .NET is the reference; its Documentation/http-contract.md is the wire contract. Parity is claimed per area only with a passing executable check.
• In-process test harnesses (Chronicle ReadModelScenario, EventScenario, ReactorScenario) support only behavior proven by a committed fixture from the pinned kernel oracle (yarn oracle:check); anything else is rejected with an explicit error pointing to a kernel-backed test.
• Every change is reviewed independently until it has no confirmed findings (cross-provider when available, otherwise a same-provider review that is stated as such), then local gates, then a PR with release notes in the repository template's sections.
• Local gates: run every step of the root package.json ci script. The Library e2e needs a working cratis/chronicle:latest-development image (recently unreliable locally); hosted CI always runs it.
• Merge with a merge commit only (gh pr merge --merge) once hosted CI is green; never squash, rebase or force-push. Minor and patch releases: gh release create vX.Y.Z --prerelease --target <merge commit>. No major release without an explicit human decision.
• Applications built on Arc for TypeScript keep a behavior's backend code, backend specs, generated proxy, React component and frontend specs in one slice folder (see Documentation/vertical-slices.md).

Open decisions for the maintainer

• Publish Arc for TypeScript to npm?
• Arc decisions 0002/0003.
• Unicode case folding and numeric culture for unique keys (Dispose the service registry when closing WebSockets throws synchronously #129 part 5.6).
• Whether to turn activateArtifactsInScopes on by default.
• Decide how far the source proxy generator grows toward the .NET generator #50, Decide whether validators take command read models as constructor parameters #51, Decide which identity-provider integrations come next #52.