apc-model-parser 0.1.0__tar.gz → 0.2.2__tar.gz

{apc_model_parser-0.1.0 → apc_model_parser-0.2.2}/AGENTS.md

@@ -22,8 +22,9 @@ ecosystem and must remain usable **standalone**.
 ```text
 authoring (ExprTk INI)  --parse-->  AST  --normalize-->  canonical IR (JSON)
                                                           |
-                                          emit julia  --> ModelingToolkit .jl
-                                          emit cpp    --> (planned) realtime C++
+                                          emit julia      --> ModelingToolkit .jl
+                                          emit julia-rhs  --> numerical f!/outputs! .jl
+                                          emit cpp        --> (planned) realtime C++
 ```
 
 ## Language
@@ -94,8 +95,8 @@ uv run mkdocs build --strict
 ### Pure logic vs. I/O separation
 
 **Pure modules** parse, normalize, validate, and lower — no filesystem,
-subprocess, or network access. Keep `ir/`, `frontends/`, `backends/`, and
-`validation/` pure and deterministic.
+subprocess, or network access. Keep `ir/`, `frontends/`, `backends/`,
+`semantic_diff.py`, and `validation/` pure and deterministic.
 
 **I/O modules** read/write files and implement the CLI. `io.py` and `cli.py` own
 filesystem access; the CLI must stay a thin shell over the pure functions.
@@ -133,7 +134,9 @@ never a serialized `System`. Generated Julia targets **MTK v11** idioms
 
 Re-running `parse`/`emit` on unchanged input must produce byte-identical output
 (stable ordering, stable number formatting). The content hash depends only on
-the semantic body.
+the semantic body. For `provenance.created_at`, when `SOURCE_DATE_EPOCH` is set
+(see reproducible-builds.org), the INI frontend uses that instant instead of the
+wall clock so regenerated IR JSON stays stable when semantics are unchanged.
 
 ### Status vocabulary and exit codes
 
@@ -149,7 +152,8 @@ CLI diagnostics use `OK` · `WARN` · `ERROR`. Exit codes:
 
 - Long options in kebab-case (`--from`, `--profile`, `--output`/`-o`).
 - The two core verbs are `parse` (authoring → IR) and `emit <target>` (IR →
-  view). Supporting commands: `validate`, `inspect`, `ast`, `schema`.
+  view). Supporting commands: `validate`, `inspect`, `diff`, `bump`, `ast`,
+  `schema`.
 - Breaking CLI changes require a SemVer bump and release notes.
 
 ## Scope guardrails
@@ -164,13 +168,16 @@ that *consume* the IR.
 If a change request conflicts with the design doc, stop and resolve via an
 explicit doc + ADR update — do not silently expand scope.
 
-## Work tracking (ADRs and issues)
+## Work tracking (ADRs, issues, and todos)
 
 - **ADRs:** numbered files under [`docs/decisions/`](docs/decisions/) (`NNNN-title.md`),
   indexed in [`docs/decisions/index.md`](docs/decisions/index.md). One decision per
   file; never delete — supersede with a newer ADR and update the index.
 - **Issues:** use GitHub issues for backlog items that are not yet an ADR; link
   ADRs from issue/PR text when a decision motivates the change.
+- **Todo briefs:** theme-sized notes under [`docs/todo/`](docs/todo/) (`index.md` +
+  one file per theme); promote into ADRs or design docs when behaviour is
+  decided. Not a substitute for issues or ADRs.
 - Prefer **small, reviewable slices** (one coherent feature, bugfix, or refactor
   per PR when practical). For larger work, split PRs and reference the same ADR
   or design section in each.
@@ -203,7 +210,7 @@ docs may stay in `julia/ModelParserJL/` README until unified.
 
 **Intended layout** (keep consistent with [`docs/design/model-parser.md`](docs/design/model-parser.md)):
 
