pi-anchor 0.3.0 → 0.4.0

package/assets/hero-zh.svg

@@ -1,4 +1,4 @@
-<svg xmlns="http://www.w3.org/2000/svg" viewBox="0 0 840 430" width="840" height="430">
+<svg xmlns="http://www.w3.org/2000/svg" viewBox="0 0 840 390" width="840" height="390">
   <defs>
     <filter id="shadow" x="-5%" y="-5%" width="110%" height="115%" filterUnits="userSpaceOnUse">
       <feDropShadow dx="0" dy="12" stdDeviation="16" flood-color="#000000" flood-opacity="0.45" />
@@ -10,72 +10,56 @@
   </defs>
 
   <g filter="url(#shadow)">
-    <rect x="20" y="15" width="800" height="390" rx="12" fill="#1e2326" stroke="#343f44" stroke-width="1.2" />
+    <rect x="20" y="15" width="800" height="350" rx="12" fill="#1e2326" stroke="#343f44" stroke-width="1.2" />
     <path d="M 20,27 A 12,12 0 0,1 32,15 L 808,15 A 12,12 0 0,1 820,27 L 820,52 L 20,52 Z" fill="url(#headerGrad)" stroke="#343f44" stroke-width="1" />
     <line x1="20" y1="52" x2="820" y2="52" stroke="#2d353b" stroke-width="1" />
     <circle cx="42" cy="33.5" r="5.5" fill="#e67e80" />
     <circle cx="60" cy="33.5" r="5.5" fill="#dbbc7f" />
     <circle cx="78" cy="33.5" r="5.5" fill="#a7c080" />
     <text x="420" y="38" text-anchor="middle" font-family="-apple-system, BlinkMacSystemFont, 'Segoe UI', Roboto, sans-serif" font-size="12" font-weight="500" fill="#859289">
-      ⌖ anchor (v0.3.0) · 小巧 · 自主 · 持久
+      ⌖ anchor · 贴在终端边框上的电子便签
     </text>
   </g>
 
   <g font-family="'JetBrains Mono', 'Fira Code', 'Cascadia Code', Consolas, monospace" font-size="13" xml:space="preserve">
-    <text x="45" y="84">
-      <tspan fill="#a7c080" font-weight="bold">~/Workspace</tspan>
+    <text x="45" y="86">
+      <tspan fill="#a7c080" font-weight="bold">~/Workspace/app</tspan>
       <tspan fill="#7fbbb3"> ❯ </tspan>
       <tspan fill="#d3c6aa" font-weight="bold">anchor</tspan>
     </text>
 
-    <text x="45" y="116">
-      <tspan fill="#7fbbb3" font-weight="bold">⌖ Anchors </tspan>
-      <tspan fill="#859289">(3 active, 1 quiet · 0 仓库污染 · 0 闲置 Token):</tspan>
+    <text x="45" y="120">
+      <tspan fill="#7fbbb3" font-weight="bold">⌖ Notes (3):</tspan>
     </text>
 
-    <text x="45" y="152">
+    <text x="45" y="154">
       <tspan fill="#859289">  01  </tspan>
-      <tspan fill="#e67e80" font-weight="bold">[P0]      </tspan>
-      <tspan fill="#d3c6aa">重构鉴权模块为 HttpOnly Cookie [src/auth.ts]</tspan>
-      <tspan fill="#7fbbb3">  anchor        </tspan>
-      <tspan fill="#e67e80" font-weight="bold">Today         </tspan>
-      <tspan fill="#7a8478">Today 10:02</tspan>
+      <tspan fill="#d3c6aa">把登录 Token 改用 HttpOnly Cookie 存储       </tspan>
+      <tspan fill="#7fbbb3">app · auth.ts          </tspan>
+      <tspan fill="#7a8478">25m ago</tspan>
     </text>
 
     <text x="45" y="182">
       <tspan fill="#859289">  02  </tspan>
