claude-memory-admin 1.0.1 → 1.2.0

package/public/ui.mjs

@@ -0,0 +1,309 @@
+const cx = (...parts) => parts.filter(Boolean).join(' ');
+
+const pick = (map, key, fallback) => map[key] ?? map[fallback];
+
+const controlPad = {
+  sm: 'min-h-control-h-sm px-control-x-sm py-control-y-sm',
+  md: 'min-h-control-h-md px-control-x-md py-control-y-md',
+  lg: 'min-h-control-h-lg px-control-x-lg py-control-y-lg',
+};
+
+export const shell = 'grid h-screen grid-cols-[280px_1fr] bg-canvas';
+export const shellCollapsed = 'grid h-screen grid-cols-1 bg-canvas';
+
+export const sidebar = 'flex flex-col overflow-hidden border-r border-line bg-surface';
+export const sidebarHidden = 'hidden';
+export const sidebarHead = 'border-b border-line p-4';
+export const sidebarTitle = 'font-mono text-sm font-semibold tracking-tightest text-fg';
+export const sidebarRoot = 'mt-1 mb-2.5 font-mono text-2xs break-all text-fg-muted';
+export const sidebarList = 'flex-1 overflow-y-auto p-2';
+export const sidebarGroup = 'px-2 pt-3 pb-1 font-mono text-2xs font-semibold uppercase tracking-widest text-fg-subtle';
+export const sidebarFoot = 'border-t border-line p-4';
+export const sidebarCredit = 'flex flex-col gap-1.5 text-2xs text-fg-subtle no-underline transition-colors hover:text-fg';
+export const sidebarLogo = 'w-24 opacity-60 transition-opacity dark:invert';
+
+export const toggleLabel = 'flex cursor-pointer items-center gap-1.5 text-xs text-fg-muted';
+export const checkbox = 'accent-accent';
+
+export const searchInput = cx('w-full rounded-md border border-line bg-surface-sunken font-mono text-xs text-fg placeholder:text-fg-subtle focus:border-accent focus:outline-none', controlPad.lg);
+
+const storeItemBase = 'mb-0.5 block w-full cursor-pointer rounded-md border border-transparent px-2.5 py-2 text-left transition-colors';
+const storeItemState = {
+  active: 'border-accent-line bg-accent-surface',
+  idle: 'hover:bg-surface-sunken',
+  empty: 'opacity-50 hover:bg-surface-sunken',
+};
+export const storeItem = ({ active = false, empty = false } = {}) =>
+  cx(storeItemBase, active ? storeItemState.active : empty ? storeItemState.empty : storeItemState.idle);
+
+export const storeRow = 'flex items-baseline gap-2';
+export const storeName = 'flex-1 truncate text-sm font-medium text-fg';
+export const storeCount = 'font-mono text-2xs text-fg-subtle';
+export const storePath = 'block truncate font-mono text-2xs text-fg-subtle';
+
+const dotBase = 'inline-block size-1.5 flex-none rounded-full';
+const dotTone = { ok: 'bg-ok', warn: 'bg-warn', none: 'bg-line-strong' };
+export const dot = (tone) => cx(dotBase, pick(dotTone, tone, 'none'));
+
+export const offMarker = 'rounded-sm bg-warn-surface px-1 py-px font-mono text-2xs uppercase tracking-widest text-warn';
+export const rootSource = 'ml-1.5 rounded-sm bg-accent-surface px-1 py-px font-mono text-2xs uppercase tracking-widest text-accent';
+
+export const main = 'overflow-y-auto';
+export const emptyState = 'px-10 py-[15vh] text-center text-fg-muted';
+export const emptyTitle = 'mb-2 text-xl font-semibold tracking-tightest text-fg';
+
+export const projectHead = 'sticky top-0 z-10 border-b border-line bg-canvas px-7 pt-5';
+export const projectHeadRow = 'flex items-center gap-3';
+export const projectTitle = 'flex-1 text-xl font-semibold tracking-tightest text-fg';
+export const projectSub = 'mt-1 mb-3.5 font-mono text-2xs break-all text-fg-muted [&>span]:block';
+export const subNote = 'mt-0.5 text-2xs text-fg-subtle';
+export const subWarn = 'mt-0.5 text-2xs text-warn';
+
+export const tabBar = 'flex gap-0.5';
+const tabBase = cx('-mb-px cursor-pointer border-b-2 font-mono text-xs uppercase tracking-widest transition-colors', controlPad.md);
+const tabState = {
+  active: 'border-accent font-semibold text-fg',
+  idle: 'border-transparent text-fg-muted hover:text-fg',
+};
+export const tab = (active) => cx(tabBase, active ? tabState.active : tabState.idle);
+
+export const tabContent = 'px-7 pt-6 pb-16';
+
+const badgeBase = 'flex-none rounded-sm px-1.5 py-px font-mono text-2xs lowercase';
+const badgeTone = {
+  neutral: 'bg-surface-sunken text-fg-muted',
+  warn: 'bg-warn-surface text-warn',
+  ok: 'bg-ok-surface text-ok',
+  project: 'bg-type-project-surface text-type-project',
+  feedback: 'bg-type-feedback-surface text-type-feedback',
+  user: 'bg-type-user-surface text-type-user',
+  reference: 'bg-type-reference-surface text-type-reference',
+  managed: 'bg-scope-managed-surface text-scope-managed',
+  scopeUser: 'bg-scope-user-surface text-scope-user',
+  scopeProject: 'bg-scope-project-surface text-scope-project',
+  scopeLocal: 'bg-scope-local-surface text-scope-local',
+};
+export const badge = (tone = 'neutral') => cx(badgeBase, pick(badgeTone, tone, 'neutral'));
+
+const SCOPE_TONE = { managed: 'managed', user: 'scopeUser', project: 'scopeProject', local: 'scopeLocal' };
+export const scopeBadge = (scope) => badge(SCOPE_TONE[scope] ?? 'neutral');
+export const typeBadge = (type) => badge(badgeTone[type] ? type : 'neutral');
+export const tabBadge = (warn) => cx('ml-1.5', badge(warn ? 'warn' : 'neutral'));
+
+export const split = 'grid grid-cols-1 items-start gap-6 xl:grid-cols-[minmax(280px,380px)_1fr]';
+export const detailPane = 'xl:sticky xl:top-4 xl:max-h-[calc(100vh-9rem)] xl:overflow-y-auto';
+
+export const sectionLabel = 'mt-5 mb-2 font-mono text-2xs font-semibold uppercase tracking-widest text-fg-subtle first:mt-0';
+export const note = 'text-xs text-fg-muted';
+export const noteTight = 'mt-0 mb-2.5 text-xs text-fg-muted';
+
+const memoryItemBase = 'mb-1.5 block w-full cursor-pointer rounded-md border bg-surface px-3 py-2.5 text-left transition-colors';
+const memoryItemState = {
+  active: 'border-accent bg-accent-surface',
+  idle: 'border-line hover:border-accent-line',
+};
+export const memoryItem = (active) => cx(memoryItemBase, active ? memoryItemState.active : memoryItemState.idle);
+export const memoryTop = 'mb-1 flex items-center gap-2';
+export const memoryName = 'flex-1 truncate text-sm font-medium text-fg';
+export const memoryDesc = 'line-clamp-2 text-xs text-fg-muted';
+
+export const card = 'rounded-lg border border-line bg-surface p-5 shadow-card';
+export const detailHead = 'mb-1 flex items-start gap-3';
+export const detailTitle = 'flex-1 text-lg font-semibold tracking-tightest text-fg';
+export const detailDesc = 'mt-0 mb-3.5 text-sm text-fg-muted';
+
+export const metaList = 'mb-4 grid grid-cols-[auto_1fr] gap-x-3.5 gap-y-1 border-y border-line py-3 font-mono text-2xs';
+export const metaKey = 'text-fg-subtle';
+export const metaValue = 'm-0 break-all text-fg';
+
+export const prose = 'prose text-base text-fg';
+export const proseDim = 'prose text-base text-fg opacity-45';
+
+const wikilinkBase = 'rounded-sm border border-transparent px-1 font-medium';
+const wikilinkState = {
+  live: 'cursor-pointer bg-accent-surface text-accent hover:border-accent-line',
+  dead: 'cursor-help bg-danger-surface text-danger line-through',
+};
+export const wikilink = (live) => cx(wikilinkBase, live ? wikilinkState.live : wikilinkState.dead);
+export const indexLink = (live) => (live ? 'cursor-pointer' : 'cursor-help text-danger line-through decoration-danger');
+
+export const linkRow = 'mt-1.5 flex flex-wrap gap-1.5';
+export const linkSection = 'mt-5 border-t border-line pt-3.5';
+const chipBase = 'rounded-full border px-2.5 py-0.5 font-mono text-2xs transition-colors';
+const chipState = {
+  live: 'cursor-pointer border-line bg-surface-sunken text-fg hover:border-accent',
+  dead: 'cursor-default border-danger-line bg-danger-surface text-danger',
+};
+export const chip = (live) => cx(chipBase, live ? chipState.live : chipState.dead);
+
+const buttonBase = 'inline-flex cursor-pointer items-center gap-1.5 rounded-md border font-medium transition-colors disabled:cursor-not-allowed disabled:opacity-45';
+const buttonTone = {
+  neutral: 'border-line bg-surface text-fg hover:border-line-strong hover:bg-surface-sunken',
+  primary: 'border-accent bg-accent text-on-accent hover:bg-accent-hover hover:border-accent-hover',
+  danger: 'border-danger-line bg-danger-surface text-danger hover:bg-danger hover:text-on-accent',
+};
+const buttonSize = {
+  md: cx(controlPad.md, 'text-sm'),
+  sm: cx(controlPad.sm, 'text-xs'),
+};
+export const button = ({ tone = 'neutral', size = 'md' } = {}) =>
+  cx(buttonBase, pick(buttonTone, tone, 'neutral'), pick(buttonSize, size, 'md'));
+
+export const linkButton = 'cursor-pointer border-none bg-transparent p-0 text-xs text-accent underline hover:text-accent-hover';
+export const iconButton = cx('float-right ml-2 cursor-pointer rounded-sm border border-line font-mono text-2xs leading-none text-fg-muted transition-colors hover:border-line-strong hover:text-fg', controlPad.sm);
+export const expandHandle = 'fixed top-3.5 left-0 z-20 cursor-pointer rounded-r-md border border-l-0 border-line bg-surface px-1.5 py-2 font-mono text-2xs text-fg-muted transition-colors hover:text-fg';
+
+export const segmentGroup = 'inline-flex flex-none items-center gap-px rounded-md border border-line bg-surface-sunken p-0.5';
+const segmentBase = cx('cursor-pointer rounded-sm font-mono text-2xs uppercase tracking-widest transition-colors', controlPad.sm);
+const segmentState = { on: 'bg-accent text-on-accent', off: 'text-fg-muted hover:text-fg' };
+export const segment = (active) => cx(segmentBase, active ? segmentState.on : segmentState.off);
+
+export const cardHeadRow = 'mb-4 flex items-center justify-between gap-3 border-b border-line pb-3';
+
+const indexLineBase = 'grid grid-cols-[3rem_1fr] gap-3 rounded-sm px-1.5 py-px font-mono text-xs';
+const indexLineTone = {
+  heading: 'font-bold text-accent',
+  index: 'text-fg',
+  text: 'text-fg-muted',
+};
+export const indexLine = ({ dangling = false, dropped = false } = {}) => cx(
+  indexLineBase,
+  dangling ? 'bg-danger-surface' : 'hover:bg-surface-sunken',
+  dropped && 'opacity-45',
+);
+export const indexLineNumber = 'text-right text-fg-subtle select-none';
+export const indexLineText = ({ kind = 'text', clickable = false, dropped = false } = {}) => cx(
+  'whitespace-pre-wrap break-words',
+  pick(indexLineTone, kind, 'text'),
+  clickable && 'cursor-pointer hover:underline',
+  dropped && 'line-through decoration-line-strong',
+);
+
+export const cutLine = 'my-2.5 flex items-center gap-2.5 before:flex-1 before:border-t before:border-dashed before:border-danger after:flex-1 after:border-t after:border-dashed after:border-danger';
+export const cutLabel = 'flex-none font-mono text-2xs whitespace-nowrap text-danger';
+
+const issueBase = 'mb-2 flex items-start gap-3 rounded-md border border-l-2 border-line bg-surface px-3.5 py-2.5';
+const issueTone = { warn: 'border-l-warn', bad: 'border-l-danger' };
+export const issue = (bad) => cx(issueBase, bad ? issueTone.bad : issueTone.warn);
+export const issueBody = 'min-w-0 flex-1';
+export const issueTitle = 'text-sm font-medium text-fg';
+export const issueDetail = 'font-mono text-2xs break-words text-fg-muted';
+
+export const cutSummary = 'mb-4 rounded-lg border border-danger-line bg-danger-surface px-4 py-3.5';
+export const cutSummaryHead = 'mb-1 text-sm font-semibold text-danger';
+
+export const meter = 'mb-5 rounded-lg border border-line bg-surface px-5 py-4';
+export const meterTop = 'mb-2.5 flex items-baseline gap-2.5';
+export const meterValue = 'font-mono text-2xl font-semibold tracking-tightest text-fg';
+export const meterUnit = 'flex-1 text-sm text-fg-muted';
+export const meterBar = 'h-2 overflow-hidden rounded-full border border-line bg-surface-sunken';
+const meterFillTone = { ok: 'bg-ok', near: 'bg-warn', over: 'bg-danger' };
+export const meterFill = (level) => cx('h-full transition-[width]', pick(meterFillTone, level, 'ok'));
+export const meterNote = 'mt-2.5 text-xs text-fg-muted';
+export const meterFacts = 'mt-3 flex flex-wrap gap-4 border-t border-line pt-3 font-mono text-2xs text-fg-muted';
+export const meterFactValue = 'font-semibold text-fg';
+
+export const pruneBar = 'mb-2.5 flex flex-wrap items-center gap-2.5';
+export const pruneSpacer = 'flex-1';
+export const select = cx('cursor-pointer rounded-md border border-line bg-surface font-mono text-xs text-fg hover:border-line-strong focus:outline-none', controlPad.sm);
+
+const pruneRowBase = 'mb-1 flex cursor-pointer items-center gap-2.5 rounded-md border px-3 py-2 transition-colors';
+const pruneRowState = { on: 'border-danger-line bg-danger-surface', off: 'border-line bg-surface hover:border-accent-line' };
+export const pruneRow = (on) => cx(pruneRowBase, on ? pruneRowState.on : pruneRowState.off);
+export const pruneMain = 'min-w-0 flex-1';
+export const pruneName = 'block text-sm font-medium text-fg';
+export const pruneDesc = 'block truncate text-xs text-fg-muted';
+export const pruneFacts = 'flex flex-none gap-3 font-mono text-2xs text-fg-muted';
+export const pruneFact = (warn) => (warn ? 'text-warn' : 'text-fg-muted');
+
+export const dupe = 'mb-2 rounded-lg border border-line bg-surface px-3.5 py-3';
+export const dupeHead = 'mb-2 flex items-baseline gap-2 font-mono text-2xs text-fg-muted';
+export const dupeScore = 'font-semibold text-warn';
+export const dupePair = 'grid grid-cols-1 gap-2.5 md:grid-cols-2';
+export const dupeSide = 'cursor-pointer rounded-md border border-line bg-surface-sunken px-3 py-2.5 transition-colors hover:border-accent';
+export const dupeSideName = 'text-sm font-medium text-fg';
+export const dupeActions = 'mt-2 flex flex-wrap justify-end gap-2';
+export const dupeSideDesc = 'text-xs text-fg-muted';
+
+export const contextMain = 'min-w-0';
+export const contextTags = 'mb-1 flex flex-wrap gap-1.5';
+export const contextFile = 'font-mono text-2xs break-words text-fg';
+export const contextSize = 'font-mono text-2xs whitespace-nowrap text-fg-subtle';
+export const contextRowButton = 'flex w-full cursor-pointer items-baseline justify-between gap-3.5 border-0 border-b border-line bg-transparent px-1 py-1.5 text-left transition-colors last:border-b-0 hover:bg-surface-sunken';
+export const contextCaret = 'mr-1.5 inline-block font-mono text-2xs text-fg-subtle';
+export const contextBody = 'mb-1.5 max-h-[28rem] overflow-y-auto rounded-md border border-line bg-surface-sunken px-3.5 py-2.5';
+
+export const graphWrap = 'graph relative overflow-hidden rounded-lg border border-line bg-surface';
+export const graphToolbar = 'absolute top-3 right-3.5 flex items-center gap-1.5 rounded-md border border-line bg-surface px-2 py-1.5';
+export const graphButton = cx('min-w-6 cursor-pointer rounded-sm border border-line bg-transparent font-mono text-xs text-fg-muted transition-colors hover:border-line-strong hover:text-fg', controlPad.sm);
+export const graphLabel = 'flex items-center gap-1.5 font-mono text-2xs text-fg-muted';
+export const graphRange = 'w-20 accent-accent';
+export const graphLegend = 'absolute bottom-3 left-3.5 flex flex-wrap gap-3 rounded-md border border-line bg-surface px-2.5 py-1.5 font-mono text-2xs text-fg-muted';
+export const graphLegendItem = 'flex items-center gap-1.5';
+export const graphLegendSwatch = 'inline-block size-2 rounded-full';
+
+export const modalBackdrop = 'fixed inset-0 z-100 flex items-center justify-center bg-scrim p-6';
+export const modal = 'flex max-h-[82vh] w-full max-w-2xl flex-col rounded-xl border border-line bg-surface shadow-pop';
+export const modalHead = 'px-6 pt-5';
+export const modalTitle = 'mb-1 text-lg font-semibold tracking-tightest text-fg';
+export const modalBody = 'overflow-y-auto px-6 py-3.5';
+export const modalFoot = 'flex justify-end gap-2 border-t border-line px-6 pt-3.5 pb-4.5';
+
+export const willBlock = 'mb-3.5';
+export const willTitle = 'mb-1.5 font-mono text-2xs font-semibold uppercase tracking-widest text-fg-subtle';
+const willItemBase = 'mb-1 rounded-md border border-line bg-surface-sunken px-2.5 py-1.5 font-mono text-2xs break-words text-fg-muted';
+const willItemTone = { remove: 'border-l-2 border-l-danger', keep: 'border-l-2 border-l-warn' };
+export const willItem = (tone) => cx(willItemBase, willItemTone[tone]);
+
+export const cascadeHead = 'mb-1.5 flex items-baseline justify-between gap-2.5';
+export const cascadeList = 'overflow-hidden rounded-md border border-line';
+const cascadeRowBase = 'flex cursor-pointer items-start gap-2.5 border-b border-line px-3 py-2 transition-colors last:border-b-0';
+const cascadeRowState = { on: 'bg-danger-surface', off: 'hover:bg-surface-sunken' };
+export const cascadeRow = (on) => cx(cascadeRowBase, on ? cascadeRowState.on : cascadeRowState.off);
+export const cascadeText = 'min-w-0';
+export const cascadeName = 'block text-sm font-medium text-fg';
+export const cascadeDetail = 'block font-mono text-2xs break-words text-fg-muted';
+
+export const pathInput = cx('my-1 mb-3 w-full rounded-md border border-line bg-surface-sunken font-mono text-xs text-fg focus:border-accent focus:outline-none', controlPad.lg);
+export const textArea = cx('my-1 mb-1.5 block min-h-20 w-full resize-y rounded-md border border-line bg-surface-sunken font-mono text-xs leading-relaxed text-fg focus:border-accent focus:outline-none', controlPad.lg);
+export const hookEditor = 'mb-1.5 rounded-md border border-accent-line bg-surface-sunken px-3 py-2.5';
+export const hookEditorFoot = 'flex justify-end gap-2';
+export const charCount = 'mb-3 flex items-baseline justify-between gap-3 font-mono text-2xs text-fg-subtle';
+export const charCountOver = 'mb-3 flex items-baseline justify-between gap-3 font-mono text-2xs text-warn';
+
+export const settingsKeyHead = 'mb-1.5 flex flex-wrap items-baseline gap-2.5';
+export const settingsKeyName = 'font-mono text-sm font-semibold text-fg';
+export const settingsEffective = 'rounded-sm bg-accent-surface px-1.5 py-px font-mono text-2xs break-all text-accent';
+export const settingsLayerRow = 'flex flex-wrap items-baseline gap-2.5 border-b border-line py-1.5 last:border-b-0';
+export const settingsLayerFile = 'min-w-0 flex-1 font-mono text-2xs break-all text-fg-subtle';
+const settingsLayerValueBase = 'font-mono text-2xs break-all';
+const settingsLayerValueState = { wins: 'text-fg', shadowed: 'text-fg-subtle line-through decoration-line-strong' };
+export const settingsLayerValue = (wins) => cx(settingsLayerValueBase, wins ? settingsLayerValueState.wins : settingsLayerValueState.shadowed);
+
+export const toastRoot = 'fixed bottom-5 left-1/2 z-200 flex -translate-x-1/2 flex-col items-center gap-2';
+const toastBase = 'flex items-center gap-3 rounded-full px-4 py-2 text-sm shadow-pop';
+const toastTone = { info: 'bg-fg text-canvas', error: 'bg-danger text-on-accent' };
+export const toast = (error) => cx(toastBase, error ? toastTone.error : toastTone.info);
+export const toastAction = cx('cursor-pointer rounded-full border border-current bg-transparent text-xs', controlPad.sm);
+
+export const searchHead = 'sticky top-0 z-10 flex items-center gap-3 border-b border-line bg-canvas px-7 pt-5 pb-3.5';
+export const searchTitle = 'flex-1 text-lg font-semibold tracking-tightest text-fg';
+export const searchResults = 'px-7 pt-5 pb-16';
+export const resultGroup = 'mb-6';
+export const result = 'mb-1.5 block w-full cursor-pointer rounded-md border border-line bg-surface px-3.5 py-2.5 text-left transition-colors hover:border-accent';
+export const resultTop = 'mb-1 flex items-center gap-2';
+export const resultName = 'flex-1 text-sm font-medium text-fg';
+export const resultSnippet = 'block text-xs text-fg-muted';
+export const resultWhere = 'block font-mono text-2xs text-fg-subtle';
+export const resultMark = 'rounded-sm bg-accent-surface px-px text-accent';
+
+export const buttonSmall = button({ size: 'sm' });
+export const buttonPrimarySmall = button({ tone: 'primary', size: 'sm' });
+export const buttonDangerSmall = button({ tone: 'danger', size: 'sm' });
+export const promptCaret = 'text-accent';
+export const inlineCode = 'rounded-sm border border-line bg-surface-sunken px-1 font-mono text-xs text-accent';
+export const okLine = 'm-0 text-base text-fg';
+export const graphEmpty = 'p-10 text-center text-fg-muted';
+export const graphNode = (highlighted) => (highlighted ? 'node hi' : 'node');
+export const graphEdge = 'edge';
+export const graphHit = 'hit';

