Method setPinned

src/node/services/memoryMeta.ts:181–198

(logicalKey: string, pinned: boolean)

  }

  async setPinned(logicalKey: string, pinned: boolean): Promise<void> {
    await this.mutate((entries) => {
      const current = entries[logicalKey] ?? EMPTY_ENTRY;
      if (pinned) {
        // Pinning counts as a use: it is an explicit signal the file matters,
        // and it feeds the same recency/frequency ranking as reads/writes.
        entries[logicalKey] = {
          ...current,
          pinned: true,
          accessCount: current.accessCount + 1,
          lastAccessedAt: Date.now(),
        };
      } else {
        // Unpinning preserves usage stats; mutate() drops the entry if empty.
        entries[logicalKey] = { ...current, pinned: false };
      }
    });
  }

  /** Record a use (read or write) of a memory file at the MemoryService chokepoint. */
  async recordAccess(logicalKey: string, options: { write: boolean }): Promise<void> {