@rubytech/create-maxy-lite 0.1.0

package/payload/schema/SCHEMA.md

@@ -0,0 +1,404 @@
+# maxy-lite SCHEMA
+
+The machine-readable declaration of the maxy-lite file-native ontology. The model and its sources are fixed in [`../../../.docs/maxy-lite-ontology.md`](../../../.docs/maxy-lite-ontology.md); this file is the field-by-field derivation that both the assistant and the validator read. It is the single source of truth — the validator parses the tables below directly, so there is no second copy to drift from.
+
+Each entity is one file: YAML frontmatter (the typed fields declared here) plus a markdown body (free prose — note body, email text, call notes, meeting notes live in the body, not in frontmatter).
+
+## How the validator reads this
+
+- **Field types** are `text`, `number`, `date`, `checkbox`, `area`, `link`, `list`. A `date` is an ISO date (`YYYY-MM-DD`) or date-time. An `area` must be one of the Areas below. A `link` is a single reference (`"[[Target]]"` or a bare basename). A `list` is a YAML list; if its field name appears in **Associations**, every item must be a link.
+- **`type`** selects the entity. A file whose `type` is not declared here fails with `type:unknown`; a file with no `type` fails with `type:missing`.
+- **Required** fields are marked ✓. A missing required field fails with `field:missing`. A present field whose value does not match its type fails with `field:type` (or `field:area` for a bad area).
+- **Associations** are fields whose name appears in the Associations table. Each link is resolved by basename against every file in the vault. A link that resolves to no file fails with `field:dangling`; a link whose target file is the wrong entity type fails with `field:target`. A target of `any` constrains nothing but still fails on a dangling link. Resolution is by basename (the filename, as Obsidian wikilinks resolve); if two files in different folders share a basename the validator cannot distinguish them, so keep entity filenames unique.
+
+## Areas
+
+The controlled vocabulary of life-areas. Every document, asset, and project must declare an `area`; contacts, events, and activities may. An `area` outside this set fails.
+
+| Area | Covers |
+|---|---|
+| home | residence, household, utilities, repairs |
+| work | employment, career, work contacts |
+| finance | money, banking, bookkeeping, tax |
+| health | medical records, providers, prescriptions |
+| vehicle | cars and other vehicles |
+| insurance | policies across all areas |
+| travel | trips and holidays |
+| education | school, courses, qualifications |
+| family | family members, children, pets |
+| legal | contracts, agreements, official documents |
+| personal | identity documents, personal admin |
+
+## Contacts
+
+### Person (`person`)
+
+vCard (RFC 6350). Lives in `people/`.
+
+| Field | Type | Required | Source |
+|---|---|---|---|
+| type | text | ✓ | discriminator (`person`) |
+| name | text | ✓ | vCard `FN` |
+| firstName | text | | vCard `N` (given) |
+| lastName | text | | vCard `N` (family) |
+| nickname | text | | vCard `NICKNAME` |
+| emails | list | | vCard `EMAIL` |
+| tels | list | | vCard `TEL` |
+| org | link | | vCard `ORG` (association `worksAt`) |
+| title | text | | vCard `TITLE` |
+| role | text | | vCard `ROLE` |
+| address | text | | vCard `ADR` |
+| birthday | date | | vCard `BDAY` |
+| anniversary | date | | vCard `ANNIVERSARY` |
+| urls | list | | vCard `URL` |
+| categories | list | | vCard `CATEGORIES` |
+| area | area | | association `filedUnder` |
+
+### Organization (`organization`)
+
+HubSpot Company object. Lives in `organizations/`.
+
+| Field | Type | Required | Source |
+|---|---|---|---|
+| type | text | ✓ | discriminator (`organization`) |
+| name | text | ✓ | HubSpot `name` |
+| domain | text | | HubSpot `domain` |
+| website | text | | HubSpot `website` |
+| industry | text | | HubSpot `industry` |
+| companyType | text | | HubSpot `type` |
+| employees | number | | HubSpot `numberofemployees` |
+| revenue | number | | HubSpot `annualrevenue` |
+| phone | text | | HubSpot `phone` |
+| city | text | | HubSpot `city` |
+| state | text | | HubSpot `state` |
+| country | text | | HubSpot `country` |
+| members | list | | HubSpot Contact→Company assoc (`employs`) |
+| area | area | | association `filedUnder` |
+
+## Time
+
+### Event (`event`)
+
+iCalendar VEVENT (RFC 5545). Lives in `calendar/`.
+
+| Field | Type | Required | Source |
+|---|---|---|---|
+| type | text | ✓ | discriminator (`event`) |
+| summary | text | ✓ | iCal `SUMMARY` |
+| start | date | ✓ | iCal `DTSTART` |
+| end | date | | iCal `DTEND` |
+| location | text | | iCal `LOCATION` |
+| description | text | | iCal `DESCRIPTION` |
+| attendees | list | | iCal `ATTENDEE` (association `attends`) |
+| organizer | link | | iCal `ORGANIZER` (association `organizes`) |
+| recurrence | text | | iCal `RRULE` |
+| status | text | | iCal `STATUS` |
+| categories | list | | iCal `CATEGORIES` |
+| url | text | | iCal `URL` |
+| project | link | | association to `project` |
+| area | area | | association `filedUnder` |
+
+## Activities
+
+HubSpot engagements. All live in `activities/`; `type` discriminates. Long-form content is the markdown body.
+
+### Task (`task`)
+
+| Field | Type | Required | Source |
+|---|---|---|---|
+| type | text | ✓ | discriminator (`task`) |
+| title | text | ✓ | HubSpot `hs_task_subject` |
+| due | date | | HubSpot `hs_timestamp` |
+| priority | text | | HubSpot `hs_task_priority` |
+| status | text | | HubSpot `hs_task_status` |
+| taskType | text | | HubSpot `hs_task_type` |
+| assignee | link | | HubSpot `hubspot_owner_id` (association `assignedTo`) |
+| about | link | | engagement association |
+| project | link | | association to `project` |
+| area | area | | association `filedUnder` |
+
+### Note (`note`)
+
+| Field | Type | Required | Source |
+|---|---|---|---|
+| type | text | ✓ | discriminator (`note`) |
+| title | text | ✓ | label (body is HubSpot `hs_note_body`) |
+| about | link | | engagement association |
+| project | link | | association to `project` |
+| area | area | | association `filedUnder` |
+
+### Email (`email`)
+
+| Field | Type | Required | Source |
+|---|---|---|---|
+| type | text | ✓ | discriminator (`email`) |
+| subject | text | ✓ | HubSpot `hs_email_subject` |
+| timestamp | date | | HubSpot `hs_timestamp` |
+| direction | text | | HubSpot `hs_email_direction` |
+| participants | list | | engagement→Contact assoc (`participates`) |
+| about | link | | engagement association |
+| area | area | | association `filedUnder` |
+
+### Call (`call`)
+
+| Field | Type | Required | Source |
+|---|---|---|---|
+| type | text | ✓ | discriminator (`call`) |
+| subject | text | ✓ | HubSpot `hs_call_title` |
+| timestamp | date | | HubSpot `hs_timestamp` |
+| duration | number | | HubSpot `hs_call_duration` |
+| direction | text | | HubSpot `hs_call_direction` |
+| disposition | text | | HubSpot `hs_call_disposition` |
+| participants | list | | engagement→Contact assoc (`participates`) |
+| about | link | | engagement association |
+| area | area | | association `filedUnder` |
+
+### Meeting (`meeting`)
+
+| Field | Type | Required | Source |
+|---|---|---|---|
+| type | text | ✓ | discriminator (`meeting`) |
+| subject | text | ✓ | HubSpot `hs_meeting_title` |
+| start | date | | HubSpot `hs_meeting_start_time` |
+| end | date | | HubSpot `hs_meeting_end_time` |
+| location | text | | HubSpot `hs_meeting_location` |
+| participants | list | | engagement→Contact assoc (`participates`) |
+| about | link | | engagement association |
+| area | area | | association `filedUnder` |
+
+## Assets
+
+Things owned, that documents attach to. Filed under an area folder.
+
+### Property (`property`)
+
+| Field | Type | Required | Source |
+|---|---|---|---|
+| type | text | ✓ | discriminator (`property`) |
+| name | text | ✓ | label (e.g. "12 Oak Street") |
+| address | text | | — |
+| propertyType | text | | house / flat / land |
+| purchaseDate | date | | — |
+| value | number | | — |
+| ownedBy | link | | association `ownedBy` |
+| area | area | ✓ | association `filedUnder` |
+
+### Vehicle (`vehicle`)
+
+| Field | Type | Required | Source |
+|---|---|---|---|
+| type | text | ✓ | discriminator (`vehicle`) |
+| name | text | ✓ | label (e.g. "VW Golf") |
+| make | text | | — |
+| model | text | | — |
+| year | number | | — |
+| registration | text | | plate / VIN |
+| purchaseDate | date | | — |
+| value | number | | — |
+| ownedBy | link | | association `ownedBy` |
+| area | area | ✓ | association `filedUnder` |
+
+### Account (`account`)
+
+A financial account.
+
+| Field | Type | Required | Source |
+|---|---|---|---|
+| type | text | ✓ | discriminator (`account`) |
+| name | text | ✓ | label |
+| institution | link | | association to `organization` |
+| accountType | text | | checking / savings / credit / investment |
+| accountNumber | text | | — |
+| ownedBy | link | | association `ownedBy` |
+| area | area | ✓ | association `filedUnder` |
+
+## Financial records
+
+Bookkeeping family (QuickBooks / Xero / Wave).
+
+### Invoice (`invoice`)
+
+| Field | Type | Required | Source |
+|---|---|---|---|
+| type | text | ✓ | discriminator (`invoice`) |
+| number | text | ✓ | invoice number |
+| issueDate | date | ✓ | — |
+| dueDate | date | | — |
+| amount | number | ✓ | — |
+| currency | text | | — |
+| status | text | | paid / unpaid / overdue |
+| billedTo | link | | association `billedTo` |
+| about | link | | — |
+| area | area | ✓ | association `filedUnder` |
+
+### Expense (`expense`)
+
+A receipt — money spent.
+
+| Field | Type | Required | Source |
+|---|---|---|---|
+| type | text | ✓ | discriminator (`expense`) |
+| description | text | ✓ | — |
+| date | date | ✓ | — |
+| amount | number | ✓ | — |
+| currency | text | | — |
+| category | text | | — |
+| paidTo | link | | association `paidTo` |
+| paymentMethod | text | | — |
+| about | link | | — |
+| area | area | ✓ | association `filedUnder` |
+
+### Bill (`bill`)
+
+A bill owed.
+
+| Field | Type | Required | Source |
+|---|---|---|---|
+| type | text | ✓ | discriminator (`bill`) |
+| description | text | ✓ | — |
+| dueDate | date | ✓ | — |
+| amount | number | ✓ | — |
+| currency | text | | — |
+| status | text | | — |
+| issuedBy | link | | association `issuedBy` |
+| recurring | checkbox | | — |
+| area | area | ✓ | association `filedUnder` |
+
+### Statement (`statement`)
+
+A bank or credit statement.
+
+| Field | Type | Required | Source |
+|---|---|---|---|
+| type | text | ✓ | discriminator (`statement`) |
+| period | text | ✓ | e.g. 2026-05 |
+| date | date | | — |
+| account | link | | association to `account` |
+| issuedBy | link | | association `issuedBy` |
+| balance | number | | — |
+| area | area | ✓ | association `filedUnder` |
+
+### Payment (`payment`)
+
+| Field | Type | Required | Source |
+|---|---|---|---|
+| type | text | ✓ | discriminator (`payment`) |
+| date | date | ✓ | — |
+| amount | number | ✓ | — |
+| currency | text | | — |
+| paidTo | link | | association `paidTo` |
+| method | text | | — |
+| about | link | | the invoice or bill it settles |
+| area | area | ✓ | association `filedUnder` |
+
+## Life documents
+
+Life-admin filing cabinet.
+
+### Policy (`policy`)
+
+Insurance policy.
+
+| Field | Type | Required | Source |
+|---|---|---|---|
+| type | text | ✓ | discriminator (`policy`) |
+| name | text | ✓ | — |
+| policyNumber | text | | — |
+| insurer | link | | association to `organization` |
+| covers | link | | association `covers` |
+| premium | number | | — |
+| startDate | date | | — |
+| endDate | date | | — |
+| area | area | ✓ | association `filedUnder` |
+
+### Contract (`contract`)
+
+| Field | Type | Required | Source |
+|---|---|---|---|
+| type | text | ✓ | discriminator (`contract`) |
+| name | text | ✓ | — |
+| parties | list | | association `parties` |
+| startDate | date | | — |
+| endDate | date | | — |
+| value | number | | — |
+| about | link | | — |
+| area | area | ✓ | association `filedUnder` |
+
+### Warranty (`warranty`)
+
+| Field | Type | Required | Source |
+|---|---|---|---|
+| type | text | ✓ | discriminator (`warranty`) |
+| name | text | ✓ | — |
+| covers | link | | association `covers` |
+| provider | link | | association to `organization` |
+| startDate | date | | — |
+| endDate | date | | — |
+| area | area | ✓ | association `filedUnder` |
+
+### TaxDocument (`taxDocument`)
+
+| Field | Type | Required | Source |
+|---|---|---|---|
+| type | text | ✓ | discriminator (`taxDocument`) |
+| name | text | ✓ | — |
+| taxYear | text | ✓ | — |
+| documentType | text | | return / W2 / 1099 / P60 |
+| issuedBy | link | | association `issuedBy` |
+| area | area | ✓ | association `filedUnder` |
+
+### IdentityDocument (`identityDocument`)
+
+| Field | Type | Required | Source |
+|---|---|---|---|
+| type | text | ✓ | discriminator (`identityDocument`) |
+| name | text | ✓ | — |
+| documentType | text | ✓ | passport / license / certificate |
+| number | text | | — |
+| issuedBy | link | | association `issuedBy` |
+| issueDate | date | | — |
+| expiryDate | date | | — |
+| holder | link | | association `holder` |
+| area | area | ✓ | association `filedUnder` |
+
+## Projects
+
+### Project (`project`)
+
+A multi-step effort (a holiday, a house move, a renovation) that ties together tasks, events, and documents. PARA's "Projects".
+
+| Field | Type | Required | Source |
+|---|---|---|---|
+| type | text | ✓ | discriminator (`project`) |
+| name | text | ✓ | — |
+| status | text | | active / done / someday |
+| startDate | date | | — |
+| dueDate | date | | — |
+| about | link | | — |
+| area | area | ✓ | association `filedUnder` |
+
+## Associations
+
+A field whose name appears here is a typed link. `link`-typed fields are single; `list`-typed fields are many. The target is an entity type, a `|`-separated union, or `any`.
+
+| Field | Target | Cardinality | Notes |
+|---|---|---|---|
+| org | organization | one | Person worksAt Organization |
+| members | person | many | Organization employs Person |
+| attendees | person | many | Event attends Person |
+| organizer | person | one | Event organized by Person |
+| assignee | person | one | Task assignedTo Person |
+| about | any | one | Activity/record about any object |
+| project | project | one | item belongs to a Project |
+| participants | person | many | communication participants |
+| ownedBy | person | one | Asset owned by Person |
+| institution | organization | one | Account at an Organization |
+| billedTo | organization\|person | one | Invoice billed to a customer |
+| paidTo | organization\|person | one | Expense/Payment paid to a counterparty |
+| issuedBy | organization | one | document issued by an Organization |
+| account | account | one | Statement for an Account |
+| insurer | organization | one | Policy underwritten by an Organization |
+| covers | any | one | Policy/Warranty covers an Asset/Person |
+| provider | organization | one | Warranty provided by an Organization |
+| parties | organization\|person | many | Contract parties |
+| holder | person | one | IdentityDocument held by a Person |