package/server.mjs

@@ -10,16 +10,23 @@ import { spawn } from 'node:child_process';
 
 import { projectsRoot, resolveRoot } from './src/projects.mjs';
 import { buildStore } from './src/model.mjs';
-import { resolveInstructions } from './src/instructions.mjs';
+import { resolveGlobalInstructions, resolveInstructions } from './src/instructions.mjs';
+import { settingsReport } from './src/settings.mjs';
 import { listStores } from './src/stores.mjs';
 import { forgetPath, rememberPath } from './src/pathcache.mjs';
 import { searchAll } from './src/search.mjs';
 import {
+  addIndexEntry,
+  addIndexEntryPreview,
   deleteIndexLine,
   deleteMemories,
   deleteMemory,
   deletePreview,
   deleteProject,
+  editIndexHook,
+  mergeMemories,
+  mergePreview,
+  moveIndexEntry,
   projectDeletePreview,
   removeWikilink,
   restoreMemory,
@@ -119,6 +126,40 @@ function requireStore(id) {
   return store;
 }
 
+function storeProjectDir(store) {
+  // The global store is the user scope itself, which no project owns.
+  if (store.kind === 'global') return null;
+  if (store.kind !== 'auto') return store.projectPath || null;
+  return store.pathExists ? store.path : null;
+}
+
+/**
+ * The global store holds instructions, not memory, and its directory is ~/.claude
+ * itself. Every write endpoint below resolves a target inside `store.dir`, so
+ * without this guard a delete aimed at it would land on the user's CLAUDE.md and
+ * settings rather than on a memory file. It is read-only, and refused here once
+ * rather than in each of the fifteen handlers.
+ */
+export function refuseWritesToGlobal(store, method) {
+  if (store.kind === 'global' && method !== 'GET') {
+    throw new Error('The global store is read-only: it holds instruction files, not memory.');
+  }
+}
+
+/** A store with nothing to build a memory model from, in the shape the frontend expects. */
+function emptyModel(store) {
+  return {
+    ...store,
+    index: null,
+    memories: [],
+    graph: { nodes: [], edges: [], dangling: [] },
+    health: { orphans: [], referencedOnly: [], danglingIndex: [], danglingWikilinks: [], nameMismatches: [], missingFrontmatter: [], longHooks: [], issues: [], issueCount: 0 },
+    stats: null,
+    duplicates: [],
+    trash: [],
+  };
+}
+
 async function handleApi(req, res, url) {
   const segments = url.pathname.split('/').filter(Boolean); // ['api', 'projects', ...]
 
@@ -144,24 +185,30 @@ async function handleApi(req, res, url) {
   }
 
   const store = requireStore(decodeURIComponent(segments[2]));
+  refuseWritesToGlobal(store, req.method);
   const dir = store.dir;
   const action = segments.slice(3).join('/');
 
   if (!action && req.method === 'GET') {
-    return sendJson(res, 200, buildStore(store));
+    // buildStore reads every .md in the directory as a memory file, which for
+    // ~/.claude would present CLAUDE.md and its neighbours as memories.
+    return sendJson(res, 200, store.kind === 'global' ? emptyModel(store) : buildStore(store));
   }
 
   // What a session starting in this store's project would load as instructions.
   // Read-only, and scoped to a directory the app already discovered rather than
   // one named in the request.
   if (action === 'instructions' && req.method === 'GET') {
-    const projectDir = store.kind === 'auto'
-      ? (store.pathExists ? store.path : null)
-      : store.projectPath;
+    if (store.kind === 'global') return sendJson(res, 200, resolveGlobalInstructions());
+    const projectDir = storeProjectDir(store);
     if (!projectDir) return sendJson(res, 200, { projectDir: null, files: [], problems: [], excluded: [], totals: null });
     return sendJson(res, 200, resolveInstructions(projectDir));
   }
 
+  if (action === 'settings' && req.method === 'GET') {
+    return sendJson(res, 200, settingsReport({ projectDir: storeProjectDir(store) }));
+  }
+
   if (action === 'delete-preview' && req.method === 'POST') {
     const body = await readBody(req);
     return sendJson(res, 200, deletePreview(dir, body.file));
@@ -209,6 +256,36 @@ async function handleApi(req, res, url) {
     return sendJson(res, 200, forgetPath(store.slug));
   }
 
+  if (action === 'index/hook' && req.method === 'POST') {
+    const body = await readBody(req);
+    return sendJson(res, 200, editIndexHook(dir, body));
+  }
+
+  if (action === 'index/move' && req.method === 'POST') {
+    const body = await readBody(req);
+    return sendJson(res, 200, moveIndexEntry(dir, body));
+  }
+
+  if (action === 'index/add-preview' && req.method === 'POST') {
+    const body = await readBody(req);
+    return sendJson(res, 200, addIndexEntryPreview(dir, body));
+  }
+
+  if (action === 'index/add' && req.method === 'POST') {
+    const body = await readBody(req);
+    return sendJson(res, 200, addIndexEntry(dir, body));
+  }
+
+  if (action === 'merge-preview' && req.method === 'POST') {
+    const body = await readBody(req);
+    return sendJson(res, 200, mergePreview(dir, body));
+  }
+
+  if (action === 'merge' && req.method === 'POST') {
+    const body = await readBody(req);
+    return sendJson(res, 200, mergeMemories(dir, body));
+  }
+
   if (action === 'index-line/delete' && req.method === 'POST') {
     const body = await readBody(req);
     return sendJson(res, 200, deleteIndexLine(dir, body.lineIndex, body.expectedText));

package/src/instructions.mjs

@@ -65,6 +65,23 @@ export function maskCode(text) {
 // so the character before it has to be a boundary.
 const IMPORT = /(^|[\s(<'"])@((?:~\/|\.{0,2}\/)?[A-Za-z0-9._~\-][A-Za-z0-9._~\-/]*)/g;
 
+/**
+ * Drop the punctuation that ended the sentence rather than the path.
+ *
+ * A dot is legal in a filename and so is inside the match, which means an import
+ * written at the end of a sentence - "conventions live in @extra.md." - swallows
+ * the full stop and resolves to a file nobody has. The same goes for an ellipsis.
+ * No path meaningfully ends in a dot, so a trailing run of them is prose.
+ *
+ * Nothing else can leak in: the only other punctuation the match accepts is
+ * `-`, `_`, `~` and `/`, none of which ends an English sentence, and a trailing
+ * slash is left alone because it says "directory", which is a real thing to have
+ * written and a real thing for the import to fail on.
+ */
+function trimTrailingProse(spec) {
+  return spec.replace(/\.+$/, '');
+}
+
 /** Every `@path` import in a file's text, with the offset it was found at. */
 export function findImports(text) {
   const masked = maskCode(text);
@@ -74,7 +91,10 @@ export function findImports(text) {
     // "@team@example.com" opens with something that looks exactly like an
     // import until the second @ arrives.
     if (masked[end] === '@') continue;
-    found.push({ spec: match[2], index: match.index + match[1].length });
+    const spec = trimTrailingProse(match[2]);
+    // "@." and "@..." are punctuation with an @ in front, not a path.
+    if (!spec) continue;
+    found.push({ spec, index: match.index + match[1].length });
   }
   return found;
 }
@@ -313,19 +333,14 @@ function globToRegExp(pattern) {
 }
 
 /**
- * Everything that would load for a session started in `projectDir`, in the order
- * Claude Code loads it: broadest scope first, so the most specific instruction is
- * the last thing read.
+ * Managed policy and user scope: what loads whichever project a session starts in.
+ *
+ * `home` is a parameter rather than a call to os.homedir() so this is a total
+ * function of where it is told to look, which is what makes it testable without a
+ * real home directory.
  */
-export function resolveInstructions(projectDir) {
-  const home = os.homedir();
-  const layers = settingsLayers({ projectDir });
-  const excludeFound = lookup(layers, 'claudeMdExcludes');
-  const excludes = Array.isArray(excludeFound?.value) ? excludeFound.value.map(String) : [];
-  const excluded = [];
-
-  const candidates = [];
-  candidates.push(entry(managedClaudeMd(), 'managed', 'claude-md'));
+function userCandidates(home, layers) {
+  const candidates = [entry(managedClaudeMd(), 'managed', 'claude-md')];
 
   const managedInline = lookup(layers, 'claudeMd');
   const inline = typeof managedInline?.value === 'string' && managedInline.value.trim()
@@ -338,8 +353,12 @@ export function resolveInstructions(projectDir) {
   for (const file of listRuleFiles(path.join(home, '.claude', 'rules'))) {
     candidates.push(ruleEntry(file, 'user'));
   }
+  return candidates;
+}
 
-  // Root-to-cwd, CLAUDE.md then CLAUDE.local.md at each level.
+/** Root-to-cwd, CLAUDE.md then CLAUDE.local.md at each level, then the project's own .claude. */
+function projectCandidates(projectDir) {
+  const candidates = [];
   for (const dir of ancestors(projectDir)) {
     candidates.push(entry(path.join(dir, 'CLAUDE.md'), 'project', 'claude-md'));
     candidates.push(entry(path.join(dir, 'CLAUDE.local.md'), 'local', 'claude-md'));
@@ -348,8 +367,24 @@ export function resolveInstructions(projectDir) {
   for (const file of listRuleFiles(path.join(projectDir, '.claude', 'rules'))) {
     candidates.push(ruleEntry(file, 'project'));
   }
+  return candidates;
+}
+
+function readExcludes(layers) {
+  const found = lookup(layers, 'claudeMdExcludes');
+  return Array.isArray(found?.value) ? found.value.map(String) : [];
+}
 
+/**
+ * Turn a candidate list into the resolved set: excludes applied, imports expanded,
+ * every file measured and every problem named.
+ *
+ * Both entry points go through here, so the whole-session view and the user-scope
+ * one cannot drift apart in what they count or what they consider broken.
+ */
+function finalize(candidates, { projectDir, excludes }) {
   const matchers = excludes.map(globToRegExp);
+  const excluded = [];
   const loaded = [];
   const problems = [];
 
@@ -379,13 +414,6 @@ export function resolveInstructions(projectDir) {
     }
   }
 
-  // AGENTS.md is read by other tools, not by Claude Code, so one sitting next to
-  // an unrelated CLAUDE.md is a real and easy-to-miss divergence.
-  const agentsFile = path.join(projectDir, 'AGENTS.md');
-  if (fs.existsSync(agentsFile) && !loaded.some((item) => item.file === agentsFile)) {
-    problems.push({ kind: 'agents-md-not-imported', file: agentsFile, scope: 'project' });
-  }
-
   for (const item of loaded) {
     item.lines = item.text.split('\n').length;
     item.bytes = Buffer.byteLength(item.text, 'utf8');
@@ -421,3 +449,77 @@ export function resolveInstructions(projectDir) {
     },
   };
 }
+
+/**
+ * Markdown files sitting in ~/.claude that nothing in the chain reaches.
+ *
+ * A file next to CLAUDE.md looks load-bearing, and stops being so the moment the
+ * import that pulled it in is deleted or its content is inlined - which leaves
+ * nothing behind to say so. This is the same failure the unimported AGENTS.md
+ * check exists for, one directory up.
+ *
+ * Only the top level is read. The directories below it - plans, skills, projects,
+ * backups - are full of markdown that was never meant to be an instruction file,
+ * and walking into them would bury the one finding that matters.
+ */
+export function unreferencedUserFiles(home, loadedFiles) {
+  const dir = path.join(home, '.claude');
+  // Imports arrive already absolutised by resolveImport while candidates are
+  // joined from `home`, so both sides are resolved before they are compared.
+  const loaded = new Set(loadedFiles.map((item) => path.resolve(item.file)));
+
+  let entries;
+  try {
+    entries = fs.readdirSync(dir, { withFileTypes: true });
+  } catch {
+    return [];
+  }
+
+  return entries
+    .filter((item) => item.isFile() && item.name.endsWith('.md'))
+    .map((item) => path.resolve(dir, item.name))
+    .filter((file) => !loaded.has(file))
+    .sort()
+    .map((file) => ({ kind: 'unreferenced-user-file', file, scope: 'user' }));
+}
+
+/**
+ * Everything that would load for a session started in `projectDir`, in the order
+ * Claude Code loads it: broadest scope first, so the most specific instruction is
+ * the last thing read.
+ */
+export function resolveInstructions(projectDir) {
+  const layers = settingsLayers({ projectDir });
+  const candidates = [
+    ...userCandidates(os.homedir(), layers),
+    ...projectCandidates(projectDir),
+  ];
+  const resolved = finalize(candidates, { projectDir, excludes: readExcludes(layers) });
+
+  // AGENTS.md is read by other tools, not by Claude Code, so one sitting next to
+  // an unrelated CLAUDE.md is a real and easy-to-miss divergence.
+  const agentsFile = path.join(projectDir, 'AGENTS.md');
+  if (fs.existsSync(agentsFile) && !resolved.files.some((item) => item.file === agentsFile)) {
+    resolved.problems.push({ kind: 'agents-md-not-imported', file: agentsFile, scope: 'project' });
+  }
+
+  return resolved;
+}
+
+/**
+ * The user scope on its own: what every session on this machine pays for before a
+ * project is even chosen.
+ *
+ * This is the half of the chain no project owns, so it has nowhere else to be
+ * shown. Resolving it needs no project directory, which is what makes it visible
+ * on a machine where no project path could be recovered from a transcript.
+ *
+ * With no project there is no boundary for an import to resolve outside of, so
+ * nothing is marked external here - that check belongs to the whole-session view.
+ */
+export function resolveGlobalInstructions({ home = os.homedir(), settingsFile = null } = {}) {
+  const layers = settingsLayers(settingsFile ? { settingsFile } : {});
+  const resolved = finalize(userCandidates(home, layers), { projectDir: null, excludes: readExcludes(layers) });
+  resolved.problems.push(...unreferencedUserFiles(home, resolved.files));
+  return resolved;
+}

package/src/model.mjs

@@ -256,6 +256,8 @@ export function listTrash(dir) {
           ...entries.map((e) => e.trashedFile),
           parsed.indexTrashedFile,
           parsed.backupFile,
+          parsed.indexBackupFile,
+          ...(parsed.backups || []).map((b) => b.backupFile),
         ].filter(Boolean);
         return {
           ...parsed,
@@ -263,7 +265,8 @@ export function listTrash(dir) {
           files: entries,
           label: parsed.label || parsed.name || parsed.memoryFile || parsed.id,
           recordFile: name,
-          present: backups.length > 0 && backups.every((f) => fs.existsSync(path.join(trashPath, f))),
+          present: (backups.length > 0 || parsed.indexCreated === true)
+            && backups.every((f) => fs.existsSync(path.join(trashPath, f))),
         };
       } catch {
         return null;