@jetrabbits/agentic 0.3.3 → 0.5.0

package/AGENTS.md

@@ -63,6 +63,14 @@ Cross-cutting practices that apply to every project regardless of area.
 - Apply the `product-owner` role to confirm that docs describe the user-facing behavior, acceptance criteria, and
   operational constraints of the change.
 
+### Versioning And Changelog
+
+- After every completed feature, update the project version in the appropriate version source for the repository.
+- Update `CHANGELOG.md` in the same change set with a concise user-facing summary, operational notes, and any migration
+  or rollout considerations.
+- Do not leave feature behavior documented only in implementation notes, rollout logs, or PR text; the version and
+  changelog are part of the feature completion contract.  
+
 ### MCP Memory Providers
 
 See [MEMORY.md](MEMORY.md) for the full protocol: provider roles, Context7 usage, MemPalace session-start queries,

package/CHANGELOG.md

@@ -1,5 +1,23 @@
 # Changelog
 
+## v0.5.0
+- Fixed skill and rule dependencies within workflows
+
+## v0.4.0
+
+- Fixed OpenCode MCP config generation to use top-level `mcp` entries and migrate/remove legacy `mcpServers` from generated OpenCode configs.
+- Added readable OpenCode menu labels for Telegram notifications and agent model mapping while preserving existing internal ids.
+- Added committed OpenCode model profiles for OpenAI and GitHub Copilot under `extensions/opencode/profiles`.
+- Added OpenCode profile choices to the optional OpenCode menu with manifest persistence and MCP-safe config merging.
+- Renamed generated Docker MCP server entries from `MCP_DOCKER` to `docker`.
+- Added non-fatal local prerequisite warnings for selected Kubernetes and Docker MCP integrations.
+- Removed the macOS bash 3.2 warning and added compatibility handling for older bash empty-array behavior.
+- Extended deterministic e2e coverage for all-MCP doctor setup, OpenCode MCP migration, OpenCode profiles, readable menu labels, and bash 3 compatibility.
+
+## v0.3.4
+
+- Enabled Codex project memories by generating `.codex/config.toml` with `[features] memories = true` whenever Codex is selected.
+
 ## v0.3.3
 
 - Updated MemPalace project initialization to pipe explicit confirmation (`echo "Y" | mempalace init ...`) for non-interactive setup robustness.

package/Makefile

@@ -1,4 +1,4 @@
-.PHONY: help install dev test test-all test-cli test-tui test-cross test-doctor test-markers test-opencode-plugins test-telegram-plugin test-ubuntu-blackbox test-real-agent-doctor test-real-blackbox test-real-blackbox-codex test-real-blackbox-opencode test-real-blackbox-telegram test-real-opencode-mapper test-coverage _test-coverage-steps lint fmt clean build assess-areas
+.PHONY: help install dev test test-all test-cli test-tui test-mcp test-cross test-doctor test-markers test-opencode-plugins test-telegram-plugin test-ubuntu-blackbox test-real-agent-doctor test-real-blackbox test-real-blackbox-codex test-real-blackbox-opencode test-real-blackbox-telegram test-real-opencode-mapper test-coverage _test-coverage-steps check-no-pycache lint fmt clean build sync-diagrams assess-areas
 
 define timed_step
 	@label='$(1)'; \
@@ -27,6 +27,7 @@ help:
 		"  test-all      Run fast tests, real blackbox, and coverage" \
 		"  test-cli      Run CLI end-to-end tests" \
 		"  test-tui      Run TUI end-to-end tests" \
+		"  test-mcp      Run MCP selection/config end-to-end tests" \
 		"  test-cross    Run cross-mode end-to-end tests" \
 		"  test-doctor   Run deterministic doctor end-to-end tests" \
 		"  test-markers  Run generated marker and idempotency tests" \
@@ -40,10 +41,12 @@ help:
 		"  test-real-blackbox-telegram  Run real OpenCode Telegram blackbox test" \
 		"  test-real-opencode-mapper  Run real OpenCode mapper input blackbox" \
 		"  test-coverage  Run traced e2e coverage for agentic" \
+		"  check-no-pycache  Fail if Python bytecode/cache artifacts are present" \
 		"  lint          Run prompt and catalog validation" \
 		"  fmt           Check formatting hooks placeholder" \
 		"  clean         Remove generated reports" \
 		"  build         Build generated docs catalog" \
+		"  sync-diagrams Generate workflow agent interaction diagrams" \
 		"  assess-areas  Generate area quality scorecards"
 
 install:
@@ -55,6 +58,7 @@ dev:
 test:
 	$(call timed_step,test-cli,bash tests/e2e/cli.e2e.sh)
 	$(call timed_step,test-tui,bash tests/e2e/tui.e2e.sh)
+	$(call timed_step,test-mcp,bash tests/e2e/mcp.e2e.sh)
 	$(call timed_step,test-cross,bash tests/e2e/cross.e2e.sh)
 	$(call timed_step,test-opencode-plugins,bash tests/e2e/opencode_plugins.e2e.sh)
 	$(call timed_step,test-telegram-plugin,bash tests/e2e/telegram_plugin.e2e.sh)
@@ -75,6 +79,9 @@ test-cli:
 test-tui:
 	$(call timed_step,test-tui,bash tests/e2e/tui.e2e.sh)
 
+test-mcp:
+	$(call timed_step,test-mcp,bash tests/e2e/mcp.e2e.sh)
+
 test-cross:
 	$(call timed_step,test-cross,bash tests/e2e/cross.e2e.sh)
 
