@pascal-app/core 1.0.1 → 1.0.4

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

@@ -0,0 +1,73 @@
+import type { AnyNode } from '../schema/index.js';
+import type { SceneNodes } from './types.js';
+type Spot = {
+    x: number;
+    z: number;
+};
+/** Where one of a family stands: rooms by their centre and name. */
+export type MeasurePlace = Spot & {
+    name?: string;
+};
+/**
+ * A family the measure counts on each floor, by place: windows, lit rooms, decks with a door.
+ * The module that knows a family registers it (the facade checks register theirs), so the measure
+ * imports none of them.
+ */
+export type MeasureFamily = {
+    family: string;
+    /** One of them, in a message: "window", "room". */
+    noun: string;
+    /** What losing one means: "gone from their places", "no longer lit". */
+    lost: string;
+    /** Two places this close are the same. */
+    tolerance: number;
+    /** Where the family runs before or after others, in the result. */
+    order: number;
+    places: (nodes: Readonly<Record<string, AnyNode>>) => {
+        levelId: string;
+        place: MeasurePlace;
+    }[];
+};
+/** Counts a family in every measure from now on; registering a family again replaces it. */
+export declare function registerMeasureFamily(family: MeasureFamily): void;
+/** What a scene holds of the registered families, by floor and place; small, and plain JSON. */
+export type SceneMeasure = {
+    levels: Record<string, {
+        name: string;
+        families: Record<string, MeasurePlace[]>;
+    }>;
+};
+/** A measure kept under a name, before an edit, to compare the scene with after it. */
+export type SceneCheckpoint = {
+    name: string;
+    measure: SceneMeasure;
+};
+export type MeasureChange = {
+    levelId: string;
+    level: string;
+    family: string;
+    before: number;
+    after: number;
+    /** What the checkpoint had that is not there now, by place (rooms by name). */
+    gone: string[];
+    /** How many stand where the checkpoint had none. */
+    added: number;
+};
+export type LostSinceCheckpointIssue = {
+    type: 'lost_since_checkpoint';
+    message: string;
+};
+export declare function measureScene(nodes: SceneNodes): SceneMeasure;
+/**
+ * The scene now against a checkpoint: per floor and family, the count then and now, what is gone
+ * from its place and what is new. A family that lost more than it gained is an issue naming what is
+ * gone. On the Victor grid v1 cost 8 windows a floor and room mode 10–12, seen only by the MCP
+ * agent counting before and after (2026-10-03); a weaker model's edits lowered its own score 29.6%
+ * of the time (LEGO-Anything, 2026-09).
+ */
+export declare function changesSince(checkpoint: SceneCheckpoint, nodes: SceneNodes): {
+    changes: MeasureChange[];
+    issues: LostSinceCheckpointIssue[];
+};
+export {};
+//# sourceMappingURL=scene-measure.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"scene-measure.d.ts","sourceRoot":"","sources":["../../src/agent-operations/scene-measure.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,WAAW,CAAA;AACxC,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,SAAS,CAAA;AAEzC,KAAK,IAAI,GAAG;IAAE,CAAC,EAAE,MAAM,CAAC;IAAC,CAAC,EAAE,MAAM,CAAA;CAAE,CAAA;AACpC,oEAAoE;AACpE,MAAM,MAAM,YAAY,GAAG,IAAI,GAAG;IAAE,IAAI,CAAC,EAAE,MAAM,CAAA;CAAE,CAAA;AAEnD;;;;GAIG;AACH,MAAM,MAAM,aAAa,GAAG;IAC1B,MAAM,EAAE,MAAM,CAAA;IACd,mDAAmD;IACnD,IAAI,EAAE,MAAM,CAAA;IACZ,wEAAwE;IACxE,IAAI,EAAE,MAAM,CAAA;IACZ,0CAA0C;IAC1C,SAAS,EAAE,MAAM,CAAA;IACjB,mEAAmE;IACnE,KAAK,EAAE,MAAM,CAAA;IACb,MAAM,EAAE,CAAC,KAAK,EAAE,QAAQ,CAAC,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC,KAAK;QAAE,OAAO,EAAE,MAAM,CAAC;QAAC,KAAK,EAAE,YAAY,CAAA;KAAE,EAAE,CAAA;CACjG,CAAA;AAID,4FAA4F;AAC5F,wBAAgB,qBAAqB,CAAC,MAAM,EAAE,aAAa,QAK1D;AAED,gGAAgG;AAChG,MAAM,MAAM,YAAY,GAAG;IACzB,MAAM,EAAE,MAAM,CAAC,MAAM,EAAE;QAAE,IAAI,EAAE,MAAM,CAAC;QAAC,QAAQ,EAAE,MAAM,CAAC,MAAM,EAAE,YAAY,EAAE,CAAC,CAAA;KAAE,CAAC,CAAA;CACnF,CAAA;AAED,uFAAuF;AACvF,MAAM,MAAM,eAAe,GAAG;IAAE,IAAI,EAAE,MAAM,CAAC;IAAC,OAAO,EAAE,YAAY,CAAA;CAAE,CAAA;AAErE,MAAM,MAAM,aAAa,GAAG;IAC1B,OAAO,EAAE,MAAM,CAAA;IACf,KAAK,EAAE,MAAM,CAAA;IACb,MAAM,EAAE,MAAM,CAAA;IACd,MAAM,EAAE,MAAM,CAAA;IACd,KAAK,EAAE,MAAM,CAAA;IACb,+EAA+E;IAC/E,IAAI,EAAE,MAAM,EAAE,CAAA;IACd,oDAAoD;IACpD,KAAK,EAAE,MAAM,CAAA;CACd,CAAA;AAED,MAAM,MAAM,wBAAwB,GAAG;IAAE,IAAI,EAAE,uBAAuB,CAAC;IAAC,OAAO,EAAE,MAAM,CAAA;CAAE,CAAA;AAIzF,wBAAgB,YAAY,CAAC,KAAK,EAAE,UAAU,GAAG,YAAY,CAc5D;AAMD;;;;;;GAMG;AACH,wBAAgB,YAAY,CAC1B,UAAU,EAAE,eAAe,EAC3B,KAAK,EAAE,UAAU,GAChB;IAAE,OAAO,EAAE,aAAa,EAAE,CAAC;IAAC,MAAM,EAAE,wBAAwB,EAAE,CAAA;CAAE,CAqClE"}

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

