ragtime-cli 0.1.0__py3-none-any.whl → 0.1.2__py3-none-any.whl

{ragtime_cli-0.1.0.dist-info → ragtime_cli-0.1.2.dist-info}/METADATA

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: ragtime-cli
-Version: 0.1.0
+Version: 0.1.2
 Summary: Local-first memory and RAG system for Claude Code - semantic search over code, docs, and team knowledge
 Author-email: Bret Martineau <bretwardjames@gmail.com>
 License-Expression: MIT

{ragtime_cli-0.1.0.dist-info → ragtime_cli-0.1.2.dist-info}/RECORD

@@ -1,6 +1,6 @@
-ragtime_cli-0.1.0.dist-info/licenses/LICENSE,sha256=9A0wJs2PRDciGRH4F8JUJ-aMKYQyq_gVu2ixrXs-l5A,1070
+ragtime_cli-0.1.2.dist-info/licenses/LICENSE,sha256=9A0wJs2PRDciGRH4F8JUJ-aMKYQyq_gVu2ixrXs-l5A,1070
 src/__init__.py,sha256=47DEQpj8HBSa-_TImW-5JCeuQeRkm5NMpJWZG3hSuFU,0
-src/cli.py,sha256=7LOyDfHsC-3glutDrasEq8dsLdUPdfWAMauGYfp9tFI,26372
+src/cli.py,sha256=UMY97OO6JbQ4EuzMxLnKddqAiRSwP73YJQgY380h1Wo,35481
 src/config.py,sha256=_5ev0OkhFKdVaU0T76x-lJUUccn1hB21-dqzV-UleUw,3155
 src/db.py,sha256=BKrlhilXYHNaj-ZcffinSXVhdUqowmwpFPBx7aLxamU,4642
 src/mcp_server.py,sha256=Tx0i73GXO0YmcVrdO7UjRMS0auN8fBG2LOpHuf_LUC0,20374
@@ -14,8 +14,8 @@ src/commands/save.md,sha256=7gTpW46AU9Y4l8XVZ8f4h1sEdBfVqIRA7hlidUxMAC4,251
 src/commands/start.md,sha256=qoqhkMgET74DBx8YPIT1-wqCiVBUDxlmevigsCinHSY,6506
 src/indexers/__init__.py,sha256=47DEQpj8HBSa-_TImW-5JCeuQeRkm5NMpJWZG3hSuFU,0
 src/indexers/docs.py,sha256=7FENHaKSvC1T557bRzvmrjyaG_vK94GuQG9XMZdr89w,3349
-ragtime_cli-0.1.0.dist-info/METADATA,sha256=IdKf5KyWm7JabJTCB4344AYbIYTLKKyQc3nYRDIiiM4,5311
-ragtime_cli-0.1.0.dist-info/WHEEL,sha256=wUyA8OaulRlbfwMtmQsvNngGrxQHAvkKcvRmdizlJi0,92
-ragtime_cli-0.1.0.dist-info/entry_points.txt,sha256=cWLbeyMxZNbew-THS3bHXTpCRXt1EaUy5QUOXGXLjl4,75
-ragtime_cli-0.1.0.dist-info/top_level.txt,sha256=74rtVfumQlgAPzR5_2CgYN24MB0XARCg0t-gzk6gTrM,4
-ragtime_cli-0.1.0.dist-info/RECORD,,
+ragtime_cli-0.1.2.dist-info/METADATA,sha256=PsKWnO86RaGbeYZHWpFNpUotMwUkGFrn9K4OQzxVmUg,5311
+ragtime_cli-0.1.2.dist-info/WHEEL,sha256=wUyA8OaulRlbfwMtmQsvNngGrxQHAvkKcvRmdizlJi0,92
+ragtime_cli-0.1.2.dist-info/entry_points.txt,sha256=cWLbeyMxZNbew-THS3bHXTpCRXt1EaUy5QUOXGXLjl4,75
+ragtime_cli-0.1.2.dist-info/top_level.txt,sha256=74rtVfumQlgAPzR5_2CgYN24MB0XARCg0t-gzk6gTrM,4
+ragtime_cli-0.1.2.dist-info/RECORD,,

src/cli.py

@@ -55,8 +55,75 @@ def get_author() -> str:
     return "unknown"
 
 
