@dzhechkov/harness-core 0.8.42 → 0.8.44

package/dist/text-mangling.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"text-mangling.js","sourceRoot":"","sources":["../src/text-mangling.ts"],"names":[],"mappings":"AASA,MAAM,eAAe,GAAG,EAAE,CAAC;AAC3B,MAAM,iBAAiB,GAAG,EAAE,CAAC;AAE7B,MAAM,UAAU,iBAAiB,CAAC,IAAY,EAAE,IAAgB;IAC9D,qFAAqF;IACrF,MAAM,QAAQ,GAAoB,EAAE,CAAC;IACrC,MAAM,GAAG,GAAG,CAAC,IAA2B,EAAE,EAAU,EAAQ,EAAE;QAC5D,QAAQ,CAAC,IAAI,CAAC,EAAE,IAAI,EAAE,EAAE,EAAE,OAAO,EAAE,IAAI,CAAC,KAAK,CAAC,EAAE,EAAE,EAAE,GAAG,EAAE,CAAC,EAAE,CAAC,CAAC;IAChE,CAAC,CAAC;IACF,MAAM,KAAK,GAAG,2CAA2C,CAAC;IAC1D,MAAM,MAAM,GAAG,qCAAqC,CAAC;IACrD,MAAM,QAAQ,GAAG,4CAA4C,CAAC;IAC9D,KAAK,MAAM,KAAK,IAAI,IAAI,CAAC,QAAQ,CAAC,KAAK,CAAC;QAAE,GAAG,CAAC,yBAAyB,EAAE,KAAK,CAAC,KAAK,CAAC,CAAC;IACtF,KAAK,MAAM,KAAK,IAAI,IAAI,CAAC,QAAQ,CAAC,MAAM,CAAC;QAAE,GAAG,CAAC,gBAAgB,EAAE,KAAK,CAAC,KAAK,CAAC,CAAC;IAC9E,KAAK,MAAM,KAAK,IAAI,IAAI,CAAC,QAAQ,CAAC,QAAQ,CAAC;QAAE,GAAG,CAAC,gBAAgB,EAAE,KAAK,CAAC,KAAK,CAAC,CAAC;IAChF,IAAI,IAAI,CAAC,IAAI,EAAE,CAAC,MAAM,GAAG,CAAC,IAAI,KAAK,OAAO,CAAC,CAAC,CAAC,eAAe,CAAC,CAAC,CAAC,iBAAiB,CAAC,EAAE,CAAC;QAClF,GAAG,CAAC,gBAAgB,EAAE,CAAC,CAAC,CAAC;IAC3B,CAAC;IACD,OAAO,QAAQ,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,EAAE,GAAG,CAAC,CAAC,EAAE,CAAC,CAAC;AAC9C,CAAC"}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@dzhechkov/harness-core",
-  "version": "0.8.42",
+  "version": "0.8.44",
   "description": "Shared harness logic - skill loading, additive apply, and the init/sync/verify/doctor operations.",
   "type": "module",
   "license": "MIT",
