@kairyou/agent-tools 0.11.0 → 0.13.0

package/dist/log/opencode-plugin.mjs

@@ -0,0 +1,113 @@
+// integrations/log/opencode-plugin.mjs
+import { spawn } from "node:child_process";
+import path from "node:path";
+import { fileURLToPath } from "node:url";
+var HOOK = path.join(path.dirname(fileURLToPath(import.meta.url)), "hook.mjs");
+var sendQueue = Promise.resolve();
+function send(payload) {
+  sendQueue = sendQueue.then(
+    () => new Promise((resolve) => {
+      try {
+        const child = spawn("node", [HOOK], {
+          stdio: ["pipe", "ignore", "ignore"],
+          windowsHide: true
+        });
+        child.on("error", () => resolve());
+        child.on("exit", () => resolve());
+        child.stdin.write(JSON.stringify(payload));
+        child.stdin.end();
+      } catch {
+        resolve();
+      }
+    })
+  );
+}
+var AgentToolsLog = async ({ directory, project } = {}) => {
+  const cwd = directory || project?.worktree || process.cwd();
+  const assistantMessageIds = /* @__PURE__ */ new Set();
+  const lastAssistantText = /* @__PURE__ */ new Map();
+  return {
+    "chat.message": async (_input, output) => {
+      const message = output?.message;
+      if (message?.role !== "user") return;
+      const text = (output?.parts || []).filter((part) => part?.type === "text" && typeof part.text === "string").map((part) => part.text).join("\n");
+      if (!text.trim()) return;
+      send({
+        hook_event_name: "UserPromptSubmit",
+        session_id: message.sessionID,
+        cwd,
+        prompt: text
+      });
+    },
+    "tool.execute.before": async (input, output) => {
+      const tool = String(input?.tool || "");
+      if (tool === "bash") return;
+      const args = output?.args;
+      if (!args || typeof args !== "object") return;
+      send({
+        hook_event_name: "PreToolUse",
+        session_id: input?.sessionID,
+        cwd,
+        tool_name: tool === "write" ? "Write" : "Edit",
+        tool_input: args
+      });
+    },
+    "tool.execute.after": async (input, output) => {
+      const sessionId = input?.sessionID;
+      const tool = String(input?.tool || "");
+      if (tool === "bash") {
+        send({
+          hook_event_name: "PostToolUse",
+          session_id: sessionId,
+          cwd,
+          tool_name: "Bash",
+          tool_input: { command: String(input?.args?.command || "") }
+        });
+        return;
+      }
+      const files = output?.metadata?.files;
+      if (!Array.isArray(files)) return;
+      for (const file of files) {
+        if (!file?.filePath) continue;
+        send({
+          hook_event_name: "PostToolUse",
+          session_id: sessionId,
+          cwd,
+          tool_name: tool === "write" ? "Write" : "Edit",
+          tool_input: { file_path: file.filePath }
+        });
+      }
+    },
+    event: async ({ event }) => {
+      const type = event?.type;
+      const properties = event?.properties || {};
+      if (type === "message.updated") {
+        if (properties.info?.role === "assistant") assistantMessageIds.add(properties.info.id);
+        return;
+      }
+      if (type === "message.part.updated") {
+        const part = properties.part;
+        if (part?.type === "text" && assistantMessageIds.has(part.messageID)) {
+          lastAssistantText.set(part.sessionID, String(part.text || ""));
+        }
+        return;
+      }
+      if (type === "session.idle") {
+        send({
+          hook_event_name: "Stop",
+          session_id: properties.sessionID,
+          cwd,
+          last_assistant_message: lastAssistantText.get(properties.sessionID) || ""
+        });
+        lastAssistantText.delete(properties.sessionID);
+        return;
+      }
+      if (type === "session.deleted") {
+        lastAssistantText.delete(properties.sessionID);
+      }
+    }
+  };
+};
+export {
+  AgentToolsLog
+};

package/docs/en/extras.md

@@ -19,13 +19,13 @@ Usage:
 - `/at-self-eval summarize July for C:\projects\project-a and C:\projects\project-b` — only those projects
 - `/at-self-eval also include C:\projects\project-c` — add to the default scope
 - Paste a daily/weekly log, or give a file path, to add business context
-- `/at-self-eval summarize from C:\projects\todo.md only` — log only, Git is not read
+- `/at-self-eval summarize from C:\logs\daily-log.md only` — log only, Git is not read
 
 Review the generated result before use.
 
 ## at-daily-log
 
