pro-vi · pro-vi · Jun 21, 2026 · Jun 13, 2026 · Jun 13, 2026 · Jun 13, 2026
diff --git a/.github/workflows/release.yml b/.github/workflows/release.yml
@@ -87,15 +87,15 @@ jobs:
       - name: Prepare publish manifest
         run: |
           set -euo pipefail
-          cp README.md LICENSE publish/
+          cp README.md LICENSE TEXT_SOURCES.md publish/
           VERSION=$(node -p "require('./package.json').version")
           cat > publish/package.json <<EOF
           {
             "name": "@pro-vi/iching",
             "version": "$VERSION",
             "description": "A contemplative I Ching TUI for the terminal.",
             "bin": "./iching.js",
-            "files": ["iching.js", "README.md", "LICENSE"],
+            "files": ["iching.js", "README.md", "LICENSE", "TEXT_SOURCES.md"],
             "type": "module",
             "engines": { "node": ">=18", "bun": ">=1.0.0" },
             "keywords": ["iching", "i-ching", "yijing", "tui", "terminal", "divination", "node", "bun"],

diff --git a/README.md b/README.md
@@ -19,6 +19,10 @@ Set an intention. Cast a hexagram. Sit with what shows up.
   (大象傳, 彖傳), English image and judgment, and Wilhelm-inspired notes.
 - **Journal** every cast (with timestamp and intention) in
   append-only JSONL — your own divination history.
+- **Observe** quiet patterns over that history (`p` in the journal, or
+  `iching journal patterns`) — a field of all 64 lit by what you've drawn,
+  where movement falls, the yin/yang balance, the phase of day each was cast.
+  Observation, never prediction.
 - **Hook into LLMs** the assistant can read your cast for further interpretation.
 
 Raw ANSI, five hand-tuned themes (ink, bone, cinnabar, jade, river),
@@ -57,16 +61,42 @@ bun run build                # builds dist/iching for your platform
 iching                          # interactive TUI
 iching cast                     # one-shot cast (plain text)
 iching cast "should I ship?"    # with a question
+iching cast --bound "ship it?"  # bind the cast to the question and moment
 iching cast --json              # structured output
+iching today                    # today's reading (cast in the TUI)
+iching today --json             # full reading payload for scripts/assistants
 iching journal list             # recent readings
+iching journal list --hexagram 29   # readings where hexagram 29 appears
 iching journal show today       # today's reading
-iching hexagram 1               # look up hexagram by number
+iching journal note "..."       # attach a reflection note to the latest reading
+iching journal patterns         # quiet observation over every past reading
+iching journal patterns --since 2026-01-01 --until 2026-03-31  # bound it to one season
+iching journal patterns --json  # the same derivation, structured for scripts
+iching hexagram 1               # look up hexagram by number or name
+iching dict water               # open the dictionary on a search
 iching dict                     # browse all 64 in TUI
 iching config theme cinnabar    # set theme
 ```
 
-Press `c` to cast, `j` for journal, `d` for dictionary, `s` for
-settings, `q` to quit.
+Press `c` to cast, `t` to return to today's reading, `j` for journal,
+`d` for dictionary, `s` for settings, `q` to quit.
+
+### JSON for scripts and assistants
+
+`cast --json`, `today --json`, and `journal patterns --json` emit stable,
+self-describing payloads. In `journal patterns --json`, mind one contract
+(the output states it in a `basis` field): **descriptive counts tally every
+reading; chance figures live in `comparison` blocks computed only over the
+method-marked subset** (coin/yarrow casts, whose line probabilities are known —
+legacy entries have none). Never divide an all-readings `count` by an `expected`
+from a `comparison` block; use that block's own `count`/`expected`, which share
+a basis. (Every chance figure — including `topTrigrams` — lives in a
+`comparison` block over the method-marked subset; uniform trigram geometry
+still needs P(yang)=½, a property of the method, so it rests on the same basis
+as the rest.) One further basis: `timeOfDay` rests on the **timestamped**
+subset — its phase
+counts sum to `timeOfDay.timestamped`, not `total`, since readings without a
+recorded local hour are omitted rather than guessed.
 
 ## Storage
 
@@ -76,6 +106,7 @@ Files follow the [XDG Base Directory](https://specifications.freedesktop.org/bas
 |------|------|---------|
 | Cache | `~/.cache/iching/daily-cache.json` | Most recent cast |
 | Journal | `~/.local/state/iching/history.jsonl` | All casts |
+| Notes | `~/.local/state/iching/notes.jsonl` | Reflection notes (sidecar to the journal) |
 | Config | `~/.config/iching/config.json` | Theme, motion, glyph settings |
 
 Override with `ICHING_HOME` env var or `--data-dir` flag.
@@ -94,9 +125,10 @@ Bun workspace monorepo. Four packages:
 ## Development
 
 ```bash
-bun test          # run tests (382 tests, ~100ms)
+bun test          # run the test suite
 bun run typecheck # tsc --noEmit
-bun run smoke     # end-to-end smoke test
+bun run build     # compile the binary for your platform
+bun run smoke     # end-to-end smoke test of the built binary
 ```
 
 Vision notes and the current scope spec are mapped in

diff --git a/README.zh-CN.md b/README.zh-CN.md
@@ -18,6 +18,8 @@
   英译象辞与卦辞、以及卫礼贤风格的注解。
 - **日志** 自动记录每一次起卦（含时间戳与问意），
   以追加式 JSONL 保存 —— 你自己的卜筮史。
+- **观象** 对这段卜筮史作静观（日志中按 `p`，或 `iching journal patterns`）——
+  六十四卦之野依所占点亮、动爻所在、阴阳之衡。只是观照，从不预言。
 - **接入大语言模型**：助手可读取你的卦象作进一步释义。
 
 原始 ANSI 渲染、五种手调主题（ink、bone、cinnabar、jade、river）、
@@ -56,15 +58,32 @@ bun run build                # 为当前平台构建 dist/iching
 iching                          # 进入交互式 TUI
 iching cast                     # 一次性起卦（纯文本）
 iching cast "该不该上线？"       # 带问意起卦
+iching cast --bound "该不该上线？"  # 将此卦与问意及当下时刻绑定
 iching cast --json              # 结构化输出
+iching today                    # 今日卦象（在 TUI 中起卦）
+iching today --json             # 供脚本与助手读取的完整卦象数据
 iching journal list             # 近期记录
+iching journal list --hexagram 29   # 筛选出现第 29 卦的记录
 iching journal show today       # 今日卦象
-iching hexagram 1               # 按卦序查阅
+iching journal note "……"        # 给最近一卦附上注记
+iching journal patterns         # 观象：对历来卦记的静观
+iching journal patterns --json  # 同一推演，结构化输出供脚本读取
+iching hexagram 1               # 按卦序或卦名查阅
+iching dict water               # 以检索词打开卦典
 iching dict                     # 在 TUI 中浏览六十四卦
 iching config theme cinnabar    # 设置主题
 ```
 
-按 `c` 起卦，`j` 查日志，`d` 查卦典，`s` 设置，`q` 退出。
+按 `c` 起卦，`t` 回看今日，`j` 查日志，`d` 查卦典，`s` 设置，`q` 退出。
+
+### 供脚本与助手的 JSON
+
+`cast --json`、`today --json` 与 `journal patterns --json` 输出稳定且自描述的结构。
+`journal patterns --json` 有一条约定（输出中以 `basis` 字段写明）：**描述性计数统计所有卦记；
+理数（chance）数值则置于 `comparison` 块内，只就已注法的子集计算**（铜钱／蓍草占法，其爻变概率已知——
+旧占记没有）。切勿用全量的 `count` 去除以某个 `comparison` 块里的 `expected`；应取该块自带的
+`count`／`expected`，二者同基。（`topTrigrams.expected` 是唯一在 `comparison` 块之外的 `expected`——
+属无关占法的几何期望，与其 `count` 同为全量基准。）
 
 ## 数据存储
 
@@ -74,6 +93,7 @@ iching config theme cinnabar    # 设置主题
 |------|------|------|
 | 缓存 | `~/.cache/iching/daily-cache.json` | 最近一卦 |
 | 日志 | `~/.local/state/iching/history.jsonl` | 全部卦象 |
+| 注记 | `~/.local/state/iching/notes.jsonl` | 回看注记（日志的伴生文件） |
 | 配置 | `~/.config/iching/config.json` | 主题、动画、字符设置 |
 
 可用 `ICHING_HOME` 环境变量或 `--data-dir` 参数覆盖。
@@ -92,9 +112,10 @@ Bun 工作区单仓多包。共四个包：
 ## 开发
 
 ```bash
-bun test          # 运行测试（382 项，约 100ms）
+bun test          # 运行测试
 bun run typecheck # tsc --noEmit
-bun run smoke     # 端到端冒烟测试
+bun run build     # 构建当前平台的二进制
+bun run smoke     # 对构建产物做端到端冒烟测试
 ```
 
 ## 缘起

diff --git a/SPEC.md b/SPEC.md
@@ -8,6 +8,8 @@ document in the repository.
 `iching` is a local-first terminal I Ching application:
 
 - one-shot CLI commands for casting, journal, config, paths, doctor, and lookup
+- a daily-reading anchor: the day's cast is cached and recallable without
+  recasting (`iching today`, TUI `t`)
 - fullscreen TUI for daily casting, journal review, settings, and dictionary
 - pure domain package for casts, derivations, search, and hexagram data
 - JSON/JSONL storage using XDG-compatible local paths
@@ -24,34 +26,20 @@ old checkbox.
 |---|---|---|
 | Workspace monorepo | Implemented | `apps/cli`, `packages/core`, `packages/storage`, `packages/terminal` |
 | Core domain | Implemented | casting, derivation, lookup, detail, search, formatters, exhaustive tests |
-| Storage | Implemented | paths, JSON/JSONL stores, config store, legacy discovery, atomic-write tests |
-| CLI commands | Implemented | `cast`, `journal`, `hexagram`, `config`, `paths`, `doctor`, `dict` |
+| Storage | Implemented | paths, JSON/JSONL stores, config store, atomic-write tests |
+| CLI commands | Implemented | `cast`, `today`, `journal`, `hexagram`, `config`, `paths`, `doctor`, `dict` |
 | Terminal primitives | Implemented | cell buffer, diff renderer, ANSI, key parser, raw input, session lifecycle |
 | Animation engine | Implemented | timeline DSL, runner, easing, presets, scene loop |
 | Casting scenes | Implemented | cast scene, coin/line/morph/reveal renderers, timeline builder |
 | TUI dictionary | Implemented | browse model/scene, detail model/scene, dictionary command, scene routing |
 | Large glyph support | Implemented | glyph data, glyph animation modes, cast/detail integration |
 | Yarrow casting | Implemented (2026-05-30) | `core/casting/yarrow.ts`, `YarrowScene` auto, `YarrowManualScene` 18-cut full-manual, ritual-chrome parity with coin |
 | Distribution | Infrastructure present | build script, smoke script, CI workflow, release workflow |
-| Entropy source evolution | Planned | see `docs/vision/entropy-sources-vision.md` |
+| Entropy binding (`bound`) | Implemented (2026-06-10) | `core/random.ts` `BoundRandomSource` (SHA-256 length-prefixed binding of fresh crypto bytes + intention + timestamp + process nonce, hash-counter DRBG); `entropy` config key (default `crypto`); `cast --bound`; `rng` provenance on journal/cache/`cast --json`; Settings row; `bound-random.test.ts` |
+| Entropy source evolution | In progress | `bound` shipped (row above); `embodied` and `quantum-remote` remain planned — see `docs/vision/entropy-sources-vision.md` |
 
 ## Active Product Questions
 
-### Entropy Binding
-
-Next likely scope: add a `bound` entropy path that mixes local crypto entropy
-with intention/session context.
-
-Constraints:
-
-- keep `crypto` as the default
-- use intention as salt/context, never as the sole seed
-- preserve explicit deterministic `--seed`
-- record provenance in JSON and journal output if the source becomes user-visible
-- do not add network entropy in this step
-
-Source: [Entropy Sources Vision](docs/vision/entropy-sources-vision.md).
-
 ### Embodied Entropy
 
 Future scope: collect local timing/jitter during an existing ritual window and

diff --git a/TEXT_SOURCES.md b/TEXT_SOURCES.md
@@ -0,0 +1,42 @@
+# Text Sources & Attribution
+
+`@pro-vi/iching` bundles several layers of I Ching text. This file records each
+source, its rights status, and what the project's MIT license does and does not
+cover.
+
+## Classical Chinese (public domain)
+
+The hexagram judgments (卦辭), line statements (爻辭), the 小象傳, and the
+序卦傳 / 雜卦傳 belong to the ancient *Zhouyi* / *Yijing* corpus. The Chinese
+source text is in the public domain.
+
+## English — Legge (`gcEn`, public domain)
+
+The `gcEn` judgment field is the English translation by **James Legge**,
+*The Yî King* (Sacred Books of the East, Vol. XVI; Oxford, 1882, rev. 1899).
+Legge's translation is in the public domain.
+
+## English — Wilhelm register (`gcEnW`, `yaoEn`) — original interpretive text
+
+The displayed English judgments (`gcEnW`) and line readings (`yaoEn`) are
+**original interpretive renderings** written for this project in the
+Wilhelm–Baynes *register* (cadence and vocabulary), **distilled from
+public-domain sources** — the classical Chinese 卦辭 / 爻辭, Legge's translation,
+and the 彖傳 / 小象傳 commentaries.
+
+They are **not quotations of, and are not derived from, the copyrighted
+Richard Wilhelm / Cary F. Baynes English translation** (*The I Ching or Book of
+Changes*, Bollingen Series XIX; 1950, rev. 1967), which remains under copyright.
+This is the project's standing **AC-010** policy: ship original wording from
+public-domain sources, never licensed third-party translation text.
+
+If you believe any specific string reproduces protected expression, please open
+an issue and it will be revised.
+
+## License scope
+
+The project's [MIT LICENSE](./LICENSE) covers the project's **code** and its
+**original textual material** (including the `gcEnW` / `yaoEn` renderings). It
+does **not** purport to grant rights in any third-party text. The classical
+Chinese source and Legge's translation are in the public domain; no third-party
+copyrighted translation is included.
diff --git a/apps/cli/package.json b/apps/cli/package.json
@@ -1,6 +1,6 @@
 {
   "name": "@iching/cli",
-  "version": "0.2.0",
+  "version": "0.5.0",
   "private": true,
   "type": "module",
   "exports": {