@volter/live 0.5.209 → 0.5.211

package/dist/session.d.ts

@@ -29,4 +29,7 @@ export interface ProjectSessionHint {
     url: string;
     startedAt: string;
 }
+/** The code a refusal carries when the registry was read and no session opens the project: the
+ *  one state in which "no editor is open here" is a fact, which `close` answers as done. */
+export declare const NO_SESSION_FOR_PROJECT = "VOLTER_NO_SESSION_FOR_PROJECT";
 export declare function resolveSession(projectDir?: string, deps?: SessionResolutionDeps): Promise<ResolvedSession>;

package/package.json

@@ -1,7 +1,7 @@
 {
   "name": "@volter/live",
   "author": "Volter AI, Inc.",
-  "version": "0.5.209",
+  "version": "0.5.211",
   "publishConfig": {
     "access": "public"
   },
@@ -30,8 +30,8 @@
     "node": ">=22"
   },
   "dependencies": {
-    "@volter/sdk": "0.5.209",
-    "@volter/project": "0.5.209",
+    "@volter/sdk": "0.5.211",
+    "@volter/project": "0.5.211",
     "undici": "^7.28.0"
   },
   "devDependencies": {

package/src/index.ts

@@ -12,7 +12,7 @@ export { LiveEditorDocument } from './editor-document.js';
 export type { DocumentGestureOptions, DocumentKeyOptions, DocumentPasteOptions } from './editor-document.js';
 export { LiveTools } from './tools.js';
 export { editorMemberHint, withEditorMemberHints } from './member-hints.js';
-export { resolveSession, findProjectRootFrom } from './session.js';
+export { resolveSession, findProjectRootFrom, NO_SESSION_FOR_PROJECT } from './session.js';
 export type { ResolvedSession, SessionResolutionDeps, SessionListingTransport, ProjectSessionHint } from './session.js';
 export type { ActiveDocumentCapture, EditorView, PresentedEditorView } from '@volter/sdk';
 

package/src/session.ts

@@ -3,7 +3,7 @@
  * then consult the shared registry. Never fall back to another project.
  * Storage identifiers move with the server in the coordinated migration. */
 
-import { existsSync, readFileSync, realpathSync } from 'node:fs';
+import { existsSync, readFileSync, realpathSync, statSync } from 'node:fs';
 import { dirname, join, resolve } from 'node:path';
 import { resolveManifestPath } from '@volter/project/manifest/locate';
 import { resolveProductForProject } from '@volter/sdk/session/product-locator';
@@ -63,6 +63,22 @@ function canonicalPath(path: string): string {
   }
 }
 
+/** Whether two paths are the same folder on disk, which `canonicalPath` alone misses on Windows
+ *  (it keeps the letter case typed, and short names and `subst` drives unexpanded). */
+function sameDirectory(a: string, b: string): boolean {
+  try {
+    const x = statSync(a, { bigint: true });
+    const y = statSync(b, { bigint: true });
+    return x.dev === y.dev && x.ino === y.ino;
+  } catch {
+    return false;
+  }
+}
+
+/** The code a refusal carries when the registry was read and no session opens the project: the
+ *  one state in which "no editor is open here" is a fact, which `close` answers as done. */
+export const NO_SESSION_FOR_PROJECT = 'VOLTER_NO_SESSION_FOR_PROJECT';
+
 function readProjectSession(projectRoot: string): ProjectSessionHint | null {
   try {
     const value: unknown = JSON.parse(
@@ -181,16 +197,19 @@ function noMatchingSessionRefusal(
     );
   }
   if (sessions.length === 0) {
-    return new Error(
+    return Object.assign(new Error(
       `@volter/live: the editor session registry is readable and lists NO live sessions, so none ` +
         `covers ${projectRoot}. @volter/live only attaches to an already-running session — it ` +
         `never starts one — so run ${editCommandFor(projectRoot)} in that project first, then retry.`,
-    );
+    ), { code: NO_SESSION_FOR_PROJECT });
   }
   const listed = sessions
     .map((s) => `    port ${s.port} → ${s.project === null ? '(no project)' : s.project}`)
     .join('\n');
-  return new Error(
+  // A listed session that is this same folder under another spelling is not "nothing open here":
+  // it keeps the refusal, so `close` does not report done while that editor runs on.
+  const thisFolderElsewhere = sessions.some((s) => s.project !== null && sameDirectory(s.project, projectRoot));
+  return Object.assign(new Error(
     `@volter/live: ${sessions.length} live editor session(s) are running, but none of them opens ` +
       `${projectRoot}. @volter/live never silently attaches to a different project.\n` +
       `  looking for (resolved): ${canon}\n` +
@@ -199,7 +218,7 @@ function noMatchingSessionRefusal(
       'the usual cause is a git worktree or a symlink, where the session was opened through a ' +
       `different path to the same files. Run ${editCommandFor(projectRoot)} from THIS path, or use the path the ` +
       'session lists.',
-  );
+  ), thisFolderElsewhere ? {} : { code: NO_SESSION_FOR_PROJECT });
 }
 
 export async function resolveSession(