mirror of
https://github.com/gastownhall/beads.git
synced 2026-09-14 20:17:24 +08:00
789044b83e
- beads-release formula: drop the snapshot-docs step (ran the deleted scripts/snapshot-release-docs.sh on the critical needs-chain); stamp- changelog now needs update-vendorhash - update-versions.sh: remove the mangled --skip-docs/docs-snapshot logic and garbled usage text left by mid-line deletions - pre-push hook: drop the snapshot-script remediation hint - release.yml: collapse the prerelease branch; BEADS_REQUIRE_RELEASE_DOCS has no consumer since check-docs-version.sh was deleted - RELEASING.md / scripts/docs.md: describe the current pipeline (no --versioned, no website/ outputs, no check-docs-version.sh) - docs-mintlify.yml: paths filter now includes engdocs/** and the curated root markdown files the docsync guard validates - docs-render-check.sh: pin mint@4.2.687, fail closed when mint dies without producing a broken-links report, parse report lines only, drop dead extract_page_links(), fix the stale jq requirement; mint.sh pins the same version - nightly.yml: remove the deleted website measurement suite option - CODEOWNERS: init-safety ADR gate follows the file to engdocs/adr/ - beads-docs skill: align with settled decision 6 — no pointer stubs, moved pages get docs.json redirects; bd's printed paths are fixed at the source - CHANGELOG (edited line), FEDERATION-SETUP, README, examples, oracle-a, .buildflags, gh-issue-to-pr formula: retarget moved-file references; anchor the build/ gitignore pattern
1.3 KiB
1.3 KiB
Starter Formulas
Example .formula.toml files you can use as starting points.
Usage
Copy formulas to your project or user-level directory:
# Project-level (available in this project only)
cp *.formula.toml /path/to/project/.beads/formulas/
# User-level (available in all projects)
cp *.formula.toml ~/.beads/formulas/
Then list and use them:
bd formula list # See available formulas
bd mol pour release --var version=1.2.0 # Pour into a molecule
For advanced GitHub workflows like gh-issue-to-pr and gh-pr-review,
customize repo variables (repo, remotes, base branch) and quality-gate
commands to match your project before first use.
Included Formulas
| Formula | Description | Use as |
|---|---|---|
feature-workflow |
Design, implement, review, merge | Molecule (persistent) |
gh-issue-to-pr |
Triage a GitHub issue through implementation and PR creation | Wisp (ephemeral) |
gh-pr-review |
Triage and review a GitHub PR using maintainer guidelines | Wisp (ephemeral) |
release |
Bump version, test, tag, publish | Molecule (persistent) |
quick-check |
Lint, test, build sanity check | Wisp (ephemeral) |
Creating Your Own
See the Formulas documentation for the full reference.