filemayor 3.6.0 → 4.0.7

package/LICENSE

@@ -1,90 +1,90 @@
-FILEMAYOR PROPRIETARY LICENSE
-
-Copyright (c) 2024-2026 Lehlohonolo Goodwill Nchefu (Chevza). All rights reserved.
-
-NOTICE: This software and all associated documentation files (the "Software")
-are the proprietary property of Lehlohonolo Goodwill Nchefu (Chevza),
-operating as FileMayor, and its contributors.
-
-1. GRANT OF LICENSE
-
-   Subject to the terms of this License, you are granted a limited,
-   non-exclusive, non-transferable, revocable license to:
-
-   a) USE the Software for personal, non-commercial purposes at no cost
-      ("Free Tier").
-
-   b) USE the Software for commercial purposes only upon purchasing a valid
-      commercial license from FileMayor ("Paid Tier").
-
-2. RESTRICTIONS
-
-   You may NOT:
-
-   a) Copy, modify, merge, publish, distribute, sublicense, or sell copies
-      of the Software without express written permission from FileMayor.
-
-   b) Reverse engineer, decompile, disassemble, or otherwise attempt to
-      derive the source code of compiled portions of the Software.
-
-   c) Remove or alter any proprietary notices, labels, or trademarks on
-      the Software.
-
-   d) Use the Software to create a competing product or service.
-
-   e) Use the Software's source code, in whole or in part, in any other
-      software product without a commercial license agreement.
-
-3. FREE TIER
-
-   The Free Tier grants individuals the right to:
-   - Use the desktop application for personal file organization
-   - Use the CLI tool for personal, non-commercial purposes
-   - Contribute improvements via pull requests (you retain copyright of
-     your contributions but grant FileMayor a perpetual license to use them)
-
-4. PAID TIER
-
-   Commercial use, including but not limited to:
-   - Enterprise deployment across multiple machines
-   - Integration into commercial products or workflows
-   - Use in a business or organizational setting
-   - Server / data center deployment
-   - SOP AI Engine features
-
-   requires a valid Paid Tier license. Contact licensing@filemayor.com
-   for commercial licensing inquiries.
-
-5. AI FEATURES
-
-   The Software includes AI-powered features that connect to third-party
-   APIs (Google Gemini). Use of these features is subject to:
-   - The respective third-party API terms of service
-   - Data processing as described in FileMayor's Privacy Policy
-   - Availability and rate limits of the third-party service
-
-6. DATA & PRIVACY
-
-   The Software processes files locally on your device. AI features may
-   transmit document text (not file contents) to third-party APIs for
-   analysis. No personal data is collected, stored, or sold by FileMayor.
-
-7. NO WARRANTY
-
-   THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS
-   OR IMPLIED. IN NO EVENT SHALL THE AUTHORS OR COPYRIGHT HOLDERS BE LIABLE
-   FOR ANY CLAIM, DAMAGES, OR OTHER LIABILITY ARISING FROM THE USE OF THE
-   SOFTWARE.
-
-8. TERMINATION
-
-   This License is effective until terminated. It terminates automatically
-   if you fail to comply with any term. Upon termination, you must destroy
-   all copies of the Software in your possession.
-
-9. GOVERNING LAW
-
-   This License shall be governed by the laws of the Republic of South Africa.
-
-For licensing inquiries: licensing@filemayor.com
-For support: support@filemayor.com
+FILEMAYOR PROPRIETARY LICENSE
+
+Copyright (c) 2024-2026 Lehlohonolo Goodwill Nchefu (Chevza). All rights reserved.
+
+NOTICE: This software and all associated documentation files (the "Software")
+are the proprietary property of Lehlohonolo Goodwill Nchefu (Chevza),
+operating as FileMayor, and its contributors.
+
+1. GRANT OF LICENSE
+
+   Subject to the terms of this License, you are granted a limited,
+   non-exclusive, non-transferable, revocable license to:
+
+   a) USE the Software for personal, non-commercial purposes at no cost
+      ("Free Tier").
+
+   b) USE the Software for commercial purposes only upon purchasing a valid
+      commercial license from FileMayor ("Paid Tier").
+
+2. RESTRICTIONS
+
+   You may NOT:
+
+   a) Copy, modify, merge, publish, distribute, sublicense, or sell copies
+      of the Software without express written permission from FileMayor.
+
+   b) Reverse engineer, decompile, disassemble, or otherwise attempt to
+      derive the source code of compiled portions of the Software.
+
+   c) Remove or alter any proprietary notices, labels, or trademarks on
+      the Software.
+
+   d) Use the Software to create a competing product or service.
+
+   e) Use the Software's source code, in whole or in part, in any other
+      software product without a commercial license agreement.
+
+3. FREE TIER
+
+   The Free Tier grants individuals the right to:
+   - Use the desktop application for personal file organization
+   - Use the CLI tool for personal, non-commercial purposes
+   - Contribute improvements via pull requests (you retain copyright of
+     your contributions but grant FileMayor a perpetual license to use them)
+
+4. PAID TIER
+
+   Commercial use, including but not limited to:
+   - Enterprise deployment across multiple machines
+   - Integration into commercial products or workflows
+   - Use in a business or organizational setting
+   - Server / data center deployment
+   - SOP AI Engine features
+
+   requires a valid Paid Tier license. Contact licensing@filemayor.com
+   for commercial licensing inquiries.
+
+5. AI FEATURES
+
+   The Software includes AI-powered features that connect to third-party
+   APIs (Google Gemini). Use of these features is subject to:
+   - The respective third-party API terms of service
+   - Data processing as described in FileMayor's Privacy Policy
+   - Availability and rate limits of the third-party service
+
+6. DATA & PRIVACY
+
+   The Software processes files locally on your device. AI features may
+   transmit document text (not file contents) to third-party APIs for
+   analysis. No personal data is collected, stored, or sold by FileMayor.
+
+7. NO WARRANTY
+
+   THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS
+   OR IMPLIED. IN NO EVENT SHALL THE AUTHORS OR COPYRIGHT HOLDERS BE LIABLE
+   FOR ANY CLAIM, DAMAGES, OR OTHER LIABILITY ARISING FROM THE USE OF THE
+   SOFTWARE.
+
+8. TERMINATION
+
+   This License is effective until terminated. It terminates automatically
+   if you fail to comply with any term. Upon termination, you must destroy
+   all copies of the Software in your possession.
+
+9. GOVERNING LAW
+
+   This License shall be governed by the laws of the Republic of South Africa.
+
+For licensing inquiries: licensing@filemayor.com
+For support: support@filemayor.com

