Initial release of File Tools 0.1.0

2026-09-01 02:55:06 +02:00
commit 055f533cf1
62 changed files with 9050 additions and 0 deletions
@@ -0,0 +1,32 @@
+# File Tools
+
+Identify, inspect and inventory local files in the browser.
+
+File Tools is a standalone local-first application in the [add·ideas Toolbox](https://git.add-ideas.de/lotobo/toolbox-portal). Inputs are processed in the browser and are not uploaded.
+
+## Version 0.1 scope
+
+- Bounded head/tail signature inspection with claimed-versus-detected MIME reporting
+- Paged 512-byte hexadecimal/ASCII views plus bounded UTF-8 and extracted-string previews
+- Streaming SHA-256 and SHA-512 hashing in a cancellable module worker
+- Same-size and same-hash duplicate candidates plus deterministic JSON/CSV inventory manifests
+
+Detection and entropy results are heuristics, not format validation, malware analysis or proof of encryption. A selection is limited to 500 entries; file contents remain represented by browser `File` handles and are read only for an inspection window, the visible hex window, or an explicitly requested streaming hash. File mutation, split/join and batch rename are not part of version 0.1. See [docs/ARCHITECTURE.md](docs/ARCHITECTURE.md) and [docs/PRIVACY-SECURITY.md](docs/PRIVACY-SECURITY.md).
+
+## Development
+
+Requires Node.js 22 and npm 11.
+
+```sh
+npm ci
+npm run check
+npm run test:browser
+```
+
+## Release
+
+`npm run release:artifact` creates a deterministic `release/file-tools-0.1.0.zip` and checksum sidecar.
+
+## Licence
+
+GPL-3.0-or-later. Runtime dependencies retain their own licences; see [THIRD_PARTY_NOTICES.md](THIRD_PARTY_NOTICES.md).