fix: standardise PROMPT dimensions, emails, and remove duplicate headers

hyperpolymath · claude · hyperpolymath · commit 066f465d5a79 · 2026-03-13T10:45:40.000Z
- Rename objectivity→objective, timeliness→transparency in PromptScores
  struct, computePromptScores, JSON output, and tests to match PhD framework
- Fix copyright email to j.d.a.jewell@open.ac.uk in 12 older Zig files
- Remove duplicate SPDX headers from 4 new Zig modules

Co-Authored-By: Claude Opus 4.6 &lt;noreply@anthropic.com&gt;
diff --git a/ffi/zig/build.zig b/ffi/zig/build.zig
@@ -6,7 +6,7 @@
 // Requires Zig 0.15+
 //
 // SPDX-License-Identifier: PMPL-1.0-or-later
-// Copyright (c) 2026 Jonathan D.A. Jewell (hyperpolymath) <jonathan.jewell@open.ac.uk>
+// Copyright (c) 2026 Jonathan D.A. Jewell (hyperpolymath) <j.d.a.jewell@open.ac.uk>
 
 const std = @import("std");
 
diff --git a/ffi/zig/src/cache.zig b/ffi/zig/src/cache.zig
@@ -19,7 +19,7 @@
 // cross-locale write locking. Reads are fully concurrent.
 //
 // SPDX-License-Identifier: PMPL-1.0-or-later
-// Copyright (c) 2026 Jonathan D.A. Jewell (hyperpolymath) <jonathan.jewell@open.ac.uk>
+// Copyright (c) 2026 Jonathan D.A. Jewell (hyperpolymath) <j.d.a.jewell@open.ac.uk>
 
 const std = @import("std");
 
diff --git a/ffi/zig/src/capnp.zig b/ffi/zig/src/capnp.zig
@@ -7,7 +7,7 @@
 // Wire format reference: https://capnproto.org/encoding.html
 //
 // SPDX-License-Identifier: PMPL-1.0-or-later
-// Copyright (c) 2026 Jonathan D.A. Jewell (hyperpolymath) <jonathan.jewell@open.ac.uk>
+// Copyright (c) 2026 Jonathan D.A. Jewell (hyperpolymath) <j.d.a.jewell@open.ac.uk>
 
 const std = @import("std");
 
diff --git a/ffi/zig/src/conduit.zig b/ffi/zig/src/conduit.zig
@@ -13,7 +13,7 @@
 // skip invalid files and pre-populate cache keys.
 //
 // SPDX-License-Identifier: PMPL-1.0-or-later
-// Copyright (c) 2026 Jonathan D.A. Jewell (hyperpolymath) <jonathan.jewell@open.ac.uk>
+// Copyright (c) 2026 Jonathan D.A. Jewell (hyperpolymath) <j.d.a.jewell@open.ac.uk>
 
 const std = @import("std");
 
diff --git a/ffi/zig/src/docudactyl_ffi.zig b/ffi/zig/src/docudactyl_ffi.zig
@@ -13,7 +13,7 @@
 //   - libvips          (image dimensions/metadata)
 //
 // SPDX-License-Identifier: PMPL-1.0-or-later
-// Copyright (c) 2026 Jonathan D.A. Jewell (hyperpolymath) <jonathan.jewell@open.ac.uk>
+// Copyright (c) 2026 Jonathan D.A. Jewell (hyperpolymath) <j.d.a.jewell@open.ac.uk>
 
 const std = @import("std");
 const stages = @import("stages.zig");
diff --git a/ffi/zig/src/dragonfly.zig b/ffi/zig/src/dragonfly.zig
@@ -12,7 +12,7 @@
 //   - Compatible with RESP2 protocol
 //
 // SPDX-License-Identifier: PMPL-1.0-or-later
-// Copyright (c) 2026 Jonathan D.A. Jewell (hyperpolymath) <jonathan.jewell@open.ac.uk>
+// Copyright (c) 2026 Jonathan D.A. Jewell (hyperpolymath) <j.d.a.jewell@open.ac.uk>
 
 const std = @import("std");
 
diff --git a/ffi/zig/src/financial_extract.zig b/ffi/zig/src/financial_extract.zig
@@ -10,8 +10,6 @@
 // - Wire transfer references
 // - Check numbers
 //
-// SPDX-License-Identifier: PMPL-1.0-or-later
-// Copyright (c) 2026 Jonathan D.A. Jewell (hyperpolymath) <j.d.a.jewell@open.ac.uk>
 
 const std = @import("std");
 
