readystack-agentforce-action-audit 1.0.1__py3-none-any.whl

readystack_agentforce_action_audit/__init__.py

@@ -0,0 +1 @@
+__version__ = '1.0.1'

readystack_agentforce_action_audit/__main__.py

@@ -0,0 +1,12 @@
+import os, sys
+
+
+def main():
+    # Runs the same checker as the npm package on the Node.js runtime installed with this package (nodejs-wheel-binaries).
+    from nodejs_wheel import node
+    here = os.path.dirname(os.path.abspath(__file__))
+    return node([os.path.join(here, "js", "cli.js")] + sys.argv[1:])
+
+
+if __name__ == "__main__":
+    sys.exit(main())

readystack_agentforce_action_audit/js/cli.js

@@ -0,0 +1,161 @@
+#!/usr/bin/env node
+// cli.js — the same rules as the VS Code extension, run from a terminal or a container. Generated by adapters.py.
+'use strict';
+const fs = require('fs'), path = require('path');
+const RULES = require('./rules.json');
+const S = require('./strings.json');
+const lic = require('./license.js');
+const ENGINE = require('./engine.js');   // s144 — scaffold products: the same engine the VS Code extension runs
+const RULE_LIST = Array.isArray(ENGINE.RULES) ? ENGINE.RULES : (Array.isArray(RULES) ? RULES : []);
+const RULE_N = ENGINE.RULE_COUNT || RULE_LIST.length;
+function scan(text, file) {
+  const r = ENGINE.engine.check(String(text), { today: new Date().toISOString().slice(0, 10), path: file || '' });
+  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') }));
+}
+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; } }
+function walk(dir, exts, out) {
+  let ents = []; try { ents = fs.readdirSync(dir, { withFileTypes: true }); } catch (e) { return out; }
+  for (const e of ents) {
+    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 를 못 봤다)
+    const p = path.join(dir, e.name);
+    if (e.isDirectory()) walk(p, exts, out);
+    else if ((!exts.length || exts.includes(path.extname(e.name).toLowerCase())) && isText(p)) out.push(p);
+  }
+  return out;
+}
+function esc(s) { return String(s).replace(/&/g, '&amp;').replace(/</g, '&lt;').replace(/>/g, '&gt;'); }
+function csvq(s) { return '"' + String(s == null ? '' : s).replace(/"/g, '""') + '"'; }
+function render(rows, fmt) {
+  if (fmt === 'json') return JSON.stringify({ tool: S.name, rules: RULE_N, files: rows }, null, 1);
+  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'; }
+  if (fmt === 'html') {
+    const n = rows.reduce((a, r) => a + r.hits.length, 0);
+    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>';
+    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>';
+    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>';
+    return o + '</table>';
+  }
+  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'; }
+  return o;
+}
+function trialState() {
+  // s158 — ⚑7일 무료 없음: 새 체험은 ⛔열지 않는다 · 이미 시작된 체험(trial.json)만 끝까지 지킨다 (읽기 전용)
+  if (process.env.READYSTACK_NO_TRIAL) return { active: false };
+  try {
+    const p = path.join(path.dirname(lic.storePath()), S.bin + '.trial.json');
+    const t = JSON.parse(fs.readFileSync(p, 'utf8'));
+    return { active: !!(t && t.until) && new Date(t.until + 'T23:59:59Z').getTime() > Date.now(), until: t && t.until };
+  } catch (e) { return { active: false }; }
+}
+// ★s158 2026-09-23 — the free run SPEAKS about the rest of the folder (vsix: auto.js · crx: welcome tab).
+//   The answer for the named files is complete and free; the next step is shown with the user's OWN numbers:
+//   "this folder has N more matching files - M issues in K of them" + the one command that sweeps them.
+//   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.
+function folderHint(done) {
+  if (!process.stderr.isTTY || process.env.CI || process.env.READYSTACK_NO_HINT || !done.length) return;
+  const base = path.dirname(path.resolve(done[0]));
+  const seen = new Set(done.map((f) => path.resolve(f)));
+  const all = walk(base, S.exts || [], []).filter((f) => !seen.has(path.resolve(f)));
+  if (!all.length) return;
+  const t0 = Date.now(); let issues = 0, hitFiles = 0, scanned = 0;
+  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++; } }
+  const rel = path.relative(process.cwd(), base) || '.';
+  const tail = trialState().active ? 'free during your trial' : '$' + S.price + ' once';
+  const more = all.length + ' more matching file' + (all.length > 1 ? 's' : '');
+  const found = issues ? ' - ' + (scanned < all.length ? 'at least ' : '') + issues + ' issue' + (issues > 1 ? 's' : '') + ' in ' + hitFiles + ' of them' : ' - no issues found in them';
+  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' : ''));
+}
+let _usePinged = false;
+function pingUse() {
+  try {
+    if (_usePinged) return; _usePinged = true;
+    if (process.env.DO_NOT_TRACK === '1' || process.env.READYSTACK_NO_TELEMETRY || process.env.CI) return;
+    if (!(process.stdout.isTTY || process.stdin.isTTY)) return;   // human seat only (s152)
+    const https = require('https');
+    const body = JSON.stringify({ t: 'use', slug: S.bin, src: 'cli', why: 'free' });
+    const req = https.request({ hostname: 'getreadystack.com', path: '/api/ev', method: 'POST', timeout: 3000,
+      headers: { 'content-type': 'application/json', 'content-length': Buffer.byteLength(body), 'user-agent': 'readystack-cli/' + S.bin } }, function (res) { res.resume(); });
+    req.on('timeout', function () { req.destroy(); }); req.on('error', function () {});
+    req.write(body); req.end();
+  } catch (e) {}
+}
+function mcpServe() {
+  process.env.READYSTACK_MCP = '1';   // s152 - 에이전트(Claude Code·Cursor)가 부른 세션은 사람 자리다 · 키 판 핑 src=mcp
+  // s144 — MCP server over stdio (newline-delimited JSON-RPC · no dependencies). Free: check_text · check_file. Licence (s158: no free trial): check_dir.
+  const rl = require('readline').createInterface({ input: process.stdin });
+  const send = (o) => process.stdout.write(JSON.stringify(o) + '\n');
+  const tools = [
+    { 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'] } },
+    { name: 'check_file', description: S.name + ' - run all checks on one file by path (free)', inputSchema: { type: 'object', properties: { path: { type: 'string' } }, required: ['path'] } },
+    { 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'] } }
+  ];
+  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 } } });
+  const fail = (id, text) => send({ jsonrpc: '2.0', id, result: { content: [{ type: 'text', text }], isError: true } });
+  rl.on('line', async (line) => {
+    let m; try { m = JSON.parse(line); } catch (e) { return; }
+    const id = m.id, method = m.method;
+    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' } } });
+    if (method === 'notifications/initialized' || method === 'ping') { if (id !== undefined) send({ jsonrpc: '2.0', id, result: {} }); return; }
+    if (method === 'tools/list') return send({ jsonrpc: '2.0', id, result: { tools } });
+    if (method === 'tools/call') {
+      const name = (m.params || {}).name, args = (m.params || {}).arguments || {};
+      try {
+        if (name === 'check_text') return result(id, [{ file: args.path || '(text)', hits: scan(String(args.text || ''), args.path || '') }]);
+        if (name === 'check_file') return result(id, [{ file: args.path, hits: scan(fs.readFileSync(args.path, 'utf8'), args.path) }]);
+        if (name === 'check_dir') {
+          const r = await lic.ensure();
+          if (!r.ok && !trialState().active) return fail(id, S.need_key + ' Get a licence ($' + S.price + ', once): ' + lic.BUY_URL);
+          const files = walk(args.dir, args.ext ? [args.ext] : (S.exts || []), []);
+          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) }; }));
+        }
+        return send({ jsonrpc: '2.0', id, error: { code: -32601, message: 'unknown tool ' + name } });
+      } catch (e) { return fail(id, String(e && e.message || e)); }
+    }
+    if (id !== undefined) send({ jsonrpc: '2.0', id, error: { code: -32601, message: 'method not found: ' + method } });
+  });
+}
+function help() {
+  return [S.name + ' - ' + S.subtitle, '', 'Usage: ' + S.bin + ' <file> [more files]           check the files you name (free, every rule)',
+    '       ' + S.bin + ' --dir <folder> [--ext .html]  scan a whole folder            (licence)',
+    '       ' + S.bin + ' ... --report csv|json|html [--out file]   export a report   (licence)',
+    '       ' + S.bin + ' ... --ci                      exit 1 when an error-level finding exists (licence)',
+    '       ' + S.bin + ' --license <key>               store your licence key (or set READYSTACK_LICENSE)',
+    '       ' + S.bin + ' --rules                       list the ' + RULE_N + ' rules',
+    '       ' + S.bin + ' --mcp                         run as an MCP server (stdio) for Claude Code / Cursor / Windsurf - free checks, folder sweep needs a licence', '',
+    'Free: ' + S.free, 'Licence ($' + S.price + ', once): ' + S.paid, 'Get a licence: ' + lic.BUY_URL, ''].join('\n');
+}
+(async function main() {
+  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 구독 피드 병합 (키 있는 손님만)
+  const a = process.argv.slice(2);
+  const get = (k) => { const i = a.indexOf(k); return i >= 0 ? a[i + 1] : null; };
+  if (a.includes('--mcp')) { mcpServe(); return; }
+  if (!a.length || a.includes('--help') || a.includes('-h')) { process.stdout.write(help()); return; }
+  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; }
+  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); }
+  const dir = get('--dir'), fmt = get('--report'), out = get('--out'), ci = a.includes('--ci');
+  const exts = a.includes('--ext') ? [get('--ext')] : (S.exts || []);
+  const paid = !!(dir || fmt || ci);
+  if (paid) {
+    const r = await lic.ensure();
+    if (!r.ok) {
+      const t = trialState();   // s158 — ⚑7일 무료 없음 · 이미 시작된 체험만 지킨다
+      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');
+      else {
+        // s158 — the key is asked WITH the customer's own count (endowment · open loop): how many issues this folder holds.
+        let own = '';
+        if (dir) { try { const all = walk(dir, exts, []); let n = 0, k = 0, sc = 0; const t0 = Date.now();
+          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++; } }
+          if (n) own = dir + ': ' + (sc < all.length ? 'at least ' : '') + n + ' issue' + (n > 1 ? 's' : '') + ' in ' + k + ' of ' + all.length + ' files.\n'; } catch (e) {} }
+        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);
+      }
+    }
+  }
+  const files = dir ? walk(dir, exts, []) : a.filter((x, i) => !x.startsWith('--') && !['--dir', '--report', '--out', '--ext', '--license'].includes(a[i - 1]));
+  if (!files.length) { process.stderr.write('No files. ' + S.bin + ' --help\n'); process.exit(2); }
+  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) }; });
+  const text = render(rows, fmt || 'text');
+  if (out) fs.writeFileSync(out, text); else process.stdout.write(text.endsWith('\n') ? text : text + '\n');
+  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)
+  const errors = rows.reduce((n, r) => n + r.hits.filter((h) => h.sev === 'error').length, 0);
+  if (ci && errors) process.exit(1);
+})().catch((e) => { process.stderr.write(String(e && e.stack || e) + '\n'); process.exit(3); });

