@jkwd/inbase 0.1.3 → 0.1.5

package/README.md

@@ -1,4 +1,6 @@
-# Inbase
+<p align="center">
+  <img src="docs/inbase-logo.png" alt="InBase — Dive into your codebase" width="520" />
+</p>
 
 A first-person 3D map of a JavaScript or TypeScript codebase. Files become blocks, folders become walkable areas, and imports become lines in the air.
 

package/apps/explorer/scripts/open-editor.d.ts

@@ -0,0 +1,6 @@
+export function editorFileUri(filePath: string): string
+export function defaultCursorUserDataDir(): string
+export function discoverCursorUserDataDirs(): string[]
+export function openFoldersFromStorage(storage: unknown): string[]
+export function cursorUserDataDirForFile(filePath: string): string | null
+export function openInEditor(filePath: string): boolean

package/apps/explorer/scripts/open-editor.mjs

@@ -0,0 +1,219 @@
+import { spawnSync } from 'node:child_process'
+import fs from 'node:fs'
+import os from 'node:os'
+import path from 'node:path'
+import { fileURLToPath } from 'node:url'
+
+export function editorFileUri(filePath) {
+  return `vscode://file${encodeURI(filePath)}`
+}
+
+function which(command) {
+  const result = spawnSync('which', [command], { encoding: 'utf8' })
+  if (result.error || result.status !== 0) return null
+  return result.stdout.trim().split('\n')[0] || null
+}
+
+export function defaultCursorUserDataDir() {
+  if (process.platform === 'darwin') {
+    return path.join(os.homedir(), 'Library/Application Support/Cursor')
+  }
+  if (process.platform === 'win32') {
+    return path.join(os.homedir(), 'AppData/Roaming/Cursor')
+  }
+  return path.join(os.homedir(), '.config/Cursor')
+}
+
+function expandUser(value) {
+  if (!value) return null
+  const trimmed = String(value).trim().replace(/^['"]|['"]$/g, '')
+  if (!trimmed) return null
+  if (trimmed.startsWith('~')) {
+    return path.resolve(os.homedir() + trimmed.slice(1))
+  }
+  return path.resolve(trimmed)
+}
+
+function isCursorUserDataDir(dir) {
+  try {
+    if (fs.existsSync(path.join(dir, 'User/globalStorage/storage.json'))) return true
+    return fs.readdirSync(dir).some((name) => name.endsWith('-main.sock'))
+  } catch {
+    return false
+  }
+}
+
+function userDataDirFromHook(hook = process.env.VSCODE_IPC_HOOK) {
+  if (!hook || !hook.endsWith('.sock')) return null
+  const dir = path.dirname(hook)
+  return isCursorUserDataDir(dir) ? dir : null
+}
+
+function userDataDirsFromProcessList() {
+  const result = spawnSync('ps', ['-ax', '-o', 'command='], { encoding: 'utf8' })
+  if (result.error || result.status !== 0) return []
+  const dirs = []
+  for (const line of result.stdout.split('\n')) {
+    const match = line.match(/--user-data-dir(?:=|\s+)(\S+)/)
+    if (!match) continue
+    const dir = expandUser(match[1])
+    if (dir && isCursorUserDataDir(dir)) dirs.push(dir)
+  }
+  return dirs
+}
+
+function profileDirsInHome() {
+  let names = []
+  try {
+    names = fs.readdirSync(os.homedir())
+  } catch {
+    return []
+  }
+  return names
+    .filter((name) => name.startsWith('cursor-profile'))
+    .map((name) => path.join(os.homedir(), name))
+    .filter(isCursorUserDataDir)
+}
+
+export function discoverCursorUserDataDirs() {
+  const dirs = new Set()
+  const explicit = expandUser(
+    process.env.INBASE_CURSOR_USER_DATA_DIR || process.env.CURSOR_USER_DATA_DIR,
+  )
+  if (explicit && isCursorUserDataDir(explicit)) dirs.add(explicit)
+  const hookDir = userDataDirFromHook()
+  if (hookDir) dirs.add(hookDir)
+  const def = defaultCursorUserDataDir()
+  if (isCursorUserDataDir(def)) dirs.add(def)
+  for (const dir of profileDirsInHome()) dirs.add(dir)
+  for (const dir of userDataDirsFromProcessList()) dirs.add(dir)
+  return [...dirs]
+}
+
+function folderPathFromUri(value) {
+  if (typeof value !== 'string' || !value) return null
+  try {
+    return value.startsWith('file:') ? fileURLToPath(value) : path.resolve(value)
+  } catch {
+    return null
+  }
+}
+
+function fileIsInside(folder, filePath) {
+  const root = path.resolve(folder)
+  const file = path.resolve(filePath)
+  return file === root || file.startsWith(`${root}${path.sep}`)
+}
+
+export function openFoldersFromStorage(storage) {
+  const state = storage?.windowsState
+  if (!state || typeof state !== 'object') return []
+  const windows = [
+    state.lastActiveWindow,
+    ...(Array.isArray(state.openedWindows) ? state.openedWindows : []),
+  ]
+  const folders = []
+  for (const window of windows) {
+    const folder = folderPathFromUri(window?.folder)
+    if (folder) folders.push(folder)
+  }
+  return folders
+}
+
+function readOpenFolders(userDataDir) {
+  const file = path.join(userDataDir, 'User/globalStorage/storage.json')
+  try {
+    return openFoldersFromStorage(JSON.parse(fs.readFileSync(file, 'utf8')))
+  } catch {
+    return []
+  }
+}
+
+function lastActiveFolder(userDataDir) {
+  const file = path.join(userDataDir, 'User/globalStorage/storage.json')
+  try {
+    const parsed = JSON.parse(fs.readFileSync(file, 'utf8'))
+    return folderPathFromUri(parsed?.windowsState?.lastActiveWindow?.folder)
+  } catch {
+    return null
+  }
+}
+
+export function cursorUserDataDirForFile(filePath) {
+  const explicit = expandUser(
+    process.env.INBASE_CURSOR_USER_DATA_DIR || process.env.CURSOR_USER_DATA_DIR,
+  )
+  if (explicit && isCursorUserDataDir(explicit)) return explicit
+
+  const hookDir = userDataDirFromHook()
+  let best = null
+  let bestScore = 0
+  for (const dir of discoverCursorUserDataDirs()) {
+    const folders = readOpenFolders(dir)
+    if (!folders.some((folder) => fileIsInside(folder, filePath))) continue
+    let score = 1
+    if (hookDir && path.resolve(hookDir) === path.resolve(dir)) score += 2
+    const last = lastActiveFolder(dir)
+    if (last && fileIsInside(last, filePath)) score += 2
+    if (score > bestScore) {
+      best = dir
+      bestScore = score
+    }
+  }
+  return best ?? hookDir
+}
+
+function cursorCliPaths() {
+  const home = os.homedir()
+  const fromEnv =
+    process.env.CURSOR_CLI && fs.existsSync(process.env.CURSOR_CLI)
+      ? process.env.CURSOR_CLI
+      : null
+  return [
+    fromEnv,
+    which('cursor'),
+    '/Applications/Cursor.app/Contents/Resources/app/bin/cursor',
+    path.join(home, '.local/bin/cursor'),
+    '/usr/local/bin/cursor',
+    '/opt/homebrew/bin/cursor',
+  ].filter((candidate, index, list) => {
+    if (!candidate || typeof candidate !== 'string') return false
+    return list.indexOf(candidate) === index
+  })
+}
+
+function editorEnv() {
+  const env = { ...process.env }
+  delete env.ELECTRON_RUN_AS_NODE
+  delete env.ELECTRON_NO_ASAR
+  delete env.CURSOR_AGENT
+  // A second Cursor instance uses its own sockets. Inherited hooks from
+  // another profile would send --goto to the wrong window.
+  delete env.VSCODE_IPC_HOOK
+  delete env.VSCODE_IPC_HOOK_CLI
+  return env
+}
+
+function runEditor(command, args) {
+  if (command.includes(path.sep) && !fs.existsSync(command)) return false
+  const result = spawnSync(command, args, {
+    stdio: 'ignore',
+    env: editorEnv(),
+  })
+  return !result.error && result.status === 0
+}
+
+export function openInEditor(filePath) {
+  const userDataDir = cursorUserDataDirForFile(filePath)
+  const goto = ['--goto', `${filePath}:1`]
+  if (userDataDir) {
+    goto.unshift('--user-data-dir', userDataDir)
+  }
+  for (const command of cursorCliPaths()) {
+    if (runEditor(command, goto)) return true
+  }
+
+  const code = which('code')
+  if (code && runEditor(code, goto)) return true
+  return false
+}

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

@@ -45,10 +45,30 @@ export type DiffManifest = {
 export function assertSessionId(value: unknown): string
 export function readActiveSession(dataDir: string): string | null
 export function writeActiveSession(dataDir: string, sessionId: string | null): void
+export function touchSessionConnection(dataDir: string, sessionId: string): void
+export function isSessionConnected(
+  dataDir: string,
+  sessionId: string,
+  waiterIds?: Set<string>,
+): boolean
+export function listStoredSessionIds(dataDir: string): string[]
+export function listOpenSessionIds(dataDir: string): string[]
+export function discardInactiveDiffSessions(
+  dataDir: string,
+  targetRoot?: string | null,
+  waiterIds?: Iterable<string>,
+): string[]
+export function listSessionIntents(
+  dataDir: string,
+  knownFileIds?: string[],
+): Array<Record<string, unknown>>
 export function readBlueprintSession(dataDir: string): string | null
 export function writeBlueprintSession(dataDir: string, sessionId: string | null): void
 export function readManifest(dataDir: string, sessionId: string): DiffManifest | null
 export function writeManifest(dataDir: string, manifest: DiffManifest): void
+export function isSessionStopped(dataDir: string, sessionId: string): boolean
+export function isWorkflowStopped(dataDir: string, sessionId: string): boolean
+export function sessionStoppedError(sessionId: string): Error
 export function startSession(
   dataDir: string,
   input: {
@@ -119,6 +139,36 @@ export function sessionIntent(
   knownFileIds?: string[],
   selectedDiffId?: string,
 ): Record<string, unknown> | null
+export function resolveTargetFile(
+  targetRoot: string,
+  fileId: string,
+): { id: string; absolute: string }
+export function captureBaseline(
+  dataDir: string,
+  sessionId: string,
+  targetRoot: string,
+  fileIds?: string[],
+): { files: Record<string, { existed: boolean }> }
+export function restoreBaseline(
+  dataDir: string,
+  sessionId: string,
+  targetRoot: string,
+): void
+export function materializeDiff(
+  dataDir: string,
+  targetRoot: string,
+  sessionId: string,
+  diffId?: string | null,
+): DiffManifest
+export function inspectTargetFile(
+  dataDir: string,
+  targetRoot: string,
+  input?: {
+    sessionId?: string | null
+    diffId?: string | null
+    fileId?: string | null
+  },
+): string | null
 export function appendDiff(
   dataDir: string,
   targetRoot: string,
@@ -142,7 +192,7 @@ export function requestReplan(
 export function stopSession(
   dataDir: string,
   sessionId: string,
-  diffId?: string,
+  targetRoot?: string | null,
 ): null
 export function decideDiff(
   dataDir: string,