@treeseed/sdk 0.13.0-rc.34 → 0.13.0-rc.35

package/dist/content/validation/agent-operational-content-schemas.d.ts

@@ -172,15 +172,15 @@ export declare const discussionTopicContentSchema: z.ZodObject<{
     status: "active" | "archived";
     id: string;
     description: string;
-    title: string;
     slug: string;
+    title: string;
     groupIds: string[];
     parentTopicId?: string | undefined;
 }, {
     id: string;
     description: string;
-    title: string;
     slug: string;
+    title: string;
     groupIds: string[];
     status?: "active" | "archived" | undefined;
     parentTopicId?: string | undefined;
@@ -842,15 +842,15 @@ export declare const agentOperationalContentSchemas: {
         status: "active" | "archived";
         id: string;
         description: string;
-        title: string;
         slug: string;
+        title: string;
         groupIds: string[];
         parentTopicId?: string | undefined;
     }, {
         id: string;
         description: string;
-        title: string;
         slug: string;
+        title: string;
         groupIds: string[];
         status?: "active" | "archived" | undefined;
         parentTopicId?: string | undefined;

package/dist/content/validation/auxiliary-content-schemas.d.ts

@@ -37,8 +37,8 @@ export declare const workdayContentSchema: z.ZodObject<{
         priority: number;
         status?: string | undefined;
         reason?: string | undefined;
-        title?: string | undefined;
         slug?: string | undefined;
+        title?: string | undefined;
         estimatedCredits?: number | undefined;
     }, {
         id: string;
@@ -46,8 +46,8 @@ export declare const workdayContentSchema: z.ZodObject<{
         priority: number;
         status?: string | undefined;
         reason?: string | undefined;
-        title?: string | undefined;
         slug?: string | undefined;
+        title?: string | undefined;
         estimatedCredits?: number | undefined;
     }>, "many">>;
     totalTasks: z.ZodDefault<z.ZodNumber>;
@@ -138,14 +138,14 @@ export declare const workdayContentSchema: z.ZodObject<{
     metadata: z.ZodDefault<z.ZodRecord<z.ZodString, z.ZodUnknown>>;
 }, "strip", z.ZodTypeAny, {
     status: string;
+    environment: string;
     visibility: "private" | "team" | "public" | "authenticated";
     summary: string;
     projectId: string;
-    title: string;
-    startedAt: Date;
     slug: string;
     metadata: Record<string, unknown>;
-    environment: string;
+    title: string;
+    startedAt: Date;
     changedFiles: string[];
     workDayId: string;
     reportVersion: string;
@@ -163,8 +163,8 @@ export declare const workdayContentSchema: z.ZodObject<{
         priority: number;
         status?: string | undefined;
         reason?: string | undefined;
-        title?: string | undefined;
         slug?: string | undefined;
+        title?: string | undefined;
         estimatedCredits?: number | undefined;
     }[];
     totalTasks: number;
@@ -206,12 +206,12 @@ export declare const workdayContentSchema: z.ZodObject<{
     endedAt?: Date | null | undefined;
     prioritySnapshotId?: string | null | undefined;
 }, {
+    environment: string;
     summary: string;
     projectId: string;
+    slug: string;
     title: string;
     startedAt: Date;
-    slug: string;
-    environment: string;
     workDayId: string;
     reportVersion: string;
     workdayState: string;
@@ -236,8 +236,8 @@ export declare const workdayContentSchema: z.ZodObject<{
         priority: number;
         status?: string | undefined;
         reason?: string | undefined;
-        title?: string | undefined;
         slug?: string | undefined;
+        title?: string | undefined;
         estimatedCredits?: number | undefined;
     }[] | undefined;
     totalTasks?: number | undefined;
@@ -316,15 +316,15 @@ export declare const templateProductContentSchema: z.ZodObject<{
             integrity: z.ZodOptional<z.ZodString>;
         }, "strip", z.ZodTypeAny, {
             kind: "git";
+            ref: string;
             repoUrl: string;
             directory: string;
-            ref: string;
             integrity?: string | undefined;
         }, {
             kind: "git";
+            ref: string;
             repoUrl: string;
             directory: string;
-            ref: string;
             integrity?: string | undefined;
         }>, z.ZodObject<{
             kind: z.ZodLiteral<"r2">;
@@ -354,9 +354,9 @@ export declare const templateProductContentSchema: z.ZodObject<{
         mode: "packaged" | "git" | "r2";
         source: {
             kind: "git";
+            ref: string;
             repoUrl: string;
             directory: string;
-            ref: string;
             integrity?: string | undefined;
         } | {
             kind: "r2";
@@ -371,9 +371,9 @@ export declare const templateProductContentSchema: z.ZodObject<{
     }, {
         source: {
             kind: "git";
+            ref: string;
             repoUrl: string;
             directory: string;
-            ref: string;
             integrity?: string | undefined;
         } | {
             kind: "r2";
@@ -408,8 +408,8 @@ export declare const templateProductContentSchema: z.ZodObject<{
     audience: string[];
     description: string;
     summary: string;
-    title: string;
     slug: string;
+    title: string;
     groupIds: string[];
     featured: boolean;
     listingEnabled: boolean;
@@ -428,9 +428,9 @@ export declare const templateProductContentSchema: z.ZodObject<{
         mode: "packaged" | "git" | "r2";
         source: {
             kind: "git";
+            ref: string;
             repoUrl: string;
             directory: string;
-            ref: string;
             integrity?: string | undefined;
         } | {
             kind: "r2";
@@ -457,8 +457,8 @@ export declare const templateProductContentSchema: z.ZodObject<{
     status: "archived" | "draft" | "live";
     description: string;
     summary: string;
-    title: string;
     slug: string;
+    title: string;
     category: string;
     publisher: {
         id: string;
@@ -472,9 +472,9 @@ export declare const templateProductContentSchema: z.ZodObject<{
     fulfillment: {
         source: {
             kind: "git";
+            ref: string;
             repoUrl: string;
             directory: string;
-            ref: string;
             integrity?: string | undefined;
         } | {
             kind: "r2";
@@ -1245,8 +1245,8 @@ export declare const auxiliaryContentSchemas: {
             priority: number;
             status?: string | undefined;
             reason?: string | undefined;
-            title?: string | undefined;
             slug?: string | undefined;
+            title?: string | undefined;
             estimatedCredits?: number | undefined;
         }, {
             id: string;
@@ -1254,8 +1254,8 @@ export declare const auxiliaryContentSchemas: {
             priority: number;
             status?: string | undefined;
             reason?: string | undefined;
-            title?: string | undefined;
             slug?: string | undefined;
+            title?: string | undefined;
             estimatedCredits?: number | undefined;
         }>, "many">>;
         totalTasks: z.ZodDefault<z.ZodNumber>;
@@ -1346,14 +1346,14 @@ export declare const auxiliaryContentSchemas: {
         metadata: z.ZodDefault<z.ZodRecord<z.ZodString, z.ZodUnknown>>;
     }, "strip", z.ZodTypeAny, {
         status: string;
+        environment: string;
         visibility: "private" | "team" | "public" | "authenticated";
         summary: string;
         projectId: string;
-        title: string;
-        startedAt: Date;
         slug: string;
         metadata: Record<string, unknown>;
-        environment: string;
+        title: string;
+        startedAt: Date;
         changedFiles: string[];
         workDayId: string;
         reportVersion: string;
@@ -1371,8 +1371,8 @@ export declare const auxiliaryContentSchemas: {
             priority: number;
             status?: string | undefined;
             reason?: string | undefined;
-            title?: string | undefined;
             slug?: string | undefined;
+            title?: string | undefined;
             estimatedCredits?: number | undefined;
         }[];
         totalTasks: number;
@@ -1414,12 +1414,12 @@ export declare const auxiliaryContentSchemas: {
         endedAt?: Date | null | undefined;
         prioritySnapshotId?: string | null | undefined;
     }, {
+        environment: string;
         summary: string;
         projectId: string;
+        slug: string;
         title: string;
         startedAt: Date;
-        slug: string;
-        environment: string;
         workDayId: string;
         reportVersion: string;
         workdayState: string;
@@ -1444,8 +1444,8 @@ export declare const auxiliaryContentSchemas: {
             priority: number;
             status?: string | undefined;
             reason?: string | undefined;
-            title?: string | undefined;
             slug?: string | undefined;
+            title?: string | undefined;
             estimatedCredits?: number | undefined;
         }[] | undefined;
         totalTasks?: number | undefined;
@@ -1524,15 +1524,15 @@ export declare const auxiliaryContentSchemas: {
                 integrity: z.ZodOptional<z.ZodString>;
             }, "strip", z.ZodTypeAny, {
                 kind: "git";
+                ref: string;
                 repoUrl: string;
                 directory: string;
-                ref: string;
                 integrity?: string | undefined;
             }, {
                 kind: "git";
+                ref: string;
                 repoUrl: string;
                 directory: string;
-                ref: string;
                 integrity?: string | undefined;
             }>, z.ZodObject<{
                 kind: z.ZodLiteral<"r2">;
@@ -1562,9 +1562,9 @@ export declare const auxiliaryContentSchemas: {
             mode: "packaged" | "git" | "r2";
             source: {
                 kind: "git";
+                ref: string;
                 repoUrl: string;
                 directory: string;
-                ref: string;
                 integrity?: string | undefined;
             } | {
                 kind: "r2";
@@ -1579,9 +1579,9 @@ export declare const auxiliaryContentSchemas: {
         }, {
             source: {
                 kind: "git";
+                ref: string;
                 repoUrl: string;
                 directory: string;
-                ref: string;
                 integrity?: string | undefined;
             } | {
                 kind: "r2";
@@ -1616,8 +1616,8 @@ export declare const auxiliaryContentSchemas: {
         audience: string[];
         description: string;
         summary: string;
-        title: string;
         slug: string;
+        title: string;
         groupIds: string[];
         featured: boolean;
         listingEnabled: boolean;
@@ -1636,9 +1636,9 @@ export declare const auxiliaryContentSchemas: {
             mode: "packaged" | "git" | "r2";
             source: {
                 kind: "git";
+                ref: string;
                 repoUrl: string;
                 directory: string;
-                ref: string;
                 integrity?: string | undefined;
             } | {
                 kind: "r2";
@@ -1665,8 +1665,8 @@ export declare const auxiliaryContentSchemas: {
         status: "archived" | "draft" | "live";
         description: string;
         summary: string;
-        title: string;
         slug: string;
+        title: string;
         category: string;
         publisher: {
             id: string;
@@ -1680,9 +1680,9 @@ export declare const auxiliaryContentSchemas: {
         fulfillment: {
             source: {
                 kind: "git";
+                ref: string;
                 repoUrl: string;
                 directory: string;
-                ref: string;
                 integrity?: string | undefined;
             } | {
                 kind: "r2";

package/dist/content/validation/content-model-schemas.d.ts

@@ -175,15 +175,15 @@ declare const schemas: {
         status: "active" | "archived";
         id: string;
         description: string;
-        title: string;
         slug: string;
+        title: string;
         groupIds: string[];
         parentTopicId?: string | undefined;
     }, {
         id: string;
         description: string;
-        title: string;
         slug: string;
+        title: string;
         groupIds: string[];
         status?: "active" | "archived" | undefined;
         parentTopicId?: string | undefined;
@@ -1060,8 +1060,8 @@ declare const schemas: {
             priority: number;
             status?: string | undefined;
             reason?: string | undefined;
-            title?: string | undefined;
             slug?: string | undefined;
+            title?: string | undefined;
             estimatedCredits?: number | undefined;
         }, {
             id: string;
@@ -1069,8 +1069,8 @@ declare const schemas: {
             priority: number;
             status?: string | undefined;
             reason?: string | undefined;
-            title?: string | undefined;
             slug?: string | undefined;
+            title?: string | undefined;
             estimatedCredits?: number | undefined;
         }>, "many">>;
         totalTasks: z.ZodDefault<z.ZodNumber>;
@@ -1161,14 +1161,14 @@ declare const schemas: {
         metadata: z.ZodDefault<z.ZodRecord<z.ZodString, z.ZodUnknown>>;
     }, "strip", z.ZodTypeAny, {
         status: string;
+        environment: string;
         visibility: "private" | "team" | "public" | "authenticated";
         summary: string;
         projectId: string;
-        title: string;
-        startedAt: Date;
         slug: string;
         metadata: Record<string, unknown>;
-        environment: string;
+        title: string;
+        startedAt: Date;
         changedFiles: string[];
         workDayId: string;
         reportVersion: string;
@@ -1186,8 +1186,8 @@ declare const schemas: {
             priority: number;
             status?: string | undefined;
             reason?: string | undefined;
-            title?: string | undefined;
             slug?: string | undefined;
+            title?: string | undefined;
             estimatedCredits?: number | undefined;
         }[];
         totalTasks: number;
@@ -1229,12 +1229,12 @@ declare const schemas: {
         endedAt?: Date | null | undefined;
         prioritySnapshotId?: string | null | undefined;
     }, {
+        environment: string;
         summary: string;
         projectId: string;
+        slug: string;
         title: string;
         startedAt: Date;
-        slug: string;
-        environment: string;
         workDayId: string;
         reportVersion: string;
         workdayState: string;
@@ -1259,8 +1259,8 @@ declare const schemas: {
             priority: number;
             status?: string | undefined;
             reason?: string | undefined;
-            title?: string | undefined;
             slug?: string | undefined;
+            title?: string | undefined;
             estimatedCredits?: number | undefined;
         }[] | undefined;
         totalTasks?: number | undefined;
@@ -1339,15 +1339,15 @@ declare const schemas: {
                 integrity: z.ZodOptional<z.ZodString>;
             }, "strip", z.ZodTypeAny, {
                 kind: "git";
+                ref: string;
                 repoUrl: string;
                 directory: string;
-                ref: string;
                 integrity?: string | undefined;
             }, {
                 kind: "git";
+                ref: string;
                 repoUrl: string;
                 directory: string;
-                ref: string;
                 integrity?: string | undefined;
             }>, z.ZodObject<{
                 kind: z.ZodLiteral<"r2">;
@@ -1377,9 +1377,9 @@ declare const schemas: {
             mode: "packaged" | "git" | "r2";
             source: {
                 kind: "git";
+                ref: string;
                 repoUrl: string;
                 directory: string;
-                ref: string;
                 integrity?: string | undefined;
             } | {
                 kind: "r2";
@@ -1394,9 +1394,9 @@ declare const schemas: {
         }, {
             source: {
                 kind: "git";
+                ref: string;
                 repoUrl: string;
                 directory: string;
-                ref: string;
                 integrity?: string | undefined;
             } | {
                 kind: "r2";
@@ -1431,8 +1431,8 @@ declare const schemas: {
         audience: string[];
         description: string;
         summary: string;
-        title: string;
         slug: string;
+        title: string;
         groupIds: string[];
         featured: boolean;
         listingEnabled: boolean;
@@ -1451,9 +1451,9 @@ declare const schemas: {
             mode: "packaged" | "git" | "r2";
             source: {
                 kind: "git";
+                ref: string;
                 repoUrl: string;
                 directory: string;
-                ref: string;
                 integrity?: string | undefined;
             } | {
                 kind: "r2";
@@ -1480,8 +1480,8 @@ declare const schemas: {
         status: "archived" | "draft" | "live";
         description: string;
         summary: string;
-        title: string;
         slug: string;
+        title: string;
         category: string;
         publisher: {
             id: string;
@@ -1495,9 +1495,9 @@ declare const schemas: {
         fulfillment: {
             source: {
                 kind: "git";
+                ref: string;
                 repoUrl: string;
                 directory: string;
-                ref: string;
                 integrity?: string | undefined;
             } | {
                 kind: "r2";
@@ -1544,8 +1544,8 @@ declare const schemas: {
         description?: string | undefined;
         summary?: string | undefined;
         stage?: string | undefined;
-        updated_at?: Date | undefined;
         slug?: string | undefined;
+        updated_at?: Date | undefined;
         page_layout?: "article" | "bridge" | undefined;
     }, {
         title: string;
@@ -1554,8 +1554,8 @@ declare const schemas: {
         description?: string | undefined;
         summary?: string | undefined;
         stage?: string | undefined;
-        updated_at?: Date | undefined;
         slug?: string | undefined;
+        updated_at?: Date | undefined;
         page_layout?: "article" | "bridge" | undefined;
     }>;
     note: z.ZodObject<{
@@ -1964,27 +1964,27 @@ declare const schemas: {
         audience: z.ZodOptional<z.ZodArray<z.ZodString, "many">>;
         relatedBookIds: z.ZodOptional<z.ZodArray<z.ZodString, "many">>;
     }, "strip", z.ZodTypeAny, {
-        status: "archived" | "review" | "draft" | "published";
+        status: "review" | "archived" | "draft" | "published";
         schemaVersion: "treeseed.book/v2";
         id: string;
         visibility: "team" | "project" | "public" | "authenticated" | "admin";
         order: number;
         summary: string;
-        title: string;
         slug: string;
+        title: string;
         audience?: string[] | undefined;
         description?: string | undefined;
         groupIds?: string[] | undefined;
         relatedBookIds?: string[] | undefined;
     }, {
-        status: "archived" | "review" | "draft" | "published";
+        status: "review" | "archived" | "draft" | "published";
         schemaVersion: "treeseed.book/v2";
         id: string;
         visibility: "team" | "project" | "public" | "authenticated" | "admin";
         order: number;
         summary: string;
-        title: string;
         slug: string;
+        title: string;
         audience?: string[] | undefined;
         description?: string | undefined;
         groupIds?: string[] | undefined;
@@ -2003,25 +2003,25 @@ declare const schemas: {
         order: z.ZodOptional<z.ZodNumber>;
         groupIds: z.ZodOptional<z.ZodArray<z.ZodString, "many">>;
     }, "strip", z.ZodTypeAny, {
-        status: "archived" | "review" | "draft" | "published";
+        status: "review" | "archived" | "draft" | "published";
         schemaVersion: "treeseed.knowledge-page/v1";
         id: string;
         visibility: "team" | "project" | "public" | "authenticated" | "admin";
         summary: string;
-        title: string;
         slug: string;
+        title: string;
         bookId: string;
         order?: number | undefined;
         description?: string | undefined;
         groupIds?: string[] | undefined;
     }, {
-        status: "archived" | "review" | "draft" | "published";
+        status: "review" | "archived" | "draft" | "published";
         schemaVersion: "treeseed.knowledge-page/v1";
         id: string;
         visibility: "team" | "project" | "public" | "authenticated" | "admin";
         summary: string;
-        title: string;
         slug: string;
+        title: string;
         bookId: string;
         order?: number | undefined;
         description?: string | undefined;
@@ -11362,14 +11362,14 @@ export declare function validateContentFrontmatter(model: PortableContentModel,
         }>>;
     }, z.ZodTypeAny, "passthrough"> | {
         status: string;
+        environment: string;
         visibility: "private" | "team" | "public" | "authenticated";
         summary: string;
         projectId: string;
-        title: string;
-        startedAt: Date;
         slug: string;
         metadata: Record<string, unknown>;
-        environment: string;
+        title: string;
+        startedAt: Date;
         changedFiles: string[];
         workDayId: string;
         reportVersion: string;
@@ -11387,8 +11387,8 @@ export declare function validateContentFrontmatter(model: PortableContentModel,
             priority: number;
             status?: string | undefined;
             reason?: string | undefined;
-            title?: string | undefined;
             slug?: string | undefined;
+            title?: string | undefined;
             estimatedCredits?: number | undefined;
         }[];
         totalTasks: number;
@@ -11434,8 +11434,8 @@ export declare function validateContentFrontmatter(model: PortableContentModel,
         audience: string[];
         description: string;
         summary: string;
-        title: string;
         slug: string;
+        title: string;
         groupIds: string[];
         featured: boolean;
         listingEnabled: boolean;
@@ -11454,9 +11454,9 @@ export declare function validateContentFrontmatter(model: PortableContentModel,
             mode: "packaged" | "git" | "r2";
             source: {
                 kind: "git";
+                ref: string;
                 repoUrl: string;
                 directory: string;
-                ref: string;
                 integrity?: string | undefined;
             } | {
                 kind: "r2";
@@ -11573,8 +11573,8 @@ export declare function validateContentFrontmatter(model: PortableContentModel,
         status: "active" | "archived";
         id: string;
         description: string;
-        title: string;
         slug: string;
+        title: string;
         groupIds: string[];
         parentTopicId?: string | undefined;
     } | {
@@ -11701,8 +11701,8 @@ export declare function validateContentFrontmatter(model: PortableContentModel,
         description?: string | undefined;
         summary?: string | undefined;
         stage?: string | undefined;
-        updated_at?: Date | undefined;
         slug?: string | undefined;
+        updated_at?: Date | undefined;
         page_layout?: "article" | "bridge" | undefined;
     } | {
         title: string;
@@ -11818,26 +11818,26 @@ export declare function validateContentFrontmatter(model: PortableContentModel,
         decision_type?: "approved" | "rejected" | "deferred" | "superseded" | "request_changes" | undefined;
         rationale?: string | undefined;
     } | {
-        status: "archived" | "review" | "draft" | "published";
+        status: "review" | "archived" | "draft" | "published";
         schemaVersion: "treeseed.book/v2";
         id: string;
         visibility: "team" | "project" | "public" | "authenticated" | "admin";
         order: number;
         summary: string;
-        title: string;
         slug: string;
+        title: string;
         audience?: string[] | undefined;
         description?: string | undefined;
         groupIds?: string[] | undefined;
         relatedBookIds?: string[] | undefined;
     } | {
-        status: "archived" | "review" | "draft" | "published";
+        status: "review" | "archived" | "draft" | "published";
         schemaVersion: "treeseed.knowledge-page/v1";
         id: string;
         visibility: "team" | "project" | "public" | "authenticated" | "admin";
         summary: string;
-        title: string;
         slug: string;
+        title: string;
         bookId: string;
         order?: number | undefined;
         description?: string | undefined;
@@ -19561,8 +19561,8 @@ export declare function describeContentFrontmatterSchema(model: PortableContentM
         priority: number;
         status?: string | undefined;
         reason?: string | undefined;
-        title?: string | undefined;
         slug?: string | undefined;
+        title?: string | undefined;
         estimatedCredits?: number | undefined;
     }, {
         id: string;
@@ -19570,8 +19570,8 @@ export declare function describeContentFrontmatterSchema(model: PortableContentM
         priority: number;
         status?: string | undefined;
         reason?: string | undefined;
-        title?: string | undefined;
         slug?: string | undefined;
+        title?: string | undefined;
         estimatedCredits?: number | undefined;
     }>, "many">>;
     totalTasks: z.ZodDefault<z.ZodNumber>;
@@ -19662,14 +19662,14 @@ export declare function describeContentFrontmatterSchema(model: PortableContentM
     metadata: z.ZodDefault<z.ZodRecord<z.ZodString, z.ZodUnknown>>;
 }, "strip", z.ZodTypeAny, {
     status: string;
+    environment: string;
     visibility: "private" | "team" | "public" | "authenticated";
     summary: string;
     projectId: string;
-    title: string;
-    startedAt: Date;
     slug: string;
     metadata: Record<string, unknown>;
-    environment: string;
+    title: string;
+    startedAt: Date;
     changedFiles: string[];
     workDayId: string;
     reportVersion: string;
@@ -19687,8 +19687,8 @@ export declare function describeContentFrontmatterSchema(model: PortableContentM
         priority: number;
         status?: string | undefined;
         reason?: string | undefined;
-        title?: string | undefined;
         slug?: string | undefined;
+        title?: string | undefined;
         estimatedCredits?: number | undefined;
     }[];
     totalTasks: number;
@@ -19730,12 +19730,12 @@ export declare function describeContentFrontmatterSchema(model: PortableContentM
     endedAt?: Date | null | undefined;
     prioritySnapshotId?: string | null | undefined;
 }, {
+    environment: string;
     summary: string;
     projectId: string;
+    slug: string;
     title: string;
     startedAt: Date;
-    slug: string;
-    environment: string;
     workDayId: string;
     reportVersion: string;
     workdayState: string;
@@ -19760,8 +19760,8 @@ export declare function describeContentFrontmatterSchema(model: PortableContentM
         priority: number;
         status?: string | undefined;
         reason?: string | undefined;
-        title?: string | undefined;
         slug?: string | undefined;
+        title?: string | undefined;
         estimatedCredits?: number | undefined;
     }[] | undefined;
     totalTasks?: number | undefined;
@@ -19839,15 +19839,15 @@ export declare function describeContentFrontmatterSchema(model: PortableContentM
             integrity: z.ZodOptional<z.ZodString>;
         }, "strip", z.ZodTypeAny, {
             kind: "git";
+            ref: string;
             repoUrl: string;
             directory: string;
-            ref: string;
             integrity?: string | undefined;
         }, {
             kind: "git";
+            ref: string;
             repoUrl: string;
             directory: string;
-            ref: string;
             integrity?: string | undefined;
         }>, z.ZodObject<{
             kind: z.ZodLiteral<"r2">;
@@ -19877,9 +19877,9 @@ export declare function describeContentFrontmatterSchema(model: PortableContentM
         mode: "packaged" | "git" | "r2";
         source: {
             kind: "git";
+            ref: string;
             repoUrl: string;
             directory: string;
-            ref: string;
             integrity?: string | undefined;
         } | {
             kind: "r2";
@@ -19894,9 +19894,9 @@ export declare function describeContentFrontmatterSchema(model: PortableContentM
     }, {
         source: {
             kind: "git";
+            ref: string;
             repoUrl: string;
             directory: string;
-            ref: string;
             integrity?: string | undefined;
         } | {
             kind: "r2";
@@ -19931,8 +19931,8 @@ export declare function describeContentFrontmatterSchema(model: PortableContentM
     audience: string[];
     description: string;
     summary: string;
-    title: string;
     slug: string;
+    title: string;
     groupIds: string[];
     featured: boolean;
     listingEnabled: boolean;
@@ -19951,9 +19951,9 @@ export declare function describeContentFrontmatterSchema(model: PortableContentM
         mode: "packaged" | "git" | "r2";
         source: {
             kind: "git";
+            ref: string;
             repoUrl: string;
             directory: string;
-            ref: string;
             integrity?: string | undefined;
         } | {
             kind: "r2";
@@ -19980,8 +19980,8 @@ export declare function describeContentFrontmatterSchema(model: PortableContentM
     status: "archived" | "draft" | "live";
     description: string;
     summary: string;
-    title: string;
     slug: string;
+    title: string;
     category: string;
     publisher: {
         id: string;
@@ -19995,9 +19995,9 @@ export declare function describeContentFrontmatterSchema(model: PortableContentM
     fulfillment: {
         source: {
             kind: "git";
+            ref: string;
             repoUrl: string;
             directory: string;
-            ref: string;
             integrity?: string | undefined;
         } | {
             kind: "r2";
@@ -20546,15 +20546,15 @@ export declare function describeContentFrontmatterSchema(model: PortableContentM
     status: "active" | "archived";
     id: string;
     description: string;
-    title: string;
     slug: string;
+    title: string;
     groupIds: string[];
     parentTopicId?: string | undefined;
 }, {
     id: string;
     description: string;
-    title: string;
     slug: string;
+    title: string;
     groupIds: string[];
     status?: "active" | "archived" | undefined;
     parentTopicId?: string | undefined;
@@ -21054,8 +21054,8 @@ export declare function describeContentFrontmatterSchema(model: PortableContentM
     description?: string | undefined;
     summary?: string | undefined;
     stage?: string | undefined;
-    updated_at?: Date | undefined;
     slug?: string | undefined;
+    updated_at?: Date | undefined;
     page_layout?: "article" | "bridge" | undefined;
 }, {
     title: string;
@@ -21064,8 +21064,8 @@ export declare function describeContentFrontmatterSchema(model: PortableContentM
     description?: string | undefined;
     summary?: string | undefined;
     stage?: string | undefined;
-    updated_at?: Date | undefined;
     slug?: string | undefined;
+    updated_at?: Date | undefined;
     page_layout?: "article" | "bridge" | undefined;
 }> | z.ZodObject<{
     group_ids: z.ZodOptional<z.ZodArray<z.ZodString, "many">>;
@@ -21468,27 +21468,27 @@ export declare function describeContentFrontmatterSchema(model: PortableContentM
     audience: z.ZodOptional<z.ZodArray<z.ZodString, "many">>;
     relatedBookIds: z.ZodOptional<z.ZodArray<z.ZodString, "many">>;
 }, "strip", z.ZodTypeAny, {
-    status: "archived" | "review" | "draft" | "published";
+    status: "review" | "archived" | "draft" | "published";
     schemaVersion: "treeseed.book/v2";
     id: string;
     visibility: "team" | "project" | "public" | "authenticated" | "admin";
     order: number;
     summary: string;
-    title: string;
     slug: string;
+    title: string;
     audience?: string[] | undefined;
     description?: string | undefined;
     groupIds?: string[] | undefined;
     relatedBookIds?: string[] | undefined;
 }, {
-    status: "archived" | "review" | "draft" | "published";
+    status: "review" | "archived" | "draft" | "published";
     schemaVersion: "treeseed.book/v2";
     id: string;
     visibility: "team" | "project" | "public" | "authenticated" | "admin";
     order: number;
     summary: string;
-    title: string;
     slug: string;
+    title: string;
     audience?: string[] | undefined;
     description?: string | undefined;
     groupIds?: string[] | undefined;
@@ -21506,25 +21506,25 @@ export declare function describeContentFrontmatterSchema(model: PortableContentM
     order: z.ZodOptional<z.ZodNumber>;
     groupIds: z.ZodOptional<z.ZodArray<z.ZodString, "many">>;
 }, "strip", z.ZodTypeAny, {
-    status: "archived" | "review" | "draft" | "published";
+    status: "review" | "archived" | "draft" | "published";
     schemaVersion: "treeseed.knowledge-page/v1";
     id: string;
     visibility: "team" | "project" | "public" | "authenticated" | "admin";
     summary: string;
-    title: string;
     slug: string;
+    title: string;
     bookId: string;
     order?: number | undefined;
     description?: string | undefined;
     groupIds?: string[] | undefined;
 }, {
-    status: "archived" | "review" | "draft" | "published";
+    status: "review" | "archived" | "draft" | "published";
     schemaVersion: "treeseed.knowledge-page/v1";
     id: string;
     visibility: "team" | "project" | "public" | "authenticated" | "admin";
     summary: string;
-    title: string;
     slug: string;
+    title: string;
     bookId: string;
     order?: number | undefined;
     description?: string | undefined;

package/dist/content/validation/portable-content-data.d.ts

@@ -1544,14 +1544,14 @@ export declare function validatePortableContentData(model: string, value: unknow
         }>>;
     }, import("zod").ZodTypeAny, "passthrough"> | {
         status: string;
+        environment: string;
         visibility: "private" | "team" | "public" | "authenticated";
         summary: string;
         projectId: string;
-        title: string;
-        startedAt: Date;
         slug: string;
         metadata: Record<string, unknown>;
-        environment: string;
+        title: string;
+        startedAt: Date;
         changedFiles: string[];
         workDayId: string;
         reportVersion: string;
@@ -1569,8 +1569,8 @@ export declare function validatePortableContentData(model: string, value: unknow
             priority: number;
             status?: string | undefined;
             reason?: string | undefined;
-            title?: string | undefined;
             slug?: string | undefined;
+            title?: string | undefined;
             estimatedCredits?: number | undefined;
         }[];
         totalTasks: number;
@@ -1616,8 +1616,8 @@ export declare function validatePortableContentData(model: string, value: unknow
         audience: string[];
         description: string;
         summary: string;
-        title: string;
         slug: string;
+        title: string;
         groupIds: string[];
         featured: boolean;
         listingEnabled: boolean;
@@ -1636,9 +1636,9 @@ export declare function validatePortableContentData(model: string, value: unknow
             mode: "packaged" | "git" | "r2";
             source: {
                 kind: "git";
+                ref: string;
                 repoUrl: string;
                 directory: string;
-                ref: string;
                 integrity?: string | undefined;
             } | {
                 kind: "r2";
@@ -1755,8 +1755,8 @@ export declare function validatePortableContentData(model: string, value: unknow
         status: "active" | "archived";
         id: string;
         description: string;
-        title: string;
         slug: string;
+        title: string;
         groupIds: string[];
         parentTopicId?: string | undefined;
     } | {
@@ -1883,8 +1883,8 @@ export declare function validatePortableContentData(model: string, value: unknow
         description?: string | undefined;
         summary?: string | undefined;
         stage?: string | undefined;
-        updated_at?: Date | undefined;
         slug?: string | undefined;
+        updated_at?: Date | undefined;
         page_layout?: "article" | "bridge" | undefined;
     } | {
         title: string;
@@ -2000,26 +2000,26 @@ export declare function validatePortableContentData(model: string, value: unknow
         decision_type?: "approved" | "rejected" | "deferred" | "superseded" | "request_changes" | undefined;
         rationale?: string | undefined;
     } | {
-        status: "archived" | "review" | "draft" | "published";
+        status: "review" | "archived" | "draft" | "published";
         schemaVersion: "treeseed.book/v2";
         id: string;
         visibility: "team" | "project" | "public" | "authenticated" | "admin";
         order: number;
         summary: string;
-        title: string;
         slug: string;
+        title: string;
         audience?: string[] | undefined;
         description?: string | undefined;
         groupIds?: string[] | undefined;
         relatedBookIds?: string[] | undefined;
     } | {
-        status: "archived" | "review" | "draft" | "published";
+        status: "review" | "archived" | "draft" | "published";
         schemaVersion: "treeseed.knowledge-page/v1";
         id: string;
         visibility: "team" | "project" | "public" | "authenticated" | "admin";
         summary: string;
-        title: string;
         slug: string;
+        title: string;
         bookId: string;
         order?: number | undefined;
         description?: string | undefined;

package/dist/deployment/schemas.d.ts

@@ -425,12 +425,26 @@ export declare const hostConfigurationSchema: z.ZodObject<{
         role: string;
         architecture: "amd64";
     }>;
-    runtime: z.ZodObject<{
+    runtime: z.ZodEffects<z.ZodObject<{
         management: z.ZodEnum<["managed", "external"]>;
+        environment: z.ZodDefault<z.ZodEnum<["production", "development"]>>;
+        dataRoot: z.ZodOptional<z.ZodString>;
     }, "strict", z.ZodTypeAny, {
         management: "managed" | "external";
+        environment: "development" | "production";
+        dataRoot?: string | undefined;
+    }, {
+        management: "managed" | "external";
+        environment?: "development" | "production" | undefined;
+        dataRoot?: string | undefined;
+    }>, {
+        management: "managed" | "external";
+        environment: "development" | "production";
+        dataRoot?: string | undefined;
     }, {
         management: "managed" | "external";
+        environment?: "development" | "production" | undefined;
+        dataRoot?: string | undefined;
     }>;
     updates: z.ZodObject<{
         defaultTrack: z.ZodEnum<["stable", "development"]>;
@@ -1145,6 +1159,8 @@ export declare const hostConfigurationSchema: z.ZodObject<{
     };
     runtime: {
         management: "managed" | "external";
+        environment: "development" | "production";
+        dataRoot?: string | undefined;
     };
     updates: {
         stable: {
@@ -1253,6 +1269,8 @@ export declare const hostConfigurationSchema: z.ZodObject<{
     };
     runtime: {
         management: "managed" | "external";
+        environment?: "development" | "production" | undefined;
+        dataRoot?: string | undefined;
     };
     updates: {
         stable: {

package/dist/deployment/schemas.js

@@ -69,7 +69,14 @@ const hostConfigurationSchema = z.object({
     role: hostRoleSchema,
     architecture: z.literal("amd64")
   }).strict(),
-  runtime: z.object({ management: z.enum(["managed", "external"]) }).strict(),
+  runtime: z.object({
+    management: z.enum(["managed", "external"]),
+    environment: z.enum(["production", "development"]).default("production"),
+    dataRoot: z.string().startsWith("/").regex(/\/\.treeseed\/data$/u, "Development dataRoot must end with /.treeseed/data.").optional()
+  }).strict().superRefine((runtime, context) => {
+    if (runtime.environment === "development" && !runtime.dataRoot) context.addIssue({ code: z.ZodIssueCode.custom, path: ["dataRoot"], message: "Development hosts require an explicit workspace-visible dataRoot." });
+    if (runtime.environment === "production" && runtime.dataRoot) context.addIssue({ code: z.ZodIssueCode.custom, path: ["dataRoot"], message: "Production hosts use manager-owned /var/lib state and cannot override dataRoot." });
+  }),
   updates: z.object({
     defaultTrack: deploymentTrackSchema,
     stable: z.object({

package/dist/operator-contracts/canonical-command-tree.js

@@ -98,6 +98,23 @@ const operationBindings = {
   "projects treedx workspaces list": operation("treedx.workspaces.list", [field("path", "projectId", "argument", "project", true), ...page()]),
   "projects treedx workspaces show": operation("treedx.workspaces.show", [field("path", "projectId", "context", "project", true), field("path", "workspaceId", "argument", "workspace", true)]),
   "projects treedx workspaces abandon": operation("treedx.workspaces.abandon", [field("path", "projectId", "context", "project", true), field("path", "workspaceId", "argument", "workspace", true)]),
+  "library show": local("local.library.show"),
+  "library status": local("local.library.status"),
+  "library paths": local("local.library.paths"),
+  "library read": local("local.library.read"),
+  "library search": local("local.library.search"),
+  "library query": local("local.library.query"),
+  "library context": local("local.library.context"),
+  "library workspace create": operation("knowledge.workspaces.create", [field("path", "projectId", "argument", "project", true), field("body", "requestId", "option", "request")]),
+  "library workspace show": operation("knowledge.workspaces.show", [field("path", "workspaceId", "argument", "workspace", true)]),
+  "library workspace read": operation("knowledge.workspaces.content.show", [field("path", "workspaceId", "argument", "workspace", true), field("query", "path", "argument", "path", true)]),
+  "library workspace diff": operation("knowledge.workspaces.diff", [field("path", "workspaceId", "argument", "workspace", true)]),
+  "library workspace write": operation("knowledge.workspaces.content.update", [field("path", "workspaceId", "argument", "workspace", true), field("body", "file", "option", "input", true)]),
+  "library workspace submit": operation("knowledge.workspaces.submit", [field("path", "workspaceId", "argument", "workspace", true), field("body", "version", "option", "version", true, "integer"), field("body", "message", "option"), field("body", "notes", "option"), field("body", "contextDigest", "option", "contextDigest")]),
+  "library workspace abandon": operation("knowledge.workspaces.abandon", [field("path", "workspaceId", "argument", "workspace", true), field("body", "version", "option", "version", true, "integer")]),
+  "library reviews list": operation("knowledge.reviews.list", [field("path", "teamId", "context", "team", true), ...page()]),
+  "library reviews decide": operation("knowledge.reviews.decide", [field("path", "reviewId", "argument", "review", true), field("body", "file", "option", "input", true)]),
+  "library reviews publish": operation("knowledge.reviews.publish", [field("path", "reviewId", "argument", "review", true), field("body", "file", "option", "input")]),
   "status": operation("status.show"),
   "save": unavailable("Unified GitHub-backed save is intentionally fail-closed during this cutover."),
   "stage": unavailable("Unified GitHub-backed stage is intentionally fail-closed during this cutover."),
@@ -145,6 +162,22 @@ function userCreate() {
   ];
   return value;
 }
+function libraryRead(segment, extraArguments = [], extraOptions = []) {
+  return {
+    nodeType: "leaf",
+    segment,
+    description: `${segment[0].toUpperCase()}${segment.slice(1)} project library knowledge.`,
+    kind: "read",
+    arguments: ["project", ...extraArguments].map((name) => ({ name, description: `${name} value.`, required: true })),
+    options: [{ name: "--ref", description: "Exact commit or protected library ref.", type: "string" }, ...extraOptions],
+    resultSchemaId: `treeseed.command.library.${segment}/v1`,
+    execution: local(`local.library.${segment}`)
+  };
+}
+function addOptions(node, options) {
+  if (node.nodeType === "leaf") node.options = [...node.options ?? [], ...options];
+  return node;
+}
 const commandTree = {
   schemaVersion: "treeseed.command-tree/v1",
   executable: "trsd",
@@ -217,6 +250,25 @@ const commandTree = {
       leaf("capabilities", "read", "project"),
       branch("workspaces", [leaf("list", "read", "project"), leaf("show", "read", "workspace"), leaf("abandon", "mutation", "workspace", "destructive")])
     ])]),
+    branch("library", [
+      libraryRead("show"),
+      libraryRead("status"),
+      libraryRead("paths", [], [{ name: "--prefix", description: "Repository-relative path prefix.", type: "string" }, { name: "--limit", description: "Page size.", type: "number" }, { name: "--cursor", description: "Opaque page cursor.", type: "string" }]),
+      libraryRead("read", ["path"]),
+      libraryRead("search", ["query"], [{ name: "--path", description: "Restrict search to a repository-relative path.", type: "string" }, { name: "--limit", description: "Page size.", type: "number" }, { name: "--cursor", description: "Opaque page cursor.", type: "string" }]),
+      libraryRead("query", ["query"], [{ name: "--model", description: "TreeDX content model.", type: "string" }, { name: "--input", description: "YAML or JSON query body.", type: "string" }]),
+      libraryRead("context", ["query"], [{ name: "--max-items", description: "Maximum context items.", type: "number" }, { name: "--max-tokens", description: "Maximum context tokens.", type: "number" }]),
+      branch("workspace", [
+        addOptions(leaf("create", "mutation", "project"), [{ name: "--request", description: "Replay-safe UUID request identity.", type: "string" }]),
+        leaf("show", "read", "workspace"),
+        { nodeType: "leaf", segment: "read", description: "Read a file from a governed library workspace.", kind: "read", arguments: [{ name: "workspace", description: "Workspace identity.", required: true }, { name: "path", description: "Repository-relative path.", required: true }], resultSchemaId: "treeseed.command.library.workspace.read/v1", execution: unavailable() },
+        leaf("diff", "read", "workspace"),
+        addOptions(leaf("write", "mutation", "workspace"), [{ name: "--input", description: "YAML or JSON draft body.", type: "string", required: true }]),
+        addOptions(leaf("submit", "mutation", "workspace"), [{ name: "--version", description: "Expected workspace version.", type: "number", required: true }, { name: "--message", description: "Commit message.", type: "string" }, { name: "--notes", description: "Review notes.", type: "string" }, { name: "--context-digest", description: "Verified editorial context digest.", type: "string" }]),
+        addOptions(leaf("abandon", "mutation", "workspace", "destructive"), [{ name: "--version", description: "Expected workspace version.", type: "number", required: true }])
+      ]),
+      branch("reviews", [leaf("list"), addOptions(leaf("decide", "mutation", "review"), [{ name: "--input", description: "YAML or JSON review decision.", type: "string", required: true }]), addOptions(leaf("publish", "mutation", "review"), [{ name: "--input", description: "Optional YAML or JSON publication body.", type: "string" }])])
+    ]),
     leaf("save", "mutation"),
     leaf("stage", "mutation", void 0, "authority"),
     leaf("release", "mutation", void 0, "production"),

package/dist/operator-contracts/control-plane-operations.js

@@ -184,17 +184,17 @@ const CONTROL_PLANE_OPERATIONS = {
     search: resource("knowledge.search", "GET", "/v1/knowledge/search", {}, { capability: "knowledge.read", surfaces: ["rest", "mcp_tool"], pagination: "cursor" }),
     teamCatalog: resource("knowledge.catalog.team", "GET", "/v1/teams/{teamId}/knowledge/catalog", { teamId: z.string().min(1) }, { capability: "knowledge.read", pagination: "cursor" }),
     projectCatalog: resource("knowledge.catalog.project", "GET", "/v1/projects/{projectId}/knowledge/catalog", { projectId: z.string().min(1) }, { capability: "knowledge.read", pagination: "cursor" }),
-    createWorkspace: resource("knowledge.workspaces.create", "POST", "/v1/projects/{projectId}/knowledge/workspaces", { projectId: z.string().min(1) }, { capability: "knowledge.write", scopes: ["treeseed:knowledge:write"] }),
-    workspace: resource("knowledge.workspaces.show", "GET", "/v1/knowledge/workspaces/{workspaceId}", { workspaceId: z.string().min(1) }, { capability: "knowledge.read" }),
-    workspaceContent: resource("knowledge.workspaces.content.show", "GET", "/v1/knowledge/workspaces/{workspaceId}/content", { workspaceId: z.string().min(1) }, { capability: "knowledge.read" }),
-    updateWorkspaceContent: resource("knowledge.workspaces.content.update", "PUT", "/v1/knowledge/workspaces/{workspaceId}/content", { workspaceId: z.string().min(1) }, { capability: "knowledge.write", scopes: ["treeseed:knowledge:write"], concurrency: true }),
-    workspaceDiff: resource("knowledge.workspaces.diff", "GET", "/v1/knowledge/workspaces/{workspaceId}/diff", { workspaceId: z.string().min(1) }, { capability: "knowledge.read" }),
-    abandonWorkspace: resource("knowledge.workspaces.abandon", "POST", "/v1/knowledge/workspaces/{workspaceId}/abandon", { workspaceId: z.string().min(1) }, { capability: "knowledge.write", scopes: ["treeseed:knowledge:write"], risk: "destructive", concurrency: true }),
-    submitWorkspace: resource("knowledge.workspaces.submit", "POST", "/v1/knowledge/workspaces/{workspaceId}/submit", { workspaceId: z.string().min(1) }, { capability: "knowledge.write", scopes: ["treeseed:knowledge:write"], concurrency: true }),
-    reviews: resource("knowledge.reviews.list", "GET", "/v1/teams/{teamId}/knowledge/reviews", { teamId: z.string().min(1) }, { capability: "knowledge.review", pagination: "cursor" }),
+    createWorkspace: resource("knowledge.workspaces.create", "POST", "/v1/projects/{projectId}/knowledge/workspaces", { projectId: z.string().min(1) }, { capability: "knowledge.write", scopes: ["treeseed:knowledge:write"], surfaces: ["rest", "cli"] }),
+    workspace: resource("knowledge.workspaces.show", "GET", "/v1/knowledge/workspaces/{workspaceId}", { workspaceId: z.string().min(1) }, { capability: "knowledge.read", surfaces: ["rest", "cli"] }),
+    workspaceContent: resource("knowledge.workspaces.content.show", "GET", "/v1/knowledge/workspaces/{workspaceId}/content", { workspaceId: z.string().min(1) }, { capability: "knowledge.read", surfaces: ["rest", "cli"] }),
+    updateWorkspaceContent: resource("knowledge.workspaces.content.update", "PUT", "/v1/knowledge/workspaces/{workspaceId}/content", { workspaceId: z.string().min(1) }, { capability: "knowledge.write", scopes: ["treeseed:knowledge:write"], surfaces: ["rest", "cli"], concurrency: true }),
+    workspaceDiff: resource("knowledge.workspaces.diff", "GET", "/v1/knowledge/workspaces/{workspaceId}/diff", { workspaceId: z.string().min(1) }, { capability: "knowledge.read", surfaces: ["rest", "cli"] }),
+    abandonWorkspace: resource("knowledge.workspaces.abandon", "POST", "/v1/knowledge/workspaces/{workspaceId}/abandon", { workspaceId: z.string().min(1) }, { capability: "knowledge.write", scopes: ["treeseed:knowledge:write"], surfaces: ["rest", "cli"], risk: "destructive", concurrency: true }),
+    submitWorkspace: resource("knowledge.workspaces.submit", "POST", "/v1/knowledge/workspaces/{workspaceId}/submit", { workspaceId: z.string().min(1) }, { capability: "knowledge.write", scopes: ["treeseed:knowledge:write"], surfaces: ["rest", "cli"], concurrency: true }),
+    reviews: resource("knowledge.reviews.list", "GET", "/v1/teams/{teamId}/knowledge/reviews", { teamId: z.string().min(1) }, { capability: "knowledge.review", surfaces: ["rest", "cli"], pagination: "cursor" }),
     commentReview: resource("knowledge.reviews.comments.create", "POST", "/v1/knowledge/reviews/{reviewId}/comments", { reviewId: z.string().min(1) }, { capability: "knowledge.review", scopes: ["treeseed:knowledge:write"] }),
-    decideReview: resource("knowledge.reviews.decide", "POST", "/v1/knowledge/reviews/{reviewId}/decision", { reviewId: z.string().min(1) }, { capability: "knowledge.review", scopes: ["treeseed:knowledge:write"], concurrency: true }),
-    publishReview: resource("knowledge.reviews.publish", "POST", "/v1/knowledge/reviews/{reviewId}/publish", { reviewId: z.string().min(1) }, { capability: "knowledge.publish", scopes: ["treeseed:knowledge:write"], concurrency: true })
+    decideReview: resource("knowledge.reviews.decide", "POST", "/v1/knowledge/reviews/{reviewId}/decision", { reviewId: z.string().min(1) }, { capability: "knowledge.review", scopes: ["treeseed:knowledge:write"], surfaces: ["rest", "cli"], concurrency: true }),
+    publishReview: resource("knowledge.reviews.publish", "POST", "/v1/knowledge/reviews/{reviewId}/publish", { reviewId: z.string().min(1) }, { capability: "knowledge.publish", scopes: ["treeseed:knowledge:write"], surfaces: ["rest", "cli"], concurrency: true })
   },
   governance: {
     proposals: resource("governance.proposals.list", "GET", "/v1/projects/{projectId}/proposals", { projectId: z.string().min(1) }, { capability: "governance.read", surfaces: ["rest", "mcp_tool", "mcp_resource"], pagination: "cursor" }),

package/dist/operator-contracts/seed/seed-bundle.d.ts

@@ -1,5 +1,6 @@
 import type { ProviderLanePurpose } from '../../agent-capacity/contracts/capacity/communication/communication-records.js';
-export declare const SEED_BUNDLE_SCHEMA_VERSION: "treeseed.seed-bundle/v2";
+export declare const SEED_BUNDLE_SCHEMA_VERSION: "treeseed.seed-bundle/v3";
+export declare const HISTORICAL_SEED_BUNDLE_SCHEMA_VERSION: "treeseed.seed-bundle/v2";
 export type SeedEnvironment = 'local' | 'staging' | 'prod' | string;
 export interface SeedTeamResource {
     key: string;
@@ -43,7 +44,7 @@ export interface SeedRepositoryPolicy {
 export interface SeedRepositoryResource {
     key: string;
     project: string;
-    role: 'primary' | 'fixture' | 'support' | 'template';
+    role: 'primary' | 'library' | 'fixture' | 'support' | 'template';
     provider: 'github';
     owner: string;
     name: string;
@@ -62,6 +63,7 @@ export interface SeedProjectResource {
     description: string;
     kind: string;
     primaryRepository?: string;
+    libraryRepository: string;
     metadata?: Record<string, unknown>;
 }
 export interface SeedCapacityProviderPrerequisite {
@@ -75,8 +77,7 @@ export interface SeedCapacityProviderPrerequisite {
     allowedModes: Array<'planning' | 'acting'>;
     requiredLanePurposes: ProviderLanePurpose[];
 }
-export interface SeedBundleV2 {
-    schemaVersion: typeof SEED_BUNDLE_SCHEMA_VERSION;
+interface SeedBundleBody {
     name: string;
     version: number;
     description: string;
@@ -92,6 +93,19 @@ export interface SeedBundleV2 {
         capacityProviders: SeedCapacityProviderPrerequisite[];
     };
 }
+export interface SeedBundleV3 extends SeedBundleBody {
+    schemaVersion: typeof SEED_BUNDLE_SCHEMA_VERSION;
+}
+/** Historical receipt shape. It is decodable, but cannot be planned or applied. */
+export interface SeedBundleV2 extends Omit<SeedBundleBody, 'resources'> {
+    schemaVersion: typeof HISTORICAL_SEED_BUNDLE_SCHEMA_VERSION;
+    resources: Omit<SeedBundleBody['resources'], 'projects'> & {
+        projects: Array<Omit<SeedProjectResource, 'libraryRepository'> & {
+            libraryRepository?: string;
+        }>;
+    };
+}
+export type SeedBundle = SeedBundleV3 | SeedBundleV2;
 export interface SeedResourceReceipt {
     resourceKey: string;
     action: 'create' | 'adopt' | 'update' | 'noop' | 'blocked';
@@ -118,6 +132,7 @@ export interface SeedBundleDiagnostic {
     path: string;
     message: string;
 }
-export declare function canonicalSeedBundlePayload(bundle: Omit<SeedBundleV2, 'digest'> | SeedBundleV2): string;
-export declare function digestSeedBundle(bundle: Omit<SeedBundleV2, 'digest'> | SeedBundleV2): Promise<`sha256:${string}`>;
-export declare function validateSeedBundle(bundle: SeedBundleV2): SeedBundleDiagnostic[];
+export declare function canonicalSeedBundlePayload(bundle: Omit<SeedBundle, 'digest'> | SeedBundle): string;
+export declare function digestSeedBundle(bundle: Omit<SeedBundle, 'digest'> | SeedBundle): Promise<`sha256:${string}`>;
+export declare function validateSeedBundle(bundle: SeedBundle): SeedBundleDiagnostic[];
+export {};

package/dist/operator-contracts/seed/seed-bundle.js

@@ -1,4 +1,5 @@
-const SEED_BUNDLE_SCHEMA_VERSION = "treeseed.seed-bundle/v2";
+const SEED_BUNDLE_SCHEMA_VERSION = "treeseed.seed-bundle/v3";
+const HISTORICAL_SEED_BUNDLE_SCHEMA_VERSION = "treeseed.seed-bundle/v2";
 function text(value) {
   return typeof value === "string" && value.trim().length > 0;
 }
@@ -19,7 +20,11 @@ async function digestSeedBundle(bundle) {
 function validateSeedBundle(bundle) {
   const diagnostics = [];
   const add = (code, path, message) => diagnostics.push({ code, path, message });
-  if (bundle?.schemaVersion !== SEED_BUNDLE_SCHEMA_VERSION) add("seed_bundle_schema_invalid", "schemaVersion", `schemaVersion must be ${SEED_BUNDLE_SCHEMA_VERSION}.`);
+  if (bundle?.schemaVersion === HISTORICAL_SEED_BUNDLE_SCHEMA_VERSION) {
+    add("seed_bundle_v2_migration_required", "schemaVersion", `Historical v2 bundles remain readable but must be migrated to ${SEED_BUNDLE_SCHEMA_VERSION} before planning or apply.`);
+  } else if (bundle?.schemaVersion !== SEED_BUNDLE_SCHEMA_VERSION) {
+    add("seed_bundle_schema_invalid", "schemaVersion", `schemaVersion must be ${SEED_BUNDLE_SCHEMA_VERSION}.`);
+  }
   if (!text(bundle?.name) || !Number.isInteger(bundle?.version) || bundle.version < 1) add("seed_bundle_identity_invalid", "name", "Seed name and positive version are required.");
   if (!/^sha256:[a-f0-9]{64}$/u.test(bundle?.digest ?? "")) add("seed_bundle_digest_invalid", "digest", "Seed digest must be an exact SHA-256 digest.");
   const teams = new Set((bundle?.resources?.teams ?? []).map((entry) => entry.key));
@@ -35,9 +40,17 @@ function validateSeedBundle(bundle) {
     if (!teams.has(project.team)) add("seed_bundle_project_team_unknown", `resources.projects[${index}].team`, "Project references an unknown team.");
     if (!project.primaryRepository && project.kind !== "content") add("seed_bundle_primary_repository_required", `resources.projects[${index}].primaryRepository`, "Non-content projects require a primary source repository.");
     if (project.primaryRepository && !repositories.has(project.primaryRepository)) add("seed_bundle_primary_repository_unknown", `resources.projects[${index}].primaryRepository`, "Project primary repository is missing.");
+    if (!project.libraryRepository) add("seed_bundle_library_repository_required", `resources.projects[${index}].libraryRepository`, "Every project requires one library repository.");
+    if (project.libraryRepository && !repositories.has(project.libraryRepository)) add("seed_bundle_library_repository_unknown", `resources.projects[${index}].libraryRepository`, "Project library repository is missing.");
   }
   for (const [index, repository] of (bundle?.resources?.repositories ?? []).entries()) {
-    if (repository.role === "content") add("seed_bundle_content_repository_forbidden", `resources.repositories[${index}].role`, "Virtual knowledge repositories are derived by TreeDX and must not be declared as Git repositories.");
+    if (repository.role === "content") add("seed_bundle_content_repository_renamed", `resources.repositories[${index}].role`, "Repository-backed knowledge uses role library.");
+  }
+  for (const [index, project] of (bundle?.resources?.projects ?? []).entries()) {
+    const library = (bundle?.resources?.repositories ?? []).find((entry) => entry.key === project.libraryRepository);
+    if (library && (library.role !== "library" || library.project !== project.key)) add("seed_bundle_library_repository_mismatch", `resources.projects[${index}].libraryRepository`, "libraryRepository must reference a library-role repository owned by this project.");
+    const projectLibraries = (bundle?.resources?.repositories ?? []).filter((entry) => entry.project === project.key && entry.role === "library");
+    if (projectLibraries.length !== 1) add("seed_bundle_library_repository_count_invalid", `resources.projects[${index}].libraryRepository`, "Every project must declare exactly one library-role repository.");
   }
   for (const [index, provider] of (bundle?.runtime?.capacityProviders ?? []).entries()) {
     if (!teams.has(provider.team)) add("seed_bundle_provider_team_unknown", `runtime.capacityProviders[${index}].team`, "Provider references an unknown team.");
@@ -47,6 +60,7 @@ function validateSeedBundle(bundle) {
   return diagnostics;
 }
 export {
+  HISTORICAL_SEED_BUNDLE_SCHEMA_VERSION,
   SEED_BUNDLE_SCHEMA_VERSION,
   canonicalSeedBundlePayload,
   digestSeedBundle,

package/package.json

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