rulestamp-notebook-share-gate 1.0.5__tar.gz

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 (19) hide show
  1. rulestamp_notebook_share_gate-1.0.5/LICENSE.txt +15 -0
  2. rulestamp_notebook_share_gate-1.0.5/PKG-INFO +81 -0
  3. rulestamp_notebook_share_gate-1.0.5/README.md +61 -0
  4. rulestamp_notebook_share_gate-1.0.5/pyproject.toml +29 -0
  5. rulestamp_notebook_share_gate-1.0.5/setup.cfg +4 -0
  6. rulestamp_notebook_share_gate-1.0.5/src/rulestamp_notebook_share_gate/__init__.py +1 -0
  7. rulestamp_notebook_share_gate-1.0.5/src/rulestamp_notebook_share_gate/__main__.py +12 -0
  8. rulestamp_notebook_share_gate-1.0.5/src/rulestamp_notebook_share_gate/js/cli.js +161 -0
  9. rulestamp_notebook_share_gate-1.0.5/src/rulestamp_notebook_share_gate/js/engine.js +147 -0
  10. rulestamp_notebook_share_gate-1.0.5/src/rulestamp_notebook_share_gate/js/license.js +103 -0
  11. rulestamp_notebook_share_gate-1.0.5/src/rulestamp_notebook_share_gate/js/package.json +41 -0
  12. rulestamp_notebook_share_gate-1.0.5/src/rulestamp_notebook_share_gate/js/rules.json +148 -0
  13. rulestamp_notebook_share_gate-1.0.5/src/rulestamp_notebook_share_gate/js/strings.json +10 -0
  14. rulestamp_notebook_share_gate-1.0.5/src/rulestamp_notebook_share_gate.egg-info/PKG-INFO +81 -0
  15. rulestamp_notebook_share_gate-1.0.5/src/rulestamp_notebook_share_gate.egg-info/SOURCES.txt +17 -0
  16. rulestamp_notebook_share_gate-1.0.5/src/rulestamp_notebook_share_gate.egg-info/dependency_links.txt +1 -0
  17. rulestamp_notebook_share_gate-1.0.5/src/rulestamp_notebook_share_gate.egg-info/entry_points.txt +2 -0
  18. rulestamp_notebook_share_gate-1.0.5/src/rulestamp_notebook_share_gate.egg-info/requires.txt +1 -0
  19. rulestamp_notebook_share_gate-1.0.5/src/rulestamp_notebook_share_gate.egg-info/top_level.txt +1 -0
