@treeseed/sdk 0.13.0-rc.67 → 0.13.0-rc.68

package/dist/.treeseed-build-complete.json

@@ -1 +1 @@
-{"completedAt":"2026-09-01T06:11:25.862Z"}
+{"completedAt":"2026-09-01T09:57:27.022Z"}

package/dist/development/schemas.d.ts

@@ -516,6 +516,22 @@ export declare const developmentTargetSchema: z.ZodEffects<z.ZodObject<{
         diskBytes?: number | undefined;
     };
     id: string;
+    ready: {
+        path: string;
+        timeoutSeconds: number;
+        kind: "marker";
+    } | {
+        path: string;
+        timeoutSeconds: number;
+        kind: "http";
+        expectedStatus: number;
+    } | {
+        timeoutSeconds: number;
+        kind: "tcp";
+    } | {
+        kind: "process";
+        graceSeconds: number;
+    };
     kind: "package-watch" | "live-web" | "live-api" | "rebuild-restart" | "local-companion";
     platforms: ("linux-amd64" | "linux-arm64" | "darwin-arm64" | "darwin-amd64")[];
     runtimeRequirements: string[];
@@ -572,22 +588,6 @@ export declare const developmentTargetSchema: z.ZodEffects<z.ZodObject<{
             cwd?: string | undefined;
         } | undefined;
     };
-    ready: {
-        path: string;
-        timeoutSeconds: number;
-        kind: "marker";
-    } | {
-        path: string;
-        timeoutSeconds: number;
-        kind: "http";
-        expectedStatus: number;
-    } | {
-        timeoutSeconds: number;
-        kind: "tcp";
-    } | {
-        kind: "process";
-        graceSeconds: number;
-    };
     outputs: {
         path: string;
         mediaType: string;
@@ -649,6 +649,22 @@ export declare const developmentTargetSchema: z.ZodEffects<z.ZodObject<{
     } | undefined;
 }, {
     id: string;
+    ready: {
+        path: string;
+        timeoutSeconds: number;
+        kind: "marker";
+    } | {
+        path: string;
+        timeoutSeconds: number;
+        kind: "http";
+        expectedStatus?: number | undefined;
+    } | {
+        timeoutSeconds: number;
+        kind: "tcp";
+    } | {
+        kind: "process";
+        graceSeconds?: number | undefined;
+    };
     kind: "package-watch" | "live-web" | "live-api" | "rebuild-restart" | "local-companion";
     platforms: ("linux-amd64" | "linux-arm64" | "darwin-arm64" | "darwin-amd64")[];
     sourceRoots: string[];
@@ -703,22 +719,6 @@ export declare const developmentTargetSchema: z.ZodEffects<z.ZodObject<{
             timeoutSeconds?: number | undefined;
         } | undefined;
     };
-    ready: {
-        path: string;
-        timeoutSeconds: number;
-        kind: "marker";
-    } | {
-        path: string;
-        timeoutSeconds: number;
-        kind: "http";
-        expectedStatus?: number | undefined;
-    } | {
-        timeoutSeconds: number;
-        kind: "tcp";
-    } | {
-        kind: "process";
-        graceSeconds?: number | undefined;
-    };
     statePolicy: "clone" | "stateless" | "ephemeral" | "shared-compatible";
     migrationPolicy: "none" | "explicit-review" | "disposable-only";
     shutdown: {
@@ -792,6 +792,22 @@ export declare const developmentTargetSchema: z.ZodEffects<z.ZodObject<{
         diskBytes?: number | undefined;
     };
     id: string;
+    ready: {
+        path: string;
+        timeoutSeconds: number;
+        kind: "marker";
+    } | {
+        path: string;
+        timeoutSeconds: number;
+        kind: "http";
+        expectedStatus: number;
+    } | {
+        timeoutSeconds: number;
+        kind: "tcp";
+    } | {
+        kind: "process";
+        graceSeconds: number;
+    };
     kind: "package-watch" | "live-web" | "live-api" | "rebuild-restart" | "local-companion";
     platforms: ("linux-amd64" | "linux-arm64" | "darwin-arm64" | "darwin-amd64")[];
     runtimeRequirements: string[];
@@ -848,22 +864,6 @@ export declare const developmentTargetSchema: z.ZodEffects<z.ZodObject<{
             cwd?: string | undefined;
         } | undefined;
     };
