aurora-actr 0.3.1__tar.gz → 0.9.4__tar.gz

aurora_actr-0.9.4/PKG-INFO

@@ -0,0 +1,288 @@
+Metadata-Version: 2.4
+Name: aurora-actr
+Version: 0.9.4
+Summary: AURORA: Adaptive Unified Reasoning and Orchestration Architecture with MCP Integration
+Author-email: AURORA Team <aurora@example.com>
+License-Expression: MIT
+Project-URL: Homepage, https://github.com/hamr/aurora
+Project-URL: Documentation, https://github.com/hamr/aurora/blob/main/README.md
+Project-URL: Repository, https://github.com/hamr/aurora
+Project-URL: Issues, https://github.com/hamr/aurora/issues
+Project-URL: Changelog, https://github.com/hamr/aurora/blob/main/CHANGELOG.md
+Keywords: aurora,actr,cognitive-architecture,semantic-search,mcp,reasoning,soar
+Classifier: Development Status :: 3 - Alpha
+Classifier: Intended Audience :: Developers
+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 :: Software Development :: Libraries :: Python Modules
+Classifier: Topic :: Scientific/Engineering :: Artificial Intelligence
+Requires-Python: >=3.10
+Description-Content-Type: text/markdown
+Requires-Dist: pydantic>=2.0.0
+Requires-Dist: jsonschema>=4.17.0
+Requires-Dist: click>=8.1.0
+Requires-Dist: rich>=13.0.0
+Requires-Dist: python-frontmatter>=1.0.0
+Requires-Dist: jinja2>=3.1.0
+Requires-Dist: python-slugify>=8.0.0
+Requires-Dist: questionary>=2.0.0
+Requires-Dist: pyyaml>=6.0.0
+Requires-Dist: tree-sitter>=0.20.0
+Requires-Dist: tree-sitter-python>=0.20.0
+Requires-Dist: numpy>=1.24.0
+Requires-Dist: anthropic>=0.18.0
+Requires-Dist: openai>=1.0.0
+Requires-Dist: ollama>=0.1.0
+Requires-Dist: tenacity>=8.2.0
+Requires-Dist: fastmcp>=0.1.0
+Provides-Extra: dev
+Requires-Dist: pytest>=7.4.0; extra == "dev"
+Requires-Dist: pytest-cov>=4.1.0; extra == "dev"
+Requires-Dist: pytest-asyncio>=0.21.0; extra == "dev"
+Requires-Dist: pytest-benchmark>=4.0.0; extra == "dev"
+Requires-Dist: ruff>=0.1.0; extra == "dev"
+Requires-Dist: mypy>=1.5.0; extra == "dev"
+Requires-Dist: types-jsonschema>=4.0.0; extra == "dev"
+Requires-Dist: bandit>=1.7.5; extra == "dev"
+Requires-Dist: memory-profiler>=0.61.0; extra == "dev"
+
+<div align="center">
+
+<pre>
+   █████╗ ██╗   ██╗██████╗  ██████╗ ██████╗  █████╗
+  ██╔══██╗██║   ██║██╔══██╗██╔═══██╗██╔══██╗██╔══██╗
+  ███████║██║   ██║██████╔╝██║   ██║██████╔╝███████║
+  ██╔══██║██║   ██║██╔══██╗██║   ██║██╔══██╗██╔══██║
+  ██║  ██║╚██████╔╝██║  ██║╚██████╔╝██║  ██║██║  ██║
+  ╚═╝  ╚═╝ ╚═════╝ ╚═╝  ╚═╝ ╚═════╝ ╚═╝  ╚═╝╚═╝  ╚═╝
+ ┳┳┓┏┓┳┳┓┏┓┳┓┓┏  ┏┓┓ ┏┏┓┳┓┏┓  ┏┓┳┓┏┓┳┳┓┏┓┓ ┏┏┓┳┓┓┏
+ ┃┃┃┣ ┃┃┃┃┃┣┫┗┫━━┣┫┃┃┃┣┫┣┫┣ ━━┣ ┣┫┣┫┃┃┃┣ ┃┃┃┃┃┣┫┃┫
+ ┛ ┗┗┛┛ ┗┗┛┛┗┗┛  ┛┗┗┻┛┛┗┛┗┗┛  ┻ ┛┗┛┗┛ ┗┗┛┗┻┛┗┛┛┗┛┗
+Planning & Multi-Agent Orchestration
+</pre>
+
+[![Python 3.10+](https://img.shields.io/badge/python-3.10+-blue.svg)](https://www.python.org/downloads/)
+[![License: MIT](https://img.shields.io/badge/License-MIT-yellow.svg)](https://opensource.org/licenses/MIT)
+[![PyPI version](https://img.shields.io/pypi/v/aurora-actr.svg)](https://pypi.org/project/aurora-actr/)
+
+</div>
+
+---
+
+## Summary
+
+### Aurora - Memory-aware Planning & Multi-Agent Orchestration Framework
+
+- **LLM-agnostic** - No API keys, works with 20+ CLI tools (Claude Code, Cursor, Aider, etc.)
+- **Smart Memory** - ACT-R activation decay, BM25, tree-sitter/cAST, git signals
+- **Memory-Aware Planning** - Decompose goals, assign agents, detect capability gaps
+- **Memory-Aware Research** - Multi-agent orchestration with recovery and state
+- **Task Execution** - Stop gates for feature creep and dangerous commands
+- **Headless Mode** - Isolated branch execution with max retries
+- **Session Checkpoints** - Save and resume session context
+
+```bash
+# PyPI
+pip install aurora-actr
+
+# From source
+git clone https://github.com/amrhas82/aurora.git
+cd aurora && ./install.sh
+```
+
+---
+
+## Core Features
+
+### Smart Memory (Slash Commands)
+
+`aur:search` - Memory with activation decay from ACT-R. Indexes your code using:
+
+- **BM25** - Keyword search
+- **Git signals** - Recent changes rank higher
+- **Tree-sitter/cAST** - Code stored as class/method (Python, TypeScript, Java)
+- **Markdown indexing** - Search docs, save tokens
+
+```bash
+# Terminal
+aur mem index .
+aur mem search "authentication"
+
+# Slash command
+/aur:search "authentication"
+/aur:get 1  # Read chunk
+```
+
+---
+
+### Memory-Aware Planning (Terminal)
+
+`aur goals` - Decomposes any goal into subgoals:
+
+1. Looks up existing memory for matches
+2. Breaks down into subgoals
+3. Assigns your existing subagents to each subgoal
+4. Detects capability gaps - tells you what agents to create
+
+Works across any domain (code, writing, research).
+
+```bash
+$ aur goals "Add payment processing"
+
+Memory matches: 3 files found
+Subgoals: 4
+  sg-1: Set up Stripe SDK (@code-developer)
+  sg-2: Create payment endpoints (@code-developer)
+  sg-3: Implement checkout UI (@ui-designer)
+  sg-4: Configure PCI compliance (@security-engineer -> NOT FOUND)
+
+Gaps detected:
+  - Missing @security-engineer
+```
+
+---
+
+### Memory-Aware Research (Terminal)
+
+`aur soar` - Research questions using your codebase:
+
+1. Looks up existing memory for matches
+2. Decomposes question into sub-questions
+3. Utilizes existing subagents
+4. Spawns agents on the fly
+5. Simple multi-orchestration with agent recovery (stateful)
+
+```bash
+aur soar "How does the payment flow work?"
+```
+
+---
+
+### Task Execution (Terminal)
+
+`aur spawn` - Takes predefined task list and executes with:
+
+- Stop gates for feature creep
+- Dangerous command detection (rm -rf, etc.)
+- Budget limits
+
+```bash
+aur spawn tasks.md --verbose
+```
+
+---
+
+### Headless Mode (Terminal)
+
+`aur headless` - Ralph Wiggum mode:
+
+- Runs in isolated branch
+- Max retries on failure
+- Unattended execution
+
+```bash
+aur headless prompt.md
+```
+
+---
+
+### Checkpoints (Slash Command)
+
+`aur:checkpoint` - Create digest of current session to resume later.
+
+```bash
+/aur:checkpoint
+
+# Output: .aurora/checkpoints/session-2026-01-15.md
+# Contains: goals, progress, decisions, next steps
+```
+
+---
+
+## Planning Workflow
+
+OpenSpec-based flow from goal to implementation:
+
+```
+Terminal                    Slash Command            Slash Command
+┌─────────────────┐        ┌─────────────────┐      ┌─────────────────┐
+│   aur goals     │   ->   │  /aur:plan      │  ->  │  /aur:implement │
+│   "Add feature" │        │  goals.json     │      │                 │
+└─────────────────┘        └─────────────────┘      └─────────────────┘
+        │                          │                        │
+        v                          v                        v
+   goals.json               PRD + tasks.md            Implemented
+   - subgoals               - specs/                  - checkpoints
+   - agent assignments      - file hints              - validation
+   - capability gaps
+```
+
+---
+
+## Quick Start
+
+```bash
+# Install
+pip install aurora-actr
+
+# Initialize project
+cd your-project/
+aur init
+
+# Index codebase for memory
+aur mem index .
+
+# Plan with memory context
+aur goals "Add user authentication"
+
+# In your CLI tool (Claude Code, Cursor, etc.):
+/aur:plan goals.json
+/aur:implement
+```
+
+---
+
+## Commands Reference
+
+| Command | Type | Description |
+|---------|------|-------------|
+| `aur init` | Terminal | Initialize Aurora in project |
+| `aur doctor` | Terminal | Check installation and dependencies |
+| `aur mem index .` | Terminal | Index codebase |
+| `aur mem search "query"` | Terminal | Search memory |
+| `aur goals "goal"` | Terminal | Memory-aware planning |
+| `aur soar "question"` | Terminal | Memory-aware research |
+| `aur spawn tasks.md` | Terminal | Execute with safeguards |
+| `aur headless prompt.md` | Terminal | Unattended execution |
+| `/aur:search "query"` | Slash | Search indexed memory |
+| `/aur:get N` | Slash | Read chunk from search |
+| `/aur:plan goals.json` | Slash | Generate PRD + tasks |
+| `/aur:implement` | Slash | Execute plan |
+| `/aur:checkpoint` | Slash | Save session context |
+| `/aur:archive plan-id` | Slash | Archive completed plan |
+
+---
+
+## Supported Tools
+
+Works with 20+ CLI tools: Claude Code, Cursor, Aider, Cline, Windsurf, Gemini CLI, and more.
+
+```bash
+aur init --tools=claude,cursor
+```
+
+---
+
+## Documentation
+
+- [Commands Reference](docs/guides/COMMANDS.md)
+- [Tools Guide](docs/guides/TOOLS_GUIDE.md)
+- [Flows Guide](docs/guides/FLOWS.md)
+
+---
+
+## License
+
+MIT License - See [LICENSE](LICENSE)

aurora_actr-0.9.4/README.md

@@ -0,0 +1,238 @@
+<div align="center">
+
+<pre>
+   █████╗ ██╗   ██╗██████╗  ██████╗ ██████╗  █████╗
+  ██╔══██╗██║   ██║██╔══██╗██╔═══██╗██╔══██╗██╔══██╗
+  ███████║██║   ██║██████╔╝██║   ██║██████╔╝███████║
+  ██╔══██║██║   ██║██╔══██╗██║   ██║██╔══██╗██╔══██║
+  ██║  ██║╚██████╔╝██║  ██║╚██████╔╝██║  ██║██║  ██║
+  ╚═╝  ╚═╝ ╚═════╝ ╚═╝  ╚═╝ ╚═════╝ ╚═╝  ╚═╝╚═╝  ╚═╝
+ ┳┳┓┏┓┳┳┓┏┓┳┓┓┏  ┏┓┓ ┏┏┓┳┓┏┓  ┏┓┳┓┏┓┳┳┓┏┓┓ ┏┏┓┳┓┓┏
+ ┃┃┃┣ ┃┃┃┃┃┣┫┗┫━━┣┫┃┃┃┣┫┣┫┣ ━━┣ ┣┫┣┫┃┃┃┣ ┃┃┃┃┃┣┫┃┫
+ ┛ ┗┗┛┛ ┗┗┛┛┗┗┛  ┛┗┗┻┛┛┗┛┗┗┛  ┻ ┛┗┛┗┛ ┗┗┛┗┻┛┗┛┛┗┛┗
+Planning & Multi-Agent Orchestration
+</pre>
+
+[![Python 3.10+](https://img.shields.io/badge/python-3.10+-blue.svg)](https://www.python.org/downloads/)
+[![License: MIT](https://img.shields.io/badge/License-MIT-yellow.svg)](https://opensource.org/licenses/MIT)
+[![PyPI version](https://img.shields.io/pypi/v/aurora-actr.svg)](https://pypi.org/project/aurora-actr/)
+
+</div>
+
+---
+
+## Summary
+
+### Aurora - Memory-aware Planning & Multi-Agent Orchestration Framework
+
+- **LLM-agnostic** - No API keys, works with 20+ CLI tools (Claude Code, Cursor, Aider, etc.)
+- **Smart Memory** - ACT-R activation decay, BM25, tree-sitter/cAST, git signals
+- **Memory-Aware Planning** - Decompose goals, assign agents, detect capability gaps
+- **Memory-Aware Research** - Multi-agent orchestration with recovery and state
+- **Task Execution** - Stop gates for feature creep and dangerous commands
+- **Headless Mode** - Isolated branch execution with max retries
+- **Session Checkpoints** - Save and resume session context
+
+```bash
+# PyPI
+pip install aurora-actr
+
+# From source
+git clone https://github.com/amrhas82/aurora.git
+cd aurora && ./install.sh
+```
+
+---
+
+## Core Features
+
+### Smart Memory (Slash Commands)
+
+`aur:search` - Memory with activation decay from ACT-R. Indexes your code using:
+
+- **BM25** - Keyword search
+- **Git signals** - Recent changes rank higher
+- **Tree-sitter/cAST** - Code stored as class/method (Python, TypeScript, Java)
+- **Markdown indexing** - Search docs, save tokens
+
+```bash
+# Terminal
+aur mem index .
+aur mem search "authentication"
+
+# Slash command
+/aur:search "authentication"
+/aur:get 1  # Read chunk
+```
+
+---
+
+### Memory-Aware Planning (Terminal)
+
+`aur goals` - Decomposes any goal into subgoals:
+
+1. Looks up existing memory for matches
+2. Breaks down into subgoals
+3. Assigns your existing subagents to each subgoal
+4. Detects capability gaps - tells you what agents to create
+
+Works across any domain (code, writing, research).
+
+```bash
+$ aur goals "Add payment processing"
+
+Memory matches: 3 files found
+Subgoals: 4
+  sg-1: Set up Stripe SDK (@code-developer)
+  sg-2: Create payment endpoints (@code-developer)
+  sg-3: Implement checkout UI (@ui-designer)
+  sg-4: Configure PCI compliance (@security-engineer -> NOT FOUND)
+
+Gaps detected:
+  - Missing @security-engineer
+```
+
+---
+
+### Memory-Aware Research (Terminal)
+
+`aur soar` - Research questions using your codebase:
+
+1. Looks up existing memory for matches
+2. Decomposes question into sub-questions
+3. Utilizes existing subagents
+4. Spawns agents on the fly
+5. Simple multi-orchestration with agent recovery (stateful)
+
+```bash
+aur soar "How does the payment flow work?"
+```
+
+---
+
+### Task Execution (Terminal)
+
+`aur spawn` - Takes predefined task list and executes with:
+
+- Stop gates for feature creep
+- Dangerous command detection (rm -rf, etc.)
+- Budget limits
+
+```bash
+aur spawn tasks.md --verbose
+```
+
+---
+
+### Headless Mode (Terminal)
+
+`aur headless` - Ralph Wiggum mode:
+
+- Runs in isolated branch
+- Max retries on failure
+- Unattended execution
+
+```bash
+aur headless prompt.md
+```
+
+---
+
+### Checkpoints (Slash Command)
+
+`aur:checkpoint` - Create digest of current session to resume later.
+
+```bash
+/aur:checkpoint
+
+# Output: .aurora/checkpoints/session-2026-01-15.md
+# Contains: goals, progress, decisions, next steps
+```
+
+---
+
+## Planning Workflow
+
+OpenSpec-based flow from goal to implementation:
+
+```
+Terminal                    Slash Command            Slash Command
+┌─────────────────┐        ┌─────────────────┐      ┌─────────────────┐
+│   aur goals     │   ->   │  /aur:plan      │  ->  │  /aur:implement │
+│   "Add feature" │        │  goals.json     │      │                 │
+└─────────────────┘        └─────────────────┘      └─────────────────┘
+        │                          │                        │
+        v                          v                        v
+   goals.json               PRD + tasks.md            Implemented
+   - subgoals               - specs/                  - checkpoints
+   - agent assignments      - file hints              - validation
+   - capability gaps
+```
+
+---
+
+## Quick Start
+
+```bash
+# Install
+pip install aurora-actr
+
+# Initialize project
+cd your-project/
+aur init
+
+# Index codebase for memory
+aur mem index .
+
+# Plan with memory context
+aur goals "Add user authentication"
+
+# In your CLI tool (Claude Code, Cursor, etc.):
+/aur:plan goals.json
+/aur:implement
+```
+
+---
+
+## Commands Reference
+
+| Command | Type | Description |
+|---------|------|-------------|
+| `aur init` | Terminal | Initialize Aurora in project |
+| `aur doctor` | Terminal | Check installation and dependencies |
+| `aur mem index .` | Terminal | Index codebase |
+| `aur mem search "query"` | Terminal | Search memory |
+| `aur goals "goal"` | Terminal | Memory-aware planning |
+| `aur soar "question"` | Terminal | Memory-aware research |
+| `aur spawn tasks.md` | Terminal | Execute with safeguards |
+| `aur headless prompt.md` | Terminal | Unattended execution |
+| `/aur:search "query"` | Slash | Search indexed memory |
+| `/aur:get N` | Slash | Read chunk from search |
+| `/aur:plan goals.json` | Slash | Generate PRD + tasks |
+| `/aur:implement` | Slash | Execute plan |
+| `/aur:checkpoint` | Slash | Save session context |
+| `/aur:archive plan-id` | Slash | Archive completed plan |
+
+---
+
+## Supported Tools
+
+Works with 20+ CLI tools: Claude Code, Cursor, Aider, Cline, Windsurf, Gemini CLI, and more.
+
+```bash
+aur init --tools=claude,cursor
+```
+
+---
+
+## Documentation
+
+- [Commands Reference](docs/guides/COMMANDS.md)
+- [Tools Guide](docs/guides/TOOLS_GUIDE.md)
+- [Flows Guide](docs/guides/FLOWS.md)
+
+---
+
+## License
+
+MIT License - See [LICENSE](LICENSE)

{aurora_actr-0.3.1 → aurora_actr-0.9.4}/pyproject.toml

@@ -4,7 +4,7 @@ build-backend = "setuptools.build_meta"
 
 [project]
 name = "aurora-actr"
-version = "0.3.1"
+version = "0.9.4"
 description = "AURORA: Adaptive Unified Reasoning and Orchestration Architecture with MCP Integration"
 readme = "README.md"
 requires-python = ">=3.10"
@@ -24,41 +24,54 @@ classifiers = [
     "Topic :: Scientific/Engineering :: Artificial Intelligence",
 ]
 
+# All packages bundled - ~5MB total
 dependencies = [
-    "aurora-core",
-    "aurora-context-code",
-    "aurora-soar",
-    "aurora-reasoning",
-    "aurora-cli",
-    "aurora-testing",
-    "aurora-planning",
+    # Core dependencies
+    "pydantic>=2.0.0",
+    "jsonschema>=4.17.0",
+
+    # CLI dependencies
+    "click>=8.1.0",
+    "rich>=13.0.0",
+    "python-frontmatter>=1.0.0",
+    "jinja2>=3.1.0",
+    "python-slugify>=8.0.0",
+    "questionary>=2.0.0",
+    "pyyaml>=6.0.0",
+
+    # Context/code analysis dependencies
+    "tree-sitter>=0.20.0",
+    "tree-sitter-python>=0.20.0",
+    "numpy>=1.24.0",
+
+    # Reasoning dependencies
+    "anthropic>=0.18.0",
+    "openai>=1.0.0",
+    "ollama>=0.1.0",
+    "tenacity>=8.2.0",
+
+    # MCP integration
+    "fastmcp>=0.1.0",
 ]
 
 [project.urls]
-Homepage = "https://github.com/yourusername/aurora"
-Documentation = "https://github.com/yourusername/aurora/blob/main/README.md"
-Repository = "https://github.com/yourusername/aurora"
-Issues = "https://github.com/yourusername/aurora/issues"
-Changelog = "https://github.com/yourusername/aurora/blob/main/CHANGELOG.md"
+Homepage = "https://github.com/hamr/aurora"
+Documentation = "https://github.com/hamr/aurora/blob/main/README.md"
+Repository = "https://github.com/hamr/aurora"
+Issues = "https://github.com/hamr/aurora/issues"
+Changelog = "https://github.com/hamr/aurora/blob/main/CHANGELOG.md"
 
 [project.scripts]
 aur = "aurora_cli.main:cli"
-aurora-mcp = "aurora.mcp.server:main"
-aurora-uninstall = "aurora.scripts.uninstall:main"
+aurora = "aurora_cli.main:cli"
+aurora-mcp = "aurora_mcp.server:main"
 
 [project.optional-dependencies]
-ml = [
-    "sentence-transformers>=2.2.0",
-    "torch>=2.0.0",
-]
-mcp = [
-    "fastmcp>=0.1.0",
-]
-all = [
-    "sentence-transformers>=2.2.0",
-    "torch>=2.0.0",
-    "fastmcp>=0.1.0",
-]
+# Note: ML features (semantic search) are optional and auto-detected.
+# If you want semantic embeddings, manually install: pip install sentence-transformers torch
+# Aurora works fine without them using BM25 + ACT-R only.
+
+# Dev: Testing and development tools (contributors only)
 dev = [
     "pytest>=7.4.0",
     "pytest-cov>=4.1.0",
@@ -69,7 +82,6 @@ dev = [
     "types-jsonschema>=4.0.0",
     "bandit>=1.7.5",
     "memory-profiler>=0.61.0",
-    "aurora-testing",
 ]
 
 # Tool configurations