automatic 26.08 → 26.09

data/doc/VERSIONS

@@ -1,26 +1,64 @@
 automaticruby Repository Version History
 ========================================
 
+v26.09 (2026-09-23)
+-------------------
+- Add FilterKimi for the Kimi API, using its OpenAI-compatible Chat Completions
+  interface.
+- Add FilterLimit, FilterBatch, and FilterPresent for pipeline-wide limiting,
+  batching, and required-field filtering.
+- Add per-fetch interval handling to FilterFullFeed, FilterImageSource, and
+  FilterDescriptionLink.
+- Refresh the bundled LDRFullFeed siteinfo database from a newer upstream
+  snapshot.
+- Make doc/PLUGINS.md section 6 the plugin catalogue's source of truth.
+- Harden the framework's execution boundary: fix CLI contract drift, distinguish
+  dependency from load failures, and preflight-validate Recipe plugins.
+- Preserve standard item metadata when FeedMaker rebuilds pipelines so filters
+  keep source, enclosure, and full content.
+- Preserve nil-link pipeline items and remove SubscriptionText placeholder
+  title and link values.
+- Preserve SubscriptionText TSV column positions and ignore empty input rows.
+- Preserve local file paths when StoreFile hands file URIs to PublishAmazonS3.
+- Stop StoreFullText from passing items downstream when database writes fail.
+
 v26.08 (2026-08-22)
 -------------------
-- Support Ruby 3.3 through 4.0 and modernize the codebase for current Ruby and maintained library APIs, validating representative versions in CI.
-- Harden Recipe loading with safe YAML parsing, structural validation and framework-specific errors.
-- Restructure the CLI with help and version options, predictable error reporting and documented exit statuses.
-- Report a clear CLI error when feed inspection discovers no feed instead of raising an internal exception.
+- Support Ruby 3.3 through 4.0 and modernize the codebase for current Ruby and
+  maintained library APIs, validating representative versions in CI.
+- Harden Recipe loading with safe YAML parsing, structural validation and
+  framework-specific errors.
+- Restructure the CLI with help and version options, predictable error reporting
+  and documented exit statuses.
+- Report a clear CLI error when feed inspection discovers no feed instead of
+  raising an internal exception.
 - Reject HTTP and HTTPS URLs without a host before attempting a network request.
