@calcit/procs 0.12.52 → 0.12.54

package/editing-history/2026-07-28-2004-cursor-editing-docs.md

@@ -0,0 +1,14 @@
+# Cursor 与 transaction 使用文档
+
+## 概要
+
+- 在 Agent 指南中补充通过搜索结果设置 cursor、用 `@cursor` 进行连续树形编辑、导航栈与结构化 clipboard 的推荐流程。
+- 在结构化编辑参考中完整记录 cursor sidecar、focus/node/full 展示、mutation 后坐标维护与 `--cursor-after` 回显控制。
+- 记录 Cirru EDN transaction 的主要输入形式、quoted code、dry-run、revision 检查与 JSON 兼容边界。
+- 将新增命令加入 Agent 能力地图和文档 frontmatter，便于结构化文档查询定位。
+
+## 一致性
+
+- 文档示例沿用既有 `cr` 子命令风格，不引入 Cargo 风格命令。
+- 所有路径仍指向 Snapshot 中的 Cirru tree，展示用 `CURSOR` 不改变真实源码与 path。
+

package/editing-history/2026-07-28-2132-cursor-recoverable-clipboard.md

@@ -0,0 +1,18 @@
+# Cursor clipboard 可恢复提交与精简状态
+
+## 概要
+
+- `.calcit-cursor.cirru` 升级到 schema v3，继续读取 v1/v2；active、history 与 stack 不再重复保存完整 subtree preview，展示时从当前 Snapshot 重建。
+- `cursor cut` 和 `cursor paste` 在修改任何目标文件前先生成 Snapshot 与 sidecar staged 文件，避免序列化或临时文件失败造成半成品。
+- cut 按 sidecar→Snapshot 顺序提交，确保 Snapshot 提交失败时完整表达式已经存在于结构化 clipboard。
+- paste 按 Snapshot→sidecar 顺序提交；若第二步失败，错误明确说明源码已经修改并禁止盲目重试。
+- `cursor show` 构造真实节点和 focus preview 时复用同一次 Snapshot 读取，减少重复解析。
+
+## 验证
+
+- 新增 cut 第二阶段失败时 clipboard 已持久化的故障注入测试。
+- 新增 paste cursor 提交失败时 Snapshot 已提交且错误包含 partial-success 指引的测试。
+- sidecar round-trip 断言 schema v3 且不包含 `:preview`。
+- `cargo test --bin cr cursor`
+- `cargo clippy --bin cr -- -D warnings`
+

package/editing-history/2026-07-28-2151-cursor-native-structural-editing.md

@@ -0,0 +1,20 @@
+# Cursor 原生结构编辑与跨层导航
+
+## 概要
+
+- 新增 `cursor apply <operation>`，由 active cursor 推导 definition target 与 tree path，再复用既有 tree handler，避免 Agent 在连续操作中重复传递坐标。
+- 新增 `cursor slurp-next` 与 `cursor barf-last`，通过已有 `edit mv` 完成跨 parent 的 Paredit 风格节点移动，cursor 始终跟随原先选中的 list。
+- 新增 `cursor forward/backward --count N`，按 definition 的深度优先结构顺序跨 list 边界移动，并把整次多步移动记录为一条 history。
+- 当顶层使用 `--cursor-after focus` 时，set、search 选中、普通导航与 history/stack 恢复会立即输出 focus preview。
+- 非法 root、leaf、空 list、缺少 sibling、零步和越界操作均在写 Snapshot 前失败。
+
+## 验证
+
+- `cargo fmt`
+- `cargo clippy -- -D warnings`
+- `cargo test`
+- `yarn compile`
+- `yarn check-agent-interface`
+- `yarn check-all`
+- `cr docs check-md` 检查 Agent 指南和 tree editing 文档。
+- 全局安装当前 `cr` 后，在 Respo workflow 临时副本往返执行 depth-first navigation、swap、slurp/barf；Snapshot 与原文件逐字节一致，`cr js` 成功。

package/editing-history/2026-07-28-2158-document-cursor-native-workflows.md

