buildbard 1.0.0__tar.gz

buildbard-1.0.0/.env.example

@@ -0,0 +1 @@
+# no secrets required yet

buildbard-1.0.0/.gitattributes

@@ -0,0 +1,5 @@
+# DeviaTDD append-only JSONL ledgers: union-merge so concurrent
+# appends never conflict at branch-merge time.
+# See specs/constitution.md §1 Append-Only Ledger Protocol.
+specs/issues.jsonl merge=union
+specs/**/tasks.jsonl merge=union

buildbard-1.0.0/.githooks/pre-commit

@@ -0,0 +1,5 @@
+#!/bin/sh
+# Checked-in hook; enable with `mise run setup-hooks`.
+# Constitution section 3: pre-commit runs format-check plus lint on staged files.
+set -e
+mise run pre-commit-staged

buildbard-1.0.0/.githooks/pre-push

@@ -0,0 +1,5 @@
+#!/bin/sh
+# Checked-in hook; enable with `mise run setup-hooks`.
+# Constitution section 3: pre-push runs unit only.
+set -e
+mise run pre-push

buildbard-1.0.0/.github/workflows/release.yml

@@ -0,0 +1,90 @@
+name: Release
+
+on:
+  workflow_dispatch:
+    inputs:
+      bump:
+        description: SemVer bump (auto from gitmoji conventional commits, or explicit)
+        required: false
+        default: auto
+        type: choice
+        options:
+          - auto
+          - patch
+          - minor
+          - major
+      dry_run:
+        description: Print the computed version and skip commit, tag, and release
+        required: false
+        default: false
+        type: boolean
+
+permissions:
+  contents: write
+  id-token: write
+
+jobs:
+  release:
+    name: Cut and release
+    runs-on: ubuntu-latest
+    steps:
+      - name: Refuse non-default branch unless dry_run
+        if: ${{ github.ref_name != github.event.repository.default_branch && inputs.dry_run != true }}
+        run: |
+          echo "Refusing to release from '${GITHUB_REF_NAME}'."
+          echo "Default branch is '${{ github.event.repository.default_branch }}'."
+          echo "Re-run with dry_run=true to preview, or run from the default branch."
+          exit 1
+
+      - uses: actions/checkout@v4
+        with:
+          fetch-depth: 0
+          ref: ${{ github.ref }}
+
+      - name: Install uv
+        uses: astral-sh/setup-uv@v6
+        with:
+          python-version: "3.13"
+
+      - name: Compute next version
+        id: version
+        run: |
+          set -euo pipefail
+          VERSION="$(uv run --no-project python scripts/next_version.py --bump "${{ inputs.bump }}")"
+          echo "version=${VERSION}" >> "${GITHUB_OUTPUT}"
+          echo "Computed next version: ${VERSION}"
+
+      - name: Dry run complete
+        if: ${{ inputs.dry_run == true }}
+        run: |
+          echo "dry_run=true — skipping commit, tag, and release for ${{ steps.version.outputs.version }}"
+
+      - name: Apply version bump
+        if: ${{ inputs.dry_run != true }}
+        run: |
+          set -euo pipefail
+          uv run --no-project python scripts/next_version.py --bump "${{ inputs.bump }}" --write
+
+      - name: Commit, tag, and push
+        if: ${{ inputs.dry_run != true }}
+        run: |
+          set -euo pipefail
+          VERSION="${{ steps.version.outputs.version }}"
+          git config user.name "github-actions[bot]"
+          git config user.email "41898282+github-actions[bot]@users.noreply.github.com"
+          git add pyproject.toml uv.lock
+          git commit -m "🔧 chore(release): version ${VERSION}"
+          git tag "v${VERSION}"
+          git push origin "HEAD:${GITHUB_REF_NAME}"
+          git push origin "v${VERSION}"
+
+      - name: Create GitHub Release and publish to PyPI
+        if: ${{ inputs.dry_run != true }}
+        env:
+          GH_TOKEN: ${{ github.token }}
+        run: |
+          set -euo pipefail
+          VERSION="${{ steps.version.outputs.version }}"
+          gh release create "v${VERSION}" --title "v${VERSION}" --generate-notes
+          uv build
+          uv publish --trusted-publishing always

buildbard-1.0.0/.gitignore

@@ -0,0 +1,11 @@
+__pycache__/
+*.py[cod]
+.venv/
+.ruff_cache/
+.pytest_cache/
+.mypy_cache/
+dist/
+build/
+*.egg-info/
+.env
+.deviate/handovers/

buildbard-1.0.0/AGENTS.md

@@ -0,0 +1 @@
+CLAUDE.md

buildbard-1.0.0/CLAUDE.md

