@arcbridge/adapters 0.1.0

package/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 Achim Kuehn
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

package/README.md

@@ -0,0 +1,54 @@
+# @arcbridge/adapters
+
+Platform adapters for ArcBridge — generate AI agent configurations for Claude Code and GitHub Copilot.
+
+## Install
+
+```bash
+npm install @arcbridge/adapters
+```
+
+## What It Does
+
+Translates ArcBridge's canonical agent role definitions (`.arcbridge/agents/*.md`) into platform-specific configurations:
+
+- **Claude Code** — Generates `CLAUDE.md` project instructions and `.claude/agents/*.md` agent files
+- **GitHub Copilot** — Generates `.github/copilot-instructions.md` and `.github/agents/*.md` agent files
+
+## Usage
+
+```typescript
+import { getAdapter, ClaudeAdapter, CopilotAdapter } from "@arcbridge/adapters";
+
+// By name
+const adapter = getAdapter("claude"); // or "copilot"
+const files = adapter.generate(projectRoot, roles, projectName);
+// files: { path: string, content: string }[]
+
+// Or directly
+const claude = new ClaudeAdapter();
+const copilot = new CopilotAdapter();
+```
+
+Each adapter implements the `PlatformAdapter` interface:
+
+```typescript
+interface PlatformAdapter {
+  generate(
+    projectRoot: string,
+    roles: AgentRole[],
+    projectName: string,
+  ): { path: string; content: string }[];
+}
+```
+
+## Supported Platforms
+
+| Platform | Output Files |
+|----------|-------------|
+| Claude Code | `CLAUDE.md`, `.claude/agents/*.md` |
+| GitHub Copilot | `.github/copilot-instructions.md`, `.github/agents/*.md` |
+
+## License
+
+[MIT](../../LICENSE)

package/dist/index.d.ts

@@ -0,0 +1,23 @@
+import { ArcBridgeConfig, AgentRole } from '@arcbridge/core';
+
+interface PlatformAdapter {
+    platform: string;
+    generateProjectConfig(targetDir: string, config: ArcBridgeConfig): void;
+    generateAgentConfigs(targetDir: string, roles: AgentRole[]): void;
+}
+
+declare class ClaudeAdapter implements PlatformAdapter {
+    platform: string;
+    generateProjectConfig(targetDir: string, config: ArcBridgeConfig): void;
+    generateAgentConfigs(targetDir: string, roles: AgentRole[]): void;
+}
+
+declare class CopilotAdapter implements PlatformAdapter {
+    platform: string;
+    generateProjectConfig(targetDir: string, config: ArcBridgeConfig): void;
+    generateAgentConfigs(targetDir: string, roles: AgentRole[]): void;
+}
+
+declare function getAdapter(platform: string): PlatformAdapter;
+
+export { ClaudeAdapter, CopilotAdapter, type PlatformAdapter, getAdapter };

package/dist/index.js

