@el-j/magic-helix-core 4.0.0-beta.2 → 4.0.0-beta.4

package/dist/index.mjs

@@ -1,54 +1,2217 @@
-import "node:path";
-import "node:url";
-import { e as i, B as n, C as r, g as l, D as o, G as g, a as u, b as P, I, M as T, P as y, x as p, y as c, u as d, c as m, R, Q as C, T as E, U as L, d as M, q as N, J as _, K as f, H as A, k as B, O, f as h, n as G, S as U, i as b, h as z, o as F, z as k, L as v, N as D, A as V, E as H, F as Q, j as S, l as j, m as w, p as x, w as q, r as J, t as K, s as W, V as X, v as Y } from "./index-DkvW5yBY.js";
+import * as g from "node:path";
+import C, { dirname as L } from "node:path";
+import { fileURLToPath as M } from "node:url";
+import * as p from "node:fs";
+import S from "node:fs";
+import P from "picocolors";
+import { glob as O } from "glob";
+function R(n) {
+  if (n === "src/**/*.ts")
+    return /^src\/.*\.ts$/;
+  if (n === "src/**/*.vue")
+    return /^src\/.*\.vue$/;
+  const e = n.replace(/\*\*/g, ".*").replace(/\*/g, "[^/]*");
+  return new RegExp(`^${e.replace(/[.+^${}()|[\]\\]/g, "\\$&")}$`);
+}
+function _(n, e) {
+  const t = R(e);
+  return n.some((s) => t.test(s));
+}
+function ye(n, e, t, s) {
+  const i = /* @__PURE__ */ new Set();
+  for (const [r, o] of Object.entries(n.dependencies))
+    e[r] && i.add(e[r]);
+  for (const r of n.configFiles)
+    t[r] && i.add(t[r]);
+  for (const r in s) {
+    const o = s[r];
+    _(n.projectFiles, r) && i.add(o);
+  }
+  return i;
+}
+const A = {
+  target: "github-copilot",
+  templateDirectory: "ai_templates",
+  // User's custom template dir
+  outputDirectory: ".github/instructions",
+  // Default output dir
+  aiRefinement: {
+    quality: "standard",
+    contextLevel: "balanced",
+    outputFormat: "markdown",
+    tokenBudget: 4e3,
+    includeExamples: !0,
+    includeBestPractices: !0
+  },
+  dependencyTagMap: {
+    // Frameworks
+    vue: "framework-vue",
+    react: "framework-react",
+    "@angular/core": "framework-angular",
+    "@nestjs/core": "framework-nestjs",
+    // Styling
+    tailwindcss: "style-tailwind",
+    primevue: "style-primevue",
+    "@mui/material": "style-mui",
+    quasar: "style-quasar",
+    // Testing
+    vitest: "test-vitest",
+    jest: "test-jest",
+    cypress: "test-cypress",
+    playwright: "test-playwright",
+    // State
+    rxjs: "state-rxjs",
+    pinia: "state-pinia",
+    redux: "state-redux",
+    zustand: "state-zustand"
+  },
+  configFileTagMap: {
+    // Detect key configs - removed language-specific entries, now handled by plugins
+    "tailwind.config.js": "style-tailwind",
+    "tailwind.config.ts": "style-tailwind",
+    "vite.config.ts": "build-vite",
+    "vite.config.js": "build-vite"
+  },
+  fileGlobTagMap: {
+    // Detect file types - removed language-specific entries, now handled by plugins
+  },
+  tagTemplateMap: {
+    // Vue Projects
+    "framework-vue": [
+      { template: "vue/vue-core.md", suffix: "vue.instructions.md" }
+    ],
+    "state-pinia": [
+      { template: "vue/vue-pinia.md", suffix: "vue-pinia.instructions.md" }
+    ],
+    "style-primevue": [
+      {
+        template: "vue/style-primevue.md",
+        suffix: "vue-primevue.instructions.md"
+      }
+    ],
+    "style-quasar": [
+      { template: "vue/style-quasar.md", suffix: "vue-quasar.instructions.md" }
+    ],
+    // React Projects
+    "framework-react": [
+      { template: "react/react-core.md", suffix: "react.instructions.md" }
+    ],
+    "state-zustand": [
+      {
+        template: "react/react-zustand.md",
+        suffix: "react-zustand.instructions.md"
+      }
+    ],
+    // NestJS Projects
+    "framework-nestjs": [
+      { template: "nestjs/nestjs-core.md", suffix: "nestjs.instructions.md" }
+    ],
+    // Angular Projects
+    "framework-angular": [
+      {
+        template: "angular/angular-core.md",
+        suffix: "angular.instructions.md"
+      }
+    ],
+    // Generic
+    "style-tailwind": [
+      {
+        template: "generic/style-tailwind.md",
+        suffix: "tailwind.instructions.md"
+      }
+    ],
+    "style-mui": [
+      { template: "generic/style-mui.md", suffix: "mui.instructions.md" }
+    ],
+    "test-vitest": [
+      { template: "generic/test-vitest.md", suffix: "vitest.instructions.md" }
+    ],
+    "test-jest": [
+      { template: "generic/test-jest.md", suffix: "jest.instructions.md" }
+    ],
+    "test-cypress": [
+      {
+        template: "generic/test-cypress.md",
+        suffix: "cypress.instructions.md"
+      }
+    ],
+    "test-playwright": [
+      {
+        template: "generic/test-playwright.md",
+        suffix: "playwright.instructions.md"
+      }
+    ]
+    // Language-specific templates removed - now provided by language plugins
+  }
+}, T = {
+  quality: "standard",
+  contextLevel: "balanced",
+  outputFormat: "markdown",
+  tokenBudget: 4e3,
+  includeExamples: !0,
+  includeBestPractices: !0
+};
+function we(n, e) {
+  const t = { ...T, ...e };
+  let s = n;
+  return s = z(s, t.outputFormat), s = W(s, t.quality), s = N(s, t.contextLevel), t.includeExamples || (s = G(s)), t.includeBestPractices || (s = B(s)), s = q(s, t.tokenBudget), s;
+}
+function W(n, e) {
+  switch (e) {
+    case "basic":
+      return n.split(/\n(?=##? )/).filter((s) => {
+        s.toLowerCase();
+        const i = s.split(`
+`)[0].toLowerCase();
+        return i.includes("# ") || // Keep top-level headers
+        i.includes("overview") || i.includes("basic") || i.includes("essential");
+      }).join(`
+`);
+    case "comprehensive":
+      return n;
+    default:
+      return n.split(/\n(?=##? )/).filter((s) => {
+        const i = s.split(`
+`)[0].toLowerCase();
+        return !i.includes("advanced") && !i.includes("deep dive");
+      }).join(`
+`);
+  }
+}
+function N(n, e) {
+  switch (e) {
+    case "minimal":
+      return n.split(/\n(?=##? )/).filter((s) => {
+        const i = s.split(`
+`)[0].toLowerCase();
+        return !i.includes("background") && !i.includes("why ") && !i.includes("explanation") && !i.includes("deep dive");
+      }).join(`
+`);
+    case "extensive":
+      return n;
+    default:
+      return n.split(`
+`).filter((t) => t.startsWith("#") || t.startsWith("-") || t.startsWith("*") || t.match(/^\d+\./) || // numbered lists
+      t.startsWith("```") || t.startsWith("  ") || t.trim().length === 0 || t.trim().length < 200).join(`
+`);
+  }
+}
+function z(n, e) {
+  switch (e) {
+    case "structured":
+      return n.replace(/^### /gm, "#### ").replace(/^## /gm, "### ").replace(/^# /gm, "## ");
+    // Demote h1 to h2
+    case "conversational":
+      return n.replace(/^- (.+)$/gm, (t, s) => `${s}.`).replace(/\n{3,}/g, `
+
+`);
+    case "code-focused": {
+      const t = n.split(`
+`);
+      let s = !1;
+      return t.filter((i) => i.startsWith("```") ? (s = !s, !0) : s || i.startsWith("#") || i.trim().length === 0 ? !0 : i.match(/^[^.]+\./)).join(`
+`);
+    }
+    default:
+      return n;
+  }
+}
+function G(n) {
+  let e = "", t = !1, s = !1;
+  for (const i of n.split(`
+`)) {
+    if (i.startsWith("```")) {
+      t = !t;
+      continue;
+    }
+    if (!t) {
+      if (i.match(/^##+ .*example/i)) {
+        s = !0;
+        continue;
+      }
+      i.startsWith("##") && (s = !1);
+    }
+    !t && !s && (e += `${i}
+`);
+  }
+  return e;
+}
+function B(n) {
+  return n.split(`
+`).filter((e) => {
+    const t = e.toLowerCase();
+    return !(t.match(/^##+ .*best practice/i) || t.match(/^##+ .*recommendation/i) || t.match(/^##+ .*tip/i));
+  }).join(`
+`);
+}
+function q(n, e) {
+  const t = e * 4;
+  if (n.length <= t) return n;
+  const s = n.substring(0, t), i = s.lastIndexOf(`
+## `);
+  return i > t * 0.7 ? `${s.substring(0, i)}
+
+<!-- Content truncated to fit token budget -->` : `${s}
+
+<!-- Content truncated to fit token budget -->`;
+}
+function ve(n) {
+  return Math.ceil(n.length / 4);
+}
+const j = "magic-helix.config.json", H = ["ai-aligner.config.json"];
+function Pe(n) {
+  const t = (n ? [g.resolve(process.cwd(), n)] : [
+    g.resolve(process.cwd(), j),
+    ...H.map(
+      (s) => g.resolve(process.cwd(), s)
+    )
+  ]).find((s, i) => {
+    const r = p.existsSync(s);
+    return !n && r && i > 0 && console.warn(
+      P.yellow(
+        `  Detected legacy config file ${g.basename(s)}. Please rename it to ${j}.`
+      )
+    ), r;
+  });
+  if (!t)
+    return console.log(
+      P.gray("  No user config file found. Using built-in conventions only.")
+    ), {};
+  try {
+    return console.log(
+      P.blue("  User config file found. Merging with built-in conventions.")
+    ), JSON.parse(p.readFileSync(t, "utf-8"));
+  } catch (s) {
+    return console.error(
+      P.red(`❌ Error parsing config file: ${s.message}`)
+    ), console.warn(
+      P.yellow(
+        "  Please fix the JSON or remove the file. Using built-in conventions only."
+      )
+    ), {};
+  }
+}
+function be(n) {
+  const e = A, t = U(
+    n.outputDirectory ?? e.outputDirectory
+  );
+  return {
+    target: n.target || e.target,
+    templateDirectory: n.templateDirectory ?? e.templateDirectory,
+    outputDirectory: t,
+    dependencyTagMap: {
+      ...e.dependencyTagMap,
+      ...n.dependencyTagMap || {}
+    },
+    configFileTagMap: {
+      ...e.configFileTagMap,
+      ...n.configFileTagMap || {}
+    },
+    fileGlobTagMap: {
+      ...e.fileGlobTagMap,
+      ...n.fileGlobTagMap || {}
+    },
+    tagTemplateMap: {
+      ...e.tagTemplateMap,
+      ...n.tagTemplateMap || {}
+    },
+    aiRefinement: {
+      ...T,
+      ...n.aiRefinement || {}
+    }
+  };
+}
+function U(n) {
+  const e = n.trim();
+  if (e.endsWith(".github/instruction") || /\binstruction\/?$/.test(e)) {
+    const t = e.replace(/instruction\/?$/, "instructions");
+    return console.warn(
+      P.yellow(
+        `  Normalized outputDirectory from "${e}" to "${t}". Using ".github/instructions" as the default convention.`
+      )
+    ), t;
+  }
+  return e;
+}
+class E {
+  format(e, t, s) {
+    return e;
+  }
+  getFileExtension() {
+    return ".md";
+  }
+  getFrontmatter(e, t) {
+    return `---
+applyTo: "${e}"
+---
+
+`;
+  }
+}
+class J {
+  format(e, t, s) {
+    return e.replace(/- \*\*([^*]+)\*\*/g, "- **$1** (important)");
+  }
+  getFileExtension() {
+    return ".md";
+  }
+  getFrontmatter(e, t) {
+    return `---
+applyTo: "${e}"
+assistant: claude
+---
+
+`;
+  }
+}
+class V {
+  format(e, t, s) {
+    return e.replace(/- \*\*ALWAYS\*\*/g, "- 🔴").replace(/- \*\*NEVER\*\*/g, "- ❌");
+  }
+  getFileExtension() {
+    return ".md";
+  }
+  getFrontmatter(e, t) {
+    return `---
+applyTo: "${e}"
+context: chat
+---
+
+`;
+  }
+}
+class Y {
+  format(e, t, s) {
+    return e;
+  }
+  getFileExtension() {
+    return ".md";
+  }
+  getFrontmatter(e, t) {
+    return `---
+applyTo: "${e}"
+---
+
+`;
+  }
+}
+function ke(n) {
+  switch (n) {
+    case "github-copilot":
+      return new E();
+    case "claude":
+      return new J();
+    case "copilot-chat":
+      return new V();
+    case "generic":
+      return new Y();
+    default:
+      return new E();
+  }
+}
+const v = {};
+function Q() {
+  const n = require.resolve("@el-j/magic-helix-plugins"), e = v.dirname(n), t = v.join(e, "patterns"), s = /* @__PURE__ */ new Map(), i = [
+    "role-definition",
+    "organization",
+    "tool-guidelines",
+    "reasoning",
+    "domain-expertise",
+    "safety",
+    "tone",
+    "environment"
+  ];
+  for (const r of i) {
+    const o = v.join(t, r);
+    if (!v.existsSync(o)) continue;
+    const a = v.readdirSync(o).filter((c) => c.endsWith(".md"));
+    for (const c of a) {
+      const l = c.replace(".md", ""), u = v.readFileSync(v.join(o, c), "utf-8");
+      s.set(l, {
+        name: l,
+        category: r,
+        content: u,
+        priority: X(r)
+      });
+    }
+  }
+  return s;
+}
+function X(n) {
+  return {
+    "role-definition": 1,
+    organization: 2,
+    "tool-guidelines": 3,
+    reasoning: 4,
+    "domain-expertise": 5,
+    environment: 6,
+    tone: 7,
+    safety: 8
+    // Safety always highest priority (never overridden)
+  }[n];
+}
+function K(n, e) {
+  const t = [], s = n.get("expert-identity"), i = n.get("scope-boundaries");
+  s && t.push(s), i && t.push(i);
+  const r = n.get("heading-hierarchy");
+  r && t.push(r);
+  const o = n.get("function-schemas"), a = n.get("usage-policies");
+  if (o && t.push(o), a && t.push(a), e.framework === "react" || e.framework === "vue") {
+    const u = n.get("react-patterns");
+    u && t.push(u);
+  }
+  if (e.libraries) {
+    if (e.libraries.includes("tailwind")) {
+      const u = n.get("tailwind-patterns");
+      u && t.push(u);
+    }
+    if (e.libraries.includes("shadcn-ui")) {
+      const u = n.get("shadcn-ui");
+      u && t.push(u);
+    }
+  }
+  if (e.aiModel === "claude") {
+    const u = n.get("thinking-tags"), d = n.get("concise-communication");
+    u && t.push(u), d && t.push(d);
+  }
+  if (e.tone === "concise") {
+    const u = n.get("concise-communication"), d = n.get("forbidden-phrases");
+    u && t.push(u), d && t.push(d);
+  }
+  if (e.environment === "vscode") {
+    const u = n.get("ide-features");
+    u && t.push(u);
+  }
+  const c = n.get("refusal-messages"), l = n.get("destructive-warnings");
+  if (c && t.push(c), l && t.push(l), e.includePatterns)
+    for (const u of e.includePatterns) {
+      const d = n.get(u);
+      d && !t.includes(d) && t.push(d);
+    }
+  return e.excludePatterns ? t.filter((u) => !e.excludePatterns?.includes(u.name)) : t;
+}
+function Z(n) {
+  const e = n.sort((f, m) => f.priority - m.priority), t = [], s = /* @__PURE__ */ new Map();
+  for (const f of e) {
+    s.has(f.category) || s.set(f.category, []);
+    const m = s.get(f.category);
+    m && m.push(f);
+  }
+  t.push(`# AI Agent Instructions
+`);
+  const i = s.get("role-definition");
+  if (i) {
+    t.push(`## Role & Identity
+`);
+    for (const f of i)
+      t.push(w(f.content));
+  }
+  const r = s.get("organization");
+  if (r) {
+    t.push(`## Instruction Structure
+`);
+    for (const f of r)
+      t.push(w(f.content));
+  }
+  const o = s.get("tool-guidelines");
+  if (o) {
+    t.push(`## Tool Usage Guidelines
+`);
+    for (const f of o)
+      t.push(w(f.content));
+  }
+  const a = s.get("reasoning");
+  if (a) {
+    t.push(`## Reasoning & Execution Patterns
+`);
+    for (const f of a)
+      t.push(w(f.content));
+  }
+  const c = s.get("domain-expertise");
+  if (c) {
+    t.push(`## Domain-Specific Guidelines
+`);
+    for (const f of c)
+      t.push(w(f.content));
+  }
+  const l = s.get("environment");
+  if (l) {
+    t.push(`## Environment Context
+`);
+    for (const f of l)
+      t.push(w(f.content));
+  }
+  const u = s.get("tone");
+  if (u) {
+    t.push(`## Communication Style
+`);
+    for (const f of u)
+      t.push(w(f.content));
+  }
+  const d = s.get("safety");
+  if (d) {
+    t.push(`## Safety & Refusal Protocols
+`);
+    for (const f of d)
+      t.push(w(f.content));
+  }
+  return t.join(`
+
+`);
+}
+function w(n) {
+  let e = n.replace(/^# .+ Pattern\n+/, "");
+  const t = e.match(
+    /## Examples\n([\s\S]+?)(?=\n## |\n---|Z)/
+  );
+  return t ? t[1].trim() : (e = e.replace(/## Purpose\n.+?\n\n/, ""), e = e.replace(/## Template\n[\s\S]+?(?=\n## |$)/, ""), e = e.replace(/## Best Practices\n[\s\S]+$/, ""), e.trim());
+}
+function ee(n) {
+  const e = Q(), t = K(e, n);
+  return Z(t);
+}
+const te = [
+  // Role Definition (Critical)
+  {
+    name: "Expert Identity",
+    weight: 1,
+    required: !0,
+    check: (n) => /you are (an?|the) .+? (expert|specialist|assistant)/i.test(n)
+  },
+  {
+    name: "Capability Declarations",
+    weight: 0.8,
+    required: !0,
+    check: (n) => /you (can|excel at|have expertise in)/i.test(n)
+  },
+  {
+    name: "Scope Boundaries",
+    weight: 0.7,
+    required: !1,
+    check: (n) => /you (will not|won't|cannot|must not)/i.test(n)
+  },
+  // Organization Structure (Important)
+  {
+    name: "Clear Headings",
+    weight: 0.9,
+    required: !0,
+    check: (n) => (n.match(/^##? /gm) || []).length >= 3
+  },
+  {
+    name: "Structured Sections",
+    weight: 0.8,
+    required: !1,
+    check: (n) => /<rules>|<thinking>|```xml/i.test(n) || (n.match(/^###? /gm) || []).length >= 5
+  },
+  // Tool Guidelines (Critical for agentic AI)
+  {
+    name: "Tool Documentation",
+    weight: 1,
+    required: !0,
+    check: (n) => /tool|function|command|api/i.test(n) && /parameter|argument|input/i.test(n)
+  },
+  {
+    name: "Tool Usage Policies",
+    weight: 0.9,
+    required: !0,
+    check: (n) => /when to use|when not to use|prefer|avoid/i.test(n)
+  },
+  {
+    name: "Concrete Examples",
+    weight: 0.8,
+    required: !0,
+    check: (n) => (n.match(/```[\s\S]+?```/g) || []).length >= 2
+  },
+  // Reasoning Patterns (Important)
+  {
+    name: "Step-by-Step Process",
+    weight: 0.7,
+    required: !1,
+    check: (n) => /^\d+\. /gm.test(n) || /first|then|next|finally/i.test(n)
+  },
+  {
+    name: "Thinking/Planning Phase",
+    weight: 0.6,
+    required: !1,
+    check: (n) => /<thinking>|before .+?, (think|plan|analyze)/i.test(n)
+  },
+  {
+    name: "Confirmation Gates",
+    weight: 0.8,
+    required: !1,
+    check: (n) => /confirmation|preview|show .+? before|ask .+? before/i.test(n)
+  },
+  // Safety Protocols (Critical)
+  {
+    name: "Refusal Guidelines",
+    weight: 1,
+    required: !0,
+    check: (n) => /refuse|decline|cannot (assist|help) with|inappropriate/i.test(n)
+  },
+  {
+    name: "Destructive Action Warnings",
+    weight: 0.9,
+    required: !1,
+    check: (n) => /warning|caution|delete|remove|overwrite/i.test(n)
+  },
+  // Tone & Style (Moderate)
+  {
+    name: "Communication Style",
+    weight: 0.5,
+    required: !1,
+    check: (n) => /concise|brief|direct|friendly|professional|tone/i.test(n)
+  },
+  {
+    name: "Forbidden Phrases",
+    weight: 0.4,
+    required: !1,
+    check: (n) => /do not (say|use|start with)|avoid (saying|phrases like)/i.test(n)
+  }
+];
+function $(n) {
+  const e = te.map((d) => ({
+    element: d,
+    passed: d.check(n)
+  })), t = e.filter(
+    (d) => ["Clear Headings", "Structured Sections"].includes(d.element.name)
+  ), s = F(t), i = e.filter(
+    (d) => ["Concrete Examples", "Communication Style", "Forbidden Phrases"].includes(
+      d.element.name
+    )
+  ), r = F(i), o = e.filter((d) => d.element.required), a = F(o), c = Math.round(
+    s * 0.3 + r * 0.2 + a * 0.5
+  ), l = e.filter((d) => d.element.required && !d.passed).map((d) => d.element.name), u = se(e, n);
+  return {
+    overallScore: c,
+    structureScore: s,
+    clarityScore: r,
+    completenessScore: a,
+    recommendations: u,
+    missingElements: l
+  };
+}
+function F(n) {
+  if (n.length === 0) return 100;
+  const e = n.reduce((s, i) => s + i.element.weight, 0), t = n.filter((s) => s.passed).reduce((s, i) => s + i.element.weight, 0);
+  return Math.round(t / e * 100);
+}
+function se(n, e) {
+  const t = [], s = n.filter(
+    (a) => a.element.required && !a.passed
+  );
+  s.length > 0 && t.push(
+    `Add ${s.length} critical element(s): ${s.map((a) => a.element.name).join(", ")}`
+  ), n.find((a) => a.element.name === "Expert Identity")?.passed || t.push(
+    'Add expert identity: Start with "You are an expert [domain] specialist..."'
+  ), n.find((a) => a.element.name === "Tool Documentation")?.passed || t.push(
+    "Add tool documentation: Include function schemas with parameters and examples"
+  ), n.find((a) => a.element.name === "Refusal Guidelines")?.passed || t.push(
+    "Add refusal guidelines: Specify what requests should be declined and how"
+  );
+  const i = (e.match(/```[\s\S]+?```/g) || []).length;
+  i < 3 && t.push(
+    `Add more code examples: Currently ${i}, aim for at least 5 concrete examples`
+  ), /✅|❌|good:|bad:/i.test(e) || t.push(
+    "Add ✅/❌ comparisons: Show good vs bad examples for clarity"
+  );
+  const o = e.split(/\s+/).length;
+  return o < 500 ? t.push(
+    `Instructions may be too brief (${o} words). Aim for 1000-3000 words for comprehensive guidance.`
+  ) : o > 5e3 && t.push(
+    `Instructions may be too long (${o} words). Consider breaking into sections or modules.`
+  ), n.find((a) => a.element.name === "Confirmation Gates")?.passed || t.push(
+    "Consider adding confirmation gates for destructive operations (delete, overwrite)"
+  ), t.length === 0 && t.push(
+    "Instructions meet quality standards. Consider A/B testing variants for optimization."
+  ), t;
+}
+function Ce(n, e = 70) {
+  return $(n).overallScore >= e;
+}
+function ne(n) {
+  return n >= 90 ? "A" : n >= 80 ? "B" : n >= 70 ? "C" : n >= 60 ? "D" : "F";
+}
+function Fe(n) {
+  const e = [];
+  if (e.push(`=== Instruction Quality Report ===
+`), e.push(
+    `Overall Score: ${n.overallScore}/100 (${ne(n.overallScore)})
+`
+  ), e.push(`  Structure:    ${n.structureScore}/100`), e.push(`  Clarity:      ${n.clarityScore}/100`), e.push(`  Completeness: ${n.completenessScore}/100
+`), n.missingElements.length > 0) {
+    e.push("❌ Missing Critical Elements:");
+    for (const t of n.missingElements)
+      e.push(`   - ${t}`);
+    e.push("");
+  }
+  if (n.recommendations.length > 0) {
+    e.push("💡 Recommendations:");
+    for (const t of n.recommendations)
+      e.push(`   - ${t}`);
+    e.push("");
+  }
+  return e.join(`
+`);
+}
+let ie = class {
+  constructor() {
+    this.plugins = /* @__PURE__ */ new Map();
+  }
+  /**
+   * Register a new detection plugin.
+   * @param plugin The plugin to register
+   */
+  register(e) {
+    this.plugins.has(e.name) && console.warn(
+      `Plugin "${e.name}" is already registered. Overwriting.`
+    ), this.plugins.set(e.name, e);
+  }
+  /**
+   * Unregister a plugin by name.
+   * @param name Plugin name to unregister
+   */
+  unregister(e) {
+    return this.plugins.delete(e);
+  }
+  /**
+   * Get a plugin by name.
+   * @param name Plugin name
+   */
+  get(e) {
+    return this.plugins.get(e);
+  }
+  /**
+   * Get all registered plugins.
+   */
+  getAll() {
+    return Array.from(this.plugins.values());
+  }
+  /**
+   * Clear all registered plugins.
+   */
+  clear() {
+    this.plugins.clear();
+  }
+  /**
+   * Get the number of registered plugins.
+   */
+  get size() {
+    return this.plugins.size;
+  }
+};
+const h = new ie();
+class re {
+  constructor(e, t = /* @__PURE__ */ new Map()) {
+    this.analysisData = e, this.fileContentCache = t;
+  }
+  get files() {
+    return this.analysisData.projectFiles;
+  }
+  get dependencies() {
+    return this.analysisData.dependencies;
+  }
+  get configFiles() {
+    return this.analysisData.configFiles;
+  }
+  getTextFile(e) {
+    return this.fileContentCache.has(e) && this.fileContentCache.get(e) || null;
+  }
+  hasFile(e) {
+    return this.analysisData.projectFiles.includes(e) || this.analysisData.configFiles.includes(e);
+  }
+  matchesPattern(e) {
+    const t = this.globToRegex(e);
+    return this.analysisData.projectFiles.some((s) => t.test(s));
+  }
+  globToRegex(e) {
+    const t = e.replace(/\\/g, "\\\\").replace(/\*\*/g, "§DOUBLESTAR§").replace(/\*/g, "[^/]*").replace(/§DOUBLESTAR§/g, ".*").replace(/\./g, "\\.");
+    return new RegExp(`^${t}$`);
+  }
+}
+async function je(n, e) {
+  const t = /* @__PURE__ */ new Set(), s = [], i = /* @__PURE__ */ new Map(), r = /* @__PURE__ */ new Map();
+  if (e)
+    for (const c of n.configFiles) {
+      const l = e(c);
+      l && r.set(c, l);
+    }
+  const o = new re(n, r);
+  if (e) {
+    const c = o.getTextFile.bind(o);
+    o.getTextFile = (l) => {
+      const u = c(l);
+      return u !== null ? u : e(l);
+    };
+  }
+  const a = h.getAll();
+  for (const c of a)
+    try {
+      const l = await Promise.resolve(c.detect(o));
+      if (l.detected) {
+        if (l.tags)
+          for (const d of l.tags)
+            t.add(d);
+        l.metadata && i.set(c.name, l.metadata);
+        const u = await Promise.resolve(
+          c.generateInstructions(o, l.metadata)
+        );
+        s.push(...u);
+      }
+    } catch (l) {
+      console.error(`Error running plugin ${c.name}:`, l);
+    }
+  return {
+    tags: t,
+    instructions: s,
+    metadata: i
+  };
+}
+function Ee() {
+  import("./index-B88j4AyE.js").then((n) => {
+    h.register(new n.GolangPlugin()), h.register(new n.PythonPlugin()), h.register(new n.RustPlugin()), h.register(new n.PHPPlugin()), h.register(new n.DockerPlugin()), h.register(new n.GitHubActionsPlugin()), h.register(new n.GitLabCIPlugin()), h.register(new n.MonorepoPlugin()), h.register(new n.CodeOwnersPlugin());
+  });
+}
+class xe {
+  constructor() {
+    this.name = "codeowners", this.description = "Detects CODEOWNERS file and provides code ownership instructions", this.version = "1.0.0";
+  }
+  detect(e) {
+    if (!(e.hasFile(".github/CODEOWNERS") || e.hasFile("CODEOWNERS") || e.hasFile("docs/CODEOWNERS")))
+      return { detected: !1 };
+    const s = {
+      hasCodeOwners: !0
+    };
+    let i = "";
+    e.hasFile(".github/CODEOWNERS") ? i = ".github/CODEOWNERS" : e.hasFile("CODEOWNERS") ? i = "CODEOWNERS" : i = "docs/CODEOWNERS", s.location = i;
+    const r = e.getTextFile(i);
+    if (r) {
+      const a = r.split(`
+`).filter(
+        (l) => l.trim() && !l.trim().startsWith("#")
+      );
+      s.ruleCount = a.length;
+      const c = /* @__PURE__ */ new Set();
+      for (const l of a) {
+        const u = l.trim().split(/\s+/);
+        if (u.length > 1)
+          for (const d of u.slice(1))
+            d.startsWith("@") && c.add(d);
+      }
+      s.ownerCount = c.size, s.owners = Array.from(c).slice(0, 10);
+    }
+    return {
+      detected: !0,
+      tags: ["architecture-codeowners"],
+      metadata: s
+    };
+  }
+  generateInstructions(e, t) {
+    return [
+      {
+        template: "architecture/codeowners.md",
+        suffix: "codeowners.md",
+        targetFiles: [".github/CODEOWNERS", "CODEOWNERS", "docs/CODEOWNERS"]
+      }
+    ];
+  }
+}
+class Te {
+  constructor() {
+    this.name = "docker", this.description = "Detects Docker usage and provides Docker-specific instructions", this.version = "1.0.0";
+  }
+  detect(e) {
+    const t = e.hasFile("Dockerfile") || e.matchesPattern("**/Dockerfile"), s = e.hasFile("docker-compose.yml") || e.hasFile("docker-compose.yaml") || e.hasFile("compose.yml") || e.hasFile("compose.yaml"), i = e.hasFile(".dockerignore");
+    if (!(t || s))
+      return { detected: !1 };
+    const o = {
+      hasDockerfile: t,
+      hasDockerCompose: s,
+      hasDockerignore: i
+    };
+    if (t) {
+      const a = e.getTextFile("Dockerfile");
+      if (a) {
+        const c = (a.match(/FROM\s+\S+\s+AS\s+\S+/gi) || []).length;
+        c > 0 && (o.multiStage = !0, o.stageCount = c);
+      }
+    }
+    return {
+      detected: !0,
+      tags: ["devops-docker"],
+      metadata: o
+    };
+  }
+  generateInstructions(e, t) {
+    const s = [];
+    return t?.hasDockerfile && s.push({
+      template: "devops/docker-dockerfile.md",
+      suffix: "docker-dockerfile.md",
+      targetFiles: ["**/Dockerfile"]
+    }), t?.hasDockerCompose && s.push({
+      template: "devops/docker-compose.md",
+      suffix: "docker-compose.md",
+      targetFiles: [
+        "**/docker-compose.yml",
+        "**/docker-compose.yaml",
+        "**/compose.yml",
+        "**/compose.yaml"
+      ]
+    }), s;
+  }
+}
+class $e {
+  constructor() {
+    this.name = "github-actions", this.description = "Detects GitHub Actions workflows and provides CI/CD-specific instructions", this.version = "1.0.0";
+  }
+  detect(e) {
+    if (!(e.matchesPattern(".github/workflows/*.yml") || e.matchesPattern(".github/workflows/*.yaml")))
+      return { detected: !1 };
+    const s = {
+      hasWorkflows: !0
+    }, i = e.files.filter(
+      (r) => r.startsWith(".github/workflows/") && (r.endsWith(".yml") || r.endsWith(".yaml"))
+    );
+    if (i.length > 0) {
+      s.workflowCount = i.length, s.workflowFiles = i;
+      const r = e.getTextFile(i[0]);
+      r && (s.hasMatrixStrategy = r.includes("strategy:") && r.includes("matrix:"), s.hasCaching = r.includes("actions/cache") || r.includes("cache:"), s.hasArtifacts = r.includes("actions/upload-artifact") || r.includes("actions/download-artifact"));
+    }
+    return {
+      detected: !0,
+      tags: ["devops-github-actions", "ci-cd"],
+      metadata: s
+    };
+  }
+  generateInstructions(e, t) {
+    return [
+      {
+        template: "devops/github-actions.md",
+        suffix: "github-actions.md",
+        targetFiles: [".github/workflows/*.yml", ".github/workflows/*.yaml"]
+      }
+    ];
+  }
+}
+class Ie {
+  constructor() {
+    this.name = "gitlab-ci", this.description = "Detects GitLab CI/CD configuration and provides CI/CD-specific instructions", this.version = "1.0.0";
+  }
+  detect(e) {
+    if (!e.hasFile(".gitlab-ci.yml"))
+      return { detected: !1 };
+    const s = {
+      hasGitLabCI: !0
+    }, i = e.getTextFile(".gitlab-ci.yml");
+    if (i) {
+      i.match(/^stages:\s*$/m) && (s.hasStages = !0), s.hasCache = i.includes("cache:"), s.hasArtifacts = i.includes("artifacts:"), s.hasServices = i.includes("services:"), s.hasIncludes = i.includes("include:");
+      const o = i.match(
+        /^stages:\s*\n((?: {2}- .+\n?)+)/m
+      );
+      if (o) {
+        const a = o[1].match(/- (.+)/g)?.map((c) => c.replace(/- /, "").trim());
+        a && (s.stages = a);
+      }
+    }
+    return {
+      detected: !0,
+      tags: ["devops-gitlab-ci", "ci-cd"],
+      metadata: s
+    };
+  }
+  generateInstructions(e, t) {
+    return [
+      {
+        template: "devops/gitlab-ci.md",
+        suffix: "gitlab-ci.md",
+        targetFiles: [".gitlab-ci.yml"]
+      }
+    ];
+  }
+}
+class De {
+  constructor() {
+    this.name = "golang", this.description = "Detects Go (Golang) projects and provides Go-specific instructions", this.version = "1.0.0";
+  }
+  detect(e) {
+    const t = e.hasFile("go.mod"), s = e.matchesPattern("**/*.go");
+    if (!(t || s))
+      return { detected: !1 };
+    const r = e.getTextFile("go.mod"), o = {
+      hasGoMod: t,
+      hasGoFiles: s
+    };
+    if (r) {
+      const a = r.match(/^module\s+(.+)$/m);
+      a && (o.moduleName = a[1].trim());
+      const c = r.match(/^go\s+([\d.]+)$/m);
+      c && (o.goVersion = c[1]);
+    }
+    return {
+      detected: !0,
+      tags: ["lang-go"],
+      metadata: o
+    };
+  }
+  generateInstructions(e, t) {
+    return [
+      {
+        template: "go/lang-go.md",
+        suffix: "lang-go.md",
+        targetFiles: ["**/*.go"]
+      }
+    ];
+  }
+}
+class Le {
+  constructor() {
+    this.name = "monorepo", this.description = "Detects monorepo structures and provides monorepo-specific instructions", this.version = "1.0.0";
+  }
+  detect(e) {
+    const t = e.hasFile("turbo.json"), s = e.hasFile("nx.json"), i = e.hasFile("pnpm-workspace.yaml"), r = e.hasFile("lerna.json"), o = e.hasFile("package.json") && e.getTextFile("package.json")?.includes('"workspaces"');
+    if (e.hasFile("package.json") && e.getTextFile("package.json")?.includes('"workspaces"'), !(t || s || i || r || o))
+      return { detected: !1 };
+    const c = {
+      hasTurbo: t,
+      hasNx: s,
+      hasPnpmWorkspace: i,
+      hasLerna: r,
+      hasYarnWorkspaces: o
+    };
+    if (t) {
+      c.tool = "turborepo";
+      const d = e.getTextFile("turbo.json");
+      d && (c.hasPipeline = d.includes('"pipeline"'));
+    } else s ? c.tool = "nx" : i ? c.tool = "pnpm" : r ? c.tool = "lerna" : c.tool = "npm/yarn workspaces";
+    const l = ["packages/*/package.json", "apps/*/package.json"], u = e.files.filter(
+      (d) => l.some((f) => new RegExp(f.replace(/\*/g, "[^/]+")).test(d))
+    );
+    return u.length > 0 && (c.packageCount = u.length), {
+      detected: !0,
+      tags: ["architecture-monorepo"],
+      metadata: c
+    };
+  }
+  generateInstructions(e, t) {
+    const s = [
+      {
+        template: "architecture/monorepo.md",
+        suffix: "monorepo.md",
+        targetFiles: [
+          "package.json",
+          "turbo.json",
+          "nx.json",
+          "pnpm-workspace.yaml",
+          "lerna.json"
+        ]
+      }
+    ];
+    return t?.tool === "turborepo" ? s.push({
+      template: "architecture/turborepo.md",
+      suffix: "turborepo.md",
+      targetFiles: ["turbo.json"]
+    }) : t?.tool === "nx" && s.push({
+      template: "architecture/nx.md",
+      suffix: "nx.md",
+      targetFiles: ["nx.json", "workspace.json"]
+    }), s;
+  }
+}
+class Me {
+  constructor() {
+    this.name = "php", this.description = "Detects PHP projects and provides PHP-specific instructions", this.version = "1.0.0";
+  }
+  detect(e) {
+    const t = e.hasFile("composer.json"), s = e.hasFile("composer.lock"), i = e.matchesPattern("**/*.php");
+    if (!(t || i))
+      return { detected: !1 };
+    const o = {
+      hasComposerJson: t,
+      hasComposerLock: s,
+      hasPhpFiles: i
+    }, a = e.getTextFile("composer.json");
+    if (a) {
+      a.includes('"laravel/framework"') ? (o.framework = "laravel", o.hasArtisan = e.hasFile("artisan")) : a.includes('"symfony/') && (o.framework = "symfony");
+      const c = a.match(/"name"\s*:\s*"([^"]+)"/);
+      c && (o.projectName = c[1]);
+    }
+    return {
+      detected: !0,
+      tags: ["lang-php"],
+      metadata: o
+    };
+  }
+  generateInstructions(e, t) {
+    const s = [
+      {
+        template: "php/lang-php.md",
+        suffix: "lang-php.md",
+        targetFiles: ["**/*.php"]
+      }
+    ];
+    return t?.framework === "laravel" && s.push({
+      template: "php/framework-laravel.md",
+      suffix: "framework-laravel.md",
+      targetFiles: ["**/*.php"]
+    }), s;
+  }
+}
+class Oe {
+  constructor() {
+    this.name = "python", this.description = "Detects Python projects and provides Python-specific instructions", this.version = "1.0.0";
+  }
+  detect(e) {
+    const t = e.hasFile("pyproject.toml"), s = e.hasFile("requirements.txt"), i = e.hasFile("setup.py"), r = e.hasFile("Pipfile"), o = e.matchesPattern("**/*.py");
+    if (!(t || s || i || r || o))
+      return { detected: !1 };
+    const c = {
+      hasPyprojectToml: t,
+      hasRequirementsTxt: s,
+      hasSetupPy: i,
+      hasPipfile: r,
+      hasPyFiles: o
+    };
+    if (t) {
+      const d = e.getTextFile("pyproject.toml");
+      d && (d.includes("[tool.poetry]") ? c.packageManager = "poetry" : d.includes("[build-system]") && (c.packageManager = "pip"));
+    } else r ? c.packageManager = "pipenv" : s && (c.packageManager = "pip");
+    const l = [], u = e.getTextFile("requirements.txt");
+    return u && (u.includes("django") && l.push("django"), u.includes("flask") && l.push("flask"), u.includes("fastapi") && l.push("fastapi")), l.length > 0 && (c.frameworks = l), {
+      detected: !0,
+      tags: ["lang-python"],
+      metadata: c
+    };
+  }
+  generateInstructions(e, t) {
+    return [
+      {
+        template: "python/lang-python.md",
+        suffix: "lang-python.md",
+        targetFiles: ["**/*.py"]
+      }
+    ];
+  }
+}
+class Re {
+  constructor() {
+    this.name = "rust", this.description = "Detects Rust projects and provides Rust-specific instructions", this.version = "1.0.0";
+  }
+  detect(e) {
+    const t = e.hasFile("Cargo.toml"), s = e.hasFile("Cargo.lock"), i = e.matchesPattern("**/*.rs");
+    if (!(t || i))
+      return { detected: !1 };
+    const o = e.getTextFile("Cargo.toml"), a = {
+      hasCargoToml: t,
+      hasCargoLock: s,
+      hasRustFiles: i
+    };
+    if (o) {
+      const c = o.match(
+        /^\[package\][\s\S]*?^name\s*=\s*"(.+?)"/m
+      );
+      c && (a.packageName = c[1]);
+      const l = o.match(/^edition\s*=\s*"(\d+)"/m);
+      l && (a.edition = l[1]), o.includes("[workspace]") && (a.isWorkspace = !0);
+    }
+    return {
+      detected: !0,
+      tags: ["lang-rust"],
+      metadata: a
+    };
+  }
+  generateInstructions(e, t) {
+    return [
+      {
+        template: "rust/lang-rust.md",
+        suffix: "lang-rust.md",
+        targetFiles: ["**/*.rs"]
+      }
+    ];
+  }
+}
+class x {
+  constructor(e = {}) {
+    this.loadedPlugins = /* @__PURE__ */ new Map(), this.loadErrors = [], this.verbose = e.verbose ?? !1;
+  }
+  /**
+   * Load built-in plugins from the @el-j/magic-helix-plugins package
+   * Loads all exported plugin classes from the package
+   */
+  async loadBuiltinPlugins(e) {
+    const t = [];
+    try {
+      const s = await this.tryImport("@el-j/magic-helix-plugins");
+      if (!s)
+        return t;
+      const i = Object.entries(s).filter(([r, o]) => r !== "BasePlugin" && typeof o == "function" && r.endsWith("Plugin")).map(([r, o]) => o);
+      for (const r of i) {
+        const o = new r();
+        if (e && !e.includes(o.name))
+          continue;
+        const a = {
+          plugin: o,
+          source: {
+            type: "npm",
+            identifier: o.name,
+            packageName: "@el-j/magic-helix-plugins"
+          },
+          loadTime: 0
+        };
+        this.loadedPlugins.set(o.name, a), t.push(a), this.log(
+          `Loaded built-in plugin: ${o.displayName} (${o.name})`
+        );
+      }
+    } catch (s) {
+      this.handleLoadError(
+        {
+          type: "npm",
+          identifier: "@el-j/magic-helix-plugins",
+          packageName: "@el-j/magic-helix-plugins"
+        },
+        s
+      );
+    }
+    return t;
+  }
+  /**
+   * Load a plugin from an npm package
+   */
+  async loadNpmPlugin(e) {
+    try {
+      const t = Date.now(), s = await this.tryImport(e);
+      if (!s)
+        throw new Error(`Package "${e}" not found`);
+      const i = s.default || s.Plugin || s;
+      if (typeof i != "function")
+        throw new Error(
+          `Package "${e}" does not export a valid plugin class`
+        );
+      const r = new i(), o = Date.now() - t;
+      this.validatePlugin(r);
+      const a = {
+        plugin: r,
+        source: {
+          type: "npm",
+          identifier: e,
+          packageName: e
+        },
+        loadTime: o
+      };
+      return this.loadedPlugins.set(r.name, a), this.log(
+        `✓ Loaded npm plugin: ${r.displayName} from ${e} (${o}ms)`
+      ), a;
+    } catch (t) {
+      return this.handleLoadError(
+        {
+          type: "npm",
+          identifier: e,
+          packageName: e
+        },
+        t
+      ), null;
+    }
+  }
+  /**
+   * Load a plugin from a local file path
+   */
+  async loadLocalPlugin(e) {
+    try {
+      const t = g.resolve(e);
+      if (!p.existsSync(t))
+        throw new Error(`Plugin file not found: ${t}`);
+      const s = Date.now(), i = await import(t), r = Date.now() - s, o = i.default || i.Plugin || i;
+      if (typeof o != "function")
+        throw new Error(
+          `File "${e}" does not export a valid plugin class`
+        );
+      const a = new o();
+      this.validatePlugin(a);
+      const c = {
+        plugin: a,
+        source: {
+          type: "local",
+          identifier: e,
+          path: t
+        },
+        loadTime: r
+      };
+      return this.loadedPlugins.set(a.name, c), this.log(
+        `✓ Loaded local plugin: ${a.displayName} from ${e} (${r}ms)`
+      ), c;
+    } catch (t) {
+      return this.handleLoadError(
+        {
+          type: "local",
+          identifier: e,
+          path: e
+        },
+        t
+      ), null;
+    }
+  }
+  /**
+   * Load plugins from workspace directory
+   */
+  async loadWorkspacePlugins(e, t) {
+    const s = [], i = t || [
+      ".magic-helix/plugins/**/*.js",
+      ".magic-helix/plugins/**/*.mjs"
+    ];
+    try {
+      const { glob: r } = await import("glob");
+      for (const o of i) {
+        const a = await r(o, {
+          cwd: e,
+          absolute: !0
+        });
+        for (const c of a) {
+          const l = await this.loadLocalPlugin(c);
+          l && (l.source.type = "workspace", s.push(l));
+        }
+      }
+    } catch (r) {
+      this.logWarning(
+        `Error loading workspace plugins: ${r.message}`
+      );
+    }
+    return s;
+  }
+  /**
+   * Get a loaded plugin by name
+   */
+  getPlugin(e) {
+    return this.loadedPlugins.get(e)?.plugin;
+  }
+  /**
+   * Get all loaded plugins sorted by priority (highest first)
+   */
+  getAllPlugins() {
+    return Array.from(this.loadedPlugins.values()).map((e) => e.plugin).sort((e, t) => t.priority - e.priority);
+  }
+  /**
+   * Get plugins filtered by name
+   */
+  getPluginsByNames(e) {
+    return e.map((t) => this.getPlugin(t)).filter((t) => t !== void 0);
+  }
+  /**
+   * Detect project using all loaded plugins
+   * Returns the first successful detection from highest priority plugin
+   */
+  async detectProject(e) {
+    const t = this.getAllPlugins();
+    for (const s of t)
+      try {
+        this.log(`Trying plugin: ${s.displayName}`);
+        const i = await s.detect(e);
+        if (i)
+          return this.log(
+            `✓ Detected ${i.language} project with ${s.displayName}`
+          ), { metadata: i, plugin: s };
+      } catch (i) {
+        this.logWarning(
+          `Plugin ${s.name} detection failed: ${i.message}`
+        );
+      }
+    return null;
+  }
+  /**
+   * Recursively scan directories for project manifests
+   */
+  async scanForProjects(e, t = 5) {
+    const s = /* @__PURE__ */ new Set(), i = /* @__PURE__ */ new Set(), r = [
+      "package.json",
+      "Cargo.toml",
+      "go.mod",
+      "go.sum",
+      "setup.py",
+      "pyproject.toml",
+      "requirements.txt",
+      "pom.xml",
+      "build.gradle",
+      "build.gradle.kts",
+      "Package.swift",
+      "Gemfile",
+      "composer.json",
+      "CMakeLists.txt",
+      "Makefile",
+      "platformio.ini"
+    ], o = /* @__PURE__ */ new Set([
+      "node_modules",
+      "target",
+      "dist",
+      "build",
+      ".git",
+      ".svn",
+      ".hg",
+      "vendor",
+      "__pycache__",
+      ".venv",
+      "venv",
+      "env",
+      ".cargo",
+      ".gradle"
+    ]), a = async (c, l) => {
+      if (l > t) return;
+      const u = g.normalize(c);
+      if (!i.has(u)) {
+        i.add(u);
+        try {
+          const d = await p.promises.readdir(c, {
+            withFileTypes: !0
+          });
+          let f = !1;
+          for (const m of d)
+            if (!m.isDirectory() && r.includes(m.name)) {
+              s.add(c), f = !0;
+              break;
+            }
+          for (const m of d)
+            if (m.isDirectory() && !o.has(m.name)) {
+              const D = g.join(c, m.name);
+              await a(D, l + 1);
+            }
+        } catch {
+          return;
+        }
+      }
+    };
+    return await a(e, 0), Array.from(s).sort();
+  }
+  /**
+   * Detect all projects in a directory (for monorepo support)
+   * Enhanced version that recursively scans for ALL project types
+   */
+  async detectAllProjects(e) {
+    const t = [], s = /* @__PURE__ */ new Set(), i = this.getAllPlugins();
+    for (const r of i)
+      try {
+        const o = await r.detect(e);
+        if (o && (s.add(o.projectPath), t.push({ metadata: o, plugin: r }), o.workspaceMembers && o.workspaceMembers.length > 0))
+          for (const a of o.workspaceMembers) {
+            const c = g.resolve(e, a);
+            if (!s.has(c)) {
+              const l = await this.detectProject(c);
+              l && (s.add(l.metadata.projectPath), t.push(l));
+            }
+          }
+      } catch (o) {
+        this.logWarning(
+          `Plugin ${r.name} failed: ${o.message}`
+        );
+      }
+    try {
+      const r = await this.scanForProjects(e);
+      for (const o of r)
+        if (!s.has(o)) {
+          const a = await this.detectProject(o);
+          a && (s.add(a.metadata.projectPath), t.push(a));
+        }
+    } catch (r) {
+      this.logWarning(`Recursive scan failed: ${r.message}`);
+    }
+    return t;
+  }
+  /**
+   * Get load errors
+   */
+  getLoadErrors() {
+    return [...this.loadErrors];
+  }
+  /**
+   * Clear all loaded plugins
+   */
+  clear() {
+    this.loadedPlugins.clear(), this.loadErrors = [];
+  }
+  /**
+   * Get statistics about loaded plugins
+   */
+  getStats() {
+    const e = Array.from(this.loadedPlugins.values()), t = {};
+    for (const s of e)
+      t[s.source.type] = (t[s.source.type] || 0) + 1;
+    return {
+      totalLoaded: e.length,
+      totalErrors: this.loadErrors.length,
+      averageLoadTime: e.length > 0 ? e.reduce((s, i) => s + i.loadTime, 0) / e.length : 0,
+      byType: t
+    };
+  }
+  // Private helper methods
+  validatePlugin(e) {
+    if (!e || typeof e != "object")
+      throw new Error("Plugin must be an object");
+    const t = e;
+    if (!t.name || typeof t.name != "string")
+      throw new Error('Plugin must have a "name" property');
+    if (!t.displayName || typeof t.displayName != "string")
+      throw new Error('Plugin must have a "displayName" property');
+    if (!t.version || typeof t.version != "string")
+      throw new Error('Plugin must have a "version" property');
+    if (typeof t.priority != "number")
+      throw new Error('Plugin must have a "priority" property');
+    if (typeof t.detect != "function")
+      throw new Error('Plugin must implement "detect" method');
+    if (typeof t.getTemplates != "function")
+      throw new Error('Plugin must implement "getTemplates" method');
+  }
+  async tryImport(e) {
+    try {
+      return await import(e);
+    } catch {
+      return null;
+    }
+  }
+  handleLoadError(e, t) {
+    this.loadErrors.push({
+      source: e,
+      error: t,
+      timestamp: /* @__PURE__ */ new Date()
+    }), this.logWarning(
+      `Failed to load plugin "${e.identifier}": ${t.message}`
+    );
+  }
+  log(e) {
+    this.verbose && console.log(`[PluginLoader] ${e}`);
+  }
+  logWarning(e) {
+    this.verbose && console.warn(`[PluginLoader] ⚠️  ${e}`);
+  }
+}
+const y = class y {
+  constructor() {
+    this.initialized = !1, this.loader = new x({ verbose: !1 }), this.config = {};
+  }
+  /**
+   * Get the singleton instance
+   */
+  static getInstance() {
+    return y.instance || (y.instance = new y()), y.instance;
+  }
+  /**
+   * Initialize the registry with configuration
+   */
+  async initialize(e = {}) {
+    if (!this.initialized && (this.config = e, this.loader = new x({ verbose: e.verbose }), await this.loadConfiguredPlugins(e.plugins), this.initialized = !0, e.verbose)) {
+      const t = this.loader.getStats();
+      console.log(
+        `[PluginRegistry] Initialized with ${t.totalLoaded} plugins`
+      ), console.log(
+        `[PluginRegistry] Load time: ${t.averageLoadTime.toFixed(2)}ms avg`
+      );
+    }
+  }
+  /**
+   * Reset the registry (useful for testing)
+   */
+  reset() {
+    this.loader.clear(), this.initialized = !1, this.config = {};
+  }
+  /**
+   * Ensure the registry is initialized before use
+   */
+  async ensureInitialized() {
+    this.initialized || await this.initialize();
+  }
+  /**
+   * Get a plugin by name
+   */
+  async getPlugin(e) {
+    return await this.ensureInitialized(), this.loader.getPlugin(e);
+  }
+  /**
+   * Get all loaded plugins
+   */
+  async getAllPlugins() {
+    return await this.ensureInitialized(), this.loader.getAllPlugins();
+  }
+  /**
+   * Detect the project type at the given path
+   */
+  async detectProject(e) {
+    return await this.ensureInitialized(), this.loader.detectProject(e);
+  }
+  /**
+   * Detect all projects in a directory (monorepo support)
+   */
+  async detectAllProjects(e) {
+    return await this.ensureInitialized(), this.loader.detectAllProjects(e);
+  }
+  /**
+   * Get the best plugin for a detected project language
+   */
+  async getPluginForLanguage(e) {
+    await this.ensureInitialized();
+    const t = this.loader.getAllPlugins();
+    let s = t.find((i) => i.name === e.toLowerCase());
+    return s || (s = t.find(
+      (i) => i.displayName.toLowerCase() === e.toLowerCase()
+    ), s) || (s = t.find(
+      (i) => i.displayName.toLowerCase().includes(e.toLowerCase()) || e.toLowerCase().includes(i.name)
+    )), s;
+  }
+  /**
+   * Load a custom plugin at runtime
+   */
+  async loadPlugin(e) {
+    return await this.ensureInitialized(), (e.type === "npm" ? await this.loader.loadNpmPlugin(e.path) : await this.loader.loadLocalPlugin(e.path))?.plugin ?? null;
+  }
+  /**
+   * Get registry statistics
+   */
+  async getStats() {
+    await this.ensureInitialized();
+    const e = this.loader.getStats();
+    return {
+      totalPlugins: e.totalLoaded,
+      loadErrors: e.totalErrors,
+      averageLoadTime: e.averageLoadTime,
+      pluginsByType: e.byType
+    };
+  }
+  /**
+   * Get load errors
+   */
+  async getLoadErrors() {
+    return await this.ensureInitialized(), this.loader.getLoadErrors().map((e) => ({
+      source: e.source.identifier,
+      error: e.error.message,
+      timestamp: e.timestamp
+    }));
+  }
+  /**
+   * Get plugin system statistics
+   */
+  getStatistics() {
+    return this.loader.getStats();
+  }
+  // Private helper methods
+  /**
+   * Load plugins based on configuration
+   */
+  async loadConfiguredPlugins(e = {}) {
+    const {
+      builtin: t = [],
+      npm: s = [],
+      local: i = [],
+      workspace: r = [],
+      disabled: o = []
+    } = e;
+    if (t.length > 0) {
+      const a = t.filter(
+        (c) => !o.includes(c)
+      );
+      await this.loader.loadBuiltinPlugins(a);
+    } else
+      await this.loader.loadBuiltinPlugins();
+    for (const a of s)
+      o.includes(a) || await this.loader.loadNpmPlugin(a);
+    for (const a of i)
+      if (!o.includes(a)) {
+        const c = this.resolvePath(a);
+        await this.loader.loadLocalPlugin(c);
+      }
+    this.config.workspacePath && r.length > 0 && await this.loader.loadWorkspacePlugins(
+      this.config.workspacePath,
+      r
+    ), e.priority && this.applyPriorityOverrides(e.priority);
+  }
+  /**
+   * Resolve plugin path (handle ~/ and relative paths)
+   */
+  resolvePath(e) {
+    if (e.startsWith("~/")) {
+      const s = process.env.HOME || process.env.USERPROFILE || "";
+      return g.join(s, e.slice(2));
+    }
+    if (g.isAbsolute(e))
+      return e;
+    const t = this.config.workspacePath || process.cwd();
+    return g.resolve(t, e);
+  }
+  /**
+   * Apply priority overrides from configuration
+   */
+  applyPriorityOverrides(e) {
+    for (const [t, s] of Object.entries(e)) {
+      const i = this.loader.getPlugin(t);
+      i && (i.priority = s);
+    }
+  }
+  /**
+   * Load configuration from file
+   */
+  static async loadConfigFromFile(e) {
+    try {
+      if (!p.existsSync(e))
+        return null;
+      const t = p.readFileSync(e, "utf-8");
+      return JSON.parse(t);
+    } catch (t) {
+      return console.warn(
+        `Failed to load config from ${e}: ${t.message}`
+      ), null;
+    }
+  }
+  /**
+   * Load configuration from workspace and global locations
+   */
+  static async loadConfig(e) {
+    const t = [], s = process.env.HOME || process.env.USERPROFILE;
+    if (s) {
+      const i = g.join(
+        s,
+        ".magic-helix",
+        "config.json"
+      ), r = await y.loadConfigFromFile(i);
+      r && t.push(r);
+    }
+    if (e) {
+      const i = g.join(e, ".magic-helix.json"), r = await y.loadConfigFromFile(i);
+      r && (r.workspacePath = e, t.push(r));
+    }
+    return t.length === 0 ? { workspacePath: e } : t.reduce(
+      (i, r) => {
+        const o = {
+          ...i.plugins || {},
+          ...r.plugins || {}
+        }, a = {
+          ...i.templates || {},
+          ...r.templates || {}
+        };
+        return i.plugins = o, i.templates = a, Object.assign(i, r, {
+          plugins: o,
+          templates: a
+        }), i;
+      },
+      { workspacePath: e }
+    );
+  }
+};
+y.instance = null;
+let b = y;
+function _e() {
+  return b.getInstance();
+}
+async function Ae(n) {
+  const e = b.getInstance();
+  return await e.initialize(n), e;
+}
+class We {
+  constructor(e = {}) {
+    this.templateCache = /* @__PURE__ */ new Map(), this.config = e.config || {}, this.verbose = e.verbose ?? !1, this.cacheEnabled = e.cacheEnabled ?? !0;
+  }
+  /**
+   * Load a template by name with priority resolution
+   */
+  async loadTemplate(e, t = []) {
+    const s = `${e}:${t.map((i) => i.name).join(",")}`;
+    if (this.cacheEnabled && this.templateCache.has(s)) {
+      const i = this.templateCache.get(s);
+      if (i)
+        return {
+          content: i,
+          source: "plugin",
+          path: "(cached)"
+        };
+    }
+    if (this.config.overrides?.[e]) {
+      const i = this.config.overrides[e], r = await this.loadFromPath(i, "override");
+      if (r)
+        return this.cacheTemplate(s, r.content), r;
+    }
+    if (this.config.searchPaths)
+      for (const i of this.config.searchPaths) {
+        const r = await this.searchInDirectory(
+          i,
+          e,
+          i.includes(".magic-helix") ? "workspace" : "global"
+        );
+        if (r)
+          return this.cacheTemplate(s, r.content), r;
+      }
+    for (const i of t) {
+      const r = await this.loadFromPlugin(i, e);
+      if (r)
+        return this.cacheTemplate(s, r.content), r;
+    }
+    return this.log(`Template "${e}" not found`), null;
+  }
+  /**
+   * Load all templates from a plugin
+   */
+  async loadPluginTemplates(e) {
+    try {
+      const t = await Promise.resolve(e.getTemplates());
+      return this.log(
+        `Loaded ${t.length} templates from ${e.displayName}`
+      ), t;
+    } catch (t) {
+      return this.logWarning(
+        `Failed to load templates from ${e.name}: ${t.message}`
+      ), [];
+    }
+  }
+  /**
+   * Load multiple templates by names
+   */
+  async loadTemplates(e, t = []) {
+    const s = /* @__PURE__ */ new Map();
+    for (const i of e) {
+      const r = await this.loadTemplate(i, t);
+      r && s.set(i, r);
+    }
+    return s;
+  }
+  /**
+   * Find templates matching specific tags
+   */
+  async findTemplatesByTags(e, t = []) {
+    const s = [];
+    for (const i of t) {
+      const r = await this.loadPluginTemplates(i);
+      s.push(...r);
+    }
+    return s.filter((i) => i.tags.some((r) => e.includes(r)));
+  }
+  /**
+   * Resolve template content (handle lazy loading)
+   */
+  async resolveTemplateContent(e) {
+    return typeof e.content == "string" ? e.content : await Promise.resolve(e.content());
+  }
+  /**
+   * Clear the template cache
+   */
+  clearCache() {
+    this.templateCache.clear(), this.log("Template cache cleared");
+  }
+  /**
+   * Get cache statistics
+   */
+  getCacheStats() {
+    return {
+      size: this.templateCache.size,
+      keys: Array.from(this.templateCache.keys())
+    };
+  }
+  // Private helper methods
+  /**
+   * Load template from a specific file path
+   */
+  async loadFromPath(e, t) {
+    try {
+      const s = this.resolvePath(e);
+      if (!p.existsSync(s))
+        return this.log(`Template not found at: ${s}`), null;
+      const i = p.readFileSync(s, "utf-8");
+      return this.log(`✓ Loaded template from ${t}: ${s}`), {
+        content: i,
+        source: t,
+        path: s
+      };
+    } catch (s) {
+      return this.logWarning(
+        `Failed to load template from ${e}: ${s.message}`
+      ), null;
+    }
+  }
+  /**
+   * Search for template in a directory
+   */
+  async searchInDirectory(e, t, s) {
+    const i = this.resolvePath(e);
+    if (!p.existsSync(i))
+      return null;
+    const r = this.config.extensions || [".md", ".txt", ""];
+    for (const o of r) {
+      const a = t.endsWith(o) ? t : `${t}${o}`, c = g.join(i, a);
+      if (p.existsSync(c))
+        return this.loadFromPath(c, s);
+    }
+    return null;
+  }
+  /**
+   * Load template from plugin
+   */
+  async loadFromPlugin(e, t) {
+    try {
+      const i = (await this.loadPluginTemplates(e)).find((o) => o.name === t);
+      if (!i)
+        return null;
+      const r = await this.resolveTemplateContent(i);
+      return this.log(
+        `✓ Loaded template "${t}" from plugin: ${e.displayName}`
+      ), {
+        content: r,
+        source: "plugin",
+        path: `plugin:${e.name}/${t}`,
+        plugin: e.name
+      };
+    } catch (s) {
+      return this.logWarning(
+        `Failed to load template "${t}" from plugin ${e.name}: ${s.message}`
+      ), null;
+    }
+  }
+  /**
+   * Resolve path (handle ~/ and relative paths)
+   */
+  resolvePath(e) {
+    if (e.startsWith("~/")) {
+      const t = process.env.HOME || process.env.USERPROFILE || "";
+      return g.join(t, e.slice(2));
+    }
+    return g.isAbsolute(e) ? e : g.resolve(process.cwd(), e);
+  }
+  /**
+   * Cache a template
+   */
+  cacheTemplate(e, t) {
+    this.cacheEnabled && this.templateCache.set(e, t);
+  }
+  log(e) {
+    this.verbose && console.log(`[TemplateLoader] ${e}`);
+  }
+  logWarning(e) {
+    this.verbose && console.warn(`[TemplateLoader] ⚠️  ${e}`);
+  }
+}
+const k = ".magic-helix", I = "meta-instructions.json";
+function oe(n) {
+  const e = g.join(n, k, I);
+  if (!p.existsSync(e))
+    return null;
+  try {
+    const t = p.readFileSync(e, "utf-8");
+    return JSON.parse(t);
+  } catch (t) {
+    return console.warn(
+      `Failed to load meta-instruction config: ${t.message}`
+    ), null;
+  }
+}
+function ae(n) {
+  const e = g.join(n, k, "overrides"), t = /* @__PURE__ */ new Map();
+  if (!p.existsSync(e))
+    return t;
+  const s = O.sync("**/*.md", { cwd: e, absolute: !0 });
+  for (const i of s) {
+    const r = g.basename(i, ".md"), o = p.readFileSync(i, "utf-8");
+    t.set(r, o);
+  }
+  return t;
+}
+function ce(n, e, t) {
+  const s = new Map(n);
+  if (e.ignoreTags)
+    for (const r of e.ignoreTags)
+      s.delete(r);
+  const i = ae(t);
+  for (const [r, o] of i)
+    s.set(r, o);
+  if (e.overrides)
+    for (const r of e.overrides) {
+      const o = s.get(r.tag);
+      switch (r.mode) {
+        case "replace":
+          s.set(r.tag, r.content);
+          break;
+        case "prepend":
+          o ? s.set(r.tag, `${r.content}
+
+${o}`) : s.set(r.tag, r.content);
+          break;
+        case "append":
+          o ? s.set(r.tag, `${o}
+
+${r.content}`) : s.set(r.tag, r.content);
+          break;
+      }
+    }
+  return s;
+}
+function le(n, e) {
+  const t = new Map(n);
+  let s = e.template;
+  for (const i of e.tags) {
+    const r = n.get(i);
+    r && (s = s.replace(`{{${i}}}`, r));
+  }
+  return t.set(e.outputTag, s), t;
+}
+function Ne(n, e) {
+  const t = oe(e);
+  if (!t)
+    return n;
+  let s = ce(n, t, e);
+  if (t.combiners)
+    for (const i of t.combiners)
+      s = le(s, i);
+  return s;
+}
+function ze(n) {
+  const e = g.join(n, k);
+  return p.existsSync(e);
+}
+function Ge(n) {
+  const e = g.join(n, k), t = g.join(e, "overrides");
+  p.mkdirSync(e, { recursive: !0 }), p.mkdirSync(t, { recursive: !0 });
+  const s = {
+    overrides: [
+      {
+        tag: "example-tag",
+        content: `# Custom Instruction
+
+Your content here...`,
+        mode: "replace"
+      }
+    ],
+    combiners: [
+      {
+        tags: ["tag1", "tag2"],
+        outputTag: "combined-tag",
+        template: `# Combined Instructions
+
+{{tag1}}
+
+---
+
+{{tag2}}`
+      }
+    ],
+    ignoreTags: ["unwanted-tag"]
+  }, i = g.join(e, I);
+  p.writeFileSync(i, JSON.stringify(s, null, 2)), p.writeFileSync(g.join(t, "example.md"), `# Example Override
+
+This file overrides the default instructions for this tag.
+Create files like:
+- react-core.md → overrides "react-core" tag
+- style-tailwind.md → overrides "style-tailwind" tag
+`), console.log(
+    `✅ Initialized .magic-helix/ directory structure at: ${e}`
+  );
+}
+class ue {
+  constructor(e = {}) {
+    this.enabled = !!e.enabled;
+    const t = e.dir || C.resolve(process.cwd(), ".magic-helix/telemetry");
+    this.filePath = C.join(t, "events.jsonl"), this.sessionId = e.sessionId, this.variant = e.variant, this.projectRoot = e.projectRoot, this.enabled && S.mkdirSync(C.dirname(this.filePath), { recursive: !0 });
+  }
+  isEnabled() {
+    return this.enabled;
+  }
+  track(e) {
+    if (!this.enabled) return;
+    const t = {
+      ...e,
+      timestamp: (/* @__PURE__ */ new Date()).toISOString(),
+      sessionId: this.sessionId,
+      projectRoot: this.projectRoot
+    };
+    "variant" in e && e.variant ? t.variant = e.variant : t.variant = this.variant;
+    const s = `${JSON.stringify(t)}
+`;
+    S.appendFileSync(this.filePath, s, "utf-8");
+  }
+}
+function Be(n = {}) {
+  const e = n.enabled ?? process.env.MAGIC_HELIX_TELEMETRY === "1", t = n.dir || process.env.MAGIC_HELIX_TELEMETRY_DIR, s = n.sessionId || process.env.MAGIC_HELIX_SESSION_ID || `${Date.now()}`, i = n.variant || process.env.MAGIC_HELIX_VARIANT || "default", r = n.projectRoot || process.cwd();
+  return new ue({ enabled: e, dir: t, sessionId: s, variant: i, projectRoot: r });
+}
+function qe(n) {
+  return n.map((e) => {
+    const t = ee(e.context), s = $(t);
+    return {
+      variant: e.name,
+      instructions: t,
+      score: s.overallScore,
+      structureScore: s.structureScore,
+      clarityScore: s.clarityScore,
+      completenessScore: s.completenessScore,
+      missingCount: s.missingElements.length
+    };
+  });
+}
+function He(n) {
+  return n.length === 0 ? {
+    variant: "",
+    instructions: "",
+    score: 0,
+    structureScore: 0,
+    clarityScore: 0,
+    completenessScore: 0,
+    missingCount: 0
+  } : n.reduce(
+    (e, t) => t.score > e.score ? t : e,
+    n[0]
+  );
+}
+function Ue(n, e) {
+  if (e?.isEnabled())
+    for (const t of n) {
+      const s = {
+        type: "instruction_validation",
+        file: `ab-test-variant-${t.variant}`,
+        score: t.score,
+        structureScore: t.structureScore,
+        clarityScore: t.clarityScore,
+        completenessScore: t.completenessScore,
+        missingCount: t.missingCount,
+        variant: t.variant
+      };
+      e.track(s);
+    }
+}
+const de = M(import.meta.url);
+L(de);
 export {
-  i as BUILT_IN_CONFIG,
-  n as BUILT_IN_TEMPLATE_DIR,
-  r as CodeOwnersPlugin,
-  l as DEFAULT_AI_REFINEMENT,
-  o as DockerPlugin,
-  g as GitHubActionsPlugin,
-  u as GitLabCIPlugin,
-  P as GolangPlugin,
-  I as INSTRUCTION_ELEMENTS,
-  T as MonorepoPlugin,
-  y as PHPPlugin,
-  p as PluginLoader,
-  c as PluginRegistry,
-  d as PluginRegistryOld,
-  m as PythonPlugin,
-  R as RustPlugin,
-  C as TelemetryClient,
-  E as TemplateLoader,
-  L as analyzeBestVariant,
-  M as analyzeProjectTags,
-  N as analyzeWithPlugins,
-  _ as applyCombiner,
-  f as applyMetaInstructions,
-  A as applyOverrides,
-  B as combinePatterns,
-  O as createTelemetry,
-  h as estimateTokens,
-  G as formatValidationReport,
-  U as generateABVariants,
-  b as generateInstructions,
-  z as getFormatter,
-  F as getQualityGrade,
-  k as getRegistry,
-  v as hasMetaInstructions,
-  D as initMetaInstructions,
-  V as initializeRegistry,
-  H as loadMetaConfig,
-  Q as loadOverrideInstructions,
-  S as loadPatternTemplates,
-  j as loadUserConfig,
-  w as mergeConfigs,
-  x as passesQualityThreshold,
-  q as pluginRegistry,
-  J as refineInstructions,
-  K as registerBuiltInPlugins,
-  W as selectPatterns,
-  X as trackABTest,
-  Y as validateInstructions
+  A as BUILT_IN_CONFIG,
+  xe as CodeOwnersPlugin,
+  T as DEFAULT_AI_REFINEMENT,
+  Te as DockerPlugin,
+  $e as GitHubActionsPlugin,
+  Ie as GitLabCIPlugin,
+  De as GolangPlugin,
+  te as INSTRUCTION_ELEMENTS,
+  Le as MonorepoPlugin,
+  Me as PHPPlugin,
+  x as PluginLoader,
+  b as PluginRegistry,
+  ie as PluginRegistryOld,
+  Oe as PythonPlugin,
+  Re as RustPlugin,
+  ue as TelemetryClient,
+  We as TemplateLoader,
+  He as analyzeBestVariant,
+  ye as analyzeProjectTags,
+  je as analyzeWithPlugins,
+  le as applyCombiner,
+  Ne as applyMetaInstructions,
+  ce as applyOverrides,
+  Z as combinePatterns,
+  Be as createTelemetry,
+  ve as estimateTokens,
+  Fe as formatValidationReport,
+  qe as generateABVariants,
+  ee as generateInstructions,
+  ke as getFormatter,
+  ne as getQualityGrade,
+  _e as getRegistry,
+  ze as hasMetaInstructions,
+  Ge as initMetaInstructions,
+  Ae as initializeRegistry,
+  oe as loadMetaConfig,
+  ae as loadOverrideInstructions,
+  Q as loadPatternTemplates,
+  Pe as loadUserConfig,
+  be as mergeConfigs,
+  Ce as passesQualityThreshold,
+  h as pluginRegistry,
+  we as refineInstructions,
+  Ee as registerBuiltInPlugins,
+  K as selectPatterns,
+  Ue as trackABTest,
+  $ as validateInstructions
 };
 //# sourceMappingURL=index.mjs.map