@bodhi-ventures/aiocs 0.3.0 → 0.4.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
@@ -13,7 +13,6 @@ Local-only documentation fetch, versioning, and search CLI for AI agents.
13
13
  - diffs snapshots to show what changed between fetches
14
14
  - indexes heading-aware chunks in SQLite FTS5
15
15
  - adds optional hybrid retrieval with local Ollama embeddings and a dedicated Qdrant vector index
16
- - compiles derived research workspaces into Markdown wiki artifacts with LM Studio
17
16
  - links docs sources to local projects for scoped search
18
17
  - exports and imports manifest-backed backups for `~/.aiocs`
19
18
 
@@ -201,83 +200,6 @@ docs verify coverage hyperliquid /absolute/path/to/reference.md
201
200
 
202
201
  When `docs search` runs inside a linked project, it automatically scopes to that project's linked sources unless `--source` or `--all` is provided.
203
202
 
204
- ### Research workspaces
205
-
206
- `aiocs` can compile a derived workspace wiki on top of canonical source snapshots. Workspace artifacts are stored separately from fetched sources under `~/.aiocs/data/workspaces/<workspace-id>/` and keep provenance links back to source chunks.
207
-
208
- LM Studio is the v1 compiler runtime. Load `google/gemma-4-26b-a4b` in LM Studio, start the local API server, and make sure `doctor` can see it:
209
-
210
- ```bash
211
- docs --json doctor
212
- ```
213
-
214
- If LM Studio is running on a non-default host or model, override:
215
-
216
- ```bash
217
- export AIOCS_LMSTUDIO_BASE_URL=ws://127.0.0.1:1234
218
- export AIOCS_LMSTUDIO_MODEL=google/gemma-4-26b-a4b
219
- ```
220
-
221
- These environment overrides apply at runtime, including for already-created workspaces.
222
-
223
- Create, bind, compile, and search a workspace:
224
-
225
- ```bash
226
- docs workspace create market-structure --label "Market Structure" --auto-compile
227
- docs workspace bind market-structure hyperliquid nktkas-hyperliquid
228
- docs workspace compile market-structure
229
- docs workspace status market-structure
230
- docs workspace queue-run
231
- docs workspace search market-structure "transport and websocket design" --scope mixed
232
- docs workspace artifact list market-structure
233
- docs workspace artifact show market-structure derived/index.md
234
- docs workspace lint market-structure
235
- docs workspace output market-structure report --name weekly-brief
236
- docs workspace output market-structure slides --name weekly-brief
237
- docs workspace answer market-structure note "What changed in websocket transport?" --name websocket-note
238
- ```
239
-
240
- Workspace compile and maintenance are incremental:
241
-
242
- - canonical source snapshots remain the source of truth
243
- - unchanged sources are skipped on later compiles
244
- - changed sources regenerate only their derived summaries/concepts plus the shared index
245
- - changed raw inputs regenerate only their derived summaries/concepts plus the shared index
246
- - compiled artifacts get deterministic graph navigation with outgoing relations and backlinks
247
- - workspace lint persists durable suggestion artifacts for duplicate concepts, missing articles, and follow-up questions
248
- - generated reports/slides keep provenance to the bound source snapshots
249
- - generated notes/reports/slides are marked stale when their inputs change
250
-
251
- Opt-in automatic recompilation:
252
-
253
- - set `--auto-compile` when creating the workspace, or later with `docs workspace configure <workspace-id> --auto-compile true`
254
- - the daemon queues recompiles after bound source refreshes
255
- - run `docs workspace queue-run` to process queued jobs outside the daemon
256
-
257
- Workspace-scoped raw ingest:
258
-
259
- ```bash
260
- docs workspace ingest add market-structure markdown-dir /absolute/path/to/notes --label "Research notes"
261
- docs workspace ingest add market-structure pdf /absolute/path/to/paper.pdf --label "Paper PDF"
262
- docs workspace ingest add market-structure image /absolute/path/to/diagram.png --label "Market diagram"
263
- docs workspace ingest add market-structure csv /absolute/path/to/fills.csv --label "Fills CSV"
264
- docs workspace ingest add market-structure json /absolute/path/to/manifest.json --label "Research manifest"
265
- docs workspace ingest add market-structure jsonl /absolute/path/to/events.jsonl --label "Events JSONL"
266
- docs workspace ingest list market-structure
267
- docs workspace ingest search market-structure "fee tier" --kind markdown-dir
268
- docs workspace ingest show market-structure markdown-dir-notes-<hash>
269
- ```
270
-
271
- Obsidian sync:
272
-
273
- ```bash
274
- docs workspace sync obsidian market-structure /absolute/path/to/obsidian-vault
275
- ```
276
-
277
- The workspace is synced under `aiocs/<workspace-id>/` by default so the raw, derived, and output trees stay grouped inside the vault.
278
-
279
- If any bound source snapshot changes, rerun `docs workspace compile <workspace-id>` before `docs workspace output ...`. Output generation fails closed when required derived artifacts are stale.
280
-
281
203
  For agents, the intended decision order is:
282
204
 
283
205
  1. check `source list` or scoped `search` first