@dotbep/core 0.2.7 → 0.2.8

package/examples/07-loin.ts

@@ -1,133 +0,0 @@
-// part of: node --experimental-strip-types examples/run-all.ts  (use --07 to stop here)
-//
-// Covers: lods, lois, loin.
-//
-// The LOIN section defines the Level of Information Need — what must be known
-// about each model element at each milestone. It is the core of an ISO 19650
-// information requirements framework.
-//
-// LOD (Level of Development) — geometric completeness of a model element.
-// LOI (Level of Information) — richness of the non-geometric data attached to it.
-// LOIN — the per-element table that maps (element × milestone) → (LOD, LOI).
-//
-// LOD and LOI ids are numeric strings ('100', '200', …). They are readable
-// codes, not UUIDs — the user chooses them to match the project's convention.
-
-import { readFileSync, writeFileSync } from 'node:fs'
-import { Bep } from '../dist/index.js'
-
-const bep = await Bep.open(readFileSync('examples/example.bep'))
-
-const m1Id = bep.milestones.list().find(m => m.name === 'Design Delivery')!.id
-const m2Id = bep.milestones.list().find(m => m.name === 'Construction Delivery')!.id
-
-// ─── LODs ─────────────────────────────────────────────────────────────────────
-
-// LOD levels are defined once and reused across all LOIN entries. Each level
-// can carry a checklist that the frontend renders as acceptance criteria.
-// The id is a string (not a number) so that it participates in the same
-// get/update/remove API as all other entities.
-
-console.log('=== lods ===')
-
-const lodsAdded = bep.lods.add([
-  { id: '100', name: 'LOD 100', checklist: ['Conceptual massing present'                          ] },
-  { id: '200', name: 'LOD 200'                                                                      },
-  { id: '300', name: 'LOD 300', checklist: ['All geometry defined', 'Dimensions accurate'         ] },
-  { id: '350', name: 'LOD 350', checklist: ['Connections and interfaces defined'                   ] },
-  { id: '100', name: 'Duplicate'                                                                   }, // fails
-])
-console.log('add succeeded:', lodsAdded.succeeded.map(l => l.id))
-console.log('add failed:   ', lodsAdded.failed)
-
-const gotLod = bep.lods.get(['100', '999'])
-console.log('\nget 100:', gotLod.succeeded[0].name)
-console.log('get 999 (failed):', gotLod.failed)
-
-bep.lods.update([
-  { id: '100', name: 'LOD 100 — Conceptual' },
-  { id: '999', name: 'Ghost'                }, // fails
-])
-
-// ─── LOIs ─────────────────────────────────────────────────────────────────────
-
-// LOI levels follow the same pattern as LODs — numeric string ids, optional
-// checklists. LOI 1 might require only a classification code; LOI 3 might
-// require a full property set with IFC links. The checklists make those
-// expectations explicit and auditable.
-
-console.log('\n=== lois ===')
-
-const loisAdded = bep.lois.add([
-  { id: '1', name: 'LOI 1'                                                                         },
-  { id: '2', name: 'LOI 2', checklist: ['Classification assigned', 'Material specified'           ] },
-  { id: '3', name: 'LOI 3', checklist: ['Full property set defined', 'IFC classification linked'  ] },
-  { id: '1', name: 'Duplicate'                                                                     }, // fails
-])
-console.log('add succeeded:', loisAdded.succeeded.map(l => l.id))
-console.log('add failed:   ', loisAdded.failed)
-
-// ─── LOIN ─────────────────────────────────────────────────────────────────────
-
-// A LOIN entry describes one model element type (e.g. "Walls") and its
-// information requirements across milestones. Each entry maps a discipline to
-// a list of (milestone → LOD + LOI) pairs.
-//
-// Every reference — discipline, milestone, LOD, LOI — is validated on add.
-// A single bad reference fails the entire LOIN entry, not just that milestone.
-
-console.log('\n=== loin ===')
-
-const loinAdded = bep.loin.add([
-  {
-    element:      'Walls',
-    disciplineId: 'ARQ',
-    milestones: [
-      { milestoneId: m1Id, lodId: '300', loiId: '2' },
-      { milestoneId: m2Id, lodId: '350', loiId: '3' },
-    ],
-  },
-  {
-    element:      'Slabs',
-    disciplineId: 'EST',
-    milestones: [
-      { milestoneId: m1Id, lodId: '200', loiId: '1' },
-      { milestoneId: m2Id, lodId: '300', loiId: '2' },
-    ],
-  },
-  // integrity failures —
-  { element: 'Bad discipline', disciplineId: 'ghost-disc'                                                             }, // fails
-  { element: 'Bad milestone',  disciplineId: 'ARQ', milestones: [{ milestoneId: 'ghost', lodId: '100', loiId: '1' }] }, // fails
-  { element: 'Bad LOD',        disciplineId: 'ARQ', milestones: [{ milestoneId: m1Id,   lodId: '999', loiId: '1' }] }, // fails
-  { element: 'Bad LOI',        disciplineId: 'ARQ', milestones: [{ milestoneId: m1Id,   lodId: '100', loiId: '99' }] }, // fails
-])
-const loinWallsId = loinAdded.succeeded[0].id
-const loinSlabsId = loinAdded.succeeded[1].id
-console.log('add succeeded:', loinAdded.succeeded.map(l => l.element))
-console.log('add failed:   ', loinAdded.failed)
-
-console.log('\n--- integrity: entities referenced by LOIN cannot be removed ---')
-console.log('remove ARQ (discipline):', bep.disciplines.remove(['ARQ']).failed)
-console.log('remove m1  (milestone): ', bep.milestones.remove([m1Id]).failed)
-console.log('remove 300 (lod):       ', bep.lods.remove(['300']).failed)
-console.log('remove LOI 2:           ', bep.lois.remove(['2']).failed)
-
-// remove works when the LOIN entry itself is deleted first
-const loinRemoved = bep.loin.remove([loinSlabsId, 'ghost-loin'])
-console.log('\nremove Slabs LOIN succeeded:', loinRemoved.succeeded)
-console.log('remove ghost failed:        ', loinRemoved.failed)
-
-// re-add Slabs so the complete BEP carries it forward
-bep.loin.add([{
-  element:      'Slabs',
-  disciplineId: 'EST',
-  milestones: [
-    { milestoneId: m1Id, lodId: '200', loiId: '1' },
-    { milestoneId: m2Id, lodId: '300', loiId: '2' },
-  ],
-}])
-
-// ─── Save ─────────────────────────────────────────────────────────────────────
-
-writeFileSync('examples/example.bep', await bep.save())
-console.log('\nSaved → examples/example.bep')

