@guyghost/swarm-dao-codex-adapter 0.2.0

package/AGENTS.md

@@ -0,0 +1,89 @@
+# AGENTS.md — Swarm DAO governance
+
+This repository is governed by **Swarm DAO**, a multi-agent governance layer.
+Proposals are deliberated by a swarm of agents, validated by quality-control
+gates, then executed and tracked.
+
+## Workflow (always follow this order)
+
+1. `dao_setup` — create the default 7 product agents (once per repo).
+2. `dao_propose` — open a proposal (`title`, `type`, `description`).
+3. `dao_deliberate proposalId=N` — returns a dispatch plan naming the agents and
+   the model each should use.
+4. Spawn one sub-agent per dispatch-plan entry (Codex subagents / `codex exec`).
+5. `dao_record_outputs proposalId=N outputs=[...]` — feed each sub-agent's
+   `agentId` + `content` back into the DAO.
+6. `dao_control proposalId=N` — run the quality gates.
+7. `dao_execute proposalId=N` — apply the approved change.
+8. `dao_ship proposalId=N` — cascade and finalize dependencies.
+
+## Rules
+
+- Treat `dao_*` tool results as the source of truth for DAO state.
+- Never hand-edit files under `.swarm-dao/` — always use the DAO tools.
+- If a gate fails in `dao_control`, fix the root cause; do not force-skip.
+- Run `dao_dry_run` before `dao_execute` for risky changes.
+- Use `dao_rollback` to revert a misbehaving executed proposal.
+- Rate outcomes with `dao_rate` to keep the governance health score accurate.
+
+## Complete command reference
+
+The canonical list of DAO commands lives in the core command registry and is
+mirrored here. Every command maps to one MCP tool. When the user types
+`/dao <command>`, invoke the matching `dao_*` tool.
+
+> The registry is the single source of truth. If this list drifts from
+> `packages/core/src/commands/registry.ts`, the registry wins.
+
+### Setup
+
+- `/dao setup` → `dao_setup` — Initialize the DAO with the default 7 product agents
+
+### Propose
+
+- `/dao propose` → `dao_propose` — Create a new proposal
+- `/dao update-proposal` → `dao_update_proposal` — Update structured fields on an open proposal
+
+### Deliberate
+
+- `/dao deliberate` → `dao_deliberate` — Run swarm deliberation / build the dispatch plan
+- `/dao record-outputs` → `dao_record_outputs` — Record sub-agent outputs and finalize deliberation
+
+### Control
+
+- `/dao control` → `dao_control` — Run the quality-control gates
+
+### Execute
+
+- `/dao execute` → `dao_execute` — Execute an approved / controlled proposal
+
+### Ship
+
+- `/dao ship` → `dao_ship` — Ship a controlled proposal (optionally cascade dependencies)
+
+### Retro
+
+- `/dao rollback` → `dao_rollback` — Revert an executed proposal to its pre-execution snapshot
+- `/dao rate` → `dao_rate` — Rate a proposal outcome (1–5 stars)
+
+### Discover
+
+- `/dao help` → `dao_help` — Show the DAO workflow and every available command
+- `/dao status` → `dao_dashboard` — Show the governance health dashboard
+- `/dao list` → `dao_list` — List all proposals
+- `/dao agents` → `dao_agents` — List the configured DAO agents
+- `/dao plan` → `dao_plan` — Show the delivery plan for a proposal
+- `/dao artefacts` → `dao_artefacts` — View the auto-generated artefacts for a proposal
+- `/dao audit` → `dao_audit` — View the audit trail
+- `/dao dry-run` → `dao_dry_run` — Preview execution without applying changes
+- `/dao roundtable` → `dao_roundtable` — Ask every agent to suggest a proposal idea
+
+### Governance
+
+- `/dao propose-amendment` → `dao_propose_amendment` — Propose an amendment (agents, config, quorum, gates)
+
+### GitHub
+
+- `/dao github-config` → `dao_config_github` — Configure the GitHub integration
+- `/dao github-branch` → `dao_github_create_branch` — Create a GitHub branch for a proposal
+- `/dao github-pr` → `dao_github_open_pr` — Open a GitHub pull request for a proposal

package/README.md

@@ -0,0 +1,56 @@
+# @guyghost/swarm-dao-codex-adapter
+
+Swarm DAO governance adapter for **OpenAI Codex** (Codex CLI).
+
+It bundles:
+
+- the Swarm DAO MCP server (`swarm-dao-codex` bin)
+- a native `config.toml` snippet for `[mcp_servers]`
+- an `AGENTS.md` instructions file
+- a `HostAdapter` implementation for programmatic use
+
+## Install
+
+```bash
+npm install @guyghost/swarm-dao-codex-adapter
+```
+
+## Configure
+
+### MCP server
+
+Append the block from `config/mcp-config.toml` to your Codex config
+(`~/.codex/config.toml` or the project-local config):
+
+```toml
+[mcp_servers.swarm_dao]
+command = "npx"
+args = ["-y", "@guyghost/swarm-dao-codex-adapter"]
+env = { DAO_ROOT = "." }
+```
+
+The `dao_*` tools then become available to Codex as the `swarm_dao` MCP server.
+
+### Instructions
+
+Append the contents of `AGENTS.md` to your repo's `AGENTS.md` so Codex follows
+the DAO workflow.
+
+## Run the server directly
+
+```bash
+swarm-dao-codex   # uses $DAO_ROOT or cwd
+```
+
+## Programmatic API
+
+```ts
+import { createCodexHostAdapter, startCodexServer } from "@guyghost/swarm-dao-codex-adapter";
+
+const adapter = createCodexHostAdapter("/path/to/repo");
+await startCodexServer();
+```
+
+## License
+
+MIT

