@pennyfarthing/core 11.0.0-alpha.0 → 11.1.0

package/pennyfarthing_scripts/prime/workflow.py

@@ -275,3 +275,42 @@ def check_redirect(workflow_status: WorkflowStatus, agent_name: str) -> tuple[st
             )
 
     return None
+
+
+def get_phase_tandem_config(
+    workflow_name: str, phase_name: str, project_root: Path | None = None
+) -> dict[str, Any] | None:
+    """Extract tandem configuration for a specific workflow phase.
+
+    Reads the workflow YAML and returns the tandem block for the given phase,
+    or None if the phase has no tandem configuration.
+
+    Args:
+        workflow_name: Workflow name (tdd-tandem, bdd-tandem, etc.)
+        phase_name: Phase name (red, green, review, etc.)
+        project_root: Project root path (auto-detected if not provided)
+
+    Returns:
+        Dict with tandem config (partner, mode, model, token_budget, triggers, scope)
+        or None if no tandem config on this phase.
+    """
+    root = project_root or get_project_root()
+    workflow_path = root / "pennyfarthing-dist" / "workflows" / f"{workflow_name}.yaml"
+
+    if not workflow_path.exists():
+        return None
+
+    try:
+        data = yaml.safe_load(workflow_path.read_text())
+        phases = data.get("workflow", {}).get("phases", [])
+
+        for phase in phases:
+            if isinstance(phase, dict) and phase.get("name") == phase_name:
+                tandem = phase.get("tandem")
+                if isinstance(tandem, dict):
+                    return dict(tandem)
+                return None
+
+        return None
+    except Exception:
+        return None

package/pennyfarthing_scripts/session/cli.py

@@ -0,0 +1,87 @@
+"""
+Session CLI - Click-based CLI for session lifecycle management.
+
+Usage:
+    pf session [COMMAND] [ARGS]...
+
+Commands:
+    new       Start the next available story from the backlog
+    continue  Resume work from a saved checkpoint
+"""
+
+import click
+
+
+@click.group()
+def session():
+    """Session lifecycle management.
+
+    \b
+    Commands:
+      new       - Start the next available story from backlog
+      continue  - Resume from saved checkpoint after context circuit breaker
+    """
+    pass
+
+
+@session.command("new")
+def session_new():
+    """Start the next available story from the sprint backlog.
+
+    Equivalent to: pf sprint work next
+    """
+    # Delegate to sprint work command
+    from pennyfarthing_scripts.sprint.work import start_work
+
+    start_work("next")
+
+
+@session.command("continue")
+@click.option("--list", "list_only", is_flag=True, help="Just display available checkpoints")
+@click.option("--story-id", help="Resume specific story directly")
+def session_continue(list_only: bool, story_id: str | None):
+    """Resume work from a saved checkpoint after context circuit breaker.
+
+    \b
+    Options:
+      --list       Display available checkpoints without restoring
+      --story-id   Resume specific story directly (skip selection)
+    """
+    from pennyfarthing_scripts.common.config import get_project_root
+
+    root = get_project_root()
+    session_dir = root / ".session"
+
+    if not session_dir.is_dir():
+        click.echo("No .session/ directory found", err=True)
+        raise SystemExit(1)
+
+    checkpoints = sorted(session_dir.glob("*-checkpoint.md"))
+
+    if not checkpoints:
+        click.echo("No saved checkpoints found")
+        click.echo("Use /pf-session new to start a new story")
+        return
+
+    if list_only:
+        click.echo("Available checkpoints:")
+        for cp in checkpoints:
+            click.echo(f"  {cp.stem}")
+        return
+
+    if story_id:
+        matches = [cp for cp in checkpoints if story_id in cp.stem]
+        if not matches:
+            click.echo(f"No checkpoint found for story {story_id}", err=True)
+            raise SystemExit(1)
+        target = matches[0]
+    else:
+        click.echo("Available checkpoints:")
+        for i, cp in enumerate(checkpoints, 1):
+            click.echo(f"  {i}. {cp.stem}")
+        target = checkpoints[0]
+
+    click.echo("\nTo resume, load the agent with checkpoint context:")
+    click.echo(f"  Read: {target}")
+
+

package/pennyfarthing_scripts/session_start_hook.py

@@ -33,9 +33,9 @@ def _setup_session_dir(project_dir: Path, session_id: str, source_type: str) ->
     session_dir.mkdir(parents=True, exist_ok=True)
     (session_dir / "agents").mkdir(exist_ok=True)
 
-    from datetime import datetime, timezone
+    from datetime import UTC, datetime
 
-    timestamp = datetime.now(timezone.utc).isoformat()
+    timestamp = datetime.now(UTC).isoformat()
     log_file = session_dir / "session-log.txt"
     with open(log_file, "a") as f:
         f.write(f"{timestamp} | Session {source_type}: {session_id}\n")
@@ -88,9 +88,9 @@ def _validate_checkpoint(project_dir: Path) -> None:
             return
 
         # Log drift
-        from datetime import datetime, timezone
+        from datetime import UTC, datetime
 
-        timestamp = datetime.now(timezone.utc).isoformat()
+        timestamp = datetime.now(UTC).isoformat()
         session_dir = project_dir / ".session"
 
         warning = f"CROSS_SESSION_DRIFT: Git changed (was: {prev_sha}, now: {current_sha})"

package/pennyfarthing_scripts/sprint/archive_epic.py

@@ -65,7 +65,11 @@ def ensure_archive_file(project_root: Path | None = None) -> Path:
 
     sprint_name = sprint_info.get("jira_sprint_name", "Unknown Sprint")
     sprint_id = sprint_info.get("jira_sprint_id", "")
+    sprint_number = sprint_info.get("number", "")
     goal = sprint_info.get("goal", "")
+    start_date = sprint_info.get("start_date", "")
+    end_date = sprint_info.get("end_date", "")
+    status = sprint_info.get("status", "active")
 
     template = f"""# Sprint {sprint_name} - Completed Work
 # Jira Sprint ID: {sprint_id}
@@ -73,9 +77,13 @@ def ensure_archive_file(project_root: Path | None = None) -> Path:
 
 sprint:
   name: "{sprint_name}"
+  number: {sprint_number}
   jira_sprint_id: {sprint_id}
   jira_sprint_name: "{sprint_name}"
   goal: {goal}
+  start_date: {start_date}
+  end_date: {end_date}
+  status: {status}
 
 completed_epics:
   # Epic shard files live in sprint/archive/epic-{{ref}}.yaml