ts-repo-utils 6.1.0 → 7.0.0

package/dist/functions/gen-index.mjs

@@ -17,9 +17,10 @@ const defaultConfig = {
  * @throws Error if any step fails.
  */
 const genIndex = async (config) => {
-    echo('Starting index file generation...\n');
     // Merge config with defaults
     const filledConfig = fillConfig(config);
+    const conditionalEcho = filledConfig.silent ? () => { } : echo;
+    conditionalEcho('Starting index file generation...\n');
     // Normalize target directories to array
     const targetDirs = typeof config.targetDirectory === 'string'
         ? [config.targetDirectory]
@@ -32,29 +33,30 @@ const genIndex = async (config) => {
             await assertPathExists(resolvedDir, `Target directory: ${dir}`);
         }
         // Step 2: Generate index files
-        echo('Generating index files...');
+        conditionalEcho('Generating index files...');
         for (const dir of targetDirs) {
             const resolvedDir = path.resolve(dir);
             // eslint-disable-next-line no-await-in-loop
             await generateIndexFileForDir(resolvedDir, filledConfig);
         }
-        echo('✓ Index files generated\n');
+        conditionalEcho('✓ Index files generated\n');
         // Step 3: Format generated files
         if (filledConfig.formatCommand !== undefined) {
-            echo('Formatting generated files...');
+            conditionalEcho('Formatting generated files...');
             const fmtResult = await $(filledConfig.formatCommand, {
                 silent: filledConfig.silent,
             });
             if (Result.isErr(fmtResult)) {
                 throw new Error(`Formatting failed: ${fmtResult.value.message}`);
             }
-            echo('✓ Formatting completed\n');
+            conditionalEcho('✓ Formatting completed\n');
         }
-        echo('✅ Index file generation completed successfully!\n');
+        conditionalEcho('✅ Index file generation completed successfully!\n');
+        return Result.ok(undefined);
     }
     catch (error) {
-        echo(`❌ Index generation failed: ${String(error)}\n`);
-        throw error;
+        conditionalEcho(`❌ Index generation failed: ${String(error)}\n`);
+        return Result.err(error);
     }
 };
 const fillConfig = (config) => {

package/dist/functions/gen-index.mjs.map

@@ -1 +1 @@
-{"version":3,"file":"gen-index.mjs","sources":["../../src/functions/gen-index.mts"],"sourcesContent":[null],"names":[],"mappings":";;;;;AAyCA,MAAM,aAAa,GAAG;AACpB,IAAA,OAAO,EAAE,CAAC,kCAAkC,EAAE,iBAAiB,CAAC;AAChE,IAAA,gBAAgB,EAAE,CAAC,KAAK,EAAE,MAAM,CAAC;AACjC,IAAA,kBAAkB,EAAE,KAAK;IACzB,wBAAwB,EAAE,KAAK;AAC/B,IAAA,MAAM,EAAE,KAAK;CAGd;AAkBD;;;;;AAKG;MACU,QAAQ,GAAG,OAAO,MAAsB,KAAmB;IACtE,IAAI,CAAC,qCAAqC,CAAC;;AAG3C,IAAA,MAAM,YAAY,GAA2B,UAAU,CAAC,MAAM,CAAC;;AAG/D,IAAA,MAAM,UAAU,GACd,OAAO,MAAM,CAAC,eAAe,KAAK;AAChC,UAAE,CAAC,MAAM,CAAC,eAAe;AACzB,UAAE,MAAM,CAAC,eAAe;AAE5B,IAAA,IAAI;;AAEF,QAAA,KAAK,MAAM,GAAG,IAAI,UAAU,EAAE;YAC5B,MAAM,WAAW,GAAG,IAAI,CAAC,OAAO,CAAC,GAAG,CAAC;;YAErC,MAAM,gBAAgB,CAAC,WAAW,EAAE,qBAAqB,GAAG,CAAA,CAAE,CAAC;QACjE;;QAGA,IAAI,CAAC,2BAA2B,CAAC;AACjC,QAAA,KAAK,MAAM,GAAG,IAAI,UAAU,EAAE;YAC5B,MAAM,WAAW,GAAG,IAAI,CAAC,OAAO,CAAC,GAAG,CAAC;;AAErC,YAAA,MAAM,uBAAuB,CAAC,WAAW,EAAE,YAAY,CAAC;QAC1D;QACA,IAAI,CAAC,2BAA2B,CAAC;;AAGjC,QAAA,IAAI,YAAY,CAAC,aAAa,KAAK,SAAS,EAAE;YAC5C,IAAI,CAAC,+BAA+B,CAAC;YACrC,MAAM,SAAS,GAAG,MAAM,CAAC,CAAC,YAAY,CAAC,aAAa,EAAE;gBACpD,MAAM,EAAE,YAAY,CAAC,MAAM;AAC5B,aAAA,CAAC;AACF,YAAA,IAAI,MAAM,CAAC,KAAK,CAAC,SAAS,CAAC,EAAE;gBAC3B,MAAM,IAAI,KAAK,CAAC,CAAA,mBAAA,EAAsB,SAAS,CAAC,KAAK,CAAC,OAAO,CAAA,CAAE,CAAC;YAClE;YACA,IAAI,CAAC,0BAA0B,CAAC;QAClC;QAEA,IAAI,CAAC,mDAAmD,CAAC;IAC3D;IAAE,OAAO,KAAK,EAAE;QACd,IAAI,CAAC,8BAA8B,MAAM,CAAC,KAAK,CAAC,CAAA,EAAA,CAAI,CAAC;AACrD,QAAA,MAAM,KAAK;IACb;AACF;AAEA,MAAM,UAAU,GAAG,CAAC,MAAsB,KAA4B;IACpE,MAAM,gBAAgB,GACpB,MAAM,CAAC,gBAAgB,IAAI,aAAa,CAAC,gBAAgB;IAE3D,MAAM,eAAe,GACnB,MAAM,CAAC,wBAAwB,IAAI,aAAa,CAAC,wBAAwB;IAE3E,OAAO;QACL,aAAa,EAAE,MAAM,CAAC,aAAa;QACnC,eAAe,EAAE,IAAI,CAAC,MAAM,CAC1B,QAAQ,CAAC,MAAM,CAAC,eAAe;AAC7B,cAAE,CAAC,MAAM,CAAC,eAAe;AACzB,cAAE,MAAM,CAAC,eAAe,CAC3B;AACD,QAAA,OAAO,EAAE,IAAI,CAAC,MAAM,CAAC,OAAO,CAAC,CAAC,GAAG,CAAC,CAAC,OAAO,KACxC,OAAO,OAAO,KAAK;AACjB,cAAE;AACF,cAAE,IAAI,CACF,IAAI,CAAC,MAAM,CACT,GAAG,CAAC,QAAQ,CAAC,aAAS;gBACpB,IAAI,OAAO,KAAK,SAAS,IAAI,KAAK,CAAC,OAAO,CAAC,OAAO,CAAC,EAAE;oBACnD,OAAO,OAAO;gBAChB;AACA,gBAAA,OAAO,aAAa,CAAC,OAAO;AAC9B,YAAA,CAAC,CAAC,CACH,CACF,CAAC,GAAG,CACH,CAAC,GAAG,KACF,CAAC,EACC,YAAY,EACZ,QAAQ,GAKR,KAAI;gBACJ,KAAK,MAAM,OAAO,IAAI,GAAG,CAAC,MAAM,EAAE,EAAE;AAClC,oBAAA,IACE,UAAU,CAAC,OAAO,CAAC,YAAY,EAAE,OAAO,CAAC;wBACzC,UAAU,CAAC,OAAO,CAAC,QAAQ,EAAE,OAAO,CAAC,EACrC;AACA,wBAAA,OAAO,IAAI;oBACb;gBACF;AACA,gBAAA,OAAO,KAAK;AACd,YAAA,CAAC,CACJ,CAAC,KAAK,CACZ,CAAC,KAAK;AACP,QAAA,gBAAgB,EAAE,IAAI,CAAC,MAAM,CAAC,gBAAgB,CAAC;AAC/C,QAAA,kBAAkB,EAChB,MAAM,CAAC,kBAAkB,IAAI,aAAa,CAAC,kBAAkB;AAC/D,QAAA,wBAAwB,EAAE,eAAe;AACzC,QAAA,MAAM,EAAE,MAAM,CAAC,MAAM,IAAI,aAAa,CAAC,MAAM;KAC9C;AACH,CAAC;AAED;;;;;;;;;AASG;AACH,MAAM,uBAAuB,GAAG,OAC9B,OAAe,EACf,MAA8B,EAC9B,OAAgB,KACC;AACjB,IAAA,IAAI;AACF,QAAA,MAAM,aAAa,GAAG,OAAO,IAAI,OAAO;AACxC,QAAA,MAAM,OAAO,GAAG,MAAM,EAAE,CAAC,OAAO,CAAC,OAAO,EAAE,EAAE,aAAa,EAAE,IAAI,EAAE,CAAC;QAElE,MAAM,kBAAkB,GAAa,EAAE;QACvC,MAAM,iBAAiB,GAAa,EAAE;AAEtC,QAAA,KAAK,MAAM,KAAK,IAAI,OAAO,EAAE;AAC3B,YAAA,MAAM,SAAS,GAAG,KAAK,CAAC,IAAI;YAC5B,MAAM,SAAS,GAAG,IAAI,CAAC,IAAI,CAAC,OAAO,EAAE,SAAS,CAAC;YAC/C,MAAM,YAAY,GAAG,IAAI,CAAC,QAAQ,CAAC,aAAa,EAAE,SAAS,CAAC;YAE5D,IACE,MAAM,CAAC,OAAO,CAAC;AACb,gBAAA,YAAY,EAAE,SAAS;gBACvB,YAAY;AACZ,gBAAA,QAAQ,EAAE,SAAS;AACpB,aAAA,CAAC,EACF;AACA,gBAAA,SAAS;YACX;AAEA,YAAA,IAAI,KAAK,CAAC,WAAW,EAAE,EAAE;AACvB,gBAAA,kBAAkB,CAAC,IAAI,CAAC,SAAS,CAAC;;;gBAGlC,MAAM,uBAAuB,CAAC,SAAS,EAAE,MAAM,EAAE,aAAa,CAAC;YACjE;iBAAO,IACL,KAAK,CAAC,MAAM,EAAE;AACd,gBAAA,gBAAgB,CAAC;AACf,oBAAA,YAAY,EAAE,SAAS;AACvB,oBAAA,QAAQ,EAAE,YAAY;oBACtB,MAAM;AACP,iBAAA,CAAC,EACF;AACA,gBAAA,iBAAiB,CAAC,IAAI,CAAC,SAAS,CAAC;YACnC;QACF;QAEA,MAAM,YAAY,GAAG,oBAAoB,CACvC,kBAAkB,EAClB,iBAAiB,EACjB,MAAM,CACP;AAED,QAAA,MAAM,SAAS,GAAG,IAAI,CAAC,IAAI,CAAC,OAAO,EAAE,CAAA,KAAA,EAAQ,MAAM,CAAC,kBAAkB,CAAA,CAAE,CAAC;QAEzE,MAAM,EAAE,CAAC,SAAS,CAAC,SAAS,EAAE,YAAY,CAAC;AAC3C,QAAA,IAAI,CAAC,CAAA,WAAA,EAAc,IAAI,CAAC,QAAQ,CAAC,OAAO,CAAC,GAAG,EAAE,EAAE,SAAS,CAAC,CAAA,CAAE,CAAC;IAC/D;IAAE,OAAO,KAAK,EAAE;AACd,QAAA,MAAM,IAAI,KAAK,CACb,CAAA,uCAAA,EAA0C,OAAO,CAAA,EAAA,EAAK,MAAM,CAAC,KAAK,CAAC,CAAA,CAAE,CACtE;IACH;AACF,CAAC;AAED,MAAM,UAAU,GAAG,0BAA0B;AAE7C;;;;;;;;;;;;AAYG;AACH,MAAM,gBAAgB,GAAG,CAAC,EACxB,YAAY,EACZ,QAAQ,EACR,MAAM,GAKN,KAAa;IACb,MAAM,QAAQ,GAAG,IAAI,CAAC,QAAQ,CAAC,QAAQ,CAAC;IAExC,MAAM,GAAG,GAAG,IAAI,CAAC,OAAO,CAAC,QAAQ,CAAC;;IAGlC,IAAI,CAAC,MAAM,CAAC,gBAAgB,CAAC,GAAG,CAAC,GAAG,CAAC,EAAE;AACrC,QAAA,OAAO,KAAK;IACd;;AAGA,IAAA,IACE,UAAU,CAAC,IAAI,CAAC,QAAQ,CAAC;MACzB;AACA,QAAA,OAAO,KAAK;IACd;;IAGA,IACE,MAAM,CAAC,OAAO,CAAC;QACb,YAAY;AACZ,QAAA,YAAY,EAAE,QAAQ;QACtB,QAAQ;AACT,KAAA,CAAC,EACF;AACA,QAAA,OAAO,KAAK;IACd;AAEA,IAAA,OAAO,IAAI;AACb,CAAC;AAqBD;;;;;;;AAOG;AACH,MAAM,oBAAoB,GAAG,CAC3B,cAAiC,EACjC,aAAgC,EAChC,MAA8B,KACpB;AACV,IAAA,MAAM,gBAAgB,GAAG;AACvB,QAAA,GAAG,cAAc,CAAC,GAAG,CAAC,CAAC,MAAM,KAC3B,MAAM,CAAC,wBAAwB,KAAK;cAChC,CAAA,iBAAA,EAAoB,MAAM,CAAA,EAAA;cAC1B,oBAAoB,MAAM,CAAA,MAAA,EAAS,MAAM,CAAC,wBAAwB,IAAI,CAC3E;AACD,QAAA,GAAG,aAAa,CAAC,GAAG,CAAC,CAAC,IAAI,KAAI;AAC5B,YAAA,MAAM,kBAAkB,GAAG,IAAI,CAAC,QAAQ,CAAC,IAAI,EAAE,IAAI,CAAC,OAAO,CAAC,IAAI,CAAC,CAAC;AAElE,YAAA,OAAO,MAAM,CAAC,wBAAwB,KAAK;kBACvC,CAAA,iBAAA,EAAoB,kBAAkB,CAAA,EAAA;kBACtC,oBAAoB,kBAAkB,CAAA,EAAG,MAAM,CAAC,wBAAwB,IAAI;AAClF,QAAA,CAAC,CAAC;KACH;AAED,IAAA,OAAO,gBAAgB,CAAC,MAAM,KAAK;AACjC,UAAE;AACF,UAAE,gBAAgB,CAAC,IAAI,CAAC,IAAI,CAAC;AACjC,CAAC;;;;"}
+{"version":3,"file":"gen-index.mjs","sources":["../../src/functions/gen-index.mts"],"sourcesContent":[null],"names":[],"mappings":"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"}

package/dist/functions/index.mjs

@@ -1,9 +1,9 @@
 export { assertExt } from './assert-ext.mjs';
 export { assertPathExists, pathExists } from './assert-path-exists.mjs';
 export { assertRepoIsClean, repoIsDirty } from './assert-repo-is-clean.mjs';
-export { getDiffFrom, getUntrackedFiles } from './diff.mjs';
+export { getDiffFrom, getModifiedFiles, getStagedFiles, getUntrackedFiles } from './diff.mjs';
 export { $ } from './exec-async.mjs';
-export { formatDiffFrom, formatFiles, formatFilesList, formatUntracked } from './format.mjs';
+export { formatDiffFrom, formatFiles, formatFilesGlob, formatUncommittedFiles } from './format.mjs';
 export { genIndex } from './gen-index.mjs';
 export { checkShouldRunTypeChecks } from './should-run.mjs';
 export { executeParallel, executeStages } from './workspace-utils/execute-parallel.mjs';

package/dist/index.mjs

@@ -1,9 +1,9 @@
 export { assertExt } from './functions/assert-ext.mjs';
 export { assertPathExists, pathExists } from './functions/assert-path-exists.mjs';
 export { assertRepoIsClean, repoIsDirty } from './functions/assert-repo-is-clean.mjs';
-export { getDiffFrom, getUntrackedFiles } from './functions/diff.mjs';
+export { getDiffFrom, getModifiedFiles, getStagedFiles, getUntrackedFiles } from './functions/diff.mjs';
 export { $ } from './functions/exec-async.mjs';
-export { formatDiffFrom, formatFiles, formatFilesList, formatUntracked } from './functions/format.mjs';
+export { formatDiffFrom, formatFiles, formatFilesGlob, formatUncommittedFiles } from './functions/format.mjs';
 export { genIndex } from './functions/gen-index.mjs';
 export { checkShouldRunTypeChecks } from './functions/should-run.mjs';
 export { executeParallel, executeStages } from './functions/workspace-utils/execute-parallel.mjs';

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "ts-repo-utils",
-  "version": "6.1.0",
+  "version": "7.0.0",
   "private": false,
   "keywords": [
     "typescript"
@@ -27,7 +27,7 @@
     "assert-repo-is-clean": "./src/cmd/assert-repo-is-clean.mts",
     "check-should-run-type-checks": "./src/cmd/check-should-run-type-checks.mts",
     "format-diff-from": "./src/cmd/format-diff-from.mts",
-    "format-untracked": "./src/cmd/format-untracked.mts",
+    "format-uncommitted": "./src/cmd/format-uncommitted.mts",
     "gen-index-ts": "./src/cmd/gen-index-ts.mts"
   },
   "files": [

package/src/cmd/assert-repo-is-clean.mts

@@ -5,7 +5,7 @@ import { assertRepoIsClean } from '../functions/index.mjs';
 
 const cmdDef = cmd.command({
   name: 'assert-repo-is-clean-cli',
-  version: '6.1.0',
+  version: '7.0.0',
   args: {
     silent: cmd.flag({
       long: 'silent',

package/src/cmd/check-should-run-type-checks.mts

@@ -5,7 +5,7 @@ import { checkShouldRunTypeChecks } from '../functions/index.mjs';
 
 const cmdDef = cmd.command({
   name: 'check-should-run-type-checks-cli',
-  version: '6.1.0',
+  version: '7.0.0',
   args: {
     pathsIgnore: cmd.multioption({
       long: 'paths-ignore',

package/src/cmd/format-diff-from.mts

@@ -1,22 +1,35 @@
 #!/usr/bin/env -S npx tsx
 
 import * as cmd from 'cmd-ts';
+import { Result } from 'ts-data-forge';
 import { formatDiffFrom } from '../functions/index.mjs';
 
 const cmdDef = cmd.command({
   name: 'format-diff-from-cli',
-  version: '6.1.0',
+  version: '7.0.0',
   args: {
     base: cmd.positional({
       type: cmd.string,
       displayName: 'base',
       description: 'Base branch name or commit hash to compare against',
     }),
-    includeUntracked: cmd.flag({
-      long: 'include-untracked',
+    excludeUntracked: cmd.flag({
+      long: 'exclude-untracked',
       type: cmd.optional(cmd.boolean),
       description:
-        'Include untracked files in addition to diff files (default: true)',
+        'Exclude untracked files in addition to diff files (default: false)',
+    }),
+    excludeModified: cmd.flag({
+      long: 'exclude-modified',
+      type: cmd.optional(cmd.boolean),
+      description:
+        'Exclude modified files in addition to diff files (default: false)',
+    }),
+    excludeStaged: cmd.flag({
+      long: 'exclude-staged',
+      type: cmd.optional(cmd.boolean),
+      description:
+        'Exclude staged files in addition to diff files (default: false)',
     }),
     silent: cmd.flag({
       long: 'silent',
@@ -25,7 +38,13 @@ const cmdDef = cmd.command({
     }),
   },
   handler: (args) => {
-    main(args).catch((error) => {
+    main({
+      base: args.base,
+      excludeUntracked: args.excludeUntracked ?? false,
+      excludeModified: args.excludeModified ?? false,
+      excludeStaged: args.excludeStaged ?? false,
+      silent: args.silent ?? false,
+    }).catch((error) => {
       console.error('An error occurred:', error);
       process.exit(1);
     });
@@ -35,13 +54,20 @@ const cmdDef = cmd.command({
 const main = async (
   args: Readonly<{
     base: string;
-    includeUntracked?: boolean;
-    silent?: boolean;
+    excludeUntracked: boolean;
+    excludeModified: boolean;
+    excludeStaged: boolean;
+    silent: boolean;
   }>,
 ): Promise<void> => {
-  const result = await formatDiffFrom(args.base, args);
+  const result = await formatDiffFrom(args.base, {
+    includeUntracked: !args.excludeUntracked,
+    includeModified: !args.excludeModified,
+    includeStaged: !args.excludeStaged,
+    silent: args.silent,
+  });
 
-  if (result === 'err') {
+  if (Result.isErr(result)) {
     process.exit(1);
   }
 };

package/src/cmd/format-uncommitted.mts

@@ -0,0 +1,67 @@
+#!/usr/bin/env -S npx tsx
+
+import * as cmd from 'cmd-ts';
+import { Result } from 'ts-data-forge';
+import { formatUncommittedFiles } from '../functions/index.mjs';
+
+const cmdDef = cmd.command({
+  name: 'format-uncommitted-cli',
+  version: '7.0.0',
+  args: {
+    excludeUntracked: cmd.flag({
+      long: 'exclude-untracked',
+      type: cmd.optional(cmd.boolean),
+      description:
+        'Exclude untracked files in addition to diff files (default: false)',
+    }),
+    excludeModified: cmd.flag({
+      long: 'exclude-modified',
+      type: cmd.optional(cmd.boolean),
+      description:
+        'Exclude modified files in addition to diff files (default: false)',
+    }),
+    excludeStaged: cmd.flag({
+      long: 'exclude-staged',
+      type: cmd.optional(cmd.boolean),
+      description:
+        'Exclude staged files in addition to diff files (default: false)',
+    }),
+    silent: cmd.flag({
+      long: 'silent',
+      type: cmd.optional(cmd.boolean),
+      description: 'If true, suppresses output messages (default: false)',
+    }),
+  },
+  handler: (args) => {
+    main({
+      excludeUntracked: args.excludeUntracked ?? false,
+      excludeModified: args.excludeModified ?? false,
+      excludeStaged: args.excludeStaged ?? false,
+      silent: args.silent ?? false,
+    }).catch((error) => {
+      console.error('An error occurred:', error);
+      process.exit(1);
+    });
+  },
+});
+
+const main = async (
+  args: Readonly<{
+    excludeUntracked: boolean;
+    excludeModified: boolean;
+    excludeStaged: boolean;
+    silent: boolean;
+  }>,
+): Promise<void> => {
+  const result = await formatUncommittedFiles({
+    untracked: !args.excludeUntracked,
+    modified: !args.excludeModified,
+    staged: !args.excludeStaged,
+    silent: args.silent,
+  });
+  if (Result.isErr(result)) {
+    process.exit(1);
+  }
+};
+
+await cmd.run(cmdDef, process.argv.slice(2));

package/src/cmd/gen-index-ts.mts

@@ -38,7 +38,7 @@ const nonEmptyArray = <T extends cmd.Type<any, any>>(
 
 const cmdDef = cmd.command({
   name: 'gen-index-ts-cli',
-  version: '6.1.0',
+  version: '7.0.0',
   args: {
     // required args
     targetDirectory: cmd.positional({

package/src/functions/assert-repo-is-clean.mts

@@ -11,7 +11,10 @@ export const repoIsDirty = async (
   options?: Readonly<{ silent?: boolean }>,
 ): Promise<boolean> => {
   const status = await getGitStatus({ silent: options?.silent ?? false });
-  return status.isDirty;
+  if (Result.isErr(status)) {
+    throw new Error(`Failed to get git status: ${status.value}`);
+  }
+  return status.value.isDirty;
 };
 
 /**
@@ -21,38 +24,39 @@ export const repoIsDirty = async (
 export const assertRepoIsClean = async (
   options?: Readonly<{ silent?: boolean }>,
 ): Promise<void> => {
-  try {
-    const status = await getGitStatus({ silent: options?.silent ?? false });
+  const silent = options?.silent ?? false;
+  const conditionalEcho = silent ? () => {} : echo;
+
+  const gitStatusResult = await getGitStatus({ silent });
+
+  if (Result.isErr(gitStatusResult)) {
+    conditionalEcho(gitStatusResult.value);
+    return;
+  }
 
-    if (!status.isDirty) {
-      echo('Repo is clean\n');
-      return;
-    }
+  const gitStatus = gitStatusResult.value;
 
-    echo('Repo is dirty\n');
-    echo('Changed files:\n');
-    echo(status.stdout);
+  if (!gitStatus.isDirty) {
+    conditionalEcho('Repo is clean\n');
+    return;
+  }
 
-    // Show files not tracked by git and unstaged changes
-    const addResult = await $('git add -N .', {
-      silent: options?.silent ?? false,
-    });
-    if (Result.isErr(addResult)) {
-      echo('Warning: Failed to add untracked files for diff\n');
-    }
+  conditionalEcho('Repo is dirty\n');
+  conditionalEcho('Changed files:\n');
+  conditionalEcho(gitStatus.stdout);
 
-    const diffResult = await $('git diff', {
-      silent: options?.silent ?? false,
-    });
-    if (Result.isErr(diffResult)) {
-      echo('Warning: Failed to show diff\n');
-    }
+  // Show files not tracked by git and unstaged changes
+  const addResult = await $('git add -N .', { silent });
+  if (Result.isErr(addResult)) {
+    conditionalEcho('Warning: Failed to add untracked files for diff\n');
+  }
 
-    process.exit(1);
-  } catch (error) {
-    echo(`Error checking repository status: ${String(error)}\n`);
-    process.exit(1);
+  const diffResult = await $('git diff', { silent });
+  if (Result.isErr(diffResult)) {
+    conditionalEcho('Warning: Failed to show diff\n');
   }
+
+  process.exit(1);
 };
 
 /**
@@ -62,22 +66,27 @@ export const assertRepoIsClean = async (
  */
 const getGitStatus = async (
   options?: Readonly<{ silent?: boolean }>,
-): Promise<{
-  isDirty: boolean;
-  stdout: string;
-}> => {
+): Promise<
+  Result<
+    Readonly<{
+      isDirty: boolean;
+      stdout: string;
+    }>,
+    string
+  >
+> => {
   const res = await $('git status --porcelain', {
     silent: options?.silent ?? false,
   });
 
   if (Result.isErr(res)) {
-    throw new Error(`Failed to get git status: ${res.value.message}`);
+    return Result.err(`Failed to get git status: ${res.value.message}`);
   }
 
   const { stdout } = res.value;
 
-  return {
+  return Result.ok({
     isDirty: stdout.trim() !== '',
     stdout,
-  };
+  });
 };

package/src/functions/diff.mts

@@ -2,7 +2,10 @@ import { type ExecException } from 'node:child_process';
 import { Result } from 'ts-data-forge';
 import '../node-global.mjs';
 
-/** Get files that have been changed (git status). */
+/**
+ * Get untracked files from the working tree (files not added to git). Runs `git
+ * ls-files --others --exclude-standard [--deleted]`
+ */
 export const getUntrackedFiles = async (
   options?: Readonly<{
     /** @default true */
@@ -12,35 +15,60 @@ export const getUntrackedFiles = async (
   }>,
 ): Promise<
   Result<readonly string[], ExecException | Readonly<{ message: string }>>
-> => {
-  // Get changed files from git status
-  const result = await $(
-    [
-      `git ls-files --others --exclude-standard`,
-      // Append '--deleted' to include deleted files only if excludeDeleted is explicitly false
-      (options?.excludeDeleted ?? true) ? '' : '--deleted',
-    ]
-      .filter((s) => s !== '')
-      .join(' '),
-    { silent: options?.silent ?? false },
-  );
+> =>
+  cmdResultToFiles({
+    cmd: `git ls-files --others --exclude-standard`,
+    cmdOptionToExcludeDeleted: '',
+    cmdOptionToIncludeDeleted: '--deleted',
+    options,
+  });
 
-  if (Result.isErr(result)) {
-    return result;
-  }
-
-  const { stdout } = result.value;
-
-  // Parse git status output
-  const files = stdout
-    .split('\n')
-    .map((s) => s.trim())
-    .filter((s) => s !== '');
+/**
+ * Get modified files from the working tree (files that have been changed but
+ * not staged). Runs `git diff --name-only [--diff-filter=d]`
+ */
+export const getModifiedFiles = async (
+  options?: Readonly<{
+    /** @default true */
+    excludeDeleted?: boolean;
+    /** @default false */
+    silent?: boolean;
+  }>,
+): Promise<
+  Result<readonly string[], ExecException | Readonly<{ message: string }>>
+> =>
+  cmdResultToFiles({
+    cmd: `git diff --name-only`,
+    cmdOptionToExcludeDeleted: '--diff-filter=d', // lower case 'd' means exclude deleted files
+    cmdOptionToIncludeDeleted: '',
+    options,
+  });
 
-  return Result.ok(files);
-};
+/**
+ * Get files that are staged for commit (files added with git add). Runs `git
+ * diff --staged --name-only [--diff-filter=d]`
+ */
+export const getStagedFiles = async (
+  options?: Readonly<{
+    /** @default true */
+    excludeDeleted?: boolean;
+    /** @default false */
+    silent?: boolean;
+  }>,
+): Promise<
+  Result<readonly string[], ExecException | Readonly<{ message: string }>>
+> =>
+  cmdResultToFiles({
+    cmd: `git diff --staged --name-only`,
+    cmdOptionToExcludeDeleted: '--diff-filter=d', // lower case 'd' means exclude deleted files
+    cmdOptionToIncludeDeleted: '',
+    options,
+  });
 
-/** Get files that differ from the specified base branch or commit */
+/**
+ * Get files that differ from the specified base branch or commit. Runs `git
+ * diff --name-only <base> [--diff-filter=d]`
+ */
 export const getDiffFrom = async (
   base: string,
   options?: Readonly<{
@@ -51,13 +79,38 @@ export const getDiffFrom = async (
   }>,
 ): Promise<
   Result<readonly string[], ExecException | Readonly<{ message: string }>>
+> =>
+  cmdResultToFiles({
+    cmd: `git diff --name-only ${base}`,
+    cmdOptionToExcludeDeleted: '--diff-filter=d',
+    cmdOptionToIncludeDeleted: '',
+    options,
+  });
+
+const cmdResultToFiles = async ({
+  cmd,
+  cmdOptionToExcludeDeleted,
+  cmdOptionToIncludeDeleted,
+  options,
+}: Readonly<{
+  cmd: string;
+  cmdOptionToExcludeDeleted: string;
+  cmdOptionToIncludeDeleted: string;
+  options?: Readonly<{
+    /** @default true */
+    excludeDeleted?: boolean;
+    /** @default false */
+    silent?: boolean;
+  }>;
+}>): Promise<
+  Result<readonly string[], ExecException | Readonly<{ message: string }>>
 > => {
-  // Get files that differ from base branch/commit (excluding deleted files)
   const result = await $(
     [
-      `git diff --name-only`,
-      base,
-      (options?.excludeDeleted ?? true) ? '--diff-filter=d' : '',
+      cmd,
+      (options?.excludeDeleted ?? true)
+        ? cmdOptionToExcludeDeleted
+        : cmdOptionToIncludeDeleted,
     ]
       .filter((s) => s !== '')
       .join(' '),
@@ -70,7 +123,7 @@ export const getDiffFrom = async (
 
   const { stdout } = result.value;
 
-  // Parse git diff output
+  // Parse git output
   const files = stdout
     .split('\n')
     .map((line) => line.trim())