detached e751749

fix(cli): check the server supports branch prefixes before creating a token

With --branch-prefix, token create reads the server features first and refuses
when token.branch_prefixes is missing or unreadable, so a server that ignores
the field never creates an unlimited token. The post-check stays as a backstop.
commit
e75174962d080218d03dd8e978c23910b70f61f5
author
brice · · 2026-10-12 15:17 UTC
parent
908d505
signature
GPG VerifiedCD88F9E564E0102646FB6077A1A07C7C7C3E349D · arch-gpg Verified for the committer email
2 files · +70 -6
Unified
UnifiedSplit
M internal/app/cli_token.go +21 -1
@@ -125,6 +125,11 @@ func newTokenCreateCmd(env *cliEnv) *cobra.Command {
125125 if err != nil {
126126 return err
127127 }
128+ if len(req.GetBranchPrefixes()) > 0 {
129+ if err := requireBranchPrefixes(env.ctx(cmd), c); err != nil {
130+ return err
131+ }
132+ }
128133 res, err := c.Tokens().CreateToken(env.ctx(cmd), connect.NewRequest(req))
129134 if err != nil {
130135 return c.Describe(err)
@@ -137,7 +142,22 @@ func newTokenCreateCmd(env *cliEnv) *cobra.Command {
137142 return cmd
138143 }
139144
140-// checkBranchPrefixes refuses to hand out a token that is less limited than
145+// requireBranchPrefixes refuses, before anything is created, to ask a server
146+// for a branch-limited token when it does not list token.branch_prefixes: such
147+// a server ignores the field. A server whose features cannot be read is refused
148+// too (fail closed).
149+func requireBranchPrefixes(ctx context.Context, c *client.Client) error {
150+ res, err := c.Server().GetVersion(ctx, connect.NewRequest(&ermite.GetVersionRequest{}))
151+ if err != nil {
152+ return c.Describe(err)
153+ }
154+ if !slices.Contains(res.Msg.GetFeatures(), client.FeatureTokenBranchPrefixes) {
155+ return fmt.Errorf("the server does not support %s, so it would ignore --branch-prefix and create an unlimited token: nothing was created (upgrade the server, see `ermite version`)", client.FeatureTokenBranchPrefixes)
156+ }
157+ return nil
158+}
159+
160+// checkBranchPrefixes is the backstop of requireBranchPrefixes: it refuses to hand out a token that is less limited than
141161 // asked for. A server that predates branch prefixes ignores the field and
142162 // creates an unlimited token: the secret is then not printed.
143163 func checkBranchPrefixes(req *ermite.CreateTokenRequest, got *ermite.Token) error {
@@ -125,6 +125,11 @@ func newTokenCreateCmd(env *cliEnv) *cobra.Command {
125 if err != nil {125 if err != nil {
126 return err126 return err
127 }127 }
128+ if len(req.GetBranchPrefixes()) > 0 {
129+ if err := requireBranchPrefixes(env.ctx(cmd), c); err != nil {
130+ return err
131+ }
132+ }
128 res, err := c.Tokens().CreateToken(env.ctx(cmd), connect.NewRequest(req))133 res, err := c.Tokens().CreateToken(env.ctx(cmd), connect.NewRequest(req))
129 if err != nil {134 if err != nil {
130 return c.Describe(err)135 return c.Describe(err)
@@ -137,7 +142,22 @@ func newTokenCreateCmd(env *cliEnv) *cobra.Command {
137 return cmd142 return cmd
138 }143 }
139 144
140-// checkBranchPrefixes refuses to hand out a token that is less limited than145+// requireBranchPrefixes refuses, before anything is created, to ask a server
146+// for a branch-limited token when it does not list token.branch_prefixes: such
147+// a server ignores the field. A server whose features cannot be read is refused
148+// too (fail closed).
149+func requireBranchPrefixes(ctx context.Context, c *client.Client) error {
150+ res, err := c.Server().GetVersion(ctx, connect.NewRequest(&ermite.GetVersionRequest{}))
151+ if err != nil {
152+ return c.Describe(err)
153+ }
154+ if !slices.Contains(res.Msg.GetFeatures(), client.FeatureTokenBranchPrefixes) {
155+ return fmt.Errorf("the server does not support %s, so it would ignore --branch-prefix and create an unlimited token: nothing was created (upgrade the server, see `ermite version`)", client.FeatureTokenBranchPrefixes)
156+ }
157+ return nil
158+}
159+
160+// checkBranchPrefixes is the backstop of requireBranchPrefixes: it refuses to hand out a token that is less limited than
141 // asked for. A server that predates branch prefixes ignores the field and161 // asked for. A server that predates branch prefixes ignores the field and
142 // creates an unlimited token: the secret is then not printed.162 // creates an unlimited token: the secret is then not printed.
143 func checkBranchPrefixes(req *ermite.CreateTokenRequest, got *ermite.Token) error {163 func checkBranchPrefixes(req *ermite.CreateTokenRequest, got *ermite.Token) error {
M internal/app/cli_token_test.go +49 -5
@@ -42,6 +42,24 @@ func TestTokenCreateMapsFlags(t *testing.T) {
4242 assert.NotContains(t, res.stderr, "SECRETVALUE")
4343 }
4444
45+// lastCreateToken returns the last CreateToken request the fake received.
46+func lastCreateToken(t *testing.T, f *fakeAPI) *ermite.CreateTokenRequest {
47+ t.Helper()
48+ calls, reqs := f.snapshot()
49+ for i := len(calls) - 1; i >= 0; i-- {
50+ if calls[i] == "CreateToken" {
51+ return reqs[i].(*ermite.CreateTokenRequest)
52+ }
53+ }
54+ t.Fatal("no CreateToken call")
55+ return nil
56+}
57+
58+// withBranchPrefixes is a GetVersion that lists token.branch_prefixes.
59+func withBranchPrefixes(*ermite.GetVersionRequest) (*ermite.GetVersionResponse, error) {
60+ return &ermite.GetVersionResponse{Version: "v0.4.0", Features: []string{"token.branch_prefixes"}}, nil
61+}
62+
4563 func TestTokenCreateBranchPrefixes(t *testing.T) {
4664 echo := func(r *ermite.CreateTokenRequest) (*ermite.CreateTokenResponse, error) {
4765 return &ermite.CreateTokenResponse{
@@ -54,11 +72,10 @@ func TestTokenCreateBranchPrefixes(t *testing.T) {
5472 }
5573
5674 t.Run("maps the repeatable flag, trims and drops duplicates", func(t *testing.T) {
57- f := &fakeAPI{createToken: echo}
75+ f := &fakeAPI{createToken: echo, getVersion: withBranchPrefixes}
5876 res := runCLI(t, envFor(f.serve(t)), "", "token", "create", "claude", "--preset", "agent", "--repo", "alpha",
5977 "--branch-prefix", "agent/claude/", "--branch-prefix", " bot/ ", "--branch-prefix", "agent/claude/").ok(t)
60- _, reqs := f.snapshot()
61- assert.Equal(t, []string{"agent/claude/", "bot/"}, reqs[0].(*ermite.CreateTokenRequest).GetBranchPrefixes())
78+ assert.Equal(t, []string{"agent/claude/", "bot/"}, lastCreateToken(t, f).GetBranchPrefixes())
6279 assert.Equal(t, "ermite_S\n", res.stdout)
6380 assert.Contains(t, res.stderr, "branches")
6481 assert.Contains(t, res.stderr, "agent/claude/, bot/")
@@ -73,18 +90,45 @@ func TestTokenCreateBranchPrefixes(t *testing.T) {
7390 })
7491
7592 t.Run("json", func(t *testing.T) {
76- f := &fakeAPI{createToken: echo}
93+ f := &fakeAPI{createToken: echo, getVersion: withBranchPrefixes}
7794 res := runCLI(t, envFor(f.serve(t)), "", "token", "create", "l", "--scope", "repo:write", "--branch-prefix", "a/", "--json").ok(t)
7895 assert.JSONEq(t, `{"id":"tok1","label":"l","scopes":["repo:write"],"repos":[],"branch_prefixes":["a/"],"expires_at":null,"created_at":"2026-10-10T12:00:00Z","last_used_at":null,"secret":"ermite_S"}`, res.stdout)
7996 })
8097
98+ t.Run("a server without the feature is asked nothing", func(t *testing.T) {
99+ for name, version := range map[string]func(*ermite.GetVersionRequest) (*ermite.GetVersionResponse, error){
100+ "feature missing": func(*ermite.GetVersionRequest) (*ermite.GetVersionResponse, error) {
101+ return &ermite.GetVersionResponse{Version: "v0.3.0", Features: []string{"repo.update", "session"}}, nil
102+ },
103+ "version unreadable": nil, // the fake answers unimplemented
104+ } {
105+ f := &fakeAPI{createToken: echo, getVersion: version}
106+ res := runCLI(t, envFor(f.serve(t)), "", "token", "create", "x", "--preset", "agent", "--branch-prefix", "agent/x/")
107+ require.Error(t, res.err, name)
108+ if name == "feature missing" {
109+ assert.Contains(t, res.err.Error(), "token.branch_prefixes", name)
110+ assert.Contains(t, res.err.Error(), "nothing was created", name)
111+ }
112+ calls, _ := f.snapshot()
113+ assert.NotContains(t, calls, "CreateToken", "%s: no token is created", name)
114+ assert.Empty(t, res.stdout, name)
115+ }
116+ })
117+
118+ t.Run("without --branch-prefix the features are not read", func(t *testing.T) {
119+ f := &fakeAPI{createToken: echo} // no getVersion: it would answer unimplemented
120+ runCLI(t, envFor(f.serve(t)), "", "token", "create", "x", "--preset", "ci").ok(t)
121+ calls, _ := f.snapshot()
122+ assert.NotContains(t, calls, "GetVersion")
123+ })
124+
81125 t.Run("a server that ignores the field does not hand out an unlimited token", func(t *testing.T) {
82126 f := &fakeAPI{createToken: func(r *ermite.CreateTokenRequest) (*ermite.CreateTokenResponse, error) {
83127 return &ermite.CreateTokenResponse{
84128 Token: &ermite.Token{Id: "tok9", Label: r.GetLabel(), Scopes: r.GetScopes(), CreatedAt: ts("2026-10-10T12:00:00Z")},
85129 Secret: "ermite_UNLIMITED",
86130 }, nil
87- }}
131+ }, getVersion: withBranchPrefixes}
88132 res := runCLI(t, envFor(f.serve(t)), "", "token", "create", "x", "--preset", "agent", "--branch-prefix", "agent/x/")
89133 require.Error(t, res.err)
90134 assert.Contains(t, res.err.Error(), "without the requested branch prefixes")
@@ -42,6 +42,24 @@ func TestTokenCreateMapsFlags(t *testing.T) {
42 assert.NotContains(t, res.stderr, "SECRETVALUE")42 assert.NotContains(t, res.stderr, "SECRETVALUE")
43 }43 }
44 44
45+// lastCreateToken returns the last CreateToken request the fake received.
46+func lastCreateToken(t *testing.T, f *fakeAPI) *ermite.CreateTokenRequest {
47+ t.Helper()
48+ calls, reqs := f.snapshot()
49+ for i := len(calls) - 1; i >= 0; i-- {
50+ if calls[i] == "CreateToken" {
51+ return reqs[i].(*ermite.CreateTokenRequest)
52+ }
53+ }
54+ t.Fatal("no CreateToken call")
55+ return nil
56+}
57+
58+// withBranchPrefixes is a GetVersion that lists token.branch_prefixes.
59+func withBranchPrefixes(*ermite.GetVersionRequest) (*ermite.GetVersionResponse, error) {
60+ return &ermite.GetVersionResponse{Version: "v0.4.0", Features: []string{"token.branch_prefixes"}}, nil
61+}
62+
45 func TestTokenCreateBranchPrefixes(t *testing.T) {63 func TestTokenCreateBranchPrefixes(t *testing.T) {
46 echo := func(r *ermite.CreateTokenRequest) (*ermite.CreateTokenResponse, error) {64 echo := func(r *ermite.CreateTokenRequest) (*ermite.CreateTokenResponse, error) {
47 return &ermite.CreateTokenResponse{65 return &ermite.CreateTokenResponse{
@@ -54,11 +72,10 @@ func TestTokenCreateBranchPrefixes(t *testing.T) {
54 }72 }
55 73
56 t.Run("maps the repeatable flag, trims and drops duplicates", func(t *testing.T) {74 t.Run("maps the repeatable flag, trims and drops duplicates", func(t *testing.T) {
57- f := &fakeAPI{createToken: echo}75+ f := &fakeAPI{createToken: echo, getVersion: withBranchPrefixes}
58 res := runCLI(t, envFor(f.serve(t)), "", "token", "create", "claude", "--preset", "agent", "--repo", "alpha",76 res := runCLI(t, envFor(f.serve(t)), "", "token", "create", "claude", "--preset", "agent", "--repo", "alpha",
59 "--branch-prefix", "agent/claude/", "--branch-prefix", " bot/ ", "--branch-prefix", "agent/claude/").ok(t)77 "--branch-prefix", "agent/claude/", "--branch-prefix", " bot/ ", "--branch-prefix", "agent/claude/").ok(t)
60- _, reqs := f.snapshot()78+ assert.Equal(t, []string{"agent/claude/", "bot/"}, lastCreateToken(t, f).GetBranchPrefixes())
61- assert.Equal(t, []string{"agent/claude/", "bot/"}, reqs[0].(*ermite.CreateTokenRequest).GetBranchPrefixes())
62 assert.Equal(t, "ermite_S\n", res.stdout)79 assert.Equal(t, "ermite_S\n", res.stdout)
63 assert.Contains(t, res.stderr, "branches")80 assert.Contains(t, res.stderr, "branches")
64 assert.Contains(t, res.stderr, "agent/claude/, bot/")81 assert.Contains(t, res.stderr, "agent/claude/, bot/")
@@ -73,18 +90,45 @@ func TestTokenCreateBranchPrefixes(t *testing.T) {
73 })90 })
74 91
75 t.Run("json", func(t *testing.T) {92 t.Run("json", func(t *testing.T) {
76- f := &fakeAPI{createToken: echo}93+ f := &fakeAPI{createToken: echo, getVersion: withBranchPrefixes}
77 res := runCLI(t, envFor(f.serve(t)), "", "token", "create", "l", "--scope", "repo:write", "--branch-prefix", "a/", "--json").ok(t)94 res := runCLI(t, envFor(f.serve(t)), "", "token", "create", "l", "--scope", "repo:write", "--branch-prefix", "a/", "--json").ok(t)
78 assert.JSONEq(t, `{"id":"tok1","label":"l","scopes":["repo:write"],"repos":[],"branch_prefixes":["a/"],"expires_at":null,"created_at":"2026-10-10T12:00:00Z","last_used_at":null,"secret":"ermite_S"}`, res.stdout)95 assert.JSONEq(t, `{"id":"tok1","label":"l","scopes":["repo:write"],"repos":[],"branch_prefixes":["a/"],"expires_at":null,"created_at":"2026-10-10T12:00:00Z","last_used_at":null,"secret":"ermite_S"}`, res.stdout)
79 })96 })
80 97
98+ t.Run("a server without the feature is asked nothing", func(t *testing.T) {
99+ for name, version := range map[string]func(*ermite.GetVersionRequest) (*ermite.GetVersionResponse, error){
100+ "feature missing": func(*ermite.GetVersionRequest) (*ermite.GetVersionResponse, error) {
101+ return &ermite.GetVersionResponse{Version: "v0.3.0", Features: []string{"repo.update", "session"}}, nil
102+ },
103+ "version unreadable": nil, // the fake answers unimplemented
104+ } {
105+ f := &fakeAPI{createToken: echo, getVersion: version}
106+ res := runCLI(t, envFor(f.serve(t)), "", "token", "create", "x", "--preset", "agent", "--branch-prefix", "agent/x/")
107+ require.Error(t, res.err, name)
108+ if name == "feature missing" {
109+ assert.Contains(t, res.err.Error(), "token.branch_prefixes", name)
110+ assert.Contains(t, res.err.Error(), "nothing was created", name)
111+ }
112+ calls, _ := f.snapshot()
113+ assert.NotContains(t, calls, "CreateToken", "%s: no token is created", name)
114+ assert.Empty(t, res.stdout, name)
115+ }
116+ })
117+
118+ t.Run("without --branch-prefix the features are not read", func(t *testing.T) {
119+ f := &fakeAPI{createToken: echo} // no getVersion: it would answer unimplemented
120+ runCLI(t, envFor(f.serve(t)), "", "token", "create", "x", "--preset", "ci").ok(t)
121+ calls, _ := f.snapshot()
122+ assert.NotContains(t, calls, "GetVersion")
123+ })
124+
81 t.Run("a server that ignores the field does not hand out an unlimited token", func(t *testing.T) {125 t.Run("a server that ignores the field does not hand out an unlimited token", func(t *testing.T) {
82 f := &fakeAPI{createToken: func(r *ermite.CreateTokenRequest) (*ermite.CreateTokenResponse, error) {126 f := &fakeAPI{createToken: func(r *ermite.CreateTokenRequest) (*ermite.CreateTokenResponse, error) {
83 return &ermite.CreateTokenResponse{127 return &ermite.CreateTokenResponse{
84 Token: &ermite.Token{Id: "tok9", Label: r.GetLabel(), Scopes: r.GetScopes(), CreatedAt: ts("2026-10-10T12:00:00Z")},128 Token: &ermite.Token{Id: "tok9", Label: r.GetLabel(), Scopes: r.GetScopes(), CreatedAt: ts("2026-10-10T12:00:00Z")},
85 Secret: "ermite_UNLIMITED",129 Secret: "ermite_UNLIMITED",
86 }, nil130 }, nil
87- }}131+ }, getVersion: withBranchPrefixes}
88 res := runCLI(t, envFor(f.serve(t)), "", "token", "create", "x", "--preset", "agent", "--branch-prefix", "agent/x/")132 res := runCLI(t, envFor(f.serve(t)), "", "token", "create", "x", "--preset", "agent", "--branch-prefix", "agent/x/")
89 require.Error(t, res.err)133 require.Error(t, res.err)
90 assert.Contains(t, res.err.Error(), "without the requested branch prefixes")134 assert.Contains(t, res.err.Error(), "without the requested branch prefixes")

Keyboard shortcuts

Single-key shortcuts are on. ctrl k and esc work whatever this says.

ctrl k :
go to a section, branch, tag, file or repository
?
this list
j k
move the row cursor down / up
enter
open the row under the cursor; on Files, a directory opens or closes in place
↑ ↓ ← → home end
in the file tree (focus on a row): previous / next row, close / open a directory or go to its parent / first entry, first / last row. They never open a file
l h
on Files: open a directory or a file / close a directory or go up to its parent, then to the parent page. Elsewhere: into the side panel (on a merge request, its files) / back to the content; there j k move between its controls
g g G
first / last row
/
filter the list; on Files, find a file anywhere in the repository (esc clears, enter opens the best match)
b
switch branch or tag
g s g f g c g b g m g i g r g a
tabs: summary, files, commits, branches & tags, merge requests, issues, releases, actions (when available)
g h
home
w
wide mode: use the whole width of the screen, or not (remembered)
y
copy a permalink pinned to the commit
d u x
diff: split / unified / collapse or expand all
e E
diff: the whole file in view / every file, with the lines the hunks hide
n
merge request: next note in the diff
esc
close a dialog, leave a field

Branches 2

Tags 45

↑↓ moveenter openesc close