@bodhi-ventures/aiocs 0.3.1 → 0.5.0

package/docs/codex-integration.md

@@ -8,22 +8,22 @@ Install the CLI and MCP binary globally:
 
 ```bash
 npm install -g @bodhi-ventures/aiocs
-docs --version
+aiocs --version
 command -v aiocs-mcp
 ```
 
 If global install is unavailable, use `npx` only as a fallback:
 
 ```bash
-npx -y -p @bodhi-ventures/aiocs docs --version
+npx -y -p @bodhi-ventures/aiocs aiocs --version
 npx -y -p @bodhi-ventures/aiocs aiocs-mcp
 ```
 
 The `aiocs-mcp` process is an MCP stdio server, so running it directly will wait for MCP clients instead of printing interactive help. The useful validation commands are:
 
 ```bash
-docs --json doctor
-docs --json init --no-fetch
+aiocs --json doctor
+aiocs --json init --no-fetch
 ```
 
 Register `aiocs-mcp` as a global Codex MCP server so the main agent can use it directly without shell fallback:
@@ -37,7 +37,7 @@ command = "aiocs-mcp"
 
 1. Prefer `aiocs` before live browsing when the requested docs may already exist locally.
 2. Prefer MCP through `aiocs-mcp` when Codex can use it.
-3. Fall back to `docs --json ...` only when MCP is unavailable.
+3. Fall back to `aiocs --json ...` only when MCP is unavailable.
 4. Check `source_list` before assuming a source is missing or stale.
 5. Default to `search mode=auto`.
 6. Use `mode=lexical` for exact identifiers, endpoint names, headings, and error strings.
@@ -46,7 +46,6 @@ command = "aiocs-mcp"
 9. Prefer `refresh due <source-id>` over force `fetch <source-id>` when the source already exists.
 10. Use MCP `batch` when multiple list/search/show or search/diff/coverage steps are needed.
 11. Cite `sourceId`, `snapshotId`, and `pageUrl` when they materially improve traceability.
-12. If the user is operating on a compiled research workspace, prefer `workspace_search` and `workspace_artifact_show` over raw source search.
 
 ## Automatic use in Codex
 
@@ -83,17 +82,17 @@ ln -sfn "$AIOCS_REPO/agents/aiocs-docs-specialist.toml" ~/.codex/agents/aiocs-do
 Health and bootstrap:
 
 ```bash
-docs --json doctor
-docs --json init --no-fetch
+aiocs --json doctor
+aiocs --json init --no-fetch
 ```
 
 Local docs lookup:
 
 ```bash
-docs --json source list
-docs --json search "maker flow" --source hyperliquid --mode auto
-docs --json search "WebSocketTransport" --source nktkas-hyperliquid --path "src/**" --language typescript --mode lexical
-docs --json show 42
+aiocs --json source list
+aiocs --json search "maker flow" --source hyperliquid --mode auto
+aiocs --json search "WebSocketTransport" --source nktkas-hyperliquid --path "src/**" --language typescript --mode lexical
+aiocs --json show 42
 ```
 
 Missing or stale sources:
@@ -102,45 +101,24 @@ Missing or stale sources:
 # user-managed source specs live here
 ~/.aiocs/sources
 
-docs --json source upsert ~/.aiocs/sources/my-source.yaml
-docs --json refresh due my-source
+aiocs --json source upsert ~/.aiocs/sources/my-source.yaml
+aiocs --json refresh due my-source
 ```
 
 Drift, change, and completeness:
 
 ```bash
