ima-claude 2.10.0 → 2.14.0

package/dist/cli.js

@@ -11,7 +11,7 @@ var HOOKS_DIR = join(CLAUDE_DIR, "hooks");
 var COMMANDS_DIR = join(CLAUDE_DIR, "commands");
 var RULES_DIR = join(CLAUDE_DIR, "rules");
 var SETTINGS_FILE = join(CLAUDE_DIR, "settings.json");
-var VERSION = "2.10.0";
+var VERSION = "2.14.0";
 var colors = {
   reset: "\x1B[0m",
   bright: "\x1B[1m",
@@ -107,6 +107,9 @@ var SKILLS_TO_INSTALL = [
   "compound-bridge",
   // MCP integration skills
   "mcp-atlassian",
+  "mcp-gitea",
+  "mcp-github",
+  "gh-cli",
   "mcp-tavily",
   "mcp-context7",
   "mcp-serena",
@@ -684,15 +687,731 @@ var JunieAdapter = class {
   }
 };
 
+// platforms/gemini/adapter.ts
+import { join as join4, dirname as dirname2 } from "path";
+import { homedir as homedir3 } from "os";
+import { existsSync as existsSync4, readdirSync as readdirSync4, statSync as statSync4, readFileSync as readFileSync3, writeFileSync as writeFileSync3, copyFileSync as copyFileSync3 } from "fs";
+import { fileURLToPath } from "url";
+var __filename = fileURLToPath(import.meta.url);
+var __dirname2 = dirname2(__filename);
+var GEMINI_DIR = join4(homedir3(), ".gemini");
+var GEMINI_SKILLS_DIR = join4(GEMINI_DIR, "skills");
+var GEMINI_AGENTS_DIR = join4(GEMINI_DIR, "agents");
+var GEMINI_HOOKS_DIR = join4(GEMINI_DIR, "hooks");
+var GEMINI_SETTINGS_FILE = join4(GEMINI_DIR, "settings.json");
+var GEMINI_GUIDELINES_FILE = join4(GEMINI_DIR, "GEMINI.md");
+var TOOL_MAP = {
+  Bash: "run_shell_command",
+  Read: "read_file",
+  Edit: "replace",
+  Write: "write_file",
+  Glob: "glob",
+  Grep: "grep_search",
+  LS: "list_directory",
+  WebSearch: "google_web_search",
+  WebFetch: "web_fetch",
+  ExitPlanMode: "exit_plan_mode"
+};
+var EVENT_MAP = {
+  PreToolUse: "BeforeTool",
+  PostToolUse: "AfterTool",
+  UserPromptSubmit: "BeforeAgent",
+  SessionStart: "SessionStart"
+};
+function parseFrontmatter2(content) {
+  const match = content.match(/^---\n([\s\S]*?)\n---\n?([\s\S]*)$/);
+  if (!match) return { frontmatter: {}, body: content };
+  const frontmatter = {};
+  for (const line of match[1].split("\n")) {
+    const colonIdx = line.indexOf(":");
+    if (colonIdx === -1) continue;
+    const key = line.slice(0, colonIdx).trim();
+    const value = line.slice(colonIdx + 1).trim();
+    if (key) frontmatter[key] = value;
+  }
+  return { frontmatter, body: match[2] };
+}
+function serializeFrontmatter2(frontmatter, body) {
+  const lines = Object.entries(frontmatter).map(([k, v]) => `${k}: ${v}`);
+  return `---
+${lines.join("\n")}
+---
+${body}`;
+}
+function mapToolName(claudeName) {
+  return TOOL_MAP[claudeName] ?? claudeName;
+}
+function transformAgentForGemini(content) {
+  const { frontmatter, body } = parseFrontmatter2(content);
+  const { permissionMode: _perm, model: _model, ...kept } = frontmatter;
+  if (kept.tools) {
+    const mapped = kept.tools.split(",").map((t) => t.trim()).map(mapToolName).join(", ");
+    kept.tools = mapped;
+  }
+  return serializeFrontmatter2(kept, body);
+}
+function translateMatcher(matcher) {
+  return TOOL_MAP[matcher] ?? matcher;
+}
+function translateHookCommand(command2) {
+  const hooksDir = GEMINI_HOOKS_DIR;
+  const translatorPath = join4(hooksDir, "hooks-translator.py");
+  const match = command2.match(/python3\s+.*\/([^/\s]+\.py)(\s.*)?$/);
+  if (!match) return command2;
+  const scriptName = match[1];
+  const trailingArgs = match[2] ?? "";
+  return `python3 ${translatorPath} ${join4(hooksDir, scriptName)}${trailingArgs}`;
+}
+function generateGeminiHooksConfig() {
+  const geminiHooks = {};
+  for (const [claudeEvent, hookEntries] of Object.entries(HOOKS_CONFIG.hooks)) {
+    const geminiEvent = EVENT_MAP[claudeEvent] ?? claudeEvent;
+    geminiHooks[geminiEvent] = hookEntries.map(
+      (entry) => {
+        const translated = {};
+        if (entry.matcher) {
+          translated.matcher = translateMatcher(entry.matcher);
+        }
+        translated.hooks = entry.hooks.map((h) => ({
+          type: h.type,
+          command: translateHookCommand(h.command)
+        }));
+        return translated;
+      }
+    );
+  }
+  return { hooks: geminiHooks };
+}
+function generateGeminiMd() {
+  return `# ima-claude: AI Coding Agent Guidelines
+
+> Generated by ima-claude v${VERSION} for Gemini CLI.
+> Source: https://github.com/Soabirw/ima-claude
+
+## Default Persona: The Practitioner
+
+A 25-year software development veteran. FP-first, composition-minded, anti-over-engineering.
+Uses "we" not "I" \u2014 collaborative, humble, light-hearted. "Slow is smooth, smooth is fast."
+
+**Philosophy**: Simple > Complex | Evidence > Assumptions | Native > Utilities | MVP > Enterprise
+
+---
+
+## Memory Routing
+
+| Store what | Where | Why |
+|---|---|---|
+| Decisions, preferences, patterns, bugs | Vestige \`smart_ingest\` | Fades naturally if not referenced |
+| Reference material (docs, standards, PRDs) | Qdrant \`qdrant-store\` | Permanent library |
+| Session state, task progress | Serena \`write_memory\` | Project-scoped workbench |
+| Future reminders | Vestige \`intention\` | Surfaces at next session |
+
+At session start, check memory before asking questions:
+- Vestige: search for user preferences and project context
+- Vestige: check for pending reminders/intentions
+- Serena: list memories if in a Serena-activated project
+
+Auto-store: "I prefer..." \u2192 Vestige preference. "Let's go with X because..." \u2192 Vestige decision. "The reason this failed..." \u2192 Vestige bug.
+
+After completing work: store outcome in Vestige, reference material in Qdrant, session state in Serena.
+
+---
+
+## Orchestrator Protocol
+
+You are the Orchestrator. Plan and delegate. Do NOT implement directly.
+- Non-trivial work \u2192 task-planner (decompose) \u2192 task-runner (delegate)
+- Trivial = single file, < 5 lines, no judgment calls
+
+---
+
+## Available Agents
+
+Delegate to named agents \u2014 they enforce tools and permissions automatically.
+
+| Agent | Use For |
+|---|---|
+| \`explorer\` | File discovery, codebase exploration |
+| \`implementer\` | Feature dev, bug fixes, refactoring |
+| \`reviewer\` | Code review, security audit, FP checks |
+| \`wp-developer\` | WordPress plugins, themes, WP-CLI, forms |
+| \`memory\` | Memory search, storage, consolidation |
+
+---
+
+## Code Navigation (Serena)
+
+When Serena MCP is available, **prefer Serena over read_file/grep_search for code investigation.** 40-70% token savings.
+
+| Instead of | Use |
+|---|---|
+| Read file to understand structure | Serena get_symbols_overview |
+| grep_search for class/function definition | Serena find_symbol |
+| grep_search for callers/references | Serena find_referencing_symbols |
+
+Use read_file only when you need the actual implementation body of a known, specific symbol.
+
+---
+
+## Complex Reasoning
+
+Use sequential thinking before acting on:
+- Debugging / root cause analysis / "why is this failing"
+- Trade-off evaluation / "which approach"
+- Architectural decisions / design choices
+- Multi-step investigations where approach may change
+
+---
+
+## MCP Tool Routing
+
+| Signal | Preferred Tool |
+|---|---|
+| "latest", "2025/2026", "what's new" | Tavily search |
+| Library/framework API question | Context7 |
+| URL content extraction | Tavily extract (use advanced for complex pages) |
+
+Before web tools: check internal knowledge \u2192 Context7 \u2192 then Tavily.
+Before external lookups: check Vestige memory first.
+
+---
+
+## Search Preference
+
+Always prefer \`rg\` (ripgrep) over grep/find. Faster, respects .gitignore, recursive by default.
+
+---
+
+## Security
+
+- Verify nonce usage and input sanitization in WordPress PHP code
+- Never concatenate user input directly into SQL \u2014 use parameterized queries
+- Check for XSS, CSRF, and OWASP top 10 vulnerabilities in written code
+
+---
+
+## Code Style
+
+- Don't create custom FP utility functions (pipe, compose, curry) \u2014 use language-native patterns or established libraries
+- In WordPress JavaScript context, use jQuery patterns when jQuery is already loaded
+- Prefer Bootstrap utility classes over custom CSS overrides
+- Run \`composer dump-autoload\` after creating new PHP files
+
+---
+
+## Documentation
+
+Follow the three-tier documentation system:
+- **Active** \u2014 Living docs, kept current (README, API docs, architecture)
+- **Archive** \u2014 Historical reference, rarely updated (decisions, post-mortems)
+- **Transient** \u2014 Ephemeral, git-ignored (session notes, scratch)
+`;
+}
+var GeminiAdapter = class {
+  name = "gemini";
+  displayName = "Gemini CLI";
+  configDir = GEMINI_DIR;
+  detect() {
+    return existsSync4(GEMINI_DIR);
+  }
+  preview(sourceDir) {
+    const skillItems = SKILLS_TO_INSTALL.map((skill) => ({
+      name: skill,
+      category: "skill",
+      destPath: join4(GEMINI_SKILLS_DIR, skill),
+      exists: existsSync4(join4(GEMINI_SKILLS_DIR, skill))
+    })).filter((item) => existsSync4(join4(sourceDir, "skills", item.name)));
+    const agentsDir = join4(sourceDir, "agents");
+    const agentItems = existsSync4(agentsDir) ? readdirSync4(agentsDir).filter((f) => f.endsWith(".md")).map((file) => ({
+      name: file.replace(/\.md$/, ""),
+      category: "agent",
+      destPath: join4(GEMINI_AGENTS_DIR, file),
+      exists: existsSync4(join4(GEMINI_AGENTS_DIR, file))
+    })) : [];
+    const hookItems = HOOKS_TO_INSTALL.map((file) => ({
+      name: file,
+      category: "hook",
+      destPath: join4(GEMINI_HOOKS_DIR, file),
+      exists: existsSync4(join4(GEMINI_HOOKS_DIR, file))
+    }));
+    const translatorItem = {
+      name: "hooks-translator.py",
+      category: "hook",
+      destPath: join4(GEMINI_HOOKS_DIR, "hooks-translator.py"),
+      exists: existsSync4(join4(GEMINI_HOOKS_DIR, "hooks-translator.py"))
+    };
+    const guidelineItem = {
+      name: "GEMINI.md",
+      category: "guideline",
+      destPath: GEMINI_GUIDELINES_FILE,
+      exists: existsSync4(GEMINI_GUIDELINES_FILE)
+    };
+    return {
+      platform: this.name,
+      targetDir: GEMINI_DIR,
+      items: [...skillItems, ...agentItems, ...hookItems, translatorItem, guidelineItem]
+    };
+  }
+  installSkills(sourceDir, exclude) {
+    ensureDir(GEMINI_SKILLS_DIR);
+    const skills = exclude?.length ? SKILLS_TO_INSTALL.filter((s) => !exclude.includes(s)) : SKILLS_TO_INSTALL;
+    for (const skill of skills) {
+      const src = join4(sourceDir, skill);
+      if (existsSync4(src) && statSync4(src).isDirectory()) {
+        copyDirRecursive(src, join4(GEMINI_SKILLS_DIR, skill));
+        log.step(`skill: ${skill}`);
+      }
+    }
+  }
+  installAgents(sourceDir, exclude) {
+    ensureDir(GEMINI_AGENTS_DIR);
+    const entries = readdirSync4(sourceDir).filter((f) => f.endsWith(".md")).filter((f) => !exclude?.includes(f.replace(/\.md$/, "")));
+    for (const file of entries) {
+      const content = readFileSync3(join4(sourceDir, file), "utf8");
+      const transformed = transformAgentForGemini(content);
+      writeFileSync3(join4(GEMINI_AGENTS_DIR, file), transformed);
+      log.step(`agent: ${file}`);
+    }
+  }
+  installGuidelines(_pluginRoot) {
+    ensureDir(GEMINI_DIR);
+    writeFileSync3(GEMINI_GUIDELINES_FILE, generateGeminiMd());
+    log.step(`guidelines: ${GEMINI_GUIDELINES_FILE}`);
+  }
+  installHooks(sourceDir, exclude) {
+    ensureDir(GEMINI_HOOKS_DIR);
+    const hooks = exclude?.length ? HOOKS_TO_INSTALL.filter((f) => !exclude.includes(f)) : HOOKS_TO_INSTALL;
+    for (const file of hooks) {
+      const src = join4(sourceDir, file);
+      if (existsSync4(src)) {
+        copyFileSync3(src, join4(GEMINI_HOOKS_DIR, file));
+        log.step(`hook: ${file}`);
+      }
+    }
+    const shimSrc = join4(__dirname2, "hooks-translator.py");
+    if (!existsSync4(shimSrc)) {
+      throw new Error(`hooks-translator.py not found at ${shimSrc} \u2014 packaging error`);
+    }
+    copyFileSync3(shimSrc, join4(GEMINI_HOOKS_DIR, "hooks-translator.py"));
+    log.step("hook: hooks-translator.py (shim)");
+    const hooksConfig = generateGeminiHooksConfig();
+    writeFileSync3(join4(GEMINI_HOOKS_DIR, "hooks.json"), JSON.stringify(hooksConfig, null, 2) + "\n");
+    log.step("hook: hooks.json (generated for Gemini)");
+    mergeGeminiHooksIntoSettings(hooksConfig);
+  }
+  postInstall() {
+    log.info("Gemini CLI install complete. Verify:");
+    log.info(`  Skills:     ${GEMINI_SKILLS_DIR}`);
+    log.info(`  Agents:     ${GEMINI_AGENTS_DIR}`);
+    log.info(`  Hooks:      ${GEMINI_HOOKS_DIR}`);
+    log.info(`  Guidelines: ${GEMINI_GUIDELINES_FILE}`);
+    log.info("Also available as a Gemini extension \u2014 see gemini-extension.json in the repo.");
+  }
+};
+function mergeGeminiHooksIntoSettings(hooksConfig) {
+  let settings = {};
+  if (existsSync4(GEMINI_SETTINGS_FILE)) {
+    try {
+      const content = readFileSync3(GEMINI_SETTINGS_FILE, "utf8");
+      settings = JSON.parse(content);
+    } catch {
+      settings = {};
+    }
+  }
+  if (!settings.hooks) {
+    settings.hooks = {};
+  }
+  const settingsHooks = settings.hooks;
+  const newHooks = hooksConfig.hooks;
+  for (const [event, entries] of Object.entries(newHooks)) {
+    if (!settingsHooks[event]) {
+      settingsHooks[event] = entries;
+      continue;
+    }
+    const existing = settingsHooks[event];
+    for (const entry of entries) {
+      if (entry.matcher) {
+        const idx = existing.findIndex((h) => h.matcher === entry.matcher);
+        if (idx >= 0) {
+          existing[idx] = entry;
+        } else {
+          existing.push(entry);
+        }
+      } else {
+        const matcherlessIdx = existing.findIndex((h) => !h.matcher);
+        if (matcherlessIdx >= 0) {
+          existing[matcherlessIdx] = entry;
+        } else {
+          existing.push(entry);
+        }
+      }
+    }
+  }
+  writeFileSync3(GEMINI_SETTINGS_FILE, JSON.stringify(settings, null, 2) + "\n");
+  log.info("Merged hooks into ~/.gemini/settings.json");
+}
+
+// platforms/gh-copilot/adapter.ts
+import { join as join5, dirname as dirname3 } from "path";
+import { homedir as homedir4 } from "os";
+import { existsSync as existsSync5, readdirSync as readdirSync5, statSync as statSync5, readFileSync as readFileSync4, writeFileSync as writeFileSync4, copyFileSync as copyFileSync4 } from "fs";
+import { fileURLToPath as fileURLToPath2 } from "url";
+var __filename2 = fileURLToPath2(import.meta.url);
+var __dirname3 = dirname3(__filename2);
+var COPILOT_DIR = join5(homedir4(), ".copilot");
+var COPILOT_SKILLS_DIR = join5(COPILOT_DIR, "skills");
+var COPILOT_AGENTS_DIR = join5(COPILOT_DIR, "agents");
+var COPILOT_HOOKS_DIR = join5(COPILOT_DIR, "hooks");
+var COPILOT_GUIDELINES_FILE = join5(COPILOT_DIR, "copilot-instructions.md");
+var TOOL_MAP2 = {
+  Bash: "run_terminal_command",
+  Read: "read_file",
+  Edit: "edit_file",
+  Write: "write_file",
+  Glob: "find_files",
+  Grep: "search_code",
+  LS: "list_directory",
+  WebSearch: "web_search",
+  WebFetch: "fetch_url",
+  ExitPlanMode: "ExitPlanMode"
+};
+var EVENT_MAP2 = {
+  PreToolUse: "preToolUse",
+  PostToolUse: "postToolUse",
+  UserPromptSubmit: "userPromptSubmitted",
+  SessionStart: "sessionStart"
+};
+function parseFrontmatter3(content) {
+  const match = content.match(/^---\n([\s\S]*?)\n---\n?([\s\S]*)$/);
+  if (!match) return { frontmatter: {}, body: content };
+  const frontmatter = {};
+  for (const line of match[1].split("\n")) {
+    const colonIdx = line.indexOf(":");
+    if (colonIdx === -1) continue;
+    const key = line.slice(0, colonIdx).trim();
+    const value = line.slice(colonIdx + 1).trim();
+    if (key) frontmatter[key] = value;
+  }
+  return { frontmatter, body: match[2] };
+}
+function serializeFrontmatter3(frontmatter, body) {
+  const lines = Object.entries(frontmatter).map(([k, v]) => `${k}: ${v}`);
+  return `---
+${lines.join("\n")}
+---
+${body}`;
+}
+function mapToolName2(claudeName) {
+  return TOOL_MAP2[claudeName] ?? claudeName;
+}
+function transformAgentForCopilot(content) {
+  const { frontmatter, body } = parseFrontmatter3(content);
+  const { permissionMode: _perm, model: _model, ...kept } = frontmatter;
+  if (kept.tools) {
+    const mapped = kept.tools.split(",").map((t) => t.trim()).map(mapToolName2).join(", ");
+    kept.tools = mapped;
+  }
+  return serializeFrontmatter3(kept, body);
+}
+function translateMatcher2(matcher) {
+  return TOOL_MAP2[matcher] ?? matcher;
+}
+function translateHookCommand2(command2) {
+  const hooksDir = COPILOT_HOOKS_DIR;
+  const translatorPath = join5(hooksDir, "hooks-translator.py");
+  const match = command2.match(/python3\s+.*\/([^/\s]+\.py)(\s.*)?$/);
+  if (!match) return command2;
+  const scriptName = match[1];
+  const trailingArgs = match[2] ?? "";
+  return `python3 ${translatorPath} ${join5(hooksDir, scriptName)}${trailingArgs}`;
+}
+function generateCopilotHooksConfig() {
+  const copilotHooks = {};
+  for (const [claudeEvent, hookEntries] of Object.entries(HOOKS_CONFIG.hooks)) {
+    const copilotEvent = EVENT_MAP2[claudeEvent] ?? claudeEvent;
+    const flatEntries = [];
+    for (const entry of hookEntries) {
+      const translatedMatcher = entry.matcher ? translateMatcher2(entry.matcher) : void 0;
+      for (const hook of entry.hooks) {
+        const flatEntry = {};
+        if (translatedMatcher) {
+          flatEntry.matcher = translatedMatcher;
+        }
+        flatEntry.type = hook.type;
+        flatEntry.bash = translateHookCommand2(hook.command);
+        flatEntries.push(flatEntry);
+      }
+    }
+    copilotHooks[copilotEvent] = flatEntries;
+  }
+  return { version: 1, hooks: copilotHooks };
+}
+function generateCopilotInstructionsMd() {
+  return `# ima-claude: AI Coding Agent Guidelines
+
+> Generated by ima-claude v${VERSION} for GitHub Copilot.
+> Source: https://github.com/Soabirw/ima-claude
+
+## Default Persona: The Practitioner
+
+A 25-year software development veteran. FP-first, composition-minded, anti-over-engineering.
+Uses "we" not "I" \u2014 collaborative, humble, light-hearted. "Slow is smooth, smooth is fast."
+
+**Philosophy**: Simple > Complex | Evidence > Assumptions | Native > Utilities | MVP > Enterprise
+
+---
+
+## Memory Routing
+
+| Store what | Where | Why |
+|---|---|---|
+| Decisions, preferences, patterns, bugs | Vestige \`smart_ingest\` | Fades naturally if not referenced |
+| Reference material (docs, standards, PRDs) | Qdrant \`qdrant-store\` | Permanent library |
+| Session state, task progress | Serena \`write_memory\` | Project-scoped workbench |
+| Future reminders | Vestige \`intention\` | Surfaces at next session |
+
+At session start, check memory before asking questions:
+- Vestige: search for user preferences and project context
+- Vestige: check for pending reminders/intentions
+- Serena: list memories if in a Serena-activated project
+
+Auto-store: "I prefer..." \u2192 Vestige preference. "Let's go with X because..." \u2192 Vestige decision. "The reason this failed..." \u2192 Vestige bug.
+
+After completing work: store outcome in Vestige, reference material in Qdrant, session state in Serena.
+
+---
+
+## Orchestrator Protocol
+
+You are the Orchestrator. Plan and delegate. Do NOT implement directly.
+- Non-trivial work \u2192 task-planner (decompose) \u2192 task-runner (delegate)
+- Trivial = single file, < 5 lines, no judgment calls
+
+---
+
+## Available Agents
+
+Delegate to named agents \u2014 they enforce tools and permissions automatically.
+
+| Agent | Use For |
+|---|---|
+| \`explorer\` | File discovery, codebase exploration |
+| \`implementer\` | Feature dev, bug fixes, refactoring |
+| \`reviewer\` | Code review, security audit, FP checks |
+| \`wp-developer\` | WordPress plugins, themes, WP-CLI, forms |
+| \`memory\` | Memory search, storage, consolidation |
+
+---
+
+## Code Navigation (Serena)
+
+When Serena MCP is available, **prefer Serena over read_file/search_code for code investigation.** 40-70% token savings.
+
+| Instead of | Use |
+|---|---|
+| Read file to understand structure | Serena get_symbols_overview |
+| search_code for class/function definition | Serena find_symbol |
+| search_code for callers/references | Serena find_referencing_symbols |
+
+Use read_file only when you need the actual implementation body of a known, specific symbol.
+
+---
+
+## Complex Reasoning
+
+Use sequential thinking before acting on:
+- Debugging / root cause analysis / "why is this failing"
+- Trade-off evaluation / "which approach"
+- Architectural decisions / design choices
+- Multi-step investigations where approach may change
+
+---
+
+## MCP Tool Routing
+
+| Signal | Preferred Tool |
+|---|---|
+| "latest", "2025/2026", "what's new" | Tavily search |
+| Library/framework API question | Context7 |
+| URL content extraction | Tavily extract (use advanced for complex pages) |
+
+Before web tools: check internal knowledge \u2192 Context7 \u2192 then Tavily.
+Before external lookups: check Vestige memory first.
+
+---
+
+## Search Preference
+
+Always prefer \`rg\` (ripgrep) over grep/find. Faster, respects .gitignore, recursive by default.
+
+---
+
+## Security
+
+- Verify nonce usage and input sanitization in WordPress PHP code
+- Never concatenate user input directly into SQL \u2014 use parameterized queries
+- Check for XSS, CSRF, and OWASP top 10 vulnerabilities in written code
+
+---
+
+## Code Style
+
+- Don't create custom FP utility functions (pipe, compose, curry) \u2014 use language-native patterns or established libraries
+- In WordPress JavaScript context, use jQuery patterns when jQuery is already loaded
+- Prefer Bootstrap utility classes over custom CSS overrides
+- Run \`composer dump-autoload\` after creating new PHP files
+
+---
+
+## Documentation
+
+Follow the three-tier documentation system:
+- **Active** \u2014 Living docs, kept current (README, API docs, architecture)
+- **Archive** \u2014 Historical reference, rarely updated (decisions, post-mortems)
+- **Transient** \u2014 Ephemeral, git-ignored (session notes, scratch)
+`;
+}
+var GhCopilotAdapter = class {
+  name = "gh-copilot";
+  displayName = "GitHub Copilot";
+  configDir = COPILOT_DIR;
+  detect() {
+    return existsSync5(COPILOT_DIR);
+  }
+  preview(sourceDir) {
+    const skillItems = SKILLS_TO_INSTALL.map((skill) => ({
+      name: skill,
+      category: "skill",
+      destPath: join5(COPILOT_SKILLS_DIR, skill),
+      exists: existsSync5(join5(COPILOT_SKILLS_DIR, skill))
+    })).filter((item) => existsSync5(join5(sourceDir, "skills", item.name)));
+    const agentsDir = join5(sourceDir, "agents");
+    const agentItems = existsSync5(agentsDir) ? readdirSync5(agentsDir).filter((f) => f.endsWith(".md")).map((file) => ({
+      name: file.replace(/\.md$/, ""),
+      category: "agent",
+      destPath: join5(COPILOT_AGENTS_DIR, file.replace(/\.md$/, ".agent.md")),
+      exists: existsSync5(join5(COPILOT_AGENTS_DIR, file.replace(/\.md$/, ".agent.md")))
+    })) : [];
+    const hookItems = HOOKS_TO_INSTALL.map((file) => ({
+      name: file,
+      category: "hook",
+      destPath: join5(COPILOT_HOOKS_DIR, file),
+      exists: existsSync5(join5(COPILOT_HOOKS_DIR, file))
+    }));
+    const translatorItem = {
+      name: "hooks-translator.py",
+      category: "hook",
+      destPath: join5(COPILOT_HOOKS_DIR, "hooks-translator.py"),
+      exists: existsSync5(join5(COPILOT_HOOKS_DIR, "hooks-translator.py"))
+    };
+    const guidelineItem = {
+      name: "copilot-instructions.md",
+      category: "guideline",
+      destPath: COPILOT_GUIDELINES_FILE,
+      exists: existsSync5(COPILOT_GUIDELINES_FILE)
+    };
+    return {
+      platform: this.name,
+      targetDir: COPILOT_DIR,
+      items: [...skillItems, ...agentItems, ...hookItems, translatorItem, guidelineItem]
+    };
+  }
+  installSkills(sourceDir, exclude) {
+    ensureDir(COPILOT_SKILLS_DIR);
+    const skills = exclude?.length ? SKILLS_TO_INSTALL.filter((s) => !exclude.includes(s)) : SKILLS_TO_INSTALL;
+    for (const skill of skills) {
+      const src = join5(sourceDir, skill);
+      if (existsSync5(src) && statSync5(src).isDirectory()) {
+        copyDirRecursive(src, join5(COPILOT_SKILLS_DIR, skill));
+        log.step(`skill: ${skill}`);
+      }
+    }
+  }
+  installAgents(sourceDir, exclude) {
+    ensureDir(COPILOT_AGENTS_DIR);
+    const entries = readdirSync5(sourceDir).filter((f) => f.endsWith(".md")).filter((f) => !exclude?.includes(f.replace(/\.md$/, "")));
+    for (const file of entries) {
+      const content = readFileSync4(join5(sourceDir, file), "utf8");
+      const transformed = transformAgentForCopilot(content);
+      const destFile = file.replace(/\.md$/, ".agent.md");
+      writeFileSync4(join5(COPILOT_AGENTS_DIR, destFile), transformed);
+      log.step(`agent: ${destFile}`);
+    }
+  }
+  installGuidelines(_pluginRoot) {
+    ensureDir(COPILOT_DIR);
+    writeFileSync4(COPILOT_GUIDELINES_FILE, generateCopilotInstructionsMd());
+    log.step(`guidelines: ${COPILOT_GUIDELINES_FILE}`);
+  }
+  installHooks(sourceDir, exclude) {
+    ensureDir(COPILOT_HOOKS_DIR);
+    const hooks = exclude?.length ? HOOKS_TO_INSTALL.filter((f) => !exclude.includes(f)) : HOOKS_TO_INSTALL;
+    for (const file of hooks) {
+      const src = join5(sourceDir, file);
+      if (existsSync5(src)) {
+        copyFileSync4(src, join5(COPILOT_HOOKS_DIR, file));
+        log.step(`hook: ${file}`);
+      }
+    }
+    const shimSrc = join5(__dirname3, "hooks-translator.py");
+    if (!existsSync5(shimSrc)) {
+      throw new Error(`hooks-translator.py not found at ${shimSrc} \u2014 packaging error`);
+    }
+    copyFileSync4(shimSrc, join5(COPILOT_HOOKS_DIR, "hooks-translator.py"));
+    log.step("hook: hooks-translator.py (shim)");
+    const hooksConfig = generateCopilotHooksConfig();
+    const hooksConfigPath = join5(COPILOT_HOOKS_DIR, "hooks.json");
+    mergeCopilotHooksConfig(hooksConfigPath, hooksConfig);
+    log.step("hook: hooks.json (generated for GitHub Copilot)");
+  }
+  postInstall() {
+    log.info("GitHub Copilot install complete. Verify:");
+    log.info(`  Skills:     ${COPILOT_SKILLS_DIR}`);
+    log.info(`  Agents:     ${COPILOT_AGENTS_DIR}`);
+    log.info(`  Hooks:      ${COPILOT_HOOKS_DIR}`);
+    log.info(`  Guidelines: ${COPILOT_GUIDELINES_FILE}`);
+  }
+};
+function mergeCopilotHooksConfig(configPath, newConfig) {
+  let existing = {};
+  if (existsSync5(configPath)) {
+    try {
+      const content = readFileSync4(configPath, "utf8");
+      existing = JSON.parse(content);
+    } catch {
+      existing = {};
+    }
+  }
+  existing.version = newConfig.version ?? 1;
+  if (!existing.hooks) {
+    existing.hooks = {};
+  }
+  const existingHooks = existing.hooks;
+  const incomingHooks = newConfig.hooks;
+  for (const [event, entries] of Object.entries(incomingHooks)) {
+    if (!existingHooks[event]) {
+      existingHooks[event] = entries;
+      continue;
+    }
+    const userHooks = existingHooks[event].filter(
+      (h) => !h.bash?.includes("hooks-translator.py")
+    );
+    existingHooks[event] = [...userHooks, ...entries];
+  }
+  writeFileSync4(configPath, JSON.stringify(existing, null, 2) + "\n");
+}
+
 // platforms/shared/detector.ts
 var ADAPTERS = [
   new ClaudeAdapter(),
-  new JunieAdapter()
+  new JunieAdapter(),
+  new GeminiAdapter(),
+  new GhCopilotAdapter()
 ];
 function detectPlatforms() {
   return ADAPTERS.map((adapter) => {
     const detected = adapter.detect();
-    const note = adapter.name === "claude" && detected ? "Recommended: install via plugin marketplace instead" : void 0;
+    const note = adapter.name === "claude" && detected ? "Recommended: install via plugin marketplace instead" : adapter.name === "gemini" && detected ? "Also available as a Gemini extension" : void 0;
     return { adapter, detected, note };
   });
 }
@@ -701,28 +1420,28 @@ function getAdapter(name) {
 }
 
 // platforms/shared/installer.ts
-import { join as join5 } from "path";
+import { join as join7 } from "path";
 
 // platforms/shared/types.ts
-import { join as join4, resolve, dirname as dirname2 } from "path";
-import { existsSync as existsSync4 } from "fs";
-import { fileURLToPath } from "url";
+import { join as join6, resolve, dirname as dirname4 } from "path";
+import { existsSync as existsSync6 } from "fs";
+import { fileURLToPath as fileURLToPath3 } from "url";
 function findPackageRoot() {
   let dir;
   try {
-    dir = dirname2(fileURLToPath(import.meta.url));
+    dir = dirname4(fileURLToPath3(import.meta.url));
   } catch {
     dir = typeof __dirname !== "undefined" ? __dirname : resolve(".");
   }
   for (let i = 0; i < 10; i++) {
-    if (existsSync4(join4(dir, "package.json"))) return dir;
-    const parent = join4(dir, "..");
+    if (existsSync6(join6(dir, "package.json"))) return dir;
+    const parent = join6(dir, "..");
     if (parent === dir) break;
     dir = parent;
   }
   return process.cwd();
 }
-var PLUGIN_SOURCE = join4(
+var PLUGIN_SOURCE = join6(
   findPackageRoot(),
   "plugins",
   "ima-claude"
@@ -838,9 +1557,9 @@ ${colors.bright}Hooks${colors.reset} (${hooks.length} total)`
   return filter;
 }
 async function installForPlatform(adapter, options = {}) {
-  const skillsSource = join5(PLUGIN_SOURCE, "skills");
-  const agentsSource = join5(PLUGIN_SOURCE, "agents");
-  const hooksSource = join5(PLUGIN_SOURCE, "hooks");
+  const skillsSource = join7(PLUGIN_SOURCE, "skills");
+  const agentsSource = join7(PLUGIN_SOURCE, "agents");
+  const hooksSource = join7(PLUGIN_SOURCE, "hooks");
   const preview = adapter.preview(PLUGIN_SOURCE);
   showPreview(adapter, preview.items);
   const filter = await promptExclusions(preview.items);
@@ -908,7 +1627,7 @@ ${colors.cyan}Usage:${colors.reset}
 
 ${colors.cyan}Commands:${colors.reset}
   install             Interactive install (auto-detects platforms)
-  install --target X  Install for specific platform (claude, junie)
+  install --target X  Install for specific platform (claude, junie, gemini, gh-copilot)
   upgrade             Upgrade installed skills to latest version
   detect              Show detected platforms
   help                Show this help message
@@ -966,7 +1685,7 @@ ${colors.bright}ima-claude v${VERSION} \u2014 Multi-Platform Installer${colors.r
       `
 ${colors.yellow}No supported platforms detected.${colors.reset}`
     );
-    console.log("Install Claude Code or Junie CLI first, then run this installer again.\n");
+    console.log("Install Claude Code, Junie CLI, Gemini CLI, or GitHub Copilot first, then run this installer again.\n");
     return;
   }
   console.log("");
@@ -998,7 +1717,7 @@ async function targetedInstall(targetName) {
   const adapter = getAdapter(targetName);
   if (!adapter) {
     log.error(`Unknown target: ${targetName}`);
-    console.log("Available targets: claude, junie");
+    console.log("Available targets: claude, junie, gemini, gh-copilot");
     process.exit(1);
   }
   if (!adapter.detect()) {