@@ -38,17 +38,17 @@
     "lint": "tsc -p tsconfig.json --noEmit"
   },
   "dependencies": {
-    "@dzhechkov/adapter-agents-md": "^0.1.8",
-    "@dzhechkov/adapter-claude": "^0.2.8",
-    "@dzhechkov/adapter-codex": "^0.2.7",
-    "@dzhechkov/adapter-copilot": "^0.1.8",
-    "@dzhechkov/adapter-cursor": "^0.1.8",
-    "@dzhechkov/adapter-gemini": "^0.1.8",
-    "@dzhechkov/adapter-hermes": "^0.2.7",
-    "@dzhechkov/adapter-openclaude": "^0.1.7",
-    "@dzhechkov/adapter-opencode": "^0.2.7",
-    "@dzhechkov/adapter-windsurf": "^0.1.8",
-    "@dzhechkov/core": "^0.2.23",
+    "@dzhechkov/adapter-agents-md": "^0.1.9",
+    "@dzhechkov/adapter-claude": "^0.2.9",
+    "@dzhechkov/adapter-codex": "^0.2.8",
+    "@dzhechkov/adapter-copilot": "^0.1.9",
+    "@dzhechkov/adapter-cursor": "^0.1.9",
+    "@dzhechkov/adapter-gemini": "^0.1.9",
+    "@dzhechkov/adapter-hermes": "^0.2.8",
+    "@dzhechkov/adapter-openclaude": "^0.1.8",
+    "@dzhechkov/adapter-opencode": "^0.2.8",
+    "@dzhechkov/adapter-windsurf": "^0.1.9",
+    "@dzhechkov/core": "^0.2.27",
     "@dzhechkov/memory": "^0.2.23",
     "proper-lockfile": "^4.1.2",
     "yaml": "^2.0.0"

package/sbom.json

@@ -25,7 +25,7 @@
       "hashes": [
         {
           "alg": "SHA-256",
-          "content": "921bc6f09dc9a270ab3330a90138b4c93a6c2edd91c665bab964e752ebd160f7"
+          "content": "f80660a868b436e0ae7b3a23d5b104a8e882bf9f9fc7bfc22f7c0023ec76f2d6"
         }
       ]
     },
@@ -405,7 +405,7 @@
       "hashes": [
         {
           "alg": "SHA-256",
-          "content": "721a78bc22d9aae2141fab974f0ca924d527c1be4d42922e4ea55231efea27f6"
+          "content": "c6dcbe1c8ddb221aace37ef1518afc357b2b541a440619265d435d6c4b24cc54"
         }
       ]
     },
@@ -415,7 +415,7 @@
       "hashes": [
         {
           "alg": "SHA-256",
-          "content": "cd4a7d917a2a85365e44c177d172fb2e88ad6e874edc6a4702664b7c6b699575"
+          "content": "c93a224929b4b864f60c0812f526acf7d07a9f4e138aae576687cadafc90f4b5"
         }
       ]
     },
@@ -425,7 +425,7 @@
       "hashes": [
         {
           "alg": "SHA-256",
-          "content": "f6774d037b9be34a45a0914fbcffdcba48f4260d75d8eb2bfe59004d00fbbb0b"
+          "content": "a9a6486b8e1de9c1d05a37b391bcb54cb5a257f671ceb5ebe4b7e366a9631ea2"
         }
       ]
     },
@@ -2915,7 +2915,7 @@
       "hashes": [
         {
           "alg": "SHA-256",
-          "content": "82c90ed5bf1686c900a71b35a8e3fb4b085944b5c70fd9806b771acca7669adf"
+          "content": "c18f5b65c615b023a3c3f576b2619692bf9a2862f44ba8acb06b5a4e025077e0"
         }
       ]
     },
@@ -2925,7 +2925,7 @@
       "hashes": [
         {
           "alg": "SHA-256",
-          "content": "fc5b2cfd1de142e4f9bcec6510ae7c6742eb9951b437ca21c338b61d8ba4acbf"
+          "content": "ddd45dd0f6cdd8c83fe98a3a78ccfb85da04b2c9df1e52973a65f2526900d418"
         }
       ]
     },
@@ -2935,7 +2935,7 @@
       "hashes": [
         {
           "alg": "SHA-256",
-          "content": "10f7d98fa24cbc087037e859c13cf52b759bae325429c6f49b1fa275cff3d403"
+          "content": "1ff621602e84ea254c7c865fd8420ced42570345c8e099ee098e5d25f5c5a9db"
         }
       ]
     },
@@ -2945,7 +2945,7 @@
       "hashes": [
         {
           "alg": "SHA-256",
-          "content": "078bb3c965030971662cca88b6706725aceda1f2bce6fcac3095ea6351fe00b4"
+          "content": "a7879e54955ef542d3cda7884d3eac9a362f3f2c2b1dbc8d03f190e479df47c3"
         }
       ]
     },
@@ -3829,6 +3829,46 @@
         }
       ]
     },
