wavify 0.1.0

checksums.yaml

@@ -0,0 +1,7 @@
+---
+SHA256:
+  metadata.gz: 0573e324cb4eb544c7a82ed254dd7fcd473439747b5c675ab474457d5cad1fec
+  data.tar.gz: a8659118673abb114e917ce23c5c8e332338962f87fe42eec9bab562628b4af9
+SHA512:
+  metadata.gz: 197cda12919d9acb3a80b17cb6526a15e2fc5b2c8c442144f299d938d0306f0b0bc332ce57da8ec98ebe87a04b11b18b3b157d2ea2bcfbf570d3266b7dde855d
+  data.tar.gz: 96432c4aadea84b31a83a231678dde7faed327246e45fa7d34ca4a5cc16d0ab1da200faaef4ab7f0980ec6de33402bf1f5a82e628b7921c5447447c3793f5f41

data/.serena/.gitignore

@@ -0,0 +1 @@
+/cache

data/.serena/memories/project_overview.md

@@ -0,0 +1,5 @@
+# Wavify project overview
+- Purpose: Pure Ruby audio processing gem with immutable, chainable audio transforms and codec support.
+- Tech stack: Ruby (>=3.1), Bundler, RSpec, Rake, RuboCop, YARD/RBS (`sig/`).
+- Current codec status of interest: OGG Vorbis supports container/header parsing and metadata; audio decode is under implementation with preflight scaffolding.
+- Structure: `lib/` implementation, `spec/` tests, `examples/`, `benchmarks/`, `bin/`, `tools/`, `sig/`.

data/.serena/memories/style_and_completion.md

@@ -0,0 +1,5 @@
+# Style and completion guidance
+- Ruby codebase uses frozen string literal comments and idiomatic snake_case naming.
+- Prefer small incremental changes with tests (RSpec) and keep public behavior stable unless task says otherwise.
+- For codec work, add focused fixtures/spec regressions for parsing and decode preflight behavior.
+- Task completion checks: run relevant specs first (target file), then broader `bundle exec rspec` if changes touch shared paths; ensure git worktree is clean except intended changes.

data/.serena/memories/suggested_commands.md

@@ -0,0 +1,11 @@
+# Suggested commands (Darwin shell)
+- `git status --short`
+- `git log --oneline -10`
+- `bundle exec rspec`
+- `bundle exec rspec spec/codecs/ogg_vorbis_spec.rb`
+- `bundle exec rubocop`
+- `bundle exec rake spec:coverage COVERAGE_MINIMUM=90`
+- `bundle exec rake docs:examples`
+- `bundle exec rake docs:yard`
+- `bundle exec rake docs:check YARD_MINIMUM=85`
+- `rake bench:flac` / `rake bench:all`

data/.serena/project.yml

