mdx-code 0.1.0__py3-none-any.whl

mdx_code-0.1.0.dist-info/METADATA

@@ -0,0 +1,316 @@
+Metadata-Version: 2.4
+Name: mdx-code
+Version: 0.1.0
+Summary: AI-Native Engineering Companion. Built for builders. Designed for regulated environments.
+Author: MD
+License: MIT
+Project-URL: Homepage, https://github.com/dhotherm/mdx-code
+Project-URL: Documentation, https://github.com/dhotherm/mdx-code#readme
+Project-URL: Repository, https://github.com/dhotherm/mdx-code
+Project-URL: Issues, https://github.com/dhotherm/mdx-code/issues
+Keywords: ai,llm,claude,developer-tools,agents,agentic-ai,code-assistant
+Classifier: Development Status :: 4 - Beta
+Classifier: Environment :: Console
+Classifier: Intended Audience :: Developers
+Classifier: License :: OSI Approved :: MIT License
+Classifier: Operating System :: OS Independent
+Classifier: Programming Language :: Python :: 3
+Classifier: Programming Language :: Python :: 3.9
+Classifier: Programming Language :: Python :: 3.10
+Classifier: Programming Language :: Python :: 3.11
+Classifier: Programming Language :: Python :: 3.12
+Classifier: Topic :: Software Development
+Classifier: Topic :: Software Development :: Code Generators
+Requires-Python: >=3.9
+Description-Content-Type: text/markdown
+License-File: LICENSE
+Requires-Dist: anthropic>=0.40.0
+Requires-Dist: httpx>=0.27.0
+Requires-Dist: pydantic>=2.0.0
+Requires-Dist: typer>=0.12.0
+Requires-Dist: rich>=13.0.0
+Requires-Dist: pyyaml>=6.0
+Requires-Dist: python-dotenv>=1.0.0
+Provides-Extra: dev
+Requires-Dist: pytest>=8.0.0; extra == "dev"
+Requires-Dist: pytest-asyncio>=0.23.0; extra == "dev"
+Requires-Dist: black>=24.0.0; extra == "dev"
+Requires-Dist: mypy>=1.8.0; extra == "dev"
+Provides-Extra: openai
+Requires-Dist: openai>=1.0.0; extra == "openai"
+Provides-Extra: bedrock
+Requires-Dist: boto3>=1.34.0; extra == "bedrock"
+Provides-Extra: all
+Requires-Dist: openai>=1.0.0; extra == "all"
+Requires-Dist: boto3>=1.34.0; extra == "all"
+Requires-Dist: google-cloud-aiplatform>=1.0.0; extra == "all"
+Dynamic: license-file
+
+# MDx Code
+
+**AI-Native Engineering Companion**
+
+Built for builders. Designed for regulated environments.
+
+---
+
+## The Story
+
+I've been thinking about AI-powered development tools for over a year. Then I read an article that broke down Claude Code from first principles and realized something: the core architecture is embarrassingly simple.
+
+```python
+while task_not_complete:
+    response = ask_llm(conversation)
+    if response.wants_tool:
+        result = execute_tool(response.tool)
+        conversation.append(result)
+    if response.done:
+        break
+```
+
+That's it. AI thinks → acts → observes → repeats.
+
+Everything else is just tooling and governance wrapped around this loop.
+
+So I built my own. Not because Claude Code isn't good... it's excellent. But because I needed something that:
+
+- **Works in regulated environments** → Financial services, healthcare, government
+- **Owns the orchestration layer** → Swap models without rewriting everything
+- **Respects governance rules** → Audit trails, permission controls, compliance profiles
+- **Learns over time** → The security agent gets smarter with use
+
+MDx Code is that tool.
+
+---
+
+## Quick Start
+
+**Option 1: Install directly from GitHub (recommended)**
+```bash
+pip install git+https://github.com/dhotherm/mdx-code.git
+```
+
+**Option 2: Clone and install locally**
+```bash
+git clone https://github.com/dhotherm/mdx-code.git
+cd mdx-code
+pip install -e .
+```
+
+**Then authenticate and run:**
+```bash
+# Authenticate with Claude
+mdxcode auth claude
+
+# Initialize in your project
+cd your-project
+mdxcode init
+
+# Run it
+mdxcode main "Fix the bug in auth.py"
+```
+
+---
+
+## What It Does
+
+**Give it a task. Watch it work.**
+
+```bash
+mdxcode "Add input validation to the user registration endpoint"
+```
+
+MDx Code will:
+1. Read your MDXCODE.md for project context
+2. Find the relevant files
+3. Understand the existing patterns
+4. Make changes incrementally
+5. Run tests to verify
+6. Log everything for audit
+
+**Scan for vulnerabilities:**
+
+```bash
+mdxcode security scan
+```
+
+**Auto-fix issues:**
+
+```bash
+mdxcode security fix --auto-fix
+```
+
+---
+
+## MDXCODE.md
+
+Every project gets a context file. This is how MDx Code understands your project before touching anything.
+
+```markdown
+# MDXCODE.md
+
+## Project
+- **Name:** Claims Processing API
+- **Domain:** Health
+- **Team:** Health Platform
+
+## Conventions
+- All endpoints require JWT auth
+- Use Pydantic for request/response models
+- Event sourcing for state changes
+
+## Compliance
+- PHI fields use SL-encrypt utility
+- Never log PHI in plain text
+
+## Guardrails
+- ❌ Never commit directly to main
+- ❌ Never modify production configs
+- ⚠️ Schema changes require approval
+```
+
+Different domains, different rules. The context file captures all of that.
+
+---
+
+## Regulatory Profiles
+
+MDx Code ships with profiles for regulated industries:
+
+| Profile | Description |
+|---------|-------------|
+| `standard` | Default. Sensible permissions for most projects. |
+| `financial_services` | Stricter controls for OSFI/SOX compliance. |
+| `healthcare` | HIPAA-aware. Extra protection for PHI. |
+| `government` | Maximum restrictions. Minimal auto-approval. |
+
+```bash
+mdxcode "Update the API" --profile financial_services
+```
+
+---
+
+## Multi-Model Support
+
+Own the orchestration. Swap the models.
+
+```bash
+mdxcode "Fix the bug" --model claude    # Default
+mdxcode "Fix the bug" --model gpt       # OpenAI
+mdxcode "Fix the bug" --model bedrock   # AWS Bedrock
+```
+
+Today it's Claude. Tomorrow it could be anything. Your choice.
+
+---
+
+## Security Agent
+
+Not just a linter. An AI that understands context.
+
+```bash
+# Scan for vulnerabilities
+mdxcode security scan
+
+# Scan specific path
+mdxcode security scan --path src/
+
+# Auto-fix what can be fixed
+mdxcode security fix --auto-fix
+
+# Teach it new patterns
+mdxcode security learn
+```
+
+The knowledge base grows as you use it. Every fix teaches it something new.
+
+---
+
+## Audit Trail
+
+Every action. Every decision. Logged.
+
+```bash
+~/.mdxcode/audit/2026-01-09_abc123.jsonl
+```
+
+```json
+{
+  "timestamp": "2026-01-09T14:32:15Z",
+  "event": "tool_use",
+  "tool": "write_file",
+  "input": {"path": "src/api.py", "content": "..."},
+  "approved_by": "user",
+  "session_id": "abc123"
+}
+```
+
+Essential for compliance. Essential for trust.
+
+---
+
+## Project Structure
+
+```
+mdx-code/
+├── mdxcode.py          # CLI entry point
+├── core/
+│   ├── agent_loop.py   # The heart of it
+│   ├── context_loader.py
+│   └── session.py
+├── tools/
+│   └── registry.py     # read, write, edit, bash, grep, glob
+├── models/
+│   ├── router.py       # Multi-model support
+│   └── auth.py         # Credential management
+├── governance/
+│   ├── permissions.py  # What's allowed
+│   ├── audit.py        # Logging everything
+│   └── security_agent.py
+├── knowledge/
+│   └── vulnerabilities/
+└── examples/
+    └── demo_project/
+```
+
+---
+
+## Philosophy
+
+**Own the orchestration layer.**
+
+Models will come and go. Vendors will compete on capability and cost. But the orchestration... the context engineering, the governance, the institutional knowledge... that's yours.
+
+**Built for regulated environments.**
+
+This isn't a toy. It's designed for environments where compliance matters, where audit trails are required, where "move fast and break things" gets you fired.
+
+**Learn over time.**
+
+The security agent grows smarter. The patterns library expands. Every project teaches it something new.
+
+---
+
+## Contributing
+
+Found a bug? Want to add a feature? PRs welcome.
+
+The code is intentionally readable. If you can't understand it in an afternoon, I've failed.
+
+---
+
+## License
+
+MIT. Use it. Modify it. Build on it.
+
+---
+
+## Author
+
+Built by MD.
+
+Not because I had to. Because I couldn't stop thinking about it.
+
+---
+
+*"The future of software development is agents that can actually do things. Now we know how they work."*

