Eval Engine

The eval engine exists to help agents plan quickly. It must be deterministic, structured, incremental, and cheap for common edits.

Tiers

Tier 0: Parse, schema, type, ID, unit checks.
Tier 1: Graph, parcel topology, terrain topology, and building topology checks.
Tier 2: Lightweight geometry, terrain, envelope, and floorplate checks.
Tier 3: Site, zoning, planning, and architectural rule checks.
Tier 4: Cost, energy, daylight, egress, grading, cut/fill, and other domain modules.
Tier 5: Backend-specific validation.

Finding Shape

interface EvalFinding {
  rule: RuleId;
  targetId?: EntityId;
  targetPath: GraphPath;
  groupPath?: GraphPath;
  severity: "hard" | "soft" | "info";
  message?: string;
  actual?: unknown;
  required?: unknown;
  unit?: string;
  repairHints?: RepairHint[];
}

Core Categories

• Parcel boundary closure and self-intersection.
• Parcel topology and neighboring parcel consistency.
• Survey geometry validity.
• Terrain surface validity.
• Slope threshold checks.
• Drainage path and access feasibility checks.
• Setback, height, lot coverage, FAR / FSI, daylight plane, and buildable envelope checks.
• Building footprint inside buildable envelope.
• Floorplate efficiency.
• Core placement.
• Unit mix and program fit.
• Circulation ratio.
• Egress routes.
• Structural grid sanity.
• Service shaft continuity.
• Space planning.
• Metadata completeness.
• Backend compatibility.