Skip to content

Update from code changes: SymbolicVerifier DiagnosticResult (v5.3.0) - #249

Open
mintlify[bot] wants to merge 2 commits into
mainfrom
mintlify/cfa51465
Open

Update from code changes: SymbolicVerifier DiagnosticResult (v5.3.0)#249
mintlify[bot] wants to merge 2 commits into
mainfrom
mintlify/cfa51465

Conversation

@mintlify

@mintlify mintlify Bot commented Jul 28, 2026

Copy link
Copy Markdown
Contributor

Summary

Rewrites the Code engine reference around the new DiagnosticResult return contract shipped in QWED-Verification v5.3.0, and adds the corresponding changelog entry.

Changes

  • engines/code.mdx — rewritten around the DiagnosticResult contract. New sections cover the status/constraint_id cheat sheet, verification_mode (symbolic vs bounded_symbolic), why VERIFIED is intentionally never emitted, per-method developer_fields maps, and a before/after migration snippet. Removes references to the never-wired check_assertions parameter and the fictional check_security / check_types arguments.
  • advanced/symbolic-limits.mdx — updated result-field docs and examples to the DiagnosticResult shape, including the new constraint_id reason table and the fail-closed matrix for typed/untyped/no-function inputs.
  • changelog.mdx — new v5.3.0 entry noting the six migrated methods, the verification_mode field, the removal of check_assertions, and that this is the first engine to conform to the unified diagnostic model. Includes a legacy-to-new field cheat sheet, before/after snippet, and version-propagation table.

Context

Source PRs in QWED-Verification:

  • #212 migrate SymbolicVerifier to DiagnosticResult (Phase 1)
  • #220 remove unused check_assertions parameter
  • #239 add verification_mode
  • #240 migrate verify_bounded
  • #241 migrate get_verification_budget
  • #242 migrate analyze_complexity
  • #243 migrate verify_safety_properties
  • #244 release: v5.3.0

@codeant-ai

codeant-ai Bot commented Jul 28, 2026

Copy link
Copy Markdown

Skipping PR review because a bot author is detected.

If you want to trigger CodeAnt AI, comment @codeant-ai review to trigger a manual review.

@qwed-security

qwed-security Bot commented Jul 28, 2026

Copy link
Copy Markdown

QWED Security Verification Report

3 files scanned | 0 blocked | 0 warnings | 0 info | 0 suppressed | 3 verified

Engines

  • entropy_scan: ✅
  • pattern_scan: ✅

Verified Files

  • advanced/symbolic-limits.mdx
  • changelog.mdx
  • engines/code.mdx

Verified by QWED — deterministic security verification. No LLM used.

@mintlify

mintlify Bot commented Jul 28, 2026

Copy link
Copy Markdown
Contributor Author

Preview deployment for your docs. Learn more about Mintlify Previews.

Project Status Preview Updated (UTC)
qwed-ai 🟢 Ready View Preview Jul 28, 2026, 4:17 AM

@greptile-apps

greptile-apps Bot commented Jul 28, 2026

Copy link
Copy Markdown

Greptile Summary

Rewrites the SymbolicVerifier documentation for the v5.3.0 DiagnosticResult contract.

  • Migrates Code engine examples, status semantics, method-specific fields, and legacy field mappings.
  • Updates symbolic-execution limits and fail-closed examples for typed, untyped, bounded, and unavailable-analysis cases.
  • Adds v5.3.0 release notes, migration guidance, included implementation PRs, and artifact propagation claims.

Confidence Score: 3/5

The release documentation should not merge until the canonical installation page is synchronized with v5.3.0; the symbolic-limits reference also needs two non-blocking consistency fixes.

Announcing v5.3.0 while the Releases page still installs v5.2.0 can leave users running the legacy return contract against the new migration examples, and the symbolic-limits page contains contradictory and incomplete result guidance.

Files Needing Attention: changelog.mdx, advanced/symbolic-limits.mdx

Important Files Changed

Filename Overview
advanced/symbolic-limits.mdx Migrates examples and result documentation to DiagnosticResult, but retains contradictory Verified benchmark labels and omits bounds_transform_error from its reason tables.
changelog.mdx Announces v5.3.0 and its breaking API migration, while the canonical releases page still directs users to install v5.2.0.
engines/code.mdx Rewrites the Code engine reference around the six DiagnosticResult-returning SymbolicVerifier methods and removes fictional legacy options.

Comments Outside Diff (1)

  1. advanced/symbolic-limits.mdx, line 193-195 (link)

    P2 Benchmarks claim impossible VERIFIED results

    These benchmark rows label clean runs as “Verified,” contradicting the new contract that the engine always reports such runs as UNVERIFIABLE with symbolic_verifier.no_counterexample_found; this gives readers conflicting expectations about an impossible status.

Reviews (1): Last reviewed commit: "docs: tighten SEO descriptions on code e..." | Re-trigger Greptile

Comment thread changelog.mdx
Comment on lines +75 to +82
| Artifact | Previous | This release |
| --- | --- | --- |
| `qwed` (PyPI) | 5.2.0 | 5.3.0 |
| `qwed_sdk` (Python) | 5.2.0 | 5.3.0 |
| `@qwed-ai/sdk` (npm) | 5.2.0 | 5.3.0 |
| `qwed` (Rust crate) | 5.2.0 | 5.3.0 |
| API version marker | 5.2.0 | 5.3.0 |
| K8s deployment image | 5.2.0 | 5.3.0 |

Copy link
Copy Markdown

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

P1 Release page installs stale version

When users follow the newly announced v5.3.0 release to the canonical Releases page, its commands still install v5.2.0, causing them to run the legacy return contract against the new DiagnosticResult migration examples and encounter missing attributes or keys.

Comment on lines +85 to +95
<ResponseField name="developer_fields.constraint_id" type="string">
Structured reason code. One of:
- `symbolic_verifier.no_counterexample_found` — clean CrossHair run, still `UNVERIFIABLE` because completeness was not proven.
- `symbolic_verifier.counterexample_found` — CrossHair disproved a check.
- `symbolic_verifier.timeout` — verification did not converge within `timeout_seconds`.
- `symbolic_verifier.incomplete_coverage` — at least one function could not be checked.
- `symbolic_verifier.no_typed_functions` — no functions carried the type hints CrossHair requires.
- `symbolic_verifier.no_verifiable_functions` — the source contained no functions.
- `symbolic_verifier.syntax_error` — the code could not be parsed.
- `symbolic_verifier.crosshair_not_available` — the CrossHair engine is not installed.
- `symbolic_verifier.verification_error` — verification did not complete cleanly.

Copy link
Copy Markdown

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

P2 Reason tables omit bounded failure

Both authoritative-looking constraint_id lists omit symbolic_verifier.bounds_transform_error, even though verify_bounded() is documented to return it, leaving consumers without a complete set of reasons to handle.

@mintlify

mintlify Bot commented Jul 28, 2026

Copy link
Copy Markdown
Contributor Author

Preview deployment for your docs. Learn more about Mintlify Previews.

Project Status Preview Updated (UTC)
qwed-ai 🟡 Building Jul 28, 2026, 4:16 AM

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.

0 participants