package/examples/08-deliverables.ts

@@ -1,126 +0,0 @@
-// part of: node --experimental-strip-types examples/run-all.ts  (use --08 to stop here)
-//
-// Covers: deliverables, nomenclature.
-//
-// Deliverables are the actual files that teams must produce and exchange.
-// They are the most cross-referenced entity in the BEP — each one ties together
-// a discipline, a document type, a set of extensions, a responsible team, a
-// milestone, and optionally an LBS location and a predecessor deliverable.
-//
-// Nomenclature derives a human-readable naming code from those references:
-//   {project.code}-{team.id}-{zoneCode}-{locationCode}-{assetType.id}-{disc.id}-{NNN}
-// NNN is a global sequence counter across all deliverables, zero-padded to three digits.
-
-import { readFileSync, writeFileSync } from 'node:fs'
-import { Bep, buildCodeMap } from '../dist/index.js'
-
-const bep = await Bep.open(readFileSync('examples/example.bep'))
-
-const m1Id = bep.milestones.list().find(m => m.name === 'Design Delivery')!.id
-const m2Id = bep.milestones.list().find(m => m.name === 'Construction Delivery')!.id
-
-// ─── Deliverables ─────────────────────────────────────────────────────────────
-
-// Every reference field is validated on add. A deliverable with a ghost
-// disciplineId, assetTypeId, extensionId, responsibleId, milestoneId, or
-// lbsNodeId fails individually — other deliverables in the same batch proceed.
-// predecessorId is set via update() after both IDs are known.
-
-console.log('=== deliverables ===')
-
-const delAdded = bep.deliverables.add([
-  {
-    description:    'Architectural Model — Floor 1',
-    disciplineId:   'ARQ',
-    assetTypeId: 'M3D',
-    extensionIds:   ['ifc', 'rvt'],
-    responsibleId:  'ARC',
-    milestoneId:    m1Id,
-    lbsNodeId:      'P01',
-  },
-  {
-    description:    'Architectural Model — Floor 2',
-    disciplineId:   'ARQ',
-    assetTypeId: 'M3D',
-    extensionIds:   ['ifc', 'rvt'],
-    responsibleId:  'ARC',
-    milestoneId:    m1Id,
-    lbsNodeId:      'P02',
-  },
-  {
-    description:    'Structural Model — Floor 1',
-    disciplineId:   'EST',
-    assetTypeId: 'M3D',
-    responsibleId:  'ARC',
-    milestoneId:    m2Id,
-    lbsNodeId:      'P01',
-    // predecessorId set after d1 is known
-  },
-  // integrity failures —
-  { description: 'Bad discipline', disciplineId: 'ghost-disc', assetTypeId: 'M3D',       responsibleId: 'ARC',        milestoneId: m1Id               },
-  { description: 'Bad assetType', disciplineId: 'ARQ',        assetTypeId: 'ghost-dt',  responsibleId: 'ARC',        milestoneId: m1Id               },
-  { description: 'Bad extension', disciplineId: 'ARQ',        assetTypeId: 'M3D',       extensionIds: ['ghost-ext'], responsibleId: 'ARC', milestoneId: m1Id },
-  { description: 'Bad team',      disciplineId: 'ARQ',        assetTypeId: 'M3D',       responsibleId: 'ghost-team', milestoneId: m1Id               },
-  { description: 'Bad milestone', disciplineId: 'ARQ',        assetTypeId: 'M3D',       responsibleId: 'ARC',        milestoneId: 'ghost-ms'         },
-  { description: 'Bad lbsNode',   disciplineId: 'ARQ',        assetTypeId: 'M3D',       responsibleId: 'ARC',        milestoneId: m1Id, lbsNodeId: 'ghost-node' },
-])
-const d1 = delAdded.succeeded[0].id
-const d2 = delAdded.succeeded[1].id
-const d3 = delAdded.succeeded[2].id
-console.log('add succeeded:', delAdded.succeeded.map(d => d.description))
-console.log('add failed:   ', delAdded.failed)
-
-// set predecessor now that both IDs are known
-bep.deliverables.update([{ id: d3, predecessorId: d1 }])
-
-console.log('\n--- integrity: predecessor blocks removal of the referenced deliverable ---')
-const d1Blocked = bep.deliverables.remove([d1])
-console.log('remove d1 (blocked by d3.predecessorId):', d1Blocked.failed)
-
-console.log('\n--- integrity: entities referenced by deliverables cannot be removed ---')
-console.log('remove ARQ (discipline):', bep.disciplines.remove(['ARQ']).failed)
-console.log('remove M3D (assetType): ', bep.assetTypes.remove(['M3D']).failed)
-console.log('remove m1  (milestone): ', bep.milestones.remove([m1Id]).failed)
-console.log('remove ARC (team):      ', bep.teams.remove(['ARC']).failed)
-console.log('remove P01 (lbsNode):   ', bep.lbsNodes.remove(['P01']).failed)
-
-// ─── Nomenclature ─────────────────────────────────────────────────────────────
-
-// buildCodeMap() computes naming codes for all deliverables in one pass.
-// LBS resolution: P01 is a child of BLK → zoneCode=BLK, locationCode=P01.
-//                 P02 is also a child of BLK → same zone, different location.
-// NNN is a global zero-padded sequence, so d1→001, d2→002, d3→003.
-//
-// getCode() is a single-deliverable shortcut that internally calls buildCodeMap.
-// buildConsecutivoMap() returns the raw integer sequence numbers before zero-padding.
-// The standalone buildCodeMap import is useful when BEP data comes from outside
-// the Bep class (e.g. from a raw JSON snapshot).
-const codeMap = bep.nomenclature.buildCodeMap()
-console.log('code map:')
-for (const [id, code] of codeMap) {
-  console.log(' ', id.slice(0, 8), '→', code)
-}
-// d1 → EXP-ARC-BLK-P01-M3D-ARQ-001
-// d2 → EXP-ARC-BLK-P02-M3D-ARQ-001  (different location → new NNN sequence)
-// d3 → EXP-ARC-BLK-P01-M3D-EST-001
-
-// getCode: single deliverable by id
-console.log('\nd1 code:', bep.nomenclature.getCode(d1))
-console.log('d2 code:', bep.nomenclature.getCode(d2))
-console.log('d3 code:', bep.nomenclature.getCode(d3))
-console.log('ghost:  ', bep.nomenclature.getCode('ghost-id'))  // null
-
-// buildConsecutivoMap: raw sequence numbers per deliverable (before zero-padding)
-const seqMap = bep.nomenclature.buildConsecutivoMap()
-console.log('seq d1:', seqMap.get(d1))  // 1
-console.log('seq d2:', seqMap.get(d2))  // 1 (different location → independent sequence)
-console.log('seq d3:', seqMap.get(d3))  // 1
-
-// standalone buildCodeMap — useful when BEP data comes from an external source
-const externalMap = buildCodeMap(bep.data.deliverables, bep.data.project.code, bep.data.lbs)
-console.log('\nexternal buildCodeMap matches:', [...externalMap.values()].join(', '))
-
-// ─── Save ─────────────────────────────────────────────────────────────────────
-
-writeFileSync('examples/example.bep', await bep.save())
-console.log('\nSaved → examples/example.bep')