+def check_ghp_installed() -> bool:
+    """Check if ghp-cli is installed."""
+    try:
+        result = subprocess.run(
+            ["ghp", "--version"],
+            capture_output=True,
+            text=True,
+            timeout=5,
+        )
+        return result.returncode == 0
+    except (subprocess.TimeoutExpired, FileNotFoundError):
+        return False
+
+
+def get_issue_from_ghp(issue_num: int, path: Path) -> dict | None:
+    """Get issue details using ghp issue open."""
+    try:
+        result = subprocess.run(
+            ["ghp", "issue", "open", str(issue_num), "--json"],
+            cwd=path,
+            capture_output=True,
+            text=True,
+            timeout=30,
+        )
+        if result.returncode == 0:
+            import json
+            return json.loads(result.stdout)
+    except (subprocess.TimeoutExpired, FileNotFoundError, Exception):
+        pass
+    return None
+
+
+def get_issue_from_gh(issue_num: int, path: Path) -> dict | None:
+    """Get issue details using gh CLI."""
+    try:
+        result = subprocess.run(
+            ["gh", "issue", "view", str(issue_num), "--json", "title,body,labels,number"],
+            cwd=path,
+            capture_output=True,
+            text=True,
+            timeout=30,
+        )
+        if result.returncode == 0:
+            import json
+            return json.loads(result.stdout)
+    except (subprocess.TimeoutExpired, FileNotFoundError, Exception):
+        pass
+    return None
+
+
+def get_current_branch(path: Path) -> str | None:
+    """Get the current git branch name."""
+    try:
+        result = subprocess.run(
+            ["git", "rev-parse", "--abbrev-ref", "HEAD"],
+            cwd=path,
+            capture_output=True,
+            text=True,
+            timeout=5,
+        )
+        if result.returncode == 0:
+            return result.stdout.strip()
+    except (subprocess.TimeoutExpired, FileNotFoundError):
+        pass
+    return None
+
+
 @click.group()
-@click.version_option(version="0.1.0")
+@click.version_option(version="0.1.2")
 def main():
     """Ragtime - semantic search over code and documentation."""
     pass
@@ -73,6 +140,20 @@ def init(path: Path):
     click.echo(f"  Code paths: {config.code.paths}")
     click.echo(f"  Languages: {config.code.languages}")
 
+    # Create memory directory structure
+    memory_dir = path / ".claude" / "memory"
+    (memory_dir / "app").mkdir(parents=True, exist_ok=True)
+    (memory_dir / "team").mkdir(parents=True, exist_ok=True)
+    (memory_dir / "branches").mkdir(parents=True, exist_ok=True)
+    click.echo(f"\nCreated .claude/memory/ structure")
+
+    # Check for ghp-cli
+    if check_ghp_installed():
+        click.echo(f"\n✓ ghp-cli detected - will use for issue lookups")
+    else:
+        click.echo(f"\n• ghp-cli not found - will use gh CLI for issue lookups")
+        click.echo(f"  Install ghp for enhanced workflow: pip install ghp-cli")
+
 
 @main.command()
 @click.argument("path", type=click.Path(exists=True, path_type=Path), default=".")
@@ -415,6 +496,141 @@ def reindex(path: Path):
     click.echo(f"✓ Reindexed {count} memory files")
 
 
+@main.command("new-branch")
+@click.argument("issue", type=int)
+@click.option("--path", type=click.Path(exists=True, path_type=Path), default=".")
+@click.option("--content", help="Context document content (overrides auto-generated scaffold)")
+@click.option("--issue-json", "issue_json", help="Issue data as JSON (from ghp hook, skips fetch)")
+@click.option("--branch", "-b", help="Branch name (auto-detected from git if not provided)")
+def new_branch(issue: int, path: Path, content: str, issue_json: str, branch: str):
+    """Initialize a branch context from a GitHub issue.
+
+    Creates .claude/memory/branches/{branch-slug}/context.md with either:
+    - Provided content (from --content flag, e.g., LLM-generated plan)
+    - Auto-generated scaffold from issue metadata (fallback)
+
+    Examples:
+        ragtime new-branch 42                         # Scaffold from issue #42
+        ragtime new-branch 42 --content "..."         # Use provided content
+        ragtime new-branch 42 --issue-json '{...}'    # Use JSON from ghp hook
+        ragtime new-branch 42 --branch my-feat        # Specify branch name
+    """
+    import json
+    from datetime import date
+
+    path = Path(path).resolve()
+
+    # Determine branch name
+    if not branch:
+        branch = get_current_branch(path)
+        if not branch or branch in ("main", "master"):
+            click.echo("✗ Not on a feature branch. Use --branch to specify.", err=True)
+            return
+
+    # Create branch slug for folder name
+    branch_slug = branch.replace("/", "-")
+    branch_dir = path / ".claude" / "memory" / "branches" / branch_slug
+    branch_dir.mkdir(parents=True, exist_ok=True)
+
+    context_file = branch_dir / "context.md"
+
+    if content:
+        # Use provided content directly
+        context_file.write_text(content)
+        click.echo(f"✓ Created context.md with provided content")
+        click.echo(f"  Path: {context_file.relative_to(path)}")
+        return
+
+    # Get issue data from JSON, ghp, or gh
+    issue_data = None
+    source = None
+
+    # Use provided JSON if available (from ghp hook)
+    if issue_json:
+        try:
+            issue_data = json.loads(issue_json)
+            source = "ghp-hook"
+        except json.JSONDecodeError as e:
+            click.echo(f"✗ Invalid JSON: {e}", err=True)
+            return
+    else:
+        # Fall back to fetching from API
+        click.echo(f"Fetching issue #{issue}...")
+
+        # Try ghp first if available
+        if check_ghp_installed():
+            issue_data = get_issue_from_ghp(issue, path)
+            source = "ghp"
+
+        # Fall back to gh
+        if not issue_data:
+            issue_data = get_issue_from_gh(issue, path)
+            source = "gh"
+
+    if not issue_data:
+        click.echo(f"✗ Could not fetch issue #{issue}", err=True)
+        click.echo("  Make sure you're in a git repo with GitHub remote")
+        return
+
+    # Extract issue fields
+    title = issue_data.get("title", f"Issue #{issue}")
+    body = issue_data.get("body", "")
+    labels = issue_data.get("labels", [])
+
+    # Format labels
+    if labels:
+        if isinstance(labels[0], dict):
+            label_names = [l.get("name", "") for l in labels]
+        else:
+            label_names = labels
+        labels_str = ", ".join(label_names)
+    else:
+        labels_str = ""
+
+    # Generate scaffold context.md
+    scaffold = f"""---
+type: context
+branch: {branch}
+issue: {issue}
+status: active
+created: '{date.today().isoformat()}'
+author: {get_author()}
+---
+
+## Issue
+
+**#{issue}**: {title}
+
+{f"**Labels**: {labels_str}" if labels_str else ""}
+
+## Description
+
+{body if body else "_No description provided_"}
+
+## Plan
+
+<!-- Implementation steps - fill in or let Claude generate -->
+
+- [ ] TODO: Define implementation steps
+
+## Acceptance Criteria
+
+<!-- What needs to be true for this to be complete? -->
+
+## Notes
+
+<!-- Additional context, decisions, blockers -->
+
+"""
+
+    context_file.write_text(scaffold)
+
+    click.echo(f"✓ Created context.md from issue #{issue}")
+    click.echo(f"  Path: {context_file.relative_to(path)}")
+    click.echo(f"  Source: {source}")
+    click.echo(f"\nNext: Fill in the Plan section or use /start to generate it")
+
+
 # ============================================================================
 # Command Installation
 # ============================================================================
