nx-npm-tools 0.2.0

package/README.md

@@ -0,0 +1,52 @@
+# nx-npm-tools
+
+Install globally:
+```bash
+npm i -g nx-npm-tools
+```
+
+## Prometheus mode (default)
+
+If you run commands without `--path`, it auto-walks upward until it finds a folder named `prometheus` and uses it as the station root.
+
+Alias:
+
+* `--pro` is the same as `--prometheus`
+
+## Commands
+
+### runOnce (per-station setup)
+
+```bash
+nx-npm-tools runOnce --pro --add-ncu --commit
+```
+
+### reportStation (visibility report)
+
+```bash
+nx-npm-tools reportStation --pro --out station-report.md
+```
+
+### publishStation (publish everything in dependency order)
+
+```bash
+nx-npm-tools publishStation --pro --access public --bump patch
+```
+
+Force clean install per package:
+
+```bash
+nx-npm-tools publishStation --pro --forceInstall --access public --bump patch
+```
+
+Publish one repo/package:
+
+```bash
+nx-npm-tools publishOne --cwd . --access public --bump patch
+```
+
+Git sync:
+
+```bash
+nx-npm-tools gitSync --message "publishing"
+```

package/dist/commands/gitSync.js

@@ -0,0 +1,26 @@
+import { Command } from "commander";
+import path from "node:path";
+import { gitAddCommitPush } from "../utils/git.js";
+export function gitSyncCommand() {
+    return new Command("gitSync")
+        .description("git add . + git commit + git push (optional upstream forcing)")
+        .option("--cwd <path>", "Repo folder (default: current dir)", process.cwd())
+        .option("--message <msg>", "Commit message", "publishing")
+        .option("--no-push", "Don't push")
+        .option("--remote <name>", "Remote name", "origin")
+        .option("--branch <name>", "Branch name (optional)")
+        .option("--set-upstream", "Push with --set-upstream (needs --branch)")
+        .option("--force-upstream", "Push with --force-with-lease")
+        .action(async (opts) => {
+        const cwd = path.resolve(opts.cwd);
+        await gitAddCommitPush(cwd, {
+            message: opts.message,
+            push: Boolean(opts.push),
+            remote: opts.remote,
+            branch: opts.branch,
+            setUpstream: Boolean(opts.setUpstream),
+            forceWithLease: Boolean(opts.forceUpstream)
+        });
+    });
+}
+//# sourceMappingURL=gitSync.js.map

package/dist/commands/gitSync.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"gitSync.js","sourceRoot":"","sources":["../../src/commands/gitSync.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,OAAO,EAAE,MAAM,WAAW,CAAC;AACpC,OAAO,IAAI,MAAM,WAAW,CAAC;AAC7B,OAAO,EAAE,gBAAgB,EAAE,MAAM,iBAAiB,CAAC;AAEnD,MAAM,UAAU,cAAc;IAC5B,OAAO,IAAI,OAAO,CAAC,SAAS,CAAC;SAC1B,WAAW,CAAC,+DAA+D,CAAC;SAC5E,MAAM,CAAC,cAAc,EAAE,oCAAoC,EAAE,OAAO,CAAC,GAAG,EAAE,CAAC;SAC3E,MAAM,CAAC,iBAAiB,EAAE,gBAAgB,EAAE,YAAY,CAAC;SACzD,MAAM,CAAC,WAAW,EAAE,YAAY,CAAC;SACjC,MAAM,CAAC,iBAAiB,EAAE,aAAa,EAAE,QAAQ,CAAC;SAClD,MAAM,CAAC,iBAAiB,EAAE,wBAAwB,CAAC;SACnD,MAAM,CAAC,gBAAgB,EAAE,2CAA2C,CAAC;SACrE,MAAM,CAAC,kBAAkB,EAAE,8BAA8B,CAAC;SAC1D,MAAM,CAAC,KAAK,EAAE,IAAI,EAAE,EAAE;QACrB,MAAM,GAAG,GAAG,IAAI,CAAC,OAAO,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC;QAEnC,MAAM,gBAAgB,CAAC,GAAG,EAAE;YAC1B,OAAO,EAAE,IAAI,CAAC,OAAO;YACrB,IAAI,EAAE,OAAO,CAAC,IAAI,CAAC,IAAI,CAAC;YACxB,MAAM,EAAE,IAAI,CAAC,MAAM;YACnB,MAAM,EAAE,IAAI,CAAC,MAAM;YACnB,WAAW,EAAE,OAAO,CAAC,IAAI,CAAC,WAAW,CAAC;YACtC,cAAc,EAAE,OAAO,CAAC,IAAI,CAAC,aAAa,CAAC;SAC5C,CAAC,CAAC;IACL,CAAC,CAAC,CAAC;AACP,CAAC"}

package/dist/commands/publishOne.js

@@ -0,0 +1,40 @@
+import { Command } from "commander";
+import path from "node:path";
+import { publishPackageFlow } from "../utils/git.js";
+export function publishOneCommand() {
+    return new Command("publishOne")
+        .description("Publish ONE package repo: install -> gitSync -> build -> dist check -> bump -> publish")
+        .option("--cwd <path>", "Package folder (default: current dir)", process.cwd())
+        .option("--message <msg>", "Git commit message", "publishing")
+        .option("--forceInstall", "Force reinstall (rm node_modules + lock + cache clean)")
+        .option("--no-push", "Don't push")
+        .option("--remote <name>", "Remote name", "origin")
+        .option("--branch <name>", "Branch name (optional)")
+        .option("--set-upstream", "Push with --set-upstream (needs --branch)")
+        .option("--force-upstream", "Push with --force-with-lease")
+        .option("--build-script <name>", "Build script name", "build")
+        .option("--dist-check <path>", "File to verify after build", "dist/index.js")
+        .option("--bump <type>", "npm version bump (patch|minor|major|none)", "patch")
+        .option("--access <type>", "npm publish access (public|restricted)", "public")
+        .option("--tag <name>", "npm dist-tag (optional)", "")
+        .option("--dry-run", "Don't execute commands", false)
+        .action(async (opts) => {
+        const cwd = path.resolve(opts.cwd);
+        await publishPackageFlow(cwd, {
+            message: opts.message,
+            forceInstall: Boolean(opts.forceInstall),
+            push: Boolean(opts.push),
+            remote: opts.remote,
+            branch: opts.branch,
+            setUpstream: Boolean(opts.setUpstream),
+            forceWithLease: Boolean(opts.forceUpstream),
+            buildScript: opts.buildScript,
+            distCheck: opts.distCheck,
+            bump: opts.bump,
+            access: opts.access,
+            tag: String(opts.tag || ""),
+            dryRun: Boolean(opts.dryRun)
+        });
+    });
+}
+//# sourceMappingURL=publishOne.js.map

