@el-j/magic-helix-plugins 4.0.0-beta.2 → 4.0.0-beta.3

package/dist/containers/kubernetes-deploy.md

@@ -0,0 +1,210 @@
+# Kubernetes Deployment Guide
+
+## Basic Deployment Structure
+
+### Deployment Manifest
+```yaml
+apiVersion: apps/v1
+kind: Deployment
+metadata:
+  name: app-deployment
+  labels:
+    app: myapp
+spec:
+  replicas: 3
+  selector:
+    matchLabels:
+      app: myapp
+  template:
+    metadata:
+      labels:
+        app: myapp
+    spec:
+      containers:
+      - name: app
+        image: myregistry/myapp:1.0.0
+        ports:
+        - containerPort: 8080
+        resources:
+          requests:
+            memory: "128Mi"
+            cpu: "100m"
+          limits:
+            memory: "512Mi"
+            cpu: "500m"
+        livenessProbe:
+          httpGet:
+            path: /health
+            port: 8080
+          initialDelaySeconds: 30
+          periodSeconds: 10
+        readinessProbe:
+          httpGet:
+            path: /ready
+            port: 8080
+          initialDelaySeconds: 10
+          periodSeconds: 5
+        env:
+        - name: DATABASE_URL
+          valueFrom:
+            secretKeyRef:
+              name: app-secrets
+              key: db-url
+```
+
+### Service Manifest
+```yaml
+apiVersion: v1
+kind: Service
+metadata:
+  name: app-service
+spec:
+  selector:
+    app: myapp
+  ports:
+  - protocol: TCP
+    port: 80
+    targetPort: 8080
+  type: LoadBalancer
+```
+
+### ConfigMap
+```yaml
+apiVersion: v1
+kind: ConfigMap
+metadata:
+  name: app-config
+data:
+  LOG_LEVEL: "info"
+  API_TIMEOUT: "30s"
+```
+
+### Secret
+```yaml
+apiVersion: v1
+kind: Secret
+metadata:
+  name: app-secrets
+type: Opaque
+data:
+  db-url: cG9zdGdyZXM6Ly9leGFtcGxl  # base64 encoded
+```
+
+## Ingress Configuration
+```yaml
+apiVersion: networking.k8s.io/v1
+kind: Ingress
+metadata:
+  name: app-ingress
+  annotations:
+    cert-manager.io/cluster-issuer: letsencrypt-prod
+spec:
+  ingressClassName: nginx
+  tls:
+  - hosts:
+    - myapp.example.com
+    secretName: app-tls
+  rules:
+  - host: myapp.example.com
+    http:
+      paths:
+      - path: /
+        pathType: Prefix
+        backend:
+          service:
+            name: app-service
+            port:
+              number: 80
+```
+
+## Horizontal Pod Autoscaler
+```yaml
+apiVersion: autoscaling/v2
+kind: HorizontalPodAutoscaler
+metadata:
+  name: app-hpa
+spec:
+  scaleTargetRef:
+    apiVersion: apps/v1
+    kind: Deployment
+    name: app-deployment
+  minReplicas: 2
+  maxReplicas: 10
+  metrics:
+  - type: Resource
+    resource:
+      name: cpu
+      target:
+        type: Utilization
+        averageUtilization: 70
+```
+
+## StatefulSet (for databases)
+```yaml
+apiVersion: apps/v1
+kind: StatefulSet
+metadata:
+  name: postgres
+spec:
+  serviceName: postgres
+  replicas: 3
+  selector:
+    matchLabels:
+      app: postgres
+  template:
+    metadata:
+      labels:
+        app: postgres
+    spec:
+      containers:
+      - name: postgres
+        image: postgres:16-alpine
+        ports:
+        - containerPort: 5432
+        volumeMounts:
+        - name: data
+          mountPath: /var/lib/postgresql/data
+  volumeClaimTemplates:
+  - metadata:
+      name: data
+    spec:
+      accessModes: ["ReadWriteOnce"]
+      resources:
+        requests:
+          storage: 10Gi
+```
+
+## Best Practices
+1. **Resource Limits**: Always set CPU/memory requests and limits
+2. **Health Checks**: Implement liveness and readiness probes
+3. **Rolling Updates**: Use `RollingUpdate` strategy with `maxSurge` and `maxUnavailable`
+4. **Pod Disruption Budgets**: Ensure availability during node maintenance
+5. **Network Policies**: Restrict pod-to-pod communication
+6. **RBAC**: Use ServiceAccounts with minimal permissions
+7. **Secrets Management**: Use external secret managers (Vault, AWS Secrets Manager)
+8. **Monitoring**: Deploy Prometheus/Grafana stack
+9. **Logging**: Use Fluentd/Fluent Bit for log aggregation
+10. **GitOps**: Manage deployments with ArgoCD or Flux
+
+## Common Commands
+```bash
+# Apply manifests
+kubectl apply -f deployment.yaml
+
+# Check status
+kubectl get pods -l app=myapp
+kubectl describe pod <pod-name>
+kubectl logs <pod-name> -f
+
+# Scale deployment
+kubectl scale deployment app-deployment --replicas=5
+
+# Update image
+kubectl set image deployment/app-deployment app=myregistry/myapp:2.0.0
+
+# Rollback
+kubectl rollout undo deployment/app-deployment
+
+# Port forwarding
+kubectl port-forward svc/app-service 8080:80
+```

