filemayor 2.0.0 → 2.0.3

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
package/LICENSE ADDED
@@ -0,0 +1,90 @@
1
+ FILEMAYOR PROPRIETARY LICENSE
2
+
3
+ Copyright (c) 2024-2026 Lehlohonolo Goodwill Nchefu (Chevza). All rights reserved.
4
+
5
+ NOTICE: This software and all associated documentation files (the "Software")
6
+ are the proprietary property of Lehlohonolo Goodwill Nchefu (Chevza),
7
+ operating as FileMayor, and its contributors.
8
+
9
+ 1. GRANT OF LICENSE
10
+
11
+ Subject to the terms of this License, you are granted a limited,
12
+ non-exclusive, non-transferable, revocable license to:
13
+
14
+ a) USE the Software for personal, non-commercial purposes at no cost
15
+ ("Free Tier").
16
+
17
+ b) USE the Software for commercial purposes only upon purchasing a valid
18
+ commercial license from FileMayor ("Paid Tier").
19
+
20
+ 2. RESTRICTIONS
21
+
22
+ You may NOT:
23
+
24
+ a) Copy, modify, merge, publish, distribute, sublicense, or sell copies
25
+ of the Software without express written permission from FileMayor.
26
+
27
+ b) Reverse engineer, decompile, disassemble, or otherwise attempt to
28
+ derive the source code of compiled portions of the Software.
29
+
30
+ c) Remove or alter any proprietary notices, labels, or trademarks on
31
+ the Software.
32
+
33
+ d) Use the Software to create a competing product or service.
34
+
35
+ e) Use the Software's source code, in whole or in part, in any other
36
+ software product without a commercial license agreement.
37
+
38
+ 3. FREE TIER
39
+
40
+ The Free Tier grants individuals the right to:
41
+ - Use the desktop application for personal file organization
42
+ - Use the CLI tool for personal, non-commercial purposes
43
+ - Contribute improvements via pull requests (you retain copyright of
44
+ your contributions but grant FileMayor a perpetual license to use them)
45
+
46
+ 4. PAID TIER
47
+
48
+ Commercial use, including but not limited to:
49
+ - Enterprise deployment across multiple machines
50
+ - Integration into commercial products or workflows
51
+ - Use in a business or organizational setting
52
+ - Server / data center deployment
53
+ - SOP AI Engine features
54
+
55
+ requires a valid Paid Tier license. Contact licensing@filemayor.app
56
+ for commercial licensing inquiries.
57
+
58
+ 5. AI FEATURES
59
+
60
+ The Software includes AI-powered features that connect to third-party
61
+ APIs (Google Gemini). Use of these features is subject to:
62
+ - The respective third-party API terms of service
63
+ - Data processing as described in FileMayor's Privacy Policy
64
+ - Availability and rate limits of the third-party service
65
+
66
+ 6. DATA & PRIVACY
67
+
68
+ The Software processes files locally on your device. AI features may
69
+ transmit document text (not file contents) to third-party APIs for
70
+ analysis. No personal data is collected, stored, or sold by FileMayor.
71
+
72
+ 7. NO WARRANTY
73
+
74
+ THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS
75
+ OR IMPLIED. IN NO EVENT SHALL THE AUTHORS OR COPYRIGHT HOLDERS BE LIABLE
76
+ FOR ANY CLAIM, DAMAGES, OR OTHER LIABILITY ARISING FROM THE USE OF THE
77
+ SOFTWARE.
78
+
79
+ 8. TERMINATION
80
+
81
+ This License is effective until terminated. It terminates automatically
82
+ if you fail to comply with any term. Upon termination, you must destroy
83
+ all copies of the Software in your possession.
84
+
85
+ 9. GOVERNING LAW
86
+
87
+ This License shall be governed by the laws of the Republic of South Africa.
88
+
89
+ For licensing inquiries: licensing@filemayor.app
90
+ For support: support@filemayor.app
package/README.md ADDED
@@ -0,0 +1,91 @@
1
+ <div align="center">
2
+
3
+ # FileMayor
4
+
5
+ **Organize, scan, clean, and watch your filesystem — from any terminal.**
6
+
7
+ `v2.0.1` · Windows · macOS · Linux · Node ≥18
8
+
9
+ </div>
10
+
11
+ ---
12
+
13
+ ## Install
14
+
15
+ ```bash
16
+ npm install -g filemayor
17
+ ```
18
+
19
+ ## Commands
20
+
21
+ ```bash
22
+ filemayor scan ~/Downloads # See what's in a folder
23
+ filemayor organize ~/Downloads # Sort files into categories
24
+ filemayor organize ~/Downloads --dry-run # Preview without moving
25
+ filemayor clean /var/tmp --yes # Delete junk files
26
+ filemayor watch ~/Downloads # Auto-organize in real-time
27
+ filemayor undo ~/Downloads # Undo last organization
28
+ filemayor init # Create config file
29
+ filemayor info # System info + version
30
+ ```
31
+
32
+ ## What It Does
33
+
34
+ | Command | Description |
35
+ |---------|-------------|
36
+ | `scan` | Recursively scan directories — size, type, date filtering |
37
+ | `organize` | Auto-sort files into 12 categories with undo journal |
38
+ | `clean` | Detect and remove temp, cache, logs, system junk |
39
+ | `watch` | Monitor folders in real-time with rules engine |
40
+ | `undo` | Rollback any organization safely |
41
+
42
+ ## 12 File Categories · 180+ Extensions
43
+
44
+ Documents · Images · Audio · Video · Archives · Code · Config · Fonts · Data · Executables · Design · Books
45
+
46
+ ## Output Formats
47
+
48
+ ```bash
49
+ filemayor scan . --json # Machine-readable JSON
50
+ filemayor scan . --csv > out.csv # Spreadsheet export
51
+ filemayor scan . --minimal # Paths only
52
+ ```
53
+
54
+ ## Configuration
55
+
56
+ Create `.filemayor.yml` in any directory:
57
+
58
+ ```yaml
59
+ organize:
60
+ naming: category_prefix # original | category_prefix | date_prefix
61
+ duplicates: rename # rename | skip | overwrite
62
+ ignore: [node_modules, .git, dist]
63
+
64
+ watch:
65
+ directories: [~/Downloads]
66
+ rules:
67
+ - match: "*.pdf"
68
+ action: move
69
+ dest: ~/Documents/PDFs
70
+ ```
71
+
72
+ ## Security
73
+
74
+ - All processing is **100% local** — no data leaves your machine
75
+ - Path traversal protection on all operations
76
+ - System directory safeguards (won't touch OS files)
77
+ - Zero runtime dependencies
78
+
79
+ ## License
80
+
81
+ Proprietary — see [LICENSE](LICENSE) for details.
82
+
83
+ ---
84
+
85
+ <div align="center">
86
+
87
+ Created by **Lehlohonolo Goodwill Nchefu (Chevza)**
88
+
89
+ [GitHub](https://github.com/Hrypopo) · [npm](https://www.npmjs.com/package/filemayor)
90
+
91
+ </div>
package/core/reporter.js CHANGED
@@ -520,6 +520,7 @@ function banner() {
520
520
  return [
521
521
  '',
522
522
  c('bold', ` ${SYMBOLS.sparkle} FileMayor`) + c('dim', ' — Your Digital Life Organizer'),
523
+ c('dim', ' by Lehlohonolo Goodwill Nchefu (Chevza)'),
523
524
  c('dim', ` ${'─'.repeat(50)}`),
524
525
  ''
525
526
  ].join('\n');
package/index.js CHANGED
@@ -11,6 +11,7 @@
11
11
  * ╚═╝ ╚═╝╚══════╝╚══════╝╚═╝ ╚═╝╚═╝ ╚═╝ ╚═╝ ╚═════╝ ╚═╝ ╚═╝
12
12
  *
13
13
  * Your Digital Life Organizer — CLI Edition
14
+ * Created by Lehlohonolo Goodwill Nchefu (Chevza)
14
15
  * Works everywhere: terminals, servers, data centers, CI/CD
15
16
  *
16
17
  * ═══════════════════════════════════════════════════════════════════
package/package.json CHANGED
@@ -1,6 +1,6 @@
1
1
  {
2
2
  "name": "filemayor",
3
- "version": "2.0.0",
3
+ "version": "2.0.3",
4
4
  "description": "Enterprise file management engine — scan, organize, clean, and watch your filesystem from any terminal",
5
5
  "main": "index.js",
6
6
  "bin": {
@@ -25,8 +25,8 @@
25
25
  "automation"
26
26
  ],
27
27
  "author": {
28
- "name": "FileMayor",
29
- "url": "https://github.com/Hrypopo/FileMayor"
28
+ "name": "Lehlohonolo Goodwill Nchefu (Chevza)",
29
+ "url": "https://github.com/Hrypopo"
30
30
  },
31
31
  "license": "PROPRIETARY",
32
32
  "repository": {
@@ -48,8 +48,7 @@
48
48
  "files": [
49
49
  "index.js",
50
50
  "core/",
51
- "package.json",
52
- "../LICENSE",
53
- "../README.md"
51
+ "LICENSE",
52
+ "README.md"
54
53
  ]
55
54
  }