Skip to content
Merged
Show file tree
Hide file tree
Changes from all commits
Commits
File filter

Filter by extension

Filter by extension

Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
28 changes: 14 additions & 14 deletions docs/root-guides/AGENT_QUICKSTART.md
Original file line number Diff line number Diff line change
Expand Up @@ -310,16 +310,16 @@ MIN_TEST_PASSING_RATE = 0.8 # 80% tests must pass

## Supported Task Types

| Category | Example | Risk |
| Category | Example | Risk |
| ------------- | -------------------------------- | ------ |
| Bug Fix | "Fix failing test_chat.py" | Medium |
| Feature | "Add OAuth2 support" | High |
| Refactor | "Extract common code to utility" | Medium |
| Test | "Add unit tests for edge cases" | Low |
| Security | "Validate user inputs" | High |
| Documentation | "Add docstrings to module" | Low |
| Performance | "Optimize database queries" | Medium |
| Cleanup | "Remove unused imports" | Low |
| Bug Fix | "Fix failing test_chat.py" | Medium |
| Feature | "Add OAuth2 support" | High |
| Refactor | "Extract common code to utility" | Medium |
| Test | "Add unit tests for edge cases" | Low |
| Security | "Validate user inputs" | High |
| Documentation | "Add docstrings to module" | Low |
| Performance | "Optimize database queries" | Medium |
| Cleanup | "Remove unused imports" | Low |

## AGI Smoke Prompt Toolkit

Expand Down Expand Up @@ -442,12 +442,12 @@ watch -n 2 'cat data_out/autonomous_agent/status.json | python -m json.tool'

## Performance

| Model | Speed | Quality | Memory | Recommendation |
| Model | Speed | Quality | Memory | Recommendation |
| ------------- | ---------- | ---------- | ------ | ------------------ |
| Mistral | ⭐⭐⭐⭐⭐ | ⭐⭐⭐⭐ | 4GB | **Best for agent** |
| Neural-Chat | ⭐⭐⭐⭐ | ⭐⭐⭐⭐ | 8GB | Good |
| Llama-7B | ⭐⭐ | ⭐⭐⭐ | 8GB | Slower |
| GPT-4 (cloud) | ⭐⭐⭐⭐⭐ | ⭐⭐⭐⭐⭐ | N/A | No - uses API |
| Mistral | ⭐⭐⭐⭐⭐ | ⭐⭐⭐⭐ | 4GB | **Best for agent** |
| Neural-Chat | ⭐⭐⭐⭐ | ⭐⭐⭐⭐ | 8GB | Good |
| Llama-7B | ⭐⭐ | ⭐⭐⭐ | 8GB | Slower |
| GPT-4 (cloud) | ⭐⭐⭐⭐⭐ | ⭐⭐⭐⭐⭐ | N/A | No - uses API |

## Security

Expand Down
32 changes: 16 additions & 16 deletions docs/root-guides/ARIA_TEST_SUITE_IMPLEMENTATION.md
Original file line number Diff line number Diff line change
Expand Up @@ -15,15 +15,15 @@ This session completed the **TODO item from AUTO-EXECUTE.md line 417** regarding

- **30+ Test Cases** across 10 test classes
- **Coverage Areas**:
- Schema validation and API contracts
- Plan-only mode (parsing without state changes)
- Execution mode with state updates
- Error handling and edge cases
- State consistency and bounds checking
- Object management and tracking
- LLM provider detection and fallback
- Response format compliance
- End-to-end integration workflows
- Schema validation and API contracts
- Plan-only mode (parsing without state changes)
- Execution mode with state updates
- Error handling and edge cases
- State consistency and bounds checking
- Object management and tracking
- LLM provider detection and fallback
- Response format compliance
- End-to-end integration workflows

**Test Classes**:

Expand Down Expand Up @@ -103,14 +103,14 @@ pytest /workspaces/Aria/tests/test_aria_auto_execute.py --cov=apps/aria --cov-re

## Test Statistics

