fs MUST give the file calls under short plain names and shapes (readTextFile, writeTextFile with append, create, createNew and mode, readFile, writeFile, remove with recursive, mkdir, stat, lstat, readDir, makeTempDir, makeTempFile, rename, copyFile, chmod, symlink, readLink, realPath, truncate, utime, and the synchronous forms in use), accept a path as a string or a file: URL, and give the helpers the harnesses wrote over them (exists, readTextOr, ensureDir, writeIfChanged in one step, listDirs, listFiles, walkFiles, sha256File, withTempDir).
Enforced (check): .github: cd commons/system && bun test suite/ — fs.test.ts: every call on a real temporary folder, the refusals
Proved by: system/suite/fs.test.ts
Written in: system/src/fs.ts
Tests: passed: suite/fs.test.ts folders made, listed, stat'd and removed; removing what is not there is NotFound; passed: suite/fs.test.ts text and bytes written, appended and read; createNew and create:false refuse; passed: suite/fs.test.ts Stolos's helpers: readTextOr, ensureDir, writeIfChanged, listDirs, listFiles, walkFiles, s; passed: suite/fs.test.ts regression: a temporary folder with no prefix is made inside the temporary folder, not bes; passed: suite/fs.test.ts temporary folders and files, rename, copy, chmod, links, realPath, truncate, utime
Cited by: fs, System