pi-anchor 0.4.0 → 0.5.0

package/dist/index.cjs

@@ -37,8 +37,10 @@ __export(index_exports, {
   acquireSyncLock: () => acquireSyncLock,
   atomicRenameWithRetry: () => atomicRenameWithRetry,
   extractPathsFromText: () => extractPathsFromText,
+  extractProgressFromText: () => extractProgressFromText,
   findMatchedAnchors: () => findMatchedAnchors,
   formatOrigin: () => formatOrigin,
+  formatProgressBar: () => formatProgressBar,
   formatRelativeAge: () => formatRelativeAge,
   getDefaultStorageDir: () => getDefaultStorageDir,
   getDisplayWidth: () => getDisplayWidth,
@@ -53,6 +55,7 @@ __export(index_exports, {
   openAnchorDashboard: () => openAnchorDashboard,
   padToWidth: () => padToWidth,
   parseAnchorCommandInput: () => parseAnchorCommandInput,
+  parseQuickNoteInput: () => parseQuickNoteInput,
   renderActiveAnchorsContext: () => renderActiveAnchorsContext,
   renderColdStartAnchorsContext: () => renderColdStartAnchorsContext,
   resolveAnchorTarget: () => resolveAnchorTarget,
@@ -115,6 +118,32 @@ function extractPathsFromText(text) {
   }
   return Array.from(results);
 }
+function extractProgressFromText(rawTitle) {
+  if (!rawTitle) return { cleanTitle: "" };
+  const stepParts = Array.from(rawTitle.matchAll(/(?:^|\s)(\d+)\.\s*([^\d]+?)(?=\s+\d+\.\s|$)/g));
+  if (stepParts.length >= 2) {
+    const steps = stepParts.map((m) => m[2].trim().replace(/[;；,，]+$/, "")).filter(Boolean);
+    const firstMatchIdx = rawTitle.indexOf(stepParts[0][0]);
+    const prefix = rawTitle.slice(0, firstMatchIdx).replace(/[:：\-—\s]+$/, "").trim();
+    return {
+      cleanTitle: prefix || steps.join(" \u2192 "),
+      progress: { done: 0, total: steps.length, steps }
+    };
+  }
+  const ratioMatch = rawTitle.match(/(?:\[(\d{1,3})\/(\d{1,3})\]|\((\d{1,3})\/(\d{1,3})\)|(?:^|\s)(\d{1,3})\/(\d{1,3})(?=\s|$))/);
+  if (ratioMatch) {
+    const done = parseInt(ratioMatch[1] ?? ratioMatch[3] ?? ratioMatch[5], 10);
+    const total = parseInt(ratioMatch[2] ?? ratioMatch[4] ?? ratioMatch[6], 10);
+    if (!isNaN(done) && !isNaN(total) && total >= 2 && total <= 500 && done >= 0 && done <= total) {
+      const stripped = rawTitle.replace(ratioMatch[0], " ").replace(/\s+/g, " ").trim();
+      return {
+        cleanTitle: stripped || rawTitle.trim(),
+        progress: { done, total }
+      };
+    }
+  }
+  return { cleanTitle: rawTitle.trim() };
+}
 function isAnchorTargetingWorkspace(anchor, targetCwd) {
   if (!targetCwd) return true;
   const normTarget = targetCwd.trim().replace(/\\/g, "/").replace(/\/+$/, "");
@@ -257,8 +286,9 @@ function renderColdStartAnchorsContext(store, cwdOrNow, nowArg) {
   const lines = activeNotes.map((a) => {
     const num = a.id.replace(/^anc-/, "");
     const files = a.files.length > 0 ? ` (${a.files.slice(0, 2).join(", ")})` : "";
+    const prog = a.progress ? ` [${a.progress.done}/${a.progress.total}${a.progress.steps && a.progress.steps[a.progress.done] ? ` \xB7 next: ${a.progress.steps[a.progress.done]}` : ""}]` : "";
     const desc = a.description ? ` \u2014 ${a.description}` : "";
-    return `\u2022 #${num} [${a.project}] ${a.title}${files}${desc}`;
+    return `\u2022 #${num} [${a.project}] ${a.title}${prog}${files}${desc}`;
   });
   return [
     `<sticky-notes count="${activeNotes.length}">`,
@@ -433,8 +463,9 @@ var AnchorStore = class {
       const state = this.loadState();
       const now = Date.now();
       const id = this.generateId(state);
+      const { cleanTitle, progress: parsedProgress } = extractProgressFromText(input.title);
       const explicitFiles = (input.files || []).map((f) => normalizePath(f)).filter(Boolean);
-      const inferredFiles = explicitFiles.length > 0 ? explicitFiles : extractPathsFromText(`${input.title} ${input.description || ""}`);
+      const inferredFiles = explicitFiles.length > 0 ? explicitFiles : extractPathsFromText(`${cleanTitle} ${input.description || ""}`);
       let cwd = input.cwd ? normalizePath(input.cwd) : "";
       if (input.project && (/^[a-zA-Z]:[\\/]/.test(input.project.trim()) || input.project.trim().startsWith("/"))) {
         cwd = normalizePath(input.project.trim());
@@ -445,7 +476,7 @@ var AnchorStore = class {
       const projectName = input.project ? input.project.trim() : cwd ? import_node_path.default.basename(cwd) : "global";
       const anchor = {
         id,
-        title: input.title.trim(),
+        title: cleanTitle,
         description: input.description?.trim(),
         priority: input.priority || "p1",
         status: "active",
@@ -455,7 +486,9 @@ var AnchorStore = class {
         updatedAt: now,
         lastTouchedAt: now,
         files: inferredFiles,
-        tags: (input.tags || []).map((t) => t.trim()).filter(Boolean)
+        tags: (input.tags || []).map((t) => t.trim()).filter(Boolean),
+        ...input.sessionFile ? { sessionFile: normalizePath(input.sessionFile) } : {},
+        ...input.progress || parsedProgress ? { progress: input.progress || parsedProgress } : {}
       };
       state.anchors.push(anchor);
       this.saveState(state);
@@ -504,7 +537,7 @@ var AnchorStore = class {
       return updated;
     });
   }
-  touch(id, timestamp = Date.now()) {
+  touch(id, timestamp = Date.now(), sessionFile) {
     return this.withLock(() => {
       const state = this.loadState();
       const idx = this.findAnchorIndex(state.anchors, id);
@@ -515,11 +548,44 @@ var AnchorStore = class {
       if (current.status === "sleeping") {
         current.status = "active";
       }
+      if (sessionFile) {
+        current.sessionFile = normalizePath(sessionFile);
+      }
       state.anchors[idx] = current;
       this.saveState(state);
       return current;
     });
   }
+  /**
+   * Advance (or set) progress on a sticky note:
+   * - If delta is provided (default +1), increments `done` up to `total`.
+   * - If note had no progress yet, initializes a 4-step bar (`1/4`).
+   */
+  step(id, delta = 1, explicitTotal) {
+    return this.withLock(() => {
+      const state = this.loadState();
+      const idx = this.findAnchorIndex(state.anchors, id);
+      if (idx === -1) throw new Error(`Note not found: ${id}`);
+      const current = state.anchors[idx];
+      const now = Date.now();
+      const total = explicitTotal && explicitTotal >= 2 ? explicitTotal : current.progress?.total || 4;
+      const prevDone = current.progress?.done || 0;
+      const nextDone = Math.max(0, Math.min(total, prevDone + delta));
+      current.progress = {
+        ...current.progress || {},
+        done: nextDone,
+        total
+      };
+      current.lastTouchedAt = now;
+      current.updatedAt = now;
+      if (current.status === "sleeping") {
+        current.status = "active";
+      }
+      state.anchors[idx] = current;
+      this.saveState(state);
+      return { anchor: current, completed: nextDone >= total };
+    });
+  }
   /**
    * Tear off (settle) a completed sticky note and archive it to archive.jsonl
    */
@@ -590,6 +656,7 @@ var AnchorStore = class {
 };
 
 // src/tui.ts
+var import_node_fs2 = __toESM(require("fs"), 1);
 var import_node_path2 = __toESM(require("path"), 1);
 var ANSI_REGEX = /\x1b\[[0-9;]*[a-zA-Z]|\x1b\][^\x07\x1b]*(?:\x07|\x1b\\)/g;
 function stripAnsi(str) {
@@ -656,6 +723,14 @@ function padToWidth(str, targetWidth) {
   if (current >= targetWidth) return truncated;
   return truncated + " ".repeat(targetWidth - current);
 }
+function formatProgressBar(progress, cells = 4) {
+  if (!progress || !progress.total || progress.total < 1) return "";
+  const done = Math.max(0, Math.min(progress.total, progress.done || 0));
+  const filled = Math.min(cells, Math.max(done > 0 ? 1 : 0, Math.round(done / progress.total * cells)));
+  const finalFilled = done >= progress.total ? cells : done === 0 ? 0 : filled;
+  const bar = "\u25A0".repeat(finalFilled) + "\u25A1".repeat(Math.max(0, cells - finalFilled));
+  return `[${bar} ${done}/${progress.total}]`;
+}
 function formatRelativeAge(timestamp, now = Date.now()) {
   const diffSec = Math.max(0, Math.floor((now - timestamp) / 1e3));
   if (diffSec < 60) return "just now";
@@ -709,6 +784,7 @@ function updateAnchorStatusBar(ctx, store) {
   try {
     const active = store.list({ status: "active", cwd: ctx.cwd });
     ctx.ui.setStatus("anchor", active.length > 0 ? `\u2316 ${active.length}` : void 0);
+    updateStartupBanner(ctx, store);
   } catch {
   }
 }
@@ -717,41 +793,41 @@ function updateStartupBanner(ctx, store) {
   try {
     const active = store.list({ status: "active", cwd: ctx.cwd });
     if (active.length === 0) {
-      ctx.ui.setWidget("anchor-startup", void 0);
+      ctx.ui.setWidget("anchor-startup", void 0, { placement: "belowEditor" });
       return;
     }
     const sorted = sortAnchorsForDisplay(active, ctx.cwd);
-    const topItems = sorted.slice(0, 3);
     const factory = (_tui, theme) => ({
       render: (width) => {
-        const maxTitleWidth = Math.max(14, width - 34);
         const fg = theme?.fg ? theme.fg.bind(theme) : (_c, text) => text;
-        const label = active.length === 1 ? "1 note" : `${active.length} notes`;
-        const lines = [
-          truncateToWidth(fg("accent", `\u2316 ${label}`), width)
-        ];
-        for (const a of topItems) {
-          const num = a.id.replace(/^anc-/, "").padStart(2, "0");
+        if (sorted.length === 1) {
+          const a = sorted[0];
+          const num = a.id.replace(/^anc-/, "");
+          const bar = a.progress ? `${fg("accent", formatProgressBar(a.progress))} ` : "";
+          const nextStep = a.progress?.steps && a.progress.steps[a.progress.done] ? fg("muted", ` \u25B8 ${a.progress.steps[a.progress.done]}`) : "";
           const origin = formatOrigin(a);
-          const age = formatRelativeAge(a.createdAt);
-          const titleClipped = truncateToWidth(a.title, maxTitleWidth);
-          lines.push(
-            truncateToWidth(
-              `  ${fg("dim", num)}  ${titleClipped}  ${fg("muted", `\xB7 ${origin}`)} ${fg("dim", `(${age})`)}`,
-              width
-            )
-          );
+          const sessionIcon = a.sessionFile ? " \u21AA" : "";
+          const prefix = `${fg("accent", "\u2316")} ${fg("dim", `#${num}`)} ${bar}`;
+          const suffix = ` ${fg("muted", `(${origin}${sessionIcon})`)}`;
+          const availTitle = Math.max(12, width - getDisplayWidth(prefix) - getDisplayWidth(nextStep) - getDisplayWidth(suffix) - 2);
+          const titleClipped = truncateToWidth(a.title, availTitle);
+          return [truncateToWidth(`${prefix}${titleClipped}${nextStep}${suffix}`, width)];
         }
-        if (sorted.length > 3) {
-          lines.push(truncateToWidth(fg("dim", `  +${sorted.length - 3} more \xB7 /anchor`), width));
-        }
-        return lines;
+        const countTag = fg("accent", `\u2316 ${sorted.length} notes: `);
+        const segments = sorted.slice(0, 3).map((a) => {
+          const num = a.id.replace(/^anc-/, "");
+          const bar = a.progress ? `${formatProgressBar(a.progress)} ` : "";
+          const shortTitle = truncateToWidth(a.title, Math.max(14, Math.floor((width - 20) / Math.min(3, sorted.length)) - 12));
+          return `${fg("dim", `#${num}`)} ${bar}${shortTitle}`;
+        });
+        const more = sorted.length > 3 ? fg("dim", ` +${sorted.length - 3}`) : "";
+        return [truncateToWidth(`${countTag}${segments.join(fg("dim", "  \xB7  "))}${more}`, width)];
       },
       invalidate: () => {
       }
     });
     const content = ctx.ui?.theme ? factory : factory().render(80);
-    ctx.ui.setWidget("anchor-startup", content, { placement: "aboveEditor" });
+    ctx.ui.setWidget("anchor-startup", content, { placement: "belowEditor" });
   } catch {
   }
 }
@@ -759,7 +835,7 @@ async function openAnchorDashboard(ctx, store) {
   if (!hasActiveUI(ctx)) return;
   const allNotes = store.list({ cwd: ctx.cwd, all: true }).filter((a) => a.status === "active" || a.status === "sleeping");
   if (allNotes.length === 0) {
-    ctx.ui.notify("\u2316 No sticky notes. Use /pin <note> to stick one.", "info");
+    ctx.ui.notify("\u2316 No sticky notes. Type `pin: <note>` or `/pin <note>` to stick one.", "info");
     return;
   }
   const sorted = sortAnchorsForDisplay(allNotes, ctx.cwd);
@@ -770,10 +846,11 @@ async function openAnchorDashboard(ctx, store) {
   const titleWidth = isNarrow ? Math.max(20, termCols - 30) : 42;
   for (const a of sorted) {
     const num = a.id.replace(/^anc-/, "").padStart(2, "0");
-    const origin = formatOrigin(a);
+    const bar = a.progress ? `${formatProgressBar(a.progress)} ` : "";
+    const origin = formatOrigin(a) + (a.sessionFile ? " \u21AA" : "");
     const age = a.status === "sleeping" ? `${formatRelativeAge(a.createdAt)} \xB7 quiet` : formatRelativeAge(a.createdAt);
     const colNum = `${num}  `;
-    const colTitle = padToWidth(a.title, titleWidth);
+    const colTitle = padToWidth(`${bar}${a.title}`, titleWidth);
     const colOrigin = padToWidth(origin, 22);
     const label = isNarrow ? `${colNum}${colTitle}  ${age}`.trimEnd() : `${colNum}${colTitle}  ${colOrigin}  ${age}`.trimEnd();
     optionMap.set(label, a);
@@ -783,8 +860,15 @@ async function openAnchorDashboard(ctx, store) {
   if (!selected) return;
   const anchor = optionMap.get(selected);
   if (!anchor) return;
+  const currentSessionFile = ctx.sessionManager?.getSessionFile?.();
+  const canJumpSession = Boolean(
+    anchor.sessionFile && import_node_fs2.default.existsSync(anchor.sessionFile) && typeof ctx.switchSession === "function" && (!currentSessionFile || import_node_path2.default.resolve(anchor.sessionFile) !== import_node_path2.default.resolve(currentSessionFile))
+  );
+  const stepLabel = anchor.progress ? `\u25B6 Advance step (${anchor.progress.done}/${anchor.progress.total} \u2794 ${Math.min(anchor.progress.total, anchor.progress.done + 1)}/${anchor.progress.total})` : "\u25B6 Start progress bar (1/4)";
   const actions = [
     "\u2713 Done (tear off note)",
+    stepLabel,
+    ...canJumpSession ? ["\u21AA Jump to session (resume linked conversation)"] : [],
     ...anchor.status === "sleeping" ? ["\u26A1 Wake up (mark active)"] : [],
     "\u2139 Read full note",
     "\u21A9 Back"
@@ -795,6 +879,23 @@ async function openAnchorDashboard(ctx, store) {
     store.settle(anchor.id, { settledBy: "manual" });
     ctx.ui.notify(`\u2316 Torn off #${anchor.id.replace(/^anc-/, "")}: "${anchor.title}" (/anchor undo to put back)`, "info");
     updateAnchorStatusBar(ctx, store);
+  } else if (action.startsWith("\u25B6")) {
+    const { anchor: updated, completed } = store.step(anchor.id, 1);
+    updateAnchorStatusBar(ctx, store);
+    if (completed) {
+      ctx.ui.notify(
+        `\u2316 #${updated.id.replace(/^anc-/, "")} reached ${formatProgressBar(updated.progress)}! Run /done ${updated.id.replace(/^anc-/, "")} to tear off.`,
+        "info"
+      );
+    } else {
+      ctx.ui.notify(`\u2316 Advanced #${updated.id.replace(/^anc-/, "")} to ${formatProgressBar(updated.progress)}`, "info");
+    }
+  } else if (action.startsWith("\u21AA") && anchor.sessionFile) {
+    try {
+      await ctx.switchSession(anchor.sessionFile);
+    } catch (err) {
+      ctx.ui.notify(`Could not switch session: ${err.message}`, "error");
+    }
   } else if (action.startsWith("\u26A1")) {
     store.touch(anchor.id);
     ctx.ui.notify(`\u2316 Woke up #${anchor.id.replace(/^anc-/, "")}: "${anchor.title}"`, "info");
@@ -802,8 +903,10 @@ async function openAnchorDashboard(ctx, store) {
   } else if (action.startsWith("\u2139")) {
     const details = [
       `\u2316 Note #${anchor.id.replace(/^anc-/, "")}: ${anchor.title}`,
+      anchor.progress ? `Progress: ${formatProgressBar(anchor.progress)}${anchor.progress.steps ? ` (${anchor.progress.steps.join(" \u2192 ")})` : ""}` : null,
       anchor.description ? `Details: ${anchor.description}` : null,
       anchor.files.length > 0 ? `Files: ${anchor.files.join(", ")}` : null,
+      anchor.sessionFile ? `Session: ${import_node_path2.default.basename(anchor.sessionFile)}` : null,
       `Workspace: ${anchor.project || "global"} \xB7 Pinned ${formatRelativeAge(anchor.createdAt)}`
     ].filter(Boolean).join("\n");
     ctx.ui.notify(details, "info");
@@ -812,6 +915,7 @@ async function openAnchorDashboard(ctx, store) {
 
 // src/extension.ts
 var import_typebox = require("@sinclair/typebox");
+var import_node_fs3 = __toESM(require("fs"), 1);
 function parseAnchorCommandInput(raw) {
   const trimmed = (raw || "").trim();
   if (!trimmed || trimmed === "list" || trimmed === "ls") {
@@ -827,11 +931,30 @@ function parseAnchorCommandInput(raw) {
       targetId: settleMatch[1].trim().replace(/^#/, "")
     };
   }
+  const stepMatch = trimmed.match(/^(?:step|\+)\s*(\S+)(?:\s+([+-]?\d+))?$/i);
+  if (stepMatch) {
+    return {
+      mode: "step",
+      targetId: stepMatch[1].trim().replace(/^#/, ""),
+      delta: stepMatch[2] ? parseInt(stepMatch[2], 10) : 1
+    };
+  }
+  const jumpMatch = trimmed.match(/^(?:jump|resume|session)\s+(.+)$/i);
+  if (jumpMatch) {
+    return {
+      mode: "jump",
+      targetId: jumpMatch[1].trim().replace(/^#/, "")
+    };
+  }
   return {
     mode: "pin",
     title: trimmed
   };
 }
+function parseQuickNoteInput(text) {
+  const m = (text || "").trim().match(/^(?:pin|note|便签|备忘)\s*[:：]\s*(.+)$/i);
+  return m && m[1].trim() ? m[1].trim() : null;
+}
 function resolveAnchorTarget(store, idOrIndex, cwd) {
   const clean = idOrIndex.trim().replace(/^#/, "");
   if (/^\d+$/.test(clean)) {
@@ -853,8 +976,10 @@ function resolveAnchorTarget(store, idOrIndex, cwd) {
   acquireSyncLock,
   atomicRenameWithRetry,
   extractPathsFromText,
+  extractProgressFromText,
   findMatchedAnchors,
   formatOrigin,
+  formatProgressBar,
   formatRelativeAge,
   getDefaultStorageDir,
   getDisplayWidth,
@@ -869,6 +994,7 @@ function resolveAnchorTarget(store, idOrIndex, cwd) {
   openAnchorDashboard,
   padToWidth,
   parseAnchorCommandInput,
+  parseQuickNoteInput,
   renderActiveAnchorsContext,
   renderColdStartAnchorsContext,
   resolveAnchorTarget,

package/dist/index.d.cts

@@ -1,6 +1,6 @@
-import { A as Anchor, a as AnchorStore } from './extension-B1-fzCox.cjs';
-export { b as AnchorEvidence, c as AnchorPriority, d as AnchorStatus, e as AnchorStoreState, C as COMMENT_FORMATS, M as MS_PER_DAY, Q as QUIET_AFTER_DAYS, T as TouchMatchResult, f as acquireSyncLock, g as atomicRenameWithRetry, h as extractPathsFromText, i as findMatchedAnchors, j as getDefaultStorageDir, k as globToRegExp, l as isAnchorTargetingWorkspace, m as isSameOrSubPath, n as makeSafeTaskAnnotation, o as matchAnchorAgainstTouchedFiles, p as matchesCommitMessage, q as normalizePath, r as parseAnchorCommandInput, s as renderActiveAnchorsContext, t as renderColdStartAnchorsContext, u as resolveAnchorTarget, v as sweepQuietNotes } from './extension-B1-fzCox.cjs';
-import { ExtensionContext } from '@earendil-works/pi-coding-agent';
+import { A as Anchor, a as AnchorProgress, b as AnchorStore } from './extension-Cq1NH1jT.cjs';
+export { c as AnchorEvidence, d as AnchorPriority, e as AnchorStatus, f as AnchorStoreState, C as COMMENT_FORMATS, M as MS_PER_DAY, Q as QUIET_AFTER_DAYS, T as TouchMatchResult, g as acquireSyncLock, h as atomicRenameWithRetry, i as extractPathsFromText, j as extractProgressFromText, k as findMatchedAnchors, l as getDefaultStorageDir, m as globToRegExp, n as isAnchorTargetingWorkspace, o as isSameOrSubPath, p as makeSafeTaskAnnotation, q as matchAnchorAgainstTouchedFiles, r as matchesCommitMessage, s as normalizePath, t as parseAnchorCommandInput, u as parseQuickNoteInput, v as renderActiveAnchorsContext, w as renderColdStartAnchorsContext, x as resolveAnchorTarget, y as sweepQuietNotes } from './extension-Cq1NH1jT.cjs';
+import { ExtensionContext, ExtensionCommandContext } from '@earendil-works/pi-coding-agent';
 
 declare function stripAnsi(str: string): string;
 /**
@@ -10,12 +10,16 @@ declare function getDisplayWidth(str: string): number;
 declare function hasActiveUI(ctx: ExtensionContext | null | undefined): ctx is ExtensionContext;
 declare function truncateToWidth(str: string, maxWidth: number, ellipsis?: string): string;
 declare function padToWidth(str: string, targetWidth: number): string;
+/**
+ * Render a 4-cell micro progress bar: e.g. `[■■□□ 2/4]` or `[■□□□ 5/30]`
+ */
+declare function formatProgressBar(progress?: AnchorProgress, cells?: number): string;
 /**
  * Format relative sticky-note age cleanly: 'just now', '15m ago', '3h ago', '2d ago'
  */
 declare function formatRelativeAge(timestamp: number, now?: number): string;
 /**
- * Format workspace & first file context concisely (e.g. 'anchor · src/auth.ts' or 'College/优化')
+ * Format workspace & first file context concisely (e.g. 'anchor · auth.ts' or 'College/优化')
  */
 declare function formatOrigin(anchor: Anchor | string): string;
 /**
@@ -26,17 +30,18 @@ declare function formatOrigin(anchor: Anchor | string): string;
  */
 declare function sortAnchorsForDisplay(anchors: Anchor[], cwd?: string): Anchor[];
 /**
- * Update status bar badge: `⌖ 2` (invisible when 0 active notes)
+ * Update status bar badge (`⌖ 2`) AND the persistent below-editor sticky strip!
  */
 declare function updateAnchorStatusBar(ctx: ExtensionContext, store: AnchorStore): void;
 /**
- * Render clean sticky-note card above editor on session startup.
- * Automatically disappears as soon as the user sends their first message.
+ * Render persistent 1-line sticky-note strip BELOW the editor (`placement: 'belowEditor'`).
+ * Never collides with `pi-lingual` (`aboveEditor`), stays visible while you work,
+ * and takes 0 lines when there are no active notes.
  */
 declare function updateStartupBanner(ctx: ExtensionContext, store: AnchorStore): void;
 /**
- * Interactive `/anchor` sticky-note board
+ * Interactive `/anchor` sticky-note board with 1-click progress stepping and session teleport (`switchSession`)
  */
-declare function openAnchorDashboard(ctx: ExtensionContext, store: AnchorStore): Promise<void>;
+declare function openAnchorDashboard(ctx: ExtensionContext | ExtensionCommandContext, store: AnchorStore): Promise<void>;
 
-export { Anchor, AnchorStore, formatOrigin, formatRelativeAge, getDisplayWidth, hasActiveUI, openAnchorDashboard, padToWidth, sortAnchorsForDisplay, stripAnsi, truncateToWidth, updateAnchorStatusBar, updateStartupBanner };
+export { Anchor, AnchorProgress, AnchorStore, formatOrigin, formatProgressBar, formatRelativeAge, getDisplayWidth, hasActiveUI, openAnchorDashboard, padToWidth, sortAnchorsForDisplay, stripAnsi, truncateToWidth, updateAnchorStatusBar, updateStartupBanner };

package/dist/index.d.ts

@@ -1,6 +1,6 @@
-import { A as Anchor, a as AnchorStore } from './extension-B1-fzCox.js';
-export { b as AnchorEvidence, c as AnchorPriority, d as AnchorStatus, e as AnchorStoreState, C as COMMENT_FORMATS, M as MS_PER_DAY, Q as QUIET_AFTER_DAYS, T as TouchMatchResult, f as acquireSyncLock, g as atomicRenameWithRetry, h as extractPathsFromText, i as findMatchedAnchors, j as getDefaultStorageDir, k as globToRegExp, l as isAnchorTargetingWorkspace, m as isSameOrSubPath, n as makeSafeTaskAnnotation, o as matchAnchorAgainstTouchedFiles, p as matchesCommitMessage, q as normalizePath, r as parseAnchorCommandInput, s as renderActiveAnchorsContext, t as renderColdStartAnchorsContext, u as resolveAnchorTarget, v as sweepQuietNotes } from './extension-B1-fzCox.js';
-import { ExtensionContext } from '@earendil-works/pi-coding-agent';
+import { A as Anchor, a as AnchorProgress, b as AnchorStore } from './extension-Cq1NH1jT.js';
+export { c as AnchorEvidence, d as AnchorPriority, e as AnchorStatus, f as AnchorStoreState, C as COMMENT_FORMATS, M as MS_PER_DAY, Q as QUIET_AFTER_DAYS, T as TouchMatchResult, g as acquireSyncLock, h as atomicRenameWithRetry, i as extractPathsFromText, j as extractProgressFromText, k as findMatchedAnchors, l as getDefaultStorageDir, m as globToRegExp, n as isAnchorTargetingWorkspace, o as isSameOrSubPath, p as makeSafeTaskAnnotation, q as matchAnchorAgainstTouchedFiles, r as matchesCommitMessage, s as normalizePath, t as parseAnchorCommandInput, u as parseQuickNoteInput, v as renderActiveAnchorsContext, w as renderColdStartAnchorsContext, x as resolveAnchorTarget, y as sweepQuietNotes } from './extension-Cq1NH1jT.js';
+import { ExtensionContext, ExtensionCommandContext } from '@earendil-works/pi-coding-agent';
 
 declare function stripAnsi(str: string): string;
 /**
@@ -10,12 +10,16 @@ declare function getDisplayWidth(str: string): number;
 declare function hasActiveUI(ctx: ExtensionContext | null | undefined): ctx is ExtensionContext;
 declare function truncateToWidth(str: string, maxWidth: number, ellipsis?: string): string;
 declare function padToWidth(str: string, targetWidth: number): string;
+/**
+ * Render a 4-cell micro progress bar: e.g. `[■■□□ 2/4]` or `[■□□□ 5/30]`
+ */
+declare function formatProgressBar(progress?: AnchorProgress, cells?: number): string;
 /**
  * Format relative sticky-note age cleanly: 'just now', '15m ago', '3h ago', '2d ago'
  */
 declare function formatRelativeAge(timestamp: number, now?: number): string;
 /**
- * Format workspace & first file context concisely (e.g. 'anchor · src/auth.ts' or 'College/优化')
+ * Format workspace & first file context concisely (e.g. 'anchor · auth.ts' or 'College/优化')
  */
 declare function formatOrigin(anchor: Anchor | string): string;
 /**
@@ -26,17 +30,18 @@ declare function formatOrigin(anchor: Anchor | string): string;
  */
 declare function sortAnchorsForDisplay(anchors: Anchor[], cwd?: string): Anchor[];
 /**
- * Update status bar badge: `⌖ 2` (invisible when 0 active notes)
+ * Update status bar badge (`⌖ 2`) AND the persistent below-editor sticky strip!
  */
 declare function updateAnchorStatusBar(ctx: ExtensionContext, store: AnchorStore): void;
 /**
- * Render clean sticky-note card above editor on session startup.
- * Automatically disappears as soon as the user sends their first message.
+ * Render persistent 1-line sticky-note strip BELOW the editor (`placement: 'belowEditor'`).
+ * Never collides with `pi-lingual` (`aboveEditor`), stays visible while you work,
+ * and takes 0 lines when there are no active notes.
  */
 declare function updateStartupBanner(ctx: ExtensionContext, store: AnchorStore): void;
 /**
- * Interactive `/anchor` sticky-note board
+ * Interactive `/anchor` sticky-note board with 1-click progress stepping and session teleport (`switchSession`)
  */
-declare function openAnchorDashboard(ctx: ExtensionContext, store: AnchorStore): Promise<void>;
+declare function openAnchorDashboard(ctx: ExtensionContext | ExtensionCommandContext, store: AnchorStore): Promise<void>;
 
-export { Anchor, AnchorStore, formatOrigin, formatRelativeAge, getDisplayWidth, hasActiveUI, openAnchorDashboard, padToWidth, sortAnchorsForDisplay, stripAnsi, truncateToWidth, updateAnchorStatusBar, updateStartupBanner };
+export { Anchor, AnchorProgress, AnchorStore, formatOrigin, formatProgressBar, formatRelativeAge, getDisplayWidth, hasActiveUI, openAnchorDashboard, padToWidth, sortAnchorsForDisplay, stripAnsi, truncateToWidth, updateAnchorStatusBar, updateStartupBanner };

package/dist/index.js

@@ -6,8 +6,10 @@ import {
   acquireSyncLock,
   atomicRenameWithRetry,
   extractPathsFromText,
+  extractProgressFromText,
   findMatchedAnchors,
   formatOrigin,
+  formatProgressBar,
   formatRelativeAge,
   getDefaultStorageDir,
   getDisplayWidth,
@@ -22,6 +24,7 @@ import {
   openAnchorDashboard,
   padToWidth,
   parseAnchorCommandInput,
+  parseQuickNoteInput,
   renderActiveAnchorsContext,
   renderColdStartAnchorsContext,
   resolveAnchorTarget,
@@ -31,7 +34,7 @@ import {
   truncateToWidth,
   updateAnchorStatusBar,
   updateStartupBanner
-} from "./chunk-LKY6WIKH.js";
+} from "./chunk-VXEQDTK4.js";
 export {
   AnchorStore,
   COMMENT_FORMATS,
@@ -40,8 +43,10 @@ export {
   acquireSyncLock,
   atomicRenameWithRetry,
   extractPathsFromText,
+  extractProgressFromText,
   findMatchedAnchors,
   formatOrigin,
+  formatProgressBar,
   formatRelativeAge,
   getDefaultStorageDir,
   getDisplayWidth,
@@ -56,6 +61,7 @@ export {
   openAnchorDashboard,
   padToWidth,
   parseAnchorCommandInput,
+  parseQuickNoteInput,
   renderActiveAnchorsContext,
   renderColdStartAnchorsContext,
   resolveAnchorTarget,

package/package.json

@@ -1,7 +1,7 @@
 {
   "name": "pi-anchor",
-  "version": "0.4.0",
-  "description": "A digital sticky note for Pi — stick a quick note across sessions (/pin), get a 1-line whisper when touching matching files, and auto-tear off on git commit with 0 TODO.md clutter.",
+  "version": "0.5.0",
+  "description": "A digital sticky note docked below your Pi editor — stick notes in 0ms (pin: ...), track long tasks with micro progress bars [■■□□], jump back to the original session (↪), and auto-tear off on git commit.",
   "type": "module",
   "main": "dist/index.js",
   "module": "dist/index.js",