---
id: TASK-3.2
title: Update docs in manager for build/execute flow
status: Done
assignee:
  - codex
created_date: '2026-01-29 18:35'
updated_date: '2026-01-29 18:45'
labels: []
dependencies: []
references:
  - lua/zync/api/manager.lua
parent_task_id: TASK-3
---

## Description

<!-- SECTION:DESCRIPTION:BEGIN -->
Add or refresh LuaDoc annotations and comments in `lua/zync/api/manager.lua` for build dir resolution, sysbuild handling, and command execution flow, focusing on critical paths.
<!-- SECTION:DESCRIPTION:END -->

## Acceptance Criteria
<!-- AC:BEGIN -->
- [x] #1 Build dir resolution helpers are documented (including profile-specific behavior)
- [x] #2 Sysbuild image handling (list/resolve/run/flash) is annotated clearly
- [x] #3 Command execution helpers and config usage have concise LuaDoc annotations
- [x] #4 No functional code changes
<!-- AC:END -->

## Implementation Plan

<!-- SECTION:PLAN:BEGIN -->
1) Review `lua/zync/api/manager.lua` for missing or stale LuaDoc blocks.
2) Add/refresh docs for build dir resolution helpers (including profile behavior).
3) Document sysbuild image handling flow (list/resolve/run/flash).
4) Ensure command execution helpers and config usage have concise annotations.
5) Keep formatting consistent with blank-line rule and make no functional changes.
<!-- SECTION:PLAN:END -->

## Implementation Notes

<!-- SECTION:NOTES:BEGIN -->
Added LuaDoc for build/project dir resolution helpers and clarified sysbuild image/command flow in `lua/zync/api/manager.lua`, keeping blank lines between brief/description/params. No functional changes.
<!-- SECTION:NOTES:END -->
