invarlock 0.3.6__tar.gz → 0.3.7__tar.gz

{invarlock-0.3.6/src/invarlock.egg-info → invarlock-0.3.7}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: invarlock
-Version: 0.3.6
+Version: 0.3.7
 Summary: Edit‑agnostic robustness certificates for weight edits (InvarLock framework)
 Author-email: InvarLock Team <oss@invarlock.dev>
 Maintainer-email: InvarLock Maintainers <support@invarlock.dev>
@@ -31,6 +31,7 @@ Requires-Dist: scikit-learn>=1.4
 Requires-Dist: pydantic>=2.0
 Requires-Dist: rich>=13.0
 Requires-Dist: pyyaml>=6.0
+Requires-Dist: markdown>=3.5
 Requires-Dist: psutil>=5.9
 Requires-Dist: hypothesis>=6.98
 Requires-Dist: typing_extensions>=4.7
@@ -110,9 +111,9 @@ In short: certify that weight edits (e.g., quantization) preserve quality. If
 they don’t, roll back safely.
 
 Technical: edit‑agnostic guard pipeline (invariants → spectral → RMT →
-variance) producing a machine‑readable Safety Certificate.
+variance) producing a machine‑readable Evaluation Certificate.
 
-> **Status:** 0.3.6 (pre‑1.0). Until 1.0, **minor** releases may be
+> **Status:** 0.3.7 (pre‑1.0). Until 1.0, **minor** releases may be
 > breaking. See CLI help and the CHANGELOG for updates.
 
 [![CI](https://img.shields.io/github/actions/workflow/status/invarlock/invarlock/ci.yml?branch=main&logo=github&label=CI)](https://github.com/invarlock/invarlock/actions/workflows/ci.yml)
@@ -127,7 +128,20 @@ For guidance on where to ask questions, how to report bugs, and what to expect i
 
 ## 🚀 Quick start (no repo clone)
 
-[![Open in Colab](https://colab.research.google.com/assets/colab-badge.svg)](https://colab.research.google.com/github/invarlock/invarlock/blob/main/notebooks/invarlock_quickstart_cpu.ipynb)
+Notebooks (Colab):
+
+- [![Open in Colab](https://colab.research.google.com/assets/colab-badge.svg)](https://colab.research.google.com/github/invarlock/invarlock/blob/main/notebooks/invarlock_quickstart_cpu.ipynb)
+  `invarlock_quickstart_cpu.ipynb` — install + certify + verify + HTML export (CPU-friendly)
+- [![Open in Colab](https://colab.research.google.com/assets/colab-badge.svg)](https://colab.research.google.com/github/invarlock/invarlock/blob/main/notebooks/invarlock_compare_certify.ipynb)
+  `invarlock_compare_certify.ipynb` — Compare & Certify (BYOE) end-to-end
+- [![Open in Colab](https://colab.research.google.com/assets/colab-badge.svg)](https://colab.research.google.com/github/invarlock/invarlock/blob/main/notebooks/invarlock_certificate_deep_dive.ipynb)
+  `invarlock_certificate_deep_dive.ipynb` — reading and interpreting certificates
+- [![Open in Colab](https://colab.research.google.com/assets/colab-badge.svg)](https://colab.research.google.com/github/invarlock/invarlock/blob/main/notebooks/invarlock_custom_datasets.ipynb)
+  `invarlock_custom_datasets.ipynb` — Bring Your Own Data (BYOD) with `local_jsonl`
+- [![Open in Colab](https://colab.research.google.com/assets/colab-badge.svg)](https://colab.research.google.com/github/invarlock/invarlock/blob/main/notebooks/invarlock_python_api.ipynb)
+  `invarlock_python_api.ipynb` — programmatic Python API usage
+- [![Open in Colab](https://colab.research.google.com/assets/colab-badge.svg)](https://colab.research.google.com/github/invarlock/invarlock/blob/main/notebooks/invarlock_policy_tiers.ipynb)
+  `invarlock_policy_tiers.ipynb` — Conservative vs Balanced vs Aggressive tier comparison
 
 ```bash
 # Install with HF adapters
@@ -146,8 +160,8 @@ This produces `reports/.../evaluation.cert.json` with paired metrics
 (ppl/accuracy), structural deltas, spectral/RMT stats, variance‑estimator
 provenance, seeds/hashes, pairing metrics, and a policy digest.
 
-> **Calibration note:** tier thresholds and window sizes are piloted on GPT‑2 small,
-> BERT base, and TinyLLaMA (see `docs/assurance/09-tier-v1-calibration.md`). For
+> **Calibration note:** tier thresholds and window sizes are piloted on GPT‑2 small
+> and BERT base (see `docs/assurance/09-tier-v1-calibration.md`). For
 > calibrated Balanced/Conservative certs, use the preset‑based CI/Release examples
 > below. `INVARLOCK_TINY_RELAX` dev runs relax sample‑size floors and are intended
 > only for small smoke tests (not release evidence).
@@ -319,7 +333,7 @@ needed (e.g., `CUDA_VISIBLE_DEVICES`).
   3. **RMT** (ε-band on outliers; monitor or gate per tier)
   4. **Variance (VE)** (predictive paired ΔlogNLL gate; tiered sidedness)
 
-- **Safety Certificate (schema v1, PM‑only)**: Primary Metric (ppl or
+- **Evaluation Certificate (schema v1, PM‑only)**: Primary Metric (ppl or
   accuracy) with paired statistics, structural deltas, spectral/RMT stats, VE
   provenance, seeds/hashes, pairing metrics, and **policy digest**. Canonical
   artifact: `reports/.../evaluation.cert.json`.
@@ -440,7 +454,7 @@ Key checks enforced by balanced policy (summary):
 ```yaml
 model:
   id: "<set-your-model-id>"   # e.g., gpt2
-  adapter: "hf_gpt2"
+  adapter: "hf_causal"
   device: "cpu"
 dataset:
   provider: "wikitext2"
@@ -505,7 +519,7 @@ invarlock/
 │  ├─ invarlock/                 # core + unified namespace
 │  │  ├─ core/               # runner, registry, contracts, events, ABI
 │  │  ├─ cli/                # console app + command wrappers (unified import path)
-│  │  ├─ adapters/           # adapter wrappers (HF GPT‑2/BERT/LLaMA)
+│  │  ├─ adapters/           # model adapters (HF causal/MLM/seq2seq/onnx)
 │  │  ├─ edits/              # quant_rtn
 │  │  ├─ guards/             # invariants, spectral, rmt, variance
 │  │  ├─ eval/               # evaluation metrics and helpers

{invarlock-0.3.6 → invarlock-0.3.7}/README.md

@@ -4,9 +4,9 @@ In short: certify that weight edits (e.g., quantization) preserve quality. If
 they don’t, roll back safely.
 
 Technical: edit‑agnostic guard pipeline (invariants → spectral → RMT →
-variance) producing a machine‑readable Safety Certificate.
+variance) producing a machine‑readable Evaluation Certificate.
 
-> **Status:** 0.3.6 (pre‑1.0). Until 1.0, **minor** releases may be
+> **Status:** 0.3.7 (pre‑1.0). Until 1.0, **minor** releases may be
 > breaking. See CLI help and the CHANGELOG for updates.
 
 [![CI](https://img.shields.io/github/actions/workflow/status/invarlock/invarlock/ci.yml?branch=main&logo=github&label=CI)](https://github.com/invarlock/invarlock/actions/workflows/ci.yml)
@@ -21,7 +21,20 @@ For guidance on where to ask questions, how to report bugs, and what to expect i
 
 ## 🚀 Quick start (no repo clone)
 
-[![Open in Colab](https://colab.research.google.com/assets/colab-badge.svg)](https://colab.research.google.com/github/invarlock/invarlock/blob/main/notebooks/invarlock_quickstart_cpu.ipynb)
+Notebooks (Colab):
+
+- [![Open in Colab](https://colab.research.google.com/assets/colab-badge.svg)](https://colab.research.google.com/github/invarlock/invarlock/blob/main/notebooks/invarlock_quickstart_cpu.ipynb)
+  `invarlock_quickstart_cpu.ipynb` — install + certify + verify + HTML export (CPU-friendly)
+- [![Open in Colab](https://colab.research.google.com/assets/colab-badge.svg)](https://colab.research.google.com/github/invarlock/invarlock/blob/main/notebooks/invarlock_compare_certify.ipynb)
+  `invarlock_compare_certify.ipynb` — Compare & Certify (BYOE) end-to-end
+- [![Open in Colab](https://colab.research.google.com/assets/colab-badge.svg)](https://colab.research.google.com/github/invarlock/invarlock/blob/main/notebooks/invarlock_certificate_deep_dive.ipynb)
+  `invarlock_certificate_deep_dive.ipynb` — reading and interpreting certificates
+- [![Open in Colab](https://colab.research.google.com/assets/colab-badge.svg)](https://colab.research.google.com/github/invarlock/invarlock/blob/main/notebooks/invarlock_custom_datasets.ipynb)
+  `invarlock_custom_datasets.ipynb` — Bring Your Own Data (BYOD) with `local_jsonl`
+- [![Open in Colab](https://colab.research.google.com/assets/colab-badge.svg)](https://colab.research.google.com/github/invarlock/invarlock/blob/main/notebooks/invarlock_python_api.ipynb)
+  `invarlock_python_api.ipynb` — programmatic Python API usage
+- [![Open in Colab](https://colab.research.google.com/assets/colab-badge.svg)](https://colab.research.google.com/github/invarlock/invarlock/blob/main/notebooks/invarlock_policy_tiers.ipynb)
+  `invarlock_policy_tiers.ipynb` — Conservative vs Balanced vs Aggressive tier comparison
 
 ```bash
 # Install with HF adapters
@@ -40,8 +53,8 @@ This produces `reports/.../evaluation.cert.json` with paired metrics
 (ppl/accuracy), structural deltas, spectral/RMT stats, variance‑estimator
 provenance, seeds/hashes, pairing metrics, and a policy digest.
 
-> **Calibration note:** tier thresholds and window sizes are piloted on GPT‑2 small,
-> BERT base, and TinyLLaMA (see `docs/assurance/09-tier-v1-calibration.md`). For
+> **Calibration note:** tier thresholds and window sizes are piloted on GPT‑2 small
+> and BERT base (see `docs/assurance/09-tier-v1-calibration.md`). For
 > calibrated Balanced/Conservative certs, use the preset‑based CI/Release examples
 > below. `INVARLOCK_TINY_RELAX` dev runs relax sample‑size floors and are intended
 > only for small smoke tests (not release evidence).
@@ -213,7 +226,7 @@ needed (e.g., `CUDA_VISIBLE_DEVICES`).
   3. **RMT** (ε-band on outliers; monitor or gate per tier)
   4. **Variance (VE)** (predictive paired ΔlogNLL gate; tiered sidedness)
 
-- **Safety Certificate (schema v1, PM‑only)**: Primary Metric (ppl or
+- **Evaluation Certificate (schema v1, PM‑only)**: Primary Metric (ppl or
   accuracy) with paired statistics, structural deltas, spectral/RMT stats, VE
   provenance, seeds/hashes, pairing metrics, and **policy digest**. Canonical
   artifact: `reports/.../evaluation.cert.json`.
@@ -334,7 +347,7 @@ Key checks enforced by balanced policy (summary):
 ```yaml
 model:
   id: "<set-your-model-id>"   # e.g., gpt2
-  adapter: "hf_gpt2"
+  adapter: "hf_causal"
   device: "cpu"
 dataset:
   provider: "wikitext2"
@@ -399,7 +412,7 @@ invarlock/
 │  ├─ invarlock/                 # core + unified namespace
 │  │  ├─ core/               # runner, registry, contracts, events, ABI
 │  │  ├─ cli/                # console app + command wrappers (unified import path)
-│  │  ├─ adapters/           # adapter wrappers (HF GPT‑2/BERT/LLaMA)
+│  │  ├─ adapters/           # model adapters (HF causal/MLM/seq2seq/onnx)
 │  │  ├─ edits/              # quant_rtn
 │  │  ├─ guards/             # invariants, spectral, rmt, variance
 │  │  ├─ eval/               # evaluation metrics and helpers

{invarlock-0.3.6 → invarlock-0.3.7}/pyproject.toml

@@ -4,7 +4,7 @@ build-backend = "setuptools.build_meta"
 
 [project]
 name = "invarlock"
-version = "0.3.6"
+version = "0.3.7"
 description = "Edit‑agnostic robustness certificates for weight edits (InvarLock framework)"
 authors = [{ name = "InvarLock Team", email = "oss@invarlock.dev" }]
 maintainers = [{ name = "InvarLock Maintainers", email = "support@invarlock.dev" }]
@@ -35,6 +35,7 @@ dependencies = [
     "pydantic>=2.0",
     "rich>=13.0",
     "pyyaml>=6.0",
+    "markdown>=3.5",
     "psutil>=5.9",
     "hypothesis>=6.98",
     "typing_extensions>=4.7",
@@ -161,9 +162,11 @@ invariants = "invarlock.guards:InvariantsGuard"
 hello_guard = "invarlock.plugins:HelloGuard"
 
 [project.entry-points."invarlock.adapters"]
-hf_gpt2 = "invarlock.adapters:HF_GPT2_Adapter"
-hf_bert = "invarlock.adapters:HF_BERT_Adapter"
-hf_llama = "invarlock.adapters:HF_LLaMA_Adapter"
+hf_causal = "invarlock.adapters:HF_Causal_Adapter"
+hf_mlm = "invarlock.adapters:HF_MLM_Adapter"
+hf_seq2seq = "invarlock.adapters:HF_Seq2Seq_Adapter"
+hf_causal_onnx = "invarlock.adapters:HF_Causal_ONNX_Adapter"
+hf_auto = "invarlock.adapters:HF_Auto_Adapter"
 hf_gptq = "invarlock.plugins.hf_gptq_adapter:HF_GPTQ_Adapter"
 hf_awq = "invarlock.plugins.hf_awq_adapter:HF_AWQ_Adapter"
 hf_bnb = "invarlock.plugins.hf_bnb_adapter:HF_BNB_Adapter"

{invarlock-0.3.6 → invarlock-0.3.7}/src/invarlock/__init__.py

@@ -6,13 +6,13 @@ Core runtime package — torch-independent utilities, configuration, and interfa
 
 This package provides the foundation for the InvarLock GuardChain without heavy dependencies.
 For torch-dependent functionality, see subpackages under `invarlock.*`:
-- `invarlock.adapters`: Model adapters (HF GPT-2/BERT/LLaMA, auto)
+- `invarlock.adapters`: Model adapters (HF causal/MLM/seq2seq + auto)
 - `invarlock.guards`: Safety mechanisms (invariants, spectral, RMT, variance)
 - `invarlock.edits`: Built-in quantization and edit interfaces
 - `invarlock.eval`: Metrics, guard-overhead checks, and certification
 """
 
-__version__ = "0.3.6"
+__version__ = "0.3.7"
 
 # Core exports - torch-independent
 from .config import CFG, Defaults, get_default_config

{invarlock-0.3.6 → invarlock-0.3.7}/src/invarlock/adapters/__init__.py

@@ -29,13 +29,11 @@ from .capabilities import (
 )
 
 _LAZY_MAP = {
-    "HF_BERT_Adapter": ".hf_bert",
-    "HF_GPT2_Adapter": ".hf_gpt2",
-    "HF_LLaMA_Adapter": ".hf_llama",
-    "HF_T5_Adapter": ".hf_t5",
-    "HF_ORT_CausalLM_Adapter": ".hf_onnx",
-    "HF_Causal_Auto_Adapter": ".auto",
-    "HF_MLM_Auto_Adapter": ".auto",
+    "HF_Causal_Adapter": ".hf_causal",
+    "HF_MLM_Adapter": ".hf_mlm",
+    "HF_Seq2Seq_Adapter": ".hf_seq2seq",
+    "HF_Causal_ONNX_Adapter": ".hf_causal_onnx",
+    "HF_Auto_Adapter": ".auto",
 }
 
 
@@ -91,13 +89,11 @@ run_invarlock = _RemovedComponent("run_invarlock", "invarlock.cli.run")
 quick_prune_gpt2 = _RemovedComponent("quick_prune_gpt2")
 
 __all__ = [
-    "HF_GPT2_Adapter",
-    "HF_BERT_Adapter",
-    "HF_LLaMA_Adapter",
-    "HF_T5_Adapter",
-    "HF_ORT_CausalLM_Adapter",
-    "HF_Causal_Auto_Adapter",
-    "HF_MLM_Auto_Adapter",
+    "HF_Causal_Adapter",
+    "HF_MLM_Adapter",
+    "HF_Seq2Seq_Adapter",
+    "HF_Causal_ONNX_Adapter",
+    "HF_Auto_Adapter",
     "BaseAdapter",
     "AdapterConfig",
     "AdapterInterface",

{invarlock-0.3.6 → invarlock-0.3.7}/src/invarlock/adapters/auto.py

@@ -110,21 +110,26 @@ class _DelegatingAdapter(ModelAdapter):
 
     def _load_adapter(self, adapter_name: str) -> ModelAdapter:
         """Load an adapter by name."""
-        if adapter_name == "hf_llama":
-            HF_LLaMA_Adapter = _importlib.import_module(
-                ".hf_llama", __package__
-            ).HF_LLaMA_Adapter
-            return HF_LLaMA_Adapter()
-        elif adapter_name == "hf_bert":
-            HF_BERT_Adapter = _importlib.import_module(
-                ".hf_bert", __package__
-            ).HF_BERT_Adapter
-            return HF_BERT_Adapter()
-        elif adapter_name == "hf_gpt2":
-            HF_GPT2_Adapter = _importlib.import_module(
-                ".hf_gpt2", __package__
-            ).HF_GPT2_Adapter
-            return HF_GPT2_Adapter()
+        if adapter_name == "hf_causal":
+            HF_Causal_Adapter = _importlib.import_module(
+                ".hf_causal", __package__
+            ).HF_Causal_Adapter
+            return HF_Causal_Adapter()
+        if adapter_name == "hf_mlm":
+            HF_MLM_Adapter = _importlib.import_module(
+                ".hf_mlm", __package__
+            ).HF_MLM_Adapter
+            return HF_MLM_Adapter()
+        if adapter_name == "hf_seq2seq":
+            HF_Seq2Seq_Adapter = _importlib.import_module(
+                ".hf_seq2seq", __package__
+            ).HF_Seq2Seq_Adapter
+            return HF_Seq2Seq_Adapter()
+        if adapter_name == "hf_causal_onnx":
+            HF_Causal_ONNX_Adapter = _importlib.import_module(
+                ".hf_causal_onnx", __package__
+            ).HF_Causal_ONNX_Adapter
+            return HF_Causal_ONNX_Adapter()
         elif adapter_name == "hf_bnb":
             HF_BNB_Adapter = _importlib.import_module(
                 "invarlock.plugins.hf_bnb_adapter"
@@ -141,11 +146,11 @@ class _DelegatingAdapter(ModelAdapter):
             ).HF_GPTQ_Adapter
             return HF_GPTQ_Adapter()
         else:
-            # Default to GPT2 adapter
-            HF_GPT2_Adapter = _importlib.import_module(
-                ".hf_gpt2", __package__
-            ).HF_GPT2_Adapter
-            return HF_GPT2_Adapter()
+            # Default to causal adapter
+            HF_Causal_Adapter = _importlib.import_module(
+                ".hf_causal", __package__
+            ).HF_Causal_Adapter
+            return HF_Causal_Adapter()
 
     def _ensure_delegate_from_id(self, model_id: str) -> ModelAdapter:
         if self._delegate is not None:
@@ -172,14 +177,16 @@ class _DelegatingAdapter(ModelAdapter):
             self._delegate = self._load_adapter(quant_adapter)
             return self._delegate
 
-        # Fall back to class name inspection
+        # Fall back to lightweight class-name inspection (no transformers import).
         cls_name = getattr(model, "__class__", type(model)).__name__.lower()
-        if any(k in cls_name for k in ["llama", "mistral", "qwen", "yi"]):
-            self._delegate = self._load_adapter("hf_llama")
-        elif any(k in cls_name for k in ["bert", "roberta", "albert", "deberta"]):
-            self._delegate = self._load_adapter("hf_bert")
+        if any(k in cls_name for k in ["bert", "roberta", "albert", "deberta"]):
+            self._delegate = self._load_adapter("hf_mlm")
         else:
-            self._delegate = self._load_adapter("hf_gpt2")
+            cfg = getattr(model, "config", None)
+            if getattr(cfg, "is_encoder_decoder", False):
+                self._delegate = self._load_adapter("hf_seq2seq")
+            else:
+                self._delegate = self._load_adapter("hf_causal")
         return self._delegate
 
     def can_handle(self, model: Any) -> bool:  # pragma: no cover - trivial
@@ -206,21 +213,9 @@ class _DelegatingAdapter(ModelAdapter):
         raise AttributeError(item)
 
 
-class HF_Causal_Auto_Adapter(_DelegatingAdapter):
-    name = "hf_causal_auto"
+class HF_Auto_Adapter(_DelegatingAdapter):
+    name = "hf_auto"
 
     def load_model(self, model_id: str, device: str = "auto", **kwargs: Any) -> Any:
         delegate = self._ensure_delegate_from_id(model_id)
         return delegate.load_model(model_id, device=device, **kwargs)
-
-
-class HF_MLM_Auto_Adapter(_DelegatingAdapter):
-    name = "hf_mlm_auto"
-
-    def load_model(self, model_id: str, device: str = "auto", **kwargs: Any) -> Any:
-        # Force BERT-like adapter for MLM families
-        HF_BERT_Adapter = _importlib.import_module(
-            ".hf_bert", __package__
-        ).HF_BERT_Adapter
-        self._delegate = HF_BERT_Adapter()
-        return self._delegate.load_model(model_id, device=device, **kwargs)

{invarlock-0.3.6 → invarlock-0.3.7}/src/invarlock/adapters/capabilities.py

@@ -359,7 +359,7 @@ def _detect_weight_tying(model: Any) -> dict[str, str]:
     tying: dict[str, str] = {}
 
     # Common weight tying patterns
-    # LLaMA/Mistral: lm_head.weight ↔ model.embed_tokens.weight
+    # Decoder embed_tokens style: lm_head.weight ↔ model.embed_tokens.weight
     if hasattr(model, "lm_head") and hasattr(model, "model"):
         inner = model.model
         if hasattr(inner, "embed_tokens"):
@@ -408,7 +408,7 @@ def _detect_primary_metric(model: Any) -> str:
             return "rouge"
         return "ppl_seq2seq"
 
-    # Decoder-only models (GPT-like, LLaMA-like)
+    # Decoder-only models (GPT-like, RoPE-style)
     return "ppl_causal"