PointCast

An agent-native broadcast from El Segundo, California: human-readable pages, machine-readable feeds, stable Blocks, and a transparent human-AI collaboration ledger. Every piece of content is a Block — a stable JSON schema with 9 channels, 8 types, and a permanent monotonic ID. Built by Mike Hoydich with Claude (Anthropic), Codex (OpenAI), and Manus. CC0-flavored.

Live: pointcast.xyz · Pattern: /agent-native-publishing · Canonical: /manifesto · Agents: /agents.json · LLMs: /llms.txt

---

What this repo is

PointCast is a real website. The homepage is a living feed of Blocks; every sub-route is a room. The site makes no distinction between human and agent audiences in access — both get the same content. It does distinguish in presentation: AI crawlers trigger stripped HTML mode at the edge (functions/_middleware.ts), humans get the full styled page.

Every human HTML route has a machine-readable JSON counterpart at the same logical URL. Agents don't scrape — they read the endpoints.

Jump to the pattern explainer: /agent-native-publishing. Jump to the project definition: /manifesto.

---

Stack

• Framework: Astro 6.1 (static site + islands)
• Hosting: Cloudflare Pages + Pages Functions
• Chain: Tezos mainnet, integrated via Taquito 25.0 + Beacon via Taquito
• Contracts: SmartPy 0.24 (FA2 for Visit Nouns, FA1.2 for DRUM, custom for Prize Cast)
• Indexing: TzKT for on-chain reads
• Typography: Self-hosted Inter + JetBrains Mono (no Google Fonts)
• Analytics: none

See /stack for the full technical disclosure — including what we deliberately didn't use.

---

The Block primitive

type Block = {
  id: string              // "0205" — 4-digit zero-padded, immutable
  channel: Channel        // one of 9 (FD, CRT, SPN, GF, GDN, ESC, FCT, VST, BTL)
  type: BlockType         // one of 8 (READ, LISTEN, WATCH, MINT, FAUCET, NOTE, VISIT, LINK)
  title: string
  timestamp: Date
  body?: string           // markdown
  dek?: string            // one-line editorial subtitle
  size?: '1x1' | '2x1' | '1x2' | '2x2' | '3x2'   // home grid span
  noun?: number           // Nouns seed 0-1199 (CC0 via noun.pics)
  edition?: {...}         // Tezos FA2/FA1.2 mint metadata
  media?: {...}           // image/audio/video/embed
  external?: {...}        // outbound link with label
  meta?: Record<string,string>
  visitor?: {...}         // human/agent visit metadata
}

Full Zod schema: src/content.config.ts Full spec: BLOCKS.md

IDs are assigned monotonically at authoring time. A retired Block 404s rather than being renumbered — the ID is permanent. Every Block is addressable at /b/{id} (HTML) and /b/{id}.json (machine-readable).

---

Key surfaces

Route	Purpose
/	Home feed — dense auto-fit grid of every Block
/agent-native-publishing	Concise explainer for the website pattern PointCast implements
/manifesto	Canonical Q&A, FAQPage + DefinedTerm JSON-LD
/glossary	Dictionary of PointCast-specific terms with stable anchors
/local	100-mile El Segundo lens: institutions, stations, local blocks
/nature	El Segundo flora, dune habitat, field guide
/garden-yield	Native planting value-yield planner
/houseplants	Indoor plant learning lab: light, water, roots, diagnosis
/meditate	Ocean breathing room: timer, focus mode, local tide log
/haptic-dreams	Real football replay translated into haptics and a living illustrated world
/gandalf	Sitting with Gandalf: V8 cozy sit + Wizard Nouns history
/nouns-cola	Nouns Cola pilot operating board + live planning model

---

On-chain

Contract	Address	Status
Visit Nouns FA2	KT1LP1oTBuudRubAYQDErH7i7mSwazVdohxh	LIVE mainnet
DRUM Token (FA1.2)	contracts/v2/drum_token.py	Written; pending ghostnet
Prize Cast	contracts/v2/prize_cast.py	Written; pending mainnet

---

Agent mode (stripped HTML)

Send a User-Agent starting with ai: or matching GPTBot, ClaudeBot, PerplexityBot, OAI-SearchBot, Atlas, Google-Extended, or Meta-ExternalAgent, and the Cloudflare Pages middleware returns stripped HTML: no stylesheets, no JS (JSON-LD preserved), no preload/preconnect/icon/manifest. Response header: X-Agent-Mode: stripped · ai:<vendor>. Typical payload savings: ~12%.

Source: functions/_middleware.ts

---

Local development

npm install
npm run dev    # Astro dev server at http://localhost:4321
npm run build  # Static build + OG card generation

The build script runs scripts/generate-og-images.mjs first (sharp rasterizes SVG → PNG per Block and per first-class page) then astro build.

Adding a Block: drop a new file in src/content/blocks/ named NNNN.json (next monotonic ID), fill the schema, run npm run build. The sitemap, per-channel feeds, archive, and OG card regenerate automatically.

Publishing live

pointcast.xyz is Cloudflare Pages with no Git hookup: a push to main does not deploy by itself. Deploy with:

scripts/deploy.sh

It builds the tip of origin/main in the shared ~/pc-deploy worktree, queues behind any other deploy, gates on a complete build, and skips if that sha is already live. Details in docs/OPERATIONS.md.

npm run publish:live -- "feat(scope): describe the ship" fetches origin/main, refuses if the current HEAD is behind, builds, commits local changes, pushes HEAD:main, then runs scripts/deploy.sh.

After the deploy: walk the town

The town inspector (scripts/town-inspector.mjs) walks every door /agents.json advertises and re-checks the manifest's claims. Its report is a committed file, src/data/town-inspector-report.json, served at /health and /health.json. Nothing regenerates it at deploy — a dirty tree at deploy time is not a commit — so the deployer runs it against production once the deploy is live and files the report in the next PR:

npm run inspect:town -- --write        # walks https://pointcast.xyz, writes the report
git add src/data/town-inspector-report.json
git commit -m "chore(inspector): walk $(date -u +%Y-%m-%d)"

npm run inspect:town:preview -- https://<hash>.pointcast.pages.dev walks a Pages preview instead (add --write to keep that report; usually you don't). Both surfaces compute the report's age from the build date and mark a walk older than 14 days stale, so a skipped walk shows on the page instead of hiding behind an old CLEAN.

---

Contributing

This is Mike Hoydich's site, not a general-purpose template — but the Block primitive, BLOCKS.md spec, and agent-layer patterns are CC0-flavored. Fork and reuse freely. Cite /manifesto if you want credit traced back.

If you've found a bug in an agent surface (/*.json, /for-agents, stripped HTML mode), file an issue with the request URL and observed response.

---

Citation

PointCast · CH.{CODE} · № {ID} — "{TITLE}" · {YYYY-MM-DD}
https://pointcast.xyz/b/{ID}

Or for the project as a whole:

PointCast — Mike Hoydich · https://pointcast.xyz/manifesto

---

License

Content: CC0-flavored. Nouns IP via noun.pics is CC0 per nouns.wtf.

Code: MIT-flavored — reuse freely with attribution.

See the /manifesto and /glossary for canonical definitions.

---

Contact

• Mike Hoydich — @mhoydich on X · @mhoydich on Farcaster
• Email: [email protected]
• Tezos: tz2FjJhB1gb9Xc2qNB7QgFkdBZkGCCRMxdFw

---

Built by a team of agents. Mike's the eyes.