@@ -0,0 +1,126 @@
+# the name by which the project can be referenced within Serena
+project_name: "wavify"
+
+
+# list of languages for which language servers are started; choose from:
+#   al                  bash                clojure             cpp                 csharp
+#   csharp_omnisharp    dart                elixir              elm                 erlang
+#   fortran             fsharp              go                  groovy              haskell
+#   java                julia               kotlin              lua                 markdown
+#   matlab              nix                 pascal              perl                php
+#   php_phpactor        powershell          python              python_jedi         r
+#   rego                ruby                ruby_solargraph     rust                scala
+#   swift               terraform           toml                typescript          typescript_vts
+#   vue                 yaml                zig
+#   (This list may be outdated. For the current list, see values of Language enum here:
+#   https://github.com/oraios/serena/blob/main/src/solidlsp/ls_config.py
+#   For some languages, there are alternative language servers, e.g. csharp_omnisharp, ruby_solargraph.)
+# Note:
+#   - For C, use cpp
+#   - For JavaScript, use typescript
+#   - For Free Pascal/Lazarus, use pascal
+# Special requirements:
+#   Some languages require additional setup/installations.
+#   See here for details: https://oraios.github.io/serena/01-about/020_programming-languages.html#language-servers
+# When using multiple languages, the first language server that supports a given file will be used for that file.
+# The first language is the default language and the respective language server will be used as a fallback.
+# Note that when using the JetBrains backend, language servers are not used and this list is correspondingly ignored.
+languages:
+- ruby
+
+# the encoding used by text files in the project
+# For a list of possible encodings, see https://docs.python.org/3.11/library/codecs.html#standard-encodings
+encoding: "utf-8"
+
+# whether to use project's .gitignore files to ignore files
+ignore_all_files_in_gitignore: true
+
+# list of additional paths to ignore in this project.
+# Same syntax as gitignore, so you can use * and **.
+# Note: global ignored_paths from serena_config.yml are also applied additively.
+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: []
+
+# list of tools to include that would otherwise be disabled (particularly optional tools that are disabled by default)
+included_optional_tools: []
+
+# fixed set of tools to use as the base tool set (if non-empty), replacing Serena's default set of tools.
+# This cannot be combined with non-empty excluded_tools or included_optional_tools.
+fixed_tools: []
+
+# list of mode names to that are always to be included in the set of active modes
+# The full set of modes to be activated is base_modes + default_modes.
+# If the setting is undefined, the base_modes from the global configuration (serena_config.yml) apply.
+# Otherwise, this setting overrides the global configuration.
+# Set this to [] to disable base modes for this project.
+# Set this to a list of mode names to always include the respective modes for this project.
+base_modes:
+
+# list of mode names that are to be activated by default.
+# The full set of modes to be activated is base_modes + default_modes.
+# If the setting is undefined, the default_modes from the global configuration (serena_config.yml) apply.
+# Otherwise, this overrides the setting from the global configuration (serena_config.yml).
+# This setting can, in turn, be overridden by CLI parameters (--mode).
+default_modes:
+
+# 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: ""
+
+# time budget (seconds) per tool call for the retrieval of additional symbol information
+# such as docstrings or parameter information.
+# This overrides the corresponding setting in the global configuration; see the documentation there.
+# If null or missing, use the setting from the global configuration.
+symbol_info_budget:
+
+# The language backend to use for this project.
+# If not set, the global setting from serena_config.yml is used.
+# Valid values: LSP, JetBrains
+# Note: the backend is fixed at startup. If a project with a different backend
+# is activated post-init, an error will be returned.
+language_backend:

data/.simplecov

@@ -0,0 +1,18 @@
+# frozen_string_literal: true
+
+SimpleCov.configure do
+  enable_coverage :branch if ENV["SIMPLECOV_BRANCH"] == "1"
+
+  add_filter "/spec/"
+  add_filter "/examples/"
+  add_filter "/benchmarks/"
+  add_filter "/tmp/"
+
+  add_group "Core", "lib/wavify/core"
+  add_group "Codecs", "lib/wavify/codecs"
+  add_group "DSP", "lib/wavify/dsp"
+  add_group "Sequencer", "lib/wavify/sequencer"
+
+  minimum = ENV.fetch("COVERAGE_MINIMUM", nil)
+  minimum_coverage(minimum.to_i) if minimum && !minimum.empty?
+end

data/.yardopts

@@ -0,0 +1,4 @@
+--readme README.md
+--markup markdown
+--output-dir doc
+lib/**/*.rb

data/CHANGELOG.md

@@ -0,0 +1,11 @@
+# Changelog
+
+All notable changes to this project will be documented in this file.
+
+The format is based on Keep a Changelog and this project adheres to Semantic Versioning.
+
+## [Unreleased]
+
+## [0.1.0] - 2026-03-04
+
+- Initial release

data/LICENSE

@@ -0,0 +1,21 @@
+The MIT License (MIT)
+
+Copyright (c) 2026 Yudai Takada
+
+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.

data/README.md

