@lvlup-sw/exarchos-dev 2.0.0

package/.claude-plugin/plugin.json

@@ -0,0 +1,9 @@
+{
+  "name": "exarchos-dev-tools",
+  "description": "Developer convenience plugins for Exarchos — GitHub, Serena, Context7, Microsoft Learn",
+  "version": "2.0.0",
+  "author": { "name": "Levelup Software" },
+  "repository": "https://github.com/lvlup-sw/exarchos",
+  "keywords": ["exarchos", "dev-tools", "github", "serena", "context7"],
+  "mcpServers": "./.mcp.json"
+}

package/.mcp.json

@@ -0,0 +1,8 @@
+{
+  "mcpServers": {
+    "microsoft-learn": {
+      "type": "http",
+      "url": "https://learn.microsoft.com/api/mcp"
+    }
+  }
+}

package/README.md

@@ -0,0 +1,35 @@
+# @lvlup-sw/exarchos-dev
+
+Developer convenience plugins for [Exarchos](https://github.com/lvlup-sw/exarchos) — the agent governance system for Claude Code.
+
+## What It Does
+
+Adds optional developer tooling to your Exarchos installation:
+
+- **GitHub** plugin — PRs, issues, code search
+- **Serena** plugin — Semantic code analysis
+- **Context7** plugin — Up-to-date library documentation
+- **Microsoft Learn** MCP — Official Azure/.NET docs
+
+## Install
+
+```bash
+npx @lvlup-sw/exarchos-dev
+```
+
+Or with bun:
+
+```bash
+bunx @lvlup-sw/exarchos-dev
+```
+
+This enables the three Claude Code plugins in `~/.claude/settings.json` and registers the Microsoft Learn MCP server in `~/.claude.json`.
+
+## Prerequisites
+
+- [Exarchos](https://github.com/lvlup-sw/exarchos) installed (via marketplace or dev mode)
+- Node.js >= 20
+
+## License
+
+Apache-2.0 — see [LICENSE](../LICENSE) for details.

package/dist/install.d.ts

@@ -0,0 +1,6 @@
+#!/usr/bin/env node
+export declare function installCompanion(claudeHome?: string, claudeJsonPath?: string): {
+    pluginsEnabled: string[];
+    mcpServersAdded: string[];
+    contentOverlays: string[];
+};

package/dist/install.js

@@ -0,0 +1,127 @@
+#!/usr/bin/env node
+import { readFileSync, writeFileSync, mkdirSync, existsSync, realpathSync, symlinkSync, lstatSync } from 'node:fs';
+import { join, dirname } from 'node:path';
+import { homedir } from 'node:os';
+import { fileURLToPath } from 'node:url';
+const PLUGINS_TO_ENABLE = {
+    'github@claude-plugins-official': true,
+    'serena@claude-plugins-official': true,
+    'context7@claude-plugins-official': true,
+};
+const MCP_SERVERS_TO_ADD = {
+    'microsoft-learn': {
+        type: 'http',
+        url: 'https://learn.microsoft.com/api/mcp',
+    },
+};
+const CONTENT_OVERLAYS = [
+    { source: 'rules/mcp-tool-guidance.md', target: 'rules/mcp-tool-guidance.md' },
+    { source: 'skills/workflow-state/references/companion-mcp-reference.md', target: 'skills/workflow-state/references/companion-mcp-reference.md' },
+];
+export function installCompanion(claudeHome, claudeJsonPath) {
+    const home = claudeHome ?? join(homedir(), '.claude');
+    const configPath = claudeJsonPath ?? join(homedir(), '.claude.json');
+    const pluginsEnabled = installPlugins(home);
+    const mcpServersAdded = installMcpServers(configPath);
+    const contentOverlays = installContentOverlays(home);
+    return { pluginsEnabled, mcpServersAdded, contentOverlays };
+}
+function installContentOverlays(claudeHome) {
+    const companionRoot = join(dirname(fileURLToPath(import.meta.url)), '..');
+    const installed = [];
+    for (const overlay of CONTENT_OVERLAYS) {
+        const sourcePath = join(companionRoot, overlay.source);
+        const targetPath = join(claudeHome, overlay.target);
+        // Ensure target directory exists
+        mkdirSync(dirname(targetPath), { recursive: true });
+        // Skip if already symlinked to the same source
+        try {
+            const existing = lstatSync(targetPath);
+            if (existing.isSymbolicLink()) {
+                try {
+                    const resolvedLink = realpathSync(targetPath);
+                    const resolvedSource = realpathSync(sourcePath);
+                    if (resolvedLink === resolvedSource)
+                        continue;
+                }
+                catch {
+                    // Resolution failed — treat as different, warn below
+                }
+            }
+            // Different file exists — warn but don't overwrite
+            process.stderr.write(`Warning: ${overlay.target} already exists, skipping.\n`);
+            continue;
+        }
+        catch (err) {
+            if (!(err instanceof Error && 'code' in err && err.code === 'ENOENT')) {
+                throw err;
+            }
+        }
+        symlinkSync(sourcePath, targetPath);
+        installed.push(overlay.target);
+    }
+    return installed;
+}
+function parseJsonFile(filePath, label) {
+    try {
+        return JSON.parse(readFileSync(filePath, 'utf-8'));
+    }
+    catch {
+        process.stderr.write(`Warning: could not parse ${label} at ${filePath} — treating as fresh install.\n`);
+        return {};
+    }
+}
+function installPlugins(claudeHome) {
+    mkdirSync(claudeHome, { recursive: true });
+    const settingsPath = join(claudeHome, 'settings.json');
+    const settings = existsSync(settingsPath)
+        ? parseJsonFile(settingsPath, 'settings.json')
+        : {};
+    if (!settings.enabledPlugins) {
+        settings.enabledPlugins = {};
+    }
+    const enabled = [];
+    for (const [plugin, value] of Object.entries(PLUGINS_TO_ENABLE)) {
+        if (settings.enabledPlugins[plugin] !== value) {
+            settings.enabledPlugins[plugin] = value;
+            enabled.push(plugin);
+        }
+    }
+    writeFileSync(settingsPath, JSON.stringify(settings, null, 2) + '\n');
+    return enabled;
+}
+function installMcpServers(configPath) {
+    const config = existsSync(configPath)
+        ? parseJsonFile(configPath, '.claude.json')
+        : {};
+    if (!config.mcpServers) {
+        config.mcpServers = {};
+    }
+    const added = [];
+    for (const [name, entry] of Object.entries(MCP_SERVERS_TO_ADD)) {
+        if (!config.mcpServers[name]) {
+            config.mcpServers[name] = entry;
+            added.push(name);
+        }
+    }
+    writeFileSync(configPath, JSON.stringify(config, null, 2) + '\n');
+    return added;
+}
+// CLI entry point
+const isMainModule = (() => {
+    try {
+        const thisFile = fileURLToPath(import.meta.url);
+        const mainFile = realpathSync(process.argv[1]);
+        return thisFile === mainFile;
+    }
+    catch {
+        return false;
+    }
+})();
+if (isMainModule) {
+    const result = installCompanion();
+    console.log('Exarchos Dev Tools installed:');
+    result.pluginsEnabled.forEach(p => console.log(`  Plugin enabled: ${p}`));
+    result.mcpServersAdded.forEach(s => console.log(`  MCP server added: ${s}`));
+    result.contentOverlays.forEach(o => console.log(`  Content overlay: ${o}`));
+}

package/package.json

@@ -0,0 +1,25 @@
+{
+  "name": "@lvlup-sw/exarchos-dev",
+  "version": "2.0.0",
+  "description": "Developer convenience plugins for Exarchos — installs GitHub, Serena, Context7, and Microsoft Learn MCP",
+  "type": "module",
+  "bin": {
+    "exarchos-dev": "./dist/install.js"
+  },
+  "files": [
+    "dist",
+    ".claude-plugin",
+    ".mcp.json",
+    "settings.json"
+  ],
+  "scripts": {
+    "build": "tsc",
+    "test:run": "npx vitest run"
+  },
+  "keywords": ["exarchos", "dev-tools", "claude-code"],
+  "author": "lvlup-sw",
+  "license": "MIT",
+  "engines": {
+    "node": ">=20.0.0"
+  }
+}

package/settings.json

@@ -0,0 +1,7 @@
+{
+  "enabledPlugins": {
+    "github@claude-plugins-official": true,
+    "serena@claude-plugins-official": true,
+    "context7@claude-plugins-official": true
+  }
+}