feat(conversation-memory): add file-based logging system

[baleen37]

Summary

• Add file-based logging system for debugging conversation-memory plugin
• Logs stored in ~/.config/conversation-memory/logs/YYYY-MM-DD.log
• Track API calls, token usage, summarization progress, and errors

Changes

• logger.ts: New module with logInfo, logError, logWarn, logDebug functions
• paths.ts: Added getLogDir() and getLogFilePath() functions
• summarizer.ts: Log API calls, token usage, and summarization results
• indexer.ts: Log errors during summary generation

Key Design Decision

logError() writes to file only (no stderr) to prevent error details from leaking into LLM context when run as a CLI tool. This addresses the concern that stderr output can be captured and included in the LLM's prompt.

Log Format

[2026-02-05T14:23:45.123Z] [INFO] API call started {"model":"haiku","apiUrl":"default","hasToken":false}
[2026-02-05T14:23:47.456Z] [INFO] Summarization completed (direct) {"filename":"...","wordCount":42,"inputTokens":1234,"outputTokens":56}

Test Plan

• Run conversation-memory sync to verify logging works
• Check log file created at ~/.config/conversation-memory/logs/
• Verify errors are logged to file only (no stderr pollution)

🤖 Generated with Claude Code

Summary by CodeRabbit

• New Features

  • Added comprehensive logging system for conversation memory operations with file-based storage and configurable debug mode.
  • Enhanced summarization workflow with detailed logging for API calls, chunk processing, and completion tracking.

• Improvements

  • Improved error reporting with enhanced context and file traceability for better debugging and monitoring.

[coderabbitai]

Caution

Review failed

The pull request is closed.

📝 Walkthrough

Walkthrough

Adds structured file-based logging infrastructure to the conversation-memory plugin. Introduces a logger module with LogLevel enum and four logging functions (logInfo, logWarn, logError, logDebug). Updates indexer and summarizer to integrate logging, adds path utilities for log file management, and enhances summarizeConversation with a filename parameter for improved traceability.

Changes

Cohort / File(s)	Summary
Logging Infrastructure plugins/conversation-memory/src/core/logger.ts	New structured logger module with LogLevel enum, LogEntry interface, and four public logging functions (logInfo, logWarn, logError, logDebug). Supports file-based logging with timestamps, optional error serialization, and environment-gated debug logging. Includes internal helpers for formatting and file I/O.
Path Utilities plugins/conversation-memory/src/core/paths.ts	Adds two utility functions: getLogDir() to ensure and return log directory under superpowers config path, and getLogFilePath() to build daily log file paths using YYYY-MM-DD format.
Indexer Integration plugins/conversation-memory/src/core/indexer.ts	Integrates logging utilities and error reporting. Updates three summarizeConversation calls to pass filename/path context as third parameter for better traceability (in indexConversations, indexSession, and indexUnprocessed functions).
Summarizer Enhancements plugins/conversation-memory/src/core/summarizer.ts	Adds filename parameter to summarizeConversation signature and integrates comprehensive logging throughout: API call lifecycle tracking, trivial conversation detection, chunk-level failure reporting, and hierarchical synthesis completion with token usage metrics.

Estimated code review effort

🎯 2 (Simple) | ⏱️ ~15 minutes

Possibly related PRs

• feat(conversation-memory): reduce token usage in summarization #397: Modifies summarization flow in the same core/summarizer.ts file; both PRs add logging and pass filename context to the summarizeConversation function, indicating parallel observability enhancements to the summarization pipeline.

Suggested labels

enhancement

Poem

🐰 Hop along, dear logs now flow,
Through paths and summarizers' glow,
Structured traces, file by file,
Debugging made worthwhile! 🌱

✨ Finishing touches

• 📝 Generate docstrings

🧪 Generate unit tests (beta)

• Create PR with unit tests
• Post copyable unit tests in a comment
• Commit unit tests in branch fix/conversion-memory

---

Thanks for using CodeRabbit! It's free for OSS, and your support helps us grow. If you like it, consider giving us a shout-out.

❤️ Share

• X
• Mastodon
• Reddit
• LinkedIn

_{Comment @coderabbitai help to get the list of available commands and usage tips.}