package/config/mcp-config.toml

@@ -0,0 +1,9 @@
+# Swarm DAO — Codex MCP server config
+#
+# Add this block to your Codex CLI config (~/.codex/config.toml or the
+# project-local codex config) to register the Swarm DAO MCP server.
+
+[mcp_servers.swarm_dao]
+command = "npx"
+args = ["-y", "@guyghost/swarm-dao-codex-adapter"]
+env = { DAO_ROOT = "." }

package/dist/cli.d.ts

@@ -0,0 +1,3 @@
+#!/usr/bin/env node
+export {};
+//# 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":""}

package/dist/cli.js

@@ -0,0 +1,7 @@
+#!/usr/bin/env node
+import { startCodexServer } from "./index.js";
+startCodexServer().catch((error) => {
+    console.error("[swarm-dao-codex] fatal:", error);
+    process.exit(1);
+});
+//# sourceMappingURL=cli.js.map

package/dist/cli.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"cli.js","sourceRoot":"","sources":["../src/cli.ts"],"names":[],"mappings":";AACA,OAAO,EAAE,gBAAgB,EAAE,MAAM,YAAY,CAAC;AAE9C,gBAAgB,EAAE,CAAC,KAAK,CAAC,CAAC,KAAK,EAAE,EAAE;IACjC,OAAO,CAAC,KAAK,CAAC,0BAA0B,EAAE,KAAK,CAAC,CAAC;IACjD,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC;AAClB,CAAC,CAAC,CAAC"}

package/dist/index.d.ts

@@ -0,0 +1,8 @@
+import type { HostAdapter } from "@guyghost/swarm-dao-core";
+import { resolveDaoRoot } from "@guyghost/swarm-dao-mcp";
+export { resolveDaoRoot };
+/** Host adapter specialized for OpenAI Codex (`hostId = "codex"`). */
+export declare function createCodexHostAdapter(workDir?: string): HostAdapter;
+/** Boot the Swarm DAO MCP server with Codex defaults. */
+export declare function startCodexServer(workDir?: string): Promise<void>;
+//# 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":"AAAA,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,0BAA0B,CAAC;AAC5D,OAAO,EAA0B,cAAc,EAA0B,MAAM,yBAAyB,CAAC;AAEzG,OAAO,EAAE,cAAc,EAAE,CAAC;AAE1B,sEAAsE;AACtE,wBAAgB,sBAAsB,CAAC,OAAO,SAAmB,GAAG,WAAW,CAE9E;AAED,yDAAyD;AACzD,wBAAsB,gBAAgB,CAAC,OAAO,SAAmB,GAAG,OAAO,CAAC,IAAI,CAAC,CAEhF"}

package/dist/index.js

@@ -0,0 +1,11 @@
+import { createStdioHostAdapter, resolveDaoRoot, startSwarmDaoMcpServer } from "@guyghost/swarm-dao-mcp";
+export { resolveDaoRoot };
+/** Host adapter specialized for OpenAI Codex (`hostId = "codex"`). */
+export function createCodexHostAdapter(workDir = resolveDaoRoot()) {
+    return createStdioHostAdapter("codex", workDir);
+}
+/** Boot the Swarm DAO MCP server with Codex defaults. */
+export async function startCodexServer(workDir = resolveDaoRoot()) {
+    await startSwarmDaoMcpServer(workDir);
+}
+//# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,sBAAsB,EAAE,cAAc,EAAE,sBAAsB,EAAE,MAAM,yBAAyB,CAAC;AAEzG,OAAO,EAAE,cAAc,EAAE,CAAC;AAE1B,sEAAsE;AACtE,MAAM,UAAU,sBAAsB,CAAC,OAAO,GAAG,cAAc,EAAE;IAC/D,OAAO,sBAAsB,CAAC,OAAO,EAAE,OAAO,CAAC,CAAC;AAClD,CAAC;AAED,yDAAyD;AACzD,MAAM,CAAC,KAAK,UAAU,gBAAgB,CAAC,OAAO,GAAG,cAAc,EAAE;IAC/D,MAAM,sBAAsB,CAAC,OAAO,CAAC,CAAC;AACxC,CAAC"}

package/package.json

@@ -0,0 +1,64 @@
+{
+  "name": "@guyghost/swarm-dao-codex-adapter",
+  "version": "0.2.0",
+  "description": "Swarm DAO governance adapter for OpenAI Codex — MCP server, native config.toml, and AGENTS.md",
+  "type": "module",
+  "main": "./dist/index.js",
+  "types": "./dist/index.d.ts",
+  "sideEffects": false,
+  "bin": {
+    "swarm-dao-codex": "./dist/cli.js"
+  },
+  "files": [
+    "dist",
+    "README.md",
+    "config/mcp-config.toml",
+    "AGENTS.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.3.0",
+    "@guyghost/swarm-dao-mcp": "^0.2.0"
+  },
+  "devDependencies": {
+    "@types/bun": "latest"
+  },
+  "keywords": [
+    "swarm-dao",
+    "codex",
+    "openai",
+    "codex-cli",
+    "mcp",
+    "dao",
+    "governance",
+    "multi-agent",
+    "deliberation",
+    "quality-gates"
+  ],
+  "author": "guyghost",
+  "license": "MIT",
+  "repository": {
+    "type": "git",
+    "url": "git+https://github.com/guyghost/swarm-dao.git",
+    "directory": "packages/codex-adapter"
+  },
+  "bugs": {
+    "url": "https://github.com/guyghost/swarm-dao/issues"
+  },
+  "homepage": "https://github.com/guyghost/swarm-dao#readme",
+  "publishConfig": {
+    "access": "public"
+  }
+}