@pennyfarthing/core 7.9.0 → 7.9.2

package/pennyfarthing-dist/scripts/sprint/check-story.sh

@@ -1,164 +0,0 @@
-#!/bin/bash
-# Check if a story or epic exists and is available for work
-# Usage: check-story.sh <id|next>
-#
-# Arguments:
-#   <story-id>  - Check specific story availability
-#   <epic-id>   - Get first available story in epic
-#   next        - Get highest-priority available story across all epics
-#
-# Returns JSON with story/epic details and availability
-
-set -euo pipefail
-
-ID="${1:-}"
-
-if [[ -z "$ID" ]]; then
-  echo '{"type": "error", "message": "No ID provided"}'
-  exit 1
-fi
-
-# PROJECT_ROOT should be set by run.sh
-if [[ -z "${PROJECT_ROOT:-}" ]]; then
-  d="$PWD"
-  while [[ ! -d "$d/.pennyfarthing" ]] && [[ "$d" != "/" ]]; do
-    d="$(dirname "$d")"
-  done
-  PROJECT_ROOT="$d"
-fi
-
-SPRINT_FILE="$PROJECT_ROOT/sprint/current-sprint.yaml"
-
-if [[ ! -f "$SPRINT_FILE" ]]; then
-  echo '{"type": "error", "message": "Sprint file not found"}'
-  exit 1
-fi
-
-# Handle "next" argument - find highest priority available story
-if [[ "$ID" == "next" ]]; then
-  # Get all available stories (backlog or ready), sort by priority, take first
-  NEXT_STORY=$(yq -o json "[.epics[].stories[] | select(.status == \"backlog\" or .status == \"ready\" or .status == null)] | sort_by(.priority) | .[0]" "$SPRINT_FILE" 2>/dev/null || echo "null")
-
-  if [[ "$NEXT_STORY" != "null" && -n "$NEXT_STORY" ]]; then
-    STORY_ID=$(echo "$NEXT_STORY" | yq -r '.id')
-    STORY_TITLE=$(echo "$NEXT_STORY" | yq -r '.title')
-    STORY_POINTS=$(echo "$NEXT_STORY" | yq -r '.points // 0')
-    STORY_PRIORITY=$(echo "$NEXT_STORY" | yq -r '.priority // "P2"')
-    STORY_WORKFLOW=$(echo "$NEXT_STORY" | yq -r '.workflow // "tdd"')
-    STORY_REPOS=$(echo "$NEXT_STORY" | yq -r '.repos // "pennyfarthing"')
-    STORY_AC=$(echo "$NEXT_STORY" | yq -o json '.acceptance_criteria // []')
-    EPIC_ID=$(yq -r ".epics[] | select(.stories[].id == \"$STORY_ID\") | .id" "$SPRINT_FILE" 2>/dev/null | head -1)
-
-    cat <<EOF
-{
-  "type": "next",
-  "story": {
-    "id": "$STORY_ID",
-    "title": "$STORY_TITLE",
-    "points": $STORY_POINTS,
-    "priority": "$STORY_PRIORITY",
-    "workflow": "$STORY_WORKFLOW",
-    "repos": "$STORY_REPOS",
-    "epic_id": "$EPIC_ID",
-    "acceptance_criteria": $STORY_AC
-  }
-}
-EOF
-  else
-    echo '{"type": "next", "story": null, "message": "No available stories in backlog"}'
-  fi
-  exit 0
-fi
-
-# Check if it's an epic
-EPIC_DATA=$(yq -o json ".epics[] | select(.id == \"$ID\")" "$SPRINT_FILE" 2>/dev/null || echo "")
-
-if [[ -n "$EPIC_DATA" && "$EPIC_DATA" != "null" ]]; then
-  # It's an epic - get first available story by priority
-  FIRST_STORY=$(yq -o json "[.epics[] | select(.id == \"$ID\") | .stories[] | select(.status == \"backlog\" or .status == \"ready\" or .status == null)] | sort_by(.priority) | .[0]" "$SPRINT_FILE" 2>/dev/null || echo "null")
-
-  EPIC_TITLE=$(echo "$EPIC_DATA" | yq -r '.title // "Unknown"')
-  STORY_COUNT=$(yq "[.epics[] | select(.id == \"$ID\") | .stories[] | select(.status == \"backlog\" or .status == \"ready\" or .status == null)] | length" "$SPRINT_FILE" 2>/dev/null || echo "0")
-
-  if [[ "$FIRST_STORY" != "null" && -n "$FIRST_STORY" ]]; then
-    STORY_ID=$(echo "$FIRST_STORY" | yq -r '.id')
-    STORY_TITLE=$(echo "$FIRST_STORY" | yq -r '.title')
-    STORY_POINTS=$(echo "$FIRST_STORY" | yq -r '.points // 0')
-    STORY_WORKFLOW=$(echo "$FIRST_STORY" | yq -r '.workflow // "tdd"')
-    STORY_REPOS=$(echo "$FIRST_STORY" | yq -r '.repos // "pennyfarthing"')
-    STORY_AC=$(echo "$FIRST_STORY" | yq -o json '.acceptance_criteria // []')
-
-    cat <<EOF
-{
-  "type": "epic",
-  "id": "$ID",
-  "title": "$EPIC_TITLE",
-  "available_stories": $STORY_COUNT,
-  "first_story": {
-    "id": "$STORY_ID",
-    "title": "$STORY_TITLE",
-    "points": $STORY_POINTS,
-    "workflow": "$STORY_WORKFLOW",
-    "repos": "$STORY_REPOS",
-    "acceptance_criteria": $STORY_AC
-  }
-}
-EOF
-  else
-    cat <<EOF
-{
-  "type": "epic",
-  "id": "$ID",
-  "title": "$EPIC_TITLE",
-  "available_stories": 0,
-  "first_story": null,
-  "message": "No available stories in this epic"
-}
-EOF
-  fi
-  exit 0
-fi
-
-# Check if it's a story
-STORY_DATA=$(yq -o json ".epics[].stories[] | select(.id == \"$ID\")" "$SPRINT_FILE" 2>/dev/null || echo "")
-
-if [[ -n "$STORY_DATA" && "$STORY_DATA" != "null" ]]; then
-  STATUS=$(echo "$STORY_DATA" | yq -r '.status // "backlog"')
-  ASSIGNED=$(echo "$STORY_DATA" | yq -r '.assigned_to // ""')
-  TITLE=$(echo "$STORY_DATA" | yq -r '.title // "Unknown"')
-  POINTS=$(echo "$STORY_DATA" | yq -r '.points // 0')
-  WORKFLOW=$(echo "$STORY_DATA" | yq -r '.workflow // "tdd"')
-  EPIC_ID=$(yq -r ".epics[] | select(.stories[].id == \"$ID\") | .id" "$SPRINT_FILE" 2>/dev/null | head -1)
-  REPOS=$(echo "$STORY_DATA" | yq -r '.repos // "pennyfarthing"')
-
-  # Story is available if status is backlog/ready and not assigned
-  if [[ ("$STATUS" == "backlog" || "$STATUS" == "ready") && -z "$ASSIGNED" ]]; then
-    AVAILABLE="true"
-  else
-    AVAILABLE="false"
-  fi
-
-  # Get acceptance criteria as JSON array
-  AC=$(echo "$STORY_DATA" | yq -o json '.acceptance_criteria // []')
-
-  cat <<EOF
-{
-  "type": "story",
-  "id": "$ID",
-  "title": "$TITLE",
-  "points": $POINTS,
-  "workflow": "$WORKFLOW",
-  "status": "$STATUS",
-  "assigned_to": "$ASSIGNED",
-  "epic_id": "$EPIC_ID",
-  "repos": "$REPOS",
-  "available": $AVAILABLE,
-  "acceptance_criteria": $AC
-}
-EOF
-  exit 0
-fi
-
-# Not found
-echo '{"type": "not_found", "id": "'"$ID"'", "message": "Story or epic not found in current sprint"}'
-exit 0

