git:20260521.a5e9657 to git:20260521.3577e90

19 added, 18 removed. Audit A to A.

- # Edge Agent Skill

+ # Edge Esmeralda 2026 Skill — Contributor Notes

- This repo contains a single-file AI agent skill (SKILL.md) for Edge Esmeralda 2026, plus backend infrastructure to keep reference content fresh.

+ This directory is the **popup-specific knowledge layer** for Edge Esmeralda 2026 (May 30 – Jun 27, Healdsburg, CA). The agent-facing content is `SKILL.md`. The Bun project alongside it (`scripts/`, `references/`) regenerates the wiki / website / newsletter references that `SKILL.md` §5 points at.

+ For backend-agnostic EdgeOS API recipes, see the sibling `../edgeos/SKILL.md`. For Index Network discovery, see `../index-network/SKILL.md`. Do not duplicate either backend's content here.

## Project Structure

- - `SKILL.md` — The skill file users download. Self-contained.

- - `references/` — Preprocessed content from Notion wiki, website, newsletter. Generated by indexer.

- - `scripts/index.ts` — Indexer that fetches and preprocesses static sources.

- - `.github/workflows/index-references.yml` — Runs indexer every 15 min.

+ - `SKILL.md` — Popup-specific agent skill: popup constants (popup id, week dates, themes), attendee-directory field semantics, the curated wiki/website/newsletter references, and the "how to obtain EdgeOS tokens" pointer.

+ - `references/` — Preprocessed content from the Edge Esmeralda Notion wiki, the Edge City website, and the Edge Esmeralda Substack newsletter. Regenerated by `scripts/index.ts`.

+ - `scripts/index.ts` — Indexer that fetches and preprocesses static sources into `references/*.md`.

## Commands

- - `bun install` — Install dependencies

- - `bun run scripts/index.ts` — Run indexer to regenerate reference files

- ## Key Data

- - EdgeOS Events API: `api.edgeos.world/api/v1` — calendar, RSVPs, venues. Requires user-supplied personal access token (`eos_live_...`).

- - EdgeOS Citizen Portal: `api-citizen-portal.simplefi.tech`, popup_id `8` — attendee directory

- - Notion Wiki page ID: `317d45cdfc5981d2a571f52b024c5141`

- - Newsletter RSS: `edgeesmeralda2026.substack.com/feed`

+ - `bun install` — Install indexer dependencies.

+ - `bun run scripts/index.ts` — Regenerate `references/` markdown.

- ## Placeholder sections in SKILL.md

- - §4 Spatial Browsing (Geo Browser) — stub, awaiting PR from Geo Browser team. Marker: ``.

+ The indexer is run automatically every 15 minutes by upstream CI (`.github/workflows/index-references.yml` in `Edge-City/edgeclaw-skills`); local runs are only needed when iterating on the indexer itself.

- When the Geo Browser team PRs in their content, they replace the placeholder block with concrete endpoints, auth, examples, and remove the marker comment.

+ ## Key Data

+ - **Popup id**: `43746fd0-bce2-472b-93e4-a438177b2dff` (UUID; the agent passes this to `edgeos`-skill recipes that need a `popup_id`).

+ - **Notion wiki page id**: `317d45cdfc5981d2a571f52b024c5141`.

+ - **Newsletter RSS**: `edgeesmeralda2026.substack.com/feed`.

+ - **Edge City website**: `edgecity.live`.

- (§3 Knowledge Discovery (Index Network) was previously a placeholder; it is now live in SKILL.md with full MCP-server documentation.)

+ ## When updating `SKILL.md`

+ - Bump `version` in the frontmatter (semver: patch for content tweaks, minor for new sections, major for breaking the cross-skill contract with `edgeos`/`index-network`).

+ - Keep this file scoped to popup-specific knowledge. EdgeOS API recipes belong in `../edgeos/SKILL.md`; cross-skill orchestration logic belongs in `../../workspace/`.

+ - The two `<EDGECITY-ONBOARDING-URL>` placeholders in §2 are intentional — they get substituted once EdgeCity publishes the operator onboarding page.

Default to using Bun instead of Node.js.