Merge remote-tracking branch 'upstream/main'

Author: dhower-qc

.agents/skills/extract-instructions-from-subsection/SKILL.md

@@ -0,0 +1,113 @@
+---
+name: extract-instructions-from-subsection
+description: Extract RISC-V instruction names from a named subsection of an AsciiDoc file and write them to /tmp/<subsection-title>.yaml.
+argument-hint: <subsection-title> <adoc-file>
+allowed-tools: Read, Bash, Write
+---
+
+Copyright (c) 2026 Qualcomm Technologies, Inc. and/or its subsidiaries.
+SPDX-License-Identifier: BSD-3-Clause-Clear
+
+Extract all RISC-V instruction names mentioned in the specified subsection of the given AsciiDoc file, then write them to `/tmp/<subsection-title>.yaml`, where `<subsection-title>` is argument 1 lowercased with spaces replaced by hyphens (e.g., `"Multiplication Operations"` → `/tmp/multiplication-operations.yaml`).
+
+## Arguments
+
+$ARGUMENTS
+
+- **Argument 1**: The subsection title to search for (e.g., `"Multiplication Operations"` or `"Integer Register-Immediate Instructions"`).
+- **Argument 2**: Path to the AsciiDoc file (e.g., `ext/riscv-isa-manual/src/m-st-ext.adoc`).
+
+If either argument is missing, ask the user to provide it.
+
+## Steps
+
+### 1. Read the AsciiDoc file
+
+Read the full content of the AsciiDoc file given as argument 2.
+
+### 2. Locate the subsection
+
+Find the subsection whose title matches argument 1. AsciiDoc section headings use `=` prefixes:
+- `== Title` — level 1 (chapter)
+- `=== Title` — level 2
+- `==== Title` — level 3
+- `===== Title` — level 4
+
+Match the subsection title case-insensitively. The subsection's content starts on the line after the heading and ends just before the next heading of equal or higher level (i.e., same or fewer `=` characters).
+
+### 3. Identify NOTE blocks to skip
+
+Before scanning for instructions, mark all NOTE blocks in the subsection so they can be excluded. AsciiDoc NOTE blocks appear in two forms:
+
+- **Delimited block**: starts with `[NOTE]` followed by `====` on the next line, and ends at the closing `====`.
+- **Inline note**: a single line starting with `NOTE:` (no delimiter).
+
+Any instruction name that appears **only** inside NOTE blocks — and nowhere else in the subsection — must be excluded from the output. If an instruction appears both inside and outside a NOTE block, include it.
+
+### 4. Extract instruction names
+
+Scan the non-NOTE text of the subsection for RISC-V instruction names. Instruction names appear as **uppercase tokens** in the prose. Use the following rules to identify them:
+
+**Patterns that indicate an instruction name:**
+- All-uppercase tokens of at least 2 characters that consist only of letters, and optionally digits or dots (e.g., `ADD`, `ADDI`, `MULHSU`, `FENCE.TSO`, `LR.W`, `SC.D`, `C.ADD`, `C.ADDI16SP`)
+- Uppercase tokens inside backticks: `` `ADD` ``, `` `JALR` ``
+- Uppercase tokens in AsciiDoc index entries: `(((MUL, MULH)))` — extract each comma-separated token
+- Uppercase tokens in AsciiDoc comment lines like `//.Integer register-register` — skip these (they are labels, not instructions)
+
+**Exclude pseudoinstructions:**
+The prose explicitly signals pseudoinstructions with the phrase "assembler pseudoinstruction" or "pseudoinstruction" adjacent to the name, e.g.:
+- `assembler pseudoinstruction SNEZ _rd, rs_`
+- `assembler pseudoinstruction MV _rd, rs1_`
+- `assembler pseudoinstruction SEQZ _rd, rs_`
+- `assembler pseudoinstruction NOT _rd, rs_`
+- `assembler pseudoinstruction J`
+- `assembler pseudoinstruction RET`
+- `assembler pseudoinstruction JR`
+
+Any token introduced by "pseudoinstruction" (with or without "assembler") must be excluded, even if it appears elsewhere in the subsection outside a pseudoinstruction context. Collect all pseudoinstruction names first, then exclude them from the final list.
+
+**Definitive exclusion list — never treat these as instructions:**
+`XLEN`, `RV32`, `RV64`, `RV32I`, `RV64I`, `RV128I`, `ISA`, `ABI`, `PC`, `CSR`, `IALIGN`, `BTB`, `RAS`, `FPGA`, `MIPS`, `RISC`, `RISCV`, `RISC-V`
+
+Tokens that are register names (`x0`–`x31`, `rd`, `rs1`, `rs2`) — exclude them.
+
+### 5. Deduplicate and normalize
+
+- Convert all extracted names to **lowercase** (matching the RISC-V Unified Database YAML file naming convention, e.g., `ADD` → `add`, `MULHSU` → `mulhsu`, `FENCE.TSO` → `fence.tso`, `LR.W` → `lr.w`)
+- Remove duplicates
+- Sort alphabetically
+
+### 6. Write the output
+
+Derive the output filename from argument 1: lowercase it and replace spaces with hyphens (e.g., `"Multiplication Operations"` → `multiplication-operations`). Write `/tmp/<derived-name>.yaml` with the following format:
+
+```yaml
+instructions:
+  - add
+  - addi
+  - mul
+  - mulh
+```
+
+Use the Write tool to create the file.
+
+### 7. Report
+
+Print a summary:
+- The subsection title found
+- The number of instructions extracted
+- The path written (e.g., `/tmp/multiplication-operations.yaml`)
+- The list of instructions
+
+## Example
+
+For subsection `"Multiplication Operations"` in `ext/riscv-isa-manual/src/m-st-ext.adoc`, the output file is `/tmp/multiplication-operations.yaml`:
+
+```yaml
+instructions:
+  - mul
+  - mulh
+  - mulhsu
+  - mulhu
+  - mulw
+```

