codrsync 1.0.0__tar.gz

codrsync-1.0.0/PKG-INFO

@@ -0,0 +1,166 @@
+Metadata-Version: 2.4
+Name: codrsync
+Version: 1.0.0
+Summary: Turn any dev into jedi ninja codr
+Author-email: Ciro Arendt <ciro@ciroarendt.com>
+License: MIT
+Project-URL: Homepage, https://codrsync.dev
+Project-URL: Documentation, https://codrsync.dev/docs
+Project-URL: Repository, https://github.com/ciroarendt/codrsync
+Project-URL: Issues, https://github.com/ciroarendt/codrsync/issues
+Keywords: cli,ai,development,orchestrator,claude,prp,codrsync
+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.10
+Classifier: Programming Language :: Python :: 3.11
+Classifier: Programming Language :: Python :: 3.12
+Classifier: Programming Language :: Python :: 3.13
+Classifier: Topic :: Software Development
+Classifier: Topic :: Software Development :: Code Generators
+Requires-Python: >=3.10
+Description-Content-Type: text/markdown
+Requires-Dist: typer>=0.9.0
+Requires-Dist: rich>=13.0.0
+Requires-Dist: anthropic>=0.18.0
+Requires-Dist: pydantic>=2.0.0
+Requires-Dist: python-dotenv>=1.0.0
+Requires-Dist: openpyxl>=3.1.0
+Requires-Dist: questionary>=2.0.0
+Provides-Extra: dev
+Requires-Dist: pytest>=7.0.0; extra == "dev"
+Requires-Dist: pytest-cov>=4.0.0; extra == "dev"
+Requires-Dist: black>=23.0.0; extra == "dev"
+Requires-Dist: ruff>=0.1.0; extra == "dev"
+Requires-Dist: mypy>=1.0.0; extra == "dev"
+
+# codrsync CLI
+
+**Turn any dev into jedi ninja codr** - AI-powered development orchestrator.
+
+## Installation
+
+```bash
+pip install codrsync
+```
+
+Or from source:
+
+```bash
+cd cli
+pip install -e .
+```
+
+## Quick Start
+
+```bash
+# Configure authentication (uses YOUR Claude Code or API key)
+codrsync auth
+
+# Create a new project
+codrsync init
+
+# Check project status
+codrsync status
+
+# View roadmap
+codrsync roadmap
+
+# Start a sprint
+codrsync sprint start
+
+# Export to Excel/Jira/Trello
+codrsync export excel
+```
+
+## Commands
+
+### Local (work offline)
+
+| Command | Description |
+|---------|-------------|
+| `codrsync status` | Show project dashboard |
+| `codrsync roadmap` | Show timeline and dependencies |
+| `codrsync sprint` | Manage sprints |
+| `codrsync export` | Export to Excel, Jira, Trello, Notion |
+
+### AI-powered (use your Claude)
+
+| Command | Description |
+|---------|-------------|
+| `codrsync init` | Interactive project kickstart |
+| `codrsync build` | AI-guided development |
+| `codrsync prp` | Manage PRPs |
+
+## Authentication
+
+codrsync uses YOUR Claude Code installation or Anthropic API key.
+
+```bash
+# Configure once
+codrsync auth
+
+# Options:
+# 1. Use Claude Code (if installed) - recommended
+# 2. Use Anthropic API key
+# 3. Offline mode (limited features)
+```
+
+**You pay for your own AI usage.** codrsync provides the intelligence through prompts.
+
+## How It Works
+
+```
+┌─────────────────────────────────────────────────────────────┐
+│                     CODRSYNC CLI                            │
+├─────────────────────────────────────────────────────────────┤
+│                                                             │
+│  LOCAL (free, offline)          AI (your Claude/API)        │
+│  ────────────────────           ──────────────────          │
+│  • status                       • init (kickstart)          │
+│  • roadmap                      • build (implement)         │
+│  • sprint                       • prp generate              │
+│  • export                       • research                  │
+│                                                             │
+│  Reads JSON files               Uses YOUR account           │
+│  No API calls                   You pay for usage           │
+│                                                             │
+└─────────────────────────────────────────────────────────────┘
+```
+
+## Project Structure
+
+When you run `codrsync init`, it creates:
+
+```
+your-project/
+├── doc/project/
+│   ├── manifest.json      # Project metadata
+│   └── progress.json      # Progress tracking
+├── doc/task/
+│   └── context-session.md # Current context
+├── PRPs/                  # Product Requirement Prompts
+├── src/                   # Your code
+├── tests/                 # Your tests
+└── exports/               # Exported reports
+```
+
+## Diagnostics
+
+```bash
+codrsync doctor
+```
+
+Shows:
+- Python version
+- Claude Code installation
+- API key status
+- Current project
+- Dependencies
+
+## License
+
+MIT