-- Verify TLS certificates when publishing to Instapaper instead of accepting an unverified connection.
-- Modernize gem packaging and dependency policy, separating core requirements from optional plugin dependencies so that an installation can be minimal, complete or extended one plugin at a time, and excluding development and generated files.
-- Classify every shipped plugin by its current support status rather than simulating obsolete services in tests.
-- Modernize the bundled plugins for current Ruby, libraries and services, and remove the integrations that are no longer viable.
-- Remove the plugins for Twitter, Pocket, HipChat, Google Calendar, livedoor Weather, So-net G-Guide and Chan-Toru, and Google News link rewriting; their services or APIs no longer exist, and a Recipe naming one now fails at load.
-- Add the plugin CustomFeedWeb, which builds one feed per HTML index page from the article links it lists, selected with CSS selectors and filtered by host, pattern and count.
-- Add the plugin StoreDigest, which drops items by content rather than by URL, on a SHA-256 digest of the item fields a Recipe names.
-- Add the plugin FilterJoin, which joins the whole pipeline into one item carrying each item's title, link and body, and invents no permalink for it.
-- Add the plugins FilterOpenAI, FilterClaude, FilterGemini and FilterSakuraAI, one per AI service rather than one selectable by setting, each replacing an item's description with what that service answers to the Recipe's prompt under a token the Recipe holds.
-- Rebuild the test and CI strategy for current RSpec and Ruby, with deterministic isolation from user data and external services.
-- Add Markdown as the primary service-independent publication format, with a documented and tested first-run workflow.
-- Rebuild the maintained documentation around current usage, architecture, policy, plugins and deployment, and remove superseded historical documents.
-- Offer the project under either GPLv3 or LGPLv3, retaining third-party attribution and shipping both licence texts.
+- Verify TLS certificates when publishing to Instapaper instead of accepting an
+  unverified connection.
+- Modernize gem packaging: separate core from optional plugin dependencies so an
+  install can be minimal or extended one plugin at a time.
+- Classify every shipped plugin by its current support status rather than
+  simulating obsolete services in tests.
+- Modernize the bundled plugins for current Ruby, libraries and services, and
+  remove the integrations that are no longer viable.
+- Remove the plugins for services that no longer exist: Twitter, Pocket, HipChat,
+  Google Calendar, livedoor Weather, So-net G-Guide and Chan-Toru.
+- Add the plugin CustomFeedWeb, building one feed per HTML index page from its
+  article links, selected by CSS selector and filtered by host, pattern and count.
+- Add the plugin StoreDigest, which drops items by content rather than by URL, on
+  a SHA-256 digest of the item fields a Recipe names.
+- Add the plugin FilterJoin, which joins the whole pipeline into one item carrying
+  each item's title, link and body, and invents no permalink for it.
+- Add one AI filter plugin per service (FilterOpenAI, FilterClaude, FilterGemini,
+  FilterSakuraAI), replacing an item's description with that service's answer.
+- Rebuild the test and CI strategy for current RSpec and Ruby, with deterministic
+  isolation from user data and external services.
+- Add Markdown as the primary service-independent publication format, with a
+  documented and tested first-run workflow.
+- Rebuild the maintained documentation around current usage, architecture, policy,
+  plugins and deployment, and remove superseded historical documents.
+- Offer the project under either GPLv3 or LGPLv3, retaining third-party
+  attribution and shipping both licence texts.
 
 v14.12.2 (2015-01-04)
 ---------------------
@@ -56,9 +94,12 @@ v14.3.0 (2014-03-23)
 v14.2.0 (2014-02-26)
 --------------------
 - Add the plugin Publish::AmazonS3.
-- Rename Store::TargetLink to Store::File, and have it rewrite the link to a file URI scheme.
-- Enable the file URI scheme in an RSS 2.0 feed, and let Store::File fetch a file from Amazon S3.
-- Read text from TSV formatted files in Subscription::Text, and add the description, author and comments fields to the RSS 2.0 feed.
+- Rename Store::TargetLink to Store::File, and have it rewrite the link to a file
+  URI scheme.
+- Enable the file URI scheme in an RSS 2.0 feed, and let Store::File fetch a file
+  from Amazon S3.
+- Read text from TSV formatted files in Subscription::Text, and add the
+  description, author and comments fields to the RSS 2.0 feed.
 - Give the log messages more detail.
 - Use 'double' instead of 'mock' and 'stub' for rspec-mocks.
 - Improve CI with a network connection.
@@ -80,14 +121,17 @@ v13.7.0 (2013-07-28)
 
 v13.6.0 (2013-06-28)
 --------------------
-- Add the plugins Subscription::Pocket, Subscription::TwitterSearch, Subscription::GGuide, Subscription::ChanToru, Filter::Accept, Filter::Sanitize, Filter::GithubFeed, Publish::ConsoleLink, Publish::Hipchat, Publish::Memcached and Publish::Fluentd.
-- Correspond to activesupport and activerecord 4.0, temporarily removing the mail plugins for actionmailer 4.0.
+- Add eleven plugins spanning Subscription, Filter and Publish, including Pocket,
+  GGuide, ChanToru, Accept, Sanitize, ConsoleLink, Hipchat, Memcached and Fluentd.
+- Correspond to activesupport and activerecord 4.0, temporarily removing the mail
+  plugins for actionmailer 4.0.
 - Ruby 1.8 support was outdated.
 - And other improvements and bug fixes.
 
 v13.5.0 (2013-05-18)
 --------------------
