@pascal-app/core 1.0.6 → 1.1.0

package/dist/agent-operations/stair-plan-footprint.js

@@ -0,0 +1,50 @@
+import { computeSegmentTransforms, rotateXZ } from '../systems/stair/stair-footprint.js';
+import { resolveStairTotalRise } from '../systems/stair/stair-rise-query.js';
+function toWorldPlanPoint(stair, localX, localZ) {
+    const [worldX, worldZ] = rotateXZ(localX, localZ, stair.rotation ?? 0);
+    return [stair.position[0] + worldX, stair.position[2] + worldZ];
+}
+/** The floor a stair stands on, in its level's plan frame: a straight stair's segments, a curved or spiral stair's turning circle. */
+export function stairFootprintPolygons(nodes, stair) {
+    if (stair.stairType === 'curved' || stair.stairType === 'spiral') {
+        const radius = Math.max(0.05, stair.innerRadius ?? 0.9) + Math.max(stair.width ?? 1, 0.4);
+        return [
+            Array.from({ length: 24 }).map((_, index) => {
+                const angle = (index / 24) * Math.PI * 2;
+                return toWorldPlanPoint(stair, Math.cos(angle) * radius, Math.sin(angle) * radius);
+            }),
+        ];
+    }
+    const segments = (stair.children ?? [])
+        .map((childId) => nodes[childId])
+        .filter((node) => node?.type === 'stair-segment');
+    const usableSegments = segments.length > 0
+        ? segments
+        : [
+            {
+                width: stair.width ?? 1,
+                length: 3,
+                height: resolveStairTotalRise(stair, nodes),
+                stepCount: stair.stepCount ?? 10,
+                attachmentSide: 'front',
+            },
+        ];
+    const transforms = computeSegmentTransforms(usableSegments);
+    return usableSegments.map((segment, index) => {
+        const transform = transforms[index] ?? {
+            position: [0, 0, 0],
+            rotation: 0,
+        };
+        const halfWidth = segment.width / 2;
+        const corners = [
+            [-halfWidth, 0],
+            [halfWidth, 0],
+            [halfWidth, segment.length],
+            [-halfWidth, segment.length],
+        ];
+        return corners.map(([localX, localZ]) => {
+            const [rx, rz] = rotateXZ(localX, localZ, transform.rotation);
+            return toWorldPlanPoint(stair, transform.position[0] + rx, transform.position[2] + rz);
+        });
+    });
+}

package/dist/agent-operations/types.d.ts

@@ -1,17 +1,20 @@
 import type { ZodType } from 'zod';
 import type { DesignBrief } from '../agent-tools/design-brief.js';
 import type { AnyNode, AssetInput, Collection, CompiledGeometryScript, SceneMaterial, SceneMaterialId } from '../schema/index.js';
