imprint: Skill for Codex

Example Refresh Release

Use this to move verified generated tools into examples/ and publish a patch release. This complements the repo's release skill; follow that skill for the final version, tag, push, and npm verification steps.

Before Editing

Rebase before committing, as required by AGENTS.md:

git status --short --branch
git fetch origin main
git rebase origin/main

Inspect the generated site directory and existing example conventions:

find ~/.imprint/<site> -maxdepth 2 -type f | sort
rg --files examples/<site>
find examples -maxdepth 3 \( -name backends.json -o -name integration.test.ts -o -name '*.test.ts' \) -print | sort

Copy Rules

Copy only active tool artifacts. Exclude local state:

• node_modules/
• sessions/
• dotfiles such as .audit-*, .cdp-jar.json, .teach-state.json, .classifications.json, .build-plan.json, .compile-*, .tool-plan.md
• bun.lock
• generated live integration.test.ts unless the example already commits them
• stale partial tool directories that lack complete index.ts/workflow.json

For generated Google Flights, the active refreshed directories were:

_shared
lookup_flight_locations
get_flight_location_details
get_flight_calendar_prices
search_flights
get_flight_booking_options
validate_flight_itinerary

Use mechanical copy commands for bulk generated artifacts, then use apply_patch for manual docs or test edits.

Documentation And Tests

Update any root or example README references to old tool counts, old tool names, stale audit percentages, or obsolete producer-token contracts.

If tsconfig.json includes examples/**/*, expect checked-in generated tools to typecheck. Update repo tests that assert example tool lists or generated parser behavior, but keep behavioral coverage. For Google Flights, preserve guards that:

• bad/non-batchexecute provider responses throw instead of returning false zeroes;
• one-way encoding works for string and numeric trip-type variants;
• missing return date forces one-way despite round-trip defaults;
• airline filters are rendered as included carriers;
• calendar duplicate dates keep the lowest fare;
• CDP reuse tests use framed batchexecute fixtures and bootstrap HTML matching current captures.