v0.1.4
[0.1.4] — 2026-05-04
Two install-path bug-fixes plus a docs note for the third — all surfaced
by a real user trying to install behind a corporate proxy.
Fixed
internal/config/config.gonow binds every defaulted key to its
DOCSIQ_<UPPER_KEY>env variant via a single
for _, key := range v.AllKeys() { _ = v.BindEnv(key) }after defaults
are set. Previously only ~9 keys were explicitly bound, which meant
DOCSIQ_LLM_PROVIDER,DOCSIQ_LLM_OLLAMA_CHAT_MODEL,
DOCSIQ_LLM_AZURE_*,DOCSIQ_LLM_OPENAI_*,DOCSIQ_DATA_DIR,
DOCSIQ_INDEXING_*, etc. were silently ignored when no config file was
present (Viper #761 —AutomaticEnv+Unmarshaldoesn't see env-only
keys without explicitBindEnv). The existing explicitBindEnvcalls
forserver.api_key,workq_workers, etc. are retained — they
document the secondaryDOCSIQ_API_KEYalias and harmlessly
double-bind. (#95)
Added
internal/config/config_test.go—TestLoad_EnvOverridesLLMregression
test that assertsDOCSIQ_LLM_OLLAMA_CHAT_MODEL,
DOCSIQ_LLM_OLLAMA_EMBED_MODEL,DOCSIQ_LLM_PROVIDER,
DOCSIQ_LLM_AZURE_API_KEY, andDOCSIQ_DATA_DIRall reach the
populated*Configstruct without a config file present. (#95)
Changed
docs/getting-started.md"Install" section now uses
GOFLAGS='-tags=sqlite_fts5' go install github.com/RandomCodeSpace/docsiq@latest
with an explicit explanation that the build tag is required because
docsiq uses SQLite's FTS5 extension viamattn/go-sqlite3— without
it the binary fails at runtime withunable to open store: no such module: fts5when opening any project DB. (#95)
Known limitations
go installdoes not produce a working web UI. docsiq's React UI
is embedded via//go:embed ui/dist, but theui/dist/build outputs
are intentionally gitignored — only a placeholderindex.htmlis
committed. The release pipeline runsnpm run buildbeforego build,
so the prebuilt release binaries on this page have the full UI
baked in. Ago installbuild, by contrast, embeds only the
placeholderindex.htmland hits 404 on every/assets/*request.
Fordocsiq serveuse cases, install via
gh release download v0.1.4 --repo RandomCodeSpace/docsiq --pattern 'docsiq-*-linux-amd64*'
(or your platform's equivalent asset). The CLI commands
(docsiq index,docsiq version,docsiq projects, etc.) work
correctly on ago installbuild; only the embedded UI is affected.
Tracked as a follow-up.
Upgrade impact
Drop-in for the test suite and config layer. Previously-ignored env
vars are now honoured — if you had DOCSIQ_LLM_* or
DOCSIQ_INDEXING_* set in a shell or CI environment, those values
will now reach docsiq where they were silently dropped before. Audit
your environment for unintended DOCSIQ_* settings before deploying.
Verify
All artifacts are signed with cosign keyless via Sigstore.
cosign verify-blob \
--certificate-identity-regexp 'https://github.com/RandomCodeSpace/docsiq/\.github/workflows/release\.yml.*' \
--certificate-oidc-issuer 'https://token.actions.githubusercontent.com' \
--certificate docsiq-v0.1.4-linux-amd64.pem \
--signature docsiq-v0.1.4-linux-amd64.sig \
docsiq-v0.1.4-linux-amd64