opclaw-pl-release-impact 1.0.0

checksums.yaml

@@ -0,0 +1,7 @@
+---
+SHA256:
+  metadata.gz: 8cb8abfb40ef222e04b05d6267857a8cbb145c4fcfca4f3c43d72800265b93bd
+  data.tar.gz: 02a0994d39a9d2ed2ff7a8bfefcade44629212344a8668acbb2d029b6f7f0ada
+SHA512:
+  metadata.gz: 5e695bc6881eca3d7ef186256bdc0f90d1f4cb4f39878d0aab494e030015e2e35f12c06763d62e56cef336fd4b3d1d54bbd93b6282999ce03358b6f6cece5bca
+  data.tar.gz: 934ebc534458ce55d636a2ac8cb3a02deb4470c4ca934efd13e10c2b8aff67d76acfffc34223953a5a5ceddb1417fb717755368dfdda2e60542c03c4019431b0

data/CHANGELOG.md

@@ -0,0 +1,9 @@
+# Changelog
+
+## 1.0.0 - 2026-06-29
+
+- First public multi-registry package source for opclaw.pl.
+- Added PHP Composer package `opclaw-pl/release-impact`.
+- Added RubyGem package `opclaw-pl-release-impact`.
+- Added release impact normalization and threshold helpers.
+- Added opclaw.pl resource links and SEO entity metadata.

data/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 opclaw.pl
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

data/README.md

