vectorlessflow · zTgx · Apr 25, 2026 · Apr 25, 2026 · Apr 25, 2026
diff --git a/CLAUDE.md b/CLAUDE.md
@@ -13,7 +13,7 @@ Vectorless is a Document Understanding Engine for AI written in Rust.
 Cargo workspace with 17 fine-grained Rust crates + pure Python SDK:
 
 ```
-vectorless-core/
+crates/
 ├── vectorless-error/       # Error types (Result, Error enum)
 ├── vectorless-document/    # Document types (Document, Tree, NavigationIndex, ReasoningIndex)
 ├── vectorless-config/      # Configuration hub (aggregates all config types)
@@ -25,7 +25,7 @@ vectorless-core/
 ├── vectorless-llm/         # LLM client (pool, memo/cache, throttle, fallback)
 ├── vectorless-storage/     # Persistence (Workspace, LRU cache, file/memory backends)
 ├── vectorless-query/       # Query understanding (intent classification, rewrite)
-├── vectorless-index/       # Compile pipeline (10-stage, checkpointing, incremental update)
+├── vectorless-compiler/    # Compile pipeline (15-pass, checkpointing, incremental update)
 ├── vectorless-agent/       # Retrieval execution (Worker navigation + Orchestrator fusion)
 ├── vectorless-retrieval/   # Retrieval dispatch layer (dispatcher, cache, streaming)
 ├── vectorless-rerank/      # Result reranking (dedup, BM25 scoring, fusion)
@@ -44,7 +44,7 @@ Layer 0:  error · document · utils · scoring          (no workspace deps)
 Layer 1:  graph · events · config · metrics            (depends on Layer 0)
 Layer 2:  llm · storage                                 (depends on Layer 0–1)
 Layer 3:  query                                         (depends on Layer 0–2)
-Layer 4:  index · agent                                 (depends on Layer 0–3)
+Layer 4:  compiler · agent                               (depends on Layer 0–3)
 Layer 5:  retrieval · rerank                            (depends on Layer 0–4)
 Layer 6:  engine (facade) · vectorless-py (bindings)    (depends on all)
 ```
@@ -170,9 +170,9 @@ When uncertain whether an operation is safe, **default to asking user confirmati
 
 ## Common Development Workflow
 
-1. **Adding features**: Implement in the appropriate `vectorless-core/vectorless-*/` crate, add tests
+1. **Adding features**: Implement in the appropriate `crates/vectorless-*/` crate, add tests
 2. **Fixing bugs**: Add failing test case first, fix and ensure tests pass
-3. **Adding crates**: New modules get their own crate under `vectorless-core/`, add to workspace Cargo.toml
-4. **Python bindings**: Update `vectorless-core/vectorless-py/src/lib.rs` (PyO3) when Rust APIs change
+3. **Adding crates**: New modules get their own crate under `crates/`, add to workspace Cargo.toml
+4. **Python bindings**: Update `crates/vectorless-py/src/lib.rs` (PyO3) when Rust APIs change
 5. **Python SDK**: Update `vectorless/` when API surface changes
 6. **Committing code**: Use semantic commit messages, format: `type(scope): description`
diff --git a/Cargo.toml b/Cargo.toml
@@ -1,24 +1,19 @@
 [workspace]
 members = [
-    "vectorless-core/vectorless-error",
-    "vectorless-core/vectorless-document",
-    "vectorless-core/vectorless-config",
-    "vectorless-core/vectorless-utils",
-    "vectorless-core/vectorless-scoring",
-    "vectorless-core/vectorless-graph",
-    "vectorless-core/vectorless-events",
-    "vectorless-core/vectorless-metrics",
-    "vectorless-core/vectorless-llm",
-    "vectorless-core/vectorless-storage",
-    # Strategy layer moved to Python — crates kept but not compiled:
-    # "vectorless-core/vectorless-query",
-    # "vectorless-core/vectorless-agent",
-    # "vectorless-core/vectorless-retrieval",
-    # "vectorless-core/vectorless-rerank",
-    "vectorless-core/vectorless-compiler",
-    "vectorless-core/vectorless-primitives",
-    "vectorless-core/vectorless-engine",
-    "vectorless-core/vectorless-py",
+    "crates/vectorless-error",
+    "crates/vectorless-document",
+    "crates/vectorless-config",
+    "crates/vectorless-utils",
+    "crates/vectorless-scoring",
+    "crates/vectorless-graph",
+    "crates/vectorless-events",
+    "crates/vectorless-metrics",
+    "crates/vectorless-llm",
+    "crates/vectorless-storage",
+    "crates/vectorless-compiler",
+    "crates/vectorless-primitives",
+    "crates/vectorless-engine",
+    "crates/vectorless-py",
 ]
 resolver = "2"
 

