@tea-agent/loop-agent 0.14.0 → 0.16.0

package/docs/production-readiness.md

@@ -1,96 +0,0 @@
-# Production Readiness v0.1
-
-本文档冻结 2026-07-06 至 2026-07-12 hardening sprint 的单任务 production readiness 标准。
-
-`loop-agent` production readiness v0.1 指：低/中风险的仓库本地 DAG 任务能以稳定、可解释、可验证、可恢复的方式运行。这不是组织级平台 readiness 声明。
-
-## 支持范围
-
-- 单仓库
-- 单任务或小范围有边界任务
-- 低/中风险的代码与文档变更
-- 显式 task source
-- 显式 `allowedPaths`、`forbiddenPaths`、`writeSet`
-- shell 验证命令
-- 通过 `dag report`、`dag doctor`、`promote-run`、`closeout` 交接
-
-## 非目标
-
-- 自动 merge
-- 自动 release
-- 生产 secrets
-- 生产数据库访问
-- 高风险 migration
-- 在线 Worker Pool
-- 多仓库 feature 编排
-- 可写的 Dynamic Workflow sharded migration
-- DAG runtime 之外的第二套 runner
-
-## 必需证据
-
-每个 production-ready v0.1 任务必须保留或产出以下证据：
-
-| 证据 | 要求 |
-|---|---|
-| DAG spec path | 生成的 DAG JSON 路径记录在 CLI 输出、report 或 task artifacts 中 |
-| DAG validation result | `dag validate --strict-models --strict-governance` 有新鲜输出 |
-| Run id | `run-dag` 打印或记录 run id |
-| Shell verification output | 完成声明引用新鲜命令输出，而非 model 自报 |
-| Failure category | 失败 run 在可用时具备 raw、normalized、product-line 与 recommended follow-up 字段 |
-| Closeout 或 failure handoff | 成功 run 可 promote 并 closeout；失败 run 产出 failure handoff 证据而非成功 closeout |
-
-## 必需命令
-
-标准任务路径：
-
-```bash
-loop-agent new-task <task-id> "Task title"
-loop-agent dag run-task <task-id> --profile auto --strict-models --output <temp-dir>/<task-id>-dag.json
-loop-agent dag validate --dag <temp-dir>/<task-id>-dag.json --strict-models --strict-governance
-loop-agent run-dag --dag <temp-dir>/<task-id>-dag.json --cwd .
-loop-agent dag report --run-id <run-id> --markdown
-loop-agent dag doctor --run-id <run-id>
-loop-agent promote-run <task-id> --run-id <run-id>
-loop-agent closeout task <task-id>
-```
-
-`<temp-dir>` 使用平台原生临时目录。
-
-## 必需标准
-
-| ID | 标准 | 验收 |
-|---|---|---|
-| PRD-01 | 新任务仅推荐 DAG 路径 | README、docs、website、skills 不把已移除的 Level 1 顺序命令当作 fallback |
-| PRD-02 | 写任务有显式边界 | strict DAG governance 在需要时拒绝缺失 `allowedPaths`、`forbiddenPaths` 或 `writeSet` |
-| PRD-03 | 每次 DAG run 有可读 report | `loop-agent dag report --latest --markdown` 显示 status、failure summary 与 next step |
-| PRD-04 | 失败 run 可诊断 | `loop-agent dag doctor` 报告 category 与 recommended follow-up |
-| PRD-05 | Shell 验证是完成权威 | closeout 不接受 model 自报替代新鲜命令输出 |
-| PRD-06 | Failure category 覆盖失败 fixture | validation、write guard、shell、timeout、auth、unknown fixture 均有映射 |
-| PRD-07 | 已完成 DAG facts 不可变 | completed facts guard 仍由测试覆盖 |
-| PRD-08 | CLI 主路径输出指引下一步 | `dag run-task`、`dag validate`、`run-dag`、`dag report` 打印 operator next commands |
-| PRD-09 | 文档面一致 | doc 更新后 `bash scripts/check-repo.sh` 与 `npm run docs:build` 通过 |
-| PRD-10 | sprint 完成前完整本地门禁通过 | 最终 hardening closeout 时 `bash scripts/ci.sh` 通过 |
-
-## Failure Routing
-
-Failure category 是路由字段，不是主任务状态。保留 raw DAG facts，仅在 report、doctor 输出、closeout draft、task artifacts 或后续 Task Pool 记录中追加派生字段。
-
-四层结构：
-
-```text
-raw_failure_category
-dag_normalized_failure_category
-product_line_failure_category
-recommended_follow_up
-```
-
-Product-line category 事实源：`ai_workspace/loop-agent/design/state-and-failure-taxonomy.md`。
-
-## Sprint Gate
-
-2026-07-06 sprint 仅在 active execution plan 记录以下内容时视为完成：
-
-- M1–M4 最终状态
-- 必需验证门禁的命令输出
-- 成功、write-guard、shell-failure 场景的 dogfood 证据
-- 剩余风险与后续工作

package/docs/progress/README.md

