Merge branch 'main' into issue-103

Author: Sahilbhatane

.github/ISSUE_TEMPLATE/bug_report.md

@@ -0,0 +1,29 @@
+---
+name: Bug Report
+about: Report something broken in Cortex
+title: "[BUG] "
+labels: bug
+assignees: ""
+---
+
+## What happened?
+
+Describe the bug clearly.
+
+## How to reproduce
+
+1. Command run: `cortex ...`
+2. What you expected
+3. What actually happened
+
+## Environment
+
+- OS: Ubuntu 24.04 / Debian 12 / etc.
+- Python: 3.11 / 3.12
+- LLM Provider: Claude / OpenAI / Ollama
+
+## Error output
+
+```
+Paste any error messages here
+```

.github/ISSUE_TEMPLATE/config.yml

@@ -0,0 +1,8 @@
+blank_issues_enabled: false
+contact_links:
+  - name: Questions / Discord
+    url: https://discord.gg/uCqHvxjU83
+    about: For general questions or discussion, join our Discord.
+  - name: Bounty Issues
+    url: https://github.com/cortexlinux/cortex/labels/bounty
+    about: Looking to earn? Check open bounty issues.

.github/ISSUE_TEMPLATE/feature_request.md

@@ -0,0 +1,27 @@
+---
+name: Feature Request
+about: Suggest a new feature for Cortex
+title: "[FEATURE] "
+labels: enhancement
+assignees: ""
+---
+
+## Problem
+
+What problem does this solve? Why is it important?
+
+## Proposed solution
+
+Describe the feature. Example commands or behavior:
+
+```bash
+cortex <your-idea-here>
+```
+
+## Alternatives considered
+
+Any workarounds you've tried.
+
+## Bounty interest
+
+Are you interested in implementing this for a bounty? (Yes/No)

.github/pull_request_template.md

@@ -1,15 +1,10 @@
-## Summary
-<!-- Brief description of changes -->
+## Related Issue
+Closes #<!-- REQUIRED: Issue number -->
 
-## Type of Change
-- [ ] Bug fix
-- [ ] New feature  
-- [ ] Documentation update
+## Summary
+<!-- What does this PR do? -->
 
 ## Checklist
-- [ ] Tests passing
-- [ ] Docs updated
-- [ ] Fixes #XXX
-
-## Testing
-<!-- How was this tested? -->
+- [ ] Tests pass (`pytest tests/`)
+- [ ] PR title format: `[#XX] Description`
+- [ ] MVP label added if closing MVP issue

.github/workflows/ci.yml

@@ -0,0 +1,38 @@
+name: CI
+
+on:
+  push:
+    branches: [main]
+  pull_request:
+    branches: [main]
+
+jobs:
+  test:
+    runs-on: ubuntu-latest
+
+    steps:
+      - name: Checkout
+        uses: actions/checkout@v4
+
+      - name: Set up Python
+        uses: actions/setup-python@v5
+        with:
+          python-version: "3.11"
+
+      - name: Install dependencies
+        run: |
+          python -m pip install -U pip
+          pip install -e .
+          pip install pytest black ruff
+
+      - name: Lint with ruff
+        run: ruff check . --exit-zero
+
+      - name: Check formatting
+        run: black --check . --exclude venv || true
+
+      - name: Run tests
+        env:
+          ANTHROPIC_API_KEY: "test-key-for-ci"
+        run: |
+          pytest tests/ -v --tb=short || echo "Some tests may require API keys"

.pre-commit-config.yaml

@@ -0,0 +1,29 @@
+repos:
+  - repo: https://github.com/psf/black
+    rev: 24.10.0
+    hooks:
+      - id: black
+        language_version: python3
+
+  - repo: https://github.com/astral-sh/ruff-pre-commit
+    rev: v0.8.0
+    hooks:
+      - id: ruff
+        args: ["--fix"]
+
+  - repo: https://github.com/pycqa/isort
+    rev: 5.13.2
+    hooks:
+      - id: isort
+        args: ["--profile", "black"]
+
+  - repo: https://github.com/pre-commit/pre-commit-hooks
+    rev: v5.0.0
+    hooks:
+      - id: trailing-whitespace
+      - id: end-of-file-fixer
+      - id: check-added-large-files
+        args: ['--maxkb=1000']
+      - id: check-yaml
+      - id: check-json
+      - id: check-merge-conflict

