Skip to content

docs(post-vulkan-drop): residual scrub + fix -Denable_vulkan=true (invalid Meson) → =enabled - #616

Merged
lusoris merged 1 commit into
masterfrom
docs/post-vulkan-drop-residual-scrub
Jun 4, 2026
Merged

lusoris merged 1 commit into
masterfrom
docs/post-vulkan-drop-residual-scrub

Conversation

@lusoris

@lusoris lusoris commented Jun 4, 2026

Copy link
Copy Markdown
Contributor

Fix list (audit findings)

Vulkan still listed as live post-ADR-0726 (residual after PR #607):

  • docs/ai/datasets/k150k.md:93 — --no-cuda description mentioned --no_vulkan: dropped (flag no longer exists post-ADR-0726)
  • docs/mcp/tools.md:198,205 — run_benchmark mentioned "CPU, CUDA, SYCL, and Vulkan" / "all four backends": replaced with "all compiled-in backends (CPU, CUDA, SYCL, HIP, Metal — Vulkan removed in ADR-0726)"
  • docs/api/index.md:26 — libvmaf_vulkan.h row listed as live: struck through and marked REMOVED per ADR-0726
  • docs/api/gpu.md:2,6,22,390–417 — page title, intro, "When these headers apply" Vulkan bullet (-Denable_vulkan=true → REMOVED note), and ## Vulkan status callout updated from live T5-1c to REMOVED

Meson feature option syntax (true is invalid for a feature option):

  • docs/api/index.md:26 — the Vulkan row is now tombstoned entirely (no Meson reference remains)
  • docs/api/gpu.md:22 — stale -Denable_vulkan=true bullet replaced with REMOVED notice

Already correct post-#607 (skipped):

  • docs/backends/index.md:113 — Vulkan row already marked "removed in ADR-0726"
  • docs/backends/vulkan/overview.md — already tombstoned
  • docs/backends/context-api-contract.md:18 — already notes vulkan was removed

ADR-0108 deliverables checklist

  • Research digest: no digest needed: docs scrub (audit-driven)
  • Decision matrix: no alternatives: only-one-way fix (literal text correction)
  • AGENTS.md invariant: no rebase-sensitive invariants
  • Reproducer: git grep -nE "(enable_vulkan=true|--no_vulkan)" -- docs/ai/datasets/k150k.md docs/api/index.md docs/api/gpu.md docs/mcp/tools.md returns 0 matches after this PR
  • CHANGELOG fragment: changelog.d/changed/post-vulkan-drop-residual-scrub.md
  • Rebase note: docs/rebase-notes.md (new entry at top)
  • state.md update: no bug closed/opened by this PR

Notes

docs/usage/vmaf-tune.md also has substantial Vulkan content (lines 304, 382–468)
that was NOT in the original audit list and was NOT touched in this PR — that is a
larger scrub and should be addressed in a follow-up.

ADRs, changelog fragments, research docs, and historical rebase-notes entries are
not modified per the CLAUDE.md policy on immutable-once-Accepted ADR bodies and
historical audit trails.

@lusoris
lusoris marked this pull request as ready for review June 4, 2026 01:40
Copilot AI review requested due to automatic review settings June 4, 2026 01:40
…valid Meson) → =enabled

Audit-driven scrub of stale Vulkan references that survived PR #607 (ADR-0726 final
Vulkan residual scrub):

- docs/ai/datasets/k150k.md: drop `--no_vulkan` from `--no-cuda` flag description;
  flag is no longer recognised by the vmaf binary post-ADR-0726.
- docs/mcp/tools.md (run_benchmark): replace "CPU, CUDA, SYCL, and Vulkan" / "all
  four backends" with "all compiled-in backends (CPU, CUDA, SYCL, HIP, Metal — Vulkan
  removed in ADR-0726)".
- docs/api/index.md: strike through the libvmaf_vulkan.h row and mark as removed per
  ADR-0726 (was still listed as a live header with `-Denable_vulkan=true`).
- docs/api/gpu.md: update page title, intro paragraph, "When these headers apply"
  bullet (drops `-Denable_vulkan=true` invalid Meson syntax, adds REMOVED note), and
  the `## Vulkan` section status callout from T5-1c live to REMOVED.

Files already correct post-#607 (skipped):
- docs/backends/index.md — line 113 already marked "removed in ADR-0726"
- docs/backends/vulkan/overview.md — already tombstoned
- docs/backends/context-api-contract.md — already notes vulkan removed