@@ -518,6 +734,75 @@ def install_commands(global_install: bool, workspace_install: bool, list_command
     click.echo('  "ragtime": {"command": "ragtime-mcp", "args": ["--path", "."]}')
 
 
+@main.command("setup-ghp")
+@click.option("--remove", is_flag=True, help="Remove ragtime hooks from ghp")
+def setup_ghp(remove: bool):
+    """Register ragtime hooks with ghp-cli.
+
+    Adds event hooks so ghp automatically creates context.md when starting issues.
+
+    Examples:
+        ragtime setup-ghp          # Register hooks
+        ragtime setup-ghp --remove # Remove hooks
+    """
+    if not check_ghp_installed():
+        click.echo("✗ ghp-cli not installed", err=True)
+        click.echo("  Install with: npm install -g @bretwardjames/ghp-cli")
+        return
+
+    hook_name = "ragtime-context"
+
+    if remove:
+        # Remove the hook
+        result = subprocess.run(
+            ["ghp", "hooks", "remove", hook_name],
+            capture_output=True,
+            text=True,
+        )
+        if result.returncode == 0:
+            click.echo(f"✓ Removed hook: {hook_name}")
+        else:
+            if "not found" in result.stderr.lower():
+                click.echo(f"• Hook {hook_name} not registered")
+            else:
+                click.echo(f"✗ Failed to remove hook: {result.stderr}", err=True)
+        return
+
+    # Check if hook already exists
+    result = subprocess.run(
+        ["ghp", "hooks", "show", hook_name],
+        capture_output=True,
+        text=True,
+    )
+    if result.returncode == 0:
+        click.echo(f"• Hook {hook_name} already registered")
+        click.echo("  Use --remove to unregister first")
+        return
+
+    # Register the hook
+    # The command uses ${issue.number}, ${issue.json}, and ${branch} from ghp
+    hook_command = "ragtime new-branch ${issue.number} --issue-json '${issue.json}' --branch '${branch}'"
+
+    result = subprocess.run(
+        [
+            "ghp", "hooks", "add", hook_name,
+            "--event", "issue-started",
+            "--command", hook_command,
+            "--display-name", "Ragtime Context",
+        ],
+        capture_output=True,
+        text=True,
+    )
+
+    if result.returncode == 0:
+        click.echo(f"✓ Registered hook: {hook_name}")
+        click.echo(f"  Event: issue-started")
+        click.echo(f"  Action: Creates context.md from issue metadata")
+        click.echo(f"\nNow when you run 'ghp start <issue>', ragtime will auto-create context.md")
+    else:
+        click.echo(f"✗ Failed to register hook: {result.stderr}", err=True)
+
+
 # ============================================================================
 # Cross-Branch Sync Commands
 # ============================================================================