monoco-toolkit 0.2.8__py3-none-any.whl → 0.3.0__py3-none-any.whl

monoco/features/issue/domain/lifecycle.py

@@ -1,12 +1,13 @@
-from typing import List, Optional, Callable
+from typing import List, Optional
 from pydantic import BaseModel
 from ..models import IssueStatus, IssueStage, IssueSolution, current_time
 from .models import Issue
 
+
 class Transition(BaseModel):
     name: str
-    from_status: Optional[IssueStatus] = None # None means any
-    from_stage: Optional[IssueStage] = None   # None means any
+    from_status: Optional[IssueStatus] = None  # None means any
+    from_stage: Optional[IssueStage] = None  # None means any
     to_status: IssueStatus
     to_stage: Optional[IssueStage] = None
     required_solution: Optional[IssueSolution] = None
@@ -19,6 +20,7 @@ class Transition(BaseModel):
             return False
         return True
 
+
 class TransitionService:
     def __init__(self):
         self.transitions: List[Transition] = [
@@ -28,15 +30,15 @@ class TransitionService:
                 from_status=IssueStatus.OPEN,
                 to_status=IssueStatus.BACKLOG,
                 to_stage=IssueStage.FREEZED,
-                description="Move open issue to backlog"
+                description="Move open issue to backlog",
             ),
             # Backlog -> Open
             Transition(
                 name="activate",
                 from_status=IssueStatus.BACKLOG,
                 to_status=IssueStatus.OPEN,
-                to_stage=IssueStage.DRAFT, # Reset to draft?
-                description="Restore issue from backlog"
+                to_stage=IssueStage.DRAFT,  # Reset to draft?
+                description="Restore issue from backlog",
             ),
             # Open (Draft) -> Open (Doing)
             Transition(
@@ -45,7 +47,7 @@ class TransitionService:
                 from_stage=IssueStage.DRAFT,
                 to_status=IssueStatus.OPEN,
                 to_stage=IssueStage.DOING,
-                description="Start working on the issue"
+                description="Start working on the issue",
             ),
             # Open (Doing) -> Open (Review)
             Transition(
@@ -54,16 +56,16 @@ class TransitionService:
                 from_stage=IssueStage.DOING,
                 to_status=IssueStatus.OPEN,
                 to_stage=IssueStage.REVIEW,
-                description="Submit for review"
+                description="Submit for review",
             ),
-             # Open (Review) -> Open (Doing) - reject
+            # Open (Review) -> Open (Doing) - reject
             Transition(
                 name="reject",
                 from_status=IssueStatus.OPEN,
                 from_stage=IssueStage.REVIEW,
                 to_status=IssueStatus.OPEN,
                 to_stage=IssueStage.DOING,
-                description="Reject review and return to doing"
+                description="Reject review and return to doing",
             ),
             # Open (Review) -> Closed (Implemented)
             Transition(
@@ -73,7 +75,7 @@ class TransitionService:
                 to_status=IssueStatus.CLOSED,
                 to_stage=IssueStage.DONE,
                 required_solution=IssueSolution.IMPLEMENTED,
-                description="Accept and close issue"
+                description="Accept and close issue",
             ),
             # Direct Close (Cancel, Wontfix, Duplicate)
             Transition(
@@ -81,14 +83,14 @@ class TransitionService:
                 to_status=IssueStatus.CLOSED,
                 to_stage=IssueStage.DONE,
                 required_solution=IssueSolution.CANCELLED,
-                description="Cancel the issue"
+                description="Cancel the issue",
             ),
-             Transition(
+            Transition(
                 name="wontfix",
                 to_status=IssueStatus.CLOSED,
                 to_stage=IssueStage.DONE,
                 required_solution=IssueSolution.WONTFIX,
-                description="Mark as wontfix"
+                description="Mark as wontfix",
             ),
         ]
 
@@ -103,9 +105,11 @@ class TransitionService:
             if t.is_allowed(issue):
                 valid_transition = t
                 break
-        
+
         if not valid_transition:
-            raise ValueError(f"Transition '{transition_name}' is not allowed for current state.")
+            raise ValueError(
+                f"Transition '{transition_name}' is not allowed for current state."
+            )
 
         # Apply changes
         issue.frontmatter.status = valid_transition.to_status
@@ -113,14 +117,20 @@ class TransitionService:
             issue.frontmatter.stage = valid_transition.to_stage
         if valid_transition.required_solution:
             issue.frontmatter.solution = valid_transition.required_solution
