Skip to content
Merged
Show file tree
Hide file tree
Changes from all commits
Commits
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.4.0)",
"version": "0.6.4.0",
"title": "Catalog of Second Chances (CSC) - Digital Database and Corresponding Interfaces for ReUse of Architectural Components (v0.6.4.1)",
"version": "0.6.4.1",
"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.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>",
"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.1 (2026-10-27)</h2><p>Hardening: the MCP connector, the component page and dependencies.</p><h3>Added</h3><ul><li><strong>Search by evidence method:</strong> the catalog list takes <code>evidence_method=&lt;method&gt;</code> (one name of the evidence vocabulary, an unknown name is a 422) and keeps only pieces with at least one published, current record of that method, for example <code>reinforcement_layout</code> for the pieces with a reinforcement layout. It combines with every other filter, also with fit and near. The MCP tools <code>search_components</code>, <code>catalog_overview</code> and <code>similar_components</code> take it as <code>has_evidence</code>. A filter in Browse follows later.</li><li><strong>A reinforcement layout in the viewer:</strong> the card of a reinforcement layout in the evidence list has \"Show in viewer\", for every status, so a submitted draft can be seen before it is published. The viewer opens the version the bars belong to and draws that layout on top of the published ones, which turn faint; the legend names it with its status, and an x takes it out again. The link can be sent on: whoever may not see the record gets a short note and no bars.</li></ul><h3>Changed</h3><ul><li><strong>MCP connector:</strong> the server introduces itself as the Catalog of Second Chances, with a link to the website and an icon, and its instructions tell a chat to use these tools for reused building components before a web search (in English and German). Every tool has a title and is marked read-only, and the descriptions name the evidence methods.</li><li><strong>MCP, reinforcement:</strong> <code>get_component</code> and <code>get_version</code> count the reinforcement layouts of the version from its evidence records (records, bars, diameters) instead of the old inline field, which always gave 0. In <code>get_evidence</code> a layout record carries a summary of its bars, and <code>performed_by</code> shows the organization.</li><li><strong>Similar pieces:</strong> on a wide screen the card sits in the left rail below Provenance, with smaller tiles, three to a row, so it no longer pushes the evidence records down. On a narrow screen it keeps its place after Photos and location. \"Show more\" appears only when there are more than six similar pieces.</li><li><strong>Statistics:</strong> the size facet of <code>/identities/stats</code> (<code>bbxX</code>) buckets the largest side of each piece in millimetres (0, 100, 250, 500, 1000, 2000, 5000, 10000 and more); the old edges came from the metre era and put nearly every piece in the last bucket. Pieces without a size are left out instead of counting as the largest.</li><li><strong>Write model:</strong> creating or changing a version rejects the old inline field <code>geometry.reinforcements</code>; a reinforcement layout is an evidence record.</li></ul><h3>Security</h3><ul><li><strong>E-mail verification</strong> accepts only the hashed token. The fallback to a token stored in plain text is gone (such tokens expired a day after 0.6.1.1); an account that is still unverified can ask for a new mail.</li><li><strong>Dependencies:</strong> the frontend lockfile takes <code>undici</code> 7.30.1 and <code>fast-uri</code> 3.1.9 (one high, two medium and two low advisories; both come only through the development tool <code>shadcn</code>, the production install was not affected). The local import scripts move to Pillow 13.0.0.</li></ul><h3>Server notes</h3><ul><li>No step needed: no new setting, collection or index.</li><li>In claude.ai the connector can be renamed to \"Catalog of Second Chances\" (Settings, Connectors); the name the server gives itself is shown when it is added again.</li></ul><p>Full history: <a href=\"https://github.com/digitaldesignunit/csc/blob/v0.6.4.1/CHANGELOG.md\">CHANGELOG.md</a></p>",
"creators": [
{
"name": "Eschenbach, Max Benjamin",
Expand Down
54 changes: 54 additions & 0 deletions CHANGELOG.md
Original file line number Diff line number Diff line change
Expand Up @@ -5,6 +5,60 @@ 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.1] - 2026-10-27

Hardening: the MCP connector, the component page and dependencies.

### Added

- **Search by evidence method:** the catalog list takes `evidence_method=<method>` (one name of the
evidence vocabulary, an unknown name is a 422) and keeps only pieces with at least one
published, current record of that method, for example `reinforcement_layout` for the pieces
with a reinforcement layout. It combines with every other filter, also with fit and near. The
MCP tools `search_components`, `catalog_overview` and `similar_components` take it as
`has_evidence`. A filter in Browse follows later.
- **A reinforcement layout in the viewer:** the card of a reinforcement layout in the evidence
list has "Show in viewer", for every status, so a submitted draft can be seen before it is
published. The viewer opens the version the bars belong to and draws that layout on top of the
published ones, which turn faint; the legend names it with its status, and an x takes it out
again. The link can be sent on: whoever may not see the record gets a short note and no bars.

### Changed

- **MCP connector:** the server introduces itself as the Catalog of Second Chances, with a link to
the website and an icon, and its instructions tell a chat to use these tools for reused building
components before a web search (in English and German). Every tool has a title and is marked
read-only, and the descriptions name the evidence methods.
- **MCP, reinforcement:** `get_component` and `get_version` count the reinforcement layouts of the
version from its evidence records (records, bars, diameters) instead of the old inline field,
which always gave 0. In `get_evidence` a layout record carries a summary of its bars, and
`performed_by` shows the organization.
- **Similar pieces:** on a wide screen the card sits in the left rail below Provenance, with
smaller tiles, three to a row, so it no longer pushes the evidence records down. On a narrow
screen it keeps its place after Photos and location. "Show more" appears only when there are
more than six similar pieces.
- **Statistics:** the size facet of `/identities/stats` (`bbxX`) buckets the largest side of each
piece in millimetres (0, 100, 250, 500, 1000, 2000, 5000, 10000 and more); the old edges came
from the metre era and put nearly every piece in the last bucket. Pieces without a size are
left out instead of counting as the largest.
- **Write model:** creating or changing a version rejects the old inline field
`geometry.reinforcements`; a reinforcement layout is an evidence record.

### Security

- **E-mail verification** accepts only the hashed token. The fallback to a token stored in plain
text is gone (such tokens expired a day after 0.6.1.1); an account that is still unverified can
ask for a new mail.
- **Dependencies:** the frontend lockfile takes `undici` 7.30.1 and `fast-uri` 3.1.9 (one high, two
medium and two low advisories; both come only through the development tool `shadcn`, the
production install was not affected). The local import scripts move to Pillow 13.0.0.

### Server notes

- No step needed: no new setting, collection or index.
- In claude.ai the connector can be renamed to "Catalog of Second Chances" (Settings, Connectors);
the name the server gives itself is shown when it is added again.

## [0.6.4.0] - 2026-10-23

Search and the location map.
Expand Down
25 changes: 14 additions & 11 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.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.
- **CSC**: 0.6.4.1 --- backend, web frontend and Grasshopper interface are released together
under one version (tag `v0.6.4.1`); the single source is the `VERSION` file.

See `CHANGELOG.md` for release notes.

Expand Down Expand Up @@ -548,15 +548,18 @@ sent back to) before you press Allow, and press Deny when it is not the tool you
just connected.

**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
Browse and `has_evidence`, which keeps only pieces with a published, current
record of one evidence method, for example `reinforcement_layout` for "with
reinforcement", 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` (with the reinforcement layouts of the current
version as counts), `list_versions`, `get_version` (geometry as counts and a
link, never the meshes; the reinforcement layouts of the version as counts),
`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.4.0
0.6.4.1
Loading
Loading