@@ -1,81 +0,0 @@
-# 进度日志
-
-本目录存放应超越聊天上下文的简洁 handoff 日志。
-
-**索引职责**：本文件维护本目录**全量文件列表**。`ai_workspace/loop-agent/README.md` 只链到本 README。
-
-## 近期要点（导读）
-
-- [`2026-07-18-observe-ops-surface-and-rich-timeline.md`](2026-07-18-observe-ops-surface-and-rich-timeline.md) — Observe 运营面/执行面重排、检查器半屏与富过程时间线收口（已归档 completed）
-- [`2026-07-17-observe-dashboard-incremental-polling-handoff.md`](2026-07-17-observe-dashboard-incremental-polling-handoff.md) — Observe 总览重复 loading/全量 DOM 重建根因、DAG 契约和跨机器恢复步骤
-- [`2026-07-17-0.13.0-merge-handoff.md`](2026-07-17-0.13.0-merge-handoff.md) — 0.13.0 合并、修复、验证与 Windows 剩余问题跨机器交接
-- [`2026-07-17-source-target-structure-alignment.md`](2026-07-17-source-target-structure-alignment.md) — 源仓库 canonical layout 对齐 fresh init，并记录首轮 write-set audit 修订
-- [`2026-07-17-fe-test-dag-archive.md`](2026-07-17-fe-test-dag-archive.md) — FE-test RAG DAG MVP + PR #25 收口归档（residual：prompt 深度 / browser smoke / website）
-- [`2026-07-17-frontend-implementation-m4-m6.md`](2026-07-17-frontend-implementation-m4-m6.md) — frontend-implementation 风险路由、项目能力、修复合同与 package surface 收口
-- [`2026-07-17-frontend-implementation-m3-repair.md`](2026-07-17-frontend-implementation-m3-repair.md) — frontend-implementation repair contract 与验证闭环
-- [`2026-07-17-frontend-implementation-m2-writer-trace.md`](2026-07-17-frontend-implementation-m2-writer-trace.md) — frontend writer trace 与 verification trace 证据
-- [`2026-07-17-frontend-implementation-contract-v1.md`](2026-07-17-frontend-implementation-contract-v1.md) — frontend implementation contract v1
-- [`2026-07-17-frontend-implementation-m0-baseline.md`](2026-07-17-frontend-implementation-m0-baseline.md) — frontend-implementation M0 能力基线
-- [`2026-07-16-frontend-mock-node.md`](2026-07-16-frontend-mock-node.md) — 前端 DAG Mock 策略、生产安全与真实接口证据边界（已验证）
-- [`2026-07-16-frontend-demand-auto-routing.md`](2026-07-16-frontend-demand-auto-routing.md) — 默认前端需求自动进入前端专用 DAG，后端/混合/未知保守回退（已验证）
-- [`2026-07-16-ready-planner.md`](2026-07-16-ready-planner.md) — Priority-aware Ready Planner：M1 core + RP-02 Feature/report/Observe 同源投影（已验证）
-- [`2026-07-15-task-pool-v2-feature-scoped-task-identity.md`](2026-07-15-task-pool-v2-feature-scoped-task-identity.md) — Task Pool v2 复合身份：M1 store + M2 consumers + M3 Observe + M4 文档收口（已归档 completed）
-- [`2026-07-15-init-update-surface-coverage.md`](2026-07-15-init-update-surface-coverage.md) — 修复初始化 surface 升级漏检（自动发现 copied 文件、blockedTargetPaths fail-safe、drift gate）实施交接（已验证）
-- [`2026-07-15-readonly-node-retry.md`](2026-07-15-readonly-node-retry.md) — 只读 Pi DAG 节点安全重试（默认策略、attempt 证据、validation 门禁）实施交接（已验证）
-- [`2026-07-15-repair-artifact-gate-runtime-contract-implementation.md`](2026-07-15-repair-artifact-gate-runtime-contract-implementation.md) — 显式 repairNodeId、runtime contract preflight 与 run-owned controller identity 实施交接（已验证）
-- [`2026-07-14-observe-ui-r5-boundary-final.md`](2026-07-14-observe-ui-r5-boundary-final.md) — R5 轻量入口与显式模块边界 DAG closeout
-- [`2026-07-14-observe-ui-r5-remediation.md`](2026-07-14-observe-ui-r5-remediation.md) — R5 浏览器状态所有权修复 DAG closeout
-- [`2026-07-14-observe-ui-r5.md`](2026-07-14-observe-ui-r5.md) — Observe 前端模块化与体验收敛（已验证）
-- [`2026-07-14-observe-ui-r4.md`](2026-07-14-observe-ui-r4.md) — Observe 事件时间线、有界 JSONL 与投影健康（已验证）
-- [`2026-07-14-observe-ui-r3.md`](2026-07-14-observe-ui-r3.md) — Observe Feature 决策详情与对象关联导航（已验证）
-- [`2026-07-14-observe-ui-r2.md`](2026-07-14-observe-ui-r2.md) — Observe Batch / Worker Run 证据化详情收口
-- [`2026-07-14-init-canonical-layout-handoff.md`](2026-07-14-init-canonical-layout-handoff.md) — 目标项目初始化布局迁移到 `ai_workspace/loop-agent/` 与 `.agents/skills/` 的跨会话交接
-- [`2026-07-14-self-update-notifier-implementation.md`](2026-07-14-self-update-notifier-implementation.md) — loop-agent CLI 自更新提醒实现、TDD 验证和 bounded DAG fallback 交接
-- [`2026-07-14-docs-living-docs-calibration.md`](2026-07-14-docs-living-docs-calibration.md) — 活文档校准（Dynamic Workflow / 六个月 / ADR）
-- [`2026-07-14-docs-governance-hygiene.md`](2026-07-14-docs-governance-hygiene.md) — 文档治理与双树/索引收敛
-- [`2026-07-14-website-docs-ia-and-converge.md`](2026-07-14-website-docs-ia-and-converge.md) — Website 文档 IA 交接
-- [`2026-07-13-sdd-embedded-skills.md`](2026-07-13-sdd-embedded-skills.md) — 目标项目 repo-local SDD skills 的可选 DAG 节点嵌入、验证与基线风险交接
-- [`2026-07-13-dev-controller-001-implementation.md`](2026-07-13-dev-controller-001-implementation.md) — controller identity 实施
-- [`2026-07-13-dev-snapshot-001-implementation.md`](2026-07-13-dev-snapshot-001-implementation.md) — skill snapshot 实施
-- [`2026-07-13-dev-canary-001-implementation.md`](2026-07-13-dev-canary-001-implementation.md) — candidate canary 实施
-
-## 全量列表（新→旧）
-
-- [`2026-07-17-observe-dashboard-incremental-polling-handoff.md`](2026-07-17-observe-dashboard-incremental-polling-handoff.md)
-- [`2026-07-17-0.13.0-merge-handoff.md`](2026-07-17-0.13.0-merge-handoff.md)
-- [`2026-07-17-source-target-structure-alignment.md`](2026-07-17-source-target-structure-alignment.md)
-- [`2026-07-17-fe-test-dag-archive.md`](2026-07-17-fe-test-dag-archive.md)
-- [`2026-07-17-frontend-implementation-m4-m6.md`](2026-07-17-frontend-implementation-m4-m6.md)
-- [`2026-07-17-frontend-implementation-m3-repair.md`](2026-07-17-frontend-implementation-m3-repair.md)
-- [`2026-07-17-frontend-implementation-m2-writer-trace.md`](2026-07-17-frontend-implementation-m2-writer-trace.md)
-- [`2026-07-17-frontend-implementation-contract-v1.md`](2026-07-17-frontend-implementation-contract-v1.md)
-- [`2026-07-17-frontend-implementation-m0-baseline.md`](2026-07-17-frontend-implementation-m0-baseline.md)
-- [`2026-07-16-frontend-mock-node.md`](2026-07-16-frontend-mock-node.md)
-- [`2026-07-16-frontend-demand-auto-routing.md`](2026-07-16-frontend-demand-auto-routing.md)
-- [`2026-07-16-ready-planner.md`](2026-07-16-ready-planner.md)
-- [`2026-07-15-task-pool-v2-feature-scoped-task-identity.md`](2026-07-15-task-pool-v2-feature-scoped-task-identity.md)
-- [`2026-07-15-init-update-surface-coverage.md`](2026-07-15-init-update-surface-coverage.md)
-- [`2026-07-15-readonly-node-retry.md`](2026-07-15-readonly-node-retry.md)
-- [`2026-07-15-repair-artifact-gate-runtime-contract-implementation.md`](2026-07-15-repair-artifact-gate-runtime-contract-implementation.md)
-- [`2026-07-14-observe-ui-r5-boundary-final.md`](2026-07-14-observe-ui-r5-boundary-final.md)
-- [`2026-07-14-observe-ui-r5-remediation.md`](2026-07-14-observe-ui-r5-remediation.md)
-- [`2026-07-14-observe-ui-r5.md`](2026-07-14-observe-ui-r5.md)
-- [`2026-07-14-observe-ui-r4.md`](2026-07-14-observe-ui-r4.md)
-- [`2026-07-14-observe-ui-r3.md`](2026-07-14-observe-ui-r3.md)
-- [`2026-07-14-observe-ui-r2.md`](2026-07-14-observe-ui-r2.md)
-- [`2026-07-14-init-canonical-layout-handoff.md`](2026-07-14-init-canonical-layout-handoff.md)
-- [`2026-07-14-self-update-notifier-implementation.md`](2026-07-14-self-update-notifier-implementation.md)
-- [`2026-07-14-website-docs-ia-and-converge.md`](2026-07-14-website-docs-ia-and-converge.md)
-- [`2026-07-14-docs-living-docs-calibration.md`](2026-07-14-docs-living-docs-calibration.md)
-- [`2026-07-14-docs-governance-hygiene.md`](2026-07-14-docs-governance-hygiene.md)
-- [`2026-07-13-sdd-embedded-skills.md`](2026-07-13-sdd-embedded-skills.md)
-- [`2026-07-13-dev-snapshot-001-implementation.md`](2026-07-13-dev-snapshot-001-implementation.md)
-- [`2026-07-13-dev-controller-001-implementation.md`](2026-07-13-dev-controller-001-implementation.md)
-- [`2026-07-13-dev-canary-001-implementation.md`](2026-07-13-dev-canary-001-implementation.md)
-- [`2026-07-12-pi-only-agent-runtime.md`](2026-07-12-pi-only-agent-runtime.md)
-- [`2026-07-11-observe-dag-visualization.md`](2026-07-11-observe-dag-visualization.md)
-- [`2026-07-11-m2-feature-delivery-loop.md`](2026-07-11-m2-feature-delivery-loop.md)
-- [`2026-07-10-observe-ui-optimization.md`](2026-07-10-observe-ui-optimization.md)
-- [`2026-07-04-dynamic-workflow-dag-engine.md`](2026-07-04-dynamic-workflow-dag-engine.md)
-- [`2026-07-04-commander-cli-migration.md`](2026-07-04-commander-cli-migration.md)
-- [`2026-07-02-loop-agent-subject-restructure.md`](2026-07-02-loop-agent-subject-restructure.md)

