restore: recover the pre-batch README from git history; verified-links section appended

README.md

@@ -1,34 +1,173 @@
 ---
+thumbnail: https://huggingface.co/SZLHOLDINGS/KHIPU-R2/resolve/9fc2f7bebeaf4b3d6d26f7a2a1788a27f8c9ed52/og-card.png
 license: apache-2.0
-library_name: transformers
+language:
+  - en
+base_model: Qwen/Qwen2.5-1.5B-Instruct
+base_model_relation: adapter
+library_name: peft
+pipeline_tag: text-generation
 tags:
-- szl-holdings
-- receipts-backed
+  - qlora
+  - peft
+  - governed-agent
+  - proposal-only
+  - research-only
+  - szl-holdings
+  - khipu
+  - abstain-retrain
+szl:
+  doctrine: v11-LOCKED
+  lean: "749/14/163"
+  lambda: "Conjecture 1 — advisory, never a theorem"
+  artifact_class: ADAPTER
+  publication_eligible: false
+  autonomy_eligible: false
+  never_overwrite: SZLHOLDINGS/SZL-Khipu-1.5B
+  jobs: COMPLETED
+  job_id: "6a91bf11984507d9db4ea104"
+  job_prior_error: "6a91ba2c45686a1580c12020"
+  weights: AVAILABLE
+  evals: MEASURED
+  gpu: UNAVAILABLE
 ---
 
-# Khipu R2
+<!-- SZL-CARD-PRESENTATION:v1 -->
+<p><a href="https://huggingface.co/SZLHOLDINGS"><img src="https://raw.githubusercontent.com/szl-holdings/szl-brand/27d12e77fc0f9f1a0e5fae8b34adf2380d51d070/kit/logos/orbit-v2/suite/szl-icon-32.svg" alt="SZL Holdings" width="48" height="48" /></a></p>
 
-> Khipu R2 — part of the SZL Holdings AI estate
+# KHIPU-R2
 
