Repository navigation
StarCLI v0.1.4 brings the released StarWorks foundation and domain fixes into the CLI and reusable Go kit, with six native installation packages.
The v0.1.3 source tag remains available, but its release job stopped before building archives. v0.1.4 preserves annotated tag metadata and verifies the event commit during release checkouts, providing the packaged delivery of these changes.
Changes since v0.1.2
- Add the reusable
kitAPI and embedded hello/QR examples for Go applications that run Starlark scripts. - Confine local imports to explicitly granted include roots in restrictive capability tiers. Arbitrary commands, Gum subprocesses and runtime environment mutation require an explicit execution grant (
--allow-cmdor--dangerously-allow-all); SQLite custom functions require--dangerously-allow-all. - Require both network and filesystem capabilities for
emailattachments andllmimage files. Migration: callers using--caps networkmust explicitly add--allow-fsto load either module. The same rule covers preloaded globals;-Ionly grants a script import directory. Defaultopenandfullusers retain the existing calls. - Preserve buffered stdin and final input without a newline. Preserve session recordings across execution paths and report recording write failures.
- Bound web request processing and support graceful shutdown. Verify non-root container behavior and identify snapshot builds with their actual snapshot version.
- Adopt the validated parser/security dependency baseline. Source builds require Go 1.26.0; production packages are built with Go 1.27.4.
- Verify all six archive layouts and checksums, scan source and the exact packaged binaries with pinned govulncheck v1.8.0, and test native installation, upgrade from v0.1.2, CLI behavior and binary rollback before publication. Published archives receive GitHub artifact attestations.
- Align CLI help, security guidance and the kit default print-handler documentation with current behavior.
Included StarWorks module versions
| Module | Version |
|---|---|
github.com/1set/starbox |
v0.2.1 |
github.com/1set/starlet |
v0.2.5 |
github.com/1set/starlight |
v0.2.3 |
github.com/starpkg/base |
v0.1.4 |
github.com/starpkg/cache |
v0.1.1 |
github.com/starpkg/cmd |
v0.1.2 |
github.com/starpkg/email |
v0.1.1 |
github.com/starpkg/emoji |
v0.1.1 |
github.com/starpkg/gum |
v0.2.1 |
github.com/starpkg/liquid |
v0.1.1 |
github.com/starpkg/llm |
v0.1.1 |
github.com/starpkg/markdown |
v0.1.1 |
github.com/starpkg/qrcode |
v0.1.1 |
github.com/starpkg/sqlite |
v0.2.2 |
github.com/starpkg/toml |
v0.1.1 |
github.com/starpkg/totp |
v0.1.1 |
github.com/starpkg/web |
v0.1.1 |
github.com/starpkg/yaml |
v0.1.1 |
The interpreter remains pinned to go.starlark.net v0.0.0-20260324133313-ffb3f39dd27a. The module adoption does not change unrelated selected dependency versions. Its reviewed safety costs remain; this release does not claim zero overhead or process isolation for in-process Starlark execution.
Installation
Download the matching Linux/macOS/Windows archive for amd64 or arm64 and verify it against checksums.txt. Each archive includes the binary, README, license and security policy. For source installation, use go install github.com/1set/starcli@v0.1.4 with Go 1.26.0 or newer.
Keep script-owned files and databases backed up separately: the tested rollback procedure replaces the executable, rather than reversing application data changes.