-docs --json canary hyperliquid
-docs --json diff hyperliquid
-docs --json verify coverage hyperliquid /absolute/path/to/reference.md
+aiocs --json canary hyperliquid
+aiocs --json diff hyperliquid
+aiocs --json verify coverage hyperliquid /absolute/path/to/reference.md
 ```
 
-Research workspaces:
-
-```bash
-docs --json workspace create market-structure --label "Market Structure" --auto-compile
-docs --json workspace bind market-structure hyperliquid nktkas-hyperliquid
-docs --json workspace compile market-structure
-docs --json workspace queue-run
-docs --json workspace search market-structure "transport design" --scope mixed
-docs --json workspace artifact show market-structure derived/index.md
-docs --json workspace lint market-structure
-docs --json workspace output market-structure report --name weekly-brief
-docs --json workspace answer market-structure note "What changed in websocket transport?" --name websocket-note
-docs --json workspace ingest add market-structure markdown-dir /absolute/path/to/notes --label "Research notes"
-docs --json workspace ingest add market-structure csv /absolute/path/to/fills.csv --label "Fills CSV"
-docs --json workspace ingest add market-structure json /absolute/path/to/manifest.json --label "Research manifest"
-docs --json workspace ingest add market-structure jsonl /absolute/path/to/events.jsonl --label "Events JSONL"
-docs --json workspace sync obsidian market-structure /absolute/path/to/vault
-```
-
-If bound source snapshots have changed since the last compile, rerun `workspace compile` before `workspace output`. The output path now fails closed on stale derived artifacts instead of synthesizing reports from outdated summaries.
-
 Catalog maintenance:
 
 ```bash
-docs --json refresh due hyperliquid
-docs --json embeddings status
-docs --json backup export /absolute/path/to/backup
+aiocs --json refresh due hyperliquid
+aiocs --json embeddings status
+aiocs --json backup export /absolute/path/to/backup
 ```
 
 ## MCP-first guidance
@@ -156,26 +134,8 @@ If a Codex agent has access to the `aiocs-mcp` server, prefer these MCP tools ov
 - `diff_snapshots`
 - `verify_coverage`
 - `embeddings_status`
-- `workspace_list`
-- `workspace_status`
-- `workspace_search`
-- `workspace_ingest_list`
-- `workspace_ingest_search`
-- `workspace_artifact_list`
-- `workspace_artifact_show`
-- `workspace_lint`
 - `batch`
 
-Use mutating tools such as `source_upsert`, `refresh_due`, `fetch`, `workspace_create`, `workspace_bind`, `workspace_compile`, and `workspace_output` only through the `aiocs-curation` workflow.
-
-## LM Studio requirement for workspaces
-
-Workspace compilation and output generation use LM Studio in v1. Codex should assume:
-
-- provider: LM Studio
-- model: `google/gemma-4-26b-a4b`
-- default API endpoint: `ws://127.0.0.1:1234`
-
-If `doctor` reports the `lmstudio` check as `warn` or `fail`, Codex should not claim workspace compilation is available until LM Studio is running and the configured model is loaded.
+Use mutating tools such as `source_upsert`, `refresh_due`, and `fetch` only through the `aiocs-curation` workflow.
 
 The CLI remains the fallback and should always be invoked with `--json` for agent use. For normal answering flows, avoid `fetch all`; use targeted due refresh or explicit user-approved force fetches.

package/docs/json-contract.md

@@ -54,26 +54,6 @@ All of these support the root-level `--json` flag:
 - `diff`
 - `project link`
 - `project unlink`
-- `workspace create`
-- `workspace configure`
-- `workspace list`
-- `workspace bind`
-- `workspace unbind`
-- `workspace compile`
-- `workspace queue-run`
-- `workspace status`
-- `workspace search`
-- `workspace ingest add`
-- `workspace ingest list`
-- `workspace ingest show`
-- `workspace ingest search`
-- `workspace ingest remove`
-- `workspace artifact list`
-- `workspace artifact show`
-- `workspace lint`
-- `workspace output`
-- `workspace answer`
-- `workspace sync obsidian`
 - `backup export`
 - `backup import`
 - `embeddings status`
@@ -151,7 +131,6 @@ Check ids are currently:
 - `source-spec-dirs`
 - `freshness`
 - `daemon-heartbeat`
-- `lmstudio`
 - `embedding-provider`
 - `vector-store`
 - `embeddings`
