@jkwd/inbase 0.1.1 → 0.1.4

package/apps/explorer/src/ui/HUD.tsx

@@ -1,4 +1,4 @@
-import { useEffect, useRef, useState } from 'react'
+import { useEffect, useRef, useState, type ReactNode } from 'react'
 import { NameInput } from './NameInput'
 import {
   isReviewingIntent,
@@ -72,6 +72,25 @@ function PanelList({
   )
 }
 
+function MutationFold({
+  hasContent,
+  children,
+}: {
+  hasContent: boolean
+  children: ReactNode
+}) {
+  if (!hasContent) return null
+  return (
+    <details
+      className="hud-fold"
+      onKeyDown={(event) => event.stopPropagation()}
+    >
+      <summary className="hud-section-title hud-fold-summary">Mutations</summary>
+      {children}
+    </details>
+  )
+}
+
 function AddIntentRow({
   placeholder,
   onAdd,
@@ -109,6 +128,7 @@ type HUDProps = {
   mode: ViewMode
   locked: boolean
   selectedId: string | null
+  selectedTick?: number
   selectedFolder?: string | null
   aimedRelation: AimedRelation | null
   currentFolder: string
@@ -143,6 +163,7 @@ type HUDProps = {
   ) => void
   onMapAddFile?: (folderPath: string) => void
   onMapAddFolder?: (folderPath: string) => void
+  onInspectFile?: (fileId: string) => void
 }
 
 export function HUD({
@@ -150,6 +171,7 @@ export function HUD({
   mode,
   locked,
   selectedId,
+  selectedTick = 0,
   selectedFolder = null,
   aimedRelation,
   currentFolder,
@@ -177,6 +199,7 @@ export function HUD({
   onRemoveBlueprintImport,
   onMapAddFile,
   onMapAddFolder,
+  onInspectFile,
 }: HUDProps) {
   const selected = graph.files.find((file) => file.id === selectedId)
   const selectedFolderNode = graph.folders.find(
@@ -280,6 +303,11 @@ export function HUD({
   const canRunNext =
     Boolean(nextStep) && (planReady || pending) && !working
   const canComplete = pending && lastStep
+  const canInspectFile = (fileId: string, userCreated = false) =>
+    Boolean(onInspectFile) &&
+    !fileId.startsWith('draft:') &&
+    !(previewing && (intent.deletes ?? []).includes(fileId)) &&
+    (!userCreated || (intent.creates ?? []).includes(fileId))
   const panelDone =
     intent.status === 'finished' ||
     intent.status === 'approved' ||
@@ -313,8 +341,8 @@ export function HUD({
   }, [selectedId, selectedFolder])
 
   useEffect(() => {
-    if (sessionMode && selectedId) setInfoVisible(true)
-  }, [selectedId, sessionMode])
+    if (selectedId) setInfoVisible(true)
+  }, [selectedId, selectedTick])
 
   useEffect(() => {
     if (selectedFolder) setInfoVisible(true)
@@ -383,7 +411,7 @@ export function HUD({
                   , <kbd>Space</kbd> place a file, <kbd>B</kbd> place an island
                 </>
               ) : null}
-              , click a block for imports.
+              , click a block for info.
             </p>
           </div>
         </div>
@@ -539,6 +567,7 @@ export function HUD({
                     nextStep?.index === step.index && !doneSteps.has(step.index)
                   }
                 >
+                  <span className="hud-step-index">{step.index}.</span>
                   <span className="hud-step-main">
                     <span className="hud-step-title">{step.title}</span>
                     {((canRunNext && nextStep?.index === step.index) ||
@@ -587,81 +616,91 @@ export function HUD({
               </button>
             </div>
           )}
-          {previewing && intent.files.length > 0 && (
-            <>
-              <div className="hud-section-title hud-section-title-edit">Changed</div>
-              <ul>
-                {intent.files.map((id) => (
-                  <li className="hud-file-edit" key={id}>
-                    {id}
-                  </li>
-                ))}
-              </ul>
-            </>
-          )}
-          {previewing && (intent.createFolders ?? []).length > 0 && (
-            <>
-              <div className="hud-section-title hud-section-title-add">Added islands</div>
-              <ul>
-                {intent.createFolders.map((id) => (
-                  <li className="hud-file-add" key={id}>
-                    {id}/
-                  </li>
-                ))}
-              </ul>
-            </>
-          )}
-          {previewing && intent.creates.length > 0 && (
-            <>
-              <div className="hud-section-title hud-section-title-add">Added</div>
-              <ul>
-                {intent.creates.map((id) => (
-                  <li className="hud-file-add" key={id}>
-                    {id}
-                  </li>
-                ))}
-              </ul>
-            </>
-          )}
-          {previewing && intent.deletes.length > 0 && (
-            <>
-              <div className="hud-section-title hud-section-title-remove">Removed</div>
-              <ul>
-                {intent.deletes.map((id) => (
-                  <li className="hud-file-remove" key={id}>
-                    {id}
-                  </li>
-                ))}
-              </ul>
-            </>
-          )}
-          {previewing && (
-            <>
-              <PanelList
-                title="Functions"
-                items={symbolLabels(addedFunctions)}
-              />
-              <PanelList
-                title="Variables"
-                items={symbolLabels(addedVariables)}
-              />
-            </>
-          )}
-          {previewing && addedImports.length > 0 && (
-            <PanelList title="Imports" items={importLabels(addedImports)} />
-          )}
-          {previewing && addedImports.length === 0 && (intent.imports ?? []).length > 0 && (
-            <>
-              <div className="hud-section-title">Imports</div>
-              <ul>
-                {intent.imports.map((edge) => (
-                  <li key={`${edge.from}->${edge.to}`}>
-                    {edge.from.split('/').pop()} → {edge.to.split('/').pop()}
-                  </li>
-                ))}
-              </ul>
-            </>
-          )}
+          <MutationFold
+            hasContent={
+              previewing &&
+              (intent.files.length > 0 ||
+                (intent.createFolders ?? []).length > 0 ||
+                intent.creates.length > 0 ||
+                intent.deletes.length > 0 ||
+                addedFunctions.length > 0 ||
+                addedVariables.length > 0 ||
+                addedImports.length > 0 ||
+                (intent.imports ?? []).length > 0)
+            }
+          >
+            {intent.files.length > 0 && (
+              <>
+                <div className="hud-section-title hud-section-title-edit">Changed</div>
+                <ul>
+                  {intent.files.map((id) => (
+                    <li className="hud-file-edit" key={id}>
+                      {id}
+                    </li>
+                  ))}
+                </ul>
+              </>
+            )}
+            {(intent.createFolders ?? []).length > 0 && (
+              <>
+                <div className="hud-section-title hud-section-title-add">Added islands</div>
+                <ul>
+                  {intent.createFolders.map((id) => (
+                    <li className="hud-file-add" key={id}>
+                      {id}/
+                    </li>
+                  ))}
+                </ul>
+              </>
+            )}
+            {intent.creates.length > 0 && (
+              <>
+                <div className="hud-section-title hud-section-title-add">Added</div>
+                <ul>
+                  {intent.creates.map((id) => (
+                    <li className="hud-file-add" key={id}>
+                      {id}
+                    </li>
+                  ))}
+                </ul>
+              </>
+            )}
+            {intent.deletes.length > 0 && (
+              <>
+                <div className="hud-section-title hud-section-title-remove">Removed</div>
+                <ul>
+                  {intent.deletes.map((id) => (
+                    <li className="hud-file-remove" key={id}>
+                      {id}
+                    </li>
+                  ))}
+                </ul>
+              </>
+            )}
+            <PanelList
+              title="Functions"
+              items={symbolLabels(addedFunctions)}
+            />
+            <PanelList
+              title="Variables"
+              items={symbolLabels(addedVariables)}
+            />
+            {addedImports.length > 0 && (
+              <PanelList title="Imports" items={importLabels(addedImports)} />
+            )}
+            {addedImports.length === 0 && (intent.imports ?? []).length > 0 && (
+              <>
+                <div className="hud-section-title">Imports</div>
+                <ul>
+                  {intent.imports.map((edge) => (
+                    <li key={`${edge.from}->${edge.to}`}>
+                      {edge.from.split('/').pop()} → {edge.to.split('/').pop()}
+                    </li>
+                  ))}
+                </ul>
+              </>
+            )}
+          </MutationFold>
           {(planReady || preparing) && (
             <div className="hud-decide">
               <button
@@ -727,6 +766,15 @@ export function HUD({
           <p>
             {selected.lines} lines · {selected.language}
           </p>
+          {canInspectFile(selected.id, selected.userCreated) && (
+            <button
+              className="hud-button hud-inspect"
+              type="button"
+              onClick={() => onInspectFile?.(selected.id)}
+            >
+              Inspect file
+            </button>
+          )}
           {selectedClasses.length > 0 && (
             <>
               <div className="hud-section-title">Classes</div>
@@ -925,7 +973,18 @@ export function HUD({
           ) : (
             <ul>
               {folderFiles.map((file) => (
-                <li key={file.id}>{file.path || file.id}</li>
+                <li key={file.id}>
+                  <span>{file.path || file.id}</span>
+                  {canInspectFile(file.id, file.userCreated) && (
+                    <button
+                      className="hud-item-inspect"
+                      type="button"
+                      onClick={() => onInspectFile?.(file.id)}
+                    >
+                      Inspect
+                    </button>
+                  )}
+                </li>
               ))}
             </ul>
           )}
@@ -958,11 +1017,7 @@ export function HUD({
             <>
               <span>Scroll zoom</span>
               <span>Drag pan</span>
-              <span>
-                {sessionMode
-                  ? 'Click a block for info'
-                  : 'Click a block for relations'}
-              </span>
+              <span>Click a block for info</span>
               <span>Click an island for its files</span>
               {creatingBlueprint && (
                 <>
@@ -971,19 +1026,11 @@ export function HUD({
                 </>
               )}
               <span>Click a line to fly there</span>
-              <span>Double-click ground to walk</span>
+              <span>Ctrl-click an island to walk</span>
               {selected?.userCreated && creatingBlueprint && (
                 <span>Backspace delete</span>
               )}
-              <span>
-                {sessionMode
-                  ? infoVisible
-                    ? 'I hide info'
-                    : 'Click a block for info'
-                  : infoVisible
-                    ? 'I hide info'
-                    : 'I show info'}
-              </span>
+              <span>{infoVisible ? 'I hide info' : 'I show info'}</span>
               {infoVisible && <span>↑↓ scroll info</span>}
               <span>
                 {importedBy ? 'K show imports' : 'K show imported by'}
@@ -1004,21 +1051,9 @@ export function HUD({
               {selected?.userCreated && creatingBlueprint && (
                 <span>Backspace delete</span>
               )}
-              <span>
-                {sessionMode
-                  ? 'Click a block for info'
-                  : 'Click block for relations'}
-              </span>
+              <span>Click a block for info</span>
               <span>Aim a line to fly</span>
-              <span>
-                {sessionMode
-                  ? infoVisible
-                    ? 'I hide info'
-                    : 'Click a block for info'
-                  : infoVisible
-                    ? 'I hide info'
-                    : 'I show info'}
-              </span>
+              <span>{infoVisible ? 'I hide info' : 'I show info'}</span>
               {infoVisible && <span>↑↓ scroll info</span>}
               <span>
                 {importedBy ? 'K show imports' : 'K show imported by'}

package/apps/explorer/vite.config.ts

@@ -7,9 +7,11 @@ import { fileURLToPath } from 'node:url'
 import type { IncomingMessage, ServerResponse } from 'node:http'
 import { emptyIntent } from './scripts/patch-lib.mjs'
 import { dataDir, targetRoot } from './scripts/target-config.mjs'
+import { editorFileUri, openInEditor } from './scripts/open-editor.mjs'
 import {
   answerBlueprint,
   continueDiff,
+  inspectTargetFile,
   invokeStep,
   readActiveSession,
   requestReplan,
@@ -105,10 +107,46 @@ function jsonFilePlugin(): Plugin {
 
         next()
       })
+
+      server.middlewares.use('/api/inspect-file', (req, res, next) => {
+        if (req.method === 'POST') {
+          void inspectFile(req, res)
+          return
+        }
+        next()
+      })
     },
   }
 }
 
+async function inspectFile(req: IncomingMessage, res: ServerResponse) {
+  try {
+    const body = JSON.parse(await readBody(req)) as {
+      sessionId?: string
+      diffId?: string
+      fileId?: string
+    }
+    const filePath = inspectTargetFile(dataDir, targetRoot, {
+      sessionId: body.sessionId,
+      diffId: body.diffId,
+      fileId: body.fileId,
+    })
+    if (!filePath) {
+      sendJson(res, 200, { path: null, uri: null, opened: false })
+      return
+    }
+    const opened = openInEditor(filePath)
+    sendJson(res, 200, {
+      path: filePath,
+      uri: editorFileUri(filePath),
+      opened,
+    })
+  } catch (error) {
+    const message = error instanceof Error ? error.message : 'invalid request'
+    sendJson(res, 400, { error: message })
+  }
+}
+
 async function decideIntent(req: IncomingMessage, res: ServerResponse) {
   try {
     const body = JSON.parse(await readBody(req)) as {
@@ -209,7 +247,7 @@ async function decideIntent(req: IncomingMessage, res: ServerResponse) {
         addedImports: body.addedImports,
       })
     } else {
-      stopSession(dataDir, body.sessionId, body.diffId)
+      stopSession(dataDir, body.sessionId, targetRoot)
     }
     const next = sessionIntent(dataDir, body.sessionId, knownFileIds())
     sendJson(res, 200, next ?? { ...emptyIntent })

package/bin/session.mjs

@@ -201,7 +201,7 @@ export async function proposePatch(args) {
 
   if (clear) {
     if (!sessionId) usage('propose-patch', '--session <cursor-chat-id> --clear')
-    store.stopSession(config.dataDir, sessionId)
+    store.stopSession(config.dataDir, sessionId, config.targetRoot)
     console.log(
       `Cleared session ${sessionId}; stored diffs and blueprint drafts were removed.`,
     )

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@jkwd/inbase",
-  "version": "0.1.1",
+  "version": "0.1.4",
   "description": "A first-person 3D map of a codebase, with a visual coding workflow for Cursor.",
   "repository": {
     "type": "git",
@@ -29,6 +29,8 @@
     "apps/explorer/src/scene",
     "apps/explorer/src/ui",
     "apps/explorer/scripts/js-source.mjs",
+    "apps/explorer/scripts/open-editor.d.ts",
+    "apps/explorer/scripts/open-editor.mjs",
     "apps/explorer/scripts/patch-lib.d.ts",
     "apps/explorer/scripts/patch-lib.mjs",
     "apps/explorer/scripts/scan-target.mjs",