package/docs/reports/README.md

@@ -1,163 +0,0 @@
-# 报告
-
-## 合并报告命名
-
-跨分支合并报告使用 `YYYY-MM-DD-origin-<source>-into-<target>-<source-short-sha>.md`。同一天重复合并时由 source short SHA 唯一标识；报告应记录双方功能、冲突文件与解析、自动合并高风险点、初始化/发布面影响、验证证据及剩余风险。新报告从 [`../templates/branch-merge-report.md`](../templates/branch-merge-report.md) 创建。
-
-- [`2026-07-18-origin-0.13.0-into-main-7c1a139.md`](2026-07-18-origin-0.13.0-into-main-7c1a139.md) — 将已发布并验证的 0.13.0 显式回合 main，合并后运行时代码树与发布分支一致
-- [`2026-07-18-origin-0.13.0-into-main-7c1a139-init-evolution-review.md`](2026-07-18-origin-0.13.0-into-main-7c1a139-init-evolution-review.md) — 0.13.0 回合 main 的 init/package/update surface 审查
-- [`2026-07-18-origin-main-into-0.13.0-43e86ad.md`](2026-07-18-origin-main-into-0.13.0-43e86ad.md) — 合入 frontend implementation M0–M6 与 browser-tools，同时保留 Observe、init/update 和既有受治理 DAG 能力
-- [`2026-07-18-origin-main-43e86ad-init-evolution-review.md`](2026-07-18-origin-main-43e86ad-init-evolution-review.md) — 本次合并的 package/full-init/update surface 审查
-- [`2026-07-17-origin-main-into-0.13.0-c139cf5.md`](2026-07-17-origin-main-into-0.13.0-c139cf5.md) — 合并 backend-test M0–M4、frontend-test/Playwright CLI 与 Pi SDK 更新，同时保留 0.13.0 初始化、Observe 和 Windows 稳定性修复
-- [`2026-07-17-origin-main-c139cf5-init-evolution-review.md`](2026-07-17-origin-main-c139cf5-init-evolution-review.md) — 本次高影响 merge 的 init/package/full-init/update 审查
-
-本目录存放验证、审计、benchmark、init evolution 与 closeout 报告。
-
-**索引职责**：本文件维护本目录**全量文件列表**。`ai_workspace/loop-agent/README.md` 只链到本 README，不再精选单篇 report。
-
-查找约定：
-
-- 按日期前缀浏览下方列表（新→旧）
-- init surface 审查：文件名含 `init-evolution-review`
-- 能力基线滚动分析：[`2026-07-02-repository-analysis.md`](2026-07-02-repository-analysis.md)（**已冻结**；2026-07-15 最终再采样关闭 0.11.0；非第二 CHANGELOG）
-
-## 近期要点（导读，非权威全集）
-
-- [`2026-07-17-origin-main-merge.md`](2026-07-17-origin-main-merge.md) — origin/main 合并、canonical 路径收敛与 partial_failed 闭环说明
-- [`2026-07-17-review-findings-remediation-init-evolution-review.md`](2026-07-17-review-findings-remediation-init-evolution-review.md) — 主干 review findings 初始化影响审查
-- [`2026-07-16-frontend-mock-node-init-evolution-review.md`](2026-07-16-frontend-mock-node-init-evolution-review.md) — 前端 Mock 节点初始化影响审查
-- [`2026-07-16-frontend-mock-data-workflow.md`](2026-07-16-frontend-mock-data-workflow.md) — 前端 Mock 数据工作流报告
-- [`2026-07-16-frontend-mock-data-workflow-init-evolution-review.md`](2026-07-16-frontend-mock-data-workflow-init-evolution-review.md) — 前端 Mock 数据工作流初始化影响审查
-- [`2026-07-16-frontend-demand-auto-routing-init-evolution-review.md`](2026-07-16-frontend-demand-auto-routing-init-evolution-review.md) — 前端需求自动路由初始化影响审查
-- [`2026-07-16-dag-source-binding-recovery-init-evolution-review.md`](2026-07-16-dag-source-binding-recovery-init-evolution-review.md) — DAG 任务源绑定初始化影响审查
-- [`2026-07-16-backend-test-run-owned-report-init-evolution-review.md`](2026-07-16-backend-test-run-owned-report-init-evolution-review.md) — backend-test run-owned 报告初始化影响审查
-- [`2026-07-17-source-target-structure-alignment-partial-failed.md`](2026-07-17-source-target-structure-alignment-partial-failed.md) — 首轮结构迁移在 writer 前被 write-set audit 正确阻断的原因与 r2 修订
-- [`2026-07-17-weekly-progress-summary-last-tue-to-today.md`](2026-07-17-weekly-progress-summary-last-tue-to-today.md) — 管理层阶段进展总结（07-07～07-17：0.6→0.12、Observe/Feature/Task Pool/Planner）
-- [`2026-07-17-backend-test-analysis-contract-init-evolution-review.md`](2026-07-17-backend-test-analysis-contract-init-evolution-review.md) — backend-test run-owned 结构化分析契约与 JSON Schema 初始化投影审查
-- [`current-capability-summary.md`](current-capability-summary.md) — **活**能力摘要（新进展写这里 / CHANGELOG / 新 report）
-- [`2026-07-16-0.13.0-init-evolution-review.md`](2026-07-16-0.13.0-init-evolution-review.md) — 0.12.0→0.13.0 init 更新连续性修复与 knowledge surface 审查（init update required）
-- [`2026-07-16-task-pool-priority-aware-ready-planner.md`](2026-07-16-task-pool-priority-aware-ready-planner.md) — Priority-aware Ready Planner 关闭报告
-- [`2026-07-15-task-pool-v2-feature-scoped-task-identity.md`](2026-07-15-task-pool-v2-feature-scoped-task-identity.md) — Task Pool v2 复合身份 M0–M4 最终报告
-- [`2026-07-15-task-pool-v2-init-evolution-review.md`](2026-07-15-task-pool-v2-init-evolution-review.md) — Task Pool v2 文档变更的 init surface 非影响审查
-- [`2026-07-15-init-update-surface-coverage-init-evolution-review.md`](2026-07-15-init-update-surface-coverage-init-evolution-review.md) — 初始化 surface 升级漏检修复的 init surface 审查（init update required）
-- [`2026-07-15-readonly-node-retry-init-evolution-review.md`](2026-07-15-readonly-node-retry-init-evolution-review.md) — 只读 Pi DAG 节点安全重试的 init surface 审查（surface check only，无需 init evolution）
-- [`2026-07-15-backend-test-dag-init-evolution-review.md`](2026-07-15-backend-test-dag-init-evolution-review.md) — 后端测试专用 DAG 的 package/init surface 审查
-- [`2026-07-15-init-canonical-layout-init-evolution-review.md`](2026-07-15-init-canonical-layout-init-evolution-review.md) — init canonical layout、旧布局安全迁移和废弃 harness 字段清理审查
-- [`2026-07-14-self-update-notifier-implementation.md`](2026-07-14-self-update-notifier-implementation.md) — loop-agent CLI 自更新提醒实现、DAG 边界、TDD 与 init surface 非影响证据
-- [`2026-07-14-docs-living-docs-calibration.md`](2026-07-14-docs-living-docs-calibration.md) — 活文档校准（Dynamic Workflow / 六个月 / analysis 冻结 / ADR）
-- [`2026-07-14-docs-governance-hygiene.md`](2026-07-14-docs-governance-hygiene.md) — 文档治理扫描与索引/双树收敛
-- [`2026-07-14-website-docs-ia-and-converge.md`](2026-07-14-website-docs-ia-and-converge.md) — Website IA 与 docs-converge 收口
-- [`2026-07-13-sdd-embedded-skills.md`](2026-07-13-sdd-embedded-skills.md) — repo-local SDD skill 嵌入增强的 DAG、TDD、独立审查、验证和基线风险证据
-- [`2026-07-13-versioned-self-hosting-bootstrap.md`](2026-07-13-versioned-self-hosting-bootstrap.md) — 版本化自举证据
-- [`2026-07-12-m2-completion-audit.md`](2026-07-12-m2-completion-audit.md) — 第二月完成审计
-- [`2026-07-02-repository-analysis.md`](2026-07-02-repository-analysis.md) — **已冻结**仓库能力基线快照（2026-07-15 最终再采样至 0.11.0；勿再当 CHANGELOG）
-
-## 全量列表（新→旧）
-
-- [`2026-07-18-origin-0.13.0-into-main-7c1a139.md`](2026-07-18-origin-0.13.0-into-main-7c1a139.md)
-- [`2026-07-18-origin-0.13.0-into-main-7c1a139-init-evolution-review.md`](2026-07-18-origin-0.13.0-into-main-7c1a139-init-evolution-review.md)
-- [`2026-07-18-origin-main-into-0.13.0-43e86ad.md`](2026-07-18-origin-main-into-0.13.0-43e86ad.md)
-- [`2026-07-18-origin-main-43e86ad-init-evolution-review.md`](2026-07-18-origin-main-43e86ad-init-evolution-review.md)
-- [`2026-07-17-pi-sdk-0-80-10-init-evolution-review.md`](2026-07-17-pi-sdk-0-80-10-init-evolution-review.md)
-- [`2026-07-17-origin-main-merge.md`](2026-07-17-origin-main-merge.md)
-- [`2026-07-17-init-evolution-review.md`](2026-07-17-init-evolution-review.md)
-- [`2026-07-17-frontend-implementation-m4-m6.md`](2026-07-17-frontend-implementation-m4-m6.md)
-- [`2026-07-17-frontend-implementation-m3-repair.md`](2026-07-17-frontend-implementation-m3-repair.md)
-- [`2026-07-17-frontend-implementation-m2-writer-trace.md`](2026-07-17-frontend-implementation-m2-writer-trace.md)
-- [`2026-07-17-frontend-implementation-m0-baseline.md`](2026-07-17-frontend-implementation-m0-baseline.md)
-- [`2026-07-17-frontend-implementation-contract-v1.md`](2026-07-17-frontend-implementation-contract-v1.md)
-- [`2026-07-17-backend-test-result-classification-m2.md`](2026-07-17-backend-test-result-classification-m2.md)
-- [`2026-07-17-backend-test-m4-converge-smoke.md`](2026-07-17-backend-test-m4-converge-smoke.md)
-- [`2026-07-17-backend-test-m0-template-runtime-drift.md`](2026-07-17-backend-test-m0-template-runtime-drift.md)
-- [`2026-07-17-backend-test-init-evolution-review.md`](2026-07-17-backend-test-init-evolution-review.md)
-- [`2026-07-17-backend-test-execution-contract-m1.md`](2026-07-17-backend-test-execution-contract-m1.md)
-- [`2026-07-17-backend-test-case-manifest-m3.md`](2026-07-17-backend-test-case-manifest-m3.md)
-- [`2026-07-17-source-target-structure-alignment-partial-failed.md`](2026-07-17-source-target-structure-alignment-partial-failed.md)
-- [`2026-07-16-0.13.0-init-evolution-review.md`](2026-07-16-0.13.0-init-evolution-review.md)
-- [`2026-07-17-weekly-progress-summary-last-tue-to-today.md`](2026-07-17-weekly-progress-summary-last-tue-to-today.md)
-- [`2026-07-17-backend-test-analysis-contract-artifact.md`](2026-07-17-backend-test-analysis-contract-artifact.md)
-- [`2026-07-17-backend-test-analysis-contract-init-evolution-review.md`](2026-07-17-backend-test-analysis-contract-init-evolution-review.md)
-- [`2026-07-17-review-findings-remediation-init-evolution-review.md`](2026-07-17-review-findings-remediation-init-evolution-review.md)
-- [`2026-07-16-dag-source-binding-recovery-init-evolution-review.md`](2026-07-16-dag-source-binding-recovery-init-evolution-review.md)
-- [`2026-07-16-repair-artifact-pass-normalization.md`](2026-07-16-repair-artifact-pass-normalization.md)
-- [`2026-07-16-observe-inspector-node-consistency.md`](2026-07-16-observe-inspector-node-consistency.md)
-- [`2026-07-16-init-natural-language-routing-init-evolution-review.md`](2026-07-16-init-natural-language-routing-init-evolution-review.md)
-- [`2026-07-16-decision-envelope-prompt-contract.md`](2026-07-16-decision-envelope-prompt-contract.md)
-- [`2026-07-16-decision-envelope-fence-tolerance.md`](2026-07-16-decision-envelope-fence-tolerance.md)
-- [`2026-07-16-frontend-mock-node-init-evolution-review.md`](2026-07-16-frontend-mock-node-init-evolution-review.md)
-- [`2026-07-16-frontend-demand-auto-routing-init-evolution-review.md`](2026-07-16-frontend-demand-auto-routing-init-evolution-review.md)
-- [`2026-07-16-frontend-mock-data-workflow.md`](2026-07-16-frontend-mock-data-workflow.md)
-- [`2026-07-16-frontend-mock-data-workflow-init-evolution-review.md`](2026-07-16-frontend-mock-data-workflow-init-evolution-review.md)
-- [`2026-07-16-task-pool-priority-aware-ready-planner.md`](2026-07-16-task-pool-priority-aware-ready-planner.md)
-- [`2026-07-15-task-pool-v2-feature-scoped-task-identity.md`](2026-07-15-task-pool-v2-feature-scoped-task-identity.md)
-- [`2026-07-15-task-pool-v2-init-evolution-review.md`](2026-07-15-task-pool-v2-init-evolution-review.md)
-- [`2026-07-15-init-update-surface-coverage-init-evolution-review.md`](2026-07-15-init-update-surface-coverage-init-evolution-review.md)
-- [`2026-07-15-readonly-node-retry-init-evolution-review.md`](2026-07-15-readonly-node-retry-init-evolution-review.md)
-- [`2026-07-15-backend-test-dag-init-evolution-review.md`](2026-07-15-backend-test-dag-init-evolution-review.md)
-- [`2026-07-15-init-canonical-layout-init-evolution-review.md`](2026-07-15-init-canonical-layout-init-evolution-review.md)
-- [`dogfood-preflight-static-20260709090443.md`](dogfood-preflight-static-20260709090443.md)
-- [`current-capability-summary.md`](current-capability-summary.md)
-- [`2026-07-14-website-docs-ia-init-evolution-review.md`](2026-07-14-website-docs-ia-init-evolution-review.md)
-- [`2026-07-14-observe-ui-r5.md`](2026-07-14-observe-ui-r5.md)
-- [`2026-07-14-observe-ui-r4.md`](2026-07-14-observe-ui-r4.md)
-- [`2026-07-14-observe-ui-r3.md`](2026-07-14-observe-ui-r3.md)
-- [`2026-07-14-observe-ui-r2.md`](2026-07-14-observe-ui-r2.md)
-- [`2026-07-14-observe-ui-r1.md`](2026-07-14-observe-ui-r1.md)
-- [`2026-07-14-architecture-docs-init-evolution-review.md`](2026-07-14-architecture-docs-init-evolution-review.md)
-- [`2026-07-14-website-docs-ia-and-converge.md`](2026-07-14-website-docs-ia-and-converge.md)
-- [`2026-07-14-self-update-notifier-implementation.md`](2026-07-14-self-update-notifier-implementation.md)
-- [`2026-07-14-docs-living-docs-calibration.md`](2026-07-14-docs-living-docs-calibration.md)
-- [`2026-07-14-docs-governance-hygiene.md`](2026-07-14-docs-governance-hygiene.md)
-- [`2026-07-13-versioned-self-hosting-init-evolution-review.md`](2026-07-13-versioned-self-hosting-init-evolution-review.md)
-- [`2026-07-13-versioned-self-hosting-bootstrap.md`](2026-07-13-versioned-self-hosting-bootstrap.md)
-- [`2026-07-13-test-environment-stability.md`](2026-07-13-test-environment-stability.md)
-- [`2026-07-13-sdd-embedded-skills-init-evolution-review.md`](2026-07-13-sdd-embedded-skills-init-evolution-review.md)
-- [`2026-07-13-sdd-embedded-skills.md`](2026-07-13-sdd-embedded-skills.md)
-- [`2026-07-13-frontend-verification-command-safety-init-evolution-review.md`](2026-07-13-frontend-verification-command-safety-init-evolution-review.md)
-- [`2026-07-13-frontend-skill-contracts-init-evolution-review.md`](2026-07-13-frontend-skill-contracts-init-evolution-review.md)
-- [`2026-07-13-exec-plan-lifecycle-init-evolution-review.md`](2026-07-13-exec-plan-lifecycle-init-evolution-review.md)
-- [`2026-07-13-exec-plan-lifecycle.md`](2026-07-13-exec-plan-lifecycle.md)
-- [`2026-07-12-production-readiness-hardening.md`](2026-07-12-production-readiness-hardening.md)
-- [`2026-07-12-pi-only-agent-runtime-init-evolution-review.md`](2026-07-12-pi-only-agent-runtime-init-evolution-review.md)
-- [`2026-07-12-observe-warm-console-redesign.md`](2026-07-12-observe-warm-console-redesign.md)
-- [`2026-07-12-observe-dag-node-model.md`](2026-07-12-observe-dag-node-model.md)
-- [`2026-07-12-observe-dag-node-model-init-evolution-review.md`](2026-07-12-observe-dag-node-model-init-evolution-review.md)
-- [`2026-07-12-m2-completion-audit.md`](2026-07-12-m2-completion-audit.md)
-- [`2026-07-12-m2-08-init-evolution-review.md`](2026-07-12-m2-08-init-evolution-review.md)
-- [`2026-07-12-m2-08-dogfood-release-evidence.md`](2026-07-12-m2-08-dogfood-release-evidence.md)
-- [`2026-07-12-m2-07-init-evolution-review.md`](2026-07-12-m2-07-init-evolution-review.md)
-- [`2026-07-12-m2-06-init-evolution-review.md`](2026-07-12-m2-06-init-evolution-review.md)
-- [`2026-07-12-m2-05-init-evolution-review.md`](2026-07-12-m2-05-init-evolution-review.md)
-- [`2026-07-12-m2-04-init-evolution-review.md`](2026-07-12-m2-04-init-evolution-review.md)
-- [`2026-07-12-m2-03-init-evolution-review.md`](2026-07-12-m2-03-init-evolution-review.md)
-- [`2026-07-12-m2-02-init-evolution-review.md`](2026-07-12-m2-02-init-evolution-review.md)
-- [`2026-07-12-init-evolution-strict-report-range.md`](2026-07-12-init-evolution-strict-report-range.md)
-- [`2026-07-12-dag-state-reconciliation.md`](2026-07-12-dag-state-reconciliation.md)
-- [`2026-07-12-dag-state-reconciliation-init-evolution-review.md`](2026-07-12-dag-state-reconciliation-init-evolution-review.md)
-- [`2026-07-12-dag-output-language.md`](2026-07-12-dag-output-language.md)
-- [`2026-07-12-dag-output-language-init-evolution-review.md`](2026-07-12-dag-output-language-init-evolution-review.md)
-- [`2026-07-12-dag-liveness-recovery.md`](2026-07-12-dag-liveness-recovery.md)
-- [`2026-07-12-dag-liveness-init-evolution-review.md`](2026-07-12-dag-liveness-init-evolution-review.md)
-- [`2026-07-12-0.10.0-init-evolution-review.md`](2026-07-12-0.10.0-init-evolution-review.md)
-- [`2026-07-11-task-pool-hard-cutover-init-evolution-review.md`](2026-07-11-task-pool-hard-cutover-init-evolution-review.md)
-- [`2026-07-11-round3-worker-expansion.md`](2026-07-11-round3-worker-expansion.md)
-- [`2026-07-11-round2-interactive-ui-experiment.md`](2026-07-11-round2-interactive-ui-experiment.md)
-- [`2026-07-11-round2-init-evolution-review.md`](2026-07-11-round2-init-evolution-review.md)
-- [`2026-07-11-observe-terminal-dag-kpi.md`](2026-07-11-observe-terminal-dag-kpi.md)
-- [`2026-07-11-observe-dag-visualization.md`](2026-07-11-observe-dag-visualization.md)
-- [`2026-07-11-m2-01-init-evolution-review.md`](2026-07-11-m2-01-init-evolution-review.md)
-- [`2026-07-11-init-evolution-review.md`](2026-07-11-init-evolution-review.md)
-- [`2026-07-11-commit-1d0f3b7-review.md`](2026-07-11-commit-1d0f3b7-review.md)
-- [`2026-07-11-command-performance-followups.md`](2026-07-11-command-performance-followups.md)
-- [`2026-07-11-command-performance-audit.md`](2026-07-11-command-performance-audit.md)
-- [`2026-07-11-0.7.5-init-evolution-review.md`](2026-07-11-0.7.5-init-evolution-review.md)
-- [`2026-07-10-session-events-dogfood.md`](2026-07-10-session-events-dogfood.md)
-- [`2026-07-10-nightly-drill-round-1.md`](2026-07-10-nightly-drill-round-1.md)
-- [`2026-07-10-nightly-drill-round-1-evidence.md`](2026-07-10-nightly-drill-round-1-evidence.md)
-- [`2026-07-10-next-stage-dogfood-runs.md`](2026-07-10-next-stage-dogfood-runs.md)
-- [`2026-07-10-init-evolution-review.md`](2026-07-10-init-evolution-review.md)
-- [`2026-07-09-be-001-pi-real-run.md`](2026-07-09-be-001-pi-real-run.md)
-- [`2026-07-05-website-docs-governance-multi-executor-dogfood.md`](2026-07-05-website-docs-governance-multi-executor-dogfood.md)
-- [`2026-07-04-website-docs-dynamic-workflow-dogfood.md`](2026-07-04-website-docs-dynamic-workflow-dogfood.md)
-- [`2026-07-02-repository-analysis.md`](2026-07-02-repository-analysis.md)
-- [`2026-06-06-pi-sdk-runtime-reuse-benchmark.md`](2026-06-06-pi-sdk-runtime-reuse-benchmark.md)

