bernstein 0.1.0__tar.gz

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

@@ -0,0 +1,43 @@
+name: Bug Report
+description: Something isn't working
+labels: ["bug"]
+body:
+  - type: textarea
+    id: what-happened
+    attributes:
+      label: What happened?
+      description: Describe the bug. What did you expect vs what actually happened?
+      placeholder: "I ran `bernstein conduct --goal '...'` and got..."
+    validations:
+      required: true
+  - type: textarea
+    id: reproduce
+    attributes:
+      label: Steps to reproduce
+      description: Minimal steps to reproduce the issue
+      value: |
+        1.
+        2.
+        3.
+    validations:
+      required: true
+  - type: textarea
+    id: env
+    attributes:
+      label: Environment
+      description: OS, Python version, bernstein version, which CLI agents you use
+      value: |
+        - OS:
+        - Python:
+        - Bernstein:
+        - Agent CLI: Claude Code / Codex / Gemini CLI / Other
+    validations:
+      required: false
+  - type: textarea
+    id: logs
+    attributes:
+      label: Logs
+      description: Paste relevant logs from `bernstein notes` or `.sdd/runtime/`
+      render: shell
+    validations:
+      required: false

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

@@ -0,0 +1,5 @@
+blank_issues_enabled: false
+contact_links:
+  - name: Questions & Ideas
+    url: https://github.com/chernistry/bernstein/discussions
+    about: Ask questions and share ideas in Discussions

bernstein-0.1.0/.github/ISSUE_TEMPLATE/evolve-candidate.md

@@ -0,0 +1,37 @@
+---
+name: Evolve Candidate
+about: Request that Bernstein implement this feature autonomously
+labels: evolve-candidate
+title: "[Evolve] "
+---
+
+<!--
+Bernstein scans issues labelled `evolve-candidate` and `feature-request`.
+If your issue passes the trust check (collaborator author or `maintainer-approved`
+label), Bernstein will convert it to a backlog task, open a PR, and close
+this issue automatically when the PR is merged.
+
+Fill in the sections below so the visionary / analyst pipeline can evaluate
+your request accurately. Free-form text is fine — all fields except Problem
+are optional.
+-->
+
+### Problem
+
+<!-- What is frustrating today? What can't you do? Be concrete. -->
+
+### Proposed solution
+
+<!-- How should it work? CLI examples, pseudocode, or a sketch are all fine. -->
+
+### Impact
+
+<!-- Who benefits, and how much? "Saves N minutes per session", "unblocks X workflow", etc. -->
+
+### Risk
+
+<!-- Any concerns? Breaking changes, security considerations, performance tradeoffs? -->
+
+### Effort
+
+<!-- S / M / L — rough guess. Leave blank if unsure. -->

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

@@ -0,0 +1,34 @@
+name: Feature Request
+description: Suggest an idea
+labels: ["enhancement"]
+body:
+  - type: textarea
+    id: problem
+    attributes:
+      label: Problem
+      description: What problem does this solve? What's frustrating today?
+      placeholder: "When I try to ... I have to ..."
+    validations:
+      required: true
+  - type: textarea
+    id: solution
+    attributes:
+      label: Proposed solution
+      description: How should it work? CLI examples welcome.
+      placeholder: "`bernstein conduct --parallel 4 --goal '...'`"
+    validations:
+      required: false
+  - type: dropdown
+    id: area
+    attributes:
+      label: Area
+      options:
+        - Orchestration
+        - Agent adapters (Claude/Codex/Gemini/Qwen)
+        - CLI / UX
+        - Self-evolution
+        - Verification / Janitor
+        - Documentation
+        - Other
+    validations:
+      required: true

bernstein-0.1.0/.github/copilot-instructions.md

