dxrk 0.1.0__tar.gz

dxrk-0.1.0/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 Dxrk777
+
+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.

dxrk-0.1.0/PKG-INFO

@@ -0,0 +1,22 @@
+Metadata-Version: 2.4
+Name: dxrk
+Version: 0.1.0
+Summary: Dxrk Ecosystem Configurator — supercharge AI coding agents
+Author: Dxrk777
+License: MIT
+Project-URL: Homepage, https://github.com/Dxrk777/Dxrk
+Requires-Python: >=3.13
+License-File: LICENSE
+Requires-Dist: textual<9.0,>=1.0
+Requires-Dist: httpx<1.0,>=0.27
+Requires-Dist: PyYAML>=6.0
+Requires-Dist: cryptography<46.0,>=43.0
+Requires-Dist: beautifulsoup4<5,>=4.12
+Provides-Extra: dev
+Requires-Dist: pytest>=8.0; extra == "dev"
+Requires-Dist: pytest-cov>=5.0; extra == "dev"
+Requires-Dist: pytest-asyncio>=0.24; extra == "dev"
+Provides-Extra: typecheck
+Requires-Dist: mypy>=1.10; extra == "typecheck"
+Requires-Dist: pytest>=8.0; extra == "typecheck"
+Dynamic: license-file

dxrk-0.1.0/README.md

