VERSIONS

automaticruby Repository Version History
========================================

v26.09 (Release Date: TBD)
--------------------------
- Add FilterLimit, FilterBatch, FilterPresent, and per-fetch interval handling;
  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 nil-link pipeline items and remove SubscriptionText placeholder
  title and link values.
- Preserve SubscriptionText TSV column positions and ignore empty input rows.

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.
- 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: 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)
---------------------
- Pin every gem in the Gemfile to an exact minor version.

v14.12.1 (2015-01-03)
---------------------
- Depend on activerecord 4.1.

v14.12.0 (2014-12-27)
---------------------
- Rewrite obsolete methods.
- Update Gemfile.

v14.10.1 (2014-10-23)
---------------------
- Version-only release. No change beyond the version number is recorded for it.

v14.10.0 (2014-10-23)
---------------------
- Use Logger for log output.
- Store::FullText ignores an entry whose title is already stored.
- Add the plugins Filter::Clear, Filter::GoogleNews and Filter::DescriptionLink.

v14.5.0 (2014-05-31)
--------------------
- Update to activesupport and activerecord 4.1.

v14.3.0 (2014-03-23)
--------------------
- Downgrade the nokogiri version for OS X.

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.
- Give the log messages more detail.
- Use 'double' instead of 'mock' and 'stub' for rspec-mocks.
- Improve CI with a network connection.
- Divide Feed::Parser into Feed::Maker.

v14.1.0 (2014-01-24)
--------------------
- Fix a dependency conflict.
- Refactor the error retry handling.

v13.12.0 (2013-12-17)
---------------------
- Fix the twitter gem version.

v13.7.0 (2013-07-28)
--------------------
- Add the plugins Subscription::Xml and Provide::Fluentd.
- Fix some problems.

v13.6.0 (2013-06-28)
--------------------
- 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.
- Move the repository from id774/automaticruby to automaticruby/automaticruby.

v13.4.1 (2013-04-10)
--------------------
- Merge the command automatic-config into automatic.
- Improve the retry functions.
- Run the tests on Ruby 2.0.

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.
- Improve the tests.
- And other minor bug fixes.

v13.1.0 (2013-01-08)
--------------------
- Fix the interval bugs.
- Improve the timing of logging.
- Return only a new feed.
- Refactoring.

v12.10.0 (2012-10-16)
---------------------
- Add the plugin Subscription::Tumblr.

v12.9.1 (2012-09-18)
--------------------
- Consider the case of a feed link including nil.

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.

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.
- 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.

v12.4.0 (2012-04-30)
--------------------
- Add the inspect subcommand to automatic-config.
- Add the plugins Filter::Reverse, Publish::SMTP and Publish::Mail.
- Run all integration tests with CI.

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.
- 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 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.

v12.02 (2012-02-18)
-------------------
- Initial release.


Notes on this record
====================
- 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
==========================
- Record externally meaningful or architecturally significant outcomes, not a
  diary of implementation work.
- 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 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
  details, examples, reasons, and secondary effects where possible.
- Preserve the changed target, externally observable behavior, compatibility
  or security impact, and important option or configuration names.
- Combine related changes within the same version, especially changes to the
  same file or feature.
- Place closely related entries near each other.
- Append an independent new change to the end of the current 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.
- 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.