codrsync-1.0.0/README.md

@@ -0,0 +1,127 @@
+# codrsync CLI
+
+**Turn any dev into jedi ninja codr** - AI-powered development orchestrator.
+
+## Installation
+
+```bash
+pip install codrsync
+```
+
+Or from source:
+
+```bash
+cd cli
+pip install -e .
+```
+
+## Quick Start
+
+```bash
+# Configure authentication (uses YOUR Claude Code or API key)
+codrsync auth
+
+# Create a new project
+codrsync init
+
+# Check project status
+codrsync status
+
+# View roadmap
+codrsync roadmap
+
+# Start a sprint
+codrsync sprint start
+
+# Export to Excel/Jira/Trello
+codrsync export excel
+```
+
+## Commands
+
+### Local (work offline)
+
+| Command | Description |
+|---------|-------------|
+| `codrsync status` | Show project dashboard |
+| `codrsync roadmap` | Show timeline and dependencies |
+| `codrsync sprint` | Manage sprints |
+| `codrsync export` | Export to Excel, Jira, Trello, Notion |
+
+### AI-powered (use your Claude)
+
+| Command | Description |
+|---------|-------------|
+| `codrsync init` | Interactive project kickstart |
+| `codrsync build` | AI-guided development |
+| `codrsync prp` | Manage PRPs |
+
+## Authentication
+
+codrsync uses YOUR Claude Code installation or Anthropic API key.
+
+```bash
+# Configure once
+codrsync auth
+
+# Options:
+# 1. Use Claude Code (if installed) - recommended
+# 2. Use Anthropic API key
+# 3. Offline mode (limited features)
+```
+
+**You pay for your own AI usage.** codrsync provides the intelligence through prompts.
+
+## How It Works
+
+```
+┌─────────────────────────────────────────────────────────────┐
+│                     CODRSYNC CLI                            │
+├─────────────────────────────────────────────────────────────┤
+│                                                             │
+│  LOCAL (free, offline)          AI (your Claude/API)        │
+│  ────────────────────           ──────────────────          │
+│  • status                       • init (kickstart)          │
+│  • roadmap                      • build (implement)         │
+│  • sprint                       • prp generate              │
+│  • export                       • research                  │
+│                                                             │
+│  Reads JSON files               Uses YOUR account           │
+│  No API calls                   You pay for usage           │
+│                                                             │
+└─────────────────────────────────────────────────────────────┘
+```
+
+## Project Structure
+
+When you run `codrsync init`, it creates:
+
+```
+your-project/
+├── doc/project/
+│   ├── manifest.json      # Project metadata
+│   └── progress.json      # Progress tracking
+├── doc/task/
+│   └── context-session.md # Current context
+├── PRPs/                  # Product Requirement Prompts
+├── src/                   # Your code
+├── tests/                 # Your tests
+└── exports/               # Exported reports
+```
+
+## Diagnostics
+
+```bash
+codrsync doctor
+```
+
+Shows:
+- Python version
+- Claude Code installation
+- API key status
+- Current project
+- Dependencies
+
+## License
+
+MIT

codrsync-1.0.0/codrsync/__init__.py

