dd-agents 0.4.1__tar.gz

dd_agents-0.4.1/.claude/agents/code-reviewer.md

@@ -0,0 +1,24 @@
+---
+name: code-reviewer
+description: Reviews implementation against spec docs for correctness and completeness
+tools: Read, Grep, Glob, Bash
+model: sonnet
+---
+
+You are a senior code reviewer for the due-diligence-agents project. Your job is to verify that implementation matches the specification.
+
+For each file you review:
+1. Read the implementation file
+2. Read the corresponding spec doc (see CLAUDE.md for the mapping)
+3. Check: Does the implementation cover all requirements in the spec?
+4. Check: Are all edge cases from the spec handled?
+5. Check: Do the tests cover the key behaviors?
+6. Check: Does the code follow project conventions (see CLAUDE.md)?
+
+Report:
+- MISSING: Features in spec but not implemented
+- WRONG: Implementation that contradicts the spec
+- UNTESTED: Code paths without test coverage
+- STYLE: Convention violations
+
+Be specific — include file paths, line numbers, and spec section references.

dd_agents-0.4.1/.claude/agents/test-runner.md

@@ -0,0 +1,21 @@
+---
+name: test-runner
+description: Runs tests and reports results with diagnostics
+tools: Bash, Read, Grep, Glob
+model: haiku
+---
+
+You are a test runner for the due-diligence-agents project.
+
+Run the requested tests and report results clearly:
+1. Run `pytest` with the specified path and flags
+2. If tests fail, read the failing test file and the source file it tests
+3. Identify the root cause of each failure
+4. Report: test name, expected vs actual, likely fix
+
+Commands:
+- Unit tests: `python -m pytest tests/unit/ -x -q`
+- Integration: `python -m pytest tests/integration/ -x -q`
+- Specific file: `python -m pytest <path> -x -v`
+- Type check: `python -m mypy src/ --strict`
+- Lint: `python -m ruff check src/ tests/`

dd_agents-0.4.1/.claude/settings.json

@@ -0,0 +1,62 @@
+{
+  "permissions": {
+    "allow": [
+      "Bash(python:*)",
+      "Bash(python3:*)",
+      "Bash(pip:*)",
+      "Bash(pytest:*)",
+      "Bash(mypy:*)",
+      "Bash(ruff:*)",
+      "Bash(git:*)",
+      "Bash(ls:*)",
+      "Bash(mkdir:*)",
+      "Bash(mv:*)",
+      "Bash(cp:*)",
+      "Bash(touch:*)",
+      "Bash(chmod:*)",
+      "Bash(head:*)",
+      "Bash(tail:*)",
+      "Bash(find:*)",
+      "Bash(grep:*)",
+      "Bash(rg:*)",
+      "Bash(cat:*)",
+      "Bash(wc:*)",
+      "Bash(diff:*)",
+      "Bash(echo:*)",
+      "Bash(docker:*)",
+      "Bash(docker-compose:*)",
+      "Bash(dd-agents:*)",
+      "Write(*)",
+      "Edit(*)",
+      "Read(*)"
+    ],
+    "deny": [
+      "Bash(rm -rf /*)",
+      "Bash(rm -rf ~/*)"
+    ]
+  },
+  "hooks": {
+    "PostToolUse": [
+      {
+        "matcher": "Edit|Write",
+        "hooks": [
+          {
+            "type": "command",
+            "command": "bash scripts/post-edit-lint.sh"
+          }
+        ]
+      }
+    ],
+    "PreToolUse": [
+      {
+        "matcher": "Bash",
+        "hooks": [
+          {
+            "type": "command",
+            "command": "bash scripts/pre-commit-gate.sh"
+          }
+        ]
+      }
+    ]
+  }
+}

dd_agents-0.4.1/.dockerignore

@@ -0,0 +1,21 @@
+.git
+__pycache__
+*.pyc
+*.pyo
+.pytest_cache
+.mypy_cache
+.ruff_cache
+tests/
+docs/
+.github/
+.claude/
+*.egg-info
+dist/
+build/
+.env
+.venv
+.tox
+.nox
+*.egg
+.coverage
+htmlcov/

