Release planning

CadCraft 0.11 impact map

Every fix and feature lined up for 0.11, and what each one touches: which apps, and which layers of the stack.

ProjectCadCraft
Sheet0.11 impact
Items799
Date2026-11-22
181Fix
383Feature
8Spike
35Platform
3Site ops
153Sanity check
36Decision
0Note
≈ 96days in the written 0.11 plans
  • Planned 45 on the plan for the release it is filed under
  • Built 449 built and working in /lab (the dev builds). Whether the public has it is its reach: "in the lab", "Live" (the last gate) or "switched off"; see docs/REACH-LIVE.md
  • Partly built 32 part of it is built in /lab; the rest waits (see "Waits on")
  • Promised 3 the live site already says it is coming
  • Moved 2 moved here from an earlier release or wishlist
  • Found 2 bug found after a release shipped; fixed in a point release or the next one
  • Candidate 49 recommended in a spike or session log; owner to choose
  • Community please test 143 built and in /use; a Discord post gives the steps and the expected result and asks people to try it on their own devices, files or know-how
  • Decision Time 74 a decision, check, file, key, flag or go only you can give; folds into the list once answered

Built means built and working in the lab. Live means the public can use it, and is the last gate: 3 Built · Live, 446 Built · in the lab.

Sheet 1 · impact areas

Where 0.11 lands

How many items touch each app and each layer, by kind. One item can touch several areas, so the rows add up to more than the item count. Pick a row to filter the schedule below.

Impact areaFixFeatureSpikePlatformSite opsSanity checkDecisionNoteAll
Apps
CadCraft 89 154 4 10 1 51 11 – 320
BimCraft 79 178 5 10 2 70 18 – 362
ModelCraft 60 81 2 10 1 41 4 – 199
MarkupCraft 46 59 2 9 1 18 1 – 136
TakeoffCraft 50 59 2 9 1 21 3 – 145
CivilCraft 69 131 3 11 1 35 3 – 253
DetailCraft 58 61 2 9 1 26 2 – 159
PartCraft 57 78 2 9 1 37 3 – 187
Studio 12 43 3 9 1 30 5 – 103
SuperCad Studio 9 109 2 7 – 23 5 – 155
Layers
Site and services 15 25 – 10 2 2 8 – 62
Desktop host 7 22 2 10 – 7 2 – 50
App shell 25 32 – 7 – 4 2 – 70
App code 69 193 4 6 1 9 16 – 298
Our engines 8 71 3 1 – 4 10 – 97
Vendor engines – 2 – – – – 1 – 3
Drawing surface 1 – – – – 1 – – 2
Help and words 2 9 1 – – 2 – – 14
Tests and tooling 4 9 1 3 – 4 2 – 23

Sheet 2 · schedule

Every fix and feature

Grouped by track. App chips carry each app’s layer colour; Studio is in ink. "Waits on" names what has to happen first; the small lines under it say who asked and where the item is written up.

Add an item Fork map (Rust and C++ forks) The roadmap

Issues sync every 10 minutes; last sync Nov 22, 2026 10:40 am.

ItemWhatAppsLayersStatusDaysWaits onIssues
Performance roadmap — wave 1 5
PlatformPERF.1 Link to PERF.1Comment on PERF.1 HTTP/2 for getcadcraft.com: Apache runs mpm_prefork + mod_php, so every app start is 140 to 520 requests over HTTP/1.1

Measured 2026-11-08 (tools/perf/startup.mjs, localhost): a cold /use start fetches cadcraft 398 requests / 2.6 MB (233 JS modules), bimcraft 521 / 3.8 MB, partcraft 371 / 3.2 MB, civilcraft 313, modelcraft 238, detailcraft 185, markupcraft 159, takeoffcraft 141. All over HTTP/1.1: Apache is mpm_prefork with mod_php, and mod_http2 cannot run under prefork. A browser opens 6 connections per host, so for a visitor with a 70 ms round trip the request count alone is about 400/6 x 70 ms = 4.5 s before any module runs; on localhost the same start takes 1.2 s. The fix is a server change, not code: mpm_event + php-fpm 8.3 (installed at /usr/sbin/php-fpm8.3, not in use) + Protocols h2 http/1.1. The VPS serves about 80 virtual hosts from the same Apache, every one on mod_php today, so this needs the owner's go, a maintenance window and a rollback plan (keep the prefork config). Expected: one connection, all modules multiplexed, start time near the localhost figure plus one RTT per import depth. Alternatives rejected: bundling the releases (add-ons import the apps' modules by URL; a bundle would run two copies), a CDN for app files (same request count). Decision needed: go / not now.

