@hanseltime/template-repo-sync 2.1.2 → 2.2.0

package/CHANGELOG.md

@@ -1,3 +1,10 @@
+# [2.2.0](https://github.com/HanseltimeIndustries/template-repo-sync/compare/v2.1.2...v2.2.0) (2026-02-21)
+
+
+### Features
+
+* add modified files output to track actual sync changes ([050ffd0](https://github.com/HanseltimeIndustries/template-repo-sync/commit/050ffd0ff74195943e60fc8dbf4354191959c0be))
+
 ## [2.1.2](https://github.com/HanseltimeIndustries/template-repo-sync/compare/v2.1.1...v2.1.2) (2026-02-08)
 
 

package/lib/cjs/formatting/sync-results-to-md.js

@@ -21,6 +21,23 @@ ${result.localFileChanges[file].reduce((diffS, change) => {
         }, "")}
 \`\`\``;
     }, "")}
+
+## Files Modified (${result.modifiedFiles.total})
+
+Added:
+${result.modifiedFiles.added.reduce((s, f) => {
+        return `${s}\n- ${f}`;
+    }, "")}
+
+Modified:
+${result.modifiedFiles.modified.reduce((s, f) => {
+        return `${s}\n- ${f}`;
+    }, "")}
+
+Deleted:
+${result.modifiedFiles.deleted.reduce((s, f) => {
+        return `${s}\n- ${f}`;
+    }, "")}
 `;
 }
 exports.syncResultsToMd = syncResultsToMd;

package/lib/cjs/merge-file.d.ts

@@ -14,7 +14,8 @@ interface MergeFileReturn {
     ignoredDueToLocal: boolean;
     /**
      * Only available if the file wasn't ignored, this is a list of lineDiffs
-     * from the the diff library that were applied to what would've been removed
+     * from the diff library that were applied to what would've been changed by
+     * the base templatesync repo
      */
     localChanges?: Change[];
 }

package/lib/cjs/template-sync.d.ts

@@ -1,6 +1,6 @@
 import { Change } from "diff";
 import { TemplateCloneDriverFn } from "./clone-drivers";
-import { TemplateDiffDriverFn } from "./diff-drivers";
+import { DiffResult, TemplateDiffDriverFn } from "./diff-drivers";
 import { TemplateRefDriverFn } from "./ref-drivers/types";
 import { TemplateCheckoutDriverFn } from "./checkout-drivers";
 export interface TemplateSyncOptions {
@@ -57,6 +57,16 @@ export interface TemplateSyncReturn {
     localFileChanges: {
         [filePath: string]: Change[];
     };
+    /**
+     * A list of all files that are modified by this operation.  You can use total to quickly check if
+     * there was an actual meaningful change.
+     *
+     * Please note, ther may be localSkipfiles and total: 0, which indicates there were changes BUT the local template
+     * sync file rendered them meaningless.
+     */
+    modifiedFiles: DiffResult & {
+        total: number;
+    };
 }
 export declare const TEMPLATE_SYNC_CONFIG = "templatesync";
 export declare const TEMPLATE_SYNC_LOCAL_CONFIG = "templatesync.local";

package/lib/cjs/template-sync.js

@@ -83,7 +83,7 @@ async function templateSync(options) {
     filesToSync.added = filesToSync.added.filter((f) => !(0, micromatch_1.some)(f, templateSyncConfig.ignore));
     filesToSync.modified = filesToSync.modified.filter((f) => !(0, micromatch_1.some)(f, templateSyncConfig.ignore));
     filesToSync.deleted = filesToSync.deleted.filter((f) => !(0, micromatch_1.some)(f, templateSyncConfig.ignore));
-    const localSkipFiles = [];
+    const localSkipFiles = new Set();
     const localFileChanges = {};
     const fileSyncFactory = (op) => {
         return async (f) => {
@@ -95,7 +95,7 @@ async function templateSync(options) {
                 fileOperation: op,
             });
             if (result.ignoredDueToLocal) {
-                localSkipFiles.push(f);
+                localSkipFiles.add(f);
             }
             else if (result?.localChanges && result.localChanges.length > 0) {
                 localFileChanges[f] = result.localChanges;
@@ -106,6 +106,16 @@ async function templateSync(options) {
     await Promise.all(filesToSync.added.map(fileSyncFactory("added")));
     await Promise.all(filesToSync.modified.map(fileSyncFactory("modified")));
     await Promise.all(filesToSync.deleted.map(fileSyncFactory("deleted")));
+    // Report the files that changed in general
+    const actualAdded = filesToSync.added.filter((f) => !localSkipFiles.has(f));
+    const actualModified = filesToSync.modified.filter((f) => !localSkipFiles.has(f));
+    const actualDeleted = filesToSync.deleted.filter((f) => !localSkipFiles.has(f));
+    const modifiedFiles = {
+        added: actualAdded,
+        modified: actualModified,
+        deleted: actualDeleted,
+        total: actualAdded.length + actualModified.length + actualDeleted.length,
+    };
     // apply after ref
     if (options.updateAfterRef) {
         const ref = await currentRefDriver({
@@ -122,8 +132,9 @@ async function templateSync(options) {
         }
     }
     return {
-        localSkipFiles,
+        localSkipFiles: Array.from(localSkipFiles),
         localFileChanges,
+        modifiedFiles: modifiedFiles,
     };
 }
 exports.templateSync = templateSync;

package/lib/esm/formatting/sync-results-to-md.js

@@ -21,6 +21,23 @@ ${result.localFileChanges[file].reduce((diffS, change) => {
         }, "")}
 \`\`\``;
     }, "")}
