feat(init): 👻 bootstrap Git Intent with fix-author - #2
Merged
Conversation
31 tasks
uklok-agent
approved these changes
Sep 1, 2026
This file contains hidden or bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
Sign up for free
to join this conversation on GitHub.
Already have an account?
Sign in to comment
Add this suggestion to a batch that can be applied as a single commit.This suggestion is invalid because no changes were made to the code.Suggestions cannot be applied while the pull request is closed.Suggestions cannot be applied while viewing a subset of changes.Only one suggestion per line can be applied in a batch.Add this suggestion to a batch that can be applied as a single commit.Applying suggestions on deleted lines is not supported.You must change the existing code in this line in order to create a valid suggestion.Outdated suggestions cannot be applied.This suggestion has been applied or marked resolved.Suggestions cannot be applied from pending reviews.Suggestions cannot be applied on multi-line comments.Suggestions cannot be applied while the pull request is queued to merge.Suggestion cannot be applied right now. Please check back later.
Summary
Bootstraps Git Intent around its first concrete workflow.
Introduces the project contract, community contribution surface, and
git-fix-authoras the first deterministic, recovery-aware referenceoperation.
Why
Simple Git intentions frequently require fragile low-level procedures.
Git Intent moves that procedural complexity into reviewed operations that can
be invoked equally by humans and agents:
Included
git-fix-authorpackage;identities;
Lessons incorporated
The reference operation accounts for failure modes identified during both the
original exploration and this implementation:
targeted; and
Signed commits in the rewritten range necessarily lose their invalidated
signatures, and this limitation is explicit in the CLI and documentation.
Verification
The integration suite covers the public help surface, root/linear history,
empty commits, dry-run purity, explicit committers, optional checkpoints, merge
topology, related and excluded ref updates, non-current finish branches,
non-ancestor rejection, dirty-state rejection, invalid refs, and confirmation
requirements.
The repository also passes
bash -n,git diff --check, YAML parsing for itsissue forms and workflow, ShellCheck 0.11.0, and shfmt 3.14.0. CI repeats the
shell lint/format checks and runs integration tests on Linux and macOS.
Architectural intent
git-fix-authordefines a stable behavior contract, not its forever engine.Future versions may delegate suitable work to established tools when that
improves correctness or safety without weakening the interface.
Backup lifecycle management remains a focused follow-up rather than expanding
the initial rewrite path.
Closes #1