quonfig 0.0.9 → 0.0.11

metadata

@@ -1,15 +1,29 @@
 --- !ruby/object:Gem::Specification
 name: quonfig
 version: !ruby/object:Gem::Version
-  version: 0.0.9
+  version: 0.0.11
 platform: ruby
 authors:
 - Jeff Dwyer
 autorequire:
 bindir: bin
 cert_chain: []
-date: 2026-04-27 00:00:00.000000000 Z
+date: 2026-05-02 00:00:00.000000000 Z
 dependencies:
+- !ruby/object:Gem::Dependency
+  name: activesupport
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - ">="
+      - !ruby/object:Gem::Version
+        version: '4'
+  type: :runtime
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - ">="
+      - !ruby/object:Gem::Version
+        version: '4'
 - !ruby/object:Gem::Dependency
   name: concurrent-ruby
   requirement: !ruby/object:Gem::Requirement
@@ -36,140 +50,42 @@ dependencies:
     requirements:
     - - ">="
       - !ruby/object:Gem::Version
-        version: '0'
+        version: '1.0'
   type: :runtime
   prerelease: false
   version_requirements: !ruby/object:Gem::Requirement
     requirements:
     - - ">="
       - !ruby/object:Gem::Version
-        version: '0'
+        version: '1.0'
 - !ruby/object:Gem::Dependency
   name: ld-eventsource
   requirement: !ruby/object:Gem::Requirement
     requirements:
     - - ">="
       - !ruby/object:Gem::Version
-        version: '0'
+        version: '2.0'
   type: :runtime
   prerelease: false
   version_requirements: !ruby/object:Gem::Requirement
     requirements:
     - - ">="
       - !ruby/object:Gem::Version
-        version: '0'
+        version: '2.0'
 - !ruby/object:Gem::Dependency
   name: uuid
   requirement: !ruby/object:Gem::Requirement
     requirements:
     - - ">="
       - !ruby/object:Gem::Version
-        version: '0'
-  type: :runtime
-  prerelease: false
-  version_requirements: !ruby/object:Gem::Requirement
-    requirements:
-    - - ">="
-      - !ruby/object:Gem::Version
-        version: '0'
-- !ruby/object:Gem::Dependency
-  name: activesupport
-  requirement: !ruby/object:Gem::Requirement
-    requirements:
-    - - ">="
-      - !ruby/object:Gem::Version
-        version: '4'
+        version: '2.0'
   type: :runtime
   prerelease: false
   version_requirements: !ruby/object:Gem::Requirement
     requirements:
     - - ">="
       - !ruby/object:Gem::Version
-        version: '4'
-- !ruby/object:Gem::Dependency
-  name: allocation_stats
-  requirement: !ruby/object:Gem::Requirement
-    requirements:
-    - - ">="
-      - !ruby/object:Gem::Version
-        version: '0'
-  type: :development
-  prerelease: false
-  version_requirements: !ruby/object:Gem::Requirement
-    requirements:
-    - - ">="
-      - !ruby/object:Gem::Version
-        version: '0'
-- !ruby/object:Gem::Dependency
-  name: benchmark-ips
-  requirement: !ruby/object:Gem::Requirement
-    requirements:
-    - - ">="
-      - !ruby/object:Gem::Version
-        version: '0'
-  type: :development
-  prerelease: false
-  version_requirements: !ruby/object:Gem::Requirement
-    requirements:
-    - - ">="
-      - !ruby/object:Gem::Version
-        version: '0'
-- !ruby/object:Gem::Dependency
-  name: bundler
-  requirement: !ruby/object:Gem::Requirement
-    requirements:
-    - - ">="
-      - !ruby/object:Gem::Version
-        version: '0'
-  type: :development
-  prerelease: false
-  version_requirements: !ruby/object:Gem::Requirement
-    requirements:
-    - - ">="
-      - !ruby/object:Gem::Version
-        version: '0'
-- !ruby/object:Gem::Dependency
-  name: juwelier
-  requirement: !ruby/object:Gem::Requirement
-    requirements:
-    - - "~>"
-      - !ruby/object:Gem::Version
-        version: 2.4.9
-  type: :development
-  prerelease: false
-  version_requirements: !ruby/object:Gem::Requirement
-    requirements:
-    - - "~>"
-      - !ruby/object:Gem::Version
-        version: 2.4.9
-- !ruby/object:Gem::Dependency
-  name: rdoc
-  requirement: !ruby/object:Gem::Requirement
-    requirements:
-    - - ">="
-      - !ruby/object:Gem::Version
-        version: '0'
-  type: :development
-  prerelease: false
-  version_requirements: !ruby/object:Gem::Requirement
-    requirements:
-    - - ">="
-      - !ruby/object:Gem::Version
-        version: '0'
-- !ruby/object:Gem::Dependency
-  name: simplecov
-  requirement: !ruby/object:Gem::Requirement
-    requirements:
-    - - ">="
-      - !ruby/object:Gem::Version
-        version: '0'
-  type: :development
-  prerelease: false
-  version_requirements: !ruby/object:Gem::Requirement
-    requirements:
-    - - ">="
-      - !ruby/object:Gem::Version
-        version: '0'
+        version: '2.0'
 description: Quonfig — feature flags and live config, stored as files in git.
 email: jeff@quonfig.com
 executables: []
