@jkwd/inbase 0.1.19 → 0.1.21

package/README.md

@@ -55,7 +55,7 @@ A normal chat request does not open a session. Use `/inbase` after Setup LLM ses
 
 If several sessions are open, `/inbase` attaches the oldest session that is still waiting. Sessions that already have an LLM are skipped, and the map window does not need to be focused.
 
-Turn on **Make LLM look where I look** if the agent should prefer the island you are standing on and the blocks you are facing. With **Step by step** on, click **Create proposal** to start a step, then **Accept proposal** when the patch is ready. With it off, the LLM implements the full plan; you can still walk Previous/Next over the diffs, then **Accept proposal**. Send an alternative instruction from the HUD to revise the remaining plan, or **Stop** to end the session.
+Turn on **Make LLM look where I look** if the agent should prefer the island you are standing on and the blocks you are facing. With **Step by step** on, click **Create proposal** to start a step, then **Accept proposal** when the patch is ready. With it off, the LLM implements the full plan; you can still walk Previous/Next over the diffs, then **Accept proposal**. Send an alternative instruction from the HUD to update the current proposal, or **Stop** to end the session.
 
 When no LLM is currently making changes, turn on **Show branch changes** (or press **G**) to highlight the current git branch against its base — committed, unstaged, and untracked files — instead of LLM patch files. The control is disabled while an LLM session is writing or reviewing a patch.
 

package/apps/explorer/scripts/patch-lib.d.ts

