buildmind 0.1.0__tar.gz

buildmind-0.1.0/PKG-INFO

@@ -0,0 +1,182 @@
+Metadata-Version: 2.4
+Name: buildmind
+Version: 0.1.0
+Summary: AI Thinking Infrastructure — orchestrate human decisions and AI execution in your IDE
+License: MIT
+Keywords: ai,orchestration,cli,mcp,llm
+Requires-Python: >=3.10
+Description-Content-Type: text/markdown
+Requires-Dist: typer>=0.12.0
+Requires-Dist: rich>=13.7.0
+Requires-Dist: prompt-toolkit>=3.0.43
+Requires-Dist: pydantic>=2.6.0
+Requires-Dist: pydantic-settings>=2.2.0
+Requires-Dist: httpx>=0.27.0
+Requires-Dist: python-dotenv>=1.0.0
+Requires-Dist: pyyaml>=6.0.1
+Requires-Dist: anthropic>=0.25.0
+Requires-Dist: openai>=1.20.0
+Requires-Dist: mcp>=0.9.0
+Requires-Dist: anyio>=4.0.0
+Provides-Extra: dev
+Requires-Dist: pytest>=8.0; extra == "dev"
+Requires-Dist: pytest-asyncio>=0.23; extra == "dev"
+Requires-Dist: black; extra == "dev"
+Requires-Dist: ruff; extra == "dev"
+
+# 🧠 BuildMind
+
+> **AI Thinking Infrastructure** — the operating system for human-AI collaborative engineering, running directly in your IDE terminal.
+
+```
+Human     = Strategy  (you make decisions, in your terminal)
+AI        = Execution (models already in your IDE — no API keys)
+BuildMind = Orchestrator (runs the pipeline, enforces rules)
+```
+
+---
+
+## 🖥️ How You Use It (IDE-Native, Zero Setup)
+
+BuildMind is a **Python CLI tool + MCP server** that runs in your IDE's terminal and uses the models already available in your IDE (Antigravity has Claude Haiku, Sonnet, Opus, Gemini Pro, and more — no API keys needed).
+
+```bash
+# Install
+pip install buildmind
+
+# Run inside any project
+buildmind start "Build a task management API with authentication"
+```
+
+**Works for any project type:**
+```bash
+buildmind start "Build a REST API with authentication"
+buildmind start "Build a React dashboard with charts"
+buildmind start "Build a CLI tool for file compression"
+buildmind start "Build a Stripe payment integration"
+buildmind start "Build a real-time chat system"
+buildmind start "Build a web scraper with rate limiting"
+buildmind start "Build a microservice for email sending"
+```
+
+---
+
+## 🤖 Uses Your IDE's Models — No API Keys
+
+BuildMind connects to your IDE's AI (Antigravity) via MCP. Your IDE already has access to:
+
+| Model | Used For |
+|-------|---------|
+| `claude-opus` | Task decomposition (deep reasoning) |
+| `claude-sonnet` | Code generation, decision cards, explanations |
+| `claude-haiku` | Classification, validation (fast + cheap) |
+| `gemini-pro` | Fallback / alternative reasoning |
+| `gemini-flash` | Fast classification fallback |
+
+**No `.env` file. No API key configuration. Your IDE handles all of that.**
+
+---
+
+## 🧩 Human Decisions — All In Terminal, All Options Listed
+
+When BuildMind needs your input, it surfaces **every realistic option with honest tradeoffs** — all inline in your terminal, no browser needed:
+
+```
+━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━
+  🧩 DECISION: Choose Authentication Strategy
+━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━
+
+  WHY YOU: Auth strategy shapes your entire security model.
+           This is hard to change later without major refactoring.
+
+  [1]  JWT (stateless)        — APIs, mobile, SPAs
+  [2]  Session-based          — web apps, admin tools  ← AI recommends
+  [3]  OAuth / OpenID         — social login, SSO
+  [4]  API Keys               — machine-to-machine APIs
+  [5]  Custom — describe your approach
+
+  > explain 1        ← type to get a deep dive on any option
+  > compare 1 2      ← side-by-side comparison
+
+  Enter choice [1-5] or command:
+  >
+```
+
+All explanations generated inline by your IDE's AI. No ChatGPT. No browser tabs.
+
+---
+
+## ⚙️ AI Tasks — Written Directly to Your Project
+
+```
+your-project/
+├── src/
+│   └── auth/
+│       ├── jwt_service.py      ← Written by AI (used your decision: JWT)
+│       └── routes.py           ← Written by AI
+├── .buildmind/
+│   ├── decisions.json          ← Every choice you made
+│   └── audit_log.jsonl         ← Complete history
+└── BUILDMIND_SUMMARY.md        ← What was built + why
+```
+
+---
+
+## 📚 Documentation
+
+| Doc | Description |
+|-----|-------------|
+| [**IDE Integration** ⭐ START HERE](./docs/15-ide-integration.md) | Setup, full terminal demo, CLI commands |
+| [Vision & Positioning](./docs/01-vision-and-positioning.md) | Product philosophy + differentiation |
+| [System Architecture](./docs/02-system-architecture.md) | Full system design — generic, any project type |
+| [Task Decomposer](./docs/03-task-decomposer.md) | How any project gets broken into atomic tasks |
+| [Decision Engine](./docs/04-decision-engine.md) | Terminal decision cards — options, `explain <num>` |
+| [Compulsion Layer](./docs/05-compulsion-layer.md) | Anti-autonomy enforcement |
+| [Router & Model Strategy](./docs/06-router-and-model-strategy.md) | IDE models (Haiku/Sonnet/Opus/Gemini) — no keys |
+| [Graph Engine](./docs/07-graph-engine.md) | ASCII terminal graph + JSON for visualization |
+| [Explanation Engine](./docs/08-explanation-engine.md) | Code → plain English, inline in terminal |
+| [Database Schema](./docs/09-database-schema.md) | File-based storage in `.buildmind/` |
+| [Prompt Templates](./docs/10-prompt-templates.md) | All LLM prompt templates |
+| [Tech Stack](./docs/11-tech-stack.md) | Python CLI (Typer + Rich), MCP server, IDE model access |
+| [MVP Build Plan](./docs/12-mvp-build-plan.md) | 7-day sprint plan |
+| [Product Tiers](./docs/13-product-tiers.md) | Free / Pro / Enterprise |
+| [Implementation Roadmap](./docs/14-implementation-roadmap.md) | MVP → Scale |
+
+---
+
+## 🚀 Quick Start
+
+**Option A: IDE-Native (Zero Config, No API Keys)**
+Connect BuildMind to your IDE's AI (like Cursor or Antigravity):
+```bash
+pip install buildmind
+buildmind serve --mcp
+```
+*(See [IDE Integration Guide](./docs/15-ide-integration.md) for setup instructions)*
+
+**Option B: Standalone CLI**
+Run directly in your terminal (requires your own API key):
+```bash
+pip install buildmind
+export ANTHROPIC_API_KEY="sk-ant-..."
+
+# Initialize in your project
+buildmind init
+
+# Start building
+buildmind start "Build whatever you're working on"
+```
+
+---
+
+## 🏗️ Project Status
+
+**Current Phase:** MVP Feature Complete!  
+**Next Phase:** IDE Specific Plugin Wrappers / Beta Testing
+
+See [IDE Integration Guide](./docs/15-ide-integration.md) for the full experience.  
+See [MVP Build Plan](./docs/12-mvp-build-plan.md) for the 7-day build sprint.
+
+---
+
+*Built with 🧠 by Mukul Prasad*