-- Add the plugins Subscription::Text, Subscription::Weather, Filter::One, Filter::Rand, Publish::Twitter and Publish::Pocket.
+- Add the plugins Subscription::Text, Subscription::Weather, Filter::One,
+  Filter::Rand, Publish::Twitter and Publish::Pocket.
 - Move the repository from id774/automaticruby to automaticruby/automaticruby.
 
 v13.4.1 (2013-04-10)
@@ -101,7 +145,8 @@ v13.2.0 (2013-02-13)
 - Implement the retry function in all subscription and download plugins.
 - Plugin Filter::Ignore has become an item-based filter.
 - Rename the plugin Filter::Reverse to Filter::Sort.
-- Add the plugins Subscription::GoogleReaderStar, Filter::FullFeed and Publish::Instapaper.
+- Add the plugins Subscription::GoogleReaderStar, Filter::FullFeed and
+  Publish::Instapaper.
 - Improve the tests.
 - And other minor bug fixes.
 
@@ -122,18 +167,25 @@ v12.9.1 (2012-09-18)
 
 v12.9.0 (2012-09-18)
 --------------------
-- Unify the format of the pipeline to a feed object, an array of feeds; some plugins lost backward compatibility.
-- Add the plugins Subscription::Link, Subscription::Twitter, Filter::Image and Filter::AbsoluteURI.
-- Remove the obsolete plugins Subscription::URI, Extract::Link, Filter::ImageLink, Store::Link and Store::Target.
+- Unify the format of the pipeline to a feed object, an array of feeds; some
+  plugins lost backward compatibility.
+- Add the plugins Subscription::Link, Subscription::Twitter, Filter::Image and
+  Filter::AbsoluteURI.
+- Remove the obsolete plugins Subscription::URI, Extract::Link, Filter::ImageLink,
+  Store::Link and Store::Target.
 
 v12.6.0 (2012-06-18)
 --------------------
-- Add the plugins Subscription::URI, Extract::Link, Filter::ImageLink, Store::Link and Store::Target.
-- Make scaffold create the config and db directories, and add the unscaffold subcommand to automatic-config.
-- Search the user directory's config when given -c with a simple filename, and use the user's db directory when it exists.
+- Add the plugins Subscription::URI, Extract::Link, Filter::ImageLink, Store::Link
+  and Store::Target.
+- Make scaffold create the config and db directories, and add the unscaffold
+  subcommand to automatic-config.
+- Search the user directory's config when given -c with a simple filename, and use
+  the user's db directory when it exists.
 - Show the recipe and db name in the log.
 - Refactor the plug-in names and the header fields.
-- Add tests, taking RSpec code coverage over 99%, and add the all option to script/build.
+- Add tests, taking RSpec code coverage over 99%, and add the all option to
+  script/build.
 
 v12.4.0 (2012-04-30)
 --------------------
@@ -144,40 +196,40 @@ v12.4.0 (2012-04-30)
 v12.3.1 (2012-03-16)
 --------------------
 - Write the English documents doc/README and doc/PLUGINS.
-- Let a user who installed the gem package create their own plugins, under ~/.automatic/plugins.
-- Merge the utilities into the automatic-config command, adding the subcommands scaffold, autodiscovery, opmlparser, feedparser and log.
+- Let a user who installed the gem package create their own plugins, under
+  ~/.automatic/plugins.
+- Merge the utilities into the automatic-config command, adding the subcommands
+  scaffold, autodiscovery, opmlparser, feedparser and log.
 - Add the integration test script script/build for CI.
 
 v12.03 (2012-03-07)
 -------------------
 - Distribute as a gem library.
-- Add the plugins CustomFeed::SVNLog, Notify::Ikachan, Filter::TumblrResize, Filter::Image and Store::TargetLink.
+- Add the plugins CustomFeed::SVNLog, Notify::Ikachan, Filter::TumblrResize,
+  Filter::Image and Store::TargetLink.
 - Add the CI and build script script/bootstrap.
 - Significant refactoring.
 
 v12.02.1 (2012-02-25)
 ---------------------