-    ready: {
-        path: string;
-        timeoutSeconds: number;
-        kind: "marker";
-    } | {
-        path: string;
-        timeoutSeconds: number;
-        kind: "http";
-        expectedStatus: number;
-    } | {
-        timeoutSeconds: number;
-        kind: "tcp";
-    } | {
-        kind: "process";
-        graceSeconds: number;
-    };
     outputs: {
         path: string;
         mediaType: string;
@@ -925,6 +925,22 @@ export declare const developmentTargetSchema: z.ZodEffects<z.ZodObject<{
     } | undefined;
 }, {
     id: string;
+    ready: {
+        path: string;
+        timeoutSeconds: number;
+        kind: "marker";
+    } | {
+        path: string;
+        timeoutSeconds: number;
+        kind: "http";
+        expectedStatus?: number | undefined;
+    } | {
+        timeoutSeconds: number;
+        kind: "tcp";
+    } | {
+        kind: "process";
+        graceSeconds?: number | undefined;
+    };
     kind: "package-watch" | "live-web" | "live-api" | "rebuild-restart" | "local-companion";
     platforms: ("linux-amd64" | "linux-arm64" | "darwin-arm64" | "darwin-amd64")[];
     sourceRoots: string[];
@@ -979,22 +995,6 @@ export declare const developmentTargetSchema: z.ZodEffects<z.ZodObject<{
             timeoutSeconds?: number | undefined;
         } | undefined;
     };
-    ready: {
-        path: string;
-        timeoutSeconds: number;
-        kind: "marker";
-    } | {
-        path: string;
-        timeoutSeconds: number;
-        kind: "http";
-        expectedStatus?: number | undefined;
-    } | {
-        timeoutSeconds: number;
-        kind: "tcp";
-    } | {
-        kind: "process";
-        graceSeconds?: number | undefined;
-    };
     statePolicy: "clone" | "stateless" | "ephemeral" | "shared-compatible";
     migrationPolicy: "none" | "explicit-review" | "disposable-only";
     shutdown: {
@@ -1597,6 +1597,22 @@ export declare const developmentRuntimeSchema: z.ZodEffects<z.ZodObject<{
             diskBytes?: number | undefined;
         };
         id: string;
+        ready: {
+            path: string;
+            timeoutSeconds: number;
+            kind: "marker";
+        } | {
+            path: string;
+            timeoutSeconds: number;
+            kind: "http";
+            expectedStatus: number;
+        } | {
+            timeoutSeconds: number;
+            kind: "tcp";
+        } | {
+            kind: "process";
+            graceSeconds: number;
+        };
         kind: "package-watch" | "live-web" | "live-api" | "rebuild-restart" | "local-companion";
         platforms: ("linux-amd64" | "linux-arm64" | "darwin-arm64" | "darwin-amd64")[];
         runtimeRequirements: string[];
@@ -1653,22 +1669,6 @@ export declare const developmentRuntimeSchema: z.ZodEffects<z.ZodObject<{
                 cwd?: string | undefined;
             } | undefined;
         };
-        ready: {
-            path: string;
-            timeoutSeconds: number;
-            kind: "marker";
-        } | {
-            path: string;
-            timeoutSeconds: number;
-            kind: "http";
-            expectedStatus: number;
-        } | {
-            timeoutSeconds: number;
-            kind: "tcp";
-        } | {
-            kind: "process";
-            graceSeconds: number;
-        };
         outputs: {
             path: string;
             mediaType: string;
@@ -1730,6 +1730,22 @@ export declare const developmentRuntimeSchema: z.ZodEffects<z.ZodObject<{
         } | undefined;
     }, {
         id: string;
+        ready: {
+            path: string;
+            timeoutSeconds: number;
+            kind: "marker";
+        } | {
+            path: string;
+            timeoutSeconds: number;
+            kind: "http";
+            expectedStatus?: number | undefined;
+        } | {
+            timeoutSeconds: number;
+            kind: "tcp";
+        } | {
+            kind: "process";
+            graceSeconds?: number | undefined;
+        };
         kind: "package-watch" | "live-web" | "live-api" | "rebuild-restart" | "local-companion";
         platforms: ("linux-amd64" | "linux-arm64" | "darwin-arm64" | "darwin-amd64")[];
         sourceRoots: string[];
@@ -1784,22 +1800,6 @@ export declare const developmentRuntimeSchema: z.ZodEffects<z.ZodObject<{
                 timeoutSeconds?: number | undefined;
             } | undefined;
         };
