@cjhyy/code-shell-core 0.6.0-rc.8 → 0.7.0-beta.1

package/dist/session/memory.d.ts

@@ -12,7 +12,11 @@
  *              auto-extracted entries (extract-memories output). LLM may
  *              only modify these through permission-gated tool calls.
  *   - dream/   The dream pipeline's workspace. The LLM is free to add /
- *              merge / delete entries here; user/ is read-only to dream.
+ *              merge / delete entries here. The dream loop may ALSO maintain
+ *              user/ entries whose origin is `auto` or `dream` (dedup/merge/
+ *              improve), but origin:`manual` user entries — things the user
+ *              explicitly asked to remember — are never touched by dream.
+ *              See dream-consolidation.ts (the origin guard at ~:240).
  *
  * MEMORY.md is the index file (one per scope).
  *
@@ -29,15 +33,20 @@
  *            panel. Keeps the global layer curated — nothing auto-lands global.
  */
 export type MemoryScope = "user" | "dream" | "pending";
+export type MemoryOrigin = "auto" | "manual" | "dream";
 export interface MemoryEntry {
+    /** Stable identity. Legacy files without frontmatter id read as legacy:<scope>:<fileName>. */
+    id?: string;
     name: string;
     description: string;
     type: "user" | "feedback" | "project" | "reference";
     content: string;
     fileName: string;
     scope: MemoryScope;
+    /** Semantic last content update time from frontmatter. */
+    updatedAt?: string;
     /** File mtime in epoch ms — drives maxAge filtering (TODO 8.1). 0 if unknown. */
-    updatedAt?: number;
+    mtimeMs?: number;
     /**
      * 固定/置顶 (feedback#18 方案 A): a pinned memory is exempt from maxAge
      * injection filtering and sorts first in the injected context. UI surfaces
@@ -49,15 +58,20 @@ export interface MemoryEntry {
      * "manual" (or absent — legacy files) = written by the user/UI. Lets the
      * UI distinguish curated memories from extractor noise.
      */
-    origin?: "auto" | "manual";
+    origin?: MemoryOrigin;
     /**
-     * Recall lifecycle (召回 TTL). `usageCount` increments each time MemoryRead
-     * hits this entry; `lastUsed` is the ISO timestamp of that last hit; `created`
-     * is set on first save and preserved across UPDATE. Drives recall-based TTL:
+     * Recall lifecycle (召回 TTL). `useCount` increments each time MemoryRead
+     * hits this entry; `lastUsedAt` is the ISO timestamp of that last hit;
+     * `createdAt` is set on first save and preserved across UPDATE. Drives recall-based TTL:
      * a `project`-type memory not read for N days is pruned. Stored in frontmatter
-     * — no SQLite. Legacy files lacking these fields read back as
-     * {usageCount:0, lastUsed/created ← mtime}, never hidden.
+     * — no SQLite. Legacy `usageCount/lastUsed/created` fields are still read and
+     * exposed through their old aliases for compatibility.
      */
+    useCount?: number;
+    updateCount?: number;
+    lastUsedAt?: string;
+    createdAt?: string;
+    /** Legacy compatibility aliases. New writes use useCount/lastUsedAt/createdAt. */
     usageCount?: number;
     lastUsed?: string;
     created?: string;
@@ -67,6 +81,15 @@ export interface MemoryEntry {
      * user store (not the current one). Absent → fall back to no-repo / global.
      */
     originProject?: string;
+    /** Global dream promotion metadata (P1). */
+    promotionKey?: string;
+    originProjects?: string[];
+    evidenceCount?: number;
+    firstSeenAt?: string;
+    lastSeenAt?: string;
+    promotionReason?: string;
+    promotionStatus?: "pending" | "rejected";
+    promotionSourceId?: string;
 }
 /**
  * Drop memories older than `maxAgeDays` (by file mtime) for context injection
@@ -75,6 +98,12 @@ export interface MemoryEntry {
  * just because we couldn't read its timestamp. Pure + testable.
  */
 export declare function filterByAge(entries: MemoryEntry[], maxAgeDays?: number, now?: number): MemoryEntry[];
+export interface SaveMemoryOptions {
+    /** False for lifecycle-only writes such as recordRecall and pin/unpin. */
+    incrementUpdateCount?: boolean;
+    /** Force provenance regardless of model/tool args. Used by origin guards. */
+    forceOrigin?: MemoryOrigin;
+}
 export interface MemoryManagerOptions {
     /** Project root path; when set, memories are scoped under projects/<hash>/memory. */
     projectDir?: string;
@@ -97,13 +126,18 @@ export declare class MemoryManager {
     getMemoryDir(): string;
     getScope(): MemoryScope;
     /**
-     * Save a memory entry. Creates the file and updates the index.
+     * Save a memory entry. New entries get a stable id and `<id>.md`; entries
+     * carrying an existing id update that file even when name changes.
      */
-    save(entry: Omit<MemoryEntry, "fileName" | "scope">): string;
+    save(entry: Omit<MemoryEntry, "fileName" | "scope">, opts?: SaveMemoryOptions): string;
     /**
      * Load all memory entries.
      */
     loadAll(): MemoryEntry[];
+    findById(id: string): MemoryEntry | undefined;
+    find(nameOrFileOrId: string): MemoryEntry | undefined;
+    isOwnedBy(entry: MemoryEntry | undefined, allowedOrigins: readonly MemoryOrigin[]): boolean;
+    deleteIfOwned(nameOrFileOrId: string, allowedOrigins: readonly MemoryOrigin[]): "deleted" | "not_found" | "protected";
     /**
      * Load a single memory file.
      */
@@ -136,13 +170,14 @@ export declare class MemoryManager {
      */
     pruneByRecall(ttlDays: number, now?: Date): string[];
     /**
-     * Approve a pending memory: move it from the pending scope into the user scope
-     * of the SAME memory root (pending only ever exists at the global root — the
-     * approval门 only gates global writes). Must be called on a pending-scope
-     * manager. Returns the new user filename, or null if not found / wrong scope.
+     * Approve a pending memory: move it from the pending scope into the global
+     * dream scope of the SAME memory root. Pending only ever exists at the global
+     * root; approval gates whether a suggested global dream becomes injected.
+     * Must be called on a pending-scope manager. Returns the new global dream
+     * filename, or null if not found / wrong scope.
      *
-     * 审批门 (用户拍板): the only path that moves an auto-extracted memory into the
-     * curated, injected global user store.
+     * 审批门 (用户拍板): the only path that moves a suggested global dream into the
+     * injected global dream store.
      */
     approvePending(nameOrFile: string): string | null;
     /**
@@ -150,7 +185,12 @@ export declare class MemoryManager {
      * user store (originProject)。无 originProject 时落全局 user(兜底,不丢)。
      */
     demotePending(nameOrFile: string): string | null;
-    /** Shared move for approve(→global user)/demote(→origin-project user). */
+    /**
+     * Reject a pending global-dream suggestion. The project dream entry stays in
+     * place, but is marked so the same source is not suggested again.
+     */
+    rejectPending(nameOrFile: string): boolean;
+    /** Shared move for approve(→global dream)/demote(→origin-project user). */
     private movePending;
     /**
      * Promote a project-level user memory to the GLOBAL user store (用户手动点
@@ -214,5 +254,8 @@ export declare class MemoryManager {
      */
     private ensureIndexCache;
     private writeIndex;
-    private slugify;
+    private generateId;
+    private availableFileNameForId;
+    private fileNameForId;
+    private parseSyntheticLegacyId;
 }