Promote CCC to top-level Sourced namespace

.gitignore

@@ -6,3 +6,5 @@ logs/
 pkg
 .DS_Store
 .claude
+bench/
+

CHANGELOG.md

@@ -1,5 +1,63 @@
 ## [Unreleased]
 
+### Changed
+
+- `Sourced::Store::MessageCodec` is now a subclass of `Sourced::Message::JSONCodec`, which
+  lives in the **sourced-message** gem and is shared with Sidereal. It keeps its
+  payload-only behaviour by overriding three private seams, and gains a per-class pair
+  cache, `compiled?`, `recompile!`, `.reset!` and `.clear_pairs!`.
+- `#encode_payload` is now `#encode` (the base class's name; it still encodes only the
+  payload and still returns `nil` for a message declared without one).
+- `#compile!` is idempotent — call `#recompile!` to pick up message types or encoders
+  registered since the last compile.
+- Encoding or decoding an uncompiled type raises
+  `Sourced::Message::JSONCodec::UnregisteredTypeError` instead of `Plumb::Codec::NoEntryError`.
+- `EncodeError` / `DecodeError` now descend from `StandardError` rather than
+  `Sourced::Error`. `Store::MessageCodec::EncodeError` still resolves, by inheritance.
+
+### Added
+
+- **Message codecs.** Messages are declared with native Ruby types (`Date`, `Time`,
+  `Symbol`, `BigDecimal`, `URI`, `Range`, …) and `Plumb::Codec::JSON` translates them to
+  and from the store's JSON columns. Apps register encoders for their own value types
+  directly on it (`Plumb::Codec::JSON.encoder MoneyEncoder`), before `Sourced.setup!`.
+- `Sourced::Store::MessageCodec` — the SQLite store's serializer, namespaced under and
+  owned by it. It registers each message class's payload type in a Plumb codec instance
+  keyed by message type string, built and frozen at `setup!`; the
+  envelope is the store's own business. The format is global and needs no configuring; a
+  future store with a different layout owns a different serializer, or none. A message
+  type the store can't persist raises `Plumb::TypeError` at `setup!` — the app fails to
+  boot rather than raising on the first append.
+- `Sourced::Types::JSONData` — any JSON value, recursively — for payload attributes
+  whose shape isn't known up front.
+
+### Fixed
+
+- `Date` and `Time` payload attributes never round-tripped through the store: they
+  were written via `#to_s` and read back as Strings, producing invalid messages. This
+  affected `DurableWorkflow`'s `WaitStarted#at`.
+- Scheduled messages recorded `scheduled_at` metadata via `Time#to_s` rather than ISO 8601.
+- A message's `created_at` was stored at whole-second precision in the log while the
+  scheduled-message blob kept microseconds. Both now come from the encoded message, at
+  microsecond precision.
+
+### Changed
+
+- `Configuration::StoreInterface` requires `setup!` instead of `install!` / `installed?`.
+  A store prepares itself however it needs to at boot; creating tables is one store's
+  answer, not the contract. `Sourced::Store#setup!` creates its tables and compiles its
+  serializer; `install!` / `installed?` remain public for scripts and tests.
+
+- Reading a message whose stored payload no longer satisfies its schema raises
+  `Sourced::Store::MessageCodec::DecodeError` instead of silently producing an invalid
+  message. Appending an invalid message raises `Store::MessageCodec::EncodeError`.
+- Reading a message whose type isn't registered raises
+  `Sourced::Message::UnknownMessageError` instead of returning a base
+  `Sourced::Message` with its payload silently dropped.
+- `DurableWorkflow` workflow context and step outputs are typed `Types::JSONData`
+  rather than `Types::Any`: values must be JSON-native, checked at append time
+  rather than silently coerced to Strings on the way back out.
+
 ## [0.1.0] - 2024-09-27
 
 - Initial release

Gemfile

@@ -14,8 +14,6 @@ group :development do
 end
 
 group :test do
-  gem 'dotenv'
-  gem 'pg'
   gem 'rspec', '~> 3.0'
   gem 'sequel'
   gem 'sqlite3'

Gemfile.lock

@@ -11,7 +11,10 @@ PATH
   specs:
     sourced (0.0.1)
       async
-      plumb (>= 0.0.17)
+      plumb (= 0.2.0.beta.2)
+      sequel
+      sourced-message
+      sqlite3
 
 GEM
   remote: https://rubygems.org/
@@ -23,8 +26,8 @@ GEM
       io-event (~> 1.11)
       metrics (~> 0.12)
       traces (~> 0.18)
-    bigdecimal (3.1.8)
-    concurrent-ruby (1.3.4)
+    bigdecimal (4.1.2)
+    concurrent-ruby (1.3.8)
     console (1.34.3)
       fiber-annotation
       fiber-local (~> 1.1)
@@ -33,11 +36,15 @@ GEM
       irb (~> 1.10)
       reline (>= 0.3.8)
     diff-lcs (1.5.1)
-    dotenv (3.1.4)
+    et-orbi (1.4.1)
+      tzinfo
     fiber-annotation (0.2.0)
     fiber-local (1.1.0)
       fiber-storage
     fiber-storage (1.0.1)
+    fugit (1.13.0)
+      et-orbi (~> 1.4)
+      raabro (~> 1.4)
     io-console (0.7.2)
     io-event (1.14.2)
     irb (1.14.0)
@@ -57,12 +64,12 @@ GEM
     parser (3.3.7.1)
       ast (~> 2.4.1)
       racc
-    pg (1.5.8)
-    plumb (0.0.17)
+    plumb (0.2.0.beta.2)
       bigdecimal
       concurrent-ruby
     psych (5.1.2)
       stringio
+    raabro (1.5.0)
     racc (1.8.1)
     rainbow (3.1.1)
     rake (13.2.1)
@@ -101,27 +108,31 @@ GEM
     ruby-progressbar (1.13.0)
     sequel (5.84.0)
       bigdecimal
+    sourced-message (0.2.1)
+      fugit
+      plumb (= 0.2.0.beta.2)
     sqlite3 (2.8.0)
       mini_portile2 (~> 2.8.0)
     sqlite3 (2.8.0-arm64-darwin)
     stringio (3.2.0)
     timecop (0.9.10)
     traces (0.18.2)
+    tzinfo (2.0.6)
+      concurrent-ruby (~> 1.0)
     unicode-display_width (3.1.4)
       unicode-emoji (~> 4.0, >= 4.0.4)
     unicode-emoji (4.2.0)
 
 PLATFORMS
   arm64-darwin-23
   arm64-darwin-24
+  arm64-darwin-25
   x86_64-linux
 
 DEPENDENCIES
   debug
   docco!
-  dotenv
   logger
-  pg
   rake (~> 13.0)
   rspec (~> 3.0)
   rubocop