@polycode-projects/the-mechanical-code-talker 5.0.7 → 5.0.9

package/README.md

@@ -1,5 +1,15 @@
 # tmct — The Mechanical Code Talker
 
+[![npm version](https://img.shields.io/npm/v/@polycode-projects/the-mechanical-code-talker)](https://www.npmjs.com/package/@polycode-projects/the-mechanical-code-talker)
+[![npm downloads](https://img.shields.io/npm/dm/@polycode-projects/the-mechanical-code-talker)](https://www.npmjs.com/package/@polycode-projects/the-mechanical-code-talker)
+[![licence](https://img.shields.io/npm/l/@polycode-projects/the-mechanical-code-talker)](https://gitlab.com/polycode-projects/the-mechanical-code-talker/-/blob/main/LICENSE)
+[![live demos](https://img.shields.io/badge/demos-tmct.polycode.co.uk-blue)](https://tmct.polycode.co.uk)
+
+> Canonical home: [GitLab](https://gitlab.com/polycode-projects/the-mechanical-code-talker).
+> Installs come from [npm](https://www.npmjs.com/package/@polycode-projects/the-mechanical-code-talker).
+> The [GitHub repo](https://github.com/polycode-public/the-mechanical-code-talker) is a
+> read-only mirror, synced hourly. Issues and merge requests go to GitLab.
+
 `@polycode-projects/the-mechanical-code-talker`
 
 A pure-JS, **no-LLM**, offline, **$0** chatbot in the ELIZA/PARRY lineage.
@@ -1499,6 +1509,11 @@ hardened:
 - A nightly **`npm audit` + OSV-Scanner** job watches dependencies.
 - Releases are published with **npm provenance** (`--provenance`).
 
+The npm tarball carries Sigstore-signed provenance naming the GitLab pipeline
+that built it. Every published version also gets a GitLab release tag pinned to
+the exact commit that pipeline ran against. Follow both and an install traces
+back to the source it was built from.
+
 The content-address hash is single-sourced in `src/domain/hash.mjs`, so the
 cross-version-stable fact-id contract has exactly one definition.
 

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@polycode-projects/the-mechanical-code-talker",
-  "version": "5.0.7",
+  "version": "5.0.9",
   "private": false,
   "type": "module",
   "description": "The Mechanical Code Talker (tmct) — a tolerant, offline, $0 chat surface that guides you toward precision queries about a software repository. ELIZA/PARRY-style but domain-obsessed with code. No model calls; indexes a repo on request (tmct index) or reads any producer's graph.",
@@ -96,6 +96,7 @@
     "check:readme": "TMCT_CHECK_README=1 node --disable-warning=ExperimentalWarning --test test-e2e/readme-examples.test.mjs",
     "e2e:browsers": "playwright install chromium",
     "gen:screenshots": "node scripts/gen-screenshots.mjs",
+    "gen:og-images": "node scripts/gen-og-images.mjs",
     "check:links": "node scripts/check-links.mjs",
     "check:pii": "node scripts/pii-lint.mjs",
     "check:pack": "node scripts/check-pack-manifest.mjs",
@@ -154,6 +155,7 @@
     "audit": "npm audit --audit-level=high",
     "audit:fix": "npm audit fix",
     "demo:build": "node scripts/build-demo-site.mjs",
+    "bench:receipts": "node scripts/bench-receipts.mjs",
     "roll": "node scripts/roll.mjs",
     "build:ask-bundle": "node scripts/build-ask-bundle.mjs",
     "build:chat-bundle": "node scripts/build-chat-bundle.mjs",

package/src/domain/interpret/normalize.mjs

@@ -235,6 +235,10 @@ const WONDERING_WRAPPER_RE = /^i(?:\s+was|\s+am|'m)?\s+(?:just\s+)?(?:wonder(?:i
  *  ("what the parser does with X …") is never re-inverted. */
 const EMBEDDED_WHATIS_RE = /^what\s+((?:an?\s+|the\s+)?[\w'-]+(?:\s+[\w'-]+){0,2})\s+(is|are)\??$/i;
 const EMBEDDED_MEANS_RE = /^what\s+((?:an?\s+|the\s+)?[\w'-]+(?:\s+[\w'-]+){0,2})\s+means\??$/i;
+/** The memory-question sibling: "tell me what you know about X" peels to
+ *  "what you know about X", which keeps the same declarative order and misses
+ *  the memory lane's own "what do you know about X" shape. */
+const EMBEDDED_KNOW_ABOUT_RE = /^what\s+you\s+(know|remember)\s+about\s+(.+?)\??$/i;
 /** show/give-me presentation bridge: a kind-listing remainder is left
  *  untouched, a relation/interrogative remainder unwraps to itself, anything
  *  else bridges to "describe <thing>". */
@@ -309,6 +313,8 @@ export function applyPreambleFrames(text) {
     if (m) q = `what ${m[2].toLowerCase()} ${m[1].trim()}`;
     m = q.match(EMBEDDED_MEANS_RE);
     if (m) q = `what does ${m[1].trim()} mean`;
+    m = q.match(EMBEDDED_KNOW_ABOUT_RE);
+    if (m) q = `what do you ${m[1].toLowerCase()} about ${m[2].trim()}`;
     m = q.match(SHOW_GIVE_ME_RE);
     if (m) {
       const rest = m[1].trim();

package/src/services/chat.mjs

@@ -14071,14 +14071,27 @@ async function runAsk(query, { config, source, graph, focus, last, templates, me
     // graph entity.
     // Contraction-expanded, so "what's X" earns the same offer "what is X"
     // does. Both shapes below anchor on the written-out copula.
-    const offerSrc = expandContractions(String(query).trim());
-    const knowAboutTerm = offerSrc.match(KNOW_ABOUT_RE)?.[1]?.trim();
+    //
     // "who is grelb" asks about a term the same way "what is grelb" does, and
     // a name is exactly what a person teaches next — without this the who-form
     // dead-ends on the bare grammar wall while its what-form twin offers the
     // teach phrasing.
-    const whoTerm = shortTermQuestionTerm(offerSrc) ? offerSrc.match(WHO_IS_BARE_RE)?.[1]?.trim() : null;
-    const offerTerm = knowAboutTerm || metaTermOf(offerSrc, envelope) || whoTerm;
+    const teachableTermOf = (src) => {
+      const knowAbout = src.match(KNOW_ABOUT_RE)?.[1]?.trim();
+      const who = shortTermQuestionTerm(src) ? src.match(WHO_IS_BARE_RE)?.[1]?.trim() : null;
+      return { knowAbout, term: knowAbout || metaTermOf(src, envelope) || who };
+    };
+    const offerSrc = expandContractions(String(query).trim());
+    // All three shapes anchor at the start of the string, so a politeness or
+    // modal wrapper ("please tell me what a grelb is") hides the term from
+    // every one of them and the turn dead-ends on the bare wall instead. The
+    // peeled form is a fallback, tried only when the raw one names nothing, so
+    // a query that already matched resolves exactly as before.
+    let { knowAbout: knowAboutTerm, term: offerTerm } = teachableTermOf(offerSrc);
+    if (!offerTerm) {
+      const peeledSrc = applyPreambleFrames(offerSrc);
+      if (peeledSrc !== offerSrc) ({ knowAbout: knowAboutTerm, term: offerTerm } = teachableTermOf(peeledSrc));
+    }
     // A term that LEADS with a bindable anaphor ("it used for", from an
     // unresolved "what is it used for") is a pronoun that failed to bind,
     // not a teachable subject — offering to learn facts about it would echo