@emeryld/rrroutes-export 1.0.5 → 1.0.7

package/README.md

@@ -77,6 +77,11 @@ Behavior summary:
   - route events (`route_added`, `route_removed`, `schema_changed`, `cfg_changed`)
   - source-object events (`source_object_added`, `source_object_removed`, `source_schema_changed`)
 
+Runtime progress logs:
+
+- `rrroutes-export-changelog` now prints step-by-step progress (window resolution, commit filtering, per-commit snapshot progress, diff totals, output writing, cleanup).
+- Bundle script prints stage logs for snapshot export + changelog export.
+
 ## Recommended end-to-end script
 
 Use this when you want one command to produce everything (snapshot + changelog + HTML + summary + timestamped storage).
@@ -135,5 +140,6 @@ const changelog = await exportFinalizedLeavesChangelog({
   to: 'HEAD',
   outFile: './finalized-leaves.changelog.json',
   htmlFile: './finalized-leaves.changelog.viewer.html',
+  log: (message) => console.log(message),
 })
 ```

package/dist/exportFinalizedLeaves.changelog.d.ts

@@ -114,6 +114,7 @@ export type ExportFinalizedLeavesChangelogOptions = {
     openOnFinish?: boolean;
     includeSource?: boolean;
     handlers?: ExportFinalizedLeavesOptions['handlers'];
+    log?: (message: string) => void;
 };
 declare function resolveCommitWindow(cwd: string, from?: string, to?: string): Promise<{
     from: string;

package/dist/index.cjs

@@ -1854,10 +1854,28 @@ async function loadChangelogInput(modulePath, exportName) {
   }
   return value;
 }
+async function ensureWorktreeDependencies(repoRoot, worktreeDir) {
+  const rootNodeModules = import_node_path4.default.join(repoRoot, "node_modules");
+  const worktreeNodeModules = import_node_path4.default.join(worktreeDir, "node_modules");
+  try {
+    await import_promises2.default.access(rootNodeModules);
+  } catch {
+    throw new Error(
+      `Missing dependencies at ${rootNodeModules}. Run install in the repository root before changelog export.`
+    );
+  }
+  try {
+    await import_promises2.default.lstat(worktreeNodeModules);
+    return;
+  } catch {
+  }
+  await import_promises2.default.symlink(rootNodeModules, worktreeNodeModules, "junction");
+}
 async function createSnapshot(repoRoot, moduleRel, exportName, commit, tempRoot, tsconfigRel, exportOptions) {
   const worktreeDir = import_node_path4.default.join(tempRoot, `wt-${commit.sha.slice(0, 12)}`);
   await runGit(repoRoot, ["worktree", "add", "--detach", worktreeDir, commit.sha]);
   try {
+    await ensureWorktreeDependencies(repoRoot, worktreeDir);
     const modulePath = import_node_path4.default.resolve(worktreeDir, moduleRel);
     const tsconfigPath = tsconfigRel ? import_node_path4.default.resolve(worktreeDir, tsconfigRel) : void 0;
     const input = await loadChangelogInput(modulePath, exportName);
@@ -2083,7 +2101,9 @@ async function writeFinalizedLeavesChangelogExport(payload, outFileOrOptions) {
   return written;
 }
 async function exportFinalizedLeavesChangelog(options) {
+  const log = options.log ?? (() => void 0);
   const cwd = process.cwd();
+  log(`[changelog] resolving repository root from ${cwd}`);
   const repoRoot = await runGit(cwd, ["rev-parse", "--show-toplevel"]);
   const modulePathAbsolute = import_node_path4.default.resolve(cwd, options.modulePath);
   const modulePathRelative = normalizePath(import_node_path4.default.relative(repoRoot, modulePathAbsolute));
@@ -2096,25 +2116,36 @@ async function exportFinalizedLeavesChangelog(options) {
     throw new Error("tsconfigPath must resolve inside the git repository root.");
   }
   const exportName = options.exportName ?? "leaves";
+  log("[changelog] resolving commit window");
   const window = await resolveCommitWindow(repoRoot, options.from, options.to);
+  log(`[changelog] window: ${window.from.slice(0, 12)}..${window.to.slice(0, 12)}`);
   const allCommits = await resolveCommitPath(repoRoot, window.from, window.to);
+  log(`[changelog] commits in ancestry path: ${allCommits.length}`);
   const selectedCommitShas = await filterCommits(
     repoRoot,
     allCommits,
     modulePathRelative,
     tsconfigRelative
   );
+  log(`[changelog] commits after path filter: ${selectedCommitShas.length}`);
   if (selectedCommitShas.length === 0) {
     selectedCommitShas.push(window.to);
+    log("[changelog] filter returned no commits, forcing tip commit inclusion");
   }
   const commits = [];
+  log("[changelog] loading commit metadata");
   for (const commit of selectedCommitShas) {
     commits.push(await getCommitMetadata(repoRoot, commit));
   }
   const tempRoot = await import_promises2.default.mkdtemp(import_node_path4.default.join(import_node_os.default.tmpdir(), "rrroutes-export-changelog-"));
+  log(`[changelog] temp workspace: ${tempRoot}`);
   try {
     const snapshots = [];
-    for (const commit of commits) {
+    for (let index = 0; index < commits.length; index += 1) {
+      const commit = commits[index];
+      log(
+        `[changelog] snapshot ${index + 1}/${commits.length}: ${commit.sha.slice(0, 12)} ${commit.subject}`
+      );
       snapshots.push(
         await createSnapshot(
           repoRoot,
@@ -2129,6 +2160,7 @@ async function exportFinalizedLeavesChangelog(options) {
     }
     const routeEvents = [];
     const sourceEvents = [];
+    log("[changelog] diffing adjacent snapshots");
     for (let i = 1; i < snapshots.length; i += 1) {
       const { routeEvents: nextRouteEvents, sourceEvents: nextSourceEvents } = diffSnapshots(
         snapshots[i - 1],
@@ -2137,6 +2169,9 @@ async function exportFinalizedLeavesChangelog(options) {
       routeEvents.push(...nextRouteEvents);
       sourceEvents.push(...nextSourceEvents);
     }
+    log(
+      `[changelog] diff complete: route events=${routeEvents.length}, source events=${sourceEvents.length}`
+    );
     const payload = {
       kind: "finalized-leaves-changelog",
       _meta: {
@@ -2154,6 +2189,7 @@ async function exportFinalizedLeavesChangelog(options) {
       rollups: buildRollups(routeEvents, sourceEvents, commits)
     };
     if (options.outFile || options.htmlFile) {
+      log("[changelog] writing output artifacts");
       await writeFinalizedLeavesChangelogExport(payload, {
         outFile: options.outFile,
         htmlFile: options.htmlFile,
@@ -2161,9 +2197,11 @@ async function exportFinalizedLeavesChangelog(options) {
         openOnFinish: options.openOnFinish
       });
     }
+    log("[changelog] done");
     return payload;
   } finally {
     await import_promises2.default.rm(tempRoot, { recursive: true, force: true }).catch(() => void 0);
+    log("[changelog] cleaned temp workspace");
   }
 }
 var __private = {
@@ -2210,6 +2248,10 @@ function parseFinalizedLeavesChangelogCliArgs(argv) {
 }
 async function runExportFinalizedLeavesChangelogCli(argv) {
   const args = parseFinalizedLeavesChangelogCliArgs(argv);
+  const log = (message) => {
+    process.stdout.write(`${message}
+`);
+  };
   const options = {
     modulePath: args.modulePath,
     exportName: args.exportName,
@@ -2218,9 +2260,12 @@ async function runExportFinalizedLeavesChangelogCli(argv) {
     tsconfigPath: args.tsconfigPath,
     from: args.from,
     to: args.to,
-    includeSource: true
+    includeSource: true,
+    log
   };
+  log("[changelog-cli] starting changelog export");
   const payload = await exportFinalizedLeavesChangelog(options);
+  log("[changelog-cli] changelog export completed");
   return {
     payload,
     outFile: import_node_path5.default.resolve(args.outFile),