monoco-toolkit 0.2.5__py3-none-any.whl → 0.2.6__py3-none-any.whl

monoco/core/agent/adapters.py

@@ -21,6 +21,16 @@ class BaseCLIClient:
 
     def _build_prompt(self, prompt: str, context_files: List[Path]) -> str:
         """Concatenate prompt and context files."""
+        # Inject Language Rule
+        try:
+            from monoco.core.config import get_config
+            settings = get_config()
+            lang = settings.i18n.source_lang
+            if lang:
+                 prompt = f"{prompt}\n\n[SYSTEM: LANGUAGE CONSTRAINT]\nThe project source language is '{lang}'. You MUST use '{lang}' for all thinking and reporting unless explicitly instructed otherwise."
+        except Exception:
+            pass
+
         full_prompt = [prompt]
         if context_files:
             full_prompt.append("\n\n--- CONTEXT FILES ---")
@@ -93,10 +103,23 @@ class QwenClient(BaseCLIClient, AgentClient):
         return await self._run_command([self._executable, full_prompt])
 
 
+class KimiClient(BaseCLIClient, AgentClient):
+    """Adapter for Moonshot Kimi CLI."""
+    
+    def __init__(self):
+        super().__init__("kimi")
+
+    async def execute(self, prompt: str, context_files: List[Path] = []) -> str:
+        full_prompt = self._build_prompt(prompt, context_files)
+        # Usage: kimi "prompt"
+        return await self._run_command([self._executable, full_prompt])
+
+
 _ADAPTERS = {
     "gemini": GeminiClient,
     "claude": ClaudeClient,
-    "qwen": QwenClient
+    "qwen": QwenClient,
+    "kimi": KimiClient
 }
 
 def get_agent_client(name: str) -> AgentClient:

monoco/core/config.py

@@ -1,7 +1,7 @@
 import os
 import yaml
 from pathlib import Path
-from typing import Optional, Dict, Any, Callable, Awaitable
+from typing import Optional, Dict, Any, Callable, Awaitable, List
 from enum import Enum
 from pydantic import BaseModel, Field
 
@@ -56,6 +56,67 @@ class AgentConfig(BaseModel):
         description="Custom agent framework integrations (overrides defaults from monoco.core.integrations)"
     )
 
