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

monoco/features/issue/domain/workspace.py

@@ -1,27 +1,28 @@
 import re
 from pathlib import Path
-from typing import Dict, List, Optional, Set
+from typing import Dict, Optional
 from pydantic import BaseModel
-from .parser import MarkdownParser
-from .models import Issue
-from monoco.core.config import get_config, MonocoConfig
-from monoco.core.lsp import Location, Range, Position
+from monoco.core.config import get_config
+
 
 class IssueLocation(BaseModel):
     project_id: str
     file_path: str
     issue_id: str
 
+
 class WorkspaceSymbolIndex:
     """
     Maintains a global index of all issues in the Monoco Workspace.
     Allows resolving Issue IDs (local or namespaced) to file locations.
     """
-    
+
     def __init__(self, root_path: Path):
         self.root_path = root_path
         self.index: Dict[str, IssueLocation] = {}  # Map<FullID, Location>
-        self.local_map: Dict[str, str] = {} # Map<LocalID, FullID> for current context project
+        self.local_map: Dict[
+            str, str
+        ] = {}  # Map<LocalID, FullID> for current context project
         self._is_indexed = False
 
     def build_index(self, recursive: bool = True):
@@ -29,15 +30,15 @@ class WorkspaceSymbolIndex:
         Scans the workspace and subprojects to build the index.
         """
         self.index.clear()
-        
+
         # 1. Index local project
         project_name = "local"
         conf = get_config(str(self.root_path))
         if conf and conf.project and conf.project.name:
             project_name = conf.project.name.lower()
-            
+
         self._index_project(self.root_path, project_name)
-        
+
         # 2. Index workspace members
         if recursive:
             try:
@@ -47,7 +48,7 @@ class WorkspaceSymbolIndex:
                         self._index_project(member_root, member_name.lower())
             except Exception:
                 pass
-                
+
         self._is_indexed = True
 
     def _index_project(self, project_root: Path, project_name: str):
@@ -69,12 +70,14 @@ class WorkspaceSymbolIndex:
                         loc = IssueLocation(
                             project_id=project_name,
                             file_path=str(f.absolute()),
-                            issue_id=issue_id
+                            issue_id=issue_id,
                         )
                         self.index[full_id] = loc
-                        self.index[issue_id] = loc # Alias for local lookup
+                        self.index[issue_id] = loc  # Alias for local lookup
 
-    def resolve(self, issue_id: str, context_project: Optional[str] = None) -> Optional[IssueLocation]:
+    def resolve(
+        self, issue_id: str, context_project: Optional[str] = None
+    ) -> Optional[IssueLocation]:
         """
         Resolves an issue ID to its location.
         Supports 'Project::ID' and 'ID'.
@@ -94,11 +97,11 @@ class WorkspaceSymbolIndex:
         # 1. Try exact match
         if issue_id in self.index:
             return self.index[issue_id]
-            
+
         # 2. Try contextual resolution if it's a local ID
         if "::" not in issue_id and context_project:
             full_id = f"{context_project}::{issue_id}"
             if full_id in self.index:
                 return self.index[full_id]
-                
+
         return None

monoco/features/issue/engine/__init__.py

@@ -1,18 +1,18 @@
 from typing import Optional
-from .models import Transition
 
 from .machine import StateMachine
 from .config import DEFAULT_ISSUE_CONFIG
 from monoco.core.config import get_config
 
+
 def get_engine(project_root: Optional[str] = None) -> StateMachine:
     # 1. Load Core Config (merges workspace & project yamls)
     core_config = get_config(project_root)
-    
+
     # 2. Start with Defaults
     # Use model_copy to avoid mutating the global default instance
     final_config = DEFAULT_ISSUE_CONFIG.model_copy(deep=True)
-    
+
     # 3. Merge User Overrides
     if core_config.issue:
         # core_config.issue is already an IssueSchemaConfig (parse/validated by Pydantic)

monoco/features/issue/engine/config.py

