@almadar/workspace 0.3.0 → 0.4.0

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.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",