monoco-toolkit 0.3.5__py3-none-any.whl → 0.3.6__py3-none-any.whl

monoco/features/issue/core.py

@@ -221,6 +221,10 @@ def create_issue_file(
         if not find_issue_path(issues_root, rel_id):
             raise ValueError(f"Related issue {rel_id} not found.")
 
+    # Auto-assign default parent for non-epic types if not provided
+    if issue_type != IssueType.EPIC and not parent:
+        parent = "EPIC-0000"
+
     issue_id = find_next_id(issue_type, issues_root)
     base_type_dir = get_issue_dir(issue_type, issues_root)
     target_dir = base_type_dir / status

monoco/features/issue/engine/machine.py

@@ -169,35 +169,6 @@ class StateMachine:
             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:
-        """
-        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)
-
-        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."
-            )
-
-        if transition.required_solution and 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.

monoco/features/issue/models.py

@@ -1,6 +1,6 @@
 from enum import Enum
 from typing import List, Optional, Any, Dict
-from pydantic import BaseModel, Field, model_validator
+from pydantic import BaseModel, Field, model_validator, ConfigDict
 from datetime import datetime
 import hashlib
 import secrets
@@ -105,13 +105,13 @@ class IssueAction(BaseModel):
 
 
 class IssueMetadata(BaseModel):
-    model_config = {"extra": "allow"}
+    model_config = ConfigDict(extra="allow", validate_assignment=True)
 
     id: str
     uid: Optional[str] = None  # Global unique identifier for cross-project identity
-    type: str
-    status: str = "open"
-    stage: Optional[str] = None
+    type: IssueType
+    status: IssueStatus = IssueStatus.OPEN
+    stage: Optional[IssueStage] = None
     title: str
 
     # Time Anchors
@@ -122,7 +122,7 @@ class IssueMetadata(BaseModel):
 
     parent: Optional[str] = None
     sprint: Optional[str] = None
-    solution: Optional[str] = None
+    solution: Optional[IssueSolution] = None
     isolation: Optional[IssueIsolation] = None
     dependencies: List[str] = []
     related: List[str] = []
@@ -161,26 +161,56 @@ class IssueMetadata(BaseModel):
             # Normalize type and status to lowercase for compatibility
             if "type" in v and isinstance(v["type"], str):
                 v["type"] = v["type"].lower()
+                try:
+                    v["type"] = IssueType(v["type"])
+                except ValueError:
+                    pass
+
             if "status" in v and isinstance(v["status"], str):
                 v["status"] = v["status"].lower()
+                try:
+                    v["status"] = IssueStatus(v["status"])
+                except ValueError:
+                    pass
+
             if "solution" in v and isinstance(v["solution"], str):
                 v["solution"] = v["solution"].lower()
+                try:
+                    v["solution"] = IssueSolution(v["solution"])
+                except ValueError:
+                    pass
+
             # Stage normalization
             if "stage" in v and isinstance(v["stage"], str):
                 v["stage"] = v["stage"].lower()
                 if v["stage"] == "todo":
                     v["stage"] = "draft"
+                try:
+                    v["stage"] = IssueStage(v["stage"])
+                except ValueError:
+                    pass
         return v
 
     @model_validator(mode="after")
     def validate_lifecycle(self) -> "IssueMetadata":
-        # Logic Definition:
-        # status: backlog -> stage: freezed
-        # status: closed -> stage: done
-        # status: open -> stage: draft | doing | review | done (default draft)
-
-        # NOTE: We do NOT auto-correct state here anymore to allow Linter to detect inconsistencies.
-        # Auto-correction should be applied explicitly by 'create' or 'update' commands via core logic.
+        # 1. Solution Consistency: Closed issues MUST have a solution
+        if self.status == IssueStatus.CLOSED and not self.solution:
+            raise ValueError(f"Issue '{self.id}' is closed but 'solution' is missing.")
+
+        # 2. Hierarchy Consistency: non-epic types MUST have a parent (except specific root seeds)
+        if self.type != IssueType.EPIC and not self.parent:
+            # We allow exceptions for very specific bootstrap cases if needed, but currently enforce it.
+            if self.id not in ["FEAT-BOOTSTRAP"]:  # Example exception
+                raise ValueError(
+                    f"Issue '{self.id}' of type '{self.type}' must have a 'parent' reference."
+                )
+
+        # 3. State/Stage Consistency (Warnings or Errors)
+        # Note: In Monoco, status: closed is tightly coupled with stage: done
+        if self.status == IssueStatus.CLOSED and self.stage != IssueStage.DONE:
+            # We could auto-fix here, but let's be strict for Validation purposes
+            # raise ValueError(f"Issue '{self.id}' is closed but stage is '{self.stage}' (expected 'done').")
+            pass
 
         return self
 

monoco/features/issue/test_priority_integration.py

@@ -16,6 +16,7 @@ def test_validator_namespaced_reference_in_body():
         opened_at=datetime.now(),
         updated_at=datetime.now(),
         domains=["intelligence"],
+        parent="EPIC-0000",
     )
 
     # Context: toolkit project, monoco workspace

monoco/features/memo/__init__.py

@@ -0,0 +1,3 @@
+from .cli import app
+
+__all__ = ["app"]

monoco/features/memo/cli.py

@@ -0,0 +1,90 @@
+import typer
+from pathlib import Path
+from typing import Optional
+from rich.console import Console
+from rich.table import Table
+from monoco.core.config import get_config
+from .core import add_memo, list_memos, get_inbox_path
+
+app = typer.Typer(help="Manage memos (fleeting notes).")
+console = Console()
+
+
+def get_issues_root() -> Path:
+    config = get_config()
+    # Resolve absolute path for issues
+    root = Path(config.paths.root).resolve()
+    # If config.paths.root is '.', it means current or discovered root.
+    # We should trust get_config's loading mechanism, but find_monoco_root might be safer to base off.
+    # Update: config is loaded relative to where it was found.
+    # Let's rely on config.paths.root if it's absolute, or relative to CWD?
+    # Actually, the ConfigLoader doesn't mutate paths.root based on location.
+    # It defaults to "."
+
+    # Better approach:
+    # Use find_monoco_root() to get base, then append config.paths.issues
+    from monoco.core.config import find_monoco_root
+
+    project_root = find_monoco_root()
+    return project_root / config.paths.issues
+
+
+@app.command("add")
+def add_command(
+    content: str = typer.Argument(..., help="The content of the memo."),
+    context: Optional[str] = typer.Option(
+        None, "--context", "-c", help="Context reference (e.g. file:line)."
+    ),
+):
+    """
+    Capture a new idea or thought into the Memo Inbox.
+    """
+    issues_root = get_issues_root()
+
+    uid = add_memo(issues_root, content, context)
+
+    console.print(f"[green]✔ Memo recorded.[/green] ID: [bold]{uid}[/bold]")
+
+
+@app.command("list")
+def list_command():
+    """
+    List all memos in the inbox.
+    """
+    issues_root = get_issues_root()
+
+    memos = list_memos(issues_root)
+
+    if not memos:
+        console.print("No memos found. Use `monoco memo add` to create one.")
+        return
+
+    table = Table(title="Memo Inbox")
+    table.add_column("ID", style="cyan", no_wrap=True)
+    table.add_column("Timestamp", style="magenta")
+    table.add_column("Content")
+
+    for memo in memos:
+        # Truncate content for list view
+        content_preview = memo["content"].split("\n")[0]
+        if len(memo["content"]) > 50:
+            content_preview = content_preview[:47] + "..."
+
+        table.add_row(memo["id"], memo["timestamp"], content_preview)
+
+    console.print(table)
+
+
+@app.command("open")
+def open_command():
+    """
+    Open the inbox file in the default editor.
+    """
+    issues_root = get_issues_root()
+    inbox_path = get_inbox_path(issues_root)
+
+    if not inbox_path.exists():
+        console.print("[yellow]Inbox does not exist yet.[/yellow]")
+        return
+
+    typer.launch(str(inbox_path))

monoco/features/memo/core.py

@@ -0,0 +1,87 @@
+import re
+from pathlib import Path
+from datetime import datetime
+from typing import List, Dict, Optional
+import secrets
+
+
+def get_memos_dir(issues_root: Path) -> Path:
+    """
+    Get the directory for memos.
+    Convention: Sibling of Issues directory.
+    """
+    # issues_root is usually ".../Issues"
+    return issues_root.parent / "Memos"
+
+
+def get_inbox_path(issues_root: Path) -> Path:
+    return get_memos_dir(issues_root) / "inbox.md"
+
+
+def generate_memo_id() -> str:
+    """Generate a short 6-char ID."""
+    return secrets.token_hex(3)
+
+
+def format_memo(uid: str, content: str, context: Optional[str] = None) -> str:
+    timestamp = datetime.now().strftime("%Y-%m-%d %H:%M:%S")
+    header = f"## [{uid}] {timestamp}"
+
+    body = content.strip()
+
+    if context:
+        body = f"> **Context**: `{context}`\n\n{body}"
+
+    return f"\n{header}\n{body}\n"
+
+
+def add_memo(issues_root: Path, content: str, context: Optional[str] = None) -> str:
+    """
+    Append a memo to the inbox.
+    Returns the generated UID.
+    """
+    inbox_path = get_inbox_path(issues_root)
+
+    if not inbox_path.exists():
+        inbox_path.parent.mkdir(parents=True, exist_ok=True)
+        inbox_path.write_text("# Monoco Memos Inbox\n", encoding="utf-8")
+
+    uid = generate_memo_id()
+    entry = format_memo(uid, content, context)
+
+    with inbox_path.open("a", encoding="utf-8") as f:
+        f.write(entry)
+
+    return uid
+
+
+def list_memos(issues_root: Path) -> List[Dict[str, str]]:
+    """
+    Parse memos from inbox.
+    """
+    inbox_path = get_inbox_path(issues_root)
+    if not inbox_path.exists():
+        return []
+
+    content = inbox_path.read_text(encoding="utf-8")
+
+    # Regex to find headers: ## [uid] timestamp
+    # We split by headers
+
+    pattern = re.compile(r"^## \[([a-f0-9]+)\] (.*?)$", re.MULTILINE)
+
+    memos = []
+    matches = list(pattern.finditer(content))
+
+    for i, match in enumerate(matches):
+        uid = match.group(1)
+        timestamp = match.group(2)
+
+        start = match.end()
+        end = matches[i + 1].start() if i + 1 < len(matches) else len(content)
+
+        body = content[start:end].strip()
+
+        memos.append({"id": uid, "timestamp": timestamp, "content": body})
+
+    return memos

monoco/features/scheduler/session.py

@@ -1,6 +1,6 @@
 from datetime import datetime
 from typing import Optional
-from pydantic import BaseModel, Field
+from pydantic import BaseModel, Field, ConfigDict
 from .worker import Worker
 
 
@@ -10,6 +10,8 @@ class Session(BaseModel):
     Persisted state of the session.
     """
 
+    model_config = ConfigDict(arbitrary_types_allowed=True)
+
     id: str = Field(..., description="Unique session ID (likely UUID)")
     issue_id: str = Field(..., description="The Issue ID this session is working on")
     role_name: str = Field(..., description="Name of the role employed")
@@ -24,9 +26,6 @@ class Session(BaseModel):
     # History could be a list of logs or pointers to git commits
     # For now, let's keep it simple. The git log IS the history.
 
-    class Config:
-        arbitrary_types_allowed = True
-
 
 class RuntimeSession:
     """

monoco/main.py

@@ -171,6 +171,10 @@ from monoco.features.scheduler import cli as scheduler_cmd
 app.add_typer(scheduler_cmd.app, name="agent", help="Manage agent sessions")
 app.add_typer(scheduler_cmd.role_app, name="role", help="Manage agent roles")
 
+from monoco.features.memo import app as memo_app
+
+app.add_typer(memo_app, name="memo", help="Manage fleeting notes (memos)")
+
 
 from monoco.daemon.commands import serve
 

{monoco_toolkit-0.3.5.dist-info → monoco_toolkit-0.3.6.dist-info}/METADATA

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: monoco-toolkit
-Version: 0.3.5
+Version: 0.3.6
 Summary: Agent Native Toolkit for Monoco - Task Management & Kanban for AI Agents
 Project-URL: Homepage, https://monoco.io
 Project-URL: Repository, https://github.com/IndenScale/Monoco

{monoco_toolkit-0.3.5.dist-info → monoco_toolkit-0.3.6.dist-info}/RECORD

@@ -1,4 +1,4 @@
-monoco/main.py,sha256=MscjwDCOT2DfZKpZMEZEn-M1INmqu4-4R200GEiBwrc,5562
+monoco/main.py,sha256=IF8pN71fFL0AwxtnRxXQaoi9NgBf0YAhppWlc8SuiTM,5688
 monoco/cli/__init__.py,sha256=47DEQpj8HBSa-_TImW-5JCeuQeRkm5NMpJWZG3hSuFU,0
 monoco/cli/project.py,sha256=FqLaDD3hiWxa0_TKzxEF7PYH9RPsvmLyjO3NYVckgGs,2737
 monoco/cli/workspace.py,sha256=1TVVS835XyirLDvBGQXSblIaYVhe2Pk9EpORDvcktyk,1538
@@ -42,15 +42,15 @@ monoco/features/i18n/resources/zh/AGENTS.md,sha256=lKkwLLCADRH7UDq9no4eQY2sRfJrb
 monoco/features/i18n/resources/zh/SKILL.md,sha256=Wynk7zVBW7CO0_6AEQNUvlD_3eMW_7EPnzEn9QUaiDs,1884
 monoco/features/issue/adapter.py,sha256=4dzKg4-0XH63uORoh8qcolvKxJR6McBDIYxYEcZJJkA,1204
 monoco/features/issue/commands.py,sha256=vaScb2J4qjUvO8DSlKhTrGDSfIyJ4zIUr14jhBlG6tE,37581
-monoco/features/issue/core.py,sha256=kRyUbYqEBno0Zoogq7dMIcQv5M0QIRSlptvzp0pfImE,51302
+monoco/features/issue/core.py,sha256=9b5BVJJz5Ek3QNKqOhn6GSgvkmpAN45zmb8CQJVsPjc,51452
 monoco/features/issue/domain_commands.py,sha256=eatSF_uZp4nGpVr2PIgb00MWfEBm0OnyAd4JvUJEAAA,1535
 monoco/features/issue/domain_service.py,sha256=bEs_WXOWmotgIR-lGwyWekF4nonvjsgrK1YG3pyVfwk,2564
 monoco/features/issue/linter.py,sha256=LLtJEVIzoGTNm1liZARJHM3-V-EODkGRuw3ExCZtEjY,26115
 monoco/features/issue/migration.py,sha256=i0xlxZjrpmuHGHOAIN4iu31EwwVIvZn7yjveS-kU22c,4896
-monoco/features/issue/models.py,sha256=7oIMxvUEfe00n7wni9bZgKU2e9404flvArixbLQ95Dg,5902
+monoco/features/issue/models.py,sha256=pIgun9dDTelDJa6RqhLJb2OR201cimOoNEB78qUsvG0,7286
 monoco/features/issue/monitor.py,sha256=vZN0TbR3V5fHKHRGkIhimO6UwWcwYjDHQs2qzjEG174,3549
 monoco/features/issue/resolver.py,sha256=mAU9s7TNNHY9A2278JTwJvxU-jalGKTDJfJdjONev3E,5655
-monoco/features/issue/test_priority_integration.py,sha256=Kq3XMQYkQK62R-a_lmAeEpGlZr4nRBbG6WAyW430el8,2763
+monoco/features/issue/test_priority_integration.py,sha256=pTBg3Wjv6lLYxWL6vjbo2NGVE-X0MRB3Ha8bqObZrU4,2791
 monoco/features/issue/test_resolver.py,sha256=luFhK37DUvh4a3TTcFYVO-oOIJljQVCSYicwSWyDleQ,2530
 monoco/features/issue/validator.py,sha256=GYqbx2-ZxXfk1HicgBXkpL__v83KK-jcOyo7eW-VRUs,27793
 monoco/features/issue/domain/__init__.py,sha256=47DEQpj8HBSa-_TImW-5JCeuQeRkm5NMpJWZG3hSuFU,0
@@ -60,7 +60,7 @@ monoco/features/issue/domain/parser.py,sha256=axfB9BjY-m4DQqYwTQBm_38plOidZaDqFt
 monoco/features/issue/domain/workspace.py,sha256=nyTEFNmpLPuX7nssMCBiFI1XBhY9zbqG877Ppp_s0Fg,3658
 monoco/features/issue/engine/__init__.py,sha256=-SBvzjlZJz0O-IB1c95d9pbhr3lydJNLq2vhnfkZ8PQ,747
 monoco/features/issue/engine/config.py,sha256=7enjPW4J_fpuK08ov6LpfQ-9h2T1D4Hc5yIXOPuQvLs,5761
-monoco/features/issue/engine/machine.py,sha256=Bun_5jHlFRA7Duy7zG8f1GZIbZlPKt6C7RZ4vP7qJWc,7503
+monoco/features/issue/engine/machine.py,sha256=BTYjp8NQAzu8JVP95bQdkOLrJjFsRNR7uC8tjsUTqCk,6393
 monoco/features/issue/engine/models.py,sha256=595Sx3ncrpg_PhnbBLthohAvuhnjA-_9oXcrsT6Lv0k,574
 monoco/features/issue/lsp/__init__.py,sha256=8bl8-WzSj3C4SkPKgVGnCeyemmvHVWBsuMZsJuJggG8,77
 monoco/features/issue/lsp/definition.py,sha256=cF6Quw1OztuKMJ1zLvgA_ek7lTAdzHF0m4LVznpbAPw,3203
@@ -68,6 +68,9 @@ monoco/features/issue/resources/en/AGENTS.md,sha256=eHHXjLRDAV7IKrYPQSilxu0X5D0S
 monoco/features/issue/resources/en/SKILL.md,sha256=M5khTJdraQenX0tf7RHOVcqyKHC285qwDzWdsCJ7XPI,4032
 monoco/features/issue/resources/zh/AGENTS.md,sha256=oRHHqeDYx6aEc5FfdL7a-zqT7uh4SYIYt8QBRKEKrYM,1351
 monoco/features/issue/resources/zh/SKILL.md,sha256=XFE33cCCos0U1IVNkMhU7fGuqVqfxo_FNKdp1aScaoM,5055
+monoco/features/memo/__init__.py,sha256=ledMrs-h5k_4wssXWv4MBYTDi-HHo3Fv8QAMpqlQI_M,40
+monoco/features/memo/cli.py,sha256=nw5Kg7Qu33ucwrBaJS5CIkPRA_6TlJQQz2TvDWL2Nqc,2685
+monoco/features/memo/core.py,sha256=HUQLohVZ6KCU2chi18tEQYtohzl1-bOR5F12W40QkIc,2226
 monoco/features/scheduler/__init__.py,sha256=hvE9A14qFTeTYbWlK9iMRdXIFLMBuG8724GEZzFTHB8,483
 monoco/features/scheduler/cli.py,sha256=NgsGwCf615YA4VGd-mqMpGp5VCjdMUqoZqiHZFnDdLU,8325
 monoco/features/scheduler/config.py,sha256=69PTvKGHJ33fA2yhFJAq0WVq70Zbmdd5X8Wl0vIYAak,2336
@@ -76,7 +79,7 @@ monoco/features/scheduler/engines.py,sha256=ICKw4Kfme6UNl_JLJvT7hADKHo76Yr8wpFFE
 monoco/features/scheduler/manager.py,sha256=PmNKqfktgrdpUwE-jPE_WX3IvzZat0JKdEcmzse08-0,1680
 monoco/features/scheduler/models.py,sha256=rb8rx8t_TD5ilUC6xU3jvK0sud7YUZE_iEdes9Np8R0,877
 monoco/features/scheduler/reliability.py,sha256=zVwtnksug5wr0_tigC2Qjl_C8VNyrheN_34ItUceGoo,3846
-monoco/features/scheduler/session.py,sha256=V1xFXA65BaERhBwRYIecaye2TjDtFvAzuIy2gZ68ag8,2954
+monoco/features/scheduler/session.py,sha256=5xga191nWXqJOLgl3MTTJ3zDrVZcj8SxZcxYM6-CtLU,2969
 monoco/features/scheduler/worker.py,sha256=4OU2Y7nG5EKadNIKDF5GWl5V7vgVl3OPlYHShfiEeBI,4538
 monoco/features/skills/__init__.py,sha256=47DEQpj8HBSa-_TImW-5JCeuQeRkm5NMpJWZG3hSuFU,0
 monoco/features/skills/core.py,sha256=BXVvMot8E457-pj9U19lPHypBVhdLQRsx0zEAXJxpGY,3436
@@ -87,8 +90,8 @@ monoco/features/spike/resources/en/AGENTS.md,sha256=NG3CMnlDk_0J8hnRUcueAM9lgIQr
 monoco/features/spike/resources/en/SKILL.md,sha256=qKDcVh0D3pDRvfNLh1Bzo4oQU3obpl4tqdlzxeiWYMk,1911
 monoco/features/spike/resources/zh/AGENTS.md,sha256=5RHNl7fc3RdYYTFH483ojJl_arGPKkyYziOuGgFbqqg,290
 monoco/features/spike/resources/zh/SKILL.md,sha256=Q82e9lCQOAYIwBs5rGnvlVUDq7bp0pz8yvO10KTWFYQ,1710
-monoco_toolkit-0.3.5.dist-info/METADATA,sha256=UD0y77LYaDLy3ZoMUphV87XScSEg8G3kGxld1DhD8Wk,4732
-monoco_toolkit-0.3.5.dist-info/WHEEL,sha256=WLgqFyCfm_KASv4WHyYy0P3pM_m7J5L9k2skdKLirC8,87
-monoco_toolkit-0.3.5.dist-info/entry_points.txt,sha256=iYj7FWYBdtClU15-Du1skqD0s6SFSIhJvxJ29VWp8ng,43
-monoco_toolkit-0.3.5.dist-info/licenses/LICENSE,sha256=ACAGGjV6aod4eIlVUTx1q9PZbnZGN5bBwkSs9RHj83s,1071
-monoco_toolkit-0.3.5.dist-info/RECORD,,
+monoco_toolkit-0.3.6.dist-info/METADATA,sha256=UZH_Na2LgWBEQ8KWU084wgO8l9AK_HlTRc2YD58DT8o,4732
+monoco_toolkit-0.3.6.dist-info/WHEEL,sha256=WLgqFyCfm_KASv4WHyYy0P3pM_m7J5L9k2skdKLirC8,87
+monoco_toolkit-0.3.6.dist-info/entry_points.txt,sha256=iYj7FWYBdtClU15-Du1skqD0s6SFSIhJvxJ29VWp8ng,43
+monoco_toolkit-0.3.6.dist-info/licenses/LICENSE,sha256=ACAGGjV6aod4eIlVUTx1q9PZbnZGN5bBwkSs9RHj83s,1071
+monoco_toolkit-0.3.6.dist-info/RECORD,,