readystack_agentforce_action_audit/js/engine.js

@@ -0,0 +1,139 @@
+/* Agentforce Action Audit - one engine, runs in VS Code and in the browser. */
+(function () {
+  'use strict';
+
+  var RULES = (typeof module !== 'undefined' && module.exports)
+    ? require('./rules.json')
+    : window.AFA_RULES;
+
+  var BY_ID = {};
+  for (var i = 0; i < RULES.length; i++) BY_ID[RULES[i].id] = RULES[i];
+
+  var DISCLOSURE = /(\bA\.?I\b)|artificial intelligence|automated (assistant|agent)|virtual (agent|assistant)|not a human|chatbot/i;
+  var PLACEHOLDER = /\bTODO\b|\bFIXME\b|lorem ipsum|\[insert|<insert|your company name|\bXXXX\b/i;
+  var EMAIL = /[A-Za-z0-9._%+-]+@[A-Za-z0-9.-]+\.[A-Za-z]{2,}/;
+  var PHONE = /\+\d{1,3}[\s.-]?\(?\d{2,4}\)?[\s.-]?\d{3,4}[\s.-]?\d{3,4}/;
+  var NATID = /\b\d{3}-\d{2}-\d{4}\b/;
+  var AMP = /&(?![A-Za-z#][A-Za-z0-9]{0,8};)/g;
+
+  function flat(s) { return String(s || '').replace(/\s+/g, ' ').trim(); }
+
+  function check(text, opts) {
+    opts = opts || {};
+    var src = String(text || '');
+    var today = String(opts.today || '');
+    var findings = [];
+
+    function lineOf(idx) {
+      if (idx < 0) idx = 0;
+      return src.slice(0, idx).split('\n').length;
+    }
+    function add(id, idx, extra) {
+      var r = BY_ID[id];
+      if (!r) return;
+      var sev = r.sev;
+      if (id === 'no_ai_disclosure' && today && today < '2026-08-02') sev = 'warn';
+      findings.push({
+        check: id,
+        sev: sev,
+        msg: extra ? r.msg + ' (' + extra + ')' : r.msg,
+        line: lineOf(idx)
+      });
+    }
+
+    /* instruction blocks */
+    var instrs = [];
+    var blockRe = /<genAiPluginInstructions>([\s\S]*?)<\/genAiPluginInstructions>/g;
+    var m;
+    while ((m = blockRe.exec(src)) !== null) {
+      instrs.push({ body: m[1], index: m.index });
+    }
+    var outside = src.replace(blockRe, '');
+
+    function tagIn(hay, name) {
+      var re = new RegExp('<' + name + '>([\\s\\S]*?)</' + name + '>');
+      var hit = re.exec(hay);
+      return hit ? flat(hit[1]) : null;
+    }
+    function idxOf(name) {
+      var at = src.indexOf('<' + name + '>');
+      return at < 0 ? 0 : at;
+    }
+
+    var rootAt = src.search(/<GenAiPlugin[\s>]|<GenAiPlannerBundle[\s>]|<GenAiPlanner[\s>]/);
+    if (rootAt < 0) rootAt = 0;
+
+    /* 1-2 top level identity */
+    if (!tagIn(outside, 'masterLabel')) add('missing_master_label', rootAt);
+    if (!tagIn(outside, 'description')) add('missing_description', rootAt);
+
+    /* 3-4 scope */
+    var scope = tagIn(outside, 'scope');
+    if (scope === null) {
+      add('missing_scope', rootAt);
+    } else if (scope.length < 40) {
+      add('scope_too_short', idxOf('scope'), scope.length + ' characters');
+    }
+
+    /* 5 instructions present */
+    if (instrs.length === 0) add('no_instructions', rootAt);
+
+    /* 6 duplicate instruction developerName */
+    var seen = {};
+    for (var a = 0; a < instrs.length; a++) {
+      var dn = tagIn(instrs[a].body, 'developerName');
+      if (!dn) continue;
+      if (seen[dn]) add('duplicate_instruction_name', instrs[a].index, dn);
+      seen[dn] = true;
+    }
+
+    /* prompt text = every instruction description + scope */
+    var prompt = [];
+    for (var b = 0; b < instrs.length; b++) {
+      var d = tagIn(instrs[b].body, 'description');
+      prompt.push({ text: d || '', index: instrs[b].index });
+    }
+    if (scope) prompt.push({ text: scope, index: idxOf('scope') });
+    var promptAll = prompt.map(function (p) { return p.text; }).join(' \n ');
+
+    /* 7 placeholder, 10 pii, 11 insecure endpoint - per instruction */
+    for (var c = 0; c < prompt.length; c++) {
+      var t = prompt[c].text;
+      if (PLACEHOLDER.test(t)) add('instruction_placeholder', prompt[c].index);
+      var pii = EMAIL.exec(t) || PHONE.exec(t) || NATID.exec(t);
+      if (pii) add('pii_in_instruction', prompt[c].index, pii[0]);
+      if (/http:\/\//i.test(t)) add('insecure_endpoint', prompt[c].index);
+    }
+
+    /* 8 function never referenced */
+    var fnRe = /<functionName>([\s\S]*?)<\/functionName>/g;
+    var f;
+    while ((f = fnRe.exec(src)) !== null) {
+      var name = flat(f[1]);
+      if (!name) continue;
+      var loose = name.replace(/_/g, ' ');
+      if (promptAll.indexOf(name) === -1 && promptAll.toLowerCase().indexOf(loose.toLowerCase()) === -1) {
+        add('function_not_referenced', f.index, name);
+      }
+    }
+
+    /* 9 AI disclosure */
+    if (instrs.length > 0 && !DISCLOSURE.test(promptAll)) add('no_ai_disclosure', instrs[0].index);
+
+    /* 12 unescaped ampersand - anywhere in the file */
+    var amp;
+    AMP.lastIndex = 0;
+    while ((amp = AMP.exec(src)) !== null) add('unescaped_ampersand', amp.index);
+
+    /* 13 stale apiVersion */
+    var av = /<apiVersion>\s*([0-9]+(?:\.[0-9]+)?)\s*<\/apiVersion>/.exec(src);
+    if (av && parseFloat(av[1]) < 62) add('stale_api_version', av.index, av[1]);
+
+    findings.sort(function (x, y) { return x.line - y.line; });
+    return { findings: findings };
+  }
+
+  var API = { engine: { check: check }, RULES: RULES, RULE_COUNT: RULES.length };
+  if (typeof module !== 'undefined' && module.exports) module.exports = API;
+  if (typeof window !== 'undefined') window.AFAENGINE = API;
+})();

readystack_agentforce_action_audit/js/license.js

@@ -0,0 +1,83 @@
+// license.js — Polar licence check for the CLI / container. Generated by adapters.py; do not edit by hand.
+'use strict';
+const https = require('https'), fs = require('fs'), path = require('path'), os = require('os');
+const ORG_ID = 'a5cdf664-d8e7-4f87-8895-056717aaba17';
+const BENEFIT_ID = '357fc648-a9a2-4467-8418-5f55bbff2c13';   // s142 — this product's Polar benefit (s140 law: ask with benefit_id, or one key opens every product)
+const BUY_URL = 'https://buy.polar.sh/polar_cl_cItF01AndFQi4JGgKXw93gpuOPFIXq4LLR70d42siAL';
+const SLUG = 'agentforce-action-audit';
+const GRACE_MS = 30 * 24 * 3600 * 1000;   // after a successful check, 30 days work offline
+const RECHECK_MS = 7 * 24 * 3600 * 1000;  // re-ask Polar every 7 days (refunds / cancellations)
+function storePath() { return path.join(process.env.READYSTACK_HOME || path.join(os.homedir(), '.config', 'readystack'), SLUG + '.json'); }
+function load() { try { return JSON.parse(fs.readFileSync(storePath(), 'utf8')); } catch (e) { return {}; } }
+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 */ } }
+const ALL_BENEFIT_ID = '22692551-5203-4467-b1a3-e33cdba6589d';   // s149 2026-09-17 — 팀 키(전 린터 한 키 · Polar benefit) · 상품 benefit 다음에 한 번 더 묻는다
+function validate(key) {
+  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); });
+}
+function validate1(key, ben) {
+  return new Promise(function (resolve) {
+    if (!ORG_ID) return resolve({ ok: false, offline: false });
+    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 });
+    const req = https.request({ hostname: 'api.polar.sh', path: '/v1/customer-portal/license-keys/validate', method: 'POST', timeout: 8000,
+      headers: { 'content-type': 'application/json', 'polar-version': '2026-04', 'content-length': Buffer.byteLength(body) } }, function (res) {
+      let buf = ''; res.on('data', function (d) { buf += d; });
+      res.on('end', function () {
+        if (res.statusCode !== 200) return resolve({ ok: false, offline: false });
+        try { const j = JSON.parse(buf); resolve({ ok: j && (j.status === 'granted' || j.valid === true || !!j.id), offline: false }); }
+        catch (e) { resolve({ ok: false, offline: false }); }
+      });
+    });
+    req.on('timeout', function () { req.destroy(); resolve({ ok: false, offline: true }); });
+    req.on('error', function () { resolve({ ok: false, offline: true }); });
+    req.write(body); req.end();
+  });
+}
+// ★s151 2026-09-19 — 키 판(키가 없거나 거절된 순간)을 익명으로 센다 (슬러그·출처·이유만) · DO_NOT_TRACK=1 · READYSTACK_NO_TELEMETRY 면 안 보낸다 · 실패는 조용히 · 프로세스당 한 번.
+let _pinged = false;
+function pingPaywall(why) {
+  try {
+    if (_pinged) return; _pinged = true;
+    if (process.env.DO_NOT_TRACK === '1' || process.env.READYSTACK_NO_TELEMETRY || process.env.CI) return;   // s151: CI(깃허브 액션 등)와 우리 빌드는 손님이 아니다
+    if (!(process.stdout.isTTY || process.stdin.isTTY || process.env.READYSTACK_MCP === '1')) return;   // s152: 사람 자리(터미널·MCP 세션)에서만 센다 - 발행 1분 뒤 남의 실행기(JP · 우리 3대는 US)가 돌린 no_key 13건은 손님이 아니다
+    const body = JSON.stringify({ t: 'paywall', slug: SLUG, src: process.env.READYSTACK_MCP === '1' ? 'mcp' : 'cli', why: why || 'no_key' });
+    const req = https.request({ hostname: 'getreadystack.com', path: '/api/ev', method: 'POST', timeout: 3000,
+      headers: { 'content-type': 'application/json', 'content-length': Buffer.byteLength(body), 'user-agent': 'readystack-cli/' + SLUG } }, function (res) { res.resume(); });
+    req.on('timeout', function () { req.destroy(); }); req.on('error', function () {});
+    req.write(body); req.end();
+  } catch (e) { /* 세는 것이 실패해도 상품은 돈다 */ }
+}
+async function ensure(explicitKey) {
+  const st = load();
+  const key = explicitKey || process.env.READYSTACK_LICENSE || st.key;
+  if (!key) { pingPaywall('no_key'); return { ok: false, why: 'no_key' }; }   // s151
+  const age = Date.now() - (st.okAt || 0);
+  if (!explicitKey && st.key === key && age < RECHECK_MS) return { ok: true, cached: true };
+  const r = await validate(String(key).trim());
+  if (r.ok) { save({ key: String(key).trim(), okAt: Date.now() }); return { ok: true }; }
+  if (r.offline && st.key === key && age < GRACE_MS) return { ok: true, offline: true };
+  if (!r.offline) pingPaywall('invalid');   // s151
+  return { ok: false, why: r.offline ? 'offline' : 'invalid' };
+}
+// ★s134 — 구독 규칙 피드(층3 "바뀌면 업데이트"): 키 있는 손님만 · 7일마다 · 오프라인은 캐시. 워커 GET /api/rules/<slug>?key=
+const FEED_URL = 'https://getreadystack.com/api/rules/';
+function pullFeed() {
+  const st = load(); const key = process.env.READYSTACK_LICENSE || st.key; const cached = st.feed || null;
+  if (!key) return Promise.resolve(cached);
+  if (cached && (Date.now() - (st.feedAt || 0)) < RECHECK_MS) return Promise.resolve(cached);
+  return new Promise(function (resolve) {
+    let req;
+    try {
+      req = https.get(FEED_URL + encodeURIComponent(SLUG) + '?key=' + encodeURIComponent(key), { timeout: 8000, headers: { 'user-agent': 'readystack-cli' } }, function (res) {
+        let buf = ''; res.on('data', function (d) { buf += d; });
+        res.on('end', function () {
+          if (res.statusCode !== 200) return resolve(cached);
+          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); }
+          catch (e) { resolve(cached); }
+        });
+      });
+    } catch (e) { return resolve(cached); }
+    req.on('timeout', function () { req.destroy(); resolve(cached); });
+    req.on('error', function () { resolve(cached); });
+  });
+}
+module.exports = { ensure, BUY_URL, storePath, pullFeed };