.default-gems

@@ -0,0 +1 @@
+bundler -v 4.0.8

.devcontainer/Dockerfile

@@ -1,118 +1,117 @@
-FROM ubuntu:24.04
+FROM ubuntu:24.04@sha256:cd1dba651b3080c3686ecf4e3c4220f026b521fb76978881737d24f200828b2b
 LABEL org.opencontainers.image.source=https://github.com/riscv/riscv-unified-db
 
 ENV DEBIAN_FRONTEND=noninteractive
+ENV IN_UDB_CONTAINER=true
 
 WORKDIR /workspace
 
 # please keep pkgs sorted
 RUN apt-get update && \
   apt-get install -y --no-install-recommends --fix-missing \
+  bash-completion \
   build-essential \
   clang-format \
   clang-tidy \
-  cmake \
   curl \
   ditaa \
   g++ \
   gcc-riscv64-linux-gnu \
   gcc-riscv64-unknown-elf \
   gdb \
-  gh \
   git \
   gpg \
+  gpg-agent \
   less \
   libc6-dev-riscv64-cross \
   libelf-dev \
   libgmp-dev \
   libnewlib-dev \
   libyaml-dev \
-  libz3-dev \
-  minisat \
-  nodejs \
-  npm \
   parallel \
-  python3 \
-  python3-pip \
-  python3.12-venv \
-  rustc \
-  shellcheck \
+  ssh \
   sudo \
   zlib1g-dev \
   \
   && apt-get clean autoclean \
   && apt-get autoremove -y \
   && rm -rf /var/lib/{apt,dpkg,cache,log}/*
 
-  # build / install ruby
-COPY .ruby-version /opt/.ruby-version
-ENV RUBY_YJIT_ENABLE=1
-RUN git clone --depth=1 https://github.com/rbenv/ruby-build.git && \
-    cd ruby-build && \
-    ./bin/ruby-build $(cat /opt/.ruby-version | tr -d "\n") /usr && \
-    cd .. && \
-    rm -rf ruby-build
-
-# build/install eqntott
-RUN git clone --depth=1 https://github.com/TheProjecter/eqntott.git && \
-    cd eqntott && \
-    ./configure && \
-    make && make install && \
-    cd .. && \
-    rm -rf eqntott
+# Install mise for tool management
+# See: https://mise.jdx.dev/mise-cookbook/docker.html
+ENV MISE_DATA_DIR="/mise"
+ENV MISE_CONFIG_DIR="/mise"
+ENV MISE_CACHE_DIR="/mise/cache"
+ENV MISE_STATE_DIR="/mise/state"
+ENV MISE_INSTALL_PATH="/usr/local/bin/mise"
+ENV MISE_YES=1
+ENV MISE_TRUSTED_CONFIG_PATHS="/"
+ENV UV_CACHE_DIR="/tmp/uv-cache"
+ENV PATH="/mise/shims:$PATH"
 
-# build/install espresso
-RUN git clone --depth=1 https://github.com/psksvp/espresso-ab-1.0.git && \
-    cd espresso-ab-1.0 && \
-    ./configure && \
-    make && make install && \
-    cd .. && \
-    rm -rf espresso-ab-1.0
+# renovate: datasource=github-releases depName=jdx/mise
+ARG MISE_VERSION=2026.4.4
+RUN MISE_VERSION=${MISE_VERSION} curl https://mise.run | sh
 
-# build / install must
-# mcsmus/mcsmus/control.cc is missing #include <cstdio>, thus the sed below
-RUN git clone https://github.com/jar-ben/mustool.git && \
-    cd mustool && \
-    git checkout 17fa9f9542a9ce05328dfccd1cd410f05f741ab3 && \
-    sed -i -e 's/#include <signal.h>/#include <signal.h>\n#include <cstdio>/' mcsmus/mcsmus/control.cc && \
-    make -j && \
-    install must -m 0777 /usr/bin/must && \
-    cd .. && \
-    rm -rf mustool
+# Install tools managed by mise (.mise.toml)
+COPY .mise.toml /mise/config.toml
+COPY .default-gems /mise/.default-gems
+RUN --mount=type=secret,id=MISE_GITHUB_TOKEN,env=MISE_GITHUB_TOKEN mise install
+RUN mise reshim
+RUN mkdir -p /mise/state && chmod -R 777 /mise
 
-# Create Python virtual environment and install packages
-COPY requirements.txt /opt/requirements.txt
-RUN /usr/bin/python3 -m venv /opt/venv && \
-  /opt/venv/bin/pip install -r /opt/requirements.txt && \
-  rm /opt/requirements.txt
-ENV PATH="/opt/venv/bin:$PATH"
+# Sync Python project dependencies with uv
+COPY pyproject.toml uv.lock /opt/python/
+RUN cd /opt/python && uv sync
+ENV PATH="/opt/python/.venv/bin:$PATH"
+ENV UV_PROJECT_ENVIRONMENT="/opt/python/.venv"
+RUN mkdir -p /tmp/uv-cache && chmod -R 777 /tmp/uv-cache
 
 # Install npm packages globally in the container
 COPY package.json package-lock.json /opt/node/
 RUN cd /opt/node && \
-  /usr/bin/npm ci && \
+  npm ci && \
   rm /opt/node/package.json /opt/node/package-lock.json
 ENV NODE_PATH="/opt/node/node_modules"
 ENV PATH="/opt/node/node_modules/.bin:$PATH"
-ENV IN_UDB_CONTAINER=true
 
 # install gems
+ENV BUNDLE_PATH=/usr/local/bundle
+ENV BUNDLE_BIN=/usr/local/bundle/bin
+ENV GEM_HOME=/usr/local/bundle
+ENV GEM_PATH=/usr/local/bundle
+ENV PATH="/usr/local/bundle/bin:$PATH"
+
+# Create the bundle directory
+RUN mkdir -p /usr/local/bundle \
+    && chmod 1777 /usr/local/bundle
+
 COPY Gemfile /opt/Gemfile
 COPY Gemfile.lock /opt/Gemfile.lock
+COPY tools/ruby-gems/idlc/Gemfile /opt/tools/ruby-gems/idlc/
+COPY tools/ruby-gems/idlc/Gemfile.lock /opt/tools/ruby-gems/idlc/
 COPY tools/ruby-gems/idlc/idlc.gemspec /opt/tools/ruby-gems/idlc/
-COPY tools/ruby-gems/idlc/lib/gem_versions.rb /opt/tools/ruby-gems/idlc/lib/
 COPY tools/ruby-gems/idlc/lib/idlc/version.rb /opt/tools/ruby-gems/idlc/lib/idlc/
 COPY tools/ruby-gems/idl_highlighter/idl_highlighter.gemspec /opt/tools/ruby-gems/idl_highlighter/
 COPY tools/ruby-gems/idl_highlighter/lib/idl_highlighter/version.rb /opt/tools/ruby-gems/idl_highlighter/lib/idl_highlighter/
+COPY tools/ruby-gems/udb/Gemfile /opt/tools/ruby-gems/udb/
+COPY tools/ruby-gems/udb/Gemfile.lock /opt/tools/ruby-gems/udb/
 COPY tools/ruby-gems/udb/udb.gemspec /opt/tools/ruby-gems/udb/
-COPY tools/ruby-gems/udb/lib/gem_versions.rb /opt/tools/ruby-gems/udb/lib/
 COPY tools/ruby-gems/udb/lib/udb/version.rb /opt/tools/ruby-gems/udb/lib/udb/
+COPY tools/ruby-gems/udb/lib/udb/dep_versions.rb /opt/tools/ruby-gems/udb/lib/udb/
+COPY tools/ruby-gems/udb/ext/udb_download/extconf.rb /opt/tools/ruby-gems/udb/ext/udb_download/
+COPY tools/ruby-gems/udb-gen/Gemfile /opt/tools/ruby-gems/udb-gen/
+COPY tools/ruby-gems/udb-gen/Gemfile.lock /opt/tools/ruby-gems/udb-gen/
 COPY tools/ruby-gems/udb-gen/udb-gen.gemspec /opt/tools/ruby-gems/udb-gen/
-COPY tools/ruby-gems/udb-gen/lib/gem_versions.rb /opt/tools/ruby-gems/udb-gen/lib/
 COPY tools/ruby-gems/udb-gen/lib/udb-gen/version.rb /opt/tools/ruby-gems/udb-gen/lib/udb-gen/
 COPY tools/ruby-gems/udb_helpers/udb_helpers.gemspec /opt/tools/ruby-gems/udb_helpers/
 COPY tools/ruby-gems/udb_helpers/lib/udb_helpers/version.rb /opt/tools/ruby-gems/udb_helpers/lib/udb_helpers/
-RUN bundle install --gemfile /opt/Gemfile
+RUN bundle install --gemfile /opt/Gemfile --jobs $(nproc) \
+    && bundle install --gemfile /opt/tools/ruby-gems/idlc/Gemfile --jobs $(nproc) \
+    && bundle install --gemfile /opt/tools/ruby-gems/udb/Gemfile --jobs $(nproc) \
+    && bundle install --gemfile /opt/tools/ruby-gems/udb-gen/Gemfile --jobs $(nproc) \
+    && chmod -R a+rwX /usr/local/bundle \
+    && rm -f /usr/local/bundle/bin/bundle
 
 # the binaries for gems need to be copied in
 RUN mkdir -p /workspace/bin/container

.devcontainer/devcontainer.json

@@ -23,14 +23,16 @@
       },
       "extensions": [
         "asciidoctor.asciidoctor-vscode",
-        "castwide.solargraph",
+        "charliermarsh.ruff",
         "CraigMaslowski.erb",
         "HowerLimited.udb-extension-pack-vscode",
         "mathematic.vscode-pdf",
+        "ms-azuretools.vscode-containers",
         "redhat.vscode-yaml",
-        "zhwu95.riscv",
+        "Shopify.ruby-lsp",
+        "tamasfe.even-better-toml",
         "timonwong.shellcheck",
-        "ms-azuretools.vscode-containers"
+        "zhwu95.riscv"
       ]
     }
   },

.devcontainer/docker-entrypoint.sh

@@ -3,3 +3,6 @@
 
 # eclipse Xtext project owned by Ajit Dingankar
 tools/eclipse @adingank-qualcomm @dhower-qc
+
+# Renovate owned by Jordan Carlin
+renovate.json5 @jordancarlin

.github/CODEOWNERS

@@ -0,0 +1,18 @@
+name: autofix.ci  # needed to securely identify the workflow
+
+on:
+  pull_request:
+permissions:
+  contents: read
+
+jobs:
+  autofix:
+    runs-on: ubuntu-latest
+    steps:
+      - uses: actions/checkout@de0fac2e4500dabe0009e67214ff5f5447ce83dd # v6.0.2
+        with:
+          fetch-depth: 0
+      - uses: jdx/mise-action@v4
+      - run: bundle install
+      - run: IN_UDB_CONTAINER=1 BUNDLE_GEMFILE=$PWD/Gemfile ./bin/chore gen all
+      - uses: autofix-ci/action@7a166d7532b277f34e16238930461bf77f9d7ed8 # v1.3.3