package/payload/validator/cli.mjs

@@ -0,0 +1,56 @@
+#!/usr/bin/env node
+// Deterministic CLI gate for a maxy-lite vault.
+//
+//   maxy-lite-validate <vault> [--schema <path>]
+//
+// Emits one `[lite-schema] op=validate ...` line per file and a final
+// `[lite-schema] op=summary ...` line, then exits 0 when every file conforms and
+// 1 when any file violates the schema.
+
+import { fileURLToPath } from 'node:url';
+import { dirname, resolve, join } from 'node:path';
+import { loadSchema } from './schema.mjs';
+import { validateVault } from './validate.mjs';
+
+const HERE = dirname(fileURLToPath(import.meta.url));
+const DEFAULT_SCHEMA = resolve(HERE, '..', 'schema', 'SCHEMA.md');
+
+function parseArgs(argv) {
+  let vault = null;
+  let schema = DEFAULT_SCHEMA;
+  for (let i = 0; i < argv.length; i += 1) {
+    const arg = argv[i];
+    if (arg === '--schema') { schema = argv[i += 1]; }
+    else if (arg.startsWith('--schema=')) { schema = arg.slice('--schema='.length); }
+    else if (!vault) { vault = arg; }
+  }
+  return { vault, schema };
+}
+
+export function run(argv) {
+  const { vault, schema: schemaPath } = parseArgs(argv);
+  if (!vault) {
+    process.stderr.write('usage: maxy-lite-validate <vault> [--schema <path>]\n');
+    return 2;
+  }
+
+  const schema = loadSchema(schemaPath);
+  const { results, summary } = validateVault(resolve(vault), schema);
+
+  for (const r of results) {
+    process.stdout.write(
+      `[lite-schema] op=validate file=${r.file} entity=${r.entity} ok=${r.ok} errors=[${r.errors.join(',')}]\n`,
+    );
+  }
+  process.stdout.write(
+    `[lite-schema] op=summary files=${summary.files} valid=${summary.valid} invalid=${summary.invalid}\n`,
+  );
+
+  return summary.invalid > 0 ? 1 : 0;
+}
+
+const invokedDirectly = process.argv[1]
+  && resolve(process.argv[1]) === resolve(fileURLToPath(import.meta.url));
+if (invokedDirectly) {
+  process.exit(run(process.argv.slice(2)));
+}