package/dist/commands/publishOne.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"publishOne.js","sourceRoot":"","sources":["../../src/commands/publishOne.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,OAAO,EAAE,MAAM,WAAW,CAAC;AACpC,OAAO,IAAI,MAAM,WAAW,CAAC;AAC7B,OAAO,EAAE,kBAAkB,EAAE,MAAM,iBAAiB,CAAC;AAErD,MAAM,UAAU,iBAAiB;IAC/B,OAAO,IAAI,OAAO,CAAC,YAAY,CAAC;SAC7B,WAAW,CAAC,wFAAwF,CAAC;SACrG,MAAM,CAAC,cAAc,EAAE,uCAAuC,EAAE,OAAO,CAAC,GAAG,EAAE,CAAC;SAC9E,MAAM,CAAC,iBAAiB,EAAE,oBAAoB,EAAE,YAAY,CAAC;SAC7D,MAAM,CAAC,gBAAgB,EAAE,wDAAwD,CAAC;SAClF,MAAM,CAAC,WAAW,EAAE,YAAY,CAAC;SACjC,MAAM,CAAC,iBAAiB,EAAE,aAAa,EAAE,QAAQ,CAAC;SAClD,MAAM,CAAC,iBAAiB,EAAE,wBAAwB,CAAC;SACnD,MAAM,CAAC,gBAAgB,EAAE,2CAA2C,CAAC;SACrE,MAAM,CAAC,kBAAkB,EAAE,8BAA8B,CAAC;SAC1D,MAAM,CAAC,uBAAuB,EAAE,mBAAmB,EAAE,OAAO,CAAC;SAC7D,MAAM,CAAC,qBAAqB,EAAE,4BAA4B,EAAE,eAAe,CAAC;SAC5E,MAAM,CAAC,eAAe,EAAE,2CAA2C,EAAE,OAAO,CAAC;SAC7E,MAAM,CAAC,iBAAiB,EAAE,wCAAwC,EAAE,QAAQ,CAAC;SAC7E,MAAM,CAAC,cAAc,EAAE,yBAAyB,EAAE,EAAE,CAAC;SACrD,MAAM,CAAC,WAAW,EAAE,wBAAwB,EAAE,KAAK,CAAC;SACpD,MAAM,CAAC,KAAK,EAAE,IAAI,EAAE,EAAE;QACrB,MAAM,GAAG,GAAG,IAAI,CAAC,OAAO,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC;QAEnC,MAAM,kBAAkB,CAAC,GAAG,EAAE;YAC5B,OAAO,EAAE,IAAI,CAAC,OAAO;YACrB,YAAY,EAAE,OAAO,CAAC,IAAI,CAAC,YAAY,CAAC;YACxC,IAAI,EAAE,OAAO,CAAC,IAAI,CAAC,IAAI,CAAC;YACxB,MAAM,EAAE,IAAI,CAAC,MAAM;YACnB,MAAM,EAAE,IAAI,CAAC,MAAM;YACnB,WAAW,EAAE,OAAO,CAAC,IAAI,CAAC,WAAW,CAAC;YACtC,cAAc,EAAE,OAAO,CAAC,IAAI,CAAC,aAAa,CAAC;YAC3C,WAAW,EAAE,IAAI,CAAC,WAAW;YAC7B,SAAS,EAAE,IAAI,CAAC,SAAS;YACzB,IAAI,EAAE,IAAI,CAAC,IAAI;YACf,MAAM,EAAE,IAAI,CAAC,MAAM;YACnB,GAAG,EAAE,MAAM,CAAC,IAAI,CAAC,GAAG,IAAI,EAAE,CAAC;YAC3B,MAAM,EAAE,OAAO,CAAC,IAAI,CAAC,MAAM,CAAC;SAC7B,CAAC,CAAC;IACL,CAAC,CAAC,CAAC;AACP,CAAC"}

package/dist/commands/publishStation.js

@@ -0,0 +1,86 @@
+import { Command } from "commander";
+import { resolveStationRoot } from "../utils/path.js";
+import { discoverStationInventory } from "../station/discover.js";
+import { buildStationGraph } from "../station/graph.js";
+import { publishPackageFlow } from "../utils/git.js";
+export function publishStationCommand() {
+    return new Command("publishStation")
+        .description("Publish ALL station packages in dependency order (prometheus mode default).")
+        .option("--path <folder>", "Explicit station root folder (overrides prometheus mode)")
+        .option("--prometheus", "Use prometheus mode")
+        .option("--pro", "Alias of --prometheus")
+        .option("--prometheus-name <folder>", "Prometheus folder name", "prometheus")
+        .option("--max-up <n>", "Max parent hops", (v) => Number(v), 120)
+        .option("--message <msg>", "Git commit message", "publishing")
+        .option("--forceInstall", "Force reinstall per package")
+        .option("--no-push", "Don't push")
+        .option("--remote <name>", "Remote name", "origin")
+        .option("--branch <name>", "Branch name (optional)")
+        .option("--set-upstream", "Push with --set-upstream (needs --branch)")
+        .option("--force-upstream", "Push with --force-with-lease")
+        .option("--build-script <name>", "Build script name", "build")
+        .option("--dist-check <path>", "File to verify after build", "dist/index.js")
+        .option("--bump <type>", "npm version bump (patch|minor|major|none)", "patch")
+        .option("--access <type>", "npm publish access (public|restricted)", "public")
+        .option("--tag <name>", "npm dist-tag (optional)", "")
+        .option("--include-private", "Include packages marked private=true (NOT recommended)", false)
+        .option("--only <names>", "Comma-separated package names to publish (still ordered)", "")
+        .option("--dry-run", "Don't execute commands", false)
+        .action(async (opts) => {
+        const stationRoot = resolveStationRoot({
+            path: opts.path,
+            prometheus: opts.prometheus,
+            pro: opts.pro,
+            prometheusName: opts.prometheusName,
+            maxUp: opts.maxUp
+        });
+        console.log(`Station root: ${stationRoot}`);
+        const inv = await discoverStationInventory(stationRoot);
+        const graph = buildStationGraph(inv);
+        if (graph.issues.length) {
+            console.log("Graph issues:");
+            for (const i of graph.issues) {
+                if (i.type === "cycle")
+                    console.log(`- cycle detected among: ${i.cycle.join(", ")}`);
+                if (i.type === "missingLocalDep")
+                    console.log(`- ${i.package} missing local dep: ${i.missing}`);
+            }
+            console.log("");
+        }
+        let names = graph.topo;
+        if (!opts.includePrivate) {
+            names = names.filter(n => !(graph.nodes.get(n)?.private));
+        }
+        if (opts.only) {
+            const set = new Set(String(opts.only).split(",").map(s => s.trim()).filter(Boolean));
+            names = names.filter(n => set.has(n));
+        }
+        const publishables = names
+            .map(n => graph.nodes.get(n))
+            .filter(p => p.publishable);
+        console.log(`Publish order (${publishables.length}):`);
+        for (const p of publishables)
+            console.log(`- ${p.name} @ ${p.version}  (${p.cwd})`);
+        console.log("");
+        for (const p of publishables) {
+            console.log(`\n=== Publishing: ${p.name} (${p.cwd}) ===`);
+            await publishPackageFlow(p.cwd, {
+                message: opts.message,
+                forceInstall: Boolean(opts.forceInstall),
+                push: Boolean(opts.push),
+                remote: opts.remote,
+                branch: opts.branch,
+                setUpstream: Boolean(opts.setUpstream),
+                forceWithLease: Boolean(opts.forceUpstream),
+                buildScript: opts.buildScript,
+                distCheck: opts.distCheck,
+                bump: opts.bump,
+                access: opts.access,
+                tag: String(opts.tag || ""),
+                dryRun: Boolean(opts.dryRun)
+            });
+        }
+        console.log("\n✅ Station publish finished.");
+    });
+}
+//# sourceMappingURL=publishStation.js.map

