simdref 0.0.5__tar.gz → 0.0.7__tar.gz

{simdref-0.0.5/src/simdref.egg-info → simdref-0.0.7}/PKG-INFO

@@ -1,7 +1,7 @@
 Metadata-Version: 2.4
 Name: simdref
-Version: 0.0.5
-Summary: Searchable SIMD intrinsic and instruction reference with CLI, manpages, TUI, LSP, and static web export.
+Version: 0.0.7
+Summary: Searchable SIMD intrinsic and instruction reference with CLI, manpages, TUI, and LSP.
 Author: Marco
 License: GPL-3.0-or-later
 Classifier: Development Status :: 3 - Alpha
@@ -10,29 +10,31 @@ Classifier: Intended Audience :: Developers
 Classifier: License :: OSI Approved :: GNU General Public License v3 or later (GPLv3+)
 Classifier: Operating System :: OS Independent
 Classifier: Programming Language :: Python :: 3
+Classifier: Programming Language :: Python :: 3.10
 Classifier: Programming Language :: Python :: 3.11
 Classifier: Programming Language :: Python :: 3.12
 Classifier: Programming Language :: Python :: 3.13
+Classifier: Programming Language :: Python :: 3.14
 Classifier: Topic :: Software Development :: Documentation
 Classifier: Topic :: Software Development :: Libraries :: Python Modules
-Requires-Python: >=3.11
+Requires-Python: >=3.10
 Description-Content-Type: text/markdown
 License-File: LICENSE
-Requires-Dist: click<10,>=8.1
+Requires-Dist: click<9,>=8.5
 Requires-Dist: httpx<1,>=0.28
-Requires-Dist: msgpack<2,>=1.0
-Requires-Dist: pdfplumber<1,>=0.11
-Requires-Dist: PyMuPDF<2,>=1.24
-Requires-Dist: PyYAML<7,>=6
-Requires-Dist: rapidfuzz<4,>=3.9
-Requires-Dist: rich<15,>=13
-Requires-Dist: textual<2,>=1.0
-Requires-Dist: typer<1,>=0.19
+Requires-Dist: msgpack<2,>=1.2.1
+Requires-Dist: pdfplumber<1,>=0.11.10
+Requires-Dist: PyMuPDF<2,>=1.28
+Requires-Dist: PyYAML<7,>=6.0.3
+Requires-Dist: rapidfuzz<4,>=3.14
+Requires-Dist: rich<16,>=15
+Requires-Dist: textual<9,>=8.2
+Requires-Dist: typer<1,>=0.27
 Dynamic: license-file
 
 # simdref
 
