@bobfrankston/tsfind 0.1.2 → 0.1.3

package/README.md

@@ -33,7 +33,8 @@ tsfind [dir] [pattern] [options]
 |------|-------------|
 | `-o file` | Write the list (or the `-count` tables) to a file instead of the console |
 | `-l` | Long: date and size before each path |
-| `-d` | Also report directories and links whose names match (listed with no size) |
+| `-f` | Files only (default: files and directories whose names match) |
+| `-d` | Directories and links only (listed with no size) |
 | `-count` | Number and total size of matches by name and by extension |
 | `-sort key` | `-count` order: `size` (default), `count` or `name` |
 | `-top N` | `-count` rows per table (default 50; 0 = all) |

package/index.d.ts

@@ -4,6 +4,10 @@
  * count them by name and extension, or show where the space goes
  *
  * CHANGE LOG (newest first)
+ * 2026-11-14 — Claude Code (Opus 5.5), at Bob's direction ("tsfind xlate should find the xlate
+ *   directory as well as files with that name"): directories (and links) whose names match are now
+ *   reported by default. -f = files only; -d now means directories only (it used to mean "also
+ *   directories"). The summary counts files and directories separately.
  * 2026-11-11 — Claude Code (Opus 5.5), at Bob's direction: usage text and README brought into
  *   line: the same examples in both, and both say a walk lists unreadable entries even with -q.
  * 2026-11-09 — Claude Code (Opus 5.5), at Bob's direction: "if you can elevate without a prompt

package/index.js

@@ -4,6 +4,10 @@
  * count them by name and extension, or show where the space goes
  *
  * CHANGE LOG (newest first)
+ * 2026-11-14 — Claude Code (Opus 5.5), at Bob's direction ("tsfind xlate should find the xlate
+ *   directory as well as files with that name"): directories (and links) whose names match are now
+ *   reported by default. -f = files only; -d now means directories only (it used to mean "also
+ *   directories"). The summary counts files and directories separately.
  * 2026-11-11 — Claude Code (Opus 5.5), at Bob's direction: usage text and README brought into
  *   line: the same examples in both, and both say a walk lists unreadable entries even with -q.
  * 2026-11-09 — Claude Code (Opus 5.5), at Bob's direction: "if you can elevate without a prompt
@@ -91,8 +95,9 @@ Options:
     -o file     Write the list (or the tables) to file instead of the console
     -l          Long: date and size before each path (default: path only, one per line,
                 so the list can be edited)
-    -d          Also report directories and links whose names match (listed with no size;
-                the search never goes inside links or junctions)
+    -f          Files only (default: files and directories whose names match)
+    -d          Directories (and links) only. Directories are listed with no size; the
+                search never goes inside links or junctions
     -count      Instead of listing: number and total size of matches by name and by
                 extension
     -sort key   -count order: size (default), count or name
@@ -143,7 +148,7 @@ function parseArgs(args) {
         process.exit(1);
     }
     const options = {
-        positional: [], patterns: null, top: '.', outFile: '', long: false, dirs: false, count: false,
+        positional: [], patterns: null, top: '.', outFile: '', long: false, kinds: 'all', count: false,
         sort: 'size', rows: DEFAULT_TOP, hogs: null, hogsRows: DEFAULT_HOGS, hogsPercent: 0, quiet: false,
         refreshScan: '',
     };
@@ -165,8 +170,11 @@ function parseArgs(args) {
             case '-l':
                 options.long = true;
                 break;
+            case '-f':
+                options.kinds = 'files';
+                break;
             case '-d':
-                options.dirs = true;
+                options.kinds = 'dirs';
                 break;
             case '-count':
                 options.count = true;
@@ -514,6 +522,18 @@ function makeLimiter(max) {
         }
     };
 }
+/** "1 file", "2 files" */
+function plural(n, one, many) {
+    return `${n.toLocaleString()} ${n === 1 ? one : many}`;
+}
+/** Whether a match of this kind is reported under -f / -d / neither */
+function wanted(isDir, options) {
+    switch (options.kinds) {
+        case 'files': return !isDir;
+        case 'dirs': return isDir;
+        default: return true;
+    }
+}
 /**
  * Hand each match beneath `top` to onFound, reading WALK_CONCURRENCY directories at a time.
  * Links and junctions are reported like directories but never entered, as in searchVolume.
@@ -545,7 +565,7 @@ async function walkTree(top, regexes, options, onFound) {
                 subdirs.push(full);
             if (!regexes.some(rx => rx.test(entry.name)))
                 continue;
-            if (isDir && !options.dirs)
+            if (!wanted(isDir, options))
                 continue;
             stats.push(limit(() => fp.lstat(full)).then(st => onFound({ path: full, name: entry.name, size: isDir ? 0 : st.size, mtime: st.mtime, isDir }), 
             // Not lost: a match that vanished or cannot be read is listed with the summary.
@@ -580,7 +600,7 @@ function searchVolume(volume, start, regexes, options, onFound) {
             const name = volume.name(id);
             if (!regexes.some(rx => rx.test(name)))
                 continue;
-            if (isDir && !options.dirs)
+            if (!wanted(isDir, options))
                 continue;
             onFound({ path: volume.path(id), name, size: isDir ? 0 : volume.size(id), mtime: volume.mtime(id), isDir });
         }
@@ -717,11 +737,15 @@ async function main() {
     const found = [];
     const byName = new Map();
     const byExt = new Map();
-    let matchCount = 0;
+    let fileCount = 0;
+    let dirCount = 0;
     let matchBytes = 0;
     const tallying = options.count || !!options.hogs;
     const onFound = (f) => {
-        matchCount++;
+        if (f.isDir)
+            dirCount++;
+        else
+            fileCount++;
         matchBytes += f.size;
         if (!tallying) {
             found.push(f);
@@ -760,8 +784,10 @@ async function main() {
         await finished(out);
     }
     if (!options.quiet) {
-        const what = options.dirs ? 'matches' : 'files';
-        console.error(`${matchCount.toLocaleString()} ${what}, ${formatBytes(matchBytes)}; ${dirs.toLocaleString()} directories searched; ` +
+        const counts = options.kinds === 'files' ? plural(fileCount, 'file', 'files')
+            : options.kinds === 'dirs' ? `${plural(dirCount, 'directory', 'directories')} matched`
+                : `${plural(fileCount, 'file', 'files')} and ${plural(dirCount, 'directory', 'directories')} matched`;
+        console.error(`${counts}, ${formatBytes(matchBytes)}; ${dirs.toLocaleString()} directories searched; ` +
             `${elapsedText(elapsed)}${options.outFile ? `; written to ${path.resolve(options.outFile)}` : ''}`);
         console.error(styleText([source.stale ? 'red' : 'blue'], `From the ${source.text}.`));
     }

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@bobfrankston/tsfind",
-  "version": "0.1.2",
+  "version": "0.1.3",
   "description": "Find files by name in a directory tree; list them for editing, or count them by name and extension. Optional NTFS MFT reading for big drives.",
   "main": "index.js",
   "bin": {