@mrciphersmith/keryx 0.3.15 → 0.3.17

package/dist/core.js

@@ -1327,6 +1327,23 @@ function tokenize(text) {
 function tokenSet(text) {
   return new Set(tokenize(text));
 }
+function stem(token) {
+  let base = token;
+  if (base.length >= 6 && base.endsWith("ies")) {
+    base = `${base.slice(0, -3)}y`;
+  } else {
+    for (const suffix of ["ing", "edly", "ed", "es", "s"]) {
+      if (base.length - suffix.length >= 3 && base.endsWith(suffix)) {
+        base = base.slice(0, base.length - suffix.length);
+        break;
+      }
+    }
+  }
+  if (base.length >= 4 && base.endsWith("e")) {
+    base = base.slice(0, -1);
+  }
+  return base;
+}
 function jaccard(a, b) {
   if (a.size === 0 || b.size === 0) {
     return 0;
@@ -1749,7 +1766,7 @@ var init_lifecycle = __esm(() => {
 function searchEntries(entries, query, filters, config, now) {
   validateQuery(query);
   validateSearchFilters(filters, now);
-  const queryTokens = [...new Set(tokenize(query))];
+  const queryTokens = [...new Set(tokenize(query).map(stem))];
   const today = now.toISOString().slice(0, 10);
   const filtered = entries.filter((entry) => matchesFilters(entry, filters) && classMatch(entry, filters.class) && temporalMatch(entry, filters.asOf ?? null, config, today, Boolean(filters.status)));
   const scored = filtered.map((entry) => scoreEntry(entry, queryTokens, filters, config, now));
@@ -1758,7 +1775,7 @@ function searchEntries(entries, query, filters, config, now) {
 function candidatePool(entries, query, filters, config, now, k) {
   validateQuery(query);
   validateSearchFilters(filters, now);
-  const queryTokens = [...new Set(tokenize(query))];
+  const queryTokens = [...new Set(tokenize(query).map(stem))];
   const today = now.toISOString().slice(0, 10);
   return entries.filter((entry) => matchesFilters(entry, filters) && classMatch(entry, filters.class) && temporalMatch(entry, filters.asOf ?? null, config, today, Boolean(filters.status))).map((entry) => scoreEntry(entry, queryTokens, filters, config, now)).sort((a, b) => b.score - a.score).slice(0, Math.min(MAX_GENERAL_RESULTS, Math.max(0, k)));
 }
@@ -1809,8 +1826,8 @@ function temporalMatch(entry, asOf, config, today, hasStatusFilter) {
   }, new Date(`${today}T00:00:00.000Z`)).current;
 }
 function scoreEntry(entry, queryTokens, filters, config, now) {
-  const bodyTokens = tokenSet(`${entry.title} ${entry.summary} ${entry.details} ${entry.tags.join(" ")}`);
-  const titleTokens = tokenSet(entry.title);
+  const bodyTokens = new Set([...tokenSet(`${entry.title} ${entry.summary} ${entry.details} ${entry.tags.join(" ")}`)].map(stem));
+  const titleTokens = new Set([...tokenSet(entry.title)].map(stem));
   let hits = 0;
   let titleHits = 0;
   for (const token of queryTokens) {
@@ -20454,6 +20471,7 @@ __export(exports_service4, {
   createMemoryService: () => createMemoryService,
   filterEntriesForHarness: () => filterEntriesForHarness,
   isMemoryHarnessId: () => isMemoryHarnessId,
+  loadEmbeddingIndex: () => loadEmbeddingIndex,
   memoryAllowedRelativePaths: () => memoryAllowedRelativePaths,
   memoryHandoff: () => memoryHandoff,
   memoryHarnessVisibilityByPath: () => memoryHarnessVisibilityByPath,
@@ -20775,6 +20793,7 @@ var init_service5 = __esm(() => {
   init_harness_identity();
   init_embedding();
   init_types();
+  init_embedding();
 });
 
 // src/wiki/ask.ts
@@ -27208,6 +27227,7 @@ var exports_service6 = {};
 __export(exports_service6, {
   UnknownGraphTargetError: () => UnknownGraphTargetError,
   buildAffectedReport: () => buildAffectedReport,
+  checkGraphStaleness: () => checkGraphStaleness,
   createGdgraphService: () => createGdgraphService
 });
 
@@ -28124,6 +28144,7 @@ async function writeRepomap(cwd, graph, config, options = {}) {
 
 // src/gdgraph/service.ts
 init_affected_report();
+init_staleness();
 
 class UnknownGraphTargetError extends Error {
   target;
@@ -28169,7 +28190,8 @@ init_json();
 var exports_service7 = {};
 __export(exports_service7, {
   createCodeHealthService: () => createCodeHealthService,
-  gateExitCode: () => gateExitCode
+  gateExitCode: () => gateExitCode,
+  readWikiFreshnessMetric: () => readWikiFreshnessMetric
 });
 import path95 from "path";
 
@@ -28331,7 +28353,8 @@ function computeGate2(input) {
   }
   const missingOptional = sources.filter((s) => !s.required && s.status === "missing");
   for (const source of missingOptional) {
-    reasons.push(`OPTIONAL: ${source.source} source missing`);
+    const detail = source.error ? `: ${source.error}` : "";
+    reasons.push(`OPTIONAL: ${source.source} source missing${detail}`);
   }
   const brokenOptional = sources.filter((s) => !s.required && s.status === "configured-but-failed");
   if (brokenOptional.length > 0) {
@@ -30148,6 +30171,12 @@ function errorCodeSuffix(error) {
   const code = safeErrorCode(error);
   return code ? ` (${code})` : "";
 }
+function missingSourceReason(sourceId) {
+  if (sourceId === "tests") {
+    return "no `bun` binary found (checked node_modules/.bin and PATH)";
+  }
+  return;
+}
 var KNOWN_VALIDATION_ERRORS = new Set([
   "ESLint JSON format was not recognized",
   "ESLint JSON parse failed",
@@ -30189,7 +30218,8 @@ async function runAdapter(adapter, ctx, cfg, stamp) {
     };
   }
   if (status === "skipped" || status === "missing") {
-    return { info: { ...base, status }, findings: [] };
+    const reason = missingSourceReason(adapter.id);
+    return { info: { ...base, status, ...reason !== undefined ? { error: reason } : {} }, findings: [] };
   }
   let raw;
   try {
@@ -30203,7 +30233,7 @@ async function runAdapter(adapter, ctx, cfg, stamp) {
       } catch (error) {
         if (error instanceof NoImportError) {
           if (adapter.id === "tests") {
-            return { info: { ...base, status: "missing" }, findings: [] };
+            return { info: { ...base, status }, findings: [] };
           }
           raw = await adapter.run(ctx);
         } else {
@@ -37016,6 +37046,18 @@ var HELP_GROUPS = [
     summary: "Grouped command help by task \u2014 keryx help [group|command]."
   },
   { kind: "slash", name: "/help", group: "Start here", summary: "Show available commands, grouped by task." },
+  {
+    kind: "cli",
+    name: "doctor",
+    group: "Start here",
+    summary: "One-page health check: version, Bun floor, ripgrep, sandbox, providers, MCP, integrations, standard, worktrees, graph/wiki freshness."
+  },
+  {
+    kind: "slash",
+    name: "/doctor",
+    group: "Start here",
+    summary: "Same one-page health check, inside the session."
+  },
   {
     kind: "cli",
     name: "auth",

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@mrciphersmith/keryx",
-  "version": "0.3.15",
+  "version": "0.3.17",
   "description": "Version-controlled project context for AI coding agents: code graph, architecture wiki, project memory, relevant tests, quality signals, and task flows.",
   "private": false,
   "publishConfig": {

package/src/gdgraph/service.ts

@@ -18,6 +18,13 @@ import type { GraphData } from "./types";
 // facade rule).
 export { buildAffectedReport, type AffectedReport, type AffectedReportOptions } from "./affected-report";
 
+// Flow 353 (P0 W5, AC1): re-exported so `commands/doctor.ts`'s aggregate
+// "graph/wiki freshness" check can ask the SAME staleness question
+// `commands/gdgraph.ts` already does, through this facade rather than a
+// second direct edge into `gdgraph/staleness.ts` (the same facade rule
+// `buildAffectedReport` above already follows).
+export { checkGraphStaleness, type StalenessCheck, type StalenessStatus } from "./staleness";
+
 export interface GdgraphService {
   build(cwd: string): Promise<{ nodes: number; edges: number; summaryPath: string }>;
   loadGraph(cwd: string): Promise<GraphData>;