-- `docs/index.md` or root `README.md` — overview, install (`uv`), quick `parse` /
+- `docs/index.md` or root `README.md` — overview, install (PyPI via `pipx` / `uv tool`, dev via `uv`), quick `parse` /
   `emit` examples (when expanded).
 - `docs/design/` — product spec (`model-parser.md`) and deep architecture notes.
 - `docs/decisions/` — ADRs (`NNNN-title.md`) + `index.md`.

{apc_model_parser-0.1.0 → apc_model_parser-0.2.2}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: apc-model-parser
-Version: 0.1.0
+Version: 0.2.2
 Summary: Convert process-model definitions to and from a canonical intermediate representation.
 Project-URL: Repository, https://github.com/Advanced-Process-Control/model-parser
 Author: Advanced Process Control
@@ -26,8 +26,9 @@ model script.
 ```text
 authoring (ExprTk INI)  --parse-->  AST  --normalize-->  canonical IR (JSON)
                                                           |
-                                          emit julia  --> ModelingToolkit .jl
-                                          emit cpp    --> (planned) realtime C++
+                                          emit julia      --> ModelingToolkit .jl
+                                          emit julia-rhs  --> numerical f!/outputs! .jl
+                                          emit cpp        --> (planned) realtime C++
 ```
 
 The IR is the single semantic contract. Adding a backend means writing one
@@ -50,7 +51,21 @@ in-memory, dynamic workflows. Both consume the *same* IR. See
 
 ## Install
 