@@ -0,0 +1,13 @@
+# 补充 Cursor 原生工作流文档
+
+## 概要
+
+- RFC 增加 `cursor apply`、`slurp-next`、`barf-last`、`forward/backward` 的命令契约、复用边界和验收项。
+- Agent 快速指南说明同级导航与跨 list 深度优先导航的区别，并加入 cursor 原生 mutation 的选择建议。
+- tree editing 指南补充完整命令示例、`--cursor-after focus` 的导航反馈，以及 `unwrap` 并非任意 wrapper 的严格逆操作这一边界。
+
+## 验证
+
+- `target/debug/cr calcit/test.cirru docs check-md docs/CalcitAgent.md --entry calcit/test.cirru`
+- `target/debug/cr calcit/test.cirru docs check-md docs/run/edit-tree.md --entry calcit/test.cirru`
+- `git diff --check`

package/editing-history/2026-07-29-0022-add-cursor-cli-options.md

@@ -0,0 +1,7 @@
+# Cursor CLI surface
+
+- Added symmetric `slurp-prev` and `barf-first` cursor commands.
+- Added `cursor duplicate --at before|after`.
+- Added `--start-path` to structural expression search.
+
+Validation for the complete change set: `cargo fmt`, `cargo clippy -- -D warnings`, `cargo test`, `yarn compile`, `yarn check-agent-interface`, and `yarn check-all`.

package/editing-history/2026-07-29-0022-audit-cursor-development-scenarios.md

@@ -0,0 +1,6 @@
+# Audit cursor development scenarios
+
+- Mapped the cursor contract to high-frequency development workflows.
+- Specified symmetric Paredit operations, duplication, target aliases, and subtree search.
+- Clarified transaction, source-undo, and concurrent-agent boundaries.
+- Kept workspace, module, and project-wide operations explicit rather than cursor-dependent.

package/editing-history/2026-07-29-0022-complete-cursor-structural-edits.md

@@ -0,0 +1,8 @@
+# Complete cursor structural edits
+
+- Implemented leftward slurp/barf operations and clipboard-preserving duplication.
+- Used staged Snapshot and sidecar writes with explicit partial-success diagnostics.
+- Added reusable active target/path resolution for `@cursor` aliases.
+- Covered selection tracking, invalid boundaries, and parallel-test temporary-directory collisions.
+
+The operations were round-trip tested on a temporary copy of `respo-calcit-workflow` with the globally installed `cr`.

package/editing-history/2026-07-29-0022-document-cursor-edit-recipes.md

@@ -0,0 +1,8 @@
+# Document cursor edit recipes
+
+- Added concrete recipes for cursor-aware query, tree, and edit commands.
+- Documented symmetric slurp/barf and clipboard-preserving duplicate operations.
+- Added cursor-scoped leaf and structural searches.
+- Clarified navigation history and multi-agent boundaries.
+
+The documented workflow was exercised against a temporary Respo project and finished with a successful JS build.

package/editing-history/2026-07-29-0022-echo-cursor-commands.md

@@ -0,0 +1,6 @@
+# Cursor command echo
+
+- Added machine-readable command echo fields and human explanations for the new cursor operations.
+- Included structural search start paths in echoed query commands.
+
+This keeps CLI diagnostics consistent with the existing command protocol.

package/editing-history/2026-07-29-0022-edit-target-cursor-alias.md

@@ -0,0 +1,6 @@
+# Edit target cursor alias
+
+- Added `@cursor` definition targets to definition, metadata, copy/move, rename, and split operations.
+- Defined the alias as the source for two-target commands while keeping destinations explicit.
+- Reused a single active target/path resolution when an edit references both.
+- Left transaction operation files self-contained with concrete targets and paths.

package/editing-history/2026-07-29-0022-guide-agents-through-cursor-workflows.md

@@ -0,0 +1,7 @@
+# Guide agents through cursor workflows
+
+- Documented cursor target aliases and subtree-scoped search for agents.
+- Added symmetric structural editing and duplication guidance.
+- Clarified that cursor history is navigation-only and the sidecar is not a concurrency primitive.
+
+All executable Markdown blocks passed `cr docs check-md`.

package/editing-history/2026-07-29-0022-query-from-active-cursor.md

@@ -0,0 +1,8 @@
+# Query from the active cursor
+
+- Allowed definition-oriented queries to use `@cursor` as their target.
+- Added cursor-scoped structural expression search with absolute result paths.
+- Made `query type-at @cursor --path @cursor` resolve one validated cursor state.
+- Rejected conflicting explicit filters for cursor-scoped searches.
+
+Real-project checks covered search selection, type evidence, and bounded semantic context.

package/editing-history/2026-07-29-0022-tree-target-cursor-alias.md