| Metric | Value |
| Metric | Value |
| ---------------- | ------------------------------------ |
| Total Test Cases | 30+ |
| Test Classes | 10 |
| Lines of Code | 615 |
| Coverage Areas | 9 major categories |
| Status | ✅ All passing (when server running) |
| Linting | ✅ Clean (0 errors) |
| Total Test Cases | 30+ |
| Test Classes | 10 |
| Lines of Code | 615 |
| Coverage Areas | 9 major categories |
| Status | ✅ All passing (when server running) |
| Linting | ✅ Clean (0 errors) |

## Related Documentation

Expand Down
6 changes: 3 additions & 3 deletions docs/root-guides/AUTOMATIC_AUTOMATION_GUIDE.md
Original file line number Diff line number Diff line change
Expand Up @@ -255,10 +255,10 @@ Get-Content "c:\Users\Bryan\Aria\logs\continuous_automation.log" -Wait -Tail 30

## Summary

| Method | Frequency | Setup | Use Case |
| Method | Frequency | Setup | Use Case |
| -------------- | --------------- | ------------ | -------------------- |
| **Manual** | On-demand | None | Quick testing |
| **Scheduled** | Daily at 2 AM | ✓ Done | Regular maintenance |
| **Manual** | On-demand | None | Quick testing |
| **Scheduled** | Daily at 2 AM | ✓ Done | Regular maintenance |
| **Continuous** | Every X minutes | Start script | Real-time monitoring |

**Recommended:**
Expand Down
34 changes: 17 additions & 17 deletions docs/root-guides/AUTONOMOUS_AGENT_IMPLEMENTATION.md
Original file line number Diff line number Diff line change
Expand Up @@ -148,16 +148,16 @@ state.save() # → data_out/autonomous_agent/status.json

## Task Categories (Auto-Detected)

| Type | Keywords | Complexity | Example |
| Type | Keywords | Complexity | Example |
| ------------- | ---------------------------- | ---------- | -------------------------- |
| Bug Fix | bug, fix, broken, failing | Moderate | "Fix test_chat.py test" |
| Feature | feature, implement, add | Complex | "Add OAuth2 support" |
| Refactor | refactor, improve, cleanup | Moderate | "Extract to util function" |
| Test | test, coverage, unit test | Simple | "Write edge case tests" |
| Security | security, vulnerable | Complex | "Validate inputs" |
| Performance | performance, optimize, fast | Complex | "Speed up queries" |
| Documentation | document, docstring, comment | Simple | "Add docstrings" |
| Cleanup | cleanup, unused, dead code | Simple | "Remove old code" |
| Bug Fix | bug, fix, broken, failing | Moderate | "Fix test_chat.py test" |
| Feature | feature, implement, add | Complex | "Add OAuth2 support" |
| Refactor | refactor, improve, cleanup | Moderate | "Extract to util function" |
| Test | test, coverage, unit test | Simple | "Write edge case tests" |
| Security | security, vulnerable | Complex | "Validate inputs" |
| Performance | performance, optimize, fast | Complex | "Speed up queries" |
| Documentation | document, docstring, comment | Simple | "Add docstrings" |
| Cleanup | cleanup, unused, dead code | Simple | "Remove old code" |

Agent automatically chooses appropriate prompts based on task description.

Expand Down Expand Up @@ -378,15 +378,15 @@ tail -50 data_out/autonomous_agent/agent.log

## Performance Metrics

| Metric | Value |
| Metric | Value |
| ------------------- | -------------------- |
| Syntax Validation | <100ms |
| LLM Planning | 5-10s (Mistral) |
| File Identification | 2-5s |
| Test Suite | 30-120s |
| Total Task | 1-5 minutes |
| Memory Usage | 4-8GB (with Mistral) |
| CPU Usage | 2-4 cores |
| Syntax Validation | <100ms |
| LLM Planning | 5-10s (Mistral) |
| File Identification | 2-5s |
| Test Suite | 30-120s |
| Total Task | 1-5 minutes |
| Memory Usage | 4-8GB (with Mistral) |
| CPU Usage | 2-4 cores |

## Security Considerations

Expand Down
38 changes: 19 additions & 19 deletions docs/root-guides/CONFIG_CHECKLIST.md
Original file line number Diff line number Diff line change
Expand Up @@ -114,19 +114,19 @@ curl http://localhost:7071/api/ai/routes | python3 -m json.tool

