al_folio_upgrade 1.0.0 → 1.0.2

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: 91910554f7cb55cf4d0183137c940f89c90770981a1094e471b51cd034044fc9
-  data.tar.gz: 5c4d24dbbec94b1169f39955a0c33986d43957ac6a9b995f1f324594fca342c8
+  metadata.gz: 311c5c378bf84cb75344dad471da0f2638381cf02bbc3fa0df7efb2334d4d2dc
+  data.tar.gz: 3a105b308d61ea92afee0d7c2cc3c5dfe98a0a1038bb2bf1aa58f3c45eb30ce0
 SHA512:
-  metadata.gz: a2dfa76729a1c268b5d7f0215721833e0caf8112e6e9bcf0550ed79532c1c7889e46ec215ea2a67f85dd723cc87f0acd5eae847f2b5de08a9cbcad3eab3c3e72
-  data.tar.gz: 84bd06b00efebb6668cb4992e58f7b2d67a310c120c3d0462700096d1e67392cb12366e9ce2cd1f9a9200438fa97f312cc2d014dcb9e0eba9d24865d5bf8974c
+  metadata.gz: ece6ab6b41a0afcf7d92a85e73407708451df2e3914031a39518d11c13e45df25625b5bc47fbc93a609920efb7ff9dd543adc29994b2a932770d844c60a80a96
+  data.tar.gz: b90842fe6f7b7a6ef987a725cf06c7df0885991407b832cf0fbbcd9a8df4ebd5ee3a8b62df69257b2ce110609fb333fae264cda54fb1c078de010866c49c6979

data/CHANGELOG.md

@@ -1,3 +1,15 @@
 # Changelog
 
-## 1.0.0 - 2026-02-08\n- Initial release.\n- Added `al-folio upgrade audit`, `al-folio upgrade apply --safe`, and `al-folio upgrade report`.
+## 1.0.2 - 2026-05-24
+
+- Expanded upgrade audit coverage for legacy local plugins and runtime assets that are now owned by v1 feature gems.
+
+## 1.0.1 - 2026-02-17
+
+- Added ownership-aware checks for plugin-owned local runtime assets (icons/search paths).
+- Added config contract warning when `al_icons` is missing from plugin wiring.
+
+## 1.0.0 - 2026-02-08
+
+- Initial release.
+- Added `al-folio upgrade audit`, `al-folio upgrade apply --safe`, and `al-folio upgrade report`.

data/README.md

@@ -1,6 +1,6 @@
-# Al-Folio Upgrade
+# al-folio-upgrade
 
-Upgrade CLI for al-folio v1.x.
+`al_folio_upgrade` is the upgrade CLI for `al-folio` v1.x.
 
 ## Commands
 
@@ -11,7 +11,18 @@ Upgrade CLI for al-folio v1.x.
 ## What it checks
 
 - Core config contract (`al_folio.*`, Tailwind, Distill)
+- Required plugin ownership wiring (for example `al_icons`)
 - Legacy Bootstrap/jQuery markers
 - Distill remote-loader policy
 - Local override drift when `theme: al_folio_core` is enabled
+- Plugin-owned local asset drift (for example copied search, icon, Distill, citation, and external-post runtime files)
 - Migration manifest availability from `al_folio_core`
+
+## Ecosystem context
+
+- Starter execution/docs live in `al-folio`.
+- Upgrade policy/audit behavior is owned by this plugin.
+
+## Contributing
+
+Audit/apply/report logic updates should be proposed in this repository.

data/lib/al_folio_upgrade/cli.rb

@@ -59,6 +59,21 @@ module AlFolioUpgrade
       tailwind.config.js
     ].freeze
 
