Updates log

Tracking Mythoskolis changes: additions, fixes, and ongoing work.

April 21, 2026

What changed for visitors

Technical note: lighter HoloGraph client, cleaner transitions, and final grouping fixes

HoloGraph client

  • The interactive client was refactored to factorize quadrant rendering more aggressively and cut down on redundant recalculations.
  • The narrative-group logic used in siblings and children now relies on a more shared foundation, including:
    • unified build structures;
    • a narrative-membership index;
    • a lightweight cache for some child-group computations.

Transitions and recentering

  • The computation of target positions during recentering was revised to better account for narrative groups.
  • Animations now also use transition aliases between a displayed group and its underlying members, which makes the motion feel much more consistent with the final rendered position.
  • Several animated clones and fly transitions were cleaned up to remove rendering artifacts and unnecessary offsets.

Narrative groups and the siblings quadrant

  • Narrative-group collapsing in siblings now triggers in more documented situations, including cases where the narrative group is not the central node.
  • When an explicit group is already present in the visible list, it once again becomes the primary display level, preventing its members from being injected alongside it as parallel duplicates.
  • Detection also reconstructs some cases more reliably when group membership is expressed through membership metadata rather than through the currently visible relation alone.

children quadrant

  • Visual redistribution around a focused child was restored without breaking the display of explicit narrative groups in that quadrant.
  • Internal ordering now works at the level of render slots rather than isolated portraits, which preserves narrative groups as display units while keeping the intended placement priority around the focused portrait.

HoloGraph demo

  • The demo runtime now makes better use of the existing quadrant scroll primitives before some guided clicks.
  • Modals left open during a demo are now temporarily made inert, so they no longer interfere with simulated interactions.

April 14, 2026

What changed for visitors

Technical note: HoloGraph stabilization, demos, and detailed genealogy

Detailed genealogy

  • EgoGraph.astro was heavily revised to make better use of the JSON produced from the factorized YAML.
  • The rendering logic can now:
    • resolve narrative-group pseudo-nodes more reliably;
    • avoid duplicates between a group and its members;
    • preserve multiple distinct groups inside the same sibling section when the documentation requires it;
    • rebuild a single card for children belonging to the same documented family schema, even when that schema mixes standalone entities, groups without explicit members, and groups with explicit members;
    • merge source rows when several contexts share the same attestation.

HoloGraph

  • The interactive HoloGraph client now handles several remaining narrative-group edge cases more cleanly inside the quadrants, especially when a sibling narrative group coexists with other documented family structures.
  • In iconography mode, narrative groups now also have their own dedicated fallback portrait when no specific visual exists.

Demo and ergonomics

  • The demo runtime was adjusted to better sequence:
    • graph recentering;
    • scroll settling;
    • page scroll locking;
    • then the actual guided steps.
  • The demo dialog was restructured with more compact navigation, a replay button, and a progress counter.
  • The Normal / Advanced toggle now looks and behaves more explicitly like a true state switch.

Illustration mode

  • Swappable media renderings (profiles, cards, contextual portraits, stories) now more often start directly on the correct iconography variant when it already exists, instead of showing the AI version first and swapping afterward.

April 10, 2026

What changed for visitors

Technical note: new canonical YAML, pipeline, HoloGraph, demos, and onboarding

New canonical YAML and pipeline

  • The project now runs on a factorized YAML used as its actual source of truth.
  • That top-level structure cleanly separates:
    • entities
    • narrative_groups
    • nuclear_families
    • siblings
    • consorts
  • This makes the document smaller and less redundant, while handling much more cleanly:
    • narrative groups ;
    • competing family structures ;
    • retained / alternative / mixed statuses ;
    • multi-source cases.
  • The YAML -> JSON pipeline was adapted to this model and now propagates the documentary metadata the HoloGraph actually needs.

HoloGraph

  • The HoloGraph was rebuilt around this documentary logic, instead of trying to keep patching the old entity-centric model.
  • Narrative groups are now first-class objects:
    • centered groups ;
    • expanded groups inside a quadrant ;
    • membership badges on the central portrait ;
    • cases where a group absorbs all relevant siblings or coexists with additional siblings ;
    • groups without explicit members ;
    • much cleaner handling of competing documented versions.
  • A large stabilization pass also covered:
    • visual stacking (z-index) ;
    • documentary tooltips and modals ;
    • focus halos ;
    • source and status badges ;
    • homonyms, ids, and slugs ;
    • FR / EN consistency ;
    • mobile behavior.