AGENTS.md

@@ -0,0 +1,81 @@
+# Cortex Linux - AI Agent Guidelines
+
+## Project Overview
+
+Cortex Linux is an AI-native package manager for Debian/Ubuntu that understands natural language commands. It wraps `apt` with LLM intelligence to parse requests, detect hardware, resolve dependencies, and execute installations safely.
+
+**Repository**: https://github.com/cortexlinux/cortex
+**License**: Apache 2.0
+**Primary Language**: Python 3.10+
+
+## Quick Start
+
+```bash
+# Clone and setup
+git clone https://github.com/cortexlinux/cortex.git
+cd cortex
+python3 -m venv venv
+source venv/bin/activate
+pip install -e .
+
+# Configure API key
+echo 'ANTHROPIC_API_KEY=your-key-here' > .env
+
+# Verify installation
+cortex install nginx --dry-run
+```
+
+## Development Environment
+
+### Prerequisites
+- Python 3.10 or higher
+- Ubuntu 22.04+ or Debian 12+
+- Virtual environment (required)
+- Anthropic API key or OpenAI API key
+
+### Setup Commands
+```bash
+python3 -m venv venv
+source venv/bin/activate
+pip install -e .
+pip install -r requirements-dev.txt
+pytest tests/ -v
+```
+
+## Testing Instructions
+
+```bash
+# Run all tests
+pytest tests/ -v
+
+# Test dry-run (safe)
+cortex install nginx --dry-run
+
+# Test hardware detection
+cortex-detect-hardware
+```
+
+## Code Standards
+
+- Follow PEP 8
+- Type hints required
+- Docstrings for public APIs
+- >80% test coverage for PRs
+
+## Safety Requirements
+
+1. Dry-run by default for all installations
+2. No silent sudo
+3. Firejail sandboxing required
+4. Audit logging to ~/.cortex/history.db
+
+## PR Guidelines
+
+- Title format: [component] Description
+- All tests must pass
+- Documentation required for new features
+
+## Contact
+
+- Discord: https://discord.gg/uCqHvxjU83
+- Email: mike@cortexlinux.com

Makefile

@@ -0,0 +1,46 @@
+# Cortex Linux - Developer Makefile
+# Usage: make [target]
+
+.PHONY: dev test lint format check clean help
+
+PYTHON ?= python3
+
+help:
+	@echo "Cortex Linux - Development Commands"
+	@echo ""
+	@echo "  make dev      Install development dependencies"
+	@echo "  make test     Run test suite"
+	@echo "  make lint     Run linters (ruff, black check)"
+	@echo "  make format   Auto-format code"
+	@echo "  make check    Run all checks (format + lint + test)"
+	@echo "  make clean    Remove build artifacts"
+	@echo ""
+
+dev:
+	$(PYTHON) -m pip install -U pip
+	$(PYTHON) -m pip install -e .
+	$(PYTHON) -m pip install -r requirements-dev.txt
+	@echo "✅ Dev environment ready"
+
+test:
+	$(PYTHON) -m pytest tests/ -v
+	@echo "✅ Tests passed"
+
+lint:
+	$(PYTHON) -m ruff check .
+	$(PYTHON) -m black --check .
+	@echo "✅ Linting passed"
+
+format:
+	$(PYTHON) -m black .
+	$(PYTHON) -m ruff check --fix .
+	@echo "✅ Code formatted"
+
+check: format lint test
+	@echo "✅ All checks passed"
+
+clean:
+	rm -rf build/ dist/ *.egg-info/
+	find . -type d -name __pycache__ -exec rm -rf {} + 2>/dev/null || true
+	find . -type f -name "*.pyc" -delete
+	@echo "✅ Cleaned"