-Summarize the day's Git activity across projects into a daily work log.
+Distill each day's Git commits across projects into a work report; runs when invoked.
 
 ```bash
 npx -y skills@latest add kairyou/agent-tools --skill at-daily-log -g -y
@@ -35,29 +35,111 @@ Usage:
 
 - `/at-daily-log` — print today's log
 - `/at-daily-log 2026-07-31` — pick the date
+- `/at-daily-log last week` / `/at-daily-log the last two weeks` — one entry per active day, empty days skipped
 - `/at-daily-log summarize today for C:\projects\project-a` — only that project
 - `/at-daily-log also include C:\projects\project-c` — add to the default scope
 - `/at-daily-log record the log` — record to the configured file; rerunning a day only refreshes the generated part
-- `/at-daily-log record it to C:\projects\todo.md` — record to that file
-- `/at-daily-log record every workday at 18:00` — guides you through an OS scheduled task
+- `/at-daily-log record it to C:\logs\daily-log.md` — record to that file
+- `/at-daily-log record daily at 18:00` — guides you through an OS scheduled task; days without commits are not written
 
+Recorded output example:
+
+```markdown
++ 2026-08-03
+<!-- daily-log:2026-08-03:start 5,a1b2c3d -->
+  1. project-a: finished the login module refactor with regression coverage.
+  2. project-b: fixed the timezone offset in report exports.
+<!-- daily-log:2026-08-03:end -->
+```
+
+The `<!-- ... -->` comments are boundary markers: an update rewrites only what sits
+between them, and everything else in the file (such as your own notes) is left alone.
+
+Paired with the `log` capability below, work that ships no code, such as troubleshooting, also reaches the report.
 Review the generated result before use.
 
-## Optional configuration
+## log
+
+Record each day's AI sessions across projects into a work log; runs automatically
+once installed.
+
+Independent of and complementary to `at-daily-log` above; use them together or alone.
+
+```bash
+npx -y @kairyou/agent-tools@latest log -a claude codex opencode
+```
+
+- `format: "daily"` (default): a single markdown file, one dated entry per day, each turn summarized into one line
+- `format: "detailed"`: one full report per day with each turn's request and outcome, the files changed, and approximate lines added/removed (measured against the current file when several turns touch one)
+- Codex: run `/hooks` once after installing to approve it; opencode: restart after installing or updating
+
+`daily` output example:
+
+```markdown
++ 2026-08-03
+<!-- log:2026-08-03:start -->
+  1. project-a: traced the login timeout to sessions never renewing.
+  2. project-a: fixed the login timeout, added regression tests.
+  3. project-b: traced empty report exports to an inverted permission filter.
+<!-- log:2026-08-03:end -->
+```
+
+One line per turn, written from the AI's own summary at the end of that turn; no
+cross-turn consolidation. Updates likewise rewrite only what sits between the markers.
+
+`detailed` output example (excerpt):
+
+```markdown
+# AI Log - 2026-08-03
+
+## Overview
+
+- Prompts: 5
+- Changed files: 3
+- Line changes: +120/-30
+
+## Sessions
+
+- Time: 2026-08-03 10:12:01 -> 2026-08-03 10:20:45
+- Project: project-a
+
+Request
+(request excerpt)
+
+Outcome
+(outcome summary)
+
+Changes
+- src/auth/session.ts | diff +42/-8 | 3 ops
+```
+
+## Configuration
 
 All in `~/.agent-tools/config.jsonc`:
 
 ```jsonc
 {
-  // at-self-eval, at-daily-log: default projects (otherwise just the current repo)
+  // log capability: AI session log
+  "log": {
+    "enabled": true,                // false: pause recording without uninstalling
+    "output": "C:\\logs\\ai-log.md",  // daily: one file; detailed: a directory
+    "language": "zh",                 // zh | en
+    "format": "daily",                // daily | detailed
+    "projects": [                     // optional: record only these; entries may override the keys above
+      "C:\\projects\\project-a",
+      { "path": "C:\\projects\\project-b", "format": "detailed", "output": "C:\\logs\\project-b" }
+    ]
+  },
+  // at-self-eval, at-daily-log: default projects (otherwise just the current repo);
+  // prompt: free text that tunes how that project is summarized
   "workProjects": [
     "C:\\projects\\project-a",
-    "C:\\projects\\project-b"
+    { "path": "C:\\projects\\project-b", "prompt": "refer to `phoenix` as `Shop App` in the output; skip commits starting with `test:`" }
     // "C:\\projects\\temporarily-disabled"
   ],
   // at-daily-log: default file when asked to record; at-self-eval also reads it as fallback
   "dailyLog": {
-    "output": "C:\\projects\\todo.md"
+    "output": "C:\\logs\\daily-log.md"
   }
 }
 ```

package/docs/zh-CN/extras.md

@@ -18,13 +18,13 @@ npx -y skills@latest add kairyou/agent-tools --skill at-self-eval -g -y
 - `/at-self-eval 统计 C:\projects\project-a 和 C:\projects\project-b 的 7 月工作` — 只统计指定项目
 - `/at-self-eval 另外包含 C:\projects\project-c` — 在默认范围上追加
 - 可粘贴日报或周报文本, 也可提供文件路径补充业务背景
-- `/at-self-eval 只根据 C:\projects\todo.md 总结` — 只凭日志生成, 不读 Git
+- `/at-self-eval 只根据 C:\logs\daily-log.md 总结` — 只凭日志生成, 不读 Git
 
 生成的结果请人工核对.
 
 ## at-daily-log
 
-汇总一天内各项目的 Git 活动, 生成工作日报.
+按天把各项目的 Git 提交提炼成工作日报, 调用时生成.
 
 ```bash
 npx -y skills@latest add kairyou/agent-tools --skill at-daily-log -g -y
