nonoka-cli 0.2.3__tar.gz → 0.2.5__tar.gz

nonoka_cli-0.2.5/.agents/skills/nonoka-tui-testing/SKILL.md

@@ -0,0 +1,413 @@
+---
+name: nonoka-tui-testing
+description: |
+  nonoka-cli 的端到端 TUI 与功能测试流程。用于在隔离沙箱中搭建最新
+  nonoka-cli + nonoka-agent + nonoka-opencode-provider，通过 OpenCode
+  实际运行对话与开发任务，截图检查 TUI 渲染，并按分层策略定位根因。
+  Use when:
+  (1) 验证 nonoka-cli 基础对话是否卡住；
+  (2) 验证复杂任务（Next.js 应用等）的工具调用链与 HITL；
+  (3) 检查 OpenCode TUI 文字分段、工具卡片、HITL 弹窗等渲染细节；
+  (4) 排查 nonoka-cli / adapter / nonoka 框架边界问题。
+license: MIT
+metadata:
+  author: Kimi Code CLI
+  version: "1.1.0"
+---
+
+# nonoka-cli TUI 与功能测试 Skill
+
+## 1. 快速开始
+
+运行项目内的 setup 脚本，一键准备 `/tmp/nonoka-test` 沙箱：
+
+```bash
+cd /home/fyerfyer/fyerfyer/Projects/nonoka-cli
+bash .agents/skills/nonoka-tui-testing/scripts/setup-sandbox.sh
+```
+
+如果项目根目录存在 `.env`（例如 `OPENAI_API_KEY=...`），脚本会自动 source 并生成
+`nonoka.yaml` / `opencode.json`。完成后启动 OpenCode：
+
+```bash
+cd /tmp/nonoka-test
+./run-opencode.sh           # 前台运行
+# 或
+./run-opencode-tmux.sh      # 后台 tmux，然后 tmux attach -t nonoka-test
+```
+
+## 2. 测试目标
+
+- 基础对话不卡住（`hello`、`what is 2+2?`）。
+- 复杂开发任务能完成工具调用链（生成 Next.js 应用）。
+- HITL 审批正常弹出、批准/拒绝后流程正确。
+- TUI 渲染细节：文字分段、工具卡片、卡片后文字续接、HITL 弹窗布局。
+- Session 管理：新建、切换、重命名、删除、持久化。
+- 工具实际执行效果：文件读写、命令执行。
+
+## 3. 测试分层
+
+| 层级 | 名称         | 验证方式                                  | 问题归属                              |
+| ---- | ------------ | ----------------------------------------- | ------------------------------------- |
+| L1   | 协议层       | 直接对 `nonoka-cli --server` 喂 NDJSON    | nonoka-cli bridge / nonoka 框架       |
+| L2   | Provider 层  | 检查 `/tmp/nonoka-provider.log`、timeline | nonoka-opencode-provider              |
+| L3   | TUI E2E      | Playwright/tmux 截屏 + UI 检查清单        | OpenCode / Ink / provider stream 转换 |
+| L4   | Session 管理 | `nonoka-cli` 子命令 + SQLite 检查         | nonoka-cli sessions                   |
+| L5   | 产物评估     | 验证生成项目能否 build                    | nonoka 框架 / tool 实现               |
+
+## 4. 环境搭建（手动版）
+
+setup 脚本已经把这些步骤自动化；下面是等价的手动流程，便于排错。
+
+### 4.1 沙箱目录
+
+```bash
+export NONOKA_TEST_ROOT=/tmp/nonoka-test
+rm -rf "$NONOKA_TEST_ROOT"
+mkdir -p "$NONOKA_TEST_ROOT"
+cd "$NONOKA_TEST_ROOT"
+```
+
+### 4.2 复制/链接源码
+
+```bash
+cd "$NONOKA_TEST_ROOT"
+cp -r /home/fyerfyer/fyerfyer/Projects/nonoka-cli ./nonoka-cli
+ln -s /home/fyerfyer/fyerfyer/Projects/nonoka-agent ./nonoka-agent
+```
+
+### 4.3 创建 Python 虚拟环境并 editable 安装
+
+```bash
+cd "$NONOKA_TEST_ROOT/nonoka-cli"
+uv venv .venv
+source .venv/bin/activate
+uv pip install -e ./../nonoka-agent -e .
+```
+
+> 测试阶段使用 editable 安装 `nonoka-agent`，修复完成后再 `uv run twine publish` 发布新版到 PyPI。
+
+### 4.4 启动本地 verdaccio 并发布 provider
+
+```bash
+cd "$NONOKA_TEST_ROOT"
+cat > verdaccio.yaml <<'EOF'
+storage: ./verdaccio-storage
+packages:
+  'nonoka-opencode-provider':
+    access: $all
+    publish: $all
+  '**':
+    access: $all
+    publish: $all
+    proxy: npmjs
+EOF
+
+nohup npx --yes verdaccio --config verdaccio.yaml > verdaccio.log 2>&1 &
+for i in {1..30}; do
+  if curl -fsSL http://localhost:4873/ >/dev/null 2>&1; then break; fi
+  sleep 1
+done
+
+cd "$NONOKA_TEST_ROOT/nonoka-cli/packages/nonoka-opencode-provider"
+# 只让当前目录使用本地 registry，不污染全局 npm 配置
+cat > .npmrc <<EOF
+registry=http://localhost:4873
+EOF
+npm install
+npm run build
+npm publish --access public
+```
+
+### 4.5 清理 OpenCode provider 缓存
+
+OpenCode 会把 provider 缓存到 `~/.cache/opencode/packages/nonoka-opencode-provider`，
+如果里面是从 npmjs 下载的旧版本，就会覆盖 verdaccio 的新版本。每次重新 setup 时都要清理：
+
+```bash
+rm -rf "$HOME/.cache/opencode/packages/nonoka-opencode-provider"
+```
+
+### 4.6 准备 OpenCode
+
+确保 `opencode` 已在 PATH 中：
+
+```bash
+which opencode
+```
+
+### 4.7 生成配置
+
+```bash
+cd "$NONOKA_TEST_ROOT"
+export DEEPSEEK_API_KEY="your-key"
+nonoka-cli config init --yes --model deepseek-chat --config "$NONOKA_TEST_ROOT/nonoka.yaml"
+nonoka-cli opencode init --config "$NONOKA_TEST_ROOT/nonoka.yaml"
+```
+
+`opencode init` 写入的 `serverCommand` 会通过 PATH 找到沙箱内的 `nonoka-cli`，并把 stderr
+重定向到 `/tmp/nonoka-server.log`。
+
+## 5. 日志策略
+
+所有日志都写文件，不再混进 OpenCode TUI：
+
+| 日志文件 | 来源 | 用途 |
+| -------- | ---- | ---- |
+| `/tmp/nonoka-server-{cwdhash}.log` | `nonoka-cli --server` 的 stderr | 框架/LLM 调试、消息顺序 |
+| `/tmp/nonoka-provider.log` | `nonoka-opencode-provider` | adapter 输入/输出摘要 |
+| `/tmp/nonoka-trace/trace-YYYYMMDD.jsonl` | `nonoka-cli` bridge | 结构化请求/事件追踪 |
+| `/tmp/nonoka-tui-timeline.ndjson` | provider + bridge | 渲染时间线对齐 |
+
+启动 OpenCode 前设置：
+
+```bash
+export NONOKA_LOG_LEVEL=DEBUG
+```
+
+## 6. TUI 渲染时间线日志
+
+TUI 问题不能仅靠 stdout/stderr 日志定位，需要**事件时间线 + 截图**对齐。
+
+provider 和 bridge 共同写 `/tmp/nonoka-tui-timeline.ndjson`，每行一个事件：
+
+```json
+{"ts":"2026-07-04T09:00:01.123Z","source":"bridge","type":"text_delta","len":42,"has_newline":true,"preview":"Hello! How can I..."}
+{"ts":"2026-07-04T09:00:01.145Z","source":"provider","type":"text-delta","len":42,"preview":"Hello! How can I..."}
+{"ts":"2026-07-04T09:00:01.200Z","source":"provider","type":"tool-call","toolName":"write_file"}
+```
+
+字段说明：
+
+- `ts`: ISO 8601 时间戳，精确到毫秒。
+- `source`: `bridge`（nonoka-cli 发出）、`provider`（adapter 转换后）、`test`（测试脚本标记）。
+- `type`: 事件类型。
+- `len`/`has_newline`/`preview`: text 类事件的关键字段，用于判断文字堆叠是否因为后端没发换行。
+
+截屏脚本在每次截图前写入一行 `test` 事件：
+
+```json
+{
+  "ts": "2026-07-04T09:00:02.500Z",
+  "source": "test",
+  "type": "screenshot",
+  "file": "01_hello.png"
+}
+```
+
+事后可用 `scripts/analyze-timeline.py` 把截图与前后 500ms 的事件对齐：
+
+```bash
+python .agents/skills/nonoka-tui-testing/scripts/analyze-timeline.py --root /tmp/nonoka-test
+```
+
+快速判断：
+
+- 如果 bridge 发了 `\n` 但 UI 没分段 → OpenCode / Ink 渲染问题。
+- 如果 bridge 没发 `\n` → nonoka-cli / nonoka 框架问题。
+- 如果 provider 没把 `text_delta` 传给 OpenCode → adapter 问题。
+
+## 7. 文本拼接快照
+
+在 bridge 端维护一个当前 turn 的文本缓冲区，每次 `text_delta` 后把完整文本写入 `/tmp/nonoka-rendered-text.txt`。截图后对比：
+
+- 文件里的文本应该是 UI 上应该显示的内容。
+- 如果文件有分段但 UI 没有 → 渲染问题。
+- 如果文件本身就没分段 → 后端问题。
+
+## 8. 辅助脚本
+
+| 脚本 | 用途 |
+| ---- | ---- |
+| `scripts/setup-sandbox.sh` | 搭建 `/tmp/nonoka-test` |
+| `scripts/capture-screenshots.py` | 驱动 tmux 输入并触发截图 |
+| `scripts/analyze-timeline.py` | 对齐截图与 timeline |
+
+setup 完成后，沙箱内还会生成：
+
+- `start-verdaccio.sh`：重新启动 verdaccio。
+- `run-opencode.sh`：前台启动 OpenCode。
+- `run-opencode-tmux.sh`：后台 tmux 启动 OpenCode。
+- `stop-sandbox.sh`：停止 verdaccio 与 tmux session。
+
+## 9. 测试用例
+
+### 9.1 基础对话
+
+| ID    | 输入                   | 通过标准                                  |
+| ----- | ---------------------- | ----------------------------------------- |
+| TC-01 | `hello`                | 3 秒内出现 assistant 回复，无 error 日志  |
+| TC-02 | `what is 2+2?`         | 截图包含答案（如 4）                      |
+| TC-03 | 连续 3 轮简单问答      | provider 日志 session_id 一致，上下文不丢 |
+| TC-04 | 发送一段多段落文本请求 | assistant 回复段落分明，无堆叠            |
+
+### 9.2 复杂任务
+
+| ID    | 输入                               | 通过标准                                             |
+| ----- | ---------------------------------- | ---------------------------------------------------- |
+| TC-10 | `create a Next.js app in ./my-app` | 出现 write_file / execute_command 工具卡片           |
+| TC-11 | 全部批准                           | `my-app/package.json` 存在，且 `npm run build` 成功  |
+| TC-12 | 拒绝一个危险工具                   | provider 日志出现 `approved: false`，agent 正确处理  |
+| TC-13 | 多步工具链任务                     | server 日志显示 tool_call / tool_result 交替，无死锁 |
+| TC-14 | 让 agent 自己读取它刚写的文件      | 返回内容与文件实际内容一致                           |
+
+### 9.3 TUI 专项
+
+| ID    | 场景                          | 通过标准                                     |
+| ----- | ----------------------------- | -------------------------------------------- |
+| TC-20 | 单轮短回复                    | 文字分段，不是连续一团                       |
+| TC-21 | 工具调用后 assistant 继续输出 | 文字接在卡片后，不堆叠                       |
+| TC-22 | HITL 弹窗                     | 工具名、参数、Approve/Decline 完整可见       |
+| TC-23 | 长回复滚动                    | 无重影、无截断                               |
+| TC-24 | 中文/多语言输出               | 字符宽度正确，不散落/重叠                    |
+| TC-25 | 代码块输出                    | 渲染为代码块，不是原始 markdown（如 ```）    |
+| TC-26 | ANSI / 终端序列               | 无 `[14;4H` 这类裸 ANSI 字符出现在文字中     |
+| TC-27 | 工具卡片展开/折叠             | 点击展开后显示完整参数，折叠后不影响后续文字 |
+
+### 9.4 Session 管理
+
+| ID    | 操作              | 通过标准                               |
+| ----- | ----------------- | -------------------------------------- |
+| TC-30 | `/new` 后发送消息 | 新 session_id，旧会话保留在 SQLite     |
+| TC-31 | 切换历史会话      | 能恢复上下文并继续对话                 |
+| TC-32 | 重命名会话        | `cli_sessions` 表 `name` 字段更新      |
+| TC-33 | 删除非当前会话    | 删除后列表中不再出现，当前会话不受影响 |
+
+### 9.5 工具实际执行
+
+| ID    | 操作                        | 通过标准                                            |
+| ----- | --------------------------- | --------------------------------------------------- |
+| TC-40 | `write_file` 创建文件       | 文件存在且内容与参数一致                            |
+| TC-41 | `edit_file` 修改文件        | 文件内容被精确替换                                  |
+| TC-42 | `execute_command echo test` | 返回 `test`                                         |
+| TC-43 | `delete_file` 删除文件      | 文件不存在                                          |
+| TC-44 | 路径解析                    | 相对路径基于 OpenCode cwd，不是 nonoka-cli 安装目录 |
+
+## 10. TUI 测试方法
+
+### 10.1 用 tmux + Playwright 截屏
+
+启动后台 tmux session：
+
+```bash
+cd /tmp/nonoka-test
+./run-opencode-tmux.sh
+```
+
+获取 pane id：
+
+```bash
+tmux list-panes -t nonoka-test -F '#{pane_id}'
+```
+
+输入消息并截图：
+
+```bash
+tmux read -t %0 -l 20
+tmux type -t %0 'hello'
+tmux keys -t %0 Enter
+tmux read -t %0 -l 50
+```
+
+用 Playwright 截取终端窗口，保存到 `/tmp/nonoka-test/screenshots/`。
+
+### 10.2 UI 检查清单
+
+每次截图后检查：
+
+- [ ] 用户输入完整显示。
+- [ ] assistant 回复分段清晰，段落间有空行或缩进。
+- [ ] 工具调用卡片独立渲染，不与文字混排。
+- [ ] 工具调用后文字接在卡片下方，不紧跟卡片右侧。
+- [ ] HITL 弹窗完整，工具名、参数、Approve/Decline 按钮可见。
+- [ ] 滚动后无重影、无截断。
+- [ ] 输入框光标位置正确，无明显延迟。
+- [ ] 中文/日文/韩文等宽字符宽度正确，无散落。
+- [ ] 代码块有语法高亮或独立背景，不是裸 markdown。
+- [ ] 无裸 ANSI 转义序列（如 `[14;4H`）出现在文字中。
+
+## 11. 问题定位决策树
+
+```
+发现问题
+│
+├─ 是否卡住？
+│  ├─ 是 → 查看 /tmp/nonoka-provider.log
+│  │       ├─ 无 doStream start → OpenCode 未调用 provider
+│  │       ├─ spawned child 后无响应 → server 启动失败，看 /tmp/nonoka-server.log
+│  │       ├─ 收到 finish/error 但未 close → provider bug
+│  │       └─ 无 finish 且 server 也无 final → nonoka 框架 / runner 层
+│  └─ 否 → 看 TUI / 结果
+│
+├─ 是否结果错误？
+│  ├─ 先隔离 nonoka-cli --server：直接喂 NDJSON，看 stdout 是否正确
+│  ├─ stdout 正确 → adapter 或 OpenCode 问题
+│  └─ stdout 错误 → nonoka-cli / nonoka 框架问题
+│
+├─ 是否 UI 异常？
+│  ├─ 查看 /tmp/nonoka-tui-timeline.ndjson
+│  │   ├─ bridge text_delta 含 \n 但 UI 未分段 → OpenCode / Ink 渲染问题
+│  │   ├─ bridge text_delta 不含 \n → nonoka-cli / nonoka 框架问题
+│  │   └─ provider 未转发 text_delta → adapter 问题
+│  ├─ 对比 /tmp/nonoka-rendered-text.txt 与截图
+│  └─ 检查 CJK/emoji 宽度、ANSI 泄漏、代码块 markdown
+│
+└─ 是否 Session / 工具执行异常？
+    ├─ 检查 SQLite `cli_sessions` 表
+    ├─ 检查 tool 实际副作用（文件是否存在、命令是否执行）
+    └─ 检查 tool 的路径解析是否基于 cwd
+```
+
+## 12. 回归与发布
+
+修复后：
+
+1. 重新跑 TC-01 ~ TC-44，全部通过。
+2. 如果修改了 `nonoka-agent`：
+   - 更新 `nonoka-agent/pyproject.toml` 版本号。
+   - `uv run twine publish` 发布到 PyPI。
+   - 更新 `nonoka-cli/pyproject.toml` 的 `nonoka` 依赖版本。
+3. 如果修改了 `nonoka-opencode-provider`：
+   - 更新 `package.json` 版本号。
+   - `npm run build && npm publish`。
+4. 如果修改了 `nonoka-cli`：
+   - 更新 `pyproject.toml` 版本号。
+   - 跑 `uv run pytest tests/unit`。
+   - 必要时发布新版到 PyPI。
+
+## 13. 常见问题
+
+### 13.1 OpenCode 仍然加载旧 provider
+
+症状：timeline 里没有 `session_init`，或行为不像最新代码。
+
+解决：
+
+```bash
+rm -rf ~/.cache/opencode/packages/nonoka-opencode-provider
+# 然后重启 OpenCode
+```
+
+### 13.2 verdaccio 启动后 npm publish 报 ECONNREFUSED
+
+症状：`npm publish --registry http://localhost:4873` 失败。
+
+原因：脚本里的 `npx verdaccio &` 在 `bash -c` 包装下可能拿到错误的 PID，导致 verdaccio 没真正启动。
+
+解决：使用沙箱内生成的 `start-verdaccio.sh`（它用 `nohup` 启动并等待端口可用）。
+
+### 13.3 沙箱内的 nonoka-cli 找不到
+
+症状：OpenCode 启动后 provider 子进程报 `nonoka-cli: command not found`。
+
+原因：`opencode.json` 的 `serverCommand` 依赖 PATH，而 OpenCode 的环境没有继承 `env.sh`。
+
+解决：始终通过 `run-opencode.sh` 或 `run-opencode-tmux.sh` 启动，它们会先 `source env.sh`。
+
+### 13.4 API key 未生效
+
+症状：`nonoka-cli config init` 提示 API key 来自环境变量，但值为空。
+
+原因：`.env` 里用的是 `OPENAI_API_KEY`，而 deepseek-chat 需要 `DEEPSEEK_API_KEY`。
+
+解决：`env.sh` 会自动把 `OPENAI_API_KEY` 同步到 `DEEPSEEK_API_KEY`。手动运行时执行 `source env.sh` 即可。

nonoka_cli-0.2.5/.agents/skills/nonoka-tui-testing/references/checklist.md

@@ -0,0 +1,48 @@
+# nonoka-cli TUI 检查清单速查表
+
+每次截屏后逐项检查，勾选通过项，对未通过项记录截图文件名与现象。
+
+## 基础布局
+
+- [ ] 终端整体布局未崩溃，边界对齐。
+- [ ] 顶部/底部状态栏信息完整，不被内容覆盖。
+- [ ] 输入框始终可见，光标位置正确。
+- [ ] 滚动后无重影、无残影、无内容覆盖。
+
+## 文字渲染
+
+- [ ] 用户输入的消息完整显示。
+- [ ] Assistant 回复按段落分段，段间有视觉分隔。
+- [ ] 长文本自动换行，不超出容器边界。
+- [ ] 代码块渲染为代码块（独立背景/语法高亮），不是裸 markdown（如 ```）。
+- [ ] 内联代码、粗体、斜体等 markdown 样式正确。
+- [ ] 工具调用后，后续文字出现在卡片下方，不紧跟卡片右侧。
+
+## 多语言与特殊字符
+
+- [ ] 中文、日文、韩文等 CJK 字符宽度正确，不散落或重叠。
+- [ ] Emoji 宽度正确，不导致后续文字错位。
+- [ ] 无裸 ANSI 转义序列（如 `[14;4H`）出现在可见文字中。
+
+## 工具调用与 HITL
+
+- [ ] 工具调用卡片独立渲染，有图标/工具名/参数。
+- [ ] 工具调用卡片与文字有明显分隔。
+- [ ] 工具执行结果（成功/失败）状态可见。
+- [ ] HITL 弹窗完整显示工具名、参数、Approve/Decline/Modify 按钮。
+- [ ] HITL 弹窗不遮挡输入框或历史消息。
+- [ ] 批准/拒绝后 UI 及时更新，无残留弹窗。
+
+## 交互响应
+
+- [ ] 输入时无明显延迟。
+- [ ] Enter 发送后输入框清空。
+- [ ] 等待 AI 回复时有 loading / thinking 指示。
+- [ ] 多轮对话上下文连续，无会话重置错觉。
+
+## 长任务与复杂输出
+
+- [ ] 长回复滚动流畅，无跳变。
+- [ ] 多个工具调用按时间顺序排列。
+- [ ] 工具调用失败时错误信息可读。
+- [ ] 任务完成后有清晰的总结输出。

nonoka_cli-0.2.5/.agents/skills/nonoka-tui-testing/scripts/analyze-timeline.py

@@ -0,0 +1,100 @@
+#!/usr/bin/env python3
+"""Align screenshots with the TUI event timeline.
+
+Usage:
+    python analyze-timeline.py --root /tmp/nonoka-test --window 0.5
+
+Output:
+    For each screenshot, prints the bridge/provider events within +/- window
+    seconds of the screenshot timestamp. Helps determine whether a rendering
+    issue originates in the backend or the frontend.
+"""
+
+from __future__ import annotations
+
+import argparse
+import json
+from datetime import datetime, timedelta, timezone
+from pathlib import Path
+from typing import Any
+
+
+def parse_ts(ts: str) -> datetime:
+    """Parse an ISO 8601 timestamp with naive or explicit timezone."""
+    # Replace trailing Z with +00:00 for fromisoformat compatibility.
+    if ts.endswith("Z"):
+        ts = ts[:-1] + "+00:00"
+    dt = datetime.fromisoformat(ts)
+    if dt.tzinfo is None:
+        dt = dt.replace(tzinfo=timezone.utc)
+    return dt
+
+
+def load_timeline(root: Path) -> list[dict[str, Any]]:
+    timeline = root / "nonoka-tui-timeline.ndjson"
+    events: list[dict[str, Any]] = []
+    if not timeline.exists():
+        return events
+    for line in timeline.read_text(encoding="utf-8").splitlines():
+        line = line.strip()
+        if not line:
+            continue
+        try:
+            events.append(json.loads(line))
+        except json.JSONDecodeError:
+            continue
+    return events
+
+
+def describe_event(event: dict[str, Any]) -> str:
+    parts = [event.get("source", "?"), event.get("type", "?")]
+    for key in ("toolName", "tool_name", "step", "file", "len", "has_newline"):
+        if key in event:
+            parts.append(f"{key}={event[key]}")
+    preview = event.get("preview")
+    if preview is not None:
+        parts.append(f"preview={preview[:60]!r}")
+    return " ".join(parts)
+
+
+def analyze(root: Path, window_seconds: float) -> None:
+    events = load_timeline(root)
+    if not events:
+        print("No timeline events found.")
+        return
+
+    screenshots = [e for e in events if e.get("type") == "screenshot"]
+    if not screenshots:
+        print("No screenshot events found.")
+        return
+
+    for shot in screenshots:
+        shot_ts = parse_ts(shot["ts"])
+        shot_file = shot.get("file", "unknown")
+        print(f"\n=== {Path(shot_file).name} @ {shot['ts']} ===")
+        for event in events:
+            if event.get("type") == "screenshot":
+                continue
+            event_ts = parse_ts(event["ts"])
+            delta = abs((event_ts - shot_ts).total_seconds())
+            if delta <= window_seconds:
+                marker = "  "
+                if event_ts < shot_ts:
+                    marker = "<-"
+                elif event_ts > shot_ts:
+                    marker = "->"
+                print(f"  {marker} {delta:.3f}s {describe_event(event)}")
+
+
+def main() -> int:
+    parser = argparse.ArgumentParser(description="Align screenshots with TUI timeline")
+    parser.add_argument("--root", default="/tmp/nonoka-test", help="Sandbox root")
+    parser.add_argument("--window", type=float, default=0.5, help="Time window in seconds around each screenshot")
+    args = parser.parse_args()
+
+    analyze(Path(args.root), args.window)
+    return 0
+
+
+if __name__ == "__main__":
+    raise SystemExit(main())