galangal-orchestrate 0.13.0__py3-none-any.whl

galangal/commands/list.py

@@ -0,0 +1,20 @@
+"""
+galangal list - List all tasks.
+"""
+
+import argparse
+
+from galangal.core.tasks import get_active_task, list_tasks
+from galangal.ui.console import console, display_task_list
+
+
+def cmd_list(args: argparse.Namespace) -> int:
+    """List all tasks."""
+    tasks = list_tasks()
+    active = get_active_task()
+
+    display_task_list(tasks, active)
+
+    if active:
+        console.print("\n[dim]→ = active task[/dim]")
+    return 0

galangal/commands/pause.py

@@ -0,0 +1,34 @@
+"""
+galangal pause - Pause the active task.
+"""
+
+import argparse
+
+from galangal.core.state import Stage
+from galangal.core.tasks import ensure_active_task_with_state
+from galangal.ui.console import console, print_info
+
+
+def cmd_pause(args: argparse.Namespace) -> int:
+    """Pause the active task for a break or shutdown."""
+    active, state = ensure_active_task_with_state()
+    if not active or not state:
+        return 1
+
+    if state.stage == Stage.COMPLETE:
+        print_info(f"Task '{active}' is already complete.")
+        console.print("Use 'complete' to create PR and move to done/.")
+        return 0
+
+    console.print("\n" + "=" * 60)
+    console.print("[yellow]⏸️  TASK PAUSED[/yellow]")
+    console.print("=" * 60)
+    console.print(f"\nTask: {state.task_name}")
+    console.print(f"Stage: {state.stage.value} (attempt {state.attempt})")
+    console.print(f"Type: {state.task_type.display_name()}")
+    console.print(f"Description: {state.task_description[:60]}...")
+    console.print("\nYour progress is saved. You can safely shut down now.")
+    console.print("\nTo resume later, run:")
+    console.print("  [cyan]galangal resume[/cyan]")
+    console.print("=" * 60)
+    return 0

galangal/commands/prompts.py

@@ -0,0 +1,89 @@
+"""
+galangal prompts - Manage stage prompts.
+"""
+
+import argparse
+import shutil
+from pathlib import Path
+
+from galangal.config.loader import get_prompts_dir
+from galangal.core.state import parse_stage_arg
+from galangal.prompts.builder import PromptBuilder
+from galangal.ui.console import console, print_error, print_info, print_success
+
+
+def cmd_prompts_export(args: argparse.Namespace) -> int:
+    """Export default prompts to .galangal/prompts/ for customization."""
+    prompts_dir = get_prompts_dir()
+    defaults_dir = Path(__file__).parent.parent / "prompts" / "defaults"
+
+    if not defaults_dir.exists():
+        print_error("Default prompts directory not found.")
+        return 1
+
+    prompts_dir.mkdir(parents=True, exist_ok=True)
+
+    exported = []
+    skipped = []
+
+    for prompt_file in defaults_dir.glob("*.md"):
+        dest = prompts_dir / prompt_file.name
+        if dest.exists():
+            skipped.append(prompt_file.name)
+        else:
+            shutil.copy(prompt_file, dest)
+            exported.append(prompt_file.name)
+
+    if exported:
+        print_success(f"Exported {len(exported)} prompts to .galangal/prompts/")
+        for name in exported:
+            console.print(f"  [green]✓[/green] {name}")
+
+    if skipped:
+        print_info(f"Skipped {len(skipped)} existing prompts (won't overwrite)")
+        for name in skipped:
+            console.print(f"  [dim]○[/dim] {name}")
+
+    console.print("\n[dim]Edit these files to customize prompts for your project.[/dim]")
+    console.print("[dim]Project prompts override package defaults.[/dim]")
+
+    return 0
+
+
+def cmd_prompts_show(args: argparse.Namespace) -> int:
+    """Show the effective prompt for a stage."""
+    # Parse stage (COMPLETE excluded - it has no prompt)
+    stage = parse_stage_arg(args.stage, exclude_complete=True)
+    if stage is None:
+        return 1
+
+    builder = PromptBuilder()
+    prompt = builder.get_stage_prompt(stage)
+
+    # Determine source
+    prompts_dir = get_prompts_dir()
+    override_path = prompts_dir / f"{stage.value.lower()}.md"
+    source = "project override" if override_path.exists() else "package default"
+
+    console.print(f"\n[bold]Stage:[/bold] {stage.value}")
+    console.print(f"[bold]Source:[/bold] {source}")
+    console.print("[dim]" + "=" * 60 + "[/dim]")
+    console.print(prompt)
+    console.print("[dim]" + "=" * 60 + "[/dim]")
+
+    return 0
+
+
+def cmd_prompts(args: argparse.Namespace) -> int:
+    """Prompts management command router."""
+    if hasattr(args, "prompts_command") and args.prompts_command:
+        if args.prompts_command == "export":
+            return cmd_prompts_export(args)
+        elif args.prompts_command == "show":
+            return cmd_prompts_show(args)
+
+    console.print("Usage: galangal prompts <command>")
+    console.print("\nCommands:")
+    console.print("  export    Export default prompts for customization")
+    console.print("  show      Show effective prompt for a stage")
+    return 1

