source_monitor 0.3.1 → 0.3.2

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: b8348a9154458260c8b6a3c3dfdeea65e8327b9d7a48dd6c1a2fbe36f9f1bf46
-  data.tar.gz: 2d56c477bc1191f4f505645f9f9f23fceaa1f15d1fd065e5032ac2d40ae3c0d3
+  metadata.gz: 24dc578d91173b255c4d1a4ecc7d85542c5c2a86daabac9ee779b73c4f012ed5
+  data.tar.gz: 43f2ae2005109c50a5c3298c315a48092926411e02a8a4715459e39304324e14
 SHA512:
-  metadata.gz: 5f875810a4a5e53aae8ec0609e0ab86a3a97ba8661826de6dcd8cf3abd3091f3e4838d8c301ed0f962da0c5849123f8a1fa7c2614e5341126753a8556a0d6fce
-  data.tar.gz: 50a7007476a9b989af9bfe989bc758a9febbc80478c541995044e1a6fd55fe54736520f643ca00845de57a4d5fc5ccfe1d83dd7994affff7530a3cd692f6fb96
+  metadata.gz: 640830590b4e1638b0fd2e90c337f49f41c788948abd7a2552338a15e80b13560da320d449ec55fad12a6a9724916af2e1a0942129ca396e9c11f0ddb3abcc89
+  data.tar.gz: 5dae4fbfe5864a33fd2895a275f2511d014e5a94ccf49a19bc1f4d0c284bd9045a561c003e945fec3acf9565b116f868616c45566310857675f3b02d3768f0e8

data/.vbw-planning/.notification-log.jsonl

@@ -244,3 +244,51 @@
   "title": "",
   "message": "Claude Code needs your approval for the plan"
 }
+{
+  "timestamp": "2026-02-11T05:06:47Z",
+  "type": "idle_prompt",
+  "title": "",
+  "message": "Claude is waiting for your input"
+}
+{
+  "timestamp": "2026-02-11T05:08:54Z",
+  "type": "idle_prompt",
+  "title": "",
+  "message": "Claude is waiting for your input"
+}
+{
+  "timestamp": "2026-02-11T05:11:34Z",
+  "type": "idle_prompt",
+  "title": "",
+  "message": "Claude is waiting for your input"
+}
+{
+  "timestamp": "2026-02-11T05:14:10Z",
+  "type": "idle_prompt",
+  "title": "",
+  "message": "Claude is waiting for your input"
+}
+{
+  "timestamp": "2026-02-11T05:15:43Z",
+  "type": "idle_prompt",
+  "title": "",
+  "message": "Claude is waiting for your input"
+}
+{
+  "timestamp": "2026-02-11T05:20:49Z",
+  "type": "idle_prompt",
+  "title": "",
+  "message": "Claude is waiting for your input"
+}
+{
+  "timestamp": "2026-02-11T05:24:55Z",
+  "type": "idle_prompt",
+  "title": "",
+  "message": "Claude is waiting for your input"
+}
+{
+  "timestamp": "2026-02-11T05:35:24Z",
+  "type": "idle_prompt",
+  "title": "",
+  "message": "Claude is waiting for your input"
+}

data/.vbw-planning/.session-log.jsonl

@@ -990,3 +990,387 @@
     "other": 89
   }
 }
