@pennyfarthing/core 7.9.3 → 8.0.0

package/pennyfarthing-dist/scripts/sprint/available-stories.sh

@@ -0,0 +1,97 @@
+#!/bin/bash
+# Display available stories grouped by epic with Jira context
+# Usage: .pennyfarthing/scripts/sprint/available-stories.sh
+#
+# Shows backlog stories with epic context, points, and workflow
+
+set -euo pipefail
+
+# PROJECT_ROOT should be set by find-root.sh, but find it if not
+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 "Error: Sprint file not found at $SPRINT_FILE"
+  exit 1
+fi
+
+if ! command -v yq &> /dev/null; then
+  echo "Error: yq is required but not installed"
+  echo "Install with: brew install yq"
+  exit 1
+fi
+
+if ! command -v jira &> /dev/null; then
+  echo "Error: jira CLI is required but not installed"
+  echo "Install with: brew install ankitpokhrel/jira/jira"
+  exit 1
+fi
+
+# Extract sprint info
+SPRINT_NAME=$(yq '.sprint.name' "$SPRINT_FILE")
+echo "# Available Stories - $SPRINT_NAME"
+echo ""
+
+# Get all epic IDs from the sprint file
+EPIC_IDS=$(yq '.epics[].id' "$SPRINT_FILE" | tr '\n' ' ')
+
+# Batch fetch epic details from Jira
+echo "Fetching epic details from Jira..."
+echo ""
+
+# Process each epic
+for EPIC_ID in $EPIC_IDS; do
+  # Get epic title from sprint YAML (faster than Jira for display)
+  EPIC_TITLE=$(yq ".epics[] | select(.id == \"$EPIC_ID\") | .title" "$SPRINT_FILE")
+
+  # Get stories for this epic that are available (backlog or ready)
+  STORY_COUNT=$(yq ".epics[] | select(.id == \"$EPIC_ID\") | .stories[] | select(.status == \"backlog\" or .status == \"ready\") | .id" "$SPRINT_FILE" 2>/dev/null | wc -l | tr -d ' ')
+
+  if [[ "$STORY_COUNT" -eq 0 ]]; then
+    continue
+  fi
+
+  # Fetch epic description from Jira for context (if it's a valid Jira key)
+  # Jira uses Atlassian Document Format - extract text content from paragraphs
+  EPIC_DESCRIPTION=""
+  if [[ "$EPIC_ID" =~ ^MSSCI-[0-9]+$ ]]; then
+    EPIC_DESCRIPTION=$(jira issue view "$EPIC_ID" --raw 2>/dev/null | \
+      jq -r '.fields.description.content[]? | select(.type == "paragraph") | .content[]? | select(.type == "text") | .text' 2>/dev/null | \
+      head -3 | tr '\n' ' ' | cut -c1-200)
+  fi
+
+  echo "## $EPIC_TITLE"
+  if [[ -n "$EPIC_DESCRIPTION" ]]; then
+    echo "*$EPIC_DESCRIPTION*"
+  fi
+  echo ""
+  echo "| ID | Title | Pts | Pri | Status | Workflow |"
+  echo "|----|-------|-----|-----|--------|----------|"
+
+  # Get available stories for this epic (backlog or ready)
+  yq -o=json ".epics[] | select(.id == \"$EPIC_ID\") | .stories[] | select(.status == \"backlog\" or .status == \"ready\")" "$SPRINT_FILE" 2>/dev/null | \
+    jq -r '[.id, .title, (.points | tostring), (.priority // "P2"), (.status // "backlog"), (.workflow // "tdd")] | @tsv' | \
+    while IFS=$'\t' read -r story_id story_title story_points story_priority story_status story_workflow; do
+      # Truncate title if too long
+      if [[ ${#story_title} -gt 40 ]]; then
+        story_title="${story_title:0:37}..."
+      fi
+      echo "| $story_id | $story_title | $story_points | $story_priority | $story_status | $story_workflow |"
+    done
+
+  echo ""
+done
+
+# Summary
+TOTAL_BACKLOG=$(yq '[.epics[].stories[] | select(.status == "backlog" or .status == "ready")] | length' "$SPRINT_FILE")
+TOTAL_POINTS=$(yq '.epics[].stories[] | select(.status == "backlog" or .status == "ready") | .points' "$SPRINT_FILE" | paste -sd+ - | bc 2>/dev/null || echo "0")
+
+echo "---"
+echo "**Total available:** $TOTAL_BACKLOG stories, $TOTAL_POINTS points"

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

@@ -0,0 +1,164 @@
+#!/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 find-root.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

@@ -0,0 +1,58 @@
+#!/bin/bash
+# Get a field value from an epic in sprint YAML
+# Usage: .pennyfarthing/scripts/sprint/get-epic-field.sh <epic-id> <field>
+#
+# Examples:
+#   .pennyfarthing/scripts/sprint/get-epic-field.sh epic-35 jira
+#   .pennyfarthing/scripts/sprint/get-epic-field.sh epic-35 title
+#   .pennyfarthing/scripts/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 find-root.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

@@ -0,0 +1,69 @@
+#!/bin/bash
+# Get a field value from a story in sprint YAML
+# Usage: .pennyfarthing/scripts/sprint/get-story-field.sh <story-id> <field>
+#
+# Examples:
+#   .pennyfarthing/scripts/sprint/get-story-field.sh 35-2 workflow
+#   .pennyfarthing/scripts/sprint/get-story-field.sh 35-2 jira
+#   .pennyfarthing/scripts/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 find-root.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

@@ -0,0 +1,10 @@
+#!/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

@@ -0,0 +1,270 @@
+#!/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())