assistant 1.0.0.rc1 → 1.0.0

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: 6b4eab141f258e58024dcc2805a4030321835b45853cf915d8a8c48aa9849144
-  data.tar.gz: 354914c47054404c57ef636d46316e0ee8cb491305ab9c081a0628e4a30708c5
+  metadata.gz: 4af2f1a745032c7fbb585be6304666cac17ba354acddb8a2c85848bac669a7f4
+  data.tar.gz: fc6e2546b5616515ab4064edcbda0152fbaec2a313a68bec1faf950a3b8f25d4
 SHA512:
-  metadata.gz: ced1f45ddcc684272b2858aebead07ee968823cdf0c52bf71877cf283b1881fec66e59b7f9c56538d5c9ba949abac3c425083c1334947bc0572235dea1ed0b92
-  data.tar.gz: 64bde79e3880ac363fc31e0d37dcae5e4e3657ec4f55807385378e3f59699fb211204a1fdf8339d4e8dc9e5d4ce8dad1bb71e82d5c6b845c1697dbc136cc99ba
+  metadata.gz: 797efe6b774b1491c995faa2c80e175c4ed27285addb1bb64ea263f877ced07ff2c922ebe57c7bd8bb2fd685f76b8f73b799b11b9cb15169047fdb9cf0ad705e
+  data.tar.gz: ede35de6de5232c25cb44d406cf33fccf5a3dd3ee8a6ae160e8fc1c9ebed4822f0b456223b0e208081e8ebc383413a4d561f00bf6830dc1b42a6b2631d5743e6

data/.github/workflows/docs.yml

@@ -1,22 +1,21 @@
 ---
 name: Docs
 
