dl4rce/flaiwheel

"This is the Way" — Knowledge Bootstrap & Cleanup

Got a messy repo with scattered docs? Tell your AI agent "This is the Way" (or just "42") and the full bootstrap workflow kicks in.

What's New

• Knowledge Bootstrap — analyse messy repos, classify files by content + embeddings, detect near-duplicates (cosine similarity ≥ 92%), and propose a structured cleanup plan
• 2 new MCP tools: analyze_knowledge_repo() (read-only analysis) and execute_cleanup(actions) (user-approved execution)
• Web UI bootstrap section — one-click analysis and guided cleanup from the browser
• 3 new API endpoints: /api/bootstrap/analyze, /api/bootstrap/report, /api/bootstrap/execute
• 47 new tests covering classification, duplicate detection, plan generation, and safe execution (202 total)
• Updated agent instructions — all install templates (FLAIWHEEL_TOOLS.md, AGENTS.md, flaiwheel.mdc) now include the bootstrap workflow and all 22 MCP tools

How It Works

1. analyze_knowledge_repo() — full read-only scan: classifies files, detects duplicates, scores quality, proposes a cleanup plan
2. Review the report with the user
3. execute_cleanup(actions) — execute only approved actions (mkdir + git mv)
4. For files flagged as low quality, rewrite using write_* tools
5. reindex() — finalize the clean knowledge base

Hard Safeguards

• Never deletes files — only moves (via git mv) and creates directories
• Never auto-executes — always requires explicit user approval
• Preserves git history — all moves use git mv
• Provides rollback — every execution returns a git revert command

Classification Strategy

Three-signal consensus: path-based detection, keyword/section matching, and embedding similarity against category templates. Confidence scores help prioritize actions.

Full changelog: v2.2.0...v2.3.0