etch-record 0.7.0__tar.gz → 0.8.0__tar.gz

{etch_record-0.7.0 → etch_record-0.8.0}/CHANGELOG.md

@@ -3,6 +3,38 @@
 All notable changes to `etch-record` (the CLI helper for the Etch signed
 audit chain).
 
+## v0.8.0 — 2026-08-02
+
+Wave 4 #15 8-category drift engine. Extends the governance object
+with 3 new optional fields (mission / terminology / context) so the
+server can populate an 8-dimension projection index. Drift detection
+runs offline via `etch-chain-verify` (added server-side).
+
+Server-side dependency: etch commit adding the multi-dim projection
+(this release cycle's server change).
+
+### Added
+
+- `--mission <string>` — mission statement (e.g. "customer KYC
+  compliance decisions"). Hashed server-side.
+- `--terminology <t1,t2,...>` — comma-separated key terms. Set-hashed
+  server-side.
+- `--context-file <path>` — JSON object describing operating context.
+  Any shape accepted; canonical-json-hashed server-side.
+
+Any of the new flags (alone or with legacy governance flags) triggers
+the governance sub-record call and populates the multi-dim index.
+
+### Positioning
+
+Wave 4 #15 is the largest single feature in the boundary plan (10
+dev-days). Ships the full OHRP v2.0 8-category surface:
+mission / assumption / confidence / evidence / scope / terminology /
+authority / context. No observability vendor claims this surface.
+
+Content angle for marketing: "8 drift dimensions with independent
+comparators, per-decision on-chain evidence, offline verifier."
+
 ## v0.7.0 — 2026-08-02
 
 Wave 2 #10. Adds three flags for recording an explicit halt event

{etch_record-0.7.0 → etch_record-0.8.0}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: etch-record
-Version: 0.7.0
+Version: 0.8.0
 Summary: CLI helper: sign any event into your Etch audit chain from the command line.
 Author: Saravanan Jaichandaran
 License: MIT

{etch_record-0.7.0 → etch_record-0.8.0}/pyproject.toml

@@ -4,7 +4,7 @@ build-backend = "hatchling.build"
 
 [project]
 name = "etch-record"
-version = "0.7.0"
+version = "0.8.0"
 description = "CLI helper: sign any event into your Etch audit chain from the command line."
 readme = "README.md"
 requires-python = ">=3.10"

{etch_record-0.7.0 → etch_record-0.8.0}/src/etch_record/__init__.py

@@ -1,3 +1,3 @@
 """etch-record: CLI helper for signing arbitrary events into your Etch chain."""
 
-__version__ = "0.7.0"
+__version__ = "0.8.0"

{etch_record-0.7.0 → etch_record-0.8.0}/src/etch_record/cli.py

@@ -424,6 +424,39 @@ def _maybe_warn_large_arg(name: str, value: str) -> None:
     ),
 )
 # ---------------------------------------------------------------------------
+# Wave 4 #15 (2026-08-02) — 8-category governance schema extension.
+# Adds mission / terminology / context fields. Extraction is server-
+# side; drift detection runs via etch-chain-verify's dimensional
+# check. Any of these flags being set (alone or with the legacy
+# governance fields) triggers the second call and populates the
+# multi-dim projection index.
+# ---------------------------------------------------------------------------
+@click.option(
+    "--mission", "mission", type=str, default=None,
+    help=(
+        "Wave 4 #15 governance: mission statement string (e.g. "
+        "'customer KYC compliance decisions'). Hashed server-side "
+        "for drift detection."
+    ),
+)
+@click.option(
+    "--terminology", "terminology_raw", type=str, default=None,
+    help=(
+        "Wave 4 #15 governance: comma-separated key terms (e.g. "
+        "'KYC,PII,customer identity'). Set-hashed server-side."
+    ),
+)
+@click.option(
+    "--context-file", "context_file",
+    type=click.Path(exists=True, dir_okay=False, path_type=Path),
+    default=None,
+    help=(
+        "Wave 4 #15 governance: JSON object describing the operating "
+        "context (e.g. {model, prompt_hash, policy_context}). Any "
+        "shape accepted; canonical-json-hashed server-side."
+    ),
+)
+# ---------------------------------------------------------------------------
 # Wave 1 #2 (2026-08-01) — bounded authority receipts.
 # When --authority-privkey-file + --authority-id + --receipt-type are all
 # set, the CLI adds a THIRD call:
@@ -725,6 +758,9 @@ def main(
     uncertainty: str | None,
     uncertainty_file: Path | None,
     invalidation_file: Path | None,
+    mission: str | None,
+    terminology_raw: str | None,
+    context_file: Path | None,
     authority_privkey_file: Path | None,
     authority_id: str | None,
     authority_scope: str,
@@ -860,6 +896,9 @@ def main(
         uncertainty=uncertainty,
         uncertainty_file=uncertainty_file,
         invalidation_file=invalidation_file,
+        mission=mission,
+        terminology_raw=terminology_raw,
+        context_file=context_file,
     )
     if governance is not None:
         try:
@@ -1060,12 +1099,20 @@ def _assemble_governance_from_flags(
     uncertainty: str | None,
     uncertainty_file: Path | None,
     invalidation_file: Path | None,
+    mission: str | None = None,
+    terminology_raw: str | None = None,
+    context_file: Path | None = None,
 ) -> dict | None:
     """Compose the governance object from CLI flags, or return None if
-    none of them are set (signals: skip the second API call)."""
+    none of them are set (signals: skip the second API call).
+
+    Wave 4 #15 additions: `mission` string, `terminology` list,
+    `context` dict. Any of these plus the legacy 5 fields triggers
+    the second call."""
     if not any((
         policy_hash, authority_file, assumptions_file,
         uncertainty, uncertainty_file, invalidation_file,
+        mission, terminology_raw, context_file,
     )):
         return None
 
@@ -1094,6 +1141,14 @@ def _assemble_governance_from_flags(
         gov["invalidation_conditions"] = _read_json_list(
             invalidation_file, "--invalidation-file",
         )
+    if mission:
+        gov["mission"] = mission
+    if terminology_raw:
+        gov["terminology"] = [
+            t.strip() for t in terminology_raw.split(",") if t.strip()
+        ]
+    if context_file is not None:
+        gov["context"] = _read_json_object(context_file, "--context-file")
     return gov