pi-anchor 0.2.0 → 0.2.1

package/README.md

@@ -21,7 +21,7 @@
   </a>
   <img src="https://img.shields.io/badge/Node-v20+-22c55e.svg" alt="Node v20+">
   <img src="https://img.shields.io/badge/TypeScript-Strict-3b82f6.svg" alt="TypeScript Strict">
-  <img src="https://img.shields.io/badge/Tests-24%20Passed-22c55e.svg" alt="Tests: 24 Passed">
+  <img src="https://img.shields.io/badge/Tests-26%20Passed-22c55e.svg" alt="Tests: 26 Passed">
   <img src="https://img.shields.io/badge/Startup-%3C%2090ms-success.svg" alt="Startup: < 90ms">
   <img src="https://img.shields.io/badge/Storage-Zero%20Repo%20Pollution-success.svg" alt="Zero Repo Pollution">
   <img src="https://img.shields.io/badge/License-MIT-f97316.svg" alt="License: MIT">
@@ -234,40 +234,58 @@ Engineered with strict TypeScript and 100% standard library test coverage using
 ```bash
 npm run build      # Dual ESM/CJS compilation via tsup + declaration emit
 npm run typecheck  # Strict tsc --noEmit check (0 errors)
-npm test           # Native Node test runner (24/24 passing)
+npm test           # Native Node test runner (26/26 passing)
 ```
 
 ```text
-✔ Lock - acquireSyncLock acquires, holds, and releases exclusive lockfile (32ms)
-✔ Lock - acquireSyncLock safely reclaims stale lock from dead PID (18ms)
-✔ Context - makeSafeTaskAnnotation produces language-accurate comments and skips JSON (3.1ms)
-✔ Protocol - AnchorProtocol lifecycle handles cold-start and safe JIT (21ms)
-✔ ContextInjector - renders only active anchors, sleeping consume 0 tokens (59ms)
-✔ ContextInjector - renders targetDate and task aging in prompt (10ms)
-✔ AnchorDecay - status evaluation transitions (1.2ms)
-✔ AnchorDecay - sweepStore transitions and graveyard eviction (102ms)
-✔ AnchorMatcher - exact, prefix, and tag matching (2.5ms)
-✔ AnchorMatcher - glob pattern matching (*.ts, src/**/*.ts) (0.7ms)
-✔ AnchorMatcher - findMatchedAnchors prioritizes high-confidence & high-priority (0.4ms)
-✔ SessionTouchObserver - records read, edit, write and commits (25ms)
-✔ SessionTouchObserver - matches CJK commit messages with segmentation (2.0ms)
-✔ SessionTouchObserver - separates read inspection from edit mutation (12ms)
-✔ AnchorStore - basic CRUD & atomic writes (77ms)
-✔ AnchorStore - corrupt state recovery (9.1ms)
-✔ AnchorStore - daily recurring task completes for today and wakes tomorrow (19ms)
-✔ AnchorStore - temporal durability keywords and project detection (10ms)
-✔ AnchorStore - atomicRenameWithRetry successfully replaces files atomically (22ms)
-✔ AnchorTUI - status bar reflects active state cleanly with ⌖ N (23ms)
-✔ AnchorTUI - formatTargetDate and formatCreationTime render clear dual-timeline (38ms)
-✔ AnchorTUI - openAnchorDashboard renders Plan 2 Neovim/Geek layout with folder metadata (26ms)
-✔ AnchorTUI - getDisplayWidth and padToWidth properly align CJK full-width columns (0.3ms)
-✔ AnchorTUI - updateStartupBanner renders clean widget above editor (8.7ms)
-
-ℹ pass 24, fail 0 (416ms total runtime)
+✔ ContextInjector - renders only active anchors, sleeping consume 0 tokens
+✔ ContextInjector - renders targetDate and task aging in prompt
+✔ ContextInjector - renders preflight failure hints into cold-start context
+✔ AnchorDecay - status evaluation transitions
+✔ AnchorDecay - sweepStore transitions and graveyard eviction
+✔ AnchorMatcher - exact, prefix, and tag matching
+✔ AnchorMatcher - glob pattern matching (*.ts, src/**/*.ts)
+✔ AnchorMatcher - findMatchedAnchors prioritizes high-confidence & high-priority
+✔ SessionTouchObserver - records read, edit, write and commits
+✔ SessionTouchObserver - matches CJK commit messages with segmentation
+✔ SessionTouchObserver - separates read inspection from edit mutation
+✔ Lock - acquireSyncLock acquires, holds, and releases exclusive lockfile
+✔ Lock - acquireSyncLock safely reclaims stale lock from dead PID
+✔ Context - makeSafeTaskAnnotation produces language-accurate comments and skips JSON
+✔ Protocol - AnchorProtocol lifecycle handles cold-start and safe JIT
+✔ AnchorStore - basic CRUD & atomic writes
+✔ AnchorStore - corrupt state recovery
+✔ AnchorStore - daily recurring task completes for today and wakes tomorrow
+✔ AnchorStore - temporal durability keywords and project detection
+✔ AnchorStore - atomicRenameWithRetry successfully replaces files atomically
+✔ AnchorTUI - status bar reflects active state cleanly with ⌖ N
+✔ AnchorTUI - formatTargetDate and formatCreationTime render clear dual-timeline
+✔ AnchorTUI - openAnchorDashboard renders Plan 2 Neovim/Geek layout with folder metadata
+✔ AnchorTUI - getDisplayWidth and padToWidth properly align CJK full-width columns
+✔ AnchorTUI - updateStartupBanner renders clean widget above editor
+✔ AnchorTUI - truncateToWidth properly handles ANSI escape sequences and bounds width
+
+ℹ pass 26, fail 0
 ```
 
 ---
 
