@pennyfarthing/core 11.4.0 → 12.0.0

package/pennyfarthing-dist/pf/jira/claim.py

@@ -1,232 +0,0 @@
-"""
-Claim Jira stories for work.
-
-Usage:
-    python -m pf.jira claim <issue-key> [--claim]
-
-Options:
-    --claim     Actually claim (assign + move to In Progress)
-
-Exit codes:
-    0 - Available or successfully claimed
-    1 - Assigned to someone else
-    2 - Not found or not synced
-    3 - Error (CLI not installed, etc.)
-"""
-
-import argparse
-import sys
-from typing import Any
-
-from pf.jira.client import (
-    get_issue,
-    get_jira_field,
-    is_jira_cli_available,
-    update_issue_status,
-)
-
-
-def parse_args(args: list[str] | None = None) -> argparse.Namespace:
-    """Parse command line arguments.
-
-    Args:
-        args: Command line arguments (defaults to sys.argv[1:])
-
-    Returns:
-        Parsed arguments namespace
-    """
-    parser = argparse.ArgumentParser(
-        description="Check availability and claim a Jira story"
-    )
-    parser.add_argument("issue_key", help="Jira issue key (e.g., MSSCI-12345)")
-    parser.add_argument(
-        "--claim",
-        action="store_true",
-        help="Actually claim (assign to self + move to In Progress)",
-    )
-
-    return parser.parse_args(args)
-
-
-def check_availability(issue_key: str) -> dict[str, Any]:
-    """Check if a story is available for claiming.
-
-    Args:
-        issue_key: Jira issue key
-
-    Returns:
-        Dict with available status and details
-    """
-    if not is_jira_cli_available():
-        return {
-            "available": False,
-            "error": "Jira CLI not installed",
-            "exit_code": 3,
-        }
-
-    issue = get_issue(issue_key)
-    if not issue:
-        return {
-            "available": False,
-            "error": f"Issue {issue_key} not found",
-            "exit_code": 2,
-        }
-
-    assignee = get_jira_field(issue, "fields.assignee.displayName")
-    status = get_jira_field(issue, "fields.status.name", "Unknown")
-    summary = get_jira_field(issue, "fields.summary", "")
-
-    if assignee:
-        return {
-            "available": False,
-            "assigned_to": assignee,
-            "status": status,
-            "summary": summary,
-            "exit_code": 1,
-        }
-
-    return {
-        "available": True,
-        "status": status,
-        "summary": summary,
-        "exit_code": 0,
-    }
-
-
-def claim_story(issue_key: str) -> dict[str, Any]:
-    """Claim a story by assigning to self and moving to In Progress.
-
-    Args:
-        issue_key: Jira issue key
-
-    Returns:
-        Dict with success status and details
-    """
-    import subprocess
-
-    if not is_jira_cli_available():
-        return {
-            "success": False,
-            "error": "Jira CLI not installed",
-            "exit_code": 3,
-        }
-
-    # Check availability first
-    availability = check_availability(issue_key)
-    if not availability["available"]:
-        return {
-            "success": False,
-            "error": f"Story not available: assigned to {availability.get('assigned_to', 'unknown')}",
-            "exit_code": 1,
-        }
-
-    actions = []
-    errors = []
-
-    # Get current user
-    result = subprocess.run(
-        ["jira", "me"],
-        capture_output=True,
-        text=True,
-    )
-    if result.returncode != 0:
-        return {
-            "success": False,
-            "error": "Could not get current Jira user",
-            "exit_code": 3,
-        }
-    current_user = result.stdout.strip()
-
-    # Assign to self
-    result = subprocess.run(
-        ["jira", "issue", "assign", issue_key, current_user, "--project", "MSSCI"],
-        capture_output=True,
-        text=True,
-    )
-    if result.returncode == 0:
-        actions.append(f"Assigned to {current_user}")
-    else:
-        errors.append(f"Failed to assign: {result.stderr}")
-
-    # Move to In Progress
-    if update_issue_status(issue_key, "In Progress"):
-        actions.append("Moved to In Progress")
-    else:
-        errors.append("Failed to move to In Progress")
-
-    if errors:
-        return {
-            "success": False,
-            "actions": actions,
-            "errors": errors,
-            "exit_code": 3,
-        }
-
-    # Update sprint YAML assigned_to field
-    try:
-        from pf.common.config import get_project_root
-        from pf.sprint.yaml_io import read_sprint, write_sprint
-
-        root = get_project_root()
-        sprint_path = root / "sprint" / "current-sprint.yaml"
-        if sprint_path.exists():
-            data = read_sprint(sprint_path)
-            for epic in data.get("epics", []):
-                if not isinstance(epic, dict):
-                    continue
-                for story in epic.get("stories", []):
-                    if story.get("jira") == issue_key:
-                        story["assigned_to"] = current_user
-                        write_sprint(sprint_path, data)
-                        actions.append("Sprint YAML assigned_to set")
-                        break
-    except Exception:
-        pass  # Best-effort — Jira claim already succeeded
-
-    return {
-        "success": True,
-        "actions": actions,
-        "exit_code": 0,
-    }
-
-
-def main(args: list[str] | None = None) -> int:
-    """CLI entry point.
-
-    Args:
-        args: Command line arguments (defaults to sys.argv[1:])
-
-    Returns:
-        Exit code
-    """
-    parsed_args = parse_args(args)
-
-    if parsed_args.claim:
-        result = claim_story(parsed_args.issue_key)
-        if result["success"]:
-            print(f"Claimed {parsed_args.issue_key}")
-            for action in result.get("actions", []):
-                print(f"  {action}")
-            return 0
-        else:
-            print(f"Failed to claim: {result.get('error', 'Unknown error')}", file=sys.stderr)
-            for err in result.get("errors", []):
-                print(f"  {err}", file=sys.stderr)
-            return result.get("exit_code", 1)
-    else:
-        result = check_availability(parsed_args.issue_key)
-        if result["available"]:
-            print(f"{parsed_args.issue_key}: Available")
-            print(f"  Status: {result.get('status')}")
-            print(f"  Summary: {result.get('summary')}")
-            return 0
-        else:
-            if result.get("assigned_to"):
-                print(f"{parsed_args.issue_key}: Assigned to {result['assigned_to']}")
-            else:
-                print(f"{parsed_args.issue_key}: {result.get('error', 'Not available')}")
-            return result.get("exit_code", 1)
-
-
-if __name__ == "__main__":
-    sys.exit(main())

