Skip to content
Merged
Show file tree
Hide file tree
Changes from all commits
Commits
Show all changes
18 commits
Select commit Hold shift + click to select a range
9366f12
docs: decisions 8.169 to 8.174 for 0.6.4 (dimension, location and sim…
fstwn Oct 22, 2026
00bc909
feat: invite-only registration without open domains, open domains lis…
fstwn Oct 22, 2026
b468448
feat: dimension search (about this size, can hold this size) and volu…
fstwn Oct 22, 2026
1fc3b60
feat: waste under can hold as a share of the piece and in m3, on two …
fstwn Oct 22, 2026
6f426f8
feat: location search near a point by current or origin location, edi…
fstwn Oct 22, 2026
3596a83
fix: one shared latitude and longitude pair in every location form, a…
fstwn Oct 22, 2026
5543087
feat: Location Map with current and origin layers, clusters, Browse f…
fstwn Oct 22, 2026
07cd368
chore: Next.js 16.4.1 for two critical advisories (not reachable here…
fstwn Oct 22, 2026
402facd
feat: catalog_overview MCP tool, similarity by shape descriptor in RE…
fstwn Oct 22, 2026
0a135ab
feat(gh): FetchSimilarComponents, fit and near search in FetchFiltere…
fstwn Oct 23, 2026
664a938
feat: maintainer as sole controller on privacy page and imprint, no G…
fstwn Oct 23, 2026
309cc3e
fix: controller address on the privacy page on separate lines
fstwn Oct 23, 2026
dc4835f
fix(gh): zero or empty FitSize and NearPoint count as not set, with a…
fstwn Oct 23, 2026
cc768d1
feat(gh): icon for FetchSimilarComponents
fstwn Oct 23, 2026
2d70533
fix(gh): zero or empty FitSize and NearPoint count as not set in ever…
fstwn Oct 23, 2026
dccb127
feat(gh): Rhino 8 export of the 0.6.4 user objects (FetchSimilarCompo…
fstwn Oct 23, 2026
e9535d3
chore: bump version, re-export gh files
fstwn Oct 23, 2026
34caf1b
chore: release prep
fstwn Oct 23, 2026
File filter

Filter by extension

Filter by extension


Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
6 changes: 3 additions & 3 deletions .zenodo.json
Original file line number Diff line number Diff line change
@@ -1,8 +1,8 @@
{
"title": "Catalog of Second Chances (CSC) - Digital Database and Corresponding Interfaces for ReUse of Architectural Components (v0.6.3.1)",
"version": "0.6.3.1",
"title": "Catalog of Second Chances (CSC) - Digital Database and Corresponding Interfaces for ReUse of Architectural Components (v0.6.4.0)",
"version": "0.6.4.0",
"upload_type": "software",
"description": "<p>The <em>Catalog of Second Chances (CSC)</em> is a prototypical digital component database. It catalogs digital representations of uniquely identifiable architectural components for reuse. Furthermore, it provides corresponding interfaces and tools to leverage them via a backend REST-API, a web-frontend as well as a interface for direct interaction within Rhino Grasshopper.</p><h2>Changes in v0.6.3.1 (2026-10-21)</h2><p>A hardening release after 0.6.3.0.</p><h3>Changed</h3><ul><li><strong>Viewer:</strong> mesh edges stay crisp over the faces instead of breaking up at some angles; close zooms no longer cut a piece open, and small pieces open filling the view. A version switch while the mesh or the point cloud is Off loads nothing hidden.</li><li><strong>Evidence:</strong> a core record links to its paired rebound record; a piece with several reinforcement layouts shows all of them.</li><li><strong>Geometry:</strong> replacing the meshes or clouds of a draft also removes the files and markers of the dropped ones; a frame-only cache entry no longer carries descriptor data; the outline vertex limit counts holes.</li><li><strong>Release tooling:</strong> <code>invoke release-prep</code> sets the CHANGELOG date, writes <code>.zenodo.json</code> and runs the version checks in one step; <code>bump-version --gh</code> leaves the Session component alone when its client version already matches. The local launch entries and the old scripts work without a user path; the local server script is now <code>scripts/dev/serve_dump.py</code> (<code>invoke dev-local</code>; <code>invoke dev-migrated</code> still works and says so), migrating an old 0.5 dump only with <code>--migrate</code>; it writes <code>.dev/dev-local-credentials-&lt;port&gt;.txt</code> and <code>.dev/local-&lt;port&gt;.json</code>.</li></ul><h3>Security</h3><ul><li><strong>Failed access-token lookups are limited per address</strong> (429 with <code>Retry-After</code>); valid tokens are never counted.</li><li><strong>Token clean-up:</strong> the tokens and connections of a deleted account are removed with it; revoked and expired tokens are deleted 90 days later.</li></ul><h3>Server notes</h3><ul><li>Existing token rows get their clean-up date from the daily user maintenance run (not while the read-only flag is set); no step needed.</li></ul><p>Full history: <a href=\"https://github.com/digitaldesignunit/csc/blob/v0.6.3.1/CHANGELOG.md\">CHANGELOG.md</a></p>",
"description": "<p>The <em>Catalog of Second Chances (CSC)</em> is a prototypical digital component database. It catalogs digital representations of uniquely identifiable architectural components for reuse. Furthermore, it provides corresponding interfaces and tools to leverage them via a backend REST-API, a web-frontend as well as a interface for direct interaction within Rhino Grasshopper.</p><h2>Changes in v0.6.4.0 (2026-10-23)</h2><p>Search and the location map.</p><h3>Added</h3><ul><li><strong>\"What fits?\":</strong> a Fits section in Browse's More filters finds pieces by size, whatever their orientation: <em>about this size</em> (within a tolerance in mm or %, default 10 %, closest first) or <em>can hold this size</em> (every side at least the asked one, least waste first). Each row shows how far off it is or how much it wastes, as a share of the piece and in m3 (per piece on batches). The list can also sort by volume, and the card view has a sort menu.</li><li><strong>Near:</strong> a Near section in Browse's More filters finds pieces around a point (a pasted \"lat, lon\"), by their current location or by their origin, within a radius in km or simply nearest first. Each row shows its distance, and the list sorts by it. A component page links to \"Near this piece\".</li><li><strong>Origin coordinates:</strong> the origin form of a piece takes the latitude and longitude of its origin place; until now they could be set only when the piece was created. In every location form a pasted \"lat, lon\" fills both boxes, and a comma after the latitude moves on to the longitude.</li><li><strong>Location Map:</strong> a new page next to the Similarity Map shows the pieces on a map, by their current location or by their origin, in clusters with counts. It takes the filters of Browse (with a \"Show as list\" link back), colours the pieces like the Similarity Map, opens a piece's preview on a click, and offers \"Search near here\" on a click into the map. The map images come from the tile server of FOSSGIS e.V. (tile.openstreetmap.de); only this page loads them.</li><li><strong>Similar pieces:</strong> a card on the component page shows the six pieces nearest in shape, over the whole shape descriptor rather than on the two-dimensional Similarity Map; size counts as well as the outline. \"Show more\" brings up to 24. The nearest pieces are also available at <code>GET /identities/{id}/similar</code>, with every Browse filter applied before the ranking.</li><li><strong>MCP:</strong> <code>search_components</code> takes <code>fit_mode</code>, <code>size_mm</code> and <code>tolerance</code>, <code>near_lat</code>, <code>near_lon</code>, <code>near_layer</code> and <code>radius_km</code> (each result with its distance), and <code>sort</code> and <code>order</code>; its description now says what the text query matches (name, id prefix, catalog number). The new tool <code>catalog_overview</code> counts the pieces of a search by material, original function, dataset, shape class and circulation, with the range of each side in mm, how many have a location and how many are not public. <code>similar_components</code> now ranks by the shape descriptor (with <code>basis</code>, <code>count</code> and the filters of <code>search_components</code>) instead of the distance on the Similarity Map.</li><li><strong>Grasshopper:</strong> the new <code>FetchSimilarComponents</code> returns the pieces nearest in shape to a piece, with their distance, and takes the filters, the dimension search and the near search of <code>FetchFilteredComponents</code>. <code>FetchFilteredComponents</code> gains the dimension search (<code>FitMode</code>, <code>FitSize</code>, <code>FitTolerance</code>) and the near search (<code>NearPoint</code>, <code>NearLayer</code>, <code>RadiusKm</code>), with the deviation or waste (<code>Fit</code>) and the distance (<code>DistanceKm</code>) per result.</li><li><strong>Grasshopper, texture colours:</strong> <code>CreateComponentIdentity</code> and <code>CreateComponentSnapshot</code> give a mesh the colours of its texture when it is staged: when the mesh comes from a Rhino object whose material has a base-colour image, each vertex takes the colour at its texture coordinate, on every level of detail. The texture replaces vertex colours the mesh already has, with a remark. Meshes without such a texture are staged as before. Grasshopper library 261022: run <code>CSC_Update</code>.</li></ul><h3>Changed</h3><ul><li><strong>Registration:</strong> without open domains the catalog is invite only, and the register page then asks for an invitation code and suggests no open sign-up. With open domains the page says that registration is open to certain domains and lists them behind a \"?\"; no page names a fixed university any more. <code>CSC_OPEN_REGISTRATION_DOMAINS</code> is now empty by default: a server that keeps open registration must set it explicitly.</li><li><strong>Privacy page and imprint:</strong> they state that the maintainer runs the catalog in person and is its sole controller, and that TU Darmstadt does not operate it and is not responsible for it. The privacy page names the tile server of the Location Map and what it receives, and no longer claims that nothing is loaded from other sites; the imprint cites the DDG instead of the repealed TMG. The Content-Security-Policy allows images from that one tile host in addition.</li><li><strong>No Google map preview:</strong> pointing at a location in the Browse table no longer loads an embedded Google map; the location is a link that opens Google Maps in a new tab on a click. With no embed left, the Content-Security-Policy allows no frames (<code>frame-src &#x27;none&#x27;</code>).</li></ul><h3>Fixed</h3><ul><li><strong>Browse table:</strong> at middle widths its columns no longer run into each other; the table keeps a minimum width for the columns shown and scrolls sideways inside its frame. The same for the admin Materials table.</li><li><strong>Statistics:</strong> one piece with a malformed size in the database can no longer make the statistics (and with them Analytics) fail for everyone.</li></ul><h3>Security</h3><ul><li><strong>Next.js 16.4.1:</strong> the web app moves from Next.js 16.4.0 to 16.4.1, which fixes two critical advisories (GHSA-2464-fhr4-w9xw, code execution through the image optimizer with SVG files; GHSA-p3m5-59mp-jv5r, denial of service through Server Actions). The catalog was not reachable through either: it does not use the image optimizer and has no Server Actions. Upgraded as a precaution; <code>npm audit</code> is clean again.</li></ul><h3>Server notes</h3><ul><li>After the deploy, run <code>scripts/db_maintenance/backfill_geo_points.py --apply</code> once: it stores the location points the near search uses for the existing pieces (new and edited pieces get them on their own). Without <code>--apply</code> it only reports, and it exits with 4 while points are missing or out of date.</li><li>After the deploy, run the map job once (<code>main_component_map.py</code>, or <code>--knn-only</code> for the similarity data alone): until it has run, similar pieces answer 409 and the card stays hidden. The similarity data is then rebuilt with the map on every scheduled run; a new or reshaped piece joins at the next run.</li></ul><p>Full history: <a href=\"https://github.com/digitaldesignunit/csc/blob/v0.6.4.0/CHANGELOG.md\">CHANGELOG.md</a></p>",
"creators": [
{
"name": "Eschenbach, Max Benjamin",
Expand Down
91 changes: 91 additions & 0 deletions CHANGELOG.md
Original file line number Diff line number Diff line change
Expand Up @@ -5,6 +5,97 @@ All notable changes to this project will be documented in this file.
The format is based on [Keep a Changelog](https://keepachangelog.com/en/1.0.0/),
and this project adheres to [Semantic Versioning](https://semver.org/spec/v2.0.0.html).

## [0.6.4.0] - 2026-10-23

Search and the location map.

### Added

- **"What fits?":** a Fits section in Browse's More filters finds pieces by size, whatever their
orientation: *about this size* (within a tolerance in mm or %, default 10 %, closest first) or
*can hold this size* (every side at least the asked one, least waste first). Each row shows how
far off it is or how much it wastes, as a share of the piece and in m3 (per piece on batches). The
list can also sort by volume, and the card view has a sort menu.
- **Near:** a Near section in Browse's More filters finds pieces around a point (a pasted "lat,
lon"), by their current location or by their origin, within a radius in km or simply nearest
first. Each row shows its distance, and the list sorts by it. A component page links to "Near
this piece".
- **Origin coordinates:** the origin form of a piece takes the latitude and longitude of its
origin place; until now they could be set only when the piece was created. In every location
form a pasted "lat, lon" fills both boxes, and a comma after the latitude moves on to the
longitude.
- **Location Map:** a new page next to the Similarity Map shows the pieces on a map, by their
current location or by their origin, in clusters with counts. It takes the filters of Browse
(with a "Show as list" link back), colours the pieces like the Similarity Map, opens a piece's
preview on a click, and offers "Search near here" on a click into the map. The map images come
from the tile server of FOSSGIS e.V. (tile.openstreetmap.de); only this page loads them.
- **Similar pieces:** a card on the component page shows the six pieces nearest in shape, over
the whole shape descriptor rather than on the two-dimensional Similarity Map; size counts as
well as the outline. "Show more" brings up to 24. The nearest pieces are also available at
`GET /identities/{id}/similar`, with every Browse filter applied before the ranking.
- **MCP:** `search_components` takes `fit_mode`, `size_mm` and `tolerance`, `near_lat`,
`near_lon`, `near_layer` and `radius_km` (each result with its distance), and `sort` and
`order`; its description now says what the text query matches (name, id prefix, catalog
number). The new tool `catalog_overview` counts the pieces of a search by material, original
function, dataset, shape class and circulation, with the range of each side in mm, how many
have a location and how many are not public. `similar_components` now ranks by the shape
descriptor (with `basis`, `count` and the filters of `search_components`) instead of the
distance on the Similarity Map.
- **Grasshopper:** the new `FetchSimilarComponents` returns the pieces nearest in shape to a
piece, with their distance, and takes the filters, the dimension search and the near search of
`FetchFilteredComponents`. `FetchFilteredComponents` gains the dimension search (`FitMode`,
`FitSize`, `FitTolerance`) and the near search (`NearPoint`, `NearLayer`, `RadiusKm`), with the
deviation or waste (`Fit`) and the distance (`DistanceKm`) per result.
- **Grasshopper, texture colours:** `CreateComponentIdentity` and `CreateComponentSnapshot` give
a mesh the colours of its texture when it is staged: when the mesh comes from a Rhino object
whose material has a base-colour image, each vertex takes the colour at its texture
coordinate, on every level of detail. The texture replaces vertex colours the mesh already
has, with a remark. Meshes without such a texture are staged as before. Grasshopper library
261022: run `CSC_Update`.

### Changed

- **Registration:** without open domains the catalog is invite only, and the register page then
asks for an invitation code and suggests no open sign-up. With open domains the page says that
registration is open to certain domains and lists them behind a "?"; no page names a fixed
university any more. `CSC_OPEN_REGISTRATION_DOMAINS` is now empty by default: a server that
keeps open registration must set it explicitly.
- **Privacy page and imprint:** they state that the maintainer runs the catalog in person and is
its sole controller, and that TU Darmstadt does not operate it and is not responsible for it.
The privacy page names the tile server of the Location Map and what it receives, and no longer
claims that nothing is loaded from other sites; the imprint cites the DDG instead of the
repealed TMG. The Content-Security-Policy allows images from that one tile host in addition.
- **No Google map preview:** pointing at a location in the Browse table no longer loads an
embedded Google map; the location is a link that opens Google Maps in a new tab on a click.
With no embed left, the Content-Security-Policy allows no frames (`frame-src 'none'`).

### Fixed

- **Browse table:** at middle widths its columns no longer run into each other; the table keeps
a minimum width for the columns shown and scrolls sideways inside its frame. The same for the
admin Materials table.
- **Statistics:** one piece with a malformed size in the database can no longer make the
statistics (and with them Analytics) fail for everyone.

### Security

- **Next.js 16.4.1:** the web app moves from Next.js 16.4.0 to 16.4.1, which fixes two critical
advisories (GHSA-2464-fhr4-w9xw, code execution through the image optimizer with SVG files;
GHSA-p3m5-59mp-jv5r, denial of service through Server Actions). The catalog was not reachable
through either: it does not use the image optimizer and has no Server Actions. Upgraded as a
precaution; `npm audit` is clean again.

### Server notes

- After the deploy, run `scripts/db_maintenance/backfill_geo_points.py --apply` once: it stores
the location points the near search uses for the existing pieces (new and edited pieces get
them on their own). Without `--apply` it only reports, and it exits with 4 while points are
missing or out of date.
- After the deploy, run the map job once (`main_component_map.py`, or `--knn-only` for the
similarity data alone): until it has run, similar pieces answer 409 and the card stays hidden.
The similarity data is then rebuilt with the map on every scheduled run; a new or reshaped
piece joins at the next run.

## [0.6.3.1] - 2026-10-21

A hardening release after 0.6.3.0.
Expand Down
19 changes: 12 additions & 7 deletions README.md
Original file line number Diff line number Diff line change
Expand Up @@ -29,8 +29,8 @@ framework

## Current Versions

- **CSC**: 0.6.3.1 --- backend, web frontend and Grasshopper interface are released together
under one version (tag `v0.6.3.1`); the single source is the `VERSION` file.
- **CSC**: 0.6.4.0 --- backend, web frontend and Grasshopper interface are released together
under one version (tag `v0.6.4.0`); the single source is the `VERSION` file.

See `CHANGELOG.md` for release notes.

Expand Down Expand Up @@ -547,11 +547,16 @@ and send you the link, so look at the large address line (the host you will be
sent back to) before you press Allow, and press Deny when it is not the tool you
just connected.

**What it can do.** Nine read-only tools: `search_components` (the filters of
Browse, a page at a time), `get_component`, `list_versions`, `get_version`
(geometry as counts and a link, never the meshes), `get_evidence`,
`list_datasets`, `get_dataset`, `get_timeline` and `similar_components` (the
nearest neighbours on the similarity map, with their distance). Every answer
**What it can do.** Ten read-only tools: `search_components` (the filters of
Browse, a page at a time), `catalog_overview` (how many pieces, counted by
material, original function, dataset, shape class and circulation, the range of
each sorted side in millimetres, and how many have a location; it takes the same
filters), `get_component`, `list_versions`, `get_version` (geometry as counts
and a link, never the meshes), `get_evidence`, `list_datasets`, `get_dataset`,
`get_timeline` and `similar_components` (the pieces nearest in shape over the
whole descriptor, not on the two-dimensional similarity map, with their distance
in standardised units; it takes the same filters, which apply before the
ranking). Every answer
carries the web link of the record, and a record that is not public is marked
(`visibility` private, `status` other than published). There are no write tools
and no tool for users, invitations or tokens; no answer holds an e-mail address
Expand Down
2 changes: 1 addition & 1 deletion VERSION
Original file line number Diff line number Diff line change
@@ -1 +1 @@
0.6.3.1
0.6.4.0
4 changes: 2 additions & 2 deletions docs/adr/DATA_MODEL_SPEC.md
Original file line number Diff line number Diff line change
Expand Up @@ -1121,8 +1121,8 @@ shown anywhere on its own: it appears through the records it fills (section 3.3.
well (the account and its `default_role` stay).

**Registration (decision 8.14).** Self-registration is open to addresses of
`CSC_OPEN_REGISTRATION_DOMAINS` (env, comma-separated, default `tu-darmstadt.de`, subdomains
included), with the verification email as in 0.5. Every other address needs an **invitation**:
`CSC_OPEN_REGISTRATION_DOMAINS` (env, comma-separated, subdomains included; empty by default, which
means invite only, 8.172), with the verification email as in 0.5. Every other address needs an **invitation**:

```jsonc
// invitations
Expand Down
Loading
Loading