@@ -0,0 +1,196 @@
+# Wavify
+
+Wavify is a Ruby audio processing toolkit with immutable transforms, codec I/O, streaming pipelines, DSP effects, and a sequencing DSL.
+
+## Requirements
+
+- Ruby `>= 3.1`
+- Bundler
+- Native build environment for gems with C extensions (`ogg-ruby`, `vorbis`)
+
+## Installation
+
+Add to your Gemfile:
+
+```ruby
+gem "wavify"
+```
+
+Then install:
+
+```bash
+bundle install
+```
+
+Or install directly:
+
+```bash
+gem install wavify
+```
+
+## Quick Start
+
+```ruby
+require "wavify"
+
+format = Wavify::Core::Format::CD_QUALITY
+
+audio = Wavify::Audio.tone(
+  frequency: 440.0,
+  duration: 1.0,
+  waveform: :sine,
+  format: format
+)
+
+audio.fade_in(0.02).fade_out(0.05).write("tone.wav")
+```
+
+## Core API
+
+### `Wavify::Audio`
+
+Main constructors:
+
+- `Audio.read(path, format: nil, codec_options: {})`
+- `Audio.stream(path_or_io, chunk_size: 4096, format: nil, codec_options: {})`
+- `Audio.tone(frequency:, duration:, waveform:, format:)`
+- `Audio.silence(duration_seconds, format:)`
+- `Audio.mix(*audios)`
+
+Immutable transforms (each also has `!` in-place variants):
+
+- `gain`, `normalize`, `trim`, `fade_in`, `fade_out`, `pan`, `reverse`, `loop`, `apply`
+
+Utility methods:
+
+- `convert`, `split(at:)`, `peak_amplitude`, `rms_amplitude`, `duration`, `sample_frame_count`
+
+### Streaming pipeline
+
+```ruby
+Wavify::Audio.stream("input.wav", chunk_size: 4096)
+             .pipe(Wavify::Effects::Compressor.new(threshold: -18, ratio: 3.0))
+             .pipe(Wavify::Effects::Chorus.new(rate: 0.5, depth: 0.2, mix: 0.15))
+             .write_to("output.aiff", format: Wavify::Core::Format::CD_QUALITY)
+```
+
+`pipe` accepts processors that respond to `call`, `process`, or `apply`.
+
+## Format Support
+
+| Format | Read | Write | Stream Read | Stream Write | Notes |
+|--------|------|-------|-------------|--------------|-------|
+| WAV | ✅ | ✅ | ✅ | ✅ | PCM + float WAV, including extensible WAV |
+| AIFF | ✅ | ✅ | ✅ | ✅ | PCM only (AIFC unsupported) |
+| FLAC | ✅ | ✅ | ✅ | ✅ | Pure Ruby implementation |
+| OGG Vorbis | ✅ | ✅ | ✅ | ✅ | Backed by `ogg-ruby` + `vorbis` |
+| Raw PCM/Float | ✅* | ✅ | ✅* | ✅ | `format:` is required for read/stream-read/metadata |
+
+Raw example:
+
+```ruby
+raw_format = Wavify::Core::Format.new(channels: 2, sample_rate: 44_100, bit_depth: 16, sample_format: :pcm)
+audio = Wavify::Audio.read("input.pcm", format: raw_format)
+audio.write("output.wav")
+```
+
+### OGG Vorbis notes
+
+- `read` / `stream_read` support sequential chained streams and interleaved multi-stream OGG.
+- Interleaved multi-stream decode is mixed into one output stream.
+- If interleaved streams have different sample rates, they are resampled to the first logical stream's sample rate before mix.
+- `decode_mode: :strict` and `decode_mode: :placeholder` are accepted for API compatibility.
+
+## Sequencer DSL
+
+Use `Wavify.build` for one-shot rendering/writing, or `Wavify::DSL.build_definition` when you want timeline access.
+
+```ruby
+song = Wavify::DSL.build_definition(format: Wavify::Core::Format::CD_QUALITY, tempo: 116, default_bars: 2) do
+  track :kick do
+    synth :sine
+    notes "C2 . . . C2 . . .", resolution: 16
+    envelope attack: 0.001, decay: 0.05, sustain: 0.0, release: 0.06
+    gain(-4)
+  end
+
+  arrange do
+    section :intro, bars: 1, tracks: %i[kick]
+  end
+end
+
+timeline = song.timeline
+mix = song.render
+mix.write("song.wav")
+```
+
+## DSP
+
+Built-in modules:
+
+- Oscillator waveforms: `:sine`, `:square`, `:sawtooth`, `:triangle`, `:white_noise`, `:pink_noise`
+- Envelope (ADSR)
+- Biquad filters (lowpass/highpass/bandpass/notch/peaking/shelves)
+- Effects: `Delay`, `Reverb`, `Chorus`, `Distortion`, `Compressor`
+
+## Examples
+
+Scripts in `examples/`:
+
+- `examples/format_convert.rb`
+- `examples/audio_processing.rb`
+- `examples/synth_pad.rb`
+- `examples/drum_machine.rb`
+- `examples/hybrid_arrangement.rb`
+- `examples/streaming_master_chain.rb`
+- `examples/cinematic_transition.rb`
+
+Run:
+
+```bash
+ruby examples/synth_pad.rb
+```
+
+## Development
+
+Install dependencies:
+
+```bash
+bundle install
+```
+
+Run tests:
+
+```bash
+bundle exec rspec
+bundle exec rake spec:coverage COVERAGE_MINIMUM=90
+```
+
+Generate/check docs:
+
+```bash
+bundle exec rake docs:examples
+bundle exec rake docs:yard
+YARD_MINIMUM=85 bundle exec rake docs:check
+bundle exec rake docs:all
+```
+
+Benchmarks:
+
+```bash
+bundle exec rake bench:wav_io
+bundle exec rake bench:dsp
+bundle exec rake bench:flac
+bundle exec rake bench:stream
+bundle exec rake bench:all
+```
+
+Release checks:
+
+```bash
+bundle exec rake release:check
+```
+
+## License
+
+Wavify is released under the MIT License.