+    {
+      "type": "file",
+      "name": "dist/memory-index-check.d.ts",
+      "hashes": [
+        {
+          "alg": "SHA-256",
+          "content": "8dc2b00ea8ab550a29d0f5612c3b643724948a1f9ebb3e2c1258d6601836c66f"
+        }
+      ]
+    },
+    {
+      "type": "file",
+      "name": "dist/memory-index-check.d.ts.map",
+      "hashes": [
+        {
+          "alg": "SHA-256",
+          "content": "788ec70ba0443c3d3f8e1599548f54013d4d6ae864ccac1b3406d84d55e443df"
+        }
+      ]
+    },
+    {
+      "type": "file",
+      "name": "dist/memory-index-check.js",
+      "hashes": [
+        {
+          "alg": "SHA-256",
+          "content": "43ba71733350f5f91ea98ed3b94baa61fe3b454543d687524e51d8cb135d7022"
+        }
+      ]
+    },
+    {
+      "type": "file",
+      "name": "dist/memory-index-check.js.map",
+      "hashes": [
+        {
+          "alg": "SHA-256",
+          "content": "66f08674ced70cfcd60bdf14fd3dded0052535b608edb31a5be165dc10ccc777"
+        }
+      ]
+    },
     {
       "type": "file",
       "name": "dist/model-recommender.d.ts",
@@ -4109,6 +4149,46 @@
         }
       ]
     },
+    {
+      "type": "file",
+      "name": "dist/pack-artifact.d.ts",
+      "hashes": [
+        {
+          "alg": "SHA-256",
+          "content": "ac53c92fe8be66aa73580b13e273321e229eeb9c2f7c3ce82acd4d0cebcfaae4"
+        }
+      ]
+    },
+    {
+      "type": "file",
+      "name": "dist/pack-artifact.d.ts.map",
+      "hashes": [
+        {
+          "alg": "SHA-256",
+          "content": "fc5ec05405710ec6cb543121d9c6f14ba9c5c11e5edc918e15622c9efc24bfe8"
+        }
+      ]
+    },
+    {
+      "type": "file",
+      "name": "dist/pack-artifact.js",
+      "hashes": [
+        {
+          "alg": "SHA-256",
+          "content": "6ad53e00466d96653f88ab0ec69f9a2d63552023bf5b851ce37918f44466ba8f"
+        }
+      ]
+    },
+    {
+      "type": "file",
+      "name": "dist/pack-artifact.js.map",
+      "hashes": [
+        {
+          "alg": "SHA-256",
+          "content": "3b1537b2de837841488829eaf12ee76fc405dbe12716a5b6677b2339ac5276cb"
+        }
+      ]
+    },
     {
       "type": "file",
       "name": "dist/pack-inventory.d.ts",
@@ -4445,7 +4525,7 @@
       "hashes": [
         {
           "alg": "SHA-256",
-          "content": "c0bce356cd6fff8aeb65022b72e180e845ff774f5b604e271447e36d6932a540"
+          "content": "fe20c556f01f1845f344886135d13357d5aea9f7260cf86d4758e82927053851"
         }
       ]
     },
@@ -4455,7 +4535,7 @@
       "hashes": [
         {
           "alg": "SHA-256",
-          "content": "0615de8e3af3ceb2e65426756736b69f3b877eea278535998719504ffb59bd43"
+          "content": "2a21b1817b07e27719c559bd37d78e87659bf1249ffdb7499efba1999d49c7c2"
         }
       ]
     },
@@ -4465,7 +4545,7 @@
       "hashes": [
         {
           "alg": "SHA-256",
-          "content": "b1974eb772e4ea8f6684c9724095e0a95e82d6dae9eb927645a967fb12f7c5c2"
+          "content": "1ee080ccc4b13bd8a1961d31284bc686860ca704e29c3b0b687a3106ccdc13c7"
         }
       ]
     },
@@ -4595,7 +4675,7 @@
       "hashes": [
         {
           "alg": "SHA-256",
-          "content": "8e39c9f1d527ddaaa8b8655ee1e2fa0ee005926e25da8c3218cf0fb9cbed5502"
+          "content": "612d932b140a0bc367a772fb6122275b509ff26a6359534f1cf3ce79539def1b"
         }
       ]
     },