-- Point release: a large refactoring of the core, a reorganization of the namespace, and a few plugins added.
+- Point release: a large refactoring of the core, a reorganization of the
+  namespace, and a few plugins added.
 
 v12.02 (2012-02-18)
 -------------------
-- First release: the scratch of this script, with a plugin existing only for Hatena Bookmark.
+- Initial release.
 
 
 Notes on this record
 ====================
-- Entries from v12.02 to v14.12.0 were moved here from doc/ChangeLog, which this
-  file replaces. No entry and no date was changed in the move; the wording was
-  brought to one bullet per change, and nothing was added or dropped.
-- v14.10.1, v14.12.1 and v14.12.2 were released and are recorded in the commit
-  log, but were never written into doc/ChangeLog. Their entries above were
-  reconstructed from the commits that bumped the version.
-- No Git tag exists for any release before v26.08. The version numbers above are
-  those recorded in the VERSION file at the time, and the commit log is the only
-  other record of them.
-- Between v14.12.2 and v26.08 the only committed change was the addition of the
-  integration recipe test/integration/test_pdf2local.yml in April 2015. It is
-  part of the v26.08 entry's repository state and took no version of its own.
+- Entries from v12.02 to v14.12.0 were moved here from doc/ChangeLog, unchanged in
+  date or content, one bullet per change.
+- v14.10.1, v14.12.1 and v14.12.2 were released and recorded in the commit log but
+  never in doc/ChangeLog; their entries above are reconstructed from it.
+- No Git tag exists for any release before v26.08; the version numbers above are
+  those recorded in the VERSION file at the time.
+- Between v14.12.2 and v26.08 the only committed change was adding
+  test/integration/test_pdf2local.yml (April 2015), folded into v26.08.
 
 
 Version History Guidelines
@@ -187,10 +239,11 @@ Version History Guidelines
 - Omit development-time corrections and intermediate states that were reverted
   or superseded before release; Git history retains that detail.
 - Summarize related low-level changes under their substantive outcome.
-- Write one coherent change per physical line, as a rule.
-- Keep entries near 100 columns where practical. Necessary file names, module
-  names, plugin names, option names, and configuration names may extend an entry
-  to approximately 120 columns.
+- Write one coherent change per bullet, at most two physical lines.
+- A single line at or under 80 columns is preferred whenever practical.
+  Necessary file names, module names, plugin names, option names, and
+  configuration names may pass 80 columns on the bullet's one or two lines
+  when they cannot be shortened without losing meaning.
 - When a version history already exists, balance a new entry against the length
   of the existing lines, so that the whole file stays consistent.
 - When an entry becomes substantially longer, omit or abstract implementation
@@ -201,8 +254,13 @@ Version History Guidelines
   same file or feature.
 - Place closely related entries near each other.
 - Append an independent new change to the end of the current version entry.
+- Never create more than one repository version for the same calendar date.
+- Independent changes may use separate bullets, but they stay in that day's
+  single version entry.
 - Past entries and their dates are a record. Do not rewrite, renumber or merge
-  them, and do not merge two releases that actually existed because they share
-  a date.
+  them. Past releases that share a date stay recorded as they were made; they
+  do not conform to the rule above and are not precedent for new releases.
 - This file records the history of the repository. A change that is not
   observable from outside does not need an entry here.
+- The first entry, at the lowest version this file reaches, reads only
+  "Initial release." and nothing else.

data/lib/automatic/cli.rb

@@ -1,11 +1,11 @@
 # -*- coding: utf-8 -*-
 # Name::        Automatic::CLI
-# Author:       id774 (More info: http://id774.net)
+# Author:       id774 (More info: https://id774.net)
 # Source Code:: https://github.com/id774/automaticruby
 # License::     The GPL version 3, or LGPL version 3 (Dual License).
 # Contact::     idnanashi@gmail.com
 # Created::     Aug 14, 2026
