Finalize place photos NIP draft, adapt reviews draft #116

Merged
raucao merged 2 commits from doc/nips into master 2026-11-11 17:27:56 +00:00
Owner

This finalizes the two place NIP drafts so they can be published.

The Place Photos NIP (kind 360) is now scoped to photos and videos, frames the osm: scheme as extending NIP-73 (proposed upstream) rather than claiming NIP-73 defines it, defines high precision as a geohash of length 9 or more with recommended resolutions 4/6/7/9, and restricts .content to empty or exactly the primary media URL, documenting the resulting override of NIP-92's content matching. It adds Querying, Client Behavior, Security Considerations and Future Work sections. The published_at and k tags are dropped as unused and redundant.

The Place Reviews NIP (kind 30360) picks up the same shared identifier, geohash and terminology fixes, and corrects a real bug: as an addressable event it must carry a d tag. Reviews now set d equal to the i value, which gives exactly one review per author and place, with update and deletion semantics documented.

The notes.md scratchpad is refreshed with the correct NIP-73 relationship, the rejected-alternative trail, and the live-data observation that motivated the published_at/k decisions.

Verification: pnpm lint passes cleanly, and nak builds and verifies example events for both kinds.

This finalizes the two place NIP drafts so they can be published. The **Place Photos** NIP (kind 360) is now scoped to photos and videos, frames the `osm:` scheme as extending NIP-73 (proposed upstream) rather than claiming NIP-73 defines it, defines high precision as a geohash of length 9 or more with recommended resolutions 4/6/7/9, and restricts `.content` to empty or exactly the primary media URL, documenting the resulting override of NIP-92's content matching. It adds Querying, Client Behavior, Security Considerations and Future Work sections. The `published_at` and `k` tags are dropped as unused and redundant. The **Place Reviews** NIP (kind 30360) picks up the same shared identifier, geohash and terminology fixes, and corrects a real bug: as an addressable event it must carry a `d` tag. Reviews now set `d` equal to the `i` value, which gives exactly one review per author and place, with update and deletion semantics documented. The `notes.md` scratchpad is refreshed with the correct NIP-73 relationship, the rejected-alternative trail, and the live-data observation that motivated the `published_at`/`k` decisions. Verification: `pnpm lint` passes cleanly, and `nak` builds and verifies example events for both kinds.
raucao added 2 commits 2026-11-11 17:24:12 +00:00
Move the git add/commit restriction out of "NEVER RUN" into a new
"ONLY WHEN EXPLICITLY ASKED" section, so agents may stage and commit
only on request.
Finalize Place Photos and Reviews NIP drafts
CI / Lint (pull_request) Successful in 50s
CI / Test (pull_request) Successful in 1m9s
Release Drafter / Update release notes draft (pull_request) Successful in 31s
33670283d1
Photos (kind 360):
- scope to photos and videos; title "Place Photos and Videos"
- osm: scheme framed as extending NIP-73 (proposed upstream); geo:-vs-g and
  OSM-mutability rationale
- geohash: define high precision as length >= 9; resolutions 4/6/7/9
- content: MUST be empty or exactly the primary url; document the NIP-92 override
- imeta: NIP-92/94 field citations, alt as the only description channel,
  video guidance (place documentation, not social video), top-level m MAY
- add Querying, Client Behavior, Security Considerations, Future Work sections
- drop published_at; drop k; json fences; relative links on first mention

Reviews (kind 30360):
- same i/g/querying/terminology fixes; correct NIP-73 title
- fix missing addressable d tag (d = i; one review per author/place) and
  add update/deletion semantics

notes: refresh stale NIP-73/osm note, add live-data line
raucao added the docsnostr labels 2026-11-11 17:24:51 +00:00
raucao merged commit d2c2b722aa into master 2026-11-11 17:27:56 +00:00
raucao deleted branch doc/nips 2026-11-11 17:27:58 +00:00
raucao changed title from Finalize place photos and reviews NIP drafts to Finalize place photos NIP draft, adapt reviews draft 2026-11-11 17:28:23 +00:00
Sign in to join this conversation.