leptris 1.9.345.0-arm-linux → 1.9.345.1-arm-linux

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
checksums.yaml CHANGED
@@ -1,7 +1,7 @@
1
1
  ---
2
2
  SHA256:
3
- metadata.gz: '05385e8728b63b53380abf43ef8d5eca5cc9f16e6fc4f78099ddc4b5f548c7c2'
4
- data.tar.gz: 2f4308d6e66ef78401a7553882fb569682b758658d8740e92ee06d75177be673
3
+ metadata.gz: 7336caa042d95a758103a546b9eaedae0d37795a8ab1cd670eee778b5a98aff4
4
+ data.tar.gz: 8759521fec72ecffcd1337aa530c7bf1afd0b21108c969bdf7a8b8dec8bf99fc
5
5
  SHA512:
6
- metadata.gz: 157712c7567a6b6f95e7ea2b7e1b41c21d8217c3c90a81d520031c745403703e36e7e980008f3cf95ad9102c40f2ccfdca4d987a90c3e41cae0c2e275a8a5825
7
- data.tar.gz: 63e2a81e06dffb50cdcf17b97e2c891fed44362a5cb2c92f35975627172a06f3fea1b63c88290d801e6273ea90aeb83c1e149dc29495b49e928073250dbbe9a9
6
+ metadata.gz: ef5c3a26a396e8100a55aa410c973decd6cbdc6a719275554614f2afc2ea70b14f5eddce6c40e3c4aae91c66e2df3f2223f796afcc1dfddf249888f92a84f860
7
+ data.tar.gz: 04b4f67f73bfbc31a57b63af7d6ffb469cf0416f946cad333fefcb33e4d461c099a7ebcacf2de5ad83451156a17b87195e51719c1f5c1f1069f086a2c2bff051
data/CHANGELOG.md CHANGED
@@ -1,3 +1,21 @@
1
+ ## [1.9.345.1] - 2026-10-12
2
+
3
+ ### Added
4
+
5
+ - **TODO.final/04 gates — shipped-artifact codesign + artifact/
6
+ version sync (#388)**: `rake audit:artifacts` (darwin) fails on
7
+ an unsigned/tampered vendored macOS artifact (`codesign
8
+ --verify --strict` against the CURRENT bytes) and on
9
+ engine-version drift (the vendored library's
10
+ `leptris_version()` must equal the Rakefile pin — a half-bumped
11
+ lockstep state can no longer package; the drift path proved
12
+ itself live during development). The darwin platform-gem builds
13
+ ad-hoc sign as the last pre-package step (audit:artifacts
14
+ between compile and pack). Negative proof in
15
+ spec/audit_codesign_spec.rb: flipped-byte and
16
+ stripped-signature copies fail the strict gate; the version
17
+ gate flags drift and accepts the pin.
18
+
1
19
  ## [1.9.345.0] - 2026-10-12
2
20
 
3
21
  ### Fixed — engine sync (libleptris 1.9.345)
data/Rakefile CHANGED
@@ -404,6 +404,45 @@ namespace :audit do
404
404
  end
405
405
  end
406
406
 
407
+ # TODO.final/04: shipped-macOS-artifact gates — (a) the
408
+ # embedded signature verifies strictly against the CURRENT
409
+ # bytes (a copy/strip/recompress in packaging invalidates the
410
+ # linker's ad-hoc signature and this fails instead of a user
411
+ # machine's dlopen), (b) the vendored library's
412
+ # leptris_version() equals the gem's engine pin (a half-bumped
413
+ # lockstep state can no longer package). Negative proof lives
414
+ # in spec/audit_codesign_spec.rb.
415
+ desc "Fail on unsigned/tampered macOS artifacts or engine-version drift"
416
+ task :artifacts do
417
+ unless RUBY_PLATFORM =~ /darwin/
418
+ puts "audit:artifacts: skipped off-darwin (codesign gates " \
419
+ "the macOS packaging legs)"
420
+ next
421
+ end
422
+ abort "audit:artifacts: codesign unavailable" \
423
+ unless AuditArtifacts.codesign_available?
424
+ libs = AuditArtifacts.darwin_artifacts.select { |f| File.file?(f) }
425
+ abort "audit:artifacts: no vendored macOS artifacts found " \
426
+ "— run rake compile" if libs.empty?
427
+ libs.each do |lib|
428
+ unless AuditArtifacts.signature_ok?(lib)
429
+ abort "audit:artifacts: signature invalid or missing on " \
430
+ "#{lib} — ad-hoc sign before packaging"
431
+ end
432
+ end
433
+ main_lib = libs.find { |f| f.end_with?("libleptris.dylib") }
434
+ pinned = ENV.fetch("LIBLEPTRIS_VERSION", LIBLEPTRIS_VERSION)
435
+ unless AuditArtifacts.version_synced?(
436
+ main_lib, File.dirname(main_lib), pinned)
437
+ vendored = AuditArtifacts.vendored_version(
438
+ main_lib, File.dirname(main_lib))
439
+ abort "audit:artifacts: engine-version drift — vendored " \
440
+ "#{vendored.inspect} != pin #{pinned.inspect}"
441
+ end
442
+ puts "audit:artifacts: #{libs.size} macOS artifacts verify " \
443
+ "strictly and engine-synced (#{pinned})"
444
+ end
445
+
407
446
  # Packaging doctrine (#271): every BUILT gem carries the engine
408
447
  # source (vendor-src/libleptris build inputs) and the ext sources;
409
448
  # platform gems additionally carry the prebuilt libraries and must
@@ -453,6 +492,8 @@ namespace :audit do
453
492
  end
454
493
 
455
494
  require "rubygems/package_task"
495
+ require_relative "rakelib/audit_artifacts"
496
+ require "open3"
456
497
 
457
498
  desc "Build the pure-Ruby gem"
458
499
  task "gem:native:any" do
@@ -499,7 +540,16 @@ platforms = [
499
540
  platforms.each do |platform|
500
541
  desc "Build pre-compiled gem for the #{platform} platform"
501
542
  task "gem:native:#{platform}" do
502
- sh "rake compile platform:#{platform} gem"
543
+ if platform.end_with?("darwin")
544
+ # TODO.final/04: ad-hoc sign as the LAST step before the
545
+ # packager touches nothing else — the signature must cover
546
+ # the final bytes, and audit:artifacts verifies strictly.
547
+ sh "rake compile platform:#{platform}"
548
+ sh "rake audit:artifacts"
549
+ sh "rake platform:#{platform} gem"
550
+ else
551
+ sh "rake compile platform:#{platform} gem"
552
+ end
503
553
  end
504
554
 
505
555
  desc "Define the gem task to build on the #{platform} platform (binary gem)"
@@ -0,0 +1,51 @@
1
+ # 04 — native-bundle codesign (macOS 14.1+) + artifact/version sync
2
+
3
+ Status: OPEN. Owner: this binding's owning session. Filed from the
4
+ engine-side investigation 2026-10-06 (leptris session); applies to
5
+ every `*-ruby` binding that ships prebuilt native artifacts.
6
+
7
+ ## Problem
8
+
9
+ macOS 14.1+ on Apple Silicon kills unsigned or signature-invalidated
10
+ arm64 Mach-O libraries at load (`killed: 9`). CI-built arm64 dylibs
11
+ are linker-ad-hoc-signed, but any packaging step that COPIES or
12
+ re-compresses the artifact can strip/invalidate the ad-hoc
13
+ signature, and a prebuilt gem that installs an unsigned dylib then
14
+ fails at `dlopen` on user machines. Nothing in the current
15
+ packaging or audit path checks this.
16
+
17
+ ## Work items
18
+
19
+ 1. **Ad-hoc codesign at package time.** For every vendored macOS
20
+ arm64 (and universal) library the gem ships:
21
+ `codesign --force --sign - <lib>` as the LAST packaging step
22
+ (after any copy/strip/recompress), so the signature always
23
+ covers the final bytes. No Apple Developer identity is needed —
24
+ ad-hoc is sufficient for load validation.
25
+ 2. **Verify in the audit gate.** Extend the existing
26
+ `rake audit` (the vendor-artifact validator: rake compile +
27
+ audit:symbols + CI) with `codesign --verify --strict` per
28
+ macOS library, so a tampered or unsigned artifact FAILS the
29
+ gate instead of a user machine.
30
+ 3. **Artifact/version sync.** At package time (and in audit),
31
+ assert the vendored library's engine version —
32
+ `<engine>_version()` / the dylib's reported version — equals
33
+ the gem's pinned engine version. This closes the manual-pin
34
+ loop: a half-bumped lockstep release can no longer package.
35
+
36
+ ## Acceptance
37
+
38
+ - Packaging workflow signs every macOS library it produces.
39
+ - Audit fails on (a) an unsigned/tampered macOS library, (b) a
40
+ vendored library whose version != the gem's engine pin.
41
+ - A deliberate negative test (unsigned copy) proves both gates.
42
+
43
+ ## Notes
44
+
45
+ - Vendored artifacts are swapped by CI ONLY (the standing law):
46
+ these gates run inside the packaging/audit workflows, not as
47
+ local shortcuts.
48
+ - Source-compiled installs are unaffected: clang ad-hoc signs the
49
+ freshly built extension on the user's machine.
50
+ - Engine-side context: leptris/leptris session notes 2026-10-06;
51
+ the item is engine-family-wide (l/t/y bindings carry it too).
@@ -1,5 +1,5 @@
1
1
  # frozen_string_literal: true
2
2
 
3
3
  module Leptris
4
- VERSION = "1.9.345.0"
4
+ VERSION = "1.9.345.1"
5
5
  end
@@ -0,0 +1,59 @@
1
+ # frozen_string_literal: true
2
+
3
+ require "open3"
4
+ require "rbconfig"
5
+
6
+ # TODO.final/04: the shipped-artifact gates. Required by
7
+ # Rakefile's audit:artifacts task and by the negative-proof specs
8
+ # (spec/audit_codesign_spec.rb). Not shipped in the gem — this is
9
+ # packaging/CI tooling.
10
+ module AuditArtifacts
11
+ module_function
12
+
13
+ # Every vendored macOS artifact the gem ships (the darwin
14
+ # packaging set, wherever it currently lives).
15
+ def darwin_artifacts
16
+ %w[
17
+ lib/libleptris.dylib
18
+ lib/libutf8proc.3.dylib
19
+ lib/leptris/xml/native.bundle
20
+ ] + Dir.glob("lib/leptris/vendor/*-darwin/**/*.{dylib,bundle}")
21
+ end
22
+
23
+ # (a) tamper gate: --strict verifies the embedded signature
24
+ # covers the CURRENT bytes; a copy/strip/recompress invalidates
25
+ # it and this fails instead of a user machine's dlopen.
26
+ def signature_ok?(path)
27
+ system("codesign", "--verify", "--strict", path,
28
+ out: File::NULL, err: File::NULL)
29
+ end
30
+
31
+ def codesign_available?
32
+ # codesign has no --version; `which`-style probe via -h
33
+ # (exit 1 with usage output still proves the binary exists —
34
+ # ENOENT returns nil).
35
+ !system("codesign", "-h", out: File::NULL, err: File::NULL).nil?
36
+ end
37
+
38
+ # (b) artifact/version sync: the vendored library's own
39
+ # leptris_version() must equal the Rakefile's engine pin — a
40
+ # half-bumped lockstep state can no longer package. Runs the
41
+ # vendored library in an isolated interpreter (no gem load).
42
+ def vendored_version(lib, lib_dir)
43
+ env = { "LEPTRIS_LIB_PATH" => lib,
44
+ "DYLD_FALLBACK_LIBRARY_PATH" => lib_dir }
45
+ out, status = Open3.capture2e(env, RbConfig.ruby,
46
+ "-rffi", "-e",
47
+ 'require "ffi"; ' \
48
+ 'module V; extend FFI::Library; ' \
49
+ 'ffi_lib ENV["LEPTRIS_LIB_PATH"]; ' \
50
+ 'attach_function :v, :leptris_version, [], :string; end; ' \
51
+ 'print V.v')
52
+ status.success? ? out.strip : nil
53
+ end
54
+
55
+ def version_synced?(lib, lib_dir, pinned)
56
+ vendored = vendored_version(lib, lib_dir)
57
+ !vendored.nil? && vendored == pinned
58
+ end
59
+ end
metadata CHANGED
@@ -1,7 +1,7 @@
1
1
  --- !ruby/object:Gem::Specification
2
2
  name: leptris
3
3
  version: !ruby/object:Gem::Version
4
- version: 1.9.345.0
4
+ version: 1.9.345.1
5
5
  platform: arm-linux
6
6
  authors:
7
7
  - Ribose Inc.
@@ -69,6 +69,7 @@ files:
69
69
  - LICENSE.md
70
70
  - README.adoc
71
71
  - Rakefile
72
+ - TODO.final/04-native-bundle-codesign-artifact-sync.md
72
73
  - TODO.perf/01-ext-accelerated-default-reads.md
73
74
  - TODO.perf/02-auto-enable-native-layer.md
74
75
  - TODO.perf/03-bulk-xpath-result-materialization.md
@@ -189,6 +190,7 @@ files:
189
190
  - lib/leptris/xml/xslt.rb
190
191
  - lib/libleptris.so
191
192
  - lib/libutf8proc.so.3
193
+ - rakelib/audit_artifacts.rb
192
194
  - scripts/gem_smoke.rb
193
195
  - vendor-src/README.md
194
196
  - vendor-src/libleptris/CHANGELOG.md