parse-stack-next 5.1.1 → 5.2.1

data/scripts/docker/docker-compose.atlas.yml

@@ -8,7 +8,7 @@
 #   Reset:  docker-compose -f scripts/docker/docker-compose.atlas.yml down -v && docker-compose -f scripts/docker/docker-compose.atlas.yml up -d
 #
 # Run tests:
-#   ATLAS_URI="mongodb://localhost:27020/parse_atlas_test?directConnection=true" ruby -Ilib:test test/lib/parse/atlas_search_integration_test.rb
+#   ATLAS_URI="mongodb://localhost:29020/parse_atlas_test?directConnection=true" ruby -Ilib:test test/lib/parse/atlas_search_integration_test.rb
 #
 # Stability notes (see commit history for context):
 #   The mongodb-atlas-local image runs a supervisor ("runner") that intentionally
@@ -19,13 +19,17 @@
 #   which checks both mongod AND mongot. We rely on that built-in healthcheck
 #   rather than overriding it with a faster mongosh probe.
 
+# Distinct Compose project name — kept separate from the main test stack
+# (psnext-it) so `down` on one never tears down the other.
+name: ${PSNEXT_PREFIX:-psnext-it}-atlas
+
 services:
   atlas-local:
     # Pinned patch tag rather than the floating :8.0 — mongodb-atlas-local has
     # known per-patch start-up flakiness (see testcontainers/testcontainers-java#10267
     # and MongoDB community forum 321179). Bump deliberately, not by drift.
     image: mongodb/mongodb-atlas-local:8.0.10
-    container_name: parse-stack-atlas-local
+    container_name: ${PSNEXT_PREFIX:-psnext-it}-atlas
     # `hostname` is called out by the official compose example — the embedded
     # single-node replica set advertises this name, and a stable value makes
     # restart-after-down work cleanly.
@@ -37,15 +41,15 @@ services:
       MONGOT_LOG_FILE: /dev/stderr
     # Loopback-only by default — Atlas Local has no auth configured.
     ports:
-      - "${ATLAS_BIND:-127.0.0.1}:27020:27017"
+      - "${ATLAS_BIND:-127.0.0.1}:${ATLAS_HOST_PORT:-29020}:27017"
     volumes:
       # Persist mongod data, replset config, and — critically — the mongot
       # Lucene index directory. Without /data/mongot persistence, every restart
       # forces a full search re-index, which lengthens "ready" time and is a
       # real source of test flakiness. Matches the official compose example.
-      - atlas-data:/data/db
-      - atlas-configdb:/data/configdb
-      - atlas-mongot:/data/mongot
+      - psnext-it-atlas-data:/data/db
+      - psnext-it-atlas-configdb:/data/configdb
+      - psnext-it-atlas-mongot:/data/mongot
     # Recover from genuine crashes automatically. Test runs `docker compose down`
     # explicitly, so this does not interfere with teardown.
     restart: unless-stopped
@@ -59,7 +63,7 @@ services:
 
   atlas-init:
     image: mongodb/mongodb-atlas-local:8.0.10
-    container_name: parse-stack-atlas-init
+    container_name: ${PSNEXT_PREFIX:-psnext-it}-atlas-init
     depends_on:
       atlas-local:
         # Uses the image's built-in healthcheck (see above), so this now waits
@@ -71,6 +75,6 @@ services:
     restart: "no"
 
 volumes:
-  atlas-data:
-  atlas-configdb:
-  atlas-mongot:
+  psnext-it-atlas-data:
+  psnext-it-atlas-configdb:
+  psnext-it-atlas-mongot:

data/scripts/docker/docker-compose.test.yml

@@ -1,31 +1,35 @@
 version: '3.8'
 
+# Distinct Compose project name so this stack never shares containers,
+# networks, or volumes with another Parse test system on the same host.
+name: ${PSNEXT_PREFIX:-psnext-it}
+
 services:
   mongo:
     image: mongo:8