@@ -179,31 +95,9 @@ extra_rdoc_files:
 - LICENSE.txt
 - README.md
 files:
-- ".claude/rules/constitution.md"
-- ".claude/rules/git-safety.md"
-- ".claude/rules/issue-tracking.md"
-- ".claude/rules/testing-workflow.md"
-- ".envrc.sample"
-- ".github/CODEOWNERS"
-- ".github/pull_request_template.md"
-- ".github/workflows/release.yml"
-- ".github/workflows/ruby.yml"
-- ".github/workflows/test.yaml"
-- ".rubocop.yml"
-- ".tool-versions"
 - CHANGELOG.md
-- CLAUDE.md
-- CODEOWNERS
-- Gemfile
-- Gemfile.lock
 - LICENSE.txt
 - README.md
-- Rakefile
-- VERSION
-- dev/allocation_stats
-- dev/benchmark
-- dev/console
-- dev/script_setup.rb
 - lib/quonfig.rb
 - lib/quonfig/bound_client.rb
 - lib/quonfig/caching_http_connection.rb
@@ -228,6 +122,7 @@ files:
 - lib/quonfig/errors/type_mismatch_error.rb
 - lib/quonfig/errors/uninitialized_error.rb
 - lib/quonfig/evaluation.rb
+- lib/quonfig/evaluation_details.rb
 - lib/quonfig/evaluator.rb
 - lib/quonfig/exponential_backoff.rb
 - lib/quonfig/fixed_size_hash.rb
@@ -251,64 +146,16 @@ files:
 - lib/quonfig/telemetry/telemetry_reporter.rb
 - lib/quonfig/time_helpers.rb
 - lib/quonfig/types.rb
+- lib/quonfig/version.rb
 - lib/quonfig/weighted_value_resolver.rb
 - quonfig.gemspec
-- test/fixtures/datafile.json
-- test/integration/test_context_precedence.rb
-- test/integration/test_datadir_environment.rb
-- test/integration/test_dev_overrides.rb
-- test/integration/test_enabled.rb
-- test/integration/test_enabled_with_contexts.rb
-- test/integration/test_get.rb
-- test/integration/test_get_feature_flag.rb
-- test/integration/test_get_or_raise.rb
-- test/integration/test_get_weighted_values.rb
-- test/integration/test_helpers.rb
-- test/integration/test_helpers_test.rb
-- test/integration/test_post.rb
-- test/integration/test_telemetry.rb
-- test/support/common_helpers.rb
-- test/support/mock_base_client.rb
-- test/support/mock_config_loader.rb
-- test/test_bound_client.rb
-- test/test_caching_http_connection.rb
-- test/test_client.rb
-- test/test_client_network_mode.rb
-- test/test_client_telemetry.rb
-- test/test_config_loader.rb
-- test/test_context.rb
-- test/test_context_shape.rb
-- test/test_context_shape_aggregator.rb
-- test/test_datadir.rb
-- test/test_dev_context.rb
-- test/test_duration.rb
-- test/test_encryption.rb
-- test/test_evaluation_summaries_aggregator.rb
-- test/test_evaluator.rb
-- test/test_example_contexts_aggregator.rb
-- test/test_exponential_backoff.rb
-- test/test_fixed_size_hash.rb
-- test/test_helper.rb
-- test/test_http_connection.rb
-- test/test_internal_logger.rb
-- test/test_options.rb
-- test/test_rate_limit_cache.rb
-- test/test_reason.rb
-- test/test_rename.rb
-- test/test_resolver.rb
-- test/test_semantic_logger_filter.rb
-- test/test_semver.rb
-- test/test_should_log.rb
-- test/test_sse_config_client.rb
-- test/test_stdlib_formatter.rb
-- test/test_telemetry_reporter.rb
-- test/test_typed_getters.rb
-- test/test_types.rb
-- test/test_weighted_value_resolver.rb
 homepage: https://github.com/quonfig/sdk-ruby
 licenses:
 - MIT