package/docs/verification-matrix.md

@@ -1,70 +0,0 @@
-# 验证矩阵
-
-用能证明声明的最窄命令。
-
-| 变更类型 | 最低验证 | 更强验证 |
-|---|---|---|
-| 仅文档或治理 | `bash scripts/check-repo.sh` | `bash scripts/ci.sh` |
-| TypeScript runtime | `npm run typecheck` | `npm test` |
-| CLI 行为 | `npm run typecheck` + 定向 Vitest | `npm test` + CLI smoke |
-| Feature reducer/review | `npx vitest run test/worker/feature test/worker/agent-worker-cli.test.ts` | `npm test` + `node bin/agent-worker.js feature review --help` |
-| Feature run orchestration | `npx vitest run test/worker/feature test/worker/runner/run-ready.test.ts test/worker/agent-worker-cli.test.ts` | `npm test` + `node bin/agent-worker.js feature run --help` |
-| Follow-up 分类与事务 | `npx vitest run test/worker/follow-up test/worker/feature test/worker/pool test/worker/report test/worker/agent-worker-cli.test.ts` | `npm test` + `node bin/agent-worker.js task draft-followup --help` + `node bin/agent-worker.js feature approve-followup --help` |
-| Feature Git transaction | `npx vitest run test/worker/delivery test/worker/feature test/worker/runner test/worker/agent-worker-cli.test.ts` | `npm test` + `node bin/agent-worker.js feature run --help` + temporary Git repo smoke |
-| Final verification / Delivery / Closeout | `npx vitest run test/worker/delivery test/worker/feature test/worker/agent-worker-cli.test.ts` | `npm test` + verify-final/Delivery/Closeout CLI help + temporary Git repo evidence/hash/tamper/apply rollback smoke。Closeout 覆盖在 `test/worker/delivery/**` 与 CLI，不存在独立 `test/worker/closeout/` 目录 |
-| Task Pool feature-scoped identity / migration | `npx vitest run test/worker/pool test/worker/runner/run-ready.test.ts test/worker/feature test/worker/follow-up test/worker/delivery test/worker/report test/worker/observability test/worker/observe test/worker/agent-worker-cli.test.ts` + `npm run typecheck` | 平台临时目录 dual-Feature smoke（同名 `QA-EXEC-001` 不串线）+ `pool doctor` / `pool migrate-state` dry-run + Observe canonical/legacy 409 |
-| Controller identity / pinning | `npx vitest run test/worker/package-metadata.test.ts test/worker/repo-preflight.test.ts test/worker/loop-agent-client.test.ts test/worker/run-task/run-task.test.ts test/worker/runner/run-ready.test.ts test/worker/feature/run.test.ts test/worker/delivery/final-verification.test.ts test/worker/delivery/package.test.ts test/worker/agent-worker-cli.test.ts` + `npm run typecheck` | `npm test` + build + 两个 CLI `--version` + 写入型命令 help |
-| DAG resolved skill snapshot / resume | `npx vitest run test/dag-skill-snapshot.test.ts test/dag-approve-resume.test.ts` + `npm run typecheck` | `npm test` + snapshot tamper/pause-resume/dynamic profile smoke |
-| Versioned self-hosting candidate canary | `npx vitest run test/self-host-canary.test.ts test/package-surface.test.ts` + `npm run build` | `npm run self-host:canary -- --deterministic --output <evidence.json>` + `npm pack --dry-run` |
-| Public skill / init mirror surface | `bash scripts/check-skill-entry.sh` + `npx vitest run test/init-command.test.ts test/package-surface.test.ts` | 临时目标项目 full init + skill/mirror hash 对照 + `bash scripts/check-repo.sh` |
-| DAG 工作流 | 定向 DAG 测试 | `npm test` |
-| Eval Replay MVP | `npx vitest run test/eval-replay.test.ts test/eval-cli.test.ts test/cli-contract.test.ts` + `npm run typecheck` | `bash scripts/check-command-registry-drift.sh` + `bash scripts/check-architecture-boundaries.sh` + `node bin/loop-agent.js eval --help` + `bash scripts/check-repo.sh` |
-| Eval Candidate Registry MVP | `npx vitest run test/eval-candidate-registry.test.ts test/eval-cli.test.ts test/cli-contract.test.ts` + `npm run typecheck` | `npm run build` + `bash scripts/check-command-registry-drift.sh` + `bash scripts/check-architecture-boundaries.sh` + `node bin/loop-agent.js eval --help` + `HARNESS_ALLOW_ACTIVE_DAG_RUNS=1 bash scripts/check-repo.sh` |
-| Eval run association W2.3 | `npx vitest run test/eval-run-association.test.ts test/eval-replay.test.ts test/dag-report.test.ts test/run-dag.test.ts` + `npm run typecheck` | `npm run build` + `bash scripts/check-architecture-boundaries.sh` + `bash scripts/check-command-registry-drift.sh` + `HARNESS_ALLOW_ACTIVE_DAG_RUNS=1 bash scripts/check-repo.sh` + `npm run docs:build` + `git diff --check` |
-| 前端 DAG 模板 / 前端节点生成 | `npm run typecheck` + 定向 DAG 测试 | `npm test` + `bash scripts/check-repo.sh` |
-| Production readiness hardening | `bash scripts/check-repo.sh` + 定向 DAG/CLI 测试 | `bash scripts/ci.sh` + docs build + package smoke |
-| 脚本或 CI | 运行变更的脚本 | `bash scripts/ci.sh` |
-| Package / publish 入口 | `npm run build` + `node bin/loop-agent.js --help` | `npm pack --dry-run` |
-| 完整交付 | `bash scripts/ci.sh` | CLI smoke + 相关手工检查 |
-
-常用命令：
-
-```bash
-npm run typecheck
-npm test
-npm run build
-bash scripts/check-repo.sh
-bash scripts/ci.sh
-node bin/loop-agent.js --help
-node bin/loop-agent.js --version
-node bin/agent-worker.js --version
-npm run dev -- --help
-npm pack --dry-run
-npm run self-host:canary -- --deterministic --output <evidence.json>
-```
-
-deterministic self-host canary 必须只执行 static/shell DAG，并在 evidence 中证明 `piExecutorObserved=false`、`modelExecutorObserved=false`、`featureExecutedTasks=[]`、PATH controller trap 未触发且候选入口位于隔离 slot。它不证明 candidate Pi/model/provider 路径，也不替代 `test/dag-skill-snapshot.test.ts` 对候选 skill resolution、snapshot hash 和 resume 的验证。
-
-测试资源策略：`npm test` 会先运行可并行的纯测试，再串行运行会启动 CLI、`tsx` 或 Git 子进程的集成测试。纯测试根据 `os.availableParallelism()` 自适应使用 1 至 4 个 Worker；可用 `LOOP_AGENT_FAST_TEST_WORKERS` 在 CI 或受限机器上显式覆盖。传入测试文件时，例如 `npm test -- test/worker/observe/server.test.ts`，仍按常规 Vitest 方式只运行该范围，不会启动两阶段完整测试。
-
-产品线 Feature/Task/QA 文档或 TaskSpec 约束变更还应运行：
-
-```bash
-bash scripts/check-product-line-docs.sh
-```
-
-该检查对仓库中的 feature packet 执行 `agent-worker task validate-feature`，覆盖 AC 唯一性、依赖/环、TaskSpec 路径与验证命令、QA verdict 与 success closeout 顺序。
-
-Windows 上通过 Git Bash 或已配置的兼容 Bash 运行 `scripts/*.sh`。跨平台 CLI 代码对真实文件操作用原生路径；`/` 仅用于稳定 repo 引用、JSON/Markdown 证据引用和 glob 约定。
-
-没有相关门禁的新鲜命令输出，不得声明完成。
-
-Production Readiness v0.1 工作以 `ai_workspace/loop-agent/production-readiness.md` 与 `ai_workspace/loop-agent/templates/production-readiness-checklist.md` 为验收契约。最终 hardening closeout 需要：
-
-```bash
-bash scripts/ci.sh
-npm run docs:build
-npm run build
-node bin/loop-agent.js --help
-npm pack --dry-run
-```