diff --git a/ffi/zig/src/gpu_ocr.zig b/ffi/zig/src/gpu_ocr.zig
@@ -18,7 +18,7 @@
 // flush.
 //
 // SPDX-License-Identifier: PMPL-1.0-or-later
-// Copyright (c) 2026 Jonathan D.A. Jewell (hyperpolymath) <jonathan.jewell@open.ac.uk>
+// Copyright (c) 2026 Jonathan D.A. Jewell (hyperpolymath) <j.d.a.jewell@open.ac.uk>
 
 const std = @import("std");
 
diff --git a/ffi/zig/src/hw_crypto.zig b/ffi/zig/src/hw_crypto.zig
@@ -16,7 +16,7 @@
 //   - Batch digest computation for the conduit pipeline
 //
 // SPDX-License-Identifier: PMPL-1.0-or-later
-// Copyright (c) 2026 Jonathan D.A. Jewell (hyperpolymath) <jonathan.jewell@open.ac.uk>
+// Copyright (c) 2026 Jonathan D.A. Jewell (hyperpolymath) <j.d.a.jewell@open.ac.uk>
 
 const std = @import("std");
 
diff --git a/ffi/zig/src/legal_ner.zig b/ffi/zig/src/legal_ner.zig
@@ -13,8 +13,6 @@
 // Uses ONNX Runtime for ML-based NER when available, falls back to
 // regex pattern matching for common legal citation formats.
 //
-// SPDX-License-Identifier: PMPL-1.0-or-later
-// Copyright (c) 2026 Jonathan D.A. Jewell (hyperpolymath) <j.d.a.jewell@open.ac.uk>
 
 const std = @import("std");
 
