@almadar/workspace 0.4.0 → 0.5.0

package/dist/__tests__/open-create-false.test.d.ts

@@ -0,0 +1 @@
+export {};

package/dist/delete-workspace.d.ts

@@ -0,0 +1,14 @@
+/**
+ * `deleteWorkspace` — remove a user's app-workspace dir by appId.
+ *
+ * Locates the workspace via its `app-marker.json` (reuse `findLocalWorkspaceDir`)
+ * and removes the tree. Idempotent: returns `false` if no matching workspace.
+ * Keeps workspace lifecycle inside the package (consumers don't fs-scan/rm the
+ * layout themselves).
+ *
+ * @packageDocumentation
+ */
+import type { ListWorkspacesOptions } from './types.js';
+export declare function deleteWorkspace(opts: ListWorkspacesOptions & {
+    appId: string;
+}): Promise<boolean>;

package/dist/index.d.ts

@@ -8,6 +8,7 @@
  */
 export { openWorkspace } from './open-workspace.js';
 export { listWorkspaces } from './list-workspaces.js';
+export { deleteWorkspace } from './delete-workspace.js';
 export { openAccount } from './account.js';
 export type { WorkspaceService, WorkspaceObserver, WorkspaceWriteEvent, WorkspaceWatchEvent, OpenWorkspaceOptions, ListWorkspacesOptions, WorkspaceSummary, RestoreBackend, GitHubConfig, GitStatusInfo, FileTreeNode, AccountService, AccountConfig, ProviderCredential, AccountIdentity, OpenAccountOptions, } from './types.js';
 export type { WorkspaceIndex, EmbedderPort, ResolveResult, ResolveOptions, TraitRefEmit, WorkspaceIndexStats, OrbitalIndexEntry, ExtraTraitIdentity, RetrievalResult, RetrievalOptions, RecentlyEditedOptions, EventEdge, EntityBinding, RuleBinding, RecencyEntry, IntentMaps, ComposedMaps, BM25Document, BM25Table, BM25Options, WorkspaceIndexManifest, } from './workspace-index/types.js';

package/dist/index.js

@@ -50,6 +50,9 @@ var LocalBackend = class {
   async chmod(absPath, mode) {
     await fs.promises.chmod(absPath, mode);
   }
+  async rm(absPath, opts) {
+    await fs.promises.rm(absPath, { recursive: opts?.recursive ?? false, force: true });
+  }
   watch(absPath, onChange) {
     let watcher;
     let timer;
@@ -172,6 +175,15 @@ var MemoryBackend = class {
     return () => {
     };
   }
+  async rm(absPath, opts) {
+    this.files.delete(absPath);
+    this.dirs.delete(absPath);
+    if (opts?.recursive) {
+      const prefix = absPath.endsWith("/") ? absPath : absPath + "/";
+      for (const k of [...this.files.keys()]) if (k.startsWith(prefix)) this.files.delete(k);
+      for (const d of [...this.dirs]) if (d.startsWith(prefix)) this.dirs.delete(d);
+    }
+  }
   // Test helpers
   getAll() {
     return new Map(this.files);
@@ -2171,13 +2183,18 @@ function openWorkspaceCacheKey(opts) {
   return `${backendTag}:${opts.userId}:${opts.appId}`;
 }
 async function openWorkspace(opts) {
+  if (opts.create === false) {
+    return openWorkspaceInternal(opts);
+  }
   const key = openWorkspaceCacheKey(opts);
   if (key !== null) {
     const cached = openWorkspaceInFlight.get(key);
     if (cached) return cached;
     const pending = (async () => {
       try {
-        return await openWorkspaceInternal(opts);
+        const ws = await openWorkspaceInternal(opts);
+        if (ws === null) throw new Error("openWorkspace: null resolution without create:false");
+        return ws;
       } catch (err) {
         openWorkspaceInFlight.delete(key);
         throw err;
@@ -2192,6 +2209,7 @@ async function openWorkspaceInternal(opts) {
   const backend = opts.backend === "memory" ? new MemoryBackend() : new LocalBackend();
   const sinks = new SinkManager();
   const resolved = await resolveLifecycle(backend, opts);
+  if (resolved === null) return null;
   const bare = opts.bare === true && opts.adopt !== void 0;
   if (!bare) {
     await ensureSkeleton(backend, resolved.workDir);
@@ -2234,6 +2252,7 @@ async function openWorkspaceInternal(opts) {
   return service;
 }
 async function resolveLifecycle(backend, opts) {
+  const noCreate = opts.create === false;
   if (opts.adopt) {
     const workDir2 = path2.resolve(opts.adopt);
     const marker = readAppMarker(backend, workDir2);
@@ -2251,14 +2270,20 @@ async function resolveLifecycle(backend, opts) {
   if (opts.appId && opts.restore) {
     const workDir2 = mintSessionDir(opts.root, opts.userId);
     await backend.mkdir(workDir2, { recursive: true });
-    await restoreWorkspace(backend, workDir2, opts.restore);
+    const result = await restoreWorkspace(backend, workDir2, opts.restore);
+    if (noCreate && result.filesRestored === 0) {
+      await backend.rm(workDir2, { recursive: true });
+      return null;
+    }
     return { workDir: workDir2, appId: opts.appId };
   }
   if (opts.appId && opts.github && opts.github.repoUrl) {
+    if (noCreate) return null;
     const workDir2 = mintSessionDir(opts.root, opts.userId);
     await backend.mkdir(workDir2, { recursive: true });
     return { workDir: workDir2, appId: opts.appId };
   }
+  if (noCreate) return null;
   const workDir = mintSessionDir(opts.root, opts.userId);
   return { workDir, appId: opts.appId };
 }
@@ -2300,6 +2325,15 @@ async function listWorkspaces(opts) {
   out.sort((a, b) => (b.updatedAt ?? 0) - (a.updatedAt ?? 0));
   return out;
 }
+
+// src/delete-workspace.ts
+async function deleteWorkspace(opts) {
+  const backend = opts.backend === "memory" ? new MemoryBackend() : new LocalBackend();
+  const workDir = await findLocalWorkspaceDir(backend, opts.root, opts.userId, opts.appId);
+  if (!workDir) return false;
+  await backend.rm(workDir, { recursive: true });
+  return true;
+}
 var ACCOUNT_DIR = ".almadar";
 var CONFIG_FILE = "config.json";
 var CREDENTIALS_FILE = "credentials.json";
@@ -2383,6 +2417,6 @@ async function openAccount(opts = {}) {
   };
 }
 
-export { DEFAULT_COERCION_THRESHOLD, DEFAULT_RETRIEVAL_TOP_K, RRF_K, WORKSPACE_INDEX_SCHEMA_VERSION, listWorkspaces, openAccount, openWorkspace };
+export { DEFAULT_COERCION_THRESHOLD, DEFAULT_RETRIEVAL_TOP_K, RRF_K, WORKSPACE_INDEX_SCHEMA_VERSION, deleteWorkspace, listWorkspaces, openAccount, openWorkspace };
 //# sourceMappingURL=index.js.map
 //# sourceMappingURL=index.js.map