zam-core 0.3.11 → 0.3.12

package/dist/index.js

@@ -1932,11 +1932,11 @@ function analyzeObservation(commands, tokenPatterns) {
   const ratings = [];
   for (const tp of tokenPatterns) {
     const matchIndices = [];
-    const matchedTexts = [];
+    const matchedTexts2 = [];
     for (let i = 0; i < commands.length; i++) {
       if (matchesToken(commands[i].command, tp.patterns)) {
         matchIndices.push(i);
-        matchedTexts.push(commands[i].command);
+        matchedTexts2.push(commands[i].command);
         matchedSet.add(i);
       }
     }
@@ -2026,7 +2026,7 @@ function analyzeObservation(commands, tokenPatterns) {
         medianGapMs,
         thinkingGapMs
       },
-      matchedCommandTexts: matchedTexts
+      matchedCommandTexts: matchedTexts2
     });
   }
   const unmatchedCommands = [];
@@ -2391,6 +2391,240 @@ async function unblockReady(db, userId) {
   return { unblocked };
 }
 
+// src/kernel/observation/ui-observer-io.ts
+import { appendFileSync as appendFileSync2, existsSync as existsSync5, mkdirSync as mkdirSync4, readFileSync as readFileSync5 } from "fs";
+import { homedir as homedir4 } from "os";
+import { join as join5 } from "path";
+
+// src/kernel/observation/ui-observer.ts
+var UI_OBSERVATION_PROTOCOL_VERSION = 1;
+var OBSERVATION_KINDS = /* @__PURE__ */ new Set([
+  "progress",
+  "step-completed",
+  "error",
+  "help-seeking",
+  "uncertain",
+  "privacy-pause",
+  "heartbeat"
+]);
+var ACTION_TYPES = /* @__PURE__ */ new Set([
+  "click",
+  "shortcut",
+  "typing",
+  "scroll",
+  "window-change"
+]);
+var EVIDENCE_TYPES = /* @__PURE__ */ new Set([
+  "uia",
+  "keyframe",
+  "clip",
+  "window"
+]);
+function isUiObservationReport(value) {
+  if (!isRecord(value)) return false;
+  if (value.version !== UI_OBSERVATION_PROTOCOL_VERSION) return false;
+  if (!isNonEmptyString(value.sessionId)) return false;
+  if (!isNonNegativeInteger(value.sequence)) return false;
+  if (!isNonEmptyString(value.observedFrom)) return false;
+  if (!isNonEmptyString(value.observedTo)) return false;
+  if (typeof value.kind !== "string" || !OBSERVATION_KINDS.has(value.kind)) {
+    return false;
+  }
+  if (!isApplication(value.application)) return false;
+  if (!isNonEmptyString(value.summary)) return false;
+  if (!Array.isArray(value.actions) || !value.actions.every(isObservedAction)) {
+    return false;
+  }
+  if (!Array.isArray(value.evidence) || !value.evidence.every(isEvidenceRef)) {
+    return false;
+  }
+  if (!Array.isArray(value.candidateTokens) || !value.candidateTokens.every(isCandidateToken)) {
+    return false;
+  }
+  return isConfidence(value.confidence);
+}
+function parseUiObservationLog(jsonl) {
+  const reports = [];
+  for (const line of jsonl.split("\n")) {
+    const trimmed = line.trim();
+    if (!trimmed) continue;
+    try {
+      const value = JSON.parse(trimmed);
+      if (isUiObservationReport(value)) {
+        reports.push(value);
+      }
+    } catch {
+    }
+  }
+  return reports.sort((left, right) => left.sequence - right.sequence);
+}
+function isApplication(value) {
+  if (!isRecord(value) || !isNonEmptyString(value.processName)) return false;
+  if (value.processId !== void 0 && !isNonNegativeInteger(value.processId)) {
+    return false;
+  }
+  return value.windowTitle === void 0 || typeof value.windowTitle === "string";
+}
+function isObservedAction(value) {
+  if (!isRecord(value) || typeof value.type !== "string") return false;
+  if (!ACTION_TYPES.has(value.type)) return false;
+  if (value.target !== void 0 && typeof value.target !== "string") {
+    return false;
+  }
+  return value.result === void 0 || typeof value.result === "string";
+}
+function isEvidenceRef(value) {
+  if (!isRecord(value) || typeof value.type !== "string") return false;
+  return EVIDENCE_TYPES.has(value.type) && isNonEmptyString(value.ref) && typeof value.redacted === "boolean";
+}
+function isCandidateToken(value) {
+  return isRecord(value) && isNonEmptyString(value.slug) && isConfidence(value.confidence) && isNonEmptyString(value.rationale);
+}
+function isRecord(value) {
+  return typeof value === "object" && value !== null && !Array.isArray(value);
+}
+function isNonEmptyString(value) {
+  return typeof value === "string" && value.trim().length > 0;
+}
+function isNonNegativeInteger(value) {
+  return Number.isInteger(value) && Number(value) >= 0;
+}
+function isConfidence(value) {
+  return typeof value === "number" && value >= 0 && value <= 1;
+}
+
+// src/kernel/observation/ui-observer-io.ts
+var DEFAULT_UI_OBSERVER_DIR = join5(homedir4(), ".zam", "observer");
+function getUiObserverDir() {
+  return process.env.ZAM_OBSERVER_DIR || DEFAULT_UI_OBSERVER_DIR;
+}
+function getUiObservationPath(sessionId) {
+  if (!/^[A-Za-z0-9_-]+$/.test(sessionId)) {
+    throw new Error(`Invalid observer session ID: ${sessionId}`);
+  }
+  return join5(getUiObserverDir(), `${sessionId}.reports.jsonl`);
+}
+function ensureUiObserverDir() {
+  const dir = getUiObserverDir();
+  if (!existsSync5(dir)) {
+    mkdirSync4(dir, { recursive: true, mode: 448 });
+  }
+}
+function uiObservationLogExists(sessionId) {
+  return existsSync5(getUiObservationPath(sessionId));
+}
+function readUiObservationLog(sessionId) {
+  const path = getUiObservationPath(sessionId);
+  if (!existsSync5(path)) return [];
+  return parseUiObservationLog(readFileSync5(path, "utf8"));
+}
+function appendUiObservationReport(report) {
+  if (!isUiObservationReport(report)) {
+    throw new Error("Invalid UI observation report");
+  }
+  ensureUiObserverDir();
+  appendFileSync2(
+    getUiObservationPath(report.sessionId),
+    `${JSON.stringify(report)}
+`,
+    { encoding: "utf8", mode: 384 }
+  );
+}
+
+// src/kernel/observation/ui-observer-synthesis.ts
+var MIN_UI_CONFIDENCE = 0.6;
+function kindToRating(kind) {
+  switch (kind) {
+    case "step-completed":
+      return 4;
+    case "progress":
+      return 3;
+    case "error":
+    case "help-seeking":
+      return 2;
+    default:
+      return null;
+  }
+}
+function toSynthesisConfidence(confidence) {
+  return confidence >= 0.85 ? "high" : "medium";
+}
+function confidenceRank(confidence) {
+  return confidence === "high" ? 2 : 1;
+}
+function buildEvidence(report) {
+  return {
+    matchedCommands: report.actions.length,
+    helpSeeking: report.kind === "help-seeking",
+    errorCount: report.kind === "error" ? 1 : 0,
+    selfCorrections: 0,
+    medianGapMs: null,
+    thinkingGapMs: null
+  };
+}
+function matchedTexts(report) {
+  const texts = [report.summary];
+  for (const action of report.actions) {
+    const label = [action.type, action.target, action.result].filter(Boolean).join(" ");
+    if (label) texts.push(label);
+  }
+  return texts;
+}
+function buildUiSynthesisCandidates(reports, tokens, applied, minConfidence) {
+  const minRank = confidenceRank(minConfidence);
+  const bestBySlug = /* @__PURE__ */ new Map();
+  let skippedLowConfidence = 0;
+  for (const report of reports) {
+    if (report.confidence < MIN_UI_CONFIDENCE) continue;
+    const fallbackRating = kindToRating(report.kind);
+    const candidates2 = report.candidateTokens.length > 0 ? report.candidateTokens.map((candidate) => ({
+      slug: candidate.slug,
+      confidence: candidate.confidence,
+      rating: fallbackRating
+    })) : [];
+    for (const candidate of candidates2) {
+      const token = tokens.get(candidate.slug);
+      if (!token || applied.has(token.id)) continue;
+      const synthesisConfidence = toSynthesisConfidence(candidate.confidence);
+      if (confidenceRank(synthesisConfidence) < minRank) {
+        skippedLowConfidence++;
+        continue;
+      }
+      const inferredRating = candidate.rating ?? 3;
+      const existing = bestBySlug.get(candidate.slug);
+      if (existing && existing.reportConfidence >= candidate.confidence) {
+        continue;
+      }
+      bestBySlug.set(candidate.slug, {
+        token,
+        inferredRating,
+        confidence: synthesisConfidence,
+        evidence: buildEvidence(report),
+        matchedCommandTexts: matchedTexts(report),
+        reportConfidence: candidate.confidence
+      });
+    }
+  }
+  const candidates = [...bestBySlug.values()].sort((left, right) => right.reportConfidence - left.reportConfidence).map((entry) => ({
+    tokenId: entry.token.id,
+    tokenSlug: entry.token.slug,
+    concept: entry.token.concept,
+    domain: entry.token.domain,
+    inferredRating: entry.inferredRating,
+    confidence: entry.confidence,
+    evidence: entry.evidence,
+    matchedCommandTexts: entry.matchedCommandTexts
+  }));
+  return { candidates, skippedLowConfidence };
+}
+function uiObservationTimeSpan(reports) {
+  if (reports.length === 0) return null;
+  const start = reports[0].observedFrom;
+  const end = reports[reports.length - 1].observedTo;
+  const durationMs = Math.max(0, Date.parse(end) - Date.parse(start));
+  return { start, end, durationMs };
+}
+
 // src/kernel/observation/session-synthesis.ts
 function parseSynthesisRow(row) {
   return {
@@ -2398,7 +2632,7 @@ function parseSynthesisRow(row) {
     evidence: JSON.parse(row.evidence)
   };
 }
-function confidenceRank(confidence) {
+function confidenceRank2(confidence) {
   return confidence === "high" ? 2 : confidence === "medium" ? 1 : 0;
 }
 function normalizeSkillStep(step) {
@@ -2460,20 +2694,50 @@ async function prepareSessionSynthesis(db, input) {
     validPatterns.push(pattern);
     tokens.set(pattern.slug, token);
   }
-  const commands = input.commands ?? pairCommands(readMonitorLog(input.sessionId));
-  const analysis = analyzeObservation(commands, validPatterns);
   const applied = new Set(
     (await getSessionSynthesisRecords(db, input.sessionId)).map(
       (record) => record.token_id
     )
   );
-  const minRank = confidenceRank(input.minConfidence ?? "medium");
+  const minConfidence = input.minConfidence ?? "medium";
+  if (session.execution_context === "ui") {
+    const reports = readUiObservationLog(input.sessionId);
+    for (const report of reports) {
+      for (const candidate of report.candidateTokens) {
+        if (tokens.has(candidate.slug)) continue;
+        const token = await getTokenBySlug(db, candidate.slug);
+        if (token && !token.deprecated_at) {
+          tokens.set(candidate.slug, token);
+        }
+      }
+    }
+    const { candidates: candidates2, skippedLowConfidence: skippedLowConfidence2 } = buildUiSynthesisCandidates(
+      reports,
+      tokens,
+      applied,
+      minConfidence
+    );
+    return {
+      sessionId: session.id,
+      userId: session.user_id,
+      patternCount: validPatterns.length,
+      commandCount: reports.length,
+      alreadyApplied: applied.size,
+      skippedLowConfidence: skippedLowConfidence2,
+      candidates: candidates2,
+      unmatchedCommands: [],
+      timeSpan: uiObservationTimeSpan(reports)
+    };
+  }
+  const commands = input.commands ?? pairCommands(readMonitorLog(input.sessionId));
+  const analysis = analyzeObservation(commands, validPatterns);
+  const minRank = confidenceRank2(minConfidence);
   let skippedLowConfidence = 0;
   const candidates = [];
   for (const rating of analysis.ratings) {
     const token = tokens.get(rating.tokenSlug);
     if (!token || rating.rating == null || applied.has(token.id)) continue;
-    if (confidenceRank(rating.confidence) < minRank) {
+    if (confidenceRank2(rating.confidence) < minRank) {
       skippedLowConfidence++;
       continue;
     }
@@ -3070,8 +3334,8 @@ function generatePrompt(input) {
 }
 
 // src/kernel/recall/reference-resolver.ts
-import { existsSync as existsSync5, readFileSync as readFileSync5 } from "fs";
-import { dirname as dirname3, join as join5, resolve } from "path";
+import { existsSync as existsSync6, readFileSync as readFileSync6 } from "fs";
+import { dirname as dirname3, join as join6, resolve } from "path";
 var DEFAULT_REVIEW_CONTEXT_MAX_CHARS = 6e3;
 function htmlToText(html) {
   let content = html;
@@ -3132,11 +3396,11 @@ async function resolveReference(sourceLink) {
       const filePath = anchorIndex2 !== -1 ? fullPathWithAnchor.slice(0, anchorIndex2) : fullPathWithAnchor;
       const anchor2 = anchorIndex2 !== -1 ? fullPathWithAnchor.slice(anchorIndex2) : "";
       const parentDir = dirname3(process.cwd());
-      const localRepoPath = join5(parentDir, repo);
-      const localFilePath = join5(localRepoPath, filePath);
-      if (existsSync5(localFilePath)) {
+      const localRepoPath = join6(parentDir, repo);
+      const localFilePath = join6(localRepoPath, filePath);
+      if (existsSync6(localFilePath)) {
         try {
-          let fileContent = readFileSync5(localFilePath, "utf-8");
+          let fileContent = readFileSync6(localFilePath, "utf-8");
           if (anchor2) {
             fileContent = extractLines(fileContent, anchor2);
           }
@@ -3190,9 +3454,9 @@ Link: ${cleaned}`,
   const relativePath = anchorIndex !== -1 ? cleaned.slice(0, anchorIndex) : cleaned;
   const anchor = anchorIndex !== -1 ? cleaned.slice(anchorIndex) : "";
   const absolutePath = resolve(process.cwd(), relativePath);
-  if (existsSync5(absolutePath)) {
+  if (existsSync6(absolutePath)) {
     try {
-      let fileContent = readFileSync5(absolutePath, "utf-8");
+      let fileContent = readFileSync6(absolutePath, "utf-8");
       if (anchor) {
         fileContent = extractLines(fileContent, anchor);
       }
@@ -3444,44 +3708,44 @@ function intersperseNew(reviews, newCards, interval) {
 
 // src/kernel/system/hooks.ts
 import {
-  appendFileSync as appendFileSync2,
+  appendFileSync as appendFileSync3,
   copyFileSync,
-  existsSync as existsSync6,
-  mkdirSync as mkdirSync4,
-  readFileSync as readFileSync6,
+  existsSync as existsSync7,
+  mkdirSync as mkdirSync5,
+  readFileSync as readFileSync7,
   writeFileSync as writeFileSync3
 } from "fs";
-import { homedir as homedir4 } from "os";
-import { join as join6 } from "path";
+import { homedir as homedir5 } from "os";
+import { join as join7 } from "path";
 import { fileURLToPath } from "url";
-var HOME = homedir4();
+var HOME = homedir5();
 function getPackageSkillPath(agent = "default") {
   const packageRoot = [
     fileURLToPath(new URL("../../..", import.meta.url)),
     fileURLToPath(new URL("../..", import.meta.url)),
     fileURLToPath(new URL("..", import.meta.url))
-  ].find((candidate) => existsSync6(join6(candidate, "package.json"))) ?? "";
+  ].find((candidate) => existsSync7(join7(candidate, "package.json"))) ?? "";
   if (!packageRoot) return "";
   if (agent === "codex") {
-    const codexPath = join6(packageRoot, ".agents", "skills", "zam", "SKILL.md");
-    if (existsSync6(codexPath)) return codexPath;
+    const codexPath = join7(packageRoot, ".agents", "skills", "zam", "SKILL.md");
+    if (existsSync7(codexPath)) return codexPath;
     return "";
   }
   if (agent === "claude") {
-    const claudePath = join6(
+    const claudePath = join7(
       packageRoot,
       ".claude",
       "skills",
       "zam",
       "SKILL.md"
     );
-    if (existsSync6(claudePath)) return claudePath;
+    if (existsSync7(claudePath)) return claudePath;
     return "";
   }
-  let path = join6(packageRoot, ".agent", "skills", "zam", "SKILL.md");
-  if (existsSync6(path)) return path;
-  path = join6(packageRoot, ".claude", "skills", "zam", "SKILL.md");
-  if (existsSync6(path)) return path;
+  let path = join7(packageRoot, ".agent", "skills", "zam", "SKILL.md");
+  if (existsSync7(path)) return path;
+  path = join7(packageRoot, ".claude", "skills", "zam", "SKILL.md");
+  if (existsSync7(path)) return path;
   return "";
 }
 function distributeGlobalSkills(home = HOME) {
@@ -3493,16 +3757,16 @@ function distributeGlobalSkills(home = HOME) {
     console.warn("Could not find ZAM source SKILL.md in the package folder.");
     return results;
   }
-  const claudeSkillsDir = join6(home, ".claude", "skills", "zam");
+  const claudeSkillsDir = join7(home, ".claude", "skills", "zam");
   try {
     if (!claudeSourceSkill) {
       throw new Error("Claude skill source not found");
     }
-    mkdirSync4(claudeSkillsDir, { recursive: true });
-    copyFileSync(claudeSourceSkill, join6(claudeSkillsDir, "SKILL.md"));
+    mkdirSync5(claudeSkillsDir, { recursive: true });
+    copyFileSync(claudeSourceSkill, join7(claudeSkillsDir, "SKILL.md"));
     results.push({
       name: "Claude Code Global",
-      path: join6(claudeSkillsDir, "SKILL.md"),
+      path: join7(claudeSkillsDir, "SKILL.md"),
       success: true
     });
   } catch (_err) {
@@ -3512,13 +3776,13 @@ function distributeGlobalSkills(home = HOME) {
       success: false
     });
   }
-  const geminiSkillsDir = join6(home, ".gemini", "skills", "zam");
+  const geminiSkillsDir = join7(home, ".gemini", "skills", "zam");
   try {
-    mkdirSync4(geminiSkillsDir, { recursive: true });
-    copyFileSync(sourceSkill, join6(geminiSkillsDir, "SKILL.md"));
+    mkdirSync5(geminiSkillsDir, { recursive: true });
+    copyFileSync(sourceSkill, join7(geminiSkillsDir, "SKILL.md"));
     results.push({
       name: "Gemini CLI Global",
-      path: join6(geminiSkillsDir, "SKILL.md"),
+      path: join7(geminiSkillsDir, "SKILL.md"),
       success: true
     });
   } catch (_err) {
@@ -3528,16 +3792,16 @@ function distributeGlobalSkills(home = HOME) {
       success: false
     });
   }
-  const codexSkillsDir = join6(home, ".agents", "skills", "zam");
+  const codexSkillsDir = join7(home, ".agents", "skills", "zam");
   try {
     if (!codexSourceSkill) {
       throw new Error("Codex skill source not found");
     }
-    mkdirSync4(codexSkillsDir, { recursive: true });
-    copyFileSync(codexSourceSkill, join6(codexSkillsDir, "SKILL.md"));
+    mkdirSync5(codexSkillsDir, { recursive: true });
+    copyFileSync(codexSourceSkill, join7(codexSkillsDir, "SKILL.md"));
     results.push({
       name: "Codex Global",
-      path: join6(codexSkillsDir, "SKILL.md"),
+      path: join7(codexSkillsDir, "SKILL.md"),
       success: true
     });
   } catch (_err) {
@@ -3547,13 +3811,13 @@ function distributeGlobalSkills(home = HOME) {
       success: false
     });
   }
-  const gooseSkillsDir = join6(home, ".goose", "skills", "zam");
+  const gooseSkillsDir = join7(home, ".goose", "skills", "zam");
   try {
-    mkdirSync4(gooseSkillsDir, { recursive: true });
-    copyFileSync(sourceSkill, join6(gooseSkillsDir, "SKILL.md"));
+    mkdirSync5(gooseSkillsDir, { recursive: true });
+    copyFileSync(sourceSkill, join7(gooseSkillsDir, "SKILL.md"));
     results.push({
       name: "Goose Global",
-      path: join6(gooseSkillsDir, "SKILL.md"),
+      path: join7(gooseSkillsDir, "SKILL.md"),
       success: true
     });
   } catch (_err) {
@@ -3597,14 +3861,14 @@ function Start-ZamMonitor {
 `;
 function installHook(file, hook, oldHook) {
   try {
-    const content = existsSync6(file) ? readFileSync6(file, "utf8") : "";
+    const content = existsSync7(file) ? readFileSync7(file, "utf8") : "";
     if (content.includes(HOOK_MARKER)) {
       return { success: true, alreadyHooked: true };
     }
     if (content.includes(oldHook.trim())) {
       writeFileSync3(file, content.replace(oldHook.trim(), hook.trim()), "utf8");
     } else {
-      appendFileSync2(file, hook);
+      appendFileSync3(file, hook);
     }
     return { success: true, alreadyHooked: false };
   } catch {
@@ -3613,24 +3877,24 @@ function installHook(file, hook, oldHook) {
 }
 function injectShellHooks(home = HOME) {
   const results = [];
-  const zshrc = join6(home, ".zshrc");
-  if (existsSync6(zshrc)) {
+  const zshrc = join7(home, ".zshrc");
+  if (existsSync7(zshrc)) {
     const status = installHook(zshrc, posixHook("zsh"), POSIX_OLD_HOOK);
     results.push({ shell: "zsh", file: zshrc, ...status });
   }
-  const bashrc = join6(home, ".bashrc");
-  if (existsSync6(bashrc)) {
+  const bashrc = join7(home, ".bashrc");
+  if (existsSync7(bashrc)) {
     const status = installHook(bashrc, posixHook("bash"), POSIX_OLD_HOOK);
     results.push({ shell: "bash", file: bashrc, ...status });
   }
   const pwshDirs = [
-    join6(home, "Documents", "PowerShell"),
-    join6(home, "Documents", "WindowsPowerShell")
+    join7(home, "Documents", "PowerShell"),
+    join7(home, "Documents", "WindowsPowerShell")
   ];
   for (const dir of pwshDirs) {
-    const profileFile = join6(dir, "Microsoft.PowerShell_profile.ps1");
+    const profileFile = join7(dir, "Microsoft.PowerShell_profile.ps1");
     try {
-      mkdirSync4(dir, { recursive: true });
+      mkdirSync5(dir, { recursive: true });
       const status = installHook(
         profileFile,
         POWERSHELL_HOOK,
@@ -3862,21 +4126,21 @@ function t(locale, key, params = {}) {
 }
 
 // src/kernel/system/install-config.ts
-import { existsSync as existsSync7, mkdirSync as mkdirSync5, readFileSync as readFileSync7, writeFileSync as writeFileSync4 } from "fs";
-import { homedir as homedir5 } from "os";
-import { dirname as dirname4, join as join7 } from "path";
-var DEFAULT_CONFIG_PATH = join7(homedir5(), ".zam", "config.json");
+import { existsSync as existsSync8, mkdirSync as mkdirSync6, readFileSync as readFileSync8, writeFileSync as writeFileSync4 } from "fs";
+import { homedir as homedir6 } from "os";
+import { dirname as dirname4, join as join8 } from "path";
+var DEFAULT_CONFIG_PATH = join8(homedir6(), ".zam", "config.json");
 function loadInstallConfig(path = DEFAULT_CONFIG_PATH) {
-  if (!existsSync7(path)) return {};
+  if (!existsSync8(path)) return {};
   try {
-    return JSON.parse(readFileSync7(path, "utf-8"));
+    return JSON.parse(readFileSync8(path, "utf-8"));
   } catch {
     return {};
   }
 }
 function saveInstallConfig(config, path = DEFAULT_CONFIG_PATH) {
   const dir = dirname4(path);
-  if (!existsSync7(dir)) mkdirSync5(dir, { recursive: true });
+  if (!existsSync8(dir)) mkdirSync6(dir, { recursive: true });
   writeFileSync4(path, `${JSON.stringify(config, null, 2)}
 `, "utf-8");
 }
@@ -3913,9 +4177,9 @@ function detectSyncProvider(dir) {
 
 // src/kernel/system/installer.ts
 import { execFileSync, execSync } from "child_process";
-import { existsSync as existsSync8 } from "fs";
-import { homedir as homedir6 } from "os";
-import { join as join8 } from "path";
+import { existsSync as existsSync9 } from "fs";
+import { homedir as homedir7 } from "os";
+import { join as join9 } from "path";
 function hasCommand(cmd) {
   try {
     const checkCmd = process.platform === "win32" ? `where ${cmd}` : `which ${cmd}`;
@@ -3932,7 +4196,7 @@ function installFastFlowLM() {
       message: "FastFlowLM is only supported on Windows."
     };
   }
-  const hasFlm = hasCommand("flm") || existsSync8("C:\\Program Files\\flm\\flm.exe");
+  const hasFlm = hasCommand("flm") || existsSync9("C:\\Program Files\\flm\\flm.exe");
   if (hasFlm) {
     return { success: true, message: "FastFlowLM is already installed." };
   }
@@ -3959,8 +4223,8 @@ function installFastFlowLM() {
 function installOllama() {
   const isMac = process.platform === "darwin";
   const isWin = process.platform === "win32";
-  const hasOllama = hasCommand("ollama") || isMac && existsSync8("/Applications/Ollama.app") || isWin && existsSync8(
-    join8(homedir6(), "AppData", "Local", "Programs", "Ollama", "ollama.exe")
+  const hasOllama = hasCommand("ollama") || isMac && existsSync9("/Applications/Ollama.app") || isWin && existsSync9(
+    join9(homedir7(), "AppData", "Local", "Programs", "Ollama", "ollama.exe")
   );
   if (hasOllama) {
     return { success: true, message: "Ollama is already installed." };
@@ -4020,8 +4284,8 @@ function installOllama() {
 function resolveOllamaCommand() {
   if (hasCommand("ollama")) return "ollama";
   const candidates = process.platform === "win32" ? [
-    join8(
-      homedir6(),
+    join9(
+      homedir7(),
       "AppData",
       "Local",
       "Programs",
@@ -4029,7 +4293,7 @@ function resolveOllamaCommand() {
       "ollama.exe"
     )
   ] : process.platform === "darwin" ? ["/Applications/Ollama.app/Contents/Resources/ollama"] : [];
-  return candidates.find((candidate) => existsSync8(candidate));
+  return candidates.find((candidate) => existsSync9(candidate));
 }
 function prepareLocalModel(runner, model) {
   if (runner === "fastflowlm") {
@@ -4217,7 +4481,7 @@ function getSystemProfile() {
 }
 
 // src/kernel/system/repos.ts
-import { existsSync as existsSync9 } from "fs";
+import { existsSync as existsSync10 } from "fs";
 import { resolve as resolve2 } from "path";
 async function getRepoPaths(db) {
   const personalSetting = await getSetting(db, "repo.personal") || await getSetting(db, "personal.workspace_dir");
@@ -4238,15 +4502,15 @@ async function resolveAllBeliefPaths(db) {
   const dirs = [];
   if (paths.personal) {
     const personalDir = resolve2(paths.personal, "beliefs");
-    if (existsSync9(personalDir)) dirs.push(personalDir);
+    if (existsSync10(personalDir)) dirs.push(personalDir);
   }
   if (paths.team) {
     const teamDir = resolve2(paths.team, "beliefs");
-    if (existsSync9(teamDir)) dirs.push(teamDir);
+    if (existsSync10(teamDir)) dirs.push(teamDir);
   }
   if (paths.org) {
     const orgDir = resolve2(paths.org, "beliefs");
-    if (existsSync9(orgDir)) dirs.push(orgDir);
+    if (existsSync10(orgDir)) dirs.push(orgDir);
   }
   return dirs;
 }
@@ -4255,15 +4519,15 @@ async function resolveAllGoalPaths(db) {
   const dirs = [];
   if (paths.personal) {
     const personalDir = resolve2(paths.personal, "goals");
-    if (existsSync9(personalDir)) dirs.push(personalDir);
+    if (existsSync10(personalDir)) dirs.push(personalDir);
   }
   if (paths.team) {
     const teamDir = resolve2(paths.team, "goals");
-    if (existsSync9(teamDir)) dirs.push(teamDir);
+    if (existsSync10(teamDir)) dirs.push(teamDir);
   }
   if (paths.org) {
     const orgDir = resolve2(paths.org, "goals");
-    if (existsSync9(orgDir)) dirs.push(orgDir);
+    if (existsSync10(orgDir)) dirs.push(orgDir);
   }
   return dirs;
 }
@@ -4356,11 +4620,14 @@ export {
   DEFAULT_REVIEW_CONTEXT_MAX_CHARS,
   HOMEBREW_CASK,
   SNAPSHOT_VERSION,
+  UI_OBSERVATION_PROTOCOL_VERSION,
   WINGET_PACKAGE_ID,
   addPrerequisite,
   analyzeObservation,
+  appendUiObservationReport,
   applySessionSynthesis,
   buildReviewQueue,
+  buildUiSynthesisCandidates,
   cascadeBlock,
   clearADOCredentials,
   clearTursoCredentials,
@@ -4381,6 +4648,7 @@ export {
   endSession,
   ensureCard,
   ensureMonitorDir,
+  ensureUiObserverDir,
   evaluateRating,
   executeReviewAction,
   exportSnapshot,
@@ -4429,6 +4697,8 @@ export {
   getTokenDeleteImpact,
   getTokenNeighborhood,
   getTursoCredentials,
+  getUiObservationPath,
+  getUiObserverDir,
   getUserStats,
   hasCommand,
   importSnapshot,
@@ -4437,6 +4707,7 @@ export {
   installOllama,
   installOpenCode,
   interleave,
+  isUiObservationReport,
   listAgentSkills,
   listGoals,
   listTokens,
@@ -4456,10 +4727,12 @@ export {
   parseGoalFile,
   parseMonitorLog,
   parseSnapshot,
+  parseUiObservationLog,
   planOpenCodeInstall,
   prepareLocalModel,
   prepareSessionSynthesis,
   readMonitorLog,
+  readUiObservationLog,
   resolveAllBeliefPaths,
   resolveAllGoalPaths,
   resolveReference,
@@ -4475,6 +4748,8 @@ export {
   setTursoCredentials,
   startSession,
   t,
+  uiObservationLogExists,
+  uiObservationTimeSpan,
   unblockReady,
   updateCard,
   updateGoalStatus,