tapps-agents 3.5.40__py3-none-any.whl → 3.6.0__py3-none-any.whl

tapps_agents/epic/beads_sync.py

@@ -1,115 +1,115 @@
-"""
-Sync an Epic to Beads (bd): create one bd issue per story and bd dep add from Story.dependencies.
-
-On run_bd failure we log, return the partial story_id->bd_id mapping, and do not re-raise
-so the Epic run can continue.
-"""
-
-import logging
-from collections.abc import Callable
-from pathlib import Path
-from typing import Any
-
-from ..beads import parse_bd_id_from_stdout
-from .models import EpicDocument, Story
-
-logger = logging.getLogger(__name__)
-
-
-def sync_epic_to_beads(
-    epic: EpicDocument,
-    project_root: Path,
-    run_bd: Callable[[list[str], Path | None], Any],
-    *,
-    create_parent: bool = True,
-) -> tuple[dict[str, str], str | None]:
-    """
-    Create a bd issue for each story and bd dep add for each dependency.
-
-    Optionally create a parent Epic issue (for grouping only; no story->parent deps).
-
-    run_bd(args, cwd) runs bd and returns a CompletedProcess-like object with
-    .returncode, .stdout, .stderr. It is typically beads.client.run_bd partially
-    applied with project_root.
-
-    On any run_bd failure we log, return the partial story_id->bd_id mapping,
-    and do not re-raise.
-
-    Args:
-        epic: Parsed Epic document.
-        project_root: Project root (used as cwd when run_bd does not override).
-        run_bd: (args, cwd=None) -> result with .returncode, .stdout, .stderr.
-        create_parent: If True, create a parent bd issue for the Epic (grouping only).
-
-    Returns:
-        (story_id -> bd_id mapping, epic_parent_id or None).
-    """
-    story_to_bd: dict[str, str] = {}
-    epic_parent_id: str | None = None
-    cwd = project_root
-
-    # Optional: create parent Epic issue (grouping only; no story->parent deps)
-    if create_parent:
-        title = f"Epic {epic.epic_number}: {epic.title}"[:200].strip()
-        desc = (epic.description or epic.goal or "")[:500].replace("\n", " ").strip()
-        args = ["create", title]
-        if desc:
-            args.extend(["-d", desc])
-        try:
-            r = run_bd(args, cwd)
-            if r.returncode == 0:
-                epic_parent_id = parse_bd_id_from_stdout(r.stdout)
-            else:
-                logger.warning("beads_sync: bd create parent failed: %s", r.stderr)
-        except Exception as e:
-            logger.warning("beads_sync: bd create parent failed: %s", e)
-
-    # Create one bd issue per story
-    for story in epic.stories:
-        title = (story.title or f"Story {story.story_id}")[:200].strip()
-        desc = (story.description or "")[:500].replace("\n", " ").strip()
-        args = ["create", title]
-        if desc:
-            args.extend(["-d", desc])
-        try:
-            r = run_bd(args, cwd)
-            if r.returncode != 0:
-                logger.warning(
-                    "beads_sync: bd create failed for %s: %s", story.story_id, r.stderr
-                )
-                continue
-            bd_id = parse_bd_id_from_stdout(r.stdout)
-            if bd_id:
-                story_to_bd[story.story_id] = bd_id
-            else:
-                logger.warning(
-                    "beads_sync: could not parse bd id from create stdout for %s",
-                    story.story_id,
-                )
-        except Exception as e:
-            logger.warning("beads_sync: bd create failed for %s: %s", story.story_id, e)
-
-    # bd dep add child parent  => parent blocks child (child depends on parent)
-    for story in epic.stories:
-        s_bd = story_to_bd.get(story.story_id)
-        if not s_bd or not story.dependencies:
-            continue
-        for dep_id in story.dependencies:
-            dep_bd = story_to_bd.get(dep_id)
-            if not dep_bd:
-                continue
-            try:
-                r = run_bd(["dep", "add", s_bd, dep_bd], cwd)
-                if r.returncode != 0:
-                    logger.warning(
-                        "beads_sync: bd dep add %s %s failed: %s",
-                        s_bd,
-                        dep_bd,
-                        r.stderr,
-                    )
-            except Exception as e:
-                logger.warning(
-                    "beads_sync: bd dep add %s %s failed: %s", s_bd, dep_bd, e
-                )
-
-    return (story_to_bd, epic_parent_id)
+"""
+Sync an Epic to Beads (bd): create one bd issue per story and bd dep add from Story.dependencies.
+
+On run_bd failure we log, return the partial story_id->bd_id mapping, and do not re-raise
+so the Epic run can continue.
+"""
+
+import logging
+from collections.abc import Callable
+from pathlib import Path
+from typing import Any
+
+from ..beads import parse_bd_id_from_stdout
+from .models import EpicDocument, Story
+
+logger = logging.getLogger(__name__)
+
+
+def sync_epic_to_beads(
+    epic: EpicDocument,
+    project_root: Path,
+    run_bd: Callable[[list[str], Path | None], Any],
+    *,
+    create_parent: bool = True,
+) -> tuple[dict[str, str], str | None]:
+    """
+    Create a bd issue for each story and bd dep add for each dependency.
+
+    Optionally create a parent Epic issue (for grouping only; no story->parent deps).
+
+    run_bd(args, cwd) runs bd and returns a CompletedProcess-like object with
+    .returncode, .stdout, .stderr. It is typically beads.client.run_bd partially
+    applied with project_root.
+
+    On any run_bd failure we log, return the partial story_id->bd_id mapping,
+    and do not re-raise.
+
+    Args:
+        epic: Parsed Epic document.
+        project_root: Project root (used as cwd when run_bd does not override).
+        run_bd: (args, cwd=None) -> result with .returncode, .stdout, .stderr.
+        create_parent: If True, create a parent bd issue for the Epic (grouping only).
+
+    Returns:
+        (story_id -> bd_id mapping, epic_parent_id or None).
+    """
+    story_to_bd: dict[str, str] = {}
+    epic_parent_id: str | None = None
+    cwd = project_root
+
+    # Optional: create parent Epic issue (grouping only; no story->parent deps)
+    if create_parent:
+        title = f"Epic {epic.epic_number}: {epic.title}"[:200].strip()
+        desc = (epic.description or epic.goal or "")[:500].replace("\n", " ").strip()
+        args = ["create", title]
+        if desc:
+            args.extend(["-d", desc])
+        try:
+            r = run_bd(args, cwd)
+            if r.returncode == 0:
+                epic_parent_id = parse_bd_id_from_stdout(r.stdout)
+            else:
+                logger.warning("beads_sync: bd create parent failed: %s", r.stderr)
+        except Exception as e:
+            logger.warning("beads_sync: bd create parent failed: %s", e)
+
+    # Create one bd issue per story
+    for story in epic.stories:
+        title = (story.title or f"Story {story.story_id}")[:200].strip()
+        desc = (story.description or "")[:500].replace("\n", " ").strip()
+        args = ["create", title]
+        if desc:
+            args.extend(["-d", desc])
+        try:
+            r = run_bd(args, cwd)
+            if r.returncode != 0:
+                logger.warning(
+                    "beads_sync: bd create failed for %s: %s", story.story_id, r.stderr
+                )
+                continue
+            bd_id = parse_bd_id_from_stdout(r.stdout)
+            if bd_id:
+                story_to_bd[story.story_id] = bd_id
+            else:
+                logger.warning(
+                    "beads_sync: could not parse bd id from create stdout for %s",
+                    story.story_id,
+                )
+        except Exception as e:
+            logger.warning("beads_sync: bd create failed for %s: %s", story.story_id, e)
+
+    # bd dep add child parent  => parent blocks child (child depends on parent)
+    for story in epic.stories:
+        s_bd = story_to_bd.get(story.story_id)
+        if not s_bd or not story.dependencies:
+            continue
+        for dep_id in story.dependencies:
+            dep_bd = story_to_bd.get(dep_id)
+            if not dep_bd:
+                continue
+            try:
+                r = run_bd(["dep", "add", s_bd, dep_bd], cwd)
+                if r.returncode != 0:
+                    logger.warning(
+                        "beads_sync: bd dep add %s %s failed: %s",
+                        s_bd,
+                        dep_bd,
+                        r.stderr,
+                    )
+            except Exception as e:
+                logger.warning(
+                    "beads_sync: bd dep add %s %s failed: %s", s_bd, dep_bd, e
+                )
+
+    return (story_to_bd, epic_parent_id)