+
+## Files Modified (${result.modifiedFiles.total})
+
+Added:
+${result.modifiedFiles.added.reduce((s, f) => {
+        return `${s}\n- ${f}`;
+    }, "")}
+
+Modified:
+${result.modifiedFiles.modified.reduce((s, f) => {
+        return `${s}\n- ${f}`;
+    }, "")}
+
+Deleted:
+${result.modifiedFiles.deleted.reduce((s, f) => {
+        return `${s}\n- ${f}`;
+    }, "")}
 `;
 }
 exports.syncResultsToMd = syncResultsToMd;

package/lib/esm/template-sync.js

@@ -83,7 +83,7 @@ async function templateSync(options) {
     filesToSync.added = filesToSync.added.filter((f) => !(0, micromatch_1.some)(f, templateSyncConfig.ignore));
     filesToSync.modified = filesToSync.modified.filter((f) => !(0, micromatch_1.some)(f, templateSyncConfig.ignore));
     filesToSync.deleted = filesToSync.deleted.filter((f) => !(0, micromatch_1.some)(f, templateSyncConfig.ignore));
-    const localSkipFiles = [];
+    const localSkipFiles = new Set();
     const localFileChanges = {};
     const fileSyncFactory = (op) => {
         return async (f) => {
@@ -95,7 +95,7 @@ async function templateSync(options) {
                 fileOperation: op,
             });
             if (result.ignoredDueToLocal) {
-                localSkipFiles.push(f);
+                localSkipFiles.add(f);
             }
             else if (result?.localChanges && result.localChanges.length > 0) {
                 localFileChanges[f] = result.localChanges;
@@ -106,6 +106,16 @@ async function templateSync(options) {
     await Promise.all(filesToSync.added.map(fileSyncFactory("added")));
     await Promise.all(filesToSync.modified.map(fileSyncFactory("modified")));
     await Promise.all(filesToSync.deleted.map(fileSyncFactory("deleted")));
+    // Report the files that changed in general
+    const actualAdded = filesToSync.added.filter((f) => !localSkipFiles.has(f));
+    const actualModified = filesToSync.modified.filter((f) => !localSkipFiles.has(f));
+    const actualDeleted = filesToSync.deleted.filter((f) => !localSkipFiles.has(f));
+    const modifiedFiles = {
+        added: actualAdded,
+        modified: actualModified,
+        deleted: actualDeleted,
+        total: actualAdded.length + actualModified.length + actualDeleted.length,
+    };
     // apply after ref
     if (options.updateAfterRef) {
         const ref = await currentRefDriver({
@@ -122,8 +132,9 @@ async function templateSync(options) {
         }
     }
     return {
-        localSkipFiles,
+        localSkipFiles: Array.from(localSkipFiles),
         localFileChanges,
+        modifiedFiles: modifiedFiles,
     };
 }
 exports.templateSync = templateSync;

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@hanseltime/template-repo-sync",
-  "version": "2.1.2",
+  "version": "2.2.0",
   "description": "An npm library that enables pluggable, customizable synchronization between template repos",
   "main": "lib/cjs/index.js",
   "types": "lib/cjs/index.d.ts",

package/src/formatting/__snapshots__/sync-results-to-md.spec.ts.snap

@@ -18,5 +18,22 @@ package.json
 -your thang
 
 \`\`\`
+
+## Files Modified (6)
+
+Added:
+
+- src/something.ts
+- new_settings.toml
+
+Modified:
+
+- something.txt
+- .env
+
+Deleted:
+
+- TODO.md
+- throwaway.ts
 "
 `;

package/src/formatting/sync-results-to-md.spec.ts

@@ -19,6 +19,12 @@ describe("syncResultsToMd", () => {
             },
           ],
         },
+        modifiedFiles: {
+          added: ["src/something.ts", "new_settings.toml"],
+          deleted: ["TODO.md", "throwaway.ts"],
+          modified: ["something.txt", ".env"],
+          total: 6,
+        },
       }),
     ).toMatchSnapshot();
   });

package/src/formatting/sync-results-to-md.ts

@@ -23,6 +23,23 @@ ${result.localFileChanges[file].reduce((diffS, change) => {
 }, "")}
 \`\`\``;
 }, "")}
