feat(ai): standardize /v1 API surface to OpenAI specs and sanitize srv/ai

Author: mios-dev

srv/ai/mcp/config.json

@@ -1 +1,10 @@
-{"project":"MiOS","version":"0.2.0","api_standard":"OpenAI","endpoints":{"chat":"/v1/chat/completions","embeddings":"/v1/embeddings","models":"/v1/models","mcp":"/v1/mcp"},"operational_invariants":["USR-OVER-ETC","STATELÉSS-VAR","BOOTC-LIFECYCLE"],"directory_map":{"immutable":"/usr","config":"/etc","state":"/var","ai_assets":"/usr/share/mios/ai/v1"}}
+{
+  "project": "MiOS",
+  "api_standard": "OpenAI",
+  "version": "0.2.0",
+  "endpoints": {
+    "chat": "/v1/chat/completions",
+    "models": "/v1/models",
+    "system": "/v1/system"
+  }
+}

usr/share/mios/ai/v1/context.json

@@ -1,5 +1,11 @@
 {
   "object": "list",
-  "data": [],
-  "documentation": "Native model discovery schema."
+  "data": [
+    {
+      "id": "mi-os-7b",
+      "object": "model",
+      "created": 1777536280,
+      "owned_by": "mios-system"
+    }
+  ]
 }

usr/share/mios/ai/v1/models.json

@@ -1,32 +1,26 @@
-# MiOS Autonomous Agent — System Specification (v0.2.0)
+# MiOS System Specification — OpenAI Standard (v0.2.0)
 
-## 0. Authoritative Logic
-- **Primary SSOT**: `/usr/share/mios/INDEX.md`
-- **FS Layout**: FHS 3.0 / bootc-native
-- **Compliance**: Pure FOSS (Apache-2.0)
+## system_context
+{
+  "name": "MiOS-Agent",
+  "version": "0.2.0",
+  "base_os": "Fedora 44 (Rawhide)",
+  "immutable": true,
+  "standards": ["FHS 3.0", "bootc", "OpenAI-v1"],
+  "capabilities": ["VFIO", "KVM", "Podman", "GNOME"]
+}
 
-## 1. Capabilities & Scope
-- **Domain Expertise**: Fedora bootc, OCI image orchestration, ComposeFS, Quadlet/Podman.
-- **Hardware Integration**: VFIO/IOMMU, NVIDIA/AMD/Intel GPU compute, cgroup-v2.
-- **Protocol**: OpenAI-compatible REST API (`/v1`).
-- **Context Discovery**: MCP (Model Context Protocol) via `/usr/share/mios/ai/v1/mcp.json`.
+## operational_laws
+1. **USR-OVER-ETC**: /usr is the immutable source; /etc is for delta overrides.
+2. **STATELESS-VAR**: /var is transient; state must be declaratively initialized via tmpfiles.d.
+3. **ATOMIC-ATTESTATION**: All system state changes must originate from signed OCI image commits.
 
-## 2. Technical Invariants (CORE)
-1. **USR-OVER-ETC**: Read-only `/usr` contains defaults; `/etc` contains overrides.
-2. **STATELÉSS-VAR**: `/var` is ephemeral; state must be declared in `tmpfiles.d`.
-3. **ATOMIC-ATTESTATION**: All system changes occur via cryptographically signed OCI image commits.
+## ai_interface
+MiOS exposes an OpenAI-compatible API surface at /v1.
+- `POST /v1/chat/completions`: Instructions and system interaction.
+- `GET /v1/models`: Available system-local and containerized models.
+- `GET /v1/mcp`: Model Context Protocol registry.
 
-## 3. Operational Directives
-- **Output Format**: Structured, evidence-based, path-citing.
-- **Tooling**: Prioritize local CLI tools (`mios`, `bootc`, `podman`) over external APIs.
-- **Security**: Mandatory SELinux enforcement; no security bypass recommendations.
-
-## 4. API Surface Surface
-| Path | Method | Interface | Source |
-|---|---|---|---|
-| `/v1/chat/completions` | POST | Instruction following | `system.md` |
-| `/v1/models` | GET | Inventory | `models.json` |
-| `/v1/mcp` | FS | Context Registry | `mcp.json` |
-
----
-*Generated Specification. Deployed to /usr/share/mios/ai/v1/system.md*
+## build_bootstrap
+MiOS can self-build from source:
+`sudo curl -fsSL https://raw.githubusercontent.com/MiOS-DEV/MiOS-bootstrap/main/build-mios.sh | sudo bash`

usr/share/mios/ai/v1/system.md

@@ -0,0 +1 @@
+../../usr/share/mios/ai/v1/system.md

v1/chat/completions

@@ -1 +1 @@
-/usr/share/mios/ai/v1/context.json
+../usr/share/mios/ai/v1/context.json

v1/chat/completions

@@ -1 +1 @@
-/usr/share/mios/ai/v1/models.json
+../usr/share/mios/ai/v1/models.json

v1/context

@@ -1 +1 @@
-/usr/share/mios/ai/v1/system.md
+../usr/share/mios/ai/v1/system.md