Skip to main content

Troubleshooting

"Dimension mismatch" warning​

Embedding model changed. Fix:

rm -rf .ship-spec/lancedb
ship-spec productionalize --reindex --cloud-ok

ESM import errors​

Ensure local imports include .js extension:

import { foo } from "./bar.js";

WASM loading failures​

Tree-sitter fallback triggers for very large files or missing WASM assets. Check syntax errors or install tree-sitter-wasms.

API key errors​

ship-spec config       # Inspect resolved config
ship-spec init         # Re-initialize
# Or set env vars
export OPENROUTER_API_KEY=sk-or-...
export TAVILY_API_KEY=tvly-...

Ollama connection refused​

ollama serve
ship-spec planning --cloud-ok
# or force local execution
ship-spec planning --local-only