persistent-json-audit-log

Generate crash-safe JSON audit logs with atomic write operations.

Updated May 15, 2026
One-click install
npx skills add https://github.com/ruskibeats/t1d --skill persistent-json-audit-log
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: persistent-json-audit-log
Source: https://github.com/ruskibeats/t1d/tree/main/.pi/skills-archive/persistent-json-audit-log
Command: npx skills add https://github.com/ruskibeats/t1d --skill persistent-json-audit-log

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill includes scripts (resource) components.

What problem does it solve?

This Skill ensures a durable, structured log for operations tracking, ideal for maintaining a crash-safe, human-readable history of tasks.

Core Features & Use Cases

  • Atomic Writes: Ensures crash-safe logging with atomic write operations to prevent partial writes.
  • Structured Entries: Generates entries with structured fields like task ID, agent, status, timestamps, and output paths.
  • Mutation Functions: Provides functions for logging actions, heartbeats, completions, and errors.
  • Query Functions: Offers capabilities to fetch and format log history for analysis.
  • Use Case: Use this Skill in applications where tracking of task executions, operations, and their outcomes is crucial, such as deployment processes or background job monitoring.

Quick Start

Create a new persistent JSON audit log by executing the script: ./log.js initLogStore

Frequently Asked Questions about persistent-json-audit-log

High-intent search queries and answers about installing and using this skill.

FAQPage Schema
How do I create a crash-safe audit log for Node.js operations tracking?

A crash-safe audit log uses atomic write operations to prevent partial entries during failures. This Skill generates a persistent JSON log with structured fields like task ID, status, and timestamps to ensure data integrity.

What is atomic file writing and when do I need it for structured logging?

Atomic file writing uses rename operations to guarantee a log file is either fully written or remains unchanged. You need it for structured logging when tracking critical task executions where partial writes could corrupt the audit history.

How do I track task dispatches and executions in a persistent JSON log?

You can track task dispatches by using mutation functions to log actions, heartbeats, completions, and errors. The log stores structured entries with agent details and output paths, and query functions fetch this history for analysis.

Can I use this atomic audit log for background job monitoring without external dependencies?

Yes, this audit log operates entirely file-based with no external dependencies. It is suitable for Node.js projects requiring background job monitoring and deployment process tracking without needing a separate database.

What is the best way to prevent partial writes when logging operations to a file?

The best way to prevent partial writes is employing atomic rename operations during file logging. This approach writes to a temporary file first and renames it, ensuring the operations log remains crash-safe and human-readable.

Why does my operations tracking log lose data during unexpected crashes?

Operations tracking logs lose data during crashes if they use direct file writes that leave partial entries. Using an audit log with atomic write operations ensures the file is only updated with complete, structured JSON entries.