@calcit/procs 0.13.26 → 0.13.28

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

@@ -1,18 +0,0 @@
-# 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

@@ -1,20 +0,0 @@
-# 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

@@ -1,13 +0,0 @@
-# 补充 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

@@ -1,7 +0,0 @@
-# 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

@@ -1,6 +0,0 @@
-# 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

@@ -1,8 +0,0 @@
-# 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

@@ -1,8 +0,0 @@
-# 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-edit-target-cursor-alias.md

@@ -1,6 +0,0 @@
-# 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

@@ -1,7 +0,0 @@
-# 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

@@ -1,8 +0,0 @@
-# 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

@@ -1,5 +0,0 @@
-# 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/202608021730-release-0.12.58.md

@@ -1,5 +0,0 @@
-# Release 0.12.58
-
-- Release the receiver-first method inference and trait nominal-identity fixes merged in PR #288.
-- Synchronize the crate, npm package, and Cargo lockfile versions at `0.12.58`.
-- The merge commit passed the main Test and CodeQL workflows before this release commit.

package/editing-history/202608021928-release-0.12.59.md

@@ -1,5 +0,0 @@
-# Release 0.12.59
-
-- Release the top-level nominal value schema fix from PR #291.
-- Synchronize the crate, npm package, and Cargo lockfile versions at `0.12.59`.
-- The merged main commit passed Test and CodeQL before this release preparation.

package/editing-history/202608082312-release-0.13.5.md

