@calcit/procs 0.13.8 → 0.13.10

package/editing-history/202608111322-agent-migration-convergence.md

@@ -0,0 +1,40 @@
+# Improve agent migration convergence
+
+Migrating Respo and its dependent modules to stricter Calcit types exposed a
+few CLI and compiler failures that made automated repairs unnecessarily slow or
+unsafe:
+
+- `cr edit imports` documented Cirru input but only accepted a single flat rule;
+  multi-rule input effectively required JSON.
+- Cirru transaction output expanded quoted empty lists into a shape that did not
+  round-trip, blocking safe insertion of zero-argument function definitions.
+- definition revision hashes rejected leaf-shaped examples/tests, so semantic
+  queries failed on otherwise valid definition-attached tests.
+- large but finite UI/Markdown dependency graphs overflowed the 16 MiB codegen
+  worker stack before diagnostics could identify the actual type errors.
+- several tree command help strings still advertised removed comma-separated
+  paths even though the parser requires `@2.1.0` coordinates.
+- concurrent mutation processes can overwrite each other's snapshot changes,
+  which was easy to trigger when an agent updated multiple entries in parallel.
+
+Changes:
+
+- Accept a quoted Cirru `[]` whose child expressions are import rules in
+  `cr edit imports`, while preserving JSON compatibility and rejecting
+  malformed flat children.
+- Emit inline Cirru for transaction quoted code so empty lists round-trip.
+- Give leaf examples/tests stable revision encodings without changing existing
+  list revision hashes.
+- Raise the dedicated codegen worker stack to 64 MiB, which is sufficient for
+  the current Respo UI/Markdown graph and still keeps recursion isolated from
+  the process main thread.
+- Align all path option help with the dot-separated coordinate parser.
+- Document that writes to one snapshot must be serialized, or grouped in a
+  revision-guarded transaction; independent snapshots/worktrees may still run
+  in parallel.
+
+Real-project validation used local Respo, Router, Markdown, UI, Reel, and Alerts
+snapshots after removing the obsolete Lilac module dependency. UI, Router, Reel,
+Alerts, and all three Markdown entries completed JS codegen. Calcit built-in
+tests passed 35/35 in Respo and 6/6 in Router; no external `calcit-test` runner
+was used.

package/editing-history/202608111349-release-0.13.10.md

@@ -0,0 +1,13 @@
+# Release 0.13.10
+
+Release the agent migration convergence improvements merged in PR #333:
+
+- quoted Cirru import-list input for `cr edit imports`;
+- safe transaction round-tripping for quoted empty lists;
+- revision support for leaf examples and definition-attached tests;
+- a larger codegen worker stack for finite real-world module graphs;
+- corrected tree path help and serialized snapshot mutation guidance.
+
+The changes were validated against the Respo dependency chain without Lilac or
+the external `calcit-test` module, in addition to the full Calcit Rust, native,
+JavaScript, agent-interface, and WASM gates.

package/history/202608101101-release-pr-workflow.md

@@ -0,0 +1,8 @@
+## Release PR workflow
+
+- `main` is protected by a pull-request requirement, including release version
+  changes; release commits must be created on a dedicated release branch.
+- A release tag is created only after the release PR is green, merged, and
+  fetched back onto local `main`.
+- Publication verification uses non-interactive `gh pr checks` and `gh run
+  list` polling, then confirms matching crates.io and npm versions.

package/history/202608101102-release-doc-tracked-path.md

@@ -0,0 +1,5 @@
+## Release documentation tracked path
+
+- The repository tracks its agent instructions as `Agents.md`; release-flow
+  documentation updates must stage that exact path so the release PR includes
+  the operational guidance as well as its history record.

package/history/202608110054-small-edit-advice.md

@@ -0,0 +1,13 @@
+## Suppress structural-edit advice for small definitions
+
+- Structural-edit guidance now requires either the existing or incoming Cirru
+  tree to contain at least 32 AST nodes.
+- Tiny definitions do not benefit from a path-finding workflow, so full
+  definition updates no longer emit a misleadingly heavyweight warning.
+- Keep the threshold in `analyze_cirru_edit_advice` so every caller shares the
+  same behavior, including identical-definition advice.
+- `&list:first` now consistently reports its nullable `Optional<T>` result to
+  static analysis, matching the Core schema and its `nil` result for empty
+  lists.
+- Core macros and comparison helpers that first establish non-emptiness now
+  use the explicitly indexed low-level read `&list:nth xs 0`.

package/history/202608110125-review-optional-list-first.md

@@ -0,0 +1,4 @@
+## Review follow-ups for nullable list-first inference
+
+- Normalize `optional_of` so already-optional types are not wrapped into nested optionals.
+- Rename the list-first inference regression test and cover both non-empty and empty lists.

package/history/202608110133-review-core-call-sites-and-thresholds.md

@@ -0,0 +1,5 @@
+## Follow-up review fixes for nullable list-first
+
+- Migrate remaining guarded Core reads in max/min, comparison folding, and list destructuring to `&list:nth ... 0`.
+- Tag the empty-list regression as both `:core` and `:unit`.
+- Make edit-advice fixtures assert exact 31/32-node boundary behavior, including one-sided threshold crossings.

package/history/202608110140-release-0.13.9.md

@@ -0,0 +1,4 @@
+## Release 0.13.9
+
+- Bump the Cargo and npm package versions together after merging PR #331.
+- Refresh the workspace lockfile before creating the release PR and tag.

package/lib/package.json

@@ -1,6 +1,6 @@
 {
     "name": "@calcit/procs",
-    "version": "0.13.8",
+    "version": "0.13.10",
     "main": "./lib/calcit.procs.mjs",
     "devDependencies": {
         "@types/node": "^25.7.0",

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@calcit/procs",
-  "version": "0.13.8",
+  "version": "0.13.10",
   "main": "./lib/calcit.procs.mjs",
   "devDependencies": {
     "@types/node": "^25.7.0",