package/dist/commands/publishStation.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"publishStation.js","sourceRoot":"","sources":["../../src/commands/publishStation.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,OAAO,EAAE,MAAM,WAAW,CAAC;AACpC,OAAO,EAAE,kBAAkB,EAAE,MAAM,kBAAkB,CAAC;AACtD,OAAO,EAAE,wBAAwB,EAAE,MAAM,wBAAwB,CAAC;AAClE,OAAO,EAAE,iBAAiB,EAAE,MAAM,qBAAqB,CAAC;AACxD,OAAO,EAAE,kBAAkB,EAAE,MAAM,iBAAiB,CAAC;AAErD,MAAM,UAAU,qBAAqB;IACnC,OAAO,IAAI,OAAO,CAAC,gBAAgB,CAAC;SACjC,WAAW,CAAC,6EAA6E,CAAC;SAC1F,MAAM,CAAC,iBAAiB,EAAE,0DAA0D,CAAC;SACrF,MAAM,CAAC,cAAc,EAAE,qBAAqB,CAAC;SAC7C,MAAM,CAAC,OAAO,EAAE,uBAAuB,CAAC;SACxC,MAAM,CAAC,4BAA4B,EAAE,wBAAwB,EAAE,YAAY,CAAC;SAC5E,MAAM,CAAC,cAAc,EAAE,iBAAiB,EAAE,CAAC,CAAC,EAAE,EAAE,CAAC,MAAM,CAAC,CAAC,CAAC,EAAE,GAAG,CAAC;SAChE,MAAM,CAAC,iBAAiB,EAAE,oBAAoB,EAAE,YAAY,CAAC;SAC7D,MAAM,CAAC,gBAAgB,EAAE,6BAA6B,CAAC;SACvD,MAAM,CAAC,WAAW,EAAE,YAAY,CAAC;SACjC,MAAM,CAAC,iBAAiB,EAAE,aAAa,EAAE,QAAQ,CAAC;SAClD,MAAM,CAAC,iBAAiB,EAAE,wBAAwB,CAAC;SACnD,MAAM,CAAC,gBAAgB,EAAE,2CAA2C,CAAC;SACrE,MAAM,CAAC,kBAAkB,EAAE,8BAA8B,CAAC;SAC1D,MAAM,CAAC,uBAAuB,EAAE,mBAAmB,EAAE,OAAO,CAAC;SAC7D,MAAM,CAAC,qBAAqB,EAAE,4BAA4B,EAAE,eAAe,CAAC;SAC5E,MAAM,CAAC,eAAe,EAAE,2CAA2C,EAAE,OAAO,CAAC;SAC7E,MAAM,CAAC,iBAAiB,EAAE,wCAAwC,EAAE,QAAQ,CAAC;SAC7E,MAAM,CAAC,cAAc,EAAE,yBAAyB,EAAE,EAAE,CAAC;SACrD,MAAM,CAAC,mBAAmB,EAAE,wDAAwD,EAAE,KAAK,CAAC;SAC5F,MAAM,CAAC,gBAAgB,EAAE,0DAA0D,EAAE,EAAE,CAAC;SACxF,MAAM,CAAC,WAAW,EAAE,wBAAwB,EAAE,KAAK,CAAC;SACpD,MAAM,CAAC,KAAK,EAAE,IAAI,EAAE,EAAE;QACrB,MAAM,WAAW,GAAG,kBAAkB,CAAC;YACrC,IAAI,EAAE,IAAI,CAAC,IAAI;YACf,UAAU,EAAE,IAAI,CAAC,UAAU;YAC3B,GAAG,EAAE,IAAI,CAAC,GAAG;YACb,cAAc,EAAE,IAAI,CAAC,cAAc;YACnC,KAAK,EAAE,IAAI,CAAC,KAAK;SAClB,CAAC,CAAC;QAEH,OAAO,CAAC,GAAG,CAAC,iBAAiB,WAAW,EAAE,CAAC,CAAC;QAE5C,MAAM,GAAG,GAAG,MAAM,wBAAwB,CAAC,WAAW,CAAC,CAAC;QACxD,MAAM,KAAK,GAAG,iBAAiB,CAAC,GAAG,CAAC,CAAC;QAErC,IAAI,KAAK,CAAC,MAAM,CAAC,MAAM,EAAE,CAAC;YACxB,OAAO,CAAC,GAAG,CAAC,eAAe,CAAC,CAAC;YAC7B,KAAK,MAAM,CAAC,IAAI,KAAK,CAAC,MAAM,EAAE,CAAC;gBAC7B,IAAI,CAAC,CAAC,IAAI,KAAK,OAAO;oBAAE,OAAO,CAAC,GAAG,CAAC,2BAA2B,CAAC,CAAC,KAAK,CAAC,IAAI,CAAC,IAAI,CAAC,EAAE,CAAC,CAAC;gBACrF,IAAI,CAAC,CAAC,IAAI,KAAK,iBAAiB;oBAAE,OAAO,CAAC,GAAG,CAAC,KAAK,CAAC,CAAC,OAAO,uBAAuB,CAAC,CAAC,OAAO,EAAE,CAAC,CAAC;YAClG,CAAC;YACD,OAAO,CAAC,GAAG,CAAC,EAAE,CAAC,CAAC;QAClB,CAAC;QAED,IAAI,KAAK,GAAG,KAAK,CAAC,IAAI,CAAC;QAEvB,IAAI,CAAC,IAAI,CAAC,cAAc,EAAE,CAAC;YACzB,KAAK,GAAG,KAAK,CAAC,MAAM,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,KAAK,CAAC,KAAK,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,OAAO,CAAC,CAAC,CAAC;QAC5D,CAAC;QAED,IAAI,IAAI,CAAC,IAAI,EAAE,CAAC;YACd,MAAM,GAAG,GAAG,IAAI,GAAG,CAAC,MAAM,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC,KAAK,CAAC,GAAG,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,IAAI,EAAE,CAAC,CAAC,MAAM,CAAC,OAAO,CAAC,CAAC,CAAC;YACrF,KAAK,GAAG,KAAK,CAAC,MAAM,CAAC,CAAC,CAAC,EAAE,CAAC,GAAG,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,CAAC;QACxC,CAAC;QAED,MAAM,YAAY,GAAG,KAAK;aACvB,GAAG,CAAC,CAAC,CAAC,EAAE,CAAC,KAAK,CAAC,KAAK,CAAC,GAAG,CAAC,CAAC,CAAE,CAAC;aAC7B,MAAM,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,WAAW,CAAC,CAAC;QAE9B,OAAO,CAAC,GAAG,CAAC,kBAAkB,YAAY,CAAC,MAAM,IAAI,CAAC,CAAC;QACvD,KAAK,MAAM,CAAC,IAAI,YAAY;YAAE,OAAO,CAAC,GAAG,CAAC,KAAK,CAAC,CAAC,IAAI,MAAM,CAAC,CAAC,OAAO,MAAM,CAAC,CAAC,GAAG,GAAG,CAAC,CAAC;QACpF,OAAO,CAAC,GAAG,CAAC,EAAE,CAAC,CAAC;QAEhB,KAAK,MAAM,CAAC,IAAI,YAAY,EAAE,CAAC;YAC7B,OAAO,CAAC,GAAG,CAAC,qBAAqB,CAAC,CAAC,IAAI,KAAK,CAAC,CAAC,GAAG,OAAO,CAAC,CAAC;YAC1D,MAAM,kBAAkB,CAAC,CAAC,CAAC,GAAG,EAAE;gBAC9B,OAAO,EAAE,IAAI,CAAC,OAAO;gBACrB,YAAY,EAAE,OAAO,CAAC,IAAI,CAAC,YAAY,CAAC;gBACxC,IAAI,EAAE,OAAO,CAAC,IAAI,CAAC,IAAI,CAAC;gBACxB,MAAM,EAAE,IAAI,CAAC,MAAM;gBACnB,MAAM,EAAE,IAAI,CAAC,MAAM;gBACnB,WAAW,EAAE,OAAO,CAAC,IAAI,CAAC,WAAW,CAAC;gBACtC,cAAc,EAAE,OAAO,CAAC,IAAI,CAAC,aAAa,CAAC;gBAC3C,WAAW,EAAE,IAAI,CAAC,WAAW;gBAC7B,SAAS,EAAE,IAAI,CAAC,SAAS;gBACzB,IAAI,EAAE,IAAI,CAAC,IAAI;gBACf,MAAM,EAAE,IAAI,CAAC,MAAM;gBACnB,GAAG,EAAE,MAAM,CAAC,IAAI,CAAC,GAAG,IAAI,EAAE,CAAC;gBAC3B,MAAM,EAAE,OAAO,CAAC,IAAI,CAAC,MAAM,CAAC;aAC7B,CAAC,CAAC;QACL,CAAC;QAED,OAAO,CAAC,GAAG,CAAC,+BAA+B,CAAC,CAAC;IAC/C,CAAC,CAAC,CAAC;AACP,CAAC"}

