Add context freshness and drift checks

Author: whut09

.agent-context/AGENTS.generated.md

@@ -22,7 +22,7 @@ L0 operating rules. Keep this file loaded by default; load deeper context only w
 - Entrypoint: `src/mcp/server.ts`
 - Anchor: `src/outputs/task-harness.ts` - 5 exports, 67 symbols
 - Anchor: `src/core/token-estimator.ts` - 7 exports, 15 symbols
-- Anchor: `src/core/context-builder.ts` - 2 exports, 15 symbols
+- Anchor: `src/core/freshness.ts` - 9 exports, 57 symbols
 
 ## Commands
 - Run: `npm run dev`

.agent-context/architecture.md

@@ -10,8 +10,8 @@ This document is generated from static repository signals. Treat it as a startin
 
 ## Important Modules
 - `outputs`: outputs contains 20 files and depends on core.
-- `core`: core contains 16 files and depends on analyzers, config, llm.
-- `test`: test contains 23 files and depends on analyzers, benchmarks, cli, config, core, mcp, outputs, retrievers.
+- `core`: core contains 17 files and depends on analyzers, config, llm, outputs.
+- `test`: test contains 24 files and depends on analyzers, benchmarks, cli, config, core, mcp, outputs, retrievers.
 - `retrievers`: retrievers contains 6 files and depends on core, outputs.
 - `analyzers`: analyzers contains 6 files and depends on core.
 - `benchmarks/fixtures/small-ts-app`: benchmarks/fixtures/small-ts-app contains 9 files.

.agent-context/contracts/architecture.contract.json

@@ -123,9 +123,10 @@
       "imports": [
         "analyzers",
         "config",
-        "llm"
+        "llm",
+        "outputs"
       ],
-      "summary": "core contains 16 files and depends on analyzers, config, llm."
+      "summary": "core contains 17 files and depends on analyzers, config, llm, outputs."
     },
     {
       "name": "test",
@@ -142,7 +143,7 @@
         "outputs",
         "retrievers"
       ],
-      "summary": "test contains 23 files and depends on analyzers, benchmarks, cli, config, core, mcp, outputs, retrievers."
+      "summary": "test contains 24 files and depends on analyzers, benchmarks, cli, config, core, mcp, outputs, retrievers."
     },
     {
       "name": "retrievers",

.agent-context/contracts/module-boundaries.json

@@ -60,7 +60,8 @@
         "src/analyzers/**",
         "src/config/**",
         "src/core/**",
-        "src/llm/**"
+        "src/llm/**",
+        "src/outputs/**"
       ],
       "forbiddenImports": [
         "**/*.generated.*",
@@ -75,12 +76,14 @@
       "observedImports": [
         "analyzers",
         "config",
-        "llm"
+        "llm",
+        "outputs"
       ],
       "publicFiles": [
         "src/core/cache.ts",
         "src/core/context-builder.ts",
         "src/core/file-classifier.ts",
+        "src/core/freshness.ts",
         "src/core/git.ts",
         "src/core/graph.ts",
         "src/core/indexer.ts",

.agent-context/contracts/test.contract.json

@@ -17,6 +17,7 @@ graph TD
   core["core"] --> analyzers["analyzers"]
   core["core"] --> config["config"]
   core["core"] --> llm["llm"]
+  core["core"] --> outputs["outputs"]
   llm["llm"] --> core["core"]
   mcp["mcp"] --> core["core"]
   mcp["mcp"] --> outputs["outputs"]
@@ -45,26 +46,27 @@ graph TD
 | benchmarks/fixtures/monorepo/packages/web | benchmarks/fixtures/monorepo/packages/config | 1 |
 | cli | benchmarks | 1 |
 | cli | config | 1 |
-| cli | core | 7 |
+| cli | core | 8 |
 | cli | outputs | 9 |
 | cli | retrievers | 1 |
 | config | core | 2 |
 | core | analyzers | 4 |
 | core | config | 1 |
 | core | llm | 1 |
+| core | outputs | 3 |
 | llm | core | 1 |
 | mcp | core | 1 |
 | mcp | outputs | 5 |
 | mcp | retrievers | 2 |
-| outputs | core | 29 |
+| outputs | core | 30 |
 | retrievers | core | 3 |
 | retrievers | outputs | 2 |
 | test | analyzers | 3 |
 | test | benchmarks | 1 |
 | test | cli | 1 |
 | test | config | 3 |
-| test | core | 24 |
+| test | core | 27 |
 | test | mcp | 1 |
-| test | outputs | 11 |
+| test | outputs | 12 |
 | test | retrievers | 1 |
 | test/fixtures/monorepo/packages/web | test/fixtures/monorepo/packages/api | 1 |