Skip to content

chore(community): community health files and manual release proposing - #45

Merged
using-system merged 7 commits into
mainfrom
chore/community-files
Aug 23, 2026
Merged

chore(community): community health files and manual release proposing#45
using-system merged 7 commits into
mainfrom
chore/community-files

Conversation

@using-system

@using-system using-system commented Aug 23, 2026

Copy link
Copy Markdown
Owner

What

Everything a first external contributor needs (community profile was at 42%), plus the release-proposing switch:

  • CONTRIBUTING.md — repo orientation (.apm/ contracts by-name, generated dirs, .odd/ memory), the CI-canonical build/test/lint commands, the two hard MCP constraints (deferring to the spec as owner), and the PR rules (squash title = release note, Conventional Commits, no breaking markers without discussion).
  • Issue forms (bug with confirmed/observed status + environment fields, feature) and config.yml (blank issues off; questions → Discussions, vulnerabilities → private reporting).
  • PR template (policy lives in CONTRIBUTING, template carries the checklist), CODE_OF_CONDUCT.md (Contributor Covenant 2.1, actionable contact), SECURITY.md, CODEOWNERS, dependabot.yml (GitHub Actions + uv weekly).
  • README: CI/PyPI/license badges and a Contributing section; Development section now defers to CONTRIBUTING.
  • release.yml: propose-release becomes a manual dispatch (Run workflow → mode: propose) — pushes to main no longer open release PRs; merging a chore(release) PR still tags/publishes automatically, and the bootstrap path survives as mode: publish-current.

Reviewed by a Fable 5 multi-angle pass: 10 findings, all addressed.

Settings applied separately via API: squash-only merges with PR-title-as-commit, delete-branch-on-merge, Discussions on, wiki off, private vulnerability reporting + Dependabot alerts on; the ruleset enforces PR-required + squash-only (required status checks were tried then removed: GITHUB_TOKEN-created release PRs never trigger workflows, so required checks made them unmergeable).

🤖 Generated with Claude Code

using-system and others added 4 commits August 23, 2026 14:07
…security policy, codeowners, dependabot

Co-Authored-By: Claude Fable 5 <noreply@anthropic.com>
Co-Authored-By: Claude Fable 5 <noreply@anthropic.com>
Co-Authored-By: Claude Fable 5 <noreply@anthropic.com>
Pushes to main no longer open/update the release PR - proposing a
release is now Run workflow -> mode: propose. The push trigger stays
for the tag-and-release chain (merge of a chore(release) PR), and the
former bootstrap path is preserved as mode: publish-current.

Co-Authored-By: Claude Fable 5 <noreply@anthropic.com>
@using-system using-system changed the title chore(community): contribution guide, issue forms, and community health files chore(community): community health files and manual release proposing Aug 23, 2026
propose, tag-and-publish, and publish-current are the three dispatch
modes; tagging is guarded against re-running on an already-tagged
version.

Co-Authored-By: Claude Fable 5 <noreply@anthropic.com>
@using-system
using-system force-pushed the chore/community-files branch from c167914 to 3eeac71 Compare August 23, 2026 12:30
using-system and others added 2 commits August 23, 2026 14:35
Exactly one open chore(release) PR is merged by publish; multiple is an
error, none is an error unless the version is already tagged (re-run).
RELEASE_TOKEN (fine-grained PAT, optional secret) is used to create and
merge the release PR so its required status checks actually run.

Co-Authored-By: Claude Fable 5 <noreply@anthropic.com>
The required-status-checks rule was removed from the main ruleset (API):
it made GITHUB_TOKEN-created release PRs unmergeable, since bot PRs
never trigger workflows. PR-required + squash-only + human merge remain
enforced; CI stays visible on every PR.

Co-Authored-By: Claude Fable 5 <noreply@anthropic.com>
@using-system
using-system merged commit 19e5a27 into main Aug 23, 2026
8 checks passed
@using-system
using-system deleted the chore/community-files branch August 23, 2026 12:39
@github-actions github-actions Bot mentioned this pull request Aug 23, 2026
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

1 participant