@bodhi-ventures/aiocs 0.5.3 → 0.6.0

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/README.md CHANGED
@@ -58,7 +58,10 @@ aiocs --json version
58
58
  aiocs --json doctor
59
59
  aiocs --json init --no-fetch
60
60
  aiocs --json source list
61
+ aiocs --json source describe hyperliquid
62
+ aiocs --json page list hyperliquid --query "auth"
61
63
  aiocs --json search "maker flow" --source hyperliquid
64
+ aiocs --json retrieve "where is maker flow documented" --source hyperliquid --mode lexical
62
65
  aiocs --json show 42
63
66
  ```
64
67
 
@@ -181,6 +184,10 @@ aiocs project unlink /absolute/path/to/project lighter
181
184
  Search and inspect results:
182
185
 
183
186
  ```bash
187
+ aiocs source describe hyperliquid
188
+ aiocs source context show hyperliquid
189
+ aiocs page list hyperliquid --query "auth"
190
+ aiocs page show hyperliquid --url "https://hyperliquid.gitbook.io/hyperliquid-docs/for-developers/api"
184
191
  aiocs search "maker flow" --source hyperliquid
185
192
  aiocs search "WebSocketTransport" --source nktkas-hyperliquid --path "src/**" --language typescript
186
193
  aiocs search "maker flow" --source hyperliquid --mode lexical
@@ -198,14 +205,25 @@ aiocs backup export /absolute/path/to/backup
198
205
  aiocs verify coverage hyperliquid /absolute/path/to/reference.md
199
206
  ```
200
207
 
208
+ Awareness and learning flow:
209
+
210
+ ```bash
211
+ aiocs source context upsert hyperliquid ~/.aiocs/source-context/hyperliquid.yaml
212
+ aiocs learning save --source hyperliquid --kind discovery --intent "maker flow" --page-url "https://..."
213
+ aiocs learning list --source hyperliquid
214
+ aiocs retrieve "where is maker flow documented" --source hyperliquid --mode lexical
215
+ ```
216
+
201
217
  When `aiocs search` runs inside a linked project, it automatically scopes to that project's linked sources unless `--source` or `--all` is provided.
202
218
 
203
219
  For agents, the intended decision order is:
204
220
 
205
- 1. check `source list` or scoped `search` first
221
+ 1. check `source list`, `source describe`, or `page list` first
206
222
  2. if the source exists and is due, run `refresh due <source-id>`
207
- 3. if the source is missing but worth reusing, add a spec under `~/.aiocs/sources`, then upsert and refresh only that source
208
- 4. avoid `fetch all` unless the user explicitly asks or the daemon is doing maintenance
223
+ 3. use `search` to shortlist candidates, then `retrieve` or `page show` to read the full page before answering
224
+ 4. if the source is missing but worth reusing, add a spec under `~/.aiocs/sources`, then upsert and refresh only that source
225
+ 5. save durable discoveries or negative paths with `learning save`
226
+ 6. avoid `fetch all` unless the user explicitly asks or the daemon is doing maintenance
209
227
 
210
228
  ### Git repo sources
211
229