-[![CI](https://github.com/DiamonDinoia/simdref/actions/workflows/ci.yml/badge.svg)](https://github.com/DiamonDinoia/simdref/actions/workflows/ci.yml)
+[![CI](https://github.com/simd-labs/simdref/actions/workflows/ci.yml/badge.svg)](https://github.com/simd-labs/simdref/actions/workflows/ci.yml)
 [![TestPyPI](https://img.shields.io/pypi/v/simdref?pypiBaseUrl=https%3A%2F%2Ftest.pypi.org&label=TestPyPI)](https://test.pypi.org/project/simdref/)
 [![Python](https://img.shields.io/pypi/pyversions/simdref?pypiBaseUrl=https%3A%2F%2Ftest.pypi.org)](https://pypi.org/project/simdref/)
 
@@ -40,90 +42,28 @@ A single searchable reference for SIMD intrinsics and instructions across
 **x86 (Intel + uops.info)**, **Arm (ACLE / AARCHMRS)**, and **RISC-V
 (RVV + unified-db)**. Runs as a CLI, a Textual TUI, an LSP server,
 on-demand manpages (`simdref man` — or run `simdref install-manpages`
-so plain `man vpaddd` works), a static web app, and a structured JSON
-interface for LLM skills.
+so plain `man vpaddd` works), a JSON site-data export for
+[simdref-web](https://github.com/simd-labs/simdref-web), and a
+structured JSON interface for LLM skills.
 
-[Web App](https://diamondinoia.github.io/simdref/) ·
+[Web App](https://simdref.diamondinoia.com/) ·
 [TestPyPI](https://test.pypi.org/project/simdref/) ·
-[GitHub](https://github.com/DiamonDinoia/simdref) ·
+[GitHub](https://github.com/simd-labs/simdref) ·
 [Contributing](CONTRIBUTING.md)
 
 <!-- Screenshots are hosted on the `docs-assets` branch so the main
      branch stays lightweight to clone. -->
 
 <p align="center">
-  <img alt="simdref TUI" src="https://raw.githubusercontent.com/DiamonDinoia/simdref/docs-assets/img/tui.svg" width="720">
+  <img alt="simdref TUI" src="https://raw.githubusercontent.com/simd-labs/simdref/docs-assets/img/tui.svg" width="720">
   <br><em>Interactive TUI with ISA filters, ranked results, and measured/modeled performance tables.</em>
 </p>
 
-## Install the Claude Code skill
+## Install the Claude Code and Codex skill
 
-`skills/asm-analysis/` ships a Claude Code skill that drives the
-compile → objdump → `simdref annotate` → `simdref profile` → LLM-batch
-pipeline automatically. This repo publishes it as a Claude Code plugin,
-so the one-liner install is:
-
-```
-/plugin marketplace add DiamonDinoia/simdref
-/plugin install asm-analysis@simdref
-```
-
-Run those at the Claude Code prompt. The marketplace add fetches this
-repo; the install wires up the skill so Claude picks it up automatically
-on performance-oriented prompts like *"why is this loop slow"*,
-*"vectorise this"*, *"look at the asm"*.
-
-### Manual install (no marketplace)
-
-If you prefer a hand-managed copy:
-
-```bash
-# symlink from a checkout — always current with main:
-git clone https://github.com/DiamonDinoia/simdref.git ~/src/simdref
-mkdir -p ~/.claude/skills
-ln -sf ~/src/simdref/skills/asm-analysis ~/.claude/skills/asm-analysis
-
-# or pull a one-off snapshot:
-mkdir -p ~/.claude/skills/asm-analysis && \
-  curl -fsSL https://raw.githubusercontent.com/DiamonDinoia/simdref/main/skills/asm-analysis/SKILL.md \
-  -o ~/.claude/skills/asm-analysis/SKILL.md
-```
-
-See [`skills/asm-analysis/SKILL.md`](skills/asm-analysis/SKILL.md) for
-the full trigger list and pipeline stages.
-
-## Install the Codex skill
-
-This repo also ships the same pipeline as an OpenAI Codex plugin, so
-the one-liner install from a Codex CLI prompt is:
-
-```
-codex plugin marketplace add DiamonDinoia/simdref
-/plugins
-```
-
-Pick `asm-analysis` in the browser and enable it. Codex picks up the
-skill automatically on performance-oriented prompts (*"why is this
-loop slow"*, *"vectorise this"*, *"look at the asm"*).
-
-### Manual install (no marketplace)
-
-```bash
-# user-scoped symlink — applies to every repo, always current with main:
-git clone https://github.com/DiamonDinoia/simdref.git ~/src/simdref
-mkdir -p ~/.agents/skills
-ln -sf ~/src/simdref/codex-skills/asm-analysis/skills/asm-analysis \
-       ~/.agents/skills/asm-analysis
-
-# or scope the skill to a single repo:
-mkdir -p .agents/skills
-ln -sf ~/src/simdref/codex-skills/asm-analysis/skills/asm-analysis \
-       .agents/skills/asm-analysis
-```
-
-See
-[`codex-skills/asm-analysis/skills/asm-analysis/SKILL.md`](codex-skills/asm-analysis/skills/asm-analysis/SKILL.md)
-for the trigger list and pipeline stages.
+The `asm-analysis` skill for Claude Code and OpenAI Codex lives in
+[simd-labs/simdref-skill](https://github.com/simd-labs/simdref-skill).
+Follow the install steps in that repo.
 
 ## Install
 
@@ -134,15 +74,6 @@ isa doctor     # confirm everything is wired up
 isa            # open the TUI
 ```
 
-For the bleeding-edge version with the `simdref profile` subcommand
-(runtime-profile → asm-annotation pipeline, Stage 2b of the skill),
-install from `main`:
-
-```bash
-pipx install git+https://github.com/DiamonDinoia/simdref.git@main
-# or editable: pip install -e git+https://github.com/DiamonDinoia/simdref.git@main#egg=simdref
-```
-
 The package installs two equivalent executables, **`isa`** (short) and
 **`simdref`** (explicit). The rest of this README uses `isa`.
 
@@ -174,15 +105,15 @@ isa                  # open the interactive TUI
 
 **Web app** — a self-contained static SPA with filters and performance
 tables, published to GitHub Pages at
-[diamondinoia.github.io/simdref](https://diamondinoia.github.io/simdref/).
-Export your own copy:
+[simdref.diamondinoia.com](https://simdref.diamondinoia.com/) and
+built from the `simdref-web` repo. This repo exports the
+JSON data it consumes:
 
 ```bash
-isa web --web-dir ./web
-isa serve --web-dir ./web       # gzip-aware local server
+isa export --out-dir ./site-data
 ```
 
-The [live demo](https://diamondinoia.github.io/simdref/) hosts the same
+The [live demo](https://simdref.diamondinoia.com/) hosts the same
 build — search across ~122k entries with ISA filters and per-uarch perf
 tables.
 
@@ -258,10 +189,6 @@ and `ld` still consume it.
 | `isa doctor`            | Check the installation — pass/fail per component, non-zero exit on failure                                        |
 | `isa update`            | Download the pre-built release catalog (no `llvm-mca` required); `--from-release` for the GitHub Release artifact |
 | `isa annotate <file.s>` | Annotate a `.s` assembly file with per-instruction summaries and latency/CPI — writes `<file>.sa`                 |
-| `isa profile run`       | Compile→record→disassemble→annotate→merge in one shot (perf or llvm-mca)                                          |
-| `isa profile ingest`    | Convert profiler output (perf / VTune / uProf / xctrace / llvm-mca / exegesis) to normalized samples              |
-| `isa profile hotloops`  | Detect natural loops in a disassembly and rank them by sample weight                                              |
-| `isa profile merge`     | Attach hotness data to the annotated instruction stream                                                           |
 | `isa llm query <q>`     | Strict lookup → JSON/NDJSON/Markdown (see [docs/LLM.md](docs/LLM.md))                                             |
 | `isa llm batch`         | Resolve many queries from stdin in one invocation (NDJSON out)                                                    |
 | `isa llm list`          | Dump the `FilterSpec` or stream matching catalog entries                                                          |
@@ -272,8 +199,7 @@ and `ld` still consume it.
 | Command                          | Description                                                                                     |
 | -------------------------------- | ----------------------------------------------------------------------------------------------- |
 | `isa build`                      | Full local rebuild from upstream sources, including Intel SDM parsing (`llvm-mca` 18+ required) |
-| `isa web`                        | Export the static web app under `web/`                                                          |
-| `isa serve`                      | Serve the exported web app locally (gzip-aware)                                                 |
+| `isa export`                     | Export site data (JSON only) — the release contract for the `simdref-web` repo                  |
 | `isa completion install [SHELL]` | Install shell completion into the user's profile                                                |
 | `isa completion show [SHELL]`    | Print the completion script for a shell                                                         |
 
@@ -308,7 +234,7 @@ mixed.
 ## Development
 
 ```bash
-git clone https://github.com/DiamonDinoia/simdref.git
+git clone https://github.com/simd-labs/simdref.git
 cd simdref
 python3 -m venv .venv
 .venv/bin/pip install -e .

{simdref-0.0.5 → simdref-0.0.7}/README.md

@@ -1,6 +1,6 @@
 # simdref
 
-[![CI](https://github.com/DiamonDinoia/simdref/actions/workflows/ci.yml/badge.svg)](https://github.com/DiamonDinoia/simdref/actions/workflows/ci.yml)
+[![CI](https://github.com/simd-labs/simdref/actions/workflows/ci.yml/badge.svg)](https://github.com/simd-labs/simdref/actions/workflows/ci.yml)
 [![TestPyPI](https://img.shields.io/pypi/v/simdref?pypiBaseUrl=https%3A%2F%2Ftest.pypi.org&label=TestPyPI)](https://test.pypi.org/project/simdref/)
 [![Python](https://img.shields.io/pypi/pyversions/simdref?pypiBaseUrl=https%3A%2F%2Ftest.pypi.org)](https://pypi.org/project/simdref/)
 
@@ -8,90 +8,28 @@ A single searchable reference for SIMD intrinsics and instructions across
 **x86 (Intel + uops.info)**, **Arm (ACLE / AARCHMRS)**, and **RISC-V
 (RVV + unified-db)**. Runs as a CLI, a Textual TUI, an LSP server,
 on-demand manpages (`simdref man` — or run `simdref install-manpages`
-so plain `man vpaddd` works), a static web app, and a structured JSON
-interface for LLM skills.
+so plain `man vpaddd` works), a JSON site-data export for
+[simdref-web](https://github.com/simd-labs/simdref-web), and a
+structured JSON interface for LLM skills.
 
-[Web App](https://diamondinoia.github.io/simdref/) ·
+[Web App](https://simdref.diamondinoia.com/) ·
 [TestPyPI](https://test.pypi.org/project/simdref/) ·
-[GitHub](https://github.com/DiamonDinoia/simdref) ·
+[GitHub](https://github.com/simd-labs/simdref) ·
 [Contributing](CONTRIBUTING.md)
 
 <!-- Screenshots are hosted on the `docs-assets` branch so the main
      branch stays lightweight to clone. -->
 
 <p align="center">
-  <img alt="simdref TUI" src="https://raw.githubusercontent.com/DiamonDinoia/simdref/docs-assets/img/tui.svg" width="720">
+  <img alt="simdref TUI" src="https://raw.githubusercontent.com/simd-labs/simdref/docs-assets/img/tui.svg" width="720">
   <br><em>Interactive TUI with ISA filters, ranked results, and measured/modeled performance tables.</em>
 </p>
 
-## Install the Claude Code skill
+## Install the Claude Code and Codex skill
 
-`skills/asm-analysis/` ships a Claude Code skill that drives the
-compile → objdump → `simdref annotate` → `simdref profile` → LLM-batch
-pipeline automatically. This repo publishes it as a Claude Code plugin,
-so the one-liner install is:
-
-```
-/plugin marketplace add DiamonDinoia/simdref
-/plugin install asm-analysis@simdref
-```
-
-Run those at the Claude Code prompt. The marketplace add fetches this
-repo; the install wires up the skill so Claude picks it up automatically
-on performance-oriented prompts like *"why is this loop slow"*,
-*"vectorise this"*, *"look at the asm"*.
-
-### Manual install (no marketplace)
-
-If you prefer a hand-managed copy:
-
-```bash
-# symlink from a checkout — always current with main:
-git clone https://github.com/DiamonDinoia/simdref.git ~/src/simdref
-mkdir -p ~/.claude/skills
-ln -sf ~/src/simdref/skills/asm-analysis ~/.claude/skills/asm-analysis
-
-# or pull a one-off snapshot:
-mkdir -p ~/.claude/skills/asm-analysis && \
-  curl -fsSL https://raw.githubusercontent.com/DiamonDinoia/simdref/main/skills/asm-analysis/SKILL.md \
-  -o ~/.claude/skills/asm-analysis/SKILL.md
-```
-
-See [`skills/asm-analysis/SKILL.md`](skills/asm-analysis/SKILL.md) for
-the full trigger list and pipeline stages.
-
-## Install the Codex skill
-
-This repo also ships the same pipeline as an OpenAI Codex plugin, so
-the one-liner install from a Codex CLI prompt is:
-
-```
-codex plugin marketplace add DiamonDinoia/simdref
-/plugins
-```
-
-Pick `asm-analysis` in the browser and enable it. Codex picks up the
-skill automatically on performance-oriented prompts (*"why is this
-loop slow"*, *"vectorise this"*, *"look at the asm"*).
-
-### Manual install (no marketplace)
-
-```bash
-# user-scoped symlink — applies to every repo, always current with main:
-git clone https://github.com/DiamonDinoia/simdref.git ~/src/simdref
-mkdir -p ~/.agents/skills
-ln -sf ~/src/simdref/codex-skills/asm-analysis/skills/asm-analysis \
-       ~/.agents/skills/asm-analysis
-
-# or scope the skill to a single repo:
-mkdir -p .agents/skills
-ln -sf ~/src/simdref/codex-skills/asm-analysis/skills/asm-analysis \
-       .agents/skills/asm-analysis
-```
-
-See
-[`codex-skills/asm-analysis/skills/asm-analysis/SKILL.md`](codex-skills/asm-analysis/skills/asm-analysis/SKILL.md)
-for the trigger list and pipeline stages.
+The `asm-analysis` skill for Claude Code and OpenAI Codex lives in
+[simd-labs/simdref-skill](https://github.com/simd-labs/simdref-skill).
+Follow the install steps in that repo.
 
 ## Install
 
@@ -102,15 +40,6 @@ isa doctor     # confirm everything is wired up
 isa            # open the TUI
 ```
 
-For the bleeding-edge version with the `simdref profile` subcommand
-(runtime-profile → asm-annotation pipeline, Stage 2b of the skill),
-install from `main`:
-
-```bash
-pipx install git+https://github.com/DiamonDinoia/simdref.git@main
-# or editable: pip install -e git+https://github.com/DiamonDinoia/simdref.git@main#egg=simdref
-```
-
 The package installs two equivalent executables, **`isa`** (short) and
 **`simdref`** (explicit). The rest of this README uses `isa`.
 
@@ -142,15 +71,15 @@ isa                  # open the interactive TUI
 
 **Web app** — a self-contained static SPA with filters and performance
 tables, published to GitHub Pages at
-[diamondinoia.github.io/simdref](https://diamondinoia.github.io/simdref/).
-Export your own copy:
+[simdref.diamondinoia.com](https://simdref.diamondinoia.com/) and
+built from the `simdref-web` repo. This repo exports the
+JSON data it consumes:
 
 ```bash
-isa web --web-dir ./web
-isa serve --web-dir ./web       # gzip-aware local server
+isa export --out-dir ./site-data
 ```
 
-The [live demo](https://diamondinoia.github.io/simdref/) hosts the same
+The [live demo](https://simdref.diamondinoia.com/) hosts the same
 build — search across ~122k entries with ISA filters and per-uarch perf
 tables.
 
@@ -226,10 +155,6 @@ and `ld` still consume it.
 | `isa doctor`            | Check the installation — pass/fail per component, non-zero exit on failure                                        |
 | `isa update`            | Download the pre-built release catalog (no `llvm-mca` required); `--from-release` for the GitHub Release artifact |
 | `isa annotate <file.s>` | Annotate a `.s` assembly file with per-instruction summaries and latency/CPI — writes `<file>.sa`                 |
-| `isa profile run`       | Compile→record→disassemble→annotate→merge in one shot (perf or llvm-mca)                                          |
-| `isa profile ingest`    | Convert profiler output (perf / VTune / uProf / xctrace / llvm-mca / exegesis) to normalized samples              |
-| `isa profile hotloops`  | Detect natural loops in a disassembly and rank them by sample weight                                              |
-| `isa profile merge`     | Attach hotness data to the annotated instruction stream                                                           |
 | `isa llm query <q>`     | Strict lookup → JSON/NDJSON/Markdown (see [docs/LLM.md](docs/LLM.md))                                             |
 | `isa llm batch`         | Resolve many queries from stdin in one invocation (NDJSON out)                                                    |
 | `isa llm list`          | Dump the `FilterSpec` or stream matching catalog entries                                                          |
@@ -240,8 +165,7 @@ and `ld` still consume it.
 | Command                          | Description                                                                                     |
 | -------------------------------- | ----------------------------------------------------------------------------------------------- |
 | `isa build`                      | Full local rebuild from upstream sources, including Intel SDM parsing (`llvm-mca` 18+ required) |
-| `isa web`                        | Export the static web app under `web/`                                                          |
-| `isa serve`                      | Serve the exported web app locally (gzip-aware)                                                 |
+| `isa export`                     | Export site data (JSON only) — the release contract for the `simdref-web` repo                  |
 | `isa completion install [SHELL]` | Install shell completion into the user's profile                                                |
 | `isa completion show [SHELL]`    | Print the completion script for a shell                                                         |
 
@@ -276,7 +200,7 @@ mixed.
 ## Development
 
 ```bash
-git clone https://github.com/DiamonDinoia/simdref.git
+git clone https://github.com/simd-labs/simdref.git
 cd simdref
 python3 -m venv .venv
 .venv/bin/pip install -e .

{simdref-0.0.5 → simdref-0.0.7}/pyproject.toml

@@ -4,10 +4,10 @@ build-backend = "setuptools.build_meta"
 
 [project]
 name = "simdref"
-version = "0.0.5"
-description = "Searchable SIMD intrinsic and instruction reference with CLI, manpages, TUI, LSP, and static web export."
+version = "0.0.7"
+description = "Searchable SIMD intrinsic and instruction reference with CLI, manpages, TUI, and LSP."
 readme = "README.md"
-requires-python = ">=3.11"
+requires-python = ">=3.10"
 license = {text = "GPL-3.0-or-later"}
 authors = [
   {name = "Marco"}
@@ -19,23 +19,30 @@ classifiers = [
   "License :: OSI Approved :: GNU General Public License v3 or later (GPLv3+)",
   "Operating System :: OS Independent",
   "Programming Language :: Python :: 3",
+  "Programming Language :: Python :: 3.10",
   "Programming Language :: Python :: 3.11",
   "Programming Language :: Python :: 3.12",
   "Programming Language :: Python :: 3.13",
+  "Programming Language :: Python :: 3.14",
   "Topic :: Software Development :: Documentation",
   "Topic :: Software Development :: Libraries :: Python Modules",
 ]
+# `requires-python` tracks the non-EOL CPython range; 3.10 goes EOL 2026-10-31.
+# Lower dependency bound is the version CI resolves and tests; anything older is
+# an untested compatibility claim. Upper bound is the next major (next minor for
+# 0.x, where that is the compatibility unit). msgpack floors above its own
+# advisory: 1.2.0 and earlier carry GHSA-6v7p-g79w-8964.
 dependencies = [
-  "click>=8.1,<10",
+  "click>=8.5,<9",
   "httpx>=0.28,<1",
-  "msgpack>=1.0,<2",
-  "pdfplumber>=0.11,<1",
-  "PyMuPDF>=1.24,<2",
-  "PyYAML>=6,<7",
-  "rapidfuzz>=3.9,<4",
-  "rich>=13,<15",
-  "textual>=1.0,<2",
-  "typer>=0.19,<1",
+  "msgpack>=1.2.1,<2",
+  "pdfplumber>=0.11.10,<1",
+  "PyMuPDF>=1.28,<2",
+  "PyYAML>=6.0.3,<7",
+  "rapidfuzz>=3.14,<4",
+  "rich>=15,<16",
+  "textual>=8.2,<9",
+  "typer>=0.27,<1",
 ]
 
 [project.scripts]
@@ -45,14 +52,10 @@ simdref-lsp = "simdref.lsp:main"
 
 [tool.setuptools]
 package-dir = {"" = "src"}
-include-package-data = true
 
 [tool.setuptools.packages.find]
 where = ["src"]
 
-[tool.setuptools.package-data]
-simdref = ["templates/*"]
-
 [tool.ruff]
 line-length = 100
-target-version = "py311"
+target-version = "py310"

{simdref-0.0.5 → simdref-0.0.7}/src/simdref/annotate.py

@@ -556,6 +556,17 @@ def arch_perf(record: InstructionRecord, arch: str) -> tuple[float | None, float
     return lat, cpi, kind
 
 
+def arch_perf_tag(arch: str, lat: float | None, cpi: float | None, kind: str) -> str:
+    """Provenance label for a perf row pinned to *arch*.
+
+    ``[missing:<arch>]`` when the catalog holds no latency and no CPI for
+    *arch*, so an empty row never reads as "measured to cost nothing".
+    """
+    if lat is None and cpi is None:
+        return f"[missing:{arch}]"
+    return f"[{arch}, {kind}]"
+
+
 def _ports_for(details: dict[str, Any]) -> str | None:
     measurement = details.get("measurement") or {}
     ports = measurement.get("ports") or measurement.get("TP_ports")
@@ -629,10 +640,7 @@ def format_annotation(
     if performance:
         if arch is not None:
             lat, cpi, kind = arch_perf(record, arch)
-            if lat is None and cpi is None:
-                tag = f"[missing:{arch}]"
-            else:
-                tag = f"[{arch}, {kind}]"
+            tag = arch_perf_tag(arch, lat, cpi, kind)
         else:
             summary = aggregate_perf(record, mode=agg, include_modeled=include_modeled)
             lat, cpi = summary.latency, summary.cpi