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

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_atom_memo/SKILL.md

@@ -0,0 +1,77 @@
+---
+name: monoco_atom_memo
+description: Lightweight memo system for quickly recording ideas, inspirations, and temporary notes. Distinguished from the formal Issue system.
+type: atom
+version: 1.0.0
+---
+
+# Monoco Memo
+
+Use this skill to quickly capture fleeting notes (fleeting ideas) without creating a formal Issue.
+
+## When to Use Memo vs Issue
+
+| Scenario | Use | Reason |
+|----------|-----|--------|
+| Temporary ideas, inspirations | **Memo** | No tracking needed, no completion status required |
+| Code snippets, link bookmarks | **Memo** | Quick record, organize later |
+| Meeting notes | **Memo** | Record first, then extract tasks |
+| Actionable work unit | **Issue** | Requires tracking, acceptance criteria, lifecycle |
+| Bug fix | **Issue** | Needs to record reproduction steps, verification results |
+| Feature development | **Issue** | Needs design, decomposition, delivery |
+
+> **Core Principle**: Memos record **ideas**; Issues handle **actionable tasks**.
+
+## Commands
+
+### Add Memo
+
+```bash
+monoco memo add "Your memo content"
+```
+
+Optional parameters:
+- `-c, --context`: Add context reference (e.g., `file:line`)
+
+Examples:
+```bash
+# Simple record
+monoco memo add "Consider using Redis cache for user sessions"
+
+# Record with context
+monoco memo add "Recursion here may cause stack overflow" -c "src/utils.py:42"
+```
+
+### View Memo List
+
+```bash
+monoco memo list
+```
+
+Displays all unarchived memos.
+
+### Open Memo File
+
+```bash
+monoco memo open
+```
+
+Opens the memo file in the default editor for organizing or batch editing.
+
+## Workflow
+
+```
+Idea flashes → monoco memo add "..." → Regular organization → Extract into Issue or archive
+```
+
+1. **Capture**: Use `monoco memo add` immediately when you have an idea
+2. **Organize**: Regularly (e.g., daily/weekly) run `monoco memo list` to review
+3. **Convert**: Transform valuable memos into formal Issues
+4. **Archive**: Remove from memos after processing
+
+## Best Practices
+
+1. **Keep concise**: Memos are quick notes, no detailed description needed
+2. **Convert timely**: Valuable ideas should be converted to Issue as soon as possible to avoid forgetting
+3. **Clean up regularly**: Memos are temporary, don't let them accumulate indefinitely
+4. **Use context**: When recording code-related ideas, use `-c` parameter to mark the location

monoco/features/memo/resources/en/skills/monoco_workflow_note_processing/SKILL.md

