v0.1.2

Kival 0.1.2

Kival 0.1.2 is a maintenance release focused on tightening documentation, build and release consistency, and the database initialization path.

What's improved

• Steda migrations now run before Kival schema setup
• build metadata consistently uses 8-character short Git SHAs
• release archive validation errors are clearer
• README resources and user documentation have been revised
• the documentation for using Kival with agents now points to the current resource
• repository organization has received a small cleanup
• the wnaf dependency has been updated to 0.14.1

Breaking changes

Database initialization order

Steda migrations now run before Kival's own schema setup.

Previously, Kival initialized its schema before handing control to Steda. Kival 0.1.2 makes Steda responsible for applying its migrations first, establishing a clearer ownership boundary between Steda's durable task infrastructure and Kival's own database schema.

This is a breaking change for integrations that call or depend directly on the previous kernel schema-setup behavior. Normal Kival installations using the standard startup and migration path should not require manual intervention.

No changes to the core knowledge model are included in this release.

Upgrade

Existing installations can update to Kival 0.1.2 with:

kivalup --update

Featured changes

Fixes

• fix(README): revise Kival resources and user sections in README by @zerosnacks in #62
• fix(build): standardize short Git SHA length to 8 characters by @zerosnacks in #65

Breaking

• refactor(kernel): run Steda migration before Kival schema setup (breaking) by @zerosnacks in #67

Chores

• chore(README): update link for 'Using Kival with agents' section by @zerosnacks in #63
• chore(release): clarify release archive validation error by @zerosnacks in #64
• chore(repo): minor code organization nits by @zerosnacks in #66

Maintenance

• chore(deps): bump wnaf to 0.14.1 by @zerosnacks in #68

Full Changelog: v0.1.1...v0.1.2

v0.1.1

Kival 0.1.1

Kival 0.1.1 is a maintenance release focused on improving the CLI, enrollment and provisioning flows, SDK ergonomics, installation, and release packaging following the initial public release.

What's improved

• CLI event pagination now matches the API and SDKs
• workspace memberships can be created by username directly from the CLI
• object versions can be addressed by version number in direct CLI lookups
• structured API error details are preserved and exposed with their original types by the CLI
• kivald now reports duplicate usernames clearly during user provisioning
• enrollment links prefill the intended username in the web application
• the SDK exposes canonical browser URLs for Kival objects
• connected objects are rendered using their titles in the web application
• kivalup avoids redundant installation work and produces cleaner bootstrap output
• GitHub Container Registry releases now publish the latest alias alongside versioned images

The release also improves SDK package metadata, project documentation, ACME demo instructions, and contribution guidance.

Upgrade

Existing installations can update to Kival 0.1.1 with:

kivalup --update

No changes to the core knowledge model are included in this release.

Featured changes

Fixes

• fix(release): npm post-publish verification by @zerosnacks in #23
• fix(release): publish GHCR latest alias and image description by @zerosnacks in #25
• fix(cli): align event pagination with API and SDKs by @zerosnacks in #38
• feat(cli): support membership creation by username in the CLI by @zerosnacks in #39
• feat(cli): support object version numbers in direct lookups by @zerosnacks in #40
• fix(kivald): report duplicate usernames during user provisioning by @zerosnacks in #44
• feat(enrollment): prefill username from enrollment links by @zerosnacks in #46
• feat(sdk): expose canonical object browser URLs by @zerosnacks in #47
• fix(app): render connected objects by title by @zerosnacks in #48
• fix(cli): preserve and type structured error details by @zerosnacks in #50
• feat: skip redundant installer work and polish bootstrap output by @zerosnacks in #52
• fix(installer): simplify bootstrap installer version handling by @zerosnacks in #56

Chores

• fix(release): use release tag as GitHub release title by @zerosnacks in #24
• docs(README): streamline README setup and development flow by @zerosnacks in #43
• style: prefer top-level imports across the Rust codebase by @zerosnacks in #51
• chore: improve SDK package metadata for discovery by @zerosnacks in #54
• fix: streamline README and reorganize contribution guidance by @zerosnacks in #55
• chore(README): clarify ACME demo usage and simplify CLI setup by @zerosnacks in #57
• chore(README): clarify demo workspace usage in README by @zerosnacks in #58

Maintenance

• chore(deps): bump uuid from 1.25.0 to 1.26.0 in the cargo-weekly group by @dependabot[bot] in #35
• chore(deps): bump the actions-weekly group with 3 updates by @dependabot[bot] in #36
• chore(deps): bump the npm-weekly group across 2 directories with 1 update by @dependabot[bot] in #37
• chore(deps): bump the actions-weekly group with 3 updates by @dependabot[bot] in #59
• chore(deps): bump the npm-weekly group across 2 directories with 2 updates by @dependabot[bot] in #60

Full Changelog: v0.1.0...v0.1.1

v0.1.0

Kival 0.1.0

Initial public release of Kival.

Kival is a self-hosted collaborative knowledge system for organizations. It gives people and agents a shared place to deliberately create, edit, discuss, connect, version, and govern knowledge while preserving the history, relationships, authorship, and provenance that give it context over time.

Highlights

• shared organizational knowledge organized into workspaces and versioned objects
• collaborative editing, discussion, mentions, notifications, and personal inboxes
• relationships, backlinks, graph exploration, and workspace search
• object history, diffs, metadata, attachments, and provenance
• workspace membership, groups, roles, and scoped access control
• passkey-based user authentication and scoped API keys for software access
• web application for interactive knowledge work and administration
• kival CLI with structured JSON output and machine-readable command schemas
• official Rust and TypeScript SDKs for integrations, automation, and agents
• self-hosted deployment with PostgreSQL and signed release artifacts

Installation

Install kival and kivald using kivalup:

curl --proto '=https' --tlsv1.2 -fsSL \
  https://github.com/selemis-com/kival/releases/latest/download/install | bash

$HOME/.kival/bin/kivalup

Prebuilt releases are available for Linux x86_64, Linux ARM64, and Apple Silicon macOS. Windows is supported through WSL.

The Kival container image is available from GitHub Container Registry:

docker pull ghcr.io/selemis-com/kival:v0.1.0

Official SDKs are available for Rust and TypeScript:

cargo add kival-sdk

npm install kival-sdk

Notes

This is the first public release, so there is no upgrade procedure from an earlier version and the API, SDKs, and operational interfaces may continue to evolve as Kival sees broader use.

Kival is dual licensed under Apache-2.0 OR MIT.

Full Changelog: https://github.com/selemis-com/kival/commits/v0.1.0