-metadata: {}
+metadata:
+  source_code_uri: https://github.com/quonfig/sdk-ruby
+  changelog_uri: https://github.com/quonfig/sdk-ruby/blob/main/CHANGELOG.md
+  rubygems_mfa_required: 'true'
 post_install_message:
 rdoc_options: []
 require_paths:
@@ -317,7 +164,7 @@ required_ruby_version: !ruby/object:Gem::Requirement
   requirements:
   - - ">="
     - !ruby/object:Gem::Version
-      version: '0'
+      version: '3.0'
 required_rubygems_version: !ruby/object:Gem::Requirement
   requirements:
   - - ">="

data/.claude/rules/constitution.md

@@ -1,81 +0,0 @@
----
-name: constitution
-description: Rules for when agents must stop for human review vs. proceed autonomously. Read before committing significant changes or when uncertain about scope.
----
-
-# Agent Constitution
-
-Default rule: **when in doubt, block for human review**. A false positive costs 30 seconds. A false negative can cause real damage.
-
-Human-review blocks use the built-in `blocked` status plus the `needs-human` label (bd's custom-status format doesn't accept `blocked:human`). Do NOT call `bd close` on a bead that needs human input — closed beads are invisible to the human review queue.
-
-## Auto-Proceed (no human needed)
-
-- Bug fixes with passing tests
-- UI copy, labels, and styling changes
-- Test coverage additions
-- Refactoring within a single file that doesn't change public interfaces
-- Docs and comment updates
-- Simulation-discovered bugs with a clear root cause and fix
-- Patch-version dependency bumps
-- Adding new flags/configs to `our-config/` (no schema change)
-- **Data-only edits** to existing configs in `our-config/` — flipping a boolean, editing a value, renaming a label. Changing *what* is stored is a data change; changing *how* it's stored is a schema change.
-- Staging deployments (`fly.staging.toml`)
-
-## Stop and Ask (blocked + needs-human)
-
-**Push as far as you can before blocking.** The goal is to surface a specific,
-answerable question — not to stop at the first sign of uncertainty. Investigate the
-codebase, try the obvious path, and block only when you hit a concrete fork that
-requires a human judgment call. An agent that does real work and then blocks with a
-precise question is far more valuable than one that blocks immediately.
-
-Block when you reach a decision point that touches:
-
-- **Storage format** — git repo structure, JSON config schema, Gitea config
-- **SDK-facing API surface** — anything SDK clients call: `api-delivery` endpoints, SSE protocol, SDK public interfaces
-- **Cache or delivery protocol** — how configs are loaded, evicted, or streamed
-- **Auth and access control** — workspace permissions, API keys, OAuth flows
-- **New external dependencies** — adding a package to package.json, go.mod, etc.
-- **Database schema changes** — Drizzle migrations, ClickHouse schema
-- **Multi-service contract changes** — modifying interfaces shared between two or more services
-- **High uncertainty** — you've investigated and the right approach still isn't clear
-
-When blocking, be specific: explain exactly what decision is needed, what you've
-already ruled out, and what the options are. Vague blocks ("not sure how to proceed")
-are not acceptable — do more investigation first.
-
-```bash
-bd update <id> --status blocked --add-label needs-human
-bd comments add <id> "Blocked: [what the decision is, what you investigated, what the options are]"
-```
-
-To see the human-review queue: `bd list --label needs-human`. Do NOT call `bd close` on these — the label is what surfaces them.
-
-## Never Touch Without Explicit Instruction
-
-- Credentials, secrets, `.env` files with real values
-- Live production data or the Gitea service token
-- Anything in `business/`
-- Production fly deployments (`fly.toml` or `fly.production.toml`, not `fly.staging.toml`)
-- The `.beads/` database directly (always use `bd` CLI)
-
-## Alpha Phase Rules
-
-In alpha it is acceptable to:
-- Deploy to staging without asking
-- Commit directly to main in sub-repos
-- Run simulated user tests against the local dev server
-- File new beads for bugs found during simulation
-
-It is NOT acceptable to:
-- Deploy to production without asking
-- Modify `integration-test-data/` YAML without asking
-- Merge breaking changes to SDK public APIs without asking
-
-## Daily Digest
-
-Append to `digests/YYYY-MM-DD.md` after each completed task:
-- What was done and what tests passed
-- What is blocked and why
-- Any bugs filed by the simulate stage