@@ -34,29 +34,110 @@ npx -y skills@latest add kairyou/agent-tools --skill at-daily-log -g -y
 
 - `/at-daily-log` — 输出今天的日报
 - `/at-daily-log 2026-07-31` — 指定日期
+- `/at-daily-log 上周` / `/at-daily-log 最近两周` — 范围内每天一条, 跳过没有提交的日子
 - `/at-daily-log 统计 C:\projects\project-a 今天的工作` — 只统计指定项目
 - `/at-daily-log 另外包含 C:\projects\project-c` — 在默认范围上追加
 - `/at-daily-log 记录日报` — 记录到配置的文件; 同一天重复执行只更新生成的部分
-- `/at-daily-log 记录到 C:\projects\todo.md` — 记录到指定文件
-- `/at-daily-log 每个工作日 18:00 自动记录` — 引导搭建系统定时任务
+- `/at-daily-log 记录到 C:\logs\daily-log.md` — 记录到指定文件
+- `/at-daily-log 每天 18:00 自动记录` — 引导搭建系统定时任务; 没有提交的日子不会写入
 
+记录到文件的示例:
+
+```markdown
++ 2026-08-03
+<!-- daily-log:2026-08-03:start 5,a1b2c3d -->
+  1. project-a: 完成登录模块重构, 覆盖回归用例.
+  2. project-b: 修复导出报表的时区偏移.
+<!-- daily-log:2026-08-03:end -->
+```
+
+`<!-- ... -->` 注释是边界标记: 更新只重写两个标记之间的内容, 文件里的其他部分
+(比如你手写的备注)不会被碰.
+
+搭配下方的 `log` 使用时, 排查问题这类没提交代码的工作也能进日报.
 生成的结果请人工核对.
 
-## 可选配置
+## log
+
+按天把各项目的 AI 会话记录成工作日志, 安装后自动运行.
+
+和上面的 `at-daily-log` 独立互补, 可一起使用或单独使用.
+
+```bash
+npx -y @kairyou/agent-tools@latest log -a claude codex opencode
+```
+
+- `format: "daily"` (默认): 单一 md 文件, 每天一个日期条目, 每轮对话总结成一行
+- `format: "detailed"`: 每天一份详细报告, 含每轮的请求与结果, 改动的文件和近似的增删行数(多轮改同一文件时按当前文件计算)
+- Codex 安装后运行 `/hooks` 批准一次; opencode 安装或更新后需要重启
+
+`daily` 输出示例:
+
+```markdown
++ 2026-08-03
+<!-- log:2026-08-03:start -->
+  1. project-a: 排查登录超时, 定位到会话缓存没有续期.
+  2. project-a: 修复登录超时, 补充回归用例.
+  3. project-b: 定位报表导出为空的问题, 原因是权限过滤条件写反.
+<!-- log:2026-08-03:end -->
+```
+
+每轮一行, 内容是那一轮结束时 AI 自己写的总结, 不做跨轮归纳; 同样只重写标记之间
+的部分, 文件里的其他内容不会被碰.
+
+`detailed` 输出示例(节选):
+
+```markdown
+# AI 日报 - 2026-08-03
+
+## 今日概览
+
+- 请求次数: 5
+- 变更文件数: 3
+- 总行变更: +120/-30
+
+## 会话记录
+
+- Time: 2026-08-03 10:12:01 -> 2026-08-03 10:20:45
+- Project: project-a
+
+Request
+(请求原文摘录)
+
+Outcome
+(结果摘要)
+
+Changes
+- src/auth/session.ts | 变更 +42/-8 | 操作 3 次
+```
+
+## 配置
 
 都在 `~/.agent-tools/config.jsonc`:
 
 ```jsonc
 {
-  // at-self-eval, at-daily-log: 默认统计的项目(不配则只统计当前项目)
+  // log capability: AI 会话日志
+  "log": {
+    "enabled": true,                // false: 临时停止记录, 不用卸载
+    "output": "C:\\logs\\ai-log.md",  // daily: 单一文件; detailed: 目录
+    "language": "zh",                 // zh | en
+    "format": "daily",                // daily | detailed
+    "projects": [                     // 可选: 只记录这些目录, 条目可覆盖上面的键
+      "C:\\projects\\project-a",
+      { "path": "C:\\projects\\project-b", "format": "detailed", "output": "C:\\logs\\project-b" }
+    ]
+  },
+  // at-self-eval, at-daily-log: 默认统计的项目(不配则只统计当前项目);
+  // prompt: 该项目的提示词, 用来优化生成的日报和总结
   "workProjects": [
     "C:\\projects\\project-a",
-    "C:\\projects\\project-b"
+    { "path": "C:\\projects\\project-b", "prompt": "输出里把 `phoenix` 称作 `商城App`, 跳过 `test:` 开头的提交" }
     // "C:\\projects\\temporarily-disabled"
   ],
   // at-daily-log: 记录日报的默认文件; 未提供日志时 at-self-eval 也读它作补充
   "dailyLog": {
-    "output": "C:\\projects\\todo.md"
+    "output": "C:\\logs\\daily-log.md"
   }
 }
 ```