Skip to content

docs: mention helpers4-common's automatic git-config self-heal across all dependent features - #77

Merged
baxyz merged 32 commits into
mainfrom
docs/self-heal-mentions-1.2.0
Sep 7, 2026
Merged

docs: mention helpers4-common's automatic git-config self-heal across all dependent features#77
baxyz merged 32 commits into
mainfrom
docs/self-heal-mentions-1.2.0

Conversation

@baxyz

@baxyz baxyz commented Sep 6, 2026

Copy link
Copy Markdown
Contributor

Summary

Pure documentation release — no functional change to any feature's install.sh or runtime behavior. Every feature that dependsOn: helpers4-common gets the automatic git-config self-heal (from #75) transitively, but that was previously only documented on helpers4-common's own README — undiscoverable for anyone using, say, claude-dev without also knowing to go read helpers4-common's docs.

Scope

All 15 features with a direct dependsOn: "ghcr.io/helpers4/devcontainer/helpers4-common:1" (verified exhaustively: jq -e '.dependsOn["ghcr.io/helpers4/devcontainer/helpers4-common:1"]' across every src/*/devcontainer-feature.json):

angular-dev, auto-header, bitwarden-secrets-manager, claude-dev, dotfiles-sync, essential-dev, git-absorb, mistral-dev, nub, package-auto-install, peon-ping, playwright-dev, pnpm-store, shell-history-per-project, vite-plus.

For each:

  • Description (devcontainer-feature.json): appended "Also includes helpers4's automatic git-config self-heal." — identical short phrasing everywhere, deliberately, since it's the exact same underlying mechanism.
  • README: a consistent callout — "Also included automatically: helpers4-common's git-config self-heal — fixes a stale credential.helper or a missing SSH commit-signing key in ~/.gitconfig on every container attach, no setup required. You never add helpers4-common yourself; every helpers4 feature pulls it in." — placed right after each feature's intro paragraph. (dotfiles-sync already had a more detailed, feature-specific note covering the same ground from its own refactor(dotfiles-sync): make SSH key file sync opt-in, drop redundant path-fixing #76 work — only its description got the short addition, to avoid a redundant second callout.)
  • Version History: a new entry marking this as documentation-only, no functional change.
  • 12 of the 15 go 1.1.0 → 1.2.0 (they were already bumped once for the dependsOn migration itself, in refactor: migrate all features off inline helpers4-common bootstrap to dependsOn #72). essential-dev and bitwarden-secrets-manager go to 1.1.0 — they already depended on helpers4-common from their own first release, so this is their first bump for this specific reason. dotfiles-sync goes to 1.2.0 (its own 1.1.0 already covered the functional side in refactor(dotfiles-sync): make SSH key file sync opt-in, drop redundant path-fixing #76).

AGENTS.md's feature table updated to match.

Everything else (descriptions read naturally, no historical/implementation references leaking into the main body — that's what Version History is for) was reviewed while touching each file; none needed further changes beyond the addition itself.

Test plan

🤖 Generated with Claude Code

baxyz and others added 16 commits September 6, 2026 22:17
…lf-heal

Documentation only, no functional change — every helpers4 feature
depends on helpers4-common, which repairs a stale credential.helper
or a missing SSH commit-signing key in ~/.gitconfig on every attach.
This was previously only documented on helpers4-common's own README,
undiscoverable for anyone using this feature without also knowing to
look there.

Version bumped to 1.2.0 to mark that this feature's users now know
about a capability that was already silently included.

Co-Authored-By: Claude Sonnet 5 <noreply@anthropic.com>
…elf-heal

Documentation only, no functional change — every helpers4 feature
depends on helpers4-common, which repairs a stale credential.helper
or a missing SSH commit-signing key in ~/.gitconfig on every attach.
This was previously only documented on helpers4-common's own README,
undiscoverable for anyone using this feature without also knowing to
look there.

Version bumped to 1.2.0 to mark that this feature's users now know
about a capability that was already silently included.

Co-Authored-By: Claude Sonnet 5 <noreply@anthropic.com>
…lf-heal

Documentation only, no functional change — every helpers4 feature
depends on helpers4-common, which repairs a stale credential.helper
or a missing SSH commit-signing key in ~/.gitconfig on every attach.
This was previously only documented on helpers4-common's own README,
undiscoverable for anyone using this feature without also knowing to
look there.

Version bumped to 1.2.0 to mark that this feature's users now know
about a capability that was already silently included.

Co-Authored-By: Claude Sonnet 5 <noreply@anthropic.com>
…elf-heal

Documentation only, no functional change — every helpers4 feature
depends on helpers4-common, which repairs a stale credential.helper
or a missing SSH commit-signing key in ~/.gitconfig on every attach.
This was previously only documented on helpers4-common's own README,
undiscoverable for anyone using this feature without also knowing to
look there.

Version bumped to 1.2.0 to mark that this feature's users now know
about a capability that was already silently included.

Co-Authored-By: Claude Sonnet 5 <noreply@anthropic.com>
…f-heal

Documentation only, no functional change — every helpers4 feature
depends on helpers4-common, which repairs a stale credential.helper
or a missing SSH commit-signing key in ~/.gitconfig on every attach.
This was previously only documented on helpers4-common's own README,
undiscoverable for anyone using this feature without also knowing to
look there.

Version bumped to 1.2.0 to mark that this feature's users now know
about a capability that was already silently included.

Co-Authored-By: Claude Sonnet 5 <noreply@anthropic.com>
…f-heal

Documentation only, no functional change — every helpers4 feature
depends on helpers4-common, which repairs a stale credential.helper
or a missing SSH commit-signing key in ~/.gitconfig on every attach.
This was previously only documented on helpers4-common's own README,
undiscoverable for anyone using this feature without also knowing to
look there.

Version bumped to 1.2.0 to mark that this feature's users now know
about a capability that was already silently included.

Co-Authored-By: Claude Sonnet 5 <noreply@anthropic.com>
…elf-heal

Documentation only, no functional change — every helpers4 feature
depends on helpers4-common, which repairs a stale credential.helper
or a missing SSH commit-signing key in ~/.gitconfig on every attach.
This was previously only documented on helpers4-common's own README,
undiscoverable for anyone using this feature without also knowing to
look there.

Version bumped to 1.2.0 to mark that this feature's users now know
about a capability that was already silently included.

Co-Authored-By: Claude Sonnet 5 <noreply@anthropic.com>
…lf-heal

Documentation only, no functional change — every helpers4 feature
depends on helpers4-common, which repairs a stale credential.helper
or a missing SSH commit-signing key in ~/.gitconfig on every attach.
This was previously only documented on helpers4-common's own README,
undiscoverable for anyone using this feature without also knowing to
look there.

Version bumped to 1.2.0 to mark that this feature's users now know
about a capability that was already silently included.

Co-Authored-By: Claude Sonnet 5 <noreply@anthropic.com>
…g self-heal

Documentation only, no functional change — every helpers4 feature
depends on helpers4-common, which repairs a stale credential.helper
or a missing SSH commit-signing key in ~/.gitconfig on every attach.
This was previously only documented on helpers4-common's own README,
undiscoverable for anyone using this feature without also knowing to
look there.

Version bumped to 1.2.0 to mark that this feature's users now know
about a capability that was already silently included.

Co-Authored-By: Claude Sonnet 5 <noreply@anthropic.com>
…-config self-heal

Documentation only, no functional change — every helpers4 feature
depends on helpers4-common, which repairs a stale credential.helper
or a missing SSH commit-signing key in ~/.gitconfig on every attach.
This was previously only documented on helpers4-common's own README,
undiscoverable for anyone using this feature without also knowing to
look there.

Version bumped to 1.2.0 to mark that this feature's users now know
about a capability that was already silently included.

Co-Authored-By: Claude Sonnet 5 <noreply@anthropic.com>
…c git-config self-heal

Documentation only, no functional change — every helpers4 feature
depends on helpers4-common, which repairs a stale credential.helper
or a missing SSH commit-signing key in ~/.gitconfig on every attach.
This was previously only documented on helpers4-common's own README,
undiscoverable for anyone using this feature without also knowing to
look there.

Version bumped to 1.2.0 to mark that this feature's users now know
about a capability that was already silently included.

Co-Authored-By: Claude Sonnet 5 <noreply@anthropic.com>
Documentation only, no functional change — every helpers4 feature
depends on helpers4-common, which repairs a stale credential.helper
or a missing SSH commit-signing key in ~/.gitconfig on every attach.
This was previously only documented on helpers4-common's own README,
undiscoverable for anyone using this feature without also knowing to
look there.

Version bumped to 1.2.0 to mark that this feature's users now know
about a capability that was already silently included.

Co-Authored-By: Claude Sonnet 5 <noreply@anthropic.com>
… self-heal

Documentation only, no functional change — every helpers4 feature
depends on helpers4-common, which repairs a stale credential.helper
or a missing SSH commit-signing key in ~/.gitconfig on every attach.
essential-dev already depended on helpers4-common directly (it
predates the repo-wide dependsOn migration, so it never got a bump
for that), but never mentioned this capability in its own README.

Also adds a Version History section — this feature never had one.

Co-Authored-By: Claude Sonnet 5 <noreply@anthropic.com>
…c git-config self-heal

Documentation only, no functional change — every helpers4 feature
depends on helpers4-common, which repairs a stale credential.helper
or a missing SSH commit-signing key in ~/.gitconfig on every attach.
This feature already depended on helpers4-common from its own first
release, but never mentioned this capability in its own README.

Also adds this feature's first Version History entry.

Co-Authored-By: Claude Sonnet 5 <noreply@anthropic.com>
… self-heal in the description

Documentation only, no functional change. This feature's README
already documented the self-heal relationship in detail (the
"Recommended" note on copyGitConfig, added alongside the v1.1.0
functional change) — this just adds the same short mention to the
compact JSON description, for consistency with every other
helpers4-common consumer's description.

Co-Authored-By: Claude Sonnet 5 <noreply@anthropic.com>
…n release

15 features that dependsOn helpers4-common bumped and documented in
the same pass — see each feature's own commit for its specific
version bump.

Co-Authored-By: Claude Sonnet 5 <noreply@anthropic.com>
@github-actions

github-actions Bot commented Sep 6, 2026

Copy link
Copy Markdown

✅ PR Validation Passed

All checks passed!


📋 Pipeline Status

Job Status
🧾 Conventional Commits passing
🔖 Version Bump passing
🧪 Feature Tests passing
🐚 ShellCheck passing

🤖 Generated by @helpers4 CI • 2026-09-07

baxyz and others added 12 commits September 7, 2026 13:55
…more naturally

The JSON description and README callout both used to spell out
"git-config self-heal", which locks the wording to today's implementation
and reads like a changelog entry. Reworded to a vague, user-focused
"self-heal mechanism" so future auto-heal improvements don't need another
wording pass, and rewrote the callout for more natural English.

Co-Authored-By: Claude Sonnet 5 <noreply@anthropic.com>
…ore naturally

The JSON description and README callout both used to spell out
"git-config self-heal", which locks the wording to today's implementation
and reads like a changelog entry. Reworded to a vague, user-focused
"self-heal mechanism" so future auto-heal improvements don't need another
wording pass, and rewrote the callout for more natural English.

Co-Authored-By: Claude Sonnet 5 <noreply@anthropic.com>
…d more naturally

The JSON description and README callout both used to spell out
"git-config self-heal", which locks the wording to today's implementation
and reads like a changelog entry. Reworded to a vague, user-focused
"self-heal mechanism" so future auto-heal improvements don't need another
wording pass, and rewrote the callout for more natural English.

Co-Authored-By: Claude Sonnet 5 <noreply@anthropic.com>
…ore naturally

The JSON description and README callout both used to spell out
"git-config self-heal", which locks the wording to today's implementation
and reads like a changelog entry. Reworded to a vague, user-focused
"self-heal mechanism" so future auto-heal improvements don't need another
wording pass, and rewrote the callout for more natural English.

Co-Authored-By: Claude Sonnet 5 <noreply@anthropic.com>
…more naturally

The JSON description and README callout both used to spell out
"git-config self-heal", which locks the wording to today's implementation
and reads like a changelog entry. Reworded to a vague, user-focused
"self-heal mechanism" so future auto-heal improvements don't need another
wording pass, and rewrote the callout for more natural English.

Co-Authored-By: Claude Sonnet 5 <noreply@anthropic.com>
…urally

The JSON description and README callout both used to spell out
"git-config self-heal", which locks the wording to today's implementation
and reads like a changelog entry. Reworded to a vague, user-focused
"self-heal mechanism" so future auto-heal improvements don't need another
wording pass, and rewrote the callout for more natural English.

Co-Authored-By: Claude Sonnet 5 <noreply@anthropic.com>
…re naturally

The JSON description and README callout both used to spell out
"git-config self-heal", which locks the wording to today's implementation
and reads like a changelog entry. Reworded to a vague, user-focused
"self-heal mechanism" so future auto-heal improvements don't need another
wording pass, and rewrote the callout for more natural English.

Co-Authored-By: Claude Sonnet 5 <noreply@anthropic.com>
…ad more naturally

The JSON description and README callout both used to spell out
"git-config self-heal", which locks the wording to today's implementation
and reads like a changelog entry. Reworded to a vague, user-focused
"self-heal mechanism" so future auto-heal improvements don't need another
wording pass, and rewrote the callout for more natural English.

Co-Authored-By: Claude Sonnet 5 <noreply@anthropic.com>
…ore naturally

The JSON description and README callout both used to spell out
"git-config self-heal", which locks the wording to today's implementation
and reads like a changelog entry. Reworded to a vague, user-focused
"self-heal mechanism" so future auto-heal improvements don't need another
wording pass, and rewrote the callout for more natural English.

Co-Authored-By: Claude Sonnet 5 <noreply@anthropic.com>
…onsistency

Reworded the JSON description and README callout the same way as the other
helpers4-common dependents: vaguer, more natural phrasing instead of
spelling out "git-config self-heal".

Also fixed all 7 usage examples, which referenced
ghcr.io/helpers4/devcontainer/auto-header:latest — every other example in
this feature (and every other feature in the catalog) pins the major
version tag (:1), not :latest.

Co-Authored-By: Claude Sonnet 5 <noreply@anthropic.com>
…en heading

Reworded the JSON description and README callout the same way as the other
helpers4-common dependents: vaguer, more natural phrasing instead of
spelling out "git-config self-heal".

Also fixed the "How It Works" section: "Corepack Support (Node 24+)" was
plain text with no heading prefix, and was preceded by an empty "### "
line. Both are now proper "###" subheadings under "## How It Works".

Co-Authored-By: Claude Sonnet 5 <noreply@anthropic.com>
…a redundant section

Reworded the JSON description and README callout the same way as the other
helpers4-common dependents: vaguer, more natural phrasing instead of
spelling out "git-config self-heal".

Also removed the "Installation and Development" section, which duplicated
"How it works"'s 4 steps almost verbatim — the latter is better formatted
(bold labels) and is the section readers land on first.

Co-Authored-By: Claude Sonnet 5 <noreply@anthropic.com>
baxyz and others added 4 commits September 7, 2026 13:55
…ference

Reworded the JSON description and README callout the same way as the other
helpers4-common dependents: vaguer, more natural phrasing instead of
spelling out "git-config self-heal".

Also fixed the "Works Great With" example, which referenced
ghcr.io/helpers4/devcontainer/local-mounts:1 — that feature was replaced by
dotfiles-sync and no longer exists in this catalog.

Co-Authored-By: Claude Sonnet 5 <noreply@anthropic.com>
…eferences

This feature was bumped to 1.1.0 for the self-heal mention, while every
other helpers4-common dependent in this release lands on 1.2.0. Aligned it
to 1.2.0 so the whole "pure documentation" release ships under one version
number, and reworded the JSON description and README callout the same way
as the others: vaguer, more natural phrasing instead of spelling out
"git-config self-heal".

Also fixed two stale references found during review: two examples still
pointed at ghcr.io/helpers4/devcontainer/local-mounts:1, a feature that no
longer exists (superseded by dotfiles-sync), and "Not Included (By Design)"
claimed a dedicated Biome feature is available, which doesn't exist in this
catalog.

Co-Authored-By: Claude Sonnet 5 <noreply@anthropic.com>
… wording

This feature was bumped to 1.1.0 for the self-heal mention, while every
other helpers4-common dependent in this release lands on 1.2.0. Aligned it
to 1.2.0 so the whole "pure documentation" release ships under one version
number, and reworded the JSON description and README callout the same way
as the others: vaguer, more natural phrasing instead of spelling out
"git-config self-heal".

Co-Authored-By: Claude Sonnet 5 <noreply@anthropic.com>
…rden-secrets-manager

Both were bumped to 1.2.0 to align with the rest of the self-heal-mention
release, but the feature table still listed them at 1.1.0.

Co-Authored-By: Claude Sonnet 5 <noreply@anthropic.com>
@baxyz
baxyz merged commit 0ecb08d into main Sep 7, 2026
39 checks passed
@baxyz
baxyz deleted the docs/self-heal-mentions-1.2.0 branch September 7, 2026 14:19
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