@@ -0,0 +1,285 @@
+// src/claude/claude-adapter.ts
+import { mkdirSync, writeFileSync, existsSync, readFileSync } from "fs";
+import { join } from "path";
+function generateClaudeMd(config) {
+  const lines = [
+    `# ${config.project_name}`,
+    "",
+    `> Auto-generated by ArcBridge. Edit .arcbridge/ files to update.`,
+    "",
+    "## Project Overview",
+    "",
+    `- **Type:** ${config.project_type}`,
+    `- **Quality Priorities:** ${config.quality_priorities.join(", ")}`,
+    "",
+    "## How to Work in This Project",
+    "",
+    "This project follows the **Plan \u2192 Build \u2192 Sync \u2192 Review** convention using ArcBridge.",
+    "ArcBridge provides MCP tools that give you architectural awareness. **Use them throughout your work.**",
+    "",
+    "### Before Starting Any Work",
+    "",
+    "1. Check project status: `arcbridge_get_project_status`",
+    "2. Review current tasks: `arcbridge_get_current_tasks`",
+    "3. Activate the appropriate role (see below): `arcbridge_activate_role`",
+    "",
+    "### When Planning or Refining Architecture",
+    "",
+    'Activate the **architect** role: `arcbridge_activate_role({ role: "architect" })`',
+    "",
+    "Then use:",
+    "- `arcbridge_get_building_blocks` \u2014 view current architecture decomposition",
+    "- `arcbridge_get_quality_scenarios` \u2014 view quality requirements",
+    "- `arcbridge_get_open_questions` \u2014 find architectural gaps to resolve",
+    "- `arcbridge_propose_arc42_update` \u2014 propose doc updates from recent code changes",
+    "",
+    "### When Implementing Features",
+    "",
+    'Activate the **implementer** role: `arcbridge_activate_role({ role: "implementer" })`',
+    "",
+    "Then use:",
+    "- `arcbridge_get_guidance` \u2014 get context-aware guidance for the file/block you're working on",
+    "- `arcbridge_get_current_tasks` \u2014 check what tasks are expected in the current phase",
+    "- `arcbridge_search_symbols` / `arcbridge_get_symbol` \u2014 understand existing code",
+    "- `arcbridge_get_dependency_graph` \u2014 check module dependencies before adding new ones",
+    "- `arcbridge_update_task` \u2014 mark tasks as in-progress or done as you complete them",
+    "- `arcbridge_reindex` \u2014 re-index after significant code changes",
+    "",
+    "### After Implementing (Phase Boundary Review)",
+    "",
+    "Before completing a phase, consult the review roles. Not every role is needed every phase \u2014 use this guide:",
+    "",
+    "| Role | When to consult | How |",
+    "|------|----------------|-----|",
+    '| **code-reviewer** | Every phase | `arcbridge_activate_role({ role: "code-reviewer" })` then `arcbridge_get_practice_review` |',
+    '| **security-reviewer** | Phases with auth, uploads, API routes, user input | `arcbridge_activate_role({ role: "security-reviewer" })` then `arcbridge_run_role_check` |',
+    '| **quality-guardian** | Every 2nd phase, or when quality scenarios are linked | `arcbridge_activate_role({ role: "quality-guardian" })` then `arcbridge_get_practice_review` |',
+    '| **architect** | When drift is detected or architecture evolved significantly | `arcbridge_activate_role({ role: "architect" })` then `arcbridge_check_drift` |',
+    "",
+    "Then run the standard checks:",
+    "",
+    "1. **Drift check:** `arcbridge_check_drift` \u2014 catch undeclared dependencies and missing modules",
+    "2. **Verify scenarios:** `arcbridge_verify_scenarios` \u2014 run linked tests for quality scenarios",
+    "",
+    "### Completing a Phase",
+    "",
+    'Activate the **phase-manager** role: `arcbridge_activate_role({ role: "phase-manager" })`',
+    "",
+    "Then: `arcbridge_complete_phase` \u2014 validates three gates: all tasks done, no critical drift, must-have quality scenarios not failing.",
+    ""
+  ];
+  if (config.project_type === "nextjs-app-router" || config.project_type === "react-vite") {
+    lines.push(
+      "## React & Next.js Analysis",
+      "",
+      "- `arcbridge_get_component_graph` \u2014 view component hierarchy, props, state, and context usage",
+      "- `arcbridge_get_route_map` \u2014 view Next.js route tree (pages, layouts, API routes)",
+      "- `arcbridge_get_boundary_analysis` \u2014 analyze server/client boundaries and detect violations",
+      ""
+    );
+  }
+  lines.push(
+    "## Agent Roles",
+    "",
+    "Activate roles with `arcbridge_activate_role` to get specialized context and tool guidance:",
+    "",
+    "| Role | When to Use |",
+    "|------|-------------|",
+    "| `architect` | Defining building blocks, reviewing dependencies, creating ADRs |",
+    "| `implementer` | Writing code within the established architecture |",
+    "| `security-reviewer` | Auditing auth, input validation, client/server boundaries |",
+    "| `quality-guardian` | Reviewing test coverage, quality scenarios, quality gates |",
+    "| `phase-manager` | Completing phases, managing task transitions |",
+    "| `code-reviewer` | Reviewing code for correctness, patterns, edge cases |",
+    "| `onboarding` | Understanding the project (for new developers) |",
+    "",
+    "Roles are defined in `.arcbridge/agents/` and `.claude/agents/`.",
+    ""
+  );
+  return lines.join("\n");
+}
+function generateAgentFile(role) {
+  const lines = [
+    `# ${role.name}`,
+    "",
+    role.description,
+    "",
+    "## Tools",
+    "",
+    ...role.required_tools.map((t) => `- ${t}`),
+    ""
+  ];
+  if (role.denied_tools.length > 0) {
+    lines.push("## Denied Tools", "", ...role.denied_tools.map((t) => `- ${t}`), "");
+  }
+  if (role.read_only) {
+    lines.push("## Access", "", "This role is **read-only**.", "");
+  }
+  if (role.quality_focus.length > 0) {
+    lines.push(
+      "## Quality Focus",
+      "",
+      ...role.quality_focus.map((q) => `- ${q}`),
+      ""
+    );
+  }
+  lines.push("## Instructions", "", role.system_prompt, "");
+  return lines.join("\n");
+}
+var ClaudeAdapter = class {
+  platform = "claude";
+  generateProjectConfig(targetDir, config) {
+    const content = generateClaudeMd(config);
+    writeFileSync(join(targetDir, "CLAUDE.md"), content, "utf-8");
+    const mcpJsonPath = join(targetDir, ".mcp.json");
+    if (!existsSync(mcpJsonPath)) {
+      const mcpConfig = {
+        mcpServers: {
+          arcbridge: {
+            command: "npx",
+            args: ["@arcbridge/mcp-server"]
+          }
+        }
+      };
+      writeFileSync(mcpJsonPath, JSON.stringify(mcpConfig, null, 2) + "\n", "utf-8");
+    } else {
+      try {
+        const existing = JSON.parse(readFileSync(mcpJsonPath, "utf-8"));
+        if (!existing.mcpServers?.arcbridge) {
+          existing.mcpServers = existing.mcpServers ?? {};
+          existing.mcpServers.arcbridge = {
+            command: "npx",
+            args: ["@arcbridge/mcp-server"]
+          };
+          writeFileSync(mcpJsonPath, JSON.stringify(existing, null, 2) + "\n", "utf-8");
+        }
+      } catch {
+      }
+    }
+  }
+  generateAgentConfigs(targetDir, roles) {
+    const agentsDir = join(targetDir, ".claude", "agents");
+    mkdirSync(agentsDir, { recursive: true });
+    for (const role of roles) {
+      const content = generateAgentFile(role);
+      writeFileSync(join(agentsDir, `${role.role_id}.md`), content, "utf-8");
+    }
+  }
+};
+
+// src/copilot/copilot-adapter.ts
+import { mkdirSync as mkdirSync2, writeFileSync as writeFileSync2 } from "fs";
+import { join as join2 } from "path";
+function generateCopilotInstructions(config) {
+  const lines = [
+    `# ${config.project_name} - Copilot Instructions`,
+    "",
+    `> Auto-generated by ArcBridge. Edit .arcbridge/ files to update.`,
+    "",
+    "## Project Context",
+    "",
+    `This is a ${config.project_type} project.`,
+    "",
+    `**Quality Priorities:** ${config.quality_priorities.join(", ")}`,
+    "",
+    "## Architecture",
+    "",
+    "Architecture documentation is in `.arcbridge/arc42/`.",
+    "Quality scenarios are in `.arcbridge/arc42/10-quality-scenarios.yaml`.",
+    "Phase plan is in `.arcbridge/plan/`.",
+    "",
+    "## Code Intelligence",
+    "",
+    "Use ArcBridge MCP tools to explore the codebase:",
+    "- `arcbridge_search_symbols` \u2014 Search for functions, classes, types",
+    "- `arcbridge_get_symbol` \u2014 Get full details on a symbol",
+    "- `arcbridge_get_dependency_graph` \u2014 Analyze module dependencies",
+    "- `arcbridge_reindex` \u2014 Re-index after code changes",
+    "",
+    "## React & Next.js Analysis",
+    "",
+    "- `arcbridge_get_component_graph` \u2014 View component hierarchy, props, state, and context",
+    "- `arcbridge_get_route_map` \u2014 View Next.js route tree (pages, layouts, API routes)",
+    "- `arcbridge_get_boundary_analysis` \u2014 Analyze server/client boundaries",
+    "",
+    "## Architecture Bridge",
+    "",
+    "- `arcbridge_check_drift` \u2014 Detect architecture drift and boundary violations",
+    "- `arcbridge_get_guidance` \u2014 Get context-aware guidance for code changes",
+    "- `arcbridge_get_open_questions` \u2014 Surface architectural gaps",
+    "- `arcbridge_propose_arc42_update` \u2014 Generate arc42 update proposals from code changes",
+    "- `arcbridge_get_practice_review` \u2014 Review recent changes across 5 practice dimensions",
+    "",
+    "## Conventions",
+    "",
+    "- Follow existing patterns in the codebase",
+    "- Stay within building block boundaries",
+    "- Write tests for new functionality",
+    "- Check quality scenarios before submitting changes",
+    ""
+  ];
+  return lines.join("\n");
+}
+function generateAgentFile2(role) {
+  const lines = [
+    `# ${role.name}`,
+    "",
+    role.description,
+    ""
+  ];
+  if (role.read_only) {
+    lines.push("**Access:** Read-only", "");
+  }
+  if (role.quality_focus.length > 0) {
+    lines.push(
+      "## Quality Focus",
+      "",
+      ...role.quality_focus.map((q) => `- ${q}`),
+      ""
+    );
+  }
+  lines.push("## Instructions", "", role.system_prompt, "");
+  return lines.join("\n");
+}
+var CopilotAdapter = class {
+  platform = "copilot";
+  generateProjectConfig(targetDir, config) {
+    const githubDir = join2(targetDir, ".github");
+    mkdirSync2(githubDir, { recursive: true });
+    const content = generateCopilotInstructions(config);
+    writeFileSync2(
+      join2(githubDir, "copilot-instructions.md"),
+      content,
+      "utf-8"
+    );
+  }
+  generateAgentConfigs(targetDir, roles) {
+    const agentsDir = join2(targetDir, ".github", "agents");
+    mkdirSync2(agentsDir, { recursive: true });
+    for (const role of roles) {
+      const content = generateAgentFile2(role);
+      writeFileSync2(join2(agentsDir, `${role.role_id}.md`), content, "utf-8");
+    }
+  }
+};
+
+// src/index.ts
+var adapters = {
+  claude: () => new ClaudeAdapter(),
+  copilot: () => new CopilotAdapter()
+};
+function getAdapter(platform) {
+  const factory = adapters[platform];
+  if (!factory) {
+    throw new Error(
+      `Unknown platform: ${platform}. Available: ${Object.keys(adapters).join(", ")}`
+    );
+  }
+  return factory();
+}
+export {
+  ClaudeAdapter,
+  CopilotAdapter,
+  getAdapter
+};
+//# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../src/claude/claude-adapter.ts","../src/copilot/copilot-adapter.ts","../src/index.ts"],"sourcesContent":["import { mkdirSync, writeFileSync, existsSync, readFileSync } from \"node:fs\";\nimport { join } from \"node:path\";\nimport type { AgentRole, ArcBridgeConfig } from \"@arcbridge/core\";\nimport type { PlatformAdapter } from \"../types.js\";\n\nfunction generateClaudeMd(config: ArcBridgeConfig): string {\n  const lines: string[] = [\n    `# ${config.project_name}`,\n    \"\",\n    `> Auto-generated by ArcBridge. Edit .arcbridge/ files to update.`,\n    \"\",\n    \"## Project Overview\",\n    \"\",\n    `- **Type:** ${config.project_type}`,\n    `- **Quality Priorities:** ${config.quality_priorities.join(\", \")}`,\n    \"\",\n    \"## How to Work in This Project\",\n    \"\",\n    \"This project follows the **Plan → Build → Sync → Review** convention using ArcBridge.\",\n    \"ArcBridge provides MCP tools that give you architectural awareness. **Use them throughout your work.**\",\n    \"\",\n    \"### Before Starting Any Work\",\n    \"\",\n    \"1. Check project status: `arcbridge_get_project_status`\",\n    \"2. Review current tasks: `arcbridge_get_current_tasks`\",\n    \"3. Activate the appropriate role (see below): `arcbridge_activate_role`\",\n    \"\",\n    \"### When Planning or Refining Architecture\",\n    \"\",\n    \"Activate the **architect** role: `arcbridge_activate_role({ role: \\\"architect\\\" })`\",\n    \"\",\n    \"Then use:\",\n    \"- `arcbridge_get_building_blocks` — view current architecture decomposition\",\n    \"- `arcbridge_get_quality_scenarios` — view quality requirements\",\n    \"- `arcbridge_get_open_questions` — find architectural gaps to resolve\",\n    \"- `arcbridge_propose_arc42_update` — propose doc updates from recent code changes\",\n    \"\",\n    \"### When Implementing Features\",\n    \"\",\n    \"Activate the **implementer** role: `arcbridge_activate_role({ role: \\\"implementer\\\" })`\",\n    \"\",\n    \"Then use:\",\n    \"- `arcbridge_get_guidance` — get context-aware guidance for the file/block you're working on\",\n    \"- `arcbridge_get_current_tasks` — check what tasks are expected in the current phase\",\n    \"- `arcbridge_search_symbols` / `arcbridge_get_symbol` — understand existing code\",\n    \"- `arcbridge_get_dependency_graph` — check module dependencies before adding new ones\",\n    \"- `arcbridge_update_task` — mark tasks as in-progress or done as you complete them\",\n    \"- `arcbridge_reindex` — re-index after significant code changes\",\n    \"\",\n    \"### After Implementing (Phase Boundary Review)\",\n    \"\",\n    \"Before completing a phase, consult the review roles. Not every role is needed every phase — use this guide:\",\n    \"\",\n    \"| Role | When to consult | How |\",\n    \"|------|----------------|-----|\",\n    \"| **code-reviewer** | Every phase | `arcbridge_activate_role({ role: \\\"code-reviewer\\\" })` then `arcbridge_get_practice_review` |\",\n    \"| **security-reviewer** | Phases with auth, uploads, API routes, user input | `arcbridge_activate_role({ role: \\\"security-reviewer\\\" })` then `arcbridge_run_role_check` |\",\n    \"| **quality-guardian** | Every 2nd phase, or when quality scenarios are linked | `arcbridge_activate_role({ role: \\\"quality-guardian\\\" })` then `arcbridge_get_practice_review` |\",\n    \"| **architect** | When drift is detected or architecture evolved significantly | `arcbridge_activate_role({ role: \\\"architect\\\" })` then `arcbridge_check_drift` |\",\n    \"\",\n    \"Then run the standard checks:\",\n    \"\",\n    \"1. **Drift check:** `arcbridge_check_drift` — catch undeclared dependencies and missing modules\",\n    \"2. **Verify scenarios:** `arcbridge_verify_scenarios` — run linked tests for quality scenarios\",\n    \"\",\n    \"### Completing a Phase\",\n    \"\",\n    \"Activate the **phase-manager** role: `arcbridge_activate_role({ role: \\\"phase-manager\\\" })`\",\n    \"\",\n    \"Then: `arcbridge_complete_phase` — validates three gates: all tasks done, no critical drift, must-have quality scenarios not failing.\",\n    \"\",\n  ];\n\n  // Add React/Next.js section only for relevant project types\n  if (config.project_type === \"nextjs-app-router\" || config.project_type === \"react-vite\") {\n    lines.push(\n      \"## React & Next.js Analysis\",\n      \"\",\n      \"- `arcbridge_get_component_graph` — view component hierarchy, props, state, and context usage\",\n      \"- `arcbridge_get_route_map` — view Next.js route tree (pages, layouts, API routes)\",\n      \"- `arcbridge_get_boundary_analysis` — analyze server/client boundaries and detect violations\",\n      \"\",\n    );\n  }\n\n  lines.push(\n    \"## Agent Roles\",\n    \"\",\n    \"Activate roles with `arcbridge_activate_role` to get specialized context and tool guidance:\",\n    \"\",\n    \"| Role | When to Use |\",\n    \"|------|-------------|\",\n    \"| `architect` | Defining building blocks, reviewing dependencies, creating ADRs |\",\n    \"| `implementer` | Writing code within the established architecture |\",\n    \"| `security-reviewer` | Auditing auth, input validation, client/server boundaries |\",\n    \"| `quality-guardian` | Reviewing test coverage, quality scenarios, quality gates |\",\n    \"| `phase-manager` | Completing phases, managing task transitions |\",\n    \"| `code-reviewer` | Reviewing code for correctness, patterns, edge cases |\",\n    \"| `onboarding` | Understanding the project (for new developers) |\",\n    \"\",\n    \"Roles are defined in `.arcbridge/agents/` and `.claude/agents/`.\",\n    \"\",\n  );\n\n  return lines.join(\"\\n\");\n}\n\nfunction generateAgentFile(role: AgentRole): string {\n  const lines: string[] = [\n    `# ${role.name}`,\n    \"\",\n    role.description,\n    \"\",\n    \"## Tools\",\n    \"\",\n    ...role.required_tools.map((t) => `- ${t}`),\n    \"\",\n  ];\n\n  if (role.denied_tools.length > 0) {\n    lines.push(\"## Denied Tools\", \"\", ...role.denied_tools.map((t) => `- ${t}`), \"\");\n  }\n\n  if (role.read_only) {\n    lines.push(\"## Access\", \"\", \"This role is **read-only**.\", \"\");\n  }\n\n  if (role.quality_focus.length > 0) {\n    lines.push(\n      \"## Quality Focus\",\n      \"\",\n      ...role.quality_focus.map((q) => `- ${q}`),\n      \"\",\n    );\n  }\n\n  lines.push(\"## Instructions\", \"\", role.system_prompt, \"\");\n\n  return lines.join(\"\\n\");\n}\n\nexport class ClaudeAdapter implements PlatformAdapter {\n  platform = \"claude\";\n\n  generateProjectConfig(targetDir: string, config: ArcBridgeConfig): void {\n    const content = generateClaudeMd(config);\n    writeFileSync(join(targetDir, \"CLAUDE.md\"), content, \"utf-8\");\n\n    // Generate .mcp.json if it doesn't already exist\n    const mcpJsonPath = join(targetDir, \".mcp.json\");\n    if (!existsSync(mcpJsonPath)) {\n      const mcpConfig = {\n        mcpServers: {\n          arcbridge: {\n            command: \"npx\",\n            args: [\"@arcbridge/mcp-server\"],\n          },\n        },\n      };\n      writeFileSync(mcpJsonPath, JSON.stringify(mcpConfig, null, 2) + \"\\n\", \"utf-8\");\n    } else {\n      // If .mcp.json exists, add arcbridge server if not already present\n      try {\n        const existing = JSON.parse(readFileSync(mcpJsonPath, \"utf-8\")) as {\n          mcpServers?: Record<string, unknown>;\n        };\n        if (!existing.mcpServers?.arcbridge) {\n          existing.mcpServers = existing.mcpServers ?? {};\n          existing.mcpServers.arcbridge = {\n            command: \"npx\",\n            args: [\"@arcbridge/mcp-server\"],\n          };\n          writeFileSync(mcpJsonPath, JSON.stringify(existing, null, 2) + \"\\n\", \"utf-8\");\n        }\n      } catch {\n        // If we can't parse existing .mcp.json, leave it alone\n      }\n    }\n  }\n\n  generateAgentConfigs(targetDir: string, roles: AgentRole[]): void {\n    const agentsDir = join(targetDir, \".claude\", \"agents\");\n    mkdirSync(agentsDir, { recursive: true });\n\n    for (const role of roles) {\n      const content = generateAgentFile(role);\n      writeFileSync(join(agentsDir, `${role.role_id}.md`), content, \"utf-8\");\n    }\n  }\n}\n","import { mkdirSync, writeFileSync } from \"node:fs\";\nimport { join } from \"node:path\";\nimport type { AgentRole, ArcBridgeConfig } from \"@arcbridge/core\";\nimport type { PlatformAdapter } from \"../types.js\";\n\nfunction generateCopilotInstructions(config: ArcBridgeConfig): string {\n  const lines: string[] = [\n    `# ${config.project_name} - Copilot Instructions`,\n    \"\",\n    `> Auto-generated by ArcBridge. Edit .arcbridge/ files to update.`,\n    \"\",\n    \"## Project Context\",\n    \"\",\n    `This is a ${config.project_type} project.`,\n    \"\",\n    `**Quality Priorities:** ${config.quality_priorities.join(\", \")}`,\n    \"\",\n    \"## Architecture\",\n    \"\",\n    \"Architecture documentation is in `.arcbridge/arc42/`.\",\n    \"Quality scenarios are in `.arcbridge/arc42/10-quality-scenarios.yaml`.\",\n    \"Phase plan is in `.arcbridge/plan/`.\",\n    \"\",\n    \"## Code Intelligence\",\n    \"\",\n    \"Use ArcBridge MCP tools to explore the codebase:\",\n    \"- `arcbridge_search_symbols` — Search for functions, classes, types\",\n    \"- `arcbridge_get_symbol` — Get full details on a symbol\",\n    \"- `arcbridge_get_dependency_graph` — Analyze module dependencies\",\n    \"- `arcbridge_reindex` — Re-index after code changes\",\n    \"\",\n    \"## React & Next.js Analysis\",\n    \"\",\n    \"- `arcbridge_get_component_graph` — View component hierarchy, props, state, and context\",\n    \"- `arcbridge_get_route_map` — View Next.js route tree (pages, layouts, API routes)\",\n    \"- `arcbridge_get_boundary_analysis` — Analyze server/client boundaries\",\n    \"\",\n    \"## Architecture Bridge\",\n    \"\",\n    \"- `arcbridge_check_drift` — Detect architecture drift and boundary violations\",\n    \"- `arcbridge_get_guidance` — Get context-aware guidance for code changes\",\n    \"- `arcbridge_get_open_questions` — Surface architectural gaps\",\n    \"- `arcbridge_propose_arc42_update` — Generate arc42 update proposals from code changes\",\n    \"- `arcbridge_get_practice_review` — Review recent changes across 5 practice dimensions\",\n    \"\",\n    \"## Conventions\",\n    \"\",\n    \"- Follow existing patterns in the codebase\",\n    \"- Stay within building block boundaries\",\n    \"- Write tests for new functionality\",\n    \"- Check quality scenarios before submitting changes\",\n    \"\",\n  ];\n\n  return lines.join(\"\\n\");\n}\n\nfunction generateAgentFile(role: AgentRole): string {\n  const lines: string[] = [\n    `# ${role.name}`,\n    \"\",\n    role.description,\n    \"\",\n  ];\n\n  if (role.read_only) {\n    lines.push(\"**Access:** Read-only\", \"\");\n  }\n\n  if (role.quality_focus.length > 0) {\n    lines.push(\n      \"## Quality Focus\",\n      \"\",\n      ...role.quality_focus.map((q) => `- ${q}`),\n      \"\",\n    );\n  }\n\n  lines.push(\"## Instructions\", \"\", role.system_prompt, \"\");\n\n  return lines.join(\"\\n\");\n}\n\nexport class CopilotAdapter implements PlatformAdapter {\n  platform = \"copilot\";\n\n  generateProjectConfig(targetDir: string, config: ArcBridgeConfig): void {\n    const githubDir = join(targetDir, \".github\");\n    mkdirSync(githubDir, { recursive: true });\n\n    const content = generateCopilotInstructions(config);\n    writeFileSync(\n      join(githubDir, \"copilot-instructions.md\"),\n      content,\n      \"utf-8\",\n    );\n  }\n\n  generateAgentConfigs(targetDir: string, roles: AgentRole[]): void {\n    const agentsDir = join(targetDir, \".github\", \"agents\");\n    mkdirSync(agentsDir, { recursive: true });\n\n    for (const role of roles) {\n      const content = generateAgentFile(role);\n      writeFileSync(join(agentsDir, `${role.role_id}.md`), content, \"utf-8\");\n    }\n  }\n}\n","export type { PlatformAdapter } from \"./types.js\";\nexport { ClaudeAdapter } from \"./claude/claude-adapter.js\";\nexport { CopilotAdapter } from \"./copilot/copilot-adapter.js\";\n\nimport type { PlatformAdapter } from \"./types.js\";\nimport { ClaudeAdapter } from \"./claude/claude-adapter.js\";\nimport { CopilotAdapter } from \"./copilot/copilot-adapter.js\";\n\nconst adapters: Record<string, () => PlatformAdapter> = {\n  claude: () => new ClaudeAdapter(),\n  copilot: () => new CopilotAdapter(),\n};\n\nexport function getAdapter(platform: string): PlatformAdapter {\n  const factory = adapters[platform];\n  if (!factory) {\n    throw new Error(\n      `Unknown platform: ${platform}. Available: ${Object.keys(adapters).join(\", \")}`,\n    );\n  }\n  return factory();\n}\n"],"mappings":"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","names":["mkdirSync","writeFileSync","join","generateAgentFile"]}

package/package.json

@@ -0,0 +1,41 @@
+{
+  "name": "@arcbridge/adapters",
+  "version": "0.1.0",
+  "description": "Platform adapters for ArcBridge — Claude Code and GitHub Copilot config generators",
+  "license": "MIT",
+  "type": "module",
+  "publishConfig": {
+    "access": "public"
+  },
+  "repository": {
+    "type": "git",
+    "url": "https://github.com/bifteki-crew/arcbridge.git",
+    "directory": "packages/adapters"
+  },
+  "keywords": [
+    "arcbridge",
+    "claude",
+    "copilot",
+    "ai-agents"
+  ],
+  "files": [
+    "dist",
+    "README.md",
+    "LICENSE"
+  ],
+  "main": "./dist/index.js",
+  "types": "./dist/index.d.ts",
+  "exports": {
+    ".": {
+      "import": "./dist/index.js",
+      "types": "./dist/index.d.ts"
+    }
+  },
+  "dependencies": {
+    "@arcbridge/core": "0.1.0"
+  },
+  "scripts": {
+    "build": "tsup",
+    "clean": "rm -rf dist"
+  }
+}