+{
+  "timestamp": "2026-02-11T05:05:47Z",
+  "duration_ms": 0,
+  "cost_usd": 0,
+  "tokens_in": 0,
+  "tokens_out": 0,
+  "model": "unknown",
+  "branch": "chore/dependency-updates"
+}
+{
+  "timestamp": "2026-02-11T05:05:47Z",
+  "type": "cost_summary",
+  "costs": {
+    "other": 380
+  }
+}
+{
+  "timestamp": "2026-02-11T05:07:54Z",
+  "duration_ms": 0,
+  "cost_usd": 0,
+  "tokens_in": 0,
+  "tokens_out": 0,
+  "model": "unknown",
+  "branch": "chore/dependency-updates"
+}
+{
+  "timestamp": "2026-02-11T05:07:54Z",
+  "type": "cost_summary",
+  "costs": {
+    "other": 51
+  }
+}
+{
+  "timestamp": "2026-02-11T05:10:33Z",
+  "duration_ms": 0,
+  "cost_usd": 0,
+  "tokens_in": 0,
+  "tokens_out": 0,
+  "model": "unknown",
+  "branch": "chore/dependency-updates"
+}
+{
+  "timestamp": "2026-02-11T05:10:33Z",
+  "type": "cost_summary",
+  "costs": {
+    "other": 59
+  }
+}
+{
+  "timestamp": "2026-02-11T05:13:09Z",
+  "duration_ms": 0,
+  "cost_usd": 0,
+  "tokens_in": 0,
+  "tokens_out": 0,
+  "model": "unknown",
+  "branch": "chore/dependency-updates"
+}
+{
+  "timestamp": "2026-02-11T05:13:09Z",
+  "type": "cost_summary",
+  "costs": {
+    "other": 25
+  }
+}
+{
+  "timestamp": "2026-02-11T05:14:42Z",
+  "duration_ms": 0,
+  "cost_usd": 0,
+  "tokens_in": 0,
+  "tokens_out": 0,
+  "model": "unknown",
+  "branch": "chore/dependency-updates"
+}
+{
+  "timestamp": "2026-02-11T05:14:42Z",
+  "type": "cost_summary",
+  "costs": {
+    "other": 17
+  }
+}
+{
+  "timestamp": "2026-02-11T05:19:49Z",
+  "duration_ms": 0,
+  "cost_usd": 0,
+  "tokens_in": 0,
+  "tokens_out": 0,
+  "model": "unknown",
+  "branch": "chore/dependency-updates"
+}
+{
+  "timestamp": "2026-02-11T05:19:49Z",
+  "type": "cost_summary",
+  "costs": {
+    "other": 23
+  }
+}
+{
+  "timestamp": "2026-02-11T05:21:52Z",
+  "duration_ms": 0,
+  "cost_usd": 0,
+  "tokens_in": 0,
+  "tokens_out": 0,
+  "model": "unknown",
+  "branch": "chore/dependency-updates"
+}
+{
+  "timestamp": "2026-02-11T05:21:52Z",
+  "type": "cost_summary",
+  "costs": {
+    "other": 6
+  }
+}
+{
+  "timestamp": "2026-02-11T05:22:48Z",
+  "duration_ms": 0,
+  "cost_usd": 0,
+  "tokens_in": 0,
+  "tokens_out": 0,
+  "model": "unknown",
+  "branch": "main"
+}
+{
+  "timestamp": "2026-02-11T05:22:48Z",
+  "type": "cost_summary",
+  "costs": {
+    "other": 32
+  }
+}
+{
+  "timestamp": "2026-02-11T05:23:55Z",
+  "duration_ms": 0,
+  "cost_usd": 0,
+  "tokens_in": 0,
+  "tokens_out": 0,
+  "model": "unknown",
+  "branch": "main"
+}
+{
+  "timestamp": "2026-02-11T05:23:55Z",
+  "type": "cost_summary",
+  "costs": {
+    "other": 52
+  }
+}
+{
+  "timestamp": "2026-02-11T05:28:15Z",
+  "duration_ms": 0,
+  "cost_usd": 0,
+  "tokens_in": 0,
+  "tokens_out": 0,
+  "model": "unknown",
+  "branch": "main"
+}
+{
+  "timestamp": "2026-02-11T05:28:15Z",
+  "type": "cost_summary",
+  "costs": {
+    "other": 164
+  }
+}
+{
+  "timestamp": "2026-02-11T05:29:11Z",
+  "duration_ms": 0,
+  "cost_usd": 0,
+  "tokens_in": 0,
+  "tokens_out": 0,
+  "model": "unknown",
+  "branch": "main"
+}
+{
+  "timestamp": "2026-02-11T05:29:11Z",
+  "type": "cost_summary",
+  "costs": {
+    "other": 147
+  }
+}
+{
+  "timestamp": "2026-02-11T05:29:14Z",
+  "duration_ms": 0,
+  "cost_usd": 0,
+  "tokens_in": 0,
+  "tokens_out": 0,
+  "model": "unknown",
+  "branch": "main"
+}
+{
+  "timestamp": "2026-02-11T05:29:14Z",
+  "type": "cost_summary",
+  "costs": {
+    "other": 13
+  }
+}
+{
+  "timestamp": "2026-02-11T05:29:17Z",
+  "duration_ms": 0,
+  "cost_usd": 0,
+  "tokens_in": 0,
+  "tokens_out": 0,
+  "model": "unknown",
+  "branch": "main"
+}
+{
+  "timestamp": "2026-02-11T05:29:17Z",
+  "type": "cost_summary",
+  "costs": {
+    "other": 5
+  }
+}
+{
+  "timestamp": "2026-02-11T05:29:20Z",
+  "duration_ms": 0,
+  "cost_usd": 0,
+  "tokens_in": 0,
+  "tokens_out": 0,
+  "model": "unknown",
+  "branch": "main"
+}
+{
+  "timestamp": "2026-02-11T05:29:20Z",
+  "type": "cost_summary",
+  "costs": {
+    "other": 13
+  }
+}
+{
+  "timestamp": "2026-02-11T05:29:23Z",
+  "duration_ms": 0,
+  "cost_usd": 0,
+  "tokens_in": 0,
+  "tokens_out": 0,
+  "model": "unknown",
+  "branch": "main"
+}
+{
+  "timestamp": "2026-02-11T05:29:23Z",
+  "type": "cost_summary",
+  "costs": {
+    "other": 25
+  }
+}
+{
+  "timestamp": "2026-02-11T05:29:26Z",
+  "duration_ms": 0,
+  "cost_usd": 0,
+  "tokens_in": 0,
+  "tokens_out": 0,
+  "model": "unknown",
+  "branch": "main"
+}
+{
+  "timestamp": "2026-02-11T05:29:26Z",
+  "type": "cost_summary",
+  "costs": {
+    "other": 13
+  }
+}
+{
+  "timestamp": "2026-02-11T05:29:29Z",
+  "duration_ms": 0,
+  "cost_usd": 0,
+  "tokens_in": 0,
+  "tokens_out": 0,
+  "model": "unknown",
+  "branch": "main"
+}
+{
+  "timestamp": "2026-02-11T05:29:29Z",
+  "type": "cost_summary",
+  "costs": {
+    "other": 14
+  }
+}
+{
+  "timestamp": "2026-02-11T05:29:32Z",
+  "duration_ms": 0,
+  "cost_usd": 0,
+  "tokens_in": 0,
+  "tokens_out": 0,
+  "model": "unknown",
+  "branch": "main"
+}
+{
+  "timestamp": "2026-02-11T05:29:32Z",
+  "type": "cost_summary",
+  "costs": {
+    "other": 13
+  }
+}
+{
+  "timestamp": "2026-02-11T05:30:26Z",
+  "duration_ms": 0,
+  "cost_usd": 0,
+  "tokens_in": 0,
+  "tokens_out": 0,
+  "model": "unknown",
+  "branch": "main"
+}
+{
+  "timestamp": "2026-02-11T05:30:26Z",
+  "type": "cost_summary",
+  "costs": {
+    "other": 74
+  }
+}
+{
+  "timestamp": "2026-02-11T05:30:33Z",
+  "duration_ms": 0,
+  "cost_usd": 0,
+  "tokens_in": 0,
+  "tokens_out": 0,
+  "model": "unknown",
+  "branch": "main"
+}
+{
+  "timestamp": "2026-02-11T05:30:33Z",
+  "type": "cost_summary",
+  "costs": {
+    "other": 29
+  }
+}
+{
+  "timestamp": "2026-02-11T05:32:32Z",
+  "duration_ms": 0,
+  "cost_usd": 0,
+  "tokens_in": 0,
+  "tokens_out": 0,
+  "model": "unknown",
+  "branch": "docs/v0.3.2-documentation-updates"
+}
+{
+  "timestamp": "2026-02-11T05:32:32Z",
+  "type": "cost_summary",
+  "costs": {
+    "other": 66
+  }
+}
+{
+  "timestamp": "2026-02-11T05:34:23Z",
+  "duration_ms": 0,
+  "cost_usd": 0,
+  "tokens_in": 0,
+  "tokens_out": 0,
+  "model": "unknown",
+  "branch": "docs/v0.3.2-documentation-updates"
+}
+{
+  "timestamp": "2026-02-11T05:34:23Z",
+  "type": "cost_summary",
+  "costs": {
+    "other": 34
+  }
+}
+{
+  "timestamp": "2026-02-11T05:44:50Z",
+  "duration_ms": 0,
+  "cost_usd": 0,
+  "tokens_in": 0,
+  "tokens_out": 0,
+  "model": "unknown",
+  "branch": "docs/v0.3.2-documentation-updates"
+}
+{
+  "timestamp": "2026-02-11T05:44:50Z",
+  "type": "cost_summary",
+  "costs": {
+    "other": 69
+  }
+}
+{
+  "timestamp": "2026-02-11T05:45:40Z",
+  "duration_ms": 0,
+  "cost_usd": 0,
+  "tokens_in": 0,
+  "tokens_out": 0,
+  "model": "unknown",
+  "branch": "docs/v0.3.2-documentation-updates"
+}
+{
+  "timestamp": "2026-02-11T05:45:40Z",
+  "type": "cost_summary",
+  "costs": {
+    "other": 13
+  }
+}