-      <tspan fill="#dbbc7f" font-weight="bold">[P1]      </tspan>
-      <tspan fill="#d3c6aa">补充并发文件锁单元测试                      </tspan>
-      <tspan fill="#7fbbb3">  anchor        </tspan>
-      <tspan fill="#dbbc7f">Tomorrow      </tspan>
-      <tspan fill="#7a8478">Yesterday 21:34</tspan>
+      <tspan fill="#d3c6aa">检查网关超时后的降级重试边界                 </tspan>
+      <tspan fill="#7fbbb3">app · gateway.ts       </tspan>
+      <tspan fill="#7a8478">3h ago</tspan>
     </text>
 
-    <text x="45" y="212">
+    <text x="45" y="210">
       <tspan fill="#859289">  03  </tspan>
-      <tspan fill="#dbbc7f" font-weight="bold">[P1]      </tspan>
-      <tspan fill="#d3c6aa">打磨 CLI 交互式极简工程列表                 </tspan>
-      <tspan fill="#7fbbb3">  Desktop       </tspan>
-      <tspan fill="#a7c080">In 2d         </tspan>
-      <tspan fill="#7a8478">Today 10:02</tspan>
+      <tspan fill="#859289">College 重构前置查阅外部架构参考库           </tspan>
+      <tspan fill="#7a8478">College/优化 · notes.md </tspan>
+      <tspan fill="#56635f">8d ago · quiet</tspan>
     </text>
 
-    <text x="45" y="242">
-      <tspan fill="#859289">  04  </tspan>
-      <tspan fill="#7a8478" font-weight="bold">[Quiet]   </tspan>
-      <tspan fill="#859289">College 重构前置查阅外部架构参考库          </tspan>
-      <tspan fill="#7a8478">  College/优化  </tspan>
-      <tspan fill="#7a8478">Quiet (0 tok) </tspan>
-      <tspan fill="#56635f">09-28 14:20</tspan>
-    </text>
-
-    <rect x="45" y="274" width="750" height="58" rx="6" fill="#232a2e" stroke="#3a464c" stroke-width="1" />
-    <text x="62" y="298" fill="#a7c080" font-weight="bold">⚡ 会话内实时自主核销（执行 git commit 或测试通过当场自动结案）：</text>
-    <text x="62" y="319" fill="#d3c6aa">  git commit -m "feat(auth): 重构鉴权模块为 HttpOnly Cookie" ➔ ⌖ Auto-settled #anc-1</text>
+    <rect x="45" y="242" width="750" height="58" rx="6" fill="#232a2e" stroke="#3a464c" stroke-width="1" />
+    <text x="62" y="266" fill="#dbbc7f">1. 随手贴一张:  /pin 把 src/auth.ts 的登录改用 HttpOnly Cookie</text>
+    <text x="62" y="287" fill="#a7c080">2. 提交自动撕:  git commit -m "feat: 登录改用 HttpOnly Cookie" ➔ ⌖ Torn off #1</text>
 
-    <text x="45" y="366" fill="#7a8478">
+    <text x="45" y="334" fill="#7a8478">
       <tspan>  常用命令: </tspan>
-      <tspan fill="#7fbbb3" font-weight="bold">`/pin &lt;任务&gt;`</tspan>
+      <tspan fill="#7fbbb3" font-weight="bold">`/pin &lt;便签&gt;`</tspan>
       <tspan> · </tspan>
       <tspan fill="#7fbbb3" font-weight="bold">`/anchor`</tspan>
       <tspan> · </tspan>

package/bin/anchor.js

@@ -1,15 +1,13 @@
 #!/usr/bin/env node
 
 /**
- * Anchor CLI - Minimalist task protocol for AI coding workflows
- * Production-ready executable with dual-timeline & 4-quadrant cognitive grouping
+ * Anchor CLI — Minimalist terminal sticky notes for AI coding
  */
 
 import {
   AnchorStore,
   formatOrigin,
-  formatTargetDate,
-  formatCreationTime,
+  formatRelativeAge,
   sortAnchorsForDisplay,
   padToWidth
 } from '../dist/index.js';
