dealsystem 0.0.1 → 0.2.0

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
Files changed (104) hide show
  1. package/README.md +64 -2
  2. package/dist/api/errors.d.ts +25 -0
  3. package/dist/api/errors.js +38 -0
  4. package/dist/api/http.d.ts +56 -0
  5. package/dist/api/http.js +406 -0
  6. package/dist/api/legal.d.ts +9 -0
  7. package/dist/api/legal.js +20 -0
  8. package/dist/api/oauth.d.ts +35 -0
  9. package/dist/api/oauth.js +113 -0
  10. package/dist/api/types.d.ts +142 -0
  11. package/dist/api/types.js +9 -0
  12. package/dist/auth/credentials.d.ts +28 -0
  13. package/dist/auth/credentials.js +96 -0
  14. package/dist/auth/session.d.ts +10 -0
  15. package/dist/auth/session.js +46 -0
  16. package/dist/bin.d.ts +2 -0
  17. package/dist/bin.js +4 -0
  18. package/dist/check/allowlist.d.ts +9 -0
  19. package/dist/check/allowlist.js +74 -0
  20. package/dist/check/catalog.d.ts +6 -0
  21. package/dist/check/catalog.js +410 -0
  22. package/dist/check/context.d.ts +79 -0
  23. package/dist/check/context.js +230 -0
  24. package/dist/check/fileset.d.ts +19 -0
  25. package/dist/check/fileset.js +91 -0
  26. package/dist/check/format.d.ts +25 -0
  27. package/dist/check/format.js +79 -0
  28. package/dist/check/index.d.ts +8 -0
  29. package/dist/check/index.js +9 -0
  30. package/dist/check/rule.d.ts +15 -0
  31. package/dist/check/rule.js +6 -0
  32. package/dist/check/rules/a11y.d.ts +3 -0
  33. package/dist/check/rules/a11y.js +433 -0
  34. package/dist/check/rules/privacy.d.ts +9 -0
  35. package/dist/check/rules/privacy.js +437 -0
  36. package/dist/check/rules/quality.d.ts +11 -0
  37. package/dist/check/rules/quality.js +451 -0
  38. package/dist/check/rules/schedule.d.ts +2 -0
  39. package/dist/check/rules/schedule.js +30 -0
  40. package/dist/check/rules/security.d.ts +18 -0
  41. package/dist/check/rules/security.js +744 -0
  42. package/dist/check/rules/structure.d.ts +2 -0
  43. package/dist/check/rules/structure.js +399 -0
  44. package/dist/check/run.d.ts +15 -0
  45. package/dist/check/run.js +147 -0
  46. package/dist/check/sdk.d.ts +56 -0
  47. package/dist/check/sdk.js +58 -0
  48. package/dist/check/types.d.ts +116 -0
  49. package/dist/check/types.js +2 -0
  50. package/dist/check/util/code.d.ts +19 -0
  51. package/dist/check/util/code.js +113 -0
  52. package/dist/check/util/color.d.ts +10 -0
  53. package/dist/check/util/color.js +53 -0
  54. package/dist/check/util/csp.d.ts +71 -0
  55. package/dist/check/util/csp.js +229 -0
  56. package/dist/check/util/html.d.ts +31 -0
  57. package/dist/check/util/html.js +65 -0
  58. package/dist/check/util/lines.d.ts +1 -0
  59. package/dist/check/util/lines.js +2 -0
  60. package/dist/check/util/literal.d.ts +1 -0
  61. package/dist/check/util/literal.js +3 -0
  62. package/dist/check/util/svelte.d.ts +42 -0
  63. package/dist/check/util/svelte.js +109 -0
  64. package/dist/cli/context.d.ts +40 -0
  65. package/dist/cli/context.js +107 -0
  66. package/dist/cli/io.d.ts +26 -0
  67. package/dist/cli/io.js +68 -0
  68. package/dist/cli/main.d.ts +24 -0
  69. package/dist/cli/main.js +269 -0
  70. package/dist/commands/check.d.ts +4 -0
  71. package/dist/commands/check.js +54 -0
  72. package/dist/commands/deploy.d.ts +20 -0
  73. package/dist/commands/deploy.js +315 -0
  74. package/dist/commands/dev.d.ts +29 -0
  75. package/dist/commands/dev.js +149 -0
  76. package/dist/commands/image.d.ts +12 -0
  77. package/dist/commands/image.js +291 -0
  78. package/dist/commands/login.d.ts +3 -0
  79. package/dist/commands/login.js +116 -0
  80. package/dist/commands/pull.d.ts +12 -0
  81. package/dist/commands/pull.js +178 -0
  82. package/dist/commands/site.d.ts +9 -0
  83. package/dist/commands/site.js +84 -0
  84. package/dist/commands/sync.d.ts +2 -0
  85. package/dist/commands/sync.js +126 -0
  86. package/dist/index.d.ts +10 -0
  87. package/dist/index.js +10 -0
  88. package/dist/project/agentFiles.d.ts +17 -0
  89. package/dist/project/agentFiles.js +156 -0
  90. package/dist/project/agentsBlock.d.ts +2 -0
  91. package/dist/project/agentsBlock.js +14 -0
  92. package/dist/project/siteConfig.d.ts +5 -0
  93. package/dist/project/siteConfig.js +35 -0
  94. package/dist/project/snapshot.d.ts +21 -0
  95. package/dist/project/snapshot.js +125 -0
  96. package/dist/project/svelteConfig.d.ts +4 -0
  97. package/dist/project/svelteConfig.js +74 -0
  98. package/dist/project/tar.d.ts +8 -0
  99. package/dist/project/tar.js +89 -0
  100. package/dist/project/untar.d.ts +27 -0
  101. package/dist/project/untar.js +232 -0
  102. package/dist/project/uploadFiles.d.ts +17 -0
  103. package/dist/project/uploadFiles.js +55 -0
  104. package/package.json +63 -7