package/dist/cpp/index.cjs

@@ -0,0 +1,79 @@
+"use strict";Object.defineProperty(exports,Symbol.toStringTag,{value:"Module"});const u=require("../BasePlugin-odQJAKA-.cjs");class m extends u.BasePlugin{constructor(){super(...arguments),this.name="cpp",this.displayName="C/C++",this.version="3.0.0",this.priority=85}async detect(t){const i=[],s={};let r,o=this.getProjectName(t);const e=await this.detectPlatformIO(t);if(e&&(i.push("platformio"),r="platformio.ini",e.board&&i.push(`board-${e.board}`),e.platform&&(i.push(`platform-${e.platform}`),e.platform.includes("espressif32")&&i.push("esp32"),e.platform.includes("espressif8266")&&i.push("esp8266"),e.platform.includes("atmelavr")&&i.push("arduino")),e.framework&&(i.push(`framework-${e.framework}`),e.framework==="arduino"&&i.push("arduino")),e.libs))for(const a of e.libs)s[a]="*";if(this.fileExists(t,"CMakeLists.txt")){i.push("cmake"),r||(r="CMakeLists.txt");const a=this.readFile(t,"CMakeLists.txt");if(a){const c=a.match(/project\s*\(\s*([^\s)]+)/i);c&&(o=c[1])}}return(this.fileExists(t,"Makefile")||this.fileExists(t,"makefile"))&&(i.push("makefile"),r||(r="Makefile")),await this.hasFiles(t,"*.ino")&&(i.push("arduino"),r||(r="*.ino")),await this.hasFiles(t,"**/*.{cpp,c,h,hpp}")&&(i.push("cpp"),r||(r="*.cpp")),i.length===0?null:{language:"C/C++",name:o,dependencies:s,manifestFile:r,projectPath:t,tags:i}}async detectPlatformIO(t){if(!this.fileExists(t,"platformio.ini"))return null;const i=this.readFile(t,"platformio.ini");if(!i)return null;const s={libs:[]},r=i.split(`
+`);let o=!1,e=null;for(const p of r){const n=p.trim();if(n.startsWith("[env:")){o=!0,e=null;continue}if(n.startsWith("[")&&n.endsWith("]")){o=!1,e=null;continue}if(o||!s.board){const l=n.match(/^(\w+)\s*=\s*(.*)$/);if(l){const[,f,a]=l;switch(e=f,f){case"board":s.board=a.trim();break;case"platform":s.platform=a.trim();break;case"framework":s.framework=a.trim();break;case"lib_deps":a.trim()&&s.libs?.push(a.trim());break}}else e==="lib_deps"&&n&&!n.startsWith("[")&&s.libs?.push(n)}}return s.board||s.platform?s:null}getTemplates(){return[{name:"cpp-core",tags:["cpp"],content:this.getCppTemplate()},{name:"platformio-core",tags:["platformio"],content:this.getPlatformIOTemplate()},{name:"arduino-core",tags:["arduino"],content:this.getArduinoTemplate()}]}getDependencyTagMap(){return{boost:"boost",fmt:"fmt",spdlog:"spdlog",googletest:"gtest",catch2:"catch2","Adafruit GFX Library":"adafruit-gfx",WiFi:"wifi",ESP32:"esp32",FastLED:"fastled",ArduinoJson:"arduino-json"}}getConfigFileTagMap(){return{"platformio.ini":"platformio","CMakeLists.txt":"cmake",Makefile:"makefile",".clang-format":"clang-format",".clang-tidy":"clang-tidy"}}getCppTemplate(){return`# C/C++ Development Guidelines
+
+This project uses C/C++.
+
+## Project Structure
+- Organize headers and implementation files clearly
+- Use proper include guards or \`#pragma once\`
+- Separate interface from implementation
+
+## Code Style
+- Follow modern C++ practices (C++11/14/17/20)
+- Use RAII for resource management
+- Prefer smart pointers over raw pointers
+- Use const correctness
+
+## Build System
+- Use CMake or Makefile for build configuration
+- Keep build files maintainable
+- Document build dependencies
+
+## Testing
+- Write unit tests for core functionality
+- Use GoogleTest, Catch2, or similar frameworks
+- Test edge cases and error conditions
+`}getPlatformIOTemplate(){return`# PlatformIO Development Guidelines
+
+This is a PlatformIO embedded project.
+
+## Project Structure
+- Source code in \`src/\`
+- Libraries in \`lib/\`
+- Include files in \`include/\`
+- Tests in \`test/\`
+
+## Development Workflow
+- Use PlatformIO CLI or IDE for building
+- Test on hardware early and often
+- Use serial monitor for debugging
+- Manage dependencies via \`platformio.ini\`
+
+## Code Practices
+- Keep \`setup()\` and \`loop()\` focused
+- Use proper pin definitions
+- Handle interrupts carefully
+- Consider power consumption
+
+## Hardware Integration
+- Document pin configurations
+- Test hardware connections before coding
+- Use appropriate voltage levels
+- Follow manufacturer datasheets
+`}getArduinoTemplate(){return`# Arduino Development Guidelines
+
+This is an Arduino project.
+
+## Project Structure
+- Main sketch (.ino file)
+- Additional tabs for organization
+- Libraries in Arduino libraries folder
+
+## Code Practices
+- Use \`setup()\` for initialization
+- Keep \`loop()\` non-blocking when possible
+- Use \`delay()\` sparingly
+- Free resources properly
+
+## Hardware
+- Document pin assignments
+- Use proper resistor values
+- Consider current limitations
+- Test connections before powering
+
+## Debugging
+- Use Serial.print() for debugging
+- Check Serial Monitor baud rate
+- Validate sensor readings
+- Test incrementally
+`}}exports.CppPlugin=m;

