Changelog of @hackage/okf-cli 0.2.0.0

Changelog

All notable changes to okf are recorded here.

The format follows Keep a Changelog, and this project adheres to Semantic Versioning.

okf id next and okf id list for allocating and listing profile-declared document handles, plus document-ID fallback in okf show so a handle such as ADR-7 resolves to the concept that carries it.
Optional BUNDLE and CONCEPT_ID arguments for okf show, filled in with fzf menus when omitted, plus the okf help interactive topic. Search roots default to the current directory and can be overridden with OKF_BUNDLE_ROOTS.

Requires okf-core >=0.2.0.0, whose profile Dhall schema gained the required idField and idPrefix record fields. Profile descriptors passed to okf validate --profile must add those values or adopt the new record-completion defaults.

Ship the help/*.md topic sources in the sdist via extra-source-files. They are embedded at compile time by Okf.Cli.Help (file-embed), so their absence from the 0.1.2.0 Hackage tarball made that release fail to build from Hackage.

okf kit command for installing reusable AI-agent skills and subagents from a configured okf-kit git repository (list, install, update, uninstall, status), with user and project (--project) scopes.
okf assist command that launches an interactive Claude session seeded with a prompt and your installed okf skills on its path; --print-command prints the command line without launching.
okf config command for managing the optional agent-assistance settings (show, path, init, init --global), sourced from okf-config.dhall, ~/.config/okf/config.dhall, or OKF_CONFIG with built-in defaults.
okf help topics for kit, config, and agents documenting the kit, configuration, and assist workflows.

okf --version, including git SHA reporting for Cabal and Nix builds when available.
Shell completion generation for supported shells.
okf help command with embedded conceptual topic guides (okf, format, validation, profiles), including a guide explaining what the Open Knowledge Format is. The guides are plain text baked into the binary at compile time, so okf help <topic> works with no network or docs checkout.
Profile-based validation: okf validate --profile <descriptor>.dhall checks a bundle against a team's house conventions (allowed type strings, required frontmatter keys, resource: schemes, file layout, and # Schema columns) declared in a Dhall descriptor. Profiles are not part of the OKF standard, so deviations are advisory by default; --profile-enforce fails the command on drift. Ships an example bundle (examples/postgresql-sample), a sample descriptor (docs/profiles/postgresql.dhall), and a user guide (docs/user/profiles.md).
Log support: okf-core can parse, serialize, and validate log.md files; okf-cli can preview, validate, author log entries, and report drift between bundle logs and git history.
Canonical OKF profile schema Dhall modules with drift tests.

Expanded the README and user guides to cover the current CLI, profile validation, and log workflows.
Updated release, Nix, and repository metadata so both packages build and check as separate Hackage packages.

Initial release.

okf-core library: OKF document parser (Okf.Document), bundle graph indexing (Okf.Index, Okf.Graph), bundle validation with referential integrity (Okf.Validation, Okf.Bundle), concept construction and bundle writing, concept-link rendering with a round-trip guarantee, and a frontmatter authoring API.
okf-cli library and okf executable: bundle validation and document authoring commands over the core API.