-        ready: {
-            path: string;
-            timeoutSeconds: number;
-            kind: "marker";
-        } | {
-            path: string;
-            timeoutSeconds: number;
-            kind: "http";
-            expectedStatus?: number | undefined;
-        } | {
-            timeoutSeconds: number;
-            kind: "tcp";
-        } | {
-            kind: "process";
-            graceSeconds?: number | undefined;
-        };
         statePolicy: "clone" | "stateless" | "ephemeral" | "shared-compatible";
         migrationPolicy: "none" | "explicit-review" | "disposable-only";
         shutdown: {
@@ -1873,6 +1873,22 @@ export declare const developmentRuntimeSchema: z.ZodEffects<z.ZodObject<{
             diskBytes?: number | undefined;
         };
         id: string;
+        ready: {
+            path: string;
+            timeoutSeconds: number;
+            kind: "marker";
+        } | {
+            path: string;
+            timeoutSeconds: number;
+            kind: "http";
+            expectedStatus: number;
+        } | {
+            timeoutSeconds: number;
+            kind: "tcp";
+        } | {
+            kind: "process";
+            graceSeconds: number;
+        };
         kind: "package-watch" | "live-web" | "live-api" | "rebuild-restart" | "local-companion";
         platforms: ("linux-amd64" | "linux-arm64" | "darwin-arm64" | "darwin-amd64")[];
         runtimeRequirements: string[];
@@ -1929,22 +1945,6 @@ export declare const developmentRuntimeSchema: z.ZodEffects<z.ZodObject<{
                 cwd?: string | undefined;
             } | undefined;
         };
-        ready: {
-            path: string;
-            timeoutSeconds: number;
-            kind: "marker";
-        } | {
-            path: string;
-            timeoutSeconds: number;
-            kind: "http";
-            expectedStatus: number;
-        } | {
-            timeoutSeconds: number;
-            kind: "tcp";
-        } | {
-            kind: "process";
-            graceSeconds: number;
-        };
         outputs: {
             path: string;
             mediaType: string;
@@ -2006,6 +2006,22 @@ export declare const developmentRuntimeSchema: z.ZodEffects<z.ZodObject<{
         } | undefined;
     }, {
         id: string;
+        ready: {
+            path: string;
+            timeoutSeconds: number;
+            kind: "marker";
+        } | {
+            path: string;
+            timeoutSeconds: number;
+            kind: "http";
+            expectedStatus?: number | undefined;
+        } | {
+            timeoutSeconds: number;
+            kind: "tcp";
+        } | {
+            kind: "process";
+            graceSeconds?: number | undefined;
+        };
         kind: "package-watch" | "live-web" | "live-api" | "rebuild-restart" | "local-companion";
         platforms: ("linux-amd64" | "linux-arm64" | "darwin-arm64" | "darwin-amd64")[];
         sourceRoots: string[];
@@ -2060,22 +2076,6 @@ export declare const developmentRuntimeSchema: z.ZodEffects<z.ZodObject<{
                 timeoutSeconds?: number | undefined;
             } | undefined;
         };
