kpack

The single shared knowledge-pack engine for capability-map corpora — one installable, one console script (kpack) serving every context across every enterprise. Implements ADR-KCM-URBA-0002; replaces the per-map CLIs gov-pack, pcm-pack/tech, and rlv-knowledge.

Architecture and rationale: docs/kpack-design.md.

How it works

id  →  ENTERPRISE (seg 0)  →  kpack config (enterprise → registry repo)
    →  governance repo      →  vocab.yaml contexts: (context → repo)
    →  CONTEXT (seg 0–1)    →  corpus repo  →  knowledge.yaml descriptor  →  fetch + walk

Each corpus publishes a navigation descriptor (knowledge.yaml) declaring how it is fetched and walked — how many event→carrier layers it has and which fields link them. The common edges live once in the shared meta-model cmm.1 (docs/examples/cmm.1.yaml). The engine walks the corpus on demand and emits a uniform, role-keyed JSON envelope; it materialises no graph and stores no credentials (corpora are fetched with your own git identity).

Install

pip install -e ".[dev]"      # from source
# or, as a container (GitHub Packages):
docker run --rm ghcr.io/papeete-hub/kpack pack BNK.RLVR.CAP.BSP.001.SCO

Commands

kpack pack <id> [--deep] [--compact]              # capability pack (context from id)
kpack list --context BNK.TECH [--level L1|L2|L3]  # list capabilities
kpack diff <from_ref> [--to <ref>] --context <C>  # semantic by-id diff
kpack process <id> [--list]                       # DDD process model (if declared)
kpack version [--context <C>]                     # engine version / corpus provenance

Global flags: --ref, --repo-root (local dev), --cache-dir, --no-fetch, --fresh, --config, --registry-repo, --registry-ref.

Configure

~/.config/kpack/config.yaml (or ./.kpack.yaml, or --config):

enterprises:
  BNK: { registry_repo: Banking-PapeeteConsulting/banking-governance, registry_ref: main }
  NUN: { registry_repo: naive-unicorn/naive-unicorn-governance,       registry_ref: main }
default_enterprise: BNK

Develop

make test     # pytest against a fake knowledge stub (tests/conftest.py)
make build    # wheel + sdist
make docker   # build the GHCR image
make smoke REPO=Banking-PapeeteConsulting/reliever-knowledge \
           DESC=docs/examples/knowledge.BNK-RLVR.yaml CAP=BNK.RLVR.CAP.BSP.001.SCO

Key dates

PyPI data
Data sourced directly from PyPI's database.
  • Released:
Latest release

1 maintainer

PyPI data
Data sourced directly from PyPI's database.
Avatar for arthis from gravatar.com arthis

Credits

Author: yremy

License

Proprietary

Requires

Python >=3.10

Provides Extra

dev

Report project as malware

Download files

Download the file for your platform. If you're not sure which to choose, learn more about installing packages.

Source Distribution

kpack-2.0.1.tar.gz (30.6 kB view details)

Uploaded Source

Built Distribution

If you're not sure about the file name format, learn more about wheel file names.

kpack-2.0.1-py3-none-any.whl (31.3 kB view details)

Uploaded Python 3

File details

Details for the file kpack-2.0.1.tar.gz.

File metadata

  • Download URL: kpack-2.0.1.tar.gz
  • Upload date:
  • Size: 30.6 kB
  • Tags: Source
  • Uploaded using Trusted Publishing? Yes
  • Uploaded via: twine/6.1.0 CPython/3.13.12

File hashes

Hashes for kpack-2.0.1.tar.gz
Algorithm Hash digest
SHA256 ea1fea4363f88d40b71f65ca337e0c3c27ad5b7903a22a32efa123cc3675fc5e
MD5 dd5bb780f744bd5262fa4ee815c99cc0
BLAKE2b-256 3fe9bad5b9eaaa7377af8e8b84a4f4dd7f5ade1c7f01c97354a1846f2d2701e6

See more details on using hashes here.

Provenance

The following attestation bundles were made for kpack-2.0.1.tar.gz:

Publisher: release.yml on papeete-hub/kpack

Attestations: Values shown here reflect the state when the release was signed and may no longer be current.

File details

Details for the file kpack-2.0.1-py3-none-any.whl.

File metadata

  • Download URL: kpack-2.0.1-py3-none-any.whl
  • Upload date:
  • Size: 31.3 kB
  • Tags: Python 3
  • Uploaded using Trusted Publishing? Yes
  • Uploaded via: twine/6.1.0 CPython/3.13.12

File hashes

Hashes for kpack-2.0.1-py3-none-any.whl
Algorithm Hash digest
SHA256 78483dafcbe9818ad5f87d9274507f6257e84628153078d2451fd3b456693701
MD5 927caf109a832b2301c6f5d5fca421f4
BLAKE2b-256 80e6aba8f543c698ed4e4f316d700fd8988b271f47ec5d4409c38ffd44378b77

See more details on using hashes here.

Provenance

The following attestation bundles were made for kpack-2.0.1-py3-none-any.whl:

Publisher: release.yml on papeete-hub/kpack

Attestations: Values shown here reflect the state when the release was signed and may no longer be current.

Release history Release notifications | RSS feed

This release

2.0.1 This release

2 files

2.0.0

2 files

Supported by

AWS Cloud computing and Security Sponsor Datadog Monitoring Depot Continuous Integration Fastly CDN Google Download Analytics Sentry Error logging StatusPage Status page