+class IssueTypeConfig(BaseModel):
+    name: str
+    label: str
+    prefix: str
+    folder: str
+    description: Optional[str] = None
+
+class TransitionConfig(BaseModel):
+    name: str
+    label: str
+    icon: Optional[str] = None
+    from_status: Optional[str] = None
+    from_stage: Optional[str] = None
+    to_status: str
+    to_stage: Optional[str] = None
+    required_solution: Optional[str] = None
+    description: str = ""
+    command_template: Optional[str] = None
+
+class IssueSchemaConfig(BaseModel):
+    types: List[IssueTypeConfig] = Field(default_factory=list)
+    statuses: List[str] = Field(default_factory=list)
+    stages: List[str] = Field(default_factory=list)
+    solutions: List[str] = Field(default_factory=list)
+    workflows: List[TransitionConfig] = Field(default_factory=list)
+
+    def merge(self, other: "IssueSchemaConfig") -> "IssueSchemaConfig":
+        if not other:
+            return self
+        
+        # Types: merge by name
+        if other.types:
+            type_map = {t.name: t for t in self.types}
+            for ot in other.types:
+                type_map[ot.name] = ot
+            self.types = list(type_map.values())
+        
+        # Statuses: replace if provided
+        if other.statuses:
+            self.statuses = other.statuses
+        
+        # Stages: replace if provided
+        if other.stages:
+            self.stages = other.stages
+            
+        # Solutions: replace if provided
+        if other.solutions:
+            self.solutions = other.solutions
+            
+        # Workflows (Transitions): merge by name
+        if other.workflows:
+            wf_map = {w.name: w for w in self.workflows}
+            for ow in other.workflows:
+                wf_map[ow.name] = ow
+            self.workflows = list(wf_map.values())
+                
+        return self
+
+class StateMachineConfig(BaseModel):
+    transitions: List[TransitionConfig]
+
 class MonocoConfig(BaseModel):
     """
     Main Configuration Schema.
@@ -68,6 +129,7 @@ class MonocoConfig(BaseModel):
     ui: UIConfig = Field(default_factory=UIConfig)
     telemetry: TelemetryConfig = Field(default_factory=TelemetryConfig)
     agent: AgentConfig = Field(default_factory=AgentConfig)
+    issue: IssueSchemaConfig = Field(default_factory=IssueSchemaConfig)
 
     @staticmethod
     def _deep_merge(base: Dict[str, Any], update: Dict[str, Any]) -> Dict[str, Any]:

monoco/core/integrations.py

@@ -110,6 +110,14 @@ DEFAULT_INTEGRATIONS: Dict[str, AgentIntegration] = {
         bin_name="qwen",
         version_cmd="--version",
     ),
+    "kimi": AgentIntegration(
+        key="kimi",
+        name="Kimi CLI",
+        system_prompt_file="KIMI.md",
+        skill_root_dir=".kimi/skills/",
+        bin_name="kimi",
+        version_cmd="--version",
+    ),
     "agent": AgentIntegration(
         key="agent",
         name="Antigravity",

monoco/core/lsp.py

@@ -24,6 +24,13 @@ class Range(BaseModel):
     def __repr__(self):
         return f"{self.start.line}:{self.start.character}-{self.end.line}:{self.end.character}"
 
+class Location(BaseModel):
+    """
+    Represents a location inside a resource, such as a line of code inside a text file.
+    """
+    uri: str
+    range: Range
+
 class DiagnosticSeverity(IntEnum):
     Error = 1
     Warning = 2

monoco/core/output.py

@@ -63,8 +63,15 @@ class OutputManager:
             print(json.dumps([item.model_dump(mode='json', exclude_none=True) for item in data], separators=(',', ':')))
         else:
             # Fallback for dicts/lists/primitives
+            def _encoder(obj):
+                if isinstance(obj, BaseModel):
+                    return obj.model_dump(mode='json', exclude_none=True)
+                if hasattr(obj, 'value'): # Enum support
+                     return obj.value
+                return str(obj)
+
             try:
-                print(json.dumps(data, separators=(',', ':'), default=str))
+                print(json.dumps(data, separators=(',', ':'), default=_encoder))
             except TypeError:
                 print(str(data))
 

monoco/core/setup.py

@@ -258,6 +258,14 @@ def init_cli(
     (cwd / "Issues").mkdir(exist_ok=True)
     (cwd / ".references").mkdir(exist_ok=True)
     
+    # Initialize Agent Resources
+    try:
+        from monoco.features.agent.core import init_agent_resources
+        init_agent_resources(cwd)
+        console.print(f"[dim]  - Agent Resources: .monoco/actions/*.prompty[/dim]")
+    except Exception as e:
+        console.print(f"[yellow]Warning: Failed to init agent resources: {e}[/yellow]")
+
     console.print("\n[bold green]✓ Monoco Project Initialized![/bold green]")
     console.print(f"Access configured! issues will be created as [bold]{project_key}-XXX[/bold]")
 

monoco/features/agent/commands.py

@@ -12,6 +12,8 @@ import re
 import json as j
 
 app = typer.Typer()
+action_app = typer.Typer(name="action", help="Manage generic agent actions/prompts.")
+app.add_typer(action_app)
 
 @app.command(name="run")
 def run_command(
@@ -100,8 +102,8 @@ def run_command(
         print_error(f"Execution failed: {e}")
         raise typer.Exit(1)
 
-@app.command()
-def list(
+@action_app.command(name="list")
+def action_list(
     json: AgentOutput = False,
     context: Optional[str] = typer.Option(None, "--context", help="Context for filtering (JSON string)")
 ):
@@ -118,9 +120,59 @@ def list(
             print_error(f"Invalid context JSON: {e}")
 
     actions = registry.list_available(action_context)
+    
+    # Filter by State Machine if context implies an Issue
+    if action_context and (action_context.status or action_context.stage):
+        try:
+            from monoco.features.issue.engine.machine import StateMachine
+            from monoco.features.issue.models import IssueMetadata
+            
+            cfg = settings.issue
+            sm = StateMachine(cfg)
+            
+            # Create a mock metadata for state check
+            mock_meta = IssueMetadata(
+                id="mock-id",
+                title="Mock Issue",
+                type=action_context.type or "feature",
+                status=action_context.status or "open",
+                stage=action_context.stage
+            )
+            
+            allowed_transitions = sm.get_available_transitions(mock_meta)
+            allowed_names = {t.name for t in allowed_transitions}
+            
+            # Identify which actions are actually transitions
+            all_transition_names = {t.name for t in cfg.workflows}
+            
+            filtered_actions = []
+            for action in actions:
+                # If an action is a formal transition, it must be allowed
+                if action.name in all_transition_names:
+                    if action.name in allowed_names:
+                        filtered_actions.append(action)
+                else:
+                    # Generic actions are passed through (already filtered by 'when')
+                    filtered_actions.append(action)
+            
+            actions = filtered_actions
+
+        except Exception:
+            # Fallback if Issue feature is missing or context is invalid
+            pass
+
     # OutputManager handles list of Pydantic models automatically for both JSON and Table
     print_output(actions, title="Available Actions")
 
+@app.command(name="list")
+def list_providers(
+    json: AgentOutput = False,
+    force: bool = typer.Option(False, "--force", "-f", help="Force refresh of agent state")
+):
+    """List available agent providers and their status."""
+    # Reuse status logic
+    status(json=json, force=force)
+
 @app.command()
 def status(
     json: AgentOutput = False,
@@ -164,3 +216,22 @@ def doctor(
     """
     from monoco.features.agent.doctor import doctor as doc_impl
     doc_impl(force)