+# Docsify is a client-side SPA: there is no build step. We upload the
+# raw `docs/` tree as the Pages artifact and let docsify fetch markdown
+# files at runtime. `docs/.nojekyll` tells GitHub to skip its own
+# Jekyll pre-processor on the artifact.
+
 on:
   push:
     branches: [main]
     paths:
       - docs/**
-      - _config.yml
-      - Gemfile
-      - Gemfile.lock
       - .github/workflows/docs.yml
   pull_request:
     branches: [main]
     paths:
       - docs/**
-      - _config.yml
-      - Gemfile
-      - Gemfile.lock
       - .github/workflows/docs.yml
   workflow_dispatch:
 
@@ -28,28 +27,19 @@ concurrency:
   cancel-in-progress: false
 
 jobs:
-  build:
-    name: jekyll build --strict_front_matter
+  upload:
+    name: Upload docs/ artifact
     runs-on: ubuntu-latest
-    env:
-      BUNDLE_WITH: docs
-      JEKYLL_ENV: production
     steps:
       - uses: actions/checkout@v4
-      - uses: ruby/setup-ruby@v1
-        with:
-          ruby-version: '3.4'
-          bundler-cache: true
-      - name: Build site
-        run: bundle exec jekyll build --strict_front_matter --baseurl "/assistant"
       - name: Upload site artifact
         uses: actions/upload-pages-artifact@v3
         with:
-          path: _site
+          path: docs
 
   deploy:
     name: Deploy to GitHub Pages
-    needs: build
+    needs: upload
     if: github.event_name == 'push' && github.ref == 'refs/heads/main'
     runs-on: ubuntu-latest
     permissions:

data/.gitignore

@@ -4,9 +4,6 @@
 /coverage/
 /doc/
 /pkg/
-/_site/
-/.jekyll-cache/
-/.jekyll-metadata
 /spec/reports/
 /tmp/
 

data/CHANGELOG.md

@@ -8,36 +8,13 @@ and this project adheres to [Semantic Versioning](https://semver.org/spec/v2.0.0
 
 ## [Unreleased]
 
-### Added
+## [1.0.0] - 2026-06-16
+
+### Documentation
 
-- **GitHub Pages — P2 scaffolding (Jekyll + just-the-docs)**: stood up
-  the parallel docs site per
-  [`docs/v1/08-github-pages.md`](docs/v1/08-github-pages.md). Ships
-  `_config.yml` (just-the-docs theme, Lunr search, dark-mode toggle,
-  `gh_edit_link`, `jekyll-seo-tag` + `jekyll-relative-links` plugins),
-  an optional `:docs` Bundler group in [`Gemfile`](Gemfile) pinning
-  `jekyll ~> 4.3`, `just-the-docs ~> 0.10`, and
-  `jekyll-relative-links ~> 0.7`, the
-  [`.github/workflows/docs.yml`](.github/workflows/docs.yml) workflow
-  (PR builds `bundle exec jekyll build --strict_front_matter`; pushes
-  to `main` deploy via `actions/deploy-pages@v4`), `docs:install` /
-  `docs:build` / `docs:serve` Rake tasks driving the Jekyll
-  toolchain, per-page front matter on every site page (Home, Getting
-  started, Guides + 5 sub-pages, API reference, Deprecations, Examples
-  + 7 sub-pages, Roadmap, Changelog), and a new `docs/guides/index.md`
-  landing for the Guides section. The site builds locally with `rake
-  docs:build` and deploys to `https://ramongr.github.io/assistant/` on
-  every push to `main`. Pages source = `GitHub Actions` was enabled in
-  repo settings after the original mkdocs PR (#177) merged; no further
-  manual step is needed for the Jekyll cut-over.
-
-  _This entry supersedes the original mkdocs-based P2 scaffolding —
-  the mkdocs stack lived for one PR before being replaced with Jekyll
-  to match the gem's primary toolchain, drop the Python build
-  dependency, and avoid the `Pygments==2.19.1` pin that worked around
-  a 2.20.0 `HtmlFormatter` regression._
-
-## [1.0.0.rc1] - 2026-06-15
+- Published a public docs site with getting started, API reference, guides,
+  examples, search, dark mode, copy buttons, and diagrams.
+- Polished docs navigation, anchors, routing, and light-mode readability.
 
 ### Added
 
@@ -75,14 +52,14 @@ and this project adheres to [Semantic Versioning](https://semver.org/spec/v2.0.0
   soft-fail semantics, the uniform result shape, the RBS / Steep
   posture, and the zero-runtime-deps guarantee. Added
   `spec.metadata['documentation_uri']`
-  (`https://rubydoc.info/gems/assistant`) and
+  (`https://ramongr.github.io/assistant/`) and
   `spec.metadata['bug_tracker_uri']`
   (`https://github.com/ramongr/assistant/issues`). The `spec.files`
   glob now excludes `examples/`, `docs/v1/`, and `docs/v1.x/` from the
   packaged gem so internal planning material and runnable samples no
   longer ship to RubyGems (Q9 decision in
   [`docs/v1/07-risks-and-open-questions.md`](docs/v1/07-risks-and-open-questions.md)).
-  No behaviour change; `Assistant::VERSION` is unchanged.
+  No behaviour change.
 
 ### Changed (Breaking)
 

data/Gemfile

@@ -7,12 +7,9 @@ git_source(:github) { |repo_name| "https://github.com/#{repo_name}" }
 # Specify your gem's dependencies in assistant.gemspec
 gemspec
 
-# Documentation site (GitHub Pages) toolchain. Optional so regular
-# contributors don't pull Jekyll on every `bundle install`. CI's Docs
-# workflow installs this group via `BUNDLE_WITH=docs`. See
-# `docs/v1/08-github-pages.md` and `Rakefile`'s `docs:*` tasks.
-group :docs, optional: true do
-  gem 'jekyll', '~> 4.3'
-  gem 'jekyll-relative-links', '~> 0.7'
-  gem 'just-the-docs', '~> 0.10'
-end
+# WEBrick is no longer a default gem in Ruby 3.0+. It's a stdlib gem
+# used only by `rake docs:serve` to mount the Docsify SPA at
+# `/assistant/` so local URLs match the production base path. Not in
+# `gemspec` because the `runtime-deps` CI gate keeps the gem itself
+# dependency-free.
+gem 'webrick', '~> 1.8'

data/Gemfile.lock

@@ -1,90 +1,31 @@
 PATH
   remote: .
   specs:
-    assistant (1.0.0.rc1)
+    assistant (1.0.0)
 
 GEM
   remote: https://rubygems.org/
   specs:
-    addressable (2.9.0)
-      public_suffix (>= 2.0.2, < 8.0)
     ast (2.4.3)
-    base64 (0.3.0)
-    bigdecimal (4.1.2)
     byebug (13.0.0)
       reline (>= 0.6.0)
-    colorator (1.1.0)
     colorize (1.1.0)
     concurrent-ruby (1.3.6)
     csv (3.3.5)
     docile (1.4.1)
     drb (2.2.3)
-    em-websocket (0.5.3)
-      eventmachine (>= 0.12.9)
-      http_parser.rb (~> 0)
-    eventmachine (1.2.7)
     ffi (1.17.4)
     ffi (1.17.4-arm64-darwin)
     fileutils (1.8.0)
-    forwardable-extended (2.6.0)
-    google-protobuf (4.35.1)
-      bigdecimal
-      rake (~> 13.3)
-    google-protobuf (4.35.1-arm64-darwin)
-      bigdecimal
-      rake (~> 13.3)
-    http_parser.rb (0.8.1)
-    i18n (1.14.8)
-      concurrent-ruby (~> 1.0)
     io-console (0.8.2)
-    jekyll (4.4.1)
-      addressable (~> 2.4)
-      base64 (~> 0.2)
-      colorator (~> 1.0)
-      csv (~> 3.0)
-      em-websocket (~> 0.5)
-      i18n (~> 1.0)
-      jekyll-sass-converter (>= 2.0, < 4.0)
-      jekyll-watch (~> 2.0)
-      json (~> 2.6)
-      kramdown (~> 2.3, >= 2.3.1)
-      kramdown-parser-gfm (~> 1.0)
-      liquid (~> 4.0)
-      mercenary (~> 0.3, >= 0.3.6)
-      pathutil (~> 0.9)
-      rouge (>= 3.0, < 5.0)
-      safe_yaml (~> 1.0)
-      terminal-table (>= 1.8, < 4.0)
-      webrick (~> 1.7)
-    jekyll-include-cache (0.2.1)
-      jekyll (>= 3.7, < 5.0)
-    jekyll-relative-links (0.7.0)
-      jekyll (>= 3.3, < 5.0)
-    jekyll-sass-converter (3.1.0)
-      sass-embedded (~> 1.75)
-    jekyll-seo-tag (2.9.0)
-      jekyll (>= 3.8, < 5.0)
-    jekyll-watch (2.2.1)
-      listen (~> 3.0)
     json (2.19.9)
-    just-the-docs (0.12.0)
-      jekyll (>= 3.8.5)
-      jekyll-include-cache
-      jekyll-seo-tag (>= 2.0)
-      rake (>= 12.3.1)
-    kramdown (2.5.2)
-      rexml (>= 3.4.4)
-    kramdown-parser-gfm (1.1.0)
-      kramdown (~> 2.0)
     language_server-protocol (3.17.0.5)
     lint_roller (1.1.0)
-    liquid (4.0.4)
     listen (3.10.0)
       logger
       rb-fsevent (~> 0.10, >= 0.10.3)
       rb-inotify (~> 0.9, >= 0.9.10)
     logger (1.7.0)
-    mercenary (0.4.0)
     minitest (6.0.6)
       drb (~> 2.0)
       prism (~> 1.5)
@@ -92,10 +33,7 @@ GEM
     parser (3.3.11.1)
       ast (~> 2.4.1)
       racc
-    pathutil (0.16.2)
-      forwardable-extended (~> 2.6)
     prism (1.9.0)
-    public_suffix (7.0.5)
     racc (1.8.1)
     rainbow (3.1.1)
     rake (13.4.2)
@@ -109,8 +47,6 @@ GEM
     regexp_parser (2.12.0)
     reline (0.6.3)
       io-console (~> 0.5)
-    rexml (3.4.4)
-    rouge (4.7.0)
     rubocop (1.86.2)
       json (~> 2.3)
       language_server-protocol (~> 3.17.0.2)
@@ -140,12 +76,6 @@ GEM
       lint_roller (~> 1.1)
       rubocop (>= 1.72, < 2.0)
     ruby-progressbar (1.13.0)
-    safe_yaml (1.0.5)
-    sass-embedded (1.101.0)
-      google-protobuf (~> 4.31)
-      rake (>= 13)
-    sass-embedded (1.101.0-arm64-darwin)
-      google-protobuf (~> 4.31)
     securerandom (0.4.1)
     simplecov (0.22.0)
       docile (~> 1.1)
@@ -187,9 +117,6 @@ DEPENDENCIES
   bundler (~> 4.0)
   byebug (~> 13.0)
   colorize (~> 1.1)
-  jekyll (~> 4.3)
-  jekyll-relative-links (~> 0.7)
-  just-the-docs (~> 0.10)
   minitest (~> 6.0)
   rake (~> 13.4)
   rubocop (~> 1.86, >= 1.86.2)
@@ -199,55 +126,32 @@ DEPENDENCIES
   rubocop-style-compact_nesting (~> 0.1)
   simplecov (~> 0.22)
   steep (~> 2.0)
+  webrick (~> 1.8)
   yard (~> 0.9)
 
 CHECKSUMS
-  addressable (2.9.0) sha256=7fdf6ac3660f7f4e867a0838be3f6cf722ace541dd97767fa42bc6cfa980c7af
-  assistant (1.0.0.rc1)
+  assistant (1.0.0)
   ast (2.4.3) sha256=954615157c1d6a382bc27d690d973195e79db7f55e9765ac7c481c60bdb4d383
-  base64 (0.3.0) sha256=27337aeabad6ffae05c265c450490628ef3ebd4b67be58257393227588f5a97b
-  bigdecimal (4.1.2) sha256=53d217666027eab4280346fba98e7d5b66baaae1b9c3c1c0ffe89d48188a3fbd
   bundler (4.0.11) sha256=5bcec0fb78302e48d02ee46f10ee6e6942be647ba5b44a6d1ddfda9a240ce785
   byebug (13.0.0) sha256=d2263efe751941ca520fa29744b71972d39cbc41839496706f5d9b22e92ae05d
-  colorator (1.1.0) sha256=e2f85daf57af47d740db2a32191d1bdfb0f6503a0dfbc8327d0c9154d5ddfc38
   colorize (1.1.0) sha256=30b5237f0603f6662ab8d1fc2bd4a96142b806c6415d79e45ef5fdc6a0cfc837
   concurrent-ruby (1.3.6) sha256=6b56837e1e7e5292f9864f34b69c5a2cbc75c0cf5338f1ce9903d10fa762d5ab
   csv (3.3.5) sha256=6e5134ac3383ef728b7f02725d9872934f523cb40b961479f69cf3afa6c8e73f
   docile (1.4.1) sha256=96159be799bfa73cdb721b840e9802126e4e03dfc26863db73647204c727f21e
   drb (2.2.3) sha256=0b00d6fdb50995fe4a45dea13663493c841112e4068656854646f418fda13373
-  em-websocket (0.5.3) sha256=f56a92bde4e6cb879256d58ee31f124181f68f8887bd14d53d5d9a292758c6a8
-  eventmachine (1.2.7) sha256=994016e42aa041477ba9cff45cbe50de2047f25dd418eba003e84f0d16560972
   ffi (1.17.4) sha256=bcd1642e06f0d16fc9e09ac6d49c3a7298b9789bcb58127302f934e437d60acf
   ffi (1.17.4-arm64-darwin) sha256=19071aaf1419251b0a46852abf960e77330a3b334d13a4ab51d58b31a937001b
   fileutils (1.8.0) sha256=8c6b1df54e2540bdb2f39258f08af78853aa70bad52b4d394bbc6424593c6e02
-  forwardable-extended (2.6.0) sha256=1bec948c469bbddfadeb3bd90eb8c85f6e627a412a3e852acfd7eaedbac3ec97
-  google-protobuf (4.35.1) sha256=a3a6471331d918f58dfa4d014a8f6286f0af2cf4840216bde52fcf2ea3fe3726
-  google-protobuf (4.35.1-arm64-darwin) sha256=d9c957df04fa89c749fa9a72a7b383eb4296efc9b2303dc6fd6fbe39c698ad6b
-  http_parser.rb (0.8.1) sha256=9ae8df145b39aa5398b2f90090d651c67bd8e2ebfe4507c966579f641e11097a
-  i18n (1.14.8) sha256=285778639134865c5e0f6269e0b818256017e8cde89993fdfcbfb64d088824a5
   io-console (0.8.2) sha256=d6e3ae7a7cc7574f4b8893b4fca2162e57a825b223a177b7afa236c5ef9814cc
-  jekyll (4.4.1) sha256=4c1144d857a5b2b80d45b8cf5138289579a9f8136aadfa6dd684b31fe2bc18c1
-  jekyll-include-cache (0.2.1) sha256=c7d4b9e551732a27442cb2ce853ba36a2f69c66603694b8c1184c99ab1a1a205
-  jekyll-relative-links (0.7.0) sha256=831e54c348eeae751845c0d4ac4b244bd73b664341f0e8c9f1803b16f4570835
-  jekyll-sass-converter (3.1.0) sha256=83925d84f1d134410c11d0c6643b0093e82e3a3cf127e90757a85294a3862443
-  jekyll-seo-tag (2.9.0) sha256=0260015a8e1df9bf195cdfb0c675b7b2883fd8cbf12556e1c1cbe36a831c6852
-  jekyll-watch (2.2.1) sha256=bc44ed43f5e0a552836245a54dbff3ea7421ecc2856707e8a1ee203a8387a7e1
   json (2.19.9) sha256=9b9025b7cdddafa38d316eca0b2358488e42d417045c1b90d216a9fefe46b79a
-  just-the-docs (0.12.0) sha256=15f2839ac9082898d60f33b978aa6f8e46fc50ba8fac20ae7a7f0e1fb295523e
-  kramdown (2.5.2) sha256=1ba542204c66b6f9111ff00dcc26075b95b220b07f2905d8261740c82f7f02fa
-  kramdown-parser-gfm (1.1.0) sha256=fb39745516427d2988543bf01fc4cf0ab1149476382393e0e9c48592f6581729
   language_server-protocol (3.17.0.5) sha256=fd1e39a51a28bf3eec959379985a72e296e9f9acfce46f6a79d31ca8760803cc
   lint_roller (1.1.0) sha256=2c0c845b632a7d172cb849cc90c1bce937a28c5c8ccccb50dfd46a485003cc87
-  liquid (4.0.4) sha256=4fcfebb1a045e47918388dbb7a0925e7c3893e58d2bd6c3b3c73ec17a2d8fdb3
   listen (3.10.0) sha256=c6e182db62143aeccc2e1960033bebe7445309c7272061979bb098d03760c9d2
   logger (1.7.0) sha256=196edec7cc44b66cfb40f9755ce11b392f21f7967696af15d274dde7edff0203
-  mercenary (0.4.0) sha256=b25a1e4a59adca88665e08e24acf0af30da5b5d859f7d8f38fba52c28f405138
   minitest (6.0.6) sha256=153ea36d1d987a62942382b61075745042a2b3123b1cd48f4c3675af9cc7d6f1
   parallel (2.1.0) sha256=b35258865c2e31134c5ecb708beaaf6772adf9d5efae28e93e99260877b09356
   parser (3.3.11.1) sha256=d17ace7aabe3e72c3cc94043714be27cc6f852f104d81aa284c2281aecc65d54
-  pathutil (0.16.2) sha256=e43b74365631cab4f6d5e4228f812927efc9cb2c71e62976edcb252ee948d589
   prism (1.9.0) sha256=7b530c6a9f92c24300014919c9dcbc055bf4cdf51ec30aed099b06cd6674ef85
-  public_suffix (7.0.5) sha256=1a8bb08f1bbea19228d3bed6e5ed908d1cb4f7c2726d18bd9cadf60bc676f623
   racc (1.8.1) sha256=4a7f6929691dbec8b5209a0b373bc2614882b55fc5d2e447a21aaa691303d62f
   rainbow (3.1.1) sha256=039491aa3a89f42efa1d6dec2fc4e62ede96eb6acd95e52f1ad581182b79bc6a
   rake (13.4.2) sha256=cb825b2bd5f1f8e91ca37bddb4b9aaf345551b4731da62949be002fa89283701
@@ -256,8 +160,6 @@ CHECKSUMS
   rbs (4.0.2) sha256=af75671e66cd03434cc546622741ebf83f6197ec4328375805306330bf78ef25
   regexp_parser (2.12.0) sha256=35a916a1d63190ab5c9009457136ae5f3c0c7512d60291d0d1378ba18ce08ebb
   reline (0.6.3) sha256=1198b04973565b36ec0f11542ab3f5cfeeec34823f4e54cebde90968092b1835
-  rexml (3.4.4) sha256=19e0a2c3425dfbf2d4fc1189747bdb2f849b6c5e74180401b15734bc97b5d142
-  rouge (4.7.0) sha256=dba5896715c0325c362e895460a6d350803dbf6427454f49a47500f3193ea739
   rubocop (1.86.2) sha256=bb2e97f635eda42c448f2588f4a6ff78f221b8bdfdf65b1e9b07fbd57521b45d
   rubocop-ast (1.49.1) sha256=4412f3ee70f6fe4546cc489548e0f6fcf76cafcfa80fa03af67098ffed755035
   rubocop-minitest (0.39.1) sha256=998398d6da4026d297f0f9bf709a1eac5f2b6947c24431f94af08138510cf7ed
@@ -265,9 +167,6 @@ CHECKSUMS
   rubocop-rake (0.7.1) sha256=3797f2b6810c3e9df7376c26d5f44f3475eda59eb1adc38e6f62ecf027cbae4d
   rubocop-style-compact_nesting (0.1.2) sha256=cbe155ec7230dcea32925d34a435b40c2fc666ea9b45755f92102dd1a73b739b
   ruby-progressbar (1.13.0) sha256=80fc9c47a9b640d6834e0dc7b3c94c9df37f08cb072b7761e4a71e22cff29b33
-  safe_yaml (1.0.5) sha256=a6ac2d64b7eb027bdeeca1851fe7e7af0d668e133e8a88066a0c6f7087d9f848
-  sass-embedded (1.101.0) sha256=57dbc3409e2c0a2c581a4c9945c2bd72ec88e71ec98017bd02dd1da8a76b22f4
-  sass-embedded (1.101.0-arm64-darwin) sha256=9fed684380b49499dfc856aba0d026a0748f924bd78044ffff2bae1537aea73e
   securerandom (0.4.1) sha256=cc5193d414a4341b6e225f0cb4446aceca8e50d5e1888743fac16987638ea0b1
   simplecov (0.22.0) sha256=fe2622c7834ff23b98066bb0a854284b2729a569ac659f82621fc22ef36213a5
   simplecov-html (0.13.2) sha256=bd0b8e54e7c2d7685927e8d6286466359b6f16b18cb0df47b508e8d73c777246

data/README.md

@@ -25,6 +25,8 @@ gem install assistant
 
 Ruby `>= 3.4` is required.
 
+**Online documentation:** <https://ramongr.github.io/assistant/>
+
 ## 60-second example
 
 ```ruby
@@ -90,8 +92,11 @@ a per-class generator (`bin/assistant-rbs`) out of the box.
 
 ## Documentation
 
+- **Online documentation** — <https://ramongr.github.io/assistant/>.
 - **Getting started** — [`docs/getting-started.md`](docs/getting-started.md)
   walks from `gem install` to a first working service.
+- **Guides** — [`docs/guides/`](docs/guides/README.md) covers inputs,
+  validation, logging/results, composition, and RBS/Steep usage.
 - **API reference** — [`docs/api-reference.md`](docs/api-reference.md)
   is the hand-written, curated reference for every Frozen symbol; the
   source of truth for stability labels stays in
@@ -102,14 +107,11 @@ a per-class generator (`bin/assistant-rbs`) out of the box.
   [`docs/v1/06-migration-0x-to-1.md`](docs/v1/06-migration-0x-to-1.md).
 - **Deprecations** — [`docs/deprecations.md`](docs/deprecations.md).
 - **Runnable sample** — [`examples/greeter.rb`](examples/greeter.rb).
+- **Examples gallery** — [`docs/examples/README.md`](docs/examples/README.md)
+  links to runnable Rails, CLI, Sidekiq, callbacks, notifier, composition, and
+  RBS generator examples.
 - **Changelog** — [`CHANGELOG.md`](CHANGELOG.md).
 
-The deeper guides (`docs/guides/inputs.md`,
-`docs/guides/validation.md`, `docs/guides/logging-and-results.md`,
-`docs/guides/composing-services.md`) are tracked in
-[`docs/v1/03-documentation.md`](docs/v1/03-documentation.md) and land
-in follow-up PRs.
-
 ## Roadmap
 
 The plan for the 1.0 release lives under

data/Rakefile

@@ -2,6 +2,7 @@
 
 require 'bundler/gem_tasks'
 require 'rake/testtask'
+require 'webrick' # stdlib gem (pinned in Gemfile); used by `rake docs:serve`.
 
 Rake::TestTask.new(:test) do |t|
   t.libs << 'test'
@@ -39,19 +40,24 @@ desc 'Run the full local CI pipeline: test + rubocop + steep + yard'
 task ci: %i[test rubocop steep yard]
 
 namespace :docs do
-  desc 'Install the Jekyll docs toolchain (Bundler :docs group)'
-  task :install do
-    sh 'bundle install --with docs'
-  end
+  desc 'Serve the Docsify site on http://127.0.0.1:4000/assistant/ (Ctrl-C to stop)'
+  task :serve do
+    # Docsify runs in hash-mode routing, so every navigable URL resolves to
+    # `docs/index.html` (no SPA-fallback servlet required). We mount `docs/`
+    # at `/assistant/` over WEBrick so local URLs match the production base
+    # path verbatim.
+    root  = File.expand_path('docs', __dir__)
+    mount = '/assistant'
 
-  desc 'Build the Jekyll site into ./_site (mirrors the CI Pages build)'
-  task :build do
-    sh 'bundle exec jekyll build --strict_front_matter'
-  end
+    server = WEBrick::HTTPServer.new(Port: 4000, BindAddress: '127.0.0.1')
+    server.mount(mount, WEBrick::HTTPServlet::FileHandler, root, FancyIndexing: false)
+    server.mount_proc('/') do |_req, res|
+      res.set_redirect(WEBrick::HTTPStatus::Found, "#{mount}/")
+    end
 
-  desc 'Serve the Jekyll site on http://127.0.0.1:4000 with live reload'
-  task :serve do
-    sh 'bundle exec jekyll serve --livereload'
+    trap('INT') { server.shutdown }
+    puts "Serving http://127.0.0.1:4000#{mount}/ (Ctrl-C to stop)"
+    server.start
   end
 end
 

data/Steepfile

@@ -37,13 +37,28 @@ target :lib do
   check 'lib/assistant/rbs_generator/cli.rb'
 end
 
-# Type-checks the sample service in `examples/` against the .rbs
-# generated by `exe/assistant-rbs` and shipped in `sig/examples/`.
+# Type-checks the sample service in `examples/greeter.rb` against the
+# .rbs generated by `exe/assistant-rbs` and shipped in `sig/examples/`.
 # Doubles as the M11 regression that the generator's output is in fact
 # accepted by Steep.
+#
+# The check is scoped to `greeter.rb` rather than the whole `examples/`
+# tree because the P6-P12 example folders (docs/v1/08-github-pages.md)
+# are documentation companions, not Steep regressions: hand-writing
+# `.rbs` sidecars for every Service / POJO they ship would be cost
+# without leverage. The `rbs_generator` example (P12) re-includes its
+# own files via a dedicated check below.
 target :examples do
   signature 'lib'
   signature 'sig'
 
-  check 'examples'
+  check 'examples/greeter.rb'
+end
+
+target :rbs_generator_example do
+  signature 'lib'
+  signature 'examples/rbs_generator/sig'
+
+  check 'examples/rbs_generator/create_user.rb'
+  check 'examples/rbs_generator/type_probe.rb'
 end

data/assistant.gemspec

@@ -29,7 +29,7 @@ Gem::Specification.new do |spec|
   spec.metadata['allowed_push_host'] = 'https://rubygems.org'
   spec.metadata['bug_tracker_uri'] = 'https://github.com/ramongr/assistant/issues'
   spec.metadata['changelog_uri'] = 'https://github.com/ramongr/assistant/blob/main/CHANGELOG.md'
-  spec.metadata['documentation_uri'] = 'https://rubydoc.info/gems/assistant'
+  spec.metadata['documentation_uri'] = 'https://ramongr.github.io/assistant/'
   spec.metadata['homepage_uri'] = 'https://github.com/ramongr/assistant'
   spec.metadata['rubygems_mfa_required'] = 'true'
   spec.metadata['source_code_uri'] = 'https://github.com/ramongr/assistant'