psi-update-calc

What problem does it solve?

This Skill automates safe, consistent updates to calculation YAML frontmatter in a file-based provenance project, eliminating error-prone manual edits while preserving Markdown bodies and index integrity.

Core Features & Use Cases

• Frontmatter merging and nested updates: Parse field=value pairs with dot notation to update nested keys and lists, supporting updates like key_results.energy=-5.43 and tags=silicon,relaxation.
• Provenance and index maintenance: Update calc_db/index.md entries, adjust parent/child links, and create subjob directories when adding subjobs.
• Multi-job aggregation & safe writes: Auto-aggregate multi-job status from subjob states, perform writes under file locks, and preserve existing markdown content.
• Use Case: Mark a multi-job calculation as completed after its final subjob finishes while ensuring index and parent links remain consistent.

Quick Start

Run the psi-update-calc skill to set calculation c001 status=completed and add tags silicon,relaxation.