Changelog

brain community — prints GitHub, PyPI, Discussions, and Issues links in a styled panel

brain --feedback — global flag that opens GitHub Discussions in the browser

GitHub Discussions integration via community.py

Community resource panel with all OSS ecosystem links

Version consistency fixes across CLI and package metadata

Packaging metadata cleanup for OSS readiness

OSS ecosystem readiness improvements

CLI version resolution issue (brain --version now correct)

Package metadata mismatch between pyproject.toml and __version__

Recursive repository scanning

AST-based Python parsing with function and class extraction

File metadata indexing and SHA256-based file tracking

Binary file detection and automatic skipping

Invalid Python parsing resilience — bad files skipped safely

Git reference comparison (any two refs)

File-level diff: added / modified / deleted file detection

Function-level diff analysis for Python files

Semantic function body comparison via AST

brain export full_code — full repository export to .brain/exports/full_code.txt

brain export file <path> — single file export

brain export dir <path> — directory export

brain export code_changes <from> <to> — diff-based function export

AI-friendly structured output format (=== FILE: ... === sections)

brain diff explain <file> — file-level structural explanation

brain diff explain <file:function> — function-level explanation

brain diff review — LLM-assisted diff review with HTML + JSON reports

Explanation caching in .brain/cache/ — avoids repeated LLM calls

Fallback heuristic summaries when LLM is disabled

Interactive HTML reports with risk labels and semantic summaries

Gemini provider support

HuggingFace provider support

Offline mode: provider: none in brain.yaml — zero API calls

brain testllm test — provider connectivity validation

Ollama provider support (local models)

OpenAI provider support

Timeout handling, model listing, response normalization

brain project doctor — full environment diagnostics (READY / PARTIAL / NOT READY)

Persistent logging to .brain/logs.txt — failures never crash CLI

Checks: project init, Git, config, provider, API keys, exports

brain project init — creates .brain/ structure and brain.yaml

brain and project-brain as CLI aliases (both work identically)

brain project analyze [path] — recursive AST scan

brain project summary — repo overview (text / json / markdown format)

brain.yaml config with llm, analysis, diff, export, explain, output sections

brain and project-brain as CLI aliases (both work identically)

brain --version / -v — show installed version

Unicode-safe subprocess execution

Safer file reading workflows for unreadable files

Better provider fallback behavior

Improved Git command handling for edge cases

18 automated tests passing (pytest)

Test coverage: CLI, analyzer, differ, config, export, explain, logging, edge cases

Real-world QA against Flask, Typer, and other open-source repositories

GitHub Actions CI — automated test execution on every push

Security hardening pass over the dev branch before OSS public release

Resolved potential unsafe file-read and subprocess exposure vectors

Dependency audit and cleanup ahead of PyPI publication

Code hygiene: removed debug artifacts and leftover dev scaffolding

Hardened branch merged to main as a pre-release security checkpoint

MIT LICENSE file added to the repository root (PR #10 — license branch)

README.md updated with project description, install steps, and usage examples

OSS compliance: repository now includes proper open-source licensing

README reflects current CLI command surface and config structure

Stabilized analyzer module — consistent AST parsing across edge-case files

Stabilized differ module — reliable function-level diff output

Stabilized exporter module — deterministic export file generation

Cleaned test artifacts and removed stale fixture data polluting test runs

Automated test suite runs cleanly end-to-end for v0.2 milestone

Test isolation improved — no cross-test state contamination

Removed accidentally tracked yaml config files from version control

Removed .brainmain/ folder from Git tracking — now correctly gitignored

.gitignore updated to prevent re-tracking of runtime and output artifacts

Cleaner repository state for contributors cloning the project

Runtime output directories separated from source-controlled files

Initial CLI entry point — brain / project-brain command scaffolded

Project directory structure established (.brain/, brain.yaml)

Early prototype of the repository analyzer (AST scanning)

Basic Git diff detection stub

Dev branch first merge to main — project exists as an installable package

pyproject.toml configured for local pip install

Initial project skeleton ready for iterative dev cycle