@jkwd/inbase 0.1.13 → 0.1.16

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

@@ -1,5 +1,6 @@
 import { useEffect } from 'react'
 import { createPortal } from 'react-dom'
+import { shouldIgnoreShortcut } from '../keyboard'
 
 export type MapContextMenuState = {
   x: number
@@ -24,6 +25,7 @@ export function MapContextMenu({
     if (!menu) return
     const onKey = (event: KeyboardEvent) => {
       if (event.code !== 'Escape') return
+      if (shouldIgnoreShortcut(event)) return
       event.preventDefault()
       onClose()
     }

package/apps/explorer/src/userCreated.ts

@@ -1,6 +1,8 @@
 import { CONFIG, fileHeight } from './theme'
 import { folderOfFile, folderParent } from './layout'
 import type {
+  BlueprintNote,
+  BlueprintNoteKind,
   CodebaseGraph,
   FileNode,
   PatchImportAddition,
@@ -339,6 +341,102 @@ export function isBlueprintSymbolName(value: string) {
   return /^[A-Za-z_$][\w$]*$/.test(value.trim())
 }
 
+export function blueprintNoteKey(
+  note: Pick<BlueprintNote, 'file' | 'kind' | 'name'>,
+) {
+  return note.kind === 'file'
+    ? `file:${note.file}`
+    : `${note.kind}:${note.file}:${note.name ?? ''}`
+}
+
+function parseBlueprintNote(value: unknown): BlueprintNote | null {
+  if (!value || typeof value !== 'object') return null
+  const item = value as Partial<BlueprintNote>
+  const file = typeof item.file === 'string' ? item.file.trim() : ''
+  const note = typeof item.note === 'string' ? item.note : ''
+  if (!file || !note.trim()) return null
+  if (item.kind === 'file') return { file, kind: 'file', note }
+  if (item.kind !== 'function' && item.kind !== 'variable') return null
+  const name = typeof item.name === 'string' ? item.name.trim() : ''
+  if (!name) return null
+  return { file, kind: item.kind, name, note }
+}
+
+export function parseBlueprintNotes(value: unknown): BlueprintNote[] {
+  if (!Array.isArray(value)) return []
+  const seen = new Set<string>()
+  const notes: BlueprintNote[] = []
+  for (const item of value) {
+    const parsed = parseBlueprintNote(item)
+    if (!parsed) continue
+    const key = blueprintNoteKey(parsed)
+    if (seen.has(key)) continue
+    seen.add(key)
+    notes.push(parsed)
+  }
+  return notes
+}
+
+export function findBlueprintNote(
+  notes: BlueprintNote[],
+  file: string,
+  kind: BlueprintNoteKind,
+  name?: string,
+) {
+  return (
+    notes.find((item) =>
+      kind === 'file'
+        ? item.kind === 'file' && item.file === file
+        : item.kind === kind && item.file === file && item.name === name,
+    )?.note ?? ''
+  )
+}
+
+export function setBlueprintNote(
+  notes: BlueprintNote[],
+  next: {
+    file: string
+    kind: BlueprintNoteKind
+    name?: string
+    note: string
+  },
+): BlueprintNote[] {
+  const key = blueprintNoteKey(next)
+  const without = notes.filter((item) => blueprintNoteKey(item) !== key)
+  if (next.note === '') return without
+  const stored: BlueprintNote =
+    next.kind === 'file'
+      ? { file: next.file, kind: 'file', note: next.note }
+      : {
+          file: next.file,
+          kind: next.kind,
+          name: (next.name ?? '').trim(),
+          note: next.note,
+        }
+  if (stored.kind !== 'file' && !stored.name) return without
+  return [...without, stored]
+}
+
+export function dropBlueprintFileNotes(
+  notes: BlueprintNote[],
+  fileIds: Iterable<string>,
+) {
+  const removed = new Set(fileIds)
+  return notes.filter((item) => !removed.has(item.file))
+}
+
+export function dropBlueprintSymbolNote(
+  notes: BlueprintNote[],
+  file: string,
+  kind: 'function' | 'variable',
+  name: string,
+) {
+  return notes.filter(
+    (item) =>
+      !(item.file === file && item.kind === kind && item.name === name),
+  )
+}
+
 export function parseBlueprintImport(
   raw: string,
   file: string,

package/apps/explorer/vite.config.ts

@@ -28,6 +28,10 @@ import {
   focusSession,
   stopSession,
   updateBlueprint,
+  readBlueprint,
+  setBlueprintHidden,
+  clearBlueprint,
+  cleanupBlueprint,
 } from './scripts/session-store.mjs'
 
 const here = path.dirname(fileURLToPath(import.meta.url))
@@ -80,6 +84,44 @@ function knownFileIds() {
   }
 }
 
+function knownFolderPaths() {
+  try {
+    const graph = JSON.parse(fs.readFileSync(codebaseFile, 'utf8')) as {
+      folders?: Array<{ path?: string }>
+    }
+    return Array.isArray(graph.folders)
+      ? graph.folders
+          .map((folder) => folder.path)
+          .filter((path): path is string => Boolean(path))
+      : []
+  } catch {
+    return []
+  }
+}
+
+function blueprintIntentFields() {
+  const blueprint = readBlueprint(dataDir)
+  return {
+    creationMode: true,
+    blueprintHidden: Boolean(blueprint.hidden),
+    blueprintRevision: blueprint.revision,
+    userCreatedBlocks: blueprint.userCreatedBlocks,
+    userCreatedIslands: blueprint.userCreatedIslands,
+    blueprintFunctions: blueprint.addedFunctions,
+    blueprintVariables: blueprint.addedVariables,
+    blueprintImports: blueprint.addedImports,
+    blueprintNotes: blueprint.notes,
+  }
+}
+
+function intentResponse(sessionId?: string) {
+  const base =
+    sessionId !== undefined && sessionId !== ''
+      ? (sessionIntent(dataDir, sessionId, knownFileIds()) ?? { ...emptyIntent })
+      : { ...emptyIntent }
+  return { ...base, ...blueprintIntentFields() }
+}
+
 function sendJson(res: ServerResponse, status: number, body: unknown) {
   res.statusCode = status
   res.setHeader('Content-Type', 'application/json')
@@ -145,6 +187,7 @@ function jsonFilePlugin(): Plugin {
             focusedSessionId: readActiveSession(dataDir),
             nextAttachSessionId: nextAttachSessionId(dataDir),
             intents: listSessionIntents(dataDir, knownFileIds()),
+            blueprint: readBlueprint(dataDir),
           })
           return
         }
@@ -214,13 +257,21 @@ async function decideIntent(req: IncomingMessage, res: ServerResponse) {
       name?: string
       step?: number
       stepByStep?: boolean
+      hidden?: boolean
       userCreatedBlocks?: unknown[]
       userCreatedIslands?: unknown[]
       addedFunctions?: unknown[]
       addedVariables?: unknown[]
       addedImports?: unknown[]
+      notes?: unknown[]
     }
     const action = body.action
+    const blueprintActions = new Set([
+      'blueprint_update',
+      'blueprint_clear',
+      'blueprint_cleanup',
+      'blueprint_set_hidden',
+    ])
     if (
       action !== 'invoke' &&
       action !== 'continue' &&
@@ -230,6 +281,9 @@ async function decideIntent(req: IncomingMessage, res: ServerResponse) {
       action !== 'blueprint_no' &&
       action !== 'blueprint_send' &&
       action !== 'blueprint_update' &&
+      action !== 'blueprint_clear' &&
+      action !== 'blueprint_cleanup' &&
+      action !== 'blueprint_set_hidden' &&
       action !== 'focus' &&
       action !== 'set_step_by_step' &&
       action !== 'set_initial_instruction' &&
@@ -238,7 +292,11 @@ async function decideIntent(req: IncomingMessage, res: ServerResponse) {
       sendJson(res, 400, { error: 'invalid workflow action' })
       return
     }
-    if (action !== 'setup_session' && !body.sessionId) {
+    if (
+      action !== 'setup_session' &&
+      !blueprintActions.has(action ?? '') &&
+      !body.sessionId
+    ) {
       sendJson(res, 400, { error: 'sessionId is required' })
       return
     }
@@ -295,7 +353,14 @@ async function decideIntent(req: IncomingMessage, res: ServerResponse) {
         addedFunctions: body.addedFunctions,
         addedVariables: body.addedVariables,
         addedImports: body.addedImports,
+        notes: body.notes,
       })
+    } else if (action === 'blueprint_clear') {
+      clearBlueprint(dataDir)
+    } else if (action === 'blueprint_cleanup') {
+      cleanupBlueprint(dataDir, knownFileIds(), knownFolderPaths())
+    } else if (action === 'blueprint_set_hidden') {
+      setBlueprintHidden(dataDir, Boolean(body.hidden))
     } else if (action === 'blueprint_send') {
       sendBlueprint(dataDir, body.sessionId, {
         userCreatedBlocks: body.userCreatedBlocks,
@@ -303,14 +368,15 @@ async function decideIntent(req: IncomingMessage, res: ServerResponse) {
         addedFunctions: body.addedFunctions,
         addedVariables: body.addedVariables,
         addedImports: body.addedImports,
+        notes: body.notes,
       })
     } 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 })
+      const next = intentResponse(manifest.sessionId)
+      sendJson(res, 200, next ?? { ...emptyIntent, ...blueprintIntentFields() })
       return
     } else if (action === 'set_initial_instruction') {
       setInitialInstruction(dataDir, body.sessionId, body.instruction ?? '')
@@ -327,8 +393,8 @@ async function decideIntent(req: IncomingMessage, res: ServerResponse) {
       stopSession(dataDir, body.sessionId, targetRoot)
       rescanTarget('after stopping session')
     }
-    const next = sessionIntent(dataDir, body.sessionId, knownFileIds())
-    sendJson(res, 200, next ?? { ...emptyIntent })
+    const next = intentResponse(body.sessionId)
+    sendJson(res, 200, next ?? { ...emptyIntent, ...blueprintIntentFields() })
   } catch (error) {
     const message = error instanceof Error ? error.message : 'invalid request'
     sendJson(res, 400, { error: message })

package/bin/session.mjs

@@ -135,7 +135,7 @@ function emitApprovalHandshake(store, dataDir, sessionId, manifest, initialDiff)
     console.log(
       continuing
         ? `VISUAL_CODER_EXECUTE Step ${manifest.currentStep} is invoked${title ? `: ${title}` : ''}. Continue immediately: edit live files for this step only, then inbase propose-patch --session ${sessionId} with no patch file. Do not explore, re-plan, or run wait-for-blueprint.`
-        : `VISUAL_CODER_EXECUTE Step ${manifest.currentStep} is invoked${title ? `: ${title}` : ''}. Re-read this session's blueprint.json before implementing; the user can place files and islands on any step. Edit the live project files for this step only (Write, StrReplace, Delete). Then record the step with inbase propose-patch --session ${sessionId} — no patch file. Inbase diffs those edits against the invoke snapshot and stores the patch. Do not write a unified diff yourself.`,
+        : `VISUAL_CODER_EXECUTE Step ${manifest.currentStep} is invoked${title ? `: ${title}` : ''}. Re-read the shared blueprint.json before implementing; the user can place files and islands at any time. Edit the live project files for this step only (Write, StrReplace, Delete). Then record the step with inbase propose-patch --session ${sessionId} — no patch file. Inbase diffs those edits against the invoke snapshot and stores the patch. Do not write a unified diff yourself.`,
     )
     process.exit(0)
   }
@@ -151,7 +151,7 @@ function emitApprovalHandshake(store, dataDir, sessionId, manifest, initialDiff)
       ? `\nVISUAL_CODER_INSTRUCTION_START\n${manifest.pendingInstruction}\nVISUAL_CODER_INSTRUCTION_END`
       : ''
     console.log(
-      `VISUAL_CODER_REPLAN Keep accepted patch files before step ${manifest.currentStep}. Disk is baseline + accepted patches. Do not edit project files until the next EXECUTE. 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}`,
+      `VISUAL_CODER_REPLAN Keep accepted patch files before step ${manifest.currentStep}. Disk is baseline + accepted patches. Do not edit project files until the next EXECUTE. The shared 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)
   }
@@ -183,6 +183,19 @@ export async function attachSession(args) {
   )
 }
 
+function printBlueprintDump(blueprint) {
+  const blocks = blueprint.userCreatedBlocks ?? []
+  const islands = blueprint.userCreatedIslands ?? []
+  console.log(
+    blueprint.enabled
+      ? `VISUAL_CODER_BLUEPRINT_READY The shared blueprint has ${blocks.length} file(s) and ${islands.length} island(s). The blueprint is leading: create those paths and honor addedFunctions, addedVariables, addedImports, and notes even if they are not on disk. Notes are extra instructions or pseudo code for a file, function, or variable — follow them when implementing those items. 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. The user can keep placing files and islands; re-read the shared blueprint.json when it is printed again.`
+      : 'VISUAL_CODER_BLUEPRINT_READY The shared blueprint is empty. The user can still place files and islands; re-read the shared blueprint.json when it is printed again. Continue without user-placed files until that file has content.',
+  )
+  console.log('VISUAL_CODER_BLUEPRINT_START')
+  console.log(JSON.stringify(blueprint, null, 2))
+  console.log('VISUAL_CODER_BLUEPRINT_END')
+}
+
 export async function waitForBlueprint(args) {
   const { store, config } = await loadExplorer()
   const sessionId = takeFlagValue(args, '--session')
@@ -204,7 +217,7 @@ export async function waitForBlueprint(args) {
     emitStopped(store, config.dataDir, sessionId)
   }
 
-  const blueprint = store.readBlueprint(config.dataDir, sessionId)
+  const blueprint = store.readBlueprint(config.dataDir)
   const blocks = blueprint.userCreatedBlocks ?? []
   const islands = blueprint.userCreatedIslands ?? []
   signalAck(
@@ -216,14 +229,8 @@ export async function waitForBlueprint(args) {
       ? `${blocks.length} file(s), ${islands.length} island(s)`
       : 'none',
   )
-  console.log(
-    blueprint.enabled
-      ? `VISUAL_CODER_BLUEPRINT_READY The session started with ${blocks.length} file(s) and ${islands.length} island(s). 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. The user can still place files and islands on later steps; re-read this session's blueprint.json before each step.`
-      : 'VISUAL_CODER_BLUEPRINT_READY The session started without a blueprint. They can still place files and islands on later steps; re-read this session\'s blueprint.json before each step. Continue without user-placed files until that file is enabled.',
-  )
-  console.log('VISUAL_CODER_BLUEPRINT_START')
-  console.log(JSON.stringify(blueprint, null, 2))
-  console.log('VISUAL_CODER_BLUEPRINT_END')
+  printBlueprintDump(blueprint)
+  store.markBlueprintSeen(config.dataDir, sessionId, blueprint.revision)
   const instruction =
     typeof manifest.initialInstruction === 'string'
       ? manifest.initialInstruction.trim()
@@ -296,6 +303,27 @@ export async function waitForApproval(args) {
       const manifest = store.readManifest(config.dataDir, sessionId)
       emitApprovalHandshake(store, config.dataDir, sessionId, manifest, initialDiff)
       if (!manifest) continue
+      const blueprint = store.readBlueprint(config.dataDir)
+      const seen = manifest.blueprintRevision ?? 0
+      if (blueprint.revision > seen) {
+        const blocks = blueprint.userCreatedBlocks ?? []
+        const islands = blueprint.userCreatedIslands ?? []
+        signalAck(
+          store,
+          config.dataDir,
+          sessionId,
+          'blueprint',
+          blueprint.enabled
+            ? `${blocks.length} file(s), ${islands.length} island(s)`
+            : 'none',
+        )
+        console.log(
+          'VISUAL_CODER_BLUEPRINT The shared blueprint changed. Follow the latest files, islands, functions, variables, imports, and notes. Do not omit, rename, relocate, or replace them. If this would differ from the current plan, ask the user before replacing the plan. Then run wait-for-approval again.',
+        )
+        printBlueprintDump(blueprint)
+        store.markBlueprintSeen(config.dataDir, sessionId, blueprint.revision)
+        process.exit(6)
+      }
       const waiting = waitingMessage(sessionId, manifest)
       if (waiting !== lastWaiting) {
         console.log(waiting)
@@ -325,7 +353,7 @@ export async function proposePatch(args) {
     if (!sessionId) usage('propose-patch', '--session <cursor-chat-id> --clear')
     store.stopSession(config.dataDir, sessionId, config.targetRoot)
     console.log(
-      `Cleared session ${sessionId}; stored diffs and blueprint drafts were removed.`,
+      `Cleared session ${sessionId}; stored diffs were removed. The shared blueprint remains.`,
     )
     process.exit(0)
   }

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@jkwd/inbase",
-  "version": "0.1.13",
+  "version": "0.1.16",
   "description": "A first-person 3D map of a codebase, with a visual coding workflow for Cursor.",
   "license": "MIT",
   "author": "Joris Kuijper",
@@ -50,6 +50,7 @@
     "apps/explorer/scripts/open-editor.mjs",
     "apps/explorer/scripts/patch-lib.d.ts",
     "apps/explorer/scripts/patch-lib.mjs",
+    "apps/explorer/scripts/scan-ignore.mjs",
     "apps/explorer/scripts/scan-target.mjs",
     "apps/explorer/scripts/session-store.d.ts",
     "apps/explorer/scripts/session-store.mjs",

package/skill/commands/inbase.md

@@ -6,7 +6,7 @@ The user invoked `/inbase`. This is how a chat joins the visualizer session that
 
 Do **not** ask for a session id. Do **not** run `inbase start-session`. Do **not** print the "direct chat interaction not allowed" message.
 
-1. Attach to the next waiting visualizer session (newest first; skip sessions that already have an LLM):
+1. Attach to the next waiting visualizer session (oldest first; skip sessions that already have an LLM):
 
 ```bash
 npx inbase attach

package/skill/inbase/SKILL.md

@@ -57,7 +57,7 @@ If this chat is not yet attached, run:
 npx inbase attach
 ```
 
-That attaches this chat to the next waiting visualizer session (newest first).
+That attaches this chat to the next waiting visualizer session (oldest first).
 Already-attached sessions are skipped. Window focus does not matter. No id is
 passed in; read `VISUAL_CODER_SESSION` from the output and use that
 `--session` value for every later command. Then continue from
@@ -94,22 +94,20 @@ npx inbase wait-for-blueprint --session "<session-id>"
 ```
 
    The user may have placed files (`Space`) and islands (`B`), or left the
-   blueprint empty. That choice is already on the session. They can keep
-   placing on later steps. This chat's blueprint is stored only for this
-   session.
+   shared blueprint empty. That blueprint is shared across sessions. They can
+   keep placing at any time.
    If `wait-for-blueprint` prints `VISUAL_CODER_INSTRUCTION_START` /
    `VISUAL_CODER_INSTRUCTION_END`, that text is the user's request for this
    session. Plan from that instruction and the blueprint together. The
    instruction does not override an enabled blueprint; if they conflict,
    ask the user.
 3. Read the handshake output between `VISUAL_CODER_BLUEPRINT_START` and
-   `VISUAL_CODER_BLUEPRINT_END`, or read
-   `.inbase/diff-sessions/<session-id>/blueprint.json`.
+   `VISUAL_CODER_BLUEPRINT_END`, or read `.inbase/blueprint.json`.
    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.
+   The same blueprint is shared with every session.
    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.
@@ -124,8 +122,8 @@ npx inbase wait-for-blueprint --session "<session-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. Viewpoint never overrides the
-   blueprint: still follow this session's blueprint when `enabled` is true.
+   and    choose files from the request itself. Viewpoint never overrides the
+   blueprint: still follow the shared blueprint when `enabled` is true.
 6. List **all** steps needed to finish the feature. Keep steps small enough that
    one recorded step is one landscape change (usually one new file, or a few
    related edits).
@@ -150,8 +148,8 @@ npx inbase wait-for-approval --session "<session-id>"
    returns, they already did. Do not edit project files until this prints
    `VISUAL_CODER_ACK execute` / `VISUAL_CODER_EXECUTE`. If Step by step is off,
    this returns immediately for each remaining step. First reply in chat
-   acknowledging the ack, then re-read this session's `blueprint.json`; the
-   user can place files and islands on any step.
+   acknowledging the ack, then re-read the shared `blueprint.json`; the
+   user can place files and islands at any time.
 9. Implement only the invoked step by editing the live project files (Write,
    StrReplace, Delete). Paths are the same ids as `codebase.json`. Then record
    the step — Inbase diffs the working tree against the snapshot taken at
@@ -180,20 +178,24 @@ npx inbase wait-for-approval --session "<session-id>"
 
    - Exit `0` (`VISUAL_CODER_ACK execute` / `VISUAL_CODER_EXECUTE`): the
      highlighted step was invoked. If this is a later step, implement it now —
-     do not explore, re-plan, or run `wait-for-blueprint`. Re-read this
-     session's `blueprint.json` only if you need placed files. Edit live files
-     for that step only, record with `inbase propose-patch` (no patch file),
-     then wait again.
+     do not explore, re-plan, or run `wait-for-blueprint`. Re-read the shared
+     `blueprint.json` if you need placed files. Edit live files for that step
+     only, record with `inbase propose-patch` (no patch file), then wait again.
+   - Exit `6` (`VISUAL_CODER_ACK blueprint` / `VISUAL_CODER_BLUEPRINT`): the
+     shared blueprint changed. Follow the latest files, islands, functions,
+     variables, and imports. Do not omit, rename, relocate, or replace them.
+     If this would differ from the current plan, ask the user before replacing
+     the plan. Then run `wait-for-approval` again.
    - Exit `5` (`VISUAL_CODER_ACK finished` / `VISUAL_CODER_FINISHED`): that was
      the last step. The visualizer already applied the final patch and removed
-     stored session diffs and blueprint drafts. Optionally run `--clear` if
-     anything remains, tell the user the feature is done, and **stop**. Do not
-     propose another patch.
+     stored session diffs. The shared blueprint remains. Optionally run
+     `--clear` if anything remains, tell the user the feature is done, and
+     **stop**. Do not propose another patch.
    - Exit `4` (`VISUAL_CODER_ACK replan` / `VISUAL_CODER_REPLAN`): do **not**
      edit project files and do not rewrite an earlier accepted patch. The
      withdrawn proposal is no longer live; disk is baseline + accepted patch
      files. Follow the text between `VISUAL_CODER_INSTRUCTION_START` and
-     `VISUAL_CODER_INSTRUCTION_END`, read this session's `blueprint.json` when
+     `VISUAL_CODER_INSTRUCTION_END`, read the shared `blueprint.json` when
      it is enabled (files, islands, `addedFunctions`, `addedVariables`,
      `addedImports`). The blueprint stays leading. If the new instruction would
      differ from it, ask the user before replacing the plan. Read
@@ -206,7 +208,7 @@ npx inbase wait-for-approval --session "<session-id>"
      (`VISUAL_CODER_ACK timeout`): make no further project changes.
 
 13. After a finished handshake, the explorer already removed stored session
-    diffs and blueprint drafts. Optionally run:
+    diffs. The shared blueprint remains. Optionally run:
 
 ```bash
 npx inbase propose-patch --session "<session-id>" --clear
@@ -220,9 +222,9 @@ npx inbase propose-patch --session "<session-id>" --clear
 - Invent a session id for `/inbase`; run `npx inbase attach` with no `--session`
 - Skip `inbase wait-for-blueprint`; it returns immediately and provides the optional blueprint and instruction
 - 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
+- Skip, rename, relocate, or replace the shared `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
+- Read global `user-context.json` for placed files; those live on the shared blueprint
 - Follow the user's look when `followLook` is false
 - Edit project files before `VISUAL_CODER_EXECUTE`
 - Keep editing after `inbase propose-patch` until the next `VISUAL_CODER_EXECUTE`