fasti 1.0.0

checksums.yaml

@@ -0,0 +1,7 @@
+---
+SHA256:
+  metadata.gz: 22bea6abffa8acc0cc0f9e9f2b1c0a5b671daaec0eddf29c79b4266ff5aeab6c
+  data.tar.gz: 5411a1bea5372791dc1468d13878e140f6ad3591700f25d6c6f243c913f9ffee
+SHA512:
+  metadata.gz: f06ab9d564796e1e155fb7c4e8f2d65233068b90710e19e871e0299ee67f39798bb2efe304bee46afe19a9cb8eeee98007cd561c73c5c24fd798d3d763d2eae6
+  data.tar.gz: a73e17c0fc03c9c9aedb58bfae4c00fff5e9622b0cf6686aea2282bc397540d454d8e64f92bce6c3205ad5877101c1902d678cd4036a8dd58d62ddc5936a55f3

data/.mcp.json

@@ -0,0 +1,19 @@
+{
+  "mcpServers": {
+    "serena": {
+      "type": "stdio",
+      "command": "uvx",
+      "args": [
+        "--from",
+        "git+https://github.com/oraios/serena",
+        "serena",
+        "start-mcp-server",
+        "--context",
+        "ide-assistant",
+        "--project",
+        "/Users/sakuro/github.com/sakuro/fasti"
+      ],
+      "env": {}
+    }
+  }
+}

data/.rspec

@@ -0,0 +1,3 @@
+--format progress
+--color
+--require spec_helper

data/.rubocop.yml

@@ -0,0 +1,82 @@
+AllCops:
+  DisplayCopNames: true
+  DisplayStyleGuide: true
+  EnabledByDefault: true
+  Exclude:
+    - bin/**/*
+    - vendor/**/*
+  ExtraDetails: true
+  NewCops: enable
+  TargetRubyVersion: 3.2
+  UseCache: true
+
+inherit_mode:
+  merge:
+    - Exclude
+
+plugins:
+  - rubocop-performance
+  - rubocop-rake
+  - rubocop-rspec
+
+inherit_gem:
+  docquet:
+    - config/cops/bundler.yml
+    - config/cops/gemspec.yml
+    - config/cops/layout.yml
+    - config/cops/lint.yml
+    - config/cops/metrics.yml
+    - config/cops/naming.yml
+    - config/cops/performance.yml
+    - config/cops/rake.yml
+    - config/cops/rspec.yml
+    - config/cops/security.yml
+    - config/cops/style.yml
+
+inherit_from: .rubocop_todo.yml
+
+# Project-specific settings can be added here
+Naming/VariableNumber:
+  AllowedPatterns:
+    - '^(january|february|march|april|may|june|july|august|september|october|november|december)_\d{4}$'  # month_YYYY
+    - '^(leap|non_leap)_\d{4}$'  # leap_YYYY, non_leap_YYYY
+
+Style/EmptyElse:
+  Enabled: false
+
+Style/FetchEnvVar:
+  # Allow ENV["key"] for these variables as nil return values are intentionally handled
+  AllowedVars:
+    - LC_ALL        # Used for locale detection, nil is acceptable
+    - LANG          # Used for locale detection, nil is acceptable
+    - XDG_CONFIG_HOME  # Used in tests for environment backup/restore, nil is acceptable
+
+Style/SymbolProc:
+  # Allow OptionParser#accept method which requires specific block format incompatible with symbol-to-proc
+  AllowedMethods:
+    - accept
+
+Layout/LineLength:
+  # Exclude test files with long test data strings
+  Exclude:
+    - 'spec/fasti/style_parser_spec.rb'
+
+Metrics/ParameterLists:
+  # Don't count keyword arguments as they are named and improve readability
+  CountKeywordArgs: false
+
+Metrics/BlockLength:
+  # Exclude CLI file which contains long OptionParser DSL block
+  Exclude:
+    - 'lib/fasti/cli.rb'
+
+# Benchmark scripts are executable utilities, not library code
+Style/TopLevelMethodDefinition:
+  Exclude:
+    - 'benchmark/**/*'
+
+Style/Documentation:
+  # Exclude config.rb: Contains methods in module re-opening (not namespace module),
+  # but main Fasti module documentation is already provided in lib/fasti.rb
+  Exclude:
+    - 'lib/fasti/config.rb'

