greybeard 0.1.0__tar.gz

greybeard-0.1.0/.env.example

@@ -0,0 +1 @@
+OPENAI_API_KEY=sk-your-key-here

greybeard-0.1.0/.github/FUNDING.yml

@@ -0,0 +1,15 @@
+# These are supported funding model platforms
+
+# github: [btotharye]  # Uncomment and add your GitHub Sponsors username
+# patreon: # Replace with a single Patreon username
+# open_collective: # Replace with a single Open Collective username
+# ko_fi: # Replace with a single Ko-fi username
+# tidelift: # Replace with a single Tidelift platform-name/package-name e.g., npm/babel
+# community_bridge: # Replace with a single Community Bridge project-name e.g., cloud-foundry
+# liberapay: # Replace with a single Liberapay username
+# issuehunt: # Replace with a single IssueHunt username
+# lfx_crowdfunding: # Replace with a single LFX Crowdfunding project-name e.g., cloud-foundry
+# polar: # Replace with a single Polar username
+# buy_me_a_coffee: # Replace with a single Buy Me a Coffee username
+# thanks_dev: # Replace with a single thanks.dev username
+# custom: # Replace with up to 4 custom sponsorship URLs e.g., ['link1', 'link2']

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

@@ -0,0 +1,96 @@
+name: Bug Report
+description: Report a bug or unexpected behavior
+title: "[Bug]: "
+labels: ["bug", "triage"]
+body:
+  - type: markdown
+    attributes:
+      value: |
+        Thanks for taking the time to report a bug! Please fill out the form below.
+
+  - type: textarea
+    id: description
+    attributes:
+      label: Description
+      description: A clear and concise description of what the bug is.
+      placeholder: What happened?
+    validations:
+      required: true
+
+  - type: textarea
+    id: reproduce
+    attributes:
+      label: Steps to Reproduce
+      description: How can we reproduce this issue?
+      placeholder: |
+        1. Configure greybeard with...
+        2. Run command...
+        3. See error...
+    validations:
+      required: true
+
+  - type: textarea
+    id: expected
+    attributes:
+      label: Expected Behavior
+      description: What did you expect to happen?
+    validations:
+      required: true
+
+  - type: textarea
+    id: actual
+    attributes:
+      label: Actual Behavior
+      description: What actually happened? Include error messages if applicable.
+      render: shell
+    validations:
+      required: true
+
+  - type: dropdown
+    id: backend
+    attributes:
+      label: LLM Backend
+      description: Which backend were you using?
+      options:
+        - OpenAI
+        - Anthropic
+        - Ollama
+        - LM Studio
+        - Other
+    validations:
+      required: true
+
+  - type: input
+    id: model
+    attributes:
+      label: Model
+      description: Which model were you using?
+      placeholder: e.g., gpt-4o, claude-3-5-sonnet, llama3.2
+
+  - type: textarea
+    id: version
+    attributes:
+      label: Version Information
+      description: Run `greybeard --version` and paste the output
+      render: shell
+    validations:
+      required: true
+
+  - type: input
+    id: os
+    attributes:
+      label: Operating System
+      placeholder: e.g., macOS 14.2, Ubuntu 22.04, Windows 11
+
+  - type: textarea
+    id: config
+    attributes:
+      label: Configuration
+      description: Paste your config (from `greybeard config show`). Redact API keys!
+      render: yaml
+
+  - type: textarea
+    id: additional
+    attributes:
+      label: Additional Context
+      description: Any other context, screenshots, or information that might help

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

@@ -0,0 +1,8 @@
+blank_issues_enabled: true
+contact_links:
+  - name: Documentation
+    url: https://greybeard.readthedocs.io
+    about: Check the documentation for guides and reference
+  - name: Discussions
+    url: https://github.com/btotharye/greybeard/discussions
+    about: Ask questions, share ideas, and discuss with the community

greybeard-0.1.0/.github/ISSUE_TEMPLATE/content_pack.yml

