roadmap-cli 0.1.1__py3-none-any.whl

roadmap/adapters/cli/issues/lookup.py

@@ -0,0 +1,96 @@
+"""Lookup issue by GitHub ID command - find internal issue by GitHub issue number."""
+
+import click
+
+from roadmap.adapters.cli.cli_command_helpers import require_initialized
+from roadmap.common.console import get_console
+from roadmap.common.formatters.text.operations import (
+    format_operation_failure,
+)
+from roadmap.common.logging import (
+    log_command,
+)
+
+console = get_console()
+
+
+@click.command("lookup-github")
+@click.argument("github_id", type=int)
+@click.pass_context
+@log_command("issue_lookup_github", entity_type="issue", track_duration=True)
+@require_initialized
+def lookup_github_issue(ctx: click.Context, github_id: int) -> None:
+    """Look up an internal issue by its GitHub issue number.
+
+    Searches for an internal issue linked to the provided GitHub issue number
+    and displays its details.
+
+    Example:
+        roadmap issue lookup-github 456
+    """
+    core = ctx.obj["core"]
+
+    # Validate GitHub ID is positive
+    if github_id <= 0:
+        lines = format_operation_failure(
+            "lookup GitHub issue", None, "Invalid GitHub issue number"
+        )
+        for line in lines:
+            # Use click.echo for proper output capture in Click's CliRunner
+            click.echo(line)
+        ctx.exit(1)
+
+    # Get all issues and search for one with matching github_issue
+    all_issues = core.issues.get_all()
+    matching_issue = None
+
+    for issue in all_issues:
+        if issue.github_issue == github_id:
+            matching_issue = issue
+            break
+
+    if not matching_issue:
+        lines = format_operation_failure(
+            "lookup GitHub issue",
+            None,
+            f"No issue found linked to GitHub issue #{github_id}",
+        )
+        for line in lines:
+            # Use click.echo for proper output capture in Click's CliRunner
+            click.echo(line)
+        ctx.exit(1)
+
+    # Display issue details
+    console.print(
+        f"✅ Found issue linked to GitHub issue #{github_id}", style="bold green"
+    )
+    console.print()
+    console.print(f"  ID: {matching_issue.id}", style="cyan")
+    console.print(f"  Title: {matching_issue.title}", style="bold")
+    console.print(f"  Status: {matching_issue.status.value}", style="cyan")
+    console.print(f"  Priority: {matching_issue.priority.value}", style="cyan")
+
+    if matching_issue.assignee:
+        console.print(f"  Assigned to: {matching_issue.assignee}", style="cyan")
+
+    if matching_issue.milestone:
+        console.print(f"  Milestone: {matching_issue.milestone}", style="cyan")
+
+    if matching_issue.labels:
+        console.print(f"  Labels: {', '.join(matching_issue.labels)}", style="cyan")
+
+    if matching_issue.estimated_hours:
+        console.print(
+            f"  Estimated: {matching_issue.estimated_time_display}", style="cyan"
+        )
+
+    if matching_issue.content:
+        console.print()
+        console.print("Description:", style="bold cyan")
+        console.print(matching_issue.content, style="dim")
+
+    console.print()
+    console.print(
+        f"  Use 'roadmap issue view {matching_issue.id}' for full details",
+        style="dim",
+    )

roadmap/adapters/cli/issues/progress.py