-            
+
         issue.frontmatter.updated_at = current_time()
-        
+
         # Logic for closed_at, opened_at etc.
-        if valid_transition.to_status == IssueStatus.CLOSED and issue.frontmatter.closed_at is None:
+        if (
+            valid_transition.to_status == IssueStatus.CLOSED
+            and issue.frontmatter.closed_at is None
+        ):
             issue.frontmatter.closed_at = current_time()
-            
-        if valid_transition.to_status == IssueStatus.OPEN and issue.frontmatter.opened_at is None:
-             issue.frontmatter.opened_at = current_time()
-            
+
+        if (
+            valid_transition.to_status == IssueStatus.OPEN
+            and issue.frontmatter.opened_at is None
+        ):
+            issue.frontmatter.opened_at = current_time()
+
         return issue

monoco/features/issue/domain/models.py

@@ -1,22 +1,33 @@
 from typing import List, Optional, Any, Dict
 from pydantic import BaseModel, Field, model_validator
 from datetime import datetime
-from ..models import IssueType, IssueStatus, IssueStage, IssueSolution, IssueIsolation, IssueID, current_time
-from monoco.core.lsp import Range, Position
+from ..models import (
+    IssueType,
+    IssueStatus,
+    IssueStage,
+    IssueSolution,
+    IssueIsolation,
+    current_time,
+)
+from monoco.core.lsp import Range
+
 
 class Span(BaseModel):
     """
     Represents a fine-grained location inside a ContentBlock.
     """
+
     type: str  # 'wikilink', 'issue_id', 'checkbox', 'yaml_key', 'plain_text'
     range: Range
     content: str
     metadata: Dict[str, Any] = Field(default_factory=dict)
 
+
 class ContentBlock(BaseModel):
     """
     Represents a block of content in the markdown body.
     """
+
     type: str  # e.g., 'heading', 'task_list', 'paragraph', 'empty'
     content: str
     line_start: int
@@ -27,30 +38,35 @@ class ContentBlock(BaseModel):
     def to_string(self) -> str:
         return self.content
 
+
 from enum import Enum
 
+
 class TaskState(str, Enum):
     TODO = " "
     DONE = "x"
     DOING = "-"
     CANCELLED = "+"
 
+
 class TaskItem(ContentBlock):
-    type: str = "task_item" # override type
+    type: str = "task_item"  # override type
     state: TaskState = TaskState.TODO
     level: int = 0
     parent_index: Optional[int] = None
-    
+
     @property
     def is_completed(self) -> bool:
         return self.state in [TaskState.DONE, TaskState.CANCELLED]
 
+
 class IssueBody(BaseModel):
     """
     Represents the parsed body of the issue.
     """
+
     blocks: List[ContentBlock] = Field(default_factory=list)
-    
+
     def to_markdown(self) -> str:
         return "\n".join(b.to_string() for b in self.blocks)
 
@@ -60,21 +76,30 @@ class IssueBody(BaseModel):
 
     @property
     def tasks(self) -> List[TaskItem]:
-        return [b for b in self.blocks if isinstance(b, TaskItem) or (isinstance(b, ContentBlock) and b.type == 'task_item')]
-    
+        return [
+            b
+            for b in self.blocks
+            if isinstance(b, TaskItem)
+            or (isinstance(b, ContentBlock) and b.type == "task_item")
+        ]
+
     @property
     def progress(self) -> str:
         tasks = self.tasks
         if not tasks:
             return "0/0"
-        completed = len([t for t in tasks if isinstance(t, TaskItem) and t.is_completed])
+        completed = len(
+            [t for t in tasks if isinstance(t, TaskItem) and t.is_completed]
+        )
         return f"{completed}/{len(tasks)}"
 
+
 class IssueFrontmatter(BaseModel):
     """
     Represents the YAML frontmatter of the issue.
     Contains metadata and validation logic.
     """
+
     id: str
     uid: Optional[str] = None
     type: IssueType
@@ -91,10 +116,10 @@ class IssueFrontmatter(BaseModel):
     tags: List[str] = Field(default_factory=list)
     solution: Optional[IssueSolution] = None
     isolation: Optional[IssueIsolation] = None
-    
+
     model_config = {"extra": "allow"}
 
-    @model_validator(mode='before')
+    @model_validator(mode="before")
     @classmethod
     def normalize_fields(cls, v: Any) -> Any:
         # Reusing normalization logic from original model or keeping it clean here
