Skip to content

spec: Add Bluespeed architecture spec (v0.1) for local-first AI on Bluefin#236

Open
lazypower wants to merge 8 commits intoprojectbluefin:mainfrom
lazypower:specs/bluespeed
Open

spec: Add Bluespeed architecture spec (v0.1) for local-first AI on Bluefin#236
lazypower wants to merge 8 commits intoprojectbluefin:mainfrom
lazypower:specs/bluespeed

Conversation

@lazypower
Copy link
Copy Markdown

Comprehensive specification for the Bluespeed initiative (common#100): local-first AI diagnostics and knowledge retrieval for the Bluefin desktop, built on Goose, ramalama, and the MCP server ecosystem.

Covers architecture, component stack, knowledge pipeline (crawl → chunk → embed → sqlite-vec), bluefin-knowledge-mcp interface spec, context window management with hard governors, tool routing with visibility filtering, model evaluation criteria and candidates, system prompt design, safety model, prompt injection mitigations, failure modes, resource budgets, testing plan, and phased rollout.

Research directory includes distilled reference material from all upstream dependencies (linux-mcp-server, okp-mcp, ramalama, goose, gnome-mcp-server, dosu) and Bluefin docs crawl analysis.

Ready for architectural review — open questions flagged inline.

@dosubot dosubot bot added the size:XS This PR changes 0-9 lines, ignoring generated files. label Mar 20, 2026
@gemini-code-assist
Copy link
Copy Markdown
Contributor

Note

Gemini is unable to generate a review for this pull request due to the file types involved not being currently supported.

@dosubot dosubot bot added area/bluespeed AI/Machine Learning integration kind/documentation Improvements or additions to documentation labels Mar 20, 2026
@lazypower lazypower marked this pull request as draft March 20, 2026 02:07
@castrojo
Copy link
Copy Markdown
Contributor

This is awesome!

I made it all the way through but have some follow up questions, I'd like to merge this and tweak along the way.

@castrojo castrojo mentioned this pull request Mar 21, 2026
8 tasks
@castrojo
Copy link
Copy Markdown
Contributor

I'm going to merge this now so we don't slow down (sorry I'm at kubecon!).

And then we'll open a discussion. Thanks for working on this chuck!

@dosubot dosubot bot added the lgtm This PR has been approved by a maintainer label Mar 25, 2026
@castrojo castrojo marked this pull request as ready for review March 25, 2026 10:00
@castrojo castrojo enabled auto-merge March 25, 2026 10:00
@dosubot dosubot bot added the kind/enhancement New feature, don't implement without a spec and consensus label Mar 25, 2026
auto-merge was automatically disabled March 31, 2026 13:05

Head branch was pushed to by a user without write access

@lazypower lazypower force-pushed the specs/bluespeed branch 2 times, most recently from d02031e to e707a6b Compare April 2, 2026 13:05
…uefin

Comprehensive specification for the Bluespeed initiative (common#100):
local-first AI diagnostics and knowledge retrieval for the Bluefin
desktop, built on Goose, ramalama, and the MCP server ecosystem.

Covers architecture, component stack, knowledge pipeline (crawl →
chunk → embed → sqlite-vec), bluefin-knowledge-mcp interface spec,
context window management with hard governors, tool routing with
visibility filtering, model evaluation criteria and candidates,
system prompt design, safety model, prompt injection mitigations,
failure modes, resource budgets, testing plan, and phased rollout.

Research directory includes distilled reference material from all
upstream dependencies (linux-mcp-server, okp-mcp, ramalama, goose,
gnome-mcp-server, dosu) and Bluefin docs crawl analysis.

Ready for architectural review — open questions flagged inline.
- Remove apple hardware
- s/cron/systemd timers
- s/podman-compose/quadlets
…wledge layer (v0.2)

Follows the spec: prefix pattern from the v0.1 commit. Captures both the addition and the architectural consolidation without getting wordy.
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

area/bluespeed AI/Machine Learning integration kind/documentation Improvements or additions to documentation kind/enhancement New feature, don't implement without a spec and consensus lgtm This PR has been approved by a maintainer size:XS This PR changes 0-9 lines, ignoring generated files.

Projects

None yet

Development

Successfully merging this pull request may close these issues.

2 participants