package/examples/09-notes.ts

@@ -1,73 +0,0 @@
-// part of: node --experimental-strip-types examples/run-all.ts  (use --09 to stop here)
-//
-// Covers: notes.
-//
-// Notes are the human layer of the BEP — annotations written by team members
-// to record decisions, concerns, or confirmations that do not fit into the
-// structured data. They are identified by the author's email, which must
-// reference an existing member of the BEP.
-//
-// Because notes are authored by members, removing a member who has authored
-// notes is blocked by referential integrity. The constraint is released only
-// when the note itself is deleted first.
-
-import { readFileSync, writeFileSync } from 'node:fs'
-import { Bep } from '../dist/index.js'
-
-const bep = await Bep.open(readFileSync('examples/example.bep'))
-
-// ─── Notes ────────────────────────────────────────────────────────────────────
-
-// Notes are authored by members (identified by email) and carry a free-text
-// message and a creation timestamp. The memberEmail must reference a member
-// already registered in the BEP — unknown authors are rejected individually.
-
-console.log('=== notes ===')
-
-// notes are human annotations authored by BEP members (identified by email)
-const notesAdded = bep.notes.add([
-  {
-    message:     'LOD 300 definition confirmed with client in meeting of 2026-03-15.',
-    memberEmail: 'alice@arc.com',
-    createdAt:   '2026-03-15T10:00:00Z',
-  },
-  {
-    message:     'Structure team has not confirmed milestone M2 date yet.',
-    memberEmail: 'bob@arc.com',
-    createdAt:   '2026-03-16T09:00:00Z',
-  },
-  {
-    message:     'Bad author.',
-    memberEmail: 'ghost@x.com',   // fails — not a registered member
-    createdAt:   '2026-03-16T09:00:00Z',
-  },
-])
-const n1Id = notesAdded.succeeded[0].id
-const n2Id = notesAdded.succeeded[1].id
-console.log('add succeeded:', notesAdded.succeeded.map(n => n.message.slice(0, 50)))
-console.log('add failed:   ', notesAdded.failed)
-
-// sparse update — only message or other fields can be patched
-const notesUpdated = bep.notes.update([
-  { id: n2Id,       message: 'Structure team confirmed: M2 date is 2027-03-31.' },
-  { id: 'ghost-id', message: 'Ghost' },   // fails — id not found
-])
-console.log('\nupdate succeeded:', notesUpdated.succeeded.map(n => n.message.slice(0, 50)))
-console.log('update failed:   ', notesUpdated.failed)
-
-console.log('\n--- integrity: member with authored notes cannot be removed ---')
-const aliceBlocked = bep.members.remove(['alice@arc.com'])
-console.log('remove alice (blocked by note.memberEmail):', aliceBlocked.failed)
-
-// removing the note frees the member constraint for that note
-const noteRemoved = bep.notes.remove([n1Id, 'ghost-note'])
-console.log('\nremove n1 succeeded:', noteRemoved.succeeded)
-console.log('remove ghost failed: ', noteRemoved.failed)
-
-// alice can now be removed (her only note was n1Id, which was just deleted)
-// — not doing it here to keep alice in the BEP for subsequent examples
-
-// ─── Save ─────────────────────────────────────────────────────────────────────
-
-writeFileSync('examples/example.bep', await bep.save())
-console.log('\nSaved → examples/example.bep')

