@jkwd/inbase 0.1.9 → 0.1.11

package/apps/explorer/src/userContext.ts

@@ -38,6 +38,16 @@ export function persistFollowLook(followLook: boolean) {
   })
 }
 
+export function persistShowBranchChanges(showBranchChanges: boolean) {
+  fetch('/api/user-context', {
+    method: 'POST',
+    headers: { 'Content-Type': 'application/json' },
+    body: `${JSON.stringify({ showBranchChanges })}\n`,
+  }).catch(() => {
+    lastWritten = ''
+  })
+}
+
 export function persistUserContext(context: UserContext) {
   pending = context
   if (timer !== null) return
@@ -51,6 +61,7 @@ function flushUserContext() {
   if (!context) return
   const {
     followLook: _followLook,
+    showBranchChanges: _showBranchChanges,
     userCreatedBlocks: _userCreatedBlocks,
     userCreatedIslands: _userCreatedIslands,
     ...gaze

package/apps/explorer/vite.config.ts

@@ -6,6 +6,8 @@ import path from 'node:path'
 import { fileURLToPath } from 'node:url'
 import type { IncomingMessage, ServerResponse } from 'node:http'
 import { emptyIntent } from './scripts/patch-lib.mjs'
+import { readBranchChanges } from './scripts/branch-changes.mjs'
+import { writeRunningInstance } from '../../bin/project.mjs'
 import { dataDir, targetRoot } from './scripts/target-config.mjs'
 import { editorFileUri, openInEditor } from './scripts/open-editor.mjs'
 import {
@@ -19,7 +21,10 @@ import {
   requestReplan,
   sendBlueprint,
   sessionIntent,
+  setInitialInstruction,
   setStepByStep,
+  setupSession,
+  focusSession,
   stopSession,
   updateBlueprint,
 } from './scripts/session-store.mjs'
@@ -84,8 +89,14 @@ function jsonFilePlugin(): Plugin {
   return {
     name: 'visual-coder-json-files',
     configureServer(server) {
+      writeRunningInstance({
+        dataDir,
+        targetRoot,
+        port: server.config.server.port ?? 5173,
+      })
+      // Always boot with no LLM session. Leftover diffs and pointers are not restored.
       clearDiffSessions(dataDir, targetRoot)
-      rescanTarget('after clearing diff sessions')
+      rescanTarget('after discarding leftover LLM sessions')
       server.middlewares.use('/api/user-context', (req, res, next) => {
         if (req.method === 'GET') {
           sendJson(res, 200, readUserContext())
@@ -144,6 +155,14 @@ function jsonFilePlugin(): Plugin {
         next()
       })
 
+      server.middlewares.use('/api/branch-changes', (req, res, next) => {
+        if (req.method === 'GET') {
+          sendJson(res, 200, readBranchChanges(targetRoot, knownFileIds()))
+          return
+        }
+        next()
+      })
+
       server.middlewares.use('/api/inspect-file', (req, res, next) => {
         if (req.method === 'POST') {
           void inspectFile(req, res)
@@ -190,6 +209,7 @@ async function decideIntent(req: IncomingMessage, res: ServerResponse) {
       sessionId?: string
       diffId?: string
       instruction?: string
+      name?: string
       step?: number
       stepByStep?: boolean
       userCreatedBlocks?: unknown[]
@@ -208,12 +228,15 @@ async function decideIntent(req: IncomingMessage, res: ServerResponse) {
       action !== 'blueprint_no' &&
       action !== 'blueprint_send' &&
       action !== 'blueprint_update' &&
-      action !== 'set_step_by_step'
+      action !== 'focus' &&
+      action !== 'set_step_by_step' &&
+      action !== 'set_initial_instruction' &&
+      action !== 'setup_session'
     ) {
       sendJson(res, 400, { error: 'invalid workflow action' })
       return
     }
-    if (!body.sessionId) {
+    if (action !== 'setup_session' && !body.sessionId) {
       sendJson(res, 400, { error: 'sessionId is required' })
       return
     }
@@ -225,13 +248,20 @@ async function decideIntent(req: IncomingMessage, res: ServerResponse) {
       return
     }
 
+    if (
+      body.name !== undefined &&
+      (typeof body.name !== 'string' || body.name.length > 200)
+    ) {
+      sendJson(res, 400, { error: 'name must be a string up to 200 characters' })
+      return
+    }
+
     if (action === 'invoke') {
       if (!Number.isInteger(body.step)) {
         sendJson(res, 400, { error: 'step is required for invoke' })
         return
       }
       invokeStep(dataDir, body.sessionId, body.step as number, targetRoot)
-      rescanTarget('after invoking step')
     } else if (action === 'continue') {
       if (!body.diffId) {
         sendJson(res, 400, { error: 'diffId is required for continue' })
@@ -249,7 +279,9 @@ async function decideIntent(req: IncomingMessage, res: ServerResponse) {
         body.sessionId,
         body.diffId,
         body.instruction ?? '',
+        targetRoot,
       )
+      rescanTarget('after withdrawing a patch')
     } else if (action === 'blueprint_yes') {
       answerBlueprint(dataDir, body.sessionId, true)
     } else if (action === 'blueprint_no') {
@@ -270,6 +302,18 @@ async function decideIntent(req: IncomingMessage, res: ServerResponse) {
         addedVariables: body.addedVariables,
         addedImports: body.addedImports,
       })
+    } else if (action === 'setup_session') {
+      const manifest = setupSession(dataDir, {
+        sessionId: body.sessionId,
+        name: body.name,
+      })
+      const next = sessionIntent(dataDir, manifest.sessionId, knownFileIds())
+      sendJson(res, 200, next ?? { ...emptyIntent })
+      return
+    } else if (action === 'set_initial_instruction') {
+      setInitialInstruction(dataDir, body.sessionId, body.instruction ?? '')
+    } else if (action === 'focus') {
+      focusSession(dataDir, body.sessionId)
     } else if (action === 'set_step_by_step') {
       if (typeof body.stepByStep !== 'boolean') {
         sendJson(res, 400, { error: 'stepByStep is required' })
@@ -324,9 +368,10 @@ function readUserContext() {
     return {
       ...parsed,
       followLook: Boolean(parsed.followLook),
+      showBranchChanges: Boolean(parsed.showBranchChanges),
     }
   } catch {
-    return { followLook: false }
+    return { followLook: false, showBranchChanges: false }
   }
 }
 
@@ -341,6 +386,10 @@ async function writeUserContext(req: IncomingMessage, res: ServerResponse) {
         typeof incoming.followLook === 'boolean'
           ? incoming.followLook
           : Boolean(existing.followLook),
+      showBranchChanges:
+        typeof incoming.showBranchChanges === 'boolean'
+          ? incoming.showBranchChanges
+          : Boolean(existing.showBranchChanges),
     }
     delete next.userCreatedBlocks
     delete next.userCreatedIslands
@@ -354,10 +403,21 @@ async function writeUserContext(req: IncomingMessage, res: ServerResponse) {
   }
 }
 
+function isDataDirPath(filePath: string) {
+  const file = path.resolve(filePath)
+  const root = path.resolve(dataDir)
+  return file === root || file.startsWith(root + path.sep)
+}
+
 export default defineConfig({
   plugins: [react(), jsonFilePlugin()],
   server: {
     port: 5173,
+    watch: {
+      // Session snapshots copy target source into the data dir. If Vite
+      // watches those writes, Create proposal full-reloads the visualizer.
+      ignored: ['**/src/data/**', isDataDirPath],
+    },
     fs: {
       allow: [here, dataDir],
     },

package/bin/inbase.mjs

@@ -10,12 +10,14 @@ import {
   ensureGitignoreEntry,
   explorerRoot,
   skillTemplateDir,
+  commandTemplateDir,
   takeFlagValue,
 } from './project.mjs'
 import {
   proposePatch,
   reportPlan,
   startSession,
+  attachSession,
   waitForApproval,
   waitForBlueprint,
 } from './session.mjs'
@@ -28,11 +30,12 @@ Usage:
   inbase help              Show this help
 
 Agent commands (used by the Cursor skill):
-  inbase start-session --session <id> [--feature "name"]
+  inbase start-session --session <id> --name "short name"
+  inbase attach [--session <id>]
   inbase wait-for-blueprint --session <id>
   inbase report-plan --session <id> --feature "name" --steps "one" [--steps "two"]
   inbase wait-for-approval --session <id>
-  inbase propose-patch --session <id> <file.patch|->
+  inbase propose-patch --session <id> [file.patch|-]
   inbase propose-patch --session <id> --clear
 
 Options for run:
@@ -50,6 +53,10 @@ export function initProject(projectRoot = process.cwd()) {
   }
   const skillDir = path.join(projectRoot, '.cursor/skills/inbase')
   copyDir(skillTemplateDir, skillDir)
+  const commandDir = path.join(projectRoot, '.cursor/commands')
+  if (fs.existsSync(commandTemplateDir)) {
+    copyDir(commandTemplateDir, commandDir)
+  }
   const { dataDir } = applyHostEnv({
     cwd: projectRoot,
     target: projectRoot,
@@ -57,7 +64,7 @@ export function initProject(projectRoot = process.cwd()) {
   })
   ensureDataDir(dataDir)
   const gitignoreAdded = ensureGitignoreEntry(projectRoot)
-  return { skillDir, dataDir, gitignoreAdded }
+  return { skillDir, commandDir, dataDir, gitignoreAdded }
 }
 
 function explorerHref(relative) {
@@ -122,6 +129,9 @@ export async function main(argv = process.argv.slice(2)) {
   if (command === 'init') {
     const result = initProject()
     console.log(`Installed Cursor skill at ${result.skillDir}`)
+    if (fs.existsSync(path.join(result.commandDir, 'inbase.md'))) {
+      console.log(`Installed /inbase command at ${result.commandDir}`)
+    }
     if (result.gitignoreAdded) console.log('Added .inbase/ to .gitignore')
     console.log('Next: run `inbase run`, then ask Cursor to change source files.')
     return
@@ -132,13 +142,22 @@ export async function main(argv = process.argv.slice(2)) {
     return
   }
 
-  applyHostEnv()
+  const host = applyHostEnv()
   ensureDataDir(process.env.INBASE_DATA_DIR)
+  if (host.instance) {
+    console.log(
+      `INBASE_ATTACHED Using the running visualizer (${host.instance.dataDir}). Run wait-for-blueprint to read the optional blueprint; it does not wait.`,
+    )
+  }
 
   if (command === 'start-session') {
     await startSession(args)
     return
   }
+  if (command === 'attach') {
+    await attachSession(args)
+    return
+  }
   if (command === 'wait-for-blueprint') {
     await waitForBlueprint(args)
     return

package/bin/project.mjs

@@ -6,6 +6,7 @@ const here = path.dirname(fileURLToPath(import.meta.url))
 export const packageRoot = path.resolve(here, '..')
 export const explorerRoot = path.join(packageRoot, 'apps/explorer')
 export const skillTemplateDir = path.join(packageRoot, 'skill/inbase')
+export const commandTemplateDir = path.join(packageRoot, 'skill/commands')
 
 export function resolveOptionalPath(value, fallback) {
   const raw = value?.trim()
@@ -13,19 +14,76 @@ export function resolveOptionalPath(value, fallback) {
   return path.isAbsolute(raw) ? path.normalize(raw) : path.resolve(process.cwd(), raw)
 }
 
+export const INSTANCE_FILE = 'instance.json'
+
+function isPidAlive(pid) {
+  if (!Number.isInteger(pid)) return true
+  try {
+    process.kill(pid, 0)
+    return true
+  } catch {
+    return false
+  }
+}
+
+export function instanceFile(dataDir) {
+  return path.join(dataDir, INSTANCE_FILE)
+}
+
+export function writeRunningInstance({ dataDir, targetRoot, port = null }) {
+  fs.mkdirSync(dataDir, { recursive: true })
+  const instance = {
+    dataDir: path.resolve(dataDir),
+    targetRoot: path.resolve(targetRoot),
+    port: port ?? null,
+    pid: process.pid,
+    updatedAt: new Date().toISOString(),
+  }
+  fs.writeFileSync(instanceFile(dataDir), `${JSON.stringify(instance, null, 2)}\n`)
+  return instance
+}
+
+export function readInstanceFile(file) {
+  try {
+    const parsed = JSON.parse(fs.readFileSync(file, 'utf8'))
+    if (!parsed?.dataDir || !parsed?.targetRoot) return null
+    if (!isPidAlive(parsed.pid)) return null
+    return parsed
+  } catch {
+    return null
+  }
+}
+
+export function readRunningInstance(cwd = process.cwd()) {
+  const files = [
+    path.join(cwd, '.inbase', INSTANCE_FILE),
+    path.join(explorerRoot, 'src/data', INSTANCE_FILE),
+  ]
+  const seen = new Set()
+  for (const file of files) {
+    const resolved = path.resolve(file)
+    if (seen.has(resolved) || !fs.existsSync(resolved)) continue
+    seen.add(resolved)
+    const instance = readInstanceFile(resolved)
+    if (instance) return instance
+  }
+  return null
+}
+
 export function applyHostEnv({
   cwd = process.cwd(),
   target = process.env.VISUAL_CODER_TARGET,
   dataDir = process.env.INBASE_DATA_DIR,
 } = {}) {
-  const targetRoot = resolveOptionalPath(target, cwd)
+  const running = !target && !dataDir ? readRunningInstance(cwd) : null
+  const targetRoot = resolveOptionalPath(target, running?.targetRoot ?? cwd)
   const resolvedDataDir = resolveOptionalPath(
     dataDir,
-    path.join(targetRoot, '.inbase'),
+    running?.dataDir ?? path.join(targetRoot, '.inbase'),
   )
   process.env.VISUAL_CODER_TARGET = targetRoot
   process.env.INBASE_DATA_DIR = resolvedDataDir
-  return { cwd, targetRoot, dataDir: resolvedDataDir }
+  return { cwd, targetRoot, dataDir: resolvedDataDir, instance: running }
 }
 
 export function ensureDataDir(dataDir) {
@@ -34,7 +92,7 @@ export function ensureDataDir(dataDir) {
   if (!fs.existsSync(userContextFile)) {
     fs.writeFileSync(
       userContextFile,
-      `${JSON.stringify({ followLook: false }, null, 2)}\n`,
+      `${JSON.stringify({ followLook: false, showBranchChanges: false }, null, 2)}\n`,
     )
   }
   return dataDir