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.1)",
"version": "0.6.4.1",
"title": "Catalog of Second Chances (CSC) - Digital Database and Corresponding Interfaces for ReUse of Architectural Components (v0.6.4.2)",
"version": "0.6.4.2",
"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.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>",
"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.2 (2026-10-29)</h2><p>Second hardening: the web app and the backend. The Grasshopper fixes follow in 0.6.4.3.</p><h3>Added</h3><ul><li><strong>Data Model page:</strong> <code>/reference</code> explains the data model for catalog users: the dataset, the component identity, its versions and the evidence records, how they relate, the rules of the model, the fields a user sees or fills in, every vocabulary with a short meaning per value, and one made-up concrete beam followed through all of them as an example, in seven tabs. It is public and linked in the sidebar next to Grasshopper. <code>GET /vocab</code> gives each vocabulary value a one-line description.</li><li><strong>Browse, evidence method:</strong> a filter for elements with a published record of one evidence method, for example the elements with a reinforcement layout.</li><li><strong>Profile, website of the organisation:</strong> the profile holds the website of the user's organisation (http or https). New evidence records copy it into the \"You\" performer, and \"Add my organisation\" in the performers field adds the organisation as a performer of its own.</li></ul><h3>Changed</h3><ul><li><strong>History:</strong> a reinforcement layout in the History graph opens in the viewer, as \"Show in viewer\" does. A corrected record opens the corrected records before the page scrolls to it, and on another element the page scrolls once its records have loaded.</li><li><strong>Viewer:</strong> with a reinforcement layout opened by its link, the diameter colours and their legend follow the bars of that layout.</li><li><strong>Credits and imprint</strong> use the layout and text sizes of the privacy page.</li><li><strong>Component page:</strong> the evidence card has its own \"Add evidence\" button, like the properties card, and the properties card explains with a \"?\" that its values come from the evidence. In the History graph, a group of one record opens that record with the first click.</li><li><strong>Wording:</strong> a single building component is called an \"element\" in the web app, the mails, the API descriptions and the MCP connector, instead of \"piece\". The Grasshopper descriptions follow in 0.6.4.3.</li><li><strong>Statistics:</strong> <code>/identities/stats</code> no longer returns the size facet <code>bbxX</code>, which no page showed.</li><li>An unknown evidence method or token scope gives a 422 on every server, also with an older Starlette.</li></ul><h3>Security</h3><ul><li><strong>Session expiry on a component page:</strong> when the session ends, a page that shows more than an anonymous visitor may see (a private element, a draft or pending version, a record only the user may load) signs the user out and leads to the sign-in page, which returns to the same address. A public element stays readable and is shown again as an anonymous visitor sees it.</li><li><strong>Sign-in:</strong> the return address after sign-in only accepts addresses on this site.</li><li><strong>Dependencies:</strong> the development tool <code>shadcn</code> moves to 4.22.1, pinned exactly; no package in the lockfile was published after 2026-10-19. Two dev-only advisories of <code>npm audit</code> stay open, both through <code>shadcn</code>: <code>body-parser</code> (high; its fix came out on 2026-10-22) and <code>deepmerge</code> (low; no fix yet). The production install has none.</li></ul><h3>Server notes</h3><ul><li>No step needed: no new setting, collection or index. The profile field is optional.</li></ul><p>Full history: <a href=\"https://github.com/digitaldesignunit/csc/blob/v0.6.4.2/CHANGELOG.md\">CHANGELOG.md</a></p>",
"creators": [
{
"name": "Eschenbach, Max Benjamin",
Expand Down
51 changes: 51 additions & 0 deletions CHANGELOG.md
Original file line number Diff line number Diff line change
Expand Up @@ -5,6 +5,57 @@ 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.2] - 2026-10-29

Second hardening: the web app and the backend. The Grasshopper fixes follow in 0.6.4.3.

### Added

- **Data Model page:** `/reference` explains the data model for catalog users: the dataset, the
component identity, its versions and the evidence records, how they relate, the rules of the
model, the fields a user sees or fills in, every vocabulary with a short meaning per value, and
one made-up concrete beam followed through all of them as an example, in seven tabs. It is public
and linked in the sidebar next to Grasshopper. `GET /vocab` gives each vocabulary value a one-line description.
- **Browse, evidence method:** a filter for elements with a published record of one evidence method,
for example the elements with a reinforcement layout.
- **Profile, website of the organisation:** the profile holds the website of the user's
organisation (http or https). New evidence records copy it into the "You" performer, and "Add my
organisation" in the performers field adds the organisation as a performer of its own.

### Changed

- **History:** a reinforcement layout in the History graph opens in the viewer, as "Show in viewer"
does. A corrected record opens the corrected records before the page scrolls to it, and on another
element the page scrolls once its records have loaded.
- **Viewer:** with a reinforcement layout opened by its link, the diameter colours and their legend
follow the bars of that layout.
- **Credits and imprint** use the layout and text sizes of the privacy page.
- **Component page:** the evidence card has its own "Add evidence" button, like the properties card,
and the properties card explains with a "?" that its values come from the evidence. In the History
graph, a group of one record opens that record with the first click.
- **Wording:** a single building component is called an "element" in the web app, the mails, the API
descriptions and the MCP connector, instead of "piece". The Grasshopper descriptions follow in
0.6.4.3.
- **Statistics:** `/identities/stats` no longer returns the size facet `bbxX`, which no page showed.
- An unknown evidence method or token scope gives a 422 on every server, also with an older
Starlette.

### Security

- **Session expiry on a component page:** when the session ends, a page that shows more than an
anonymous visitor may see (a private element, a draft or pending version, a record only the user may
load) signs the user out and leads to the sign-in page, which returns to the same address. A
public element stays readable and is shown again as an anonymous visitor sees it.
- **Sign-in:** the return address after sign-in only accepts addresses on this site.
- **Dependencies:** the development tool `shadcn` moves to 4.22.1, pinned exactly; no package in the
lockfile was published after 2026-10-19. Two dev-only advisories of `npm audit` stay open, both through
`shadcn`: `body-parser` (high; its fix came out on 2026-10-22) and `deepmerge` (low; no fix yet). The
production install has none.

### Server notes

- No step needed: no new setting, collection or index. The profile field is optional.

## [0.6.4.1] - 2026-10-27

Hardening: the MCP connector, the component page and dependencies.
Expand Down
15 changes: 8 additions & 7 deletions CONTEXT.md
Original file line number Diff line number Diff line change
@@ -1,15 +1,16 @@
# Catalog of Second Chances (CSC)

A research catalog of reclaimed building components: what each physical piece is, where it came
A research catalog of reclaimed building components: what each physical element is, where it came
from, what state it is in, and what is known about it --- so it can be designed with and reused.

## Language

### Components and records

**Component**:
A physical reclaimed building element the catalog tracks --- a beam, a panel, a lump of rubble.
_Avoid_: item, part
A physical reclaimed building element the catalog tracks --- a beam, a panel, a lump of rubble. In user-facing text a
single one is an "element" (not to be confused with a Grasshopper component).
_Avoid_: item, part, piece

**Component identity**:
The catalog's permanent record of one physical component, from its arrival to long after its exit.
Expand Down Expand Up @@ -113,18 +114,18 @@ A user's hold on a component in circulation, signalling that they intend to use
An installed, returned or lost component coming back with a new origin; the previous origin--exit cycle is archived.

**Lineage**:
The split and merge relations between identities. Children inherit their parents' past --- origin, material, trade name, manufacture date, original function --- unless they state their own.
The split and merge relations between identities. Children inherit their parents' past --- origin, material, trade name, manufacturer, manufacture date, material separability, original function --- unless they state their own; in a merge, a unit is inherited only where all parents agree.

**Batch**:
One identity standing for several homogeneous pieces --- same type, material and nominal size --- whose snapshot quantity is greater than one (the CPR word).
One identity standing for several homogeneous elements --- same type, material and nominal size --- whose snapshot quantity is greater than one (the CPR word). The single items of a batch are its elements.
_Avoid_: lot, stack, group

**Draw**:
Taking one or more pieces out of a batch as a child identity; the batch stays in circulation until nothing remains.
Taking one or more elements out of a batch as a child identity; the batch stays in circulation until nothing remains.
_Avoid_: cut, split (a cut changes shape), take

**Remaining**:
The pieces of a batch not yet drawn; derived, never entered.
The elements of a batch not yet drawn; derived, never entered.
_Avoid_: stock, available

### Evidence and properties
Expand Down
16 changes: 8 additions & 8 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.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.
- **CSC**: 0.6.4.2 --- backend, web frontend and Grasshopper interface are released together
under one version (tag `v0.6.4.2`); the single source is the `VERSION` file.

See `CHANGELOG.md` for release notes.

Expand Down Expand Up @@ -530,7 +530,7 @@ and a JWT does not work in place of it.
## Using CSC from Claude

Claude can read the catalog as you: ask it to find components, show one with its
versions and measurements, compare, or look at what happened to a piece. It
versions and measurements, compare, or look at what happened to an element. It
only reads, and it sees what you see on the website; nothing it can reach is
private to anybody else. Administrators can connect it for now (the roles are
`CSC_PAT_ROLES`).
Expand All @@ -548,16 +548,16 @@ 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 and `has_evidence`, which keeps only pieces with a published, current
Browse and `has_evidence`, which keeps only elements 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
reinforcement", a page at a time), `catalog_overview` (how many elements, 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
`similar_components` (the elements 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
Expand Down Expand Up @@ -701,7 +701,7 @@ so the two heavy jobs never run together (server memory): the
frequent geometry run skips its run while the lock is held, the nightly run and
the map wait up to 15 minutes instead of losing their slot. A write that changes
what the geometry stages read (a new version, a file, the geometry, the colour,
an override, the function of the piece) marks the snapshot (`derivation_due`);
an override, the function of the element) marks the snapshot (`derivation_due`);
the frequent run derives only marked snapshots, the nightly run checks all of them
(`main_geometry.py --due` / without it).

Expand Down Expand Up @@ -848,7 +848,7 @@ which is the origin of abovementioned Catalog Explorer.

## Citing

When using, extending or building upon this piece of softare in your work, please reference it accordingly:
When using, extending or building upon this piece of software in your work, please reference it accordingly:

### BibTex

Expand Down
2 changes: 1 addition & 1 deletion VERSION
Original file line number Diff line number Diff line change
@@ -1 +1 @@
0.6.4.1
0.6.4.2
Loading
Loading