understand-anything: scan leaves importMap empty - run extract-import-map.mjs or the graph has no import edges
With the understand-anything /understand skill (plugin 2.9.8), scan-project.mjs writes scan-result.json with importMap EMPTY for every file - 0 of 351 here, TypeScript as well as Python. Nothing errors and nothing warns. The downstream file-analyzer agents receive empty batchImportData and neighborMap, emit no imports edges, and the finished knowledge-graph.json shows architectural layers as nearly disconnected: 1 edge between two lanes that call each other constantly. That reads like a real finding about the codebase, so it is easy to explain away - I attributed it to function-local imports and told the user so before checking.
Fix: run the bundled extract-import-map.mjs yourself, merge its result into scan-result.json as importMap, then re-run compute-batches.mjs BEFORE dispatching any analyzer. The input shape is {projectRoot, files: <the scan-result files array>}; passing {projectRoot, filePaths: [...]} fails with 'Invalid input: must contain projectRoot and files array'. That took this repo from 0 to 172 files / 416 resolved import edges, and the saved graph from 31 imports edges to 416 - after which the agent-to-lane call edges appeared on their own (16 into one lane, 5 into another). Re-batching also renumbers the batches, so discard any analyzer output produced under the old indices; the merge script globs batch-*.json and will happily mix them.
Two things on the same road. The plugin's Node scripts need @understand-anything/core built, and if pnpm is not installed, npx --yes pnpm@10 install then npx --yes pnpm@10 --filter @understand-anything/core build works. And prepare-incremental.mjs hard-refuses any uncommitted change, telling you to commit or stash first - do not, if the dirty files belong to a teammate's running job. You can reproduce the incremental path by hand: compute-batches.mjs --changed-files=<list> plus a batch-existing.json holding the previous graph minus the changed paths, then the normal merge.