@blkc-code/mapgen 0.3.0 → 0.6.0

package/dist/tree.js

@@ -0,0 +1,252 @@
+/**
+ * A project as a world, before anything is placed. A folder holding an application is a
+ * building. A folder holding none is a road, at any depth, named by its literal path. Loose
+ * files sit on the road of their own folder, grouped by type. Files that look like secrets
+ * are kept apart, for the vault.
+ *
+ * Only names and counts are read here, and package manifests for links. Never source code.
+ */
+import { execFileSync } from "node:child_process";
+import { readdirSync } from "node:fs";
+import path from "node:path";
+import { DEFAULT_APP_MARKERS, IGNORE, gitignoredNames, isOwnRepo, markerMatcher, readPackage } from "./project-files.js";
+export const SECRETS_GROUP = "Secrets";
+/** Secrets comes first, so a file like .env.json is never left in Config. */
+export const DEFAULT_FILE_GROUPS = {
+    [SECRETS_GROUP]: [".env", ".env.*", "*.pem", "*.key", "*.p12", "*.pfx", "id_rsa", "id_ed25519", ".npmrc", ".netrc"],
+    Docs: ["*.md", "*.mdx", "*.rst", "LICENSE*", "NOTICE*"],
+    Config: [".env.*", "*.json", "*.jsonc", "*.yaml", "*.yml", "*.toml", "*.config.*", ".*ignore", ".*rc", ".*rc.*", ".editorconfig", "Dockerfile*", "Makefile"],
+    Pages: ["*.html", "*.htm"],
+    Images: ["*.png", "*.jpg", "*.jpeg", "*.gif", "*.svg", "*.webp", "*.ico"],
+    Logs: ["*.log", "*.txt", "*history*"],
+    Code: ["*.ts", "*.tsx", "*.js", "*.mjs", "*.cjs", "*.py", "*.go", "*.rs", "*.java", "*.rb", "*.php", "*.sh", "*.css", "*.sql"],
+};
+const OTHER_GROUP = "Other";
+/** Templates are meant to be committed, and hold no real values. */
+const SECRET_TEMPLATE = /\.(example|sample|template|dist)$/i;
+/** What a folder inside an application is, by its name. Anything else under src/ is a Desk. */
+export const DEFAULT_PART_TYPES = {
+    "Server rack": ["api", "server", "servers", "backend", "supabase", "migrations", "db", "database", "prisma"],
+    Workbench: ["lib", "libs", "shared", "utils", "core", "common", "kernel"],
+    Whiteboard: ["test", "tests", "__tests__", "e2e", "spec", "specs"],
+    Bookshelf: ["docs", "doc", "documentation"],
+    Toolbox: ["scripts", "tools", "bin", "skills"],
+    Plants: ["public", "assets", "static", "images"],
+};
+const FEATURE_ITEM = "Desk";
+const OTHER_ITEM = "Filing cabinet";
+/** Folders inside an application that hold its parts, rather than being one. */
+const PART_CONTAINERS = new Set(["src", "app", "pages", "features", "modules"]);
+const MAX_ENTRIES = 400000;
+const MAX_DEPTH = 12;
+const clean = (value) => value.replace(/\\/g, "/").replace(/^\.\//, "").replace(/\/+$/, "");
+const join = (base, name) => (base ? `${base}/${name}` : name);
+const within = (rel, parent) => rel === parent || rel.startsWith(`${parent}/`);
+export function scanTree(root, options = {}) {
+    const gitignored = gitignoredNames(root);
+    const skipped = new Set((options.ignore ?? []).map(clean));
+    const isSkipped = (rel) => skipped.has(rel) || skipped.has(path.posix.basename(rel));
+    const roads = (options.roads ?? []).map(clean);
+    /** An added road, somewhere above or below this folder, opens the way through. */
+    const onAddedRoad = (rel) => roads.some((road) => within(rel, road) || within(road, rel));
+    const markers = [...(options.replaceDefaults ? [] : DEFAULT_APP_MARKERS), ...(options.markers ?? [])].map(markerMatcher);
+    const includes = new Set((options.include ?? []).map(clean));
+    const groupMatchers = Object.entries({ ...DEFAULT_FILE_GROUPS, ...options.fileGroups })
+        .sort(([a], [b]) => Number(b === SECRETS_GROUP) - Number(a === SECRETS_GROUP))
+        .map(([name, patterns]) => ({ name, patterns: patterns.map(markerMatcher) }));
+    const groupOf = (file) => groupMatchers.find((group) => !(group.name === SECRETS_GROUP && SECRET_TEMPLATE.test(file)) && group.patterns.some((pattern) => pattern.test(file)))?.name ?? OTHER_GROUP;
+    const customParts = Object.entries(options.partTypes ?? {}).map(([item, folders]) => ({ item, folders: folders.map(clean) }));
+    const itemFor = (rel, nested) => {
+        const name = path.posix.basename(rel);
+        const custom = customParts.find(({ folders }) => folders.some((folder) => folder === name || rel === folder || rel.endsWith(`/${folder}`)));
+        if (custom)
+            return custom.item;
+        const known = Object.entries(DEFAULT_PART_TYPES).find(([, folders]) => folders.includes(name));
+        if (known)
+            return known[0];
+        return nested ? FEATURE_ITEM : OTHER_ITEM;
+    };
+    // What git tracks is the truth, repo by repo, since an added road can hold separate repos.
+    const trackedIn = new Map();
+    const tracked = (repo) => {
+        let files = trackedIn.get(repo);
+        if (!files) {
+            try {
+                files = execFileSync("git", ["ls-files", "-z"], { cwd: path.join(root, repo), encoding: "utf8", maxBuffer: 512 * 1024 * 1024, stdio: ["ignore", "pipe", "ignore"] }).split("\0").filter(Boolean);
+            }
+            catch {
+                files = [];
+            }
+            trackedIn.set(repo, files);
+        }
+        return files;
+    };
+    let budget = MAX_ENTRIES;
+    let truncated = false;
+    const list = (rel) => {
+        try {
+            const entries = readdirSync(path.join(root, rel), { withFileTypes: true }).sort((a, b) => a.name.localeCompare(b.name));
+            budget -= entries.length;
+            if (budget <= 0)
+                truncated = true;
+            return entries;
+        }
+        catch {
+            return [];
+        }
+    };
+    const countOnDisk = (rel, depth = 0) => {
+        if (budget <= 0 || depth > MAX_DEPTH)
+            return 0;
+        let total = 0;
+        for (const entry of list(rel)) {
+            if (entry.isFile())
+                total += 1;
+            else if (entry.isDirectory() && !entry.name.startsWith(".") && !IGNORE.has(entry.name) && !gitignored.has(entry.name))
+                total += countOnDisk(join(rel, entry.name), depth + 1);
+        }
+        return total;
+    };
+    const countFiles = (rel, repo) => {
+        const inside = repo ? rel.slice(repo.length + 1) : rel;
+        const prefix = inside ? `${inside}/` : "";
+        const count = tracked(repo).filter((file) => file.startsWith(prefix)).length;
+        return count > 0 ? count : countOnDisk(rel);
+    };
+    const secrets = [];
+    const looseFiles = (owner, files) => {
+        const groups = new Map();
+        for (const file of files) {
+            const rel = join(owner, file);
+            const node = { id: `file:${rel}`, kind: "file", name: file, path: rel, children: [] };
+            const group = groupOf(file);
+            if (group === SECRETS_GROUP) {
+                secrets.push(node);
+                continue;
+            }
+            groups.set(group, [...(groups.get(group) ?? []), node]);
+        }
+        return [...groups.entries()].sort(([a], [b]) => a.localeCompare(b)).map(([name, children]) => ({ id: `group:${owner}:${name}`, kind: "group", name, path: owner, children }));
+    };
+    /** A folder is shown unless it's hidden, junk, ignored, or another repo no road opened. */
+    const showFolder = (rel, name) => {
+        if (IGNORE.has(name) || isSkipped(rel))
+            return false;
+        const opened = onAddedRoad(rel);
+        if (name.startsWith(".") && name !== ".github" && !opened)
+            return false;
+        if (gitignored.has(name) && !opened)
+            return false;
+        return opened || !isOwnRepo(path.join(root, rel));
+    };
+    const isApp = (rel, files) => includes.has(rel) || files.some((file) => markers.some((marker) => marker.test(file)));
+    const partsOf = (rel, repo, nested, depth) => {
+        const parts = [];
+        for (const entry of list(rel)) {
+            if (!entry.isDirectory())
+                continue;
+            const child = join(rel, entry.name);
+            if (entry.name.startsWith(".") || !showFolder(child, entry.name))
+                continue;
+            if (PART_CONTAINERS.has(entry.name) && depth < 3) {
+                const inner = partsOf(child, repo, true, depth + 1);
+                if (inner.length > 0) {
+                    parts.push(...inner);
+                    continue;
+                }
+            }
+            const files = countFiles(child, repo);
+            if (files > 0)
+                parts.push({ id: `part:${child}`, kind: "part", name: path.posix.basename(child), path: child, files, item: itemFor(child, nested), children: [] });
+        }
+        return parts;
+    };
+    const building = (rel, repo, files) => ({
+        id: `building:${rel}`,
+        kind: "building",
+        name: path.posix.basename(rel) || path.basename(path.resolve(root)),
+        path: rel,
+        files: countFiles(rel, repo),
+        children: [...partsOf(rel, repo, false, 0), ...looseFiles(rel, files)],
+    });
+    const walk = (rel, repo, depth) => {
+        const entries = list(rel);
+        const files = entries.filter((entry) => entry.isFile()).map((entry) => entry.name);
+        const children = [];
+        if (depth < MAX_DEPTH && budget > 0) {
+            for (const entry of entries) {
+                if (!entry.isDirectory())
+                    continue;
+                const child = join(rel, entry.name);
+                if (!showFolder(child, entry.name))
+                    continue;
+                const childRepo = isOwnRepo(path.join(root, child)) ? child : repo;
+                const childFiles = list(child).filter((item) => item.isFile()).map((item) => item.name);
+                if (isApp(child, childFiles)) {
+                    children.push(building(child, childRepo, childFiles));
+                }
+                else {
+                    const road = walk(child, childRepo, depth + 1);
+                    if (road.children.length > 0)
+                        children.push(road);
+                }
+            }
+        }
+        else if (depth >= MAX_DEPTH) {
+            truncated = true;
+        }
+        return {
+            id: `road:${rel}`,
+            kind: "road",
+            name: rel ? `${path.posix.basename(rel)}/` : "/",
+            path: rel,
+            children: [...children, ...looseFiles(rel, files)],
+        };
+    };
+    const hasBuildings = (node) => node.children.some((child) => child.kind === "building" || (child.kind === "road" && hasBuildings(child)));
+    const topFiles = list("").filter((entry) => entry.isFile()).map((entry) => entry.name);
+    let top = walk("", "", 0);
+    // With no application inside it, the whole project is one, marked or not.
+    if (!hasBuildings(top)) {
+        secrets.length = 0;
+        top = building("", "", topFiles);
+    }
+    const buildings = [];
+    const collect = (node) => {
+        if (node.kind === "building")
+            buildings.push(node);
+        for (const child of node.children)
+            if (child.kind === "road")
+                collect(child);
+        if (node.kind === "road")
+            for (const child of node.children)
+                if (child.kind === "building")
+                    buildings.push(child);
+    };
+    collect(top);
+    const owners = new Map();
+    const manifests = new Map();
+    for (const node of buildings) {
+        const manifest = readPackage(path.join(root, node.path));
+        if (!manifest)
+            continue;
+        manifests.set(node.id, manifest);
+        if (typeof manifest["name"] === "string")
+            owners.set(manifest["name"], node.id);
+    }
+    const links = [];
+    for (const [from, manifest] of manifests) {
+        const seen = new Set();
+        for (const field of ["dependencies", "devDependencies", "peerDependencies"]) {
+            for (const name of Object.keys((manifest[field] ?? {}))) {
+                const to = owners.get(name);
+                if (to && to !== from && !seen.has(to)) {
+                    seen.add(to);
+                    links.push({ from, to });
+                }
+            }
+        }
+    }
+    return { root: top, secrets, links, truncated };
+}
+//# sourceMappingURL=tree.js.map

package/dist/tree.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"tree.js","sourceRoot":"","sources":["../src/tree.ts"],"names":[],"mappings":"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"}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@blkc-code/mapgen",
-  "version": "0.3.0",
+  "version": "0.6.0",
   "type": "module",
   "description": "Grows a unique map from a project, and keeps it in step as the project changes",
   "main": "dist/index.js",
