@cortexkit/opencode-magic-context 0.6.2 → 0.7.0

package/README.md

@@ -45,6 +45,8 @@ Your agent should never stop working to manage its own context. Magic Context is
 
 **User Memories** — historian extracts behavioral observations about you alongside its normal compartment output (communication style, expertise level, review focus, working patterns). Recurring observations are promoted by the dreamer to stable user memories that appear in all sessions via `<user-profile>`. Enable with `experimental.user_memories.enabled: true` (requires dreamer).
 
+**Key File Pinning** — dreamer analyzes which files your agent reads most frequently across the session. Core orientation files (architecture, config, types) that get re-read after every context drop are pinned into the system prompt as `<key-files>`, so the agent always has them without needing to re-read from disk. Files are read fresh on each cache-busting pass. Enable with `experimental.pin_key_files.enabled: true` (requires dreamer).
+
 ---
 
 ## Get Started

package/dist/config/schema/magic-context.d.ts

@@ -195,6 +195,13 @@ export interface MagicContextConfig {
             enabled: boolean;
             promotion_threshold: number;
         };
+        pin_key_files: {
+            enabled: boolean;
+            /** Total token budget for all pinned key files (default: 10000) */
+            token_budget: number;
+            /** Minimum full-read count before a file is considered for pinning (default: 4) */
+            min_reads: number;
+        };
     };
     embedding: EmbeddingConfig;
     memory: {
@@ -370,6 +377,11 @@ export declare const MagicContextConfigSchema: z.ZodPipe<z.ZodObject<{
             enabled: z.ZodDefault<z.ZodBoolean>;
             promotion_threshold: z.ZodDefault<z.ZodNumber>;
         }, z.core.$strip>>;
+        pin_key_files: z.ZodDefault<z.ZodObject<{
+            enabled: z.ZodDefault<z.ZodBoolean>;
+            token_budget: z.ZodDefault<z.ZodNumber>;
+            min_reads: z.ZodDefault<z.ZodNumber>;
+        }, z.core.$strip>>;
     }, z.core.$strip>>;
     memory: z.ZodDefault<z.ZodObject<{
         enabled: z.ZodDefault<z.ZodBoolean>;
@@ -470,6 +482,11 @@ export declare const MagicContextConfigSchema: z.ZodPipe<z.ZodObject<{
             enabled: boolean;
             promotion_threshold: number;
         };
+        pin_key_files: {
+            enabled: boolean;
+            token_budget: number;
+            min_reads: number;
+        };
     };
     memory: {
         enabled: boolean;

package/dist/config/schema/magic-context.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"magic-context.d.ts","sourceRoot":"","sources":["../../../src/config/schema/magic-context.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"magic-context.d.ts","sourceRoot":"","sources":["../../../src/config/schema/magic-context.ts"],"names":[],"mappings":"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"}

package/dist/features/magic-context/dreamer/runner.d.ts

@@ -1,6 +1,11 @@
-import type { Database } from "bun:sqlite";
+import { Database } from "bun:sqlite";
 import type { DreamingTask } from "../../../config/schema/magic-context";
 import type { PluginContext } from "../../../plugin/types";
+interface ExperimentalPinKeyFilesConfig {
+    enabled: boolean;
+    token_budget: number;
+    min_reads: number;
+}
 export declare function registerDreamProjectDirectory(projectIdentity: string, directory: string): void;
 export interface DreamRunResult {
     startedAt: number;
@@ -29,6 +34,7 @@ export declare function runDream(args: {
         enabled: boolean;
         promotionThreshold: number;
     };
+    experimentalPinKeyFiles?: ExperimentalPinKeyFilesConfig;
 }): Promise<DreamRunResult>;
 export declare function processDreamQueue(args: {
     db: Database;
@@ -40,5 +46,7 @@ export declare function processDreamQueue(args: {
         enabled: boolean;
         promotionThreshold: number;
     };
+    experimentalPinKeyFiles?: ExperimentalPinKeyFilesConfig;
 }): Promise<DreamRunResult | null>;
+export {};
 //# sourceMappingURL=runner.d.ts.map

package/dist/features/magic-context/dreamer/runner.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"runner.d.ts","sourceRoot":"","sources":["../../../../src/features/magic-context/dreamer/runner.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,YAAY,CAAC;AAI3C,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,sCAAsC,CAAC;AACzE,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,uBAAuB,CAAC;AAyB3D,wBAAgB,6BAA6B,CAAC,eAAe,EAAE,MAAM,EAAE,SAAS,EAAE,MAAM,GAAG,IAAI,CAE9F;AAMD,MAAM,WAAW,cAAc;IAC3B,SAAS,EAAE,MAAM,CAAC;IAClB,UAAU,EAAE,MAAM,CAAC;IACnB,QAAQ,EAAE,MAAM,CAAC;IACjB,kBAAkB,EAAE,MAAM,CAAC;IAC3B,iBAAiB,EAAE,MAAM,CAAC;IAC1B,KAAK,EAAE;QACH,IAAI,EAAE,MAAM,CAAC;QACb,UAAU,EAAE,MAAM,CAAC;QACnB,MAAM,EAAE,OAAO,CAAC;QAChB,KAAK,CAAC,EAAE,MAAM,CAAC;KAClB,EAAE,CAAC;CACP;AAaD,wBAAsB,QAAQ,CAAC,IAAI,EAAE;IACjC,EAAE,EAAE,QAAQ,CAAC;IACb,MAAM,EAAE,aAAa,CAAC,QAAQ,CAAC,CAAC;IAChC,6FAA6F;IAC7F,eAAe,EAAE,MAAM,CAAC;IACxB,KAAK,EAAE,YAAY,EAAE,CAAC;IACtB,kBAAkB,EAAE,MAAM,CAAC;IAC3B,iBAAiB,EAAE,MAAM,CAAC;IAC1B,eAAe,CAAC,EAAE,MAAM,CAAC;IACzB,gBAAgB,CAAC,EAAE,MAAM,CAAC;IAC1B,wBAAwB,CAAC,EAAE;QAAE,OAAO,EAAE,OAAO,CAAC;QAAC,kBAAkB,EAAE,MAAM,CAAA;KAAE,CAAC;CAC/E,GAAG,OAAO,CAAC,cAAc,CAAC,CA8R1B;AA0LD,wBAAsB,iBAAiB,CAAC,IAAI,EAAE;IAC1C,EAAE,EAAE,QAAQ,CAAC;IACb,MAAM,EAAE,aAAa,CAAC,QAAQ,CAAC,CAAC;IAChC,KAAK,EAAE,YAAY,EAAE,CAAC;IACtB,kBAAkB,EAAE,MAAM,CAAC;IAC3B,iBAAiB,EAAE,MAAM,CAAC;IAC1B,wBAAwB,CAAC,EAAE;QAAE,OAAO,EAAE,OAAO,CAAC;QAAC,kBAAkB,EAAE,MAAM,CAAA;KAAE,CAAC;CAC/E,GAAG,OAAO,CAAC,cAAc,GAAG,IAAI,CAAC,CAwDjC"}
+{"version":3,"file":"runner.d.ts","sourceRoot":"","sources":["../../../../src/features/magic-context/dreamer/runner.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,QAAQ,EAAE,MAAM,YAAY,CAAC;AAItC,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,sCAAsC,CAAC;AACzE,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,uBAAuB,CAAC;AA0C3D,UAAU,6BAA6B;IACnC,OAAO,EAAE,OAAO,CAAC;IACjB,YAAY,EAAE,MAAM,CAAC;IACrB,SAAS,EAAE,MAAM,CAAC;CACrB;AAED,wBAAgB,6BAA6B,CAAC,eAAe,EAAE,MAAM,EAAE,SAAS,EAAE,MAAM,GAAG,IAAI,CAE9F;AAMD,MAAM,WAAW,cAAc;IAC3B,SAAS,EAAE,MAAM,CAAC;IAClB,UAAU,EAAE,MAAM,CAAC;IACnB,QAAQ,EAAE,MAAM,CAAC;IACjB,kBAAkB,EAAE,MAAM,CAAC;IAC3B,iBAAiB,EAAE,MAAM,CAAC;IAC1B,KAAK,EAAE;QACH,IAAI,EAAE,MAAM,CAAC;QACb,UAAU,EAAE,MAAM,CAAC;QACnB,MAAM,EAAE,OAAO,CAAC;QAChB,KAAK,CAAC,EAAE,MAAM,CAAC;KAClB,EAAE,CAAC;CACP;AA6RD,wBAAsB,QAAQ,CAAC,IAAI,EAAE;IACjC,EAAE,EAAE,QAAQ,CAAC;IACb,MAAM,EAAE,aAAa,CAAC,QAAQ,CAAC,CAAC;IAChC,6FAA6F;IAC7F,eAAe,EAAE,MAAM,CAAC;IACxB,KAAK,EAAE,YAAY,EAAE,CAAC;IACtB,kBAAkB,EAAE,MAAM,CAAC;IAC3B,iBAAiB,EAAE,MAAM,CAAC;IAC1B,eAAe,CAAC,EAAE,MAAM,CAAC;IACzB,gBAAgB,CAAC,EAAE,MAAM,CAAC;IAC1B,wBAAwB,CAAC,EAAE;QAAE,OAAO,EAAE,OAAO,CAAC;QAAC,kBAAkB,EAAE,MAAM,CAAA;KAAE,CAAC;IAC5E,uBAAuB,CAAC,EAAE,6BAA6B,CAAC;CAC3D,GAAG,OAAO,CAAC,cAAc,CAAC,CA8S1B;AA0LD,wBAAsB,iBAAiB,CAAC,IAAI,EAAE;IAC1C,EAAE,EAAE,QAAQ,CAAC;IACb,MAAM,EAAE,aAAa,CAAC,QAAQ,CAAC,CAAC;IAChC,KAAK,EAAE,YAAY,EAAE,CAAC;IACtB,kBAAkB,EAAE,MAAM,CAAC;IAC3B,iBAAiB,EAAE,MAAM,CAAC;IAC1B,wBAAwB,CAAC,EAAE;QAAE,OAAO,EAAE,OAAO,CAAC;QAAC,kBAAkB,EAAE,MAAM,CAAA;KAAE,CAAC;IAC5E,uBAAuB,CAAC,EAAE,6BAA6B,CAAC;CAC3D,GAAG,OAAO,CAAC,cAAc,GAAG,IAAI,CAAC,CAyDjC"}

package/dist/features/magic-context/key-files/identify-key-files.d.ts

@@ -0,0 +1,39 @@
+import type { Database } from "bun:sqlite";
+import { type FileReadStat } from "./read-stats";
+export declare const KEY_FILES_SYSTEM_PROMPT = "You are a file importance evaluator. Given read statistics about files in a coding session, identify which are core orientation files worth pinning in context. Return a JSON array.";
+/**
+ * Build the LLM prompt for key file identification.
+ * Called from the dreamer runner which handles session creation.
+ */
+export declare function buildKeyFilesPrompt(candidates: FileReadStat[], tokenBudget: number, minReads: number): string;
+/**
+ * Parse the LLM's response into a ranked file list.
+ */
+export declare function parseKeyFilesOutput(text: string): Array<{
+    filePath: string;
+    tokens: number;
+}>;
+/**
+ * Get candidate files for key-file analysis from OpenCode's DB.
+ * Returns files with full reads >= minReads and size under half the budget.
+ */
+export declare function getKeyFileCandidates(openCodeDb: Database, sessionId: string, minReads: number, tokenBudget: number): FileReadStat[];
+/**
+ * Apply LLM-ranked results through the knapsack solver and persist.
+ */
+export declare function applyKeyFileResults(db: Database, sessionId: string, llmRanked: Array<{
+    filePath: string;
+    tokens: number;
+}>, tokenBudget: number, candidatePaths?: Set<string>): {
+    filesIdentified: number;
+    totalTokens: number;
+};
+/**
+ * Pure heuristic fallback when LLM is unavailable.
+ * Ranks by: high read count, low edit count, reasonable size.
+ */
+export declare function heuristicKeyFileSelection(db: Database, sessionId: string, candidates: FileReadStat[], tokenBudget: number): {
+    filesIdentified: number;
+    totalTokens: number;
+};
+//# sourceMappingURL=identify-key-files.d.ts.map

package/dist/features/magic-context/key-files/identify-key-files.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"identify-key-files.d.ts","sourceRoot":"","sources":["../../../../src/features/magic-context/key-files/identify-key-files.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,YAAY,CAAC;AAE3C,OAAO,EAAE,KAAK,YAAY,EAAuB,MAAM,cAAc,CAAC;AAGtE,eAAO,MAAM,uBAAuB,yLACsJ,CAAC;AAE3L;;;GAGG;AACH,wBAAgB,mBAAmB,CAC/B,UAAU,EAAE,YAAY,EAAE,EAC1B,WAAW,EAAE,MAAM,EACnB,QAAQ,EAAE,MAAM,GACjB,MAAM,CAqCR;AAED;;GAEG;AACH,wBAAgB,mBAAmB,CAAC,IAAI,EAAE,MAAM,GAAG,KAAK,CAAC;IAAE,QAAQ,EAAE,MAAM,CAAC;IAAC,MAAM,EAAE,MAAM,CAAA;CAAE,CAAC,CAqB7F;AAED;;;GAGG;AACH,wBAAgB,oBAAoB,CAChC,UAAU,EAAE,QAAQ,EACpB,SAAS,EAAE,MAAM,EACjB,QAAQ,EAAE,MAAM,EAChB,WAAW,EAAE,MAAM,GACpB,YAAY,EAAE,CAIhB;AAED;;GAEG;AACH,wBAAgB,mBAAmB,CAC/B,EAAE,EAAE,QAAQ,EACZ,SAAS,EAAE,MAAM,EACjB,SAAS,EAAE,KAAK,CAAC;IAAE,QAAQ,EAAE,MAAM,CAAC;IAAC,MAAM,EAAE,MAAM,CAAA;CAAE,CAAC,EACtD,WAAW,EAAE,MAAM,EACnB,cAAc,CAAC,EAAE,GAAG,CAAC,MAAM,CAAC,GAC7B;IAAE,eAAe,EAAE,MAAM,CAAC;IAAC,WAAW,EAAE,MAAM,CAAA;CAAE,CAelD;AAED;;;GAGG;AACH,wBAAgB,yBAAyB,CACrC,EAAE,EAAE,QAAQ,EACZ,SAAS,EAAE,MAAM,EACjB,UAAU,EAAE,YAAY,EAAE,EAC1B,WAAW,EAAE,MAAM,GACpB;IAAE,eAAe,EAAE,MAAM,CAAC;IAAC,WAAW,EAAE,MAAM,CAAA;CAAE,CAmBlD"}

package/dist/features/magic-context/key-files/read-stats.d.ts

@@ -0,0 +1,20 @@
+import type { Database } from "bun:sqlite";
+export interface FileReadStat {
+    filePath: string;
+    fullReadCount: number;
+    /** Number of distinct compartment ranges the reads span across */
+    spreadAcrossCompartments: number;
+    /** Number of times the file was edited (write/edit tool) in this session */
+    editCount: number;
+    /** Byte size of the most recent full read output */
+    latestReadBytes: number;
+    /** Approximate token count of the most recent full read (~3.5 chars per token) */
+    latestReadTokens: number;
+}
+/**
+ * Query file read patterns from OpenCode's DB for a specific session.
+ * Returns files that were fully read (no line range) at least `minReads` times,
+ * sorted by read frequency descending.
+ */
+export declare function getSessionReadStats(openCodeDb: Database, sessionId: string, minReads: number): FileReadStat[];
+//# sourceMappingURL=read-stats.d.ts.map

package/dist/features/magic-context/key-files/read-stats.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"read-stats.d.ts","sourceRoot":"","sources":["../../../../src/features/magic-context/key-files/read-stats.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,YAAY,CAAC;AAE3C,MAAM,WAAW,YAAY;IACzB,QAAQ,EAAE,MAAM,CAAC;IACjB,aAAa,EAAE,MAAM,CAAC;IACtB,kEAAkE;IAClE,wBAAwB,EAAE,MAAM,CAAC;IACjC,4EAA4E;IAC5E,SAAS,EAAE,MAAM,CAAC;IAClB,oDAAoD;IACpD,eAAe,EAAE,MAAM,CAAC;IACxB,kFAAkF;IAClF,gBAAgB,EAAE,MAAM,CAAC;CAC5B;AAED;;;;GAIG;AACH,wBAAgB,mBAAmB,CAC/B,UAAU,EAAE,QAAQ,EACpB,SAAS,EAAE,MAAM,EACjB,QAAQ,EAAE,MAAM,GACjB,YAAY,EAAE,CAgFhB"}

package/dist/features/magic-context/key-files/storage-key-files.d.ts

@@ -0,0 +1,25 @@
+import type { Database } from "bun:sqlite";
+export interface KeyFileEntry {
+    filePath: string;
+    /** Approximate token count when last pinned */
+    tokens: number;
+}
+/**
+ * Get the pinned key files for a session from session_meta.
+ * Returns empty array if not set or parse fails.
+ */
+export declare function getKeyFiles(db: Database, sessionId: string): KeyFileEntry[];
+/**
+ * Set the pinned key files for a session.
+ */
+export declare function setKeyFiles(db: Database, sessionId: string, files: KeyFileEntry[]): void;
+/**
+ * Greedy-fit files into a token budget.
+ * Takes files sorted by priority (dreamer's ranking) and greedily adds
+ * them until the budget is exhausted. Returns the selected files.
+ */
+export declare function greedyFitFiles(rankedFiles: Array<{
+    filePath: string;
+    tokens: number;
+}>, tokenBudget: number): KeyFileEntry[];
+//# sourceMappingURL=storage-key-files.d.ts.map

package/dist/features/magic-context/key-files/storage-key-files.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"storage-key-files.d.ts","sourceRoot":"","sources":["../../../../src/features/magic-context/key-files/storage-key-files.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,YAAY,CAAC;AAG3C,MAAM,WAAW,YAAY;IACzB,QAAQ,EAAE,MAAM,CAAC;IACjB,+CAA+C;IAC/C,MAAM,EAAE,MAAM,CAAC;CAClB;AAED;;;GAGG;AACH,wBAAgB,WAAW,CAAC,EAAE,EAAE,QAAQ,EAAE,SAAS,EAAE,MAAM,GAAG,YAAY,EAAE,CAqB3E;AAED;;GAEG;AACH,wBAAgB,WAAW,CAAC,EAAE,EAAE,QAAQ,EAAE,SAAS,EAAE,MAAM,EAAE,KAAK,EAAE,YAAY,EAAE,GAAG,IAAI,CAYxF;AAED;;;;GAIG;AACH,wBAAgB,cAAc,CAC1B,WAAW,EAAE,KAAK,CAAC;IAAE,QAAQ,EAAE,MAAM,CAAC;IAAC,MAAM,EAAE,MAAM,CAAA;CAAE,CAAC,EACxD,WAAW,EAAE,MAAM,GACpB,YAAY,EAAE,CAehB"}

package/dist/features/magic-context/storage-db.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"storage-db.d.ts","sourceRoot":"","sources":["../../../src/features/magic-context/storage-db.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,QAAQ,EAAE,MAAM,YAAY,CAAC;AAkBtC,wBAAgB,kBAAkB,CAAC,EAAE,EAAE,QAAQ,GAAG,IAAI,CAiRrD;AAiCD,wBAAgB,YAAY,IAAI,QAAQ,CAsCvC;AAED,wBAAgB,mBAAmB,CAAC,EAAE,EAAE,QAAQ,GAAG,OAAO,CAEzD;AAED,wBAAgB,2BAA2B,CAAC,EAAE,EAAE,QAAQ,GAAG,MAAM,GAAG,IAAI,CAEvE;AAED,wBAAgB,aAAa,IAAI,IAAI,CAUpC;AAED,MAAM,MAAM,eAAe,GAAG,UAAU,CAAC,OAAO,YAAY,CAAC,CAAC"}
+{"version":3,"file":"storage-db.d.ts","sourceRoot":"","sources":["../../../src/features/magic-context/storage-db.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,QAAQ,EAAE,MAAM,YAAY,CAAC;AAkBtC,wBAAgB,kBAAkB,CAAC,EAAE,EAAE,QAAQ,GAAG,IAAI,CAkRrD;AAiCD,wBAAgB,YAAY,IAAI,QAAQ,CAsCvC;AAED,wBAAgB,mBAAmB,CAAC,EAAE,EAAE,QAAQ,GAAG,OAAO,CAEzD;AAED,wBAAgB,2BAA2B,CAAC,EAAE,EAAE,QAAQ,GAAG,MAAM,GAAG,IAAI,CAEvE;AAED,wBAAgB,aAAa,IAAI,IAAI,CAUpC;AAED,MAAM,MAAM,eAAe,GAAG,UAAU,CAAC,OAAO,YAAY,CAAC,CAAC"}

package/dist/hooks/magic-context/command-handler.d.ts

@@ -47,6 +47,11 @@ export declare function createMagicContextCommandHandler(deps: {
             enabled: boolean;
             promotionThreshold: number;
         };
+        experimentalPinKeyFiles?: {
+            enabled: boolean;
+            token_budget: number;
+            min_reads: number;
+        };
     };
 }): {
     "command.execute.before": (input: CommandExecuteInput, _output: CommandExecuteOutput, _params: NotificationParams) => Promise<void>;

package/dist/hooks/magic-context/command-handler.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"command-handler.d.ts","sourceRoot":"","sources":["../../../src/hooks/magic-context/command-handler.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,YAAY,CAAC;AAC3C,OAAO,KAAK,EAAE,aAAa,EAAE,cAAc,EAAE,MAAM,mCAAmC,CAAC;AACvF,OAAO,EACH,KAAK,cAAc,EAGtB,MAAM,sCAAsC,CAAC;AAG9C,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,oBAAoB,CAAC;AAIxD,OAAO,KAAK,EAAE,kBAAkB,EAAE,MAAM,6BAA6B,CAAC;AAOtE,MAAM,WAAW,mBAAmB;IAChC,OAAO,EAAE,MAAM,CAAC;IAChB,SAAS,EAAE,MAAM,CAAC;IAClB,SAAS,EAAE,MAAM,CAAC;CACrB;AAED,MAAM,WAAW,oBAAoB;IACjC,KAAK,EAAE,KAAK,CAAC;QAAE,IAAI,EAAE,MAAM,CAAC;QAAC,IAAI,CAAC,EAAE,MAAM,CAAA;KAAE,CAAC,CAAC;CACjD;AA8JD,wBAAgB,gCAAgC,CAAC,IAAI,EAAE;IACnD,EAAE,EAAE,QAAQ,CAAC;IACb,aAAa,EAAE,MAAM,CAAC;IACtB,mBAAmB,CAAC,EAAE,MAAM,CAAC;IAC7B,0BAA0B,CAAC,EAAE,MAAM,GAAG;QAAE,OAAO,EAAE,MAAM,CAAC;QAAC,CAAC,QAAQ,EAAE,MAAM,GAAG,MAAM,CAAA;KAAE,CAAC;IACtF,uBAAuB,CAAC,EAAE,MAAM,CAAC;IACjC,oBAAoB,CAAC,EAAE;QAAE,OAAO,EAAE,OAAO,CAAC;QAAC,YAAY,EAAE,MAAM,CAAA;KAAE,CAAC;IAClE,eAAe,CAAC,EAAE,CAAC,SAAS,EAAE,MAAM,KAAK,MAAM,GAAG,SAAS,CAAC;IAC5D,OAAO,CAAC,EAAE,CAAC,SAAS,EAAE,MAAM,KAAK,IAAI,CAAC;IACtC,aAAa,CAAC,EAAE,CAAC,SAAS,EAAE,MAAM,KAAK,OAAO,CAAC,MAAM,CAAC,CAAC;IACvD,gBAAgB,EAAE,CACd,SAAS,EAAE,MAAM,EACjB,IAAI,EAAE,MAAM,EACZ,MAAM,EAAE,kBAAkB,KACzB,OAAO,CAAC,IAAI,CAAC,CAAC;IACnB,QAAQ,CAAC,EAAE;QACP,MAAM,EAAE,cAAc,CAAC;QACvB,WAAW,EAAE,MAAM,CAAC;QACpB,gBAAgB,CAAC,EAAE,MAAM,CAAC;QAC1B,MAAM,EAAE,aAAa,CAAC,QAAQ,CAAC,CAAC;KACnC,CAAC;IACF,OAAO,CAAC,EAAE;QACN,MAAM,EAAE,aAAa,CAAC;QACtB,WAAW,EAAE,MAAM,CAAC;QACpB,MAAM,EAAE,OAAO,CAAC;QAChB,SAAS,EAAE,MAAM,CAAC;QAClB,YAAY,CAAC,EAAE,CAAC,SAAS,EAAE,MAAM,KAAK,OAAO,CAAC,cAAc,GAAG,IAAI,CAAC,CAAC;QACrE,wBAAwB,CAAC,EAAE;YAAE,OAAO,EAAE,OAAO,CAAC;YAAC,kBAAkB,EAAE,MAAM,CAAA;SAAE,CAAC;KAC/E,CAAC;CACL;sCASkB,mBAAmB,WACjB,oBAAoB,WACpB,kBAAkB,KAC5B,OAAO,CAAC,IAAI,CAAC;EAoGvB"}
+{"version":3,"file":"command-handler.d.ts","sourceRoot":"","sources":["../../../src/hooks/magic-context/command-handler.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,YAAY,CAAC;AAC3C,OAAO,KAAK,EAAE,aAAa,EAAE,cAAc,EAAE,MAAM,mCAAmC,CAAC;AACvF,OAAO,EACH,KAAK,cAAc,EAGtB,MAAM,sCAAsC,CAAC;AAG9C,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,oBAAoB,CAAC;AAIxD,OAAO,KAAK,EAAE,kBAAkB,EAAE,MAAM,6BAA6B,CAAC;AAOtE,MAAM,WAAW,mBAAmB;IAChC,OAAO,EAAE,MAAM,CAAC;IAChB,SAAS,EAAE,MAAM,CAAC;IAClB,SAAS,EAAE,MAAM,CAAC;CACrB;AAED,MAAM,WAAW,oBAAoB;IACjC,KAAK,EAAE,KAAK,CAAC;QAAE,IAAI,EAAE,MAAM,CAAC;QAAC,IAAI,CAAC,EAAE,MAAM,CAAA;KAAE,CAAC,CAAC;CACjD;AAoKD,wBAAgB,gCAAgC,CAAC,IAAI,EAAE;IACnD,EAAE,EAAE,QAAQ,CAAC;IACb,aAAa,EAAE,MAAM,CAAC;IACtB,mBAAmB,CAAC,EAAE,MAAM,CAAC;IAC7B,0BAA0B,CAAC,EAAE,MAAM,GAAG;QAAE,OAAO,EAAE,MAAM,CAAC;QAAC,CAAC,QAAQ,EAAE,MAAM,GAAG,MAAM,CAAA;KAAE,CAAC;IACtF,uBAAuB,CAAC,EAAE,MAAM,CAAC;IACjC,oBAAoB,CAAC,EAAE;QAAE,OAAO,EAAE,OAAO,CAAC;QAAC,YAAY,EAAE,MAAM,CAAA;KAAE,CAAC;IAClE,eAAe,CAAC,EAAE,CAAC,SAAS,EAAE,MAAM,KAAK,MAAM,GAAG,SAAS,CAAC;IAC5D,OAAO,CAAC,EAAE,CAAC,SAAS,EAAE,MAAM,KAAK,IAAI,CAAC;IACtC,aAAa,CAAC,EAAE,CAAC,SAAS,EAAE,MAAM,KAAK,OAAO,CAAC,MAAM,CAAC,CAAC;IACvD,gBAAgB,EAAE,CACd,SAAS,EAAE,MAAM,EACjB,IAAI,EAAE,MAAM,EACZ,MAAM,EAAE,kBAAkB,KACzB,OAAO,CAAC,IAAI,CAAC,CAAC;IACnB,QAAQ,CAAC,EAAE;QACP,MAAM,EAAE,cAAc,CAAC;QACvB,WAAW,EAAE,MAAM,CAAC;QACpB,gBAAgB,CAAC,EAAE,MAAM,CAAC;QAC1B,MAAM,EAAE,aAAa,CAAC,QAAQ,CAAC,CAAC;KACnC,CAAC;IACF,OAAO,CAAC,EAAE;QACN,MAAM,EAAE,aAAa,CAAC;QACtB,WAAW,EAAE,MAAM,CAAC;QACpB,MAAM,EAAE,OAAO,CAAC;QAChB,SAAS,EAAE,MAAM,CAAC;QAClB,YAAY,CAAC,EAAE,CAAC,SAAS,EAAE,MAAM,KAAK,OAAO,CAAC,cAAc,GAAG,IAAI,CAAC,CAAC;QACrE,wBAAwB,CAAC,EAAE;YAAE,OAAO,EAAE,OAAO,CAAC;YAAC,kBAAkB,EAAE,MAAM,CAAA;SAAE,CAAC;QAC5E,uBAAuB,CAAC,EAAE;YACtB,OAAO,EAAE,OAAO,CAAC;YACjB,YAAY,EAAE,MAAM,CAAC;YACrB,SAAS,EAAE,MAAM,CAAC;SACrB,CAAC;KACL,CAAC;CACL;sCASkB,mBAAmB,WACjB,oBAAoB,WACpB,kBAAkB,KAC5B,OAAO,CAAC,IAAI,CAAC;EAoGvB"}

package/dist/hooks/magic-context/hook.d.ts

@@ -43,6 +43,11 @@ export interface MagicContextDeps {
                 enabled: boolean;
                 promotion_threshold: number;
             };
+            pin_key_files?: {
+                enabled: boolean;
+                token_budget: number;
+                min_reads: number;
+            };
         };
     };
 }

package/dist/hooks/magic-context/hook.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"hook.d.ts","sourceRoot":"","sources":["../../../src/hooks/magic-context/hook.ts"],"names":[],"mappings":"AAAA,OAAO,EAIH,KAAK,aAAa,EAClB,KAAK,cAAc,EACtB,MAAM,mCAAmC,CAAC;AAC3C,OAAO,KAAK,EAAE,uBAAuB,EAAE,MAAM,yCAAyC,CAAC;AAOvF,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,wCAAwC,CAAC;AAMxE,OAAO,KAAK,EAAE,MAAM,EAAE,MAAM,qCAAqC,CAAC;AAElE,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,oBAAoB,CAAC;AAWxD,YAAY,EAAE,mBAAmB,EAAE,oBAAoB,EAAE,MAAM,mBAAmB,CAAC;AAiBnF,MAAM,WAAW,gBAAgB;IAC7B,MAAM,EAAE,aAAa,CAAC,QAAQ,CAAC,CAAC;IAChC,SAAS,EAAE,MAAM,CAAC;IAClB,MAAM,EAAE,MAAM,CAAC;IACf,SAAS,EAAE,SAAS,CAAC;IACrB,yBAAyB,CAAC,EAAE,CAAC,SAAS,EAAE,MAAM,KAAK,IAAI,CAAC;IACxD,iBAAiB,EAAE,UAAU,CAAC,OAAO,uBAAuB,CAAC,CAAC;IAC9D,MAAM,EAAE;QACJ,cAAc,EAAE,MAAM,CAAC;QACvB,kBAAkB,CAAC,EAAE,OAAO,CAAC;QAC7B,qBAAqB,CAAC,EAAE,MAAM,CAAC;QAC/B,kBAAkB,CAAC,EAAE,MAAM,CAAC;QAC5B,mBAAmB,CAAC,EAAE,MAAM,CAAC;QAC7B,yBAAyB,CAAC,EAAE,MAAM,CAAC;QACnC,4BAA4B,CAAC,EAAE,MAAM,GAAG;YAAE,OAAO,EAAE,MAAM,CAAC;YAAC,CAAC,QAAQ,EAAE,MAAM,GAAG,MAAM,CAAA;SAAE,CAAC;QACxF,SAAS,EAAE,MAAM,GAAG,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;QAC3C,uBAAuB,CAAC,EAAE,GAAG,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;QAE9C,wBAAwB,CAAC,EAAE,MAAM,CAAC;QAClC,yBAAyB,CAAC,EAAE,MAAM,CAAC;QACnC,oBAAoB,CAAC,EAAE,MAAM,CAAC;QAC9B,MAAM,CAAC,EAAE;YACL,OAAO,EAAE,OAAO,CAAC;YACjB,uBAAuB,EAAE,MAAM,CAAC;SACnC,CAAC;QACF,QAAQ,CAAC,EAAE,cAAc,CAAC;QAC1B,OAAO,CAAC,EAAE,aAAa,CAAC;QACxB,sBAAsB,CAAC,EAAE;YAAE,OAAO,EAAE,OAAO,CAAC;YAAC,YAAY,EAAE,MAAM,CAAA;SAAE,CAAC;QACpE,YAAY,CAAC,EAAE;YACX,kBAAkB,CAAC,EAAE,OAAO,CAAC;YAC7B,aAAa,CAAC,EAAE;gBAAE,OAAO,EAAE,OAAO,CAAC;gBAAC,mBAAmB,EAAE,MAAM,CAAA;aAAE,CAAC;SACrE,CAAC;KACL,CAAC;CACL;AAqCD,wBAAgB,sBAAsB,CAAC,IAAI,EAAE,gBAAgB;;;;;iBAtDtC,CAAC;;;;;;;;;;;;iBAbpB,CAAA;eACA,CAAF;;mBA2S2B;QAAE,KAAK,EAAE;YAAE,IAAI,EAAE,MAAM,CAAC;YAAC,UAAU,CAAC,EAAE,OAAO,CAAA;SAAE,CAAA;KAAE;;;SAa7E"}
+{"version":3,"file":"hook.d.ts","sourceRoot":"","sources":["../../../src/hooks/magic-context/hook.ts"],"names":[],"mappings":"AAAA,OAAO,EAIH,KAAK,aAAa,EAClB,KAAK,cAAc,EACtB,MAAM,mCAAmC,CAAC;AAC3C,OAAO,KAAK,EAAE,uBAAuB,EAAE,MAAM,yCAAyC,CAAC;AAOvF,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,wCAAwC,CAAC;AAMxE,OAAO,KAAK,EAAE,MAAM,EAAE,MAAM,qCAAqC,CAAC;AAElE,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,oBAAoB,CAAC;AAWxD,YAAY,EAAE,mBAAmB,EAAE,oBAAoB,EAAE,MAAM,mBAAmB,CAAC;AAiBnF,MAAM,WAAW,gBAAgB;IAC7B,MAAM,EAAE,aAAa,CAAC,QAAQ,CAAC,CAAC;IAChC,SAAS,EAAE,MAAM,CAAC;IAClB,MAAM,EAAE,MAAM,CAAC;IACf,SAAS,EAAE,SAAS,CAAC;IACrB,yBAAyB,CAAC,EAAE,CAAC,SAAS,EAAE,MAAM,KAAK,IAAI,CAAC;IACxD,iBAAiB,EAAE,UAAU,CAAC,OAAO,uBAAuB,CAAC,CAAC;IAC9D,MAAM,EAAE;QACJ,cAAc,EAAE,MAAM,CAAC;QACvB,kBAAkB,CAAC,EAAE,OAAO,CAAC;QAC7B,qBAAqB,CAAC,EAAE,MAAM,CAAC;QAC/B,kBAAkB,CAAC,EAAE,MAAM,CAAC;QAC5B,mBAAmB,CAAC,EAAE,MAAM,CAAC;QAC7B,yBAAyB,CAAC,EAAE,MAAM,CAAC;QACnC,4BAA4B,CAAC,EAAE,MAAM,GAAG;YAAE,OAAO,EAAE,MAAM,CAAC;YAAC,CAAC,QAAQ,EAAE,MAAM,GAAG,MAAM,CAAA;SAAE,CAAC;QACxF,SAAS,EAAE,MAAM,GAAG,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;QAC3C,uBAAuB,CAAC,EAAE,GAAG,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;QAE9C,wBAAwB,CAAC,EAAE,MAAM,CAAC;QAClC,yBAAyB,CAAC,EAAE,MAAM,CAAC;QACnC,oBAAoB,CAAC,EAAE,MAAM,CAAC;QAC9B,MAAM,CAAC,EAAE;YACL,OAAO,EAAE,OAAO,CAAC;YACjB,uBAAuB,EAAE,MAAM,CAAC;SACnC,CAAC;QACF,QAAQ,CAAC,EAAE,cAAc,CAAC;QAC1B,OAAO,CAAC,EAAE,aAAa,CAAC;QACxB,sBAAsB,CAAC,EAAE;YAAE,OAAO,EAAE,OAAO,CAAC;YAAC,YAAY,EAAE,MAAM,CAAA;SAAE,CAAC;QACpE,YAAY,CAAC,EAAE;YACX,kBAAkB,CAAC,EAAE,OAAO,CAAC;YAC7B,aAAa,CAAC,EAAE;gBAAE,OAAO,EAAE,OAAO,CAAC;gBAAC,mBAAmB,EAAE,MAAM,CAAA;aAAE,CAAC;YAClE,aAAa,CAAC,EAAE;gBAAE,OAAO,EAAE,OAAO,CAAC;gBAAC,YAAY,EAAE,MAAM,CAAC;gBAAC,SAAS,EAAE,MAAM,CAAA;aAAE,CAAC;SACjF,CAAC;KACL,CAAC;CACL;AAqCD,wBAAgB,sBAAsB,CAAC,IAAI,EAAE,gBAAgB;;;;;iBAxCF,CAAC;;;;;;;;;;;;iBA5BxD,CAAA;eACA,CAAF;;mBA4T2B;QAAE,KAAK,EAAE;YAAE,IAAI,EAAE,MAAM,CAAC;YAAC,UAAU,CAAC,EAAE,OAAO,CAAA;SAAE,CAAA;KAAE;;;SAa7E"}

package/dist/hooks/magic-context/system-prompt-hash.d.ts

@@ -25,6 +25,10 @@ export declare function createSystemPromptHashHandler(deps: {
     lastHeuristicsTurnId: Map<string, string>;
     /** When true, inject stable user memories as <user-profile> into system prompt */
     experimentalUserMemories?: boolean;
+    /** When true, inject pinned key files as <key-files> into system prompt */
+    experimentalPinKeyFiles?: boolean;
+    /** Token budget for key files injection (default 10000) */
+    experimentalPinKeyFilesTokenBudget?: number;
 }): (input: {
     sessionID?: string;
 }, output: {

package/dist/hooks/magic-context/system-prompt-hash.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"system-prompt-hash.d.ts","sourceRoot":"","sources":["../../../src/hooks/magic-context/system-prompt-hash.ts"],"names":[],"mappings":"AAMA,OAAO,EACH,KAAK,eAAe,EAGvB,MAAM,sCAAsC,CAAC;AAqC9C;;;;;;;;;;;;GAYG;AACH,wBAAgB,6BAA6B,CAAC,IAAI,EAAE;IAChD,EAAE,EAAE,eAAe,CAAC;IACpB,aAAa,EAAE,MAAM,CAAC;IACtB,gBAAgB,EAAE,OAAO,CAAC;IAC1B,cAAc,EAAE,OAAO,CAAC;IACxB,6FAA6F;IAC7F,UAAU,EAAE,OAAO,CAAC;IACpB,mDAAmD;IACnD,SAAS,EAAE,MAAM,CAAC;IAClB,eAAe,EAAE,GAAG,CAAC,MAAM,CAAC,CAAC;IAC7B,oBAAoB,EAAE,GAAG,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;IAC1C,kFAAkF;IAClF,wBAAwB,CAAC,EAAE,OAAO,CAAC;CACtC,GAAG,CAAC,KAAK,EAAE;IAAE,SAAS,CAAC,EAAE,MAAM,CAAA;CAAE,EAAE,MAAM,EAAE;IAAE,MAAM,EAAE,MAAM,EAAE,CAAA;CAAE,KAAK,OAAO,CAAC,IAAI,CAAC,CAgKjF"}
+{"version":3,"file":"system-prompt-hash.d.ts","sourceRoot":"","sources":["../../../src/hooks/magic-context/system-prompt-hash.ts"],"names":[],"mappings":"AAQA,OAAO,EACH,KAAK,eAAe,EAGvB,MAAM,sCAAsC,CAAC;AAwC9C;;;;;;;;;;;;GAYG;AACH,wBAAgB,6BAA6B,CAAC,IAAI,EAAE;IAChD,EAAE,EAAE,eAAe,CAAC;IACpB,aAAa,EAAE,MAAM,CAAC;IACtB,gBAAgB,EAAE,OAAO,CAAC;IAC1B,cAAc,EAAE,OAAO,CAAC;IACxB,6FAA6F;IAC7F,UAAU,EAAE,OAAO,CAAC;IACpB,mDAAmD;IACnD,SAAS,EAAE,MAAM,CAAC;IAClB,eAAe,EAAE,GAAG,CAAC,MAAM,CAAC,CAAC;IAC7B,oBAAoB,EAAE,GAAG,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;IAC1C,kFAAkF;IAClF,wBAAwB,CAAC,EAAE,OAAO,CAAC;IACnC,2EAA2E;IAC3E,uBAAuB,CAAC,EAAE,OAAO,CAAC;IAClC,2DAA2D;IAC3D,kCAAkC,CAAC,EAAE,MAAM,CAAC;CAC/C,GAAG,CAAC,KAAK,EAAE;IAAE,SAAS,CAAC,EAAE,MAAM,CAAA;CAAE,EAAE,MAAM,EAAE;IAAE,MAAM,EAAE,MAAM,EAAE,CAAA;CAAE,KAAK,OAAO,CAAC,IAAI,CAAC,CA2PjF"}

package/dist/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,MAAM,EAAE,MAAM,qBAAqB,CAAC;AAuBlD,QAAA,MAAM,MAAM,EAAE,MA2Lb,CAAC;AAEF,eAAe,MAAM,CAAC"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,MAAM,EAAE,MAAM,qBAAqB,CAAC;AAuBlD,QAAA,MAAM,MAAM,EAAE,MAkMb,CAAC;AAEF,eAAe,MAAM,CAAC"}

package/dist/index.js

@@ -22202,10 +22202,16 @@ var MagicContextConfigSchema = exports_external.object({
     user_memories: exports_external.object({
       enabled: exports_external.boolean().default(false),
       promotion_threshold: exports_external.number().min(2).max(20).default(3)
-    }).default({ enabled: false, promotion_threshold: 3 })
+    }).default({ enabled: false, promotion_threshold: 3 }),
+    pin_key_files: exports_external.object({
+      enabled: exports_external.boolean().default(false),
+      token_budget: exports_external.number().min(2000).max(30000).default(1e4),
+      min_reads: exports_external.number().min(2).max(20).default(4)
+    }).default({ enabled: false, token_budget: 1e4, min_reads: 4 })
   }).default({
     compaction_markers: false,
-    user_memories: { enabled: false, promotion_threshold: 3 }
+    user_memories: { enabled: false, promotion_threshold: 3 },
+    pin_key_files: { enabled: false, token_budget: 1e4, min_reads: 4 }
   }),
   memory: exports_external.object({
     enabled: exports_external.boolean().default(true),
@@ -23502,8 +23508,19 @@ function clearStaleEntries(db, maxAgeMs) {
   return result.changes;
 }
 // src/features/magic-context/dreamer/runner.ts
+import { Database } from "bun:sqlite";
 import { existsSync as existsSync4 } from "fs";
-import { join as join6 } from "path";
+import { join as join7 } from "path";
+
+// src/shared/data-path.ts
+import * as os2 from "os";
+import * as path2 from "path";
+function getDataDir() {
+  return process.env.XDG_DATA_HOME ?? path2.join(os2.homedir(), ".local", "share");
+}
+function getOpenCodeStorageDir() {
+  return path2.join(getDataDir(), "opencode", "storage");
+}
 
 // src/shared/error-message.ts
 function getErrorMessage(error48) {
@@ -23513,6 +23530,189 @@ function getErrorMessage(error48) {
 // src/features/magic-context/dreamer/runner.ts
 init_logger();
 
+// src/features/magic-context/key-files/identify-key-files.ts
+init_logger();
+
+// src/features/magic-context/key-files/read-stats.ts
+function getSessionReadStats(openCodeDb, sessionId, minReads) {
+  const fullReads = openCodeDb.prepare(`
+        WITH full_reads AS (
+            SELECT 
+                json_extract(json_extract(data, '$.state'), '$.input.filePath') as file_path,
+                LENGTH(json_extract(json_extract(data, '$.state'), '$.output')) as output_bytes,
+                p.time_created,
+                ROW_NUMBER() OVER (
+                    PARTITION BY json_extract(json_extract(data, '$.state'), '$.input.filePath') 
+                    ORDER BY p.time_created DESC
+                ) as rn
+            FROM part p
+            WHERE p.session_id = ?
+                AND json_extract(data, '$.type') = 'tool'
+                AND json_extract(data, '$.tool') = 'read'
+                AND json_extract(json_extract(data, '$.state'), '$.input.filePath') IS NOT NULL
+                AND json_extract(json_extract(data, '$.state'), '$.input.startLine') IS NULL
+                AND json_extract(json_extract(data, '$.state'), '$.input.start_line') IS NULL
+                AND json_extract(json_extract(data, '$.state'), '$.input.endLine') IS NULL
+                AND json_extract(json_extract(data, '$.state'), '$.input.end_line') IS NULL
+                AND json_extract(json_extract(data, '$.state'), '$.input.offset') IS NULL
+                AND json_extract(json_extract(data, '$.state'), '$.input.limit') IS NULL
+        ),
+        file_counts AS (
+            SELECT file_path, COUNT(*) as full_read_count
+            FROM full_reads
+            GROUP BY file_path
+            HAVING full_read_count >= ?
+        )
+        SELECT 
+            r.file_path,
+            fc.full_read_count,
+            r.output_bytes as latest_read_bytes
+        FROM full_reads r
+        JOIN file_counts fc ON r.file_path = fc.file_path
+        WHERE r.rn = 1
+        ORDER BY fc.full_read_count DESC
+    `).all(sessionId, minReads);
+  if (fullReads.length === 0)
+    return [];
+  const editCounts = new Map;
+  const editRows = openCodeDb.prepare(`
+        SELECT 
+            json_extract(json_extract(data, '$.state'), '$.input.filePath') as file_path,
+            COUNT(*) as edit_count
+        FROM part p
+        WHERE p.session_id = ?
+            AND json_extract(data, '$.type') = 'tool'
+            AND json_extract(data, '$.tool') IN ('edit', 'write', 'mcp_edit', 'mcp_write')
+            AND json_extract(json_extract(data, '$.state'), '$.input.filePath') IS NOT NULL
+        GROUP BY file_path
+    `).all(sessionId);
+  for (const row of editRows) {
+    editCounts.set(row.file_path, row.edit_count);
+  }
+  return fullReads.map((row) => ({
+    filePath: row.file_path,
+    fullReadCount: row.full_read_count,
+    spreadAcrossCompartments: 0,
+    editCount: editCounts.get(row.file_path) ?? 0,
+    latestReadBytes: row.latest_read_bytes ?? 0,
+    latestReadTokens: Math.ceil((row.latest_read_bytes ?? 0) / 3.5)
+  }));
+}
+
+// src/features/magic-context/key-files/storage-key-files.ts
+init_logger();
+function getKeyFiles(db, sessionId) {
+  try {
+    const row = db.prepare("SELECT key_files FROM session_meta WHERE session_id = ?").get(sessionId);
+    if (!row?.key_files)
+      return [];
+    const parsed = JSON.parse(row.key_files);
+    if (!Array.isArray(parsed))
+      return [];
+    return parsed.filter((e) => typeof e === "object" && e !== null && typeof e.filePath === "string" && typeof e.tokens === "number");
+  } catch {
+    return [];
+  }
+}
+function setKeyFiles(db, sessionId, files) {
+  try {
+    db.prepare("INSERT OR IGNORE INTO session_meta (session_id) VALUES (?)").run(sessionId);
+    db.prepare("UPDATE session_meta SET key_files = ? WHERE session_id = ?").run(JSON.stringify(files), sessionId);
+  } catch (error48) {
+    sessionLog(sessionId, "failed to persist key files:", error48);
+  }
+}
+function greedyFitFiles(rankedFiles, tokenBudget) {
+  const selected = [];
+  let remainingBudget = tokenBudget;
+  for (const file2 of rankedFiles) {
+    if (file2.tokens <= 0)
+      continue;
+    if (file2.tokens > remainingBudget)
+      continue;
+    selected.push({ filePath: file2.filePath, tokens: file2.tokens });
+    remainingBudget -= file2.tokens;
+    if (remainingBudget <= 0)
+      break;
+  }
+  return selected;
+}
+
+// src/features/magic-context/key-files/identify-key-files.ts
+var KEY_FILES_SYSTEM_PROMPT = "You are a file importance evaluator. Given read statistics about files in a coding session, identify which are core orientation files worth pinning in context. Return a JSON array.";
+function buildKeyFilesPrompt(candidates, tokenBudget, minReads) {
+  const statsText = candidates.map((s) => `- **${s.filePath}** \u2014 ${s.fullReadCount} full reads, ${s.editCount} edits, ~${s.latestReadTokens} tokens`).join(`
+`);
+  return `## Identify Key Files for Pinning
+
+The following files were fully read ${minReads}+ times during a coding session.
+Identify which ones are **core orientation files** worth keeping permanently in context.
+
+### Signals of a core orientation file:
+- Read many times across different phases of work (not clustered in one task)
+- Read without editing \u2014 consulted for understanding, not modification
+- Contains architecture, configuration, types, or key abstractions
+
+### Signals of a NON-core file (exclude):
+- Read many times but always edited \u2014 actively working on it
+- Very large (>5000 tokens) \u2014 too expensive to pin
+- Test files, scripts, or generated files
+
+### Token budget: ${tokenBudget} tokens total
+
+### Files:
+${statsText}
+
+### Output Format
+Return a JSON array ranked by importance (most important first):
+\`\`\`json
+[
+  {"filePath": "src/path/to/file.ts", "tokens": 2500, "reason": "brief reason"}
+]
+\`\`\`
+
+Only include files you're confident are true orientation files. Return empty array if none qualify.`;
+}
+function parseKeyFilesOutput(text) {
+  const jsonMatch = text.match(/```(?:json)?\s*\n?([\s\S]*?)\n?```/) ?? text.match(/\[[\s\S]*\]/);
+  if (!jsonMatch)
+    return [];
+  try {
+    const raw = jsonMatch[1] ?? jsonMatch[0];
+    const parsed = JSON.parse(raw);
+    if (!Array.isArray(parsed))
+      return [];
+    return parsed.filter((item) => typeof item === "object" && item !== null && typeof item.filePath === "string" && typeof item.tokens === "number").map((item) => ({ filePath: item.filePath, tokens: item.tokens }));
+  } catch {
+    return [];
+  }
+}
+function getKeyFileCandidates(openCodeDb, sessionId, minReads, tokenBudget) {
+  const stats = getSessionReadStats(openCodeDb, sessionId, minReads);
+  const maxPerFileTokens = Math.min(tokenBudget / 2, 5000);
+  return stats.filter((s) => s.latestReadTokens > 0 && s.latestReadTokens <= maxPerFileTokens);
+}
+function applyKeyFileResults(db, sessionId, llmRanked, tokenBudget, candidatePaths) {
+  const filtered = candidatePaths ? llmRanked.filter((f) => candidatePaths.has(f.filePath)) : llmRanked;
+  const selected = greedyFitFiles(filtered, tokenBudget);
+  setKeyFiles(db, sessionId, selected);
+  const totalTokens = selected.reduce((sum, f) => sum + f.tokens, 0);
+  log(`[key-files][${sessionId}] pinned ${selected.length} files (${totalTokens} tokens): ${selected.map((f) => f.filePath).join(", ")}`);
+  return { filesIdentified: selected.length, totalTokens };
+}
+function heuristicKeyFileSelection(db, sessionId, candidates, tokenBudget) {
+  const scored = candidates.map((c) => ({
+    filePath: c.filePath,
+    tokens: c.latestReadTokens,
+    score: c.fullReadCount * 2 - c.editCount * 3
+  })).filter((c) => c.score > 0).sort((a, b) => b.score - a.score);
+  const selected = greedyFitFiles(scored, tokenBudget);
+  setKeyFiles(db, sessionId, selected);
+  const totalTokens = selected.reduce((sum, f) => sum + f.tokens, 0);
+  log(`[key-files][${sessionId}] heuristic pinned ${selected.length} files (${totalTokens} tokens)`);
+  return { filesIdentified: selected.length, totalTokens };
+}
+
 // src/features/magic-context/memory/storage-memory-embeddings.ts
 var saveEmbeddingStatements = new WeakMap;
 var loadAllEmbeddingsStatements = new WeakMap;
@@ -24408,6 +24608,176 @@ function countNewIds(beforeIds, afterIds) {
   }
   return count;
 }
+function getOpenCodeDbPath() {
+  return join7(getDataDir(), "opencode", "opencode.db");
+}
+function openOpenCodeDb() {
+  const dbPath = getOpenCodeDbPath();
+  if (!existsSync4(dbPath)) {
+    log(`[key-files] OpenCode DB not found at ${dbPath} \u2014 skipping`);
+    return null;
+  }
+  try {
+    const db = new Database(dbPath, { readonly: true });
+    db.exec("PRAGMA busy_timeout = 5000");
+    return db;
+  } catch (error48) {
+    log(`[key-files] failed to open OpenCode DB at ${dbPath}: ${getErrorMessage(error48)}`);
+    return null;
+  }
+}
+function isSessionIdRow(row) {
+  if (row === null || typeof row !== "object") {
+    return false;
+  }
+  return typeof row.sessionId === "string";
+}
+function hasExplicitEmptyKeyFilesOutput(text) {
+  return /```(?:json)?\s*\[\s*\]\s*```/s.test(text) || /^\s*\[\s*\]\s*$/s.test(text);
+}
+async function getActiveProjectSessionIds(args) {
+  const listResponse = await args.client.session.list({
+    query: { directory: args.sessionDirectory ?? args.projectIdentity }
+  });
+  const sessions = normalizeSDKResponse(listResponse, [], {
+    preferResponseOnMissingData: true
+  });
+  const projectSessionIds = new Set(sessions.map((session) => typeof session?.id === "string" ? session.id : null).filter((sessionId) => Boolean(sessionId)));
+  if (projectSessionIds.size === 0) {
+    return [];
+  }
+  return args.db.prepare("SELECT session_id AS sessionId FROM session_meta WHERE is_subagent = 0 ORDER BY session_id ASC").all().filter(isSessionIdRow).map((row) => row.sessionId).filter((sessionId) => projectSessionIds.has(sessionId));
+}
+async function identifyKeyFilesForSession(args) {
+  let openCodeDb = null;
+  try {
+    openCodeDb = openOpenCodeDb();
+    if (!openCodeDb) {
+      return;
+    }
+    const candidates = getKeyFileCandidates(openCodeDb, args.sessionId, args.config.min_reads, args.config.token_budget);
+    if (candidates.length === 0) {
+      log(`[key-files][${args.sessionId}] no candidates found \u2014 skipping`);
+      return;
+    }
+    const prompt = buildKeyFilesPrompt(candidates, args.config.token_budget, args.config.min_reads);
+    const applyHeuristicFallback = () => {
+      heuristicKeyFileSelection(args.db, args.sessionId, candidates, args.config.token_budget);
+    };
+    let agentSessionId = null;
+    const abortController = new AbortController;
+    const leaseInterval = setInterval(() => {
+      try {
+        if (!renewLease(args.db, args.holderId)) {
+          log(`[key-files][${args.sessionId}] lease renewal failed \u2014 aborting`);
+          abortController.abort();
+        }
+      } catch {
+        abortController.abort();
+      }
+    }, 60000);
+    try {
+      const createResponse = await args.client.session.create({
+        body: {
+          ...args.parentSessionId ? { parentID: args.parentSessionId } : {},
+          title: `magic-context-dream-key-files-${args.sessionId.slice(0, 12)}`
+        },
+        query: { directory: args.sessionDirectory }
+      });
+      const created = normalizeSDKResponse(createResponse, null, { preferResponseOnMissingData: true });
+      agentSessionId = typeof created?.id === "string" ? created.id : null;
+      if (!agentSessionId) {
+        throw new Error("Could not create key-file identification session.");
+      }
+      log(`[key-files][${args.sessionId}] child session created ${agentSessionId}`);
+      const remainingMs = Math.max(0, args.deadline - Date.now());
+      await promptSyncWithModelSuggestionRetry(args.client, {
+        path: { id: agentSessionId },
+        query: { directory: args.sessionDirectory },
+        body: {
+          agent: DREAMER_AGENT,
+          system: KEY_FILES_SYSTEM_PROMPT,
+          parts: [{ type: "text", text: prompt }]
+        }
+      }, { timeoutMs: Math.min(remainingMs, 5 * 60 * 1000), signal: abortController.signal });
+      const messagesResponse = await args.client.session.messages({
+        path: { id: agentSessionId },
+        query: { directory: args.sessionDirectory }
+      });
+      const messages = normalizeSDKResponse(messagesResponse, [], {
+        preferResponseOnMissingData: true
+      });
+      const responseText = extractLatestAssistantText(messages);
+      if (!responseText) {
+        log(`[key-files][${args.sessionId}] no response from agent \u2014 using heuristic fallback`);
+        applyHeuristicFallback();
+        return;
+      }
+      const parsed = parseKeyFilesOutput(responseText);
+      if (parsed.length > 0 || hasExplicitEmptyKeyFilesOutput(responseText)) {
+        const candidatePaths = new Set(candidates.map((c) => c.filePath));
+        applyKeyFileResults(args.db, args.sessionId, parsed, args.config.token_budget, candidatePaths);
+        return;
+      }
+      log(`[key-files][${args.sessionId}] could not parse agent output \u2014 using heuristic fallback`);
+      applyHeuristicFallback();
+    } catch (error48) {
+      log(`[key-files][${args.sessionId}] identification failed: ${getErrorMessage(error48)} \u2014 using heuristic fallback`);
+      try {
+        applyHeuristicFallback();
+      } catch (fallbackError) {
+        log(`[key-files][${args.sessionId}] heuristic fallback failed: ${getErrorMessage(fallbackError)}`);
+      }
+    } finally {
+      clearInterval(leaseInterval);
+      if (agentSessionId) {
+        await args.client.session.delete({
+          path: { id: agentSessionId },
+          query: { directory: args.sessionDirectory }
+        }).catch((error48) => {
+          log(`[key-files][${args.sessionId}] session cleanup failed: ${getErrorMessage(error48)}`);
+        });
+      }
+    }
+  } finally {
+    if (openCodeDb) {
+      try {
+        openCodeDb.close(false);
+      } catch (error48) {
+        log(`[key-files][${args.sessionId}] failed to close OpenCode DB: ${getErrorMessage(error48)}`);
+      }
+    }
+  }
+}
+async function identifyKeyFiles(args) {
+  const sessionIds = await getActiveProjectSessionIds({
+    db: args.db,
+    client: args.client,
+    projectIdentity: args.projectIdentity,
+    sessionDirectory: args.sessionDirectory
+  });
+  if (sessionIds.length === 0) {
+    log(`[key-files] no active sessions found for ${args.projectIdentity}`);
+    return;
+  }
+  log(`[key-files] evaluating ${sessionIds.length} active session(s) for ${args.projectIdentity}`);
+  for (const sessionId of sessionIds) {
+    if (Date.now() > args.deadline) {
+      log("[key-files] deadline reached \u2014 stopping key-file identification");
+      break;
+    }
+    await identifyKeyFilesForSession({
+      db: args.db,
+      client: args.client,
+      parentSessionId: args.parentSessionId,
+      sessionDirectory: args.sessionDirectory,
+      holderId: args.holderId,
+      deadline: args.deadline,
+      sessionId,
+      config: args.config
+    });
+  }
+}
 async function runDream(args) {
   const holderId = crypto.randomUUID();
   const startedAt = Date.now();
@@ -24479,8 +24849,8 @@ async function runDream(args) {
       try {
         const docsDir = args.sessionDirectory ?? args.projectIdentity;
         const existingDocs = taskName === "maintain-docs" ? {
-          architecture: existsSync4(join6(docsDir, "ARCHITECTURE.md")),
-          structure: existsSync4(join6(docsDir, "STRUCTURE.md"))
+          architecture: existsSync4(join7(docsDir, "ARCHITECTURE.md")),
+          structure: existsSync4(join7(docsDir, "STRUCTURE.md"))
         } : undefined;
         const taskPrompt = buildDreamTaskPrompt(taskName, {
           projectPath: args.projectIdentity,
@@ -24586,6 +24956,22 @@ async function runDream(args) {
         log(`[dreamer] smart note evaluation failed: ${getErrorMessage(error48)}`);
       }
     }
+    if (args.experimentalPinKeyFiles?.enabled && Date.now() <= deadline) {
+      try {
+        await identifyKeyFiles({
+          db: args.db,
+          client: args.client,
+          projectIdentity: args.projectIdentity,
+          parentSessionId,
+          sessionDirectory: args.sessionDirectory ?? args.projectIdentity,
+          holderId,
+          deadline,
+          config: args.experimentalPinKeyFiles
+        });
+      } catch (error48) {
+        log(`[key-files] identification phase failed: ${getErrorMessage(error48)}`);
+      }
+    }
   } finally {
     releaseLease(args.db, holderId);
     log(`[dreamer] lease released: ${holderId}`);
@@ -24794,7 +25180,8 @@ async function processDreamQueue(args) {
       taskTimeoutMinutes: args.taskTimeoutMinutes,
       maxRuntimeMinutes: args.maxRuntimeMinutes,
       sessionDirectory: projectDirectory,
-      experimentalUserMemories: args.experimentalUserMemories
+      experimentalUserMemories: args.experimentalUserMemories,
+      experimentalPinKeyFiles: args.experimentalPinKeyFiles
     });
   } catch (error48) {
     log(`[dreamer] runDream threw for ${entry.projectIdentity}: ${getErrorMessage(error48)}`);
@@ -25291,7 +25678,7 @@ function getEmbeddingModelId() {
 
 // src/features/magic-context/memory/project-identity.ts
 import { execSync } from "child_process";
-import path2 from "path";
+import path3 from "path";
 var GIT_TIMEOUT_MS = 5000;
 var resolvedCache = new Map;
 function getRootCommitHash(directory) {
@@ -25310,12 +25697,12 @@ function getRootCommitHash(directory) {
   }
 }
 function directoryFallback(directory) {
-  const canonical = path2.resolve(directory);
+  const canonical = path3.resolve(directory);
   const hash2 = Bun.hash(canonical).toString(16).slice(0, 12);
   return `dir:${hash2}`;
 }
 function resolveProjectIdentity(directory) {
-  const resolved = path2.resolve(directory);
+  const resolved = path3.resolve(directory);
   const cached2 = resolvedCache.get(resolved);
   if (cached2 !== undefined) {
     return cached2;
@@ -25402,22 +25789,10 @@ function removeSystemReminders(text) {
 }
 
 // src/hooks/magic-context/read-session-db.ts
-import { Database } from "bun:sqlite";
+import { Database as Database2 } from "bun:sqlite";
 import { join as join8 } from "path";
-
-// src/shared/data-path.ts
-import * as os2 from "os";
-import * as path3 from "path";
-function getDataDir() {
-  return process.env.XDG_DATA_HOME ?? path3.join(os2.homedir(), ".local", "share");
-}
-function getOpenCodeStorageDir() {
-  return path3.join(getDataDir(), "opencode", "storage");
-}
-
-// src/hooks/magic-context/read-session-db.ts
 init_logger();
-function getOpenCodeDbPath() {
+function getOpenCodeDbPath2() {
   return join8(getDataDir(), "opencode", "opencode.db");
 }
 var cachedReadOnlyDb = null;
@@ -25434,12 +25809,12 @@ function closeCachedReadOnlyDb() {
   }
 }
 function getReadOnlySessionDb() {
-  const dbPath = getOpenCodeDbPath();
+  const dbPath = getOpenCodeDbPath2();
   if (cachedReadOnlyDb?.path === dbPath) {
     return cachedReadOnlyDb.db;
   }
   closeCachedReadOnlyDb();
-  const db = new Database(dbPath, { readonly: true });
+  const db = new Database2(dbPath, { readonly: true });
   cachedReadOnlyDb = { path: dbPath, db };
   return db;
 }
@@ -25992,7 +26367,7 @@ function ensureMessagesIndexed(db, sessionId, readMessages) {
   })();
 }
 // src/features/magic-context/storage-db.ts
-import { Database as Database2 } from "bun:sqlite";
+import { Database as Database3 } from "bun:sqlite";
 import { mkdirSync } from "fs";
 import { join as join9 } from "path";
 init_logger();
@@ -26428,6 +26803,7 @@ CREATE INDEX IF NOT EXISTS idx_dream_queue_pending ON dream_queue(started_at, en
   ensureColumn(db, "tags", "reasoning_byte_size", "INTEGER DEFAULT 0");
   ensureColumn(db, "session_meta", "system_prompt_tokens", "INTEGER DEFAULT 0");
   ensureColumn(db, "session_meta", "compaction_marker_state", "TEXT DEFAULT ''");
+  ensureColumn(db, "session_meta", "key_files", "TEXT DEFAULT ''");
 }
 function ensureColumn(db, table, column, definition) {
   if (!/^[a-z_]+$/.test(table) || !/^[a-z_]+$/.test(column) || !/^[A-Z0-9_'(),\s]+$/i.test(definition)) {
@@ -26441,7 +26817,7 @@ function ensureColumn(db, table, column, definition) {
 }
 function createFallbackDatabase() {
   try {
-    const fallback = new Database2(":memory:");
+    const fallback = new Database3(":memory:");
     initializeDatabase(fallback);
     runMigrations(fallback);
     return fallback;
@@ -26460,7 +26836,7 @@ function openDatabase() {
       return existing;
     }
     mkdirSync(dbDir, { recursive: true });
-    const db = new Database2(dbPath);
+    const db = new Database3(dbPath);
     initializeDatabase(db);
     runMigrations(db);
     databases.set(dbPath, db);
@@ -27012,7 +27388,8 @@ function startDreamScheduleTimer(args) {
     dreamerConfig,
     embeddingConfig: embeddingConfig2,
     memoryEnabled,
-    experimentalUserMemories
+    experimentalUserMemories,
+    experimentalPinKeyFiles
   } = args;
   const dreamingEnabled = Boolean(dreamerConfig?.enabled && dreamerConfig.schedule?.trim());
   const embeddingSweepEnabled = memoryEnabled && embeddingConfig2.provider !== "off";
@@ -27042,7 +27419,8 @@ function startDreamScheduleTimer(args) {
         tasks: dreamerConfig.tasks,
         taskTimeoutMinutes: dreamerConfig.task_timeout_minutes,
         maxRuntimeMinutes: dreamerConfig.max_runtime_minutes,
-        experimentalUserMemories
+        experimentalUserMemories,
+        experimentalPinKeyFiles
       }).catch((error48) => {
         log("[dreamer] timer-triggered queue processing failed:", error48);
       });
@@ -27841,7 +28219,8 @@ Dreaming is not configured for this project.`, {});
     tasks: deps.dreamer.config.tasks,
     taskTimeoutMinutes: deps.dreamer.config.task_timeout_minutes,
     maxRuntimeMinutes: deps.dreamer.config.max_runtime_minutes,
-    experimentalUserMemories: deps.dreamer.experimentalUserMemories
+    experimentalUserMemories: deps.dreamer.experimentalUserMemories,
+    experimentalPinKeyFiles: deps.dreamer.experimentalPinKeyFiles
   });
   await deps.sendNotification(sessionId, result ? summarizeDreamResult(result) : "Dream queued, but another worker is already processing the queue.", {});
   throw new Error(`${SENTINEL_PREFIX}CTX-DREAM_HANDLED__`);
@@ -27930,7 +28309,7 @@ Historian recomp started. Rebuilding compartments and facts from raw session his
 init_logger();
 
 // src/features/magic-context/compaction-marker.ts
-import { Database as Database3 } from "bun:sqlite";
+import { Database as Database4 } from "bun:sqlite";
 import { join as join10 } from "path";
 init_logger();
 var BASE62_CHARS = "0123456789ABCDEFGHIJKLMNOPQRSTUVWXYZabcdefghijklmnopqrstuvwxyz";
@@ -27952,12 +28331,12 @@ function generateMessageId(timestampMs, counter = 0n) {
 function generatePartId(timestampMs, counter = 0n) {
   return generateId("prt", timestampMs, counter);
 }
-function getOpenCodeDbPath2() {
+function getOpenCodeDbPath3() {
   return join10(getDataDir(), "opencode", "opencode.db");
 }
 var cachedWriteDb = null;
 function getWritableOpenCodeDb() {
-  const dbPath = getOpenCodeDbPath2();
+  const dbPath = getOpenCodeDbPath3();
   if (cachedWriteDb?.path === dbPath) {
     return cachedWriteDb.db;
   }
@@ -27966,7 +28345,7 @@ function getWritableOpenCodeDb() {
       cachedWriteDb.db.close(false);
     } catch {}
   }
-  const db = new Database3(dbPath);
+  const db = new Database4(dbPath);
   db.exec("PRAGMA journal_mode=WAL");
   db.exec("PRAGMA busy_timeout=5000");
   cachedWriteDb = { path: dbPath, db };
@@ -31965,8 +32344,8 @@ function createToolExecuteAfterHook(args) {
 }
 
 // src/hooks/magic-context/system-prompt-hash.ts
-import { existsSync as existsSync5, readFileSync as readFileSync4 } from "fs";
-import { join as join12 } from "path";
+import { existsSync as existsSync5, readFileSync as readFileSync4, realpathSync } from "fs";
+import { join as join12, resolve as resolve2, sep } from "path";
 
 // src/agents/magic-context-prompt.ts
 var BASE_INTRO = (protectedTags) => `Messages and tool outputs are tagged with \xA7N\xA7 identifiers (e.g., \xA71\xA7, \xA742\xA7).
@@ -32168,7 +32547,9 @@ init_logger();
 var MAGIC_CONTEXT_MARKER = "## Magic Context";
 var PROJECT_DOCS_MARKER = "<project-docs>";
 var USER_PROFILE_MARKER = "<user-profile>";
+var KEY_FILES_MARKER = "<key-files>";
 var cachedUserProfileBySession = new Map;
+var cachedKeyFilesBySession = new Map;
 var DOC_FILES = ["ARCHITECTURE.md", "STRUCTURE.md"];
 function readProjectDocs(directory) {
   const sections = [];
@@ -32250,6 +32631,72 @@ ${items}
         output.system.push(profileBlock);
       }
     }
+    if (deps.experimentalPinKeyFiles) {
+      const hasCachedKeyFiles = cachedKeyFilesBySession.has(sessionId);
+      if (!hasCachedKeyFiles || isCacheBusting) {
+        const keyFileEntries = getKeyFiles(deps.db, sessionId);
+        if (keyFileEntries.length > 0) {
+          const sections = [];
+          const projectRoot = resolve2(deps.directory);
+          let remainingBudgetTokens = deps.experimentalPinKeyFilesTokenBudget ?? 1e4;
+          for (const entry of keyFileEntries) {
+            try {
+              const absPath = resolve2(deps.directory, entry.filePath);
+              if (!absPath.startsWith(projectRoot + sep) && absPath !== projectRoot) {
+                log(`[magic-context] key file path escapes project root, skipping: ${entry.filePath}`);
+                continue;
+              }
+              if (!existsSync5(absPath))
+                continue;
+              let realPath;
+              try {
+                realPath = realpathSync(absPath);
+              } catch {
+                continue;
+              }
+              if (!realPath.startsWith(projectRoot + sep) && realPath !== projectRoot) {
+                log(`[magic-context] key file symlink escapes project root, skipping: ${entry.filePath} \u2192 ${realPath}`);
+                continue;
+              }
+              const content = readFileSync4(realPath, "utf-8").trim();
+              if (content.length === 0)
+                continue;
+              const fileTokens = estimateTokens(content);
+              if (fileTokens > remainingBudgetTokens) {
+                log(`[magic-context] key file ${entry.filePath} exceeds remaining budget (${fileTokens} > ${remainingBudgetTokens}), skipping`);
+                continue;
+              }
+              remainingBudgetTokens -= fileTokens;
+              sections.push(`<file path="${escapeXmlAttr(entry.filePath)}">
+${escapeXmlContent(content)}
+</file>`);
+            } catch (error48) {
+              log(`[magic-context] failed to read key file ${entry.filePath}:`, error48);
+            }
+          }
+          if (sections.length > 0) {
+            cachedKeyFilesBySession.set(sessionId, `${KEY_FILES_MARKER}
+${sections.join(`
+
+`)}
+</key-files>`);
+            if (!hasCachedKeyFiles) {
+              sessionLog(sessionId, `loaded ${sections.length} key file(s) into system prompt`);
+            } else {
+              sessionLog(sessionId, "refreshed key files (cache-busting pass)");
+            }
+          } else {
+            cachedKeyFilesBySession.set(sessionId, null);
+          }
+        } else {
+          cachedKeyFilesBySession.set(sessionId, null);
+        }
+      }
+      const keyFilesBlock = cachedKeyFilesBySession.get(sessionId);
+      if (keyFilesBlock && !fullPrompt.includes(KEY_FILES_MARKER)) {
+        output.system.push(keyFilesBlock);
+      }
+    }
     const DATE_PATTERN = /Today's date: .+/;
     for (let i = 0;i < output.system.length; i++) {
       const match = output.system[i].match(DATE_PATTERN);
@@ -32290,7 +32737,7 @@ ${items}
     } else if (previousHash === "" || previousHash === "0") {
       sessionLog(sessionId, `system prompt hash initialized: ${currentHash} (len=${systemContent.length})`);
     }
-    const systemPromptTokens = Math.ceil(systemContent.length / 4);
+    const systemPromptTokens = estimateTokens(systemContent);
     if (currentHash !== previousHash) {
       updateSessionMeta(deps.db, sessionId, {
         systemPromptHash: currentHash,
@@ -32424,6 +32871,11 @@ function createMagicContextHook(deps) {
       experimentalUserMemories: deps.config.experimental?.user_memories?.enabled ? {
         enabled: true,
         promotionThreshold: deps.config.experimental.user_memories?.promotion_threshold
+      } : undefined,
+      experimentalPinKeyFiles: deps.config.experimental?.pin_key_files?.enabled ? {
+        enabled: true,
+        token_budget: deps.config.experimental.pin_key_files?.token_budget,
+        min_reads: deps.config.experimental.pin_key_files?.min_reads
       } : undefined
     }).catch((error48) => {
       log("[dreamer] scheduled queue processing failed:", error48);
@@ -32470,6 +32922,11 @@ function createMagicContextHook(deps) {
       experimentalUserMemories: deps.config.experimental?.user_memories?.enabled ? {
         enabled: true,
         promotionThreshold: deps.config.experimental.user_memories?.promotion_threshold
+      } : undefined,
+      experimentalPinKeyFiles: deps.config.experimental?.pin_key_files?.enabled ? {
+        enabled: true,
+        token_budget: deps.config.experimental.pin_key_files?.token_budget,
+        min_reads: deps.config.experimental.pin_key_files?.min_reads
       } : undefined
     } : undefined
   });
@@ -32483,7 +32940,9 @@ function createMagicContextHook(deps) {
     directory: deps.directory,
     flushedSessions,
     lastHeuristicsTurnId,
-    experimentalUserMemories: deps.config.experimental?.user_memories?.enabled
+    experimentalUserMemories: deps.config.experimental?.user_memories?.enabled,
+    experimentalPinKeyFiles: deps.config.experimental?.pin_key_files?.enabled ?? false,
+    experimentalPinKeyFilesTokenBudget: deps.config.experimental?.pin_key_files?.token_budget
   });
   const eventHook = createEventHook({
     eventHandler,
@@ -32962,15 +33421,17 @@ Historian reads these notes, deduplicates them, and rewrites the remaining usefu
 import { tool as tool3 } from "@opencode-ai/plugin";
 function formatNoteLine(note) {
   const statusSuffix = note.status === "active" ? "" : ` (${note.status})`;
-  const dismissHint = note.status === "dismissed" ? "" : ` _(dismiss with \`ctx_note(action="dismiss", note_id=${note.id})\`)_`;
   if (note.type === "session") {
-    return `- **#${note.id}**${statusSuffix}: ${note.content}${dismissHint}`;
+    return `- **#${note.id}**${statusSuffix}: ${note.content}`;
   }
   const conditionText = note.status === "ready" ? note.readyReason ?? note.surfaceCondition ?? "Condition satisfied" : note.surfaceCondition ?? "No condition recorded";
   const conditionLabel = note.status === "ready" ? "Condition met" : "Condition";
   return `- **#${note.id}**${statusSuffix}: ${note.content}
-  ${conditionLabel}: ${conditionText}${dismissHint}`;
+  ${conditionLabel}: ${conditionText}`;
 }
+var DISMISS_FOOTER = `
+
+To dismiss a stale note: ctx_note(action="dismiss", note_id=N)`;
 function buildReadSections(args) {
   if (args.filter === undefined) {
     const sessionNotes2 = getSessionNotes(args.db, args.sessionId);
@@ -33109,7 +33570,7 @@ No session notes or smart notes.`;
       }
       return sections.join(`
 
-`);
+`) + DISMISS_FOOTER;
     }
   });
 }
@@ -33880,6 +34341,11 @@ var plugin = async (ctx) => {
       experimentalUserMemories: pluginConfig.experimental?.user_memories?.enabled ? {
         enabled: true,
         promotionThreshold: pluginConfig.experimental.user_memories?.promotion_threshold
+      } : undefined,
+      experimentalPinKeyFiles: pluginConfig.experimental?.pin_key_files?.enabled ? {
+        enabled: true,
+        token_budget: pluginConfig.experimental.pin_key_files?.token_budget,
+        min_reads: pluginConfig.experimental.pin_key_files?.min_reads
       } : undefined
     });
     startTuiActionConsumer({

package/dist/plugin/dream-timer.d.ts

@@ -17,5 +17,10 @@ export declare function startDreamScheduleTimer(args: {
         enabled: boolean;
         promotionThreshold: number;
     };
+    experimentalPinKeyFiles?: {
+        enabled: boolean;
+        token_budget: number;
+        min_reads: number;
+    };
 }): (() => void) | undefined;
 //# sourceMappingURL=dream-timer.d.ts.map

package/dist/plugin/dream-timer.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"dream-timer.d.ts","sourceRoot":"","sources":["../../src/plugin/dream-timer.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,aAAa,EAAE,eAAe,EAAE,MAAM,gCAAgC,CAAC;AAMrF,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,SAAS,CAAC;AAK7C;;;;;;GAMG;AACH,wBAAgB,uBAAuB,CAAC,IAAI,EAAE;IAC1C,SAAS,EAAE,MAAM,CAAC;IAClB,MAAM,EAAE,aAAa,CAAC,QAAQ,CAAC,CAAC;IAChC,aAAa,CAAC,EAAE,aAAa,CAAC;IAC9B,eAAe,EAAE,eAAe,CAAC;IACjC,aAAa,EAAE,OAAO,CAAC;IACvB,wBAAwB,CAAC,EAAE;QAAE,OAAO,EAAE,OAAO,CAAC;QAAC,kBAAkB,EAAE,MAAM,CAAA;KAAE,CAAC;CAC/E,GAAG,CAAC,MAAM,IAAI,CAAC,GAAG,SAAS,CAqE3B"}
+{"version":3,"file":"dream-timer.d.ts","sourceRoot":"","sources":["../../src/plugin/dream-timer.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,aAAa,EAAE,eAAe,EAAE,MAAM,gCAAgC,CAAC;AAMrF,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,SAAS,CAAC;AAK7C;;;;;;GAMG;AACH,wBAAgB,uBAAuB,CAAC,IAAI,EAAE;IAC1C,SAAS,EAAE,MAAM,CAAC;IAClB,MAAM,EAAE,aAAa,CAAC,QAAQ,CAAC,CAAC;IAChC,aAAa,CAAC,EAAE,aAAa,CAAC;IAC9B,eAAe,EAAE,eAAe,CAAC;IACjC,aAAa,EAAE,OAAO,CAAC;IACvB,wBAAwB,CAAC,EAAE;QAAE,OAAO,EAAE,OAAO,CAAC;QAAC,kBAAkB,EAAE,MAAM,CAAA;KAAE,CAAC;IAC5E,uBAAuB,CAAC,EAAE;QACtB,OAAO,EAAE,OAAO,CAAC;QACjB,YAAY,EAAE,MAAM,CAAC;QACrB,SAAS,EAAE,MAAM,CAAC;KACrB,CAAC;CACL,GAAG,CAAC,MAAM,IAAI,CAAC,GAAG,SAAS,CAuE3B"}

package/dist/plugin/hooks/create-session-hooks.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"create-session-hooks.d.ts","sourceRoot":"","sources":["../../../src/plugin/hooks/create-session-hooks.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,wBAAwB,EAAE,MAAM,cAAc,CAAC;AAU7D,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,UAAU,CAAC;AAE9C,wBAAgB,kBAAkB,CAAC,IAAI,EAAE;IACrC,GAAG,EAAE,aAAa,CAAC;IACnB,YAAY,EAAE,wBAAwB,CAAC;CAC1C;;;;;;qBA4C+R,CAAC;;;;;;;;;;;;qBATjR,CAAN;mBAAiB,CAAC;;;;;0BASwtW,CAAC;;;;;;EADpvW"}
+{"version":3,"file":"create-session-hooks.d.ts","sourceRoot":"","sources":["../../../src/plugin/hooks/create-session-hooks.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,wBAAwB,EAAE,MAAM,cAAc,CAAC;AAU7D,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,UAAU,CAAC;AAE9C,wBAAgB,kBAAkB,CAAC,IAAI,EAAE;IACrC,GAAG,EAAE,aAAa,CAAC;IACnB,YAAY,EAAE,wBAAwB,CAAC;CAC1C;;;;;;qBA4Cq4B,CAAC;;;;;;;;;;;;qBATv3B,CAAN;mBAAiB,CAAC;;;;;0BASwvY,CAAC;;;;;;EADpxY"}

package/dist/tools/ctx-note/tools.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"tools.d.ts","sourceRoot":"","sources":["../../../src/tools/ctx-note/tools.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,YAAY,CAAC;AAC3C,OAAO,EAAE,KAAK,cAAc,EAAQ,MAAM,qBAAqB,CAAC;AAchE,MAAM,WAAW,eAAe;IAC5B,EAAE,EAAE,QAAQ,CAAC;IACb,cAAc,CAAC,EAAE,OAAO,CAAC;IACzB,eAAe,CAAC,EAAE,MAAM,CAAC;CAC5B;AAkND,wBAAgB,kBAAkB,CAAC,IAAI,EAAE,eAAe,GAAG,MAAM,CAAC,MAAM,EAAE,cAAc,CAAC,CAIxF"}
+{"version":3,"file":"tools.d.ts","sourceRoot":"","sources":["../../../src/tools/ctx-note/tools.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,YAAY,CAAC;AAC3C,OAAO,EAAE,KAAK,cAAc,EAAQ,MAAM,qBAAqB,CAAC;AAchE,MAAM,WAAW,eAAe;IAC5B,EAAE,EAAE,QAAQ,CAAC;IACb,cAAc,CAAC,EAAE,OAAO,CAAC;IACzB,eAAe,CAAC,EAAE,MAAM,CAAC;CAC5B;AAgND,wBAAgB,kBAAkB,CAAC,IAAI,EAAE,eAAe,GAAG,MAAM,CAAC,MAAM,EAAE,cAAc,CAAC,CAIxF"}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@cortexkit/opencode-magic-context",
-  "version": "0.6.2",
+  "version": "0.7.0",
   "type": "module",
   "description": "OpenCode plugin for Magic Context — cross-session memory and context management",
   "main": "dist/index.js",

package/src/tui/data/context-db.ts

@@ -272,7 +272,7 @@ export function loadSidebarSnapshot(sessionId: string, directory: string): Sideb
             for (const c of compRows) {
                 compartmentTokens += Math.ceil(
                     `<compartment start="${c.start_message}" end="${c.end_message}" title="${c.title}">\n${c.content}\n</compartment>\n`
-                        .length / 4,
+                        .length / 3.5,
                 );
             }
         } catch {
@@ -285,7 +285,7 @@ export function loadSidebarSnapshot(sessionId: string, directory: string): Sideb
                 )
                 .all(sessionId);
             for (const f of factRows) {
-                factTokens += Math.ceil(`* ${f.content}\n`.length / 4);
+                factTokens += Math.ceil(`* ${f.content}\n`.length / 3.5);
             }
         } catch {
             /* session_facts table may not exist */
@@ -294,7 +294,7 @@ export function loadSidebarSnapshot(sessionId: string, directory: string): Sideb
         if (meta) {
             const cached = (meta as Record<string, unknown>).memory_block_cache;
             if (typeof cached === "string" && cached.length > 0) {
-                memoryTokens = Math.ceil(cached.length / 4);
+                memoryTokens = Math.ceil(cached.length / 3.5);
             }
         }
 
@@ -514,14 +514,14 @@ export function loadStatusDetail(
 
             let histTokens = 0;
             for (const c of compartments) {
-                // ~4 chars per token estimate (same as plugin's estimateTokens)
+                // ~3.5 chars per token estimate (matches plugin's estimateTokens)
                 histTokens += Math.ceil(
                     `<compartment start="${c.start_message}" end="${c.end_message}" title="${c.title}">\n${c.content}\n</compartment>\n`
-                        .length / 4,
+                        .length / 3.5,
                 );
             }
             for (const f of facts) {
-                histTokens += Math.ceil(`* ${f.content}\n`.length / 4);
+                histTokens += Math.ceil(`* ${f.content}\n`.length / 3.5);
             }
             detail.historyBlockTokens = histTokens;