@su-record/vibe 4.2.35 → 4.2.37

package/dist/core/regress.js

@@ -7,22 +7,25 @@ import { usage } from './errors.js';
 import { loadScenarios } from './intent.js';
 import { record } from './ledger.js';
 import { vibePath } from './paths.js';
-import { parseScenarios } from './scenarios.js';
+import { EVIDENCE_DIR } from './run-id.js';
+import { parseScenarios, SCENARIO_ID_MAX } from './scenarios.js';
 import { ensureDir, readJson, readText, writeAtomic } from './store.js';
 /**
  * Regressions — a fixed failure becomes a reproducing check that joins every `check --all`.
  * One file = one scenario. The original check is copied; the id gets an `r-` prefix.
  */
+const REGRESSIONS_DIR = 'regressions';
+const REGRESSION_PREFIX = 'r-';
+const DEFAULT_SLUG = 'regression';
 export function regressionsDir(root) {
-    return vibePath(root, 'regressions');
+    return vibePath(root, REGRESSIONS_DIR);
 }
-const ID_MAX = 40;
 /** `r-<n>-<slug>` within the 40-character id rule — the slug gives way, the number never does. */
 function regressionId(n, title) {
-    const prefix = `r-${n}-`;
+    const prefix = `${REGRESSION_PREFIX}${n}-`;
     const words = title.toLowerCase().replace(/[^a-z0-9]+/g, '-').replace(/^-+|-+$/g, '');
-    const slug = words.slice(0, ID_MAX - prefix.length).replace(/-+$/g, '');
-    return `${prefix}${slug || 'regression'}`.slice(0, ID_MAX).replace(/-+$/g, '');
+    const slug = words.slice(0, SCENARIO_ID_MAX - prefix.length).replace(/-+$/g, '');
+    return `${prefix}${slug || DEFAULT_SLUG}`.slice(0, SCENARIO_ID_MAX).replace(/-+$/g, '');
 }
 function readRegressionFiles(root) {
     const dir = regressionsDir(root);
@@ -45,7 +48,9 @@ export function listRegressions(root) {
 }
 /** Regression files that parse to nothing — a silent gap in `check --all`, so the state view names them. */
 export function regressionProblems(root) {
-    return readRegressionFiles(root).filter((f) => f.rejections.length > 0).map((f) => `regressions/${f.name} is not checked — ${f.rejections.join('; ')}`);
+    return readRegressionFiles(root)
+        .filter((f) => f.rejections.length > 0)
+        .map((f) => `${REGRESSIONS_DIR}/${f.name} is not checked — ${f.rejections.join('; ')}`);
 }
 export function recordRegression(root, input) {
     const source = loadScenarios(root).find((s) => s.id === input.scenario);
@@ -53,15 +58,17 @@ export function recordRegression(root, input) {
         throw usage(`unknown scenario: ${input.scenario}`);
     if (source.check.type === 'human')
         throw usage('a human scenario cannot become a regression check — it has no verdict');
-    if (source.irreversible)
-        throw usage(`a regression must observe — ${source.id} mutates (${actionOf(source.irreversible)}); write a check that reproduces the failure without changing state`);
+    if (source.irreversible) {
+        const action = actionOf(source.irreversible);
+        throw usage(`a regression must observe — ${source.id} mutates (${action}); write a check that reproduces the failure without changing state`);
+    }
     if (!input.title.trim())
         throw usage('--title is required');
     const existing = readRegressionFiles(root).length;
     const id = regressionId(existing + 1, input.title);
     let tail = '';
     if (input.fromEvidence) {
-        const evidence = readJson(vibePath(root, 'evidence', `${input.fromEvidence}.json`));
+        const evidence = readJson(vibePath(root, EVIDENCE_DIR, `${input.fromEvidence}.json`));
         tail = evidence?.results?.find((r) => r.id === input.scenario)?.failureCode ?? '';
     }
     const entry = { id, then: `[regression] ${input.title} — source ${source.id}: ${source.then}`, check: source.check };
@@ -69,12 +76,14 @@ export function recordRegression(root, input) {
         entry.given = source.given;
     if (source.when)
         entry.when = source.when;
-    const body = `# Regression check — ${input.title}\n# Source scenario: ${source.id}${tail ? `\n# Output at the time:\n${tail.split('\n').map((l) => `#   ${l}`).join('\n')}` : ''}\n${YAML.stringify([entry])}`;
+    const output = tail ? `\n# Output at the time:\n${tail.split('\n').map((l) => `#   ${l}`).join('\n')}` : '';
+    const body = `# Regression check — ${input.title}\n# Source scenario: ${source.id}${output}\n${YAML.stringify([entry])}`;
     ensureDir(regressionsDir(root));
     const file = path.join(regressionsDir(root), `${id}.yaml`);
     const parsed = parseScenarios(body);
-    if (parsed.scenarios.length !== 1)
+    if (parsed.scenarios.length !== 1) {
         throw usage(`the regression would not parse: ${parsed.rejections.map((r) => r.reason).join('; ')}`);
+    }
     writeAtomic(file, body);
     const edges = [{ type: 'caused', from: `regression:${id}`, to: `scenario:${source.id}` }];
     if (input.fromEvidence)

package/dist/core/regress.js.map

@@ -1 +1 @@
-{"version":3,"file":"regress.js","sourceRoot":"","sources":["../../src/core/regress.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"regress.js","sourceRoot":"","sources":["../../src/core/regress.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,MAAM,SAAS,CAAC;AACzB,OAAO,IAAI,MAAM,WAAW,CAAC;AAC7B,OAAO,IAAI,MAAM,MAAM,CAAC;AACxB,OAAO,EAAE,QAAQ,EAAE,MAAM,sBAAsB,CAAC;AAChD,OAAO,EAAE,YAAY,EAAE,WAAW,EAAE,MAAM,aAAa,CAAC;AACxD,OAAO,EAAE,KAAK,EAAE,MAAM,aAAa,CAAC;AACpC,OAAO,EAAE,aAAa,EAAE,MAAM,aAAa,CAAC;AAC5C,OAAO,EAAE,MAAM,EAAa,MAAM,aAAa,CAAC;AAChD,OAAO,EAAE,QAAQ,EAAE,MAAM,YAAY,CAAC;AACtC,OAAO,EAAE,YAAY,EAAE,MAAM,aAAa,CAAC;AAC3C,OAAO,EAAE,cAAc,EAAE,eAAe,EAAiB,MAAM,gBAAgB,CAAC;AAChF,OAAO,EAAE,SAAS,EAAE,QAAQ,EAAE,QAAQ,EAAE,WAAW,EAAE,MAAM,YAAY,CAAC;AAExE;;;GAGG;AACH,MAAM,eAAe,GAAG,aAAa,CAAC;AACtC,MAAM,iBAAiB,GAAG,IAAI,CAAC;AAC/B,MAAM,YAAY,GAAG,YAAY,CAAC;AAElC,MAAM,UAAU,cAAc,CAAC,IAAY;IACzC,OAAO,QAAQ,CAAC,IAAI,EAAE,eAAe,CAAC,CAAC;AACzC,CAAC;AASD,kGAAkG;AAClG,SAAS,YAAY,CAAC,CAAS,EAAE,KAAa;IAC5C,MAAM,MAAM,GAAG,GAAG,iBAAiB,GAAG,CAAC,GAAG,CAAC;IAC3C,MAAM,KAAK,GAAG,KAAK,CAAC,WAAW,EAAE,CAAC,OAAO,CAAC,aAAa,EAAE,GAAG,CAAC,CAAC,OAAO,CAAC,UAAU,EAAE,EAAE,CAAC,CAAC;IACtF,MAAM,IAAI,GAAG,KAAK,CAAC,KAAK,CAAC,CAAC,EAAE,eAAe,GAAG,MAAM,CAAC,MAAM,CAAC,CAAC,OAAO,CAAC,MAAM,EAAE,EAAE,CAAC,CAAC;IACjF,OAAO,GAAG,MAAM,GAAG,IAAI,IAAI,YAAY,EAAE,CAAC,KAAK,CAAC,CAAC,EAAE,eAAe,CAAC,CAAC,OAAO,CAAC,MAAM,EAAE,EAAE,CAAC,CAAC;AAC1F,CAAC;AAED,SAAS,mBAAmB,CAAC,IAAY;IACvC,MAAM,GAAG,GAAG,cAAc,CAAC,IAAI,CAAC,CAAC;IACjC,IAAI,CAAC,EAAE,CAAC,UAAU,CAAC,GAAG,CAAC;QAAE,OAAO,EAAE,CAAC;IACnC,MAAM,GAAG,GAAyE,EAAE,CAAC;IACrF,KAAK,MAAM,IAAI,IAAI,EAAE,CAAC,WAAW,CAAC,GAAG,CAAC,CAAC,IAAI,EAAE,EAAE,CAAC;QAC9C,IAAI,CAAC,IAAI,CAAC,QAAQ,CAAC,OAAO,CAAC;YAAE,SAAS;QACtC,MAAM,IAAI,GAAG,QAAQ,CAAC,IAAI,CAAC,IAAI,CAAC,GAAG,EAAE,IAAI,CAAC,CAAC,CAAC;QAC5C,IAAI,IAAI,KAAK,IAAI;YAAE,SAAS;QAC5B,MAAM,MAAM,GAAG,cAAc,CAAC,IAAI,CAAC,CAAC;QACpC,GAAG,CAAC,IAAI,CAAC,EAAE,IAAI,EAAE,SAAS,EAAE,MAAM,CAAC,SAAS,EAAE,UAAU,EAAE,MAAM,CAAC,UAAU,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,GAAG,CAAC,CAAC,EAAE,KAAK,CAAC,CAAC,MAAM,EAAE,CAAC,EAAE,CAAC,CAAC;IACpH,CAAC;IACD,OAAO,GAAG,CAAC;AACb,CAAC;AAED,MAAM,UAAU,eAAe,CAAC,IAAY;IAC1C,OAAO,mBAAmB,CAAC,IAAI,CAAC,CAAC,OAAO,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,SAAS,CAAC,CAAC;AAC/D,CAAC;AAED,4GAA4G;AAC5G,MAAM,UAAU,kBAAkB,CAAC,IAAY;IAC7C,OAAO,mBAAmB,CAAC,IAAI,CAAC;SAC7B,MAAM,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,UAAU,CAAC,MAAM,GAAG,CAAC,CAAC;SACtC,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,GAAG,eAAe,IAAI,CAAC,CAAC,IAAI,qBAAqB,CAAC,CAAC,UAAU,CAAC,IAAI,CAAC,IAAI,CAAC,EAAE,CAAC,CAAC;AAC5F,CAAC;AAED,MAAM,UAAU,gBAAgB,CAAC,IAAY,EAAE,KAA4B;IACzE,MAAM,MAAM,GAAG,aAAa,CAAC,IAAI,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,EAAE,KAAK,KAAK,CAAC,QAAQ,CAAC,CAAC;IACxE,IAAI,CAAC,MAAM;QAAE,MAAM,KAAK,CAAC,qBAAqB,KAAK,CAAC,QAAQ,EAAE,CAAC,CAAC;IAChE,IAAI,MAAM,CAAC,KAAK,CAAC,IAAI,KAAK,OAAO;QAAE,MAAM,KAAK,CAAC,uEAAuE,CAAC,CAAC;IACxH,IAAI,MAAM,CAAC,YAAY,EAAE,CAAC;QACxB,MAAM,MAAM,GAAG,QAAQ,CAAC,MAAM,CAAC,YAAY,CAAC,CAAC;QAC7C,MAAM,KAAK,CAAC,+BAA+B,MAAM,CAAC,EAAE,aAAa,MAAM,qEAAqE,CAAC,CAAC;IAChJ,CAAC;IACD,IAAI,CAAC,KAAK,CAAC,KAAK,CAAC,IAAI,EAAE;QAAE,MAAM,KAAK,CAAC,qBAAqB,CAAC,CAAC;IAC5D,MAAM,QAAQ,GAAG,mBAAmB,CAAC,IAAI,CAAC,CAAC,MAAM,CAAC;IAClD,MAAM,EAAE,GAAG,YAAY,CAAC,QAAQ,GAAG,CAAC,EAAE,KAAK,CAAC,KAAK,CAAC,CAAC;IACnD,IAAI,IAAI,GAAG,EAAE,CAAC;IACd,IAAI,KAAK,CAAC,YAAY,EAAE,CAAC;QACvB,MAAM,QAAQ,GAAG,QAAQ,CAA4D,QAAQ,CAAC,IAAI,EAAE,YAAY,EAAE,GAAG,KAAK,CAAC,YAAY,OAAO,CAAC,CAAC,CAAC;QACjJ,IAAI,GAAG,QAAQ,EAAE,OAAO,EAAE,IAAI,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,EAAE,KAAK,KAAK,CAAC,QAAQ,CAAC,EAAE,WAAW,IAAI,EAAE,CAAC;IACpF,CAAC;IACD,MAAM,KAAK,GAAa,EAAE,EAAE,EAAE,IAAI,EAAE,gBAAgB,KAAK,CAAC,KAAK,aAAa,MAAM,CAAC,EAAE,KAAK,MAAM,CAAC,IAAI,EAAE,EAAE,KAAK,EAAE,MAAM,CAAC,KAAK,EAAE,CAAC;IAC/H,IAAI,MAAM,CAAC,KAAK;QAAE,KAAK,CAAC,KAAK,GAAG,MAAM,CAAC,KAAK,CAAC;IAC7C,IAAI,MAAM,CAAC,IAAI;QAAE,KAAK,CAAC,IAAI,GAAG,MAAM,CAAC,IAAI,CAAC;IAC1C,MAAM,MAAM,GAAG,IAAI,CAAC,CAAC,CAAC,4BAA4B,IAAI,CAAC,KAAK,CAAC,IAAI,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,OAAO,CAAC,EAAE,CAAC,CAAC,IAAI,CAAC,IAAI,CAAC,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC;IAC5G,MAAM,IAAI,GAAG,wBAAwB,KAAK,CAAC,KAAK,wBAAwB,MAAM,CAAC,EAAE,GAAG,MAAM,KAAK,IAAI,CAAC,SAAS,CAAC,CAAC,KAAK,CAAC,CAAC,EAAE,CAAC;IACzH,SAAS,CAAC,cAAc,CAAC,IAAI,CAAC,CAAC,CAAC;IAChC,MAAM,IAAI,GAAG,IAAI,CAAC,IAAI,CAAC,cAAc,CAAC,IAAI,CAAC,EAAE,GAAG,EAAE,OAAO,CAAC,CAAC;IAC3D,MAAM,MAAM,GAAG,cAAc,CAAC,IAAI,CAAC,CAAC;IACpC,IAAI,MAAM,CAAC,SAAS,CAAC,MAAM,KAAK,CAAC,EAAE,CAAC;QAClC,MAAM,KAAK,CAAC,mCAAmC,MAAM,CAAC,UAAU,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,MAAM,CAAC,CAAC,IAAI,CAAC,IAAI,CAAC,EAAE,CAAC,CAAC;IACtG,CAAC;IACD,WAAW,CAAC,IAAI,EAAE,IAAI,CAAC,CAAC;IACxB,MAAM,KAAK,GAAW,CAAC,EAAE,IAAI,EAAE,QAAQ,EAAE,IAAI,EAAE,cAAc,EAAE,EAAE,EAAE,EAAE,EAAE,YAAY,MAAM,CAAC,EAAE,EAAE,EAAE,CAAC,CAAC;IAClG,IAAI,KAAK,CAAC,YAAY;QAAE,KAAK,CAAC,IAAI,CAAC,EAAE,IAAI,EAAE,QAAQ,EAAE,IAAI,EAAE,cAAc,EAAE,EAAE,EAAE,EAAE,EAAE,OAAO,KAAK,CAAC,YAAY,EAAE,EAAE,CAAC,CAAC;IAClH,MAAM,CAAC,IAAI,EAAE,EAAE,KAAK,EAAE,SAAS,EAAE,MAAM,EAAE,YAAY,EAAE,EAAE,KAAK,EAAE,WAAW,EAAE,EAAE,MAAM,EAAE,EAAE,EAAE,KAAK,EAAE,CAAC,CAAC;IACpG,OAAO,EAAE,EAAE,EAAE,IAAI,EAAE,CAAC;AACtB,CAAC"}

package/dist/core/repair.js

@@ -5,6 +5,11 @@ import { maskFailureLine } from './failure-message.js';
 import { safeText } from './evidence.js';
 export const DIAGNOSE_AFTER = 2;
 export const ASK_AFTER = 5;
+/** Longest declared approach kept in the repair record. */
+const APPROACH_MAX = 240;
+const APPROACH_NOT_RECORDED = 'not recorded';
+const NO_FAILURE_DETAILS = 'failure details unavailable';
+const STUCK_OPTIONS = ['provide missing information', 'revise the agreed scope', 'handoff remaining work'];
 export function pendingRepairQuestion(root, repair) {
     if (!repair?.waiting)
         return undefined;
@@ -13,21 +18,34 @@ export function pendingRepairQuestion(root, repair) {
 export function repairAwaitingInput(root, repair) {
     return Boolean(repair?.waiting && !foldQuestions(root).find(q => q.id === repair.questionId)?.answer?.trim());
 }
+function stuckQuestion(hash, failStreak, failures, attempts) {
+    const approaches = attempts.map((item) => `${item.run}: ${JSON.stringify(item.approach)}`).join('; ');
+    return [
+        `STUCK ${hash}: same failure ${failStreak} times; repair limit reached.`,
+        `Untrusted failure summaries: ${failures.map(failureLine).join('\n')}`,
+        `Declared approaches (untrusted): ${approaches}. What new information or decision should guide the next attempt?`,
+    ].join('\n');
+}
 export function repairFailure(root, current, hash, failures, run, approach) {
     const same = hash === current.lastFailHash;
     const failStreak = same ? current.failStreak + 1 : 1;
-    const attempts = [...(same ? current.repair?.attempts ?? [] : []), { run, approach: approach?.trim() ? safeText(maskFailureLine(approach.trim(), root), 240) : 'not recorded' }].slice(-ASK_AFTER);
+    const declared = approach?.trim() ? safeText(maskFailureLine(approach.trim(), root), APPROACH_MAX) : APPROACH_NOT_RECORDED;
+    const attempts = [...(same ? current.repair?.attempts ?? [] : []), { run, approach: declared }].slice(-ASK_AFTER);
     const repair = { hash, attempts, failures, waiting: failStreak >= ASK_AFTER };
     if (repair.waiting) {
         const existing = openQuestions(root).find(q => q.question.startsWith(`STUCK ${hash}:`));
-        repair.questionId = existing?.id ?? ask(root, { question: `STUCK ${hash}: same failure ${failStreak} times; repair limit reached.\nUntrusted failure summaries: ${failures.map(failureLine).join('\n')}\nDeclared approaches (untrusted): ${attempts.map((item) => `${item.run}: ${JSON.stringify(item.approach)}`).join('; ')}. What new information or decision should guide the next attempt?`, options: ['provide missing information', 'revise the agreed scope', 'handoff remaining work'] }).id;
+        repair.questionId = existing?.id ?? ask(root, { question: stuckQuestion(hash, failStreak, failures, attempts), options: STUCK_OPTIONS }).id;
     }
     return { state: failStreak >= DIAGNOSE_AFTER ? 'STUCK' : 'RUNNING', failStreak, lastFailHash: hash, repair };
 }
 export function repairNext(repair) {
-    const facts = repair?.failures.map(failureLine).join(' | ') ?? 'failure details unavailable';
+    const facts = repair?.failures.map(failureLine).join(' | ') ?? NO_FAILURE_DETAILS;
     const contexts = repair?.failures.map((failure) => `vibe context ${failure.id}`).join('; ') || 'vibe context <id>';
-    return `prove — STUCK diagnosis: ${facts}; ${contexts}; change the approach instead of repeating the same fix: write the one premise the failed fixes shared and test it before another fix; then vibe check <id> --approach "the premise and what changed"`;
+    return [
+        `prove — STUCK diagnosis: ${facts}; ${contexts}; change the approach instead of repeating the same fix:`,
+        'write the one premise the failed fixes shared and test it before another fix;',
+        'then vibe check <id> --approach "the premise and what changed"',
+    ].join(' ');
 }
 export function resumeRepair(root, state) {
     if (!state.repair?.waiting)

package/dist/core/repair.js.map

@@ -1 +1 @@
-{"version":3,"file":"repair.js","sourceRoot":"","sources":["../../src/core/repair.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"repair.js","sourceRoot":"","sources":["../../src/core/repair.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,WAAW,EAAE,MAAM,cAAc,CAAC;AAC3C,OAAO,EAAE,GAAG,EAAE,aAAa,EAAE,aAAa,EAAE,OAAO,EAAE,MAAM,YAAY,CAAC;AACxE,OAAO,EAAE,iBAAiB,EAAE,MAAM,aAAa,CAAC;AAEhD,OAAO,EAAE,eAAe,EAAE,MAAM,sBAAsB,CAAC;AACvD,OAAO,EAAE,QAAQ,EAAE,MAAM,eAAe,CAAC;AAEzC,MAAM,CAAC,MAAM,cAAc,GAAG,CAAC,CAAC;AAChC,MAAM,CAAC,MAAM,SAAS,GAAG,CAAC,CAAC;AAC3B,2DAA2D;AAC3D,MAAM,YAAY,GAAG,GAAG,CAAC;AACzB,MAAM,qBAAqB,GAAG,cAAc,CAAC;AAC7C,MAAM,kBAAkB,GAAG,6BAA6B,CAAC;AACzD,MAAM,aAAa,GAAG,CAAC,6BAA6B,EAAE,yBAAyB,EAAE,wBAAwB,CAAC,CAAC;AAK3G,MAAM,UAAU,qBAAqB,CAAC,IAAY,EAAE,MAAsC;IACxF,IAAI,CAAC,MAAM,EAAE,OAAO;QAAE,OAAO,SAAS,CAAC;IACvC,OAAO,aAAa,CAAC,IAAI,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,EAAE,KAAK,MAAM,CAAC,UAAU,IAAI,CAAC,CAAC,CAAC,MAAM,EAAE,IAAI,EAAE,CAAC,CAAC;AACxF,CAAC;AAED,MAAM,UAAU,mBAAmB,CAAC,IAAY,EAAE,MAAsC;IACtF,OAAO,OAAO,CAAC,MAAM,EAAE,OAAO,IAAI,CAAC,aAAa,CAAC,IAAI,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,EAAE,KAAK,MAAM,CAAC,UAAU,CAAC,EAAE,MAAM,EAAE,IAAI,EAAE,CAAC,CAAC;AAChH,CAAC;AAED,SAAS,aAAa,CAAC,IAAY,EAAE,UAAkB,EAAE,QAA0B,EAAE,QAAyB;IAC5G,MAAM,UAAU,GAAG,QAAQ,CAAC,GAAG,CAAC,CAAC,IAAI,EAAE,EAAE,CAAC,GAAG,IAAI,CAAC,GAAG,KAAK,IAAI,CAAC,SAAS,CAAC,IAAI,CAAC,QAAQ,CAAC,EAAE,CAAC,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;IACtG,OAAO;QACL,SAAS,IAAI,kBAAkB,UAAU,+BAA+B;QACxE,gCAAgC,QAAQ,CAAC,GAAG,CAAC,WAAW,CAAC,CAAC,IAAI,CAAC,IAAI,CAAC,EAAE;QACtE,oCAAoC,UAAU,mEAAmE;KAClH,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;AACf,CAAC;AAED,MAAM,UAAU,aAAa,CAC3B,IAAY,EAAE,OAAkB,EAAE,IAAY,EAAE,QAA0B,EAAE,GAAW,EAAE,QAAiB;IAE1G,MAAM,IAAI,GAAG,IAAI,KAAK,OAAO,CAAC,YAAY,CAAC;IAC3C,MAAM,UAAU,GAAG,IAAI,CAAC,CAAC,CAAC,OAAO,CAAC,UAAU,GAAG,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC;IACrD,MAAM,QAAQ,GAAG,QAAQ,EAAE,IAAI,EAAE,CAAC,CAAC,CAAC,QAAQ,CAAC,eAAe,CAAC,QAAQ,CAAC,IAAI,EAAE,EAAE,IAAI,CAAC,EAAE,YAAY,CAAC,CAAC,CAAC,CAAC,qBAAqB,CAAC;IAC3H,MAAM,QAAQ,GAAG,CAAC,GAAG,CAAC,IAAI,CAAC,CAAC,CAAC,OAAO,CAAC,MAAM,EAAE,QAAQ,IAAI,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC,EAAE,EAAE,GAAG,EAAE,QAAQ,EAAE,QAAQ,EAAE,CAAC,CAAC,KAAK,CAAC,CAAC,SAAS,CAAC,CAAC;IAClH,MAAM,MAAM,GAAgB,EAAE,IAAI,EAAE,QAAQ,EAAE,QAAQ,EAAE,OAAO,EAAE,UAAU,IAAI,SAAS,EAAE,CAAC;IAC3F,IAAI,MAAM,CAAC,OAAO,EAAE,CAAC;QACnB,MAAM,QAAQ,GAAG,aAAa,CAAC,IAAI,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,QAAQ,CAAC,UAAU,CAAC,SAAS,IAAI,GAAG,CAAC,CAAC,CAAC;QACxF,MAAM,CAAC,UAAU,GAAG,QAAQ,EAAE,EAAE,IAAI,GAAG,CAAC,IAAI,EAAE,EAAE,QAAQ,EAAE,aAAa,CAAC,IAAI,EAAE,UAAU,EAAE,QAAQ,EAAE,QAAQ,CAAC,EAAE,OAAO,EAAE,aAAa,EAAE,CAAC,CAAC,EAAE,CAAC;IAC9I,CAAC;IACD,OAAO,EAAE,KAAK,EAAE,UAAU,IAAI,cAAc,CAAC,CAAC,CAAC,OAAO,CAAC,CAAC,CAAC,SAAS,EAAE,UAAU,EAAE,YAAY,EAAE,IAAI,EAAE,MAAM,EAAE,CAAC;AAC/G,CAAC;AAED,MAAM,UAAU,UAAU,CAAC,MAAsC;IAC/D,MAAM,KAAK,GAAG,MAAM,EAAE,QAAQ,CAAC,GAAG,CAAC,WAAW,CAAC,CAAC,IAAI,CAAC,KAAK,CAAC,IAAI,kBAAkB,CAAC;IAClF,MAAM,QAAQ,GAAG,MAAM,EAAE,QAAQ,CAAC,GAAG,CAAC,CAAC,OAAO,EAAE,EAAE,CAAC,gBAAgB,OAAO,CAAC,EAAE,EAAE,CAAC,CAAC,IAAI,CAAC,IAAI,CAAC,IAAI,mBAAmB,CAAC;IACnH,OAAO;QACL,4BAA4B,KAAK,KAAK,QAAQ,0DAA0D;QACxG,+EAA+E;QAC/E,gEAAgE;KACjE,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC;AACd,CAAC;AAED,MAAM,UAAU,YAAY,CAAC,IAAY,EAAE,KAAgB;IACzD,IAAI,CAAC,KAAK,CAAC,MAAM,EAAE,OAAO;QAAE,OAAO,KAAK,CAAC;IACzC,MAAM,QAAQ,GAAG,aAAa,CAAC,IAAI,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,EAAE,KAAK,KAAK,CAAC,MAAM,EAAE,UAAU,CAAC,CAAC;IAClF,IAAI,CAAC,QAAQ,EAAE,MAAM,EAAE,IAAI,EAAE;QAAE,MAAM,iBAAiB,CAAC,+FAA+F,CAAC,CAAC;IACxJ,IAAI,QAAQ,CAAC,UAAU,KAAK,IAAI;QAAE,OAAO,CAAC,IAAI,EAAE,QAAQ,CAAC,EAAE,CAAC,CAAC;IAC7D,OAAO,EAAE,GAAG,KAAK,EAAE,KAAK,EAAE,SAAS,EAAE,UAAU,EAAE,CAAC,EAAE,YAAY,EAAE,IAAI,EAAE,MAAM,EAAE,IAAI,EAAE,CAAC;AACzF,CAAC"}

package/dist/core/research-queries.js

@@ -0,0 +1,85 @@
+import path from 'node:path';
+import { intentPath, loadScenarios } from './intent.js';
+import { readJson, readText } from './store.js';
+/** Words in one query, queries drawn from the intent body, and queries in all (with the host and stack queries). */
+const QUERY_WORDS_MAX = 4;
+const BODY_QUERIES_MAX = 3;
+const QUERIES_MAX = 5;
+/** Intent words shorter than this, or repeated fewer times, are not terms; query words below this length are noise. */
+export const TERM_MIN_LENGTH = 4;
+const TERM_MIN_REPEATS = 2;
+/** Dependencies named in a query. */
+const QUERY_DEPS_MAX = 2;
+const STOP = new Set([
+    'a', 'an', 'the', 'and', 'or', 'of', 'to', 'in', 'for', 'with', 'vibe', 'phase', 'into', 'from', 'on', 'by', 'is', 'it',
+    // words every intent uses — they describe the harness, not the work
+    'check', 'checks', 'scenario', 'scenarios', 'intent', 'harness', 'model', 'client', 'test', 'tests', 'file', 'files',
+    'line', 'lines', 'when', 'then', 'given', 'that', 'this', 'each', 'every', 'same', 'other', 'than', 'under', 'over',
+    'first', 'names', 'name', 'none', 'nothing', 'stays', 'still', 'earlier', 'gates', 'build', 'live',
+]);
+const SUCCESS_HEADING = /^## What counts as success/m;
+export function tokens(text) {
+    return [...new Set(text.toLowerCase().split(/[^a-z0-9]+/).filter((w) => w.length > 2 && !STOP.has(w)))];
+}
+/** A host named by an http check, as a search key: without `www.`/`api.` and the domain suffix. Throws on a string that is not a URL. */
+export function hostKey(url) {
+    return new URL(url).hostname.replace(/^(www|api)\./, '').split('.')[0];
+}
+/** The words the intent body actually repeats: backticked names first, then frequent words of `TERM_MIN_LENGTH` letters or more. */
+function bodyTerms(text) {
+    const section = text.split(SUCCESS_HEADING)[1]?.split(/^## /m)[0] ?? text;
+    const count = new Map();
+    for (const m of section.matchAll(/`([a-z][a-z0-9-]{3,})`/g))
+        count.set(m[1], (count.get(m[1]) ?? 0) + 1);
+    const names = [...count.entries()].filter(([w]) => !STOP.has(w)).sort((a, b) => b[1] - a[1]).map(([w]) => w);
+    const freq = new Map();
+    for (const w of section.toLowerCase().replace(/`[^`]*`/g, ' ').split(/[^a-z0-9]+/)) {
+        if (w.length < TERM_MIN_LENGTH || STOP.has(w) || /^\d/.test(w))
+            continue;
+        freq.set(w, (freq.get(w) ?? 0) + 1);
+    }
+    const words = [...freq.entries()].filter(([, n]) => n >= TERM_MIN_REPEATS).sort((a, b) => b[1] - a[1]).map(([w]) => w);
+    return { names, words };
+}
+/**
+ * Queries come from what the intent body names and repeats — never from the title's first words —
+ * then the hosts its http checks target and the stack.
+ */
+export function queriesFromIntent(root) {
+    const queries = [];
+    const text = readText(intentPath(root)) ?? '';
+    const { names, words } = bodyTerms(text);
+    const push = (parts) => {
+        const q = [...new Set(parts.filter(Boolean))].slice(0, QUERY_WORDS_MAX).join(' ');
+        if (q.split(' ').length >= 2 && !queries.includes(q))
+            queries.push(q);
+    };
+    push(words.slice(0, 3));
+    push([names[0] ?? '', ...words.filter((w) => w !== names[0]).slice(0, 2)]);
+    push(names.slice(1, 4));
+    if (queries.length === 0) { // a body too thin to name anything twice: the title is all there is
+        const heading = text.split('\n').find((l) => l.startsWith('#')) ?? '';
+        const title = tokens(heading.replace(/^#+/, '')).slice(0, QUERY_WORDS_MAX);
+        push([...names.slice(0, 1), ...title]);
+        words.push(...title);
+    }
+    const body = queries.slice(0, BODY_QUERIES_MAX);
+    for (const s of loadScenarios(root)) {
+        if (s.check.type !== 'http')
+            continue;
+        try {
+            const host = hostKey(s.check.url);
+            if (host && !body.includes(`${host} sdk`))
+                body.push(`${host} sdk`);
+        }
+        catch {
+            /* not a URL — nothing to ask */
+        }
+    }
+    const pkg = readJson(path.join(root, 'package.json'));
+    const deps = Object.keys(pkg?.dependencies ?? {}).filter((d) => !d.startsWith('@types/')).slice(0, QUERY_DEPS_MAX);
+    if (deps.length > 0 && words[0])
+        body.push(`${deps.join(' ')} ${words[0]}`);
+    return body.slice(0, QUERIES_MAX);
+}
+//# sourceMappingURL=research-queries.js.map

package/dist/core/research-queries.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"research-queries.js","sourceRoot":"","sources":["../../src/core/research-queries.ts"],"names":[],"mappings":"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"}

package/dist/core/research.js

@@ -1,91 +1,53 @@
-import { skillsmpClient } from './skillsmp.js';
+import { skillsmpClient, SKILLSMP_UNAVAILABLE } from './skillsmp.js';
 import { createHash } from 'node:crypto';
 import fs from 'node:fs';
 import path from 'node:path';
 import { detectClient, detectModel } from './client.js';
 import { readConfig } from './config.js';
-import { applyWindow } from './recent.js';
+import { applyWindow, DAY_MS } from './recent.js';
 import { usage } from './errors.js';
 import { githubClient } from './github.js';
-import { intentPath, loadScenarios } from './intent.js';
 import { record } from './ledger.js';
 import { vibePath } from './paths.js';
-import { readJson, readText, writeAtomic, writeJson, nowIso } from './store.js';
+import { queriesFromIntent, tokens, TERM_MIN_LENGTH } from './research-queries.js';
+import { readJson, writeAtomic, writeJson, nowIso } from './store.js';
+export { queriesFromIntent };
 export const SOURCES = ['repos', 'code', 'skills'];
-const CACHE_TTL_MS = 24 * 60 * 60 * 1000;
+const CACHE_TTL_MS = DAY_MS;
+/** A result with warnings (a source was down) is kept only briefly, so the next run tries again. */
+const WARNED_CACHE_TTL_MS = 5 * 60 * 1000;
+/** Bumped when the cached shape or the sources change, so an old cache is not read as a current answer. */
+const CACHE_KEY_VERSION = 'skillsmp-v1';
+const CACHE_KEY_LENGTH = 16;
 const DEFAULT_MAX = 5;
 const DEFAULT_DAYS = 30;
-const STOP = new Set(['a', 'an', 'the', 'and', 'or', 'of', 'to', 'in', 'for', 'with', 'vibe', 'phase', 'into', 'from', 'on', 'by', 'is', 'it',
-    // words every intent uses — they describe the harness, not the work
-    'check', 'checks', 'scenario', 'scenarios', 'intent', 'harness', 'model', 'client', 'test', 'tests', 'file', 'files', 'line', 'lines', 'when', 'then', 'given',
-    'that', 'this', 'each', 'every', 'same', 'other', 'than', 'under', 'over', 'first', 'names', 'name', 'none', 'nothing', 'stays', 'still', 'earlier', 'gates', 'build', 'live']);
-function tokens(text) {
-    return [...new Set(text.toLowerCase().split(/[^a-z0-9]+/).filter((w) => w.length > 2 && !STOP.has(w)))];
-}
-/** The words the intent body actually repeats: backticked names first, then frequent words of four letters or more. */
-function bodyTerms(text) {
-    const section = text.split(/^## What counts as success/m)[1]?.split(/^## /m)[0] ?? text;
-    const count = new Map();
-    for (const m of section.matchAll(/`([a-z][a-z0-9-]{3,})`/g))
-        count.set(m[1], (count.get(m[1]) ?? 0) + 1);
-    const names = [...count.entries()].filter(([w]) => !STOP.has(w)).sort((a, b) => b[1] - a[1]).map(([w]) => w);
-    const freq = new Map();
-    for (const w of section.toLowerCase().replace(/`[^`]*`/g, ' ').split(/[^a-z0-9]+/)) {
-        if (w.length < 4 || STOP.has(w) || /^\d/.test(w))
-            continue;
-        freq.set(w, (freq.get(w) ?? 0) + 1);
-    }
-    const words = [...freq.entries()].filter(([, n]) => n >= 2).sort((a, b) => b[1] - a[1]).map(([w]) => w);
-    return { names, words };
-}
-/** Queries come from what the intent body names and repeats — never from the title's first words — then the hosts its http checks target and the stack. */
-export function queriesFromIntent(root) {
-    const queries = [];
-    const text = readText(intentPath(root)) ?? '';
-    const { names, words } = bodyTerms(text);
-    const push = (parts) => {
-        const q = [...new Set(parts.filter(Boolean))].slice(0, 4).join(' ');
-        if (q.split(' ').length >= 2 && !queries.includes(q))
-            queries.push(q);
-    };
-    push(words.slice(0, 3));
-    push([names[0] ?? '', ...words.filter((w) => w !== names[0]).slice(0, 2)]);
-    push(names.slice(1, 4));
-    if (queries.length === 0) { // a body too thin to name anything twice: the title is all there is
-        const heading = text.split('\n').find((l) => l.startsWith('#')) ?? '';
-        const title = tokens(heading.replace(/^#+/, '')).slice(0, 4);
-        push([...names.slice(0, 1), ...title]);
-        words.push(...title);
-    }
-    const body = queries.slice(0, 3);
-    for (const s of loadScenarios(root)) {
-        if (s.check.type !== 'http')
-            continue;
-        try {
-            const host = new URL(s.check.url).hostname.replace(/^(www|api)\./, '').split('.')[0];
-            if (host && !body.includes(`${host} sdk`))
-                body.push(`${host} sdk`);
-        }
-        catch {
-            /* not a URL — nothing to ask */
-        }
-    }
-    const pkg = readJson(path.join(root, 'package.json'));
-    const deps = Object.keys(pkg?.dependencies ?? {}).filter((d) => !d.startsWith('@types/')).slice(0, 2);
-    if (deps.length > 0 && words[0])
-        body.push(`${deps.join(' ')} ${words[0]}`);
-    return body.slice(0, 5);
-}
+const GITHUB_WEB = 'https://github.com';
+/** Results asked of each GitHub search request. */
+const PER_SEARCH = 5;
+/** Score: points per matched query word, recency bands, and the cap of the stars bonus (log10 of the stars). */
+const MATCH_POINTS = 3;
+const FRESH_DAYS = 180;
+const STALE_DAYS = 365;
+const STARS_BONUS_MAX = 4;
+const SLUG_MAX = 40;
+/** A catalog skill name also matches the first letters of a longer query word. */
+const PREFIX_MATCH_LENGTH = 4;
+const DEFAULT_SLUG = 'research';
+const NOTE_DATE_LENGTH = 10;
+const GITHUB_FIXTURE_ENV = 'VIBE_GITHUB_FIXTURE';
+const SKILLSMP_ENV = 'VIBE_SKILLSMP';
+const NOTE_MONTH_LENGTH = 7;
+const UNKNOWN_CELL = '—';
 function score(text, queryTokens, stars, updatedAt, license) {
     const haystack = text.toLowerCase();
     const matched = queryTokens.filter((t) => haystack.includes(t));
-    let total = matched.length * 3;
+    let total = matched.length * MATCH_POINTS;
     if (updatedAt) {
         const age = Date.now() - new Date(updatedAt).getTime();
-        total += age < 180 * 86_400_000 ? 2 : age < 365 * 86_400_000 ? 1 : 0;
+        total += age < FRESH_DAYS * DAY_MS ? 2 : age < STALE_DAYS * DAY_MS ? 1 : 0;
     }
     if (stars)
-        total += Math.min(Math.log10(stars), 4);
+        total += Math.min(Math.log10(stars), STARS_BONUS_MAX);
     if (license && license !== 'NOASSERTION')
         total += 1;
     return { score: total, matched };
@@ -93,7 +55,7 @@ function score(text, queryTokens, stars, updatedAt, license) {
 function why(matched, updatedAt, stars, license) {
     const parts = [matched.length ? `matches "${matched.join(', ')}"` : 'no keyword match'];
     if (updatedAt)
-        parts.push(`updated ${updatedAt.slice(0, 7)}`);
+        parts.push(`updated ${updatedAt.slice(0, NOTE_MONTH_LENGTH)}`);
     if (stars !== null)
         parts.push(`${stars} stars`);
     parts.push(license ? license : 'no license');
@@ -107,7 +69,8 @@ function fromRepo(item, queryTokens) {
     const license = item.license?.spdx_id ?? null;
     const s = score(`${item.full_name} ${item.description ?? ''}`, queryTokens, stars, updatedAt, license);
     const action = license ? `knowledge: save a reference note on ${item.full_name}` : 'none — license unknown';
-    return { kind: 'repo', ref: item.full_name, url: item.html_url, why: why(s.matched, updatedAt, stars, license), stars, updatedAt, license, action, score: s.score };
+    const reason = why(s.matched, updatedAt, stars, license);
+    return { kind: 'repo', ref: item.full_name, url: item.html_url, why: reason, stars, updatedAt, license, action, score: s.score };
 }
 function fromCode(item, queryTokens) {
     const repo = item.repository;
@@ -116,8 +79,12 @@ function fromCode(item, queryTokens) {
     const dir = path.posix.dirname(item.path);
     const name = dir === '.' ? '' : path.posix.basename(dir);
     const ref = name ? `${repo.full_name}@${name}` : repo.full_name;
-    const s = score(`${repo.full_name} ${item.path} ${repo.description ?? ''}`, queryTokens, null, repo.pushed_at ?? null, repo.license?.spdx_id ?? null);
-    return { kind: 'skill', ref, url: `${repo.html_url ?? `https://github.com/${repo.full_name}`}/tree/HEAD/${dir === '.' ? '' : dir}`, why: why(s.matched, repo.pushed_at ?? null, null, repo.license?.spdx_id ?? null), stars: null, updatedAt: repo.pushed_at ?? null, license: repo.license?.spdx_id ?? null, action: `vibe skill add ${ref}`, score: s.score };
+    const updatedAt = repo.pushed_at ?? null;
+    const license = repo.license?.spdx_id ?? null;
+    const s = score(`${repo.full_name} ${item.path} ${repo.description ?? ''}`, queryTokens, null, updatedAt, license);
+    const url = `${repo.html_url ?? `${GITHUB_WEB}/${repo.full_name}`}/tree/HEAD/${dir === '.' ? '' : dir}`;
+    const reason = why(s.matched, updatedAt, null, license);
+    return { kind: 'skill', ref, url, why: reason, stars: null, updatedAt, license, action: `vibe skill add ${ref}`, score: s.score };
 }
 /** One tree request per catalog; a skill is any directory holding SKILL.md, at any depth under `skills/` or the root. */
 export function skillDirsInTree(entries) {
@@ -144,10 +111,16 @@ async function catalogCandidates(client, catalog, queryTokens) {
     const out = [];
     for (const { name, dir } of skillDirsInTree(entries)) {
         const leaf = path.posix.basename(name);
-        const matched = queryTokens.filter((t) => name.toLowerCase().includes(t) || (t.length > 3 && leaf.includes(t.slice(0, 4))));
+        const matchesName = (t) => name.toLowerCase().includes(t)
+            || (t.length >= PREFIX_MATCH_LENGTH && leaf.includes(t.slice(0, PREFIX_MATCH_LENGTH)));
+        const matched = queryTokens.filter(matchesName);
         if (matched.length === 0)
             continue;
-        out.push({ kind: 'skill', ref: `${catalog}@${name}`, url: `https://github.com/${catalog}/tree/HEAD/${dir}`, why: `catalog ${catalog} · matches "${matched.join(', ')}"`, stars: null, updatedAt: null, license: null, action: `vibe skill add ${catalog}@${name}`, score: matched.length * 3 + 2 });
+        const ref = `${catalog}@${name}`;
+        out.push({
+            kind: 'skill', ref, url: `${GITHUB_WEB}/${catalog}/tree/HEAD/${dir}`, why: `catalog ${catalog} · matches "${matched.join(', ')}"`,
+            stars: null, updatedAt: null, license: null, action: `vibe skill add ${ref}`, score: matched.length * MATCH_POINTS + 2,
+        });
     }
     return out;
 }
@@ -156,7 +129,7 @@ async function searchRepos(client, query) {
     const words = query.split(' ').filter(Boolean);
     for (let n = words.length; n >= 1; n -= 1) {
         const q = words.slice(0, n).join(' ');
-        const res = (await client.get(`/search/repositories?q=${encodeURIComponent(q)}&sort=updated&per_page=5`));
+        const res = (await client.get(`/search/repositories?q=${encodeURIComponent(q)}&sort=updated&per_page=${PER_SEARCH}`));
         if ((res.items ?? []).length > 0 || n === 1)
             return res.items ?? [];
     }
@@ -175,7 +148,7 @@ async function search(client, queries, sources, catalogs) {
             }
         }
         if (sources.includes('code') && client.authenticated) {
-            const res = (await client.get(`/search/code?q=${encodeURIComponent(`${q} filename:SKILL.md`)}&per_page=5`));
+            const res = (await client.get(`/search/code?q=${encodeURIComponent(`${q} filename:SKILL.md`)}&per_page=${PER_SEARCH}`));
             for (const item of res.items ?? []) {
                 const c = fromCode(item, queryTokens);
                 if (c)
@@ -190,7 +163,7 @@ async function search(client, queries, sources, catalogs) {
     // A candidate none of the query words describe is noise, whatever search returned it; so is one that matches only words under four letters.
     for (const c of found) {
         const matched = /matches "([^"]*)"/.exec(c.why)?.[1]?.split(', ') ?? [];
-        if (matched.length === 0 || matched.every((t) => t.length < 4))
+        if (matched.length === 0 || matched.every((t) => t.length < TERM_MIN_LENGTH))
             continue;
         if (!byRef.has(c.ref) || byRef.get(c.ref).score < c.score)
             byRef.set(c.ref, c);
@@ -198,13 +171,33 @@ async function search(client, queries, sources, catalogs) {
     return [...byRef.values()].sort((a, b) => b.score - a.score);
 }
 function slug(text) {
-    return text.toLowerCase().replace(/[^a-z0-9]+/g, '-').replace(/^-+|-+$/g, '').slice(0, 40) || 'research';
+    return text.toLowerCase().replace(/[^a-z0-9]+/g, '-').replace(/^-+|-+$/g, '').slice(0, SLUG_MAX) || DEFAULT_SLUG;
+}
+/** What moved last in a repository: its newest release, else its last commit. */
+function latestActivity(c) {
+    if (!c.recent)
+        return UNKNOWN_CELL;
+    const release = c.recent.releases[0];
+    if (release)
+        return `${release.tag} ${release.at.slice(0, NOTE_DATE_LENGTH)}`;
+    return c.recent.lastCommitAt ? `commit ${c.recent.lastCommitAt.slice(0, NOTE_DATE_LENGTH)}` : 'none';
+}
+function noteRow(c) {
+    const inWindow = c.recent ? (c.recent.inWindow ? 'yes' : 'no') : UNKNOWN_CELL;
+    return `| ${c.kind} | [${c.ref}](${c.url}) | ${inWindow} | ${latestActivity(c)} | ${c.why} | ${c.action} |`;
 }
 function writeNote(root, queries, candidates, days, cutoff, warnings) {
-    const file = vibePath(root, 'knowledge', 'research', `${nowIso().slice(0, 10)}-${slug(queries[0] ?? '')}.md`);
-    const latest = (c) => (c.recent ? (c.recent.releases[0] ? `${c.recent.releases[0].tag} ${c.recent.releases[0].at.slice(0, 10)}` : c.recent.lastCommitAt ? `commit ${c.recent.lastCommitAt.slice(0, 10)}` : 'none') : '—');
-    const rows = candidates.map((c) => `| ${c.kind} | [${c.ref}](${c.url}) | ${c.recent ? (c.recent.inWindow ? 'yes' : 'no') : '—'} | ${latest(c)} | ${c.why} | ${c.action} |`);
-    const body = [`# Research — ${queries.join(' · ')}`, '', `Date: ${nowIso().slice(0, 10)} · Window: last ${days} days (since ${cutoff}) · Source: GitHub search, skill catalogs and optional SkillsMP discovery · GitHub results rank by activity inside the window, then keyword match, recency, stars and license; SkillsMP hints are interleaved without a quality score. Nothing is dropped for being old. Nothing here was executed or installed.`, ...warnings.map(w => `Search limitation: ${w}`), '', '| kind | candidate | in window | latest | why | action |', '|---|---|---|---|---|---|', ...rows, ''].join('\n');
+    const date = nowIso().slice(0, NOTE_DATE_LENGTH);
+    const file = vibePath(root, 'knowledge', 'research', `${date}-${slug(queries[0] ?? '')}.md`);
+    const preamble = [
+        `Date: ${date} · Window: last ${days} days (since ${cutoff}) · Source: GitHub search, skill catalogs and optional SkillsMP discovery`,
+        '· GitHub results rank by activity inside the window, then keyword match, recency, stars and license;',
+        'SkillsMP hints are interleaved without a quality score. Nothing is dropped for being old. Nothing here was executed or installed.',
+    ].join(' ');
+    const body = [
+        `# Research — ${queries.join(' · ')}`, '', preamble, ...warnings.map(w => `Search limitation: ${w}`), '',
+        '| kind | candidate | in window | latest | why | action |', '|---|---|---|---|---|---|', ...candidates.map(noteRow), '',
+    ].join('\n');
     writeAtomic(file, body);
     return file;
 }
@@ -225,7 +218,7 @@ async function searchSources(github, provider, queries, sources, catalogs, days,
             discovered = await provider.search(queries[0]);
         }
         catch {
-            warnings.push('SkillsMP unavailable, limited or invalid; using existing GitHub search');
+            warnings.push(SKILLSMP_UNAVAILABLE);
         }
     }
     const outcome = await githubSearch;
@@ -245,9 +238,15 @@ async function searchSources(github, provider, queries, sources, catalogs, days,
             unique.set(canonical(c), originals.get(canonical(c)) ?? c);
     return [...unique.values()];
 }
+/** The marketplace searched next to GitHub: none under a test client, a fixture or `VIBE_SKILLSMP=off`. */
+function marketplaceFor(client, marketplace) {
+    if (marketplace !== undefined)
+        return marketplace;
+    return client || process.env[GITHUB_FIXTURE_ENV] || process.env[SKILLSMP_ENV] === 'off' ? null : skillsmpClient();
+}
 export async function research(root, options, client, marketplace) {
     const github = client ?? githubClient();
-    const provider = marketplace !== undefined ? marketplace : client || process.env['VIBE_GITHUB_FIXTURE'] || process.env['VIBE_SKILLSMP'] === 'off' ? null : skillsmpClient();
+    const provider = marketplaceFor(client, marketplace);
     const queries = options.fromIntent ? queriesFromIntent(root) : options.query ? [options.query] : [];
     if (queries.length === 0)
         throw usage(options.fromIntent ? 'no intent to research — draft one first' : 'research --from-intent | "query"');
@@ -255,15 +254,17 @@ export async function research(root, options, client, marketplace) {
     const max = options.max ?? DEFAULT_MAX;
     const days = options.days ?? DEFAULT_DAYS;
     const now = options.now ?? Date.now();
-    const cutoff = new Date(now - days * 86_400_000).toISOString().slice(0, 10);
+    const cutoff = new Date(now - days * DAY_MS).toISOString().slice(0, 10);
     const catalogs = readConfig(root).catalogs;
-    const key = createHash('sha256').update(JSON.stringify(['skillsmp-v1', queries, sources, catalogs, days, Boolean(provider)])).digest('hex').slice(0, 16);
+    const key = createHash('sha256').update(JSON.stringify([CACHE_KEY_VERSION, queries, sources, catalogs, days, Boolean(provider)]))
+        .digest('hex').slice(0, CACHE_KEY_LENGTH);
     const cacheFile = vibePath(root, 'cache', 'research', `${key}.json`);
     const cached = readJson(cacheFile);
     let candidates;
     let fromCache = false;
     let warnings = [];
-    if (cached && Date.now() - new Date(cached.at).getTime() < (cached.warnings?.length ? 300_000 : CACHE_TTL_MS)) {
+    const cacheTtl = cached?.warnings?.length ? WARNED_CACHE_TTL_MS : CACHE_TTL_MS;
+    if (cached && Date.now() - new Date(cached.at).getTime() < cacheTtl) {
         candidates = cached.candidates;
         warnings = cached.warnings ?? [];
         fromCache = true;