Two HoloGraph demos

  • The base-mode demo was fully rebuilt on top of a dedicated runtime, with:
    • isolated steps ;
    • explicit cancellation of async actions ;
    • waits for graph transitions to finish ;
    • clicks that stay much closer to the graph’s natural behavior ;
    • floating pointers, simulated search, badge clicks, modal interactions, and sourced excerpts ;
    • programmed quadrant scrolling when that feels more natural than forced positioning.
  • The advanced-mode demo now exists as a full scenario of its own.
  • The How does it work? button now launches the correct demo according to the real HoloGraph state.
  • The old advanced-mode ? help button and its usage notice were removed entirely: the explanation now lives in the demo itself.
  • Separate visual hints now exist for first-time discovery of the base demo and of the advanced demo.

Ancient texts and onboarding

  • The ancient-text listing component now distinguishes more cleanly between:
    • works with one single part ;
    • works with several parts ;
    • works with many parts.
  • The result avoids redundant nested cards and dramatically reduces vertical clutter, especially on mobile.
  • A new onboarding block was added to the homepage around Follow the guide.
  • The FR/EN routes for that guide were also wired cleanly into the language switcher.

March 27, 2026

What changed for visitors

Technical note: homonyms, HoloGraph routes, and sourced data

HoloGraph and identity resolution

  • Front-end entity resolution now prioritizes stable id values over plain slug matching, which prevents one homonym from silently overriding another during search, focus, or recentering.
  • The HoloGraph controller now also passes the id more consistently whenever it is known, including in internal focus actions.
  • A dedicated regression test now explicitly covers the case of two figures sharing the same public name.

Genealogy data

  • The YAML received a substantial batch of documentary fixes and enrichments, with several Hesiod passages rewritten toward more precise excerpts better aligned with the displayed relations.
  • New entities and relations were integrated into the factorized graph, then re-exported into the public JSON used by the site.

Contributions and public page

  • The public contributions registry was updated to reflect the newly acknowledged documentary work shown on the citizens page.
  • A few support-related visual markers were harmonized between the footer and the dedicated page.

March 26, 2026

Thanks. Warm thanks to Noyan for his contributions to the documentation of sourced excerpts, and to blooh for the Ko-fi donation that will, in time, help commission human artists to illustrate the site.

Publicly acknowledged contributions can be found on the dedicated page: Contributors

What changed for visitors

Technical note: narrative groups, contextual help, and contributions

Narrative groups and genealogy

  • The YAML inspector now includes a dedicated modal to manage a narrative group as a full documentary configuration: source, retained / alternative status, members, and optional parents.
  • That modal can rewrite the relevant relations in a more coherent siblings / parents / children schema, which reduces ambiguity when several competing versions of the same group coexist.
  • Detailed genealogy now groups those versions more cleanly: same members = one card with stacked source lines; different compositions = separate cards kept adjacent when they belong to the same narrative group.
  • The HoloGraph also handles multi-version groups more effectively: one narrative label can now produce a single expandable group, while individual portraits keep their own documentary states (retained, alternative, mixed, uncertain).

Sourced excerpts and source texts

  • The full YAML -> inspector -> JSON -> site chain now supports multi-passage references for a single source work.
  • Sourced-excerpt modals can show several successive passages, and ancient-text pages now expose controls for previous / next passage navigation as well as a targeted-excerpts panel.

Contextual help and citizens page

  • The advanced-mode HoloGraph guide is now powered by shared FR/EN markdown plus media selected according to the current language and illustration mode.
  • The contributions manager was strengthened as well: canonical contributor registry, portrait/URL management, donation amounts, optional public amount anonymization, and better consistency between the internal tool and the public citizens page.

March 20, 2026

What changed for visitors

Technical note: data model, inspector, HoloGraph, and contextual reading

