@pennyfarthing/core 10.0.3 → 10.0.5

package/pennyfarthing-dist/guides/xml-tags.md

@@ -447,7 +447,7 @@ Tags used in skill files (`skills/{name}/SKILL.md`) for command documentation.
 
 ```markdown
 <run>
-.pennyfarthing/scripts/sprint/sprint-status.sh [filter]
+pf sprint status [filter]
 </run>
 ```
 
@@ -473,7 +473,7 @@ Tags used in skill files (`skills/{name}/SKILL.md`) for command documentation.
 
 ```markdown
 <example>
-.pennyfarthing/scripts/sprint/check-story.sh MSSCI-12038
+pf sprint check MSSCI-12038
 # Returns: {"type": "story", "available": true}
 </example>
 ```

package/pennyfarthing-dist/scripts/README.md

@@ -8,7 +8,7 @@ Scripts are organized into categorical subdirectories. **Full paths are required
 scripts/
 ├── core/       # Essential scripts (agent-session.sh)
 ├── workflow/   # Workflow mechanics (finish-story.sh, check.sh)
-├── sprint/     # Sprint YAML operations (sprint-status.sh)
+├── sprint/     # Sprint YAML operations (migrated to pf sprint CLI)
 ├── story/      # Story operations (create-story.sh)
 ├── jira/       # Jira integration (jira-claim-story.sh)
 ├── git/        # Git operations (release.sh, worktree-manager.sh)
@@ -27,7 +27,7 @@ Scripts are invoked directly with **full category paths**:
 ```bash
 # From project root
 .pennyfarthing/scripts/core/agent-session.sh start sm
-.pennyfarthing/scripts/sprint/sprint-status.sh
+pf sprint status
 .pennyfarthing/scripts/jira/jira-claim-story.sh MSSCI-12345
 .pennyfarthing/scripts/workflow/finish-story.sh MSSCI-12345
 ```

package/pennyfarthing-dist/scripts/git/git-status-all.sh

@@ -3,7 +3,7 @@
 # Usage: ./scripts/git-status-all.sh [--brief]
 #
 # Shows: branch, status, unpushed commits for all repos
-# Reads repo configuration from .claude/project/repos.yaml
+# Reads repo configuration from .pennyfarthing/repos.yaml
 
 set -e
 

package/pennyfarthing-dist/scripts/git/worktree-manager.sh

@@ -3,7 +3,7 @@
 # Usage: worktree-manager.sh {create|remove|list|status|ports|cd} [args]
 #
 # Configuration (choose one):
-#   1. repos.yaml: Define repos in .claude/project/repos.yaml (recommended)
+#   1. repos.yaml: Define repos in .pennyfarthing/repos.yaml (recommended)
 #   2. Legacy env vars: Set API_REPO and UI_REPO in .claude/project/hooks/setup-env.sh
 
 set -e
@@ -109,7 +109,7 @@ load_repos_config
 if [ "$(get_repo_count)" -eq 0 ]; then
     echo "❌ Error: No repositories configured"
     echo ""
-    echo "Option 1: Create .claude/project/repos.yaml (recommended for multi-repo projects)"
+    echo "Option 1: Create .pennyfarthing/repos.yaml (recommended for multi-repo projects)"
     echo "Option 2: Set API_REPO and UI_REPO in .claude/project/hooks/setup-env.sh"
     exit 1
 fi
@@ -161,7 +161,7 @@ Repos Filter (third argument):
   repo1,repo2   - Comma-separated list of specific repo names
 
 Configuration:
-  Option 1 (recommended): Create .claude/project/repos.yaml
+  Option 1 (recommended): Create .pennyfarthing/repos.yaml
   Option 2 (legacy): Set API_REPO and UI_REPO environment variables
 
 Session Files:

package/pennyfarthing-dist/scripts/hooks/post-merge.sh

@@ -10,7 +10,7 @@
 #
 # Dependencies:
 #   - yq (for YAML manipulation)
-#   - sprint-common.sh (for shared sprint functions)
+#   (sprint-common.sh removed — all functions defined locally)
 
 set -uo pipefail
 
@@ -22,12 +22,7 @@ source "$(dirname "$REAL_SCRIPT")/../lib/find-root.sh"
 SESSION_DIR="$PROJECT_ROOT/.session"
 SPRINT_FILE="$PROJECT_ROOT/sprint/current-sprint.yaml"
 
