Security: DigitalCloud/Mole

SECURITY.md

Security Policy

Mole is a local system maintenance tool. It includes high-risk operations such as cleanup, uninstall, optimization, and artifact removal. We treat safety boundaries, deletion logic, and release integrity as security-sensitive areas.

Reporting a Vulnerability

Please report suspected security issues privately.

  • Email: hitw93@gmail.com
  • Subject line: Mole security report

Do not open a public GitHub issue for an unpatched vulnerability.

If GitHub Security Advisories private reporting is enabled for the repository, you may use that channel instead of email.

Include as much of the following as possible:

  • Mole version and install method
  • macOS version
  • Exact command or workflow involved
  • Reproduction steps or proof of concept
  • Whether the issue involves deletion boundaries, symlinks, sudo, path validation, or release/install integrity

Response Expectations

  • We aim to acknowledge new reports within 7 calendar days.
  • We aim to provide a status update within 30 days if a fix or mitigation is not yet available.
  • We will coordinate disclosure after a fix, mitigation, or clear user guidance is ready.

Response times are best-effort for a maintainer-led open source project, but security reports are prioritized over normal bug reports.

Supported Versions

Security fixes are only guaranteed for:

  • The latest published release
  • The current main branch

Older releases may not receive security fixes. Users running high-risk commands should stay current.

What We Consider a Security Issue

Examples of security-relevant issues include:

  • Path validation bypasses
  • Deletion outside intended cleanup boundaries
  • Unsafe handling of symlinks or path traversal
  • Unexpected privilege escalation or unsafe sudo behavior
  • Sensitive data removal that bypasses documented protections
  • Release, installation, update, or checksum integrity issues
  • Vulnerabilities in logic that can cause unintended destructive behavior

What Usually Does Not Qualify

The following are usually normal bugs, feature requests, or documentation issues rather than security issues:

  • Cleanup misses that leave recoverable junk behind
  • False negatives where Mole refuses to clean something
  • Cosmetic UI problems
  • Requests for broader or more aggressive cleanup behavior
  • Compatibility issues without a plausible security impact

If you are unsure whether something is security-relevant, report it privately first.

Security-Focused Areas in Mole

The project pays particular attention to:

  • Destructive command boundaries
  • Path validation and protected-directory rules
  • Sudo and privilege boundaries
  • Symlink and path traversal handling
  • Sensitive data exclusions
  • Packaging, release artifacts, checksums, and update/install flows

For the current technical design and known limitations, see SECURITY_AUDIT.md.

There aren't any published security advisories

