feat: Initial Python project setup with monorepo structure (#4)

* feat: Initial Python project setup with monorepo structure

Set up the morphir-python project as a production-ready Python port of Morphir
with a monorepo structure supporting separate library and tools packages.

Project infrastructure:
- mise for tool management (Python 3.14, uv)
- uv workspace with two packages: morphir (core library) and morphir-tools (CLI)
- Strict type checking with mypy and pyright
- Linting and formatting with ruff (Google-style docstrings)
- Testing with pytest (unit) and behave (BDD)
- GitHub Actions CI/CD workflows
- Pre-commit hooks configuration

Documentation:
- Updated README.md with installation and development instructions
- Created AGENTS.md with guidelines for code agents
- Created .agents/skills/README.md for agentic skills (Agent Skills spec)

This establishes the foundation for implementing the Morphir IR models and
tooling in Python, following functional programming principles.

* fix(ci): Add uv.lock for reproducible CI builds

* fix(ci): Use --all-groups to install workspace packages

* fix(ci): Install workspace packages in editable mode for tests

* refactor(ci): Use mise tasks for consistent CI/local development

- Add 'install' task to handle dependency sync and workspace package installation
- Update CI workflow to use mise-action and mise tasks
- Add XML coverage output to coverage task for CI reporting

* fix: Add future annotations to prevent NameError with TYPE_CHECKING imports

Add 'from __future__ import annotations' to defer annotation evaluation,
preventing NameError when Context type is only imported under TYPE_CHECKING.

Author: DamianReeves

.agents/skills/README.md

@@ -0,0 +1,85 @@
+# Agent Skills
+
+This directory contains agentic skills for the Morphir Python project, following the [Agent Skills Specification](https://agentskills.io/).
+
+## What are Agent Skills?
+
+Agent Skills are folders of instructions, scripts, and resources that AI agents can discover and use to perform tasks more accurately and efficiently. They provide a simple, open format for extending agent capabilities with:
+
+- **Procedural knowledge** - Step-by-step instructions for complex tasks
+- **Contextual information** - Project-specific knowledge
+- **Scripts** - Executable code for common operations
+- **References** - Additional documentation
+
+## Directory Structure
+
+Each skill should be in its own subdirectory with a `SKILL.md` file:
+
+```
+.agents/skills/
+├── README.md              # This file
+├── skill-name/
+│   ├── SKILL.md          # Required - skill definition
+│   ├── scripts/          # Optional - executable scripts
+│   ├── references/       # Optional - additional docs
+│   └── assets/           # Optional - templates, data files
+└── another-skill/
+    └── SKILL.md
+```
+
+## SKILL.md Format
+
+Each skill must have a `SKILL.md` file with YAML frontmatter:
+
+```yaml
+---
+name: skill-name
+description: A description of what this skill does and when to use it.
+license: Apache-2.0
+compatibility: Requirements (e.g., "Requires Python 3.14+")
+metadata:
+  author: finos
+  version: "1.0"
+---
+
+# Skill Instructions
+
+Step-by-step instructions for the skill...
+```
+
+### Required Fields
+
+| Field | Description |
+|-------|-------------|
+| `name` | Lowercase, hyphenated name (must match directory name) |
+| `description` | What the skill does and when to use it (max 1024 chars) |
+
+### Optional Fields
+
+| Field | Description |
+|-------|-------------|
+| `license` | License for the skill |
+| `compatibility` | Environment requirements |
+| `metadata` | Additional key-value metadata |
+| `allowed-tools` | Pre-approved tools for the skill |
+
+## Creating a New Skill
+
+1. Create a directory with your skill name (lowercase, hyphenated)
+2. Add a `SKILL.md` file with the required frontmatter
+3. Add any supporting scripts, references, or assets
+4. Test the skill with an agent to verify it works correctly
+
+## Validation
+
+Use the reference library to validate skills:
+
+```bash
+npx skills-ref validate ./skill-name
+```
+
+## Resources
+
+- [Agent Skills Specification](https://agentskills.io/specification)
+- [Example Skills](https://github.com/anthropics/skills)
+- [Reference Library](https://github.com/agentskills/agentskills/tree/main/skills-ref)

.config/mise/config.toml

@@ -0,0 +1,9 @@
+[tools]
+python = "3.14"
+uv = "latest"
+
+[env]
+VIRTUAL_ENV = "{{config_root}}/.venv"
+
+[settings]
+experimental = true

.config/mise/tasks/build

@@ -0,0 +1,11 @@
+#!/usr/bin/env bash
+#MISE description="Build all packages"
+set -euo pipefail
+
+echo "Building morphir package..."
+uv build packages/morphir
+
+echo "Building morphir-tools package..."
+uv build packages/morphir-tools
+
+echo "Build complete!"

.config/mise/tasks/check

@@ -0,0 +1,6 @@
+#!/usr/bin/env bash
+#MISE description="Run all checks (lint, format, typecheck, tests)"
+#MISE depends=["lint", "format-check", "typecheck", "test-all"]
+set -euo pipefail
+
+echo "All checks passed!"

.config/mise/tasks/clean

@@ -0,0 +1,17 @@
+#!/usr/bin/env bash
+#MISE description="Clean build artifacts and caches"
+set -euo pipefail
+
+echo "Cleaning build artifacts..."
+rm -rf build/ dist/ .eggs/
+find . -type d -name "*.egg-info" -exec rm -rf {} + 2>/dev/null || true
+find . -type d -name "__pycache__" -exec rm -rf {} + 2>/dev/null || true
+find . -type f -name "*.py[cod]" -delete 2>/dev/null || true
+
+echo "Cleaning test artifacts..."
+rm -rf .pytest_cache/ .coverage htmlcov/ coverage.xml .hypothesis/
+
+echo "Cleaning type checker caches..."
+rm -rf .mypy_cache/ .ruff_cache/ .pyright/
+
+echo "Clean complete!"

.config/mise/tasks/coverage

@@ -0,0 +1,5 @@
+#!/usr/bin/env bash
+#MISE description="Run tests with coverage report"
+set -euo pipefail
+
+uv run pytest tests/ --cov=packages/morphir/src --cov=packages/morphir-tools/src --cov-report=term-missing --cov-report=html --cov-report=xml

.config/mise/tasks/format

@@ -0,0 +1,5 @@
+#!/usr/bin/env bash
+#MISE description="Run ruff formatter on the codebase"
+set -euo pipefail
+
+uv run ruff format .

.config/mise/tasks/format-check

@@ -0,0 +1,5 @@
+#!/usr/bin/env bash
+#MISE description="Check code formatting without making changes"
+set -euo pipefail
+
+uv run ruff format --check .

.config/mise/tasks/install

@@ -0,0 +1,11 @@
+#!/usr/bin/env bash
+#MISE description="Install all dependencies and workspace packages"
+set -euo pipefail
+
+echo "Syncing dependencies..."
+uv sync --all-groups
+
+echo "Installing workspace packages in editable mode..."
+uv pip install -e packages/morphir -e packages/morphir-tools
+
+echo "Install complete!"

.config/mise/tasks/lint

@@ -0,0 +1,5 @@
+#!/usr/bin/env bash
+#MISE description="Run ruff linter on the codebase"
+set -euo pipefail
+
+uv run ruff check .