TypeScript Rewrite: App bootstrap, config, and shared utilities

.github/workflows/lint.yml

@@ -6,6 +6,12 @@ jobs:
     steps:
       - uses: actions/checkout@v6
       - uses: oven-sh/setup-bun@v2
+      - uses: actions/cache@v4
+        with:
+          path: node_modules
+          key: ${{ runner.os }}-node-modules-${{ hashFiles('bun.lock') }}
+          restore-keys: |
+            ${{ runner.os }}-node-modules-
       - run: bun install --frozen-lockfile
       - run: bun run lint
       - name: Typecheck

.github/workflows/tests.yml

@@ -6,5 +6,12 @@ jobs:
     steps:
       - uses: actions/checkout@v6
       - uses: oven-sh/setup-bun@v2
+      - uses: actions/cache@v4
+        with:
+          path: node_modules
+          key: ${{ runner.os }}-node-modules-${{ hashFiles('bun.lock') }}
+          restore-keys: |
+            ${{ runner.os }}-node-modules-
       - run: bun install --frozen-lockfile
+      - run: bun run build
       - run: bun run test

src/app.ts

@@ -0,0 +1,62 @@
+import { Command } from 'commander';
+import { Config, getConfig, resetConfig } from './config.js';
+import * as output from './utils/output.js';
+import { fileURLToPath } from 'node:url';
+import path from 'node:path';
+import fs from 'fs-extra';
+
+const __filename = fileURLToPath(import.meta.url);
+const __dirname = path.dirname(__filename);
+
+/**
+ * Reads the pup version from the nearest package.json.
+ *
+ * @since TBD
+ *
+ * @returns {string} The version string from package.json, or '2.0.0' as a fallback.
+ */
+function getVersion(): string {
+  // Try to read from package.json
+  const candidates = [
+    path.resolve(__dirname, '..', 'package.json'),
+    path.resolve(__dirname, '..', '..', 'package.json'),
+  ];
+
+  for (const candidate of candidates) {
+    if (fs.existsSync(candidate)) {
+      const pkg = JSON.parse(fs.readFileSync(candidate, 'utf-8')) as { version: string };
+      return pkg.version;
+    }
+  }
+
+  return '2.0.0';
+}
+
+export const PUP_VERSION = getVersion();
+
+/**
+ * Creates and configures the Commander program instance.
+ *
+ * @since TBD
+ *
+ * @returns {Command} The configured Commander program.
+ */
+export function createApp(): Command {
+  resetConfig();
+
+  const config = getConfig();
+  if (config.hasInvalidPuprc()) {
+    output.error('There is a .puprc file in this directory, but it could not be parsed.');
+    output.error(`JSON Error: ${config.getPuprcParseError()}`);
+  }
+
+  const program = new Command();
+  program
+    .name('pup')
+    .version(PUP_VERSION)
+    .description("StellarWP's Project Utilities & Packager");
+
+  return program;
+}
+
+export { Config, getConfig, resetConfig };

src/cli.ts

@@ -0,0 +1,8 @@
+import { createApp } from './app.js';
+
+const program = createApp();
+
+program.parseAsync(process.argv).catch((err) => {
+  console.error(err instanceof Error ? err.message : String(err));
+  process.exit(1);
+});