@guyghost/swarm-dao-core 0.3.0 → 0.5.0

package/dist/governance/proposal.machine.js

@@ -1,378 +1,3 @@
-import { assign, setup } from "xstate";
-// ============================================================
-// XState Machine Definition
-// ============================================================
-export const proposalMachine = setup({
-    types: {
-        context: {},
-        input: {},
-        events: {},
-    },
-}).createMachine({
-    id: "proposalLifecycle",
-    initial: "draft",
-    context: ({ input }) => ({
-        proposal: input.proposal,
-        stage: input.stage ?? "intake",
-        status: input.status ?? "open",
-        riskZone: input.riskZone,
-        deliberationCount: input.deliberationCount ?? 0,
-        retryCount: input.retryCount ?? 0,
-        errorMessage: input.errorMessage,
-        lastTransitionTime: input.lastTransitionTime ?? new Date().toISOString(),
-    }),
-    on: {
-        DISCARD: {
-            target: ".rejected",
-            actions: assign({
-                status: "rejected",
-                lastTransitionTime: () => new Date().toISOString(),
-            }),
-        },
-        ERROR: {
-            target: ".executionError",
-            actions: assign({
-                status: "failed",
-                errorMessage: ({ event }) => event.message,
-                lastTransitionTime: () => new Date().toISOString(),
-            }),
-        },
-    },
-    states: {
-        // ───────────────────────────────────────────────────────
-        // INTAKE PHASE
-        // ───────────────────────────────────────────────────────
-        draft: {
-            on: {
-                SUBMIT: {
-                    target: "intake",
-                    actions: assign({
-                        status: "open",
-                        stage: "intake",
-                        lastTransitionTime: () => new Date().toISOString(),
-                    }),
-                },
-            },
-        },
-        intake: {
-            on: {
-                QUALIFY: {
-                    target: "qualification",
-                    actions: assign({
-                        status: "open",
-                        stage: "qualification",
-                        lastTransitionTime: () => new Date().toISOString(),
-                    }),
-                },
-                REJECT: {
-                    target: "rejected",
-                    actions: assign({
-                        status: "rejected",
-                        stage: "council",
-                        lastTransitionTime: () => new Date().toISOString(),
-                    }),
-                },
-            },
-        },
-        // ───────────────────────────────────────────────────────
-        // QUALIFICATION PHASE
-        // ───────────────────────────────────────────────────────
-        qualification: {
-            on: {
-                ANALYZE: {
-                    target: "analysis",
-                    actions: assign({
-                        status: "open",
-                        stage: "analysis",
-                        lastTransitionTime: () => new Date().toISOString(),
-                    }),
-                },
-                REJECT: {
-                    target: "rejected",
-                    actions: assign({
-                        status: "rejected",
-                        stage: "council",
-                        lastTransitionTime: () => new Date().toISOString(),
-                    }),
-                },
-            },
-        },
-        // ───────────────────────────────────────────────────────
-        // ANALYSIS PHASE
-        // ───────────────────────────────────────────────────────
-        analysis: {
-            on: {
-                CRITIQUE: {
-                    target: "critique",
-                    actions: assign({
-                        status: "deliberating",
-                        stage: "critique",
-                        deliberationCount: ({ context }) => context.deliberationCount + 1,
-                        lastTransitionTime: () => new Date().toISOString(),
-                    }),
-                },
-                REJECT: {
-                    target: "rejected",
-                    actions: assign({
-                        status: "rejected",
-                        stage: "council",
-                        lastTransitionTime: () => new Date().toISOString(),
-                    }),
-                },
-            },
-        },
-        // ───────────────────────────────────────────────────────
-        // CRITIQUE PHASE
-        // ───────────────────────────────────────────────────────
-        critique: {
-            on: {
-                SCORE: {
-                    target: "scoring",
-                    actions: assign({
-                        status: "deliberating",
-                        stage: "scoring",
-                        deliberationCount: ({ context }) => context.deliberationCount + 1,
-                        lastTransitionTime: () => new Date().toISOString(),
-                    }),
-                },
-                REJECT: {
-                    target: "rejected",
-                    actions: assign({
-                        status: "rejected",
-                        stage: "council",
-                        lastTransitionTime: () => new Date().toISOString(),
-                    }),
-                },
-            },
-        },
-        // ───────────────────────────────────────────────────────
-        // SCORING PHASE
-        // ───────────────────────────────────────────────────────
-        scoring: {
-            on: {
-                SEND_TO_COUNCIL: {
-                    target: "council",
-                    actions: assign({
-                        status: "deliberating",
-                        stage: "council",
-                        deliberationCount: ({ context }) => context.deliberationCount + 1,
-                        lastTransitionTime: () => new Date().toISOString(),
-                    }),
-                },
-                REJECT: {
-                    target: "rejected",
-                    actions: assign({
-                        status: "rejected",
-                        stage: "council",
-                        lastTransitionTime: () => new Date().toISOString(),
-                    }),
-                },
-            },
-        },
-        // ───────────────────────────────────────────────────────
-        // COUNCIL PHASE
-        // ───────────────────────────────────────────────────────
-        council: {
-            on: {
-                VOTE: {
-                    target: "voting",
-                    actions: assign({
-                        status: "deliberating",
-                        stage: "vote",
-                        lastTransitionTime: () => new Date().toISOString(),
-                    }),
-                },
-                REJECT: {
-                    target: "rejected",
-                    actions: assign({
-                        status: "rejected",
-                        stage: "council",
-                        lastTransitionTime: () => new Date().toISOString(),
-                    }),
-                },
-            },
-        },
-        // ───────────────────────────────────────────────────────
-        // VOTING PHASE
-        // ───────────────────────────────────────────────────────
-        voting: {
-            on: {
-                APPROVE: {
-                    target: "specDraft",
-                    actions: assign({
-                        status: "approved",
-                        stage: "spec",
-                        retryCount: 0,
-                        lastTransitionTime: () => new Date().toISOString(),
-                    }),
-                },
-                REJECT: {
-                    target: "rejected",
-                    actions: assign({
-                        status: "rejected",
-                        stage: "council",
-                        lastTransitionTime: () => new Date().toISOString(),
-                    }),
-                },
-            },
-        },
-        // ───────────────────────────────────────────────────────
-        // SPECIFICATION PHASE
-        // ───────────────────────────────────────────────────────
-        specDraft: {
-            on: {
-                REQUEST_SPEC: {
-                    target: "specReview",
-                    actions: assign({
-                        status: "approved",
-                        stage: "spec",
-                        lastTransitionTime: () => new Date().toISOString(),
-                    }),
-                },
-                REVIEW_SPEC: {
-                    target: "specReview",
-                    actions: assign({
-                        status: "approved",
-                        stage: "spec",
-                        lastTransitionTime: () => new Date().toISOString(),
-                    }),
-                },
-                REJECT: {
-                    target: "rejected",
-                    actions: assign({
-                        status: "rejected",
-                        stage: "council",
-                        lastTransitionTime: () => new Date().toISOString(),
-                    }),
-                },
-            },
-        },
-        specReview: {
-            on: {
-                APPROVE_SPEC: {
-                    target: "executionGate",
-                    actions: assign({
-                        status: "approved",
-                        stage: "spec",
-                        lastTransitionTime: () => new Date().toISOString(),
-                    }),
-                },
-                REQUEST_SPEC: {
-                    target: "specDraft",
-                    actions: assign({
-                        status: "approved",
-                        stage: "spec",
-                        lastTransitionTime: () => new Date().toISOString(),
-                    }),
-                },
-                REJECT: {
-                    target: "rejected",
-                    actions: assign({
-                        status: "rejected",
-                        stage: "council",
-                        lastTransitionTime: () => new Date().toISOString(),
-                    }),
-                },
-            },
-        },
-        // ───────────────────────────────────────────────────────
-        // EXECUTION GATE PHASE
-        // ───────────────────────────────────────────────────────
-        executionGate: {
-            on: {
-                EXECUTION_GATE_PASS: {
-                    target: "executing",
-                    actions: assign({
-                        status: "controlled",
-                        stage: "execution-gate",
-                        lastTransitionTime: () => new Date().toISOString(),
-                    }),
-                },
-                EXECUTE: {
-                    target: "executing",
-                    actions: assign({
-                        status: "controlled",
-                        stage: "execution-gate",
-                        lastTransitionTime: () => new Date().toISOString(),
-                    }),
-                },
-                EXECUTION_GATE_FAIL: {
-                    target: "rejected",
-                    actions: assign({
-                        status: "rejected",
-                        stage: "execution-gate",
-                        lastTransitionTime: () => new Date().toISOString(),
-                    }),
-                },
-            },
-        },
-        // ───────────────────────────────────────────────────────
-        // EXECUTION PHASE
-        // ───────────────────────────────────────────────────────
-        executing: {
-            on: {
-                EXECUTION_SUCCESS: {
-                    target: "postmortem",
-                    actions: assign({
-                        status: "executed",
-                        stage: "postmortem",
-                        retryCount: 0,
-                        lastTransitionTime: () => new Date().toISOString(),
-                    }),
-                },
-                EXECUTION_FAILED: {
-                    target: "executionError",
-                    actions: assign({
-                        errorMessage: "Execution failed",
-                        lastTransitionTime: () => new Date().toISOString(),
-                    }),
-                },
-            },
-        },
-        executionError: {
-            on: {
-                RETRY: [
-                    {
-                        target: "executing",
-                        guard: ({ context }) => context.retryCount < 3,
-                        actions: assign({
-                            retryCount: ({ context }) => context.retryCount + 1,
-                            lastTransitionTime: () => new Date().toISOString(),
-                        }),
-                    },
-                ],
-                EXECUTION_FAILED: {
-                    target: "postmortem",
-                    actions: assign({
-                        status: "failed",
-                        stage: "postmortem",
-                        lastTransitionTime: () => new Date().toISOString(),
-                    }),
-                },
-            },
-        },
-        // ───────────────────────────────────────────────────────
-        // POSTMORTEM PHASE
-        // ───────────────────────────────────────────────────────
-        postmortem: {
-            on: {
-                POSTMORTEM: {
-                    target: "completed",
-                    actions: assign({
-                        lastTransitionTime: () => new Date().toISOString(),
-                    }),
-                },
-            },
-        },
-        // ───────────────────────────────────────────────────────
-        // TERMINAL STATES
-        // ───────────────────────────────────────────────────────
-        rejected: {
-            type: "final",
-        },
-        completed: {
-            type: "final",
-        },
-    },
-});
+/** @deprecated Behavioral models now live in `/models`, the source of truth. */
+export * from "../models/proposal.machine.js";
 //# sourceMappingURL=proposal.machine.js.map