Co-Authored-By: Claude Sonnet 4.6 <noreply@anthropic.com>
@lusoris
lusoris force-pushed the docs/post-vulkan-drop-residual-scrub branch from f7fe6c0 to 1f27c88 Compare June 4, 2026 01:41
@lusoris
lusoris merged commit 74a9b99 into master Jun 4, 2026
14 of 18 checks passed
@lusoris
lusoris deleted the docs/post-vulkan-drop-residual-scrub branch June 4, 2026 01:41
@lusoris
lusoris removed the request for review from Copilot June 4, 2026 02:01
lusoris added a commit that referenced this pull request Jun 12, 2026
…CI) (#868)

* fix(codeql): resolve HIGH-severity security-cpp-high alerts (23 sites)

- cpp/integer-multiplication-cast-to-long (11): pre-cast one operand to
  size_t / double / ptrdiff_t before int*int multiplications in
  cambi.c, float_vif.c (log message), iqa/convolve.c (img_offset),
  moment.c, psnr.c, and vif_tools.c (four memcpy size expressions).
  Add stddef.h to convolve.c for ptrdiff_t.

- cpp/incomplete-parity-check (3): change `% 2 == 1` to `% 2 != 0`
  in vif_tools.c (assert), svm.cpp (powi loop), pdjson.c (JSON
  object key/value alternation). The == 1 form is wrong for negative
  operands; != 0 is always correct.

- cpp/wrong-type-format-argument (2): fix float_vif.c error log that
  printed size_t fields scaled_w/scaled_h with %d; change to %zu.

- cpp/world-writable-file-creation (1): in vmaf.cpp replace bare
  fopen("wb") with open(O_WRONLY|O_CREAT|O_TRUNC, 0644)+fdopen() on
  POSIX so the created file is never world-writable independent of the
  caller's umask. Add <fcntl.h>.

- cpp/path-injection (4): in test_output.c resolve the mkstemp-created
  path through realpath() immediately after creation, breaking the taint
  chain from getenv("TMPDIR") to the vmaf_write_output call site.

- cpp/toctou-race-condition (2): skipped — both sites are in test
  cleanup (RMDIR after stat assertion). The stat result drives a test
  assertion, not a security-sensitive access decision; no atomic
  replacement of open() is applicable to rmdir. Reported as skipped.

Co-Authored-By: Claude Fable 5 <noreply@anthropic.com>

* fix(codeql): resolve security-python-and-ci CodeQL alerts

Fixes 18 open CodeQL alerts across the Python and CI categories:

- yaml.github-actions.security.run-shell-injection (#661): move
  github.event_name, github.base_ref, and github.event.before from
  inline ${{...}} interpolation to env: vars in the SYCL clang-tidy
  detect step of lint-and-format.yml.

- python.lang.security.use-defused-xml-parse (#216, #217): replace
  xml.etree.ElementTree with defusedxml.ElementTree in
  feature_extractor.py and quality_runner.py; add defusedxml>=0.7.1
  to python/pyproject.toml and python/requirements.txt.

- py/undefined-export (#352, #353, #354, #616): restructure
  aiutils/__init__.py to do a conditional eager import of the parquet
  helpers so the names are defined when pyarrow is present, and only
  include them in __all__ when the import succeeded.

- py/stack-trace-exposure (#178, #179, #585): log exception detail
  server-side and return a generic message to the HTTP client in
  http_transport.py _handle_score (invalid JSON, bad params, scorer
  error branches).

- python.lang.security.audit.dangerous-subprocess-use-tainted-env-args
  (#227, #372): add shlex.quote() around user-supplied path arguments
  passed into shell strings in extract_ugc_features.py and
  test_bbb_e2e_v5_bug_cluster.py.

- py/file-not-closed (#677, #678): replace bare open() calls with
  context managers in test_coverage_round3.py.

- py/redundant-comparison (#427, #431): remove redundant
  assert not (x != y) lines that duplicate the preceding assert x == y.

- py/equals-hash-mismatch (#182): convert RdPoint to frozen=True
  dataclass so __eq__ and __hash__ are generated consistently.

- py/inheritance/signature-mismatch (#197): add result_dict=None
  default to EnsembleVmafQualityRunner._populate_result_dict so the
  signature is compatible with the base class.

- py/multiple-definition (#201): drop redundant assignment to
  feature_found in feature_extractor.py wildcard discovery path.

- py/str-format/surplus-named-argument (#204): remove unused
  dataset= kwarg from the format() call in routine.py.

Skipped: python.lang.security.audit.insecure-file-permissions (#373) —
  the Unix socket at 0o660 is intentional (Go sidecar node must write
  to it and runs as the same UNIX group); tightening to 0o644 would
  break the IPC channel.

Skipped: py/path-injection (#180, #181) — _validate_path() already
  resolves the path and checks it against an allowlist before any file
  operation; the data flow is secure and the CodeQL dataflow trace is a
  false positive on this allowlisted pattern.

Co-Authored-By: Claude Fable 5 <noreply@anthropic.com>

---------

Co-authored-by: Lusoris <lusoris@pm.me>
Co-authored-by: Claude Fable 5 <noreply@anthropic.com>
@lusoris lusoris added this to the 1.0.0 — First release milestone Sep 4, 2026
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

1 participant