Interaction Logger

A robust utility for appending interaction logs to user-specific history files. It abstracts away JSON parsing, file I/O, and schema validation.

Tool Usage

Call the interaction_logger tool directly:

{
  "action": "log",
  "target": "zhy",
  "role": "assistant",
  "content": "Hello world"
}

{
  "action": "sync"
}

CLI Usage (Legacy)

node skills/interaction-logger/index.js --action log --target <target_alias> --role <role> --content <message>

Arguments

• --action: log or sync
• --target: The user alias.
  • zhy, shiqi, master -> memory/master_history.json
  • fmw, big-brother -> fmw/history.json
• --role: Who is speaking (user | assistant | system). Default: assistant.
• --content: The text content to log.

Why use this?

• Safety: Prevents JSON syntax errors from manual editing.
• Convenience: One-line command vs multi-step read/edit/write.
• Compliance: Ensures mandatory logging rules (from MEMORY.md) are actually followed.

Features

• Atomic Writes: Uses .tmp file + rename to prevent corruption on crash.
• Log Rotation: Automatically rotates log files when they exceed 5MB to filename_YYYY-MM-DD-HHmmss.json.
• Dynamic Targets: Auto-creates log files for new users in memory/users/.
• Sync: Automatically syncs session logs to history files.