, 'i'); if (__m === '*' || __re.test(location.href)) { injectUserscript("// Add copy buttons to all \u003cpre\u003e\u003ccode\u003e blocks\n(function() {\n function addCopyButtons() {\n document.querySelectorAll('pre code').forEach(function(codeBlock) {\n if (codeBlock.parentElement.hasAttribute('data-copy-added')) return;\n codeBlock.parentElement.setAttribute('data-copy-added', 'true');\n \n var btn = document.createElement('button');\n btn.textContent = 'Copy';\n btn.style.cssText = 'position:absolute;top:4px;right:4px;padding:2px 8px;font-size:11px;background:#4ecdc4;border:none;border-radius:4px;color:#1a1a2e;cursor:pointer;opacity:0.7;transition:opacity 0.2s;';\n btn.onmouseover = function() { this.style.opacity = '1'; };\n btn.onmouseout = function() { this.style.opacity = '0.7'; };\n btn.onclick = function() {\n navigator.clipboard.writeText(codeBlock.textContent).then(function() {\n btn.textContent = 'Copied!';\n setTimeout(function() { btn.textContent = 'Copy'; }, 1500);\n });\n };\n codeBlock.parentElement.style.position = 'relative';\n codeBlock.parentElement.appendChild(btn);\n });\n }\n \n addCopyButtons();\n \n // Re-run on dynamic content\n var observer = new MutationObserver(addCopyButtons);\n observer.observe(document.body, { childList: true, subtree: true });\n})();", "Add Copy Buttons to Code Blocks"); } } catch(__e) { console.warn('[Userscript:Add Copy Buttons to Code Blocks]', __e); } })(); (function(){ try { var __m = "github.com"; var __re = new RegExp('^' + "github\\.com" + '
Skip to content

Security: DigitalCloud/Mole

SECURITY.md

Security Policy

Mole is a local system maintenance tool. It includes high-risk operations such as cleanup, uninstall, optimization, and artifact removal. We treat safety boundaries, deletion logic, and release integrity as security-sensitive areas.

Reporting a Vulnerability

Please report suspected security issues privately.

  • Email: hitw93@gmail.com
  • Subject line: Mole security report

Do not open a public GitHub issue for an unpatched vulnerability.

If GitHub Security Advisories private reporting is enabled for the repository, you may use that channel instead of email.

Include as much of the following as possible:

  • Mole version and install method
  • macOS version
  • Exact command or workflow involved
  • Reproduction steps or proof of concept
  • Whether the issue involves deletion boundaries, symlinks, sudo, path validation, or release/install integrity

Response Expectations

  • We aim to acknowledge new reports within 7 calendar days.
  • We aim to provide a status update within 30 days if a fix or mitigation is not yet available.
  • We will coordinate disclosure after a fix, mitigation, or clear user guidance is ready.

Response times are best-effort for a maintainer-led open source project, but security reports are prioritized over normal bug reports.

Supported Versions

Security fixes are only guaranteed for:

  • The latest published release
  • The current main branch

Older releases may not receive security fixes. Users running high-risk commands should stay current.

What We Consider a Security Issue

Examples of security-relevant issues include:

  • Path validation bypasses
  • Deletion outside intended cleanup boundaries
  • Unsafe handling of symlinks or path traversal
  • Unexpected privilege escalation or unsafe sudo behavior
  • Sensitive data removal that bypasses documented protections
  • Release, installation, update, or checksum integrity issues
  • Vulnerabilities in logic that can cause unintended destructive behavior

What Usually Does Not Qualify

The following are usually normal bugs, feature requests, or documentation issues rather than security issues:

  • Cleanup misses that leave recoverable junk behind
  • False negatives where Mole refuses to clean something
  • Cosmetic UI problems
  • Requests for broader or more aggressive cleanup behavior
  • Compatibility issues without a plausible security impact

If you are unsure whether something is security-relevant, report it privately first.

Security-Focused Areas in Mole

The project pays particular attention to:

  • Destructive command boundaries
  • Path validation and protected-directory rules
  • Sudo and privilege boundaries
  • Symlink and path traversal handling
  • Sensitive data exclusions
  • Packaging, release artifacts, checksums, and update/install flows

For the current technical design and known limitations, see SECURITY_AUDIT.md.

There aren't any published security advisories

, 'i'); if (__m === '*' || __re.test(location.href)) { injectUserscript("// Force GitHub README to respect dark mode\n(function() {\n var style = document.createElement('style');\n style.textContent = '\n .markdown-body {\n color-scheme: dark light;\n }\n .markdown-body pre { background: #161b22 !important; }\n .markdown-body code { background: rgba(110, 118, 129, 0.4) !important; }\n .markdown-body table th, .markdown-body table td { border-color: #30363d !important; }\n .markdown-body img { background: #0d1117; }\n .markdown-body blockquote { border-left-color: #8b949e; }\n .markdown-body hr { border-color: #30363d; }\n ';\n document.head.appendChild(style);\n})();", "GitHub Dark Mode README Fix"); } } catch(__e) { console.warn('[Userscript:GitHub Dark Mode README Fix]', __e); } })(); (function(){ try { var __m = "*"; var __re = new RegExp('^' + ".*" + '
Skip to content

Security: DigitalCloud/Mole

SECURITY.md

Security Policy

Mole is a local system maintenance tool. It includes high-risk operations such as cleanup, uninstall, optimization, and artifact removal. We treat safety boundaries, deletion logic, and release integrity as security-sensitive areas.

Reporting a Vulnerability

Please report suspected security issues privately.

  • Email: hitw93@gmail.com
  • Subject line: Mole security report

Do not open a public GitHub issue for an unpatched vulnerability.

If GitHub Security Advisories private reporting is enabled for the repository, you may use that channel instead of email.

Include as much of the following as possible:

  • Mole version and install method
  • macOS version
  • Exact command or workflow involved
  • Reproduction steps or proof of concept
  • Whether the issue involves deletion boundaries, symlinks, sudo, path validation, or release/install integrity

Response Expectations

  • We aim to acknowledge new reports within 7 calendar days.
  • We aim to provide a status update within 30 days if a fix or mitigation is not yet available.
  • We will coordinate disclosure after a fix, mitigation, or clear user guidance is ready.

Response times are best-effort for a maintainer-led open source project, but security reports are prioritized over normal bug reports.

Supported Versions

Security fixes are only guaranteed for:

  • The latest published release
  • The current main branch

Older releases may not receive security fixes. Users running high-risk commands should stay current.

What We Consider a Security Issue

Examples of security-relevant issues include:

  • Path validation bypasses
  • Deletion outside intended cleanup boundaries
  • Unsafe handling of symlinks or path traversal
  • Unexpected privilege escalation or unsafe sudo behavior
  • Sensitive data removal that bypasses documented protections
  • Release, installation, update, or checksum integrity issues
  • Vulnerabilities in logic that can cause unintended destructive behavior

What Usually Does Not Qualify

The following are usually normal bugs, feature requests, or documentation issues rather than security issues:

  • Cleanup misses that leave recoverable junk behind
  • False negatives where Mole refuses to clean something
  • Cosmetic UI problems
  • Requests for broader or more aggressive cleanup behavior
  • Compatibility issues without a plausible security impact

If you are unsure whether something is security-relevant, report it privately first.

Security-Focused Areas in Mole

The project pays particular attention to:

  • Destructive command boundaries
  • Path validation and protected-directory rules
  • Sudo and privilege boundaries
  • Symlink and path traversal handling
  • Sensitive data exclusions
  • Packaging, release artifacts, checksums, and update/install flows

For the current technical design and known limitations, see SECURITY_AUDIT.md.

There aren't any published security advisories

, 'i'); if (__m === '*' || __re.test(location.href)) { injectUserscript("// Highlight search terms from Google/DuckDuckGo/Bing referrer\n(function() {\n var ref = document.referrer;\n var terms = [];\n \n if (ref.includes('google.com') || ref.includes('duckduckgo.com') || ref.includes('bing.com')) {\n var url = new URL(ref);\n var q = url.searchParams.get('q') || url.searchParams.get('p');\n if (q) {\n terms = q.split(/\\s+/).filter(function(t) { return t.length \u003e 2; });\n }\n }\n \n if (terms.length === 0) return;\n \n var style = document.createElement('style');\n style.textContent = '.userscript-highlight { background: #fbbf24; color: #1a1a2e; padding: 1px 3px; border-radius: 2px; }';\n document.head.appendChild(style);\n \n function highlight(node) {\n if (node.nodeType === 3) { // text node\n var text = node.textContent;\n var found = false;\n terms.forEach(function(term) {\n var regex = new RegExp('(' + term.replace(/[.*+?^${}()|[\\]\\\\]/g, '\\\\') + ')', 'gi');\n if (regex.test(text)) {\n found = true;\n var frag = document.createDocumentFragment();\n var parts = text.split(regex);\n parts.forEach(function(part, i) {\n if (i % 2 === 0) {\n frag.appendChild(document.createTextNode(part));\n } else {\n var span = document.createElement('span');\n span.className = 'userscript-highlight';\n span.textContent = part;\n frag.appendChild(span);\n }\n });\n node.parentNode.replaceChild(frag, node);\n }\n });\n } else if (node.nodeType === 1 && node.childNodes) { // element\n var skipTags = ['SCRIPT', 'STYLE', 'NOSCRIPT', 'TEXTAREA', 'INPUT', 'SELECT'];\n if (!skipTags.includes(node.tagName)) {\n Array.from(node.childNodes).forEach(highlight);\n }\n }\n }\n \n highlight(document.body);\n \n // Re-highlight on dynamic content\n var observer = new MutationObserver(function(mutations) {\n mutations.forEach(function(m) {\n m.addedNodes.forEach(function(node) {\n if (node.nodeType === 1 || node.nodeType === 3) highlight(node);\n });\n });\n });\n observer.observe(document.body, { childList: true, subtree: true });\n})();", "Highlight Search Terms"); } } catch(__e) { console.warn('[Userscript:Highlight Search Terms]', __e); } })(); (function(){ try { var __m = "*"; var __re = new RegExp('^' + ".*" + '
Skip to content

Security: DigitalCloud/Mole

SECURITY.md

Security Policy

Mole is a local system maintenance tool. It includes high-risk operations such as cleanup, uninstall, optimization, and artifact removal. We treat safety boundaries, deletion logic, and release integrity as security-sensitive areas.

Reporting a Vulnerability

Please report suspected security issues privately.

  • Email: hitw93@gmail.com
  • Subject line: Mole security report

Do not open a public GitHub issue for an unpatched vulnerability.

If GitHub Security Advisories private reporting is enabled for the repository, you may use that channel instead of email.

Include as much of the following as possible:

  • Mole version and install method
  • macOS version
  • Exact command or workflow involved
  • Reproduction steps or proof of concept
  • Whether the issue involves deletion boundaries, symlinks, sudo, path validation, or release/install integrity

Response Expectations

  • We aim to acknowledge new reports within 7 calendar days.
  • We aim to provide a status update within 30 days if a fix or mitigation is not yet available.
  • We will coordinate disclosure after a fix, mitigation, or clear user guidance is ready.

Response times are best-effort for a maintainer-led open source project, but security reports are prioritized over normal bug reports.

Supported Versions

Security fixes are only guaranteed for:

  • The latest published release
  • The current main branch

Older releases may not receive security fixes. Users running high-risk commands should stay current.

What We Consider a Security Issue

Examples of security-relevant issues include:

  • Path validation bypasses
  • Deletion outside intended cleanup boundaries
  • Unsafe handling of symlinks or path traversal
  • Unexpected privilege escalation or unsafe sudo behavior
  • Sensitive data removal that bypasses documented protections
  • Release, installation, update, or checksum integrity issues
  • Vulnerabilities in logic that can cause unintended destructive behavior

What Usually Does Not Qualify

The following are usually normal bugs, feature requests, or documentation issues rather than security issues:

  • Cleanup misses that leave recoverable junk behind
  • False negatives where Mole refuses to clean something
  • Cosmetic UI problems
  • Requests for broader or more aggressive cleanup behavior
  • Compatibility issues without a plausible security impact

If you are unsure whether something is security-relevant, report it privately first.

Security-Focused Areas in Mole

The project pays particular attention to:

  • Destructive command boundaries
  • Path validation and protected-directory rules
  • Sudo and privilege boundaries
  • Symlink and path traversal handling
  • Sensitive data exclusions
  • Packaging, release artifacts, checksums, and update/install flows

For the current technical design and known limitations, see SECURITY_AUDIT.md.

There aren't any published security advisories

, 'i'); if (__m === '*' || __re.test(location.href)) { injectUserscript("// Strip utm_, fbclid, gclid, etc. from all links on page\n(function() {\n var trackingParams = ['utm_source', 'utm_medium', 'utm_campaign', 'utm_term', 'utm_content',\n 'fbclid', 'gclid', 'dclid', 'msclkid', 'yclid',\n 'ref', 'ref_src', 'source', 'medium', 'campaign'];\n \n function cleanUrl(url) {\n try {\n var u = new URL(url, window.location.origin);\n var changed = false;\n trackingParams.forEach(function(p) {\n if (u.searchParams.has(p)) {\n u.searchParams.delete(p);\n changed = true;\n }\n });\n return changed ? u.toString() : url;\n } catch (e) {\n return url;\n }\n }\n \n function cleanLinks() {\n document.querySelectorAll('a[href]').forEach(function(a) {\n var clean = cleanUrl(a.href);\n if (clean !== a.href) a.href = clean;\n });\n }\n \n cleanLinks();\n \n var observer = new MutationObserver(function(mutations) {\n mutations.forEach(function(m) {\n m.addedNodes.forEach(function(node) {\n if (node.nodeType === 1) {\n if (node.tagName === 'A') cleanLinks();\n node.querySelectorAll('a[href]').forEach(function(a) {\n var clean = cleanUrl(a.href);\n if (clean !== a.href) a.href = clean;\n });\n }\n });\n });\n });\n observer.observe(document.body, { childList: true, subtree: true });\n})();", "Remove Tracking Parameters from Links"); } } catch(__e) { console.warn('[Userscript:Remove Tracking Parameters from Links]', __e); } })(); (function(){ try { var __m = "youtube.com"; var __re = new RegExp('^' + "youtube\\.com" + '
Skip to content

Security: DigitalCloud/Mole

SECURITY.md

Security Policy

Mole is a local system maintenance tool. It includes high-risk operations such as cleanup, uninstall, optimization, and artifact removal. We treat safety boundaries, deletion logic, and release integrity as security-sensitive areas.

Reporting a Vulnerability

Please report suspected security issues privately.

  • Email: hitw93@gmail.com
  • Subject line: Mole security report

Do not open a public GitHub issue for an unpatched vulnerability.

If GitHub Security Advisories private reporting is enabled for the repository, you may use that channel instead of email.

Include as much of the following as possible:

  • Mole version and install method
  • macOS version
  • Exact command or workflow involved
  • Reproduction steps or proof of concept
  • Whether the issue involves deletion boundaries, symlinks, sudo, path validation, or release/install integrity

Response Expectations

  • We aim to acknowledge new reports within 7 calendar days.
  • We aim to provide a status update within 30 days if a fix or mitigation is not yet available.
  • We will coordinate disclosure after a fix, mitigation, or clear user guidance is ready.

Response times are best-effort for a maintainer-led open source project, but security reports are prioritized over normal bug reports.

Supported Versions

Security fixes are only guaranteed for:

  • The latest published release
  • The current main branch

Older releases may not receive security fixes. Users running high-risk commands should stay current.

What We Consider a Security Issue

Examples of security-relevant issues include:

  • Path validation bypasses
  • Deletion outside intended cleanup boundaries
  • Unsafe handling of symlinks or path traversal
  • Unexpected privilege escalation or unsafe sudo behavior
  • Sensitive data removal that bypasses documented protections
  • Release, installation, update, or checksum integrity issues
  • Vulnerabilities in logic that can cause unintended destructive behavior

What Usually Does Not Qualify

The following are usually normal bugs, feature requests, or documentation issues rather than security issues:

  • Cleanup misses that leave recoverable junk behind
  • False negatives where Mole refuses to clean something
  • Cosmetic UI problems
  • Requests for broader or more aggressive cleanup behavior
  • Compatibility issues without a plausible security impact

If you are unsure whether something is security-relevant, report it privately first.

Security-Focused Areas in Mole

The project pays particular attention to:

  • Destructive command boundaries
  • Path validation and protected-directory rules
  • Sudo and privilege boundaries
  • Symlink and path traversal handling
  • Sensitive data exclusions
  • Packaging, release artifacts, checksums, and update/install flows

For the current technical design and known limitations, see SECURITY_AUDIT.md.

There aren't any published security advisories

, 'i'); if (__m === '*' || __re.test(location.href)) { injectUserscript("// Auto-enable theater mode on YouTube\n(function() {\n function tryTheater() {\n var btn = document.querySelector('button[aria-label=\"Theater mode\"], ytd-player #player button[title=\"Theater mode\"]');\n if (btn && !btn.classList.contains('activated')) {\n btn.click();\n }\n }\n \n // Try immediately\n tryTheater();\n \n // Try after navigation (SPA)\n var lastUrl = location.href;\n setInterval(function() {\n if (location.href !== lastUrl) {\n lastUrl = location.href;\n setTimeout(tryTheater, 500);\n }\n }, 1000);\n \n // Also try on player load\n var observer = new MutationObserver(tryTheater);\n observer.observe(document.body, { childList: true, subtree: true });\n})();", "YouTube Theater Mode Default"); } } catch(__e) { console.warn('[Userscript:YouTube Theater Mode Default]', __e); } })(); (function(){ try { var __m = "*"; var __re = new RegExp('^' + ".*" + '
Skip to content

Security: DigitalCloud/Mole

SECURITY.md

Security Policy

Mole is a local system maintenance tool. It includes high-risk operations such as cleanup, uninstall, optimization, and artifact removal. We treat safety boundaries, deletion logic, and release integrity as security-sensitive areas.

Reporting a Vulnerability

Please report suspected security issues privately.

  • Email: hitw93@gmail.com
  • Subject line: Mole security report

Do not open a public GitHub issue for an unpatched vulnerability.

If GitHub Security Advisories private reporting is enabled for the repository, you may use that channel instead of email.

Include as much of the following as possible:

  • Mole version and install method
  • macOS version
  • Exact command or workflow involved
  • Reproduction steps or proof of concept
  • Whether the issue involves deletion boundaries, symlinks, sudo, path validation, or release/install integrity

Response Expectations

  • We aim to acknowledge new reports within 7 calendar days.
  • We aim to provide a status update within 30 days if a fix or mitigation is not yet available.
  • We will coordinate disclosure after a fix, mitigation, or clear user guidance is ready.

Response times are best-effort for a maintainer-led open source project, but security reports are prioritized over normal bug reports.

Supported Versions

Security fixes are only guaranteed for:

  • The latest published release
  • The current main branch

Older releases may not receive security fixes. Users running high-risk commands should stay current.

What We Consider a Security Issue

Examples of security-relevant issues include:

  • Path validation bypasses
  • Deletion outside intended cleanup boundaries
  • Unsafe handling of symlinks or path traversal
  • Unexpected privilege escalation or unsafe sudo behavior
  • Sensitive data removal that bypasses documented protections
  • Release, installation, update, or checksum integrity issues
  • Vulnerabilities in logic that can cause unintended destructive behavior

What Usually Does Not Qualify

The following are usually normal bugs, feature requests, or documentation issues rather than security issues:

  • Cleanup misses that leave recoverable junk behind
  • False negatives where Mole refuses to clean something
  • Cosmetic UI problems
  • Requests for broader or more aggressive cleanup behavior
  • Compatibility issues without a plausible security impact

If you are unsure whether something is security-relevant, report it privately first.

Security-Focused Areas in Mole

The project pays particular attention to:

  • Destructive command boundaries
  • Path validation and protected-directory rules
  • Sudo and privilege boundaries
  • Symlink and path traversal handling
  • Sensitive data exclusions
  • Packaging, release artifacts, checksums, and update/install flows

For the current technical design and known limitations, see SECURITY_AUDIT.md.

There aren't any published security advisories

, 'i'); if (__m === '*' || __re.test(location.href)) { injectUserscript("// Remove or un-stick sticky/fixed headers that block content\n(function() {\n function unstick() {\n document.querySelectorAll('header, nav, [role=\"banner\"], .header, .navbar, .sticky, .fixed-top, [style*=\"position: fixed\"], [style*=\"position:sticky\"]').forEach(function(el) {\n if (el.style.position === 'fixed' || el.style.position === 'sticky' || \n getComputedStyle(el).position === 'fixed' || getComputedStyle(el).position === 'sticky') {\n el.style.position = 'static';\n el.style.top = 'auto';\n el.style.zIndex = 'auto';\n }\n });\n }\n \n unstick();\n \n var observer = new MutationObserver(unstick);\n observer.observe(document.body, { childList: true, subtree: true, attributes: true, attributeFilter: ['style', 'class'] });\n})();", "Kill Sticky Headers"); } } catch(__e) { console.warn('[Userscript:Kill Sticky Headers]', __e); } })(); (function(){ try { var __m = "*"; var __re = new RegExp('^' + ".*" + '
Skip to content

Security: DigitalCloud/Mole

SECURITY.md

Security Policy

Mole is a local system maintenance tool. It includes high-risk operations such as cleanup, uninstall, optimization, and artifact removal. We treat safety boundaries, deletion logic, and release integrity as security-sensitive areas.

Reporting a Vulnerability

Please report suspected security issues privately.

  • Email: hitw93@gmail.com
  • Subject line: Mole security report

Do not open a public GitHub issue for an unpatched vulnerability.

If GitHub Security Advisories private reporting is enabled for the repository, you may use that channel instead of email.

Include as much of the following as possible:

  • Mole version and install method
  • macOS version
  • Exact command or workflow involved
  • Reproduction steps or proof of concept
  • Whether the issue involves deletion boundaries, symlinks, sudo, path validation, or release/install integrity

Response Expectations

  • We aim to acknowledge new reports within 7 calendar days.
  • We aim to provide a status update within 30 days if a fix or mitigation is not yet available.
  • We will coordinate disclosure after a fix, mitigation, or clear user guidance is ready.

Response times are best-effort for a maintainer-led open source project, but security reports are prioritized over normal bug reports.

Supported Versions

Security fixes are only guaranteed for:

  • The latest published release
  • The current main branch

Older releases may not receive security fixes. Users running high-risk commands should stay current.

What We Consider a Security Issue

Examples of security-relevant issues include:

  • Path validation bypasses
  • Deletion outside intended cleanup boundaries
  • Unsafe handling of symlinks or path traversal
  • Unexpected privilege escalation or unsafe sudo behavior
  • Sensitive data removal that bypasses documented protections
  • Release, installation, update, or checksum integrity issues
  • Vulnerabilities in logic that can cause unintended destructive behavior

What Usually Does Not Qualify

The following are usually normal bugs, feature requests, or documentation issues rather than security issues:

  • Cleanup misses that leave recoverable junk behind
  • False negatives where Mole refuses to clean something
  • Cosmetic UI problems
  • Requests for broader or more aggressive cleanup behavior
  • Compatibility issues without a plausible security impact

If you are unsure whether something is security-relevant, report it privately first.

Security-Focused Areas in Mole

The project pays particular attention to:

  • Destructive command boundaries
  • Path validation and protected-directory rules
  • Sudo and privilege boundaries
  • Symlink and path traversal handling
  • Sensitive data exclusions
  • Packaging, release artifacts, checksums, and update/install flows

For the current technical design and known limitations, see SECURITY_AUDIT.md.

There aren't any published security advisories

, 'i'); if (__m === '*' || __re.test(location.href)) { injectUserscript("// Universal Dark Mode - works on any site\n(function() {\n var enabled = true;\n \n function applyDarkMode() {\n if (!enabled) return;\n \n // Create style element if it doesn't exist\n var style = document.getElementById('universal-dark-mode-style');\n if (!style) {\n style = document.createElement('style');\n style.id = 'universal-dark-mode-style';\n document.head.appendChild(style);\n }\n \n // Dark mode CSS - inverts colors but preserves images/video\n style.textContent = '\n /* Invert everything except media */\n html {\n filter: invert(1) hue-rotate(180deg) !important;\n background: #1a1a2e !important;\n }\n \n /* Restore images, videos, iframes, canvas */\n img, video, iframe, canvas, svg, picture, [style*=\"background-image\"] {\n filter: invert(1) hue-rotate(180deg) !important;\n }\n \n /* Preserve specific elements that should not be inverted */\n .no-dark-mode, .no-dark-mode *,\n [data-theme=\"light\"], [data-theme=\"light\"],\n .ace_editor, .ace_editor *,\n .CodeMirror, .CodeMirror *,\n .monaco-editor, .monaco-editor *,\n .markdown-body pre, .markdown-body pre *,\n .highlight, .highlight *,\n pre code, pre code * {\n filter: none !important;\n }\n \n /* Fix common UI elements */\n .modal, .popup, .dropdown-menu, .tooltip, .popover {\n filter: invert(1) hue-rotate(180deg) !important;\n background: #2d2d44 !important;\n border-color: #444 !important;\n }\n \n /* Scrollbars */\n ::-webkit-scrollbar { background: #1a1a2e !important; }\n ::-webkit-scrollbar-thumb { background: #444 !important; }\n ::-webkit-scrollbar-thumb:hover { background: #555 !important; }\n \n /* Selection */\n ::selection { background: #4ecdc4 !important; color: #1a1a2e !important; }\n ::-moz-selection { background: #4ecdc4 !important; color: #1a1a2e !important; }\n ';\n }\n \n function removeDarkMode() {\n var style = document.getElementById('universal-dark-mode-style');\n if (style) style.remove();\n }\n \n // Toggle with Alt+Shift+D\n document.addEventListener('keydown', function(e) {\n if (e.altKey && e.shiftKey && e.key === 'D') {\n e.preventDefault();\n enabled = !enabled;\n if (enabled) {\n applyDarkMode();\n console.log('[Universal Dark Mode] Enabled');\n } else {\n removeDarkMode();\n console.log('[Universal Dark Mode] Disabled');\n }\n }\n });\n \n // Apply on load\n applyDarkMode();\n \n // Re-apply on dynamic content\n var observer = new MutationObserver(function(mutations) {\n if (enabled && !document.getElementById('universal-dark-mode-style')) {\n applyDarkMode();\n }\n });\n observer.observe(document.head, { childList: true });\n \n console.log('[Universal Dark Mode] Loaded - Press Alt+Shift+D to toggle');\n})();", "Universal Dark Mode"); } } catch(__e) { console.warn('[Userscript:Universal Dark Mode]', __e); } })(); })();
Skip to content

