@guyghost/swarm-dao-graph 0.2.0

package/README.md

@@ -0,0 +1,29 @@
+# @guyghost/swarm-dao-graph
+
+Swarm DAO Graph Engineering run executor.
+
+Runs the frozen Graph Engineering machine (in `@guyghost/swarm-dao-core`) as
+journal-replayed runs on disk: every submitted signal is validated (AI signals
+never carry state targets, commands, approvals, retries, cancellations, or
+permission decisions), journaled to `journal.ndjson`, and the snapshot is
+persisted for deterministic replay.
+
+## Usage
+
+```ts
+import { createGraphRunner, validateGraphSignal } from "@guyghost/swarm-dao-graph";
+
+const runner = await createGraphRunner({ evidenceRoot: ".dao/graph-runs", runId: "my-run" });
+const result = await runner.submit(signal);
+```
+
+Or through the CLI entry:
+
+```ts
+import { runGraphCli } from "@guyghost/swarm-dao-graph";
+const code = await runGraphCli(["status", "--run-id", "my-run"]); // 0 | 1 | 2
+```
+
+The `swarm-dao` CLI exposes the same surface as `swarm-dao graph
+<init|status|submit>`; exit codes are 0 (success), 2 (machine rejection),
+1 (usage or execution error).

package/dist/cli.d.ts

@@ -0,0 +1,10 @@
+export interface GraphCliDefaults {
+    /** Evidence root used when --evidence-root is absent (resolved from cwd). */
+    evidenceRoot?: string;
+}
+/**
+ * Entry point for the `graph:*` repo scripts and the swarm-dao CLI.
+ * Exit codes: 0 success, 2 machine rejection, 1 usage or execution error.
+ */
+export declare const runGraphCli: (argv: readonly string[], defaults?: GraphCliDefaults) => Promise<number>;
+//# sourceMappingURL=cli.d.ts.map

package/dist/cli.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"cli.d.ts","sourceRoot":"","sources":["../src/cli.ts"],"names":[],"mappings":"AAYA,MAAM,WAAW,gBAAgB;IAC/B,6EAA6E;IAC7E,YAAY,CAAC,EAAE,MAAM,CAAC;CACvB;AAMD;;;GAGG;AACH,eAAO,MAAM,WAAW,GAAU,MAAM,SAAS,MAAM,EAAE,EAAE,WAAU,gBAAqB,KAAG,OAAO,CAAC,MAAM,CAkC1G,CAAC"}

package/dist/cli.js

@@ -0,0 +1,52 @@
+// Swarm DAO — Graph Engineering run CLI.
+//
+// Thin host entry over GraphRunner: init/status/submit with the same exit-code
+// contract as the improvement series CLI (0 success, 2 machine rejection,
+// 1 usage or execution error). Hosts stay free of transition rules — every
+// submitted signal passes through validateGraphSignal and the frozen machine.
+import { readFile, writeFile } from "node:fs/promises";
+import { resolve } from "node:path";
+import { parseArgs } from "node:util";
+import { createGraphRunner } from "./runner.js";
+const usage = `Usage:
+  graph <init|status|submit> --run-id <id> [--evidence-root <path>]
+  graph submit --run-id <id> --signal <file> [--evidence-root <path>]`;
+/**
+ * Entry point for the `graph:*` repo scripts and the swarm-dao CLI.
+ * Exit codes: 0 success, 2 machine rejection, 1 usage or execution error.
+ */
+export const runGraphCli = async (argv, defaults = {}) => {
+    const command = argv[0];
+    if (command !== "init" && command !== "status" && command !== "submit")
+        throw new Error(usage);
+    const { values } = parseArgs({
+        args: argv.slice(1),
+        strict: true,
+        options: {
+            "run-id": { type: "string" },
+            "evidence-root": { type: "string" },
+            signal: { type: "string" },
+        },
+    });
+    const runId = values["run-id"];
+    if (!runId)
+        throw new Error(`--run-id is required\n${usage}`);
+    const evidenceRoot = resolve(values["evidence-root"] ?? defaults.evidenceRoot ?? ".dao/graph-runs");
+    if (command === "submit" && !values.signal)
+        throw new Error(`--signal is required\n${usage}`);
+    const runner = await createGraphRunner({ evidenceRoot, runId });
+    if (command === "init") {
+        await writeFile(resolve(evidenceRoot, "active-run.json"), `${JSON.stringify({ runId }, null, 2)}\n`, "utf8");
+        process.stdout.write(`${JSON.stringify(runner.snapshot(), null, 2)}\n`);
+        return 0;
+    }
+    if (command === "status") {
+        process.stdout.write(`${JSON.stringify(runner.snapshot(), null, 2)}\n`);
+        return 0;
+    }
+    const signal = JSON.parse(await readFile(resolve(values.signal), "utf8"));
+    const result = await runner.submit(signal);
+    process.stdout.write(`${JSON.stringify(result, null, 2)}\n`);
+    return result.accepted ? 0 : 2;
+};
+//# sourceMappingURL=cli.js.map

package/dist/cli.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"cli.js","sourceRoot":"","sources":["../src/cli.ts"],"names":[],"mappings":"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"}

package/dist/index.d.ts