package/dist/commands/reportStation.js

@@ -0,0 +1,70 @@
+import { Command } from "commander";
+import path from "node:path";
+import { resolveStationRoot } from "../utils/path.js";
+import { discoverStationInventory } from "../station/discover.js";
+import { buildStationGraph } from "../station/graph.js";
+import { writeText } from "../utils/fs.js";
+export function reportStationCommand() {
+    return new Command("reportStation")
+        .description("Generate a Markdown report of station packages, relationships, and publish order.")
+        .option("--path <folder>", "Explicit station root folder (overrides prometheus mode)")
+        .option("--prometheus", "Use prometheus mode")
+        .option("--pro", "Alias of --prometheus")
+        .option("--prometheus-name <folder>", "Prometheus folder name", "prometheus")
+        .option("--max-up <n>", "Max parent hops", (v) => Number(v), 120)
+        .option("--out <file>", "Write report to file (otherwise prints to stdout)", "")
+        .action(async (opts) => {
+        const stationRoot = resolveStationRoot({
+            path: opts.path,
+            prometheus: opts.prometheus,
+            pro: opts.pro,
+            prometheusName: opts.prometheusName,
+            maxUp: opts.maxUp
+        });
+        const inv = await discoverStationInventory(stationRoot);
+        const graph = buildStationGraph(inv);
+        const lines = [];
+        lines.push(`# Station Report`);
+        lines.push(`- Station root: \`${stationRoot}\``);
+        lines.push(`- Packages discovered: **${inv.packages.length}**`);
+        lines.push("");
+        if (graph.issues.length) {
+            lines.push(`## Issues`);
+            for (const i of graph.issues) {
+                if (i.type === "cycle")
+                    lines.push(`- ⚠️ Cycle detected among: ${i.cycle.join(", ")}`);
+                if (i.type === "missingLocalDep")
+                    lines.push(`- ⚠️ ${i.package} missing local dep: ${i.missing}`);
+            }
+            lines.push("");
+        }
+        lines.push(`## Publish order (deps first)`);
+        for (const name of graph.topo) {
+            const p = graph.nodes.get(name);
+            lines.push(`- ${p.private ? "🔒" : "📦"} \`${p.name}\` @ \`${p.version}\`${p.publishable ? "" : " (not publishable?)"} — \`${p.cwd}\``);
+        }
+        lines.push("");
+        lines.push(`## Packages`);
+        lines.push(`| Package | Version | Private | Publishable | Repo | Path | Local deps |`);
+        lines.push(`|---|---:|:---:|:---:|---|---|---|`);
+        for (const p of inv.packages) {
+            const localDeps = [...(graph.edges.get(p.name) ?? [])].sort().join(", ");
+            lines.push(`| \`${p.name}\` | \`${p.version}\` | ${p.private ? "yes" : "no"} | ${p.publishable ? "yes" : "no"} | \`${p.repoRoot}\` | \`${p.cwd}\` | ${localDeps ? localDeps : ""} |`);
+        }
+        lines.push("");
+        lines.push(`## Notes`);
+        lines.push(`- Local deps are inferred from dependencies/devDependencies/peerDependencies/optionalDependencies that match other discovered package names.`);
+        lines.push(`- Publish order is a topological sort (dependencies first). Cycles are reported and then appended in stable order.`);
+        lines.push("");
+        const out = lines.join("\n");
+        if (opts.out) {
+            const outPath = path.resolve(opts.out);
+            writeText(outPath, out);
+            console.log(`Wrote report: ${outPath}`);
+        }
+        else {
+            console.log(out);
+        }
+    });
+}
+//# sourceMappingURL=reportStation.js.map

package/dist/commands/reportStation.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"reportStation.js","sourceRoot":"","sources":["../../src/commands/reportStation.ts"],"names":[],"mappings":"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"}

package/dist/commands/runOnce.js