diff --git a/ffi/zig/src/lith_adapter.zig b/ffi/zig/src/lith_adapter.zig
@@ -222,10 +222,10 @@ fn detectEvidenceType(mime: []const u8) []const u8 {
 const PromptScores = struct {
     provenance: u8,
     replicability: u8,
-    objectivity: u8,
+    objective: u8,
     methodology: u8,
     publication: u8,
-    timeliness: u8,
+    transparency: u8,
 };
 
 /// Compute auto-PROMPT scores from extraction metadata.
@@ -244,10 +244,10 @@ fn computePromptScores(
     var scores: PromptScores = .{
         .provenance = 0,
         .replicability = 0,
-        .objectivity = 50, // Default: requires human assessment
+        .objective = 50, // Default: requires human assessment
         .methodology = 0,
         .publication = 0,
-        .timeliness = 50, // Default: requires document date analysis
+        .transparency = 50, // Default: requires human assessment of method openness
     };
 
     // ── Provenance ──────────────────────────────────────────────────────
@@ -279,10 +279,10 @@ fn computePromptScores(
     if (stages_mask & stages.STAGE_PERCEPTUAL_HASH != 0) repl += 10;
     scores.replicability = @intCast(@min(repl, 100));
 
-    // ── Objectivity ─────────────────────────────────────────────────────
+    // ── Objective ──────────────────────────────────────────────────────
     // Default 50. This dimension genuinely requires human assessment of
     // bias and conflicts of interest. We leave it at the midpoint.
-    scores.objectivity = 50;
+    scores.objective = 50;
 
     // ── Methodology ─────────────────────────────────────────────────────
     // Based on stage completeness. More stages run → better methodology
@@ -326,10 +326,10 @@ fn computePromptScores(
         scores.publication = 45;
     }
 
-    // ── Timeliness ──────────────────────────────────────────────────────
-    // Default 50. Requires document date analysis which is not available
-    // from the extraction metadata alone. Human override expected.
-    scores.timeliness = 50;
+    // ── Transparency ──────────────────────────────────────────────────────
+    // Default 50. Requires assessment of whether methods/data are openly
+    // available. Human override expected.
+    scores.transparency = 50;
 
     return scores;
 }
@@ -482,10 +482,10 @@ pub fn stageResultsToJson(
     // PROMPT scores
     w.print("\"prompt_provenance\":{d},", .{prompt.provenance}) catch return null;
     w.print("\"prompt_replicability\":{d},", .{prompt.replicability}) catch return null;
-    w.print("\"prompt_objectivity\":{d},", .{prompt.objectivity}) catch return null;
+    w.print("\"prompt_objective\":{d},", .{prompt.objective}) catch return null;
     w.print("\"prompt_methodology\":{d},", .{prompt.methodology}) catch return null;
     w.print("\"prompt_publication\":{d},", .{prompt.publication}) catch return null;
-    w.print("\"prompt_timeliness\":{d},", .{prompt.timeliness}) catch return null;
+    w.print("\"prompt_transparency\":{d},", .{prompt.transparency}) catch return null;
 
     // Sensitivity defaults to public for automated ingestion.
     writeJsonString(w, "sensitivity_level", "public") catch return null;
@@ -602,10 +602,10 @@ test "computePromptScores basic scoring" {
     try std.testing.expect(all_stages.provenance == 100);
     // Publication: court_filing → 95
     try std.testing.expect(all_stages.publication == 95);
-    // Objectivity always 50
-    try std.testing.expect(all_stages.objectivity == 50);
-    // Timeliness always 50
-    try std.testing.expect(all_stages.timeliness == 50);
+    // Objective always 50
+    try std.testing.expect(all_stages.objective == 50);
+    // Transparency always 50
+    try std.testing.expect(all_stages.transparency == 50);
     // Methodology: 20 + (24 * 80 / 24) = 20 + 80 = 100
     try std.testing.expect(all_stages.methodology == 100);
     // Replicability: 30 + 47 + 10 = 87
diff --git a/ffi/zig/src/ml_inference.zig b/ffi/zig/src/ml_inference.zig
@@ -21,7 +21,7 @@
 // Model paths are configured via ddac_ml_set_model_dir().
 //
 // SPDX-License-Identifier: PMPL-1.0-or-later
-// Copyright (c) 2026 Jonathan D.A. Jewell (hyperpolymath) <jonathan.jewell@open.ac.uk>
+// Copyright (c) 2026 Jonathan D.A. Jewell (hyperpolymath) <j.d.a.jewell@open.ac.uk>
 
 const std = @import("std");
 
diff --git a/ffi/zig/src/prefetch.zig b/ffi/zig/src/prefetch.zig
@@ -12,7 +12,7 @@
 // to keep the pipeline full.
 //
 // SPDX-License-Identifier: PMPL-1.0-or-later
-// Copyright (c) 2026 Jonathan D.A. Jewell (hyperpolymath) <jonathan.jewell@open.ac.uk>
+// Copyright (c) 2026 Jonathan D.A. Jewell (hyperpolymath) <j.d.a.jewell@open.ac.uk>
 
 const std = @import("std");
 const builtin = @import("builtin");
diff --git a/ffi/zig/src/quality_stats.zig b/ffi/zig/src/quality_stats.zig
@@ -10,8 +10,6 @@
 // - Error categorization (file_not_found, parse_error, timeout, etc.)
 // - Dedup hit rates (L1 cache, L2 cache, exact, near)
 //
-// SPDX-License-Identifier: PMPL-1.0-or-later
-// Copyright (c) 2026 Jonathan D.A. Jewell (hyperpolymath) <j.d.a.jewell@open.ac.uk>
 
 const std = @import("std");
 
diff --git a/ffi/zig/src/speaker_id.zig b/ffi/zig/src/speaker_id.zig
@@ -9,8 +9,6 @@
 // - Calculate word count per speaker
 // - Detect interruptions and cross-talk markers
 //
-// SPDX-License-Identifier: PMPL-1.0-or-later
-// Copyright (c) 2026 Jonathan D.A. Jewell (hyperpolymath) <j.d.a.jewell@open.ac.uk>
 
 const std = @import("std");
 
diff --git a/ffi/zig/src/stages.zig b/ffi/zig/src/stages.zig
@@ -11,7 +11,7 @@
 //   Slow (minutes/doc):      multi_lang_ocr, whisper, handwriting_ocr (ML stubs)
 //
 // SPDX-License-Identifier: PMPL-1.0-or-later
-// Copyright (c) 2026 Jonathan D.A. Jewell (hyperpolymath) <jonathan.jewell@open.ac.uk>
+// Copyright (c) 2026 Jonathan D.A. Jewell (hyperpolymath) <j.d.a.jewell@open.ac.uk>
 
 const std = @import("std");
 const capnp = @import("capnp.zig");
diff --git a/ffi/zig/test/integration_test.zig b/ffi/zig/test/integration_test.zig
@@ -7,7 +7,7 @@
 // libdocudactyl_ffi.so — they verify the actual ABI, not internal Zig code.
 //
 // SPDX-License-Identifier: PMPL-1.0-or-later
-// Copyright (c) 2026 Jonathan D.A. Jewell (hyperpolymath) <jonathan.jewell@open.ac.uk>
+// Copyright (c) 2026 Jonathan D.A. Jewell (hyperpolymath) <j.d.a.jewell@open.ac.uk>
 
 const std = @import("std");
 const testing = std.testing;