@@ -17,55 +15,43 @@ import {
 const store = new AnchorStore();
 const args = process.argv.slice(2);
 
-// 1. View pending tasks: `anchor` or `anchor list`
+// 1. View sticky notes: `anchor` or `anchor list`
 if (args.length === 0 || args[0] === 'list' || args[0] === 'ls') {
-  const allUnfinished = store
+  const allNotes = store
     .list({ cwd: process.cwd(), all: true })
     .filter(a => a.status === 'active' || a.status === 'sleeping');
 
-  if (allUnfinished.length === 0) {
-    console.log('\n⌖ No active anchors. Use `anchor <task>` to record.\n');
+  if (allNotes.length === 0) {
+    console.log('\n⌖ No sticky notes. Run `anchor "<note>"` to stick one.\n');
     process.exit(0);
   }
 
-  const sorted = sortAnchorsForDisplay(allUnfinished, process.cwd());
-  const activeCount = sorted.filter(a => a.status === 'active').length;
-  const quietCount = sorted.length - activeCount;
-  const headerSuffix = quietCount > 0 ? `${activeCount} active, ${quietCount} quiet` : `${activeCount} active`;
-
-  console.log(`\n⌖ Anchors (${headerSuffix}):\n`);
+  const sorted = sortAnchorsForDisplay(allNotes, process.cwd());
+  console.log(`\n⌖ Notes (${sorted.length}):\n`);
 
   sorted.forEach((a, idx) => {
     const num = String(idx + 1).padStart(2, '0');
-    const badge = a.status === 'sleeping'
-      ? padToWidth('[Quiet]', 10)
-      : padToWidth(`[${a.priority.toUpperCase()}]`, 10);
     const origin = formatOrigin(a);
-    const target = a.status === 'sleeping' ? 'Quiet (0 tok)' : formatTargetDate(a);
-    const created = formatCreationTime(a.createdAt);
-
-    const titleWithFiles = (a.files && a.files.length > 0)
-      ? `${a.title} [${a.files.slice(0, 1).join(', ')}]`
-      : a.title;
+    const age = a.status === 'sleeping'
+      ? `${formatRelativeAge(a.createdAt)} · quiet`
+      : formatRelativeAge(a.createdAt);
 
     const colNum = `  ${num}  `;
-    const colTitle = padToWidth(titleWithFiles, 36);
-    const colOrigin = padToWidth(origin, 14);
-    const colTarget = padToWidth(target, 14);
-    const colCreated = created;
+    const colTitle = padToWidth(a.title, 42);
+    const colOrigin = padToWidth(origin, 22);
 
-    console.log(`${colNum}${badge}${colTitle}  ${colOrigin}  ${colTarget}  ${colCreated}`);
+    console.log(`${colNum}${colTitle}  ${colOrigin}  ${age}`);
   });
 
-  console.log('\n  Use `anchor done <id>` to complete, or `anchor undo` to restore.\n');
+  console.log('\n  Run `anchor done <num>` to tear off, or `anchor undo` to put back.\n');
   process.exit(0);
 }
 
-// 2. Undo settlement: `anchor undo`
+// 2. Put back last torn-off note: `anchor undo`
 if (args[0] === 'undo') {
   try {
     const restored = store.undoSettle();
-    console.log(`⌖ Restored #${restored.id}: "${restored.title}"`);
+    console.log(`⌖ Put back #${restored.id.replace(/^anc-/, '')}: "${restored.title}"`);
   } catch (err) {
     console.error(`Error: ${err.message}`);
     process.exit(1);
@@ -73,53 +59,43 @@ if (args[0] === 'undo') {
   process.exit(0);
 }
 
-// 3. Help: `anchor --help` or `anchor -h`
+// 3. Help: `anchor --help`
 if (args[0] === '--help' || args[0] === '-h' || args[0] === 'help') {
   console.log(`
-⌖ Anchor CLI - Cross-session task protocol for AI coding agents
+⌖ Anchor — Digital sticky notes for AI coding sessions
 
 Usage:
-  anchor                    List active anchors
-  anchor <task>             Pin a new task across sessions
-  anchor done <id>          Settle and evict a task (e.g. anchor done 1)
-  anchor undo               Restore the last settled task
-
-Options:
-  -h, --help                Show this help message
-  -v, --version             Show version
-  -d, --due <date>          Specify expected completion date (e.g. tomorrow, friday, 2026-09-28)
+  anchor                    View all sticky notes
+  anchor "<note>"           Stick a new note
+  anchor done <num>         Tear off a completed note (e.g. anchor done 1)
+  anchor undo               Put back the last torn-off note
 `);
   process.exit(0);
 }
 
-// 4. Close task: `anchor done <id>` or `anchor rm <id>`
+// 4. Tear off note: `anchor done <num>`
 if (args[0] === 'done' || args[0] === 'rm' || args[0] === 'close') {
   const idInput = args[1];
   if (!idInput) {
-    console.error('Usage: anchor done <id>');
+    console.error('Usage: anchor done <num>');
     process.exit(1);
   }
   try {
-    // 1. Check if idInput is a 1-based sequential display number (e.g. '1', '01')
-    const allUnfinished = store
+    const allNotes = store
       .list({ cwd: process.cwd(), all: true })
       .filter(a => a.status === 'active' || a.status === 'sleeping');
-    const sortedActive = sortAnchorsForDisplay(allUnfinished, process.cwd());
+    const sorted = sortAnchorsForDisplay(allNotes, process.cwd());
 
     let targetId = idInput;
-    const numMatch = idInput.match(/^\d+$/);
-    if (numMatch) {
+    if (/^\d+$/.test(idInput)) {
       const seqIndex = parseInt(idInput, 10);
-      if (seqIndex >= 1 && seqIndex <= sortedActive.length) {
-        targetId = sortedActive[seqIndex - 1].id;
+      if (seqIndex >= 1 && seqIndex <= sorted.length) {
+        targetId = sorted[seqIndex - 1].id;
       }
     }
 
-    const settled = store.settle(targetId, { settledBy: 'manual-command' });
-    const successMsg = settled.recurrence === 'daily'
-      ? `⌖ Completed for today: "${settled.title}" (resets tomorrow)`
-      : `⌖ Settled: "${settled.title}"`;
-    console.log(successMsg);
+    const settled = store.settle(targetId, { settledBy: 'manual' });
+    console.log(`⌖ Torn off: "${settled.title}"`);
   } catch (err) {
     console.error(`Error: ${err.message}`);
     process.exit(1);
@@ -127,24 +103,15 @@ if (args[0] === 'done' || args[0] === 'rm' || args[0] === 'close') {
   process.exit(0);
 }
 
-// 5. Pin new task: `anchor <task description> [--due <date>]`
-let targetDateFlag;
-const dueIdx = args.findIndex(a => a === '--due' || a === '-d');
-if (dueIdx !== -1 && args[dueIdx + 1]) {
-  targetDateFlag = args[dueIdx + 1];
-  args.splice(dueIdx, 2);
-}
-
+// 5. Stick a new note: `anchor <note text>`
 const title = args.join(' ').trim();
 if (!title) {
-  console.error('Error: task description cannot be empty.');
+  console.error('Error: Note text cannot be empty');
   process.exit(1);
 }
 
-const anc = store.create({
+const created = store.create({
   title,
-  targetDate: targetDateFlag,
   cwd: process.cwd()
 });
-const targetBadge = anc.targetDate ? ` · ${formatTargetDate(anc)}` : '';
-console.log(`⌖ Pinned #${anc.id}: "${anc.title}" [${anc.project}]${targetBadge}`);
+console.log(`⌖ Pinned #${created.id.replace(/^anc-/, '')}: "${created.title}"`);