Skip to content

v0.8.1

Choose a tag to compare

@lair001 lair001 released this 06 Sep 17:13
· 1 commit to main since this release

Agentic Praxis Grimoire v0.8.1

Agentic Praxis Grimoire (APGR) is a provider-neutral toolkit and canonical skill
corpus for bounded agent engineering. It gives coding-agent systems, LLM
harnesses, and workflow engines deterministic primitives for task-scoped guidance
selection, immutable evidence collection, curated environment resolution,
repository structure inspection, and context-footprint accounting without
imposing orchestration policy.

Highlights

  • Context-footprint accounting: Full support for measuring, comparing, and
    projecting context budgets across descriptions, bodies, and support material
    via the new public footprint Go package and apgr footprint CLI commands.
  • Strict schema versions: Introduces versioned schemas including
    apg.context-footprint/v1, apg.context-comparison/v1,
    apg.context-projection/v1, apg.context-component-registry/v1, and
    apg.capacity-control-mapping/v1.
  • 39 Canonical Agent Skills: 14 stable and 25 provisional skill leaves
    curated for test discipline, code hygiene, language profiles, and agentic workflows.
  • Reusable Go packages: Public packages for schema, report, skills,
    envsnap, hotspot, and footprint.
  • Deterministic multi-registry packaging: Bit-for-bit reproducible wheels,
    source distribution, npm platform packages, launcher, distribution manifest,
    and checksums.
  • Enhanced package presentation: Packaged human-facing READMEs and rich
    metadata on PyPI, npm, and GitHub.

Installation

Python (PyPI)

pip install agentic-praxis-grimoire==0.8.1
apgr --version

npm (Node.js)

npm install -g @knowledge-forge-ai/apgr@0.8.1
apgr --version

Or run via npx:

npx @knowledge-forge-ai/apgr@0.8.1 --version

Go library & CLI

CLI executable:

go install github.com/Knowledge-Forge-AI/agentic-praxis-grimoire/cmd/apgr@v0.8.1

Go module dependency:

go get github.com/Knowledge-Forge-AI/agentic-praxis-grimoire@v0.8.1

Release recovery & v0.8.0 predecessor status

During the initial publication attempt of v0.8.0 on 2026-08-31:

  • Git commit fc0fd99b41d24951d7db3535402c46ef9c671143 was pushed to main;
  • Annotated tag v0.8.0 (aa83b64f019b92e211154cd246b939f3fc62ac91) was created; and
  • The Go module proxy (proxy.golang.org) indexed v0.8.0.

Downstream publication to GitHub Releases, PyPI, and npm was stopped before completion
due to interactive credential requirements and stale documentation descriptions.
In adherence to registry immutability and zero-overwrite rules:

  • The v0.8.0 Git ref and Go module entries are preserved unchanged as immutable
    predecessor state; no tag is rewritten or force-pushed.
  • v0.8.1 is the first complete, synchronized release across all surfaces (Git,
    GitHub Releases, PyPI, npm, and Go module proxy).

Compatibility and breaking-change status

  • Additive & backward-compatible: Fully backward-compatible with v0.7.0.
  • All public v0.7 APIs (schema, report, skills, envsnap, hotspot) remain
    stable and compatible.
  • The footprint package and CLI subcommands are additive.
  • No public breaking changes.

Supported targets

APGR provides prebuilt native binaries for:

  • macOS Apple Silicon: darwin/arm64 (macosx_11_0_arm64)
  • Linux x86_64: linux/amd64 (manylinux_2_17_x86_64, linux-x64)
  • Linux ARM64: linux/arm64 (manylinux_2_17_aarch64, linux-arm64)

Verification and checksums

Every official release includes ten canonical assets verified by SHA256SUMS and
apg-distribution-manifest.json:

  1. agentic_praxis_grimoire-0.8.1-py3-none-macosx_11_0_arm64.whl
  2. agentic_praxis_grimoire-0.8.1-py3-none-manylinux_2_17_aarch64.whl
  3. agentic_praxis_grimoire-0.8.1-py3-none-manylinux_2_17_x86_64.whl
  4. agentic_praxis_grimoire-0.8.1.tar.gz
  5. knowledge-forge-ai-apgr-darwin-arm64-0.8.1.tgz
  6. knowledge-forge-ai-apgr-linux-x64-0.8.1.tgz
  7. knowledge-forge-ai-apgr-linux-arm64-0.8.1.tgz
  8. knowledge-forge-ai-apgr-0.8.1.tgz
  9. apg-distribution-manifest.json
  10. SHA256SUMS

Verify downloads with:

sha256sum -c SHA256SUMS

Known limitations

  • Operating systems: Linux and macOS only. Windows is not supported by the
    prebuilt native binaries or embeddable Go core.
  • Context estimates: Provider-specific token estimates are marked explicitly
    as unavailable unless supplied by the caller; APGR measures exact bytes and
    UTF-8 characters locally without guessing tokenizer rules.
  • Offline operation: Binary packages and CLI run entirely offline with zero
    telemetry or external network calls.

Documentation

Contributing & licensing

Agentic Praxis Grimoire is free software licensed under the
GNU Affero General Public License v3.0 or later (AGPL-3.0-or-later).
Commercial licensing options and enterprise support are available from
Knowledge Forge AI.
Contributions are welcomed under the terms described in
CONTRIBUTING.md
and CLA.md.