commit b445d8a1179d2d88551a08c2a741fa7b84238200
Author: Jacob Mathison <jacob@mathisonprojects.com>
Date:   Tue Jul 21 11:10:20 2026 -0500

    feat: scaffold rust llm module controller

diff --git a/.env.example b/.env.example
new file mode 100644
index 0000000..52cb18d
--- /dev/null
+++ b/.env.example
@@ -0,0 +1,11 @@
+# Required: path to a local GGUF model for llama.cpp.
+LLAMA_MODEL_PATH=/absolute/path/to/model.gguf
+
+# Optional llama.cpp server settings.
+LLAMA_HOST=127.0.0.1
+LLAMA_PORT=8080
+LLAMA_CONTEXT_SIZE=
+LLAMA_EXTRA_ARGS=
+
+# Optional controller logging.
+CONTROLLER_LOG_LEVEL=info
diff --git a/.gitea/workflows/ci.yml b/.gitea/workflows/ci.yml
new file mode 100644
index 0000000..db43ceb
--- /dev/null
+++ b/.gitea/workflows/ci.yml
@@ -0,0 +1,32 @@
+name: CI
+
+on:
+  push:
+    branches:
+      - main
+  pull_request:
+
+jobs:
+  validate:
+    runs-on: ubuntu-latest
+    steps:
+      - name: Checkout
+        uses: actions/checkout@v4
+
+      - name: Install Rust if needed
+        shell: bash
+        run: |
+          if ! command -v cargo >/dev/null 2>&1; then
+            curl --proto '=https' --tlsv1.2 -sSf https://sh.rustup.rs | sh -s -- -y --default-toolchain stable
+            echo "$HOME/.cargo/bin" >> "$GITHUB_PATH"
+          fi
+
+      - name: Show Rust versions
+        shell: bash
+        run: |
+          rustc --version
+          cargo --version
+
+      - name: Run precommit checks
+        shell: bash
+        run: scripts/precommit-check.sh
diff --git a/.githooks/pre-commit b/.githooks/pre-commit
new file mode 100755
index 0000000..3b01a42
--- /dev/null
+++ b/.githooks/pre-commit
@@ -0,0 +1,4 @@
+#!/usr/bin/env bash
+set -euo pipefail
+
+exec scripts/precommit-check.sh
diff --git a/.gitignore b/.gitignore
new file mode 100644
index 0000000..1791b5a
--- /dev/null
+++ b/.gitignore
@@ -0,0 +1,9 @@
+/target/
+/.env
+/.env.*
+!/.env.example
+/logs/
+/runtime/
+/dictionary/actions.jsonl
+/dictionary/actions.index.json
+*.log
diff --git a/.woodpecker.yml b/.woodpecker.yml
new file mode 100644
index 0000000..a5f6909
--- /dev/null
+++ b/.woodpecker.yml
@@ -0,0 +1,11 @@
+when:
+  - event: push
+  - event: pull_request
+
+steps:
+  validate:
+    image: rust:1.95
+    commands:
+      - rustc --version
+      - cargo --version
+      - scripts/precommit-check.sh
diff --git a/AGENTS.md b/AGENTS.md
new file mode 100644
index 0000000..e5f8f4e
--- /dev/null
+++ b/AGENTS.md
@@ -0,0 +1,69 @@
+# AGENTS.md
+
+## Project
+
+`mp-ai-module-controller` is a Rust CLI scaffold for local llama.cpp-driven action dispatch. It starts a local `llama-server`, generates an action dictionary for small-model training and runtime lookup, queries the server through its OpenAI-compatible chat endpoint, and dispatches exact-match Rust scripts.
+
+## Commands
+
+- Build: `cargo build`
+- Test: `cargo test`
+- Generate dictionary: `cargo run -- dictionary generate`
+- Start llama.cpp: `cargo run -- serve`
+- Query local model: `cargo run -- query "log hello from codex"`
+- Direct proof-of-concept dispatch: `cargo run -- run logger --payload '{"message":"hello from codex"}'`
+- Codex setup: `scripts/codex-setup.sh`
+- Codex logger smoke test: `scripts/codex-run-logger.sh`
+- Precommit/CI check: `scripts/precommit-check.sh`
+
+## Environment
+
+Configuration is read from environment variables:
+
+- `LLAMA_MODEL_PATH`: required GGUF model path for `cargo run -- serve`.
+- `LLAMA_HOST`: llama.cpp host. Default: `127.0.0.1`.
+- `LLAMA_PORT`: llama.cpp port. Default: `8080`.
+- `LLAMA_CONTEXT_SIZE`: optional value passed as `--ctx-size`.
+- `LLAMA_EXTRA_ARGS`: optional shell-split arguments appended to `llama-server`.
+- `CONTROLLER_LOG_LEVEL`: tracing log level. Default: `info`.
+
+Use `.env` for local values and keep it out of git. Update `.env.example`, `README.md`, `manifest.llm.json`, and `llm.txt` when environment variables or commands change.
+
+## Dictionary Rules
+
+- `src/registry.rs` is the source of truth for action definitions.
+- `dictionary/actions.jsonl` is generated canonical training data.
+- `dictionary/actions.index.json` is the generated runtime lookup file.
+- Regenerate dictionary files with `cargo run -- dictionary generate` after changing registered actions.
+- Do not manually edit generated dictionary files.
+
+## Dispatch Rules
+
+- Dispatch only exact `action_id` values present in `dictionary/actions.index.json`.
+- Aliases and intent examples are training hints only; they are not executable ids.
+- Unknown, malformed, ambiguous, missing, or empty action ids must be rejected without running scripts.
+- Script processes are detached. The controller spawns them and does not monitor completion.
+- Keep script payload validation strict and local to the script module.
+
+## Generated Paths
+
+- `target/`
+- `logs/`
+- `runtime/`
+- `dictionary/actions.jsonl`
+- `dictionary/actions.index.json`
+
+## CI And Hooks
+
+- Gitea Actions workflow lives at `.gitea/workflows/ci.yml`.
+- Woodpecker workflow lives at `.woodpecker.yml`.
+- The committed pre-commit hook lives at `.githooks/pre-commit`.
+- Configure local hooks with `git config core.hooksPath .githooks`.
+- All CI and pre-commit checks should call `scripts/precommit-check.sh` so dictionary generation stays validated consistently.
+
+## Coding Guidelines
+
+- Keep the CLI Rust-first and small.
+- Prefer adding scripts under `src/scripts/` and registering them in `src/registry.rs`.
+- Add focused tests for parsing, dictionary generation, action lookup, and payload validation.
+- Run `cargo test` before handing off code changes.
diff --git a/Cargo.lock b/Cargo.lock
new file mode 100644
index 0000000..181ec7b
--- /dev/null
+++ b/Cargo.lock
@@ -0,0 +1,1714 @@
+# This file is automatically @generated by Cargo.
+# It is not intended for manual editing.
+version = 4
+
+[[package]]
+name = "aho-corasick"
+version = "1.1.4"
+source = "registry+https://github.com/rust-lang/crates.io-index"
+checksum = "ddd31a130427c27518df266943a5308ed92d4b226cc639f5a8f1002816174301"
+dependencies = [
+ "memchr",
+]
+
+[[package]]
+name = "android_system_properties"
+version = "0.1.5"
+source = "registry+https://github.com/rust-lang/crates.io-index"
+checksum = "819e7219dbd41043ac279b19830f2efc897156490d7fd6ea916720117ee66311"
+dependencies = [
+ "libc",
+]
+
+[[package]]
+name = "anstream"
+version = "1.0.0"
+source = "registry+https://github.com/rust-lang/crates.io-index"
+checksum = "824a212faf96e9acacdbd09febd34438f8f711fb84e09a8916013cd7815ca28d"
+dependencies = [
+ "anstyle",
+ "anstyle-parse",
+ "anstyle-query",
+ "anstyle-wincon",
+ "colorchoice",
+ "is_terminal_polyfill",
+ "utf8parse",
+]
+
+[[package]]
+name = "anstyle"
+version = "1.0.14"
+source = "registry+https://github.com/rust-lang/crates.io-index"
+checksum = "940b3a0ca603d1eade50a4846a2afffd5ef57a9feac2c0e2ec2e14f9ead76000"
+
+[[package]]
+name = "anstyle-parse"
+version = "1.0.0"
+source = "registry+https://github.com/rust-lang/crates.io-index"
+checksum = "52ce7f38b242319f7cabaa6813055467063ecdc9d355bbb4ce0c68908cd8130e"
+dependencies = [
+ "utf8parse",
+]
+
+[[package]]
+name = "anstyle-query"
+version = "1.1.5"
+source = "registry+https://github.com/rust-lang/crates.io-index"
+checksum = "40c48f72fd53cd289104fc64099abca73db4166ad86ea0b4341abe65af83dadc"
+dependencies = [
+ "windows-sys 0.61.2",
+]
+
+[[package]]
+name = "anstyle-wincon"
+version = "3.0.11"
+source = "registry+https://github.com/rust-lang/crates.io-index"
+checksum = "291e6a250ff86cd4a820112fb8898808a366d8f9f58ce16d1f538353ad55747d"
+dependencies = [
+ "anstyle",
+ "once_cell_polyfill",
+ "windows-sys 0.61.2",
+]
+
+[[package]]
+name = "anyhow"
+version = "1.0.104"
+source = "registry+https://github.com/rust-lang/crates.io-index"
+checksum = "330a5ed07fa54e4702c9d6c4174f74427fc0ef6e214bbd677ae50a5099946470"
+
+[[package]]
+name = "atomic-waker"
+version = "1.1.2"
+source = "registry+https://github.com/rust-lang/crates.io-index"
+checksum = "1505bd5d3d116872e7271a6d4e16d81d0c8570876c8de68093a09ac269d8aac0"
+
+[[package]]
+name = "autocfg"
+version = "1.5.1"
+source = "registry+https://github.com/rust-lang/crates.io-index"
+checksum = "f2032f911046de80f0a198e0901378627c33f59ea0ac00e363d481118bd70a53"
+
+[[package]]
+name = "base64"
+version = "0.22.1"
+source = "registry+https://github.com/rust-lang/crates.io-index"
+checksum = "72b3254f16251a8381aa12e40e3c4d2f0199f8c6508fbecb9d91f575e0fbb8c6"
+
+[[package]]
+name = "bitflags"
+version = "2.13.1"
+source = "registry+https://github.com/rust-lang/crates.io-index"
+checksum = "b588b76d00fde79687d7646a9b5bdf3cc0f655e0bbd080335a95d7e96f3587da"
+
+[[package]]
+name = "bumpalo"
+version = "3.20.3"
+source = "registry+https://github.com/rust-lang/crates.io-index"
+checksum = "72f5acc6cb2ba439de613abc23857ec3d78374d8ed5ac84e9d11336e87da8649"
+
+[[package]]
+name = "bytes"
+version = "1.12.1"
+source = "registry+https://github.com/rust-lang/crates.io-index"
+checksum = "fc652a48c352aef3ea3aed32080501cf3ef6ed5da78602a020c991775b0aff04"
+
+[[package]]
+name = "cc"
+version = "1.3.0"
+source = "registry+https://github.com/rust-lang/crates.io-index"
+checksum = "c89588d05638b5b4594a3348a2d6c20277e43a7f5c5202b05cc56888475a47b8"
+dependencies = [
+ "find-msvc-tools",
+ "shlex",
+]
+
+[[package]]
+name = "cfg-if"
+version = "1.0.4"
+source = "registry+https://github.com/rust-lang/crates.io-index"
+checksum = "9330f8b2ff13f34540b44e946ef35111825727b38d33286ef986142615121801"
+
+[[package]]
+name = "cfg_aliases"
+version = "0.2.2"
+source = "registry+https://github.com/rust-lang/crates.io-index"
+checksum = "f079e83a288787bcd14a6aea84cee5c87a67c5a3e660c30f557a3d24761b3527"
+
+[[package]]
+name = "chacha20"
+version = "0.10.1"
+source = "registry+https://github.com/rust-lang/crates.io-index"
+checksum = "d524456ba66e72eb8b115ff89e01e497f8e6d11d78b70b1aa13c0fbd97540a81"
+dependencies = [
+ "cfg-if",
+ "cpufeatures",
+ "rand_core",
+]
+
+[[package]]
+name = "chrono"
+version = "0.4.45"
+source = "registry+https://github.com/rust-lang/crates.io-index"
+checksum = "1aa79e62e7697b8e29b513a68abacf485adcd1fe8284a4316c5ae868e6633327"
+dependencies = [
+ "iana-time-zone",
+ "num-traits",
+ "serde",
+ "windows-link",
+]
+
+[[package]]
+name = "clap"
+version = "4.6.3"
+source = "registry+https://github.com/rust-lang/crates.io-index"
+checksum = "0fb99565819980999fb7b4a1796046a5c949e6d4ff132cf5fadf5a641e20d776"
+dependencies = [
+ "clap_builder",
+ "clap_derive",
+]
+
+[[package]]
+name = "clap_builder"
+version = "4.6.2"
+source = "registry+https://github.com/rust-lang/crates.io-index"
+checksum = "f09628afdcc538b57f3c6341e9c8e9970f18e4a481690a64974d7023bd33548b"
+dependencies = [
+ "anstream",
+ "anstyle",
+ "clap_lex",
+ "strsim",
+]
+
+[[package]]
+name = "clap_derive"
+version = "4.6.3"
+source = "registry+https://github.com/rust-lang/crates.io-index"
+checksum = "32f2392eae7f16557a3d727ef3a12e57b2b2ca6f98566a5f4fb41ffe305df077"
+dependencies = [
+ "heck",
+ "proc-macro2",
+ "quote",
+ "syn 2.0.119",
+]
+
+[[package]]
+name = "clap_lex"
+version = "1.1.0"
+source = "registry+https://github.com/rust-lang/crates.io-index"
+checksum = "c8d4a3bb8b1e0c1050499d1815f5ab16d04f0959b233085fb31653fbfc9d98f9"
+
+[[package]]
+name = "colorchoice"
+version = "1.0.5"
+source = "registry+https://github.com/rust-lang/crates.io-index"
+checksum = "1d07550c9036bf2ae0c684c4297d503f838287c83c53686d05370d0e139ae570"
+
+[[package]]
+name = "core-foundation-sys"
+version = "0.8.7"
+source = "registry+https://github.com/rust-lang/crates.io-index"
+checksum = "773648b94d0e5d620f64f280777445740e61fe701025087ec8b57f45c791888b"
+
+[[package]]
+name = "cpufeatures"
+version = "0.3.0"
+source = "registry+https://github.com/rust-lang/crates.io-index"
+checksum = "8b2a41393f66f16b0823bb79094d54ac5fbd34ab292ddafb9a0456ac9f87d201"
+dependencies = [
+ "libc",
+]
+
+[[package]]
+name = "displaydoc"
+version = "0.2.6"
+source = "registry+https://github.com/rust-lang/crates.io-index"
+checksum = "1ac70aa55017e108007fbaf5aa0f54b021c98f92ff8af59d42eda9da96e3dd4f"
+dependencies = [
+ "proc-macro2",
+ "quote",
+ "syn 2.0.119",
+]
+
+[[package]]
+name = "dotenvy"
+version = "0.15.7"
+source = "registry+https://github.com/rust-lang/crates.io-index"
+checksum = "1aaf95b3e5c8f23aa320147307562d361db0ae0d51242340f558153b4eb2439b"
+
+[[package]]
+name = "errno"
+version = "0.3.14"
+source = "registry+https://github.com/rust-lang/crates.io-index"
+checksum = "39cab71617ae0d63f51a36d69f866391735b51691dbda63cf6f96d042b63efeb"
+dependencies = [
+ "libc",
+ "windows-sys 0.61.2",
+]
+
+[[package]]
+name = "fastrand"
+version = "2.5.0"
+source = "registry+https://github.com/rust-lang/crates.io-index"
+checksum = "da7c62ceae207dd37ea5b845da6a0696c799f85e97da1ab5b7910be3c1c80223"
+
+[[package]]
+name = "find-msvc-tools"
+version = "0.1.9"
+source = "registry+https://github.com/rust-lang/crates.io-index"
+checksum = "5baebc0774151f905a1a2cc41989300b1e6fbb29aff0ceffa1064fdd3088d582"
+
+[[package]]
+name = "form_urlencoded"
+version = "1.2.2"
+source = "registry+https://github.com/rust-lang/crates.io-index"
+checksum = "cb4cb245038516f5f85277875cdaa4f7d2c9a0fa0468de06ed190163b1581fcf"
+dependencies = [
+ "percent-encoding",
+]
+
+[[package]]
+name = "futures-channel"
+version = "0.3.33"
+source = "registry+https://github.com/rust-lang/crates.io-index"
+checksum = "262590f4fe6afeb0bc83be1daa64e52657fe185690a958af7f3ad0e92085c5ae"
+dependencies = [
+ "futures-core",
+ "futures-sink",
+]
+
+[[package]]
+name = "futures-core"
+version = "0.3.33"
+source = "registry+https://github.com/rust-lang/crates.io-index"
+checksum = "2cd50c473c80f6d7c3670a752354b8e569b1a7cbfdc0419ec88e5edad85e0dc7"
+
+[[package]]
+name = "futures-io"
+version = "0.3.33"
+source = "registry+https://github.com/rust-lang/crates.io-index"
+checksum = "4577ecaa3c4f96589d473f679a71b596316f6641bc350038b962a5daf0085d7a"
+
+[[package]]
+name = "futures-sink"
+version = "0.3.33"
+source = "registry+https://github.com/rust-lang/crates.io-index"
+checksum = "e34418ac499d6305c2fb5ad0ed2f6ac998c5f8ca209b4510f7f94242c647e307"
+
+[[package]]
+name = "futures-task"
+version = "0.3.33"
+source = "registry+https://github.com/rust-lang/crates.io-index"
+checksum = "b231ed28831efb4a61a08580c4bc233ec56bc009f4cd8f52da2c3cb97df0c109"
+
+[[package]]
+name = "futures-util"
+version = "0.3.33"
+source = "registry+https://github.com/rust-lang/crates.io-index"
+checksum = "a77a90a256fce34da66415271e30f94ee91c57b04b8a2c042d9cf3220179deaa"
+dependencies = [
+ "futures-core",
+ "futures-io",
+ "futures-sink",
+ "futures-task",
+ "memchr",
+ "pin-project-lite",
+ "slab",
+]
+
+[[package]]
+name = "getrandom"
+version = "0.2.17"
+source = "registry+https://github.com/rust-lang/crates.io-index"
+checksum = "ff2abc00be7fca6ebc474524697ae276ad847ad0a6b3faa4bcb027e9a4614ad0"
+dependencies = [
+ "cfg-if",
+ "js-sys",
+ "libc",
+ "wasi",
+ "wasm-bindgen",
+]
+
+[[package]]
+name = "getrandom"
+version = "0.4.3"
+source = "registry+https://github.com/rust-lang/crates.io-index"
+checksum = "300e883d756b2e4ec94e02791f39b04b522276138852cfc41d9fb7e904106099"
+dependencies = [
+ "cfg-if",
+ "js-sys",
+ "libc",
+ "r-efi",
+ "rand_core",
+ "wasm-bindgen",
+]
+
+[[package]]
+name = "heck"
+version = "0.5.0"
+source = "registry+https://github.com/rust-lang/crates.io-index"
+checksum = "2304e00983f87ffb38b55b444b5e3b60a884b5d30c0fca7d82fe33449bbe55ea"
+
+[[package]]
+name = "http"
+version = "1.4.2"
+source = "registry+https://github.com/rust-lang/crates.io-index"
+checksum = "6970f50e31d6fc17d3fa27329444bfa74e196cf62e95052a3f6fee181dba6425"
+dependencies = [
+ "bytes",
+ "itoa",
+]
+
+[[package]]
+name = "http-body"
+version = "1.1.0"
+source = "registry+https://github.com/rust-lang/crates.io-index"
+checksum = "ca2a8f2913ee65f60facd6a5905613afaa448497a0230cc41ce022d93290bc2c"
+dependencies = [
+ "bytes",
+ "http",
+]
+
+[[package]]
+name = "http-body-util"
+version = "0.1.4"
+source = "registry+https://github.com/rust-lang/crates.io-index"
+checksum = "e9f41fd6a08e4d4ec69df65976da761afd5ad5e58a9d4acb46bd1c953a9e3ff2"
+dependencies = [
+ "bytes",
+ "futures-core",
+ "http",
+ "http-body",
+ "pin-project-lite",
+]
+
+[[package]]
+name = "httparse"
+version = "1.10.1"
+source = "registry+https://github.com/rust-lang/crates.io-index"
+checksum = "6dbf3de79e51f3d586ab4cb9d5c3e2c14aa28ed23d180cf89b4df0454a69cc87"
+
+[[package]]
+name = "hyper"
+version = "1.11.0"
+source = "registry+https://github.com/rust-lang/crates.io-index"
+checksum = "d22053281f852e11534f5198498373cbb59295120a20771d90f7ed1897490a72"
+dependencies = [
+ "atomic-waker",
+ "bytes",
+ "futures-channel",
+ "futures-core",
+ "http",
+ "http-body",
+ "httparse",
+ "itoa",
+ "pin-project-lite",
+ "smallvec",
+ "tokio",
+ "want",
+]
+
+[[package]]
+name = "hyper-rustls"
+version = "0.27.9"
+source = "registry+https://github.com/rust-lang/crates.io-index"
+checksum = "33ca68d021ef39cf6463ab54c1d0f5daf03377b70561305bb89a8f83aab66e0f"
+dependencies = [
+ "http",
+ "hyper",
+ "hyper-util",
+ "rustls",
+ "tokio",
+ "tokio-rustls",
+ "tower-service",
+ "webpki-roots",
+]
+
+[[package]]
+name = "hyper-util"
+version = "0.1.20"
+source = "registry+https://github.com/rust-lang/crates.io-index"
+checksum = "96547c2556ec9d12fb1578c4eaf448b04993e7fb79cbaad930a656880a6bdfa0"
+dependencies = [
+ "base64",
+ "bytes",
+ "futures-channel",
+ "futures-util",
+ "http",
+ "http-body",
+ "hyper",
+ "ipnet",
+ "libc",
+ "percent-encoding",
+ "pin-project-lite",
+ "socket2",
+ "tokio",
+ "tower-service",
+ "tracing",
+]
+
+[[package]]
+name = "iana-time-zone"
+version = "0.1.65"
+source = "registry+https://github.com/rust-lang/crates.io-index"
+checksum = "e31bc9ad994ba00e440a8aa5c9ef0ec67d5cb5e5cb0cc7f8b744a35b389cc470"
+dependencies = [
+ "android_system_properties",
+ "core-foundation-sys",
+ "iana-time-zone-haiku",
+ "js-sys",
+ "log",
+ "wasm-bindgen",
+ "windows-core",
+]
+
+[[package]]
+name = "iana-time-zone-haiku"
+version = "0.1.2"
+source = "registry+https://github.com/rust-lang/crates.io-index"
+checksum = "f31827a206f56af32e590ba56d5d2d085f558508192593743f16b2306495269f"
+dependencies = [
+ "cc",
+]
+
+[[package]]
+name = "icu_collections"
+version = "2.2.0"
+source = "registry+https://github.com/rust-lang/crates.io-index"
+checksum = "2984d1cd16c883d7935b9e07e44071dca8d917fd52ecc02c04d5fa0b5a3f191c"
+dependencies = [
+ "displaydoc",
+ "potential_utf",
+ "utf8_iter",
+ "yoke",
+ "zerofrom",
+ "zerovec",
+]
+
+[[package]]
+name = "icu_locale_core"
+version = "2.2.0"
+source = "registry+https://github.com/rust-lang/crates.io-index"
+checksum = "92219b62b3e2b4d88ac5119f8904c10f8f61bf7e95b640d25ba3075e6cac2c29"
+dependencies = [
+ "displaydoc",
+ "litemap",
+ "tinystr",
+ "writeable",
+ "zerovec",
+]
+
+[[package]]
+name = "icu_normalizer"
+version = "2.2.0"
+source = "registry+https://github.com/rust-lang/crates.io-index"
+checksum = "c56e5ee99d6e3d33bd91c5d85458b6005a22140021cc324cea84dd0e72cff3b4"
+dependencies = [
+ "icu_collections",
+ "icu_normalizer_data",
+ "icu_properties",
+ "icu_provider",
+ "smallvec",
+ "zerovec",
+]
+
+[[package]]
+name = "icu_normalizer_data"
+version = "2.2.0"
+source = "registry+https://github.com/rust-lang/crates.io-index"
+checksum = "da3be0ae77ea334f4da67c12f149704f19f81d1adf7c51cf482943e84a2bad38"
+
+[[package]]
+name = "icu_properties"
+version = "2.2.0"
+source = "registry+https://github.com/rust-lang/crates.io-index"
+checksum = "bee3b67d0ea5c2cca5003417989af8996f8604e34fb9ddf96208a033901e70de"
+dependencies = [
+ "icu_collections",
+ "icu_locale_core",
+ "icu_properties_data",
+ "icu_provider",
+ "zerotrie",
+ "zerovec",
+]
+
+[[package]]
+name = "icu_properties_data"
+version = "2.2.0"
+source = "registry+https://github.com/rust-lang/crates.io-index"
+checksum = "8e2bbb201e0c04f7b4b3e14382af113e17ba4f63e2c9d2ee626b720cbce54a14"
+
+[[package]]
+name = "icu_provider"
+version = "2.2.0"
+source = "registry+https://github.com/rust-lang/crates.io-index"
+checksum = "139c4cf31c8b5f33d7e199446eff9c1e02decfc2f0eec2c8d71f65befa45b421"
+dependencies = [
+ "displaydoc",
+ "icu_locale_core",
+ "writeable",
+ "yoke",
+ "zerofrom",
+ "zerotrie",
+ "zerovec",
+]
+
+[[package]]
+name = "idna"
+version = "1.1.0"
+source = "registry+https://github.com/rust-lang/crates.io-index"
+checksum = "3b0875f23caa03898994f6ddc501886a45c7d3d62d04d2d90788d47be1b1e4de"
+dependencies = [
+ "idna_adapter",
+ "smallvec",
+ "utf8_iter",
+]
+
+[[package]]
+name = "idna_adapter"
+version = "1.2.2"
+source = "registry+https://github.com/rust-lang/crates.io-index"
+checksum = "cb68373c0d6620ef8105e855e7745e18b0d00d3bdb07fb532e434244cdb9a714"
+dependencies = [
+ "icu_normalizer",
+ "icu_properties",
+]
+
+[[package]]
+name = "ipnet"
+version = "2.12.0"
+source = "registry+https://github.com/rust-lang/crates.io-index"
+checksum = "d98f6fed1fde3f8c21bc40a1abb88dd75e67924f9cffc3ef95607bad8017f8e2"
+
+[[package]]
+name = "is_terminal_polyfill"
+version = "1.70.2"
+source = "registry+https://github.com/rust-lang/crates.io-index"
+checksum = "a6cb138bb79a146c1bd460005623e142ef0181e3d0219cb493e02f7d08a35695"
+
+[[package]]
+name = "itoa"
+version = "1.0.18"
+source = "registry+https://github.com/rust-lang/crates.io-index"
+checksum = "8f42a60cbdf9a97f5d2305f08a87dc4e09308d1276d28c869c684d7777685682"
+
+[[package]]
+name = "js-sys"
+version = "0.3.103"
+source = "registry+https://github.com/rust-lang/crates.io-index"
+checksum = "53b44bfcdb3f8d5837a46dae1ca9660a837176eee74a28b229bc626816589102"
+dependencies = [
+ "cfg-if",
+ "futures-util",
+ "wasm-bindgen",
+]
+
+[[package]]
+name = "lazy_static"
+version = "1.5.0"
+source = "registry+https://github.com/rust-lang/crates.io-index"
+checksum = "bbd2bcb4c963f2ddae06a2efc7e9f3591312473c50c6685e1f298068316e66fe"
+
+[[package]]
+name = "libc"
+version = "0.2.188"
+source = "registry+https://github.com/rust-lang/crates.io-index"
+checksum = "22053b6a34f84abc97f9129e61334f40174659a1b9bd18c970b83db6a9a6348b"
+
+[[package]]
+name = "linux-raw-sys"
+version = "0.12.1"
+source = "registry+https://github.com/rust-lang/crates.io-index"
+checksum = "32a66949e030da00e8c7d4434b251670a91556f4144941d37452769c25d58a53"
+
+[[package]]
+name = "litemap"
+version = "0.8.2"
+source = "registry+https://github.com/rust-lang/crates.io-index"
+checksum = "92daf443525c4cce67b150400bc2316076100ce0b3686209eb8cf3c31612e6f0"
+
+[[package]]
+name = "log"
+version = "0.4.33"
+source = "registry+https://github.com/rust-lang/crates.io-index"
+checksum = "0ceec5bc11778974d1bcb055b18002eba7f4b3518b6a0081b3af5f21666da9ad"
+
+[[package]]
+name = "lru-slab"
+version = "0.1.2"
+source = "registry+https://github.com/rust-lang/crates.io-index"
+checksum = "112b39cec0b298b6c1999fee3e31427f74f676e4cb9879ed1a121b43661a4154"
+
+[[package]]
+name = "matchers"
+version = "0.2.0"
+source = "registry+https://github.com/rust-lang/crates.io-index"
+checksum = "d1525a2a28c7f4fa0fc98bb91ae755d1e2d1505079e05539e35bc876b5d65ae9"
+dependencies = [
+ "regex-automata",
+]
+
+[[package]]
+name = "memchr"
+version = "2.8.3"
+source = "registry+https://github.com/rust-lang/crates.io-index"
+checksum = "cf8baf1c55e62ffcace7a9f06f4bd9cd3f0c4beb022d3b367256b91b87513d98"
+
+[[package]]
+name = "mio"
+version = "1.2.2"
+source = "registry+https://github.com/rust-lang/crates.io-index"
+checksum = "30d65c71f1ce40ab09135ce117d742b9f8a19ff91a41a8b57ed50bc2de59c427"
+dependencies = [
+ "libc",
+ "wasi",
+ "windows-sys 0.61.2",
+]
+
+[[package]]
+name = "mp-ai-module-controller"
+version = "0.1.0"
+dependencies = [
+ "anyhow",
+ "chrono",
+ "clap",
+ "dotenvy",
+ "reqwest",
+ "serde",
+ "serde_json",
+ "shell-words",
+ "tempfile",
+ "tracing",
+ "tracing-subscriber",
+]
+
+[[package]]
+name = "nu-ansi-term"
+version = "0.50.3"
+source = "registry+https://github.com/rust-lang/crates.io-index"
+checksum = "7957b9740744892f114936ab4a57b3f487491bbeafaf8083688b16841a4240e5"
+dependencies = [
+ "windows-sys 0.61.2",
+]
+
+[[package]]
+name = "num-traits"
+version = "0.2.19"
+source = "registry+https://github.com/rust-lang/crates.io-index"
+checksum = "071dfc062690e90b734c0b2273ce72ad0ffa95f0c74596bc250dcfd960262841"
+dependencies = [
+ "autocfg",
+]
+
+[[package]]
+name = "once_cell"
+version = "1.21.4"
+source = "registry+https://github.com/rust-lang/crates.io-index"
+checksum = "9f7c3e4beb33f85d45ae3e3a1792185706c8e16d043238c593331cc7cd313b50"
+
+[[package]]
+name = "once_cell_polyfill"
+version = "1.70.2"
+source = "registry+https://github.com/rust-lang/crates.io-index"
+checksum = "384b8ab6d37215f3c5301a95a4accb5d64aa607f1fcb26a11b5303878451b4fe"
+
+[[package]]
+name = "percent-encoding"
+version = "2.3.2"
+source = "registry+https://github.com/rust-lang/crates.io-index"
+checksum = "9b4f627cb1b25917193a259e49bdad08f671f8d9708acfd5fe0a8c1455d87220"
+
+[[package]]
+name = "pin-project-lite"
+version = "0.2.17"
+source = "registry+https://github.com/rust-lang/crates.io-index"
+checksum = "a89322df9ebe1c1578d689c92318e070967d1042b512afbe49518723f4e6d5cd"
+
+[[package]]
+name = "potential_utf"
+version = "0.1.5"
+source = "registry+https://github.com/rust-lang/crates.io-index"
+checksum = "0103b1cef7ec0cf76490e969665504990193874ea05c85ff9bab8b911d0a0564"
+dependencies = [
+ "zerovec",
+]
+
+[[package]]
+name = "proc-macro2"
+version = "1.0.107"
+source = "registry+https://github.com/rust-lang/crates.io-index"
+checksum = "985e7ec9bb745e6ce6535b544d84d6cd6f7ad8bd711c398938ae983b91a766d9"
+dependencies = [
+ "unicode-ident",
+]
+
+[[package]]
+name = "quinn"
+version = "0.11.11"
+source = "registry+https://github.com/rust-lang/crates.io-index"
+checksum = "0c1a41e437b6bbd489372cd4971de128e85c855f56c57f283d20ff016cf7c0a8"
+dependencies = [
+ "bytes",
+ "cfg_aliases",
+ "pin-project-lite",
+ "quinn-proto",
+ "quinn-udp",
+ "rustc-hash",
+ "rustls",
+ "socket2",
+ "thiserror",
+ "tokio",
+ "tracing",
+ "web-time",
+]
+
+[[package]]
+name = "quinn-proto"
+version = "0.11.16"
+source = "registry+https://github.com/rust-lang/crates.io-index"
+checksum = "2f4bfc015262b9df63c8845072ce59068853ff5872180c2ce2f13038b970e560"
+dependencies = [
+ "bytes",
+ "getrandom 0.4.3",
+ "lru-slab",
+ "rand",
+ "rand_pcg",
+ "ring",
+ "rustc-hash",
+ "rustls",
+ "rustls-pki-types",
+ "slab",
+ "thiserror",
+ "tinyvec",
+ "tracing",
+ "web-time",
+]
+
+[[package]]
+name = "quinn-udp"
+version = "0.5.15"
+source = "registry+https://github.com/rust-lang/crates.io-index"
+checksum = "35a133f956daabe89a61a685c2649f13d82d5aa4bd5d12d1277e1072a21c0694"
+dependencies = [
+ "cfg_aliases",
+ "libc",
+ "once_cell",
+ "socket2",
+ "tracing",
+ "windows-sys 0.61.2",
+]
+
+[[package]]
+name = "quote"
+version = "1.0.47"
+source = "registry+https://github.com/rust-lang/crates.io-index"
+checksum = "1fbf4db142a473a8d80c26bbf18454ed458bf8d26c8219c331daecfdbd079001"
+dependencies = [
+ "proc-macro2",
+]
+
+[[package]]
+name = "r-efi"
+version = "6.0.0"
+source = "registry+https://github.com/rust-lang/crates.io-index"
+checksum = "f8dcc9c7d52a811697d2151c701e0d08956f92b0e24136cf4cf27b57a6a0d9bf"
+
+[[package]]
+name = "rand"
+version = "0.10.2"
+source = "registry+https://github.com/rust-lang/crates.io-index"
+checksum = "c7f5fa3a058cd35567ef9bfa5e75732bee0f9e4c55fa90477bef2dfcdbc4be80"
+dependencies = [
+ "chacha20",
+ "getrandom 0.4.3",
+ "rand_core",
+]
+
+[[package]]
+name = "rand_core"
+version = "0.10.1"
+source = "registry+https://github.com/rust-lang/crates.io-index"
+checksum = "63b8176103e19a2643978565ca18b50549f6101881c443590420e4dc998a3c69"
+
+[[package]]
+name = "rand_pcg"
+version = "0.10.2"
+source = "registry+https://github.com/rust-lang/crates.io-index"
+checksum = "caa0f4137e1c0a72f4c651489402276c8e8e1cf081f3b0ba156d2cbeef09e86a"
+dependencies = [
+ "rand_core",
+]
+
+[[package]]
+name = "regex-automata"
+version = "0.4.16"
+source = "registry+https://github.com/rust-lang/crates.io-index"
+checksum = "8fcfdb36bda0c880c5931cdc7a2bcdc8ba4556847b9d912bca70bc94708711ad"
+dependencies = [
+ "aho-corasick",
+ "memchr",
+ "regex-syntax",
+]
+
+[[package]]
+name = "regex-syntax"
+version = "0.8.11"
+source = "registry+https://github.com/rust-lang/crates.io-index"
+checksum = "d6f6ff9a378485b298a5286656da665ba74413d36db0979633275d2e708145d4"
+
+[[package]]
+name = "reqwest"
+version = "0.12.28"
+source = "registry+https://github.com/rust-lang/crates.io-index"
+checksum = "eddd3ca559203180a307f12d114c268abf583f59b03cb906fd0b3ff8646c1147"
+dependencies = [
+ "base64",
+ "bytes",
+ "futures-channel",
+ "futures-core",
+ "futures-util",
+ "http",
+ "http-body",
+ "http-body-util",
+ "hyper",
+ "hyper-rustls",
+ "hyper-util",
+ "js-sys",
+ "log",
+ "percent-encoding",
+ "pin-project-lite",
+ "quinn",
+ "rustls",
+ "rustls-pki-types",
+ "serde",
+ "serde_json",
+ "serde_urlencoded",
+ "sync_wrapper",
+ "tokio",
+ "tokio-rustls",
+ "tower",
+ "tower-http",
+ "tower-service",
+ "url",
+ "wasm-bindgen",
+ "wasm-bindgen-futures",
+ "web-sys",
+ "webpki-roots",
+]
+
+[[package]]
+name = "ring"
+version = "0.17.14"
+source = "registry+https://github.com/rust-lang/crates.io-index"
+checksum = "a4689e6c2294d81e88dc6261c768b63bc4fcdb852be6d1352498b114f61383b7"
+dependencies = [
+ "cc",
+ "cfg-if",
+ "getrandom 0.2.17",
+ "libc",
+ "untrusted",
+ "windows-sys 0.52.0",
+]
+
+[[package]]
+name = "rustc-hash"
+version = "2.1.3"
+source = "registry+https://github.com/rust-lang/crates.io-index"
+checksum = "6b1e7f9a428571be2dc5bc0505c13fb6bf936822b894ec87abf8a08a4e51742d"
+
+[[package]]
+name = "rustix"
+version = "1.1.4"
+source = "registry+https://github.com/rust-lang/crates.io-index"
+checksum = "b6fe4565b9518b83ef4f91bb47ce29620ca828bd32cb7e408f0062e9930ba190"
+dependencies = [
+ "bitflags",
+ "errno",
+ "libc",
+ "linux-raw-sys",
+ "windows-sys 0.61.2",
+]
+
+[[package]]
+name = "rustls"
+version = "0.23.42"
+source = "registry+https://github.com/rust-lang/crates.io-index"
+checksum = "3c54fcab019b409d04215d3a17cb438fd7fbf192ee61461f20f4fe18704bc138"
+dependencies = [
+ "once_cell",
+ "ring",
+ "rustls-pki-types",
+ "rustls-webpki",
+ "subtle",
+ "zeroize",
+]
+
+[[package]]
+name = "rustls-pki-types"
+version = "1.15.0"
+source = "registry+https://github.com/rust-lang/crates.io-index"
+checksum = "764899a24af3980067ee14bc143654f297b22eaebfe3c7b6b211920a5a59b046"
+dependencies = [
+ "web-time",
+ "zeroize",
+]
+
+[[package]]
+name = "rustls-webpki"
+version = "0.103.13"
+source = "registry+https://github.com/rust-lang/crates.io-index"
+checksum = "61c429a8649f110dddef65e2a5ad240f747e85f7758a6bccc7e5777bd33f756e"
+dependencies = [
+ "ring",
+ "rustls-pki-types",
+ "untrusted",
+]
+
+[[package]]
+name = "rustversion"
+version = "1.0.23"
+source = "registry+https://github.com/rust-lang/crates.io-index"
+checksum = "cf54715a573b99ac80df0bc206da022bcd442c974952c7b9720069370852e21f"
+
+[[package]]
+name = "ryu"
+version = "1.0.23"
+source = "registry+https://github.com/rust-lang/crates.io-index"
+checksum = "9774ba4a74de5f7b1c1451ed6cd5285a32eddb5cccb8cc655a4e50009e06477f"
+
+[[package]]
+name = "serde"
+version = "1.0.229"
+source = "registry+https://github.com/rust-lang/crates.io-index"
+checksum = "4148590afebada386688f18773da617792bf2ef03ffc1e4cbd2b1d45b023e0ba"
+dependencies = [
+ "serde_core",
+ "serde_derive",
+]
+
+[[package]]
+name = "serde_core"
+version = "1.0.229"
+source = "registry+https://github.com/rust-lang/crates.io-index"
+checksum = "67dca2c9c51e58a4791a4b1ed58308b39c64224d349a935ab5039aa360942a48"
+dependencies = [
+ "serde_derive",
+]
+
+[[package]]
+name = "serde_derive"
+version = "1.0.229"
+source = "registry+https://github.com/rust-lang/crates.io-index"
+checksum = "e7a5d71263a5a7d47b41f6b3f06ba276f10cc18b0931f1799f710578e2309348"
+dependencies = [
+ "proc-macro2",
+ "quote",
+ "syn 3.0.2",
+]
+
+[[package]]
+name = "serde_json"
+version = "1.0.151"
+source = "registry+https://github.com/rust-lang/crates.io-index"
+checksum = "c841b55ecdae098c80dcae9cf767f6f8a0c2cdb3416bbef72181df4d0fe73f14"
+dependencies = [
+ "itoa",
+ "memchr",
+ "serde",
+ "serde_core",
+ "zmij",
+]
+
+[[package]]
+name = "serde_urlencoded"
+version = "0.7.1"
+source = "registry+https://github.com/rust-lang/crates.io-index"
+checksum = "d3491c14715ca2294c4d6a88f15e84739788c1d030eed8c110436aafdaa2f3fd"
+dependencies = [
+ "form_urlencoded",
+ "itoa",
+ "ryu",
+ "serde",
+]
+
+[[package]]
+name = "sharded-slab"
+version = "0.1.7"
+source = "registry+https://github.com/rust-lang/crates.io-index"
+checksum = "f40ca3c46823713e0d4209592e8d6e826aa57e928f09752619fc696c499637f6"
+dependencies = [
+ "lazy_static",
+]
+
+[[package]]
+name = "shell-words"
+version = "1.1.1"
+source = "registry+https://github.com/rust-lang/crates.io-index"
+checksum = "dc6fe69c597f9c37bfeeeeeb33da3530379845f10be461a66d16d03eca2ded77"
+
+[[package]]
+name = "shlex"
+version = "2.0.1"
+source = "registry+https://github.com/rust-lang/crates.io-index"
+checksum = "f8fadd59c855ef2080decdef8ff161eb6661b86933c9d82e5ba29dc602a55aba"
+
+[[package]]
+name = "slab"
+version = "0.4.12"
+source = "registry+https://github.com/rust-lang/crates.io-index"
+checksum = "0c790de23124f9ab44544d7ac05d60440adc586479ce501c1d6d7da3cd8c9cf5"
+
+[[package]]
+name = "smallvec"
+version = "1.15.2"
+source = "registry+https://github.com/rust-lang/crates.io-index"
+checksum = "8ed6a63f02c8539c91a8685a86f4099661ba3da017932f6ebbea6de3f0fa7c90"
+
+[[package]]
+name = "socket2"
+version = "0.6.5"
+source = "registry+https://github.com/rust-lang/crates.io-index"
+checksum = "c3d1e2c7f27f8d4cb10542a02c49005dbd6e93095799d6f3be745fae9f8fedd4"
+dependencies = [
+ "libc",
+ "windows-sys 0.61.2",
+]
+
+[[package]]
+name = "stable_deref_trait"
+version = "1.2.1"
+source = "registry+https://github.com/rust-lang/crates.io-index"
+checksum = "6ce2be8dc25455e1f91df71bfa12ad37d7af1092ae736f3a6cd0e37bc7810596"
+
+[[package]]
+name = "strsim"
+version = "0.11.1"
+source = "registry+https://github.com/rust-lang/crates.io-index"
+checksum = "7da8b5736845d9f2fcb837ea5d9e2628564b3b043a70948a3f0b778838c5fb4f"
+
+[[package]]
+name = "subtle"
+version = "2.6.1"
+source = "registry+https://github.com/rust-lang/crates.io-index"
+checksum = "13c2bddecc57b384dee18652358fb23172facb8a2c51ccc10d74c157bdea3292"
+
+[[package]]
+name = "syn"
+version = "2.0.119"
+source = "registry+https://github.com/rust-lang/crates.io-index"
+checksum = "872831b642d1a07999a962a351ed35b955ea2cfc8f3862091e2a240a84f17297"
+dependencies = [
+ "proc-macro2",
+ "quote",
+ "unicode-ident",
+]
+
+[[package]]
+name = "syn"
+version = "3.0.2"
+source = "registry+https://github.com/rust-lang/crates.io-index"
+checksum = "a207d6d6a2b7fc470b80443726053f18a2481b7e1eee970597051596567987a3"
+dependencies = [
+ "proc-macro2",
+ "quote",
+ "unicode-ident",
+]
+
+[[package]]
+name = "sync_wrapper"
+version = "1.0.2"
+source = "registry+https://github.com/rust-lang/crates.io-index"
+checksum = "0bf256ce5efdfa370213c1dabab5935a12e49f2c58d15e9eac2870d3b4f27263"
+dependencies = [
+ "futures-core",
+]
+
+[[package]]
+name = "synstructure"
+version = "0.13.2"
+source = "registry+https://github.com/rust-lang/crates.io-index"
+checksum = "728a70f3dbaf5bab7f0c4b1ac8d7ae5ea60a4b5549c8a5914361c99147a709d2"
+dependencies = [
+ "proc-macro2",
+ "quote",
+ "syn 2.0.119",
+]
+
+[[package]]
+name = "tempfile"
+version = "3.27.0"
+source = "registry+https://github.com/rust-lang/crates.io-index"
+checksum = "32497e9a4c7b38532efcdebeef879707aa9f794296a4f0244f6f69e9bc8574bd"
+dependencies = [
+ "fastrand",
+ "getrandom 0.4.3",
+ "once_cell",
+ "rustix",
+ "windows-sys 0.61.2",
+]
+
+[[package]]
+name = "thiserror"
+version = "2.0.19"
+source = "registry+https://github.com/rust-lang/crates.io-index"
+checksum = "09a43598840e33d5b0331f38c5e30d13bb11c11210a4b58f0d9b18a5a5eefcd9"
+dependencies = [
+ "thiserror-impl",
+]
+
+[[package]]
+name = "thiserror-impl"
+version = "2.0.19"
+source = "registry+https://github.com/rust-lang/crates.io-index"
+checksum = "43cbfe0cf76104d42a574802844187e84a305e531ed54455f11fbde0f10541cd"
+dependencies = [
+ "proc-macro2",
+ "quote",
+ "syn 3.0.2",
+]
+
+[[package]]
+name = "thread_local"
+version = "1.1.10"
+source = "registry+https://github.com/rust-lang/crates.io-index"
+checksum = "1ad99c4c6d32803332c548b1af0540b357b3f5fc0be8f6c6bfe8b2e6ae784070"
+dependencies = [
+ "cfg-if",
+]
+
+[[package]]
+name = "tinystr"
+version = "0.8.3"
+source = "registry+https://github.com/rust-lang/crates.io-index"
+checksum = "c8323304221c2a851516f22236c5722a72eaa19749016521d6dff0824447d96d"
+dependencies = [
+ "displaydoc",
+ "zerovec",
+]
+
+[[package]]
+name = "tinyvec"
+version = "1.12.0"
+source = "registry+https://github.com/rust-lang/crates.io-index"
+checksum = "bb4ebadaa0af04fab11ae01eb5f9fdb5f9c5b875506e210e71c07873528baa7f"
+dependencies = [
+ "tinyvec_macros",
+]
+
+[[package]]
+name = "tinyvec_macros"
+version = "0.1.1"
+source = "registry+https://github.com/rust-lang/crates.io-index"
+checksum = "1f3ccbac311fea05f86f61904b462b55fb3df8837a366dfc601a0161d0532f20"
+
+[[package]]
+name = "tokio"
+version = "1.53.1"
+source = "registry+https://github.com/rust-lang/crates.io-index"
+checksum = "202caea871b69668250d242070849eb495be178ed697a3e98aebce5bc81a0bed"
+dependencies = [
+ "bytes",
+ "libc",
+ "mio",
+ "pin-project-lite",
+ "socket2",
+ "windows-sys 0.61.2",
+]
+
+[[package]]
+name = "tokio-rustls"
+version = "0.26.4"
+source = "registry+https://github.com/rust-lang/crates.io-index"
+checksum = "1729aa945f29d91ba541258c8df89027d5792d85a8841fb65e8bf0f4ede4ef61"
+dependencies = [
+ "rustls",
+ "tokio",
+]
+
+[[package]]
+name = "tower"
+version = "0.5.3"
+source = "registry+https://github.com/rust-lang/crates.io-index"
+checksum = "ebe5ef63511595f1344e2d5cfa636d973292adc0eec1f0ad45fae9f0851ab1d4"
+dependencies = [
+ "futures-core",
+ "futures-util",
+ "pin-project-lite",
+ "sync_wrapper",
+ "tokio",
+ "tower-layer",
+ "tower-service",
+]
+
+[[package]]
+name = "tower-http"
+version = "0.6.11"
+source = "registry+https://github.com/rust-lang/crates.io-index"
+checksum = "4cfcf7e2740e6fc6d4d688b4ef00650406bb94adf4731e43c096c3a19fe40840"
+dependencies = [
+ "bitflags",
+ "bytes",
+ "futures-util",
+ "http",
+ "http-body",
+ "pin-project-lite",
+ "tower",
+ "tower-layer",
+ "tower-service",
+ "url",
+]
+
+[[package]]
+name = "tower-layer"
+version = "0.3.3"
+source = "registry+https://github.com/rust-lang/crates.io-index"
+checksum = "121c2a6cda46980bb0fcd1647ffaf6cd3fc79a013de288782836f6df9c48780e"
+
+[[package]]
+name = "tower-service"
+version = "0.3.3"
+source = "registry+https://github.com/rust-lang/crates.io-index"
+checksum = "8df9b6e13f2d32c91b9bd719c00d1958837bc7dec474d94952798cc8e69eeec3"
+
+[[package]]
+name = "tracing"
+version = "0.1.44"
+source = "registry+https://github.com/rust-lang/crates.io-index"
+checksum = "63e71662fa4b2a2c3a26f570f037eb95bb1f85397f3cd8076caed2f026a6d100"
+dependencies = [
+ "pin-project-lite",
+ "tracing-attributes",
+ "tracing-core",
+]
+
+[[package]]
+name = "tracing-attributes"
+version = "0.1.31"
+source = "registry+https://github.com/rust-lang/crates.io-index"
+checksum = "7490cfa5ec963746568740651ac6781f701c9c5ea257c58e057f3ba8cf69e8da"
+dependencies = [
+ "proc-macro2",
+ "quote",
+ "syn 2.0.119",
+]
+
+[[package]]
+name = "tracing-core"
+version = "0.1.36"
+source = "registry+https://github.com/rust-lang/crates.io-index"
+checksum = "db97caf9d906fbde555dd62fa95ddba9eecfd14cb388e4f491a66d74cd5fb79a"
+dependencies = [
+ "once_cell",
+ "valuable",
+]
+
+[[package]]
+name = "tracing-log"
+version = "0.2.0"
+source = "registry+https://github.com/rust-lang/crates.io-index"
+checksum = "ee855f1f400bd0e5c02d150ae5de3840039a3f54b025156404e34c23c03f47c3"
+dependencies = [
+ "log",
+ "once_cell",
+ "tracing-core",
+]
+
+[[package]]
+name = "tracing-subscriber"
+version = "0.3.23"
+source = "registry+https://github.com/rust-lang/crates.io-index"
+checksum = "cb7f578e5945fb242538965c2d0b04418d38ec25c79d160cd279bf0731c8d319"
+dependencies = [
+ "matchers",
+ "nu-ansi-term",
+ "once_cell",
+ "regex-automata",
+ "sharded-slab",
+ "smallvec",
+ "thread_local",
+ "tracing",
+ "tracing-core",
+ "tracing-log",
+]
+
+[[package]]
+name = "try-lock"
+version = "0.2.5"
+source = "registry+https://github.com/rust-lang/crates.io-index"
+checksum = "e421abadd41a4225275504ea4d6566923418b7f05506fbc9c0fe86ba7396114b"
+
+[[package]]
+name = "unicode-ident"
+version = "1.0.24"
+source = "registry+https://github.com/rust-lang/crates.io-index"
+checksum = "e6e4313cd5fcd3dad5cafa179702e2b244f760991f45397d14d4ebf38247da75"
+
+[[package]]
+name = "untrusted"
+version = "0.9.0"
+source = "registry+https://github.com/rust-lang/crates.io-index"
+checksum = "8ecb6da28b8a351d773b68d5825ac39017e680750f980f3a1a85cd8dd28a47c1"
+
+[[package]]
+name = "url"
+version = "2.5.8"
+source = "registry+https://github.com/rust-lang/crates.io-index"
+checksum = "ff67a8a4397373c3ef660812acab3268222035010ab8680ec4215f38ba3d0eed"
+dependencies = [
+ "form_urlencoded",
+ "idna",
+ "percent-encoding",
+ "serde",
+]
+
+[[package]]
+name = "utf8_iter"
+version = "1.0.4"
+source = "registry+https://github.com/rust-lang/crates.io-index"
+checksum = "b6c140620e7ffbb22c2dee59cafe6084a59b5ffc27a8859a5f0d494b5d52b6be"
+
+[[package]]
+name = "utf8parse"
+version = "0.2.2"
+source = "registry+https://github.com/rust-lang/crates.io-index"
+checksum = "06abde3611657adf66d383f00b093d7faecc7fa57071cce2578660c9f1010821"
+
+[[package]]
+name = "valuable"
+version = "0.1.1"
+source = "registry+https://github.com/rust-lang/crates.io-index"
+checksum = "ba73ea9cf16a25df0c8caa16c51acb937d5712a8429db78a3ee29d5dcacd3a65"
+
+[[package]]
+name = "want"
+version = "0.3.1"
+source = "registry+https://github.com/rust-lang/crates.io-index"
+checksum = "bfa7760aed19e106de2c7c0b581b509f2f25d3dacaf737cb82ac61bc6d760b0e"
+dependencies = [
+ "try-lock",
+]
+
+[[package]]
+name = "wasi"
+version = "0.11.1+wasi-snapshot-preview1"
+source = "registry+https://github.com/rust-lang/crates.io-index"
+checksum = "ccf3ec651a847eb01de73ccad15eb7d99f80485de043efb2f370cd654f4ea44b"
+
+[[package]]
+name = "wasm-bindgen"
+version = "0.2.126"
+source = "registry+https://github.com/rust-lang/crates.io-index"
+checksum = "4b067c0c11094aef6b7a801c1e34a26affafdf3d051dba08456b868789aaf9a4"
+dependencies = [
+ "cfg-if",
+ "once_cell",
+ "rustversion",
+ "wasm-bindgen-macro",
+ "wasm-bindgen-shared",
+]
+
+[[package]]
+name = "wasm-bindgen-futures"
+version = "0.4.76"
+source = "registry+https://github.com/rust-lang/crates.io-index"
+checksum = "c62df1340f32221cb9c54d6a27b030e3dba64361d4a95bed55f9aacb44da291d"
+dependencies = [
+ "js-sys",
+ "wasm-bindgen",
+]
+
+[[package]]
+name = "wasm-bindgen-macro"
+version = "0.2.126"
+source = "registry+https://github.com/rust-lang/crates.io-index"
+checksum = "167ce5e579f6bcf889c4f7175a8a5a585de84e8ff93976ce393efa5f2837aab1"
+dependencies = [
+ "quote",
+ "wasm-bindgen-macro-support",
+]
+
+[[package]]
+name = "wasm-bindgen-macro-support"
+version = "0.2.126"
+source = "registry+https://github.com/rust-lang/crates.io-index"
+checksum = "f3997c7839262f4ef12cf90b818d6340c18e80f263f1a94bf157d0ec4420380e"
+dependencies = [
+ "bumpalo",
+ "proc-macro2",
+ "quote",
+ "syn 2.0.119",
+ "wasm-bindgen-shared",
+]
+
+[[package]]
+name = "wasm-bindgen-shared"
+version = "0.2.126"
+source = "registry+https://github.com/rust-lang/crates.io-index"
+checksum = "dc1b4cb0cc549fcf58d7dfc081778139b3d283a081644e833e84682ad71cea24"
+dependencies = [
+ "unicode-ident",
+]
+
+[[package]]
+name = "web-sys"
+version = "0.3.103"
+source = "registry+https://github.com/rust-lang/crates.io-index"
+checksum = "8622dcb61c0bcc9fffa6938bed81210af2da9a7e4a1a834b2e37a59b6dfb6141"
+dependencies = [
+ "js-sys",
+ "wasm-bindgen",
+]
+
+[[package]]
+name = "web-time"
+version = "1.1.0"
+source = "registry+https://github.com/rust-lang/crates.io-index"
+checksum = "5a6580f308b1fad9207618087a65c04e7a10bc77e02c8e84e9b00dd4b12fa0bb"
+dependencies = [
+ "js-sys",
+ "wasm-bindgen",
+]
+
+[[package]]
+name = "webpki-roots"
+version = "1.0.9"
+source = "registry+https://github.com/rust-lang/crates.io-index"
+checksum = "7dcd9d09a39985f5344844e66b0c530a33843579125f23e21e9f0f220850f22a"
+dependencies = [
+ "rustls-pki-types",
+]
+
+[[package]]
+name = "windows-core"
+version = "0.62.2"
+source = "registry+https://github.com/rust-lang/crates.io-index"
+checksum = "b8e83a14d34d0623b51dce9581199302a221863196a1dde71a7663a4c2be9deb"
+dependencies = [
+ "windows-implement",
+ "windows-interface",
+ "windows-link",
+ "windows-result",
+ "windows-strings",
+]
+
+[[package]]
+name = "windows-implement"
+version = "0.60.2"
+source = "registry+https://github.com/rust-lang/crates.io-index"
+checksum = "053e2e040ab57b9dc951b72c264860db7eb3b0200ba345b4e4c3b14f67855ddf"
+dependencies = [
+ "proc-macro2",
+ "quote",
+ "syn 2.0.119",
+]
+
+[[package]]
+name = "windows-interface"
+version = "0.59.3"
+source = "registry+https://github.com/rust-lang/crates.io-index"
+checksum = "3f316c4a2570ba26bbec722032c4099d8c8bc095efccdc15688708623367e358"
+dependencies = [
+ "proc-macro2",
+ "quote",
+ "syn 2.0.119",
+]
+
+[[package]]
+name = "windows-link"
+version = "0.2.1"
+source = "registry+https://github.com/rust-lang/crates.io-index"
+checksum = "f0805222e57f7521d6a62e36fa9163bc891acd422f971defe97d64e70d0a4fe5"
+
+[[package]]
+name = "windows-result"
+version = "0.4.1"
+source = "registry+https://github.com/rust-lang/crates.io-index"
+checksum = "7781fa89eaf60850ac3d2da7af8e5242a5ea78d1a11c49bf2910bb5a73853eb5"
+dependencies = [
+ "windows-link",
+]
+
+[[package]]
+name = "windows-strings"
+version = "0.5.1"
+source = "registry+https://github.com/rust-lang/crates.io-index"
+checksum = "7837d08f69c77cf6b07689544538e017c1bfcf57e34b4c0ff58e6c2cd3b37091"
+dependencies = [
+ "windows-link",
+]
+
+[[package]]
+name = "windows-sys"
+version = "0.52.0"
+source = "registry+https://github.com/rust-lang/crates.io-index"
+checksum = "282be5f36a8ce781fad8c8ae18fa3f9beff57ec1b52cb3de0789201425d9a33d"
+dependencies = [
+ "windows-targets",
+]
+
+[[package]]
+name = "windows-sys"
+version = "0.61.2"
+source = "registry+https://github.com/rust-lang/crates.io-index"
+checksum = "ae137229bcbd6cdf0f7b80a31df61766145077ddf49416a728b02cb3921ff3fc"
+dependencies = [
+ "windows-link",
+]
+
+[[package]]
+name = "windows-targets"
+version = "0.52.6"
+source = "registry+https://github.com/rust-lang/crates.io-index"
+checksum = "9b724f72796e036ab90c1021d4780d4d3d648aca59e491e6b98e725b84e99973"
+dependencies = [
+ "windows_aarch64_gnullvm",
+ "windows_aarch64_msvc",
+ "windows_i686_gnu",
+ "windows_i686_gnullvm",
+ "windows_i686_msvc",
+ "windows_x86_64_gnu",
+ "windows_x86_64_gnullvm",
+ "windows_x86_64_msvc",
+]
+
+[[package]]
+name = "windows_aarch64_gnullvm"
+version = "0.52.6"
+source = "registry+https://github.com/rust-lang/crates.io-index"
+checksum = "32a4622180e7a0ec044bb555404c800bc9fd9ec262ec147edd5989ccd0c02cd3"
+
+[[package]]
+name = "windows_aarch64_msvc"
+version = "0.52.6"
+source = "registry+https://github.com/rust-lang/crates.io-index"
+checksum = "09ec2a7bb152e2252b53fa7803150007879548bc709c039df7627cabbd05d469"
+
+[[package]]
+name = "windows_i686_gnu"
+version = "0.52.6"
+source = "registry+https://github.com/rust-lang/crates.io-index"
+checksum = "8e9b5ad5ab802e97eb8e295ac6720e509ee4c243f69d781394014ebfe8bbfa0b"
+
+[[package]]
+name = "windows_i686_gnullvm"
+version = "0.52.6"
+source = "registry+https://github.com/rust-lang/crates.io-index"
+checksum = "0eee52d38c090b3caa76c563b86c3a4bd71ef1a819287c19d586d7334ae8ed66"
+
+[[package]]
+name = "windows_i686_msvc"
+version = "0.52.6"
+source = "registry+https://github.com/rust-lang/crates.io-index"
+checksum = "240948bc05c5e7c6dabba28bf89d89ffce3e303022809e73deaefe4f6ec56c66"
+
+[[package]]
+name = "windows_x86_64_gnu"
+version = "0.52.6"
+source = "registry+https://github.com/rust-lang/crates.io-index"
+checksum = "147a5c80aabfbf0c7d901cb5895d1de30ef2907eb21fbbab29ca94c5b08b1a78"
+
+[[package]]
+name = "windows_x86_64_gnullvm"
+version = "0.52.6"
+source = "registry+https://github.com/rust-lang/crates.io-index"
+checksum = "24d5b23dc417412679681396f2b49f3de8c1473deb516bd34410872eff51ed0d"
+
+[[package]]
+name = "windows_x86_64_msvc"
+version = "0.52.6"
+source = "registry+https://github.com/rust-lang/crates.io-index"
+checksum = "589f6da84c646204747d1270a2a5661ea66ed1cced2631d546fdfb155959f9ec"
+
+[[package]]
+name = "writeable"
+version = "0.6.3"
+source = "registry+https://github.com/rust-lang/crates.io-index"
+checksum = "1ffae5123b2d3fc086436f8834ae3ab053a283cfac8fe0a0b8eaae044768a4c4"
+
+[[package]]
+name = "yoke"
+version = "0.8.3"
+source = "registry+https://github.com/rust-lang/crates.io-index"
+checksum = "709fe23a0424b6a435d82152b1bd3fdfb0833487d5fa90d05d42762a9891fef5"
+dependencies = [
+ "stable_deref_trait",
+ "yoke-derive",
+ "zerofrom",
+]
+
+[[package]]
+name = "yoke-derive"
+version = "0.8.2"
+source = "registry+https://github.com/rust-lang/crates.io-index"
+checksum = "de844c262c8848816172cef550288e7dc6c7b7814b4ee56b3e1553f275f1858e"
+dependencies = [
+ "proc-macro2",
+ "quote",
+ "syn 2.0.119",
+ "synstructure",
+]
+
+[[package]]
+name = "zerofrom"
+version = "0.1.8"
+source = "registry+https://github.com/rust-lang/crates.io-index"
+checksum = "0ec05a11813ea801ff6d75110ad09cd0824ddba17dfe17128ea0d5f68e6c5272"
+dependencies = [
+ "zerofrom-derive",
+]
+
+[[package]]
+name = "zerofrom-derive"
+version = "0.1.7"
+source = "registry+https://github.com/rust-lang/crates.io-index"
+checksum = "11532158c46691caf0f2593ea8358fed6bbf68a0315e80aae9bd41fbade684a1"
+dependencies = [
+ "proc-macro2",
+ "quote",
+ "syn 2.0.119",
+ "synstructure",
+]
+
+[[package]]
+name = "zeroize"
+version = "1.9.0"
+source = "registry+https://github.com/rust-lang/crates.io-index"
+checksum = "e13c156562582aa81c60cb29407084cdb54c4164760106ab78e6c5b0858cf64e"
+
+[[package]]
+name = "zerotrie"
+version = "0.2.4"
+source = "registry+https://github.com/rust-lang/crates.io-index"
+checksum = "0f9152d31db0792fa83f70fb2f83148effb5c1f5b8c7686c3459e361d9bc20bf"
+dependencies = [
+ "displaydoc",
+ "yoke",
+ "zerofrom",
+]
+
+[[package]]
+name = "zerovec"
+version = "0.11.6"
+source = "registry+https://github.com/rust-lang/crates.io-index"
+checksum = "90f911cbc359ab6af17377d242225f4d75119aec87ea711a880987b18cd7b239"
+dependencies = [
+ "yoke",
+ "zerofrom",
+ "zerovec-derive",
+]
+
+[[package]]
+name = "zerovec-derive"
+version = "0.11.3"
+source = "registry+https://github.com/rust-lang/crates.io-index"
+checksum = "625dc425cab0dca6dc3c3319506e6593dcb08a9f387ea3b284dbd52a92c40555"
+dependencies = [
+ "proc-macro2",
+ "quote",
+ "syn 2.0.119",
+]
+
+[[package]]
+name = "zmij"
+version = "1.0.23"
+source = "registry+https://github.com/rust-lang/crates.io-index"
+checksum = "29666d0abbfad1e3dc4dcf6144730dd3a3ab225bbbdac83319345b1b44ccfc1b"
diff --git a/Cargo.toml b/Cargo.toml
new file mode 100644
index 0000000..f36b58b
--- /dev/null
+++ b/Cargo.toml
@@ -0,0 +1,20 @@
+[package]
+name = "mp-ai-module-controller"
+version = "0.1.0"
+edition = "2024"
+description = "Rust controller for llama.cpp-driven local module dispatch."
+
+[dependencies]
+anyhow = "1.0"
+chrono = { version = "0.4", default-features = false, features = ["clock", "serde"] }
+clap = { version = "4.5", features = ["derive"] }
+dotenvy = "0.15"
+reqwest = { version = "0.12", default-features = false, features = ["blocking", "json", "rustls-tls"] }
+serde = { version = "1.0", features = ["derive"] }
+serde_json = "1.0"
+shell-words = "1.1"
+tracing = "0.1"
+tracing-subscriber = { version = "0.3", features = ["env-filter"] }
+
+[dev-dependencies]
+tempfile = "3.10"
diff --git a/README.md b/README.md
new file mode 100644
index 0000000..b911b61
--- /dev/null
+++ b/README.md
@@ -0,0 +1,75 @@
+# mp-ai-module-controller
+
+Rust controller for starting a local `llama.cpp` server, asking it to map natural-language requests to known local actions, and dispatching exact-match Rust scripts.
+
+## Setup
+
+```sh
+cp .env.example .env
+# edit LLAMA_MODEL_PATH in .env
+cargo build
+cargo run -- dictionary generate
+git config core.hooksPath .githooks
+```
+
+The controller expects `llama-server` from `llama.cpp` to be installed. On this machine the planned binary is `/opt/homebrew/bin/llama-server`; if that path is not present, the controller falls back to `llama-server` on `PATH`.
+
+## Commands
+
+```sh
+cargo run -- dictionary generate
+cargo run -- serve
+cargo run -- query "log hello from codex"
+cargo run -- run logger --payload '{"message":"hello from direct dispatch"}'
+scripts/precommit-check.sh
+```
+
+`serve` starts:
+
+```sh
+llama-server --model "$LLAMA_MODEL_PATH" --host "$LLAMA_HOST" --port "$LLAMA_PORT"
+```
+
+Optional environment variables:
+
+- `LLAMA_CONTEXT_SIZE`: appended as `--ctx-size`.
+- `LLAMA_EXTRA_ARGS`: shell-split and appended to `llama-server`.
+- `CONTROLLER_LOG_LEVEL`: tracing log level, default `info`.
+
+## Dictionary
+
+Run `cargo run -- dictionary generate` to create:
+
+- `dictionary/actions.jsonl`: canonical training dictionary, one action record per line.
+- `dictionary/actions.index.json`: compact runtime lookup index.
+
+The runtime only dispatches exact `action_id` matches from `actions.index.json`. Aliases and examples are training hints, not executable ids.
+
+## LLM Response Contract
+
+The local model must return compact JSON:
+
+```json
+{"action_id":"logger","payload":{"message":"hello"}}
+```
+
+Malformed JSON, missing `action_id`, empty `action_id`, aliases, and unknown action ids are rejected without running anything.
+
+## Initial Script
+
+The first registered script is `logger`. It writes JSONL records to `logs/controller-actions.jsonl`. Dispatch is detached: after the controller spawns the script process, it does not monitor completion.
+
+## CI And Hooks
+
+The project includes:
+
+- `.gitea/workflows/ci.yml` for Gitea Actions.
+- `.woodpecker.yml` for Woodpecker.
+- `.githooks/pre-commit` for local pre-commit checks.
+- `scripts/precommit-check.sh` as the shared validation entrypoint.
+
+Enable the hook after cloning:
+
+```sh
+git config core.hooksPath .githooks
+```
diff --git a/llm.txt b/llm.txt
new file mode 100644
index 0000000..f3ce65d
--- /dev/null
+++ b/llm.txt
@@ -0,0 +1,41 @@
+# mp-ai-module-controller
+
+Rust CLI for local llama.cpp action dispatch.
+
+Important files:
+
+- `src/main.rs`: CLI entrypoint.
+- `src/registry.rs`: source-of-truth action registry.
+- `src/dictionary.rs`: generates `dictionary/actions.jsonl` and `dictionary/actions.index.json`.
+- `src/llm.rs`: sends OpenAI-compatible chat requests to the local llama.cpp server and parses action JSON.
+- `src/dispatcher.rs`: exact-match runtime dispatch and detached script spawning.
+- `src/scripts/logger.rs`: proof-of-concept logger script.
+- `AGENTS.md`: agent instructions.
+- `manifest.llm.json`: machine-readable project metadata.
+- `.env.example`: environment variable template.
+
+Commands:
+
+- `cargo build`
+- `cargo test`
+- `cargo run -- dictionary generate`
+- `cargo run -- serve`
+- `cargo run -- query "log hello from codex"`
+- `cargo run -- run logger --payload '{"message":"hello from codex"}'`
+- `scripts/codex-setup.sh`
+- `scripts/codex-run-logger.sh`
+- `scripts/precommit-check.sh`
+- `git config core.hooksPath .githooks`
+
+Environment:
+
+- `LLAMA_MODEL_PATH`: required for `serve`; local GGUF model path.
+- `LLAMA_HOST`: default `127.0.0.1`.
+- `LLAMA_PORT`: default `8080`.
+- `LLAMA_CONTEXT_SIZE`: optional `--ctx-size`.
+- `LLAMA_EXTRA_ARGS`: optional extra llama-server args.
+- `CONTROLLER_LOG_LEVEL`: default `info`.
+
+The LLM must return compact JSON like `{"action_id":"logger","payload":{"message":"hello"}}`. The runtime only executes exact `action_id` matches from `dictionary/actions.index.json`; aliases are not executable. Invalid or unknown outputs are rejected without running anything.
+
+CI and hooks: `.gitea/workflows/ci.yml`, `.woodpecker.yml`, and `.githooks/pre-commit` all use `scripts/precommit-check.sh` to verify formatting, tests, and dictionary generation.
diff --git a/manifest.llm.json b/manifest.llm.json
new file mode 100644
index 0000000..6419428
--- /dev/null
+++ b/manifest.llm.json
@@ -0,0 +1,124 @@
+{
+  "schema_version": "1.0",
+  "name": "mp-ai-module-controller",
+  "description": "Rust CLI controller for llama.cpp-backed local action dispatch.",
+  "project_type": "cli",
+  "language": "rust",
+  "package_manager": "cargo",
+  "entrypoints": {
+    "main": "src/main.rs",
+    "action_registry": "src/registry.rs",
+    "dictionary_generator": "src/dictionary.rs",
+    "llm_client": "src/llm.rs",
+    "dispatcher": "src/dispatcher.rs",
+    "logger_script": "src/scripts/logger.rs"
+  },
+  "commands": {
+    "build": "cargo build",
+    "test": "cargo test",
+    "generate_dictionary": "cargo run -- dictionary generate",
+    "serve": "cargo run -- serve",
+    "query": "cargo run -- query \"log hello from codex\"",
+    "run_logger": "cargo run -- run logger --payload '{\"message\":\"hello from codex\"}'",
+    "codex_setup": "scripts/codex-setup.sh",
+    "codex_logger_smoke": "scripts/codex-run-logger.sh",
+    "precommit_check": "scripts/precommit-check.sh",
+    "install_hooks": "git config core.hooksPath .githooks"
+  },
+  "environment": {
+    "example_file": ".env.example",
+    "variables": [
+      {
+        "name": "LLAMA_MODEL_PATH",
+        "required": true,
+        "secret": false,
+        "description": "Absolute path to a local GGUF model used by llama-server."
+      },
+      {
+        "name": "LLAMA_HOST",
+        "required": false,
+        "secret": false,
+        "default": "127.0.0.1",
+        "description": "Host for the local llama.cpp server."
+      },
+      {
+        "name": "LLAMA_PORT",
+        "required": false,
+        "secret": false,
+        "default": "8080",
+        "description": "Port for the local llama.cpp server."
+      },
+      {
+        "name": "LLAMA_CONTEXT_SIZE",
+        "required": false,
+        "secret": false,
+        "description": "Optional context size passed to llama-server as --ctx-size."
+      },
+      {
+        "name": "LLAMA_EXTRA_ARGS",
+        "required": false,
+        "secret": false,
+        "description": "Optional shell-split extra arguments appended to llama-server."
+      },
+      {
+        "name": "CONTROLLER_LOG_LEVEL",
+        "required": false,
+        "secret": false,
+        "default": "info",
+        "description": "Tracing log level for the controller."
+      }
+    ]
+  },
+  "llama_cpp": {
+    "server_binary": "/opt/homebrew/bin/llama-server",
+    "fallback_binary": "llama-server",
+    "api": "OpenAI-compatible /v1/chat/completions",
+    "response_contract": {
+      "format": "compact JSON",
+      "example": {
+        "action_id": "logger",
+        "payload": {
+          "message": "hello"
+        }
+      }
+    }
+  },
+  "dictionary": {
+    "source_of_truth": "src/registry.rs",
+    "generated_jsonl": "dictionary/actions.jsonl",
+    "generated_index": "dictionary/actions.index.json",
+    "runtime_policy": "Only exact action_id matches from the generated index are executable."
+  },
+  "actions": [
+    {
+      "action_id": "logger",
+      "script": "src/scripts/logger.rs",
+      "description": "Proof-of-concept script that writes structured JSONL log records.",
+      "payload_example": {
+        "message": "hello from codex"
+      },
+      "output": "logs/controller-actions.jsonl"
+    }
+  ],
+  "generated_paths": [
+    "target/",
+    "logs/",
+    "runtime/",
+    "dictionary/actions.jsonl",
+    "dictionary/actions.index.json"
+  ],
+  "ci": {
+    "gitea_actions": ".gitea/workflows/ci.yml",
+    "woodpecker": ".woodpecker.yml",
+    "precommit_hook": ".githooks/pre-commit",
+    "shared_check": "scripts/precommit-check.sh",
+    "checks": [
+      "cargo fmt --check",
+      "cargo test",
+      "cargo run -- dictionary generate",
+      "test -s dictionary/actions.jsonl",
+      "test -s dictionary/actions.index.json"
+    ]
+  },
+  "agent_guidance": "See AGENTS.md. Keep src/registry.rs as the source of truth, regenerate dictionary files after action changes, and reject non-exact LLM action outputs."
+}
diff --git a/scripts/codex-run-logger.sh b/scripts/codex-run-logger.sh
new file mode 100755
index 0000000..371bebe
--- /dev/null
+++ b/scripts/codex-run-logger.sh
@@ -0,0 +1,9 @@
+#!/usr/bin/env bash
+set -euo pipefail
+
+cd "$(dirname "$0")/.."
+
+cargo run -- dictionary generate
+cargo run -- run logger --payload '{"message":"hello from codex"}'
+
+echo "logger dispatched; see logs/controller-actions.jsonl"
diff --git a/scripts/codex-setup.sh b/scripts/codex-setup.sh
new file mode 100755
index 0000000..744d94e
--- /dev/null
+++ b/scripts/codex-setup.sh
@@ -0,0 +1,20 @@
+#!/usr/bin/env bash
+set -euo pipefail
+
+cd "$(dirname "$0")/.."
+
+command -v rustc >/dev/null
+command -v cargo >/dev/null
+
+if [[ -x /opt/homebrew/bin/llama-server ]]; then
+  echo "llama-server: /opt/homebrew/bin/llama-server"
+else
+  command -v llama-server >/dev/null
+  echo "llama-server: $(command -v llama-server)"
+fi
+
+mkdir -p dictionary logs runtime
+cargo build
+cargo run -- dictionary generate
+
+echo "codex setup complete"
diff --git a/scripts/precommit-check.sh b/scripts/precommit-check.sh
new file mode 100755
index 0000000..84125ac
--- /dev/null
+++ b/scripts/precommit-check.sh
@@ -0,0 +1,13 @@
+#!/usr/bin/env bash
+set -euo pipefail
+
+cd "$(dirname "$0")/.."
+
+cargo fmt --check
+cargo test
+cargo run -- dictionary generate
+
+test -s dictionary/actions.jsonl
+test -s dictionary/actions.index.json
+
+echo "precommit check complete"
diff --git a/src/config.rs b/src/config.rs
new file mode 100644
index 0000000..762748a
--- /dev/null
+++ b/src/config.rs
@@ -0,0 +1,26 @@
+use std::env;
+
+#[derive(Debug, Clone, PartialEq, Eq)]
+pub struct ControllerConfig {
+    pub llama_host: String,
+    pub llama_port: u16,
+}
+
+impl ControllerConfig {
+    pub fn from_env() -> Self {
+        let llama_host = env::var("LLAMA_HOST").unwrap_or_else(|_| "127.0.0.1".to_string());
+        let llama_port = env::var("LLAMA_PORT")
+            .ok()
+            .and_then(|value| value.parse::<u16>().ok())
+            .unwrap_or(8080);
+
+        Self {
+            llama_host,
+            llama_port,
+        }
+    }
+
+    pub fn base_url(&self) -> String {
+        format!("http://{}:{}", self.llama_host, self.llama_port)
+    }
+}
diff --git a/src/dictionary.rs b/src/dictionary.rs
new file mode 100644
index 0000000..214abeb
--- /dev/null
+++ b/src/dictionary.rs
@@ -0,0 +1,145 @@
+use anyhow::{Context, Result};
+use serde::{Deserialize, Serialize};
+use std::collections::BTreeMap;
+use std::fs::{self, File};
+use std::io::Write;
+#[cfg(test)]
+use std::io::{BufRead, BufReader};
+use std::path::{Path, PathBuf};
+
+use crate::registry::ActionDefinition;
+
+#[derive(Debug, Clone, Serialize, Deserialize, PartialEq)]
+pub struct ActionDictionaryRecord {
+    pub action_id: String,
+    pub aliases: Vec<String>,
+    pub description: String,
+    pub intent_examples: Vec<String>,
+    pub payload_schema: serde_json::Value,
+    pub executable: crate::registry::ExecutableDefinition,
+}
+
+#[derive(Debug, Clone, Serialize, Deserialize, PartialEq)]
+pub struct ActionIndex {
+    pub schema_version: String,
+    pub actions: BTreeMap<String, ActionDictionaryRecord>,
+}
+
+#[derive(Debug, Clone, PartialEq, Eq)]
+pub struct DictionarySummary {
+    pub action_count: usize,
+    pub jsonl_path: PathBuf,
+    pub index_path: PathBuf,
+}
+
+pub fn default_dictionary_dir() -> PathBuf {
+    PathBuf::from("dictionary")
+}
+
+pub fn generate_dictionary_files(
+    actions: &[ActionDefinition],
+    out_dir: &Path,
+) -> Result<DictionarySummary> {
+    fs::create_dir_all(out_dir)
+        .with_context(|| format!("creating dictionary directory {}", out_dir.display()))?;
+
+    let jsonl_path = out_dir.join("actions.jsonl");
+    let index_path = out_dir.join("actions.index.json");
+    let records = actions
+        .iter()
+        .cloned()
+        .map(ActionDictionaryRecord::from)
+        .collect::<Vec<_>>();
+
+    let mut jsonl =
+        File::create(&jsonl_path).with_context(|| format!("creating {}", jsonl_path.display()))?;
+    for record in &records {
+        serde_json::to_writer(&mut jsonl, record)?;
+        jsonl.write_all(b"\n")?;
+    }
+
+    let index = ActionIndex {
+        schema_version: "1.0".to_string(),
+        actions: records
+            .into_iter()
+            .map(|record| (record.action_id.clone(), record))
+            .collect(),
+    };
+
+    let pretty = serde_json::to_string_pretty(&index)?;
+    fs::write(&index_path, format!("{pretty}\n"))
+        .with_context(|| format!("writing {}", index_path.display()))?;
+
+    Ok(DictionarySummary {
+        action_count: index.actions.len(),
+        jsonl_path,
+        index_path,
+    })
+}
+
+pub fn load_action_index(dictionary_dir: &Path) -> Result<ActionIndex> {
+    let path = dictionary_dir.join("actions.index.json");
+    let raw = fs::read_to_string(&path).with_context(|| {
+        format!(
+            "reading {}; run `cargo run -- dictionary generate` first",
+            path.display()
+        )
+    })?;
+    let index = serde_json::from_str::<ActionIndex>(&raw)
+        .with_context(|| format!("parsing {}", path.display()))?;
+    Ok(index)
+}
+
+#[cfg(test)]
+fn read_jsonl_records(path: &Path) -> Result<Vec<ActionDictionaryRecord>> {
+    let file = File::open(path).with_context(|| format!("opening {}", path.display()))?;
+    let reader = BufReader::new(file);
+    let mut records = Vec::new();
+
+    for line in reader.lines() {
+        let line = line?;
+        if line.trim().is_empty() {
+            continue;
+        }
+        records.push(serde_json::from_str::<ActionDictionaryRecord>(&line)?);
+    }
+
+    Ok(records)
+}
+
+impl From<ActionDefinition> for ActionDictionaryRecord {
+    fn from(action: ActionDefinition) -> Self {
+        Self {
+            action_id: action.action_id,
+            aliases: action.aliases,
+            description: action.description,
+            intent_examples: action.intent_examples,
+            payload_schema: action.payload_schema,
+            executable: action.executable,
+        }
+    }
+}
+
+#[cfg(test)]
+mod tests {
+    use super::*;
+    use crate::registry::registered_actions;
+
+    #[test]
+    fn generates_jsonl_and_index() {
+        let temp = tempfile::tempdir().expect("temp dir");
+        let summary = generate_dictionary_files(&registered_actions(), temp.path()).unwrap();
+
+        assert_eq!(summary.action_count, 1);
+        assert!(summary.jsonl_path.exists());
+        assert!(summary.index_path.exists());
+
+        let records = read_jsonl_records(&summary.jsonl_path).unwrap();
+        assert_eq!(records.len(), 1);
+        assert_eq!(records[0].action_id, "logger");
+
+        let index = load_action_index(temp.path()).unwrap();
+        assert!(index.actions.contains_key("logger"));
+        assert!(!index.actions.contains_key("log"));
+    }
+}
diff --git a/src/dispatcher.rs b/src/dispatcher.rs
new file mode 100644
index 0000000..bd0f717
--- /dev/null
+++ b/src/dispatcher.rs
@@ -0,0 +1,95 @@
+use anyhow::{Context, Result, anyhow, bail};
+use serde_json::Value;
+use std::fs::{self, OpenOptions};
+use std::process::{Command, Stdio};
+
+use crate::dictionary::ActionIndex;
+use crate::scripts::logger::{LoggerPayload, run_logger};
+
+pub fn dispatch_action(index: &ActionIndex, action_id: &str, payload: Value) -> Result<()> {
+    let action = index
+        .actions
+        .get(action_id)
+        .ok_or_else(|| anyhow!("unknown action_id `{action_id}`; refusing to dispatch"))?;
+
+    if action.executable.kind != "internal-rust-script" {
+        bail!(
+            "unsupported executable kind `{}` for action `{}`",
+            action.executable.kind,
+            action.action_id
+        );
+    }
+
+    let payload = serde_json::to_string(&payload)?;
+    let current_exe = std::env::current_exe().context("resolving current executable")?;
+    let log_file = open_child_log()?;
+
+    Command::new(current_exe)
+        .arg("__script")
+        .arg(&action.executable.script)
+        .arg("--payload")
+        .arg(payload)
+        .stdin(Stdio::null())
+        .stdout(Stdio::from(log_file.try_clone()?))
+        .stderr(Stdio::from(log_file))
+        .spawn()
+        .with_context(|| format!("spawning action `{action_id}`"))?;
+
+    tracing::info!("dispatched action `{}`", action_id);
+    println!("dispatched action `{action_id}`");
+    Ok(())
+}
+
+pub fn run_internal_script(action_id: &str, payload: Value) -> Result<()> {
+    match action_id {
+        "logger" => {
+            let payload = serde_json::from_value::<LoggerPayload>(payload)?;
+            run_logger(payload)
+        }
+        other => bail!("unknown internal script `{other}`"),
+    }
+}
+
+fn open_child_log() -> Result<std::fs::File> {
+    fs::create_dir_all("logs").context("creating logs directory")?;
+    let file = OpenOptions::new()
+        .create(true)
+        .append(true)
+        .open("logs/controller-child.log")
+        .context("opening logs/controller-child.log")?;
+    Ok(file)
+}
+
+#[cfg(test)]
+mod tests {
+    use super::*;
+    use crate::dictionary::ActionIndex;
+    use crate::registry::registered_actions;
+    use std::collections::BTreeMap;
+
+    fn test_index() -> ActionIndex {
+        let actions = registered_actions()
+            .into_iter()
+            .map(crate::dictionary::ActionDictionaryRecord::from)
+            .map(|record| (record.action_id.clone(), record))
+            .collect::<BTreeMap<_, _>>();
+
+        ActionIndex {
+            schema_version: "1.0".to_string(),
+            actions,
+        }
+    }
+
+    #[test]
+    fn exact_action_lookup_accepts_registered_id() {
+        let index = test_index();
+        assert!(index.actions.contains_key("logger"));
+    }
+
+    #[test]
+    fn exact_action_lookup_rejects_alias() {
+        let index = test_index();
+        let result = dispatch_action(&index, "log", serde_json::json!({ "message": "test" }));
+        assert!(result.is_err());
+    }
+}
diff --git a/src/llm.rs b/src/llm.rs
new file mode 100644
index 0000000..c494917
--- /dev/null
+++ b/src/llm.rs
@@ -0,0 +1,167 @@
+use anyhow::{Context, Result, anyhow, bail};
+use reqwest::blocking::Client;
+use serde::{Deserialize, Serialize};
+use serde_json::Value;
+use std::time::Duration;
+
+use crate::config::ControllerConfig;
+use crate::dictionary::ActionIndex;
+
+#[derive(Debug, Clone, Serialize, Deserialize, PartialEq)]
+pub struct ActionRequest {
+    pub action_id: String,
+    #[serde(default)]
+    pub payload: Value,
+}
+
+#[derive(Debug, Serialize)]
+struct ChatRequest {
+    model: String,
+    messages: Vec<ChatMessage>,
+    temperature: f32,
+    stream: bool,
+}
+
+#[derive(Debug, Serialize)]
+struct ChatMessage {
+    role: String,
+    content: String,
+}
+
+#[derive(Debug, Deserialize)]
+struct ChatResponse {
+    choices: Vec<ChatChoice>,
+}
+
+#[derive(Debug, Deserialize)]
+struct ChatChoice {
+    message: ChatChoiceMessage,
+}
+
+#[derive(Debug, Deserialize)]
+struct ChatChoiceMessage {
+    content: String,
+}
+
+pub fn query_llama(config: &ControllerConfig, index: &ActionIndex, text: &str) -> Result<String> {
+    let actions = serde_json::to_string(&index.actions)?;
+    let system = format!(
+        "You map user requests to exact local action ids. Return only compact JSON with shape {{\"action_id\":\"...\",\"payload\":{{...}}}}. Valid actions index: {actions}"
+    );
+    let request = ChatRequest {
+        model: "local".to_string(),
+        messages: vec![
+            ChatMessage {
+                role: "system".to_string(),
+                content: system,
+            },
+            ChatMessage {
+                role: "user".to_string(),
+                content: text.to_string(),
+            },
+        ],
+        temperature: 0.0,
+        stream: false,
+    };
+
+    let url = format!("{}/v1/chat/completions", config.base_url());
+    let client = Client::builder()
+        .timeout(Duration::from_secs(120))
+        .build()
+        .context("building HTTP client")?;
+    let response = client
+        .post(&url)
+        .json(&request)
+        .send()
+        .with_context(|| format!("posting to {url}"))?
+        .error_for_status()
+        .with_context(|| format!("llama.cpp server returned an error for {url}"))?
+        .json::<ChatResponse>()
+        .context("parsing OpenAI-compatible chat completion response")?;
+
+    response
+        .choices
+        .into_iter()
+        .next()
+        .map(|choice| choice.message.content)
+        .ok_or_else(|| anyhow!("llama.cpp response had no choices"))
+}
+
+pub fn parse_action_response(raw: &str) -> Result<ActionRequest> {
+    let trimmed = raw.trim();
+    let json_text = if trimmed.starts_with('{') {
+        trimmed
+    } else {
+        extract_first_json_object(trimmed)
+            .ok_or_else(|| anyhow!("LLM response did not contain a JSON object"))?
+    };
+
+    let request = serde_json::from_str::<ActionRequest>(json_text)
+        .with_context(|| format!("parsing LLM action JSON: {json_text}"))?;
+
+    if request.action_id.trim().is_empty() {
+        bail!("LLM action JSON had an empty action_id");
+    }
+
+    Ok(request)
+}
+
+fn extract_first_json_object(text: &str) -> Option<&str> {
+    let start = text.find('{')?;
+    let mut depth = 0_i32;
+    let mut in_string = false;
+    let mut escaped = false;
+
+    for (offset, ch) in text[start..].char_indices() {
+        if escaped {
+            escaped = false;
+            continue;
+        }
+
+        match ch {
+            '\\' if in_string => escaped = true,
+            '"' => in_string = !in_string,
+            '{' if !in_string => depth += 1,
+            '}' if !in_string => {
+                depth -= 1;
+                if depth == 0 {
+                    let end = start + offset + ch.len_utf8();
+                    return Some(&text[start..end]);
+                }
+            }
+            _ => {}
+        }
+    }
+
+    None
+}
+
+#[cfg(test)]
+mod tests {
+    use super::*;
+
+    #[test]
+    fn parses_valid_action_response() {
+        let parsed =
+            parse_action_response(r#"{"action_id":"logger","payload":{"message":"hello"}}"#)
+                .unwrap();
+        assert_eq!(parsed.action_id, "logger");
+        assert_eq!(parsed.payload["message"], "hello");
+    }
+
+    #[test]
+    fn parses_embedded_json_response() {
+        let parsed = parse_action_response(
+            r#"Here is the action: {"action_id":"logger","payload":{"message":"hello"}}"#,
+        )
+        .unwrap();
+        assert_eq!(parsed.action_id, "logger");
+    }
+
+    #[test]
+    fn rejects_malformed_response() {
+        assert!(parse_action_response("run logger please").is_err());
+        assert!(parse_action_response(r#"{"payload":{"message":"missing id"}}"#).is_err());
+        assert!(parse_action_response(r#"{"action_id":"","payload":{}}"#).is_err());
+    }
+}
diff --git a/src/main.rs b/src/main.rs
new file mode 100644
index 0000000..1c60795
--- /dev/null
+++ b/src/main.rs
@@ -0,0 +1,125 @@
+mod config;
+mod dictionary;
+mod dispatcher;
+mod llm;
+mod registry;
+mod scripts;
+mod server;
+
+use anyhow::Result;
+use clap::{Parser, Subcommand};
+use serde_json::Value;
+use std::path::PathBuf;
+
+use crate::config::ControllerConfig;
+use crate::dictionary::{default_dictionary_dir, generate_dictionary_files, load_action_index};
+use crate::dispatcher::{dispatch_action, run_internal_script};
+use crate::llm::{parse_action_response, query_llama};
+use crate::registry::registered_actions;
+use crate::server::start_llama_server;
+
+#[derive(Debug, Parser)]
+#[command(name = "mp-ai-module-controller")]
+#[command(about = "Control local Rust scripts through a llama.cpp action dictionary.")]
+struct Cli {
+    #[command(subcommand)]
+    command: Command,
+}
+
+#[derive(Debug, Subcommand)]
+enum Command {
+    /// Start a llama.cpp server using LLAMA_MODEL_PATH.
+    Serve,
+    /// Generate or inspect the LLM action dictionary.
+    Dictionary {
+        #[command(subcommand)]
+        command: DictionaryCommand,
+    },
+    /// Query the local LLM and dispatch the exact action id it returns.
+    Query {
+        /// Natural-language request to send to the local model.
+        text: String,
+    },
+    /// Dispatch a known action id directly.
+    Run {
+        /// Exact action id from dictionary/actions.index.json.
+        action_id: String,
+        /// JSON payload for the action. Defaults to the logger proof-of-concept payload.
+        #[arg(long)]
+        payload: Option<String>,
+    },
+    /// Internal detached script runner. Not part of the public CLI.
+    #[command(name = "__script", hide = true)]
+    Script {
+        action_id: String,
+        #[arg(long)]
+        payload: String,
+    },
+}
+
+#[derive(Debug, Subcommand)]
+enum DictionaryCommand {
+    /// Generate dictionary/actions.jsonl and dictionary/actions.index.json.
+    Generate {
+        /// Output directory for generated dictionary files.
+        #[arg(long)]
+        out_dir: Option<PathBuf>,
+    },
+}
+
+fn main() -> Result<()> {
+    let _ = dotenvy::dotenv();
+    init_tracing();
+
+    let cli = Cli::parse();
+    match cli.command {
+        Command::Serve => {
+            let config = ControllerConfig::from_env();
+            start_llama_server(&config)
+        }
+        Command::Dictionary {
+            command: DictionaryCommand::Generate { out_dir },
+        } => {
+            let out_dir = out_dir.unwrap_or_else(default_dictionary_dir);
+            let summary = generate_dictionary_files(&registered_actions(), &out_dir)?;
+            println!(
+                "generated {} actions: {} and {}",
+                summary.action_count,
+                summary.jsonl_path.display(),
+                summary.index_path.display()
+            );
+            Ok(())
+        }
+        Command::Query { text } => {
+            let config = ControllerConfig::from_env();
+            let index = load_action_index(&default_dictionary_dir())?;
+            let response = query_llama(&config, &index, &text)?;
+            let request = parse_action_response(&response)?;
+            dispatch_action(&index, &request.action_id, request.payload)
+        }
+        Command::Run { action_id, payload } => {
+            let index = load_action_index(&default_dictionary_dir())?;
+            let payload = match payload {
+                Some(raw) => serde_json::from_str::<Value>(&raw)?,
+                None => serde_json::json!({ "message": "logger proof of concept" }),
+            };
+            dispatch_action(&index, &action_id, payload)
+        }
+        Command::Script { action_id, payload } => {
+            let payload = serde_json::from_str::<Value>(&payload)?;
+            run_internal_script(&action_id, payload)
+        }
+    }
+}
+
+fn init_tracing() {
+    let level = std::env::var("CONTROLLER_LOG_LEVEL").unwrap_or_else(|_| "info".to_string());
+    let filter = tracing_subscriber::EnvFilter::try_from_default_env()
+        .or_else(|_| tracing_subscriber::EnvFilter::try_new(level))
+        .unwrap_or_else(|_| tracing_subscriber::EnvFilter::new("info"));
+
+    let _ = tracing_subscriber::fmt()
+        .with_env_filter(filter)
+        .with_target(false)
+        .try_init();
+}
diff --git a/src/registry.rs b/src/registry.rs
new file mode 100644
index 0000000..5bb6b3d
--- /dev/null
+++ b/src/registry.rs
@@ -0,0 +1,50 @@
+use serde::{Deserialize, Serialize};
+use serde_json::Value;
+
+#[derive(Debug, Clone, Serialize, Deserialize, PartialEq)]
+pub struct ActionDefinition {
+    pub action_id: String,
+    pub aliases: Vec<String>,
+    pub description: String,
+    pub intent_examples: Vec<String>,
+    pub payload_schema: Value,
+    pub executable: ExecutableDefinition,
+}
+
+#[derive(Debug, Clone, Serialize, Deserialize, PartialEq)]
+pub struct ExecutableDefinition {
+    pub kind: String,
+    pub script: String,
+}
+
+pub fn registered_actions() -> Vec<ActionDefinition> {
+    vec![ActionDefinition {
+        action_id: "logger".to_string(),
+        aliases: vec![
+            "log".to_string(),
+            "write_log".to_string(),
+            "record_message".to_string(),
+        ],
+        description: "Write a structured proof-of-concept log message.".to_string(),
+        intent_examples: vec![
+            "log hello from codex".to_string(),
+            "record this message".to_string(),
+            "write a logger proof of concept entry".to_string(),
+        ],
+        payload_schema: serde_json::json!({
+            "type": "object",
+            "required": ["message"],
+            "properties": {
+                "message": {
+                    "type": "string",
+                    "description": "Message text to write into logs/controller-actions.jsonl."
+                }
+            },
+            "additionalProperties": false
+        }),
+        executable: ExecutableDefinition {
+            kind: "internal-rust-script".to_string(),
+            script: "logger".to_string(),
+        },
+    }]
+}
diff --git a/src/scripts/logger.rs b/src/scripts/logger.rs
new file mode 100644
index 0000000..0d70213
--- /dev/null
+++ b/src/scripts/logger.rs
@@ -0,0 +1,73 @@
+use anyhow::{Context, Result};
+use chrono::Utc;
+use serde::{Deserialize, Serialize};
+use std::fs::{self, OpenOptions};
+use std::io::Write;
+
+#[derive(Debug, Clone, Serialize, Deserialize, PartialEq, Eq)]
+pub struct LoggerPayload {
+    pub message: String,
+}
+
+#[derive(Debug, Clone, Serialize, Deserialize, PartialEq, Eq)]
+pub struct LoggerRecord {
+    pub timestamp: String,
+    pub action_id: String,
+    pub message: String,
+}
+
+pub fn run_logger(payload: LoggerPayload) -> Result<()> {
+    let record = build_logger_record(payload)?;
+    fs::create_dir_all("logs").context("creating logs directory")?;
+
+    let mut file = OpenOptions::new()
+        .create(true)
+        .append(true)
+        .open("logs/controller-actions.jsonl")
+        .context("opening logs/controller-actions.jsonl")?;
+
+    serde_json::to_writer(&mut file, &record)?;
+    file.write_all(b"\n")?;
+    println!("logger wrote: {}", record.message);
+    Ok(())
+}
+
+pub fn build_logger_record(payload: LoggerPayload) -> Result<LoggerRecord> {
+    let message = payload.message.trim();
+    if message.is_empty() {
+        anyhow::bail!("logger payload message must not be empty");
+    }
+
+    Ok(LoggerRecord {
+        timestamp: Utc::now().to_rfc3339(),
+        action_id: "logger".to_string(),
+        message: message.to_string(),
+    })
+}
+
+#[cfg(test)]
+mod tests {
+    use super::*;
+
+    #[test]
+    fn validates_and_serializes_payload() {
+        let payload = LoggerPayload {
+            message: " hello ".to_string(),
+        };
+        let record = build_logger_record(payload).unwrap();
+        assert_eq!(record.action_id, "logger");
+        assert_eq!(record.message, "hello");
+
+        let json = serde_json::to_string(&record).unwrap();
+        assert!(json.contains(r#""action_id":"logger""#));
+        assert!(json.contains(r#""message":"hello""#));
+    }
+
+    #[test]
+    fn rejects_empty_message() {
+        let result = build_logger_record(LoggerPayload {
+            message: "   ".to_string(),
+        });
+        assert!(result.is_err());
+    }
+}
diff --git a/src/scripts/mod.rs b/src/scripts/mod.rs
new file mode 100644
index 0000000..d991728
--- /dev/null
+++ b/src/scripts/mod.rs
@@ -0,0 +1 @@
+pub mod logger;
diff --git a/src/server.rs b/src/server.rs
new file mode 100644
index 0000000..7b2e181
--- /dev/null
+++ b/src/server.rs
@@ -0,0 +1,54 @@
+use anyhow::{Context, Result, anyhow};
+use std::path::Path;
+use std::process::Command;
+
+use crate::config::ControllerConfig;
+
+pub fn start_llama_server(config: &ControllerConfig) -> Result<()> {
+    let model_path = std::env::var("LLAMA_MODEL_PATH")
+        .map_err(|_| anyhow!("LLAMA_MODEL_PATH is required and must point to a GGUF model"))?;
+
+    let binary = llama_server_binary();
+    let mut command = Command::new(&binary);
+    command
+        .arg("--model")
+        .arg(model_path)
+        .arg("--host")
+        .arg(&config.llama_host)
+        .arg("--port")
+        .arg(config.llama_port.to_string());
+
+    if let Ok(context_size) = std::env::var("LLAMA_CONTEXT_SIZE") {
+        if !context_size.trim().is_empty() {
+            command.arg("--ctx-size").arg(context_size);
+        }
+    }
+
+    if let Ok(extra_args) = std::env::var("LLAMA_EXTRA_ARGS") {
+        if !extra_args.trim().is_empty() {
+            for arg in shell_words::split(&extra_args).context("parsing LLAMA_EXTRA_ARGS")? {
+                command.arg(arg);
+            }
+        }
+    }
+
+    tracing::info!("starting llama.cpp server on {}", config.base_url());
+    let status = command
+        .status()
+        .with_context(|| format!("starting {}", binary.display()))?;
+
+    if status.success() {
+        Ok(())
+    } else {
+        Err(anyhow!("llama-server exited with status {status}"))
+    }
+}
+
+fn llama_server_binary() -> std::path::PathBuf {
+    let homebrew_path = Path::new("/opt/homebrew/bin/llama-server");
+    if homebrew_path.exists() {
+        homebrew_path.to_path_buf()
+    } else {
+        "llama-server".into()
+    }
+}