opencode-plannotator-tui 0.2.2 → 0.3.0

package/CHANGELOG.md

@@ -1,5 +1,16 @@
 # Changelog
 
+## 0.3.0
+
+- Select older completed replies with `/annotate 2`, `/annotate 3`, and so on.
+  Bare `/annotate` and `/annotate 1` still select the latest reply.
+- Count only eligible completed text replies across history pages; report missing
+  replies and invalid numbers without opening a different source.
+- `/annotate-last` now always selects the latest reply and ignores arguments.
+  **Migration:** replace `/annotate-last file.md` with `/annotate file.md`.
+- Verify numbered feedback delivery and fixed latest-reply selection in the real
+  terminal smoke test, alongside 21 behavior tests.
+
 ## 0.2.2
 
 - All confirmation dialogs, status notices, errors, and the feedback header sent

package/README.md

@@ -13,12 +13,14 @@ official OpenCode or Plannotator release.
 
 ```text
 /annotate                         Review the last completed assistant reply
+/annotate 2                       Review the second most recent reply
+/annotate 3                       Review the third most recent reply
 /annotate docs/plan.md            Review a Markdown document
 /annotate "docs/release plan.md"  Review a path containing spaces
 /annotate ~/Documents/notes.txt   Review a plain-text document
 ```
 
-`/annotate-last` is an alias with the same optional file argument.
+`/annotate-last` always reviews the latest completed reply; any supplied argument is ignored.
 
 ## Install
 
@@ -75,6 +77,9 @@ cancelled reviews submit nothing.
 
 **Replies:** the latest completed text reply, with paginated history lookup.
 Reasoning, in-progress messages and tool-call commentary are excluded.
+Pass a positive integer to select the Nth most recent eligible reply: `1` is the
+default, `2` is the previous reply, and so on. If there are too few replies, the
+plugin reports that instead of opening another reply.
 
 **Documents:** local UTF-8 `.md`, `.mdx`, `.markdown` and `.txt` files up to 2 MiB.
 Relative paths resolve against the captured session's working directory, not the
@@ -160,8 +165,9 @@ See [release instructions](docs/releasing.md) and [changelog](CHANGELOG.md).
 这是 **Plannotator TUI 的非官方 OpenCode 适配插件**。
 
 - `/annotate`：批注上一条完整回复。
+- `/annotate 2`：批注倒数第二条，`3`、`4` 依次往前；`1` 等同于默认。
 - `/annotate 文档.md`：批注文档，支持中文、空格和相对路径。
-- `/annotate-last`：同义入口，也可带文件路径。
+- `/annotate-last`：固定批注最新一条完整回复，忽略附带参数。
 - 选中文字 → `c` 写批注 → Enter 保存 → `q` 返回 →「Send and continue」。
 - 文档采用独立快照，反馈附原文件路径，确认后发回发起批注的会话。
 - 更新：`opencode plugin update opencode-plannotator-tui@latest`，然后重新打开终端客户端。

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "opencode-plannotator-tui",
-  "version": "0.2.2",
+  "version": "0.3.0",
   "description": "Unofficial OpenCode adapter for Plannotator TUI: annotate replies and documents without leaving your terminal.",
   "license": "MIT",
   "type": "module",
@@ -13,16 +13,42 @@
     "check": "node --check review.mjs && npm test && npm pack --dry-run",
     "prepublishOnly": "npm run check"
   },
-  "files": ["tui.ts", "review.mjs", "README.md", "LICENSE", "CHANGELOG.md"],
-  "engines": { "node": ">=22" },
-  "peerDependencies": { "@opencode/plugin": ">=2.0.22 <3" },
-  "peerDependenciesMeta": { "@opencode/plugin": { "optional": true } },
+  "files": [
+    "tui.ts",
+    "review.mjs",
+    "README.md",
+    "LICENSE",
+    "CHANGELOG.md"
+  ],
+  "engines": {
+    "node": ">=22"
+  },
+  "peerDependencies": {
+    "@opencode/plugin": ">=2.0.22 <3"
+  },
+  "peerDependenciesMeta": {
+    "@opencode/plugin": {
+      "optional": true
+    }
+  },
   "repository": {
     "type": "git",
     "url": "git+https://github.com/nxxxsooo/opencode-plannotator-tui.git"
   },
   "homepage": "https://github.com/nxxxsooo/opencode-plannotator-tui#readme",
