hypomnema 1.4.2 → 1.5.1

package/hooks/hypo-session-start.mjs

@@ -7,7 +7,7 @@
  *   MISS → inject global hot.md pointer only (no fan-out to all projects)
  */
 
-import { readFileSync, writeFileSync, existsSync, readdirSync, statSync } from 'fs';
+import { readFileSync, writeFileSync, existsSync, realpathSync } from 'fs';
 import { homedir } from 'os';
 import { join, dirname } from 'path';
 import { fileURLToPath } from 'url';
@@ -28,6 +28,10 @@ import {
   buildProjectSuggestionLine,
   recordSuggestionCooldown,
   sanitizeProjForPrompt,
+  pickProjectByCwd,
+  collectProjectWorkingDirs,
+  buildVaultOrientation,
+  staleMarkerFor,
 } from './hypo-shared.mjs';
 import {
   defaultCachePath,
@@ -53,6 +57,21 @@ function readIfNotIgnored(path, maxChars, patterns) {
   return readFileSync(path, 'utf-8').slice(0, maxChars);
 }
 
+// Compute the STALE marker for a hot/state file from its RAW content (readIfNotIgnored
+// already slices, which could truncate frontmatter). Honors the same .hypoignore
+// privacy guard, and returns '' for any miss (no path, ignored, absent, no
+// verify_by_date, or error) so derived summaries pass through unchanged.
+function staleMarkerForPath(path, patterns, today) {
+  try {
+    if (!path) return '';
+    if (patterns.length > 0 && isIgnored(path, HYPO_DIR, patterns)) return '';
+    if (!existsSync(path)) return '';
+    return staleMarkerFor(readFileSync(path, 'utf-8'), today);
+  } catch {
+    return '';
+  }
+}
+
 // Directory of the running hook, and the install root one level up
 // (<root>/hooks/...). The root is derived from the RUNNING hook path rather
 // than ~/.claude/hypo-pkg.json so a dual install (npm + plugin) or a stale
@@ -124,7 +143,7 @@ function buildUpdateNotice() {
 }
 
 /**
- * Stale-sibling notice (ADR 0038, D3). The update-notifier above only knows
+ * Stale-sibling notice (D3). The update-notifier above only knows
  * whether the ACTIVE install is behind latest — it is blind to an OLDER sibling
  * that owns the `hypomnema` bin on PATH. That sibling is the live footgun:
  * running `hypomnema init`/`upgrade` through it downgrades the active hooks.
@@ -176,7 +195,7 @@ function readLastGrowthLine() {
 }
 
 /**
- * ADR 0022 amendment 2026-05-14: if the prior session ended
+ * Amendment 2026-05-14: if the prior session ended
  * via `/clear`, hypo-session-end stashed its identity in `.cache/clear-marker.json`.
  * Read it (with 7-day stale guard), unlink it (one-shot), and return a
  * `[WIKI_AUTOCLOSE]` recovery line for additionalContext + stderr.
@@ -256,41 +275,26 @@ const GLOBAL_HOT = join(HYPO_DIR, 'hot.md');
 const HOT_CHARS = 2000;
 const STATE_CHARS = 2000;
 
-function parseFrontmatterField(content, key) {
-  const match = content.match(/^---\r?\n([\s\S]*?)\r?\n---/);
-  if (!match) return null;
-  const line = match[1].split('\n').find((l) => l.startsWith(`${key}:`));
-  if (!line) return null;
-  return line
-    .slice(key.length + 1)
-    .trim()
-    .replace(/^['"]|['"]$/g, '');
-}
-
 function findProjectFiles(cwd) {
   if (!existsSync(PROJECTS_DIR)) return null;
-  for (const proj of readdirSync(PROJECTS_DIR)) {
-    const projDir = join(PROJECTS_DIR, proj);
-    if (!statSync(projDir).isDirectory()) continue;
-    const indexPath = join(projDir, 'index.md');
-    if (!existsSync(indexPath)) continue;
-    const content = readFileSync(indexPath, 'utf-8');
-    const workingDir = parseFrontmatterField(content, 'working_dir');
-    if (!workingDir) continue;
-    const resolved = workingDir.startsWith('~/')
-      ? join(homedir(), workingDir.slice(2))
-      : workingDir;
-    if (cwd === resolved || cwd.startsWith(resolved + '/')) {
-      const hotPath = join(projDir, 'hot.md');
-      const statePath = join(projDir, 'session-state.md');
-      return {
-        proj,
-        hotPath: existsSync(hotPath) ? hotPath : null,
-        statePath: existsSync(statePath) ? statePath : null,
-      };
-    }
+  let realpathCwd = null;
+  try {
+    realpathCwd = realpathSync(cwd);
+  } catch {
+    realpathCwd = null;
   }
-  return null;
+  // Two-tier match (absolute prefix, then cross-machine unique basename) so a
+  // vault synced from another machine still resolves the cwd to its project.
+  const proj = pickProjectByCwd(collectProjectWorkingDirs(HYPO_DIR), cwd, { realpathCwd });
+  if (!proj) return null;
+  const projDir = join(PROJECTS_DIR, proj);
+  const hotPath = join(projDir, 'hot.md');
+  const statePath = join(projDir, 'session-state.md');
+  return {
+    proj,
+    hotPath: existsSync(hotPath) ? hotPath : null,
+    statePath: existsSync(statePath) ? statePath : null,
+  };
 }
 
 function extractSection(content, heading) {
@@ -343,7 +347,7 @@ process.stdin.on('end', () => {
     const pullOk = gitPull(HYPO_DIR);
     const syncLine = syncStateNotice(pullOk);
     const growthLine = readLastGrowthLine();
-    // ADR 0022 amendment: on source='clear', surface the dying
+    // On source='clear', surface the dying
     // session's identity that hypo-session-end stashed so Claude can recover
     // session-close work that /clear skipped. One-shot: marker is unlinked
     // immediately after read.
@@ -377,9 +381,25 @@ process.stdin.on('end', () => {
 
     const ignorePatterns = loadHypoIgnore(HYPO_DIR);
 
+    // When cwd is a project working_dir that is NOT the vault itself, tell the
+    // AI where the vault lives so it does not re-discover the path or look for
+    // wiki files in the code repo. '' when cwd === vault root.
+    const vaultOrientation = hit ? buildVaultOrientation(cwd) : '';
+    const hitPrefix = vaultOrientation ? `${vaultOrientation}\n\n` : '';
+
     if (hit) {
-      const hotContent = readIfNotIgnored(hit.hotPath, HOT_CHARS, ignorePatterns);
-      const stateContent = readIfNotIgnored(hit.statePath, STATE_CHARS, ignorePatterns);
+      // project hot/state only. root/global hot (below) is a derived pointer
+      // table with no per-page frontmatter, so it is never a STALE target and
+      // gets no marker logic. TODAY is UTC to match doctor.mjs (D1/D2). The
+      // marker is computed on raw content (staleMarkerForPath), then prepended
+      // onto the sliced display content; a no-op when there is no verify_by_date.
+      const TODAY = new Date().toISOString().slice(0, 10);
+      let hotContent = readIfNotIgnored(hit.hotPath, HOT_CHARS, ignorePatterns);
+      let stateContent = readIfNotIgnored(hit.statePath, STATE_CHARS, ignorePatterns);
+      const hotMarker = staleMarkerForPath(hit.hotPath, ignorePatterns, TODAY);
+      const stateMarker = staleMarkerForPath(hit.statePath, ignorePatterns, TODAY);
+      if (hotContent && hotMarker) hotContent = `${hotMarker}\n${hotContent}`;
+      if (stateContent && stateMarker) stateContent = `${stateMarker}\n${stateContent}`;
 
       if (hotContent || stateContent) {
         printTerminalSummary(hit.proj, hotContent, stateContent);
@@ -399,7 +419,7 @@ process.stdin.on('end', () => {
         console.log(
           JSON.stringify(
             buildOutput(
-              `${noticePrefix}[WIKI HOT CACHE: project=${sanitizeProjForPrompt(hit.proj)}]\n\n${parts.join('\n\n')}`,
+              `${noticePrefix}${hitPrefix}[WIKI HOT CACHE: project=${sanitizeProjForPrompt(hit.proj)}]\n\n${parts.join('\n\n')}`,
               outExtra,
             ),
           ),
@@ -415,7 +435,7 @@ process.stdin.on('end', () => {
         console.log(
           JSON.stringify(
             buildOutput(
-              `${noticePrefix}[WIKI HOT CACHE: project=${sanitizeProjForPrompt(hit.proj)}, no snapshot yet]`,
+              `${noticePrefix}${hitPrefix}[WIKI HOT CACHE: project=${sanitizeProjForPrompt(hit.proj)}, no snapshot yet]`,
               outExtra,
             ),
           ),
@@ -424,8 +444,8 @@ process.stdin.on('end', () => {
       return;
     }
 
-    // MISS: cwd matches no project. ADR 0023 — offer to create one
-    // when the ADR trigger conditions hold (git repo + project marker + no
+    // MISS: cwd matches no project. Offer to create one
+    // when the trigger conditions hold (git repo + project marker + no
     // cooldown + not previously declined). The actual scaffold is the LLM's
     // job on a "Y" reply (scripts/lib/project-create.mjs); the hook only nudges.
     if (shouldSuggestProjectCreation(cwd, HYPO_DIR)) {