@@ -0,0 +1,4 @@
+export * from "./cli.js";
+export * from "./runner.js";
+export * from "./signal.js";
+//# sourceMappingURL=index.d.ts.map

package/dist/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAKA,cAAc,UAAU,CAAC;AACzB,cAAc,aAAa,CAAC;AAC5B,cAAc,aAAa,CAAC"}

package/dist/index.js

@@ -0,0 +1,8 @@
+// @guyghost/swarm-dao-graph — executor for Swarm DAO Graph Engineering runs:
+// journal-replayed change-control runs over the frozen machine in
+// @guyghost/swarm-dao-core, with strict signal validation (AI signals never
+// carry authority keys; human-source events cannot be forged by tools).
+export * from "./cli.js";
+export * from "./runner.js";
+export * from "./signal.js";
+//# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,6EAA6E;AAC7E,kEAAkE;AAClE,4EAA4E;AAC5E,wEAAwE;AAExE,cAAc,UAAU,CAAC;AACzB,cAAc,aAAa,CAAC;AAC5B,cAAc,aAAa,CAAC"}

package/dist/runner.d.ts

@@ -0,0 +1,27 @@
+import { type GraphEngineeringContext } from "@guyghost/swarm-dao-core";
+export type PersistedGraphSnapshot = Readonly<{
+    runId: string;
+    state: string;
+    status: string;
+    context: GraphEngineeringContext;
+}>;
+export type GraphSubmissionResult = Readonly<{
+    accepted: boolean;
+    issues: readonly string[];
+    snapshot: PersistedGraphSnapshot;
+}>;
+type RunnerOptions = Readonly<{
+    evidenceRoot: string;
+    runId: string;
+    clock?: () => string;
+}>;
+export declare class GraphRunner {
+    #private;
+    private constructor();
+    static create(options: RunnerOptions): Promise<GraphRunner>;
+    snapshot(): PersistedGraphSnapshot;
+    submit(input: unknown): Promise<GraphSubmissionResult>;
+}
+export declare const createGraphRunner: (options: RunnerOptions) => Promise<GraphRunner>;
+export {};
+//# sourceMappingURL=runner.d.ts.map

package/dist/runner.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"runner.d.ts","sourceRoot":"","sources":["../src/runner.ts"],"names":[],"mappings":"AAEA,OAAO,EAGL,KAAK,uBAAuB,EAC7B,MAAM,0BAA0B,CAAC;AAGlC,MAAM,MAAM,sBAAsB,GAAG,QAAQ,CAAC;IAC5C,KAAK,EAAE,MAAM,CAAC;IACd,KAAK,EAAE,MAAM,CAAC;IACd,MAAM,EAAE,MAAM,CAAC;IACf,OAAO,EAAE,uBAAuB,CAAC;CAClC,CAAC,CAAC;AAEH,MAAM,MAAM,qBAAqB,GAAG,QAAQ,CAAC;IAC3C,QAAQ,EAAE,OAAO,CAAC;IAClB,MAAM,EAAE,SAAS,MAAM,EAAE,CAAC;IAC1B,QAAQ,EAAE,sBAAsB,CAAC;CAClC,CAAC,CAAC;AAeH,KAAK,aAAa,GAAG,QAAQ,CAAC;IAC5B,YAAY,EAAE,MAAM,CAAC;IACrB,KAAK,EAAE,MAAM,CAAC;IACd,KAAK,CAAC,EAAE,MAAM,MAAM,CAAC;CACtB,CAAC,CAAC;AAyBH,qBAAa,WAAW;;IAQtB,OAAO;WAOM,MAAM,CAAC,OAAO,EAAE,aAAa,GAAG,OAAO,CAAC,WAAW,CAAC;IAcjE,QAAQ,IAAI,sBAAsB;IAIlC,MAAM,CAAC,KAAK,EAAE,OAAO,GAAG,OAAO,CAAC,qBAAqB,CAAC;CA8FvD;AAED,eAAO,MAAM,iBAAiB,GAAI,SAAS,aAAa,KAAG,OAAO,CAAC,WAAW,CAAgC,CAAC"}

package/dist/runner.js