-    container_name: parse-stack-test-mongo
+    container_name: ${PSNEXT_PREFIX:-psnext-it}-mongo
     # Bind to loopback so the test database isn't reachable from the LAN
     # when a developer runs `docker-compose up`. Override with
     # `MONGO_BIND=0.0.0.0` if you really want it exposed.
     ports:
-      - "${MONGO_BIND:-127.0.0.1}:27019:27017"
+      - "${MONGO_BIND:-127.0.0.1}:${MONGO_HOST_PORT:-29017}:27017"
     environment:
       MONGO_INITDB_ROOT_USERNAME: ${MONGO_ROOT_USER:-admin}
       MONGO_INITDB_ROOT_PASSWORD: ${MONGO_ROOT_PASSWORD:-password}
       MONGO_INITDB_DATABASE: admin
     volumes:
-      - mongo-data:/data/db
+      - psnext-it-mongo-data:/data/db
       - ./mongo-init.js:/docker-entrypoint-initdb.d/mongo-init.js:ro
 
   parse:
     build:
       context: ..
       dockerfile: docker/Dockerfile.parse
-    container_name: parse-stack-test-server
+    container_name: ${PSNEXT_PREFIX:-psnext-it}-server
     # Bind to loopback by default — Parse Server with the test master key
     # has no business being reachable on a developer's LAN.
     ports:
-      - "${PARSE_BIND:-127.0.0.1}:2337:1337"
+      - "${PARSE_BIND:-127.0.0.1}:${PARSE_HOST_PORT:-29337}:1337"
     # `host.docker.internal` is needed so Parse Server can POST to the
     # in-process WEBrick that backs webhook integration tests. Docker
     # Desktop on Mac/Windows resolves this natively; on Linux we map it
@@ -45,10 +49,10 @@ services:
       # `start-parse.sh` will abort if any of these is unset, so any
       # name drift here surfaces immediately rather than booting Parse
       # Server with whatever placeholder default the SDK README documents.
-      PARSE_SERVER_APPLICATION_ID: ${PARSE_APP_ID:-myAppId}
-      PARSE_SERVER_MASTER_KEY:     ${PARSE_MASTER_KEY:-myMasterKey}
-      PARSE_SERVER_REST_API_KEY:   ${PARSE_API_KEY:-test-rest-key}
-      PARSE_SERVER_DATABASE_URI:   mongodb://${MONGO_ROOT_USER:-admin}:${MONGO_ROOT_PASSWORD:-password}@mongo:27017/parse?authSource=admin
+      PARSE_SERVER_APPLICATION_ID: ${PARSE_APP_ID:-psnextItAppId}
+      PARSE_SERVER_MASTER_KEY:     ${PARSE_MASTER_KEY:-psnextItMasterKey}
+      PARSE_SERVER_REST_API_KEY:   ${PARSE_API_KEY:-psnext-it-rest-key}
+      PARSE_SERVER_DATABASE_URI:   mongodb://${MONGO_ROOT_USER:-admin}:${MONGO_ROOT_PASSWORD:-password}@mongo:27017/parse_stack_next_it?authSource=admin
       # Accept client-supplied objectId on create. Required by the
       # `parse_reference precompute: true` DSL. The SDK only forwards
       # client objectIds under master-key authority; for non-master
@@ -78,36 +82,36 @@ services:
 
   redis:
     image: redis:7-alpine
-    container_name: parse-stack-test-redis
+    container_name: ${PSNEXT_PREFIX:-psnext-it}-redis
     # Loopback-only by default. Used by the cache integration test
     # (cache_redis_integration_test.rb) and the synchronize-create lock
     # tests. Override with `REDIS_BIND=0.0.0.0` if you need to point a
     # remote client at it during debugging.
     ports:
-      - "${REDIS_BIND:-127.0.0.1}:6399:6379"
+      - "${REDIS_BIND:-127.0.0.1}:${REDIS_HOST_PORT:-29379}:6379"
     command: ["redis-server", "--save", "", "--appendonly", "no"]
 
   parse-dashboard:
     image: parseplatform/parse-dashboard:9
