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

package/dist/ruby/templates/lang-ruby.md

@@ -0,0 +1,216 @@
+# Ruby Language Instructions
+
+## Project Type
+- Language: Ruby
+- Package Manager: Bundler (Gemfile)
+- Framework: {Rails|Sinatra|None}
+
+## Build Commands
+
+```bash
+bundle install          # Install dependencies
+bundle exec ruby app.rb # Run application
+bundle exec rake test   # Run tests
+bundle update          # Update dependencies
+```
+
+## Code Conventions
+
+### Ruby Style
+```ruby
+# Use descriptive variable names
+user_name = "John Doe"
+users = User.where(active: true)
+
+# Prefer blocks and enumerables
+users.each do |user|
+  puts user.name
+end
+
+# Use symbols for hash keys
+options = { name: "John", age: 30 }
+
+# Prefer string interpolation
+puts "Hello, #{user.name}!"
+```
+
+### Classes and Modules
+```ruby
+class User
+  attr_accessor :name, :email
+  attr_reader :id
+  
+  def initialize(name:, email:)
+    @name = name
+    @email = email
+    @id = SecureRandom.uuid
+  end
+  
+  def full_profile
+    "#{name} <#{email}>"
+  end
+end
+
+module Authenticatable
+  def authenticate(password)
+    # authentication logic
+  end
+end
+
+class Admin < User
+  include Authenticatable
+end
+```
+
+### Blocks and Procs
+```ruby
+# Block
+numbers.map { |n| n * 2 }
+
+# Multiline block
+numbers.each do |n|
+  puts n
+  log_number(n)
+end
+
+# Proc
+double = ->(x) { x * 2 }
+double.call(5) # => 10
+```
+
+## Testing with RSpec
+
+```ruby
+# spec/models/user_spec.rb
+require 'rails_helper'
+
+RSpec.describe User, type: :model do
+  describe '#full_profile' do
+    it 'returns formatted name and email' do
+      user = User.new(name: 'John', email: 'john@example.com')
+      expect(user.full_profile).to eq('John <john@example.com>')
+    end
+  end
+  
+  describe 'validations' do
+    it { should validate_presence_of(:name) }
+    it { should validate_presence_of(:email) }
+  end
+end
+```
+
+## Docker Optimization
+
+### Multi-stage Dockerfile
+```dockerfile
+FROM ruby:3.2-alpine AS builder
+WORKDIR /app
+
+# Install build dependencies
+RUN apk add --no-cache build-base postgresql-dev
+
+# Install gems
+COPY Gemfile Gemfile.lock ./
+RUN bundle config --local deployment true && \
+    bundle config --local without development:test && \
+    bundle install -j4
+
+# Runtime stage
+FROM ruby:3.2-alpine
+WORKDIR /app
+
+# Install runtime dependencies
+RUN apk add --no-cache postgresql-client tzdata
+
+# Copy installed gems
+COPY --from=builder /usr/local/bundle /usr/local/bundle
+COPY . .
+
+# Non-root user
+RUN adduser -D -u 1000 appuser && chown -R appuser /app
+USER appuser
+
+EXPOSE 3000
+CMD ["bundle", "exec", "puma", "-C", "config/puma.rb"]
+```
+
+### Docker Compose
+```yaml
+services:
+  web:
+    build: .
+    ports:
+      - "3000:3000"
+    environment:
+      - DATABASE_URL=postgresql://postgres:password@db/myapp
+      - REDIS_URL=redis://redis:6379/0
+    depends_on:
+      - db
+      - redis
+  
+  db:
+    image: postgres:15-alpine
+    environment:
+      POSTGRES_PASSWORD: password
+    volumes:
+      - postgres_data:/var/lib/postgresql/data
+  
+  redis:
+    image: redis:7-alpine
+    volumes:
+      - redis_data:/data
+
+volumes:
+  postgres_data:
+  redis_data:
+```
+
+## Dependency Management
+
+```bash
+# Add a gem
+bundle add puma
+
+# Remove a gem
+bundle remove old_gem
+
+# Update specific gem
+bundle update rails
+
+# Check for outdated gems
+bundle outdated
+
+# Audit for security vulnerabilities
+bundle audit
+```
+
+## Performance Tips
+
+- Use `pluck` instead of `map` for database queries
+- Eager load associations to avoid N+1 queries
+- Use background jobs (Sidekiq) for slow operations
+- Cache expensive operations
+- Use `find_each` for large datasets
+- Profile with rack-mini-profiler
+- Use Ruby 3.x for YJIT performance improvements
+
+## Security
+
+- Always use strong parameters in Rails
+- Use `SecureRandom` for tokens
+- Validate user input
+- Use parameterized queries (ActiveRecord does this)
+- Keep dependencies updated with `bundle audit`
+- Set secure headers
+- Use HTTPS in production
+
+## Common Gems
+
+- **puma**: Web server
+- **sidekiq**: Background jobs
+- **rspec**: Testing framework
+- **rubocop**: Linter
+- **devise**: Authentication
+- **cancancan**: Authorization
+- **kaminari**: Pagination
+- **jbuilder**: JSON API builder

