TypeScript Rewrite: App bootstrap, config, and shared utilities

.github/workflows/lint.yml

@@ -6,6 +6,18 @@ jobs:
     steps:
       - uses: actions/checkout@v6
       - uses: oven-sh/setup-bun@v2
+      - name: Get bun cache directory
+        id: bun-cache
+        shell: bash
+        run: |
+          echo "dir=$(bun pm cache)" >> $GITHUB_OUTPUT
+      - name: Cache bun dependencies
+        uses: actions/cache@v5
+        with:
+          path: ${{ steps.bun-cache.outputs.dir }}
+          key: ${{ runner.os }}-bun-${{ hashFiles('bun.lock') }}
+          restore-keys: |
+            ${{ runner.os }}-bun-
       - run: bun install --frozen-lockfile
       - run: bun run lint
       - name: Typecheck

.github/workflows/tests.yml

@@ -6,5 +6,18 @@ jobs:
     steps:
       - uses: actions/checkout@v6
       - uses: oven-sh/setup-bun@v2
+      - name: Get bun cache directory
+        id: bun-cache
+        shell: bash
+        run: |
+          echo "dir=$(bun pm cache)" >> $GITHUB_OUTPUT
+      - name: Cache bun dependencies
+        uses: actions/cache@v5
+        with:
+          path: ${{ steps.bun-cache.outputs.dir }}
+          key: ${{ runner.os }}-bun-${{ hashFiles('bun.lock') }}
+          restore-keys: |
+            ${{ runner.os }}-bun-
       - run: bun install --frozen-lockfile
+      - run: bun run build
       - run: bun run test

package.json

@@ -38,7 +38,8 @@
     "execa": "^8.0.1",
     "fs-extra": "^11.2.0",
     "picomatch": "^4.0.0",
-    "simple-git": "^3.22.0"
+    "simple-git": "^3.22.0",
+    "zod": "^4.3.6"
   },
   "devDependencies": {
     "@jest/types": "^30.2.0",

src/app.ts

@@ -0,0 +1,28 @@
+import { Command } from 'commander';
+import { Config, getConfig, resetConfig } from './config.ts';
+import { version } from '../package.json';
+
+export const PUP_VERSION = version;
+
+/**
+ * Creates and configures the Commander program instance.
+ *
+ * @since TBD
+ *
+ * @returns {Command} The configured Commander program.
+ */
+export function createApp(): Command {
+  resetConfig();
+
+  getConfig();
+
+  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.ts';
+
+const program = createApp();
+
+program.parseAsync(process.argv).catch((err) => {
+  console.error(err instanceof Error ? err.message : String(err));
+  process.exit(1);
+});