filemayor 3.6.0 → 4.0.5
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 +90 -90
- package/README.md +96 -96
- package/core/analyzer.js +163 -163
- package/core/categories.js +235 -235
- package/core/cleaner.js +527 -527
- package/core/config.js +562 -562
- package/core/fs-abstraction.js +110 -38
- package/core/index.js +135 -135
- package/core/intent-interpreter.js +209 -66
- package/core/license.js +403 -339
- package/core/organizer.js +414 -414
- package/core/reporter.js +783 -783
- package/core/scanner.js +466 -466
- package/core/security.js +370 -370
- package/core/sop-parser.js +564 -564
- package/core/telemetry.js +74 -0
- package/core/vault.js +83 -69
- package/core/watcher.js +478 -478
- package/index.js +895 -877
- package/package.json +2 -2
package/LICENSE
CHANGED
|
@@ -1,90 +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.com
|
|
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.com
|
|
90
|
-
For support: support@filemayor.com
|
|
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.com
|
|
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.com
|
|
90
|
+
For support: support@filemayor.com
|
package/README.md
CHANGED
|
@@ -1,96 +1,96 @@
|
|
|
1
|
-
<div align="center">
|
|
2
|
-
<img src="https://raw.githubusercontent.com/Hrypopo/filemayor-landing/main/logo.png" width="128" height="128" alt="FileMayor logo" />
|
|
3
|
-
|
|
4
|
-
# FileMayor
|
|
5
|
-
### The intelligent, local-first engine for filesystem order.
|
|
6
|
-
|
|
7
|
-
`v3.0.0` · Windows · macOS · Linux · Node ≥18 · **Zero Dependencies**
|
|
8
|
-
|
|
9
|
-
[Website](https://filemayor.com) · [npm](https://www.npmjs.com/package/filemayor) · [Safety Report](#security)
|
|
10
|
-
|
|
11
|
-
</div>
|
|
12
|
-
|
|
13
|
-
---
|
|
14
|
-
|
|
15
|
-
## Why FileMayor?
|
|
16
|
-
|
|
17
|
-
Hacker News skeptics, we hear you. Why not `du`, `find`, or `ncdu`?
|
|
18
|
-
|
|
19
|
-
Unix tools are powerful but dangerous and manual. **FileMayor** provides a middle ground: **Recursive context-aware intelligence** paired with **Psychological Safety**.
|
|
20
|
-
|
|
21
|
-
- **Intelligence**: Don't just list files; analyze bloat, find duplicates across names, and auto-categorize into 12 smart categories.
|
|
22
|
-
- **Safety**: Every move is journaled. Every destructive action is dry-run by default. Every mistake is reversible.
|
|
23
|
-
|
|
24
|
-
## Install
|
|
25
|
-
|
|
26
|
-
```bash
|
|
27
|
-
npm install -g filemayor
|
|
28
|
-
```
|
|
29
|
-
|
|
30
|
-
## Quick Start
|
|
31
|
-
|
|
32
|
-
```bash
|
|
33
|
-
# Get deep insights into your disk bloat and duplicate waste
|
|
34
|
-
filemayor analyze ~/Downloads
|
|
35
|
-
|
|
36
|
-
# Preview a massive organization change without touching a bit
|
|
37
|
-
filemayor organize ~/Downloads --dry-run
|
|
38
|
-
|
|
39
|
-
# Reclaim space by nuking system junk and temporary rot
|
|
40
|
-
filemayor clean /var/tmp --yes
|
|
41
|
-
|
|
42
|
-
# Restore order if you change your mind
|
|
43
|
-
filemayor undo ~/Downloads
|
|
44
|
-
```
|
|
45
|
-
|
|
46
|
-
## Features
|
|
47
|
-
|
|
48
|
-
- **`analyze` (New)**: Deep intelligence. Fhash-based duplicate detection, top directory bloat mapping, and potential savings calculation.
|
|
49
|
-
- **`organize`**: Deterministic sorting into Documents, Images, Media, etc.
|
|
50
|
-
- **`clean`**: Multi-category junk removal (temp, cache, logs, system, dependencies).
|
|
51
|
-
- **`watch` (Pro)**: Real-time background organization using a high-performance rules engine.
|
|
52
|
-
- **`undo`**: 100% cryptographic rollback of any organizational operation.
|
|
53
|
-
|
|
54
|
-
## Security & Safety Protocols
|
|
55
|
-
|
|
56
|
-
We touch your files. We take that seriously.
|
|
57
|
-
|
|
58
|
-
1. **100% Local**: No telemetry. No cloud uploads. No API calls to remote servers. Your file names and structures never leave your RAM.
|
|
59
|
-
2. **Dry-Run by Default**: Organization commands require an explicit execution or a `--dry-run` preview.
|
|
60
|
-
3. **Rollback Journaling**: Every move is recorded in a local `.filemayor-journal.json`. The `undo` command uses this to restore your filesystem state perfectly.
|
|
61
|
-
4. **Supply-Chain Secured**: **Zero** runtime dependencies. No hidden npm vulnerabilities. No `node_modules` rot in production.
|
|
62
|
-
|
|
63
|
-
## Configuration
|
|
64
|
-
|
|
65
|
-
Control your engine with a simple `.filemayor.yml`:
|
|
66
|
-
|
|
67
|
-
```yaml
|
|
68
|
-
organize:
|
|
69
|
-
naming: category_prefix # options: original | category_prefix | date_prefix | clean
|
|
70
|
-
duplicates: rename # options: rename | skip | overwrite
|
|
71
|
-
ignore: [node_modules, .git, dist, build]
|
|
72
|
-
|
|
73
|
-
watch:
|
|
74
|
-
directories: [~/Downloads]
|
|
75
|
-
rules:
|
|
76
|
-
- match: "*.pdf"
|
|
77
|
-
action: move
|
|
78
|
-
dest: ~/Documents/Finance
|
|
79
|
-
```
|
|
80
|
-
|
|
81
|
-
## Pricing
|
|
82
|
-
|
|
83
|
-
FileMayor is built by builders for builders.
|
|
84
|
-
- **Free**: Core scanning, organization, cleaning, and undo.
|
|
85
|
-
- **Pro**: Real-time Watch mode, AI-powered SOP parsing, and Bulk processing.
|
|
86
|
-
- **Activation**: `filemayor license activate FM-PRO-XXXX`
|
|
87
|
-
|
|
88
|
-
---
|
|
89
|
-
|
|
90
|
-
<div align="center">
|
|
91
|
-
|
|
92
|
-
Created by **Lehlohonolo Goodwill Nchefu (Chevza)**
|
|
93
|
-
|
|
94
|
-
Built for the builders who refuse to let digital rot win.
|
|
95
|
-
|
|
96
|
-
</div>
|
|
1
|
+
<div align="center">
|
|
2
|
+
<img src="https://raw.githubusercontent.com/Hrypopo/filemayor-landing/main/logo.png" width="128" height="128" alt="FileMayor logo" />
|
|
3
|
+
|
|
4
|
+
# FileMayor
|
|
5
|
+
### The intelligent, local-first engine for filesystem order.
|
|
6
|
+
|
|
7
|
+
`v3.0.0` · Windows · macOS · Linux · Node ≥18 · **Zero Dependencies**
|
|
8
|
+
|
|
9
|
+
[Website](https://filemayor.com) · [npm](https://www.npmjs.com/package/filemayor) · [Safety Report](#security)
|
|
10
|
+
|
|
11
|
+
</div>
|
|
12
|
+
|
|
13
|
+
---
|
|
14
|
+
|
|
15
|
+
## Why FileMayor?
|
|
16
|
+
|
|
17
|
+
Hacker News skeptics, we hear you. Why not `du`, `find`, or `ncdu`?
|
|
18
|
+
|
|
19
|
+
Unix tools are powerful but dangerous and manual. **FileMayor** provides a middle ground: **Recursive context-aware intelligence** paired with **Psychological Safety**.
|
|
20
|
+
|
|
21
|
+
- **Intelligence**: Don't just list files; analyze bloat, find duplicates across names, and auto-categorize into 12 smart categories.
|
|
22
|
+
- **Safety**: Every move is journaled. Every destructive action is dry-run by default. Every mistake is reversible.
|
|
23
|
+
|
|
24
|
+
## Install
|
|
25
|
+
|
|
26
|
+
```bash
|
|
27
|
+
npm install -g filemayor
|
|
28
|
+
```
|
|
29
|
+
|
|
30
|
+
## Quick Start
|
|
31
|
+
|
|
32
|
+
```bash
|
|
33
|
+
# Get deep insights into your disk bloat and duplicate waste
|
|
34
|
+
filemayor analyze ~/Downloads
|
|
35
|
+
|
|
36
|
+
# Preview a massive organization change without touching a bit
|
|
37
|
+
filemayor organize ~/Downloads --dry-run
|
|
38
|
+
|
|
39
|
+
# Reclaim space by nuking system junk and temporary rot
|
|
40
|
+
filemayor clean /var/tmp --yes
|
|
41
|
+
|
|
42
|
+
# Restore order if you change your mind
|
|
43
|
+
filemayor undo ~/Downloads
|
|
44
|
+
```
|
|
45
|
+
|
|
46
|
+
## Features
|
|
47
|
+
|
|
48
|
+
- **`analyze` (New)**: Deep intelligence. Fhash-based duplicate detection, top directory bloat mapping, and potential savings calculation.
|
|
49
|
+
- **`organize`**: Deterministic sorting into Documents, Images, Media, etc.
|
|
50
|
+
- **`clean`**: Multi-category junk removal (temp, cache, logs, system, dependencies).
|
|
51
|
+
- **`watch` (Pro)**: Real-time background organization using a high-performance rules engine.
|
|
52
|
+
- **`undo`**: 100% cryptographic rollback of any organizational operation.
|
|
53
|
+
|
|
54
|
+
## Security & Safety Protocols
|
|
55
|
+
|
|
56
|
+
We touch your files. We take that seriously.
|
|
57
|
+
|
|
58
|
+
1. **100% Local**: No telemetry. No cloud uploads. No API calls to remote servers. Your file names and structures never leave your RAM.
|
|
59
|
+
2. **Dry-Run by Default**: Organization commands require an explicit execution or a `--dry-run` preview.
|
|
60
|
+
3. **Rollback Journaling**: Every move is recorded in a local `.filemayor-journal.json`. The `undo` command uses this to restore your filesystem state perfectly.
|
|
61
|
+
4. **Supply-Chain Secured**: **Zero** runtime dependencies. No hidden npm vulnerabilities. No `node_modules` rot in production.
|
|
62
|
+
|
|
63
|
+
## Configuration
|
|
64
|
+
|
|
65
|
+
Control your engine with a simple `.filemayor.yml`:
|
|
66
|
+
|
|
67
|
+
```yaml
|
|
68
|
+
organize:
|
|
69
|
+
naming: category_prefix # options: original | category_prefix | date_prefix | clean
|
|
70
|
+
duplicates: rename # options: rename | skip | overwrite
|
|
71
|
+
ignore: [node_modules, .git, dist, build]
|
|
72
|
+
|
|
73
|
+
watch:
|
|
74
|
+
directories: [~/Downloads]
|
|
75
|
+
rules:
|
|
76
|
+
- match: "*.pdf"
|
|
77
|
+
action: move
|
|
78
|
+
dest: ~/Documents/Finance
|
|
79
|
+
```
|
|
80
|
+
|
|
81
|
+
## Pricing
|
|
82
|
+
|
|
83
|
+
FileMayor is built by builders for builders.
|
|
84
|
+
- **Free**: Core scanning, organization, cleaning, and undo.
|
|
85
|
+
- **Pro**: Real-time Watch mode, AI-powered SOP parsing, and Bulk processing.
|
|
86
|
+
- **Activation**: `filemayor license activate FM-PRO-XXXX`
|
|
87
|
+
|
|
88
|
+
---
|
|
89
|
+
|
|
90
|
+
<div align="center">
|
|
91
|
+
|
|
92
|
+
Created by **Lehlohonolo Goodwill Nchefu (Chevza)**
|
|
93
|
+
|
|
94
|
+
Built for the builders who refuse to let digital rot win.
|
|
95
|
+
|
|
96
|
+
</div>
|