@unson/brainbase-mcp 0.22.0 → 0.22.1

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@unson/brainbase-mcp",
-  "version": "0.22.0",
+  "version": "0.22.1",
   "description": "Local-first Brainbase judgment OS that lets supported AI agents reuse a user's approved goals, priorities, decisions, and judgment criteria.",
   "type": "module",
   "license": "MIT",
@@ -407,5 +407,5 @@
   "engines": {
     "node": ">=20"
   },
-  "gitHead": "4933fdd273d050d9fa76f46b5d3696c1657613eb"
+  "gitHead": "8ce6f52ff6e5650f7f26f913de3888b8906cff81"
 }

package/ui/world/world-district.js

@@ -14,7 +14,7 @@
  */
 
 import { THREE, MapControls } from './world-vendor.js';
-import { DISTRICT_STREETS, districtStreetLots, skyAt } from './world-placement.js';
+import { DISTRICT_STREETS, districtStage, districtStreetLots, skyAt } from './world-placement.js';
 import { canvasTexture, drawFacade, FACADE_SIZES, FACADE_UNITS, gableRoof, hashUnit, paintVertices, roundedPlate, valueNoise } from './world-scenery.js';
 import { makeWorkspaceElement as el } from '../../workspace-kit.js';
 
@@ -37,7 +37,8 @@ export const DISTRICT_LEGEND = Object.freeze([
   ['is-scaffold', '足場と緑のネット＝進行中（記録上）'],
   ['is-cover', 'ブルーシートの覆い＝待ち（記録上）'],
   ['is-stakes', '杭と縄の空き地＝未着手（記録上）'],
-  ['is-house', '明かりのついた家＝完了（記録上）'],
+  ['is-house', '明かりのついた家＝完了して、出典・成果の記録がある（本設の建物）'],
+  ['is-prefab', 'プレハブ＝完了したが、出典・成果の記録が無い'],
   ['is-worker', 'ヘルメットの人＝担当欄の担当'],
   ['is-empty', '誰もいない現場＝担当の記録なし'],
   ['is-outside', '柵の外の人（破線の輪）＝本文にだけ名前がある'],
@@ -46,6 +47,7 @@ export const DISTRICT_LEGEND = Object.freeze([
   ['is-weeds', '雑草と色あせ＝見直し予定を過ぎた'],
   ['is-stone', '庁舎前の石碑＝方針の決定（枠だけ＝題名からの推定）'],
   ['is-street', '通りの看板＝何のための仕事か（タスクの記録の言葉。言葉が無い仕事は門の近くの空き地）'],
+  ['is-stage', '区画の段階（更地・村・町・街・都市）＝本設の建物の数。石畳・街灯・噴水・時計塔が増える'],
   ['is-ambience', '通りを歩く人と煙＝街の雰囲気（記録とは関係しません）'],
 ]);
 
@@ -258,12 +260,17 @@ export function createDistrictView({ doc, stage, reducedMotion = false, onPick,
   });
   dashTexture.wrapT = THREE.RepeatWrapping;
   /** A street along z (or along x when `across`): sidewalks, asphalt, and a dashed centre line if wide. */
-  function streetStrip(parent, { x = 0, z = 0, width, length, across = false, centreLine = false }) {
+  function streetStrip(parent, { x = 0, z = 0, width, length, across = false, centreLine = false, dirt = false }) {
     const strip = (stripWidth, mat, y) => {
       const surface = mesh(new THREE.PlaneGeometry(stripWidth, length), mat, { x, y, z, shadow: false });
       surface.rotation.set(-Math.PI / 2, 0, across ? Math.PI / 2 : 0);
       parent.add(surface);
     };
+    // A dirt track on vacant land; sidewalks and asphalt once the district has grown.
+    if (dirt) {
+      strip(width, material(0xb59d7a, { roughness: 1 }), 0.03);
+      return;
+    }
     strip(width + 0.7, material(0xe4dfd2, { roughness: 1 }), 0.025);
     strip(width, material(0x8e938f, { roughness: 0.95 }), 0.04);
     if (centreLine) {
@@ -288,6 +295,7 @@ export function createDistrictView({ doc, stage, reducedMotion = false, onPick,
   tarpTexture.wrapT = THREE.RepeatWrapping;
 
   let root = null;
+  let fountainJet = null;
   let lots = new Map();
   let labels = [];
   let walkers = [];
@@ -298,6 +306,11 @@ export function createDistrictView({ doc, stage, reducedMotion = false, onPick,
   let flight = null;
   let home = null;
   let focusIds = null;
+  // What changed since the viewer was last here (AC-22, AC-23): a gold ring, a rising building, words.
+  let celebrations = [];
+  const RISING = new Set(['new', 'built', 'evidenced', 'started']);
+  // Changes that set the district back are marked too, in grey, without the gold or the plus.
+  const SETBACK = new Set(['worker_out', 'weeds_grew', 'held']);
   const selectionRing = mesh(new THREE.RingGeometry(1.75, 1.95, 48), new THREE.MeshBasicMaterial({ color: 0x087d62, transparent: true, opacity: 0.9, side: THREE.DoubleSide }), { y: 0.09, shadow: false });
   selectionRing.rotation.x = -Math.PI / 2;
   selectionRing.visible = false;
@@ -383,7 +396,15 @@ export function createDistrictView({ doc, stage, reducedMotion = false, onPick,
         for (const x of [-1.08, 1.08]) group.add(mesh(new THREE.BoxGeometry(0.02, 0.02, 2.0), rope, { x, y: scaffoldH * 0.55, z: -0.25, shadow: false }));
       }
     }
-    if (status === 'completed') {
+    if (status === 'completed' && !(site.source_refs?.length > 0)) {
+      // A prefab: completed, with no record of its source or outcome yet (AC-24).
+      const shell = box(1.7, 0.75, 1.3, 0xd7d9d6, { z: -0.3 }, { roughness: 0.6, metalness: 0.15 });
+      group.add(shell);
+      group.add(mesh(new THREE.BoxGeometry(1.8, 0.06, 1.4), material(0x9fa3a0, { roughness: 0.5, metalness: 0.3 }), { y: 0.78, z: -0.3 }));
+      group.add(mesh(new THREE.BoxGeometry(0.5, 0.28, 0.03), material(0x8fb3c8, { roughness: 0.2 }), { x: -0.35, y: 0.45, z: 0.36, shadow: false }));
+      group.add(mesh(new THREE.BoxGeometry(0.3, 0.55, 0.03), material(0x7d8a8f), { x: 0.45, y: 0.28, z: 0.36, shadow: false }));
+    }
+    if (status === 'completed' && site.source_refs?.length > 0) {
       // A finished house: plastered walls with lit windows, a gable roof, a door to the street.
       const house = block(1.7, 1.05, 1.4, { style: 'house', wall: 0xf2ebdd, lit: true, roof: 0xd8d0c2 });
       house.position.z = -0.3;
@@ -452,6 +473,7 @@ export function createDistrictView({ doc, stage, reducedMotion = false, onPick,
   // --- the district -------------------------------------------------------------------------------
   function clear() {
     if (root) scene.remove(root);
+    fountainJet = null;
     litMaterials.clear();
     lampMaterials.clear();
     for (const label of labels) label.node.remove();
@@ -462,9 +484,45 @@ export function createDistrictView({ doc, stage, reducedMotion = false, onPick,
     selected = null;
     hovered = null;
     focusIds = null;
+    celebrations = [];
     selectionRing.visible = false;
   }
 
+  /** Marks what changed: each changed lot glows; built ones rise from the ground (not with reduced motion). */
+  function celebrate(changes) {
+    for (const item of celebrations) {
+      root?.remove(item.ring);
+      root?.remove(item.beam);
+      item.label.node.remove();
+      labels = labels.filter((label) => label !== item.label);
+    }
+    celebrations = [];
+    if (!changes || changes.first || !root) return;
+    const byTask = new Map();
+    for (const item of changes.items) {
+      if (item.kind === 'left' || !lots.has(item.task_id)) continue;
+      if (!byTask.has(item.task_id)) byTask.set(item.task_id, []);
+      byTask.get(item.task_id).push(item);
+    }
+    let shownWords = 0;
+    for (const [taskId, items] of byTask) {
+      const group = lots.get(taskId);
+      const setback = items.every((item) => SETBACK.has(item.kind));
+      const color = setback ? 0x8a8f94 : 0xe0a526;
+      const ring = mesh(new THREE.RingGeometry(1.95, 2.35, 48), new THREE.MeshBasicMaterial({ color, transparent: true, opacity: 0.9, side: THREE.DoubleSide }), { x: group.position.x, y: 0.1, z: group.position.z, shadow: false });
+      ring.rotation.x = -Math.PI / 2;
+      root.add(ring);
+      // A column of light, so the change can be found from the gate.
+      const beam = mesh(new THREE.CylinderGeometry(0.5, 1.6, 9, 24, 1, true), new THREE.MeshBasicMaterial({ color, transparent: true, opacity: 0.22, side: THREE.DoubleSide, depthWrite: false }), { x: group.position.x, y: 4.6, z: group.position.z, shadow: false });
+      root.add(beam);
+      const words = items.map((item) => `${SETBACK.has(item.kind) ? '！' : '＋'}${item.text.split('（')[0]}`).join('・');
+      const label = addLabel(words, new THREE.Vector3(group.position.x, 3.3, group.position.z), `is-change${setback ? ' is-setback' : ''}`, { priority: shownWords++ < 6 ? 0 : 3 });
+      const rises = !reducedMotion && items.some((item) => RISING.has(item.kind));
+      if (rises) group.scale.set(1, 0.02, 1);
+      celebrations.push({ ring, beam, label, group, rises, started: null });
+    }
+  }
+
   function build(business, work, neighbours) {
     clear();
     root = new THREE.Group();
@@ -474,6 +532,9 @@ export function createDistrictView({ doc, stage, reducedMotion = false, onPick,
     const shown = readable ? work.sites.filter((site) => site.work.status !== 'cancelled') : [];
     const layout = districtStreetLots(shown.map((site) => ({ task_id: site.task_id, created_at: site.work.created_at, purpose_label: site.purpose_label })));
     const L = layout.length;
+    // The stage of the district (AC-24): counted from permanent buildings, it sets how built-up it looks.
+    const stage = districtStage(shown);
+    const grown = stage.level;
     const gateZ = L / 2 + 4;
     const hallZ = -L / 2 - 7;
     // Land as in the world: gentle, non-repeating shades of grass (scenery).
@@ -488,18 +549,19 @@ export function createDistrictView({ doc, stage, reducedMotion = false, onPick,
     // The district's paving: a raised plate with a kerb, from the gate to the hall.
     const pavingDepth = gateZ - hallZ + 14;
     root.add(mesh(roundedPlate(28, pavingDepth, 0.04, 2.2), material(0xd4cec0, { roughness: 1 }), { z: (gateZ + hallZ) / 2, shadow: false }));
-    root.add(mesh(roundedPlate(27, pavingDepth - 1, 0.06, 1.8), material(0xebe6d8, { roughness: 1 }), { z: (gateZ + hallZ) / 2, shadow: false }));
+    const pavingColor = [0xd8cdb2, 0xe2dac6, 0xebe6d8, 0xefeadc, 0xf2eee2][grown];
+    root.add(mesh(roundedPlate(27, pavingDepth - 1, 0.06, 1.8), material(pavingColor, { roughness: 1 }), { z: (gateZ + hallZ) / 2, shadow: false }));
     const lift = new THREE.Group();
     lift.position.y = 0.17;
     root.add(lift);
-    streetStrip(lift, { x: 0, z: (gateZ + 8 + hallZ + 3) / 2, width: DISTRICT_STREETS.main * 2, length: gateZ + 8 - (hallZ + 3), centreLine: true });
-    streetStrip(lift, { x: -DISTRICT_STREETS.backStreet, z: 0, width: 1.6, length: L + 2 });
-    streetStrip(lift, { x: DISTRICT_STREETS.backStreet, z: 0, width: 1.6, length: L + 2 });
+    streetStrip(lift, { x: 0, z: (gateZ + 8 + hallZ + 3) / 2, width: DISTRICT_STREETS.main * 2, length: gateZ + 8 - (hallZ + 3), centreLine: grown >= 2, dirt: grown === 0 });
+    streetStrip(lift, { x: -DISTRICT_STREETS.backStreet, z: 0, width: 1.6, length: L + 2, dirt: grown < 2 });
+    streetStrip(lift, { x: DISTRICT_STREETS.backStreet, z: 0, width: 1.6, length: L + 2, dirt: grown < 2 });
     // A cross street between the blocks, and at the hall end of each block a sign saying what its work is for.
     const crossWidth = DISTRICT_STREETS.backLot * 2 + 4;
     layout.streets.forEach((block, index) => {
       if (index < layout.streets.length - 1) {
-        streetStrip(lift, { x: 0, z: block.z_to + DISTRICT_STREETS.cross / 2, width: DISTRICT_STREETS.cross * 0.62, length: crossWidth, across: true });
+        streetStrip(lift, { x: 0, z: block.z_to + DISTRICT_STREETS.cross / 2, width: DISTRICT_STREETS.cross * 0.62, length: crossWidth, across: true, dirt: grown < 2 });
       }
       const signZ = block.z_from - (index === 0 ? 0.9 : DISTRICT_STREETS.cross / 2);
       root.add(mesh(new THREE.CylinderGeometry(0.06, 0.08, 2.5, 8), material(0x3f4844, { roughness: 0.6, metalness: 0.4 }), { x: -DISTRICT_STREETS.main - 0.5, y: 1.25, z: signZ }));
@@ -523,7 +585,8 @@ export function createDistrictView({ doc, stage, reducedMotion = false, onPick,
       trees.push([Math.cos(angle) * rx, (gateZ + hallZ) / 2 + Math.sin(angle) * rz, 0.8 + hashUnit(`belt${i}s`) * 0.6]);
     }
     plantTrees(root, trees.filter(([x, z]) => !(Math.abs(x) < 4.2 && z > gateZ - 1)));
-    placeLamps(lift, lamps);
+    // Lamps come with the district's growth: none on vacant land, every other one in a village.
+    placeLamps(lift, grown === 0 ? [] : grown === 1 ? lamps.filter((_, i) => i % 4 === 0) : lamps);
     // The gate: stone pillars on plinths, a lintel with a cornice, lamps on its pillars.
     const stone = material(0xe2dccf, { roughness: 0.9 });
     for (const x of [-3.3, 3.3]) {
@@ -534,7 +597,7 @@ export function createDistrictView({ doc, stage, reducedMotion = false, onPick,
     root.add(mesh(new THREE.BoxGeometry(7.8, 0.55, 0.95), stone, { y: 4.65, z: gateZ }));
     root.add(mesh(new THREE.BoxGeometry(8.2, 0.16, 1.1), material(0xcfc8ba, { roughness: 0.9 }), { y: 5.0, z: gateZ }));
     placeLamps(root, [[-3.3, gateZ + 0.6], [3.3, gateZ + 0.6]]);
-    addLabel(`${business.name}の区画（入口）`, new THREE.Vector3(0, 5.2, gateZ), 'is-city', { priority: 1 });
+    addLabel(`${business.name}の区画（入口）・${stage.label}`, new THREE.Vector3(0, 5.2, gateZ), 'is-city', { priority: 1 });
     // The hall: what this business is for, and the stones of its policies in front of it.
     // A civic building as in the world: steps, a colonnade, tall lit windows, a pediment.
     for (let step = 0; step < 3; step += 1) root.add(mesh(roundedPlate(9.6 - step * 0.5, 6.2 - step * 0.4, 0.1, 0.25), stone, { y: step * 0.18, z: hallZ + 0.2 }));
@@ -559,6 +622,28 @@ export function createDistrictView({ doc, stage, reducedMotion = false, onPick,
     const ring = mesh(new THREE.RingGeometry(3.6, 3.85, 48), material(0xcfc8b8, { roughness: 1 }), { y: 0.21, z: hallZ + 5.4, shadow: false });
     ring.rotation.x = -Math.PI / 2;
     root.add(ring);
+    if (grown >= 3) {
+      // A fountain in the plaza once the district is a 街.
+      const basin = material(0xd9d3c6, { roughness: 0.8 });
+      root.add(mesh(new THREE.CylinderGeometry(1.0, 1.1, 0.35, 32), basin, { y: 0.37, z: hallZ + 5.4 }));
+      const water = mesh(new THREE.CylinderGeometry(0.88, 0.88, 0.04, 32), material(0x7fc4d6, { roughness: 0.15, metalness: 0.1, transparent: true, opacity: 0.85 }), { y: 0.52, z: hallZ + 5.4, shadow: false });
+      root.add(water);
+      root.add(mesh(new THREE.CylinderGeometry(0.12, 0.16, 0.7, 12), basin, { y: 0.7, z: hallZ + 5.4 }));
+      const jet = mesh(new THREE.ConeGeometry(0.22, 0.6, 12, 1, true), material(0xcfeef5, { transparent: true, opacity: 0.6, emissive: new THREE.Color(0x6fb6c9), emissiveIntensity: 0.2 }), { y: 1.25, z: hallZ + 5.4, shadow: false });
+      jet.rotation.x = Math.PI;
+      root.add(jet);
+      fountainJet = jet;
+    }
+    if (grown >= 4) {
+      // A clock tower beside the hall once the district is a 都市.
+      const tower = block(1.4, 6.0, 1.4, { style: 'civic', wall: 0xe8e0cf, lit: true, roof: 0xb5654a });
+      tower.position.set(5.6, 0.2, hallZ - 0.4);
+      root.add(tower);
+      const cap = mesh(new THREE.ConeGeometry(1.1, 1.4, 4), material(0xb5654a, { roughness: 0.7 }), { x: 5.6, y: 6.9, z: hallZ - 0.4 });
+      cap.rotation.y = Math.PI / 4;
+      root.add(cap);
+      root.add(mesh(new THREE.CylinderGeometry(0.42, 0.42, 0.06, 24), material(0xfaf6ea, { emissive: new THREE.Color(0xffe2a0), emissiveIntensity: 0.3 }), { x: 5.6, y: 5.6, z: hallZ + 0.33, shadow: false }).rotateX(Math.PI / 2));
+    }
     const policies = work?.status === 'ok' ? work.purpose.policies.slice(0, 8) : [];
     policies.forEach((policy, index) => {
       const angle = Math.PI * (0.15 + (0.7 * index) / Math.max(policies.length - 1, 1));
@@ -797,6 +882,19 @@ export function createDistrictView({ doc, stage, reducedMotion = false, onPick,
         puff.material.opacity = 0.5 * (1 - cycle);
       }
     }
+    for (const item of celebrations) {
+      item.started ??= time;
+      const elapsed = (time - item.started) / 1000;
+      if (item.rises) {
+        const t = Math.min(elapsed / 1.4, 1);
+        item.group.scale.y = 0.02 + 0.98 * (1 - (1 - t) ** 3);
+        if (t >= 1) item.rises = false;
+      }
+      // Pulses for a while, then stays as a faint ring so the change can still be found.
+      item.ring.material.opacity = reducedMotion ? 0.8 : elapsed < 8 ? 0.55 + 0.4 * Math.sin(elapsed * 5) : 0.45;
+      item.beam.material.opacity = reducedMotion ? 0.2 : elapsed < 8 ? 0.16 + 0.12 * Math.sin(elapsed * 5) : 0.12;
+    }
+    if (fountainJet && !reducedMotion) fountainJet.scale.y = 1 + 0.12 * Math.sin(time / 260);
     if (selectionRing.visible) selectionRing.material.opacity = 0.6 + 0.3 * Math.sin(time / 300);
     renderer.render(scene, camera);
     placeLabels();
@@ -851,6 +949,16 @@ export function createDistrictView({ doc, stage, reducedMotion = false, onPick,
       focusIds = taskIds ? new Set(taskIds) : null;
       applyFocus();
     },
+    /** Shows what changed since the viewer's last visit (from `districtChanges`). */
+    celebrate,
+    /** Rebuilds the open district from fresh records, keeping the camera where it is. */
+    refresh(business, work, { neighbours = new Map() } = {}) {
+      const keep = { target: controls.target.clone(), position: camera.position.clone() };
+      build(business, work, neighbours);
+      controls.target.copy(keep.target);
+      camera.position.copy(keep.position);
+      camera.lookAt(keep.target);
+    },
     dispose() {
       running = false;
       observer?.disconnect();

package/ui/world/world-placement.js

@@ -193,3 +193,106 @@ export function districtStreetLots(sites, { minRows = 4 } = {}) {
   }
   return { lots, streets, rows, length };
 }
+
+/*
+ * The town grows (story-world-work-sites-and-gaps-v1, AC-22〜24).  It grows only from evidenced outcomes
+ * and closed gaps, never from activity: counting completions or edits would let splitting work inflate it.
+ */
+const WORKER_GAPS = new Set(['assignee_unrecorded', 'assignee_unlinked_mentioned']);
+const PATH_GAPS = new Set(['source_unlinked', 'outcome_unlinked']);
+const OPEN_STATES = new Set(['pending', 'in_progress', 'waiting']);
+
+export const DISTRICT_CHANGE_TEXT = Object.freeze({
+  new: '新しい現場ができた',
+  left: '区画を出た仕事がある（取消・付け替え）',
+  built: '家が建った（完了）',
+  evidenced: 'プレハブが本設の建物になった（成果の記録がつながった）',
+  started: '着工した（未着手→進行中）',
+  held: 'シートがかかった（→待ち）',
+  resumed: 'シートが外れた（待ち→進行中）',
+  worker_in: '作業員が入った（担当がつながった）',
+  worker_out: '作業員がいなくなった（担当が外れた）',
+  path_linked: '道がつながった（出典・成果の記録がついた）',
+  weeds_cleared: '雑草が抜けた（見直された）',
+  weeds_grew: '雑草が生えた（見直し予定を過ぎた）',
+});
+
+const hasEvidence = (site) => (site.source_refs?.length ?? 0) > 0;
+
+/** What this viewer saw of a district, kept in their browser to tell what changed next time. */
+export function districtSnapshot(sites, at) {
+  const kept = {};
+  for (const site of sites ?? []) {
+    if (site.work?.status === 'cancelled') continue;
+    kept[site.task_id] = {
+      s: site.work?.status ?? null,
+      g: [...new Set((site.gaps ?? []).map((gap) => gap.kind))].sort(),
+      l: site.purpose_label ?? null,
+      e: hasEvidence(site),
+    };
+  }
+  return { v: 1, at, sites: kept };
+}
+
+/** What changed in a district since `previous` (a snapshot), in the words of the street. */
+export function districtChanges(previous, sites, at) {
+  if (!previous || previous.v !== 1 || typeof previous.sites !== 'object' || previous.sites === null) {
+    return { first: true, since: null, at, items: [], counts: {} };
+  }
+  const now = districtSnapshot(sites, at).sites;
+  const items = [];
+  const add = (taskId, kind) => items.push({ task_id: taskId, kind, text: DISTRICT_CHANGE_TEXT[kind] });
+  for (const [taskId, after] of Object.entries(now)) {
+    const before = previous.sites[taskId];
+    if (!before) {
+      add(taskId, 'new');
+      continue;
+    }
+    if (OPEN_STATES.has(before.s) && after.s === 'completed') add(taskId, 'built');
+    if (before.s === 'completed' && after.s === 'completed' && !before.e && after.e) add(taskId, 'evidenced');
+    if (before.s === 'pending' && after.s === 'in_progress') add(taskId, 'started');
+    if (before.s !== 'waiting' && OPEN_STATES.has(before.s) && after.s === 'waiting') add(taskId, 'held');
+    if (before.s === 'waiting' && after.s === 'in_progress') add(taskId, 'resumed');
+    const had = (gaps, set) => (gaps ?? []).some((kind) => set.has(kind));
+    if (had(before.g, WORKER_GAPS) && !had(after.g, WORKER_GAPS)) add(taskId, 'worker_in');
+    if (!had(before.g, WORKER_GAPS) && had(after.g, WORKER_GAPS)) add(taskId, 'worker_out');
+    if (had(before.g, PATH_GAPS) && !had(after.g, PATH_GAPS)) add(taskId, 'path_linked');
+    const overdue = new Set(['review_overdue']);
+    if (had(before.g, overdue) && !had(after.g, overdue)) add(taskId, 'weeds_cleared');
+    if (!had(before.g, overdue) && had(after.g, overdue)) add(taskId, 'weeds_grew');
+  }
+  for (const taskId of Object.keys(previous.sites)) if (!now[taskId]) add(taskId, 'left');
+  const counts = {};
+  for (const item of items) counts[item.kind] = (counts[item.kind] ?? 0) + 1;
+  return { first: false, since: previous.at ?? null, at, items, counts };
+}
+
+export const DISTRICT_STAGES = Object.freeze([
+  { key: 'vacant', label: '更地', min: 0 },
+  { key: 'village', label: '村', min: 1 },
+  { key: 'town', label: '町', min: 3 },
+  { key: 'street', label: '街', min: 7 },
+  { key: 'city', label: '都市', min: 15 },
+]);
+
+/** The stage of a district: counted from completed work with a record of its source (a permanent building). */
+export function districtStage(sites) {
+  const live = (sites ?? []).filter((site) => site.work?.status !== 'cancelled');
+  const completed = live.filter((site) => site.work?.status === 'completed');
+  const permanent = completed.filter(hasEvidence).length;
+  const open = live.filter((site) => OPEN_STATES.has(site.work?.status));
+  let index = 0;
+  DISTRICT_STAGES.forEach((stage, i) => { if (permanent >= stage.min) index = i; });
+  const stage = DISTRICT_STAGES[index];
+  const following = DISTRICT_STAGES[index + 1] ?? null;
+  return {
+    key: stage.key,
+    label: stage.label,
+    level: index,
+    permanent,
+    prefab: completed.length - permanent,
+    open: open.length,
+    clear_open: open.filter((site) => (site.gaps?.length ?? 0) === 0).length,
+    next: following ? { label: following.label, needed: following.min - permanent } : null,
+  };
+}

package/ui/world/world-view.css

@@ -217,6 +217,44 @@
   color: #5c5546;
 }
 
+.bb-world-label.is-change {
+  font-weight: 700;
+  background: #fff4d6;
+  border-color: #e0a526;
+  color: #6b4a00;
+}
+
+.bb-world-label.is-change.is-setback {
+  background: #eef0f1;
+  border-color: #8a8f94;
+  color: #3f454a;
+}
+
+.bb-world-growth-stage {
+  margin: 0 0 6px;
+}
+
+.bb-world-growth-stage strong {
+  font-size: 1.25em;
+}
+
+.bb-world-growth-since {
+  margin: 8px 0 2px;
+  font-weight: 700;
+}
+
+.bb-world-growth-changes li {
+  border-left: 3px solid #e0a526;
+  padding-left: 6px;
+}
+
+.bb-world-growth-changes li.is-worker_out,
+.bb-world-growth-changes li.is-weeds_grew,
+.bb-world-growth-changes li.is-held,
+.bb-world-growth-changes li.is-left {
+  border-left-color: var(--bb-color-muted);
+}
+
 .bb-world-label.is-engagement {
   font-size: 11px;
   color: var(--bb-color-muted);

package/ui/world/world-view.js

@@ -23,10 +23,10 @@
  */
 
 import { THREE, MapControls } from './world-vendor.js';
-import { changesSince, cityMeasures, districtLots, groupJudgmentPlaces, skyAt, UNPLACED_REASON_TEXT } from './world-placement.js';
+import { changesSince, cityMeasures, districtChanges, districtLots, districtSnapshot, districtStage, groupJudgmentPlaces, skyAt, UNPLACED_REASON_TEXT } from './world-placement.js';
 import { createDistrictView } from './world-district.js';
 import { canvasTexture, drawFacade, FACADE_SIZES, FACADE_UNITS, gableRoof, hashUnit, muted, paintVertices, roundedPlate, valueNoise } from './world-scenery.js';
-import { WORK_STATES, workCityBlocks, workPickBlock, workSign, workSiteBlocks } from './world-work-rail.js';
+import { WORK_STATES, workCityBlocks, workGrowthBlock, workPickBlock, workSign, workSiteBlocks } from './world-work-rail.js';
 import {
   makeWorkspaceElement as el,
   workspacePageHeader,
@@ -1684,6 +1684,8 @@ export function createWorldView({ root, rail, page, document: explicitDocument,
       }));
       blocks.push(workspaceRailBlock(doc, { title: '', content: workspaceButton(doc, { text: 'すべての仕事を表示', onClick: () => showFocus(business, null) }) }));
     }
+    const growth = growthFor(business.code);
+    if (growth) blocks.push(workGrowthBlock(doc, growth));
     blocks.push(...workBlocksFor(business), ...cityRegistrationBlocks(business));
     showRail(blocks);
     if (revealFocus) reveal(focusBlock ?? blocks[0]);
@@ -1703,6 +1705,64 @@ export function createWorldView({ root, rail, page, document: explicitDocument,
     renderCityRail(business, { revealFocus: true });
   }
 
+  // --- the district grows (AC-22〜24): what changed since this viewer was last inside -------------
+  // The last state seen is a per-viewer convenience kept in this browser; nothing is lost if it forgets.
+  const districtGrowth = new Map();
+  const snapshotKey = (code) => `brainbase.world.district.${code}`;
+  function readSnapshot(code) {
+    try {
+      return JSON.parse(globalThis.localStorage?.getItem(snapshotKey(code)) ?? 'null');
+    } catch {
+      return null;
+    }
+  }
+  function writeSnapshot(code, snapshot) {
+    try {
+      globalThis.localStorage?.setItem(snapshotKey(code), JSON.stringify(snapshot));
+    } catch {
+      // Without storage the district shows no changes next time.
+    }
+  }
+  const liveSites = (work) => (work?.status === 'ok' && work.reads.tasks.state !== 'unavailable' ? work.sites : null);
+  /** Compares against what this viewer last saw, then remembers what they see now. */
+  function noteGrowth(code, work, previous) {
+    const sites = liveSites(work);
+    if (!sites) {
+      districtGrowth.delete(code);
+      return null;
+    }
+    const at = new Date().toISOString();
+    const changes = districtChanges(previous, sites, at);
+    const growth = { stage: districtStage(sites), changes, seen: districtSnapshot(sites, at) };
+    districtGrowth.set(code, growth);
+    writeSnapshot(code, growth.seen);
+    return growth;
+  }
+  const growthFor = (code) => districtGrowth.get(code) ?? null;
+
+  // AC-23: coming back from the task screen with the district open, read its work again and answer.
+  async function recheckDistrict() {
+    const business = districtCode ? businessOf(districtCode) : null;
+    if (!business || !district?.isOpen()) return;
+    const previous = growthFor(business.code)?.seen ?? readSnapshot(business.code);
+    const result = await readJson(fetcher, `/api/extensions/world/businesses/${encodeURIComponent(business.code)}/work`);
+    if (!result.ok || districtCode !== business.code) return;
+    const work = result.data;
+    const before = previous ? districtChanges(previous, liveSites(work) ?? [], new Date().toISOString()) : null;
+    if (!before || before.first || !before.items.length) return;
+    workCache.set(business.code, work);
+    scene?.showWork(business.code, work);
+    district.refresh(business, work, { neighbours: new Map(knownBusinesses.map((entry) => [entry.code, entry.name])) });
+    const growth = noteGrowth(business.code, work, previous);
+    district.celebrate(growth?.changes ?? null);
+    district.focus(focusIdsFor(work, current.focus));
+    if (current.level === 'city') renderCityRail(business);
+  }
+  const onVisible = () => {
+    if (doc.visibilityState === 'visible') void recheckDistrict();
+  };
+  doc.addEventListener('visibilitychange', onVisible);
+
   // --- inside a district (AC-11): the world rests behind it while it is open ---------------------
   let district = null;
   let districtCode = null;
@@ -1729,6 +1789,8 @@ export function createWorldView({ root, rail, page, document: explicitDocument,
     if (districtCode !== business.code || !district.isOpen()) {
       district.show(business, work, { neighbours: new Map(knownBusinesses.map((entry) => [entry.code, entry.name])) });
       districtCode = business.code;
+      const growth = growthFor(business.code) ?? noteGrowth(business.code, work, readSnapshot(business.code));
+      district.celebrate(growth?.changes ?? null);
     }
     district.focus(focusIdsFor(work, current.focus));
     return true;
@@ -2115,6 +2177,7 @@ export function createWorldView({ root, rail, page, document: explicitDocument,
   void load();
   return {
     dispose() {
+      doc.removeEventListener('visibilitychange', onVisible);
       scene?.dispose();
     },
   };

package/ui/world/world-work-rail.js

@@ -335,3 +335,37 @@ export function workSiteBlocks(doc, { business, site, readAt, taskHref }) {
   blocks.push(workspaceRailBlock(doc, { title: '出典', content: workspaceDefinition(doc, [['記録', `${site.task_id}（版 ${site.source.version ?? '不明'}）`], ['事業', business.name]]) }));
   return blocks;
 }
+
+/**
+ * How the district has grown (AC-22, AC-24): its stage, what it is counted from, how far to the next, and
+ * what changed since this viewer was last here.  Counts of records, never a score.
+ */
+export function workGrowthBlock(doc, { stage, changes }) {
+  const content = [];
+  const head = el(doc, 'p', { className: 'bb-world-growth-stage' });
+  head.append(el(doc, 'strong', { text: stage.label }), el(doc, 'span', { text: `　本設の建物 ${stage.permanent}軒・プレハブ ${stage.prefab}軒` }));
+  content.push(head);
+  content.push(workspaceDefinition(doc, [
+    ['断絶の無い未完了', `${stage.clear_open} / ${stage.open}件`],
+    ['次の段階', stage.next ? `${stage.next.label}まで本設の建物あと${stage.next.needed}軒` : 'いちばん上の段階です'],
+  ]));
+  content.push(el(doc, 'p', {
+    className: 'bb-world-rail-note',
+    text: '本設の建物＝完了して、出典か成果の記録がついた仕事。記録の無い完了はプレハブのままで、件数を増やしても街は育ちません。',
+  }));
+  if (changes) {
+    if (changes.first) {
+      content.push(el(doc, 'p', { className: 'bb-world-rail-note', text: 'この区画に初めて入りました。次回から、前回からの変化を出します（このブラウザに覚えます）。' }));
+    } else if (!changes.items.length) {
+      content.push(el(doc, 'p', { className: 'bb-world-rail-note', text: `前回（${shortTime(changes.since) ?? '時点不明'}）から変わったことはありません。` }));
+    } else {
+      const list = el(doc, 'ul', { className: 'bb-world-rail-list bb-world-growth-changes' });
+      for (const [kind, count] of Object.entries(changes.counts)) {
+        const text = changes.items.find((item) => item.kind === kind)?.text ?? kind;
+        list.append(el(doc, 'li', { className: `is-${kind}`, text: `${text}　${count}件` }));
+      }
+      content.push(el(doc, 'p', { className: 'bb-world-growth-since', text: `前回（${shortTime(changes.since) ?? '時点不明'}）から` }), list);
+    }
+  }
+  return workspaceRailBlock(doc, { title: '区画の育ち', content });
+}