data/.rubocop_todo.yml

@@ -0,0 +1,89 @@
+# This configuration was generated by
+# `rubocop --auto-gen-config --no-exclude-limit --no-offense-counts --no-auto-gen-timestamp`
+# using RuboCop version 1.80.0.
+# The point is for the user to remove these configuration records
+# one by one as the offenses are removed from the code base.
+# Note that changes in the inspected code, or installation of new
+# versions of RuboCop, may require this file to be generated again.
+
+# Configuration parameters: AllowedMethods, AllowedPatterns, CountRepeatedAttributes, Max.
+Metrics/AbcSize:
+  Exclude:
+    - 'lib/fasti/calendar.rb'
+    - 'lib/fasti/calendar_transition.rb'
+    - 'lib/fasti/cli.rb'
+    - 'lib/fasti/config.rb'
+    - 'lib/fasti/formatter.rb'
+    - 'lib/fasti/style.rb'
+    - 'lib/fasti/style_parser.rb'
+
+# Configuration parameters: CountComments, Max, CountAsOne, AllowedMethods, AllowedPatterns, inherit_mode.
+# AllowedMethods: refine
+Metrics/BlockLength:
+  Exclude:
+    - 'examples/config.rb'
+
+# Configuration parameters: CountComments, Max, CountAsOne.
+Metrics/ClassLength:
+  Exclude:
+    - 'lib/fasti/calendar.rb'
+    - 'lib/fasti/cli.rb'
+    - 'lib/fasti/style_parser.rb'
+
+# Configuration parameters: AllowedMethods, AllowedPatterns, Max.
+Metrics/CyclomaticComplexity:
+  Exclude:
+    - 'lib/fasti/formatter.rb'
+    - 'lib/fasti/style.rb'
+
+# Configuration parameters: CountComments, Max, CountAsOne, AllowedMethods, AllowedPatterns.
+Metrics/MethodLength:
+  Exclude:
+    - 'lib/fasti/calendar.rb'
+    - 'lib/fasti/calendar_transition.rb'
+    - 'lib/fasti/cli.rb'
+    - 'lib/fasti/config.rb'
+    - 'lib/fasti/formatter.rb'
+    - 'lib/fasti/style.rb'
+    - 'lib/fasti/style_parser.rb'
+    - 'spec/support/ansi_matchers.rb'
+
+# Configuration parameters: AllowedMethods, AllowedPatterns, Max.
+Metrics/PerceivedComplexity:
+  Exclude:
+    - 'lib/fasti/formatter.rb'
+    - 'lib/fasti/style.rb'
+
+# Configuration parameters: Prefixes, AllowedPatterns.
+# Prefixes: when, with, without
+RSpec/ContextWording:
+  Exclude:
+    - 'spec/fasti/calendar_spec.rb'
+
+# Configuration parameters: Max, CountAsOne.
+RSpec/ExampleLength:
+  Exclude:
+    - 'spec/fasti/calendar_spec.rb'
+    - 'spec/fasti/calendar_transition_spec.rb'
+    - 'spec/fasti/cli_spec.rb'
+    - 'spec/fasti/config_spec.rb'
+    - 'spec/fasti/formatter_custom_styles_spec.rb'
+    - 'spec/fasti/formatter_spec.rb'
+    - 'spec/fasti/style_spec.rb'
+
+# Configuration parameters: Max.
+RSpec/MultipleExpectations:
+  Exclude:
+    - 'spec/fasti/calendar_spec.rb'
+    - 'spec/fasti/calendar_transition_spec.rb'
+    - 'spec/fasti/cli_spec.rb'
+    - 'spec/fasti/config_spec.rb'
+    - 'spec/fasti/formatter_custom_styles_spec.rb'
+    - 'spec/fasti/formatter_spec.rb'
+    - 'spec/fasti/style_parser_spec.rb'
+    - 'spec/fasti/style_spec.rb'
+
+# Configuration parameters: Max, AllowedGroups.
+RSpec/NestedGroups:
+  Exclude:
+    - 'spec/fasti/formatter_spec.rb'