+import type { AssetSearchResult } from './asset-catalog.js';
 import type { AssetViewFacts } from './asset-views.js';
 import type { SessionKeep, SessionRecord } from './scene-checkpoint.js';
 export type SceneNodes = Readonly<Record<string, AnyNode>>;
 /**
  * What a surface knows beyond the scene: the chat knows the floor a person is viewing; a host
  * passes the agent's session so far (the moments it named, what it made), which verify_scene
- * compares the scene with. A host with an item library passes it as `catalog` (the chat and the
- * hosted MCP: the published library; the standalone MCP: its built-in list), resolved before the
- * call, as the operations are sync. A host that can store scene materials with the nodes that use
- * them passes the scene's `materials`: paint then checks scene refs against them and keeps a native
- * material as one.
+ * compares the scene with. A host with an item library reads what the call needs of it before
+ * the call, as the operations are sync (`readCatalog`): a list held whole (the standalone MCP's
+ * built-in one) is the `catalog`; a library searched where it is kept (the chat's and the hosted
+ * MCP's published library) gives the items the call names as `catalog` and its search answers as
+ * `catalogSearches`. A host that can store scene materials with the nodes that use them passes
+ * the scene's `materials`: paint then checks scene refs against them and keeps a native material
+ * as one.
  */
 export type AgentContext = {
     activeLevelId: string | null;
@@ -30,6 +33,8 @@ export type AgentContext = {
     /** The agent's session so far. The host keeps it where its sessions live; it is never scene data. */
     session?: SessionRecord;
     catalog?: readonly AssetInput[];
+    /** The library's answers to the call's searches, by `assetSearchKey`; set, they are what search_assets lists. */
+    catalogSearches?: Readonly<Record<string, AssetSearchResult>>;
     /**
      * What a host read about catalog items before the call, by item id (`assetViewNeeds` says
      * which): their pictures for view_assets, the names of their paintable surfaces for it and for

package/dist/agent-operations/types.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../../src/agent-operations/types.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../../src/agent-operations/types.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,KAAK,CAAA;AAClC,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,6BAA6B,CAAA;AAC9D,OAAO,KAAK,EACV,OAAO,EACP,UAAU,EACV,UAAU,EACV,sBAAsB,EACtB,aAAa,EACb,eAAe,EAChB,MAAM,WAAW,CAAA;AAClB,OAAO,KAAK,EAAE,iBAAiB,EAAE,MAAM,iBAAiB,CAAA;AACxD,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,eAAe,CAAA;AACnD,OAAO,KAAK,EAAE,WAAW,EAAE,aAAa,EAAE,MAAM,oBAAoB,CAAA;AAEpE,MAAM,MAAM,UAAU,GAAG,QAAQ,CAAC,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC,CAAA;AAE1D;;;;;;;;;;GAUG;AACH,MAAM,MAAM,YAAY,GAAG;IACzB,aAAa,EAAE,MAAM,GAAG,IAAI,CAAA;IAC5B;;;;;OAKG;IACH,UAAU,CAAC,EAAE,CAAC,IAAI,EAAE,MAAM,KAAK,OAAO,GAAG,SAAS,CAAA;IAClD,wFAAwF;IACxF,UAAU,CAAC,EAAE;QAAE,IAAI,EAAE,MAAM,CAAC;QAAC,OAAO,EAAE,OAAO,CAAA;KAAE,CAAA;IAC/C,qGAAqG;IACrG,OAAO,CAAC,EAAE,aAAa,CAAA;IACvB,OAAO,CAAC,EAAE,SAAS,UAAU,EAAE,CAAA;IAC/B,iHAAiH;IACjH,eAAe,CAAC,EAAE,QAAQ,CAAC,MAAM,CAAC,MAAM,EAAE,iBAAiB,CAAC,CAAC,CAAA;IAC7D;;;;OAIG;IACH,UAAU,CAAC,EAAE,QAAQ,CAAC,MAAM,CAAC,MAAM,EAAE,cAAc,CAAC,CAAC,CAAA;IACrD,SAAS,CAAC,EAAE,QAAQ,CAAC,MAAM,CAAC,eAAe,EAAE,aAAa,CAAC,CAAC,CAAA;IAC5D,4EAA4E;IAC5E,YAAY,CAAC,EAAE,QAAQ,CAAC,MAAM,CAAC,MAAM,EAAE,aAAa,CAAC,CAAC,CAAA;IACtD,SAAS,CAAC,EAAE,MAAM,CAAA;IAClB;;;;OAIG;IACH,WAAW,CAAC,EAAE,WAAW,GAAG,IAAI,CAAA;IAChC;;;;OAIG;IACH,WAAW,CAAC,EAAE,MAAM,CAAA;CACrB,CAAA;AAED,gGAAgG;AAChG,MAAM,MAAM,aAAa,GACrB;IAAE,QAAQ,EAAE,sBAAsB,CAAA;CAAE,GACpC;IAAE,OAAO,EAAE;QAAE,IAAI,EAAE,MAAM,CAAC;QAAC,OAAO,EAAE,MAAM,CAAA;KAAE,CAAA;CAAE,CAAA;AAElD,gFAAgF;AAChF,MAAM,MAAM,SAAS,GACjB;IAAE,EAAE,EAAE,QAAQ,CAAC;IAAC,IAAI,EAAE,OAAO,CAAC;IAAC,QAAQ,CAAC,EAAE,MAAM,CAAA;CAAE,GAClD;IAAE,EAAE,EAAE,QAAQ,CAAC;IAAC,EAAE,EAAE,MAAM,CAAC;IAAC,IAAI,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAA;CAAE,GAC3D;IAAE,EAAE,EAAE,QAAQ,CAAC;IAAC,EAAE,EAAE,MAAM,CAAA;CAAE,CAAA;AAEhC,4FAA4F;AAC5F,MAAM,MAAM,YAAY,GAAG;IACzB,sEAAsE;IACtE,SAAS,CAAC,EAAE,SAAS,aAAa,EAAE,CAAA;IACpC,MAAM,CAAC,EAAE;QAAE,IAAI,EAAE,OAAO,CAAC;QAAC,QAAQ,CAAC,EAAE,MAAM,CAAA;KAAE,EAAE,CAAA;IAC/C,MAAM,CAAC,EAAE;QAAE,EAAE,EAAE,MAAM,CAAC;QAAC,IAAI,EAAE,OAAO,CAAC,OAAO,CAAC,CAAA;KAAE,EAAE,CAAA;IACjD,sFAAsF;IACtF,MAAM,CAAC,EAAE,MAAM,EAAE,CAAA;IACjB,6DAA6D;IAC7D,WAAW,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,UAAU,GAAG,IAAI,CAAC,CAAA;CAChD,CAAA;AAED,MAAM,MAAM,qBAAqB,GAAG;IAClC,MAAM,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAA;IAC/B,uFAAuF;IACvF,IAAI,CAAC,EAAE,WAAW,CAAA;IAClB,OAAO,CAAC,EAAE,YAAY,CAAA;IACtB;;;;;OAKG;IACH,cAAc,CAAC,EAAE,CAAC,KAAK,EAAE,UAAU,KAAK;QACtC,MAAM,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAA;QAC/B,OAAO,CAAC,EAAE,YAAY,CAAA;KACvB,CAAA;CACF,CAAA;AAED;;;GAGG;AACH,MAAM,MAAM,cAAc,CAAC,KAAK,GAAG,KAAK,IAAI,CAC1C,KAAK,EAAE,UAAU,EACjB,KAAK,EAAE,KAAK,EACZ,OAAO,EAAE,YAAY,KAClB,qBAAqB,CAAA;AAE1B,qGAAqG;AACrG,MAAM,MAAM,eAAe,GAAG,QAAQ,CAAC,MAAM,CAAC,MAAM,EAAE,cAAc,CAAC,CAAC,CAAA"}

package/dist/agent-operations/units.d.ts

@@ -0,0 +1,26 @@
+import { type UnitKind } from '../schema/index.js';
+import type { AgentOperation } from './types.js';
+type CreateUnitInput = {
+    buildingId?: string;
+    name: string;
+    kind?: UnitKind;
+    color?: string;
+    memberZoneIds?: string[];
+    move?: boolean;
+};
+type SetUnitMembersInput = {
+    unitId: string;
+    memberZoneIds: string[];
+    move?: boolean;
+};
+type ListUnitsInput = {
+    buildingId?: string;
+};
+/** `create_unit`: a unit under its building, holding the zones named. */
+export declare const createUnit: AgentOperation<CreateUnitInput>;
+/** `set_unit_members`: the unit's rooms from now on. */
+export declare const setUnitMembers: AgentOperation<SetUnitMembersInput>;
+/** `list_units`: every unit of a building, or of the scene, with its report. */
+export declare const listUnits: AgentOperation<ListUnitsInput>;
+export {};
+//# sourceMappingURL=units.d.ts.map

package/dist/agent-operations/units.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"units.d.ts","sourceRoot":"","sources":["../../src/agent-operations/units.ts"],"names":[],"mappings":"AAEA,OAAO,EAAqB,KAAK,QAAQ,EAA2B,MAAM,WAAW,CAAA;AAGrF,OAAO,KAAK,EAAE,cAAc,EAA4B,MAAM,SAAS,CAAA;AAEvE,KAAK,eAAe,GAAG;IACrB,UAAU,CAAC,EAAE,MAAM,CAAA;IACnB,IAAI,EAAE,MAAM,CAAA;IACZ,IAAI,CAAC,EAAE,QAAQ,CAAA;IACf,KAAK,CAAC,EAAE,MAAM,CAAA;IACd,aAAa,CAAC,EAAE,MAAM,EAAE,CAAA;IACxB,IAAI,CAAC,EAAE,OAAO,CAAA;CACf,CAAA;AAED,KAAK,mBAAmB,GAAG;IAAE,MAAM,EAAE,MAAM,CAAC;IAAC,aAAa,EAAE,MAAM,EAAE,CAAC;IAAC,IAAI,CAAC,EAAE,OAAO,CAAA;CAAE,CAAA;AAEtF,KAAK,cAAc,GAAG;IAAE,UAAU,CAAC,EAAE,MAAM,CAAA;CAAE,CAAA;AAsE7C,yEAAyE;AACzE,eAAO,MAAM,UAAU,EAAE,cAAc,CAAC,eAAe,CA4BtD,CAAA;AAED,wDAAwD;AACxD,eAAO,MAAM,cAAc,EAAE,cAAc,CAAC,mBAAmB,CA4B9D,CAAA;AAED,gFAAgF;AAChF,eAAO,MAAM,SAAS,EAAE,cAAc,CAAC,cAAc,CAUpD,CAAA"}

package/dist/agent-operations/units.js

@@ -0,0 +1,110 @@
+import { refuse } from '../agent-tools/refusal.js';
+import { buildUnitReport } from '../lib/unit-report.js';
+import { UnitNode } from '../schema/index.js';
+import { targetBuilding } from './add-level.js';
+import { queryNodes } from './scene-queries.js';
+const unitsOf = (nodes, buildingId) => queryNodes(nodes, { type: 'unit' }).filter((unit) => unit.parentId === buildingId);
+/**
+ * The zones as the unit may hold them: each one a zone on a level of the building, in no other
+ * unit of it unless the call moves it, each once. Answers the members and the units that lose one.
+ */
+function memberZones(nodes, building, zoneIds, except, move) {
+    const levelIds = new Set(queryNodes(nodes, { type: 'level' })
+        .filter((level) => level.parentId === building.id ||
+        building.children.includes(level.id))
+        .map((level) => level.id));
+    const others = unitsOf(nodes, building.id).filter((unit) => unit.id !== except);
+    const leaving = new Map();
+    const members = [];
+    for (const zoneId of new Set(zoneIds)) {
+        const zone = nodes[zoneId];
+        if (!zone)
+            refuse('zone_not_found', `Zone not found: ${zoneId}.`, { zoneId });
+        if (zone.type !== 'zone')
+            refuse('zone_not_found', `Node ${zoneId} is a ${zone.type}, not a zone.`, {
+                zoneId,
+                type: zone.type,
+            });
+        if (!zone.parentId || !levelIds.has(zone.parentId))
+            refuse('zone_outside_building', `Zone ${zoneId} (${zone.name}) is not on a level of building ${building.id}.`, { zoneId, buildingId: building.id });
+        const holder = others.find((unit) => unit.members.includes(zone.id));
+        if (holder) {
+            if (!move)
+                refuse('zone_in_other_unit', `Zone ${zoneId} (${zone.name}) is already in unit ${holder.id} (${holder.name}). Pass move: true to move it.`, { zoneId, unitId: holder.id, unitName: holder.name });
+            leaving.set(holder.id, (leaving.get(holder.id) ?? new Set()).add(zone.id));
+        }
+        members.push(zone.id);
+    }
+    const released = [...leaving].map(([unitId, zones]) => ({
+        id: unitId,
+        data: { members: nodes[unitId].members.filter((id) => !zones.has(id)) },
+    }));
+    const moved = [...leaving.values()].reduce((n, zones) => n + zones.size, 0);
+    return { members, released, moved };
+}
+const describe = (unit) => ({
+    unitId: unit.id,
+    name: unit.name,
+    kind: unit.kind,
+    color: unit.color,
+    members: unit.members,
+});
+/** `create_unit`: a unit under its building, holding the zones named. */
+export const createUnit = (nodes, input, context) => {
+    const building = targetBuilding(nodes, input.buildingId, context);
+    const { members, released, moved } = memberZones(nodes, building, input.memberZoneIds ?? [], null, input.move);
+    const unit = UnitNode.parse({
+        parentId: building.id,
+        name: input.name,
+        ...(input.kind ? { kind: input.kind } : {}),
+        ...(input.color ? { color: input.color } : {}),
+        members,
+    });
+    return {
+        result: {
+            ...describe(unit),
+            buildingId: building.id,
+            memberCount: members.length,
+            message: `Made ${unit.kind} "${unit.name}" in ${building.name ?? building.id} with ${members.length} room${members.length === 1 ? '' : 's'}${moved ? `, ${moved} moved from ${released.length === 1 ? 'another unit' : 'other units'}` : ''}.`,
+        },
+        changes: {
+            create: [{ node: unit, parentId: building.id }],
+            ...(released.length ? { update: released } : {}),
+        },
+    };
+};
+/** `set_unit_members`: the unit's rooms from now on. */
+export const setUnitMembers = (nodes, input) => {
+    const unit = nodes[input.unitId];
+    if (!unit)
+        refuse('unit_not_found', `Unit not found: ${input.unitId}.`, { unitId: input.unitId });
+    if (unit.type !== 'unit')
+        refuse('unit_not_found', `Node ${input.unitId} is a ${unit.type}, not a unit.`, {
+            unitId: input.unitId,
+            type: unit.type,
+        });
+    const building = unit.parentId ? nodes[unit.parentId] : undefined;
+    if (building?.type !== 'building')
+        refuse('building_not_found', `Unit ${unit.id} is in no building.`, { unitId: unit.id });
+    const { members, released, moved } = memberZones(nodes, building, input.memberZoneIds, unit.id, input.move);
+    const next = { ...unit, members };
+    return {
+        result: {
+            ...describe(next),
+            buildingId: building.id,
+            memberCount: members.length,
+            message: `"${unit.name}" now holds ${members.length} room${members.length === 1 ? '' : 's'}${moved ? `, ${moved} moved from ${released.length === 1 ? 'another unit' : 'other units'}` : ''}.`,
+        },
+        changes: { update: [{ id: unit.id, data: { members } }, ...released] },
+    };
+};
+/** `list_units`: every unit of a building, or of the scene, with its report. */
+export const listUnits = (nodes, input, context) => {
+    const building = input.buildingId ? targetBuilding(nodes, input.buildingId, context) : null;
+    const units = queryNodes(nodes, { type: 'unit' }).filter((unit) => !building || unit.parentId === building.id);
+    return {
+        result: {
+            units: units.map((unit) => ({ ...describe(unit), report: buildUnitReport(unit, nodes) })),
+        },
+    };
+};

package/dist/agent-operations/unreachable-rooms-check.d.ts

@@ -0,0 +1,17 @@
+import type { SceneNodes } from './types.js';
+export type RoomUnreachableIssue = {
+    type: 'room_unreachable';
+    message: string;
+    severity: 'warning';
+    nodeIds: string[];
+    levelIds: string[];
+    spaceId?: string;
+};
+/**
+ * A room no walk from outside reaches through the doors, openings, open edges, stairs and lifts the
+ * scene models. A level no entrance reaches is one fact about the level, said by the storey checks;
+ * a room whose route crosses geometry the reading cannot measure is not named (its access is unknown,
+ * not missing).
+ */
+export declare function unreachableRoomIssues(nodes: SceneNodes): RoomUnreachableIssue[];
+//# sourceMappingURL=unreachable-rooms-check.d.ts.map

package/dist/agent-operations/unreachable-rooms-check.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"unreachable-rooms-check.d.ts","sourceRoot":"","sources":["../../src/agent-operations/unreachable-rooms-check.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,SAAS,CAAA;AAGzC,MAAM,MAAM,oBAAoB,GAAG;IACjC,IAAI,EAAE,kBAAkB,CAAA;IACxB,OAAO,EAAE,MAAM,CAAA;IACf,QAAQ,EAAE,SAAS,CAAA;IACnB,OAAO,EAAE,MAAM,EAAE,CAAA;IACjB,QAAQ,EAAE,MAAM,EAAE,CAAA;IAClB,OAAO,CAAC,EAAE,MAAM,CAAA;CACjB,CAAA;AAED;;;;;GAKG;AACH,wBAAgB,qBAAqB,CAAC,KAAK,EAAE,UAAU,GAAG,oBAAoB,EAAE,CAe/E"}

package/dist/agent-operations/unreachable-rooms-check.js

@@ -0,0 +1,35 @@
+import { circulationDiagnostics } from './reachability.js';
+import { registerSceneCheck } from './verify-scene.js';
+/**
+ * A room no walk from outside reaches through the doors, openings, open edges, stairs and lifts the
+ * scene models. A level no entrance reaches is one fact about the level, said by the storey checks;
+ * a room whose route crosses geometry the reading cannot measure is not named (its access is unknown,
+ * not missing).
+ */
+export function unreachableRoomIssues(nodes) {
+    return circulationDiagnostics(nodes).flatMap((reading) => reading.type === 'room_unreachable'
+        ? [
+            {
+                type: 'room_unreachable',
+                message: reading.message,
+                severity: 'warning',
+                nodeIds: reading.nodeIds,
+                levelIds: reading.levelIds ?? [],
+                ...(reading.spaceId ? { spaceId: reading.spaceId } : {}),
+            },
+        ]
+        : []);
+}
+registerSceneCheck({
+    name: 'unreachable rooms',
+    order: 80,
+    run: (nodes) => {
+        try {
+            return unreachableRoomIssues(nodes);
+        }
+        catch {
+            // A scene the circulation graph cannot walk is the schema check's to report.
+            return [];
+        }
+    },
+});

package/dist/agent-operations/usage-checks.d.ts

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=usage-checks.d.ts.map

package/dist/agent-operations/usage-checks.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"usage-checks.d.ts","sourceRoot":"","sources":["../../src/agent-operations/usage-checks.ts"],"names":[],"mappings":""}

