@geminilight/mindos 0.5.63 → 0.5.64

package/app/components/panels/AgentsPanel.tsx

@@ -1,7 +1,6 @@
 'use client';
 
-import { useState, useRef, useCallback } from 'react';
-import { useRouter } from 'next/navigation';
+import { useState } from 'react';
 import { Loader2, RefreshCw, ChevronDown, ChevronRight, Settings } from 'lucide-react';
 import { useMcpData } from '@/hooks/useMcpData';
 import { useLocale } from '@/lib/LocaleContext';
@@ -28,26 +27,18 @@ export default function AgentsPanel({
   onOpenAgentDetail,
 }: AgentsPanelProps) {
   const { t } = useLocale();
-  const router = useRouter();
   const p = t.panels.agents;
   const mcp = useMcpData();
   const [refreshing, setRefreshing] = useState(false);
   const [showNotDetected, setShowNotDetected] = useState(false);
   const [showBuiltinSkills, setShowBuiltinSkills] = useState(false);
 
-  const overviewRef = useRef<HTMLDivElement>(null);
-  const skillsRef = useRef<HTMLDivElement>(null);
-
   const handleRefresh = async () => {
     setRefreshing(true);
     await mcp.refresh();
     setRefreshing(false);
   };
 
-  const scrollTo = useCallback((el: HTMLElement | null) => {
-    el?.scrollIntoView({ behavior: 'smooth', block: 'start' });
-  }, []);
-
   const openAdvancedConfig = () => {
     window.dispatchEvent(new CustomEvent('mindos:open-settings', { detail: { tab: 'mcp' } }));
   };
@@ -59,10 +50,18 @@ export default function AgentsPanel({
   const customSkills = mcp.skills.filter(s => s.source === 'user');
   const builtinSkills = mcp.skills.filter(s => s.source === 'builtin');
   const activeSkillCount = mcp.skills.filter(s => s.enabled).length;
+  const installAgentWithRefresh = async (key: string) => {
+    const ok = await mcp.installAgent(key);
+    if (ok) await mcp.refresh();
+    return ok;
+  };
 
   const listCopy = {
     installing: p.installing,
     install: p.install,
+    installSuccess: p.installSuccess,
+    installFailed: p.installFailed,
+    retryInstall: p.retryInstall,
   };
 
   const hubCopy = {
@@ -75,10 +74,6 @@ export default function AgentsPanel({
     <AgentsPanelHubNav
       copy={hubCopy}
       connectedCount={connected.length}
-      overviewRef={overviewRef}
-      skillsRef={skillsRef}
-      scrollTo={scrollTo}
-      openAdvancedConfig={openAdvancedConfig}
     />
   );
 
@@ -91,15 +86,6 @@ export default function AgentsPanel({
               {connected.length} {p.connected}
             </span>
           )}
-          <button
-            onClick={() => router.push('/agents')}
-            className="px-2 py-1 rounded border border-border text-2xs text-muted-foreground hover:text-foreground hover:bg-muted transition-colors focus-visible:outline-none focus-visible:ring-2 focus-visible:ring-ring"
-            aria-label={p.openDashboard}
-            title={p.openDashboard}
-            type="button"
-          >
-            {p.openDashboard}
-          </button>
           <button
             onClick={handleRefresh}
             disabled={refreshing}
@@ -122,7 +108,7 @@ export default function AgentsPanel({
           <div className="flex flex-col gap-2 py-4 px-0">
             {hub}
             <div className="mx-4 border-t border-border" />
-            <div ref={overviewRef} className="mx-3 rounded-lg border border-border bg-card/50 px-3 py-2.5 flex items-center justify-between scroll-mt-2">
+            <div className="mx-3 rounded-lg border border-border bg-card/50 px-3 py-2.5 flex items-center justify-between">
               <span className="text-xs font-medium text-foreground">{p.mcpServer}</span>
               {mcp.status?.running ? (
                 <span className="flex items-center gap-1.5 text-[11px]">
@@ -137,7 +123,7 @@ export default function AgentsPanel({
                 </span>
               )}
             </div>
-            <div ref={skillsRef} className="mx-3 scroll-mt-2 rounded-lg border border-dashed border-border px-3 py-3 text-center">
+            <div className="mx-3 rounded-lg border border-dashed border-border px-3 py-3 text-center">
               <p className="text-xs text-muted-foreground mb-2">{p.noAgents}</p>
               <p className="text-2xs text-muted-foreground mb-3">{p.skillsEmptyHint}</p>
               <button
@@ -156,7 +142,7 @@ export default function AgentsPanel({
             <div className="mx-4 border-t border-border" />
 
             <div className="px-3 py-3 space-y-4">
-              <div ref={overviewRef} className="rounded-lg border border-border bg-card/50 px-3 py-2.5 flex items-center justify-between scroll-mt-2">
+              <div className="rounded-lg border border-border bg-card/50 px-3 py-2.5 flex items-center justify-between">
                 <span className="text-xs font-medium text-foreground">{p.mcpServer}</span>
                 {mcp.status?.running ? (
                   <span className="flex items-center gap-1.5 text-[11px]">
@@ -178,8 +164,8 @@ export default function AgentsPanel({
                 notFound={notFound}
                 onOpenDetail={onOpenAgentDetail}
                 selectedAgentKey={selectedAgentKey}
-                mcp={mcp}
                 listCopy={listCopy}
+                onInstallAgent={installAgentWithRefresh}
                 showNotDetected={showNotDetected}
                 setShowNotDetected={setShowNotDetected}
                 p={{
@@ -190,7 +176,7 @@ export default function AgentsPanel({
                 }}
               />
 
-              <section ref={skillsRef} className="scroll-mt-2">
+              <section>
                 {mcp.skills.length > 0 ? (
                   <>
                     <div className="flex items-center justify-between mb-2">

package/app/components/panels/AgentsPanelAgentDetail.tsx

@@ -12,7 +12,8 @@ export type { AgentsPanelAgentDetailStatus };
 export interface AgentsPanelAgentDetailCopy {
   connected: string;
   installing: string;
-  install: (name: string) => string;
+  install: string;
+  installFailed: string;
   copyConfig: string;
   copied: string;
   transportLocal: string;
@@ -61,7 +62,7 @@ export default function AgentsPanelAgentDetail({
     setResult(
       ok
         ? { type: 'success', text: `${agent.name} ${copy.connected}` }
-        : { type: 'error', text: 'Install failed' },
+        : { type: 'error', text: copy.installFailed },
     );
     setInstalling(false);
   };
@@ -117,10 +118,10 @@ export default function AgentsPanelAgentDetail({
               type="button"
               onClick={handleInstall}
               disabled={installing}
-              className="inline-flex items-center gap-1.5 px-3 py-2 text-xs rounded-lg font-medium text-[var(--amber-foreground)] disabled:opacity-50 bg-[var(--amber)] focus-visible:outline-none focus-visible:ring-2 focus-visible:ring-ring"
+              className="inline-flex items-center gap-1.5 px-3 py-2 text-xs rounded-lg font-medium text-white disabled:opacity-50 bg-[var(--amber)] hover:bg-[var(--amber)]/90 focus-visible:outline-none focus-visible:ring-2 focus-visible:ring-ring"
             >
               {installing ? <Loader2 size={14} className="animate-spin" /> : null}
-              {installing ? copy.installing : copy.install(agent.name)}
+              {installing ? copy.installing : copy.install}
             </button>
             {result && (
               <span

package/app/components/panels/AgentsPanelAgentGroups.tsx

@@ -2,7 +2,6 @@
 
 import { ChevronDown, ChevronRight } from 'lucide-react';
 import type { AgentInfo } from '../settings/types';
-import type { McpContextValue } from '@/hooks/useMcpData';
 import AgentsPanelAgentListRow, { type AgentsPanelAgentListRowCopy } from './AgentsPanelAgentListRow';
 
 type AgentsCopy = {
@@ -18,7 +17,7 @@ export function AgentsPanelAgentGroups({
   notFound,
   onOpenDetail,
   selectedAgentKey,
-  mcp,
+  onInstallAgent,
   listCopy,
   showNotDetected,
   setShowNotDetected,
@@ -29,7 +28,7 @@ export function AgentsPanelAgentGroups({
   notFound: AgentInfo[];
   onOpenDetail?: (key: string) => void;
   selectedAgentKey?: string | null;
-  mcp: Pick<McpContextValue, 'installAgent'>;
+  onInstallAgent: (key: string) => Promise<boolean>;
   listCopy: AgentsPanelAgentListRowCopy;
   showNotDetected: boolean;
   setShowNotDetected: (v: boolean | ((prev: boolean) => boolean)) => void;
@@ -55,7 +54,7 @@ export function AgentsPanelAgentGroups({
                 agentStatus="connected"
                 selected={selectedAgentKey === agent.key}
                 onOpenDetail={() => open(agent.key)}
-                onInstallAgent={mcp.installAgent}
+                onInstallAgent={onInstallAgent}
                 copy={listCopy}
               />
             ))}
@@ -76,7 +75,7 @@ export function AgentsPanelAgentGroups({
                 agentStatus="detected"
                 selected={selectedAgentKey === agent.key}
                 onOpenDetail={() => open(agent.key)}
-                onInstallAgent={mcp.installAgent}
+                onInstallAgent={onInstallAgent}
                 copy={listCopy}
               />
             ))}
@@ -103,7 +102,7 @@ export function AgentsPanelAgentGroups({
                   agentStatus="notFound"
                   selected={selectedAgentKey === agent.key}
                   onOpenDetail={() => open(agent.key)}
-                  onInstallAgent={mcp.installAgent}
+                  onInstallAgent={onInstallAgent}
                   copy={listCopy}
                 />
               ))}

package/app/components/panels/AgentsPanelAgentListRow.tsx

@@ -1,14 +1,17 @@
 'use client';
 
 import { useState } from 'react';
-import { ChevronRight, Loader2 } from 'lucide-react';
+import { Check, ChevronRight, Loader2, RotateCw } from 'lucide-react';
 import type { AgentInfo } from '../settings/types';
 
 export type AgentsPanelAgentListStatus = 'connected' | 'detected' | 'notFound';
 
 export interface AgentsPanelAgentListRowCopy {
   installing: string;
-  install: (name: string) => string;
+  install: string;
+  installSuccess: string;
+  installFailed: string;
+  retryInstall: string;
 }
 
 export default function AgentsPanelAgentListRow({
@@ -79,23 +82,45 @@ function AgentInstallButton({
   copy: AgentsPanelAgentListRowCopy;
 }) {
   const [installing, setInstalling] = useState(false);
+  const [installState, setInstallState] = useState<'idle' | 'success' | 'error'>('idle');
 
   const handleInstall = async (e: React.MouseEvent) => {
     e.stopPropagation();
+    if (installing) return;
     setInstalling(true);
-    await onInstallAgent(agentKey);
+    setInstallState('idle');
+    const ok = await onInstallAgent(agentKey);
     setInstalling(false);
+    setInstallState(ok ? 'success' : 'error');
   };
 
+  const isError = installState === 'error';
+  const isSuccess = installState === 'success';
+  const label = installing
+    ? copy.installing
+    : isSuccess
+      ? copy.installSuccess
+      : isError
+        ? copy.retryInstall
+        : copy.install;
+
   return (
     <button
       type="button"
       onClick={handleInstall}
       disabled={installing}
-      className="flex items-center gap-1 px-2 py-1.5 text-2xs rounded-lg font-medium text-[var(--amber-foreground)] disabled:opacity-50 transition-colors shrink-0 bg-[var(--amber)] focus-visible:outline-none focus-visible:ring-2 focus-visible:ring-ring"
+      className={`flex items-center gap-1 px-2 py-1.5 text-2xs rounded-lg font-medium text-white disabled:opacity-50 transition-colors shrink-0 focus-visible:outline-none focus-visible:ring-2 focus-visible:ring-ring ${
+        isError ? 'bg-error hover:bg-error/90' : isSuccess ? 'bg-success hover:bg-success/90' : 'bg-[var(--amber)] hover:bg-[var(--amber)]/90'
+      }`}
+      aria-label={`${agentName} ${label}`}
     >
       {installing ? <Loader2 size={10} className="animate-spin" /> : null}
-      {installing ? copy.installing : copy.install(agentName)}
+      {!installing && isSuccess ? <Check size={10} /> : null}
+      {!installing && isError ? <RotateCw size={10} /> : null}
+      {label}
+      <span className="sr-only" aria-live="polite">
+        {isError ? copy.installFailed : ''}
+      </span>
     </button>
   );
 }

package/app/components/panels/AgentsPanelHubNav.tsx

@@ -1,6 +1,6 @@
 'use client';
 
-import { type RefObject } from 'react';
+import { usePathname, useSearchParams } from 'next/navigation';
 import { LayoutDashboard, Server, Zap } from 'lucide-react';
 import { PanelNavRow } from './PanelNavRow';
 
@@ -13,35 +13,35 @@ type HubCopy = {
 export function AgentsPanelHubNav({
   copy,
   connectedCount,
-  overviewRef,
-  skillsRef,
-  scrollTo,
-  openAdvancedConfig,
 }: {
   copy: HubCopy;
   connectedCount: number;
-  overviewRef: RefObject<HTMLDivElement | null>;
-  skillsRef: RefObject<HTMLDivElement | null>;
-  scrollTo: (el: HTMLElement | null) => void;
-  openAdvancedConfig: () => void;
 }) {
+  const pathname = usePathname();
+  const searchParams = useSearchParams();
+  const tab = searchParams.get('tab');
+  const inAgentsRoute = pathname === '/agents';
+
   return (
     <div className="py-2">
       <PanelNavRow
         icon={<LayoutDashboard size={14} className="text-[var(--amber)]" />}
         title={copy.navOverview}
         badge={<span className="text-2xs tabular-nums text-muted-foreground">{connectedCount}</span>}
-        onClick={() => scrollTo(overviewRef.current)}
+        href="/agents"
+        active={inAgentsRoute && (tab === null || tab === 'overview')}
       />
       <PanelNavRow
         icon={<Server size={14} className="text-muted-foreground" />}
         title={copy.navMcp}
-        onClick={openAdvancedConfig}
+        href="/agents?tab=mcp"
+        active={inAgentsRoute && tab === 'mcp'}
       />
       <PanelNavRow
         icon={<Zap size={14} className="text-muted-foreground" />}
         title={copy.navSkills}
-        onClick={() => scrollTo(skillsRef.current)}
+        href="/agents?tab=skills"
+        active={inAgentsRoute && tab === 'skills'}
       />
     </div>
   );

package/app/components/panels/PluginsPanel.tsx

@@ -2,7 +2,7 @@
 
 import { useState, useEffect, useCallback, useRef } from 'react';
 import { useRouter } from 'next/navigation';
-import { getAllRenderers, isRendererEnabled, setRendererEnabled, loadDisabledState } from '@/lib/renderers/registry';
+import { getPluginRenderers, isRendererEnabled, setRendererEnabled, loadDisabledState } from '@/lib/renderers/registry';
 import { Toggle } from '../settings/Primitives';
 import PanelHeader from './PanelHeader';
 import { useLocale } from '@/lib/LocaleContext';
@@ -32,7 +32,7 @@ export default function PluginsPanel({ active, maximized, onMaximize }: PluginsP
   useEffect(() => {
     if (!mounted || fetchedRef.current) return;
     fetchedRef.current = true;
-    const entryPaths = getAllRenderers()
+    const entryPaths = getPluginRenderers()
       .map(r => r.entryPath)
       .filter((p): p is string => !!p);
     if (entryPaths.length === 0) return;
@@ -47,7 +47,7 @@ export default function PluginsPanel({ active, maximized, onMaximize }: PluginsP
       .catch(() => {});
   }, [mounted]);
 
-  const renderers = mounted ? getAllRenderers() : [];
+  const renderers = mounted ? getPluginRenderers() : [];
   const enabledCount = mounted ? renderers.filter(r => isRendererEnabled(r.id)).length : 0;
 
   const handleToggle = useCallback((id: string, enabled: boolean) => {

package/app/components/renderers/agent-inspector/manifest.ts

@@ -8,6 +8,8 @@ export const manifest: RendererDefinition = {
   icon: '🔍',
   tags: ['agent', 'inspector', 'log', 'mcp', 'tools'],
   builtin: true,
+  core: true,
+  appBuiltinFeature: true,
   entryPath: '.agent-log.json',
   match: ({ filePath }) => /\.agent-log\.json$/i.test(filePath),
   load: () => import('./AgentInspectorRenderer').then(m => ({ default: m.AgentInspectorRenderer })),

package/app/components/renderers/config/manifest.ts

@@ -9,6 +9,7 @@ export const manifest: RendererDefinition = {
   tags: ['config', 'json', 'settings', 'schema'],
   builtin: true,
   core: true,
+  appBuiltinFeature: true,
   entryPath: 'CONFIG.json',
   match: ({ filePath, extension }) => extension === 'json' && /(^|\/)CONFIG\.json$/i.test(filePath),
   load: () => import('./ConfigRenderer').then(m => ({ default: m.ConfigRenderer })),

package/app/components/renderers/csv/manifest.ts

@@ -9,6 +9,7 @@ export const manifest: RendererDefinition = {
   tags: ['csv', 'table', 'gallery', 'board', 'data'],
   builtin: true,
   core: true,
+  appBuiltinFeature: true,
   entryPath: 'Resources/Products.csv',
   match: ({ extension, filePath }) => extension === 'csv' && !/\bTODO\b/i.test(filePath),
   load: () => import('./CsvRenderer').then(m => ({ default: m.CsvRenderer })),

package/app/components/settings/PluginsTab.tsx

@@ -1,20 +1,21 @@
 'use client';
 
 import { Puzzle } from 'lucide-react';
-import { getAllRenderers, setRendererEnabled } from '@/lib/renderers/registry';
+import { getPluginRenderers, setRendererEnabled } from '@/lib/renderers/registry';
 import { Toggle } from './Primitives';
 import type { PluginsTabProps } from './types';
 
 export function PluginsTab({ pluginStates, setPluginStates, t }: PluginsTabProps) {
+  const renderers = getPluginRenderers();
   return (
     <div className="space-y-5">
       <p className="text-xs font-medium text-muted-foreground uppercase tracking-wider">{t.settings.plugins.title}</p>
 
-      {getAllRenderers().length === 0 ? (
+      {renderers.length === 0 ? (
         <p className="text-sm text-muted-foreground">{t.settings.plugins.noPlugins}</p>
       ) : (
         <div className="flex flex-col gap-3">
-          {getAllRenderers().map(renderer => {
+          {renderers.map(renderer => {
             const isCore = !!renderer.core;
             const enabled = isCore ? true : (pluginStates[renderer.id] ?? true);
             return (

package/app/hooks/useMcpData.tsx

@@ -128,7 +128,7 @@ export default function McpProvider({ children }: { children: ReactNode }) {
     if (!agent) return false;
 
     try {
-      const res = await apiFetch<{ results: Array<{ key: string; ok: boolean; error?: string }> }>('/api/mcp/install', {
+      const res = await apiFetch<{ results: Array<{ agent?: string; status?: string; ok?: boolean; error?: string }> }>('/api/mcp/install', {
         method: 'POST',
         headers: { 'Content-Type': 'application/json' },
         body: JSON.stringify({
@@ -141,7 +141,8 @@ export default function McpProvider({ children }: { children: ReactNode }) {
         }),
       });
 
-      const ok = res.results?.[0]?.ok ?? false;
+      const first = res.results?.[0];
+      const ok = first?.ok === true || first?.status === 'ok';
       if (ok) {
         // Refresh to pick up newly installed agent
         await fetchAll();

package/app/lib/core/content-changes.ts

@@ -32,11 +32,18 @@ interface ChangeLogState {
   version: 1;
   lastSeenAt: string | null;
   events: ContentChangeEvent[];
+  legacy?: {
+    agentDiffImportedCount?: number;
+    lastImportedAt?: string | null;
+  };
 }
 
 interface ListOptions {
   path?: string;
   limit?: number;
+  source?: ContentChangeSource;
+  op?: string;
+  q?: string;
 }
 
 export interface ContentChangeSummary {
@@ -64,6 +71,10 @@ function defaultState(): ChangeLogState {
     version: 1,
     lastSeenAt: null,
     events: [],
+    legacy: {
+      agentDiffImportedCount: 0,
+      lastImportedAt: null,
+    },
   };
 }
 
@@ -87,6 +98,16 @@ function readState(mindRoot: string): ChangeLogState {
       version: 1,
       lastSeenAt: typeof parsed.lastSeenAt === 'string' ? parsed.lastSeenAt : null,
       events: parsed.events,
+      legacy: {
+        agentDiffImportedCount:
+          typeof parsed.legacy?.agentDiffImportedCount === 'number'
+            ? parsed.legacy.agentDiffImportedCount
+            : 0,
+        lastImportedAt:
+          typeof parsed.legacy?.lastImportedAt === 'string'
+            ? parsed.legacy.lastImportedAt
+            : null,
+      },
     };
   } catch {
     return defaultState();
@@ -99,8 +120,115 @@ function writeState(mindRoot: string, state: ChangeLogState): void {
   fs.writeFileSync(file, JSON.stringify(state, null, 2), 'utf-8');
 }
 
-export function appendContentChange(mindRoot: string, input: ContentChangeInput): ContentChangeEvent {
+interface LegacyAgentDiffEntry {
+  ts?: string;
+  path?: string;
+  tool?: string;
+  before?: string;
+  after?: string;
+}
+
+function parseLegacyAgentDiffBlocks(content: string): LegacyAgentDiffEntry[] {
+  const blocks: LegacyAgentDiffEntry[] = [];
+  const re = /```agent-diff\s*\n([\s\S]*?)```/g;
+  let m: RegExpExecArray | null;
+  while ((m = re.exec(content)) !== null) {
+    try {
+      const parsed = JSON.parse(m[1].trim()) as LegacyAgentDiffEntry;
+      blocks.push(parsed);
+    } catch {
+      // Skip malformed block, keep import best-effort.
+    }
+  }
+  return blocks;
+}
+
+function toValidIso(ts: string | undefined): string {
+  if (!ts) return nowIso();
+  const ms = new Date(ts).getTime();
+  return Number.isFinite(ms) ? new Date(ms).toISOString() : nowIso();
+}
+
+function removeLegacyFile(filePath: string): void {
+  try {
+    fs.rmSync(filePath, { force: true });
+  } catch {
+    // keep best-effort; migration should not fail main flow.
+  }
+}
+
+function importLegacyAgentDiffIfNeeded(mindRoot: string, state: ChangeLogState): ChangeLogState {
+  const legacyPath = path.join(mindRoot, 'Agent-Diff.md');
+  if (!fs.existsSync(legacyPath)) return state;
+
+  let raw = '';
+  try {
+    raw = fs.readFileSync(legacyPath, 'utf-8');
+  } catch {
+    return state;
+  }
+
+  const blocks = parseLegacyAgentDiffBlocks(raw);
+  const importedCount = state.legacy?.agentDiffImportedCount ?? 0;
+  if (blocks.length <= importedCount) {
+    // Already migrated before: remove legacy file to avoid stale duplicate source.
+    if (blocks.length > 0) removeLegacyFile(legacyPath);
+    return state;
+  }
+
+  const incoming = blocks.slice(importedCount);
+  const importedEvents: ContentChangeEvent[] = incoming.map((entry, idx) => {
+    const before = normalizeText(entry.before);
+    const after = normalizeText(entry.after);
+    const toolName = typeof entry.tool === 'string' && entry.tool.trim()
+      ? entry.tool.trim()
+      : 'unknown-tool';
+    const targetPath = typeof entry.path === 'string' && entry.path.trim()
+      ? entry.path
+      : 'Agent-Diff.md';
+    return {
+      id: `legacy-${Date.now().toString(36)}-${idx.toString(36)}`,
+      ts: toValidIso(entry.ts),
+      op: 'legacy_agent_diff_import',
+      path: targetPath,
+      source: 'agent',
+      summary: `Imported legacy agent diff (${toolName})`,
+      before: before.value,
+      after: after.value,
+      truncated: before.truncated || after.truncated || undefined,
+    };
+  });
+
+  const merged = [...state.events, ...importedEvents].sort(
+    (a, b) => new Date(b.ts).getTime() - new Date(a.ts).getTime(),
+  );
+
+  const nextState = {
+    ...state,
+    events: merged.slice(0, MAX_EVENTS),
+    legacy: {
+      agentDiffImportedCount: blocks.length,
+      lastImportedAt: nowIso(),
+    },
+  };
+  removeLegacyFile(legacyPath);
+  return nextState;
+}
+
+function loadState(mindRoot: string): ChangeLogState {
   const state = readState(mindRoot);
+  const migrated = importLegacyAgentDiffIfNeeded(mindRoot, state);
+  const changed =
+    (state.legacy?.agentDiffImportedCount ?? 0) !== (migrated.legacy?.agentDiffImportedCount ?? 0) ||
+    state.events.length !== migrated.events.length;
+  if (changed) {
+    writeState(mindRoot, migrated);
+  }
+  return migrated;
+}
+
+export function appendContentChange(mindRoot: string, input: ContentChangeInput): ContentChangeEvent {
+  const state = loadState(mindRoot);
   const before = normalizeText(input.before);
   const after = normalizeText(input.after);
   const event: ContentChangeEvent = {
@@ -125,23 +253,35 @@ export function appendContentChange(mindRoot: string, input: ContentChangeInput)
 }
 
 export function listContentChanges(mindRoot: string, options: ListOptions = {}): ContentChangeEvent[] {
-  const state = readState(mindRoot);
+  const state = loadState(mindRoot);
   const limit = Math.max(1, Math.min(options.limit ?? 50, 200));
-  const pathFilter = options.path;
-  const events = pathFilter
-    ? state.events.filter((event) => event.path === pathFilter || event.beforePath === pathFilter || event.afterPath === pathFilter)
-    : state.events;
+  const pathFilter = options.path?.trim();
+  const sourceFilter = options.source;
+  const opFilter = options.op?.trim();
+  const q = options.q?.trim().toLowerCase();
+  const events = state.events.filter((event) => {
+    if (pathFilter && event.path !== pathFilter && event.beforePath !== pathFilter && event.afterPath !== pathFilter) {
+      return false;
+    }
+    if (sourceFilter && event.source !== sourceFilter) return false;
+    if (opFilter && event.op !== opFilter) return false;
+    if (q) {
+      const haystack = `${event.path} ${event.beforePath ?? ''} ${event.afterPath ?? ''} ${event.summary} ${event.op} ${event.source}`.toLowerCase();
+      if (!haystack.includes(q)) return false;
+    }
+    return true;
+  });
   return events.slice(0, limit);
 }
 
 export function markContentChangesSeen(mindRoot: string): void {
-  const state = readState(mindRoot);
+  const state = loadState(mindRoot);
   state.lastSeenAt = nowIso();
   writeState(mindRoot, state);
 }
 
 export function getContentChangeSummary(mindRoot: string): ContentChangeSummary {
-  const state = readState(mindRoot);
+  const state = loadState(mindRoot);
   const lastSeenAtMs = state.lastSeenAt ? new Date(state.lastSeenAt).getTime() : 0;
   const unreadCount = state.events.filter((event) => new Date(event.ts).getTime() > lastSeenAtMs).length;
   return {

package/app/lib/fs.ts

@@ -199,7 +199,13 @@ export function appendContentChange(input: ContentChangeInput): ContentChangeEve
   return coreAppendContentChange(getMindRoot(), input);
 }
 
-export function listContentChanges(options: { path?: string; limit?: number } = {}): ContentChangeEvent[] {
+export function listContentChanges(options: {
+  path?: string;
+  limit?: number;
+  source?: 'user' | 'agent' | 'system';
+  op?: string;
+  q?: string;
+} = {}): ContentChangeEvent[] {
   return coreListContentChanges(getMindRoot(), options);
 }