@pennyfarthing/core 7.8.2 → 7.9.0

package/pennyfarthing-dist/scripts/workflow/phase-owner.sh

@@ -16,7 +16,7 @@ fi
 # Find project root
 if [[ -z "${PROJECT_ROOT:-}" ]]; then
   d="$PWD"
-  while [[ ! -d "$d/.claude" ]] && [[ "$d" != "/" ]]; do
+  while [[ ! -d "$d/.pennyfarthing" ]] && [[ "$d" != "/" ]]; do
     d="$(dirname "$d")"
   done
   PROJECT_ROOT="$d"

package/pennyfarthing-dist/scripts/workflow/resume-workflow.sh

@@ -9,7 +9,7 @@ set -euo pipefail
 # PROJECT_ROOT should be set by run.sh, but find it if not
 if [[ -z "${PROJECT_ROOT:-}" ]]; then
   d="$PWD"
-  while [[ ! -d "$d/.claude" ]] && [[ "$d" != "/" ]]; do
+  while [[ ! -d "$d/.pennyfarthing" ]] && [[ "$d" != "/" ]]; do
     d="$(dirname "$d")"
   done
   PROJECT_ROOT="$d"

package/pennyfarthing-dist/scripts/workflow/show-workflow.sh

@@ -11,7 +11,7 @@ set -euo pipefail
 # PROJECT_ROOT should be set by run.sh, but find it if not
 if [[ -z "${PROJECT_ROOT:-}" ]]; then
   d="$PWD"
-  while [[ ! -d "$d/.claude" ]] && [[ "$d" != "/" ]]; do
+  while [[ ! -d "$d/.pennyfarthing" ]] && [[ "$d" != "/" ]]; do
     d="$(dirname "$d")"
   done
   PROJECT_ROOT="$d"

package/pennyfarthing-dist/scripts/workflow/start-workflow.sh

@@ -10,7 +10,7 @@ set -euo pipefail
 # PROJECT_ROOT should be set by run.sh, but find it if not
 if [[ -z "${PROJECT_ROOT:-}" ]]; then
   d="$PWD"
-  while [[ ! -d "$d/.claude" ]] && [[ "$d" != "/" ]]; do
+  while [[ ! -d "$d/.pennyfarthing" ]] && [[ "$d" != "/" ]]; do
     d="$(dirname "$d")"
   done
   PROJECT_ROOT="$d"

package/pennyfarthing-dist/scripts/workflow/workflow-status.sh

@@ -9,7 +9,7 @@ set -euo pipefail
 # PROJECT_ROOT should be set by run.sh, but find it if not
 if [[ -z "${PROJECT_ROOT:-}" ]]; then
   d="$PWD"
-  while [[ ! -d "$d/.claude" ]] && [[ "$d" != "/" ]]; do
+  while [[ ! -d "$d/.pennyfarthing" ]] && [[ "$d" != "/" ]]; do
     d="$(dirname "$d")"
   done
   PROJECT_ROOT="$d"

package/pennyfarthing-dist/workflows/git-cleanup/steps/step-01-analyze.md

@@ -12,6 +12,24 @@ Build a complete picture of:
 
 ## Execution
 
+### 1.0 Check Stash (CRITICAL - DO THIS FIRST)
+
+```bash
+echo "=== Stash Status (CRITICAL) ==="
+git stash list
+```
+
+**If stash has ANY entries:**
+1. Show the stash contents to user
+2. Ask: "Stash contains saved work. Clear it completely before proceeding?"
+3. If user agrees: `git stash clear`
+4. If user declines: **STOP** - do not proceed with cleanup
+
+**This prevents:**
+- Losing work that was stashed from a previous interrupted cleanup
+- Confusion about what changes belong to what
+- Accidentally clearing someone else's stashed work
+
 ### 1.1 Gather Git Status (All Repos)
 
 ```bash

package/pennyfarthing-dist/workflows/git-cleanup/steps/step-03-execute.md

@@ -29,8 +29,13 @@ Execute the approved change groupings following the branch workflow:
 ### 3.1 Stash All Changes
 
 ```bash
-# Stash everything to start clean
-git stash push -m "git-cleanup-$(date +%Y%m%d-%H%M%S)"
+# Stash everything to start clean - MARK CLEARLY
+git stash push -m "CLEANUP-WIP: git-cleanup-$(date +%Y%m%d-%H%M%S)"
+```
+
+**Verify stash worked:**
+```bash
+git stash list  # Should show your CLEANUP-WIP entry
 ```
 
 ### 3.2 For Each Group
@@ -57,8 +62,8 @@ git stash pop
 # Stage only files for this group
 git add {file1} {file2} ...
 
-# Re-stash remaining changes
-git stash push -m "remaining-cleanup"
+# Re-stash remaining changes - MARK CLEARLY
+git stash push -m "CLEANUP-WIP: remaining changes"
 ```
 
 #### Show Diff for Verification
@@ -187,6 +192,15 @@ If a commit fails:
 2. **Merge conflict**: Report to user, offer to abort or resolve
 3. **Test failure**: Report which tests failed, offer to proceed or abort
 
+**CRITICAL: Before panicking about lost work, CHECK STASH:**
+```bash
+git stash list              # Work is probably here!
+git stash show -p stash@{0} # See what's in it
+git stash pop               # Restore it
+```
+
+When a pre-commit hook blocks a commit, staged changes may be auto-stashed. Always check.
+
 ## Output
 
 After all groups processed:

package/pennyfarthing-dist/workflows/git-cleanup/steps/step-05-complete.md