package/payload/validator/frontmatter.mjs

@@ -0,0 +1,37 @@
+// Extract and parse the YAML frontmatter block from a markdown file's text.
+// Deterministic: no LLM. Returns { frontmatter, hasFrontmatter }.
+
+import yaml from 'js-yaml';
+
+// Opening `---` line, lazily-captured body, closing `---` line. The newline
+// before the closing fence is optional so an empty block (`---\n---`) parses.
+const FRONTMATTER_RE = /^?---[ \t]*\r?\n([\s\S]*?)\r?\n?---[ \t]*(?:\r?\n|$)/;
+
+/**
+ * Parse the leading `--- ... ---` YAML block of a markdown document.
+ *
+ * @param {string} text raw file contents
+ * @returns {{ hasFrontmatter: boolean, frontmatter: object, error: string|null }}
+ *   - hasFrontmatter: a frontmatter block was present
+ *   - frontmatter: the parsed mapping (empty object when absent or not a mapping)
+ *   - error: a parse-error message, or null
+ */
+export function parseFrontmatter(text) {
+  const match = text.match(FRONTMATTER_RE);
+  if (!match) {
+    return { hasFrontmatter: false, frontmatter: {}, error: null };
+  }
+  let data;
+  try {
+    data = yaml.load(match[1]);
+  } catch (err) {
+    return { hasFrontmatter: true, frontmatter: {}, error: err.message };
+  }
+  if (data === null || data === undefined) {
+    return { hasFrontmatter: true, frontmatter: {}, error: null };
+  }
+  if (typeof data !== 'object' || Array.isArray(data)) {
+    return { hasFrontmatter: true, frontmatter: {}, error: 'frontmatter is not a mapping' };
+  }
+  return { hasFrontmatter: true, frontmatter: data, error: null };
+}