data/AGENTS.md

@@ -1,13 +1,13 @@
 # Repository Guidelines
 
-refer to ./ai/project_overview.md for full scope of this project
+Refer to `CLAUDE.md` for project conventions and skills catalog.
 
-use rbenv for all ruby and bundler/gem commands, not the system ruby
+Use rbenv for all ruby and bundler/gem commands, not the system ruby.
 
 ## Contribution Workflow
 
 - Treat the engine like any external contributor would: no direct commits to `main`.
-- Before writing code, branch off the latest `origin/main` (use a descriptive `feature/` or `bugfix/` prefix) and open a draft PR on `github.com/dchuk/source_monitor` referencing the active `.ai/tasks.md` slice.
+- Before writing code, branch off the latest `origin/main` (use a descriptive `feature/` or `bugfix/` prefix) and open a draft PR on `github.com/dchuk/source_monitor`.
 - Push early and often to that branch so history stays visible; keep commits scoped and rebases local to your branch only.
 - Move the PR out of draft once tests pass and the slice is ready for review; request at least one review and wait for all CI jobs (lint, security, Rails tests + diff coverage) to succeed before merging.
 - The `test` job enforces diff coverage via `bin/check-diff-coverage`; if legitimate gaps remain after new code paths, refresh `config/coverage_baseline.json` by running `bin/test-coverage` followed by `bin/update-coverage-baseline` on the updated branch and commit the regenerated baseline.