+
+@app.command()
+def init(
+    force: bool = typer.Option(False, "--force", "-f", help="Force overwrite existing resources")
+):
+    """
+    Initialize Agent Resources (prompts) in the current project.
+    """
+    settings = get_config()
+    root = Path(settings.paths.root)
+    
+    from monoco.features.agent.core import init_agent_resources
+    # TODO: Pass force arg when supported by core
+    init_agent_resources(root)
+    
+    if OutputManager.is_agent_mode():
+        OutputManager.print({"status": "initialized"})
+    else:
+        print(f"Agent resources initialized in {root}")

monoco/features/agent/core.py

@@ -0,0 +1,48 @@
+import shutil
+import os
+from pathlib import Path
+from typing import List
+try:
+    from importlib.resources import files
+except ImportError:
+    # Fallback for python < 3.9
+    from importlib_resources import files
+
+def init_agent_resources(project_root: Path):
+    """
+    Initialize Agent resources (prompts) in the project workspace.
+    """
+    actions_dir = project_root / ".monoco" / "actions"
+    actions_dir.mkdir(parents=True, exist_ok=True)
+    
+    # Determine language from config, default to 'en'
+    # We need to load config to know the language. 
+    # But this function might be called before full config load?
+    # Helper to peek at config or default to 'en'
+    from monoco.core.config import get_config
+    try:
+        settings = get_config(str(project_root), require_project=False) # Best effort
+        lang = settings.core.language or "en"
+    except Exception:
+        lang = "en"
+
+    # Define source path relative to this module
+    try:
+        current_dir = Path(__file__).parent
+        
+        # Try specific language, fallback to 'en'
+        source_dir = current_dir / "resources" / lang
+        if not source_dir.exists():
+             source_dir = current_dir / "resources" / "en"
+        
+        if source_dir.exists():
+            for item in source_dir.glob("*.prompty"):
+                target = actions_dir / item.name
+                # Copy if not exists, or overwrite? 
+                # Ideally init should be safe to run multiple times (idempotent)
+                # But user might have customized them.
+                if not target.exists():
+                     shutil.copy2(item, target)
+    except Exception as e:
+        # Fallback or Log?
+        pass

monoco/features/agent/resources/en/critique.prompty

@@ -0,0 +1,16 @@
+---
+name: critique
+description: Critique the code or design against requirements.
+provider: chat
+---
+You are a Principal Code Reviewer.
+Your task is to critique the following implementation/design:
+
+{{file}}
+
+# Instructions
+1. **Gap Analysis**: Check if all Acceptance Criteria are met.
+2. **Code Quality**: Identify potential bugs, security issues, or performance bottlenecks.
+3. **Design Patterns**: Suggest better patterns if applicable.
+
+Output a structured review.

monoco/features/agent/resources/en/develop.prompty

@@ -0,0 +1,16 @@
+---
+name: develop
+description: 执行核心开发任务：编码与单元测试。
+provider: chat
+---
+You are a Principal Software Engineer.
+Your task is to implement the feature described in this Issue:
+
+{{file}}
+
+# Instructions
+1.  **Implementation**: Write the code required to satisfy the Acceptance Criteria.
+2.  **Unit Tests**: Add or update unit tests to verify your changes.
+3.  **Linting**: Ensure code follows project style guidelines.
+
+Please provide the code changes.

monoco/features/agent/resources/en/investigate.prompty

@@ -0,0 +1,16 @@
+---
+name: investigate
+description: 扫描 Codebase，识别架构设计、业务约束，丰富 Issue 引用网络。
+provider: chat
+---
+You are a Senior Software Architect.
+Your task is to investigate the feasibility and impact of the following Issue:
+
+{{file}}
+
+# Instructions
+1.  **Architecture Scan**: Identify which modules/files need to be modified.
+2.  **Dependency Analysis**: Suggest `parent`, `dependencies`, and `related` issues.
+3.  **Constraint Check**: Identify any business rules or technical constraints (e.g., Billing module impact).
+
+Output your findings as a comment or update the Issue description directly.

monoco/features/agent/resources/en/refine.prompty