Data model and YAML -> JSON chain

  • The YAML model now supports a narrative_group field on sibling relations, instead of duplicating that information elsewhere.
  • The transform pipeline preserves that information all the way to the generated JSON, allowing the front end to use it directly instead of re-inferring groups from entities alone.

Genealogy inspector

  • The YAML inspector was extended to create, edit, and propagate narrative sibling groups more cleanly.
  • Relation forms were reorganized to reduce overlapping fields and make source-related and narrative-group editing blocks easier to read.

HoloGraph

  • The HoloGraph now reconstructs narrative groups from documented relations, then uses them differently depending on the quadrant:
    • collapsed / expanded bubble in children ;
    • dedicated narrative badge in siblings.
  • Several ergonomics fixes were added around these groups:
    • temporary violet halos ;
    • collapse on outside click ;
    • relayout animation for surrounding portraits ;
    • stricter clipping to prevent cross-quadrant overflow ;
    • removal of various jumps, repops, and end-of-animation flickers.
  • The HoloGraph demo was updated for cases where a sibling set is no longer displayed as separate portraits but as one interactive narrative group.

Contextual reading

  • When a precise source passage is documented, related badges and modals can now open the exact excerpt that supports the relation.
  • From that excerpt, a dedicated control can open the full source-text page directly at the corresponding highlighted passage.
  • The contextual-reading floater now follows the actual active reading area more closely.
  • When the contextualized body leaves the viewport, the badge can hide without causing a visible scroll hitch.
Older updates

March 13, 2026

What changed for visitors

  • The advanced HoloGraph mode was deeply reworked. It now distinguishes retained and alternative relations more clearly, documents sources in a much richer way, and makes alternative filiations, uncertain ties, and alter-ego cases far easier to read.
  • The detailed genealogy on entity pages was significantly expanded and brought closer to the advanced HoloGraph logic. It now exposes more source-by-source context, handles ambiguous cases better, and makes alternative family structures much more readable.
  • The FR / EN behavior of the advanced HoloGraph was aligned more closely: modals, source groupings, badges, and relation handling now behave far more consistently across both languages.
  • Advanced HoloGraph modals were enriched with better contextual groupings, clearer context badges, cleaner retained / alternative rendering, improved handling of sole parents (only), and more explicit source-based family links.
  • Alter egos are now better integrated across the browsing experience: cleaner switching in the HoloGraph, better handling when the entity is at the center, adapted sheet-navigation buttons, and more coherent rendering in both modals and entity pages.
  • On entity pages, consort sections can now surface children documented by the sources, which brings detailed genealogy much closer to HoloGraph behavior.
  • Multiple visual adjustments were made to badges, chips, and modals in both the HoloGraph and detailed genealogy views to improve readability and UI consistency.
  • The legacy ? button in advanced mode and its video explainer link were removed from the HoloGraph, as that help layer had become obsolete after the refactor.
  • The genealogy sandbox received several interface fixes: restoration of the central starting bubble, repaired relation-management modal behavior, larger and easier-to-hit edit-mode action badges, and a new grouped social-links badge in the footer.
  • New ancient source texts were added to the repository, notably around Apollonius of Rhodes’ Argonautica and Hesiod’s Theogony.
Deep technical refactor: data model, inspector, pipeline, and rendering

Genealogy data model refactor

  • The genealogy YAML model was heavily restructured around the factorized YAML format.
  • The legacy alter field was replaced by directional alter_self / alter_target.
  • Mirror entities were clarified: an alter_target entity is no longer supposed to maintain its own relationship set, but instead reuses the origin-side genealogy.
  • Alter-ego reciprocity rules are now explicitly validated.
  • Sources now support a multilingual passage format such as passage_fr|passage_en, with proper fallback based on the active language.

YAML -> inspector -> JSON -> site pipeline

  • The full chain was upgraded:
    • factorized YAML,
    • inspector,
    • editing server,
    • YAML -> JSON transforms,
    • shared front-end helpers,
    • HoloGraph and entity-page rendering.
  • JSON generation now preserves structural source signatures more reliably, even when displayed labels are localized.
  • Shared helpers were extended to better resolve directional alter egos and language-specific passage variants.

