Skip to content

OKF Agent Memory v0.1.4

Latest

Choose a tag to compare

@github-actions github-actions released this 08 Sep 08:57

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.ResolveLink and graph construction on Go's POSIX path package 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 under validate --strict.

2. OKF v0.2 §7 Open Actor Family Conformance (Fixes #5)

  • Deprecated the hardcoded human / process actor whitelist in pkg/okf/types.go and removed non-standard prefix warnings in okf validate.
  • Aligns okf validate with 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-green 0 concept(s) / Conformant reporting. Hidden subdirectories (like .git/) and hidden files continue to be safely skipped.

4. Streamlined Makefile & Unified Pipeline

  • Integrated golangci-lint directly into make 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.4

Via Homebrew

brew update
brew upgrade okf

Pre-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