aibox-cli 0.3.1__tar.gz

aibox_cli-0.3.1/.dockerignore

@@ -0,0 +1,8 @@
+.git
+.gitignore
+.venv
+__pycache__
+*.pyc
+.pytest_cache
+htmlcov
+.aibox/projects

aibox_cli-0.3.1/.github/workflows/release.yml

@@ -0,0 +1,83 @@
+name: Release
+
+on:
+  push:
+    tags:
+      - 'v*'
+
+jobs:
+  build:
+    name: Build distribution
+    runs-on: ubuntu-latest
+
+    steps:
+    - uses: actions/checkout@v4
+
+    - name: Install uv
+      uses: astral-sh/setup-uv@v4
+
+    - name: Set up Python
+      run: uv python install 3.12
+
+    - name: Create virtual environment
+      run: uv venv
+
+    - name: Install build dependencies
+      run: |
+        uv pip install build twine
+
+    - name: Build package
+      run: |
+        uv build
+
+    - name: Check package
+      run: |
+        uv run twine check dist/*
+
+    - name: Upload artifacts
+      uses: actions/upload-artifact@v4
+      with:
+        name: dist
+        path: dist/
+
+  publish-pypi:
+    name: Publish to PyPI
+    needs: build
+    runs-on: ubuntu-latest
+    environment:
+      name: pypi
+      url: https://pypi.org/p/aibox-cli
+    permissions:
+      id-token: write  # For trusted publishing
+
+    steps:
+    - uses: actions/download-artifact@v4
+      with:
+        name: dist
+        path: dist/
+
+    - name: Publish to PyPI
+      uses: pypa/gh-action-pypi-publish@release/v1
+
+  github-release:
+    name: Create GitHub Release
+    needs: build
+    runs-on: ubuntu-latest
+    permissions:
+      contents: write
+
+    steps:
+    - uses: actions/checkout@v4
+
+    - uses: actions/download-artifact@v4
+      with:
+        name: dist
+        path: dist/
+
+    - name: Create Release
+      uses: softprops/action-gh-release@v2
+      with:
+        files: dist/*
+        generate_release_notes: true
+        draft: false
+        prerelease: false

aibox_cli-0.3.1/.github/workflows/test.yml

@@ -0,0 +1,55 @@
+name: Tests
+
+on:
+  push:
+    branches: [ main, develop ]
+  pull_request:
+    branches: [ main, develop ]
+
+jobs:
+  test:
+    name: Test Python 3.12 on ${{ matrix.os }}
+    runs-on: ${{ matrix.os }}
+
+    strategy:
+      fail-fast: false
+      matrix:
+        os: [ubuntu-latest, macos-latest]
+
+    steps:
+    - uses: actions/checkout@v4
+
+    - name: Install uv
+      uses: astral-sh/setup-uv@v4
+
+    - name: Set up Python 3.12
+      run: uv python install 3.12
+
+    - name: Create virtual environment
+      run: uv venv
+
+    - name: Install dependencies
+      run: |
+        uv pip install -e ".[dev]"
+
+    - name: Run linter (ruff)
+      run: |
+        uv run ruff check aibox/
+
+    - name: Run formatter check (ruff)
+      run: |
+        uv run ruff format --check aibox/
+
+    - name: Run type checker (mypy)
+      run: |
+        uv run mypy aibox/
+
+    - name: Run unit tests
+      run: |
+        uv run pytest tests/unit -v --cov=aibox --cov-report=xml
+
+    - name: Upload coverage to Codecov
+      uses: codecov/codecov-action@v4
+      with:
+        file: ./coverage.xml
+        fail_ci_if_error: false

aibox_cli-0.3.1/.gitignore

@@ -0,0 +1,326 @@
+# =============================================================================
+# Python
+# =============================================================================
+
+# Byte-compiled / optimized / DLL files
+__pycache__/
+*.py[cod]
+*$py.class
+
+# C extensions
+*.so
+
+# Distribution / packaging
+.Python
+build/
+develop-eggs/
+dist/
+downloads/
+eggs/
+.eggs/
+lib/
+lib64/
+parts/
+sdist/
+var/
+wheels/
+pip-wheel-metadata/
+share/python-wheels/
+*.egg-info/
+.installed.cfg
+*.egg
+MANIFEST
+
+# PyInstaller
+*.manifest
+*.spec
+
+# Installer logs
+pip-log.txt
+pip-delete-this-directory.txt
+
+# Unit test / coverage reports
+htmlcov/
+.tox/
+.nox/
+.coverage
+.coverage.*
+.cache
+nosetests.xml
+coverage.xml
+*.cover
+*.py,cover
+.hypothesis/
+.pytest_cache/
+test-results/
+.test_results/
+
+# Translations
+*.mo
+*.pot
+
+# Django stuff:
+*.log
+local_settings.py
+db.sqlite3
+db.sqlite3-journal
+
+# Flask stuff:
+instance/
+.webassets-cache
+
+# Scrapy stuff:
+.scrapy
+
+# Sphinx documentation
+docs/_build/
+docs/_static/
+docs/_templates/
+
+# PyBuilder
+target/
+
+# Jupyter Notebook
+.ipynb_checkpoints
+
+# IPython
+profile_default/
+ipython_config.py
+
+# pyenv
+.python-version
+
+# pipenv
+Pipfile.lock
+
+# PEP 582
+__pypackages__/
+
+# Celery stuff
+celerybeat-schedule
+celerybeat.pid
+
+# SageMath parsed files
+*.sage.py
+
+# Environments
+.env
+.env.*
+.venv
+env/
+venv/
+ENV/
+env.bak/
+venv.bak/
+*.env
+
+# =============================================================================
+# Development Tools
+# =============================================================================
+
+# mypy
+.mypy_cache/
+.dmypy.json
+dmypy.json
+
+# Pyre type checker
+.pyre/
+
+# pytype static type analyzer
+.pytype/
+
+# Ruff
+.ruff_cache/
+
+# uv
+.uv/
+.uv-cache/
+uv.lock
+
+# Pylint
+.pylintrc.local
+
+# Rope project settings
+.ropeproject
+
+# Spyder project settings
+.spyderproject
+.spyproject
+
+# =============================================================================
+# IDEs and Editors
+# =============================================================================
+
+# VSCode
+.vscode/
+*.code-workspace
+
+# PyCharm / IntelliJ
+.idea/
+*.iml
+*.iws
+.idea_modules/
+
+# Vim
+*.swp
+*.swo
+*~
+.vim/
+*.un~
+
+# Emacs
+*~
+\#*\#
+.\#*
+.emacs.desktop
+.emacs.desktop.lock
+
+# Sublime Text
+*.sublime-project
+*.sublime-workspace
+
+# Eclipse
+.project
+.pydevproject
+.settings/
+
+# =============================================================================
+# Operating System
+# =============================================================================
+
+# macOS
+.DS_Store
+.AppleDouble
+.LSOverride
+._*
+.DocumentRevisions-V100
+.fseventsd
+.Spotlight-V100
+.TemporaryItems
+.Trashes
+.VolumeIcon.icns
+.com.apple.timemachine.donotpresent
+
+# Windows
+Thumbs.db
+ehthumbs.db
+Desktop.ini
+$RECYCLE.BIN/
+
+# Linux
+.directory
+.Trash-*
+
+# =============================================================================
+# aibox Specific
+# =============================================================================
+
+# aibox runtime data (testing/development)
+# This includes .aibox-ref files (machine-specific project references)
+.aibox/
+*.aibox/
+
+# aibox temp directories
+aibox-temp/
+.aibox-temp/
+
+# Test data directories
+test_aibox_data/
+
+# =============================================================================
+# Personal / Private Data
+# =============================================================================
+
+# Claude CLI personal configuration (DO NOT COMMIT)
+.claude/
+
+# Personal notes and scratch files
+NOTES.md
+SCRATCH.md
+TODO.personal.md
+scratch/
+notes/
+
+# API keys and secrets (CRITICAL - DO NOT COMMIT)
+*.key
+*.pem
+*.pfx
+*.p12
+secrets.*
+credentials.*
+.secrets
+api_keys.*
+*_secret.*
+*-secret.*
+
+# Local development overrides
+*.local
+*.local.*
+config.local.*
+settings.local.*
+
+# Database files (development)
+*.db
+*.sqlite
+*.sqlite3
+
+# =============================================================================
+# Docker
+# =============================================================================
+
+# Docker build context
+.dockerignore.local
+docker-compose.override.yml
+
+# =============================================================================
+# Temporary and Backup Files
+# =============================================================================
+
+# Temporary files
+*.tmp
+*.temp
+*.bak
+*.backup
+*.old
+*.orig
+*-copy.*
+
+# Backup directories
+backup/
+backups/
+.backup/
+
+# Temp Todos
+TODO.md
+
+# =============================================================================
+# Logs and Debugging
+# =============================================================================
+
+# Log files
+*.log
+logs/
+*.log.*
+
+# Debug files
+debug/
+*.debug
+.debug/
+
+# Profiling
+*.prof
+*.pstats
+.profiling/
+
+# =============================================================================
+# Project Specific Exclusions
+# =============================================================================
+
+# Keep migration reference materials (already tracked)
+# aibox-migration/ is intentionally tracked
+
+# Keep documentation (already tracked)
+# README.md, CLAUDE.md, CONTRIBUTING.md are intentionally tracked
+
+# Keep tests (already tracked)
+# tests/ directory is intentionally tracked

aibox_cli-0.3.1/AGENTS.md

@@ -0,0 +1,31 @@
+# Repository Guidelines
+
+## Project Structure & Modules
+`aibox/` houses the CLI, config models, container orchestration, profile definitions, and AI providers—keep domain logic in these subpackages so commands stay thin. `tests/` mirrors those modules (`tests/unit`, `tests/fixtures`), while `docs/` collects architecture, multi-agent, and configuration references; helpers live in `scripts/`. Treat `htmlcov/` as disposable coverage output.
+
+## Build, Test, and Development Commands
+```bash
+uv pip install -e ".[dev]"            # install runtime + dev extras
+ruff check aibox tests                # lint/import order
+ruff format aibox tests               # auto-format
+mypy aibox                            # strict typing
+pytest                                # full suite (markers/opts in pyproject)
+pytest --cov=aibox --cov-report=html  # coverage (≥80% floor)
+pre-commit run --all-files
+aibox --help                          # quick CLI smoke test
+```
+
+## Coding Style & Simple Design
+Use Python 3.11+, 4-space indentation, and explicit type hints everywhere to satisfy strict `mypy`. Ruff enforces 100-character lines and naming; only `__init__.py` may ignore unused imports. Refactor using Kent Beck’s rules in priority order: all tests pass → intent is obvious → no duplication → fewest necessary elements. Document mass deltas when refactors stall.
+
+## TDD Workflow
+Start every problem by listing base `pytest` cases (`it.todo()` conceptually) before activating exactly one test. Follow Red (compilation/runtime failure), Green (minimal implementation), and Refactor (mandatory improvement) phases with explicit “guessing game” predictions before each run. Stick to baby steps, resist lookahead, and never implement beyond the current failing test; update docs/tests together to keep coverage stable.
+
+## Human-in-the-Loop Checkpoints
+After each phase summarize what happened (test chosen, prediction accuracy, implementation, refactors/mass changes) and pause for approval before moving on. If a prediction is wrong, stop and explain why before continuing or investigating per human guidance. No batch execution—every Red/Green/Refactor loop or phase transition requires confirmation.
+
+## Commit & Pull Request Guidance
+History favors short, imperative subjects (`Add configuration system with Pydantic models`, `Fix GitHub Actions CI workflow`, `chore: remove all ClaudeBox references`). Keep scopes tight, pair code/tests/docs/`CHANGELOG.md` updates, and avoid WIP commits. Pull requests should link issues, describe user-visible CLI effects, include `pytest`/`ruff` snippets, and add Rich output screenshots when formatting changes.
+
+## Security & Configuration
+Never commit provider credentials; rely on `ANTHROPIC_API_KEY` or `OPENAI_API_KEY` in your shell. Keep `.aibox/config.yml` examples minimal, document new schema fields in `docs/configuration.md`, and ensure `aibox init` plus `slot add` stay backward compatible without secrets to protect CI runs.