@blxzer/pactile 0.5.0 → 0.6.0-beta.2

package/README.md

@@ -1,108 +1,111 @@
-# `@blxzer/pactile`
-
-English | [简体中文](README.zh-CN.md)
-
-The Pactile CLI creates and maintains an evidence-backed capability workspace for Cursor, Codex, or both. Canonical state lives in `.pactile/`; host files are rebuildable projections governed by explicit ownership.
-
-## Install
-
-```bash
-npm install -g @blxzer/pactile
-pactile --version
-```
-
-Node.js 18.17 or newer is required. Generated Python scripts and host hooks require Python 3.9 or newer. Smart Search and other middleware providers are optional, independently probed capabilities; Pactile does not silently install host-native assets or copy credentials.
-
-## First project
-
-```bash
-mkdir my-pactile-project
-cd my-pactile-project
-pactile init --cursor --codex -y
-pactile capability-smoke --json
-```
-
-Choose `--cursor`, `--codex`, or both. Existing user files and native assets are inspected before projection. A compatible external asset may be adopted as borrowed; a conflict or malformed host file remains untouched and produces a recovery action.
-
-## Command reference
-
-| Command                                              | Contract                                                                          |
-| ---------------------------------------------------- | --------------------------------------------------------------------------------- |
-| `pactile init --cursor [--codex]`                    | Create canonical state and reconcile the selected adapters.                       |
-| `pactile capability-smoke [--json] [--write-status]` | Probe selected capabilities and optionally persist readiness.                     |
-| `pactile update --dry-run`                           | Preview official-file, migration, and projection changes.                         |
-| `pactile update`                                     | Apply one confirmed transaction, then reconcile adapters independently.           |
-| `pactile migrate`                                    | Produce the optional migration preview; actual writes remain in `update`.         |
-| `pactile rollout`                                    | Run `update` across explicit project paths and aggregate evidence.                |
-| `pactile upgrade`                                    | Upgrade the globally installed canonical CLI package.                             |
-| `pactile detach cursor`                              | Remove one adapter's bindings and claims; preserve shared and borrowed resources. |
-| `pactile detach codex`                               | Apply the same single-adapter contract to Codex.                                  |
-| `pactile uninstall --dry-run`                        | Preview detaching all adapters while retaining `.pactile/`.                       |
-| `pactile rollback <generation> --dry-run`            | Verify and preview a sealed generation switch.                                    |
-| `pactile purge --dry-run`                            | Produce the exact inactive-root target fingerprint; does not delete.              |
-| `pactile workflow`                                   | List or select a canonical workflow template.                                     |
-| `pactile validate-rules`                             | Validate supported Cursor rule projections.                                       |
-| `pactile kernel --json`                              | Run the machine JSON lifecycle boundary used by generated project scripts.        |
-
-Run `pactile <command> --help` for current flags. `detach` takes the adapter as a positional argument. `purge` is intentionally two-step: a destructive run requires `--yes` plus the exact fingerprint returned by the preview.
-
-## Init options that affect ownership
-
-- `--import-cstl` explicitly declares an existing legacy tree as a read-only migration source. It never becomes a write target.
-- `--capability <id>` enables an optional project capability; use the flag repeatedly or pass `all`.
-- `--with-optional <name>` installs a packaged optional Skill into the project Skill directory. It does not install host-native plugins or services.
-- `--skip-readiness` records framework readiness as unverified instead of inventing a provider result.
-- `--force` and `--skip-existing` control file conflicts, but do not transfer ownership of user assets.
-
-## Update, recovery, and exit
-
-Always preview uncertain changes:
-
-```bash
-pactile update --dry-run --json
-pactile detach cursor --dry-run
-pactile uninstall --dry-run
-pactile rollback <generation> --dry-run
-pactile purge --dry-run
-```
-
-Canonical generation commit happens before host reconciliation. If one adapter fails, canonical state and successful sibling adapters remain intact; the failed adapter keeps a retryable receipt. Update and exit decisions consult the ownership ledger, so modified, foreign, unknown, shared, and borrowed resources fail safe.
-
-See the repository guides for [Lifecycle](../../docs/lifecycle/index.md), [Recovery](../../docs/troubleshooting/recovery.md), and [Projection and Ownership](../../docs/concepts/projection-and-ownership.md).
-
-## Package graph
-
-| Package                | Role                                                                    |
-| ---------------------- | ----------------------------------------------------------------------- |
-| `@blxzer/pactile`      | Canonical CLI, adapters, templates, lifecycle, and project integration. |
-| `@blxzer/pactile-core` | Canonical strict contracts and host-neutral primitives.                 |
-| Legacy CLI bridge      | Deprecated 0.5.x compatibility package delegating to this CLI.          |
-| Legacy core bridge     | Deprecated 0.5.x compatibility package re-exporting canonical Core.     |
-
-Packed internal dependencies are exact release versions and never retain a workspace protocol. The published CLI exposes `pactile`; compatibility executables are not the preferred interface.
-
-## Programmatic exports
-
-```js
-import { VERSION, listPactilePlatforms } from "@blxzer/pactile";
-
-console.log(VERSION, listPactilePlatforms());
-```
-
-The root export contains the supported library surface. `./cli` is the executable entry used by the package bridge, `./compat` is reserved for that temporary bridge, and `./package.json` is exported for tooling. For host-neutral contracts, import from `@blxzer/pactile-core` and its documented subpaths.
-
-## Security boundary
-
-Pactile stores logical provider references and Evidence links, not secret values, OAuth state, private model reasoning, or copied external asset bodies. Adapters cannot write canonical `.pactile/` state; the reconciler is the only projection writer. Borrowed assets retain `preserve` deletion policy.
-
-## More documentation
-
-- [Repository overview](../../README.md)
-- [Five-minute example](../../examples/minimal-agent-app/README.md)
-- [Core concepts](../../docs/concepts/index.md)
-- [Hosts](../../docs/hosts/index.md)
-- [Capabilities and providers](../../docs/capabilities/index.md)
-- [Lifecycle](../../docs/lifecycle/index.md)
+# `@blxzer/pactile`
+
+English | [简体中文](README.zh-CN.md)
+
+The Pactile CLI creates and maintains an evidence-backed capability workspace for Codex. Canonical state lives in `.pactile/`; host files are rebuildable projections governed by explicit ownership.
+
+## Install
+
+```bash
+npm install -g @blxzer/pactile
+pactile --version
+```
+
+Node.js 18.17 or newer is required. Pactile's task, context, and session commands use Node.js; Python is not required. Smart Search and other middleware providers are optional, independently probed capabilities; Pactile does not silently install host-native assets or copy credentials.
+
+## First project
+
+```bash
+mkdir my-pactile-project
+cd my-pactile-project
+pactile init --codex -y
+pactile capability-smoke --json
+```
+
+Use `--codex` to select the active host. Existing user files and native assets are inspected before projection. A compatible external asset may be adopted as borrowed; a conflict or malformed host file remains untouched and produces a recovery action.
+
+## Command reference
+
+| Command                                              | Contract                                                                          |
+| ---------------------------------------------------- | --------------------------------------------------------------------------------- |
+| `pactile init --codex`                               | Create canonical state and reconcile the Codex adapter.                          |
+| `pactile capability-smoke [--json] [--write-status]` | Probe selected capabilities and optionally persist readiness.                     |
+| `pactile update --dry-run`                           | Preview official-file, migration, and projection changes.                         |
+| `pactile update`                                     | Apply one confirmed transaction, then reconcile adapters independently.           |
+| `pactile migrate`                                    | Produce the optional migration preview; actual writes remain in `update`.         |
+| `pactile rollout`                                    | Run `update` across explicit project paths and aggregate evidence.                |
+| `pactile upgrade`                                    | Upgrade the globally installed canonical CLI package.                             |
+| `pactile detach cursor`                              | Review and remove a legacy Cursor adapter without deleting modified user files.  |
+| `pactile detach codex`                               | Apply the same single-adapter contract to Codex.                                  |
+| `pactile uninstall --dry-run`                        | Preview detaching all adapters while retaining `.pactile/`.                       |
+| `pactile rollback <generation> --dry-run`            | Verify and preview a sealed generation switch.                                    |
+| `pactile purge --dry-run`                            | Produce the exact inactive-root target fingerprint; does not delete.              |
+| `pactile workflow`                                   | List or select a canonical workflow template.                                     |
+| `pactile task <command>`                             | Manage Node-backed task lifecycle, evidence gates, and Parent/Child review.       |
+| `pactile context --mode session`                     | Compile the phase-scoped session pack.                                            |
+| `pactile context --mode retrieval-pack --input <file>` | Score and budget collected evidence; optionally write it with `--output <file>`. |
+| `pactile session <command>`                          | Record and inspect local session continuity.                                     |
+| `pactile kernel --json`                              | Run the machine JSON lifecycle boundary used by generated project scripts.        |
+
+Run `pactile <command> --help` for current flags. `detach` takes the adapter as a positional argument. `purge` is intentionally two-step: a destructive run requires `--yes` plus the exact fingerprint returned by the preview.
+
+## Init options that affect ownership
+
+- [Explicit legacy import](../../docs/pactile/compatibility-inputs.md#explicit-import) declares an existing tree as a read-only migration source. It never becomes a write target.
+- `--capability <id>` enables an optional project capability; use the flag repeatedly or pass `all`.
+- `--with-optional <name>` installs a packaged optional Skill into the project Skill directory. It does not install host-native plugins or services.
+- `--skip-readiness` records framework readiness as unverified instead of inventing a provider result.
+- `--force` and `--skip-existing` control file conflicts, but do not transfer ownership of user assets.
+
+## Update, recovery, and exit
+
+Always preview uncertain changes:
+
+```bash
+pactile update --dry-run --json
+pactile detach cursor --dry-run
+pactile uninstall --dry-run
+pactile rollback <generation> --dry-run
+pactile purge --dry-run
+```
+
+Canonical generation commit happens before host reconciliation. A failed adapter keeps a retryable receipt. Update and exit decisions consult the ownership ledger, so modified, foreign, unknown, shared, and borrowed resources fail safe.
+
+See the repository guides for [Lifecycle](../../docs/lifecycle/index.md), [Recovery](../../docs/troubleshooting/recovery.md), and [Projection and Ownership](../../docs/concepts/projection-and-ownership.md).
+
+## Package
+
+`@blxzer/pactile` is the only package published for v0.6.0. Its tarball contains
+the CLI, adapters, templates, lifecycle, and Core task/contracts API. It has no
+external `@blxzer/pactile-core` dependency or workspace protocol. The `pactile`
+bin is the preferred entry; the older command spelling remains a warning
+alias for existing installations.
+
+## Programmatic exports
+
+```js
+import { VERSION, listPactilePlatforms } from "@blxzer/pactile";
+
+console.log(VERSION, listPactilePlatforms());
+```
+
+The root export contains the supported library surface. `./cli` is the
+executable entry, `./package.json` is exported for tooling, and the Core
+contracts are available from `@blxzer/pactile/core` and
+`@blxzer/pactile/core/task`.
+
+## Security boundary
+
+Pactile stores logical provider references and Evidence links, not secret values, OAuth state, private model reasoning, or copied external asset bodies. Adapters cannot write canonical `.pactile/` state; the reconciler is the only projection writer. Borrowed assets retain `preserve` deletion policy.
+
+## More documentation
+
+- [Repository overview](../../README.md)
+- [Five-minute example](../../examples/minimal-agent-app/README.md)
+- [Core concepts](../../docs/concepts/index.md)
+- [Hosts](../../docs/hosts/index.md)
+- [Capabilities and providers](../../docs/capabilities/index.md)
+- [Lifecycle](../../docs/lifecycle/index.md)
 - [Troubleshooting](../../docs/troubleshooting/index.md)
 
 Release and registry mutation procedures are intentionally absent from this public package README.

package/README.zh-CN.md

@@ -1,108 +1,108 @@
-# `@blxzer/pactile`
-
-[English](README.md) | 简体中文
-
-Pactile CLI 为 Cursor、Codex 或双宿主建立并维护可追溯证据的能力工作空间。Canonical 状态位于 `.pactile/`；宿主文件是可重建投影，并受显式 ownership 约束。
-
-## 安装
-
-```bash
-npm install -g @blxzer/pactile
-pactile --version
-```
-
-需要 Node.js 18.17 或更高版本。生成的 Python 脚本与宿主 hooks 需要 Python 3.9 或更高版本。Smart Search 等 Middleware Provider 是可选、独立探测的能力；Pactile 不会静默安装宿主原生资产，也不会复制凭据。
-
-## 第一个项目
-
-```bash
-mkdir my-pactile-project
-cd my-pactile-project
-pactile init --cursor --codex -y
-pactile capability-smoke --json
-```
-
-选择 `--cursor`、`--codex`，或同时使用两者。生成投影前会检查既有用户文件和原生资产。兼容的外部资产可以 borrowed 方式 adopt；冲突或 malformed 宿主文件保持原样，并返回恢复动作。
-
-## 命令参考
-
-| 命令                                                 | 契约                                                           |
-| ---------------------------------------------------- | -------------------------------------------------------------- |
-| `pactile init --cursor [--codex]`                    | 创建 canonical 状态并协调所选 Adapter。                        |
-| `pactile capability-smoke [--json] [--write-status]` | 探测所选能力，并可写入 readiness。                             |
-| `pactile update --dry-run`                           | 预览官方文件、迁移与投影变化。                                 |
-| `pactile update`                                     | 应用一次确认过的事务，再独立协调各 Adapter。                   |
-| `pactile migrate`                                    | 生成可选迁移预览；实际写入仍由 `update` 完成。                 |
-| `pactile rollout`                                    | 对显式项目路径运行 `update` 并汇总证据。                       |
-| `pactile upgrade`                                    | 升级全局安装的 canonical CLI 包。                              |
-| `pactile detach cursor`                              | 移除一个 Adapter 的绑定与 claimant；保留共享和 borrowed 资源。 |
-| `pactile detach codex`                               | 对 Codex 应用相同的单 Adapter 契约。                           |
-| `pactile uninstall --dry-run`                        | 预览分离全部 Adapter，同时保留 `.pactile/`。                   |
-| `pactile rollback <generation> --dry-run`            | 验证并预览 sealed generation 切换。                            |
-| `pactile purge --dry-run`                            | 生成 inactive canonical root 的精确目标指纹，不删除。          |
-| `pactile workflow`                                   | 列出或选择 canonical workflow 模板。                           |
-| `pactile validate-rules`                             | 验证受支持的 Cursor rule 投影。                                |
-| `pactile kernel --json`                              | 运行生成项目脚本使用的机器 JSON 生命周期边界。                 |
-
-用 `pactile <command> --help` 查看当前参数。`detach` 使用位置参数指定 Adapter。`purge` 固定为两步：破坏性执行必须同时提供 `--yes` 和 preview 返回的精确指纹。
-
-## 影响 ownership 的 init 参数
-
-- `--import-cstl` 显式声明一个既有旧树作为只读迁移源；它永远不会变成写入目标。
-- `--capability <id>` 启用可选项目能力；可重复使用或传入 `all`。
-- `--with-optional <name>` 把包内可选 Skill 安装到项目 Skill 目录；不会安装宿主原生插件或服务。
-- `--skip-readiness` 将 framework readiness 记录为 unverified，而不是虚构 Provider 结果。
-- `--force` 与 `--skip-existing` 控制文件冲突，但不会转移用户资产所有权。
-
-## 更新、恢复与退出
-
-对不确定的操作先做 preview：
-
-```bash
-pactile update --dry-run --json
-pactile detach cursor --dry-run
-pactile uninstall --dry-run
-pactile rollback <generation> --dry-run
-pactile purge --dry-run
-```
-
-Canonical generation 在宿主协调前提交。如果一个 Adapter 失败，canonical 状态和已成功的 sibling Adapter 保持有效；失败 Adapter 保留可重试 receipt。更新与退出决策会查询 ownership ledger，因此 modified、foreign、unknown、shared 与 borrowed 资源都会安全保留。
-
-详细说明见[生命周期](../../docs/lifecycle/index.zh-CN.md)、[恢复](../../docs/troubleshooting/recovery.zh-CN.md)和 [Projection 与 Ownership](../../docs/concepts/projection-and-ownership.zh-CN.md)。
-
-## 包关系
-
-| 包                     | 角色                                                |
-| ---------------------- | --------------------------------------------------- |
-| `@blxzer/pactile`      | Canonical CLI、Adapters、模板、生命周期与项目集成。 |
-| `@blxzer/pactile-core` | Canonical 严格契约与宿主无关原语。                  |
-| 旧 CLI bridge          | 0.5.x 临时兼容包，委托给本 CLI。                    |
-| 旧 Core bridge         | 0.5.x 临时兼容包，重新导出 canonical Core。         |
-
-打包后的内部依赖必须是精确发布版本，不能残留 workspace protocol。发布 CLI 暴露 `pactile`；兼容 executable 不是推荐入口。
-
-## 程序化导出
-
-```js
-import { VERSION, listPactilePlatforms } from "@blxzer/pactile";
-
-console.log(VERSION, listPactilePlatforms());
-```
-
-根导出提供受支持的库接口。`./cli` 是 package bridge 使用的 executable 入口，`./compat` 仅供这一临时 bridge，`./package.json` 供工具读取。宿主无关契约应从 `@blxzer/pactile-core` 及其已记录的 subpath 导入。
-
-## 安全边界
-
-Pactile 存储逻辑 Provider 引用与 Evidence 链接，不保存 secret value、OAuth 状态、模型私有推理或复制的外部资产正文。Adapter 不能写 canonical `.pactile/` 状态；只有 Reconciler 能写投影。Borrowed 资产始终使用 `preserve` 删除策略。
-
-## 更多文档
-
-- [仓库概览](../../README.zh-CN.md)
-- [五分钟示例](../../examples/minimal-agent-app/README.zh-CN.md)
-- [核心概念](../../docs/concepts/index.zh-CN.md)
-- [宿主](../../docs/hosts/index.zh-CN.md)
-- [能力与 Provider](../../docs/capabilities/index.zh-CN.md)
-- [生命周期](../../docs/lifecycle/index.zh-CN.md)
+# `@blxzer/pactile`
+
+[English](README.md) | 简体中文
+
+Pactile CLI 为 Codex 建立并维护可追溯证据的能力工作空间。Canonical 状态位于 `.pactile/`；宿主文件是可重建投影，并受显式 ownership 约束。
+
+## 安装
+
+```bash
+npm install -g @blxzer/pactile
+pactile --version
+```
+
+需要 Node.js 18.17 或更高版本。Pactile 的任务、上下文和会话命令使用 Node.js，不要求 Python。Smart Search 等 Middleware Provider 是可选、独立探测的能力；Pactile 不会静默安装宿主原生资产，也不会复制凭据。
+
+## 第一个项目
+
+```bash
+mkdir my-pactile-project
+cd my-pactile-project
+pactile init --codex -y
+pactile capability-smoke --json
+```
+
+使用 `--codex` 选择当前宿主。生成投影前会检查既有用户文件和原生资产。兼容的外部资产可以 borrowed 方式 adopt；冲突或 malformed 宿主文件保持原样，并返回恢复动作。
+
+## 命令参考
+
+| 命令                                                 | 契约                                                           |
+| ---------------------------------------------------- | -------------------------------------------------------------- |
+| `pactile init --codex`                               | 创建 canonical 状态并协调 Codex Adapter。                      |
+| `pactile capability-smoke [--json] [--write-status]` | 探测所选能力，并可写入 readiness。                             |
+| `pactile update --dry-run`                           | 预览官方文件、迁移与投影变化。                                 |
+| `pactile update`                                     | 应用一次确认过的事务，再独立协调各 Adapter。                   |
+| `pactile migrate`                                    | 生成可选迁移预览；实际写入仍由 `update` 完成。                 |
+| `pactile rollout`                                    | 对显式项目路径运行 `update` 并汇总证据。                       |
+| `pactile upgrade`                                    | 升级全局安装的 canonical CLI 包。                              |
+| `pactile detach cursor`                              | 审阅并移除旧 Cursor Adapter，保留已修改的用户文件。            |
+| `pactile detach codex`                               | 对 Codex 应用相同的单 Adapter 契约。                           |
+| `pactile uninstall --dry-run`                        | 预览分离全部 Adapter，同时保留 `.pactile/`。                   |
+| `pactile rollback <generation> --dry-run`            | 验证并预览 sealed generation 切换。                            |
+| `pactile purge --dry-run`                            | 生成 inactive canonical root 的精确目标指纹，不删除。          |
+| `pactile workflow`                                   | 列出或选择 canonical workflow 模板。                           |
+| `pactile task <command>`                            | 用 Node 管理任务生命周期、证据门槛与 Parent/Child 审核。        |
+| `pactile context --mode session`                    | 编译按阶段裁剪的会话上下文包。                                 |
+| `pactile context --mode retrieval-pack --input <file>` | 对已收集证据评分并按预算选取；可用 `--output <file>` 写出。   |
+| `pactile session <command>`                         | 记录和查看本地会话连续性。                                     |
+| `pactile kernel --json`                              | 运行生成项目脚本使用的机器 JSON 生命周期边界。                 |
+
+用 `pactile <command> --help` 查看当前参数。`detach` 使用位置参数指定 Adapter。`purge` 固定为两步：破坏性执行必须同时提供 `--yes` 和 preview 返回的精确指纹。
+
+## 影响 ownership 的 init 参数
+
+- [显式旧树导入](../../docs/pactile/compatibility-inputs.zh-CN.md#显式导入)声明一个既有旧树作为只读迁移源；它永远不会变成写入目标。
+- `--capability <id>` 启用可选项目能力；可重复使用或传入 `all`。
+- `--with-optional <name>` 把包内可选 Skill 安装到项目 Skill 目录；不会安装宿主原生插件或服务。
+- `--skip-readiness` 将 framework readiness 记录为 unverified，而不是虚构 Provider 结果。
+- `--force` 与 `--skip-existing` 控制文件冲突，但不会转移用户资产所有权。
+
+## 更新、恢复与退出
+
+对不确定的操作先做 preview：
+
+```bash
+pactile update --dry-run --json
+pactile detach cursor --dry-run
+pactile uninstall --dry-run
+pactile rollback <generation> --dry-run
+pactile purge --dry-run
+```
+
+Canonical generation 在宿主协调前提交。失败的 Adapter 保留可重试 receipt。更新与退出决策会查询 ownership ledger，因此 modified、foreign、unknown、shared 与 borrowed 资源都会安全保留。
+
+详细说明见[生命周期](../../docs/lifecycle/index.zh-CN.md)、[恢复](../../docs/troubleshooting/recovery.zh-CN.md)和 [Projection 与 Ownership](../../docs/concepts/projection-and-ownership.zh-CN.md)。
+
+## 包
+
+v0.6.0 只发布 `@blxzer/pactile`。tarball 内含 CLI、Adapters、模板、生命周期和
+Core 任务/契约 API；不依赖外部 `@blxzer/pactile-core`，也不含 workspace
+协议。`pactile` 是推荐命令；旧命令拼写仅作为已有安装的提示性别名。
+
+## 程序化导出
+
+```js
+import { VERSION, listPactilePlatforms } from "@blxzer/pactile";
+
+console.log(VERSION, listPactilePlatforms());
+```
+
+根导出提供受支持的库接口，`./cli` 是可执行入口，`./package.json` 供工具
+读取。宿主无关契约从 `@blxzer/pactile/core` 或
+`@blxzer/pactile/core/task` 导入。
+
+## 安全边界
+
+Pactile 存储逻辑 Provider 引用与 Evidence 链接，不保存 secret value、OAuth 状态、模型私有推理或复制的外部资产正文。Adapter 不能写 canonical `.pactile/` 状态；只有 Reconciler 能写投影。Borrowed 资产始终使用 `preserve` 删除策略。
+
+## 更多文档
+
+- [仓库概览](../../README.zh-CN.md)
+- [五分钟示例](../../examples/minimal-agent-app/README.zh-CN.md)
+- [核心概念](../../docs/concepts/index.zh-CN.md)
+- [宿主](../../docs/hosts/index.zh-CN.md)
+- [能力与 Provider](../../docs/capabilities/index.zh-CN.md)
+- [生命周期](../../docs/lifecycle/index.zh-CN.md)
 - [故障排查](../../docs/troubleshooting/index.zh-CN.md)
 
 公开 package README 刻意不包含 release 或 registry 写操作说明。

package/bin/compat-warning.js

@@ -1,11 +1,11 @@
-let warned = false;
-
-export function warnLegacyCliOnce() {
-  if (warned) return;
-  warned = true;
-  process.stderr.write(
-    '[pactile] Deprecated compatibility entry: use "pactile" from ' +
-      '@blxzer/pactile; the "cstl" and @blxzer/cursor-trellis aliases ' +
-      'remain only through 0.5.x.\n',
-  );
-}
+let warned = false;
+
+export function warnLegacyCliOnce() {
+  if (warned) return;
+  warned = true;
+  process.stderr.write(
+    '[pactile] Deprecated compatibility entry: use "pactile" from ' +
+      '@blxzer/pactile; the "cstl" and @blxzer/cursor-trellis aliases ' +
+      'remain only through 0.5.x.\n',
+  );
+}

package/bin/cstl.js

@@ -1,6 +1,6 @@
-#!/usr/bin/env node
-
-import { warnLegacyCliOnce } from "./compat-warning.js";
-
-warnLegacyCliOnce();
-import("../dist/cli/index.js");
+#!/usr/bin/env node
+
+import { warnLegacyCliOnce } from "./compat-warning.js";
+
+warnLegacyCliOnce();
+import("../dist/cli/index.js");

package/bin/pactile.js

@@ -1,3 +1,3 @@
-#!/usr/bin/env node
-
-import("../dist/cli/index.js");
+#!/usr/bin/env node
+
+import("../dist/cli/index.js");

package/bin/smart-search.js

@@ -1,38 +1,38 @@
-#!/usr/bin/env node
-
-import { spawn } from "node:child_process";
-import { existsSync } from "node:fs";
-import { dirname, join } from "node:path";
-import { fileURLToPath } from "node:url";
-
-// Probe wrapper: smart-search is an independent Middleware Provider.
-// Missing package is degraded, not a Core/Kernel load failure.
-const __filename = fileURLToPath(import.meta.url);
-const __dirname = dirname(__filename);
-
-const smartSearchBin = join(
-  __dirname,
-  "..",
-  "node_modules",
-  "@blxzer",
-  "smart-search",
-  "npm",
-  "bin",
-  "smart-search.js"
-);
-
-if (!existsSync(smartSearchBin)) {
-  console.error(
-    "smart-search Provider is not installed. Pactile treats this as optional Middleware (external-knowledge). Install @blxzer/smart-search separately, or continue tasks that do not need external knowledge.",
-  );
-  process.exit(2);
-}
-
-const child = spawn(process.execPath, [smartSearchBin, ...process.argv.slice(2)], {
-  stdio: "inherit",
-  windowsHide: true,
-});
-
-child.on("exit", (code) => {
-  process.exit(code ?? 1);
-});
+#!/usr/bin/env node
+
+import { spawn } from "node:child_process";
+import { existsSync } from "node:fs";
+import { dirname, join } from "node:path";
+import { fileURLToPath } from "node:url";
+
+// Probe wrapper: smart-search is an independent Middleware Provider.
+// Missing package is degraded, not a Core/Kernel load failure.
+const __filename = fileURLToPath(import.meta.url);
+const __dirname = dirname(__filename);
+
+const smartSearchBin = join(
+  __dirname,
+  "..",
+  "node_modules",
+  "@blxzer",
+  "smart-search",
+  "npm",
+  "bin",
+  "smart-search.js"
+);
+
+if (!existsSync(smartSearchBin)) {
+  console.error(
+    "smart-search Provider is not installed. Pactile treats this as optional Middleware (external-knowledge). Install @blxzer/smart-search separately, or continue tasks that do not need external knowledge.",
+  );
+  process.exit(2);
+}
+
+const child = spawn(process.execPath, [smartSearchBin, ...process.argv.slice(2)], {
+  stdio: "inherit",
+  windowsHide: true,
+});
+
+child.on("exit", (code) => {
+  process.exit(code ?? 1);
+});

package/dist/cli/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/cli/index.ts"],"names":[],"mappings":"AAuBA,OAAO,EAAE,YAAY,EAAE,OAAO,EAAE,MAAM,yBAAyB,CAAC;AAahE,OAAO,EAAE,OAAO,EAAE,YAAY,EAAE,CAAC"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/cli/index.ts"],"names":[],"mappings":"AAqBA,OAAO,EAAE,YAAY,EAAE,OAAO,EAAE,MAAM,yBAAyB,CAAC;AAmBhE,OAAO,EAAE,OAAO,EAAE,YAAY,EAAE,CAAC"}