+## Author's Note
+
+The motivation behind Anchor came from a recurring headache during pair-programming with AI coding agents: watching `TODO.md` and `AGENTS.md` rot inside my git trees.
+
+Every time a task remained unfinished across sessions, writing it to a project markdown file felt harmless at first. But over weeks of work, two frictions became unbearable:
+1. In multi-turn sessions, the AI dragged dozens of stagnant task lines into the prompt on every single turn, burning hundreds of tokens while diluting the model's focus on the actual code being edited.
+2. Merge conflicts on task checklists in Git commits polluted the repository's history with irrelevant bookkeeping noise.
+
+When I looked at existing solutions, the trade-offs felt disproportionate. Stuffing a 200MB Dolt SQL relational database into the repository root (`beads`), or running a background Go daemon with SQLite and continuous vector retrieval (`engram`), inverted the relationship between tool and developer. A developer task tracker should not demand more system resources than the application being built.
+
+Anchor takes the opposite approach: store state outside the project tree in a lean global ledger (`~/.anchor/state.json`), inject tasks only on Turn 1 of a cold start, keep Turn 2+ at exactly 0 tokens, and auto-settle upon git commits or session exit.
+
+I hope Anchor helps keep your project trees clean and your focus where it belongs: on the code.
+
+---
+
 ## License
 
 MIT License © 2025 [Jason Song (@3ZEROS12)](https://github.com/3ZEROS12)

package/README_zh.md

@@ -2,7 +2,7 @@
 
 <p align="center">
   <strong>面向 AI 编程智能体的零污染、零闲置 Token 跨会话任务记忆。</strong><br>
-  <em>告别发霉的 TODO.md。零 Git 历史污染，0 闲置 Token 损耗，写完代码自动闭环核销。</em>
+  <em>告别发霉的 TODO.md。零 Git 历史污染，0 闲置 Token 损耗，代码提交自动核销结算。</em>
 </p>
 
 <p align="center">
@@ -21,7 +21,7 @@
   </a>
   <img src="https://img.shields.io/badge/Node-v20+-22c55e.svg" alt="Node v20+">
   <img src="https://img.shields.io/badge/TypeScript-Strict-3b82f6.svg" alt="TypeScript Strict">
-  <img src="https://img.shields.io/badge/Tests-24%20通过-22c55e.svg" alt="Tests: 24 Passed">
+  <img src="https://img.shields.io/badge/Tests-26%20通过-22c55e.svg" alt="Tests: 26 Passed">
   <img src="https://img.shields.io/badge/启动耗时-%3C%2090ms-success.svg" alt="启动耗时: < 90ms">
   <img src="https://img.shields.io/badge/存储-零仓库污染-success.svg" alt="零仓库污染">
   <img src="https://img.shields.io/badge/开源协议-MIT-f97316.svg" alt="License: MIT">
@@ -38,7 +38,7 @@
 使用终端编程智能体（Claude Code、Pi、Aider 等）进行实际项目开发时，开发者普遍面临三个摩擦：
 
 1. **终端退出即失忆**：按下 `Ctrl+C` 退出终端，Agent 内存中的上下文被全部清空。未完成的代码重构计划、临时交代的排期与多步约定瞬间丢失。
-2. **TODO.md 污染与 Token 泥潭**：直接在工程根目录写 `TODO.md` 或 `AGENTS.md`，不仅会产生大量 Git 杂质提交，而且**每一轮对话都要把几十行陈旧清单塞入 System Prompt**，白白消耗大量 Token 预算，并分散模型对当前核心代码的注意力。
+2. **TODO.md 污染与 Token 泥潭**：直接在工程根目录写 `TODO.md` 或 `AGENTS.md`，会产生大量 Git 杂质提交，且**每一轮对话都要把几十行陈旧清单塞入 System Prompt**，白白消耗大量 Token 预算，并分散模型对当前核心代码的注意力。
 3. **静态清单无限腐烂**：写完代码后，工程师极少会专程打开 Markdown 逐个打勾。未勾选的旧任务烂在仓库里，越积越多。
 
 现有的解决方案大多走向了两个重型极端：
@@ -122,7 +122,7 @@ Anchor 从两个正交的时间维度管理任务，兼顾“何时要交”与
 * **`[Habits]`（每日循环）**：日常例行循环任务。当天打勾后隐身，明日零点自动复苏。
 * **`[Backlog]`（长期备忘）**：无指定日期的宏观架构愿景（`Someday`）。
 
-### 5. 零心智负担的自动核销闭环
+### 5. 零心智负担的自动核销与生命周期结算
 * **Git Commit 自动语义匹配**：内置基于标准 `Intl.Segmenter` 的多语系分词引擎。代码提交信息（如 `git commit -m "fix(auth): migrate to HttpOnly cookies"`）命中任务描述时自动核销结案。
 * **退出终端一键确认**：检测到本会话修改了任务关联的文件时，退出终端前弹出极简单键确认：
   ```text
@@ -170,7 +170,7 @@ Anchor 从两个正交的时间维度管理任务，兼顾“何时要交”与
 | **Token 损耗** | 每轮中/高消耗 | 高（注入长文历史） | 极高（陈旧文本成倍累积） | **0 Token 闲置（仅文件触碰 JIT 唤醒）** |
 | **JIT 语法安全** | 不支持文件注释 | 无语法感知 | 静态文本无防护 | **精确匹配 30+ 语言注释，跳过 JSON** |
 | **任务时效** | 单层平铺 | 单层平铺 | 静态复选框 | **双时间维度（交付排期 + 立项时间）** |
-| **核销闭环** | 手动命令 `close` | 无闭环机制 | 人工修改文本打勾 | **Git Commit 自动识别 + 退出前一键核销** |
+| **任务结算与核销** | 手动命令 `close` | 无自动结算机制 | 人工修改文本打勾 | **Git Commit 自动识别 + 退出前一键核销** |
 | **衰减清理** | 手动 prune | 无衰退机制 | 长期堆积发霉 | **静默衰退（临时任务 48h 自动清理）** |
 | **启动耗时** | 重型 CLI 初始化 | Go 守护进程常驻 | 无 | **< 90ms 预打包瞬时秒开** |
 | **环境依赖** | 外部 Dolt 二进制 | 外部 Go 编译产物 | 无 | **零原生外部依赖（纯 TypeScript）** |
@@ -233,40 +233,62 @@ pi install npm:pi-anchor
 ```bash
 npm run build      # tsup 双格式打包 (ESM/CJS) 与 .d.ts 类型生成
 npm run typecheck  # TypeScript 严格类型检查 (0 错误)
-npm test           # 全套自动化单元测试 (24/24 全绿通过)
+npm test           # 全套自动化单元测试 (26/26 全绿通过)
 ```
 
 ```text
-✔ Lock - acquireSyncLock acquires, holds, and releases exclusive lockfile (32ms)
-✔ Lock - acquireSyncLock safely reclaims stale lock from dead PID (18ms)
-✔ Context - makeSafeTaskAnnotation produces language-accurate comments and skips JSON (3.1ms)
-✔ Protocol - AnchorProtocol lifecycle handles cold-start and safe JIT (21ms)
-✔ ContextInjector - renders only active anchors, sleeping consume 0 tokens (59ms)
-✔ ContextInjector - renders targetDate and task aging in prompt (10ms)
-✔ AnchorDecay - status evaluation transitions (1.2ms)
-✔ AnchorDecay - sweepStore transitions and graveyard eviction (102ms)
-✔ AnchorMatcher - exact, prefix, and tag matching (2.5ms)
-✔ AnchorMatcher - glob pattern matching (*.ts, src/**/*.ts) (0.7ms)
-✔ AnchorMatcher - findMatchedAnchors prioritizes high-confidence & high-priority (0.4ms)
-✔ SessionTouchObserver - records read, edit, write and commits (25ms)
-✔ SessionTouchObserver - matches CJK commit messages with segmentation (2.0ms)
-✔ SessionTouchObserver - separates read inspection from edit mutation (12ms)
-✔ AnchorStore - basic CRUD & atomic writes (77ms)
-✔ AnchorStore - corrupt state recovery (9.1ms)
-✔ AnchorStore - daily recurring task completes for today and wakes tomorrow (19ms)
-✔ AnchorStore - temporal durability keywords and project detection (10ms)
-✔ AnchorStore - atomicRenameWithRetry successfully replaces files atomically (22ms)
-✔ AnchorTUI - status bar reflects active state cleanly with ⌖ N (23ms)
-✔ AnchorTUI - formatTargetDate and formatCreationTime render clear dual-timeline (38ms)
-✔ AnchorTUI - openAnchorDashboard renders Plan 2 Neovim/Geek layout with folder metadata (26ms)
-✔ AnchorTUI - getDisplayWidth and padToWidth properly align CJK full-width columns (0.3ms)
-✔ AnchorTUI - updateStartupBanner renders clean widget above editor (8.7ms)
-
-ℹ pass 24, fail 0 (416ms total runtime)
+✔ ContextInjector - renders only active anchors, sleeping consume 0 tokens
+✔ ContextInjector - renders targetDate and task aging in prompt
+✔ ContextInjector - renders preflight failure hints into cold-start context
+✔ AnchorDecay - status evaluation transitions
+✔ AnchorDecay - sweepStore transitions and graveyard eviction
+✔ AnchorMatcher - exact, prefix, and tag matching
+✔ AnchorMatcher - glob pattern matching (*.ts, src/**/*.ts)
+✔ AnchorMatcher - findMatchedAnchors prioritizes high-confidence & high-priority
+✔ SessionTouchObserver - records read, edit, write and commits
+✔ SessionTouchObserver - matches CJK commit messages with segmentation
+✔ SessionTouchObserver - separates read inspection from edit mutation
+✔ Lock - acquireSyncLock acquires, holds, and releases exclusive lockfile
+✔ Lock - acquireSyncLock safely reclaims stale lock from dead PID
+✔ Context - makeSafeTaskAnnotation produces language-accurate comments and skips JSON
+✔ Protocol - AnchorProtocol lifecycle handles cold-start and safe JIT
+✔ AnchorStore - basic CRUD & atomic writes
+✔ AnchorStore - corrupt state recovery
+✔ AnchorStore - daily recurring task completes for today and wakes tomorrow
+✔ AnchorStore - temporal durability keywords and project detection
+✔ AnchorStore - atomicRenameWithRetry successfully replaces files atomically
+✔ AnchorTUI - status bar reflects active state cleanly with ⌖ N
+✔ AnchorTUI - formatTargetDate and formatCreationTime render clear dual-timeline
+✔ AnchorTUI - openAnchorDashboard renders Plan 2 Neovim/Geek layout with folder metadata
+✔ AnchorTUI - getDisplayWidth and padToWidth properly align CJK full-width columns
+✔ AnchorTUI - updateStartupBanner renders clean widget above editor
+✔ AnchorTUI - truncateToWidth properly handles ANSI escape sequences and bounds width
+
+ℹ pass 26, fail 0
 ```
 
 ---
 
+## 作者手记 (Author's Note)
+
+写 Anchor 的最初冲动，来自于我用终端 AI 编程智能体结对开发时经历的一场持续阵痛：看着项目根目录下的 `TODO.md` 与 `AGENTS.md` 在 Git 历史里发霉。
+
+很多时候，写完一段代码已经是深夜，跨会话未完成的任务随手记在项目的 Markdown 里，看起来省事。然而几个月下来，两点物理摩擦让我极其痛苦：
+1. 每一轮对话交互，AI 都要把陈旧的任务清单整段塞进系统提示词，白白烧掉几十上百行 Token，还会分散模型对当前正在修改的代码的注意力；
+2. 团队多人协作或分支合并时，这类任务清单文件频发 Git 合并冲突，无端污染了核心代码的提交历史。
+
+调研现存工具时，我发现社区给出的方案走向了沉重的极端：为了管理几个简单的任务，有的方案直接在代码仓库根目录塞入一个超过 200MB 的 Dolt SQL 关系型数据库（`beads`），有的方案在后台常驻一个用 Go 编写的 SQLite 守护进程并做持续向量检索（`engram`）。一个任务追踪工具消耗的系统资源与认知负担，甚至超过了开发者正在编写的业务代码本身。
+
+这颠倒了工具与生产者的关系。
+
+Anchor 选择了一条极度克制的工程路径：把状态移出代码仓库，托管在用户主目录下的单文件轻量状态表（`~/.anchor/state.json`）；首轮对话注入冷启动上下文，第 2 轮起保持 0 Token 损耗；通过语言对应的语法安全注释在触碰代码时精准唤醒，并在代码提交或会话退出时自动核销。
+
+在这次更新中，我们还为 `/anchor` 增加了防误触详情面板，按回车可以从容查看关联文件与执行命令，彻底消灭误敲回车直接结算的焦虑。
+
+希望 Anchor 能让你的代码仓库保持干净，把专注力还给代码本身。
+
+---
+
 ## 开源协议
 
 MIT License © 2025 [Jason Song (@3ZEROS12)](https://github.com/3ZEROS12)

package/dist/{chunk-T62PHIQI.js → chunk-B652T7QR.js}

@@ -1066,8 +1066,9 @@ function groupAnchorsByQuadrant(anchors, now = Date.now()) {
   }
   return groups;
 }
+var ANSI_REGEX = /\x1b\[[0-9;]*[a-zA-Z]|\x1b\][^\x07\x1b]*(?:\x07|\x1b\\)/g;
 function stripAnsi(str) {
-  return str.replace(/\x1b\[[0-9;]*[a-zA-Z]/g, "");
+  return str.replace(ANSI_REGEX, "");
 }
 function getDisplayWidth(str) {
   const clean = stripAnsi(str);
@@ -1086,22 +1087,36 @@ function getDisplayWidth(str) {
   return width;
 }
 function truncateToWidth(str, maxWidth, ellipsis = "\u2026") {
-  const current = getDisplayWidth(str);
-  if (current <= maxWidth) return str;
+  if (maxWidth <= 0) return "";
+  const totalWidth = getDisplayWidth(str);
+  if (totalWidth <= maxWidth) return str;
   const ellipsisWidth = getDisplayWidth(ellipsis);
-  const target = maxWidth - ellipsisWidth;
-  if (target <= 0) return ellipsis.slice(0, maxWidth);
+  const target = Math.max(0, maxWidth - ellipsisWidth);
+  if (target === 0) return ellipsis.slice(0, maxWidth);
   let accumulated = "";
   let accumWidth = 0;
-  for (const char of str) {
-    const charWidth = getDisplayWidth(char);
+  let i = 0;
+  while (i < str.length) {
+    ANSI_REGEX.lastIndex = i;
+    const match = ANSI_REGEX.exec(str);
+    if (match && match.index === i) {
+      accumulated += match[0];
+      i += match[0].length;
+      continue;
+    }
+    const codePoint = str.codePointAt(i) || 0;
+    const charLen = codePoint > 65535 ? 2 : 1;
+    const fullChar = str.slice(i, i + charLen);
+    const charWidth = getDisplayWidth(fullChar);
     if (accumWidth + charWidth > target) {
       break;
     }
-    accumulated += char;
+    accumulated += fullChar;
     accumWidth += charWidth;
+    i += charLen;
   }
-  return accumulated + ellipsis;
+  accumulated = accumulated.replace(/\s*[\(\[\{（【]$/, "");
+  return accumulated + ellipsis + (str.includes("\x1B") ? "\x1B[0m" : "");
 }
 function padToWidth(str, targetWidth) {
   const truncated = truncateToWidth(str, targetWidth);
@@ -1254,14 +1269,35 @@ async function openAnchorDashboard(ctx, store) {
     optionMap.set(label, a);
     displayOptions.push(label);
   }
-  const selected = await ctx.ui.select("\u2316 Anchors (enter to complete):", displayOptions);
+  const selected = await ctx.ui.select("\u2316 Anchors (select to inspect or settle):", displayOptions);
   if (!selected) return;
   const anchor = optionMap.get(selected);
   if (!anchor) return;
-  store.settle(anchor.id, { settledBy: "manual-command" });
-  const successMsg = anchor.recurrence === "daily" ? `\u2316 Completed for today: "${anchor.title}" (resets tomorrow)` : `\u2316 Settled: "${anchor.title}"`;
-  ctx.ui.notify(successMsg, "info");
-  updateAnchorStatusBar(ctx, store);
+  const action = await ctx.ui.select(
+    `\u2316 Anchor #${anchor.id}: "${anchor.title}"`,
+    [
+      "\u2713 Settle (Mark completed and archive)",
+      "\u2139 View details & associated files",
+      "\u21A9 Cancel"
+    ]
+  );
+  if (!action || action.startsWith("\u21A9")) return;
+  if (action.startsWith("\u2713")) {
+    store.settle(anchor.id, { settledBy: "manual-command" });
+    const successMsg = anchor.recurrence === "daily" ? `\u2316 Completed for today: "${anchor.title}" (resets tomorrow)` : `\u2316 Settled #${anchor.id}: "${anchor.title}" (/anchor undo to revert)`;
+    ctx.ui.notify(successMsg, "info");
+    updateAnchorStatusBar(ctx, store);
+  } else if (action.startsWith("\u2139")) {
+    const details = [
+      `#${anchor.id} [${anchor.priority.toUpperCase()}] ${anchor.title}`,
+      anchor.description ? `Description: ${anchor.description}` : null,
+      anchor.targetDate ? `Target Date: ${anchor.targetDate} (${formatTargetDate(anchor)})` : null,
+      anchor.files && anchor.files.length > 0 ? `Files: ${anchor.files.join(", ")}` : null,
+      anchor.verifyCommand ? `Verify Command: ${anchor.verifyCommand}` : null,
+      `Created: ${formatCreationTime(anchor.createdAt)} (in ${anchor.project || "global"})`
+    ].filter(Boolean).join("\n");
+    ctx.ui.notify(details, "info");
+  }
 }
 
 export {

package/dist/extension.cjs

@@ -1086,8 +1086,9 @@ function groupAnchorsByQuadrant(anchors, now = Date.now()) {
   }
   return groups;
 }