## 📦 Dependency Summary

| Category | Key Package | Min Version |
| Category | Key Package | Min Version |
| ----------------- | ----------------------------- | ----------- |
| **AI/Chat** | `openai` | 1.58.0 |
| **Quantum** | `qiskit` | 1.3.0 |
| **Quantum ML** | `qiskit-machine-learning` | 0.8.2 |
| **Azure Quantum** | `azure-quantum` | 1.0.0 |
| **Deep Learning** | `torch` | 2.8.0 |
| **Transformers** | `transformers` | Latest |
| **Fine-tuning** | `peft` | Latest |
| **Functions** | `azure-functions` | Latest |
| **Database** | `sqlalchemy` | 2.0.36 |
| **Cosmos** | `azure-cosmos` | 4.7.0 |
| **Telemetry** | `azure-monitor-opentelemetry` | 1.0.0 |
| **AI/Chat** | `openai` | 1.58.0 |
| **Quantum** | `qiskit` | 1.3.0 |
| **Quantum ML** | `qiskit-machine-learning` | 0.8.2 |
| **Azure Quantum** | `azure-quantum` | 1.0.0 |
| **Deep Learning** | `torch` | 2.8.0 |
| **Transformers** | `transformers` | Latest |
| **Fine-tuning** | `peft` | Latest |
| **Functions** | `azure-functions` | Latest |
| **Database** | `sqlalchemy` | 2.0.36 |
| **Cosmos** | `azure-cosmos` | 4.7.0 |
| **Telemetry** | `azure-monitor-opentelemetry` | 1.0.0 |

---

Expand Down Expand Up @@ -223,14 +223,14 @@ See `ENVIRONMENT_SETUP.md` for:

## 🆘 Quick Troubleshooting

| Problem | Fix |
| Problem | Fix |
| ----------------------------- | ---------------------------------------- |
| `ModuleNotFoundError: torch` | `pip install torch>=2.8.0` |
| `ModuleNotFoundError: qiskit` | `pip install qiskit==1.3.0` |
| `ModuleNotFoundError: openai` | `pip install openai>=1.58.0` |
| Provider returns "local" | Check `/api/ai/status` for env vars |
| `/api/chat` returns 500 | Run `/api/ai/provider-probe` to diagnose |
| Functions fail to start | `pip install azure-functions` |
| `ModuleNotFoundError: torch` | `pip install torch>=2.8.0` |
| `ModuleNotFoundError: qiskit` | `pip install qiskit==1.3.0` |
| `ModuleNotFoundError: openai` | `pip install openai>=1.58.0` |
| Provider returns "local" | Check `/api/ai/status` for env vars |
| `/api/chat` returns 500 | Run `/api/ai/provider-probe` to diagnose |
| Functions fail to start | `pip install azure-functions` |

---

Expand Down
10 changes: 5 additions & 5 deletions docs/root-guides/ENVIRONMENT_SETUP.md
Original file line number Diff line number Diff line change
Expand Up @@ -10,12 +10,12 @@

Your Aria workspace is configured with:

| Component | Status | Python | Venv Path |
| Component | Status | Python | Venv Path |
| ----------------- | ------------- | ------ | --------------------------------- |
| **Main Aria** | ✅ Configured | 3.14 | `/workspaces/Aria/.venv` |
| **Quantum ML** | ✅ Configured | 3.14 | `/workspaces/Aria/.venv` (shared) |
| **Chat CLI** | ✅ Configured | 3.14 | `/workspaces/Aria/.venv` (shared) |
| **LoRA Training** | ✅ Configured | 3.14 | `/workspaces/Aria/.venv` (shared) |
| **Main Aria** | ✅ Configured | 3.14 | `/workspaces/Aria/.venv` |
| **Quantum ML** | ✅ Configured | 3.14 | `/workspaces/Aria/.venv` (shared) |
| **Chat CLI** | ✅ Configured | 3.14 | `/workspaces/Aria/.venv` (shared) |
| **LoRA Training** | ✅ Configured | 3.14 | `/workspaces/Aria/.venv` (shared) |

---

