@guyghost/swarm-dao-copilot-adapter 0.2.0

package/.vscode/mcp.json

@@ -0,0 +1,12 @@
+{
+  "servers": {
+    "swarm-dao": {
+      "type": "stdio",
+      "command": "npx",
+      "args": ["-y", "@guyghost/swarm-dao-copilot-adapter"],
+      "env": {
+        "DAO_ROOT": "${workspaceFolder}"
+      }
+    }
+  }
+}

package/README.md

@@ -0,0 +1,55 @@
+# @guyghost/swarm-dao-copilot-adapter
+
+Swarm DAO governance adapter for **GitHub Copilot** (VS Code Copilot Chat,
+Copilot CLI, and the Copilot coding agent).
+
+It bundles:
+
+- the Swarm DAO MCP server (`swarm-dao-copilot` bin)
+- a native `.vscode/mcp.json` template
+- Copilot custom instructions (`copilot-instructions.md`)
+- a `HostAdapter` implementation for programmatic use
+
+## Install
+
+```bash
+npm install @guyghost/swarm-dao-copilot-adapter
+```
+
+## Configure
+
+### VS Code Copilot Chat
+
+Copy `.vscode/mcp.json` into your project (it registers the `swarm-dao` MCP
+server). Restart VS Code, then the `dao_*` tools appear under the `swarm-dao`
+MCP server in Copilot Chat.
+
+### Custom instructions
+
+Append the contents of `copilot-instructions.md` to your repo's
+`.github/copilot-instructions.md` so Copilot follows the DAO workflow.
+
+## Run the server directly
+
+```bash
+swarm-dao-copilot   # uses $DAO_ROOT or cwd
+```
+
+## Programmatic API
+
+```ts
+import { createCopilotHostAdapter, startCopilotServer } from "@guyghost/swarm-dao-copilot-adapter";
+
+const adapter = createCopilotHostAdapter("/path/to/repo");
+await startCopilotServer(); // boots the stdio MCP server
+```
+
+## Workflow
+
+See [`copilot-instructions.md`](./copilot-instructions.md) for the full
+DAO workflow (setup → propose → deliberate → dispatch → record → control →
+execute → ship).
+
+## License
+
+MIT

package/copilot-instructions.md

@@ -0,0 +1,92 @@
+# Swarm DAO — GitHub Copilot Instructions
+
+You are operating inside a **Swarm DAO**-governed repository. Swarm DAO is a
+multi-agent governance layer: proposals are deliberated by a swarm of agents,
+validated by quality-control gates, then executed and tracked.
+
+## The DAO workflow
+
+Always follow this order. Do not skip steps.
+
+1. **Setup** — `dao_setup` once per repo to create the default 7 product agents.
+2. **Propose** — `dao_propose` with a `title`, `type`, and `description`.
+3. **Deliberate** — `dao_deliberate proposalId=N` returns a dispatch plan that
+   names the agents to run and the model each should use.
+4. **Dispatch** — spawn one sub-agent per entry in the dispatch plan (Copilot
+   cannot spawn agents through MCP, so run them yourself as separate tasks).
+5. **Record** — `dao_record_outputs proposalId=N outputs=[...]` with each
+   sub-agent's `agentId` + `content`.
+6. **Control** — `dao_control proposalId=N` runs the quality gates.
+7. **Execute** — `dao_execute proposalId=N` applies the approved change.
+8. **Ship** — `dao_ship proposalId=N` cascades and finalizes dependencies.
+
+## Operating rules
+
+- Treat every `dao_*` tool result as the source of truth for DAO state.
+- Never edit `.swarm-dao/` files directly — always go through the DAO tools.
+- If `dao_control` fails a gate, fix the root cause, do not force-skip.
+- Prefer `dao_dry_run` before `dao_execute` for risky changes.
+- Use `dao_rollback` if an executed proposal misbehaves.
+- Rate outcomes with `dao_rate` so the governance health score stays 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/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 { startCopilotServer } from "./index.js";
+startCopilotServer().catch((error) => {
+    console.error("[swarm-dao-copilot] 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,kBAAkB,EAAE,MAAM,YAAY,CAAC;AAEhD,kBAAkB,EAAE,CAAC,KAAK,CAAC,CAAC,KAAK,EAAE,EAAE;IACnC,OAAO,CAAC,KAAK,CAAC,4BAA4B,EAAE,KAAK,CAAC,CAAC;IACnD,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 GitHub Copilot (`hostId = "copilot"`). */
+export declare function createCopilotHostAdapter(workDir?: string): HostAdapter;
+/** Boot the Swarm DAO MCP server with Copilot defaults. */
+export declare function startCopilotServer(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,0EAA0E;AAC1E,wBAAgB,wBAAwB,CAAC,OAAO,SAAmB,GAAG,WAAW,CAEhF;AAED,2DAA2D;AAC3D,wBAAsB,kBAAkB,CAAC,OAAO,SAAmB,GAAG,OAAO,CAAC,IAAI,CAAC,CAElF"}

package/dist/index.js

@@ -0,0 +1,11 @@
+import { createStdioHostAdapter, resolveDaoRoot, startSwarmDaoMcpServer } from "@guyghost/swarm-dao-mcp";
+export { resolveDaoRoot };
+/** Host adapter specialized for GitHub Copilot (`hostId = "copilot"`). */
+export function createCopilotHostAdapter(workDir = resolveDaoRoot()) {
+    return createStdioHostAdapter("copilot", workDir);
+}
+/** Boot the Swarm DAO MCP server with Copilot defaults. */
+export async function startCopilotServer(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,0EAA0E;AAC1E,MAAM,UAAU,wBAAwB,CAAC,OAAO,GAAG,cAAc,EAAE;IACjE,OAAO,sBAAsB,CAAC,SAAS,EAAE,OAAO,CAAC,CAAC;AACpD,CAAC;AAED,2DAA2D;AAC3D,MAAM,CAAC,KAAK,UAAU,kBAAkB,CAAC,OAAO,GAAG,cAAc,EAAE;IACjE,MAAM,sBAAsB,CAAC,OAAO,CAAC,CAAC;AACxC,CAAC"}

package/package.json

@@ -0,0 +1,63 @@
+{
+  "name": "@guyghost/swarm-dao-copilot-adapter",
+  "version": "0.2.0",
+  "description": "Swarm DAO governance adapter for GitHub Copilot — MCP server, native config, and custom instructions",
+  "type": "module",
+  "main": "./dist/index.js",
+  "types": "./dist/index.d.ts",
+  "sideEffects": false,
+  "bin": {
+    "swarm-dao-copilot": "./dist/cli.js"
+  },
+  "files": [
+    "dist",
+    "README.md",
+    ".vscode/mcp.json",
+    "copilot-instructions.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",
+    "copilot",
+    "github-copilot",
+    "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/copilot-adapter"
+  },
+  "bugs": {
+    "url": "https://github.com/guyghost/swarm-dao/issues"
+  },
+  "homepage": "https://github.com/guyghost/swarm-dao#readme",
+  "publishConfig": {
+    "access": "public"
+  }
+}