suma 0.5.44 → 0.5.46
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 +4 -4
- data/.github/workflows/release.yml +7 -0
- data/CLAUDE.md +10 -0
- data/lib/suma/delivery/site_verifier.rb +5 -0
- data/lib/suma/version.rb +1 -1
- data/suma.gemspec +7 -0
- metadata +16 -2
checksums.yaml
CHANGED
|
@@ -1,7 +1,7 @@
|
|
|
1
1
|
---
|
|
2
2
|
SHA256:
|
|
3
|
-
metadata.gz:
|
|
4
|
-
data.tar.gz:
|
|
3
|
+
metadata.gz: 85a9c26d83622207b34e74ff9079c36a8111cf87afb0e571b732a8f83b852f8d
|
|
4
|
+
data.tar.gz: 2cdffdf12e5e539ea0c96d8608ee0affe428bd03a4046f5ec1bfd11d3d3182bf
|
|
5
5
|
SHA512:
|
|
6
|
-
metadata.gz:
|
|
7
|
-
data.tar.gz:
|
|
6
|
+
metadata.gz: 98ce215e152ba83d93c686bfb6d239b485e0d49832894d73fcff70f73580840d23d084f488cb0579bb4ccd98e956a971578e3e544f510dc59ca44423252735cb
|
|
7
|
+
data.tar.gz: b3e7d4d2e7961d5a09a2b137505191a5d4797eaf5bf377bba25b8cd1a4fc14ac6382a1ff1c325fa2aecc03827b576a4113fd7d037e35f12f0a7f816e0032b02a
|
|
@@ -13,12 +13,19 @@ on:
|
|
|
13
13
|
default: 'skip'
|
|
14
14
|
repository_dispatch:
|
|
15
15
|
types: [ do-release ]
|
|
16
|
+
# The publish leg: when the release PR (head branch release/v*) merges,
|
|
17
|
+
# metanorma/ci tags the merge commit and publishes (metanorma/ci#515).
|
|
18
|
+
# Ordinary PR closes are skipped inside the reusable workflow.
|
|
19
|
+
pull_request:
|
|
20
|
+
types:
|
|
21
|
+
- closed
|
|
16
22
|
|
|
17
23
|
# Least-privilege ceiling for the called rubygems-release.yml: its release job
|
|
18
24
|
# needs contents:write (git tag push) and id-token:write (OIDC Trusted Publishing).
|
|
19
25
|
permissions:
|
|
20
26
|
contents: write
|
|
21
27
|
id-token: write
|
|
28
|
+
pull-requests: write
|
|
22
29
|
|
|
23
30
|
jobs:
|
|
24
31
|
release:
|
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.
|
|
@@ -152,6 +152,11 @@ module Suma
|
|
|
152
152
|
# leakage).
|
|
153
153
|
def check_asciidoc_leakage(doc, rel_path, report)
|
|
154
154
|
leaks = doc.xpath("//text()").sum do |node|
|
|
155
|
+
# The annotated-EXPRESS source listing shows the macros as
|
|
156
|
+
# written by design (the source-fidelity listing); only macros
|
|
157
|
+
# rendered outside listings are leakage.
|
|
158
|
+
next 0 if inside_listing?(node)
|
|
159
|
+
|
|
155
160
|
text = node.text.to_s
|
|
156
161
|
text.scan(ASCIIDOC_MACROS_RE).size + (text.strip == "+" ? 1 : 0)
|
|
157
162
|
end
|
data/lib/suma/version.rb
CHANGED
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.
|
|
4
|
+
version: 0.5.46
|
|
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-
|
|
11
|
+
date: 2026-11-20 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
|
'
|