@@ -59,7 +59,7 @@ Run `bin/setup` to install gems, prepare the dummy database, and compile Tailwin
 
 ## Coding Style & Naming Conventions
 
-Use two-space indentation and Ruby 3.3 syntax. Keep engine classes under the `SourceMonitor::` namespace; new modules should mirror their directory, e.g., `lib/source_monitor/fetching/pipeline.rb`. Favor service objects ending in `Service`, jobs ending in `Job`, and background channels ending in `Channel`. Rails defaults handle formatting, but run `bundle exec rubocop` (configured via `.rubocop.yml`) before opening a PR. For views, stick with ERB and Tailwind utility classes.
+Use two-space indentation and Ruby 4.0+ syntax. Keep engine classes under the `SourceMonitor::` namespace; new modules should mirror their directory, e.g., `lib/source_monitor/fetching/pipeline.rb`. Favor service objects ending in `Service`, jobs ending in `Job`, and background channels ending in `Channel`. Rails defaults handle formatting, but run `bundle exec rubocop` (configured via `.rubocop.yml`) before opening a PR. For views, stick with ERB and Tailwind utility classes.
 
 ## Testing Guidelines
 
@@ -67,66 +67,29 @@ MiniTest drives coverage (`test/models`, `test/controllers`, `test/system`). Nam
 
 ## Commit & Pull Request Guidelines
 
-Adopt imperative commit messages in the format `scope: action`, e.g., `sources: enforce URL normalization`. Group unrelated work into separate commits. PRs should describe context, summarise the slice delivered, list validation steps (`bin/rails test`, manual fetch run), and reference roadmap items from `.ai/tasks.md`. Include screenshots or console output when altering UI or background jobs. Request at least one review and ensure CI completes before merge.
+Adopt imperative commit messages in the format `scope: action`, e.g., `sources: enforce URL normalization`. Group unrelated work into separate commits. PRs should describe context, summarise the slice delivered, and list validation steps (`bin/rails test`, manual fetch run). Include screenshots or console output when altering UI or background jobs. Request at least one review and ensure CI completes before merge.
 
 ## Security & Configuration Tips
 
 Store secrets (API keys, webhook tokens) in `config/credentials/` and never commit plain-text values. When adding HTTP endpoints or webhooks, default to Solid Queue middleware for retries and respect the allowlist in `config/source_monitor.yml`. Document new environment variables in `config/application.yml.sample` and call out any migrations that impact host apps.
 
-# Clean coding guidelines
+## Clean Coding Principles
 
-Object Orientated Design: You should write code that embraces change. Here’s how…
+- **SRP**: Classes and methods should have a single responsibility.
+- **DRY**: Avoid duplication; changes should only need one edit.
+- **Depend on behaviour, not data**: Wrap instance variables in methods (`attr_reader`); use Struct for data structures.
+- **Minimise dependencies**: Use dependency injection, encapsulate external messages, prefer hash arguments.
+- **Depend on things that change less often than you do.**
 
-SRP: A class should do the smallest possible useful thing; it should have a single responsibility. A class that has more than one responsibility is difficult to reuse. SRP requires that a class be cohesive, that everything the class does be highly related to its purpose. A class that is easy to reuse will make the application easier to change.
+## Claude Code Skills
 
-Methods, like classes, should have a single responsibility. All of the same reasons apply, having just one responsibility makes them easy to change and easy to reuse.
+SourceMonitor ships 14 engine-specific Claude Code skills (`sm-*` prefix) covering the domain model, configuration DSL, pipeline stages, testing conventions, and more. Skills are distributed with the gem and installed into `.claude/skills/` via rake tasks:
 
-DRY: DRY code tolerates change because any change in behaviour can be made by changing code in just one place.
+```bash
+bin/rails source_monitor:skills:install        # Consumer skills (host app integration)
+bin/rails source_monitor:skills:contributor     # Contributor skills (engine development)
+bin/rails source_monitor:skills:all            # All skills
+bin/rails source_monitor:skills:remove         # Remove all sm-* skills
+```
 