@@ -1,10 +0,0 @@
-# Release 0.13.5
-
-- Bumped the Calcit package versions in `Cargo.toml`, `package.json`, and
-  `Cargo.lock` from 0.13.4 to 0.13.5.
-- Releases typed static `js-get`/`js-set` field access with external-object
-  traits (PR #316) and the `unsafe-coerce` named-type preservation fix.
-- Consolidated redundant non-functional editing-history notes (release and
-  release-policy entries) into `ARCHIVE.md`.
-- Verified with formatting, tests, clippy, compilation, full checks, agent
-  interface smoke checks, and Markdown example checks.

package/editing-history/202608090107-release-0.13.6.md

@@ -1,10 +0,0 @@
-# Release 0.13.6
-
-- Bumped the Calcit package versions in `Cargo.toml`, `package.json`, and
-  `Cargo.lock` from 0.13.5 to 0.13.6.
-- Releases the opt-in `W_JS_FFI_UNTYPED_ACCESS` warning (behind
-  `--warn-dyn-method`) for untyped raw JS FFI access on bare `JsObject`, plus
-  the cheap JS codegen readability improvements (line-based indentation, blank
-  lines between top-level functions, verbatim `&raw-code` preservation).
-- Verified with formatting, tests, clippy, compilation, full checks, agent
-  interface smoke checks, and Markdown example checks.

package/editing-history/202608091812-release-0.13.7.md

@@ -1,8 +0,0 @@
-# Release 0.13.7
-
-Released the merged definition-attached core test and `cr` CLI accuracy work.
-
-- Bumped the Rust crate and npm package versions from `0.13.6` to `0.13.7`.
-- Updated `Cargo.lock` with the workspace version through `cargo update --workspace`.
-- Release validation covers the merged PR's core tests, native/JS/WASM targets,
-  Agent CLI interface, and the repository test workflow before tagging.

package/editing-history/202608101042-release-0.13.8.md

@@ -1,6 +0,0 @@
-## Release 0.13.8
-
-- Publishes the typed Struct field-access and collection path-boundary work
-  merged through PR #327.
-- Keeps module branch resolution robust by fetching and pruning remote branch
-  refs before checkout.

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

@@ -1,8 +0,0 @@
-## 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/editing-history/202608101102-release-doc-tracked-path.md

@@ -1,5 +0,0 @@
-## 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/editing-history/202608110140-release-0.13.9.md

@@ -1,4 +0,0 @@
-## 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/editing-history/202608111349-release-0.13.10.md

@@ -1,13 +0,0 @@
-# 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/editing-history/202608111650-release-0.13.11.md

@@ -1,5 +0,0 @@
-## Release 0.13.11
-
-- Bump the Cargo crate and `@calcit/procs` package together so published artifacts stay version-aligned.
-- This release includes trailing `Option` parameter sugar, stronger typed Option/struct handling, and the terminating JS string replacement fix from the preceding merged PRs.
-- Run the full repository validation before tagging and publishing the release.

package/editing-history/202608121900-release-0.13.12.md

@@ -1,5 +0,0 @@
-# Release 0.13.12
-
-- 合并类型指导与 Dynamic 审计能力，强化 Option/Result 的组合式使用建议。
-- 支持 `Struct :field value` 类型化构造语法，省略的 `Option<T>` 字段自动补为 `%none`。
-- 更新 Struct、Agent 和类型系统相关文档及回归测试。

package/editing-history/202608130003-release-0.13.13.md

@@ -1,9 +0,0 @@
-# release 0.13.13 from caps module-store branch
-
-## Summary
-
-- Released version `0.13.13` directly from `codex/caps-project-module-store`
-  while keeping the feature branch unmerged, as requested.
-- Kept the Rust crate, npm package, and workspace lockfile versions aligned.
-- The branch had already passed PR CI; the release update was additionally
-  checked with formatting and the `caps` test suite.

package/editing-history/202608131650-release-0.13.15.md

@@ -1,10 +0,0 @@
-# Release Calcit 0.13.15
-
-## Change summary
-
-- Released the merged `decode-map-as` runtime decoder and its core snapshot metadata, examples, and tests.
-- Kept Cargo and npm package versions synchronized at `0.13.15` for the direct-main release workflow.
-
-## Knowledge point
-
-Version-only release changes are allowed directly on `main`; the functional implementation was merged and validated before this release commit. The release tag is created from the synchronized `main` commit so Cargo and npm publish the same version.

package/editing-history/20260816-0254-release-0.13.17.md

@@ -1,5 +0,0 @@
-# Release 0.13.17
-
-- PR #358 已合并到 `main`，包含嵌套 Struct 类型上下文修复、typed Struct 访问引导、项目源码迁移告警边界和 `.calcit/snippets/` 路径提示。
-- Cargo 与 npm 包版本同步从 `0.13.16` 升至 `0.13.17`，并执行 `cargo update --workspace` 更新 `Cargo.lock`。
-- 本次 release commit 位于已验证的 `main`，后续从该提交创建不带 `v` 前缀的 `0.13.17` tag 并发布 GitHub Release。

package/editing-history/20260817-0006-release-0-13-18.md

@@ -1,6 +0,0 @@
-# 2026-08-17 00:06 发布 0.13.18
-
-- PR #363 已合并到 `main`，修复宏展开字段告警的源码位置误判。
-- 将 `Cargo.toml` 与 `package.json` 版本统一升级到 `0.13.18`。
-- 执行 `cargo update --workspace` 同步 `Cargo.lock`，依赖版本无变化。
-- 后续从已同步的 `main` 创建并推送不带 `v` 前缀的 `0.13.18` tag，触发 crates.io 与 npm 发布。

package/editing-history/202608171118-project-module-runtime-resolution.md

@@ -1,6 +0,0 @@
-# Project module runtime resolution
-
-- `caps` already stores immutable dependency revisions in `~/.config/calcit/modules/.store/` and builds the project's `.calcit/modules/` link view.
-- Runtime loaders must consume only that project view. Retaining a global module fallback can silently run a dependency revision that was not selected by the project's dependency graph.
-- Centralize the project module directory calculation in `calcit::project_module_folder`, then use it for normal execution, WASM codegen, queries, configuration inspection, markdown checks, call-graph comparison, and the Cirru integration harness.
-- Keep explicitly relative and absolute module paths working; only package-style module paths are constrained to the project view.

package/editing-history/202608171133-visible-module-versions-and-cleanup.md

@@ -1,6 +0,0 @@
-# Visible module versions and cache cleanup
-
-- Store immutable module revisions under `~/.config/calcit/modules/versions/` instead of a hidden `.store/` directory, retaining the owner, repository, and resolved commit in the path.
-- Write `metadata.txt` beside each cached revision so the requested reference remains inspectable and global cleanup can select the highest SemVer release without a network request. When one commit is observed through multiple refs, retain the highest observed SemVer ref for cleanup ordering.
-- Add `caps clean` as an explicit global cleanup command. It preserves one newest revision per module (SemVer takes precedence; materialization time breaks non-SemVer ties) and removes older revision directories.
-- Rewrite `~/.config/calcit/modules/AGENTS.md` on each `caps` invocation. The guide treats `versions/` as immutable cache data and directs dependency changes through a repository commit, new tag, dependency update, and reinstall.

package/editing-history/202608171140-module-caches-root.md

@@ -1,5 +0,0 @@
-# Module caches root
-
-- Move the global immutable cache from the nested `modules/versions/` proposal to the clearer sibling path `~/.config/calcit/module-caches/`.
-- Keep `~/.config/calcit/modules/` reserved for the legacy module root and per-project link vocabulary; `module-caches/AGENTS.md` is the authoritative generated guidance for cached revisions.
-- Derive the cache root as a sibling of `CALCIT_MODULES_DIR`, so custom test and CI roots preserve the same `modules/` plus `module-caches/` layout.

package/editing-history/202608171200-module-cache-review-follow-up.md

@@ -1,5 +0,0 @@
-# Module cache review follow-up
-
-- Scope `cr docs` module documentation and scope discovery to the current project's `.calcit/modules/` directory, removing the final global fallback.
-- Register each successfully materialized project module view in `module-caches/projects/`; global cleanup preserves every cached revision that remains linked by one of those views.
-- When a cached commit is later resolved through a SemVer tag, refresh its metadata with the highest observed SemVer ref so cleanup ordering stays correct.

package/editing-history/202608171205-release-0-13-19.md

@@ -1,4 +0,0 @@
-# Release 0.13.19
-
-- Publish the project-scoped module resolution, visible `module-caches` store, safe cleanup, and documentation fixes from PR #364.
-- Keep Cargo and npm package versions synchronized at `0.13.19` for the direct PR-branch release.

package/editing-history/202608171215-module-path-resolution-docs.md

@@ -1,4 +0,0 @@
-# Module path resolution documentation
-
-- Clarify that project-local `.calcit/modules/` links are mandatory only for package-style module paths.
-- Preserve the documented behavior of explicit relative paths (resolved from the snapshot) and absolute paths (resolved directly).

package/editing-history/202608171409-module-cache-review-followup.md

@@ -1,5 +0,0 @@
-# Module cache review follow-up
-
-- Added a shared inter-process metadata lock for cache revision metadata updates and cleanup scans, preventing concurrent `caps` processes from losing the highest observed SemVer reference.
-- Made project-view installation transactional across module links and `caps-state.cirru`; registration failures now restore the previous view and state before returning an error.
-- Added concurrency and rollback regression tests, and routed module documentation tests through project-root-aware resolver helpers so the production path is covered.

package/editing-history/202608171427-module-cache-review-followup-locking.md

@@ -1,5 +0,0 @@
-# Module cache locking follow-up
-
-- Replaced removable lock files with OS-managed `fs4` locks, so ownership is released when the handle or process exits on every supported platform.
-- Held the cache lock across revision installation and metadata publication, and added a project-scoped lock spanning module view activation, state replacement, registration, rollback, and cleanup.
-- Isolated the documentation fallback regression test against the actual `$HOME/.config/calcit/modules` layout without leaking the test environment.

package/editing-history/202608171438-module-docs-home-lock.md

@@ -1,4 +0,0 @@
-# 2026-08-17 14:38 — Serialize documentation HOME access
-
-- Shared the documentation test HOME mutex between `TestHome` and tests that read the guidebook through the process environment.
-- Guarded `collect_docs_for_query_uses_guidebook_without_module` so it cannot race with tests that temporarily replace `HOME`.

package/editing-history/202608171611-dependency-audit-review.md

@@ -1,4 +0,0 @@
-# Address dependency audit documentation review
-
-- Clarified that `docs check-md --entry` takes a snapshot filename, unlike named-entry selection in `config modules` and top-level `--check-only`.
-- Recorded Markdown validation for both changed dependency-audit documents.

package/editing-history/202608181000-release-0-13-20.md

@@ -1,5 +0,0 @@
-# Release 0.13.20
-
-- Publish the typed JavaScript FFI capability boundary and browser/Node target validation from PR #367.
-- Reorganize and expand the JavaScript FFI documentation, including adapter design, diagnostics, and release checks.
-- Keep Cargo and npm package versions synchronized at `0.13.20` for the direct PR-branch release.

package/editing-history/202608181930-release-0-13-21.md

@@ -1,5 +0,0 @@
-# Release 0.13.21
-
-- Publish the typed JavaScript FFI boundary and the related struct/enum type-resolution fixes merged from PR #367.
-- Improve migration diagnostics for projects moving their version field to `deps.cirru`.
-- Keep Cargo and npm package versions synchronized at `0.13.21`.

package/history/202608191418-rfc-defenum-syntax.md

@@ -1,4 +0,0 @@
-# Correct transparent-union RFC enum examples
-
-- Removed redundant parentheses from line-oriented `defenum` variants in the transparent-union RFC.
-- Verified the `RequestState` and `RespoNode` examples with `cr cirru parse -e`.

package/history/202608191430-transparent-union-review.md

@@ -1,5 +0,0 @@
-# Transparent union review fixes
-
-- Made test-only semantic-version helpers private to remove unnecessary crate visibility.
-- Added regression coverage for transparent-union struct matching through nominal fallback and imported namespace resolution when scope types are empty.
-- Full Rust tests and Clippy validation passed; the repository-wide agent-interface check still reports an existing deprecated `cr config version` scenario.