@@ -0,0 +1,70 @@
+name: Content Pack Submission
+description: Submit a new content pack for review
+title: "[Pack]: "
+labels: ["content-pack", "community"]
+body:
+  - type: markdown
+    attributes:
+      value: |
+        Thanks for contributing a content pack! This helps the whole community.
+
+  - type: input
+    id: pack-name
+    attributes:
+      label: Pack Name
+      description: What's the name of your pack?
+      placeholder: e.g., security-engineer, sre-perspective
+    validations:
+      required: true
+
+  - type: textarea
+    id: description
+    attributes:
+      label: Description
+      description: What perspective does this pack provide?
+      placeholder: This pack provides a security engineer's perspective, focusing on...
+    validations:
+      required: true
+
+  - type: dropdown
+    id: submission-type
+    attributes:
+      label: Submission Type
+      options:
+        - New pack for this repository (packs/ directory)
+        - Link to my pack repository
+    validations:
+      required: true
+
+  - type: textarea
+    id: pack-yaml
+    attributes:
+      label: Pack Content
+      description: If submitting to this repo, paste your pack YAML here
+      render: yaml
+
+  - type: input
+    id: pack-url
+    attributes:
+      label: Pack Repository URL
+      description: If you have a pack repository, link it here
+      placeholder: https://github.com/username/my-greybeard-packs
+
+  - type: textarea
+    id: example-output
+    attributes:
+      label: Example Output
+      description: Optional but helpful - show an example of a review using this pack
+      render: markdown
+
+  - type: checkboxes
+    id: checklist
+    attributes:
+      label: Pack Checklist
+      options:
+        - label: Pack follows the schema documented in docs/reference/pack-schema.md
+          required: true
+        - label: I've tested this pack with greybeard
+          required: true
+        - label: The perspective is clear and distinct from existing packs
+          required: true

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

@@ -0,0 +1,54 @@
+name: Feature Request
+description: Suggest a new feature or enhancement
+title: "[Feature]: "
+labels: ["enhancement"]
+body:
+  - type: markdown
+    attributes:
+      value: |
+        Thanks for suggesting a feature! Please describe what you'd like to see.
+
+  - type: textarea
+    id: problem
+    attributes:
+      label: Problem Statement
+      description: Is your feature request related to a problem? Please describe.
+      placeholder: I'm frustrated when...
+    validations:
+      required: true
+
+  - type: textarea
+    id: solution
+    attributes:
+      label: Proposed Solution
+      description: Describe the solution you'd like to see
+      placeholder: I'd like greybeard to...
+    validations:
+      required: true
+
+  - type: textarea
+    id: alternatives
+    attributes:
+      label: Alternatives Considered
+      description: Have you considered any alternative solutions or workarounds?
+
+  - type: dropdown
+    id: type
+    attributes:
+      label: Feature Type
+      description: What kind of feature is this?
+      options:
+        - New LLM backend support
+        - New content pack
+        - CLI enhancement
+        - MCP integration improvement
+        - Documentation improvement
+        - Other
+    validations:
+      required: true
+
+  - type: textarea
+    id: additional
+    attributes:
+      label: Additional Context
+      description: Add any other context, examples, or screenshots about the feature request

greybeard-0.1.0/.github/PULL_REQUEST_TEMPLATE.md

@@ -0,0 +1,46 @@
+## Description
+
+<!-- Briefly describe what this PR does -->
+
+## Type of Change
+
+- [ ] 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
+- [ ] Content pack addition/update
+- [ ] CI/CD or tooling change
+
+## Changes Made
+
+<!-- List the specific changes or provide more details -->
+
+-
+-
+
+## Testing
+
+<!-- Describe how you tested these changes -->
+
+- [ ] Tests pass locally (`make test`)
+- [ ] Linting passes (`make lint`)
+- [ ] Formatting is correct (`make format-check`)
+- [ ] Tested manually with: <!-- specify LLM backend and command -->
+
+## Related Issues
+
+<!-- Link any related issues: Closes #123, Fixes #456 -->
+
+## Checklist
+
+- [ ] My code follows the project's style guidelines
+- [ ] I have performed a self-review of my code
+- [ ] I have commented my code, particularly in hard-to-understand areas
+- [ ] I have made corresponding changes to the documentation
+- [ ] My changes generate no new warnings or errors
+- [ ] I have added tests that prove my fix is effective or that my feature works
+- [ ] New and existing tests pass locally with my changes
+
+## Additional Notes
+
+<!-- Any additional information, context, or screenshots -->

greybeard-0.1.0/.github/REPOSITORY_SETUP.md