-# Updated::     Aug 19, 2026
+# Updated::     Sep  9, 2026
 # Copyright::   Copyright (c) 2012-2026 Automatic Ruby Developers.
 #
 # Everything that belongs to being a command: option parsing, the subcommands,
@@ -103,11 +103,13 @@ module Automatic
       EXIT_FAILURE
     end
 
-    # A LoadError is one of the failures reported as a message here: a Recipe
-    # naming a plugin whose optional gem is not installed is an operator's
-    # mistake with an answer, and the answer is in the message rather than in a
-    # backtrace. What the plugin itself raises is left alone; see
-    # doc/PLUGINS.md section 2.7.
+    # Automatic::OptionalDependencyError is one of the failures reported as a
+    # message here: a Recipe naming a plugin whose optional gem is not
+    # installed is an operator's mistake with an answer, and the answer is in
+    # the message rather than in a backtrace. A LoadError raised from inside a
+    # plugin's own load -- for a different, unrelated missing file -- is not
+    # this, and is left alone along with everything else the plugin itself
+    # raises; see doc/PLUGINS.md section 2.7.
     def run_recipe(path)
       unless File.exist?(resolve_recipe(path))
         @stderr.puts "automatic: no such recipe: #{path}"
@@ -116,7 +118,8 @@ module Automatic
 
       Automatic.run(recipe: Automatic::Recipe.new(path), root_dir: @root_dir)
       EXIT_SUCCESS
-    rescue Automatic::Error, Psych::Exception, SystemCallError, IOError, LoadError => e
+    rescue Automatic::Error, Psych::Exception, SystemCallError, IOError,
+           Automatic::OptionalDependencyError => e
       @stderr.puts "automatic: #{e.message}"
       EXIT_FAILURE
     end
@@ -139,7 +142,7 @@ module Automatic
 
       handler.call(argv)
       EXIT_SUCCESS
-    rescue Automatic::Error, SystemCallError, IOError, LoadError => e
+    rescue Automatic::Error, SystemCallError, IOError, Automatic::OptionalDependencyError => e
       @stderr.puts "automatic: #{e.message}"
       EXIT_FAILURE
     end
@@ -178,16 +181,12 @@ module Automatic
       create_dir(File.join(Automatic.user_dir, 'db'))
 
       assets = File.join(Automatic.user_dir, 'assets')
-      if create_dir(assets)
-        FileUtils.cp_r(File.join(@root_dir, 'assets', 'siteinfo'),
-                       File.join(assets, 'siteinfo'))
-      end
+      create_dir(assets)
+      copy_bundled(File.join(@root_dir, 'assets', 'siteinfo'), File.join(assets, 'siteinfo'))
 
       config = Automatic.user_config_dir
-      if create_dir(config)
-        FileUtils.cp_r(File.join(@root_dir, 'config'),
-                       File.join(config, 'example'))
-      end
+      create_dir(config)
+      copy_bundled(File.join(@root_dir, 'config'), File.join(config, 'example'))
     end
 
     def unscaffold(_argv)
@@ -209,9 +208,19 @@ module Automatic
       require 'automatic/feed_parser'
       require 'pp'
       url = argv.shift || missing_argument('feedparser')
+      validate_fetch_url(url)
       @stdout.puts Automatic::FeedParser.get_url(url).pretty_inspect
     end
 
+    # Converts only the URL validation failure `Automatic::Http.uri` already
+    # applies into the CLI's ordinary failure path; an unexpected error from
+    # inside FeedParser itself is left to propagate.
+    def validate_fetch_url(url)
+      Automatic::Http.uri(url)
+    rescue ArgumentError, URI::InvalidURIError => e
+      raise Automatic::Error, e.message
+    end
+
     def inspect_url(argv)
       require 'automatic/feed_parser'
       Automatic.require_optional('feedbag', needed_by: 'the inspect subcommand')