package/dist/cpp/index.mjs

@@ -0,0 +1,209 @@
+import { B as u } from "../BasePlugin-6wv0hYJ9.js";
+class g extends u {
+  constructor() {
+    super(...arguments), this.name = "cpp", this.displayName = "C/C++", this.version = "3.0.0", this.priority = 85;
+  }
+  async detect(t) {
+    const i = [], s = {};
+    let r, n = this.getProjectName(t);
+    const e = await this.detectPlatformIO(t);
+    if (e && (i.push("platformio"), r = "platformio.ini", e.board && i.push(`board-${e.board}`), e.platform && (i.push(`platform-${e.platform}`), e.platform.includes("espressif32") && i.push("esp32"), e.platform.includes("espressif8266") && i.push("esp8266"), e.platform.includes("atmelavr") && i.push("arduino")), e.framework && (i.push(`framework-${e.framework}`), e.framework === "arduino" && i.push("arduino")), e.libs))
+      for (const a of e.libs)
+        s[a] = "*";
+    if (this.fileExists(t, "CMakeLists.txt")) {
+      i.push("cmake"), r || (r = "CMakeLists.txt");
+      const a = this.readFile(t, "CMakeLists.txt");
+      if (a) {
+        const c = a.match(/project\s*\(\s*([^\s)]+)/i);
+        c && (n = c[1]);
+      }
+    }
+    return (this.fileExists(t, "Makefile") || this.fileExists(t, "makefile")) && (i.push("makefile"), r || (r = "Makefile")), await this.hasFiles(t, "*.ino") && (i.push("arduino"), r || (r = "*.ino")), await this.hasFiles(t, "**/*.{cpp,c,h,hpp}") && (i.push("cpp"), r || (r = "*.cpp")), i.length === 0 ? null : {
+      language: "C/C++",
+      name: n,
+      dependencies: s,
+      manifestFile: r,
+      projectPath: t,
+      tags: i
+    };
+  }
+  /**
+   * Parse platformio.ini configuration
+   */
+  async detectPlatformIO(t) {
+    if (!this.fileExists(t, "platformio.ini"))
+      return null;
+    const i = this.readFile(t, "platformio.ini");
+    if (!i) return null;
+    const s = {
+      libs: []
+    }, r = i.split(`
+`);
+    let n = !1, e = null;
+    for (const p of r) {
+      const o = p.trim();
+      if (o.startsWith("[env:")) {
+        n = !0, e = null;
+        continue;
+      }
+      if (o.startsWith("[") && o.endsWith("]")) {
+        n = !1, e = null;
+        continue;
+      }
+      if (n || !s.board) {
+        const l = o.match(/^(\w+)\s*=\s*(.*)$/);
+        if (l) {
+          const [, f, a] = l;
+          switch (e = f, f) {
+            case "board":
+              s.board = a.trim();
+              break;
+            case "platform":
+              s.platform = a.trim();
+              break;
+            case "framework":
+              s.framework = a.trim();
+              break;
+            case "lib_deps":
+              a.trim() && s.libs?.push(a.trim());
+              break;
+          }
+        } else e === "lib_deps" && o && !o.startsWith("[") && s.libs?.push(o);
+      }
+    }
+    return s.board || s.platform ? s : null;
+  }
+  getTemplates() {
+    return [
+      {
+        name: "cpp-core",
+        tags: ["cpp"],
+        content: this.getCppTemplate()
+      },
+      {
+        name: "platformio-core",
+        tags: ["platformio"],
+        content: this.getPlatformIOTemplate()
+      },
+      {
+        name: "arduino-core",
+        tags: ["arduino"],
+        content: this.getArduinoTemplate()
+      }
+    ];
+  }
+  getDependencyTagMap() {
+    return {
+      // Common C++ libraries
+      boost: "boost",
+      fmt: "fmt",
+      spdlog: "spdlog",
+      googletest: "gtest",
+      catch2: "catch2",
+      // Arduino/PlatformIO libraries
+      "Adafruit GFX Library": "adafruit-gfx",
+      WiFi: "wifi",
+      ESP32: "esp32",
+      FastLED: "fastled",
+      ArduinoJson: "arduino-json"
+    };
+  }
+  getConfigFileTagMap() {
+    return {
+      "platformio.ini": "platformio",
+      "CMakeLists.txt": "cmake",
+      Makefile: "makefile",
+      ".clang-format": "clang-format",
+      ".clang-tidy": "clang-tidy"
+    };
+  }
+  getCppTemplate() {
+    return `# C/C++ Development Guidelines
+
+This project uses C/C++.
+
+## Project Structure
+- Organize headers and implementation files clearly
+- Use proper include guards or \`#pragma once\`
+- Separate interface from implementation
+
+## Code Style
+- Follow modern C++ practices (C++11/14/17/20)
+- Use RAII for resource management
+- Prefer smart pointers over raw pointers
+- Use const correctness
+
+## Build System
+- Use CMake or Makefile for build configuration
+- Keep build files maintainable
+- Document build dependencies
+
+## Testing
+- Write unit tests for core functionality
+- Use GoogleTest, Catch2, or similar frameworks
+- Test edge cases and error conditions
+`;
+  }
+  getPlatformIOTemplate() {
+    return `# PlatformIO Development Guidelines
+
+This is a PlatformIO embedded project.
+
+## Project Structure
+- Source code in \`src/\`
+- Libraries in \`lib/\`
+- Include files in \`include/\`
+- Tests in \`test/\`
+
+## Development Workflow
+- Use PlatformIO CLI or IDE for building
+- Test on hardware early and often
+- Use serial monitor for debugging
+- Manage dependencies via \`platformio.ini\`
+
+## Code Practices
+- Keep \`setup()\` and \`loop()\` focused
+- Use proper pin definitions
+- Handle interrupts carefully
+- Consider power consumption
+
+## Hardware Integration
+- Document pin configurations
+- Test hardware connections before coding
+- Use appropriate voltage levels
+- Follow manufacturer datasheets
+`;
+  }
+  getArduinoTemplate() {
+    return `# Arduino Development Guidelines
+
+This is an Arduino project.
+
+## Project Structure
+- Main sketch (.ino file)
+- Additional tabs for organization
+- Libraries in Arduino libraries folder
+
+## Code Practices
+- Use \`setup()\` for initialization
+- Keep \`loop()\` non-blocking when possible
+- Use \`delay()\` sparingly
+- Free resources properly
+
+## Hardware
+- Document pin assignments
+- Use proper resistor values
+- Consider current limitations
+- Test connections before powering
+
+## Debugging
+- Use Serial.print() for debugging
+- Check Serial Monitor baud rate
+- Validate sensor readings
+- Test incrementally
+`;
+  }
+}
+export {
+  g as CppPlugin
+};

