monoco-toolkit 0.3.10__py3-none-any.whl → 0.3.11__py3-none-any.whl

monoco/features/memo/cli.py

@@ -4,7 +4,7 @@ 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, delete_memo, get_inbox_path, validate_content_language
+from .core import add_memo, load_memos, delete_memo, update_memo, get_inbox_path, validate_content_language
 
 app = typer.Typer(help="Manage memos (fleeting notes).")
 console = Console()
@@ -26,6 +26,12 @@ def add_command(
     context: Optional[str] = typer.Option(
         None, "--context", "-c", help="Context reference (e.g. file:line)."
     ),
+    type: str = typer.Option(
+        "insight", "--type", "-t", help="Type of memo (insight, bug, feature, task)."
+    ),
+    source: str = typer.Option(
+        "cli", "--source", "-s", help="Source of the memo."
+    ),
     force: bool = typer.Option(
         False, "--force", "-f", help="Bypass i18n language validation."
     ),
@@ -47,36 +53,75 @@ def add_command(
         )
         raise typer.Exit(code=1)
 
-    uid = add_memo(issues_root, content, context)
+    # TODO: Get actual user name if possible
+    author = "User" 
+    
+    uid = add_memo(
+        issues_root, 
+        content, 
+        context=context,
+        author=author,
+        source=source,
+        memo_type=type
+    )
 
     console.print(f"[green]✔ Memo recorded.[/green] ID: [bold]{uid}[/bold]")
 
 
 @app.command("list")
-def list_command():
+def list_command(
+    status: Optional[str] = typer.Option(None, "--status", help="Filter by status (pending, tracked, resolved)."),
+    limit: int = typer.Option(None, "--limit", "-n", help="Limit number of memos shown.")
+):
     """
     List all memos in the inbox.
     """
     issues_root = get_issues_root()
 
-    memos = list_memos(issues_root)
+    memos = load_memos(issues_root)
+    
+    if status:
+        memos = [m for m in memos if m.status == status]
 
     if not memos:
-        console.print("No memos found. Use `monoco memo add` to create one.")
+        console.print("No memos found.")
         return
+        
+    # Reverse sort by timestamp (newest first) usually? 
+    # But file is appended. Let's show newest at bottom (log style) or newest at top?
+    # Usually list shows content. Newest at bottom is standard for logs, but for "Inbox" maybe newest top?
+    # Let's keep file order (oldest first) unless user asks otherwise, or maybe reverse it for "Inbox" feel?
+    # Let's reverse it to see latest first.
+    memos.reverse()
+    
+    if limit:
+        memos = memos[:limit]
 
     table = Table(title="Memo Inbox")
     table.add_column("ID", style="cyan", no_wrap=True)
-    table.add_column("Timestamp", style="magenta")
+    table.add_column("Stat", style="yellow", width=4)
+    table.add_column("Type", style="magenta", width=8)
+    table.add_column("Ref", style="blue")
     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 = memo.content.split("\n")[0]
+        if len(content_preview) > 50:
             content_preview = content_preview[:47] + "..."
-
-        table.add_row(memo["id"], memo["timestamp"], content_preview)
+            
+        status_icon = " "
+        if memo.status == "pending": status_icon = "P"
+        elif memo.status == "tracked": status_icon = "T"
+        elif memo.status == "resolved": status_icon = "✔"
+        
+        table.add_row(
+            memo.uid, 
+            status_icon,
+            memo.type,
+            memo.ref or "",
+            content_preview
+        )
 
     console.print(table)
 
@@ -110,3 +155,51 @@ def delete_command(
     else:
         console.print(f"[red]Error: Memo with ID [bold]{memo_id}[/bold] not found.[/red]")
         raise typer.Exit(code=1)
+
+
+@app.command("link")
+def link_command(
+    memo_id: str = typer.Argument(..., help="Memo ID"),
+    issue_id: str = typer.Argument(..., help="Issue ID to link to")
+):
+    """
+    Link a memo to an issue (Traceability).
+    Sets status to 'tracked'.
+    """
+    issues_root = get_issues_root()
+    
+    updates = {
+        "status": "tracked",
+        "ref": issue_id
+    }
+    
+    if update_memo(issues_root, memo_id, updates):
+        console.print(f"[green]✔ Memo {memo_id} linked to {issue_id}.[/green]")
+    else:
+        console.print(f"[red]Error: Memo {memo_id} not found.[/red]")
+        raise typer.Exit(code=1)
+
+
+@app.command("resolve")
+def resolve_command(
+    memo_id: str = typer.Argument(..., help="Memo ID")
+):
+    """
+    Mark a memo as resolved.
+    """
+    issues_root = get_issues_root()
+    
+    updates = {
+        "status": "resolved"
+    }
+    
+    if update_memo(issues_root, memo_id, updates):
+        console.print(f"[green]✔ Memo {memo_id} resolved.[/green]")
+    else:
+        console.print(f"[red]Error: Memo {memo_id} not found.[/red]")
+        raise typer.Exit(code=1)
+
+
+
+
+

monoco/features/memo/core.py

@@ -1,9 +1,10 @@
 import re
 from pathlib import Path
-from datetime import datetime
-from typing import List, Dict, Optional
+from typing import List, Optional, Any
 import secrets
+from datetime import datetime
 
+from .models import Memo
 
 def is_chinese(text: str) -> bool:
     """Check if the text contains at least one Chinese character."""
@@ -18,7 +19,6 @@ def validate_content_language(content: str, source_lang: str) -> bool:
     if source_lang == "zh":
         return is_chinese(content)
     # For 'en', we generally allow everything but could be more strict.
-    # Requirement is mainly about enforcing 'zh' when configured.
     return True
 
 
@@ -27,120 +27,206 @@ 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:
+def parse_memo_block(block: str) -> Optional[Memo]:
     """
-    Append a memo to the inbox.
-    Returns the generated UID.
+    Parse a text block into a Memo object.
+    Block format:
+    ## [uid] YYYY-MM-DD HH:MM:SS
+    - **Key**: Value
+    ...
+    Content
     """
-    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]]:
+    lines = block.strip().split("\n")
+    if not lines:
+        return None
+        
+    header = lines[0]
+    match = re.match(r"^## \[([a-f0-9]+)\] (.*?)$", header)
+    if not match:
+        return None
+        
+    uid = match.group(1)
+    ts_str = match.group(2)
+    try:
+        timestamp = datetime.strptime(ts_str, "%Y-%m-%d %H:%M:%S")
+    except ValueError:
+        timestamp = datetime.now() # Fallback
+
+    content_lines = []
+    metadata = {}
+    
+    # Simple state machine
+    # 0: Header (done)
+    # 1: Metadata
+    # 2: Content
+    
+    state = 1
+    
+    for line in lines[1:]:
+        stripped = line.strip()
+        if state == 1:
+            if not stripped:
+                continue
+            # Check for metadata line: - **Key**: Value
+            meta_match = re.match(r"^\- \*\*([a-zA-Z]+)\*\*: (.*)$", stripped)
+            if meta_match:
+                key = meta_match.group(1).lower()
+                val = meta_match.group(2).strip()
+                metadata[key] = val
+            else:
+                # First non-metadata line marks start of content
+                state = 2
+                content_lines.append(line)
+        elif state == 2:
+            content_lines.append(line)
+            
+    content = "\n".join(content_lines).strip()
+    
+    # Map metadata to model fields
+    # Status map reverse
+    status_raw = metadata.get("status", "[ ] Pending")
+    status = "pending"
+    if "[x] Tracked" in status_raw:
+        status = "tracked"
+    elif "[x] Resolved" in status_raw:
+        status = "resolved"
+    elif "[-] Dismissed" in status_raw:
+        status = "dismissed"
+        
+    return Memo(
+        uid=uid,
+        timestamp=timestamp,
+        content=content,
+        author=metadata.get("from", "User"),
+        source=metadata.get("source", "cli"),
+        type=metadata.get("type", "insight"),
+        status=status,
+        ref=metadata.get("ref"),
+        context=metadata.get("context") # Note: context might need cleanup if it was wrapped in code blocks
+    )
+
+def load_memos(issues_root: Path) -> List[Memo]:
     """
-    Parse memos from inbox.
+    Parse all 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)
-
+    
+    # Split by headers: ## [uid]
+    # We use a lookahead or just standard split carefully
+    parts = re.split(r"(^## \[)", content, flags=re.MULTILINE)[1:] # Skip preamble
+    
+    # parts will be like: ['## [', 'abc] 2023...\n...', '## [', 'def] ...']
+    # Reassemble pairs
+    blocks = []
+    for i in range(0, len(parts), 2):
+        if i+1 < len(parts):
+            blocks.append(parts[i] + parts[i+1])
+            
     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})
-
+    for block in blocks:
+        memo = parse_memo_block(block)
+        if memo:
+            memos.append(memo)
+            
+    # Sort by timestamp desc? Or keep file order? File order is usually append (time asc).
     return memos
 
-
-def delete_memo(issues_root: Path, memo_id: str) -> bool:
+def save_memos(issues_root: Path, memos: List[Memo]) -> None:
     """