package/pennyfarthing-dist/scripts/sprint/get-epic-field.sh

@@ -1,58 +0,0 @@
-#!/bin/bash
-# Get a field value from an epic in sprint YAML
-# Usage: .pennyfarthing/scripts/core/run.sh sprint/get-epic-field.sh <epic-id> <field>
-#
-# Examples:
-#   .pennyfarthing/scripts/core/run.sh sprint/get-epic-field.sh epic-35 jira
-#   .pennyfarthing/scripts/core/run.sh sprint/get-epic-field.sh epic-35 title
-#   .pennyfarthing/scripts/core/run.sh sprint/get-epic-field.sh 35 jira  # Also works without 'epic-' prefix
-#
-# Common fields: jira, title, description, status
-# Returns the field value or "null" if not found
-
-set -euo pipefail
-
-EPIC_ID="${1:-}"
-FIELD="${2:-}"
-
-if [[ -z "$EPIC_ID" || -z "$FIELD" ]]; then
-  echo "Usage: get-epic-field.sh <epic-id> <field>"
-  echo ""
-  echo "Examples:"
-  echo "  get-epic-field.sh epic-35 jira     # Returns: MSSCI-11234"
-  echo "  get-epic-field.sh epic-35 title    # Returns: Epic title"
-  echo "  get-epic-field.sh 35 jira          # Also works without 'epic-' prefix"
-  echo ""
-  echo "Common fields: jira, title, description, status"
-  exit 1
-fi
-
-# Normalize epic ID - add 'epic-' prefix if not present
-if [[ ! "$EPIC_ID" =~ ^epic- ]]; then
-  EPIC_ID="epic-$EPIC_ID"
-fi
-
-# PROJECT_ROOT should be set by run.sh
-if [[ -z "${PROJECT_ROOT:-}" ]]; then
-  d="$PWD"
-  while [[ ! -d "$d/.pennyfarthing" ]] && [[ "$d" != "/" ]]; do
-    d="$(dirname "$d")"
-  done
-  PROJECT_ROOT="$d"
-fi
-
-SPRINT_FILE="$PROJECT_ROOT/sprint/current-sprint.yaml"
-
-if [[ ! -f "$SPRINT_FILE" ]]; then
-  echo "null"
-  exit 1
-fi
-
-# Extract field value using yq
-VALUE=$(yq eval ".epics[] | select(.id == \"$EPIC_ID\") | .$FIELD // \"null\"" "$SPRINT_FILE" 2>/dev/null | head -1)
-
-if [[ -z "$VALUE" ]]; then
-  echo "null"
-else
-  echo "$VALUE"
-fi

