pi-anchor 0.3.0 → 0.4.0

package/dist/store-t2_TDhJn.d.cts

@@ -1,210 +0,0 @@
-/**
- * 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.
- * Note: graveyardDays is always 9999 so unfinished tasks are NEVER silently deleted.
- */
-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[];
-}
-
-export { AnchorStore as A, DEFAULT_DECAY_POLICY as D, EPHEMERAL_DECAY_POLICY as E, type SettlementProposal as S, type TouchMatchResult as T, type AnchorStatus as a, type Anchor as b, type AnchorDecayPolicy as c, type AnchorDurability as d, type AnchorEvidence as e, type AnchorPriority as f, type AnchorStoreState as g, DURABLE_DECAY_POLICY as h, acquireSyncLock as i, atomicRenameWithRetry as j, detectDurability as k, detectRecurrence as l, detectTargetDate as m, getDefaultStorageDir as n, getEphemeralDecayPolicy as o, getTodayDateString as p };

package/dist/store-t2_TDhJn.d.ts

@@ -1,210 +0,0 @@
-/**
- * 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.
- * Note: graveyardDays is always 9999 so unfinished tasks are NEVER silently deleted.
- */
-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[];
-}
-
-export { AnchorStore as A, DEFAULT_DECAY_POLICY as D, EPHEMERAL_DECAY_POLICY as E, type SettlementProposal as S, type TouchMatchResult as T, type AnchorStatus as a, type Anchor as b, type AnchorDecayPolicy as c, type AnchorDurability as d, type AnchorEvidence as e, type AnchorPriority as f, type AnchorStoreState as g, DURABLE_DECAY_POLICY as h, acquireSyncLock as i, atomicRenameWithRetry as j, detectDurability as k, detectRecurrence as l, detectTargetDate as m, getDefaultStorageDir as n, getEphemeralDecayPolicy as o, getTodayDateString as p };

package/src/context_injector.ts