package/dist/agent-operations/usage-checks.js

@@ -0,0 +1,12 @@
+import { usageIssues } from '../spatial/usage-field/findings.js';
+import { sdfChecksOn } from '../spatial/usage-field/flag.js';
+import { registerSceneCheck } from './verify-scene.js';
+/**
+ * Passages, turning circles, pockets and wall objects, measured on the real shapes of the scene
+ * (`spatial/usage-field`). Off unless a host turns usage checks on; off, it adds nothing.
+ */
+registerSceneCheck({
+    name: 'usage',
+    order: 60,
+    run: (nodes) => (sdfChecksOn() ? usageIssues(nodes) : []),
+});

package/dist/agent-operations/verify-scene.d.ts

@@ -1,13 +1,17 @@
 import { type OpenWallEnd } from '../lib/room-graph.js';
+import type { UsageIssue } from '../spatial/usage-field/findings.js';
 import { type CeilingObjectObservation } from './ceiling-object-observations.js';
+import type { RoomCheckIssue } from './room-checks.js';
 import { type RoomFinding } from './room-findings.js';
-import type { AgentOperation, SceneNodes } from './types.js';
+import type { AgentContext, AgentOperation, SceneNodes } from './types.js';
+import type { RoomUnreachableIssue } from './unreachable-rooms-check.js';
+import { type WallEndShortIssue, type WallNearlyAlignedIssue } from './wall-joins.js';
 import { type WallObjectObservation } from './wall-object-observations.js';
 /** A problem verify_scene found, typed so it can be counted and acted on. */
 export type SceneIssue = CeilingObjectObservation | WallObjectObservation | RoomFinding | {
     type: string;
     message: string;
-    severity?: 'info';
+    severity?: 'info' | 'warning';
 } | {
     type: 'schema_invalid';
     message: string;
@@ -47,7 +51,7 @@ export type SceneIssue = CeilingObjectObservation | WallObjectObservation | Room
     reason: Exclude<OpenWallEnd['reason'], 'isolated'>;
     gap?: number;
     nearestWallId?: string;
-};
+} | WallEndShortIssue | WallNearlyAlignedIssue | UsageIssue | RoomCheckIssue | RoomUnreachableIssue;
 /** What verify_scene was asked: its contract's input, which other modules may extend. */
 export type VerifySceneInput = Readonly<Record<string, unknown>>;
 /**
@@ -58,7 +62,7 @@ export type VerifySceneInput = Readonly<Record<string, unknown>>;
 export type SceneCheck = {
     name: string;
     order: number;
-    run: (nodes: SceneNodes, input: VerifySceneInput) => SceneIssue[];
+    run: (nodes: SceneNodes, input: VerifySceneInput, context: AgentContext) => SceneIssue[];
 };
 export declare const CHECKPOINT_ORDER = 100;
 /**
@@ -73,12 +77,5 @@ export type SceneReport = {
 export declare function registerSceneReport(report: SceneReport): void;
 /** Runs a check in every verify_scene from now on; registering a check again replaces it. */
 export declare function registerSceneCheck(check: SceneCheck): void;