package/dist/rust/index.cjs

@@ -1,5 +1,5 @@
-"use strict";Object.defineProperty(exports,Symbol.toStringTag,{value:"Module"});const m=require("../BasePlugin-odQJAKA-.cjs");class g extends m.BasePlugin{constructor(){super(...arguments),this.name="rust",this.displayName="Rust",this.version="3.0.0",this.priority=80}async detect(e){if(!this.fileExists(e,"Cargo.toml"))return null;const s=this.readFile(e,"Cargo.toml");if(!s)return{language:"Rust",name:this.getProjectName(e),dependencies:{},manifestFile:"Cargo.toml",projectPath:e};const l=s.match(/\[package\][\s\S]*?name\s*=\s*"([^"]+)"/),u=s.match(/\[package\][\s\S]*?description\s*=\s*"([^"]+)"/),r={},a=s.match(/\[dependencies\]([\s\S]*?)(?:\n\[|$)/);if(a){const i=a[1].split(`
-`);for(const o of i){const t=o.match(/^([a-zA-Z0-9_-]+)\s*=\s*(?:"([^"]+)"|{[^}]*version\s*=\s*"([^"]+)")/);t&&(r[t[1]]=t[2]||t[3]||"*")}}const c=s.match(/\[workspace\][\s\S]*?members\s*=\s*\[([\s\S]*?)\]/),n=[];if(c){const i=c[1].split(",").map(o=>o.trim().replace(/["']/g,"")).filter(Boolean);n.push(...i)}return{language:"Rust",name:l?.[1]||this.getProjectName(e),description:u?.[1],dependencies:r,manifestFile:"Cargo.toml",projectPath:e,workspaceMembers:n.length>0?n:void 0}}getTemplates(){return[{name:"rust-core",tags:["rust"],content:`# Rust Development Guidelines
+"use strict";Object.defineProperty(exports,Symbol.toStringTag,{value:"Module"});const p=require("node:path"),g=require("../BasePlugin-odQJAKA-.cjs");function d(s){const e=Object.create(null,{[Symbol.toStringTag]:{value:"Module"}});if(s){for(const t in s)if(t!=="default"){const n=Object.getOwnPropertyDescriptor(s,t);Object.defineProperty(e,t,n.get?n:{enumerable:!0,get:()=>s[t]})}}return e.default=s,Object.freeze(e)}const f=d(p);class h extends g.BasePlugin{constructor(){super(...arguments),this.name="rust",this.displayName="Rust",this.version="3.0.0",this.priority=80}async detect(e){if(!this.fileExists(e,"Cargo.toml"))return null;const t=this.readFile(e,"Cargo.toml");if(!t)return{language:"Rust",name:this.getProjectName(e),dependencies:{},manifestFile:"Cargo.toml",projectPath:e};const n=t.match(/\[package\][\s\S]*?name\s*=\s*"([^"]+)"/),m=t.match(/\[package\][\s\S]*?description\s*=\s*"([^"]+)"/),c={},l=t.match(/\[dependencies\]([\s\S]*?)(?:\n\[|$)/);if(l){const r=l[1].split(`
+`);for(const a of r){const i=a.match(/^([a-zA-Z0-9_-]+)\s*=\s*(?:"([^"]+)"|{[^}]*version\s*=\s*"([^"]+)")/);i&&(c[i[1]]=i[2]||i[3]||"*")}}const u=t.match(/\[workspace\][\s\S]*?members\s*=\s*\[([\s\S]*?)\]/),o=[];if(u){const r=u[1].split(",").map(a=>a.trim().replace(/["']/g,"")).filter(Boolean);o.push(...r)}return{language:"Rust",name:n?.[1]||this.getProjectName(e),description:m?.[1],dependencies:c,manifestFile:"Cargo.toml",projectPath:e,workspaceMembers:o.length>0?o:void 0}}getTemplates(){return[{name:"rust-core",tags:["rust"],content:()=>this.loadTemplateFromFile(f.join(__dirname,"templates/lang-rust.md")).then(e=>e||this.getRustFallbackTemplate())}]}getRustFallbackTemplate(){return`# Rust Development Guidelines
 
 This project uses Rust.
 
@@ -26,4 +26,4 @@ This project uses Rust.
 ## Dependencies
 - Manage with Cargo.toml
 - Review crate security
-- Keep dependencies updated`}]}getDependencyTagMap(){return{tokio:"tokio","actix-web":"actix",rocket:"rocket",serde:"serde"}}}exports.RustPlugin=g;
+- Keep dependencies updated`}getDependencyTagMap(){return{tokio:"tokio","actix-web":"actix",rocket:"rocket",serde:"serde"}}}exports.RustPlugin=h;

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

@@ -1,13 +1,14 @@
-import { B as p } from "../BasePlugin-6wv0hYJ9.js";
-class d extends p {
+import * as p from "node:path";
+import { B as u } from "../BasePlugin-6wv0hYJ9.js";
+class h extends u {
   constructor() {
     super(...arguments), this.name = "rust", this.displayName = "Rust", this.version = "3.0.0", this.priority = 80;
   }
   async detect(e) {
     if (!this.fileExists(e, "Cargo.toml"))
       return null;
-    const s = this.readFile(e, "Cargo.toml");
-    if (!s)
+    const t = this.readFile(e, "Cargo.toml");
+    if (!t)
       return {
         language: "Rust",
         name: this.getProjectName(e),
@@ -15,25 +16,25 @@ class d extends p {
         manifestFile: "Cargo.toml",
         projectPath: e
       };
-    const m = s.match(/\[package\][\s\S]*?name\s*=\s*"([^"]+)"/), l = s.match(/\[package\][\s\S]*?description\s*=\s*"([^"]+)"/), r = {}, a = s.match(/\[dependencies\]([\s\S]*?)(?:\n\[|$)/);
-    if (a) {
-      const i = a[1].split(`
+    const l = t.match(/\[package\][\s\S]*?name\s*=\s*"([^"]+)"/), m = t.match(/\[package\][\s\S]*?description\s*=\s*"([^"]+)"/), a = {}, r = t.match(/\[dependencies\]([\s\S]*?)(?:\n\[|$)/);
+    if (r) {
+      const i = r[1].split(`
 `);
       for (const o of i) {
-        const t = o.match(/^([a-zA-Z0-9_-]+)\s*=\s*(?:"([^"]+)"|{[^}]*version\s*=\s*"([^"]+)")/);
-        t && (r[t[1]] = t[2] || t[3] || "*");
+        const s = o.match(/^([a-zA-Z0-9_-]+)\s*=\s*(?:"([^"]+)"|{[^}]*version\s*=\s*"([^"]+)")/);
+        s && (a[s[1]] = s[2] || s[3] || "*");
       }
     }
-    const c = s.match(/\[workspace\][\s\S]*?members\s*=\s*\[([\s\S]*?)\]/), n = [];
+    const c = t.match(/\[workspace\][\s\S]*?members\s*=\s*\[([\s\S]*?)\]/), n = [];
     if (c) {
       const i = c[1].split(",").map((o) => o.trim().replace(/["']/g, "")).filter(Boolean);
       n.push(...i);
     }
     return {
       language: "Rust",
-      name: m?.[1] || this.getProjectName(e),
-      description: l?.[1],
-      dependencies: r,
+      name: l?.[1] || this.getProjectName(e),
+      description: m?.[1],
+      dependencies: a,
       manifestFile: "Cargo.toml",
       projectPath: e,
       workspaceMembers: n.length > 0 ? n : void 0
@@ -44,7 +45,14 @@ class d extends p {
       {
         name: "rust-core",
         tags: ["rust"],
-        content: `# Rust Development Guidelines
+        content: () => this.loadTemplateFromFile(
+          p.join(__dirname, "templates/lang-rust.md")
+        ).then((e) => e || this.getRustFallbackTemplate())
+      }
+    ];
+  }
+  getRustFallbackTemplate() {
+    return `# Rust Development Guidelines
 
 This project uses Rust.
 
@@ -71,9 +79,7 @@ This project uses Rust.
 ## Dependencies
 - Manage with Cargo.toml
 - Review crate security
-- Keep dependencies updated`
-      }
-    ];
+- Keep dependencies updated`;
   }
   getDependencyTagMap() {
     return {
@@ -85,5 +91,5 @@ This project uses Rust.
   }
 }
 export {
-  d as RustPlugin
+  h as RustPlugin
 };

package/dist/rust/templates/lang-rust.md

@@ -0,0 +1,89 @@
+# Rust Development Guidelines
+
+## Overview
+This project uses Rust. Follow Rust idioms, ownership rules, and best practices.
+
+## Code Style
+- Use `rustfmt` for automatic code formatting
+- Follow the [Rust API Guidelines](https://rust-lang.github.io/api-guidelines/)
+- Use `clippy` for linting: `cargo clippy`
+- Keep functions small and focused
+- Use descriptive variable names
+
+## Ownership & Borrowing
+- Follow Rust's ownership rules strictly
+- Prefer borrowing (`&T`) over taking ownership when possible
+- Use `&mut T` for mutable borrows
+- Avoid unnecessary `.clone()` calls
+- Use `Cow<'_, T>` for conditional ownership
+
+## Error Handling
+- Use `Result<T, E>` for operations that can fail
+- Use the `?` operator for error propagation
+- Create custom error types using `thiserror` crate
+- Avoid `unwrap()` and `expect()` in production code
+- Provide meaningful error messages
+
+## Types & Traits
+- Use strong typing and avoid `String` everywhere
+- Implement common traits (`Debug`, `Clone`, `PartialEq`) when appropriate
+- Use `derive` macros for automatic implementations
+- Define traits for shared behavior
+- Use generics for code reuse
+
+## Cargo Commands
+- Build: `cargo build` (debug) or `cargo build --release` (optimized)
+- Run: `cargo run`
+- Test: `cargo test`
+- Check: `cargo check` (faster than build for syntax checking)
+- Format: `cargo fmt`
+- Lint: `cargo clippy`
+- Doc: `cargo doc --open`
+
+## Project Structure
+- `src/main.rs` - Binary entry point
+- `src/lib.rs` - Library entry point
+- `src/bin/` - Additional binaries
+- `tests/` - Integration tests
+- `benches/` - Benchmarks
+- `examples/` - Example code
+
+## Dependencies
+- Add dependencies in `Cargo.toml`
+- Use semantic versioning
+- Run `cargo update` to update dependencies
+- Check for outdated deps: `cargo outdated`
+
+## Testing
+- Write unit tests in the same file: `#[cfg(test)] mod tests { ... }`
+- Write integration tests in `tests/` directory
+- Use `assert!`, `assert_eq!`, `assert_ne!` macros
+- Run specific tests: `cargo test test_name`
+- Run with output: `cargo test -- --nocapture`
+
+## Async/Await
+- Use `tokio` or `async-std` for async runtime
+- Mark async functions with `async fn`
+- Use `.await` to wait for futures
+- Use `#[tokio::main]` or `#[async_std::main]` for async main
+
+## Documentation
+- Use `///` for public API documentation
+- Use `//!` for module-level documentation
+- Include examples in doc comments
+- Run `cargo doc` to generate documentation
+- Use `#[doc = "..."]` for advanced docs
+
+## Performance
+- Profile before optimizing: use `cargo flamegraph`
+- Use release builds for benchmarks: `cargo bench`
+- Avoid unnecessary allocations
+- Use iterators instead of loops when appropriate
+- Consider using `rayon` for parallel processing
+
+## Common Patterns
+- Builder pattern for complex constructors
+- Newtype pattern for type safety
+- Use `match` for exhaustive pattern matching
+- Use `if let` for simple pattern matching
+- Use `Option<T>` instead of null

package/dist/swift/index.cjs

@@ -0,0 +1,32 @@
+"use strict";Object.defineProperty(exports,Symbol.toStringTag,{value:"Module"});const u=require("node:path"),p=require("../BasePlugin-odQJAKA-.cjs");function d(a){const e=Object.create(null,{[Symbol.toStringTag]:{value:"Module"}});if(a){for(const t in a)if(t!=="default"){const s=Object.getOwnPropertyDescriptor(a,t);Object.defineProperty(e,t,s.get?s:{enumerable:!0,get:()=>a[t]})}}return e.default=a,Object.freeze(e)}const g=d(u);class m extends p.BasePlugin{constructor(){super(...arguments),this.name="swift",this.displayName="Swift",this.version="3.0.0",this.priority=75}async detect(e){if(this.fileExists(e,"Package.swift"))return this.detectSPM(e);const t=await this.hasFiles(e,"**/*.xcodeproj"),s=await this.hasFiles(e,"**/*.xcworkspace");return t||s?this.detectXcode(e):await this.hasFiles(e,"**/*.swift")?{language:"Swift",name:this.getProjectName(e),dependencies:{},projectPath:e}:null}getTemplates(){return[{name:"swift-core",tags:["swift"],content:()=>this.loadTemplateFromFile(g.join(__dirname,"templates/lang-swift.md")).then(e=>e||this.getSwiftFallbackTemplate())}]}getSwiftFallbackTemplate(){return`# Swift Development Guidelines
+
+This project uses Swift.
+
+## Project Structure
+- Follow Swift Package Manager conventions
+- Use clear module organization
+- Separate concerns appropriately
+
+## Code Style
+- Follow Swift API Design Guidelines
+- Use Swift naming conventions (lowerCamelCase for vars/funcs, UpperCamelCase for types)
+- Leverage SwiftLint for consistency
+- Prefer value types (structs) over reference types when appropriate
+
+## Best Practices
+- Use optionals safely with guard/if let
+- Leverage protocol-oriented programming
+- Use strong type system features
+- Handle errors with do/catch or Result types
+- Write clear documentation comments
+
+## Async/Concurrency
+- Use async/await for asynchronous operations
+- Use actors for shared mutable state
+- Understand structured concurrency patterns
+
+## Testing
+- Write XCTest unit tests
+- Use Quick/Nimble for BDD-style tests (if applicable)
+- Mock dependencies appropriately
+- Test async code with expectations`}getDependencyTagMap(){return{vapor:"vapor",Vapor:"vapor",swift:"swift"}}detectSPM(e){const t=this.readFile(e,"Package.swift");if(!t)return{language:"Swift",name:this.getProjectName(e),dependencies:{},manifestFile:"Package.swift",projectPath:e};const s={},i={language:"Swift",name:this.getProjectName(e),dependencies:s,manifestFile:"Package.swift",projectPath:e},n=t.match(/name:\s*"([^"]+)"/);n&&(i.name=n[1]);const r=t.match(/swift-tools-version:\s*([\d.]+)/);r&&(i.description=`Swift ${r[1]}`),(t.includes("vapor")||t.includes("Vapor"))&&(s.vapor="*");const c=t.matchAll(/\.package\([^)]+url:\s*"([^"]+)"/g);for(const l of c){const o=l[1],f=o.split("/").pop()?.replace(".git","")||o;s[f]="*"}return i}detectXcode(e){return{language:"Swift",name:this.getProjectName(e),dependencies:{},description:"Xcode project",projectPath:e}}}exports.SwiftPlugin=m;

package/dist/swift/index.mjs

@@ -0,0 +1,112 @@
+import * as p from "node:path";
+import { B as f } from "../BasePlugin-6wv0hYJ9.js";
+class u extends f {
+  constructor() {
+    super(...arguments), this.name = "swift", this.displayName = "Swift", this.version = "3.0.0", this.priority = 75;
+  }
+  async detect(e) {
+    if (this.fileExists(e, "Package.swift"))
+      return this.detectSPM(e);
+    const t = await this.hasFiles(e, "**/*.xcodeproj"), s = await this.hasFiles(
+      e,
+      "**/*.xcworkspace"
+    );
+    return t || s ? this.detectXcode(e) : await this.hasFiles(e, "**/*.swift") ? {
+      language: "Swift",
+      name: this.getProjectName(e),
+      dependencies: {},
+      projectPath: e
+    } : null;
+  }
+  getTemplates() {
+    return [
+      {
+        name: "swift-core",
+        tags: ["swift"],
+        content: () => this.loadTemplateFromFile(
+          p.join(__dirname, "templates/lang-swift.md")
+        ).then((e) => e || this.getSwiftFallbackTemplate())
+      }
+    ];
+  }
+  getSwiftFallbackTemplate() {
+    return `# Swift Development Guidelines
+
+This project uses Swift.
+
+## Project Structure
+- Follow Swift Package Manager conventions
+- Use clear module organization
+- Separate concerns appropriately
+
+## Code Style
+- Follow Swift API Design Guidelines
+- Use Swift naming conventions (lowerCamelCase for vars/funcs, UpperCamelCase for types)
+- Leverage SwiftLint for consistency
+- Prefer value types (structs) over reference types when appropriate
+
+## Best Practices
+- Use optionals safely with guard/if let
+- Leverage protocol-oriented programming
+- Use strong type system features
+- Handle errors with do/catch or Result types
+- Write clear documentation comments
+
+## Async/Concurrency
+- Use async/await for asynchronous operations
+- Use actors for shared mutable state
+- Understand structured concurrency patterns
+
+## Testing
+- Write XCTest unit tests
+- Use Quick/Nimble for BDD-style tests (if applicable)
+- Mock dependencies appropriately
+- Test async code with expectations`;
+  }
+  getDependencyTagMap() {
+    return {
+      vapor: "vapor",
+      Vapor: "vapor",
+      swift: "swift"
+    };
+  }
+  detectSPM(e) {
+    const t = this.readFile(e, "Package.swift");
+    if (!t)
+      return {
+        language: "Swift",
+        name: this.getProjectName(e),
+        dependencies: {},
+        manifestFile: "Package.swift",
+        projectPath: e
+      };
+    const s = {}, a = {
+      language: "Swift",
+      name: this.getProjectName(e),
+      dependencies: s,
+      manifestFile: "Package.swift",
+      projectPath: e
+    }, i = t.match(/name:\s*"([^"]+)"/);
+    i && (a.name = i[1]);
+    const n = t.match(/swift-tools-version:\s*([\d.]+)/);
+    n && (a.description = `Swift ${n[1]}`), (t.includes("vapor") || t.includes("Vapor")) && (s.vapor = "*");
+    const o = t.matchAll(/\.package\([^)]+url:\s*"([^"]+)"/g);
+    for (const c of o) {
+      const r = c[1], l = r.split("/").pop()?.replace(".git", "") || r;
+      s[l] = "*";
+    }
+    return a;
+  }
+  detectXcode(e) {
+    return {
+      language: "Swift",
+      name: this.getProjectName(e),
+      dependencies: {},
+      description: "Xcode project",
+      projectPath: e
+    };
+  }
+}
+export {
+  u as SwiftPlugin
+};