package/pennyfarthing-dist/pf/jira/cli.py

@@ -1,362 +0,0 @@
-"""
-Jira CLI - Unified entry point for all Jira operations.
-
-Usage:
-    pf jira <command> [args]
-    python -m pf.jira <command> [args]
-
-Commands:
-    view         View issue details
-    check        Check story availability
-    claim        Claim a story
-    move         Transition issue status
-    assign       Assign issue to user
-    link         Link two issues
-    search       Search issues by JQL
-    create epic  Create epic + stories from YAML
-    create story Create single story from YAML
-    sync         Sync epic to Jira
-    bidirectional Bidirectional sync
-    reconcile    Reconciliation report
-    sprint add   Add issue to sprint
-"""
-
-import sys
-
-import click
-
-
-@click.group()
-def jira():
-    """Jira issue management for Pennyfarthing.
-
-    \b
-    All operations use REST API where possible.
-    No interactive prompts, no subprocess stdin issues.
-    """
-    pass
-
-
-@jira.command()
-@click.argument("key")
-def view(key):
-    """View issue details (delegates to jira CLI)."""
-    import subprocess
-
-    result = subprocess.run(
-        ["jira", "issue", "view", key],
-        capture_output=False,
-    )
-    raise SystemExit(result.returncode)
-
-
-@jira.command()
-@click.argument("key")
-def check(key):
-    """Check if a story is available to claim."""
-    from pf.jira.claim import main as claim_main
-
-    raise SystemExit(claim_main([key]))
-
-
-@jira.command()
-@click.argument("key")
-@click.option("--dry-run", is_flag=True, help="Show what would be done without making changes")
-def claim(key, dry_run):
-    """Claim a story (assign to self + move to In Progress)."""
-    if dry_run:
-        click.echo(f"[DRY-RUN] Would claim {key} (assign to self + move to In Progress)")
-        return
-    from pf.jira.claim import main as claim_main
-
-    raise SystemExit(claim_main([key, "--claim"]))
-
-
-@jira.command()
-@click.argument("key")
-@click.argument("status")
-@click.option("--dry-run", is_flag=True, help="Preview without applying")
-def move(key, status, dry_run):
-    """Transition a Jira issue to a new status.
-
-    \b
-    Statuses: "To Do", "In Progress", "In Review", "Done"
-    """
-    from pf.jira.operations import move_issue
-
-    result = move_issue(key, status, dry_run=dry_run)
-    if result.get("already_at_status"):
-        click.echo(f"{key} already at '{status}'")
-    elif result.get("success"):
-        click.echo(f"Moved {key} to '{status}'")
-    else:
-        click.echo(f"Failed: {result.get('reason', 'unknown')}", err=True)
-        raise SystemExit(1)
-
-
-@jira.command()
-@click.argument("key")
-@click.argument("user")
-@click.option("--dry-run", is_flag=True, help="Preview without applying")
-def assign(key, user, dry_run):
-    """Assign issue to a user (email or GitHub username)."""
-    from pf.jira.operations import assign_issue
-
-    result = assign_issue(key, user, dry_run=dry_run)
-    if result.get("already_assigned"):
-        click.echo(f"{key} already assigned to {user}")
-    elif result.get("success"):
-        click.echo(f"Assigned {key} to {user}")
-    else:
-        click.echo(f"Failed: {result.get('reason', 'unknown')}", err=True)
-        raise SystemExit(1)
-
-
-@jira.command()
-@click.argument("parent_key")
-@click.argument("child_key")
-@click.argument("link_type", default="Relates")
-@click.option("--dry-run", is_flag=True, help="Preview without applying")
-def link(parent_key, child_key, link_type, dry_run):
-    """Link two Jira issues.
-
-    \b
-    Link types: "Parent-Child", "Blocks", "Relates", "Duplicate"
-    """
-    from pf.jira.operations import link_issues
-
-    result = link_issues(parent_key, child_key, link_type, dry_run=dry_run)
-    if result.get("success"):
-        click.echo(f"Linked {parent_key} -> {child_key} ({link_type})")
-    else:
-        click.echo(f"Failed: {result.get('reason', 'unknown')}", err=True)
-        raise SystemExit(1)
-
-
-@jira.command()
-@click.argument("jql")
-def search(jql):
-    """Search issues using JQL (delegates to jira CLI)."""
-    import subprocess
-
-    result = subprocess.run(
-        ["jira", "issue", "list", "--jql", jql, "--plain"],
-        capture_output=False,
-    )
-    raise SystemExit(result.returncode)
-
-
-@jira.group()
-def create():
-    """Create Jira issues from sprint YAML."""
-    pass
-
-
-@create.command("epic")
-@click.argument("epic_id")
-@click.option("--dry-run", is_flag=True, help="Preview without creating")
-def create_epic(epic_id, dry_run):
-    """Create a Jira epic and its child stories from sprint YAML."""
-    from pf.jira.create import create_epic_in_jira
-
-    result = create_epic_in_jira(epic_id, dry_run=dry_run)
-    if not result.get("success"):
-        click.echo(f"Failed: {result.get('error', 'unknown')}", err=True)
-        raise SystemExit(1)
-
-
-@create.command("story")
-@click.argument("epic_jira_key")
-@click.argument("story_id")
-@click.option("--dry-run", is_flag=True, help="Preview without creating")
-def create_story(epic_jira_key, story_id, dry_run):
-    """Create a single Jira story under an epic from sprint YAML."""
-    from pf.jira.create import create_story_in_jira
-
-    result = create_story_in_jira(epic_jira_key, story_id, dry_run=dry_run)
-    if not result.get("success") and not result.get("dry_run"):
-        click.echo(f"Failed: {result.get('error', 'unknown')}", err=True)
-        raise SystemExit(1)
-
-
-@create.command("standalone")
-@click.argument("title")
-@click.option("--points", default=2, type=int, help="Story points (default: 2)")
-@click.option("--description", "-d", default="", help="Story description")
-@click.option("--dry-run", is_flag=True, help="Preview without creating")
-def create_standalone(title, points, description, dry_run):
-    """Create a standalone Jira story, add to sprint, mark Done.
-
-    Uses REST API directly — no interactive prompts, no stdin issues.
-
-    \b
-    Arguments:
-      TITLE  - Story summary
-
-    \b
-    Examples:
-      pf jira create standalone "Fix sprint script shard support" --points 3
-      pf jira create standalone "Add drift detection" -d "Detects YAML drift"
-      pf jira create standalone "Quick fix" --dry-run
-    """
-    from pf.jira.client import JIRA_PROJECT, get_client
-    from pf.jira.create import _build_adf_description
-    from pf.sprint.loader import get_sprint_info
-
-    sprint_info = get_sprint_info()
-    sprint_id = sprint_info.get("jira_sprint_id")
-
-    if dry_run:
-        click.echo(f"[DRY-RUN] Would create: {title}")
-        click.echo(f"  Points: {points}")
-        click.echo(f"  Sprint: {sprint_id}")
-        click.echo("  Actions: create -> add to sprint -> transition to Done")
-        return
-
-    client = get_client()
-
-    # 1. Create the story
-    payload = {
-        "fields": {
-            "project": {"key": JIRA_PROJECT},
-            "summary": title,
-            "description": _build_adf_description(description),
-            "issuetype": {"name": "Story"},
-            "labels": ["pennyfarthing"],
-        }
-    }
-
-    response = client.create_issue_sync(payload)
-    if not response or "key" not in response:
-        raise click.ClickException(f"Failed to create story: {response}")
-
-    jira_key = response["key"]
-    click.echo(f"Created: {jira_key}")
-
-    # 2. Set story points
-    if points > 0:
-        client.update_issue_sync(jira_key, {"customfield_10031": points})
-
-    # 3. Add to sprint
-    if sprint_id:
-        client.add_to_sprint_sync(sprint_id, jira_key)
-        click.echo(f"Added to sprint {sprint_id}")
-
-    # 4. Transition to Done
-    result = client.transition_sync(jira_key, "Done")
-    if result.get("success"):
-        click.echo("Transitioned to Done")
-    else:
-        click.echo(f"Warning: could not transition to Done: {result.get('reason')}")
-
-    click.echo(f"\n{jira_key}: {title}")
-    click.echo(f"https://1898andco.atlassian.net/browse/{jira_key}")
-
-
-@jira.command()
-@click.argument("epic")
-@click.option("--dry-run", is_flag=True, help="Preview without applying")
-@click.option("--transition", is_flag=True, help="Sync status to Jira")
-@click.option("--points", is_flag=True, help="Sync story points")
-@click.option("--all", "sync_all", is_flag=True, help="Sync all fields")
-def sync(epic, dry_run, transition, points, sync_all):
-    """Sync epic stories from sprint YAML to Jira."""
-    from pf.jira.sync import main as sync_main
-
-    args = [epic]
-    if dry_run:
-        args.append("--dry-run")
-    if transition or sync_all:
-        args.append("--transition")
-    if points or sync_all:
-        args.append("--points")
-    raise SystemExit(sync_main(args))
-
-
-@jira.command()
-@click.option("--dry-run", is_flag=True, help="Preview without applying")
-@click.option("--yaml-wins", is_flag=True, help="Prefer YAML values on conflict")
-@click.option("--status", is_flag=True, help="Sync status field")
-@click.option("--points", is_flag=True, help="Sync story points")
-@click.option("--assignee", is_flag=True, help="Sync assignee field (Jira -> YAML only)")
-@click.option("--all", "sync_all", is_flag=True, help="Sync all fields")
-@click.option("--sprint", "sprint_id", help="Target specific sprint")
-def bidirectional(dry_run, yaml_wins, status, points, assignee, sync_all, sprint_id):
-    """Bidirectional sync between YAML and Jira."""
-    from pf.jira.bidirectional import main as bidirectional_main
-
-    args = []
-    if dry_run:
-        args.append("--dry-run")
-    if yaml_wins:
-        args.append("--yaml-wins")
-    if status or sync_all:
-        args.append("--status")
-    if points or sync_all:
-        args.append("--points")
-    if assignee or sync_all:
-        args.append("--assignee")
-    if sync_all:
-        args.append("--all")
-    if sprint_id:
-        args.extend(["--sprint", sprint_id])
-    raise SystemExit(bidirectional_main(args))
-
-
-@jira.command()
-@click.option("--fix", is_flag=True, help="Apply automatic fixes where safe")
-def reconcile(fix):
-    """Reconciliation report: sprint YAML vs Jira."""
-    from pf.jira.reconcile import reconcile as run_reconcile
-
-    result = run_reconcile(fix=fix)
-    if not result.get("success"):
-        click.echo(f"Failed: {result.get('error', 'unknown')}", err=True)
-        raise SystemExit(1)
-
-
-@jira.group("sprint")
-def jira_sprint():
-    """Sprint operations."""
-    pass
-
-
-@jira_sprint.command("add")
-@click.argument("sprint_id")
-@click.argument("issue_key")
-@click.option("--dry-run", is_flag=True, help="Show what would be done without making changes")
-def sprint_add(sprint_id, issue_key, dry_run):
-    """Add an issue to a sprint."""
-    if dry_run:
-        click.echo(f"[DRY-RUN] Would add {issue_key} to sprint {sprint_id}")
-        return
-    from pf.jira.client import get_client
-
-    client = get_client()
-    result = client.add_to_sprint_sync(sprint_id, issue_key)
-    if result.get("success"):
-        click.echo(f"Added {issue_key} to sprint {sprint_id}")
-    else:
-        click.echo(f"Failed: {result.get('reason', 'unknown')}", err=True)
-        raise SystemExit(1)
-
-
-def cli(args=None):
-    """Backwards-compatible entry point."""
-    try:
-        jira(args, standalone_mode=False)
-    except SystemExit as e:
-        return e.code or 0
-    except click.exceptions.UsageError as e:
-        click.echo(str(e), err=True)
-        return 1
-    return 0
-
-
-def main(args=None):
-    """Alias for cli()."""
-    return cli(args)
-
-
-if __name__ == "__main__":
-    sys.exit(cli())