@@ -131,11 +138,21 @@ _test-coverage-steps:
 	$(call timed_step,test-coverage-doctor,AGENTIC_COVERAGE_TRACE_FILE="$(AGENTIC_COVERAGE_TRACE_FILE)" AGENTIC_TEST_CLI="$(CURDIR)/tests/e2e/coverage_shim.sh" bash tests/e2e/doctor.e2e.sh >/tmp/agentic-coverage-doctor.log 2>&1)
 	$(call timed_step,test-coverage-parse,bash tests/e2e/coverage_parse.sh "$(AGENTIC_COVERAGE_TRACE_FILE)")
 
+check-no-pycache:
+	@found="$$(find . -name .git -prune -o \( -type d -name __pycache__ -o -type f \( -name '*.pyc' -o -name '*.pyo' -o -name '*.pyd' \) \) -print)"; \
+	if [ -n "$$found" ]; then \
+	  printf '%s\n' "Python bytecode/cache artifacts are not allowed:"; \
+	  printf '%s\n' "$$found"; \
+	  exit 1; \
+	fi
+
 lint:
 	bash -n agentic
-	python3 -m py_compile scripts/build_docs_catalog.py scripts/lint_prompts.py scripts/assess_area_quality.py
-	python3 scripts/lint_prompts.py --strict
-	python3 scripts/build_docs_catalog.py --validate --output /tmp/agentic-catalog-check.json
+	PYTHONPYCACHEPREFIX=/tmp/agentic-pycache-check python3 -m py_compile scripts/build_docs_catalog.py scripts/lint_prompts.py scripts/assess_area_quality.py scripts/sync_workflow_diagrams.py
+	PYTHONDONTWRITEBYTECODE=1 python3 scripts/lint_prompts.py --strict
+	PYTHONDONTWRITEBYTECODE=1 python3 scripts/sync_workflow_diagrams.py --check
+	PYTHONDONTWRITEBYTECODE=1 python3 scripts/build_docs_catalog.py --validate --output /tmp/agentic-catalog-check.json
+	$(MAKE) check-no-pycache
 
 fmt:
 	@printf '%s\n' "No formatter configured."
@@ -144,7 +161,11 @@ clean:
 	rm -f reports/area-quality.json reports/area-quality.md
 
 build:
-	python3 scripts/build_docs_catalog.py --output docs/site/catalog.json --validate
+	PYTHONDONTWRITEBYTECODE=1 python3 scripts/sync_workflow_diagrams.py --check
+	PYTHONDONTWRITEBYTECODE=1 python3 scripts/build_docs_catalog.py --output docs/site/catalog.json --validate
+
+sync-diagrams:
+	python3 scripts/sync_workflow_diagrams.py
 
 assess-areas:
 	python3 scripts/assess_area_quality.py --json-output reports/area-quality.json --markdown-output reports/area-quality.md

package/README.md

@@ -194,15 +194,34 @@ project/.agent/
 
 ### MCP
 
-- `context7`: adds a remote MCP server for up-to-date framework, library, SDK, and API documentation.
-- `mempalace`: adds a local memory MCP server for project context discovery and reuse.
+- `opencode-docs` (safe): adds OpenCode documentation through a local MCP server.
+- `playwright` (sensitive): adds browser automation through Playwright MCP.
+- `kubernetes` (dangerous): adds Kubernetes cluster access through Kubernetes MCP.
+- `youtube-transcript` (safe): adds YouTube transcript lookup through a local MCP server.
+- `docker-mcp` (dangerous): adds Docker MCP Gateway as the generated `docker` MCP server.
+- `context7` (safe): adds a remote MCP server for up-to-date framework, library, SDK, and API documentation.
+- `mempalace` (sensitive): adds a local memory MCP server for project context discovery and reuse.
+- `anydb` (dangerous): adds database access through AnyDB MCP.
 
 ### OpenCode Plugins
 
-- `telegram-opencode-notifier`: sends Telegram notifications when an OpenCode session becomes idle, including the final
-  response or an attachment for long output.
-- `agent-model-mapper`: maps `.opencode/agents/*.md` roles to main and fallback OpenCode models during interactive
-  `agentic install`/`agentic tui`. OpenCode startup never prompts or writes project files.
+- `Telegram Notifications`: sends Telegram notifications when an OpenCode session becomes idle, including the final
+  response or an attachment for long output. Stored internally as `telegram-notification`.
+- `Agent Model Mapping`: maps `.opencode/agents/*.md` roles to main and fallback OpenCode models during interactive
+  `agentic install`/`agentic tui`. Stored internally as `agent-model-mapper`; OpenCode startup never prompts or writes
+  project files.
+
+### OpenCode Model Profiles
+
+- `OpenAI Model Profile`: applies the bundled OpenAI model mapping from `extensions/opencode/profiles/openai/`.
+- `GitHub Copilot Model Profile`: applies the bundled GitHub Copilot model mapping from
+  `extensions/opencode/profiles/githubcopilot/`.
+- User profiles: place `opencode.json` files under `$HOME/.config/agentic/opencode/profiles/<profile-id>/`. For
+  example, `$HOME/.config/agentic/opencode/profiles/DT/opencode.json` appears in the optional OpenCode plugin menu as
+  `DT profile`, and `$HOME/.config/agentic/opencode/profiles/GH/opencode.json` appears as `GH profile`.
+- `none`: applies no model profile and does not copy the baseline `extensions/opencode/opencode.json` just for profile
+  selection. OpenCode MCPs, Telegram notifications, and model mapping may still create or update `.opencode/opencode.json`
+  when those options are selected.
 
 ---