conciliate 0.2.0__tar.gz

conciliate-0.2.0/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2025 Conciliate Team
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

conciliate-0.2.0/PKG-INFO

@@ -0,0 +1,201 @@
+Metadata-Version: 2.4
+Name: conciliate
+Version: 0.2.0
+Summary: AI context synchronization and propagation between dev environments
+Author: Conciliate Team
+License: MIT
+Project-URL: Homepage, https://github.com/iv4n-ga6l/conciliate
+Project-URL: Repository, https://github.com/iv4n-ga6l/conciliate
+Keywords: api,openapi,sync,ai,context,fastapi
+Classifier: Development Status :: 3 - Alpha
+Classifier: Intended Audience :: Developers
+Classifier: License :: OSI Approved :: MIT License
+Classifier: Programming Language :: Python :: 3
+Classifier: Programming Language :: Python :: 3.9
+Classifier: Programming Language :: Python :: 3.10
+Classifier: Programming Language :: Python :: 3.11
+Classifier: Programming Language :: Python :: 3.12
+Requires-Python: >=3.9
+Description-Content-Type: text/markdown
+License-File: LICENSE
+Requires-Dist: fastapi>=0.104.0
+Requires-Dist: uvicorn[standard]>=0.24.0
+Requires-Dist: watchfiles>=0.21.0
+Requires-Dist: deepdiff>=6.7.0
+Requires-Dist: typer>=0.9.0
+Requires-Dist: pyyaml>=6.0
+Requires-Dist: httpx>=0.25.0
+Requires-Dist: rich>=13.7.0
+Requires-Dist: pydantic>=2.5.0
+Requires-Dist: pydantic-settings>=2.1.0
+Requires-Dist: mcp>=1.0.0
+Provides-Extra: dev
+Requires-Dist: pytest>=7.4.0; extra == "dev"
+Requires-Dist: pytest-asyncio>=0.21.0; extra == "dev"
+Requires-Dist: black>=23.0.0; extra == "dev"
+Requires-Dist: ruff>=0.1.0; extra == "dev"
+Requires-Dist: mypy>=1.7.0; extra == "dev"
+Dynamic: license-file
+
+<p align="center">
+    <img src="assets/conciliate_brand.png" alt="Conciliate - Unified context for smarter AI decisions" />
+</p>
+
+<p align="center">
+    <a href="https://github.com/yourusername/conciliate/releases" target="_blank" rel="noopener"><img src="https://img.shields.io/github/release/yourusername/conciliate.svg" alt="Latest releases" /></a>
+    <a href="https://github.com/yourusername/conciliate/blob/main/LICENSE" target="_blank" rel="noopener"><img src="https://img.shields.io/badge/license-MIT-blue.svg" alt="MIT License" /></a>
+    <a href="https://pypi.org/project/conciliate/" target="_blank" rel="noopener"><img src="https://img.shields.io/pypi/v/conciliate.svg" alt="PyPI version" /></a>
+</p>
+
+**Unified context for smarter AI decisions.**
+
+Conciliate automatically extracts API specifications from your backend, detects changes, and streams context to AI coding assistants in real-time. Keep your AI in sync across separate IDE sessions—no more manual copy-pasting.
+
+## Features
+
+- **Auto-extraction**: Monitors backend files, generates OpenAPI specs automatically
+- **Live updates**: Real-time synchronization via MCP protocol  
+- **Three access modes**: MCP server, REST API, or CLI
+- **Framework support**: FastAPI (_Flask, Express coming soon_)
+- **AI-native**: Built for Claude Desktop, Cursor, VS Code Copilot
+- **Local-first**: No cloud dependencies, runs entirely on your machine
+
+## Quick Start
+
+### Install
+
+```bash
+pip install conciliate
+```
+
+### Setup
+
+```bash
+cd /path/to/your/project
+conciliate init
+# Edit .conciliate.yaml to set backend_path
+```
+
+### Run
+
+```bash
+conciliate mcp      # For AI assistants (recommended)
+conciliate watch    # REST API + file watching
+conciliate serve    # REST API only
+```
+
+## CLI Commands
+
+| Command | Description |
+|---------|-------------|
+| `conciliate init` | Create config file |
+| `conciliate watch` | Watch backend + serve REST API |
+| `conciliate mcp` | Run MCP server for AI assistants |
+| `conciliate summary` | Display API summary |
+| `conciliate diff` | Show recent changes |
+| `conciliate status` | Show configuration |
+
+## Configuration
+
+Create `.conciliate.yaml` in your project root:
+
+```yaml
+backend_path: ../backend    # Path to your backend
+framework: fastapi          # Backend framework (auto-detected if omitted)
+port: 5678                  # Server port
+output_dir: .conciliate     # Output directory
+```
+
+Copy from `.conciliate.yaml.template` for all available options.
+
+## � MCP Integration (AI Assistants)
+
+### Claude Desktop
+
+Edit `claude_desktop_config.json`:
+
+```json
+{
+  "mcpServers": {
+    "conciliate": {
+      "command": "conciliate",
+      "args": ["mcp"],
+      "cwd": "C:\\path\\to\\your\\project"
+    }
+  }
+}
+```
+
+### VS Code
+
+Create `.vscode/mcp.json`:
+
+```json
+{
+  "servers": {
+    "conciliate": {
+      "command": "conciliate",
+      "args": ["mcp"],
+      "cwd": "${workspaceFolder}"
+    }
+  }
+}
+```
+
+**Then**: Restart your AI assistant → Ask: "What API endpoints are available?"
+
+### Features
+
+- 📚 **Resources**: Full spec, summaries, diffs
+- 🛠️ **Tools**: Reload, search, get endpoint details
+- ⚡ **Live Updates**: Auto-detects backend changes, no manual reload
+- 🎯 **Cross-session**: Keep frontend/backend AI assistants synchronized
+
+**Full guide**: [docs/MCP_INTEGRATION.md](docs/MCP_INTEGRATION.md)
+
+## � REST API
+
+When running `conciliate watch` or `conciliate serve`:
+
+| Endpoint | Description |
+|----------|-------------|
+| `GET /spec` | Full OpenAPI specification |
+| `GET /summary` | Human-readable summary |
+| `GET /diff` | Latest changes |
+| `POST /reload` | Trigger spec regeneration |
+
+## 🧪 Example
+
+```bash
+# Start example backend
+cd example/backend && python main.py
+
+# In another terminal
+cd ../.. && conciliate init
+# Edit .conciliate.yaml: backend_path: ./example/backend
+
+conciliate watch
+# Visit http://localhost:5678/summary
+```
+
+## 🔮 Roadmap
+
+- **v0.1.0** ✅ Core engine (watcher, spec gen, diff, REST API)
+- **v0.2.0** ✅ MCP integration with live updates
+- **v0.3.0** - VS Code extension (status bar, API explorer, inline docs)
+- **v0.4.0** - Multi-backend support (microservices, aggregated specs)
+- **v0.5.0** - Flask/Express framework support
+
+## Troubleshooting
+
+| Issue | Solution |
+|-------|----------|
+| "Failed to generate spec" | Check `backend_path` in config, verify FastAPI app exists |
+| "No .conciliate.yaml found" | Run `conciliate init` in your project directory |
+| MCP not connecting | Restart AI assistant, verify `cwd` path in config |
+
+See full troubleshooting guide in [docs/](docs/).
+
+## License
+
+MIT License - see [LICENSE](LICENSE) for details.