Inspector and source propagation

  • The YAML inspector was reworked to expose more clearly:
    • grouped relations,
    • directional alter pairs (origin / target),
    • stronger data-consistency checks.
  • Source propagation was reinforced across parents, children, and consorts groups.
  • This propagation is now locked by strict author / work / passage coherence, preventing accidental overwrites of distinct parallel documentations.
  • YAML validation now explicitly handles alter_self / alter_target constraints.

HoloGraph and detailed genealogy rendering

  • EgoGraphInteractive, its TypeScript client, EgoGraph.astro, GenealogyEntityChip.astro, and shared genealogy helpers were substantially reworked.
  • The advanced HoloGraph now handles much better:
    • uncertain relations (uncertain, uncertain_self, uncertain_target) ;
    • source grouping by family context ;
    • alter egos at the center and in surrounding quadrants ;
    • richer source modals ;
    • contextual badges and halos.
  • Detailed genealogy now inherits part of that rendering intelligence instead of remaining a flatter, simplified view.
  • Public FR / EN meta pages were substantially rewritten to better reflect the current state of the project, primarily as a descriptive layer usable by crawlers and AI systems.
  • A dedicated AI-facing documentation layer was added:
    • ai.txt
    • llm.txt
    • about-ai.md

Planned next steps

  • Introduce entity-group sheets (for example Cyclopes, Muses, and similar collective figures), structurally close to current entity sheets but reachable from multiple unitary HoloGraph figures.
  • Add a more advanced source-passage linking system, with the long-term goal of connecting displayed references, the exact excerpt they point to, and the full source text available on the site.

March 3, 2026

What changed for visitors

  • A new guidance card was added on the homepage (FR/EN) to quickly direct first-time visitors to three entry points: HoloGraph, entity sheets, and stories. Particular thanks to Histoire & Odyssée for this ergonomic suggestion.
  • The French intermediate page L'HoloGraph de Mythoskolis was removed: it now redirects directly to /fr/holograph/zeus/.
  • The illustration-mode modal was improved with dedicated visual backgrounds (Interpretation/Iconography), a footer ? button to reopen it, and better tooltip readability/ergonomics.
  • In HoloGraph, keyboard navigation in the search field was improved: up/down arrows now correctly cycle through the full result list.
  • Media captions now preserve line breaks on the website (pre-line rendering).
  • Three new entity pages were published: Helios, Selene, and Eos.
  • New illustrations were added and/or refreshed across the site (notably around Helios, Selene, Eos, and Ouranos, in both Interpretation and Iconography modes).
  • The stories Birth of Dionysus and The Refusal of Pentheus are now illustrated in Iconography mode.
  • Mobile ergonomics were refined: more compact HoloGraph controls and a lower “back to top” button position.
Editorial tools and technical fixes

Editorial tools (inspectors)

  • Media archiving workflow was expanded in the MD inspector (entities/stories, AI and AI-free) with a dedicated Archive action and the option to archive before replace/delete.
  • Browser confirm() prompts were replaced by explicit action modals (choice between “archive then replace” and “replace without archive”, plus dedicated confirmations).
  • A “Show archives” entry was added in MD inspector media blocks, with per-image archived metadata preview.
  • Domains and Symbols inputs are now more flexible: free values can be validated with Enter, not only picked from suggestions.
  • Media and IA-free Media managers now include an archives mode (read-only), active/archive toggle, associated entity/story display, and archive metadata modal.

Technical fixes

  • Backend tools/yaml-server-new.mjs:
    • new GET /md/media-archives endpoint,
    • separate AI / AI-free archive storage in public/archive/{mode}/{kind},
    • automatic filename increment on collisions (slug.webp, slug-1.webp, etc.),
    • metadata preservation during archiving in dedicated registries,
    • static serving of archived files through /archive/.
  • Footer.astro: illustration-mode modal reworked (visual cards, default-above tooltip placement with below fallback, aligned action buttons, reopen control from footer).
  • src/pages/fr|en/index.astro: insertion of a “How would you like to explore?” guidance block.
  • src/components/ego-graph-interactive-client.ts: fixed arrow-key handling in the search results list.
  • src/styles/global.css: line-break preservation in media captions.

February 27, 2026

