@mrciphersmith/keryx 0.2.79 → 0.2.80

package/dist/cli.js

@@ -43320,6 +43320,10 @@ async function wikiCommand(args) {
     printHelp4();
     return;
   }
+  if (args.includes("--help") || args.includes("-h")) {
+    printHelp4();
+    return;
+  }
   if (command === "status") {
     await runStatus();
     return;
@@ -43677,6 +43681,11 @@ Usage:
                          # before the run; enrich can never itself accept a page (issue #391)
   keryx wiki context
   keryx wiki backlinks <wiki-page-or-code-file>
+  keryx wiki freshness            # read-only backlog: which pages the code moved under
+  keryx wiki refresh              # regenerate managed ## Reference blocks (WRITES pages)
+  keryx wiki verify --page <path> | --baseline
+                                  # stamp provenance; refuses to stamp the corpus silently
+  keryx wiki migrate-markers      # one-off: wrap existing Reference sections in markers
 
 Page types:
   architecture, domain-model, business-rule, user-scenario,
@@ -44178,8 +44187,21 @@ On git pull / branch switch, they run 'keryx sync' (advisory report). Run 'keryx
       continue;
     }
     const diff = await diffSince(cwd, provenance.commit);
-    const code = diff ? codeOnly(diff) : null;
-    if (!code || totalChanges(code) === 0) {
+    if (diff === null) {
+      anyStale = true;
+      if (apply) {
+        await applyModule(cwd, module, null, at);
+        console.log(`  \u2192 rebuilt from scratch; provenance named ${provenance.commit.slice(0, 8)}, which this repository does not have`);
+      } else {
+        console.log(`  cannot compare \u2014 provenance names ${provenance.commit.slice(0, 8)}, a revision this repository does not have`);
+        console.log("  (a branch that was squash-merged and deleted leaves exactly this)");
+        console.log("  \u2192 run `keryx sync --apply` to rebuild and re-record");
+      }
+      console.log("");
+      continue;
+    }
+    const code = codeOnly(diff);
+    if (totalChanges(code) === 0) {
       console.log(`  up to date (built at ${provenance.commit.slice(0, 8)})`);
       console.log("");
       continue;
@@ -55490,7 +55512,15 @@ var COMMAND_DESCRIPTORS = [
     module: "gdgraph",
     command: "gdgraph build",
     summary: "Build or refresh the code dependency graph for this project.",
-    intent: ["\u043F\u043E\u0441\u0442\u0440\u043E\u0439 \u0433\u0440\u0430\u0444", "\u043E\u0431\u043D\u043E\u0432\u0438 \u0433\u0440\u0430\u0444", "build the code graph", "rebuild graph", "reindex dependencies"],
+    intent: [
+      "\u043F\u043E\u0441\u0442\u0440\u043E\u0439 \u0433\u0440\u0430\u0444",
+      "\u043E\u0431\u043D\u043E\u0432\u0438 \u0433\u0440\u0430\u0444",
+      "\u043F\u0435\u0440\u0435\u0441\u0442\u0440\u043E\u0439 \u0433\u0440\u0430\u0444",
+      "build the code graph",
+      "rebuild graph",
+      "update graph",
+      "reindex dependencies"
+    ],
     args: [],
     json: false,
     read: false,
@@ -55656,23 +55686,62 @@ function listDescriptors(module) {
   const filtered = module ? COMMAND_DESCRIPTORS.filter((descriptor) => descriptor.module === module) : COMMAND_DESCRIPTORS;
   return [...filtered].sort((a, b) => sortKey(a) < sortKey(b) ? -1 : sortKey(a) > sortKey(b) ? 1 : 0);
 }
+var INTENT_FILLER = new Set([
+  "the",
+  "a",
+  "an",
+  "my",
+  "our",
+  "this",
+  "that",
+  "please",
+  "\u0438",
+  "\u043C\u043D\u0435",
+  "\u044D\u0442\u043E\u0442",
+  "\u044D\u0442\u0443",
+  "\u044D\u0442\u043E",
+  "\u043F\u043E\u0436\u0430\u043B\u0443\u0439\u0441\u0442\u0430"
+]);
+function intentTokens(value) {
+  return value.toLowerCase().split(/[^\p{L}\p{N}-]+/u).filter((token) => token.length > 0 && !INTENT_FILLER.has(token));
+}
 function matchIntent(query) {
   const normalized = query.trim().toLowerCase();
   if (normalized.length === 0) {
     return [];
   }
+  const queryTokens = new Set(intentTokens(normalized));
   const scored = listDescriptors().map((descriptor) => {
     let score = 0;
     for (const phrase of descriptor.intent) {
       const needle = phrase.toLowerCase();
       if (normalized.includes(needle) || needle.includes(normalized)) {
         score = Math.max(score, needle.length);
+        continue;
+      }
+      const phraseTokens = intentTokens(needle);
+      if (phraseTokens.length > 0 && phraseTokens.every((token) => queryTokens.has(token))) {
+        score = Math.max(score, needle.length - 1);
       }
     }
     return { descriptor, score };
   }).filter((entry) => entry.score > 0).sort((a, b) => b.score - a.score);
   return scored.map((entry) => entry.descriptor);
 }
+function suggestIntent(query, limit = 4) {
+  const queryTokens = new Set(intentTokens(query));
+  if (queryTokens.size === 0) {
+    return [];
+  }
+  return listDescriptors().map((descriptor) => {
+    let shared = 0;
+    for (const phrase of descriptor.intent) {
+      const overlap = intentTokens(phrase).filter((token) => queryTokens.has(token)).length;
+      shared = Math.max(shared, overlap);
+    }
+    return { descriptor, shared };
+  }).filter((entry) => entry.shared > 0).sort((a, b) => b.shared - a.shared).slice(0, limit).map((entry) => entry.descriptor);
+}
 function emitCommandsJson(module) {
   const payload = {
     schemaVersion: 1,
@@ -55759,6 +55828,14 @@ async function commandsCommand(args = []) {
     }
     if (matches.length === 0) {
       console.log(`No command matched intent: ${intent}`);
+      const suggestions = suggestIntent(intent);
+      if (suggestions.length > 0) {
+        console.log("");
+        console.log("Closest commands by shared words (none matched outright):");
+        for (const suggestion of suggestions) {
+          console.log(`  keryx ${suggestion.command} \u2014 ${suggestion.summary}`);
+        }
+      }
       process.exitCode = 1;
       return;
     }
@@ -66101,7 +66178,7 @@ import { spawnSync as spawnSync2 } from "child_process";
 // package.json
 var package_default = {
   name: "@mrciphersmith/keryx",
-  version: "0.2.79",
+  version: "0.2.80",
   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/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@mrciphersmith/keryx",
-  "version": "0.2.79",
+  "version": "0.2.80",
   "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": {