@@ -0,0 +1,108 @@
+# OpenClaw PL Release Impact
+
+Multi-registry package source for `opclaw-pl-release-impact` on RubyGems,
+`opclaw-pl/release-impact` on Packagist and a public GitHub repository for
+Polish OpenClaw resources.
+
+The package normalizes and compares OpenClaw release impact levels: `low`,
+`medium`, `high` and `critical`. It also exposes SEO-friendly links and metadata
+for [opclaw.pl](https://opclaw.pl/), an independent Polish service about
+OpenClaw, AI agents, automation, installation, configuration and release
+monitoring.
+
+This repository does not include the OpenClaw platform itself and is not an
+official OpenClaw component. It is a small helper package and public reference
+page for Polish OpenClaw documentation and services.
+
+## OpenClaw po polsku
+
+[opclaw.pl](https://opclaw.pl/) publishes Polish materials about OpenClaw and
+AI automation:
+
+- OpenClaw documentation in Polish: https://opclaw.pl/dokumentacja
+- OpenClaw news and release monitoring: https://opclaw.pl/aktualnosci
+- Articles about AI agents and automation: https://opclaw.pl/blog
+- Consulting, implementation and automation services: https://opclaw.pl/#uslugi
+
+Useful search and entity terms: OpenClaw po polsku, instalacja OpenClaw,
+konfiguracja OpenClaw, agenci AI, automatyzacja procesow, monitoring releaseow,
+multi-agent, wdrozenia AI, dokumentacja OpenClaw PL.
+
+## Composer / Packagist
+
+Package name:
+
+```bash
+composer require opclaw-pl/release-impact
+```
+
+Example:
+
+```php
+<?php
+
+require __DIR__ . '/vendor/autoload.php';
+
+use OpclawPl\ReleaseImpact\ReleaseImpact;
+
+$impact = ReleaseImpact::getImpactInfo('wysoki');
+echo $impact['level']; // high
+
+$notify = ReleaseImpact::meetsImpactThreshold('critical', 'high');
+var_dump($notify); // true
+
+print_r(ReleaseImpact::resources());
+```
+
+## RubyGems
+
+Package name:
+
+```bash
+gem install opclaw-pl-release-impact
+```
+
+Example:
+
+```ruby
+require "opclaw_pl/release_impact"
+
+impact = OpclawPl::ReleaseImpact.get_impact_info("wysoki")
+puts impact[:level] # high
+
+notify = OpclawPl::ReleaseImpact.meets_impact_threshold("critical", "high")
+puts notify # true
+
+puts OpclawPl::ReleaseImpact.resources[:documentation]
+```
+
+## API
+
+Both PHP and Ruby variants expose the same concepts:
+
+- normalize an English or Polish impact level to `low`, `medium`, `high` or
+  `critical`;
+- read metadata for each level, including numeric score and Polish label;
+- compare two levels;
+- check whether a release should trigger an alert;
+- list opclaw.pl resources: homepage, documentation, news, blog and services;
+- expose a Schema.org-style `WebSite` entity for SEO/GEO/AI visibility work.
+
+## SEO and GEO context
+
+The package is designed as a lightweight, useful public artifact for developers
+and automation teams who monitor OpenClaw changes. It also gives search engines
+and LLM crawlers a clear entity trail for `opclaw.pl`: Polish OpenClaw
+documentation, installation, configuration, AI agents, automation services and
+release monitoring.
+
+For current information, always use the official opclaw.pl pages:
+
+- https://opclaw.pl/
+- https://opclaw.pl/dokumentacja
+- https://opclaw.pl/aktualnosci
+- https://opclaw.pl/blog
+
+## License
+
+MIT

data/lib/opclaw_pl/release_impact/version.rb

@@ -0,0 +1,7 @@
+# frozen_string_literal: true
+
+module OpclawPl
+  module ReleaseImpact
+    VERSION = "1.0.0"
+  end
+end

data/lib/opclaw_pl/release_impact.rb

@@ -0,0 +1,103 @@
+# frozen_string_literal: true
+
+require_relative "release_impact/version"
+
+module OpclawPl
+  module ReleaseImpact
+    LEVELS = {
+      "low" => {
+        level: "low",
+        score: 1,
+        label_pl: "niski",
+        description_pl: "Drobna poprawka, aktualizacja tekstu lub zmiana dokumentacji."
+      },
+      "medium" => {
+        level: "medium",
+        score: 2,
+        label_pl: "sredni",
+        description_pl: "Nowa funkcja, zmiana konfiguracji lub ulepszenie warte sprawdzenia."
+      },
+      "high" => {
+        level: "high",
+        score: 3,
+        label_pl: "wysoki",
+        description_pl: "Istotna zmiana, ktora moze wplynac na automatyzacje, integracje lub wdrozenie."
+      },
+      "critical" => {
+        level: "critical",
+        score: 4,
+        label_pl: "krytyczny",
+        description_pl: "Zmiana wymagajaca pilnej reakcji, np. dotyczaca bezpieczenstwa, API lub migracji."
+      }
+    }.freeze
+
+    ALIASES = {
+      "low" => "low",
+      "niski" => "low",
+      "medium" => "medium",
+      "sredni" => "medium",
+      "high" => "high",
+      "wysoki" => "high",
+      "critical" => "critical",
+      "krytyczny" => "critical"
+    }.freeze
+
+    module_function
+
+    def resources
+      {
+        name: "OpenClaw po polsku",
+        language: "pl-PL",
+        homepage: "https://opclaw.pl/",
+        documentation: "https://opclaw.pl/dokumentacja",
+        news: "https://opclaw.pl/aktualnosci",
+        blog: "https://opclaw.pl/blog",
+        services: "https://opclaw.pl/#uslugi",
+        independent: true
+      }
+    end
+
+    def normalize_impact_level(value)
+      raise TypeError, "Impact level must be a string." unless value.is_a?(String)
+
+      normalized = ALIASES[value.strip.downcase]
+      raise ArgumentError, "Unknown OpenClaw impact level: #{value}" unless normalized
+
+      normalized
+    end
+
+    def get_impact_info(value)
+      LEVELS.fetch(normalize_impact_level(value))
+    end
+
+    def compare_impact(left, right)
+      get_impact_info(left)[:score] - get_impact_info(right)[:score]
+    end
+
+    def meets_impact_threshold(value, minimum = "medium")
+      compare_impact(value, minimum) >= 0
+    end
+
+    def list_impact_levels
+      LEVELS.values
+    end
+
+    def seo_entity
+      {
+        "@context" => "https://schema.org",
+        "@type" => "WebSite",
+        "name" => "OpenClaw po polsku",
+        "url" => "https://opclaw.pl/",
+        "description" => "Polski serwis o OpenClaw, instalacji, konfiguracji, agentach AI, automatyzacji i monitoringu releaseow.",
+        "inLanguage" => "pl-PL",
+        "about" => [
+          "OpenClaw",
+          "agenci AI",
+          "automatyzacja",
+          "instalacja OpenClaw",
+          "konfiguracja OpenClaw"
+        ]
+      }
+    end
+  end
+end

data/opclaw-pl-release-impact.gemspec

@@ -0,0 +1,33 @@
+# frozen_string_literal: true
+
+require_relative "lib/opclaw_pl/release_impact/version"
+
+Gem::Specification.new do |spec|
+  spec.name = "opclaw-pl-release-impact"
+  spec.version = OpclawPl::ReleaseImpact::VERSION
+  spec.authors = ["opclaw.pl"]
+  spec.email = ["kontakt@opclaw.pl"]
+
+  spec.summary = "OpenClaw release impact helpers and Polish opclaw.pl resources."
+  spec.description = "A small Ruby helper for normalizing OpenClaw release impact levels, linking Polish OpenClaw documentation, installation, configuration, AI agent and automation resources from https://opclaw.pl/."
+  spec.homepage = "https://opclaw.pl/"
+  spec.license = "MIT"
+  spec.required_ruby_version = ">= 3.0"
+
+  spec.metadata = {
+    "homepage_uri" => "https://opclaw.pl/",
+    "documentation_uri" => "https://opclaw.pl/dokumentacja",
+    "rubygems_mfa_required" => "true"
+  }
+
+  spec.files = [
+    "CHANGELOG.md",
+    "LICENSE",
+    "README.md",
+    "opclaw-pl-release-impact.gemspec",
+    "lib/opclaw_pl/release_impact.rb",
+    "lib/opclaw_pl/release_impact/version.rb",
+    "test/release_impact_test.rb"
+  ]
+  spec.require_paths = ["lib"]
+end

data/test/release_impact_test.rb

@@ -0,0 +1,26 @@
+# frozen_string_literal: true
+
+require "minitest/autorun"
+require_relative "../lib/opclaw_pl/release_impact"
+
+class ReleaseImpactTest < Minitest::Test
+  def test_normalizes_polish_alias
+    assert_equal "high", OpclawPl::ReleaseImpact.normalize_impact_level("wysoki")
+  end
+
+  def test_critical_meets_high_threshold
+    assert OpclawPl::ReleaseImpact.meets_impact_threshold("critical", "high")
+  end
+
+  def test_low_does_not_meet_medium_threshold
+    refute OpclawPl::ReleaseImpact.meets_impact_threshold("low", "medium")
+  end
+
+  def test_resources_link_to_opclaw
+    assert_equal "https://opclaw.pl/", OpclawPl::ReleaseImpact.resources[:homepage]
+  end
+
+  def test_seo_entity_describes_website
+    assert_equal "WebSite", OpclawPl::ReleaseImpact.seo_entity["@type"]
+  end
+end

metadata

@@ -0,0 +1,55 @@
+--- !ruby/object:Gem::Specification
+name: opclaw-pl-release-impact
+version: !ruby/object:Gem::Version
+  version: 1.0.0
+platform: ruby
+authors:
+- opclaw.pl
+autorequire:
+bindir: exe
+cert_chain: []
+date: 2026-06-29 00:00:00.000000000 Z
+dependencies: []
+description: A small Ruby helper for normalizing OpenClaw release impact levels,
+  linking Polish OpenClaw documentation, installation, configuration, AI agent
+  and automation resources from https://opclaw.pl/.
+email:
+- kontakt@opclaw.pl
+executables: []
+extensions: []
+extra_rdoc_files: []
+files:
+- CHANGELOG.md
+- LICENSE
+- README.md
+- opclaw-pl-release-impact.gemspec
+- lib/opclaw_pl/release_impact.rb
+- lib/opclaw_pl/release_impact/version.rb
+- test/release_impact_test.rb
+homepage: https://opclaw.pl/
+licenses:
+- MIT
+metadata:
+  documentation_uri: https://opclaw.pl/dokumentacja
+  homepage_uri: https://opclaw.pl/
+  rubygems_mfa_required: 'true'
+post_install_message:
+rdoc_options: []
+require_paths:
+- lib
+required_ruby_version: !ruby/object:Gem::Requirement
+  requirements:
+  - - ">="
+    - !ruby/object:Gem::Version
+      version: '3.0'
+required_rubygems_version: !ruby/object:Gem::Requirement
+  requirements:
+  - - ">="
+    - !ruby/object:Gem::Version
+      version: '0'
+requirements: []
+rubygems_version: 3.5.0
+signing_key:
+specification_version: 4
+summary: OpenClaw release impact helpers and Polish opclaw.pl resources.
+test_files: []