@@ -221,7 +230,7 @@ module Automatic
       raise Automatic::Error, "no feed found at #{url}" if feeds.empty?
 
       @stdout.puts feeds.pretty_inspect
-      @stdout.puts Automatic::FeedParser.get_url(feeds.pop).pretty_inspect
+      @stdout.puts Automatic::FeedParser.get_url(feeds.first).pretty_inspect
     end
 
     def opmlparser(argv)
@@ -244,5 +253,18 @@ module Automatic
       @stdout.puts "Creating #{path}"
       true
     end
+
+    # Bundled initial data (siteinfo, example config) is copied whenever its
+    # own destination is missing, independent of whether the parent user
+    # directory already existed. That is what lets a re-run of scaffold heal a
+    # partially-scaffolded user directory instead of only ever populating a
+    # brand new one. See doc/DEPLOYMENT.md and doc/POLICY.md on scaffold only
+    # adding what is missing.
+    def copy_bundled(src, dest)
+      return if File.exist?(dest)
+
+      FileUtils.cp_r(src, dest)
+      @stdout.puts "Creating #{dest}"
+    end
   end
 end

data/lib/automatic/environment.rb

@@ -1,6 +1,6 @@
 # -*- coding: utf-8 -*-
 # Name::        Automatic::Environment
-# Author:       id774 (More info: http://id774.net)
+# Author:       id774 (More info: https://id774.net)
 # Source Code:: https://github.com/id774/automaticruby
 # License::     The GPL version 3, or LGPL version 3 (Dual License).
 # Contact::     idnanashi@gmail.com

data/lib/automatic/feed_maker.rb

@@ -1,11 +1,11 @@
 # -*- coding: utf-8 -*-
 # Name::        Automatic::FeedMaker
-# Author:       id774 (More info: http://id774.net)
+# Author:       id774 (More info: https://id774.net)
 # Source Code:: https://github.com/id774/automaticruby
 # License::     The GPL version 3, or LGPL version 3 (Dual License).
 # Contact::     idnanashi@gmail.com
 # Created::     Feb 21, 2014
-# Updated::     Aug 14, 2026
+# Updated::     Sep  7, 2026
 # Copyright::   Copyright (c) 2012-2026 Automatic Ruby Developers.
 
 module Automatic
@@ -16,8 +16,8 @@ module Automatic
     class FeedObject
       attr_accessor :title, :link, :description, :author, :comments
       def initialize
-        @link        = 'http://dummy'
-        @title       = 'dummy'
+        @link        = nil
+        @title       = nil
         @description = ''
         @author      = ''
         @comments    = ''
@@ -34,6 +34,20 @@ module Automatic
       feed_object
     end
 
+    # Plain-value standard fields, copied onto the rebuilt item as-is when the
+    # item being rebuilt carries them. See doc/REQUIREMENTS.md and
+    # doc/PLUGINS.md for the standard item field contract this preserves.
+    REBUILD_SIMPLE_FIELDS = %i[title link description author comments content_encoded].freeze
+
+    # source and enclosure are RSS child elements. RSS::Maker exposes each of
+    # them on a new item as a builder with its own sub-attributes rather than
+    # accepting the finished element directly, so each is rebuilt attribute by
+    # attribute instead of by one assignment.
+    REBUILD_STRUCTURED_FIELDS = {
+      source:    %i[url content],
+      enclosure: %i[url length type]
+    }.freeze
+
     def self.create_pipeline(feeds = [])
       RSS::Maker.make("2.0") {|maker|
         xss = maker.xml_stylesheets.new_xml_stylesheet
@@ -44,20 +58,12 @@ module Automatic
 
         unless feeds.nil?
           feeds.each {|feed|
-            unless feed.link.nil?
-              Automatic::Log.puts("info", "Create Pipeline: #{feed.link}")
-              item = maker.items.new_item
-              item.title = feed.title
-              item.link = feed.link
-              begin
-                item.description = feed.description
-                item.author = feed.author
-                item.comments = feed.comments
-                item.date = feed.pubDate || Time.now
-              rescue NoMethodError
-                Automatic::Log.puts("warn", "Undefined field detected in feed.")
-              end
-            end
+            Automatic::Log.puts("info", "Create Pipeline: #{feed.link}")
+            item = maker.items.new_item
+            item.date = (feed.pubDate if feed.respond_to?(:pubDate)) || Time.now
+
+            REBUILD_SIMPLE_FIELDS.each { |field| copy_rebuild_field(feed, item, field) }
+            REBUILD_STRUCTURED_FIELDS.each_key { |field| copy_rebuild_structured_field(feed, item, field) }
           }
         end
       }
