Skip to content

docs(release): v0.0.14 sync — Gemini priority + 10 new features documented#100

Merged
edgarriba merged 2 commits into
mainfrom
docs/gemini-priority
May 19, 2026
Merged

docs(release): v0.0.14 sync — Gemini priority + 10 new features documented#100
edgarriba merged 2 commits into
mainfrom
docs/gemini-priority

Conversation

@edgarriba

@edgarriba edgarriba commented May 19, 2026

Copy link
Copy Markdown
Member

Summary

Comprehensive doc sync ahead of the v0.0.14 release. A team of 4 audit agents reviewed user-facing, dashboard, reference/concepts, and MCP/root docs against the 10 commits shipped since v0.0.13. This PR fixes every load-bearing issue they flagged.

Headline changes

CHANGELOG.md — was 6 versions behind (stuck at v0.0.7). Now backfills v0.0.8 → v0.0.13 with summaries and adds a full v0.0.14 section covering:

Gemini as default — across README, agent-guide, quickstart, configuration, and CLI reference. Matches the actual code behaviour (runtime.rs:120 defaults provider to "gemini"; bubbaloop agent setup already recommends Gemini first).

Tool count: 42 → 47 — fixed in CLAUDE.md, ARCHITECTURE.md (3 places), ROADMAP.md (3 places), README.md.

Concept docs — memory.md "3-tier" → "4-tier"; topics.md/messaging.md/architecture.md add the cancel topic + Chat tab HTTP+SSE alternative; wire-format.md notes that grab_frame queryable replies are raw JPEG + JSON attachment (not the CBOR envelope).

New filedocs/dashboard/chat.md documents the Chat tab end-to-end.

Other fixes — CONTRIBUTING.md test count 298+ → 2400+; INSTALL.md prefers bubbaloop mcp --token; cli.md adds missing env vars (BUBBALOOP_MCP_TOKEN, BUBBALOOP_MCP_MODE, BUBBALOOP_MCP_TOOLSETS, OLLAMA_HOST).

Files touched

18 files modified, 1 new file (docs/dashboard/chat.md).