tapps_agents/epic/markdown_sync.py

@@ -1,105 +1,105 @@
-"""
-Sync epic execution status from report JSON back into the epic markdown file.
-
-Updates each story block with **Execution status:** done | failed so the .md
-reflects the last run. Run after epic execution or when you have a report file.
-"""
-
-import json
-import re
-from pathlib import Path
-
-
-def update_epic_markdown_from_report(
-    epic_path: Path | str,
-    report_path: Path | None = None,
-    project_root: Path | None = None,
-) -> None:
-    """
-    Update the epic markdown file with execution status from the report JSON.
-
-    For each story in the report, adds or replaces a line
-    "**Execution status:** done" or "**Execution status:** failed"
-    in the corresponding story block.
-
-    Args:
-        epic_path: Path to the epic .md file.
-        report_path: Path to epic-N-report.json. If None, uses same directory
-            as epic_path and filename epic-{N}-report.json (N from epic content).
-        project_root: Project root for resolving relative epic_path. Defaults to cwd.
-
-    Raises:
-        FileNotFoundError: If epic or report file is missing.
-        ValueError: If report format is invalid or epic number cannot be determined.
-    """
-    root = Path(project_root or Path.cwd())
-    epic_path = Path(epic_path)
-    if not epic_path.is_absolute():
-        for base in [root, root / "stories", root / "docs" / "prd"]:
-            candidate = base / epic_path.name if epic_path.parent.name else base / epic_path
-            if candidate.exists():
-                epic_path = candidate
-                break
-        else:
-            epic_path = root / epic_path
-
-    if not epic_path.exists():
-        raise FileNotFoundError(f"Epic file not found: {epic_path}")
-
-    content = epic_path.read_text(encoding="utf-8")
-
-    # Determine epic number from content
-    epic_num_match = re.search(r"^#\s+Epic\s+(\d+):", content, re.MULTILINE)
-    if not epic_num_match:
-        epic_num_match = re.search(r"epic-(\d+)", epic_path.name, re.IGNORECASE)
-    if not epic_num_match:
-        raise ValueError(f"Could not determine epic number from {epic_path}")
-    epic_number = int(epic_num_match.group(1))
-
-    if report_path is None:
-        report_path = epic_path.parent / f"epic-{epic_number}-report.json"
-    else:
-        report_path = Path(report_path)
-    if not report_path.is_absolute():
-        report_path = root / report_path
-
-    if not report_path.exists():
-        raise FileNotFoundError(f"Report file not found: {report_path}")
-
-    report = json.loads(report_path.read_text(encoding="utf-8"))
-    stories = report.get("stories") or []
-    if not stories:
-        return
-
-    # Build map story_id -> status (done | failed | in_progress)
-    status_by_id: dict[str, str] = {}
-    for s in stories:
-        sid = s.get("story_id")
-        if sid:
-            status_by_id[sid] = (s.get("status") or "unknown").lower()
-
-    # For each story id, find the story block and add/replace **Execution status:**
-    def replace_or_add_status(match: re.Match[str]) -> str:
-        story_id = match.group(2)  # e.g. "2.1"
-        title_line = match.group(1)
-        rest = match.group(3)
-        status = status_by_id.get(story_id, "not run")
-        status_line = f"   **Execution status:** {status}\n"
-        existing = re.search(r"^(\s*\*\*Execution status:\*\*\s*)[^\n]*\n", rest, re.MULTILINE)
-        if existing:
-            rest = rest[: existing.start()] + status_line.strip() + "\n" + rest[existing.end() :]
-        else:
-            rest = status_line + rest
-        return title_line + rest
-
-    pattern = re.compile(
-        r"^(\d+\.\s*\*\*Story\s+(\d+\.\d+):[^*]*\*\*[^\n]*\n)(.*?)(?=^\d+\.\s*\*\*Story\s|\Z)",
-        re.MULTILINE | re.DOTALL,
-    )
-    new_content = pattern.sub(
-        lambda m: replace_or_add_status(m) if m.group(2) in status_by_id else m.group(0),
-        content,
-    )
-
-    if new_content != content:
-        epic_path.write_text(new_content, encoding="utf-8")
+"""
+Sync epic execution status from report JSON back into the epic markdown file.
+
+Updates each story block with **Execution status:** done | failed so the .md
+reflects the last run. Run after epic execution or when you have a report file.
+"""
+
+import json
+import re
+from pathlib import Path
+
+
+def update_epic_markdown_from_report(
+    epic_path: Path | str,
+    report_path: Path | None = None,
+    project_root: Path | None = None,
+) -> None:
+    """
+    Update the epic markdown file with execution status from the report JSON.
+
+    For each story in the report, adds or replaces a line
+    "**Execution status:** done" or "**Execution status:** failed"
+    in the corresponding story block.
+
+    Args:
+        epic_path: Path to the epic .md file.
+        report_path: Path to epic-N-report.json. If None, uses same directory
+            as epic_path and filename epic-{N}-report.json (N from epic content).
+        project_root: Project root for resolving relative epic_path. Defaults to cwd.
+
+    Raises:
+        FileNotFoundError: If epic or report file is missing.
+        ValueError: If report format is invalid or epic number cannot be determined.
+    """
+    root = Path(project_root or Path.cwd())
+    epic_path = Path(epic_path)
+    if not epic_path.is_absolute():
+        for base in [root, root / "stories", root / "docs" / "prd"]:
+            candidate = base / epic_path.name if epic_path.parent.name else base / epic_path
+            if candidate.exists():
+                epic_path = candidate
+                break
+        else:
+            epic_path = root / epic_path
+
+    if not epic_path.exists():
+        raise FileNotFoundError(f"Epic file not found: {epic_path}")
+
+    content = epic_path.read_text(encoding="utf-8")
+
+    # Determine epic number from content
+    epic_num_match = re.search(r"^#\s+Epic\s+(\d+):", content, re.MULTILINE)
+    if not epic_num_match:
+        epic_num_match = re.search(r"epic-(\d+)", epic_path.name, re.IGNORECASE)
+    if not epic_num_match:
+        raise ValueError(f"Could not determine epic number from {epic_path}")
+    epic_number = int(epic_num_match.group(1))
+
+    if report_path is None:
+        report_path = epic_path.parent / f"epic-{epic_number}-report.json"
+    else:
+        report_path = Path(report_path)
+    if not report_path.is_absolute():
+        report_path = root / report_path
+
+    if not report_path.exists():
+        raise FileNotFoundError(f"Report file not found: {report_path}")
+
+    report = json.loads(report_path.read_text(encoding="utf-8"))
+    stories = report.get("stories") or []
+    if not stories:
+        return
+
+    # Build map story_id -> status (done | failed | in_progress)
+    status_by_id: dict[str, str] = {}
+    for s in stories:
+        sid = s.get("story_id")
+        if sid:
+            status_by_id[sid] = (s.get("status") or "unknown").lower()
+
+    # For each story id, find the story block and add/replace **Execution status:**
+    def replace_or_add_status(match: re.Match[str]) -> str:
+        story_id = match.group(2)  # e.g. "2.1"
+        title_line = match.group(1)
+        rest = match.group(3)
+        status = status_by_id.get(story_id, "not run")
+        status_line = f"   **Execution status:** {status}\n"
+        existing = re.search(r"^(\s*\*\*Execution status:\*\*\s*)[^\n]*\n", rest, re.MULTILINE)
+        if existing:
+            rest = rest[: existing.start()] + status_line.strip() + "\n" + rest[existing.end() :]
+        else:
+            rest = status_line + rest
+        return title_line + rest
+
+    pattern = re.compile(
+        r"^(\d+\.\s*\*\*Story\s+(\d+\.\d+):[^*]*\*\*[^\n]*\n)(.*?)(?=^\d+\.\s*\*\*Story\s|\Z)",
+        re.MULTILINE | re.DOTALL,
+    )
+    new_content = pattern.sub(
+        lambda m: replace_or_add_status(m) if m.group(2) in status_by_id else m.group(0),
+        content,
+    )
+
+    if new_content != content:
+        epic_path.write_text(new_content, encoding="utf-8")

