pi-anchor 0.2.3 → 0.2.4

package/dist/extension.d.cts

@@ -1,5 +1,20 @@
 import { ExtensionAPI } from '@earendil-works/pi-coding-agent';
+import { A as AnchorStore } from './store-BNKjzhS_.cjs';
 
+/**
+ * Parse inline `--due <date>` / `-d <date>` flags and `done`/`rm`/`close`/`settle` subcommands
+ * for `/anchor` and `/pin` slash commands.
+ */
+declare function parseAnchorCommandInput(raw: string, now?: number): {
+    mode: 'dashboard' | 'undo' | 'settle' | 'pin';
+    targetId?: string;
+    title?: string;
+    targetDate?: string;
+};
+/**
+ * Resolve either an explicit anchor ID ('anc-2', '2') or a 1-based visual dashboard index ('01', '1')
+ */
+declare function resolveAnchorTarget(store: AnchorStore, idOrIndex: string, cwd?: string): string | undefined;
 declare function export_default(pi: ExtensionAPI): void;
 
-export { export_default as default };
+export { export_default as default, parseAnchorCommandInput, resolveAnchorTarget };

package/dist/extension.d.ts

@@ -1,5 +1,20 @@
 import { ExtensionAPI } from '@earendil-works/pi-coding-agent';
+import { A as AnchorStore } from './store-BNKjzhS_.js';
 
+/**
+ * Parse inline `--due <date>` / `-d <date>` flags and `done`/`rm`/`close`/`settle` subcommands
+ * for `/anchor` and `/pin` slash commands.
+ */
+declare function parseAnchorCommandInput(raw: string, now?: number): {
+    mode: 'dashboard' | 'undo' | 'settle' | 'pin';
+    targetId?: string;
+    title?: string;
+    targetDate?: string;
+};
+/**
+ * Resolve either an explicit anchor ID ('anc-2', '2') or a 1-based visual dashboard index ('01', '1')
+ */
+declare function resolveAnchorTarget(store: AnchorStore, idOrIndex: string, cwd?: string): string | undefined;
 declare function export_default(pi: ExtensionAPI): void;
 
-export { export_default as default };
+export { export_default as default, parseAnchorCommandInput, resolveAnchorTarget };

package/dist/extension.js

