plandex-ai/plandex · error

failed to get map file details for %s: %v

Error message

failed to get map file details for %s: %v

What it means

In the defs-only (map) load path, getMapFileDetails fails for a given file path while building map batches. Means parsing/mapping that file failed (read error, unsupported content, or internal map-generation error) and that file's map cannot be produced.

Source

Thrown at app/cli/lib/context_load.go:485

							return
						}

						if !params.DefsOnly {
							contextMu.Lock()
							if totalSize+size > shared.MaxContextBodySize {
								filesSkippedAfterSizeLimit = append(filesSkippedAfterSizeLimit, path)
								contextMu.Unlock()
								errCh <- nil
								return
							}
							totalSize += size
							contextMu.Unlock()
						}

						if params.DefsOnly {
							res, err := getMapFileDetails(path, size, totalSize)
							if err != nil {
								errCh <- fmt.Errorf("failed to get map file details for %s: %v", path, err)
								return
							}

							contextMu.Lock()
							defer contextMu.Unlock()

							if currentMapInputBatch.NumFiles()+1 > shared.ContextMapMaxBatchSize || currentMapInputBatch.TotalSize()+size > shared.ContextMapMaxBatchBytes {
								currentMapInputBatch = shared.FileMapInputs{}
								mapInputBatches = append(mapInputBatches, currentMapInputBatch)
							}

							currentMapInputBatch[path] = res.mapContent
							mapSize += res.size
							mapInputShas[path] = res.shaVal
							mapInputTokens[path] = res.tokens
							mapInputSizes[path] = res.size

							if len(res.mapFilesTruncatedTooLarge) > 0 {

View on GitHub (pinned to e2d772072e)

Solutions

1. Read the wrapped error to see why getMapFileDetails failed for that path
2. Verify the file is readable and is a text-ish source file
3. Exclude the problematic path from the load and retry

When it happens

Trigger: Thrown at app/cli/lib/context_load.go:485 when the library encounters an invalid state.

Common situations: See trigger scenarios.

AI-assisted analysis of plandex-ai/plandex@e2d772072e (2026-09-05). Data as JSON: /api/errors/1b8239ef1b15b9ec. Report an issue: GitHub.