@jkwd/inbase 0.1.3 → 0.1.5

package/apps/explorer/vite.config.ts

@@ -7,10 +7,14 @@ 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,
+  discardInactiveDiffSessions,
+  inspectTargetFile,
   invokeStep,
+  listSessionIntents,
   readActiveSession,
   requestReplan,
   sendBlueprint,
@@ -43,6 +47,17 @@ function readBody(req: IncomingMessage) {
   })
 }
 
+function rescanTarget(when: string) {
+  const scan = spawnSync(process.execPath, [scanScript], {
+    cwd: here,
+    encoding: 'utf8',
+    env: scanEnv,
+  })
+  if (scan.status !== 0) {
+    console.error(scan.stderr || scan.stdout || `scan failed ${when}`)
+  }
+}
+
 function knownFileIds() {
   try {
     const graph = JSON.parse(fs.readFileSync(codebaseFile, 'utf8')) as {
@@ -66,6 +81,8 @@ function jsonFilePlugin(): Plugin {
   return {
     name: 'visual-coder-json-files',
     configureServer(server) {
+      discardInactiveDiffSessions(dataDir, targetRoot)
+      rescanTarget('after discarding inactive sessions')
       server.middlewares.use('/api/user-context', (req, res, next) => {
         if (req.method === 'GET') {
           sendJson(res, 200, readUserContext())
@@ -89,12 +106,22 @@ function jsonFilePlugin(): Plugin {
       server.middlewares.use('/api/agent-intent', (req, res, next) => {
         if (req.method === 'GET') {
           const url = new URL(req.url ?? '/', 'http://visual-coder.local')
-          const sessionId = url.searchParams.get('sessionId') ?? readActiveSession(dataDir)
+          const sessionId = url.searchParams.get('sessionId')
           const diffId = url.searchParams.get('diffId') ?? undefined
-          const intent = sessionId
-            ? sessionIntent(dataDir, sessionId, knownFileIds(), diffId)
-            : null
-          sendJson(res, 200, intent ?? { ...emptyIntent })
+          if (sessionId) {
+            const intent = sessionIntent(
+              dataDir,
+              sessionId,
+              knownFileIds(),
+              diffId,
+            )
+            sendJson(res, 200, intent ?? { ...emptyIntent })
+            return
+          }
+          sendJson(res, 200, {
+            focusedSessionId: readActiveSession(dataDir),
+            intents: listSessionIntents(dataDir, knownFileIds()),
+          })
           return
         }
 
@@ -105,10 +132,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 {
@@ -155,28 +218,14 @@ async function decideIntent(req: IncomingMessage, res: ServerResponse) {
         return
       }
       invokeStep(dataDir, body.sessionId, body.step as number, targetRoot)
-      const scan = spawnSync(process.execPath, [scanScript], {
-        cwd: here,
-        encoding: 'utf8',
-        env: scanEnv,
-      })
-      if (scan.status !== 0) {
-        console.error(scan.stderr || scan.stdout || 'scan failed after invoking step')
-      }
+      rescanTarget('after invoking step')
     } else if (action === 'continue') {
       if (!body.diffId) {
         sendJson(res, 400, { error: 'diffId is required for continue' })
         return
       }
       continueDiff(dataDir, targetRoot, body.sessionId, body.diffId)
-      const scan = spawnSync(process.execPath, [scanScript], {
-        cwd: here,
-        encoding: 'utf8',
-        env: scanEnv,
-      })
-      if (scan.status !== 0) {
-        console.error(scan.stderr || scan.stdout || 'scan failed after applying patch')
-      }
+      rescanTarget('after applying patch')
     } else if (action === 'instruct') {
       if (!body.diffId) {
         sendJson(res, 400, { error: 'diffId is required for instruct' })
@@ -209,7 +258,8 @@ async function decideIntent(req: IncomingMessage, res: ServerResponse) {
         addedImports: body.addedImports,
       })
     } else {
-      stopSession(dataDir, body.sessionId, body.diffId)
+      stopSession(dataDir, body.sessionId, targetRoot)
+      rescanTarget('after stopping session')
     }
     const next = sessionIntent(dataDir, body.sessionId, knownFileIds())
     sendJson(res, 200, next ?? { ...emptyIntent })

package/bin/session.mjs

@@ -52,6 +52,12 @@ export async function waitForBlueprint(args) {
 
   const started = Date.now()
   const initial = store.readManifest(config.dataDir, sessionId)
+  if (store.isWorkflowStopped(config.dataDir, sessionId)) {
+    console.error(
+      'VISUAL_CODER_STOPPED The workflow was stopped. Do not modify project files.',
+    )
+    process.exit(2)
+  }
   if (!initial) {
     console.error(`No workflow session found for ${sessionId}`)
     process.exit(1)
@@ -68,6 +74,7 @@ export async function waitForBlueprint(args) {
   }
 
   while (Date.now() - started < timeoutMs) {
+    store.touchSessionConnection(config.dataDir, sessionId)
     const manifest = store.readManifest(config.dataDir, sessionId)
     if (!manifest || manifest.phase === 'stopped') {
       console.error(
@@ -81,7 +88,7 @@ export async function waitForBlueprint(args) {
       const islands = blueprint.userCreatedIslands ?? []
       console.log(
         blueprint.enabled
-          ? `VISUAL_CODER_BLUEPRINT_READY The user sent ${blocks.length} file(s) and ${islands.length} island(s) for this chat. Create those paths in the plan even if they are not on disk.`
+          ? `VISUAL_CODER_BLUEPRINT_READY The user sent ${blocks.length} file(s) and ${islands.length} island(s) for this chat. The blueprint is leading: create those paths and honor addedFunctions, addedVariables, and addedImports even if they are not on disk. Do not omit, rename, relocate, or replace them. Extra new files not in the blueprint are a deviation. If you would differ from the blueprint, ask the user first; do not silently deviate.`
           : 'VISUAL_CODER_BLUEPRINT_READY The user skipped the blueprint. Continue without user-placed files or islands.',
       )
       console.log('VISUAL_CODER_BLUEPRINT_START')
@@ -131,6 +138,12 @@ export async function waitForApproval(args) {
   const started = Date.now()
   const initial = store.readManifest(config.dataDir, sessionId)
   const initialDiff = initial?.diffs?.at(-1)
+  if (store.isWorkflowStopped(config.dataDir, sessionId)) {
+    console.error(
+      'VISUAL_CODER_STOPPED The workflow was stopped. Do not modify project files.',
+    )
+    process.exit(2)
+  }
   if (!initial) {
     console.error(`No workflow session found for ${sessionId}`)
     process.exit(1)
@@ -144,6 +157,7 @@ export async function waitForApproval(args) {
   )
 
   while (Date.now() - started < timeoutMs) {
+    store.touchSessionConnection(config.dataDir, sessionId)
     const manifest = store.readManifest(config.dataDir, sessionId)
     if (!manifest) {
       console.error(
@@ -173,7 +187,7 @@ export async function waitForApproval(args) {
         ? `\nVISUAL_CODER_INSTRUCTION_START\n${manifest.pendingInstruction}\nVISUAL_CODER_INSTRUCTION_END`
         : ''
       console.log(
-        `VISUAL_CODER_REPLAN Keep accepted steps before step ${manifest.currentStep}. Replace the plan from step ${manifest.currentStep} onward using the instruction below. Report the revised tail with inbase report-plan, then wait for invocation.${instruction}`,
+        `VISUAL_CODER_REPLAN Keep accepted steps before step ${manifest.currentStep}. Replace the plan from step ${manifest.currentStep} onward using the instruction below. The session blueprint remains leading; if this instruction would differ from it, ask the user before replacing the plan. Report the revised tail with inbase report-plan, then wait for invocation.${instruction}`,
       )
       process.exit(4)
     }
@@ -201,7 +215,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.3",
+  "version": "0.1.5",
   "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",

package/skill/inbase/SKILL.md

@@ -48,12 +48,17 @@ npx inbase wait-for-blueprint --session "<current-cursor-chat-id>"
 3. Read the handshake output between `VISUAL_CODER_BLUEPRINT_START` and
    `VISUAL_CODER_BLUEPRINT_END`, or read
    `.inbase/diff-sessions/<session-id>/blueprint.json`.
-   If `enabled` is true, always create `userCreatedBlocks` and
-   `userCreatedIslands` at the given path/folder. Those files and folders do
-   not exist on disk yet. They belong to this chat only.
-   Also honor `addedFunctions`, `addedVariables`, and `addedImports`: add those
-   symbols and imports to the named files. They are blueprint intentions, not
-   files that already exist on disk.
+   If `enabled` is true, **the blueprint is leading**. Treat
+   `userCreatedBlocks`, `userCreatedIslands`, `addedFunctions`,
+   `addedVariables`, and `addedImports` as the source of truth for this chat.
+   Create those paths and add those symbols even if they are not on disk.
+   They belong to this chat only.
+   Do not omit, rename, relocate, or replace a blueprint file, island, symbol,
+   or import. Extra edits to existing files are allowed when needed to finish
+   the feature. Extra new files that are not in the blueprint are a deviation.
+   If the user request, viewpoint, a later instruction, or your own plan would
+   differ from the blueprint, **stop and ask the user in chat** before
+   reporting the plan. Do not silently deviate.
 4. Read `.inbase/user-context.json` for viewpoint only.
 5. Use the user's viewpoint only when `followLook` is true:
    - `island` is where they are standing
@@ -62,8 +67,8 @@ npx inbase wait-for-blueprint --session "<current-cursor-chat-id>"
    - `filesOnIsland` is the rest of that folder
    Prefer those files while `followLook` is true, unless the request clearly
    needs something else. If `followLook` is false or missing, ignore viewpoint
-   and choose files from the request itself. Still include this session's
-   blueprint files and islands when `enabled` is true.
+   and choose files from the request itself. Viewpoint never overrides the
+   blueprint: still follow this session's blueprint when `enabled` is true.
 6. List **all** steps needed to finish the feature. Keep steps small enough that
    one patch is one landscape change (usually one new file, or a few related
    edits).
@@ -136,10 +141,12 @@ npx inbase wait-for-approval --session "<current-cursor-chat-id>"
      an earlier diff. Follow the text between
      `VISUAL_CODER_INSTRUCTION_START` and `VISUAL_CODER_INSTRUCTION_END`, read
      this session's `blueprint.json` when it is enabled (files, islands,
-     `addedFunctions`, `addedVariables`, `addedImports`), read
-     `user-context.json` (follow the viewpoint only if `followLook` is true),
-     replace the plan from the current step onward using `inbase report-plan`,
-     then wait for the user to invoke the first revised step.
+     `addedFunctions`, `addedVariables`, `addedImports`). The blueprint stays
+     leading. If the new instruction would differ from it, ask the user before
+     replacing the plan. Read `user-context.json` (follow the viewpoint only if
+     `followLook` is true), replace the plan from the current step onward using
+     `inbase report-plan`, then wait for the user to invoke the first revised
+     step.
    - Exit `2` (`VISUAL_CODER_STOPPED`) or `3` (timeout): make no further
      project changes.
 
@@ -154,8 +161,9 @@ npx inbase propose-patch --session "<current-cursor-chat-id>" --clear
 
 - Skip `inbase start-session` once this skill applies
 - Skip `inbase wait-for-blueprint` or report a plan before `VISUAL_CODER_BLUEPRINT_READY`
-- Skip this session's `blueprint.json` `userCreatedBlocks` or `userCreatedIslands` when `enabled` is true
-- Skip `addedFunctions`, `addedVariables`, or `addedImports` from that blueprint when `enabled` is true
+- Treat the chat request, viewpoint, or your own plan as overriding an enabled blueprint
+- Skip, rename, relocate, or replace this session's `blueprint.json` files, islands, functions, variables, or imports when `enabled` is true
+- Silently differ from the blueprint; ask the user first
 - Read global `user-context.json` for placed files; those live on the session blueprint
 - Follow the user's look when `followLook` is false
 - Write, edit, create, or delete project files directly