@polycode-projects/the-mechanical-code-talker 2.11.2 → 2.11.4

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@polycode-projects/the-mechanical-code-talker",
-  "version": "2.11.2",
+  "version": "2.11.4",
   "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; no codebase index of its own.",

package/src/domain/interpret/normalize.mjs

@@ -140,6 +140,10 @@ const BROWSING_PREAMBLE_RE = /^(?:just\s+(?:poking\s+around|looking\s+around|bro
 /** Repeated leading hedge adverb before a polite request verb ("maybe
  *  possibly tell me <Q>"). No delimiter required, unlike ACK_PREAMBLE_RE. */
 const HEDGE_ADVERB_PREAMBLE_RE = /^(?:(?:maybe|possibly|perhaps)\s+)+(.+)$/i;
+/** Leading courtesy marker ("please tell me <Q>", "please, what is a dog").
+ *  MODAL_WRAPPER_RE only strips a "please" INSIDE its own frame, so a
+ *  sentence that leads with one never reached any wrapper. */
+const PLEASE_PREAMBLE_RE = /^(?:please[\s,]+)+(.+)$/i;
 /** A floating "if it's not too much trouble" aside — a mid-sentence
  *  parenthetical, stripped wherever it appears (not start-anchored). */
 const TROUBLE_ASIDE_RE = /,?\s*if\s+(?:it'?s|it\s+is|that'?s|that\s+is)\s+not\s+too\s+much\s+(?:trouble|bother|hassle)\s*,?\s*/i;
@@ -148,9 +152,14 @@ const MODAL_WRAPPER_RE = /^(?:can|could|would|will)\s+you\s+(?:please\s+)?(.+?)(
 /** "explain [to me|please]* <Q>" -> "<Q>", gated on an interrogative
  *  remainder so it only unwraps a real WH-question underneath. */
 const EXPLAIN_WRAPPER_RE = /^explain\s+(?:to\s+me\s+|please\s+)*(.+?)\??$/i;
-/** "tell me <Q>" (bare, no "about") -> "<Q>"; "tell me about X" is a
- *  different, untouched territory (chat.mjs's vagueTouchTermOf). */
-const TELL_ME_WRAPPER_RE = /^tell\s+me\s+(.+?)\??$/i;
+/** "tell me [please] <Q>" (bare, no "about") -> "<Q>"; "tell me about X" is a
+ *  different, untouched territory (chat.mjs's vagueTouchTermOf). The optional
+ *  infix "please" mirrors MODAL_WRAPPER_RE's own. */
+const TELL_ME_WRAPPER_RE = /^tell\s+me\s+(?:please\s+)?(.+?)\??$/i;
+/** "[would/do you] mind telling me <Q>" -> "<Q>" — the gerund sibling of
+ *  TELL_ME_WRAPPER_RE (MODAL_WRAPPER_RE peels a leading "would you", leaving
+ *  the bare "mind telling me" form this also matches directly). */
+const MIND_TELLING_WRAPPER_RE = /^(?:(?:would|do)\s+you\s+)?mind\s+telling\s+(?:me|us)\s+(?:please\s+)?(.+?)\??$/i;
 /** "do you know <Q>" -> "<Q>", gated on an interrogative remainder — so
  *  "do you know anything about movies" (small-talk, no embedded question)
  *  passes through untouched. */
@@ -213,6 +222,8 @@ export function applyPreambleFrames(text) {
     if (m) q = m[1].trim();
     m = q.match(HEDGE_ADVERB_PREAMBLE_RE);
     if (m) q = m[1].trim();
+    m = q.match(PLEASE_PREAMBLE_RE);
+    if (m) q = m[1].trim();
     m = q.match(TOPIC_SWITCH_PREAMBLE_RE);
     if (m) q = m[1].trim();
     m = q.match(MODAL_WRAPPER_RE);
@@ -221,6 +232,8 @@ export function applyPreambleFrames(text) {
     if (m && INTERROGATIVE_LEAD_RE.test(m[1].trim())) q = m[1].trim();
     m = q.match(TELL_ME_WRAPPER_RE);
     if (m && INTERROGATIVE_LEAD_RE.test(m[1].trim())) q = m[1].trim();
+    m = q.match(MIND_TELLING_WRAPPER_RE);
+    if (m && INTERROGATIVE_LEAD_RE.test(m[1].trim())) q = m[1].trim();
     m = q.match(KNOW_WRAPPER_RE);
     if (m && INTERROGATIVE_LEAD_RE.test(m[1].trim())) q = m[1].trim();
     m = q.match(WANT_KNOW_WRAPPER_RE);

package/src/services/chat.mjs

@@ -3163,6 +3163,14 @@ async function unknownAdjectiveFallback(payload, { memoryDir, sessionId, lexicon
   if (!m) return null;
   const [, det, subjectRaw, verb, objectRaw] = m;
   if (PLACE_ADVERB_OBJECT_RE.test(objectRaw)) return null; // a place adverb is never a property
+  // An ARTICLED complement ("a dog is a mammal") is a noun-phrase kind claim,
+  // never an adjective property — but UNKNOWN_SUBJECT_RE strips the object's
+  // article before capture, so objectRaw alone can't show the difference from
+  // "the cache is bespoke". Without this re-check, a fact-grounded subject
+  // silently minted the kind claim as an mgx:hasProperty garble that the isa
+  // read-back then denied. Declining here lands on the honest teach-miss,
+  // whose nudge already names the storable form ("every dog is a mammal").
+  if (/\s+(?:is|are)\s+an?\s+[\w-]+[.!?]*\s*$/i.test(String(payload).trim())) return null;
   const { loadLexicon, lookupNoun, lookupAdjective, classify } = await import("../domain/grammar/lexicon.mjs");
   const lex = lexicon || loadLexicon();
   // Y already a known NOUN or a fact-grounded CLASS term — a genuine class-