enya-agent 0.1.0

package/docs/static/giallo-light.css

@@ -0,0 +1,91 @@
+/*
+ * theme "github-light" generated by giallo
+ */
+
+.z-code {
+  color: #24292E;
+  background-color: #FFFFFF;
+}
+
+.z-hl {
+  background-color: #F6F8FA;
+}
+
+.giallo-ln {
+  color: #1B1F234D;
+}
+
+.z-comment { color: #6A737D; }
+.z-constant { color: #005CC5; }
+.z-entity { color: #6F42C1; }
+.z-keyword { color: #D73A49; }
+.z-storage { color: #D73A49; }
+.z-string { color: #032F62; }
+.z-support { color: #005CC5; }
+.z-variable { color: #E36209; }
+.z-carriage-return { color: #FAFBFC; background-color: #D73A49; font-style: italic;text-decoration: underline; }
+.z-variable { color: #005CC5; }
+.z-source { color: #032F62; }
+.z-string.z-comment { color: #6A737D; }
+.z-variable.z-language { color: #005CC5; }
+.z-entity.z-name { color: #6F42C1; }
+.z-storage.z-type { color: #D73A49; }
+.z-meta.z-property-name { color: #005CC5; }
+.z-variable.z-other { color: #24292E; }
+.z-invalid.z-broken { color: #B31D28; font-style: italic; }
+.z-invalid.z-deprecated { color: #B31D28; font-style: italic; }
+.z-invalid.z-illegal { color: #B31D28; font-style: italic; }
+.z-invalid.z-unimplemented { color: #B31D28; font-style: italic; }
+.z-message.z-error { color: #B31D28; }
+.z-source.z-regexp { color: #032F62; }
+.z-string.z-regexp { color: #032F62; }
+.z-support.z-constant { color: #005CC5; }
+.z-support.z-variable { color: #005CC5; }
+.z-meta.z-module-reference { color: #005CC5; }
+.z-markup.z-heading { color: #005CC5; font-weight: bold; }
+.z-markup.z-quote { color: #22863A; }
+.z-markup.z-italic { color: #24292E; font-style: italic; }
+.z-markup.z-bold { color: #24292E; font-weight: bold; }
+.z-markup.z-underline { text-decoration: underline; }
+.z-markup.z-strikethrough { text-decoration: line-through; }
+.z-markup.z-deleted { color: #B31D28; background-color: #FFEEF0; }
+.z-markup.z-inserted { color: #22863A; background-color: #F0FFF4; }
+.z-markup.z-changed { color: #E36209; background-color: #FFEBDA; }
+.z-markup.z-ignored { color: #F6F8FA; background-color: #005CC5; }
+.z-markup.z-untracked { color: #F6F8FA; background-color: #005CC5; }
+.z-meta.z-separator { color: #005CC5; font-weight: bold; }
+.z-meta.z-output { color: #005CC5; }
+.z-brackethighlighter.z-tag { color: #586069; }
+.z-brackethighlighter.z-curly { color: #586069; }
+.z-brackethighlighter.z-round { color: #586069; }
+.z-brackethighlighter.z-square { color: #586069; }
+.z-brackethighlighter.z-angle { color: #586069; }
+.z-brackethighlighter.z-quote { color: #586069; }
+.z-brackethighlighter.z-unmatched { color: #B31D28; }
+.z-entity.z-name { color: #005CC5; font-weight: bold; }
+.z-punctuation.z-definition.z-comment { color: #6A737D; }
+.z-entity.z-name.z-constant { color: #005CC5; }
+.z-variable.z-other.z-constant { color: #005CC5; }
+.z-variable.z-other.z-enummember { color: #005CC5; }
+.z-variable.z-parameter.z-function { color: #24292E; }
+.z-entity.z-name.z-tag { color: #22863A; }
+.z-storage.z-modifier.z-package { color: #24292E; }
+.z-storage.z-modifier.z-import { color: #24292E; }
+.z-storage.z-type.z-java { color: #24292E; }
+.z-punctuation.z-definition.z-string { color: #032F62; }
+.z-string.z-regexp.z-character-class { color: #032F62; }
+.z-markup.z-inline.z-raw { color: #005CC5; }
+.z-punctuation.z-definition.z-deleted { color: #B31D28; background-color: #FFEEF0; }
+.z-punctuation.z-definition.z-inserted { color: #22863A; background-color: #F0FFF4; }
+.z-punctuation.z-definition.z-changed { color: #E36209; background-color: #FFEBDA; }
+.z-meta.z-diff.z-range { color: #6F42C1; font-weight: bold; }
+.z-meta.z-diff.z-header { color: #005CC5; }
+.z-string.z-other.z-link { color: #032F62; text-decoration: underline; }
+.z-constant.z-character.z-escape { color: #032F62; }
+.z-source.z-ruby.z-embedded { color: #032F62; }
+.z-string.z-regexp.z-arbitrary-repitition { color: #032F62; }
+.z-constant.z-character.z-escape { color: #22863A; font-weight: bold; }
+.z-meta.z-diff.z-header.z-from-file { color: #B31D28; background-color: #FFEEF0; }
+.z-meta.z-diff.z-header.z-to-file { color: #22863A; background-color: #F0FFF4; }
+.z-constant.z-other.z-reference.z-link { color: #032F62; text-decoration: underline; }
+.z-punctuation.z-definition.z-list.z-begin.z-markdown { color: #E36209; }

package/docs/themes/tanuki/.github/workflows/deploy.yml

@@ -0,0 +1,44 @@
+name: Deploy to GitHub Pages
+
+on:
+  push:
+    branches: [main]
+  workflow_dispatch:
+
+permissions:
+  contents: read
+  pages: write
+  id-token: write
+
+concurrency:
+  group: "pages"
+  cancel-in-progress: false
+
+jobs:
+  build:
+    runs-on: ubuntu-latest
+    steps:
+      - name: Checkout
+        uses: actions/checkout@v4
+
+      - name: Install mise
+        uses: jdx/mise-action@v2
+
+      - name: Build all examples
+        run: mise run build
+
+      - name: Upload artifact
+        uses: actions/upload-pages-artifact@v3
+        with:
+          path: ./public
+
+  deploy:
+    environment:
+      name: github-pages
+      url: ${{ steps.deployment.outputs.page_url }}
+    runs-on: ubuntu-latest
+    needs: build
+    steps:
+      - name: Deploy to GitHub Pages
+        id: deployment
+        uses: actions/deploy-pages@v4

package/docs/themes/tanuki/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2024 Raffael Schneider / raskell.io
+
+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.

package/docs/themes/tanuki/README.md

@@ -0,0 +1,166 @@
+<div align="center">
+
+<h1 align="center">
+  <img src="static/img/tanuki-icon.png" alt="tanuki mascot" width="96" />
+  <br>
+  Tanuki
+</h1>
+
+<p align="center">
+  <em>An opinionated Zola theme for documentation, books, and blogs.</em><br>
+  <em>Beautiful, accessible, and thoughtfully designed.</em>
+</p>
+
+<p align="center">
+  <a href="https://www.getzola.org/">
+    <img alt="Zola" src="https://img.shields.io/badge/Zola-0.19+-000000?logo=zola&logoColor=white&style=for-the-badge">
+  </a>
+  <a href="https://catppuccin.com/">
+    <img alt="Catppuccin" src="https://img.shields.io/badge/Catppuccin-cba6f7?style=for-the-badge">
+  </a>
+  <a href="LICENSE">
+    <img alt="License" src="https://img.shields.io/badge/License-MIT-a6e3a1?style=for-the-badge">
+  </a>
+</p>
+
+<p align="center">
+  <a href="https://tanuki.raskell.io">Live Demo</a> •
+  <a href="https://tanuki.raskell.io/docs/">Documentation</a> •
+  <a href="https://tanuki.raskell.io/book/">Book Example</a> •
+  <a href="https://tanuki.raskell.io/blog/">Blog Example</a>
+</p>
+
+<hr />
+
+</div>
+
+![Tanuki Theme](screenshot.png)
+
+## Features
+
+- **Three Modes** — Documentation (with versioning), Book, and Blog layouts
+- **Catppuccin Colors** — Soothing Mocha (dark) and Latte (light) palettes
+- **Geist Typography** — Clean, readable variable fonts
+- **Lucide Icons** — Crisp, consistent iconography
+- **Resizable Sidebar** — Drag to resize, persists across sessions
+- **Full-text Search** — Elasticlunr-powered instant search
+- **Dark/Light Toggle** — Three-way toggle with system preference detection
+- **Print Support** — Print all pages as a single document (docs/book modes)
+- **Keyboard Navigation** — Arrow keys for prev/next, `/` for search
+- **SEO & Accessibility** — JSON-LD structured data, ARIA landmarks, semantic HTML
+
+## Installation
+
+```bash
+cd your-zola-site
+git clone https://github.com/raskell-io/tanuki themes/tanuki
+```
+
+Or as a git submodule:
+
+```bash
+git submodule add https://github.com/raskell-io/tanuki themes/tanuki
+```
+
+## Quick Start
+
+### Documentation Mode
+
+```toml
+base_url = "https://docs.example.com"
+title = "My Project Docs"
+theme = "tanuki"
+build_search_index = true
+
+[markdown]
+highlight_code = true
+highlight_theme = "css"
+
+[extra]
+mode = "docs"
+github = "https://github.com/you/project"
+
+# Optional: version picker
+[extra.versions]
+current = "2.0.0"
+list = [
+    { version = "2.0.0", url = "/", label = "latest" },
+    { version = "1.0.0", url = "/v1/" },
+]
+```
+
+### Book Mode
+
+```toml
+base_url = "https://book.example.com"
+title = "The Complete Guide"
+theme = "tanuki"
+build_search_index = true
+
+[markdown]
+highlight_code = true
+highlight_theme = "css"
+
+[extra]
+mode = "book"
+github = "https://github.com/you/book"
+```
+
+### Blog Mode
+
+```toml
+base_url = "https://blog.example.com"
+title = "My Blog"
+theme = "tanuki"
+generate_feeds = true
+
+taxonomies = [
+    { name = "tags", feed = true },
+]
+
+[markdown]
+highlight_code = true
+highlight_theme = "css"
+
+[extra]
+mode = "blog"
+
+[extra.hero]
+title = "Welcome to my blog"
+subtitle = "Thoughts on code and craft"
+
+[[extra.nav]]
+name = "Blog"
+url = "/blog/"
+
+[[extra.nav]]
+name = "About"
+url = "/about/"
+```
+
+## Keyboard Shortcuts
+
+| Key | Action |
+|-----|--------|
+| `←` / `→` | Previous / Next page |
+| `/` | Open search |
+| `Esc` | Close overlays |
+
+## Browser Support
+
+Modern browsers (Chrome 88+, Firefox 78+, Safari 14+, Edge 88+)
+
+## Credits
+
+- [Catppuccin](https://catppuccin.com) — Color palette
+- [Geist](https://vercel.com/font) — Typography
+- [Lucide](https://lucide.dev) — Icons
+- [Zola](https://www.getzola.org) — Static site generator
+
+## License
+
+[MIT](LICENSE)
+
+---
+
+<p align="center">Made with care by <a href="https://raskell.io">raskell.io</a></p>

package/docs/themes/tanuki/examples/blog/config.toml

@@ -0,0 +1,58 @@
+# Tanuki Theme - Blog/Personal Site Example
+base_url = "/tanuki/blog"
+title = "Alex Chen"
+description = "Software developer writing about web technologies, design, and the craft of building things."
+theme = "tanuki"
+compile_sass = true
+build_search_index = true
+generate_feeds = true
+feed_filenames = ["rss.xml"]
+
+taxonomies = [
+    { name = "tags", feed = true },
+]
+
+[markdown]
+highlight_code = true
+highlight_theme = "base16-ocean-dark"
+
+[extra]
+mode = "blog"
+show_theme_toggle = true
+show_about_section = true
+
+# Author info
+[extra.author]
+name = "Alex Chen"
+bio = "Software developer and open source enthusiast."
+# avatar = "images/avatar.jpg"
+
+# Hero section
+[extra.hero]
+title = "Hey, I'm Alex"
+subtitle = "I build things for the web and write about what I learn along the way."
+[extra.hero.cta]
+text = "Read the blog"
+url = "/tanuki/blog/blog/"
+
+# About preview on homepage
+[extra.about]
+summary = "I'm a software developer passionate about web technologies, developer experience, and building tools that make other developers' lives easier."
+
+# Social links
+[extra.social]
+github = "https://github.com/username"
+twitter = "https://twitter.com/username"
+
+# Navigation
+[[extra.nav]]
+name = "Blog"
+url = "/tanuki/blog/blog/"
+
+[[extra.nav]]
+name = "Projects"
+url = "/tanuki/blog/projects/"
+
+[[extra.nav]]
+name = "About"
+url = "/tanuki/blog/about/"

package/docs/themes/tanuki/examples/blog/content/_index.md

@@ -0,0 +1,4 @@
++++
+title = "Home"
+template = "home.html"
++++

package/docs/themes/tanuki/examples/blog/content/about.md

@@ -0,0 +1,33 @@
++++
+title = "About"
+description = "A little bit about me and what I do."
+template = "page.html"
+path = "about"
++++
+
+# About Me
+
+Hey there! I'm a software developer passionate about building things for the web. I spend most of my time writing code, learning new technologies, and occasionally writing about what I've learned.
+
+## What I Do
+
+By day, I work on web applications—everything from frontend interfaces to backend APIs. I particularly enjoy:
+
+- **Frontend Development**: React, Vue, and modern CSS
+- **Backend Systems**: Node.js, Rust, and databases
+- **Developer Experience**: Tooling, automation, and workflows
+- **Open Source**: Contributing to and maintaining projects
+
+## This Site
+
+This site is built with [Zola](https://www.getzola.org/) and the Tanuki theme. It's where I share articles about web development, design patterns, and lessons learned along the way.
+
+The source code is available on [GitHub](https://github.com/example/blog) if you're curious about how it's built.
+
+## Get in Touch
+
+- **GitHub**: [@username](https://github.com/username)
+- **Twitter**: [@username](https://twitter.com/username)
+- **Email**: hello@example.com
+
+Feel free to reach out if you want to chat about tech, have questions about my articles, or just want to say hi.

package/docs/themes/tanuki/examples/blog/content/blog/_index.md

@@ -0,0 +1,7 @@
++++
+title = "Blog"
+description = "Thoughts on web development, design, and technology."
+sort_by = "date"
+template = "blog.html"
+paginate_by = 10
++++

package/docs/themes/tanuki/examples/blog/content/blog/api-design-best-practices.md

@@ -0,0 +1,245 @@
++++
+title = "REST API Design Best Practices"
+description = "Good API design makes the difference between a joy to use and a nightmare to integrate. Here's how to get it right."
+date = 2024-12-22
+[taxonomies]
+tags = ["api", "rest", "backend"]
++++
+
+# REST API Design Best Practices
+
+Your API is a contract. Make it one developers actually want to sign.
+
+## Use Nouns, Not Verbs
+
+The HTTP method is the verb. The URL is the noun.
+
+```
+# Bad
+GET /getUsers
+POST /createUser
+DELETE /deleteUser/123
+
+# Good
+GET /users
+POST /users
+DELETE /users/123
+```
+
+## Use Plural Resource Names
+
+Consistency matters more than grammar debates:
+
+```
+GET /users        # List users
+GET /users/123    # Get one user
+POST /users       # Create user
+PUT /users/123    # Update user
+DELETE /users/123 # Delete user
+```
+
+## Nest Related Resources
+
+Show relationships through URL structure:
+
+```
+GET /users/123/posts      # Posts by user 123
+GET /posts/456/comments   # Comments on post 456
+```
+
+But don't nest too deeply:
+
+```
+# Too deep
+GET /users/123/posts/456/comments/789/likes
+
+# Better: use query params or separate endpoint
+GET /likes?comment=789
+```
+
+## HTTP Status Codes
+
+Use them correctly:
+
+| Code | Meaning | When to Use |
+|------|---------|-------------|
+| 200 | OK | Successful GET, PUT, PATCH |
+| 201 | Created | Successful POST |
+| 204 | No Content | Successful DELETE |
+| 400 | Bad Request | Invalid syntax, validation errors |
+| 401 | Unauthorized | Missing/invalid authentication |
+| 403 | Forbidden | Authenticated but not allowed |
+| 404 | Not Found | Resource doesn't exist |
+| 409 | Conflict | Duplicate resource, version conflict |
+| 422 | Unprocessable | Valid syntax but semantic errors |
+| 429 | Too Many Requests | Rate limit exceeded |
+| 500 | Server Error | Something broke |
+
+## Consistent Error Format
+
+Always return errors in the same shape:
+
+```json
+{
+    "error": {
+        "code": "VALIDATION_ERROR",
+        "message": "Invalid input data",
+        "details": [
+            {
+                "field": "email",
+                "message": "Must be a valid email address"
+            },
+            {
+                "field": "age",
+                "message": "Must be at least 18"
+            }
+        ]
+    }
+}
+```
+
+## Pagination
+
+For any list endpoint, support pagination:
+
+```
+GET /posts?page=2&limit=20
+```
+
+Return pagination metadata:
+
+```json
+{
+    "data": [...],
+    "pagination": {
+        "page": 2,
+        "limit": 20,
+        "total": 156,
+        "pages": 8
+    }
+}
+```
+
+Or use cursor-based pagination for large datasets:
+
+```
+GET /posts?cursor=eyJpZCI6MTAwfQ&limit=20
+```
+
+## Filtering and Sorting
+
+Use query parameters:
+
+```
+GET /posts?status=published&author=123
+GET /posts?sort=-created_at,title
+GET /posts?created_after=2024-01-01
+```
+
+The `-` prefix indicates descending order.
+
+## Partial Responses
+
+Let clients request only what they need:
+
+```
+GET /users/123?fields=id,name,email
+```
+
+Response:
+
+```json
+{
+    "id": 123,
+    "name": "Jane Doe",
+    "email": "jane@example.com"
+}
+```
+
+## Versioning
+
+Version your API from day one:
+
+```
+# URL path (most common)
+GET /v1/users
+
+# Header
+GET /users
+Accept: application/vnd.api+json;version=1
+
+# Query param (least preferred)
+GET /users?version=1
+```
+
+## Rate Limiting Headers
+
+Tell clients their limits:
+
+```
+X-RateLimit-Limit: 1000
+X-RateLimit-Remaining: 999
+X-RateLimit-Reset: 1640995200
+```
+
+## HATEOAS (Hypermedia)
+
+Include links for discoverability:
+
+```json
+{
+    "id": 123,
+    "title": "API Design",
+    "links": {
+        "self": "/posts/123",
+        "author": "/users/456",
+        "comments": "/posts/123/comments"
+    }
+}
+```
+
+## Idempotency
+
+Make operations safe to retry:
+
+```
+# Idempotent (safe to retry)
+GET /users/123
+PUT /users/123  # Full replacement
+DELETE /users/123
+
+# Not idempotent
+POST /users  # Creates new each time
+```
+
+For non-idempotent operations, accept an idempotency key:
+
+```
+POST /payments
+Idempotency-Key: abc123
+
+# Retrying with same key returns cached response
+```
+
+## Documentation
+
+Good APIs have good docs:
+
+- **OpenAPI/Swagger**: Machine-readable spec
+- **Examples**: Show request/response pairs
+- **Authentication**: Clear setup instructions
+- **Errors**: Document all error codes
+- **Changelog**: Track breaking changes
+
+## Quick Checklist
+
+- [ ] Consistent naming conventions
+- [ ] Proper HTTP status codes
+- [ ] Structured error responses
+- [ ] Pagination for lists
+- [ ] Rate limiting
+- [ ] API versioning
+- [ ] Authentication documented
+- [ ] OpenAPI specification
+
+Good API design is invisible—developers just get things working without friction.