diff --git a/...rless-core/vectorless-compiler/Cargo.toml → crates/vectorless-compiler/Cargo.toml b/...rless-core/vectorless-compiler/Cargo.toml → crates/vectorless-compiler/Cargo.toml
diff --git a/...ss-core/vectorless-compiler/src/config.rs → crates/vectorless-compiler/src/config.rs b/...ss-core/vectorless-compiler/src/config.rs → crates/vectorless-compiler/src/config.rs
diff --git a/...less-compiler/src/incremental/detector.rs → ...less-compiler/src/incremental/detector.rs b/...less-compiler/src/incremental/detector.rs → ...less-compiler/src/incremental/detector.rs
diff --git a/...ectorless-compiler/src/incremental/mod.rs → ...ectorless-compiler/src/incremental/mod.rs b/...ectorless-compiler/src/incremental/mod.rs → ...ectorless-compiler/src/incremental/mod.rs
diff --git a/...less-compiler/src/incremental/resolver.rs → ...less-compiler/src/incremental/resolver.rs b/...less-compiler/src/incremental/resolver.rs → ...less-compiler/src/incremental/resolver.rs
diff --git a/...rless-compiler/src/incremental/updater.rs → ...rless-compiler/src/incremental/updater.rs b/...rless-compiler/src/incremental/updater.rs → ...rless-compiler/src/incremental/updater.rs
diff --git a/...rless-core/vectorless-compiler/src/lib.rs → crates/vectorless-compiler/src/lib.rs b/...rless-core/vectorless-compiler/src/lib.rs → crates/vectorless-compiler/src/lib.rs
diff --git a/...ess-compiler/src/parse/markdown/config.rs → ...ess-compiler/src/parse/markdown/config.rs b/...ess-compiler/src/parse/markdown/config.rs → ...ess-compiler/src/parse/markdown/config.rs
diff --git a/...ompiler/src/parse/markdown/frontmatter.rs → ...ompiler/src/parse/markdown/frontmatter.rs b/...ompiler/src/parse/markdown/frontmatter.rs → ...ompiler/src/parse/markdown/frontmatter.rs
diff --git a/...orless-compiler/src/parse/markdown/mod.rs → ...orless-compiler/src/parse/markdown/mod.rs b/...orless-compiler/src/parse/markdown/mod.rs → ...orless-compiler/src/parse/markdown/mod.rs
diff --git a/...ess-compiler/src/parse/markdown/parser.rs → ...ess-compiler/src/parse/markdown/parser.rs b/...ess-compiler/src/parse/markdown/parser.rs → ...ess-compiler/src/parse/markdown/parser.rs
diff --git a/...core/vectorless-compiler/src/parse/mod.rs → crates/vectorless-compiler/src/parse/mod.rs b/...core/vectorless-compiler/src/parse/mod.rs → crates/vectorless-compiler/src/parse/mod.rs
diff --git a/.../vectorless-compiler/src/parse/pdf/mod.rs → .../vectorless-compiler/src/parse/pdf/mod.rs b/.../vectorless-compiler/src/parse/pdf/mod.rs → .../vectorless-compiler/src/parse/pdf/mod.rs
diff --git a/...ctorless-compiler/src/parse/pdf/parser.rs → ...ctorless-compiler/src/parse/pdf/parser.rs b/...ctorless-compiler/src/parse/pdf/parser.rs → ...ctorless-compiler/src/parse/pdf/parser.rs
diff --git a/...ectorless-compiler/src/parse/pdf/types.rs → ...ectorless-compiler/src/parse/pdf/types.rs b/...ectorless-compiler/src/parse/pdf/types.rs → ...ectorless-compiler/src/parse/pdf/types.rs
diff --git a/...orless-compiler/src/parse/toc/assigner.rs → ...orless-compiler/src/parse/toc/assigner.rs b/...orless-compiler/src/parse/toc/assigner.rs → ...orless-compiler/src/parse/toc/assigner.rs
diff --git a/...orless-compiler/src/parse/toc/detector.rs → ...orless-compiler/src/parse/toc/detector.rs b/...orless-compiler/src/parse/toc/detector.rs → ...orless-compiler/src/parse/toc/detector.rs
diff --git a/.../vectorless-compiler/src/parse/toc/mod.rs → .../vectorless-compiler/src/parse/toc/mod.rs b/.../vectorless-compiler/src/parse/toc/mod.rs → .../vectorless-compiler/src/parse/toc/mod.rs
diff --git a/...ctorless-compiler/src/parse/toc/parser.rs → ...ctorless-compiler/src/parse/toc/parser.rs b/...ctorless-compiler/src/parse/toc/parser.rs → ...ctorless-compiler/src/parse/toc/parser.rs
diff --git a/...rless-compiler/src/parse/toc/processor.rs → ...rless-compiler/src/parse/toc/processor.rs b/...rless-compiler/src/parse/toc/processor.rs → ...rless-compiler/src/parse/toc/processor.rs
diff --git a/...orless-compiler/src/parse/toc/repairer.rs → ...orless-compiler/src/parse/toc/repairer.rs b/...orless-compiler/src/parse/toc/repairer.rs → ...orless-compiler/src/parse/toc/repairer.rs
diff --git a/...iler/src/parse/toc/structure_extractor.rs → ...iler/src/parse/toc/structure_extractor.rs b/...iler/src/parse/toc/structure_extractor.rs → ...iler/src/parse/toc/structure_extractor.rs
diff --git a/...ectorless-compiler/src/parse/toc/types.rs → ...ectorless-compiler/src/parse/toc/types.rs b/...ectorless-compiler/src/parse/toc/types.rs → ...ectorless-compiler/src/parse/toc/types.rs
diff --git a/...orless-compiler/src/parse/toc/verifier.rs → ...orless-compiler/src/parse/toc/verifier.rs b/...orless-compiler/src/parse/toc/verifier.rs → ...orless-compiler/src/parse/toc/verifier.rs
diff --git a/...re/vectorless-compiler/src/parse/types.rs → ...es/vectorless-compiler/src/parse/types.rs b/...re/vectorless-compiler/src/parse/types.rs → ...es/vectorless-compiler/src/parse/types.rs
diff --git a/...s-compiler/src/passes/analysis/enhance.rs → ...s-compiler/src/passes/analysis/enhance.rs b/...s-compiler/src/passes/analysis/enhance.rs → ...s-compiler/src/passes/analysis/enhance.rs
diff --git a/...rless-compiler/src/passes/analysis/mod.rs → ...rless-compiler/src/passes/analysis/mod.rs b/...rless-compiler/src/passes/analysis/mod.rs → ...rless-compiler/src/passes/analysis/mod.rs
diff --git a/...-compiler/src/passes/analysis/validate.rs → ...-compiler/src/passes/analysis/validate.rs b/...-compiler/src/passes/analysis/validate.rs → ...-compiler/src/passes/analysis/validate.rs
diff --git a/...less-compiler/src/passes/backend/chain.rs → ...less-compiler/src/passes/backend/chain.rs b/...less-compiler/src/passes/backend/chain.rs → ...less-compiler/src/passes/backend/chain.rs
diff --git a/...ss-compiler/src/passes/backend/concept.rs → ...ss-compiler/src/passes/backend/concept.rs b/...ss-compiler/src/passes/backend/concept.rs → ...ss-compiler/src/passes/backend/concept.rs
diff --git a/...orless-compiler/src/passes/backend/mod.rs → ...orless-compiler/src/passes/backend/mod.rs b/...orless-compiler/src/passes/backend/mod.rs → ...orless-compiler/src/passes/backend/mod.rs
diff --git a/...compiler/src/passes/backend/navigation.rs → ...compiler/src/passes/backend/navigation.rs b/...compiler/src/passes/backend/navigation.rs → ...compiler/src/passes/backend/navigation.rs
diff --git a/...s-compiler/src/passes/backend/optimize.rs → ...s-compiler/src/passes/backend/optimize.rs b/...s-compiler/src/passes/backend/optimize.rs → ...s-compiler/src/passes/backend/optimize.rs
diff --git a/...ss-compiler/src/passes/backend/overlap.rs → ...ss-compiler/src/passes/backend/overlap.rs b/...ss-compiler/src/passes/backend/overlap.rs → ...ss-compiler/src/passes/backend/overlap.rs
diff --git a/...-compiler/src/passes/backend/reasoning.rs → ...-compiler/src/passes/backend/reasoning.rs b/...-compiler/src/passes/backend/reasoning.rs → ...-compiler/src/passes/backend/reasoning.rs
diff --git a/...less-compiler/src/passes/backend/route.rs → ...less-compiler/src/passes/backend/route.rs b/...less-compiler/src/passes/backend/route.rs → ...less-compiler/src/passes/backend/route.rs
diff --git a/...less-compiler/src/passes/backend/score.rs → ...less-compiler/src/passes/backend/score.rs b/...less-compiler/src/passes/backend/score.rs → ...less-compiler/src/passes/backend/score.rs
diff --git a/...ess-compiler/src/passes/backend/verify.rs → ...ess-compiler/src/passes/backend/verify.rs b/...ess-compiler/src/passes/backend/verify.rs → ...ess-compiler/src/passes/backend/verify.rs
diff --git a/...ess-compiler/src/passes/frontend/build.rs → ...ess-compiler/src/passes/frontend/build.rs b/...ess-compiler/src/passes/frontend/build.rs → ...ess-compiler/src/passes/frontend/build.rs
diff --git a/...rless-compiler/src/passes/frontend/mod.rs → ...rless-compiler/src/passes/frontend/mod.rs b/...rless-compiler/src/passes/frontend/mod.rs → ...rless-compiler/src/passes/frontend/mod.rs
diff --git a/...ess-compiler/src/passes/frontend/parse.rs → ...ess-compiler/src/passes/frontend/parse.rs b/...ess-compiler/src/passes/frontend/parse.rs → ...ess-compiler/src/passes/frontend/parse.rs
diff --git a/...ore/vectorless-compiler/src/passes/mod.rs → crates/vectorless-compiler/src/passes/mod.rs b/...ore/vectorless-compiler/src/passes/mod.rs → crates/vectorless-compiler/src/passes/mod.rs
diff --git a/...s-compiler/src/passes/transform/enrich.rs → ...s-compiler/src/passes/transform/enrich.rs b/...s-compiler/src/passes/transform/enrich.rs → ...s-compiler/src/passes/transform/enrich.rs
diff --git a/...less-compiler/src/passes/transform/mod.rs → ...less-compiler/src/passes/transform/mod.rs b/...less-compiler/src/passes/transform/mod.rs → ...less-compiler/src/passes/transform/mod.rs
diff --git a/...ss-compiler/src/passes/transform/split.rs → ...ss-compiler/src/passes/transform/split.rs b/...ss-compiler/src/passes/transform/split.rs → ...ss-compiler/src/passes/transform/split.rs
diff --git a/...rless-compiler/src/pipeline/checkpoint.rs → ...rless-compiler/src/pipeline/checkpoint.rs b/...rless-compiler/src/pipeline/checkpoint.rs → ...rless-compiler/src/pipeline/checkpoint.rs
diff --git a/...ctorless-compiler/src/pipeline/context.rs → ...ctorless-compiler/src/pipeline/context.rs b/...ctorless-compiler/src/pipeline/context.rs → ...ctorless-compiler/src/pipeline/context.rs
diff --git a/...torless-compiler/src/pipeline/executor.rs → ...torless-compiler/src/pipeline/executor.rs b/...torless-compiler/src/pipeline/executor.rs → ...torless-compiler/src/pipeline/executor.rs
diff --git a/...ctorless-compiler/src/pipeline/metrics.rs → ...ctorless-compiler/src/pipeline/metrics.rs b/...ctorless-compiler/src/pipeline/metrics.rs → ...ctorless-compiler/src/pipeline/metrics.rs
diff --git a/...e/vectorless-compiler/src/pipeline/mod.rs → ...s/vectorless-compiler/src/pipeline/mod.rs b/...e/vectorless-compiler/src/pipeline/mod.rs → ...s/vectorless-compiler/src/pipeline/mod.rs
diff --git a/...ess-compiler/src/pipeline/orchestrator.rs → ...ess-compiler/src/pipeline/orchestrator.rs b/...ess-compiler/src/pipeline/orchestrator.rs → ...ess-compiler/src/pipeline/orchestrator.rs
diff --git a/...ectorless-compiler/src/pipeline/policy.rs → ...ectorless-compiler/src/pipeline/policy.rs b/...ectorless-compiler/src/pipeline/policy.rs → ...ectorless-compiler/src/pipeline/policy.rs
diff --git a/...e/vectorless-compiler/src/summary/full.rs → ...s/vectorless-compiler/src/summary/full.rs b/...e/vectorless-compiler/src/summary/full.rs → ...s/vectorless-compiler/src/summary/full.rs
diff --git a/...e/vectorless-compiler/src/summary/lazy.rs → ...s/vectorless-compiler/src/summary/lazy.rs b/...e/vectorless-compiler/src/summary/lazy.rs → ...s/vectorless-compiler/src/summary/lazy.rs
diff --git a/...re/vectorless-compiler/src/summary/mod.rs → ...es/vectorless-compiler/src/summary/mod.rs b/...re/vectorless-compiler/src/summary/mod.rs → ...es/vectorless-compiler/src/summary/mod.rs
diff --git a/...torless-compiler/src/summary/selective.rs → ...torless-compiler/src/summary/selective.rs b/...torless-compiler/src/summary/selective.rs → ...torless-compiler/src/summary/selective.rs
diff --git a/...ctorless-compiler/src/summary/strategy.rs → ...ctorless-compiler/src/summary/strategy.rs b/...ctorless-compiler/src/summary/strategy.rs → ...ctorless-compiler/src/summary/strategy.rs
diff --git a/vectorless-core/vectorless-config/Cargo.toml → crates/vectorless-config/Cargo.toml b/vectorless-core/vectorless-config/Cargo.toml → crates/vectorless-config/Cargo.toml
diff --git a/...ess-core/vectorless-config/src/indexer.rs → crates/vectorless-config/src/indexer.rs b/...ess-core/vectorless-config/src/indexer.rs → crates/vectorless-config/src/indexer.rs
diff --git a/vectorless-core/vectorless-config/src/lib.rs → crates/vectorless-config/src/lib.rs b/vectorless-core/vectorless-config/src/lib.rs → crates/vectorless-config/src/lib.rs
diff --git a/...ss-core/vectorless-config/src/llm_pool.rs → crates/vectorless-config/src/llm_pool.rs b/...ss-core/vectorless-config/src/llm_pool.rs → crates/vectorless-config/src/llm_pool.rs
diff --git a/...ess-core/vectorless-config/src/metrics.rs → crates/vectorless-config/src/metrics.rs b/...ess-core/vectorless-config/src/metrics.rs → crates/vectorless-config/src/metrics.rs
diff --git a/...ess-core/vectorless-config/src/storage.rs → crates/vectorless-config/src/storage.rs b/...ess-core/vectorless-config/src/storage.rs → crates/vectorless-config/src/storage.rs
diff --git a/...rless-core/vectorless-document/Cargo.toml → crates/vectorless-document/Cargo.toml b/...rless-core/vectorless-document/Cargo.toml → crates/vectorless-document/Cargo.toml
diff --git a/...ess-core/vectorless-document/src/chain.rs → crates/vectorless-document/src/chain.rs b/...ess-core/vectorless-document/src/chain.rs → crates/vectorless-document/src/chain.rs
diff --git a/...-core/vectorless-document/src/evidence.rs → crates/vectorless-document/src/evidence.rs b/...-core/vectorless-document/src/evidence.rs → crates/vectorless-document/src/evidence.rs
diff --git a/...ss-core/vectorless-document/src/format.rs → crates/vectorless-document/src/format.rs b/...ss-core/vectorless-document/src/format.rs → crates/vectorless-document/src/format.rs
diff --git a/...rless-core/vectorless-document/src/lib.rs → crates/vectorless-document/src/lib.rs b/...rless-core/vectorless-document/src/lib.rs → crates/vectorless-document/src/lib.rs
diff --git a/...ore/vectorless-document/src/navigation.rs → crates/vectorless-document/src/navigation.rs b/...ore/vectorless-document/src/navigation.rs → crates/vectorless-document/src/navigation.rs
diff --git a/...less-core/vectorless-document/src/node.rs → crates/vectorless-document/src/node.rs b/...less-core/vectorless-document/src/node.rs → crates/vectorless-document/src/node.rs
diff --git a/...s-core/vectorless-document/src/overlap.rs → crates/vectorless-document/src/overlap.rs b/...s-core/vectorless-document/src/overlap.rs → crates/vectorless-document/src/overlap.rs
diff --git a/...re/vectorless-document/src/query_route.rs → ...es/vectorless-document/src/query_route.rs b/...re/vectorless-document/src/query_route.rs → ...es/vectorless-document/src/query_route.rs
diff --git a/...core/vectorless-document/src/reasoning.rs → crates/vectorless-document/src/reasoning.rs b/...core/vectorless-document/src/reasoning.rs → crates/vectorless-document/src/reasoning.rs
diff --git a/...core/vectorless-document/src/reference.rs → crates/vectorless-document/src/reference.rs b/...core/vectorless-document/src/reference.rs → crates/vectorless-document/src/reference.rs
diff --git a/.../vectorless-document/src/serde_helpers.rs → .../vectorless-document/src/serde_helpers.rs b/.../vectorless-document/src/serde_helpers.rs → .../vectorless-document/src/serde_helpers.rs
diff --git a/...core/vectorless-document/src/structure.rs → crates/vectorless-document/src/structure.rs b/...core/vectorless-document/src/structure.rs → crates/vectorless-document/src/structure.rs
diff --git a/...rless-core/vectorless-document/src/toc.rs → crates/vectorless-document/src/toc.rs b/...rless-core/vectorless-document/src/toc.rs → crates/vectorless-document/src/toc.rs
diff --git a/...less-core/vectorless-document/src/tree.rs → crates/vectorless-document/src/tree.rs b/...less-core/vectorless-document/src/tree.rs → crates/vectorless-document/src/tree.rs
diff --git a/.../vectorless-document/src/understanding.rs → .../vectorless-document/src/understanding.rs b/.../vectorless-document/src/understanding.rs → .../vectorless-document/src/understanding.rs
diff --git a/vectorless-core/vectorless-engine/Cargo.toml → crates/vectorless-engine/Cargo.toml b/vectorless-core/vectorless-engine/Cargo.toml → crates/vectorless-engine/Cargo.toml
diff --git a/...ess-core/vectorless-engine/src/builder.rs → crates/vectorless-engine/src/builder.rs b/...ess-core/vectorless-engine/src/builder.rs → crates/vectorless-engine/src/builder.rs
diff --git a/...re/vectorless-engine/src/compile_input.rs → ...es/vectorless-engine/src/compile_input.rs b/...re/vectorless-engine/src/compile_input.rs → ...es/vectorless-engine/src/compile_input.rs
diff --git a/...ectorless-engine/src/compiled_document.rs → ...ectorless-engine/src/compiled_document.rs b/...ectorless-engine/src/compiled_document.rs → ...ectorless-engine/src/compiled_document.rs
diff --git a/...less-core/vectorless-engine/src/engine.rs → crates/vectorless-engine/src/engine.rs b/...less-core/vectorless-engine/src/engine.rs → crates/vectorless-engine/src/engine.rs
diff --git a/...ess-core/vectorless-engine/src/indexer.rs → crates/vectorless-engine/src/indexer.rs b/...ess-core/vectorless-engine/src/indexer.rs → crates/vectorless-engine/src/indexer.rs
diff --git a/vectorless-core/vectorless-engine/src/lib.rs → crates/vectorless-engine/src/lib.rs b/vectorless-core/vectorless-engine/src/lib.rs → crates/vectorless-engine/src/lib.rs
diff --git a/...rless-core/vectorless-engine/src/types.rs → crates/vectorless-engine/src/types.rs b/...rless-core/vectorless-engine/src/types.rs → crates/vectorless-engine/src/types.rs
diff --git a/...s-core/vectorless-engine/src/workspace.rs → crates/vectorless-engine/src/workspace.rs b/...s-core/vectorless-engine/src/workspace.rs → crates/vectorless-engine/src/workspace.rs
diff --git a/vectorless-core/vectorless-error/Cargo.toml → crates/vectorless-error/Cargo.toml b/vectorless-core/vectorless-error/Cargo.toml → crates/vectorless-error/Cargo.toml
diff --git a/...orless-core/vectorless-error/src/error.rs → crates/vectorless-error/src/error.rs b/...orless-core/vectorless-error/src/error.rs → crates/vectorless-error/src/error.rs
diff --git a/vectorless-core/vectorless-error/src/lib.rs → crates/vectorless-error/src/lib.rs b/vectorless-core/vectorless-error/src/lib.rs → crates/vectorless-error/src/lib.rs
diff --git a/vectorless-core/vectorless-events/Cargo.toml → crates/vectorless-events/Cargo.toml b/vectorless-core/vectorless-events/Cargo.toml → crates/vectorless-events/Cargo.toml
diff --git a/...ess-core/vectorless-events/src/emitter.rs → crates/vectorless-events/src/emitter.rs b/...ess-core/vectorless-events/src/emitter.rs → crates/vectorless-events/src/emitter.rs
diff --git a/vectorless-core/vectorless-events/src/lib.rs → crates/vectorless-events/src/lib.rs b/vectorless-core/vectorless-events/src/lib.rs → crates/vectorless-events/src/lib.rs
diff --git a/...rless-core/vectorless-events/src/types.rs → crates/vectorless-events/src/types.rs b/...rless-core/vectorless-events/src/types.rs → crates/vectorless-events/src/types.rs
diff --git a/vectorless-core/vectorless-graph/Cargo.toml → crates/vectorless-graph/Cargo.toml b/vectorless-core/vectorless-graph/Cargo.toml → crates/vectorless-graph/Cargo.toml
diff --git a/...less-core/vectorless-graph/src/builder.rs → crates/vectorless-graph/src/builder.rs b/...less-core/vectorless-graph/src/builder.rs → crates/vectorless-graph/src/builder.rs
diff --git a/...rless-core/vectorless-graph/src/config.rs → crates/vectorless-graph/src/config.rs b/...rless-core/vectorless-graph/src/config.rs → crates/vectorless-graph/src/config.rs
diff --git a/vectorless-core/vectorless-graph/src/lib.rs → crates/vectorless-graph/src/lib.rs b/vectorless-core/vectorless-graph/src/lib.rs → crates/vectorless-graph/src/lib.rs
diff --git a/...orless-core/vectorless-graph/src/types.rs → crates/vectorless-graph/src/types.rs b/...orless-core/vectorless-graph/src/types.rs → crates/vectorless-graph/src/types.rs
diff --git a/vectorless-core/vectorless-llm/Cargo.toml → crates/vectorless-llm/Cargo.toml b/vectorless-core/vectorless-llm/Cargo.toml → crates/vectorless-llm/Cargo.toml
diff --git a/vectorless-core/vectorless-llm/src/client.rs → crates/vectorless-llm/src/client.rs b/vectorless-core/vectorless-llm/src/client.rs → crates/vectorless-llm/src/client.rs
diff --git a/vectorless-core/vectorless-llm/src/config.rs → crates/vectorless-llm/src/config.rs b/vectorless-core/vectorless-llm/src/config.rs → crates/vectorless-llm/src/config.rs
diff --git a/vectorless-core/vectorless-llm/src/error.rs → crates/vectorless-llm/src/error.rs b/vectorless-core/vectorless-llm/src/error.rs → crates/vectorless-llm/src/error.rs
diff --git a/...rless-core/vectorless-llm/src/executor.rs → crates/vectorless-llm/src/executor.rs b/...rless-core/vectorless-llm/src/executor.rs → crates/vectorless-llm/src/executor.rs
diff --git a/...rless-core/vectorless-llm/src/fallback.rs → crates/vectorless-llm/src/fallback.rs b/...rless-core/vectorless-llm/src/fallback.rs → crates/vectorless-llm/src/fallback.rs
diff --git a/vectorless-core/vectorless-llm/src/lib.rs → crates/vectorless-llm/src/lib.rs b/vectorless-core/vectorless-llm/src/lib.rs → crates/vectorless-llm/src/lib.rs
diff --git a/...rless-core/vectorless-llm/src/memo/mod.rs → crates/vectorless-llm/src/memo/mod.rs b/...rless-core/vectorless-llm/src/memo/mod.rs → crates/vectorless-llm/src/memo/mod.rs
diff --git a/...ess-core/vectorless-llm/src/memo/store.rs → crates/vectorless-llm/src/memo/store.rs b/...ess-core/vectorless-llm/src/memo/store.rs → crates/vectorless-llm/src/memo/store.rs
diff --git a/...ess-core/vectorless-llm/src/memo/types.rs → crates/vectorless-llm/src/memo/types.rs b/...ess-core/vectorless-llm/src/memo/types.rs → crates/vectorless-llm/src/memo/types.rs
diff --git a/vectorless-core/vectorless-llm/src/pool.rs → crates/vectorless-llm/src/pool.rs b/vectorless-core/vectorless-llm/src/pool.rs → crates/vectorless-llm/src/pool.rs
diff --git a/...rless-core/vectorless-llm/src/throttle.rs → crates/vectorless-llm/src/throttle.rs b/...rless-core/vectorless-llm/src/throttle.rs → crates/vectorless-llm/src/throttle.rs
diff --git a/...orless-core/vectorless-metrics/Cargo.toml → crates/vectorless-metrics/Cargo.toml b/...orless-core/vectorless-metrics/Cargo.toml → crates/vectorless-metrics/Cargo.toml
diff --git a/...orless-core/vectorless-metrics/src/hub.rs → crates/vectorless-metrics/src/hub.rs b/...orless-core/vectorless-metrics/src/hub.rs → crates/vectorless-metrics/src/hub.rs
diff --git a/...less-core/vectorless-metrics/src/index.rs → crates/vectorless-metrics/src/index.rs b/...less-core/vectorless-metrics/src/index.rs → crates/vectorless-metrics/src/index.rs
diff --git a/...orless-core/vectorless-metrics/src/lib.rs → crates/vectorless-metrics/src/lib.rs b/...orless-core/vectorless-metrics/src/lib.rs → crates/vectorless-metrics/src/lib.rs
diff --git a/...orless-core/vectorless-metrics/src/llm.rs → crates/vectorless-metrics/src/llm.rs b/...orless-core/vectorless-metrics/src/llm.rs → crates/vectorless-metrics/src/llm.rs
diff --git a/...-core/vectorless-metrics/src/retrieval.rs → crates/vectorless-metrics/src/retrieval.rs b/...-core/vectorless-metrics/src/retrieval.rs → crates/vectorless-metrics/src/retrieval.rs
diff --git a/...ess-core/vectorless-primitives/Cargo.toml → crates/vectorless-primitives/Cargo.toml b/...ess-core/vectorless-primitives/Cargo.toml → crates/vectorless-primitives/Cargo.toml
diff --git a/...ess-core/vectorless-primitives/src/lib.rs → crates/vectorless-primitives/src/lib.rs b/...ess-core/vectorless-primitives/src/lib.rs → crates/vectorless-primitives/src/lib.rs
diff --git a/...re/vectorless-primitives/src/navigator.rs → ...es/vectorless-primitives/src/navigator.rs b/...re/vectorless-primitives/src/navigator.rs → ...es/vectorless-primitives/src/navigator.rs
diff --git a/...ss-primitives/src/navigator_inspection.rs → ...ss-primitives/src/navigator_inspection.rs b/...ss-primitives/src/navigator_inspection.rs → ...ss-primitives/src/navigator_inspection.rs
diff --git a/...orless-primitives/src/navigator_search.rs → ...orless-primitives/src/navigator_search.rs b/...orless-primitives/src/navigator_search.rs → ...orless-primitives/src/navigator_search.rs
diff --git a/...core/vectorless-primitives/src/resolve.rs → crates/vectorless-primitives/src/resolve.rs b/...core/vectorless-primitives/src/resolve.rs → crates/vectorless-primitives/src/resolve.rs
diff --git a/...core/vectorless-primitives/src/subtree.rs → crates/vectorless-primitives/src/subtree.rs b/...core/vectorless-primitives/src/subtree.rs → crates/vectorless-primitives/src/subtree.rs
diff --git a/...s-core/vectorless-primitives/src/types.rs → crates/vectorless-primitives/src/types.rs b/...s-core/vectorless-primitives/src/types.rs → crates/vectorless-primitives/src/types.rs
diff --git a/vectorless-core/vectorless-py/Cargo.toml → crates/vectorless-py/Cargo.toml b/vectorless-core/vectorless-py/Cargo.toml → crates/vectorless-py/Cargo.toml
diff --git a/vectorless-core/vectorless-py/src/config.rs → crates/vectorless-py/src/config.rs b/vectorless-core/vectorless-py/src/config.rs → crates/vectorless-py/src/config.rs
diff --git a/...orless-core/vectorless-py/src/document.rs → crates/vectorless-py/src/document.rs b/...orless-core/vectorless-py/src/document.rs → crates/vectorless-py/src/document.rs
diff --git a/vectorless-core/vectorless-py/src/engine.rs → crates/vectorless-py/src/engine.rs b/vectorless-core/vectorless-py/src/engine.rs → crates/vectorless-py/src/engine.rs
diff --git a/vectorless-core/vectorless-py/src/error.rs → crates/vectorless-py/src/error.rs b/vectorless-core/vectorless-py/src/error.rs → crates/vectorless-py/src/error.rs
diff --git a/vectorless-core/vectorless-py/src/graph.rs → crates/vectorless-py/src/graph.rs b/vectorless-core/vectorless-py/src/graph.rs → crates/vectorless-py/src/graph.rs
diff --git a/vectorless-core/vectorless-py/src/lib.rs → crates/vectorless-py/src/lib.rs b/vectorless-core/vectorless-py/src/lib.rs → crates/vectorless-py/src/lib.rs
diff --git a/vectorless-core/vectorless-py/src/metrics.rs → crates/vectorless-py/src/metrics.rs b/vectorless-core/vectorless-py/src/metrics.rs → crates/vectorless-py/src/metrics.rs
diff --git a/...orless-core/vectorless-scoring/Cargo.toml → crates/vectorless-scoring/Cargo.toml b/...orless-core/vectorless-scoring/Cargo.toml → crates/vectorless-scoring/Cargo.toml
diff --git a/...rless-core/vectorless-scoring/src/bm25.rs → crates/vectorless-scoring/src/bm25.rs b/...rless-core/vectorless-scoring/src/bm25.rs → crates/vectorless-scoring/src/bm25.rs
diff --git a/...orless-core/vectorless-scoring/src/lib.rs → crates/vectorless-scoring/src/lib.rs b/...orless-core/vectorless-scoring/src/lib.rs → crates/vectorless-scoring/src/lib.rs
diff --git a/...orless-core/vectorless-storage/Cargo.toml → crates/vectorless-storage/Cargo.toml b/...orless-core/vectorless-storage/Cargo.toml → crates/vectorless-storage/Cargo.toml
diff --git a/...re/vectorless-storage/src/backend/file.rs → ...es/vectorless-storage/src/backend/file.rs b/...re/vectorless-storage/src/backend/file.rs → ...es/vectorless-storage/src/backend/file.rs
diff --git a/...ore/vectorless-storage/src/backend/mod.rs → crates/vectorless-storage/src/backend/mod.rs b/...ore/vectorless-storage/src/backend/mod.rs → crates/vectorless-storage/src/backend/mod.rs
diff --git a/...ctorless-storage/src/backend/trait_def.rs → ...ctorless-storage/src/backend/trait_def.rs b/...ctorless-storage/src/backend/trait_def.rs → ...ctorless-storage/src/backend/trait_def.rs
diff --git a/...less-core/vectorless-storage/src/cache.rs → crates/vectorless-storage/src/cache.rs b/...less-core/vectorless-storage/src/cache.rs → crates/vectorless-storage/src/cache.rs
diff --git a/...less-core/vectorless-storage/src/codec.rs → crates/vectorless-storage/src/codec.rs b/...less-core/vectorless-storage/src/codec.rs → crates/vectorless-storage/src/codec.rs
diff --git a/...orless-core/vectorless-storage/src/lib.rs → crates/vectorless-storage/src/lib.rs b/...orless-core/vectorless-storage/src/lib.rs → crates/vectorless-storage/src/lib.rs
diff --git a/...rless-core/vectorless-storage/src/lock.rs → crates/vectorless-storage/src/lock.rs b/...rless-core/vectorless-storage/src/lock.rs → crates/vectorless-storage/src/lock.rs
diff --git a/...-core/vectorless-storage/src/migration.rs → crates/vectorless-storage/src/migration.rs b/...-core/vectorless-storage/src/migration.rs → crates/vectorless-storage/src/migration.rs
diff --git a/...ore/vectorless-storage/src/persistence.rs → crates/vectorless-storage/src/persistence.rs b/...ore/vectorless-storage/src/persistence.rs → crates/vectorless-storage/src/persistence.rs
diff --git a/...-core/vectorless-storage/src/workspace.rs → crates/vectorless-storage/src/workspace.rs b/...-core/vectorless-storage/src/workspace.rs → crates/vectorless-storage/src/workspace.rs
diff --git a/vectorless-core/vectorless-utils/Cargo.toml → crates/vectorless-utils/Cargo.toml b/vectorless-core/vectorless-utils/Cargo.toml → crates/vectorless-utils/Cargo.toml
diff --git a/...-core/vectorless-utils/src/fingerprint.rs → crates/vectorless-utils/src/fingerprint.rs b/...-core/vectorless-utils/src/fingerprint.rs → crates/vectorless-utils/src/fingerprint.rs
diff --git a/vectorless-core/vectorless-utils/src/lib.rs → crates/vectorless-utils/src/lib.rs b/vectorless-core/vectorless-utils/src/lib.rs → crates/vectorless-utils/src/lib.rs
diff --git a/...orless-core/vectorless-utils/src/token.rs → crates/vectorless-utils/src/token.rs b/...orless-core/vectorless-utils/src/token.rs → crates/vectorless-utils/src/token.rs
diff --git a/...s-core/vectorless-utils/src/validation.rs → crates/vectorless-utils/src/validation.rs b/...s-core/vectorless-utils/src/validation.rs → crates/vectorless-utils/src/validation.rs
diff --git a/pyproject.toml b/pyproject.toml
@@ -68,7 +68,7 @@ Documentation = "https://www.vectorless.dev/docs/intro"
 [tool.maturin]
 python-source = "."
 module-name = "vectorless._vectorless"
