From 6a8065e08058c2e1cb73ae933db3288fc8b05141 Mon Sep 17 00:00:00 2001
From: Michael Dieringer <65093775+MichaelDieringer@users.noreply.github.com>
Date: Mon, 29 Jun 2026 15:56:39 +0200
Subject: [PATCH] =?UTF-8?q?Foresl=C3=A5=20regel:=20Shebang-integritet=20ve?=
 =?UTF-8?q?d=20deploy=20af=20script-filer?=
MIME-Version: 1.0
Content-Type: text/plain; charset=UTF-8
Content-Transfer-Encoding: 8bit

---
 .../knowledge/mcp/write-shebang-integrity.md  | 60 +++++++++++++++++++
 1 file changed, 60 insertions(+)
 create mode 100644 custom/knowledge/mcp/write-shebang-integrity.md

diff --git a/custom/knowledge/mcp/write-shebang-integrity.md b/custom/knowledge/mcp/write-shebang-integrity.md
new file mode 100644
index 0000000..843f09e
--- /dev/null
+++ b/custom/knowledge/mcp/write-shebang-integrity.md
@@ -0,0 +1,60 @@
+---
+id: CURABIS-MCP-SHEBANG-001
+title: Shebang-integritet ved deploy af script-filer
+category: mcp
+severity: error
+applies-to: [claude-code, windows, mcp-setup]
+---
+
+# Shebang-integritet ved deploy af script-filer
+
+## Regel
+
+Når en script-fil med shebang-linje (`.js`, `.sh`, `.ps1`) skrives via Claude Codes
+`Write`-værktøj på Windows, skal linje 1 i den deployede fil verificeres umiddelbart
+efter skrivning.
+
+Den verificerede linje skal matche den forventede shebang præcist, f.eks.:
+
+```
+#!/usr/bin/env node
+```
+
+## Baggrund
+
+På Windows håndteres strenge internt via PowerShell-laget. PowerShell behandler `#`
+som kommentar-tegn. Hvis filindhold sendes gennem en ikke-quoted streng eller heredoc,
+kan `#!` i shebangens første linje reduceres til `!/...` — et gyldigt men syntaktisk
+ugyldigt JavaScript-udtryk.
+
+Node.js parser da `!/usr/bin/env node` som logisk NOT på et regex-udtryk med ugyldige
+flags og kaster en `SyntaxError` ved opstart. Fejlen er stille: broen starter ikke,
+MCP-tools afvises uden dialog, og brugeren opdager det typisk kun ved at undres over
+manglende godkendelsesdialog.
+
+## Konsekvens af brud
+
+MCP-serveren starter ikke. Alle `mcp__businesscentral__*`-kald afvises automatisk.
+Brugeren ser ingen fejlbesked i Claude Code — kaldet afvises blot.
+
+## Verifikation (påkrævet efter enhver write af script-fil)
+
+```python
+with open(deployed_path, "r", encoding="utf-8") as f:
+    line1 = f.readline().rstrip()
+assert line1 == expected_shebang, f"Shebang fejl: forventet {expected_shebang!r}, fik {line1!r}"
+```
+
+Alternativt med Read-værktøjet: læs linje 1 og sammenlign med forventet shebang.
+Stop setup-processen og genskriv filen hvis de ikke matcher.
+
+## Eksempel (fejlscenarie observeret 2026-06-29)
+
+`bc-mcp-bridge.js` fik `!/usr/bin/env node` (mangler `#`) efter en
+CURABIS Standard-opdatering. BC MCP var ude af drift i ukendt periode.
+Opdaget ved at brugeren efterspurgte MCP-data og ingen godkendelsesdialog dukkede op.
+
+## Gælder for
+
+- `~/.claude/bc-mcp-bridge.js` (og fremtidige bridge-varianter)
+- Enhver `.js`- eller `.sh`-fil med shebang deployeret via CURABIS Standard-setup