package/README.md

@@ -1,96 +1,96 @@
-<div align="center">
-<img src="https://raw.githubusercontent.com/Hrypopo/filemayor-landing/main/logo.png" width="128" height="128" alt="FileMayor logo" />
-
-# FileMayor
-### The intelligent, local-first engine for filesystem order.
-
-`v3.0.0` · Windows · macOS · Linux · Node ≥18 · **Zero Dependencies**
-
-[Website](https://filemayor.com) · [npm](https://www.npmjs.com/package/filemayor) · [Safety Report](#security)
-
-</div>
-
----
-
-## Why FileMayor?
-
-Hacker News skeptics, we hear you. Why not `du`, `find`, or `ncdu`? 
-
-Unix tools are powerful but dangerous and manual. **FileMayor** provides a middle ground: **Recursive context-aware intelligence** paired with **Psychological Safety**. 
-
-- **Intelligence**: Don't just list files; analyze bloat, find duplicates across names, and auto-categorize into 12 smart categories.
-- **Safety**: Every move is journaled. Every destructive action is dry-run by default. Every mistake is reversible.
-
-## Install
-
-```bash
-npm install -g filemayor
-```
-
-## Quick Start
-
-```bash
-# Get deep insights into your disk bloat and duplicate waste
-filemayor analyze ~/Downloads
-
-# Preview a massive organization change without touching a bit
-filemayor organize ~/Downloads --dry-run
-
-# Reclaim space by nuking system junk and temporary rot
-filemayor clean /var/tmp --yes
-
-# Restore order if you change your mind
-filemayor undo ~/Downloads
-```
-
-## Features
-
-- **`analyze` (New)**: Deep intelligence. Fhash-based duplicate detection, top directory bloat mapping, and potential savings calculation.
-- **`organize`**: Deterministic sorting into Documents, Images, Media, etc.
-- **`clean`**: Multi-category junk removal (temp, cache, logs, system, dependencies).
-- **`watch` (Pro)**: Real-time background organization using a high-performance rules engine.
-- **`undo`**: 100% cryptographic rollback of any organizational operation.
-
-## Security & Safety Protocols
-
-We touch your files. We take that seriously.
-
-1.  **100% Local**: No telemetry. No cloud uploads. No API calls to remote servers. Your file names and structures never leave your RAM.
-2.  **Dry-Run by Default**: Organization commands require an explicit execution or a `--dry-run` preview.
-3.  **Rollback Journaling**: Every move is recorded in a local `.filemayor-journal.json`. The `undo` command uses this to restore your filesystem state perfectly.
-4.  **Supply-Chain Secured**: **Zero** runtime dependencies. No hidden npm vulnerabilities. No `node_modules` rot in production.
-
-## Configuration
-
-Control your engine with a simple `.filemayor.yml`:
-
-```yaml
-organize:
-  naming: category_prefix    # options: original | category_prefix | date_prefix | clean
-  duplicates: rename         # options: rename | skip | overwrite
-  ignore: [node_modules, .git, dist, build]
-
-watch:
-  directories: [~/Downloads]
-  rules:
-    - match: "*.pdf"
-      action: move
-      dest: ~/Documents/Finance
-```
-
-## Pricing
-
-FileMayor is built by builders for builders.
-- **Free**: Core scanning, organization, cleaning, and undo.
-- **Pro**: Real-time Watch mode, AI-powered SOP parsing, and Bulk processing.
-- **Activation**: `filemayor license activate FM-PRO-XXXX`
-
----
-
-<div align="center">
-
-Created by **Lehlohonolo Goodwill Nchefu (Chevza)**
-
-Built for the builders who refuse to let digital rot win.
-
-</div>
+<div align="center">
+<img src="https://raw.githubusercontent.com/Hrypopo/filemayor-landing/main/logo.png" width="128" height="128" alt="FileMayor logo" />
+
+# FileMayor
+### The intelligent, local-first engine for filesystem order.
+
+`v3.0.0` · Windows · macOS · Linux · Node ≥18 · **Zero Dependencies**
+
+[Website](https://filemayor.com) · [npm](https://www.npmjs.com/package/filemayor) · [Safety Report](#security)
+
+</div>
+
+---
+
+## Why FileMayor?
+
+Hacker News skeptics, we hear you. Why not `du`, `find`, or `ncdu`? 
+
+Unix tools are powerful but dangerous and manual. **FileMayor** provides a middle ground: **Recursive context-aware intelligence** paired with **Psychological Safety**. 
+
+- **Intelligence**: Don't just list files; analyze bloat, find duplicates across names, and auto-categorize into 12 smart categories.
+- **Safety**: Every move is journaled. Every destructive action is dry-run by default. Every mistake is reversible.
+
+## Install
+
+```bash
+npm install -g filemayor
+```
+
+## Quick Start
+
+```bash
+# Get deep insights into your disk bloat and duplicate waste
+filemayor analyze ~/Downloads
+
+# Preview a massive organization change without touching a bit
+filemayor organize ~/Downloads --dry-run
+
+# Reclaim space by nuking system junk and temporary rot
+filemayor clean /var/tmp --yes
+
+# Restore order if you change your mind
+filemayor undo ~/Downloads
+```
+
+## Features
+
+- **`analyze` (New)**: Deep intelligence. Fhash-based duplicate detection, top directory bloat mapping, and potential savings calculation.
+- **`organize`**: Deterministic sorting into Documents, Images, Media, etc.
+- **`clean`**: Multi-category junk removal (temp, cache, logs, system, dependencies).
+- **`watch` (Pro)**: Real-time background organization using a high-performance rules engine.
+- **`undo`**: 100% cryptographic rollback of any organizational operation.
+
+## Security & Safety Protocols
+
+We touch your files. We take that seriously.
+
+1.  **100% Local**: No telemetry. No cloud uploads. No API calls to remote servers. Your file names and structures never leave your RAM.
+2.  **Dry-Run by Default**: Organization commands require an explicit execution or a `--dry-run` preview.
+3.  **Rollback Journaling**: Every move is recorded in a local `.filemayor-journal.json`. The `undo` command uses this to restore your filesystem state perfectly.
+4.  **Supply-Chain Secured**: **Zero** runtime dependencies. No hidden npm vulnerabilities. No `node_modules` rot in production.
+
+## Configuration
+
+Control your engine with a simple `.filemayor.yml`:
+
+```yaml
+organize:
+  naming: category_prefix    # options: original | category_prefix | date_prefix | clean
+  duplicates: rename         # options: rename | skip | overwrite
+  ignore: [node_modules, .git, dist, build]
+
+watch:
+  directories: [~/Downloads]
+  rules:
+    - match: "*.pdf"
+      action: move
+      dest: ~/Documents/Finance
+```
+
+## Pricing
+
+FileMayor is built by builders for builders.
+- **Free**: Core scanning, organization, cleaning, and undo.
+- **Pro**: Real-time Watch mode, AI-powered SOP parsing, and Bulk processing.
+- **Activation**: `filemayor license activate FM-PRO-XXXX`
+
+---
+
+<div align="center">
+
+Created by **Lehlohonolo Goodwill Nchefu (Chevza)**
+
+Built for the builders who refuse to let digital rot win.
+
+</div>