@@ -0,0 +1,72 @@
+import { Command } from "commander";
+import path from "node:path";
+import { resolveStationRoot } from "../utils/path.js";
+import { discoverStationInventory } from "../station/discover.js";
+import { ensureRenovateConfig, ensureNcuScript } from "../utils/git.js";
+export function runOnceCommand() {
+    const cmd = new Command("runOnce")
+        .description("Station-wide one-time setup: ensure renovate.json, optional deps:latest, optional commit+push.")
+        .option("--path <folder>", "Explicit station root folder (overrides prometheus mode)")
+        .option("--prometheus", "Use prometheus mode (walk up to folder named prometheus)")
+        .option("--pro", "Alias of --prometheus")
+        .option("--prometheus-name <folder>", "Prometheus folder name", "prometheus")
+        .option("--max-up <n>", "Max parent hops", (v) => Number(v), 120)
+        .option("--add-ncu", "Add deps:latest script (ncu)")
+        .option("--commit", "Commit changes (per repo) if any")
+        .option("--push", "Push changes (per repo) if any", true)
+        .option("--message <msg>", "Commit message", "chore: add/update renovate config")
+        .option("--dry-run", "No writes", false)
+        .action(async (opts) => {
+        const stationRoot = resolveStationRoot({
+            path: opts.path,
+            prometheus: opts.prometheus,
+            pro: opts.pro,
+            prometheusName: opts.prometheusName,
+            maxUp: opts.maxUp
+        });
+        console.log(`Station root: ${stationRoot}`);
+        const inv = await discoverStationInventory(stationRoot);
+        // group by repoRoot
+        const repos = new Map(); // repoRoot -> packageJsonPaths under it
+        for (const p of inv.packages) {
+            const list = repos.get(p.repoRoot) ?? [];
+            list.push(p.packageJsonPath);
+            repos.set(p.repoRoot, list);
+        }
+        console.log(`Found ${repos.size} repo(s), ${inv.packages.length} package(s).`);
+        let ok = 0, fail = 0;
+        for (const [repoRoot, pkgJsonPaths] of repos) {
+            try {
+                if (opts.dryRun) {
+                    console.log(`DRY  ${repoRoot} -> would update renovate.json${opts.addNcu ? " + deps:latest" : ""}`);
+                    ok++;
+                    continue;
+                }
+                const changedRenovate = await ensureRenovateConfig(repoRoot);
+                let changedNcu = false;
+                if (opts.addNcu) {
+                    // apply deps:latest to all package.json that are in this repoRoot (root + workspaces)
+                    for (const pkgJsonPath of pkgJsonPaths) {
+                        changedNcu = (await ensureNcuScript(path.dirname(pkgJsonPath))) || changedNcu;
+                    }
+                }
+                const changed = changedRenovate || changedNcu;
+                if (changed && opts.commit) {
+                    await (await import("../utils/git.js")).gitAddCommitPush(repoRoot, {
+                        message: opts.message,
+                        push: Boolean(opts.push)
+                    });
+                }
+                console.log(`OK   ${repoRoot}${changed ? " (changed)" : " (no-op)"}`);
+                ok++;
+            }
+            catch (e) {
+                console.log(`FAIL ${repoRoot} - ${e?.message ?? String(e)}`);
+                fail++;
+            }
+        }
+        console.log(`\nSummary: OK=${ok}, FAIL=${fail}`);
+    });
+    return cmd;
+}
+//# sourceMappingURL=runOnce.js.map

package/dist/commands/runOnce.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"runOnce.js","sourceRoot":"","sources":["../../src/commands/runOnce.ts"],"names":[],"mappings":"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"}

package/dist/index.js

@@ -0,0 +1,19 @@
+#!/usr/bin/env node
+import { Command } from "commander";
+import { runOnceCommand } from "./commands/runOnce.js";
+import { gitSyncCommand } from "./commands/gitSync.js";
+import { publishOneCommand } from "./commands/publishOne.js";
+import { publishStationCommand } from "./commands/publishStation.js";
+import { reportStationCommand } from "./commands/reportStation.js";
+const program = new Command();
+program
+    .name("nx-npm-tools")
+    .description("Renovate setup + station scan + dependency graph + ordered npm publishing.")
+    .version("0.2.0");
+program.addCommand(runOnceCommand());
+program.addCommand(gitSyncCommand());
+program.addCommand(publishOneCommand());
+program.addCommand(publishStationCommand());
+program.addCommand(reportStationCommand());
+program.parse(process.argv);
+//# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":";AACA,OAAO,EAAE,OAAO,EAAE,MAAM,WAAW,CAAC;AACpC,OAAO,EAAE,cAAc,EAAE,MAAM,uBAAuB,CAAC;AACvD,OAAO,EAAE,cAAc,EAAE,MAAM,uBAAuB,CAAC;AACvD,OAAO,EAAE,iBAAiB,EAAE,MAAM,0BAA0B,CAAC;AAC7D,OAAO,EAAE,qBAAqB,EAAE,MAAM,8BAA8B,CAAC;AACrE,OAAO,EAAE,oBAAoB,EAAE,MAAM,6BAA6B,CAAC;AAEnE,MAAM,OAAO,GAAG,IAAI,OAAO,EAAE,CAAC;AAE9B,OAAO;KACJ,IAAI,CAAC,cAAc,CAAC;KACpB,WAAW,CAAC,4EAA4E,CAAC;KACzF,OAAO,CAAC,OAAO,CAAC,CAAC;AAEpB,OAAO,CAAC,UAAU,CAAC,cAAc,EAAE,CAAC,CAAC;AACrC,OAAO,CAAC,UAAU,CAAC,cAAc,EAAE,CAAC,CAAC;AACrC,OAAO,CAAC,UAAU,CAAC,iBAAiB,EAAE,CAAC,CAAC;AACxC,OAAO,CAAC,UAAU,CAAC,qBAAqB,EAAE,CAAC,CAAC;AAC5C,OAAO,CAAC,UAAU,CAAC,oBAAoB,EAAE,CAAC,CAAC;AAE3C,OAAO,CAAC,KAAK,CAAC,OAAO,CAAC,IAAI,CAAC,CAAC"}

package/dist/station/discover.js

