@treeseed/sdk 0.13.0-rc.107 → 0.13.0-rc.109

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

@@ -641,8 +641,8 @@ export declare function validatePortableContentData(model: string, value: unknow
                 }>, "many">>;
                 requiresArtifactKinds: import("zod").ZodOptional<import("zod").ZodEffects<import("zod").ZodArray<import("zod").ZodString, "many">, string[], string[]>>;
             }, "strict", import("zod").ZodTypeAny, {
-                objective?: string | undefined;
                 stage?: "revision" | "closeout" | "discovery" | "synthesis" | "deliberation" | "evaluation" | undefined;
+                objective?: string | undefined;
                 proposalTypes?: string[] | undefined;
                 artifactKind?: string | undefined;
                 subjectModel?: string | undefined;
@@ -672,8 +672,8 @@ export declare function validatePortableContentData(model: string, value: unknow
                 }[] | undefined;
                 requiresArtifactKinds?: string[] | undefined;
             }, {
-                objective?: string | undefined;
                 stage?: "revision" | "closeout" | "discovery" | "synthesis" | "deliberation" | "evaluation" | undefined;
+                objective?: string | undefined;
                 proposalTypes?: string[] | undefined;
                 artifactKind?: string | undefined;
                 subjectModel?: string | undefined;
@@ -966,8 +966,8 @@ export declare function validatePortableContentData(model: string, value: unknow
                 publishes?: string[] | undefined;
             } | undefined;
             planningIntent?: {
-                objective?: string | undefined;
                 stage?: "revision" | "closeout" | "discovery" | "synthesis" | "deliberation" | "evaluation" | undefined;
+                objective?: string | undefined;
                 proposalTypes?: string[] | undefined;
                 artifactKind?: string | undefined;
                 subjectModel?: string | undefined;
@@ -1138,8 +1138,8 @@ export declare function validatePortableContentData(model: string, value: unknow
                 publishes?: string[] | undefined;
             } | undefined;
             planningIntent?: {
-                objective?: string | undefined;
                 stage?: "revision" | "closeout" | "discovery" | "synthesis" | "deliberation" | "evaluation" | undefined;
+                objective?: string | undefined;
                 proposalTypes?: string[] | undefined;
                 artifactKind?: string | undefined;
                 subjectModel?: string | undefined;
@@ -1310,8 +1310,8 @@ export declare function validatePortableContentData(model: string, value: unknow
                 publishes?: string[] | undefined;
             } | undefined;
             planningIntent?: {
-                objective?: string | undefined;
                 stage?: "revision" | "closeout" | "discovery" | "synthesis" | "deliberation" | "evaluation" | undefined;
+                objective?: string | undefined;
                 proposalTypes?: string[] | undefined;
                 artifactKind?: string | undefined;
                 subjectModel?: string | undefined;
@@ -1482,8 +1482,8 @@ export declare function validatePortableContentData(model: string, value: unknow
                 publishes?: string[] | undefined;
             } | undefined;
             planningIntent?: {
-                objective?: string | undefined;
                 stage?: "revision" | "closeout" | "discovery" | "synthesis" | "deliberation" | "evaluation" | undefined;
+                objective?: string | undefined;
                 proposalTypes?: string[] | undefined;
                 artifactKind?: string | undefined;
                 subjectModel?: string | undefined;
@@ -1886,8 +1886,8 @@ export declare function validatePortableContentData(model: string, value: unknow
         audience?: string[] | undefined;
         slug?: string | undefined;
         description?: string | undefined;
-        summary?: string | undefined;
         stage?: string | undefined;
+        summary?: string | undefined;
         updated_at?: Date | undefined;
         page_layout?: "article" | "bridge" | undefined;
     } | {
@@ -2006,8 +2006,8 @@ export declare function validatePortableContentData(model: string, value: unknow
     } | {
         status: "review" | "archived" | "draft" | "published";
         id: string;
-        slug: string;
         schemaVersion: "treeseed.book/v2";
+        slug: string;
         visibility: "project" | "team" | "public" | "admin" | "authenticated";
         order: number;
         summary: string;
@@ -2019,8 +2019,8 @@ export declare function validatePortableContentData(model: string, value: unknow
     } | {
         status: "review" | "archived" | "draft" | "published";
         id: string;
-        slug: string;
         schemaVersion: "treeseed.knowledge-page/v1";
+        slug: string;
         visibility: "project" | "team" | "public" | "admin" | "authenticated";
         summary: string;
         title: string;

package/dist/deployment/ai/storage.d.ts

@@ -24,8 +24,8 @@ export declare const aiStorageProofSchema: z.ZodEffects<z.ZodObject<{
 }, "strict", z.ZodTypeAny, {
     service: "inference" | "training" | "lab";
     nonce: string;
-    key: string;
     schemaVersion: "treeseed.ai-storage-proof/v1";
+    key: string;
     action: "read" | "write" | "list" | "delete";
     projectId: string;
     teamId: string;
@@ -35,8 +35,8 @@ export declare const aiStorageProofSchema: z.ZodEffects<z.ZodObject<{
 }, {
     service: "inference" | "training" | "lab";
     nonce: string;
-    key: string;
     schemaVersion: "treeseed.ai-storage-proof/v1";
+    key: string;
     action: "read" | "write" | "list" | "delete";
     projectId: string;
     teamId: string;
@@ -46,8 +46,8 @@ export declare const aiStorageProofSchema: z.ZodEffects<z.ZodObject<{
 }>, {
     service: "inference" | "training" | "lab";
     nonce: string;
-    key: string;
     schemaVersion: "treeseed.ai-storage-proof/v1";
+    key: string;
     action: "read" | "write" | "list" | "delete";
     projectId: string;
     teamId: string;
@@ -57,8 +57,8 @@ export declare const aiStorageProofSchema: z.ZodEffects<z.ZodObject<{
 }, {
     service: "inference" | "training" | "lab";
     nonce: string;
-    key: string;
     schemaVersion: "treeseed.ai-storage-proof/v1";
+    key: string;
     action: "read" | "write" | "list" | "delete";
     projectId: string;
     teamId: string;
@@ -82,8 +82,8 @@ export declare const aiStorageRequestSchema: z.ZodObject<{
     }, "strict", z.ZodTypeAny, {
         service: "inference" | "training" | "lab";
         nonce: string;
-        key: string;
         schemaVersion: "treeseed.ai-storage-proof/v1";
+        key: string;
         action: "read" | "write" | "list" | "delete";
         projectId: string;
         teamId: string;
@@ -93,8 +93,8 @@ export declare const aiStorageRequestSchema: z.ZodObject<{
     }, {
         service: "inference" | "training" | "lab";
         nonce: string;
-        key: string;
         schemaVersion: "treeseed.ai-storage-proof/v1";
+        key: string;
         action: "read" | "write" | "list" | "delete";
         projectId: string;
         teamId: string;
@@ -104,8 +104,8 @@ export declare const aiStorageRequestSchema: z.ZodObject<{
     }>, {
         service: "inference" | "training" | "lab";
         nonce: string;
-        key: string;
         schemaVersion: "treeseed.ai-storage-proof/v1";
+        key: string;
         action: "read" | "write" | "list" | "delete";
         projectId: string;
         teamId: string;
@@ -115,8 +115,8 @@ export declare const aiStorageRequestSchema: z.ZodObject<{
     }, {
         service: "inference" | "training" | "lab";
         nonce: string;
-        key: string;
         schemaVersion: "treeseed.ai-storage-proof/v1";
+        key: string;
         action: "read" | "write" | "list" | "delete";
         projectId: string;
         teamId: string;
@@ -129,8 +129,8 @@ export declare const aiStorageRequestSchema: z.ZodObject<{
     proof: {
         service: "inference" | "training" | "lab";
         nonce: string;
-        key: string;
         schemaVersion: "treeseed.ai-storage-proof/v1";
+        key: string;
         action: "read" | "write" | "list" | "delete";
         projectId: string;
         teamId: string;
@@ -143,8 +143,8 @@ export declare const aiStorageRequestSchema: z.ZodObject<{
     proof: {
         service: "inference" | "training" | "lab";
         nonce: string;
-        key: string;
         schemaVersion: "treeseed.ai-storage-proof/v1";
+        key: string;
         action: "read" | "write" | "list" | "delete";
         projectId: string;
         teamId: string;

package/dist/deployment/hosted-topology.d.ts

@@ -21,8 +21,8 @@ declare const hostedStateBackendCoreSchema: z.ZodObject<{
     encryptionKeyRef: z.ZodString;
 }, "strict", z.ZodTypeAny, {
     type: "s3";
-    key: string;
     schemaVersion: "treeseed.hosted-state-backend/v1";
+    key: string;
     teamId: string;
     environment: "production" | "staging";
     deploymentId: string;
@@ -35,8 +35,8 @@ declare const hostedStateBackendCoreSchema: z.ZodObject<{
     usePathStyle?: boolean | undefined;
 }, {
     type: "s3";
-    key: string;
     schemaVersion: "treeseed.hosted-state-backend/v1";
+    key: string;
     teamId: string;
     environment: "production" | "staging";
     deploymentId: string;
@@ -66,8 +66,8 @@ export declare const hostedStateBackendSchema: z.ZodEffects<z.ZodObject<{
     bindingDigest: z.ZodString;
 }, "strict", z.ZodTypeAny, {
     type: "s3";
-    key: string;
     schemaVersion: "treeseed.hosted-state-backend/v1";
+    key: string;
     teamId: string;
     environment: "production" | "staging";
     deploymentId: string;
@@ -81,8 +81,8 @@ export declare const hostedStateBackendSchema: z.ZodEffects<z.ZodObject<{
     usePathStyle?: boolean | undefined;
 }, {
     type: "s3";
-    key: string;
     schemaVersion: "treeseed.hosted-state-backend/v1";
+    key: string;
     teamId: string;
     environment: "production" | "staging";
     deploymentId: string;
@@ -96,8 +96,8 @@ export declare const hostedStateBackendSchema: z.ZodEffects<z.ZodObject<{
     usePathStyle?: boolean | undefined;
 }>, {
     type: "s3";
-    key: string;
     schemaVersion: "treeseed.hosted-state-backend/v1";
+    key: string;
     teamId: string;
     environment: "production" | "staging";
     deploymentId: string;
@@ -111,8 +111,8 @@ export declare const hostedStateBackendSchema: z.ZodEffects<z.ZodObject<{
     usePathStyle?: boolean | undefined;
 }, {
     type: "s3";
-    key: string;
     schemaVersion: "treeseed.hosted-state-backend/v1";
+    key: string;
     teamId: string;
     environment: "production" | "staging";
     deploymentId: string;
@@ -127,8 +127,8 @@ export declare const hostedStateBackendSchema: z.ZodEffects<z.ZodObject<{
 }>;
 export declare function bindHostedStateBackend(input: z.input<typeof hostedStateBackendCoreSchema>): {
     type: "s3";
-    key: string;
     schemaVersion: "treeseed.hosted-state-backend/v1";
+    key: string;
     teamId: string;
     environment: "production" | "staging";
     deploymentId: string;
@@ -781,8 +781,8 @@ export declare const hostedTopologyPlanSchema: z.ZodEffects<z.ZodObject<{
         bindingDigest: z.ZodString;
     }, "strict", z.ZodTypeAny, {
         type: "s3";
-        key: string;
         schemaVersion: "treeseed.hosted-state-backend/v1";
+        key: string;
         teamId: string;
         environment: "production" | "staging";
         deploymentId: string;
@@ -796,8 +796,8 @@ export declare const hostedTopologyPlanSchema: z.ZodEffects<z.ZodObject<{
         usePathStyle?: boolean | undefined;
     }, {
         type: "s3";
-        key: string;
         schemaVersion: "treeseed.hosted-state-backend/v1";
+        key: string;
         teamId: string;
         environment: "production" | "staging";
         deploymentId: string;
@@ -811,8 +811,8 @@ export declare const hostedTopologyPlanSchema: z.ZodEffects<z.ZodObject<{
         usePathStyle?: boolean | undefined;
     }>, {
         type: "s3";
-        key: string;
         schemaVersion: "treeseed.hosted-state-backend/v1";
+        key: string;
         teamId: string;
         environment: "production" | "staging";
         deploymentId: string;
@@ -826,8 +826,8 @@ export declare const hostedTopologyPlanSchema: z.ZodEffects<z.ZodObject<{
         usePathStyle?: boolean | undefined;
     }, {
         type: "s3";
-        key: string;
         schemaVersion: "treeseed.hosted-state-backend/v1";
+        key: string;
         teamId: string;
         environment: "production" | "staging";
         deploymentId: string;
@@ -1159,8 +1159,8 @@ export declare const hostedTopologyPlanSchema: z.ZodEffects<z.ZodObject<{
     stackId: string;
     stateBackend: {
         type: "s3";
-        key: string;
         schemaVersion: "treeseed.hosted-state-backend/v1";
+        key: string;
         teamId: string;
         environment: "production" | "staging";
         deploymentId: string;
@@ -1244,8 +1244,8 @@ export declare const hostedTopologyPlanSchema: z.ZodEffects<z.ZodObject<{
     stackId: string;
     stateBackend: {
         type: "s3";
-        key: string;
         schemaVersion: "treeseed.hosted-state-backend/v1";
+        key: string;
         teamId: string;
         environment: "production" | "staging";
         deploymentId: string;
@@ -1329,8 +1329,8 @@ export declare const hostedTopologyPlanSchema: z.ZodEffects<z.ZodObject<{
     stackId: string;
     stateBackend: {
         type: "s3";
-        key: string;
         schemaVersion: "treeseed.hosted-state-backend/v1";
+        key: string;
         teamId: string;
         environment: "production" | "staging";
         deploymentId: string;
@@ -1414,8 +1414,8 @@ export declare const hostedTopologyPlanSchema: z.ZodEffects<z.ZodObject<{
     stackId: string;
     stateBackend: {
         type: "s3";
-        key: string;
         schemaVersion: "treeseed.hosted-state-backend/v1";
+        key: string;
         teamId: string;
         environment: "production" | "staging";
         deploymentId: string;
@@ -1467,8 +1467,8 @@ export declare const authorizedHostedTopologyPlanSchema: z.ZodEffects<z.ZodObjec
         bindingDigest: z.ZodString;
     }, "strict", z.ZodTypeAny, {
         type: "s3";
-        key: string;
         schemaVersion: "treeseed.hosted-state-backend/v1";
+        key: string;
         teamId: string;
         environment: "production" | "staging";
         deploymentId: string;
@@ -1482,8 +1482,8 @@ export declare const authorizedHostedTopologyPlanSchema: z.ZodEffects<z.ZodObjec
         usePathStyle?: boolean | undefined;
     }, {
         type: "s3";
-        key: string;
         schemaVersion: "treeseed.hosted-state-backend/v1";
+        key: string;
         teamId: string;
         environment: "production" | "staging";
         deploymentId: string;
@@ -1497,8 +1497,8 @@ export declare const authorizedHostedTopologyPlanSchema: z.ZodEffects<z.ZodObjec
         usePathStyle?: boolean | undefined;
     }>, {
         type: "s3";
-        key: string;
         schemaVersion: "treeseed.hosted-state-backend/v1";
+        key: string;
         teamId: string;
         environment: "production" | "staging";
         deploymentId: string;
@@ -1512,8 +1512,8 @@ export declare const authorizedHostedTopologyPlanSchema: z.ZodEffects<z.ZodObjec
         usePathStyle?: boolean | undefined;
     }, {
         type: "s3";
-        key: string;
         schemaVersion: "treeseed.hosted-state-backend/v1";
+        key: string;
         teamId: string;
         environment: "production" | "staging";
         deploymentId: string;
@@ -1844,8 +1844,8 @@ export declare const authorizedHostedTopologyPlanSchema: z.ZodEffects<z.ZodObjec
     stackId: string;
     stateBackend: {
         type: "s3";
-        key: string;
         schemaVersion: "treeseed.hosted-state-backend/v1";
+        key: string;
         teamId: string;
         environment: "production" | "staging";
         deploymentId: string;
@@ -1929,8 +1929,8 @@ export declare const authorizedHostedTopologyPlanSchema: z.ZodEffects<z.ZodObjec
     stackId: string;
     stateBackend: {
         type: "s3";
-        key: string;
         schemaVersion: "treeseed.hosted-state-backend/v1";
+        key: string;
         teamId: string;
         environment: "production" | "staging";
         deploymentId: string;
@@ -2014,8 +2014,8 @@ export declare const authorizedHostedTopologyPlanSchema: z.ZodEffects<z.ZodObjec
     stackId: string;
     stateBackend: {
         type: "s3";
-        key: string;
         schemaVersion: "treeseed.hosted-state-backend/v1";
+        key: string;
         teamId: string;
         environment: "production" | "staging";
         deploymentId: string;
@@ -2099,8 +2099,8 @@ export declare const authorizedHostedTopologyPlanSchema: z.ZodEffects<z.ZodObjec
     stackId: string;
     stateBackend: {
         type: "s3";
-        key: string;
         schemaVersion: "treeseed.hosted-state-backend/v1";
+        key: string;
         teamId: string;
         environment: "production" | "staging";
         deploymentId: string;

package/dist/deployment/index.d.ts

@@ -1,6 +1,7 @@
 export * from './schemas.js';
 export * from './postgres/contracts.js';
 export * from './postgres/requirements.js';
+export * from './postgres/transfer.js';
 export * from './canonical.js';
 export * from './catalog.js';
 export * from './topology.js';

package/dist/deployment/index.js

@@ -1,6 +1,7 @@
 export * from "./schemas.js";
 export * from "./postgres/contracts.js";
 export * from "./postgres/requirements.js";
+export * from "./postgres/transfer.js";
 export * from "./canonical.js";
 export * from "./catalog.js";
 export * from "./topology.js";

package/dist/deployment/postgres/transfer.d.ts

@@ -0,0 +1,97 @@
+import { z } from 'zod';
+/** Exact future activation selection, not permission to execute caller SQL or
+ * restart a source database. Deployment reattests retained source custody and
+ * performs transfer only inside coordinated backup/reconciliation. */
+export declare const postgresTransitionSelectionSchema: z.ZodEffects<z.ZodObject<{
+    componentId: z.ZodString;
+    sourceRuntimeDigest: z.ZodString;
+    targetRuntimeDigest: z.ZodString;
+    topologyDigest: z.ZodString;
+    configurationDigest: z.ZodString;
+    allowLocaleConversion: z.ZodBoolean;
+}, "strict", z.ZodTypeAny, {
+    configurationDigest: string;
+    componentId: string;
+    sourceRuntimeDigest: string;
+    targetRuntimeDigest: string;
+    topologyDigest: string;
+    allowLocaleConversion: boolean;
+}, {
+    configurationDigest: string;
+    componentId: string;
+    sourceRuntimeDigest: string;
+    targetRuntimeDigest: string;
+    topologyDigest: string;
+    allowLocaleConversion: boolean;
+}>, {
+    configurationDigest: string;
+    componentId: string;
+    sourceRuntimeDigest: string;
+    targetRuntimeDigest: string;
+    topologyDigest: string;
+    allowLocaleConversion: boolean;
+}, {
+    configurationDigest: string;
+    componentId: string;
+    sourceRuntimeDigest: string;
+    targetRuntimeDigest: string;
+    topologyDigest: string;
+    allowLocaleConversion: boolean;
+}>;
+export type PostgresTransitionSelection = z.infer<typeof postgresTransitionSelectionSchema>;
+export declare const postgresTransferPreparationResultSchema: z.ZodObject<{
+    action: z.ZodEnum<["planned", "prepared", "noop"]>;
+    selectionDigest: z.ZodString;
+}, "strict", z.ZodTypeAny, {
+    action: "noop" | "planned" | "prepared";
+    selectionDigest: string;
+}, {
+    action: "noop" | "planned" | "prepared";
+    selectionDigest: string;
+}>;
+/** Redacted durable status: no database contents, connection settings, paths,
+ * credentials or process output. A held transfer requires coordinated restore. */
+export declare const postgresTransferRecordSchema: z.ZodObject<{
+    schemaVersion: z.ZodLiteral<"treeseed.postgres-transfer-journal/v1">;
+    intentDigest: z.ZodString;
+    restoreGeneration: z.ZodNumber;
+    restoreDigest: z.ZodString;
+    stage: z.ZodEnum<["fencing", "export", "restore", "verify", "switch", "activate", "accepted", "recovery-required", "rolled-back"]>;
+    archiveDigest: z.ZodOptional<z.ZodString>;
+}, "strict", z.ZodTypeAny, {
+    schemaVersion: "treeseed.postgres-transfer-journal/v1";
+    intentDigest: string;
+    restoreGeneration: number;
+    restoreDigest: string;
+    stage: "verify" | "rolled-back" | "restore" | "fencing" | "export" | "switch" | "activate" | "accepted" | "recovery-required";
+    archiveDigest?: string | undefined;
+}, {
+    schemaVersion: "treeseed.postgres-transfer-journal/v1";
+    intentDigest: string;
+    restoreGeneration: number;
+    restoreDigest: string;
+    stage: "verify" | "rolled-back" | "restore" | "fencing" | "export" | "switch" | "activate" | "accepted" | "recovery-required";
+    archiveDigest?: string | undefined;
+}>;
+export declare const postgresTransferStatusSchema: z.ZodNullable<z.ZodObject<{
+    schemaVersion: z.ZodLiteral<"treeseed.postgres-transfer-journal/v1">;
+    intentDigest: z.ZodString;
+    restoreGeneration: z.ZodNumber;
+    restoreDigest: z.ZodString;
+    stage: z.ZodEnum<["fencing", "export", "restore", "verify", "switch", "activate", "accepted", "recovery-required", "rolled-back"]>;
+    archiveDigest: z.ZodOptional<z.ZodString>;
+}, "strict", z.ZodTypeAny, {
+    schemaVersion: "treeseed.postgres-transfer-journal/v1";
+    intentDigest: string;
+    restoreGeneration: number;
+    restoreDigest: string;
+    stage: "verify" | "rolled-back" | "restore" | "fencing" | "export" | "switch" | "activate" | "accepted" | "recovery-required";
+    archiveDigest?: string | undefined;
+}, {
+    schemaVersion: "treeseed.postgres-transfer-journal/v1";
+    intentDigest: string;
+    restoreGeneration: number;
+    restoreDigest: string;
+    stage: "verify" | "rolled-back" | "restore" | "fencing" | "export" | "switch" | "activate" | "accepted" | "recovery-required";
+    archiveDigest?: string | undefined;
+}>>;

package/dist/deployment/postgres/transfer.js

@@ -0,0 +1,29 @@
+import { z } from "zod";
+const digest = z.string().regex(/^sha256:[a-f0-9]{64}$/u);
+const postgresTransitionSelectionSchema = z.object({
+  componentId: z.string().regex(/^[a-z][a-z0-9.-]{0,127}$/u),
+  sourceRuntimeDigest: digest,
+  targetRuntimeDigest: digest,
+  topologyDigest: digest,
+  configurationDigest: digest,
+  allowLocaleConversion: z.boolean()
+}).strict().refine((value) => value.sourceRuntimeDigest !== value.targetRuntimeDigest, "Distinct source and target runtimes required");
+const postgresTransferPreparationResultSchema = z.object({
+  action: z.enum(["planned", "prepared", "noop"]),
+  selectionDigest: digest
+}).strict();
+const postgresTransferRecordSchema = z.object({
+  schemaVersion: z.literal("treeseed.postgres-transfer-journal/v1"),
+  intentDigest: digest,
+  restoreGeneration: z.number().int().positive().safe(),
+  restoreDigest: digest,
+  stage: z.enum(["fencing", "export", "restore", "verify", "switch", "activate", "accepted", "recovery-required", "rolled-back"]),
+  archiveDigest: digest.optional()
+}).strict();
+const postgresTransferStatusSchema = postgresTransferRecordSchema.nullable();
+export {
+  postgresTransferPreparationResultSchema,
+  postgresTransferRecordSchema,
+  postgresTransferStatusSchema,
+  postgresTransitionSelectionSchema
+};