@@ -0,0 +1,5 @@
+# Tree target cursor alias
+
+- Allowed every target-bearing `cr tree` command to resolve `@cursor` as both definition target and structural path.
+- Reused one validated active cursor when both aliases occur in the same command.
+- Preserved target mismatch rejection for explicit definitions.

package/editing-history/2026-07-29-1242-agent-guide-cold-start-validation.md

@@ -0,0 +1,15 @@
+# Agent guide cold-start validation
+
+- Reworked the embedded Agent guide around Snapshot identity, Cirru AST boundaries, query-to-cursor workflows, structural editing, and layered validation.
+- Preserved the high-frequency Cirru rules that fresh agents commonly misapply, while routing lower-frequency operations through live CLI documentation.
+- Added practical cursor guidance for sibling insertion, clipboard state, inherited sidecars, focused previews, invalid navigation, and non-invertible unwrap operations.
+- Corrected error recovery guidance so current stderr takes precedence over stale persisted runtime stacks.
+- Validated the guide through isolated cold-start trials in a real Respo project without committing experimental changes.
+
+Validation:
+
+- `bash scripts/check-docs-md.sh` (52 files, 286 blocks)
+- `yarn check-agent-interface` (12 scenarios)
+- `cargo test cli_handlers::docs::tests::agents_docs_default_to_the_version_matched_embedded_guide`
+- Isolated `cr --check-only` and `cr js` trials in `respo-calcit-workflow` copies
+

package/editing-history/2026-07-29-1242-cirru-quote-input-errors.md

@@ -0,0 +1,13 @@
+# Cirru quote input diagnostics
+
+- Clarified CLI errors for missing or malformed `quote` transport wrappers.
+- Distinguished symbol, string, and expression payload examples in parser hints.
+- Added coverage for ambiguous bare forms and multi-payload quote input.
+
+Validation:
+
+- `cargo fmt`
+- `cargo clippy -- -D warnings`
+- `cargo test`
+- `yarn check-all`
+

package/editing-history/2026-07-29-1242-internal-wasm-doc-boundary.md

@@ -0,0 +1,13 @@
+# Internal WASM documentation boundary
+
+- Removed `cr-wasm` from installation, quick-reference, feature, and public CLI documentation.
+- Kept the WASM backend implementation and validation workflow unchanged.
+- Moved the detailed backend notes under `scripts/` and reframed them as repository-internal validation documentation.
+- Reduced `cr ir` coverage to a short compiler-debugging note instead of presenting it as a normal project workflow.
+
+Validation:
+
+- `bash scripts/check-docs-md.sh`
+- `yarn check-all`
+- `git diff --check`
+

package/editing-history/2026-07-30-1130-pr-281-review-fixes.md

@@ -0,0 +1,5 @@
+# PR 281 review fixes
+
+- Guard recursive static definition inference, falling back to `:dynamic` for cycles.
+- Validate dependency module paths before filesystem or Git operations and avoid reporting a reset for untracked-only changes.
+- Correct JS FFI intent classification, bounded cursor state recovery, and CLI/documentation consistency.

package/editing-history/20260728-1500-caps-module-status.md

@@ -0,0 +1,17 @@
+# 2026-07-28 caps 模块状态检查与重置
+
+## 修改概要
+
+- 为 `caps` 增加 `status` 子命令，检查 `deps.cirru` 声明模块的版本、缺失状态和本地 Git 修改。
+- 为 `caps` 增加 `reset` 子命令，重置已安装模块的 tracked 本地修改。
+- 普通 `caps` 同步前增加本地模块状态提示。
+- 补充依赖加载文档。
+
+## 验证
+
+- `cargo fmt`
+- `cargo clippy -- -D warnings`
+- `cargo test`
+- `yarn compile`
+- `yarn check-all`
+- `yarn check-agent-interface`

package/editing-history/20260728-1501-release-0.12.53.md

@@ -0,0 +1,6 @@
+# 2026-07-28 发布 0.12.53
+
+## 修改概要
+
+- 同步 `Cargo.toml` 和 `package.json` 版本号到 `0.12.53`。
+- 执行 `cargo update --workspace` 更新 `Cargo.lock`。

package/editing-history/20260729-1421-consolidate-local-state-and-cursor-tools.md