@@ -0,0 +1,161 @@
+# Dxrk
+
+<p align="center">
+  <strong>Ecosistema, Frameworks y Workflows para agentes de IA</strong>
+</p>
+
+<p align="center">
+  <a href="https://github.com/Dxrk777/Dxrk/releases"><img src="https://img.shields.io/badge/Release-v0.1.0-blue" alt="Release"></a>
+  <a href="LICENSE"><img src="https://img.shields.io/badge/License-MIT-green" alt="License"></a>
+  <a href="https://www.python.org/downloads/"><img src="https://img.shields.io/badge/Python-3.13%2B-3776AB" alt="Python 3.13+"></a>
+  <a href="https://github.com/Dxrk777/Dxrk"><img src="https://img.shields.io/badge/Platform-macOS%20%7C%20Linux%20%7C%20Windows-lightgrey" alt="Platform"></a>
+  <a href="https://github.com/Dxrk777/Dxrk/actions"><img src="https://img.shields.io/github/actions/workflow/status/Dxrk777/Dxrk/ci.yml" alt="CI"></a>
+  <a href="https://github.com/Dxrk777/Dxrk/stargazers"><img src="https://img.shields.io/github/stars/Dxrk777/Dxrk" alt="Stars"></a>
+</p>
+
+---
+
+## Qué es Dxrk
+
+**Dxrk** es el configurador y orquestador de ecosistemas para agentes de IA. Unifica
+memoria persistente, Spec-Driven Development, skills curadas, servidores MCP y un
+conmutador de proveedores de modelos en una sola herramienta de línea de comandos.
+
+Escrito en **Python 3.13+** con una TUI basada en Textual, Dxrk:
+
+- Configura **42 agentes de IA** (Claude Code, OpenCode, Codex, Gemini CLI, Cursor,
+  Copilot, Windsurf y más) con un solo comando.
+- Mantiene **memoria persistente** entre sesiones y proyectos (SDD, decisiones,
+  contexto, aprender de cada interacción).
+- Gestiona **skills curadas** y servidores **MCP** por proyecto.
+- Conmuta entre **proveedores y modelos de IA** con perfiles de costo por fase
+  (cheap/balanced/quality) o por comando.
+- Ejecuta **workflows** de desarrollo: planificación, commits con conventional
+  commits, PRs, revisión de código, keybindings y más.
+
+## Instalación
+
+Requisito: **Python 3.13 o superior**.
+
+### Con uv (recomendado)
+
+```bash
+uv tool install --from git+https://github.com/Dxrk777/Dxrk.git dxrk
+```
+
+### Con pip
+
+```bash
+pip install git+https://github.com/Dxrk777/Dxrk.git
+```
+
+### Desde el código fuente
+
+```bash
+git clone https://github.com/Dxrk777/Dxrk.git
+cd Dxrk
+uv sync --all-extras
+uv run dxrk-py --help
+```
+
+## Uso rápido
+
+```bash
+# Instalar y configurar un agente
+dxrk-py install --agent claude-code --preset full-dxrk
+
+# Preguntar sobre un concepto
+dxrk-py query "explica qué es Spec-Driven Development"
+
+# Sincronizar perfil de modelos barato
+dxrk-py sync --profile cheap:openrouter/qwen/qwen3-30b-a3b:free
+
+# Perfil por fase (ej. diseño)
+dxrk-py sync --profile-phase cheap:sdd-design:anthropic/claude-sonnet-4-20250514
+```
+
+## Agentes soportados (42)
+
+| | | | |
+|---|---|---|---|
+| Claude Code | OpenCode | Kilo Code | Gemini CLI |
+| Cursor | VS Code Copilot | Codex | Windsurf |
+| Antigravity | Kimi Code | Kiro IDE | Qwen Code |
+| Pi | OpenClaw | Aider | Cline |
+| Roo Code | Continue | Junie | Amazon Q |
+| OpenHands | Zed AI | GitHub Copilot | Devin |
+| Cody | Tabnine | Replit | Void |
+| Amp | Blackbox AI | Bolt.new | Conductor |
+| Hermes | JetBrains AI | Looperators | Lovable |
+| PearAI | Qodo | RunCell | Trae |
+| v0 | ZCode | | |
+
+## Características
+
+- **Memoria persistente**: `dxrk-memory` (binario externo en
+  [Dxrk777/dxrk-memory](https://github.com/Dxrk777/dxrk-memory), instalable vía
+  Homebrew o GitHub Releases) con búsqueda semántica: `dxrk-memory search "SDD"`.
+- **Spec-Driven Development**: inicialización por proyecto con `/sdd-init`,
+  especificaciones, diseño y verificación.
+- **Skills**: `dxrk-py skill-registry refresh` para sincronizar el registro de
+  skills del proyecto.
+- **Servidores MCP**: 35 servidores configurables vía `.mcp.json`.
+- **Conmutador de modelos**: perfiles `cheap` / `balanced` / `quality`, asignación
+  por fase (sdd-design, sdd-spec, sdd-tasks, etc.).
+- **TUI**: interfaz Textual con detección de agentes instalados.
+- **Workflows Git**: commits con conventional commits, PRs con revisión,
+  keybindings configurables.
+
+## Estructura del proyecto
+
+```
+dxrk/
+├── __main__.py            # Entry point CLI
+├── autonomy/              # Aprendizaje, evolución, verificador
+├── cli/                   # Comandos de instalación y ejecución
+├── commands/              # Comandos del orquestador (commit, plan, mcp, ...)
+├── config/                # Configuración y validación
+├── mcp/                   # Clientes MCP
+├── observe/               # Observabilidad y traces
+├── query/                 # Motor de consultas
+├── rag/                   # Retrieval-Augmented Generation
+├── security/              # JWT, permisos
+├── system/                # Detección de plataforma y gestión del sistema
+├── tools/                 # Herramientas del agente
+├── trace/                 # Trazabilidad
+├── tui/                   # Interfaz Textual
+└── utils/                 # Utilidades (fileops, hooks, http, ...)
+```
+
+## Desarrollo
+
+```bash
+uv sync --all-extras          # Instalar dependencias y extras
+uv run pytest                 # Suite de tests (2760+ tests)
+uv run --with mypy mypy dxrk/ # Type checking
+```
+
+## Roadmap
+
+- **v4.1.0** — pipeline de entrenamiento ML, pre-commit, dependabot, más integraciones.
+- **v4.2.0** — marketplace de plugins.
+- **v5.0.0** — multi-tenant.
+
+## Documentación
+
+| Documento | Descripción |
+|---|---|
+| [docs/intended-usage.md](docs/intended-usage.md) | Uso intencional del ecosistema |
+| [docs/agents.md](docs/agents.md) | Agentes soportados |
+| [docs/components.md](docs/components.md) | Componentes del sistema |
+| [docs/architecture.md](docs/architecture.md) | Arquitectura |
+| [docs/usage.md](docs/usage.md) | Guía de uso |
+| [docs/platforms.md](docs/platforms.md) | Plataformas |
+
+## Licencia
+
+MIT — ver [LICENSE](LICENSE).
+
+---
+
+**DXRK // BEYOND LIMITS**

dxrk-0.1.0/dxrk/__init__.py

@@ -0,0 +1,2 @@
+# SPDX-License-Identifier: MIT
+

dxrk-0.1.0/dxrk/__main__.py

@@ -0,0 +1,254 @@
+# SPDX-License-Identifier: MIT
+#!/usr/bin/env python3
+"""
+Dxrk — Unified CLI + TUI entry point.
+"""
+
+from __future__ import annotations
+
+import argparse
+import logging
+import os
+import sys
+
+
+def main() -> None:
+    parser = argparse.ArgumentParser(description="Dxrk — Agent Ecosystem Manager")
+    parser.add_argument("--version", "-v", action="store_true", help="Show version")
+    parser.add_argument("--health", action="store_true", help="Run health check")
+    parser.add_argument(
+        "--tui", action="store_true", help="Launch TUI (default if no args)"
+    )
+    parser.add_argument("--debug", action="store_true", help="Enable debug logging")
+
+    sub = parser.add_subparsers(dest="command")
+
+    # dxrk install
+    install_parser = sub.add_parser("install", help="Install agents and components")
+    install_parser.add_argument(
+        "--agent", "-a", action="append", dest="agents", help="Agent to install"
+    )
+    install_parser.add_argument(
+        "--component",
+        "-c",
+        action="append",
+        dest="components",
+        help="Component to install",
+    )
+    install_parser.add_argument(
+        "--persona", choices=["gentleman", "neutral", "custom"], default="gentleman"
+    )
+    install_parser.add_argument(
+        "--preset", choices=["full-gentleman", "ecosystem-only", "minimal", "custom"]
+    )
+    install_parser.add_argument(
+        "--dry-run", action="store_true", help="Preview without installing"
+    )
+
+    # dxrk sync
+    sync_parser = sub.add_parser("sync", help="Sync configuration to disk")
+    sync_parser.add_argument(
+        "--agent", "-a", action="append", dest="agents", help="Agent to sync"
+    )
+    sync_parser.add_argument(
+        "--dry-run", action="store_true", help="Preview without syncing"
+    )
+    sync_parser.add_argument(
+        "--sdd-mode", type=str, default="", help="SDD mode (single/multi)"
+    )
+    sync_parser.add_argument(
+        "--strict-tdd", action="store_true", default=False, help="Enable strict TDD"
+    )
+    sync_parser.add_argument(
+        "--include-permissions",
+        action="store_true",
+        default=False,
+        help="Include permissions",
+    )
+    sync_parser.add_argument(
+        "--include-theme", action="store_true", default=False, help="Include theme"
+    )
+
+    # dxrk upgrade
+    upg_parser = sub.add_parser("upgrade", help="Upgrade installed components")
+
+    # dxrk uninstall
+    uninstall_parser = sub.add_parser(
+        "uninstall", help="Uninstall agents and components"
+    )
+    uninstall_parser.add_argument("--agent", action="append", dest="agents")
+    uninstall_parser.add_argument("--component", action="append", dest="components")
+    uninstall_parser.add_argument(
+        "--all", action="store_true", default=False, help="Uninstall all"
+    )
+    uninstall_parser.add_argument(
+        "--yes", "-y", action="store_true", default=False, help="Skip confirmation"
+    )
+
+    # dxrk backup / restore
+    sub.add_parser("backup", help="Manage backups")
+    restore_parser = sub.add_parser("restore", help="Restore from a backup")
+    restore_parser.add_argument("backup_id", nargs="?", help="Backup ID to restore")
+
+    # dxrk model
+    model_parser = sub.add_parser("model", help="Configure model assignments")
+    model_parser.add_argument("phase", nargs="?", help="SDD phase to configure")
+    model_parser.add_argument("--provider", help="Provider ID")
+    model_parser.add_argument("--model", help="Model ID")
+
+    # dxrk version
+    sub.add_parser("version", help="Show version")
+
+    args = parser.parse_args()
+
+    if args.debug:
+        logging.basicConfig(
+            level=logging.DEBUG, format="%(levelname)s %(name)s: %(message)s"
+        )
+    else:
+        logging.basicConfig(level=logging.WARNING)
+
+    version = os.environ.get("DXRK_VERSION", "dev")
+
+    if args.version or args.command == "version":
+        print(f"Dxrk v{version}")
+        return
+
+    if args.health:
+        from dxrk.system import detect, render_dependency_report
+
+        result = detect()
+        assert result.dependencies is not None, (
+            "detection did not populate dependencies"
+        )
+        print(render_dependency_report(result.dependencies))
+        return
+
+    if args.command == "install":
+        _run_install_cli(args)
+        return
+
+    if args.command == "sync":
+        _run_sync_cli(args)
+        return
+
+    if args.command == "uninstall":
+        _run_uninstall_cli(args)
+        return
+
+    if args.command == "backup":
+        _run_backup_cli()
+        return
+
+    if args.command == "restore":
+        _run_restore_cli(args)
+        return
+
+    if args.command == "upgrade":
+        print("Upgrade not yet implemented")
+        return
+
+    if args.command == "model":
+        _run_model_cli(args)
+        return
+
+    if args.command:
+        print(f"Command '{args.command}' not yet implemented")
+        return
+
+    _launch_tui(version)
+
+
+def _run_install_cli(args) -> None:
+    from dxrk.system import detect
+
+    result = detect()
+    if not result.system.supported:
+        print("Unsupported system:", result.system.os)
+        sys.exit(1)
+
+    from dxrk.cli.install import run_install
+
+    raw = sys.argv[2:]
+
+    out = run_install(raw, detection=result)
+    if out.dry_run:
+        rev = out.review
+        if rev:
+            print("=== Dry Run Review ===")
+            print(f"  Agents selected: {len(rev.agents)}")
+            print(f"  Unsupported agents: {len(rev.unsupported_agents)}")
+            print(f"  Persona: {rev.persona}")
+            print(f"  Preset: {rev.preset}")
+            print(f"  Components: {len(rev.components)}")
+            print(f"  Skills: {len(rev.skills)}")
+            print(f"  Strict TDD: {rev.strict_tdd}")
+            print(f"  Has SDD: {rev.has_sdd}")
+            if rev.platform_decision:
+                pd = rev.platform_decision
+                print(f"  OS: {pd.os} / {pd.linux_distro}")
+        return
+
+
+def _launch_tui(version: str) -> None:
+    from dxrk.tui.app import run as run_tui
+
+    run_tui(version)
+
+
+def _run_sync_cli(args) -> None:
+    from dxrk.cli.sync import RunSync
+
+    raw = sys.argv[2:]
+    result = RunSync(raw)
+    if hasattr(result, "dry_run") and result.dry_run:
+        print("=== Dry Run Sync ===")
+        print(f"  Agents: {len(result.agents)}")
+        print(f"  SDD Mode: {getattr(result.selection, 'sdd_mode', 'N/A')}")
+        print(f"  Strict TDD: {result.selection.strict_tdd}")
+        return
+
+    print(f"Sync complete — {getattr(result, 'files_changed', 0)} files changed")
+
+
+def _run_uninstall_cli(args) -> None:
+    from dxrk.cli.uninstall import RunUninstall
+
+    raw = sys.argv[2:]
+    result = RunUninstall(raw)
+    if hasattr(result, "removed_files"):
+        manual = getattr(result, "manual_actions", [])
+        if manual:
+            print("Manual actions required:")
+            for a in manual:
+                print(f"  {a}")
+        print("Uninstall complete")
+
+
+def _run_backup_cli() -> None:
+    from dxrk.backup import list_backups
+
+    backups = list_backups()
+    if not backups:
+        print("No backups found")
+        return
+    for b in backups:
+        print(f"  {b}")
+
+
+def _run_restore_cli(args) -> None:
+    from dxrk.cli.restore import RunRestore
+
+    raw = sys.argv[2:]
+    RunRestore(raw)
+
+
+def _run_model_cli(args) -> None:
+    if args.phase:
+        print(f"Model config for phase '{args.phase}' not yet implemented")
+    else:
+        print("Model configuration not yet implemented")
+
+
+if __name__ == "__main__":
+    main()