update harness-api proposal based on feedback so far