@@ -1,9 +1,11 @@
-from monoco.core.config import IssueSchemaConfig, IssueTypeConfig, TransitionConfig, StateMachineConfig
+from monoco.core.config import IssueSchemaConfig, IssueTypeConfig, TransitionConfig
 
 DEFAULT_ISSUE_CONFIG = IssueSchemaConfig(
     types=[
         IssueTypeConfig(name="epic", label="Epic", prefix="EPIC", folder="Epics"),
-        IssueTypeConfig(name="feature", label="Feature", prefix="FEAT", folder="Features"),
+        IssueTypeConfig(
+            name="feature", label="Feature", prefix="FEAT", folder="Features"
+        ),
         IssueTypeConfig(name="chore", label="Chore", prefix="CHORE", folder="Chores"),
         IssueTypeConfig(name="fix", label="Fix", prefix="FIX", folder="Fixes"),
     ],
@@ -12,8 +14,6 @@ DEFAULT_ISSUE_CONFIG = IssueSchemaConfig(
     solutions=["implemented", "cancelled", "wontfix", "duplicate"],
     workflows=[
         # --- UNIVERSAL AGENT ACTIONS ---
-
-
         # --- OPEN -> OPEN Transitions (Stage changes) ---
         TransitionConfig(
             name="start",
@@ -24,11 +24,8 @@ DEFAULT_ISSUE_CONFIG = IssueSchemaConfig(
             to_status="open",
             to_stage="doing",
             command_template="monoco issue start {id}",
-            description="Start working on the issue"
+            description="Start working on the issue",
         ),
-        
-
-
         TransitionConfig(
             name="stop",
             label="Stop",
@@ -38,7 +35,7 @@ DEFAULT_ISSUE_CONFIG = IssueSchemaConfig(
             to_status="open",
             to_stage="draft",
             command_template="monoco issue stop {id}",
-            description="Stop working and return to draft"
+            description="Stop working and return to draft",
         ),
         TransitionConfig(
             name="submit",
@@ -49,7 +46,7 @@ DEFAULT_ISSUE_CONFIG = IssueSchemaConfig(
             to_status="open",
             to_stage="review",
             command_template="monoco issue submit {id}",
-            description="Submit for review"
+            description="Submit for review",
         ),
         TransitionConfig(
             name="reject",
@@ -60,9 +57,8 @@ DEFAULT_ISSUE_CONFIG = IssueSchemaConfig(
             to_status="open",
             to_stage="doing",
             command_template="monoco issue update {id} --stage doing",
-            description="Reject review and return to doing"
+            description="Reject review and return to doing",
         ),
-
         # --- OPEN -> CLOSED Transitions ---
         TransitionConfig(
             name="accept",
@@ -74,7 +70,7 @@ DEFAULT_ISSUE_CONFIG = IssueSchemaConfig(
             to_stage="done",
             required_solution="implemented",
             command_template="monoco issue close {id} --solution implemented",
-            description="Accept and close issue"
+            description="Accept and close issue",
         ),
         TransitionConfig(
             name="close_done",
@@ -86,7 +82,7 @@ DEFAULT_ISSUE_CONFIG = IssueSchemaConfig(
             to_stage="done",
             required_solution="implemented",
             command_template="monoco issue close {id} --solution implemented",
-            description="Close completed issue"
+            description="Close completed issue",
         ),
         TransitionConfig(
             name="cancel",
@@ -98,7 +94,7 @@ DEFAULT_ISSUE_CONFIG = IssueSchemaConfig(
             to_stage="done",
             required_solution="cancelled",
             command_template="monoco issue cancel {id}",
-            description="Cancel the issue"
+            description="Cancel the issue",
         ),
         TransitionConfig(
             name="wontfix",
@@ -109,9 +105,8 @@ DEFAULT_ISSUE_CONFIG = IssueSchemaConfig(
             to_stage="done",
             required_solution="wontfix",
             command_template="monoco issue close {id} --solution wontfix",
-            description="Mark as won't fix"
+            description="Mark as won't fix",
         ),
-
         # --- BACKLOG Transitions ---
         TransitionConfig(
             name="push",
@@ -121,9 +116,8 @@ DEFAULT_ISSUE_CONFIG = IssueSchemaConfig(
             to_status="backlog",
             to_stage="freezed",
             command_template="monoco issue backlog push {id}",
-            description="Move issue to backlog"
+            description="Move issue to backlog",
         ),
-
         TransitionConfig(
             name="pull",
             label="Pull",
@@ -132,7 +126,7 @@ DEFAULT_ISSUE_CONFIG = IssueSchemaConfig(
             to_status="open",
             to_stage="draft",
             command_template="monoco issue backlog pull {id}",
-            description="Restore issue from backlog"
+            description="Restore issue from backlog",
         ),
         TransitionConfig(
             name="cancel_backlog",
@@ -143,9 +137,8 @@ DEFAULT_ISSUE_CONFIG = IssueSchemaConfig(
             to_stage="done",
             required_solution="cancelled",
             command_template="monoco issue cancel {id}",
-            description="Cancel backlog issue"
+            description="Cancel backlog issue",
         ),
-
         # --- CLOSED Transitions ---
         TransitionConfig(
             name="reopen",
@@ -155,7 +148,7 @@ DEFAULT_ISSUE_CONFIG = IssueSchemaConfig(
             to_status="open",
             to_stage="draft",
             command_template="monoco issue open {id}",
-            description="Reopen a closed issue"
+            description="Reopen a closed issue",
         ),
         TransitionConfig(
             name="reopen_from_done",
@@ -166,7 +159,7 @@ DEFAULT_ISSUE_CONFIG = IssueSchemaConfig(
             to_status="open",
             to_stage="draft",
             command_template="monoco issue open {id}",
-            description="Reopen a done issue"
+            description="Reopen a done issue",
         ),
-    ]
+    ],
 )

monoco/features/issue/engine/machine.py

@@ -1,6 +1,7 @@
 from typing import List, Optional, Dict
 from monoco.core.config import IssueSchemaConfig, TransitionConfig
-from ..models import IssueStatus, IssueStage, IssueMetadata, IssueSolution, IssueType
+from ..models import IssueMetadata
+
 
 class StateMachine:
     def __init__(self, config: IssueSchemaConfig):
@@ -30,15 +31,20 @@ class StateMachine:
             return []
         return [t.name for t in self.issue_config.types]
 
-    def can_transition(self, current_status: str, current_stage: Optional[str], 
-                       target_status: str, target_stage: Optional[str]) -> bool:
+    def can_transition(
+        self,
+        current_status: str,
+        current_stage: Optional[str],
+        target_status: str,
+        target_stage: Optional[str],
+    ) -> bool:
         """Check if a transition path exists."""
         for t in self.transitions:
             if t.from_status and t.from_status != current_status:
                 continue
             if t.from_stage and t.from_stage != current_stage:
                 continue
-            
+
             if t.to_status == target_status:
                 if target_stage is None or t.to_stage == target_stage:
                     return True
@@ -56,11 +62,11 @@ class StateMachine:
             # Match status
             if t.from_status and t.from_status != meta.status:
                 continue
-            
+
             # Match stage
             if t.from_stage and t.from_stage != meta.stage:
                 continue
-            
+
             # Special case for 'Cancel': don't show if already DONE or CLOSED
             if t.name == "cancel" and meta.stage == "done":
                 continue
@@ -68,9 +74,14 @@ class StateMachine:
             allowed.append(t)
         return allowed
 
-    def find_transition(self, from_status: str, from_stage: Optional[str],
-                        to_status: str, to_stage: Optional[str],
-                        solution: Optional[str] = None) -> Optional[TransitionConfig]:
+    def find_transition(
+        self,
+        from_status: str,
+        from_stage: Optional[str],
+        to_status: str,
+        to_stage: Optional[str],
+        solution: Optional[str] = None,
+    ) -> Optional[TransitionConfig]:
         """Find a specific transition rule."""
         candidates = []
         for t in self.transitions:
@@ -82,15 +93,15 @@ class StateMachine:
                 continue
             if t.from_stage and t.from_stage != from_stage:
                 continue
-            
+
             # Check if this transition matches the target
             if t.to_status == to_status:
                 if to_stage is None or t.to_stage == to_stage:
                     candidates.append(t)
-        
+
         if not candidates:
             return None
-        
+
         # If we have a solution, find the transition that requires it
         if solution:
             for t in candidates:
@@ -102,84 +113,106 @@ class StateMachine:
                 if t.required_solution is None:
                     return t
             return None
-        
+
         # Otherwise return the first one that has NO required_solution
         for t in candidates:
             if t.required_solution is None:
                 return t
-        
+
         return candidates[0]
 
-    def validate_transition(self, from_status: str, from_stage: Optional[str],
-                            to_status: str, to_stage: Optional[str],
-                            solution: Optional[str] = None) -> None:
+    def validate_transition(
+        self,
+        from_status: str,
+        from_stage: Optional[str],
+        to_status: str,
+        to_stage: Optional[str],
+        solution: Optional[str] = None,
+    ) -> None:
         """
         Validate if a transition is allowed. Raises ValueError if not.
         """
         if from_status == to_status and from_stage == to_stage:
-            return # No change is always allowed (unless we want to enforce specific updates)
+            return  # No change is always allowed (unless we want to enforce specific updates)
+
+        transition = self.find_transition(
+            from_status, from_stage, to_status, to_stage, solution
+        )
 
-        transition = self.find_transition(from_status, from_stage, to_status, to_stage, solution)
-        
         if not transition:
-            raise ValueError(f"Lifecycle Policy: Transition from {from_status}({from_stage if from_stage else 'None'}) "
-                             f"to {to_status}({to_stage if to_stage else 'None'}) is not defined.")
+            raise ValueError(
+                f"Lifecycle Policy: Transition from {from_status}({from_stage if from_stage else 'None'}) "
+                f"to {to_status}({to_stage if to_stage else 'None'}) is not defined."
+            )
 
         if transition.required_solution and solution != transition.required_solution:
-             raise ValueError(f"Lifecycle Policy: Transition '{transition.label}' requires solution '{transition.required_solution}'.")
+            raise ValueError(
+                f"Lifecycle Policy: Transition '{transition.label}' requires solution '{transition.required_solution}'."
+            )
 
     def enforce_policy(self, meta: IssueMetadata) -> None:
         """
         Apply consistency rules to IssueMetadata.
         """
         from ..models import current_time
-        
+
         if meta.status == "backlog":
             meta.stage = "freezed"
-        
+
         elif meta.status == "closed":
             if meta.stage != "done":
                 meta.stage = "done"
             if not meta.closed_at:
                 meta.closed_at = current_time()
-        
+
         elif meta.status == "open":
             if meta.stage is None:
                 meta.stage = "draft"
 
-    def validate_transition(self, from_status: str, from_stage: Optional[str],
-                            to_status: str, to_stage: Optional[str],
-                            solution: Optional[str] = None) -> None:
+    def validate_transition(
+        self,
+        from_status: str,
+        from_stage: Optional[str],
+        to_status: str,
+        to_stage: Optional[str],
+        solution: Optional[str] = None,
+    ) -> None:
         """
         Validate if a transition is allowed. Raises ValueError if not.
         """
         if from_status == to_status and from_stage == to_stage:
-            return # No change is always allowed (unless we want to enforce specific updates)
+            return  # No change is always allowed (unless we want to enforce specific updates)
+
+        transition = self.find_transition(
+            from_status, from_stage, to_status, to_stage, solution
+        )
 
-        transition = self.find_transition(from_status, from_stage, to_status, to_stage, solution)
-        
         if not transition:
-            raise ValueError(f"Lifecycle Policy: Transition from {from_status}({from_stage if from_stage else 'None'}) "
-                             f"to {to_status}({to_stage if to_stage else 'None'}) is not defined.")
+            raise ValueError(
+                f"Lifecycle Policy: Transition from {from_status}({from_stage if from_stage else 'None'}) "
+                f"to {to_status}({to_stage if to_stage else 'None'}) is not defined."
+            )
 
         if transition.required_solution and solution != transition.required_solution:
-             raise ValueError(f"Lifecycle Policy: Transition '{transition.label}' requires solution '{transition.required_solution}'.")
+            raise ValueError(
+                f"Lifecycle Policy: Transition '{transition.label}' requires solution '{transition.required_solution}'."
+            )
 
     def enforce_policy(self, meta: IssueMetadata) -> None:
         """
         Apply consistency rules to IssueMetadata.
         """
         from ..models import current_time
-        
+
         if meta.status == "backlog":
             meta.stage = "freezed"
-        
+
         elif meta.status == "closed":
             if meta.stage != "done":
                 meta.stage = "done"
             if not meta.closed_at:
                 meta.closed_at = current_time()
-        
+
         elif meta.status == "open":
             if meta.stage is None:
-                meta.stage = "draft"
+                meta.stage = "draft"

monoco/features/issue/engine/models.py

@@ -1,18 +1,20 @@
-from typing import List, Optional, Any
+from typing import List, Optional
 from pydantic import BaseModel
 
+
 class Transition(BaseModel):
     name: str
     label: str
     icon: Optional[str] = None
     from_status: Optional[str] = None  # None means any
-    from_stage: Optional[str] = None    # None means any
+    from_stage: Optional[str] = None  # None means any
     to_status: str
     to_stage: Optional[str] = None
     required_solution: Optional[str] = None
     description: str = ""
     command_template: Optional[str] = None
 
+
 class StateMachineConfig(BaseModel):
     transitions: List[Transition]
     # We can add more config like default stages for statuses etc.