Documentation
¶
Overview ¶
Package kirocli is the pinstall profile for the kiro-cli release.
It states once, for every consumer installing kiro-cli, the release host and archive shape, the architecture tokens, where the archive holds its binaries, the probe argv, the licence notice and the assertion the integrity check depends on. A profile copied into each consumer would drift silently between the copies.
The pin itself is not here. The version and the per-architecture digests belong to the deployment and to whatever bumps them, so a consumer passes them in pinstall.Config:
mgr, err := pinstall.New(&pinstall.Config{
Release: kirocli.Release(),
Version: version,
Digests: map[string]string{"amd64": amd64SHA256, "arm64": arm64SHA256},
Root: toolsDir,
LinkDir: "bin",
Assert: []pinstall.Assertion{kirocli.Setting("telemetry.enabled", false)},
})
Index ¶
Constants ¶
const Name = "kiro-cli"
Name is the package identity and the name of its primary artifact.
Variables ¶
This section is empty.
Functions ¶
func Release ¶
Release returns the kiro-cli profile. Each call returns a fresh value, so a consumer can adjust it without affecting any other consumer in the process.
The required set is deliberately left to the caller beyond the main dispatcher: which sidecars a deployment cannot run without is a property of what that deployment does with kiro-cli, not of the release.
func Setting ¶
func Setting(key SettingKey, value bool) pinstall.Assertion
Setting returns the assertion that sets a boolean kiro-cli setting.
The `settings <key> <value>` grammar is package knowledge, which is why it lives here rather than as a hook in pinstall: the library takes a full argv and needs to know nothing about how kiro-cli is configured.
func SettingRaw ¶
func SettingRaw(key SettingKey, value string) pinstall.Assertion
SettingRaw returns the assertion that sets a kiro-cli setting to a verbatim string value, for the settings whose value is not a boolean.
func ShellEraDispatchers ¶
func ShellEraDispatchers() []string
ShellEraDispatchers returns the dispatcher names a shell-era kiro-cli installer promoted into a shared bin directory, for pinstall.Purge's Names. It is a function rather than a variable so a caller cannot mutate the list another caller is about to sweep with.
The set is fixed on purpose. Sweeping by a `kiro-cli*` prefix instead would delete every matching entry in a directory this package does not own — including another installer's live symlink of the same name.
Types ¶
type SettingKey ¶
type SettingKey string
SettingKey names a kiro-cli setting (the dotted form: "app.disableAutoupdates", "chat.notificationMethod"). It is a distinct type so the key and a string VALUE cannot be transposed in a SettingRaw call — a swapped call wrote the wrong setting under the wrong key, silently, since both sides are strings on the wire. An untyped string constant still converts implicitly at a call site; the type guards every site that passes variables.