@treeseed/sdk 0.13.0-rc.118 → 0.13.0-rc.119

package/dist/agent-capacity/contracts/support/execution-graph.d.ts

@@ -0,0 +1,1087 @@
+import { z } from 'zod';
+export declare const conditionDefinitionSchema: z.ZodObject<{
+    conditionType: z.ZodEnum<["question", "external", "authority", "lifecycle"]>;
+    subjectRef: z.ZodEffects<z.ZodObject<{
+        store: z.ZodEnum<["treedx", "postgresql", "git", "url"]>;
+        model: z.ZodString;
+        id: z.ZodString;
+        revision: z.ZodOptional<z.ZodNumber>;
+        digest: z.ZodOptional<z.ZodString>;
+        repository: z.ZodOptional<z.ZodString>;
+        commit: z.ZodOptional<z.ZodString>;
+        path: z.ZodOptional<z.ZodString>;
+        anchor: z.ZodOptional<z.ZodString>;
+        startLine: z.ZodOptional<z.ZodNumber>;
+        endLine: z.ZodOptional<z.ZodNumber>;
+        url: z.ZodOptional<z.ZodString>;
+    }, "strict", z.ZodTypeAny, {
+        id: string;
+        model: string;
+        store: "git" | "url" | "postgresql" | "treedx";
+        path?: string | undefined;
+        repository?: string | undefined;
+        commit?: string | undefined;
+        digest?: string | undefined;
+        anchor?: string | undefined;
+        url?: string | undefined;
+        revision?: number | undefined;
+        startLine?: number | undefined;
+        endLine?: number | undefined;
+    }, {
+        id: string;
+        model: string;
+        store: "git" | "url" | "postgresql" | "treedx";
+        path?: string | undefined;
+        repository?: string | undefined;
+        commit?: string | undefined;
+        digest?: string | undefined;
+        anchor?: string | undefined;
+        url?: string | undefined;
+        revision?: number | undefined;
+        startLine?: number | undefined;
+        endLine?: number | undefined;
+    }>, {
+        id: string;
+        model: string;
+        store: "git" | "url" | "postgresql" | "treedx";
+        path?: string | undefined;
+        repository?: string | undefined;
+        commit?: string | undefined;
+        digest?: string | undefined;
+        anchor?: string | undefined;
+        url?: string | undefined;
+        revision?: number | undefined;
+        startLine?: number | undefined;
+        endLine?: number | undefined;
+    }, {
+        id: string;
+        model: string;
+        store: "git" | "url" | "postgresql" | "treedx";
+        path?: string | undefined;
+        repository?: string | undefined;
+        commit?: string | undefined;
+        digest?: string | undefined;
+        anchor?: string | undefined;
+        url?: string | undefined;
+        revision?: number | undefined;
+        startLine?: number | undefined;
+        endLine?: number | undefined;
+    }>;
+    expectedState: z.ZodString;
+}, "strict", z.ZodTypeAny, {
+    conditionType: "external" | "authority" | "question" | "lifecycle";
+    subjectRef: {
+        id: string;
+        model: string;
+        store: "git" | "url" | "postgresql" | "treedx";
+        path?: string | undefined;
+        repository?: string | undefined;
+        commit?: string | undefined;
+        digest?: string | undefined;
+        anchor?: string | undefined;
+        url?: string | undefined;
+        revision?: number | undefined;
+        startLine?: number | undefined;
+        endLine?: number | undefined;
+    };
+    expectedState: string;
+}, {
+    conditionType: "external" | "authority" | "question" | "lifecycle";
+    subjectRef: {
+        id: string;
+        model: string;
+        store: "git" | "url" | "postgresql" | "treedx";
+        path?: string | undefined;
+        repository?: string | undefined;
+        commit?: string | undefined;
+        digest?: string | undefined;
+        anchor?: string | undefined;
+        url?: string | undefined;
+        revision?: number | undefined;
+        startLine?: number | undefined;
+        endLine?: number | undefined;
+    };
+    expectedState: string;
+}>;
+export declare const executionNodeSchema: z.ZodEffects<z.ZodObject<{
+    schemaVersion: z.ZodLiteral<"treeseed.execution-node/v1">;
+    id: z.ZodString;
+    teamId: z.ZodString;
+    projectId: z.ZodString;
+    workdayId: z.ZodOptional<z.ZodString>;
+    workItemId: z.ZodOptional<z.ZodString>;
+    kind: z.ZodEnum<["planning", "estimating", "acting", "reviewing", "reporting", "communication", "condition"]>;
+    pairRole: z.ZodNullable<z.ZodEnum<["actor", "reviewer"]>>;
+    sourceRef: z.ZodEffects<z.ZodObject<{
+        store: z.ZodEnum<["treedx", "postgresql", "git", "url"]>;
+        model: z.ZodString;
+        id: z.ZodString;
+        revision: z.ZodOptional<z.ZodNumber>;
+        digest: z.ZodOptional<z.ZodString>;
+        repository: z.ZodOptional<z.ZodString>;
+        commit: z.ZodOptional<z.ZodString>;
+        path: z.ZodOptional<z.ZodString>;
+        anchor: z.ZodOptional<z.ZodString>;
+        startLine: z.ZodOptional<z.ZodNumber>;
+        endLine: z.ZodOptional<z.ZodNumber>;
+        url: z.ZodOptional<z.ZodString>;
+    }, "strict", z.ZodTypeAny, {
+        id: string;
+        model: string;
+        store: "git" | "url" | "postgresql" | "treedx";
+        path?: string | undefined;
+        repository?: string | undefined;
+        commit?: string | undefined;
+        digest?: string | undefined;
+        anchor?: string | undefined;
+        url?: string | undefined;
+        revision?: number | undefined;
+        startLine?: number | undefined;
+        endLine?: number | undefined;
+    }, {
+        id: string;
+        model: string;
+        store: "git" | "url" | "postgresql" | "treedx";
+        path?: string | undefined;
+        repository?: string | undefined;
+        commit?: string | undefined;
+        digest?: string | undefined;
+        anchor?: string | undefined;
+        url?: string | undefined;
+        revision?: number | undefined;
+        startLine?: number | undefined;
+        endLine?: number | undefined;
+    }>, {
+        id: string;
+        model: string;
+        store: "git" | "url" | "postgresql" | "treedx";
+        path?: string | undefined;
+        repository?: string | undefined;
+        commit?: string | undefined;
+        digest?: string | undefined;
+        anchor?: string | undefined;
+        url?: string | undefined;
+        revision?: number | undefined;
+        startLine?: number | undefined;
+        endLine?: number | undefined;
+    }, {
+        id: string;
+        model: string;
+        store: "git" | "url" | "postgresql" | "treedx";
+        path?: string | undefined;
+        repository?: string | undefined;
+        commit?: string | undefined;
+        digest?: string | undefined;
+        anchor?: string | undefined;
+        url?: string | undefined;
+        revision?: number | undefined;
+        startLine?: number | undefined;
+        endLine?: number | undefined;
+    }>;
+    authorityRefs: z.ZodOptional<z.ZodArray<z.ZodEffects<z.ZodObject<{
+        store: z.ZodEnum<["treedx", "postgresql", "git", "url"]>;
+        model: z.ZodString;
+        id: z.ZodString;
+        revision: z.ZodOptional<z.ZodNumber>;
+        digest: z.ZodOptional<z.ZodString>;
+        repository: z.ZodOptional<z.ZodString>;
+        commit: z.ZodOptional<z.ZodString>;
+        path: z.ZodOptional<z.ZodString>;
+        anchor: z.ZodOptional<z.ZodString>;
+        startLine: z.ZodOptional<z.ZodNumber>;
+        endLine: z.ZodOptional<z.ZodNumber>;
+        url: z.ZodOptional<z.ZodString>;
+    }, "strict", z.ZodTypeAny, {
+        id: string;
+        model: string;
+        store: "git" | "url" | "postgresql" | "treedx";
+        path?: string | undefined;
+        repository?: string | undefined;
+        commit?: string | undefined;
+        digest?: string | undefined;
+        anchor?: string | undefined;
+        url?: string | undefined;
+        revision?: number | undefined;
+        startLine?: number | undefined;
+        endLine?: number | undefined;
+    }, {
+        id: string;
+        model: string;
+        store: "git" | "url" | "postgresql" | "treedx";
+        path?: string | undefined;
+        repository?: string | undefined;
+        commit?: string | undefined;
+        digest?: string | undefined;
+        anchor?: string | undefined;
+        url?: string | undefined;
+        revision?: number | undefined;
+        startLine?: number | undefined;
+        endLine?: number | undefined;
+    }>, {
+        id: string;
+        model: string;
+        store: "git" | "url" | "postgresql" | "treedx";
+        path?: string | undefined;
+        repository?: string | undefined;
+        commit?: string | undefined;
+        digest?: string | undefined;
+        anchor?: string | undefined;
+        url?: string | undefined;
+        revision?: number | undefined;
+        startLine?: number | undefined;
+        endLine?: number | undefined;
+    }, {
+        id: string;
+        model: string;
+        store: "git" | "url" | "postgresql" | "treedx";
+        path?: string | undefined;
+        repository?: string | undefined;
+        commit?: string | undefined;
+        digest?: string | undefined;
+        anchor?: string | undefined;
+        url?: string | undefined;
+        revision?: number | undefined;
+        startLine?: number | undefined;
+        endLine?: number | undefined;
+    }>, "many">>;
+    ruleRevision: z.ZodNumber;
+    nodeRevision: z.ZodNumber;
+    agentClass: z.ZodOptional<z.ZodString>;
+    status: z.ZodEnum<["proposed", "blocked", "ready", "assigned", "running", "completed", "failed", "cancelled", "stale"]>;
+    estimate: z.ZodOptional<z.ZodEffects<z.ZodObject<{
+        minimumSeconds: z.ZodNumber;
+        expectedSeconds: z.ZodNumber;
+        maximumSeconds: z.ZodNumber;
+        rationale: z.ZodOptional<z.ZodString>;
+    }, "strict", z.ZodTypeAny, {
+        minimumSeconds: number;
+        expectedSeconds: number;
+        maximumSeconds: number;
+        rationale?: string | undefined;
+    }, {
+        minimumSeconds: number;
+        expectedSeconds: number;
+        maximumSeconds: number;
+        rationale?: string | undefined;
+    }>, {
+        minimumSeconds: number;
+        expectedSeconds: number;
+        maximumSeconds: number;
+        rationale?: string | undefined;
+    }, {
+        minimumSeconds: number;
+        expectedSeconds: number;
+        maximumSeconds: number;
+        rationale?: string | undefined;
+    }>>;
+    requiredCapabilities: z.ZodOptional<z.ZodEffects<z.ZodArray<z.ZodString, "many">, string[], string[]>>;
+    requestedPermissions: z.ZodOptional<z.ZodObject<{
+        content: z.ZodObject<{
+            read: z.ZodEffects<z.ZodArray<z.ZodEnum<["agent", "book", "knowledge", "objective", "discussion", "discussion-message", "proposal", "question", "note", "decision"]>, "many">, ("agent" | "knowledge" | "decision" | "proposal" | "objective" | "question" | "discussion" | "note" | "book" | "discussion-message")[], ("agent" | "knowledge" | "decision" | "proposal" | "objective" | "question" | "discussion" | "note" | "book" | "discussion-message")[]>;
+            write: z.ZodEffects<z.ZodArray<z.ZodEnum<["agent", "book", "knowledge", "objective", "discussion", "discussion-message", "proposal", "question", "note", "decision"]>, "many">, ("agent" | "knowledge" | "decision" | "proposal" | "objective" | "question" | "discussion" | "note" | "book" | "discussion-message")[], ("agent" | "knowledge" | "decision" | "proposal" | "objective" | "question" | "discussion" | "note" | "book" | "discussion-message")[]>;
+        }, "strict", z.ZodTypeAny, {
+            read: ("agent" | "knowledge" | "decision" | "proposal" | "objective" | "question" | "discussion" | "note" | "book" | "discussion-message")[];
+            write: ("agent" | "knowledge" | "decision" | "proposal" | "objective" | "question" | "discussion" | "note" | "book" | "discussion-message")[];
+        }, {
+            read: ("agent" | "knowledge" | "decision" | "proposal" | "objective" | "question" | "discussion" | "note" | "book" | "discussion-message")[];
+            write: ("agent" | "knowledge" | "decision" | "proposal" | "objective" | "question" | "discussion" | "note" | "book" | "discussion-message")[];
+        }>;
+        tools: z.ZodEffects<z.ZodArray<z.ZodEnum<["discussion", "source.read", "source.write", "verification", "release"]>, "many">, ("release" | "verification" | "discussion" | "source.read" | "source.write")[], ("release" | "verification" | "discussion" | "source.read" | "source.write")[]>;
+    }, "strict", z.ZodTypeAny, {
+        content: {
+            read: ("agent" | "knowledge" | "decision" | "proposal" | "objective" | "question" | "discussion" | "note" | "book" | "discussion-message")[];
+            write: ("agent" | "knowledge" | "decision" | "proposal" | "objective" | "question" | "discussion" | "note" | "book" | "discussion-message")[];
+        };
+        tools: ("release" | "verification" | "discussion" | "source.read" | "source.write")[];
+    }, {
+        content: {
+            read: ("agent" | "knowledge" | "decision" | "proposal" | "objective" | "question" | "discussion" | "note" | "book" | "discussion-message")[];
+            write: ("agent" | "knowledge" | "decision" | "proposal" | "objective" | "question" | "discussion" | "note" | "book" | "discussion-message")[];
+        };
+        tools: ("release" | "verification" | "discussion" | "source.read" | "source.write")[];
+    }>>;
+    workspace: z.ZodOptional<z.ZodEnum<["read-only", "treedx", "git"]>>;
+    acceptanceCriteria: z.ZodOptional<z.ZodArray<z.ZodString, "many">>;
+    maximumReviewCycles: z.ZodOptional<z.ZodNumber>;
+    condition: z.ZodOptional<z.ZodObject<{
+        conditionType: z.ZodEnum<["question", "external", "authority", "lifecycle"]>;
+        subjectRef: z.ZodEffects<z.ZodObject<{
+            store: z.ZodEnum<["treedx", "postgresql", "git", "url"]>;
+            model: z.ZodString;
+            id: z.ZodString;
+            revision: z.ZodOptional<z.ZodNumber>;
+            digest: z.ZodOptional<z.ZodString>;
+            repository: z.ZodOptional<z.ZodString>;
+            commit: z.ZodOptional<z.ZodString>;
+            path: z.ZodOptional<z.ZodString>;
+            anchor: z.ZodOptional<z.ZodString>;
+            startLine: z.ZodOptional<z.ZodNumber>;
+            endLine: z.ZodOptional<z.ZodNumber>;
+            url: z.ZodOptional<z.ZodString>;
+        }, "strict", z.ZodTypeAny, {
+            id: string;
+            model: string;
+            store: "git" | "url" | "postgresql" | "treedx";
+            path?: string | undefined;
+            repository?: string | undefined;
+            commit?: string | undefined;
+            digest?: string | undefined;
+            anchor?: string | undefined;
+            url?: string | undefined;
+            revision?: number | undefined;
+            startLine?: number | undefined;
+            endLine?: number | undefined;
+        }, {
+            id: string;
+            model: string;
+            store: "git" | "url" | "postgresql" | "treedx";
+            path?: string | undefined;
+            repository?: string | undefined;
+            commit?: string | undefined;
+            digest?: string | undefined;
+            anchor?: string | undefined;
+            url?: string | undefined;
+            revision?: number | undefined;
+            startLine?: number | undefined;
+            endLine?: number | undefined;
+        }>, {
+            id: string;
+            model: string;
+            store: "git" | "url" | "postgresql" | "treedx";
+            path?: string | undefined;
+            repository?: string | undefined;
+            commit?: string | undefined;
+            digest?: string | undefined;
+            anchor?: string | undefined;
+            url?: string | undefined;
+            revision?: number | undefined;
+            startLine?: number | undefined;
+            endLine?: number | undefined;
+        }, {
+            id: string;
+            model: string;
+            store: "git" | "url" | "postgresql" | "treedx";
+            path?: string | undefined;
+            repository?: string | undefined;
+            commit?: string | undefined;
+            digest?: string | undefined;
+            anchor?: string | undefined;
+            url?: string | undefined;
+            revision?: number | undefined;
+            startLine?: number | undefined;
+            endLine?: number | undefined;
+        }>;
+        expectedState: z.ZodString;
+    }, "strict", z.ZodTypeAny, {
+        conditionType: "external" | "authority" | "question" | "lifecycle";
+        subjectRef: {
+            id: string;
+            model: string;
+            store: "git" | "url" | "postgresql" | "treedx";
+            path?: string | undefined;
+            repository?: string | undefined;
+            commit?: string | undefined;
+            digest?: string | undefined;
+            anchor?: string | undefined;
+            url?: string | undefined;
+            revision?: number | undefined;
+            startLine?: number | undefined;
+            endLine?: number | undefined;
+        };
+        expectedState: string;
+    }, {
+        conditionType: "external" | "authority" | "question" | "lifecycle";
+        subjectRef: {
+            id: string;
+            model: string;
+            store: "git" | "url" | "postgresql" | "treedx";
+            path?: string | undefined;
+            repository?: string | undefined;
+            commit?: string | undefined;
+            digest?: string | undefined;
+            anchor?: string | undefined;
+            url?: string | undefined;
+            revision?: number | undefined;
+            startLine?: number | undefined;
+            endLine?: number | undefined;
+        };
+        expectedState: string;
+    }>>;
+    graphRevisionCreated: z.ZodNumber;
+    graphRevisionUpdated: z.ZodNumber;
+}, "strict", z.ZodTypeAny, {
+    status: "blocked" | "ready" | "stale" | "failed" | "running" | "completed" | "cancelled" | "proposed" | "assigned";
+    kind: "planning" | "acting" | "estimating" | "reviewing" | "reporting" | "communication" | "condition";
+    id: string;
+    schemaVersion: "treeseed.execution-node/v1";
+    projectId: string;
+    teamId: string;
+    nodeRevision: number;
+    sourceRef: {
+        id: string;
+        model: string;
+        store: "git" | "url" | "postgresql" | "treedx";
+        path?: string | undefined;
+        repository?: string | undefined;
+        commit?: string | undefined;
+        digest?: string | undefined;
+        anchor?: string | undefined;
+        url?: string | undefined;
+        revision?: number | undefined;
+        startLine?: number | undefined;
+        endLine?: number | undefined;
+    };
+    pairRole: "actor" | "reviewer" | null;
+    ruleRevision: number;
+    graphRevisionCreated: number;
+    graphRevisionUpdated: number;
+    requiredCapabilities?: string[] | undefined;
+    workspace?: "git" | "treedx" | "read-only" | undefined;
+    agentClass?: string | undefined;
+    estimate?: {
+        minimumSeconds: number;
+        expectedSeconds: number;
+        maximumSeconds: number;
+        rationale?: string | undefined;
+    } | undefined;
+    workdayId?: string | undefined;
+    workItemId?: string | undefined;
+    authorityRefs?: {
+        id: string;
+        model: string;
+        store: "git" | "url" | "postgresql" | "treedx";
+        path?: string | undefined;
+        repository?: string | undefined;
+        commit?: string | undefined;
+        digest?: string | undefined;
+        anchor?: string | undefined;
+        url?: string | undefined;
+        revision?: number | undefined;
+        startLine?: number | undefined;
+        endLine?: number | undefined;
+    }[] | undefined;
+    acceptanceCriteria?: string[] | undefined;
+    condition?: {
+        conditionType: "external" | "authority" | "question" | "lifecycle";
+        subjectRef: {
+            id: string;
+            model: string;
+            store: "git" | "url" | "postgresql" | "treedx";
+            path?: string | undefined;
+            repository?: string | undefined;
+            commit?: string | undefined;
+            digest?: string | undefined;
+            anchor?: string | undefined;
+            url?: string | undefined;
+            revision?: number | undefined;
+            startLine?: number | undefined;
+            endLine?: number | undefined;
+        };
+        expectedState: string;
+    } | undefined;
+    requestedPermissions?: {
+        content: {
+            read: ("agent" | "knowledge" | "decision" | "proposal" | "objective" | "question" | "discussion" | "note" | "book" | "discussion-message")[];
+            write: ("agent" | "knowledge" | "decision" | "proposal" | "objective" | "question" | "discussion" | "note" | "book" | "discussion-message")[];
+        };
+        tools: ("release" | "verification" | "discussion" | "source.read" | "source.write")[];
+    } | undefined;
+    maximumReviewCycles?: number | undefined;
+}, {
+    status: "blocked" | "ready" | "stale" | "failed" | "running" | "completed" | "cancelled" | "proposed" | "assigned";
+    kind: "planning" | "acting" | "estimating" | "reviewing" | "reporting" | "communication" | "condition";
+    id: string;
+    schemaVersion: "treeseed.execution-node/v1";
+    projectId: string;
+    teamId: string;
+    nodeRevision: number;
+    sourceRef: {
+        id: string;
+        model: string;
+        store: "git" | "url" | "postgresql" | "treedx";
+        path?: string | undefined;
+        repository?: string | undefined;
+        commit?: string | undefined;
+        digest?: string | undefined;
+        anchor?: string | undefined;
+        url?: string | undefined;
+        revision?: number | undefined;
+        startLine?: number | undefined;
+        endLine?: number | undefined;
+    };
+    pairRole: "actor" | "reviewer" | null;
+    ruleRevision: number;
+    graphRevisionCreated: number;
+    graphRevisionUpdated: number;
+    requiredCapabilities?: string[] | undefined;
+    workspace?: "git" | "treedx" | "read-only" | undefined;
+    agentClass?: string | undefined;
+    estimate?: {
+        minimumSeconds: number;
+        expectedSeconds: number;
+        maximumSeconds: number;
+        rationale?: string | undefined;
+    } | undefined;
+    workdayId?: string | undefined;
+    workItemId?: string | undefined;
+    authorityRefs?: {
+        id: string;
+        model: string;
+        store: "git" | "url" | "postgresql" | "treedx";
+        path?: string | undefined;
+        repository?: string | undefined;
+        commit?: string | undefined;
+        digest?: string | undefined;
+        anchor?: string | undefined;
+        url?: string | undefined;
+        revision?: number | undefined;
+        startLine?: number | undefined;
+        endLine?: number | undefined;
+    }[] | undefined;
+    acceptanceCriteria?: string[] | undefined;
+    condition?: {
+        conditionType: "external" | "authority" | "question" | "lifecycle";
+        subjectRef: {
+            id: string;
+            model: string;
+            store: "git" | "url" | "postgresql" | "treedx";
+            path?: string | undefined;
+            repository?: string | undefined;
+            commit?: string | undefined;
+            digest?: string | undefined;
+            anchor?: string | undefined;
+            url?: string | undefined;
+            revision?: number | undefined;
+            startLine?: number | undefined;
+            endLine?: number | undefined;
+        };
+        expectedState: string;
+    } | undefined;
+    requestedPermissions?: {
+        content: {
+            read: ("agent" | "knowledge" | "decision" | "proposal" | "objective" | "question" | "discussion" | "note" | "book" | "discussion-message")[];
+            write: ("agent" | "knowledge" | "decision" | "proposal" | "objective" | "question" | "discussion" | "note" | "book" | "discussion-message")[];
+        };
+        tools: ("release" | "verification" | "discussion" | "source.read" | "source.write")[];
+    } | undefined;
+    maximumReviewCycles?: number | undefined;
+}>, {
+    status: "blocked" | "ready" | "stale" | "failed" | "running" | "completed" | "cancelled" | "proposed" | "assigned";
+    kind: "planning" | "acting" | "estimating" | "reviewing" | "reporting" | "communication" | "condition";
+    id: string;
+    schemaVersion: "treeseed.execution-node/v1";
+    projectId: string;
+    teamId: string;
+    nodeRevision: number;
+    sourceRef: {
+        id: string;
+        model: string;
+        store: "git" | "url" | "postgresql" | "treedx";
+        path?: string | undefined;
+        repository?: string | undefined;
+        commit?: string | undefined;
+        digest?: string | undefined;
+        anchor?: string | undefined;
+        url?: string | undefined;
+        revision?: number | undefined;
+        startLine?: number | undefined;
+        endLine?: number | undefined;
+    };
+    pairRole: "actor" | "reviewer" | null;
+    ruleRevision: number;
+    graphRevisionCreated: number;
+    graphRevisionUpdated: number;
+    requiredCapabilities?: string[] | undefined;
+    workspace?: "git" | "treedx" | "read-only" | undefined;
+    agentClass?: string | undefined;
+    estimate?: {
+        minimumSeconds: number;
+        expectedSeconds: number;
+        maximumSeconds: number;
+        rationale?: string | undefined;
+    } | undefined;
+    workdayId?: string | undefined;
+    workItemId?: string | undefined;
+    authorityRefs?: {
+        id: string;
+        model: string;
+        store: "git" | "url" | "postgresql" | "treedx";
+        path?: string | undefined;
+        repository?: string | undefined;
+        commit?: string | undefined;
+        digest?: string | undefined;
+        anchor?: string | undefined;
+        url?: string | undefined;
+        revision?: number | undefined;
+        startLine?: number | undefined;
+        endLine?: number | undefined;
+    }[] | undefined;
+    acceptanceCriteria?: string[] | undefined;
+    condition?: {
+        conditionType: "external" | "authority" | "question" | "lifecycle";
+        subjectRef: {
+            id: string;
+            model: string;
+            store: "git" | "url" | "postgresql" | "treedx";
+            path?: string | undefined;
+            repository?: string | undefined;
+            commit?: string | undefined;
+            digest?: string | undefined;
+            anchor?: string | undefined;
+            url?: string | undefined;
+            revision?: number | undefined;
+            startLine?: number | undefined;
+            endLine?: number | undefined;
+        };
+        expectedState: string;
+    } | undefined;
+    requestedPermissions?: {
+        content: {
+            read: ("agent" | "knowledge" | "decision" | "proposal" | "objective" | "question" | "discussion" | "note" | "book" | "discussion-message")[];
+            write: ("agent" | "knowledge" | "decision" | "proposal" | "objective" | "question" | "discussion" | "note" | "book" | "discussion-message")[];
+        };
+        tools: ("release" | "verification" | "discussion" | "source.read" | "source.write")[];
+    } | undefined;
+    maximumReviewCycles?: number | undefined;
+}, {
+    status: "blocked" | "ready" | "stale" | "failed" | "running" | "completed" | "cancelled" | "proposed" | "assigned";
+    kind: "planning" | "acting" | "estimating" | "reviewing" | "reporting" | "communication" | "condition";
+    id: string;
+    schemaVersion: "treeseed.execution-node/v1";
+    projectId: string;
+    teamId: string;
+    nodeRevision: number;
+    sourceRef: {
+        id: string;
+        model: string;
+        store: "git" | "url" | "postgresql" | "treedx";
+        path?: string | undefined;
+        repository?: string | undefined;
+        commit?: string | undefined;
+        digest?: string | undefined;
+        anchor?: string | undefined;
+        url?: string | undefined;
+        revision?: number | undefined;
+        startLine?: number | undefined;
+        endLine?: number | undefined;
+    };
+    pairRole: "actor" | "reviewer" | null;
+    ruleRevision: number;
+    graphRevisionCreated: number;
+    graphRevisionUpdated: number;
+    requiredCapabilities?: string[] | undefined;
+    workspace?: "git" | "treedx" | "read-only" | undefined;
+    agentClass?: string | undefined;
+    estimate?: {
+        minimumSeconds: number;
+        expectedSeconds: number;
+        maximumSeconds: number;
+        rationale?: string | undefined;
+    } | undefined;
+    workdayId?: string | undefined;
+    workItemId?: string | undefined;
+    authorityRefs?: {
+        id: string;
+        model: string;
+        store: "git" | "url" | "postgresql" | "treedx";
+        path?: string | undefined;
+        repository?: string | undefined;
+        commit?: string | undefined;
+        digest?: string | undefined;
+        anchor?: string | undefined;
+        url?: string | undefined;
+        revision?: number | undefined;
+        startLine?: number | undefined;
+        endLine?: number | undefined;
+    }[] | undefined;
+    acceptanceCriteria?: string[] | undefined;
+    condition?: {
+        conditionType: "external" | "authority" | "question" | "lifecycle";
+        subjectRef: {
+            id: string;
+            model: string;
+            store: "git" | "url" | "postgresql" | "treedx";
+            path?: string | undefined;
+            repository?: string | undefined;
+            commit?: string | undefined;
+            digest?: string | undefined;
+            anchor?: string | undefined;
+            url?: string | undefined;
+            revision?: number | undefined;
+            startLine?: number | undefined;
+            endLine?: number | undefined;
+        };
+        expectedState: string;
+    } | undefined;
+    requestedPermissions?: {
+        content: {
+            read: ("agent" | "knowledge" | "decision" | "proposal" | "objective" | "question" | "discussion" | "note" | "book" | "discussion-message")[];
+            write: ("agent" | "knowledge" | "decision" | "proposal" | "objective" | "question" | "discussion" | "note" | "book" | "discussion-message")[];
+        };
+        tools: ("release" | "verification" | "discussion" | "source.read" | "source.write")[];
+    } | undefined;
+    maximumReviewCycles?: number | undefined;
+}>;
+export declare const executionEdgeSchema: z.ZodEffects<z.ZodObject<{
+    schemaVersion: z.ZodLiteral<"treeseed.execution-edge/v1">;
+    id: z.ZodString;
+    teamId: z.ZodString;
+    fromNodeId: z.ZodString;
+    toNodeId: z.ZodString;
+    provenance: z.ZodEnum<["profile-agent", "profile-event", "work-item", "review-pair", "governance"]>;
+    sourceRef: z.ZodOptional<z.ZodEffects<z.ZodObject<{
+        store: z.ZodEnum<["treedx", "postgresql", "git", "url"]>;
+        model: z.ZodString;
+        id: z.ZodString;
+        revision: z.ZodOptional<z.ZodNumber>;
+        digest: z.ZodOptional<z.ZodString>;
+        repository: z.ZodOptional<z.ZodString>;
+        commit: z.ZodOptional<z.ZodString>;
+        path: z.ZodOptional<z.ZodString>;
+        anchor: z.ZodOptional<z.ZodString>;
+        startLine: z.ZodOptional<z.ZodNumber>;
+        endLine: z.ZodOptional<z.ZodNumber>;
+        url: z.ZodOptional<z.ZodString>;
+    }, "strict", z.ZodTypeAny, {
+        id: string;
+        model: string;
+        store: "git" | "url" | "postgresql" | "treedx";
+        path?: string | undefined;
+        repository?: string | undefined;
+        commit?: string | undefined;
+        digest?: string | undefined;
+        anchor?: string | undefined;
+        url?: string | undefined;
+        revision?: number | undefined;
+        startLine?: number | undefined;
+        endLine?: number | undefined;
+    }, {
+        id: string;
+        model: string;
+        store: "git" | "url" | "postgresql" | "treedx";
+        path?: string | undefined;
+        repository?: string | undefined;
+        commit?: string | undefined;
+        digest?: string | undefined;
+        anchor?: string | undefined;
+        url?: string | undefined;
+        revision?: number | undefined;
+        startLine?: number | undefined;
+        endLine?: number | undefined;
+    }>, {
+        id: string;
+        model: string;
+        store: "git" | "url" | "postgresql" | "treedx";
+        path?: string | undefined;
+        repository?: string | undefined;
+        commit?: string | undefined;
+        digest?: string | undefined;
+        anchor?: string | undefined;
+        url?: string | undefined;
+        revision?: number | undefined;
+        startLine?: number | undefined;
+        endLine?: number | undefined;
+    }, {
+        id: string;
+        model: string;
+        store: "git" | "url" | "postgresql" | "treedx";
+        path?: string | undefined;
+        repository?: string | undefined;
+        commit?: string | undefined;
+        digest?: string | undefined;
+        anchor?: string | undefined;
+        url?: string | undefined;
+        revision?: number | undefined;
+        startLine?: number | undefined;
+        endLine?: number | undefined;
+    }>>;
+    graphRevisionCreated: z.ZodNumber;
+    graphRevisionRemoved: z.ZodOptional<z.ZodNumber>;
+}, "strict", z.ZodTypeAny, {
+    id: string;
+    schemaVersion: "treeseed.execution-edge/v1";
+    teamId: string;
+    provenance: "governance" | "profile-agent" | "profile-event" | "work-item" | "review-pair";
+    graphRevisionCreated: number;
+    fromNodeId: string;
+    toNodeId: string;
+    sourceRef?: {
+        id: string;
+        model: string;
+        store: "git" | "url" | "postgresql" | "treedx";
+        path?: string | undefined;
+        repository?: string | undefined;
+        commit?: string | undefined;
+        digest?: string | undefined;
+        anchor?: string | undefined;
+        url?: string | undefined;
+        revision?: number | undefined;
+        startLine?: number | undefined;
+        endLine?: number | undefined;
+    } | undefined;
+    graphRevisionRemoved?: number | undefined;
+}, {
+    id: string;
+    schemaVersion: "treeseed.execution-edge/v1";
+    teamId: string;
+    provenance: "governance" | "profile-agent" | "profile-event" | "work-item" | "review-pair";
+    graphRevisionCreated: number;
+    fromNodeId: string;
+    toNodeId: string;
+    sourceRef?: {
+        id: string;
+        model: string;
+        store: "git" | "url" | "postgresql" | "treedx";
+        path?: string | undefined;
+        repository?: string | undefined;
+        commit?: string | undefined;
+        digest?: string | undefined;
+        anchor?: string | undefined;
+        url?: string | undefined;
+        revision?: number | undefined;
+        startLine?: number | undefined;
+        endLine?: number | undefined;
+    } | undefined;
+    graphRevisionRemoved?: number | undefined;
+}>, {
+    id: string;
+    schemaVersion: "treeseed.execution-edge/v1";
+    teamId: string;
+    provenance: "governance" | "profile-agent" | "profile-event" | "work-item" | "review-pair";
+    graphRevisionCreated: number;
+    fromNodeId: string;
+    toNodeId: string;
+    sourceRef?: {
+        id: string;
+        model: string;
+        store: "git" | "url" | "postgresql" | "treedx";
+        path?: string | undefined;
+        repository?: string | undefined;
+        commit?: string | undefined;
+        digest?: string | undefined;
+        anchor?: string | undefined;
+        url?: string | undefined;
+        revision?: number | undefined;
+        startLine?: number | undefined;
+        endLine?: number | undefined;
+    } | undefined;
+    graphRevisionRemoved?: number | undefined;
+}, {
+    id: string;
+    schemaVersion: "treeseed.execution-edge/v1";
+    teamId: string;
+    provenance: "governance" | "profile-agent" | "profile-event" | "work-item" | "review-pair";
+    graphRevisionCreated: number;
+    fromNodeId: string;
+    toNodeId: string;
+    sourceRef?: {
+        id: string;
+        model: string;
+        store: "git" | "url" | "postgresql" | "treedx";
+        path?: string | undefined;
+        repository?: string | undefined;
+        commit?: string | undefined;
+        digest?: string | undefined;
+        anchor?: string | undefined;
+        url?: string | undefined;
+        revision?: number | undefined;
+        startLine?: number | undefined;
+        endLine?: number | undefined;
+    } | undefined;
+    graphRevisionRemoved?: number | undefined;
+}>;
+export declare const graphChangeSetSchema: z.ZodObject<{
+    added: z.ZodEffects<z.ZodArray<z.ZodString, "many">, string[], string[]>;
+    changed: z.ZodEffects<z.ZodArray<z.ZodString, "many">, string[], string[]>;
+    completed: z.ZodEffects<z.ZodArray<z.ZodString, "many">, string[], string[]>;
+    blocked: z.ZodEffects<z.ZodArray<z.ZodString, "many">, string[], string[]>;
+    stale: z.ZodEffects<z.ZodArray<z.ZodString, "many">, string[], string[]>;
+    removedEdges: z.ZodEffects<z.ZodArray<z.ZodString, "many">, string[], string[]>;
+    addedEdges: z.ZodEffects<z.ZodArray<z.ZodString, "many">, string[], string[]>;
+}, "strict", z.ZodTypeAny, {
+    blocked: string[];
+    stale: string[];
+    completed: string[];
+    added: string[];
+    changed: string[];
+    removedEdges: string[];
+    addedEdges: string[];
+}, {
+    blocked: string[];
+    stale: string[];
+    completed: string[];
+    added: string[];
+    changed: string[];
+    removedEdges: string[];
+    addedEdges: string[];
+}>;
+export declare const graphRevisionSchema: z.ZodObject<{
+    schemaVersion: z.ZodLiteral<"treeseed.graph-revision/v1">;
+    teamId: z.ZodString;
+    revision: z.ZodNumber;
+    ruleRevision: z.ZodNumber;
+    changedSourceRefs: z.ZodArray<z.ZodEffects<z.ZodObject<{
+        store: z.ZodEnum<["treedx", "postgresql", "git", "url"]>;
+        model: z.ZodString;
+        id: z.ZodString;
+        revision: z.ZodOptional<z.ZodNumber>;
+        digest: z.ZodOptional<z.ZodString>;
+        repository: z.ZodOptional<z.ZodString>;
+        commit: z.ZodOptional<z.ZodString>;
+        path: z.ZodOptional<z.ZodString>;
+        anchor: z.ZodOptional<z.ZodString>;
+        startLine: z.ZodOptional<z.ZodNumber>;
+        endLine: z.ZodOptional<z.ZodNumber>;
+        url: z.ZodOptional<z.ZodString>;
+    }, "strict", z.ZodTypeAny, {
+        id: string;
+        model: string;
+        store: "git" | "url" | "postgresql" | "treedx";
+        path?: string | undefined;
+        repository?: string | undefined;
+        commit?: string | undefined;
+        digest?: string | undefined;
+        anchor?: string | undefined;
+        url?: string | undefined;
+        revision?: number | undefined;
+        startLine?: number | undefined;
+        endLine?: number | undefined;
+    }, {
+        id: string;
+        model: string;
+        store: "git" | "url" | "postgresql" | "treedx";
+        path?: string | undefined;
+        repository?: string | undefined;
+        commit?: string | undefined;
+        digest?: string | undefined;
+        anchor?: string | undefined;
+        url?: string | undefined;
+        revision?: number | undefined;
+        startLine?: number | undefined;
+        endLine?: number | undefined;
+    }>, {
+        id: string;
+        model: string;
+        store: "git" | "url" | "postgresql" | "treedx";
+        path?: string | undefined;
+        repository?: string | undefined;
+        commit?: string | undefined;
+        digest?: string | undefined;
+        anchor?: string | undefined;
+        url?: string | undefined;
+        revision?: number | undefined;
+        startLine?: number | undefined;
+        endLine?: number | undefined;
+    }, {
+        id: string;
+        model: string;
+        store: "git" | "url" | "postgresql" | "treedx";
+        path?: string | undefined;
+        repository?: string | undefined;
+        commit?: string | undefined;
+        digest?: string | undefined;
+        anchor?: string | undefined;
+        url?: string | undefined;
+        revision?: number | undefined;
+        startLine?: number | undefined;
+        endLine?: number | undefined;
+    }>, "many">;
+    graphDigest: z.ZodString;
+    changes: z.ZodObject<{
+        added: z.ZodEffects<z.ZodArray<z.ZodString, "many">, string[], string[]>;
+        changed: z.ZodEffects<z.ZodArray<z.ZodString, "many">, string[], string[]>;
+        completed: z.ZodEffects<z.ZodArray<z.ZodString, "many">, string[], string[]>;
+        blocked: z.ZodEffects<z.ZodArray<z.ZodString, "many">, string[], string[]>;
+        stale: z.ZodEffects<z.ZodArray<z.ZodString, "many">, string[], string[]>;
+        removedEdges: z.ZodEffects<z.ZodArray<z.ZodString, "many">, string[], string[]>;
+        addedEdges: z.ZodEffects<z.ZodArray<z.ZodString, "many">, string[], string[]>;
+    }, "strict", z.ZodTypeAny, {
+        blocked: string[];
+        stale: string[];
+        completed: string[];
+        added: string[];
+        changed: string[];
+        removedEdges: string[];
+        addedEdges: string[];
+    }, {
+        blocked: string[];
+        stale: string[];
+        completed: string[];
+        added: string[];
+        changed: string[];
+        removedEdges: string[];
+        addedEdges: string[];
+    }>;
+    createdAt: z.ZodString;
+}, "strict", z.ZodTypeAny, {
+    schemaVersion: "treeseed.graph-revision/v1";
+    teamId: string;
+    createdAt: string;
+    revision: number;
+    changes: {
+        blocked: string[];
+        stale: string[];
+        completed: string[];
+        added: string[];
+        changed: string[];
+        removedEdges: string[];
+        addedEdges: string[];
+    };
+    ruleRevision: number;
+    changedSourceRefs: {
+        id: string;
+        model: string;
+        store: "git" | "url" | "postgresql" | "treedx";
+        path?: string | undefined;
+        repository?: string | undefined;
+        commit?: string | undefined;
+        digest?: string | undefined;
+        anchor?: string | undefined;
+        url?: string | undefined;
+        revision?: number | undefined;
+        startLine?: number | undefined;
+        endLine?: number | undefined;
+    }[];
+    graphDigest: string;
+}, {
+    schemaVersion: "treeseed.graph-revision/v1";
+    teamId: string;
+    createdAt: string;
+    revision: number;
+    changes: {
+        blocked: string[];
+        stale: string[];
+        completed: string[];
+        added: string[];
+        changed: string[];
+        removedEdges: string[];
+        addedEdges: string[];
+    };
+    ruleRevision: number;
+    changedSourceRefs: {
+        id: string;
+        model: string;
+        store: "git" | "url" | "postgresql" | "treedx";
+        path?: string | undefined;
+        repository?: string | undefined;
+        commit?: string | undefined;
+        digest?: string | undefined;
+        anchor?: string | undefined;
+        url?: string | undefined;
+        revision?: number | undefined;
+        startLine?: number | undefined;
+        endLine?: number | undefined;
+    }[];
+    graphDigest: string;
+}>;
+export type ExecutionNode = z.infer<typeof executionNodeSchema>;
+export type ExecutionEdge = z.infer<typeof executionEdgeSchema>;
+export type GraphRevision = z.infer<typeof graphRevisionSchema>;
+export declare function validateExecutionGraph(nodes: ExecutionNode[], edges: ExecutionEdge[]): {
+    ok: boolean;
+    diagnostics: {
+        code: string;
+        path: string;
+        message: string;
+    }[];
+};