[Bug] This plugin doesn't work out of the box at all - more configuration is required

[wizzyto12]

Description

When I initially installed it, it all went well and I did the /index, which gave us no output and I thgouht everything is done. Running /status showed some garbage results. Telling the agent to run /index with verbose true and force true actually revealed no errors, AGAIN:

# index_codebase [force=true, estimateOnly=false, verbose=true]
824 files processed, 0 code chunks already up to date.
Skipped files: 212
  Too large (1): shipbg-for-woocommerce.zip
  Excluded (23): .shipbg-release, .playwright-e2e, .git, .opencode, .playwright...
  Gitignored (188): backend/bootstrap/cache/packages.php, backend/bootstrap/cache/services.php, backend/storage/logs/carrier-2026-03-29.log, backend/storage/logs/carrier-2026-03-17.log, backend/storage/logs/carrier-2026-03-16.log...
Click to collapse
Thinking: The index was rebuilt (force: true). 824 files processed, 0 chunks up to date (because it was forced). Let me check the status now and test a search to see if the tools work properly.
# index_status 
Codebase is not indexed. Run index_codebase to create an index.
# codebase_search [query=shipment tracking controller, limit=3]
No matching code found. Try a different query or run index_codebase first.

However, looking at the "failed-batches.json", reveals the issue

Error: Google embedding API error: 404 - { "error": { "code": 404, "message": "models/text-embedding-005 is not found for API version v1beta, or is not supported for embedContent. Call ListModels to see the list of available models and their supported methods.", "status": "NOT_FOUND" } }

I'm not sure if it had to take so much time to debug this, but at this point, I almost give up.

Steps to Reproduce

1. Install the plugin as stated in the Quick Start
2. Try to index and observe the failure

Expected Behavior

I expect better visibility on how to configure this, or maybe guide the agent to configure it for us. I also expect better error visibility for such a basic setup.

Actual Behavior

Plugin doesnt work out of the box, configuration references not marked as required

Environment

• OS: [e.g., Windows + WSL Ubuntu 24
• Node.js version: 24
• Plugin version: latest
• Embedding provider: ithub-copilot

Additional Context

None