mirdan 0.0.1__tar.gz

mirdan-0.0.1/.github/workflows/ci.yml

@@ -0,0 +1,123 @@
+name: CI
+
+on:
+  push:
+    branches: [main]
+  pull_request:
+    branches: [main]
+
+concurrency:
+  group: ${{ github.workflow }}-${{ github.ref }}
+  cancel-in-progress: true
+
+jobs:
+  lint:
+    name: Lint
+    runs-on: ubuntu-latest
+    steps:
+      - name: Checkout code
+        uses: actions/checkout@11bd71901bbe5b1630ceea73d27597364c9af683 # v4.2.2
+
+      - name: Install uv
+        uses: astral-sh/setup-uv@6b9c6063abd6010835644d4c2e1bef4cf5cd0fca # v4.2.0
+        with:
+          enable-cache: true
+          cache-dependency-glob: "uv.lock"
+
+      - name: Set up Python
+        run: uv python install 3.13
+
+      - name: Install dependencies
+        run: uv sync --all-extras --all-groups
+
+      - name: Run ruff check
+        run: uv run ruff check src/mirdan tests
+
+      - name: Run ruff format check
+        run: uv run ruff format --check src/mirdan tests
+
+  typecheck:
+    name: Type Check
+    runs-on: ubuntu-latest
+    steps:
+      - name: Checkout code
+        uses: actions/checkout@11bd71901bbe5b1630ceea73d27597364c9af683 # v4.2.2
+
+      - name: Install uv
+        uses: astral-sh/setup-uv@6b9c6063abd6010835644d4c2e1bef4cf5cd0fca # v4.2.0
+        with:
+          enable-cache: true
+          cache-dependency-glob: "uv.lock"
+
+      - name: Set up Python
+        run: uv python install 3.13
+
+      - name: Install dependencies
+        run: uv sync --all-extras --all-groups
+
+      - name: Run mypy
+        run: uv run mypy src/mirdan
+
+  test:
+    name: Test (Python ${{ matrix.python-version }})
+    runs-on: ubuntu-latest
+    strategy:
+      fail-fast: false
+      matrix:
+        python-version: ["3.11", "3.12", "3.13"]
+    steps:
+      - name: Checkout code
+        uses: actions/checkout@11bd71901bbe5b1630ceea73d27597364c9af683 # v4.2.2
+
+      - name: Install uv
+        uses: astral-sh/setup-uv@6b9c6063abd6010835644d4c2e1bef4cf5cd0fca # v4.2.0
+        with:
+          enable-cache: true
+          cache-dependency-glob: "uv.lock"
+
+      - name: Set up Python ${{ matrix.python-version }}
+        run: uv python install ${{ matrix.python-version }}
+
+      - name: Install dependencies
+        run: uv sync --all-extras --all-groups
+
+      - name: Run tests
+        run: uv run pytest --cov=mirdan --cov-report=xml
+
+      - name: Upload coverage to Codecov
+        if: matrix.python-version == '3.13'
+        uses: codecov/codecov-action@ad3126e916f78f00edff4ed0317cf185271ccc2d # v5.4.2
+        with:
+          files: ./coverage.xml
+          fail_ci_if_error: false
+
+  build:
+    name: Build
+    runs-on: ubuntu-latest
+    steps:
+      - name: Checkout code
+        uses: actions/checkout@11bd71901bbe5b1630ceea73d27597364c9af683 # v4.2.2
+
+      - name: Install uv
+        uses: astral-sh/setup-uv@6b9c6063abd6010835644d4c2e1bef4cf5cd0fca # v4.2.0
+        with:
+          enable-cache: true
+          cache-dependency-glob: "uv.lock"
+
+      - name: Set up Python
+        run: uv python install 3.13
+
+      - name: Build package
+        run: uv build
+
+      - name: Verify wheel contents
+        run: |
+          pip install dist/*.whl --target /tmp/verify
+          python -c "import sys; sys.path.insert(0, '/tmp/verify'); from mirdan.server import mcp; print('Import successful')"
+
+      - name: Upload build artifacts
+        uses: actions/upload-artifact@ea165f8d65b6e75b540449e92b4886f43607fa02 # v4.6.2
+        with:
+          name: dist
+          path: dist/
+          retention-days: 7

mirdan-0.0.1/.github/workflows/publish.yml

@@ -0,0 +1,115 @@
+name: Publish to PyPI
+
+on:
+  release:
+    types: [published]
+
+jobs:
+  build:
+    name: Build distribution
+    runs-on: ubuntu-latest
+    steps:
+      - name: Validate release tag format
+        run: |
+          TAG="${{ github.ref_name }}"
+          if [[ ! "$TAG" =~ ^[0-9]+\.[0-9]+\.[0-9]+(-[a-zA-Z0-9.]+)?$ ]]; then
+            echo "Error: Release tag '$TAG' does not follow semantic versioning (e.g., 0.1.0, 1.0.0-beta.1)"
+            exit 1
+          fi
+          echo "Valid semantic version: $TAG"
+
+      - name: Checkout code
+        uses: actions/checkout@11bd71901bbe5b1630ceea73d27597364c9af683 # v4.2.2
+
+      - name: Install uv
+        uses: astral-sh/setup-uv@6b9c6063abd6010835644d4c2e1bef4cf5cd0fca # v4.2.0
+        with:
+          enable-cache: true
+          cache-dependency-glob: "uv.lock"
+
+      - name: Set up Python
+        run: uv python install 3.13
+
+      - name: Create virtual environment and install dependencies
+        run: |
+          uv venv
+          uv pip install build twine
+
+      - name: Build sdist and wheel
+        run: uv run python -m build
+
+      - name: Check distribution with twine
+        run: uv run twine check dist/*
+
+      - name: Upload distribution artifacts
+        uses: actions/upload-artifact@ea165f8d65b6e75b540449e92b4886f43607fa02 # v4.6.2
+        with:
+          name: dist
+          path: dist/
+          if-no-files-found: error
+
+  test-publish:
+    name: Publish to TestPyPI
+    needs: build
+    runs-on: ubuntu-latest
+    environment:
+      name: testpypi
+      url: https://test.pypi.org/p/mirdan
+    permissions:
+      id-token: write
+    steps:
+      - name: Download distribution artifacts
+        uses: actions/download-artifact@d3f86a106a0bac45b974a628896c90dbdf5c8093 # v4.3.0
+        with:
+          name: dist
+          path: dist/
+
+      - name: Publish to TestPyPI
+        uses: pypa/gh-action-pypi-publish@76f52bc884231f62b9a034ebfe128415bbaabdfc # v1.12.4
+        with:
+          repository-url: https://test.pypi.org/legacy/
+          attestations: true
+
+  verify-testpypi:
+    name: Verify TestPyPI installation
+    needs: test-publish
+    runs-on: ubuntu-latest
+    steps:
+      - name: Set up Python
+        uses: actions/setup-python@a26af69be951a213d495a4c3e4e4022e16d87065 # v5.6.0
+        with:
+          python-version: "3.13"
+
+      - name: Wait for TestPyPI to update
+        run: sleep 30
+
+      - name: Install from TestPyPI
+        run: |
+          pip install --index-url https://test.pypi.org/simple/ \
+            --extra-index-url https://pypi.org/simple/ \
+            mirdan
+
+      - name: Verify installation
+        run: |
+          python -c "import mirdan; print(f'Successfully imported mirdan version: {mirdan.__version__}')"
+
+  publish:
+    name: Publish to PyPI
+    needs: verify-testpypi
+    runs-on: ubuntu-latest
+    environment:
+      name: pypi
+      url: https://pypi.org/p/mirdan
+    permissions:
+      id-token: write
+    steps:
+      - name: Download distribution artifacts
+        uses: actions/download-artifact@d3f86a106a0bac45b974a628896c90dbdf5c8093 # v4.3.0
+        with:
+          name: dist
+          path: dist/
+
+      - name: Publish to PyPI
+        uses: pypa/gh-action-pypi-publish@76f52bc884231f62b9a034ebfe128415bbaabdfc # v1.12.4
+        with:
+          attestations: true

mirdan-0.0.1/.gitignore

@@ -0,0 +1,83 @@
+# Byte-compiled / optimized / DLL files
+__pycache__/
+*.py[cod]
+*$py.class
+
+# C extensions
+*.so
+
+# Distribution / packaging
+.Python
+build/
+develop-eggs/
+dist/
+downloads/
+eggs/
+.eggs/
+lib/
+lib64/
+parts/
+sdist/
+var/
+wheels/
+*.egg-info/
+.installed.cfg
+*.egg
+
+# PyInstaller
+*.manifest
+*.spec
+
+# Installer logs
+pip-log.txt
+pip-delete-this-directory.txt
+
+# Unit test / coverage reports
+htmlcov/
+.tox/
+.nox/
+.coverage
+.coverage.*
+.cache
+nosetests.xml
+coverage.xml
+*.cover
+*.py,cover
+.hypothesis/
+.pytest_cache/
+
+# Translations
+*.mo
+*.pot
+
+# Environments
+.env
+.venv
+env/
+venv/
+ENV/
+env.bak/
+venv.bak/
+
+# IDEs
+.idea/
+.vscode/
+*.swp
+*.swo
+*~
+
+# mypy
+.mypy_cache/
+.dmypy.json
+dmypy.json
+
+# ruff
+.ruff_cache/
+
+# OS
+.DS_Store
+Thumbs.db
+
+# Project specific
+.mirdan/
+*.local.yaml

mirdan-0.0.1/.python-version

@@ -0,0 +1 @@
+3.13

mirdan-0.0.1/PKG-INFO

@@ -0,0 +1,126 @@
+Metadata-Version: 2.4
+Name: mirdan
+Version: 0.0.1
+Summary: AI Code Quality Orchestrator - Automatically transforms developer prompts into high-quality, structured requests
+Author: Sean Corkum
+License-Expression: MIT
+Keywords: ai,code-quality,llm,mcp,prompt-engineering
+Classifier: Development Status :: 3 - Alpha
+Classifier: Intended Audience :: Developers
+Classifier: License :: OSI Approved :: MIT License
+Classifier: Programming Language :: Python :: 3.11
+Classifier: Programming Language :: Python :: 3.12
+Classifier: Programming Language :: Python :: 3.13
+Classifier: Topic :: Software Development :: Quality Assurance
+Requires-Python: >=3.11
+Requires-Dist: fastmcp>=2.0.0
+Requires-Dist: pydantic>=2.0
+Requires-Dist: pyyaml>=6.0
+Provides-Extra: dev
+Requires-Dist: mypy>=1.13; extra == 'dev'
+Requires-Dist: pytest-asyncio>=0.24; extra == 'dev'
+Requires-Dist: pytest>=8.0; extra == 'dev'
+Requires-Dist: ruff>=0.8; extra == 'dev'
+Requires-Dist: types-pyyaml>=6.0; extra == 'dev'
+Description-Content-Type: text/markdown
+
+# Mirdan
+
+AI Code Quality Orchestrator - Automatically transforms developer prompts into high-quality, structured requests that maximize AI coding assistant capabilities.
+
+## The Problem
+
+AI coding assistants produce "slop" not because the models are incapable, but because developers provide prompts that lack context, structure, and quality constraints. Research shows properly structured prompts achieve 15-74% better results.
+
+## The Solution
+
+Mirdan is an MCP server that intercepts prompts, automatically enhances them with quality requirements, codebase context, and architectural patterns, then intelligently orchestrates other available MCPs to ground the AI in reality.
+
+## Features
+
+- **Intent Analysis**: Classifies task type (generation, refactor, debug, review, test)
+- **Quality Injection**: Applies language-specific coding standards and security requirements
+- **Prompt Composition**: Structures prompts using proven frameworks (Role/Goal/Constraints)
+- **MCP Orchestration**: Recommends which tools to use for context gathering
+- **Verification Checklists**: Generates task-specific verification steps
+
+## Installation
+
+```bash
+# Using uv
+uv add mirdan
+
+# Or with pip
+pip install mirdan
+```
+
+## Quick Start
+
+### As an MCP Server
+
+Add to your Claude Code configuration:
+
+```json
+{
+  "mcpServers": {
+    "mirdan": {
+      "command": "uv",
+      "args": ["run", "mirdan"]
+    }
+  }
+}
+```
+
+### Available Tools
+
+#### enhance_prompt
+
+Automatically enhance a coding prompt with quality requirements and tool recommendations.
+
+#### analyze_intent
+
+Analyze a prompt without enhancement to understand the detected intent.
+
+#### get_quality_standards
+
+Retrieve quality standards for a language/framework combination.
+
+#### suggest_tools
+
+Get recommendations for which MCP tools to use.
+
+## Configuration
+
+Create a `.mirdan/config.yaml` in your project:
+
+```yaml
+version: "1.0"
+
+project:
+  name: "MyApp"
+  primary_language: "typescript"
+  frameworks: ["next.js", "prisma"]
+
+quality:
+  security: "strict"
+  architecture: "moderate"
+```
+
+## Development
+
+```bash
+# Clone and install
+git clone https://github.com/S-Corkum/mirdan.git
+cd mirdan
+uv sync --all-extras
+
+# Run tests
+uv run pytest
+
+# Run the server locally
+uv run mirdan
+```
+
+## License
+
+MIT

mirdan-0.0.1/README.md

@@ -0,0 +1,100 @@
+# Mirdan
+
+AI Code Quality Orchestrator - Automatically transforms developer prompts into high-quality, structured requests that maximize AI coding assistant capabilities.
+
+## The Problem
+
+AI coding assistants produce "slop" not because the models are incapable, but because developers provide prompts that lack context, structure, and quality constraints. Research shows properly structured prompts achieve 15-74% better results.
+
+## The Solution
+
+Mirdan is an MCP server that intercepts prompts, automatically enhances them with quality requirements, codebase context, and architectural patterns, then intelligently orchestrates other available MCPs to ground the AI in reality.
+
+## Features
+
+- **Intent Analysis**: Classifies task type (generation, refactor, debug, review, test)
+- **Quality Injection**: Applies language-specific coding standards and security requirements
+- **Prompt Composition**: Structures prompts using proven frameworks (Role/Goal/Constraints)
+- **MCP Orchestration**: Recommends which tools to use for context gathering
+- **Verification Checklists**: Generates task-specific verification steps
+
+## Installation
+
+```bash
+# Using uv
+uv add mirdan
+
+# Or with pip
+pip install mirdan
+```
+
+## Quick Start
+
+### As an MCP Server
+
+Add to your Claude Code configuration:
+
+```json
+{
+  "mcpServers": {
+    "mirdan": {
+      "command": "uv",
+      "args": ["run", "mirdan"]
+    }
+  }
+}
+```
+
+### Available Tools
+
+#### enhance_prompt
+
+Automatically enhance a coding prompt with quality requirements and tool recommendations.
+
+#### analyze_intent
+
+Analyze a prompt without enhancement to understand the detected intent.
+
+#### get_quality_standards
+
+Retrieve quality standards for a language/framework combination.
+
+#### suggest_tools
+
+Get recommendations for which MCP tools to use.
+
+## Configuration
+
+Create a `.mirdan/config.yaml` in your project:
+
+```yaml
+version: "1.0"
+
+project:
+  name: "MyApp"
+  primary_language: "typescript"
+  frameworks: ["next.js", "prisma"]
+
+quality:
+  security: "strict"
+  architecture: "moderate"
+```
+
+## Development
+
+```bash
+# Clone and install
+git clone https://github.com/S-Corkum/mirdan.git
+cd mirdan
+uv sync --all-extras
+
+# Run tests
+uv run pytest
+
+# Run the server locally
+uv run mirdan
+```
+
+## License
+
+MIT

mirdan-0.0.1/pyproject.toml

@@ -0,0 +1,64 @@
+[project]
+name = "mirdan"
+version = "0.0.1"
+description = "AI Code Quality Orchestrator - Automatically transforms developer prompts into high-quality, structured requests"
+readme = "README.md"
+requires-python = ">=3.11"
+license = "MIT"
+authors = [
+    { name = "Sean Corkum" }
+]
+keywords = ["mcp", "ai", "code-quality", "prompt-engineering", "llm"]
+classifiers = [
+    "Development Status :: 3 - Alpha",
+    "Intended Audience :: Developers",
+    "License :: OSI Approved :: MIT License",
+    "Programming Language :: Python :: 3.11",
+    "Programming Language :: Python :: 3.12",
+    "Programming Language :: Python :: 3.13",
+    "Topic :: Software Development :: Quality Assurance",
+]
+dependencies = [
+    "fastmcp>=2.0.0",
+    "pyyaml>=6.0",
+    "pydantic>=2.0",
+]
+
+[project.optional-dependencies]
+dev = [
+    "pytest>=8.0",
+    "pytest-asyncio>=0.24",
+    "ruff>=0.8",
+    "mypy>=1.13",
+    "types-PyYAML>=6.0",
+]
+
+[project.scripts]
+mirdan = "mirdan.server:main"
+
+[build-system]
+requires = ["hatchling"]
+build-backend = "hatchling.build"
+
+[tool.hatch.build.targets.wheel]
+packages = ["src/mirdan"]
+
+[tool.ruff]
+line-length = 100
+target-version = "py311"
+
+[tool.ruff.lint]
+select = ["E", "F", "I", "N", "W", "UP"]
+
+[tool.mypy]
+python_version = "3.11"
+strict = true
+
+[tool.pytest.ini_options]
+asyncio_mode = "auto"
+testpaths = ["tests"]
+
+[dependency-groups]
+dev = [
+    "pytest-cov>=7.0.0",
+]

mirdan-0.0.1/src/mirdan/__init__.py

@@ -0,0 +1,8 @@
+"""
+Mirdan: AI Code Quality Orchestrator
+
+Automatically transforms developer prompts into high-quality,
+structured requests that maximize AI coding assistant capabilities.
+"""
+
+__version__ = "0.0.1"