@@ -0,0 +1,128 @@
+import fg from "fast-glob";
+import path from "node:path";
+import { exists, isDir, readJson } from "../utils/fs.js";
+const IGNORE = [
+    "**/node_modules/**",
+    "**/.git/**",
+    "**/.pnpm-store/**",
+    "**/.yarn/**",
+    "**/.nx/**",
+    "**/dist/**",
+    "**/build/**",
+    "**/out/**",
+    "**/.next/**",
+    "**/coverage/**",
+    "**/.cache/**"
+];
+function normalizeWorkspaces(ws) {
+    if (!ws)
+        return [];
+    if (Array.isArray(ws))
+        return ws;
+    if (typeof ws === "object" && Array.isArray(ws.packages))
+        return ws.packages;
+    return [];
+}
+function isLikelyPublishable(pkg, cwd) {
+    // Heuristic: publishable if not private, has name+version, and has build script OR dist folder commonly used
+    if (!pkg.name || !pkg.version)
+        return false;
+    if (pkg.private === true)
+        return false;
+    if (pkg.scripts?.build)
+        return true;
+    if (exists(path.join(cwd, "dist")))
+        return true;
+    return true; // default permissive
+}
+function depsBlock(p) {
+    return {
+        dependencies: p.dependencies ?? {},
+        devDependencies: p.devDependencies ?? {},
+        peerDependencies: p.peerDependencies ?? {},
+        optionalDependencies: p.optionalDependencies ?? {}
+    };
+}
+async function findGitRepoRoots(stationRoot) {
+    const gitDirs = await fg(["**/.git"], {
+        cwd: stationRoot,
+        onlyDirectories: true,
+        ignore: IGNORE,
+        followSymbolicLinks: false
+    });
+    const repoRoots = gitDirs
+        .map(g => path.resolve(stationRoot, path.dirname(g)))
+        .filter(r => isDir(r));
+    return [...new Set(repoRoots)].sort();
+}
+async function discoverWorkspacePackages(repoRoot) {
+    const rootPkgPath = path.join(repoRoot, "package.json");
+    if (!exists(rootPkgPath))
+        return [];
+    const rootPkg = readJson(rootPkgPath);
+    const patterns = normalizeWorkspaces(rootPkg.workspaces);
+    if (!patterns.length)
+        return [];
+    // Expand workspace patterns relative to repo root (e.g. "packages/*")
+    const matches = await fg(patterns.map(p => path.posix.join(p.replaceAll("\\", "/"), "package.json")), {
+        cwd: repoRoot,
+        onlyFiles: true,
+        ignore: IGNORE,
+        followSymbolicLinks: false
+    });
+    return matches.map(m => path.join(repoRoot, m));
+}
+export async function discoverStationInventory(stationRoot) {
+    const repoRoots = await findGitRepoRoots(stationRoot);
+    const packageJsonPaths = [];
+    for (const repoRoot of repoRoots) {
+        const rootPkg = path.join(repoRoot, "package.json");
+        if (exists(rootPkg))
+            packageJsonPaths.push(rootPkg);
+        const wsPkgs = await discoverWorkspacePackages(repoRoot);
+        for (const p of wsPkgs)
+            packageJsonPaths.push(p);
+    }
+    const uniqPkgJsonPaths = [...new Set(packageJsonPaths)];
+    const packages = [];
+    for (const pkgPath of uniqPkgJsonPaths) {
+        const cwd = path.dirname(pkgPath);
+        const pkg = readJson(pkgPath);
+        if (!pkg.name || !pkg.version)
+            continue;
+        // repoRoot = nearest ancestor containing .git (we already enumerated repo roots, so match by prefix)
+        const repoRoot = repoRoots.find(r => cwd === r || cwd.startsWith(r + path.sep));
+        if (!repoRoot)
+            continue;
+        packages.push({
+            name: pkg.name,
+            version: pkg.version,
+            private: pkg.private ?? false,
+            cwd,
+            repoRoot,
+            packageJsonPath: pkgPath,
+            scripts: pkg.scripts ?? {},
+            deps: depsBlock(pkg),
+            publishable: isLikelyPublishable(pkg, cwd)
+        });
+    }
+    // De-dupe by name: prefer deeper package (workspace) over repo root if name collides (rare)
+    const byName = new Map();
+    for (const p of packages) {
+        const prev = byName.get(p.name);
+        if (!prev)
+            byName.set(p.name, p);
+        else {
+            // prefer the one that is not private, else prefer the one with build script
+            if (prev.private && !p.private)
+                byName.set(p.name, p);
+            else if (!prev.scripts.build && p.scripts.build)
+                byName.set(p.name, p);
+        }
+    }
+    return {
+        stationRoot,
+        packages: [...byName.values()].sort((a, b) => a.name.localeCompare(b.name))
+    };
+}
+//# sourceMappingURL=discover.js.map

package/dist/station/discover.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"discover.js","sourceRoot":"","sources":["../../src/station/discover.ts"],"names":[],"mappings":"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"}

package/dist/station/graph.js

@@ -0,0 +1,67 @@
+function collectAllDeps(p) {
+    return {
+        ...p.deps.dependencies,
+        ...p.deps.devDependencies,
+        ...p.deps.peerDependencies,
+        ...p.deps.optionalDependencies
+    };
+}
+export function buildStationGraph(inv) {
+    const nodes = new Map();
+    for (const p of inv.packages)
+        nodes.set(p.name, p);
+    const edges = new Map();
+    const issues = [];
+    for (const p of inv.packages) {
+        const deps = collectAllDeps(p);
+        const local = new Set();
+        for (const depName of Object.keys(deps)) {
+            if (nodes.has(depName))
+                local.add(depName);
+        }
+        edges.set(p.name, local);
+        // (optional) if you want to warn about @scope/* deps not found locally:
+        // for (const depName of Object.keys(deps)) {
+        //   if (depName.startsWith("@athenices/") && !nodes.has(depName)) {
+        //     issues.push({ type: "missingLocalDep", package: p.name, missing: depName });
+        //   }
+        // }
+    }
+    // Toposort (Kahn)
+    const indeg = new Map();
+    for (const name of nodes.keys())
+        indeg.set(name, 0);
+    for (const [from, tos] of edges) {
+        for (const to of tos)
+            indeg.set(to, (indeg.get(to) ?? 0) + 1);
+    }
+    const q = [];
+    for (const [n, d] of indeg)
+        if (d === 0)
+            q.push(n);
+    const topo = [];
+    while (q.length) {
+        const n = q.shift();
+        topo.push(n);
+        for (const dep of edges.get(n) ?? []) {
+            const nd = (indeg.get(dep) ?? 0) - 1;
+            indeg.set(dep, nd);
+            if (nd === 0)
+                q.push(dep);
+        }
+    }
+    if (topo.length !== nodes.size) {
+        // cycle exists; find a rough cycle by listing remaining nodes
+        const remaining = [...nodes.keys()].filter(n => !topo.includes(n));
+        issues.push({ type: "cycle", cycle: remaining });
+        // fallback: append remaining in stable order
+        remaining.sort();
+        topo.push(...remaining);
+    }
+    // We want publish order: dependencies first.
+    // Current topo puts zero-indeg first (packages that nothing depends on), which is reverse for publishing.
+    // So reverse it.
+    topo.reverse();
+    return { nodes, edges, topo, issues };
+}
+//# sourceMappingURL=graph.js.map

package/dist/station/graph.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"graph.js","sourceRoot":"","sources":["../../src/station/graph.ts"],"names":[],"mappings":"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"}

package/dist/station/types.js

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=types.js.map

package/dist/station/types.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.js","sourceRoot":"","sources":["../../src/station/types.ts"],"names":[],"mappings":""}

package/dist/utils/exec.js

@@ -0,0 +1,9 @@
+import { execa } from "execa";
+export async function run(cmd, args, cwd, inherit = true) {
+    return execa(cmd, args, { cwd, stdio: inherit ? "inherit" : "pipe" });
+}
+export async function runCapture(cmd, args, cwd) {
+    const r = await execa(cmd, args, { cwd, stdio: "pipe" });
+    return (r.stdout ?? "").toString();
+}
+//# sourceMappingURL=exec.js.map

