@calcit/procs 0.12.50 → 0.12.51

package/editing-history/2026-04-07-1550-path-format-at-prefix-migration.md

@@ -5,17 +5,20 @@
 All display-level Cirru tree paths now use `@` prefix notation when rendered to user.
 
 ### Display format change
+
 - `1.2.3.4` → `@1.2.3.4` (bare path)
 - `[1.2.3.4]` → `[@1.2.3.4]` (bracketed path)
 - `NodeLocation::Display` now outputs `ns/def [@1.2.3]` instead of `ns/def [1.2.3]`
 
 ### Backward compatibility
+
 - `parse_path()` strips leading `@` if present, so CLI input still accepts both `@1.2.3` and `1.2.3`
 - Error messages and help text updated to show `@` format
 
 ### Files modified
 
 **Core functions:**
+
 - `src/bin/cli_handlers/common.rs`: `format_path()` returns `@1.2.3`; `parse_path()` strips `@` prefix; test assertions updated
 - `src/calcit.rs`: `NodeLocation::Display` outputs `[@1.2.3]`; test assertion updated
 - `src/bin/cli_handlers/cirru_validator.rs`: local `format_path()` updated
@@ -24,17 +27,20 @@ All display-level Cirru tree paths now use `@` prefix notation when rendered to
 - `src/runner/preprocess/mod.rs`: `[&inspect-type]` debug output uses `@`
 
 **Tree/edit handlers:**
+
 - `src/bin/cli_handlers/tree.rs`: inline path formatting in swap handler
 - `src/bin/cli_handlers/edit.rs`: error message example
 - `src/cli_args.rs`: help text examples (3 locations)
 
 **Documentation:**
+
 - `docs/CalcitAgent.md`: 19 path examples updated
 - `docs/run/agent-advanced.md`: 23 path examples updated
 - `docs/run/edit-tree.md`: 6 path examples updated
 - `docs/Respo-Agent.md` (respo project): 26 path examples updated
 
 ### Why
+
 - `@` prefix helps LLMs distinguish path coordinates from other dotted numeric patterns (like version numbers or floats)
 - `@` is safe in shell (no escaping needed)
 - All display output now consistent with `@` prefix

package/editing-history/20260720-2305-cli-docs-refresh.md

@@ -0,0 +1,9 @@
+## Summary
+
+Refresh CLI-facing docs to match the current command surface.
+
+## Notes
+
+- Align `cr edit` / `cr tree` examples with current subcommand names and long-option forms.
+- Document stdin fallback for edit/tree code inputs while keeping the Cirru EDN `quote` requirement explicit.
+- Update agent-oriented guides so examples no longer mix legacy structured command syntax with current shell CLI usage.

package/editing-history/20260720-2306-compatible-dependency-upgrades.md

@@ -0,0 +1,9 @@
+## Summary
+
+Upgrade compatible Rust dependencies, including `cirru_edn`, without changing the existing `strum` line.
+
+## Notes
+
+- Bump `cirru_edn` to `0.7.8` in normal and build dependencies.
+- Upgrade other compatible crates such as `argh`, `colored`, `ctrlc`, `regex`, `rpds`, `semver`, `serde`, `serde_json`, and `ureq`.
+- Refresh `Cargo.lock` after version changes so the workspace resolves to the new compatible releases.

package/editing-history/20260721-0110-format-cirru-and-refresh-docs.md

@@ -0,0 +1,15 @@
+# 2026-07-21 01:10 Cirru 格式化与文档命令更新
+
+## 修改概要
+
+- 使用 `cr <snapshot> edit format` 统一格式化 `calcit/` 下 56 个非空 Cirru 文件。
+- 保留 `calcit/debug/.compact-inc.cirru` 这个 0 字节热更新占位文件原样。
+- 修正文档中已移除的 `check-md -d`、`remote-libs readme -f`、`read-lines -s/-n` 旧参数。
+- 在快速参考中加入文档知识图谱常用命令。
+
+## 验证
+
+- `cr docs agents --full`
+- `cargo test -q`
+- `yarn check-all`
+- `git diff --check`

package/editing-history/20260722-1428-fix-or-codegen-timeout.md

@@ -0,0 +1,23 @@
+# Fix exponential `or` expansion and bound code generation
+
+## Summary
+
+- Fixed the `or` macro so its recursive tail is emitted once instead of being duplicated in both falsy branches.
+- Preserved Calcit truthiness semantics for `nil`, `false`, and arbitrary truthy values.
+- Added a long-operand regression case to the macro test suite.
+- Added verbose preprocessing phase/definition diagnostics for JS and IR generation.
+- Added a configurable code generation timeout, defaulting to 60 seconds, including watch-mode rebuilds.
+- Increased the code generation worker stack for deeply nested macro and type preprocessing.
+
+## Root cause
+
+The previous `or` macro emitted the remaining operands in both the `nil` and `false` branches. Recursive macro expansion therefore grew exponentially for long `or` expressions. A real-world 40-plus-operand predicate appeared to hang and consumed CPU until externally terminated.
+
+## Validation
+
+- `cargo fmt --check`
+- `cargo clippy --bin cr -- -D warnings`
+- `cargo test --lib runner::preprocess -- --nocapture`
+- `target/debug/cr calcit/test.cirru`
+- `target/debug/cr calcit/test.cirru --timeout 60 js`
+- The original `respo/markdown/calcit.cirru` reproduction now reaches its project-level warnings in under one second instead of timing out after 60 seconds.

package/lib/package.json

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

package/package.json

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