@@ -4605,7 +4685,7 @@
       "hashes": [
         {
           "alg": "SHA-256",
-          "content": "257237bac3a1d173113b4525ea19dbb4f7984a08ad017ebdd7af164ba6cc7cfe"
+          "content": "120250c23f016ef260bd764b35ddca919da595b953fcaf7960ae228c4bdc65d2"
         }
       ]
     },
@@ -4615,7 +4695,7 @@
       "hashes": [
         {
           "alg": "SHA-256",
-          "content": "16ac3f704998f295ed42c112277482d6adfb5d26e4c8a4c89781d24b63118f6f"
+          "content": "da830c806d680362a0668623dd653add234ea9968511366b178c3b1657318d05"
         }
       ]
     },
@@ -4625,7 +4705,7 @@
       "hashes": [
         {
           "alg": "SHA-256",
-          "content": "8143d41cd1c706713fe6d9a742b71d9a28b3519a72072ca4683837ab54732d30"
+          "content": "e08511c5f7024e8d76472a68ed930b613fffc5a859788a3cbb20cf469a638fa0"
         }
       ]
     },
@@ -4715,7 +4795,7 @@
       "hashes": [
         {
           "alg": "SHA-256",
-          "content": "149d0d95689591db30c433eb84c4f6da93a100296e156a52672bc715ac832991"
+          "content": "5384d5e5b0be1dc5f41c376233a1182065edd26622ecf5608a8f73f7f04c9f81"
         }
       ]
     },
@@ -4725,7 +4805,7 @@
       "hashes": [
         {
           "alg": "SHA-256",
-          "content": "93a56cbdfd3acff3e95f42695478f3f04ebed664380506fa1085dbc8f729b0b6"
+          "content": "cee754875a0f78ef1b65457f07eb33a0045469596e22f6f3f3eef4ff989401c0"
         }
       ]
     },
@@ -4735,7 +4815,7 @@
       "hashes": [
         {
           "alg": "SHA-256",
-          "content": "d92c3e7382fc142dd2a53b6be27de3c866be34f9916020c9eaf20bdc3eae17f0"
+          "content": "e6fe3953003c79e5ce5065053c401d322fb186f40603bf7312beb5c2fb994969"
         }
       ]
     },
@@ -4745,7 +4825,7 @@
       "hashes": [
         {
           "alg": "SHA-256",
-          "content": "6a45842cd3083205cbff2438c60dc3bce98b23b5a87b0586d11114dba931f40d"
+          "content": "275fd7d74bd1345ffe8fa55ffced2272985662904dc7774f6b343b06730322b0"
         }
       ]
     },
@@ -7109,6 +7189,46 @@
         }
       ]
     },
+    {
+      "type": "file",
+      "name": "dist/text-mangling.d.ts",
+      "hashes": [
+        {
+          "alg": "SHA-256",
+          "content": "fa46a6aa1981ed6569a45c1a4d3ce99404db9ae6ca345f6fd16e3edb2ca00bd8"
+        }
+      ]
+    },
+    {
+      "type": "file",
+      "name": "dist/text-mangling.d.ts.map",
+      "hashes": [
+        {
+          "alg": "SHA-256",
+          "content": "414ba36e047efbf7460728884bec7509520ed6e7f95887bd423d98cc1e69a776"
+        }
+      ]
+    },
+    {
+      "type": "file",
+      "name": "dist/text-mangling.js",
+      "hashes": [
+        {
+          "alg": "SHA-256",
+          "content": "538b223f3bf30a0806df7ff68af7432b86972898bbc8932fe03786dc313e271a"
+        }
+      ]
+    },
+    {
+      "type": "file",
+      "name": "dist/text-mangling.js.map",
+      "hashes": [
+        {
+          "alg": "SHA-256",
+          "content": "184f7f29fc4472c4e6a82deeff6207fa884156d91c8679eaa020f62b46699dc0"
+        }
+      ]
+    },
     {
       "type": "file",
       "name": "dist/tg-post.d.ts",
@@ -7559,7 +7679,7 @@
         },
         {
           "name": "dz:canonical-json-sha256-v2",
-          "value": "e22f06c021fca1aa1332c3cc86f90c80ddb00bd164f74bf5d8bfe5fbfb444439"
+          "value": "0b881348f6c4b203b10ec7331e8cb5e0a44f6b4fd661e9340cba4e60a7042edb"
         }
       ]
     },
