ruact 0.0.11 → 0.0.12

data/.github/workflows/ci.yml

@@ -1,284 +0,0 @@
-name: CI
-
-on:
-  push:
-    branches: [main]
-  pull_request:
-    branches: [main]
-
-# Note: this workflow runs in the `luizcg/ruact` repo, where the gem source
-# lives at the repo root (no `gem/` subdirectory). The previous version had
-# `working-directory: gem` on every step, copy-pasted from a monorepo layout;
-# every run since the initial commit failed at `setup-ruby` with
-# `ENOENT: no such file or directory, chdir 'gem'`. The e2e jobs depended
-# on an `e2e/` Rails app that lives in the planning monorepo, not in this
-# repo, and likewise could never run here. Both issues fixed in Story 6.7.
-
-jobs:
-  name-propagation:
-    # Required status check — fails if the legacy gem name or the legacy
-    # API-surface prefix appear in user-facing files. Two complementary
-    # guards:
-    #
-    #   (a) Story 5.1 — guards against the legacy gem-name regression
-    #       (the `rails[_-]rsc` / PascalCase form). The legacy names are
-    #       written here in the same regex-character-class form that the
-    #       grep step itself uses, so this workflow file stays grep-clean
-    #       under its own checks.
-    #   (b) Story 5.12 — guards against the residual legacy prefix on the
-    #       API surface (controller methods, header name, Rake task, view
-    #       helper, token format, Serializable DSL) being re-introduced
-    #       after the pre-v0.1.0 clean cut.
-    #
-    # Exclusion list mirrors the AC1 / AC6 contracts exactly: CHANGELOG.md
-    # (historical record), doc/ (generated YARD), *.gem (built artifacts).
-    name: No legacy gem-name or legacy-prefix API references
-    runs-on: ubuntu-latest
-    steps:
-      - uses: actions/checkout@v5
-      - name: Grep for legacy gem-name references (Story 5.1)
-        # Pattern is assembled from concatenated string fragments so this
-        # very workflow file is grep-clean even though it talks about the
-        # legacy names — that lets the canonical exclusion list stay at
-        # three entries (Story 5.1 review F4).
-        run: |
-          PATTERN='rails[_-]rsc|Rails''Rsc'
-          if git grep -nE "$PATTERN" -- \
-               ':!CHANGELOG.md' \
-               ':!doc/' \
-               ':!*.gem'; then
-            echo "::error::Legacy gem-name reference found in user-facing file."
-            echo "::error::Rename to 'ruact' / 'Ruact'. See Story 5.1 in _bmad-output/implementation-artifacts/."
-            exit 1
-          fi
-          echo "::notice::No legacy gem-name references found."
-      - name: Grep for residual rsc_* API references (Story 5.12)
-        # AC1 of Story 5.12: every identifier renamed in the clean cut.
-        # Uses Perl mode (-P) for word boundaries. Pattern fragments are
-        # split with $R / $RU shell-vars so this workflow file is itself
-        # grep-clean — the file contains `${R}` / `${RU}` references, not
-        # literal `rsc` / `RSC` strings that would match the pattern (same
-        # strategy as Story 5.1 review F4).
-        #
-        # Coverage (Story 5.12 review F5 — broaden beyond curated list):
-        #   - any <legacy>_<identifier> (catches private helpers),
-        #   - any __<legacy>_<X>__ helper,
-        #   - any __<UPPER>_<X>__ token format,
-        #   - any data-<legacy> / data-<legacy>-<X> DOM attribute,
-        #   - the [-:] router / suspense / doctor literals,
-        #   - the legacy Request HTTP header,
-        #   - the legacy lib/tasks/<legacy>.rake file path.
-        # Literals are intentionally written with placeholder text so this
-        # workflow file is itself grep-clean under its own regex.
-        run: |
-          R='rsc'
-          RU="$(printf '%s' "$R" | tr a-z A-Z)"
-          PATTERN="\\b(${R}_\\w+|__${R}_\\w+__|__${RU}_\\w*[0-9]+__|data-${R}(-\\w+|=)|${R}[-:](router|suspense|doctor)|${RU}-Request|lib/tasks/${R}\\.rake)\\b"
-          if git grep -nP "$PATTERN" -- \
-               ':!CHANGELOG.md' \
-               ':!doc/' \
-               ':!*.gem' \
-               ':!coverage/'; then
-            echo "::error::Residual rsc_* API reference found in gem source."
-            echo "::error::Rename to the ruact_* equivalent. See Story 5.12 in _bmad-output/implementation-artifacts/."
-            exit 1
-          fi
-          echo "::notice::No residual rsc_* API references found."
-
-  rspec:
-    # Required status check — all 8 matrix combinations must pass to merge.
-    name: RSpec (Ruby ${{ matrix.ruby }} / Rails ${{ matrix.rails }})
-    runs-on: ubuntu-latest
-    strategy:
-      fail-fast: false
-      matrix:
-        ruby: ["3.2", "3.3"]
-        rails: ["7.0", "7.1", "7.2", "8.0"]
-    env:
-      RAILS_VERSION: ${{ matrix.rails }}
-      # The Gemfile injects `gem "rails", "~> #{ENV['RAILS_VERSION']}"` for
-      # matrix testing, but Gemfile.lock cannot pin all four Rails versions
-      # at once. `bundler-cache: true` defaults to deployment/frozen mode
-      # which rejects any Gemfile change vs lockfile, so disable that here
-      # while keeping the gem cache for everything else.
-      BUNDLE_DEPLOYMENT: "false"
-      BUNDLE_FROZEN: "false"
-    steps:
-      - uses: actions/checkout@v5
-      - uses: ruby/setup-ruby@v1
-        with:
-          ruby-version: ${{ matrix.ruby }}
-          bundler-cache: true
-      - name: Run RSpec
-        run: bundle exec rspec --format progress
-      - name: Upload coverage to Codecov
-        # Upload from one canonical matrix cell only (Ruby 3.3 × Rails 7.2)
-        # to avoid quota burn and Codecov-side flag merge conflicts. Other
-        # cells run RSpec but skip the upload. `success()` ensures we never
-        # upload partial/aborted runs. `fail_ci_if_error: false` keeps a
-        # Codecov outage from reddening a build whose tests passed.
-        if: matrix.ruby == '3.3' && matrix.rails == '7.2' && success()
-        uses: codecov/codecov-action@v5
-        with:
-          token: ${{ secrets.CODECOV_TOKEN }}
-          files: coverage/lcov.info
-          flags: gem
-          fail_ci_if_error: false
-
-  rubocop:
-    # Required status check.
-    name: RuboCop
-    runs-on: ubuntu-latest
-    steps:
-      - uses: actions/checkout@v5
-      - uses: ruby/setup-ruby@v1
-        with:
-          ruby-version: "3.3"
-          bundler-cache: true
-      - name: Run RuboCop
-        run: bundle exec rubocop --format github
-
-  yard:
-    # Required status check — fails if any public method is missing YARD docs.
-    name: YARD Docs
-    runs-on: ubuntu-latest
-    steps:
-      - uses: actions/checkout@v5
-      - uses: ruby/setup-ruby@v1
-        with:
-          ruby-version: "3.3"
-          bundler-cache: true
-      - name: Validate YARD docs
-        run: bundle exec yard --fail-on-warning
-
-  js:
-    # Required status check — the bundled Vite plugin's JS suite. Runs the
-    # vitest codegen tests (incl. the Ruby↔JS byte-parity cases, which shell out
-    # to `ruby` — hence Ruby is set up alongside Node) and, Story 13.4, the
-    # `tsc --noEmit` type-level test that proves the emitted typed-query accessor
-    # signatures are enforced at compile time (FR99 / AC6).
-    name: JS (vite-plugin codegen + typecheck)
-    runs-on: ubuntu-latest
-    defaults:
-      run:
-        working-directory: vendor/javascript/vite-plugin-ruact
-    steps:
-      - uses: actions/checkout@v5
-      - uses: ruby/setup-ruby@v1
-        with:
-          ruby-version: "3.3"
-          bundler-cache: false
-      - uses: actions/setup-node@v4
-        with:
-          node-version: "20"
-      - name: Install JS deps
-        run: npm ci
-      - name: Install runtime package deps (react for the bundled runtime test)
-        # The vite-plugin vitest config globs in the sibling runtime package's
-        # `index.test.mjs`, which imports the runtime's `index.js` → `react`.
-        # That package keeps `react` in its own deps (lockfile gitignored), so
-        # install them here. Without this the bundled run fails to resolve react.
-        working-directory: vendor/javascript/ruact-server-functions-runtime
-        run: npm install --no-audit --no-fund
-      - name: Run vitest (codegen + Ruby↔JS parity + runtime)
-        run: npm test
-      - name: Type-check emitted accessors (Story 13.4 / FR99)
-        run: npm run typecheck
-
-  benchmark:
-    # Required status check — fails if memory allocations exceed 120% of baseline.json.
-    name: Memory Benchmark
-    runs-on: ubuntu-latest
-    steps:
-      - uses: actions/checkout@v5
-      - uses: ruby/setup-ruby@v1
-        with:
-          ruby-version: "3.3"
-          bundler-cache: true
-      - name: Run memory benchmark
-        run: bundle exec rake benchmark:memory
-
-# E2E jobs (e2e and e2e-next) were removed from this workflow in Story 6.7.
-# They depend on the `e2e/` Rails app in the planning monorepo and cannot run
-# here (this repo has no `e2e/` directory). When/if a host-app system test
-# is desired in CI, host the workflow in the monorepo (luizcg/ruact-dev) where
-# both the gem submodule and the e2e/ Rails app live side by side.
-
-  release:
-    # Auto-release to RubyGems on every GREEN push to main, gated on the full
-    # required-check set via `needs:`. Versioning (source of truth:
-    # lib/ruact/version.rb): story verde -> patch; epic verde -> minor via an
-    # `[epic-done]` marker in the merge-commit message; major manual for 1.0.0.
-    # Auth is RubyGems Trusted Publishing (OIDC) — satisfies
-    # rubygems_mfa_required. The bump commit carries [skip ci] (no re-trigger).
-    #
-    # KILL SWITCH (added 2026-06-14): publishing is OFF by default. The job only
-    # runs when the repo variable RUACT_AUTO_RELEASE is exactly "true". When the
-    # variable is unset (current state), `vars.RUACT_AUTO_RELEASE` is the empty
-    # string, the `== 'true'` test is false, and this job is skipped — every
-    # other check still runs, merges stay green, nothing is published.
-    #   Turn ON :  gh variable set    RUACT_AUTO_RELEASE -b true -R luizcg/ruact
-    #   Turn OFF:  gh variable delete  RUACT_AUTO_RELEASE      -R luizcg/ruact
-    # (or GitHub UI: Settings -> Secrets and variables -> Actions -> Variables)
-    name: Release to RubyGems
-    needs: [name-propagation, rspec, rubocop, yard, js, benchmark]
-    if: >-
-      github.event_name == 'push'
-      && github.ref == 'refs/heads/main'
-      && vars.RUACT_AUTO_RELEASE == 'true'
-    runs-on: ubuntu-latest
-    permissions:
-      id-token: write
-      contents: write
-    concurrency:
-      group: release
-      cancel-in-progress: false
-    steps:
-      - uses: actions/checkout@v5
-        with:
-          fetch-depth: 0
-      - uses: ruby/setup-ruby@v1
-        with:
-          ruby-version: "3.3"
-          bundler-cache: true
-      - name: Decide bump kind & compute next version
-        id: bump
-        env:
-          HEAD_MSG: ${{ github.event.head_commit.message }}
-        run: |
-          KIND=patch
-          printf '%s' "$HEAD_MSG" | grep -qi '\[epic-done\]' && KIND=minor
-          VERSION=$(ruby -e '
-            kind = ARGV[0]
-            path = "lib/ruact/version.rb"
-            src  = File.read(path)
-            maj, min, pat = src.match(/VERSION = "(\d+)\.(\d+)\.(\d+)"/).captures.map(&:to_i)
-            case kind
-            when "major" then maj, min, pat = maj + 1, 0, 0
-            when "minor" then min, pat = min + 1, 0
-            else pat += 1
-            end
-            v = "#{maj}.#{min}.#{pat}"
-            File.write(path, src.sub(/VERSION = "[^"]+"/, %(VERSION = "#{v}")))
-            print v
-          ' "$KIND")
-          echo "version=$VERSION" >> "$GITHUB_OUTPUT"
-          # Resync Gemfile.lock to the bumped path-gem version. Without this the
-          # release commit carries a new version.rb but a stale lock, and every
-          # frozen-mode job (rubocop/yard/benchmark) goes red on the next push
-          # with bundler exit 16 ("gemspecs for path gems changed"). `git commit
-          # -am` below then picks up the updated lock alongside version.rb.
-          bundle lock --local
-          echo "::notice::Release bump $KIND -> v$VERSION"
-      - uses: rubygems/configure-rubygems-credentials@v2.0.0 # OIDC -> short-lived credential
-      - name: Commit, tag & publish
-        env:
-          VERSION: ${{ steps.bump.outputs.version }}
-        run: |
-          git config user.name  "github-actions[bot]"
-          git config user.email "41898282+github-actions[bot]@users.noreply.github.com"
-          git commit -am "Release v$VERSION [skip ci]"
-          git tag "v$VERSION"
-          git push origin HEAD --tags
-          gem build ruact.gemspec
-          gem push "ruact-$VERSION.gem"

data/.github/workflows/server-functions-bench.yml

@@ -1,54 +0,0 @@
-name: Server-functions bench (AC12)
-
-# Story 8.1 AC12 — non-blocking nightly perf guard. Runs the AR-backed
-# end-to-end dispatch benchmark and posts the numbers as a workflow
-# summary. Does NOT gate merge (the bench measures wall-clock and is
-# subject to runner noise); it exists to surface 10× regressions in
-# the open instead of after release.
-#
-# Triggers:
-#   - nightly cron (06:00 UTC)
-#   - PRs touching `lib/ruact/server_functions/**` or the bench script
-#     itself
-#   - manual `workflow_dispatch`
-
-on:
-  schedule:
-    - cron: "0 6 * * *"
-  pull_request:
-    paths:
-      - "lib/ruact/server_functions/**"
-      - "lib/ruact/controller.rb"
-      - "vendor/javascript/ruact-server-functions-runtime/**"
-      - "bench/server_functions_dispatch_bench.rb"
-      - ".github/workflows/server-functions-bench.yml"
-  workflow_dispatch:
-
-jobs:
-  bench:
-    name: Run dispatch bench
-    runs-on: ubuntu-latest
-    env:
-      BUNDLE_DEPLOYMENT: "false"
-      BUNDLE_FROZEN: "false"
-    steps:
-      - uses: actions/checkout@v5
-      - uses: ruby/setup-ruby@v1
-        with:
-          ruby-version: "3.3"
-          bundler-cache: true
-      - name: Run bench
-        id: bench
-        run: |
-          bundle exec ruby bench/server_functions_dispatch_bench.rb \
-            | tee bench-output.txt
-      - name: Post numbers as workflow summary
-        if: always()
-        run: |
-          {
-            echo "## Server-functions dispatch bench"
-            echo ""
-            echo '```'
-            cat bench-output.txt
-            echo '```'
-          } >> "$GITHUB_STEP_SUMMARY"

data/.rubocop.yml

@@ -1,107 +0,0 @@
-inherit_from: .rubocop_todo.yml
-
-# Merge (union) Exclude arrays across .rubocop_todo.yml and this file —
-# without this, a cop that declares its own Exclude below (e.g.
-# Metrics/ModuleLength) would silently DISCARD the todo file's frozen
-# exclusions for that cop (RuboCop's per-parameter override semantics).
-inherit_mode:
-  merge:
-    - Exclude
-
-require:
-  - rubocop/cop/ruact
-
-plugins:
-  - rubocop-rspec
-  - rubocop-performance
-
-AllCops:
-  TargetRubyVersion: 3.2
-  NewCops: enable
-  Exclude:
-    - "vendor/**/*"
-    - "sig/**/*"
-
-# --- Layout ---
-Layout/LineLength:
-  Max: 120
-
-# --- Metrics ---
-Metrics/MethodLength:
-  Max: 30
-  CountAsOne: ["array", "hash", "heredoc"]
-  # Note: case/when chain in serializer.rb and converter is intentional by architecture decision
-
-Metrics/BlockLength:
-  Exclude:
-    - "spec/**/*"
-    - "Gemfile"
-    - "lib/tasks/**/*.rake"
-
-Naming/VariableNumber:
-  Exclude:
-    - "lib/tasks/**/*.rake"
-  # Spec story-tag convention: `describe ..., :story_7_7` mirrors the story
-  # ID (7.7 → :story_7_7) so a single rspec invocation runs the regression
-  # suite for that story (project-context §11). Narrowed to the exact symbol
-  # shape rather than excluding all of spec/ — anything else under spec/ that
-  # tries to use snake_case-with-numbers still trips the cop. The optional
-  # trailing letter accommodates carve-out stories like 8.0a → :story_8_0a.
-  AllowedPatterns:
-    - '\bstory_\d+_\d+[a-z]?\b'
-
-Metrics/ClassLength:
-  Max: 150
-
-Metrics/ModuleLength:
-  Max: 150
-  Exclude:
-    - "spec/**/*"
-
-Metrics/AbcSize:
-  Max: 50
-  # Note: PoC methods (ruact_render, each, convert_element) will be refactored
-  # in later stories. Current values reflect tech debt, not design intent.
-
-Metrics/CyclomaticComplexity:
-  Max: 20
-
-Metrics/PerceivedComplexity:
-  Max: 20
-
-# --- Style ---
-Style/Documentation:
-  Enabled: false
-
-Style/FrozenStringLiteralComment:
-  Enabled: true
-  EnforcedStyle: always
-
-Style/StringLiterals:
-  EnforcedStyle: double_quotes
-
-# --- RSpec ---
-RSpec/MultipleExpectations:
-  Max: 5
-
-RSpec/ExampleLength:
-  Max: 25
-
-RSpec/MultipleMemoizedHelpers:
-  Max: 7
-
-RSpec/NestedGroups:
-  Max: 4
-
-RSpec/DescribeClass:
-  Enabled: false
-
-# --- Custom Ruact Cops ---
-Ruact/NoIoInFlight:
-  Enabled: true
-
-Ruact/NoSharedState:
-  Enabled: true
-
-Ruact/NoExtendSelf:
-  Enabled: true

data/.rubocop_todo.yml

@@ -1,63 +0,0 @@
-# This configuration was generated by
-# `rubocop --auto-gen-config --auto-gen-only-exclude --exclude-limit 100`
-# on 2026-06-15 05:49:26 UTC using RuboCop version 1.85.1.
-# 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.
-
-# Offense count: 2
-# This cop supports safe autocorrection (--autocorrect).
-# Configuration parameters: AllowAliasSyntax, AllowedMethods.
-# AllowedMethods: alias_method, public, protected, private
-Layout/EmptyLinesAroundAttributeAccessor:
-  Exclude:
-    - 'spec/ruact/server_functions/error_payload_spec.rb'
-
-# Offense count: 10
-# This cop supports safe autocorrection (--autocorrect).
-# Configuration parameters: Max, AllowHeredoc, AllowURI, AllowQualifiedName, URISchemes, AllowRBSInlineAnnotation, AllowCopDirectives, AllowedPatterns, SplitStrings.
-# URISchemes: http, https
-Layout/LineLength:
-  Exclude:
-    - 'bench/server_functions_dispatch_bench.rb'
-    - 'lib/ruact/server_functions/error_suggestion.rb'
-    - 'spec/ruact/server_functions/error_suggestion_spec.rb'
-
-# Offense count: 1
-# Configuration parameters: Prefixes, AllowedPatterns.
-# Prefixes: when, with, without
-RSpec/ContextWording:
-  Exclude:
-    - 'spec/ruact/controller_spec.rb'
-
-# Offense count: 2
-# This cop supports unsafe autocorrection (--autocorrect-all).
-# Configuration parameters: AllowedMethods, AllowedPatterns.
-# AllowedMethods: ==, equal?, eql?
-Style/ClassEqualityComparison:
-  Exclude:
-    - 'lib/ruact/server_functions/error_payload.rb'
-
-# Offense count: 1
-# This cop supports safe autocorrection (--autocorrect).
-Style/IfUnlessModifier:
-  Exclude:
-    - 'bench/server_functions_dispatch_bench.rb'
-
-# Offense count: 1
-Style/MixinUsage:
-  Exclude:
-    - 'bench/server_functions_dispatch_bench.rb'
-
-# Offense count: 4
-# Configuration parameters: AllowedClasses.
-Style/OneClassPerFile:
-  Exclude:
-    - 'bench/server_functions_dispatch_bench.rb'
-
-# Offense count: 2
-# This cop supports safe autocorrection (--autocorrect).
-Style/RedundantFreeze:
-  Exclude:
-    - 'spec/ruact/server_functions/error_payload_spec.rb'

data/Rakefile

@@ -1,10 +0,0 @@
-# frozen_string_literal: true
-
-require "bundler/gem_tasks"
-require "rspec/core/rake_task"
-
-RSpec::Core::RakeTask.new(:spec)
-
-Dir["lib/tasks/**/*.rake"].each { |f| load f }
-
-task default: :spec