What changed for visitors

  • A first-visit modal now asks users to choose the site illustration mode: Interpretation or Iconography.
  • The choice is stored locally and can be changed at any time from the footer toggle, without page reload.
  • Iconography mode is now consistent end-to-end across media rendering, contextual tooltips, info badge (i), captions, and related visuals.
  • On the homepage, both the hero visual and the HoloGraph preview video now switch according to the selected mode.
  • In iconography mode, a clickable Source badge is displayed below portraits/illustrations when a source URL is available.
  • On entity pages and in HoloGraph, unknown_* placeholders are now used when no dedicated iconography portrait exists.
  • White hero text readability was improved with a subtle dark outline.
Editorial tools and technical fixes

Editorial tools (inspectors)

  • Media and IA-free Media inspectors now provide a larger caption editing experience for FR/EN fields.
  • New i18n caption completeness checks detect FR/EN mismatches, with a top counter and a filter to show only impacted entries.
  • Mismatch warnings now refresh correctly after save and fully disappear when no mismatch remains.
  • A visual warning now reminds editors to save when unsaved changes exist.
  • In IA-free Media inspector, a new URL field was added for portraits/illustrations (excluding faces), and the IA-free method field was removed.

Technical fixes

  • Footer.astro: first-visit mode modal added (FR/EN), with persistence in mythoskolis:illustrationMode and backward compatibility with mythos-img-mode.
  • Footer.astro: full mode synchronization across swappable images, homepage hero, homepage HoloGraph video, media captions/source links, and footer toggle state.
  • ContextualLayerScript.astro: iconography mode tooltip/media resolution fixed to use IA-free assets.
  • ego-graph-interactive-client.ts: mode-aware portrait resolution in HoloGraph with IA-free candidates, unknown_* fallback, and preload caching.
  • FR/EN entity/story/holograph pages were aligned for iconography media sources, captions, and placeholder handling.
  • Backend tools/yaml-server-new.mjs: IA-free metadata flow updated with dedicated registry support, new url field, and IA-free method removal.
  • New registry file added: data/media-metadata-ia-free.yaml.
  • Large iconography media batch integrated (faces-ia-free, images/grecque-ia-free, unknown_* placeholders, dedicated homepage hero, dedicated HoloGraph preview video).

February 25, 2026

What changed for visitors

  • Every entity portrait and story illustration now shows a clickable ℹ badge revealing media credits (author, method, date if available).
  • On desktop hover, or mobile tap, a caption fades in as an overlay at the bottom of the image — when a caption has been filled in.
  • The caption also serves as the alt text for screen readers when present.
  • The English story pages now have full parity with the French version, including EN-specific captions (with FR fallback).
  • Links shared on social media now correctly display images and URLs for entity pages, stories, and HoloGraph pages.
Editorial tools and technical fixes

Editorial tools (inspectors)

  • Media manager: a second EN caption field is now stacked below the FR caption field for each eligible media item.
  • The caption_en field is stored in data/media-metadata.yaml and surfaced on EN pages with FR fallback.

Technical fixes

  • astro.config.mjs: site: 'https://mythoskolis.com' added — OG/canonical URLs were relative, they are now absolute.
  • Story pages (FR/EN): the illustration image is now passed to <MetaTags> for social sharing previews.
  • HoloGraph: the OG image now uses the central entity’s faces/ portrait with an existence check (falls back to the generic site image if missing).
  • MetaTags.astro: canonical and og:url are now converted to absolute URLs via toAbsolute().

February 23, 2026

What changed for visitors

  • In narrative cycles, unnumbered stories now remain visible inside their arc without displaying “Episode X”.
  • Cycle/arc story organization is now aligned between the public website and editorial tools (FR/EN).
Editorial tools and technical fixes

Editorial tools (inspectors)

  • Story inspector: narrative-cycle view (default), alphabetical toggle, cycle filter.
  • Cycles modal: inline FR/EN editing for cycle/arc names, cycle/arc creation moved to the top, arc deletion (with story fallback to “no arc”), and per-story “unnumbered” checkbox.
  • The “Manage narrative cycle” button inside story editing now opens the modal focused on the current story cycle.
  • The “i18n mismatch” badge is now also visible in cycle view.
  • FR/EN UI coverage was consolidated for story, glossary, media, and genealogy inspectors (with FR fallback when needed).