@@ -0,0 +1,140 @@
+---
+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: workflow
+domain: memo
+version: 1.0.0
+---
+
+# Note Processing Workflow
+
+Standardized workflow for Memo note processing, ensuring the "Capture → Process → Organize → Archive/Convert" process.
+
+## Workflow State Machine
+
+```mermaid
+stateDiagram-v2
+    [*] --> Capture: Idea flashes
+    
+    Capture --> Process: Regular organization
+    Capture --> Capture: Continue recording
+    
+    Process --> Organize: Classification completed
+    Process --> Archive: No value<br/>(archive directly)
+    
+    Organize --> Convert: Actionable
+    Organize --> Organize: Needs supplement<br/>(complete information)
+    Organize --> Archive: Pure reference<br/>(archive for storage)
+    
+    Convert --> [*]: Converted to Issue
+    
+    Archive --> [*]: Archiving completed
+```
+
+## Execution Steps
+
+### 1. Capture (Capture)
+
+- **Goal**: Quickly record fleeting ideas without interrupting current work
+- **Input**: Ideas, inspirations, code snippets, links
+- **Output**: Memo record
+- **Checkpoints**:
+  - [ ] Use `monoco memo add "content"`
+  - [ ] Keep it concise, no detailed description needed
+  - [ ] Add context (`-c file:line` if applicable)
+  - [ ] Do not interrupt current task flow
+
+### 2. Process (Processing)
+
+- **Goal**: Regularly review and classify Memos
+- **Strategy**: Regular organization (daily/weekly)
+- **Checkpoints**:
+  - [ ] Run `monoco memo list` to view all Memos
+  - [ ] Evaluate value of each Memo
+  - [ ] Classify: Actionable / Pure reference / No value
+  - [ ] Supplement missing information
+
+### 3. Organize (Organization)
+
+- **Goal**: Structured organization of valuable Memos
+- **Strategy**: Choose processing method based on type
+- **Checkpoints**:
+  - [ ] Add tags or categories to related Memos
+  - [ ] Merge similar Memos
+  - [ ] Complete vague records
+  - [ ] Set priority (if applicable)
+
+### 4. Archive/Convert (Archive or Convert)
+
+- **Goal**: Archive processed Memos or convert to Issue
+- **Checkpoints**:
+  - [ ] **Convert**: Convert actionable ideas to Issue
+    - Use `monoco issue create feature/chore/fix -t "title"`
+    - Reference original Memo in the Issue
+  - [ ] **Archive**: Archive pure reference content
+    - Move to knowledge base or documentation
+    - Remove from Memo list
+  - [ ] **Delete**: Delete Memos with no value directly
+
+## Decision Branches
+
+| Condition | Action |
+|-----------|--------|
+| Idea is actionable | Convert, create Issue |
+| Pure reference material | Archive, save to knowledge base |
+| No value/outdated | Delete, remove directly |
+| Information incomplete | Return to Organize, supplement information |
+
+## Compliance Requirements
+
+- **Required**: Memos are temporary, should not accumulate indefinitely
+- **Required**: Actionable ideas must be converted to Issue for tracking
+- **Recommended**: Process regularly (recommended weekly)
+- **Recommended**: Keep Memos concise, avoid lengthy discussions
+
+## Related Commands
+
+```bash
+# Add Memo
+monoco memo add "Consider using Redis cache for user sessions"
+
+# Memo with context
+monoco memo add "Recursion may cause stack overflow" -c "src/utils.py:42"
+
+# View all Memos
+monoco memo list
+
+# Edit Memo
+monoco memo open
+
+# Create Issue (convert Memo)
+monoco issue create feature -t "Implement Redis cache"
+```
+
+## Usage Scenarios
+
+| Scenario | Use Memo | Follow-up Processing |
+|----------|----------|---------------------|
+| Improvement suggestion during code review | `memo add "Refactoring suggestion: ..."` | Process → Convert to Issue |
+| Temporary idea during meeting | `memo add "Idea: ..."` | Process → Organize → Convert |
+| Useful code snippet | `memo add "Snippet: ..."` | Process → Archive to knowledge base |
+| Technical article link | `memo add "Read: https://..."` | Process → Archive |
+| Bug clue | `memo add "Possible Bug: ..."` | Process → Convert to Fix Issue |
+
+## Difference from Issue
+
+| Dimension | Memo | Issue |
+|-----------|------|-------|
+| Purpose | Record ideas | Track tasks |
+| Lifecycle | Temporary, needs regular cleanup | Formal, complete lifecycle |
+| Completion Criteria | Archived or converted | Acceptance criteria passed |
+| Complexity | Simple, one sentence | Detailed, with AC and Tasks |
+| Tracking | None | Complete tracking |
+
+## Best Practices
+
+1. **Record promptly**: Record immediately when ideas flash, avoid forgetting
+2. **Organize regularly**: Process Memo list at least once a week
+3. **Convert quickly**: Convert valuable ideas to Issue as soon as possible
+4. **Delete decisively**: Delete outdated or valueless Memos decisively
+5. **Keep concise**: Memos are quick notes, no detailed description needed

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

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

