pokt-network/pocket-scribe

curate-version-fixtures

Curate FilePlugin fixtures for a poktroll version from the Hetzner archeology bucket — download, scan, select per spec §8.1, generate expected.json, enroll in the golden walker. Use when a new version's tarball lands in the bucket (v0.1.30 / v0.1.31 / v0.1.33…

원문 언어: 영어

add-decoder-version

Onboard a new poktroll chain version — vendor protos, codegen, scaffold decoder, register in router, add CI matrix. Use when poktroll publishes a new release that introduces protobuf changes.

원문 언어: 영어

add-aggregate

Scaffold a new continuous aggregate (rewards_hourly, claims_daily, etc.) following PocketScribe's registry-driven pattern with bucket sealing. Generates migration, registry entry, sealing test, and late-arrival test.

원문 언어: 영어

add-consumer

Scaffold a new consumer module (supplier, application, gateway, etc.) following PocketScribe patterns — generates the consumer Go code, SQL migration, tests, and CLI registration. Enforces TDD by generating tests first.

원문 언어: 영어

generate-decoder

Onboard a poktroll chain version. Vendors protos at the given tag, extracts a structural snapshot of every poktroll-owned message, and computes the diff against the previous vendored version. Produces docs/research/.shapes/<vX_Y_Z>.json (full snapshot) and…

원문 언어: 영어

generate-migration-from-diff

Generate a goose SQL migration for a specific poktroll version from its shape snapshot. Reads docs/research/.shapes/<vX_Y_Z>.json (produced by /generate-decoder), compares against the immediately-previous snapshot, and emits…

원문 언어: 영어

invariant-audit

Audit recent changes (staged, uncommitted, or last N commits) for violations of PocketScribe's hard invariants. Fast guardrail before commit.

원문 언어: 영어

pre-commit-check

Full pre-commit gauntlet — runs gen-check, lint, unit tests, invariant audit. The skill version of `make ci` plus invariant checks.

원문 언어: 영어

reconcile-now

Trigger a one-shot reconciliation pass against the chain. Detects drift between indexed state and chain truth without waiting for the periodic loop.

원문 언어: 영어

replay-module

Replay (reindex) a height range for one or more modules. Used after a decoder bug fix or reconciler drift detection. Wraps `ps replay` with safety checks.

원문 언어: 영어

verify-migrations

Apply all goose migrations against a disposable TimescaleDB container to validate SQL correctness. Spins up timescale/timescaledb:latest-pg18, runs `goose up`, reports the first failure (if any) with the exact PostgreSQL error and the migration filename.…

원문 언어: 영어