readystack_agentforce_action_audit/js/package.json

@@ -0,0 +1,40 @@
+{
+  "name": "@readystack/agentforce-action-audit",
+  "version": "1.0.1",
+  "description": "13 rules on a Salesforce Agentforce topic file, before the deploy and before Article 50",
+  "license": "SEE LICENSE IN LICENSE.txt",
+  "publishConfig": {
+    "access": "public"
+  },
+  "keywords": [
+    "agentforce",
+    "salesforce",
+    "genaiplugin",
+    "ai-act-article-50",
+    "metadata-lint",
+    "sfdx"
+  ],
+  "homepage": "https://getreadystack.com",
+  "funding": "https://buy.polar.sh/polar_cl_cItF01AndFQi4JGgKXw93gpuOPFIXq4LLR70d42siAL",
+  "bin": {
+    "agentforce-action-audit": "cli.js"
+  },
+  "engines": {
+    "node": ">=18"
+  },
+  "mcpName": "io.github.jmshinhwa/agentforce-action-audit",
+  "repository": {
+    "type": "git",
+    "url": "https://github.com/jmshinhwa/readystack-themes.git",
+    "directory": "agentforce-action-audit"
+  },
+  "files": [
+    "cli.js",
+    "license.js",
+    "rules.json",
+    "strings.json",
+    "README.md",
+    "LICENSE.txt",
+    "engine.js"
+  ]
+}

