autoweave 0.1.0__tar.gz

autoweave-0.1.0/.dockerignore

@@ -0,0 +1,10 @@
+.env
+.env.local
+.pytest_cache/
+__pycache__/
+*.pyc
+var/
+workspaces/
+config/secrets/
+ergon-*.json
+README.md

autoweave-0.1.0/.editorconfig

@@ -0,0 +1,22 @@
+# https://editorconfig.org
+root = true
+
+[*]
+indent_style = space
+indent_size = 4
+end_of_line = lf
+charset = utf-8
+trim_trailing_whitespace = true
+insert_final_newline = true
+
+[*.{yml,yaml}]
+indent_size = 2
+
+[*.{json,toml}]
+indent_size = 2
+
+[*.md]
+trim_trailing_whitespace = false
+
+[Makefile]
+indent_style = tab

autoweave-0.1.0/.env.example

@@ -0,0 +1,52 @@
+# Copy values that are safe for local development into `.env.local`.
+# Keep secrets and service-account files out of git.
+# `docker compose up -d` reads `.env.local` for the OpenHands service via `docker-compose.yml`.
+
+# Vertex AI canonical runtime settings
+VERTEXAI_PROJECT=
+# Gemini 3 preview models are currently available on Vertex via the global endpoint.
+VERTEXAI_LOCATION=global
+VERTEXAI_SERVICE_ACCOUNT_FILE=./config/secrets/vertex_service_account.json
+
+# Optional local compatibility alias if a worker process reads it directly.
+# The runtime compiler should normally materialize this from VERTEXAI_SERVICE_ACCOUNT_FILE.
+GOOGLE_APPLICATION_CREDENTIALS=./config/secrets/vertex_service_account.json
+
+# Canonical storage and queue settings
+POSTGRES_URL=
+REDIS_URL=redis://127.0.0.1:6379/0
+NEO4J_URL=
+NEO4J_USERNAME=
+NEO4J_PASSWORD=
+
+# Artifact and observability backends
+ARTIFACT_STORE_URL=file://./var/artifacts
+OTEL_EXPORTER_OTLP_ENDPOINT=
+AUTOWEAVE_METRICS_EXPORTER=
+
+# OpenHands remote worker runtime
+OPENHANDS_AGENT_SERVER_BASE_URL=http://127.0.0.1:8000
+OPENHANDS_AGENT_SERVER_API_KEY=
+OPENHANDS_WORKER_TIMEOUT_SECONDS=1800
+# Leave this unset to derive a poll budget from OPENHANDS_WORKER_TIMEOUT_SECONDS.
+AUTOWEAVE_OPENHANDS_POLL_TIMEOUT_SECONDS=
+AUTOWEAVE_OPENHANDS_POLL_INTERVAL_SECONDS=1
+
+# AutoWeave runtime defaults
+AUTOWEAVE_DEFAULT_WORKFLOW=configs/workflows/team.workflow.yaml
+AUTOWEAVE_RUNTIME_CONFIG=configs/runtime/runtime.yaml
+AUTOWEAVE_STORAGE_CONFIG=configs/runtime/storage.yaml
+AUTOWEAVE_VERTEX_CONFIG=configs/runtime/vertex.yaml
+AUTOWEAVE_OBSERVABILITY_CONFIG=configs/runtime/observability.yaml
+# Optional: force one named Vertex profile such as `fast`, `planner`, or `legacy_balanced`.
+AUTOWEAVE_VERTEX_PROFILE_OVERRIDE=
+AUTOWEAVE_CANONICAL_BACKEND=postgres
+AUTOWEAVE_GRAPH_BACKEND=neo4j
+AUTOWEAVE_AUTONOMY_LEVEL=medium
+AUTOWEAVE_POSTGRES_SCHEMA=autoweave
+AUTOWEAVE_STATE_DIR=var/state
+
+# Optional local queue/runtime tuning
+AUTOWEAVE_MAX_ACTIVE_ATTEMPTS=8
+AUTOWEAVE_HEARTBEAT_INTERVAL_SECONDS=15
+AUTOWEAVE_LEASE_TTL_SECONDS=60

autoweave-0.1.0/.github/CODEOWNERS

@@ -0,0 +1,10 @@
+# AutoWeave Code Owners
+
+# Default owner for everything
+*       @hypnoastic
+
+# Specific subsystems (examples, can be expanded as team grows)
+/autoweave/orchestration/   @hypnoastic
+/autoweave/storage/         @hypnoastic
+/autoweave/monitoring/      @hypnoastic
+/docs/                      @hypnoastic

autoweave-0.1.0/.github/FUNDING.yml

@@ -0,0 +1,3 @@
+# These are supported funding model platforms
+
+github: [hypnoastic]