dd_agents-0.4.1/.env.example

@@ -0,0 +1,22 @@
+# ==============================================================================
+# Due Diligence Agent SDK — Environment Variables
+# ==============================================================================
+# Copy this file to .env and uncomment/set the variables you need.
+# Only ONE API access method is required (Option A or B).
+
+# --- API Access (required — choose one) ---
+
+# Option A: Anthropic API (recommended for new developers)
+# ANTHROPIC_API_KEY=sk-ant-...
+
+# Option B: AWS Bedrock
+# AWS_PROFILE=default
+# AWS_REGION=us-east-1
+
+# --- Optional ---
+
+# ChromaDB: persist vector search index to disk (default: memory-only)
+# CHROMA_PERSIST_DIR=./chroma_data
+
+# Logging level (default: INFO). Set to DEBUG for verbose pipeline output.
+# LOG_LEVEL=INFO

dd_agents-0.4.1/.github/FUNDING.yml

@@ -0,0 +1 @@
+github: zoharbabin

dd_agents-0.4.1/.github/ISSUE_TEMPLATE/bug_report.md

@@ -0,0 +1,29 @@
+---
+name: Bug Report
+about: Report a bug in dd-agents
+labels: bug
+---
+
+## Describe the Bug
+
+<!-- A clear, concise description of what the bug is. -->
+
+## Steps to Reproduce
+
+1.
+2.
+3.
+
+## Expected Behavior
+
+<!-- What you expected to happen. -->
+
+## Actual Behavior
+
+<!-- What actually happened. Include error messages or stack traces if available. -->
+
+## Environment
+
+- **OS**: <!-- e.g., macOS 14.5, Ubuntu 24.04 -->
+- **Python version**: <!-- e.g., 3.12.3 -->
+- **dd-agents version**: <!-- e.g., 0.1.0 -->

dd_agents-0.4.1/.github/ISSUE_TEMPLATE/feature_request.md

@@ -0,0 +1,17 @@
+---
+name: Feature Request
+about: Suggest a new feature or improvement
+labels: enhancement
+---
+
+## Problem Description
+
+<!-- What problem does this solve? Why is it needed? -->
+
+## Proposed Solution
+
+<!-- How should this work? Be specific about expected behavior. -->
+
+## Alternatives Considered
+
+<!-- What other approaches did you consider and why were they ruled out? -->

dd_agents-0.4.1/.github/ISSUE_TEMPLATE/question.md

@@ -0,0 +1,13 @@
+---
+name: Question
+about: Ask a question about using dd-agents
+labels: question
+---
+
+## Question
+
+<!-- What would you like to know? -->
+
+## Context
+
+<!-- What are you trying to accomplish? What have you tried so far? -->

dd_agents-0.4.1/.github/pull_request_template.md

@@ -0,0 +1,17 @@
+## Summary
+
+<!-- What does this PR do and why? -->
+
+## Changes
+
+-
+
+## Testing
+
+<!-- How was this verified? Which tests were added/updated? -->
+
+## Checklist
+
+- [ ] Tests added or updated
+- [ ] `make verify` passes (lint + typecheck + tests)
+- [ ] No breaking changes (or documented in this PR)

dd_agents-0.4.1/.github/workflows/ci.yml

@@ -0,0 +1,162 @@
+name: CI
+
+on:
+  push:
+    branches: [main]
+  pull_request:
+    branches: [main]
+
+permissions:
+  contents: read
+
+jobs:
+  # ──────────────────────────────────────────────
+  # Stage 1: Code Quality (runs in parallel)
+  # ──────────────────────────────────────────────
+
+  lint:
+    name: "Lint & Format"
+    runs-on: ubuntu-latest
+    steps:
+      - uses: actions/checkout@v4
+      - uses: actions/setup-python@v5
+        with:
+          python-version: "3.12"
+          cache: pip
+      - name: Install dependencies
+        run: pip install -e ".[dev]"
+      - name: Ruff lint
+        run: ruff check src/ tests/
+      - name: Ruff format
+        run: ruff format --check src/ tests/
+
+  typecheck:
+    name: "Type Check (mypy --strict)"
+    runs-on: ubuntu-latest
+    steps:
+      - uses: actions/checkout@v4
+      - uses: actions/setup-python@v5
+        with:
+          python-version: "3.12"
+          cache: pip
+      - name: Install dependencies
+        run: pip install -e ".[dev]" types-openpyxl types-networkx
+      - name: Mypy strict
+        run: mypy src/ --strict
+
+  # ──────────────────────────────────────────────
+  # Stage 2: Tests (unit runs in parallel with Stage 1)
+  # ──────────────────────────────────────────────
+
+  test-unit:
+    name: "Unit Tests"
+    runs-on: ubuntu-latest
+    strategy:
+      matrix:
+        python-version: ["3.12", "3.13"]
+    steps:
+      - uses: actions/checkout@v4
+      - uses: actions/setup-python@v5
+        with:
+          python-version: ${{ matrix.python-version }}
+          cache: pip
+      - name: Install dependencies
+        run: pip install -e ".[dev]"
+      - name: Run unit tests
+        run: pytest tests/unit/ -v --tb=short --junitxml=results/unit-${{ matrix.python-version }}.xml
+      - uses: actions/upload-artifact@v4
+        if: always()
+        with:
+          name: unit-test-results-py${{ matrix.python-version }}
+          path: results/
+
+  # ──────────────────────────────────────────────
+  # Stage 3: Integration (after lint + unit pass)
+  # ──────────────────────────────────────────────
+
+  test-integration:
+    name: "Integration Tests"
+    runs-on: ubuntu-latest
+    needs: [lint, typecheck, test-unit]
+    steps:
+      - uses: actions/checkout@v4
+      - uses: actions/setup-python@v5
+        with:
+          python-version: "3.12"
+          cache: pip
+      - name: Install dependencies
+        run: pip install -e ".[dev]"
+      - name: Run integration tests
+        run: pytest tests/integration/ -v --tb=short -k "not test_agent_spawning" --junitxml=results/integration.xml
+      - uses: actions/upload-artifact@v4
+        if: always()
+        with:
+          name: integration-test-results
+          path: results/
+
+  # ──────────────────────────────────────────────
+  # Stage 4: Build verification
+  # ──────────────────────────────────────────────
+
+  build:
+    name: "Build Package"
+    runs-on: ubuntu-latest
+    needs: [lint, typecheck, test-unit]
+    steps:
+      - uses: actions/checkout@v4
+      - uses: actions/setup-python@v5
+        with:
+          python-version: "3.12"
+          cache: pip
+      - name: Install build tools
+        run: pip install build twine
+      - name: Build sdist and wheel
+        run: python -m build
+      - name: Verify package
+        run: twine check dist/*
+      - name: Verify CLI entry point
+        run: |
+          pip install dist/*.whl
+          dd-agents version
+      - uses: actions/upload-artifact@v4
+        with:
+          name: dist
+          path: dist/
+
+  build-docker:
+    name: "Build Docker Image"
+    runs-on: ubuntu-latest
+    needs: [lint, typecheck, test-unit]
+    steps:
+      - uses: actions/checkout@v4
+      - name: Build image
+        run: docker build -t dd-agents:ci-test .
+      - name: Verify CLI in container
+        run: docker run --rm dd-agents:ci-test version
+
+  # ──────────────────────────────────────────────
+  # Stage 5: E2E (main branch only, requires API key)
+  # ──────────────────────────────────────────────
+
+  test-e2e:
+    name: "E2E Tests"
+    runs-on: ubuntu-latest
+    needs: [test-integration, build]
+    if: github.event_name == 'push' && github.ref == 'refs/heads/main'
+    steps:
+      - uses: actions/checkout@v4
+      - uses: actions/setup-python@v5
+        with:
+          python-version: "3.12"
+          cache: pip
+      - name: Install dependencies
+        run: pip install -e ".[dev]"
+      - name: Run end-to-end tests
+        run: pytest tests/e2e/ -v --tb=long -m "e2e" --junitxml=results/e2e.xml
+        env:
+          ANTHROPIC_API_KEY: ${{ secrets.ANTHROPIC_API_KEY }}
+      - uses: actions/upload-artifact@v4
+        if: always()
+        with:
+          name: e2e-test-results
+          path: results/

dd_agents-0.4.1/.github/workflows/release.yml

@@ -0,0 +1,174 @@
+name: Release
+
+on:
+  push:
+    tags:
+      - "v*"
+  workflow_dispatch:
+    inputs:
+      tag:
+        description: "Version tag to release (e.g. v0.4.1)"
+        required: true
+
+permissions:
+  contents: write
+  id-token: write
+  packages: write
+
+jobs:
+  # ──────────────────────────────────────────────
+  # Gate: run full test suite before releasing
+  # ──────────────────────────────────────────────
+
+  quality-gate:
+    name: "Quality Gate"
+    runs-on: ubuntu-latest
+    steps:
+      - uses: actions/checkout@v4
+      - uses: actions/setup-python@v5
+        with:
+          python-version: "3.12"
+          cache: pip
+      - name: Install dependencies
+        run: pip install -e ".[dev]" types-openpyxl types-networkx
+      - name: Lint
+        run: ruff check src/ tests/ && ruff format --check src/ tests/
+      - name: Type check
+        run: mypy src/ --strict
+      - name: Unit tests
+        run: pytest tests/unit/ -x -q
+      - name: Integration tests
+        run: pytest tests/integration/ -x -q -k "not test_agent_spawning"
+
+  # ──────────────────────────────────────────────
+  # Build Python package
+  # ──────────────────────────────────────────────
+
+  build:
+    name: "Build Package"
+    runs-on: ubuntu-latest
+    needs: [quality-gate]
+    steps:
+      - uses: actions/checkout@v4
+      - uses: actions/setup-python@v5
+        with:
+          python-version: "3.12"
+          cache: pip
+      - name: Install build tools
+        run: pip install build
+      - name: Build sdist and wheel
+        run: python -m build
+      - name: Verify CLI entry point
+        run: |
+          pip install dist/*.whl
+          dd-agents version
+      - uses: actions/upload-artifact@v4
+        with:
+          name: dist
+          path: dist/
+
+  # ──────────────────────────────────────────────
+  # Publish to PyPI (trusted publishing via OIDC)
+  # ──────────────────────────────────────────────
+
+  publish-pypi:
+    name: "Publish to PyPI"
+    runs-on: ubuntu-latest
+    needs: [build]
+    steps:
+      - uses: actions/download-artifact@v4
+        with:
+          name: dist
+          path: dist/
+      - name: Publish to PyPI
+        uses: pypa/gh-action-pypi-publish@release/v1
+
+  # ──────────────────────────────────────────────
+  # Publish Docker image to GHCR
+  # ──────────────────────────────────────────────
+
+  publish-docker:
+    name: "Publish Docker Image"
+    runs-on: ubuntu-latest
+    needs: [build]
+    steps:
+      - uses: actions/checkout@v4
+
+      - name: Docker metadata
+        id: meta
+        uses: docker/metadata-action@v5
+        with:
+          images: ghcr.io/${{ github.repository }}
+          tags: |
+            type=semver,pattern={{version}}
+            type=semver,pattern={{major}}.{{minor}}
+            type=raw,value=latest
+
+      - name: Log in to GitHub Container Registry
+        uses: docker/login-action@v3
+        with:
+          registry: ghcr.io
+          username: ${{ github.actor }}
+          password: ${{ secrets.GITHUB_TOKEN }}
+
+      - name: Build and push
+        uses: docker/build-push-action@v6
+        with:
+          context: .
+          push: true
+          tags: ${{ steps.meta.outputs.tags }}
+          labels: ${{ steps.meta.outputs.labels }}
+
+  # ──────────────────────────────────────────────
+  # Create GitHub Release with changelog
+  # ──────────────────────────────────────────────
+
+  github-release:
+    name: "GitHub Release"
+    runs-on: ubuntu-latest
+    needs: [publish-pypi, publish-docker]
+    steps:
+      - uses: actions/checkout@v4
+        with:
+          fetch-depth: 0
+
+      - uses: actions/download-artifact@v4
+        with:
+          name: dist
+          path: dist/
+
+      - name: Generate release notes
+        id: notes
+        run: |
+          TAG="${GITHUB_REF_NAME}"
+          if [ "${{ github.event_name }}" = "workflow_dispatch" ]; then
+            TAG="${{ github.event.inputs.tag }}"
+          fi
+          PREV_TAG=$(git tag --sort=-v:refname | grep '^v' | grep -v "^${TAG}$" | head -1)
+          if [ -n "$PREV_TAG" ]; then
+            echo "## Changes since $PREV_TAG" > notes.md
+            echo "" >> notes.md
+            git log "$PREV_TAG".."$TAG" --pretty=format:"- %s" --no-merges >> notes.md
+          else
+            echo "## Initial release" > notes.md
+          fi
+          echo "" >> notes.md
+          echo "---" >> notes.md
+          echo "" >> notes.md
+          echo "### Install" >> notes.md
+          echo '```bash' >> notes.md
+          echo "pip install dd-agents==${TAG#v}" >> notes.md
+          echo '```' >> notes.md
+          echo "" >> notes.md
+          echo "### Docker" >> notes.md
+          echo '```bash' >> notes.md
+          echo "docker pull ghcr.io/${{ github.repository }}:${TAG#v}" >> notes.md
+          echo '```' >> notes.md
+
+      - name: Create GitHub Release
+        uses: softprops/action-gh-release@v2
+        with:
+          tag_name: ${{ github.event_name == 'workflow_dispatch' && github.event.inputs.tag || github.ref_name }}
+          body_path: notes.md
+          files: dist/*
+          generate_release_notes: true

dd_agents-0.4.1/.gitignore

@@ -0,0 +1,60 @@
+# Python
+__pycache__/
+*.py[cod]
+*$py.class
+*.so
+*.egg-info/
+*.egg
+dist/
+build/
+.eggs/
+
+# Virtual environments
+.venv/
+venv/
+ENV/
+.python-version
+
+# IDE
+.idea/
+.vscode/
+*.swp
+*.swo
+*~
+.DS_Store
+
+# Testing
+.pytest_cache/
+.coverage
+htmlcov/
+.mypy_cache/
+.ruff_cache/
+results/
+
+# Environment
+.env
+.env.local
+
+# Claude Code local overrides (project settings are checked in)
+.claude/settings.local.json
+CLAUDE.local.md
+
+# Data room artifacts (generated at runtime)
+_dd/
+_index/
+_findings/
+_inventory/
+
+# Data room files (prevent accidental commit of customer documents)
+data_room/
+*.pdf
+
+# ChromaDB local storage
+chroma_data/
+
+# Node / misc
+node_modules/
+*.db
+
+# Generated reports
+*.xlsx

dd_agents-0.4.1/.pre-commit-config.yaml

@@ -0,0 +1,20 @@
+repos:
+  - repo: https://github.com/astral-sh/ruff-pre-commit
+    rev: v0.8.0
+    hooks:
+      - id: ruff
+        args: [--fix]
+      - id: ruff-format
+
+  - repo: https://github.com/pre-commit/mirrors-mypy
+    rev: v1.13.0
+    hooks:
+      - id: mypy
+        args: [--strict]
+        additional_dependencies:
+          - pydantic>=2.0
+          - click>=8.0
+          - openpyxl>=3.1
+          - networkx>=3.0
+          - types-openpyxl
+          - types-networkx