From 054a713977ba169469d6a7be51d13f466a58d43e Mon Sep 17 00:00:00 2001 From: Sergey Matyunin Date: Fri, 25 Sep 2026 13:12:28 +0300 Subject: [PATCH] docs: preserve workstation section hierarchy Keep the critical file-sync subsection under Local Windows workstation and place the repository-maintenance section after it, as requested by review r1. Issue: #628 User-Visible: no --- docs/DEVELOPMENT.md | 18 +++++++++--------- 1 file changed, 9 insertions(+), 9 deletions(-) diff --git a/docs/DEVELOPMENT.md b/docs/DEVELOPMENT.md index d5f26687..3ab43c7d 100644 --- a/docs/DEVELOPMENT.md +++ b/docs/DEVELOPMENT.md @@ -165,6 +165,15 @@ git config core.fsmonitor true git config core.untrackedCache true ``` +### ⚠️ File-sync pitfalls (critical) +1. The network mount sometimes serves files **truncated/scrambled** — edits via the Edit tool + from the Windows side are unreliable. Rule: **apply python patches against a clean copy in /tmp, + write via bash**, with an assert that count(old)==1. +2. **Run the rollup build ONLY in /tmp/hpc** (`npm ci` is already done). A build on the mount once + produced a syntactically valid but broken bundle ("wi is not defined") that crashed the rendering + of ALL HA dashboards (the card is loaded as an extra_module on every page!). +3. `.git` cannot be created on the mount ("Operation not permitted" on dot-directories) — hence the bundle. + ## Local repository maintenance (#628) Owner decision on 2026-09-25: use only a one-time local garbage collection for @@ -192,15 +201,6 @@ This post-GC value is the #628 monthly-growth baseline. To evaluate AC2 on or after 2026-10-25, run the same GC and `count-objects` sequence and compare the new `size-pack` with 467.63 MiB; the accepted upper bound is 487.63 MiB. -### ⚠️ File-sync pitfalls (critical) -1. The network mount sometimes serves files **truncated/scrambled** — edits via the Edit tool - from the Windows side are unreliable. Rule: **apply python patches against a clean copy in /tmp, - write via bash**, with an assert that count(old)==1. -2. **Run the rollup build ONLY in /tmp/hpc** (`npm ci` is already done). A build on the mount once - produced a syntactically valid but broken bundle ("wi is not defined") that crashed the rendering - of ALL HA dashboards (the card is loaded as an extra_module on every page!). -3. `.git` cannot be created on the mount ("Operation not permitted" on dot-directories) — hence the bundle. - ## Tests - Frontend: `npm test` — compiles src/logic.ts+rules.ts (tsconfig.test.json) and runs node:test