@tekmidian/pai 0.14.2 → 0.16.0

package/dist/{auto-route-CLYcToZ5.mjs → auto-route-CdvjEWs5.mjs}

@@ -1,5 +1,5 @@
-import { r as readPaiMarker } from "./pai-marker-HVBwwBW-.mjs";
-import { t as detectProject } from "./detect-KjycLtXM.mjs";
+import { r as readPaiMarker } from "./pai-marker-B20KqhA8.mjs";
+import { t as detectProject } from "./detect-Bf2z-oKB.mjs";
 import { existsSync } from "node:fs";
 import { dirname, resolve } from "node:path";
 
@@ -26,7 +26,7 @@ async function autoRoute(registryDb, federation, cwd, context) {
 	const markerResult = findMarkerUpward(registryDb, target);
 	if (markerResult) return markerResult;
 	if (context && context.trim().length > 0) {
-		const { detectTopicShift } = await import("./detector-ZiOhHszd.mjs").then((n) => n.n);
+		const { detectTopicShift } = await import("./detector-rq9JGTmS.mjs").then((n) => n.n);
 		const topicResult = await detectTopicShift(registryDb, federation, {
 			context,
 			threshold: .5
@@ -83,4 +83,4 @@ function formatAutoRouteJson(result) {
 
 //#endregion
 export { autoRoute, formatAutoRouteJson };
-//# sourceMappingURL=auto-route-CLYcToZ5.mjs.map
+//# sourceMappingURL=auto-route-CdvjEWs5.mjs.map

package/dist/{auto-route-CLYcToZ5.mjs.map → auto-route-CdvjEWs5.mjs.map}

@@ -1 +1 @@
-{"version":3,"file":"auto-route-CLYcToZ5.mjs","names":[],"sources":["../src/session/auto-route.ts"],"sourcesContent":["/**\n * Auto-route: automatic project routing suggestion on session start.\n *\n * Given a working directory (and optional conversation context), determine\n * which registered project the session belongs to.\n *\n * Strategy (in priority order):\n *   1. Path match   — exact or parent-directory match in the project registry\n *   2. Marker walk  — walk up from cwd looking for Notes/PAI.md, resolve slug\n *   3. Topic match  — BM25 keyword search against memory (requires context text)\n *\n * The function is stateless and works with direct DB access (no daemon\n * required), making it fast and safe to call during session startup.\n */\n\nimport type { Database } from \"better-sqlite3\";\nimport type { StorageBackend } from \"../storage/interface.js\";\nimport { resolve, dirname } from \"node:path\";\nimport { existsSync } from \"node:fs\";\nimport { readPaiMarker } from \"../registry/pai-marker.js\";\nimport { detectProject } from \"../cli/commands/detect.js\";\n\n// ---------------------------------------------------------------------------\n// Types\n// ---------------------------------------------------------------------------\n\nexport type AutoRouteMethod = \"path\" | \"marker\" | \"topic\";\n\nexport interface AutoRouteResult {\n  /** Project slug */\n  slug: string;\n  /** Human-readable project name */\n  display_name: string;\n  /** Absolute path to the project root */\n  root_path: string;\n  /** How the project was detected */\n  method: AutoRouteMethod;\n  /** Confidence [0,1]: 1.0 for path/marker matches, BM25 fraction for topic */\n  confidence: number;\n}\n\n// ---------------------------------------------------------------------------\n// Core function\n// ---------------------------------------------------------------------------\n\n/**\n * Determine which project a session should be routed to.\n *\n * @param registryDb  Open PAI registry database\n * @param federation  Memory storage backend (needed only for topic fallback)\n * @param cwd         Working directory to detect from (defaults to process.cwd())\n * @param context     Optional conversation text for topic-based fallback\n * @returns           Best project match, or null if nothing matched\n */\nexport async function autoRoute(\n  registryDb: Database,\n  federation: Database | StorageBackend,\n  cwd?: string,\n  context?: string\n): Promise<AutoRouteResult | null> {\n  const target = resolve(cwd ?? process.cwd());\n\n  // -------------------------------------------------------------------------\n  // Strategy 1: Path match via registry\n  // -------------------------------------------------------------------------\n\n  const pathMatch = detectProject(registryDb, target);\n\n  if (pathMatch) {\n    return {\n      slug: pathMatch.slug,\n      display_name: pathMatch.display_name,\n      root_path: pathMatch.root_path,\n      method: \"path\",\n      confidence: 1.0,\n    };\n  }\n\n  // -------------------------------------------------------------------------\n  // Strategy 2: PAI.md marker file walk\n  //\n  // Walk up from cwd, checking <dir>/Notes/PAI.md at each level.\n  // Once found, resolve the slug against the registry to get full project info.\n  // -------------------------------------------------------------------------\n\n  const markerResult = findMarkerUpward(registryDb, target);\n  if (markerResult) {\n    return markerResult;\n  }\n\n  // -------------------------------------------------------------------------\n  // Strategy 3: Topic detection (requires context text)\n  // -------------------------------------------------------------------------\n\n  if (context && context.trim().length > 0) {\n    // Lazy import to avoid bundler pulling in daemon/index.mjs at module load time\n    const { detectTopicShift } = await import(\"../topics/detector.js\");\n    const topicResult = await detectTopicShift(registryDb, federation, {\n      context,\n      threshold: 0.5, // Lower threshold for initial routing (vs shift detection)\n    });\n\n    if (topicResult.suggestedProject && topicResult.confidence > 0) {\n      // Look up the full project info from the registry\n      const projectRow = registryDb\n        .prepare(\n          \"SELECT slug, display_name, root_path FROM projects WHERE slug = ? AND status != 'archived'\"\n        )\n        .get(topicResult.suggestedProject) as\n        | { slug: string; display_name: string; root_path: string }\n        | undefined;\n\n      if (projectRow) {\n        return {\n          slug: projectRow.slug,\n          display_name: projectRow.display_name,\n          root_path: projectRow.root_path,\n          method: \"topic\",\n          confidence: topicResult.confidence,\n        };\n      }\n    }\n  }\n\n  return null;\n}\n\n// ---------------------------------------------------------------------------\n// Marker walk helper\n// ---------------------------------------------------------------------------\n\n/**\n * Walk up the directory tree from `startDir`, checking each level for a\n * `Notes/PAI.md` file. If found, read the slug and look up the project.\n *\n * Stops at the filesystem root or after 20 levels (safety guard).\n */\nfunction findMarkerUpward(\n  registryDb: Database,\n  startDir: string\n): AutoRouteResult | null {\n  let current = startDir;\n  let depth = 0;\n\n  while (depth < 20) {\n    const markerPath = `${current}/Notes/PAI.md`;\n\n    if (existsSync(markerPath)) {\n      const marker = readPaiMarker(current);\n\n      if (marker && marker.status !== \"archived\") {\n        // Resolve slug to full project info in the registry\n        const projectRow = registryDb\n          .prepare(\n            \"SELECT slug, display_name, root_path FROM projects WHERE slug = ? AND status != 'archived'\"\n          )\n          .get(marker.slug) as\n          | { slug: string; display_name: string; root_path: string }\n          | undefined;\n\n        if (projectRow) {\n          return {\n            slug: projectRow.slug,\n            display_name: projectRow.display_name,\n            root_path: projectRow.root_path,\n            method: \"marker\",\n            confidence: 1.0,\n          };\n        }\n      }\n    }\n\n    const parent = dirname(current);\n    if (parent === current) break; // Reached filesystem root\n    current = parent;\n    depth++;\n  }\n\n  return null;\n}\n\n// ---------------------------------------------------------------------------\n// Format helpers\n// ---------------------------------------------------------------------------\n\n/**\n * Format an AutoRouteResult as a human-readable string for CLI output.\n */\nexport function formatAutoRoute(result: AutoRouteResult): string {\n  const lines: string[] = [\n    `slug:         ${result.slug}`,\n    `display_name: ${result.display_name}`,\n    `root_path:    ${result.root_path}`,\n    `method:       ${result.method}`,\n    `confidence:   ${(result.confidence * 100).toFixed(0)}%`,\n  ];\n  return lines.join(\"\\n\");\n}\n\n/**\n * Format an AutoRouteResult as JSON for machine consumption.\n */\nexport function formatAutoRouteJson(result: AutoRouteResult): string {\n  return JSON.stringify(result, null, 2);\n}\n"],"mappings":";;;;;;;;;;;;;;;AAsDA,eAAsB,UACpB,YACA,YACA,KACA,SACiC;CACjC,MAAM,SAAS,QAAQ,OAAO,QAAQ,KAAK,CAAC;CAM5C,MAAM,YAAY,cAAc,YAAY,OAAO;AAEnD,KAAI,UACF,QAAO;EACL,MAAM,UAAU;EAChB,cAAc,UAAU;EACxB,WAAW,UAAU;EACrB,QAAQ;EACR,YAAY;EACb;CAUH,MAAM,eAAe,iBAAiB,YAAY,OAAO;AACzD,KAAI,aACF,QAAO;AAOT,KAAI,WAAW,QAAQ,MAAM,CAAC,SAAS,GAAG;EAExC,MAAM,EAAE,qBAAqB,MAAM,OAAO;EAC1C,MAAM,cAAc,MAAM,iBAAiB,YAAY,YAAY;GACjE;GACA,WAAW;GACZ,CAAC;AAEF,MAAI,YAAY,oBAAoB,YAAY,aAAa,GAAG;GAE9D,MAAM,aAAa,WAChB,QACC,6FACD,CACA,IAAI,YAAY,iBAAiB;AAIpC,OAAI,WACF,QAAO;IACL,MAAM,WAAW;IACjB,cAAc,WAAW;IACzB,WAAW,WAAW;IACtB,QAAQ;IACR,YAAY,YAAY;IACzB;;;AAKP,QAAO;;;;;;;;AAaT,SAAS,iBACP,YACA,UACwB;CACxB,IAAI,UAAU;CACd,IAAI,QAAQ;AAEZ,QAAO,QAAQ,IAAI;AAGjB,MAAI,WAFe,GAAG,QAAQ,eAEJ,EAAE;GAC1B,MAAM,SAAS,cAAc,QAAQ;AAErC,OAAI,UAAU,OAAO,WAAW,YAAY;IAE1C,MAAM,aAAa,WAChB,QACC,6FACD,CACA,IAAI,OAAO,KAAK;AAInB,QAAI,WACF,QAAO;KACL,MAAM,WAAW;KACjB,cAAc,WAAW;KACzB,WAAW,WAAW;KACtB,QAAQ;KACR,YAAY;KACb;;;EAKP,MAAM,SAAS,QAAQ,QAAQ;AAC/B,MAAI,WAAW,QAAS;AACxB,YAAU;AACV;;AAGF,QAAO;;;;;AAwBT,SAAgB,oBAAoB,QAAiC;AACnE,QAAO,KAAK,UAAU,QAAQ,MAAM,EAAE"}
+{"version":3,"file":"auto-route-CdvjEWs5.mjs","names":[],"sources":["../src/session/auto-route.ts"],"sourcesContent":["/**\n * Auto-route: automatic project routing suggestion on session start.\n *\n * Given a working directory (and optional conversation context), determine\n * which registered project the session belongs to.\n *\n * Strategy (in priority order):\n *   1. Path match   — exact or parent-directory match in the project registry\n *   2. Marker walk  — walk up from cwd looking for Notes/PAI.md, resolve slug\n *   3. Topic match  — BM25 keyword search against memory (requires context text)\n *\n * The function is stateless and works with direct DB access (no daemon\n * required), making it fast and safe to call during session startup.\n */\n\nimport type { Database } from \"better-sqlite3\";\nimport type { StorageBackend } from \"../storage/interface.js\";\nimport { resolve, dirname } from \"node:path\";\nimport { existsSync } from \"node:fs\";\nimport { readPaiMarker } from \"../registry/pai-marker.js\";\nimport { detectProject } from \"../cli/commands/detect.js\";\n\n// ---------------------------------------------------------------------------\n// Types\n// ---------------------------------------------------------------------------\n\nexport type AutoRouteMethod = \"path\" | \"marker\" | \"topic\";\n\nexport interface AutoRouteResult {\n  /** Project slug */\n  slug: string;\n  /** Human-readable project name */\n  display_name: string;\n  /** Absolute path to the project root */\n  root_path: string;\n  /** How the project was detected */\n  method: AutoRouteMethod;\n  /** Confidence [0,1]: 1.0 for path/marker matches, BM25 fraction for topic */\n  confidence: number;\n}\n\n// ---------------------------------------------------------------------------\n// Core function\n// ---------------------------------------------------------------------------\n\n/**\n * Determine which project a session should be routed to.\n *\n * @param registryDb  Open PAI registry database\n * @param federation  Memory storage backend (needed only for topic fallback)\n * @param cwd         Working directory to detect from (defaults to process.cwd())\n * @param context     Optional conversation text for topic-based fallback\n * @returns           Best project match, or null if nothing matched\n */\nexport async function autoRoute(\n  registryDb: Database,\n  federation: Database | StorageBackend,\n  cwd?: string,\n  context?: string\n): Promise<AutoRouteResult | null> {\n  const target = resolve(cwd ?? process.cwd());\n\n  // -------------------------------------------------------------------------\n  // Strategy 1: Path match via registry\n  // -------------------------------------------------------------------------\n\n  const pathMatch = detectProject(registryDb, target);\n\n  if (pathMatch) {\n    return {\n      slug: pathMatch.slug,\n      display_name: pathMatch.display_name,\n      root_path: pathMatch.root_path,\n      method: \"path\",\n      confidence: 1.0,\n    };\n  }\n\n  // -------------------------------------------------------------------------\n  // Strategy 2: PAI.md marker file walk\n  //\n  // Walk up from cwd, checking <dir>/Notes/PAI.md at each level.\n  // Once found, resolve the slug against the registry to get full project info.\n  // -------------------------------------------------------------------------\n\n  const markerResult = findMarkerUpward(registryDb, target);\n  if (markerResult) {\n    return markerResult;\n  }\n\n  // -------------------------------------------------------------------------\n  // Strategy 3: Topic detection (requires context text)\n  // -------------------------------------------------------------------------\n\n  if (context && context.trim().length > 0) {\n    // Lazy import to avoid bundler pulling in daemon/index.mjs at module load time\n    const { detectTopicShift } = await import(\"../topics/detector.js\");\n    const topicResult = await detectTopicShift(registryDb, federation, {\n      context,\n      threshold: 0.5, // Lower threshold for initial routing (vs shift detection)\n    });\n\n    if (topicResult.suggestedProject && topicResult.confidence > 0) {\n      // Look up the full project info from the registry\n      const projectRow = registryDb\n        .prepare(\n          \"SELECT slug, display_name, root_path FROM projects WHERE slug = ? AND status != 'archived'\"\n        )\n        .get(topicResult.suggestedProject) as\n        | { slug: string; display_name: string; root_path: string }\n        | undefined;\n\n      if (projectRow) {\n        return {\n          slug: projectRow.slug,\n          display_name: projectRow.display_name,\n          root_path: projectRow.root_path,\n          method: \"topic\",\n          confidence: topicResult.confidence,\n        };\n      }\n    }\n  }\n\n  return null;\n}\n\n// ---------------------------------------------------------------------------\n// Marker walk helper\n// ---------------------------------------------------------------------------\n\n/**\n * Walk up the directory tree from `startDir`, checking each level for a\n * `Notes/PAI.md` file. If found, read the slug and look up the project.\n *\n * Stops at the filesystem root or after 20 levels (safety guard).\n */\nfunction findMarkerUpward(\n  registryDb: Database,\n  startDir: string\n): AutoRouteResult | null {\n  let current = startDir;\n  let depth = 0;\n\n  while (depth < 20) {\n    const markerPath = `${current}/Notes/PAI.md`;\n\n    if (existsSync(markerPath)) {\n      const marker = readPaiMarker(current);\n\n      if (marker && marker.status !== \"archived\") {\n        // Resolve slug to full project info in the registry\n        const projectRow = registryDb\n          .prepare(\n            \"SELECT slug, display_name, root_path FROM projects WHERE slug = ? AND status != 'archived'\"\n          )\n          .get(marker.slug) as\n          | { slug: string; display_name: string; root_path: string }\n          | undefined;\n\n        if (projectRow) {\n          return {\n            slug: projectRow.slug,\n            display_name: projectRow.display_name,\n            root_path: projectRow.root_path,\n            method: \"marker\",\n            confidence: 1.0,\n          };\n        }\n      }\n    }\n\n    const parent = dirname(current);\n    if (parent === current) break; // Reached filesystem root\n    current = parent;\n    depth++;\n  }\n\n  return null;\n}\n\n// ---------------------------------------------------------------------------\n// Format helpers\n// ---------------------------------------------------------------------------\n\n/**\n * Format an AutoRouteResult as a human-readable string for CLI output.\n */\nexport function formatAutoRoute(result: AutoRouteResult): string {\n  const lines: string[] = [\n    `slug:         ${result.slug}`,\n    `display_name: ${result.display_name}`,\n    `root_path:    ${result.root_path}`,\n    `method:       ${result.method}`,\n    `confidence:   ${(result.confidence * 100).toFixed(0)}%`,\n  ];\n  return lines.join(\"\\n\");\n}\n\n/**\n * Format an AutoRouteResult as JSON for machine consumption.\n */\nexport function formatAutoRouteJson(result: AutoRouteResult): string {\n  return JSON.stringify(result, null, 2);\n}\n"],"mappings":";;;;;;;;;;;;;;;AAsDA,eAAsB,UACpB,YACA,YACA,KACA,SACiC;CACjC,MAAM,SAAS,QAAQ,OAAO,QAAQ,KAAK,CAAC;CAM5C,MAAM,YAAY,cAAc,YAAY,OAAO;AAEnD,KAAI,UACF,QAAO;EACL,MAAM,UAAU;EAChB,cAAc,UAAU;EACxB,WAAW,UAAU;EACrB,QAAQ;EACR,YAAY;EACb;CAUH,MAAM,eAAe,iBAAiB,YAAY,OAAO;AACzD,KAAI,aACF,QAAO;AAOT,KAAI,WAAW,QAAQ,MAAM,CAAC,SAAS,GAAG;EAExC,MAAM,EAAE,qBAAqB,MAAM,OAAO;EAC1C,MAAM,cAAc,MAAM,iBAAiB,YAAY,YAAY;GACjE;GACA,WAAW;GACZ,CAAC;AAEF,MAAI,YAAY,oBAAoB,YAAY,aAAa,GAAG;GAE9D,MAAM,aAAa,WAChB,QACC,6FACD,CACA,IAAI,YAAY,iBAAiB;AAIpC,OAAI,WACF,QAAO;IACL,MAAM,WAAW;IACjB,cAAc,WAAW;IACzB,WAAW,WAAW;IACtB,QAAQ;IACR,YAAY,YAAY;IACzB;;;AAKP,QAAO;;;;;;;;AAaT,SAAS,iBACP,YACA,UACwB;CACxB,IAAI,UAAU;CACd,IAAI,QAAQ;AAEZ,QAAO,QAAQ,IAAI;AAGjB,MAAI,WAFe,GAAG,QAAQ,eAEJ,EAAE;GAC1B,MAAM,SAAS,cAAc,QAAQ;AAErC,OAAI,UAAU,OAAO,WAAW,YAAY;IAE1C,MAAM,aAAa,WAChB,QACC,6FACD,CACA,IAAI,OAAO,KAAK;AAInB,QAAI,WACF,QAAO;KACL,MAAM,WAAW;KACjB,cAAc,WAAW;KACzB,WAAW,WAAW;KACtB,QAAQ;KACR,YAAY;KACb;;;EAKP,MAAM,SAAS,QAAQ,QAAQ;AAC/B,MAAI,WAAW,QAAS;AACxB,YAAU;AACV;;AAGF,QAAO;;;;;AAwBT,SAAgB,oBAAoB,QAAiC;AACnE,QAAO,KAAK,UAAU,QAAQ,MAAM,EAAE"}

package/dist/{kg-extraction-C8DEUHTS.mjs → checkpoint-block-Bl0HD3U2.mjs}

@@ -1,8 +1,8 @@
-import { _ as warn, c as ok, i as err, n as dim, r as encodeDir, s as now, t as bold } from "./utils-CqqgB0dH.mjs";
-import { a as slugify, i as parseSessionFilename, n as decodeEncodedDir, t as buildEncodedDirMap } from "./migrate-B02wDDgS.mjs";
-import { n as ensurePaiMarker, t as discoverPaiMarkers } from "./pai-marker-HVBwwBW-.mjs";
-import { i as kgAdd, o as kgInvalidate, r as upsertKgEntity, s as kgQuery } from "./kg-entity-LXblD7LZ.mjs";
-import { existsSync, mkdirSync, readFileSync, readdirSync, realpathSync, statSync, writeFileSync } from "node:fs";
+import { _ as warn, c as ok, i as err, n as dim, r as encodeDir, s as now, t as bold } from "./utils-BAxjW3j8.mjs";
+import { a as slugify, i as parseSessionFilename, n as decodeEncodedDir, t as buildEncodedDirMap } from "./migrate-fLD6rAdO.mjs";
+import { n as ensurePaiMarker, t as discoverPaiMarkers } from "./pai-marker-B20KqhA8.mjs";
+import { i as kgAdd, o as kgInvalidate, r as upsertKgEntity, s as kgQuery } from "./kg-entity-DbOMPdF9.mjs";
+import { existsSync, mkdirSync, readFileSync, readdirSync, realpathSync, renameSync, statSync, writeFileSync } from "node:fs";
 import { homedir } from "node:os";
 import { basename, join, resolve } from "node:path";
 
@@ -119,6 +119,23 @@ function saveScanConfig(config) {
 	mkdirSync(PAI_CONFIG_DIR, { recursive: true });
 	writeFileSync(PAI_CONFIG_FILE, JSON.stringify(config, null, 2) + "\n", "utf8");
 }
+/**
+* Resolve a path to its canonical form, falling back to the input.
+*
+* Every path that becomes a `projects.root_path` must go through this. That
+* column is UNIQUE, so two spellings of one directory create two projects and
+* split session history between them. The spellings are not hypothetical: a
+* configured scan_dir of `~/dev/ai` (where `~/dev` is a symlink) makes every
+* project under it register under the symlinked path, while a session started
+* from the resolved path registers a rival row.
+*/
+function canonicalPath(p) {
+	try {
+		return realpathSync(p);
+	} catch {
+		return p;
+	}
+}
 function resolveHome(p) {
 	if (p.startsWith("~/")) return join(homedir(), p.slice(2));
 	return resolve(p);
@@ -166,6 +183,7 @@ function performScan(db) {
 			result.projectsScanned++;
 			continue;
 		}
+		rootPath = canonicalPath(rootPath);
 		const slug = slugify(basename(rootPath) || encodedDir);
 		const { id, isNew } = upsertProject(db, slug, rootPath, encodedDir);
 		result.projectsScanned++;
@@ -223,7 +241,7 @@ function performScan(db) {
 			}
 		});
 		for (const child of children) {
-			const childPath = join(scanDir, child);
+			const childPath = canonicalPath(join(scanDir, child));
 			const childSlug = slugify(child);
 			const childEncoded = encodeDir(childPath);
 			const existing = db.prepare("SELECT id FROM projects WHERE root_path = ?").get(childPath);
@@ -269,15 +287,16 @@ function performScan(db) {
 		for (const marker of markers) {
 			const registeredRow = db.prepare("SELECT id, root_path, slug FROM projects WHERE slug = ?").get(marker.slug);
 			if (!registeredRow) continue;
-			if (registeredRow.root_path !== marker.projectRoot) {
-				const newEncoded = encodeDir(marker.projectRoot);
+			const markerRoot = canonicalPath(marker.projectRoot);
+			if (registeredRow.root_path !== markerRoot) {
+				const newEncoded = encodeDir(markerRoot);
 				const now4 = Date.now();
 				const encodedOwner = db.prepare("SELECT id FROM projects WHERE encoded_dir = ?").get(newEncoded);
-				const pathOwner = db.prepare("SELECT id FROM projects WHERE root_path = ?").get(marker.projectRoot);
+				const pathOwner = db.prepare("SELECT id FROM projects WHERE root_path = ?").get(markerRoot);
 				const encodedSafe = !encodedOwner || encodedOwner.id === registeredRow.id;
 				const pathSafe = !pathOwner || pathOwner.id === registeredRow.id;
-				if (encodedSafe && pathSafe) db.prepare("UPDATE projects SET root_path = ?, encoded_dir = ?, updated_at = ? WHERE id = ?").run(marker.projectRoot, newEncoded, now4, registeredRow.id);
-				else if (pathSafe) db.prepare("UPDATE projects SET root_path = ?, updated_at = ? WHERE id = ?").run(marker.projectRoot, now4, registeredRow.id);
+				if (encodedSafe && pathSafe) db.prepare("UPDATE projects SET root_path = ?, encoded_dir = ?, updated_at = ? WHERE id = ?").run(markerRoot, newEncoded, now4, registeredRow.id);
+				else if (pathSafe) db.prepare("UPDATE projects SET root_path = ?, updated_at = ? WHERE id = ?").run(markerRoot, now4, registeredRow.id);
 			}
 		}
 	}
@@ -565,5 +584,415 @@ async function extractAndStoreTriples(pool, params) {
 }
 
 //#endregion
-export { resolveHome as a, upsertSession as c, performScan as i, cmdScan as n, saveScanConfig as o, loadScanConfig as r, upsertProject as s, extractAndStoreTriples as t };
-//# sourceMappingURL=kg-extraction-C8DEUHTS.mjs.map
+//#region src/session/checkpoint-block.ts
+/**
+* Shared "## Continue" checkpoint logic for a project's TODO.md.
+*
+* WHY THIS MODULE EXISTS
+* ----------------------
+* Before this, `pause.ts` and `handover.ts` each carried their own copy of
+* findProjectTodo / stripContinueSection / block-builder. Both wrote the same
+* fixed four-line block, and both stripped any existing ## Continue section
+* unconditionally. The consequence was that a rich, model-authored checkpoint
+* could never survive:
+*
+*   1. `pai pause` had no way to accept a body, so the model printed its
+*      checkpoint to the terminal and it was lost.
+*   2. Even if a body had been written by hand, the session-stop hook runs
+*      `pai session handover` on every clean exit, which regenerated the
+*      generic block and erased it.
+*
+* So there are two jobs here:
+*
+*   - AUTHORED writes (`pai pause --body-file`) carry the model's markdown
+*     verbatim, wrapped in explicit start/end markers.
+*   - AUTO writes (hooks) must never destroy an authored checkpoint belonging
+*     to the *same* session. They may replace a stale one left by an earlier
+*     session, otherwise TODO.md would show a checkpoint that no longer
+*     describes where the work stands.
+*
+* PARSING
+* -------
+* A rich body can legitimately contain `---` rules and `##` headings, which the
+* old heuristic scanner treated as section terminators. Authored blocks are
+* therefore delimited by an explicit HTML-comment pair; the legacy heuristic is
+* kept only as a fallback for blocks written before this change.
+*/
+/** Locations searched for a project TODO.md, in priority order. */
+const TODO_LOCATIONS = [
+	"Notes/TODO.md",
+	".claude/Notes/TODO.md",
+	"tasks/todo.md",
+	"TODO.md"
+];
+const MARKER_OPEN = "<!-- pai:checkpoint";
+const MARKER_CLOSE = "<!-- /pai:checkpoint -->";
+const CONTINUE_HEADING = "## Continue";
+function findProjectTodo(rootPath) {
+	for (const rel of TODO_LOCATIONS) {
+		const full = join(rootPath, rel);
+		if (existsSync(full)) try {
+			return {
+				path: full,
+				content: readFileSync(full, "utf8")
+			};
+		} catch {}
+	}
+	return null;
+}
+/**
+* Resolve the TODO.md to write to, creating Notes/ if nothing exists yet.
+* Returns null only when the directory could not be created.
+*/
+function resolveTodoTarget(rootPath, opts = {}) {
+	const found = findProjectTodo(rootPath);
+	if (found) return found;
+	const notesDir = join(rootPath, "Notes");
+	if (opts.create !== false) try {
+		if (!existsSync(notesDir)) mkdirSync(notesDir, { recursive: true });
+	} catch {
+		return null;
+	}
+	return {
+		path: join(notesDir, "TODO.md"),
+		content: ""
+	};
+}
+/**
+* Parse a `<!-- pai:checkpoint key="value" ... -->` marker line.
+* Returns null when the line is not a marker.
+*/
+function parseMarker(line) {
+	const trimmed = line.trim();
+	if (!trimmed.startsWith(MARKER_OPEN)) return null;
+	const attrs = {};
+	for (const m of trimmed.matchAll(/([a-zA-Z][\w-]*)="([^"]*)"/g)) attrs[m[1]] = m[2];
+	return {
+		authored: attrs.authored === "model" ? "model" : "auto",
+		session: attrs.session || void 0,
+		sessionId: attrs["session-id"] || void 0,
+		ts: attrs.ts || void 0
+	};
+}
+/**
+* Lines an auto-generated block is made of. Anything else in a section is
+* content somebody put there deliberately.
+*/
+const BOILERPLATE_PATTERNS = [
+	/^##\s+Continue$/,
+	/^<!--\s*\/?pai:checkpoint/,
+	/^>\s*\*\*Last session:\*\*/,
+	/^>\s*\*\*Paused at:\*\*/,
+	/^>\s*Working directory:/,
+	/^>\s*Resume with:/,
+	/^>\s*_No checkpoint body was recorded/,
+	/^>?\s*$/,
+	/^-{3,}$/
+];
+/**
+* True when a section contains nothing but generated header lines.
+*
+* This is the guard that stops an auto write from destroying content it did
+* not author. A session that hit the old clobbering bug may have worked around
+* it by hand — writing its state into a subsection underneath the generated
+* header lines, in an unmarked block. Those blocks predate the marker, so
+* authorship cannot be read off them; the only safe signal is whether anything
+* beyond boilerplate is present.
+*/
+function isBoilerplateOnly(lines) {
+	return lines.every((line) => {
+		const t = line.trim();
+		return BOILERPLATE_PATTERNS.some((re) => re.test(t));
+	});
+}
+/** Extract the non-boilerplate content of a section, or "" if there is none. */
+function extractSectionContent(lines) {
+	const kept = [];
+	for (const line of lines) {
+		const t = line.trim();
+		if (BOILERPLATE_PATTERNS.some((re) => re.test(t))) continue;
+		kept.push(line);
+	}
+	return kept.join("\n").trim();
+}
+/**
+* Locate the existing ## Continue section.
+*
+* When the section carries an explicit marker pair, the close marker defines
+* the end — this is what lets a rich body contain `---` and `##` safely.
+* Otherwise the legacy heuristic applies: stop at the first `---` or the next
+* `##` heading.
+*/
+function locateContinue(content) {
+	const lines = content.split("\n");
+	const startIdx = lines.findIndex((l) => l.trim() === CONTINUE_HEADING);
+	if (startIdx === -1) return null;
+	let meta = null;
+	let markerIdx = -1;
+	for (let i = startIdx + 1; i < Math.min(startIdx + 6, lines.length); i++) {
+		const parsed = parseMarker(lines[i]);
+		if (parsed) {
+			meta = parsed;
+			markerIdx = i;
+			break;
+		}
+		if (lines[i].trim() !== "") break;
+	}
+	let endIdx = lines.length;
+	if (markerIdx !== -1) {
+		const closeIdx = lines.findIndex((l, i) => i > markerIdx && l.trim() === MARKER_CLOSE);
+		if (closeIdx !== -1) endIdx = closeIdx + 1;
+		else endIdx = heuristicEnd(lines, startIdx);
+	} else endIdx = heuristicEnd(lines, startIdx);
+	let trailingEnd = endIdx;
+	while (trailingEnd < lines.length && lines[trailingEnd].trim() === "") trailingEnd += 1;
+	if (trailingEnd < lines.length && lines[trailingEnd].trim() === "---") trailingEnd += 1;
+	else trailingEnd = endIdx;
+	return {
+		startIdx,
+		endIdx: trailingEnd,
+		meta,
+		lines: lines.slice(startIdx, trailingEnd)
+	};
+}
+/**
+* Legacy scanner for blocks written before checkpoint markers existed.
+*
+* Terminates on a horizontal rule or the next level-2 heading. Note the
+* `(?!#)` — `###` is a *subsection* of `## Continue`, not a terminator. The
+* original scanner stopped at any run of `#`, which meant a `### Restored
+* state` subsection fell outside the section entirely and could not be seen,
+* let alone carried forward.
+*/
+function heuristicEnd(lines, startIdx) {
+	for (let i = startIdx + 1; i < lines.length; i++) {
+		const trimmed = lines[i].trim();
+		if (trimmed === "---" || /^##(?!#)/.test(trimmed) && trimmed !== CONTINUE_HEADING) return i;
+	}
+	return lines.length;
+}
+/** Remove the ## Continue section, returning the remainder of the document. */
+function stripContinue(content) {
+	const found = locateContinue(content);
+	if (!found) return content;
+	const lines = content.split("\n");
+	const before = lines.slice(0, found.startIdx);
+	const after = lines.slice(found.endIdx);
+	while (after.length > 0 && after[0].trim() === "") after.shift();
+	return [...before, ...after].join("\n");
+}
+function escapeAttr(value) {
+	return value.replace(/"/g, "'");
+}
+function buildContinueBlock(opts) {
+	const ts = opts.timestamp ?? (/* @__PURE__ */ new Date()).toISOString();
+	const attrs = [
+		`authored="${opts.authored}"`,
+		`session="${escapeAttr(opts.sessionLine)}"`,
+		opts.sessionId ? `session-id="${escapeAttr(opts.sessionId)}"` : null,
+		`ts="${ts}"`
+	].filter(Boolean).join(" ");
+	const header = [
+		`> **Last session:** ${opts.sessionLine}`,
+		`> **Paused at:** ${ts}`,
+		">",
+		`> Working directory: ${opts.cwd}`
+	];
+	if (opts.sessionId) header.push(">", `> Resume with: \`claude --resume ${opts.sessionId}\``);
+	const body = (opts.body ?? "").trim();
+	const parts = [
+		CONTINUE_HEADING,
+		"",
+		`${MARKER_OPEN} ${attrs} -->`,
+		"",
+		...header
+	];
+	if (body) parts.push("", body);
+	else parts.push(">", "> _No checkpoint body was recorded — see the latest session note._");
+	parts.push("", MARKER_CLOSE, "", "---", "");
+	return parts.join("\n");
+}
+/**
+* Write the ## Continue block, honouring the preservation rules.
+*
+* An AUTO write is unattended — it fires from the session-stop and pre-compact
+* hooks — so it operates under one governing rule: **never destroy content it
+* did not author.** Three cases follow from that:
+*
+*   1. An authored checkpoint for the SAME session is left untouched. The hooks
+*      fire after the model has already recorded the real state; overwriting it
+*      with metadata is the bug this module exists to fix.
+*   2. An authored checkpoint from an EARLIER session is stale — TODO.md would
+*      otherwise keep pointing at the wrong session — so it is replaced. Its
+*      content is not lost: `pai pause` mirrors every authored body into the
+*      session note.
+*   3. An UNMARKED block predates the marker, so authorship cannot be read off
+*      it. If it is nothing but generated header lines it is replaced. If it
+*      carries anything else, that content was put there deliberately — quite
+*      possibly as a hand-rolled workaround for the very clobbering this fixes —
+*      and is carried forward into the new block rather than dropped.
+*
+* A MODEL write always replaces: the model is authoring the checkpoint, and a
+* newer one supersedes an older one.
+*/
+function applyContinue(opts) {
+	const target = resolveTodoTarget(opts.rootPath, { create: !opts.dryRun });
+	if (!target) return {
+		action: "failed",
+		path: null,
+		block: buildContinueBlock(opts),
+		error: "Could not resolve or create a TODO.md target"
+	};
+	const existing = locateContinue(target.content);
+	let carriedForward = false;
+	let effectiveBody = opts.body;
+	if (opts.authored === "auto" && existing) {
+		if (existing.meta?.authored === "model" && existing.meta.session === opts.sessionLine) return {
+			action: "preserved",
+			path: target.path,
+			block: buildContinueBlock(opts),
+			preservedMeta: existing.meta
+		};
+		if (!existing.meta && !isBoilerplateOnly(existing.lines)) {
+			const salvaged = extractSectionContent(existing.lines);
+			if (salvaged) {
+				effectiveBody = [
+					"_Carried forward from the previous checkpoint (author unknown — this",
+					"block predates checkpoint authorship markers):_",
+					"",
+					salvaged
+				].join("\n");
+				carriedForward = true;
+			}
+		}
+	}
+	const block = buildContinueBlock({
+		...opts,
+		body: effectiveBody
+	});
+	if (opts.dryRun) return {
+		action: "written",
+		path: target.path,
+		block,
+		carriedForward
+	};
+	const newContent = block + stripContinue(target.content).trimStart();
+	const tmpPath = `${target.path}.continue.tmp`;
+	try {
+		writeFileSync(tmpPath, newContent, "utf8");
+		renameSync(tmpPath, target.path);
+	} catch (err) {
+		try {
+			if (existsSync(tmpPath)) renameSync(tmpPath, `${tmpPath}.dead`);
+		} catch {}
+		return {
+			action: "failed",
+			path: target.path,
+			block,
+			error: String(err)
+		};
+	}
+	return {
+		action: "written",
+		path: target.path,
+		block,
+		carriedForward
+	};
+}
+/** PAI_DIR — mirrors pai-paths.ts resolution. */
+function getPaiDir() {
+	const envDir = process.env.PAI_DIR;
+	if (envDir) try {
+		return realpathSync(envDir);
+	} catch {
+		return envDir;
+	}
+	return join(homedir(), ".claude");
+}
+/**
+* Find the notes directory for a project — local first, then the central
+* ~/.claude/projects/<encoded>/Notes fallback. Never creates.
+*/
+function findNotesDir(rootPath, encodedDir) {
+	for (const rel of [
+		"Notes",
+		"notes",
+		".claude/Notes"
+	]) {
+		const p = join(rootPath, rel);
+		if (existsSync(p)) return p;
+	}
+	const central = join(getPaiDir(), "projects", encodedDir, "Notes");
+	if (existsSync(central)) return central;
+	return null;
+}
+/**
+* Find the current (highest-numbered) session note: current month, then the
+* previous month, then a flat notesDir as legacy fallback.
+*/
+function findLatestNote(notesDir) {
+	const findIn = (dir) => {
+		if (!existsSync(dir)) return null;
+		let files;
+		try {
+			files = readdirSync(dir);
+		} catch {
+			return null;
+		}
+		const notes = files.filter((f) => /^\d{3,4}[\s_-].*\.md$/.test(f)).sort((a, b) => {
+			return parseInt(a.match(/^(\d+)/)?.[1] ?? "0", 10) - parseInt(b.match(/^(\d+)/)?.[1] ?? "0", 10);
+		});
+		return notes.length > 0 ? join(dir, notes[notes.length - 1]) : null;
+	};
+	const now = /* @__PURE__ */ new Date();
+	const current = findIn(join(notesDir, String(now.getFullYear()), String(now.getMonth() + 1).padStart(2, "0")));
+	if (current) return current;
+	const prev = new Date(now.getFullYear(), now.getMonth() - 1, 1);
+	const prevFound = findIn(join(notesDir, String(prev.getFullYear()), String(prev.getMonth() + 1).padStart(2, "0")));
+	if (prevFound) return prevFound;
+	return findIn(notesDir);
+}
+/**
+* Append the checkpoint body to a session note.
+*
+* TODO.md's ## Continue is a single slot that every later checkpoint
+* overwrites. The session note is the durable record, so the body goes to both.
+* Idempotent per timestamp: re-running with the same stamp will not duplicate.
+*/
+function appendCheckpointToNote(notePath, body, timestamp) {
+	const heading = `## Pause Checkpoint — ${timestamp ?? (/* @__PURE__ */ new Date()).toISOString()}`;
+	let existing;
+	try {
+		existing = readFileSync(notePath, "utf8");
+	} catch (err) {
+		return {
+			appended: false,
+			error: String(err)
+		};
+	}
+	if (existing.includes(heading)) return { appended: false };
+	const block = `\n\n---\n\n${heading}\n\n${body.trim()}\n`;
+	const tmpPath = `${notePath}.checkpoint.tmp`;
+	try {
+		writeFileSync(tmpPath, existing.trimEnd() + block, "utf8");
+		renameSync(tmpPath, notePath);
+	} catch (err) {
+		try {
+			if (existsSync(tmpPath)) renameSync(tmpPath, `${tmpPath}.dead`);
+		} catch {}
+		return {
+			appended: false,
+			error: String(err)
+		};
+	}
+	return { appended: true };
+}
+/** Read a checkpoint body from a file, or from stdin when path is "-". */
+function readBodyFile(path) {
+	if (path === "-") return readFileSync(0, "utf8");
+	return readFileSync(path, "utf8");
+}
+
+//#endregion
+export { readBodyFile as a, loadScanConfig as c, saveScanConfig as d, upsertProject as f, findNotesDir as i, performScan as l, applyContinue as n, extractAndStoreTriples as o, upsertSession as p, findLatestNote as r, cmdScan as s, appendCheckpointToNote as t, resolveHome as u };
+//# sourceMappingURL=checkpoint-block-Bl0HD3U2.mjs.map