readystack_agentforce_action_audit/js/rules.json

@@ -0,0 +1,67 @@
+[
+ {
+  "id": "missing_master_label",
+  "sev": "error",
+  "msg": "No top-level <masterLabel>. The topic deploys without a name and the planner cannot list it."
+ },
+ {
+  "id": "missing_description",
+  "sev": "error",
+  "msg": "No top-level <description>. The planner routes on this text, so the topic is never selected."
+ },
+ {
+  "id": "missing_scope",
+  "sev": "error",
+  "msg": "No <scope>. Nothing bounds the topic, so the agent answers questions it was never meant to touch. Add a one-line topic boundary."
+ },
+ {
+  "id": "scope_too_short",
+  "sev": "warn",
+  "msg": "<scope> is under 40 characters. Too thin to bound the topic; say what the agent must refuse."
+ },
+ {
+  "id": "no_instructions",
+  "sev": "error",
+  "msg": "No <genAiPluginInstructions> block. The topic carries no behaviour at all."
+ },
+ {
+  "id": "duplicate_instruction_name",
+  "sev": "error",
+  "msg": "Two instructions share one <developerName>. Rename the duplicate or the metadata deploy fails."
+ },
+ {
+  "id": "instruction_placeholder",
+  "sev": "error",
+  "msg": "Generated placeholder text left in an instruction. Replace it before the agent reads it to a customer."
+ },
+ {
+  "id": "function_not_referenced",
+  "sev": "warn",
+  "msg": "A <functionName> is never named in any instruction or in <scope>. Name it so the planner picks it."
+ },
+ {
+  "id": "no_ai_disclosure",
+  "sev": "error",
+  "msg": "No instruction tells the person they are talking to an AI. EU AI Act Article 50(1) has applied since 2026-08-02; the Article 99(4) ceiling is 15 million euro or 3 percent of worldwide turnover."
+ },
+ {
+  "id": "pii_in_instruction",
+  "sev": "error",
+  "msg": "An instruction carries contact or identity data. Instruction text is sent to the model on every turn; move it out of the prompt."
+ },
+ {
+  "id": "insecure_endpoint",
+  "sev": "warn",
+  "msg": "An instruction points at a plain http:// address. Use a Named Credential over https."
+ },
+ {
+  "id": "unescaped_ampersand",
+  "sev": "error",
+  "msg": "A bare & that is not an XML entity. Escape it as &amp; or the deploy stops on a parse error."
+ },
+ {
+  "id": "stale_api_version",
+  "sev": "warn",
+  "msg": "<apiVersion> predates 62.0, the release Agentforce topics shipped in. Raise it to 62.0 or later."
+ }
+]