@@ -0,0 +1,102 @@
+"""Update progress command - thin wrapper around update.
+
+This command is syntactic sugar for: roadmap issue update <ID> --progress <PERCENT>
+"""
+
+import click
+
+from roadmap.adapters.cli.cli_command_helpers import (
+    ensure_entity_exists,
+    require_initialized,
+)
+from roadmap.adapters.cli.cli_error_handlers import handle_cli_error
+from roadmap.common.console import get_console
+from roadmap.common.formatters.text.operations import (
+    format_operation_failure,
+    format_operation_success,
+)
+from roadmap.common.logging import (
+    log_command,
+    track_database_operation,
+)
+from roadmap.core.domain import Status
+
+console = get_console()
+
+
+@click.command("progress")
+@click.argument("issue_id")
+@click.argument("percentage", type=float)
+@click.pass_context
+@log_command("issue_progress", entity_type="issue", track_duration=True)
+@require_initialized
+def update_progress(ctx: click.Context, issue_id: str, percentage: float):
+    """Update the progress percentage for an issue (0-100).
+
+    Syntactic sugar for: roadmap issue update <ID> --progress <PERCENT>
+    """
+    core = ctx.obj["core"]
+
+    if not 0 <= percentage <= 100:
+        console.print(
+            "❌ Progress percentage must be between 0 and 100", style="bold red"
+        )
+        return
+
+    try:
+        # Get the issue
+        issue = ensure_entity_exists(core, "issue", issue_id)
+
+        # Update progress via core.update_issue
+        with track_database_operation("update", "issue", entity_id=issue_id):
+            updated = core.issues.update(issue_id, progress_percentage=percentage)
+
+        if updated:
+            # Build extra details for display
+            extra_details = {"Progress": f"{percentage:.0f}%"}
+
+            # Auto-update status based on progress
+            if percentage == 0:
+                extra_details["Note"] = "Resetting to todo"
+            elif percentage == 100:
+                extra_details["Tip"] = "roadmap issue close to mark complete"
+            else:
+                if issue.status == Status.TODO:
+                    core.issues.update(issue_id, status=Status.IN_PROGRESS)
+                    extra_details["Status"] = "Auto-updated to In Progress"
+
+            # Display success with formatter
+            lines = format_operation_success(
+                emoji="📊",
+                action="Updated progress",
+                entity_title=issue.title,
+                entity_id=issue_id,
+                extra_details=extra_details,
+            )
+            for line in lines:
+                console.print(line, style="bold green" if "Updated" in line else "cyan")
+        else:
+            lines = format_operation_failure(
+                action="update progress",
+                entity_id=issue_id,
+                error="No changes made",
+            )
+            for line in lines:
+                console.print(line, style="bold red")
+
+    except Exception as e:
+        handle_cli_error(
+            error=e,
+            operation="update_issue_progress",
+            entity_type="issue",
+            entity_id=issue_id,
+            context={"percentage": percentage},
+            fatal=True,
+        )
+        lines = format_operation_failure(
+            action="update progress",
+            entity_id=issue_id,
+            error=str(e),
+        )
+        for line in lines:
+            console.print(line, style="bold red")

roadmap/adapters/cli/issues/restore.py

@@ -0,0 +1,96 @@
+"""Restore issue command - move archived issues back to active."""
+
+import click
+
+from roadmap.adapters.cli.cli_command_helpers import require_initialized
+from roadmap.adapters.cli.issues.restore_class import IssueRestore
+from roadmap.common.console import get_console
+from roadmap.common.logging import (
+    log_command,
+    verbose_output,
+)
+
+
+@click.command()
+@click.argument("issue_id", required=False)
+@click.option(
+    "--all",
+    is_flag=True,
+    help="Restore all archived issues",
+)
+@click.option(
+    "--status",
+    type=click.Choice(["todo", "in-progress", "blocked", "review", "closed"]),
+    help="Set status when restoring (default: keep current status)",
+)
+@click.option(
+    "--dry-run",
+    is_flag=True,
+    help="Preview what would be restored without actually doing it",
+)
+@click.option(
+    "--force",
+    is_flag=True,
+    help="Skip confirmation prompt",
+)
+@click.option(
+    "--verbose",
+    "-v",
+    is_flag=True,
+    help="Show detailed debug information",
+)
+@click.pass_context
+@verbose_output
+@log_command("issue_restore", entity_type="issue", track_duration=True)
+@require_initialized
+def restore_issue(
+    ctx: click.Context,
+    issue_id: str | None,
+    all: bool,
+    status: str | None,
+    dry_run: bool,
+    force: bool,
+    verbose: bool,  # noqa: F841
+):
+    """Restore an archived issue back to active issues.
+
+    This moves an issue from .roadmap/archive/issues/ back to
+    .roadmap/issues/, making it active again. Optionally update
+    the status when restoring.
+
+    Examples:
+        roadmap issue restore 8a00a17e
+        roadmap issue restore 8a00a17e --status todo
+        roadmap issue restore --all
+        roadmap issue restore 8a00a17e --dry-run
+    """
+    core = ctx.obj["core"]
+    console = get_console()
+
+    restore = IssueRestore(core, console)
+
+    if not issue_id and not all:
+        console.print(
+            "❌ Error: Specify an issue ID or use --all",
+            style="bold red",
+        )
+        ctx.exit(1)
+
+    if issue_id and all:
+        console.print(
+            "❌ Error: Cannot specify issue ID with --all",
+            style="bold red",
+        )
+        ctx.exit(1)
+
+    try:
+        restore.execute(
+            entity_id=issue_id,
+            all=all,
+            status=status,
+            dry_run=dry_run,
+            force=force,
+        )
+    except Exception as e:
+        console.print(f"❌ Restore operation failed: {str(e)}", style="bold red")
+        ctx.exit(1)

