daimyo 1.0.0__tar.gz

daimyo-1.0.0/.gitignore

@@ -0,0 +1,61 @@
+# Python
+__pycache__/
+*.py[cod]
+*$py.class
+*.so
+.Python
+build/
+develop-eggs/
+dist/
+downloads/
+eggs/
+.eggs/
+lib/
+lib64/
+parts/
+sdist/
+var/
+wheels/
+*.egg-info/
+.installed.cfg
+*.egg
+MANIFEST
+
+# Virtual environments
+venv/
+ENV/
+env/
+.venv
+
+# IDEs
+.vscode/
+.idea/
+*.swp
+*.swo
+*~
+
+# Testing
+.pytest_cache/
+.coverage
+htmlcov/
+.tox/
+
+# Logs
+logs/
+*.log
+
+# Configuration secrets
+config/.secrets.toml
+.secrets.toml
+
+# OS
+.DS_Store
+Thumbs.db
+
+# Hatch
+.hatch/
+
+# Type checking
+.mypy_cache/
+.dmypy.json
+dmypy.json

daimyo-1.0.0/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2025 Jesús Alonso Abad
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

daimyo-1.0.0/PKG-INFO

@@ -0,0 +1,301 @@
+Metadata-Version: 2.4
+Name: daimyo
+Version: 1.0.0
+Summary: Rules server for agents with REST and MCP interfaces
+Project-URL: Homepage, https://gitlab.com/Kencho1/daimyo
+Project-URL: Repository, https://gitlab.com/Kencho1/daimyo
+Project-URL: Issues, https://gitlab.com/Kencho1/daimyo/-/issues
+Project-URL: Changelog, https://gitlab.com/Kencho1/daimyo/-/blob/main/CHANGELOG.md
+Author: Jesús Alonso Abad
+License: MIT
+License-File: LICENSE
+Classifier: Development Status :: 5 - Production/Stable
+Classifier: Intended Audience :: Developers
+Classifier: License :: OSI Approved :: MIT License
+Classifier: Programming Language :: Python :: 3
+Classifier: Programming Language :: Python :: 3.11
+Classifier: Programming Language :: Python :: 3.12
+Classifier: Programming Language :: Python :: 3.13
+Classifier: Programming Language :: Python :: 3.14
+Requires-Python: >=3.11
+Requires-Dist: cachetools~=5.3
+Requires-Dist: dynaconf~=3.2
+Requires-Dist: fastapi~=0.104
+Requires-Dist: fastmcp~=0.2
+Requires-Dist: httpx~=0.25
+Requires-Dist: loguru~=0.7
+Requires-Dist: pydantic~=2.5
+Requires-Dist: pyyaml~=6.0
+Requires-Dist: typer~=0.9
+Requires-Dist: uvicorn[standard]~=0.24
+Provides-Extra: dev
+Requires-Dist: mypy~=1.7; extra == 'dev'
+Requires-Dist: pytest-asyncio~=0.21; extra == 'dev'
+Requires-Dist: pytest-cov~=4.1; extra == 'dev'
+Requires-Dist: pytest-httpx~=0.27; extra == 'dev'
+Requires-Dist: pytest~=7.4; extra == 'dev'
+Requires-Dist: ruff~=0.1; extra == 'dev'
+Description-Content-Type: text/markdown
+
+# Daimyo - Rules Server for Agents
+
+A Python server providing rules to AI agents through REST and MCP interfaces. Supports scope-based rules with inheritance, categories for filtering, and server federation for distributed rule management.
+
+## Features
+
+- **Multiple Interfaces**: REST API, MCP (Model Context Protocol), and CLI
+- **Scope Inheritance**: Single and multiple parent inheritance with priority-based conflict resolution
+- **Rule Types**: Commandments (MUST) and Suggestions (SHOULD)
+- **Categories**: Organize rules into hierarchical categories for selective retrieval
+- **Server Federation**: Distribute scopes across multiple servers with automatic merging
+- **Multiple Formats**: Output as YAML, JSON, or Markdown
+- **Clean Architecture**: Domain-driven design with clear separation of concerns
+
+## Installation
+
+```bash
+pip install daimyo
+```
+
+Or install from source:
+
+```bash
+git clone https://gitlab.com/Kencho1/daimyo.git
+cd daimyo
+pip install -e .
+```
+
+## Quick Start
+
+### 1. Set Up Your Rules
+
+```bash
+cp -r example-daimyo-rules daimyo-rules
+```
+
+### 2. Start the Server
+
+```bash
+daimyo serve
+```
+
+### 3. Access the API
+
+Visit http://localhost:8000/docs for interactive API documentation.
+
+```bash
+curl http://localhost:8000/api/v1/scopes/python-general/rules
+```
+
+## Core Concepts
+
+### Scopes
+
+Scopes represent organizational contexts (company, team, project). Each scope is a directory containing:
+
+- `metadata.yml` - Scope configuration and parent references
+- `commandments.yml` - Mandatory rules (MUST)
+- `suggestions.yml` - Recommended rules (SHOULD)
+
+```text
+daimyo-rules/
+├── python-general/
+│   ├── metadata.yml
+│   ├── commandments.yml
+│   └── suggestions.yml
+└── team-backend/
+    ├── metadata.yml
+    ├── commandments.yml
+    └── suggestions.yml
+```
+
+### Metadata Format
+
+```yaml
+name: scope-name
+description: Human-readable description
+parents:
+  - parent-scope-1
+  - parent-scope-2
+tags:
+  team: backend
+  language: python
+```
+
+**Fields:**
+
+- `name`: Scope identifier (must match directory name)
+- `description`: Human-readable description
+- `parents`: List of parent scopes (first = highest priority)
+- `tags`: Key-value pairs for categorization
+
+### Categories
+
+Categories are hierarchical subdivisions within rules:
+
+```yaml
+python.web.testing:
+  when: When testing web interfaces
+  ruleset:
+    - Use playwright for acceptance tests
+    - Use pytest fixtures for test setup
+```
+
+### Rule Types
+
+**Commandments (MUST)**: Mandatory rules that accumulate through inheritance
+
+**Suggestions (SHOULD)**: Recommended rules that can be overridden or appended with `+` prefix
+
+## Usage
+
+### REST API
+
+Start the server:
+
+```bash
+daimyo serve
+daimyo serve --host 0.0.0.0 --port 8080
+```
+
+Get rules:
+
+```bash
+curl http://localhost:8000/api/v1/scopes/python-general/rules
+
+curl -H "Accept: application/json" \
+  http://localhost:8000/api/v1/scopes/python-general/rules
+
+curl -H "Accept: text/markdown" \
+  http://localhost:8000/api/v1/scopes/python-general/rules
+```
+
+Filter by categories:
+
+```bash
+curl "http://localhost:8000/api/v1/scopes/team-backend/rules?categories=python.web,python.testing"
+```
+
+### MCP Server
+
+Start the MCP server:
+
+```bash
+daimyo mcp
+daimyo mcp --transport sse
+```
+
+Available tools:
+
+- `get_rules(scope_name, categories?)` - Get formatted rules
+- `list_scopes()` - List available scopes
+- `apply_scope_rules(scope_name, categories?)` - Get prompt template with rules
+
+### CLI Commands
+
+```bash
+daimyo list-scopes
+daimyo show python-general
+daimyo --version
+```
+
+## Configuration
+
+Configuration is managed via `config/settings.toml` or environment variables:
+
+```toml
+[default]
+rules_path = "./daimyo-rules"
+console_log_level = "WARNING"
+file_log_level = "INFO"
+max_inheritance_depth = 10
+master_server_url = ""
+remote_timeout_seconds = 5
+rest_port = 8000
+```
+
+Override with environment variables:
+
+```bash
+export DAIMYO_RULES_PATH="/custom/rules/path"
+export DAIMYO_MASTER_SERVER_URL="http://master.example.com:8000"
+export DAIMYO_CONSOLE_LOG_LEVEL="DEBUG"
+```
+
+## Examples
+
+The `example-daimyo-rules/` directory contains working examples:
+
+### python-general
+
+Base Python development rules with categories for core practices, testing, security, and documentation.
+
+### python-fastapi
+
+FastAPI framework rules extending `python-general` with routing, async patterns, and performance optimization.
+
+### team-backend
+
+Backend team rules extending `python-general` with REST API patterns, database access, and deployment considerations.
+
+### project-api
+
+Demonstrates multiple parent inheritance with `parents: [team-backend, python-fastapi]`:
+
+- Combines team-specific and technology-specific rules
+- Shows priority-based conflict resolution
+- Uses `+` prefix to append to parent rules
+
+## Advanced Topics
+
+### Multiple Parent Inheritance
+
+```yaml
+parents:
+  - high-priority
+  - low-priority
+```
+
+**Commandments**: All rules from all parents are combined (additive)
+
+**Suggestions**: First parent wins in conflicts; use `+` prefix to append instead of replace
+
+### Server Federation
+
+Configure a master server for distributed scope management:
+
+```bash
+export DAIMYO_MASTER_SERVER_URL="http://master.example.com:8000"
+```
+
+The system will:
+
+1. Look for scopes locally
+2. Look for scopes on the master server
+3. Merge both if found in both locations (local extends remote)
+
+### Scope Sharding
+
+The same scope name can exist on both master server and locally. When both exist, they are merged with the remote version as the base and the local version extending it.
+
+## Development
+
+### Running Tests
+
+```bash
+pip install -e ".[dev]"
+pytest
+pytest --cov=daimyo
+```
+
+### Code Quality
+
+```bash
+mypy daimyo
+ruff check daimyo
+ruff format daimyo
+```
+
+## License
+
+MIT

