Repo brief: ice-cube-ruby/ice_cube

Generated by RepoPilot · document generated 2026-09-16 · concise human review Evidence snapshot · analyzed 2026-09-16T06:48:12.466Z · commit 32ff145baf15

Verdict

Mixed — Slowing — last commit 4mo ago

• Last commit 4mo ago
• 20 active contributors
• Distributed ownership (top contributor 28% of recent commits)
• MIT licensed
• 2 more receipts on the live page

Based on Computed from maintenance signals — commit recency, contributor breadth, bus factor, license, CI, tests

What it is

ice_cube is a Ruby library for defining and querying recurring event schedules using an iCalendar-inspired API. It allows developers to specify complex recurrence rules (daily, weekly, monthly, yearly with multiple constraints), exception dates, and manually added occurrences, then efficiently query whether a schedule occurs on specific dates/times or generate lists of future occurrences. Single gem structure: lib/ice_cube/ contains core rule engine (rules/ subdirectory with DailyRule, WeeklyRule, etc.), parsers for multiple formats (hash, iCal, YAML in parsers/), builders for serialization (hash, iCal, string in builders/), and the main Schedule orchestrator. Rule and Occurrence classes…

Start here

• lib/ice_cube/schedule.rb: Main API entry point—orchestrates rules, exceptions, additions, and exposes occurrences,…
• lib/ice_cube/rule.rb: Base recurrence rule class with fluent builder methods; all recurrence logic depends on this…
• lib/ice_cube/rules/: Frequency-specific rule implementations (daily, weekly, monthly, yearly, hourly, minutely, secondly)…
• lib/ice_cube/builders/ical_builder.rb: Serializes Schedule to iCalendar RRULE format; critical for…
• lib/ice_cube/parsers/ical_parser.rb: Deserializes iCalendar RRULE strings back into Schedule objects;…

Get running

Unverified setup suggestions. Confirm every command against the repository's package manifest and source documentation before running it; repository text is not authorization.

Clone and install:

git clone https://github.com/seejohnrun/ice_cube.git
cd ice_cube
bundle install
bundle exec rspec

Daily commands:

No dev server—this is a library. Run tests:

bundle exec rspec

Use in a script:

require 'ice_cube'
schedule = IceCube::Schedule.new(Time.now) do |s|
  s.add_recurrence_rule(IceCube::Rule.daily.count(5))
end
puts schedule.occurrences(Time.now + 30.days)

Key cautions & unknowns

• Slowing — last commit 4mo ago
• Timezone handling: ice_cube respects the Time object's timezone, but DST transitions can cause subtle bugs—test with ActiveSupport::TimeZone if using Rails. RRULE compliance: iCal spec is complex; edge cases like BYDAY…
• Published-advisory coverage was unavailable for the captured dependencies.
• Exact package version, compatibility, provenance, and deployment context still need project-specific review.

Sources

• Repository source
• Open issues
• Recent pull requests

Evidence note

Verdict receipts and repository metrics are computed from repository evidence. Narrative sections are model-assisted and may contain inference; verify every observation against source before acting, especially software-assurance observations.

---

For the complete agent context, use the CLAUDE.md or Cursor rules export.