roadmap/adapters/cli/issues/restore_class.py

@@ -0,0 +1,57 @@
+"""IssueRestore command implementation using base class."""
+
+from pathlib import Path
+
+from roadmap.adapters.cli.crud import BaseRestore, EntityType
+
+
+class IssueRestore(BaseRestore):
+    """Restore issue command implementation."""
+
+    entity_type = EntityType.ISSUE
+
+    def get_archived_files_to_restore(
+        self, entity_id: str | None = None, **filters
+    ) -> list[Path]:
+        """Get archived issue files to restore.
+
+        Args:
+            entity_id: Specific issue ID to restore
+            **filters: Additional filter criteria
+
+        Returns:
+            List of archived file paths
+        """
+        from roadmap.adapters.cli.crud.crud_helpers import get_archive_dir
+
+        archive_dir = get_archive_dir(self.entity_type)
+
+        if not archive_dir.exists():
+            return []
+
+        if entity_id:
+            # Find specific issue file by ID prefix
+            matching = list(archive_dir.rglob(f"{entity_id[:8]}*.md"))
+            return matching if matching else []
+        else:
+            # Return all archived issues
+            return list(archive_dir.rglob("*.md"))
+
+    def post_restore_hook(self, restored_files: list[Path], **kwargs) -> None:
+        """Handle post-restore state updates.
+
+        Args:
+            restored_files: Files that were restored
+            **kwargs: Additional arguments
+        """
+        # Mark issues as restored in database
+        for file_path in restored_files:
+            try:
+                # Extract issue ID from filename
+                issue_id = file_path.stem.split("-")[0]
+                self.core.db.mark_issue_archived(issue_id, archived=False)
+            except Exception as e:
+                self.console.print(
+                    f"⚠️  Warning: Failed to update restoration status for {file_path.name}: {e}",
+                    style="yellow",
+                )

roadmap/adapters/cli/issues/start.py

