highperfocused/grimoire
1
0
Fork 0
mirror of https://github.com/purrgrammer/grimoire.git synced 2026-04-09 15:07:10 +02:00
Code Issues Packages Projects Releases Wiki Activity

Document k-tag filtering for comments, reactions, reposts, and zaps

Browse Source 
Add documentation about the #k tag which specifies target content kind:
- Update kind table entries for 1111, 7, 16, and 9735 to mention k-tag usage
- Add "Filter by target kind" to "What a Single REQ CAN Do" section
- Add new "Comments & Target Kind Filtering" section with query examples

This enables precise queries like "comments on articles" or "zaps on live events"
without client-side filtering.

https://claude.ai/code/session_01G4hiCq3p3JaNKfTQkc4VsW
This commit is contained in:
Claude
2026-02-03 12:03:55 +00:00
parent e1eccacd33
commit cfcbb82ab9
1 changed files with 18 additions and 4 deletions
Download Patch File Download Diff File Expand all files Collapse all files

22
src/prompts/req-assistant-system-prompt.ts
View File

@@ -141,16 +141,16 @@ req [options] [relay...]
| 10 | Group Reply | NIP-29 group chat threaded reply | 29 |
| 13 | Seal | Sealed/wrapped event | 59 |
| 14 | Direct Message | NIP-17 private direct message | 17 |
| 1111 | Comment | Generic comment on any content | 22 |
| 1111 | Comment | Generic comment on any content (uses #k tag for target kind) | 22 |
### Social Interactions
| Kind | Name | Description | NIP |
|------|------|-------------|-----|
| 5 | Deletion | Event deletion request | 09 |
| 6 | Repost | Repost (retweet equivalent) | 18 |
| 7 | Reaction | Reaction (like, emoji, +, -) | 25 |
| 7 | Reaction | Reaction (like, emoji, +, -); uses #k tag for target kind | 25 |
| 8 | Badge Award | Award badge to user | 58 |
| 16 | Generic Repost | Repost any event kind | 18 |
| 16 | Generic Repost | Repost any event kind; uses #k tag for target kind | 18 |
| 9802 | Highlight | Text highlight from content | 84 |
### Media
@@ -179,7 +179,7 @@ req [options] [relay...]
| Kind | Name | Description | NIP |
|------|------|-------------|-----|
| 9734 | Zap Request | Lightning zap request | 57 |
| 9735 | Zap | Zap receipt (payment proof) | 57 |
| 9735 | Zap | Zap receipt (payment proof); uses #k tag for target kind | 57 |
| 9041 | Zap Goal | Fundraising goal | 75 |
| 9321 | Nutzap | Cashu-based zap | 61 |
@@ -297,6 +297,7 @@ req [options] [relay...]
- Filter by multiple authors (OR logic): \`-a npub1...,npub2...\`
- Filter by multiple tags of same type (OR logic): \`-t nostr,bitcoin\`
- Combine different filter fields (AND logic): \`-k 1 -a npub1...\` = kind 1 AND author npub1
- Filter by target kind using #k tag: \`--tag k 30023\` = events targeting articles (comments, reactions, zaps)
- Time range filtering with since/until
- Limit results
- Full-text search (relay-dependent)
@@ -392,6 +393,19 @@ req -k 1621 -a npub1... # Issues by author
req -k 1617 --tag a <repo-addr> # Patches for a repo
\`\`\`
### Comments & Target Kind Filtering (NIP-22)
Comments, reactions, generic reposts, and zaps use the \`k\` tag to indicate the kind of content being targeted. This enables filtering by target content type:
\`\`\`
req -k 1111 --tag k 1 # Comments on notes
req -k 1111 --tag k 30023 # Comments on articles
req -k 1111 --tag k 9802 # Comments on highlights
req -k 1111 -a $contacts --tag k 30023 # Comments from follows on articles
req -k 7 --tag k 30023 # Reactions on articles
req -k 9735 --tag k 30311 # Zaps on live events
req -k 16 --tag k 30023 # Generic reposts of articles
\`\`\`
The \`k\` tag is particularly useful for finding engagement on specific content types without client-side filtering.
---
## NIP Quick Reference