ci: oclif mess around

.eslintignore

@@ -1,3 +1,4 @@
 coverage/
 dist/
+dist-gha/
 exe/

.github/workflows/ci.yml

@@ -64,17 +64,10 @@ jobs:
           path: oas-examples-repo
           repository: readmeio/oas-examples
 
-      # For every GitHub Action release, we deploy our Docker images
-      # to the GitHub Container Registry for performance reasons.
-      # Instead of testing against the pre-built image, we can build
-      # an image from the currently checked-out repo contents by doing a
-      # li'l update in the action.yml file to point to the current Dockerfile.
-      - name: Replace Docker image value in action.yml
-        uses: jacobtomlinson/gha-find-replace@v3
-        with:
-          find: 'image:.*'
-          replace: "image: 'Dockerfile'"
-          include: rdme-repo/action.yml
+      # TODO: write a smol explainer comment
+      - name: Rebuild GitHub Action for testing purposes
+        run: 'npm ci && npm run build:gha'
+        working-directory: rdme-repo
 
       - name: Run `openapi:validate` command
         uses: ./rdme-repo/

.github/workflows/docs.yml

@@ -40,17 +40,9 @@ jobs:
           regex: false
           include: documentation/*
 
-      # For every GitHub Action release, we deploy our Docker images
-      # to the GitHub Container Registry for performance reasons.
-      # Instead of testing against the pre-built image, we can build
-      # an image from the currently checked-out repo contents by doing a
-      # li'l update in the action.yml file to point to the current Dockerfile.
-      - name: Replace Docker image value in action.yml
-        uses: jacobtomlinson/gha-find-replace@v3
-        with:
-          find: 'image:.*'
-          replace: "image: 'Dockerfile'"
-          include: action.yml
+      # TODO: write a smol explainer comment
+      - name: Rebuild GitHub Action for testing purposes
+        run: 'npm ci && npm run build:gha'
 
       # And finally, with our updated documentation,
       # we run the `rdme` GitHub Action to sync the Markdown file

.gitignore

@@ -6,4 +6,5 @@ node_modules/
 tmp/
 
 # required for building with TS
+dist-gha/package.json
 src/package.json

.prettierignore

@@ -2,4 +2,5 @@ __tests__/__fixtures__/invalid-json/yikes.json
 CHANGELOG.md
 coverage/
 dist/
+dist-gha/
 exe/

action.yml

@@ -12,8 +12,6 @@ outputs:
   rdme:
     description: The rdme command result output
 runs:
-  using: docker
-  image: docker://ghcr.io/readmeio/rdme:9.0.0-next.19
-  args:
-    - docker-gha
-    - ${{ inputs.rdme }}
+  using: node20
+  pre: bin/write-gha-pjson.js
+  main: dist-gha/run.cjs

bin/run.js

@@ -2,9 +2,15 @@
 // ^ we need this env variable above to hide the ExperimentalWarnings
 // source: https://github.com/nodejs/node/issues/10802#issuecomment-573376999
 
+import stringArgv from 'string-argv';
+
 async function main() {
   const { execute } = await import('@oclif/core');
-  await execute({ dir: import.meta.url }).then(msg => {
+  const opts = { dir: import.meta.url };
+  if (process.env.INPUT_RDME) {
+    opts.args = stringArgv(process.env.INPUT_RDME);
+  }
+  await execute(opts).then(msg => {
     if (msg) {
       // eslint-disable-next-line no-console
       console.log(msg);

bin/write-gha-pjson.js

@@ -0,0 +1,35 @@
+#! /usr/bin/env node
+// @ts-check
+
+import fs from 'node:fs';
+import path from 'node:path';
+
+const newTarget = './cmds.js';
+
+/**
+ * We need to duplicate the `package.json` file (with a few modifications) from the root of the project to the
+ * `dist-gha` directory, so that the GitHub Actions-flavored `oclif` configuration can find it.
+ */
+function writeGitHubActionsPackageJson() {
+  const current = JSON.parse(
+    fs.readFileSync(path.resolve(import.meta.dirname, '../package.json'), { encoding: 'utf-8' }),
+  );
+
+  current.private = true;
+
+  // set the correct targets for GitHub Actions
+  current.oclif.commands.target = newTarget;
+  Object.values(current.oclif.hooks).forEach(hook => {
+    // eslint-disable-next-line no-param-reassign
+    hook.target = newTarget;
+  });
+
+  // remove properties that are only applicable in a CLI context
+  delete current.oclif.helpClass;
+  delete current.oclif.plugins;
+
+  // write the new package.json file
+  fs.writeFileSync(path.resolve(import.meta.dirname, '../dist-gha/package.json'), JSON.stringify(current, null, 2));
+}
+
+writeGitHubActionsPackageJson();

knip.ts

@@ -1,8 +1,8 @@
 import type { KnipConfig } from 'knip';
 
 const config: KnipConfig = {
-  entry: ['src/index.ts', 'src/lib/help.ts'],
-  ignore: ['bin/*.js'],
+  entry: ['src/index.ts', 'src/lib/help.ts', 'bin/*.js'],
+  ignore: ['dist-gha/**'],
   ignoreBinaries: ['semantic-release'],
   ignoreDependencies: ['oclif'],
 };