tapps_agents/epic/models.py

@@ -1,96 +1,96 @@
-"""
-Data models for Epic parsing and orchestration.
-
-Migrated to Pydantic BaseModel for runtime validation and type safety.
-"""
-
-from __future__ import annotations
-
-from enum import Enum
-from pathlib import Path
-from typing import Any
-
-from pydantic import BaseModel, Field
-
-from ..workflow.common_enums import Priority, StoryStatus
-
-
-class AcceptanceCriterion(BaseModel):
-    """Acceptance criterion for a story."""
-
-    description: str
-    verified: bool = False
-
-    model_config = {"extra": "forbid"}
-
-
-class Story(BaseModel):
-    """Represents a single story within an Epic."""
-
-    epic_number: int
-    story_number: int
-    title: str
-    description: str
-    acceptance_criteria: list[AcceptanceCriterion] = Field(default_factory=list)
-    dependencies: list[str] = Field(default_factory=list)  # Story IDs like "8.1", "8.2"
-    story_points: int | None = Field(default=None, ge=1)
-    status: StoryStatus = StoryStatus.NOT_STARTED
-    file_path: Path | None = None  # Path to story file if exists
-
-    model_config = {"extra": "forbid"}
-
-    @property
-    def story_id(self) -> str:
-        """Get story ID in format X.Y."""
-        return f"{self.epic_number}.{self.story_number}"
-
-    @property
-    def full_id(self) -> str:
-        """Get full story ID with prefix."""
-        return f"Story {self.story_id}"
-
-    def depends_on(self, other_story_id: str) -> bool:
-        """Check if this story depends on another story."""
-        return other_story_id in self.dependencies
-
-
-class EpicDocument(BaseModel):
-    """Represents a parsed Epic document."""
-
-    epic_number: int
-    title: str
-    goal: str
-    description: str
-    stories: list[Story] = Field(default_factory=list)
-    priority: Priority | None = None
-    timeline: str | None = None
-    prerequisites: list[str] = Field(default_factory=list)
-    execution_notes: dict[str, Any] = Field(default_factory=dict)
-    definition_of_done: list[str] = Field(default_factory=list)
-    status: str | None = None
-    file_path: Path | None = None
-
-    model_config = {"extra": "forbid"}
-
-    def get_story(self, story_id: str) -> Story | None:
-        """Get a story by its ID (e.g., '8.1')."""
-        for story in self.stories:
-            if story.story_id == story_id:
-                return story
-        return None
-
-    def get_stories_by_status(self, status: StoryStatus) -> list[Story]:
-        """Get all stories with a specific status."""
-        return [s for s in self.stories if s.status == status]
-
-    def is_complete(self) -> bool:
-        """Check if all stories are done."""
-        return all(s.status == StoryStatus.DONE for s in self.stories)
-
-    def completion_percentage(self) -> float:
-        """Calculate completion percentage."""
-        if not self.stories:
-            return 0.0
-        done_count = sum(1 for s in self.stories if s.status == StoryStatus.DONE)
-        return (done_count / len(self.stories)) * 100.0
-
+"""
+Data models for Epic parsing and orchestration.
+
+Migrated to Pydantic BaseModel for runtime validation and type safety.
+"""
+
+from __future__ import annotations
+
+from enum import Enum
+from pathlib import Path
+from typing import Any
+
+from pydantic import BaseModel, Field
+
+from ..workflow.common_enums import Priority, StoryStatus
+
+
+class AcceptanceCriterion(BaseModel):
+    """Acceptance criterion for a story."""
+
+    description: str
+    verified: bool = False
+
+    model_config = {"extra": "forbid"}
+
+
+class Story(BaseModel):
+    """Represents a single story within an Epic."""
+
+    epic_number: int
+    story_number: int
+    title: str
+    description: str
+    acceptance_criteria: list[AcceptanceCriterion] = Field(default_factory=list)
+    dependencies: list[str] = Field(default_factory=list)  # Story IDs like "8.1", "8.2"
+    story_points: int | None = Field(default=None, ge=1)
+    status: StoryStatus = StoryStatus.NOT_STARTED
+    file_path: Path | None = None  # Path to story file if exists
+
+    model_config = {"extra": "forbid"}
+
+    @property
+    def story_id(self) -> str:
+        """Get story ID in format X.Y."""
+        return f"{self.epic_number}.{self.story_number}"
+
+    @property
+    def full_id(self) -> str:
+        """Get full story ID with prefix."""
+        return f"Story {self.story_id}"
+
+    def depends_on(self, other_story_id: str) -> bool:
+        """Check if this story depends on another story."""
+        return other_story_id in self.dependencies
+
+
+class EpicDocument(BaseModel):
+    """Represents a parsed Epic document."""
+
+    epic_number: int
+    title: str
+    goal: str
+    description: str
+    stories: list[Story] = Field(default_factory=list)
+    priority: Priority | None = None
+    timeline: str | None = None
+    prerequisites: list[str] = Field(default_factory=list)
+    execution_notes: dict[str, Any] = Field(default_factory=dict)
+    definition_of_done: list[str] = Field(default_factory=list)
+    status: str | None = None
+    file_path: Path | None = None
+
+    model_config = {"extra": "forbid"}
+
+    def get_story(self, story_id: str) -> Story | None:
+        """Get a story by its ID (e.g., '8.1')."""
+        for story in self.stories:
+            if story.story_id == story_id:
+                return story
+        return None
+
+    def get_stories_by_status(self, status: StoryStatus) -> list[Story]:
+        """Get all stories with a specific status."""
+        return [s for s in self.stories if s.status == status]
+
+    def is_complete(self) -> bool:
+        """Check if all stories are done."""
+        return all(s.status == StoryStatus.DONE for s in self.stories)
+
+    def completion_percentage(self) -> float:
+        """Calculate completion percentage."""
+        if not self.stories:
+            return 0.0
+        done_count = sum(1 for s in self.stories if s.status == StoryStatus.DONE)
+        return (done_count / len(self.stories)) * 100.0
+