@almadar/workspace 0.3.0 → 0.4.1

package/dist/internal/backends/local.d.ts

@@ -21,5 +21,8 @@ export declare class LocalBackend implements WorkspaceBackend {
     }>;
     rename(srcAbs: string, dstAbs: string): Promise<void>;
     chmod(absPath: string, mode: number): Promise<void>;
+    rm(absPath: string, opts?: {
+        recursive?: boolean;
+    }): Promise<void>;
     watch(absPath: string, onChange: (kind: 'change' | 'rename') => void): () => void;
 }

package/dist/internal/backends/memory.d.ts

@@ -23,6 +23,9 @@ export declare class MemoryBackend implements WorkspaceBackend {
     rename(srcAbs: string, dstAbs: string): Promise<void>;
     chmod(): Promise<void>;
     watch(): () => void;
+    rm(absPath: string, opts?: {
+        recursive?: boolean;
+    }): Promise<void>;
     getAll(): Map<string, string>;
     clear(): void;
 }

package/dist/internal/types.d.ts

@@ -46,6 +46,14 @@ export interface WorkspaceBackend {
      * way (poll/webhook) — consumers never see the difference.
      */
     watch(absPath: string, onChange: (kind: 'change' | 'rename') => void): () => void;
+    /**
+     * Remove a path. With `{ recursive: true }` removes a directory tree; always
+     * idempotent (no-op if absent). The `'local'` backend uses `fs.rm`; memory
+     * drops the matching key(s). Used by `deleteWorkspace`.
+     */
+    rm(absPath: string, opts?: {
+        recursive?: boolean;
+    }): Promise<void>;
 }
 /**
  * The persisted marker that pins an `appId` to a workspace dir on disk.

package/dist/list-workspaces.d.ts

@@ -0,0 +1,14 @@
+/**
+ * `listWorkspaces` — enumerate the app-workspaces a user has under a root.
+ *
+ * The single source for "which projects exist locally": scans
+ * `<root>/<userId>/*` for dirs carrying an `app-marker.json` (minted or
+ * adopted-as-app workspaces) and reports `{ appId, workDir, name?, updatedAt? }`.
+ * Bare-adopted loose files (no marker) are intentionally excluded — they aren't
+ * projects. Consumers (apps/builder's offline AppStore, orbital-agent-cli) use
+ * this instead of fs-scanning the layout themselves.
+ *
+ * @packageDocumentation
+ */
+import type { ListWorkspacesOptions, WorkspaceSummary } from './types.js';
+export declare function listWorkspaces(opts: ListWorkspacesOptions): Promise<WorkspaceSummary[]>;

package/dist/types.d.ts

@@ -190,6 +190,26 @@ export interface OpenWorkspaceOptions {
      */
     embedder?: EmbedderPort;
 }
+/** Input for {@link listWorkspaces}. */
+export interface ListWorkspacesOptions {
+    /** Workspaces root, e.g. `/workspaces` — user dirs nest under it. */
+    root: string;
+    /** Owning user id. */
+    userId: string;
+    /** Storage selector. `'memory'` is for tests; `'local'` is default. */
+    backend?: 'local' | 'memory';
+}
+/** One project workspace returned by {@link listWorkspaces}. */
+export interface WorkspaceSummary {
+    /** Pinned app id from `.almadar/app-marker.json`. */
+    appId: string;
+    /** Absolute workspace directory. */
+    workDir: string;
+    /** Schema display name (`schema.orb` `name`), when present. */
+    name?: string;
+    /** `schema.orb` mtime if present, else the marker's `createdAt`. */
+    updatedAt?: number;
+}
 /**
  * The single workspace I/O surface. Every consumer (rabit, apps/builder,
  * cli, future tools) operates through this. Methods are grouped per

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@almadar/workspace",
-  "version": "0.3.0",
+  "version": "0.4.1",
   "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",