daimyo-1.0.0/README.md

@@ -0,0 +1,262 @@
+# Daimyo - Rules Server for Agents
+
+A Python server providing rules to AI agents through REST and MCP interfaces. Supports scope-based rules with inheritance, categories for filtering, and server federation for distributed rule management.
+
+## Features
+
+- **Multiple Interfaces**: REST API, MCP (Model Context Protocol), and CLI
+- **Scope Inheritance**: Single and multiple parent inheritance with priority-based conflict resolution
+- **Rule Types**: Commandments (MUST) and Suggestions (SHOULD)
+- **Categories**: Organize rules into hierarchical categories for selective retrieval
+- **Server Federation**: Distribute scopes across multiple servers with automatic merging
+- **Multiple Formats**: Output as YAML, JSON, or Markdown
+- **Clean Architecture**: Domain-driven design with clear separation of concerns
+
+## Installation
+
+```bash
+pip install daimyo
+```
+
+Or install from source:
+
+```bash
+git clone https://gitlab.com/Kencho1/daimyo.git
+cd daimyo
+pip install -e .
+```
+
+## Quick Start
+
+### 1. Set Up Your Rules
+
+```bash
+cp -r example-daimyo-rules daimyo-rules
+```
+
+### 2. Start the Server
+
+```bash
+daimyo serve
+```
+
+### 3. Access the API
+
+Visit http://localhost:8000/docs for interactive API documentation.
+
+```bash
+curl http://localhost:8000/api/v1/scopes/python-general/rules
+```
+
+## Core Concepts
+
+### Scopes
+
+Scopes represent organizational contexts (company, team, project). Each scope is a directory containing:
+
+- `metadata.yml` - Scope configuration and parent references
+- `commandments.yml` - Mandatory rules (MUST)
+- `suggestions.yml` - Recommended rules (SHOULD)
+
+```text
+daimyo-rules/
+├── python-general/
+│   ├── metadata.yml
+│   ├── commandments.yml
+│   └── suggestions.yml
+└── team-backend/
+    ├── metadata.yml
+    ├── commandments.yml
+    └── suggestions.yml
+```
+
+### Metadata Format
+
+```yaml
+name: scope-name
+description: Human-readable description
+parents:
+  - parent-scope-1
+  - parent-scope-2
+tags:
+  team: backend
+  language: python
+```
+
+**Fields:**
+
+- `name`: Scope identifier (must match directory name)
+- `description`: Human-readable description
+- `parents`: List of parent scopes (first = highest priority)
+- `tags`: Key-value pairs for categorization
+
+### Categories
+
+Categories are hierarchical subdivisions within rules:
+
+```yaml
+python.web.testing:
+  when: When testing web interfaces
+  ruleset:
+    - Use playwright for acceptance tests
+    - Use pytest fixtures for test setup
+```
+
+### Rule Types
+
+**Commandments (MUST)**: Mandatory rules that accumulate through inheritance
+
+**Suggestions (SHOULD)**: Recommended rules that can be overridden or appended with `+` prefix
+
+## Usage
+
+### REST API
+
+Start the server:
+
+```bash
+daimyo serve
+daimyo serve --host 0.0.0.0 --port 8080
+```
+
+Get rules:
+
+```bash
+curl http://localhost:8000/api/v1/scopes/python-general/rules
+
+curl -H "Accept: application/json" \
+  http://localhost:8000/api/v1/scopes/python-general/rules
+
+curl -H "Accept: text/markdown" \
+  http://localhost:8000/api/v1/scopes/python-general/rules
+```
+
+Filter by categories:
+
+```bash
+curl "http://localhost:8000/api/v1/scopes/team-backend/rules?categories=python.web,python.testing"
+```
+
+### MCP Server
+
+Start the MCP server:
+
+```bash
+daimyo mcp
+daimyo mcp --transport sse
+```
+
+Available tools:
+
+- `get_rules(scope_name, categories?)` - Get formatted rules
+- `list_scopes()` - List available scopes
+- `apply_scope_rules(scope_name, categories?)` - Get prompt template with rules
+
+### CLI Commands
+
+```bash
+daimyo list-scopes
+daimyo show python-general
+daimyo --version
+```
+
+## Configuration
+
+Configuration is managed via `config/settings.toml` or environment variables:
+
+```toml
+[default]
+rules_path = "./daimyo-rules"
+console_log_level = "WARNING"
+file_log_level = "INFO"
+max_inheritance_depth = 10
+master_server_url = ""
+remote_timeout_seconds = 5
+rest_port = 8000
+```
+
+Override with environment variables:
+
+```bash
+export DAIMYO_RULES_PATH="/custom/rules/path"
+export DAIMYO_MASTER_SERVER_URL="http://master.example.com:8000"
+export DAIMYO_CONSOLE_LOG_LEVEL="DEBUG"
+```
+
+## Examples
+
+The `example-daimyo-rules/` directory contains working examples:
+
+### python-general
+
+Base Python development rules with categories for core practices, testing, security, and documentation.
+
+### python-fastapi
+
+FastAPI framework rules extending `python-general` with routing, async patterns, and performance optimization.
+
+### team-backend
+
+Backend team rules extending `python-general` with REST API patterns, database access, and deployment considerations.
+
+### project-api
+
+Demonstrates multiple parent inheritance with `parents: [team-backend, python-fastapi]`:
+
+- Combines team-specific and technology-specific rules
+- Shows priority-based conflict resolution
+- Uses `+` prefix to append to parent rules
+
+## Advanced Topics
+
+### Multiple Parent Inheritance
+
+```yaml
+parents:
+  - high-priority
+  - low-priority
+```
+
+**Commandments**: All rules from all parents are combined (additive)
+
+**Suggestions**: First parent wins in conflicts; use `+` prefix to append instead of replace
+
+### Server Federation
+
+Configure a master server for distributed scope management:
+
+```bash
+export DAIMYO_MASTER_SERVER_URL="http://master.example.com:8000"
+```
+
+The system will:
+
+1. Look for scopes locally
+2. Look for scopes on the master server
+3. Merge both if found in both locations (local extends remote)
+
+### Scope Sharding
+
+The same scope name can exist on both master server and locally. When both exist, they are merged with the remote version as the base and the local version extending it.
+
+## Development
+
+### Running Tests
+
+```bash
+pip install -e ".[dev]"
+pytest
+pytest --cov=daimyo
+```
+
+### Code Quality
+
+```bash
+mypy daimyo
+ruff check daimyo
+ruff format daimyo
+```
+
+## License
+
+MIT

daimyo-1.0.0/daimyo/__init__.py

@@ -0,0 +1,11 @@
+"""
+Daimyo - Rules Server for Agents
+
+A Python server providing rules to agents through REST and MCP interfaces.
+Supports scope-based rules with inheritance, categories for filtering,
+and server federation for distributed rule management.
+"""
+
+__version__ = "1.0.0"
+
+__all__ = ["__version__"]