@guyghost/swarm-dao-improvement 0.2.1

package/dist/signal.js

@@ -0,0 +1,216 @@
+import { isRequiredImprovementAnchor, } from "@guyghost/swarm-dao-core/models/improvement";
+const EVENT_SOURCES = {
+    METRIC_SAMPLED: "ai",
+    COUNTER_SAMPLED: "ai",
+    SAMPLES_SEALED: "tool",
+    DRIFT_ESTIMATE: "ai",
+    ARBITRATION: "tool",
+    ANCHOR_RECORDED: "tool",
+    EVALUATE: "system",
+    REFERENCE_CHANGE_APPROVED: "human",
+    REFERENCE_CHANGE_REJECTED: "human",
+    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",
+    "referenceHash",
+    "reference",
+    "target",
+    "retry",
+    "cancel",
+    "permission",
+]);
+// Producer -> { declared source, emitted event types }. Mirrors the frozen
+// authority model in models/improvement-loop.graph.json so that a signal's
+// authority is bound to the producer's declared node, not to a caller-supplied
+// `source` label. An AI producer (e.g. "sensor") therefore cannot emit a
+// human-authority event (e.g. CANCEL) by forging source: "human".
+const PRODUCER_EMISSIONS = {
+    sensor: { source: "ai", emits: new Set(["METRIC_SAMPLED"]) },
+    "counter-sensor": { source: "ai", emits: new Set(["COUNTER_SAMPLED"]) },
+    "sample-gate": { source: "tool", emits: new Set(["SAMPLES_SEALED", "PERMISSION_DENIED"]) },
+    "drift-auditor": { source: "ai", emits: new Set(["DRIFT_ESTIMATE"]) },
+    arbitrator: { source: "tool", emits: new Set(["ARBITRATION"]) },
+    "anchor-verifier": { source: "tool", emits: new Set(["ANCHOR_RECORDED", "PERMISSION_DENIED"]) },
+    "human-owner": {
+        source: "human",
+        emits: new Set(["REFERENCE_CHANGE_APPROVED", "REFERENCE_CHANGE_REJECTED", "RETRY_AUTHORIZED", "CANCEL"]),
+    },
+};
+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 requireSample = (payload, issues) => {
+    const sample = payload.sample;
+    if (!isRecord(sample) || !nonEmptyString(sample.value) || !nonEmptyString(sample.evidence)) {
+        issues.push("payload.sample must be { value: string, evidence: string }");
+        return { value: "", evidence: "" };
+    }
+    return { value: sample.value, evidence: sample.evidence };
+};
+const buildEvent = (type, source, payload, evidence, issues) => {
+    switch (type) {
+        case "METRIC_SAMPLED": {
+            const sample = requireSample(payload, issues);
+            firstEvidence(evidence, issues);
+            return { type, source, sample };
+        }
+        case "COUNTER_SAMPLED": {
+            const sample = requireSample(payload, issues);
+            firstEvidence(evidence, issues);
+            return { type, source, sample };
+        }
+        case "SAMPLES_SEALED":
+            return { type, source };
+        case "DRIFT_ESTIMATE": {
+            const driftClass = payload.driftClass;
+            if (driftClass !== "none" && driftClass !== "partial" && driftClass !== "detached") {
+                issues.push("payload.driftClass must be none, partial, or detached");
+            }
+            return {
+                type,
+                source,
+                driftClass: driftClass === "detached" ? "detached" : driftClass === "partial" ? "partial" : "none",
+            };
+        }
+        case "ARBITRATION":
+            return { type, source, outcome: requiredPayloadString(payload, "outcome", issues) };
+        case "ANCHOR_RECORDED": {
+            const anchor = payload.anchor;
+            if (!isRequiredImprovementAnchor(anchor)) {
+                issues.push("payload.anchor must be a required improvement anchor");
+            }
+            const status = payload.status;
+            if (status !== "passed" && status !== "failed") {
+                issues.push('payload.status must be "passed" or "failed"');
+            }
+            return {
+                type,
+                source,
+                anchor: isRequiredImprovementAnchor(anchor) ? anchor : "regression",
+                status: status === "failed" ? "failed" : "passed",
+                evidence: firstEvidence(evidence, issues),
+            };
+        }
+        case "EVALUATE":
+            return { type, source };
+        case "REFERENCE_CHANGE_APPROVED":
+            return { type, source, referenceHash: requiredPayloadString(payload, "referenceHash", issues) };
+        case "REFERENCE_CHANGE_REJECTED":
+            return { type, source, reason: requiredPayloadString(payload, "reason", issues) };
+        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 validateImprovementSignal = (input) => {
+    const issues = [];
+    if (!isRecord(input))
+        return { ok: false, issues: ["signal must be an object"] };
+    if (!nonEmptyString(input.cycleId))
+        issues.push("cycleId 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 improvement event");
+    const source = input.source === "ai" || input.source === "tool" || input.source === "human" || input.source === "system"
+        ? input.source
+        : null;
+    const validSource = source !== null;
+    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]}`);
+    }
+    // Bind the event's authority to the producer's declared graph node. EVALUATE
+    // is emitted by the improvement-runner (a system principal with no graph
+    // producer node) and is gated by the source === "system" rule above.
+    const producer = typeof input.producer === "string" ? input.producer : "";
+    if (knownType && knownType !== "EVALUATE") {
+        const declared = PRODUCER_EMISSIONS[producer];
+        if (!declared) {
+            issues.push(`producer ${producer || "?"} is not a declared graph producer for ${knownType}`);
+        }
+        else {
+            if (!declared.emits.has(knownType)) {
+                issues.push(`producer ${producer} is not declared to emit ${knownType}`);
+            }
+            if (validSource && declared.source !== source) {
+                issues.push(`producer ${producer} must use source ${declared.source}, not ${source}`);
+            }
+        }
+    }
+    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;
+    // knownType/source nullability is collapsed here: any null already pushed an
+    // issue, so the ok-path can only be reached with a fully validated signal.
+    if (issues.length > 0 || !event || knownType === null || source === null) {
+        return { ok: false, issues };
+    }
+    return {
+        ok: true,
+        signal: {
+            cycleId: input.cycleId,
+            type: knownType,
+            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":"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"}

package/dist/workers.d.ts

@@ -0,0 +1,41 @@
+import type { HerdrRunner } from "@guyghost/swarm-dao-herdr-adapter";
+export interface HerdrWorkerOptions {
+    /** Repository root the worker workspaces run in. */
+    workDir: string;
+    /** herdr agent kind (default "pi"). */
+    kind?: string;
+    /** Extra args passed to the agent executable. Default ["-ne"]: worker agents
+     * are signal-only and must not carry the dao_* extension tools; disabling
+     * extension discovery also sidesteps the local .pi extension conflict. */
+    agentArgs?: readonly string[];
+    /** Per-attempt prompt timeout in ms (default 5 min; herdr max 300000). */
+    timeoutMs?: number;
+    /** agent start readiness timeout in ms (default 120 s; herdr max 300000). */
+    startTimeoutMs?: number;
+    /** Lines of terminal output harvested per worker (default 200). */
+    readLines?: number;
+    /** Keep the herdr workspaces alive after harvest (default false). */
+    keepPanes?: boolean;
+    /** Injectable command runner (tests). */
+    runner?: HerdrRunner;
+}
+export type WorkerHarvest = Readonly<{
+    ok: true;
+    content: string;
+} | {
+    ok: false;
+    error: string;
+}>;
+export declare const toBoundedInt: (value: unknown, fallback: number, min: number, max: number) => number;
+/**
+ * Run one worker prompt inside a herdr workspace, with bounded effect-level
+ * retries (fresh workspace and unique agent name per attempt).
+ */
+export declare function runHerdrWorker(options: HerdrWorkerOptions, name: string, prompt: string): Promise<WorkerHarvest>;
+/**
+ * Extract the worker's JSON answer from a harvested transcript. Agents echo
+ * the prompt (which itself contains JSON templates), so only the LAST JSON
+ * object in the transcript is the answer; earlier ones are ignored.
+ */
+export declare function extractLastJsonObject(content: string): Record<string, unknown> | null;
+//# sourceMappingURL=workers.d.ts.map

package/dist/workers.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"workers.d.ts","sourceRoot":"","sources":["../src/workers.ts"],"names":[],"mappings":"AAkBA,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,mCAAmC,CAAC;AAqBrE,MAAM,WAAW,kBAAkB;IACjC,oDAAoD;IACpD,OAAO,EAAE,MAAM,CAAC;IAChB,uCAAuC;IACvC,IAAI,CAAC,EAAE,MAAM,CAAC;IACd;;8EAE0E;IAC1E,SAAS,CAAC,EAAE,SAAS,MAAM,EAAE,CAAC;IAC9B,0EAA0E;IAC1E,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,6EAA6E;IAC7E,cAAc,CAAC,EAAE,MAAM,CAAC;IACxB,mEAAmE;IACnE,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,qEAAqE;IACrE,SAAS,CAAC,EAAE,OAAO,CAAC;IACpB,yCAAyC;IACzC,MAAM,CAAC,EAAE,WAAW,CAAC;CACtB;AAED,MAAM,MAAM,aAAa,GAAG,QAAQ,CAAC;IAAE,EAAE,EAAE,IAAI,CAAC;IAAC,OAAO,EAAE,MAAM,CAAA;CAAE,GAAG;IAAE,EAAE,EAAE,KAAK,CAAC;IAAC,KAAK,EAAE,MAAM,CAAA;CAAE,CAAC,CAAC;AAgDnG,eAAO,MAAM,YAAY,GAAI,OAAO,OAAO,EAAE,UAAU,MAAM,EAAE,KAAK,MAAM,EAAE,KAAK,MAAM,KAAG,MAIzF,CAAC;AAsCF;;;GAGG;AACH,wBAAsB,cAAc,CAClC,OAAO,EAAE,kBAAkB,EAC3B,IAAI,EAAE,MAAM,EACZ,MAAM,EAAE,MAAM,GACb,OAAO,CAAC,aAAa,CAAC,CAsExB;AAED;;;;GAIG;AACH,wBAAgB,qBAAqB,CAAC,OAAO,EAAE,MAAM,GAAG,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,IAAI,CAuBrF"}

package/dist/workers.js

@@ -0,0 +1,216 @@
+// Swarm DAO — Improvement Orchestrator herdr worker executor.
+// Runs one Improvement Loop AI worker (sensor, counter-sensor, drift-auditor)
+// as a real coding agent inside a herdr workspace, mirroring the battle-tested
+// lifecycle of packages/herdr-adapter:
+//   herdr workspace create --cwd <repo> --label <name> --no-focus
+//   herdr agent start <name> --kind <kind> --pane <id> --timeout <ms> -- <args>
+//   herdr agent prompt <name> '<prompt>' --wait --timeout <ms>
+//   herdr agent read <name> --source recent-unwrapped --lines N
+//   herdr workspace close <id>
+//
+// Boundary: a blocked, timed-out, or unparseable worker is an ERROR, never a
+// signal (models/improvement-orchestrator.md). Executor retries are
+// effect-level, bounded, and idempotent (fresh workspace per attempt); they
+// never change series or cycle state.
+import { exec as execCallback } from "node:child_process";
+import { promisify } from "node:util";
+import { ORCHESTRATOR_MAX_WORKER_RETRIES } from "@guyghost/swarm-dao-core/models/improvement";
+import { sanitizeHerdrName } from "@guyghost/swarm-dao-herdr-adapter";
+const execAsync = promisify(execCallback);
+const defaultRunner = () => ({
+    exec: async (command, options) => {
+        try {
+            const { stdout, stderr } = await execAsync(command, { cwd: options?.cwd, timeout: options?.timeout });
+            return { stdout, stderr, exitCode: 0 };
+        }
+        catch (error) {
+            const failure = error;
+            return {
+                stdout: failure.stdout ?? "",
+                stderr: failure.stderr ?? failure.message ?? "command failed",
+                exitCode: Number.isInteger(failure.code) ? failure.code : 1,
+            };
+        }
+    },
+});
+const SAFE_KIND = /^[a-z][a-z0-9_-]{0,31}$/;
+/**
+ * Escape raw control characters that are illegal inside JSON string literals.
+ * Terminal hard-wraps inject literal newlines mid-string (observed on real
+ * herdr `agent read --source recent-unwrapped` harvests); whitespace between
+ * JSON tokens is preserved — only in-string characters are rewritten.
+ */
+const escapeInStringControls = (candidate) => {
+    let repaired = "";
+    let inString = false;
+    let escaped = false;
+    for (const char of candidate) {
+        if (inString && !escaped) {
+            if (char === "\\") {
+                escaped = true;
+            }
+            else if (char === '"') {
+                inString = false;
+            }
+            else if (char === "\n") {
+                repaired += "\\n";
+                continue;
+            }
+            else if (char === "\r") {
+                repaired += "\\r";
+                continue;
+            }
+            else if (char === "\t") {
+                repaired += "\\t";
+                continue;
+            }
+        }
+        else if (inString && escaped) {
+            if (char === "\n" || char === "\r" || char === "\t") {
+                // Hard-wrap injected between the backslash and its escaped character:
+                // drop the artifact and keep consuming the escape (Copilot review on #79).
+                continue;
+            }
+            escaped = false;
+        }
+        else if (char === '"') {
+            inString = true;
+        }
+        repaired += char;
+    }
+    return repaired;
+};
+// Numeric options are interpolated into herdr shell commands, so they must be
+// finite integers within bounds even when callers bypass the TypeScript types
+// (e.g. JSON config); anything else falls back to the default.
+export const toBoundedInt = (value, fallback, min, max) => {
+    const parsed = typeof value === "number" ? value : Number(value);
+    if (!Number.isFinite(parsed))
+        return fallback;
+    return Math.min(Math.max(Math.trunc(parsed), min), max);
+};
+const quote = (value) => `'${value.replace(/'/g, `'\\''`)}'`;
+function herdrErrorDetail(stderr, stdout) {
+    try {
+        const parsed = JSON.parse(stderr.trim() || stdout.trim());
+        if (typeof parsed === "object" && parsed !== null && "error" in parsed) {
+            const { code, message } = parsed.error;
+            return [code, message].filter((part) => part && part.length > 0).join(": ");
+        }
+    }
+    catch {
+        // fall through to raw output
+    }
+    return (stderr.trim() || stdout.trim() || "unknown herdr error").slice(0, 300);
+}
+function parseHerdrJson(raw) {
+    try {
+        const parsed = JSON.parse(raw);
+        return typeof parsed === "object" && parsed !== null ? parsed : null;
+    }
+    catch {
+        return null;
+    }
+}
+function agentState(result) {
+    return result?.agent?.status ?? result?.agent?.state ?? null;
+}
+/**
+ * Run one worker prompt inside a herdr workspace, with bounded effect-level
+ * retries (fresh workspace and unique agent name per attempt).
+ */
+export async function runHerdrWorker(options, name, prompt) {
+    const runner = options.runner ?? defaultRunner();
+    const kind = options.kind ?? "pi";
+    const agentArgs = options.agentArgs ?? ["-ne"];
+    // herdr's own timeout ceiling is 300000ms; readLines is capped to keep the
+    // read command (and the harvested transcript) bounded.
+    const timeoutMs = toBoundedInt(options.timeoutMs, 300_000, 1_000, 300_000);
+    const startTimeoutMs = toBoundedInt(options.startTimeoutMs, 120_000, 1_000, 300_000);
+    const readLines = toBoundedInt(options.readLines, 200, 1, 10_000);
+    const extraArgs = agentArgs.map((arg) => quote(arg)).join(" ");
+    if (!SAFE_KIND.test(kind))
+        return { ok: false, error: `herdr kind '${kind}' is not a valid agent kind identifier.` };
+    const baseName = sanitizeHerdrName(name);
+    const maxAttempts = ORCHESTRATOR_MAX_WORKER_RETRIES + 1;
+    let lastError = "unknown worker error";
+    for (let attempt = 1; attempt <= maxAttempts; attempt++) {
+        const agentName = attempt === 1 ? baseName : `${baseName}-r${attempt}`.slice(0, 32);
+        let workspaceId = null;
+        try {
+            const created = await runner.exec(`herdr workspace create --cwd ${quote(options.workDir)} --label ${quote(agentName)} --no-focus`);
+            if (created.exitCode !== 0) {
+                lastError = `herdr workspace create failed: ${herdrErrorDetail(created.stderr, created.stdout)}`;
+                continue;
+            }
+            const paneId = parseHerdrJson(created.stdout)?.result?.root_pane?.pane_id ?? null;
+            workspaceId = parseHerdrJson(created.stdout)?.result?.workspace?.workspace_id ?? null;
+            if (!paneId || !workspaceId) {
+                lastError = `herdr workspace create returned no pane/workspace id: ${created.stdout.slice(0, 200)}`;
+                continue;
+            }
+            const started = await runner.exec(`herdr agent start ${agentName} --kind ${kind} --pane ${paneId} --timeout ${startTimeoutMs}${extraArgs ? ` -- ${extraArgs}` : ""}`);
+            if (started.exitCode !== 0) {
+                lastError = `herdr agent start (${kind}) failed: ${herdrErrorDetail(started.stderr, started.stdout)}`;
+                continue;
+            }
+            const prompted = await runner.exec(`herdr agent prompt ${agentName} ${quote(prompt)} --wait --timeout ${timeoutMs}`);
+            if (prompted.exitCode !== 0) {
+                lastError = `herdr agent prompt failed (likely timeout): ${herdrErrorDetail(prompted.stderr, prompted.stdout)}`;
+                continue;
+            }
+            if (agentState(parseHerdrJson(prompted.stdout)?.result) === "blocked") {
+                lastError = `herdr agent ${agentName} is blocked (approval/question UI) — it never produced a signal.`;
+                continue;
+            }
+            const read = await runner.exec(`herdr agent read ${agentName} --source recent-unwrapped --lines ${readLines}`);
+            if (read.exitCode !== 0) {
+                lastError = `herdr agent read failed: ${herdrErrorDetail(read.stderr, read.stdout)}`;
+                continue;
+            }
+            return { ok: true, content: read.stdout.replace(/\n+$/, "\n") };
+        }
+        catch (error) {
+            lastError = error instanceof Error ? error.message : String(error);
+        }
+        finally {
+            if (!options.keepPanes && workspaceId) {
+                await runner.exec(`herdr workspace close ${workspaceId}`).catch(() => undefined);
+            }
+        }
+    }
+    return { ok: false, error: `worker ${baseName} failed after ${maxAttempts} attempts: ${lastError}` };
+}
+/**
+ * Extract the worker's JSON answer from a harvested transcript. Agents echo
+ * the prompt (which itself contains JSON templates), so only the LAST JSON
+ * object in the transcript is the answer; earlier ones are ignored.
+ */
+export function extractLastJsonObject(content) {
+    const lastClose = content.lastIndexOf("}");
+    if (lastClose === -1)
+        return null;
+    let open = content.lastIndexOf("{", lastClose);
+    for (let scans = 0; open !== -1 && scans < 50; scans++, open = content.lastIndexOf("{", open - 1)) {
+        const raw = content.slice(open, lastClose + 1);
+        try {
+            const parsed = JSON.parse(raw);
+            if (typeof parsed === "object" && parsed !== null && !Array.isArray(parsed)) {
+                return parsed;
+            }
+        }
+        catch {
+            try {
+                const repaired = JSON.parse(escapeInStringControls(raw));
+                if (typeof repaired === "object" && repaired !== null && !Array.isArray(repaired)) {
+                    return repaired;
+                }
+            }
+            catch {
+                // walk back to the previous opening brace
+            }
+        }
+    }
+    return null;
+}
+//# sourceMappingURL=workers.js.map

package/dist/workers.js.map

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

package/package.json

@@ -0,0 +1,57 @@
+{
+  "name": "@guyghost/swarm-dao-improvement",
+  "version": "0.2.1",
+  "description": "Swarm DAO improvement loop executor — continuous improvement series over journal-replayed cycles, with herdr workers and bounded sandbox execution (Docker / Apple container)",
+  "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.0",
+    "@guyghost/swarm-dao-herdr-adapter": "^0.2.4"
+  },
+  "devDependencies": {
+    "@types/bun": "1.3.14",
+    "@types/node": "^26.0.1"
+  },
+  "keywords": [
+    "swarm-dao",
+    "improvement-loop",
+    "continuous-improvement",
+    "dao",
+    "sandbox",
+    "docker",
+    "apple-container"
+  ],
+  "author": "guyghost",
+  "license": "MIT",
+  "repository": {
+    "type": "git",
+    "url": "git+https://github.com/guyghost/swarm-dao.git",
+    "directory": "packages/improvement-loop"
+  },
+  "bugs": {
+    "url": "https://github.com/guyghost/swarm-dao/issues"
+  },
+  "homepage": "https://github.com/guyghost/swarm-dao#readme",
+  "publishConfig": {
+    "access": "public"
+  }
+}