@@ -7659,7 +7779,7 @@
       "hashes": [
         {
           "alg": "SHA-256",
-          "content": "2334e9a0d6a06655c96a47a9c71263f60928de3cf6612899921c4fbeecd1a276"
+          "content": "75f32916bb73b3b8fccdcdfdd20aa5e9c9231a61be7670db83efe912b6250bd0"
         }
       ]
     },
@@ -8299,7 +8419,7 @@
       "hashes": [
         {
           "alg": "SHA-256",
-          "content": "a8227a49425c040c6fbf296f46c4c73a95cf31d978574e717be91d7e1ca08652"
+          "content": "ecbd56d2a04ff6a7fda5bff402bfd7f978db91a1b9559b33e5dfbe20da92390f"
         }
       ]
     },
@@ -8523,6 +8643,16 @@
         }
       ]
     },
+    {
+      "type": "file",
+      "name": "src/memory-index-check.ts",
+      "hashes": [
+        {
+          "alg": "SHA-256",
+          "content": "78baea4b55d0d19180040761050837a9f28bdd60112062a7d359ebfd78beed14"
+        }
+      ]
+    },
     {
       "type": "file",
       "name": "src/model-recommender.ts",
@@ -8593,6 +8723,16 @@
         }
       ]
     },
+    {
+      "type": "file",
+      "name": "src/pack-artifact.ts",
+      "hashes": [
+        {
+          "alg": "SHA-256",
+          "content": "7c7679225a5d5057ecd71f195d8dbda105a9082bc3ce257a5eddd9e47b7dadd1"
+        }
+      ]
+    },
     {
       "type": "file",
       "name": "src/pack-inventory.ts",
@@ -8679,7 +8819,7 @@
       "hashes": [
         {
           "alg": "SHA-256",
-          "content": "9c0aa7d6e030c5a165c8322ad8c32c7d4435a69afd0e7271272676704e6e26c6"
+          "content": "9d5a7418da2864535d5661cb6f3c2d7b8fc3e8cc98ef4e063370d841a7494abc"
         }
       ]
     },
@@ -8719,7 +8859,7 @@
       "hashes": [
         {
           "alg": "SHA-256",
-          "content": "5a7c2cffce4e62e4e859578b7014020670125e1ea68d4e04f2b1f6256c423b7a"
+          "content": "3d1805546b964d8bce68cc94cdf1d9dd5e7e6a558f112e73fe1faf0f1c445fd4"
         }
       ]
     },
@@ -8749,7 +8889,7 @@
       "hashes": [
         {
           "alg": "SHA-256",
-          "content": "4bb4dbe8a712c17a6df93ff86553a53364c66ea5a8b5caf694dc4992cb9e3e4b"
+          "content": "b0248fad94dc412820b0feae2d3cfd5796efac4d759a875c9063693bcd2c2a78"
         }
       ]
     },
@@ -9353,6 +9493,16 @@
         }
       ]
     },
