Skip to content

v0.9.0

Latest
Latest

Choose a tag to compare

View all tags
@lair001 lair001 released this 08 Sep 19:30
v0.9.0
139127f

Agentic Praxis Grimoire v0.9.0 Release Notes

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

This documentation covers 0.9.0. The previous public release baseline was
v0.8.1, published and frozen across Git, GitHub Releases, PyPI, npm, and the
Go module proxy. Once this version is published, packages are available from
standard registries. Prior to formal publication, release qualification, packaging,
and publication remain separately authorized boundaries.

Highlights

  • CI-First qualification interface: Added the --summary-file <path> CLI option
    emitting strict 6-field machine-readable JSON evidence (version, subproject,
    suite, test_status, gate_status, source_commit) adhering to JACA's
    subproject evidence contract.
  • Closed validation role taxonomy: Established a 4-role taxonomy:
    • policy: fast mechanical validation checking repository inventory, toolchain
      versions, skill library mechanical and Go embedded corpus integrity, and record identity.
    • unit: Python unit testing with exact 80/80 statement and branch coverage gates.
    • integration: Python integration and CLI boundary testing with exact 80/80 gates.
    • unit-integration (combined / apg-dev-gate): combined union gate requiring
      85/85 statement and branch coverage.
  • JACA XO compatibility & caller-owned adapter pattern: Verified Go library
    consumption behind a caller-owned internal adapter fixture (testing/fixtures/xo_consumer/)
    utilizing caller DTOs (CallerSkillEvidence, CallerFootprintEvidence,
    CallerComponentEvidence, CallerSourceReference, CallerComparisonDelta,
    CallerProjectionEvidence) to ensure zero APGR domain types leak into caller domain.
    Verified pure in-memory smoke execution without subprocesses, AST containment,
    static dependency boundaries (no os/exec, internal, or cmd packages), context
    cancellation propagation, and sentinel error fidelity.
  • Dual-lane verification: Demonstrated clean dual-lane conformance across the
    published v0.8.1 baseline (Lane A via public Go proxy) and the exact development
    candidate (Lane B via disposable local replace).
  • Context-footprint accounting: Source-bound observations with explicit
    fidelity and omission disclosure (footprint Go package and apgr footprint
    CLI commands). Reaffirmed key principles:
    • Observations are source-bound measurements, not capacity forecasts.
    • Unavailable metrics remain explicit with stated reasons and nil values; unavailable != zero.
    • Component separation: selected descriptions, selected bodies, support material,
      repository references, and provider prompt overhead are distinct components;
      overlap is not additive.
  • Preserved invariants: Retained all 39 canonical skills (14 stable / 25
    provisional), the 9,527-byte discovery integrity limit, the six public Go
    packages (schema, report, skills, envsnap, hotspot, footprint), and
    full backward compatibility with published v0.8.1 APIs.

Truthful status and boundaries

  • Published baseline vs 0.9.0 release:
    • v0.8.1 is the preceding frozen baseline on Git, GitHub Releases, PyPI, npm, and Go proxy.
    • Once this version is published, 0.9.0 packages become available on public registries.
      Prior to publication, candidate downloads are not published to registries.
  • APGR-local qualification != JACA registration:
    • APGR-local qualification of CI summary emission and test roles is completed
      on Darwin arm64 under phase APG114 (Exit 00159).
    • Downstream runner registration in JACA CI (tools/ci/evidence.go, workflow.go,
      trustedRoleOrder) is consumer-owned in the JACA repository and remains pending.
  • XO fixture != production adapter or security proof:
    • The caller-owned adapter in testing/fixtures/xo_consumer/ qualifies APGR Go
      package compatibility and illustrates DTO containment.
    • It is not JACA's production adapter (which belongs in JACA's xo/src/main/go).
    • Bounded passive DTOs do not enforce workflow security or prove universal isolation.
  • Platform support and developer qualification gate:
    • Prebuilt runtime targets: macOS Apple Silicon (darwin/arm64), Linux x86_64
      (linux/amd64), and Linux ARM64 (linux/arm64).
    • Developer qualification gate: macOS Darwin arm64 is fully qualified.
      The Linux x86_64 developer qualification gate is currently pending: the policy
      suite is pending runner qualification, and unit/integration/combined
      suites are blocked by whole-inventory preflight binding Darwin arm64 Nix store digests.
  • Dispatch and package contents:
    • apgr test (including --summary-file and the policy role) is a repository
      maintenance command requiring an APGR Git source checkout and the developer
      toolchain (Python 3.11+, pytest, coverage, pytest-cov, pytest-xdist, Git 2.40+, Go 1.25+).
    • Prebuilt native Go binaries (cmd/apgr) and bare wheels/npm packages do not
      carry the test runner or test suites. Prebuilt binaries provide runtime commands
      (skills, footprint, env, analyze hotspots, report, response).

Source-checkout first use

To explore the v0.9.0 source, use an APGR Git checkout:

# From the checkout root:
go run ./cmd/apgr --version
go run ./cmd/apgr skills list

To run the v0.9 CI qualification summary interface in a checkout with developer toolchain:

# Run fast mechanical policy validation emitting machine-readable summary
bin/apgr test policy --summary-file "${TMPDIR:-/tmp}/apgr-policy-summary.json"
cat "${TMPDIR:-/tmp}/apgr-policy-summary.json"

Once this version is published, standard registry installation commands (pip install agentic-praxis-grimoire==0.9.0, npm install -g @knowledge-forge-ai/apgr@0.9.0, go get github.com/Knowledge-Forge-AI/agentic-praxis-grimoire@v0.9.0) become active. Prior to formal publication, installation is via source checkout.

Use the existing pinned developer Python environment: pytest 9.1.1, coverage
7.15.2, pytest-cov 7.1.0, and pytest-xdist 3.8.0. Unit and integration preflight
also require the selected TypeScript 7.0.2 compiler and Node runtimes identified
in the CI handoff. The Python frontend
may be installed, but still needs those prerequisites and the checkout; a bare
native/npm executable has no test command even when invoked from a checkout.
combined is the summary suite value and apg-dev-gate is a consumer role alias;
the CLI argument is unit-integration. source_commit records entry HEAD,
so qualification of uncommitted source also needs a separate tested-tree binding.

Upgrade guidance

  • Production consumers: Once this version is published, upgrade to 0.9.0 across supported registries. Prior to publication, production consumers remain on the published, frozen v0.8.1 release.
  • Go library consumers: All public APIs in skills, footprint, schema,
    report, envsnap, and hotspot remain fully backward-compatible with v0.8.1. Once this version is published, depend on v0.9.0.
  • Candidate evaluators: Use disposable local Go replace directives or
    checkout-local scripts to test candidate features without affecting production locks.

Documentation index

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 require adherence to the project contribution terms in
CLA.md and CONTRIBUTING.md.

Assets 12
Loading