-        ready: {
-            path: string;
-            timeoutSeconds: number;
-            kind: "marker";
-        } | {
-            path: string;
-            timeoutSeconds: number;
-            kind: "http";
-            expectedStatus?: number | undefined;
-        } | {
-            timeoutSeconds: number;
-            kind: "tcp";
-        } | {
-            kind: "process";
-            graceSeconds?: number | undefined;
-        };
         statePolicy: "clone" | "stateless" | "ephemeral" | "shared-compatible";
         migrationPolicy: "none" | "explicit-review" | "disposable-only";
         shutdown: {
@@ -2156,6 +2156,22 @@ export declare const developmentRuntimeSchema: z.ZodEffects<z.ZodObject<{
             diskBytes?: number | undefined;
         };
         id: string;
+        ready: {
+            path: string;
+            timeoutSeconds: number;
+            kind: "marker";
+        } | {
+            path: string;
+            timeoutSeconds: number;
+            kind: "http";
+            expectedStatus: number;
+        } | {
+            timeoutSeconds: number;
+            kind: "tcp";
+        } | {
+            kind: "process";
+            graceSeconds: number;
+        };
         kind: "package-watch" | "live-web" | "live-api" | "rebuild-restart" | "local-companion";
         platforms: ("linux-amd64" | "linux-arm64" | "darwin-arm64" | "darwin-amd64")[];
         runtimeRequirements: string[];
@@ -2212,22 +2228,6 @@ export declare const developmentRuntimeSchema: z.ZodEffects<z.ZodObject<{
                 cwd?: string | undefined;
             } | undefined;
         };