-# Source sprint-common.sh for shared functions
-SPRINT_COMMON="$PROJECT_ROOT/.pennyfarthing/scripts/sprint/sprint-common.sh"
-if [[ -f "$SPRINT_COMMON" ]]; then
-    # shellcheck source=/dev/null
-    source "$SPRINT_COMMON"
-fi
+# Note: sprint-common.sh removed — all needed functions are defined locally below
 
 # extract_story_id BRANCH_NAME
 # Extract story ID from branch name pattern feat/X-Y-*

package/pennyfarthing-dist/scripts/hooks/sprint-yaml-validation.sh

@@ -15,7 +15,7 @@
 # Input: JSON via stdin with tool_name, tool_input
 # Output: JSON with additionalContext on validation failure
 #
-# See also: .pennyfarthing/scripts/validation/validate-sprint-yaml.sh
+# See also: pf sprint validate
 
 set -euo pipefail
 

package/pennyfarthing-dist/scripts/misc/repo-utils.sh

@@ -4,7 +4,7 @@
 #
 # Usage: source scripts/repo-utils.sh
 #
-# If .claude/project/repos.yaml exists, uses that configuration.
+# If .pennyfarthing/repos.yaml exists, uses that configuration.
 # Otherwise, falls back to legacy $API_REPO/$UI_REPO environment variables.
 #
 # Core Functions:
@@ -28,7 +28,7 @@ set -euo pipefail
 
 # Determine PROJECT_ROOT if not set
 PROJECT_ROOT="${PROJECT_ROOT:-$(git rev-parse --show-toplevel 2>/dev/null || pwd)}"
-REPOS_CONFIG="${PROJECT_ROOT}/.claude/project/pennyfarthing-settings.yaml"
+REPOS_CONFIG="${PROJECT_ROOT}/.pennyfarthing/repos.yaml"
 
 # Cache for parsed config (associative arrays)
 declare -A _REPO_PATHS 2>/dev/null || true
@@ -136,7 +136,7 @@ import json
 import sys
 import os
 
-config_path = os.environ.get('REPOS_CONFIG', '.claude/project/repos.yaml')
+config_path = os.environ.get('REPOS_CONFIG', '.pennyfarthing/repos.yaml')
 try:
     with open(config_path) as f:
         config = yaml.safe_load(f)

package/pennyfarthing-dist/scripts/sprint/README.md

@@ -1,29 +1,44 @@
 # Sprint Scripts
 
-Scripts for sprint YAML operations and sprint management.
-
-## Scripts
-
-| Script | Purpose |
-|--------|---------|
-| `sprint-status.sh` | Show current sprint status and metrics |
-| `sprint-info.sh` | Display sprint information |
-| `available-stories.sh` | List available stories in backlog |
-| `archive-story.sh` | Archive completed story to sprint archive |
-| `check-story.sh` | Check story details and readiness |
-| `new-sprint.sh` | Create a new sprint |
-| `promote-epic.sh` | Move epic from planning to current sprint |
-| `sprint-common.sh` | Shared sprint utilities (library) |
-| `sprint-metrics.sh` | Calculate sprint metrics |
+Sprint management is handled by the Python CLI: `pf sprint [COMMAND]`.
+
+## Commands
+
+| Command | Purpose |
+|---------|---------|
+| `pf sprint status` | Show current sprint status and metrics |
+| `pf sprint backlog` | List available stories grouped by epic |
+| `pf sprint info` | Sprint info as JSON (for Cyclist sidebar) |
+| `pf sprint metrics` | Sprint velocity and progress metrics |
+| `pf sprint check <id>` | Check story/epic availability (JSON) |
+| `pf sprint future` | Show future initiatives and epics |
+| `pf sprint new` | Initialize a new sprint |
+| `pf sprint validate <file>` | Validate sprint YAML structure |
+| `pf sprint archive <id>` | Archive a completed story |
+| `pf sprint work <id>` | Start work on a story |
+| `pf sprint story field <id> <field>` | Get a story field value |
+| `pf sprint epic field <id> <field>` | Get an epic field value |
+| `pf sprint epic promote <id>` | Move epic from future to current sprint |
+| `pf sprint epic show <id>` | Show epic details |
+| `pf sprint epic cancel <id>` | Cancel an epic |
+| `pf sprint epic archive` | Archive completed epics |
 
 ## Usage
 
 ```bash
-.pennyfarthing/scripts/sprint/sprint-status.sh
-.pennyfarthing/scripts/sprint/available-stories.sh
+pf sprint status
+pf sprint backlog
+pf sprint future epic-55
+pf sprint epic promote epic-41
 ```
 
 ## Ownership
 
 - **Primary users:** SM agent, `/sprint` skill
 - **Maintained by:** Core Pennyfarthing team