@@ -77,5 +83,38 @@ module Automatic
         item.date = Time.now
       }
     end
+
+    # A field the item being rebuilt does not carry, or carries as nil, is
+    # left off the new item: that is the normal shape of an optional field,
+    # not a reason to skip copying anything else. See doc/POLICY.md on
+    # distinguishing a missing optional value from a programming error.
+    def self.copy_rebuild_field(feed, item, field)
+      return unless feed.respond_to?(field)
+
+      value = feed.public_send(field)
+      return if value.nil?
+
+      item.public_send("#{field}=", value)
+    end
+    private_class_method :copy_rebuild_field
+
+    # source and enclosure are rebuilt sub-attribute by sub-attribute, on the
+    # same missing-is-normal basis as copy_rebuild_field, so that (for
+    # example) an enclosure with no type recorded still keeps its url.
+    def self.copy_rebuild_structured_field(feed, item, field)
+      return unless feed.respond_to?(field)
+
+      value = feed.public_send(field)
+      return if value.nil?
+
+      target = item.public_send(field)
+      REBUILD_STRUCTURED_FIELDS.fetch(field).each do |sub_field|
+        next unless value.respond_to?(sub_field)
+
+        sub_value = value.public_send(sub_field)
+        target.public_send("#{sub_field}=", sub_value) unless sub_value.nil?
+      end
+    end
+    private_class_method :copy_rebuild_structured_field
   end
 end

data/lib/automatic/feed_parser.rb

@@ -1,6 +1,6 @@
 # -*- coding: utf-8 -*-
 # Name::        Automatic::FeedParser
-# Author:       id774 (More info: http://id774.net)
+# Author:       id774 (More info: https://id774.net)
 # Source Code:: https://github.com/id774/automaticruby
 # License::     The GPL version 3, or LGPL version 3 (Dual License).
 # Contact::     idnanashi@gmail.com

data/lib/automatic/http.rb

@@ -1,6 +1,6 @@
 # -*- coding: utf-8 -*-
 # Name::        Automatic::Http
-# Author:       id774 (More info: http://id774.net)
+# Author:       id774 (More info: https://id774.net)
 # Source Code:: https://github.com/id774/automaticruby
 # License::     The GPL version 3, or LGPL version 3 (Dual License).
 # Contact::     idnanashi@gmail.com

data/lib/automatic/log.rb

@@ -1,6 +1,6 @@
 # -*- coding: utf-8 -*-
 # Name::        Automatic::Log
-# Author:       id774 (More info: http://id774.net)
+# Author:       id774 (More info: https://id774.net)
 # Source Code:: https://github.com/id774/automaticruby
 # License::     The GPL version 3, or LGPL version 3 (Dual License).
 # Contact::     idnanashi@gmail.com

data/lib/automatic/pipeline.rb

@@ -1,16 +1,23 @@
 # -*- coding: utf-8 -*-
 # Name::        Automatic::Pipeline
-# Author:       id774 (More info: http://id774.net)
+# Author:       id774 (More info: https://id774.net)
 # Source Code:: https://github.com/id774/automaticruby
 # License::     The GPL version 3, or LGPL version 3 (Dual License).
 # Contact::     idnanashi@gmail.com
 # Created::     Feb 22, 2012
