monoco-toolkit 0.2.5__py3-none-any.whl → 0.2.7__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
 
@@ -10,7 +10,7 @@ import asyncio
 from watchdog.observers import Observer
 from watchdog.events import FileSystemEventHandler
 
-from monoco.core.integrations import AgentIntegration
+
 
 logger = logging.getLogger("monoco.core.config")
 
@@ -46,15 +46,68 @@ class TelemetryConfig(BaseModel):
     """Configuration for Telemetry."""
     enabled: Optional[bool] = Field(default=None, description="Whether telemetry is enabled")
 
-class AgentConfig(BaseModel):
-    """Configuration for Agent Environment Integration."""
-    targets: Optional[list[str]] = Field(default=None, description="Specific target files to inject into (e.g. .cursorrules)")
-    framework: Optional[str] = Field(default=None, description="Manually specified agent framework (cursor, windsurf, etc.)")
-    includes: Optional[list[str]] = Field(default=None, description="List of specific features to include in injection")
-    integrations: Optional[Dict[str, "AgentIntegration"]] = Field(
-        default=None, 
-        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):
     """
@@ -67,7 +120,8 @@ class MonocoConfig(BaseModel):
     i18n: I18nConfig = Field(default_factory=I18nConfig)
     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]:
@@ -179,15 +233,21 @@ def get_config_path(scope: ConfigScope, project_root: Optional[str] = None) -> P
         return cwd / ".monoco" / "project.yaml"
 
 def find_monoco_root(start_path: Optional[Path] = None) -> Path:
-    """Recursively find the .monoco directory upwards."""
+    """
+    Find the Monoco Workspace root.
+    Strictly restricted to checking the current directory (or its parent if CWD is .monoco).
+    Recursive upward lookup is disabled per FIX-0009.
+    """
     current = (start_path or Path.cwd()).resolve()
-    # Check if we are inside a .monoco folder (unlikely but possible)
+    
+    # Check if we are inside a .monoco folder
     if current.name == ".monoco":
         return current.parent
         
-    for parent in [current] + list(current.parents):
-        if (parent / ".monoco").exists():
-            return parent
+    # Check if current directory has .monoco
+    if (current / ".monoco").exists():
+        return current
+        
     return current
 
 def load_raw_config(scope: ConfigScope, project_root: Optional[str] = None) -> 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/resources/zh/SKILL.md

@@ -9,11 +9,11 @@ Monoco Toolkit 的核心功能和命令。
 
 ## 概述
 
-Monoco 是一个开发者生产力工具包，提供：
+Monoco 是一个开发者生产力工具包，提供:
 
-- **项目初始化**：标准化的项目结构
-- **配置管理**：全局和项目级别的配置
-- **工作空间管理**：多项目设置
+- **项目初始化**: 标准化的项目结构
+- **配置管理**: 全局和项目级别的配置
+- **工作空间管理**: 多项目设置
 
 ## 核心命令
 
@@ -34,7 +34,6 @@ Monoco 是一个开发者生产力工具包，提供：
 ### Agent 集成
 
 - **`monoco sync`**: 与 agent 环境同步
-
   - 将系统提示注入到 agent 配置文件（GEMINI.md, CLAUDE.md 等）
   - 分发 skills 到 agent 框架目录
   - 遵循 `i18n.source_lang` 的语言配置
@@ -45,12 +44,12 @@ Monoco 是一个开发者生产力工具包，提供：
 
 ## 配置结构
 
-配置以 YAML 格式存储在：
+配置以 YAML 格式存储在:
 
 - **全局**: `~/.monoco/config.yaml`
 - **项目**: `.monoco/config.yaml`
 
-关键配置段：
+关键配置段:
 
 - `core`: 编辑器、日志级别、作者
 - `paths`: 目录路径（issues, spikes, specs）

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/i18n/resources/zh/SKILL.md

@@ -9,7 +9,7 @@ description: 文档国际化质量控制。确保多语言文档保持同步。
 
 ## 概述
 
-I18n 功能提供：
+I18n 功能提供:
 
 - **自动扫描**缺失的翻译
 - **标准化结构**用于多语言文档
@@ -33,7 +33,7 @@ monoco i18n scan
 
 ## 配置
 
-I18n 设置在 `.monoco/config.yaml` 中配置：
+I18n 设置在 `.monoco/config.yaml` 中配置:
 
 ```yaml
 i18n:
@@ -47,7 +47,7 @@ i18n:
 
 ### 根文件（后缀模式）
 
-对于项目根目录中的文件：
+对于项目根目录中的文件:
 
 - 源文件: `README.md`
 - 中文: `README_ZH.md`
@@ -55,7 +55,7 @@ i18n:
 
 ### 子目录文件（目录模式）
 
-对于 `docs/` 或其他目录中的文件：
+对于 `docs/` 或其他目录中的文件:
 
 ```
 docs/
@@ -72,7 +72,7 @@ docs/
 
 ## 排除规则
 
-以下内容会自动从 i18n 扫描中排除：
+以下内容会自动从 i18n 扫描中排除:
 
 - `.gitignore` 模式（自动遵循）
 - `.references/` 目录

monoco/features/issue/commands.py

@@ -14,16 +14,18 @@ from . import core
 
 app = typer.Typer(help="Agent-Native Issue Management.")
 backlog_app = typer.Typer(help="Manage backlog operations.")
+lsp_app = typer.Typer(help="LSP Server commands.")
 app.add_typer(backlog_app, name="backlog")
+app.add_typer(lsp_app, name="lsp")
 console = Console()
 
 @app.command("create")
 def create(
-    type: IssueType = typer.Argument(..., help="Issue type (epic, feature, chore, fix)"),
+    type: str = typer.Argument(..., help="Issue type (epic, feature, chore, fix, etc.)"),
     title: str = typer.Option(..., "--title", "-t", help="Issue title"),
     parent: Optional[str] = typer.Option(None, "--parent", "-p", help="Parent Issue ID"),
     is_backlog: bool = typer.Option(False, "--backlog", help="Create as backlog item"),
-    stage: Optional[IssueStage] = typer.Option(None, "--stage", help="Issue stage (draft, doing, review)"),
+    stage: Optional[str] = typer.Option(None, "--stage", help="Issue stage"),
     dependencies: List[str] = typer.Option([], "--dependency", "-d", help="Issue dependency ID(s)"),
     related: List[str] = typer.Option([], "--related", "-r", help="Related Issue ID(s)"),
     subdir: Optional[str] = typer.Option(None, "--subdir", "-s", help="Subdirectory for organization (e.g. 'Backend/Auth')"),
@@ -32,10 +34,11 @@ def create(
     root: Optional[str] = typer.Option(None, "--root", help="Override issues root directory"),
     json: AgentOutput = False,
 ):
+    """Create a new issue."""
     """Create a new issue."""
     config = get_config()
     issues_root = _resolve_issues_root(config, root)
-    status = IssueStatus.BACKLOG if is_backlog else IssueStatus.OPEN
+    status = "backlog" if is_backlog else "open"
     
     if parent:
         parent_path = core.find_issue_path(issues_root, parent)
@@ -63,11 +66,15 @@ def create(
         except ValueError:
             rel_path = path
 
-        OutputManager.print({
-            "issue": issue,
-            "path": str(rel_path),
-            "status": "created"
-        })
+        if OutputManager.is_agent_mode():
+            OutputManager.print({
+                "issue": issue,
+                "path": str(rel_path),
+                "status": "created"
+            })
+        else:
+            console.print(f"[green]✔ Created {issue.id} in status {issue.status}.[/green]")
+            console.print(f"Path: {rel_path}")
 
     except ValueError as e:
         OutputManager.error(str(e))
@@ -77,8 +84,8 @@ def create(
 def update(
     issue_id: str = typer.Argument(..., help="Issue ID to update"),
     title: Optional[str] = typer.Option(None, "--title", "-t", help="New title"),
-    status: Optional[IssueStatus] = typer.Option(None, "--status", help="New status"),
-    stage: Optional[IssueStage] = typer.Option(None, "--stage", help="New stage"),
+    status: Optional[str] = typer.Option(None, "--status", help="New status"),
+    stage: Optional[str] = typer.Option(None, "--stage", help="New stage"),
     parent: Optional[str] = typer.Option(None, "--parent", "-p", help="Parent Issue ID"),
     sprint: Optional[str] = typer.Option(None, "--sprint", help="Sprint ID"),
     dependencies: Optional[List[str]] = typer.Option(None, "--dependency", "-d", help="Issue dependency ID(s)"),
@@ -125,7 +132,7 @@ def move_open(
     issues_root = _resolve_issues_root(config, root)
     try:
         # Pull operation: Force stage to TODO
-        issue = core.update_issue(issues_root, issue_id, status=IssueStatus.OPEN, stage=IssueStage.DRAFT)
+        issue = core.update_issue(issues_root, issue_id, status="open", stage="draft")
         OutputManager.print({
             "issue": issue,
             "status": "opened"
@@ -153,13 +160,13 @@ def start(
 
     try:
         # Implicitly ensure status is Open
-        issue = core.update_issue(issues_root, issue_id, status=IssueStatus.OPEN, stage=IssueStage.DOING)
+        issue = core.update_issue(issues_root, issue_id, status="open", stage="doing")
         
         isolation_info = None
 
         if branch:
             try:
-                issue = core.start_issue_isolation(issues_root, issue_id, IsolationType.BRANCH, project_root)
+                issue = core.start_issue_isolation(issues_root, issue_id, "branch", project_root)
                 isolation_info = {"type": "branch", "ref": issue.isolation.ref}
             except Exception as e:
                 OutputManager.error(f"Failed to create branch: {e}")
@@ -167,7 +174,7 @@ def start(
                 
         if worktree:
             try:
-                issue = core.start_issue_isolation(issues_root, issue_id, IsolationType.WORKTREE, project_root)
+                issue = core.start_issue_isolation(issues_root, issue_id, "worktree", project_root)
                 isolation_info = {"type": "worktree", "path": issue.isolation.path, "ref": issue.isolation.ref}
             except Exception as e:
                 OutputManager.error(f"Failed to create worktree: {e}")
@@ -196,7 +203,7 @@ def submit(
     project_root = _resolve_project_root(config)
     try:
         # Implicitly ensure status is Open
-        issue = core.update_issue(issues_root, issue_id, status=IssueStatus.OPEN, stage=IssueStage.REVIEW)
+        issue = core.update_issue(issues_root, issue_id, status="open", stage="review")
         
         # Delivery Report Generation
         report_status = "skipped"
@@ -228,7 +235,7 @@ def submit(
 @app.command("close")
 def move_close(
     issue_id: str = typer.Argument(..., help="Issue ID to close"),
-    solution: Optional[IssueSolution] = typer.Option(None, "--solution", "-s", help="Solution type"),
+    solution: Optional[str] = typer.Option(None, "--solution", "-s", help="Solution type"),
     prune: bool = typer.Option(False, "--prune", help="Delete branch/worktree after close"),
     force: bool = typer.Option(False, "--force", help="Force delete branch/worktree"),
     root: Optional[str] = typer.Option(None, "--root", help="Override issues root directory"),
@@ -241,12 +248,15 @@ def move_close(
     
     # Pre-flight check for interactive guidance (Requirement FEAT-0082 #6)
     if solution is None:
-        valid_solutions = [e.value for e in IssueSolution]
+        # Resolve options from engine
+        from .engine import get_engine
+        engine = get_engine(str(issues_root.parent))
+        valid_solutions = engine.issue_config.solutions or []
         OutputManager.error(f"Closing an issue requires a solution. Options: {', '.join(valid_solutions)}")
         raise typer.Exit(code=1)
 
     try:
-        issue = core.update_issue(issues_root, issue_id, status=IssueStatus.CLOSED, solution=solution)
+        issue = core.update_issue(issues_root, issue_id, status="closed", solution=solution)
         
         pruned_resources = []
         if prune:
@@ -276,7 +286,7 @@ def push(
     config = get_config()
     issues_root = _resolve_issues_root(config, root)
     try:
-        issue = core.update_issue(issues_root, issue_id, status=IssueStatus.BACKLOG)
+        issue = core.update_issue(issues_root, issue_id, status="backlog")
         OutputManager.print({
             "issue": issue,
             "status": "pushed_to_backlog"
@@ -295,7 +305,7 @@ def pull(
     config = get_config()
     issues_root = _resolve_issues_root(config, root)
     try:
-        issue = core.update_issue(issues_root, issue_id, status=IssueStatus.OPEN, stage=IssueStage.DRAFT)
+        issue = core.update_issue(issues_root, issue_id, status="open", stage="draft")
         OutputManager.print({
             "issue": issue,
             "status": "pulled_from_backlog"
@@ -314,7 +324,7 @@ def cancel(
     config = get_config()
     issues_root = _resolve_issues_root(config, root)
     try:
-        issue = core.update_issue(issues_root, issue_id, status=IssueStatus.CLOSED, solution=IssueSolution.CANCELLED)
+        issue = core.update_issue(issues_root, issue_id, status="closed", solution="cancelled")
         OutputManager.print({
             "issue": issue,
             "status": "cancelled"
@@ -427,10 +437,10 @@ def board(
         issue_list = []
         for issue in sorted(issues, key=lambda x: x.updated_at, reverse=True):
             type_color = {
-                IssueType.FEATURE: "green",
-                IssueType.CHORE: "blue",
-                IssueType.FIX: "red",
-                IssueType.EPIC: "magenta"
+                "feature": "green",
+                "chore": "blue",
+                "fix": "red",
+                "epic": "magenta"
             }.get(issue.type, "white")
             
             issue_list.append(
@@ -458,8 +468,8 @@ def board(
 @app.command("list")
 def list_cmd(
     status: Optional[str] = typer.Option(None, "--status", "-s", help="Filter by status (open, closed, backlog, all)"),
-    type: Optional[IssueType] = typer.Option(None, "--type", "-t", help="Filter by type"),
-    stage: Optional[IssueStage] = typer.Option(None, "--stage", help="Filter by stage"),
+    type: Optional[str] = typer.Option(None, "--type", "-t", help="Filter by type"),
+    stage: Optional[str] = typer.Option(None, "--stage", help="Filter by stage"),
     root: Optional[str] = typer.Option(None, "--root", help="Override issues root directory"),
     workspace: bool = typer.Option(False, "--workspace", "-w", help="Include issues from workspace members"),
     json: AgentOutput = False,
@@ -481,7 +491,7 @@ def list_cmd(
     for i in issues:
         # Status Filter
         if target_status != "all":
-            if i.status.value != target_status:
+            if i.status != target_status:
                 continue
                 
         # Type Filter
@@ -530,13 +540,13 @@ def _render_issues_table(issues: List[IssueMetadata], title: str = "Issues"):
         t_color = type_colors.get(i.type, "white")
         s_color = status_colors.get(i.status, "white")
         
-        stage_str = i.stage.value if i.stage else "-"
+        stage_str = i.stage if i.stage else "-"
         updated_str = i.updated_at.strftime("%Y-%m-%d %H:%M")
         
         table.add_row(
             i.id,
-            f"[{t_color}]{i.type.value}[/{t_color}]",
-            f"[{s_color}]{i.status.value}[/{s_color}]",
+            f"[{t_color}]{i.type}[/{t_color}]",
+            f"[{s_color}]{i.status}[/{s_color}]",
             stage_str,
             i.title,
             updated_str
@@ -605,11 +615,11 @@ def scope(
         return
 
     tree = Tree(f"[bold blue]Monoco Issue Scope[/bold blue]")
-    epics = sorted([i for i in issues if i.type == IssueType.EPIC], key=lambda x: x.id)
-    stories = [i for i in issues if i.type == IssueType.FEATURE]
-    tasks = [i for i in issues if i.type in [IssueType.CHORE, IssueType.FIX]]
+    epics = sorted([i for i in issues if i.type == "epic"], key=lambda x: x.id)
+    stories = [i for i in issues if i.type == "feature"]
+    tasks = [i for i in issues if i.type in ["chore", "fix"]]
 
-    status_map = {IssueStatus.OPEN: "[blue]●[/blue]", IssueStatus.CLOSED: "[green]✔[/green]", IssueStatus.BACKLOG: "[dim]💤[/dim]"}
+    status_map = {"open": "[blue]●[/blue]", "closed": "[green]✔[/green]", "backlog": "[dim]💤[/dim]"}
 
     for epic in epics:
         epic_node = tree.add(f"{status_map[epic.status]} [bold]{epic.id}[/bold]: {epic.title}")
@@ -622,6 +632,57 @@ def scope(
 
     console.print(Panel(tree, expand=False))
 
+@app.command("inspect")
+def inspect(
+    target: str = typer.Argument(..., help="Issue ID or File Path"),
+    root: Optional[str] = typer.Option(None, "--root", help="Override issues root directory"),
+    ast: bool = typer.Option(False, "--ast", help="Output JSON AST structure for debugging"),
+    json: AgentOutput = False,
+):
+    """
+    Inspect a specific issue and return its metadata (including actions).
+    """
+    config = get_config()
+    issues_root = _resolve_issues_root(config, root)
+    
+    # Try as Path
+    target_path = Path(target)
+    if target_path.exists() and target_path.is_file():
+        path = target_path
+    else:
+        # Try as ID
+        # Search path logic is needed? Or core.find_issue_path
+        path = core.find_issue_path(issues_root, target)
+        if not path:
+             OutputManager.error(f"Issue or file {target} not found.")
+             raise typer.Exit(code=1)
+    
+    # AST Debug Mode
+    if ast:
+        from .domain.parser import MarkdownParser
+        content = path.read_text()
+        try:
+            domain_issue = MarkdownParser.parse(content, path=str(path))
+            print(domain_issue.model_dump_json(indent=2))
+        except Exception as e:
+            OutputManager.error(f"Failed to parse AST: {e}")
+            raise typer.Exit(code=1)
+        return
+
+    # Normal Mode
+    meta = core.parse_issue(path)
+        
+    if not meta:
+         OutputManager.error(f"Could not parse issue {target}.")
+         raise typer.Exit(code=1)
+
+    # In JSON mode (AgentOutput), we might want to return rich data
+    if OutputManager.is_agent_mode():
+        OutputManager.print(meta)
+    else:
+        # For human, print yaml-like or table
+        console.print(meta)
+
 @app.command("lint")
 def lint(
     recursive: bool = typer.Option(False, "--recursive", "-r", help="Recursively scan subdirectories"),
@@ -662,27 +723,9 @@ def _resolve_issues_root(config, cli_root: Optional[str]) -> Path:
         return path
     
     # 2. Handle Default / Contextual Execution (No --root)
-    # We need to detect if we are in a Workspace Root with multiple projects
+    # Strict Workspace Check: If not in a project root, we rely on the config root.
+    # (The global app callback already enforces presence of .monoco for most commands)
     cwd = Path.cwd()
-    
-    # If CWD is NOT a project root (no .monoco/), scan for subprojects
-    if not is_project_root(cwd):
-        subprojects = find_projects(cwd)
-        if len(subprojects) > 1:
-            console.print(f"[yellow]Workspace detected with {len(subprojects)} projects:[/yellow]")
-            for p in subprojects:
-                console.print(f" - [bold]{p.name}[/bold]")
-            console.print("\n[yellow]Please specify a project using --root <PATH>.[/yellow]")
-            # We don't exit here strictly, but usually this means we can't find 'Issues' in CWD anyway
-            # so the config fallbacks below will likely fail or point to non-existent CWD/Issues.
-            # But let's fail fast to be helpful.
-            raise typer.Exit(code=1)
-        elif len(subprojects) == 1:
-            # Auto-select the only child project?
-            # It's safer to require explicit intent, but let's try to be helpful if it's obvious.
-            # However, standard behavior is usually "operate on current dir". 
-            # Let's stick to standard config resolution, but maybe warn.
-            pass
 
     # 3. Config Fallback
     config_issues_path = Path(config.paths.issues)
@@ -826,3 +869,40 @@ def commit(
     except Exception as e:
          console.print(f"[red]Git Error:[/red] {e}")
          raise typer.Exit(code=1)
+
+@lsp_app.command("definition")
+def lsp_definition(
+    file: str = typer.Option(..., "--file", "-f", help="Abs path to file"),
+    line: int = typer.Option(..., "--line", "-l", help="0-indexed line number"),
+    character: int = typer.Option(..., "--char", "-c", help="0-indexed character number"),
+):
+    """
+    Handle textDocument/definition request.
+    Output: JSON Location | null
+    """
+    import json
+    from monoco.core.lsp import Position
+    from monoco.features.issue.lsp import DefinitionProvider
+
+    config = get_config()
+    # Workspace Root resolution is key here. 
+    # If we are in a workspace, we want the workspace root, not just issue root.
+    # _resolve_project_root returns the closest project root or monoco root.
+    workspace_root = _resolve_project_root(config)
+    # Search for topmost workspace root to enable cross-project navigation
+    current_best = workspace_root
+    for parent in [workspace_root] + list(workspace_root.parents):
+        if (parent / ".monoco" / "workspace.yaml").exists() or (parent / ".monoco" / "project.yaml").exists():
+            current_best = parent
+    workspace_root = current_best
+    
+    provider = DefinitionProvider(workspace_root)
+    file_path = Path(file)
+    
+    locations = provider.provide_definition(
+        file_path, 
+        Position(line=line, character=character)
+    )
+    
+    # helper to serialize
+    print(json.dumps([l.model_dump(mode='json') for l in locations]))