-Depend on behaviour not data:
-
-Hide instance variables by wrapping them in a method, an attr_reader. The method changes a variable from data ( which is referenced all over) to behaviour (which is defined once). This means if you need to adjust the data you only have to make a change in one place.
-
-Hide data structures using the Struct class.
-
-Minimise Dependencies: An object depends on another object if, when one object changes, the other might be forced to change in turn. An object has a dependency when it knows:
-
-The name of another class.
-
-The name of a message that it intends to send to someone other than self.
-
-The arguments that a message requires.
-
-The order of those arguments.
-
-Dependency Injection: Addresses the first dependency. It decouples two objects by moving the creation of object_A outside of object_B eg:
-
-object_A.new(1,2,object_B.new)
-
-Encapsulation: Addresses the second dependency. Create wrapper methods so that external messages are isolated in one place. The wrapper method is called throughout the class, rather than sending messages externally.
-
-Use hashes for initialization arguments: this addresses the final dependencies.
-
-Depend on things that change less often than you do
-
-## Agent Notes (2025-10-08)
-
-- Finished roadmap section 05.03 (structured fetch error handling). Added `SourceMonitor::Fetching::FetchError` hierarchy, expanded `FeedFetcher` error handling, and ensured instrumentation payloads include success/error context.
-- Fetch attempts now always create `FetchLog` records and update `Source` failure state; added MiniTest coverage for timeout, HTTP 404, and malformed feed scenarios.
-- Relevant tests: `bundle exec rails test test/lib/source_monitor/fetching/feed_fetcher_test.rb` and full suite via `bundle exec rails test` (both passing).
-- Next roadmap item is 05.04 (not started). Untracked tmp dir `test/lib/tmp` can be safely ignored if it reappears.
-
-## Agent Notes (2025-10-09)
-
-- Introduced `SourceMonitor::Scrapers::Base`, establishing the scraper adapter contract and Result object. Subclasses merge default, source, and invocation settings (HashWithIndifferentAccess) and must return a Result with status/html/content/metadata. Use `SourceMonitor::Scrapers::Base.call(item:, source:, settings:, http:)` to execute adapters.
-- Added Readability scraper adapter leveraging SourceMonitor::HTTP, Nokolexbor, and ruby-readability. Supports override selectors via `scrape_settings[:selectors]`, records extraction metadata including strategy and inferred status, and returns structured failure results on HTTP errors.
-- Extracted scraper HTTP fetching and parsing into dedicated collaborators (`SourceMonitor::Scrapers::Fetchers::HttpFetcher` and `SourceMonitor::Scrapers::Parsers::ReadabilityParser`). The adapter now orchestrates these services, simplifying future parser additions while keeping failure metadata consistent.
-- Added Readability scraper adapter leveraging SourceMonitor::HTTP, Nokolexbor, and ruby-readability. Supports override selectors via `scrape_settings[:selectors]`, records extraction metadata including strategy and inferred status, and returns structured failure results on HTTP errors.
-- Phase 07.03 complete: introduced `SourceMonitor::ItemContent` table with one-to-one association, virtual accessors on `Item`, and migration that backfills existing scraped data while dropping legacy columns. Clearing both fields now removes the content row. Run `bundle exec rails db:migrate` in host apps after upgrading.
-- Phase 07.04 complete: added `SourceMonitor::Scraping::ItemScraper` service with log recording, manual scrape controls in the item admin, and a dedicated scraping configuration section on the source form. Item show page now highlights content comparisons, status badges, and recent scrape errors. System coverage updated to exercise the manual scraping flow.
-- Phase 08.02 complete: created `SourceMonitor::FetchFeedJob`, introduced `SourceMonitor::Fetching::FetchRunner` with Postgres advisory locking, and added a temporary `ScrapeItemJob` stub so new items from auto-scrape sources are queued with `scrape_status` set to `pending`. Manual fetch UI now reuses the runner, and tests cover job retry behavior plus follow-up scraping enqueue (`bundle exec rails test test/lib/source_monitor/fetching/fetch_runner_test.rb`, `bundle exec rails test test/jobs/source_monitor/fetch_feed_job_test.rb`, and `bundle exec rails test test/lib/source_monitor/fetching/feed_fetcher_test.rb`).
-- Phase 08.03 complete: implemented `SourceMonitor::Scraping::Enqueuer` with deduplication/auto-scrape guards, promoted `SourceMonitor::ScrapeItemJob` to execute `ItemScraper`, and updated the manual item view to enqueue jobs instead of running scrapes inline. Added unit coverage for the enqueuer/job plus refreshed the manual scrape system test (`bundle exec rails test test/lib/source_monitor/scraping/enqueuer_test.rb test/jobs/source_monitor/scrape_item_job_test.rb test/system/items_test.rb test/lib/source_monitor/fetching/fetch_runner_test.rb`).
-- Phase 08.04 complete: manual "Fetch Now" now queues `FetchFeedJob` via `FetchRunner.enqueue`, dashboard shows live queue metrics from `SourceMonitor::Jobs::Visibility`, and optional Mission Control link appears when configured. System tests updated to assert job enqueues (`test/system/sources_test.rb`, `test/system/items_test.rb`, `test/system/dashboard_test.rb`); run `bundle exec rails test test/system` after UI tweaks.
-- Install generator now also creates `config/initializers/source_monitor.rb` with documented defaults for queue settings, metrics, and Mission Control hooks. Update the initializer if future configuration options are added.
-- `SourceMonitor.mission_control_dashboard_path` now validates that the configured path exists before rendering a dashboard link, preventing 404s when Mission Control isn't mounted yet. Template comments outline how to mount the engine when enabling it.
-- `test/dummy/bin/dev` now runs the Rails server with `BUNDLE_GEMFILE` pointing at the dummy app, so dummy-only gems (like mission_control-jobs) load correctly while the Tailwind watcher still uses the engine's Gemfile.
+See `CLAUDE.md` for the full skills catalog and usage details.