-    container_name: parse-stack-test-dashboard
+    container_name: ${PSNEXT_PREFIX:-psnext-it}-dashboard
     # Loopback-only by default. This compose is for `rake test:integration`
     # and local debugging; do not expose to the network.
     ports:
-      - "${DASHBOARD_BIND:-127.0.0.1}:4040:4040"
+      - "${DASHBOARD_BIND:-127.0.0.1}:${DASHBOARD_HOST_PORT:-29040}:4040"
     environment:
       # `allowInsecureHTTP` and `useEncryptedPasswords: false` are kept
       # because this stack runs over plain HTTP on loopback. Do NOT copy
       # these settings to a deployed environment.
       PARSE_DASHBOARD_ALLOW_INSECURE_HTTP: "1"
-      PARSE_SERVER_MASTER_KEY: ${PARSE_MASTER_KEY:-myMasterKey}
-      PARSE_SERVER_APPLICATION_ID: ${PARSE_APP_ID:-myAppId}
-      PARSE_SERVER_URL: http://localhost:2337/parse
+      PARSE_SERVER_MASTER_KEY: ${PARSE_MASTER_KEY:-psnextItMasterKey}
+      PARSE_SERVER_APPLICATION_ID: ${PARSE_APP_ID:-psnextItAppId}
+      PARSE_SERVER_URL: http://localhost:${PARSE_HOST_PORT:-29337}/parse
       PARSE_DASHBOARD_CONFIG: |
         {
           "apps": [{
-            "serverURL": "http://localhost:2337/parse",
-            "appId": "${PARSE_APP_ID:-myAppId}",
-            "masterKey": "${PARSE_MASTER_KEY:-myMasterKey}",
+            "serverURL": "http://localhost:${PARSE_HOST_PORT:-29337}/parse",
+            "appId": "${PARSE_APP_ID:-psnextItAppId}",
+            "masterKey": "${PARSE_MASTER_KEY:-psnextItMasterKey}",
             "appName": "ParseStackTest"
           }],
           "users": [{
@@ -121,4 +125,4 @@ services:
       - parse
 
 volumes:
-  mongo-data:
+  psnext-it-mongo-data:

data/scripts/docker/mongo-init.js

@@ -1,6 +1,6 @@
 // MongoDB initialization script
 // This script runs when the MongoDB container is first created
-// It grants the admin user access to the parse database for direct queries
+// It grants the admin user access to the parse_stack_next_it database for direct queries
 
 // The admin user needs readWriteAnyDatabase role to access all databases
 db = db.getSiblingDB('admin');
@@ -11,8 +11,8 @@ db.grantRolesToUser('admin', [
   { role: 'dbAdminAnyDatabase', db: 'admin' }
 ]);
 
-// Initialize the parse database
-db = db.getSiblingDB('parse');
+// Initialize the parse_stack_next_it database
+db = db.getSiblingDB('parse_stack_next_it');
 
 // Create a placeholder collection to ensure the database exists
 db.createCollection('_init');

data/scripts/start-parse.sh

@@ -70,6 +70,16 @@ export PARSE_SERVER_START_LIVE_QUERY_SERVER="${PARSE_SERVER_START_LIVE_QUERY_SER
 # both pathways: authed upload succeeds, anon upload is rejected.
 export PARSE_SERVER_FILE_UPLOAD="${PARSE_SERVER_FILE_UPLOAD:-{\"enableForPublic\":false,\"enableForAnonymousUser\":false,\"enableForAuthenticatedUser\":true}}"
 
+# Request-id idempotency — test-stack only, scoped to a single probe class so
+# it deduplicates ONLY writes the request-id integration test targets and has
+# zero effect on every other suite. Parse Server dedups POST/PUT carrying the
+# same X-Parse-Request-Id within the TTL for paths matching `paths` (regex).
+# The SDK's idempotent-retry feature relies on exactly this server-side dedup
+# when `Parse::Request.assume_server_idempotency = true`. NOTE: Parse Server
+# names this env var with an `EXPERIMENTAL_` infix and treats the value as a
+# JSON object (objectParser). Override the whole JSON to widen coverage.
+export PARSE_SERVER_EXPERIMENTAL_IDEMPOTENCY_OPTIONS="${PARSE_SERVER_EXPERIMENTAL_IDEMPOTENCY_OPTIONS:-{\"paths\":[\"classes/IdempotencyProbe\"],\"ttl\":120}}"
+
 echo "Environment configured:"
 echo "  PARSE_SERVER_APPLICATION_ID: $PARSE_SERVER_APPLICATION_ID"
 echo "  PARSE_SERVER_LIVE_QUERY: $PARSE_SERVER_LIVE_QUERY"

data/scripts/start_mcp_server.rb

@@ -18,7 +18,7 @@
 #                       binding to a non-loopback host
 #
 # Why no fallback values: previously this script accepted
-# `ENV["PARSE_APP_ID"] || "myAppId"` and the equivalent for the master
+# `ENV["PARSE_APP_ID"] || "psnextItAppId"` and the equivalent for the master
 # key. A deployment that forgot to set the env var (typo'd name, missing
 # secret manager binding, container startup race) would silently boot
 # with the placeholder credentials documented in the README — credentials

data/scripts/test_server_connection.rb

@@ -75,7 +75,7 @@ end
 
 puts "\n5. Connection information:"
 puts "  Parse Server: http://localhost:1337/parse"
-puts "  Parse Dashboard: http://localhost:4040"
+puts "  Parse Dashboard: http://localhost:29040"
 puts "  Dashboard login: admin/admin"
 
 puts "\nTo stop the containers, run:"

data/scripts/vector_prototype/create_vector_index.js

@@ -10,7 +10,7 @@
 // fetch_embeddings.py.
 //
 // Run:
-//   mongosh "mongodb://localhost:27020/vector_prototype?directConnection=true" \
+//   mongosh "mongodb://localhost:29020/vector_prototype?directConnection=true" \
 //     scripts/vector_prototype/create_vector_index.js
 //
 // To switch to 1024-dim (voyage-multimodal-3 compat), set DIMS=1024

data/scripts/vector_prototype/fetch_embeddings.py

@@ -3,7 +3,7 @@
 Vector-search & RAG test fixture loader.
 
 Pulls a subset of a pre-computed embeddings dataset from HuggingFace and
-loads it into Atlas Local at localhost:27020 (the same container managed
+loads it into Atlas Local at localhost:29020 (the same container managed
 by scripts/docker/docker-compose.atlas.yml). Designed to be reused by both:
 
   1. Vector search integration tests (Parse::VectorSearch — v4.3 plan)
@@ -90,7 +90,7 @@ ID_FIELD = _p["id_field"]
 
 _ext = "parquet" if DATA_FORMAT == "parquet" else "json"
 LOCAL_FILE = os.environ.get("LOCAL_FILE", f"/tmp/parse-stack-fixture-{PRESET}.{_ext}")
-MONGO_URI = os.environ.get("ATLAS_URI", "mongodb://localhost:27020/?directConnection=true")
+MONGO_URI = os.environ.get("ATLAS_URI", "mongodb://localhost:29020/?directConnection=true")
 DB_NAME = os.environ.get("DB_NAME", "vector_prototype")
 # Collection name mirrors the dataset shape so RAG tests can pivot
 # without coupling test assertions to a hard-coded class name.

data/scripts/vector_prototype/query_prototype.rb

@@ -24,7 +24,7 @@ unless File.exist?(MANIFEST_PATH)
 end
 MANIFEST = JSON.parse(File.read(MANIFEST_PATH))
 
-MONGO_URI = ENV.fetch("ATLAS_URI", "mongodb://localhost:27020/#{MANIFEST['db']}?directConnection=true")
+MONGO_URI = ENV.fetch("ATLAS_URI", "mongodb://localhost:29020/#{MANIFEST['db']}?directConnection=true")
 INDEX_NAME = ENV.fetch("VECTOR_INDEX", MANIFEST["index_name"])
 COLL_NAME = MANIFEST["collection"].to_sym
 

data/scripts/vector_prototype/run.sh

@@ -1,7 +1,7 @@
 #!/usr/bin/env bash
 # Orchestrate the vector-search / RAG test fixture setup.
 # Assumes the Atlas Local container from docker-compose.atlas.yml is up
-# (i.e. localhost:27020 is reachable).
+# (i.e. localhost:29020 is reachable).
 #
 # Usage:  ./scripts/vector_prototype/run.sh
 #
@@ -13,9 +13,9 @@ set -euo pipefail
 
 HERE="$(cd "$(dirname "$0")" && pwd)"
 
-echo "[1/3] verifying Atlas Local on localhost:27020"
+echo "[1/3] verifying Atlas Local on localhost:29020"
 if ! mongosh --quiet --eval "db.runCommand({ ping: 1 })" \
-     "mongodb://localhost:27020/?directConnection=true" >/dev/null; then
+     "mongodb://localhost:29020/?directConnection=true" >/dev/null; then
   echo "  ERROR: Atlas Local not reachable. Start it with:"
   echo "    docker-compose -f scripts/docker/docker-compose.atlas.yml up -d"
   exit 1
@@ -26,7 +26,7 @@ echo "[2/3] downloading + loading embeddings"
 python3 "$HERE/fetch_embeddings.py"
 
 echo "[3/3] creating vectorSearch index"
-mongosh --quiet "mongodb://localhost:27020/vector_prototype?directConnection=true" \
+mongosh --quiet "mongodb://localhost:29020/vector_prototype?directConnection=true" \
   "$HERE/create_vector_index.js"
 
 echo

metadata

@@ -1,12 +1,12 @@
 --- !ruby/object:Gem::Specification
 name: parse-stack-next
 version: !ruby/object:Gem::Version
-  version: 5.1.1
+  version: 5.2.1
 platform: ruby
 authors:
+- Adrian Curtin
 - Anthony Persaud
 - Henry Spindell
-- Adrian Curtin
 bindir: bin
 cert_chain: []
 date: 1980-01-02 00:00:00.000000000 Z
@@ -257,6 +257,7 @@ files:
 - lib/parse-stack.rb
 - lib/parse/acl_scope.rb
 - lib/parse/agent.rb
+- lib/parse/agent/approval_gate.rb
 - lib/parse/agent/cancellation_token.rb
 - lib/parse/agent/constraint_translator.rb
 - lib/parse/agent/describe.rb
@@ -265,10 +266,12 @@ files:
 - lib/parse/agent/mcp_dispatcher.rb
 - lib/parse/agent/mcp_rack_app.rb
 - lib/parse/agent/mcp_server.rb
+- lib/parse/agent/mcp_subscriptions.rb
 - lib/parse/agent/metadata_audit.rb
 - lib/parse/agent/metadata_dsl.rb
 - lib/parse/agent/metadata_registry.rb
 - lib/parse/agent/pipeline_validator.rb
+- lib/parse/agent/prompt_hardening.rb
 - lib/parse/agent/prompts.rb
 - lib/parse/agent/rate_limiter.rb
 - lib/parse/agent/relation_graph.rb
@@ -391,6 +394,11 @@ files:
 - lib/parse/query/n_plus_one_detector.rb
 - lib/parse/query/operation.rb
 - lib/parse/query/ordering.rb
+- lib/parse/retrieval.rb
+- lib/parse/retrieval/agent_tool.rb
+- lib/parse/retrieval/chunk.rb
+- lib/parse/retrieval/chunker.rb
+- lib/parse/retrieval/retriever.rb
 - lib/parse/schema.rb
 - lib/parse/schema/index_migrator.rb
 - lib/parse/schema/search_index_migrator.rb