autoweave-0.1.0/.github/ISSUE_TEMPLATE/bug_report.yml

@@ -0,0 +1,58 @@
+name: Bug Report
+description: Create a report to help us improve
+title: "[Bug]: "
+labels: ["bug"]
+assignees: []
+body:
+  - type: markdown
+    attributes:
+      value: |
+        Thanks for taking the time to fill out this bug report!
+  - type: input
+    id: version
+    attributes:
+      label: AutoWeave Version
+      description: What version of the AutoWeave Library are you using?
+      placeholder: e.g. 0.1.0 or main branch commit
+    validations:
+      required: true
+  - type: input
+    id: environment
+    attributes:
+      label: Environment
+      description: OS, Python version, Docker version, etc.
+      placeholder: e.g. macOS 14.5, Python 3.11, Docker 24.0.5
+    validations:
+      required: true
+  - type: textarea
+    id: description
+    attributes:
+      label: Describe the bug
+      description: A clear and concise description of what the bug is.
+    validations:
+      required: true
+  - type: textarea
+    id: reproduction
+    attributes:
+      label: Steps To Reproduce
+      description: Steps to reproduce the behavior.
+      placeholder: |
+        1. Run 'autoweave run-workflow...'
+        2. Provide input 'X'
+        3. See error 'Y'
+    validations:
+      required: true
+  - type: textarea
+    id: expected
+    attributes:
+      label: Expected behavior
+      description: A clear and concise description of what you expected to happen.
+    validations:
+      required: true
+  - type: textarea
+    id: logs
+    attributes:
+      label: Logs or Output
+      description: Paste any relevant logs, tracebacks, or output. Use code blocks (```) for formatting.
+    validations:
+      required: false

autoweave-0.1.0/.github/ISSUE_TEMPLATE/config.yml

@@ -0,0 +1,5 @@
+blank_issues_enabled: false
+contact_links:
+  - name: AutoWeave Discussions
+    url: https://github.com/hypnoastic/Autoweave/discussions
+    about: Ask questions, share ideas, and engage with the community.

autoweave-0.1.0/.github/ISSUE_TEMPLATE/feature_request.yml

@@ -0,0 +1,38 @@
+name: Feature Request
+description: Suggest an idea for this project
+title: "[Feature]: "
+labels: ["enhancement"]
+assignees: []
+body:
+  - type: markdown
+    attributes:
+      value: |
+        Thanks for suggesting a new feature! Please provide as much context as possible.
+  - type: textarea
+    id: problem
+    attributes:
+      label: Is your feature request related to a problem? Please describe.
+      description: A clear and concise description of what the problem is. Ex. I'm always frustrated when [...]
+    validations:
+      required: true
+  - type: textarea
+    id: solution
+    attributes:
+      label: Describe the solution you'd like
+      description: A clear and concise description of what you want to happen.
+    validations:
+      required: true
+  - type: textarea
+    id: alternatives
+    attributes:
+      label: Describe alternatives you've considered
+      description: A clear and concise description of any alternative solutions or features you've considered.
+    validations:
+      required: false
+  - type: textarea
+    id: additional_context
+    attributes:
+      label: Additional context
+      description: Add any other context or screenshots about the feature request here.
+    validations:
+      required: false

autoweave-0.1.0/.github/PULL_REQUEST_TEMPLATE.md

@@ -0,0 +1,28 @@
+## Description
+<!-- Describe your changes in detail -->
+<!-- Include motivation and context if it's a non-trivial change -->
+
+## Related Issue
+<!-- If fixing a bug or implementing a feature, link the issue here (e.g., Fixes #123) -->
+
+## Type of Change
+<!-- Check all that apply -->
+- [ ] Bug fix (non-breaking change which fixes an issue)
+- [ ] New feature (non-breaking change which adds functionality)
+- [ ] Breaking change (fix or feature that would cause existing functionality to not work as expected)
+- [ ] Documentation update
+- [ ] Refactoring / Tech Debt / Chore
+
+## Testing
+<!-- Describe the tests you ran to verify your changes. -->
+- [ ] Unit tests added/updated
+- [ ] Integration tests added/updated
+- [ ] UI tests added/updated (if applicable)
+- [ ] Tested locally with a real workflow execution
+
+## Checklist
+- [ ] My code follows the code style of this project (`make lint` passes).
+- [ ] I have run mypy type checking (`make typecheck` passes).
+- [ ] All new and existing tests pass (`make test` passes).
+- [ ] I have added/updated documentation if necessary.
+- [ ] My commit messages follow the [Conventional Commits](https://www.conventionalcommits.org/) format.

autoweave-0.1.0/.github/dependabot.yml

@@ -0,0 +1,24 @@
+version: 2
+updates:
+  # Maintain dependencies for pip (pyproject.toml)
+  - package-ecosystem: "pip"
+    directory: "/"
+    schedule:
+      interval: "weekly"
+    open-pull-requests-limit: 10
+    labels:
+      - "dependencies"
+      - "python"
+    ignore:
+      - dependency-name: "*"
+        update-types: ["version-update:semver-major"] # Ignore major updates automatically, review manually
+
+  # Maintain dependencies for GitHub Actions
+  - package-ecosystem: "github-actions"
+    directory: "/"
+    schedule:
+      interval: "weekly"
+    open-pull-requests-limit: 5
+    labels:
+      - "dependencies"
+      - "ci"

autoweave-0.1.0/.github/workflows/ci.yml

@@ -0,0 +1,122 @@
+name: CI
+
+on:
+  push:
+    branches: ["main"]
+  pull_request:
+    branches: ["main"]
+  workflow_dispatch:
+
+concurrency:
+  group: ${{ github.workflow }}-${{ github.ref }}
+  cancel-in-progress: true
+
+jobs:
+  lint-format-typecheck:
+    name: Code Quality
+    runs-on: ubuntu-latest
+    steps:
+      - uses: actions/checkout@v4
+      - name: Install uv
+        uses: astral-sh/setup-uv@v3
+        with:
+          enable-cache: true
+      - name: Set up Python
+        uses: actions/setup-python@v5
+        with:
+          python-version-file: ".python-version"
+      - name: Install dependencies
+        run: uv pip install --system -e ".[dev]"
+      - name: Lint & Format Check (Ruff)
+        run: make lint
+
+  test:
+    name: Test (Python ${{ matrix.python-version }})
+    runs-on: ubuntu-latest
+    strategy:
+      fail-fast: false
+      matrix:
+        python-version: ["3.10", "3.11", "3.12"]
+    steps:
+      - uses: actions/checkout@v4
+      - name: Install uv
+        uses: astral-sh/setup-uv@v3
+        with:
+          enable-cache: true
+      - name: Set up Python
+        uses: actions/setup-python@v5
+        with:
+          python-version: ${{ matrix.python-version }}
+      - name: Install dependencies
+        run: uv pip install --system -e ".[dev]"
+      - name: Install Playwright browsers
+        run: uv run playwright install chromium
+      - name: Start Redis for Tests
+        uses: supercharge/redis-github-action@1.8.0
+        with:
+          redis-version: 6
+      - name: Run Tests & Check Coverage
+        run: make test:coverage
+        env:
+          REDIS_URL: "redis://localhost:6379/0"
+      - name: Upload Coverage Report
+        uses: actions/upload-artifact@v4
+        if: matrix.python-version == '3.10' # Only upload once
+        with:
+          name: coverage-report
+          path: .coverage
+          retention-days: 14
+          include-hidden-files: true
+
+  package:
+    name: Build & Smoke Test
+    runs-on: ubuntu-latest
+    needs: [lint-format-typecheck, test]
+    steps:
+      - uses: actions/checkout@v4
+      - name: Install uv
+        uses: astral-sh/setup-uv@v3
+        with:
+          enable-cache: true
+      - name: Set up Python
+        uses: actions/setup-python@v5
+        with:
+          python-version-file: ".python-version"
+      - name: Run Package Smoke Test
+        run: make pack:check
+      - name: Upload Wheel
+        uses: actions/upload-artifact@v4
+        with:
+          name: autoweave-wheel
+          path: dist/*.whl
+          retention-days: 14
+
+  health-report:
+    name: Project Health Report
+    runs-on: ubuntu-latest
+    if: github.event_name == 'push' && github.ref == 'refs/heads/main'
+    needs: [test]
+    steps:
+      - uses: actions/checkout@v4
+      - name: Install uv
+        uses: astral-sh/setup-uv@v3
+        with:
+          enable-cache: true
+      - name: Set up Python
+        uses: actions/setup-python@v5
+        with:
+          python-version-file: ".python-version"
+      - name: Download Coverage Report
+        uses: actions/download-artifact@v4
+        with:
+          name: coverage-report
+      - name: Generate Health Report
+        run: |
+          uv pip install --system -e ".[dev]"
+          make health
+      - name: Upload Health Report
+        uses: actions/upload-artifact@v4
+        with:
+          name: project-health
+          path: reports/health_report.*
+          retention-days: 30

autoweave-0.1.0/.github/workflows/release.yml

@@ -0,0 +1,44 @@
+name: Release
+
+on:
+  push:
+    tags:
+      - "v*.*.*"
+
+jobs:
+  build-and-publish:
+    runs-on: ubuntu-latest
+    environment: release
+    permissions:
+      id-token: write
+      contents: write # Needed for creating GitHub Releases
+    steps:
+      - uses: actions/checkout@v4
+      - name: Install uv
+        uses: astral-sh/setup-uv@v3
+        with:
+          enable-cache: true
+      - name: Set up Python
+        uses: actions/setup-python@v5
+        with:
+          python-version-file: ".python-version"
+      - name: Build Package
+        run: |
+          uv run --with build python -m build
+      - name: Smoke Test
+        run: |
+          uv venv smoke-env
+          source smoke-env/bin/activate
+          pip install dist/*.whl
+          autoweave --help
+      
+      - name: Publish to PyPI
+        uses: pypa/gh-action-pypi-publish@release/v1
+
+      - name: Create GitHub Release
+        uses: softprops/action-gh-release@v2
+        with:
+          generate_release_notes: true
+          files: |
+            dist/*.whl
+            dist/*.tar.gz

autoweave-0.1.0/.github/workflows/security.yml

@@ -0,0 +1,58 @@
+name: Security
+
+on:
+  push:
+    branches: ["main"]
+  pull_request:
+    branches: ["main"]
+  schedule:
+    - cron: "0 4 * * 1" # Run weekly on Monday
+
+jobs:
+  codeql:
+    name: CodeQL Analysis
+    runs-on: ubuntu-latest
+    permissions:
+      security-events: write
+      actions: read
+      contents: read
+    steps:
+      - uses: actions/checkout@v4
+      - name: Initialize CodeQL
+        uses: github/codeql-action/init@v3
+        with:
+          languages: python
+      - name: Perform CodeQL Analysis
+        uses: github/codeql-action/analyze@v3
+
+  dependency-audit:
+    name: Dependency Audit (pip-audit)
+    runs-on: ubuntu-latest
+    permissions:
+      security-events: write
+    steps:
+      - uses: actions/checkout@v4
+      - name: Install uv
+        uses: astral-sh/setup-uv@v3
+        with:
+          enable-cache: true
+      - name: Set up Python
+        uses: actions/setup-python@v5
+        with:
+          python-version-file: ".python-version"
+      - name: Audit Dependencies
+        run: |
+          uv run --with pip-audit pip-audit --format json -o audit-results.json || true
+          uv run --with pip-audit pip-audit # Print human-readable output and fail if necessary
+
+  gitleaks:
+    name: Secret Scanning
+    runs-on: ubuntu-latest
+    steps:
+      - uses: actions/checkout@v4
+        with:
+          fetch-depth: 0
+      - name: Run Gitleaks
+        uses: gitleaks/gitleaks-action@v2
+        env:
+          GITHUB_TOKEN: ${{ secrets.GITHUB_TOKEN }}

autoweave-0.1.0/.gitignore

@@ -0,0 +1,57 @@
+# ----- Python -----
+__pycache__/
+*.py[cod]
+*$py.class
+*.egg-info/
+*.egg
+dist/
+build/
+*.whl
+
+# ----- Virtual environments -----
+.venv/
+venv/
+env/
+
+# ----- Testing -----
+.pytest_cache/
+.coverage
+htmlcov/
+coverage.xml
+reports/
+
+# ----- Type checking -----
+.mypy_cache/
+.dmypy.json
+dmypy.json
+
+# ----- IDE / Editor -----
+.vscode/
+.idea/
+*.swp
+*.swo
+*~
+
+# ----- OS -----
+.DS_Store
+Thumbs.db
+
+# ----- AutoWeave specific -----
+.env
+.env.local
+config/secrets/
+var/
+workspaces/
+workspace/
+my-weave-project/
+tmp/
+ergon-*.json
+context.md
+/agents/
+/configs/
+
+# ----- Stray build artifacts -----
+*.jpeg
+*.jpg
+!docs/**/*.jpeg
+!docs/**/*.jpg

autoweave-0.1.0/.pre-commit-config.yaml

@@ -0,0 +1,24 @@
+repos:
+  - repo: https://github.com/pre-commit/pre-commit-hooks
+    rev: v4.5.0
+    hooks:
+      - id: trailing-whitespace
+      - id: end-of-file-fixer
+      - id: check-yaml
+      - id: check-toml
+      - id: check-merge-conflict
+      - id: check-added-large-files
+
+  - repo: https://github.com/astral-sh/ruff-pre-commit
+    rev: v0.3.5
+    hooks:
+      - id: ruff
+        args: [ --fix ]
+      - id: ruff-format
+
+  - repo: https://github.com/Yelp/detect-secrets
+    rev: v1.4.0
+    hooks:
+      - id: detect-secrets
+        args: ['--baseline', '.secrets.baseline']
+        exclude: package.lock.json

autoweave-0.1.0/.python-version

@@ -0,0 +1 @@
+3.10