---
id: TASK-20.1
title: Design logging helper + configuration for Kaze
status: Done
assignee:
  - codex
created_date: '2026-02-27 11:46'
updated_date: '2026-02-27 11:53'
labels: []
dependencies: []
references:
  - docs/zync/lua/zync/lib/utils.lua
  - src/lib.rs
  - src/core
parent_task_id: TASK-20
---

## Description

<!-- SECTION:DESCRIPTION:BEGIN -->
Create a logging utility (e.g., `core/log.rs`) with a consistent prefix (mirroring `zync: `). Decide on test suppression (e.g., env var like `KAZE_TESTING` and opt-in `KAZE_LOGS`) similar to zync’s `ZYNC_TESTING`/`ZYNC_LOGS` behavior. Expose a small API for emitting user-facing info messages.
<!-- SECTION:DESCRIPTION:END -->

## Acceptance Criteria
<!-- AC:BEGIN -->
- [x] #1 Logging helper added and used by at least one callsite
- [x] #2 Prefix matches agreed format (ex: `kaze: <msg>`)
- [x] #3 Test suppression behavior defined and documented if introduced
<!-- AC:END -->

## Implementation Plan

<!-- SECTION:PLAN:BEGIN -->
- Review existing stdout/print usage to decide minimal logging API shape.
- Add `core::log` helper with `kaze: ` prefix and optional test suppression envs mirroring zync.
- Wire the helper into one initial callsite to validate usage.
- Document any new env vars if introduced.
<!-- SECTION:PLAN:END -->

## Implementation Notes

<!-- SECTION:NOTES:BEGIN -->
Added `core::log` helper with `kaze: ` prefix and env-based suppression (`KAZE_TESTING`/`KAZE_LOGS`), wired into `cmd_init`, and documented env vars in README/spec. `just check` passes.
<!-- SECTION:NOTES:END -->

## Final Summary

<!-- SECTION:FINAL_SUMMARY:BEGIN -->
Added `core::log` helper with `kaze: ` prefix and env-based suppression (`KAZE_TESTING`/`KAZE_LOGS`), wired it into `cmd_init`, and documented logging env vars in README/spec. Tests: `just check`.
<!-- SECTION:FINAL_SUMMARY:END -->