@@ -0,0 +1,410 @@
1
+ // Regelkatalog von `dealsystem check` (Konzept Abschnitt 7, „Regeln von dealsystem check“).
2
+ // Neue Regeln kommen zuerst als Warnung und werden frühestens mit der nächsten Minor-Version zum Fehler,
3
+ // sonst scheitert der Inhalts-Rebuild einer unveränderten Seite. `RULE_SET_VERSION` steigt, sobald sich
4
+ // das Urteil ändern kann: eine neue oder geänderte Fehler-Regel, ein geänderter Schweregrad. Der Core gibt
5
+ // die Version dem Build-Host vor (`SELF_SITE_RULE_SET_VERSION`); weicht sie ab, scheitert jeder Build.
6
+ // Eine neue Warnung lässt das Urteil gleich und erhöht die Version deshalb nicht (CNT-003).
7
+ // 3: fremde Dienste über `external` und `dealsystemCsp()` (Phase 2, Paket A). Verschärfungen gelten als Fehler nur
8
+ // für Seiten mit `dealsystemCsp()`; Seiten mit der festen CSP bis SDK 0.1 bekommen sie als Warnung.
9
+ export const RULE_SET_VERSION = '3';
10
+ /** Bereich von `@dealsystem/site`, den dieser Regelkatalog kennt. Der Build-Host gibt seinen eigenen mit. */
11
+ export const DEFAULT_SDK_RANGE = '>=0.1.0 <2.0.0';
12
+ export const RULES = [
13
+ // ------------------------------------------------------------------ Struktur
14
+ {
15
+ id: 'STR-001',
16
+ severity: 'error',
17
+ stages: ['source'],
18
+ title: '`@sveltejs/adapter-static` in svelte.config.js',
19
+ fix: 'Setze in svelte.config.js den Adapter `@sveltejs/adapter-static`: `import adapter from "@sveltejs/adapter-static"` und `kit: { adapter: adapter() }`.',
20
+ },
21
+ {
22
+ id: 'STR-002',
23
+ severity: 'error',
24
+ stages: ['source'],
25
+ title: 'kein Server-Code: keine `+server.ts` (außer sitemap.xml/robots.txt), keine `hooks.server.ts`, keine Form-Actions',
26
+ fix: 'Lösche die Datei. Formulare gehen über `<LeadForm>`, Daten über `getCollection()`.',
27
+ },
28
+ {
29
+ id: 'STR-003',
30
+ severity: 'error',
31
+ stages: ['source'],
32
+ title: '`+page.server.ts`/`+layout.server.ts` nur mit `prerender = true`; Lade-Helfer nur dort',
33
+ fix: 'Ergänze `export const prerender = true` in der Datei oder in `src/routes/+layout.ts`.',
34
+ },
35
+ {
36
+ id: 'STR-004',
37
+ severity: 'error',
38
+ stages: ['source'],
39
+ title: 'dynamische Routen exportieren `entries()`',
40
+ fix: "Exportiere in `+page.server.ts` der Route `export const entries = () => collectionEntries('<key>')`.",
41
+ },
42
+ {
43
+ id: 'STR-005',
44
+ severity: 'error',
45
+ stages: ['source'],
46
+ title: '`dealsystem.config.ts` gültig, `siteId` gesetzt',
47
+ fix: 'Führe `npx dealsystem init` aus.',
48
+ },
49
+ {
50
+ id: 'STR-008',
51
+ severity: 'error',
52
+ stages: ['source'],
53
+ title: "`kit.prerender` in svelte.config.js: `handleHttpError` aus `@dealsystem/site/config` und `handleUnseenRoutes: 'ignore'`",
54
+ fix: "Ergänze in svelte.config.js `import { handleHttpError } from '@dealsystem/site/config'` und `kit: { prerender: { handleHttpError, handleUnseenRoutes: 'ignore' } }`, oder führe `npx dealsystem sync --fix-config` aus.",
55
+ },
56
+ {
57
+ id: 'STR-009',
58
+ severity: 'error',
59
+ stages: ['source'],
60
+ title: 'Vite-Plugin `dealsystem(site)` vor `sveltekit()` in vite.config.ts',
61
+ fix: "Schreibe in vite.config.ts `plugins: [dealsystem(site), sveltekit()]` mit `import { dealsystem } from '@dealsystem/site/vite'` und `import site from './dealsystem.config.ts'`.",
62
+ },
63
+ {
64
+ id: 'STR-006',
65
+ severity: 'error',
66
+ stages: ['source'],
67
+ title: '`@dealsystem/site` im unterstützten Versionsbereich',
68
+ fix: 'Aktualisiere mit `npm install @dealsystem/site@latest` und führe `npx dealsystem sync` aus.',
69
+ },
70
+ {
71
+ id: 'STR-007',
72
+ severity: 'error',
73
+ stages: ['source'],
74
+ title: '`package-lock.json` vorhanden und passend zu package.json',
75
+ fix: 'Führe `npm install` aus und lade das Lockfile mit hoch.',
76
+ },
77
+ // ------------------------------------------------------------- Abhängigkeiten
78
+ {
79
+ id: 'DEP-001',
80
+ severity: 'error',
81
+ stages: ['source'],
82
+ title: 'direkte Abhängigkeiten stehen auf der Positiv-Liste',
83
+ fix: 'Entferne das Paket mit `npm uninstall <name>`. Freigegebene Pakete: `npx dealsystem check --allowed`.',
84
+ },
85
+ {
86
+ id: 'DEP-002',
87
+ severity: 'error',
88
+ stages: ['source'],
89
+ title: 'Pakete kommen nur aus der npm-Registry (kein Git, keine URL, kein `file:`)',
90
+ fix: 'Installiere die veröffentlichte Version aus der npm-Registry: `npm install <name>@latest`.',
91
+ },
92
+ // -------------------------------------------------------------- Sicherheit
93
+ {
94
+ id: 'SEC-001',
95
+ severity: 'error',
96
+ stages: ['source', 'output'],
97
+ title: 'kein Zugangsschlüssel in Quelle oder Ausgabe',
98
+ fix: 'Entferne den Schlüssel und erneuere ihn beim Anbieter. Diese Seite braucht keine Secrets.',
99
+ },
100
+ {
101
+ id: 'SEC-002',
102
+ severity: 'error',
103
+ stages: ['source'],
104
+ title: 'kein `$env/static/private`, `$env/dynamic/private`, keine `.env` im Upload',
105
+ fix: 'Private Umgebungsvariablen gibt es auf einer statischen Seite nicht. Entferne den Import.',
106
+ },
107
+ {
108
+ id: 'SEC-003',
109
+ severity: 'error',
110
+ stages: ['source'],
111
+ title: 'kein `{@html}` außerhalb der SDK-Komponenten',
112
+ fix: 'Ersetze `{@html …}` durch `<RichText>` oder gib den Text normal aus.',
113
+ },
114
+ {
115
+ id: 'SEC-004',
116
+ severity: 'error',
117
+ stages: ['source'],
118
+ title: 'kein eigener Aufruf von `/api/site/`, `/api/v1/`, `/api/internal/`',
119
+ fix: 'Sprich die DealSystem-API nicht direkt an. Nutze `<LeadForm>`, `getCollection()` oder `<CollectionList>`.',
120
+ },
121
+ {
122
+ id: 'SEC-005',
123
+ severity: 'error',
124
+ stages: ['source'],
125
+ title: '`kit.csp: dealsystemCsp()` (oder die feste Liste bis SDK 0.1); `external` in dealsystem.config.ts gültig: nur `https://host`, Platzhalter nicht in `script`/`frame`, kein `unsafe-eval`',
126
+ fix: 'Schreibe in svelte.config.js `csp: dealsystemCsp()` (`npx dealsystem sync --fix-config`) und trage fremde Hosts unter `external` in dealsystem.config.ts ein (extern.md).',
127
+ },
128
+ {
129
+ id: 'SEC-006',
130
+ severity: 'error',
131
+ stages: ['source'],
132
+ title: 'kein `eval`, `new Function`, WebAssembly, kein Inline-Event-Handler als Zeichenkette, kein `<script>` ohne `src`, kein eigener Inhaltsblock `ds-content`',
133
+ fix: 'Entferne den Fund; die Seite läuft mit einer strengen Content-Security-Policy. Eigenen Code legst du als Datei in `static/scripts/` ab und lädst ihn mit `<ExternalScript>` (extern.md).',
134
+ },
135
+ {
136
+ id: 'SEC-007',
137
+ severity: 'error',
138
+ stages: ['source'],
139
+ title: 'eigenes `<form>` mit `onsubmit`, ohne `action` oder nur auf dieselbe Seite/`#`; kein `method="post"` mit `action`, kein fremdes `target`',
140
+ fix: 'Lass `action` weg, schreib `<form onsubmit={senden}>` und sende in `senden` mit `createLeadClient()`; oder nimm `<LeadForm funnel="…" />` mit dem Formular unter `funnels` in dealsystem.config.ts.',
141
+ },
142
+ {
143
+ id: 'SEC-008',
144
+ severity: 'error',
145
+ stages: ['source', 'output'],
146
+ title: 'fremde Rahmen und Skripte nur über `<Embed>`/`<ExternalScript>` mit Eintrag unter `external`; CSP der fertigen Seite = erwartete CSP',
147
+ fix: 'Trage den Dienst unter `external` in dealsystem.config.ts ein und binde ihn mit `<Embed>` (Video, Karte, Termin) oder `<ExternalScript>` (Skript) ein. Anleitung: extern.md. Lockere nicht die Regeln in svelte.config.js.',
148
+ },
149
+ {
150
+ id: 'SEC-009',
151
+ severity: 'error',
152
+ stages: ['source', 'output'],
153
+ title: 'kein Passwortfeld (`<input type="password">`)',
154
+ fix: 'Entferne das Passwortfeld. Eine Seite auf DealSystem hat keine Anmeldung.',
155
+ },
156
+ {
157
+ id: 'SEC-010',
158
+ severity: 'error',
159
+ stages: [],
160
+ title: 'deklarierte fremde Hosts sind nicht als gefährlich gemeldet (Prüfung durch DealSystem beim Hochladen)',
161
+ fix: 'Entferne den Dienst aus `external` in dealsystem.config.ts und aus der Seite. Ein gemeldeter Host schadet den Besuchern.',
162
+ },
163
+ {
164
+ id: 'SEC-011',
165
+ severity: 'error',
166
+ stages: ['output'],
167
+ title: '`<ExternalScript>` nur auf Seiten mit eigener Domain, solange `dealsystem.site` nicht auf der Public Suffix List steht (nur Build-Host)',
168
+ fix: 'Verbinde eine eigene Domain (Eigene Website → Domains) oder nimm `<ExternalScript>` heraus. Videos über `<Embed>` und `<Tracking />` gehen auch ohne.',
169
+ },
170
+ // --------------------------------------------------------------- Datenschutz
171
+ {
172
+ id: 'PRV-001',
173
+ severity: 'error',
174
+ stages: ['source', 'output'],
175
+ title: 'keine externen Skripte, Styles, Iframes, Schriften, Bilder vor der Einwilligung (außerhalb `<Embed>`, `<ExternalScript>`, `<ConsentGate>`)',
176
+ fix: 'Lege die Datei lokal ab (Ordner `static/` oder Import). Fremde Dienste bindest du mit `<Embed>` oder `<ExternalScript>` ein (extern.md).',
177
+ },
178
+ {
179
+ id: 'PRV-002',
180
+ severity: 'error',
181
+ stages: ['source', 'output'],
182
+ title: 'keine Google-Fonts- oder CDN-Schrift-URLs',
183
+ fix: 'Schriften müssen lokal liegen. Installiere `@fontsource/<name>` und importiere sie in `src/routes/+layout.svelte`.',
184
+ },
185
+ {
186
+ id: 'PRV-003',
187
+ severity: 'error',
188
+ stages: ['source'],
189
+ title: 'Tracking über `<Tracking>` oder als Datei in `static/`, geladen von `<ExternalScript>` mit Kategorie `statistics`/`marketing`',
190
+ fix: 'Google Tag und Meta Pixel: Kennung im CRM eintragen und `<ConsentGate category="marketing"><Tracking /></ConsentGate>`. Andere Snippets als Datei unter `static/scripts/` mit `<ExternalScript>` laden (extern.md).',
191
+ },
192
+ {
193
+ id: 'PRV-004',
194
+ severity: 'error',
195
+ stages: ['source', 'output'],
196
+ title: 'Routen `/impressum` und `/datenschutz` mit `<Impressum>` bzw. `<Datenschutz>`',
197
+ fix: 'Lege `src/routes/impressum/+page.svelte` mit `<Impressum />` und `src/routes/datenschutz/+page.svelte` mit `<Datenschutz />` an.',
198
+ },
199
+ {
200
+ id: 'PRV-005',
201
+ severity: 'error',
202
+ stages: ['source', 'output'],
203
+ title: 'jede Seite verlinkt Impressum und Datenschutz und enthält den Cookie-Hinweis',
204
+ fix: 'Füge `<SiteFooterLegal />` und `<CookieBanner />` in `src/routes/+layout.svelte` ein.',
205
+ },
206
+ {
207
+ id: 'PRV-006',
208
+ severity: 'warning',
209
+ stages: ['source'],
210
+ title: 'kein eigener Zugriff auf `document.cookie`, `localStorage`, `sessionStorage`',
211
+ fix: 'Wenn das Speichern nicht technisch nötig ist, gehört es hinter `<ConsentGate>`.',
212
+ },
213
+ {
214
+ id: 'PRV-008',
215
+ severity: 'warning',
216
+ stages: ['source'],
217
+ title: 'eigener fremder Dienst unter `external` nennt `provider`, `purpose` und `privacyUrl`',
218
+ fix: 'Ergänze Anbieter mit Sitz, Zweck und Datenschutz-Link: Der Cookie-Hinweis zeigt sie dem Besucher.',
219
+ },
220
+ // ------------------------------------------------------------ Barrierefreiheit
221
+ {
222
+ id: 'A11Y-001',
223
+ severity: 'error',
224
+ stages: ['source', 'output'],
225
+ title: '`<html lang>` gesetzt',
226
+ fix: 'Setze `<html lang="de">` in `src/app.html`.',
227
+ },
228
+ {
229
+ id: 'A11Y-002',
230
+ severity: 'error',
231
+ stages: ['source', 'output'],
232
+ title: 'jedes Bild hat `alt`; `<img>` nur über `<MediaImage>`',
233
+ fix: 'Ersetze `<img>` durch `<MediaImage>` und beschreibe das Bild in `alt`. Rein dekorativ: `alt="" decorative`.',
234
+ },
235
+ {
236
+ id: 'A11Y-003',
237
+ severity: 'error',
238
+ stages: ['output'],
239
+ title: 'genau eine `<h1>` je Seite, keine übersprungene Überschriften-Ebene',
240
+ fix: 'Nutze genau eine `<h1>` je Seite und danach jeweils die nächste Ebene.',
241
+ },
242
+ {
243
+ id: 'A11Y-004',
244
+ severity: 'error',
245
+ stages: ['output'],
246
+ title: 'Formularfelder haben eine verknüpfte Beschriftung',
247
+ fix: 'Nutze `<LeadForm>` oder ergänze `<label for="…">`.',
248
+ },
249
+ {
250
+ id: 'A11Y-005',
251
+ severity: 'error',
252
+ stages: ['output'],
253
+ title: 'Links und Schaltflächen haben einen zugänglichen Namen; kein „hier klicken“ als einziger Text',
254
+ fix: 'Ergänze sichtbaren, beschreibenden Text oder `aria-label`.',
255
+ },
256
+ {
257
+ id: 'A11Y-006',
258
+ severity: 'error',
259
+ stages: ['source'],
260
+ title: 'Farbpaare der Design-Tokens erreichen 4,5:1',
261
+ fix: 'Wähle für `--color-on-<name>` oder `--color-<name>` einen Farbton mit mindestens 4,5:1 Kontrast.',
262
+ },
263
+ {
264
+ id: 'A11Y-007',
265
+ severity: 'error',
266
+ stages: ['source'],
267
+ title: 'kein `outline: none` ohne Ersatz, kein `tabindex` > 0, kein `user-scalable=no`',
268
+ fix: 'Entferne den Fund; Tastaturnutzer brauchen den sichtbaren Fokus.',
269
+ },
270
+ {
271
+ id: 'A11Y-008',
272
+ severity: 'error',
273
+ stages: ['output'],
274
+ title: '`<title>` und `meta description` je Seite, Titel eindeutig',
275
+ fix: 'Ergänze `<svelte:head><title>…</title><meta name="description" content="…" /></svelte:head>`.',
276
+ },
277
+ {
278
+ id: 'A11Y-009',
279
+ severity: 'error',
280
+ stages: ['source', 'output'],
281
+ title: 'Videos über `<MediaVideo>` mit `title`; kein Autoplay mit Ton',
282
+ fix: 'Nutze `<MediaVideo media={…} title="…" />`.',
283
+ },
284
+ // ----------------------------------------------------------------- Qualität
285
+ {
286
+ id: 'QUA-001',
287
+ severity: 'error',
288
+ stages: ['output'],
289
+ title: 'Ausgabe ≤ 200 MB, ≤ 10 000 Dateien, Einzeldatei ≤ 25 MB',
290
+ fix: 'Verkleinere Bilder oder lege Videos im CRM ab.',
291
+ },
292
+ {
293
+ id: 'QUA-002',
294
+ severity: 'warning',
295
+ stages: ['output'],
296
+ title: 'JavaScript je Seite ≤ 300 KB (gzip)',
297
+ fix: 'Entferne ungenutzte Pakete und große Bibliotheken.',
298
+ },
299
+ {
300
+ id: 'QUA-003',
301
+ severity: 'error',
302
+ stages: ['output'],
303
+ title: 'keine toten internen Links, `404.html` vorhanden',
304
+ fix: 'Korrigiere den Link oder lege die Zielseite an.',
305
+ },
306
+ {
307
+ id: 'QUA-004',
308
+ severity: 'error',
309
+ stages: ['output'],
310
+ title: '`sitemap.xml` und `robots.txt` vorhanden',
311
+ fix: 'Stelle `src/routes/sitemap.xml/+server.ts` und `src/routes/robots.txt/+server.ts` aus dem Starter wieder her (mit `export const prerender = true`).',
312
+ },
313
+ {
314
+ id: 'QUA-005',
315
+ severity: 'error',
316
+ stages: ['source'],
317
+ title: 'jedes Formular hat ein Feld mit `standardField` `email` oder `phone`',
318
+ fix: "Ergänze im Formular ein Feld `{ name: 'email', type: 'email', standardField: 'email', required: true }`.",
319
+ },
320
+ {
321
+ id: 'QUA-006',
322
+ severity: 'error',
323
+ stages: ['source'],
324
+ title: 'Schlüssel-Formate (Slots, Formulare, Sammlungen), kein Slot-Schlüssel mit zwei Typen',
325
+ fix: 'Formular- und Sammlungs-Schlüssel: Kleinbuchstaben, Ziffern und Bindestriche, z. B. `kontakt`. Slot-Schlüssel: zwei bis fünf Teile mit Punkten, der erste ohne Bindestrich, z. B. `ueberuns.team.titel` für die Seite „Über uns“.',
326
+ },
327
+ {
328
+ id: 'QUA-007',
329
+ severity: 'warning',
330
+ stages: ['source'],
331
+ title: 'AGENTS.md-Block passt zur installierten SDK-Version',
332
+ fix: 'Führe `npx dealsystem sync` aus, damit die Agenten-Anleitung zur SDK-Version passt.',
333
+ },
334
+ {
335
+ id: 'QUA-009',
336
+ severity: 'warning',
337
+ stages: ['source'],
338
+ title: '`<Zeitfenster>`: `ab`/`bis` als feste Zeitpunkte mit Zeitzone, `ab` vor `bis`',
339
+ fix: 'Schreibe den Zeitpunkt als feste Zeichenkette mit Zeitzone, z. B. `bis="2026-12-01T18:00:00+01:00"` (Winterzeit, Sommerzeit `+02:00`). Keine Variable, sonst kann DealSystem zur Grenze nicht neu bauen.',
340
+ },
341
+ {
342
+ id: 'QUA-008',
343
+ severity: 'warning',
344
+ stages: ['source'],
345
+ title: 'eigene Oberfläche mit `createLeadClient`: Ausweichkontakt (`fallback`) und Bot-Falle (`<LeadHoneypot>`)',
346
+ fix: 'Zeig bei jedem Fehler außer `validation` `result.message` und den Ausweichkontakt `result.fallback` (Telefon, E-Mail) und setz `<LeadHoneypot client={lead} />` in die Oberfläche. Vorlage: Skill `funnel-mehrstufig`.',
347
+ },
348
+ {
349
+ id: 'QUA-010',
350
+ severity: 'warning',
351
+ stages: ['source'],
352
+ title: 'höchstens 50 Felder je Formular (mehr übernimmt das CRM nicht)',
353
+ fix: 'Teile das Formular auf oder streiche Felder. Felder ab dem 51. kommen nur als Notiz an, ohne Prüfung und ohne Zuordnung im CRM. Versteckte Felder zählen mit.',
354
+ },
355
+ // ------------------------------------------------------------------ Inhalte
356
+ {
357
+ id: 'CNT-001',
358
+ severity: 'warning',
359
+ stages: ['source'],
360
+ title: 'Überschriften und längere Texte als Content-Slot statt fest im Code',
361
+ fix: 'Lege den Text als Slot an, damit er im CRM änderbar ist: `<Text key="seite.bereich.name" default="…" />` (Überschrift: `as="h2"`, mehrzeilig: `multiline`, mit Formatierung: `<RichText>`).',
362
+ },
363
+ {
364
+ id: 'CNT-002',
365
+ severity: 'warning',
366
+ stages: ['source'],
367
+ title: 'Adresse, Telefonnummer und E-Mail-Adresse kommen aus dem CRM, nicht aus dem Code',
368
+ fix: 'Nimm die Angabe aus dem CRM: `getSite()` aus `@dealsystem/site/content` liefert `company`, `address`, `email` und `phone` (im Starter als `data.site` auf jeder Seite). Gib sie mit `{data.site.address}` aus. Ändert der Kunde sie im CRM, folgt die Seite.',
369
+ },
370
+ {
371
+ id: 'CNT-003',
372
+ severity: 'warning',
373
+ stages: ['source'],
374
+ title: 'kein `\\n` im `default` von `<Text>`/`<RichText>`: im Attribut ist es kein Zeilenumbruch',
375
+ fix: "Setz den Text in geschweifte Klammern, dann ist `\\n` ein echter Zeilenumbruch: `default={'1. Erster Schritt\\n2. Zweiter Schritt'}`. Leerzeile (`\\n\\n`) = neuer Absatz. Bei `<Text>` zusätzlich `multiline`. Beispiele: komponenten.md, `<Text>` und `<RichText>`.",
376
+ },
377
+ {
378
+ id: 'CNT-004',
379
+ severity: 'warning',
380
+ stages: ['source'],
381
+ title: 'Titel und Beschreibung über `<Seo>`, Favicon und `noindex` über `<SiteHead>`, damit „Google und Teilen“ im CRM wirkt',
382
+ fix: 'Ersetze `<title>` und `<meta name="description">` in `<svelte:head>` durch `<Seo title="…" description="…" />` (Import aus `@dealsystem/site`). Ins Haupt-Layout gehört `<SiteHead favicon="/favicon.svg" />`, der Favicon-Link nicht nach `src/app.html`.',
383
+ },
384
+ // ------------------------------------------------- Meldungen des Build-Hosts
385
+ {
386
+ id: 'BLD-001',
387
+ severity: 'error',
388
+ stages: [],
389
+ title: '`npm ci` oder `vite build` scheitert',
390
+ fix: 'Führe lokal `npm run build` aus und behebe den ersten Fehler.',
391
+ },
392
+ {
393
+ id: 'BLD-002',
394
+ severity: 'error',
395
+ stages: [],
396
+ title: 'Zeit- oder Speichergrenze des Builds überschritten',
397
+ fix: 'Der Build darf höchstens 5 Minuten und 2 GB brauchen. Entferne große Abhängigkeiten oder Seiten mit sehr vielen Einträgen.',
398
+ },
399
+ {
400
+ id: 'BLD-003',
401
+ severity: 'error',
402
+ stages: [],
403
+ title: 'Archiv oder Ausgabe ungültig (Symlinks, `..` im Pfad, Gerätedateien, Größengrenze)',
404
+ fix: 'Entferne Symlinks und Dateien außerhalb des Projekts und verkleinere große Dateien. Lade nur mit `npx dealsystem deploy` hoch; es packt ausschließlich die erlaubten Dateien.',
405
+ },
406
+ ];
407
+ const BY_ID = new Map(RULES.map((r) => [r.id, r]));
408
+ export function getRule(id) {
409
+ return BY_ID.get(id);
410
+ }
@@ -0,0 +1,79 @@
1
+ import { type ResolvedExternal } from '@dealsystem/site/config';
2
+ import { type SiteConfigResult } from '../project/siteConfig.js';
3
+ import { type HtmlDoc } from './util/html.js';
4
+ import { LineIndex } from './util/lines.js';
5
+ import { type ParsedModule } from './util/literal.js';
6
+ import { type ParsedSvelte } from './util/svelte.js';
7
+ import type { CheckOptions, FileSet, RawFinding } from './types.js';
8
+ export declare function isTextPath(path: string): boolean;
9
+ declare abstract class BaseContext {
10
+ readonly files: FileSet;
11
+ readonly options: CheckOptions;
12
+ private readonly texts;
13
+ private readonly lineIndexes;
14
+ constructor(files: FileSet, options: CheckOptions);
15
+ paths(): string[];
16
+ text(path: string): string | null;
17
+ /**
18
+ * Alle Textdateien (nach Endung; Binärdateien werden übersprungen). Mit `anyExtension` zählt jede Datei
19
+ * ohne Null-Bytes bis 5 MB (für die Secret-Suche: Schlüssel stehen auch in `.pem` oder ohne Endung).
20
+ */
21
+ textFiles(filter?: (path: string) => boolean, anyExtension?: boolean): string[];
22
+ lines(path: string): LineIndex;
23
+ /** Fund an einem Zeichen-Offset. */
24
+ at(path: string, offset: number, message: string, fix?: string): RawFinding;
25
+ }
26
+ export declare class SourceContext extends BaseContext {
27
+ private readonly codes;
28
+ private readonly svelteAsts;
29
+ private readonly modules;
30
+ private siteConfigResult;
31
+ /** Text mit ausgeblendeten Kommentaren. */
32
+ code(path: string): string;
33
+ svelte(path: string): ParsedSvelte | null;
34
+ module(path: string): ParsedModule | null;
35
+ /** Svelte-Dateien unter `src/`. */
36
+ svelteFiles(): string[];
37
+ /** Skript- und Svelte-Dateien unter `src/` (ohne erzeugte Typen). */
38
+ codeFiles(): string[];
39
+ /** HTML-Dateien der Quelle (`src/app.html`, `static/**.html`). */
40
+ htmlFiles(): string[];
41
+ /** CSS-Dateien der Quelle. */
42
+ cssFiles(): string[];
43
+ siteConfig(): SiteConfigResult;
44
+ svelteConfigPath(): string | null;
45
+ json(path: string): {
46
+ data: Record<string, unknown> | null;
47
+ error: string | null;
48
+ };
49
+ /** Installierte Version von `@dealsystem/site` laut Lockfile. */
50
+ sdkVersion(): string | null;
51
+ }
52
+ export declare class OutputContext extends BaseContext {
53
+ private readonly docs;
54
+ /**
55
+ * Deklaration für die erwartete CSP: aus `options.external` (Build-Host, aus dem Manifest) oder aus der Quelle
56
+ * desselben Laufs. `strict`: Abweichungen sind Fehler (neues SDK), sonst Warnungen. `null`: unbekannt.
57
+ */
58
+ declared: {
59
+ external: readonly ResolvedExternal[];
60
+ strict: boolean;
61
+ } | null;
62
+ /** Erwartete CSP der fertigen Seiten; `null`, wenn die Deklaration unbekannt ist. */
63
+ expectedCsp(apiOrigin: string): {
64
+ csp: Record<string, string[]>;
65
+ strict: boolean;
66
+ } | null;
67
+ html(path: string): HtmlDoc;
68
+ /** Alle HTML-Seiten der Ausgabe. */
69
+ pages(): string[];
70
+ /** Seiten ohne Fehler- und Ausweichseiten (404.html, 200.html, index.html der SPA-Ausweiche). */
71
+ contentPages(): string[];
72
+ /** Host der Seite, falls bekannt. */
73
+ siteHost(): string | null;
74
+ }
75
+ /** Route einer Ausgabe-Datei: `index.html` → `/`, `a/index.html` und `a.html` → `/a`. */
76
+ export declare function routeOfPage(path: string): string;
77
+ /** Route einer Quell-Datei unter `src/routes` ohne Gruppen: `src/routes/(app)/a/+page.svelte` → `/a`. */
78
+ export declare function routeOfSource(path: string): string;
79
+ export {};