@@ -105,10 +130,12 @@ class IssueFrontmatter(BaseModel):
                 v["status"] = v["status"].lower()
         return v
 
+
 class Issue(BaseModel):
     """
     The Aggregate Root for an Issue in the Domain Layer.
     """
+
     path: Optional[str] = None
     frontmatter: IssueFrontmatter
     body: IssueBody
@@ -116,55 +143,61 @@ class Issue(BaseModel):
     @property
     def id(self) -> str:
         return self.frontmatter.id
-    
+
     @property
     def status(self) -> IssueStatus:
         return self.frontmatter.status
-        
+
     def to_file_content(self) -> str:
         """
         Reconstruct the full file content.
         """
         import yaml
-        
+
         # Dump frontmatter
         # Dump frontmatter with explicit field handling
         # We want to keep certain fields even if empty to serve as prompts
-        data = self.frontmatter.model_dump(mode='json')
-        
+        data = self.frontmatter.model_dump(mode="json")
+
         # Explicit ordering and key retention
         # We construct a new dict to control order and presence
         ordered_dump = {}
-        
+
         # 1. Identity
-        ordered_dump['id'] = data['id']
-        if data.get('uid'): ordered_dump['uid'] = data['uid']
-        
+        ordered_dump["id"] = data["id"]
+        if data.get("uid"):
+            ordered_dump["uid"] = data["uid"]
+
         # 2. Classifier
-        ordered_dump['type'] = data['type']
-        ordered_dump['status'] = data['status']
-        if data.get('stage'): ordered_dump['stage'] = data['stage']
-        
+        ordered_dump["type"] = data["type"]
+        ordered_dump["status"] = data["status"]
+        if data.get("stage"):
+            ordered_dump["stage"] = data["stage"]
+
         # 3. Content
-        ordered_dump['title'] = data['title']
-        
+        ordered_dump["title"] = data["title"]
+
         # 4. Dates (Always keep created/updated, others if exist)
-        ordered_dump['created_at'] = data['created_at']
-        if data.get('opened_at'): ordered_dump['opened_at'] = data['opened_at']
-        ordered_dump['updated_at'] = data['updated_at']
-        if data.get('closed_at'): ordered_dump['closed_at'] = data['closed_at']
-        
+        ordered_dump["created_at"] = data["created_at"]
+        if data.get("opened_at"):
+            ordered_dump["opened_at"] = data["opened_at"]
+        ordered_dump["updated_at"] = data["updated_at"]
+        if data.get("closed_at"):
+            ordered_dump["closed_at"] = data["closed_at"]
+
         # 5. Graph (Always include to prompt usage)
-        ordered_dump['parent'] = data.get('parent') # Allow null
-        ordered_dump['dependencies'] = data.get('dependencies', [])
-        ordered_dump['related'] = data.get('related', [])
-        ordered_dump['tags'] = data.get('tags', [])
-        
+        ordered_dump["parent"] = data.get("parent")  # Allow null
+        ordered_dump["dependencies"] = data.get("dependencies", [])
+        ordered_dump["related"] = data.get("related", [])
+        ordered_dump["tags"] = data.get("tags", [])
+
         # 6. Lifecycle (Optional)
-        if data.get('solution'): ordered_dump['solution'] = data['solution']
-        if data.get('isolation'): ordered_dump['isolation'] = data['isolation']
+        if data.get("solution"):
+            ordered_dump["solution"] = data["solution"]
+        if data.get("isolation"):
+            ordered_dump["isolation"] = data["isolation"]
 
         fm_str = yaml.dump(ordered_dump, sort_keys=False, allow_unicode=True).strip()
         body_str = self.body.to_markdown()
-        
+
         return f"---\n{fm_str}\n---\n\n{body_str}"

monoco/features/issue/domain/parser.py

@@ -1,9 +1,10 @@
 import yaml
 import re
-from typing import List, Optional, Tuple, Any
+from typing import List, Optional, Tuple
 from .models import Issue, IssueFrontmatter, IssueBody, ContentBlock, Span
 from monoco.core.lsp import Range, Position
 