– Decision Time – –
PlatformPERF.2 Link to PERF.2Comment on PERF.2 Apps: the 532 KB language catalog inlined in every app page (65 % of the HTML, never cached) as a cached static file per build and locale

Measured 2026-11-08: /use/cadcraft is 828 KB of HTML (205 KB gzipped) and 532 KB of it is <script id="cc-lang"> (8,818 strings; cmd 83 KB, shell 82 KB, frame 32 KB, m3d 28 KB...), regenerated and sent on every page view because the page itself is dynamic. Readers: assets/js/app-shell.js, app-boot.js, app-lang-boot.js, i18n.js (one copy per app), supercadcraft.js, super-tools.js, exact-client.js; all read #cc-lang synchronously. Plan: Lang::bootTag writes a small tag and the catalog moves to a classic script /assets/apps/<slug>/<version>/lang/<locale>.boot.js?v= (or a generated file under a cache folder for the shell part) that sets window.ccLangCatalog, loaded with the week-long asset cache; the readers take window.ccLangCatalog first, #cc-lang second (so frozen releases and the browser edition keep working). Second visit: 0 bytes for strings instead of about 100 KB gzipped. Releases are frozen so the file can be written at release time (bin/release-app.php); a Discord member builds generate it on demand keyed by the lab stamp. Keep Lang::use (PHP needs the shell strings for the bar and Settings). Built behind PERF_LANG_FILE (off). The catalog tag becomes a cached script file per build, language and content hash (/assets/lang/cache/); a classic script writes the identical #cc-lang tag, so no reader changed (catalog text compared character for character, 8 apps, /use and /lab). Measured on /use with the switch on: the page is CadCraft 977 to 217 KB decoded (232 to 39 KB on the wire), PartCraft 922 to 190, MarkupCraft 372 to 143. Cold first view moves the same catalog bytes in one more request (wire 2.84 to 2.78 MB CadCraft); the saving is every later page view and the HTML parse. /lab files are no-store by the site's rule, so no repeat saving there. Not built: the per-namespace split (PERF.55). (perf-start-10 2026-11-13: docs/0.10-sessions/perf-start-10.md; numbers docs/results/0.10/)

– Built · in the lab – Owner: flip PERF_LANG_FILE=1 (or lab) in .env
PlatformPERF.3 Link to PERF.3Comment on PERF.3 Apps: the "Save for offline" file list (128 KB inline, 2,054 files stat-ed per page, 42 ms) fetched on demand instead

Measured 2026-11-08: every app page carries <script id="cc-offline"> (128 KB: the URL of every file the service worker would save) and PHP spends 14 ms in AppBuilds::offlineFiles plus 28 ms in tools/shell/offline-size.php (a filesize of all 2,054 files) to build it. It is read only when a person clicks Save for offline (assets/js/app-offline.js) and by help-panel.js for the listed-files check. Plan: keep key/page/bytes in the tag; move urls to a small endpoint (or a static JSON per release written by bin/release-app.php, a Discord member builds on demand) fetched when the button is pressed; cache offline_size per release (frozen) and per lab stamp for a Discord member. Saves about 15 KB gzipped per page view and 42 ms of PHP. Built behind PERF_OFFLINE_LAZY (off). #cc-offline carries only the key, the page, the endpoint and the size (0.1 KB, was 36 KB MarkupCraft to 189 KB BimCraft); the list is fetched once when Save for offline is clicked (the page's own URL with ?cc-offline-list=1). The size for the tooltip is cached on disk, so the 20 to 86 ms folder walk is 0.2 ms. Same list as before minus other languages (0 missing, 0 extra, 8 apps). Real Chromium: list fetched 0 times before the click, 1 after, ends Offline ready. (perf-start-10 2026-11-13: docs/0.10-sessions/perf-start-10.md; numbers docs/results/0.10/)

– Built · in the lab – Owner: flip PERF_OFFLINE_LAZY=1 (or lab) in .env
PlatformPERF.4 Link to PERF.4Comment on PERF.4 Apps: modulepreload hints for the static import closure, so the import waterfall is one round trip deep instead of 4 to 8

