chore: simplify plugin readmes, changelogs and manifest descriptions

plugins/ai/CHANGELOG.md

@@ -2,4 +2,6 @@
 
 ## 1.0.0
 
-Bundled with Termix 2.9.0.
+First release, bundled with Termix 2.9.0.
+
+Adds an AI assistant that can read your hosts, snippets, fleets, alerts and automations and suggest changes for you to approve. Works with Ollama, Anthropic, OpenAI, Google Gemini and any OpenAI compatible provider.

plugins/ai/README.md

@@ -1,22 +1,52 @@
 # AI Assistant
 
-An AI assistant that can read your hosts, snippets, fleets, alerts and automations, and propose changes for you to approve.
+An AI assistant that can read your hosts, snippets, fleets, alerts and automations, and suggest changes for you to approve.
 
-Bundled with Termix and enabled by default.
+## Features
 
-## Layout
+- Chat with an assistant that can read your hosts, snippets, fleets, alerts, automations, workspaces, network graph and homepage.
+- The assistant suggests changes, and nothing is applied until you approve it.
+- Can run read-only diagnostic commands on a host if you allow it.
+- Open the assistant from the terminal toolbar with the current session as context.
+- Works with Ollama, Anthropic, OpenAI, Google Gemini and any OpenAI compatible provider.
 
-    manifest.json        id, capabilities and what this plugin contributes
-    src/backend/         activate(ctx) / deactivate(), plus the routes
-    src/frontend/        the UI it registers
-    locales/en.json      its strings (English only; the rest are translated)
-    tests/backend/       vitest, node
-    tests/frontend/      vitest, jsdom
+## Settings
 
-## Commands
+### Admin
 
-    npm run build     bundle into dist/
-    npm run test      run this plugin's tests
-    npm run typecheck
+- AI assistant: let users turn the assistant on. While this is off it is hidden for everyone.
+- Allowed private AI hosts: hosts on your private network a provider may point at, such as a self-hosted Ollama.
 
-See packages/plugin-sdk/ARCHITECTURE.md for the contract this follows.
+### User
+
+- Enable the AI assistant: turn the assistant on for yourself.
+- Allow read-only diagnostic commands: let the assistant run safe commands on your hosts.
+- Providers: the AI providers, models and API keys you use.
+
+### Host
+
+- Enable AI Assistant: allow the assistant to work with this host.
+
+## Permissions
+
+- `ai.use`: Open the assistant and ask it things. Admins and users have it by default.
+- `ai.manage_providers`: Add, edit and remove AI providers and their API keys. Admins and users have it by default.
+- `ai.apply_proposals`: Let the assistant carry out the changes it suggests. Admins and users have it by default.
+- `ai.services.use`: Let other features call the assistant for you. Admins and users have it by default.
+- `ai.secrets.share`: Let other features use the stored AI API key without seeing it. Admins and users have it by default.
+
+## Services
+
+Uses from other plugins:
+
+- `workspaces.saved`, `network-topology.graph`, `snippets.access`, `fleets.access`, `terminal.history`, `automations.access` and `homepage.items` to read your data. Each one is optional.
+
+## Development
+
+```bash
+npm run build      # build into dist/
+npm run test       # run this plugin's tests
+npm run typecheck  # type-check this plugin
+```
+
+See `packages/plugin-sdk/ARCHITECTURE.md` for the plugin contract.

plugins/ai/manifest.json

@@ -2,7 +2,7 @@
   "id": "ai",
   "name": "AI Assistant",
   "version": "1.0.0",
-  "description": "An AI assistant that can read your hosts, snippets, fleets, alerts and automations, and propose changes for you to approve.",
+  "description": "An AI assistant that can read your hosts, snippets, fleets, alerts and automations, and suggest changes for you to approve.",
   "author": {
     "name": "Termix"
   },