Just Updated Feed

An endless "Just updated" stream on every local page: new places, new reviews and new prices rise to the top by themselves, like a news feed.

The 9 commands inside

A look inside

Build the change log writer at the hook point found in B1.

REQUIREMENTS
- When a refresh replaces data for a local unit, compare old and new, and write one event per real change, following the definitions from B1.
- The FIRST import of a local unit must not flood the feed: write at most {{FIRST_IMPORT_EVENTS — e.g. 10}} events for it, the most relevant ones.
- De-duplicate: within {{DEDUPE_HOURS — e.g. 24}} hours the same item cannot produce the same event kind twice with the same new value. A further change to the same item inside that window replaces the earlier event instead of adding one, so the feed always shows the latest value.
- Storage is capped: keep at most {{EVENTS_PER_UNIT — e.g. 300}} events per local unit and drop the oldest when the cap is reached. Trimming happens in the same write, not in a separate job that might never run.
- Store events so that "newest first for one local unit" is a cheap read: one small file per local unit, or an indexed table if the project already uses a database.
- happened_at is the moment the change was detected, in UTC. Never back-date or forward-date. Events with the same time are ordered by event id. For tests only, the clock can be replaced from config.
- Writes are atomic. A failed write must not corrupt existing events or block the refresh.

Then show me a command or script that refreshes one local unit twice with a small change in between and prints the events produced.
…

First lines of command B2. The pack holds the full text of all 9 commands.

How it works

1. Open START-HERE.html from the pack. Fill in your details once: your stack, your hosting limits, your numbers.
2. Copy each command into your AI coding assistant, in order. The assistant reads your own project and builds the feature inside it.
3. Run the test command. Go live when every case prints PASS.

What you need

• An AI coding assistant that can read and edit your project files, such as Claude Code, Cursor or Windsurf. A chat assistant you paste code into also works, more slowly.
• Access to your website's code and a test copy to try changes on first.
• A few hours, testing included.

Good to know before you buy

• This is a set of instructions for an AI assistant, not ready-made code. The assistant writes the code to fit your site, so results depend on your stack and on the assistant you use.
• Before release, the pack was run end to end by an AI coding assistant on a small PHP 8 sample project with flat files, and the test command passed every case. We have not tested other stacks; the commands are written to be stack-neutral, and the test command shows whether it worked on yours.
• The commands come in English and Vietnamese, as an offline page with copy buttons and as plain text files.
• Nothing in the pack is legal advice.

Questions