@@ -124,6 +124,7 @@ export const emptyIntent: {
   blueprintVariables: unknown[]
   blueprintImports: unknown[]
   blueprintNotes: unknown[]
+  blueprintPointers: unknown[]
 }
 
 export function isLastStep(intent: {

package/apps/explorer/scripts/patch-lib.mjs

@@ -551,6 +551,7 @@ export const emptyIntent = {
   blueprintVariables: [],
   blueprintImports: [],
   blueprintNotes: [],
+  blueprintPointers: [],
 }
 
 export function isLastStep(intent) {

package/apps/explorer/scripts/scan-ignore.mjs

@@ -17,9 +17,18 @@ export function toPosix(filePath) {
   return filePath.split(path.sep).join('/')
 }
 
+function isViteDepCache(parts) {
+  const viteAt = parts.indexOf('vite')
+  if (viteAt < 0) return false
+  return parts
+    .slice(viteAt + 1)
+    .some((part) => part === 'deps' || part.startsWith('deps_temp'))
+}
+
 /** True when any path segment is ignored, e.g. apps/web/node_modules/pkg/index.js. */
 export function shouldIgnoreRelativePath(relative) {
   const parts = toPosix(relative).split('/').filter(Boolean)
+  if (isViteDepCache(parts)) return true
   if (
     parts.some(
       (part) =>

package/apps/explorer/scripts/session-store.d.ts

@@ -185,6 +185,7 @@ export type SessionBlueprint = {
   addedVariables: unknown[]
   addedImports: unknown[]
   notes: unknown[]
+  pointers: unknown[]
 }
 export function emptyBlueprint(): SessionBlueprint
 export function readBlueprint(dataDir: string, sessionId?: string): SessionBlueprint
@@ -224,6 +225,7 @@ export function updateBlueprint(
     addedVariables?: unknown[]
     addedImports?: unknown[]
     notes?: unknown[]
+    pointers?: unknown[]
   },
 ): SessionBlueprint
 export function sendBlueprint(
@@ -236,6 +238,7 @@ export function sendBlueprint(
     addedVariables?: unknown[]
     addedImports?: unknown[]
     notes?: unknown[]
+    pointers?: unknown[]
   },
 ): DiffManifest
 export function maybeStartVisualizerHandshake(

package/apps/explorer/scripts/session-store.mjs

@@ -424,7 +424,8 @@ function blueprintHasContent(blueprint) {
     (blueprint.addedFunctions?.length ?? 0) > 0 ||
     (blueprint.addedVariables?.length ?? 0) > 0 ||
     (blueprint.addedImports?.length ?? 0) > 0 ||
-    (blueprint.notes?.length ?? 0) > 0
+    (blueprint.notes?.length ?? 0) > 0 ||
+    (blueprint.pointers?.length ?? 0) > 0
   )
 }
 
@@ -801,6 +802,7 @@ export function sessionIntent(
     blueprintVariables: blueprint.addedVariables,
     blueprintImports: blueprint.addedImports,
     blueprintNotes: blueprint.notes,
+    blueprintPointers: blueprint.pointers,
   }
 }
 
@@ -1020,11 +1022,21 @@ export function autoAdvance(dataDir, sessionId, targetRoot = null) {
     const active = manifest.diffs.at(-1)
     if (!active || active.status !== 'pending') return manifest
     if (active.step >= manifest.steps.length) return manifest
+    if (isRevisedProposal(manifest, active)) return manifest
     return invokeStep(dataDir, sessionId, active.step + 1, targetRoot)
   }
   return manifest
 }
 
+function isRevisedProposal(manifest, active) {
+  return manifest.diffs.some(
+    (entry) =>
+      entry.id !== active.id &&
+      entry.step === active.step &&
+      (entry.status === 'extended' || entry.status === 'extend'),
+  )
+}
+
 export function setStepByStep(dataDir, sessionId, enabled, targetRoot = null) {
   const manifest = requireManifest(dataDir, sessionId)
   manifest.stepByStep = Boolean(enabled)
@@ -1277,6 +1289,7 @@ export function updateBlueprint(dataDir, _sessionId, input = {}) {
     addedVariables: input.addedVariables ?? current.addedVariables,
     addedImports: input.addedImports ?? current.addedImports,
     notes: input.notes ?? current.notes,
+    pointers: input.pointers ?? current.pointers,
   }
   return writeBlueprint(dataDir, next)
 }
@@ -1293,7 +1306,8 @@ export function sendBlueprint(dataDir, sessionId, input = {}) {
     input.addedFunctions ||
     input.addedVariables ||
     input.addedImports ||
-    input.notes
+    input.notes ||
+    input.pointers
   ) {
     updateBlueprint(dataDir, safeId, input)
   }
@@ -1755,6 +1769,7 @@ export function emptyBlueprint() {
     addedVariables: [],
     addedImports: [],
     notes: [],
+    pointers: [],
   }
 }
 
@@ -1849,6 +1864,36 @@ function namedBlueprintNotes(value) {
   return notes
 }
 
+function namedBlueprintPointers(value) {
+  if (!Array.isArray(value)) return []
+  const seen = new Set()
+  const pointers = []
+  for (const item of value) {
+    if (!item || typeof item !== 'object') continue
+    const path = typeof item.path === 'string' ? item.path.trim() : ''
+    if (!path) continue
+    let stored = null
+    if (item.kind === 'file' || item.kind === 'folder') {
+      stored = { kind: item.kind, path }
+    } else if (
+      (item.kind === 'function' || item.kind === 'variable') &&
+      typeof item.name === 'string' &&
+      item.name.trim() !== ''
+    ) {
+      stored = { kind: item.kind, path, name: item.name.trim() }
+    }
+    if (!stored) continue
+    const key =
+      stored.kind === 'file' || stored.kind === 'folder'
+        ? `${stored.kind}:${stored.path}`
+        : `${stored.kind}:${stored.path}:${stored.name}`
+    if (seen.has(key)) continue
+    seen.add(key)
+    pointers.push(stored)
+  }
+  return pointers
+}
+
 function blueprintContentEqual(left, right) {
   return (
     JSON.stringify({
@@ -1858,6 +1903,7 @@ function blueprintContentEqual(left, right) {
       addedVariables: left.addedVariables,
       addedImports: left.addedImports,
       notes: left.notes,
+      pointers: left.pointers,
     }) ===
     JSON.stringify({
       userCreatedBlocks: right.userCreatedBlocks,
@@ -1866,6 +1912,7 @@ function blueprintContentEqual(left, right) {
       addedVariables: right.addedVariables,
       addedImports: right.addedImports,
       notes: right.notes,
+      pointers: right.pointers,
     })
   )
 }
@@ -1877,6 +1924,7 @@ function normalizeBlueprint(value) {
   const addedVariables = namedBlueprintSymbols(value?.addedVariables)
   const addedImports = namedBlueprintImportAdditions(value?.addedImports)
   const notes = namedBlueprintNotes(value?.notes)
+  const pointers = namedBlueprintPointers(value?.pointers)
   const revision =
     Number.isInteger(value?.revision) && value.revision >= 0 ? value.revision : 0
   return {
@@ -1889,6 +1937,7 @@ function normalizeBlueprint(value) {
       addedVariables,
       addedImports,
       notes,
+      pointers,
     }),
     sent: true,
     userCreatedBlocks,
@@ -1897,6 +1946,7 @@ function normalizeBlueprint(value) {
     addedVariables,
     addedImports,
     notes,
+    pointers,
   }
 }
 
@@ -1935,6 +1985,7 @@ export function writeBlueprint(dataDir, sessionIdOrBlueprint, maybeBlueprint) {
         addedVariables: namedBlueprintSymbols(next.addedVariables),
         addedImports: namedBlueprintImportAdditions(next.addedImports),
         notes: namedBlueprintNotes(next.notes),
+        pointers: namedBlueprintPointers(next.pointers),
       },
       null,
       2,
@@ -1973,6 +2024,7 @@ export function cleanupBlueprint(dataDir, knownFileIds = [], knownFolderPaths =
     addedVariables: current.addedVariables.filter((item) => !removedFiles.has(item.file)),
     addedImports: current.addedImports.filter((item) => !removedFiles.has(item.file)),
     notes: current.notes.filter((item) => !removedFiles.has(item.file)),
+    pointers: current.pointers,
   }
   return writeBlueprint(dataDir, next)
 }

package/apps/explorer/src/App.tsx

@@ -29,17 +29,22 @@ import {
 import {
   defaultBlockSpot,
   dropBlueprintFileNotes,
+  dropBlueprintFilePointers,
   dropBlueprintSymbolNote,
+  dropBlueprintSymbolPointer,
+  findBlueprintPointer,
   isBlueprintSymbolName,
   namedCreatedBlocks,
   namedCreatedIslands,
   parseBlueprintImport,
   parseBlueprintNotes,
+  parseBlueprintPointers,
   parseUserCreatedBlocks,
   parseUserCreatedIslands,
   resolveCreatedFile,
   resolveCreatedIsland,
   setBlueprintNote,
+  toggleBlueprintPointer,
   withBlueprintIntent,
   withUserCreatedGraph,
   withUserCreatedLayout,
@@ -51,6 +56,8 @@ import {
   type AimedRelation,
   type BlueprintNote,
   type BlueprintNoteKind,
+  type BlueprintPointer,
+  type BlueprintPointerKind,
   type CodebaseGraph,
   type FlyTo,
   type PatchImportAddition,
@@ -200,6 +207,9 @@ function Explorer({
     PatchImportAddition[]
   >([])
   const [blueprintNotes, setBlueprintNotes] = useState<BlueprintNote[]>([])
+  const [blueprintPointers, setBlueprintPointers] = useState<BlueprintPointer[]>(
+    [],
+  )
   const [blueprintHidden, setBlueprintHidden] = useState(false)
   const userBlocksRef = useRef(userBlocks)
   const userIslandsRef = useRef(userIslands)
@@ -207,6 +217,7 @@ function Explorer({
   const blueprintVariablesRef = useRef(blueprintVariables)
   const blueprintImportsRef = useRef(blueprintImports)
   const blueprintNotesRef = useRef(blueprintNotes)
+  const blueprintPointersRef = useRef(blueprintPointers)
   const notesDirty = useRef(false)
   const blueprintPersistGen = useRef(0)
   const notePersistTimer = useRef<number | null>(null)
@@ -216,6 +227,7 @@ function Explorer({
   blueprintVariablesRef.current = blueprintVariables
   blueprintImportsRef.current = blueprintImports
   blueprintNotesRef.current = blueprintNotes
+  blueprintPointersRef.current = blueprintPointers
   const namingId = userBlocks.find((block) => block.naming)?.id ?? null
   const namingIslandId = userIslands.find((island) => island.naming)?.id ?? null
   const naming = Boolean(namingId || namingIslandId)
@@ -296,11 +308,15 @@ function Explorer({
     for (const item of blueprintVariables) ids.add(item.file)
     for (const item of blueprintImports) ids.add(item.file)
     for (const note of blueprintNotes) ids.add(note.file)
+    for (const pointer of blueprintPointers) {
+      if (pointer.kind !== 'folder') ids.add(pointer.path)
+    }
     return [...ids]
   }, [
     blueprintFunctions,
     blueprintImports,
     blueprintNotes,
+    blueprintPointers,
     blueprintVariables,
     changeSet.creates,
     changeSet.deletes,
@@ -314,8 +330,11 @@ function Explorer({
       if (island.path) paths.add(island.path)
       else if (island.id) paths.add(island.id)
     }
+    for (const pointer of blueprintPointers) {
+      if (pointer.kind === 'folder') paths.add(pointer.path)
+    }
     return [...paths]
-  }, [changeSet.createFolders, userIslands])
+  }, [blueprintPointers, changeSet.createFolders, userIslands])
   const hasChangeSet =
     changeFileIds.length > 0 || changeFolderPaths.length > 0
   const changePathGraph = useMemo(() => {
@@ -511,6 +530,7 @@ function Explorer({
                   addedVariables: blueprintVariables,
                   addedImports: blueprintImports,
                   notes: blueprintNotes,
+                  pointers: blueprintPointers,
                 }
               : {}),
           },
@@ -534,6 +554,7 @@ function Explorer({
       blueprintFunctions,
       blueprintImports,
       blueprintNotes,
+      blueprintPointers,
       blueprintVariables,
       intents,
       onRefreshGraph,
@@ -618,6 +639,7 @@ function Explorer({
       variables: PatchSymbolAddition[] = blueprintVariablesRef.current,
       imports: PatchImportAddition[] = blueprintImportsRef.current,
       notes: BlueprintNote[] = blueprintNotesRef.current,
+      pointers: BlueprintPointer[] = blueprintPointersRef.current,
     ) => {
       if (notePersistTimer.current != null) {
         window.clearTimeout(notePersistTimer.current)
@@ -632,6 +654,7 @@ function Explorer({
         addedVariables: variables,
         addedImports: imports,
         notes,
+        pointers,
       }).finally(() => {
         if (gen !== blueprintPersistGen.current) return
         if (notePersistTimer.current != null) return
@@ -664,6 +687,7 @@ function Explorer({
         addedVariables: blueprintVariablesRef.current,
         addedImports: blueprintImportsRef.current,
         notes: blueprintNotesRef.current,
+        pointers: blueprintPointersRef.current,
       })
       notesDirty.current = false
     }
@@ -684,6 +708,28 @@ function Explorer({
     [persistBlueprintSoon],
   )
 
+  const applyBlueprintPointer = useCallback(
+    (next: {
+      kind: BlueprintPointerKind
+      path: string
+      name?: string
+    }) => {
+      const pointers = toggleBlueprintPointer(blueprintPointersRef.current, next)
+      blueprintPointersRef.current = pointers
+      setBlueprintPointers(pointers)
+      persistBlueprint(
+        userBlocksRef.current,
+        userIslandsRef.current,
+        blueprintFunctionsRef.current,
+        blueprintVariablesRef.current,
+        blueprintImportsRef.current,
+        blueprintNotesRef.current,
+        pointers,
+      )
+    },
+    [persistBlueprint],
+  )
+
   const placeBlock = useCallback(
     (spot: { x: number; z: number; folder: string }) => {
       if (!canPlace) return
@@ -832,10 +878,23 @@ function Explorer({
     if (!selected || selected.naming) return false
     const next = userBlocks.filter((block) => block.id !== selectedId)
     const notes = dropBlueprintFileNotes(blueprintNotesRef.current, [selectedId])
+    const pointers = dropBlueprintFilePointers(blueprintPointersRef.current, [
+      selectedId,
+    ])
     blueprintNotesRef.current = notes
+    blueprintPointersRef.current = pointers
     setUserBlocks(next)
     setBlueprintNotes(notes)
-    persistBlueprint(next, userIslands, undefined, undefined, undefined, notes)
+    setBlueprintPointers(pointers)
+    persistBlueprint(
+      next,
+      userIslands,
+      undefined,
+      undefined,
+      undefined,
+      notes,
+      pointers,
+    )
     setSelectedId(null)
     return true
   }, [canPlace, persistBlueprint, selectedId, userBlocks, userIslands])
@@ -1000,9 +1059,17 @@ function Explorer({
         'function',
         name,
       )
+      const pointers = dropBlueprintSymbolPointer(
+        blueprintPointersRef.current,
+        fileId,
+        'function',
+        name,
+      )
       blueprintNotesRef.current = notes
+      blueprintPointersRef.current = pointers
       setBlueprintFunctions(next)
       setBlueprintNotes(notes)
+      setBlueprintPointers(pointers)
       persistBlueprint(
         userBlocks,
         userIslands,
@@ -1010,6 +1077,7 @@ function Explorer({
         blueprintVariables,
         blueprintImports,
         notes,
+        pointers,
       )
     },
     [
@@ -1035,9 +1103,17 @@ function Explorer({
         'variable',
         name,
       )
+      const pointers = dropBlueprintSymbolPointer(
+        blueprintPointersRef.current,
+        fileId,
+        'variable',
+        name,
+      )
       blueprintNotesRef.current = notes
+      blueprintPointersRef.current = pointers
       setBlueprintVariables(next)
       setBlueprintNotes(notes)
+      setBlueprintPointers(pointers)
       persistBlueprint(
         userBlocks,
         userIslands,
@@ -1045,6 +1121,7 @@ function Explorer({
         next,
         blueprintImports,
         notes,
+        pointers,
       )
     },
     [
@@ -1222,6 +1299,11 @@ function Explorer({
         setBlueprintFunctions(bundle.blueprint.addedFunctions)
         setBlueprintVariables(bundle.blueprint.addedVariables)
         setBlueprintImports(bundle.blueprint.addedImports)
+        if (!notesDirty.current) {
+          const nextPointers = parseBlueprintPointers(bundle.blueprint.pointers)
+          blueprintPointersRef.current = nextPointers
+          setBlueprintPointers(nextPointers)
+        }
         if (!notesDirty.current && !isKeyboardIsolated()) {
           const nextNotes = parseBlueprintNotes(bundle.blueprint.notes)
           blueprintNotesRef.current = nextNotes
@@ -1305,7 +1387,8 @@ function Explorer({
     blueprintFunctions.length > 0 ||
     blueprintVariables.length > 0 ||
     blueprintImports.length > 0 ||
-    blueprintNotes.length > 0
+    blueprintNotes.length > 0 ||
+    blueprintPointers.length > 0
   const blueprintCanCleanup =
     userBlocks.some((block) => !block.naming && knownFileIds.has(block.id)) ||
     userIslands.some(
@@ -1325,7 +1408,9 @@ function Explorer({
     setBlueprintVariables([])
     setBlueprintImports([])
     blueprintNotesRef.current = []
+    blueprintPointersRef.current = []
     setBlueprintNotes([])
+    setBlueprintPointers([])
     void persistBlueprintClear()
   }, [])
 
@@ -1366,6 +1451,13 @@ function Explorer({
           shadows={false}
           dpr={[1, 1.5]}
           gl={{ antialias: true, toneMappingExposure: 1.25 }}
+          onCreated={({ gl }) => {
+            gl.domElement.addEventListener(
+              'webglcontextlost',
+              (event) => event.preventDefault(),
+              { once: false },
+            )
+          }}
           camera={{
             position: layout.spawn,
             fov: 70,
@@ -1412,6 +1504,20 @@ function Explorer({
             userCreatedBlocks={visibleBlocks}
             userCreatedIslands={visibleIslands}
             overlayBlocks={overlayBlocks}
+            pointedFileIds={
+              blueprintHidden
+                ? undefined
+                : blueprintPointers.flatMap((item) =>
+                    item.kind === 'folder' ? [] : [item.path],
+                  )
+            }
+            pointedFolderPaths={
+              blueprintHidden
+                ? undefined
+                : blueprintPointers.flatMap((item) =>
+                    item.kind === 'folder' ? [item.path] : [],
+                  )
+            }
             mapGraph={
               changePathsOnly && hasChangeSet ? changePathGraph : null
             }
@@ -1470,6 +1576,7 @@ function Explorer({
         blueprintVariables={blueprintVariables}
         blueprintImports={blueprintImports}
         blueprintNotes={blueprintNotes}
+        blueprintPointers={blueprintPointers}
         onAddBlueprintFunction={addBlueprintFunction}
         onAddBlueprintVariable={addBlueprintVariable}
         onAddBlueprintImport={addBlueprintImport}
@@ -1477,6 +1584,7 @@ function Explorer({
         onRemoveBlueprintVariable={removeBlueprintVariable}
         onRemoveBlueprintImport={removeBlueprintImport}
         onSetBlueprintNote={applyBlueprintNote}
+        onToggleBlueprintPointer={applyBlueprintPointer}
         onMapAddFile={placeBlockOnFolder}
         onMapAddFolder={placeIslandOnFolder}
         onInspectFile={inspectFile}
@@ -1493,8 +1601,16 @@ function Explorer({
       />
       <MapContextMenu
         menu={mapMenu}
+        pointed={
+          mapMenu
+            ? findBlueprintPointer(blueprintPointers, 'folder', mapMenu.folder)
+            : false
+        }
         onAddFile={placeBlockOnFolder}
         onAddFolder={placeIslandOnFolder}
+        onPointToFolder={(folder) =>
+          applyBlueprintPointer({ kind: 'folder', path: folder })
+        }
         onClose={() => setMapMenu(null)}
       />
     </>

package/apps/explorer/src/agentIntent.ts

@@ -2,6 +2,7 @@ import type {
   AgentIntent,
   AgentIntentBundle,
   BlueprintNote,
+  BlueprintPointer,
   PatchImport,
   PatchImportAddition,
   PatchSymbolAddition,
@@ -11,6 +12,7 @@ import type {
 } from './types'
 import {
   parseBlueprintNotes,
+  parseBlueprintPointers,
   parseUserCreatedBlocks,
   parseUserCreatedIslands,
 } from './userCreated'
@@ -133,6 +135,7 @@ export const emptyIntent: AgentIntent = {
   blueprintVariables: [],
   blueprintImports: [],
   blueprintNotes: [],
+  blueprintPointers: [],
 }
 
 function normalize(data: Partial<AgentIntent> | null | undefined): AgentIntent {
@@ -192,6 +195,7 @@ function normalize(data: Partial<AgentIntent> | null | undefined): AgentIntent {
     blueprintVariables: normalizeSymbolAdditions(data?.blueprintVariables),
     blueprintImports: normalizeImportAdditions(data?.blueprintImports),
     blueprintNotes: parseBlueprintNotes(data?.blueprintNotes),
+    blueprintPointers: parseBlueprintPointers(data?.blueprintPointers),
   }
 }
 
@@ -206,6 +210,7 @@ function normalizeBlueprint(data: Partial<AgentIntentBundle['blueprint']> | null
     addedVariables: normalizeSymbolAdditions(data?.addedVariables),
     addedImports: normalizeImportAdditions(data?.addedImports),
     notes: parseBlueprintNotes(data?.notes),
+    pointers: parseBlueprintPointers(data?.pointers),
   }
 }
 
@@ -256,13 +261,15 @@ export async function fetchAgentIntents(): Promise<AgentIntentBundle> {
         intent.blueprintFunctions.length > 0 ||
         intent.blueprintVariables.length > 0 ||
         intent.blueprintImports.length > 0 ||
-        intent.blueprintNotes.length > 0,
+        intent.blueprintNotes.length > 0 ||
+        intent.blueprintPointers.length > 0,
       userCreatedBlocks: intent.userCreatedBlocks,
       userCreatedIslands: intent.userCreatedIslands,
       addedFunctions: intent.blueprintFunctions,
       addedVariables: intent.blueprintVariables,
       addedImports: intent.blueprintImports,
       notes: intent.blueprintNotes,
+      pointers: intent.blueprintPointers,
     }),
   }
 }
@@ -295,6 +302,7 @@ export async function performAgentAction(
     addedVariables?: PatchSymbolAddition[]
     addedImports?: PatchImportAddition[]
     notes?: BlueprintNote[]
+    pointers?: BlueprintPointer[]
   } = {},
 ) {
   const response = await fetch('/api/agent-intent', {
@@ -318,6 +326,7 @@ export function persistSessionBlueprint(
     addedVariables?: PatchSymbolAddition[]
     addedImports?: PatchImportAddition[]
     notes?: BlueprintNote[]
+    pointers?: BlueprintPointer[]
   },
 ) {
   return fetch('/api/agent-intent', {

package/apps/explorer/src/index.css

@@ -64,6 +64,15 @@ button {
   font-size: 15px;
 }
 
+.canvas-error {
+  position: absolute;
+  inset: 0;
+  z-index: 2;
+  display: grid;
+  place-items: center;
+  background: var(--vc-chrome);
+}
+
 .canvas-error .hud-button {
   margin-top: 12px;
 }

package/apps/explorer/src/scene/FileBlock.tsx

@@ -2,6 +2,7 @@ import { memo, Suspense } from 'react'
 import { Billboard, Edges, Html, Text } from '@react-three/drei'
 import { CHANGE_HIGHLIGHT, CONFIG, dimColor, fileColor, FILE_SELECTION, MAP_SELECTION, type ChangeKind } from '../theme'
 import { NameInput } from '../ui/NameInput'
+import { EyeIcon } from '../ui/EyeIcon'
 import { MapSelectBorder } from './MapSelectBorder'
 import type { FileNode } from '../types'
 import type { PlacedFile } from '../types'
@@ -30,6 +31,7 @@ type FileBlockProps = {
   highlightMapChange?: boolean
   previewLabels?: boolean
   labelVisible?: boolean
+  pointed?: boolean
   onCommitName?: (name: string) => void
   onCancelName?: () => void
 }
@@ -93,6 +95,7 @@ export const FileBlock = memo(function FileBlock({
   highlightMapChange = mapMode,
   previewLabels = false,
   labelVisible = true,
+  pointed = false,
   onCommitName,
   onCancelName,
 }: FileBlockProps) {
@@ -191,6 +194,30 @@ export const FileBlock = memo(function FileBlock({
       {mapMode && !naming && mark && (
         <MapChangeMark mark={mark} width={width} depth={depth} height={height} />
       )}
+      {pointed && !naming && (
+        <Html
+          position={
+            mapMode
+              ? mark
+                ? [width * 0.28, height / 2 + 0.16, -depth * 0.28]
+                : [0, height / 2 + 0.12, 0]
+              : [0, height / 2 + (planned || highlight ? 0.92 : 0.74), 0]
+          }
+          center
+          occlude={false}
+          style={{ pointerEvents: 'none' }}
+          zIndexRange={[40, 0]}
+        >
+          <div
+            className="blueprint-eye"
+            data-map={mapMode ? 'true' : 'false'}
+            role="img"
+            aria-label="Keep in mind"
+          >
+            <EyeIcon size={mapMode ? 16 : 18} title="Keep in mind" />
+          </div>
+        </Html>
+      )}
       {naming && onCommitName && onCancelName && (
         <Html
           position={