@@ -0,0 +1,28 @@
+# Copilot Instructions
+
+This is Bernstein — a multi-agent orchestrator for CLI coding agents (Claude Code, Codex, Gemini CLI, Qwen).
+
+## Key constraints
+
+- The orchestrator/scheduler must be deterministic Python. Never add LLM calls for coordination or scheduling decisions.
+- Agents are short-lived: spawn per task batch, execute, exit. Do not create long-running agent processes.
+- All runtime state lives in `.sdd/` as files (JSONL, YAML, Markdown). No databases.
+- Use Pydantic models for all data structures.
+- Type hints on all public functions. `pyright` strict mode must pass.
+
+## Before committing
+
+```bash
+uv run ruff check src/
+uv run pyright src/
+uv run pytest
+```
+
+## Architecture
+
+- `src/bernstein/core/server.py` — FastAPI task server (HTTP API on :8052)
+- `src/bernstein/core/orchestrator.py` — deterministic scheduling loop
+- `src/bernstein/core/spawner.py` — launches CLI agents
+- `src/bernstein/core/janitor.py` — verifies task completion via signals
+- `src/bernstein/adapters/` — pluggable CLI adapters (inherit from `CLIAdapter` ABC)
+- `src/bernstein/evolution/` — self-evolution with safety gates

bernstein-0.1.0/.github/dependabot.yml

@@ -0,0 +1,19 @@
+version: 2
+updates:
+  - package-ecosystem: pip
+    directory: /
+    schedule:
+      interval: weekly
+    groups:
+      minor-and-patch:
+        update-types:
+          - minor
+          - patch
+    ignore:
+      - dependency-name: "*"
+        update-types: ["version-update:semver-major"]
+
+  - package-ecosystem: github-actions
+    directory: /
+    schedule:
+      interval: weekly

bernstein-0.1.0/.github/pull_request_template.md

@@ -0,0 +1,19 @@
+## What
+
+<!-- One-liner: what does this PR do? -->
+
+## Why
+
+<!-- What problem does it solve? Link to issue if applicable. -->
+
+## How
+
+<!-- Brief description of the approach. -->
+
+## Checklist
+
+- [ ] `uv run ruff check src/` passes
+- [ ] `uv run pyright src/` passes
+- [ ] `uv run pytest` passes
+- [ ] New code has type hints
+- [ ] Docs updated if needed

bernstein-0.1.0/.github/workflows/bernstein-ci-fix.yml

@@ -0,0 +1,46 @@
+name: "Bernstein CI Fix"
+
+# Trigger when another workflow (e.g. "CI") completes with a failure.
+on:
+  workflow_run:
+    workflows: ["CI"]
+    types: [completed]
+    branches: [main, master]
+
+# Only one fix attempt at a time per branch.
+concurrency:
+  group: bernstein-fix-${{ github.event.workflow_run.head_branch }}
+  cancel-in-progress: true
+
+permissions:
+  contents: write
+  pull-requests: write
+  actions: read
+
+jobs:
+  fix:
+    name: Auto-fix with Bernstein
+    runs-on: ubuntu-latest
+    if: ${{ github.event.workflow_run.conclusion == 'failure' }}
+    steps:
+      - uses: actions/checkout@v4
+        with:
+          ref: ${{ github.event.workflow_run.head_branch }}
+          # Need full history for bernstein worktree operations
+          fetch-depth: 0
+
+      - name: Run Bernstein CI fix
+        uses: ./
+        with:
+          task: fix-ci
+          budget: "5.00"
+          cli: claude
+          max-retries: "3"
+        env:
+          # Provide the API key for whichever CLI agent you use.
+          # For Claude Code:
+          ANTHROPIC_API_KEY: ${{ secrets.ANTHROPIC_API_KEY }}
+          # For Codex:
+          # OPENAI_API_KEY: ${{ secrets.OPENAI_API_KEY }}
+          # For Gemini CLI:
+          # GOOGLE_API_KEY: ${{ secrets.GOOGLE_API_KEY }}

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