-    Delete a memo by its ID.
-    Returns True if deleted, False if not found.
+    Rewrite the inbox file with the given list of memos.
+    """
+    inbox_path = get_inbox_path(issues_root)
+    
+    # Header
+    lines = ["# Monoco Memos Inbox", ""]
+    
+    for memo in memos:
+        lines.append(memo.to_markdown().strip())
+        lines.append("") # Spacer
+        
+    inbox_path.write_text("\n".join(lines), encoding="utf-8")
+
+
+def add_memo(
+    issues_root: Path, 
+    content: str, 
+    context: Optional[str] = None,
+    author: str = "User",
+    source: str = "cli",
+    memo_type: str = "insight"
+) -> str:
+    """
+    Append a memo to the inbox.
+    Returns the generated UID.
     """
+    uid = generate_memo_id()
+    memo = Memo(
+        uid=uid,
+        content=content,
+        context=context,
+        author=author,
+        source=source,
+        type=memo_type
+    )
+    
+    # Append mode is more robust against concurrent reads than rewrite, 
+    # but for consistent formatting we might want to just append string.
     inbox_path = get_inbox_path(issues_root)
+    
     if not inbox_path.exists():
-        return False
-
-    content = inbox_path.read_text(encoding="utf-8")
-    pattern = re.compile(r"^## \[([a-f0-9]+)\] (.*?)$", re.MULTILINE)
+        inbox_path.parent.mkdir(parents=True, exist_ok=True)
+        inbox_path.write_text("# Monoco Memos Inbox\n\n", encoding="utf-8")
+        
+    with inbox_path.open("a", encoding="utf-8") as f:
+        f.write("\n" + memo.to_markdown().strip() + "\n")
+        
+    return uid
 
-    matches = list(pattern.finditer(content))
-    target_idx = -1
-    for i, m in enumerate(matches):
-        if m.group(1) == memo_id:
-            target_idx = i
+def update_memo(issues_root: Path, memo_id: str, updates: dict) -> bool:
+    """
+    Update a memo's fields.
+    """
+    memos = load_memos(issues_root)
+    found = False
+    for i, m in enumerate(memos):
+        if m.uid == memo_id:
+            # Apply updates
+            updated_data = m.model_dump()
+            updated_data.update(updates)
+            memos[i] = Memo(**updated_data) # Re-validate
+            found = True
             break
+            
+    if found:
+        save_memos(issues_root, memos)
+        
+    return found
 
-    if target_idx == -1:
-        return False
-
-    # Find boundaries
-    start = matches[target_idx].start()
-    # Include the potential newline before the header if it exists
-    if start > 0 and content[start - 1] == "\n":
-        start -= 1
-
-    if target_idx + 1 < len(matches):
-        end = matches[target_idx + 1].start()
-        # Back up if there's a newline before the next header that we should keep?
-        # Actually, if we delete a memo, we should probably remove one "entry block".
-        # Entry blocks are format_memo: \n## header\nbody\n
-        # So we want to remove the leading \n and the trailing parts.
-    else:
-        end = len(content)
-
-    new_content = content[:start] + content[end:]
-    inbox_path.write_text(new_content, encoding="utf-8")
-    return True
+def delete_memo(issues_root: Path, memo_id: str) -> bool:
+    """
+    Delete a memo by its ID.
+    """
+    memos = load_memos(issues_root)
+    initial_count = len(memos)
+    memos = [m for m in memos if m.uid != memo_id]
+    
+    if len(memos) < initial_count:
+        save_memos(issues_root, memos)
+        return True
+    return False
+
+# Compatibility shim
+list_memos = load_memos

monoco/features/memo/models.py

@@ -0,0 +1,53 @@
+from datetime import datetime
+from typing import Optional, Literal
+from pydantic import BaseModel, Field
+
+class Memo(BaseModel):
+    uid: str
+    content: str
+    timestamp: datetime = Field(default_factory=datetime.now)
+    
+    # Optional Context
+    context: Optional[str] = None
+    
+    # New Metadata Fields
+    author: str = "User"  # User, Assistant, or specific Agent Name
+    source: str = "cli"   # cli, agent, mailroom, etc.
+    status: Literal["pending", "tracked", "resolved", "dismissed"] = "pending"
+    ref: Optional[str] = None  # Linked Issue ID or other reference
+    type: Literal["insight", "bug", "feature", "task"] = "insight"
+    
+    def to_markdown(self) -> str:
+        """
+        Render the memo to Markdown format.
+        """
+        ts_str = self.timestamp.strftime("%Y-%m-%d %H:%M:%S")
+        header = f"## [{self.uid}] {ts_str}"
+        
+        # Metadata block
+        meta = []
+        if self.author != "User":
+            meta.append(f"- **From**: {self.author}")
+        if self.source != "cli":
+            meta.append(f"- **Source**: {self.source}")
+        if self.type != "insight":
+             meta.append(f"- **Type**: {self.type}")
+        
+        # Status line with checkbox simulation
+        status_map = {
+            "pending": "[ ] Pending",
+            "tracked": "[x] Tracked",
+            "resolved": "[x] Resolved",
+            "dismissed": "[-] Dismissed"
+        }
+        meta.append(f"- **Status**: {status_map.get(self.status, '[ ] Pending')}")
+        
+        if self.ref:
+            meta.append(f"- **Ref**: {self.ref}")
+            
+        if self.context:
+            meta.append(f"- **Context**: `{self.context}`")
+            
+        meta_block = "\n".join(meta)
+        
+        return f"\n{header}\n{meta_block}\n\n{self.content.strip()}\n"

monoco/features/memo/resources/en/skills/{monoco_memo → monoco_atom_memo}/SKILL.md

@@ -1,7 +1,7 @@
 ---
-name: monoco-memo
+name: monoco_atom_memo
 description: Lightweight memo system for quickly recording ideas, inspirations, and temporary notes. Distinguished from the formal Issue system.
-type: standard
+type: atom
 version: 1.0.0
 ---
 

monoco/features/memo/resources/en/skills/{note_processing_workflow → monoco_workflow_note_processing}/SKILL.md

@@ -1,7 +1,7 @@
 ---
-name: note-processing-workflow
+name: monoco_workflow_note_processing
 description: Memo Note Processing Workflow (Flow Skill). Defines the standard operational process from capturing fleeting notes to organizing and archiving, ensuring effective management of ideas.
-type: flow
+type: workflow
 domain: memo
 version: 1.0.0
 ---

monoco/features/memo/resources/zh/skills/{monoco_memo → monoco_atom_memo}/SKILL.md

@@ -1,7 +1,7 @@
 ---
-name: monoco-memo
+name: monoco_atom_memo
 description: 轻量级备忘录系统，用于快速记录想法、灵感和临时笔记。与正式的 Issue 系统区分开来。
-type: standard
+type: atom
 version: 1.0.0
 ---
 

monoco/features/memo/resources/zh/skills/{note_processing_workflow → monoco_workflow_note_processing}/SKILL.md

@@ -1,7 +1,7 @@
 ---
-name: note-processing-workflow
+name: monoco_workflow_note_processing
 description: Memo 笔记处理工作流 (Flow Skill)。定义从捕获 fleeting notes 到组织归档的标准操作流程，确保想法有效管理。
-type: flow
+type: workflow
 domain: memo
 version: 1.0.0
 ---

monoco/features/spike/adapter.py

@@ -1,19 +1,32 @@
 from pathlib import Path
 from typing import Dict
-from monoco.core.feature import MonocoFeature, IntegrationData
+from monoco.core.loader import FeatureModule, FeatureMetadata
+from monoco.core.feature import IntegrationData
 from monoco.features.spike import core
 
 
-class SpikeFeature(MonocoFeature):
+class SpikeFeature(FeatureModule):
+    """Spike (research) feature module with unified lifecycle support."""
+
     @property
-    def name(self) -> str:
-        return "spike"
+    def metadata(self) -> FeatureMetadata:
+        return FeatureMetadata(
+            name="spike",
+            version="1.0.0",
+            description="Research spike management for external references",
+            dependencies=["core"],
+            priority=30,
+        )
 
-    def initialize(self, root: Path, config: Dict) -> None:
+    def _on_mount(self, context: "FeatureContext") -> None:  # type: ignore
+        """Initialize spike feature with workspace context."""
+        root = context.root
+        config = context.config
         spikes_name = config.get("paths", {}).get("spikes", ".references")
         core.init(root, spikes_name)
 
     def integrate(self, root: Path, config: Dict) -> IntegrationData:
+        """Provide integration data for agent environment."""
         # Determine language from config, default to 'en'
         lang = config.get("i18n", {}).get("source_lang", "en")
         base_dir = Path(__file__).parent / "resources"

monoco/features/spike/resources/en/skills/{monoco_spike → monoco_atom_spike}/SKILL.md

@@ -1,7 +1,7 @@
 ---
-name: monoco-spike
+name: monoco_atom_spike
 description: Manage external reference repositories for research and learning. Provides read-only access to curated codebases.
-type: standard
+type: atom
 version: 1.0.0
 ---
 

monoco/features/spike/resources/en/skills/{research_workflow → monoco_workflow_research}/SKILL.md

@@ -1,7 +1,7 @@
 ---
-name: research-workflow
+name: monoco_workflow_research
 description: Spike Research Workflow (Flow Skill). Defines the standard operational process from adding external repositories to knowledge extraction and archiving, ensuring effective management of external knowledge.
-type: flow
+type: workflow
 domain: spike
 version: 1.0.0
 ---

monoco/features/spike/resources/zh/skills/{monoco_spike → monoco_atom_spike}/SKILL.md

@@ -1,7 +1,7 @@
 ---
-name: monoco-spike
+name: monoco_atom_spike
 description: 管理用于研究和学习的外部参考仓库。提供对精选代码库的只读访问。
-type: standard
+type: atom
 version: 1.0.0
 ---
 

monoco/features/spike/resources/zh/skills/{research_workflow → monoco_workflow_research}/SKILL.md

@@ -1,7 +1,7 @@
 ---
-name: research-workflow
+name: monoco_workflow_research
 description: Spike 研究工作流 (Flow Skill)。定义从添加外部仓库到知识提取和归档的标准操作流程，确保外部知识有效管理。
-type: flow
+type: workflow
 domain: spike
 version: 1.0.0
 ---