-/**
- * `verify_scene`: a self-check after complex edits. Per-level content, roles and enclosed spaces,
- * then every practical problem found, typed: spaces with no room, rooms the walls do not close or
- * with no name, rooms missing floors or ceilings, roof levels misused, storeys with no stair,
- * openings off their wall, stairs off their slab, blocked doors, overlapping furniture, and every
- * field a node's schema rejects, by node and path; a kind no schema here knows, once per kind.
- */
 export declare const verifyScene: AgentOperation<VerifySceneInput | undefined>;
 //# sourceMappingURL=verify-scene.d.ts.map

package/dist/agent-operations/verify-scene.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"verify-scene.d.ts","sourceRoot":"","sources":["../../src/agent-operations/verify-scene.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"verify-scene.d.ts","sourceRoot":"","sources":["../../src/agent-operations/verify-scene.ts"],"names":[],"mappings":"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"}

package/dist/agent-operations/verify-scene.js

@@ -1,19 +1,20 @@
 import { levelBuildingId } from '../building/level-duplication.js';
 import { levelGradeStanding } from '../lib/grade-standing.js';
 import { groundSeat } from '../lib/ground-seat.js';
+import { hierarchyCycleErrors } from '../lib/hierarchy.js';
 import { getLevelDisplayName } from '../lib/level-name.js';
 import { HIDDEN_SITE_NOTE } from '../lib/node-visibility.js';
 import { wallSupportForNodes } from '../lib/opening-floor-datum.js';
 import { detectOpenWallEnds } from '../lib/room-graph.js';
 import { siteBrief } from '../lib/site-placement.js';
 import { nodeRegistry } from '../registry/index.js';
-import { AnyNode as AnyNodeSchema } from '../schema/index.js';
+import { AnyNode as AnyNodeSchema, } from '../schema/index.js';
 import { nodeSchemaForKind } from '../schema/compiled-node-parsers.js';
 import { isCeilingGeometry } from '../services/roof-level.js';
 import { isRoofOnStoreyWalls } from '../services/roof-move.js';
 import { getStoredLevelHeight, getWallCoveringSlabs, getWallTop } from '../services/storey.js';
 import { getStoreyDatum } from '../services/storey-datum.js';
-import { computeSegmentTransforms, rotateXZ } from '../systems/stair/stair-footprint.js';
+import { computeSegmentTransforms, rotateXZ, stairArrivalOpening, } from '../systems/stair/stair-footprint.js';
 import { resolveStairTotalRise, stairClimbsToNoStorey, stairReachesStoreyAbove, } from '../systems/stair/stair-rise-query.js';
 import { measureStair } from '../systems/stair/stair-sizing.js';
 import { checkOpeningWithinWall, formatOpeningBoundsIssue } from '../validation/opening-bounds.js';
@@ -22,10 +23,14 @@ import { layoutIssuesFromScene } from './layout-clearance.js';
 import { wallResolvedHeight } from './level-reads.js';
 import { pointInPolygon, polygonContainsPolygon } from './plan-geometry.js';
 import { roomFindings } from './room-findings.js';
+import { roomIssueScope } from './room-readings.js';
+import { withoutDuplicatePockets } from './scene-check-policy.js';
 import { EMPTY_SESSION } from './scene-checkpoint.js';
+import { sceneIssueGroups } from './scene-issue-groups.js';
 import { changesSince } from './scene-measure.js';
-import { contentCounts, levelIdOf, levelRole, levelsOf, nodesOnLevel, } from './scene-queries.js';
+import { contentCounts, levelIdOf, levelRole, levelsOf, nodesOnLevel, queryNodes, } from './scene-queries.js';
 import { reviewSince } from './scene-review.js';
+import { wallBodies, wallEndShortIssues, wallNearlyAlignedIssues, } from './wall-joins.js';
 import { wallObjectObservations } from './wall-object-observations.js';
 export const CHECKPOINT_ORDER = 100;
 const checks = [];
@@ -163,7 +168,7 @@ function withDefaults(node, parsed) {
  * kind's, else core's. The checks that measure read each node with its defaults filled. A node its schema
  * rejects is listed field by field and left `unread`: they could not read it. A node of a kind no
  * schema here knows (a plugin's, where the plugin is not loaded) is counted by kind and kept as
- * stored: the checks never read it.
+ * stored: the checks never read it. Each node on a parent cycle is listed by its `parentId`.
  */
 function checkSchemas(scene, hostSchema) {
     const errors = [];
@@ -189,6 +194,7 @@ function checkSchemas(scene, hostSchema) {
             errors.push({ nodeId: id, path: issue.path.join('.'), message: issue.message });
         unread.add(id);
     }
+    errors.push(...hierarchyCycleErrors(scene));
     return { errors, unknownKinds, unread, measured };
 }
 /**
@@ -198,6 +204,8 @@ function checkSchemas(scene, hostSchema) {
  * openings off their wall, stairs off their slab, blocked doors, overlapping furniture, and every
  * field a node's schema rejects, by node and path; a kind no schema here knows, once per kind.
  */
+/** A flight of this many risers or fewer is a step up to a door, not a staircase: no going or comfort target applies. */
+const SHORT_FLIGHT_STEPS = 3;
 export const verifyScene = (scene, input, context) => {
     const { errors, unknownKinds, unread, measured: nodes } = checkSchemas(scene, context.nodeSchema);
     const onLevel = (levelId) => nodesOnLevel(nodes, levelId);
@@ -217,7 +225,9 @@ export const verifyScene = (scene, input, context) => {
     // What the checks across levels read: the scene without the levels that wait.
     const settled = unreadOn.size === 0
         ? nodes
-        : Object.fromEntries(Object.entries(nodes).filter(([id]) => !unreadOn.has(levelIdOf(scene, id) ?? '')));
+        : Object.fromEntries(
+        // biome-ignore lint/plugin: verify_scene reads the whole scene
+        Object.entries(nodes).filter(([id]) => !unreadOn.has(levelIdOf(scene, id) ?? '')));
     // A roof level holds the roof, no rooms.
     const rooms = new Map();
     const levels = levelsOf(nodes).map((level) => {
@@ -255,6 +265,8 @@ export const verifyScene = (scene, input, context) => {
         const { content, levelName } = level;
         if (level.unread)
             continue;
+        const bodies = wallBodies(onLevel(level.levelId).filter((node) => node.type === 'wall'));
+        issues.push(...wallEndShortIssues({ levelId: level.levelId, levelName, bodies }), ...wallNearlyAlignedIssues({ levelId: level.levelId, levelName, bodies }));
         // A free-standing wall (garden wall, half wall) is legitimate, not something to repair.
         for (const end of detectOpenWallEnds(nodes, level.levelId)) {
             if (end.reason === 'isolated')
@@ -290,7 +302,7 @@ export const verifyScene = (scene, input, context) => {
             report('basement_at_grade', `${levelName} is floor index ${level.floorIndex}, below the ground floor, but its floor stands at grade (${(getStoreyDatum(nodes, level.levelId)?.floorElevation ?? 0).toFixed(2)} m): its walls rise from the terrain instead of standing down in it. set_ground_level on the level that stands at grade (the floor over it) seats the building, and the levels under it read below grade.`, true);
         const seat = groundSeat(asNodes, buildingOf(level.levelId) ?? '');
         if (seat?.levelId === level.levelId && seat.explicit && !seat.seated)
-            report('ground_level_unseated', `${levelName} is the ground floor, but its floor datum stands ${seat.offset.toFixed(2)} m ${seat.offset > 0 ? 'over' : 'under'} grade (${seat.gradeElevation.toFixed(2)} m); a seated ground floor stands between grade and ${seat.aboveGrade} m (the top of the ${seat.foundation.construction.label} foundation) over it. set_ground_level on it seats the building.`, true);
+            report('ground_level_unseated', `${levelName} is the ground floor, but its floor datum stands ${seat.offset.toFixed(2)} m ${seat.offset > 0 ? 'over' : 'under'} grade (${seat.gradeElevation.toFixed(2)} m); a seated ground floor stands on it. set_ground_level on it seats the building.`, true);
         if (content.walls > 0 && content.zones === 0)
             report('walls_no_zones', `${levelName} has walls but no zones/rooms`);
         if (content.zones > 0 && content.slabs === 0)
@@ -309,7 +321,7 @@ export const verifyScene = (scene, input, context) => {
     for (const level of levels) {
         for (const wall of ofType(onLevel(level.levelId), 'wall')) {
             const base = wallSupportForNodes(wall, nodes).elevation;
-            const wallTop = getWallTop(wall, level.levelId, nodes, base);
+            const wallTop = Math.max(getWallTop(wall, level.levelId, nodes, base, 0), getWallTop(wall, level.levelId, nodes, base, 1));
             for (const { slab, top: slabTop, underside: slabUnderside } of getWallCoveringSlabs(wall, level.levelId, nodes)) {
                 const penetration = Math.max(0, Math.min(wallTop, slabTop) - Math.max(base, slabUnderside));
                 const coplanar = Math.abs(wallTop - slabTop) <= 1e-6;
@@ -388,8 +400,14 @@ export const verifyScene = (scene, input, context) => {
         if (sourceLevelId && holdingUnread.has(buildingOf(sourceLevelId) ?? ''))
             continue;
         const stairName = stair.name ?? stair.id;
-        for (const diagnostic of measureStair(stair, nodes).diagnostics)
+        const measured = measureStair(stair, nodes);
+        for (const diagnostic of measured.diagnostics) {
+            // the going and comfort rules are a staircase's: a step or two up to a door has none to miss
+            if (measured.riserCount <= SHORT_FLIGHT_STEPS &&
+                (diagnostic.code === 'comfort-target' || diagnostic.code === 'going-target'))
+                continue;
             report(`stair_${diagnostic.code.replaceAll('-', '_')}`, `Stair ${stairName}: ${diagnostic.message}`, diagnostic.code.endsWith('-target'));
+        }
         if (sourceLevelId) {
             const sourceName = nodes[sourceLevelId]?.name ?? sourceLevelId;
             const footprints = stairFootprintPolygons(nodes, stair);
@@ -403,6 +421,30 @@ export const verifyScene = (scene, input, context) => {
                 if (footprints.some((footprint) => wallSamplePoints(wall).some((point) => pointInPolygon(point, footprint, false))))
                     report('stair_obstructed', `Wall ${wall.name ?? wall.id} obstructs stair ${stairName} on ${sourceName}`);
         }
+        // Where it arrives: inside a room of the floor it climbs to, no wall across its top step or
+        // standing in the opening it cuts.
+        const arrival = stairArrivalOpening(stair, nodes);
+        for (const targetLevelId of targetLevelIdsForStair(nodes, stair)) {
+            if (targetLevelId === sourceLevelId || arrival.length === 0)
+                continue;
+            const targetName = nodes[targetLevelId]?.name ?? targetLevelId;
+            const target = onLevel(targetLevelId);
+            const zones = ofType(target, 'zone');
+            const centre = [
+                arrival.reduce((sum, [x]) => sum + x, 0) / arrival.length,
+                arrival.reduce((sum, [, z]) => sum + z, 0) / arrival.length,
+            ];
+            if (zones.length > 0 && !zones.some((zone) => pointInPolygon(centre, zone.polygon)))
+                report('stair_arrives_outside_room', `Stair ${stairName} arrives on ${targetName} outside every room: move it so its top step lands in a hall or a room`);
+            const opened = target.filter((node) => node.type === 'floor-opening' && node.source === 'stair' && node.ownerId === stair.id);
+            for (const wall of ofType(target, 'wall')) {
+                const points = wallSamplePoints(wall);
+                if (points.some((point) => pointInPolygon(point, arrival, false)))
+                    report('stair_arrival_blocked', `Wall ${wall.name ?? wall.id} on ${targetName} crosses the top of stair ${stairName}`);
+                else if (opened.some((opening) => points.some((point) => pointInPolygon(point, opening.polygon, false))))
+                    report('stair_opening_wall', `Wall ${wall.name ?? wall.id} on ${targetName} stands in the floor opening of stair ${stairName}`);
+            }
+        }
         if ((stair.slabOpeningMode ?? 'none') !== 'destination')
             continue;
         const targetLevelIds = targetLevelIdsForStair(nodes, stair);
@@ -439,9 +481,7 @@ export const verifyScene = (scene, input, context) => {
     }
     // Where each building stands on its lot: past the lot line or into the required yards is a
     // problem, off-centre is not.
-    for (const building of Object.values(nodes)) {
-        if (building.type !== 'building')
-            continue;
+    for (const building of queryNodes(nodes, { type: 'building' })) {
         const brief = siteBrief(nodes, { buildingId: building.id });
         if (!brief)
             continue;
@@ -488,7 +528,7 @@ export const verifyScene = (scene, input, context) => {
     issues.push(...wallObjectObservations(settled));
     for (const check of checks)
         if (check.order < CHECKPOINT_ORDER)
-            issues.push(...check.run(settled, input ?? {}));
+            issues.push(...check.run(settled, input ?? {}, context));
     // What the edits since the host's checkpoint lost, by place.
     const hosted = context.checkpoint
         ? changesSince(context.checkpoint, scene)
@@ -503,8 +543,10 @@ export const verifyScene = (scene, input, context) => {
         issues.push(...since.places.issues);
     for (const check of checks)
         if (check.order >= CHECKPOINT_ORDER)
-            issues.push(...check.run(settled, input ?? {}));
+            issues.push(...check.run(settled, input ?? {}, context));
     const occupiedStoryCount = levels.filter((level) => level.isOccupiedStory).length;
+    issues.splice(0, issues.length, ...withoutDuplicatePockets(issues));
+    const issueGroups = sceneIssueGroups(issues, nodes);
     return {
         result: {
             ok: true,
@@ -517,6 +559,9 @@ export const verifyScene = (scene, input, context) => {
             levels,
             emptyLevelIds: empty.map((level) => level.levelId),
             issues,
+            ...(typeof input?.room === 'string' && { roomScope: roomIssueScope(nodes, input.room) }),
+            issueGroups,
+            issueCount: issues.length,
             hasIssues: issues.some((issue) => !('severity' in issue && issue.severity === 'info')),
             ...authoredObjects(nodes),
             ...Object.assign({}, ...reports.map((report) => report.run(nodes))),
@@ -532,6 +577,7 @@ export const verifyScene = (scene, input, context) => {
 };
 /** Objects built by add_object, with what each stands in for: each is a gap in what Pascal builds. */
 function authoredObjects(nodes) {
+    // biome-ignore lint/plugin: verify_scene reads the whole scene
     const objects = Object.values(nodes)
         .flatMap((node) => node.type === 'item' && node.source
         ? [

package/dist/agent-operations/wall-face-defaults.d.ts

@@ -0,0 +1,44 @@
+import type { WallFace } from '../schema/index.js';
+import type { SceneNodes } from './types.js';
+/**
+ * Every visible wall face at the default finish, read from the walls themselves and not through a
+ * room: a stub that stands inside a room on no boundary, a partition side no zone looks at, an outside
+ * face, all show the viewer's fallback finish the same. A face is read where somebody wrote nothing for
+ * it: no slot, no legacy finish, no room finish over it, no paint region on the stretch, no finish
+ * script, and, on the exterior side, no assembly cladding. What is not visible is not read: the end
+ * of a wall that runs into another wall's body (a face inside a body of the same height or more) is
+ * no face. What is not modelled: a paint region that covers part of a face's height counts as covering
+ * its stretch, and a curved wall's buried ends are not cut.
+ */
+type Interval = [number, number];
+export type DefaultWallFace = {
+    wallId: string;
+    wallName: string;
+    levelId: string;
+    levelName: string;
+    face: WallFace;
+    /** Metres of the face at the default, visible stretches only. */
+    metres: number;
+    /** Metres along the wall's reference line, each stretch. */
+    stretches: Interval[];
+    /** Plan points (x, z) on the wall's reference line where the first stretch starts and the last ends. */
+    from: [number, number];
+    to: [number, number];
+    /** The rooms that stand on this face along its default stretches. */
+    facing: string[];
+    /** With none facing: the rooms the wall stands inside, on no boundary. */
+    standsIn: string[];
+};
+export type WallFaceReading = {
+    /** Visible wall faces read (a face with a visible stretch of `MIN_STRETCH_M` or more). */
+    faces: number;
+    metres: number;
+    defaults: DefaultWallFace[];
+};
+/**
+ * Every wall face of the scene read for the default finish. Walls that are hidden, curtain walls and
+ * walls on a roof level are left out; a scene whose walls cannot be walked reads as no faces.
+ */
+export declare function readWallFaces(nodes: SceneNodes): WallFaceReading;
+export {};
+//# sourceMappingURL=wall-face-defaults.d.ts.map

package/dist/agent-operations/wall-face-defaults.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"wall-face-defaults.d.ts","sourceRoot":"","sources":["../../src/agent-operations/wall-face-defaults.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,QAAQ,EAAsB,MAAM,WAAW,CAAA;AAoB7D,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,SAAS,CAAA;AAEzC;;;;;;;;;GASG;AAEH,KAAK,QAAQ,GAAG,CAAC,MAAM,EAAE,MAAM,CAAC,CAAA;AAWhC,MAAM,MAAM,eAAe,GAAG;IAC5B,MAAM,EAAE,MAAM,CAAA;IACd,QAAQ,EAAE,MAAM,CAAA;IAChB,OAAO,EAAE,MAAM,CAAA;IACf,SAAS,EAAE,MAAM,CAAA;IACjB,IAAI,EAAE,QAAQ,CAAA;IACd,iEAAiE;IACjE,MAAM,EAAE,MAAM,CAAA;IACd,4DAA4D;IAC5D,SAAS,EAAE,QAAQ,EAAE,CAAA;IACrB,wGAAwG;IACxG,IAAI,EAAE,CAAC,MAAM,EAAE,MAAM,CAAC,CAAA;IACtB,EAAE,EAAE,CAAC,MAAM,EAAE,MAAM,CAAC,CAAA;IACpB,qEAAqE;IACrE,MAAM,EAAE,MAAM,EAAE,CAAA;IAChB,0EAA0E;IAC1E,QAAQ,EAAE,MAAM,EAAE,CAAA;CACnB,CAAA;AAED,MAAM,MAAM,eAAe,GAAG;IAC5B,0FAA0F;IAC1F,KAAK,EAAE,MAAM,CAAA;IACb,MAAM,EAAE,MAAM,CAAA;IACd,QAAQ,EAAE,eAAe,EAAE,CAAA;CAC5B,CAAA;AAgID;;;GAGG;AACH,wBAAgB,aAAa,CAAC,KAAK,EAAE,UAAU,GAAG,eAAe,CA0EhE"}