package/dist/utils/exec.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"exec.js","sourceRoot":"","sources":["../../src/utils/exec.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,KAAK,EAAE,MAAM,OAAO,CAAC;AAE9B,MAAM,CAAC,KAAK,UAAU,GAAG,CAAC,GAAW,EAAE,IAAc,EAAE,GAAW,EAAE,OAAO,GAAG,IAAI;IAChF,OAAO,KAAK,CAAC,GAAG,EAAE,IAAI,EAAE,EAAE,GAAG,EAAE,KAAK,EAAE,OAAO,CAAC,CAAC,CAAC,SAAS,CAAC,CAAC,CAAC,MAAM,EAAE,CAAC,CAAC;AACxE,CAAC;AAED,MAAM,CAAC,KAAK,UAAU,UAAU,CAAC,GAAW,EAAE,IAAc,EAAE,GAAW;IACvE,MAAM,CAAC,GAAG,MAAM,KAAK,CAAC,GAAG,EAAE,IAAI,EAAE,EAAE,GAAG,EAAE,KAAK,EAAE,MAAM,EAAE,CAAC,CAAC;IACzD,OAAO,CAAC,CAAC,CAAC,MAAM,IAAI,EAAE,CAAC,CAAC,QAAQ,EAAE,CAAC;AACrC,CAAC"}

package/dist/utils/fs.js

@@ -0,0 +1,40 @@
+import fs from "node:fs";
+import path from "node:path";
+export function readJson(filePath) {
+    const raw = fs.readFileSync(filePath, "utf8");
+    return JSON.parse(raw);
+}
+export function writeJson(filePath, obj) {
+    const out = JSON.stringify(obj, null, 2) + "\n";
+    fs.writeFileSync(filePath, out, "utf8");
+}
+export function exists(p) {
+    try {
+        fs.accessSync(p);
+        return true;
+    }
+    catch {
+        return false;
+    }
+}
+export function readText(p) {
+    return fs.readFileSync(p, "utf8");
+}
+export function writeText(p, s) {
+    fs.writeFileSync(p, s, "utf8");
+}
+export function isDir(p) {
+    try {
+        return fs.statSync(p).isDirectory();
+    }
+    catch {
+        return false;
+    }
+}
+export function ensureDir(p) {
+    fs.mkdirSync(p, { recursive: true });
+}
+export function join(...parts) {
+    return path.join(...parts);
+}
+//# sourceMappingURL=fs.js.map

package/dist/utils/fs.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"fs.js","sourceRoot":"","sources":["../../src/utils/fs.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,MAAM,SAAS,CAAC;AACzB,OAAO,IAAI,MAAM,WAAW,CAAC;AAE7B,MAAM,UAAU,QAAQ,CAAI,QAAgB;IAC1C,MAAM,GAAG,GAAG,EAAE,CAAC,YAAY,CAAC,QAAQ,EAAE,MAAM,CAAC,CAAC;IAC9C,OAAO,IAAI,CAAC,KAAK,CAAC,GAAG,CAAM,CAAC;AAC9B,CAAC;AAED,MAAM,UAAU,SAAS,CAAC,QAAgB,EAAE,GAAY;IACtD,MAAM,GAAG,GAAG,IAAI,CAAC,SAAS,CAAC,GAAG,EAAE,IAAI,EAAE,CAAC,CAAC,GAAG,IAAI,CAAC;IAChD,EAAE,CAAC,aAAa,CAAC,QAAQ,EAAE,GAAG,EAAE,MAAM,CAAC,CAAC;AAC1C,CAAC;AAED,MAAM,UAAU,MAAM,CAAC,CAAS;IAC9B,IAAI,CAAC;QACH,EAAE,CAAC,UAAU,CAAC,CAAC,CAAC,CAAC;QACjB,OAAO,IAAI,CAAC;IACd,CAAC;IAAC,MAAM,CAAC;QACP,OAAO,KAAK,CAAC;IACf,CAAC;AACH,CAAC;AAED,MAAM,UAAU,QAAQ,CAAC,CAAS;IAChC,OAAO,EAAE,CAAC,YAAY,CAAC,CAAC,EAAE,MAAM,CAAC,CAAC;AACpC,CAAC;AAED,MAAM,UAAU,SAAS,CAAC,CAAS,EAAE,CAAS;IAC5C,EAAE,CAAC,aAAa,CAAC,CAAC,EAAE,CAAC,EAAE,MAAM,CAAC,CAAC;AACjC,CAAC;AAED,MAAM,UAAU,KAAK,CAAC,CAAS;IAC7B,IAAI,CAAC;QAAC,OAAO,EAAE,CAAC,QAAQ,CAAC,CAAC,CAAC,CAAC,WAAW,EAAE,CAAC;IAAC,CAAC;IAAC,MAAM,CAAC;QAAC,OAAO,KAAK,CAAC;IAAC,CAAC;AACtE,CAAC;AAED,MAAM,UAAU,SAAS,CAAC,CAAS;IACjC,EAAE,CAAC,SAAS,CAAC,CAAC,EAAE,EAAE,SAAS,EAAE,IAAI,EAAE,CAAC,CAAC;AACvC,CAAC;AAED,MAAM,UAAU,IAAI,CAAC,GAAG,KAAe;IACrC,OAAO,IAAI,CAAC,IAAI,CAAC,GAAG,KAAK,CAAC,CAAC;AAC7B,CAAC"}

package/dist/utils/git.js