data/.serena/project.yml

@@ -0,0 +1,68 @@
+# language of the project (csharp, python, rust, java, typescript, go, cpp, or ruby)
+#  * For C, use cpp
+#  * For JavaScript, use typescript
+# Special requirements:
+#  * csharp: Requires the presence of a .sln file in the project folder.
+language: ruby
+
+# whether to use the project's gitignore file to ignore files
+# Added on 2025-04-07
+ignore_all_files_in_gitignore: true
+# list of additional paths to ignore
+# same syntax as gitignore, so you can use * and **
+# Was previously called `ignored_dirs`, please update your config if you are using that.
+# Added (renamed) on 2025-04-07
+ignored_paths: []
+
+# whether the project is in read-only mode
+# If set to true, all editing tools will be disabled and attempts to use them will result in an error
+# Added on 2025-04-18
+read_only: false
+
+
+# list of tool names to exclude. We recommend not excluding any tools, see the readme for more details.
+# Below is the complete list of tools for convenience.
+# To make sure you have the latest list of tools, and to view their descriptions, 
+# execute `uv run scripts/print_tool_overview.py`.
+#
+#  * `activate_project`: Activates a project by name.
+#  * `check_onboarding_performed`: Checks whether project onboarding was already performed.
+#  * `create_text_file`: Creates/overwrites a file in the project directory.
+#  * `delete_lines`: Deletes a range of lines within a file.
+#  * `delete_memory`: Deletes a memory from Serena's project-specific memory store.
+#  * `execute_shell_command`: Executes a shell command.
+#  * `find_referencing_code_snippets`: Finds code snippets in which the symbol at the given location is referenced.
+#  * `find_referencing_symbols`: Finds symbols that reference the symbol at the given location (optionally filtered by type).
+#  * `find_symbol`: Performs a global (or local) search for symbols with/containing a given name/substring (optionally filtered by type).
+#  * `get_current_config`: Prints the current configuration of the agent, including the active and available projects, tools, contexts, and modes.
+#  * `get_symbols_overview`: Gets an overview of the top-level symbols defined in a given file.
+#  * `initial_instructions`: Gets the initial instructions for the current project.
+#     Should only be used in settings where the system prompt cannot be set,
+#     e.g. in clients you have no control over, like Claude Desktop.
+#  * `insert_after_symbol`: Inserts content after the end of the definition of a given symbol.
+#  * `insert_at_line`: Inserts content at a given line in a file.
+#  * `insert_before_symbol`: Inserts content before the beginning of the definition of a given symbol.
+#  * `list_dir`: Lists files and directories in the given directory (optionally with recursion).
+#  * `list_memories`: Lists memories in Serena's project-specific memory store.
+#  * `onboarding`: Performs onboarding (identifying the project structure and essential tasks, e.g. for testing or building).
+#  * `prepare_for_new_conversation`: Provides instructions for preparing for a new conversation (in order to continue with the necessary context).
+#  * `read_file`: Reads a file within the project directory.
+#  * `read_memory`: Reads the memory with the given name from Serena's project-specific memory store.
+#  * `remove_project`: Removes a project from the Serena configuration.
+#  * `replace_lines`: Replaces a range of lines within a file with new content.
+#  * `replace_symbol_body`: Replaces the full definition of a symbol.
+#  * `restart_language_server`: Restarts the language server, may be necessary when edits not through Serena happen.
+#  * `search_for_pattern`: Performs a search for a pattern in the project.
+#  * `summarize_changes`: Provides instructions for summarizing the changes made to the codebase.
+#  * `switch_modes`: Activates modes by providing a list of their names
+#  * `think_about_collected_information`: Thinking tool for pondering the completeness of collected information.
+#  * `think_about_task_adherence`: Thinking tool for determining whether the agent is still on track with the current task.
+#  * `think_about_whether_you_are_done`: Thinking tool for determining whether the task is truly completed.
+#  * `write_memory`: Writes a named memory (for future reference) to Serena's project-specific memory store.
+excluded_tools: []
+
+# initial prompt for the project. It will always be given to the LLM upon activating the project
+# (contrary to the memories, which are loaded on demand).
+initial_prompt: ""
+
+project_name: "fasti"

