@polycode-projects/the-mechanical-code-talker 0.9.1 → 0.9.3

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@polycode-projects/the-mechanical-code-talker",
-  "version": "0.9.1",
+  "version": "0.9.3",
   "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/chat.mjs

@@ -2987,6 +2987,12 @@ export async function runChat({
   gitRoot = gitToplevel,
   ephemeral = false,
 } = {}) {
+  // createSession's first-run seed (~2-3s, corpus/seon + ConceptNet) produces ZERO
+  // output until it fully resolves — found live: an operator reported `npm run chat`
+  // appearing to hang with total silence. This one line is cheap on every run (a
+  // fast subsequent run just flashes it briefly) and removes the "is this even
+  // running" uncertainty during the one case that's genuinely slow.
+  output.write("tmct — starting…\n");
   const session = await createSession({ repoPath, source, env, cwd, gitRoot, ephemeral });
 
   const dim = (s) => (env.NO_COLOR || !output.isTTY ? s : `\x1b[2m${s}\x1b[0m`);

package/src/interpret/normalize.mjs

@@ -485,6 +485,12 @@ export const STOPWORDS = new Set([
   // literally named "last" would be the accepted residual cost, same trade as
   // every other stopword.
   "last",
+  // frequency-adverb filler ("what does X usually change together with", "what does
+  // X typically call") — found live: "usually" glued onto the object term instead of
+  // being stripped, corrupting resolution ("src/core/store.mjs usually" instead of
+  // the module alone). Same trade as every other stopword: a symbol literally named
+  // "usually" would be the accepted residual cost.
+  "usually", "typically", "generally", "normally", "often", "commonly", "mostly",
 ]);
 
 /** Split free text into words: trailing "?" run stripped, commas treated as

package/src/interpret/strategies/keywords.mjs

@@ -150,6 +150,21 @@ export function parseKeywordSpot(text, nlp = null) {
   const consumed = new Set();
   const mark = (hit) => { if (hit) for (let i = hit.start; i < hit.end; i += 1) consumed.add(i); };
   mark(verbHit);
+  // A redundant SAME-KIND verb immediately after the matched one ("what TESTS
+  // cover X" — "tests" is read as the relation trigger, but "cover" — also a
+  // `tests` verb, ask-vocab.mjs's own synonym list — is the word the sentence
+  // actually intends as the verb) would otherwise fall into afterText raw and
+  // corrupt the object ("cover src/core/model.mjs" instead of the module alone).
+  // Anchored to the exact position right after verbHit (never a general re-scan),
+  // and gated on matching the SAME kind, so this can only strip a genuine
+  // restatement, never eat a real object term. Found live: "what tests cover X",
+  // "which tests test X" both misparsed this way before this fix.
+  for (const [phrase, kind] of Object.entries(VERB_TO_KIND)) {
+    if (kind !== verbHit.kind) continue;
+    const pWords = phrase.split(" ");
+    const start = verbHit.end;
+    if (pWords.every((w, j) => canonWords[start + j] === w)) { mark({ start, end: start + pWords.length }); break; }
+  }
   const entityHit = findPhrase(canonWords, ENTITY_TO_TYPE, consumed);
   mark(entityHit);
   const modifierHit = findPhrase(canonWords, MODIFIER_TO_KIND, consumed);

package/src/tui/app.mjs

@@ -231,6 +231,12 @@ export function App({ session }) {
  *  which also triggers the memory fold — stream flush). Returns
  *  { logFile, sidecarFile, turns } exactly like runChat. */
 export async function runTui({ repoPath, stdout = process.stdout, stdin = process.stdin, ...sessionOpts } = {}) {
+  // Same reasoning as runChat's equivalent line (src/chat.mjs): createSession's
+  // first-run seed is silent for ~2-3s, and nothing is written to the terminal
+  // (not even the alternate-screen switch below) until it resolves — this was
+  // reported live as an apparent hang. One cheap line on the PRIMARY screen,
+  // before the alt-screen switch, so there's visible proof of life immediately.
+  stdout.write("tmct — starting…\n");
   const session = await createSession({ repoPath, ...sessionOpts });
   stdout.write("\x1b[?1049h\x1b[H"); // alternate screen buffer + home — a clean full-screen canvas
   const app = render(h(App, { session }), { stdout, stdin, exitOnCtrlC: true });