Skip to content

chore(release): v0.26.1 URP Unification and Asset Indexing Parity - #191

Merged
PythonWoods-Dev merged 9 commits into
mainfrom
refactor/urp-unification
Jul 28, 2026
Merged

chore(release): v0.26.1 URP Unification and Asset Indexing Parity#191
PythonWoods-Dev merged 9 commits into
mainfrom
refactor/urp-unification

Conversation

@PythonWoods-Dev

Copy link
Copy Markdown
Contributor

Summary of Changes in v0.26.1

Architecture & Validation Parity

  • URP Unification (CORE-REFACTOR-003): Eradicated the legacy CLI link validation pipeline (validate_links_async). Both CLI and LSP now evaluate broken internal links exclusively via VSMBrokenLinkRule.check_vsm and PolyglotExtractor, achieving 100% true validation parity.
  • Asset Indexing Parity (CORE-REFACTOR-006): Upgraded the Virtual Site Map (VSM) builder to explicitly index non-Markdown static assets (e.g., .png, .webp, .html). This eradicates hardcoded directory workarounds and eliminates false-positive Z101 and Z104 findings for static assets across all adapters.
  • JSON Purity (CLI-FIX-001): Enforced absolute JSON purity when the --json flag is active by routing fail_under and suppression_cap failure messages to stderr. This prevents JSON.parse() failures in programmatic consumers.
  • MkDocs Asset URLs (CORE-FIX-002): Eradicated false-positive Z101 findings for static assets in MkDocs repositories by preventing the MkDocsAdapter from appending trailing slashes to non-Markdown files during VSM route generation.

Supply Chain Security & CI Updates

  • Absorbed dependabot workflow updates:
    • Bumped astral-sh/setup-uv to v9.0.0 across CI and release workflows.
    • Updated CodeQL action SHAs in .github/workflows/codeql.yml.

Quality & Governance Verification

  • Test Suite: 1496 unit tests passed.
  • Strict Verification: zenzic check all --strict passed with DQS 98/100 (Gate Passed).

…ets in MkDocsAdapter (CORE-FIX-002)

Static assets (.jpg, .png, .css, etc.) in MkDocs repositories were receiving use_directory_urls transformation in _map_url, producing routes like /blog/posts/hero/ instead of /blog/posts/hero.jpg. This caused false-positive Z101 findings for any link to a static asset.

Add the same DOC_SUFFIXES guard used by ZensicalAdapter: files whose suffix is not in DOC_SUFFIXES bypass use_directory_urls entirely and are mapped to their exact relative path.

fix(cli): route FAILED threshold and suppression-cap messages to stderr when --json is active (CLI-FIX-001)

When --json is active (output_format == 'json'), the FAILED threshold and suppression-cap messages were emitted to stdout via _shared.console.print(), polluting the JSON payload and breaking JSON.parse() in programmatic consumers (e.g. the VS Code extension CLI bridge).

Both failure messages now route to _shared.stderr_console when output_format is 'json', preserving POSIX separation: stdout carries only the JSON data contract, stderr carries human-readable diagnostics.

test(vsm): add five parametric asset URL cases to TestMkDocsAdapterMapUrl

Covers .jpg, .png, .css, and both use_directory_urls=true/false to guarantee the guard is stable regardless of config.

Signed-off-by: PythonWoods-Dev <gianluca.catalano@gmail.com>
Convert launch hero assets from JPEG to WebP, add named hero images for existing release posts, and normalize blog hero alt text to a consistent editorial pattern aligned with post titles.

Also add a new Hostile Precision article for the v0.24.0 to v0.26.0 editor trilogy using the previously unused trilogy asset, turning that image from a policy-exempt unused asset into a documented architectural narrative.

Verified with strict Zenzic checks on all modified posts.

Signed-off-by: PythonWoods-Dev <gianluca.catalano@gmail.com>
Move the 0.24.x and 0.25.x sections out of the main changelog into dedicated archive files, update the archive index, and record the unreleased v0.26.1 fixes and blog/media documentation updates in the active changelog.

Signed-off-by: PythonWoods-Dev <gianluca.catalano@gmail.com>
Signed-off-by: PythonWoods-Dev <gianluca.catalano@gmail.com>
Apply the formatting changes produced by verification so docs and tests stay aligned with repository style checks.

Signed-off-by: PythonWoods-Dev <gianluca.catalano@gmail.com>
Add SPDX sidecars for the blog image assets under docs/assets/images/blog so REUSE passes, and remove the ignored .draft workspace files from the Git index without deleting them locally.

Signed-off-by: PythonWoods-Dev <gianluca.catalano@gmail.com>
Signed-off-by: PythonWoods <gianluca.catalano@gmail.com>
Signed-off-by: PythonWoods <gianluca.catalano@gmail.com>
Signed-off-by: PythonWoods <gianluca.catalano@gmail.com>
@PythonWoods-Dev
PythonWoods-Dev merged commit 018177c into main Jul 28, 2026
9 checks passed
@PythonWoods-Dev
PythonWoods-Dev deleted the refactor/urp-unification branch July 28, 2026 08:09
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