@@ -0,0 +1,14 @@
+---
+name: refine
+description: 细化需求，将 Draft 转化为可执行的 Plan。
+provider: chat
+---
+You are a Product Owner / Systems Analyst.
+Refine the following Draft Issue into a concrete Technical Plan:
+
+{{file}}
+
+# Instructions
+1.  **Clarify Objective**: Ensure the goal is specific and standard.
+2.  **Expand Criteria**: Add detailed Acceptance Criteria.
+3.  **Breakdown Tasks**: List concrete Technical Tasks.

monoco/features/agent/resources/en/verify.prompty

@@ -0,0 +1,16 @@
+---
+name: verify
+description: 代为检查工单完整性、代码质量与逻辑一致性。
+provider: chat
+---
+You are a QA Lead / Release Manager.
+Your task is to verify if the following Issue is ready for delivery:
+
+{{file}}
+
+# Instructions
+1.  **Definition of Done**: Check if all Technical Tasks are checked and Acceptance Criteria met.
+2.  **Quality Check**: Review the code changes (if provided in context) for bugs or antipatterns.
+3.  **Completeness**: Ensure documentation and tests are present.
+
+Output "PASS" if ready, or a list of "BLOCKERS" if not.

monoco/features/agent/resources/zh/critique.prompty

@@ -0,0 +1,18 @@
+---
+name: critique
+description: 对当前实现或设计进行批判性审查。
+provider: chat
+when:
+  stageMatch: "review"
+---
+你是一位首席代码审查员。
+你的任务是对以下实现/设计进行批判性审查：
+
+{{file}}
+
+# 指令
+1. **差距分析**: 检查是否满足所有验收标准。
+2. **代码质量**: 识别潜在的 Bug、安全问题或性能瓶颈。
+3. **设计模式**: 如果适用，建议更好的设计模式。
+
+输出结构化的审查意见。

monoco/features/agent/resources/zh/develop.prompty

@@ -0,0 +1,18 @@
+---
+name: develop
+description: 执行核心开发任务：编码与单元测试。
+provider: chat
+when:
+  stageMatch: "doing"
+---
+你是一位首席软件工程师。
+你的任务是实现此 Issue 中描述的功能：
+
+{{file}}
+
+# 指令
+1.  **代码实现**: 编写满足验收标准所需的代码。
+2.  **单元测试**: 添加或更新单元测试以验证你的更改。
+3.  **代码规范**: 确保代码遵循项目风格指南 (Linting)。
+
+请提供代码变更。

monoco/features/agent/resources/zh/investigate.prompty

@@ -0,0 +1,18 @@
+---
+name: investigate
+description: 扫描代码库，识别架构设计、业务约束，丰富 Issue 引用网络。
+provider: chat
+when:
+  statusMatch: "open"
+---
+你是一位资深软件架构师。
+你的任务是调查以下 Issue 的可行性和影响：
+
+{{file}}
+
+# 指令
+1.  **架构扫描**: 识别哪些模块/文件需要修改。
+2.  **依赖分析**: 建议 `parent` (父级), `dependencies` (依赖), 和 `related` (相关) 议题。
+3.  **约束检查**: 识别任何业务规则或技术约束（例如，即使很小的改动也可能影响计费模块）。
+
+请以评论形式输出你的发现，或直接更新 Issue 描述。

monoco/features/agent/resources/zh/refine.prompty

@@ -0,0 +1,16 @@
+---
+name: refine
+description: 细化需求，将 Draft 转化为可执行的 Plan。
+provider: chat
+when:
+  stageMatch: "draft"
+---
+你是一位产品负责人 (PO) / 系统分析师。
+将以下草案 (Draft) Issue 细化为具体的技术计划：
+
+{{file}}
+
+# 指令
+1.  **阐明目标**: 确保目标具体且标准。
+2.  **扩展标准**: 添加详细的验收标准 (Acceptance Criteria)。
+3.  **任务分解**: 列出具体的技术任务 (Technical Tasks)。

monoco/features/agent/resources/zh/verify.prompty

@@ -0,0 +1,18 @@
+---
+name: verify
+description: 代为检查工单完整性、代码质量与逻辑一致性。
+provider: chat
+when:
+  stageMatch: "review|done"
+---
+你是一位 QA 负责人 / 发布经理。
+你的任务是验证以下 Issue 是否已准备好交付：
+
+{{file}}
+
+# 指令
+1.  **完成定义 (DoD)**: 检查是否所有技术任务 (Technical Tasks) 都已勾选，且满足验收标准。
+2.  **质量检查**: 审查代码变更（如果在上下文中提供了），查找 Bug 或反模式。
+3.  **完整性**: 确保文档和测试都已存在。
+
+如果准备好了，输出 "PASS"；否则列出 "BLOCKERS" (阻碍项)。