@@ -38,18 +38,26 @@ Run periodically to clean up merged branches:
 git branch --merged develop | grep -v "develop\|main" | xargs -r git branch -d
 ```
 
-### Stash Cleanup
+### Stash Verification (MANDATORY)
 
-If old stashes accumulated:
+**Before completing, verify stash is empty:**
 
 ```bash
-# View stashes
 git stash list
+```
+
+**If stash has entries:**
+- If CLEANUP-WIP entries: These are leftover from this session - pop or clear them
+- If other entries: Ask user before clearing
 
-# Drop old cleanup stashes
-git stash drop stash@{n}
+**Clear stash completely when done:**
+```bash
+# After confirming with user
+git stash clear
 ```
 
+**Why this matters:** Leftover stash entries cause confusion in future cleanups and can lead to lost work if forgotten.
+
 ## Quick Re-run
 
 To run git-cleanup again:

package/pennyfarthing_scripts/jira/client.py

@@ -123,7 +123,7 @@ def get_issue(issue_key: str) -> dict[str, Any] | None:
         return None
 
     result = subprocess.run(
-        ["jira", "issue", "view", issue_key, "--output", "json"],
+        ["jira", "issue", "view", issue_key, "--raw"],
         capture_output=True,
         text=True,
     )

package/pennyfarthing_scripts/prime/__init__.py

@@ -1,22 +1,48 @@
 """
-Prime - Load essential project context at agent activation.
+Prime - Unified agent bootstrap for Pennyfarthing.
 
-This module provides context loading for Pennyfarthing agents, with
-priority-based ordering optimized for attention (most important first).
+This module provides context loading and state detection for Pennyfarthing agents,
+consolidating agent-session.sh, prime.sh, and workflow-status-check into a single
+Python entry point.
 
 Usage:
-    python -m pennyfarthing_scripts.prime [--agent <name>] [--minimal] [--full] [--quiet]
+    python -m pennyfarthing_scripts.prime [--agent <name>] [--json] [--minimal] [--full]
 
 Public API:
     prime() - Load and print context (main entry point)
-    load_agent_definition() - Load agent markdown
-    load_behavior_guide() - Load shared behavior guide
-    load_sprint_context() - Load sprint summary
-    load_session_context() - Load active session header and assessment
-    load_sidecars() - Load agent-specific patterns, gotchas, decisions
-    load_domain_docs() - Load domain documentation (--full only)
+
+    Context Loaders:
+        load_agent_definition() - Load agent markdown
+        load_behavior_guide() - Load shared behavior guide
+        load_sprint_context() - Load sprint summary
+        load_session_context() - Load active session header and assessment
+        load_sidecars() - Load agent-specific patterns, gotchas, decisions
+        load_domain_docs() - Load domain documentation (--full only)
+
+    Workflow Detection:
+        detect_workflow_state() - Detect FINISH/IN_PROGRESS/NEW_WORK/EMPTY_BACKLOG state
+        check_redirect() - Check if agent should redirect to another
+
+    Persona Loading:
+        load_persona() - Load agent persona from theme
+        get_crew_manifest() - Get all agent characters for handoff reference
+        format_persona_output() - Format persona as XML for Claude
+        is_character_voice_enabled() - Check if character voice is enabled
+
+    Session Management:
+        register_session() - Register agent session
+        cleanup_old_sessions() - Remove stale sessions
+        get_session_agent() - Get agent name for session
+        unregister_session() - Remove session
+
+    Models:
+        WorkflowState - Enum of workflow states
+        WorkflowStatus - Workflow detection result
+        Persona - Agent persona data
+        PrimeResult - Complete prime result for JSON output
 """
 
+from pennyfarthing_scripts.prime.cli import prime
 from pennyfarthing_scripts.prime.loader import (
     load_agent_definition,
     load_behavior_guide,
@@ -25,14 +51,75 @@ from pennyfarthing_scripts.prime.loader import (
     load_sidecars,
     load_sprint_context,
 )
-from pennyfarthing_scripts.prime.cli import prime
+from pennyfarthing_scripts.prime.models import (
+    CrewMember,
+    Persona,
+    PrimeResult,
+    SessionInfo,
+    WorkflowState,
+    WorkflowStatus,
+)
+from pennyfarthing_scripts.prime.persona import (
+    format_persona_output,
+    get_crew_manifest,
+    get_current_theme,
+    get_user_title,
+    is_character_voice_enabled,
+    load_persona,
+    load_theme,
+)
+from pennyfarthing_scripts.prime.session import (
+    cleanup_old_sessions,
+    get_session_agent,
+    list_sessions,
+    register_session,
+    unregister_session,
+)
+from pennyfarthing_scripts.prime.workflow import (
+    check_redirect,
+    detect_workflow_state,
+    find_active_session,
+    get_backlog_count,
+    get_phase_owner,
+    parse_session_header,
+)
 
 __all__ = [
+    # Main entry point
     "prime",
+    # Context loaders
     "load_agent_definition",
     "load_behavior_guide",
     "load_sprint_context",
     "load_session_context",
     "load_sidecars",
     "load_domain_docs",
+    # Workflow detection
+    "detect_workflow_state",
+    "check_redirect",
+    "find_active_session",
+    "parse_session_header",
+    "get_phase_owner",
+    "get_backlog_count",
+    # Persona loading
+    "load_persona",
+    "load_theme",
+    "get_current_theme",
+    "get_crew_manifest",
+    "get_user_title",
+    "format_persona_output",
+    "is_character_voice_enabled",
+    # Session management
+    "register_session",
+    "cleanup_old_sessions",
+    "get_session_agent",
+    "unregister_session",
+    "list_sessions",
+    # Models
+    "WorkflowState",
+    "WorkflowStatus",
+    "Persona",
+    "PrimeResult",
+    "CrewMember",
+    "SessionInfo",
 ]