Merge pull request #91 from PatrickSys/feat/phase-8-tighten-search-contract

feat: tighten search contract (Phase 8 - DISC-01 + SAFE-01)

Author: PatrickSys

package.json

@@ -141,7 +141,7 @@
     "chokidar": "^3.6.0",
     "fuse.js": "^7.0.0",
     "glob": "^10.3.10",
-    "hono": "^4.12.5",
+    "hono": "^4.12.12",
     "ignore": "^5.3.1",
     "typescript": "^5.3.3",
     "uuid": "^9.0.1",
@@ -175,7 +175,7 @@
     ],
     "overrides": {
       "@modelcontextprotocol/sdk>ajv": "8.18.0",
-      "@modelcontextprotocol/sdk>@hono/node-server": "1.19.11",
+      "@modelcontextprotocol/sdk>@hono/node-server": "1.19.13",
       "@modelcontextprotocol/sdk>express-rate-limit": "8.2.2",
       "@huggingface/transformers>onnxruntime-node": "1.24.2",
       "path-to-regexp": "8.4.0",
@@ -185,7 +185,7 @@
       "readdirp>picomatch": "2.3.2",
       "minimatch": "10.2.3",
       "rollup": "4.59.0",
-      "hono@<4.12.7": ">=4.12.7",
+      "hono@<4.12.12": ">=4.12.12",
       "tmp": "0.2.4"
     }
   }

pnpm-lock.yaml

@@ -44,6 +44,8 @@ interface BuildEvidenceLockInput {
   searchQualityStatus?: 'ok' | 'low_confidence';
   /** Impact coverage: number of known callers covered by results */
   impactCoverage?: { covered: number; total: number };
+  /** Index age signal: fresh (<24h), aging (24h–7d), stale (>7d) */
+  indexFreshness?: 'fresh' | 'aging' | 'stale';
 }
 
 function strengthFactor(strength: EvidenceStrength): number {
@@ -204,8 +206,22 @@ export function buildEvidenceLock(input: BuildEvidenceLockInput): EvidenceLock {
     }
   }
 
+  // Freshness gate: stale index forces block; aging index warns without changing status.
+  if (input.indexFreshness === 'stale') {
+    status = 'block';
+    nextAction = 'Index is stale (>7 days). Run refresh_index before editing.';
+    if (!gaps.includes('Index is stale')) {
+      gaps.push('Index is stale (>7 days) — results may be significantly out of date');
+    }
+  } else if (input.indexFreshness === 'aging') {
+    if (!gaps.includes('Index is aging')) {
+      gaps.push('Index is aging (>24h) — results may not reflect recent changes');
+    }
+  }
+
   const readyToEdit =
     status === 'pass' &&
+    input.indexFreshness !== 'stale' &&
     (!epistemicStress || !epistemicStress.abstain) &&
     input.searchQualityStatus !== 'low_confidence';