@yoooclaw/cli 0.0.1 → 0.0.2

package/dist/index.d.ts

@@ -6,4 +6,3 @@ export { ErrorCode, YoooclawError } from "./errors.js";
 export { renderResult, renderError, resolveFormat, type OutputFormat, } from "./output/format.js";
 export { buildContext, resolveActiveProfile, type CliContext, type GlobalFlags, } from "./context.js";
 export * as paths from "./paths.js";
-//# sourceMappingURL=index.d.ts.map

package/dist/output/format.d.ts

@@ -16,4 +16,3 @@ export declare function renderResult(data: unknown, opts: RenderOptions): void;
  */
 export declare function renderError(err: unknown, opts: RenderOptions): void;
 export {};
-//# sourceMappingURL=format.d.ts.map

package/dist/paths.d.ts

@@ -20,6 +20,11 @@ export interface ProfilePaths {
     lightRules: string;
     state: string;
 }
+/** profiles/ 根目录。 */
+export declare function profilesRoot(): string;
+/** 列出已存在的 profile 名（profiles/ 下的目录）。 */
+export declare function listProfileNames(): string[];
+/** 读取 active-profile 文件内容（不存在返回 undefined）。 */
+export declare function readActiveProfile(): string | undefined;
 /** 解析某个 profile 下的全部关键路径。 */
 export declare function profilePaths(profile: string): ProfilePaths;
-//# sourceMappingURL=paths.d.ts.map

package/dist/program.d.ts

@@ -1,13 +1,14 @@
 /**
  * 构建 yoooclaw 的 commander 程序。
  *
- * 命令树来自 command-tree.ts（单一事实来源）。脚手架阶段所有 action 走 notImplemented
- * 占位，但已贯通全局 flags、CliContext 解析与统一输出/错误层 —— 后续替换 action 体即可。
+ * 命令树结构（service / subcommand / shortcut / options）来自 command-tree.ts；
+ * 实现体由 commands/registry.ts 按 path（如 `config init`）提供，未注册则回落 notImplemented。
  */
 import { Command } from "commander";
 import { type CliContext } from "./context.js";
 /** 命令处理器签名：拿到上下文 + commander 解析后的参数/选项，返回可序列化结果。 */
 export type CommandHandler = (ctx: CliContext, args: unknown[], opts: Record<string, unknown>) => unknown;
+/** 注册表的 path key：去掉子命令名里的位置参数占位（`show <id>` → `show`）。 */
+export declare function handlerKey(service: string, subName: string): string;
 /** 构建并返回顶层 commander 程序。 */
 export declare function buildProgram(): Command;
-//# sourceMappingURL=program.d.ts.map

package/dist/version.d.ts

@@ -1,2 +1 @@
 export declare const CLI_VERSION: string;
