[gobby-cli-#461] chore: prep multi-crate release (gwiki 0.2.0, gloc dep fix, docs)

Release prep for gobby-core 0.3.0, gcode 0.9.9, ghook 0.4.5, gsqz 0.4.5, gloc 0.1.3, and the first gwiki release (0.2.0).

- gwiki: bump package version 0.1.0 -> 0.2.0 (first public release); Cargo.lock synced.
- gloc: pin gobby-core dep to version = "0.3.0" (keep default-features = false) so the crate is releasable to crates.io, which rejects a path dependency with no version; update the gcore public_boundary test to match the corrected declaration.
- CHANGELOG: reconcile gcode [0.9.9] and gobby-core [0.3.0] against all commits since 2026-05-31 (codewiki generator, LLM outlines, citation provenance, daemon-first embeddings, shared AI clients/probe, etc.), add gloc dep-fix and ghook review entries, and add the new gwiki [0.2.0] section.
- Docs: README now lists five tools incl. gwiki (feature section, version table, install, links); release-guide and guides index include gwiki and document the gloc dep rule.

Co-Authored-By: Claude Opus 4.8 (1M context) <noreply@anthropic.com>

Author: joshwilhelmi

CHANGELOG.md

@@ -9,51 +9,164 @@ and this project adheres to [Semantic Versioning](https://semver.org/spec/v2.0.0
 
 ## [Unreleased]
 
+## [0.2.0] — gwiki
+
+### Added
+
+#### gwiki
+
+- **Initial release** — first public release of `gwiki`, the Gobby
+  research/knowledge-vault CLI. It ingests multimodal sources into a Markdown
+  vault, then indexes, searches, and compiles them into wiki articles and
+  reports.
+- **Multimodal ingest** — `gwiki ingest-file` routes a source by type and
+  derives Markdown into the vault: text documents, PDFs, URLs, MediaWiki pages,
+  git repositories, and Wayback captures for text-bearing sources; audio
+  transcription/translation, image vision description, and video frame +
+  transcript extraction for media. Per-run AI overrides
+  (`--transcription-routing`, `--vision-routing`, `--text-routing`, `--no-ai`)
+  control or bypass media AI for a single ingest.
+- **Markdown vault model** — sources land in a Markdown vault with frontmatter,
+  source provenance, and citation/credibility tracking, so every derived
+  document records where it came from and how trustworthy the source is.
+- **Hybrid search** — `gwiki search` and `gwiki ask` merge BM25 (ParadeDB
+  `pg_search`), semantic (Qdrant), and graph (FalkorDB) signals via Reciprocal
+  Rank Fusion, the same hybrid stack used by gcode.
+- **Reason-act research loop** — `gwiki research` runs an iterative reason-act
+  loop with budget controls (max steps, max tokens, and a wall-time budget),
+  reporting explicit stop reasons (budget exhausted, no progress, duplicate
+  frontier, source blocked, AI unavailable, or finished) and emitting accepted
+  note drafts and recorded gaps.
+- **Command set** — `init`, `setup`, `collect`, `index`, `compile`, `export`,
+  `search`, `read`, `ask`, `research`, `refresh`, `audit`, `lint`, `sources`,
+  `backlinks`, `status`, `health`, and `remove-source` cover vault setup,
+  ingestion, indexing/refresh, search/read/ask, research and compilation,
+  export, and vault health/audit/lint.
+- **Graceful degradation** — multimodal endpoints (transcription, vision) and
+  the AI transport degrade independently, falling back to skeleton/derived
+  output with explicit degradation markers when a capability is routed off or
+  unavailable; search degrades like gcode (BM25 standalone, with semantic and
+  graph optional).
+
 ## [0.9.9] — gcode
 
 ### Added
 
 #### gcode
 
+- **Codewiki generator** — new `gcode codewiki [--out DIR] [--scope PATH...]`
+  command generates per-module Markdown documentation from the indexed code
+  graph, optionally limited to indexed files under one or more paths.
+- **Graph-clustered codewiki modules** — codewiki groups documented files into
+  modules derived from the FalkorDB code graph so generated docs follow the
+  project's real structure instead of flat directory listings.
+- **Bounded mermaid graph diagrams** — generated codewiki pages embed mermaid
+  dependency diagrams that are capped in size so large modules render readable,
+  truncated graphs instead of unbounded blobs.
+- **Codewiki citation provenance** — generated docs carry citations back to the
+  indexed symbols and files they were derived from, so every section is
+  traceable to its source.
+- **Incremental codewiki regeneration** — re-running `gcode codewiki` only
+  regenerates docs for modules whose underlying code changed, leaving unchanged
+  pages in place.
+- **LLM-backed outlines** — `gcode outline --summarize FILE` produces a
+  natural-language outline of a file via text generation when AI routing is
+  configured, alongside the existing structural symbol tree.
 - **Embeddings doctor** — new diagnostics surface for the `ai.embeddings.*`
   configuration namespace, including API base, model, query prefix, timeout,
   and legacy-key migration checks.
 - **Isolated worktree overlay indexing** — linked worktrees and isolated roots
   now get filesystem-derived code-index identity and overlay-aware visibility
   counts instead of inheriting parent project state.
+- **Text-content indexing for Markdown** — Markdown files are now indexed as
+  searchable repo text content (reachable through content search) rather than
+  being dropped, even though they are not parsed for AST symbols.
+- **Hidden repo metadata indexing** — gcode now indexes an allowlisted set of
+  hidden repository metadata as text content (e.g. `.gobby/plans/**/*.md` and
+  `.github/workflows/**`), extendable per project via a `hidden_allowlist` in
+  `.gobby/gcode.json`.
+- **Text-only file-type reporting** — `gcode index` now reports the file types
+  it indexed as text-only (with file counts and examples) so it is clear which
+  inputs were content-indexed rather than parsed for symbols.
 
 ### Changed
 
 #### gcode
 
+- **Search ergonomics** — `gcode search` now detects literal-looking queries
+  (quoted strings, call-site syntax, dotted config keys, path separators) and
+  hints toward `gcode grep`/`gcode search-content`, with refreshed help text and
+  examples steering exact-literal lookups to the right command.
+- **CLI contract surface** — gcode now ships a published CLI contract
+  describing its command surface for tooling and daemon integration.
+- **Codewiki AI routing contract** — `gcode codewiki --ai <auto|daemon|direct|off>`
+  lets you override AI routing for generated summaries per invocation, matching
+  the shared routing vocabulary.
+- **Daemon-first embeddings** — code-symbol embeddings for indexing and semantic
+  search now route through the Gobby daemon when available and fall back to a
+  direct embedding API, instead of always calling the embedding endpoint
+  directly.
+- **Shared hub provisioning** — standalone `gcode setup` now provisions the
+  PostgreSQL hub through shared `gobby-core` provisioning logic that is also used
+  by `gwiki setup`.
 - **Embeddings namespace contract** — embedding configuration now resolves from
   `ai.embeddings.*` keys only; legacy `embeddings.*` keys are reported by
   diagnostics instead of silently winning configuration resolution.
+- **Indexing policy** — Markdown and `.mjs` files are no longer parsed as
+  source-language symbol inputs; safe repo text remains available through
+  content search where supported.
 - **Large-module decomposition** — CLI dispatch, config resolution, setup,
   parser call extraction, import resolution, indexing, graph reads/reports,
   FTS, and vector code-symbol lifecycle were split into focused modules with
   expanded tests.
-- **Indexing policy** — Markdown and `.mjs` files are no longer parsed as
-  source-language symbol inputs; safe repo text remains available through
-  content search where supported.
 
 ### Fixed
 
 #### gcode
 
+- **Single hub resolution enforced** — gcode now resolves exactly one
+  PostgreSQL hub for a given run, preventing conflicting hub sources from being
+  mixed during indexing and search.
+- **Serialized freshness indexing** — read-time freshness re-indexing is now
+  serialized per project so concurrent agent sessions no longer race the index
+  refresh against each other.
+- **Lock-free read-time freshness pre-gate** — project-scoped reads now use a
+  lock-free, hash-free pre-gate that checks file mtimes against the last index
+  time and only takes the refresh lock when something actually changed,
+  eliminating spurious "index refresh already running" messages under
+  concurrent sessions.
+- **Skip generated JS bundles** — indexing now skips generated/minified
+  JavaScript bundles so search and graph results are not polluted by build
+  artifacts.
 - **Search and graph hardening** — graph payloads, graph read rows, projection
   sync reporting, semantic search limits, indexed grep output, and Qdrant
   vector lifecycle paths were tightened across review follow-up fixes.
 - **Setup preflights** — standalone setup and embedding provisioning now
   report namespace and datastore compatibility problems more explicitly before
   mutating gcode-owned projection state.
+- **Review hardening** — applied review and cleanup findings across the crate.
 
 ## [0.3.0] — gobby-core
 
 ### Added
 
 #### gobby-core
 
+- **Shared AI context and capability routing** — `gobby-core` now owns AI
+  config types, `AiContext` resolution, and a per-capability routing decision
+  (daemon / direct / off) so every Gobby CLI resolves AI behavior the same way.
+- **Daemon and direct AI clients** — added daemon-backed AI clients plus direct
+  transcription, vision, and text-generation clients, giving consumers a shared
+  transport for transcribe/vision/text capabilities behind the `ai` feature.
+- **Shared AI capability probe** — a shared probe reports which AI capabilities
+  are reachable (via daemon or direct) so consumers can degrade predictably when
+  a capability is routed off or unavailable.
+- **Shared local-backend discovery** — local-LLM backend descriptors and
+  discovery now live in `gobby-core::local_backend`, shared across the CLIs
+  instead of being reimplemented per binary.
+- **Shared hub provisioning** — added provisioning helpers that let `gcode
+  setup` and `gwiki setup` provision the PostgreSQL hub through one shared code
+  path.
 - **Embedding config contract** — shared `ai.embeddings.*` key constants,
   namespace-aware resolution, `query_prefix`, and `timeout_seconds` now live in
   `gobby-core` for consumers that need consistent embedding service behavior.
@@ -64,6 +177,12 @@ and this project adheres to [Semantic Versioning](https://semver.org/spec/v2.0.0
 
 #### gobby-core
 
+- **Daemon-first embedding routing** — embedding requests now prefer the Gobby
+  daemon when available and fall back to a direct embedding API, with shared
+  routing applied consistently across consumers.
+- **Explicit AI routing modes** — AI routing now requires an explicit mode
+  (auto / daemon / direct / off) rather than relying on implicit defaults, so
+  capability behavior is unambiguous across CLIs.
 - **Legacy embedding keys retired** — `resolve_embedding_config` no longer
   honors `embeddings.*` keys; callers get the new namespace or no embedding
   config.
@@ -76,6 +195,7 @@ and this project adheres to [Semantic Versioning](https://semver.org/spec/v2.0.0
 
 - **Datastore adapter hardening** — PostgreSQL, FalkorDB, and Qdrant helpers
   gained stricter diagnostics and degradation behavior for release consumers.
+- **Review hardening** — applied review and cleanup findings across the crate.
 
 ## [0.4.5] — gobby-hooks
 
@@ -93,6 +213,7 @@ and this project adheres to [Semantic Versioning](https://semver.org/spec/v2.0.0
   logged at debug level during planned Stop handling instead of disappearing.
 - **Test isolation** — tmux environment tests now use scoped environment
   mutation through `temp-env`.
+- **Review hardening** — applied review and cleanup findings across the crate.
 
 ## [0.4.5] — gobby-squeeze
 
@@ -110,10 +231,21 @@ and this project adheres to [Semantic Versioning](https://semver.org/spec/v2.0.0
 
 #### gobby-local
 
+- **Shared local-backend discovery** — backend descriptors and discovery now
+  come from `gobby-core::local_backend` instead of a gloc-local copy, keeping
+  backend detection consistent across the Gobby CLIs.
 - **YAML dependency refresh** — the manifest now uses the maintained
   `yaml_serde 0.10.4` package while keeping the public `serde_yaml` dependency
   name and config-file format unchanged.
 
+### Fixed
+
+#### gobby-local
+
+- **Publishable to crates.io** — the `gobby-core` dependency now carries an
+  explicit `version = "0.3.0"` alongside its workspace path, so `cargo publish`
+  no longer fails on a path dependency that has no version requirement.
+
 ## [0.9.8] — gcode
 
 ### Changed

Cargo.lock

@@ -7,7 +7,7 @@
 
 <p align="center">
   <strong>Rust CLI tools for AI-assisted development.</strong><br>
-  Code search, symbol navigation, output compression, and local LLM launching — all from the terminal.
+  Code search, symbol navigation, output compression, local LLM launching, and multimodal research vaults — all from the terminal.
 </p>
 
 <p align="center">
@@ -21,9 +21,7 @@
 
 ## What's Inside
 
-This workspace ships four Gobby CLI tools plus a shared library. `gobby-wiki`
-is in the workspace, but it is still unreleased and is not part of the current
-release set.
+This workspace ships five Gobby CLI tools plus a shared library.
 
 ### Current Release Set
 
@@ -34,9 +32,7 @@ release set.
 | `gobby-hooks` | `ghook` | `0.4.5` | `ghook-v0.4.5` |
 | `gobby-squeeze` | `gsqz` | `0.4.5` | `gsqz-v0.4.5` |
 | `gobby-local` | `gloc` | `0.1.3` | `gloc-v0.1.3` |
-
-`gobby-wiki` / `gwiki` stays at `0.1.0` in-tree and is excluded from this
-release.
+| `gobby-wiki` | `gwiki` | `0.2.0` | `gwiki-v0.2.0` |
 
 ### gcode — Code Search & Navigation
 
@@ -69,6 +65,17 @@ One command to launch Claude Code or Codex against a local LLM backend. Auto-det
 
 Sandbox-tolerant hook dispatcher invoked by host AI CLIs (Claude Code, Codex, Gemini CLI, Qwen CLI) on lifecycle and tool-use events. Spools envelopes to `~/.gobby/hooks/inbox/` *before* POSTing to the local Gobby daemon, so the daemon's drain worker can replay any delivery lost to a sandbox FS-read denial, network blip, or daemon restart. You don't usually invoke it directly — Gobby wires it into your AI CLI for you.
 
+### gwiki — Research Knowledge Vault
+
+Ingests multimodal sources — documents, PDFs, URLs, MediaWiki, git repos,
+Wayback snapshots, and audio/image/video — into a Markdown knowledge vault with
+frontmatter provenance and citations, then indexes and searches them with the
+same hybrid BM25 + semantic + graph stack as `gcode`. Compiles vault material
+into cited briefs, runs a reason-act `research` loop with step/token/source
+budgets, and answers questions directly with `gwiki ask`. Multimodal and AI
+capabilities degrade gracefully when transcription, vision, or the configured
+datastores are unavailable.
+
 `gobby-core` underpins them all — a small shared-primitives library for project
 root walk-up, bootstrap config, daemon URL composition, setup/provisioning
 contracts, and optional datastore adapters. It is not a standalone tool.
@@ -79,10 +86,12 @@ contracts, and optional datastore adapters. It is not a standalone tool.
 - [gsqz User Guide](docs/guides/gsqz-user-guide.md) — pipelines, step types, configuration, debugging
 - [gloc User Guide](docs/guides/gloc-user-guide.md) — backends, clients, model management, configuration
 - [ghook User Guide](docs/guides/ghook-user-guide.md) — hook wiring, diagnose mode, inbox/replay, troubleshooting
+- [gwiki Development Guide](docs/guides/gwiki-development-guide.md) — research vault ingest, indexing, and hybrid search
 - [Release Guide](docs/guides/release-guide.md) — crate versions, tag order, and local binary installation
 - [Changelog](CHANGELOG.md) — release history
 - [gcode README](crates/gcode/README.md) — architecture and build details
 - [gsqz README](crates/gsqz/README.md) — architecture and build details
+- [gwiki README](crates/gwiki/README.md) — architecture and build details
 
 ## Install
 
@@ -104,6 +113,9 @@ cargo install gobby-local
 
 # ghook
 cargo install gobby-hooks
+
+# gwiki
+cargo install gobby-wiki
 ```
 
 `gcode` graph and semantic features are configured at runtime. There are no
@@ -142,6 +154,7 @@ cargo install --path crates/gcode
 cargo install --path crates/gsqz
 cargo install --path crates/gloc
 cargo install --path crates/ghook
+cargo install --path crates/gwiki
 ```
 
 ## Development

README.md

@@ -52,10 +52,12 @@ fn cargo_features_define_public_boundary() {
         );
     }
 
-    let gloc_gcore_dependency = r#"gobby-core = { path = "../gcore", default-features = false }"#;
+    let gloc_gcore_dependency =
+        r#"gobby-core = { path = "../gcore", version = "0.3.0", default-features = false }"#;
     assert!(
         gloc_manifest.contains(gloc_gcore_dependency),
-        "gloc must not enable the heavier gobby-core/ai feature"
+        "gloc must keep default-features = false (no heavier gobby-core/ai feature); \
+         the explicit version is required for crates.io publishing"
     );
 }
 

crates/gcore/tests/public_boundary.rs

@@ -22,4 +22,4 @@ serde = { version = "1", features = ["derive"] }
 serde_json = "1"
 serde_yaml = { package = "yaml_serde", version = "0.10.4" }
 ureq = { version = "2", features = ["json"] }
-gobby-core = { path = "../gcore", default-features = false }
+gobby-core = { path = "../gcore", version = "0.3.0", default-features = false }

crates/gloc/Cargo.toml

@@ -1,6 +1,6 @@
 [package]
 name = "gobby-wiki"
-version = "0.1.0"
+version = "0.2.0"
 edition = "2024"
 rust-version = "1.88"
 authors = ["Josh Wilhelmi <hello@gobby.ai>"]

crates/gwiki/Cargo.toml

@@ -22,9 +22,9 @@ Task-focused documentation for the released gobby-cli crates.
 - [gsqz Development Guide](./gsqz-development-guide.md) - compressor implementation details.
 - [gloc Development Guide](./gloc-development-guide.md) - local-launcher implementation details.
 - [ghook Development Guide](./ghook-development-guide.md) - hook-dispatch implementation details.
-- [gwiki Development Guide](./gwiki-development-guide.md) - unreleased wiki CLI internals.
+- [gwiki Development Guide](./gwiki-development-guide.md) - research/knowledge-vault CLI internals.
 
-`gobby-wiki` is documented for development only. It is not part of the current
-published release set.
+A `gwiki` user guide is forthcoming. Until then, see the gwiki development guide
+above and the [gwiki README](../../crates/gwiki/README.md).
 
-_Last verified: 2026-06-01_
+_Last verified: 2026-06-03_