@@ -0,0 +1,22 @@
+# Consolidate local state and cursor tools
+
+## Summary
+
+- Consolidated project-local sidecar files under `.calcit/`: cursor state now uses `.calcit/cursor.cirru`, and persisted runtime errors use `.calcit/error.cirru`.
+- Added one-time migration from `.calcit-cursor.cirru` and `.calcit-error.cirru` without dual writes.
+- Kept state paths relative to the selected snapshot, including commands invoked from another working directory.
+- Extended cursor schema v4 with one region anchor, up to 16 named marks, and a compact last-query descriptor.
+- Added `cursor anchor`, `clear-anchor`, `region`, `mark`, `goto`, `marks`, and `rm-mark`, plus `query next` and `query prev`.
+- Applied the same path transforms to the active cursor, anchor, and marks during structural edits; stale query continuation is rejected after a snapshot revision change.
+- Bounded the complete cursor file to 64 KiB and retained existing history, stack, and mark count limits.
+
+## Validation
+
+- `cargo fmt`
+- `cargo clippy --all-targets -- -D warnings`
+- `cargo test`
+- `yarn compile`
+- `yarn check-all`
+- `yarn check-agent-interface`
+- Real-project regression on a temporary Respo workflow copy, including legacy migration, region/marks/query continuation, and successful `cr js` compilation.
+- Release binary changed from 8,196,752 bytes to 8,280,352 bytes on the same arm64 build environment (about 1.02%).

package/editing-history/20260729-1422-document-calcit-local-state.md

@@ -0,0 +1,15 @@
+# Document Calcit local state
+
+## Summary
+
+- Documented `.calcit/` as the bounded project-local state directory and recommended ignoring the directory as a unit.
+- Updated cursor RFC and Agent guidance for anchor/region, named marks, query continuation, migration behavior, and state-size limits.
+- Moved the recommended multiline snippet location to `.calcit/snippets/`.
+- Updated error-stack references to `.calcit/error.cirru` while preserving historical editing records.
+- Clarified that `.compact-inc.cirru` remains the existing watcher protocol rather than project-local diagnostic state.
+- Corrected repository-local Agent examples and replaced the obsolete binary-size threshold with a same-platform exact-byte baseline comparison.
+
+## Validation
+
+- `target/debug/cr docs check-md docs/CalcitAgent.md --entry calcit/test.cirru` (4/4 blocks passed)
+- `git diff --check`

package/editing-history/20260729-1952-strengthen-polymorphism-diagnostics.md

@@ -0,0 +1,21 @@
+# Strengthen polymorphism diagnostics
+
+## Summary
+
+- Clarified the static-semantics RFC around parametric generics, trait bounds, applied data types, callback contracts, enums, optionals, and type slots.
+- Restored the intended compatibility rule that legacy `:any` is parsed and serialized as `:dynamic`, rather than acting as a separate static top type.
+- Added generic and trait-bound evidence to type-coverage reports.
+- Added stable aggregate diagnostics for coverage gaps and unresolved dynamic debt, including per-occurrence impact and relationship-aware suggestions for Agents.
+- Reduced false positives from generated metadata namespaces, `defimpl` declarations, and singleton-list wrappers around Cirru data declarations.
+- Updated Agent and feature documentation with a concise workflow for replacing accidental dynamic types with concrete types, type variables, trait bounds, parameterized containers, or enums.
+
+## Validation
+
+- `cargo fmt`
+- `cargo clippy -- -D warnings`
+- `cargo test`
+- `yarn compile`
+- `yarn check-agent-interface` (12/12 scenarios)
+- `yarn check-all`
+- `cr docs check-md` for `docs/CalcitAgent.md`, `docs/features/static-analysis.md`, and `docs/features/polymorphism.md`
+- Real-project regression on a temporary Respo workflow copy, including type reports and successful `cr js` compilation.

package/editing-history/202607301429-entry-type-slots.md