+
+## Migration Note
+
+All bash scripts previously in this directory have been migrated to Python CLI
+commands in `pennyfarthing_scripts/sprint/cli.py`. See PR #716 and the follow-up
+deprecation commit for details.

package/pennyfarthing-dist/scripts/story/README.md

@@ -19,5 +19,5 @@ Scripts for story creation and management.
 
 ## Ownership
 
-- **Primary users:** SM agent, `/story` skill
+- **Primary users:** SM agent, `/sprint story` commands
 - **Maintained by:** Core Pennyfarthing team

package/pennyfarthing-dist/scripts/test/test-setup.sh

@@ -4,7 +4,7 @@
 #
 # Usage: source scripts/test/test-setup.sh
 #
-# Configuration is read from .claude/project/repos.yaml
+# Configuration is read from .pennyfarthing/repos.yaml
 # See repos.yaml for schema documentation
 #
 # Functions:

package/pennyfarthing-dist/skills/skill-registry.yaml

@@ -141,7 +141,7 @@ skills:
         invocation: /jira assign ISSUE-123
     anti_patterns:
       - Don't bypass Jira for sprint tracking
-    related_skills: [sprint, story]
+    related_skills: [sprint]
     keywords: [atlassian, issues, tickets, backlog]
 
   judge:
@@ -251,20 +251,26 @@ skills:
 
   sprint:
     name: sprint
-    description: Sprint status, backlog, and story management for Pennyfarthing
+    description: Sprint status, backlog, story, and epic management for Pennyfarthing
     category: project-management
-    tags: [sprint, status, backlog]
-    version: "1.0.0"
+    tags: [sprint, status, backlog, stories, epics]
+    version: "2.0.0"
     prerequisites: []
     examples:
       - context: Checking sprint status
         invocation: /sprint
       - context: Finding available stories
         invocation: /sprint backlog
+      - context: Adding a story
+        invocation: /sprint story add epic-76 "My story" 3
+      - context: Sizing guidelines
+        invocation: /sprint story size
+      - context: Adding an epic
+        invocation: /sprint epic add epic-85 "New epic"
     anti_patterns:
       - Don't manually edit sprint YAML - use scripts
-    related_skills: [story, jira]
-    keywords: [sprint, backlog, velocity, kanban]
+    related_skills: [jira]
+    keywords: [sprint, backlog, velocity, kanban, stories, epics, sizing, templates]
     allowed_tools: [Read, Glob, Grep, Bash, Task]
 
   systematic-debugging:
@@ -287,18 +293,21 @@ skills:
 
   story:
     name: story
-    description: Story creation, sizing, and templates for Pennyfarthing workflow
+    description: "DEPRECATED: Use /sprint story instead. Story commands consolidated under /sprint."
     category: project-management
-    tags: [stories, sizing, workflow]
-    version: "1.0.0"
+    tags: [stories, sizing, workflow, deprecated]
+    version: "2.0.0"
+    deprecated: true
+    redirect: sprint
     prerequisites: []
     examples:
       - context: Creating new stories
-        invocation: /story create
+        invocation: /sprint story add
       - context: Sizing stories
-        invocation: /story size
+        invocation: /sprint story size
     anti_patterns:
       - Don't create stories without acceptance criteria
+      - Don't use /story directly - use /sprint story instead
     related_skills: [sprint, jira]
     keywords: [user-stories, estimation, points, acceptance-criteria]
 
@@ -372,7 +381,7 @@ skills:
         invocation: /workflow start architecture
     anti_patterns:
       - Don't switch workflows mid-story unless requirements fundamentally changed
-    related_skills: [sprint, story]
+    related_skills: [sprint]
     keywords: [tdd, trivial, agent-docs, bdd, architecture, bikelane, stepped, phased]
 
   yq: