scrum-agent 1.0.0__tar.gz

scrum_agent-1.0.0/.env.example

@@ -0,0 +1,55 @@
+# LLM Provider
+# Options: anthropic (default), openai, google
+# Install additional providers: uv sync --extra openai   or   uv sync --extra google
+LLM_PROVIDER=anthropic
+# Optional: override the default model for the selected provider
+# Anthropic default: claude-sonnet-4-20250514
+# OpenAI default:    gpt-4o
+# Google default:    gemini-2.0-flash
+LLM_MODEL=
+
+# Anthropic (required when LLM_PROVIDER=anthropic)
+ANTHROPIC_API_KEY=your-anthropic-api-key
+
+# OpenAI (required when LLM_PROVIDER=openai)
+OPENAI_API_KEY=your-openai-api-key
+
+# Google AI (required when LLM_PROVIDER=google)
+GOOGLE_API_KEY=your-google-api-key
+
+# LangSmith (optional — enables tracing for development)
+LANGSMITH_TRACING=true
+LANGSMITH_API_KEY=your-langsmith-api-key
+LANGSMITH_PROJECT=scrum-agent
+
+# GitHub (optional — enables repo context tools; required for private repos and higher rate limits)
+# Fine-grained PAT: Contents=Read, Issues=Read, Metadata=Read
+# Classic PAT: public_repo (public repos) or repo (private repos)
+# No token: works for public repos at 60 req/hour (unauthenticated)
+GITHUB_TOKEN=your-github-personal-access-token
+
+# Azure DevOps (optional — enables repo context tools; required for private projects)
+# PAT permissions needed: Code=Read, Work Items=Read
+AZURE_DEVOPS_TOKEN=your-azure-devops-personal-access-token
+
+# Jira Cloud / Atlassian (optional — enables Jira board read + issue creation tools)
+# API token: id.atlassian.com → Security → API tokens
+# No trailing slash on JIRA_BASE_URL
+JIRA_BASE_URL=https://your-org.atlassian.net
+JIRA_EMAIL=you@example.com
+JIRA_API_TOKEN=your-jira-api-token
+JIRA_PROJECT_KEY=MYPROJ
+
+# Confluence (optional — shares Atlassian auth with Jira; only space key is new)
+# Space key is the short identifier visible in your Confluence space URL
+CONFLUENCE_SPACE_KEY=MYSPACE
+
+# Session management
+# Auto-prune sessions older than N days (default 30, set to 0 to disable)
+SESSION_PRUNE_DAYS=30
+
+# Logging
+# Controls the file logger at ~/.scrum-agent/scrum-agent.log
+# Values: DEBUG, INFO, WARNING (default), ERROR
+# Set to DEBUG to capture full diagnostics for troubleshooting
+LOG_LEVEL=WARNING

scrum_agent-1.0.0/.github/workflows/ci.yml

@@ -0,0 +1,79 @@
+name: CI
+
+on:
+  push:
+    branches: [main]
+  pull_request:
+    branches: [main]
+
+# Least-privilege token — these jobs only check out code and run tests.
+permissions:
+  contents: read
+
+# Cancel in-progress runs on the same branch when a new push arrives.
+concurrency:
+  group: ${{ github.workflow }}-${{ github.ref }}
+  cancel-in-progress: true
+
+jobs:
+  # ── Fast gate ────────────────────────────────────────────────────────────
+  # Unit tests — also enforced locally by the pre-commit hook in
+  # .pre-commit-config.yaml. Running them in CI too catches contributors
+  # who haven't installed pre-commit.
+  unit:
+    name: Unit tests
+    runs-on: ubuntu-latest
+    steps:
+      - uses: actions/checkout@v4
+      - uses: astral-sh/setup-uv@v4
+      - run: uv python install 3.11
+      - run: uv sync --extra dev
+      - run: make test-fast
+
+  # ── Slow suite ───────────────────────────────────────────────────────────
+  # Integration + contract tests (marked @pytest.mark.slow) — too slow for
+  # pre-commit but must pass before any PR merges. All external calls are
+  # mocked or VCR-replayed; no real API keys required.
+  integration:
+    name: Integration & contract tests
+    runs-on: ubuntu-latest
+    steps:
+      - uses: actions/checkout@v4
+      - uses: astral-sh/setup-uv@v4
+      - run: uv python install 3.11
+      - run: uv sync --extra dev
+      - run: make test
+
+  # ── Golden evaluators ────────────────────────────────────────────────────
+  # LLM-output quality checks against the golden dataset.
+  # Kept separate so a quality regression doesn't block unrelated PRs.
+  eval:
+    name: Golden evaluators
+    runs-on: ubuntu-latest
+    steps:
+      - uses: actions/checkout@v4
+      - uses: astral-sh/setup-uv@v4
+      - run: uv python install 3.11
+      - run: uv sync --extra dev
+      - run: make eval
+
+  # ── Code quality ─────────────────────────────────────────────────────────
+  lint:
+    name: Lint (ruff)
+    runs-on: ubuntu-latest
+    steps:
+      - uses: actions/checkout@v4
+      - uses: astral-sh/setup-uv@v4
+      - run: uv python install 3.11
+      - run: uv sync --extra dev
+      - run: make lint
+
+  format-check:
+    name: Format check (ruff)
+    runs-on: ubuntu-latest
+    steps:
+      - uses: actions/checkout@v4
+      - uses: astral-sh/setup-uv@v4
+      - run: uv python install 3.11
+      - run: uv sync --extra dev
+      - run: uv run ruff format --check src/ tests/

scrum_agent-1.0.0/.github/workflows/claude-code-review.yml

@@ -0,0 +1,43 @@
+name: Claude Code Review
+
+on:
+  pull_request:
+    types: [opened, synchronize, ready_for_review, reopened]
+    # Optional: Only run on specific file changes
+    # paths:
+    #   - "src/**/*.ts"
+    #   - "src/**/*.tsx"
+    #   - "src/**/*.js"
+    #   - "src/**/*.jsx"
+
+jobs:
+  claude-review:
+    # Optional: Filter by PR author
+    # if: |
+    #   github.event.pull_request.user.login == 'external-contributor' ||
+    #   github.event.pull_request.user.login == 'new-developer' ||
+    #   github.event.pull_request.author_association == 'FIRST_TIME_CONTRIBUTOR'
+
+    runs-on: ubuntu-latest
+    permissions:
+      contents: read
+      pull-requests: read
+      issues: read
+      id-token: write
+
+    steps:
+      - name: Checkout repository
+        uses: actions/checkout@v4
+        with:
+          fetch-depth: 1
+
+      - name: Run Claude Code Review
+        id: claude-review
+        uses: anthropics/claude-code-action@v1
+        with:
+          claude_code_oauth_token: ${{ secrets.CLAUDE_CODE_OAUTH_TOKEN }}
+          plugin_marketplaces: 'https://github.com/anthropics/claude-code.git'
+          plugins: 'code-review@claude-code-plugins'
+          prompt: '/code-review:code-review ${{ github.repository }}/pull/${{ github.event.pull_request.number }}'
+          # See https://github.com/anthropics/claude-code-action/blob/main/docs/usage.md
+          # or https://code.claude.com/docs/en/cli-reference for available options

scrum_agent-1.0.0/.github/workflows/claude.yml

@@ -0,0 +1,49 @@
+name: Claude Code
+
+on:
+  issue_comment:
+    types: [created]
+  pull_request_review_comment:
+    types: [created]
+  issues:
+    types: [opened, assigned]
+  pull_request_review:
+    types: [submitted]
+
+jobs:
+  claude:
+    if: |
+      (github.event_name == 'issue_comment' && contains(github.event.comment.body, '@claude')) ||
+      (github.event_name == 'pull_request_review_comment' && contains(github.event.comment.body, '@claude')) ||
+      (github.event_name == 'pull_request_review' && contains(github.event.review.body, '@claude')) ||
+      (github.event_name == 'issues' && (contains(github.event.issue.body, '@claude') || contains(github.event.issue.title, '@claude')))
+    runs-on: ubuntu-latest
+    permissions:
+      contents: read
+      pull-requests: read
+      issues: read
+      id-token: write
+      actions: read # Required for Claude to read CI results on PRs
+    steps:
+      - name: Checkout repository
+        uses: actions/checkout@v4
+        with:
+          fetch-depth: 1
+
+      - name: Run Claude Code
+        id: claude
+        uses: anthropics/claude-code-action@v1
+        with:
+          claude_code_oauth_token: ${{ secrets.CLAUDE_CODE_OAUTH_TOKEN }}
+
+          # This is an optional setting that allows Claude to read CI results on PRs
+          additional_permissions: |
+            actions: read
+
+          # Optional: Give a custom prompt to Claude. If this is not specified, Claude will perform the instructions specified in the comment that tagged it.
+          # prompt: 'Update the pull request description to include a summary of changes.'
+
+          # Optional: Add claude_args to customize behavior and configuration
+          # See https://github.com/anthropics/claude-code-action/blob/main/docs/usage.md
+          # or https://code.claude.com/docs/en/cli-reference for available options
+          # claude_args: '--allowed-tools Bash(gh pr:*)'

scrum_agent-1.0.0/.github/workflows/publish.yml

@@ -0,0 +1,77 @@
+name: Publish to PyPI
+
+on:
+  push:
+    tags:
+      - "v*"
+
+permissions:
+  contents: write   # GitHub Release
+  id-token: write   # PyPI trusted publishing (OIDC)
+
+jobs:
+  test:
+    name: Lint & Test
+    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: Install dependencies
+        run: uv sync --extra dev
+
+      - name: Lint
+        run: make lint
+
+      - name: Test
+        run: make test
+
+  publish:
+    name: Build & Publish to PyPI
+    needs: test
+    runs-on: ubuntu-latest
+    environment: pypi
+    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: Build
+        run: uv build
+
+      - name: Publish to PyPI
+        uses: pypa/gh-action-pypi-publish@release/v1
+
+  release:
+    name: GitHub Release
+    needs: publish
+    runs-on: ubuntu-latest
+    steps:
+      - uses: actions/checkout@v4
+
+      - name: Create GitHub Release
+        uses: softprops/action-gh-release@v2
+        with:
+          generate_release_notes: true
+
+  update-homebrew:
+    name: Notify Homebrew Tap
+    needs: publish
+    runs-on: ubuntu-latest
+    steps:
+      - name: Repository Dispatch
+        uses: peter-evans/repository-dispatch@v3
+        with:
+          token: ${{ secrets.HOMEBREW_TAP_TOKEN }}
+          repository: omardin14/homebrew-tap
+          event-type: update-formula
+          client-payload: '{"version": "${{ github.ref_name }}"}'

scrum_agent-1.0.0/.github/workflows/smoke.yml

@@ -0,0 +1,44 @@
+name: Smoke Tests
+
+on:
+  schedule:
+    # Every Monday at 06:00 UTC
+    - cron: "0 6 * * 1"
+  workflow_dispatch: # Allow manual trigger from GitHub UI
+
+# Least-privilege token — this job only checks out code and runs tests.
+# Real API credentials are injected via repository secrets, not GITHUB_TOKEN.
+permissions:
+  contents: read
+
+jobs:
+  smoke:
+    if: false  # Disabled — re-enable when secrets are configured
+    runs-on: ubuntu-latest
+    steps:
+      - uses: actions/checkout@v4
+      - uses: astral-sh/setup-uv@v4
+      - run: uv python install 3.11
+      - run: uv sync --extra dev --extra all-providers
+
+      - name: Run smoke tests
+        env:
+          # Jira / Confluence
+          JIRA_BASE_URL: ${{ secrets.JIRA_BASE_URL }}
+          JIRA_EMAIL: ${{ secrets.JIRA_EMAIL }}
+          JIRA_API_TOKEN: ${{ secrets.JIRA_API_TOKEN }}
+          JIRA_PROJECT_KEY: ${{ secrets.JIRA_PROJECT_KEY }}
+          CONFLUENCE_SPACE_KEY: ${{ secrets.CONFLUENCE_SPACE_KEY }}
+          # SMOKE_GITHUB_TOKEN: a PAT for broader GitHub access (cross-org calls etc.)
+          # GITHUB_BUILTIN_TOKEN: always has contents:read for this repo; used as
+          # a runtime fallback in conftest.py when the PAT returns 404.
+          GITHUB_TOKEN: ${{ secrets.SMOKE_GITHUB_TOKEN }}
+          GITHUB_BUILTIN_TOKEN: ${{ github.token }}
+          # Azure DevOps
+          AZURE_DEVOPS_TOKEN: ${{ secrets.AZURE_DEVOPS_TOKEN }}
+          AZURE_DEVOPS_SMOKE_REPO_URL: ${{ secrets.AZURE_DEVOPS_SMOKE_REPO_URL }}
+          # LLM providers
+          ANTHROPIC_API_KEY: ${{ secrets.ANTHROPIC_API_KEY }}
+          OPENAI_API_KEY: ${{ secrets.OPENAI_API_KEY }}
+          GOOGLE_API_KEY: ${{ secrets.GOOGLE_API_KEY }}
+        run: make smoke-test

scrum_agent-1.0.0/.gitignore

@@ -0,0 +1,62 @@
+# Python
+__pycache__/
+*.py[cod]
+*$py.class
+*.so
+*.egg
+*.egg-info/
+dist/
+build/
+eggs/
+*.whl
+.eggs/
+
+# Virtual environments
+.venv/
+venv/
+env/
+ENV/
+
+# Environment variables
+.env
+.env.local
+.env.*.local
+
+# IDE
+.vscode/
+.idea/
+*.swp
+*.swo
+*~
+.DS_Store
+
+# Testing
+.pytest_cache/
+.coverage
+htmlcov/
+.tox/
+
+# Vector store
+chroma_db/
+
+# LangSmith / LangChain
+.langsmith/
+
+# Distribution
+*.tar.gz
+*.zip
+
+# Jupyter
+.ipynb_checkpoints/
+
+# Generated output
+scrum-plan.*
+scrum-questionnaire.md
+
+# References
+Capacity_Plan_Template.xlsx
+SCRUM.md
+
+# Allow test fixtures (overrides SCRUM.md ignore above)
+!tests/fixtures/SCRUM.md
+!projects/*/SCRUM.md

scrum_agent-1.0.0/.pre-commit-config.yaml

@@ -0,0 +1,28 @@
+repos:
+  - repo: https://github.com/pre-commit/pre-commit-hooks
+    rev: v5.0.0
+    hooks:
+      - id: trailing-whitespace
+        exclude: \.ambr$
+      - id: end-of-file-fixer
+      - id: check-yaml
+      - id: check-added-large-files
+      - id: check-merge-conflict
+
+  - repo: https://github.com/astral-sh/ruff-pre-commit
+    rev: v0.15.2
+    hooks:
+      - id: ruff
+        args: [--fix]
+      - id: ruff-format
+
+  # Run unit tests before every commit (< 3s, no API keys, no graph compilation).
+  # Integration + contract tests run in CI on every PR — see .github/workflows/ci.yml.
+  - repo: local
+    hooks:
+      - id: unit-tests
+        name: Unit tests
+        language: system
+        entry: uv run pytest tests/unit/ --tb=short -q
+        pass_filenames: false
+        files: \.py$