@@ -266,405 +245,6 @@ Summary status values:
 }
 ```
 
-### Workspace commands
-
-Workspace commands manage derived wiki artifacts backed by canonical source snapshots and LM Studio compilation.
-
-#### `workspace.create`
-
-```json
-{
-  "workspace": {
-    "id": "market-structure",
-    "label": "Market Structure",
-    "compilerProfile": {
-      "provider": "lmstudio",
-      "model": "google/gemma-4-26b-a4b",
-      "temperature": 0.1,
-      "topP": 0.9,
-      "maxInputChars": 12000,
-      "maxOutputTokens": 4096,
-      "concurrency": 1
-    },
-    "defaultOutputFormats": ["report", "slides"]
-  }
-}
-```
-
-#### `workspace.list`
-
-```json
-{
-  "workspaces": [
-    {
-      "id": "market-structure",
-      "label": "Market Structure",
-      "bindingCount": 2,
-      "artifactCount": 5,
-      "lastCompileStatus": "success"
-    }
-  ]
-}
-```
-
-#### `workspace.bind` and `workspace.unbind`
-
-```json
-{
-  "workspaceId": "market-structure",
-  "sourceIds": ["hyperliquid", "nktkas-hyperliquid"]
-}
-```
-
-#### `workspace.configure`
-
-```json
-{
-  "workspace": {
-    "id": "market-structure",
-    "label": "Market Structure",
-    "autoCompileEnabled": true
-  }
-}
-```
-
-#### `workspace.compile`
-
-```json
-{
-  "workspaceId": "market-structure",
-  "skipped": false,
-  "sourceFingerprint": "sha256...",
-  "changedSourceIds": ["hyperliquid"],
-  "changedRawInputIds": [],
-  "updatedArtifactPaths": [
-    "derived/sources/hyperliquid/summary.md",
-    "derived/concepts/hyperliquid.md",
-    "derived/index.md"
-  ],
-  "artifactCount": 3,
-  "compileRunId": "wrkcmp_..."
-}
-```
-
-#### `workspace.queue-run`
-
-```json
-{
-  "processedJobs": 1,
-  "succeededJobs": [
-    {
-      "workspaceId": "market-structure",
-      "sourceFingerprint": "sha256...",
-      "changedSourceIds": ["hyperliquid"],
-      "changedRawInputIds": []
-    }
-  ],
-  "failedJobs": []
-}
-```
-
-#### `workspace.status`
-
-```json
-{
-  "workspace": {
-    "id": "market-structure",
-    "label": "Market Structure",
-    "autoCompileEnabled": true
-  },
-  "bindings": [
-    {
-      "workspaceId": "market-structure",
-      "sourceId": "hyperliquid",
-      "createdAt": "2026-04-03T10:00:00.000Z"
-    }
-  ],
-  "artifacts": [
-    {
-      "workspaceId": "market-structure",
-      "path": "derived/index.md",
-      "kind": "index",
-      "stale": false,
-      "chunkCount": 3
-    }
-  ],
-  "compileJob": {
-    "workspaceId": "market-structure",
-    "status": "pending",
-    "requestedSourceIds": ["hyperliquid"],
-    "requestedRawInputIds": [],
-    "requestedFingerprint": null
-  },
-  "rawInputs": [],
-  "syncTargets": [],
-  "questionRuns": [],
-  "links": [],
-  "graph": {
-    "linkCount": 4,
-    "brokenLinkCount": 0,
-    "orphanArtifactCount": 0,
-    "backlinkCount": 4,
-    "relationCounts": {
-      "explicit_link": 0,
-      "derived_from": 1,
-      "mentions": 1,
-      "related_to": 2,
-      "expands": 1,
-      "index_entry": 2,
-      "summary_of": 1,
-      "concept_of": 1,
-      "output_depends_on": 0
-    },
-    "mostLinkedArtifacts": [
-      {
-        "artifactPath": "derived/index.md",
-        "incomingCount": 0,
-        "outgoingCount": 2
-      }
-    ]
-  },
-  "lintSummary": {
-    "status": "pass",
-    "findingCount": 0,
-    "staleArtifactCount": 0,
-    "missingProvenanceCount": 0,
-    "missingArtifactCount": 0,
-    "brokenLinkCount": 0,
-    "orphanArtifactCount": 0,
-    "suggestedConceptCount": 0,
-    "duplicateConceptCandidateCount": 0,
-    "missingArticleCandidateCount": 0,
-    "followUpQuestionCount": 0
-  },
-  "health": {
-    "status": "healthy",
-    "staleArtifactCount": 0,
-    "pendingCompileJobs": 0,
-    "failedCompileJobs": 0,
-    "brokenLinkCount": 0,
-    "orphanArtifactCount": 0,
-    "rawInputCount": 0,
-    "lintFindingCount": 0,
-    "duplicateConceptCandidateCount": 0,
-    "missingArticleCandidateCount": 0,
-    "followUpQuestionCount": 0
-  },
-  "compileRuns": [
-    {
-      "id": "wrkcmp_...",
-      "status": "success"
-    }
-  ]
-}
-```
-
-#### `workspace.ingest.*`
-
-```json
-{
-  "workspaceId": "market-structure",
-  "rawInput": {
-    "id": "csv-fills-abc123def0",
-    "workspaceId": "market-structure",
-    "kind": "csv",
-    "label": "Fills CSV",
-    "sourcePath": "/absolute/path/to/fills.csv",
-    "storagePath": "raw/csv-fills-abc123def0/fills.csv",
-    "extractedTextPath": "raw/csv-fills-abc123def0/fills.csv.txt",
-    "contentHash": "sha256...",
-    "chunkCount": 12
-  }
-}
-```
-
-Raw-input search returns:
-
-```json
-{
-  "workspaceId": "market-structure",
-  "query": "fee tier",
-  "total": 1,
-  "limit": 10,
-  "offset": 0,
-  "hasMore": false,
-  "results": [
-    {
-      "rawInputId": "csv-fills-abc123def0",
-      "kind": "csv",
-      "label": "Fills CSV",
-      "sectionTitle": "Fills CSV rows 1-2",
-      "markdown": "...",
-      "filePath": "fills.csv",
-      "score": 0.42
-    }
-  ]
-}
-```
-
-#### `workspace.search`
-
-```json
-{
-  "workspaceId": "market-structure",
-  "query": "transport design",
-  "scope": "mixed",
-  "limit": 10,
-  "offset": 0,
-  "hasMore": false,
-  "modeRequested": "auto",
-  "modeUsed": "hybrid",
-  "total": 2,
-  "results": [
-    {
-      "kind": "source",
-      "scope": "source",
-      "chunkId": 42,
-      "sourceId": "nktkas-hyperliquid",
-      "snapshotId": "snp_...",
-      "pageUrl": "file://src/transports/websocket.ts",
-      "pageTitle": "src/transports/websocket.ts",
-      "sectionTitle": "WebSocketTransport",
-      "markdown": "...",
-      "pageKind": "file",
-      "filePath": "src/transports/websocket.ts",
-      "language": "typescript",
-      "score": 0.91,
-      "signals": ["lexical", "vector"]
-    },
-    {
-      "kind": "derived",
-      "scope": "derived",
-      "artifactPath": "derived/concepts/nktkas-hyperliquid.md",
-      "artifactKind": "concept",
-      "sectionTitle": "Transport design",
-      "markdown": "...",
-      "stale": false,
-      "score": 0.74
-    }
-  ]
-}
-```
-
-#### `workspace.artifact.list`
-
-```json
-{
-  "workspaceId": "market-structure",
-  "artifacts": [
-    {
-      "workspaceId": "market-structure",
-      "path": "derived/index.md",
-      "kind": "index",
-      "stale": false,
-      "chunkCount": 3
-    }
-  ]
-}
-```
-
-#### `workspace.artifact.show`
-
-```json
-{
-  "workspaceId": "market-structure",
-  "artifact": {
-    "workspaceId": "market-structure",
-    "path": "derived/index.md",
-    "kind": "index",
-    "stale": false
-  },
-  "content": "# Workspace Index\n...",
-  "provenance": [
-    {
-      "workspaceId": "market-structure",
-      "path": "derived/index.md",
-      "sourceId": "hyperliquid",
-      "snapshotId": "snp_...",
-      "chunkIds": [42, 43]
-    }
-  ],
-  "rawInputProvenance": []
-}
-```
-
-#### `workspace.lint`
-
-```json
-{
-  "workspaceId": "market-structure",
-  "summary": {
-    "status": "warn",
-    "findingCount": 1,
-    "staleArtifactCount": 1,
-    "missingProvenanceCount": 0,
-    "missingArtifactCount": 0,
-    "brokenLinkCount": 0,
-    "orphanArtifactCount": 0,
-    "suggestedConceptCount": 0,
-    "duplicateConceptCandidateCount": 1,
-    "missingArticleCandidateCount": 1,
-    "followUpQuestionCount": 2
-  },
-  "findings": [
-    {
-      "kind": "stale-artifact",
-      "severity": "warn",
-      "summary": "Artifact provenance points at an older snapshot.",
-      "artifactPath": "derived/sources/hyperliquid/summary.md"
-    },
-    {
-      "kind": "follow-up-question-suggestion",
-      "severity": "warn",
-      "summary": "What important workflows, caveats, or open questions remain unresolved for derived/concepts/hyperliquid.md?",
-      "artifactPath": "derived/concepts/hyperliquid.md"
-    }
-  ],
-  "suggestionsArtifactPath": "outputs/suggestions/lint.md"
-}
-```
-
-#### `workspace.output`
-
-```json
-{
-  "workspaceId": "market-structure",
-  "format": "report",
-  "path": "outputs/reports/weekly-brief.md",
-  "artifactCount": 8
-}
-```
-
-#### `workspace.answer`
-
-```json
-{
-  "workspaceId": "market-structure",
-  "format": "note",
-  "path": "derived/notes/websocket-note.md",
-  "artifactCount": 9,
-  "questionRun": {
-    "id": "wrkq_...",
-    "workspaceId": "market-structure",
-    "question": "What changed in websocket transport?",
-    "format": "note",
-    "artifactPath": "derived/notes/websocket-note.md",
-    "status": "success"
-  }
-}
-```
-
-#### `workspace.sync.obsidian`
-
-```json
-{
-  "workspaceId": "market-structure",
-  "vaultPath": "/absolute/path/to/vault",
-  "targetPath": "/absolute/path/to/vault/aiocs/market-structure",
-  "exportSubdir": "aiocs/market-structure"
-}
-```
-
 ### `diff`
 
 ```json