package/examples/10-llm.ts

@@ -1,109 +0,0 @@
-// part of: node --experimental-strip-types examples/run-all.ts  (use --10 to stop here)
-//
-// Covers: flags, memory, skill.
-//
-// These three entities are the LLM's layer of the BEP — they are written by
-// the agent, not by the BIM Manager directly.
-//
-// Flags    — observations generated after analyze_bep. Each flag points to an
-//            entity (or to the whole BEP) and carries a severity level. Flags
-//            are transient: they are cleared and regenerated on each analysis.
-//
-// Memory   — a single markdown string the LLM writes to persist context across
-//            sessions: confirmed decisions, acknowledged flags, client constraints.
-//            The caller owns the full string — there is no append API.
-//
-// Skill    — instructions authored by the BIM Manager that tell the LLM how to
-//            behave in this specific BEP (terminology, tone, LOD conventions).
-//            Skill can be copied from a template BEP to seed a new project.
-
-import { readFileSync, writeFileSync } from 'node:fs'
-import { Bep } from '../dist/index.js'
-
-const bep = await Bep.open(readFileSync('examples/example.bep'))
-
-const d1 = bep.deliverables.list().find(d => d.description === 'Architectural Model — Floor 1')!.id
-
-// ─── Flags ────────────────────────────────────────────────────────────────────
-
-// Flags point to specific entities (or to the whole BEP when entityId is null)
-// and communicate issues the LLM detected during analysis. Once a flag is
-// knowingly accepted, it should be removed and the decision documented in memory
-// so it is not re-reported in a future session.
-
-console.log('=== flags ===')
-
-// Flags are generated by the LLM after analyze_bep — not authored by users.
-// entity / entityId point to what the flag refers to; null means the whole BEP.
-const flagsAdded = bep.flags.add([
-  {
-    entity:      'deliverables',
-    entityId:    d1,
-    severity:    'warning',
-    message:     'Deliverable has no dueDate and the milestone date is in the past.',
-    generatedAt: '2026-03-24T08:00:00Z',
-  },
-  {
-    entity:      null,
-    entityId:    null,
-    severity:    'info',
-    message:     'BEP has no KPIs defined in the indicators section.',
-    generatedAt: '2026-03-24T08:00:00Z',
-  },
-])
-const f1Id = flagsAdded.succeeded[0].id
-const f2Id = flagsAdded.succeeded[1].id
-console.log('flags added:', flagsAdded.succeeded.map(f => `[${f.severity}] ${f.message.slice(0, 40)}`))
-
-// remove a flag once it has been resolved or knowingly accepted
-const flagRemoved = bep.flags.remove([f2Id, 'ghost-flag'])
-console.log('remove info flag:', flagRemoved.succeeded)
-console.log('remove ghost (failed):', flagRemoved.failed)
-console.log('flags remaining:', bep.flags.list().length)
-
-// ─── Memory ───────────────────────────────────────────────────────────────────
-
-console.log('\n=== memory ===')
-
-// memory is project-specific context the LLM writes for itself to recall across sessions
-console.log('memory (empty):', JSON.stringify(await bep.memory.get()))
-
-bep.memory.set([
-  '# Project Memory',
-  '',
-  '- LOD 300 confirmed with client on 2026-03-15.',
-  '- Structure team is responsible for all EST deliverables.',
-  '- "No KPIs" flag acknowledged — no KPI framework planned for this phase.',
-].join('\n'))
-
-console.log('memory set (first 60 chars):', (await bep.memory.get()).slice(0, 60))
-
-// overwrite — no append, the caller owns the full string
-const current = await bep.memory.get()
-bep.memory.set(current + '\n- Coordination meetings every Monday at 09:00.')
-console.log('memory length after update:', (await bep.memory.get()).length)
-
-// ─── Skill ────────────────────────────────────────────────────────────────────
-
-console.log('\n=== skill ===')
-
-// skill is the BIM Manager's instructions for how the LLM should behave in this BEP
-console.log('skill (empty):', JSON.stringify(await bep.skill.get()))
-
-bep.skill.set([
-  'Always use ISO 19650 terminology.',
-  'Prefer concise descriptions — one sentence per deliverable.',
-  'When suggesting LOD levels, reference the project phases in bep.phases.',
-].join('\n'))
-
-console.log('skill set (first 60 chars):', (await bep.skill.get()).slice(0, 60))
-
-// key use case: copy skill from a template BEP to a new project
-const templateBep = Bep.create({ name: 'New Project', code: 'NEW' })
-templateBep.skill.set(await bep.skill.get())
-console.log('\nskill copied to new BEP (first 50):', (await templateBep.skill.get()).slice(0, 50))
-
-// ─── Save ─────────────────────────────────────────────────────────────────────
-
-writeFileSync('examples/example.bep', await bep.save())
-console.log('\nSaved → examples/example.bep')

