suma 0.5.43 → 0.5.45

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: b19a3323b2babf94e043a9d44b58552d30a8216edce9a7b9481d4038114b2483
4
- data.tar.gz: 56217001687acfb6b8aab49274e78dac63014336d42929f01f8ac007c387777d
3
+ metadata.gz: d82b5b4a9631ed6c3a33ff5f1289d5b573d4306875fab90e737c1fbc214f2431
4
+ data.tar.gz: 0c7e873e46b323a07b0499ea75c8d98f661147445c001d124c0e714f904543bb
5
5
  SHA512:
6
- metadata.gz: 5f5ce333acd1281bb2e708ee025649f448b210f1c0ec60a9c4856cb40a991a4ddc7c67b5d17bd5ece3faf00f98ce8421d4c5e585a1f179bae6c8f1a490516468
7
- data.tar.gz: c25d489df407bce0993264896ed6c4eb8673b141ed586cdc03df428abb8009334b5bfbbc692bafd5969916d84b8f6a6e00e5ad4b1b9c88b678df199ec66af09d
6
+ metadata.gz: 6e3e6fbf2e2b3692e4a0bf94d75ef9ee93cbdfd9052da7637145e3e642ecc34297780fe8c70af285d11eab1a979f9b2fae22f512614e65013bb18ae3e89a62fe
7
+ data.tar.gz: 211772fc4e783ba4735dd1df9f874a5222d0dfa315bd76d8836b8f8325a7b62ad6fe0f665806ac38d941c5abcc18720e9174d4486e08a1c89b12d47b1c53a929
data/CLAUDE.md CHANGED
@@ -156,3 +156,13 @@ The `compare` command uses an external `eengine` binary to diff two EXPRESS sche
156
156
  - Internal library code uses Ruby `autoload` (defined in the immediate parent namespace's file); no `require_relative`
157
157
  - No `send` to call private methods, no `instance_variable_set`/`get`, no `respond_to?` for type checking
158
158
  - Use `Utils.log` for user-facing output (writes to `$stderr`, prefix `[suma]`; `level: :debug` gated by `SUMA_DEBUG`)
159
+
160
+ ## Release integrity (fleet contracts) — learned 2026-11-16
161
+
162
+ These rules exist because 0.5.43 shipped with its schema templates calling `metanorma-plugin-lutaml`'s `formatted_hyperlinked_adoc_listing` without a gemspec declaration of that gem — paired with 0.7.69, Liquid rendered `nil` silently and every schema page lost its listing (issue suma#211; found by TRThurman, not by us).
163
+
164
+ 1. **Every cross-gem method the templates call is a declared gemspec dependency with an explicit floor.** A method that exists only in an unreleased sibling makes this gem uninstallable-with-prereleases and silently broken with released ones.
165
+ 2. **Renderer-affecting changes carry positive content assertions**: assert the built dummy collection's schema pages CONTAIN a listing (`<pre>` with `END_SCHEMA`) — never only absence-of-error.
166
+ 3. **Gemspec/floor bumps move only after CI proves them on figure-bearing corpora** (smol, part2). The dummy collection is the unit harness, not the integration surface: 0.7.71 passed it and FATALed smol's express-g staging.
167
+ 4. **Verifier checks rescue external-tool failures**: a datum that fails to parse (Expressir::Express::Error::SchemaParseFailure) is a finding counted under its cap, never a crash of the whole verify (0.5.44).
168
+ 5. **VERSIONING: the GHA release workflow owns it exclusively** (`release -f next_version=x.y.z`); never edit `version.rb` to bump a version.
@@ -227,11 +227,17 @@ module Suma
227
227
  def schema_remarks
228
228
  @schema_remarks ||= Dir.glob("#{@site_dir}/plain_schemas/**/*.exp")
229
229
  .filter_map do |exp|
230
- schema = Expressir::Express::Parser.from_file(exp).schemas.first
230
+ begin
231
+ schema = Expressir::Express::Parser.from_file(exp).schemas.first
232
+ rescue Expressir::Express::Error::SchemaParseFailure => e
233
+ warn "[suma] unparseable schema attachment: #{exp} " \
234
+ "(#{e.message.lines.first.to_s.strip})"
235
+ next nil
236
+ end
231
237
  next unless schema
232
238
 
233
239
  [File.basename(exp, ".exp"), schema.remarks]
234
- end.to_h
240
+ end.compact.to_h
235
241
  end
236
242
 
237
243
  def schema_doc_page?(rel_path)
data/lib/suma/version.rb CHANGED
@@ -1,5 +1,5 @@
1
1
  # frozen_string_literal: true
2
2
 
3
3
  module Suma
4
- VERSION = "0.5.43"
4
+ VERSION = "0.5.45"
5
5
  end
data/suma.gemspec CHANGED
@@ -47,5 +47,12 @@ Gem::Specification.new do |spec| # rubocop:disable Metrics/BlockLength
47
47
  spec.add_dependency "table_tennis"
48
48
  spec.add_dependency "thor", ">= 0.20"
49
49
 
50
+ # 0.5.45: the schema templates call formatted_hyperlinked_adoc_listing
51
+ # (plugin-lutaml >= 0.7.70); without this declaration the 0.7.69
52
+ # pairing renders Liquid nil silently and every schema page loses its
53
+ # listing (suma#211).
54
+ spec.add_dependency "metanorma-plugin-lutaml", ">= 0.7.72"
55
+
50
56
  spec.metadata["rubygems_mfa_required"] = "true"
51
57
  end
58
+
metadata CHANGED
@@ -1,14 +1,14 @@
1
1
  --- !ruby/object:Gem::Specification
2
2
  name: suma
3
3
  version: !ruby/object:Gem::Version
4
- version: 0.5.43
4
+ version: 0.5.45
5
5
  platform: ruby
6
6
  authors:
7
7
  - Ribose Inc.
8
8
  autorequire:
9
9
  bindir: exe
10
10
  cert_chain: []
11
- date: 2026-11-16 00:00:00.000000000 Z
11
+ date: 2026-11-17 00:00:00.000000000 Z
12
12
  dependencies:
13
13
  - !ruby/object:Gem::Dependency
14
14
  name: base64
@@ -184,6 +184,20 @@ dependencies:
184
184
  - - ">="
185
185
  - !ruby/object:Gem::Version
186
186
  version: '0.20'
187
+ - !ruby/object:Gem::Dependency
188
+ name: metanorma-plugin-lutaml
189
+ requirement: !ruby/object:Gem::Requirement
190
+ requirements:
191
+ - - ">="
192
+ - !ruby/object:Gem::Version
193
+ version: 0.7.72
194
+ type: :runtime
195
+ prerelease: false
196
+ version_requirements: !ruby/object:Gem::Requirement
197
+ requirements:
198
+ - - ">="
199
+ - !ruby/object:Gem::Version
200
+ version: 0.7.72
187
201
  description: 'Utility for SUMA (STEP Unified Model-Based Standards Architecture)
188
202
 
189
203
  '