@kenhkl/agent-moss 0.16.9 → 0.16.13

package/README.md

@@ -105,6 +105,9 @@ const result = await resp.json();
 | `AGENT_MOSS_DISABLE_HEURISTIC` | 设为 `1` 禁用层1 特征匹配 | 未设置 |
 | `AGENT_MOSS_DISABLE_LOGIC_RULES` | 设为 `1` 禁用层2 逻辑规则 | 未设置 |
 | `AGENT_MOSS_CUSTOM_RULES` | 自定义规则 JSON 数组 | `[]` |
+| `AGENT_MOSS_RULES_MODE` | 规则来源模式：`hot`（默认）/ `cold`（冷启动：启动时读规则目录并冻结，runtime/Console 不参与）/ `builtin`（仅内置）。非法值按 builtin fail-safe | 未设置（hot）|
+| `AGENT_MOSS_RULES_BUILTIN_ONLY` | 设为 `1` = builtin（仅内置）| 未设置 |
+| `AGENT_MOSS_DISABLE_RULE_HOT_RELOAD` | 设为 `1` = cold（禁用 runtime/Console 热加载，但启动时仍读规则目录）| 未设置 |
 
 ### 自定义规则
 

package/dist/cli.d.ts

@@ -1,11 +1,29 @@
 #!/usr/bin/env node
+import { AnalysisInput } from './engine/coordinator.js';
+
 /**
  * AgentMoss CLI — TypeScript version.
  * Supports: init | analyze | server
  */
+
 /** 命令模式核心：把一条 shell 命令当 a_next 分析，输出 Deny/Allow（--json 时完整
  *  JSON），返回退出码（Allow=0 / Deny=1）。导出供测试直接调用（CLI 分支再 process.exit）。
  *  零文件读写——镜像 Python cli.py 的 _analyze_command。 */
+/**
+ * 把 CLI 输入文件（input.json）映射成引擎入参。
+ *
+ * 抽成导出函数是为了**可测**：CLI 文件模式的入口字段映射曾经丢字段且无看护
+ * （`output` 与 `scenario_id` 都没传），而 CLI 的 main() 里没法单测。Python 侧
+ * 对应用 `cli.py::cmd_analyze` 的透传（那边直传原始 dict，天然不丢字段）。
+ *
+ * 字段口径与 Python CLI（cli.py）逐项对齐：
+ * - `output`：工具返回 / 用户对 ask_user_question 的回答 —— L2 授权（consent）
+ *   判定看它，丢了会把「已授权」判成「未授权」；
+ * - `scenario_id`：场景定制规则（如 bank 沙箱目录白名单）的加载依据，丢了
+ *   这些规则整套不生效；
+ * - `agent_id` / `cwd`：agent 专属规则与间接文件访问检测依据。
+ */
+declare function buildAnalysisInputFromFile(data: any): AnalysisInput;
 declare function analyzeRawCommand(command: string, useJson?: boolean): Promise<number>;
 
-export { analyzeRawCommand };
+export { analyzeRawCommand, buildAnalysisInputFromFile };