package/dist/governance/proposal.machine.js.map

@@ -1 +1 @@
-{"version":3,"file":"proposal.machine.js","sourceRoot":"","sources":["../../src/governance/proposal.machine.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"proposal.machine.js","sourceRoot":"","sources":["../../src/governance/proposal.machine.ts"],"names":[],"mappings":"AAAA,gFAAgF;AAChF,cAAc,+BAA+B,CAAC"}

package/dist/governance/proposal.utils.d.ts

@@ -1,166 +1,23 @@
-import type { PipelineStage, Proposal } from "../types/index.js";
-import { type ProposalContext, type ProposalEvent, type ProposalMachineInput } from "./proposal.machine.js";
-/**
- * Creates an XState actor for a proposal
- */
-export declare function createProposalActor(proposal: Proposal, initialStage?: PipelineStage): import("xstate").Actor<import("xstate").StateMachine<ProposalContext, {
-    type: "SUBMIT";
-} | {
-    type: "QUALIFY";
-} | {
-    type: "ANALYZE";
-} | {
-    type: "CRITIQUE";
-} | {
-    type: "SCORE";
-} | {
-    type: "SEND_TO_COUNCIL";
-} | {
-    type: "VOTE";
-} | {
-    type: "APPROVE";
-} | {
-    type: "REJECT";
-} | {
-    type: "REQUEST_SPEC";
-} | {
-    type: "REVIEW_SPEC";
-} | {
-    type: "APPROVE_SPEC";
-} | {
-    type: "EXECUTION_GATE_PASS";
-} | {
-    type: "EXECUTION_GATE_FAIL";
-} | {
-    type: "EXECUTE";
-} | {
-    type: "EXECUTION_SUCCESS";
-} | {
-    type: "EXECUTION_FAILED";
-} | {
-    type: "POSTMORTEM";
-} | {
-    type: "RETRY";
-} | {
-    type: "DISCARD";
-} | {
-    type: "ERROR";
-    message: string;
-}, {}, never, never, never, never, "intake" | "qualification" | "analysis" | "critique" | "scoring" | "council" | "postmortem" | "rejected" | "draft" | "voting" | "specDraft" | "specReview" | "executionGate" | "executing" | "executionError" | "completed", string, ProposalMachineInput, import("xstate").NonReducibleUnknown, import("xstate").EventObject, import("xstate").MetaObject, {
-    id: "proposalLifecycle";
-    states: {
-        readonly draft: {};
-        readonly intake: {};
-        readonly qualification: {};
-        readonly analysis: {};
-        readonly critique: {};
-        readonly scoring: {};
-        readonly council: {};
-        readonly voting: {};
-        readonly specDraft: {};
-        readonly specReview: {};
-        readonly executionGate: {};
-        readonly executing: {};
-        readonly executionError: {};
-        readonly postmortem: {};
-        readonly rejected: {};
-        readonly completed: {};
-    };
-}>>;
-/**
- * Moves a proposal through its states sequentially
- */
-export declare function sendProposalEvent(actor: ReturnType<typeof createProposalActor>, event: ProposalEvent): import("xstate").MachineSnapshot<ProposalContext, {
-    type: "SUBMIT";
-} | {
-    type: "QUALIFY";
-} | {
-    type: "ANALYZE";
-} | {
-    type: "CRITIQUE";
-} | {
-    type: "SCORE";
-} | {
-    type: "SEND_TO_COUNCIL";
-} | {
-    type: "VOTE";
-} | {
-    type: "APPROVE";
-} | {
-    type: "REJECT";
-} | {
-    type: "REQUEST_SPEC";
-} | {
-    type: "REVIEW_SPEC";
-} | {
-    type: "APPROVE_SPEC";
-} | {
-    type: "EXECUTION_GATE_PASS";
-} | {
-    type: "EXECUTION_GATE_FAIL";
-} | {
-    type: "EXECUTE";
-} | {
-    type: "EXECUTION_SUCCESS";
-} | {
-    type: "EXECUTION_FAILED";
-} | {
-    type: "POSTMORTEM";
-} | {
-    type: "RETRY";
-} | {
-    type: "DISCARD";
-} | {
-    type: "ERROR";
-    message: string;
-}, {}, "intake" | "qualification" | "analysis" | "critique" | "scoring" | "council" | "postmortem" | "rejected" | "draft" | "voting" | "specDraft" | "specReview" | "executionGate" | "executing" | "executionError" | "completed", string, import("xstate").NonReducibleUnknown, import("xstate").MetaObject, {
-    id: "proposalLifecycle";
-    states: {
-        readonly draft: {};
-        readonly intake: {};
-        readonly qualification: {};
-        readonly analysis: {};
-        readonly critique: {};
-        readonly scoring: {};
-        readonly council: {};
-        readonly voting: {};
-        readonly specDraft: {};
-        readonly specReview: {};
-        readonly executionGate: {};
-        readonly executing: {};
-        readonly executionError: {};
-        readonly postmortem: {};
-        readonly rejected: {};
-        readonly completed: {};
-    };
-}>;
-/**
- * Returns the machine's current context
- */
-export declare function getProposalContext(actor: ReturnType<typeof createProposalActor>): ProposalContext;
-/**
- * Returns the machine's current state
- */
-export declare function getProposalState(actor: ReturnType<typeof createProposalActor>): "intake" | "qualification" | "analysis" | "critique" | "scoring" | "council" | "postmortem" | "rejected" | "draft" | "voting" | "specDraft" | "specReview" | "executionGate" | "executing" | "executionError" | "completed";
-/**
- * Checks whether the proposal can take a given transition
- */
-export declare function canSendProposalEvent(actor: ReturnType<typeof createProposalActor>, eventType: string): boolean;
-/**
- * Returns all possible transitions from the current state
- */
-export declare function getAvailableProposalEvents(actor: ReturnType<typeof createProposalActor>): string[];
-/**
- * Helper for auto-progressing a proposal through the pipeline
- * Uses linear progression events
- */
-export declare function progressProposal(actor: ReturnType<typeof createProposalActor>): string | null;
-/**
- * Creates a helper to trigger rejection events easily
- */
-export declare function rejectProposal(actor: ReturnType<typeof createProposalActor>): "intake" | "qualification" | "analysis" | "critique" | "scoring" | "council" | "postmortem" | "rejected" | "draft" | "voting" | "specDraft" | "specReview" | "executionGate" | "executing" | "executionError" | "completed";
-/**
- * Listener for observing state changes
- */
-export declare function onProposalStateChange(actor: ReturnType<typeof createProposalActor>, callback: (state: string, context: ProposalContext) => void): () => void;
+import { type ProposalEvent } from "../models/proposal.machine.js";
+import type { ClockPort } from "../ports/clock.js";
+import type { Proposal, ProposalStatus } from "../types/index.js";
+export type DispatchResult = {
+    ok: true;
+    status: ProposalStatus;
+} | {
+    ok: false;
+    error: string;
+};
+/**
+ * Apply a lifecycle event to a proposal. Enforces the machine's
+ * topology AND its guards. On success, `proposal.status` (and
+ * `proposal.resolvedAt` for terminal states) is updated in place.
+ *
+ * Returns `{ ok: false, error }` when the event is not permitted
+ * from the current status — the caller must surface that error and
+ * MUST NOT mutate the status itself.
+ */
+export declare function dispatchProposalEvent(proposal: Proposal, event: ProposalEvent, options?: {
+    clock?: ClockPort;
+}): DispatchResult;
 //# sourceMappingURL=proposal.utils.d.ts.map

package/dist/governance/proposal.utils.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"proposal.utils.d.ts","sourceRoot":"","sources":["../../src/governance/proposal.utils.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,aAAa,EAAE,QAAQ,EAAE,MAAM,mBAAmB,CAAC;AACjE,OAAO,EACL,KAAK,eAAe,EACpB,KAAK,aAAa,EAClB,KAAK,oBAAoB,EAE1B,MAAM,uBAAuB,CAAC;AAE/B;;GAEG;AACH,wBAAgB,mBAAmB,CAAC,QAAQ,EAAE,QAAQ,EAAE,YAAY,CAAC,EAAE,aAAa;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;IAenF;AAED;;GAEG;AACH,wBAAgB,iBAAiB,CAAC,KAAK,EAAE,UAAU,CAAC,OAAO,mBAAmB,CAAC,EAAE,KAAK,EAAE,aAAa;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAGpG;AAED;;GAEG;AACH,wBAAgB,kBAAkB,CAAC,KAAK,EAAE,UAAU,CAAC,OAAO,mBAAmB,CAAC,mBAE/E;AAED;;GAEG;AACH,wBAAgB,gBAAgB,CAAC,KAAK,EAAE,UAAU,CAAC,OAAO,mBAAmB,CAAC,+NAE7E;AAED;;GAEG;AACH,wBAAgB,oBAAoB,CAAC,KAAK,EAAE,UAAU,CAAC,OAAO,mBAAmB,CAAC,EAAE,SAAS,EAAE,MAAM,GAAG,OAAO,CAW9G;AAED;;GAEG;AACH,wBAAgB,0BAA0B,CAAC,KAAK,EAAE,UAAU,CAAC,OAAO,mBAAmB,CAAC,GAAG,MAAM,EAAE,CAyBlG;AAED;;;GAGG;AACH,wBAAgB,gBAAgB,CAAC,KAAK,EAAE,UAAU,CAAC,OAAO,mBAAmB,CAAC,GAAG,MAAM,GAAG,IAAI,CAwB7F;AAED;;GAEG;AACH,wBAAgB,cAAc,CAAC,KAAK,EAAE,UAAU,CAAC,OAAO,mBAAmB,CAAC,+NAG3E;AAED;;GAEG;AACH,wBAAgB,qBAAqB,CACnC,KAAK,EAAE,UAAU,CAAC,OAAO,mBAAmB,CAAC,EAC7C,QAAQ,EAAE,CAAC,KAAK,EAAE,MAAM,EAAE,OAAO,EAAE,eAAe,KAAK,IAAI,cAM5D"}
+{"version":3,"file":"proposal.utils.d.ts","sourceRoot":"","sources":["../../src/governance/proposal.utils.ts"],"names":[],"mappings":"AAYA,OAAO,EAGL,KAAK,aAAa,EAEnB,MAAM,+BAA+B,CAAC;AACvC,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,mBAAmB,CAAC;AAEnD,OAAO,KAAK,EAAE,QAAQ,EAAE,cAAc,EAAE,MAAM,mBAAmB,CAAC;AAElE,MAAM,MAAM,cAAc,GAAG;IAAE,EAAE,EAAE,IAAI,CAAC;IAAC,MAAM,EAAE,cAAc,CAAA;CAAE,GAAG;IAAE,EAAE,EAAE,KAAK,CAAC;IAAC,KAAK,EAAE,MAAM,CAAA;CAAE,CAAC;AAEjG;;;;;;;;GAQG;AACH,wBAAgB,qBAAqB,CACnC,QAAQ,EAAE,QAAQ,EAClB,KAAK,EAAE,aAAa,EACpB,OAAO,GAAE;IAAE,KAAK,CAAC,EAAE,SAAS,CAAA;CAAO,GAClC,cAAc,CAwChB"}