chore: update files with annotations and todos