Loci v0.2.0 — visual authoring demo and collection walkthroughs

Loci v0.2.0 adds an optional visual authoring console to the generated local demonstration. A signed-in author can map one video range to a model point, preview the annotation privately and publish it individually. Readers can play that evidence while keeping their chosen model view. Separate walkthroughs show the generated authoring example and the hosted research collection.

Changes

• Added three generated chapters with visible feature labels, shape markers and video time, plus a guarded refresh for eligible existing synthetic installations.
• Rejected blank placement coordinates while accepting valid zero coordinates, and aligned the generated Top edge pin with the demonstrated edge.
• Preserved the camera during direct model-pin playback and retained the selected annotation at a guided range's exclusive end.
• Refreshed clean transcript drafts after saved text changes; preserved unsaved text during navigation and blocked detected conflicting saves until explicit reconciliation.
• Corrected dark branding and retained the muted-light palette.
• Added the Lab's silent authoring video, poster, timed description and single-range authoring guide.
• Added Unlock Digital's hosted collection walkthrough with audio, a still README poster, optional animated preview and feature guide.
• Updated brace-expansion to 5.0.12 and PyJWT to 2.15.0, with matching dependency notices and expanded checks.

Contributions and media terms

3D Humanities Lab contributed the generated demo improvements, authoring/playback corrections, guarded refresh, transcript conflict correction, dependency/setup documentation and original local authoring tutorial. Unlock Digital contributed the hosted walkthrough recording and editing, retaining the source captions and attribution. Unlock Digital also independently assessed and adopted the Lab source and final changelog for protected owner review, preserving the original Lab commits and authorship.

Software, first-party documentation and generated Lab examples retain Apache 2.0 terms. The hosted hosted-walkthrough.mp4, hosted-walkthrough.jpg and hosted-walkthrough-preview.gif are explicit exceptions. The edited presentation has permission to display participants and is publicly viewable/downloadable; inclusion grants no reuse license for these assets or depicted research content. Original interviews, models and collection datasets remain outside the repository. See license scope and media permissions.

Upgrade and scope

Rebuild the API and web images from this release. Preserve the installation's .env, database and media volumes. A source update alone changes neither running images nor existing seeded content. The optional console uses the existing API and services; these contributions introduce no database migration, role/publication privilege change or JWT algorithm/token-format change.

An eligible original synthetic installation can use the explicit generated-demo refresh. It validates the sample contract, writes new media before switching database references, and preserves the original source and old playback files. Back up the isolated database if restoration of its previous content is needed. Personalized content uses the ordinary replacement and review workflow.

The supported authoring exercise covers one range on the seeded cube. General multi-range export/publication, provisioning new public object identities, approximately 700-object performance, broader browser/device coverage and hosted operational security remain separate work. The Lab video's opening overview precedes the documented Top edge correction. Earlier release archives retain their original contents.

Validation

Release commit: 2a4460689d832cb935a1b7014f4b549caeb69566. All four required jobs passed for this exact reviewed commit: web unit/build/dependency checks; API/PostgreSQL/Redis and migration rehearsal; browser regression; and clean generated demo with real authoring privacy/publication/cleanup. See the final-main CI run.

Inspected final-main evidence records 138 passing web tests, 624 API cases across 31 modules without skips, and zero vulnerabilities in the full npm audit. Both ordinary and reduced-motion camera checks pass, alongside the actual private-preview, individual-publication and cleanup journey.

Loci v0.1.1

Loci v0.1.1 improves the public local demonstration and the contributor workflow. Five separately reviewed pull requests are included in this one release.

Changes

• Built public web assets are readable by the unprivileged NGINX runtime user (#1).
• Evidence pages use a stable, theme-aware loading state. An optional muted-light palette has contrast-safe text, and documented ?studio=0 / ?legacy=1 loading behavior remains available (#2).
• Public object cards and evidence actions remain available while posters load or fail and while a later page is requested. Mobile one-card pages size to their content (#3).
• CONTRIBUTING.md documents fork pull requests, protected main, required review and CI, and 3DH Lab release ownership (#4).
• Browser media fixtures are replaced with small generated geometric samples. Reproduction instructions, semantic fixture checks, a focused public-fixture guard, and Docker context exclusions strengthen the public-source boundary (#5).

The repository documentation also links the separately governed hosted research example and current support and private-security reporting paths. #4 and #5 retain credit for the original 3DH Lab draft commits and Unlock Digital's independent review and adaptation.

Compatibility and data

No database migration or public API/data-format change is required. Existing theme preferences remain valid; muted-light is optional. This release includes generated browser fixtures and no hosted collection media or participant material. Earlier tags and their source archives are unchanged.

Verification and scope

All four required CI jobs, including migration rehearsal, synthetic browser regression, dependency checks, and the clean generated-demo Chromium journey, passed on the final protected main commit 71bfb23c5dc6cfb4c7b724ae7829c56fff928600: CI run 36604843585.

This release supports the documented local demonstration. Hosted deployment operations and large-collection performance need separate validation for each installation.

Loci v0.1.0

Loci v0.1.0 is the first public source release under Apache License 2.0. It provides a local, self-hosted demonstration that links annotations on a 3D object to video clips, timed transcripts, citations, and shareable selections.

The repository includes generated sample content, setup and authoring guides, security and contribution information, and automated checks for frontend behavior, backend publication rules, database migrations, and a complete browser demonstration. The original generated samples and interface artwork are also covered by Apache 2.0; third-party components retain their own terms.

Start with the README. This release supports the documented local demonstration. Hosted multi-user operation and collection-specific rights management remain future work.