---
id: TASK-7
title: Document private command helpers
status: Done
assignee:
  - '@codex'
created_date: '2026-02-24 13:55'
updated_date: '2026-02-24 14:02'
labels: []
dependencies: []
references:
  - src/core/cmd.rs
documentation:
  - docs/spec.md
  - docs/plan.md
---

## Description

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

## Acceptance Criteria
<!-- AC:BEGIN -->
- [x] #1 `src/core/cmd.rs` has doc comments for `cmd_init`, `cmd_profiles`, `cmd_clean_root`, `cmd_conf`, `ensure_configured`, `cmd_build`, `ensure_built`, `cmd_flash`, `cmd_run`, `cmd_west_boards`, `is_configured`, `clean_dir_safe`, `canonical_or`, and `os` consistent with existing module style.
- [x] #2 `just check` shows no missing-doc warnings for cmd helpers.
<!-- AC:END -->

## Implementation Notes

<!-- SECTION:NOTES:BEGIN -->
Started documenting private command helpers.

Added doc comments for private helpers in src/core/cmd.rs. `just check` not run yet.

Fixed doc_markdown by backticking CMake, reran `just check -- -D warnings`: pass.
<!-- SECTION:NOTES:END -->