@@ -0,0 +1,158 @@
+# GitHub Repository Configuration
+
+This file documents the recommended GitHub repository settings for greybeard.
+
+## Repository Settings
+
+### General
+
+**Description:**
+
+> CLI-first Staff/Principal engineer review assistant powered by LLMs. Works with OpenAI, Anthropic, Ollama, and more.
+
+**Topics (keywords):**
+
+```
+code-review
+llm
+ai
+staff-engineer
+architecture
+cli
+openai
+anthropic
+ollama
+python
+mcp
+model-context-protocol
+code-quality
+```
+
+**Features:**
+
+- ✅ Issues
+- ✅ Projects
+- ✅ Discussions
+- ✅ Wiki (optional)
+- ✅ Sponsorships (if configured in FUNDING.yml)
+
+**Social Preview Image:**
+Consider creating a 1280x640 image with:
+
+- greybeard ASCII art
+- Project name
+- Tagline: "Staff-level code review from the command line"
+
+### Branch Protection (for `main`)
+
+**Required:**
+
+- ✅ Require a pull request before merging
+- ✅ Require status checks to pass before merging
+  - `test (3.11)`
+  - `test (3.12)`
+  - `test (3.13)`
+  - `lint`
+- ✅ Require conversation resolution before merging
+- ✅ Do not allow bypassing the above settings
+
+**Optional:**
+
+- Require linear history
+- Include administrators (for solo maintainer, may want to disable)
+
+### Security
+
+**Advisories:**
+
+- ✅ Enable private vulnerability reporting
+
+**Dependabot:**
+
+- ✅ Alerts enabled (configured via `.github/dependabot.yml`)
+- ✅ Security updates enabled
+
+**Code Scanning:**
+
+- Consider enabling CodeQL for Python
+
+### Automation
+
+**GitHub Actions:**
+See `.github/workflows/` for:
+
+- `ci.yml` - Tests and linting on PRs
+- `docs.yml` - Documentation builds
+- `publish.yml` - PyPI publishing on releases
+- `stale.yml` - Closes stale issues/PRs
+
+### Community Standards
+
+All files present:
+
+- ✅ LICENSE
+- ✅ README.md
+- ✅ CODE_OF_CONDUCT.md
+- ✅ CONTRIBUTING.md
+- ✅ SECURITY.md
+- ✅ Issue templates
+- ✅ PR template
+- ✅ Funding (optional)
+
+## Environment Secrets
+
+For PyPI publishing (after first manual upload), configure in repository settings:
+
+**Environments → `pypi`:**
+
+- No secrets needed (uses trusted publishing)
+
+**Environments → `testpypi`:**
+
+- No secrets needed (uses trusted publishing)
+
+## Discussions Categories
+
+Recommended categories:
+
+- 💡 Ideas - Feature requests and suggestions
+- 🙋 Q&A - Questions and answers
+- 📣 Announcements - Project updates
+- 🎨 Show and Tell - Share your content packs
+- 💬 General - Everything else
+
+## Labels
+
+The issue templates will create these labels automatically:
+
+- `bug`
+- `enhancement`
+- `triage`
+- `content-pack`
+- `community`
+- `dependencies`
+- `python`
+- `github-actions`
+- `stale`
+
+Additional recommended labels:
+
+- `good first issue`
+- `help wanted`
+- `documentation`
+- `question`
+- `wontfix`
+- `duplicate`
+
+## Applying These Settings
+
+Most settings must be configured through the GitHub web UI:
+
+1. Go to `https://github.com/btotharye/greybeard/settings`
+2. Update **Description** and **Topics** under General
+3. Configure **Branch protection rules** under Branches
+4. Enable **Discussions** under General → Features
+5. Review **Security** settings under Security & analysis
+6. Create **Environments** (`pypi`, `testpypi`) under Environments
+
+Note: The YAML files in `.github/` handle automation (workflows, issue templates, dependabot).

greybeard-0.1.0/.github/dependabot.yml

@@ -0,0 +1,41 @@
+version: 2
+updates:
+  # Python dependencies
+  - package-ecosystem: "pip"
+    directory: "/"
+    schedule:
+      interval: "weekly"
+      day: "monday"
+    open-pull-requests-limit: 5
+    labels:
+      - "dependencies"
+      - "python"
+    commit-message:
+      prefix: "chore(deps)"
+    groups:
+      dev-dependencies:
+        patterns:
+          - "pytest*"
+          - "ruff"
+        update-types:
+          - "minor"
+          - "patch"
+      docs-dependencies:
+        patterns:
+          - "mkdocs*"
+          - "pymdown-extensions"
+        update-types:
+          - "minor"
+          - "patch"
+
+  # GitHub Actions
+  - package-ecosystem: "github-actions"
+    directory: "/"
+    schedule:
+      interval: "weekly"
+      day: "monday"
+    labels:
+      - "dependencies"
+      - "github-actions"
+    commit-message:
+      prefix: "chore(ci)"

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

