@pennyfarthing/core 11.0.0 → 11.1.1

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/sprint/story_finish.py

@@ -126,8 +126,16 @@ def finish_story(
     steps: list[dict[str, Any]] = []
     archive_name = f"{jira_key}-session.md" if jira_key else f"{story_id}-session.md"
 
+    # Check for dialogue file
+    dialogue_path = project_root / ".session" / f"{story_id}-dialogue.md"
+    dialogue_archive_name = (
+        f"{jira_key}-dialogue.md" if jira_key else f"{story_id}-dialogue.md"
+    )
+
     if dry_run:
         steps.append({"step": 1, "action": f"Archive session → {archive_dir / archive_name}"})
+        if dialogue_path.exists():
+            steps.append({"step": "1b", "action": f"Archive dialogue → {archive_dir / dialogue_archive_name}"})
         if pr_number:
             steps.append({"step": 2, "action": f"Merge PR #{pr_number} (squash, delete branch)"})
         else:
@@ -147,6 +155,12 @@ def finish_story(
     shutil.copy2(session_path, archive_dest)
     steps.append({"step": 1, "action": "archive_session", "dest": str(archive_dest)})
 
+    # --- Step 1b: Archive dialogue (if exists) ---
+    if dialogue_path.exists():
+        dialogue_dest = archive_dir / dialogue_archive_name
+        shutil.copy2(dialogue_path, dialogue_dest)
+        steps.append({"step": "1b", "action": "archive_dialogue", "dest": str(dialogue_dest)})
+
     # --- Step 2: Merge PR ---
     if pr_number:
         result = _run(["gh", "pr", "merge", pr_number, "--squash", "--delete-branch"])