data/CHANGELOG.md

@@ -15,6 +15,16 @@ All notable changes to this project are documented below. The format follows [Ke
 
 - No unreleased changes yet.
 
+## [0.3.2] - 2026-02-10
+
+### Fixed
+
+- Updated README, AGENTS.md, CONTRIBUTING.md, and docs/ to reflect v0.3.1 changes (Ruby 4.0+, gem version refs, skills system documentation).
+- Replaced stale `.ai/` references with `CLAUDE.md` and `AGENTS.md` across all docs.
+- Corrected `SOURCE_MONITOR_TEST_WORKERS` env var to `PARALLEL_WORKERS` in CONTRIBUTING.md.
+- Removed historical agent development notes from AGENTS.md.
+- Condensed verbose clean coding guidelines into concise bullet summary.
+
 ## [0.3.1] - 2026-02-10
 
 ### Added

data/CLAUDE.md

@@ -45,7 +45,7 @@ Run /vbw:help for all commands.
 
 | Layer | Technology |
 |-------|------------|
-| Ruby | 3.4+ |
+| Ruby | 4.0+ |
 | Rails | 8.x |
 | Testing | Minitest (no fixtures -- uses factory helpers + WebMock/VCR) |
 | Authorization | Host app responsibility (mountable engine) |

data/CONTRIBUTING.md

@@ -4,7 +4,7 @@ This project ships each roadmap slice behind a fast, reliable test loop. The not
 
 ## Test Suite Expectations
 
-- **Fast feedback:** run `bundle exec rake app:test:smoke` for unit, helper, and job coverage before pushing. Use `SOURCE_MONITOR_TEST_WORKERS=1` locally when profiling failures for determinism.
+- **Fast feedback:** run `bundle exec rake app:test:smoke` for unit, helper, and job coverage before pushing. Use `PARALLEL_WORKERS=1` locally when profiling failures for determinism.
 - **Full validation:** continue to run `bundle exec rails test` (or `bin/test-coverage` in CI) before marking a slice ready for review.
 - **Background jobs:** the default adapter is `:test`. Switch to inline execution only for the precise block that needs it via `with_inline_jobs { ... }`; never flip the global adapter.
 - **Database usage:** prefer transactional fixtures over manual `delete_all`. Reach for `setup_once` (TestProf’s `before_all`) when immutable data can be shared safely across examples.
@@ -13,16 +13,16 @@ This project ships each roadmap slice behind a fast, reliable test loop. The not
 ## Performance Profiling
 
 - **Local commands:**
-  - `TAG_PROF=type SOURCE_MONITOR_TEST_WORKERS=1 bundle exec rails test`
-  - `EVENT_PROF=sql.active_record SOURCE_MONITOR_TEST_WORKERS=1 bundle exec rails test`
-  - `TEST_STACK_PROF=1 SOURCE_MONITOR_TEST_WORKERS=1 bundle exec rails test test/integration`
+  - `TAG_PROF=type PARALLEL_WORKERS=1 bundle exec rails test`
+  - `EVENT_PROF=sql.active_record PARALLEL_WORKERS=1 bundle exec rails test`
+  - `TEST_STACK_PROF=1 PARALLEL_WORKERS=1 bundle exec rails test test/integration`
 - **CI automation:** a scheduled `profiling` workflow runs the commands above nightly, archives `tmp/test_prof`, and applies guardrails via `bin/check-test-prof-metrics` (suite ≤ 80s, integration ≤ 35s, DB time ≤ 5s). Failures block the job so regressions surface quickly.
 
 ## Code Review Checklist
 
 Before approval, verify that the changes:
 
-1. Avoid unnecessary database persistence (`build_stubbed`/test doubles over `.create` when assertions allow).
+1. Avoid unnecessary database persistence (test doubles over `.create` when assertions allow).
 2. Share heavy setup with `setup_once` or helper memoization instead of per-test rebuilds.
 3. Scope inline job execution to `with_inline_jobs { ... }` blocks—no suite-wide adapter swaps.
 4. Keep new or modified system specs lean, relying on lower-level coverage when UI is not essential.

data/Gemfile.lock

@@ -1,7 +1,7 @@
 PATH
   remote: .
   specs:
-    source_monitor (0.3.1)
+    source_monitor (0.3.2)
       cssbundling-rails (~> 1.4)
       faraday (~> 2.9)
       faraday-follow_redirects (~> 0.4)

data/README.md

@@ -9,8 +9,8 @@ SourceMonitor is a production-ready Rails 8 mountable engine for ingesting, norm
 In your host Rails app:
 
 ```bash
-bundle add source_monitor --version "~> 0.1.2"
-# or add `gem "source_monitor", "~> 0.1.2"` manually, then run:
+bundle add source_monitor --version "~> 0.3.1"
+# or add `gem "source_monitor", "~> 0.3.1"` manually, then run:
 bundle install
 ```
 
@@ -25,7 +25,7 @@ This exposes `bin/source_monitor` (via Bundler binstubs) so you can run the guid
 - First-class observability through ActiveSupport notifications and `SourceMonitor::Metrics` counters/gauges
 
 ## Requirements
-- Ruby 3.4.4 (we recommend [rbenv](https://github.com/rbenv/rbenv) for local development: `rbenv install 3.4.4 && rbenv local 3.4.4`, but use whatever Ruby version manager suits your environment—asdf, chruby, rvm, or container-based workflows all work fine)
+- Ruby 4.0+ (we recommend [rbenv](https://github.com/rbenv/rbenv) for local development, but use whatever Ruby version manager suits your environment—asdf, chruby, rvm, or container-based workflows all work fine)
 - Rails ≥ 8.0.2.1 in the host application
 - PostgreSQL 13+ (engine migrations use JSONB, SKIP LOCKED, advisory locks, and Solid Cable tables)
 - Node.js 18+ (npm or Yarn) for asset linting and the Tailwind/esbuild bundling pipeline
@@ -41,7 +41,7 @@ This exposes `bin/source_monitor` (via Bundler binstubs) so you can run the guid
 Before running any SourceMonitor commands inside your host app, add the gem and install dependencies:
 
 ```bash
-bundle add source_monitor --version "~> 0.1.2"
+bundle add source_monitor --version "~> 0.3.1"
 # or edit your Gemfile, then run
 bundle install
 ```
@@ -111,6 +111,19 @@ The generated initializer documents every setting. Key areas:
 
 See [docs/configuration.md](docs/configuration.md) for exhaustive coverage and examples.
 
+## Claude Code Skills
+
+SourceMonitor ships 14 engine-specific Claude Code skills (`sm-*` prefix) that give AI agents deep context about the engine's domain model, configuration DSL, pipeline stages, and testing conventions. Skills are bundled with the gem and installed into your host app's `.claude/skills/` directory.
+
+```bash
+bin/rails source_monitor:skills:install        # Consumer skills (host app integration)
+bin/rails source_monitor:skills:contributor     # Contributor skills (engine development)
+bin/rails source_monitor:skills:all            # All skills
+bin/rails source_monitor:skills:remove         # Remove all sm-* skills
+```
+
+The guided installer (`bin/source_monitor install`) also offers to install consumer skills as part of the setup workflow.
+
 ## Deployment Considerations
 - Copy engine migrations before every deploy and run `bin/rails db:migrate`.
 - Precompile assets so SourceMonitor's bundled CSS/JS outputs are available at runtime.
@@ -130,7 +143,7 @@ Common installation and runtime issues (missing migrations, realtime not streami
 - Quality checks: `bin/rubocop`, `bin/brakeman --no-pager`, `bin/lint-assets`.
 - Record HTTP fixtures with VCR under `test/vcr_cassettes/` and keep coverage ≥ 90% for new code.
 
-Contributions follow the clean architecture and TDD guidelines in `.ai/project_overview.md`. Review `.ai/tasks.md` to align with the active roadmap slice before opening a pull request.
+Contributions follow the clean architecture and TDD guidelines in `CLAUDE.md` and `AGENTS.md`.
 
 ## License
 SourceMonitor is released under the [MIT License](MIT-LICENSE).

data/VERSION

@@ -0,0 +1 @@
+0.3.2

data/docs/deployment.md

@@ -60,7 +60,7 @@ Keep this guide alongside your platform runbooks so teams can confidently deploy
 
 ## Container Reference Stack
 
-The repository ships a reusable Docker stack under `examples/docker` that mirrors the recommended process model. It builds a Ruby 3.3 image with Node, mounts your generated example via `APP_PATH`, and launches three services (`web`, `worker`, `scheduler`) alongside Postgres and Redis. Use it to trial production settings locally or as a baseline for ECS/Kubernetes manifests.
+The repository ships a reusable Docker stack under `examples/docker` that mirrors the recommended process model. It builds a Ruby 4.0 image with Node, mounts your generated example via `APP_PATH`, and launches three services (`web`, `worker`, `scheduler`) alongside Postgres and Redis. Use it to trial production settings locally or as a baseline for ECS/Kubernetes manifests.
 
 ## Setup Workflow Rollout Checklist
 

data/docs/setup.md

@@ -6,8 +6,8 @@ This guide consolidates the new guided installer, verification commands, and rol
 
 | Requirement | Minimum | Notes |
 | --- | --- | --- |
-| Ruby | 3.4.4 | Use rbenv and match the engine's `.ruby-version`. |
-| Rails | 8.0.2.1 | Run `bin/rails about` inside the host to confirm. |
+| Ruby | 4.0.1 | Use rbenv and match the engine's `.ruby-version`. |
+| Rails | 8.1.2 | Run `bin/rails about` inside the host to confirm. |
 | PostgreSQL | 14+ | Required for Solid Queue tables and item storage. |
 | Node.js | 18+ | Needed for Tailwind/esbuild assets when the host owns node tooling. |
 | Background jobs | Solid Queue (>= 0.3, < 3.0) | Add `solid_queue` to the host Gemfile if not present. |
@@ -18,8 +18,8 @@ This guide consolidates the new guided installer, verification commands, and rol
 Run these commands inside your host Rails application before invoking the guided workflow:
 
 ```bash
-bundle add source_monitor --version "~> 0.1.2"
-# or add gem "source_monitor", "~> 0.1.2" to Gemfile manually
+bundle add source_monitor --version "~> 0.3.1"
+# or add gem "source_monitor", "~> 0.3.1" to Gemfile manually
 bundle install
 ```
 

data/lib/source_monitor/setup/skills_installer.rb

@@ -0,0 +1,94 @@
+# frozen_string_literal: true
+
+require "fileutils"
+require "pathname"
+
+module SourceMonitor
+  module Setup
+    class SkillsInstaller
+      SM_SKILL_PATTERN = "sm-*"
+
+      CONSUMER_SKILLS = %w[
+        sm-host-setup sm-configure sm-scraper-adapter
+        sm-event-handler sm-model-extension sm-dashboard-widget
+      ].freeze
+
+      CONTRIBUTOR_SKILLS = %w[
+        sm-domain-model sm-architecture sm-engine-test
+        sm-configuration-setting sm-pipeline-stage sm-engine-migration
+        sm-job sm-health-rule
+      ].freeze
+
+      def initialize(gem_root: nil, output: $stdout)
+        @gem_root = Pathname.new(gem_root || resolve_gem_root)
+        @output = output
+      end
+
+      def install(target_dir:, group: :consumer)
+        target = Pathname.new(target_dir)
+        result = { installed: [], skipped: [] }
+
+        source_skills_dir = gem_root.join(".claude", "skills")
+        return result unless source_skills_dir.directory?
+
+        skill_dirs = Dir[source_skills_dir.join(SM_SKILL_PATTERN).to_s].sort
+        return result if skill_dirs.empty?
+
+        allowed = skills_for_group(group)
+        skill_dirs = skill_dirs.select { |path| allowed.include?(File.basename(path)) }
+        return result if skill_dirs.empty?
+
+        FileUtils.mkdir_p(target.to_s)
+
+        skill_dirs.each do |source_path|
+          skill_name = File.basename(source_path)
+          dest_path = target.join(skill_name)
+
+          if dest_path.directory?
+            result[:skipped] << skill_name
+          else
+            FileUtils.cp_r(source_path, dest_path.to_s)
+            result[:installed] << skill_name
+          end
+        end
+
+        result
+      end
+
+      def remove(target_dir:)
+        target = Pathname.new(target_dir)
+        result = { removed: [] }
+
+        return result unless target.directory?
+
+        Dir[target.join(SM_SKILL_PATTERN).to_s].sort.each do |path|
+          skill_name = File.basename(path)
+          FileUtils.rm_rf(path)
+          result[:removed] << skill_name
+        end
+
+        result
+      end
+
+      private
+
+      attr_reader :gem_root, :output
+
+      def skills_for_group(group)
+        case group
+        when :consumer then CONSUMER_SKILLS
+        when :contributor then CONTRIBUTOR_SKILLS
+        when :all then CONSUMER_SKILLS + CONTRIBUTOR_SKILLS
+        else raise ArgumentError, "Unknown skill group: #{group.inspect}. Use :consumer, :contributor, or :all"
+        end
+      end
+
+      def resolve_gem_root
+        spec = Gem.loaded_specs["source_monitor"]
+        return spec.gem_dir if spec
+
+        File.expand_path("../../..", __dir__)
+      end
+    end
+  end
+end

data/lib/source_monitor/version.rb

@@ -1,5 +1,5 @@
 # frozen_string_literal: true
 
 module SourceMonitor
-  VERSION = "0.3.1"
+  VERSION = "0.3.2"
 end

metadata

@@ -1,7 +1,7 @@
 --- !ruby/object:Gem::Specification
 name: source_monitor
 version: !ruby/object:Gem::Version
-  version: 0.3.1
+  version: 0.3.2
 platform: ruby
 authors:
 - dchuk
@@ -395,6 +395,7 @@ files:
 - MIT-LICENSE
 - README.md
 - Rakefile
+- VERSION
 - app/assets/builds/.keep
 - app/assets/builds/source_monitor/application.css
 - app/assets/builds/source_monitor/application.js
@@ -642,6 +643,7 @@ files:
 - lib/source_monitor/setup/prompter.rb
 - lib/source_monitor/setup/requirements.rb
 - lib/source_monitor/setup/shell_runner.rb
+- lib/source_monitor/setup/skills_installer.rb
 - lib/source_monitor/setup/verification/action_cable_verifier.rb
 - lib/source_monitor/setup/verification/printer.rb
 - lib/source_monitor/setup/verification/result.rb