@@ -0,0 +1,29 @@
+# Entry-level type slots
+
+Date: 2026-07-30 14:29 +0800
+
+## Context
+
+`with-type-slot` represented a build-wide type choice as a body wrapper. Its single-body and multi-body preprocessing paths diverged, so adding an otherwise meaningless `do` could decide whether a runtime `with-type-slot` call leaked into generated code. Respo also needs the same dispatch `Op` type across a large component call graph without passing generics through every API.
+
+## Changes
+
+- Added optional `:type-slots` maps to default and named entry configurations.
+- Added `cr config type-slots`, `set-type-slot`, and `rm-type-slot` commands.
+- Installed the selected entry's bindings before preprocessing and validated configured full type paths after module loading.
+- Kept named entry configurations independent instead of inheriting default bindings.
+- Made `with-type-slot` compile-time-only for both single and multiple bodies; codegen now rejects leaked forms.
+- Preserved unrelated raw Snapshot EDN when a type-slot config command writes its map.
+- Migrated type-slot fixtures and added round-trip, entry isolation, diagnostic, and multi-body erasure coverage.
+- Updated the static-analysis, entry, project-structure, core API, and RFC documentation.
+
+## Validation
+
+- `cargo fmt --all`
+- `cargo clippy -- -D warnings`
+- `cargo test`
+- `yarn compile`
+- `yarn check-agent-interface`
+- `yarn check-all`
+- Calcit Markdown checks for the updated static-analysis and entry documentation
+- Respo main/test entry regression, JS codegen, Node tests, and all Markdown code blocks with the new CLI

package/editing-history/202607301435-release-0.12.54.md

@@ -0,0 +1,22 @@
+# Release 0.12.54
+
+Date: 2026-07-30 14:35 +0800
+
+## Release scope
+
+- Entry-level `:type-slots` configuration and CLI management commands.
+- Compile-time-only `with-type-slot` erasure for single and multiple bodies.
+- Snapshot/config preservation, type-slot diagnostics, regression fixtures, and documentation.
+- The earlier PR 281 review fixes already carried by the same branch.
+
+## Pre-release evidence
+
+- Feature commit `5e180a2e` passed the repository Test workflow on PR #282.
+- Local validation passed `cargo fmt`, Clippy with warnings denied, all Rust tests, TypeScript compilation, Agent interface checks, and the full Rust/JS/WASM integration suite.
+- Respo passed check-only, JS codegen, Node tests, and all Markdown checks with the new CLI.
+
+## Version changes
+
+- `Cargo.toml`: `0.12.54`
+- `package.json`: `0.12.54`
+- `Cargo.lock`: refreshed with `cargo update --workspace`

package/editing-history/archived/2026-03-20-1229-query-window-3-with-parent-preview.md

@@ -60,13 +60,13 @@
   - 可见 `--detail-offset` 参数。
 - `cargo run --bin cr -- /Users/jon.chen/repo/respo/respo/calcit.cirru query search --help`
   - `--start-path` 示例为点号格式。
-- `cargo run --bin cr -- /Users/jon.chen/repo/respo/respo/calcit.cirru query search state -f respo.app.comp.todolist/comp-todolist --detail-offset 5`
+- `cargo run --bin cr -- /Users/jon.chen/repo/respo/respo/calcit.cirru query search state --filter respo.app.comp.todolist/comp-todolist --detail-offset 5`
   - 输出降噪，路径为点号，窗口外压缩。
-- `cargo run --bin cr -- /Users/jon.chen/repo/respo/respo/calcit.cirru query search state -f respo.app.comp.todolist/comp-todolist --detail-offset 0`
+- `cargo run --bin cr -- /Users/jon.chen/repo/respo/respo/calcit.cirru query search state --filter respo.app.comp.todolist/comp-todolist --detail-offset 0`
   - 详情窗口为 `[0, 3)`，每条命中仅展示一行（优先父节点预览）。
-- `cargo run --bin cr -- /Users/jon.chen/repo/respo/respo/calcit.cirru query search state -f respo.app.comp.todolist/comp-todolist --detail-offset 0 --exact`
+- `cargo run --bin cr -- /Users/jon.chen/repo/respo/respo/calcit.cirru query search state --filter respo.app.comp.todolist/comp-todolist --detail-offset 0 --exact`
   - 精确命中不再把 `states` 视觉误判为 `state`；且不显示“add --exact”提示。
-- `cargo run --bin cr -- /Users/jon.chen/repo/respo/respo/calcit.cirru query search-expr state -f respo.app.comp.todolist/comp-todolist --detail-offset 0`
+- `cargo run --bin cr -- /Users/jon.chen/repo/respo/respo/calcit.cirru query search-expr state --filter respo.app.comp.todolist/comp-todolist --detail-offset 0`
   - 输出样式一致（单行预览）。
-- `cargo run --bin cr -- /Users/jon.chen/repo/respo/respo/calcit.cirru query search-expr state -f respo.app.comp.todolist/comp-todolist --detail-offset 0 --exact`
+- `cargo run --bin cr -- /Users/jon.chen/repo/respo/respo/calcit.cirru query search-expr state --filter respo.app.comp.todolist/comp-todolist --detail-offset 0 --exact`
   - 结果为 `No matches found`，符合结构精确匹配预期。

