Use options for link-readme CLI command (#102)

Author: JakeSCahill

bin/doc-tools.js

@@ -309,25 +309,27 @@ automation
     process.exit(0);
   });
 
-programCli
-  .command('link-readme <subdir> <targetFilename>')
+  programCli
+  .command('link-readme')
   .description('Symlink a README.adoc into docs/modules/<module>/pages/')
-  .action((subdir, targetFilename) => {
+  .requiredOption('-s, --subdir <subdir>', 'Relative path to the lab project subdirectory')
+  .requiredOption('-t, --target <filename>', 'Name of the target AsciiDoc file in pages/')
+  .action((options) => {
     const repoRoot = findRepoRoot();
-    const normalized = subdir.replace(/\/+$/, '');
+    const normalized = options.subdir.replace(/\/+$/, '');
     const moduleName = normalized.split('/')[0];
 
     const projectDir = path.join(repoRoot, normalized);
     const pagesDir   = path.join(repoRoot, 'docs', 'modules', moduleName, 'pages');
-    const sourceFile = path.join(repoRoot, normalized, 'README.adoc');
-    const destLink   = path.join(pagesDir, targetFilename);
+    const sourceFile = path.join(projectDir, 'README.adoc');
+    const destLink   = path.join(pagesDir, options.target);
 
     if (!fs.existsSync(projectDir)) {
       console.error(`❌ Project directory not found: ${projectDir}`);
       process.exit(1);
     }
     if (!fs.existsSync(sourceFile)) {
-      console.error(`❌ README.adoc not found in ${normalized}`);
+      console.error(`❌ README.adoc not found in ${projectDir}`);
       process.exit(1);
     }
 

package-lock.json

@@ -1,6 +1,6 @@
 {
   "name": "@redpanda-data/docs-extensions-and-macros",
-  "version": "4.4.1",
+  "version": "4.4.2",
   "description": "Antora extensions and macros developed for Redpanda documentation.",
   "keywords": [
     "antora",