mdx_code-0.1.0.dist-info/RECORD

@@ -0,0 +1,21 @@
+mdx_code-0.1.0.dist-info/licenses/LICENSE,sha256=pp9j0Bt7MSztJrKcWtA2iSgzaq5dKjAcHLIMRzhpQfE,1059
+mdxcode/__init__.py,sha256=KAV8lCmAOOGD0nb97qPES5Q-6mVVAzfBE5wZMhy4TlA,207
+mdxcode/cli.py,sha256=83FYSWJH0LeWU7oAHpyRO1wFnDMRJYa7Ck2pZhWMmjI,9180
+mdxcode/core/__init__.py,sha256=J8fXKYUK_t38aUkrCMxpIhULwN_d4tIsxYkWS50AR6k,569
+mdxcode/core/agent_loop.py,sha256=4CsuSPVqITgSNFeu4f1fXqzSGGlLHTeAXiqrtyyqZ3o,11124
+mdxcode/core/context_loader.py,sha256=JZFUh54fR_fG6k-irlM3_XY9tUvmlkzXsrpJR1Co98k,6210
+mdxcode/core/session.py,sha256=T4KoJ0Lp7kuB8jOjR9YR_Ol7nhc6jKUSduFody0D6ws,2649
+mdxcode/governance/__init__.py,sha256=N7NsrVq5KjxCarbQdSx9VNcMbhBMjqbk3EYwUCiTcCY,853
+mdxcode/governance/audit.py,sha256=FVpJQW8pzfTMNhnyu6VR7epRpSCjmxG8b7aLxUVOyBQ,5925
+mdxcode/governance/permissions.py,sha256=kMTMovUZhh8CCFNVc72UXNY9_f8nwYe_Xabog1Nk2TM,9621
+mdxcode/governance/security_agent.py,sha256=IPq0FR0FafeDvOTv0Q23jY01T2JcjmN5ar5nuZPLx7M,13496
+mdxcode/models/__init__.py,sha256=QJFphYKPDBaQe72ae7aO_CHNaarVbG4uh66jktjCQDk,667
+mdxcode/models/auth.py,sha256=BLiI2MPjWsd2uhlpK07YZK0B_xW3_R0bmJ-b2VzV0vk,7421
+mdxcode/models/router.py,sha256=gW9wk5lBTd0ynUWI8pdXzs31IsPmIOU2R_2qHJGBijI,5925
+mdxcode/tools/__init__.py,sha256=R9ZhVo5QRSG7doLBtmaJdxEmEg0Vo0FY8u5CRgorPis,384
+mdxcode/tools/registry.py,sha256=lzXh83VSc6KybpDT7cEhK2j-P_ew7F8e82_zZfONHSA,13546
+mdx_code-0.1.0.dist-info/METADATA,sha256=vLalCddIQdShxmgN5X1-SYzdPPKMfEyFUMFB2Lxyn8E,7897
+mdx_code-0.1.0.dist-info/WHEEL,sha256=_zCd3N1l69ArxyTb8rzEoP9TpbYXkqRFSNOD5OuxnTs,91
+mdx_code-0.1.0.dist-info/entry_points.txt,sha256=dtFrZaULL68n911H7enEuP1wnUn_YWvsrYt6Ir9x0vw,40
+mdx_code-0.1.0.dist-info/top_level.txt,sha256=VcIBQaqm0bIrugT9-6e_en1y2nMATWmkF_KC_50_fPc,8
+mdx_code-0.1.0.dist-info/RECORD,,

