plm-knowledge 1.2.0__tar.gz → 1.3.0__tar.gz

{plm_knowledge-1.2.0 → plm_knowledge-1.3.0}/PKG-INFO

@@ -1,12 +1,12 @@
 Metadata-Version: 2.4
 Name: plm-knowledge
-Version: 1.2.0
+Version: 1.3.0
 Summary: TracePulse PLM Knowledge product-line — BM25 retrieval, RAG, business rules, lifecycle FSM, knowledge-pack manifests (Wave 6.5 Conv B / PRD §3 #6). Full description in README.
 Author: TracePulse
 License: Proprietary
 Requires-Python: >=3.12
 Description-Content-Type: text/markdown
-Requires-Dist: plm-shared
+Requires-Dist: plm-shared>=1.4.0
 Requires-Dist: pydantic>=2.5.0
 Requires-Dist: PyYAML>=6.0
 Requires-Dist: rank-bm25>=0.2.2
@@ -51,6 +51,39 @@ carve per PRD §3 #6.
 * `plm_knowledge.registry` — manifest+lifecycle registry exposed to
   the kernel (capability registry callers).
 
+## Foundation MVP-0 corpus qualification (FTR-2219 / US-2219-01)
+
+`plm_knowledge.foundation` turns the bundled 146-document Markdown corpus,
+taken at an **exact pinned commit SHA**, into a reviewable, byte-reproducible
+qualification matrix under the versioned policy
+`foundation-corpus-qualification/0.1.0`. It is build-time governance, **not** a
+runtime search surface (retrieval stays out of scope for MVP-0).
+
+* Every candidate is classified `included` / `excluded` / `invalid` with a
+  reason code; no candidate disappears from the matrix. Included documents
+  carry `qualified_seed` authority.
+* Approved MVP-0 perimeter: `plm` / `bpmn` / `ontology` / `data` / `rgpd` are
+  the included seed; `customers` is excluded `sensitive` and `prompt_library`
+  is excluded `out_of_scope`. At the pinned seed revision the matrix is
+  **146 candidates → 55 included / 91 excluded / 0 invalid** (the 4 zero-byte
+  category-index files are reason-coded `empty`).
+* Stable identity: `document_id = "doc:" + sha256(NFC(source_relative_path))`;
+  content is EOL-normalized before hashing so `content_sha256` is reproducible
+  across checkouts. Canonical serialization is UTF-8 / LF / sorted-keys /
+  compact JSON with no timestamps or absolute paths.
+
+```bash
+python scripts/qualify_foundation_corpus.py            # dry-run report (writes nothing)
+python scripts/qualify_foundation_corpus.py --execute   # write the approved inventory
+python scripts/qualify_foundation_corpus.py --check      # determinism gate: fail on any drift
+```
+
+The executed inventory lives in-repo at
+`plm_knowledge/foundation/inventory/foundation-inventory.json` and is consumed
+by downstream package-projection / integrity stories from the source tree. It
+is intentionally **not** shipped as wheel package-data, since the matrix
+enumerates the paths of perimeter-excluded `sensitive` documents.
+
 ## Lifecycle FSM (PRD §8.11.3 verbatim — Decision #167 mirrored)
 
 ```

{plm_knowledge-1.2.0 → plm_knowledge-1.3.0}/README.md

@@ -31,6 +31,39 @@ carve per PRD §3 #6.
 * `plm_knowledge.registry` — manifest+lifecycle registry exposed to
   the kernel (capability registry callers).
 
+## Foundation MVP-0 corpus qualification (FTR-2219 / US-2219-01)
+
+`plm_knowledge.foundation` turns the bundled 146-document Markdown corpus,
+taken at an **exact pinned commit SHA**, into a reviewable, byte-reproducible
+qualification matrix under the versioned policy
+`foundation-corpus-qualification/0.1.0`. It is build-time governance, **not** a
+runtime search surface (retrieval stays out of scope for MVP-0).
+
+* Every candidate is classified `included` / `excluded` / `invalid` with a
+  reason code; no candidate disappears from the matrix. Included documents
+  carry `qualified_seed` authority.
+* Approved MVP-0 perimeter: `plm` / `bpmn` / `ontology` / `data` / `rgpd` are
+  the included seed; `customers` is excluded `sensitive` and `prompt_library`
+  is excluded `out_of_scope`. At the pinned seed revision the matrix is
+  **146 candidates → 55 included / 91 excluded / 0 invalid** (the 4 zero-byte
+  category-index files are reason-coded `empty`).
+* Stable identity: `document_id = "doc:" + sha256(NFC(source_relative_path))`;
+  content is EOL-normalized before hashing so `content_sha256` is reproducible
+  across checkouts. Canonical serialization is UTF-8 / LF / sorted-keys /
+  compact JSON with no timestamps or absolute paths.
+
+```bash
+python scripts/qualify_foundation_corpus.py            # dry-run report (writes nothing)
+python scripts/qualify_foundation_corpus.py --execute   # write the approved inventory
+python scripts/qualify_foundation_corpus.py --check      # determinism gate: fail on any drift
+```
+
+The executed inventory lives in-repo at
+`plm_knowledge/foundation/inventory/foundation-inventory.json` and is consumed
+by downstream package-projection / integrity stories from the source tree. It
+is intentionally **not** shipped as wheel package-data, since the matrix
+enumerates the paths of perimeter-excluded `sensitive` documents.
+
 ## Lifecycle FSM (PRD §8.11.3 verbatim — Decision #167 mirrored)
 
 ```

plm_knowledge-1.3.0/plm_knowledge/foundation/__init__.py

@@ -0,0 +1,35 @@
+"""Foundation MVP-0 governance surface for ``plm-knowledge``.
+
+This subpackage hosts the deterministic Foundation build-governance workers
+(FTR-2219). US-2219-01 lands the corpus **inventory & qualification** worker:
+it turns the bundled 146-document Markdown corpus, taken at an exact pinned
+repository revision, into a reviewable, byte-reproducible qualification matrix
+under the versioned policy ``foundation-corpus-qualification/0.1.0``.
+
+Nothing here is a runtime search/retrieval surface — that stays out of scope
+for MVP-0. Downstream package projection and integrity stories consume the
+approved inventory produced by :func:`plm_knowledge.foundation.qualification.run_inventory`.
+"""
+from __future__ import annotations
+
+from plm_knowledge.foundation.qualification import (
+    POLICY_VERSION,
+    InvalidRevisionError,
+    PerimeterNotApprovedError,
+    QualificationBlockedError,
+    QualificationError,
+    QualificationResult,
+    qualify,
+    run_inventory,
+)
+
+__all__ = [
+    "POLICY_VERSION",
+    "QualificationResult",
+    "QualificationError",
+    "InvalidRevisionError",
+    "PerimeterNotApprovedError",
+    "QualificationBlockedError",
+    "qualify",
+    "run_inventory",
+]