v2.0.0 — Claude Code Plugin, Skill Discovery, Interactive Onboarding
What's new in v2
Claude Code Plugin
Oracle is now a first-class Claude Code plugin. Load the repo root as a plugin to get:
- 6 MCP tools via FastMCP:
oracle__analyze_file,oracle__write_test_file,oracle__run_tests,oracle__init_suite,oracle__list_frameworks,oracle__migrate - 3 slash-command skills:
/oracle:generate,/oracle:init,/oracle:migrate - 7 agent definitions:
oracle-test-generator,oracle-initializer,oracle-migrator,oracle-test-author,oracle-test-reviewer,oracle-framework-advisor,oracle-flake-hunter - 4 slash commands wired to the four MVP personas:
/oracle-write-test,/oracle-review-test,/oracle-pick-framework,/oracle-debug-flake
Skill Discovery Convention
Downstream overlay repositories can extend Oracle with zero application code — just .oracle/skills/<name>/SKILL.md directories. Local skills override bundled skills of the same name. Discovery walks from CWD up to the git root.
oracle skills list # show all discoverable skills
oracle skills list --verbose # include file pathsInteractive Guided Onboarding
First-run SetupWizard asks permission before any unconfigured command, guides provider selection, verifies the API key, and optionally runs a sample generation. Re-runnable with oracle setup.
pipx Distribution
pipx install git+https://github.com/bri-stevenski/oracle-test-ai-agent@v2.0.0Package renamed to oracle-test-ai on PyPI. The oracle binary on PATH is unchanged.
Action Fixes
--no-setupflag now correctly placed before the subcommand (oracle --no-setup generate) — fixes empty PR comments on every previous runCommit ledger if changedstep skipped on cross-fork PRs to prevent push-back failures
Other improvements
- Orchestrator scanner isolation:
project_rootthreaded throughrun()so tests scan an isolated temp dir instead of Oracle's own source tree export constregex fix inDomainScanner— dotted TS type annotations (React.FC<Props>,z.ZodObject<...>) now captured correctly- Pre-commit hook auto-refreshes security ledger and runs markdownlint on staged markdown files
Upgrading the GitHub Action
- uses: bri-stevenski/oracle-test-ai-agent@v2or pin to the exact version:
- uses: bri-stevenski/oracle-test-ai-agent@v2.0.0