@jetrabbits/agentic 0.0.5 → 0.2.0

package/docs/agentic-lifecycle.md

@@ -101,3 +101,14 @@ When `.agentic.json` exists in the target project, `agentic install` treats the
 - skipped paths are recorded in `.agentic.json`.
 
 Every copied or generated file carries an internal marker. Markdown uses YAML front matter, comment-capable formats use comments, and JSON uses an `_agentic` object.
+
+## MemPalace install and validation logs
+
+When MemPalace MCP is enabled during interactive install, `agentic` now reports setup progress in explicit steps so users can see what succeeded or failed:
+
+1. Python availability check
+2. pip availability check
+3. `pip install mempalace`
+4. Project initialization (`mempalace init` and `mempalace mine`)
+
+After setup, install checks that `mempalace-mcp` is present and leaves runtime startup/tool validation to the post-install doctor smoke check. Generated MCP configs invoke `mempalace-mcp` without arguments for all supported agent targets.

package/docs/agentic-token-minimization/README.md

@@ -51,6 +51,8 @@ OPENCODE_TELEGRAM_CHAT_ID
 - `.mcp.json` for Claude Code project-scoped MCP servers
 - `.cursor/mcp.json`
 - `.gemini/settings.json`
+- `.kilocode/mcp.json` for `kilocode`
+- `~/.gemini/antigravity/mcp_config.json` for `antigravity` (global user config)
 
 Interactive installs ask whether to enable Context7. If enabled, the Context7 API key is optional. Empty keys keep the install usable with default Context7 limits or rule-only fallback behavior. Non-interactive installs enable Context7 only when `CONTEXT7_API_KEY` is already set. Generated guidance requires agents to use Context7 for framework, SDK, library, and API documentation before relying on model memory when the project config is present.
 

package/docs/agentic-usage.md

@@ -30,6 +30,23 @@ Default behavior:
 - In non-interactive mode (CI/pipe): prints usage and exits with code `1`
 - For CI one-off execution, prefer `npx @jetrabbits/agentic@latest <command>`
 
+## Requirements
+
+`agentic install` and `agentic tui` fail fast when required local tools are missing:
+
+- Bash 3.2+.
+- Python 3 as `python3`.
+- pip as `pip3`, `pip`, or `python3 -m pip`.
+- `shasum` or `sha256sum` for managed-file hashes.
+- Git when installed mode needs to bootstrap or upgrade `~/.local/share/agentic/repo`.
+
+Optional tools:
+
+- `fzf` for interactive picker UI; index-based menus are used when it is unavailable.
+- Node.js/npm only for the `npx @jetrabbits/agentic@latest` entrypoint.
+- `curl` only for the bootstrap installer.
+- Real agent binaries only for selected target recommendations and doctor checks.
+
 Install the standalone binary:
 
 ```bash
@@ -73,7 +90,27 @@ 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.
+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 the project files are generated, `agentic` starts timestamped operational logging and mirrors install output to a temporary log file such as:
+
+```text
+/tmp/agentic-20260512-114203.ABC123
+```
+
+The final install line prints the exact path:
+
+```text
+Agentic log file: /tmp/agentic-20260512-114203.ABC123
+```
+
+`agentic` also runs a final doctor smoke check for selected real agent targets (`codex`, `opencode`, `claude`, `gemini`). The doctor runs `/develop-feature напиши hello world python` in a temporary copy of the project and prints one status row per selected agent. Doctor failures are reported but do not roll back or fail the install. Disable doctor for CI or cheap checks with:
+
+```bash
+AGENTIC_DOCTOR=0 agentic install ...
+# or
+agentic install ... --no-doctor
+```
 
 List available options:
 
@@ -136,10 +173,30 @@ Non-interactive installs create a disabled config when no config exists. Telegra
 
 ## Context7
 
-For `opencode` and `codex`, interactive installs ask whether to add project-level Context7 MCP configuration. If enabled, the Context7 API key prompt is optional; leave it empty to configure Context7 without a key.
+For `opencode`, `codex`, `claude`, `cursor`, `gemini`, `kilocode`, and `antigravity`, interactive installs ask whether to add Context7 MCP configuration. If enabled, the Context7 API key prompt is optional; leave it empty to configure Context7 without a key. Most targets use project-level files, while `antigravity` is written to the global user path `~/.gemini/antigravity/mcp_config.json`.
 
 Non-interactive installs skip Context7 unless `CONTEXT7_API_KEY` is set in the environment. Agents are instructed to use Context7 for framework, library, SDK, API, and setup documentation when the project config is present.
 
+## MemPalace
+
+For `opencode`, `codex`, `claude`, `cursor`, `gemini`, and `antigravity`, MemPalace MCP is configured as a local Python module instead of a hosted MCP URL. Install it first:
+
+```bash
+pip install mempalace
+```
+
+Generated configs run `mempalace-mcp` without arguments for all supported agent targets. Runtime startup and MCP tool errors are checked by the post-install doctor stage.
+
+During install, if MemPalace is enabled, `agentic` checks whether `mempalace-mcp` is available. For OpenCode installs, `agentic` creates `<project>` and runs `mempalace init "<project>" --yes --auto-mine`. If checks fail (for example, package not installed yet), install continues and agents fall back to standard context discovery.
+
+## Real agent doctor E2E
+
+The deterministic e2e suite uses fake agent binaries and does not call models. Real agent doctor checks are opt-in because they may use network access, credentials, and model credits:
+
+```bash
+AGENTIC_RUN_REAL_AGENT_E2E=1 make test-real-agent-doctor
+```
+
 ## Deprecated wrapper
 
 `agentos-install.sh` remains for backward compatibility and forwards to `agentic`. Prefer `agentic` in new usage and documentation.

package/docs/opencode_setup.md

@@ -43,3 +43,6 @@ OPENCODE_TELEGRAM_CHAT_ID
 ```
 
 Non-interactive `agentic install` defaults optional plugins to disabled when no config exists.
+
+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/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@jetrabbits/agentic",
-  "version": "0.0.5",
+  "version": "0.2.0",
   "description": "Agent Intelligence Configuration CLI",
   "bin": {
     "agentic": "bin/agentic.js"
@@ -11,6 +11,7 @@
   },
   "files": [
     "AGENTS.md",
+    "CHANGELOG.md",
     "UPGRADE.md",
     "LICENSE",
     "Makefile",