@@ -0,0 +1,15 @@
1
+ Notebook Share Gate — .ipynb output leak audit — Licence
2
+
3
+ Free scope
4
+ Audit the notebook you have open and name every leaking output cell, line by line. 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
+ Sweep every .ipynb in the workspace and export the dated audit record you keep on file. 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
@@ -0,0 +1,81 @@
1
+ Metadata-Version: 2.4
2
+ Name: rulestamp-notebook-share-gate
3
+ Version: 1.0.5
4
+ Summary: 18 rules that read saved .ipynb outputs — 23 findings in the 6-cell sample notebook, 0 in the cleared one (bundled Node.js runtime)
5
+ Author-email: Rulestamp <support@getreadystack.com>
6
+ License: Proprietary - see LICENSE.txt
7
+ Project-URL: Homepage, https://getreadystack.com/tools/notebook-share-gate?ref=pypi
8
+ Project-URL: Documentation, https://getreadystack.com/tools/notebook-share-gate?ref=pypi
9
+ Project-URL: Support, https://getreadystack.com/support
10
+ Keywords: jupyter,notebook,ipynb,secret scanning,pii,gdpr,data science
11
+ Classifier: Programming Language :: Python :: 3
12
+ Classifier: Environment :: Console
13
+ Classifier: Topic :: Software Development :: Quality Assurance
14
+ Classifier: Operating System :: OS Independent
15
+ Requires-Python: >=3.9
16
+ Description-Content-Type: text/markdown
17
+ License-File: LICENSE.txt
18
+ Requires-Dist: nodejs-wheel-binaries>=20
19
+ Dynamic: license-file
20
+
21
+ # Notebook Share Gate
22
+
23
+ > Runs the same checker as our npm package on a Node.js runtime that pip installs for you (`nodejs-wheel-binaries`) - no system Node.js needed. Your files are checked locally.
24
+
25
+ 18 rules that read saved .ipynb outputs — 23 findings in the 6-cell sample notebook, 0 in the cleared one
26
+
27
+ ## Install
28
+
29
+ ```
30
+ notebook-share-gate file
31
+ ```
32
+
33
+ Node 18+. The same 18 rules as the VS Code extension, from a terminal or CI.
34
+
35
+ ## Free
36
+
37
+ - Audit the .ipynb you have open: all 18 rules run over the saved outputs and every leak is named with its rule, severity and line number.
38
+ - `--rules` lists every rule
39
+
40
+ ## With a licence ($29 once)
41
+
42
+ - Sweep every .ipynb in the workspace in one pass and export the dated audit record you keep on file.
43
+
44
+ ```
45
+ notebook-share-gate --dir ./templates --report html --out report.html
46
+ ```
47
+
48
+ Hand-checking one notebook means reopening every saved output cell; GDPR Art. 83(5) caps the fine for missing one at EUR 20 million or 4 % of total worldwide annual turnover.
49
+
50
+ ## Use from an AI agent (MCP)
51
+
52
+ Claude Code · Cursor · Windsurf · any MCP client - add to your MCP config:
53
+
54
+ ```json
55
+ { "mcpServers": { "notebook-share-gate": { "command": "notebook-share-gate", "args": ["--mcp"] } } }
56
+ ```
57
+
58
+ Tools: `check_text` and `check_file` (free) · `check_dir` (licence). The agent gets every finding with the line number.
59
+
60
+ ## Use in CI
61
+
62
+ ```yaml
63
+ - name: Notebook Share Gate
64
+ run: pip install rulestamp-notebook-share-gate && notebook-share-gate --dir . --ci
65
+ ```
66
+
67
+
68
+ The folder sweep, reports and CI mode need one licence — one payment, no subscription. Set `READYSTACK_LICENSE=<key>` or run `--license <key>` once.
69
+
70
+ [Get a licence](https://getreadystack.com/api/buy/cl/polar_cl_UD1n6ljLUOrZtnOT9UfRLSi9NjUk6UvFwZB0a0Zgads)
71
+
72
+
73
+ <!-- notebook share gate -->
74
+
75
+
76
+ ## Install (PyPI)
77
+
78
+ ```
79
+ pip install rulestamp-notebook-share-gate
80
+ notebook-share-gate --help
81
+ ```
@@ -0,0 +1,61 @@
1
+ # Notebook Share Gate
2
+
3
+ > Runs the same checker as our npm package on a Node.js runtime that pip installs for you (`nodejs-wheel-binaries`) - no system Node.js needed. Your files are checked locally.
4
+
5
+ 18 rules that read saved .ipynb outputs — 23 findings in the 6-cell sample notebook, 0 in the cleared one
6
+
7
+ ## Install
8
+
9
+ ```
10
+ notebook-share-gate file
11
+ ```
12
+
13
+ Node 18+. The same 18 rules as the VS Code extension, from a terminal or CI.
14
+
15
+ ## Free
16
+
17
+ - Audit the .ipynb you have open: all 18 rules run over the saved outputs and every leak is named with its rule, severity and line number.
18
+ - `--rules` lists every rule
19
+
20
+ ## With a licence ($29 once)
21
+
22
+ - Sweep every .ipynb in the workspace in one pass and export the dated audit record you keep on file.
23
+
24
+ ```
25
+ notebook-share-gate --dir ./templates --report html --out report.html
26
+ ```
27
+
28
+ Hand-checking one notebook means reopening every saved output cell; GDPR Art. 83(5) caps the fine for missing one at EUR 20 million or 4 % of total worldwide annual turnover.
29
+
30
+ ## Use from an AI agent (MCP)
31
+
32
+ Claude Code · Cursor · Windsurf · any MCP client - add to your MCP config:
33
+
34
+ ```json
35
+ { "mcpServers": { "notebook-share-gate": { "command": "notebook-share-gate", "args": ["--mcp"] } } }
36
+ ```
37
+
38
+ Tools: `check_text` and `check_file` (free) · `check_dir` (licence). The agent gets every finding with the line number.
39
+
40
+ ## Use in CI
41
+
42
+ ```yaml
43
+ - name: Notebook Share Gate
44
+ run: pip install rulestamp-notebook-share-gate && notebook-share-gate --dir . --ci
45
+ ```
46
+
47
+
48
+ The folder sweep, reports and CI mode need one licence — one payment, no subscription. Set `READYSTACK_LICENSE=<key>` or run `--license <key>` once.
49
+
50
+ [Get a licence](https://getreadystack.com/api/buy/cl/polar_cl_UD1n6ljLUOrZtnOT9UfRLSi9NjUk6UvFwZB0a0Zgads)
51
+
52
+
53
+ <!-- notebook share gate -->
54
+
55
+
56
+ ## Install (PyPI)
57
+
58
+ ```
59
+ pip install rulestamp-notebook-share-gate
60
+ notebook-share-gate --help
61
+ ```
@@ -0,0 +1,29 @@
1
+ [build-system]
2
+ requires = ["setuptools>=68"]
3
+ build-backend = "setuptools.build_meta"
4
+
5
+ [project]
6
+ name = "rulestamp-notebook-share-gate"
7
+ version = "1.0.5"
8
+ description = "18 rules that read saved .ipynb outputs \u2014 23 findings in the 6-cell sample notebook, 0 in the cleared one (bundled Node.js runtime)"
9
+ readme = "README.md"
10
+ requires-python = ">=3.9"
11
+ dependencies = ["nodejs-wheel-binaries>=20"]
12
+ license = {text = "Proprietary - see LICENSE.txt"}
13
+ keywords = ["jupyter", "notebook", "ipynb", "secret scanning", "pii", "gdpr", "data science"]
14
+ authors = [{name = "Rulestamp", email = "support@getreadystack.com"}]
15
+ classifiers = ["Programming Language :: Python :: 3", "Environment :: Console", "Topic :: Software Development :: Quality Assurance", "Operating System :: OS Independent"]
16
+
17
+ [project.urls]
18
+ Homepage = "https://getreadystack.com/tools/notebook-share-gate?ref=pypi"
19
+ Documentation = "https://getreadystack.com/tools/notebook-share-gate?ref=pypi"
20
+ Support = "https://getreadystack.com/support"
21
+
22
+ [project.scripts]
23
+ "notebook-share-gate" = "rulestamp_notebook_share_gate.__main__:main"
24
+
25
+ [tool.setuptools.packages.find]
26
+ where = ["src"]
27
+
28
+ [tool.setuptools.package-data]
29
+ "rulestamp_notebook_share_gate" = ["js/*"]
@@ -0,0 +1,4 @@
1
+ [egg_info]
2
+ tag_build =
3
+ tag_date = 0
4
+
@@ -0,0 +1,12 @@
1
+ import os, sys
2
+
3
+
4
+ def main():
5
+ # Runs the same checker as the npm package on the Node.js runtime installed with this package (nodejs-wheel-binaries).
6
+ from nodejs_wheel import node
7
+ here = os.path.dirname(os.path.abspath(__file__))
8
+ return node([os.path.join(here, "js", "cli.js")] + sys.argv[1:])
9
+
10
+
11
+ if __name__ == "__main__":
12
+ sys.exit(main())
@@ -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); });
@@ -0,0 +1,147 @@
1
+ /* Notebook Share Gate — one brain, used by the VS Code extension and by the free web page.
2
+ Rules live in rules.json; this file only decides what counts as a finding in a .ipynb. */
3
+ (function (root) {
4
+ 'use strict';
5
+
6
+ var RULES = (typeof module !== 'undefined' && module.exports)
7
+ ? require('./rules.json')
8
+ : root.NB_RULES;
9
+
10
+ function re(src, flags) {
11
+ return new RegExp(src, flags || 'gi');
12
+ }
13
+
14
+ function joinSource(v) {
15
+ if (v == null) return '';
16
+ return Array.isArray(v) ? v.join('') : String(v);
17
+ }
18
+
19
+ // Everything a saved output can carry: stream text, text/plain, text/html, tracebacks.
20
+ function outputText(out) {
21
+ var parts = [];
22
+ if (!out || typeof out !== 'object') return '';
23
+ parts.push(joinSource(out.text));
24
+ if (Array.isArray(out.traceback)) parts.push(out.traceback.join('\n'));
25
+ if (out.evalue) parts.push(String(out.evalue));
26
+ var data = out.data;
27
+ if (data && typeof data === 'object') {
28
+ Object.keys(data).forEach(function (mime) {
29
+ if (mime.indexOf('text/') === 0 || mime === 'application/json') {
30
+ parts.push(joinSource(data[mime]));
31
+ }
32
+ });
33
+ }
34
+ return parts.filter(Boolean).join('\n');
35
+ }
36
+
37
+ // A hit is reported at the raw file line it sits on, so the editor can jump there.
38
+ function lineOf(rawLines, hit, fallback) {
39
+ if (!hit) return fallback;
40
+ var needles = [hit];
41
+ try { needles.push(JSON.stringify(hit).slice(1, -1)); } catch (e) { /* not encodable */ }
42
+ for (var n = 0; n < needles.length; n++) {
43
+ for (var i = 0; i < rawLines.length; i++) {
44
+ if (rawLines[i].indexOf(needles[n]) !== -1) return i + 1;
45
+ }
46
+ }
47
+ return fallback;
48
+ }
49
+
50
+ function cellStartLines(rawLines) {
51
+ var starts = [];
52
+ for (var i = 0; i < rawLines.length; i++) {
53
+ if (rawLines[i].indexOf('"cell_type"') !== -1) starts.push(i + 1);
54
+ }
55
+ return starts;
56
+ }
57
+
58
+ function short(s) {
59
+ s = String(s).replace(/\s+/g, ' ').trim();
60
+ return s.length > 48 ? s.slice(0, 24) + '…' + s.slice(-12) : s;
61
+ }
62
+
63
+ function check(text, opts) {
64
+ opts = opts || {};
65
+ var raw = String(text == null ? '' : text);
66
+ var rawLines = raw.split(/\r?\n/);
67
+ var findings = [];
68
+ var seen = {};
69
+
70
+ function add(rule, hit, line) {
71
+ var key = rule.id + '@' + line;
72
+ if (seen[key]) return;
73
+ seen[key] = 1;
74
+ findings.push({
75
+ check: rule.id,
76
+ sev: rule.sev,
77
+ msg: rule.msg.replace('{hit}', short(hit)),
78
+ line: line
79
+ });
80
+ }
81
+
82
+ var nb = null;
83
+ try { nb = JSON.parse(raw); } catch (e) { nb = null; }
84
+
85
+ // Segments carry their own kind so a rule only reads the part of the notebook it owns.
86
+ var segs = [];
87
+ if (nb && Array.isArray(nb.cells)) {
88
+ var starts = cellStartLines(rawLines);
89
+ nb.cells.forEach(function (cell, idx) {
90
+ var at = starts[idx] || 1;
91
+ segs.push({ kind: 'source', text: joinSource(cell.source), at: at });
92
+ (cell.outputs || []).forEach(function (out) {
93
+ segs.push({ kind: 'output', text: outputText(out), at: at });
94
+ });
95
+ });
96
+ } else {
97
+ // Not parseable as a notebook: read the whole file rather than report nothing.
98
+ segs.push({ kind: 'output', text: raw, at: 1 });
99
+ segs.push({ kind: 'source', text: raw, at: 1 });
100
+ }
101
+
102
+ RULES.forEach(function (rule) {
103
+ if (rule.where === 'struct') return;
104
+ var rx = re(rule.pat);
105
+ segs.forEach(function (seg) {
106
+ if (seg.kind !== rule.where || !seg.text) return;
107
+ rx.lastIndex = 0;
108
+ var m, guard = 0;
109
+ while ((m = rx.exec(seg.text)) !== null && guard++ < 200) {
110
+ add(rule, m[0], lineOf(rawLines, m[0], seg.at));
111
+ if (m.index === rx.lastIndex) rx.lastIndex++;
112
+ }
113
+ });
114
+ });
115
+
116
+ if (nb) {
117
+ var order = ruleById('execution_order_regressed');
118
+ if (order && Array.isArray(nb.cells)) {
119
+ var starts2 = cellStartLines(rawLines);
120
+ var high = 0;
121
+ for (var i = 0; i < nb.cells.length; i++) {
122
+ var n = nb.cells[i].execution_count;
123
+ if (typeof n !== 'number') continue;
124
+ if (n < high) { add(order, '', starts2[i] || 1); break; }
125
+ high = n;
126
+ }
127
+ }
128
+ var wid = ruleById('widget_state_saved');
129
+ var w = nb.metadata && nb.metadata.widgets;
130
+ if (wid && w && Object.keys(w).length) {
131
+ add(wid, '', lineOf(rawLines, '"widgets"', 1));
132
+ }
133
+ }
134
+
135
+ findings.sort(function (a, b) { return a.line - b.line; });
136
+ return { findings: findings };
137
+ }
138
+
139
+ function ruleById(id) {
140
+ for (var i = 0; i < RULES.length; i++) if (RULES[i].id === id) return RULES[i];
141
+ return null;
142
+ }
143
+
144
+ var api = { engine: { check: check }, RULES: RULES, RULE_COUNT: RULES.length };
145
+ if (typeof module !== 'undefined' && module.exports) module.exports = api;
146
+ root.NBGATE = api;
147
+ }(typeof window !== 'undefined' ? window : this));
@@ -0,0 +1,103 @@
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 = 'b0dcdc65-5f28-46bb-b2be-407f50a04784'; // s142 — this product's Polar benefit (s140 law: ask with benefit_id, or one key opens every product)
6
+ const BUY_URL = 'https://getreadystack.com/api/buy/cl/polar_cl_UD1n6ljLUOrZtnOT9UfRLSi9NjUk6UvFwZB0a0Zgads';
7
+ const SLUG = 'notebook-share-gate';
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
+ // s170 2026-09-29 — ask OUR worker first (/api/lic): keys bought on Whop open here (a price-tier key binds to the first tool it opens · the team key opens every tool). Then the old Polar check.
15
+ function validate(key) {
16
+ return validateHub(key).then(function (h) {
17
+ if (h.ok) return h;
18
+ 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); })
19
+ .then(function (r) { return r.ok ? r : { ok: false, offline: !!(h.offline || r.offline) }; });
20
+ });
21
+ }
22
+ function validateHub(key) {
23
+ return new Promise(function (resolve) {
24
+ const req = https.request({ hostname: 'getreadystack.com', path: '/api/lic?key=' + encodeURIComponent(key) + '&slug=' + encodeURIComponent(SLUG),
25
+ method: 'GET', timeout: 8000, headers: { 'accept': 'application/json', 'user-agent': 'readystack-cli/' + SLUG } }, function (res) {
26
+ let buf = ''; res.on('data', function (d) { buf += d; });
27
+ res.on('end', function () {
28
+ if (res.statusCode !== 200) return resolve({ ok: false, offline: res.statusCode >= 500 });
29
+ try { const j = JSON.parse(buf); resolve({ ok: !!(j && j.ok), offline: false }); } catch (e) { resolve({ ok: false, offline: false }); }
30
+ });
31
+ });
32
+ req.on('timeout', function () { req.destroy(); resolve({ ok: false, offline: true }); });
33
+ req.on('error', function () { resolve({ ok: false, offline: true }); });
34
+ req.end();
35
+ });
36
+ }
37
+ function validate1(key, ben) {
38
+ return new Promise(function (resolve) {
39
+ if (!ORG_ID) return resolve({ ok: false, offline: false });
40
+ 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 });
41
+ const req = https.request({ hostname: 'api.polar.sh', path: '/v1/customer-portal/license-keys/validate', method: 'POST', timeout: 8000,
42
+ headers: { 'content-type': 'application/json', 'polar-version': '2026-04', 'content-length': Buffer.byteLength(body) } }, function (res) {
43
+ let buf = ''; res.on('data', function (d) { buf += d; });
44
+ res.on('end', function () {
45
+ if (res.statusCode !== 200) return resolve({ ok: false, offline: false });
46
+ try { const j = JSON.parse(buf); resolve({ ok: j && (j.status === 'granted' || j.valid === true || !!j.id), offline: false }); }
47
+ catch (e) { resolve({ ok: false, offline: false }); }
48
+ });
49
+ });
50
+ req.on('timeout', function () { req.destroy(); resolve({ ok: false, offline: true }); });
51
+ req.on('error', function () { resolve({ ok: false, offline: true }); });
52
+ req.write(body); req.end();
53
+ });
54
+ }
55
+ // ★s151 2026-09-19 — 키 판(키가 없거나 거절된 순간)을 익명으로 센다 (슬러그·출처·이유만) · DO_NOT_TRACK=1 · READYSTACK_NO_TELEMETRY 면 안 보낸다 · 실패는 조용히 · 프로세스당 한 번.
56
+ let _pinged = false;
57
+ function pingPaywall(why) {
58
+ try {
59
+ if (_pinged) return; _pinged = true;
60
+ if (process.env.DO_NOT_TRACK === '1' || process.env.READYSTACK_NO_TELEMETRY || process.env.CI) return; // s151: CI(깃허브 액션 등)와 우리 빌드는 손님이 아니다
61
+ if (!(process.stdout.isTTY || process.stdin.isTTY || process.env.READYSTACK_MCP === '1')) return; // s152: 사람 자리(터미널·MCP 세션)에서만 센다 - 발행 1분 뒤 남의 실행기(JP · 우리 3대는 US)가 돌린 no_key 13건은 손님이 아니다
62
+ const body = JSON.stringify({ t: 'paywall', slug: SLUG, src: process.env.READYSTACK_MCP === '1' ? 'mcp' : 'cli', why: why || 'no_key' });
63
+ const req = https.request({ hostname: 'getreadystack.com', path: '/api/ev', method: 'POST', timeout: 3000,
64
+ headers: { 'content-type': 'application/json', 'content-length': Buffer.byteLength(body), 'user-agent': 'readystack-cli/' + SLUG } }, function (res) { res.resume(); });
65
+ req.on('timeout', function () { req.destroy(); }); req.on('error', function () {});
66
+ req.write(body); req.end();
67
+ } catch (e) { /* 세는 것이 실패해도 상품은 돈다 */ }
68
+ }
69
+ async function ensure(explicitKey) {
70
+ const st = load();
71
+ const key = explicitKey || process.env.READYSTACK_LICENSE || st.key;
72
+ if (!key) { pingPaywall('no_key'); return { ok: false, why: 'no_key' }; } // s151
73
+ const age = Date.now() - (st.okAt || 0);
74
+ if (!explicitKey && st.key === key && age < RECHECK_MS) return { ok: true, cached: true };
75
+ const r = await validate(String(key).trim());
76
+ if (r.ok) { save({ key: String(key).trim(), okAt: Date.now() }); return { ok: true }; }
77
+ if (r.offline && st.key === key && age < GRACE_MS) return { ok: true, offline: true };
78
+ if (!r.offline) pingPaywall('invalid'); // s151
79
+ return { ok: false, why: r.offline ? 'offline' : 'invalid' };
80
+ }
81
+ // ★s134 — 구독 규칙 피드(층3 "바뀌면 업데이트"): 키 있는 손님만 · 7일마다 · 오프라인은 캐시. 워커 GET /api/rules/<slug>?key=
82
+ const FEED_URL = 'https://getreadystack.com/api/rules/';
83
+ function pullFeed() {
84
+ const st = load(); const key = process.env.READYSTACK_LICENSE || st.key; const cached = st.feed || null;
85
+ if (!key) return Promise.resolve(cached);
86
+ if (cached && (Date.now() - (st.feedAt || 0)) < RECHECK_MS) return Promise.resolve(cached);
87
+ return new Promise(function (resolve) {
88
+ let req;
89
+ try {
90
+ req = https.get(FEED_URL + encodeURIComponent(SLUG) + '?key=' + encodeURIComponent(key), { timeout: 8000, headers: { 'user-agent': 'readystack-cli' } }, function (res) {
91
+ let buf = ''; res.on('data', function (d) { buf += d; });
92
+ res.on('end', function () {
93
+ if (res.statusCode !== 200) return resolve(cached);
94
+ 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); }
95
+ catch (e) { resolve(cached); }
96
+ });
97
+ });
98
+ } catch (e) { return resolve(cached); }
99
+ req.on('timeout', function () { req.destroy(); resolve(cached); });
100
+ req.on('error', function () { resolve(cached); });
101
+ });
102
+ }
103
+ module.exports = { ensure, BUY_URL, storePath, pullFeed };
@@ -0,0 +1,41 @@
1
+ {
2
+ "name": "@readystack/notebook-share-gate",
3
+ "version": "1.0.5",
4
+ "description": "18 rules that read saved .ipynb outputs — 23 findings in the 6-cell sample notebook, 0 in the cleared one",
5
+ "license": "SEE LICENSE IN LICENSE.txt",
6
+ "publishConfig": {
7
+ "access": "public"
8
+ },
9
+ "keywords": [
10
+ "jupyter",
11
+ "notebook",
12
+ "ipynb",
13
+ "secret scanning",
14
+ "pii",
15
+ "gdpr",
16
+ "data science"
17
+ ],
18
+ "homepage": "https://getreadystack.com",
19
+ "funding": "https://getreadystack.com/api/buy/cl/polar_cl_UD1n6ljLUOrZtnOT9UfRLSi9NjUk6UvFwZB0a0Zgads",
20
+ "bin": {
21
+ "notebook-share-gate": "cli.js"
22
+ },
23
+ "engines": {
24
+ "node": ">=18"
25
+ },
26
+ "mcpName": "io.github.jmshinhwa/notebook-share-gate",
27
+ "repository": {
28
+ "type": "git",
29
+ "url": "https://github.com/jmshinhwa/readystack-themes.git",
30
+ "directory": "notebook-share-gate"
31
+ },
32
+ "files": [
33
+ "cli.js",
34
+ "license.js",
35
+ "rules.json",
36
+ "strings.json",
37
+ "README.md",
38
+ "LICENSE.txt",
39
+ "engine.js"
40
+ ]
41
+ }
@@ -0,0 +1,148 @@
1
+ [
2
+ {
3
+ "id": "aws_access_key_id",
4
+ "sev": "error",
5
+ "where": "output",
6
+ "law": "GDPR Art. 32 / Art. 33",
7
+ "notify_hours": 72,
8
+ "fine_cap": "EUR 20 million or 4 % of total worldwide annual turnover (GDPR Art. 83(5))",
9
+ "pat": "\\bAKIA[0-9A-Z]{16}\\b",
10
+ "msg": "\"{hit}\" is a live AWS access key id sitting in a saved cell output. Rotate it in IAM, then clear the output before the file leaves this machine."
11
+ },
12
+ {
13
+ "id": "aws_secret_access_key",
14
+ "sev": "error",
15
+ "where": "output",
16
+ "law": "GDPR Art. 32",
17
+ "pat": "aws_secret_access_key['\"]?\\s*[:=]\\s*['\"]?[A-Za-z0-9/+=]{40}",
18
+ "msg": "A 40-character AWS secret access key was printed into an output cell. Rotate the key pair, then clear the output."
19
+ },
20
+ {
21
+ "id": "openai_style_api_key",
22
+ "sev": "error",
23
+ "where": "output",
24
+ "law": "GDPR Art. 32",
25
+ "pat": "\\bsk-[A-Za-z0-9_-]{20,}\\b",
26
+ "msg": "\"{hit}\" is an API key of the sk- family printed into an output cell. Revoke it in the provider console, then clear the output."
27
+ },
28
+ {
29
+ "id": "github_token",
30
+ "sev": "error",
31
+ "where": "output",
32
+ "law": "GDPR Art. 32",
33
+ "pat": "\\bgh[pousr]_[A-Za-z0-9]{30,}\\b",
34
+ "msg": "\"{hit}\" is a GitHub token in a saved output. It grants whatever the token's scopes grant to anyone who opens this .ipynb. Revoke and clear."
35
+ },
36
+ {
37
+ "id": "slack_token",
38
+ "sev": "error",
39
+ "where": "output",
40
+ "law": "GDPR Art. 32",
41
+ "pat": "\\bxox[abprs]-[A-Za-z0-9-]{10,}\\b",
42
+ "msg": "\"{hit}\" is a Slack token in a saved output. Revoke it in the app's OAuth settings, then clear the output."
43
+ },
44
+ {
45
+ "id": "bearer_jwt",
46
+ "sev": "error",
47
+ "where": "output",
48
+ "law": "GDPR Art. 32",
49
+ "pat": "\\beyJ[A-Za-z0-9_-]{8,}\\.[A-Za-z0-9_-]{8,}\\.[A-Za-z0-9_-]{5,}",
50
+ "msg": "A JWT was printed into an output cell. Anyone reading the notebook can replay it until it expires. Clear the output and shorten the token lifetime."
51
+ },
52
+ {
53
+ "id": "db_url_with_password",
54
+ "sev": "error",
55
+ "where": "output",
56
+ "law": "GDPR Art. 32",
57
+ "pat": "\\b(?:postgres(?:ql)?|mysql|mariadb|mongodb(?:\\+srv)?|redis|mssql|clickhouse):\\/\\/[^\\s:@'\"]+:[^\\s@'\"]{3,}@[^\\s'\"]+",
58
+ "msg": "\"{hit}\" is a database URL carrying its password in a saved output. Rotate the database credential and clear the output."
59
+ },
60
+ {
61
+ "id": "private_key_block",
62
+ "sev": "error",
63
+ "where": "output",
64
+ "law": "GDPR Art. 32",
65
+ "pat": "-----BEGIN (?:RSA |EC |DSA |OPENSSH |PGP )?PRIVATE KEY-----",
66
+ "msg": "A private key block was printed into an output cell. Treat the key as compromised, issue a new one, and clear the output."
67
+ },
68
+ {
69
+ "id": "email_in_output",
70
+ "sev": "error",
71
+ "where": "output",
72
+ "law": "GDPR Art. 4(1) / Art. 33",
73
+ "pat": "\\b[A-Za-z0-9._%+-]+@(?!example\\.(?:com|org|net)\\b)[A-Za-z0-9.-]+\\.(?!corp\\b|internal\\b|intranet\\b|local\\b|lan\\b)[A-Za-z]{2,}\\b",
74
+ "msg": "\"{hit}\" is an email address held in a saved output — personal data under GDPR Art. 4(1). A notebook shared with it is a disclosure you have 72 hours to report under Art. 33. Clear the output or mask the column."
75
+ },
76
+ {
77
+ "id": "iban_in_output",
78
+ "sev": "error",
79
+ "where": "output",
80
+ "law": "GDPR Art. 9 / Art. 33",
81
+ "pat": "\\b(?:AT|BE|CH|CZ|DE|DK|ES|FI|FR|GB|IE|IT|LU|NL|NO|PL|PT|SE)[0-9]{2}[ ]?(?:[0-9A-Z]{4}[ ]?){3,7}[0-9A-Z]{1,4}\\b",
82
+ "msg": "\"{hit}\" looks like an IBAN sitting in a saved output. Bank account numbers identify a person directly. Clear the output before the notebook is shared."
83
+ },
84
+ {
85
+ "id": "card_pan_in_output",
86
+ "sev": "error",
87
+ "where": "output",
88
+ "law": "PCI DSS 3.3 / GDPR Art. 33",
89
+ "pat": "\\b(?:4[0-9]{3}|5[1-5][0-9]{2})[ -]?[0-9]{4}[ -]?[0-9]{4}[ -]?[0-9]{4}\\b",
90
+ "msg": "\"{hit}\" has the shape of a full card number in a saved output. PCI DSS 3.3 allows at most the first six and last four digits to be displayed. Clear the output."
91
+ },
92
+ {
93
+ "id": "internal_hostname",
94
+ "sev": "warn",
95
+ "where": "output",
96
+ "law": "NIS2 Art. 21 (risk-management measures)",
97
+ "pat": "\\b[a-z0-9][a-z0-9-]{1,40}\\.(?:internal|intranet|corp|lan|local)\\b",
98
+ "msg": "\"{hit}\" is an internal hostname in a saved output. It maps your private network for whoever reads the notebook. Clear the output."
99
+ },
100
+ {
101
+ "id": "private_ip_in_output",
102
+ "sev": "warn",
103
+ "where": "output",
104
+ "law": "NIS2 Art. 21 (risk-management measures)",
105
+ "pat": "\\b(?:10\\.(?:[0-9]{1,3}\\.){2}[0-9]{1,3}|192\\.168\\.[0-9]{1,3}\\.[0-9]{1,3}|172\\.(?:1[6-9]|2[0-9]|3[01])\\.[0-9]{1,3}\\.[0-9]{1,3})\\b",
106
+ "msg": "\"{hit}\" is a private network address in a saved output. Together with a hostname it is a map of your internal estate. Clear the output."
107
+ },
108
+ {
109
+ "id": "local_user_path",
110
+ "sev": "warn",
111
+ "where": "output",
112
+ "law": "GDPR Art. 4(1)",
113
+ "pat": "(?:\\/(?:home|Users)\\/[A-Za-z0-9._-]{2,}\\/)|(?:[Cc]:\\\\Users\\\\[A-Za-z0-9._-]{2,}\\\\)",
114
+ "msg": "\"{hit}\" is a traceback path carrying a named person's home directory. The employee name travels with the notebook. Clear the output."
115
+ },
116
+ {
117
+ "id": "env_secret_dump",
118
+ "sev": "error",
119
+ "where": "output",
120
+ "law": "GDPR Art. 32",
121
+ "pat": "'[A-Z][A-Z0-9_]{2,}_(?:TOKEN|SECRET|PASSWORD|PASSWD|API_KEY|APIKEY|CREDENTIALS)':\\s*'[^']{4,}'",
122
+ "msg": "\"{hit}\" is an environment variable printed with its value — the classic os.environ dump. Rotate what it names and clear the output."
123
+ },
124
+ {
125
+ "id": "hardcoded_secret_in_source",
126
+ "sev": "warn",
127
+ "where": "source",
128
+ "law": "GDPR Art. 32",
129
+ "pat": "\\b(?:api_key|apikey|password|passwd|secret|token|access_key)\\s*=\\s*[\"'][^\"'\\s]{8,}[\"']",
130
+ "msg": "\"{hit}\" hard-codes a credential in the cell source, so clearing outputs will not remove it. Move it to an environment variable or a .env file that is git-ignored."
131
+ },
132
+ {
133
+ "id": "execution_order_regressed",
134
+ "sev": "warn",
135
+ "where": "struct",
136
+ "pat": "",
137
+ "law": "reproducibility",
138
+ "msg": "Cell execution counts run out of order, so the saved outputs were not produced by a top-to-bottom run. Whoever audits this notebook cannot reproduce the numbers it shows. Restart and run all before sharing."
139
+ },
140
+ {
141
+ "id": "widget_state_saved",
142
+ "sev": "warn",
143
+ "where": "struct",
144
+ "pat": "",
145
+ "law": "GDPR Art. 5(1)(c)",
146
+ "msg": "The notebook carries saved ipywidgets state in its metadata. Widget state keeps a copy of values the visible outputs no longer show. Clear widget state before sharing."
147
+ }
148
+ ]
@@ -0,0 +1,10 @@
1
+ {
2
+ "name": "Notebook Share Gate",
3
+ "subtitle": "18 rules that read saved .ipynb outputs — 23 findings in the 6-cell sample notebook, 0 in the cleared one",
4
+ "bin": "notebook-share-gate",
5
+ "price": 29,
6
+ "free": "Audit the .ipynb you have open: all 18 rules run over the saved outputs and every leak is named with its rule, severity and line number.",
7
+ "paid": "Sweep every .ipynb in the workspace in one pass and export the dated audit record you keep on file.",
8
+ "need_key": "This option needs a licence (Notebook Share Gate).",
9
+ "exts": []
10
+ }
@@ -0,0 +1,81 @@
1
+ Metadata-Version: 2.4
2
+ Name: rulestamp-notebook-share-gate
3
+ Version: 1.0.5
4
+ Summary: 18 rules that read saved .ipynb outputs — 23 findings in the 6-cell sample notebook, 0 in the cleared one (bundled Node.js runtime)
5
+ Author-email: Rulestamp <support@getreadystack.com>
6
+ License: Proprietary - see LICENSE.txt
7
+ Project-URL: Homepage, https://getreadystack.com/tools/notebook-share-gate?ref=pypi
8
+ Project-URL: Documentation, https://getreadystack.com/tools/notebook-share-gate?ref=pypi
9
+ Project-URL: Support, https://getreadystack.com/support
10
+ Keywords: jupyter,notebook,ipynb,secret scanning,pii,gdpr,data science
11
+ Classifier: Programming Language :: Python :: 3
12
+ Classifier: Environment :: Console
13
+ Classifier: Topic :: Software Development :: Quality Assurance
14
+ Classifier: Operating System :: OS Independent
15
+ Requires-Python: >=3.9
16
+ Description-Content-Type: text/markdown
17
+ License-File: LICENSE.txt
18
+ Requires-Dist: nodejs-wheel-binaries>=20
19
+ Dynamic: license-file
20
+
21
+ # Notebook Share Gate
22
+
23
+ > Runs the same checker as our npm package on a Node.js runtime that pip installs for you (`nodejs-wheel-binaries`) - no system Node.js needed. Your files are checked locally.
24
+
25
+ 18 rules that read saved .ipynb outputs — 23 findings in the 6-cell sample notebook, 0 in the cleared one
26
+
27
+ ## Install
28
+
29
+ ```
30
+ notebook-share-gate file
31
+ ```
32
+
33
+ Node 18+. The same 18 rules as the VS Code extension, from a terminal or CI.
34
+
35
+ ## Free
36
+
37
+ - Audit the .ipynb you have open: all 18 rules run over the saved outputs and every leak is named with its rule, severity and line number.
38
+ - `--rules` lists every rule
39
+
40
+ ## With a licence ($29 once)
41
+
42
+ - Sweep every .ipynb in the workspace in one pass and export the dated audit record you keep on file.
43
+
44
+ ```
45
+ notebook-share-gate --dir ./templates --report html --out report.html
46
+ ```
47
+
48
+ Hand-checking one notebook means reopening every saved output cell; GDPR Art. 83(5) caps the fine for missing one at EUR 20 million or 4 % of total worldwide annual turnover.
49
+
50
+ ## Use from an AI agent (MCP)
51
+
52
+ Claude Code · Cursor · Windsurf · any MCP client - add to your MCP config:
53
+
54
+ ```json
55
+ { "mcpServers": { "notebook-share-gate": { "command": "notebook-share-gate", "args": ["--mcp"] } } }
56
+ ```
57
+
58
+ Tools: `check_text` and `check_file` (free) · `check_dir` (licence). The agent gets every finding with the line number.
59
+
60
+ ## Use in CI
61
+
62
+ ```yaml
63
+ - name: Notebook Share Gate
64
+ run: pip install rulestamp-notebook-share-gate && notebook-share-gate --dir . --ci
65
+ ```
66
+
67
+
68
+ The folder sweep, reports and CI mode need one licence — one payment, no subscription. Set `READYSTACK_LICENSE=<key>` or run `--license <key>` once.
69
+
70
+ [Get a licence](https://getreadystack.com/api/buy/cl/polar_cl_UD1n6ljLUOrZtnOT9UfRLSi9NjUk6UvFwZB0a0Zgads)
71
+
72
+
73
+ <!-- notebook share gate -->
74
+
75
+
76
+ ## Install (PyPI)
77
+
78
+ ```
79
+ pip install rulestamp-notebook-share-gate
80
+ notebook-share-gate --help
81
+ ```
@@ -0,0 +1,17 @@
1
+ LICENSE.txt
2
+ README.md
3
+ pyproject.toml
4
+ src/rulestamp_notebook_share_gate/__init__.py
5
+ src/rulestamp_notebook_share_gate/__main__.py
6
+ src/rulestamp_notebook_share_gate.egg-info/PKG-INFO
7
+ src/rulestamp_notebook_share_gate.egg-info/SOURCES.txt
8
+ src/rulestamp_notebook_share_gate.egg-info/dependency_links.txt
9
+ src/rulestamp_notebook_share_gate.egg-info/entry_points.txt
10
+ src/rulestamp_notebook_share_gate.egg-info/requires.txt
11
+ src/rulestamp_notebook_share_gate.egg-info/top_level.txt
12
+ src/rulestamp_notebook_share_gate/js/cli.js
13
+ src/rulestamp_notebook_share_gate/js/engine.js
14
+ src/rulestamp_notebook_share_gate/js/license.js
15
+ src/rulestamp_notebook_share_gate/js/package.json
16
+ src/rulestamp_notebook_share_gate/js/rules.json
17
+ src/rulestamp_notebook_share_gate/js/strings.json
@@ -0,0 +1,2 @@
1
+ [console_scripts]
2
+ notebook-share-gate = rulestamp_notebook_share_gate.__main__:main