-//# sourceMappingURL=version.d.ts.map

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@yoooclaw/cli",
-  "version": "0.0.1",
+  "version": "0.0.2",
   "type": "module",
   "description": "yoooclaw 独立 CLI：本地守护进程接收手机通知、Relay 隧道、灯效规则评估，Agent-Native",
   "bin": {
@@ -20,10 +20,9 @@
     "skills"
   ],
   "scripts": {
-    "build": "bun run build:js && bun run build:types",
+    "build": "bun scripts/build.ts",
     "build:js": "bun scripts/build.ts",
-    "build:types": "tsc --emitDeclarationOnly --outDir dist",
-    "dev": "tsc --watch",
+    "dev": "tsc --noEmit --watch",
     "test": "vitest run",
     "test:watch": "vitest",
     "typecheck": "tsc --noEmit",

package/skills/yoooclaw-lightrule-create/SKILL.md

@@ -0,0 +1,62 @@
+---
+name: yoooclaw-lightrule-create
+description: 用 yoooclaw CLI 创建/管理"通知→灯效"规则。当用户表达"收到/当/如果某类通知或消息时，亮灯/闪灯/变成某种灯效"这类**持久规则**诉求时激活。规则由 daemon 在通知 ingest 后评估命中并触发灯效。需要 daemon 在运行（🟡）。从 stdin 用 --from-file - 提交规则定义最稳妥。
+---
+
+# yoooclaw 灯效规则创建（从 stdin）
+
+灯效规则是**持久**的：通知到达后 daemon 评估是否命中，命中则播放灯效。
+和"立即放一次灯效测试"不同（那是 `yoooclaw light send`）。
+
+> 需要 daemon 在跑：先 `yoooclaw daemon status`，未运行则 `yoooclaw daemon start`。
+
+## 何时激活
+
+- "微信群里有人@我时红灯闪三下"
+- "收到老板的消息就亮黄灯"
+- "飞书有新消息时呼吸绿灯"
+- 任何"当 X 通知 → 播放 Y 灯效"的持久化诉求。
+
+不要为这类诉求调用 `light send`（那只用于一次性测试/预览）。
+
+## 创建规则（首选 --from-file - 从 stdin）
+
+```bash
+cat <<'JSON' | yoooclaw lightrule create --from-file - --format json
+{
+  "name": "wechat-at-me",
+  "title": "微信@我",
+  "description": "微信群里有人@我时红灯快闪",
+  "segments": [
+    { "mode": "strobe", "duration_s": 2, "brightness": 255,
+      "color": { "r": 255, "g": 0, "b": 0 }, "interval_ms": 200 }
+  ]
+}
+JSON
+```
+
+字段说明：
+
+- `name`（必填）：规则唯一标识。
+- `description`（必填）：自然语言意图，daemon 的 webhook 评估器据此判断通知是否命中。
+- `segments`（必填）：命中后播放的灯效，遵循 light protocol（mode/duration_s/brightness/color/interval_ms 等）。
+- 也可用 flag 形式：`--name --intent <描述> --light-action <segments JSON> --match-rules <硬过滤 JSON>`。
+
+## 管理
+
+```bash
+yoooclaw lightrule list --format json          # 列出全部规则及 enabled 状态
+yoooclaw lightrule show <name> --format json   # 单条详情
+yoooclaw lightrule disable <name>              # 停用（不删除）
+yoooclaw lightrule enable <name>               # 启用
+yoooclaw lightrule +off                        # 停用所有
+yoooclaw lightrule +on                         # 启用所有
+yoooclaw lightrule delete <name> --yes         # 删除
+```
+
+## 错误处理
+
+- `YOOOCLAW_DAEMON_NOT_RUNNING`：先 `yoooclaw daemon start` 再重试。
+- 创建失败常见为 `VALIDATION_FAILED`（segments 不合法）或 `INVALID_PARAMS`（缺 name/description）：
+  读 `error.message`（含具体校验项）后修正 JSON 重新提交。
+- 规则名重复：换 `name` 或先 `delete`。

package/skills/yoooclaw-notification-query/SKILL.md

@@ -0,0 +1,70 @@
+---
+name: yoooclaw-notification-query
+description: 用 yoooclaw CLI 直接、流式地查询手机通知原始数据。当用户说"看看最近的通知""谁找过我""总结今天的消息""某 App 有什么通知""昨天有什么消息"或任何通知查询/筛选/汇总诉求时，激活本 Skill，基于当前磁盘最新数据查询，不要依赖先前轮次或记忆。yoooclaw 是 openclaw 手机通知插件的独立 CLI 形态，数据在 ~/.yoooclaw 下，纯读磁盘、不需要 daemon 在跑。
+---
+
+# yoooclaw 通知查询（Agent-Native，流式）
+
+`yoooclaw` CLI 自身就是工具表：所有命令都支持 `--format json|pretty|table|ndjson`。
+**Agent 消费首选 `--format ndjson`**——每条通知一行 JSON、无包裹数组，便于流式逐条处理大批量结果。
+
+> 命令名 `yoooclaw`，短别名 `yc` 完全等价。下文用 `yoooclaw`。
+
+## 何时激活
+
+- "最近收到什么消息 / 谁找过我 / 某某给我发过什么"
+- "总结今天 / 昨天 / 最近一小时的通知"
+- "微信 / 飞书 有什么通知"
+- 任何按 时间 / 应用 / 发送人 / 关键词 筛选通知的诉求
+
+## 先确认存储路径（不要假设目录）
+
+```bash
+yoooclaw notification storage-path --format json
+# → {"ok":true,"path":"/abs/path/to/profiles/<profile>/notifications"}
+```
+
+## 查询（按需选参数）
+
+```bash
+# 今日全部（快捷命令，等价 search --from 今日00:00 --to 今日23:59）
+yoooclaw notification +today --format ndjson
+
+# 最近一小时
+yoooclaw notification +recent --format ndjson
+
+# 精确筛选：时间范围 + 应用 + 关键词
+yoooclaw notification search \
+  --from 2026-05-01T00:00:00+08:00 --to 2026-05-21T23:59:59+08:00 \
+  --app 微信 --keyword 开会 --limit 200 --format ndjson
+
+# 聚合摘要（topApps / topSenders / 最近样例），适合"帮我总结"
+yoooclaw notification summary --top 10 --sample 30 --format json
+
+# 维度统计（date|app|sender|hour|all）
+yoooclaw notification stats --from 2026-05-14 --to 2026-05-21 --dim all --format json
+```
+
+- `--app` 支持中英文别名：`微信/wechat`、`飞书/feishu/lark`、`钉钉/dingtalk`、`企业微信/wecom` 等。
+- `--from/--to` 用 ISO 8601 含时区（`2026-05-01T09:00:00+08:00`）。`stats` 的 `--from/--to` 用 `YYYY-MM-DD`。
+
+## 流式处理 ndjson 的样板
+
+```bash
+yoooclaw notification search --app 微信 --format ndjson | while IFS= read -r line; do
+  # 每行是一条 StoredNotification：{appName,appDisplayName,title,content,timestamp,senderName,conversationType,...}
+  echo "$line" | jq -r '"\(.timestamp) \(.appDisplayName // .appName) | \(.senderName // .title): \(.content)"'
+done
+```
+
+## 错误处理
+
+所有命令失败都输出统一 schema 并以非零退出码结束：
+
+```json
+{ "ok": false, "error": { "code": "YOOOCLAW_...", "message": "...", "hint": "..." } }
+```
+
+- `YOOOCLAW_INVALID_ARGUMENT`：时间格式 / `--conversation-type`（只能 group|private）/ `--limit` 非正整数 → 按 `message` 修正参数。
+- 通知目录尚不存在或当天无数据：`search` 返回 `[]`、`+today` 返回 `[]`，**不是错误**——直接据此回复"暂无通知"。
+- 多 profile：加 `--profile <name>` 查指定 profile 的数据。

package/skills/yoooclaw-tunnel-debug/SKILL.md

@@ -0,0 +1,52 @@
+---
+name: yoooclaw-tunnel-debug
+description: 用 yoooclaw CLI 排查手机端推送链路是否通。当用户说"手机推送收不到""通知没同步过来""检查一下隧道/连接""daemon 还活着吗""手机连不上"时激活。组合使用 daemon status / tunnel status / tunnel +test / gateway test 自检整条接收链路。多数命令需要 daemon 在运行（🟡）。
+---
+
+# yoooclaw 隧道 / 接收链路排查
+
+独立 daemon 当前以**直连 HTTP** 接收手机推送（`POST /notifications`），
+配合用户自建 `cloudflared` / `tailscale serve` 反代到 daemon 的本地地址即可让手机端推达。
+
+## 何时激活
+
+- "手机推送收不到 / 通知没同步过来"
+- "检查隧道 / 连接 / daemon 状态"
+- "手机连不上 / 一直没新消息"
+
+## 排查顺序
+
+```bash
+# 1) daemon 是否在跑、监听哪个地址端口
+yoooclaw daemon status --format json
+#   未运行 → {"ok":false,"error":{"code":"YOOOCLAW_DAEMON_NOT_RUNNING",...}} → yoooclaw daemon start
+
+# 2) 隧道状态（relay 模式 / 是否连接 / relay URL）
+yoooclaw tunnel status --format json
+#   → {"ok":true,"mode":"standalone-http","connected":false,"relayUrl":"...","note":"..."}
+
+# 3) 端到端回环自检：daemon 通过本地 HTTP 给自己发一条 echo 通知，验证 ingest+鉴权链路
+yoooclaw tunnel +test --format json
+#   → {"ok":true,"loopback":{"ok":true,"status":200}}  表示本机接收链路 OK
+
+# 4) 模拟手机端调 /notifications，验证鉴权与连通
+yoooclaw gateway test --format json
+#   → {"ok":true,"status":200,"response":{"ok":true,"ingested":1,...}}
+#   要强制走 relay 旁路：yoooclaw gateway test --via-relay
+```
+
+## 判读
+
+- `daemon status` 报 `YOOOCLAW_DAEMON_NOT_RUNNING` → daemon 没起，先 `yoooclaw daemon start`。
+- `tunnel +test` 的 `loopback.ok=true` 且 `gateway test` `ok=true`：**本机接收链路正常**。
+  手机仍收不到 → 问题在网络可达性：检查防火墙、反代（cloudflared/tailscale）、手机端填的地址是否指向 daemon 的对外地址。
+- `gateway test` 返回 `401 / YOOOCLAW_UNAUTHORIZED`：token 不一致。
+  用 `yoooclaw auth status` 看 token 来源，必要时 `yoooclaw auth token-rotate` 后重启 daemon、并更新手机端 token。
+- 想看 daemon 自身日志定位 ingest 失败：`yoooclaw daemon logs --lines 200`（或 `yoooclaw log +errors`）。
+
+## 鉴权前置检查（不调 daemon）
+
+```bash
+yoooclaw auth status --format json   # api-key / gateway token 是否存在、来源、daemon 是否可达
+yoooclaw auth check --format json    # 端到端：用本地 token 调 daemon /daemon/status 验证一致性
+```

package/dist/bin.d.ts

@@ -1,2 +0,0 @@
-export {};
-//# sourceMappingURL=bin.d.ts.map

package/dist/bin.d.ts.map

@@ -1 +0,0 @@
-{"version":3,"file":"bin.d.ts","sourceRoot":"","sources":["../src/bin.ts"],"names":[],"mappings":""}

package/dist/command-tree.d.ts.map

@@ -1 +0,0 @@
-{"version":3,"file":"command-tree.d.ts","sourceRoot":"","sources":["../src/command-tree.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AAEH,MAAM,WAAW,cAAc;IAC7B,sDAAsD;IACtD,IAAI,EAAE,MAAM,CAAC;IACb,OAAO,EAAE,MAAM,CAAC;CACjB;AAED,MAAM,WAAW,YAAY;IAC3B,gCAAgC;IAChC,IAAI,EAAE,MAAM,CAAC;IACb,OAAO,EAAE,MAAM,CAAC;CACjB;AAED,MAAM,WAAW,WAAW;IAC1B,IAAI,EAAE,MAAM,CAAC;IACb,OAAO,EAAE,MAAM,CAAC;IAChB,8CAA8C;IAC9C,WAAW,CAAC,EAAE,cAAc,EAAE,CAAC;IAC/B,oDAAoD;IACpD,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,SAAS,CAAC,EAAE,YAAY,EAAE,CAAC;CAC5B;AAED,eAAO,MAAM,YAAY,EAAE,WAAW,EA0KrC,CAAC"}

package/dist/context.d.ts.map

@@ -1 +0,0 @@
-{"version":3,"file":"context.d.ts","sourceRoot":"","sources":["../src/context.ts"],"names":[],"mappings":"AAIA,OAAO,EAIL,KAAK,YAAY,EAClB,MAAM,YAAY,CAAC;AACpB,OAAO,EAAiB,KAAK,YAAY,EAAE,MAAM,oBAAoB,CAAC;AAEtE,MAAM,WAAW,WAAW;IAC1B,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,KAAK,CAAC,EAAE,OAAO,CAAC;IAChB,KAAK,CAAC,EAAE,OAAO,CAAC;CACjB;AAED,MAAM,WAAW,UAAU;IACzB,OAAO,EAAE,MAAM,CAAC;IAChB,KAAK,EAAE,YAAY,CAAC;IACpB,MAAM,EAAE,YAAY,CAAC;IACrB,KAAK,EAAE,OAAO,CAAC;IACf,KAAK,EAAE,OAAO,CAAC;CAChB;AAED,uFAAuF;AACvF,wBAAgB,oBAAoB,CAAC,WAAW,CAAC,EAAE,MAAM,GAAG,MAAM,CAUjE;AAED,qCAAqC;AACrC,wBAAgB,YAAY,CAAC,KAAK,EAAE,WAAW,GAAG,UAAU,CAU3D"}

package/dist/errors.d.ts.map

@@ -1 +0,0 @@
-{"version":3,"file":"errors.d.ts","sourceRoot":"","sources":["../src/errors.ts"],"names":[],"mappings":"AAAA;;;GAGG;AACH,eAAO,MAAM,SAAS;IACpB,iBAAiB;;IAEjB,aAAa;;IAEb,uBAAuB;;IAEvB,iBAAiB;;IAEjB,wBAAwB;;IAExB,uBAAuB;;IAEvB,cAAc;;IAEd,kBAAkB;;IAElB,eAAe;;IAEf,YAAY;;CAEJ,CAAC;AAEX,MAAM,MAAM,cAAc,GAAG,CAAC,OAAO,SAAS,CAAC,CAAC,MAAM,OAAO,SAAS,CAAC,CAAC;AAExE,MAAM,WAAW,oBAAoB;IACnC,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,YAAY,CAAC,EAAE,MAAM,EAAE,CAAC;IACxB,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO,CAAC;CACxB;AAED;;GAEG;AACH,qBAAa,aAAc,SAAQ,KAAK;IACtC,QAAQ,CAAC,IAAI,EAAE,cAAc,CAAC;IAC9B,QAAQ,CAAC,OAAO,EAAE,oBAAoB,CAAC;IACvC,iBAAiB;IACjB,QAAQ,CAAC,QAAQ,EAAE,MAAM,CAAC;gBAGxB,IAAI,EAAE,cAAc,EACpB,OAAO,EAAE,MAAM,EACf,OAAO,GAAE,oBAAyB,EAClC,QAAQ,SAAI;IASd,cAAc,IAAI;QAChB,IAAI,EAAE,cAAc,CAAC;QACrB,OAAO,EAAE,MAAM,CAAC;KACjB,GAAG,oBAAoB;CAGzB;AAED,wBAAgB,cAAc,CAAC,OAAO,EAAE,MAAM,GAAG,aAAa,CAM7D"}

package/dist/index.d.ts.map

@@ -1 +0,0 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAQA,wBAAsB,GAAG,CAAC,IAAI,GAAE,MAAM,EAAiB,GAAG,OAAO,CAAC,IAAI,CAAC,CAGtE;AAED,OAAO,EAAE,YAAY,EAAE,MAAM,cAAc,CAAC;AAC5C,OAAO,EAAE,YAAY,EAAE,MAAM,mBAAmB,CAAC;AACjD,OAAO,EAAE,WAAW,EAAE,MAAM,cAAc,CAAC;AAC3C,OAAO,EAAE,SAAS,EAAE,aAAa,EAAE,MAAM,aAAa,CAAC;AACvD,OAAO,EACL,YAAY,EACZ,WAAW,EACX,aAAa,EACb,KAAK,YAAY,GAClB,MAAM,oBAAoB,CAAC;AAC5B,OAAO,EACL,YAAY,EACZ,oBAAoB,EACpB,KAAK,UAAU,EACf,KAAK,WAAW,GACjB,MAAM,cAAc,CAAC;AACtB,OAAO,KAAK,KAAK,MAAM,YAAY,CAAC"}

package/dist/output/format.d.ts.map

@@ -1 +0,0 @@
-{"version":3,"file":"format.d.ts","sourceRoot":"","sources":["../../src/output/format.ts"],"names":[],"mappings":"AAaA,MAAM,MAAM,YAAY,GAAG,MAAM,GAAG,QAAQ,GAAG,OAAO,GAAG,QAAQ,CAAC;AAClE,eAAO,MAAM,cAAc,EAAE,YAAY,EAKxC,CAAC;AAEF,6CAA6C;AAC7C,wBAAgB,aAAa,CAC3B,SAAS,EAAE,MAAM,GAAG,SAAS,EAC7B,KAAK,UAAgC,GACpC,YAAY,CAYd;AAED,UAAU,aAAa;IACrB,MAAM,EAAE,YAAY,CAAC;IACrB,mCAAmC;IACnC,MAAM,CAAC,EAAE,MAAM,CAAC,cAAc,CAAC;CAChC;AAMD,gDAAgD;AAChD,wBAAgB,YAAY,CAAC,IAAI,EAAE,OAAO,EAAE,IAAI,EAAE,aAAa,GAAG,IAAI,CAkBrE;AAED;;;;GAIG;AACH,wBAAgB,WAAW,CAAC,GAAG,EAAE,OAAO,EAAE,IAAI,EAAE,aAAa,GAAG,IAAI,CAenE"}

package/dist/paths.d.ts.map

@@ -1 +0,0 @@
-{"version":3,"file":"paths.d.ts","sourceRoot":"","sources":["../src/paths.ts"],"names":[],"mappings":"AAeA,eAAO,MAAM,eAAe,YAAY,CAAC;AAEzC,mDAAmD;AACnD,wBAAgB,OAAO,IAAI,MAAM,CAEhC;AAED,4CAA4C;AAC5C,wBAAgB,qBAAqB,IAAI,MAAM,CAE9C;AAED,iCAAiC;AACjC,wBAAgB,iBAAiB,IAAI,MAAM,CAE1C;AAED,sBAAsB;AACtB,wBAAgB,UAAU,CAAC,OAAO,EAAE,MAAM,GAAG,MAAM,CAElD;AAED,MAAM,WAAW,YAAY;IAC3B,OAAO,EAAE,MAAM,CAAC;IAChB,GAAG,EAAE,MAAM,CAAC;IACZ,MAAM,EAAE,MAAM,CAAC;IACf,WAAW,EAAE,MAAM,CAAC;IACpB,UAAU,EAAE,MAAM,CAAC;IACnB,SAAS,EAAE,MAAM,CAAC;IAClB,aAAa,EAAE,MAAM,CAAC;IACtB,UAAU,EAAE,MAAM,CAAC;IACnB,MAAM,EAAE,MAAM,CAAC;IACf,UAAU,EAAE,MAAM,CAAC;IACnB,KAAK,EAAE,MAAM,CAAC;CACf;AAED,6BAA6B;AAC7B,wBAAgB,YAAY,CAAC,OAAO,EAAE,MAAM,GAAG,YAAY,CAe1D"}

package/dist/program.d.ts.map

@@ -1 +0,0 @@
-{"version":3,"file":"program.d.ts","sourceRoot":"","sources":["../src/program.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AACH,OAAO,EAAE,OAAO,EAAE,MAAM,WAAW,CAAC;AAEpC,OAAO,EAAgB,KAAK,UAAU,EAAoB,MAAM,cAAc,CAAC;AAK/E,oDAAoD;AACpD,MAAM,MAAM,cAAc,GAAG,CAC3B,GAAG,EAAE,UAAU,EACf,IAAI,EAAE,OAAO,EAAE,EACf,IAAI,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,KAC1B,OAAO,CAAC;AA6Db,4BAA4B;AAC5B,wBAAgB,YAAY,IAAI,OAAO,CAyBtC"}

package/dist/version.d.ts.map

@@ -1 +0,0 @@
-{"version":3,"file":"version.d.ts","sourceRoot":"","sources":["../src/version.ts"],"names":[],"mappings":"AA6BA,eAAO,MAAM,WAAW,QACiD,CAAC"}