polish(docs): clearer collision error when a node name clashes with the index page

dmealing · claude · dmealing · commit b2329018ce21 · 2026-06-02T09:41:24.000-04:00
Co-Authored-By: Claude Opus 4.8 (1M context) &lt;noreply@anthropic.com&gt;
diff --git a/server/typescript/packages/codegen-ts/src/generators/docs-file.ts b/server/typescript/packages/codegen-ts/src/generators/docs-file.ts
@@ -127,7 +127,7 @@ export const docsFile = function docsFile(opts?: DocsFileOpts): Generator {
       // produces nothing (no orphan landing page with an empty diagram).
       if (files.length > 0) {
         const indexContent = renderIndexPage(ctx.loadedRoot, layout, entityNodes, templateNodes);
-        placements.push({ path: INDEX_FILENAME, fqn: "<overview>" });
+        placements.push({ path: INDEX_FILENAME, fqn: "<the auto-generated overview/index page>" });
         files.unshift({ path: INDEX_FILENAME, content: indexContent });
       }
 

Original file line number	Diff line number	Diff line change
`@@ -127,7 +127,7 @@ export const docsFile = function docsFile(opts?: DocsFileOpts): Generator {`
`127`	`127`	`// produces nothing (no orphan landing page with an empty diagram).`
`128`	`128`	`if (files.length > 0) {`
`129`	`129`	`const indexContent = renderIndexPage(ctx.loadedRoot, layout, entityNodes, templateNodes);`
`130`		`- placements.push({ path: INDEX_FILENAME, fqn: "<overview>" });`
	`130`	`+ placements.push({ path: INDEX_FILENAME, fqn: "<the auto-generated overview/index page>" });`
`131`	`131`	`files.unshift({ path: INDEX_FILENAME, content: indexContent });`
`132`	`132`	`}`
`133`	`133`