+
 class MarkdownParser:
     """
     Parses markdown content into Domain Models.
@@ -17,10 +18,10 @@ class MarkdownParser:
     @staticmethod
     def parse(content: str, path: Optional[str] = None) -> Issue:
         lines = content.splitlines()
-        
+
         # 1. Parse Frontmatter
         frontmatter_dict, body_start_line = MarkdownParser._extract_frontmatter(lines)
-        
+
         # 2. Create Frontmatter Object
         # Handle cases where frontmatter might be empty or invalid
         if not frontmatter_dict:
@@ -34,8 +35,10 @@ class MarkdownParser:
         # 3. Parse Body
         body_lines = lines[body_start_line:]
         # Adjust line numbers relative to the original file
-        blocks = MarkdownParser._parse_blocks(body_lines, start_line_offset=body_start_line)
-        
+        blocks = MarkdownParser._parse_blocks(
+            body_lines, start_line_offset=body_start_line
+        )
+
         body = IssueBody(blocks=blocks)
 
         return Issue(path=path, frontmatter=frontmatter, body=body)
@@ -47,7 +50,7 @@ class MarkdownParser:
         """
         if not lines or lines[0].strip() != "---":
             return {}, 0
-        
+
         fm_lines = []
         i = 1
         while i < len(lines):
@@ -56,8 +59,8 @@ class MarkdownParser:
                 return yaml.safe_load("\n".join(fm_lines)), i + 1
             fm_lines.append(line)
             i += 1
-            
-        return {}, 0 # malformed
+
+        return {}, 0  # malformed
 
     @staticmethod
     def _parse_blocks(lines: List[str], start_line_offset: int) -> List[ContentBlock]:
@@ -65,7 +68,7 @@ class MarkdownParser:
         current_block_lines = []
         current_block_type = "paragraph"
         current_start_line = start_line_offset
-        
+
         def flush_block():
             nonlocal current_block_lines, current_start_line
             if current_block_lines:
@@ -74,31 +77,33 @@ class MarkdownParser:
                     type=current_block_type,
                     content=content,
                     line_start=current_start_line,
-                    line_end=current_start_line + len(current_block_lines)
+                    line_end=current_start_line + len(current_block_lines),
+                )
+                block.spans = MarkdownParser._parse_spans(
+                    current_block_lines, current_start_line
                 )
-                block.spans = MarkdownParser._parse_spans(current_block_lines, current_start_line)
                 blocks.append(block)
                 current_block_lines = []
 
         for i, line in enumerate(lines):
             abs_line_idx = start_line_offset + i
-            
+
             # Simple heuristic for block detection
             # 1. Heading
             if re.match(r"^#{1,6}\s", line):
                 flush_block()
-                
+
                 # Add heading as its own block
                 block = ContentBlock(
                     type="heading",
                     content=line,
                     line_start=abs_line_idx,
-                    line_end=abs_line_idx + 1
+                    line_end=abs_line_idx + 1,
                 )
                 block.spans = MarkdownParser._parse_spans([line], abs_line_idx)
                 blocks.append(block)
                 current_start_line = abs_line_idx + 1
-                current_block_type = "paragraph" # reset
+                current_block_type = "paragraph"  # reset
                 continue
 
             # 2. Task List Item
@@ -109,24 +114,25 @@ class MarkdownParser:
 
                 indent_str = task_match.group(1)
                 state_char = task_match.group(2).lower()
-                
+
                 # Calculate level (assuming 2 spaces per level)
-                level = len(indent_str) // 2 
-                
+                level = len(indent_str) // 2
+
                 # Determine state
                 from .models import TaskState, TaskItem
+
                 state_map = {
                     " ": TaskState.TODO,
                     "x": TaskState.DONE,
                     "-": TaskState.DOING,  # Legacy
                     "/": TaskState.DOING,  # New Standard
-                    "+": TaskState.CANCELLED, # Legacy
-                    "~": TaskState.CANCELLED  # New Standard
+                    "+": TaskState.CANCELLED,  # Legacy
+                    "~": TaskState.CANCELLED,  # New Standard
                 }
-                
+
                 # Fallback for 'X' -> 'x'
-                if state_char not in state_map and state_char == 'x':
-                    state_char = 'x'
+                if state_char not in state_map and state_char == "x":
+                    state_char = "x"
 
                 block = TaskItem(
                     content=line,
@@ -134,7 +140,7 @@ class MarkdownParser:
                     line_end=abs_line_idx + 1,
                     state=state_map.get(state_char, TaskState.TODO),
                     level=level,
-                    metadata={"checked": state_char in ['x', '+']}
+                    metadata={"checked": state_char in ["x", "+"]},
                 )
                 block.spans = MarkdownParser._parse_spans([line], abs_line_idx)
                 blocks.append(block)
