Update READMEs for DevContainer Features

src/apptainer/README.md

@@ -21,4 +21,4 @@ Install Apptainer, a container system for HPC
 
 ---
 
-_Note: This file was auto-generated from the [devcontainer-feature.json](https://github.com/MiguelRodo/DevContainerFeatures/blob/main/src/apptainer/devcontainer-feature.json).  Add additional notes to a `NOTES.md`._
+_Note: This file was auto-generated from the [devcontainer-feature.json](devcontainer-feature.json).  Add additional notes to a `NOTES.md`._

src/build-info/README.md

@@ -0,0 +1,25 @@
+
+# Container Metadata Injector (build-info)
+
+Bakes build-time release version and date metadata from GHA directly into a system-wide command.
+
+## Example Usage
+
+```json
+"features": {
+    "ghcr.io/MiguelRodo/DevContainerFeatures/build-info:1": {}
+}
+```
+
+## Options
+
+| Options Id | Description | Type | Default Value |
+|-----|-----|-----|-----|
+| version | The automated version number injected from the runner host environment. | string | development |
+| buildDate | The build timestamp injected from the runner host environment. | string | unknown |
+
+
+
+---
+
+_Note: This file was auto-generated from the [devcontainer-feature.json](devcontainer-feature.json).  Add additional notes to a `NOTES.md`._

src/cmdstan/README.md

@@ -24,4 +24,4 @@ Installs CmdStan (the Stan probabilistic programming system command-line interfa
 
 ---
 
-_Note: This file was auto-generated from the [devcontainer-feature.json](https://github.com/MiguelRodo/DevContainerFeatures/blob/main/src/cmdstan/devcontainer-feature.json).  Add additional notes to a `NOTES.md`._
+_Note: This file was auto-generated from the [devcontainer-feature.json](devcontainer-feature.json).  Add additional notes to a `NOTES.md`._

src/fit-sne/README.md

@@ -21,4 +21,4 @@ Installs FIt-SNE (Fast Interpolation-based t-SNE) by compiling from source.
 
 ---
 
-_Note: This file was auto-generated from the [devcontainer-feature.json](https://github.com/MiguelRodo/DevContainerFeatures/blob/main/src/fit-sne/devcontainer-feature.json).  Add additional notes to a `NOTES.md`._
+_Note: This file was auto-generated from the [devcontainer-feature.json](devcontainer-feature.json).  Add additional notes to a `NOTES.md`._

src/github-tokens/README.md

@@ -22,4 +22,4 @@ Manage GitHub authentication tokens (GITHUB_PAT, GITHUB_TOKEN) on each shell sta
 
 ---
 
-_Note: This file was auto-generated from the [devcontainer-feature.json](https://github.com/MiguelRodo/DevContainerFeatures/blob/main/src/github-tokens/devcontainer-feature.json).  Add additional notes to a `NOTES.md`._
+_Note: This file was auto-generated from the [devcontainer-feature.json](devcontainer-feature.json).  Add additional notes to a `NOTES.md`._

src/mermaid/README.md

@@ -23,4 +23,4 @@ Installs Mermaid CLI to generate diagrams. Sets up a non-root user and Puppeteer
 
 ---
 
-_Note: This file was auto-generated from the [devcontainer-feature.json](https://github.com/MiguelRodo/DevContainerFeatures/blob/main/src/mermaid/devcontainer-feature.json).  Add additional notes to a `NOTES.md`._
+_Note: This file was auto-generated from the [devcontainer-feature.json](devcontainer-feature.json).  Add additional notes to a `NOTES.md`._

src/renv-cache/README.md

@@ -24,6 +24,10 @@ Configure R with renv cache
 | usePak | Whether to use `pak` for package installation. | boolean | false |
 | debug | Whether to print debug information during package restore. | boolean | false |
 | debugRenv | Whether to print debug information during renv restore. | boolean | false |
+| repositories | Comma-separated list of GitHub repos to clone. Must support branch and profile syntax: user/repo@branch:profile. If :profile is omitted, it defaults to the root renv.lock. | string | - |
+| pkg | Comma-separated list of specific packages to cache explicitly. | string | - |
+| installSystemRequirements | Uses the Posit API to install apt-dependencies. | boolean | true |
+| cranMirror | - | string | https://cloud.r-project.org |
 
 ## renv Global Cache Configuration
 
@@ -155,31 +159,6 @@ You can place custom scripts in your renv subdirectories:
 
 These scripts receive the `pkgExclude` parameter and run in the project directory context.
 
-### Accessing Lockfiles at Runtime
-
-The feature automatically creates snapshots of the `renv.lock` files used during the image build (both the "restore" state and the "update" state, if updates were requested).
-
-You can interact with these internal snapshots using the `renv-lockfile-cache` CLI utility, which is automatically available on your path inside the built container:
-
-**List Available Lockfiles:**
-```bash
-renv-lockfile-cache --list
-```
-
-**Copy a Lockfile to your Workspace:**
-By default, the script will prefer the updated lockfile (if available) and will place it in your current directory:
-```bash
-renv-lockfile-cache --copy
-```
-
-You can also specify a custom path (either a directory or exact filename):
-```bash
-renv-lockfile-cache --copy ./my-project/
-renv-lockfile-cache --copy /workspaces/custom-name.lock
-```
-
-If multiple project configurations were used during the build, `--copy` will prompt you interactively to select which project's lockfile you want to extract.
-
 ## Package Restoration
 
 This feature uses [`renvvv::renvvv_restore()`](https://github.com/MiguelRodo/renvvv) for package restoration instead of the default `renv::restore()`. This provides more robust restoration logic that:
@@ -267,4 +246,4 @@ If you also want GitHub token elevation on every shell startup (e.g., for intera
 
 ---
 
-_Note: This file was auto-generated from the [devcontainer-feature.json](https://github.com/MiguelRodo/DevContainerFeatures/blob/main/src/renv-cache/devcontainer-feature.json).  Add additional notes to a `NOTES.md`._
+_Note: This file was auto-generated from the [devcontainer-feature.json](devcontainer-feature.json).  Add additional notes to a `NOTES.md`._

src/repos/README.md

@@ -1,7 +1,9 @@
+### **IMPORTANT NOTE**
+- **This Feature is deprecated, and will no longer receive any further updates/support.**
 
 # Automatically set up multi-repo projects (repos)
 
-Installs the 'repos' CLI tool to manage multiple Git repositories. Optionally runs 'repos clone' when the container starts to clone repositories defined in repos.list.
+(DEPRECATED: Use the 'utils' feature instead) Installs the 'repos' CLI tool to manage multiple Git repositories. Optionally runs 'repos clone' when the container starts to clone repositories defined in repos.list.
 
 ## Example Usage
 
@@ -275,4 +277,4 @@ This project incorporates code from [AwesomeProject](https://github.com/rocker-o
 
 ---
 
-_Note: This file was auto-generated from the [devcontainer-feature.json](https://github.com/MiguelRodo/DevContainerFeatures/blob/main/src/repos/devcontainer-feature.json).  Add additional notes to a `NOTES.md`._
+_Note: This file was auto-generated from the [devcontainer-feature.json](devcontainer-feature.json).  Add additional notes to a `NOTES.md`._

src/utils/README.md

@@ -0,0 +1,26 @@
+
+# MiguelRodo Utils (utils)
+
+Installs Miguel Rodo's utilities like 'repos' and 'setupmjr'.
+
+## Example Usage
+
+```json
+"features": {
+    "ghcr.io/MiguelRodo/DevContainerFeatures/utils:1": {}
+}
+```
+
+## Options
+
+| Options Id | Description | Type | Default Value |
+|-----|-----|-----|-----|
+| installRepos | Install the 'repos' utility. | boolean | true |
+| installSetupmjr | Install the 'setupmjr' utility. | boolean | true |
+| runOnStart | Automatically run 'repos clone' when the container starts (only applies if installRepos is true). | boolean | false |
+
+
+
+---
+
+_Note: This file was auto-generated from the [devcontainer-feature.json](devcontainer-feature.json).  Add additional notes to a `NOTES.md`._