package/payload/validator/schema.mjs

@@ -0,0 +1,147 @@
+// Parse SCHEMA.md's markdown tables into a schema object the validator checks
+// against. SCHEMA.md is the single source of truth; this reads it directly so
+// there is no second declaration to drift from. Deterministic: no LLM.
+
+import { readFileSync } from 'node:fs';
+
+const FIELD_TYPES = new Set(['text', 'number', 'date', 'checkbox', 'area', 'link', 'list']);
+
+/**
+ * Split a markdown table row into trimmed cells, dropping the leading/trailing
+ * pipes. A literal pipe inside a cell is escaped as `\|` (e.g. a `a|b` union) and
+ * must not be treated as a column separator.
+ */
+function splitRow(line) {
+  const trimmed = line.trim().replace(/^\|/, '').replace(/\|$/, '');
+  return trimmed.split(/(?<!\\)\|/).map((c) => c.trim().replace(/\\\|/g, '|'));
+}
+
+function isSeparatorRow(line) {
+  return /^\s*\|?[\s:|-]+\|?\s*$/.test(line) && line.includes('-');
+}
+
+/**
+ * Collect the markdown tables that appear under a heading whose text matches
+ * `headingTest`. Each table is returned as an array of row objects keyed by the
+ * lower-cased header cell text.
+ */
+function tablesUnderHeading(lines, headingTest) {
+  const out = [];
+  let active = false;
+  let header = null;
+  let rows = [];
+
+  const flush = () => {
+    if (header && rows.length) out.push(rows);
+    header = null;
+    rows = [];
+  };
+
+  for (const line of lines) {
+    const heading = line.match(/^(#{1,6})\s+(.*)$/);
+    if (heading) {
+      flush();
+      active = headingTest(heading[2].trim());
+      continue;
+    }
+    if (!active) continue;
+    const isTableRow = line.trim().startsWith('|');
+    if (!isTableRow) {
+      // A blank line inside a section is fine; a table ends at the next non-row line.
+      if (line.trim() === '') continue;
+      flush();
+      continue;
+    }
+    if (isSeparatorRow(line)) continue;
+    const cells = splitRow(line);
+    if (!header) {
+      header = cells.map((c) => c.toLowerCase());
+    } else {
+      const row = {};
+      header.forEach((key, i) => { row[key] = cells[i] ?? ''; });
+      rows.push(row);
+    }
+  }
+  flush();
+  return out;
+}
+
+function isRequired(cell) {
+  const v = (cell || '').toLowerCase();
+  return v.includes('✓') || v === 'yes' || v === 'required' || v === 'true';
+}
+
+/** Heading form: "Person (`person`)" → { name: 'Person', type: 'person' }. */
+function parseEntityHeading(text) {
+  const m = text.match(/^(.+?)\s+\(`([^`]+)`\)\s*$/);
+  if (!m) return null;
+  return { name: m[1].trim(), type: m[2].trim() };
+}
+
+/**
+ * Read and parse SCHEMA.md.
+ *
+ * @param {string} schemaPath path to SCHEMA.md
+ * @returns {{
+ *   areas: Set<string>,
+ *   entities: Map<string, { name: string, fields: Map<string, {type: string, required: boolean}> }>,
+ *   associations: Map<string, { targets: string[]|'any' }>
+ * }}
+ */
+export function loadSchema(schemaPath) {
+  const text = readFileSync(schemaPath, 'utf8');
+  const lines = text.split(/\r?\n/);
+
+  // Areas: the first column of the table under the "Areas" heading.
+  const areas = new Set();
+  for (const table of tablesUnderHeading(lines, (h) => h.toLowerCase() === 'areas')) {
+    for (const row of table) {
+      const value = row.area ?? Object.values(row)[0];
+      if (value) areas.add(value);
+    }
+  }
+
+  // Associations: field -> targets, from the table under the "Associations" heading.
+  const associations = new Map();
+  for (const table of tablesUnderHeading(lines, (h) => h.toLowerCase() === 'associations')) {
+    for (const row of table) {
+      const field = row.field;
+      const targetCell = row.target || '';
+      if (!field || !targetCell) continue;
+      const targets = targetCell === 'any' ? 'any' : targetCell.split('|').map((t) => t.trim());
+      associations.set(field, { targets });
+    }
+  }
+
+  // Entities: every heading shaped "Name (`type`)" introduces a field table.
+  // Pair each entity heading with the field table that immediately follows it.
+  const entities = new Map();
+  let current = null;
+  let header = null;
+  for (const line of lines) {
+    const heading = line.match(/^(#{1,6})\s+(.*)$/);
+    if (heading) {
+      const parsed = parseEntityHeading(heading[2].trim());
+      current = parsed ? { ...parsed, fields: new Map() } : null;
+      header = null;
+      if (parsed) entities.set(parsed.type, current);
+      continue;
+    }
+    if (!current) continue;
+    if (!line.trim().startsWith('|')) { if (line.trim() === '') continue; header = null; continue; }
+    if (isSeparatorRow(line)) continue;
+    const cells = splitRow(line);
+    if (!header) {
+      header = cells.map((c) => c.toLowerCase());
+      continue;
+    }
+    const row = {};
+    header.forEach((key, i) => { row[key] = cells[i] ?? ''; });
+    const fieldName = row.field;
+    const fieldType = (row.type || '').toLowerCase();
+    if (!fieldName || !FIELD_TYPES.has(fieldType)) continue;
+    current.fields.set(fieldName, { type: fieldType, required: isRequired(row.required) });
+  }
+
+  return { areas, entities, associations };
+}