conciliate-0.2.0/README.md

@@ -0,0 +1,162 @@
+<p align="center">
+    <img src="assets/conciliate_brand.png" alt="Conciliate - Unified context for smarter AI decisions" />
+</p>
+
+<p align="center">
+    <a href="https://github.com/yourusername/conciliate/releases" target="_blank" rel="noopener"><img src="https://img.shields.io/github/release/yourusername/conciliate.svg" alt="Latest releases" /></a>
+    <a href="https://github.com/yourusername/conciliate/blob/main/LICENSE" target="_blank" rel="noopener"><img src="https://img.shields.io/badge/license-MIT-blue.svg" alt="MIT License" /></a>
+    <a href="https://pypi.org/project/conciliate/" target="_blank" rel="noopener"><img src="https://img.shields.io/pypi/v/conciliate.svg" alt="PyPI version" /></a>
+</p>
+
+**Unified context for smarter AI decisions.**
+
+Conciliate automatically extracts API specifications from your backend, detects changes, and streams context to AI coding assistants in real-time. Keep your AI in sync across separate IDE sessions—no more manual copy-pasting.
+
+## Features
+
+- **Auto-extraction**: Monitors backend files, generates OpenAPI specs automatically
+- **Live updates**: Real-time synchronization via MCP protocol  
+- **Three access modes**: MCP server, REST API, or CLI
+- **Framework support**: FastAPI (_Flask, Express coming soon_)
+- **AI-native**: Built for Claude Desktop, Cursor, VS Code Copilot
+- **Local-first**: No cloud dependencies, runs entirely on your machine
+
+## Quick Start
+
+### Install
+
+```bash
+pip install conciliate
+```
+
+### Setup
+
+```bash
+cd /path/to/your/project
+conciliate init
+# Edit .conciliate.yaml to set backend_path
+```
+
+### Run
+
+```bash
+conciliate mcp      # For AI assistants (recommended)
+conciliate watch    # REST API + file watching
+conciliate serve    # REST API only
+```
+
+## CLI Commands
+
+| Command | Description |
+|---------|-------------|
+| `conciliate init` | Create config file |
+| `conciliate watch` | Watch backend + serve REST API |
+| `conciliate mcp` | Run MCP server for AI assistants |
+| `conciliate summary` | Display API summary |
+| `conciliate diff` | Show recent changes |
+| `conciliate status` | Show configuration |
+
+## Configuration
+
+Create `.conciliate.yaml` in your project root:
+
+```yaml
+backend_path: ../backend    # Path to your backend
+framework: fastapi          # Backend framework (auto-detected if omitted)
+port: 5678                  # Server port
+output_dir: .conciliate     # Output directory
+```
+
+Copy from `.conciliate.yaml.template` for all available options.
+
+## � MCP Integration (AI Assistants)
+
+### Claude Desktop
+
+Edit `claude_desktop_config.json`:
+
+```json
+{
+  "mcpServers": {
+    "conciliate": {
+      "command": "conciliate",
+      "args": ["mcp"],
+      "cwd": "C:\\path\\to\\your\\project"
+    }
+  }
+}
+```
+
+### VS Code
+
+Create `.vscode/mcp.json`:
+
+```json
+{
+  "servers": {
+    "conciliate": {
+      "command": "conciliate",
+      "args": ["mcp"],
+      "cwd": "${workspaceFolder}"
+    }
+  }
+}
+```
+
+**Then**: Restart your AI assistant → Ask: "What API endpoints are available?"
+
+### Features
+
+- 📚 **Resources**: Full spec, summaries, diffs
+- 🛠️ **Tools**: Reload, search, get endpoint details
+- ⚡ **Live Updates**: Auto-detects backend changes, no manual reload
+- 🎯 **Cross-session**: Keep frontend/backend AI assistants synchronized
+
+**Full guide**: [docs/MCP_INTEGRATION.md](docs/MCP_INTEGRATION.md)
+
+## � REST API
+
+When running `conciliate watch` or `conciliate serve`:
+
+| Endpoint | Description |
+|----------|-------------|
+| `GET /spec` | Full OpenAPI specification |
+| `GET /summary` | Human-readable summary |
+| `GET /diff` | Latest changes |
+| `POST /reload` | Trigger spec regeneration |
+
+## 🧪 Example
+
+```bash
+# Start example backend
+cd example/backend && python main.py
+
+# In another terminal
+cd ../.. && conciliate init
+# Edit .conciliate.yaml: backend_path: ./example/backend
+
+conciliate watch
+# Visit http://localhost:5678/summary
+```
+
+## 🔮 Roadmap
+
+- **v0.1.0** ✅ Core engine (watcher, spec gen, diff, REST API)
+- **v0.2.0** ✅ MCP integration with live updates
+- **v0.3.0** - VS Code extension (status bar, API explorer, inline docs)
+- **v0.4.0** - Multi-backend support (microservices, aggregated specs)
+- **v0.5.0** - Flask/Express framework support
+
+## Troubleshooting
+
+| Issue | Solution |
+|-------|----------|
+| "Failed to generate spec" | Check `backend_path` in config, verify FastAPI app exists |
+| "No .conciliate.yaml found" | Run `conciliate init` in your project directory |
+| MCP not connecting | Restart AI assistant, verify `cwd` path in config |
+
+See full troubleshooting guide in [docs/](docs/).
+
+## License
+
+MIT License - see [LICENSE](LICENSE) for details.

conciliate-0.2.0/conciliate/__init__.py

@@ -0,0 +1,6 @@
+"""
+Conciliate - AI context synchronization and propagation between dev environments.
+"""
+
+__version__ = "0.2.0"
+