@@ -1,166 +0,0 @@
-import type { AnchorStore } from './store.ts';
-import type { Anchor } from './types.ts';
-import { sweepStore } from './decay.ts';
-import { getTodayDateString } from './store.ts';
-import path from 'node:path';
-
-/**
- * Universal multi-language comment generator.
- * Maps file extension to safe comment syntax.
- * Formats that do not safely support comments (e.g. .json, .env, binary) return null.
- */
-export const COMMENT_FORMATS: Record<string, (msg: string) => string> = {
-  // Double slash //
-  '.ts': m => `// ${m}`,
-  '.tsx': m => `// ${m}`,
-  '.js': m => `// ${m}`,
-  '.jsx': m => `// ${m}`,
-  '.mjs': m => `// ${m}`,
-  '.cjs': m => `// ${m}`,
-  '.java': m => `// ${m}`,
-  '.kt': m => `// ${m}`,
-  '.swift': m => `// ${m}`,
-  '.go': m => `// ${m}`,
-  '.rs': m => `// ${m}`,
-  '.c': m => `// ${m}`,
-  '.cpp': m => `// ${m}`,
-  '.h': m => `// ${m}`,
-  '.hpp': m => `// ${m}`,
-  '.cs': m => `// ${m}`,
-  '.dart': m => `// ${m}`,
-  '.scala': m => `// ${m}`,
-  '.zig': m => `// ${m}`,
-  '.proto': m => `// ${m}`,
-
-  // Hash #
-  '.py': m => `# ${m}`,
-  '.rb': m => `# ${m}`,
-  '.sh': m => `# ${m}`,
-  '.bash': m => `# ${m}`,
-  '.zsh': m => `# ${m}`,
-  '.yaml': m => `# ${m}`,
-  '.yml': m => `# ${m}`,
-  '.toml': m => `# ${m}`,
-  '.conf': m => `# ${m}`,
-  '.dockerfile': m => `# ${m}`,
-  '.ps1': m => `# ${m}`,
-  '.r': m => `# ${m}`,
-
-  // HTML / XML <!-- -->
-  '.html': m => `<!-- ${m} -->`,
-  '.xml': m => `<!-- ${m} -->`,
-  '.svg': m => `<!-- ${m} -->`,
-  '.vue': m => `<!-- ${m} -->`,
-  '.svelte': m => `<!-- ${m} -->`,
-
-  // Block comment /* */
-  '.css': m => `/* ${m} */`,
-  '.scss': m => `/* ${m} */`,
-  '.less': m => `/* ${m} */`,
-
-  // SQL / Lua / Haskell --
-  '.sql': m => `-- ${m}`,
-  '.lua': m => `-- ${m}`,
-  '.hs': m => `-- ${m}`,
-
-  // Batch REM
-  '.bat': m => `REM ${m}`,
-  '.cmd': m => `REM ${m}`,
-};
-
-/**
- * Format safe task context comment for a specific file.
- * Returns null for formats that do not safely support comments (e.g. .json, .env, .lock)
- */
-export function makeSafeTaskAnnotation(filePath: string, anchor: Anchor): string | null {
-  const ext = path.extname(filePath).toLowerCase();
-  const formatter = COMMENT_FORMATS[ext];
-  if (!formatter) {
-    return null;
-  }
-  return '\n\n' + formatter(`⌖ anchor context: #${anchor.id} ${anchor.title} (${anchor.priority.toUpperCase()})`);
-}
-
-/**
- * Render ultra-compact cold-start context block for session turn 1.
- * Only active anchors for the current project context are injected.
- * From turn 2 onwards, this returns empty string (0 tokens).
- */
-export function renderColdStartAnchorsContext(
-  store: AnchorStore,
-  cwdOrNow?: string | number,
-  nowArg?: number,
-  preflightFailures?: Map<string, string>
-): string {
-  let cwd: string | undefined;
-  let now = Date.now();
-
-  if (typeof cwdOrNow === 'number') {
-    now = cwdOrNow;
-  } else if (typeof cwdOrNow === 'string') {
-    cwd = cwdOrNow;
-  }
-  if (typeof nowArg === 'number') {
-    now = nowArg;
-  }
-
-  // 1. Run opportunistic sweep to ensure expired anchors don't leak into context
-  sweepStore(store, now);
-
-  // 2. Fetch only 'active' anchors scoped to the current cwd
-  const activeAnchors = store.list({ status: 'active', cwd });
-  if (activeAnchors.length === 0) {
-    return '';
-  }
-
-  const lines = activeAnchors.map(a => {
-    const fileHint = a.files.length > 0 ? ` (${a.files.slice(0, 2).join(', ')})` : '';
-    const tagHint = a.tags.length > 0 ? ` [${a.tags.join(', ')}]` : '';
-    const projHint = a.cwd ? `[${a.project}]` : '[global]';
-
-    // Target cadence hint
-    let targetHint = '';
-    if (a.recurrence === 'daily') {
-      targetHint = ' [今日循环·Daily]';
-    } else if (a.targetDate) {
-      const todayStr = getTodayDateString(now);
-      if (a.targetDate === todayStr) {
-        targetHint = ' [今日聚焦·Due Today]';
-      } else if (a.targetDate < todayStr) {
-        targetHint = ' [已逾期·Overdue]';
-      } else {
-        targetHint = ` [排期:${a.targetDate}]`;
-      }
-    } else {
-      targetHint = ' [长期愿景·Someday]';
-    }
-
-    const ageDays = Math.floor((now - a.createdAt) / (24 * 60 * 60 * 1000));
-    const ageHint = ageDays > 0 ? ` (${ageDays}d old)` : '';
-
-    const failureSnippet = preflightFailures?.get(a.id);
-    const verifyHint = failureSnippet
-      ? ` [⚡ 物理验证失败: ${failureSnippet.replace(/\s+/g, ' ').slice(-100)}]`
-      : a.verifyCommand
-        ? ` [verify: ${a.verifyCommand}]`
-        : '';
-
-    return `• #${a.id} ${projHint}${targetHint} [${a.priority.toUpperCase()}] ${a.title}${verifyHint}${ageHint}${tagHint}${fileHint}`;
-  });
-
-  return [
-    `<active-anchors count="${activeAnchors.length}">`,
-    `Unfinished cross-session commitments from previous sessions:`,
-    lines.join('\n'),
-    ``,
-    `CONVERSATIONAL PROTOCOL (HUMAN PARTNER TONE):`,
-    `- If the user opens the session with a casual greeting or continuation ("hi", "在吗", "继续", "早上好"), naturally prioritize items tagged [今日聚焦·Due Today] in a friendly assistant tone (e.g. "嗨！今天规划的【...】现在处理还是看别的？").`,
-    `- If an anchor has [⚡ 物理验证失败], its verifyCommand failed on session start. Target the failing assertion directly.`,
-    `- If the user issues a direct, concrete new instruction (e.g. "帮我查下这个报错"), DO NOT interrupt their flow. Focus directly on their instruction.`,
-    `- When a commitment is satisfied during work, automatically call anchor(action="settle", id=...) to clear it.`,
-    `</active-anchors>`
-  ].join('\n');
-}
-
-/** Legacy alias for backwards compatibility */
-export const renderActiveAnchorsContext = renderColdStartAnchorsContext;