# FileCraft

Filesystem, volume analytics, disk usage, and integrity workstation.

## Verbs
- `filecraft list --path <dir>`: Directory listing with file metadata and depth control
- `filecraft hash --path <file>`: Cryptographic hash calculation (sha256, md5, sha1)
- `filecraft grep --path <dir> --pattern <regex>`: High-speed regex search across text files
- `filecraft du --path <dir>`: Recursive disk usage breakdown and tree analysis
- `filecraft find-large --path <dir>`: Identify largest files exceeding size threshold
- `filecraft find-dups --path <dir>`: Duplicate file detection by byte size and hash
- `filecraft strings --file <bin>`: Extract printable strings from binary files
- `filecraft mcp`: FastMCP stdio server

## Status — does today / next week / non-goals

**Does today:** Python FastMCP workstation; 8 test fns; hash/grep/du/strings
family; most-composed craft in the fleet.

**Next week:** path-traversal confinement tests (refusal, proven); 3
fixture recipes; photocraft-deferred note if it carries exif.

**Non-goals:** recipes never touch `C:\Windows` (fixtures under fleet root
only).

## Lineage — the Storytold craft-app pattern

Storytold ArtCraft ([storytold/artcraft](https://github.com/storytold/artcraft) — "the IDE for artists") was the starting point. The 16 craft apps in the Storytold stable each ship one binary that is both the human CLI and the agent MCP server (stdio), headless-first, with `run.json` + report artifacts. That modus operandi and harness is what this repo implements; the code here is independent, the pattern is shared.