Skip to content

docs: document onPost binary hooks#155

Merged
fentas merged 3 commits into
mainfrom
docs-onpost-hook
May 8, 2026
Merged

docs: document onPost binary hooks#155
fentas merged 3 commits into
mainfrom
docs-onpost-hook

Conversation

@fentas

@fentas fentas commented May 8, 2026

Copy link
Copy Markdown
Owner

Summary

Documentation for the onPost per-binary hook feature (PR #153).

Changes

  • docs/b/subcommands/install.mdx — new "Post-install hooks" section: --on-post flag, env vars table (B_EVENT, B_NAME, B_VERSION, B_FILE), b.yaml examples, and behaviour notes (POSIX-only, non-fatal, stderr output). Added --on-post to the flags table.
  • docs/b/subcommands/update.mdx — "Post-update hooks" section explaining that onPost also fires on update, with a cross-reference to the install docs.
  • docs/getting-started.mdxonPost example in the config walkthrough.
  • docs/glossary.mdxonPost term definition.
  • README.md--on-post CLI example in the quick-use block + onPost in the config example section.

🤖 Generated with Claude Code

- docs/b/subcommands/install.mdx — new "Post-install hooks" section
  with --on-post flag, env vars table, b.yaml examples, and behaviour
  notes. Added --on-post to the flags table.
- docs/b/subcommands/update.mdx — "Post-update hooks" section
  referencing install docs.
- docs/getting-started.mdx — onPost example in the config walkthrough.
- docs/glossary.mdx — onPost term definition.
- README.md — --on-post CLI example + onPost in config example.

Co-Authored-By: Claude Opus 4.6 (1M context) <noreply@anthropic.com>

Copilot AI left a comment

Copy link
Copy Markdown
Contributor

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Pull request overview

Adds end-user documentation for the per-binary onPost hook feature so users can configure post-install/post-update commands via CLI (--on-post) and b.yaml.

Changes:

  • Documented onPost hooks in b install docs, including env vars, examples, and the --on-post flag.
  • Documented that onPost also runs during b update, with a cross-reference back to install docs.
  • Added onPost references/examples across getting started, glossary, and README.

Reviewed changes

Copilot reviewed 5 out of 5 changed files in this pull request and generated 3 comments.

Show a summary per file
File Description
README.md Adds a quick-use CLI example and config snippet showing onPost.
docs/glossary.mdx Adds a glossary definition for onPost.
docs/getting-started.mdx Adds an onPost example to the config walkthrough.
docs/b/subcommands/update.mdx Adds a “Post-update hooks” section and cross-link to install docs.
docs/b/subcommands/install.mdx Adds a “Post-install hooks” section, env var table, examples, and documents --on-post.

Comment thread docs/b/subcommands/install.mdx
Comment thread docs/b/subcommands/install.mdx
Comment thread docs/glossary.mdx
fentas and others added 2 commits May 8, 2026 10:55
Co-authored-by: Copilot Autofix powered by AI <175728472+Copilot@users.noreply.github.com>
Copilot review on #155:

1. Clarify hooks run in the project root directory so relative paths
   in examples (e.g. .completions/) make sense.
2. Remove implication that 'b install --dry-run' exists; clarify the
   skip applies to 'b update --dry-run' and '--plan-json'.
3. Glossary onPost entry now bold-links to onPreSync/onPostSync
   entries defined immediately below.

Co-Authored-By: Claude Opus 4.6 (1M context) <noreply@anthropic.com>
@fentas fentas merged commit 21dab7e into main May 8, 2026
2 checks passed
@fentas fentas deleted the docs-onpost-hook branch May 8, 2026 09:07
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.

2 participants