Skip to content

0.6.0 - 2026-10-18

Latest

Choose a tag to compare

@github-actions github-actions released this 18 Oct 16:29

Release Notes

Added

  • Machine-readable exit-code reference (CLI-73): hamstik commands --exit-codes prints the stable exit-code table (0–10) with name, meaning,
    and remediation as a human table, or the versioned exitCodesVersion: 1
    document under --json/--format json — riding the shared --fields,
    --jq, and output-mode contract. The same table is embedded in the
    commands --json manifest as the additive exitCodes block, so one
    manifest fetch yields both the command surface and the failure schema.
    Every entry is generated from the same exit constants the error renderer
    maps onto, so the table cannot drift from actual behavior, and contract
    tests assert the eleven documented codes stay contiguous and named.

  • work diff <KEY> (CLI-56): review-style Work Item comparison with two
    server-authoritative modes. Default baseline mode compares against a local
    baseline recorded with work diff KEY --save-baseline — a per-user file
    under the config directory (baselines/<org>/<project>/<KEY>.json) that
    contains no credentials and is replaced only by another --save-baseline
    — and reports every changed field with before/after (title, description,
    status, priority, assignee, sprint, parent, labels, Attributes, due date,
    and more; identity, volatile, server-computed, and social fields are
    excluded and named in the output). --since <revision> reports the
    revision delta plus the field changes the server records in the item's
    activity feed with explicit coverage: partial and historySupported: false — the Public API v1 exposes no revision snapshots, and the CLI
    never fabricates a diff. Unchanged comparisons exit 0 with an explicit
    no-changes result; --fail-on-change exits with the conflict exit code
    (6) when differences exist. Human table rendering plus the versioned
    diffVersion: 1 document under --json.

  • Shared saved-query library (CLI-57): SqueakQL queries can now live in a
    version-controllable directory, so teams share queries via the repository
    instead of only per-user local saves. Resolution precedence is strict and
    documented — repository .hamstik/queries/<NAME>.squeakql (discovered by
    walking up from the working directory), then config-dir
    queries/<NAME>.squeakql, then the existing queries.toml entries
    written by squeakql save (unchanged) — and collisions are never silent:
    the first source wins while squeakql list reports every holding source
    (sources) plus the winner (source). New squeakql run <NAME> executes
    a resolved query through the same pipeline as work search --saved NAME
    (also library-aware now), and squeakql validate --saved NAME and
    squeakql show resolve through the same precedence. Files hold only
    plain query text under the saved-query size cap; files with invalid name
    stems are ignored; there is no sync/upload — committing the file is the
    sharing mechanism, so a query committed to a repository runs identically
    for anyone who checks it out.

Fixed

  • The CLI no longer crashes with a stack overflow on Windows when built in
    debug mode (the cargo build / cargo test profile). Windows defaults the
    main thread to a 1 MiB stack and some code paths — observed with large
    --file request bodies in the report/dashboard commands — exceeded it,
    aborting with STATUS_STACK_OVERFLOW before any diagnostic. hamstik now
    runs its full command dispatch on an explicitly 32 MiB thread on every
    platform, making stack depth uniform across Windows/macOS/Linux and across
    debug and release profiles. Release archives were never affected.

Internal

  • Windows CI: the external-plugin integration tests now create
    platform-appropriate plugin stubs (.cmd batch files on Windows instead
    of extensionless #!/bin/sh scripts), so the six plugin invocation tests
    run and pass on windows-latest too. Test-only change; the CLI's plugin
    discovery and invocation were already correct on every platform.

Install hamstik-cli 0.6.0

Install prebuilt binaries via shell script

curl --proto '=https' --tlsv1.2 -LsSf https://github.com/blackboardstudios/hamstik-cli/releases/download/v0.6.0/hamstik-cli-installer.sh | sh

Install prebuilt binaries via powershell script

powershell -ExecutionPolicy Bypass -c "irm https://github.com/blackboardstudios/hamstik-cli/releases/download/v0.6.0/hamstik-cli-installer.ps1 | iex"

Install prebuilt binaries via Homebrew

brew install blackboardstudios/hamstik/hamstik

Download hamstik-cli 0.6.0

File Platform Checksum
hamstik-cli-aarch64-apple-darwin.tar.gz Apple Silicon macOS checksum
hamstik-cli-x86_64-apple-darwin.tar.gz Intel macOS checksum
hamstik-cli-x86_64-pc-windows-msvc.zip x64 Windows checksum
hamstik-cli-aarch64-unknown-linux-gnu.tar.gz ARM64 Linux checksum
hamstik-cli-x86_64-unknown-linux-gnu.tar.gz x64 Linux checksum