ai-atlasforge 1.2.3__tar.gz

ai_atlasforge-1.2.3/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2024-2026 AI-AtlasForge Contributors
+
+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.

ai_atlasforge-1.2.3/PKG-INFO

@@ -0,0 +1,324 @@
+Metadata-Version: 2.2
+Name: ai-atlasforge
+Version: 1.2.3
+Summary: Autonomous AI research and development platform powered by Claude
+License: MIT
+Project-URL: Homepage, https://github.com/DragonShadows1978/AI-AtlasForge
+Project-URL: Documentation, https://github.com/DragonShadows1978/AI-AtlasForge#readme
+Project-URL: Repository, https://github.com/DragonShadows1978/AI-AtlasForge.git
+Project-URL: Issues, https://github.com/DragonShadows1978/AI-AtlasForge/issues
+Keywords: ai,claude,autonomous,research,development
+Classifier: Development Status :: 4 - Beta
+Classifier: Environment :: Console
+Classifier: Environment :: Web Environment
+Classifier: Intended Audience :: Developers
+Classifier: License :: OSI Approved :: MIT License
+Classifier: Operating System :: POSIX :: Linux
+Classifier: Programming Language :: Python :: 3
+Classifier: Programming Language :: Python :: 3.10
+Classifier: Programming Language :: Python :: 3.11
+Classifier: Programming Language :: Python :: 3.12
+Classifier: Topic :: Scientific/Engineering :: Artificial Intelligence
+Classifier: Topic :: Software Development :: Code Generators
+Requires-Python: >=3.10
+Description-Content-Type: text/markdown
+License-File: LICENSE
+Requires-Dist: flask>=2.0.0
+Requires-Dist: flask-socketio>=5.0.0
+Requires-Dist: simple-websocket>=0.5.0
+Requires-Dist: anthropic>=0.18.0
+Requires-Dist: watchdog>=3.0.0
+Requires-Dist: psutil>=5.9.0
+Requires-Dist: numpy>=1.21.0
+Requires-Dist: scikit-learn>=1.0.0
+Provides-Extra: dev
+Requires-Dist: pytest>=7.0.0; extra == "dev"
+Requires-Dist: pytest-cov>=4.0.0; extra == "dev"
+Requires-Dist: black>=23.0.0; extra == "dev"
+Requires-Dist: flake8>=6.0.0; extra == "dev"
+Requires-Dist: mypy>=1.0.0; extra == "dev"
+Provides-Extra: tray
+Requires-Dist: PyGObject>=3.42.0; extra == "tray"
+Provides-Extra: all
+Requires-Dist: ai-atlasforge[dev,tray]; extra == "all"
+
+# AI-AtlasForge
+
+An autonomous AI research and development platform powered by Claude. Run long-duration missions, accumulate cross-session knowledge, and build software autonomously.
+
+## What is AI-AtlasForge?
+
+AI-AtlasForge is not a chatbot wrapper. It's an **autonomous research engine** that:
+
+- Runs multi-day missions without human intervention
+- Maintains mission continuity across context windows
+- Accumulates knowledge that persists across sessions
+- Self-corrects when drifting from objectives
+- Adversarially tests its own outputs
+
+## Quick Start
+
+### Prerequisites
+
+- Python 3.10+
+- Anthropic API key (get one at https://console.anthropic.com/)
+- Linux environment (tested on Ubuntu 22.04+, Debian 12+)
+
+> **Platform Notes:**
+> - **Windows:** Use WSL2 (Windows Subsystem for Linux)
+> - **macOS:** Should work but is untested. Please report issues.
+
+### Option 1: Standard Installation
+
+```bash
+# Clone the repository
+git clone https://github.com/DragonShadows1978/AI-AtlasForge.git
+cd AI-AtlasForge
+
+# Run the installer
+./install.sh
+
+# Configure your API key
+export ANTHROPIC_API_KEY='your-key-here'
+# Or edit config.yaml / .env
+
+# Verify installation
+./verify.sh
+```
+
+### Option 2: One-Liner Install
+
+```bash
+curl -sSL https://raw.githubusercontent.com/DragonShadows1978/AI-AtlasForge/main/quick_install.sh | bash
+```
+
+### Option 3: Docker Installation
+
+```bash
+git clone https://github.com/DragonShadows1978/AI-AtlasForge.git
+cd AI-AtlasForge
+docker compose up -d
+# Dashboard at http://localhost:5050
+```
+
+For detailed installation options, see [INSTALL.md](INSTALL.md) or [QUICKSTART.md](QUICKSTART.md).
+
+### Running Your First Mission
+
+1. **Start the Dashboard** (optional, for monitoring):
+   ```bash
+   make dashboard
+   # Or: python3 dashboard_v2.py
+   # Access at http://localhost:5050
+   ```
+
+2. **Create a Mission**:
+   - Via Dashboard: Click "Create Mission" and enter your objectives
+   - Via Sample: Run `make sample-mission` to load a hello-world mission
+   - Via JSON: Create `state/mission.json` manually
+
+3. **Start the Engine**:
+   ```bash
+   make run
+   # Or: python3 claude_autonomous.py --mode=rd
+   ```
+
+### Development Commands
+
+Run `make help` to see all available commands:
+
+```bash
+make install      # Full installation
+make verify       # Verify installation
+make dashboard    # Start dashboard
+make run          # Start autonomous agent
+make docker       # Start with Docker
+make sample-mission  # Load sample mission
+```
+
+## Architecture
+
+```
+                    +-------------------+
+                    |   Mission State   |
+                    |  (mission.json)   |
+                    +--------+----------+
+                             |
+              +--------------+--------------+
+              |                             |
+    +---------v---------+         +--------v--------+
+    |    AtlasForge     |         |    Dashboard    |
+    | (Execution Engine)|         |   (Monitoring)  |
+    +---------+---------+         +-----------------+
+              |
+    +---------v---------+
+    |    R&D Engine     |
+    |   (State Machine) |
+    +---------+---------+
+              |
+    +---------v-------------------+
+    |     Stage Pipeline          |
+    |                             |
+    |  PLANNING -> BUILDING ->    |
+    |  TESTING -> ANALYZING ->    |
+    |  CYCLE_END -> COMPLETE      |
+    +-----------------------------+
+```
+
+## Mission Lifecycle
+
+1. **PLANNING** - Understand objectives, research codebase, create implementation plan
+2. **BUILDING** - Implement the solution
+3. **TESTING** - Validate implementation
+4. **ANALYZING** - Evaluate results, identify issues
+5. **CYCLE_END** - Generate reports, prepare continuation
+6. **COMPLETE** - Mission finished
+
+Missions can iterate through multiple cycles until success criteria are met.
+
+## Core Components
+
+### atlasforge.py
+Main execution loop. Spawns Claude instances, manages state, handles graceful shutdown.
+
+### af_engine.py
+State machine for mission execution. Manages stages, enforces constraints, tracks progress.
+
+### dashboard_v2.py
+Web-based monitoring interface showing mission status, knowledge base, and analytics.
+
+### Knowledge Base
+SQLite database accumulating learnings across all missions:
+- Techniques discovered
+- Insights gained
+- Gotchas encountered
+- Reusable code patterns
+
+### Adversarial Testing
+Separate Claude instances that test implementations:
+- RedTeam agents with no implementation knowledge
+- Mutation testing
+- Property-based testing
+
+### GlassBox
+Post-mission introspection system:
+- Transcript parsing
+- Agent hierarchy reconstruction
+- Stage timeline visualization
+
+## Key Features
+
+### Display Layer (Windows)
+Visual environment for graphical application testing:
+- Screenshot capture from virtual display
+- Web-accessible display via noVNC (localhost:6080)
+- Web terminal via ttyd (localhost:7681)
+- Browser support for OAuth flows and web testing
+- Automatic GPU detection with software fallback
+
+See [docs/DISPLAY_LAYER.md](workspace/docs/DISPLAY_LAYER.md) for the user guide.
+
+### Mission Continuity
+Missions survive context window limits through:
+- Persistent mission.json state
+- Cycle-based iteration
+- Continuation prompts that preserve context
+
+### Knowledge Accumulation
+Every mission adds to the knowledge base. The system improves over time as it learns patterns, gotchas, and techniques.
+
+### Autonomous Operation
+Designed for unattended execution:
+- Graceful crash recovery
+- Stage checkpointing
+- Automatic cycle progression
+
+## Directory Structure
+
+```
+AI-AtlasForge/
++-- atlasforge.py           # Main entry point
++-- af_engine.py            # Stage state machine
++-- dashboard_v2.py         # Web dashboard
++-- adversarial_testing/    # Testing framework
++-- atlasforge_enhancements/  # Enhancement modules
++-- workspace/              # Active workspace
+|   +-- glassbox/           # Introspection tools
+|   +-- artifacts/          # Plans, reports
+|   +-- research/           # Notes, findings
+|   +-- tests/              # Test scripts
++-- state/                  # Runtime state
+|   +-- mission.json        # Current mission
+|   +-- claude_state.json   # Execution state
++-- missions/               # Mission workspaces
++-- atlasforge_data/
+|   +-- knowledge_base/     # Accumulated learnings
++-- logs/                   # Execution logs
+```
+
+## Configuration
+
+AI-AtlasForge uses environment variables for configuration:
+
+| Variable | Default | Description |
+|----------|---------|-------------|
+| `ATLASFORGE_PORT` | `5050` | Dashboard port |
+| `ATLASFORGE_ROOT` | (script directory) | Base directory |
+| `ATLASFORGE_DEBUG` | `false` | Enable debug logging |
+
+## Dashboard Features
+
+The web dashboard provides real-time monitoring:
+
+- **Mission Status** - Current stage, progress, timing
+- **Activity Feed** - Live log of agent actions
+- **Knowledge Base** - Search and browse learnings
+- **Analytics** - Token usage, cost tracking
+- **Mission Queue** - Queue and schedule missions
+- **GlassBox** - Post-mission analysis
+
+## Philosophy
+
+**First principles only.** No frameworks hiding integration failures. Every component built from scratch for full visibility.
+
+**Speed of machine, not human.** Designed for autonomous operation. Check in when convenient, not when required.
+
+**Knowledge accumulates.** Every mission adds to the knowledge base. The system gets better over time.
+
+**Trust but verify.** Adversarial testing catches what regular testing misses. The same agent that writes code doesn't validate it.
+
+## Requirements
+
+- Python 3.10+
+- Node.js 18+ (optional, for dashboard JS modifications)
+- Anthropic API key
+- Linux environment (Ubuntu 22.04+, Debian 12+)
+
+### Python Dependencies
+
+See `requirements.txt` or `pyproject.toml` for full list.
+
+## Documentation
+
+- [QUICKSTART.md](QUICKSTART.md) - Get started in 5 minutes
+- [INSTALL.md](INSTALL.md) - Detailed installation guide
+- [USAGE.md](USAGE.md) - How to use AI-AtlasForge
+- [ARCHITECTURE.md](ARCHITECTURE.md) - System architecture
+- [DISPLAY_LAYER.md](workspace/docs/DISPLAY_LAYER.md) - Display Layer user guide (Windows)
+- [TROUBLESHOOTING.md](workspace/docs/TROUBLESHOOTING.md) - Display Layer troubleshooting
+
+## License
+
+MIT License - see [LICENSE](LICENSE) for details.
+
+## Contributing
+
+Contributions are welcome! Please feel free to submit issues and pull requests.
+
+## Related Projects
+
+- **[AI-AfterImage](https://github.com/DragonShadows1978/AI-AfterImage)** - Episodic memory for AI coding agents. Gives Claude Code persistent memory of code it has written across sessions. Works great with AtlasForge for cross-mission code recall.
+
+## Acknowledgments
+
+Built on Claude by Anthropic. Special thanks to the Claude Code team for making autonomous AI development possible.

ai_atlasforge-1.2.3/README.md

@@ -0,0 +1,280 @@
+# AI-AtlasForge
+
+An autonomous AI research and development platform powered by Claude. Run long-duration missions, accumulate cross-session knowledge, and build software autonomously.
+
+## What is AI-AtlasForge?
+
+AI-AtlasForge is not a chatbot wrapper. It's an **autonomous research engine** that:
+
+- Runs multi-day missions without human intervention
+- Maintains mission continuity across context windows
+- Accumulates knowledge that persists across sessions
+- Self-corrects when drifting from objectives
+- Adversarially tests its own outputs
+
+## Quick Start
+
+### Prerequisites
+
+- Python 3.10+
+- Anthropic API key (get one at https://console.anthropic.com/)
+- Linux environment (tested on Ubuntu 22.04+, Debian 12+)
+
+> **Platform Notes:**
+> - **Windows:** Use WSL2 (Windows Subsystem for Linux)
+> - **macOS:** Should work but is untested. Please report issues.
+
+### Option 1: Standard Installation
+
+```bash
+# Clone the repository
+git clone https://github.com/DragonShadows1978/AI-AtlasForge.git
+cd AI-AtlasForge
+
+# Run the installer
+./install.sh
+
+# Configure your API key
+export ANTHROPIC_API_KEY='your-key-here'
+# Or edit config.yaml / .env
+
+# Verify installation
+./verify.sh
+```
+
+### Option 2: One-Liner Install
+
+```bash
+curl -sSL https://raw.githubusercontent.com/DragonShadows1978/AI-AtlasForge/main/quick_install.sh | bash
+```
+
+### Option 3: Docker Installation
+
+```bash
+git clone https://github.com/DragonShadows1978/AI-AtlasForge.git
+cd AI-AtlasForge
+docker compose up -d
+# Dashboard at http://localhost:5050
+```
+
+For detailed installation options, see [INSTALL.md](INSTALL.md) or [QUICKSTART.md](QUICKSTART.md).
+
+### Running Your First Mission
+
+1. **Start the Dashboard** (optional, for monitoring):
+   ```bash
+   make dashboard
+   # Or: python3 dashboard_v2.py
+   # Access at http://localhost:5050
+   ```
+
+2. **Create a Mission**:
+   - Via Dashboard: Click "Create Mission" and enter your objectives
+   - Via Sample: Run `make sample-mission` to load a hello-world mission
+   - Via JSON: Create `state/mission.json` manually
+
+3. **Start the Engine**:
+   ```bash
+   make run
+   # Or: python3 claude_autonomous.py --mode=rd
+   ```
+
+### Development Commands
+
+Run `make help` to see all available commands:
+
+```bash
+make install      # Full installation
+make verify       # Verify installation
+make dashboard    # Start dashboard
+make run          # Start autonomous agent
+make docker       # Start with Docker
+make sample-mission  # Load sample mission
+```
+
+## Architecture
+
+```
+                    +-------------------+
+                    |   Mission State   |
+                    |  (mission.json)   |
+                    +--------+----------+
+                             |
+              +--------------+--------------+
+              |                             |
+    +---------v---------+         +--------v--------+
+    |    AtlasForge     |         |    Dashboard    |
+    | (Execution Engine)|         |   (Monitoring)  |
+    +---------+---------+         +-----------------+
+              |
+    +---------v---------+
+    |    R&D Engine     |
+    |   (State Machine) |
+    +---------+---------+
+              |
+    +---------v-------------------+
+    |     Stage Pipeline          |
+    |                             |
+    |  PLANNING -> BUILDING ->    |
+    |  TESTING -> ANALYZING ->    |
+    |  CYCLE_END -> COMPLETE      |
+    +-----------------------------+
+```
+
+## Mission Lifecycle
+
+1. **PLANNING** - Understand objectives, research codebase, create implementation plan
+2. **BUILDING** - Implement the solution
+3. **TESTING** - Validate implementation
+4. **ANALYZING** - Evaluate results, identify issues
+5. **CYCLE_END** - Generate reports, prepare continuation
+6. **COMPLETE** - Mission finished
+
+Missions can iterate through multiple cycles until success criteria are met.
+
+## Core Components
+
+### atlasforge.py
+Main execution loop. Spawns Claude instances, manages state, handles graceful shutdown.
+
+### af_engine.py
+State machine for mission execution. Manages stages, enforces constraints, tracks progress.
+
+### dashboard_v2.py
+Web-based monitoring interface showing mission status, knowledge base, and analytics.
+
+### Knowledge Base
+SQLite database accumulating learnings across all missions:
+- Techniques discovered
+- Insights gained
+- Gotchas encountered
+- Reusable code patterns
+
+### Adversarial Testing
+Separate Claude instances that test implementations:
+- RedTeam agents with no implementation knowledge
+- Mutation testing
+- Property-based testing
+
+### GlassBox
+Post-mission introspection system:
+- Transcript parsing
+- Agent hierarchy reconstruction
+- Stage timeline visualization
+
+## Key Features
+
+### Display Layer (Windows)
+Visual environment for graphical application testing:
+- Screenshot capture from virtual display
+- Web-accessible display via noVNC (localhost:6080)
+- Web terminal via ttyd (localhost:7681)
+- Browser support for OAuth flows and web testing
+- Automatic GPU detection with software fallback
+
+See [docs/DISPLAY_LAYER.md](workspace/docs/DISPLAY_LAYER.md) for the user guide.
+
+### Mission Continuity
+Missions survive context window limits through:
+- Persistent mission.json state
+- Cycle-based iteration
+- Continuation prompts that preserve context
+
+### Knowledge Accumulation
+Every mission adds to the knowledge base. The system improves over time as it learns patterns, gotchas, and techniques.
+
+### Autonomous Operation
+Designed for unattended execution:
+- Graceful crash recovery
+- Stage checkpointing
+- Automatic cycle progression
+
+## Directory Structure
+
+```
+AI-AtlasForge/
++-- atlasforge.py           # Main entry point
++-- af_engine.py            # Stage state machine
++-- dashboard_v2.py         # Web dashboard
++-- adversarial_testing/    # Testing framework
++-- atlasforge_enhancements/  # Enhancement modules
++-- workspace/              # Active workspace
+|   +-- glassbox/           # Introspection tools
+|   +-- artifacts/          # Plans, reports
+|   +-- research/           # Notes, findings
+|   +-- tests/              # Test scripts
++-- state/                  # Runtime state
+|   +-- mission.json        # Current mission
+|   +-- claude_state.json   # Execution state
++-- missions/               # Mission workspaces
++-- atlasforge_data/
+|   +-- knowledge_base/     # Accumulated learnings
++-- logs/                   # Execution logs
+```
+
+## Configuration
+
+AI-AtlasForge uses environment variables for configuration:
+
+| Variable | Default | Description |
+|----------|---------|-------------|
+| `ATLASFORGE_PORT` | `5050` | Dashboard port |
+| `ATLASFORGE_ROOT` | (script directory) | Base directory |
+| `ATLASFORGE_DEBUG` | `false` | Enable debug logging |
+
+## Dashboard Features
+
+The web dashboard provides real-time monitoring:
+
+- **Mission Status** - Current stage, progress, timing
+- **Activity Feed** - Live log of agent actions
+- **Knowledge Base** - Search and browse learnings
+- **Analytics** - Token usage, cost tracking
+- **Mission Queue** - Queue and schedule missions
+- **GlassBox** - Post-mission analysis
+
+## Philosophy
+
+**First principles only.** No frameworks hiding integration failures. Every component built from scratch for full visibility.
+
+**Speed of machine, not human.** Designed for autonomous operation. Check in when convenient, not when required.
+
+**Knowledge accumulates.** Every mission adds to the knowledge base. The system gets better over time.
+
+**Trust but verify.** Adversarial testing catches what regular testing misses. The same agent that writes code doesn't validate it.
+
+## Requirements
+
+- Python 3.10+
+- Node.js 18+ (optional, for dashboard JS modifications)
+- Anthropic API key
+- Linux environment (Ubuntu 22.04+, Debian 12+)
+
+### Python Dependencies
+
+See `requirements.txt` or `pyproject.toml` for full list.
+
+## Documentation
+
+- [QUICKSTART.md](QUICKSTART.md) - Get started in 5 minutes
+- [INSTALL.md](INSTALL.md) - Detailed installation guide
+- [USAGE.md](USAGE.md) - How to use AI-AtlasForge
+- [ARCHITECTURE.md](ARCHITECTURE.md) - System architecture
+- [DISPLAY_LAYER.md](workspace/docs/DISPLAY_LAYER.md) - Display Layer user guide (Windows)
+- [TROUBLESHOOTING.md](workspace/docs/TROUBLESHOOTING.md) - Display Layer troubleshooting
+
+## License
+
+MIT License - see [LICENSE](LICENSE) for details.
+
+## Contributing
+
+Contributions are welcome! Please feel free to submit issues and pull requests.
+
+## Related Projects
+
+- **[AI-AfterImage](https://github.com/DragonShadows1978/AI-AfterImage)** - Episodic memory for AI coding agents. Gives Claude Code persistent memory of code it has written across sessions. Works great with AtlasForge for cross-mission code recall.
+
+## Acknowledgments
+
+Built on Claude by Anthropic. Special thanks to the Claude Code team for making autonomous AI development possible.