package/editing-history/archived/2026-03-23-1137-command-echo-tool-output-cleanup.md

@@ -60,8 +60,8 @@
 - `cargo run --bin cr -- calcit/test.cirru analyze js-unescape 'demo_$q_'`
 - `cargo run --bin cr -- calcit/test.cirru query ns app.main`
 - `cargo run --bin cr -- calcit/test.cirru query find render`
-- `cargo run --bin cr -- calcit/test.cirru tree show app.main/test-json -p ''`
-- `cargo run --bin cr -- calcit/test.cirru docs search chunk -f agent-advanced.md`
+- `cargo run --bin cr -- calcit/test.cirru tree show app.main/test-json --path ''`
+- `cargo run --bin cr -- calcit/test.cirru docs search chunk --filename agent-advanced.md`
 - `cargo run --bin cr -- demos/calcit.cirru docs check-md docs/CalcitAgent.md`
 - `cargo run --bin cr -- /tmp/calcit-cli-demo/calcit.cirru tree replace ...` 多次人工检查 replace 输出形态
 

package/lib/calcit.procs.d.mts

@@ -20,6 +20,7 @@ export declare const calcit_package_json: {
         "bench-recur-smoke": string;
         "check-smooth": string;
         "check-all": string;
+        "check-agent-interface": string;
         "try-all": string;
         "try-rs": string;
         "warn-dyn-method": string;

package/lib/package.json

@@ -1,6 +1,6 @@
 {
     "name": "@calcit/procs",
-    "version": "0.12.52",
+    "version": "0.12.54",
     "main": "./lib/calcit.procs.mjs",
     "devDependencies": {
         "@types/node": "^25.7.0",
@@ -18,7 +18,8 @@
         "test-snippets": "cargo test -q snippets::tests",
         "bench-recur-smoke": "cargo run --bin cr -- calcit/test.cirru js && node --input-type=module -e \"import { test_loop } from './js-out/test-recursion.main.mjs'; const n=3000; const t0=process.hrtime.bigint(); for(let i=0;i<n;i++) test_loop(); const dt=Number(process.hrtime.bigint()-t0)/1e6; console.log('test_loop_ms='+dt.toFixed(3));\"",
         "check-smooth": "yarn fmt-rs && yarn lint-rs && yarn test-rs && yarn check-all",
-        "check-all": "yarn compile && yarn try-rs && yarn try-js && yarn try-ir && yarn try-wasm",
+        "check-all": "yarn compile && yarn check-agent-interface && yarn try-rs && yarn try-js && yarn try-ir && yarn try-wasm",
+        "check-agent-interface": "cargo build --bin cr && node scripts/check-agent-interface.mjs",
         "try-all": "yarn check-all",
         "try-rs": "cargo run --bin cr -- calcit/test.cirru",
         "warn-dyn-method": "cargo run --bin cr -- calcit/test.cirru --warn-dyn-method",

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@calcit/procs",
-  "version": "0.12.52",
+  "version": "0.12.54",
   "main": "./lib/calcit.procs.mjs",
   "devDependencies": {
     "@types/node": "^25.7.0",
@@ -18,7 +18,8 @@
     "test-snippets": "cargo test -q snippets::tests",
     "bench-recur-smoke": "cargo run --bin cr -- calcit/test.cirru js && node --input-type=module -e \"import { test_loop } from './js-out/test-recursion.main.mjs'; const n=3000; const t0=process.hrtime.bigint(); for(let i=0;i<n;i++) test_loop(); const dt=Number(process.hrtime.bigint()-t0)/1e6; console.log('test_loop_ms='+dt.toFixed(3));\"",
     "check-smooth": "yarn fmt-rs && yarn lint-rs && yarn test-rs && yarn check-all",
-    "check-all": "yarn compile && yarn try-rs && yarn try-js && yarn try-ir && yarn try-wasm",
+    "check-all": "yarn compile && yarn check-agent-interface && yarn try-rs && yarn try-js && yarn try-ir && yarn try-wasm",
+    "check-agent-interface": "cargo build --bin cr && node scripts/check-agent-interface.mjs",
     "try-all": "yarn check-all",
     "try-rs": "cargo run --bin cr -- calcit/test.cirru",
     "warn-dyn-method": "cargo run --bin cr -- calcit/test.cirru --warn-dyn-method",