-This project uses **[uv](https://docs.astral.sh/uv/)** for everything.
+### CLI from PyPI (end users)
+
+The package on PyPI is **`apc-model-parser`**; the installed command is **`model-parser`**.
+
+```bash
+pipx install apc-model-parser
+# or: uv tool install apc-model-parser
+model-parser --help
+```
+
+Use **`pipx`** or **`uv tool`** when you only need the CLI in an isolated environment.
+
+### From source (development)
+
+This repository uses **[uv](https://docs.astral.sh/uv/)** for environments and tasks.
 
 ```bash
 uv sync --all-groups    # include dev tools (ruff, pytest, mkdocs)
@@ -66,9 +81,14 @@ uv run model-parser parse examples/models/model_monod_simple.ini -o monod.ir.jso
 # 2. canonical IR  ->  ModelingToolkit (v11) Julia model
 uv run model-parser emit julia monod.ir.json -o monod.jl
 
+# 2a. canonical IR  ->  plain numerical ODE RHS (SciML-style f!)
+uv run model-parser emit julia-rhs monod.ir.json -o monod_rhs.jl
+
 # Supporting commands
 uv run model-parser validate monod.ir.json --profile julia-analysis
 uv run model-parser inspect  monod.ir.json
+uv run model-parser diff     monod.ir.json other.ir.json   # semantic IR diff
+uv run model-parser bump     monod.ir.json other.ir.json   # suggested SemVer bump
 uv run model-parser ast      examples/models/model_monod_simple.ini   # debug tree
 uv run model-parser schema   -o schemas/canonical-ir.schema.json      # export schema
 ```

{apc_model_parser-0.1.0 → apc_model_parser-0.2.2}/README.md

@@ -13,8 +13,9 @@ model script.
 ```text
 authoring (ExprTk INI)  --parse-->  AST  --normalize-->  canonical IR (JSON)
                                                           |
-                                          emit julia  --> ModelingToolkit .jl
-                                          emit cpp    --> (planned) realtime C++
+                                          emit julia      --> ModelingToolkit .jl
+                                          emit julia-rhs  --> numerical f!/outputs! .jl
+                                          emit cpp        --> (planned) realtime C++
 ```
 
 The IR is the single semantic contract. Adding a backend means writing one
@@ -37,7 +38,21 @@ in-memory, dynamic workflows. Both consume the *same* IR. See
 
 ## Install
 
-This project uses **[uv](https://docs.astral.sh/uv/)** for everything.
+### CLI from PyPI (end users)
+
+The package on PyPI is **`apc-model-parser`**; the installed command is **`model-parser`**.
+
+```bash
+pipx install apc-model-parser
+# or: uv tool install apc-model-parser
+model-parser --help
+```
+
+Use **`pipx`** or **`uv tool`** when you only need the CLI in an isolated environment.
+
+### From source (development)
+
+This repository uses **[uv](https://docs.astral.sh/uv/)** for environments and tasks.
 
 ```bash
 uv sync --all-groups    # include dev tools (ruff, pytest, mkdocs)
@@ -53,9 +68,14 @@ uv run model-parser parse examples/models/model_monod_simple.ini -o monod.ir.jso
 # 2. canonical IR  ->  ModelingToolkit (v11) Julia model
 uv run model-parser emit julia monod.ir.json -o monod.jl
 
+# 2a. canonical IR  ->  plain numerical ODE RHS (SciML-style f!)
+uv run model-parser emit julia-rhs monod.ir.json -o monod_rhs.jl
+
 # Supporting commands
 uv run model-parser validate monod.ir.json --profile julia-analysis
 uv run model-parser inspect  monod.ir.json
+uv run model-parser diff     monod.ir.json other.ir.json   # semantic IR diff
+uv run model-parser bump     monod.ir.json other.ir.json   # suggested SemVer bump
 uv run model-parser ast      examples/models/model_monod_simple.ini   # debug tree
 uv run model-parser schema   -o schemas/canonical-ir.schema.json      # export schema
 ```

apc_model_parser-0.2.2/docs/chatlogs/2026-06-01_docs-pipx-pypi-install.md

@@ -0,0 +1,62 @@
+---
+title: Document PyPI CLI install (pipx and uv tool)
+topic: docs-packaging
+date_added: 2026-06-01
+tags: [chatlogs]
+links:
+  - README.md
+  - docs/index.md
+  - docs/deployment/ci-cd.md
+  - AGENTS.md
+---
+
+## Commit helper
+
+- **SemVer / version bump:** **No bump** — documentation only; no change to the
+  published package API or CLI contract beyond how to install it.
+- **Tags / GitHub Release:** **None** — stack on `main`; releases remain tag-driven
+  when version/metadata changes warrant a new **`v*.*.*`**.
+- **Suggested commit message:** `docs: document pipx and uv tool install for apc-model-parser`
+- **Copy-paste git commands:**
+
+```bash
+git add README.md docs/index.md docs/deployment/ci-cd.md AGENTS.md \
+        docs/chatlogs/2026-06-01_docs-pipx-pypi-install.md
+git commit -m 'docs: document pipx and uv tool install for apc-model-parser'
+```
+
+- **Git order when tagging a release:** N/A this session.
+
+## How to try
+
+```bash
+pipx install apc-model-parser
+model-parser --help
+
+# Alternative (same CLI, different installer):
+# uv tool install apc-model-parser
+
+# Docs site (after deploy):
+# uv run mkdocs build --strict
+```
+
+## Session narrative
+
+**Goal.** After the first PyPI publish and manual **`v0.1.0`** tag, document that
+end users can install the CLI with **`pipx install apc-model-parser`**, not only
+**`uv tool install`**, while keeping **`apc-model-parser`** vs **`model-parser`**
+(dist name vs command) explicit.
+
+**Shipped surface.**
+
+- **`README.md`:** Install split into **CLI from PyPI** (`pipx` primary, `uv tool`
+  comment) and **from source** (`uv sync --all-groups`).
+- **`docs/index.md`:** Published site home — same dual path for PyPI installs;
+  short note that both are isolated env installs with `model-parser` on `PATH`.
+- **`docs/deployment/ci-cd.md`:** One line after the release job listing consumer
+  **`pipx`** / **`uv tool install`** post-publish.
+- **`AGENTS.md`:** Documentation layout bullet updated to mention PyPI install via
+  **`pipx` / `uv tool`** and dev via **`uv`**.
+
+**Follow-ups.** None required; optional future “Getting started” page could repeat
+install if the nav grows.

apc_model_parser-0.2.2/docs/chatlogs/2026-06-02_model-library-docs-diff-bump.md

@@ -0,0 +1,63 @@
+---
+title: Model library design, diff/bump CLI, and model-library bootstrap
+topic: documentation
+date_added: 2026-06-02
+tags: [chatlogs]
+links:
+  - AGENTS.md
+  - docs/design/model-parser.md
+  - docs/design/model-library-and-versioning.md
+  - src/model_parser/cli.py
+  - src/model_parser/semantic_diff.py
+  - src/model_parser/frontends/exprtk_ini.py
+---
+
+## Commit helper
+
+- **SemVer / version bump:** **MINOR** — user-visible CLI (`diff`, `bump`), new pure module `semantic_diff.py`, and `SOURCE_DATE_EPOCH` behaviour for `provenance.created_at` are new public behaviour (not docs-only).
+- **Tags / GitHub Release:** **None** — stack on default branch; tag when maintainers cut a release (existing `release.yml` on tag).
+- **Suggested commit message:** `feat(cli): add IR diff/bump and model-library design doc`
+- **Copy-paste git commands:**
+
+```bash
+git add AGENTS.md README.md docs/design/model-library-and-versioning.md \
+  docs/design/model-parser.md docs/design/ir-specification.md \
+  docs/index.md docs/chatlogs/2026-06-02_model-library-docs-diff-bump.md \
+  mkdocs.yml src/model_parser/cli.py src/model_parser/semantic_diff.py \
+  src/model_parser/frontends/exprtk_ini.py tests/test_cli.py tests/test_semantic_diff.py
+git commit -m "$(cat <<'EOF'
+feat(cli): add IR diff/bump and model-library design doc
+
+Add semantic comparison and advisory SemVer bump; document library workflows;
+honour SOURCE_DATE_EPOCH for reproducible IR provenance timestamps.
+EOF
+)"
+```
+
+- **Git order when tagging:** commit / push branch (with version bump if releasing) → annotated tag on that commit → push tag.
+
+## How to try
+
+```bash
+cd /path/to/model-parser
+uv sync --all-groups
+uv run model-parser parse examples/models/model_monod_simple.ini -o /tmp/a.ir.json
+uv run model-parser parse examples/models/model_monod_simple.ini -o /tmp/b.ir.json
+uv run model-parser diff /tmp/a.ir.json /tmp/b.ir.json
+uv run model-parser bump /tmp/a.ir.json /tmp/b.ir.json --json
+SOURCE_DATE_EPOCH=946684800 uv run model-parser parse examples/models/model_monod_simple.ini -o /tmp/c.ir.json
+uv run pytest tests/test_semantic_diff.py
+uv run mkdocs build --strict
+```
+
+Sibling repo `model-library`: set `MODEL_PARSER_VENV` to this repo’s `.venv` and run `./scripts/sync.sh` (see that repo’s README).
+
+## Session narrative
+
+**Goal:** Capture the prior design answer in-repo, add `diff` / `bump` to support a versioned model library, and bootstrap `Advanced-Process-Control/model-library` with the two existing example models.
+
+**Shipped:** New design page `docs/design/model-library-and-versioning.md` (hashes vs SemVer vs git, workflows, authoring vs parameter sets, optimal multi-file layout, reproducible timestamps); nav and cross-links (`mkdocs.yml`, `docs/index.md`, `model-parser.md`, `ir-specification.md`); `src/model_parser/semantic_diff.py` with conservative bump policy; CLI commands `diff` and `bump` (`--json`); INI frontend respects `SOURCE_DATE_EPOCH` for `provenance.created_at`; tests (`tests/test_semantic_diff.py`, CLI smoke); README and `AGENTS.md` updates.
+
+**model-library repo:** Added `models/monod_simple` and `models/thermal_tank` with copied authoring INIs, `scripts/sync.sh` + `scripts/update_lock.py`, committed generated `model.ir.json` / `views/model.jl`, `library.lock.json`, README, and GitHub Actions CI that installs `model-parser` from git `main` and fails on drift after sync.
+
+**Follow-ups:** Optional ADR for bump policy; `emit ini` and parameter-set JSON remain roadmap; publish a PyPI release so CI can pin a version instead of `main` if desired.

apc_model_parser-0.2.2/docs/chatlogs/2026-06-03_docs-todo-backlog-mkdocs.md

@@ -0,0 +1,47 @@
+---
+title: Tracked todo briefs under docs/todo and MkDocs nav
+topic: documentation
+date_added: 2026-06-03
+tags: [chatlogs]
+links:
+  - AGENTS.md
+  - docs/todo/index.md
+  - mkdocs.yml
+  - docs/index.md
+---
+
+## Commit helper
+
+- **SemVer / version bump:** **no bump** — documentation and contributor-guide updates only (`docs/todo/**`, `mkdocs.yml`, `docs/index.md`, `AGENTS.md`). No user-visible CLI or IR contract change.
+- **Tags / GitHub Release:** **None** — stack on default branch.
+- **Suggested commit message:** `docs: add tracked todo backlog under docs/todo`
+- **Copy-paste git commands:**
+
+```bash
+git add AGENTS.md docs/index.md docs/todo/ mkdocs.yml \
+  docs/chatlogs/2026-06-03_docs-todo-backlog-mkdocs.md
+git commit -m "$(cat <<'EOF'
+docs: add tracked todo backlog under docs/todo
+
+Add theme-sized future-work briefs, MkDocs Future work nav, and AGENTS work-tracking note.
+EOF
+)"
+```
+
+- **Git order when tagging:** N/A (no release in this slice).
+
+## How to try
+
+```bash
+cd /path/to/model-parser
+uv run mkdocs build --strict
+# optional: open docs/todo/index.md in the editor or browse site → Future work
+```
+
+## Session narrative
+
+**Goal:** Add a `docs/todo/` area with one Markdown file per major future implementation theme, wired into the published docs site, and record guidance on whether `model-library`’s `sync.sh` should auto-commit/push (recommendation: keep sync as regenerate-only; optional separate commit helper; avoid default auto-push).
+
+**Shipped:** `docs/todo/index.md` plus seven task files (`emit-ini-round-trip`, `emit-cpp-realtime-backend`, `ir-schema-migrations`, `parameter-set-contract-cli`, `conformance-fixtures-parity`, `ini-dimensions-inference`, `diff-bump-hardening`); `mkdocs.yml` **Future work** nav listing all pages (satisfies `--strict`); link from `docs/index.md`; `AGENTS.md` **Work tracking** section renamed to include todo briefs and clarify they complement ADRs/issues. MkDocs strict fixes: removed invalid links from `docs/` into `src/` / repo root; use code spans or in-repo doc links only.
+
+**Follow-ups:** Optional `model-library` script `sync-and-commit.sh` (opt-in commit, no default push) if maintainers want scripted commits; promote individual todo themes into GitHub issues or ADRs when scoped.

apc_model_parser-0.2.2/docs/chatlogs/2026-06-03_julia-rhs-emit-and-library-sync.md

@@ -0,0 +1,80 @@
+---
+title: Julia numerical RHS emit target and model-library sync
+topic: codegen
+date_added: 2026-06-03
+tags: [chatlogs]
+links:
+  - AGENTS.md
+  - docs/design/model-parser.md
+  - docs/decisions/0006-julia-numerical-rhs-view.md
+  - src/model_parser/backends/julia_expr.py
+  - src/model_parser/backends/julia_rhs.py
+  - src/model_parser/cli.py
+---
+
+## Commit helper
+
+- **SemVer / version bump:** **PATCH** (`0.2.1` → `0.2.2`) — new CLI subcommand `emit julia-rhs` and new public Python API `emit_julia_rhs`; backward-compatible for existing `emit julia` users.
+- **Tags / GitHub Release:** **None** — stack on default branch; tag when cutting a PyPI release (existing `release.yml` on tag).
+- **Suggested commit message (model-parser repo):** `feat(emit): add julia-rhs numerical ODE view`
+- **Copy-paste git commands (model-parser):**
+
+```bash
+cd /path/to/model-parser
+git add AGENTS.md README.md docs/design/model-library-and-versioning.md \
+  docs/design/model-parser.md docs/design/storing-mtk-models.md \
+  docs/decisions/0006-julia-numerical-rhs-view.md docs/decisions/index.md \
+  docs/chatlogs/2026-06-03_julia-rhs-emit-and-library-sync.md \
+  examples/README.md examples/run.sh mkdocs.yml pyproject.toml \
+  src/model_parser/__init__.py src/model_parser/backends/__init__.py \
+  src/model_parser/backends/julia_expr.py src/model_parser/backends/julia_mtk.py \
+  src/model_parser/backends/julia_rhs.py src/model_parser/cli.py \
+  tests/test_cli.py tests/test_julia_rhs.py
+git commit -m "$(cat <<'EOF'
+feat(emit): add julia-rhs numerical ODE view
+
+Share IR→Julia expression lowering in julia_expr; emit f!/outputs! codegen;
+document packing and ADR 0006; extend examples and model-library design notes.
+EOF
+)"
+```
+
+- **Suggested commit message (model-library repo, separate clone):** `chore(views): add model_rhs.jl and lock digests from emit julia-rhs`
+- **Copy-paste git commands (model-library):**
+
+```bash
+cd /path/to/model-library
+git add README.md library.lock.json scripts/sync.sh scripts/update_lock.py \
+  models/*/model.ir.json models/*/views/model.jl models/*/views/model_rhs.jl
+git commit -m "$(cat <<'EOF'
+chore(views): sync numerical RHS views and lockfile
+
+Regenerate IR/MTK views; add model_rhs.jl and julia_rhs_* lock fields per sync.
+EOF
+)"
+```
+
+- **Git order when tagging:** commit / push branch (with version bump if releasing) → annotated tag on that commit → push tag.
+
+## How to try
+
+```bash
+cd /path/to/model-parser
+uv sync --all-groups
+uv run model-parser parse examples/models/model_monod_simple.ini -o /tmp/m.ir.json
+uv run model-parser emit julia-rhs /tmp/m.ir.json
+uv run pytest tests/test_julia_rhs.py tests/test_cli.py
+uv run mkdocs build --strict
+```
+
+**model-library:** `MODEL_PARSER_VENV=/path/to/model-parser/.venv ./scripts/sync.sh` then inspect `models/*/views/model_rhs.jl` and `library.lock.json`.
+
+## Session narrative
+
+**Goal:** Implement a second Julia backend that emits an explicit numerical RHS (`f!` and optional `outputs!`) from the canonical IR, and wire the sibling `model-library` sync + lockfile to generate and fingerprint `views/model_rhs.jl`.
+
+**Shipped (model-parser):** New module `julia_expr.py` (shared `expr_to_julia`, `julia_model_slug`, `julia_number_literal`, `JuliaCodegenError`); `julia_mtk.py` refactored to use it; `julia_rhs.py` with `emit_julia_rhs`; CLI `emit julia-rhs`; tests; PATCH version bump; ADR 0006; design/README/AGENTS/examples updates; MkDocs nav entry.
+
+**Shipped (model-library):** `sync.sh` runs `emit julia-rhs` to `views/model_rhs.jl`; `update_lock.py` records `julia_rhs_relpath` and `julia_rhs_content_hash`; README updated; all models re-synced (committed artifacts include new `.jl` files and refreshed lock).
+
+**Follow-ups:** Optional `ApcModelAnalysis.jl` helper to load `model_rhs.jl`; conformance tests comparing MTK trajectory vs plain `ODEProblem` built from `f!` for small fixtures.

apc_model_parser-0.2.2/docs/decisions/0006-julia-numerical-rhs-view.md

@@ -0,0 +1,52 @@
+# ADR 0006: Julia numerical RHS view (`emit julia-rhs`)
+
+## Status
+
+accepted
+
+## Context
+
+Some analysis workflows (explicit vector ODEs, custom sensitivity tooling, or
+bridges that do not use ModelingToolkit) need a **plain in-place RHS**
+`f!(du, u, p, t)` with stable symbol-to-index packing, while the ecosystem
+standard remains an MTK-generated `System` from the same IR.
+
+## Decision
+
+Add a second Julia **codegen** target, `emit julia-rhs`, that lowers the same
+canonical IR to:
+
+- `f_<model_slug>!(du, u, p, t)` when the scaffold has no inputs, or
+  `f_<model_slug>!(du, u, p, t, inp)` when it has inputs (`inp` order = IR inputs
+  list order);
+- `outputs_<model_slug>!(y, u, p, t)` (same optional `inp`) when the IR
+  carries output equations.
+
+Packing rules: `u` and `du` follow `ir.states` order; `p` follows `ir.parameters`
+order (defaults in the IR are **not** applied inside `f!` — callers supply
+numeric `p`). Locals are emitted as sequential assignments in IR order, aligned
+with the MTK lowering order.
+
+Expression rendering is shared with the MTK backend via `julia_expr.py` so
+semantics are not duplicated.
+
+## Consequences
+
+- **Positive:** One IR, two diffable Julia views; numerical and symbolic stacks
+  stay aligned.
+- **Negative:** Callers must respect documented packing; no automatic wiring to
+  MTK `ODEProblem` from the RHS view alone.
+
+## Alternatives considered
+
+1. **Generate RHS only in downstream repos** — rejected: duplicates expression
+   semantics and drifts from the IR contract.
+2. **Single `emit julia` with a flag** — rejected: CLI stays clearer with
+   separate targets (`emit cpp`, etc.) per ADR 0005.
+
+## References
+
+- ADR 0002 (codegen over serialized `System`)
+- ADR 0003 (explicit expression IR)
+- ADR 0005 (CLI `emit <target>` shape)
+- `docs/design/model-parser.md` §5 (CLI)

{apc_model_parser-0.1.0 → apc_model_parser-0.2.2}/docs/decisions/index.md

@@ -17,6 +17,7 @@ code and review naturally in pull requests.
 | [0003](0003-explicit-expression-ir.md) | Explicit expression IR, not string rewrites | accepted | 2026-06-01 |
 | [0004](0004-target-mtk-v11-idioms.md) | Generated Julia targets ModelingToolkit v11 idioms | accepted | 2026-06-01 |
 | [0005](0005-cli-verbs-parse-emit.md) | CLI shape: `parse` and `emit <target>` as core verbs | accepted | 2026-06-01 |
+| [0006](0006-julia-numerical-rhs-view.md) | Second Julia view: plain `f!` / `outputs!` from IR (`emit julia-rhs`) | accepted | 2026-06-03 |
 
 ## Format
 

{apc_model_parser-0.1.0 → apc_model_parser-0.2.2}/docs/deployment/ci-cd.md

@@ -41,6 +41,8 @@ The job:
 3. Creates a **GitHub Release** (with generated notes) and attaches the built files
 4. Publishes to **PyPI** using **trusted publishing (OIDC)** — no long-lived API token in secrets
 
+After publish, end users typically install the CLI with **`pipx install apc-model-parser`** or **`uv tool install apc-model-parser`** (command on `PATH`: **`model-parser`**).
+
 ### PyPI trusted publisher
 
 Configure the pending publisher on PyPI for:

{apc_model_parser-0.1.0 → apc_model_parser-0.2.2}/docs/design/ir-specification.md

@@ -53,7 +53,9 @@ one namespace; duplicates are a validation error.
 
 `provenance.content_hash` is `sha256` over the canonical JSON of the IR body
 **excluding** `provenance`. Downstream artifacts reference a scaffold by this
-hash, not by file path.
+hash, not by file path. For how this interacts with a versioned model library,
+SemVer, and git, see
+[`model-library-and-versioning.md`](model-library-and-versioning.md).
 
 ## 3. Expression sub-language