Skip to content

Conversation

@aRustyDev
Copy link
Owner

Summary

  • Add sqlite-vec based semantic knowledge graph for context components
  • Implement MCP server research infrastructure with SQLite+FTS5 registry cache
  • Add plugin creation workflow with 4 agents and 6 commands
  • Configure MCP server settings with categorized YAML structure

Key Components

Knowledge Graph (sqlite-vec)

  • Database schema with entities, chunks, embeddings, and similarity cache
  • Embedder module with Ollama (primary) and sentence-transformers (fallback)
  • Markdown chunker with hierarchical levels (file/section/paragraph)
  • Ingestion pipeline CLI with search and similarity commands
  • File watcher for automatic re-embedding on changes
  • Justfile targets: kg-init, kg-ingest, kg-search, kg-similar, etc.

MCP Research Infrastructure

  • SQLite+FTS5 registry cache for MCP server metadata
  • Research agents: mcp-server-profiler, mcp-registry-scanner
  • Skill definition for MCP research workflow
  • Tiered registry reference (official, curated, community)

Architecture Decisions

Documented in docs/src/adr/:

  • ADR-001: SQLite as primary store
  • ADR-002: sqlite-vec for vector index
  • ADR-003: Ollama embedding models
  • ADR-004: Recursive CTEs for graph queries
  • ADR-005: Watchdog file watching
  • ADR-006: SQL dump for version control
  • ADR-007: Future graph layer considerations

Test plan

  • Run just init to install dependencies and initialize database
  • Verify just kg-stats shows empty database
  • Install Ollama and pull nomic-embed-text model
  • Run just kg-ingest to embed context files
  • Test just kg-search "code analysis" returns relevant results
  • Test just kg-similar <entity-slug> returns similar entities

🤖 Generated with Claude Code

aRustyDev and others added 9 commits February 1, 2026 16:22
…ages

Expand the Homebrew formula generation skill from 3 fully-supported
languages (Go, Rust, Python) to 24 language enum values with full
template pipeline coverage, plus 7 Tier 2 and 7 Tier 3 mapped languages.

- Add 15 new install-* schema definitions and allOf dispatch entries
- Create 17 mustache partials for language-specific install blocks
- Add 25 reference docs with research patterns and common issues
- Add 21 example formulas showing expected pipeline output
- Add 36 test fixtures and 35 test cases (41 total tests, all passing)
- Create meta-checklist for adding future language support
- Add build_system_is_* flag preprocessing in formula.helper.ts

Co-Authored-By: Claude Opus 4.5 <noreply@anthropic.com>
Add human-facing README with pipeline overview, language tiers, and
directory layout. Remove TODO.md and settings.json (superseded by
repo reorganization). Remove unused add-formula justfile recipe.

Co-Authored-By: Claude Opus 4.5 <noreply@anthropic.com>
Add Homebrew's official MCP server (brew mcp-server) and
@gongrzhe/server-json-mcp for JSONPath queries. Replace placeholder
configs that had hardcoded /path/to paths. Add jq and node to
brewfile as runtime dependencies for the MCP servers.

Co-Authored-By: Claude Opus 4.5 <noreply@anthropic.com>
…t format

Convert flat URL lists to categorized maps with structured entries
containing url, desc, and name fields across all 48 MCP registry files.

Co-Authored-By: Claude Opus 4.5 <noreply@anthropic.com>
Add justfile recipe with [confirm] to clone, build, and merge three
clone-only MCP servers (json-validate, jsondiffpatch, json-mcp-server)
into the plugin's .mcp.json config.

Co-Authored-By: Claude Opus 4.5 <noreply@anthropic.com>
Implement a modular plugin planning and scaffolding pipeline:
- Orchestrator `/create-plugin` chains brainstorm → research → roadmap → scaffold → issues
- 4 specialized agents: skill-researcher, mcp-researcher, component-assessor, planner
- Interactive brainstorming across 7 component categories (skills, commands, agents, styles, hooks, MCP, LSP)
- Parallel research using haiku agents, synthesis via sonnet assessor
- Roadmap with P0/P1/P2 prioritization and dependency mapping
- Scaffold from .template/ with generated plugin.json, sources, mcp config
- Beads issue generation with labels and blocking relationships

Co-Authored-By: Claude Opus 4.5 <noreply@anthropic.com>
Introduce a local MCP server registry cache backed by SQLite with FTS5
full-text search. Split the monolithic plugin-mcp-researcher into three
specialized agents (scanner, profiler, researcher) and add a /find-mcp-servers
slash command for cache-first server discovery.

- Add .data/mcp/registry-cache.sql with schema, triggers, and 39 seeded
  code-analysis servers (8 fully profiled with tools)
- Add mcp-registry-scanner agent (haiku) for lightweight registry discovery
- Add mcp-server-profiler agent (sonnet) for deep server enrichment
- Rewrite plugin-mcp-researcher for cache-first flow
- Add /find-mcp-servers command with FTS5 search, weighted ranking, and
  interactive next steps
- Add justfile recipes for cache management (load, dump, stats, search)
- Add cclint config and lint-context.sh for agent/command validation

Co-Authored-By: Claude Opus 4.5 <noreply@anthropic.com>
Expand the mcp-research stub into a full skill with architecture docs,
three discovery/profiling/seeding workflows, web scraping fallback chain,
SQL patterns, and troubleshooting guide. Restructure registries.yaml
into prioritized tiers for the scanner agent.

Co-Authored-By: Claude Opus 4.5 <noreply@anthropic.com>
Add semantic knowledge graph infrastructure using sqlite-vec for vector
storage and Ollama for local embedding generation.

Components:
- Database schema with entities, chunks, embeddings, and similarity cache
- Embedder module with Ollama (primary) and sentence-transformers (fallback)
- Markdown chunker with hierarchical levels (file/section/paragraph)
- Ingestion pipeline CLI (embed.py) with search, similarity commands
- File watcher for automatic re-embedding on changes
- Justfile targets: kg-init, kg-ingest, kg-search, kg-similar, etc.

Architecture decisions documented in docs/src/adr/:
- ADR-001: SQLite as primary store
- ADR-002: sqlite-vec for vector index
- ADR-003: Ollama embedding models
- ADR-004: Recursive CTEs for graph queries
- ADR-005: Watchdog file watching
- ADR-006: SQL dump for version control
- ADR-007: Future graph layer considerations

Requires Python 3.14+ (Homebrew) for sqlite extension loading.

Co-Authored-By: Claude Opus 4.5 <noreply@anthropic.com>
Signed-off-by: aRustyDev <36318507+aRustyDev@users.noreply.github.com>
@aRustyDev aRustyDev merged commit a5ff60f into main Feb 3, 2026
2 checks passed
@aRustyDev aRustyDev deleted the feat/homebrew-dev-mcp-servers branch February 3, 2026 05:53
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