@@ -144,24 +150,26 @@ class MarkdownParser:
 
             # 3. Empty lines (separators)
             if not line.strip():
-                 flush_block()
-                 
-                 blocks.append(ContentBlock(
-                     type="empty",
-                     content="",
-                     line_start=abs_line_idx,
-                     line_end=abs_line_idx + 1
-                 ))
-                 current_start_line = abs_line_idx + 1
-                 current_block_type = "paragraph"
-                 continue
+                flush_block()
+
+                blocks.append(
+                    ContentBlock(
+                        type="empty",
+                        content="",
+                        line_start=abs_line_idx,
+                        line_end=abs_line_idx + 1,
+                    )
+                )
+                current_start_line = abs_line_idx + 1
+                current_block_type = "paragraph"
+                continue
 
             # Default: accumulate lines into paragraph
             if not current_block_lines:
                 current_start_line = abs_line_idx
-            
+
             current_block_lines.append(line)
-            
+
         # Flush remaining
         flush_block()
 
@@ -175,49 +183,64 @@ class MarkdownParser:
         spans = []
         for i, line in enumerate(lines):
             abs_line_idx = line_offset + i
-            
+
             # 1. Parse Checkboxes (only at start of line)
             checkbox_match = re.match(r"^(\s*-\s*\[)([ xX\-\+~/])(\])", line)
             if checkbox_match:
                 start_char = len(checkbox_match.group(1))
                 end_char = start_char + 1
-                spans.append(Span(
-                    type="checkbox",
-                    range=Range(
-                        start=Position(line=abs_line_idx, character=start_char),
-                        end=Position(line=abs_line_idx, character=end_char)
-                    ),
-                    content=checkbox_match.group(2),
-                    metadata={"state": checkbox_match.group(2)}
-                ))
+                spans.append(
+                    Span(
+                        type="checkbox",
+                        range=Range(
+                            start=Position(line=abs_line_idx, character=start_char),
+                            end=Position(line=abs_line_idx, character=end_char),
+                        ),
+                        content=checkbox_match.group(2),
+                        metadata={"state": checkbox_match.group(2)},
+                    )
+                )
 
             # 2. Parse Wikilinks
             for match in re.finditer(MarkdownParser.WIKILINK_PATTERN, line):
-                spans.append(Span(
-                    type="wikilink",
-                    range=Range(
-                        start=Position(line=abs_line_idx, character=match.start()),
-                        end=Position(line=abs_line_idx, character=match.end())
-                    ),
-                    content=match.group(0),
-                    metadata={"issue_id": match.group(1)}
-                ))
+                spans.append(
+                    Span(
+                        type="wikilink",
+                        range=Range(
+                            start=Position(line=abs_line_idx, character=match.start()),
+                            end=Position(line=abs_line_idx, character=match.end()),
+                        ),
+                        content=match.group(0),
+                        metadata={"issue_id": match.group(1)},
+                    )
+                )
 
             # 3. Parse Raw Issue IDs (not inside wikilinks)
             # We use a simple exclusion logic: if a match is inside a wikilink, skip it.
-            wikilink_ranges = [(s.range.start.character, s.range.end.character) for s in spans if s.type == "wikilink" and s.range.start.line == abs_line_idx]
-            
+            wikilink_ranges = [
+                (s.range.start.character, s.range.end.character)
+                for s in spans
+                if s.type == "wikilink" and s.range.start.line == abs_line_idx
+            ]
+
             for match in re.finditer(MarkdownParser.ISSUE_ID_PATTERN, line):
-                is_inside = any(r[0] <= match.start() and match.end() <= r[1] for r in wikilink_ranges)
+                is_inside = any(
+                    r[0] <= match.start() and match.end() <= r[1]
+                    for r in wikilink_ranges
+                )
                 if not is_inside:
-                    spans.append(Span(
-                        type="issue_id",
-                        range=Range(
-                            start=Position(line=abs_line_idx, character=match.start()),
-                            end=Position(line=abs_line_idx, character=match.end())
-                        ),
-                        content=match.group(0),
-                        metadata={"issue_id": match.group(1)}
-                    ))
-        
+                    spans.append(
+                        Span(
+                            type="issue_id",
+                            range=Range(
+                                start=Position(
+                                    line=abs_line_idx, character=match.start()
+                                ),
+                                end=Position(line=abs_line_idx, character=match.end()),
+                            ),
+                            content=match.group(0),
+                            metadata={"issue_id": match.group(1)},
+                        )
+                    )
+
         return spans