package/examples/11-resolved.ts

@@ -1,133 +0,0 @@
-// part of: node --experimental-strip-types examples/run-all.ts  (use --11 to stop here)
-//
-// Covers: listResolved() across all entity types. Read-only — no save.
-//
-// Every list() call returns raw entities with ID references (e.g. roleId: 'uuid').
-// listResolved() replaces every ID with the full referenced object, so callers
-// get a ready-to-render shape without performing any lookups themselves.
-//
-// This is particularly useful for the MCP — list_* tools always call
-// listResolved() internally and return the enriched objects, so the LLM never
-// needs to issue a follow-up call just to resolve a name.
-//
-// If a reference is broken (the referenced entity was deleted), listResolved()
-// returns { id, name: null } instead of throwing, so the rest of the record
-// remains usable.
-
-import { readFileSync } from 'node:fs'
-import { Bep } from '../dist/index.js'
-
-const bep = await Bep.open(readFileSync('examples/example.bep'))
-
-// ─── members ──────────────────────────────────────────────────────────────────
-
-console.log('=== members.listResolved() ===')
-
-const resolvedMembers = bep.members.listResolved()
-const alice = resolvedMembers.find(m => m.email === 'alice@arc.com')!
-console.log('alice role:            ', alice.role)               // { id, name, color }
-console.log('alice team:            ', alice.team)               // { id: 'ARC', name: '...' }
-console.log('alice isRepresentative:', alice.isRepresentative)   // true
-
-// ─── teams ────────────────────────────────────────────────────────────────────
-
-console.log('\n=== teams.listResolved() ===')
-
-const resolvedTeams = bep.teams.listResolved()
-const arc = resolvedTeams.find(t => t.id === 'ARC')!
-console.log('ARC representative:', arc.representative?.name)
-console.log('ARC members:       ', arc.members.map(m => m.name))
-console.log('ARC disciplines:   ', arc.disciplines.map(d => d.id))
-
-// ─── milestones ───────────────────────────────────────────────────────────────
-
-console.log('\n=== milestones.listResolved() ===')
-
-const resolvedMilestones = bep.milestones.listResolved()
-for (const m of resolvedMilestones) {
-  console.log(`  ${m.name} (${m.date}) → phase: ${m.phase?.name}`)
-}
-
-// ─── lbsNodes ─────────────────────────────────────────────────────────────────
-
-console.log('\n=== lbsNodes.listResolved() ===')
-
-const resolvedLbs = bep.lbsNodes.listResolved()
-const site = resolvedLbs.find(n => n.id === 'SIT')!
-const blkA = resolvedLbs.find(n => n.id === 'BLK')!
-const p01  = resolvedLbs.find(n => n.id === 'P01')!
-
-console.log('SIT  isRoot:', site.isRoot,  '| parent:', site.parent,      '| children:', site.children.map(c => c.id))
-console.log('BLK isRoot:', blkA.isRoot,  '| parent:', blkA.parent?.id,  '| children:', blkA.children.map(c => c.id))
-console.log('P01   isRoot:', p01.isRoot,   '| parent:', p01.parent?.id)
-
-// ─── guides ───────────────────────────────────────────────────────────────────
-
-console.log('\n=== guides.listResolved() ===')
-
-const resolvedGuides = bep.guides.listResolved()
-for (const g of resolvedGuides) {
-  console.log(`  ${g.name}: annexes=[${g.annexes.map(a => a.name).join(', ')}]`)
-}
-
-// ─── workflows ────────────────────────────────────────────────────────────────
-
-console.log('\n=== workflows.listResolved() ===')
-
-const resolvedWorkflows = bep.workflows.listResolved()
-const wf = resolvedWorkflows[0]
-console.log('workflow:', wf.name)
-
-const updateNode = wf.diagram.nodes['update']
-if (updateNode) {
-  console.log('update node action:     ', updateNode.action?.name)
-  console.log('update node responsible:', updateNode.responsible.roles.map(r => r.name))
-}
-
-// ─── bimUses ──────────────────────────────────────────────────────────────────
-
-console.log('\n=== bimUses.listResolved() ===')
-
-const resolvedBimUses = bep.bimUses.listResolved()
-for (const bu of resolvedBimUses) {
-  console.log(`  ${bu.name}:`)
-  console.log(`    objectives: [${bu.objectives.map(o => o.description.slice(0, 35)).join(' | ')}]`)
-  console.log(`    workflows:  [${bu.workflows.map(w => w.name).join(', ')}]`)
-}
-
-// ─── loin ─────────────────────────────────────────────────────────────────────
-
-console.log('\n=== loin.listResolved() ===')
-
-const resolvedLoin = bep.loin.listResolved()
-for (const l of resolvedLoin) {
-  console.log(`  ${l.element} (${l.discipline?.name}):`)
-  for (const lm of l.milestones) {
-    console.log(`    milestone=${lm.milestone?.name}  lod=${lm.lod?.name}  loi=${lm.loi?.name}`)
-  }
-}
-
-// ─── deliverables ─────────────────────────────────────────────────────────────
-
-console.log('\n=== deliverables.listResolved() ===')
-
-const resolvedDelivs = bep.deliverables.listResolved()
-for (const d of resolvedDelivs) {
-  console.log(`  ${d.nomenclatureCode ?? d.id}`)
-  console.log(`    discipline:  ${d.discipline?.name}`)
-  console.log(`    assetType:   ${d.assetType?.name}`)
-  console.log(`    responsible: ${d.responsible?.name}`)
-  console.log(`    milestone:   ${d.milestone?.name}`)
-  if (d.predecessor) console.log(`    predecessor: ${d.predecessor.id}`)
-}
-
-// ─── notes ────────────────────────────────────────────────────────────────────
-
-console.log('\n=== notes.listResolved() ===')
-
-const resolvedNotes = bep.notes.listResolved()
-for (const n of resolvedNotes) {
-  console.log(`  [${n.member?.name ?? '(unknown)'}] ${n.message.slice(0, 60)}`)
-}
-
-console.log('\nDone — no save (read-only example).')