Expand Down
40 changes: 20 additions & 20 deletions docs/root-guides/PYTHON_314_UPGRADE.md
Original file line number Diff line number Diff line change
Expand Up @@ -26,27 +26,27 @@ This document summarizes the complete Python 3.14 upgrade performed on the Aria

**Updated 20 workflow files** to use Python 3.14:

| Workflow | Change |
| Workflow | Change |
| ----------------------------- | ------------------------------------------------------------ |
| ci-pipeline.yml | `3.11` → `3.14` |
| pr-tests.yml | `3.11` → `3.14` |
| ci.yml | `3.11` → `3.14` |
| aria-tests.yml | `['3.10', '3.11', '3.12']` → `['3.12', '3.13', '3.14']` |
| e2e-tests.yml | `3.11` → `3.14` |
| quantum-ci.yml | `['3.10', '3.11']` → `['3.12', '3.13', '3.14']` |
| nightly-regression.yml | `3.11` → `3.14` |
| agi-smoke.yml | `3.11` → `3.14` |
| llm-maker-tests.yml | `3.11` → `3.14` |
| api-health-smoke.yml | `3.11` → `3.14` |
| gradio-focused-tests.yml | `3.11` → `3.14` |
| integration-contract-gate.yml | `3.11` → `3.14` |
| aria-bot-tests.yml | `3.10` → `3.14` |
| auto-fix.yml | `3.11` → `3.14` |
| training-health-report.yml | `3.11` → `3.14` |
| agi-prune-cron.yml | `3.11.x` → `3.14` |
| test-watcher.yml | `3.11` → `3.14` |
| codeql.yml | (checked - no explicit version pin, will use runner default) |
| copilot-setup-steps.yml | (checked - no explicit version pin) |
| ci-pipeline.yml | `3.11` → `3.14` |
| pr-tests.yml | `3.11` → `3.14` |
| ci.yml | `3.11` → `3.14` |
| aria-tests.yml | `['3.10', '3.11', '3.12']` → `['3.12', '3.13', '3.14']` |
| e2e-tests.yml | `3.11` → `3.14` |
| quantum-ci.yml | `['3.10', '3.11']` → `['3.12', '3.13', '3.14']` |
| nightly-regression.yml | `3.11` → `3.14` |
| agi-smoke.yml | `3.11` → `3.14` |
| llm-maker-tests.yml | `3.11` → `3.14` |
| api-health-smoke.yml | `3.11` → `3.14` |
| gradio-focused-tests.yml | `3.11` → `3.14` |
| integration-contract-gate.yml | `3.11` → `3.14` |
| aria-bot-tests.yml | `3.10` → `3.14` |
| auto-fix.yml | `3.11` → `3.14` |
| training-health-report.yml | `3.11` → `3.14` |
| agi-prune-cron.yml | `3.11.x` → `3.14` |
| test-watcher.yml | `3.11` → `3.14` |
| codeql.yml | (checked - no explicit version pin, will use runner default) |
| copilot-setup-steps.yml | (checked - no explicit version pin) |

**Rationale for Matrix Updates**:

Expand Down
10 changes: 5 additions & 5 deletions docs/root-guides/SMOKE_TESTS_AGI_ENDPOINTS.md
Original file line number Diff line number Diff line change
Expand Up @@ -87,9 +87,9 @@ The `/api/agi/status` endpoint response includes:

## Troubleshooting

| Issue | Solution |
| Issue | Solution |
| ----------------------------- | --------------------------------------------------------------- |
| `curl: (7) Failed to connect` | Ensure `func host start` is running on port 7071 |
| `agent_tools` field missing | Check `agi_provider._AGENT_REGISTRY` is accessible |
| Tool names not sorted | Verify `sorted(set(...))` logic in `function_app.py` agi_status |
| Non-string tools in list | Check `agi_provider.py` tool configuration structure |
| `curl: (7) Failed to connect` | Ensure `func host start` is running on port 7071 |
| `agent_tools` field missing | Check `agi_provider._AGENT_REGISTRY` is accessible |
| Tool names not sorted | Verify `sorted(set(...))` logic in `function_app.py` agi_status |
| Non-string tools in list | Check `agi_provider.py` tool configuration structure |
Loading