@@ -0,0 +1,165 @@
+"""Start issue command - thin wrapper around update.
+
+This command is syntactic sugar for: roadmap issue update <ID> --status in-progress
+with optional Git branch creation.
+"""
+
+import click
+
+from roadmap.adapters.cli.cli_command_helpers import require_initialized
+from roadmap.adapters.cli.cli_error_handlers import handle_cli_error
+from roadmap.common.console import get_console
+from roadmap.common.formatters.text.operations import (
+    format_operation_failure,
+    format_operation_success,
+)
+from roadmap.common.logging import (
+    log_command,
+    track_database_operation,
+)
+from roadmap.core.services import StartIssueService
+
+console = get_console()
+
+
+@click.command("start")
+@click.argument("issue_id")
+@click.option("--date", help="Start date (YYYY-MM-DD HH:MM, defaults to now)")
+@click.option(
+    "--git-branch/--no-git-branch",
+    default=False,
+    help="Create a Git branch for this issue when starting",
+)
+@click.option(
+    "--checkout/--no-checkout",
+    default=True,
+    help="Checkout the created branch (when --git-branch is used)",
+)
+@click.option("--branch-name", default=None, help="Override suggested branch name")
+@click.option(
+    "--force", is_flag=True, help="Force branch creation even if working tree is dirty"
+)
+@click.pass_context
+@log_command("issue_start", entity_type="issue", track_duration=True)
+@require_initialized
+def start_issue(
+    ctx: click.Context,
+    issue_id: str,
+    date: str,
+    git_branch: bool,
+    checkout: bool,
+    branch_name: str,
+    force: bool,
+):
+    """Start work on an issue (sets status to in-progress and records start date).
+
+    Syntactic sugar for: roadmap issue update <ID> --status in-progress
+    """
+    core = ctx.obj["core"]
+
+    try:
+        # Create start issue service
+        service = StartIssueService(core)
+
+        # Parse start date
+        try:
+            start_date = service.parse_start_date(date)
+        except ValueError:
+            console.print(
+                "❌ Invalid date format. Use YYYY-MM-DD or YYYY-MM-DD HH:MM",
+                style="bold red",
+            )
+            return
+
+        # Get the issue
+        issue = core.issues.get(issue_id)
+        if not issue:
+            console.print(f"❌ Issue not found: {issue_id}", style="bold red")
+            return
+
+        # Start work on issue via core.update_issue
+        with track_database_operation("update", "issue", entity_id=issue_id):
+            success = service.start_work(issue_id, start_date)
+
+        if success:
+            # Build extra details
+            extra_details = {
+                "Status": "🚀 In Progress",
+                "Started": start_date.strftime("%Y-%m-%d %H:%M"),
+            }
+
+            # Display success with formatter
+            lines = format_operation_success(
+                emoji="🚀",
+                action="Started",
+                entity_title=issue.title,
+                entity_id=issue_id,
+                extra_details=extra_details,
+            )
+            for line in lines:
+                console.print(line, style="bold green" if "Started" in line else "cyan")
+
+            # Handle git branch creation
+            if service.should_create_branch(git_branch):
+                _handle_git_branch_creation(
+                    core, service, issue, branch_name, checkout, force
+                )
+        else:
+            lines = format_operation_failure(
+                action="start",
+                entity_id=issue_id,
+                error="Failed to update status",
+            )
+            for line in lines:
+                console.print(line, style="bold red")
+
+    except Exception as e:
+        handle_cli_error(
+            error=e,
+            operation="start_issue",
+            entity_type="issue",
+            entity_id=issue_id,
+            context={
+                "git_branch": git_branch,
+                "checkout": checkout,
+                "branch_name": branch_name,
+            },
+            fatal=True,
+        )
+        lines = format_operation_failure(
+            action="start",
+            entity_id=issue_id,
+            error=str(e),
+        )
+        for line in lines:
+            console.print(line, style="bold red")
+
+
+def _handle_git_branch_creation(core, service, issue, branch_name, checkout, force):
+    """Handle git branch creation for started issue."""
+    try:
+        if hasattr(core, "git") and core.git.is_git_repository():
+            success, resolved_branch_name = service.core.git.create_branch_for_issue(
+                issue, checkout=checkout, force=force
+            )
+            if success and resolved_branch_name:
+                service.display_branch_created(resolved_branch_name, checkout)
+            else:
+                service.display_branch_warning()
+        else:
+            console.print(
+                "⚠️  Not in a Git repository, skipping branch creation",
+                style="yellow",
+            )
+    except Exception as e:
+        handle_cli_error(
+            error=e,
+            operation="create_git_branch",
+            entity_type="issue",
+            entity_id=issue.id,
+            context={"branch_name": branch_name},
+            fatal=False,
+        )
+        console.print(
+            f"⚠️  Git branch creation skipped due to error: {e}", style="yellow"
+        )