@jetrabbits/agentic 0.3.3 → 0.4.0

package/docs/agentic-usage.md

@@ -90,7 +90,16 @@ agentic install \
   --specializations software.general,software.backend
 ```
 
-After install, `agentic` writes `.agentic.json` in the target project. It records copied/generated files and their hashes. A later install rerun updates only manifest-managed files and skips files changed by the user. Generated guidance is written to root `AGENTS.md` for most agents and to `.opencode/AGENTS.md` when OpenCode is selected; multi-target installs that include OpenCode and another agent write both files.
+After install, `agentic` writes `.agentic.json` in the target project. It records copied/generated files and their hashes. A later install rerun updates only manifest-managed files and skips files changed by the user. Generated guidance is always written to root `AGENTS.md`; when OpenCode is selected, `agentic` also writes `.opencode/AGENTS.md`.
+
+When Codex is selected, `agentic` creates or updates the project-local `.codex/config.toml` with Codex memories enabled:
+
+```toml
+[features]
+memories = true
+```
+
+This config file follows the same manifest-managed safeguards as other generated project files.
 
 After the project files are generated, `agentic` starts timestamped operational logging and mirrors install output to a temporary log file such as:
 
@@ -137,6 +146,8 @@ TUI uses `fzf` for interactive selection. If `fzf` is missing, `agentic` can:
 
 `--install-fzf` only affects `self-install`. If auto-install fails, self-install still completes.
 
+The CLI supports the system bash 3.2 shipped with macOS and does not require installing a newer bash.
+
 Manual install examples:
 
 Linux:
@@ -163,7 +174,7 @@ scoop install fzf
 
 ## OpenCode optional plugins
 
-When `opencode` is selected, interactive installs ask whether to enable Telegram notifications and `agent-model-mapper`. The answer is stored globally in:
+When `opencode` is selected, interactive installs ask whether to enable `Telegram Notifications` and `Agent Model Mapping`. These are readable menu labels for the stable internal ids `telegram-notification` and `agent-model-mapper`. The answer is stored globally in:
 
 ```text
 ~/.config/agentic/opencode-plugins.json
@@ -171,6 +182,12 @@ When `opencode` is selected, interactive installs ask whether to enable Telegram
 
 Non-interactive installs create a disabled config when no config exists. Interactive installs ask for Telegram `botToken` and `chatId` when `telegram-notification` is selected. Those credentials are written to the target project `.agentic.json` under `settings.opencode_plugins.telegram`, not to `~/.config/agentic/opencode-plugins.json`. Treat `.agentic.json` as plaintext secret-bearing project config when Telegram is enabled and do not commit it to public repositories. When enabled, `agent-model-mapper` runs during interactive `agentic install`/`agentic tui`, uses `fzf` as a dropdown picker when available, and writes `.opencode/opencode.json` only after a Confirm action. OpenCode startup does not load a mapper runtime plugin or prompt for model mapping.
 
+OpenCode model profiles are stored in `extensions/opencode/profiles` and appear in the same optional OpenCode selection menu as the plugin choices. The built-in choices are `OpenAI Model Profile` and `GitHub Copilot Model Profile`; non-interactive installs can choose them with `AGENTIC_OPENCODE_PROFILE=openai` or `AGENTIC_OPENCODE_PROFILE=githubcopilot`. Profile selection merges agent model mappings into `.opencode/opencode.json`, then MCP configuration is merged afterward.
+
+OpenCode MCP config uses top-level `mcp`, not `mcpServers`. Agentic migrates legacy OpenCode `mcpServers` entries into `mcp` during install. Codex continues to use `.codex/config.toml` with `[mcp_servers.*]` sections.
+
+For selected Kubernetes and Docker MCP integrations, `agentic` performs non-fatal local checks after config generation: `kubectl version` for Kubernetes and `docker mcp --version` for Docker MCP. Failed checks appear as warnings in the final install report with official setup links. Docker MCP server entries are generated under the server name `docker`.
+
 ## Context7
 
 For `opencode`, `codex`, `claude`, `cursor`, `gemini`, `kilocode`, and `antigravity`, interactive installs ask whether to add Context7 MCP configuration. If enabled, a follow-up menu chooses either keyless mode or entering `CONTEXT7_API_KEY`. The selected key is written to all selected target configs for the current project. Most targets use project-level files, while `antigravity` is written to the global user path `~/.gemini/antigravity/mcp_config.json`.

