Zum Hauptinhalt springen
H

dsh-nvchecker

hougelangley/dsh-nvchecker

Checks upstream releases with nvchecker and reports recipes that are behind. Regenerates nvchecker.toml from an ABBS-style recipe tree, runs nvchecker, diffs every reported tag against the recipe's VER line, and writes a Markdown report. Never edits a recipe - version bumps stay a human decision, because nvchecker's use_max_tag sorts tags lexically and mis-picks year-style tags on repos that mix 2.8.15 with 20160726. Built for the AOSC OS loongarch64 third-party tree; reads the plain ABBS layout (section/pkg/spec with a VER= line).

Installation

dsh plugin --profile web add github:hougelangley/dsh-nvchecker

README

dsh-nvchecker

Host plugin for DeepSeek Harness that checks upstream releases with nvchecker and reports recipes that are behind.

Built for the AOSC OS loongarch64 third-party package tree (HougeLangley/aosc-loongarch64-thirdparty), but the recipe layout it reads is the plain ABBS one: <section>/<pkg>/spec with a VER= line.

What it does

  1. Regenerates nvchecker.toml from the recipe specs.
  2. Runs nvchecker and reads the JSON log stream (fd 2).
  3. Diffs each upstream version against the recipe's VER.
  4. Writes a Markdown report, by default to ~/build/logs/updates.md.

It never edits a recipe. Bumping versions stays a human decision, because nvchecker's use_max_tag sorts tags lexically and mis-picks year-style tags on repositories that mix 2.8.15 with 20160726 — see Known Limitations.

Config

FieldTypeDefaultMeaning
treeRootstring, required—Recipe tree, e.g. ~/build/tree/aosc-loongarch64-thirdparty/packages
nvcheckerBinstringnvcheckernvchecker executable
checkIntervalHoursnumber24Hours between checks; 0 disables the timer and runs once at activation
reportPathstring~/build/logs/updates.mdReport destination

One check runs at activation; the timer then repeats it.

Prerequisites

  • nvchecker on PATH (pip install nvchecker).
  • The generator script nvchecker-gen.py in <treeRoot>/../../../scripts/, and the recipe tree at the layout described above. Generate it once with the generator if it is missing.

Install

plugin_manager install_bundle  target=<absolute path to this directory>

Requirements the plugin must meet

Config implements Standard Schema, not a plain object. Cordis calls Config["~standard"].validate(config) before apply; a plain JSON Schema or a schemastery schema has no ~standard property, and activation fails with Cannot read properties of undefined (reading 'validate') even though the plugin's own code never throws.

nvchecker is resolved by absolute path. pip install --user puts it under ~/.local/bin, which is not on the Harness process PATH. Do not set nvcheckerBin in the bundle patch: an explicit value there overrides the absolute-path default and silently yields a report with 0 recipes checked and no error message.

Known Limitations and Deferred Work

  • Auto-bump is intentionally absent. use_max_tag mis-picks year-style tags: on pyenv it returns 20160726 instead of 2.8.15; on helm-docs it returns 19.0614 instead of 1.14.2. Two of three reported "updates" were wrong in the first field run.
  • Sub-path tag prefixes are not handled. A recipe whose SRCS uses tags/kustomize/v$VER reports v3.3.1 rather than 5.8.3. Resolving this needs a custom nvchecker source.
  • Non-numeric upstream tags are skipped, not guessed. The report lists them separately.
  • No UI. The plugin is Host-only and writes a file; it does not add a page or panel.

Ähnliche Plugins