monoco/features/memo/resources/{skills/note_processing_workflow → zh/skills/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/{SKILL.md → skills/monoco_atom_spike/SKILL.md}

@@ -1,6 +1,8 @@
 ---
-name: monoco-spike
+name: monoco_atom_spike
 description: Manage external reference repositories for research and learning. Provides read-only access to curated codebases.
+type: atom
+version: 1.0.0
 ---
 
 # Spike (Research)

monoco/features/spike/resources/en/skills/monoco_workflow_research/SKILL.md

@@ -0,0 +1,121 @@
+---
+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: workflow
+domain: spike
+version: 1.0.0
+---
+
+# Research Workflow
+
+Standardized workflow for Spike research, ensuring the "Add → Sync → Analyze → Extract → Archive" process.
+
+## Workflow State Machine
+
+```mermaid
+stateDiagram-v2
+    [*] --> Add: Discover reference repository
+    
+    Add --> Sync: Configuration added
+    Add --> Add: Invalid URL<br/>(re-enter)
+    
+    Sync --> Analyze: Sync completed
+    Sync --> Sync: Sync failed<br/>(network/permission)
+    
+    Analyze --> Extract: Analysis completed
+    Analyze --> Analyze: Content mismatch<br/>(re-evaluate)
+    
+    Extract --> Archive: Knowledge extraction completed
+    
+    Archive --> [*]: Archiving completed
+```
+
+## Execution Steps
+
+### 1. Add (Add Repository)
+
+- **Goal**: Add external repository as reference
+- **Input**: Repository URL, reference purpose
+- **Output**: Configuration updated
+- **Checkpoints**:
+  - [ ] Verify repository URL is accessible
+  - [ ] Confirm repository is relevant to current project
+  - [ ] Run `monoco spike add <url>`
+  - [ ] Check `.monoco/config.yaml` is updated
+
+### 2. Sync (Synchronize)
+
+- **Goal**: Download or update reference repository content
+- **Checkpoints**:
+  - [ ] Run `monoco spike sync`
+  - [ ] Verify repository is cloned to `.references/<name>/`
+  - [ ] Check sync logs for errors
+  - [ ] Verify file permissions are correct (read-only)
+
+### 3. Analyze (Analysis)
+
+- **Goal**: Research the structure and content of reference repository
+- **Strategy**: Systematic browsing and marking
+- **Checkpoints**:
+  - [ ] Browse overall repository structure
+  - [ ] Identify modules relevant to current project
+  - [ ] Mark valuable code patterns
+  - [ ] Record architectural design highlights
+
+### 4. Extract (Knowledge Extraction)
+
+- **Goal**: Extract usable knowledge from reference repository
+- **Strategy**: Document valuable findings
+- **Checkpoints**:
+  - [ ] Extract key code snippets (without modifying original files)
+  - [ ] Record design patterns and best practices
+  - [ ] Create learning notes (using Memo or Issue)
+  - [ ] Annotate knowledge source (repository URL + Commit)
+
+### 5. Archive (Archiving)
+
+- **Goal**: Organize and archive research results
+- **Checkpoints**:
+  - [ ] Update project documentation, referencing the repository
+  - [ ] Create knowledge index (if needed)
+  - [ ] Run `monoco spike list` to verify status
+  - [ ] Periodically clean up references no longer needed
+
+## Decision Branches
+
+| Condition | Action |
+|-----------|--------|
+| Invalid URL | Return to Add, check URL format |
+| Sync failed | Check network, permissions, retry or skip |
+| Content not relevant | Remove from configuration, reselect |
+| Important pattern discovered | Create Issue, plan to introduce to project |
+
+## Compliance Requirements
+
+- **Prohibited**: Editing any files in `.references/`
+- **Required**: All external knowledge must be annotated with source
+- **Required**: Regular synchronization to get updates
+- **Recommended**: Only add high-quality, relevant repositories
+
+## Related Commands
+
+```bash
+# Add reference repository
+monoco spike add <url>
+
+# Sync all repositories
+monoco spike sync
+
+# List configured repositories
+monoco spike list
+
+# Record research findings
+monoco memo add "Discovery: {insight}" -c "spike:{repo_name}"
+```
+
+## Best Practices
+
+1. **Selective Choice**: Only add repositories highly relevant to the project
+2. **Read-only Access**: Treat `.references/` as external knowledge base, never modify
+3. **Regular Sync**: Run `monoco spike sync` monthly to get updates
+4. **Knowledge Transformation**: Transform learned patterns into actual project improvements

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

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

monoco/features/spike/resources/{skills/research_workflow → zh/skills/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
 ---

monoco/main.py

@@ -1,7 +1,23 @@
 import os
 import typer
 from typing import Optional
+from pathlib import Path
 from monoco.core.output import print_output
+from monoco.core.loader import FeatureLoader, FeatureContext
+
+# Global feature loader for CLI lifecycle management
+_feature_loader: Optional[FeatureLoader] = None
+
+
+def get_feature_loader() -> FeatureLoader:
+    """Get or initialize the global feature loader."""
+    global _feature_loader
+    if _feature_loader is None:
+        _feature_loader = FeatureLoader()
+        # Discover features but defer loading until needed
+        _feature_loader.discover()
+    return _feature_loader
+
 
 app = typer.Typer(
     name="monoco",
@@ -89,7 +105,26 @@ def main(
             if (discovered / ".monoco").exists():
                 config_root = str(discovered)
 
-        get_config(project_root=config_root, require_project=require_workspace)
+        config = get_config(project_root=config_root, require_project=require_workspace)
+        
+        # Initialize FeatureLoader and mount features when workspace is available
+        if require_workspace and config_root:
+            loader = get_feature_loader()
+            # Load all features (with lazy loading for non-critical features)
+            loader.load_all(lazy=True)
+            # Create feature context and mount all features
+            feature_context = FeatureContext(
+                root=Path(config_root),
+                config=config.model_dump(),
+                registry=loader.registry,
+            )
+            errors = loader.mount_all(feature_context)
+            if errors:
+                from rich.console import Console
+                console = Console()
+                for name, error in errors.items():
+                    console.print(f"[yellow]Warning: Failed to mount feature '{name}': {error}[/yellow]")
+                    
     except FileNotFoundError as e:
         # Graceful exit for workspace errors
         from rich.console import Console
@@ -156,6 +191,7 @@ from monoco.features.issue import commands as issue_cmd
 from monoco.features.spike import commands as spike_cmd
 from monoco.features.i18n import commands as i18n_cmd
 from monoco.features.config import commands as config_cmd
+from monoco.features.hooks import commands as hooks_cmd
 from monoco.cli import project as project_cmd
 from monoco.cli import workspace as workspace_cmd
 
@@ -163,6 +199,7 @@ app.add_typer(issue_cmd.app, name="issue", help="Manage development issues")
 app.add_typer(spike_cmd.app, name="spike", help="Manage research spikes")
 app.add_typer(i18n_cmd.app, name="i18n", help="Manage documentation i18n")
 app.add_typer(config_cmd.app, name="config", help="Manage configuration")
+app.add_typer(hooks_cmd.app, name="hooks", help="Manage git hooks for development workflow")
 app.add_typer(project_cmd.app, name="project", help="Manage projects")
 app.add_typer(workspace_cmd.app, name="workspace", help="Manage workspace")
 

monoco_toolkit-0.3.11.dist-info/METADATA

@@ -0,0 +1,130 @@
+Metadata-Version: 2.4
+Name: monoco-toolkit
+Version: 0.3.11
+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
+Project-URL: Documentation, https://monoco.io/docs
+Project-URL: Issues, https://github.com/IndenScale/Monoco/issues
+Author-email: Monoco Team <dev@monoco.io>
+License-Expression: MIT
+License-File: LICENSE
+Keywords: agent-native,ai-agents,cli,kanban,monoco,task-management,workflow
+Classifier: Development Status :: 3 - Alpha
+Classifier: Intended Audience :: Developers
+Classifier: License :: OSI Approved :: MIT License
+Classifier: Programming Language :: Python :: 3
+Classifier: Programming Language :: Python :: 3.10
+Classifier: Programming Language :: Python :: 3.11
+Classifier: Programming Language :: Python :: 3.12
+Classifier: Topic :: Office/Business :: Groupware
+Classifier: Topic :: Software Development :: Libraries :: Python Modules
+Classifier: Topic :: Software Development :: Quality Assurance
+Requires-Python: >=3.10
+Requires-Dist: fastapi>=0.100.0
+Requires-Dist: httpx>=0.28.1
+Requires-Dist: prompt-toolkit>=3.0.0
+Requires-Dist: pydantic>=2.0.0
+Requires-Dist: pyyaml>=6.0
+Requires-Dist: rich>=13.0.0
+Requires-Dist: sse-starlette>=1.6.0
+Requires-Dist: typer[all]>=0.9.0
+Requires-Dist: uvicorn[standard]>=0.20.0
+Requires-Dist: watchdog>=6.0.0
+Description-Content-Type: text/markdown
+
+# Monoco Distro
+
+[![Version](https://img.shields.io/pypi/v/monoco-toolkit)](https://pypi.org/project/monoco-toolkit/)
+[![License](https://img.shields.io/github/license/IndenScale/Monoco)](LICENSE)
+
+> **The Headless Operating System for Agentic Engineering.**
+>
+> Monoco is a **Linux-like Distribution** for AI Agents.
+> It provides the **Package Manager**, **Init System**, and **Policy Kit** that turns a raw LLM Kernel into a production-ready engineering workforce.
+
+---
+
+## 🐧 The "Distro" Metaphor
+
+Monoco is built on a clear separation of concerns, inspired by the Linux ecosystem:
+
+| Component   | In Linux      | In Monoco             | Responsibility                                                                                                             |
+| :---------- | :------------ | :-------------------- | :------------------------------------------------------------------------------------------------------------------------- |
+| **Kernel**  | Linux Kernel  | **Kimi CLI / Kosong** | The raw execution engine. Handles LLM prompts, tool execution, and process isolation.                                      |
+| **Distro**  | Ubuntu / Arch | **Monoco**            | The system manager. Orchestrates workflows, enforces policies, manages state (Issues), and installs capabilities (Skills). |
+| **Desktop** | GNOME / KDE   | **VSCode / Zed**      | The user interface. Connects to Monoco via standard protocols (LSP, ACP) to provide a visual experience.                   |
+
+## 🌟 Core Philosophy
+
+### 1. Headless & Protocol-First
+
+Monoco is designed to run silently in the background. It doesn't fight for your attention with a chat window. Instead, it exposes its state via **LSP (Language Server Protocol)** and **ACP (Agent Client Protocol)**, allowing your favorite IDEs to become "Agent-Native".
+
+### 2. Issue is the Unit of Work
+
+Just as `systemd` manages Units, Monoco manages **Issues**.
+An Issue is not just a text file; it is a stateful object that defines the lifecycle of a task. The Agent cannot "freelance"—it must be assigned to an active Issue.
+
+### 3. Governance as Code
+
+Monoco acts as the "Policy Kit" for your AI workforce.
+
+- **Guardrails**: Prevent destructive actions.
+- **Verification**: Enforce linting and tests before submission.
+- **Audit**: Log every decision and tool call.
+
+## 🚀 Quick Start
+
+### 1. Installation
+
+Install the Monoco Distro via pip:
+
+```bash
+pip install monoco-toolkit
+```
+
+### 2. Initialize System
+
+Turn your project into a Monoco-managed workspace:
+
+```bash
+monoco init
+```
+
+### 3. Sync Kernel
+
+Inject Monoco's policies into your Agent Kernel (e.g., Kimi CLI configuration):
+
+```bash
+monoco sync
+```
+
+### 4. Start a Session
+
+Launch the Monoco Daemon to begin orchestrating work:
+
+```bash
+monoco session start
+```
+
+## 🛠️ Tech Stack & Architecture
+
+- **Kernel Interface**: Python (Interfacing with Kimi/Kosong)
+- **Distro Logic**: Python (State Management, Issue Tracking)
+- **Protocols**: LSP / ACP (for IDE integration)
+- **Storage**: Local Filesystem (Markdown/YAML)
+
+## 📁 Project Structure
+
+Monoco follows a "Distro" architecture that separates **State** (`Issues/`), **Config** (`.monoco/`), and **Logic** (`monoco/`).
+
+For a detailed breakdown of the directory structure, see **[TREE.md](./TREE.md)**.
+
+## 🤝 Contributing
+
+Monoco is open-source. We are building the standard distribution for the Agentic era.
+
+## 📄 License
+
+MIT © [IndenScale](https://github.com/IndenScale)