upsert-octopus-transactions

Upsert Octopus transactions to the ledger via a two-pass workflow.

1|Updated Aug 5, 2023
One-click install
npx skills add https://github.com/polyipseity/ledger --skill upsert-octopus-transactions
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: upsert-octopus-transactions
Source: https://github.com/polyipseity/ledger/tree/main/.github/skills/upsert-octopus-transactions
Command: npx skills add https://github.com/polyipseity/ledger --skill upsert-octopus-transactions

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

Strict, deterministic workflow for upserting Octopus card transactions to the ledger with explicit user clarification and privacy controls.

Core Features & Use Cases

  • End-to-end two-pass workflow (Pass 1: match/update; Pass 2: add) for Octopus transactions.
  • Mandatory payee mappings and confidential-payee handling using private.yaml.
  • Enforced chronological ordering, mapping validation, and duration updates to existing transactions.

Quick Start

Provide the Octopus transaction data to be reconciled and run the two-pass upsert workflow.

Frequently Asked Questions about upsert-octopus-transactions

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

FAQPage Schema
How do I reconcile Octopus card transactions to my ledger safely?

Reconcile Octopus transactions using a strict two-pass upsert workflow that matches existing entries first, then adds new ones, enforcing exact date/time matching and mandatory payee mappings to prevent guessing.

What is the two-pass workflow for upserting transactions to a ledger?

The two-pass upsert workflow requires Pass 1 to match and update existing ledger entries based on exact time matching, and Pass 2 to add new transactions, ensuring deterministic reconciliation without guessing.

How do I handle confidential payees when mapping Octopus transactions?

Handle confidential payees by reading configurations from private.yaml, applying mandatory payee mappings to ensure sensitive transaction details are correctly processed and mapped during the ledger reconciliation.

Why does my transaction upsert require exact date and time matching?

Exact date and time matching within a strict tolerance of ±1.5 hours is enforced to ensure deterministic upserts, preventing ambiguous matches and guaranteeing that only the correct existing ledger entries are updated.

Can I update the duration of existing journal entries during Octopus transaction reconciliation?

Yes, the reconciliation workflow updates existing journal entries with duration where applicable, ensuring the ledger accurately reflects transaction durations during the first pass of the upsert process.

What are the limitations of automated Octopus transaction reconciliation?

The workflow enforces strict guardrails with no guessing, requiring mandatory payee mappings and chronological ordering, meaning unmatched transactions without valid mappings will fail unless explicitly clarified by the user.