+
+## Files Modified (${result.modifiedFiles.total})
+
+Added:
+${result.modifiedFiles.added.reduce((s, f) => {
+  return `${s}\n- ${f}`;
+}, "")}
+
+Modified:
+${result.modifiedFiles.modified.reduce((s, f) => {
+  return `${s}\n- ${f}`;
+}, "")}
+
+Deleted:
+${result.modifiedFiles.deleted.reduce((s, f) => {
+  return `${s}\n- ${f}`;
+}, "")}
 `;
 }
 

package/src/merge-file.ts

@@ -22,7 +22,8 @@ interface MergeFileReturn {
   ignoredDueToLocal: boolean;
   /**
    * Only available if the file wasn't ignored, this is a list of lineDiffs
-   * from the the diff library that were applied to what would've been removed
+   * from the diff library that were applied to what would've been changed by
+   * the base templatesync repo
    */
   localChanges?: Change[];
 }

package/src/template-sync.spec.ts

@@ -44,6 +44,18 @@ describe("templateSync", () => {
       // Expect no changes since there was no local sync file
       localSkipFiles: [],
       localFileChanges: {},
+      modifiedFiles: {
+        added: [
+          "package.json",
+          "src/index.js",
+          "src/templated.js",
+          "src/templated.ts",
+          "templatesync.json",
+        ],
+        deleted: [],
+        modified: [],
+        total: 5,
+      },
     });
 
     // Verify the files
@@ -72,6 +84,18 @@ describe("templateSync", () => {
       // Expect no changes since there was no local sync file
       localSkipFiles: [],
       localFileChanges: {},
+      modifiedFiles: {
+        added: [
+          "package.json",
+          "src/index.js",
+          "src/templated.js",
+          "src/templated.ts",
+          "templatesync.json",
+        ],
+        deleted: [],
+        modified: [],
+        total: 5,
+      },
     });
 
     // Verify the files
@@ -175,6 +199,18 @@ describe("templateSync", () => {
         "package.json": expect.arrayContaining([]),
       }),
     );
+    // Make sure the result captures the changes
+    expect(result.modifiedFiles).toEqual({
+      added: [
+        "package.json",
+        "src/index.js",
+        "src/templated.js",
+        "templatesync.json",
+      ],
+      deleted: [],
+      modified: [],
+      total: 4,
+    });
 
     // Verify the files
     await fileMatchTemplate(tmpDir, "templatesync.json");
@@ -273,7 +309,7 @@ describe("templateSync", () => {
       checkoutDriver: dummyCheckoutDriver,
     });
 
-    // since there was no override for this file, not changes from the local file
+    // since there was no override for this file, no changes from the local file
     expect(result.localFileChanges).toEqual(expect.objectContaining({}));
 
     // Verify the files
@@ -318,7 +354,7 @@ describe("templateSync", () => {
       checkoutDriver: dummyCheckoutDriver,
     });
 
-    // since there was no override for this file, not changes from the local file
+    // since there was no override for this file, no changes from the local file
     expect(result.localFileChanges).toEqual(expect.objectContaining({}));
 
     // Verify the files

package/src/template-sync.ts

@@ -77,6 +77,16 @@ export interface TemplateSyncReturn {
   localFileChanges: {
     [filePath: string]: Change[];
   };
+  /**
+   * A list of all files that are modified by this operation.  You can use total to quickly check if
+   * there was an actual meaningful change.
+   *
+   * Please note, ther may be localSkipfiles and total: 0, which indicates there were changes BUT the local template
+   * sync file rendered them meaningless.
+   */
+  modifiedFiles: DiffResult & {
+    total: number;
+  };
 }
 
 export const TEMPLATE_SYNC_CONFIG = "templatesync";
@@ -153,7 +163,7 @@ export async function templateSync(
     (f) => !some(f, templateSyncConfig.ignore),
   );
 
-  const localSkipFiles: string[] = [];
+  const localSkipFiles: Set<string> = new Set();
   const localFileChanges: {
     [filePath: string]: Change[];
   } = {};
@@ -168,7 +178,7 @@ export async function templateSync(
         fileOperation: op,
       });
       if (result.ignoredDueToLocal) {
-        localSkipFiles.push(f);
+        localSkipFiles.add(f);
       } else if (result?.localChanges && result.localChanges.length > 0) {
         localFileChanges[f] = result.localChanges;
       }
@@ -180,6 +190,21 @@ export async function templateSync(
   await Promise.all(filesToSync.modified.map(fileSyncFactory("modified")));
   await Promise.all(filesToSync.deleted.map(fileSyncFactory("deleted")));
 
+  // Report the files that changed in general
+  const actualAdded = filesToSync.added.filter((f) => !localSkipFiles.has(f));
+  const actualModified = filesToSync.modified.filter(
+    (f) => !localSkipFiles.has(f),
+  );
+  const actualDeleted = filesToSync.deleted.filter(
+    (f) => !localSkipFiles.has(f),
+  );
+  const modifiedFiles = {
+    added: actualAdded,
+    modified: actualModified,
+    deleted: actualDeleted,
+    total: actualAdded.length + actualModified.length + actualDeleted.length,
+  };
+
   // apply after ref
   if (options.updateAfterRef) {
     const ref = await currentRefDriver({
@@ -203,7 +228,8 @@ export async function templateSync(
   }
 
   return {
-    localSkipFiles,
+    localSkipFiles: Array.from(localSkipFiles),
     localFileChanges,
+    modifiedFiles: modifiedFiles,
   };
 }