@@ -27,7 +27,7 @@
   "devDependencies": {
     "typescript": "^5.9.3",
     "vitest": "^5.1.0",
-    "@blkc-code/render-canvas": "^0.6.0",
+    "@blkc-code/render-canvas": "^0.7.0",
     "@types/node": "^22.9.0"
   },
   "engines": {

package/src/index.ts

@@ -8,11 +8,16 @@
  * here, never source code.
  */
 
+import { execFileSync } from "node:child_process";
 import { existsSync, readdirSync, readFileSync } from "node:fs";
 import path from "node:path";
+import { DEFAULT_APP_MARKERS, IGNORE, gitignoredNames, isOwnRepo, markerMatcher, readPackage } from "./project-files.js";
 import { OFFICE_PLAN, worldPlan, type RoomRole, type Theme, type WorldPlan } from "./plan.js";
 
 export * from "./plan.js";
+export * from "./project-files.js";
+export * from "./tree.js";
+export * from "./roads.js";
 
 export interface MapRoom {
   id: string;
@@ -28,15 +33,26 @@ export interface MapRoom {
   /** Edited by hand: the generator leaves it alone. */
   locked?: boolean;
   files?: number;
+  /** The road this sits on, as a path. */
+  road?: string;
+}
+export interface MapItem {
+  type: string;
+  x: number;
+  y: number;
+  room?: string;
+  /** The real folder or file group this stands for. */
+  part?: string;
+  /** Shown beside it on the map, for things like a group of loose files. */
+  label?: string;
 }
-export interface MapItem { type: string; x: number; y: number; room?: string }
 export interface MapDoor { x: number; y: number }
 export interface OfficeMap {
   version: 1;
   /** Which world this map is for. The office if left out. */
   world?: string;
-  /** halls: rooms in even rows along corridors. Left out on older maps, whose rooms were placed one against another. */
-  layout?: "halls";
+  /** roads: grows from the project's folders, with no size limit. halls: even rows along corridors. Left out on the oldest maps. */
+  layout?: "halls" | "roads";
   /** How tall the rooms are in the first pair of rows. */
   roomHeight?: number;
   seed: string;
@@ -63,7 +79,22 @@ export interface ProjectArea {
   files: number;
   /** How many other areas depend on this one. */
   dependents?: number;
+  /** The folder path it sits on, such as "apps/". */
+  street?: string;
+}
+
+/** How to read a project. This is the part of a Kit's world.json the scan needs. */
+export interface ScanOptions {
+  /** File names that mark a folder as an application, such as "go.mod" or "*.xydsf". */
+  markers?: string[];
+  /** Use only `markers`, not the built-in ones as well. */
+  replaceDefaults?: boolean;
+  /** Folders that get a building even with no marker. */
+  include?: string[];
+  /** Folders that never get a building: a name, or a path from the top. */
+  ignore?: string[];
 }
+
 export interface ProjectScan {
   areas: ProjectArea[];
   rootFiles: number;
@@ -82,12 +113,14 @@ const TIGHT_ABOVE = 14;
 const MAX_ENTRIES = 200000;
 /** One huge folder can't use up the scan and leave the rest uncounted. */
 const MAX_ENTRIES_PER_AREA = 20000;
+/** How deep to look for applications. */
+const MAX_APP_DEPTH = 5;
+
 const MAX_DEPTH = 8;
-const IGNORE = new Set(["node_modules", ".git", "dist", "build", "out", "target", "coverage", ".next", ".turbo", ".cache", "vendor", "venv", "__pycache__", ".venv", ".idea", ".vscode", ".claude", ".blkc", ".gemini", ".cursor"]);
 const CONTAINERS = new Set(["src", "packages", "apps", "services", "libs", "lib", "modules", "crates", "cmd", "internal", "app"]);
 
-const slug = (value: string): string => value.toLowerCase().replace(/[^a-z0-9]+/g, "-").replace(/^-+|-+$/g, "").slice(0, 60);
-const titled = (value: string): string =>
+export const slug = (value: string): string => value.toLowerCase().replace(/[^a-z0-9]+/g, "-").replace(/^-+|-+$/g, "").slice(0, 60);
+export const titled = (value: string): string =>
   value.replace(/^\./, "").split(/[-_]/).filter(Boolean).map((p) => p.charAt(0).toUpperCase() + p.slice(1)).join(" ").slice(0, 18) || value.slice(0, 18);
 
 export function hashText(text: string): number {
@@ -97,7 +130,7 @@ export function hashText(text: string): number {
 }
 
 /** A small seeded generator, so the same project always grows the same way. */
-function rng(seed: string): () => number {
+export function rng(seed: string): () => number {
   let state = hashText(seed) || 1;
   return () => {
     state ^= state << 13;
@@ -108,33 +141,8 @@ function rng(seed: string): () => number {
   };
 }
 
-/** The plain folder names in a .gitignore. Patterns with wildcards aren't followed. */
-export function gitignoredNames(root: string): Set<string> {
-  const names = new Set<string>();
-  try {
-    for (const line of readFileSync(path.join(root, ".gitignore"), "utf8").split("\n")) {
-      const name = line.trim().replace(/^\//, "").replace(/\/$/, "");
-      if (name && !/[*!#/\s]/.test(name)) names.add(name);
-    }
-  } catch {
-    // no .gitignore
-  }
-  return names;
-}
-
-/** A folder with its own .git is another project, even if it sits inside this one. */
-export const isOwnRepo = (dir: string): boolean => existsSync(path.join(dir, ".git"));
-
 type Json = Record<string, unknown>;
 
-const readPackage = (dir: string): Json | undefined => {
-  try {
-    return JSON.parse(readFileSync(path.join(dir, "package.json"), "utf8")) as Json;
-  } catch {
-    return undefined;
-  }
-};
-
 /** Top-level folders a workspace config says hold packages, such as tools from "tools/*". */
 function workspaceFolders(root: string): string[] {
   const globs: string[] = [];
@@ -179,8 +187,19 @@ function findLinks(root: string, areas: ProjectArea[]): { from: string; to: stri
 }
 
 /** Folder names, file counts and how the folders depend on each other. */
-export function scanProject(root: string): ProjectScan {
+export function scanProject(root: string, options: ScanOptions = {}): ProjectScan {
   const ignored = new Set([...IGNORE, ...gitignoredNames(root)]);
+  const clean = (value: string): string => value.replace(/\\/g, "/").replace(/^\.\//, "").replace(/\/+$/, "");
+  const skipped = new Set((options.ignore ?? []).map(clean));
+  const isSkipped = (rel: string): boolean => skipped.has(rel) || skipped.has(path.posix.basename(rel));
+
+  // What git tracks is the truth. Build output on disk isn't part of the project.
+  let tracked: string[] | undefined;
+  try {
+    tracked = execFileSync("git", ["ls-files", "-z"], { cwd: root, encoding: "utf8", maxBuffer: 256 * 1024 * 1024, stdio: ["ignore", "pipe", "ignore"] }).split("\0").filter(Boolean);
+  } catch {
+    // not a git repo, so the folders are all there is
+  }
 
   let budget = MAX_ENTRIES;
   const countFiles = (dir: string, depth: number): number => {
@@ -196,7 +215,7 @@ export function scanProject(root: string): ProjectScan {
       if (--budget <= 0) break;
       if (entry.isDirectory()) {
         const child = path.join(dir, entry.name);
-        if (!ignored.has(entry.name) && !isOwnRepo(child)) files += countFiles(child, depth + 1);
+        if (!ignored.has(entry.name) && !entry.name.startsWith(".") && !isOwnRepo(child)) files += countFiles(child, depth + 1);
       } else if (entry.isFile()) {
         files += 1;
       }
@@ -214,22 +233,60 @@ export function scanProject(root: string): ProjectScan {
     }
   };
 
+  const markers = [...(options.replaceDefaults ? [] : DEFAULT_APP_MARKERS), ...(options.markers ?? [])].map(markerMatcher);
+  const isApp = (dir: string): boolean => {
+    try {
+      return readdirSync(dir, { withFileTypes: true }).some((entry) => entry.isFile() && markers.some((marker) => marker.test(entry.name)));
+    } catch {
+      return false;
+    }
+  };
+  const below = (rel: string): string[] => subdirs(path.join(root, rel)).map((name) => (rel ? `${rel}/${name}` : name)).filter((child) => !isSkipped(child));
+
+  // An application is a building. A folder holding applications is a street. Everything else doesn't count.
+  const apps: string[] = [];
+  const findApps = (rel: string, depth: number): void => {
+    for (const child of below(rel)) {
+      if (isApp(path.join(root, child))) apps.push(child);
+      else if (depth < MAX_APP_DEPTH) findApps(child, depth + 1);
+    }
+  };
+  findApps("", 1);
+  const included = (options.include ?? []).map(clean).filter((rel) => !apps.includes(rel) && existsSync(path.join(root, rel)));
+
   const containers = new Set([...CONTAINERS, ...workspaceFolders(root)]);
   const areas: ProjectArea[] = [];
   let remaining = MAX_ENTRIES;
-  const add = (rel: string): void => {
-    budget = Math.min(MAX_ENTRIES_PER_AREA, remaining);
-    const before = budget;
-    const files = countFiles(path.join(root, rel), 0);
-    remaining -= before - Math.max(budget, 0);
-    if (files > 0) areas.push({ id: slug(rel), name: titled(path.basename(rel)), path: `${rel}/`, files });
+  const add = (rel: string, street?: string): void => {
+    let files = tracked ? tracked.filter((file) => file.startsWith(`${rel}/`)).length : 0;
+    if (files === 0) {
+      // New and not committed yet.
+      budget = Math.min(MAX_ENTRIES_PER_AREA, remaining);
+      const before = budget;
+      files = countFiles(path.join(root, rel), 0);
+      remaining -= before - Math.max(budget, 0);
+    }
+    if (files > 0) areas.push({ id: slug(rel), name: titled(path.basename(rel)), path: `${rel}/`, files, ...(street === undefined ? {} : { street }) });
   };
-  for (const name of subdirs(root)) {
-    const children = containers.has(name) ? subdirs(path.join(root, name)) : [];
-    // One package in packages/ is still a package, but one folder in src/ is just a folder.
-    const open = children.length >= 2 || children.some((child) => readPackage(path.join(root, name, child)));
-    if (open) for (const child of children) add(`${name}/${child}`);
-    else add(name);
+  const readsAsOneApp = apps.length + included.length <= 1 && (isApp(root) || apps.length === 0);
+  const insideOneApp = apps.length === 1 && included.length === 0 && !isApp(root);
+  if (readsAsOneApp || insideOneApp) {
+    // One application: its own folders are the rooms.
+    const base = insideOneApp ? (apps[0] as string) : "";
+    for (const rel of below(base)) {
+      const name = path.posix.basename(rel);
+      const children = containers.has(name) ? below(rel) : [];
+      // One package in packages/ is still a package, but one folder in src/ is just a folder.
+      const open = children.length >= 2 || children.some((child) => readPackage(path.join(root, child)));
+      if (open) for (const child of children) add(child);
+      else add(rel);
+    }
+    for (const rel of included) add(rel);
+  } else {
+    for (const rel of [...apps, ...included]) {
+      const parent = path.posix.dirname(rel);
+      add(rel, parent === "." ? "" : `${parent}/`);
+    }
   }
   let rootFiles = 0;
   try {
@@ -261,7 +318,7 @@ export function scanProject(root: string): ProjectScan {
 // --- What a folder looks like ---------------------------------------------------------------------------
 
 /** The look comes from a folder's own name, so everything in apps/ doesn't look like a front end. */
-function themeFor(folder: string, plan: WorldPlan, random: () => number): Theme {
+export function themeFor(folder: string, plan: WorldPlan, random: () => number): Theme {
   const own = folder.replace(/\/$/, "").split("/").pop() ?? folder;
   const found = plan.themes.find(({ match }) => match.test(own));
   if (found) return found.theme;
@@ -279,7 +336,7 @@ function targetSize(id: string, files: number, seed: string, compact: false | nu
   };
 }
 
-const deskCount = (files: number): number => Math.min(9, Math.max(1, Math.round(Math.log2(files + 1) - 1)));
+export const deskCount = (files: number): number => Math.min(9, Math.max(1, Math.round(Math.log2(files + 1) - 1)));
 
 // --- Geometry -------------------------------------------------------------------------------------------
 
@@ -401,7 +458,12 @@ function placeInHalls(
   related: MapRoom[],
   family: MapRoom[],
   random: () => number,
+  street?: string,
 ): { box: Box; door?: MapDoor; replaces?: MapRoom } | undefined {
+  const streetOf = (room: MapRoom): string => {
+    const parent = path.posix.dirname((room.paths[0] ?? "").replace(/\/$/, ""));
+    return parent === "." ? "" : `${parent}/`;
+  };
   const beside = (x: number, w: number, y: number, room: MapRoom): boolean => room.y === y && (room.x + room.w + 1 === x || x + w + 1 === room.x);
   const empty = map.rooms
     .filter((room) => room.role === "vacant" && !room.locked && room.w >= MIN_ROOM_W)
@@ -414,7 +476,9 @@ function placeInHalls(
     const open = hallRows(map).filter((row) => row.end + w <= row.limit);
     const score = (row: HallRow): number => row.end
       - (related.some((other) => other.y === row.y) ? 20 : 0)
-      - (family.some((other) => other.y === row.y) ? 6 : 0)
+      - (family.some((other) => other.y === row.y) ? 30 : 0)
+      // A new street starts its own row, where it can.
+      + (street !== undefined && row.rooms.some((other) => !other.role && streetOf(other) !== street) ? 25 : 0)
       + random() * 3;
     const row = open.map((candidate) => ({ candidate, value: score(candidate) })).sort((a, b) => a.value - b.value)[0]?.candidate;
     if (row) return { box: { x: row.end, y: row.y, w, h: row.h }, door: doorInto(row.end, w, row.doorY, random) };
@@ -433,7 +497,7 @@ function placeInHalls(
   map.rooms.push({ id: "stairs", name: "", x: landing, y: top.y + HALL_H + 1, w: HALL_H, h: y - 1 - (top.y + HALL_H + 1), floor: "hall", paths: [], role: "hall" });
   map.rooms.push({ id: "hall-1", name: "", x: top.x, y, w: landing + HALL_H - top.x, h: HALL_H, floor: "hall", paths: [], role: "hall" });
   map.doors.push({ x: landing, y: top.y + HALL_H }, { x: landing, y: y - 1 });
-  return placeInHalls(map, id, width, related, family, random);
+  return placeInHalls(map, id, width, related, family, random, street);
 }
 
 /** Corridors reach the end of their rows, and rows fill out to a straight edge with empty rooms. */
@@ -497,7 +561,7 @@ function reachable(rooms: Box[], doors: MapDoor[], from: Box): Set<Box> {
 
 // --- Furnishing ------------------------------------------------------------------------------------------
 
-function furnish(room: MapRoom, doors: MapDoor[], seed: string, plan: WorldPlan): MapItem[] {
+export function furnish(room: MapRoom, doors: MapDoor[], seed: string, plan: WorldPlan): MapItem[] {
   const random = rng(`${seed}:furnish:${room.id}:${room.w}x${room.h}`);
   const blocked = new Set<string>();
   const reserved = new Set<string>();
@@ -716,7 +780,7 @@ export function evolveMap(previous: OfficeMap | undefined, scan: ProjectScan, se
     const prefer = related.length > 0 ? related : family;
     const pull = related.length > 0 ? 40 : 8;
     if (map.layout === "halls") {
-      const spot = placeInHalls(map, area.id, wantedSize.w, related, family, rng(`${map.seed}:place:${area.id}`));
+      const spot = placeInHalls(map, area.id, wantedSize.w, related, family, rng(`${map.seed}:place:${area.id}`), area.street);
       if (!spot) continue; // the building is full; this folder's agents use the lobby
       if (spot.replaces) {
         const old = spot.replaces.id;
@@ -749,7 +813,22 @@ export function evolveMap(previous: OfficeMap | undefined, scan: ProjectScan, se
     if (previous) changes.push(`New room: ${area.name}`);
   }
 
-  if (map.layout === "halls") squareUp(map, map.seed, touched);
+  if (map.layout === "halls") {
+    squareUp(map, map.seed, touched);
+    // A corridor is named for the literal paths along it.
+    const streetFor = new Map(scan.areas.map((area) => [area.id, area.street]));
+    for (const hall of corridors(map)) {
+      const streets = new Set<string>();
+      for (const row of hallRows(map).filter((candidate) => candidate.hall === hall)) {
+        for (const room of row.rooms) {
+          const street = streetFor.get(room.id);
+          if (street) streets.add(street);
+        }
+      }
+      hall.paths = [...streets];
+      hall.name = hall.paths.join(" + ").slice(0, 24);
+    }
+  }
 
   // A new door or a bigger room can change what fits, so those rooms are furnished again.
   for (const id of touched) {

package/src/plan.ts

@@ -24,6 +24,8 @@ export interface WorldPlan {
   fallback: Theme & { floors: string[] };
   /** For the biggest rooms. */
   filler: [string, string];
+  /** What draws each kind of part in a building. Anything else uses the workstation. */
+  partItems?: Record<string, string>;
 }
 
 /** The office, and the world used when a map doesn't name one. */
@@ -59,6 +61,7 @@ export const OFFICE_PLAN: WorldPlan = {
   ],
   fallback: { floor: "", floors: ["wood", "carpet", "tile", "stone", "concrete"], items: ["plant", "shelf", "lamp"], decor: ["poster"] },
   filler: ["plant", "fern"],
+  partItems: { Desk: "desk", "Server rack": "server", Workbench: "table", Whiteboard: "whiteboard", Bookshelf: "shelf", Toolbox: "printer", Plants: "plant", "Filing cabinet": "shelf" },
 };
 
 const plans = new Map<string, WorldPlan>([[OFFICE_PLAN.id, OFFICE_PLAN]]);