@tekmidian/pai 0.9.0 → 0.9.1

package/dist/{auto-route-C-DrW6BL.mjs → auto-route-CruBrTf-.mjs}

@@ -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-jGBuYQJM.mjs").then((n) => n.n);
+		const { detectTopicShift } = await import("./detector-CNU3zCwP.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-C-DrW6BL.mjs.map
+//# sourceMappingURL=auto-route-CruBrTf-.mjs.map

package/dist/{auto-route-C-DrW6BL.mjs.map → auto-route-CruBrTf-.mjs.map}

@@ -1 +1 @@
-{"version":3,"file":"auto-route-C-DrW6BL.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-CruBrTf-.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/cli/index.mjs

@@ -10,10 +10,11 @@ import "../embeddings-DGRAPAYb.mjs";
 import { t as STOP_WORDS } from "../stop-words-BaMEGVeY.mjs";
 import { n as populateSlugs, r as searchMemory } from "../search-DC1qhkKn.mjs";
 import { n as formatDetection, r as formatDetectionJson, t as detectProject } from "../detect-CdaA48EI.mjs";
-import "../indexer-D53l5d1U.mjs";
+import { t as extractAndStoreTriples } from "../kg-extraction-BlGM40q7.mjs";
 import { t as PaiClient } from "../ipc-client-CoyUHPod.mjs";
 import { a as expandHome, i as ensureConfigDir, n as CONFIG_FILE$2, o as loadConfig, t as CONFIG_DIR } from "../config-BuhHWyOK.mjs";
-import { t as createStorageBackend } from "../factory-e0k1HWuc.mjs";
+import { t as createStorageBackend } from "../factory-DKDPRhAN.mjs";
+import { i as kgQuery } from "../kg-B5ysyRLC.mjs";
 import { appendFileSync, chmodSync, copyFileSync, existsSync, lstatSync, mkdirSync, readFileSync, readdirSync, readlinkSync, renameSync, statSync, symlinkSync, unlinkSync, writeFileSync } from "node:fs";
 import { homedir, platform, tmpdir } from "node:os";
 import { basename, dirname, join, relative, resolve } from "node:path";
@@ -256,7 +257,7 @@ function cmdAdd(db, rawPath, opts) {
 	console.log(dim(`  Encoded dir:  ${encodedDir}`));
 	console.log(dim(`  Type:         ${type}`));
 }
-function cmdList$2(db, opts) {
+function cmdList$3(db, opts) {
 	let query = `
     SELECT p.*,
       (SELECT COUNT(*) FROM sessions s WHERE s.project_id = p.id) AS session_count,
@@ -1099,7 +1100,7 @@ function registerProjectCommands(projectCmd, getDb) {
 		cmdAdd(getDb(), rawPath, opts);
 	});
 	projectCmd.command("list").description("List registered projects").option("--status <status>", "Filter by status: active | archived").option("--tag <tag>", "Filter by tag").option("--type <type>", "Filter by type").action((opts) => {
-		cmdList$2(getDb(), opts);
+		cmdList$3(getDb(), opts);
 	});
 	projectCmd.command("info <slug>").description("Show full details for a project").action((slug) => {
 		cmdInfo$1(getDb(), slug);
@@ -1350,7 +1351,7 @@ function getSessionTags(db, sessionId) {
 
 //#endregion
 //#region src/cli/commands/session/commands.ts
-function cmdList$1(db, projectSlug, opts) {
+function cmdList$2(db, projectSlug, opts) {
 	const limit = parseInt(opts.limit ?? "20", 10);
 	const params = [];
 	let query = `
@@ -1681,9 +1682,9 @@ function cmdActive(db, opts) {
 	], rows));
 }
 async function cmdAutoRoute(opts) {
-	const { autoRoute, formatAutoRoute, formatAutoRouteJson } = await import("../auto-route-C-DrW6BL.mjs");
+	const { autoRoute, formatAutoRoute, formatAutoRouteJson } = await import("../auto-route-CruBrTf-.mjs");
 	const { openRegistry } = await import("../db-BtuN768f.mjs").then((n) => n.t);
-	const { createStorageBackend } = await import("../factory-e0k1HWuc.mjs").then((n) => n.n);
+	const { createStorageBackend } = await import("../factory-DKDPRhAN.mjs").then((n) => n.n);
 	const { loadConfig } = await import("../config-BuhHWyOK.mjs").then((n) => n.r);
 	const config = loadConfig();
 	const registryDb = openRegistry();
@@ -1927,7 +1928,7 @@ function cmdHandover(db, projectSlug, numberOrLatest) {
 //#region src/cli/commands/session/index.ts
 function registerSessionCommands(sessionCmd, getDb) {
 	sessionCmd.command("list [project-slug]").description("List sessions, optionally filtered to a single project").option("--limit <n>", "Maximum number of sessions to show", "20").option("--status <status>", "Filter by status: open | completed | compacted").action((projectSlug, opts) => {
-		cmdList$1(getDb(), projectSlug, opts);
+		cmdList$2(getDb(), projectSlug, opts);
 	});
 	sessionCmd.command("info <project-slug> <number>").description("Show full details for a specific session").action((projectSlug, number) => {
 		cmdInfo(getDb(), projectSlug, number);
@@ -2302,7 +2303,7 @@ async function countVectorDbPaths(oldPaths) {
 	if (oldPaths.length === 0) return 0;
 	try {
 		const { loadConfig } = await import("../config-BuhHWyOK.mjs").then((n) => n.r);
-		const { PostgresBackend } = await import("../postgres-DvEPooLO.mjs");
+		const { PostgresBackend } = await import("../postgres-BGERehmX.mjs");
 		const config = loadConfig();
 		if (config.storageBackend !== "postgres") return 0;
 		const pgBackend = new PostgresBackend(config.postgres ?? {});
@@ -2323,7 +2324,7 @@ async function updateVectorDbPaths(moves) {
 	if (moves.length === 0) return 0;
 	try {
 		const { loadConfig } = await import("../config-BuhHWyOK.mjs").then((n) => n.r);
-		const { PostgresBackend } = await import("../postgres-DvEPooLO.mjs");
+		const { PostgresBackend } = await import("../postgres-BGERehmX.mjs");
 		const config = loadConfig();
 		if (config.storageBackend !== "postgres") return 0;
 		const pgBackend = new PostgresBackend(config.postgres ?? {});
@@ -2971,7 +2972,7 @@ function cmdMigrate$1(db) {
 
 //#endregion
 //#region src/cli/commands/registry/index.ts
-function cmdStats$1(db) {
+function cmdStats$2(db) {
 	const totalProjects = db.prepare("SELECT COUNT(*) AS n FROM projects").get().n;
 	const activeProjects = db.prepare("SELECT COUNT(*) AS n FROM projects WHERE status = 'active'").get().n;
 	const archivedProjects = db.prepare("SELECT COUNT(*) AS n FROM projects WHERE status = 'archived'").get().n;
@@ -3058,7 +3059,7 @@ function registerRegistryCommands(registryCmd, getDb) {
 		cmdMigrate$1(getDb());
 	});
 	registryCmd.command("stats").description("Show summary statistics for the registry").action(() => {
-		cmdStats$1(getDb());
+		cmdStats$2(getDb());
 	});
 	registryCmd.command("rebuild").description("Erase all registry data and rebuild from the filesystem (destructive)").action(() => {
 		cmdRebuild(getDb());
@@ -3793,7 +3794,7 @@ function cmdLogs(opts) {
 }
 function registerDaemonCommands(daemonCmd) {
 	daemonCmd.command("serve").description("Start the PAI daemon in the foreground").action(async () => {
-		const { serve } = await import("../daemon-VIFoKc_z.mjs").then((n) => n.t);
+		const { serve } = await import("../daemon-kp49BE7u.mjs").then((n) => n.t);
 		const { loadConfig: lc, ensureConfigDir } = await import("../config-BuhHWyOK.mjs").then((n) => n.r);
 		ensureConfigDir();
 		await serve(lc());
@@ -6411,7 +6412,7 @@ async function cmdExplore(note, opts) {
 	const depth = parseInt(opts.depth ?? "3", 10);
 	const direction = opts.direction ?? "both";
 	const mode = opts.mode ?? "all";
-	const { zettelExplore } = await import("../zettelkasten-DhBKZQHF.mjs");
+	const { zettelExplore } = await import("../zettelkasten-BdaMzTGQ.mjs");
 	const result = zettelExplore(getFedDb(), {
 		startNote: note,
 		depth,
@@ -6475,7 +6476,7 @@ async function cmdHealth(opts) {
 	const projectPath = opts.project;
 	const recentDays = parseInt(opts.days ?? "30", 10);
 	const includeTypes = opts.include ? opts.include.split(",").map((s) => s.trim()) : void 0;
-	const { zettelHealth } = await import("../zettelkasten-DhBKZQHF.mjs");
+	const { zettelHealth } = await import("../zettelkasten-BdaMzTGQ.mjs");
 	const result = zettelHealth(getFedDb(), {
 		scope,
 		projectPath,
@@ -6544,7 +6545,7 @@ async function cmdSurprise(note, opts) {
 	const limit = parseInt(opts.limit ?? "10", 10);
 	const minSimilarity = parseFloat(opts.minSimilarity ?? "0.3");
 	const minGraphDistance = parseInt(opts.minDistance ?? "3", 10);
-	const { zettelSurprise } = await import("../zettelkasten-DhBKZQHF.mjs");
+	const { zettelSurprise } = await import("../zettelkasten-BdaMzTGQ.mjs");
 	const db = getFedDb();
 	console.log();
 	console.log(header("  PAI Zettel Surprise"));
@@ -6597,7 +6598,7 @@ async function cmdSuggest(note, opts) {
 	const vaultProjectId = parseInt(opts.vaultProjectId, 10);
 	const limit = parseInt(opts.limit ?? "5", 10);
 	const excludeLinked = opts.excludeLinked !== false;
-	const { zettelSuggest } = await import("../zettelkasten-DhBKZQHF.mjs");
+	const { zettelSuggest } = await import("../zettelkasten-BdaMzTGQ.mjs");
 	const db = getFedDb();
 	console.log();
 	console.log(header("  PAI Zettel Suggest"));
@@ -6648,7 +6649,7 @@ async function cmdConverse(question, opts) {
 	const vaultProjectId = parseInt(opts.vaultProjectId, 10);
 	const depth = parseInt(opts.depth ?? "2", 10);
 	const limit = parseInt(opts.limit ?? "15", 10);
-	const { zettelConverse } = await import("../zettelkasten-DhBKZQHF.mjs");
+	const { zettelConverse } = await import("../zettelkasten-BdaMzTGQ.mjs");
 	const db = getFedDb();
 	console.log();
 	console.log(header("  PAI Zettel Converse"));
@@ -6709,7 +6710,7 @@ async function cmdThemes(opts) {
 	const minClusterSize = parseInt(opts.minSize ?? "3", 10);
 	const maxThemes = parseInt(opts.maxThemes ?? "10", 10);
 	const similarityThreshold = parseFloat(opts.threshold ?? "0.65");
-	const { zettelThemes } = await import("../zettelkasten-DhBKZQHF.mjs");
+	const { zettelThemes } = await import("../zettelkasten-BdaMzTGQ.mjs");
 	const db = getFedDb();
 	console.log();
 	console.log(header("  PAI Zettel Themes"));
@@ -6838,7 +6839,7 @@ function trunc(s, maxLen) {
 	if (s.length <= maxLen) return s;
 	return s.slice(0, maxLen - 1) + "…";
 }
-async function cmdList(opts) {
+async function cmdList$1(opts) {
 	const limit = parseInt(opts.limit ?? "20", 10);
 	const params = { limit };
 	if (opts.project) params.project_slug = opts.project;
@@ -6935,7 +6936,7 @@ async function cmdSearch(query, opts) {
 	console.log(dim(`  ${observations.length} result(s)`));
 	console.log();
 }
-async function cmdStats() {
+async function cmdStats$1() {
 	let stats;
 	try {
 		stats = await ipcCall("observation_stats", {});
@@ -6984,7 +6985,7 @@ async function cmdStats() {
 function registerObservationCommands(parent) {
 	parent.command("list").description("List recent observations").option("--project <slug>", "Filter by project slug").option("--type <type>", "Filter by type (decision, bugfix, feature, refactor, discovery, change)").option("--session <id>", "Filter by session ID").option("--limit <n>", "Maximum results", "20").action(async (opts) => {
 		try {
-			await cmdList(opts);
+			await cmdList$1(opts);
 		} catch (e) {
 			console.error(err(`  Error: ${e}`));
 			process.exit(1);
@@ -7000,7 +7001,7 @@ function registerObservationCommands(parent) {
 	});
 	parent.command("stats").description("Show observation statistics: totals, by type, by project").action(async () => {
 		try {
-			await cmdStats();
+			await cmdStats$1();
 		} catch (e) {
 			console.error(err(`  Error: ${e}`));
 			process.exit(1);
@@ -7569,6 +7570,326 @@ function registerTopicCommands(topicCmd) {
 	});
 }
 
+//#endregion
+//#region src/memory/kg-backfill.ts
+/**
+* kg-backfill.ts — Populate the temporal knowledge graph from existing
+* session notes.
+*
+* Walks `Notes/YYYY/MM/*.md` for each registered project, runs the same
+* extractor that the session-summary-worker uses on every NEW summary, and
+* stores triples in Postgres. Idempotent: a state file at
+* ~/.config/pai/kg-backfill-state.json records which note paths have been
+* processed so re-runs skip them.
+*
+* Even without the state file the operation is safe — extractAndStoreTriples
+* uses supersession logic so re-extracting a note never produces duplicates.
+*/
+const STATE_FILE = join(homedir(), ".config", "pai", "kg-backfill-state.json");
+function loadState() {
+	try {
+		if (existsSync(STATE_FILE)) {
+			const raw = JSON.parse(readFileSync(STATE_FILE, "utf-8"));
+			if (raw && typeof raw === "object" && raw.processed) return raw;
+		}
+	} catch {}
+	return { processed: {} };
+}
+function saveState(state) {
+	try {
+		const dir = join(homedir(), ".config", "pai");
+		if (!existsSync(dir)) mkdirSync(dir, { recursive: true });
+		writeFileSync(STATE_FILE, JSON.stringify(state, null, 2), "utf-8");
+	} catch (e) {
+		process.stderr.write(`[kg-backfill] failed to save state: ${e}\n`);
+	}
+}
+/**
+* Find all session notes under <project_root>/Notes/YYYY/MM/*.md.
+* Falls back to <project_root>/Notes/*.md (flat layout) when no year/month
+* subdirectories are present.
+*/
+function findProjectNotes(project) {
+	const notesRoot = join(project.root_path, "Notes");
+	if (!existsSync(notesRoot)) return [];
+	const found = [];
+	function walk(dir, depth) {
+		if (depth > 4) return;
+		let entries;
+		try {
+			entries = readdirSync(dir);
+		} catch {
+			return;
+		}
+		for (const name of entries) {
+			const full = join(dir, name);
+			let st;
+			try {
+				st = statSync(full);
+			} catch {
+				continue;
+			}
+			if (st.isDirectory()) walk(full, depth + 1);
+			else if (st.isFile() && name.endsWith(".md") && /^\d{3,4}/.test(name)) found.push({
+				path: full,
+				mtime: st.mtimeMs
+			});
+		}
+	}
+	walk(notesRoot, 0);
+	found.sort((a, b) => a.mtime - b.mtime);
+	return found.map((f) => f.path);
+}
+/**
+* Backfill the knowledge graph from existing session notes.
+*
+* Requires the Postgres backend (KG tables live there). Throws if Postgres
+* is unavailable, since this is an explicit user action.
+*/
+async function backfillKgFromNotes(options = {}) {
+	const result = {
+		notes_processed: 0,
+		triples_extracted: 0,
+		triples_added: 0,
+		triples_superseded: 0,
+		errors: 0
+	};
+	const config = loadConfig();
+	if (config.storageBackend !== "postgres") throw new Error("kg backfill requires the Postgres backend. Set \"storageBackend\": \"postgres\" in ~/.config/pai/config.json.");
+	const backend = await createStorageBackend(config);
+	if (backend.backendType !== "postgres") throw new Error("Postgres backend unavailable — fell back to SQLite. Cannot backfill KG.");
+	const pool = backend.getPool();
+	const registry = openRegistry();
+	let projects;
+	try {
+		if (options.projectSlug) {
+			const row = registry.prepare("SELECT id, slug, root_path FROM projects WHERE slug = ?").get(options.projectSlug);
+			if (!row) throw new Error(`Project not found: ${options.projectSlug}`);
+			projects = [row];
+		} else projects = registry.prepare("SELECT id, slug, root_path FROM projects WHERE status = 'active' ORDER BY slug").all();
+	} finally {
+		registry.close();
+	}
+	const state = loadState();
+	const work = [];
+	for (const project of projects) {
+		const notes = findProjectNotes(project);
+		for (const notePath of notes) {
+			if (state.processed[notePath]) continue;
+			work.push({
+				project,
+				notePath
+			});
+		}
+	}
+	const total = options.limit ? Math.min(options.limit, work.length) : work.length;
+	for (let i = 0; i < total; i++) {
+		const { project, notePath } = work[i];
+		options.onProgress?.(i + 1, total, notePath);
+		if (options.dryRun) {
+			result.notes_processed++;
+			continue;
+		}
+		let noteContent;
+		try {
+			noteContent = readFileSync(notePath, "utf-8");
+		} catch (e) {
+			process.stderr.write(`[kg-backfill] read failed ${notePath}: ${e}\n`);
+			result.errors++;
+			continue;
+		}
+		try {
+			const stats = await extractAndStoreTriples(pool, {
+				summaryText: noteContent,
+				projectSlug: project.slug,
+				projectId: project.id,
+				sessionId: `backfill:${notePath}`,
+				gitLog: "",
+				model: "sonnet"
+			});
+			result.notes_processed++;
+			result.triples_extracted += stats.extracted;
+			result.triples_added += stats.added;
+			result.triples_superseded += stats.superseded;
+			state.processed[notePath] = (/* @__PURE__ */ new Date()).toISOString();
+			if ((i + 1) % 5 === 0) saveState(state);
+		} catch (e) {
+			process.stderr.write(`[kg-backfill] extract failed ${notePath}: ${e}\n`);
+			result.errors++;
+		}
+	}
+	if (!options.dryRun) saveState(state);
+	await backend.close();
+	return result;
+}
+
+//#endregion
+//#region src/cli/commands/kg.ts
+async function getPool() {
+	const config = loadConfig();
+	if (config.storageBackend !== "postgres") {
+		console.error(err("  KG commands require Postgres backend."));
+		console.error(dim("  Set \"storageBackend\": \"postgres\" in ~/.config/pai/config.json"));
+		process.exit(1);
+	}
+	const backend = await createStorageBackend(config);
+	if (backend.backendType !== "postgres") {
+		console.error(err("  Postgres backend unavailable — fell back to SQLite."));
+		process.exit(1);
+	}
+	return {
+		pool: backend.getPool(),
+		close: () => backend.close()
+	};
+}
+function shorten(s, n) {
+	return s.length <= n ? s : s.slice(0, n - 1) + "…";
+}
+async function cmdBackfill(opts) {
+	const limit = opts.limit ? parseInt(opts.limit, 10) : void 0;
+	if (limit !== void 0 && (isNaN(limit) || limit < 1)) {
+		console.error(err("  --limit must be a positive integer"));
+		process.exit(1);
+	}
+	console.log();
+	console.log(header("  PAI KG Backfill"));
+	console.log();
+	if (opts.project) console.log(`  ${bold("Project:")} ${opts.project}`);
+	if (limit) console.log(`  ${bold("Limit:")}   ${limit}`);
+	if (opts.dryRun) console.log(`  ${bold("Mode:")}    ${warn("dry-run")}`);
+	console.log();
+	try {
+		const result = await backfillKgFromNotes({
+			projectSlug: opts.project,
+			limit,
+			dryRun: opts.dryRun,
+			onProgress: (current, total, note) => {
+				const short = shorten(note.replace(process.env.HOME ?? "", "~"), 70);
+				process.stdout.write(`  [${current}/${total}] ${dim(short)}\n`);
+			}
+		});
+		console.log();
+		console.log(ok("  Backfill complete"));
+		console.log(`    Notes processed:    ${bold(String(result.notes_processed))}`);
+		console.log(`    Triples extracted:  ${bold(String(result.triples_extracted))}`);
+		console.log(`    Triples added:      ${bold(String(result.triples_added))}`);
+		console.log(`    Triples superseded: ${bold(String(result.triples_superseded))}`);
+		if (result.errors > 0) console.log(`    ${warn("Errors:")}             ${result.errors}`);
+		console.log();
+	} catch (e) {
+		const msg = e instanceof Error ? e.message : String(e);
+		console.error(err(`  ${msg}`));
+		process.exit(1);
+	}
+}
+async function cmdQuery(opts) {
+	const { pool, close } = await getPool();
+	try {
+		let projectId;
+		if (opts.project) {
+			const r = await pool.query("SELECT id FROM projects WHERE slug = $1 LIMIT 1", [opts.project]);
+			if (r.rows.length === 0) console.error(warn(`  Project not found in Postgres: ${opts.project}`));
+			else projectId = r.rows[0].id;
+		}
+		const asOf = opts.asOf ? new Date(opts.asOf) : void 0;
+		if (asOf && isNaN(asOf.getTime())) {
+			console.error(err(`  Invalid --as-of date: ${opts.asOf}`));
+			process.exit(1);
+		}
+		const triples = await kgQuery(pool, {
+			subject: opts.subject,
+			predicate: opts.predicate,
+			object: opts.object,
+			project_id: projectId,
+			as_of: asOf
+		});
+		if (opts.json) {
+			console.log(JSON.stringify(triples, null, 2));
+			return;
+		}
+		console.log();
+		console.log(header(`  ${triples.length} triple(s)`));
+		console.log();
+		for (const t of triples) {
+			const validity = t.valid_to ? dim(`(invalidated ${t.valid_to.toISOString().slice(0, 10)})`) : dim(`(valid since ${t.valid_from.toISOString().slice(0, 10)})`);
+			console.log(`  ${bold(t.subject)} ${dim("·")} ${t.predicate} ${dim("·")} ${t.object}  ${validity}`);
+		}
+		console.log();
+	} finally {
+		await close();
+	}
+}
+async function cmdList(opts) {
+	const limit = opts.limit ? parseInt(opts.limit, 10) : 50;
+	const { pool, close } = await getPool();
+	try {
+		let projectId;
+		if (opts.project) {
+			const r = await pool.query("SELECT id FROM projects WHERE slug = $1 LIMIT 1", [opts.project]);
+			if (r.rows.length > 0) projectId = r.rows[0].id;
+		}
+		const triples = await kgQuery(pool, { project_id: projectId });
+		const slice = triples.slice(0, limit);
+		console.log();
+		console.log(header(`  ${slice.length} of ${triples.length} currently-valid triple(s)`));
+		console.log();
+		for (const t of slice) console.log(`  ${bold(t.subject)} ${dim("·")} ${t.predicate} ${dim("·")} ${t.object}`);
+		if (triples.length > slice.length) {
+			console.log();
+			console.log(dim(`  (${triples.length - slice.length} more — increase --limit)`));
+		}
+		console.log();
+	} finally {
+		await close();
+	}
+}
+async function cmdStats() {
+	const { pool, close } = await getPool();
+	try {
+		const totals = await pool.query(`SELECT
+         COUNT(*)::text                                            AS total,
+         COUNT(*) FILTER (WHERE valid_to IS NULL)::text            AS valid,
+         COUNT(*) FILTER (WHERE valid_to IS NOT NULL)::text        AS invalidated,
+         COUNT(DISTINCT subject)::text                             AS subjects,
+         COUNT(DISTINCT predicate)::text                           AS predicates
+       FROM kg_triples`);
+		const contradictions = await pool.query(`SELECT COUNT(*)::text AS count FROM (
+         SELECT subject, predicate
+         FROM kg_triples
+         WHERE valid_to IS NULL
+         GROUP BY subject, predicate
+         HAVING COUNT(*) > 1
+       ) c`);
+		const row = totals.rows[0] ?? {};
+		console.log();
+		console.log(header("  PAI KG Stats"));
+		console.log();
+		console.log(`  ${bold("Total triples:")}        ${row.total ?? "0"}`);
+		console.log(`  ${bold("Currently valid:")}      ${row.valid ?? "0"}`);
+		console.log(`  ${bold("Invalidated:")}          ${row.invalidated ?? "0"}`);
+		console.log(`  ${bold("Distinct subjects:")}    ${row.subjects ?? "0"}`);
+		console.log(`  ${bold("Distinct predicates:")}  ${row.predicates ?? "0"}`);
+		console.log(`  ${bold("Contradictions:")}       ${contradictions.rows[0]?.count ?? "0"}`);
+		console.log();
+	} finally {
+		await close();
+	}
+}
+function registerKgCommands(kgCmd) {
+	kgCmd.command("backfill").description("Populate the KG from existing session notes (idempotent)").option("--project <slug>", "Restrict backfill to a single project").option("--limit <n>", "Maximum number of notes to process").option("--dry-run", "List notes that would be processed without extracting").action(async (opts) => {
+		await cmdBackfill(opts);
+	});
+	kgCmd.command("query").description("Query KG triples by subject, predicate, object, time, or project").option("--subject <s>", "Filter by subject").option("--predicate <p>", "Filter by predicate").option("--object <o>", "Filter by object").option("--as-of <date>", "Point-in-time query (YYYY-MM-DD or ISO 8601)").option("--project <slug>", "Restrict to a project slug").option("--json", "Output raw JSON").action(async (opts) => {
+		await cmdQuery(opts);
+	});
+	kgCmd.command("list").description("List currently-valid triples").option("--project <slug>", "Restrict to a project slug").option("--limit <n>", "Maximum triples to print", "50").action(async (opts) => {
+		await cmdList(opts);
+	});
+	kgCmd.command("stats").description("Show triple counts and contradiction count").action(async () => {
+		await cmdStats();
+	});
+}
+
 //#endregion
 //#region src/cli/index.ts
 /**
@@ -7617,6 +7938,7 @@ registerSetupCommand(program);
 registerUpdateCommand(program);
 registerNotifyCommands(program.command("notify").description("Notification config: status, get, set, test, send"));
 registerTopicCommands(program.command("topic").description("Topic shift detection: check whether context has drifted to a different project"));
+registerKgCommands(program.command("kg").description("Temporal knowledge graph: backfill, query, list, stats"));
 registerObsidianCommands(program.command("obsidian").description("Obsidian vault: sync project notes, view status, open in Obsidian"), getDb);
 registerZettelCommands(program.command("zettel").description("Zettelkasten intelligence: explore, surprise, converse, themes, health, suggest"), getDb);
 registerObservationCommands(program.command("observation").description("Observation capture: list, search, and stats"));