pointbreak 0.6.0

Durable terminal code review for changes humans and coding agents collaborate on together
Documentation 
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96
97
98
99
100
101
102
103
104
105
106
107
108
109
110
111
112
113
114
115
116
117
118
119
120
121
122
123
124
125
126

from_latest_tag = true
ignore_merge_commits = true
ignore_fixup_commits = true
disable_changelog = false
disable_bump_commit = false
generate_mono_repository_global_tag = false
generate_mono_repository_package_tags = false
branch_whitelist = []
skip_ci = "[skip ci]"
skip_untracked = false
tag_prefix = "v"

# Scopes are intentionally not enforced yet. Add scopes once the crate has
# stable module/package boundaries that should be reflected in commit headers.
scopes = []

pre_bump_hooks = [
    "just lint",
    "just test",
    "cargo set-version {{version}}",
]
post_bump_hooks = []

# CI profile: skip local lint/test and leave publishing orchestration to CI.
# Usage: cog bump --auto --hook-profile ci
[bump_profiles.ci]
pre_bump_hooks = [
    "cargo set-version {{version}}",
]
post_bump_hooks = [
    "git commit --amend -m 'chore: v{{version}}'",
    "git tag -f -m 'v{{version}}' v{{version}}",
    "git push origin HEAD:main",
    "git push origin refs/tags/v{{version}}",
    "gh workflow run release.yml -f tag=v{{version}}",
]

[git_hooks.commit-msg]
script = '''#!/bin/sh
set -e
cog verify --file $1

# Enforce header max 100 characters.
header=$(head -1 "$1")
if [ ${#header} -gt 100 ]; then
    echo "error: commit header exceeds 100 characters (${#header})"
    exit 1
fi

# Enforce lowercase first letter in subject (strip type and optional scope).
subject=$(echo "$header" | sed 's/^[a-z]*([^)]*): //' | sed 's/^[a-z]*: //')
first_char=$(printf '%.1s' "$subject")
if echo "$first_char" | grep -q '^[A-Z]'; then
    echo "error: commit subject must start with a lowercase letter"
    exit 1
fi

# Enforce no trailing period in subject.
if echo "$header" | grep -q '\.$'; then
    echo "error: commit subject must not end with a period"
    exit 1
fi

# Workaround for cocogitto/cocogitto#516: `cog verify` does not validate
# scope against the configured `scopes` list. Fixed upstream in v7.0.0 via
# cocogitto/cocogitto#541. Remove this block once shore is on cog >= 7.
# Single-line `scopes = [...]` assumed; multi-line arrays would need a real
# TOML parser. With an empty scopes list, any scoped commit is rejected.
scope=$(echo "$header" | sed -nE 's/^[a-z]+\(([^)]+)\)!?:.*/\1/p')
if [ -n "$scope" ]; then
    allowed=$(awk -F'=' '/^scopes[[:space:]]*=/ {
        sub(/^.*=[[:space:]]*\[/, "")
        sub(/\].*$/, "")
        gsub(/[" ]/, "")
        print
    }' cog.toml)
    if ! echo "$allowed" | tr ',' '\n' | grep -qx "$scope"; then
        echo "error: scope '$scope' is not in cog.toml scopes list"
        echo "  allowed: ${allowed:-<empty>}"
        exit 1
    fi
fi
'''

[git_hooks.pre-push]
script = '''#!/bin/sh
branch=$(git rev-parse --abbrev-ref HEAD)

# Allow main and detached HEAD.
case "$branch" in
    main|HEAD) exit 0 ;;
esac

# Enforce conventional branch format: type/description.
if ! echo "$branch" | grep -qE '^(feat|fix|hotfix|release|chore)/[a-z0-9][a-z0-9.-]*[a-z0-9]$'; then
    echo "error: branch name '$branch' does not follow Conventional Branch format"
    echo "  expected: <type>/<description>"
    echo "  types: feat, fix, hotfix, release, chore"
    echo "  description: lowercase letters, numbers, and hyphens only"
    exit 1
fi
'''

[commit_types]
feat = { changelog_title = "Features", bump_minor = true, order = 1 }
fix = { changelog_title = "Bug Fixes", bump_patch = true, order = 2 }
perf = { changelog_title = "Performance Improvements", order = 3 }
revert = { changelog_title = "Revert", order = 4 }
docs = { changelog_title = "Documentation", order = 5 }
test = { changelog_title = "Tests", omit_from_changelog = true, order = 6 }
build = { changelog_title = "Build system", omit_from_changelog = true, order = 7 }
ci = { changelog_title = "Continuous Integration", omit_from_changelog = true, order = 8 }
refactor = { changelog_title = "Refactoring", order = 9 }
chore = { changelog_title = "Miscellaneous Chores", omit_from_changelog = true, order = 10 }
style = { changelog_title = "Style", omit_from_changelog = true, order = 11 }

[changelog]
path = "CHANGELOG.md"
template = "remote"
remote = "github.com"
repository = "pointbreak"
owner = "kevinswiber"

[[changelog.authors]]
signature = "Kevin Swiber"
username = "kevinswiber"