-  "bugs": { "url": "https://github.com/nxxxsooo/opencode-plannotator-tui/issues" },
-  "keywords": ["opencode", "opencode-plugin", "plannotator", "tui", "annotation", "markdown", "review"],
-  "publishConfig": { "access": "public" }
+  "bugs": {
+    "url": "https://github.com/nxxxsooo/opencode-plannotator-tui/issues"
+  },
+  "keywords": [
+    "opencode",
+    "opencode-plugin",
+    "plannotator",
+    "tui",
+    "annotation",
+    "markdown",
+    "review"
+  ],
+  "publishConfig": {
+    "access": "public"
+  }
 }

package/review.mjs

@@ -48,6 +48,11 @@ async function documentSource(input, client, sessionID, signal) {
 }
 
 export function selectReply(messages) {
+  return eligibleReplies(messages)[0]
+}
+
+function eligibleReplies(messages) {
+  const replies = []
   const newest = [...messages].sort((a, b) =>
     b.time.created - a.time.created || b.id.localeCompare(a.id),
   )
@@ -55,12 +60,14 @@ export function selectReply(messages) {
     if (message.type !== "assistant" || message.time.completed === undefined || message.error) continue
     if (["tool-calls", "error", "content-filter"].includes(message.finish)) continue
     const text = message.content.filter(part => part.type === "text").map(part => part.text).join("\n\n")
-    if (text.trim()) return { id: message.id, text }
+    if (text.trim()) replies.push({ id: message.id, text })
   }
+  return replies
 }
 
-async function latestReply(client, sessionID, signal) {
+async function latestReply(client, sessionID, signal, position = 1) {
   const seen = new Set()
+  const messages = new Set()
   let cursor
   do {
     signal.throwIfAborted()
@@ -68,8 +75,11 @@ async function latestReply(client, sessionID, signal) {
       sessionID, type: "assistant", limit: 50,
       ...(cursor ? { cursor } : { order: "desc" }),
     }, { signal })
-    const reply = selectReply(page.data)
-    if (reply) return reply
+    for (const reply of eligibleReplies(page.data)) {
+      if (messages.has(reply.id)) continue
+      messages.add(reply.id)
+      if (--position === 0) return reply
+    }
     cursor = page.cursor?.next
     if (cursor && seen.has(cursor)) throw new Error("Session history returned a repeated page cursor.")
     seen.add(cursor)
@@ -125,11 +135,18 @@ export function createReviewCommand(context, options = {}) {
       // The UI cache contains only a recent page; a long tool run can push the last
       // completed reply out of it. Read the session-scoped history, newest first.
       const target = input.trim()
-      const source = target
+      const numeric = target !== "" && /^[+-]?(?:\d+(?:\.\d*)?|\.\d+)(?:e[+-]?\d+)?$/i.test(target)
+      const position = numeric ? Number(target) : 1
+      if (numeric && (!/^\d+$/.test(target) || !Number.isSafeInteger(position) || position < 1)) {
+        throw new Error("Choose a positive integer reply number (1 = latest, 2 = previous).")
+      }
+      const source = target && !numeric
         ? await documentSource(target, context.client, sessionID, controller.signal)
-        : await latestReply(context.client, sessionID, controller.signal)
+        : await latestReply(context.client, sessionID, controller.signal, position)
       if (controller.signal.aborted) return
-      if (!source) return notice("This session has no completed assistant reply yet.")
+      if (!source) return notice(position === 1
+        ? "This session has no completed assistant reply yet."
+        : `Can't find reply ${position}: this session has fewer completed assistant text replies.`)
 
       directory = await mkdtemp(path.join(options.tempRoot ?? os.tmpdir(), "opencode-annotate-"))
       keepDraft = true

package/tui.ts

@@ -14,11 +14,21 @@ export default Plugin.define({
           commands: [{
             id: "opencode-plannotator-tui.annotate",
             title: "Annotate reply or document (TUI)",
-            description: "Annotate the last reply or a file; press q, then confirm to send",
+            description: "Annotate a reply (1 = latest, 2 = previous) or a file; press q, then confirm to send",
             group: "Plannotator",
             palette: true,
-            slash: { name: "annotate", aliases: ["annotate-last"], arguments: true },
+            slash: { name: "annotate", arguments: true },
             run: review.run,
+          }, {
+            id: "opencode-plannotator-tui.annotate-last",
+            title: "Annotate last reply (TUI)",
+            description: "Annotate the latest completed reply; press q, then confirm to send",
+            group: "Plannotator",
+            palette: true,
+            // Keep slash submission with a trailing space local to the command.
+            // Any supplied argument is deliberately ignored: this always means latest.
+            slash: { name: "annotate-last", arguments: true },
+            run: () => review.run(),
           }],
         }))
         return null