@@ -0,0 +1,90 @@
+name: CI
+
+on:
+  push:
+    branches: [master]
+  pull_request:
+
+jobs:
+  lint:
+    name: Lint
+    runs-on: ubuntu-latest
+    steps:
+      - uses: actions/checkout@v4
+      - uses: astral-sh/setup-uv@v5
+        with:
+          enable-cache: true
+      - run: uv run ruff check src/
+      - run: uv run ruff format --check src/
+
+  typecheck:
+    name: Type check
+    runs-on: ubuntu-latest
+    steps:
+      - uses: actions/checkout@v4
+      - uses: astral-sh/setup-uv@v5
+        with:
+          enable-cache: true
+      - run: uv run pyright
+
+  test:
+    name: Test (Python ${{ matrix.python-version }})
+    runs-on: ubuntu-latest
+    strategy:
+      matrix:
+        python-version: ["3.12", "3.13"]
+    steps:
+      - uses: actions/checkout@v4
+      - uses: astral-sh/setup-uv@v5
+        with:
+          enable-cache: true
+          python-version: ${{ matrix.python-version }}
+      - run: uv run python scripts/run_tests.py -x
+
+  # Self-healing: open a GitHub Issue on master when CI fails so the evolve
+  # agent can pick it up as a priority-1 ci-fix task.
+  self-heal:
+    name: Self-heal (create fix issue on failure)
+    runs-on: ubuntu-latest
+    needs: [lint, test]
+    if: >
+      failure() &&
+      github.ref == 'refs/heads/master' &&
+      github.event_name == 'push'
+    permissions:
+      issues: write
+    steps:
+      - uses: actions/checkout@v4
+      - name: Create ci-fix issue
+        env:
+          GH_TOKEN: ${{ secrets.GITHUB_TOKEN }}
+          RUN_URL: ${{ github.server_url }}/${{ github.repository }}/actions/runs/${{ github.run_id }}
+        run: |
+          TITLE="[ci-fix] CI failing on master — run ${{ github.run_id }}"
+          BODY="## CI failure detected
+
+          **Commit:** \`${{ github.sha }}\`
+          **Run:** $RUN_URL
+
+          ### Failing jobs
+          Check the run above for details. Common fixes:
+          - Lint: \`uv run ruff check --fix src/ && uv run ruff format src/\`
+          - Tests: \`uv run pytest tests/ -x -q --tb=short\`
+
+          ### Instructions for the fix agent
+          1. Check the CI run linked above.
+          2. Run the failing checks locally and fix the root cause.
+          3. Verify with: \`uv run ruff check src/ && uv run pytest tests/ -x -q\`
+          4. Push the fix.
+
+          /label ci-fix priority-1"
+
+          # Only open if no open ci-fix issue already exists
+          OPEN=$(gh issue list --label ci-fix --state open --json number --jq length 2>/dev/null || echo 0)
+          if [ "$OPEN" = "0" ]; then
+            gh issue create \
+              --title "$TITLE" \
+              --body "$BODY" \
+              --label "bug" \
+              || true  # Don't fail the workflow if label doesn't exist
+          fi

bernstein-0.1.0/.github/workflows/publish.yml

@@ -0,0 +1,34 @@
+name: Publish
+
+on:
+  push:
+    tags:
+      - "v*"
+
+jobs:
+  build:
+    name: Build
+    runs-on: ubuntu-latest
+    steps:
+      - uses: actions/checkout@v4
+      - uses: astral-sh/setup-uv@v5
+        with:
+          enable-cache: true
+      - run: uv build
+      - uses: actions/upload-artifact@v4
+        with:
+          name: dist
+          path: dist/
+
+  publish:
+    name: Publish to PyPI
+    runs-on: ubuntu-latest
+    needs: build
+    steps:
+      - uses: actions/download-artifact@v4
+        with:
+          name: dist
+          path: dist/
+      - uses: pypa/gh-action-pypi-publish@release/v1
+        with:
+          password: ${{ secrets.PYPI_API_TOKEN }}

bernstein-0.1.0/.gitignore

@@ -0,0 +1,56 @@
+# Python
+__pycache__/
+*.pyc
+*.pyo
+*.egg-info/
+.venv/
+dist/
+build/
+
+# Environment
+.env
+.env.local
+.env.*
+
+# IDE / AI tooling
+.DS_Store
+.idea/
+.vscode/
+.claude/
+*.swp
+
+# Bernstein runtime state (regenerated on each run)
+.sdd/runtime/
+.sdd/metrics/
+.sdd/upgrades/
+.sdd/invariants.lock
+.sdd/sandboxes/
+.sdd/backlog/done/
+.sdd/backlog/PLAN.md
+.sdd/config.json
+.sdd/config.yaml
+.sdd/config/
+.sdd/agents/definitions/
+.sdd/evolution/
+.sdd/researches/
+
+# Proprietary: agent role prompts, design specs, development plans
+templates/roles/
+docs/specs/
+docs/plans/
+
+# Cache
+.pytest_cache/
+.ruff_cache/
+.mypy_cache/
+
+# Coverage
+.coverage
+
+# Failed/ephemeral research artifacts
+.sdd/research/auto/*.json
+
+# Other
+node_modules/
+*.pid
+*.log

bernstein-0.1.0/.sdd/agents/catalog.json

@@ -0,0 +1,102 @@
+[
+  {
+    "role": "manager",
+    "description": "Plans and decomposes goals into tasks.",
+    "model": "opus",
+    "effort": "max",
+    "source": "builtin",
+    "fetched_at": 1774689620.4267368,
+    "ttl_seconds": 300,
+    "metadata": {}
+  },
+  {
+    "role": "backend",
+    "description": "Backend engineer.",
+    "model": "sonnet",
+    "effort": "high",
+    "source": "builtin",
+    "fetched_at": 1774689620.4267368,
+    "ttl_seconds": 300,
+    "metadata": {}
+  },
+  {
+    "role": "frontend",
+    "description": "Frontend engineer.",
+    "model": "sonnet",
+    "effort": "high",
+    "source": "builtin",
+    "fetched_at": 1774689620.4267368,
+    "ttl_seconds": 300,
+    "metadata": {}
+  },
+  {
+    "role": "qa",
+    "description": "Quality assurance and test engineer.",
+    "model": "sonnet",
+    "effort": "normal",
+    "source": "builtin",
+    "fetched_at": 1774689620.4267368,
+    "ttl_seconds": 300,
+    "metadata": {}
+  },
+  {
+    "role": "security",
+    "description": "Security engineer.",
+    "model": "sonnet",
+    "effort": "high",
+    "source": "builtin",
+    "fetched_at": 1774689620.4267368,
+    "ttl_seconds": 300,
+    "metadata": {}
+  },
+  {
+    "role": "devops",
+    "description": "DevOps / infrastructure engineer.",
+    "model": "sonnet",
+    "effort": "normal",
+    "source": "builtin",
+    "fetched_at": 1774689620.4267368,
+    "ttl_seconds": 300,
+    "metadata": {}
+  },
+  {
+    "role": "architect",
+    "description": "System architect.",
+    "model": "opus",
+    "effort": "high",
+    "source": "builtin",
+    "fetched_at": 1774689620.4267368,
+    "ttl_seconds": 300,
+    "metadata": {}
+  },
+  {
+    "role": "reviewer",
+    "description": "Code reviewer.",
+    "model": "sonnet",
+    "effort": "normal",
+    "source": "builtin",
+    "fetched_at": 1774689620.4267368,
+    "ttl_seconds": 300,
+    "metadata": {}
+  },
+  {
+    "role": "docs",
+    "description": "Documentation writer.",
+    "model": "sonnet",
+    "effort": "normal",
+    "source": "builtin",
+    "fetched_at": 1774689620.4267368,
+    "ttl_seconds": 300,
+    "metadata": {}
+  },
+  {
+    "role": "ml-engineer",
+    "description": "Machine-learning engineer.",
+    "model": "sonnet",
+    "effort": "high",
+    "source": "builtin",
+    "fetched_at": 1774689620.4267368,
+    "ttl_seconds": 300,
+    "metadata": {}
+  }
+]