data/.claude/rules/git-safety.md

@@ -1,11 +0,0 @@
----
-description: Git safety rules applied to all projects in the monorepo
-globs: ["**"]
----
-
-IMPORTANT: Never force push (`--force` or `--force-with-lease`) to any branch.
-IMPORTANT: Never delete branches without explicit user approval.
-IMPORTANT: Never run `git reset --hard` or `git clean` without explaining what will be lost and getting confirmation first.
-IMPORTANT: Always commit work-in-progress before any context switch so nothing is lost.
-IMPORTANT: Keep commits small and well-scoped so anything can be easily reverted.
-IMPORTANT: If git blocks an operation, stop and ask — don't force past it.

data/.claude/rules/issue-tracking.md

@@ -1,13 +0,0 @@
----
-description: Issue tracking with beads (bd) for all projects
-globs: ["**"]
----
-
-IMPORTANT: Do not use Linear for issue tracking. Use beads (`bd`) instead.
-
-Quick reference:
-- `bd ready` — find available work
-- `bd show <id>` — view issue details
-- `bd update <id> --status in_progress` — claim work
-- `bd close <id>` — complete work
-- `bd sync` — sync with git

data/.claude/rules/testing-workflow.md

@@ -1,28 +0,0 @@
----
-description: Testing workflow rules for all code projects
-globs: ["app-quonfig/**", "www-quonfig/**", "ai-starter/**", "api-telemetry/**", "api-delivery/**", "sdk-node/**", "sdk-go/**"]
----
-
-IMPORTANT: Default to TDD — write the failing test first, run it and confirm it fails (red), then implement until it passes (green). The red→green sequence is the cheapest check that the test is real and that the change actually worked. Paste both the failing and passing output as evidence.
-
-IMPORTANT: The goal is **verification**, not test volume. If a change genuinely isn't red/green testable in code (UI polish, infra glue, config-only changes, anything where the test rig would be more complex than the fix), pick one:
-1. **Simulated verification** — drive the real flow (browser automation, live HTTP call, dev server) and paste the evidence it worked.
-2. **Block for human** — `bd update <id> --status blocked --add-label needs-human` with a comment explaining what you tried and why verification needs human hands. Do NOT `bd close` — that hides the bead from the human queue.
-
-Never ship with zero verification. Don't build elaborate test scaffolding when the change doesn't warrant it — the form can flex, the evidence cannot.
-
-IMPORTANT: Run the relevant test suite before marking a task complete (the file or package you touched, not necessarily the whole repo).
-
-## Browser / Chrome DevTools testing (app-quonfig)
-
-When any task requires browser testing in app-quonfig, ALWAYS read these skills first:
-- `/user-test-login`  — `.claude/skills/user-test-login/SKILL.md`
-- `/user-create-test` — `.claude/skills/user-create-test/SKILL.md`
-
-Key points so you don't go off-script:
-- Test accounts live in `app-quonfig/.dev/test-users.json` (gitignored, alias-keyed)
-- The dev-agent login route (`POST /api/dev/login-as`) is the preferred way to sign in headlessly — requires `DEV_AGENT_LOGIN=true` in `.env`
-- Use `isolatedContext` in Chrome MCP when you need a clean session that doesn't share cookies
-- Avoid `@example.com` emails — that domain triggers SSO via the Test Organization
-- Verification codes for new sign-ups come from the WorkOS Events API (see `/user-create-test` for the node snippet)
-- If a test requires a user with a specific state (e.g. pending invite, no org), create a fresh account with `/user-create-test` rather than reusing an existing one