@@ -0,0 +1,143 @@
+import { appendFile, mkdir, readFile, writeFile } from "node:fs/promises";
+import { resolve, sep } from "node:path";
+import { createGraphEngineeringActor, } from "@guyghost/swarm-dao-core";
+import { validateGraphSignal } from "./signal.js";
+const validRunId = (runId) => /^[A-Za-z0-9][A-Za-z0-9._-]{0,127}$/.test(runId) && !runId.includes("..");
+const eventTypeFrom = (input) => {
+    if (typeof input !== "object" || input === null || !("type" in input))
+        return null;
+    return typeof input.type === "string" ? input.type : null;
+};
+const serializeSnapshot = (actor) => {
+    const snapshot = actor.getSnapshot();
+    return {
+        runId: snapshot.context.runId,
+        state: String(snapshot.value),
+        status: snapshot.status,
+        context: structuredClone(snapshot.context),
+    };
+};
+const snapshotChanged = (before, after) => before.state !== after.state ||
+    before.status !== after.status ||
+    JSON.stringify(before.context) !== JSON.stringify(after.context);
+export class GraphRunner {
+    #runId;
+    #runDirectory;
+    #clock;
+    #actor;
+    #sequence = 0;
+    #tail = Promise.resolve();
+    constructor(options, runDirectory) {
+        this.#runId = options.runId;
+        this.#runDirectory = runDirectory;
+        this.#clock = options.clock ?? (() => new Date().toISOString());
+        this.#actor = createGraphEngineeringActor(options.runId);
+    }
+    static async create(options) {
+        if (!validRunId(options.runId))
+            throw new Error("runId must be a safe non-empty filesystem identifier");
+        const root = resolve(options.evidenceRoot);
+        const runDirectory = resolve(root, options.runId);
+        if (!runDirectory.startsWith(`${root}${sep}`))
+            throw new Error("runId resolves outside the evidence root");
+        await mkdir(runDirectory, { recursive: true });
+        const runner = new GraphRunner(options, runDirectory);
+        await runner.#restoreJournal();
+        await runner.#persistSnapshot(serializeSnapshot(runner.#actor));
+        return runner;
+    }
+    snapshot() {
+        return serializeSnapshot(this.#actor);
+    }
+    submit(input) {
+        const operation = this.#tail.then(() => this.#submitNow(input));
+        this.#tail = operation.then(() => undefined, () => undefined);
+        return operation;
+    }
+    async #submitNow(input) {
+        const before = serializeSnapshot(this.#actor);
+        const validation = validateGraphSignal(input);
+        let accepted = false;
+        let issues = [];
+        let signal;
+        if (!validation.ok) {
+            issues = validation.issues;
+        }
+        else if (validation.signal.runId !== this.#runId) {
+            issues = [`signal runId must match ${this.#runId}`];
+            signal = validation.signal;
+        }
+        else {
+            signal = validation.signal;
+            this.#actor.send(validation.event);
+            accepted = snapshotChanged(before, serializeSnapshot(this.#actor));
+            if (!accepted)
+                issues = ["machine rejected event for the current state or guards"];
+        }
+        const after = serializeSnapshot(this.#actor);
+        const entry = {
+            sequence: ++this.#sequence,
+            runId: this.#runId,
+            receivedAt: this.#clock(),
+            eventType: eventTypeFrom(input),
+            producer: signal?.producer ?? null,
+            accepted,
+            issues,
+            beforeState: before.state,
+            afterState: after.state,
+            ...(signal ? { signal } : {}),
+        };
+        await appendFile(resolve(this.#runDirectory, "journal.ndjson"), `${JSON.stringify(entry)}\n`, "utf8");
+        await this.#persistSnapshot(after);
+        return { accepted, issues, snapshot: after };
+    }
+    async #persistSnapshot(snapshot) {
+        await writeFile(resolve(this.#runDirectory, "snapshot.json"), `${JSON.stringify(snapshot, null, 2)}\n`, "utf8");
+    }
+    async #restoreJournal() {
+        const journalPath = resolve(this.#runDirectory, "journal.ndjson");
+        let content;
+        try {
+            content = await readFile(journalPath, "utf8");
+        }
+        catch (error) {
+            if (typeof error === "object" && error !== null && "code" in error && error.code === "ENOENT")
+                return;
+            throw error;
+        }
+        const lines = content.split("\n").filter((line) => line.trim().length > 0);
+        for (const [index, line] of lines.entries()) {
+            let entry;
+            try {
+                entry = JSON.parse(line);
+            }
+            catch {
+                throw new Error(`journal line ${index + 1} is not valid JSON`);
+            }
+            if (typeof entry !== "object" ||
+                entry === null ||
+                !("sequence" in entry) ||
+                entry.sequence !== index + 1 ||
+                !("accepted" in entry) ||
+                typeof entry.accepted !== "boolean") {
+                throw new Error(`journal line ${index + 1} violates sequence contract`);
+            }
+            this.#sequence = entry.sequence;
+            if (!entry.accepted)
+                continue;
+            if (!("signal" in entry))
+                throw new Error(`accepted journal line ${index + 1} has no signal`);
+            const validation = validateGraphSignal(entry.signal);
+            if (!validation.ok || validation.signal.runId !== this.#runId) {
+                throw new Error(`accepted journal line ${index + 1} has an invalid signal`);
+            }
+            const before = serializeSnapshot(this.#actor);
+            this.#actor.send(validation.event);
+            if (!snapshotChanged(before, serializeSnapshot(this.#actor))) {
+                throw new Error(`accepted journal line ${index + 1} cannot be replayed deterministically`);
+            }
+        }
+    }
+}
+export const createGraphRunner = (options) => GraphRunner.create(options);
+//# sourceMappingURL=runner.js.map

package/dist/runner.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"runner.js","sourceRoot":"","sources":["../src/runner.ts"],"names":[],"mappings":"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"}

package/dist/signal.d.ts

@@ -0,0 +1,20 @@
+import { type GraphEngineeringEvent, type GraphSignalSource } from "@guyghost/swarm-dao-core";
+export type GraphSignal = Readonly<{
+    runId: string;
+    type: string;
+    source: GraphSignalSource;
+    producer: string;
+    occurredAt: string;
+    payload: Readonly<Record<string, unknown>>;
+    evidence: readonly string[];
+}>;
+export type GraphSignalValidation = Readonly<{
+    ok: true;
+    signal: GraphSignal;
+    event: GraphEngineeringEvent;
+}> | Readonly<{
+    ok: false;
+    issues: readonly string[];
+}>;
+export declare const validateGraphSignal: (input: unknown) => GraphSignalValidation;
+//# sourceMappingURL=signal.d.ts.map

package/dist/signal.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"signal.d.ts","sourceRoot":"","sources":["../src/signal.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,KAAK,qBAAqB,EAAE,KAAK,iBAAiB,EAAyB,MAAM,0BAA0B,CAAC;AAErH,MAAM,MAAM,WAAW,GAAG,QAAQ,CAAC;IACjC,KAAK,EAAE,MAAM,CAAC;IACd,IAAI,EAAE,MAAM,CAAC;IACb,MAAM,EAAE,iBAAiB,CAAC;IAC1B,QAAQ,EAAE,MAAM,CAAC;IACjB,UAAU,EAAE,MAAM,CAAC;IACnB,OAAO,EAAE,QAAQ,CAAC,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC,CAAC;IAC3C,QAAQ,EAAE,SAAS,MAAM,EAAE,CAAC;CAC7B,CAAC,CAAC;AAEH,MAAM,MAAM,qBAAqB,GAC7B,QAAQ,CAAC;IAAE,EAAE,EAAE,IAAI,CAAC;IAAC,MAAM,EAAE,WAAW,CAAC;IAAC,KAAK,EAAE,qBAAqB,CAAA;CAAE,CAAC,GACzE,QAAQ,CAAC;IAAE,EAAE,EAAE,KAAK,CAAC;IAAC,MAAM,EAAE,SAAS,MAAM,EAAE,CAAA;CAAE,CAAC,CAAC;AAwHvD,eAAO,MAAM,mBAAmB,GAAI,OAAO,OAAO,KAAG,qBAgDpD,CAAC"}

package/dist/signal.js

@@ -0,0 +1,155 @@
+import { isRequiredGraphAnchor } from "@guyghost/swarm-dao-core";
+const EVENT_SOURCES = {
+    MODEL_DRAFTED: "ai",
+    MODEL_CONTRACT_VALID: "tool",
+    MODEL_CONTRACT_INVALID: "tool",
+    MODEL_APPROVED: "human",
+    MODEL_REJECTED: "human",
+    START_IMPLEMENTATION: "system",
+    IMPLEMENTATION_READY: "ai",
+    IMPLEMENTATION_FAILED: "ai",
+    ANCHOR_RECORDED: "tool",
+    EVALUATE: "system",
+    RETRY_AUTHORIZED: "human",
+    PERMISSION_DENIED: "tool",
+    CANCEL: "human",
+};
+const FORBIDDEN_TRANSITION_KEYS = new Set(["nextState", "targetState", "transition"]);
+const FORBIDDEN_AI_AUTHORITY_KEYS = new Set([
+    "command",
+    "cmd",
+    "shell",
+    "approval",
+    "approve",
+    "retry",
+    "cancel",
+    "permission",
+]);
+const isRecord = (value) => typeof value === "object" && value !== null && !Array.isArray(value);
+const nonEmptyString = (value) => typeof value === "string" && value.trim().length > 0;
+const findForbiddenKeys = (value, forbidden, path = "signal") => {
+    if (Array.isArray(value)) {
+        return value.flatMap((entry, index) => findForbiddenKeys(entry, forbidden, `${path}[${index}]`));
+    }
+    if (!isRecord(value))
+        return [];
+    return Object.entries(value).flatMap(([key, entry]) => [
+        ...(forbidden.has(key) ? [`${path}.${key} is forbidden`] : []),
+        ...findForbiddenKeys(entry, forbidden, `${path}.${key}`),
+    ]);
+};
+const requiredPayloadString = (payload, key, issues) => {
+    const value = payload[key];
+    if (!nonEmptyString(value)) {
+        issues.push(`payload.${key} must be a non-empty string`);
+        return "";
+    }
+    return value;
+};
+const firstEvidence = (evidence, issues) => {
+    const value = evidence.find(nonEmptyString);
+    if (!value) {
+        issues.push("evidence must contain at least one non-empty entry");
+        return "";
+    }
+    return value;
+};
+const buildEvent = (type, source, payload, evidence, issues) => {
+    switch (type) {
+        case "MODEL_DRAFTED":
+            firstEvidence(evidence, issues);
+            return { type, source, modelHash: requiredPayloadString(payload, "modelHash", issues) };
+        case "MODEL_CONTRACT_VALID":
+            return { type, source, evidence: firstEvidence(evidence, issues) };
+        case "MODEL_CONTRACT_INVALID":
+            return { type, source, reason: requiredPayloadString(payload, "reason", issues) };
+        case "MODEL_APPROVED":
+            return { type, source, modelHash: requiredPayloadString(payload, "modelHash", issues) };
+        case "MODEL_REJECTED":
+            return { type, source, reason: requiredPayloadString(payload, "reason", issues) };
+        case "START_IMPLEMENTATION":
+            return { type, source };
+        case "IMPLEMENTATION_READY":
+            firstEvidence(evidence, issues);
+            return { type, source, implementationHash: requiredPayloadString(payload, "implementationHash", issues) };
+        case "IMPLEMENTATION_FAILED":
+            return { type, source, reason: requiredPayloadString(payload, "reason", issues) };
+        case "ANCHOR_RECORDED": {
+            const anchor = payload.anchor;
+            if (!isRequiredGraphAnchor(anchor) || anchor === "model-contract") {
+                issues.push("payload.anchor must be a permitted implementation anchor");
+            }
+            const status = payload.status;
+            if (status !== "passed" && status !== "failed") {
+                issues.push('payload.status must be "passed" or "failed"');
+            }
+            return {
+                type,
+                source,
+                anchor: isRequiredGraphAnchor(anchor) ? anchor : "graph-tests",
+                status: status === "failed" ? "failed" : "passed",
+                evidence: firstEvidence(evidence, issues),
+            };
+        }
+        case "EVALUATE":
+            return { type, source };
+        case "RETRY_AUTHORIZED":
+            return { type, source };
+        case "PERMISSION_DENIED":
+            return { type, source, reason: requiredPayloadString(payload, "reason", issues) };
+        case "CANCEL":
+            return { type, source, reason: requiredPayloadString(payload, "reason", issues) };
+    }
+};
+export const validateGraphSignal = (input) => {
+    const issues = [];
+    if (!isRecord(input))
+        return { ok: false, issues: ["signal must be an object"] };
+    if (!nonEmptyString(input.runId))
+        issues.push("runId must be a non-empty string");
+    if (!nonEmptyString(input.producer))
+        issues.push("producer must be a non-empty string");
+    if (!nonEmptyString(input.occurredAt) || Number.isNaN(Date.parse(input.occurredAt))) {
+        issues.push("occurredAt must be a valid ISO timestamp");
+    }
+    if (!isRecord(input.payload))
+        issues.push("payload must be an object");
+    if (!Array.isArray(input.evidence) || !input.evidence.every((entry) => typeof entry === "string")) {
+        issues.push("evidence must be an array of strings");
+    }
+    const type = input.type;
+    const knownType = typeof type === "string" && type in EVENT_SOURCES ? type : null;
+    if (!knownType)
+        issues.push("type must be a known graph event");
+    const source = input.source;
+    const validSource = source === "ai" || source === "tool" || source === "human" || source === "system";
+    if (!validSource)
+        issues.push("source must be ai, tool, human, or system");
+    if (knownType && validSource && EVENT_SOURCES[knownType] !== source) {
+        issues.push(`source for ${knownType} must be ${EVENT_SOURCES[knownType]}`);
+    }
+    issues.push(...findForbiddenKeys(input, FORBIDDEN_TRANSITION_KEYS));
+    if (source === "ai")
+        issues.push(...findForbiddenKeys(input, FORBIDDEN_AI_AUTHORITY_KEYS));
+    const payload = isRecord(input.payload) ? input.payload : {};
+    const evidence = Array.isArray(input.evidence)
+        ? input.evidence.filter((entry) => typeof entry === "string")
+        : [];
+    const event = knownType && validSource ? buildEvent(knownType, source, payload, evidence, issues) : null;
+    if (issues.length > 0 || !event || !knownType)
+        return { ok: false, issues };
+    return {
+        ok: true,
+        signal: {
+            runId: input.runId,
+            type: knownType,
+            source: source,
+            producer: input.producer,
+            occurredAt: input.occurredAt,
+            payload,
+            evidence,
+        },
+        event,
+    };
+};
+//# sourceMappingURL=signal.js.map

package/dist/signal.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"signal.js","sourceRoot":"","sources":["../src/signal.ts"],"names":[],"mappings":"AAAA,OAAO,EAAsD,qBAAqB,EAAE,MAAM,0BAA0B,CAAC;AAgBrH,MAAM,aAAa,GAAG;IACpB,aAAa,EAAE,IAAI;IACnB,oBAAoB,EAAE,MAAM;IAC5B,sBAAsB,EAAE,MAAM;IAC9B,cAAc,EAAE,OAAO;IACvB,cAAc,EAAE,OAAO;IACvB,oBAAoB,EAAE,QAAQ;IAC9B,oBAAoB,EAAE,IAAI;IAC1B,qBAAqB,EAAE,IAAI;IAC3B,eAAe,EAAE,MAAM;IACvB,QAAQ,EAAE,QAAQ;IAClB,gBAAgB,EAAE,OAAO;IACzB,iBAAiB,EAAE,MAAM;IACzB,MAAM,EAAE,OAAO;CAC4D,CAAC;AAI9E,MAAM,yBAAyB,GAAG,IAAI,GAAG,CAAC,CAAC,WAAW,EAAE,aAAa,EAAE,YAAY,CAAC,CAAC,CAAC;AACtF,MAAM,2BAA2B,GAAG,IAAI,GAAG,CAAC;IAC1C,SAAS;IACT,KAAK;IACL,OAAO;IACP,UAAU;IACV,SAAS;IACT,OAAO;IACP,QAAQ;IACR,YAAY;CACb,CAAC,CAAC;AAEH,MAAM,QAAQ,GAAG,CAAC,KAAc,EAAoC,EAAE,CACpE,OAAO,KAAK,KAAK,QAAQ,IAAI,KAAK,KAAK,IAAI,IAAI,CAAC,KAAK,CAAC,OAAO,CAAC,KAAK,CAAC,CAAC;AAEvE,MAAM,cAAc,GAAG,CAAC,KAAc,EAAmB,EAAE,CAAC,OAAO,KAAK,KAAK,QAAQ,IAAI,KAAK,CAAC,IAAI,EAAE,CAAC,MAAM,GAAG,CAAC,CAAC;AAEjH,MAAM,iBAAiB,GAAG,CAAC,KAAc,EAAE,SAA8B,EAAE,IAAI,GAAG,QAAQ,EAAY,EAAE;IACtG,IAAI,KAAK,CAAC,OAAO,CAAC,KAAK,CAAC,EAAE,CAAC;QACzB,OAAO,KAAK,CAAC,OAAO,CAAC,CAAC,KAAK,EAAE,KAAK,EAAE,EAAE,CAAC,iBAAiB,CAAC,KAAK,EAAE,SAAS,EAAE,GAAG,IAAI,IAAI,KAAK,GAAG,CAAC,CAAC,CAAC;IACnG,CAAC;IACD,IAAI,CAAC,QAAQ,CAAC,KAAK,CAAC;QAAE,OAAO,EAAE,CAAC;IAChC,OAAO,MAAM,CAAC,OAAO,CAAC,KAAK,CAAC,CAAC,OAAO,CAAC,CAAC,CAAC,GAAG,EAAE,KAAK,CAAC,EAAE,EAAE,CAAC;QACrD,GAAG,CAAC,SAAS,CAAC,GAAG,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,CAAC,GAAG,IAAI,IAAI,GAAG,eAAe,CAAC,CAAC,CAAC,CAAC,EAAE,CAAC;QAC9D,GAAG,iBAAiB,CAAC,KAAK,EAAE,SAAS,EAAE,GAAG,IAAI,IAAI,GAAG,EAAE,CAAC;KACzD,CAAC,CAAC;AACL,CAAC,CAAC;AAEF,MAAM,qBAAqB,GAAG,CAAC,OAA0C,EAAE,GAAW,EAAE,MAAgB,EAAU,EAAE;IAClH,MAAM,KAAK,GAAG,OAAO,CAAC,GAAG,CAAC,CAAC;IAC3B,IAAI,CAAC,cAAc,CAAC,KAAK,CAAC,EAAE,CAAC;QAC3B,MAAM,CAAC,IAAI,CAAC,WAAW,GAAG,6BAA6B,CAAC,CAAC;QACzD,OAAO,EAAE,CAAC;IACZ,CAAC;IACD,OAAO,KAAK,CAAC;AACf,CAAC,CAAC;AAEF,MAAM,aAAa,GAAG,CAAC,QAA2B,EAAE,MAAgB,EAAU,EAAE;IAC9E,MAAM,KAAK,GAAG,QAAQ,CAAC,IAAI,CAAC,cAAc,CAAC,CAAC;IAC5C,IAAI,CAAC,KAAK,EAAE,CAAC;QACX,MAAM,CAAC,IAAI,CAAC,oDAAoD,CAAC,CAAC;QAClE,OAAO,EAAE,CAAC;IACZ,CAAC;IACD,OAAO,KAAK,CAAC;AACf,CAAC,CAAC;AAEF,MAAM,UAAU,GAAG,CACjB,IAAoB,EACpB,MAAyB,EACzB,OAA0C,EAC1C,QAA2B,EAC3B,MAAgB,EACO,EAAE;IACzB,QAAQ,IAAI,EAAE,CAAC;QACb,KAAK,eAAe;YAClB,aAAa,CAAC,QAAQ,EAAE,MAAM,CAAC,CAAC;YAChC,OAAO,EAAE,IAAI,EAAE,MAAM,EAAE,SAAS,EAAE,qBAAqB,CAAC,OAAO,EAAE,WAAW,EAAE,MAAM,CAAC,EAAE,CAAC;QAC1F,KAAK,sBAAsB;YACzB,OAAO,EAAE,IAAI,EAAE,MAAM,EAAE,QAAQ,EAAE,aAAa,CAAC,QAAQ,EAAE,MAAM,CAAC,EAAE,CAAC;QACrE,KAAK,wBAAwB;YAC3B,OAAO,EAAE,IAAI,EAAE,MAAM,EAAE,MAAM,EAAE,qBAAqB,CAAC,OAAO,EAAE,QAAQ,EAAE,MAAM,CAAC,EAAE,CAAC;QACpF,KAAK,gBAAgB;YACnB,OAAO,EAAE,IAAI,EAAE,MAAM,EAAE,SAAS,EAAE,qBAAqB,CAAC,OAAO,EAAE,WAAW,EAAE,MAAM,CAAC,EAAE,CAAC;QAC1F,KAAK,gBAAgB;YACnB,OAAO,EAAE,IAAI,EAAE,MAAM,EAAE,MAAM,EAAE,qBAAqB,CAAC,OAAO,EAAE,QAAQ,EAAE,MAAM,CAAC,EAAE,CAAC;QACpF,KAAK,sBAAsB;YACzB,OAAO,EAAE,IAAI,EAAE,MAAM,EAAE,CAAC;QAC1B,KAAK,sBAAsB;YACzB,aAAa,CAAC,QAAQ,EAAE,MAAM,CAAC,CAAC;YAChC,OAAO,EAAE,IAAI,EAAE,MAAM,EAAE,kBAAkB,EAAE,qBAAqB,CAAC,OAAO,EAAE,oBAAoB,EAAE,MAAM,CAAC,EAAE,CAAC;QAC5G,KAAK,uBAAuB;YAC1B,OAAO,EAAE,IAAI,EAAE,MAAM,EAAE,MAAM,EAAE,qBAAqB,CAAC,OAAO,EAAE,QAAQ,EAAE,MAAM,CAAC,EAAE,CAAC;QACpF,KAAK,iBAAiB,CAAC,CAAC,CAAC;YACvB,MAAM,MAAM,GAAG,OAAO,CAAC,MAAM,CAAC;YAC9B,IAAI,CAAC,qBAAqB,CAAC,MAAM,CAAC,IAAI,MAAM,KAAK,gBAAgB,EAAE,CAAC;gBAClE,MAAM,CAAC,IAAI,CAAC,0DAA0D,CAAC,CAAC;YAC1E,CAAC;YACD,MAAM,MAAM,GAAG,OAAO,CAAC,MAAM,CAAC;YAC9B,IAAI,MAAM,KAAK,QAAQ,IAAI,MAAM,KAAK,QAAQ,EAAE,CAAC;gBAC/C,MAAM,CAAC,IAAI,CAAC,6CAA6C,CAAC,CAAC;YAC7D,CAAC;YACD,OAAO;gBACL,IAAI;gBACJ,MAAM;gBACN,MAAM,EAAE,qBAAqB,CAAC,MAAM,CAAC,CAAC,CAAC,CAAC,MAAM,CAAC,CAAC,CAAC,aAAa;gBAC9D,MAAM,EAAE,MAAM,KAAK,QAAQ,CAAC,CAAC,CAAC,QAAQ,CAAC,CAAC,CAAC,QAAQ;gBACjD,QAAQ,EAAE,aAAa,CAAC,QAAQ,EAAE,MAAM,CAAC;aAC1C,CAAC;QACJ,CAAC;QACD,KAAK,UAAU;YACb,OAAO,EAAE,IAAI,EAAE,MAAM,EAAE,CAAC;QAC1B,KAAK,kBAAkB;YACrB,OAAO,EAAE,IAAI,EAAE,MAAM,EAAE,CAAC;QAC1B,KAAK,mBAAmB;YACtB,OAAO,EAAE,IAAI,EAAE,MAAM,EAAE,MAAM,EAAE,qBAAqB,CAAC,OAAO,EAAE,QAAQ,EAAE,MAAM,CAAC,EAAE,CAAC;QACpF,KAAK,QAAQ;YACX,OAAO,EAAE,IAAI,EAAE,MAAM,EAAE,MAAM,EAAE,qBAAqB,CAAC,OAAO,EAAE,QAAQ,EAAE,MAAM,CAAC,EAAE,CAAC;IACtF,CAAC;AACH,CAAC,CAAC;AAEF,MAAM,CAAC,MAAM,mBAAmB,GAAG,CAAC,KAAc,EAAyB,EAAE;IAC3E,MAAM,MAAM,GAAa,EAAE,CAAC;IAC5B,IAAI,CAAC,QAAQ,CAAC,KAAK,CAAC;QAAE,OAAO,EAAE,EAAE,EAAE,KAAK,EAAE,MAAM,EAAE,CAAC,0BAA0B,CAAC,EAAE,CAAC;IAEjF,IAAI,CAAC,cAAc,CAAC,KAAK,CAAC,KAAK,CAAC;QAAE,MAAM,CAAC,IAAI,CAAC,kCAAkC,CAAC,CAAC;IAClF,IAAI,CAAC,cAAc,CAAC,KAAK,CAAC,QAAQ,CAAC;QAAE,MAAM,CAAC,IAAI,CAAC,qCAAqC,CAAC,CAAC;IACxF,IAAI,CAAC,cAAc,CAAC,KAAK,CAAC,UAAU,CAAC,IAAI,MAAM,CAAC,KAAK,CAAC,IAAI,CAAC,KAAK,CAAC,KAAK,CAAC,UAAU,CAAC,CAAC,EAAE,CAAC;QACpF,MAAM,CAAC,IAAI,CAAC,0CAA0C,CAAC,CAAC;IAC1D,CAAC;IACD,IAAI,CAAC,QAAQ,CAAC,KAAK,CAAC,OAAO,CAAC;QAAE,MAAM,CAAC,IAAI,CAAC,2BAA2B,CAAC,CAAC;IACvE,IAAI,CAAC,KAAK,CAAC,OAAO,CAAC,KAAK,CAAC,QAAQ,CAAC,IAAI,CAAC,KAAK,CAAC,QAAQ,CAAC,KAAK,CAAC,CAAC,KAAK,EAAE,EAAE,CAAC,OAAO,KAAK,KAAK,QAAQ,CAAC,EAAE,CAAC;QAClG,MAAM,CAAC,IAAI,CAAC,sCAAsC,CAAC,CAAC;IACtD,CAAC;IAED,MAAM,IAAI,GAAG,KAAK,CAAC,IAAI,CAAC;IACxB,MAAM,SAAS,GAAG,OAAO,IAAI,KAAK,QAAQ,IAAI,IAAI,IAAI,aAAa,CAAC,CAAC,CAAE,IAAuB,CAAC,CAAC,CAAC,IAAI,CAAC;IACtG,IAAI,CAAC,SAAS;QAAE,MAAM,CAAC,IAAI,CAAC,kCAAkC,CAAC,CAAC;IAEhE,MAAM,MAAM,GAAG,KAAK,CAAC,MAAM,CAAC;IAC5B,MAAM,WAAW,GAAG,MAAM,KAAK,IAAI,IAAI,MAAM,KAAK,MAAM,IAAI,MAAM,KAAK,OAAO,IAAI,MAAM,KAAK,QAAQ,CAAC;IACtG,IAAI,CAAC,WAAW;QAAE,MAAM,CAAC,IAAI,CAAC,2CAA2C,CAAC,CAAC;IAC3E,IAAI,SAAS,IAAI,WAAW,IAAI,aAAa,CAAC,SAAS,CAAC,KAAK,MAAM,EAAE,CAAC;QACpE,MAAM,CAAC,IAAI,CAAC,cAAc,SAAS,YAAY,aAAa,CAAC,SAAS,CAAC,EAAE,CAAC,CAAC;IAC7E,CAAC;IAED,MAAM,CAAC,IAAI,CAAC,GAAG,iBAAiB,CAAC,KAAK,EAAE,yBAAyB,CAAC,CAAC,CAAC;IACpE,IAAI,MAAM,KAAK,IAAI;QAAE,MAAM,CAAC,IAAI,CAAC,GAAG,iBAAiB,CAAC,KAAK,EAAE,2BAA2B,CAAC,CAAC,CAAC;IAE3F,MAAM,OAAO,GAAG,QAAQ,CAAC,KAAK,CAAC,OAAO,CAAC,CAAC,CAAC,CAAC,KAAK,CAAC,OAAO,CAAC,CAAC,CAAC,EAAE,CAAC;IAC7D,MAAM,QAAQ,GAAG,KAAK,CAAC,OAAO,CAAC,KAAK,CAAC,QAAQ,CAAC;QAC5C,CAAC,CAAC,KAAK,CAAC,QAAQ,CAAC,MAAM,CAAC,CAAC,KAAK,EAAmB,EAAE,CAAC,OAAO,KAAK,KAAK,QAAQ,CAAC;QAC9E,CAAC,CAAC,EAAE,CAAC;IACP,MAAM,KAAK,GAAG,SAAS,IAAI,WAAW,CAAC,CAAC,CAAC,UAAU,CAAC,SAAS,EAAE,MAAM,EAAE,OAAO,EAAE,QAAQ,EAAE,MAAM,CAAC,CAAC,CAAC,CAAC,IAAI,CAAC;IAEzG,IAAI,MAAM,CAAC,MAAM,GAAG,CAAC,IAAI,CAAC,KAAK,IAAI,CAAC,SAAS;QAAE,OAAO,EAAE,EAAE,EAAE,KAAK,EAAE,MAAM,EAAE,CAAC;IAC5E,OAAO;QACL,EAAE,EAAE,IAAI;QACR,MAAM,EAAE;YACN,KAAK,EAAE,KAAK,CAAC,KAAe;YAC5B,IAAI,EAAE,SAAS;YACf,MAAM,EAAE,MAA2B;YACnC,QAAQ,EAAE,KAAK,CAAC,QAAkB;YAClC,UAAU,EAAE,KAAK,CAAC,UAAoB;YACtC,OAAO;YACP,QAAQ;SACT;QACD,KAAK;KACN,CAAC;AACJ,CAAC,CAAC"}

package/package.json

@@ -0,0 +1,54 @@
+{
+  "name": "@guyghost/swarm-dao-graph",
+  "version": "0.2.0",
+  "description": "Swarm DAO Graph Engineering run executor — journal-replayed change-control runs with strict signal validation",
+  "type": "module",
+  "main": "./dist/index.js",
+  "types": "./dist/index.d.ts",
+  "sideEffects": false,
+  "files": [
+    "dist",
+    "README.md"
+  ],
+  "exports": {
+    ".": {
+      "types": "./dist/index.d.ts",
+      "import": "./dist/index.js"
+    }
+  },
+  "scripts": {
+    "build": "tsc",
+    "test": "bun test",
+    "lint": "biome check .",
+    "typecheck": "tsc --noEmit",
+    "prepublishOnly": "bun run build"
+  },
+  "dependencies": {
+    "@guyghost/swarm-dao-core": "^0.10.2"
+  },
+  "devDependencies": {
+    "@types/bun": "1.3.14",
+    "@types/node": "^26.0.1"
+  },
+  "keywords": [
+    "swarm-dao",
+    "graph-engineering",
+    "change-control",
+    "dao",
+    "xstate"
+  ],
+  "author": "guyghost",
+  "license": "MIT",
+  "repository": {
+    "type": "git",
+    "url": "git+https://github.com/guyghost/swarm-dao.git",
+    "directory": "packages/graph-engineering"
+  },
+  "bugs": {
+    "url": "https://github.com/guyghost/swarm-dao/issues"
+  },
+  "homepage": "https://github.com/guyghost/swarm-dao#readme",
+  "publishConfig": {
+    "access": "public"
+  }
+}