Technical fixes

  • Inline story save now preserves cycle, arc, and numero to avoid accidental cycle removal.
  • Narrative-cycle backend was expanded: cycle/arc rename, batch cycle/arc assignment, and renumbering with unnumbered support.
  • numero parsing/display was normalized on website pages to avoid null-value edge cases.

February 22, 2026

February 21, 2026

What changed for visitors

  • Core sections are now fully bilingual (entities, stories, resources, about, sandbox, help).
  • Header/footer language switch now maps more pages to their real counterpart instead of falling back to a generic page.
  • The sandbox “How to” guide now serves FR/EN demo videos depending on the active language.
  • In English, the HoloGraph advanced-mode help modal now shows a clear availability message while still keeping access to the current demo.
  • The Resources “Recommendations” page has been expanded (books, podcast, video games, board games), with a consistent card layout and full English localization.
  • New public “Updates log” page is available from the footer (FR/EN).
Behind the scenes and technical deep dive

Behind the scenes (technical)

  • Large i18n refactor across routing, slugs, language fallbacks, and FR/EN consistency.
  • HoloGraph advanced mode now localizes bibliographic source labels to English when available, with FR/default fallback.
  • Genealogy inspector now includes operation history with state restore (rollback), history depth set to 30.
  • Bilingual bibliographic registry introduced (authors/works), decoupled from the core genealogy YAML and syncable from observed data.
  • New media manager in the inspector (images + videos) with metadata (author, method, date, level), legacy mode, autocomplete, and advanced preview (fit/zoom/scroll).
  • Analytics foundation added with explicit consent flow and legal opt-out controls.

Technical deep dive (backend / inspector refactor)

  • Scope covered by branch commits feature/eng: from bb8e57a to fac8b05.
  • Core backend refactor in tools/yaml-server-new.mjs: consolidated inspector services (YAML, MD, sources, media, history) behind one HTTP layer.
  • YAML history engine added: state snapshots, operation labels, touched entity IDs, targeted restore.
  • History APIs exposed: GET /history, POST /history/restore.
  • History depth set to 30 operations (including current state), aligned with editorial correction workflows.
  • Source governance moved to external bilingual registry data/sources-bibliographiques.yaml (authors + works FR/EN).
  • New source APIs: GET /md/sources, POST /md/sources/save, POST /md/sources/sync.
  • Backend source normalization implemented: stable IDs, dedupe, aliases, author/work matching, i18n fallback.
  • Observed-source extraction layer added to compare actual YAML usage against registry coverage and drive sync actions.
  • Dedicated media metadata store introduced: data/media-metadata.yaml (keeps genealogy YAML focused).
  • Backend media scan pipeline added across multiple roots: public/faces, public/images/grecque, public/videos/grecque, public/recits_images.
  • Native mixed-media support in catalog generation (image/video inferred by extension).
  • New media APIs: GET /md/media, POST /md/media/save, plus manager route GET /media-manager.
  • Media metadata normalization enforced: text author/method, integer level, date as ISO or legacy.
  • Metadata keying stabilized via full public-path metadataKey to prevent image/video name collisions.
  • YAML inspector refactor (tools/yaml-inspector-new.html): history pane, source registry pane, sync controls, relation tooling polish.
  • MD inspector refactor (tools/md-inspector.html): extended multi-view architecture (entities, stories, genealogy, glossary, media).
  • New tools/media-manager.html: bulk metadata editing, keyboard autocomplete, fit/zoom/scroll media preview modal.
  • scripts/generate-genealogie-json-new.mjs updated to support richer i18n data flow.
  • scripts/migrate-recits-i18n.mjs added to automate stories i18n migration.
  • src/utils/markdown-sections.ts added to support section-based rendering (# fr / # en) in shared markdown pages.
  • src/utils/i18n.ts added to centralize localized-field resolution and fallback behavior.
  • src/content.config.ts extended for new i18n fields (including display_fr) with stricter collection validation.
  • Advanced HoloGraph now localizes source authors/works client-side from the source registry (EN when available, FR/default fallback).

February 20, 2026

  • Initial updates log page added.
  • Footer link added.