@readystack/loeschkonzept-fristen-lint 1.0.1

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.
package/LICENSE.txt ADDED
@@ -0,0 +1,15 @@
1
+ Löschkonzept-Prüfer – Aufbewahrungsfristen 2026 — Licence
2
+
3
+ Free scope
4
+ Prüft jedes offene Löschkonzept (.md) mit allen 16 Regeln und zeigt die Befunde zeilengenau im Editor und im Browser — ohne Key. is free for any use, personal or commercial, for as long as you keep the
5
+ extension installed, and the online check at the product page is free without registration.
6
+
7
+ Paid scope
8
+ Ordner-Prüfbericht über alle Löschkonzepte und Löschfristen-Tabellen eines Workspace als Datei, als Nachweis nach Art. 5 Abs. 2 DSGVO für Audit und Datenschutzbeauftragte. is the paid part. It asks for a licence key issued at purchase (one seat, one key). The key is checked against the payment provider and
9
+ cached locally for 30 days so it keeps working offline.
10
+
11
+ Redistribution
12
+ You may not resell, re-host or bundle this extension or its rule set. The rule set and the
13
+ engine are provided as-is; check results are advisory and do not constitute legal advice.
14
+
15
+ (c) ReadyStack — https://getreadystack.com
package/README.md ADDED
@@ -0,0 +1,52 @@
1
+ # Löschkonzept-Prüfer – Aufbewahrungsfristen 2026
2
+
3
+ Löschkonzept und Löschfristen-Tabelle prüfen: 16 Regeln zu § 147 AO, § 257 HGB, § 14b UStG, § 41 EStG, § 15 AGG und Art. 5 DSGVO, direkt in VS Code und im Browser.
4
+
5
+ ## Install
6
+
7
+ ```
8
+ npx @readystack/loeschkonzept-fristen-lint file
9
+ ```
10
+
11
+ Node 18+. The same 16 rules as the VS Code extension, from a terminal or CI.
12
+
13
+ ## Free
14
+
15
+ - Prüft jedes offene Löschkonzept (.md) mit allen 16 Regeln, ohne Key, in VS Code und im Browser. Die Beispiel-Vorlage (Stand 2023) liefert 18 Befunde, darunter: Buchungsbelege 10 statt 8 Jahre, Rechnungen 10 statt 8 Jahre, Geschäftsbriefe 10 statt 6 Jahre, Lohnkonten 10 statt 6 Jahre, Jahresabschlüsse 6 statt 10 Jahre, Newsletter-Daten unbegrenzt.
16
+ - `--rules` lists every rule
17
+
18
+ ## With a licence ($29 once)
19
+
20
+ - $29 einmalig: Ordner-Prüfbericht über alle Löschkonzepte und Löschfristen-Tabellen eines Workspace als Datei, als Nachweis nach Art. 5 Abs. 2 DSGVO für Audit und Datenschutzbeauftragte. Ein Lizenzschlüssel pro Person oder Team-Platz.
21
+
22
+ ```
23
+ @readystack/loeschkonzept-fristen-lint --dir ./templates --report html --out report.html
24
+ ```
25
+
26
+ Steuerberater nach § 13 StBVV: Zeitgebühr €16,50 bis €41 je angefangene Viertelstunde.
27
+
28
+ ## Use from an AI agent (MCP)
29
+
30
+ Claude Code · Cursor · Windsurf · any MCP client - add to your MCP config:
31
+
32
+ ```json
33
+ { "mcpServers": { "loeschkonzept-fristen-lint": { "command": "npx", "args": ["-y", "@readystack/loeschkonzept-fristen-lint", "--mcp"] } } }
34
+ ```
35
+
36
+ Tools: `check_text` and `check_file` (free) · `check_dir` (licence). The agent gets every finding with the line number.
37
+
38
+ ## Use in CI
39
+
40
+ ```yaml
41
+ - name: Löschkonzept-Prüfer – Aufbewahrungsfristen 2026
42
+ run: npx -y @readystack/loeschkonzept-fristen-lint --dir . --ci
43
+ ```
44
+
45
+ (container: `docker run --rm -v "$PWD:/work" getreadystack/loeschkonzept-fristen-lint --dir /work --ci`)
46
+
47
+ The folder sweep, reports and CI mode need one licence — one payment, no subscription. Set `READYSTACK_LICENSE=<key>` or run `--license <key>` once.
48
+
49
+ [Get a licence](https://buy.polar.sh/polar_cl_j0sYK5M2L5REhRw2p2PONeb8WtblzQWGCbVU82rwl6B)
50
+
51
+
52
+ <!-- Löschkonzept -->
package/cli.js ADDED
@@ -0,0 +1,161 @@
1
+ #!/usr/bin/env node
2
+ // cli.js — the same rules as the VS Code extension, run from a terminal or a container. Generated by adapters.py.
3
+ 'use strict';
4
+ const fs = require('fs'), path = require('path');
5
+ const RULES = require('./rules.json');
6
+ const S = require('./strings.json');
7
+ const lic = require('./license.js');
8
+ const ENGINE = require('./engine.js'); // s144 — scaffold products: the same engine the VS Code extension runs
9
+ const RULE_LIST = Array.isArray(ENGINE.RULES) ? ENGINE.RULES : (Array.isArray(RULES) ? RULES : []);
10
+ const RULE_N = ENGINE.RULE_COUNT || RULE_LIST.length;
11
+ function scan(text, file) {
12
+ const r = ENGINE.engine.check(String(text), { today: new Date().toISOString().slice(0, 10), path: file || '' });
13
+ return (r && r.findings || []).map((f) => ({ line: parseInt(f.line, 10) || 1, msg: String(f.msg || f.message || f.check || ''), fix: f.fix || null, sev: (String(f.sev || 'error').toLowerCase().startsWith('err') ? 'error' : 'warn') }));
14
+ }
15
+ function isText(p) { try { const b = fs.readFileSync(p); if (b.length > 2 * 1024 * 1024) return false; const s = b.subarray(0, 4096); for (const x of s) if (x === 0) return false; return true; } catch (e) { return false; } }
16
+ function walk(dir, exts, out) {
17
+ let ents = []; try { ents = fs.readdirSync(dir, { withFileTypes: true }); } catch (e) { return out; }
18
+ for (const e of ents) {
19
+ if (['node_modules', '.git', '.hg', '.svn', '.venv', 'venv', '.tox', '.cache', '.next', '.nuxt', '.terraform', '__pycache__'].includes(e.name)) continue; // s158 — .github · .gitlab-ci.yml · .env · .well-known 은 본다 (옛 줄은 점으로 시작하는 것을 전부 건너뛰어 워크플로 검사기가 .github/workflows 를 못 봤다)
20
+ const p = path.join(dir, e.name);
21
+ if (e.isDirectory()) walk(p, exts, out);
22
+ else if ((!exts.length || exts.includes(path.extname(e.name).toLowerCase())) && isText(p)) out.push(p);
23
+ }
24
+ return out;
25
+ }
26
+ function esc(s) { return String(s).replace(/&/g, '&amp;').replace(/</g, '&lt;').replace(/>/g, '&gt;'); }
27
+ function csvq(s) { return '"' + String(s == null ? '' : s).replace(/"/g, '""') + '"'; }
28
+ function render(rows, fmt) {
29
+ if (fmt === 'json') return JSON.stringify({ tool: S.name, rules: RULE_N, files: rows }, null, 1);
30
+ if (fmt === 'csv') { const o = ['file,line,severity,message,fix']; for (const r of rows) for (const h of r.hits) o.push([csvq(r.file), h.line, h.sev, csvq(h.msg), csvq(h.fix)].join(',')); return o.join('\n') + '\n'; }
31
+ if (fmt === 'html') {
32
+ const n = rows.reduce((a, r) => a + r.hits.length, 0);
33
+ let o = '<!doctype html><meta charset="utf-8"><title>' + esc(S.name) + ' report</title><style>body{font:14px system-ui;margin:24px}table{border-collapse:collapse}td,th{border:1px solid #ddd;padding:4px 8px;font-size:13px}code{font-family:ui-monospace,monospace}</style>';
34
+ o += '<h1>' + esc(S.name) + '</h1><p>' + rows.length + ' files · ' + n + ' findings · ' + RULE_N + ' rules</p><table><tr><th>file</th><th>line</th><th>sev</th><th>message</th><th>fix</th></tr>';
35
+ for (const r of rows) for (const h of r.hits) o += '<tr><td><code>' + esc(r.file) + '</code></td><td>' + h.line + '</td><td>' + esc(h.sev) + '</td><td>' + esc(h.msg) + '</td><td>' + esc(h.fix || '') + '</td></tr>';
36
+ return o + '</table>';
37
+ }
38
+ let o = ''; for (const r of rows) { o += r.file + '\n'; for (const h of r.hits) o += ' ' + String(h.line).padStart(5) + ' ' + h.sev.padEnd(5) + ' ' + h.msg + (h.fix ? '\n -> ' + h.fix : '') + '\n'; if (!r.hits.length) o += ' (no findings)\n'; }
39
+ return o;
40
+ }
41
+ function trialState() {
42
+ // s158 — ⚑7일 무료 없음: 새 체험은 ⛔열지 않는다 · 이미 시작된 체험(trial.json)만 끝까지 지킨다 (읽기 전용)
43
+ if (process.env.READYSTACK_NO_TRIAL) return { active: false };
44
+ try {
45
+ const p = path.join(path.dirname(lic.storePath()), S.bin + '.trial.json');
46
+ const t = JSON.parse(fs.readFileSync(p, 'utf8'));
47
+ return { active: !!(t && t.until) && new Date(t.until + 'T23:59:59Z').getTime() > Date.now(), until: t && t.until };
48
+ } catch (e) { return { active: false }; }
49
+ }
50
+ // ★s158 2026-09-23 — the free run SPEAKS about the rest of the folder (vsix: auto.js · crx: welcome tab).
51
+ // The answer for the named files is complete and free; the next step is shown with the user's OWN numbers:
52
+ // "this folder has N more matching files - M issues in K of them" + the one command that sweeps them.
53
+ // Never blocks, never starts a trial (s158: no free trial - the free answer on the named files is the "try it"), human seat only, 400 files / 1.5 s cap.
54
+ function folderHint(done) {
55
+ if (!process.stderr.isTTY || process.env.CI || process.env.READYSTACK_NO_HINT || !done.length) return;
56
+ const base = path.dirname(path.resolve(done[0]));
57
+ const seen = new Set(done.map((f) => path.resolve(f)));
58
+ const all = walk(base, S.exts || [], []).filter((f) => !seen.has(path.resolve(f)));
59
+ if (!all.length) return;
60
+ const t0 = Date.now(); let issues = 0, hitFiles = 0, scanned = 0;
61
+ for (const f of all.slice(0, 400)) { if (Date.now() - t0 > 1500) break; let t = ''; try { t = fs.readFileSync(f, 'utf8'); } catch (e) { continue; } scanned++; const h = scan(t, f); if (h.length) { issues += h.length; hitFiles++; } }
62
+ const rel = path.relative(process.cwd(), base) || '.';
63
+ const tail = trialState().active ? 'free during your trial' : '$' + S.price + ' once';
64
+ const more = all.length + ' more matching file' + (all.length > 1 ? 's' : '');
65
+ const found = issues ? ' - ' + (scanned < all.length ? 'at least ' : '') + issues + ' issue' + (issues > 1 ? 's' : '') + ' in ' + hitFiles + ' of them' : ' - no issues found in them';
66
+ process.stderr.write('\n' + (rel === '.' ? 'This folder' : rel) + ' has ' + more + found + '.\n' + (issues ? 'Sweep them all: ' + S.bin + ' --dir ' + (/\s/.test(rel) ? JSON.stringify(rel) : rel) + ' (' + tail + ')\n' : ''));
67
+ }
68
+ let _usePinged = false;
69
+ function pingUse() {
70
+ try {
71
+ if (_usePinged) return; _usePinged = true;
72
+ if (process.env.DO_NOT_TRACK === '1' || process.env.READYSTACK_NO_TELEMETRY || process.env.CI) return;
73
+ if (!(process.stdout.isTTY || process.stdin.isTTY)) return; // human seat only (s152)
74
+ const https = require('https');
75
+ const body = JSON.stringify({ t: 'use', slug: S.bin, src: 'cli', why: 'free' });
76
+ const req = https.request({ hostname: 'getreadystack.com', path: '/api/ev', method: 'POST', timeout: 3000,
77
+ headers: { 'content-type': 'application/json', 'content-length': Buffer.byteLength(body), 'user-agent': 'readystack-cli/' + S.bin } }, function (res) { res.resume(); });
78
+ req.on('timeout', function () { req.destroy(); }); req.on('error', function () {});
79
+ req.write(body); req.end();
80
+ } catch (e) {}
81
+ }
82
+ function mcpServe() {
83
+ process.env.READYSTACK_MCP = '1'; // s152 - 에이전트(Claude Code·Cursor)가 부른 세션은 사람 자리다 · 키 판 핑 src=mcp
84
+ // s144 — MCP server over stdio (newline-delimited JSON-RPC · no dependencies). Free: check_text · check_file. Licence (s158: no free trial): check_dir.
85
+ const rl = require('readline').createInterface({ input: process.stdin });
86
+ const send = (o) => process.stdout.write(JSON.stringify(o) + '\n');
87
+ const tools = [
88
+ { name: 'check_text', description: S.name + ' - run all ' + RULE_N + ' checks on a text (free)', inputSchema: { type: 'object', properties: { text: { type: 'string', description: 'file contents' }, path: { type: 'string', description: 'optional file name for context' } }, required: ['text'] } },
89
+ { name: 'check_file', description: S.name + ' - run all checks on one file by path (free)', inputSchema: { type: 'object', properties: { path: { type: 'string' } }, required: ['path'] } },
90
+ { name: 'check_dir', description: S.name + ' - sweep a folder and return every finding (licence; $' + S.price + ' once)', inputSchema: { type: 'object', properties: { dir: { type: 'string' }, ext: { type: 'string', description: 'optional extension filter, e.g. .html' } }, required: ['dir'] } }
91
+ ];
92
+ const result = (id, rows) => send({ jsonrpc: '2.0', id, result: { content: [{ type: 'text', text: render(rows, 'text') }], structuredContent: { tool: S.name, rules: RULE_N, files: rows } } });
93
+ const fail = (id, text) => send({ jsonrpc: '2.0', id, result: { content: [{ type: 'text', text }], isError: true } });
94
+ rl.on('line', async (line) => {
95
+ let m; try { m = JSON.parse(line); } catch (e) { return; }
96
+ const id = m.id, method = m.method;
97
+ if (method === 'initialize') return send({ jsonrpc: '2.0', id, result: { protocolVersion: '2025-06-18', capabilities: { tools: {} }, serverInfo: { name: '@readystack/' + S.bin, version: '1.0.0' } } });
98
+ if (method === 'notifications/initialized' || method === 'ping') { if (id !== undefined) send({ jsonrpc: '2.0', id, result: {} }); return; }
99
+ if (method === 'tools/list') return send({ jsonrpc: '2.0', id, result: { tools } });
100
+ if (method === 'tools/call') {
101
+ const name = (m.params || {}).name, args = (m.params || {}).arguments || {};
102
+ try {
103
+ if (name === 'check_text') return result(id, [{ file: args.path || '(text)', hits: scan(String(args.text || ''), args.path || '') }]);
104
+ if (name === 'check_file') return result(id, [{ file: args.path, hits: scan(fs.readFileSync(args.path, 'utf8'), args.path) }]);
105
+ if (name === 'check_dir') {
106
+ const r = await lic.ensure();
107
+ if (!r.ok && !trialState().active) return fail(id, S.need_key + ' Get a licence ($' + S.price + ', once): ' + lic.BUY_URL);
108
+ const files = walk(args.dir, args.ext ? [args.ext] : (S.exts || []), []);
109
+ return result(id, files.map((f) => { let t = ''; try { t = fs.readFileSync(f, 'utf8'); } catch (e) { return { file: f, hits: [], error: String(e.message) }; } return { file: f, hits: scan(t, f) }; }));
110
+ }
111
+ return send({ jsonrpc: '2.0', id, error: { code: -32601, message: 'unknown tool ' + name } });
112
+ } catch (e) { return fail(id, String(e && e.message || e)); }
113
+ }
114
+ if (id !== undefined) send({ jsonrpc: '2.0', id, error: { code: -32601, message: 'method not found: ' + method } });
115
+ });
116
+ }
117
+ function help() {
118
+ return [S.name + ' - ' + S.subtitle, '', 'Usage: ' + S.bin + ' <file> [more files] check the files you name (free, every rule)',
119
+ ' ' + S.bin + ' --dir <folder> [--ext .html] scan a whole folder (licence)',
120
+ ' ' + S.bin + ' ... --report csv|json|html [--out file] export a report (licence)',
121
+ ' ' + S.bin + ' ... --ci exit 1 when an error-level finding exists (licence)',
122
+ ' ' + S.bin + ' --license <key> store your licence key (or set READYSTACK_LICENSE)',
123
+ ' ' + S.bin + ' --rules list the ' + RULE_N + ' rules',
124
+ ' ' + S.bin + ' --mcp run as an MCP server (stdio) for Claude Code / Cursor / Windsurf - free checks, folder sweep needs a licence', '',
125
+ 'Free: ' + S.free, 'Licence ($' + S.price + ', once): ' + S.paid, 'Get a licence: ' + lic.BUY_URL, ''].join('\n');
126
+ }
127
+ (async function main() {
128
+ try { const _feed = await lic.pullFeed(); if (_feed && Array.isArray(_feed.rules)) { if (Array.isArray(ENGINE.RULES)) for (const r of _feed.rules) ENGINE.RULES.push(r); } } catch (e) {} // ★s134 구독 피드 병합 (키 있는 손님만)
129
+ const a = process.argv.slice(2);
130
+ const get = (k) => { const i = a.indexOf(k); return i >= 0 ? a[i + 1] : null; };
131
+ if (a.includes('--mcp')) { mcpServe(); return; }
132
+ if (!a.length || a.includes('--help') || a.includes('-h')) { process.stdout.write(help()); return; }
133
+ if (a.includes('--rules')) { process.stdout.write((RULE_LIST.length ? RULE_LIST.map((r, i) => String(i + 1).padStart(3) + ' [' + (r.sev || 'warn') + '] ' + (r.message || r.msg || r.id || '')) : Array.from({ length: RULE_N }, (_, i) => String(i + 1).padStart(3) + ' [engine] check ' + (i + 1))).join('\n') + '\n'); return; }
134
+ if (a.includes('--license')) { const r = await lic.ensure(get('--license')); process.stdout.write(r.ok ? 'Licence stored: ' + lic.storePath() + '\n' : 'Licence not accepted (' + r.why + '). Get one: ' + lic.BUY_URL + '\n'); process.exit(r.ok ? 0 : 2); }
135
+ const dir = get('--dir'), fmt = get('--report'), out = get('--out'), ci = a.includes('--ci');
136
+ const exts = a.includes('--ext') ? [get('--ext')] : (S.exts || []);
137
+ const paid = !!(dir || fmt || ci);
138
+ if (paid) {
139
+ const r = await lic.ensure();
140
+ if (!r.ok) {
141
+ const t = trialState(); // s158 — ⚑7일 무료 없음 · 이미 시작된 체험만 지킨다
142
+ if (t.active) process.stderr.write('Trial: the full run is free until ' + t.until + ' — after that $' + S.price + ' once. Get a licence: ' + lic.BUY_URL + '\n');
143
+ else {
144
+ // s158 — the key is asked WITH the customer's own count (endowment · open loop): how many issues this folder holds.
145
+ let own = '';
146
+ if (dir) { try { const all = walk(dir, exts, []); let n = 0, k = 0, sc = 0; const t0 = Date.now();
147
+ for (const f of all.slice(0, 2000)) { if (Date.now() - t0 > 4000) break; let tx = ''; try { tx = fs.readFileSync(f, 'utf8'); } catch (e) { continue; } sc++; const h = scan(tx, f); if (h.length) { n += h.length; k++; } }
148
+ if (n) own = dir + ': ' + (sc < all.length ? 'at least ' : '') + n + ' issue' + (n > 1 ? 's' : '') + ' in ' + k + ' of ' + all.length + ' files.\n'; } catch (e) {} }
149
+ process.stderr.write(own + S.need_key + '\n set READYSTACK_LICENSE=<key> or ' + S.bin + ' --license <key>\n Get a licence ($' + S.price + ' once): ' + lic.BUY_URL + '\n'); process.exit(2);
150
+ }
151
+ }
152
+ }
153
+ const files = dir ? walk(dir, exts, []) : a.filter((x, i) => !x.startsWith('--') && !['--dir', '--report', '--out', '--ext', '--license'].includes(a[i - 1]));
154
+ if (!files.length) { process.stderr.write('No files. ' + S.bin + ' --help\n'); process.exit(2); }
155
+ const rows = files.map((f) => { let t = ''; try { t = fs.readFileSync(f, 'utf8'); } catch (e) { return { file: f, hits: [], error: String(e.message) }; } return { file: f, hits: scan(t) }; });
156
+ const text = render(rows, fmt || 'text');
157
+ if (out) fs.writeFileSync(out, text); else process.stdout.write(text.endsWith('\n') ? text : text + '\n');
158
+ if (!paid) { try { folderHint(files); } catch (e) {} pingUse(); } // s158 — a free run ends with the user's own folder count + one anonymous 'used' count (human seat only)
159
+ const errors = rows.reduce((n, r) => n + r.hits.filter((h) => h.sev === 'error').length, 0);
160
+ if (ci && errors) process.exit(1);
161
+ })().catch((e) => { process.stderr.write(String(e && e.stack || e) + '\n'); process.exit(3); });
package/engine.js ADDED
@@ -0,0 +1,63 @@
1
+ /* Löschkonzept-Prüfer engine: runs in Node (VS Code) and in the browser (index.html). */
2
+ (function () {
3
+ var RULES = (typeof module !== 'undefined') ? require('./rules.json') : window.LF_RULES;
4
+ var WORDS = { zwei: 2, drei: 3, vier: 4, 'fünf': 5, sechs: 6, sieben: 7, acht: 8, neun: 9, zehn: 10, 'elf': 11, 'zwölf': 12 };
5
+ var INST = /kreditinstitut|\bKWG\b|versicherungsaufsicht|versicherungsunternehmen|\bVAG\b|wertpapierinstitut|\bWpIG\b/i;
6
+ var CITE = /§|art\.?\s*\d|dsgvo|\bAO\b|\bHGB\b|\bUStG\b|\bEStG\b|\bAGG\b|\bBDSG\b|einwilligung/i;
7
+ function rx(s) { return new RegExp(s, 'i'); }
8
+ function years(line) {
9
+ var m = line.match(/(\d{1,2}|zwei|drei|vier|fünf|sechs|sieben|acht|neun|zehn|elf|zwölf)\s*(jahren?|jahre|jahr|j\.)(?![a-zäöü])/i);
10
+ if (!m) return 0;
11
+ var v = m[1].toLowerCase();
12
+ return /^\d+$/.test(v) ? parseInt(v, 10) : WORDS[v];
13
+ }
14
+ function months(line) {
15
+ var m;
16
+ if ((m = line.match(/(\d{1,3})\s*monat/i))) return parseInt(m[1], 10);
17
+ if ((m = line.match(/(\d{1,3})\s*woche/i))) return parseInt(m[1], 10) / 4.345;
18
+ if ((m = line.match(/(\d{1,3})\s*tag/i))) return parseInt(m[1], 10) / 30.4;
19
+ if (/sofort|unverzüglich|umgehend|direkt nach|mit (der )?absage/i.test(line)) return 0;
20
+ return -1;
21
+ }
22
+ function isRow(l) { return /^\s*\|/.test(l) && !/^\s*\|[\s:|-]+\|?\s*$/.test(l); }
23
+ function check(text, opts) {
24
+ var lines = String(text || '').split(/\r?\n/);
25
+ var all = lines.join('\n');
26
+ var inst = INST.test(all);
27
+ var out = [];
28
+ function hit(r, line, msg) { out.push({ check: r.id, sev: r.sev, msg: msg || r.msg, line: line, ref: r.ref }); }
29
+ var cats = RULES.filter(function (r) { return /^(period|period_any|min_months)$/.test(r.kind); });
30
+ lines.forEach(function (l, i) {
31
+ var r = null;
32
+ for (var k = 0; k < cats.length; k++) if (rx(cats[k].re).test(l)) { r = cats[k]; break; }
33
+ if (!r) return;
34
+ if (r.kind === 'period') {
35
+ var y = years(l); if (!y) return;
36
+ var want = (inst && r.inst_years) ? r.inst_years : r.years;
37
+ if (y > want && r.over) hit(r, i + 1, r.label + ': ' + y + ' Jahre im Konzept, gesetzlich ' + want + ' Jahre (' + r.ref + '). ' + r.over);
38
+ else if (y < want) hit(r, i + 1, r.label + ': ' + y + ' Jahre im Konzept, gesetzlich ' + want + ' Jahre (' + r.ref + '). ' + r.under);
39
+ } else if (r.kind === 'period_any') {
40
+ if (years(l) && !(r.unless && rx(r.unless).test(l))) hit(r, i + 1);
41
+ } else if (r.kind === 'min_months') {
42
+ if (years(l)) return;
43
+ var mo = months(l);
44
+ if (mo >= 0 && mo < r.months) hit(r, i + 1);
45
+ }
46
+ });
47
+ RULES.forEach(function (r) {
48
+ var re = rx(r.re);
49
+ if (r.kind === 'require') {
50
+ if (!re.test(all)) hit(r, 1);
51
+ } else if (r.kind === 'forbid') {
52
+ lines.forEach(function (l, i) { if (re.test(l)) hit(r, i + 1); });
53
+ } else if (r.kind === 'row_ref') {
54
+ lines.forEach(function (l, i) { if (isRow(l) && re.test(l) && !CITE.test(l)) hit(r, i + 1); });
55
+ }
56
+ });
57
+ out.sort(function (a, b) { return a.line - b.line; });
58
+ return { findings: out };
59
+ }
60
+ var api = { engine: { check: check }, RULES: RULES, RULE_COUNT: RULES.length };
61
+ if (typeof module !== 'undefined') module.exports = api;
62
+ if (typeof window !== 'undefined') window.LFENGINE = api;
63
+ })();
package/license.js ADDED
@@ -0,0 +1,83 @@
1
+ // license.js — Polar licence check for the CLI / container. Generated by adapters.py; do not edit by hand.
2
+ 'use strict';
3
+ const https = require('https'), fs = require('fs'), path = require('path'), os = require('os');
4
+ const ORG_ID = 'a5cdf664-d8e7-4f87-8895-056717aaba17';
5
+ const BENEFIT_ID = '0df57fc7-997c-45b4-807b-b16fc2ed53eb'; // s142 — this product's Polar benefit (s140 law: ask with benefit_id, or one key opens every product)
6
+ const BUY_URL = 'https://buy.polar.sh/polar_cl_j0sYK5M2L5REhRw2p2PONeb8WtblzQWGCbVU82rwl6B';
7
+ const SLUG = 'loeschkonzept-fristen-lint';
8
+ const GRACE_MS = 30 * 24 * 3600 * 1000; // after a successful check, 30 days work offline
9
+ const RECHECK_MS = 7 * 24 * 3600 * 1000; // re-ask Polar every 7 days (refunds / cancellations)
10
+ function storePath() { return path.join(process.env.READYSTACK_HOME || path.join(os.homedir(), '.config', 'readystack'), SLUG + '.json'); }
11
+ function load() { try { return JSON.parse(fs.readFileSync(storePath(), 'utf8')); } catch (e) { return {}; } }
12
+ function save(o) { try { fs.mkdirSync(path.dirname(storePath()), { recursive: true }); fs.writeFileSync(storePath(), JSON.stringify(o)); } catch (e) { /* read-only home: still works for this run */ } }
13
+ const ALL_BENEFIT_ID = '22692551-5203-4467-b1a3-e33cdba6589d'; // s149 2026-09-17 — 팀 키(전 린터 한 키 · Polar benefit) · 상품 benefit 다음에 한 번 더 묻는다
14
+ function validate(key) {
15
+ return validate1(key, BENEFIT_ID).then(function (r) { return (r.ok || r.offline || !/^[0-9a-f-]{36}$/.test(ALL_BENEFIT_ID)) ? r : validate1(key, ALL_BENEFIT_ID); });
16
+ }
17
+ function validate1(key, ben) {
18
+ return new Promise(function (resolve) {
19
+ if (!ORG_ID) return resolve({ ok: false, offline: false });
20
+ const body = JSON.stringify(/^[0-9a-f-]{36}$/.test(ben) ? { key: key, organization_id: ORG_ID, benefit_id: ben } : { key: key, organization_id: ORG_ID });
21
+ const req = https.request({ hostname: 'api.polar.sh', path: '/v1/customer-portal/license-keys/validate', method: 'POST', timeout: 8000,
22
+ headers: { 'content-type': 'application/json', 'polar-version': '2026-04', 'content-length': Buffer.byteLength(body) } }, function (res) {
23
+ let buf = ''; res.on('data', function (d) { buf += d; });
24
+ res.on('end', function () {
25
+ if (res.statusCode !== 200) return resolve({ ok: false, offline: false });
26
+ try { const j = JSON.parse(buf); resolve({ ok: j && (j.status === 'granted' || j.valid === true || !!j.id), offline: false }); }
27
+ catch (e) { resolve({ ok: false, offline: false }); }
28
+ });
29
+ });
30
+ req.on('timeout', function () { req.destroy(); resolve({ ok: false, offline: true }); });
31
+ req.on('error', function () { resolve({ ok: false, offline: true }); });
32
+ req.write(body); req.end();
33
+ });
34
+ }
35
+ // ★s151 2026-09-19 — 키 판(키가 없거나 거절된 순간)을 익명으로 센다 (슬러그·출처·이유만) · DO_NOT_TRACK=1 · READYSTACK_NO_TELEMETRY 면 안 보낸다 · 실패는 조용히 · 프로세스당 한 번.
36
+ let _pinged = false;
37
+ function pingPaywall(why) {
38
+ try {
39
+ if (_pinged) return; _pinged = true;
40
+ if (process.env.DO_NOT_TRACK === '1' || process.env.READYSTACK_NO_TELEMETRY || process.env.CI) return; // s151: CI(깃허브 액션 등)와 우리 빌드는 손님이 아니다
41
+ if (!(process.stdout.isTTY || process.stdin.isTTY || process.env.READYSTACK_MCP === '1')) return; // s152: 사람 자리(터미널·MCP 세션)에서만 센다 - 발행 1분 뒤 남의 실행기(JP · 우리 3대는 US)가 돌린 no_key 13건은 손님이 아니다
42
+ const body = JSON.stringify({ t: 'paywall', slug: SLUG, src: process.env.READYSTACK_MCP === '1' ? 'mcp' : 'cli', why: why || 'no_key' });
43
+ const req = https.request({ hostname: 'getreadystack.com', path: '/api/ev', method: 'POST', timeout: 3000,
44
+ headers: { 'content-type': 'application/json', 'content-length': Buffer.byteLength(body), 'user-agent': 'readystack-cli/' + SLUG } }, function (res) { res.resume(); });
45
+ req.on('timeout', function () { req.destroy(); }); req.on('error', function () {});
46
+ req.write(body); req.end();
47
+ } catch (e) { /* 세는 것이 실패해도 상품은 돈다 */ }
48
+ }
49
+ async function ensure(explicitKey) {
50
+ const st = load();
51
+ const key = explicitKey || process.env.READYSTACK_LICENSE || st.key;
52
+ if (!key) { pingPaywall('no_key'); return { ok: false, why: 'no_key' }; } // s151
53
+ const age = Date.now() - (st.okAt || 0);
54
+ if (!explicitKey && st.key === key && age < RECHECK_MS) return { ok: true, cached: true };
55
+ const r = await validate(String(key).trim());
56
+ if (r.ok) { save({ key: String(key).trim(), okAt: Date.now() }); return { ok: true }; }
57
+ if (r.offline && st.key === key && age < GRACE_MS) return { ok: true, offline: true };
58
+ if (!r.offline) pingPaywall('invalid'); // s151
59
+ return { ok: false, why: r.offline ? 'offline' : 'invalid' };
60
+ }
61
+ // ★s134 — 구독 규칙 피드(층3 "바뀌면 업데이트"): 키 있는 손님만 · 7일마다 · 오프라인은 캐시. 워커 GET /api/rules/<slug>?key=
62
+ const FEED_URL = 'https://getreadystack.com/api/rules/';
63
+ function pullFeed() {
64
+ const st = load(); const key = process.env.READYSTACK_LICENSE || st.key; const cached = st.feed || null;
65
+ if (!key) return Promise.resolve(cached);
66
+ if (cached && (Date.now() - (st.feedAt || 0)) < RECHECK_MS) return Promise.resolve(cached);
67
+ return new Promise(function (resolve) {
68
+ let req;
69
+ try {
70
+ req = https.get(FEED_URL + encodeURIComponent(SLUG) + '?key=' + encodeURIComponent(key), { timeout: 8000, headers: { 'user-agent': 'readystack-cli' } }, function (res) {
71
+ let buf = ''; res.on('data', function (d) { buf += d; });
72
+ res.on('end', function () {
73
+ if (res.statusCode !== 200) return resolve(cached);
74
+ try { const j = JSON.parse(buf); if (!j || !Array.isArray(j.rules)) return resolve(cached); save(Object.assign(load(), { feed: j, feedAt: Date.now() })); resolve(j); }
75
+ catch (e) { resolve(cached); }
76
+ });
77
+ });
78
+ } catch (e) { return resolve(cached); }
79
+ req.on('timeout', function () { req.destroy(); resolve(cached); });
80
+ req.on('error', function () { resolve(cached); });
81
+ });
82
+ }
83
+ module.exports = { ensure, BUY_URL, storePath, pullFeed };
package/package.json ADDED
@@ -0,0 +1,42 @@
1
+ {
2
+ "name": "@readystack/loeschkonzept-fristen-lint",
3
+ "version": "1.0.1",
4
+ "description": "Löschkonzept und Löschfristen-Tabelle prüfen: 16 Regeln zu § 147 AO, § 257 HGB, § 14b UStG, § 41 EStG, § 15 AGG und Art. 5 DSGVO, direkt in VS Code und im Browser.",
5
+ "license": "SEE LICENSE IN LICENSE.txt",
6
+ "publishConfig": {
7
+ "access": "public"
8
+ },
9
+ "keywords": [
10
+ "löschkonzept",
11
+ "löschfristen",
12
+ "aufbewahrungsfristen",
13
+ "dsgvo",
14
+ "gobd",
15
+ "§ 147 ao",
16
+ "beg iv",
17
+ "datenschutz"
18
+ ],
19
+ "homepage": "https://getreadystack.com",
20
+ "funding": "https://buy.polar.sh/polar_cl_j0sYK5M2L5REhRw2p2PONeb8WtblzQWGCbVU82rwl6B",
21
+ "bin": {
22
+ "loeschkonzept-fristen-lint": "cli.js"
23
+ },
24
+ "engines": {
25
+ "node": ">=18"
26
+ },
27
+ "mcpName": "io.github.jmshinhwa/loeschkonzept-fristen-lint",
28
+ "repository": {
29
+ "type": "git",
30
+ "url": "https://github.com/jmshinhwa/readystack-themes.git",
31
+ "directory": "loeschkonzept-fristen-lint"
32
+ },
33
+ "files": [
34
+ "cli.js",
35
+ "license.js",
36
+ "rules.json",
37
+ "strings.json",
38
+ "README.md",
39
+ "LICENSE.txt",
40
+ "engine.js"
41
+ ]
42
+ }
package/rules.json ADDED
@@ -0,0 +1,156 @@
1
+ [
2
+ {
3
+ "id": "LF01",
4
+ "kind": "period",
5
+ "sev": "error",
6
+ "label": "Zollunterlagen",
7
+ "re": "zollanmeldung|zollunterlagen|zolldokument|präferenznachweis|zollkodex",
8
+ "years": 10,
9
+ "ref": "§ 147 Abs. 1 Nr. 4a, Abs. 3 AO",
10
+ "over": "",
11
+ "under": "Unterlagen nach Art. 15 und Art. 163 Zollkodex der Union sind zehn Jahre aufzubewahren."
12
+ },
13
+ {
14
+ "id": "LF02",
15
+ "kind": "period",
16
+ "sev": "warning",
17
+ "label": "Lohnkonten",
18
+ "re": "lohnkont",
19
+ "years": 6,
20
+ "ref": "§ 41 Abs. 1 S. 9 EStG",
21
+ "over": "Lohnkonten sind bis zum Ablauf des sechsten Kalenderjahres nach der letzten Lohnzahlung aufzubewahren; länger gespeicherte Beschäftigtendaten verletzen die Speicherbegrenzung (Art. 5 Abs. 1 lit. e DSGVO).",
22
+ "under": "Lohnkonten sind bis zum Ablauf des sechsten Kalenderjahres nach der letzten Lohnzahlung aufzubewahren."
23
+ },
24
+ {
25
+ "id": "LF03",
26
+ "kind": "period_any",
27
+ "sev": "warning",
28
+ "label": "Lieferscheine",
29
+ "re": "lieferschein",
30
+ "unless": "buchungsbeleg",
31
+ "ref": "§ 147 Abs. 3 S. 3 und 4 AO",
32
+ "msg": "Lieferscheine, die keine Buchungsbelege sind: die Aufbewahrungsfrist endet mit Erhalt bzw. Versand der Rechnung (§ 147 Abs. 3 S. 3 und 4 AO), nicht nach Jahren."
33
+ },
34
+ {
35
+ "id": "LF04",
36
+ "kind": "period",
37
+ "sev": "error",
38
+ "label": "Verfahrensdokumentation / Organisationsunterlagen",
39
+ "re": "verfahrensdoku|arbeitsanweisung|organisationsunterlage",
40
+ "years": 10,
41
+ "ref": "§ 147 Abs. 1 Nr. 1, Abs. 3 AO",
42
+ "over": "",
43
+ "under": "Die zum Verständnis der Bücher erforderlichen Arbeitsanweisungen und Organisationsunterlagen sind zehn Jahre aufzubewahren."
44
+ },
45
+ {
46
+ "id": "LF05",
47
+ "kind": "period",
48
+ "sev": "error",
49
+ "label": "Bücher / Jahresabschlüsse",
50
+ "re": "jahresabschl|bilanz|inventar|lagebericht|hauptbuch|kassenbuch|handelsbüch|journal",
51
+ "years": 10,
52
+ "ref": "§ 147 Abs. 3 AO, § 257 Abs. 4 HGB",
53
+ "over": "",
54
+ "under": "Bücher, Inventare, Jahresabschlüsse und Lageberichte sind zehn Jahre aufzubewahren."
55
+ },
56
+ {
57
+ "id": "LF06",
58
+ "kind": "period",
59
+ "sev": "error",
60
+ "label": "Buchungsbelege",
61
+ "re": "buchungsbeleg|kontoauszug|kassenbeleg|\\bbelege\\b",
62
+ "years": 8,
63
+ "inst_years": 10,
64
+ "ref": "§ 147 Abs. 3 AO, § 257 Abs. 4 HGB",
65
+ "over": "Seit 01.01.2025 (BEG IV) gelten für Buchungsbelege acht statt zehn Jahre; zwei Jahre länger gespeicherte Namen, IBAN und Adressen verletzen die Speicherbegrenzung (Art. 5 Abs. 1 lit. e DSGVO). Zehn Jahre nur für Kreditinstitute, Versicherer und Wertpapierinstitute (§ 257 Abs. 4 S. 2 HGB).",
66
+ "under": "Buchungsbelege sind acht Jahre aufzubewahren."
67
+ },
68
+ {
69
+ "id": "LF07",
70
+ "kind": "period",
71
+ "sev": "error",
72
+ "label": "Rechnungen",
73
+ "re": "rechnung(en)?\\b|eingangsrechnung|ausgangsrechnung",
74
+ "years": 8,
75
+ "ref": "§ 14b Abs. 1 UStG",
76
+ "over": "Seit 01.01.2025 (BEG IV) sind Rechnungen acht statt zehn Jahre aufzubewahren; danach löschen (Art. 5 Abs. 1 lit. e, Art. 17 DSGVO).",
77
+ "under": "Rechnungen sind acht Jahre aufzubewahren."
78
+ },
79
+ {
80
+ "id": "LF08",
81
+ "kind": "period",
82
+ "sev": "warning",
83
+ "label": "Handels- und Geschäftsbriefe",
84
+ "re": "geschäftsbrief|handelsbrief|geschäftskorrespondenz",
85
+ "years": 6,
86
+ "ref": "§ 147 Abs. 3 AO, § 257 Abs. 4 HGB",
87
+ "over": "Empfangene und abgesandte Handels- und Geschäftsbriefe: sechs Jahre, nicht zehn; der Rest ist Speicherung ohne Rechtsgrundlage (Art. 5 Abs. 1 lit. e DSGVO).",
88
+ "under": "Handels- und Geschäftsbriefe sind sechs Jahre aufzubewahren."
89
+ },
90
+ {
91
+ "id": "LF09",
92
+ "kind": "min_months",
93
+ "sev": "warning",
94
+ "label": "Bewerbungsunterlagen",
95
+ "re": "bewerb",
96
+ "months": 2,
97
+ "ref": "§ 15 Abs. 4 AGG, Art. 17 Abs. 3 lit. e DSGVO",
98
+ "msg": "Bewerbungsunterlagen vor Ablauf von zwei Monaten nach Zugang der Absage gelöscht: in dieser Frist kann ein AGG-Anspruch geltend gemacht werden (§ 15 Abs. 4 AGG); zur Verteidigung von Rechtsansprüchen darf gespeichert werden (Art. 17 Abs. 3 lit. e DSGVO)."
99
+ },
100
+ {
101
+ "id": "LF10",
102
+ "kind": "forbid",
103
+ "sev": "error",
104
+ "re": "unbegrenzt|unbefristet|dauerhaft gespeichert|\\bdauerhaft\\b|für immer|nie gelöscht",
105
+ "ref": "Art. 5 Abs. 1 lit. e DSGVO",
106
+ "msg": "Unbegrenzte Speicherung: Art. 5 Abs. 1 lit. e DSGVO verlangt eine Speicherdauer, die nicht länger ist als für den Zweck erforderlich. Eine konkrete Frist oder ein Löschereignis eintragen."
107
+ },
108
+ {
109
+ "id": "LF11",
110
+ "kind": "forbid",
111
+ "sev": "warning",
112
+ "re": "(pauschal|alle|sämtliche|grundsätzlich).{0,60}(10|zehn) jahre",
113
+ "ref": "§ 147 Abs. 3 AO",
114
+ "msg": "Pauschal zehn Jahre für alle Unterlagen: § 147 Abs. 3 AO kennt zehn, acht und sechs Jahre. Buchungsbelege acht, Geschäftsbriefe sechs Jahre."
115
+ },
116
+ {
117
+ "id": "LF12",
118
+ "kind": "row_ref",
119
+ "sev": "warning",
120
+ "re": "\\d+\\s*(jahre?|monate?|wochen?|tage?)\\b|sofort|unverzüglich",
121
+ "ref": "Art. 5 Abs. 2 DSGVO",
122
+ "msg": "Tabellenzeile mit Frist, aber ohne Rechtsgrundlage (§ oder Art.). Für die Rechenschaftspflicht nach Art. 5 Abs. 2 DSGVO die Norm eintragen."
123
+ },
124
+ {
125
+ "id": "LF13",
126
+ "kind": "require",
127
+ "sev": "warning",
128
+ "re": "schluss des kalenderjahr|ende des kalenderjahr|ablauf des kalenderjahr|jahresende|31\\.12\\.",
129
+ "ref": "§ 147 Abs. 4 AO, § 257 Abs. 5 HGB",
130
+ "msg": "Fristbeginn fehlt: die Aufbewahrungsfrist beginnt mit dem Schluss des Kalenderjahres (§ 147 Abs. 4 AO, § 257 Abs. 5 HGB), nicht mit dem Belegdatum."
131
+ },
132
+ {
133
+ "id": "LF14",
134
+ "kind": "require",
135
+ "sev": "warning",
136
+ "re": "festsetzungsfrist|ablaufhemmung|§\\s*169",
137
+ "ref": "§ 147 Abs. 3 S. 5 AO",
138
+ "msg": "Hinweis auf die Festsetzungsfrist fehlt: die Aufbewahrungsfrist läuft nicht ab, solange die Unterlagen für Steuern mit offener Festsetzungsfrist von Bedeutung sind (§ 147 Abs. 3 S. 5 AO). Vor der Löschung prüfen."
139
+ },
140
+ {
141
+ "id": "LF15",
142
+ "kind": "require",
143
+ "sev": "info",
144
+ "re": "art\\.?\\s*5 abs\\.?\\s*1 lit\\.?\\s*e|speicherbegrenzung|art\\.?\\s*17",
145
+ "ref": "Art. 5 Abs. 1 lit. e, Art. 17 DSGVO",
146
+ "msg": "Kein Bezug auf Speicherbegrenzung (Art. 5 Abs. 1 lit. e DSGVO) oder das Recht auf Löschung (Art. 17 DSGVO). Das Löschkonzept sollte seinen Zweck nennen."
147
+ },
148
+ {
149
+ "id": "LF16",
150
+ "kind": "forbid",
151
+ "sev": "warning",
152
+ "re": "\\bTTDSG\\b",
153
+ "ref": "TDDDG",
154
+ "msg": "TTDSG heißt seit 14.05.2024 TDDDG (Telekommunikation-Digitale-Dienste-Datenschutz-Gesetz). Verweis aktualisieren."
155
+ }
156
+ ]
package/strings.json ADDED
@@ -0,0 +1,10 @@
1
+ {
2
+ "name": "Löschkonzept-Prüfer – Aufbewahrungsfristen 2026",
3
+ "subtitle": "Löschkonzept und Löschfristen-Tabelle prüfen: 16 Regeln zu § 147 AO, § 257 HGB, § 14b UStG, § 41 EStG, § 15 AGG und Art. 5 DSGVO, direkt in VS Code und im Browser.",
4
+ "bin": "loeschkonzept-fristen-lint",
5
+ "price": 29,
6
+ "free": "Prüft jedes offene Löschkonzept (.md) mit allen 16 Regeln, ohne Key, in VS Code und im Browser. Die Beispiel-Vorlage (Stand 2023) liefert 18 Befunde, darunter: Buchungsbelege 10 statt 8 Jahre, Rechnungen 10 statt 8 Jahre, Geschäftsbriefe 10 statt 6 Jahre, Lohnkonten 10 statt 6 Jahre, Jahresabschlüsse 6 statt 10 Jahre, Newsletter-Daten unbegrenzt.",
7
+ "paid": "$29 einmalig: Ordner-Prüfbericht über alle Löschkonzepte und Löschfristen-Tabellen eines Workspace als Datei, als Nachweis nach Art. 5 Abs. 2 DSGVO für Audit und Datenschutzbeauftragte. Ein Lizenzschlüssel pro Person oder Team-Platz.",
8
+ "need_key": "This option needs a licence (Löschkonzept-Prüfer – Aufbewahrungsfristen 2026).",
9
+ "exts": []
10
+ }