@almadar/workspace 0.11.1 → 0.11.3

package/dist/service.d.ts

@@ -7,7 +7,7 @@
  * @packageDocumentation
  */
 import type { JsonObject, JsonValue } from '@almadar/core';
-import type { FileTreeNode, GitHubConfig, GitStatusInfo, SnapshotMeta, WorkspaceArchiveBackend, WorkspaceObserver, WorkspaceService, WorkspaceWatchEvent } from './types.js';
+import type { FileTreeNode, GitHubConfig, GitStatusInfo, InstantiateWorkspaceSeed, SnapshotMeta, WorkspaceArchiveBackend, WorkspaceObserver, WorkspaceService, WorkspaceWatchEvent } from './types.js';
 import type { WorkspaceBackend } from './internal/types.js';
 import { SinkManager } from './internal/sink-manager.js';
 import { GitClient } from './internal/git-client.js';
@@ -55,6 +55,7 @@ export declare class WorkspaceServiceImpl implements WorkspaceService {
     renameOrbitalSession(from: string, to: string): Promise<void>;
     readSchema(): string | null;
     writeSchema(content: string): Promise<void>;
+    instantiateWorkspace(seed: InstantiateWorkspaceSeed): Promise<void>;
     readAnalysis<T extends JsonObject>(): T | null;
     writeAnalysis<T extends JsonObject>(analysis: T): Promise<void>;
     readPlan<T extends JsonObject>(): T | null;

package/dist/types.d.ts

@@ -6,7 +6,7 @@
  *
  * @packageDocumentation
  */
-import type { JsonObject, JsonValue } from '@almadar/core';
+import type { JsonObject, JsonValue, OrbitalSchema } from '@almadar/core';
 import type { ProviderConfig } from '@almadar/llm';
 import type { EmbedderPort, WorkspaceIndex } from './workspace-index/types.js';
 /**
@@ -252,6 +252,21 @@ export interface WorkspaceSummary {
  * observer. The service stays neutral — it serializes JSON and emits typed
  * `WorkspaceWriteEvent`s.
  */
+/**
+ * Input for {@link WorkspaceService.instantiateWorkspace}. `schema` /
+ * `composedSchema` are `OrbitalSchema`s the caller already built (the on-disk
+ * `.orb` format is always an `OrbitalSchema`); `spec` / `planSnapshot` are
+ * JSON-shaped and ride the generic `writeSpec` / `writePlan` writers.
+ */
+export interface InstantiateWorkspaceSeed {
+    orbitals: ReadonlyArray<{
+        name: string;
+        spec: JsonObject;
+        schema: OrbitalSchema;
+    }>;
+    composedSchema: OrbitalSchema;
+    planSnapshot: JsonObject;
+}
 export interface WorkspaceService {
     readonly appId: string | undefined;
     readonly workDir: string;
@@ -273,6 +288,17 @@ export interface WorkspaceService {
     renameOrbitalSession(from: string, to: string): Promise<void>;
     readSchema(): string | null;
     writeSchema(content: string): Promise<void>;
+    /**
+     * Seed a complete, coordinator-adoptable workspace in one call from
+     * already-built artifacts: writes each orbital's `.orb` + per-orbital
+     * `spec.json`, the composed `schema.orb`, and the Coordinator plan snapshot.
+     * After this, a fresh `runCoordinator` turn against this workDir sees the
+     * orbitals as already-built (via their specs + the plan snapshot) and
+     * *iterates* them rather than rebuilding. Pure fs over the writers above —
+     * the caller materialises the schemas (e.g. via the std factory +
+     * `@almadar/core`'s `composeBehaviors`); this package never invokes a factory.
+     */
+    instantiateWorkspace(seed: InstantiateWorkspaceSeed): Promise<void>;
     readAnalysis<T extends JsonObject>(): T | null;
     writeAnalysis<T extends JsonObject>(analysis: T): Promise<void>;
     readPlan<T extends JsonObject>(): T | null;

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@almadar/workspace",
-  "version": "0.11.1",
+  "version": "0.11.3",
   "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",
@@ -36,7 +36,8 @@
     "@typescript-eslint/parser": "8.56.0",
     "eslint": "^10.0.0",
     "tsup": "^8.0.0",
-    "vitest": "^3.2.4"
+    "vitest": "^3.2.4",
+    "turbo": "^2.8.17"
   },
   "scripts": {
     "build": "tsup && tsc --declaration --emitDeclarationOnly --outDir dist --rootDir src --skipLibCheck || true",