Update CLAUDE.md and NOTEBOOK.md for 1.13.x releases

Document sbt-riddl rewrite, ANSI version parsing fix, direct
command invocation, and related learnings from 1.13.0/1.13.1.

Co-Authored-By: Claude Opus 4.6 <noreply@anthropic.com>

Author: reid-spencer

CLAUDE.md

@@ -829,8 +829,8 @@ Then add to root aggregation: `.aggregate(..., mymodule, mymoduleJS, mymoduleNat
     ARM64. Removing `inline` fixes it; the compiler optimizes
     trivial delegations anyway. Filed as
     https://github.com/scala/scala3/issues/25306
-66. **Current release is 1.12.1** — Patch release fixing
-    prettify formatting regressions. Supersedes 1.12.0
+66. **Current release is 1.13.1** — sbt-riddl bugfix release.
+    Supersedes 1.13.0 (sbt-riddl rewrite)
 67. **PrettifyPass multi-file mode** — `PrettifyPass.Options`
     now carries `topFile`, `outputDir`, and `flatten`. When
     `flatten=false` (the new default), prettify preserves
@@ -852,11 +852,8 @@ Then add to root aggregation: `.aggregate(..., mymodule, mymoduleJS, mymoduleNat
     (hugo-theme-learn, redislabs-docs, hugo-theme-docdock)
     were causing warnings on `git pull`. No submodule paths
     were tracked in the tree; only `.gitmodules` remained
-71. **Current release is 1.12.1** — Patch release fixing three
-    prettify formatting regressions from 1.12.0: removed
-    commas between aggregate fields, kept `} with {` on same
-    line for types with metadata, preserved relative include
-    paths. Supersedes 1.12.0
+71. **Current release is 1.13.1** — sbt-riddl ANSI fix and
+    direct command invocation. Supersedes 1.13.0
 72. **RiddlFileEmitter.trimTrailingNewline()** — Removes a
     trailing newline from the StringBuilder. Used in
     `closeType` to join `}` from `emitFields` with ` with {`
@@ -867,3 +864,30 @@ Then add to root aggregation: `.aggregate(..., mymodule, mymoduleJS, mymoduleNat
     instead of `url.toExternalForm` (absolute `file:///`
     URL). This preserves the original include path as written
     in the source model
+74. **sbt-riddl rewritten with auto-download** — Plugin at
+    `sbt-riddl/src/.../RiddlSbtPlugin.scala` now auto-downloads
+    riddlc from GitHub releases, caches in
+    `~/.cache/riddlc/<version>/`. Three-tier resolution:
+    explicit path > download > PATH. Full command set:
+    validate, parse, bastify, prettify, info, version. Batch
+    .conf scanning with `riddlcSourceDir`/`riddlcConfExclusions`.
+    Pre-compile hook via `riddlcValidateOnCompile`. Curried
+    `riddlc()` helper for one-line project config
+75. **sbt plugin visibility: private[plugin]** — In sbt
+    plugins (Scala 2.12), `private def` methods appear unused
+    to the compiler because sbt macro-generated task bodies
+    (`:=`) reference them indirectly. Use `private[plugin] def`
+    to avoid "private method never used" errors
+76. **riddlc commands don't need `from <conf>`** — Individual
+    commands like `riddlc validate file.riddl` work directly.
+    The `from` command is only needed to load a full HOCON
+    config. The sbt-riddl plugin extracts `input-file` from
+    .conf files and invokes commands directly
+77. **riddlc version emits ANSI codes** — Output includes
+    `\u001b[34m\u001b[1m[info] 1.13.0\u001b[0m`. Use
+    `--no-ansi-messages` flag and strip residual ANSI/`[info]`
+    with regex before version parsing
+78. **Scripted tests need pinned riddlcVersion** — Between
+    releases, sbt-dynver produces snapshot versions like
+    `1.13.0-2-hash-date` which don't exist on GitHub. Pin
+    `riddlcVersion := "1.13.1"` in scripted test build.sbt

NOTEBOOK.md

@@ -15,7 +15,47 @@ to the task file and note completion in this notebook.
 
 ## Current Status
 
-**Last Updated**: February 19, 2026
+**Last Updated**: February 21, 2026
+
+### Release 1.13.1 Published (Feb 21, 2026)
+
+Bugfix patch for sbt-riddl plugin:
+- Fixed `checkVersion()` ANSI parsing — `riddlc version`
+  emits ANSI color codes causing `NumberFormatException`.
+  Added `--no-ansi-messages` flag and ANSI/`[info]` stripping
+- Changed all tasks (validate, parse, bastify, prettify) to
+  use direct riddlc commands instead of `from <conf>` wrapper.
+  Only the `from` command needs a `.conf` file; individual
+  commands like `riddlc validate file.riddl` work directly
+
+### Release 1.13.0 Published (Feb 21, 2026)
+
+Complete rewrite of `sbt-riddl` plugin (`RiddlSbtPlugin.scala`)
+from a minimal 4-command wrapper (~219 lines) to a full-featured
+plugin (~620 lines) with:
+- **Auto-download**: Downloads riddlc from GitHub releases,
+  cached in `~/.cache/riddlc/<version>/`. Platform detection
+  for macOS ARM64, Linux x86_64, JVM universal fallback
+- **Three-tier binary resolution**: explicit path > download >
+  PATH fallback
+- **Full command set**: validate, parse, bastify, prettify,
+  info, version (removed stale `hugo` command)
+- **Batch operations**: Scans `riddlcSourceDir` for `.conf`
+  files, runs operation on each, reports pass/fail per model
+- **Pre-compile validation**: `riddlcValidateOnCompile` setting
+  (default true) hooks into `Compile / compile`
+- **`riddlc()` curried helper**: One-line project configuration
+  via `.configure(riddlc(version = "1.13.1"))`
+- **Version checking**: Validates riddlc version meets minimum
+
+Key learnings:
+- `private def` in sbt plugins must be `private[plugin]`
+  because Scala 2.12 can't see usage through sbt macro-
+  generated task bodies (`:=`)
+- `java.nio.file.Path` shadows sbt's `Path` — avoid importing
+  both
+- Scripted tests between releases must pin `riddlcVersion` to
+  a real release tag, not the dynver snapshot
 
 ### Release 1.12.1 Published (Feb 19, 2026)
 
@@ -189,6 +229,21 @@ go there, not this repo.
 
 ## Session Log
 
+### February 21, 2026 — sbt-riddl Rewrite + Ship 1.13.0/1.13.1
+
+Complete rewrite of `RiddlSbtPlugin.scala` with auto-download
+from GitHub releases, batch conf operations, pre-compile
+validation hook, and full riddlc command set. Shipped as 1.13.0.
+
+Then fixed two bugs found during scripted testing:
+1. `checkVersion()` fails on ANSI output from `riddlc version`
+2. Tasks used `from <conf> <command>` which requires command
+   blocks in the conf — switched to direct `riddlc <command>
+   <file>` invocations
+
+Shipped bugfix as 1.13.1. Upgrade task files dropped in all 8
+consumer projects.
+
 ### February 18, 2026 — Prettify Multi-File Fix + Release
 
 Fixed `riddlc prettify` to retain multi-file include/import