data/.envrc.sample

@@ -1,3 +0,0 @@
-export AWS_ACCESS_KEY_ID=
-export AWS_SECRET_ACCESS_KEY=
-export PREFAB_INTEGRATION_TEST_API_KEY=

data/.github/CODEOWNERS

@@ -1,2 +0,0 @@
-# All changes require review from prefabdevs team
-* @prefab-cloud/prefabdevs

data/.github/pull_request_template.md

@@ -1,8 +0,0 @@
-## Description
-*(Brief overview of what this PR changes and/or why the changes are needed)*
-
-## Testing & Validation
-*(Outline the steps needed to be taken to verify the changes.)*
-
-## Rollout
-*(Optional section: Provide rollout and rollback procedures, when outside the bounds or requiring additional work beyond standard deployment)*

data/.github/workflows/release.yml

@@ -1,49 +0,0 @@
----
-name: Push gem
-
-"on":
-  workflow_run:
-    workflows: ["Ruby"]
-    branches: [main]
-    types:
-      - completed
-
-jobs:
-  push:
-    runs-on: ubuntu-latest
-    if: ${{ github.event.workflow_run.conclusion == 'success' }}
-
-    permissions:
-      contents: write
-      id-token: write
-
-    steps:
-      - uses: actions/checkout@v4
-        with:
-          persist-credentials: false
-          submodules: recursive
-
-      - name: Set up Ruby
-        uses: ruby/setup-ruby@v1
-        with:
-          bundler-cache: false
-          ruby-version: '3.3'
-
-      - name: Install runtime dependencies
-        run: bundle install --without development --jobs 4 --retry 3
-
-      - name: Check if version already exists
-        id: version-check
-        run: |
-          VERSION=$(cat VERSION)
-          if gem list -r quonfig | grep -q "quonfig ($VERSION)"; then
-            echo "version-exists=true" >> $GITHUB_OUTPUT
-            echo "Version $VERSION already exists on RubyGems, skipping publish"
-          else
-            echo "version-exists=false" >> $GITHUB_OUTPUT
-            echo "Version $VERSION not found, proceeding with publish"
-          fi
-
-      - name: Release gem
-        if: steps.version-check.outputs.version-exists == 'false'
-        uses: rubygems/release-gem@v1

data/.github/workflows/ruby.yml

@@ -1,60 +0,0 @@
-# This workflow uses actions that are not certified by GitHub.
-# They are provided by a third-party and are governed by
-# separate terms of service, privacy policy, and support
-# documentation.
-# This workflow will download a prebuilt Ruby version, install dependencies and run tests with Rake
-# For more information see: https://github.com/marketplace/actions/setup-ruby-jruby-and-truffleruby
-
-name: Ruby
-
-on:
-  push:
-    branches: [ "main" ]
-  pull_request:
-    branches: [ "main" ]
-
-permissions:
-  contents: read
-
-jobs:
-  test:
-
-    runs-on: ubuntu-latest
-    strategy:
-      fail-fast: false
-      matrix:
-        ruby-version: ['3.2','3.3','3.4']
-
-    steps:
-    - name: Checkout sdk-ruby
-      uses: actions/checkout@v4
-      with:
-        submodules: recursive
-        path: sdk-ruby
-
-    - name: Checkout integration-test-data
-      uses: actions/checkout@v4
-      with:
-        repository: quonfig/integration-test-data
-        path: integration-test-data
-        ref: main
-
-    - name: Set up Ruby
-    # To automatically get bug fixes and new Ruby versions for ruby/setup-ruby,
-    # change this to (see https://github.com/ruby/setup-ruby#versioning):
-    # uses: ruby/setup-ruby@v1
-    # uses: ruby/setup-ruby@2b019609e2b0f1ea1a2bc8ca11cb82ab46ada124
-      uses: ruby/setup-ruby@v1
-      with:
-        ruby-version: ${{ matrix.ruby-version }}
-        bundler-cache: false # runs 'bundle install' and caches installed gems automatically
-        working-directory: sdk-ruby
-    - name: Install dependencies
-      working-directory: sdk-ruby
-      run: bundle install --without development --jobs 4 --retry 3
-    - name: Run tests
-      working-directory: sdk-ruby
-      run: bundle exec rake --trace
-      env:
-        NOT_A_NUMBER: "abcd"
-        IS_A_NUMBER: "1234"