package/docs/mcp/README.md

@@ -0,0 +1,28 @@
+# Agentic MCP server selection
+
+`agentic tui` includes a dedicated `Select MCP servers to enable:` step after target agent platform selection. The fzf flow supports multi-select with Space or Tab, Enter to confirm, Esc to skip, and a `None / skip` entry for users who do not want MCP configuration generated for the current install.
+
+The MCP menu is driven by the CLI MCP registry rather than hardcoded UI rows. The registry tracks each server's id, display title, description, security level, default disabled state, and generated config block.
+
+Supported registry ids:
+
+| id | Description | Security |
+| --- | --- | --- |
+| `opencode-docs` | OpenCode docs MCP | safe |
+| `playwright` | Browser automation via Playwright MCP | sensitive |
+| `kubernetes` | Kubernetes pods/logs/exec management | dangerous |
+| `youtube-transcript` | YouTube transcript extraction | safe |
+| `docker-mcp` | Docker MCP Gateway | dangerous |
+| `context7` | Fresh library documentation | safe |
+| `mempalace` | Persistent project memory | sensitive |
+| `anydb` | Database access MCP | dangerous |
+
+For non-interactive installs, set `AGENTIC_ENABLE_MCPS` to a comma-separated list of registry ids. Dangerous MCPs require explicit confirmation before config is written. In non-interactive installs, set `AGENTIC_CONFIRM_DANGEROUS_MCP=1` to enable selected dangerous MCPs; otherwise agentic skips them and reports a warning.
+
+OpenCode config generation writes current OpenCode-compatible top-level `mcp` entries, not legacy `mcpServers`. Re-running agentic preserves existing unknown fields, preserves an existing `$schema`, updates only the selected MCP entries, and migrates any existing OpenCode `mcpServers` entries into `mcp` before removing the invalid legacy key.
+
+Codex config generation remains TOML-based and writes `[mcp_servers.<name>]` sections in `.codex/config.toml`.
+
+When `kubernetes` is selected, `agentic` checks whether `kubectl version` succeeds. If it does not, install continues and the final report warns with the official kubectl setup guide: <https://kubernetes.io/docs/tasks/tools/>.
+
+When `docker-mcp` is selected, generated MCP server names use `docker` instead of the older `MCP_DOCKER`. `agentic` checks whether `docker mcp --version` succeeds. If it does not, install continues and the final report warns with Docker setup links: <https://docs.docker.com/get-started/get-docker/> and <https://docs.docker.com/ai/mcp-catalog-and-toolkit/>.

package/docs/opencode_setup.md