galangal/commands/reset.py

@@ -0,0 +1,41 @@
+"""
+galangal reset - Delete the active task.
+"""
+
+import argparse
+import shutil
+
+from rich.prompt import Prompt
+
+from galangal.core.state import get_task_dir
+from galangal.core.tasks import clear_active_task, get_active_task
+from galangal.ui.console import print_error, print_info, print_success
+
+
+def cmd_reset(args: argparse.Namespace) -> int:
+    """Delete the active task."""
+    active = get_active_task()
+    if not active:
+        print_error("No active task.")
+        return 0
+
+    task_dir = get_task_dir(active)
+    if not task_dir.exists():
+        print_info("Task directory not found.")
+        clear_active_task()
+        return 0
+
+    if not args.force:
+        confirm = (
+            Prompt.ask(f"Delete task '{active}' and all its artifacts? [y/N]", default="n")
+            .strip()
+            .lower()
+        )
+        if confirm != "y":
+            print_info("Reset cancelled.")
+            return 1
+
+    shutil.rmtree(task_dir)
+    clear_active_task()
+    print_success(f"Task '{active}' deleted.")
+    return 0

galangal/commands/resume.py

@@ -0,0 +1,30 @@
+"""
+galangal resume - Resume the active task.
+"""
+
+import argparse
+
+from galangal.core.tasks import ensure_active_task_with_state
+from galangal.core.workflow import run_workflow
+from galangal.ui.console import console
+
+
+def cmd_resume(args: argparse.Namespace) -> int:
+    """Resume the active task."""
+    active, state = ensure_active_task_with_state(
+        no_task_msg="No active task. Use 'list' to see tasks, 'switch' to select one."
+    )
+    if not active or not state:
+        return 1
+
+    console.print(f"[bold]Resuming task:[/bold] {active}")
+    console.print(f"[dim]Stage:[/dim] {state.stage.value}")
+    console.print(f"[dim]Type:[/dim] {state.task_type.display_name()}")
+
+    # Pass skip_discovery flag via state attribute
+    if getattr(args, "skip_discovery", False):
+        state._skip_discovery = True
+        console.print("[dim]Discovery Q&A:[/dim] skipped")
+
+    run_workflow(state)
+    return 0

galangal/commands/skip.py

@@ -0,0 +1,62 @@
+"""
+galangal skip-to - Jump to a specific stage for debugging.
+"""
+
+import argparse
+
+from rich.prompt import Prompt
+
+from galangal.core.state import STAGE_ORDER, parse_stage_arg, save_state
+from galangal.core.tasks import ensure_active_task_with_state
+from galangal.core.workflow import run_workflow
+from galangal.ui.console import console, print_info, print_success
+
+
+def cmd_skip_to(args: argparse.Namespace) -> int:
+    """Jump to a specific stage (for debugging/re-running)."""
+    active, state = ensure_active_task_with_state()
+    if not active or not state:
+        return 1
+
+    # Parse target stage (COMPLETE not allowed - use 'complete' command instead)
+    target_stage = parse_stage_arg(args.stage, exclude_complete=True)
+    if target_stage is None:
+        return 1
+
+    current_stage = state.stage
+    current_idx = STAGE_ORDER.index(current_stage) if current_stage in STAGE_ORDER else -1
+    target_idx = STAGE_ORDER.index(target_stage)
+
+    # Warn if skipping backwards or forwards
+    if target_idx < current_idx:
+        console.print(
+            f"[yellow]⚠️  Going backwards: {current_stage.value} → {target_stage.value}[/yellow]"
+        )
+    elif target_idx > current_idx:
+        console.print(
+            f"[yellow]⚠️  Skipping forward: {current_stage.value} → {target_stage.value}[/yellow]"
+        )
+    else:
+        console.print(f"[dim]Re-running current stage: {target_stage.value}[/dim]")
+
+    if not args.force:
+        confirm = Prompt.ask(f"Jump to {target_stage.value}? [y/N]", default="n").strip().lower()
+        if confirm != "y":
+            print_info("Cancelled.")
+            return 0
+
+    # Update state
+    state.stage = target_stage
+    state.reset_attempts()
+    state.awaiting_approval = False
+    state.clarification_required = False
+    save_state(state)
+
+    print_success(f"Jumped to stage: {target_stage.value}")
+
+    # Optionally resume immediately
+    if args.resume:
+        console.print("\n[dim]Resuming workflow...[/dim]")
+        run_workflow(state)
+
+    return 0