feat: крейт mt-protocol — вбудована специфікація для Rust-реалізації

.github/workflows/lint-rust.yml

@@ -0,0 +1,42 @@
+name: Lint Rust
+
+on:
+  push:
+    branches:
+      - dev
+      - main
+    paths:
+      - '**/*.rs'
+      - '**/Cargo.toml'
+      - '**/Cargo.lock'
+
+  pull_request:
+    branches:
+      - dev
+      - main
+
+concurrency:
+  group: ${{ github.ref }}-${{ github.workflow }}
+  cancel-in-progress: true
+
+jobs:
+  lint:
+    runs-on: ubuntu-latest
+    permissions:
+      contents: read
+    steps:
+      - uses: actions/checkout@v6
+        with:
+          persist-credentials: false
+
+      - uses: dtolnay/rust-toolchain@stable
+        with:
+          components: rustfmt, clippy
+
+      - uses: Swatinem/rust-cache@v2
+
+      - name: Rustfmt
+        run: cargo fmt --all -- --check
+
+      - name: Clippy
+        run: cargo clippy --all-targets --all-features -- -D warnings

.gitignore

@@ -1,5 +1,6 @@
 node_modules/
 dist/
+/target
 
 *.secret
 

.n-rules.json

@@ -6,6 +6,7 @@
     "ci4",
     "feedback",
     "ga",
+    "rust",
     "security",
     "text"
   ],

Cargo.toml

@@ -0,0 +1,11 @@
+[package]
+name = "mt-protocol"
+version = "0.1.0"
+edition = "2021"
+description = "Специфікація протоколу MT, вбудована як Rust-крейт — docs/ корпус доступний без ручного копіювання"
+license = "ISC"
+repository = "https://github.com/nitra/mt"
+keywords = ["mt", "protocol", "spec", "docs", "agent"]
+
+[dependencies]
+include_dir = { version = "0.7.4", features = ["glob"] }

README.md

@@ -31,3 +31,7 @@ npm i @7n/mt
 ## Генерація шарів
 
 `docs/layers.json` — конфіг і CRC-маркери (`<!-- layers:... -->`) для рушія шарової документації (подвійний CRC суть/файл, LLM-генерація верхніх шарів, derived-переклади). Сам рушій живе в [nitra/mt-rust](https://github.com/nitra/mt-rust) і запускається звідти проти цього репозиторію.
+
+## Крейт `mt-protocol` (Rust)
+
+Поряд із `docs/` у цьому репозиторії живе невеликий Rust-крейт **`mt-protocol`** ([`Cargo.toml`](Cargo.toml), [`src/lib.rs`](src/lib.rs)): він вшиває каталог `docs/` у бінарник через [`include_dir`](https://docs.rs/include_dir) й дає доступ до вмісту специфікації без ручного копіювання файлів. Споживається як git-залежність у [nitra/mt-rust](https://github.com/nitra/mt-rust) — крейт наразі **не публікується в crates.io**, лише через `git`-dependency. npm-пакет `@7n/mt` лишається суто docs-only — Rust-файли в його публікований архів не входять.

src/lib.rs

@@ -0,0 +1,46 @@
+//! Специфікація протоколу MT, вбудована в бінарник як Rust-крейт.
+//!
+//! Каталог `docs/` цього репозиторію (`nitra/mt`) вшивається на етапі
+//! компіляції через [`include_dir`], тож споживачі (наприклад,
+//! `nitra/mt-rust`) отримують корпус специфікації без ручного копіювання
+//! чи мережевого доступу під час білду.
+
+use include_dir::{include_dir, Dir};
+
+/// Вшитий у бінарник каталог `docs/` — корпус специфікації протоколу MT.
+pub static DOCS: Dir<'_> = include_dir!("$CARGO_MANIFEST_DIR/docs");
+
+/// Повертає вміст файлу специфікації за відносним шляхом (наприклад,
+/// `"index.md"` або `"architecture/overview.md"`), якщо він існує у
+/// вшитому корпусі `docs/` і є коректним UTF-8.
+pub fn get(path: &str) -> Option<&'static str> {
+    DOCS.get_file(path)?.contents_utf8()
+}
+
+#[cfg(test)]
+mod tests {
+    use super::*;
+
+    #[test]
+    fn index_md_is_present_and_non_empty() {
+        let content = get("index.md").expect("index.md має бути у вшитому docs/ корпусі");
+        assert!(!content.is_empty(), "index.md не має бути порожнім");
+    }
+
+    #[test]
+    fn missing_file_returns_none() {
+        assert!(get("no-such-file.md").is_none());
+    }
+
+    #[test]
+    fn corpus_contains_more_than_a_handful_of_files() {
+        let count = DOCS
+            .find("**/*.md")
+            .expect("glob має бути валідним")
+            .count();
+        assert!(
+            count > 5,
+            "очікували більше 5 md-файлів у docs/, знайдено {count}"
+        );
+    }
+}