@@ -33,7 +33,7 @@ When `agentic` installs the OpenCode extension, it configures optional plugins i
 ~/.config/agentic/opencode-plugins.json
 ```
 
-Telegram notifications and agent model mapping are opt-in. Interactive `agentic install` and `agentic tui` ask for OpenCode plugin selection whenever `opencode` is selected; the answer rewrites this config. During manifest-based upgrade/re-install sync, existing plugin settings are kept so automated refreshes do not open prompts. If the config is absent or a plugin is disabled, the plugin returns no hooks and OpenCode continues without that behavior.
+Telegram notifications and agent model mapping are opt-in. Interactive `agentic install` and `agentic tui` ask for OpenCode plugin selection whenever `opencode` is selected. The menu uses readable labels (`Telegram Notifications` and `Agent Model Mapping`) while keeping the stored internal ids `telegram-notification` and `agent-model-mapper`. The answer rewrites this config. During manifest-based upgrade/re-install sync, existing plugin settings are kept so automated refreshes do not open prompts. If the config is absent or a plugin is disabled, the plugin returns no hooks and OpenCode continues without that behavior.
 
 When `telegram-notification` is selected interactively, `agentic` asks for `botToken` and `chatId` and stores them in the target project's `.agentic.json`:
 
@@ -48,5 +48,15 @@ Non-interactive `agentic install` defaults optional plugins to disabled when no
 
 `agent-model-mapper` reads roles from target `.opencode/agents/*.md` and discovers model names from `~/.config/opencode/opencode.json`, then adds models from active providers in `~/.local/share/opencode/auth.json` using non-deprecated entries in `~/.cache/opencode/models.json`. When enabled, interactive `agentic install`/`agentic tui` prompts for a main and fallback model per role, using `fzf` as a dropdown picker when available, and writes `.opencode/opencode.json` only after a Confirm action. OpenCode startup never opens `fzf` or waits for model input because no mapper runtime plugin is shipped or registered.
 
+Agentic also ships reusable OpenCode model profiles in:
+
+```text
+extensions/opencode/profiles/
+```
+
+The current profiles are `OpenAI Model Profile` (`openai/opencode.json`) and `GitHub Copilot Model Profile` (`githubcopilot/opencode.json`). They appear in the same optional OpenCode selection menu as the plugin choices. Selecting one merges its agent model mapping into `.opencode/opencode.json`; later MCP configuration is merged on top, so profile selection does not block future MCP sections.
+
+For MCP servers, OpenCode uses top-level `mcp` entries. Agentic migrates legacy `mcpServers` in OpenCode configs to `mcp` and removes the invalid key.
+
 For OpenCode targets, `agentic` writes generated operating guidance to `.opencode/AGENTS.md`. If OpenCode is installed
 alongside another agent target, root `AGENTS.md` is generated as well for the non-OpenCode target.

package/extensions/opencode/profiles/githubcopilot/opencode.json

@@ -0,0 +1,88 @@
+{
+  "$schema": "https://opencode.ai/config.json",
+  "plugin": [
+    "sound-notification",
+    "telegram-notification"
+  ],
+  "agent": {
+    "product-owner": {
+      "description": "Main coordinator for feature development workflow",
+      "mode": "primary",
+      "model": "github-copilot/gpt-5.5",
+      "fallback": [],
+      "permission": {
+        "task": {
+          "pm": "allow",
+          "team-lead": "allow",
+          "designer": "allow",
+          "developer": "allow",
+          "qa": "allow",
+          "instruction_reviewer": "allow",
+          "memory_curator": "allow"
+        }
+      }
+    },
+    "pm": {
+      "description": "Project Manager - coordinates workflow",
+      "mode": "subagent",
+      "model": "github-copilot/gpt-5.3-codex",
+      "fallback": [],
+      "permission": {
+        "task": {
+          "team-lead": "allow",
+          "designer": "allow",
+          "developer": "allow",
+          "qa": "allow"
+        }
+      }
+    },
+    "team-lead": {
+      "description": "Team Lead - planning and code review",
+      "mode": "all",
+      "model": "github-copilot/claude-opus-4.7",
+      "fallback": [],
+      "permission": {
+        "task": {
+          "developer": "allow",
+          "qa": "allow"
+        }
+      }
+    },
+    "developer": {
+      "description": "Developer - implements code",
+      "mode": "all",
+      "model": "github-copilot/gpt-5.3-codex",
+      "fallback": []
+    },
+    "devops-engineer": {
+      "description": "DevOps Engineer - infrastructure, CI/CD, and platform reliability",
+      "mode": "all",
+      "model": "github-copilot/claude-sonnet-4.6",
+      "fallback": []
+    },
+    "instruction_reviewer": {
+      "description": "Instruction Reviewer - post-task review of instruction effectiveness and tool discipline",
+      "mode": "all",
+      "model": "github-copilot/claude-sonnet-4.6",
+      "fallback": []
+    },
+    "memory_curator": {
+      "description": "Memory Curator - post-task memory hygiene recommendations without automatic writes",
+      "mode": "all",
+      "model": "github-copilot/gpt-5-mini",
+      "fallback": []
+    },
+    "qa": {
+      "description": "QA Engineer - runs tests",
+      "mode": "subagent",
+      "model": "github-copilot/gpt-5.3-codex",
+      "fallback": []
+    },
+    "designer": {
+      "description": "Designer - UI/UX validation",
+      "mode": "subagent",
+      "model": "github-copilot/gemini-3.5-flash",
+      "fallback": []
+    }
+  }
+}

package/extensions/opencode/profiles/openai/opencode.json

@@ -0,0 +1,100 @@
+{
+  "$schema": "https://opencode.ai/config.json",
+  "plugin": [
+    "sound-notification",
+    "telegram-notification"
+  ],
+  "agent": {
+    "product-owner": {
+      "description": "Main coordinator for feature development workflow",
+      "mode": "primary",
+      "model": "openai/gpt-5.5",
+      "fallback": [],
+      "permission": {
+        "task": {
+          "pm": "allow",
+          "team-lead": "allow",
+          "designer": "allow",
+          "developer": "allow",
+          "qa": "allow",
+          "instruction_reviewer": "allow",
+          "memory_curator": "allow"
+        }
+      }
+    },
+    "pm": {
+      "description": "Project Manager - coordinates workflow",
+      "mode": "subagent",
+      "model": "openai/gpt-5.5",
+      "fallback": [],
+      "permission": {
+        "task": {
+          "team-lead": "allow",
+          "designer": "allow",
+          "developer": "allow",
+          "qa": "allow"
+        }
+      }
+    },
+    "team-lead": {
+      "description": "Team Lead - planning and code review",
+      "mode": "all",
+      "model": "openai/gpt-5.5",
+      "fallback": [],
+      "permission": {
+        "task": {
+          "developer": "allow",
+          "qa": "allow"
+        }
+      }
+    },
+    "developer": {
+      "description": "Developer - implements code",
+      "mode": "all",
+      "model": "openai/gpt-5.5",
+      "fallback": []
+    },
+    "devops-engineer": {
+      "description": "DevOps Engineer - infrastructure, CI/CD, and platform reliability",
+      "mode": "all",
+      "model": "openai/gpt-5.5",
+      "fallback": []
+    },
+    "instruction_reviewer": {
+      "description": "Instruction Reviewer - post-task review of instruction effectiveness and tool discipline",
+      "mode": "all",
+      "model": "openai/gpt-5.5",
+      "fallback": []
+    },
+    "memory_curator": {
+      "description": "Memory Curator - post-task memory hygiene recommendations without automatic writes",
+      "mode": "all",
+      "model": "openai/gpt-5.5",
+      "fallback": []
+    },
+    "qa": {
+      "description": "QA Engineer - runs tests",
+      "mode": "subagent",
+      "model": "openai/gpt-5.5",
+      "fallback": []
+    },
+    "designer": {
+      "description": "Designer - UI/UX validation",
+      "mode": "subagent",
+      "model": "openai/gpt-5.5",
+      "fallback": []
+    },
+    "plan": {
+      "description": "Planning mode",
+      "mode": "primary",
+      "model": "openai/gpt-5.5",
+      "fallback": []
+    },
+    "build": {
+      "description": "Build mode",
+      "mode": "primary",
+      "model": "openai/gpt-5.5",
+      "fallback": []
+    }
+  }
+}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@jetrabbits/agentic",
-  "version": "0.3.3",
+  "version": "0.4.0",
   "description": "Agent Intelligence Configuration CLI",
   "bin": {
     "agentic": "bin/agentic.js"