+    {
+      "type": "file",
+      "name": "src/text-mangling.ts",
+      "hashes": [
+        {
+          "alg": "SHA-256",
+          "content": "61b4ef4f7d63fb395922145c9803a55f9dce6d46920fa3bbe280fa1af6235e78"
+        }
+      ]
+    },
     {
       "type": "file",
       "name": "src/tg-post.ts",

package/src/index.ts

@@ -308,6 +308,15 @@ export type {
   StoreMarkWriteOptions,
   StoreResetReceipt,
 } from './store-guard.js';
+export {
+  checkMemoryIndex,
+  MEMORY_INDEX_MAX_BYTES,
+  MEMORY_INDEX_MAX_LINE_CHARS,
+  MEMORY_INDEX_MIN_HOOK_SUPPORT,
+} from './memory-index-check.js';
+export type { MemoryIndexReport, Finding, FindingKind } from './memory-index-check.js';
+export { detectMangledText } from './text-mangling.js';
+export type { MangleKind, MangleSymptom } from './text-mangling.js';
 export { planStoreGuardPrune } from './store-guard-prune.js';
 export type {
   StoreGuardPruneBucket,
@@ -770,6 +779,8 @@ export type {
   ChainDefectAges,
   ChainedJournal,
 } from './event-chain.js';
+export { packArtifact, readWorkspaceVersions, UnknownWorkspaceSpecError } from './pack-artifact.js';
+export type { PackArtifactResult, ExecLike } from './pack-artifact.js';
 export { decideProvenance, environmentCanMintProvenance, publishArgv, matchesPublishFilter, discoverPackages, publishPackages, bumpPatch, compareVersions, findUnpackagedSkills, findUnpublishedWorkspaceFloors, rewriteWorkspaceSpecs, orderByDependencies, syncReadmeVersion, isChangelogEntryLine, changelogRegion, planReadmeVersionSync } from './publish.js';
 export type { ReadmeVersionSyncPlan, ReadmeSyncRewrite } from './publish.js';
 export { RELEASE_LINE_RE, parseReleaseLine, findReleaseLine, rewriteReleaseLine, shortPackageName } from './release-line.js';
@@ -816,7 +827,7 @@ export type {
 } from './release.js';
 export { formatPublishError } from './publish.js';
 // Sibling-drift + packed-install-smoke gates (feature publish-sibling-drift-gate, ADR-001).
-export { detectSiblingDrift, parseNpmPackInventory } from './publish-sibling-drift.js';
+export { detectSiblingDrift, parseNpmPackInventory, formatDriftFiles } from './publish-sibling-drift.js';
 export type {
   SiblingDriftStatus,
   InventorySource,

package/src/memory-index-check.ts

@@ -0,0 +1,93 @@
+import { Buffer } from 'node:buffer';
+import { stemToken, stems } from './stem.js';
+
+export const MEMORY_INDEX_MAX_BYTES = 24_000;
+export const MEMORY_INDEX_MAX_LINE_CHARS = 200;
+// Hook support is a lexical heuristic, not proof that a hook's meaning is preserved.
+// Shared conservative stems fold находку/находка → находк and подписью/подпись → подпис;
+// проверил ≠ проверка (verb/noun) and teacher ≠ teach remain distinct, without prefix matching.
+// Calibration history on the real index (108 judged lines): 2026-09-23 the coder measured a live
+// minimum of 0 at L83/L85/L114 and 15 lines under 0.5 — 14 were Russian hooks over English files
+// or other word forms (knowledge present), one (L76) linked the WRONG file. The lead rewrote those
+// hooks with words from their files; 2026-09-24 the live minimum is 0.5 exactly (QE F2 on 23.09 counted
+// 5 lines at the boundary on the then-index; re-measured 24.09 on the current index: 4 under the substring rule). The threshold stays the contract's 0.5; a hook at the boundary passes
+// (`support < min` fails), so the margin there is thin by construction.
+// Stem era (feature memory-index-hook-stems, 2026-09-24, lead on the host): with stem-to-stem support the
+// live index first showed ONE new finding — L46, support 2/6, a hook whose words the substring rule had
+// matched INSIDE other words (после/двух/ночь) — an honest downgrade, fixed in the memory file, not here;
+// after that: 0 findings, minimum 0.5 on exactly 2 lines (L18, L69 — measured with minHookSupport raised
+// just above 0.5 and counting `support 0.5` findings; the earlier "5" was a stale copy, QE F1), threshold unchanged.
+export const MEMORY_INDEX_MIN_HOOK_SUPPORT = 0.5;
+
+export type FindingKind = 'over-size' | 'long-line' | 'broken-link' | 'unindexed-file' | 'unsupported-hook' | 'duplicate-link';
+export type Finding = { kind: FindingKind; line?: number; file?: string; detail: string };
+export type MemoryIndexReport = { bytes: number; lines: number; findings: readonly Finding[] };
+
+/** Pure check: callers supply the index and sibling Markdown files (excluding MEMORY.md). */
+export function checkMemoryIndex(input: {
+  indexText: string;
+  files: ReadonlyMap<string, string>;
+  limits?: { maxBytes?: number; maxLineChars?: number; minHookSupport?: number };
+}): MemoryIndexReport {
+  const { indexText, files, limits } = input;
+  const maxBytes = limits?.maxBytes ?? MEMORY_INDEX_MAX_BYTES;
+  const maxLineChars = limits?.maxLineChars ?? MEMORY_INDEX_MAX_LINE_CHARS;
+  const minHookSupport = limits?.minHookSupport ?? MEMORY_INDEX_MIN_HOOK_SUPPORT;
+  const bytes = Buffer.byteLength(indexText, 'utf8');
+  const findings: Finding[] = [];
+  if (bytes > maxBytes) {
+    findings.push({ kind: 'over-size', detail: `${bytes} bytes exceeds maximum ${maxBytes}` });
+  }
+
+  // Count physical lines; a final newline terminates a line, rather than adding one.
+  const lines = indexText === '' ? [] : indexText.split(/\r?\n/u);
+  if (lines.at(-1) === '') lines.pop();
+  const indexed = new Map<string, number>();
+  const stemsByFile = new Map<string, Set<string>>();
+  for (const [offset, text] of lines.entries()) {
+    const line = offset + 1;
+    // String length measures UTF-16 code units, not bytes or Unicode code points.
+    if (text.length > maxLineChars) {
+      findings.push({ kind: 'long-line', line, detail: `${text.length} UTF-16 code units exceeds maximum ${maxLineChars}` });
+    }
+    const match = /^- \[(.*?)\]\((.*?)\)\s*—\s*(.*)$/u.exec(text);
+    if (match === null) continue;
+    const file = match[2]!;
+    const previous = indexed.get(file);
+    if (previous !== undefined) {
+      findings.push({ kind: 'duplicate-link', line, file, detail: `already linked on line ${previous}` });
+    } else {
+      indexed.set(file, line);
+    }
+    const content = files.get(file);
+    if (content === undefined) {
+      findings.push({ kind: 'broken-link', line, file, detail: 'linked file is absent' });
+      continue;
+    }
+    const tokens = (match[3]!.split(';', 1)[0]!.match(/[\p{L}\p{N}]{4,}/gu) ?? []).map(token => token.toLowerCase());
+    // Fewer than three tokens are too short for this heuristic to judge.
+    if (tokens.length < 3) continue;
+    let contentStems = stemsByFile.get(file);
+    if (contentStems === undefined) {
+      contentStems = new Set(stems(content));
+      stemsByFile.set(file, contentStems);
+    }
+    const missing = tokens.filter(token => !contentStems.has(stemToken(token)));
+    const supported = tokens.length - missing.length;
+    const support = supported / tokens.length;
+    if (support < minHookSupport) {
+      findings.push({
+        kind: 'unsupported-hook', line, file,
+        detail: `hook support ${support} (${supported}/${tokens.length}) below minimum ${minHookSupport}; missing tokens: ${missing.join(', ')}`,
+      });
+    }
+  }
+  for (const file of [...files.keys()].sort()) {
+    if (!indexed.has(file)) findings.push({ kind: 'unindexed-file', file, detail: 'file has no index entry' });
+  }
+  // Whole-index findings precede line findings; ties use kind, then file order.
+  findings.sort((a, b) => (a.line ?? 0) - (b.line ?? 0)
+    || (a.kind < b.kind ? -1 : a.kind > b.kind ? 1 : 0)
+    || ((a.file ?? '') < (b.file ?? '') ? -1 : (a.file ?? '') > (b.file ?? '') ? 1 : 0));
+  return { bytes, lines: lines.length, findings };
+}