@@ -0,0 +1,9 @@
+"""
+codrsync - Turn any dev into jedi ninja codr
+
+AI-powered development orchestrator with guided development,
+interactive validation, and persistent context.
+"""
+
+__version__ = "1.0.0"
+__author__ = "Ciro Arendt"

codrsync-1.0.0/codrsync/__main__.py

@@ -0,0 +1,6 @@
+"""Entry point for python -m codrsync"""
+
+from codrsync.cli import app
+
+if __name__ == "__main__":
+    app()

codrsync-1.0.0/codrsync/ai/__init__.py

@@ -0,0 +1,9 @@
+"""
+AI-powered commands (require Claude Code or API)
+"""
+
+from codrsync.ai import kickstart
+from codrsync.ai import build
+from codrsync.ai import prp
+
+__all__ = ["kickstart", "build", "prp"]

codrsync-1.0.0/codrsync/ai/backend.py

@@ -0,0 +1,252 @@
+"""
+AI Backend abstraction - supports Claude Code CLI or Anthropic API
+"""
+
+import os
+import subprocess
+import json
+from abc import ABC, abstractmethod
+from typing import Optional, Generator
+from pathlib import Path
+
+from rich.console import Console
+
+from codrsync.auth import AIBackend
+
+
+console = Console()
+
+
+class AIBackendBase(ABC):
+    """Abstract base for AI backends"""
+
+    @abstractmethod
+    def run_prompt(
+        self,
+        prompt: str,
+        context: Optional[dict] = None,
+        system: Optional[str] = None,
+    ) -> str:
+        """Run a prompt and return the response"""
+        pass
+
+    @abstractmethod
+    def run_interactive(
+        self,
+        prompt: str,
+        context: Optional[dict] = None,
+        system: Optional[str] = None,
+    ) -> Generator[str, None, None]:
+        """Run an interactive session, yielding responses"""
+        pass
+
+    def run_conversation(
+        self,
+        messages: list[dict],
+        system: Optional[str] = None,
+    ) -> str:
+        """Run a multi-turn conversation. Default: use last user message as prompt."""
+        last_user = ""
+        for msg in reversed(messages):
+            if msg.get("role") == "user":
+                last_user = msg["content"]
+                break
+        return self.run_prompt(last_user, system=system)
+
+
+class ClaudeCodeBackend(AIBackendBase):
+    """Uses Claude Code CLI"""
+
+    def __init__(self):
+        self.claude_path = "claude"
+
+    def run_prompt(
+        self,
+        prompt: str,
+        context: Optional[dict] = None,
+        system: Optional[str] = None,
+    ) -> str:
+        """Run prompt via Claude Code CLI"""
+        full_prompt = self._build_prompt(prompt, context, system)
+        cmd = [self.claude_path, "-p", full_prompt]
+
+        try:
+            result = subprocess.run(
+                cmd,
+                capture_output=True,
+                text=True,
+                timeout=300  # 5 min timeout
+            )
+            return result.stdout
+        except subprocess.TimeoutExpired:
+            return "Error: Command timed out"
+        except Exception as e:
+            return f"Error: {str(e)}"
+
+    def run_interactive(
+        self,
+        prompt: str,
+        context: Optional[dict] = None,
+        system: Optional[str] = None,
+    ) -> Generator[str, None, None]:
+        """Run interactive Claude Code session"""
+        yield self.run_prompt(prompt, context, system)
+
+    def run_conversation(
+        self,
+        messages: list[dict],
+        system: Optional[str] = None,
+    ) -> str:
+        """Run conversation via Claude Code CLI using --continue flag"""
+        # Claude Code CLI doesn't support multi-turn natively via -p,
+        # so we concatenate the conversation into a single prompt.
+        parts = []
+        if system:
+            parts.append(f"<system>\n{system}\n</system>\n")
+
+        for msg in messages:
+            role = msg["role"].upper()
+            parts.append(f"[{role}]\n{msg['content']}\n")
+
+        full_prompt = "\n".join(parts)
+        cmd = [self.claude_path, "-p", full_prompt]
+
+        try:
+            result = subprocess.run(
+                cmd,
+                capture_output=True,
+                text=True,
+                timeout=300,
+            )
+            return result.stdout
+        except subprocess.TimeoutExpired:
+            return "Error: Command timed out"
+        except Exception as e:
+            return f"Error: {str(e)}"
+
+    @staticmethod
+    def _build_prompt(
+        prompt: str,
+        context: Optional[dict] = None,
+        system: Optional[str] = None,
+    ) -> str:
+        """Combine system, context, and prompt into a single string for CLI mode."""
+        parts = []
+
+        if system:
+            parts.append(f"<system>\n{system}\n</system>\n")
+
+        if context:
+            context_str = json.dumps(context, indent=2, ensure_ascii=False)
+            parts.append(f"<context>\n{context_str}\n</context>\n")
+
+        parts.append(prompt)
+        return "\n".join(parts)
+
+
+class AnthropicAPIBackend(AIBackendBase):
+    """Uses Anthropic API directly"""
+
+    def __init__(self, api_key: Optional[str] = None):
+        self.api_key = api_key or os.getenv("ANTHROPIC_API_KEY")
+
+        if not self.api_key:
+            raise ValueError("ANTHROPIC_API_KEY not set")
+
+        try:
+            from anthropic import Anthropic
+            self.client = Anthropic(api_key=self.api_key)
+        except ImportError:
+            raise ImportError("anthropic package not installed")
+
+    def run_prompt(
+        self,
+        prompt: str,
+        context: Optional[dict] = None,
+        system: Optional[str] = None,
+    ) -> str:
+        """Run prompt via Anthropic API"""
+        messages = []
+
+        if context:
+            context_str = json.dumps(context, indent=2, ensure_ascii=False)
+            messages.append({
+                "role": "user",
+                "content": f"Context:\n```json\n{context_str}\n```\n\n{prompt}"
+            })
+        else:
+            messages.append({
+                "role": "user",
+                "content": prompt
+            })
+
+        kwargs = {
+            "model": "claude-sonnet-4-20250514",
+            "max_tokens": 4096,
+            "messages": messages,
+        }
+        if system:
+            kwargs["system"] = system
+
+        response = self.client.messages.create(**kwargs)
+        return response.content[0].text
+
+    def run_interactive(
+        self,
+        prompt: str,
+        context: Optional[dict] = None,
+        system: Optional[str] = None,
+    ) -> Generator[str, None, None]:
+        """Run with streaming"""
+        messages = []
+
+        if context:
+            context_str = json.dumps(context, indent=2, ensure_ascii=False)
+            messages.append({
+                "role": "user",
+                "content": f"Context:\n```json\n{context_str}\n```\n\n{prompt}"
+            })
+        else:
+            messages.append({
+                "role": "user",
+                "content": prompt
+            })
+
+        kwargs = {
+            "model": "claude-sonnet-4-20250514",
+            "max_tokens": 4096,
+            "messages": messages,
+        }
+        if system:
+            kwargs["system"] = system
+
+        with self.client.messages.stream(**kwargs) as stream:
+            for text in stream.text_stream:
+                yield text
+
+    def run_conversation(
+        self,
+        messages: list[dict],
+        system: Optional[str] = None,
+    ) -> str:
+        """Run a multi-turn conversation via API"""
+        kwargs = {
+            "model": "claude-sonnet-4-20250514",
+            "max_tokens": 4096,
+            "messages": messages,
+        }
+        if system:
+            kwargs["system"] = system
+
+        response = self.client.messages.create(**kwargs)
+        return response.content[0].text
+
+
+def get_backend_instance(backend: AIBackend) -> AIBackendBase:
+    """Get appropriate backend instance"""
+    if backend == AIBackend.CLAUDE_CODE:
+        return ClaudeCodeBackend()
+    elif backend == AIBackend.ANTHROPIC_API:
+        return AnthropicAPIBackend()
+    else:
+        raise ValueError("No AI backend available")