data/.simplecov

@@ -0,0 +1,31 @@
+# frozen_string_literal: true
+
+SimpleCov.configure do
+  # Start coverage measurement
+  SimpleCov.start do
+    # Add coverage filter for non-production code
+    add_filter "/spec/"
+    add_filter "/vendor/"
+    add_filter "/examples/"
+
+    # Track these directories
+    add_group "Library", "lib"
+    add_group "Executables", "exe"
+
+    # Coverage thresholds - restored and improved beyond original target
+    minimum_coverage 90.0 # Achieved: 96.99% line coverage, 90.73% branch coverage
+    # minimum_coverage_by_file 80  # Could be enabled with current high coverage
+
+    # Enable branch coverage (Ruby 2.5+)
+    enable_coverage :branch if respond_to?(:enable_coverage)
+
+    # Coverage formats
+    formatter SimpleCov::Formatter::MultiFormatter.new([
+                                                         SimpleCov::Formatter::HTMLFormatter, # HTML report in coverage/
+                                                         SimpleCov::Formatter::SimpleFormatter # Console output
+                                                       ])
+
+    # Merge multiple test runs (useful for parallel testing)
+    merge_timeout 3600
+  end
+end

data/.yardopts

@@ -0,0 +1,9 @@
+--markup markdown
+--markup-provider redcarpet
+--output-dir docs/api
+--readme README.md
+--files CHANGELOG.md,LICENSE.txt
+--exclude spec/
+--exclude vendor/
+lib/**/*.rb
+exe/fasti

data/AGENTS.md