@@ -0,0 +1,64 @@
+name: CI
+
+on:
+  push:
+    branches: [main]
+  pull_request:
+    branches: [main]
+
+jobs:
+  test:
+    name: Test (Python ${{ matrix.python-version }})
+    runs-on: ubuntu-latest
+    strategy:
+      fail-fast: false
+      matrix:
+        python-version: ["3.11", "3.12", "3.13"]
+
+    steps:
+      - uses: actions/checkout@v4
+
+      - name: Install uv
+        uses: astral-sh/setup-uv@v4
+        with:
+          version: "latest"
+
+      - name: Set up Python ${{ matrix.python-version }}
+        run: uv python install ${{ matrix.python-version }}
+
+      - name: Install dependencies
+        run: uv sync --extra dev
+
+      - name: Run tests
+        run: uv run pytest --tb=short -q
+
+      - name: Upload coverage
+        if: matrix.python-version == '3.11'
+        uses: actions/upload-artifact@v4
+        with:
+          name: coverage
+          path: .coverage
+
+  lint:
+    name: Lint
+    runs-on: ubuntu-latest
+
+    steps:
+      - uses: actions/checkout@v4
+
+      - name: Install uv
+        uses: astral-sh/setup-uv@v4
+        with:
+          version: "latest"
+
+      - name: Set up Python
+        run: uv python install 3.11
+
+      - name: Install dependencies
+        run: uv sync --extra dev
+
+      - name: Run ruff
+        run: uv run ruff check .
+
+      - name: Check ruff formatting
+        run: uv run ruff format --check .

greybeard-0.1.0/.github/workflows/docs.yml

@@ -0,0 +1,43 @@
+name: Docs
+
+on:
+  push:
+    branches: [main]
+    paths:
+      - "docs/**"
+      - "mkdocs.yml"
+      - ".readthedocs.yaml"
+  pull_request:
+    branches: [main]
+    paths:
+      - "docs/**"
+      - "mkdocs.yml"
+
+jobs:
+  build:
+    name: Build docs
+    runs-on: ubuntu-latest
+
+    steps:
+      - uses: actions/checkout@v4
+
+      - name: Install uv
+        uses: astral-sh/setup-uv@v4
+        with:
+          version: "latest"
+
+      - name: Set up Python
+        run: uv python install 3.11
+
+      - name: Install dependencies
+        run: uv sync --extra docs
+
+      - name: Build docs
+        run: uv run mkdocs build --strict
+
+      - name: Upload docs artifact
+        uses: actions/upload-artifact@v4
+        with:
+          name: docs-site
+          path: site/
+          retention-days: 7

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

@@ -0,0 +1,77 @@
+name: Publish to PyPI
+
+on:
+  release:
+    types: [published]
+  workflow_dispatch: # Allow manual trigger for testing
+
+jobs:
+  build:
+    name: Build distribution
+    runs-on: ubuntu-latest
+
+    steps:
+      - uses: actions/checkout@v4
+
+      - name: Install uv
+        uses: astral-sh/setup-uv@v4
+        with:
+          version: "latest"
+
+      - name: Set up Python
+        run: uv python install 3.11
+
+      - name: Install build dependencies
+        run: uv pip install build
+
+      - name: Build package
+        run: uv run --python 3.11 python -m build
+
+      - name: Store the distribution packages
+        uses: actions/upload-artifact@v4
+        with:
+          name: python-package-distributions
+          path: dist/
+
+  publish-to-pypi:
+    name: Publish to PyPI
+    needs: [build]
+    runs-on: ubuntu-latest
+    environment:
+      name: pypi
+      url: https://pypi.org/p/greybeard
+    permissions:
+      id-token: write # IMPORTANT: mandatory for trusted publishing
+
+    steps:
+      - name: Download all the dists
+        uses: actions/download-artifact@v4
+        with:
+          name: python-package-distributions
+          path: dist/
+
+      - name: Publish distribution to PyPI
+        uses: pypa/gh-action-pypi-publish@release/v1
+
+  publish-to-testpypi:
+    name: Publish to TestPyPI
+    needs: [build]
+    runs-on: ubuntu-latest
+    if: github.event_name == 'workflow_dispatch' # Only on manual trigger
+    environment:
+      name: testpypi
+      url: https://test.pypi.org/p/greybeard
+    permissions:
+      id-token: write
+
+    steps:
+      - name: Download all the dists
+        uses: actions/download-artifact@v4
+        with:
+          name: python-package-distributions
+          path: dist/
+
+      - name: Publish distribution to TestPyPI
+        uses: pypa/gh-action-pypi-publish@release/v1
+        with:
+          repository-url: https://test.pypi.org/legacy/