-# Updated::     Aug 14, 2026
+# Updated::     Sep  6, 2026
 # Copyright::   Copyright (c) 2012-2026 Automatic Ruby Developers.
 #
 # The core: resolve a plugin's class name to a file, then run the Recipe's
 # plugins in order, each receiving the previous one's output. See
 # doc/BASIC_DESIGN.md section 4.6 and doc/PLUGINS.md section 3.
+#
+# Every module the Recipe names is discovered before any plugin runs, so that
+# an unknown module later in the Recipe is refused before an earlier plugin's
+# side effect, not after it. Discovery only registers an autoload; it does not
+# read a plugin's own source, which stays lazy until that plugin's turn to
+# run. See doc/PLUGINS.md on unknown plugin being refused before any plugin
+# runs.
 
 require 'active_support/core_ext/string/inflections'
 
@@ -51,10 +58,13 @@ module Automatic
       def run(recipe)
         raise NoRecipeError, 'no recipe given' if recipe.nil?
 
+        entries = []
+        recipe.each_plugin { |plugin| entries << [plugin, plugin.module] }
+
+        entries.each { |_plugin, mod| load_plugin(mod) }
+
         pipeline = []
-        recipe.each_plugin do |plugin|
-          mod = plugin.module
-          load_plugin(mod)
+        entries.each do |plugin, mod|
           klass = Automatic::Plugin.const_get(mod)
           pipeline = klass.new(plugin.config, pipeline).run
         end

data/lib/automatic/recipe.rb

@@ -5,11 +5,16 @@
 # License::     The GPL version 3, or LGPL version 3 (Dual License).
 # Contact::     idnanashi@gmail.com
 # Created::     Feb 18, 2012
-# Updated::     Aug 14, 2026
+# Updated::     Sep  6, 2026
 # Copyright::   Copyright (c) 2012-2026 Automatic Ruby Developers.
 #
 # Turns a Recipe file into something the pipeline can iterate. The format is
 # specified in doc/PLUGINS.md section 2.
+#
+# Each plugin entry's documented shape -- a mapping naming a module, with an
+# optional config mapping -- is validated here, at load time, rather than
+# left to surface as whatever internal exception a malformed entry happens to
+# raise once the pipeline reaches it.
 
 require 'date'
 require 'hashie'
@@ -45,6 +50,8 @@ module Automatic
               "recipe #{resolved} has no plugins sequence"
       end
 
+      validate_plugins(resolved)
+
       Automatic::Log.level(@procedure.global&.log&.level)
       Automatic::Log.puts('info', "Loading Recipe: #{resolved}")
       @procedure
@@ -72,5 +79,42 @@ module Automatic
         aliases: true
       )
     end
+
+    # Only the shape doc/PLUGINS.md documents is checked here: a mapping
+    # naming a module, with an optional config mapping. What a plugin does
+    # with its own config is that plugin's concern, not this one's.
+    def validate_plugins(resolved)
+      @procedure.plugins.each_with_index do |plugin, index|
+        validate_plugin_entry(resolved, plugin, index)
+      end
+    end
+
+    def validate_plugin_entry(resolved, plugin, index)
+      unless plugin.is_a?(Hash)
+        raise InvalidRecipeError,
+              "recipe #{resolved} plugins[#{index}] is not a mapping"
+      end
+
+      validate_module_name(resolved, plugin, index)
+      validate_plugin_config(resolved, plugin, index)
+    end
+
+    def validate_module_name(resolved, plugin, index)
+      name = plugin['module']
+
+      return if name.is_a?(String) && !name.strip.empty?
+
+      raise InvalidRecipeError,
+            "recipe #{resolved} plugins[#{index}] has no module name"
+    end
+
+    def validate_plugin_config(resolved, plugin, index)
+      config = plugin['config']
+
+      return if config.nil? || config.is_a?(Hash)
+
+      raise InvalidRecipeError,
+            "recipe #{resolved} plugins[#{index}] has a config that is not a mapping"
+    end
   end
 end