Measured 2026-11-08 (static import graph from each release's entry module): cadcraft 281 modules, depth 6 (99 at depth 1, 104, 51, 21, 4, 1), 4.6 MB; bimcraft 422 modules, depth 4, 6.5 MB; partcraft 269 modules, depth 8; markupcraft 78 modules, depth 3. The browser only discovers level n+1 after level n arrives, so each level costs a round trip even with HTTP/2 (PERF.1). Plan: AppBuilds::headTags adds <link rel="modulepreload" href=...> for the entry's static closure (regex over import/export-from lines, cached per release in storage/ and per lab stamp for a Discord member builds; about 25 KB of tags for cadcraft, gzips well). Dynamic import() sites (38 in cadcraft, 97 in bimcraft) stay lazy. Measure with tools/perf/startup.mjs before and after; most valuable after PERF.1, still a win on HTTP/1.1 for the small deep levels. Built behind PERF_PRELOAD (off), generated: AppBuilds::preloadHrefs follows static imports only (hints: CadCraft 309, BimCraft 520, MarkupCraft 83, TakeoffCraft 60, ModelCraft 162, CivilCraft 234, DetailCraft 121, PartCraft 297; every hint answers 200; 0 unused-preload warnings in MarkupCraft). Time NOT shown: with 70 ms added latency, alternating off/on runs, time to the drawing surface (median of three): at load 17 to 26 CadCraft 6,158 to 8,026 ms, MarkupCraft 3,246 to 3,315, PartCraft 6,773 to 5,873; at load 8 to 11 CadCraft 5,871 to 5,922, PartCraft 5,944 to about 6,500. No difference beyond the noise; the request count is the same. HTTP/1.1 keeps six connections whatever the hints say; PERF.1 (HTTP/2) is where this pays. (perf-start-10 2026-11-13: docs/0.10-sessions/perf-start-10.md; numbers docs/results/0.10/)

– Built · in the lab – Owner: flip PERF_PRELOAD=1 (or lab); gain not shown yet, measure again when the VPS is quiet
Performance roadmap — wave 2 8
PlatformPERF.12 Link to PERF.12Comment on PERF.12 Website: /library front page runs 83 queries (250 ms) — N+1 loads and a 51 ms stats query per visit

Partly built (perf-site-10 2026-11-13). /library front page 237.6 ms and 77 queries to 129.4 ms and 10 (load 5 before, 23 after), HTML identical: the N+1 is gone (PERF.41) and the COUNT leaves out the version join (PERF.42). publicStats (43 ms) and AddonLibrary::all are not cached: aggregate SQL for publicStats measured slower (66 ms), only a stored row helps (docs/LIBRARY-1000X-DESIGN.md 3.6). Was: Measured 2026-11-08 (bin/admin-perf.php /library): 251 ms, 83 queries taking 130 ms: LibraryItems::browse x2 (55 ms: COUNT + LEFT JOIN + ORDER over 13,850 items), LibraryItems::publicStats 51 ms, AddonLibrary::all 9 ms, then Auth::byId x25, LibraryItems::byId x16, LibraryFiles::byId x15 for the cards. /library/browse and the category pages share browse(). Plan: batch the card lookups (one IN (...) per table), cache publicStats and AddonLibrary::all for 10 minutes (file cache in storage/, no APCu on this PHP), index the browse ORDER columns and make the LIKE search on 4 columns a FULLTEXT index; target under 60 ms and under 15 queries. library-11 2026-11-20: publicStats 48.13 ms to 0.05 ms warm (91.6 ms cold) and makers 0.26 to 0.02 ms behind .env LIBRARY_STATS_CACHE=1 (600 s on disk), output md5 identical (docs/results/0.11/library-11.md). Switch OFF: flip it and the front-page counts can be 10 minutes old; roll back by removing the line. LanguageNames::inUse is site-11's (Inbox).

– Built · in the lab – the owner flipping LIBRARY_STATS_CACHE; LanguageNames::inUse is site-11
PlatformPERF.16 Link to PERF.16Comment on PERF.16 Static delivery: no Brotli (gzip only), 7-day cache on files that are already cache-busted

Partly built (site-11 2026-11-20). Brotli is on for this site's static text types (css, javascript, json, svg, wasm) from public_html/.htaccess, gzip stays the fallback: app-workspace.js 32,458 B gzip to 30,611 B br, host.js 41,689 to 39,543, roadmap-issues.css 6,707 to 6,492; decoded bodies equal the files byte for byte (node zlib), identity and gzip answers unchanged; +3 ms per 140 KB file on a loaded box. The quality is server-level (BrotliCompressionQuality in .htaccess answered 500 and was removed within seconds), so the gain is 5 to 6 %; pre-compressed quality-11 siblings would give 15 % (27,671 B) at no CPU. Not done: the one-year immutable cache (some shared files import with a fixed ?v= number, so a year could pin an old file; and 0.10.1 is still moving), pre-compressed .br siblings (bin/release-app.php is the release session's). Was: Measured 2026-11-08: app files come back Content-Encoding: gzip only (cadcraft.js 198 KB to 61 KB); mod_brotli is loaded but not configured, and Brotli typically takes another 15 to 20 % off JS and CSS (1.4 to 1.7 MB of modules per app start). Every ?v= file carries Cache-Control: public, max-age=604800 (7 days); frozen release files and ?v=-busted shell files never change under their URL, so they can be immutable for a year (fewer revalidations on the second visit). Plan (.htaccess + Apache conf, no code): Brotli for text/css, javascript, wasm, json, svg with gzip as the fallback (or pre-compressed . BUILT 2026-11-21 (perf-finish-11), lane site, in /lab (a Discord member) only: Pre-compressed .br copies (quality 11, parallel tree assets/br, never inside a frozen folder) written by bin/brotli-siblings.mjs from bin/release-app.php; .htaccess serves them to browsers that accept br and gives live release folders a one-year immutable cache (current/, a Discord member/, /lab unchanged). CadCraft 0.10 over HTTPS: bin/test-static-delivery.mjs 15,307 / 0, every br/gzip/plain body equals its file; 14-17 % fewer bytes than gzip (cadcraft.js 54,806 -> 46,193). LIVE 2026-11-22 (owner's go): Brotli now wins for browsers that offer br, site-only (.htaccess: SetEnvIf Accept-Encoding br -> no-gzip, and the BROTLI_COMPRESS type list covers every type mod_deflate compresses); gzip-only clients unchanged; the server's deflate.conf and the other sites untouched. Checked over HTTPS: /roadmap, site.css, site.js, favicon.svg, robots.txt, sitemap.xml answer br to a browser and gzip to a gzip-only client, every br body decodes to the same bytes (sitemap.xml 501,803 -> 31,499 bytes); test-static-delivery 15,307 / 0; smoke 311 / 0. Pre-compressed .br copies (quality 11) for all eight apps' live 0.10: BimCraft 34.90 -> 9.64 MB, ModelCraft 17.26 -> 4.82, PartCraft 16.71 -> 4.77, CivilCraft 15.42 -> 3.59, DetailCraft 5.82 -> 1.59, TakeoffCraft 4.11 -> 1.05, MarkupCraft 1.98 -> 0.57 MB, 0 bad copies, test-static-delivery per app all 0 failed; live release folders answer br with a year, immutable.

– Built · in the lab – –
PlatformPERF.18 Link to PERF.18Comment on PERF.18 CadCraft Studio start-up time: a startup log with timestamps in the desktop shell, measured on Windows and macOS

Not measurable on the VPS (Studio is a Windows/macOS/Linux desktop shell around the web apps; the page part is PERF.1 to PERF.4). KICKOFF line 196 already asks for a startup log a person can send. Plan: desktop-shell logs timestamps for process start, single-instance lock, window shown, first page request, app module running, first drawing paint; the About dialog shows the last start's total; owner measures a cold and a warm start on the Windows workstation and the Mac mini with the 0.9 build and records them in the release notes. Budget: window in under 1 s, app usable in under 3 s warm. studio-10 2026-11-14: Written in desktop-shell (source only): startup.log gains the first page request, a line per app window and the two stages only the page knows; cadcraftDesktop.startLog.summary() answers the stages in milliseconds and whether the window came in under 1 s and the app was usable under 3 s; startLog.text(previous) gives the words for Copy / Save. No file names, paths or account data (every stage is a literal or a window label). std-only tests (2, rustc --test) and the source contracts pass. No start was timed: the numbers are the owner's on real machines. studio-11 2026-11-20: Studio's hub (studio/hub/hub.js) now tells the shell 'app module running' and 'first drawing paint' at its own start, and Settings > Updates shows the last start (ready in N s, window in N s, within the aim or not) with Copy and Save the start-up log. Hub tests 119/0, a headless hub run with a stand-in shell saw both marks and the row. Not timed on a real machine. LANDED 2026-11-20 (inbox-11) the page side: app-shell.js marks 'app module running' and 'first drawing… Verified 2026-11-20 (0.11 close-out): Hub test (studio/test/test-hub.mjs) 122/0 today, startlog.rs rustc --test 2/0, desktop-shell bridge test 137/0; one real Windows start already seen (window 762 ms, first paint 1021 ms). Cold/warm series and the Mac are a person's timings on real machines. The hand check is PERF.18-HAND.

– Built · in the lab – –
PlatformPERF.15 Link to PERF.15Comment on PERF.15 "Save for offline" downloads 107 to 260 MB per app; 103 MB of CadCraft's 173 MB is compiled help in 52 languages

Measured 2026-11-08 (bin/offline-size.php --libs): CadCraft 0.8.2 offline set 173 MB in 2,077 files: app files 161 MB, libraries 9.6 MB (pdfjs 5.2, three 2.1), shell 2.7 MB. Of the app files, help/ is 103 MB (52 compiled help.<locale>.js of 2 to 3 MB each plus 395 .md sources) and lang/ 33 MB (55 locale files); the modules a person runs are 3.7 MB at the top level. BimCraft 0.8.1 is similar; a Discord member builds reach 260 MB; MarkupCraft 78 MB carries 11.9 MB of Tesseract OCR data. On a phone this is a long download for one language. Plan: the offline set keeps the chosen locale (its lang file and its help.<locale>.js) plus English, never all 52; help .md sources are not saved (the compiled help is what the panel reads); OCR language data per picked language; optional "all languages" switch for a shared classroom machine. AppBuilds::offlineFiles takes the locale (PERF.3 fetches the list on demand). Expected: CadCraft about 35 MB instead of 173 MB, with the same offline behaviour for that person. Test: bin/offline-size.php gains --locale and the service-worker test checks the saved copy opens the help in the picked language. Built with PERF.3 behind PERF_OFFLINE_LAZY (off): the saved copy keeps the page's language chain (es-MX, es, en) of the compiled help and the language files only. /use copy size: CadCraft 265.3 to 32.6 MB, PartCraft 226.9 to 19.3 MB, MarkupCraft 110.2 to 24.7 MB (English). Changing language offline means saving again (the saved page is server-rendered in its language anyway). Not built: PERF.60 (the help index split) and help per language on demand when a person changes language. (perf-start-10 2026-11-13: docs/0.10-sessions/perf-start-10.md; numbers docs/results/0.10/)

– Built · in the lab – Owner: flip PERF_OFFLINE_LAZY=1 (or lab) in .env
Performance roadmap — wave 3 49
PlatformPERF.26 Link to PERF.26Comment on PERF.26 Scale: text writers return one string, so exports stop at 512 MB and hold twice the output

DXF (dxf.js:1324, dxf2000.js:437), LandXML (landxml.js:227), OBJ, DAE, USDA (usda-write.js:33), GeoJSON and gcode writers each build one string and return it; a 1,000,000-entity DXF export is near the V8 string limit and the string plus its Blob is twice the output in memory. Change: writers that yield chunks into a WritableStream (createWritable on a file handle when the host offers one, else a Blob built from parts), with the same report object. Pairs with the streaming readers row. Partly built (dwg-perf-10 2026-11-14): lib/textout/chunks.js (TextChunks: parts, Blob, pipe, string only while it fits): equal to lines.join at every size around a part, and 686 MB of text written without a string (peak RSS 1.7 GB). A ready patch for the DXF writer is docs/0.10-sessions/dwg-perf-10-dxf-chunks.patch. Log docs/0.10-sessions/dwg-perf-10.md. PARTLY BUILT 2026-11-20, scale-11: TextChunks gained push(); the LandXML and GeoJSON writers (patch for civilcraft/a Discord member) and the G-code writer (lib/carve, done) write past 512 MB: LandXML 9 M points 706 MB in 11.6 s, peak 3.2 GB (the string version fails: Invalid string length); 6 M points peak 5.7 GB to 2.2 GB; GeoJSON 4.8 M features 661 MB (fails as one string); G-code 40 M moves 767 MB (fails as one string). Same text as before on 62 checks. The DXF patch of 0.10 still applies: posted to cad-11. docs/results/0.11/scale-11-text-ws11a.txt. LANDED 2026-11-20 (inbox-11b) LandXML and GeoJSON chunked writers in civilcraft BUILT 2026-11-21 (perf-finish-11), lane scale-shell, cad, civil, model, in /lab (a Discord member) only: lib/textout TextChunks.output() (a string to 300 M characters, a Blob past that). CadCraft DXF 2000 save at 1 M objects works (was "Invalid string length": 538 M characters in parts, 12.5 s); CivilCraft LandXML and GeoJSON export in chunks (Blob past 300 MB), GeoJSON import from parts; ModelCraft OBJ, Collada, USDA write in parts, byte-identical 33 / 0; carve G-code check 29.8 -> 0.45 s (261 / 0). Copies synced (--check clean).

CadCraftModelCraftCivilCraft App codeOur engines Built · in the lab 4 – docs/0.9-sessions/perf-wave3/
PlatformPERF.44 Link to PERF.44Comment on PERF.44 Website: session_activity and analytics_visitors hold 1.6 M rows and 1,015 MB (83 % of the database), 42 % bots, no retention, one table never read

Partly built (site-11 2026-11-20). bin/test-analytics-prune.php 8/0. New switch ANALYTICS_VISITORS_OFF=1 (OFF) stops the analytics_visitors upsert on every page view (the table is read by nothing: checked across public_html, bin, tools); the retention job keeps pruning what is there. The nightly prune is still off (ANALYTICS_PRUNE=1, 400 days). Was: Partly built (perf-site-10 2026-11-13). AnalyticsRetention + bin/analytics-prune.php (batches of 5,000 on the date index, one run at a time, tests 8/0), OFF until .env ANALYTICS_PRUNE=1; 400 days default (ANALYTICS_RETENTION_DAYS), optional shorter bot window; today it counts 0 rows (oldest row 2026-10-10). Cron line is in the script header for the owner. Not built: no rows for bot page views, the daily rollup table, stop writing analytics_visitors, dropping idx_session. Was: Measured: session_activity 1.02 M rows / 646 MB growing 51,086 rows a day (21,675 of them is_bot = 1), analytics_visitors 597k rows / 369 MB growing 38,644 a day because a cookie-less client gets a fresh visitor id on every request; the table is written on every page view (Analytics.php:75) and read nowhere. Nothing prunes either (no DELETE in bin/ or the classes except the smoke test's own rows). The report queries full-scan the table (EXPLAIN ANALYZE: summary 1.8 s, topPages 2.4 s, each audience group 1.7 s, tryOpens 1.3 s), so the nightly warm job is roughly 60 to 80 s of scans that push the whole table through a 1 GB server-wide buffer pool these two tables alone fill. CadCraft analytics is about 1.1 inserts a second, over half of all INSERTs on this MySQL, each an fsync (two autocommits per page view). At 10x the warm job takes ten minutes and evicts every other database on the server. Fix: (1) do not store bot page views as rows (count per day per bot name in a small table) and give a visitor with no cc_vid cookie no analytics_visitors row until the second request; (2) retention for humans (owner's number; 30 days for any bot rows kept…

– Site and services Built · in the lab 4 Owner: ANALYTICS_PRUNE=1 with the cron line in bin/analytics-prune.php (400 days), and ANALYTICS_VISITORS_OFF=1 docs/0.9-sessions/perf-wave3/
PlatformPERF.53 Link to PERF.53Comment on PERF.53 Apps: 29.6 MB of byte-identical files under different URLs across the eight releases, and every new release re-downloads 98 % unchanged files

Planned (code-mains2-10 2026-11-16): not started. Baseline measured and saved (docs/results/0.10/code-mains2-10-shared-before.txt): 822 distinct contents under 2,548 URLs, 33.2 MB of extra copies. Fixing it changes released-build packaging and the 0.9 folders (rule 60: the owner's), so it needs the owner's word on the approach first. Was: tools/perf/addons-shared.mjs hashed every file of the eight current releases: 665 distinct contents under 2,163 URLs, 29.6 MB extra on the wire for a person who opens more than one app (cabinetcraft add-on in four apps 5.8 MB, dwg/ 3.0 MB, ifc schemas in four apps 2.3 MB, regs in four 2.3 MB, m3d 1.3 MB, crs-db.json 914 KB three times, host.js / addons.js / libitem.js eight times). Across releases: CadCraft 0.8.1 → 0.8.2 kept 2,084 of 2,127 files byte-identical (158 MB) and every one is re-downloaded under the new version URL; the same for every app and every "Save for offline" re-save (PERF.15). Vendor libraries are fine (one URL each, pinCurrent works). Change: a shared /assets/lib/<name>/<content-hash>/ URL for lib/* copies and shared add-ons (release-app.php pins it like vendor paths; the import map aliases ./dwg/x.js to it), or content-hashed file names so an unchanged file keeps its URL across releases. Both shrink the import map, which lists every file because ?v= busting needs an entry per module (499 entries / 48 KB in CadCraft, 772 / 78 KB in BimCraft per page view; AppBuilds.php:391-397).

CadCraftBimCraftModelCraftMarkupCraftTakeoffCraftCivilCraftDetailCraftPartCraft Site and servicesApp shell Planned 8 – docs/0.9-sessions/perf-wave3/
PlatformPERF.58 Link to PERF.58Comment on PERF.58 Apps: an installed add-on package is relinked from blob modules on every start (hvac 334 ms, plant 756 ms) and ships as base64 JSON

addons.js linkPackage turns each verified package into blob: module URLs every start: hvac 0.9.0 (193 files, 1.8 MB; 2.4 MB as base64 JSON) costs 334 ms per start (link 115, import 55, verify 6); plant 756 ms (import 447). The Ed25519 plus sha256 check is cheap (6 to 11 ms for 100 to 193 files); blob modules get no HTTP cache and no V8 code cache, so the cost repeats on every visit and grows with file count. Change: keep the signature check but serve verified packages from the service worker under a stable /addons/pkg/<sha>/<path> scope (or cache the linked texts and import() a persistent URL) so modules get code caching; stop base64 in the package JSON (binary zip, about 34 % smaller). AddonPackages.php, addons.js, sw.js.

CadCraftBimCraftModelCraftMarkupCraftTakeoffCraftCivilCraftDetailCraftPartCraft App shellSite and services Planned 3 – docs/0.9-sessions/perf-wave3/
PlatformPERF.59 Link to PERF.59Comment on PERF.59 Apps: no service worker until someone clicks "Save for offline"; every repeat visit is a cold start minus the 7-day HTTP cache

app-offline.js:160 registers /sw.js only on the click, and sw.js:46 installs nothing on its own; the PWA manifest promises more than the page delivers. Every visit refetches the 830 to 940 KB app page (PERF.2, PERF.3) and relies on the HTTP cache for the 300 to 500 module files (which Vary: Referer defeats, see the server rows). Change: register /sw.js on every /use page; cache-first for immutable URLs (?v= and pinned vendor/app folders: the worker already knows the rule, sw.js:33-40), stale-while-revalidate for the page; "Save for offline" stays the explicit full copy. Pairs with the shared-URL row (a shared lib URL is cached once for all apps) and the installed-package row. Built behind PERF_SW_RUNTIME (off): the worker is registered as /sw.js?rt=1 and keeps versioned /assets/ files (?v=, versioned vendor and release folders, hashed catalogs) in cc-runtime:v1, newest 2,500; the first visit hands it what it loaded (MarkupCraft: 170 files kept on the first visit). Rules in the head of sw.js: GET, same origin, /assets/ only, 200 only, never a lab a Discord member build, never a page, so nothing with a CSRF token or account data. Without ?rt=1 the cache is deleted. Repeat-visit time is not measured yet (Playwright's second visit already hits the HTTP cache). (perf-start-10 2026-11-13: docs/0.10-sessions/perf-start-10.md; numbers docs/results/0.10/)

CadCraftBimCraftModelCraftMarkupCraftTakeoffCraftCivilCraftDetailCraftPartCraft App shell Built · in the lab 3 Owner: flip PERF_SW_RUNTIME=1 (or lab) in .env docs/0.9-sessions/perf-wave3/
PlatformPERF.62 Link to PERF.62Comment on PERF.62 Server: the opcache interned-strings buffer is full and the cache restarts during the day

Measured: opcache interned strings 8.0 of 8.0 MB used (70,128 strings), oom_restarts 1 at 20:11 UTC today on a cache started 01:58; 1,195 scripts, 54 of 128 MB. After each restart every PHP file of every vhost recompiles (CadCraft alone 379 scripts / 33 MB): a CPU spike and slow first requests several times a day. Change in /etc/php/8.3/apache2/conf.d/10-opcache.ini: opcache.interned_strings_buffer=32, opcache.memory_consumption=256, then apache2ctl graceful. Healthy otherwise: hit rate 99.94 %, realpath cache 14 % used, autoloader one is_file per class, .env parse 0.04 ms, bootstrap 2 to 3 ms, DB connect 0.8 ms.

– Site and services Decision Time 1 Owner: server-wide PHP setting (shared by about 80 vhosts), no functional risk. docs/0.9-sessions/perf-wave3/
PlatformPERF.66 Link to PERF.66Comment on PERF.66 Server: Apache and TLS settings for a 400-request app start: MaxKeepAliveRequests 100, no OCSP stapling, RSA-2048, no HSTS, MaxConnectionsPerChild 0

Measured: a TLS handshake is 25 to 30 ms on localhost (RSA-2048, session tickets off by certbot, no stapling: "OCSP response: no response sent"); with MaxKeepAliveRequests 100 and six connections a 400-request CadCraft start forces at least four extra handshakes (each about two round trips plus CPU for a visitor). Prefork MaxRequestWorkers 150; 36 to 40 children at 50 MB (81 MB max) = 2 GB; MaxConnectionsPerChild 0 so a mod_php child never recycles. HSTS is on api.getcadcraft.com and the forks, not on getcadcraft.com. Changes: MaxKeepAliveRequests 1000 (or 0) in /etc/apache2/apache2.conf; SSLUseStapling On plus SSLStaplingCache shmcb:${APACHE_RUN_DIR}/stapling(128000) in mods-available/ssl.conf; certbot --key-type ecdsa for getcadcraft.com and api (halves handshake signing); Header always set Strict-Transport-Security "max-age=31536000" on getcadcraft.com; MaxConnectionsPerChild 10000 in mpm_prefork.conf. All moot or smaller after PERF.1 (HTTP/2), which these numbers also strengthen.

– Site and services Decision Time 1 Owner: apache2.conf, mods-available/ssl.conf and mpm_prefork.conf are server-wide (about 80 vhosts); the ECDSA certificate and HSTS header are this site's. docs/0.9-sessions/perf-wave3/
PlatformPERF.67 Link to PERF.67Comment on PERF.67 Server: MySQL settings versus the data on the box: a full 1 GB buffer pool for 5.2 GB of data, table cache overflowing, slow log off

Measured: innodb_buffer_pool_size 1 GB with 1,024 free pages and wait_free 74,540 against 5.2 GB of data plus index across 56 schemas (cadcraft_db 1.23 GB; the two analytics tables alone are 1 GB); table_open_cache 4000 full with 110,482 overflows; Sort_merge_passes 1.1 M with a 256 KB sort buffer; innodb_io_capacity 200 on an SSD; slow_query_log OFF and long_query_time 10 (7 hits in 12 days; nothing below it is known). Also from the SQL track: 64,469 COMMITs at 2.76 ms (innodb_flush_log_at_trx_commit = 1, every autocommit an fsync) and SET time_zone run 1.28 M times = one per connection (no persistent connections). Changes: innodb_buffer_pool_size 4G (SET GLOBAL plus mysqld.cnf), table_open_cache 8000, sort_buffer_size 1M, innodb_io_capacity 1000 / max 4000, slow_query_log ON with long_query_time 0.5 and log_queries_not_using_indexes capped, init_connect = "SET time_zone='+00:00'" if persistent connections are wanted; flush_log_at_trx_commit 2 is a server-wide trade (a second of rows lost on a crash) the other sites would share: the analytics row removes most of the fsyncs anyway. Healthy: pool hit rate 99.9 %, 2 disk temp tables of 3.6 M, redo 430 MB a day, max_used_connections 44 of 151.

– Site and services Decision Time 1 Owner: shared MySQL (56 schemas); all settings are dynamic, no restart; the pool adds about 3 GB to mysqld's 2.8 GB RSS (15 GB free). docs/0.9-sessions/perf-wave3/
PlatformPERF.68 Link to PERF.68Comment on PERF.68 Server: disk at 75 % with 90 GB reclaimable (a 56 GB Rust build tree, tmp/ build trees, both 0.8 downloads, a lang-overlay cache); logs rotated monthly

Measured: / is 290 of 388 GB. desktop-shell src-tauri target 56 GB (the forks' target moved to W: on 2026-11-08; this one did not; memory rule: never rebuild forks on the VPS), stores/build 18 GB, tmp build trees about 13 GB (editions, public-repos, studio-suite-0.9-a Discord member, devshell, live-apps-www*), downloads 0.8 and 0.8.1 both on disk (2.1 GB each; 0.7 and older moved to the CDN), three byte-identical frozen copies per app (hardlinking would save about 1.3 GB), tmp/cache/lang-overlay 981 MB with no TTL; access.log 345 MB a day uncompressed for a month (2.76 GB now). Noise: mec-broker logs two lines a minute when idle, a Discord member-sandbox-sync logs the same schema drift (team_join_codes.used_at) every 10 minutes, mail-poll logs a PHP array_merge(stdClass) error every 5 minutes (a ContactMail bug). Changes: move or delete the Rust target, clean tmp/ after each release, TTL on lang-overlay, hardlink identical files across frozen versions in bin/release-app.php, publish 0.8 downloads to the CDN like 0.7, weekly (or daily access) logrotate, quiet the idle broker line, fix the sandbox drift and the mail-poll error. About 90 GB back (75 % to about 52 %). closing 2026-11-16: Planned → Owner. Server-wide logrotate and disk settings (KICKOFF § Not a session); no session work.

– Site and servicesTests and tooling Decision Time 1 Owner: /etc/logrotate.d is server-wide; tmp/downloads-replaced (4.7 GB) is the "never deleted" policy and stays. docs/0.9-sessions/perf-wave3/
Suggest an item

Anyone can send one; no account and no name needed. The team reads each idea, and the ones we take on appear on this page. Please leave out web addresses.

Top