+    PLUGIN_OWNED_LOCAL_PATHS = {
+      "_plugins/external-posts.rb" => "al_ext_posts",
+      "_plugins/google-scholar-citations.rb" => "al_citations",
+      "_plugins/inspirehep-citations.rb" => "al_citations",
+      "_plugins/hide-custom-bibtex.rb" => "al_folio_core",
+      "_plugins/details.rb" => "al_folio_core",
+      "_plugins/file-exists.rb" => "al_folio_core",
+      "_plugins/remove-accents.rb" => "al_folio_core",
+      "assets/js/distillpub/**/*" => "al_folio_distill",
+      "assets/js/search/**/*" => "al_search",
+      "assets/webfonts/**/*" => "al_icons",
+      "assets/fonts/academicons.*" => "al_icons",
+      "assets/fonts/scholar-icons.*" => "al_icons"
+    }.freeze
+
     def initialize(root: Dir.pwd, stdout: $stdout, stderr: $stderr)
       @root = Pathname.new(root)
       @stdout = stdout
@@ -139,6 +154,7 @@ module AlFolioUpgrade
       check_legacy_patterns(findings)
       check_distill_runtime(findings)
       check_core_override_drift(findings)
+      check_plugin_owned_local_assets(findings)
       findings
     end
 
@@ -220,6 +236,18 @@ module AlFolioUpgrade
           snippet: "Add al_folio.distill.engine/source/allow_remote_loader."
         )
       end
+
+      plugins = Array(parsed["plugins"]).map(&:to_s)
+      return if plugins.include?("al_icons")
+
+      findings << Finding.new(
+        id: "missing_al_icons_plugin",
+        severity: :warning,
+        message: "Missing `al_icons` in plugin list; icon runtime ownership moved out of core.",
+        file: "_config.yml",
+        line: 1,
+        snippet: "Add `- al_icons` under plugins."
+      )
     end
 
     def check_legacy_assets(findings)
@@ -346,6 +374,24 @@ module AlFolioUpgrade
       end
     end
 
+    def check_plugin_owned_local_assets(findings)
+      PLUGIN_OWNED_LOCAL_PATHS.each do |glob, owner_plugin|
+        Dir.glob(@root.join(glob)).sort.each do |path|
+          next unless File.file?(path)
+
+          relative = Pathname.new(path).relative_path_from(@root).to_s
+          findings << Finding.new(
+            id: "plugin_owned_local_asset",
+            severity: :warning,
+            message: "Local asset path is plugin-owned by `#{owner_plugin}` and may drift from release contracts.",
+            file: relative,
+            line: 1,
+            snippet: "Prefer plugin-managed runtime assets for this path."
+          )
+        end
+      end
+    end
+
     def each_candidate_file
       FILE_GLOBS.each do |glob|
         Dir.glob(@root.join(glob)).sort.each do |path|

data/lib/al_folio_upgrade/version.rb

@@ -1,5 +1,5 @@
 # frozen_string_literal: true
 
 module AlFolioUpgrade
-  VERSION = "1.0.0"
+  VERSION = "1.0.2"
 end

metadata

@@ -1,14 +1,13 @@
 --- !ruby/object:Gem::Specification
 name: al_folio_upgrade
 version: !ruby/object:Gem::Version
-  version: 1.0.0
+  version: 1.0.2
 platform: ruby
 authors:
 - al-folio maintainers
-autorequire:
 bindir: exe
 cert_chain: []
-date: 2026-02-16 00:00:00.000000000 Z
+date: 1980-01-02 00:00:00.000000000 Z
 dependencies:
 - !ruby/object:Gem::Dependency
   name: jekyll
@@ -120,7 +119,6 @@ metadata:
   allowed_push_host: https://rubygems.org
   homepage_uri: https://github.com/al-org-dev/al-folio-upgrade
   source_code_uri: https://github.com/al-org-dev/al-folio-upgrade
-post_install_message:
 rdoc_options: []
 require_paths:
 - lib
@@ -135,8 +133,7 @@ required_rubygems_version: !ruby/object:Gem::Requirement
     - !ruby/object:Gem::Version
       version: '0'
 requirements: []
-rubygems_version: 3.4.10
-signing_key:
+rubygems_version: 4.0.6
 specification_version: 4
 summary: Upgrade tooling for al-folio v1.x
 test_files: []