---
id: TASK-5
title: Document private exec helpers
status: In Progress
assignee:
  - codex
created_date: '2026-02-24 13:55'
updated_date: '2026-02-24 13:59'
labels: []
dependencies: []
references:
  - src/core/exec.rs
documentation:
  - docs/spec.md
  - docs/plan.md
---

## Description

<!-- SECTION:DESCRIPTION:BEGIN -->
Add Rust doc comments for private helper functions in exec module to satisfy missing_docs_in_private_items and match existing style.
<!-- SECTION:DESCRIPTION:END -->

## Acceptance Criteria
<!-- AC:BEGIN -->
- [x] #1 `src/core/exec.rs` has doc comments for `pretty_cmd` and `shellish` consistent with existing module style.
- [ ] #2 `just check` shows no missing-doc warnings for exec helpers.
<!-- AC:END -->

## Implementation Plan

<!-- SECTION:PLAN:BEGIN -->
1. Add doc comments above `pretty_cmd` and `shellish` in src/core/exec.rs, mirroring the module’s doc tone.
2. Run `just check` to confirm the missing-doc warnings for exec helpers are resolved.
3. Update the task with results and mark acceptance criteria complete.
<!-- SECTION:PLAN:END -->

## Implementation Notes

<!-- SECTION:NOTES:BEGIN -->
Added/clarified doc comments for pretty_cmd and shellish in src/core/exec.rs. Did not run `just check` yet.
<!-- SECTION:NOTES:END -->