-[![License](https://img.shields.io/badge/license-Apache--2.0-22d3ee.svg)](https://github.com/szl-holdings)
-[![Receipts](https://img.shields.io/badge/receipts-on__chain-34d399.svg)](https://huggingface.co/datasets/SZLHOLDINGS/frontier-54-runs)
-[![Source](https://img.shields.io/badge/source-GitHub-64748b.svg)](https://github.com/szl-holdings)
+A separate abstention-retraining experiment with adapter-scoped historical evaluation records.
 
+**Artifact:** QLoRA adapter; separate merged checkpoint · **Stage:** Research · release blocked
 
-## What this is
+[Command Lab](https://huggingface.co/spaces/SZLHOLDINGS/szl-command-lab) · [Canonical source](https://github.com/szl-holdings/szl-forge/tree/main/khipu-r2) · [Reviewed evidence](https://github.com/szl-holdings/szl-forge/blob/2b4d7a0f69e68d60cb0f35f09c9bac837d66acdc/khipu-r2/card/README.md)
 
-This model is part of the SZL Holdings estate: an AI research and product portfolio where every claim carries a receipt. Measured results for this artifact live on the public receipts chain — we publish numbers only where a signed receipt backs them.
+Provider compatibility support [requested on 4 October 2026](https://huggingface.co/spaces/huggingface/InferenceSupport/discussions/12786). No provider was listed in the dated Hub observation; adoption and use qualification remain unchanged.
 
-## Provenance
+## Before you use it
 
-- **Source:** [szl-holdings on GitHub](https://github.com/szl-holdings)
-- **Receipts chain:** [SZLHOLDINGS/frontier-54-runs](https://huggingface.co/datasets/SZLHOLDINGS/frontier-54-runs) — every claim on this card traces to a hash-chained receipt
-- **License:** Apache-2.0
+- Recorded abstention is 3/6, not a passing gate. Publication and autonomy eligibility remain false.
+- The adapter is the artifact of record for the figures; the merged checkpoint has no separate held-out qualification.
+- The recorded merge-time base reference is not an immutable identity. This experiment does not replace Khipu 1.5B.
 
+<details>
+<summary>Technical details and evidence</summary>
 
-## Why it matters (for investors)
+<!-- SZL-CARD-TECHNICAL:v1:START -->
+<!-- szl:artifact-identity-reconciled -->
+> **Artifact identity (noted 2026-09-30).** Besides the LoRA adapter, this repository's root carries a merged full-precision checkpoint (`model.safetensors` + `config.json`, loadable with `transformers`) produced by the receipted CPU merge of this adapter into its declared base (`merge_receipt.json`). The adapter remains the artifact of record for every figure on this card; the merged bytes carry no separate held-out receipt and add no claim. Metadata-only note.
+
+# KHIPU-R2
+
+**Research-only · historical abstention 3/6 · publication and autonomy gates closed**
+
+Adapters are on this repo. Abstain is MEASURED 3/6, not a pass.
+That statement describes the dated owner-run records below, rather than
+a new evaluation or current model qualification. This is a separate
+abstention-retraining SKU. Not a replacement for `SZL-Khipu-1.5B`.
+
+Card and metadata review snapshot: [9fc2f7bebeaf4b3d6d26f7a2a1788a27f8c9ed52](https://huggingface.co/SZLHOLDINGS/KHIPU-R2/tree/9fc2f7bebeaf4b3d6d26f7a2a1788a27f8c9ed52).
+No weights were downloaded, no model was loaded, and no evaluation or
+signature verification was rerun in this review.
+
+## Distributed forms
+
+| Form | Files | Scope |
+|---|---|---|
+| QLoRA adapter | `adapter_model.safetensors`, `adapter_config.json` | The PEFT example below explicitly selects this adapter form. |
+| Separate fp32 merged checkpoint | Root `model.safetensors`, `config.json`, `merge_receipt.json` | A distinct runtime form; selecting the adapter does not load this merged checkpoint. |
+
+Current artifact bytes and their equality to historical evaluated bytes
+were not independently rehashed. The merge receipt's base revision is
+`main@merge-time`, which is not an immutable base identity.
+
+## Dated evaluation records
+
+The [2026-08-28 owner-run job record](https://huggingface.co/SZLHOLDINGS/KHIPU-R2/blob/9fc2f7bebeaf4b3d6d26f7a2a1788a27f8c9ed52/eval_measured.json)
+reports in-process Unsloth generation at temperature 0 with scoring ported
+from `eval_khipu.py`. It reports `held_out_in_gradients: false`.
+
+| Metric | Historical result | Limit |
+|---|---|---|
+| plan-valid | **11 / 11** | Small owner-run synthetic protocol |
+| grounding (`eval.jsonl` navigate) | **5 / 5** | Five navigation cases |
+| abstain (`adversarial.jsonl`) | **3 / 6** | Visible release blocker; not a pass |
+| hallucinated citations | **0** | These cases only |
+
+The [2026-09-13 corrected-harness CPU re-verification](https://huggingface.co/SZLHOLDINGS/KHIPU-R2/blob/9fc2f7bebeaf4b3d6d26f7a2a1788a27f8c9ed52/eval_verified_2026-09-13.json)
+reports **11/11 plan-valid, 5/5 grounding, and 3/6 abstention** on rebuilt
+fp16 merges and the published fp32 merge. The owner fixed a decoding
+harness that returned prompt characters instead of generated output;
+**all prior fp16 scores produced by that buggy harness are void**.
+The corrected runs are separate owner records and do not promote the model.
+
+No signed R2 eval receipt in this atelier. The linked owner-run records
+are not an independent evaluation or public leaderboard. GPU **UNAVAILABLE**
+describes the CPU-only re-verification record and the earlier card state;
+no current hardware availability was tested. Publication and autonomy
+eligibility remain **false**.
+
+The original Khipu **2/6** abstention record and R2's **3/6** record remain
+separate. No broad quality score or general safety guarantee follows.
+
+## Historical training
+
+The prior card and [training receipt](https://huggingface.co/SZLHOLDINGS/KHIPU-R2/blob/9fc2f7bebeaf4b3d6d26f7a2a1788a27f8c9ed52/training_receipt.json)
+describe QLoRA r=32, α=64, seed 11, learning rate 2e-4 and 45 epochs,
+on 15 navigation rows plus 8 abstention rows oversampled four times.
+The reported train loss **0.017188…** is a training metric, not evaluation.
+The historical adapter digest is
+`e44d53f29f2d443598e06d6c0441557fd3a5010888c7aa97b56ec3c0e050d349`;
+it was not recomputed here. The earlier card records successful job
+`6a91bf11984507d9db4ea104` and prior error `6a91ba2c45686a1580c12020`
+(Trackio 404). This review did not query those jobs or rerun training.
+
+## Adapter usage
+
+This example is **untested in this review**. An owner-verified immutable
+base revision is required; none is invented here. The blank base revision
+fails before imports or remote loading. The adapter repository is pinned
+to the reviewed documentation and metadata snapshot; this is not an
+evaluation binding or release approval.
+
+```python
+import re
+
+BASE_REVISION = ""  # Supply an owner-verified immutable base commit.
+if not re.fullmatch(r"[0-9a-f]{40}", BASE_REVISION):
+    raise ValueError("An owner-verified immutable base revision is required")
+
+from peft import PeftModel
+from transformers import AutoModelForCausalLM, AutoTokenizer
+
+base_id = "Qwen/Qwen2.5-1.5B-Instruct"
+adapter_id = "SZLHOLDINGS/KHIPU-R2"
+adapter_revision = "9fc2f7bebeaf4b3d6d26f7a2a1788a27f8c9ed52"
+tok = AutoTokenizer.from_pretrained(base_id, revision=BASE_REVISION)
+base = AutoModelForCausalLM.from_pretrained(base_id, revision=BASE_REVISION)
+model = PeftModel.from_pretrained(base, adapter_id, revision=adapter_revision)
+```
+
+Outputs are proposals requiring external validation and approval. Lab load
+remains forbidden. [A11OY-MINI](https://huggingface.co/SZLHOLDINGS/A11OY-MINI)
+contains separately scoped legacy and R2 evidence and inherits no KHIPU-R2
+score or qualification.
+
+Apache-2.0 is declared in metadata. No standalone `LICENSE` is listed at
+the reviewed revision; artifact license coverage was not independently
+verified. A license addition requires source-owner review of that coverage.
+
+Canonical card authoring source: [khipu-r2/card/README.md](https://github.com/szl-holdings/szl-forge/blob/6f4ac90ff503265cec9c0436587f086e52d6124e/khipu-r2/card/README.md).
+Doctrine v11 LOCKED 749/14/163. Λ = Conjecture 1, advisory, never a theorem.
+
+<!-- SZL-CARD-TECHNICAL:v1:END -->
+</details>
+
+<!-- SZL-NATIVE-ARTWORK:v1 -->
+SZL Orbit artwork: [source](https://github.com/szl-holdings/szl-brand/blob/27d12e77fc0f9f1a0e5fae8b34adf2380d51d070/kit/logos/orbit-v2/suite/szl-icon-32.svg) · [CC BY 4.0](https://creativecommons.org/licenses/by/4.0/). Software and artifact licensing remain declared above.
+<!-- /SZL-NATIVE-ARTWORK:v1 -->
 
-SZL Holdings builds receipt-backed AI: measured honesty, a machine-checked constitution, and a public hash-chained evidence chain. This artifact is one piece of that estate.
 
 ## The estate
 
@@ -36,9 +175,6 @@ SZL Holdings builds receipt-backed AI: measured honesty, a machine-checked const
 |---|---|
 | Company | [szlholdings.com](https://szlholdings.com) |
 | Sponsors | [Become a sponsor](https://szlholdings.com/sponsors.html) |
+| GitHub | [szl-holdings](https://github.com/szl-holdings) |
+| Receipts chain | [frontier-54-runs](https://huggingface.co/datasets/SZLHOLDINGS/frontier-54-runs) |
 | Live dashboard | [SI command center](https://szlholdings-szlholdings-si.hf.space) |
-| Living anatomy | [Anatomy](https://szlholdings-anatomy.hf.space) |
-| Autonomy ladder | [The 0.3% partition](https://github.com/szl-holdings/szl-gpu-bridge/blob/main/docs/AUTONOMY_LADDER.md) |
-| Training curriculum | [Ouroboros](https://github.com/szl-holdings/szl-gpu-bridge/blob/main/docs/OUROBOROS_CURRICULUM.md) |
-
-*This card is generated by [tools/hf_cards](https://github.com/szl-holdings/szl-gpu-bridge/tree/main/tools/hf_cards) — links verified at build time.*