Release v0.1.4 — Cross-Platform & Spec Alignment Maintenance Release
OKF Agent Memory v0.1.4 is a maintenance release addressing community-reported issues regarding Windows link resolution, OKF v0.2 actor specification conformance, and dot-directory bundle scanning, alongside a streamlined CI/local verification pipeline.
Special Thanks & Credits
We want to extend our sincere thanks to our community contributors:
- Ashish (@ashishtele) for investigating and reporting the Windows relative link resolution issue (#6).
- Rogelio (@rogeliodh) for detailed reports and spec analysis on the OKF v0.2 §7 open actor family (#5) and the dot-directory bundle root scanning behavior (#4).
Key Fixes & Improvements
1. Cross-Platform Windows Link Resolution (Fixes #6)
- Standardized link resolution in
b.ResolveLinkand graph construction on Go's POSIXpathpackage with uniform forward-slash normalization. - Prevents Windows host path separators (
\) from corrupting concept map lookups (b.Concepts), resolving false-positive broken links and spurious orphan warnings undervalidate --strict.
2. OKF v0.2 §7 Open Actor Family Conformance (Fixes #5)
- Deprecated the hardcoded
human/processactor whitelist inpkg/okf/types.goand removed non-standard prefix warnings inokf validate. - Aligns
okf validatewith the OKF reference validator (okf_validate.py) by recognizing<prefix>:<id>as an open actor family (e.g.agent:<id>,team:<id>,bot:<id>).
3. Dot-Directory Bundle Root Scanning (Fixes #4)
- Updated
LoadBundle's directory walk to exempt the bundle root directory itself from the hidden-directory filter. - OKF bundles located in dot-directories (such as
.okf/or.okf) are now scanned, loaded, and validated normally, avoiding false-green0 concept(s) / Conformantreporting. Hidden subdirectories (like.git/) and hidden files continue to be safely skipped.
4. Streamlined Makefile & Unified Pipeline
- Integrated
golangci-lintdirectly intomake check, providing a single, explicit pipeline command (check: fmt vet lint test validate-all) for local verification and CI workflows. - Cleaned up and organized Makefile target categories and help documentation.
Installation & Upgrade
Via Go Install
go install github.com/okf-memory/okf-agent-memory/cmd/okf@v0.1.4Via Homebrew
brew update
brew upgrade okfPre-built Binaries
Pre-built standalone binaries and starter packs for macOS, Linux, and Windows (ARM64 and x86_64) are attached to this release.
Full Changelog: v0.1.3...v0.1.4