Merge branch 'main' into pr/ink-pad/678

Author: jakelorocco

.github/CODEOWNERS

@@ -3,3 +3,7 @@
 
 # Mellea Core requires special review
 /mellea/core/ @nrfulton @jakelorocco
+
+# Mellea Intrinsics
+/mellea/formatters/granite @generative-computing/mellea-intrinsics
+/test/formatters/granite @generative-computing/mellea-intrinsics

CONTRIBUTING.md

@@ -424,7 +424,6 @@ print(m.last_prompt())
 ### Documentation
 
 - **[Docs writing guide](docs/docs/guide/CONTRIBUTING.md)** - Conventions, PR checklist, and review process for documentation contributions
-- **[Tutorial](docs/tutorial.md)** - Comprehensive guide to Mellea concepts
 - **[API Documentation](https://docs.mellea.ai)** - Published documentation site
 - **[Test Markers Guide](test/MARKERS_GUIDE.md)** - Detailed pytest marker documentation
 - **[AGENTS.md](AGENTS.md)** - Guidelines for AI assistants working on Mellea internals
@@ -452,4 +451,4 @@ Help us improve this guide by opening a PR with your additions!
 
 ---
 
-Thank you for contributing to Mellea! 🎉
+Thank you for contributing to Mellea! 🎉

README.md

@@ -182,11 +182,6 @@ if __name__ == "__main__":
 ```
 
 
-
-## Tutorial
-
-See the [tutorial](docs/tutorial.md)
-
 ## Contributing
 
 We welcome contributions to Mellea! There are several ways to contribute:

docs/docs/examples/index.md

@@ -49,6 +49,12 @@ to run.
 | `tools/` | `@tool` definition, code interpreter integration, tool argument validation, safe `eval` patterns |
 | `mini_researcher/` | Complete research assistant: multi-model architecture, document retrieval, safety checks, custom validation pipeline |
 
+### Extensibility
+
+| Category | What it shows |
+| -------- | ------------- |
+| `plugins/` | Plugin system end-to-end: function hooks, class-based plugins, payload modification, scoped and session-scoped plugins, `PluginSet` composition, execution modes, tool hooks, and testing patterns |
+
 ### Safety and validation
 
 | Category | What it shows |
@@ -60,6 +66,7 @@ to run.
 | Category | What it shows |
 | -------- | ------------- |
 | `m_serve/` | Deploying Mellea programs as REST APIs with production deployment patterns |
+| `m_decompose/` | Decomposing complex prompts into sub-tasks via the CLI and Python API |
 | `library_interop/` | LangChain message conversion, OpenAI format compatibility, cross-library workflows |
 | `mcp/` | MCP tool creation, Claude Desktop integration, Langflow integration |
 | `bedrock/` | Amazon Bedrock backend configuration and usage |
@@ -90,6 +97,14 @@ to run.
 | -------- | ------------- |
 | `melp/` | ⚠️ Experimental lazy evaluation — thunks, deferred execution, advanced control flow |
 
+### Getting started and tutorials
+
+| Category | What it shows |
+| -------- | ------------- |
+| `hello_world.py` | Minimal single-file starting point |
+| `tutorial/` | Python script versions of the tutorials: email generation, IVR, generative slots, contexts, MObjects, model options, and more |
+| `notebooks/` | Jupyter notebook versions of the same tutorials for interactive, cell-by-cell exploration |
+
 ---
 
 ## Running the examples

docs/docs/guide/CONTRIBUTING.md

@@ -251,6 +251,15 @@ Where a CI-tested example exists in `docs/examples/`, link it:
 
 Only link examples that are current and in CI.
 
+### Keeping the examples catalogue up to date
+
+Check that every example directory under `docs/examples/` has a corresponding
+row in the catalogue table in `docs/docs/examples/index.md`. When adding a new
+example directory, add a row with a short description of what the examples
+demonstrate. This ensures users browsing the published docs can discover all
+available examples, not only the ones linked from individual guide or concept
+pages.
+
 ---
 
 ## Missing content

docs/examples/intrinsics/README.md

@@ -13,9 +13,6 @@ Core example showing how to directly use intrinsics with adapters.
 - Working with Granite Common adapters (aLoRA-based)
 - Understanding adapter output formats
 
-### answer_relevance.py
-Evaluates whether an answer is relevant to a question.
-
 ### answerability.py
 Checks if a question can be answered given the context.
 
@@ -83,7 +80,6 @@ out, new_ctx = mfuncs.act(
 ## Available Intrinsics
 
 - **requirement_check**: Validate requirements (used by ALoraRequirement)
-- **answer_relevance**: Check answer-question relevance
 - **answerability**: Determine if question is answerable
 - **citations**: Extract and validate citations
 - **context_relevance**: Assess context-query relevance