readystack_agentforce_action_audit/js/strings.json

@@ -0,0 +1,10 @@
+{
+ "name": "Agentforce Action Audit",
+ "subtitle": "13 rules on a Salesforce Agentforce topic file, before the deploy and before Article 50",
+ "bin": "agentforce-action-audit",
+ "price": 29,
+ "free": "Audit the Agentforce topic metadata file you have open and get every deploy blocker with its line number.",
+ "paid": "Sweep every genAiPlugin and genAiPlannerBundle in the workspace in one run and export a dated AGENTFORCE-AUDIT.md for the change request.",
+ "need_key": "This option needs a licence (Agentforce Action Audit).",
+ "exts": []
+}

readystack_agentforce_action_audit-1.0.1.dist-info/METADATA

@@ -0,0 +1,84 @@
+Metadata-Version: 2.4
+Name: readystack-agentforce-action-audit
+Version: 1.0.1
+Summary: 13 rules on a Salesforce Agentforce topic file, before the deploy and before Article 50 (bundled Node.js runtime)
+Author-email: ReadyStack <support@getreadystack.com>
+License: Proprietary - see LICENSE.txt
+Project-URL: Homepage, https://getreadystack.com/tools/agentforce-action-audit?ref=pypi
+Project-URL: Documentation, https://getreadystack.com/tools/agentforce-action-audit?ref=pypi
+Project-URL: Support, https://getreadystack.com/support
+Keywords: agentforce,salesforce,genaiplugin,ai-act-article-50,metadata-lint,sfdx
+Classifier: Programming Language :: Python :: 3
+Classifier: Environment :: Console
+Classifier: Topic :: Software Development :: Quality Assurance
+Classifier: Operating System :: OS Independent
+Requires-Python: >=3.9
+Description-Content-Type: text/markdown
+License-File: LICENSE.txt
+Requires-Dist: nodejs-wheel-binaries>=20
+Dynamic: license-file
+
+# Agentforce Action Audit
+
+> Runs the same checker as the npm package `@readystack/agentforce-action-audit` on a Node.js runtime that pip installs for you (`nodejs-wheel-binaries`) - no system Node.js needed. Your files are checked locally.
+
+![Agentforce Action Audit](https://getreadystack.com/img/promo/sku141697_result_card.jpg)
+
+13 rules on a Salesforce Agentforce topic file, before the deploy and before Article 50
+
+## Install
+
+```
+agentforce-action-audit file
+```
+
+Node 18+. The same 13 rules as the VS Code extension, from a terminal or CI.
+
+## Free
+
+- Audit the Agentforce topic metadata file you have open and get every deploy blocker with its line number.
+- `--rules` lists every rule
+
+## With a licence ($29 once)
+
+- Sweep every genAiPlugin and genAiPlannerBundle in the workspace in one run and export a dated AGENTFORCE-AUDIT.md for the change request.
+
+```
+@readystack/agentforce-action-audit --dir ./templates --report html --out report.html
+```
+
+A Salesforce partner bills metadata review at about $150 an hour; one topic file takes roughly 20 minutes to read by hand.
+
+## Use from an AI agent (MCP)
+
+Claude Code · Cursor · Windsurf · any MCP client - add to your MCP config:
+
+```json
+{ "mcpServers": { "agentforce-action-audit": { "command": "npx", "args": ["-y", "@readystack/agentforce-action-audit", "--mcp"] } } }
+```
+
+Tools: `check_text` and `check_file` (free) · `check_dir` (licence). The agent gets every finding with the line number.
+
+## Use in CI
+
+```yaml
+- name: Agentforce Action Audit
+  run: npx -y @readystack/agentforce-action-audit --dir . --ci
+```
+
+(container: `docker run --rm -v "$PWD:/work" getreadystack/agentforce-action-audit --dir /work --ci`)
+
+The folder sweep, reports and CI mode need one licence — one payment, no subscription. Set `READYSTACK_LICENSE=<key>` or run `--license <key>` once.
+
+[Get a licence](https://buy.polar.sh/polar_cl_cItF01AndFQi4JGgKXw93gpuOPFIXq4LLR70d42siAL)
+
+
+<!-- agentforce action audit -->
+
+
+## Install (PyPI)
+
+```
+pip install readystack-agentforce-action-audit
+agentforce-action-audit --help
+```

readystack_agentforce_action_audit-1.0.1.dist-info/RECORD

@@ -0,0 +1,14 @@
+readystack_agentforce_action_audit/__init__.py,sha256=3KXfAcA5rzzQXMtfwpHphgbJNZdA0XWaW96kdWVSZJw,22
+readystack_agentforce_action_audit/__main__.py,sha256=3DzZxi-7VBAiEeEUw4wbFJcFLoWDkdhCPmwyaTT-DkY,359
+readystack_agentforce_action_audit/js/cli.js,sha256=ib60vyNQbZ7meRCc-ACffzcJ04JFn1nbF-HjqGMWM_U,14665
+readystack_agentforce_action_audit/js/engine.js,sha256=TTeJQ8JNwnx_4pLXISVTqHB0ZwCDO9yNSfJqOvbZMGk,5097
+readystack_agentforce_action_audit/js/license.js,sha256=MDdyLgD9EMMmzfGHaeGLIMph-e8mSi8BBR28xb3BW1A,6259
+readystack_agentforce_action_audit/js/package.json,sha256=Zb3VLfnI0-1Lc1_3kJWCg-dX_Hh_dEYXwEP0NFwabMU,985
+readystack_agentforce_action_audit/js/rules.json,sha256=6Mf2DwDEr7QD9L5ogC4EFUU1mFMSPq2CAzwGDA4DYSs,2242
+readystack_agentforce_action_audit/js/strings.json,sha256=rwNhAoBgvtJpIRixIAEI4QVroAHdmVCbQC2_GdN7Nh8,544
+readystack_agentforce_action_audit-1.0.1.dist-info/licenses/LICENSE.txt,sha256=cHP_tJkBZX1D7UmNjnGqE9JKnI8FWM2k3Com-P9CwXQ,927
+readystack_agentforce_action_audit-1.0.1.dist-info/METADATA,sha256=yEL_KPN3CDzKRWHRMZfjfJJwAlbXffdtOazHwTN6gfI,3033
+readystack_agentforce_action_audit-1.0.1.dist-info/WHEEL,sha256=YVMoNqKzERt-wjUZwJ33xBGAwnFl-4cqbYkTtWa4itE,91
+readystack_agentforce_action_audit-1.0.1.dist-info/entry_points.txt,sha256=eVOev5wVYnZRHEIE8CEiRH2SDiuCxCD0_EvmmJjm8sU,93
+readystack_agentforce_action_audit-1.0.1.dist-info/top_level.txt,sha256=agOVqQhGyQW0k_awA_tTH9zKvluYQQILEdQB9JS1e7w,35
+readystack_agentforce_action_audit-1.0.1.dist-info/RECORD,,

readystack_agentforce_action_audit-1.0.1.dist-info/WHEEL

@@ -0,0 +1,5 @@
+Wheel-Version: 1.0
+Generator: setuptools (84.0.0)
+Root-Is-Purelib: true
+Tag: py3-none-any
+

readystack_agentforce_action_audit-1.0.1.dist-info/entry_points.txt

@@ -0,0 +1,2 @@
+[console_scripts]
+agentforce-action-audit = readystack_agentforce_action_audit.__main__:main

readystack_agentforce_action_audit-1.0.1.dist-info/licenses/LICENSE.txt

@@ -0,0 +1,16 @@
+Agentforce Action Audit — Licence
+
+Free scope
+  Audit the Agentforce topic metadata file you have open and get every deploy blocker with its line number. is free for any use, personal or commercial, for as long as you keep the
+  extension installed, and the online check at the product page is free without registration.
+
+Paid scope
+  Sweep every genAiPlugin and genAiPlannerBundle in the workspace in one run and export a dated AGENTFORCE-AUDIT.md is the paid part. It asks for a licence key issued at purchase (one seat, one key;
+  7-day full refund, no questions). The key is checked against the payment provider and
+  cached locally for 30 days so it keeps working offline.
+
+Redistribution
+  You may not resell, re-host or bundle this extension or its rule set. The rule set and the
+  engine are provided as-is; check results are advisory and do not constitute legal advice.
+
+(c) ReadyStack — https://getreadystack.com

readystack_agentforce_action_audit-1.0.1.dist-info/top_level.txt

@@ -0,0 +1 @@
+readystack_agentforce_action_audit