package/scripts/check-product-line-docs.sh

@@ -1,29 +0,0 @@
-#!/usr/bin/env bash
-set -euo pipefail
-
-ROOT_DIR="$(cd "$(dirname "${BASH_SOURCE[0]}")/.." && pwd)"
-cd "${ROOT_DIR}"
-
-feature_dirs=()
-for root in features product/features dogfood/features; do
-  [[ -d "${root}" ]] || continue
-  while IFS= read -r feature_dir; do
-    if [[ ! -f "${feature_dir}/acceptance.yaml" ]]; then
-      echo "product-line docs check failed: incomplete feature packet missing acceptance.yaml: ${feature_dir}" >&2
-      exit 1
-    fi
-    feature_dirs+=("${feature_dir}")
-  done < <(find "${root}" -mindepth 1 -maxdepth 1 -type d | sort)
-done
-
-if [[ ${#feature_dirs[@]} -eq 0 ]]; then
-  echo "product-line docs check skipped: no feature packets found"
-  exit 0
-fi
-
-for feature_dir in "${feature_dirs[@]}"; do
-  echo "==> validate product-line feature: ${feature_dir}"
-  node --import tsx/esm src/worker/cli.ts task validate-feature "${feature_dir}"
-done
-
-echo "product-line docs checks passed: ${#feature_dirs[@]} feature packet(s)"

package/scripts/check-task-pool-root.sh

@@ -1,32 +0,0 @@
-#!/usr/bin/env bash
-set -euo pipefail
-
-ROOT_DIR="$(cd "$(dirname "${BASH_SOURCE[0]}")/.." && pwd)"
-cd "${ROOT_DIR}"
-
-scan_paths=(
-  src
-  test
-  scripts
-  .github
-  README.md
-  AGENTS.md
-  harness.json
-  docs/architecture
-  docs/README.md
-  docs/loop-agent-harness.md
-  docs/init-surface.manifest.json
-  skills
-  website/docs
-)
-
-matches="$(rg -n --path-separator / '[.]task-pool' "${scan_paths[@]}" 2>/dev/null || true)"
-matches="$(printf '%s\n' "${matches}" | rg -v '^(README\.md|AGENTS\.md):.*gitignore|^src/commands/init\.ts:.*("[.]task-pool/"|legacy [.]task-pool residue)|^test/init-command\.test\.ts:.*toContain\("[.]task-pool/"\)|^website/docs/reference/cli\.md:.*旧顶层.*[.]task-pool' || true)"
-
-if [[ -n "${matches}" ]]; then
-  echo "Task Pool root 检查失败：活跃源码、测试、脚本或用户文档仍引用已废弃的顶层 runtime path：" >&2
-  printf '%s\n' "${matches}" >&2
-  exit 1
-fi
-
-echo "Task Pool root 检查通过：活跃 surface 只使用 .harness/task-pool"

package/scripts/kb-graph-incremental-prepare.sh

@@ -1,5 +0,0 @@
-#!/usr/bin/env bash
-# Incremental knowledge-graph update prepare (narrowed scope for bootstrap DAG).
-set -euo pipefail
-ROOT_DIR="$(cd "$(dirname "${BASH_SOURCE[0]}")/.." && pwd)"
-exec node "${ROOT_DIR}/scripts/kb-graph-incremental-prepare.mjs" "$@"

package/scripts/kb-graph-materialize.sh

@@ -1,4 +0,0 @@
-#!/usr/bin/env bash
-set -euo pipefail
-ROOT_DIR="$(cd "$(dirname "${BASH_SOURCE[0]}")/.." && pwd)"
-exec node "${ROOT_DIR}/scripts/kb-graph-materialize.mjs" "$@"

package/scripts/kb-graph-promote.sh

@@ -1,4 +0,0 @@
-#!/usr/bin/env bash
-set -euo pipefail
-ROOT_DIR="$(cd "$(dirname "${BASH_SOURCE[0]}")/.." && pwd)"
-exec node "${ROOT_DIR}/scripts/kb-graph-promote.mjs" "$@"

package/scripts/kb-query.sh

@@ -1,5 +0,0 @@
-#!/usr/bin/env bash
-# Phase A knowledge query wrapper (by_id / by_feature / search).
-set -euo pipefail
-ROOT_DIR="$(cd "$(dirname "${BASH_SOURCE[0]}")/.." && pwd)"
-exec node "${ROOT_DIR}/scripts/kb-query.mjs" "$@"