Skip to content

chore: align develop with main — backport #86 content + version#106

Merged
constk merged 6 commits into
developfrom
chore/sync-develop-with-main
May 26, 2026
Merged

chore: align develop with main — backport #86 content + version#106
constk merged 6 commits into
developfrom
chore/sync-develop-with-main

Conversation

@constk

@constk constk commented May 25, 2026

Copy link
Copy Markdown
Owner

What & why

main is currently ahead of develop by one squash commit (eff5b1c) — PR #86 was merged directly to main on 2026-05-25 rather than via the standard develop → release flow. The resulting divergence is real and not just cosmetic:

  • Content drift. Develop is missing the Beads issue-queue docs, the new tests/test_scripts_compile.py CI-script compile gate, .gitattributes, the PR-template Beads block, .gitignore .beads/ entry, the CONTRIBUTING.md line-ending normalisation, and minor touch-ups across the .github/scripts/check_*.py files.
  • Version drift. Main is at 0.2.11; develop is at 0.2.10. Every in-flight PR against develop has been bumping 0.2.10 → 0.2.11, which all then collide with each other.
  • Reverse-direction release diff. The next release: bring main up to develop PR would otherwise show main ahead in content and develop ahead in version — confusing the audit trail at exactly the moment a release should be tidy.

This PR brings the missing commit forward via git merge --no-ff origin/main. Conflicts in pyproject.toml and uv.lock (on the version line only) resolved in favour of main's 0.2.11. No other conflicts.

Why a merge commit, not a cherry-pick

The merge preserves the audit trail (eff5b1c remains attributable to PR #86; the merge commit records when it crossed back over to develop). Cherry-picking would create a duplicate commit with no link back to #86.

Knock-on effect on in-flight PRs

After this lands, every other open release-blocker PR needs a one-line rebase to bump 0.2.11 → 0.2.12 (and sequentially onward as they merge). Affected PRs: #99, #100, #101, #103, #104, #105. I'll handle the rebases.

Test plan

  • git merge --no-ff origin/main succeeded with two expected conflicts (pyproject.toml, uv.lock); resolved in favour of 0.2.11
  • uv sync --frozen --extra dev succeeds on the merged tree
  • uv run --frozen pytest tests/ -q202 passed (the +10 vs develop's 192 are chore: add optional Beads issue queue guidance #86's tests/test_scripts_compile.py cases)
  • uv run --frozen mypy --strict src/ tests/ → clean on 41 source files
  • uv run --frozen ruff check . → All checks passed

Invariants affected

None. This PR moves develop forward; the harness rules themselves are unchanged.

New deps / actions / external surface

None new beyond what #86 already brought to main. No new GitHub Actions; no new external endpoints.

Linked issue

None — this is a coordination/divergence fix surfaced by the in-flight release-blockers review.

constk and others added 6 commits April 27, 2026 22:52
release: bring main up to develop (every harness ticket)
release: sync main with develop (Vite proxy fix + README screenshots)
release: bring main up to develop (Teller v1.4 → v1.10.3 backport)
release: bring main up to develop (Teller v1.12.0 backports + audit follow-up)
* chore: add optional Beads issue queue guidance

* chore: address PR-86 review feedback (BEADS doc + template + CI-script compile gate)

Applies the actionable items from the PR-86 review:

- docs/BEADS.md: lead with a one-sentence "what Beads is" + upstream link;
  state the stance explicitly (optional/additive, recommended for agent-driven
  flows, GitHub remains authoritative); add a YAML example block under
  Recommended Bead fields; replace the duplicated Closure checklist with a
  Bead-specific narrowing that cites the PR template + CONTRIBUTING; call out
  that .beads/ is wiped by git clean -fdx.
- .github/pull_request_template.md: collapse the "Local Beads" section into
  an HTML-commented opt-in block so it is invisible in the rendered preview
  until a Beads-using team uncomments it.
- CONTRIBUTING.md: document the one-shot git renormalisation step for
  Windows clones after the .gitattributes change lands.
- tests/test_scripts_compile.py: regression gate that py_compiles every
  .github/scripts/*.py. The "scripts unparseable" review finding was based on
  an older local Python — PEP 758 (3.14) makes the unparenthesised except
  clauses valid, so the scripts ARE fine on the project pin. The test
  guards against an actual syntax error landing in future.

* chore: bump version to 0.2.11

---------

Co-authored-by: const.koutsakis@aurecongroup.com <constantinos.koutsakis@gmail.com>
…sed post-#103/#104)

main moved ahead of develop on 2026-05-25 when PR #86 was merged
directly to main rather than via develop -> release flow. The
divergence is one squash commit (eff5b1c) carrying:

  - docs/BEADS.md (optional Beads issue-queue guidance)
  - .github/pull_request_template.md (Beads PR-template block)
  - .github/scripts/check_aspirational_tickets.py (PEP 758 reformat)
  - .github/scripts/check_pin_freshness.py / check_tests_present.py /
    check_version_bump.py (touch-ups)
  - .gitattributes / .gitignore (.beads/ ignore, Windows renormalise)
  - CONTRIBUTING.md (line-ending normalisation)
  - tests/test_scripts_compile.py (new CI-script compile gate)
  - docs/DEVELOPMENT.md / docs/HARNESS.md / docs/HARNESS_PRIMER.md
    cross-refs
  - pyproject.toml + uv.lock self-version 0.2.10 -> 0.2.11

This PR was rebased after #103 (CVE fix, develop -> 0.2.11) and
#104 (eval pattern examples, develop -> 0.2.12) merged. The version
on main (0.2.11) is now behind develop (0.2.12); the conflict is
resolved by bumping develop -> 0.2.13.

After this lands, develop is at 0.2.13 and contains everything main
has. Remaining in-flight PRs (#99, #100, #101, #105) need to rebase
to bump 0.2.13 -> 0.2.14 (and onward sequentially as they merge).

No behaviour change beyond what #86 already added to main.

# Conflicts:
#	pyproject.toml
#	uv.lock
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

2 participants