@gmickel/gno 0.25.0 → 0.25.2
This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
- package/assets/skill/SKILL.md +75 -1
- package/package.json +1 -1
package/assets/skill/SKILL.md
CHANGED
|
@@ -61,18 +61,92 @@ gno search "your query" # BM25 keyword search
|
|
|
61
61
|
|
|
62
62
|
**Retry strategy**: Use default first. If no results: rephrase query, then try `--thorough`.
|
|
63
63
|
|
|
64
|
-
## Common Flags
|
|
64
|
+
## Common Flags (search/vsearch/query/ask)
|
|
65
65
|
|
|
66
66
|
```
|
|
67
67
|
-n <num> Max results (default: 5)
|
|
68
68
|
-c, --collection Filter to collection
|
|
69
69
|
--tags-any <t1,t2> Has ANY of these tags
|
|
70
70
|
--tags-all <t1,t2> Has ALL of these tags
|
|
71
|
+
--since <date> Modified after date (ISO: 2026-03-01)
|
|
72
|
+
--until <date> Modified before date (ISO: 2026-03-31)
|
|
73
|
+
--exclude <terms> Exclude docs containing any term (comma-separated)
|
|
74
|
+
--intent <text> Disambiguate ambiguous queries (e.g. "python" = language not snake)
|
|
71
75
|
--json JSON output
|
|
72
76
|
--files URI list output
|
|
73
77
|
--line-numbers Include line numbers
|
|
74
78
|
```
|
|
75
79
|
|
|
80
|
+
## Advanced: Structured Query Modes (query/ask only)
|
|
81
|
+
|
|
82
|
+
Use `--query-mode` to combine multiple retrieval strategies in one query (repeatable):
|
|
83
|
+
|
|
84
|
+
```bash
|
|
85
|
+
# Combine keyword + hypothetical document
|
|
86
|
+
gno query "API rate limiting" \
|
|
87
|
+
--query-mode "term:rate limit" \
|
|
88
|
+
--query-mode "hyde:how to implement request throttling"
|
|
89
|
+
|
|
90
|
+
# Add intent steering
|
|
91
|
+
gno query "python" \
|
|
92
|
+
--query-mode "term:python" \
|
|
93
|
+
--query-mode "intent:programming language"
|
|
94
|
+
```
|
|
95
|
+
|
|
96
|
+
Modes: `term:<text>` (keyword), `intent:<text>` (disambiguation), `hyde:<text>` (hypothetical doc for semantic matching). Max one hyde per query.
|
|
97
|
+
|
|
98
|
+
## Document Retrieval
|
|
99
|
+
|
|
100
|
+
```bash
|
|
101
|
+
# Full document by URI
|
|
102
|
+
gno get gno://work/readme.md
|
|
103
|
+
|
|
104
|
+
# By document ID
|
|
105
|
+
gno get "#a1b2c3d4"
|
|
106
|
+
|
|
107
|
+
# Specific line range: --from <start> -l <count>
|
|
108
|
+
gno get gno://work/report.md --from 100 -l 20
|
|
109
|
+
|
|
110
|
+
# With line numbers
|
|
111
|
+
gno get gno://work/report.md --line-numbers
|
|
112
|
+
|
|
113
|
+
# Multiple documents
|
|
114
|
+
gno multi-get gno://work/doc1.md gno://work/doc2.md
|
|
115
|
+
```
|
|
116
|
+
|
|
117
|
+
## Search Then Get (common pipeline)
|
|
118
|
+
|
|
119
|
+
```bash
|
|
120
|
+
# Search, get full content of top result
|
|
121
|
+
gno query "auth" --json | jq -r '.results[0].uri' | xargs gno get
|
|
122
|
+
|
|
123
|
+
# Get all results
|
|
124
|
+
gno search "error handling" --json | jq -r '.results[].uri' | xargs gno multi-get
|
|
125
|
+
```
|
|
126
|
+
|
|
127
|
+
## Document Links & Similarity
|
|
128
|
+
|
|
129
|
+
```bash
|
|
130
|
+
# Outgoing links from a document
|
|
131
|
+
gno links gno://notes/readme.md
|
|
132
|
+
|
|
133
|
+
# Find documents linking TO a document (backlinks)
|
|
134
|
+
gno backlinks gno://notes/api-design.md
|
|
135
|
+
|
|
136
|
+
# Find semantically similar documents
|
|
137
|
+
gno similar gno://notes/auth.md
|
|
138
|
+
|
|
139
|
+
# Similar across all collections (not just same collection)
|
|
140
|
+
gno similar gno://notes/auth.md --cross-collection
|
|
141
|
+
|
|
142
|
+
# Stricter threshold (default: 0.7)
|
|
143
|
+
gno similar gno://notes/auth.md --threshold 0.85
|
|
144
|
+
|
|
145
|
+
# Knowledge graph
|
|
146
|
+
gno graph --json
|
|
147
|
+
gno graph -c notes --similar # Include similarity edges
|
|
148
|
+
```
|
|
149
|
+
|
|
76
150
|
## Global Flags
|
|
77
151
|
|
|
78
152
|
```
|
package/package.json
CHANGED