@@ -890,7 +470,7 @@ Raw-input search returns:
 
 ## Daemon event stream
 
-`docs daemon --json` is intentionally different because the process is long-running. It emits newline-delimited JSON events to stdout rather than a single envelope.
+`aiocs daemon --json` is intentionally different because the process is long-running. It emits newline-delimited JSON events to stdout rather than a single envelope.
 
 Current event types:
 
@@ -914,11 +494,6 @@ Current stable CLI error codes include:
 
 - `INVALID_ARGUMENT`
 - `SOURCE_NOT_FOUND`
-- `WORKSPACE_NOT_FOUND`
-- `WORKSPACE_ARTIFACT_NOT_FOUND`
-- `WORKSPACE_ARTIFACTS_STALE`
-- `WORKSPACE_COMPILER_CONFIG_INVALID`
-- `WORKSPACE_COMPILER_UNAVAILABLE`
 - `SNAPSHOT_NOT_FOUND`
 - `NO_PAGES_FETCHED`
 - `NO_PROJECT_SCOPE`

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@bodhi-ventures/aiocs",
-  "version": "0.3.1",
+  "version": "0.5.0",
   "license": "MIT",
   "type": "module",
   "description": "Local-only documentation store, fetcher, and search CLI for AI agents.",
@@ -33,7 +33,7 @@
     "skills"
   ],
   "bin": {
-    "docs": "./dist/cli.js",
+    "aiocs": "./dist/cli.js",
     "aiocs-mcp": "./dist/mcp-server.js"
   },
   "engines": {
@@ -48,15 +48,12 @@
     "test:watch": "vitest"
   },
   "dependencies": {
-    "@lmstudio/sdk": "1.5.0",
     "@modelcontextprotocol/sdk": "1.28.0",
     "@mozilla/readability": "0.6.0",
     "@qdrant/js-client-rest": "1.17.0",
     "better-sqlite3": "12.4.1",
     "commander": "14.0.1",
-    "csv-parse": "6.2.1",
     "jsdom": "27.0.1",
-    "pdf-parse": "2.4.5",
     "playwright": "1.57.0",
     "turndown": "7.2.1",
     "turndown-plugin-gfm": "1.0.2",