@@ -0,0 +1,60 @@
+# Repository Guidelines
+
+> **Note**: This file is also accessible via the `CLAUDE.md` symlink for AI agent compatibility.
+
+> **Important**: This document references other documentation files. Please also read:
+> - `docs/agents/rubocop.md` - RuboCop fix guidelines for AI agents
+> - `docs/agents/git-pr.md` - Git commit and pull request guidelines
+> - `docs/agents/languages.md` - Language usage guidelines for communication and code
+> - Any other documents referenced inline below
+
+## Project Structure & Module Organization
+- `lib/fasti`: Core library. Entry point is `lib/fasti.rb`; code is namespaced under `Fasti` (autoloaded via Zeitwerk).
+- `spec`: RSpec tests. Mirror library paths (e.g., `spec/fasti/cli_spec.rb`).
+- `docs/api`: Generated YARD documentation. Do not edit by hand; use `rake doc`.
+- `benchmark/*`: Performance experiments and notes.
+- `bin`: Development helpers (`bin/setup`, `bin/console`).
+
+## Build, Test, and Development Commands
+- `bundle install`: Install dependencies (use a supported Ruby; see policy below and `mise.toml`).
+- `rake`: Default task; runs `spec` and `rubocop`.
+- `rake spec`: Run the test suite.
+- `rubocop` or `rake rubocop`: Lint and style checks.
+- `rake doc`: Build YARD docs into `docs/api`.
+- `bin/console`: IRB with the gem loaded for quick experiments.
+- `docquet regenerate-todo`: Regenerate `.rubocop_todo.yml` after lint updates; include with related code fixes.
+
+## Communication & Languages
+See `docs/agents/languages.md` for detailed language usage guidelines covering:
+- AI/user chat communication languages
+- Source code and documentation language requirements  
+- Issues/PRs language preferences
+- Context-appropriate language switching
+
+## Coding Style & Naming Conventions
+- Ruby 3.x compatible; 2-space indent, `# frozen_string_literal: true` headers.
+- Follow RuboCop rules (`.rubocop.yml`); fix offenses before committing.
+- Files and specs use snake_case; specs live under `spec/fasti/*_spec.rb`.
+- Public API is under `Fasti`; avoid monkey patching. Prefer immutable, composable objects where applicable.
+- RuboCop fixes: When addressing lints, follow `docs/agents/rubocop.md` (safe autocorrect first; targeted unsafe only as needed).
+
+## Testing Guidelines
+- Framework: RSpec with `spec_helper` and SimpleCov. Maintain ≥ 90% coverage.
+- Name/spec files to mirror library paths; keep examples focused and readable.
+- Run `rake spec` locally; ensure `.rspec_status` is clean.
+
+## Commit & Pull Request Guidelines
+- Title format: Must start with a GitHub `:emoji:` code followed by a space, then an imperative subject. Example: `:zap: Optimize Style#call path`.
+- No raw emoji: Use `:emoji:` codes only (commit hook rejects Unicode emoji).
+- Exceptions: `fixup!` / `squash!` are allowed by hooks.
+- Merge commits: Auto-prefixed with `:inbox_tray:` by the prepare-commit-msg hook.
+- Commit body: English, explaining motivation, approach, and trade-offs.
+- Include rationale and, when useful, before/after snippets or benchmarks.
+- Link issues (e.g., `Fixes #123`) and update README/CHANGELOG when user-facing behavior changes.
+- PRs must pass `rake` (tests + lint), include tests for changes, and keep API docs current (`rake doc` when needed).
+
+## Security & Configuration Tips
+- Supported Ruby: latest patch of the newest three minor series (e.g., 3.4.x / 3.3.x / 3.2.x). Develop locally on the oldest of these.
+- Version management: Use `mise`; the repo’s `mise.toml` sets the default to the oldest supported series. Examples: `mise use -g ruby@3.2`, `mise run -e ruby@3.3 rake spec`.
+- Keep runtime dependencies minimal; prefer standard library where possible.
+- No network access is expected at runtime; avoid introducing it without discussion.

data/CHANGELOG.md

@@ -0,0 +1,25 @@
+## [Unreleased]
+
+## [1.0.0] - 2025-09-10
+
+### Added
+- **Core Calendar Application**: Flexible calendar application with multi-country holiday support
+- **Multiple Display Formats**: Month, quarter (3 months), and full year views
+- **Holiday Support**: Country-specific holiday highlighting using the holidays gem
+- **Configurable Week Start**: Support for all 7 days of the week as week start
+- **Custom Styling System**: Comprehensive `--style` option with flexible styling rules for holidays, weekends, and today's date powered by TIntMe gem
+- **Configuration File**: XDG-compliant Ruby-based configuration file support (`~/.config/fasti/config.rb`)
+- **Locale Detection**: Automatic country detection from `LC_ALL` and `LANG` environment variables
+- **Examples Directory**: Sample configuration files for easy setup
+- **Zeitwerk Integration**: Modern code autoloading with Zeitwerk for improved performance and maintainability
+
+### Performance
+- **Holiday Caching**: Month-based holiday caching with bulk API calls for 12-74x performance improvement
+- **Style Caching**: Target-based style caching system achieving 966+ months/second rendering performance
+- **TIntMe Integration**: High-performance ANSI terminal styling with optimized color composition
+
+### Development
+- **Comprehensive Testing**: Full RSpec test suite with 154+ examples
+- **Code Quality**: RuboCop configuration with strict style enforcement
+- **Benchmark Suite**: Performance testing tools for holiday caching validation
+- **CI/CD**: GitHub Actions workflow for automated testing and quality checks

data/CLAUDE.md

@@ -0,0 +1 @@
+AGENTS.md

data/LICENSE.txt

@@ -0,0 +1,21 @@
+The MIT License (MIT)
+
+Copyright (c) 2025 OZAWA Sakuro
+
+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.