@@ -0,0 +1,34 @@
+# Vision source of truth: `docs/` (start at `docs/00-overview.md`). Consult it when behavior, scope, or design intent is unclear.
+# Bard skills source of truth: `src/buildbard/data/skills/*-SKILL.md`. Never read installed copies in `.agents/skills/` — they are generated output.
+
+## ⚡ DeviaTDD Verification and Mise Tasks
+
+Use `mise run <task>`:
+
+| Task | Purpose |
+|------|---------|
+| `mise run test` | Unit tests by default |
+
+| `mise run test:unit` | Unit tests only |
+| `mise run test:integration` | Unit plus integration tests |
+| `mise run test:e2e` | Unit plus integration plus E2E tests |
+| `mise run doctor` | Readiness |
+| `mise run doctor:unit` | Unit readiness |
+| `mise run doctor:integration` | Unit+integration readiness |
+| `mise run doctor:e2e` | Unit+integration+E2E readiness |
+
+Targeted testing: `mise run test:one -- <file> [-k <name>]`. Behavior checks: `mise run verify` (see `docs/verification.md`).
+Before completion, run the matching `test:*` layer task.
+
+Unit tests must not require external services.
+Unit tests never invoke the git binary: stub git seams
+(`commit_post`, `_clean_head`, `_commit_drop`, `_issue_files`,
+`_current_branch`) or pre-create `.git` to skip `git init`.
+`tests/unit/conftest.py` fails any test that shells out to git.
+Put service-dependent checks in integration tests.
+Integration tests may use git only inside an isolated sandbox
+(fresh `tmp_path` repo, never the working checkout).
+
+## Commit convention
+
+Before any commit, read CONTRIBUTING.md and apply its gitmoji + Conventional Commits rules.

buildbard-1.0.0/CONTRIBUTING.md

@@ -0,0 +1,64 @@
+# Contributing
+
+## Commit message convention
+
+This repo uses [Conventional Commits 1.0](https://www.conventionalcommits.org/)
+with an [emoji prefix](https://gitmoji.dev/) for visual scannability.
+
+### Format
+
+```
+<emoji> <type>[(<scope>)][!]: <subject>
+
+<body — explain WHY, wrap at 72 chars/line>
+
+<footer — BREAKING CHANGE: …, Refs: #123, etc.>
+```
+
+### Type → emoji
+
+| Type       | Emoji | Meaning                                          |
+| ---------- | ----- | ------------------------------------------------ |
+| `feat`     | ✨    | New user-visible feature                         |
+| `fix`      | 🐛    | Bug fix                                          |
+| `docs`     | 📚    | Documentation only                               |
+| `style`    | 🎨    | Formatting/whitespace (no logic change)          |
+| `refactor` | ♻️    | Code change with no behavior change              |
+| `perf`     | 🚀    | Performance improvement                          |
+| `test`     | ✅    | Tests added or corrected                         |
+| `build`    | 📦    | Build system or dependency change                |
+| `ci`       | 👷    | CI configuration or scripts                      |
+| `chore`    | 🔧    | Tooling, maintenance, non-source tasks           |
+| `revert`   | ⏪    | Revert a prior commit                            |
+| breaking   | 💥    | Backward-incompatible (use `type!:` + footer)    |
+| security   | 🔒    | Security hardening (treat as `fix`)              |
+
+### Rules
+
+- One logical change per commit. Split unrelated changes.
+- **Subject**: imperative, lowercase after the colon, no trailing period, ≤ 50 chars.
+- **Scope** *(optional)*: short noun — `pi`, `omp`, `chezmoi`, `agents`, `claude`, etc.
+- **Breaking changes**: append `!` after the type/scope **and** add a `BREAKING CHANGE: <explanation>` footer.
+- **Body** *(optional)*: explain *why*, not *what*. Wrap at 72 chars/line.
+- **Footer** *(optional)*: `BREAKING CHANGE: …`, `Refs: #123`, etc.
+
+### Examples
+
+```text
+✨ feat(pi): add commit-convention lookup in commit skill
+🐛 fix(omp): handle null theme on first launch
+📚 docs(agents): document codebase-index toolchain
+♻️ refactor(opencode): rename footer file for clarity
+🚀 perf(pi): skip jq on small contracts
+✅ test(commit): cover conventional+emoji prefix parsing
+💥 feat(api)!: drop legacy v1 endpoints
+🔒 fix(pi): mask sensitive paths in error messages
+```
+
+### Why
+
+- **Conventional types** let tooling (release-please, commitlint, semantic-release)
+  derive versions and changelogs automatically from the log.
+- **Emoji prefixes** make `git log --oneline` scannable — the type cue lands
+  before your eye reaches the prose.
+- **Scope** keeps the diff domain explicit in monorepos like this one.

buildbard-1.0.0/PKG-INFO

@@ -0,0 +1,28 @@
+Metadata-Version: 2.5
+Name: buildbard
+Version: 1.0.0
+Summary: Buildbard CLI — spec-driven TDD orchestrator (deviatdd rewrite)
+Requires-Python: >=3.13
+Requires-Dist: rich>=13.0
+Requires-Dist: typer>=0.12
+Description-Content-Type: text/markdown
+
+![buildbard](buildbard.svg)
+
+# buildbard
+
+Spec-driven TDD orchestrator. Python CLI (`buildbard` / `bard`).
+
+## Setup
+
+```sh
+mise run setup
+```
+
+## Use
+
+```sh
+mise run dev          # CLI help
+mise run check        # lint + format-check
+mise run test         # unit tests
+```

buildbard-1.0.0/README.md

@@ -0,0 +1,19 @@
+![buildbard](buildbard.svg)
+
+# buildbard
+
+Spec-driven TDD orchestrator. Python CLI (`buildbard` / `bard`).
+
+## Setup
+
+```sh
+mise run setup
+```
+
+## Use
+
+```sh
+mise run dev          # CLI help
+mise run check        # lint + format-check
+mise run test         # unit tests
+```