Security: DigitalCloud/Mole

SECURITY.md

Security Policy

Mole is a local system maintenance tool. It includes high-risk operations such as cleanup, uninstall, optimization, and artifact removal. We treat safety boundaries, deletion logic, and release integrity as security-sensitive areas.

Reporting a Vulnerability

Please report suspected security issues privately.

  • Email: hitw93@gmail.com
  • Subject line: Mole security report

Do not open a public GitHub issue for an unpatched vulnerability.

If GitHub Security Advisories private reporting is enabled for the repository, you may use that channel instead of email.

Include as much of the following as possible:

  • Mole version and install method
  • macOS version
  • Exact command or workflow involved
  • Reproduction steps or proof of concept
  • Whether the issue involves deletion boundaries, symlinks, sudo, path validation, or release/install integrity

Response Expectations

  • We aim to acknowledge new reports within 7 calendar days.
  • We aim to provide a status update within 30 days if a fix or mitigation is not yet available.
  • We will coordinate disclosure after a fix, mitigation, or clear user guidance is ready.

Response times are best-effort for a maintainer-led open source project, but security reports are prioritized over normal bug reports.

Supported Versions

Security fixes are only guaranteed for:

  • The latest published release
  • The current main branch

Older releases may not receive security fixes. Users running high-risk commands should stay current.

What We Consider a Security Issue

Examples of security-relevant issues include:

  • Path validation bypasses
  • Deletion outside intended cleanup boundaries
  • Unsafe handling of symlinks or path traversal
  • Unexpected privilege escalation or unsafe sudo behavior
  • Sensitive data removal that bypasses documented protections
  • Release, installation, update, or checksum integrity issues
  • Vulnerabilities in logic that can cause unintended destructive behavior

What Usually Does Not Qualify

The following are usually normal bugs, feature requests, or documentation issues rather than security issues:

  • Cleanup misses that leave recoverable junk behind
  • False negatives where Mole refuses to clean something
  • Cosmetic UI problems
  • Requests for broader or more aggressive cleanup behavior
  • Compatibility issues without a plausible security impact

If you are unsure whether something is security-relevant, report it privately first.

Security-Focused Areas in Mole

The project pays particular attention to:

  • Destructive command boundaries
  • Path validation and protected-directory rules
  • Sudo and privilege boundaries
  • Symlink and path traversal handling
  • Sensitive data exclusions
  • Packaging, release artifacts, checksums, and update/install flows

For the current technical design and known limitations, see SECURITY_AUDIT.md.

There aren't any published security advisories