package/pennyfarthing-dist/scripts/sprint/get-story-field.sh

@@ -1,69 +0,0 @@
-#!/bin/bash
-# Get a field value from a story in sprint YAML
-# Usage: .pennyfarthing/scripts/core/run.sh sprint/get-story-field.sh <story-id> <field>
-#
-# Examples:
-#   .pennyfarthing/scripts/core/run.sh sprint/get-story-field.sh 35-2 workflow
-#   .pennyfarthing/scripts/core/run.sh sprint/get-story-field.sh 35-2 jira
-#   .pennyfarthing/scripts/core/run.sh sprint/get-story-field.sh 35-2 status
-#
-# Common fields: workflow, status, jira, points, title, repos, priority
-# Returns the field value or "null" if not found
-
-set -euo pipefail
-
-STORY_ID="${1:-}"
-FIELD="${2:-}"
-
-if [[ -z "$STORY_ID" || -z "$FIELD" ]]; then
-  echo "Usage: get-story-field.sh <story-id> <field>"
-  echo ""
-  echo "Examples:"
-  echo "  get-story-field.sh 35-2 workflow    # Returns: tdd"
-  echo "  get-story-field.sh 35-2 jira        # Returns: MSSCI-12345"
-  echo "  get-story-field.sh 35-2 status      # Returns: in_progress"
-  echo ""
-  echo "Common fields: workflow, status, jira, points, title, repos, priority"
-  exit 1
-fi
-
-# PROJECT_ROOT should be set by run.sh
-if [[ -z "${PROJECT_ROOT:-}" ]]; then
-  d="$PWD"
-  while [[ ! -d "$d/.pennyfarthing" ]] && [[ "$d" != "/" ]]; do
-    d="$(dirname "$d")"
-  done
-  PROJECT_ROOT="$d"
-fi
-
-SPRINT_FILE="$PROJECT_ROOT/sprint/current-sprint.yaml"
-
-if [[ ! -f "$SPRINT_FILE" ]]; then
-  echo "null"
-  exit 1
-fi
-
-# Extract field value using yq
-# Handle default values for common fields
-case "$FIELD" in
-  workflow)
-    DEFAULT="tdd"
-    ;;
-  status)
-    DEFAULT="backlog"
-    ;;
-  repos)
-    DEFAULT="pennyfarthing"
-    ;;
-  *)
-    DEFAULT="null"
-    ;;
-esac
-
-VALUE=$(yq eval ".epics[].stories[] | select(.id == \"$STORY_ID\") | .$FIELD // \"$DEFAULT\"" "$SPRINT_FILE" 2>/dev/null | head -1)
-
-if [[ -z "$VALUE" ]]; then
-  echo "null"
-else
-  echo "$VALUE"
-fi