mdx_code-0.1.0.dist-info/WHEEL

@@ -0,0 +1,5 @@
+Wheel-Version: 1.0
+Generator: setuptools (80.9.0)
+Root-Is-Purelib: true
+Tag: py3-none-any
+

mdx_code-0.1.0.dist-info/entry_points.txt

@@ -0,0 +1,2 @@
+[console_scripts]
+mdxcode = mdxcode:run

mdx_code-0.1.0.dist-info/licenses/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 MD
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

mdx_code-0.1.0.dist-info/top_level.txt

@@ -0,0 +1 @@
+mdxcode

mdxcode/__init__.py

@@ -0,0 +1,11 @@
+"""
+MDx Code - AI-Native Engineering Companion
+
+Built for builders. Designed for regulated environments.
+"""
+
+__version__ = "0.1.0"
+
+from mdxcode.cli import app, run
+
+__all__ = ["app", "run", "__version__"]

mdxcode/cli.py

@@ -0,0 +1,269 @@
+#!/usr/bin/env python3
+"""
+MDx Code - AI-Native Engineering Companion
+
+Built for builders. Designed for regulated environments.
+Own the orchestration. Swap the models. Keep the governance.
+
+This is what happens when you realize Claude Code's architecture
+is embarrassingly simple... and decide to build your own.
+
+Author: MD
+License: MIT
+"""
+
+import asyncio
+import sys
+from pathlib import Path
+
+import typer
+from rich.console import Console
+from rich.panel import Panel
+from rich.text import Text
+
+from mdxcode.core.agent_loop import AgentLoop
+from mdxcode.core.context_loader import load_mdxcode_context
+from mdxcode.core.session import Session
+from mdxcode.governance.audit import AuditLogger
+from mdxcode.models.router import ModelRouter
+
+# The CLI app
+app = typer.Typer(
+    name="mdxcode",
+    help="AI-Native Engineering Companion. Built for builders.",
+    add_completion=False,
+)
+
+console = Console()
+
+# Version
+__version__ = "0.1.0"
+
+
+def version_callback(value: bool):
+    """Show version and exit."""
+    if value:
+        console.print(f"[bold cyan]MDx Code[/bold cyan] v{__version__}")
+        raise typer.Exit()
+
+
+# ASCII art banner - MDx CODE with style
+BANNER_ART = """
+[bold cyan]
+ ███╗   ███╗[/bold cyan][cyan]██████╗[/cyan] [dim cyan]x[/dim cyan]   [bold white]██████╗ ██████╗ ██████╗ ███████╗[/bold white]
+[bold cyan] ████╗ ████║[/bold cyan][cyan]██╔══██╗[/cyan]     [bold white]██╔════╝██╔═══██╗██╔══██╗██╔════╝[/bold white]
+[bold cyan] ██╔████╔██║[/bold cyan][cyan]██║  ██║[/cyan]     [bold white]██║     ██║   ██║██║  ██║█████╗[/bold white]
+[bold cyan] ██║╚██╔╝██║[/bold cyan][cyan]██║  ██║[/cyan]     [bold white]██║     ██║   ██║██║  ██║██╔══╝[/bold white]
+[bold cyan] ██║ ╚═╝ ██║[/bold cyan][cyan]██████╔╝[/cyan]     [bold white]╚██████╗╚██████╔╝██████╔╝███████╗[/bold white]
+[bold cyan] ╚═╝     ╚═╝[/bold cyan][cyan]╚═════╝[/cyan]      [bold white]╚═════╝ ╚═════╝ ╚═════╝ ╚══════╝[/bold white]
+"""
+
+
+def show_banner():
+    """Show the MDx Code banner. First impressions matter."""
+    from rich.markup import escape
+    
+    console.print(BANNER_ART)
+    console.print(f"  [dim]v{__version__}[/dim]  [italic]Built for builders. Designed for regulated environments.[/italic]\n")
+    console.print("  [bold green]Yoooooo! Let's ship some code.[/bold green] 🚀\n")
+
+
+@app.callback(invoke_without_command=True)
+def app_callback(
+    ctx: typer.Context,
+    version: bool = typer.Option(False, "--version", "-V", help="Show version and exit.", callback=version_callback, is_eager=True),
+):
+    """MDx Code - AI-Native Engineering Companion."""
+    if ctx.invoked_subcommand is None:
+        show_banner()
+        console.print("Run [bold]mdxcode --help[/bold] for usage.\n")
+
+
+@app.command()
+def main(
+    task: str = typer.Argument(None, help="What do you want to work on?"),
+    model: str = typer.Option("claude", "--model", "-m", help="Model to use: claude, gpt, bedrock"),
+    profile: str = typer.Option("standard", "--profile", "-p", help="Regulatory profile: standard, financial_services, healthcare"),
+    verbose: bool = typer.Option(False, "--verbose", "-v", help="Show detailed output"),
+    dry_run: bool = typer.Option(False, "--dry-run", help="Show what would happen without executing"),
+):
+    """
+    Run MDx Code on a task.
+    
+    Examples:
+        mdxcode "Fix the bug in auth.py"
+        mdxcode "Add tests for the claims module" --model gpt
+        mdxcode "Scan for security vulnerabilities" --profile financial_services
+    """
+    show_banner()
+    
+    # Load project context if MDXCODE.md exists
+    context = load_mdxcode_context()
+    if context:
+        console.print(f"[dim]Loaded context from MDXCODE.md[/dim]")
+        if context.project_name:
+            console.print(f"[dim]Project: {context.project_name} ({context.domain})[/dim]")
+    
+    # If no task provided, enter interactive mode
+    if not task:
+        console.print("\n[cyan]No task provided. Entering interactive mode...[/cyan]\n")
+        task = console.input("[bold]What do you want to work on?[/bold] → ")
+        if not task.strip():
+            console.print("[dim]Nothing to do. Exiting.[/dim]")
+            raise typer.Exit()
+    
+    # Initialize the session
+    session = Session(
+        model=model,
+        profile=profile,
+        context=context,
+        verbose=verbose,
+        dry_run=dry_run,
+    )
+    
+    # Initialize audit logging
+    audit = AuditLogger(session)
+    audit.log_session_start(task)
+    
+    # Initialize model router
+    router = ModelRouter(model)
+    
+    # Initialize and run the agent loop
+    # This is where the magic happens.
+    # AI thinks → acts → observes → repeats.
+    agent = AgentLoop(
+        session=session,
+        router=router,
+        audit=audit,
+        console=console,
+    )
+    
+    try:
+        asyncio.run(agent.run(task))
+    except KeyboardInterrupt:
+        console.print("\n[yellow]Interrupted. Saving session state...[/yellow]")
+        audit.log_session_end("interrupted")
+    except Exception as e:
+        console.print(f"\n[red]Error: {e}[/red]")
+        audit.log_session_end("error", str(e))
+        raise typer.Exit(1)
+    else:
+        audit.log_session_end("success")
+    
+    console.print("\n[dim]Session complete. Audit log saved.[/dim]")
+
+
+@app.command()
+def auth(
+    provider: str = typer.Argument(..., help="Provider to authenticate: claude, openai, bedrock"),
+):
+    """
+    Authenticate with an LLM provider.
+    
+    Examples:
+        mdxcode auth claude
+        mdxcode auth openai
+    """
+    from mdxcode.models.auth import authenticate
+    
+    show_banner()
+    console.print(f"\n[cyan]Authenticating with {provider}...[/cyan]\n")
+    
+    success = asyncio.run(authenticate(provider, console))
+    
+    if success:
+        console.print(f"\n[green]✓ Authenticated with {provider}[/green]")
+    else:
+        console.print(f"\n[red]✗ Authentication failed[/red]")
+        raise typer.Exit(1)
+
+
+@app.command()
+def security(
+    action: str = typer.Argument("scan", help="Action: scan, fix, learn"),
+    path: str = typer.Option(".", "--path", "-p", help="Path to scan"),
+    auto_fix: bool = typer.Option(False, "--auto-fix", help="Automatically apply fixes"),
+):
+    """
+    Security agent for vulnerability scanning and remediation.
+    
+    Examples:
+        mdxcode security scan
+        mdxcode security scan --path src/
+        mdxcode security fix --auto-fix
+    """
+    from mdxcode.governance.security_agent import SecurityAgent
+    
+    show_banner()
+    console.print(f"\n[cyan]MDx Code Security Agent[/cyan]\n")
+    
+    agent = SecurityAgent(console)
+    
+    if action == "scan":
+        asyncio.run(agent.scan(path))
+    elif action == "fix":
+        asyncio.run(agent.fix(path, auto_fix=auto_fix))
+    elif action == "learn":
+        asyncio.run(agent.learn())
+    else:
+        console.print(f"[red]Unknown action: {action}[/red]")
+        raise typer.Exit(1)
+
+
+@app.command()
+def init():
+    """
+    Initialize MDx Code in the current directory.
+    
+    Creates a starter MDXCODE.md file with sensible defaults.
+    """
+    show_banner()
+    
+    mdxcode_path = Path("MDXCODE.md")
+    
+    if mdxcode_path.exists():
+        console.print("[yellow]MDXCODE.md already exists. Skipping.[/yellow]")
+        raise typer.Exit()
+    
+    from mdxcode.core.context_loader import create_starter_mdxcode
+    
+    create_starter_mdxcode(mdxcode_path)
+    console.print("[green]✓ Created MDXCODE.md[/green]")
+    console.print("[dim]Edit this file to customize MDx Code for your project.[/dim]")
+
+
+@app.command()
+def status():
+    """
+    Show current MDx Code status and configuration.
+    """
+    show_banner()
+    
+    from mdxcode.core.context_loader import load_mdxcode_context
+    from mdxcode.models.auth import get_authenticated_providers
+    
+    context = load_mdxcode_context()
+    providers = get_authenticated_providers()
+    
+    console.print("\n[bold]Configuration[/bold]")
+    console.print(f"  MDXCODE.md: {'[green]Found[/green]' if context else '[yellow]Not found[/yellow]'}")
+    if context:
+        console.print(f"  Project: {context.project_name or 'Not set'}")
+        console.print(f"  Domain: {context.domain or 'Not set'}")
+        console.print(f"  Profile: {context.regulatory_profile or 'standard'}")
+    
+    console.print("\n[bold]Authenticated Providers[/bold]")
+    if providers:
+        for provider in providers:
+            console.print(f"  [green]✓[/green] {provider}")
+    else:
+        console.print("  [yellow]None. Run 'mdxcode auth <provider>' to authenticate.[/yellow]")
+
+
+def run():
+    """Entry point for the CLI."""
+    app()
+
+
+if __name__ == "__main__":
+    run()

mdxcode/core/__init__.py

@@ -0,0 +1,26 @@
+"""
+MDx Code Core
+
+The fundamental building blocks:
+- Agent Loop: The while loop that powers everything
+- Session: State management for a single run
+- Context Loader: Reading MDXCODE.md files
+"""
+
+from mdxcode.core.agent_loop import AgentLoop
+from mdxcode.core.session import Session
+from mdxcode.core.context_loader import (
+    MDXCodeContext,
+    load_mdxcode_context,
+    parse_mdxcode,
+    create_starter_mdxcode,
+)
+
+__all__ = [
+    "AgentLoop",
+    "Session",
+    "MDXCodeContext",
+    "load_mdxcode_context",
+    "parse_mdxcode",
+    "create_starter_mdxcode",
+]