Test plan

  • bubbaloop agent setup --help already prefers Gemini (verified in cli/agent_setup.rs)
  • bubbaloop login --status shows Gemini and Claude (verified in cli/login.rs)
  • Tool counts verified against mcp/tools.rs (47 #[tool] handlers)
  • Provider default verified against agent/runtime.rs:120
  • Cancel topic verified against agent/gateway.rs
  • CI green on this branch

🤖 Generated with Claude Code

Updates README, agent-guide, quickstart, configuration, and CLI docs
to match the actual CLI behaviour (`bubbaloop agent setup` already
recommends Gemini first as the free-tier, vision-capable default).

Changes:
- README: Login section reorganized — Gemini listed first (env var setup),
  Claude options second, Ollama mentioned
- agent-guide.md: provider field default "gemini", auth resolution
  documents all three providers, example configs use gemini-2.5-flash
- configuration.md: `provider` default and example soul config use Gemini
- quickstart.md: auth step starts with `export GEMINI_API_KEY` and
  mentions Claude as an alternative
- cli.md: `bubbaloop login` description clarifies it covers Claude only;
  env var table adds GEMINI_API_KEY

Co-Authored-By: Claude Sonnet 4.6 <noreply@anthropic.com>
@qodo-code-review

Copy link
Copy Markdown

Qodo reviews are paused for this user.

Troubleshooting steps vary by plan Learn more →

On a Teams plan?
Reviews resume once this user has a paid seat and their Git account is linked in Qodo.
Link Git account →

Using GitHub Enterprise Server, GitLab Self-Managed, or Bitbucket Data Center?
These require an Enterprise plan - Contact us
Contact us →

…dashboard docs

After a parallel 4-agent audit of all docs, this commit brings the
project documentation in line with the 10 commits shipped since v0.0.13.

CHANGELOG.md
- Backfill v0.0.8 → v0.0.13 (was stuck at v0.0.7)
- Add v0.0.14 section with grab_frame, Gemini Vision, turn cancellation,
  Chat tab, multi-provider login status, mcp --token flag

Root docs (CLAUDE.md, ARCHITECTURE.md, ROADMAP.md, CONTRIBUTING.md, README.md)
- MCP tool count 42 → 47 (4 places)
- Add Gemini provider to file pointers; document grab_frame and
  agent gateway cancel topic
- Check off completed roadmap items (Chat tab, Gemini, grab_frame,
  cancellation, HTTP+SSE)
- Fix Rust test count 298+ → 2400+

Concept docs
- memory.md: 3-tier → 4-tier (matches CLAUDE.md/ARCHITECTURE.md)
- topics.md: add cancel topic row + Chat tab note
- messaging.md: add cancel topic + Chat tab HTTP+SSE alternative
- architecture.md: add Chat tab entry point, document --token flag
- wire-format.md: note grab_frame queryable reply uses raw JPEG +
  JSON attachment (not the CBOR envelope)

Reference docs
- cli.md: add 'bubbaloop mcp' subcommand row, BUBBALOOP_MCP_TOKEN,
  BUBBALOOP_MCP_MODE, BUBBALOOP_MCP_TOOLSETS, OLLAMA_HOST env vars
- troubleshooting.md: multi-provider auth fix instructions; Gemini
  quota dashboard alongside Anthropic Console

Dashboard docs
- index.md: add Chat row to features table
- chat.md: NEW FILE documenting the Chat tab end-to-end (HTTP+SSE
  transport, provider/agent selection, tool-call traces,
  image-in-chat via grab_frame, turn cancellation)
- getting-started/quickstart.md: add Chat to Dashboard Features table

MCP plugin docs
- INSTALL.md: prefer 'bubbaloop mcp --token' over 'cat ~/.bubbaloop/mcp-token'

agent-guide.md
- Add Turn Cancellation paragraph documenting Ctrl-C + cancel topic
- Add grab_frame to Quick Reference (agent-internal tools)

Co-Authored-By: Claude Sonnet 4.6 <noreply@anthropic.com>
@edgarriba edgarriba changed the title docs: prioritize Gemini as the default agent provider docs(release): v0.0.14 sync — Gemini priority + 10 new features documented May 19, 2026
@edgarriba edgarriba merged commit 8746dfc into main May 19, 2026
1 check passed
@edgarriba edgarriba deleted the docs/gemini-priority branch May 19, 2026 07:06
@edgarriba edgarriba mentioned this pull request May 19, 2026
4 tasks
edgarriba added a commit that referenced this pull request May 19, 2026
Ships 10 commits worth of features and fixes since v0.0.13:

Features
- agent: grab_frame tool + Gemini Vision provider + image-in-chat (#96)
- dashboard: Chat tab with HTTP+SSE agent gateway (#91)
- agent: client-side turn cancellation via Zenoh cancel topic (#94, #95)
- chat: multi-provider login status, 404 on unknown agent, Claude OAuth
  risk warning (#93)
- mcp: 'bubbaloop mcp --token' prints bearer token for .mcp.json (#90)

Fixes
- agent: grab_frame reads binary JPEG payload + JSON metadata
  attachment from camera nodes (#99)
- chat: clear Responding state after multi-camera grab_frame (#98)
- mcp: eliminate token race between gateway and agent runtime (#89)

Chores
- dashboard: remove LibraryView component (#92, replaced by Chat tab)

Docs
- Comprehensive sync across README, CHANGELOG (backfilled v0.0.8 to
  v0.0.13), CLAUDE.md, ARCHITECTURE.md, ROADMAP.md, concept/reference/
  dashboard docs to match the new feature surface (#100)

Co-authored-by: Claude Sonnet 4.6 <noreply@anthropic.com>
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

1 participant