package/pennyfarthing-dist/scripts/sprint/import-epic-to-future.sh

@@ -1,10 +0,0 @@
-#!/usr/bin/env bash
-# import-epic-to-future.sh - Import epics-and-stories workflow output to future.yaml
-#
-# Usage: ./scripts/sprint/import-epic-to-future.sh [--dry-run] <epics-md-file> [initiative-name]
-
-set -euo pipefail
-
-SCRIPT_DIR="$(cd "$(dirname "${BASH_SOURCE[0]}")" && pwd)"
-
-exec python3 "$SCRIPT_DIR/import_epic_to_future.py" "$@"

package/pennyfarthing-dist/scripts/sprint/import_epic_to_future.py

@@ -1,270 +0,0 @@
-#!/usr/bin/env python3
-"""
-import_epic_to_future.py - Import epics-and-stories workflow output to future.yaml
-
-Transforms the markdown output from the epics-and-stories workflow into
-the YAML format used by sprint/future.yaml.
-
-Usage: python import_epic_to_future.py [--dry-run] <epics-md-file> [initiative-name]
-
-Example:
-  python import_epic_to_future.py docs/planning/reflector-epics-and-stories.md "Reflector Consolidation"
-"""
-
-import argparse
-import re
-import sys
-from datetime import date
-from pathlib import Path
-
-
-class Colors:
-    RED = '\033[31m'
-    GREEN = '\033[32m'
-    YELLOW = '\033[33m'
-    BLUE = '\033[34m'
-    NC = '\033[0m'
-
-
-def log_info(msg: str) -> None:
-    print(f"{Colors.BLUE}INFO{Colors.NC}: {msg}")
-
-
-def log_success(msg: str) -> None:
-    print(f"{Colors.GREEN}SUCCESS{Colors.NC}: {msg}")
-
-
-def log_error(msg: str) -> None:
-    print(f"{Colors.RED}ERROR{Colors.NC}: {msg}", file=sys.stderr)
-
-
-def find_project_root() -> Path:
-    """Find project root by looking for .pennyfarthing directory."""
-    current = Path.cwd()
-    while current != current.parent:
-        if (current / ".pennyfarthing").is_dir():
-            return current
-        current = current.parent
-    return Path.cwd()
-
-
-def parse_epics_markdown(content: str) -> dict:
-    """Parse epics markdown file."""
-    result = {
-        'title': '',
-        'description': '',
-        'total_points': 0,
-        'epic_title': '',
-        'epic_description': '',
-        'stories': [],
-    }
-
-    # Extract title from first # heading
-    title_match = re.search(r'^# (.+?)( - Epic Breakdown)?$', content, re.MULTILINE)
-    if title_match:
-        result['title'] = title_match.group(1).replace(' - Epics and Stories', '')
-
-    # Extract description from Overview section
-    overview_match = re.search(r'## Overview\s*\n\s*\n(.+?)(?=\n\n##|\n##)', content, re.DOTALL)
-    if overview_match:
-        result['description'] = overview_match.group(1).strip()
-
-    # Extract total points
-    points_match = re.search(r'\*\*Points:\*\*\s*(\d+)', content)
-    if points_match:
-        result['total_points'] = int(points_match.group(1))
-    else:
-        effort_match = re.search(r'Total Effort.*?(\d+)\s*story points', content, re.IGNORECASE)
-        if effort_match:
-            result['total_points'] = int(effort_match.group(1))
-
-    # Extract epic title
-    epic_title_match = re.search(r'^## Epic \d+:\s*(.+)$', content, re.MULTILINE)
-    if epic_title_match:
-        result['epic_title'] = epic_title_match.group(1)
-
-    # Extract epic description (User Outcome)
-    user_outcome_match = re.search(r'\*\*User Outcome:\*\*\s*(.+)', content)
-    if user_outcome_match:
-        result['epic_description'] = user_outcome_match.group(1)
-
-    # Parse stories
-    story_pattern = re.compile(r'^### Story \d+\.(\d+):\s*(.+)$', re.MULTILINE)
-    i_want_pattern = re.compile(r'^I want \*\*(.+?)\*\*,', re.MULTILINE)
-
-    story_positions = []
-    for match in story_pattern.finditer(content):
-        story_positions.append({
-            'num': int(match.group(1)),
-            'title': match.group(2),
-            'index': match.start(),
-        })
-
-    for i, story in enumerate(story_positions):
-        start_index = story['index']
-        end_index = story_positions[i + 1]['index'] if i < len(story_positions) - 1 else len(content)
-        story_content = content[start_index:end_index]
-
-        i_want_match = i_want_pattern.search(story_content)
-        description = i_want_match.group(1) if i_want_match else ''
-
-        result['stories'].append({
-            'num': story['num'],
-            'title': story['title'],
-            'description': description,
-        })
-
-    return result
-
-
-def get_next_epic_number(future_yaml_path: Path) -> int:
-    """Get next epic number from future.yaml."""
-    if not future_yaml_path.exists():
-        return 60
-
-    content = future_yaml_path.read_text()
-
-    # Look for "Next Available Epic Number: XX"
-    next_match = re.search(r'Next Available Epic Number:\s*(\d+)', content, re.IGNORECASE)
-    if next_match:
-        return int(next_match.group(1))
-
-    # Fallback: find highest epic-XX number
-    max_num = 59
-    for match in re.finditer(r'epic-(\d+)', content):
-        num = int(match.group(1))
-        if num > max_num:
-            max_num = num
-
-    return max_num + 1
-
-
-def generate_yaml(parsed: dict, epic_num: int, initiative_name: str, epics_file: str) -> str:
-    """Generate YAML for initiative."""
-    today = date.today().isoformat()
-
-    yaml = f"""
-    # ==========================================================================
-    # {initiative_name}
-    # Imported from: {epics_file}
-    # Date: {today}
-    # ==========================================================================
-    - name: "{initiative_name}"
-      description: |
-        {parsed['description']}
-      status: ready
-      blocked_by: null
-      total_points: {parsed['total_points']}
-      prd: docs/planning/reflector-prd.md
-      epics_doc: {epics_file}
-      epics:
-        - id: epic-{epic_num}
-          title: "{parsed['epic_title'] or initiative_name}"
-          description: |
-            {parsed['epic_description'] or parsed['description']}
-          points: {parsed['total_points']}
-          priority: P1
-          marker: "reflector"
-          repos: pennyfarthing
-          status: planning
-          stories:
-"""
-
-    for story in parsed['stories']:
-        yaml += f"""            - id: "{epic_num}-{story['num']}"
-              title: "{story['title']}"
-              description: |
-                {story['description'] or story['title']}
-              points: 1
-              priority: P0
-              status: planning
-              repos: pennyfarthing
-"""
-
-    return yaml
-
-
-def update_future_yaml(future_yaml_path: Path, new_content: str, next_epic_num: int) -> str:
-    """Update future.yaml."""
-    content = future_yaml_path.read_text()
-
-    # Update next epic number comment
-    content = re.sub(
-        r'Next Available Epic Number:\s*\d+',
-        f'Next Available Epic Number: {next_epic_num + 1}',
-        content,
-        flags=re.IGNORECASE
-    )
-
-    # Find insertion point (before SUMMARY section)
-    summary_marker = '# =============================================================================\n# SUMMARY'
-    summary_index = content.find(summary_marker)
-
-    if summary_index == -1:
-        content += new_content
-    else:
-        content = content[:summary_index] + new_content + '\n' + content[summary_index:]
-
-    return content
-
-
-def main() -> int:
-    parser = argparse.ArgumentParser(
-        description="Import epics-and-stories workflow output to future.yaml"
-    )
-    parser.add_argument('--dry-run', action='store_true',
-                        help='Print YAML to stdout instead of updating future.yaml')
-    parser.add_argument('epics_file', type=str,
-                        help='Path to the markdown file from epics-and-stories workflow')
-    parser.add_argument('initiative_name', type=str, nargs='?', default='',
-                        help='Name for the initiative (optional, extracted from file if not provided)')
-    args = parser.parse_args()
-
-    project_root = find_project_root()
-
-    epics_path = Path(args.epics_file)
-    if not epics_path.is_absolute():
-        epics_path = project_root / epics_path
-
-    if not epics_path.exists():
-        log_error(f"File not found: {epics_path}")
-        return 1
-
-    future_yaml_path = project_root / 'sprint' / 'future.yaml'
-
-    # Read and parse epics file
-    content = epics_path.read_text()
-    parsed = parse_epics_markdown(content)
-
-    # Use provided name or extract from file
-    initiative_name = args.initiative_name or parsed['title'] or 'Imported Initiative'
-
-    # Get next epic number
-    next_epic_num = get_next_epic_number(future_yaml_path)
-
-    log_info(f"Next epic number: {next_epic_num}")
-    log_info(f"Initiative name: {initiative_name}")
-    log_info(f"Total points: {parsed['total_points']}")
-    log_info(f"Epic title: {parsed['epic_title']}")
-    log_info(f"Stories found: {len(parsed['stories'])}")
-
-    # Generate YAML
-    new_yaml = generate_yaml(parsed, next_epic_num, initiative_name, args.epics_file)
-
-    if args.dry_run:
-        print(f"\n{Colors.YELLOW}=== DRY RUN: Would append to future.yaml ==={Colors.NC}")
-        print(new_yaml)
-        print(f"{Colors.YELLOW}=== End of YAML ==={Colors.NC}\n")
-        print(f"{Colors.GREEN}To apply, run without --dry-run{Colors.NC}")
-    else:
-        updated_content = update_future_yaml(future_yaml_path, new_yaml, next_epic_num)
-        future_yaml_path.write_text(updated_content)
-
-        log_success(f"Added epic-{next_epic_num} to {future_yaml_path}")
-        log_success(f"Next available epic number is now: {next_epic_num + 1}")
-
-    return 0
-
-
-if __name__ == "__main__":
-    sys.exit(main())