@almadar/workspace 0.4.1 → 0.5.0

package/dist/open-workspace.d.ts

@@ -8,4 +8,7 @@
  * @packageDocumentation
  */
 import type { OpenWorkspaceOptions, WorkspaceService } from './types.js';
+export declare function openWorkspace(opts: OpenWorkspaceOptions & {
+    create: false;
+}): Promise<WorkspaceService | null>;
 export declare function openWorkspace(opts: OpenWorkspaceOptions): Promise<WorkspaceService>;

package/dist/types.d.ts

@@ -178,6 +178,16 @@ export interface OpenWorkspaceOptions {
     github?: GitHubConfig;
     /** Fallback fetcher used when the local cache misses. */
     restore?: RestoreBackend;
+    /**
+     * When `false`, open is a pure read: resolve an EXISTING workspace (local
+     * resume, or restore that actually yields files) but NEVER mint a fresh one.
+     * Returns `null` when the appId exists in neither the local cache nor the
+     * restore backend — so callers can 404 instead of silently creating (and
+     * listing) a phantom workspace. Defaults to `true` (mint on miss, the
+     * historical behaviour). A `github`-clone-on-miss still requires
+     * `create !== false` (remote existence can't be verified without cloning).
+     */
+    create?: boolean;
     /** Storage selector. `'memory'` is for tests; `'local'` is default. */
     backend?: 'local' | 'memory';
     /** Optional project name baked into the mint-time schema template. */

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@almadar/workspace",
-  "version": "0.4.1",
+  "version": "0.5.0",
   "description": "Storage-agnostic workspace primitives shared by Almadar consumers. One service, six exports, hidden paths, single observer. See docs/Almadar_Workspace.md.",
   "type": "module",
   "main": "./dist/index.js",