doc-tools link-readme CLI command (#101)

* Add a doc-tools CLI command so that writers and our tests have access to a consistent set of tools

* Bump version

* Add submodule

* Add tree-sitter-cpp submodule

* Add tree-sitter-c grammar as dependency of C++ parser

* Add tree-sitter-c grammar as required by tree-sitter-cpp

* Add property automation to CLI

* Add CLI help

* doc-tools CLI

* Remove tree‑sitter‑cpp submodule; clone on demand instead

* Fix paths

* Fix makefile

* Update package.json

* Update package-lock.json

* Fix packages

* Cleanup

* Apply suggestions from code review

Co-authored-by: coderabbitai[bot] <136622811+coderabbitai[bot]@users.noreply.github.com>

* Refactor

* Add Iceberg support in test cluster

* Fix error

* Apply suggestions from code review

Co-authored-by: coderabbitai[bot] <136622811+coderabbitai[bot]@users.noreply.github.com>

* Final fixes

* Apply suggestions

* Add support for the new gets_restored metadata introduced in redpanda-data/redpanda#25105

* Add fetch command for saving files from other repos locally

* Apply suggestions from code review

Co-authored-by: coderabbitai[bot] <136622811+coderabbitai[bot]@users.noreply.github.com>

* Add support for a --diff flag

* Use tags for Redpanda labs

* Add symlink util for labs to the CLI

* Remove utils

---------

Co-authored-by: coderabbitai[bot] <136622811+coderabbitai[bot]@users.noreply.github.com>

Author: JakeSCahill

bin/doc-tools.js

@@ -5,6 +5,20 @@ const { Command } = require('commander');
 const path = require('path');
 const fs = require('fs');
 
+function findRepoRoot(start = process.cwd()) {
+  let dir = start;
+  while (dir !== path.parse(dir).root) {
+    // marker could be a .git folder or package.json or anything you choose
+    if (fs.existsSync(path.join(dir, '.git')) ||
+        fs.existsSync(path.join(dir, 'package.json'))) {
+      return dir;
+    }
+    dir = path.dirname(dir);
+  }
+  console.error('❌ Could not find repo root (no .git or package.json in any parent)');
+  process.exit(1);
+}
+
 // --------------------------------------------------------------------
 // Dependency check functions
 // --------------------------------------------------------------------
@@ -107,7 +121,7 @@ const programCli = new Command();
 programCli
   .name('doc-tools')
   .description('Redpanda Document Automation CLI')
-  .version('1.0.0');
+  .version('1.0.1');
 
 // Top-level commands.
 programCli
@@ -295,6 +309,40 @@ automation
     process.exit(0);
   });
 
+programCli
+  .command('link-readme <subdir> <targetFilename>')
+  .description('Symlink a README.adoc into docs/modules/<module>/pages/')
+  .action((subdir, targetFilename) => {
+    const repoRoot = findRepoRoot();
+    const normalized = 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);
+
+    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}`);
+      process.exit(1);
+    }
+
+    fs.mkdirSync(pagesDir, { recursive: true });
+    const relPath = path.relative(pagesDir, sourceFile);
+
+    try {
+      fs.symlinkSync(relPath, destLink);
+      console.log(`✔️  Linked ${relPath} → ${destLink}`);
+    } catch (err) {
+      console.error(`❌ Failed to create symlink: ${err.message}`);
+      process.exit(1);
+    }
+  });
+
 programCli
 .command('fetch')
 .description('Fetch a file or directory from GitHub and save locally')

extensions/replace-attributes-in-attachments.js

@@ -182,7 +182,7 @@ function getDynamicReplacements(componentVersion, logger) {
   const versionNum = formatVersion(componentVersion.version || '', semver);
   const is24_3plus =
     versionNum && semver.gte(versionNum, '24.3.0') && componentVersion.title === 'Self-Managed';
-  const useTagAttributes = isPrerelease || is24_3plus;
+  const useTagAttributes = isPrerelease || is24_3plus || componentVersion.title === 'Labs';
 
   // Derive Redpanda / Console versions
   const redpandaVersion = isPrerelease

extension-utils/compute-out.js renamed to extensions/util/compute-out.js

@@ -22,8 +22,8 @@ const jsonpath = require('jsonpath-plus');
 const yaml = require('yaml');
 // For synchronous HTTP fetching.
 const request = require('sync-request');
-const computeOut = require('../extension-utils/compute-out.js');
-const createAsciiDocFile = require('../extension-utils/create-asciidoc-file.js');
+const computeOut = require('../extensions/util/compute-out.js');
+const createAsciiDocFile = require('../extensions/util/create-asciidoc-file.js');
 
 // In-memory cache for external resources (avoid repeated network calls)
 const externalCache = new Map();

extension-utils/create-asciidoc-file.js renamed to extensions/util/create-asciidoc-file.js

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