-manifest-path = "vectorless-core/vectorless-py/Cargo.toml"
+manifest-path = "crates/vectorless-py/Cargo.toml"
 features = ["pyo3/extension-module"]
 
 [tool.pytest.ini_options]

diff --git a/vectorless/ask/dispatcher.py b/vectorless/ask/dispatcher.py
@@ -1,7 +1,5 @@
 """Dispatcher — unified entry point for retrieval.
 
-Mirrors vectorless-core/vectorless-agent/src/dispatcher.rs.
-
 All queries go through dispatch():
 1. Query reasoning -> QueryAnalysis (via QueryAnalyzer)
 2. Scope resolution -> Specified | Workspace

diff --git a/vectorless/ask/orchestrator.py b/vectorless/ask/orchestrator.py
@@ -1,7 +1,5 @@
 """Orchestrator agent — coordinates multi-document retrieval.
 
-Mirrors vectorless-core/vectorless-agent/src/orchestrator/.
-
 The Orchestrator is always the entry point for retrieval:
 - User specified doc_ids → skip_analysis=True → spawn Workers directly
 - Workspace (unspecified) → analyze DocCards → select docs → spawn Workers

diff --git a/vectorless/ask/prompts.py b/vectorless/ask/prompts.py
@@ -1,9 +1,5 @@
 """Prompt templates for the retrieval agent.
 
-Extracted from vectorless-core/vectorless-agent/src/prompts.rs,
-vectorless-core/vectorless-agent/src/worker/planning.rs, and
-vectorless-core/vectorless-agent/src/orchestrator/replan.rs.
-
 Templates:
 1. worker_navigation   — Worker nav loop, every round
 2. worker_dispatch     — Worker first round (when Orchestrator dispatches)

diff --git a/vectorless/ask/understand.py b/vectorless/ask/understand.py
@@ -1,7 +1,5 @@
 """Query understanding — LLM-driven analysis of user queries.
 
-Mirrors vectorless-core/vectorless-query/src/understand.rs.
-
 This module is now a thin wrapper around the multi-stage QueryAnalyzer.
 Kept for backward compatibility — new code should use QueryAnalyzer directly.
 """

diff --git a/vectorless/rerank/synthesize.py b/vectorless/rerank/synthesize.py
@@ -1,6 +1,5 @@
 """Evidence deduplication and answer formatting.
 
-Mirrors vectorless-core/vectorless-rerank/src/.
 Dedup is pure compute (no LLM). Answer formatting is intent-aware.
 
 The Rust rerank principle: "Find what you find, return what you find."