@@ -0,0 +1,73 @@
+const families = [];
+/** Counts a family in every measure from now on; registering a family again replaces it. */
+export function registerMeasureFamily(family) {
+    const at = families.findIndex((known) => known.family === family.family);
+    if (at >= 0)
+        families[at] = family;
+    else
+        families.push(family);
+    families.sort((a, b) => a.order - b.order);
+}
+const round = (value) => Math.round(value * 100) / 100;
+export function measureScene(nodes) {
+    const all = nodes;
+    const levels = {};
+    for (const node of Object.values(all))
+        if (node.type === 'level')
+            levels[node.id] = { name: node.name ?? `level ${node.level}`, families: {} };
+    for (const { family, places } of families)
+        for (const { levelId, place } of places(all)) {
+            const level = levels[levelId];
+            if (!level)
+                continue;
+            level.families[family] ??= [];
+            level.families[family].push({ ...place, x: round(place.x), z: round(place.z) });
+        }
+    return { levels };
+}
+/** The places of `from` with none of `to` within `tolerance`. */
+const missing = (from, to, tolerance) => from.filter((a) => !to.some((b) => Math.hypot(a.x - b.x, a.z - b.z) < tolerance));
+/**
+ * The scene now against a checkpoint: per floor and family, the count then and now, what is gone
+ * from its place and what is new. A family that lost more than it gained is an issue naming what is
+ * gone. On the Victor grid v1 cost 8 windows a floor and room mode 10–12, seen only by the MCP
+ * agent counting before and after (2026-10-03); a weaker model's edits lowered its own score 29.6%
+ * of the time (LEGO-Anything, 2026-09).
+ */
+export function changesSince(checkpoint, nodes) {
+    const now = measureScene(nodes).levels;
+    const then = checkpoint.measure.levels;
+    const changes = [];
+    const issues = [];
+    for (const levelId of new Set([...Object.keys(then), ...Object.keys(now)])) {
+        const before = then[levelId];
+        const after = now[levelId];
+        const level = after?.name ?? before?.name ?? levelId;
+        for (const { family, tolerance, noun, lost } of families) {
+            const was = before?.families[family] ?? [];
+            const is = after?.families[family] ?? [];
+            const gone = missing(was, is, tolerance);
+            const added = missing(is, was, tolerance).length;
+            if (!gone.length && !added)
+                continue;
+            const named = gone.map((s) => typeof s.name === 'string' ? s.name : `${noun} at (${s.x}, ${s.z})`);
+            changes.push({
+                levelId,
+                level,
+                family,
+                before: was.length,
+                after: is.length,
+                gone: named,
+                added,
+            });
+            if (is.length >= was.length)
+                continue;
+            const list = named.slice(0, 8).join('; ') + (named.length > 8 ? `; and ${named.length - 8} more` : '');
+            issues.push({
+                type: 'lost_since_checkpoint',
+                message: `${level} has ${is.length} ${family}, ${was.length} at checkpoint "${checkpoint.name}": ${lost}, ${list}${added ? `; ${added} stand in new places` : ''}. If the edit was not meant to lose them, restore the checkpoint or put them back.`,
+            });
+        }
+    }
+    return { changes, issues };
+}