+var ANSI_REGEX = /\x1b\[[0-9;]*[a-zA-Z]|\x1b\][^\x07\x1b]*(?:\x07|\x1b\\)/g;
 function stripAnsi(str) {
-  return str.replace(/\x1b\[[0-9;]*[a-zA-Z]/g, "");
+  return str.replace(ANSI_REGEX, "");
 }
 function getDisplayWidth(str) {
   const clean = stripAnsi(str);
@@ -1106,22 +1107,36 @@ function getDisplayWidth(str) {
   return width;
 }
 function truncateToWidth(str, maxWidth, ellipsis = "\u2026") {
-  const current = getDisplayWidth(str);
-  if (current <= maxWidth) return str;
+  if (maxWidth <= 0) return "";
+  const totalWidth = getDisplayWidth(str);
+  if (totalWidth <= maxWidth) return str;
   const ellipsisWidth = getDisplayWidth(ellipsis);
-  const target = maxWidth - ellipsisWidth;
-  if (target <= 0) return ellipsis.slice(0, maxWidth);
+  const target = Math.max(0, maxWidth - ellipsisWidth);
+  if (target === 0) return ellipsis.slice(0, maxWidth);
   let accumulated = "";
   let accumWidth = 0;
-  for (const char of str) {
-    const charWidth = getDisplayWidth(char);
+  let i = 0;
+  while (i < str.length) {
+    ANSI_REGEX.lastIndex = i;
+    const match = ANSI_REGEX.exec(str);
+    if (match && match.index === i) {
+      accumulated += match[0];
+      i += match[0].length;
+      continue;
+    }
+    const codePoint = str.codePointAt(i) || 0;
+    const charLen = codePoint > 65535 ? 2 : 1;
+    const fullChar = str.slice(i, i + charLen);
+    const charWidth = getDisplayWidth(fullChar);
     if (accumWidth + charWidth > target) {
       break;
     }
-    accumulated += char;
+    accumulated += fullChar;
     accumWidth += charWidth;
+    i += charLen;
   }
-  return accumulated + ellipsis;
+  accumulated = accumulated.replace(/\s*[\(\[\{（【]$/, "");
+  return accumulated + ellipsis + (str.includes("\x1B") ? "\x1B[0m" : "");
 }
 function padToWidth(str, targetWidth) {
   const truncated = truncateToWidth(str, targetWidth);
@@ -1268,14 +1283,35 @@ async function openAnchorDashboard(ctx, store) {
     optionMap.set(label, a);
     displayOptions.push(label);
   }
-  const selected = await ctx.ui.select("\u2316 Anchors (enter to complete):", displayOptions);
+  const selected = await ctx.ui.select("\u2316 Anchors (select to inspect or settle):", displayOptions);
   if (!selected) return;
   const anchor = optionMap.get(selected);
   if (!anchor) return;
-  store.settle(anchor.id, { settledBy: "manual-command" });
-  const successMsg = anchor.recurrence === "daily" ? `\u2316 Completed for today: "${anchor.title}" (resets tomorrow)` : `\u2316 Settled: "${anchor.title}"`;
-  ctx.ui.notify(successMsg, "info");
-  updateAnchorStatusBar(ctx, store);
+  const action = await ctx.ui.select(
+    `\u2316 Anchor #${anchor.id}: "${anchor.title}"`,
+    [
+      "\u2713 Settle (Mark completed and archive)",
+      "\u2139 View details & associated files",
+      "\u21A9 Cancel"
+    ]
+  );
+  if (!action || action.startsWith("\u21A9")) return;
+  if (action.startsWith("\u2713")) {
+    store.settle(anchor.id, { settledBy: "manual-command" });
+    const successMsg = anchor.recurrence === "daily" ? `\u2316 Completed for today: "${anchor.title}" (resets tomorrow)` : `\u2316 Settled #${anchor.id}: "${anchor.title}" (/anchor undo to revert)`;
+    ctx.ui.notify(successMsg, "info");
+    updateAnchorStatusBar(ctx, store);
+  } else if (action.startsWith("\u2139")) {
+    const details = [
+      `#${anchor.id} [${anchor.priority.toUpperCase()}] ${anchor.title}`,
+      anchor.description ? `Description: ${anchor.description}` : null,
+      anchor.targetDate ? `Target Date: ${anchor.targetDate} (${formatTargetDate(anchor)})` : null,
+      anchor.files && anchor.files.length > 0 ? `Files: ${anchor.files.join(", ")}` : null,
+      anchor.verifyCommand ? `Verify Command: ${anchor.verifyCommand}` : null,
+      `Created: ${formatCreationTime(anchor.createdAt)} (in ${anchor.project || "global"})`
+    ].filter(Boolean).join("\n");
+    ctx.ui.notify(details, "info");
+  }
 }
 
 // src/extension.ts
@@ -1488,7 +1524,7 @@ Mark as completed and archive?`
         if (args.priority) title += ` ${theme.fg("muted", `[${args.priority}]`)}`;
       }
       return {
-        render: () => [title],
+        render: (width) => [truncateToWidth(title, width)],
         invalidate: () => {
         }
       };
@@ -1497,14 +1533,14 @@ Mark as completed and archive?`
       if (result.isError) {
         const errText = result.content?.[0]?.text || "Execution failed";
         return {
-          render: () => [theme.fg("error", `\u2717 ${errText}`)],
+          render: (width) => [truncateToWidth(theme.fg("error", `\u2717 ${errText}`), width)],
           invalidate: () => {
           }
         };
       }
       const text = result.content?.[0]?.text || "OK";
       return {
-        render: () => [theme.fg("success", `\u2714 ${text}`)],
+        render: (width) => [truncateToWidth(theme.fg("success", `\u2714 ${text}`), width)],
         invalidate: () => {
         }
       };

package/dist/extension.js

@@ -9,9 +9,10 @@ import {
   renderColdStartAnchorsContext,
   runPhysicalVerification,
   sweepStore,
+  truncateToWidth,
   updateAnchorStatusBar,
   updateStartupBanner
-} from "./chunk-T62PHIQI.js";
+} from "./chunk-B652T7QR.js";
 
 // src/extension.ts
 import { Type } from "@sinclair/typebox";
@@ -224,7 +225,7 @@ Mark as completed and archive?`
         if (args.priority) title += ` ${theme.fg("muted", `[${args.priority}]`)}`;
       }
       return {
-        render: () => [title],
+        render: (width) => [truncateToWidth(title, width)],
         invalidate: () => {
         }
       };
@@ -233,14 +234,14 @@ Mark as completed and archive?`
       if (result.isError) {
         const errText = result.content?.[0]?.text || "Execution failed";
         return {
-          render: () => [theme.fg("error", `\u2717 ${errText}`)],
+          render: (width) => [truncateToWidth(theme.fg("error", `\u2717 ${errText}`), width)],
           invalidate: () => {
           }
         };
       }
       const text = result.content?.[0]?.text || "OK";
       return {
-        render: () => [theme.fg("success", `\u2714 ${text}`)],
+        render: (width) => [truncateToWidth(theme.fg("success", `\u2714 ${text}`), width)],
         invalidate: () => {
         }
       };

package/dist/index.cjs

@@ -910,8 +910,9 @@ function groupAnchorsByQuadrant(anchors, now = Date.now()) {
   }
   return groups;
 }
+var ANSI_REGEX = /\x1b\[[0-9;]*[a-zA-Z]|\x1b\][^\x07\x1b]*(?:\x07|\x1b\\)/g;
 function stripAnsi(str) {
-  return str.replace(/\x1b\[[0-9;]*[a-zA-Z]/g, "");
+  return str.replace(ANSI_REGEX, "");
 }
 function getDisplayWidth(str) {
   const clean = stripAnsi(str);
@@ -930,22 +931,36 @@ function getDisplayWidth(str) {
   return width;
 }
 function truncateToWidth(str, maxWidth, ellipsis = "\u2026") {
-  const current = getDisplayWidth(str);
-  if (current <= maxWidth) return str;
+  if (maxWidth <= 0) return "";
+  const totalWidth = getDisplayWidth(str);
+  if (totalWidth <= maxWidth) return str;
   const ellipsisWidth = getDisplayWidth(ellipsis);
-  const target = maxWidth - ellipsisWidth;
-  if (target <= 0) return ellipsis.slice(0, maxWidth);
+  const target = Math.max(0, maxWidth - ellipsisWidth);
+  if (target === 0) return ellipsis.slice(0, maxWidth);
   let accumulated = "";
   let accumWidth = 0;
-  for (const char of str) {
-    const charWidth = getDisplayWidth(char);
+  let i = 0;
+  while (i < str.length) {
+    ANSI_REGEX.lastIndex = i;
+    const match = ANSI_REGEX.exec(str);
+    if (match && match.index === i) {
+      accumulated += match[0];
+      i += match[0].length;
+      continue;
+    }
+    const codePoint = str.codePointAt(i) || 0;
+    const charLen = codePoint > 65535 ? 2 : 1;
+    const fullChar = str.slice(i, i + charLen);
+    const charWidth = getDisplayWidth(fullChar);
     if (accumWidth + charWidth > target) {
       break;
     }
-    accumulated += char;
+    accumulated += fullChar;
     accumWidth += charWidth;
+    i += charLen;
   }
-  return accumulated + ellipsis;
+  accumulated = accumulated.replace(/\s*[\(\[\{（【]$/, "");
+  return accumulated + ellipsis + (str.includes("\x1B") ? "\x1B[0m" : "");
 }
 function padToWidth(str, targetWidth) {
   const truncated = truncateToWidth(str, targetWidth);
@@ -1098,14 +1113,35 @@ async function openAnchorDashboard(ctx, store) {
     optionMap.set(label, a);
     displayOptions.push(label);
   }
-  const selected = await ctx.ui.select("\u2316 Anchors (enter to complete):", displayOptions);
+  const selected = await ctx.ui.select("\u2316 Anchors (select to inspect or settle):", displayOptions);
   if (!selected) return;
   const anchor = optionMap.get(selected);
   if (!anchor) return;
-  store.settle(anchor.id, { settledBy: "manual-command" });
-  const successMsg = anchor.recurrence === "daily" ? `\u2316 Completed for today: "${anchor.title}" (resets tomorrow)` : `\u2316 Settled: "${anchor.title}"`;
-  ctx.ui.notify(successMsg, "info");
-  updateAnchorStatusBar(ctx, store);
+  const action = await ctx.ui.select(
+    `\u2316 Anchor #${anchor.id}: "${anchor.title}"`,
+    [
+      "\u2713 Settle (Mark completed and archive)",
+      "\u2139 View details & associated files",
+      "\u21A9 Cancel"
+    ]
+  );
+  if (!action || action.startsWith("\u21A9")) return;
+  if (action.startsWith("\u2713")) {
+    store.settle(anchor.id, { settledBy: "manual-command" });
+    const successMsg = anchor.recurrence === "daily" ? `\u2316 Completed for today: "${anchor.title}" (resets tomorrow)` : `\u2316 Settled #${anchor.id}: "${anchor.title}" (/anchor undo to revert)`;
+    ctx.ui.notify(successMsg, "info");
+    updateAnchorStatusBar(ctx, store);
+  } else if (action.startsWith("\u2139")) {
+    const details = [
+      `#${anchor.id} [${anchor.priority.toUpperCase()}] ${anchor.title}`,
+      anchor.description ? `Description: ${anchor.description}` : null,
+      anchor.targetDate ? `Target Date: ${anchor.targetDate} (${formatTargetDate(anchor)})` : null,
+      anchor.files && anchor.files.length > 0 ? `Files: ${anchor.files.join(", ")}` : null,
+      anchor.verifyCommand ? `Verify Command: ${anchor.verifyCommand}` : null,
+      `Created: ${formatCreationTime(anchor.createdAt)} (in ${anchor.project || "global"})`
+    ].filter(Boolean).join("\n");
+    ctx.ui.notify(details, "info");
+  }
 }
 
 // src/observer.ts

package/dist/index.js

@@ -39,7 +39,7 @@ import {
   truncateToWidth,
   updateAnchorStatusBar,
   updateStartupBanner
-} from "./chunk-T62PHIQI.js";
+} from "./chunk-B652T7QR.js";
 
 // src/protocol.ts
 var AnchorProtocol = class {

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "pi-anchor",
-  "version": "0.2.0",
+  "version": "0.2.1",
   "description": "Zero-pollution, 0-idle-token task memory for AI coding agents",
   "type": "module",
   "main": "dist/index.js",
@@ -52,13 +52,14 @@
   "publishConfig": {
     "access": "public"
   },
+  "peerDependencies": {
+    "@sinclair/typebox": "*"
+  },
   "devDependencies": {
+    "@sinclair/typebox": "^0.34.52",
     "@types/node": "^26.6.2",
     "tsup": "^8.5.1",
     "tsx": "^4.23.15",
     "typescript": "^5.8.2"
-  },
-  "dependencies": {
-    "@sinclair/typebox": "^0.34.52"
   }
 }

package/src/extension.ts

@@ -6,7 +6,7 @@ import { renderColdStartAnchorsContext, renderActiveAnchorsContext, makeSafeTask
 import { generateSettlementProposals, runPhysicalVerification } from './settlement.ts';
 import { normalizePath, findMatchedAnchors } from './matcher.ts';
 import { sweepStore } from './decay.ts';
-import { updateAnchorStatusBar, openAnchorDashboard, updateStartupBanner } from './tui.ts';
+import { updateAnchorStatusBar, openAnchorDashboard, updateStartupBanner, truncateToWidth } from './tui.ts';
 import { execSync } from 'node:child_process';
 import fs from 'node:fs';
 import path from 'node:path';
@@ -267,7 +267,7 @@ export default function (pi: ExtensionAPI) {
       }
 
       return {
-        render: () => [title],
+        render: (width: number) => [truncateToWidth(title, width)],
         invalidate: () => {}
       };
     },
@@ -275,14 +275,14 @@ export default function (pi: ExtensionAPI) {
       if (result.isError) {
         const errText = result.content?.[0]?.text || 'Execution failed';
         return {
-          render: () => [theme.fg('error', `✗ ${errText}`)],
+          render: (width: number) => [truncateToWidth(theme.fg('error', `✗ ${errText}`), width)],
           invalidate: () => {}
         };
       }
 
       const text = result.content?.[0]?.text || 'OK';
       return {
-        render: () => [theme.fg('success', `✔ ${text}`)],
+        render: (width: number) => [truncateToWidth(theme.fg('success', `✔ ${text}`), width)],
         invalidate: () => {}
       };
     },

package/src/tui.ts

@@ -57,11 +57,13 @@ export function groupAnchorsByQuadrant(anchors: Anchor[], now: number = Date.now
   return groups;
 }
 
+const ANSI_REGEX = /\x1b\[[0-9;]*[a-zA-Z]|\x1b\][^\x07\x1b]*(?:\x07|\x1b\\)/g;
+
 /**
  * Strip ANSI escape codes from string
  */
 export function stripAnsi(str: string): string {
-  return str.replace(/\x1b\[[0-9;]*[a-zA-Z]/g, '');
+  return str.replace(ANSI_REGEX, '');
 }
 
 /**
@@ -124,26 +126,44 @@ export function getDisplayWidth(str: string): number {
  * Truncate string to target terminal visual width with ellipsis
  */
 export function truncateToWidth(str: string, maxWidth: number, ellipsis = '…'): string {
-  const current = getDisplayWidth(str);
-  if (current <= maxWidth) return str;
+  if (maxWidth <= 0) return '';
+  const totalWidth = getDisplayWidth(str);
+  if (totalWidth <= maxWidth) return str;
 
   const ellipsisWidth = getDisplayWidth(ellipsis);
-  const target = maxWidth - ellipsisWidth;
-  if (target <= 0) return ellipsis.slice(0, maxWidth);
+  const target = Math.max(0, maxWidth - ellipsisWidth);
+  if (target === 0) return ellipsis.slice(0, maxWidth);
 
   let accumulated = '';
   let accumWidth = 0;
+  let i = 0;
+
+  while (i < str.length) {
+    ANSI_REGEX.lastIndex = i;
+    const match = ANSI_REGEX.exec(str);
+    if (match && match.index === i) {
+      accumulated += match[0];
+      i += match[0].length;
+      continue;
+    }
+
+    const codePoint = str.codePointAt(i) || 0;
+    const charLen = codePoint > 0xffff ? 2 : 1;
+    const fullChar = str.slice(i, i + charLen);
+    const charWidth = getDisplayWidth(fullChar);
 
-  for (const char of str) {
-    const charWidth = getDisplayWidth(char);
     if (accumWidth + charWidth > target) {
       break;
     }
-    accumulated += char;
+    accumulated += fullChar;
     accumWidth += charWidth;
+    i += charLen;
   }
 
-  return accumulated + ellipsis;
+  // Invariant 11: Guard against trailing open brackets right before ellipsis (e.g. "Fix auth (…" -> "Fix auth…")
+  accumulated = accumulated.replace(/\s*[\(\[\{（【]$/, '');
+
+  return accumulated + ellipsis + (str.includes('\x1b') ? '\x1b[0m' : '');
 }
 
 /**
@@ -384,16 +404,38 @@ export async function openAnchorDashboard(
     displayOptions.push(label);
   }
 
-  const selected = await ctx.ui.select('⌖ Anchors (enter to complete):', displayOptions);
+  const selected = await ctx.ui.select('⌖ Anchors (select to inspect or settle):', displayOptions);
   if (!selected) return;
 
   const anchor = optionMap.get(selected);
   if (!anchor) return;
 
-  store.settle(anchor.id, { settledBy: 'manual-command' });
-  const successMsg = anchor.recurrence === 'daily'
-    ? `⌖ Completed for today: "${anchor.title}" (resets tomorrow)`
-    : `⌖ Settled: "${anchor.title}"`;
-  ctx.ui.notify(successMsg, 'info');
-  updateAnchorStatusBar(ctx, store);
+  const action = await ctx.ui.select(
+    `⌖ Anchor #${anchor.id}: "${anchor.title}"`,
+    [
+      '✓ Settle (Mark completed and archive)',
+      'ℹ View details & associated files',
+      '↩ Cancel'
+    ]
+  );
+  if (!action || action.startsWith('↩')) return;
+
+  if (action.startsWith('✓')) {
+    store.settle(anchor.id, { settledBy: 'manual-command' });
+    const successMsg = anchor.recurrence === 'daily'
+      ? `⌖ Completed for today: "${anchor.title}" (resets tomorrow)`
+      : `⌖ Settled #${anchor.id}: "${anchor.title}" (/anchor undo to revert)`;
+    ctx.ui.notify(successMsg, 'info');
+    updateAnchorStatusBar(ctx, store);
+  } else if (action.startsWith('ℹ')) {
+    const details = [
+      `#${anchor.id} [${anchor.priority.toUpperCase()}] ${anchor.title}`,
+      anchor.description ? `Description: ${anchor.description}` : null,
+      anchor.targetDate ? `Target Date: ${anchor.targetDate} (${formatTargetDate(anchor)})` : null,
+      anchor.files && anchor.files.length > 0 ? `Files: ${anchor.files.join(', ')}` : null,
+      anchor.verifyCommand ? `Verify Command: ${anchor.verifyCommand}` : null,
+      `Created: ${formatCreationTime(anchor.createdAt)} (in ${anchor.project || 'global'})`
+    ].filter(Boolean).join('\n');
+    ctx.ui.notify(details, 'info');
+  }
 }