Skip to content

v2.0.0 — Claude Code Plugin, Skill Discovery, Interactive Onboarding

Choose a tag to compare

@bri-stevenski bri-stevenski released this 20 May 20:23
· 189 commits to main since this release
a974dbc

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 paths

Interactive 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.0

Package renamed to oracle-test-ai on PyPI. The oracle binary on PATH is unchanged.

Action Fixes

  • --no-setup flag now correctly placed before the subcommand (oracle --no-setup generate) — fixes empty PR comments on every previous run
  • Commit ledger if changed step skipped on cross-fork PRs to prevent push-back failures

Other improvements

  • Orchestrator scanner isolation: project_root threaded through run() so tests scan an isolated temp dir instead of Oracle's own source tree
  • export const regex fix in DomainScanner — 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@v2

or pin to the exact version:

- uses: bri-stevenski/oracle-test-ai-agent@v2.0.0