@@ -1,8 +1,10 @@
 import {
   AnchorStore,
   SessionTouchObserver,
+  detectTargetDate,
   findMatchedAnchors,
   generateSettlementProposals,
+  groupAnchorsByQuadrant,
   hasActiveUI,
   isSameOrSubPath,
   makeSafeTaskAnnotation,
@@ -22,6 +24,55 @@ import { execSync } from "child_process";
 import fs from "fs";
 import path from "path";
 var MUTATION_TOOLS = /* @__PURE__ */ new Set(["edit", "write", "patch", "apply_diff", "create_file", "modify"]);
+function parseAnchorCommandInput(raw, now = Date.now()) {
+  const trimmed = (raw || "").trim();
+  if (!trimmed || trimmed === "list" || trimmed === "ls") {
+    return { mode: "dashboard" };
+  }
+  if (trimmed === "undo") {
+    return { mode: "undo" };
+  }
+  const settleMatch = trimmed.match(/^(?:done|rm|close|settle)\s+(.+)$/i);
+  if (settleMatch) {
+    return {
+      mode: "settle",
+      targetId: settleMatch[1].trim().replace(/^#/, "")
+    };
+  }
+  let targetDate;
+  const tokens = trimmed.split(/\s+/);
+  const dueIdx = tokens.findIndex((t) => t === "--due" || t === "-d");
+  if (dueIdx !== -1 && tokens[dueIdx + 1]) {
+    const rawDue = tokens[dueIdx + 1];
+    targetDate = detectTargetDate(rawDue, now) || rawDue;
+    tokens.splice(dueIdx, 2);
+  }
+  const cleanTitle = tokens.join(" ").trim();
+  return {
+    mode: "pin",
+    title: cleanTitle || trimmed,
+    targetDate
+  };
+}
+function resolveAnchorTarget(store, idOrIndex, cwd) {
+  const clean = idOrIndex.trim().replace(/^#/, "");
+  if (/^\d+$/.test(clean)) {
+    const seqIndex = parseInt(clean, 10);
+    const active = store.list({ status: "active", cwd });
+    const groups = groupAnchorsByQuadrant(active);
+    const sortedActive = [
+      ...groups.today,
+      ...groups.upcoming,
+      ...groups.habits,
+      ...groups.backlog
+    ];
+    if (seqIndex >= 1 && seqIndex <= sortedActive.length) {
+      return sortedActive[seqIndex - 1].id;
+    }
+  }
+  const direct = store.get(clean);
+  return direct?.id;
+}
 function extension_default(pi) {
   const store = new AnchorStore();
   const observer = new SessionTouchObserver();
@@ -33,7 +84,7 @@ function extension_default(pi) {
     preflightFailures.clear();
     const sweep = sweepStore(store);
     if (sweep.transitionedToSleeping.length > 0) {
-      ctx.ui.notify(`Anchor: ${sweep.transitionedToSleeping.length} \u4E2A\u975E\u6D3B\u8DC3\u4EFB\u52A1\u5DF2\u8FDB\u5165\u4F11\u7720`, "info");
+      ctx.ui.notify(`\u2316 Anchor: ${sweep.transitionedToSleeping.length} inactive tasks transitioned to sleep`, "info");
     }
     const activeAnchors = store.list({ cwd: ctx.cwd }).filter((a) => a.status === "active");
     for (const a of activeAnchors) {
@@ -45,7 +96,7 @@ function extension_default(pi) {
               settledBy: "verification-test",
               summary: `Physical pre-flight test passed: ${a.verifyCommand}`
             });
-            ctx.ui.notify(`\u2693 \u7269\u7406\u9A8C\u8BC1\u901A\u8FC7\uFF01\u951A\u70B9 #${a.id} ("${a.title}") \u5DF2\u81EA\u52A8\u7ED3\u6848\u5F52\u6863\u3002`, "info");
+            ctx.ui.notify(`\u2316 Verification passed! Auto-settled #${a.id}: "${a.title}"`, "info");
           } else {
             preflightFailures.set(a.id, res.output.slice(-250));
           }
@@ -377,14 +428,14 @@ Mark as completed and archive?`
     }
   });
   pi.registerCommand("anchor", {
-    description: "Inspect and settle active anchors",
+    description: "Inspect, pin, or settle active anchors (e.g. /anchor, /anchor done 1, /anchor undo)",
     handler: async (args, ctx) => {
-      const input = (args || "").trim();
-      if (!input || input === "list" || input === "ls") {
+      const parsed = parseAnchorCommandInput(args);
+      if (parsed.mode === "dashboard") {
         await openAnchorDashboard(ctx, store);
         return;
       }
-      if (input === "undo") {
+      if (parsed.mode === "undo") {
         try {
           const restored = store.undoSettle();
           ctx.ui.notify(`\u2316 Restored #${restored.id}: "${restored.title}"`, "info");
@@ -394,29 +445,68 @@ Mark as completed and archive?`
         }
         return;
       }
-      const targetId = input.startsWith("#") ? input.slice(1) : input;
-      const item = store.get(targetId);
-      if (item) {
-        store.settle(targetId, { settledBy: "manual-command" });
-        ctx.ui.notify(`\u2316 Settled: "${item.title}"`, "info");
+      if (parsed.mode === "settle" && parsed.targetId) {
+        const resolvedId = resolveAnchorTarget(store, parsed.targetId, ctx.cwd);
+        if (!resolvedId) {
+          ctx.ui.notify(`\u2316 Anchor not found: ${parsed.targetId}`, "error");
+          return;
+        }
+        const settled = store.settle(resolvedId, { settledBy: "manual-command" });
+        ctx.ui.notify(`\u2316 Settled #${settled.id}: "${settled.title}" (/anchor undo to revert)`, "info");
         updateAnchorStatusBar(ctx, store);
         return;
       }
-      const anc = store.create({ title: input, cwd: ctx.cwd });
-      ctx.ui.notify(`\u2316 Pinned #${anc.id}: "${anc.title}"`, "info");
+      const rawTrimmed = (args || "").trim();
+      if (/^(?:#?anc-\d+|#\d+)$/i.test(rawTrimmed)) {
+        const resolvedId = resolveAnchorTarget(store, rawTrimmed, ctx.cwd);
+        if (resolvedId) {
+          const settled = store.settle(resolvedId, { settledBy: "manual-command" });
+          ctx.ui.notify(`\u2316 Settled #${settled.id}: "${settled.title}" (/anchor undo to revert)`, "info");
+          updateAnchorStatusBar(ctx, store);
+          return;
+        }
+      }
+      const anc = store.create({
+        title: parsed.title || rawTrimmed,
+        targetDate: parsed.targetDate,
+        cwd: ctx.cwd
+      });
+      ctx.ui.notify(`\u2316 Pinned #${anc.id}: "${anc.title}"${anc.targetDate ? ` (due ${anc.targetDate})` : ""}`, "info");
       updateAnchorStatusBar(ctx, store);
     }
   });
   pi.registerCommand("pin", {
-    description: "Quickly pin a task across sessions",
+    description: "Pin a task across sessions (e.g. /pin Refactor auth --due tomorrow)",
     handler: async (args, ctx) => {
-      const title = (args || "").trim();
-      if (!title) {
+      const parsed = parseAnchorCommandInput(args);
+      if (parsed.mode === "dashboard" || !parsed.title) {
         await openAnchorDashboard(ctx, store);
         return;
       }
-      const anc = store.create({ title, cwd: ctx.cwd });
-      ctx.ui.notify(`\u2316 Pinned #${anc.id}: "${anc.title}"`, "info");
+      const anc = store.create({
+        title: parsed.title,
+        targetDate: parsed.targetDate,
+        cwd: ctx.cwd
+      });
+      ctx.ui.notify(`\u2316 Pinned #${anc.id}: "${anc.title}"${anc.targetDate ? ` (due ${anc.targetDate})` : ""}`, "info");
+      updateAnchorStatusBar(ctx, store);
+    }
+  });
+  pi.registerCommand("done", {
+    description: "Complete an active anchor by row number or ID (e.g. /done 1)",
+    handler: async (args, ctx) => {
+      const target = (args || "").trim();
+      if (!target) {
+        await openAnchorDashboard(ctx, store);
+        return;
+      }
+      const resolvedId = resolveAnchorTarget(store, target, ctx.cwd);
+      if (!resolvedId) {
+        ctx.ui.notify(`\u2316 Anchor not found: ${target}`, "error");
+        return;
+      }
+      const settled = store.settle(resolvedId, { settledBy: "manual-command" });
+      ctx.ui.notify(`\u2316 Settled #${settled.id}: "${settled.title}" (/anchor undo to revert)`, "info");
       updateAnchorStatusBar(ctx, store);
     }
   });
@@ -428,5 +518,7 @@ Mark as completed and archive?`
   });
 }
 export {
-  extension_default as default
+  extension_default as default,
+  parseAnchorCommandInput,
+  resolveAnchorTarget
 };

package/dist/index.d.cts

@@ -1,213 +1,7 @@
+import { a as AnchorStatus, b as Anchor, A as AnchorStore, T as TouchMatchResult, S as SettlementProposal } from './store-BNKjzhS_.cjs';
+export { c as AnchorDecayPolicy, d as AnchorDurability, e as AnchorEvidence, f as AnchorPriority, g as AnchorStoreState, D as DEFAULT_DECAY_POLICY, h as DURABLE_DECAY_POLICY, E as EPHEMERAL_DECAY_POLICY, i as acquireSyncLock, j as atomicRenameWithRetry, k as detectDurability, l as detectRecurrence, m as detectTargetDate, n as getDefaultStorageDir, o as getEphemeralDecayPolicy, p as getTodayDateString } from './store-BNKjzhS_.cjs';
 import { ExtensionContext } from '@earendil-works/pi-coding-agent';
 
-/**
- * Anchor Data Contracts & Type Definitions
- * Single Global Source of Truth with Zero Workspace Contamination.
- */
-type AnchorStatus = 'active' | 'sleeping' | 'settled' | 'graveyard';
-type AnchorPriority = 'p0' | 'p1' | 'p2';
-type AnchorDurability = 'ephemeral' | 'durable';
-interface AnchorDecayPolicy {
-    /** Days before an untouched active anchor transitions to sleeping */
-    activeDays: number;
-    /** Days an anchor remains sleeping before dropping to graveyard */
-    sleepDays: number;
-    /** Total maximum days before permanent graveyard sweep (9999 = never) */
-    graveyardDays: number;
-}
-interface AnchorEvidence {
-    settledAt?: number;
-    settledBy?: 'one-tap-settlement' | 'manual-command' | 'verification-test';
-    commitHash?: string;
-    summary?: string;
-    touchedFiles?: string[];
-}
-interface Anchor {
-    /** Unique sequential identifier, e.g., 'anc-1' */
-    id: string;
-    /** Short imperative title of the task */
-    title: string;
-    /** Optional detailed context or notes */
-    description?: string;
-    /** Task priority */
-    priority: AnchorPriority;
-    /** Current lifecycle status */
-    status: AnchorStatus;
-    /** Durability tier: ephemeral (short-lived reminder, 48h TTL) or durable (long-term architecture vision) */
-    durability: AnchorDurability;
-    /** Canonical project name (e.g. 'PPT', 'X', or 'global') */
-    project: string;
-    /** Canonical root directory where the task was anchored (empty string for global tasks) */
-    cwd: string;
-    /** Creation timestamp in ms */
-    createdAt: number;
-    /** Last update timestamp in ms */
-    updatedAt: number;
-    /** Last touched timestamp in ms (resets on file touch) */
-    lastTouchedAt: number;
-    /** Associated file paths or globs, e.g. ['src/auth/*.ts'] */
-    files: string[];
-    /** Expected completion date in format 'YYYY-MM-DD' (e.g. '2026-09-24') */
-    targetDate?: string;
-    /** Optional shell command for automated physical verification (e.g. 'npm test') */
-    verifyCommand?: string;
-    /** Topic or domain tags, e.g. ['auth', 'security'] */
-    tags: string[];
-    /** Optional recurrence pattern: 'daily' for recurring daily habits */
-    recurrence?: 'daily';
-    /** Last completed date string 'YYYY-MM-DD' for recurring tasks */
-    lastCompletedDate?: string;
-    /** Decay policy overrides */
-    decay: AnchorDecayPolicy;
-    /** Settlement evidence metadata upon closure */
-    evidence?: AnchorEvidence;
-}
-interface AnchorStoreState {
-    version: number;
-    anchors: Anchor[];
-    lastSweepAt: number;
-    nextId?: number;
-}
-interface TouchMatchResult {
-    anchor: Anchor;
-    score: number;
-    matchedFiles: string[];
-    reason: 'exact-file' | 'dir-prefix' | 'tag-keyword';
-}
-interface SettlementProposal {
-    anchor: Anchor;
-    matchedFiles: string[];
-    reason: string;
-    recommendedAction: 'settle' | 'defer';
-}
-declare const EPHEMERAL_DECAY_POLICY: AnchorDecayPolicy;
-declare const DURABLE_DECAY_POLICY: AnchorDecayPolicy;
-declare const DEFAULT_DECAY_POLICY: AnchorDecayPolicy;
-
-/**
- * Detect whether a task is a short-term ephemeral reminder or a long-term architectural vision
- */
-declare function detectDurability(title: string): AnchorDurability;
-/**
- * Get custom ephemeral decay policy based on temporal span (e.g. 后天, 大后天)
- */
-declare function getEphemeralDecayPolicy(title: string): AnchorDecayPolicy;
-/**
- * Detect expected completion date from title keywords or explicit date string, returning 'YYYY-MM-DD'
- */
-declare function detectTargetDate(titleOrDate: string, now?: number): string | undefined;
-/**
- * Detect recurring patterns, e.g. daily habits
- */
-declare function detectRecurrence(title: string): 'daily' | undefined;
-/**
- * Get current date string 'YYYY-MM-DD' in local timezone
- */
-declare function getTodayDateString(timestamp?: number): string;
-/**
- * Resolve the default storage directory for Anchor (~/.anchor).
- * Hierarchy:
- * 1. Process environment: ANCHOR_DIR
- * 2. Canonical user-global store: ~/.anchor/
- * 3. Legacy Pi harness fallback: ~/.pi/agent/anchors/ (migrates automatically if present)
- */
-declare function getDefaultStorageDir(): string;
-/**
- * Acquire exclusive lockfile using atomic 'wx' file creation (zero external dependencies).
- * Features:
- * - 0 async infection (100% synchronous)
- * - Automatic stale lock eviction (>5000ms or dead PID)
- * - Exponential backoff with jitter
- */
-declare function acquireSyncLock(lockPath: string, maxWaitMs?: number, staleTimeoutMs?: number): () => void;
-/**
- * Windows-tolerant atomic rename with exponential spin-retry to combat NTFS EBUSY/EPERM file locks
- */
-declare function atomicRenameWithRetry(tempPath: string, targetPath: string, maxAttempts?: number): void;
-declare class AnchorStore {
-    readonly storageDir: string;
-    readonly statePath: string;
-    readonly archivePath: string;
-    readonly graveyardPath: string;
-    constructor(customStorageDir?: string);
-    get lockPath(): string;
-    /**
-     * Execute mutation within a cross-process exclusive lock
-     */
-    withLock<T>(fn: () => T): T;
-    private ensureDirs;
-    /**
-     * Load store state. If corrupt or missing, returns safe default.
-     */
-    loadState(): AnchorStoreState;
-    /**
-     * Atomically save store state via temp file + atomic rename with Windows NTFS spin-retry
-     */
-    saveState(state: AnchorStoreState): void;
-    private generateId;
-    /**
-     * Create a new Anchor with automatic project and cwd tagging
-     */
-    create(input: {
-        title: string;
-        description?: string;
-        priority?: AnchorPriority;
-        durability?: AnchorDurability;
-        recurrence?: 'daily';
-        cwd?: string;
-        project?: string;
-        targetDate?: string;
-        files?: string[];
-        tags?: string[];
-        verifyCommand?: string;
-        decay?: AnchorDecayPolicy;
-    }): Anchor;
-    private findAnchorIndex;
-    /**
-     * Get an anchor by ID (supports 'anc-1', '#anc-1', '1', '01')
-     */
-    get(id: string): Anchor | undefined;
-    /**
-     * List anchors. By default, if cwd is provided, only returns anchors
-     * belonging to this cwd or marked as global (''). Pass all: true for global view.
-     */
-    list(filter?: {
-        status?: AnchorStatus;
-        priority?: AnchorPriority;
-        cwd?: string;
-        all?: boolean;
-        now?: number;
-    }): Anchor[];
-    /**
-     * Update an existing anchor
-     */
-    update(id: string, patch: Partial<Omit<Anchor, 'id' | 'createdAt'>>): Anchor;
-    /**
-     * Touch an anchor to refresh its decay window and reactivate sleeping state
-     */
-    touch(id: string, timestamp?: number): Anchor;
-    /**
-     * Settle an anchor (recurring daily habits complete for today and wake up tomorrow)
-     */
-    settle(id: string, evidence?: AnchorEvidence, now?: number): Anchor;
-    /**
-     * Reverse/undo the last settled anchor, popping it from archive.jsonl back into state.json
-     */
-    undoSettle(): Anchor;
-    /**
-     * Evict anchor to graveyard.jsonl upon total decay expiry
-     */
-    dropToGraveyard(id: string, reason: string): Anchor;
-    getArchive(filter?: {
-        cwd?: string;
-        all?: boolean;
-    }): Anchor[];
-    getGraveyard(filter?: {
-        cwd?: string;
-        all?: boolean;
-    }): Anchor[];
-}
-
 interface DecayEvaluation {
     currentStatus: AnchorStatus;
     nextStatus: AnchorStatus;
@@ -451,4 +245,4 @@ declare class AnchorProtocol {
     };
 }
 
-export { type AgentAdapter, type Anchor, type AnchorDecayPolicy, type AnchorDurability, type AnchorEvidence, type AnchorPriority, AnchorProtocol, type AnchorQuadrant, type AnchorStatus, AnchorStore, type AnchorStoreState, COMMENT_FORMATS, DEFAULT_DECAY_POLICY, DURABLE_DECAY_POLICY, type DecayEvaluation, EPHEMERAL_DECAY_POLICY, type GroupedAnchors, SessionTouchObserver, type SettlementProposal, type SweepResult, type TouchMatchResult, acquireSyncLock, atomicRenameWithRetry, classifyAnchor, detectDurability, detectRecurrence, detectTargetDate, evaluateAnchorDecay, findMatchedAnchors, formatCreationTime, formatOrigin, formatRelativeTime, formatRemainingTtl, formatSettlementCard, formatTargetDate, generateSettlementProposals, getDefaultStorageDir, getDisplayWidth, getEphemeralDecayPolicy, getTodayDateString, globToRegExp, groupAnchorsByQuadrant, hasActiveUI, isSameOrSubPath, makeSafeTaskAnnotation, matchAnchorAgainstTouchedFiles, normalizePath, openAnchorDashboard, padToWidth, renderActiveAnchorsContext, renderColdStartAnchorsContext, runPhysicalVerification, stripAnsi, sweepStore, truncateToWidth, updateAnchorStatusBar, updateStartupBanner };
+export { type AgentAdapter, Anchor, AnchorProtocol, type AnchorQuadrant, AnchorStatus, AnchorStore, COMMENT_FORMATS, type DecayEvaluation, type GroupedAnchors, SessionTouchObserver, SettlementProposal, type SweepResult, TouchMatchResult, classifyAnchor, evaluateAnchorDecay, findMatchedAnchors, formatCreationTime, formatOrigin, formatRelativeTime, formatRemainingTtl, formatSettlementCard, formatTargetDate, generateSettlementProposals, getDisplayWidth, globToRegExp, groupAnchorsByQuadrant, hasActiveUI, isSameOrSubPath, makeSafeTaskAnnotation, matchAnchorAgainstTouchedFiles, normalizePath, openAnchorDashboard, padToWidth, renderActiveAnchorsContext, renderColdStartAnchorsContext, runPhysicalVerification, stripAnsi, sweepStore, truncateToWidth, updateAnchorStatusBar, updateStartupBanner };

package/dist/index.d.ts

@@ -1,213 +1,7 @@
+import { a as AnchorStatus, b as Anchor, A as AnchorStore, T as TouchMatchResult, S as SettlementProposal } from './store-BNKjzhS_.js';
+export { c as AnchorDecayPolicy, d as AnchorDurability, e as AnchorEvidence, f as AnchorPriority, g as AnchorStoreState, D as DEFAULT_DECAY_POLICY, h as DURABLE_DECAY_POLICY, E as EPHEMERAL_DECAY_POLICY, i as acquireSyncLock, j as atomicRenameWithRetry, k as detectDurability, l as detectRecurrence, m as detectTargetDate, n as getDefaultStorageDir, o as getEphemeralDecayPolicy, p as getTodayDateString } from './store-BNKjzhS_.js';
 import { ExtensionContext } from '@earendil-works/pi-coding-agent';
 
-/**
- * Anchor Data Contracts & Type Definitions
- * Single Global Source of Truth with Zero Workspace Contamination.
- */
-type AnchorStatus = 'active' | 'sleeping' | 'settled' | 'graveyard';
-type AnchorPriority = 'p0' | 'p1' | 'p2';
-type AnchorDurability = 'ephemeral' | 'durable';
-interface AnchorDecayPolicy {
-    /** Days before an untouched active anchor transitions to sleeping */
-    activeDays: number;
-    /** Days an anchor remains sleeping before dropping to graveyard */
-    sleepDays: number;
-    /** Total maximum days before permanent graveyard sweep (9999 = never) */
-    graveyardDays: number;
-}
-interface AnchorEvidence {
-    settledAt?: number;
-    settledBy?: 'one-tap-settlement' | 'manual-command' | 'verification-test';
-    commitHash?: string;
-    summary?: string;
-    touchedFiles?: string[];
-}
-interface Anchor {
-    /** Unique sequential identifier, e.g., 'anc-1' */
-    id: string;
-    /** Short imperative title of the task */
-    title: string;
-    /** Optional detailed context or notes */
-    description?: string;
-    /** Task priority */
-    priority: AnchorPriority;
-    /** Current lifecycle status */
-    status: AnchorStatus;
-    /** Durability tier: ephemeral (short-lived reminder, 48h TTL) or durable (long-term architecture vision) */
-    durability: AnchorDurability;
-    /** Canonical project name (e.g. 'PPT', 'X', or 'global') */
-    project: string;
-    /** Canonical root directory where the task was anchored (empty string for global tasks) */
-    cwd: string;
-    /** Creation timestamp in ms */
-    createdAt: number;
-    /** Last update timestamp in ms */
-    updatedAt: number;
-    /** Last touched timestamp in ms (resets on file touch) */
-    lastTouchedAt: number;
-    /** Associated file paths or globs, e.g. ['src/auth/*.ts'] */
-    files: string[];
-    /** Expected completion date in format 'YYYY-MM-DD' (e.g. '2026-09-24') */
-    targetDate?: string;
-    /** Optional shell command for automated physical verification (e.g. 'npm test') */
-    verifyCommand?: string;
-    /** Topic or domain tags, e.g. ['auth', 'security'] */
-    tags: string[];
-    /** Optional recurrence pattern: 'daily' for recurring daily habits */
-    recurrence?: 'daily';
-    /** Last completed date string 'YYYY-MM-DD' for recurring tasks */
-    lastCompletedDate?: string;
-    /** Decay policy overrides */
-    decay: AnchorDecayPolicy;
-    /** Settlement evidence metadata upon closure */
-    evidence?: AnchorEvidence;
-}
-interface AnchorStoreState {
-    version: number;
-    anchors: Anchor[];
-    lastSweepAt: number;
-    nextId?: number;
-}
-interface TouchMatchResult {
-    anchor: Anchor;
-    score: number;
-    matchedFiles: string[];
-    reason: 'exact-file' | 'dir-prefix' | 'tag-keyword';
-}
-interface SettlementProposal {
-    anchor: Anchor;
-    matchedFiles: string[];
-    reason: string;
-    recommendedAction: 'settle' | 'defer';
-}
-declare const EPHEMERAL_DECAY_POLICY: AnchorDecayPolicy;
-declare const DURABLE_DECAY_POLICY: AnchorDecayPolicy;
-declare const DEFAULT_DECAY_POLICY: AnchorDecayPolicy;
-
-/**
- * Detect whether a task is a short-term ephemeral reminder or a long-term architectural vision
- */
-declare function detectDurability(title: string): AnchorDurability;
-/**
- * Get custom ephemeral decay policy based on temporal span (e.g. 后天, 大后天)
- */
-declare function getEphemeralDecayPolicy(title: string): AnchorDecayPolicy;
-/**
- * Detect expected completion date from title keywords or explicit date string, returning 'YYYY-MM-DD'
- */
-declare function detectTargetDate(titleOrDate: string, now?: number): string | undefined;
-/**
- * Detect recurring patterns, e.g. daily habits
- */
-declare function detectRecurrence(title: string): 'daily' | undefined;
-/**
- * Get current date string 'YYYY-MM-DD' in local timezone
- */
-declare function getTodayDateString(timestamp?: number): string;
-/**
- * Resolve the default storage directory for Anchor (~/.anchor).
- * Hierarchy:
- * 1. Process environment: ANCHOR_DIR
- * 2. Canonical user-global store: ~/.anchor/
- * 3. Legacy Pi harness fallback: ~/.pi/agent/anchors/ (migrates automatically if present)
- */
-declare function getDefaultStorageDir(): string;
-/**
- * Acquire exclusive lockfile using atomic 'wx' file creation (zero external dependencies).
- * Features:
- * - 0 async infection (100% synchronous)
- * - Automatic stale lock eviction (>5000ms or dead PID)
- * - Exponential backoff with jitter
- */
-declare function acquireSyncLock(lockPath: string, maxWaitMs?: number, staleTimeoutMs?: number): () => void;
-/**
- * Windows-tolerant atomic rename with exponential spin-retry to combat NTFS EBUSY/EPERM file locks
- */
-declare function atomicRenameWithRetry(tempPath: string, targetPath: string, maxAttempts?: number): void;
-declare class AnchorStore {
-    readonly storageDir: string;
-    readonly statePath: string;
-    readonly archivePath: string;
-    readonly graveyardPath: string;
-    constructor(customStorageDir?: string);
-    get lockPath(): string;
-    /**
-     * Execute mutation within a cross-process exclusive lock
-     */
-    withLock<T>(fn: () => T): T;
-    private ensureDirs;
-    /**
-     * Load store state. If corrupt or missing, returns safe default.
-     */
-    loadState(): AnchorStoreState;
-    /**
-     * Atomically save store state via temp file + atomic rename with Windows NTFS spin-retry
-     */
-    saveState(state: AnchorStoreState): void;
-    private generateId;
-    /**
-     * Create a new Anchor with automatic project and cwd tagging
-     */
-    create(input: {
-        title: string;
-        description?: string;
-        priority?: AnchorPriority;
-        durability?: AnchorDurability;
-        recurrence?: 'daily';
-        cwd?: string;
-        project?: string;
-        targetDate?: string;
-        files?: string[];
-        tags?: string[];
-        verifyCommand?: string;
-        decay?: AnchorDecayPolicy;
-    }): Anchor;
-    private findAnchorIndex;
-    /**
-     * Get an anchor by ID (supports 'anc-1', '#anc-1', '1', '01')
-     */
-    get(id: string): Anchor | undefined;
-    /**
-     * List anchors. By default, if cwd is provided, only returns anchors
-     * belonging to this cwd or marked as global (''). Pass all: true for global view.
-     */
-    list(filter?: {
-        status?: AnchorStatus;
-        priority?: AnchorPriority;
-        cwd?: string;
-        all?: boolean;
-        now?: number;
-    }): Anchor[];
-    /**
-     * Update an existing anchor
-     */
-    update(id: string, patch: Partial<Omit<Anchor, 'id' | 'createdAt'>>): Anchor;
-    /**
-     * Touch an anchor to refresh its decay window and reactivate sleeping state
-     */
-    touch(id: string, timestamp?: number): Anchor;
-    /**
-     * Settle an anchor (recurring daily habits complete for today and wake up tomorrow)
-     */
-    settle(id: string, evidence?: AnchorEvidence, now?: number): Anchor;
-    /**
-     * Reverse/undo the last settled anchor, popping it from archive.jsonl back into state.json
-     */
-    undoSettle(): Anchor;
-    /**
-     * Evict anchor to graveyard.jsonl upon total decay expiry
-     */
-    dropToGraveyard(id: string, reason: string): Anchor;
-    getArchive(filter?: {
-        cwd?: string;
-        all?: boolean;
-    }): Anchor[];
-    getGraveyard(filter?: {
-        cwd?: string;
-        all?: boolean;
-    }): Anchor[];
-}
-
 interface DecayEvaluation {
     currentStatus: AnchorStatus;
     nextStatus: AnchorStatus;
@@ -451,4 +245,4 @@ declare class AnchorProtocol {
     };
 }
 
-export { type AgentAdapter, type Anchor, type AnchorDecayPolicy, type AnchorDurability, type AnchorEvidence, type AnchorPriority, AnchorProtocol, type AnchorQuadrant, type AnchorStatus, AnchorStore, type AnchorStoreState, COMMENT_FORMATS, DEFAULT_DECAY_POLICY, DURABLE_DECAY_POLICY, type DecayEvaluation, EPHEMERAL_DECAY_POLICY, type GroupedAnchors, SessionTouchObserver, type SettlementProposal, type SweepResult, type TouchMatchResult, acquireSyncLock, atomicRenameWithRetry, classifyAnchor, detectDurability, detectRecurrence, detectTargetDate, evaluateAnchorDecay, findMatchedAnchors, formatCreationTime, formatOrigin, formatRelativeTime, formatRemainingTtl, formatSettlementCard, formatTargetDate, generateSettlementProposals, getDefaultStorageDir, getDisplayWidth, getEphemeralDecayPolicy, getTodayDateString, globToRegExp, groupAnchorsByQuadrant, hasActiveUI, isSameOrSubPath, makeSafeTaskAnnotation, matchAnchorAgainstTouchedFiles, normalizePath, openAnchorDashboard, padToWidth, renderActiveAnchorsContext, renderColdStartAnchorsContext, runPhysicalVerification, stripAnsi, sweepStore, truncateToWidth, updateAnchorStatusBar, updateStartupBanner };
+export { type AgentAdapter, Anchor, AnchorProtocol, type AnchorQuadrant, AnchorStatus, AnchorStore, COMMENT_FORMATS, type DecayEvaluation, type GroupedAnchors, SessionTouchObserver, SettlementProposal, type SweepResult, TouchMatchResult, classifyAnchor, evaluateAnchorDecay, findMatchedAnchors, formatCreationTime, formatOrigin, formatRelativeTime, formatRemainingTtl, formatSettlementCard, formatTargetDate, generateSettlementProposals, getDisplayWidth, globToRegExp, groupAnchorsByQuadrant, hasActiveUI, isSameOrSubPath, makeSafeTaskAnnotation, matchAnchorAgainstTouchedFiles, normalizePath, openAnchorDashboard, padToWidth, renderActiveAnchorsContext, renderColdStartAnchorsContext, runPhysicalVerification, stripAnsi, sweepStore, truncateToWidth, updateAnchorStatusBar, updateStartupBanner };