@@ -0,0 +1,132 @@
+import path from "node:path";
+import fs from "node:fs";
+import { run } from "./exec.js";
+import { exists, readJson, writeJson, readText, writeText } from "./fs.js";
+export async function gitAddCommitPush(cwd, opts) {
+    const remote = opts.remote ?? "origin";
+    await run("git", ["add", "."], cwd, true);
+    // commit may fail if nothing to commit; ignore
+    try {
+        await run("git", ["commit", "-m", opts.message], cwd, true);
+    }
+    catch {
+        // ignore
+    }
+    if (!opts.push)
+        return;
+    const args = ["push", remote];
+    if (opts.branch)
+        args.push(opts.branch);
+    if (opts.setUpstream && opts.branch)
+        args.push("--set-upstream");
+    if (opts.forceWithLease)
+        args.push("--force-with-lease");
+    await run("git", args, cwd, true);
+}
+export async function ensureRenovateConfig(repoRoot) {
+    const renovatePath = path.join(repoRoot, "renovate.json");
+    const existed = exists(renovatePath);
+    let cfg = {};
+    if (existed) {
+        cfg = readJson(renovatePath);
+    }
+    let ext = cfg.extends;
+    if (!ext)
+        ext = [];
+    if (typeof ext === "string")
+        ext = [ext];
+    if (!Array.isArray(ext))
+        ext = [];
+    if (!ext.includes("config:base"))
+        ext.unshift("config:base");
+    cfg.extends = ext;
+    cfg.dependencyDashboard = true;
+    if (cfg.packageRules == null) {
+        cfg.packageRules = [
+            { matchUpdateTypes: ["minor", "patch", "pin", "digest"], groupName: "all non-major dependencies" }
+        ];
+    }
+    const next = JSON.stringify(cfg, null, 2) + "\n";
+    const prev = existed ? readText(renovatePath) : "";
+    const changed = prev !== next;
+    if (changed)
+        writeText(renovatePath, next);
+    return changed;
+}
+export async function ensureNcuScript(pkgDir) {
+    const pkgPath = path.join(pkgDir, "package.json");
+    if (!exists(pkgPath))
+        return false;
+    const pkg = readJson(pkgPath);
+    pkg.scripts ||= {};
+    const before = pkg.scripts["deps:latest"];
+    pkg.scripts["deps:latest"] = "npx npm-check-updates -u && npm install";
+    const changed = before !== pkg.scripts["deps:latest"];
+    if (changed)
+        writeJson(pkgPath, pkg);
+    return changed;
+}
+async function forceCleanInstall(cwd) {
+    // Cross-platform remove node_modules + package-lock.json
+    const nm = path.join(cwd, "node_modules");
+    const lock = path.join(cwd, "package-lock.json");
+    try {
+        fs.rmSync(nm, { recursive: true, force: true });
+    }
+    catch { }
+    try {
+        fs.rmSync(lock, { force: true });
+    }
+    catch { }
+    await run("npm", ["cache", "clean", "--force"], cwd, true);
+    await run("npm", ["install"], cwd, true);
+}
+function mustExist(filePath, hint) {
+    if (!exists(filePath))
+        throw new Error(`${hint}\nMissing: ${filePath}`);
+}
+export async function publishPackageFlow(cwd, opts) {
+    if (opts.dryRun) {
+        console.log(`[dry-run] would publish from: ${cwd}`);
+        return;
+    }
+    // install
+    if (opts.forceInstall)
+        await forceCleanInstall(cwd);
+    else
+        await run("npm", ["install"], cwd, true);
+    // git sync
+    await gitAddCommitPush(cwd, {
+        message: opts.message,
+        push: opts.push,
+        remote: opts.remote,
+        branch: opts.branch,
+        setUpstream: opts.setUpstream,
+        forceWithLease: opts.forceWithLease
+    });
+    // build
+    await run("npm", ["run", opts.buildScript], cwd, true);
+    // verify dist output exists
+    const distFile = path.resolve(cwd, opts.distCheck);
+    mustExist(distFile, "Build output check failed.");
+    // bump version (optional)
+    if (opts.bump !== "none") {
+        await run("npm", ["version", String(opts.bump)], cwd, true);
+    }
+    // publish
+    const publishArgs = ["publish"];
+    // access flag
+    if (opts.access)
+        publishArgs.push("--access", String(opts.access));
+    // tag flag
+    if (opts.tag && opts.tag.trim())
+        publishArgs.push("--tag", opts.tag.trim());
+    await run("npm", publishArgs, cwd, true);
+    // Show current package + version (best effort)
+    try {
+        const pkg = readJson(path.join(cwd, "package.json"));
+        console.log(`✅ Published: ${pkg.name} @ ${pkg.version}`);
+    }
+    catch { }
+}
+//# sourceMappingURL=git.js.map

package/dist/utils/git.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"git.js","sourceRoot":"","sources":["../../src/utils/git.ts"],"names":[],"mappings":"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"}

package/dist/utils/path.js

@@ -0,0 +1,11 @@
+import path from "node:path";
+import { findAncestorFolderByName } from "./prometheus.js";
+export function resolveStationRoot(opts) {
+    if (opts.path)
+        return path.resolve(opts.path);
+    // Default to prometheus mode
+    const folderName = opts.prometheusName ?? "prometheus";
+    const maxUp = opts.maxUp ?? 120;
+    return findAncestorFolderByName(process.cwd(), folderName, maxUp);
+}
+//# sourceMappingURL=path.js.map

package/dist/utils/path.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"path.js","sourceRoot":"","sources":["../../src/utils/path.ts"],"names":[],"mappings":"AAAA,OAAO,IAAI,MAAM,WAAW,CAAC;AAC7B,OAAO,EAAE,wBAAwB,EAAE,MAAM,iBAAiB,CAAC;AAU3D,MAAM,UAAU,kBAAkB,CAAC,IAAwB;IACzD,IAAI,IAAI,CAAC,IAAI;QAAE,OAAO,IAAI,CAAC,OAAO,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;IAE9C,6BAA6B;IAC7B,MAAM,UAAU,GAAG,IAAI,CAAC,cAAc,IAAI,YAAY,CAAC;IACvD,MAAM,KAAK,GAAG,IAAI,CAAC,KAAK,IAAI,GAAG,CAAC;IAEhC,OAAO,wBAAwB,CAAC,OAAO,CAAC,GAAG,EAAE,EAAE,UAAU,EAAE,KAAK,CAAC,CAAC;AACpE,CAAC"}

package/dist/utils/prometheus.js

@@ -0,0 +1,14 @@
+import path from "node:path";
+export function findAncestorFolderByName(startDir, folderName = "prometheus", maxUp = 120) {
+    let cur = path.resolve(startDir);
+    for (let i = 0; i <= maxUp; i++) {
+        if (path.basename(cur) === folderName)
+            return cur;
+        const parent = path.dirname(cur);
+        if (parent === cur)
+            break;
+        cur = parent;
+    }
+    throw new Error(`Prometheus mode: couldn't find ancestor folder named "${folderName}" starting from: ${startDir}`);
+}
+//# sourceMappingURL=prometheus.js.map

package/dist/utils/prometheus.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"prometheus.js","sourceRoot":"","sources":["../../src/utils/prometheus.ts"],"names":[],"mappings":"AAAA,OAAO,IAAI,MAAM,WAAW,CAAC;AAE7B,MAAM,UAAU,wBAAwB,CACtC,QAAgB,EAChB,UAAU,GAAG,YAAY,EACzB,KAAK,GAAG,GAAG;IAEX,IAAI,GAAG,GAAG,IAAI,CAAC,OAAO,CAAC,QAAQ,CAAC,CAAC;IAEjC,KAAK,IAAI,CAAC,GAAG,CAAC,EAAE,CAAC,IAAI,KAAK,EAAE,CAAC,EAAE,EAAE,CAAC;QAChC,IAAI,IAAI,CAAC,QAAQ,CAAC,GAAG,CAAC,KAAK,UAAU;YAAE,OAAO,GAAG,CAAC;QAElD,MAAM,MAAM,GAAG,IAAI,CAAC,OAAO,CAAC,GAAG,CAAC,CAAC;QACjC,IAAI,MAAM,KAAK,GAAG;YAAE,MAAM;QAC1B,GAAG,GAAG,MAAM,CAAC;IACf,CAAC;IAED,MAAM,IAAI,KAAK,CACb,yDAAyD,UAAU,oBAAoB,QAAQ,EAAE,CAClG,CAAC;AACJ,CAAC"}

package/package.json

@@ -0,0 +1,26 @@
+{
+  "name": "nx-npm-tools",
+  "version": "0.2.0",
+  "description": "CLI helpers for Renovate setup, station scanning, dependency graph, git sync, and ordered npm publishing.",
+  "license": "MIT",
+  "type": "module",
+  "bin": {
+    "nx-npm-tools": "dist/index.js"
+  },
+  "files": [
+    "dist"
+  ],
+  "scripts": {
+    "build": "tsc -p tsconfig.json",
+    "prepublishOnly": "npm run build"
+  },
+  "dependencies": {
+    "commander": "^12.1.0",
+    "execa": "^9.5.0",
+    "fast-glob": "^3.3.2"
+  },
+  "devDependencies": {
+    "@types/node": "^25.0.3",
+    "typescript": "^5.5.4"
+  }
+}