buildmind-0.1.0/README.md

@@ -0,0 +1,156 @@
+# 🧠 BuildMind
+
+> **AI Thinking Infrastructure** — the operating system for human-AI collaborative engineering, running directly in your IDE terminal.
+
+```
+Human     = Strategy  (you make decisions, in your terminal)
+AI        = Execution (models already in your IDE — no API keys)
+BuildMind = Orchestrator (runs the pipeline, enforces rules)
+```
+
+---
+
+## 🖥️ How You Use It (IDE-Native, Zero Setup)
+
+BuildMind is a **Python CLI tool + MCP server** that runs in your IDE's terminal and uses the models already available in your IDE (Antigravity has Claude Haiku, Sonnet, Opus, Gemini Pro, and more — no API keys needed).
+
+```bash
+# Install
+pip install buildmind
+
+# Run inside any project
+buildmind start "Build a task management API with authentication"
+```
+
+**Works for any project type:**
+```bash
+buildmind start "Build a REST API with authentication"
+buildmind start "Build a React dashboard with charts"
+buildmind start "Build a CLI tool for file compression"
+buildmind start "Build a Stripe payment integration"
+buildmind start "Build a real-time chat system"
+buildmind start "Build a web scraper with rate limiting"
+buildmind start "Build a microservice for email sending"
+```
+
+---
+
+## 🤖 Uses Your IDE's Models — No API Keys
+
+BuildMind connects to your IDE's AI (Antigravity) via MCP. Your IDE already has access to:
+
+| Model | Used For |
+|-------|---------|
+| `claude-opus` | Task decomposition (deep reasoning) |
+| `claude-sonnet` | Code generation, decision cards, explanations |
+| `claude-haiku` | Classification, validation (fast + cheap) |
+| `gemini-pro` | Fallback / alternative reasoning |
+| `gemini-flash` | Fast classification fallback |
+
+**No `.env` file. No API key configuration. Your IDE handles all of that.**
+
+---
+
+## 🧩 Human Decisions — All In Terminal, All Options Listed
+
+When BuildMind needs your input, it surfaces **every realistic option with honest tradeoffs** — all inline in your terminal, no browser needed:
+
+```
+━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━
+  🧩 DECISION: Choose Authentication Strategy
+━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━
+
+  WHY YOU: Auth strategy shapes your entire security model.
+           This is hard to change later without major refactoring.
+
+  [1]  JWT (stateless)        — APIs, mobile, SPAs
+  [2]  Session-based          — web apps, admin tools  ← AI recommends
+  [3]  OAuth / OpenID         — social login, SSO
+  [4]  API Keys               — machine-to-machine APIs
+  [5]  Custom — describe your approach
+
+  > explain 1        ← type to get a deep dive on any option
+  > compare 1 2      ← side-by-side comparison
+
+  Enter choice [1-5] or command:
+  >
+```
+
+All explanations generated inline by your IDE's AI. No ChatGPT. No browser tabs.
+
+---
+
+## ⚙️ AI Tasks — Written Directly to Your Project
+
+```
+your-project/
+├── src/
+│   └── auth/
+│       ├── jwt_service.py      ← Written by AI (used your decision: JWT)
+│       └── routes.py           ← Written by AI
+├── .buildmind/
+│   ├── decisions.json          ← Every choice you made
+│   └── audit_log.jsonl         ← Complete history
+└── BUILDMIND_SUMMARY.md        ← What was built + why
+```
+
+---
+
+## 📚 Documentation
+
+| Doc | Description |
+|-----|-------------|
+| [**IDE Integration** ⭐ START HERE](./docs/15-ide-integration.md) | Setup, full terminal demo, CLI commands |
+| [Vision & Positioning](./docs/01-vision-and-positioning.md) | Product philosophy + differentiation |
+| [System Architecture](./docs/02-system-architecture.md) | Full system design — generic, any project type |
+| [Task Decomposer](./docs/03-task-decomposer.md) | How any project gets broken into atomic tasks |
+| [Decision Engine](./docs/04-decision-engine.md) | Terminal decision cards — options, `explain <num>` |
+| [Compulsion Layer](./docs/05-compulsion-layer.md) | Anti-autonomy enforcement |
+| [Router & Model Strategy](./docs/06-router-and-model-strategy.md) | IDE models (Haiku/Sonnet/Opus/Gemini) — no keys |
+| [Graph Engine](./docs/07-graph-engine.md) | ASCII terminal graph + JSON for visualization |
+| [Explanation Engine](./docs/08-explanation-engine.md) | Code → plain English, inline in terminal |
+| [Database Schema](./docs/09-database-schema.md) | File-based storage in `.buildmind/` |
+| [Prompt Templates](./docs/10-prompt-templates.md) | All LLM prompt templates |
+| [Tech Stack](./docs/11-tech-stack.md) | Python CLI (Typer + Rich), MCP server, IDE model access |
+| [MVP Build Plan](./docs/12-mvp-build-plan.md) | 7-day sprint plan |
+| [Product Tiers](./docs/13-product-tiers.md) | Free / Pro / Enterprise |
+| [Implementation Roadmap](./docs/14-implementation-roadmap.md) | MVP → Scale |
+
+---
+
+## 🚀 Quick Start
+
+**Option A: IDE-Native (Zero Config, No API Keys)**
+Connect BuildMind to your IDE's AI (like Cursor or Antigravity):
+```bash
+pip install buildmind
+buildmind serve --mcp
+```
+*(See [IDE Integration Guide](./docs/15-ide-integration.md) for setup instructions)*
+
+**Option B: Standalone CLI**
+Run directly in your terminal (requires your own API key):
+```bash
+pip install buildmind
+export ANTHROPIC_API_KEY="sk-ant-..."
+
+# Initialize in your project
+buildmind init
+
+# Start building
+buildmind start "Build whatever you're working on"
+```
+
+---
+
+## 🏗️ Project Status
+
+**Current Phase:** MVP Feature Complete!  
+**Next Phase:** IDE Specific Plugin Wrappers / Beta Testing
+
+See [IDE Integration Guide](./docs/15-ide-integration.md) for the full experience.  
+See [MVP Build Plan](./docs/12-mvp-build-plan.md) for the 7-day build sprint.
+
+---
+
+*Built with 🧠 by Mukul Prasad*

buildmind-0.1.0/buildmind/__init__.py

@@ -0,0 +1,3 @@
+# BuildMind — AI Thinking Infrastructure
+__version__ = "0.1.0"
+__author__ = "Mukul Prasad"