data/Rakefile

@@ -0,0 +1,190 @@
+# frozen_string_literal: true
+
+require "bundler/gem_tasks"
+require "rspec/core/rake_task"
+require "rbconfig"
+
+RSpec::Core::RakeTask.new(:spec)
+
+namespace :spec do
+  desc "Generate audio fixtures from YAML definitions"
+  task :create_fixtures do
+    ruby = RbConfig.ruby
+    success = system(ruby, File.expand_path("tools/fixture_writer.rb", __dir__))
+    abort("fixture generation failed") unless success
+  end
+
+  desc "Run specs with SimpleCov coverage (set COVERAGE_MINIMUM=90 to enforce target)"
+  task :coverage do
+    ruby = RbConfig.ruby
+    env = { "COVERAGE" => "1" }
+    env["COVERAGE_MINIMUM"] = ENV["COVERAGE_MINIMUM"] if ENV["COVERAGE_MINIMUM"]
+    env["SIMPLECOV_BRANCH"] = ENV["SIMPLECOV_BRANCH"] if ENV["SIMPLECOV_BRANCH"]
+
+    success = system(env, ruby, "-S", "bundle", "exec", "rspec")
+    abort("coverage run failed") unless success
+  end
+end
+
+task default: :spec
+
+namespace :bench do
+  def run_benchmark_script(path)
+    ruby = RbConfig.ruby
+    success = system(ruby, File.expand_path(path, __dir__))
+    abort("benchmark failed: #{path}") unless success
+  end
+
+  desc "Run WAV I/O benchmark"
+  task :wav_io do
+    run_benchmark_script("benchmarks/wav_io_benchmark.rb")
+  end
+
+  desc "Run DSP effects benchmark"
+  task :dsp do
+    run_benchmark_script("benchmarks/dsp_effects_benchmark.rb")
+  end
+
+  desc "Run FLAC encode/decode benchmark"
+  task :flac do
+    run_benchmark_script("benchmarks/flac_benchmark.rb")
+  end
+
+  desc "Run streaming memory benchmark"
+  task :stream do
+    run_benchmark_script("benchmarks/streaming_memory_benchmark.rb")
+  end
+
+  desc "Run all benchmarks"
+  task all: %i[wav_io dsp flac stream]
+end
+
+namespace :docs do
+  def example_scripts
+    %w[
+      examples/format_convert.rb
+      examples/drum_machine.rb
+      examples/synth_pad.rb
+      examples/audio_processing.rb
+      examples/hybrid_arrangement.rb
+      examples/streaming_master_chain.rb
+      examples/cinematic_transition.rb
+    ].freeze
+  end
+
+  def run_ruby_script(path)
+    ruby = RbConfig.ruby
+    success = system(ruby, File.expand_path(path, __dir__))
+    abort("script failed: #{path}") unless success
+  end
+
+  desc "Generate YARD docs into doc/"
+  task :yard do
+    ruby = RbConfig.ruby
+    success = system(ruby, "-S", "bundle", "exec", "yard", "doc")
+    abort("yard doc failed") unless success
+  end
+
+  desc "Print YARD documentation coverage stats"
+  task :stats do
+    ruby = RbConfig.ruby
+    success = system(ruby, "-S", "bundle", "exec", "yard", "stats")
+    abort("yard stats failed") unless success
+  end
+
+  desc "Enforce minimum YARD documentation percentage (YARD_MINIMUM, default: 85)"
+  task :check do
+    ruby = RbConfig.ruby
+    minimum = ENV.fetch("YARD_MINIMUM", "85").to_f
+    output = IO.popen([ruby, "-S", "bundle", "exec", "yard", "stats"], chdir: __dir__, err: %i[child out], &:read)
+    puts output
+
+    match = output.match(/([0-9]+\.[0-9]+)% documented/)
+    abort("yard stats output did not include documentation percentage") unless match
+
+    percent = match[1].to_f
+    abort("documentation coverage #{percent}% is below minimum #{minimum}%") if percent < minimum
+
+    puts "docs check ok: #{percent}% >= #{minimum}%"
+  end
+
+  desc "Smoke-run all example scripts (self-contained demo mode)"
+  task :examples do
+    example_scripts.each do |script|
+      puts "== running #{script}"
+      run_ruby_script(script)
+    end
+  end
+
+  desc "Run docs-related checks and generators"
+  task all: %i[examples yard check]
+end
+
+namespace :release do
+  def load_release_spec!
+    spec = Gem::Specification.load(File.expand_path("wavify.gemspec", __dir__))
+    abort("failed to load wavify.gemspec") unless spec
+
+    spec
+  end
+
+  def assert_release_check!(condition, message)
+    return if condition
+
+    abort("release check failed: #{message}")
+  end
+
+  desc "Validate gemspec metadata and packaged file list"
+  task :check_gemspec do
+    spec = load_release_spec!
+
+    assert_release_check!(!spec.name.to_s.strip.empty?, "gemspec.name is empty")
+    assert_release_check!(!spec.version.to_s.strip.empty?, "gemspec.version is empty")
+    assert_release_check!(!spec.summary.to_s.strip.empty?, "gemspec.summary is empty")
+    assert_release_check!(!spec.description.to_s.strip.empty?, "gemspec.description is empty")
+    assert_release_check!(!spec.homepage.to_s.strip.empty?, "gemspec.homepage is empty")
+    assert_release_check!(!spec.license.to_s.strip.empty?, "gemspec.license is empty")
+    assert_release_check!(!spec.required_ruby_version.to_s.strip.empty?, "gemspec.required_ruby_version is empty")
+
+    required_metadata_keys = %w[allowed_push_host homepage_uri source_code_uri changelog_uri]
+    missing_metadata = required_metadata_keys.select { |key| spec.metadata[key].to_s.strip == "" }
+    assert_release_check!(missing_metadata.empty?, "missing gemspec metadata keys: #{missing_metadata.join(', ')}")
+
+    files = spec.files || []
+    assert_release_check!(files.include?("lib/wavify.rb"), "gemspec.files does not include lib/wavify.rb")
+    assert_release_check!(files.include?("README.md"), "gemspec.files does not include README.md")
+    assert_release_check!(files.any? { |f| ["LICENSE", "LICENSE.txt"].include?(f) }, "gemspec.files does not include license file")
+    assert_release_check!(files.none? { |f| f.start_with?(".idea/") }, ".idea files should not be packaged")
+
+    puts "release check ok: gemspec metadata and package file list"
+    puts "  name: #{spec.name}"
+    puts "  version: #{spec.version}"
+    puts "  packaged files: #{files.length}"
+  end
+
+  desc "Validate CHANGELOG structure and unreleased section"
+  task :check_changelog do
+    changelog_path = File.expand_path("CHANGELOG.md", __dir__)
+    assert_release_check!(File.file?(changelog_path), "CHANGELOG.md is missing")
+
+    changelog = File.read(changelog_path)
+    assert_release_check!(changelog.include?("## [Unreleased]"), "CHANGELOG.md must include an [Unreleased] section")
+    assert_release_check!(changelog.include?("Keep a Changelog"), "CHANGELOG.md should mention Keep a Changelog format")
+    has_standard_subsection = changelog.match?(/^### (Added|Changed|Fixed|Removed|Security)$/)
+    assert_release_check!(
+      has_standard_subsection,
+      "CHANGELOG.md should include at least one subsection heading"
+    )
+
+    puts "release check ok: CHANGELOG.md structure"
+  end
+
+  desc "Build gem package locally (same artifact as release flow)"
+  task :build_package do
+    Rake::Task["build"].reenable
+    Rake::Task["build"].invoke
+  end
+
+  desc "Run release readiness checks (changelog, gemspec, gem build)"
+  task check: %i[check_changelog check_gemspec build_package]
+end

data/benchmarks/README.md

@@ -0,0 +1,46 @@
+# Benchmarks
+
+This directory contains lightweight benchmark scripts for Wavify's core workflows.
+
+Implemented targets (incremental Phase 6 work):
+
+- `wav_io_benchmark.rb` - WAV read/write and streaming pipeline throughput
+- `dsp_effects_benchmark.rb` - DSP effects processing cost
+- `flac_benchmark.rb` - FLAC encode/decode and streaming throughput
+- `streaming_memory_benchmark.rb` - streaming pipeline memory behavior (sampled RSS)
+
+## Usage
+
+Run directly:
+
+```bash
+ruby benchmarks/wav_io_benchmark.rb
+ruby benchmarks/dsp_effects_benchmark.rb
+ruby benchmarks/flac_benchmark.rb
+ruby benchmarks/streaming_memory_benchmark.rb
+```
+
+Or via rake tasks:
+
+```bash
+rake bench:wav_io
+rake bench:dsp
+rake bench:flac
+rake bench:stream
+rake bench:all
+```
+
+## Environment Variables
+
+- `KEEP_BENCH_FILES=1` keeps generated files in `tmp/benchmarks/`
+- `WAV_IO_ITERATIONS`, `WAV_IO_DURATION`, `WAV_IO_CHUNK`
+- `DSP_BENCH_ITERATIONS`, `DSP_BENCH_DURATION`
+- `FLAC_BENCH_ITERATIONS`, `FLAC_BENCH_DURATION`, `FLAC_BENCH_CHUNK`
+- `STREAM_BENCH_DURATION`, `STREAM_BENCH_CHUNK`
+
+## Notes
+
+- OGG Vorbis audio decode is still incomplete, so it is not benchmarked yet.
+- `flac_benchmark.rb` measures the current pure Ruby FLAC implementation (verbatim/fixed subframe selection).
+- `streaming_memory_benchmark.rb` reports sampled RSS (`ps`) as an approximation, not a strict peak profiler.
+- `wav_io_benchmark.rb` optionally compares WAV read/write throughput with the `wavefile` gem when it is installed (`gem install wavefile`).