-        ready: {
-            path: string;
-            timeoutSeconds: number;
-            kind: "marker";
-        } | {
-            path: string;
-            timeoutSeconds: number;
-            kind: "http";
-            expectedStatus: number;
-        } | {
-            timeoutSeconds: number;
-            kind: "tcp";
-        } | {
-            kind: "process";
-            graceSeconds: number;
-        };
         outputs: {
             path: string;
             mediaType: string;
@@ -2300,6 +2300,22 @@ export declare const developmentRuntimeSchema: z.ZodEffects<z.ZodObject<{
     schemaVersion: "treeseed.development-runtime/v1";
     targets: {
         id: string;
+        ready: {
+            path: string;
+            timeoutSeconds: number;
+            kind: "marker";
+        } | {
+            path: string;
+            timeoutSeconds: number;
+            kind: "http";
+            expectedStatus?: number | undefined;
+        } | {
+            timeoutSeconds: number;
+            kind: "tcp";
+        } | {
+            kind: "process";
+            graceSeconds?: number | undefined;
+        };
         kind: "package-watch" | "live-web" | "live-api" | "rebuild-restart" | "local-companion";
         platforms: ("linux-amd64" | "linux-arm64" | "darwin-arm64" | "darwin-amd64")[];
         sourceRoots: string[];
@@ -2354,22 +2370,6 @@ export declare const developmentRuntimeSchema: z.ZodEffects<z.ZodObject<{
                 timeoutSeconds?: number | undefined;
             } | undefined;
         };
-        ready: {
-            path: string;
-            timeoutSeconds: number;
-            kind: "marker";
-        } | {
-            path: string;
-            timeoutSeconds: number;
-            kind: "http";
-            expectedStatus?: number | undefined;
-        } | {
-            timeoutSeconds: number;
-            kind: "tcp";
-        } | {
-            kind: "process";
-            graceSeconds?: number | undefined;
-        };
         statePolicy: "clone" | "stateless" | "ephemeral" | "shared-compatible";
         migrationPolicy: "none" | "explicit-review" | "disposable-only";
         shutdown: {
@@ -2454,6 +2454,22 @@ export declare const developmentRuntimeSchema: z.ZodEffects<z.ZodObject<{
             diskBytes?: number | undefined;
         };
         id: string;
+        ready: {
+            path: string;
+            timeoutSeconds: number;
+            kind: "marker";
+        } | {
+            path: string;
+            timeoutSeconds: number;
+            kind: "http";
+            expectedStatus: number;
+        } | {
+            timeoutSeconds: number;
+            kind: "tcp";
+        } | {
+            kind: "process";
+            graceSeconds: number;
+        };
         kind: "package-watch" | "live-web" | "live-api" | "rebuild-restart" | "local-companion";
         platforms: ("linux-amd64" | "linux-arm64" | "darwin-arm64" | "darwin-amd64")[];
         runtimeRequirements: string[];
@@ -2510,22 +2526,6 @@ export declare const developmentRuntimeSchema: z.ZodEffects<z.ZodObject<{
                 cwd?: string | undefined;
             } | undefined;
         };
-        ready: {
-            path: string;
-            timeoutSeconds: number;
-            kind: "marker";
-        } | {
-            path: string;
-            timeoutSeconds: number;
-            kind: "http";
-            expectedStatus: number;
-        } | {
-            timeoutSeconds: number;
-            kind: "tcp";
-        } | {
-            kind: "process";
-            graceSeconds: number;
-        };
         outputs: {
             path: string;
             mediaType: string;
@@ -2598,6 +2598,22 @@ export declare const developmentRuntimeSchema: z.ZodEffects<z.ZodObject<{
     schemaVersion: "treeseed.development-runtime/v1";
     targets: {
         id: string;
+        ready: {
+            path: string;
+            timeoutSeconds: number;
+            kind: "marker";
+        } | {
+            path: string;
+            timeoutSeconds: number;
+            kind: "http";
+            expectedStatus?: number | undefined;
+        } | {
+            timeoutSeconds: number;
+            kind: "tcp";
+        } | {
+            kind: "process";
+            graceSeconds?: number | undefined;
+        };
         kind: "package-watch" | "live-web" | "live-api" | "rebuild-restart" | "local-companion";
         platforms: ("linux-amd64" | "linux-arm64" | "darwin-arm64" | "darwin-amd64")[];
         sourceRoots: string[];
@@ -2652,22 +2668,6 @@ export declare const developmentRuntimeSchema: z.ZodEffects<z.ZodObject<{
                 timeoutSeconds?: number | undefined;
             } | undefined;
         };
-        ready: {
-            path: string;
-            timeoutSeconds: number;
-            kind: "marker";
-        } | {
-            path: string;
-            timeoutSeconds: number;
-            kind: "http";
-            expectedStatus?: number | undefined;
-        } | {
-            timeoutSeconds: number;
-            kind: "tcp";
-        } | {
-            kind: "process";
-            graceSeconds?: number | undefined;
-        };
         statePolicy: "clone" | "stateless" | "ephemeral" | "shared-compatible";
         migrationPolicy: "none" | "explicit-review" | "disposable-only";
         shutdown: {

package/dist/platform/contracts.d.ts

@@ -149,6 +149,20 @@ export declare const projectCreatePlanSchema: z.ZodObject<{
         visibility: "public" | "private";
     }>;
     steps: z.ZodArray<z.ZodEnum<["project", "repository", "template", "library", "inventory"]>, "many">;
+    actions: z.ZodArray<z.ZodObject<{
+        step: z.ZodEnum<["project", "repository", "template", "library", "inventory"]>;
+        action: z.ZodEnum<["create", "adopt", "apply", "bind", "publish", "noop", "blocked"]>;
+    }, "strip", z.ZodTypeAny, {
+        action: "noop" | "blocked" | "create" | "adopt" | "apply" | "bind" | "publish";
+        step: "project" | "library" | "repository" | "template" | "inventory";
+    }, {
+        action: "noop" | "blocked" | "create" | "adopt" | "apply" | "bind" | "publish";
+        step: "project" | "library" | "repository" | "template" | "inventory";
+    }>, "many">;
+    observationDigest: z.ZodString;
+    planDigest: z.ZodString;
+    ok: z.ZodBoolean;
+    blockers: z.ZodArray<z.ZodString, "many">;
 }, "strict", z.ZodTypeAny, {
     slug: string;
     schemaVersion: "treeseed.platform-project-create-plan/v1";
@@ -157,6 +171,9 @@ export declare const projectCreatePlanSchema: z.ZodObject<{
         owner: string;
         visibility: "public" | "private";
     };
+    blockers: string[];
+    ok: boolean;
+    planDigest: string;
     template: {
         id: string;
         version: string;
@@ -164,6 +181,11 @@ export declare const projectCreatePlanSchema: z.ZodObject<{
     };
     team: string;
     steps: ("project" | "library" | "repository" | "template" | "inventory")[];
+    actions: {
+        action: "noop" | "blocked" | "create" | "adopt" | "apply" | "bind" | "publish";
+        step: "project" | "library" | "repository" | "template" | "inventory";
+    }[];
+    observationDigest: string;
 }, {
     slug: string;
     schemaVersion: "treeseed.platform-project-create-plan/v1";
@@ -172,6 +194,9 @@ export declare const projectCreatePlanSchema: z.ZodObject<{
         owner: string;
         visibility: "public" | "private";
     };
+    blockers: string[];
+    ok: boolean;
+    planDigest: string;
     template: {
         id: string;
         version: string;
@@ -179,9 +204,15 @@ export declare const projectCreatePlanSchema: z.ZodObject<{
     };
     team: string;
     steps: ("project" | "library" | "repository" | "template" | "inventory")[];
+    actions: {
+        action: "noop" | "blocked" | "create" | "adopt" | "apply" | "bind" | "publish";
+        step: "project" | "library" | "repository" | "template" | "inventory";
+    }[];
+    observationDigest: string;
 }>;
-export declare const projectCreateReceiptSchema: z.ZodObject<Omit<{
-    schemaVersion: z.ZodLiteral<"treeseed.platform-project-create-plan/v1">;
+export declare const projectCreateReceiptSchema: z.ZodObject<{
+    schemaVersion: z.ZodLiteral<"treeseed.platform-project-create-receipt/v1">;
+    planDigest: z.ZodString;
     slug: z.ZodString;
     template: z.ZodObject<{
         id: z.ZodString;
@@ -210,13 +241,20 @@ export declare const projectCreateReceiptSchema: z.ZodObject<Omit<{
         owner: string;
         visibility: "public" | "private";
     }>;
-    steps: z.ZodArray<z.ZodEnum<["project", "repository", "template", "library", "inventory"]>, "many">;
-}, "schemaVersion"> & {
-    schemaVersion: z.ZodLiteral<"treeseed.platform-project-create-receipt/v1">;
     projectId: z.ZodString;
     repositoryUrl: z.ZodString;
     libraryBindingId: z.ZodString;
     inventoryVersion: z.ZodNumber;
+    actions: z.ZodArray<z.ZodObject<{
+        step: z.ZodEnum<["project", "repository", "template", "library", "inventory"]>;
+        action: z.ZodEnum<["create", "adopt", "apply", "bind", "publish", "noop", "blocked"]>;
+    }, "strip", z.ZodTypeAny, {
+        action: "noop" | "blocked" | "create" | "adopt" | "apply" | "bind" | "publish";
+        step: "project" | "library" | "repository" | "template" | "inventory";
+    }, {
+        action: "noop" | "blocked" | "create" | "adopt" | "apply" | "bind" | "publish";
+        step: "project" | "library" | "repository" | "template" | "inventory";
+    }>, "many">;
 }, "strict", z.ZodTypeAny, {
     slug: string;
     schemaVersion: "treeseed.platform-project-create-receipt/v1";
@@ -225,13 +263,17 @@ export declare const projectCreateReceiptSchema: z.ZodObject<Omit<{
         owner: string;
         visibility: "public" | "private";
     };
+    planDigest: string;
     template: {
         id: string;
         version: string;
         digest: string;
     };
     team: string;
-    steps: ("project" | "library" | "repository" | "template" | "inventory")[];
+    actions: {
+        action: "noop" | "blocked" | "create" | "adopt" | "apply" | "bind" | "publish";
+        step: "project" | "library" | "repository" | "template" | "inventory";
+    }[];
     projectId: string;
     repositoryUrl: string;
     libraryBindingId: string;
@@ -244,13 +286,17 @@ export declare const projectCreateReceiptSchema: z.ZodObject<Omit<{
         owner: string;
         visibility: "public" | "private";
     };
+    planDigest: string;
     template: {
         id: string;
         version: string;
         digest: string;
     };
     team: string;
-    steps: ("project" | "library" | "repository" | "template" | "inventory")[];
+    actions: {
+        action: "noop" | "blocked" | "create" | "adopt" | "apply" | "bind" | "publish";
+        step: "project" | "library" | "repository" | "template" | "inventory";
+    }[];
     projectId: string;
     repositoryUrl: string;
     libraryBindingId: string;

package/dist/platform/contracts.js

@@ -27,14 +27,28 @@ const projectCreatePlanSchema = z.object({
   template: z.object({ id: z.string().min(1), version: z.string().min(1), digest }),
   team: z.string().min(1),
   repository: z.object({ owner: z.string().min(1), name: z.string().min(1), visibility: z.enum(["public", "private"]) }),
-  steps: z.array(z.enum(["project", "repository", "template", "library", "inventory"]))
+  steps: z.array(z.enum(["project", "repository", "template", "library", "inventory"])),
+  actions: z.array(z.object({
+    step: z.enum(["project", "repository", "template", "library", "inventory"]),
+    action: z.enum(["create", "adopt", "apply", "bind", "publish", "noop", "blocked"])
+  })),
+  observationDigest: digest,
+  planDigest: digest,
+  ok: z.boolean(),
+  blockers: z.array(z.string())
 }).strict();
-const projectCreateReceiptSchema = projectCreatePlanSchema.omit({ schemaVersion: true }).extend({
+const projectCreateReceiptSchema = z.object({
   schemaVersion: z.literal("treeseed.platform-project-create-receipt/v1"),
+  planDigest: digest,
+  slug: projectCreatePlanSchema.shape.slug,
+  template: projectCreatePlanSchema.shape.template,
+  team: z.string().min(1),
+  repository: projectCreatePlanSchema.shape.repository,
   projectId: z.string().min(1),
   repositoryUrl: z.string().url(),
   libraryBindingId: z.string().min(1),
-  inventoryVersion: z.number().int().positive()
+  inventoryVersion: z.number().int().positive(),
+  actions: projectCreatePlanSchema.shape.actions
 }).strict();
 const providerRegistrationRequestSchema = z.object({
   schemaVersion: z.literal("treeseed.provider-registration-request/v1"),

package/dist/platform/index.d.ts

@@ -1,5 +1,6 @@
 export * from './schemas.js';
 export * from './contracts.js';
 export * from './inventory.js';
+export * from './project-create.js';
 export * from './workset.js';
 export * from './verification.js';

package/dist/platform/index.js

@@ -1,5 +1,6 @@
 export * from "./schemas.js";
 export * from "./contracts.js";
 export * from "./inventory.js";
+export * from "./project-create.js";
 export * from "./workset.js";
 export * from "./verification.js";

package/dist/platform/project-create.d.ts

@@ -0,0 +1,49 @@
+import { type ProjectCreatePlan, type ProjectCreateReceipt } from './contracts.js';
+export type ProjectCreateStep = 'project' | 'repository' | 'template' | 'library' | 'inventory';
+export type ProjectCreateState = 'missing' | 'ready' | 'conflict';
+export interface ProjectCreateTarget {
+    slug: string;
+    template: {
+        id: string;
+        version: string;
+        digest: string;
+    };
+    team: string;
+    repository: {
+        owner: string;
+        name: string;
+        visibility: 'public' | 'private';
+    };
+}
+export interface ProjectCreateObservation {
+    project: {
+        state: ProjectCreateState;
+        id?: string;
+    };
+    repository: {
+        state: ProjectCreateState;
+        url?: string;
+    };
+    template: {
+        state: ProjectCreateState;
+        digest?: string;
+    };
+    library: {
+        state: ProjectCreateState;
+        bindingId?: string;
+    };
+    inventory: {
+        state: ProjectCreateState;
+        version?: number;
+    };
+}
+export interface ProjectCreateAuthority {
+    observe(target: ProjectCreateTarget): Promise<ProjectCreateObservation>;
+    reconcileProject(target: ProjectCreateTarget): Promise<void>;
+    reconcileRepository(target: ProjectCreateTarget): Promise<void>;
+    applyTemplate(target: ProjectCreateTarget): Promise<void>;
+    reconcileLibrary(target: ProjectCreateTarget): Promise<void>;
+    publishInventory(target: ProjectCreateTarget): Promise<void>;
+}
+export declare function planPlatformProjectCreate(target: ProjectCreateTarget, authority: Pick<ProjectCreateAuthority, 'observe'>): Promise<ProjectCreatePlan>;
+export declare function applyPlatformProjectCreate(plan: ProjectCreatePlan, authority: ProjectCreateAuthority): Promise<ProjectCreateReceipt>;

package/dist/platform/project-create.js

@@ -0,0 +1,75 @@
+import { createHash } from "node:crypto";
+import { projectCreatePlanSchema, projectCreateReceiptSchema } from "./contracts.js";
+const steps = ["project", "repository", "template", "library", "inventory"];
+const actionFor = {
+  project: "create",
+  repository: "adopt",
+  template: "apply",
+  library: "bind",
+  inventory: "publish"
+};
+function canonical(value) {
+  if (Array.isArray(value)) return `[${value.map(canonical).join(",")}]`;
+  if (value && typeof value === "object") return `{${Object.entries(value).sort(([left], [right]) => left.localeCompare(right)).map(([key, item]) => `${JSON.stringify(key)}:${canonical(item)}`).join(",")}}`;
+  return JSON.stringify(value);
+}
+function digest(value) {
+  return `sha256:${createHash("sha256").update(canonical(value)).digest("hex")}`;
+}
+function blockers(observation) {
+  return steps.filter((step) => observation[step].state === "conflict").map((step) => `${step}_conflicts_with_requested_target`);
+}
+async function planPlatformProjectCreate(target, authority) {
+  const observation = await authority.observe(target);
+  const conflicts = blockers(observation);
+  const base = {
+    schemaVersion: "treeseed.platform-project-create-plan/v1",
+    ...target,
+    steps: [...steps],
+    actions: steps.map((step) => ({ step, action: observation[step].state === "ready" ? "noop" : observation[step].state === "conflict" ? "blocked" : actionFor[step] })),
+    observationDigest: digest(observation),
+    ok: conflicts.length === 0,
+    blockers: conflicts
+  };
+  return projectCreatePlanSchema.parse({ ...base, planDigest: digest(base) });
+}
+function requireReady(observation) {
+  const incomplete = steps.filter((step) => observation[step].state !== "ready");
+  if (incomplete.length) throw new Error(`Project creation postconditions are incomplete: ${incomplete.join(", ")}.`);
+  if (!observation.project.id || !observation.repository.url || !observation.library.bindingId || !observation.inventory.version) {
+    throw new Error("Project creation authority returned incomplete receipt identities.");
+  }
+}
+async function applyPlatformProjectCreate(plan, authority) {
+  const accepted = projectCreatePlanSchema.parse(plan);
+  const { planDigest: _planDigest, ...unsigned } = accepted;
+  if (digest(unsigned) !== accepted.planDigest) throw new Error("Project creation plan digest does not match its frozen inputs.");
+  if (!accepted.ok || accepted.blockers.length) throw new Error("Blocked project creation plans cannot be applied.");
+  const target = { slug: accepted.slug, template: accepted.template, team: accepted.team, repository: accepted.repository };
+  const current = await authority.observe(target);
+  if (digest(current) !== accepted.observationDigest) throw new Error("Project creation authority changed after planning; create a new plan.");
+  const operations = {
+    project: authority.reconcileProject,
+    repository: authority.reconcileRepository,
+    template: authority.applyTemplate,
+    library: authority.reconcileLibrary,
+    inventory: authority.publishInventory
+  };
+  for (const item of accepted.actions) if (item.action !== "noop") await operations[item.step].call(authority, target);
+  const final = await authority.observe(target);
+  requireReady(final);
+  return projectCreateReceiptSchema.parse({
+    schemaVersion: "treeseed.platform-project-create-receipt/v1",
+    planDigest: accepted.planDigest,
+    ...target,
+    projectId: final.project.id,
+    repositoryUrl: final.repository.url,
+    libraryBindingId: final.library.bindingId,
+    inventoryVersion: final.inventory.version,
+    actions: accepted.actions
+  });
+}
+export {
+  applyPlatformProjectCreate,
+  planPlatformProjectCreate
+};

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@treeseed/sdk",
-  "version": "0.13.0-rc.67",
+  "version": "0.13.0-rc.68",
   "description": "Portable TreeSeed contracts, standards, and typed remote control-plane clients.",
   "license": "Apache-2.0",
   "repository": {