data/.github/workflows/test.yaml

@@ -1,40 +0,0 @@
-name: Test
-on:
-  push:
-    branches: [main]
-  pull_request:
-
-jobs:
-  test:
-    runs-on: ubuntu-latest
-    strategy:
-      fail-fast: false
-      matrix:
-        ruby-version: ['3.1', '3.2', '3.3']
-    steps:
-      - name: Checkout sdk-ruby
-        uses: actions/checkout@v4
-        with:
-          path: sdk-ruby
-
-      - name: Checkout integration-test-data
-        uses: actions/checkout@v4
-        with:
-          repository: quonfig/integration-test-data
-          path: integration-test-data
-          ref: main
-
-      - name: Set up Ruby ${{ matrix.ruby-version }}
-        uses: ruby/setup-ruby@v1
-        with:
-          ruby-version: ${{ matrix.ruby-version }}
-          bundler-cache: true
-          working-directory: sdk-ruby
-
-      - name: Install dependencies
-        working-directory: sdk-ruby
-        run: bundle install
-
-      - name: Run tests
-        working-directory: sdk-ruby
-        run: bundle exec rake test

data/.rubocop.yml

@@ -1,13 +0,0 @@
-AllCops:
-  NewCops: enable
-  Exclude:
-    - sdk-reforge.gemspec
-    - lib/prefab_pb.rb
-
-Metrics:
-  Exclude:
-    - 'test/*.rb'
-
-Layout/LineLength:
-  Exclude:
-    - 'test/*.rb'

data/.tool-versions

@@ -1 +0,0 @@
-ruby 3.2.7

data/CLAUDE.md

@@ -1,29 +0,0 @@
-# Quonfig Ruby SDK
-
-Ruby SDK for Quonfig feature flags and configuration.
-
-## Build & Test
-
-```bash
-bundle install                          # install dependencies
-bundle exec rake test                   # run all tests
-bundle exec ruby test/test_FOO.rb       # run a single test file
-bundle exec rake                        # default task — runs tests
-```
-
-## Directory layout
-
-- `lib/quonfig/` — SDK source code
-- `test/` — unit tests (one `test_*.rb` per module)
-- `test/integration/` — integration tests driven by shared YAML specs
-
-Integration tests require the sibling directory `../../integration-test-data/`
-to exist (cloned from `quonfig/integration-test-data`). Without it the
-integration suite cannot resolve its YAML specs.
-
-## Environment variables
-
-- `QUONFIG_BACKEND_SDK_KEY` — backend SDK key for authenticated config delivery
-- `QUONFIG_DIR` — path to a local Quonfig workspace (datadir mode)
-- `QUONFIG_ENVIRONMENT` — which environment to evaluate (`production`, `staging`, `development`)
-- `QUONFIG_TELEMETRY_URL` — telemetry ingest endpoint

data/CODEOWNERS

@@ -1 +0,0 @@
-*    @prefab-cloud/prefabdevs @prefab-cloud/prefabmaintainers @prefab-cloud/prefabadmins

data/Gemfile

@@ -1,26 +0,0 @@
-source 'https://rubygems.org'
-
-gem 'concurrent-ruby', '~> 1.0', '>= 1.0.5'
-gem 'faraday'
-gem 'ld-eventsource'
-gem 'uuid'
-
-gem 'activesupport', '>= 4'
-
-group :development do
-  gem 'allocation_stats'
-  gem 'benchmark-ips'
-  gem 'bundler'
-  gem 'juwelier', '~> 2.4.9'
-  gem 'rdoc'
-  gem 'simplecov', '>= 0'
-end
-
-group :test do
-  gem 'semantic_logger', '!= 4.16.0', require: "semantic_logger/sync"
-  gem 'minitest'
-  gem 'minitest-focus'
-  gem 'minitest-reporters'
-  gem 'timecop'
-  gem 'webrick'
-end