Skip to content

Commit 59a7f43

Browse files
committed
use debug for logging, teach agents how to enable debug
Entire-Checkpoint: 072b7f08a759
1 parent 5c3b886 commit 59a7f43

4 files changed

Lines changed: 4 additions & 3 deletions

File tree

CLAUDE.md

Lines changed: 1 addition & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -261,6 +261,7 @@ if settings.IsSummarizeEnabled() {
261261
### Logging vs User Output
262262

263263
- **Internal/debug logging**: Use `logging.Debug/Info/Warn/Error(ctx, msg, attrs...)` from `cmd/entire/cli/logging/`. Writes to `.entire/logs/`.
264+
- **Enabling debug/perf logs locally**: Prefer adding `"log_level": "DEBUG"` to `.entire/settings.local.json` when you need detailed hook/perf logs. This file is gitignored, so it is a low-risk local-only change. `ENTIRE_LOG_LEVEL=debug` also works and takes precedence.
264265
- **User-facing output**: Use `fmt.Fprint*(cmd.OutOrStdout(), ...)` or `cmd.ErrOrStderr()`.
265266

266267
Don't use `fmt.Print*` for operational messages (checkpoint saves, hook invocations, strategy decisions) - those should use the `logging` package.

cmd/entire/cli/checkpoint/committed.go

Lines changed: 1 addition & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -707,7 +707,7 @@ func (s *GitStore) writeTranscript(ctx context.Context, opts WriteCommittedOptio
707707
}
708708
contentHashSpan.End()
709709

710-
logging.Info(logCtx, "write transcript timings",
710+
logging.Debug(logCtx, "write transcript timings",
711711
slog.String("session_id", opts.SessionID),
712712
slog.String("checkpoint_id", opts.CheckpointID.String()),
713713
slog.String("agent", string(opts.Agent)),

cmd/entire/cli/strategy/manual_commit_condensation.go

Lines changed: 1 addition & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -296,7 +296,7 @@ func (s *ManualCommitStrategy) CondenseSession(ctx context.Context, repo *git.Re
296296
writeCommittedV2Span.End()
297297
writeV2Duration := time.Since(writeV2Start)
298298

299-
logging.Info(logCtx, "condense timings",
299+
logging.Debug(logCtx, "condense timings",
300300
slog.String("session_id", state.SessionID),
301301
slog.String("checkpoint_id", checkpointID.String()),
302302
slog.Int64("extract_session_data_ms", extractDuration.Milliseconds()),

cmd/entire/cli/strategy/manual_commit_hooks.go

Lines changed: 1 addition & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -2665,7 +2665,7 @@ func (s *ManualCommitStrategy) carryForwardToNewShadowBranch(
26652665
slog.String("session_id", state.SessionID),
26662666
slog.Int("remaining_files", len(remainingFiles)),
26672667
)
2668-
logging.Info(logCtx, "carry-forward timings",
2668+
logging.Debug(logCtx, "carry-forward timings",
26692669
slog.String("session_id", state.SessionID),
26702670
slog.Int64("write_carry_forward_shadow_ms", duration.Milliseconds()),
26712671
slog.Int("remaining_files", len(remainingFiles)),

0 commit comments

Comments
 (0)