package/dist/csharp/index.cjs

@@ -1,4 +1,4 @@
-"use strict";Object.defineProperty(exports,Symbol.toStringTag,{value:"Module"});const o=require("../BasePlugin-odQJAKA-.cjs");class c extends o.BasePlugin{constructor(){super(...arguments),this.name="csharp",this.displayName="C#",this.version="3.0.0",this.priority=60}async detect(e){const n=await this.findFiles(e,"*.csproj");if(n.length===0)return null;const t=n[0],s=this.readFile(e,t),i={};if(s){const a=s.matchAll(/<PackageReference\s+Include="([^"]+)"(?:\s+Version="([^"]+)")?/g);for(const r of a)i[r[1]]=r[2]||"*"}return{language:"C#",name:t.replace(".csproj",""),dependencies:i,manifestFile:t,projectPath:e}}getTemplates(){return[{name:"csharp-core",tags:["csharp","dotnet"],content:`# C# / .NET Development Guidelines
+"use strict";Object.defineProperty(exports,Symbol.toStringTag,{value:"Module"});const c=require("node:path"),p=require("../BasePlugin-odQJAKA-.cjs");function l(n){const e=Object.create(null,{[Symbol.toStringTag]:{value:"Module"}});if(n){for(const t in n)if(t!=="default"){const a=Object.getOwnPropertyDescriptor(n,t);Object.defineProperty(e,t,a.get?a:{enumerable:!0,get:()=>n[t]})}}return e.default=n,Object.freeze(e)}const u=l(c);class g extends p.BasePlugin{constructor(){super(...arguments),this.name="csharp",this.displayName="C#",this.version="3.0.0",this.priority=60}async detect(e){const t=await this.findFiles(e,"*.csproj");if(t.length===0)return null;const a=t[0],s=this.readFile(e,a),r={};if(s){const o=s.matchAll(/<PackageReference\s+Include="([^"]+)"(?:\s+Version="([^"]+)")?/g);for(const i of o)r[i[1]]=i[2]||"*"}return{language:"C#",name:a.replace(".csproj",""),dependencies:r,manifestFile:a,projectPath:e}}getTemplates(){return[{name:"csharp-core",tags:["csharp","dotnet"],content:()=>this.loadTemplateFromFile(u.join(__dirname,"templates/lang-csharp.md")).then(e=>e||this.getCSharpFallbackTemplate())}]}getCSharpFallbackTemplate(){return`# C# / .NET Development Guidelines
 
 This project uses C# and .NET.
 
@@ -15,4 +15,4 @@ This project uses C# and .NET.
 ## Testing
 - Write xUnit/NUnit tests
 - Use proper assertions
-- Aim for good coverage`}]}getDependencyTagMap(){return{"Microsoft.AspNetCore":"aspnetcore",xunit:"xunit",NUnit:"nunit"}}}exports.CSharpPlugin=c;
+- Aim for good coverage`}getDependencyTagMap(){return{"Microsoft.AspNetCore":"aspnetcore",xunit:"xunit",NUnit:"nunit"}}}exports.CSharpPlugin=g;

package/dist/csharp/{index.js → index.mjs}

@@ -1,5 +1,6 @@
-import { B as o } from "../BasePlugin-6wv0hYJ9.js";
-class l extends o {
+import * as o from "node:path";
+import { B as p } from "../BasePlugin-6wv0hYJ9.js";
+class g extends p {
   constructor() {
     super(...arguments), this.name = "csharp", this.displayName = "C#", this.version = "3.0.0", this.priority = 60;
   }
@@ -7,18 +8,18 @@ class l extends o {
     const s = await this.findFiles(e, "*.csproj");
     if (s.length === 0)
       return null;
-    const t = s[0], n = this.readFile(e, t), r = {};
+    const t = s[0], n = this.readFile(e, t), a = {};
     if (n) {
       const i = n.matchAll(
         /<PackageReference\s+Include="([^"]+)"(?:\s+Version="([^"]+)")?/g
       );
-      for (const a of i)
-        r[a[1]] = a[2] || "*";
+      for (const r of i)
+        a[r[1]] = r[2] || "*";
     }
     return {
       language: "C#",
       name: t.replace(".csproj", ""),
-      dependencies: r,
+      dependencies: a,
       manifestFile: t,
       projectPath: e
     };
@@ -28,7 +29,14 @@ class l extends o {
       {
         name: "csharp-core",
         tags: ["csharp", "dotnet"],
-        content: `# C# / .NET Development Guidelines
+        content: () => this.loadTemplateFromFile(
+          o.join(__dirname, "templates/lang-csharp.md")
+        ).then((e) => e || this.getCSharpFallbackTemplate())
+      }
+    ];
+  }
+  getCSharpFallbackTemplate() {
+    return `# C# / .NET Development Guidelines
 
 This project uses C# and .NET.
 
@@ -45,9 +53,7 @@ This project uses C# and .NET.
 ## Testing
 - Write xUnit/NUnit tests
 - Use proper assertions
-- Aim for good coverage`
-      }
-    ];
+- Aim for good coverage`;
   }
   getDependencyTagMap() {
     return {
@@ -58,5 +64,5 @@ This project uses C# and .NET.
   }
 }
 export {
-  l as CSharpPlugin
+  g as CSharpPlugin
 };