fst-action-journals

Guides audit logging for mutations in the Otgruzka warehouse and HR system.

Updated May 5, 2026
One-click install
npx skills add https://github.com/nikegeorgian-stack/otgruzka-tovara --skill fst-action-journals-nikegeorgian-stack
Or copy as Structured Prompt for Agent▼
Please help me install this Agent Skill.
Skill: fst-action-journals
Source: https://github.com/nikegeorgian-stack/otgruzka-tovara/tree/main/.cursor/skills/fst-action-journals
Command: npx skills add https://github.com/nikegeorgian-stack/otgruzka-tovara --skill fst-action-journals-nikegeorgian-stack

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve? Developers adding new mutations (save, approve, delete, rename) to the FiberCell Otgruzka app often forget to write audit journal entries, or write them to the wrong journal. This Skill ensures every user action is correctly logged to the right store (auditLog, warehouse.auditLog, hrJournal, itemHistories) before anyone claims "it's logged". ## Core Features & Use Cases - Journal API Routing: Maps each action type to the correct logging API — appendAudit for timesheets/HR/finance, appendWarehouseAudit for warehouse documents, appendItemHistory for item renames, appendEmployeeJournal for employee changes. - Mutation Checklist: Provides a checklist for new mutations covering actor fields, old→new rename details, AuditEntry action registration, and ring-buffer limits (2000/300/200 entries). - Use Case: When adding a "Rename Brigade" button, use this Skill to confirm the rename writes old→new values via appendAudit with actor fields, and that the new action is registered in AuditEntry labels and classification. ## Quick Start Ask the AI to verify whether a new mutation in the Otgruzka codebase writes the correct audit journal entry using the fst-action-journals checklist.

Frequently Asked Questions about fst-action-journals

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

FAQPage Schema
How do I add audit logging to a new mutation in a warehouse app?▼

Call appendAudit or the domain-specific logger (appendWarehouseAudit, appendItemHistory, appendEmployeeJournal) inside the same setStore as the mutation. Include actor fields (by, byName) and, for renames, old and new values in the detail field.

Which audit log should warehouse document changes use?▼

Warehouse documents, movements, and loadings use appendWarehouseAudit writing to warehouse.auditLog. General actions like timesheets, HR cards, access, finances, and directories use appendAudit writing to the main auditLog.

Why is my action not showing in the journals UI section?▼

The journals feed is built by collectJournalEntries and classifyAuditEntry, and roles see only permitted categories defined in journals/access.ts. Check that your new action is registered in AuditEntry with a label and classification, and that the viewing role has access.

What are the size limits of the audit log ring buffers?▼

The main auditLog keeps 2000 entries, warehouse.auditLog keeps 300, and hrJournal keeps 200. Long-lived entities like employees and items also store history on their own cards, so history survives ring rotation.

When should I not add audit logging?▼

Do not log every UI click, rewrite the logger entirely, or create a separate audit database. The skill covers meaningful mutations like saves, approvals, deletions, and renames only.