# readable-verilog-generator

Adopt this skill: https://proskills.md/skills/other/eriemon-verilog-generator

Page: https://proskills.md/skills/other/eriemon-verilog-generator
This document is the public skill bundle for that page. It contains SKILL.md and every helper file the catalog carries. No login is required.

## File: SKILL.md
size: 21765
sha: 5f6cb9291a6d4706ef537af4ceb2846a3a763c94
upstream: https://github.com/eriemon/verilog-generator/blob/HEAD/SKILL.md

````text
---
name: readable-verilog-generator
description: >-
  Use when creating, writing, reviewing, annotating, repairing, refactoring, or validating readable Verilog RTL, including synthesizable Verilog-2001 .v files, existing-RTL analysis, semantic comment annotation, testbench scaffold planning, ASIC-quality review, local or remote Vivado/xsim validation, evidence-backed repair, and workflow trace diagnosis.
---

# Readable Verilog Generator

Generate, analyze, improve, and verify readable Verilog-2001 RTL through the bundled runtime under `scripts/python/`. Keep design RTL and verification testbenches in `.v` files, use `scripts/python/facade/verilog_api.py` for host integration, and treat formatter-AST and external-tool evidence as stronger than model self-assessment.

## Route

- `create/write`: confirm the design contract, then use `requirements -> codegen_plan -> spec_document -> python -> rtl`.
- `deep_review`: insert a non-empty structured review between the Python semantic model and RTL; it must cover interface, reset, timing/pipeline, handshake or FSM behavior, width, synthesis, testbench coverage, and risks.
- `review/analyze`: remain read-only and report the eight public gate states before suggesting changes.
- `annotate`: preserve an immutable normalized baseline, change only `//` comments, prove token equivalence from that baseline, and rerun the final deliverable gate.
- `repair/refactor`: bind the task to real RTL, reproduce or validate the issue, and apply the smallest evidence-backed change.
- `agentic_repair`: use the existing-RTL `verify_existing_verilog(...)` loop with an explicit `conservative`, `semi_auto`, or `auto_apply` choice.
- `validate`: collect static or external evidence without implicitly editing RTL.

- Load `references/workflows/verilog_dispatcher.md` before routing. Existing assets, logs, waveform clues, and mixed inputs use its read-only entry decision before any generation, validation, backup, or remote action.

## Install v2.0.0

The package root contains `install.ps1`, `install.sh`, and `install.bat` beside this `SKILL.md`. They share the package-local Python backend and read only the generated installer projection under `assets/installer/` plus the same-level bootstrap descriptor. Platform IDs, root resolution, target templates, status text, exit codes, transaction policy, and verification cases are data-driven by `config/installer/`; do not add platform branches or current test values to code or comments.

Install only from a versioned payload with the configured `RELEASE_RECEIPT.json`. Use `--DryRun`/`--dry-run` to validate without creating transaction resources; use replacement flags only when the target and overwrite intent are explicit. A transaction handles one platform and one target, preserves unlisted target files, writes an install receipt, and attempts rollback on failure. Unknown IDs and source directories without a valid release receipt fail closed. See `references/skill/installation.md` for the complete contract and parameterized invocation templates.

## Generate And Modify

1. Confirm module name, ports, clock/reset, behavior, pipeline expectation, interface family, and verification cases.
2. Use `regular` by default; use `deep_review` only when its extra review stage adds value; use `agentic_repair` only for existing RTL.
3. Generate a Python semantic model before RTL in the staged workflow and use it as the testbench semantic contract.
4. Select local interface and ADC/DAC family templates only when the confirmed design matches them; record every adaptation in the requirements and codegen plan.
5. Keep batch execution generation-only, with one run directory per confirmed spec. Do not use batch mode for existing-RTL mutation or decision resume.
6. Treat streaming as provider interaction only. The finalized response artifact remains the extraction source of truth.
7. Run the strict generated-deliverable gate before downstream use. Optional lint and testbench helpers never replace it.

Every module generated or modified by this skill must ship with a same-name `<module>_spec.md` companion. The canonical JSON contract accepts a single legacy module projection or a `modules` array, but each normalized module must declare a safe `.v` `rtl_path`, complete interface ports, clock/reset semantics, cycle behavior, constraints, corner cases, verification cases, and at least one `timing_diagrams` entry. A timing entry contains `id`, `title`, `scenario`, `description`, and WaveJSON with named signals. `python -m scripts.python.workflow.cli write-spec --spec <spec.json> --out-dir <artifact-root> [--source <rtl.v>] --language <zh|en>` writes `spec/<feature>/<module>_spec.md` plus sibling `spec/<feature>/waveforms/<module>_<scenario>.json5` and `.svg`. The `--source` form fails closed when a module or port is undeclared; the no-source form validates and renders only the confirmed spec and never infers behavior from RTL. All waveform rendering goes through the renderer runtime declared by the settings authority and fails closed when its configured Node/npm prerequisites, package identity, version, or executable are unavailable. A render failure stages diagnostics without overwriting the previous valid bundle.

The default profile is `erie_strict`. Its authoritative naming, bilingual header, region, FSM, comment, port-order, runtime-message, and formatter-AST rules live in `references/rules/verilog-code-comment-naming-standard.md`, `references/rules/erie-style.md`, `references/rules/verilog-comment-placement.md`, and machine-readable assets. Do not duplicate those rule catalogs in this entry document.

## Quality

Strict quality control is mandatory. ASIC quality review, independent static lint, and testbench scaffold are optional workflow steps selected only when the task needs their evidence. Optional helper tools are inside the workflow and never replace the generated-deliverable gate.

Generated deliverables must pass the formatter-backed gate with zero errors and zero strict warnings. The public result matrix is exactly `compile`, `ast`, `readability`, `comment`, `naming`, `profile`, `testbench`, and `toolchain`; static compile evidence does not imply that an external simulator, synthesis, or remote validation ran.

Verilog/SystemVerilog filenames must describe real function. Functional digits are valid; VG148 rejects only terminal version or meaningless numeric suffixes. A file recognized as a testbench by `tb_`, `_tb`, `testbench`, or an exact `tb`/`testbench`/`sim` directory must use the `tb_<function>.v` or `tb_<function>.sv` form; `_tb` is recognition evidence, not an allowed output name. When an ordinary design filename carries at least two independent testbench-content evidence groups, VG149 remains inconclusive until the user confirms `design` or `testbench` through `file_role_confirmations`. Confirming `testbench` does not waive the prefix rule: rename the file to the authority-selected `tb_<function>` form before it can pass. VG150 rejects configured workflow/evidence phrases on entity comments and high-confidence periodic unrelated tail families; it does not blacklist ordinary Chinese words or isolated functional descriptions. The full filename and comment contract lives in `references/rules/verilog-code-comment-naming-standard.md`, and gate/report semantics live in `references/rules/verilog-quality-gates.md`.

Use strict mode for new or modified deliverables. `--non-strict --warn-only` is limited to historical reference-corpus analysis and never approves generated output. The formatter backend under `scripts/python/quality/formatter_backend/` is the parser source for quality checks; do not add a second Verilog parser.

For comment-only work, normalize the original RTL once, annotate a copy, run the comment-only verifier with a required delta, run the final gate, and compare the final file again against the immutable baseline. Comments must not change RTL tokens, modules, ports, lvalues, resets, always targets, or instance connections. Reused generic entity comments do not satisfy semantic-comment coverage.

When `VG097` cannot see an external XPM, UNISIM primitive, or project-generated IP interface, first consult the exact-name AMD-Xilinx primitive catalog in `assets/xilinx_primitive_semantics.json` and its detailed contract in `references/rules/xilinx-primitive-exemptions.md`. Keep the result `inconclusive` until a governed pure-interface `.v` source is supplied through the repeatable `--external-interface-source` option when the name is not cataloged or the profile conflicts. Use the registered `quality.external-interface-extract` command for explicit vendor-source module whitelists and `quality.external-interface-manifest` for reviewed project-IP contracts. Never infer that an unknown width is a mismatch, and never use a stub or primitive profile as simulation, synthesis, implementation, or hardware evidence.

Generated RTL must remain synthesizable Verilog-2001. Prefer the governed interface templates for AXI-Stream, AXI4-Lite, AXI4, AHB, and APB; use complete combinational assignments and case defaults; avoid raw gated clocks; document CDC/reset assumptions; keep datapath and control timing-reviewable; and avoid generated `function` or `task` blocks when explicit logic is clearer for waveform debug. Every FSM must use three independent processes for the state register, procedural combinational next-state logic, and state output/task logic; a continuous `assign` to any next-state signal is forbidden. Every continuous or procedural combinational target must pass both the transitive source-cone limit and the configured real-operation budget, each defaulting to at most three. VG146/VG147 evaluate the complete source closure: formatter structured port associations bind child outputs into the parent cone, parameter/localparam specialization selects the materialized implementation, and each definition root, full instance path, specialization fingerprint, and static target remains an independent report identity. Output connections expand through known implementations; inout and unresolved-net boundaries never invent reverse ownership; all known wire/tri drivers are merged; and a clocked output Q cuts upstream expansion while its D input remains checked. The operation budget covers unary, binary, ternary, comparison, selector, control-decode, continuous-assign, combinational-process, clocked D-input, and elaborated `for` operations. Moving logic into `always @(*)` or directly into a clocked D expression does not bypass either gate. If `loop_presence=unknown`, VG146 and VG147 both apply and share the same lower-bound evidence: an over-limit known lower bound fails both, otherwise both remain inconclusive. When the operation budget fails, recommend pipeline registers, registered flags or predecode, or a multicycle FSM decomposition first, and disclose that these changes may alter visible latency; immutable-latency protocols require manual architecture review. Only an exact output bridge from an output port to a clocked internal `_o` `reg` is exempt from the source-cone rule. Detailed VG rules and ASIC review criteria remain authoritative in `references/rules/verilog-quality-gates.md` and `references/rules/asic-verilog-quality.md`.

VG151-VG155 provide module-independent structural contracts. Parameter constraints are selected automatically from the identifiers in each restricted expression; `module`, `instance`, `hierarchy`, and `scope` fields are invalid. VG152 reports large dynamically selected packed storage with a configurable positive threshold and offers structured case/FSM, inferred-memory, or vendor-memory alternatives. VG153/VG154 expose read-without-driver and unused declaration evidence, including reg/wire/function/task facts. VG155 uses explicit top-level ready-valid role facts and requires both valid and ready for a transfer consumer; no target module name is part of these contracts.

Before generating or repairing declarations, apply VG156-VG158 as design-time naming and comment constraints, not only as a final audit. VG156 checks every module/function/task variable declaration by underscore token: a token containing digits is valid only when its complete case-insensitive text appears in the governed protocol/algorithm/rate allowlist. VG157 forbids ordinary-comment version markers such as `v2` or `version 3`; only the formatter-recognized fixed bilingual header and revision-history range is exempt. VG158 repeatedly removes the governed direction/type prefixes and `_o`, then requires at least one functional token outside the closed meaningless-token set; unknown domain terms pass. The formatter must assign each declaration to exactly one region using the shared conflict priority, place the first group comment directly below its banner, place later group comments after exactly one blank line, leave no empty group, keep one trailing blank line per non-empty region, and produce byte-identical output on the second pass.

## Existing RTL

- `analyze_existing_verilog(...)` owns structural analysis and durable design explanation.
- `improve_existing_verilog(...)` owns controlled testbench, style, partition, merge, and optimization assist flows.
- `compare_verilog_semantics(...)` owns equivalence, QoR, and transform-validation evidence.
- `verify_existing_verilog(...)` owns log-driven verification, diagnosis, candidate patches, confirmation resume, and terminal closure.

`optimize_assist` and `merge_assist` are assist-only by default and never silently accept or rewrite source RTL. `conservative` is report-only; `semi_auto` requires confirmation before overwrite; `auto_apply` is valid only after explicit selection and still downgrades non-eligible patch classes to confirmation. Preserve source and testbench backups, diff and decision artifacts, diagnostics, and terminal status exactly as specified by `references/workflows/workflow-contracts.md` and `references/integration/host-integration.md`.

Existing-RTL diagnostic comment findings are advisory so compile, semantic, interface, and high-confidence lint failures remain visible. A report file being written is not success; blocker, warning, failed, toolchain, external-validation, or confirmation-blocked terminal states remain non-success.

## Dependencies And External Evidence

Run dependency preflight before first use and before remote, Vivado, or Vitis work. Missing required dependencies require user approval before installation; if declined, continue only with self-contained static Verilog work and block remote/execute/implement claims. The required skill dependency remains `erie-remote-ssh`; the optional context-engineering group is the only recommended external skill group. No additional external skill suite is included. The required external renderer dependency, package identity, version, executable, and Node/npm floor are read from the settings authority; use `scripts/python/toolchain/wavedrom_runtime.py` with the `check`, `install --yes`, or `render` subcommand, never an ad-hoc package command. Prefer `vivado-developer` and `vitis-developer` for AMD-Xilinx, and `pds-developer` for PangoMicro. FPGA-Agent-Skills remains an explicit manual fallback.

Compile, execute, simulation, synthesis, or implement readiness requires actual external evidence. Remote validation is preferred and must use `erie-remote-ssh`, a user-confirmed server, local-only server selection/configuration, and the remote workdir's `.settings/verilog.remote.json`. A configured default is only a recommendation. Multiple Vivado settings candidates require user selection. Do not silently fall back to local tools and do not add direct SSH/SCP logic.

Remote validation runs are retained by default, including fixed remote-fixture reports. Cleanup occurs only when explicitly requested. Vivado xsim is the preferred simulator backend, followed by VCS+Verdi and then iverilog/vvp; yosys is implement-readiness evidence only. VCS+Verdi support is scripted backend invocation, not full GUI/session automation.

## Document And Command Registry

Registration is enabled for this skill. Markdown remains the authoritative knowledge source. Editable command records live under `config/registry/commands/`; document responsibilities and search metadata have one owner in `config/registry/documents/catalog.json`; current duplicate and interface decisions live in `config/registry/governance/reviews.json`; `config/registry/registry.sqlite3` is a generated local FTS5 trigram index at the location required by the agents-md-generator gate. The skill runtime is self-contained and must not import or call an external `agents-md-generator` registry implementation.

Document governance scans `SKILL.md` and every Markdown file below `references/`, recursively. It records one responsibility per document, knowledge pointers, exact and fuzzy duplicate adjudications, interface mappings, and content hashes. Remove only confirmed equivalent duplication; preserve structural repetition and every unique contract. Installed copies may query and check but must not mutate registry sources.

Detailed command syntax, examples, prerequisites, outputs, exit codes, risk warnings, and relations are retrieved from the local registry:

```text
python -m scripts.python.registry.query_registry ask "<question>" [--kind <kind>] [--category <name>] [--limit 1..10] [--json]
```

The query is read-only and never executes returned commands. Exit codes are `0` for hits, `1` for no match, `2` for request errors, and `3` for a missing, corrupt, stale, or incompatible index. After JSON source changes, use registry instruction `registry.build`; never edit SQLite by hand. See `references/skill/script-guide.md` for the compact registry lifecycle.

## Verify

The first outer command group is the generated-deliverable gate:

```text
python -m scripts.python.validation.generated_deliverable_gate <rtl-file-or-dir> --json <report.json> --markdown <report.md>
```

When either report option is omitted, the CLI writes both reports under the caller's current working directory: `reports/readable/deliverable_gate.json` and `reports/readable/deliverable_gate.md`. The focused quality CLI follows the same policy with `quality_gate.json` and `quality_gate.md`. Supplying one explicit path only overrides that format; JSON and Markdown paths must resolve to different files. Runtime reports must never be written back to the source or installed skill root.

Both CLIs publish v3 reports and print compact `[Python]` finding lines containing the VG rule, status, confirmed location, concrete problem, and direct fix instruction. The JSON and Markdown files contain the full evidence, ordered repair steps, risk and human-review obligation, plus bad/good examples. Exit code `1` means the gate found RTL issues; exit code `2` means invocation, diagnostic-contract, or report-publication failure.

The second outer command group is package validation:

```text
python -m scripts.python.validation.validate_verilog_skill --settings .\config\defaults.json
```

Run the smallest relevant checks while editing, then the governed final chain. The extended repository-regression, external-audit, and remote variants live in `references/integration/configuration.md` and registry instruction `validation.skill`. Local success does not replace requested remote pytest, simulator, synthesis, or installed-copy evidence. Never claim an unrun check passed.

## Resources

- `references/skill/script-guide.md`: registry query, build, document-governance, and command-category contract.
- `references/workflows/verilog_dispatcher.md`: task classification, public gate matrix, and safe repair boundary.
- `references/workflows/workflow-contracts.md`: run artifacts, statuses, resume behavior, and trace semantics.
- `references/integration/configuration.md`: paths, dependencies, remote settings, and validation configuration.
- `references/integration/host-integration.md`: facade functions and host-owned execution boundaries.
- `scripts/python/workflow/spec_document.py`: strict module contract, source cross-check, Markdown and WaveDrom bundle writer.
- `scripts/python/toolchain/wavedrom_runtime.py`: pinned Node/npm/WaveDrom check, explicit install, and SVG renderer.
- `references/rules/verilog-code-comment-naming-standard.md`: canonical readable RTL rule text.
- `references/rules/verilog-quality-gates.md`: VG catalog and report semantics.
- `references/rules/xilinx-primitive-exemptions.md`: exact AMD-Xilinx UNISIM/XPM/project-IP primitive inventory and VG097/VG132/VG146/VG147 boundary contract.
- `references/rules/asic-verilog-quality.md`: ASIC quality review criteria and risk boundaries.
- `references/rules/testbench-patterns.md`: self-checking testbench scaffold patterns.
- `references/checklists/lint-checklist.md`: independent static lint review checklist.
- `references/corpus/verilog-style-observations.md`: empirical ideal/bad corpus observations that do not override normative rules.
- `references/checklists/verilog-readability-gate.md`: final human review.
- `references/skill/skill-standards.md`: skill packaging and progressive-disclosure requirements.

## Boundaries

- Do not generate non-Verilog hardware flows, C/C++ kernels, or alternate RTL dialects.
- Do not invent source RTL, testbenches, logs, successful tool evidence, or repair confirmation.
- Do not store caller run artifacts inside the skill; use caller-selected directories such as `reports/`.
- Do not let optional helpers, model reviews, or registry query results replace actual quality or toolchain evidence.
````

## File: assets/use_case_templates/jesd_adc/README.md
size: 699
sha: fa7ef93228c835f49c70ea8c19b0f917c68889a5
upstream: https://github.com/eriemon/verilog-generator/blob/HEAD/assets/use_case_templates/jesd_adc/README.md

```text
# JESD ADC Use-Case Template

This bundle captures the recurring JESD204 receive pattern used by JESD ADC projects such as AD6676.

## Scope

- JESD204 RX transceiver and link bring-up
- Transport receive and channel packing
- DMA-backed ADC capture
- Board-level top and block-design scaffolding

## Parameterization Points

- RX lane count
- Number of converters
- Sample width and samples per frame
- Reference clock routing
- Board family and DMA interconnect

## Provenance Notes

- `common_bd.tcl` is distilled from the receive-side structure used by AD6676.
- `system_top.v` is a compact board-facing wrapper that exposes JESD RX sideband clocks and valid/data output.
```

## File: assets/use_case_templates/jesd_dac/README.md
size: 745
sha: 502d401511c02756be034f9e2b78baf7afc1e932
upstream: https://github.com/eriemon/verilog-generator/blob/HEAD/assets/use_case_templates/jesd_dac/README.md

```text
# JESD DAC Use-Case Template

This bundle captures the recurring JESD204 transmit pattern used by JESD DAC projects such as DAC_FMC_EBZ and the transmit side of DAQ3.

## Scope

- JESD204 TX transceiver and link bring-up
- Transport feed through upack and DAC FIFO
- DMA-backed waveform playback
- Board-level top and block-design scaffolding

## Parameterization Points

- TX lane count
- Number of converters
- Sample width and samples per frame
- FIFO depth and DMA width
- Board family and transceiver settings

## Provenance Notes

- `common_bd.tcl` keeps the TX-side structure used by DAC_FMC_EBZ and DAQ3.
- `system_top.v` is a compact board-facing wrapper that exposes a waveform push input and lane clock output.
```

## File: assets/use_case_templates/mxfe_mixed/README.md
size: 739
sha: 18a8bef3ab517e02a0af74adf0ed82e80c58f69e
upstream: https://github.com/eriemon/verilog-generator/blob/HEAD/assets/use_case_templates/mxfe_mixed/README.md

```text
# MxFE Mixed Use-Case Template

This bundle captures the recurring mixed RF ADC and RF DAC pattern used by MxFE projects such as AD9081 X-band designs.

## Scope

- Coordinated RX and TX JESD paths
- Shared RF transceiver tuning parameters
- PMOD and FMC control sideband buses
- TDD synchronization and enable signals

## Parameterization Points

- RX and TX lane rates
- Number of links
- RX and TX samples per channel
- PMOD or FMC control bus widths
- TDD enable and synchronization strategy

## Provenance Notes

- `common_bd.tcl` keeps the board-level orchestration pattern used by AD9081 X-band flows.
- `system_top.v` is a compact wrapper that exposes RX and TX status, PMOD control, and TDD sideband hooks.
```

## File: assets/use_case_templates/spi_adc/README.md
size: 925
sha: 0da76651bc534d6db616fde921dbc125d4735418
upstream: https://github.com/eriemon/verilog-generator/blob/HEAD/assets/use_case_templates/spi_adc/README.md

```text
# SPI ADC Use-Case Template

This bundle captures the recurring board-level pattern used by SPI ADC projects such as AD40xx, AD469x, and AD7134.

## Scope

- Triggered or periodic ADC conversion launch
- SPI Engine style serial control path
- BUSY edge capture or ODR handoff
- DMA-backed sample collection into processor memory

## Parameterization Points

- ADC resolution and packed sample width
- Number of channels or SDI lanes
- Sampling rate and SPI reference clock
- Trigger policy: CNV pulse, ODR, or BUSY edge
- Board family and GPIO banking

## Provenance Notes

- `system_top.v` is distilled from the top-level wiring style used by AD469x-class SPI ADC projects.
- `common_bd.tcl` combines the CNV/BUSY gating and DMA structure used across AD40xx, AD469x, and AD7134.
- `system_bd.tcl` and `system_project.tcl` keep only the reusable board flow skeleton and remove project-specific noise.
```

## File: assets/use_case_templates/spi_dac/README.md
size: 757
sha: 5cfd2648a1b546c7f3555c80bc3878c3020339fc
upstream: https://github.com/eriemon/verilog-generator/blob/HEAD/assets/use_case_templates/spi_dac/README.md

```text
# SPI DAC Use-Case Template

This bundle captures the recurring board-level pattern used by SPI DAC projects such as AD5758 and AD5766.

## Scope

- SPI DAC register and streaming control
- Optional cyclic DMA feed for playback
- GPIO sideband control such as fault, reset, and LDAC
- Board-level top and block-design scaffolding

## Parameterization Points

- DAC sample width
- Number of DAC channels
- DMA cyclic policy
- GPIO sideband presence
- Board family and voltage standard

## Provenance Notes

- `system_top.v` follows the DAC sideband wiring style used by AD5758.
- `common_bd.tcl` keeps the SPI Engine and DMA structure used by AD5766.
- The project and constraint files are distilled to the minimum reusable skeleton.
```

## File: README.md
size: 8422
sha: 5ab33bfb247e2a673aec29380ed95ad7a8e42512
upstream: https://github.com/eriemon/verilog-generator/blob/HEAD/README.md

````text
<p align="center">
  <a href="README.md"><strong>English</strong></a>
  <span>&nbsp;|&nbsp;</span>
  <a href="README-CN.md">Chinese</a>
</p>

<p align="center">
  <img src="assets/readme/hero-overview.png" alt="Verilog Generator: from RTL intent to reviewable delivery" width="100%">
</p>

<p align="center">
  <a href="LICENSE"><img alt="Apache-2.0 license" src="https://img.shields.io/badge/license-Apache--2.0-2ad4ee"></a>
  <img alt="VERSION v2.0.0" src="https://img.shields.io/badge/version-v2.0.0-8ce85d">
  <img alt="Verilog-2001" src="https://img.shields.io/badge/RTL-Verilog--2001-ffb85c">
  <img alt="Agent skill" src="https://img.shields.io/badge/target-agent%20skill-8ce85d">
</p>

<p align="center">
  <strong>Readable RTL → clear behavior → reviewable delivery</strong><br>
  Give AI the design intent, review the behavior preview, and receive artifacts you can inspect and verify.
</p>

Verilog Generator is an agent skill for practical Verilog-2001 work. It helps you create a module from a clear requirement, understand an existing RTL design, add semantic comments, repair a problem from real diagnostics, and run the checks that your task actually needs.

## What it does

- Turn a module requirement into readable, synthesizable Verilog-2001 RTL.
- Explain an existing module through its ports, clock/reset behavior, state, timing, and data flow.
- Add or improve semantic comments without silently changing RTL behavior.
- Repair an existing design against a compiler, linter, simulator, or tool log.
- Prepare a testbench scaffold or request real simulation results when the environment is available.

The skill keeps results honest: a static review, a simulation, a synthesis run, and a hardware result are reported separately. A check that did not run is never presented as a completed result.

## Install

> Ask your AI to install the skill from https://github.com/Eriemon/verilog-generator.

After installation, call the skill in the same conversation with `$readable-verilog-generator` or describe the Verilog task directly.

The v2.0.0 release package also includes `install.ps1`, `install.sh`, and `install.bat` beside `SKILL.md` for manual installation. Supported Harness targets are Codex (`codex`), Claude (`claude`), Gemini (`gemini`), and DeepSeek (`deepseek`). From the release directory, preview and install with one of these commands:

```text
.\install.ps1 -Platform codex -DryRun -Json
.\install.ps1 -Platform codex -Json
```

```bash
./install.sh --platform codex --dry-run --json
./install.sh --platform codex --json
```

```bat
install.bat -Platform codex -DryRun -Json
install.bat -Platform codex -Json
```

Real wrapper writes automatically back up an existing target before replacement; `DryRun` never writes. Source directories without the configured release receipt are rejected. See `references/skill/installation.md` for the parameterized contract.

## Before you start

Prepare only the material that matches your task:

![What to prepare for a Verilog task](assets/readme/project-facts.png)

- **New module:** purpose, module name, ports, clock and reset semantics, cycle-by-cycle behavior, protocol rules, boundary cases, and the checks you expect.
- **Existing RTL review:** the `.v` files, relevant testbench or integration context, and the questions or risks you want reviewed.
- **Commenting or repair:** the original RTL, the diagnostic or log, the intended behavior, and whether the change must be comment-only or may change logic.
- **Simulation or external validation:** a usable testbench with expected outcomes, the simulator/tool environment, and any required project or remote access.

If something important is missing, the skill asks for it before making a consequential change.

## How to call it

Use a normal request. These examples are ready to adapt:

```text
Use $readable-verilog-generator to create a Verilog-2001 AXI-Stream packet counter.
First ask for any missing interface and timing details, then show me the module spec
and WaveDrom behavior preview before generating RTL.
```

```text
Use $readable-verilog-generator to review this RTL for reset behavior, handshake
errors, width issues, naming, comments, and synthesis risks. Do not modify the file.
```

```text
Use $readable-verilog-generator to add semantic comments to this Verilog file.
Preserve every RTL token and show the comment-only verification result.
```

```text
Use $readable-verilog-generator to diagnose and repair this module from the
attached simulator log. Show the proposed change and validation results first.
```

## Preview and confirm before generation

For a new module or a behavior-changing repair, ask for a preview before asking AI to write the final RTL. The preview should make these decisions visible:

![Preview and confirmation before generation](assets/readme/design-profile.png)

1. Interface, port directions, widths, clock, and reset behavior.
2. State transitions, handshake conditions, data-path timing, and corner cases.
3. At least one WaveDrom scenario that shows the intended cycle behavior.
4. The checks that will be run and what each result can prove.

Confirm the preview only after the behavior matches your intent. If it does not, revise the requirement and preview again; do not treat an unconfirmed interpretation as the final design.

## What you receive

Depending on the request, the handoff can include:

![What you receive after the task](assets/readme/rule-rendering.png)

- readable Verilog-2001 source (`.v`);
- a same-name module specification (`<module>_spec.md`);
- WaveDrom behavior files (`.json5` and rendered `.svg`);
- a testbench scaffold or updated testbench when requested;
- review, repair, static-check, simulation, or tool reports showing only checks that actually ran;
- a concise explanation of remaining assumptions, warnings, and unverified areas.

## Review and deliver

![Reviewable delivery](assets/readme/evidence-guard.png)

Review the generated files and the checks that actually ran before accepting the handoff. Keep assumptions and unverified areas visible.

## Example result

The example below is a 32-bit AXI-Stream meter. It counts bytes only after a `TVALID`/`TREADY` transfer, counts packets on a transferred `TLAST`, and saturates instead of wrapping.

```verilog
// AXI-Stream transaction detection
assign flag_transfer = i_axis_tvalid & i_axis_tready;
assign flag_packet_end = flag_transfer & i_axis_tlast;

always@(posedge i_axis_aclk or negedge i_axis_arstn)begin
	if(i_axis_arstn == 1'b0)begin
		cnt_packet_o <= 32'd0;
	end else if(i_clear == 1'b1)begin
		cnt_packet_o <= 32'd0;
	end else if(flag_packet_end == 1'b1)begin
		if(data_frame_sum[32] == 1'b0)begin
			cnt_packet_o <= data_frame_sum[31:0];
		end else begin
			cnt_packet_o <= 32'hFFFF_FFFF;
		end
	end
end
```

**[Open the complete commented source →](assets/examples/readme/axis_packet_meter.v)**

| Example check | Result |
| --- | ---: |
| Formatter AST | `PASS` |
| Readability, comments, naming, profile | `PASS` |
| Errors | `0` |
| Strict warnings | `0` |

> This is an example static result for the published sample. It does not claim that a simulator, synthesis tool, hardware target, or remote environment ran.

## Authors and citation

Jiyuan Liu and He Li · Southeast University（东南大学）· HIQC (Heterogeneous Intelligence and Quantum Computing Laboratory)

If this skill supports your research, teaching, or engineering work, cite [CITATION.cff](CITATION.cff).

```bibtex
@software{liu_2026_verilog_generator,
  author       = {Jiyuan Liu and He Li},
  title        = {{Verilog Generator}: An Agent Skill for Verilog-2001 RTL Workflows},
  year         = {2026},
  version      = {2.0.0},
  date         = {2026-08-12},
  url          = {https://github.com/Eriemon/verilog-generator},
  license      = {Apache-2.0},
  note         = {Agent skill for readable Verilog-2001 RTL workflows}
}
```

---

<p align="center">
  <a href="SKILL.md">Skill details</a>
  <span>&nbsp;&bull;&nbsp;</span>
  <a href="LICENSE">Apache License 2.0 (Apache-2.0)</a>
  <span>&nbsp;&bull;&nbsp;</span>
  <a href="CITATION.cff">Citation</a>
  <span>&nbsp;&bull;&nbsp;</span>
  <a href="mailto:<REDACTED_EMAIL>">Contact</a>
</p>
````

## File: scripts/__init__.py
size: 53
sha: 5049e977b4fc06b23f8ec9f6bee31bc061b655a6
upstream: https://github.com/eriemon/verilog-generator/blob/HEAD/scripts/__init__.py

```text
"""readable-verilog-generator 的脚本包根。"""
```

## File: scripts/python/__init__.py
size: 55
sha: 8e1a5466b1f80e3737ef0c5d2f94435a6f15fef2
upstream: https://github.com/eriemon/verilog-generator/blob/HEAD/scripts/python/__init__.py

```text
"""按工作流域划分的 Python 入口集合。"""
```

## File: scripts/python/corpus/analyze_verilog_style_corpus.py
size: 25922
sha: 4e0dd80cef3559932ab91681963c7a58d25a4746
upstream: https://github.com/eriemon/verilog-generator/blob/HEAD/scripts/python/corpus/analyze_verilog_style_corpus.py

```text
#!/usr/bin/env python3
"""从理想和反例 Verilog 语料中提取可复现的风格统计指标。"""

# future annotations 让类型提示保持静态用途，不影响脚本运行时兼容性。
from __future__ import annotations

# 标准库负责 CLI 参数、JSON 写入、正则提取、统计量和路径遍历。
import argparse
import json
import re
import statistics
import sys
from pathlib import Path
from typing import Any, Iterable

# 批量治理脚本不应在源码目录旁生成 __pycache__。
sys.dont_write_bytecode = True  # 关闭当前脚本运行时的 pyc 写入

# Verilog 源文件后缀集中维护，供目录递归筛选复用。
SET_VERILOG_SUFFIXES = {".v", ".vh"}  # 允许进入语料统计的 Verilog 文件后缀

# 端口声明正则保留旧脚本对 input/output/inout 行的宽松识别。
RE_PORT_DECL = re.compile(  # 端口声明行匹配器
    r"^\s*(input|output|inout)\b(?P<body>.*?)(?:,|;)?\s*(?://.*)?$",  # 捕获方向后的声明主体
    re.MULTILINE,  # 允许从完整源码文本中逐行查找端口声明
)

# 标识符正则用于端口名和参数名的轻量文本提取。
RE_IDENTIFIER = re.compile(r"[A-Za-z_][A-Za-z0-9_$]*")  # Verilog 普通标识符匹配器

# 区域横幅只统计 Erie 模板认可的中文区域名称。
STR_REGION_BANNER_PATTERN = (
    r"//[-\s]*(?:配置参数区域|状态参数区域|模块实例化信号|计数信号|状态机信号|"
    r"寄存器信号|标志信号|编码信号|译码信号|其他信号|输出信号|其他信号连线|"
    r"输出信号连线|输出信号处理区域|状态机区域|状态任务处理区域|主要任务处理区域|"
    r"生成块区域|参数检查区域|初始化区域|模块实例化区域)[-\s]*//"
)  # 中文区域横幅正则文本

# 区域横幅正则单独编译，避免每个文件重复解析长表达式。
RE_REGION = re.compile(STR_REGION_BANNER_PATTERN)  # 中文区域横幅匹配器

# 占位注释命中会降低风格分，帮助暴露模板未清理痕迹。
RE_PLACEHOLDER_COMMENT = re.compile(  # 占位或模板化注释匹配器
    r"(?:端口信号注释|参数解释说明中文|默认值,?参数解释|必须要有的注释|此模板未使用|占位|placeholder)",  # 占位词组集合
    re.IGNORECASE,  # 同时识别英文 placeholder 的大小写变体
)

# Verilog 端口方向关键字不能被误当成端口名。
SET_PORT_DIRECTIONS = {"input", "output", "inout"}  # 端口方向关键字集合

# 读取语料时按项目常见编码优先级尝试。
TUPLE_TEXT_ENCODINGS = ("utf-8", "utf-8-sig", "gb18030", "latin-1")  # 语料读取编码候选

# 输出报告的数值字段顺序保持旧 JSON 结构。
TUPLE_METRIC_FIELDS = (
    "lines",  # 源文件总行数指标
    "code_lines",  # 非注释代码行数指标
    "comment_lines",  # 含有 // 的行数指标
    "comment_density",  # 注释相对代码行的密度指标
    "tab_indented_lines",  # tab 缩进行数指标
    "space_indented_lines",  # 空格缩进行数指标
    "block_comment_markers",  # 块注释边界标记数量指标
    "ports",  # 端口声明数量指标
    "prefixed_ports",  # 带项目前缀端口数量指标
    "parameters",  # parameter 声明数量指标
    "c_parameters",  # C_ 前缀参数数量指标
    "region_banners",  # 中文区域横幅数量指标
    "has_bilingual_header",  # 双语头部是否存在的二值指标
    "placeholder_comment_hits",  # 占位注释命中数量指标
    "always_blocks",  # always 块数量指标
    "assigns",  # assign 语句数量指标
)  # summary 区域逐项统计的指标字段

# create_parser 只声明公开 CLI，不读取文件。
def create_parser() -> argparse.ArgumentParser:
    """
    创建 Verilog 风格语料分析脚本的参数解析器。

    :param: 此函数不接收外部业务参数。
    :return: 已注册 ideal、bad、out 和 sample-size 参数的解析器。
    """

    # 描述文本沿用英文，保持既有 --help 风格。
    str_description = "Analyze style metrics from ideal/bad Verilog corpora."  # argparse 描述文本

    # parser 只承担命令行合同声明职责。
    parser = argparse.ArgumentParser(description=str_description)  # 语料分析参数解析器

    # ideal 指向正例语料根目录或单文件。
    parser.add_argument("--ideal", type=Path, required=True, help="Path to ideal Verilog corpus.")

    # bad 指向反例或压力语料根目录或单文件。
    parser.add_argument("--bad", type=Path, required=True, help="Path to bad/stress Verilog corpus.")

    # out 是 JSON 指标报告写入位置。
    parser.add_argument("--out", type=Path, required=True, help="Output JSON metrics path.")

    # sample-size 控制低风格分样本数量。
    parser.add_argument(
        "--sample-size",
        type=int,
        default=10,
        help="Number of lowest-style-signal samples to retain.",
    )

    # 返回完整解析器给 main 调用。
    return parser

# iter_sources 统一处理单文件和目录语料输入。
def iter_sources(path_root: Path) -> Iterable[Path]:
    """
    按稳定顺序产出输入根下的 Verilog 源文件。

    :param path_root: 语料根目录或单个 Verilog 文件路径。
    :return: 可迭代的 Verilog 源文件路径序列。
    """

    # 单文件输入只在后缀受支持时产出自身。
    if path_root.is_file():

        # 后缀判断使用小写以兼容大写扩展名。
        if path_root.suffix.lower() in SET_VERILOG_SUFFIXES:

            # yield 保持旧脚本对单文件输入的惰性行为。
            yield path_root

        # 单文件路径处理完毕后不再递归。
        return

    # 目录输入按路径名排序，保证报告可复现。
    for path_source in sorted(path_root.rglob("*")):

        # 只统计真实文件，跳过目录和非 Verilog 文本。
        if path_source.is_file() and path_source.suffix.lower() in SET_VERILOG_SUFFIXES:

            # 将候选源文件交给后续指标提取。
            yield path_source

# read_text 以多编码尝试读取语料，避免单个遗留文件中断统计。
def read_text(path_source: Path) -> tuple[str, str]:
    """
    读取 Verilog 文本并返回实际采用的编码名称。

    :param path_source: 待读取的 Verilog 文件路径。
    :return: 二元组，包含源码文本和解码编码标签。
    """

    # 原始字节只读取一次，后续在内存中尝试不同编码。
    bytes_raw = path_source.read_bytes()  # Verilog 文件原始字节

    # 编码候选按最常见到最兜底排序。
    for str_encoding in TUPLE_TEXT_ENCODINGS:

        # 解码失败时继续尝试下一个编码。
        try:

            # 成功解码后立即返回文本和编码标签。
            return bytes_raw.decode(str_encoding), str_encoding

        # UnicodeDecodeError 表示当前编码不适合该文件。
        except UnicodeDecodeError:

            # 继续尝试后续编码候选。
            continue

    # 最终兜底保留可读文本，避免极端文件打断批量报告。
    return bytes_raw.decode("latin-1", errors="replace"), "latin-1-replace"

# strip_line_comment 用于区分代码内容和尾随单行注释。
def strip_line_comment(str_line: str) -> str:
    """
    移除一行中字符串字面量外部的 Verilog 单行注释。

    :param str_line: 待分析的单行 Verilog 文本。
    :return: 去除行注释后的代码片段。
    """

    # 字符串状态避免把字符串内部的 // 误判成注释。
    bool_in_string = False  # 当前扫描位置是否位于双引号字符串内

    # index 从行首开始向后扫描。
    int_index = 0  # 当前字符偏移

    # 至少保留一个后续字符才能判断 //。
    while int_index < len(str_line) - 1:

        # 当前字符决定字符串状态和注释起点。
        str_char = str_line[int_index]  # 当前扫描字符

        # 双引号可能切换字符串状态。
        if str_char == '"':

            # 被反斜杠转义的双引号不结束字符串。
            bool_escaped = int_index > 0 and str_line[int_index - 1] == "\\"  # 当前引号是否被转义

            # 只有未转义引号才改变字符串状态。
            if not bool_escaped:

                # 切换字符串内部/外部状态。
                bool_in_string = not bool_in_string  # 更新后的字符串扫描状态

        # 字符串外部的 // 表示单行注释起点。
        if not bool_in_string and str_char == "/" and str_line[int_index + 1] == "/":

            # 返回注释之前的代码文本。
            return str_line[:int_index]

        # 普通字符推进一个位置。
        int_index += 1  # 下一处扫描偏移

    # 未发现行注释时返回原始行。
    return str_line

# is_code_line 判断一行在剥离注释后是否仍包含代码。
def is_code_line(str_line: str) -> bool:
    """
    判断 Verilog 源码行是否包含非注释代码。

    :param str_line: 待分析的单行 Verilog 文本。
    :return: True 表示该行剥离单行注释后仍有内容。
    """

    # 去除行注释和两端空白后再判定。
    str_stripped = strip_line_comment(str_line).strip()  # 去注释后的非空判断文本

    # bool 转换保持旧脚本的空行处理语义。
    return bool(str_stripped)

# port_name_from_decl_body 从端口声明体内提取最后一个标识符作为端口名。
def port_name_from_decl_body(str_body: str) -> str | None:
    """
    从端口声明正文中提取端口名。

    :param str_body: PORT_DECL_RE 捕获到的声明正文。
    :return: 识别到的端口名；无法识别时返回 None。
    """

    # 位宽范围不是端口名，先替换为空格。
    str_without_ranges = re.sub(r"\[[^\]]+\]", " ", str_body)  # 移除位宽范围后的声明体

    # 常见类型修饰符也不参与端口名候选。
    str_without_types = re.sub(  # 移除类型修饰符后的声明体
        r"\b(?:wire|reg|logic|signed|unsigned)\b",  # 端口声明类型修饰符集合
        " ",  # 用空格替换以保留标识符分隔边界
        str_without_ranges,  # 已移除位宽范围的端口声明体
    )

    # 标识符列表先初始化，再按方向关键字过滤。
    list_identifiers: list[str] = []  # 声明体内过滤方向关键字后的标识符

    # 正则扫描结果按声明文本顺序保留。
    for str_item in RE_IDENTIFIER.findall(str_without_types):

        # 方向关键字已经由正则前缀处理，不应进入端口名候选。
        if str_item not in SET_PORT_DIRECTIONS:

            # 追加真实端口名候选，最后一个候选会作为端口名。
            list_identifiers.append(str_item)

    # 没有标识符时无法可靠给出端口名。
    if not list_identifiers:

        # None 保持旧脚本对异常声明的跳过语义。
        return None

    # Verilog 声明中最后一个标识符通常是端口名。
    return list_identifiers[-1]

# relative_path_text 让报告路径在语料根内保持相对形式。
def relative_path_text(path_source: Path, path_root: Path) -> str:
    """
    生成报告中展示的源文件路径文本。

    :param path_source: 当前 Verilog 源文件路径。
    :param path_root: 用户传入的语料根路径。
    :return: 根内相对路径或原始路径文本。
    """

    # Python 3.9+ 的 is_relative_to 可避免异常式控制流。
    if path_source.is_relative_to(path_root):

        # 根内文件使用相对路径，报告在不同机器上更稳定。
        return str(path_source.relative_to(path_root))

    # 根外文件保留完整路径，避免丢失来源。
    return str(path_source)

# metric_dict 提取单个文件的所有统计字段。
def metric_dict(path_source: Path, path_root: Path) -> dict[str, Any]:
    """
    提取单个 Verilog 文件的风格统计字典。

    :param path_source: 待统计的 Verilog 源文件路径。
    :param path_root: 用户传入的语料根路径。
    :return: 与旧版 CorpusFileMetrics.to_dict 等价的指标字典。
    """

    # 文本读取同时记录实际编码，供报告排查语料来源差异。
    tuple_text_encoding = read_text(path_source)  # 源码文本和编码名称

    # 元组拆分让后续指标表达更清晰。
    str_text, str_encoding = tuple_text_encoding  # Verilog 源码文本和解码标签

    # splitlines 保持旧脚本不保留换行符的统计方式。
    list_lines = str_text.splitlines()  # 源文件按行拆分后的文本列表

    # 代码行统计只计算剥离行注释后仍非空的行。
    list_code_lines = [str_line for str_line in list_lines if is_code_line(str_line)]  # 非注释代码行列表

    # 注释行沿用旧脚本的简单 // 包含判断。
    list_comment_lines = [str_line for str_line in list_lines if "//" in str_line]  # 含有单行注释标记的行列表

    # 端口名称由所有端口声明行解析得到。
    list_ports = extract_ports(str_text)  # 当前文件识别出的端口名列表

    # 参数名称直接从 parameter 声明中提取。
    list_parameters = re.findall(r"\bparameter\s+([A-Za-z_][A-Za-z0-9_$]*)", str_text)  # parameter 名称列表

    # C_ 前缀参数列表先初始化，便于逐项解释筛选条件。
    list_c_parameters: list[str] = []  # C_ 前缀参数名称列表

    # C_ 命名比例需要从全部 parameter 名称中筛出命中项。
    for str_name in list_parameters:

        # C_ 前缀参数是 Erie 理想语料中的正向特征。
        if str_name.startswith("C_"):

            # 记录当前命中项，供后续参数比例计算。
            list_c_parameters.append(str_name)

    # 注释密度默认归零，避免空文件触发除零。
    float_comment_density = 0.0  # 注释行数相对代码行数的密度

    # 有代码行时才计算真实注释密度。
    if list_code_lines:

        # 注释行数沿用旧脚本的简单 // 行计数。
        float_comment_density = len(list_comment_lines) / len(list_code_lines)  # 有代码行时的注释密度

    # 相对路径文本保持报告跨环境可比较。
    str_report_path = relative_path_text(path_source, path_root)  # 报告中的文件路径文本

    # 英文头部标记来自 Erie 既有模板。
    str_english_header = "////////////////////////////////////English"  # 双语头部中的英文分隔线

    # 中文头部标记来自 Erie 既有模板。
    str_chinese_header = "///////////////////////////////////Chinese"  # 双语头部中的中文分隔线

    # 双语头部需要两个标记同时存在。
    int_has_bilingual_header = int(str_english_header in str_text and str_chinese_header in str_text)  # 双语头部命中标志

    # 指标字典字段名保持旧报告结构。
    return {
        "path": str_report_path,
        "encoding": str_encoding,
        "lines": len(list_lines),
        "code_lines": len(list_code_lines),
        "comment_lines": len(list_comment_lines),
        "comment_density": float_comment_density,
        "tab_indented_lines": sum(1 for str_line in list_lines if str_line.startswith("\t")),
        "space_indented_lines": sum(1 for str_line in list_lines if re.match(r" {2,}\S", str_line)),
        "block_comment_markers": str_text.count("/*") + str_text.count("*/"),
        "ports": len(list_ports),
        "prefixed_ports": sum(1 for str_name in list_ports if str_name.startswith(("i_", "o_", "io_"))),
        "parameters": len(list_parameters),
        "c_parameters": len(list_c_parameters),
        "region_banners": len(RE_REGION.findall(str_text)),
        "has_bilingual_header": int_has_bilingual_header,
        "placeholder_comment_hits": len(RE_PLACEHOLDER_COMMENT.findall(str_text)),
        "always_blocks": len(re.findall(r"\balways\s*@", str_text)),
        "assigns": len(re.findall(r"\bassign\b", str_text)),
    }

# extract_ports 封装端口声明扫描，避免主统计函数过长。
def extract_ports(str_text: str) -> list[str]:
    """
    从 Verilog 文本中提取端口名列表。

    :param str_text: 待扫描的 Verilog 源码文本。
    :return: 成功识别出的端口名列表。
    """

    # 端口列表按源码出现顺序保留。
    list_ports: list[str] = []  # 已识别端口名列表

    # 遍历所有方向声明匹配项。
    for match_port in RE_PORT_DECL.finditer(str_text):

        # 声明体中最后一个有效标识符视为端口名。
        str_name = port_name_from_decl_body(match_port.group("body"))  # 当前端口声明提取出的名称

        # 无法识别名称的声明不进入统计。
        if str_name:

            # 追加到端口列表供前缀覆盖统计使用。
            list_ports.append(str_name)

    # 返回当前文件全部端口名。
    return list_ports

# summarize_number 对同一指标在语料中的分布做基本统计。
def summarize_number(list_values: list[float]) -> dict[str, float]:
    """
    汇总一组数值的平均值、中位数和边界值。

    :param list_values: 待汇总的浮点数值列表。
    :return: 包含 avg、median、min、max 的统计字典。
    """

    # 空语料下所有数值汇总归零。
    if not list_values:

        # 保持旧 JSON 字段完整，便于下游读取。
        return {"avg": 0.0, "median": 0.0, "min": 0.0, "max": 0.0}

    # 平均值使用简单算术平均。
    float_avg = float(sum(list_values) / len(list_values))  # 指标平均值

    # 中位数交给标准库处理奇偶长度。
    float_median = float(statistics.median(list_values))  # 指标中位数

    # 最小值展示该指标在语料中的下界。
    float_min = float(min(list_values))  # 指标最小值

    # 最大值展示该指标在语料中的上界。
    float_max = float(max(list_values))  # 指标最大值

    # 返回字段名保持旧报告结构。
    return {
        "avg": float_avg,
        "median": float_median,
        "min": float_min,
        "max": float_max,
    }

# style_signal 计算低风格样本排序用的启发式信号值。
def style_signal(dict_item: dict[str, Any]) -> float:
    """
    根据单文件指标计算启发式风格信号。

    :param dict_item: metric_dict 产出的单文件指标字典。
    :return: 信号值越低表示越值得人工查看。
    """

    # 信号值从零开始累加正负特征。
    float_signal = 0.0  # 当前文件启发式风格信号

    # 有端口时，端口前缀比例作为正向特征。
    if dict_item["ports"]:

        # i_/o_/io_ 前缀越完整，信号值越偏向理想语料。
        float_signal += dict_item["prefixed_ports"] / dict_item["ports"]  # 端口命名前缀贡献

    # 有参数时，C_ 参数比例作为正向特征。
    if dict_item["parameters"]:

        # 项目参数前缀越完整，正例语料特征越明显。
        float_signal += dict_item["c_parameters"] / dict_item["parameters"]  # 参数命名前缀贡献

    # 注释密度按 1.0 封顶，避免超密注释支配信号值。
    float_signal += min(dict_item["comment_density"], 1.0)  # 注释密度贡献

    # 区域横幅按 4 个封顶，鼓励结构化但不过度奖励。
    float_signal += min(dict_item["region_banners"] / 4.0, 1.0)  # 区域横幅贡献

    # 双语头部是模板完整性的正向信号。
    float_signal += dict_item["has_bilingual_header"]  # 双语头部贡献

    # 块注释标记在该项目风格中通常是不鼓励的格式。
    float_signal -= min(dict_item["block_comment_markers"], 3) * 0.25  # 块注释扣分

    # 占位注释命中直接提示模板未清理。
    float_signal -= min(dict_item["placeholder_comment_hits"], 5) * 0.5  # 占位注释扣分

    # 空格缩进比例用于暴露和项目 tab 缩进偏好的偏差。
    float_signal -= min(dict_item["space_indented_lines"] / max(dict_item["lines"], 1), 1.0)  # 空格缩进扣分

    # 返回排序使用的最终信号值。
    return float_signal

# corpus_report 汇总一个语料根的文件级指标和低信号样本。
def corpus_report(path_root: Path, *, int_sample_size: int) -> dict[str, Any]:
    """
    生成单个语料根的汇总报告。

    :param path_root: 语料根目录或单个 Verilog 文件路径。
    :param int_sample_size: 需要保留的低风格信号样本数量。
    :return: 包含文件数、统计摘要、编码分布和低信号样本的字典。
    """

    # 文件级指标先全部收集，便于后续多字段汇总。
    list_metrics = [metric_dict(path_source, path_root) for path_source in iter_sources(path_root)]  # 单文件指标列表

    # 各字段统计摘要保持旧版 field_names 顺序。
    dict_summary: dict[str, dict[str, float]] = {}  # 每个数值指标的分布摘要

    # 逐字段展开统计，避免压缩推导式掩盖字段来源。
    for str_field in TUPLE_METRIC_FIELDS:

        # 当前字段值统一转为 float，供 summarize_number 计算。
        list_field_values = [float(dict_item[str_field]) for dict_item in list_metrics]  # 当前指标的文件级数值

        # 汇总结果写回与旧报告相同的字段名。
        dict_summary[str_field] = summarize_number(list_field_values)  # 当前指标的分布摘要

    # 编码分布用于发现混入的非 UTF-8 语料。
    dict_encodings: dict[str, int] = {}  # 编码名称到文件数量的映射

    # 遍历文件级指标累加编码计数。
    for dict_item in list_metrics:

        # 当前文件编码从 read_text 结果传入。
        str_encoding = dict_item["encoding"]  # 当前文件使用的解码标签

        # 计数采用 get 兼容首次出现的编码。
        dict_encodings[str_encoding] = dict_encodings.get(str_encoding, 0) + 1  # 更新后的编码文件数量

    # 低风格信号样本按启发式信号值升序截取。
    list_low_samples = sorted(list_metrics, key=style_signal)[:int_sample_size]  # 低风格信号样本列表

    # 样本条目附带 style_signal，方便人工复核排序原因。
    list_low_sample_reports: list[dict[str, Any]] = []  # 带风格信号的低信号样本报告

    # 样本报告逐个追加，便于说明 style_signal 的来源。
    for dict_item in list_low_samples:

        # 当前样本保留原指标并追加排序使用的信号值。
        dict_sample = dict_item | {"style_signal": style_signal(dict_item)}  # 单个低信号样本报告条目

        # 追加后的列表直接进入 JSON 报告。
        list_low_sample_reports.append(dict_sample)

    # 返回字段名保持旧 JSON 顶层结构。
    return {
        "file_count": len(list_metrics),
        "summary": dict_summary,
        "encodings": dict_encodings,
        "sample_low_style": list_low_sample_reports,
    }

# main 串联 CLI 解析、报告构造和 JSON 写入。
def main() -> int:
    """
    执行语料风格统计 CLI。

    :param: 此函数不接收外部业务参数，直接读取命令行。
    :return: 0 表示报告文件已成功写入。
    """

    # argparse 负责校验必填参数和基础类型。
    namespace_args: argparse.Namespace = create_parser().parse_args()  # 语料分析命令行参数

    # meta 说明报告只用于规则调参，不替代正式 RTL 质量门。
    str_report_note = (
        "Corpus traits are advisory; generated delivery RTL is enforced by "
        "scripts/python/quality/quality_gate.py and "
        "scripts/python/quality/formatter_ast.py."
    )  # 报告用途说明文本

    # meta 字段承载版本号和使用边界。
    dict_meta = {
        "version": 1,  # 报告格式版本
        "note": str_report_note,  # 报告用途说明
    }  # 报告元信息

    # 正例语料根解析为绝对路径，避免相对路径受工作目录影响。
    path_ideal_root = namespace_args.ideal.resolve()  # ideal 语料绝对路径

    # bad 语料同样规范化路径，防止报告受调用目录变化影响。
    path_bad_root = namespace_args.bad.resolve()  # 压力样本语料的规范化根路径

    # 最终报告顶层结构保持旧版 meta/ideal/bad 三段，方便下游兼容。
    dict_report = {
        "meta": dict_meta,  # 版本和用途边界
        "ideal": corpus_report(path_ideal_root, int_sample_size=namespace_args.sample_size),  # 正例语料统计
        "bad": corpus_report(path_bad_root, int_sample_size=namespace_args.sample_size),  # 反例语料统计
    }  # 待写入 JSON 报告载荷

    # 输出目录不存在时自动创建，保持旧 CLI 便利性。
    namespace_args.out.parent.mkdir(parents=True, exist_ok=True)

    # JSON 文件使用 UTF-8 和缩进，便于人工查看。
    namespace_args.out.write_text(
        json.dumps(dict_report, indent=2, ensure_ascii=False) + "\n",
        encoding="utf-8",
    )

    # 终端只输出简短状态，完整结构化数据写入文件。
    print(f"> INFO: [Python] Wrote corpus metrics to {namespace_args.out}")

    # 成功写入报告后返回 0。
    return 0

# 脚本入口保持直接运行时的退出码传递。
if __name__ == "__main__":

    # main 的返回值作为进程退出码。
    raise SystemExit(main())
```

## File: scripts/python/existing_rtl/existing_rtl.py
size: 83047
sha: 76c727033067d4deb4fd6faa200885859c40c4a9
upstream: https://github.com/eriemon/verilog-generator/blob/HEAD/scripts/python/existing_rtl/existing_rtl.py

Content is not inlined in the catalog. Read the upstream file: https://github.com/eriemon/verilog-generator/blob/HEAD/scripts/python/existing_rtl/existing_rtl.py

## File: scripts/python/existing_rtl/existing_rtl_improvement.py
size: 112503
sha: 7e490b91de37c6c8373c3781f33a54effe96ddee
upstream: https://github.com/eriemon/verilog-generator/blob/HEAD/scripts/python/existing_rtl/existing_rtl_improvement.py

Content is not inlined in the catalog. Read the upstream file: https://github.com/eriemon/verilog-generator/blob/HEAD/scripts/python/existing_rtl/existing_rtl_improvement.py

## File: scripts/python/existing_rtl/intervention.py
size: 8511
sha: e353540519e25ca19e4e3740073d4f000f458eb7
upstream: https://github.com/eriemon/verilog-generator/blob/HEAD/scripts/python/existing_rtl/intervention.py

```text
"""人工介入决策的归一化、适用范围判断和记忆条目生成。"""

# 未来注解避免运行时解析复杂类型，保持轻量导入。
from __future__ import annotations

# 标准库类型：仅用于描述 JSON-like 字典中的任意值。
from typing import Any

# 公开入口把用户回答转换成 workflow 可持久化的决策和记忆。
def resolve_intervention(intervention: dict[str, Any], answer: dict[str, Any]) -> tuple[dict[str, Any], dict[str, Any]]:
    """
    将一次人工介入回答整理为决策对象和决策记忆。

    :param intervention: workflow 生成的待确认问题，包含来源和问题文本。
    :param answer: 用户提交的回答对象，必须包含 decision、evidence、constraints 和 affected_subfunctions。
    :return: 二元组，第一项是 resolved decision，第二项是可写入 workflow state 的 memory。
    :raises ValueError: 当回答不是对象、缺少必要字段或 decision 为空时抛出。
    """

    # 先校验回答字段，避免写出不完整的人类决策记录。
    _validate_answer(answer)

    # affected_subfunctions 为空时默认影响全部子功能，保持旧流程的全局决策语义。
    list_affected = [str(item) for item in _as_list(answer.get("affected_subfunctions"))] or ["*"]  # 影响范围

    # 原始介入摘要单独命名，避免主决策对象变成难读的大字典。
    dict_source_intervention = {
        "primary_source": intervention.get("primary_source"),  # 原始介入来源
        "question": intervention.get("question"),  # 原始人工确认问题
    }  # 原始介入摘要对象

    # 决策对象保留原有 wire shape，供 workflow state 和报告继续读取。
    dict_decision: dict[str, Any] = {}  # 人工决策记录

    # 决策记录版本用于未来迁移兼容。
    dict_decision["version"] = 1  # 决策记录版本

    # 人工介入完成后固定进入 resolved 状态。
    dict_decision["status"] = "resolved"  # 人工介入已解决状态

    # 决策文本保持用户原文的字符串形式。
    dict_decision["decision"] = str(answer["decision"])  # 用户确认的决策文本

    # 证据字段归一化为列表，保留旧 wire shape。
    dict_decision["evidence"] = _as_list(answer.get("evidence", []))  # 用户提供的证据列表

    # 约束字段归一化为列表，供记忆摘要拼接。
    dict_decision["constraints"] = _as_list(answer.get("constraints", []))  # 用户确认的约束列表

    # 影响范围使用前面计算好的默认星号语义。
    dict_decision["affected_subfunctions"] = list_affected  # 决策影响的子功能范围

    # 原始介入摘要保留问题来源，便于审计人类决策链。
    dict_decision["source_intervention"] = dict_source_intervention  # 原始介入摘要

    # 记忆条目按影响范围展开，让后续阶段能按子功能匹配人类决策。
    dict_memory = {
        "version": 1,  # 记忆结构版本
        "entries": [  # workflow 可持久化的记忆条目列表
            {
                "subfunction": subfunction_name,  # 记忆适用的子功能
                "stage": "*",  # 决策适用于所有阶段
                "error_signature": "human_decision",  # 人工决策的固定错误签名
                "constraint": _constraint_text(dict_decision),  # 可读约束摘要
                "decision": dict_decision["decision"],  # 原始决策文本
            }
            for subfunction_name in list_affected  # 决策影响范围逐项展开
        ],  # 按影响范围展开后的记忆条目集合
    }

    # 返回决策和记忆，调用方负责写入状态文件或报告。
    return dict_decision, dict_memory

# workflow 在进入子功能阶段前用该函数判断已有人工决策是否命中。
def decision_applies(decision: dict[str, Any] | None, subfunction: str | None) -> bool:
    """
    判断人工决策是否适用于指定子功能。

    :param decision: 已解析的人工决策对象；为空表示没有可用决策。
    :param subfunction: 当前子功能名称；为空时表示调用方处于全局上下文。
    :return: 当决策为空返回 False；当影响范围为空、包含 ``*``、处于全局上下文或命中子功能名时返回 True。
    """

    # 没有决策时不能套用任何人工约束。
    if not decision:

        # 返回不适用，保持调用方继续等待或触发人工介入。
        return False

    # 决策影响范围统一转字符串列表，兼容 JSON 中的数字或其他标量。
    list_affected = [str(item) for item in decision.get("affected_subfunctions", []) or []]  # 当前决策影响范围

    # 空范围、全局星号、全局上下文或显式子功能命中都视为适用。
    return not list_affected or "*" in list_affected or subfunction is None or str(subfunction) in list_affected

# 回答校验集中在这里，保持 resolve_intervention 主流程直观。
def _validate_answer(answer: dict[str, Any]) -> None:
    """校验人工介入回答是否包含生成决策所需的字段。

    参数:
        answer: 用户提交的人工介入回答对象。

    返回:
        无。

    异常:
        ValueError: 当回答不是对象、缺少字段或 decision 为空时抛出。
    """

    # 人工回答必须是 JSON object，列表或字符串都无法承载必要字段。
    if not isinstance(answer, dict):

        # 错误前缀遵循脚本输出规范，主体保留原英文诊断。
        raise ValueError("> ERR: [Python] Human intervention answer must be a JSON object.")

    # 必需字段缺失时一次性报告全部字段，方便用户补齐回答。
    list_missing = [
        field_name  # 缺失的必需字段名
        for field_name in ("decision", "evidence", "constraints", "affected_subfunctions")  # 必需字段枚举
        if field_name not in answer  # 当前回答缺失该字段
    ]  # 缺失字段列表

    # 缺字段的回答不能进入决策记忆，否则后续阶段会误用不完整约束。
    if list_missing:

        # 缺失字段列表保留原拼接格式，便于用户直接补齐。
        raise ValueError(
            "> ERR: [Python] Human intervention answer is missing required fields: " + ", ".join(list_missing)
        )

    # decision 文本为空时无法形成可审计的人类决策。
    if not str(answer.get("decision", "")).strip():

        # 空决策的诊断也保留英文主体，便于既有调用方识别原因。
        raise ValueError("> ERR: [Python] Human intervention answer decision must not be empty.")

# 记忆约束摘要只拼接非空约束，避免空字符串污染报告。
def _constraint_text(decision: dict[str, Any]) -> str:
    """把人工决策和非空约束合成为可写入记忆的摘要。

    参数:
        decision: 已解析的人工决策对象。

    返回:
        面向 prompt 记忆的人工决策摘要文本。
    """

    # 约束文本使用分号拼接，保留用户提供约束的顺序。
    str_constraints = "; ".join(str(item) for item in decision.get("constraints", []) if str(item).strip())  # 约束摘要

    # 有约束时把决策和约束同时写入记忆，便于后续 prompt 引用。
    if str_constraints:

        # 返回带约束的人工决策摘要。
        return f"Human decision: {decision['decision']}. Constraints: {str_constraints}."

    # 没有约束时只记录决策本身。
    return f"Human decision: {decision['decision']}."

# JSON 字段兼容空值、列表和单项标量三种输入。
def _as_list(value: Any) -> list[Any]:
    """把 JSON 字段值归一化为列表形态。

    参数:
        value: 可能为空、列表或单项标量的 JSON 字段值。

    返回:
        归一化后的列表对象；原列表输入保持原对象返回。
    """

    # 空值代表没有条目。
    if value is None:

        # 返回空列表，调用方不需要再判断 None。
        return []

    # 列表输入保留原有顺序和元素对象。
    if isinstance(value, list):

        # 返回原列表，保持旧行为不做深拷贝。
        return value

    # 标量输入提升为单元素列表，兼容简单回答格式。
    return [value]
```

## File: scripts/python/existing_rtl/optimizer.py
size: 26415
sha: ef66a94143cee73e8de82cf72fa00cb32c787422
upstream: https://github.com/eriemon/verilog-generator/blob/HEAD/scripts/python/existing_rtl/optimizer.py

```text
"""根据 workflow trace 生成下一轮 prompt 补丁和可复用记忆。"""

# 延迟注解解析，避免运行期求值嵌套泛型。
from __future__ import annotations

# 标准库提供路径对象和 JSON-like 负载类型标注。
from pathlib import Path
from typing import Any

# 运行时模块提供计划规范化和 trace 读取能力。
from scripts.python.workflow.planning import decompose_spec
from scripts.python.workflow.trace import read_trace

# trace 文本约束规则保持旧版顺序，确保 prompt patch 输出稳定。
CONSTRAINT_RULES: tuple[tuple[tuple[str, ...], str], ...] = (  # trace 关键词到 prompt 约束的映射表
    (
        ("dependency_issue", "undefined module", "undefined reference", "not declared"),  # 依赖或声明缺失迹象
        (
            "Re-check subfunction interface compatibility, dimensions, and dependency outputs "
            "before regenerating the failing module."
        ),  # 依赖失败后复核上下游接口的 prompt 约束
    ),
    (
        ("testbench", "main() entry point"),  # 测试平台或入口函数相关诊断
        (
            "Generate or repair a self-checking testbench with explicit PASS/FAIL behavior "
            "and coverage for every behavior item."
        ),  # testbench 失败后要求补齐自检覆盖的 prompt 约束
    ),
    (
        ("toolchain_issue", "required tool", "failed to start", "timed out"),  # 外部工具不可用或超时迹象
        (
            "Separate toolchain availability/configuration failures from code edits; "
            "only rewrite code when the tool output identifies code errors."
        ),  # 工具链异常和代码错误分流的 prompt 约束
    ),
    (
        ("placeholder", "todo", "fixme", "ellipsis"),  # 未完成代码占位痕迹
        "Remove all placeholders and produce complete executable code for every manifest file.",  # 完整实现约束
    ),
    (
        ("spec_issue", "expected output file is missing"),  # 规格或产物覆盖缺口
        (
            "Audit the plan outputs and evidence before code regeneration; "
            "missing requested files indicate a plan or manifest coverage issue."
        ),  # 缺失产物先回查计划覆盖的 prompt 约束
    ),
    (
        ("reviewability", "comment"),  # 注释可审查性相关信号
        (
            "Preserve the requested comment language and add same-line semantic comments for "
            "ports, signals, always blocks, assigns, testbench checks, and construct end lines."
        ),  # RTL 可审查性不足时使用的注释补强约束
    ),
    (
        ("fsm", "state register", "next-state"),  # 状态机结构缺口
        (
            "For RTL regeneration, use a three-block FSM with explicit state register, "
            "next-state logic, and output logic sections."
        ),  # 状态机结构失败后的 RTL 分块约束
    ),
    (
        ("semantic model", "run_tests"),  # Python 参考模型合同信号
        (
            "Preserve the Python semantic model API and mirror its deterministic "
            "verification vectors in the downstream testbench."
        ),  # 参考模型合同漂移时的向量同步约束
    ),
    (
        ("semantic output drift", "wrong_final_output"),  # 最终输出语义漂移
        (
            "When a final output mismatches the Python oracle, restate the exact output contract "
            "and regenerate only the logic responsible for those drift keys."
        ),  # 最终输出漂移时限制重生成范围的约束
    ),
    (
        ("checkpoint drift", "checkpoint_divergence"),  # 中间检查点漂移
        (
            "Preserve and compare intermediate checkpoints so the next attempt can localize "
            "the mismatch before the final output stage."
        ),  # 中间检查点漂移后的定位约束
    ),
    (
        ("case order drift", "case_order_drift"),  # 用例顺序漂移
        "Keep case ids and transcript order stable across Python oracle, vectors, and Verilog testbench output.",  # 用例顺序稳定约束
    ),
    (
        ("weak_test_oracle", "augment_tests"),  # 测试 oracle 覆盖不足
        "Strengthen boundary cases, negative cases, and checkpoint coverage before escalating to human debugging.",  # 测试增强约束
    ),
    (
        ("ambiguous_spec_rule",),  # 规格规则冲突
        (
            "Call out the conflicting spec rule explicitly and preserve the ambiguity "
            "for structured human resolution instead of guessing."
        ),  # 规格冲突进入人工确认前的保留约束
    ),
    (
        ("needs_human_intervention", "ask_human"),  # 人工介入信号
        (
            "Summarize the unresolved ambiguity as a precise hardware-design question "
            "before another generation attempt."
        ),  # 人工介入后收敛问题描述的约束
    ),
)

# 记忆签名规则保持旧版优先级，避免历史 trace 产出的 memory 顺序漂移。
SIGNATURE_RULES: tuple[dict[str, Any], ...] = (  # 供_memory_entries把失败事件转换为可复用prompt记忆约束的规则序列
    {
        "source_terms": ("dependency_issue",),  # 依赖失败事件来源匹配词
        "text_terms": ("undefined module", "interface"),  # 接口或未定义模块文本
        "signature": "interface_or_dependency_mismatch",  # 接口依赖签名
        "constraint": (  # 接口依赖签名对应的 prompt memory 约束
            "Reconfirm upstream/downstream port names, dimensions, and subfunction dependency "
            "outputs before code generation."
        ),  # 接口依赖失败写入 memory 的复核提醒
    },
    {
        "source_terms": ("testbench_issue",),  # 测试平台失败事件来源匹配词
        "text_terms": ("testbench", "pass behavior", "fail behavior"),  # 自检行为文本
        "signature": "testbench_or_reference_vector_gap",  # testbench 覆盖签名
        "constraint": (  # testbench 覆盖签名对应的 prompt memory 约束
            "Generate self-checking PASS/FAIL tests that mirror the semantic model vectors "
            "and mention required verification cases."
        ),  # testbench 覆盖缺口写入 memory 的自检提醒
    },
    {
        "source_terms": (),  # 该规则只依赖 trace 文本
        "text_terms": ("semantic model", "run_tests"),  # 参考模型 API 文本
        "signature": "reference_model_contract_gap",  # 参考模型合同签名
        "constraint": "Preserve `run_tests()` and the Python CLI entrypoint, then mirror its vectors downstream.",  # 参考模型入口缺口写入记忆的保持约束
    },
    {
        "source_terms": (),  # 注释可审查性来自文本线索
        "text_terms": ("reviewability", "comment"),  # 注释质量相关文本
        "signature": "comment_reviewability_gap",  # 注释审查签名
        "constraint": (  # 注释可审查签名对应的 prompt memory 约束
            "Use the requested comment language and add same-line semantic comments for every "
            "RTL declaration, block, assign, construct end, and testbench case check."
        ),  # 注释审查失败写入 memory 的 RTL 注释提醒
    },
    {
        "source_terms": (),  # FSM 结构来自 trace 描述
        "text_terms": ("fsm", "state register", "next-state"),  # 状态机结构文本
        "signature": "rtl_fsm_structure_gap",  # FSM 结构签名
        "constraint": (  # FSM 结构签名对应的 prompt memory 约束
            "Use three-block RTL FSM style with state register, next-state logic, "
            "and output logic labels."
        ),  # FSM 结构缺口写入 memory 的样式提醒
    },
    {
        "source_terms": ("toolchain_issue",),  # 工具链类 error_sources
        "text_terms": ("required tool",),  # 缺少工具文本
        "signature": "toolchain_unavailable_or_failed",  # 工具链失败签名
        "constraint": (  # 工具链失败签名对应的 prompt memory 约束
            "Separate tool availability failures from code edits and rerun with "
            "the required readiness tool installed."
        ),  # 工具链失败写入 memory 的执行边界提醒
    },
    {
        "source_terms": ("spec_issue",),  # 规格失败事件来源匹配词
        "text_terms": ("evidence",),  # 证据覆盖文本
        "signature": "spec_or_evidence_gap",  # 规格证据签名
        "constraint": "Audit evidence coverage and requested outputs before regenerating implementation files.",  # 证据覆盖记忆
    },
    {
        "source_terms": (),  # 输出漂移来自语义报告文本
        "text_terms": ("semantic output drift", "wrong_final_output"),  # 最终输出不匹配文本
        "signature": "wrong_final_output",  # 最终输出漂移签名
        "constraint": (  # 最终输出漂移签名对应的 prompt memory 约束
            "Reconfirm case outputs against the Python oracle and focus regeneration "
            "on the drift keys reported by semantic validation."
        ),  # 最终输出漂移写入 memory 的重生成范围提醒
    },
    {
        "source_terms": (),  # checkpoint 漂移来自语义报告文本
        "text_terms": ("checkpoint drift", "checkpoint_divergence"),  # checkpoint 不一致文本
        "signature": "checkpoint_divergence",  # checkpoint 漂移签名
        "constraint": (  # checkpoint 漂移签名对应的 prompt memory 约束
            "Preserve intermediate checkpoints and use them to localize where the Verilog "
            "behavior diverges from the Python oracle."
        ),  # checkpoint 漂移写入 memory 的定位提醒
    },
    {
        "source_terms": (),  # case 顺序漂移来自 trace 文本
        "text_terms": ("case order drift", "case_order_drift"),  # 用例顺序不一致文本
        "signature": "case_order_drift",  # 用例顺序签名
        "constraint": (  # case 顺序漂移签名对应的 prompt memory 约束
            "Keep case ordering and case ids stable between the semantic contract "
            "and the Verilog transcript."
        ),  # 用例顺序漂移写入 memory 的排序提醒
    },
    {
        "source_terms": (),  # oracle 强度来自 trace 文本
        "text_terms": ("weak_test_oracle", "augment_tests"),  # 测试增强文本
        "signature": "weak_test_oracle",  # 测试 oracle 签名
        "constraint": "Add stronger boundary, negative, and checkpoint cases before escalating to a human.",  # 测试增强记忆
    },
    {
        "source_terms": (),  # 规格歧义来自结构化文本
        "text_terms": ("ambiguous_spec_rule",),  # 歧义规则文本
        "signature": "ambiguous_spec_rule",  # 规格歧义签名
        "constraint": (  # 规格歧义签名对应的 prompt memory 约束
            "Preserve the spec conflict explicitly and route it into structured human intervention "
            "rather than inferring behavior."
        ),  # 规格歧义写入 memory 的人工介入提醒
    },
)

# optimize_prompt_from_trace 将 trace 诊断整理成下一轮 prompt patch。
def optimize_prompt_from_trace(trace_path: Path, plan: dict[str, Any]) -> str:
    """根据历史 trace 为下一轮 staged generation 构造 prompt patch。

    参数:
        trace_path: workflow trace JSONL 或 JSON 文件路径。
        plan: 已有 codegen plan 或规格字典。

    返回:
        可追加到下一轮 prompt 的 Markdown 补丁文本。
    """

    # trace 事件提供失败模式和恢复线索。
    list_events = read_trace(trace_path)  # 历史 workflow 事件

    # 规范化计划用于稳定读取设计名和子功能列表。
    dict_normalized_plan = decompose_spec(plan)  # 规范化后的 RTL 生成计划

    # 约束列表按规则顺序去重，保持 prompt patch 可预测。
    list_constraints = _derive_constraints(list_events)  # 下一轮 prompt 约束

    # 子功能摘要在 Context 区域显示，帮助人工确认覆盖范围。
    str_subfunctions = _subfunction_summary(dict_normalized_plan)  # 子功能名称摘要

    # prompt patch 头部保持旧版 Markdown wire shape。
    list_lines = [  # 供optimize_prompt_from_trace拼接返回Markdown补丁正文的行序列
        f"# Prompt patch: {dict_normalized_plan['name']}",  # 标识目标设计名称的补丁标题行
        "",  # 标题和正文之间的 Markdown 空行
        "Apply these incremental constraints to the next staged generation prompt.",  # 固定说明文本
        "",  # 说明和约束标题之间的 Markdown 空行
        "## Targeted Constraints",  # 约束章节标题
        "",  # 约束标题后的 Markdown 空行
    ]

    # 有具体约束时逐条追加，空约束时保留旧版兜底文本。
    if list_constraints:

        # 约束条目必须保持规则匹配顺序。
        list_lines.extend(f"- {str_constraint}" for str_constraint in list_constraints)

    # trace 没有命中失败模式时不强行发明 prompt 约束。
    else:

        # 兜底约束明确要求保留既有 staged prompt 合同。
        list_lines.append(
            "- No concrete failure pattern was found; keep the existing staged prompt contract unchanged."
        )

    # Context 区域汇总 trace 数量、子功能和输出合同边界。
    list_lines.extend(
        [
            "",  # 约束列表和 Context 标题之间的 Markdown 空行
            "## Context",  # 上下文章节标题
            "",  # Context 标题后的 Markdown 空行
            f"- Trace events analyzed: {len(list_events)}",  # trace 事件数量
            f"- Subfunctions: {str_subfunctions}",  # 子功能摘要
            "- Preserve exact manifest/code-fence output contract.",  # 输出合同保护提醒
        ]
    )

    # 返回带末尾换行的 Markdown 文本，保持旧版 CLI 输出习惯。
    return "\n".join(list_lines) + "\n"

# build_prompt_memory 将 trace 诊断转换为 workflow 可复用记忆。
def build_prompt_memory(trace_path: Path, plan: dict[str, Any]) -> dict[str, Any]:
    """根据 trace 和计划生成 prompt memory 结构。

    参数:
        trace_path: workflow trace JSONL 或 JSON 文件路径。
        plan: 已有 codegen plan 或规格字典。

    返回:
        包含版本、目标和记忆条目的字典。
    """

    # prompt memory 只读取能复用到后续生成的失败线索。
    list_events = read_trace(trace_path)  # prompt memory 签名抽取的输入事件

    # 顶层 memory 字段从规范化计划读取，避免原始 spec 形态差异。
    dict_normalized_plan = decompose_spec(plan)  # memory 顶层名称和目标来源

    # 返回结构保持旧版 prompt memory wire shape。
    return {
        "version": 1,  # memory 结构版本
        "name": dict_normalized_plan["name"],  # 设计或计划名称
        "target": dict_normalized_plan["target"],  # 生成目标类型
        "entries": _memory_entries(list_events, dict_normalized_plan),  # 去重后的 trace 记忆条目
    }

# _derive_constraints 负责从 trace 文本中抽取 prompt 约束。
def _derive_constraints(list_events: list[dict[str, Any]]) -> list[str]:
    """从历史事件文本中提取下一轮 prompt 约束。

    参数:
        list_events: read_trace 返回的 workflow 事件列表。

    返回:
        按规则顺序去重后的英文 prompt 约束列表。
    """

    # 所有事件统一转成小写文本，兼容旧逻辑的字符串匹配方式。
    str_joined_events = "\n".join(str(dict_event).lower() for dict_event in list_events)  # trace 拼接文本

    # prompt patch 约束按 CONSTRAINT_RULES 命中顺序累积。
    list_constraints: list[str] = []  # 下一轮生成 prompt 中追加的约束条目

    # 逐条匹配历史规则，保持旧版约束文本和顺序。
    for tuple_keywords, str_constraint in CONSTRAINT_RULES:

        # 当前关键词组命中时追加对应约束。
        if _contains_any(str_joined_events, tuple_keywords):

            # 去重追加避免多个关键词命中同一约束时重复输出。
            _append_unique(list_constraints, str_constraint)

    # 返回 prompt patch 使用的约束列表。
    return list_constraints

# _memory_entries 负责把 trace 事件展开成去重记忆条目。
def _memory_entries(list_events: list[dict[str, Any]], dict_plan: dict[str, Any]) -> list[dict[str, Any]]:
    """把 trace 事件转换为按子功能和阶段索引的记忆条目。

    参数:
        list_events: read_trace 返回的 workflow 事件列表。
        dict_plan: decompose_spec 输出的规范化计划。

    返回:
        去重后的 prompt memory entries 列表。
    """

    # 子功能列表缺省为星号，保留旧版全局记忆语义。
    list_subfunctions = _plan_subfunctions(dict_plan)  # prompt memory 适用的子功能名称

    # entries 先完整收集，再按 subfunction/stage/signature 去重。
    list_entries: list[dict[str, Any]] = []  # 原始记忆条目列表

    # 每个 trace 事件可能贡献多个签名。
    for dict_event in list_events:

        # 事件文本沿用旧版 str(event).lower() 匹配语义。
        str_joined_event = str(dict_event).lower()  # 单个事件小写文本

        # 事件签名规则输出错误签名和约束文本。
        list_signatures = _event_signatures(dict_event, str_joined_event)  # 当前事件命中的签名

        # 每个签名生成一条 memory entry。
        for str_signature, str_constraint in list_signatures:

            # 记忆条目保持 workflow state 使用的字段形状。
            list_entries.append(
                {
                    "subfunction": dict_event.get("subfunction") or list_subfunctions[0],  # 事件归属子功能
                    "stage": _event_stage(dict_event),  # 事件归属阶段或 readiness
                    "attempt_id": dict_event.get("attempt_id"),  # 原始尝试标识
                    "error_signature": str_signature,  # 可复用错误签名
                    "constraint": str_constraint,  # 下一轮 prompt 约束文本
                }
            )

    # 去重后返回给 prompt memory 写出流程。
    return _dedupe_entries(list_entries)

# _event_signatures 根据单个事件匹配可复用错误签名。
def _event_signatures(dict_event: dict[str, Any], str_joined_event: str) -> list[tuple[str, str]]:
    """提取单个 trace 事件命中的记忆签名。

    参数:
        dict_event: 单条 workflow trace 事件。
        str_joined_event: 事件字典转成小写后的文本。

    返回:
        由 error_signature 和 constraint 组成的二元组列表。
    """

    # error_sources 只有列表形态时才参与源分类匹配。
    set_sources = set(dict_event.get("error_sources", []) or [])  # 当前事件错误来源集合

    # 签名输出按 SIGNATURE_RULES 顺序累积。
    list_signatures: list[tuple[str, str]] = []  # 当前事件命中的签名列表

    # 逐条匹配来源和文本关键词，保持旧版优先级。
    for dict_rule in SIGNATURE_RULES:

        # 规则命中后生成一条 prompt memory 签名。
        if _signature_rule_matches(dict_rule, set_sources, str_joined_event):

            # 签名和约束文本来自静态规则表，不做运行时改写。
            tuple_signature = (dict_rule["signature"], dict_rule["constraint"])  # 记忆签名和约束

            # 当前事件命中的签名进入返回列表。
            list_signatures.append(tuple_signature)

    # 返回当前事件贡献的所有签名。
    return list_signatures

# _signature_rule_matches 判断签名规则是否命中当前事件。
def _signature_rule_matches(dict_rule: dict[str, Any], set_sources: set[Any], str_joined_event: str) -> bool:
    """判断一条签名规则是否匹配当前 trace 事件。

    参数:
        dict_rule: SIGNATURE_RULES 中的一条规则。
        set_sources: 当前事件的 error_sources 集合。
        str_joined_event: 当前事件的小写文本。

    返回:
        来源或文本关键词任一命中时返回 True。
    """

    # source_terms 为空时只依赖文本关键词。
    tuple_source_terms = tuple(dict_rule.get("source_terms", ()))  # 规则错误来源关键词

    # text_terms 为空时只依赖 error_sources。
    tuple_text_terms = tuple(dict_rule.get("text_terms", ()))  # 规则事件文本关键词

    # 来源命中沿用旧逻辑中的 error_sources 判断。
    bool_source_matched = bool(tuple_source_terms) and any(  # error_sources 是否命中该签名规则
        str_source in set_sources  # 当前来源是否在事件来源集合中
        for str_source in tuple_source_terms  # 规则要求的来源关键词
    )

    # 文本命中沿用旧逻辑中的 str(event).lower() 判断。
    bool_text_matched = _contains_any(str_joined_event, tuple_text_terms)  # 文本是否命中

    # 来源或文本任一路径命中即可生成签名。
    return bool_source_matched or bool_text_matched

# _plan_subfunctions 解析计划中的子功能名称列表。
def _plan_subfunctions(dict_plan: dict[str, Any]) -> list[str]:
    """从规范化计划中提取 prompt memory 适用的子功能名称。

    参数:
        dict_plan: decompose_spec 输出的规范化计划。

    返回:
        子功能名称列表；没有可用名称时返回 ``["*"]``。
    """

    # 子功能名只从 dict 条目提取，兼容旧版过滤逻辑。
    list_names = [
        str(dict_item.get("name"))  # 子功能名称
        for dict_item in dict_plan.get("subfunctions", [])  # 规范化计划子功能列表
        if isinstance(dict_item, dict) and dict_item.get("name")  # 只保留具名子功能
    ]  # 已解析子功能名称

    # 没有子功能时返回全局星号，保持旧版默认行为。
    return list_names or ["*"]

# _subfunction_summary 生成 prompt patch 中展示的子功能摘要。
def _subfunction_summary(dict_plan: dict[str, Any]) -> str:
    """生成 prompt patch Context 区域使用的子功能摘要文本。

    参数:
        dict_plan: decompose_spec 输出的规范化计划。

    返回:
        以逗号分隔的子功能名称字符串。
    """

    # 子功能摘要复用 memory 的解析规则，避免两个路径默认值不一致。
    list_subfunctions = _plan_subfunctions(dict_plan)  # prompt patch 展示的子功能名称

    # 返回 Markdown 列表项中使用的逗号分隔摘要。
    return ", ".join(list_subfunctions)

# _event_stage 解析 memory entry 的阶段字段。
def _event_stage(dict_event: dict[str, Any]) -> Any:
    """解析 trace 事件所属阶段或 readiness。

    参数:
        dict_event: 单条 workflow trace 事件。

    返回:
        事件中的 stage、readiness、event 或 ``unknown``。
    """

    # stage/readiness/event 按旧版优先级依次兜底。
    return dict_event.get("stage") or dict_event.get("readiness") or dict_event.get("event") or "unknown"

# _contains_any 统一处理小写文本的关键词匹配。
def _contains_any(str_text: str, tuple_keywords: tuple[str, ...]) -> bool:
    """判断文本是否包含任一关键词。

    参数:
        str_text: 已按调用方需要归一化的待检索文本。
        tuple_keywords: 需要依次匹配的关键词集合。

    返回:
        任一关键词出现在文本中时返回 True。
    """

    # any 保持短路匹配，避免无意义地扫描后续关键词。
    return any(str_keyword in str_text for str_keyword in tuple_keywords)

# _append_unique 保持约束列表的稳定去重追加语义。
def _append_unique(list_values: list[str], str_value: str) -> None:
    """向字符串列表追加不存在的值。

    参数:
        list_values: 需要原地更新的字符串列表。
        str_value: 候选字符串值。

    返回:
        无。
    """

    # 只有首次命中才写入，保持旧版 add helper 的去重行为。
    if str_value not in list_values:

        # 原地追加让调用方持有的列表保持同步。
        list_values.append(str_value)

# _dedupe_entries 按子功能、阶段和错误签名去重。
def _dedupe_entries(list_entries: list[dict[str, Any]]) -> list[dict[str, Any]]:
    """去除重复的 prompt memory entry。

    参数:
        list_entries: 原始 prompt memory 条目列表。

    返回:
        保留首次出现顺序的去重条目列表。
    """

    # seen 记录已经输出过的 memory 业务键。
    set_seen: set[tuple[Any, Any, Any]] = set()  # 已出现的记忆去重键

    # 去重结果按输入顺序保存首次出现的条目。
    list_deduped: list[dict[str, Any]] = []  # 保留首次出现顺序的 memory 条目

    # 逐条检查 memory entry 的业务唯一键。
    for dict_entry in list_entries:

        # memory 去重仍使用旧版的三字段业务键。
        tuple_key = (  # 子功能、阶段和签名组成 memory 去重键
            dict_entry.get("subfunction"),  # 记忆适用子功能
            dict_entry.get("stage"),  # workflow 阶段或 readiness 名称
            dict_entry.get("error_signature"),  # 触发 prompt 记忆复用的错误签名
        )

        # 已见过的业务键直接跳过，保留首次条目。
        if tuple_key in set_seen:

            # 跳过重复条目，不改变输出顺序。
            continue

        # 记录当前业务键，避免后续重复输出。
        set_seen.add(tuple_key)

        # 首次出现的条目保留原字段内容。
        list_deduped.append(dict_entry)

    # 返回去重后的 memory 条目。
    return list_deduped
```

## File: scripts/python/existing_rtl/reflection.py
size: 88734
sha: 33170dda2ee3f979a082959a3429a6688a47ad17
upstream: https://github.com/eriemon/verilog-generator/blob/HEAD/scripts/python/existing_rtl/reflection.py

Content is not inlined in the catalog. Read the upstream file: https://github.com/eriemon/verilog-generator/blob/HEAD/scripts/python/existing_rtl/reflection.py

## File: scripts/python/existing_rtl/semantic_contract.py
size: 46694
sha: 8c645326c368e4026100a6f2c91200b17beefd9f
upstream: https://github.com/eriemon/verilog-generator/blob/HEAD/scripts/python/existing_rtl/semantic_contract.py

Content is not inlined in the catalog. Read the upstream file: https://github.com/eriemon/verilog-generator/blob/HEAD/scripts/python/existing_rtl/semantic_contract.py

## File: scripts/python/existing_rtl/verifier.py
size: 15705
sha: a68cf21f02fde60c90d76da6cb7b302d28291d66
upstream: https://github.com/eriemon/verilog-generator/blob/HEAD/scripts/python/existing_rtl/verifier.py

```text
"""校验 Verilog workflow 相邻阶段的契约一致性。"""

# 延迟注解解析，避免导入期处理嵌套 JSON 类型。
from __future__ import annotations

# 运行时契约由 JSON 字典承载，类型提示保持宽容。
from typing import Any

# 公开入口汇总阶段契约、计划接口和语义执行问题。
def verify_stage(
    plan: dict[str, Any],
    from_contract: dict[str, Any],
    to_contract: dict[str, Any],
) -> dict[str, Any]:
    """校验 workflow 相邻阶段之间的契约兼容性。

    参数:
        plan: codegen plan 或规范化计划，用于提供期望 top 和端口。
        from_contract: 上一阶段导出的契约。
        to_contract: 当前阶段导出的契约。

    返回:
        保持旧版字段形状的校验报告，包含 ready、issues 和语义执行摘要。
    """

    # issues 汇总原始契约问题、接口漂移和测试用例漂移。
    list_issues: list[dict[str, Any]] = []  # 阶段契约问题列表

    # 上一阶段问题保留原诊断内容，只附加来源侧。
    list_issues.extend(_contract_issues(from_contract, "from"))

    # 当前阶段问题同样附加来源侧，便于报告定位。
    list_issues.extend(_contract_issues(to_contract, "to"))

    # RTL 输出契约需要和 plan 中的 top/ports 对齐。
    list_issues.extend(plan_contract_interface_issues(plan, to_contract))

    # reference 和 RTL 阶段的 case_ids 不一致会降低验证闭环可信度。
    list_issues.extend(_check_cases(from_contract, to_contract))

    # 语义执行指标独立解析，供报告字段和 recommended_action 复用。
    dict_semantic = _semantic_execution_issues(to_contract)  # 当前阶段语义执行诊断

    # 语义问题加入统一 issues 列表。
    list_issues.extend(dict_semantic["issues"])

    # ready 只要存在 error 级问题就为 False。
    bool_ready = not any(item.get("severity") == "error" for item in list_issues)  # 阶段契约是否可继续

    # semantic_ready 显式布尔 False 时建议修复语义 testbench。
    semantic_ready_value = dict_semantic["semantic_ready"]  # 当前阶段语义 ready 原始值

    # 仅布尔 False 触发 repair_semantic_testbench，None 表示未检查。
    bool_requires_semantic_repair = isinstance(semantic_ready_value, bool) and not semantic_ready_value  # 是否建议修复语义 testbench

    # 默认没有语义修复建议。
    str_recommended_action = None  # 下一步建议动作

    # 语义执行明确失败时给出旧版建议动作。
    if bool_requires_semantic_repair:

        # 推荐动作字符串由旧版报告消费，不能改名。
        str_recommended_action = "repair_semantic_testbench"  # 语义 testbench 修复动作

    # error_sources 去重排序后供 workflow trace 和 repair plan 使用。
    list_error_sources = sorted({str(item.get("source")) for item in list_issues if item.get("source")})  # 问题来源集合

    # 返回字段保持旧版契约，避免上游报告解析变化。
    return {
        "version": 1,
        "target": plan.get("target", "rtl"),
        "ready": bool_ready,
        "issues": list_issues,
        "semantic_ready": dict_semantic["semantic_ready"],
        "mismatched_cases": dict_semantic["mismatched_cases"],
        "checkpoint_drift": dict_semantic["checkpoint_drift"],
        "failed_cases": dict_semantic["failed_cases"],
        "localization_confidence": dict_semantic["localization_confidence"],
        "error_sources": list_error_sources,
        "recommended_action": str_recommended_action,
        "summary": {
            "from_target": from_contract.get("target"),
            "to_target": to_contract.get("target"),
            "top": to_contract.get("top"),
        },
    }

# 公开接口校验器检查 plan 期望端口和 RTL 契约端口是否一致。
def plan_contract_interface_issues(plan: dict[str, Any], contract: dict[str, Any]) -> list[dict[str, Any]]:
    """检查 RTL 阶段契约是否保留计划中的 top 和端口定义。

    参数:
        plan: 提供期望模块名和 interfaces.ports 的计划字典。
        contract: 当前阶段导出的契约字典。

    返回:
        error 级接口漂移问题列表；非 RTL 契约返回空列表。
    """

    # 当前函数只验证 RTL 契约，其它阶段没有端口约束。
    list_issues: list[dict[str, Any]] = []  # RTL 接口契约问题

    # 非 RTL 目标不执行 top/ports 对齐检查。
    if contract.get("target") != "rtl":

        # 返回空问题，保持非 RTL 阶段宽容。
        return list_issues

    # plan.name 是期望的 RTL 顶层模块名。
    value_expected_top = plan.get("name")  # 计划中的期望 top 名称

    # contract.top 是当前阶段实际解析到的 RTL 顶层名。
    value_observed_top = contract.get("top")  # 当前契约中的 top 名称

    # 两侧都提供 top 且不一致时报告顶层漂移。
    if value_expected_top and value_observed_top and value_expected_top != value_observed_top:

        # 顶层不一致通常表示生成文件不是目标模块。
        list_issues.append(
            _issue("error", f"RTL top mismatch: expected {value_expected_top!r}, observed {value_observed_top!r}.")
        )

    # 期望端口按 name 建索引，便于后续逐个比较。
    dict_expected_ports = {
        str(item.get("name")): item  # 计划端口对象
        for item in plan.get("interfaces", {}).get("ports", [])  # 计划端口列表
        if isinstance(item, dict) and item.get("name")  # 只索引 RTL 契约中可命名匹配的端口
    }  # 计划端口索引

    # 观测端口同样按 name 建索引。
    dict_observed_ports = {
        str(item.get("name")): item  # 契约端口对象
        for item in contract.get("ports", [])  # RTL 契约端口列表
        if isinstance(item, dict) and item.get("name")  # 只保留具名端口
    }  # RTL 契约端口索引

    # 逐个计划端口检查是否缺失、方向漂移或位宽漂移。
    for str_port_name, dict_expected_port in dict_expected_ports.items():

        # observed 缺失说明 RTL 没有导出计划要求的端口。
        dict_observed_port = dict_observed_ports.get(str_port_name)  # 当前端口的 RTL 观测定义

        # 缺失端口直接记录 error，并跳过后续方向/位宽比较。
        if not dict_observed_port:

            # 端口缺失会破坏 testbench 和集成契约。
            list_issues.append(_issue("error", f"RTL port {str_port_name!r} is missing."))

            # 当前端口没有可比较的观测定义。
            continue

        # 两侧都声明 direction 时必须完全一致。
        if (
            dict_expected_port.get("direction")
            and dict_observed_port.get("direction")
            and dict_expected_port["direction"] != dict_observed_port["direction"]
        ):

            # 方向漂移会改变模块使用方式。
            list_issues.append(_issue("error", f"RTL port {str_port_name!r} direction changed."))

        # 期望宽度缺省按 1 处理，匹配旧版逻辑。
        int_expected_width = int(dict_expected_port.get("width", 1) or 1)  # 计划端口位宽

        # 观测位宽允许缺失；缺失时不报宽度漂移。
        value_observed_width = dict_observed_port.get("width")  # RTL 契约端口位宽

        # 观测位宽存在且和期望不同则报告 error。
        if value_observed_width is not None and int(value_observed_width) != int_expected_width:

            # 长错误消息拆分成变量，避免报告构造行过宽。
            str_message = (  # 位宽漂移诊断文本
                f"RTL port {str_port_name!r} width changed "  # 端口名和漂移类型
                f"from {int_expected_width} to {value_observed_width}."  # 期望位宽到观测位宽
            )

            # 记录当前端口位宽漂移。
            list_issues.append(_issue("error", str_message))

    # 返回 RTL 接口漂移问题列表。
    return list_issues

# 契约问题复制器给已有 issue 标注来源阶段。
def _contract_issues(contract: dict[str, Any], side: str) -> list[dict[str, Any]]:
    """复制契约内已有问题并标注来源侧。

    参数:
        contract: workflow 阶段导出的契约字典。
        side: 当前问题所属的阶段侧标识，通常为 from 或 to。

    返回:
        已补充 side 字段的契约问题列表。
    """

    # 复制后的问题列表不会反写原始 contract。
    list_issues: list[dict[str, Any]] = []  # 附加 side 后的契约问题

    # contract.issues 可能缺失，按空列表处理。
    for item in contract.get("issues", []) or []:

        # 只有 dict 形态问题才能安全附加 side 字段。
        if isinstance(item, dict):

            # side 字段帮助诊断问题来自 from 还是 to 阶段。
            list_issues.append({**item, "side": side})

    # 返回复制后的契约问题。
    return list_issues

# case_ids 检查器确认两阶段引用同一批参考用例。
def _check_cases(from_contract: dict[str, Any], to_contract: dict[str, Any]) -> list[dict[str, Any]]:
    """检查两阶段契约是否引用同一批 reference case。

    参数:
        from_contract: 上一阶段导出的契约字典。
        to_contract: 当前阶段导出的契约字典。

    返回:
        用例集合漂移问题列表；未漂移时返回空列表。
    """

    # from 阶段 case_ids 是参考契约期望覆盖的用例集合。
    set_expected_cases = {str(item) for item in from_contract.get("case_ids", []) or []}  # 参考阶段用例集合

    # to 阶段 case_ids 是当前契约实际覆盖的用例集合。
    set_observed_cases = {str(item) for item in to_contract.get("case_ids", []) or []}  # 当前阶段用例集合

    # 两侧都有用例且集合不一致时报告 warning。
    if set_expected_cases and set_observed_cases and set_expected_cases != set_observed_cases:

        # 用例集合漂移影响覆盖率，但不一定阻断生成。
        return [_issue("warning", "Reference case ids differ between stages.", source="testbench_issue")]

    # 没有发现用例集合漂移。
    return []

# 语义执行指标解析器把 transcript/checkpoint 失败转成契约问题。
def _semantic_execution_issues(contract: dict[str, Any]) -> dict[str, Any]:
    """把契约中的 semantic_execution 指标转换为统一诊断。

    参数:
        contract: 当前阶段导出的契约字典。

    返回:
        包含语义执行问题、ready 状态、漂移用例和定位置信度的摘要字典。
    """

    # metrics 只有 dict 形态时才可读取 semantic_execution。
    dict_metrics = contract.get("metrics") if isinstance(contract.get("metrics"), dict) else {}  # 当前契约指标对象

    # 原始 semantic_execution 可能缺失或不是对象，先以动态值承接。
    value_semantic_execution = dict_metrics.get("semantic_execution")  # 原始语义执行指标

    # semantic_execution 缺失时使用空字典表达当前阶段未运行语义用例。
    dict_semantic_execution = value_semantic_execution if isinstance(value_semantic_execution, dict) else {}  # 语义执行指标

    # 没有语义指标时返回空诊断，但保留字段形状。
    if not dict_semantic_execution:

        # None 表示未检查，而不是语义检查失败。
        return {
            "issues": [],
            "semantic_ready": None,
            "mismatched_cases": [],
            "checkpoint_drift": [],
            "failed_cases": [],
            "localization_confidence": None,
        }

    # 语义执行问题会附加到 verify_stage 的统一 issues。
    list_issues: list[dict[str, Any]] = []  # 语义执行问题列表

    # semantic_ready 是上游语义执行器的总体就绪判断。
    value_semantic_ready = dict_semantic_execution.get("semantic_ready")  # 语义执行总体状态

    # mismatched_cases 记录 reference/RTL 用例覆盖差异。
    mismatched_cases = dict_semantic_execution.get("mismatched_cases", []) or []  # 覆盖不一致的用例

    # checkpoint_drift 记录 checkpoint 名称或值的漂移。
    list_checkpoint_drift = dict_semantic_execution.get("checkpoint_drift", []) or []  # 语义检查点漂移列表

    # failed_cases 记录 transcript 中失败的用例。
    failed_cases = dict_semantic_execution.get("failed_cases", []) or []  # 语义执行失败用例

    # 显式布尔 False 表示语义用例或 checkpoint 尚未准备好。
    bool_semantic_failed = isinstance(value_semantic_ready, bool) and not value_semantic_ready  # 语义执行是否明确失败

    # 语义执行未就绪时给出阻断级问题。
    if bool_semantic_failed:

        # 长错误消息独立成变量，避免问题登记行过宽。
        str_message = (  # 语义执行未就绪诊断
            "Semantic execution is not ready; "  # 语义执行失败诊断前半句
            "reference cases or checkpoints are missing or mismatched."  # 缺失或不匹配原因
        )

        # 未就绪说明 testbench 语义闭环需要修复。
        list_issues.append(_issue("error", str_message, source="testbench_issue"))

    # 用例覆盖不一致时记录阻断级问题。
    if mismatched_cases:

        # case coverage 不一致会让 RTL 与 reference 不可比。
        list_issues.append(
            _issue("error", "Semantic case coverage differs from the semantic contract.", source="testbench_issue")
        )

    # checkpoint drift 表示语义观测点不一致。
    if list_checkpoint_drift:

        # checkpoint 漂移需要在 reference 或 RTL transcript 中修复。
        list_issues.append(_issue("error", "Semantic checkpoint drift was detected.", source="testbench_issue"))

    # transcript 中存在失败 case 时记录阻断级问题。
    if failed_cases:

        # failed_cases 表示语义执行已经跑通但用例结果失败。
        str_message = "Semantic transcript contains failed reference cases."  # transcript 失败用例诊断

        # 失败用例来自 testbench 语义执行链路。
        list_issues.append(_issue("error", str_message, source="testbench_issue"))

    # 返回字段保持旧版语义执行摘要形状。
    return {
        "issues": list_issues,
        "semantic_ready": value_semantic_ready,
        "mismatched_cases": mismatched_cases,
        "checkpoint_drift": list_checkpoint_drift,
        "failed_cases": failed_cases,
        "localization_confidence": dict_semantic_execution.get("localization_confidence"),
    }

# issue 构造器统一生成 severity/source/message 三字段诊断。
def _issue(severity: str, message: str, *, source: str = "current_module_issue") -> dict[str, Any]:
    """生成 workflow 报告使用的最小 issue 对象。

    参数:
        severity: 问题严重程度。
        message: 人类可读诊断文本。
        source: 问题来源分类，默认归入当前模块。

    返回:
        包含 severity、source 和 message 的 issue 字典。
    """

    # 返回最小 issue 结构，保持 workflow 报告兼容。
    return {"severity": severity, "source": source, "message": message}
```

## File: scripts/python/existing_rtl/verify_repair.py
size: 4693
sha: 8f984bd8483b93f467097ac141539d38d6cc5289
upstream: https://github.com/eriemon/verilog-generator/blob/HEAD/scripts/python/existing_rtl/verify_repair.py

```text
"""existing RTL verify-repair 的兼容入口。"""

# 延迟注解让 facade 只承担导出职责。
from __future__ import annotations

# 路径和宽松 JSON 类型用于复刻旧 facade 签名。
from pathlib import Path
from typing import Any

# 主流程模块承载 verify_existing 的完整编排。
from . import verify_repair_core as _core

# support 模块承载入口校验、日志诊断和稳定常量。
from . import verify_repair_support as _support

# automation mode 常量保持旧导出路径。
AUTOMATION_MODES: tuple[str, ...] = _support.AUTOMATION_MODES  # verify-repair 自动化模式集合

# TB language 集合在旧调用方里常用于 CLI choices。
TB_LANGUAGES: tuple[str, ...] = _support.TB_LANGUAGES  # testbench 语言集合

# TB mode 集合保持 generate/augment 分支的旧读取位置。
TB_MODES: tuple[str, ...] = _support.TB_MODES  # testbench 处理模式集合

# 日志诊断入口保留旧模块路径，便于外部脚本继续导入。
def diagnose_log_texts(*, compile_log: str, simulation_log: str, executed: bool) -> dict[str, Any]:
    """分类编译和仿真日志中的 verify-repair 诊断信息。

    Args:
        compile_log: 编译阶段输出文本。
        simulation_log: 仿真阶段输出文本。
        executed: 外部验证流程是否已经实际执行。

    Returns:
        可写入报告的日志诊断字典。
    """

    # 真实规则集中在 support 模块，facade 只保留旧入口。
    return _support.diagnose_log_texts(
        compile_log=compile_log,
        simulation_log=simulation_log,
        executed=executed,
    )

# automation mode 校验是写回权限进入 core 前的兼容 guard。
def require_automation_mode(str_value: str) -> str:
    """校验并规范化 verify-repair 自动化模式。

    Args:
        str_value: 调用方传入的自动化模式文本。

    Returns:
        support 模块认可的标准模式文本。
    """

    # 委托 support 保持错误消息和允许值完全一致。
    return _support.require_automation_mode(str_value)

# TB language 校验继续服务直接从旧模块导入的脚本。
def require_tb_language(str_value: str) -> str:
    """校验并规范化 testbench 语言。

    Args:
        str_value: 调用方传入的 testbench 语言文本。

    Returns:
        support 模块认可的标准语言文本。
    """

    # 委托 support 保持语言集合和大小写规整逻辑一致。
    return _support.require_tb_language(str_value)

# TB mode 校验继续隔离 testbench 生成与增强策略。
def require_tb_mode(str_value: str) -> str:
    """校验并规范化 testbench 处理模式。

    Args:
        str_value: 调用方传入的 testbench 模式文本。

    Returns:
        support 模块认可的标准模式文本。
    """

    # 委托 support 保持 generate/augment 分支边界一致。
    return _support.require_tb_mode(str_value)

# verify_existing 是对外主入口，真实实现位于 core helper。
def verify_existing(source_paths: list[Path], **dict_verify_options: Any) -> dict[str, Any]:
    """运行 existing RTL verify-repair，并保留旧 facade 入口。

    Args:
        source_paths: 待分析和验证的 RTL/TB 源文件路径。
        dict_verify_options: 旧调用方传入 core verify_existing 的关键字参数。

    Returns:
        verify-repair 运行报告和工件路径字典。
    """

    # core 模块承载真实编排，facade 不复制业务逻辑。
    return _core.verify_existing(source_paths, **dict_verify_options)

# 私有元组集中保存旧模块允许导入的稳定符号名。
tuple_public_verify_repair_exports: tuple[str, ...] = (  # verify_repair 旧导入语句允许解析的符号顺序
    "AUTOMATION_MODES",  # 旧调用方读取的自动化模式枚举
    "TB_LANGUAGES",  # 旧调用方读取的 testbench 语言枚举
    "TB_MODES",  # 旧调用方读取的 testbench 处理策略枚举
    "diagnose_log_texts",  # 旧调用方分析编译与仿真 transcript 的入口
    "require_automation_mode",  # 旧调用方校验 automation-mode 取值的入口
    "require_tb_language",  # 旧调用方校验 testbench 语言取值的入口
    "require_tb_mode",  # 旧调用方校验 testbench 模式取值的入口
    "verify_existing",  # 旧调用方启动 existing RTL verify-repair 的入口
)

# __all__ 保持 list 形态，避免旧测试或调用方依赖可变序列时失配。
__all__: list[str] = list(tuple_public_verify_repair_exports)  # 旧导入清单的 list 兼容副本
```

## File: scripts/python/existing_rtl/verify_repair_core.py
size: 46828
sha: 50bc4caa8d12e4f61de5d50618b0547816874a9e
upstream: https://github.com/eriemon/verilog-generator/blob/HEAD/scripts/python/existing_rtl/verify_repair_core.py

Content is not inlined in the catalog. Read the upstream file: https://github.com/eriemon/verilog-generator/blob/HEAD/scripts/python/existing_rtl/verify_repair_core.py

## File: scripts/python/existing_rtl/verify_repair_patch_apply.py
size: 24047
sha: 92a8eb43d8be91ff8af62c12032a8e7dc1854809
upstream: https://github.com/eriemon/verilog-generator/blob/HEAD/scripts/python/existing_rtl/verify_repair_patch_apply.py

Content is not inlined in the catalog. Read the upstream file: https://github.com/eriemon/verilog-generator/blob/HEAD/scripts/python/existing_rtl/verify_repair_patch_apply.py

## File: scripts/python/existing_rtl/verify_repair_patch_categories.py
size: 36325
sha: bdf59f4551071bd5dee57474b17d177022cbbda6
upstream: https://github.com/eriemon/verilog-generator/blob/HEAD/scripts/python/existing_rtl/verify_repair_patch_categories.py

Content is not inlined in the catalog. Read the upstream file: https://github.com/eriemon/verilog-generator/blob/HEAD/scripts/python/existing_rtl/verify_repair_patch_categories.py

## File: scripts/python/existing_rtl/verify_repair_patch_plan.py
size: 25659
sha: d97db9958713f89343c7d06b8965230d861ed9b5
upstream: https://github.com/eriemon/verilog-generator/blob/HEAD/scripts/python/existing_rtl/verify_repair_patch_plan.py

Content is not inlined in the catalog. Read the upstream file: https://github.com/eriemon/verilog-generator/blob/HEAD/scripts/python/existing_rtl/verify_repair_patch_plan.py

## File: scripts/python/existing_rtl/verify_repair_patching.py
size: 2476
sha: 27601a1d9c0c45d75bcbd9356ece620ef07f8151
upstream: https://github.com/eriemon/verilog-generator/blob/HEAD/scripts/python/existing_rtl/verify_repair_patching.py

```text
"""verify-repair 的 RTL patch facade，保持旧导入面稳定。"""

# 延迟类型求值，避免 facade 在类型解析阶段扩大耦合。
from __future__ import annotations

# patch 写回阶段的稳定公开入口从 apply 子模块转发。
from .verify_repair_patch_apply import (
    RtlMutationContext,
    apply_rtl_patch as _apply_rtl_patch,
    decision_allows_apply,
    handle_rtl_mutation,
)

# post-apply 证据与人工确认入口继续复用 apply 子模块。
from .verify_repair_patch_apply import (
    post_apply_equivalence_payload,
    post_apply_validation_payload,
    read_decision,
    write_rtl_intervention,
)

# patch 类别与候选生成 helper 从 categories 子模块转发。
from .verify_repair_patch_categories import (
    build_root_cause_evidence,
    declared_reg_outputs,
    extract_reset_block,
    extract_reset_block_match,
    extract_reset_block_span,
)

# patch 类别补丁生成 helper 继续从 categories 子模块转发。
from .verify_repair_patch_categories import (
    inferred_output_assignment,
    insert_output_register_assignments as _insert_output_register_assignments,
    insert_reset_assignments as _insert_reset_assignments,
    insert_state_hold_branch as _insert_state_hold_branch,
)

# patch 风险与输出推断 helper 继续从 categories 子模块转发。
from .verify_repair_patch_categories import (
    missing_output_register_assignments as _missing_output_register_assignments,
    patch_case_default_completion,
    patch_missing_reset_initialization,
    patch_output_register_completion,
)

# patch 风险等级和信号推断 helper 继续从 categories 子模块转发。
from .verify_repair_patch_categories import (
    patch_risk_level as _patch_risk_level,
    patch_state_hold_completion,
    reset_assignment,
    select_patch_candidate as _select_patch_candidate,
    signal_widths,
)

# patch 计划与策略 helper 从 plan 子模块转发。
from .verify_repair_patch_plan import (
    build_patch_candidate,
    build_rtl_patch_plan,
    multi_file_patch_plan as _multi_file_patch_plan,
    recommended_action,
    rtl_mutation_policy,
)

# patch 策略补充 helper 继续从 plan 子模块转发。
from .verify_repair_patch_plan import (
    rtl_no_candidate_policy as _rtl_no_candidate_policy,
    rtl_wait_confirmation as _rtl_wait_confirmation,
    source_mutation_policy,
    tb_mutation_policy,
    write_candidate_and_compare as _write_candidate_and_compare,
)

```

## File: scripts/python/existing_rtl/verify_repair_support.py
size: 26251
sha: 3fb550d318e3763e749896bd812e971af907899a
upstream: https://github.com/eriemon/verilog-generator/blob/HEAD/scripts/python/existing_rtl/verify_repair_support.py

Content is not inlined in the catalog. Read the upstream file: https://github.com/eriemon/verilog-generator/blob/HEAD/scripts/python/existing_rtl/verify_repair_support.py

## File: scripts/python/existing_rtl/verify_repair_testbench.py
size: 46984
sha: cba2c323f1dcb4a7369dabddc43e9a4caa761ca2
upstream: https://github.com/eriemon/verilog-generator/blob/HEAD/scripts/python/existing_rtl/verify_repair_testbench.py

Content is not inlined in the catalog. Read the upstream file: https://github.com/eriemon/verilog-generator/blob/HEAD/scripts/python/existing_rtl/verify_repair_testbench.py

## File: scripts/python/existing_rtl/verify_reporting.py
size: 16532
sha: fc7a1e755a559709555967bb47654b0c0e3a3b0a
upstream: https://github.com/eriemon/verilog-generator/blob/HEAD/scripts/python/existing_rtl/verify_reporting.py

Content is not inlined in the catalog. Read the upstream file: https://github.com/eriemon/verilog-generator/blob/HEAD/scripts/python/existing_rtl/verify_reporting.py

## File: scripts/python/facade/__init__.py
size: 45
sha: 9c0cf5921c9fea2a2af025941e8cfaa4bdf4dca0
upstream: https://github.com/eriemon/verilog-generator/blob/HEAD/scripts/python/facade/__init__.py

```text
"""对外公开的 Verilog facade 包。"""
```

## File: scripts/python/facade/existing_rtl_api.py
size: 14318
sha: 53bd121a8380794b4e57f6d68d82cd65b4886d4b
upstream: https://github.com/eriemon/verilog-generator/blob/HEAD/scripts/python/facade/existing_rtl_api.py

Content is not inlined in the catalog. Read the upstream file: https://github.com/eriemon/verilog-generator/blob/HEAD/scripts/python/facade/existing_rtl_api.py

## File: scripts/python/facade/quality_api.py
size: 20422
sha: 2793394794fdd7b8eb7da15bc89f8a1d18a83402
upstream: https://github.com/eriemon/verilog-generator/blob/HEAD/scripts/python/facade/quality_api.py

Content is not inlined in the catalog. Read the upstream file: https://github.com/eriemon/verilog-generator/blob/HEAD/scripts/python/facade/quality_api.py

## File: scripts/python/facade/representative_cases.py
size: 39177
sha: 16e91ee2c6a2d9c2b2c15f64523ea4323cdbcee0
upstream: https://github.com/eriemon/verilog-generator/blob/HEAD/scripts/python/facade/representative_cases.py

Content is not inlined in the catalog. Read the upstream file: https://github.com/eriemon/verilog-generator/blob/HEAD/scripts/python/facade/representative_cases.py

## File: scripts/python/facade/verilog_api.py
size: 6685
sha: 0d8650660bb6c168271528b996d647c1b11160df
upstream: https://github.com/eriemon/verilog-generator/blob/HEAD/scripts/python/facade/verilog_api.py

```text
"""Verilog-only 生成、分析和验证公开 facade API。"""

# future annotations 避免注解在导入期求值。
from __future__ import annotations

# Any 用于兼容旧 facade 的自由配置字典；其余类型描述 spec bundle 输入。
from pathlib import Path
from typing import Any, Callable, Mapping, Sequence

# runtime 路由器负责只分类请求、不触发生成执行。
from scripts.python.workflow.workflow_router import route_verilog_entry

# 统一 VG 门禁入口由质量模块直接提供，避免 facade 复制规则逻辑。
from scripts.python.quality.quality_gate import run_verilog_quality_gate

# spec_document 是规范文档、接口交叉核验和 WaveDrom 伴随包的唯一实现入口。
from scripts.python.workflow.spec_document import write_spec_bundle

# existing-RTL 相关公开能力从子模块重导出。
from .existing_rtl_api import (
    analyze_existing_verilog,
    compare_verilog_semantics,
    improve_existing_verilog,
    verify_existing_verilog,
)

# 质量门与工件验证能力从子模块重导出。
from .quality_api import (
    check_verilog_deliverable,
    check_verilog_quality,
    validate_verilog_artifacts,
)

# 代表性案例运行入口和常量从子模块重导出。
from .representative_cases import (
    DEFAULT_CASE_RUN_DIR,
    REPRESENTATIVE_BAD_CASE_IDS,
    REPRESENTATIVE_CASE_CATALOG,
    REPRESENTATIVE_CASE_ORDER,
    REPRESENTATIVE_IDEAL_CASE_IDS,
    run_verilog_cases,
)

# 工作流 facade 的类型与兼容辅助函数从子模块重导出。
from .workflow_api import (
    JsonSource,
    PathCollectionSource,
    _merged_option_dict,
)

# 工作流 facade 的公开执行入口从子模块重导出。
from .workflow_api import (
    load_default_workflow_config,
    load_workflow_result,
    render_verilog_prompt,
    run_verilog_batch,
    run_verilog_workflow,
)

# __all__ 固定 facade 对外导出的稳定符号集合。
__all__ = [
    "JsonSource",  # 公共 spec 输入类型
    "PathCollectionSource",  # 公共路径集合输入类型
    "DEFAULT_CASE_RUN_DIR",  # 代表性案例默认运行目录名
    "REPRESENTATIVE_BAD_CASE_IDS",  # 负例代表性案例 ID 集合
    "REPRESENTATIVE_CASE_CATALOG",  # 代表性案例目录映射
    "REPRESENTATIVE_CASE_ORDER",  # 代表性案例稳定排序
    "REPRESENTATIVE_IDEAL_CASE_IDS",  # 正例代表性案例 ID 集合
    "run_verilog_workflow",  # 主工作流执行入口
    "run_verilog_batch",  # 批量工作流执行入口
    "render_verilog_prompt",  # 提示词渲染入口
    "validate_verilog_artifacts",  # 工件验证入口
    "check_verilog_deliverable",  # 交付门入口
    "check_verilog_quality",  # 质量门入口
    "run_verilog_quality_gate",  # 统一 VG 门禁入口
    "analyze_existing_verilog",  # 既有 RTL 分析入口
    "improve_existing_verilog",  # 既有 RTL 精修入口
    "compare_verilog_semantics",  # RTL 语义比较入口
    "verify_existing_verilog",  # 既有 RTL 验证修复入口
    "run_verilog_cases",  # 代表性案例运行入口
    "route_verilog_request",  # 请求分类入口
    "load_default_workflow_config",  # 默认工作流配置加载入口
    "load_workflow_result",  # 工作流结果读取入口
]  # facade 导出符号表

# route_verilog_request 保留旧 facade 的请求分类入口。
def route_verilog_request(
    *,
    config: dict[str, Any] | None = None,
    **legacy_options: Any,
) -> dict[str, Any]:
    """分类 Verilog 请求，但不执行生成或验证。

    参数:
        config: 新式 facade 配置字典；缺省时仅使用 legacy_options。
        legacy_options: 旧调用方传入的兼容关键字参数。

    返回:
        返回 workflow_router 的请求分类结果字典。
    """

    # 路由白名单文本集中声明兼容字段，避免列表元素注释之间互相相似。
    str_allowed_keys_text = (
        "request_summary spec codegen_plan rtl testbench "
        "logs waveform validation artifact_dir remote_validation_requested"
    )  # 路由入口允许的兼容键文本

    # 再把键文本切成集合，只允许这些字段参与请求分类。
    set_allowed_keys = set(str_allowed_keys_text.split())  # 路由入口允许透传给分类器的字段集合

    # 兼容配置字典把新旧调用参数合并为统一入口视图。
    dict_options = _merged_option_dict(  # 归一化后的路由参数
        "route_verilog_request",  # 当前 facade 入口名称
        config,  # 新式配置字典
        legacy_options,  # 旧式关键字参数
        allowed_keys=set_allowed_keys,  # 允许的兼容字段集合
    )

    # 仅把归一化字段传给 runtime 路由器做分类判定。
    return route_verilog_entry(
        request_summary=str(dict_options.get("request_summary", "")),
        spec=dict_options.get("spec"),
        codegen_plan=dict_options.get("codegen_plan"),
        rtl=dict_options.get("rtl"),
        testbench=dict_options.get("testbench"),
        logs=dict_options.get("logs"),
        waveform=dict_options.get("waveform"),
        validation=dict_options.get("validation"),
        artifact_dir=dict_options.get("artifact_dir"),
        remote_validation_requested=bool(
            dict_options.get("remote_validation_requested", False),
        ),
    )

# write_verilog_specs 为生成、既有 RTL 和独立 CLI 共用同一 spec-first 核心。
def write_verilog_specs(
    spec: Mapping[str, Any] | Path,
    out_dir: Path,
    *,
    source_paths: Sequence[Path] | None = None,
    language: str = "zh",
    renderer: Callable[[Path, Path], dict[str, Any]] | None = None,
) -> dict[str, Any]:
    """
    写出每个 Verilog 模块的 ``*_spec.md``、WaveJSON 和 SVG 伴随包。

    :param spec: 单模块或多模块规范对象，也可以是 JSON 文件路径。
    :param out_dir: 交付工件根目录。
    :param source_paths: 可选 RTL 源文件，用于模块和端口严格交叉核验。
    :param language: Markdown 语言，支持 ``zh`` 或 ``en``。
    :param renderer: 可选 WaveDrom 渲染器替身，默认使用固定 runtime。
    :return: 模块级写出报告，包含 ``ok``、``spec_root`` 和 ``modules``。
    :raises ValueError: 规范字段、源接口或 WaveDrom 渲染失败时抛出。
    """

    # facade 不复制 spec 规则，只把统一入口暴露给上层调用方。
    return write_spec_bundle(
        spec,
        out_dir,
        source_paths=source_paths,
        language=language,
        renderer=renderer,
    )
```

## File: scripts/python/facade/workflow_api.py
size: 64739
sha: d08e329f083d729e39a0e72321585af1cdfdd6c4
upstream: https://github.com/eriemon/verilog-generator/blob/HEAD/scripts/python/facade/workflow_api.py

Content is not inlined in the catalog. Read the upstream file: https://github.com/eriemon/verilog-generator/blob/HEAD/scripts/python/facade/workflow_api.py

## File: scripts/python/generation/tb_generator.py
size: 56245
sha: f88799cc4d64a69c16a078a0cc4f6e21c496edf1
upstream: https://github.com/eriemon/verilog-generator/blob/HEAD/scripts/python/generation/tb_generator.py

Content is not inlined in the catalog. Read the upstream file: https://github.com/eriemon/verilog-generator/blob/HEAD/scripts/python/generation/tb_generator.py

## File: scripts/python/header_contract.py
size: 21628
sha: 06e1dec4d0be0efa11d48750c657d63bd19e6913
upstream: https://github.com/eriemon/verilog-generator/blob/HEAD/scripts/python/header_contract.py

Content is not inlined in the catalog. Read the upstream file: https://github.com/eriemon/verilog-generator/blob/HEAD/scripts/python/header_contract.py

## File: scripts/python/installation/__init__.py
size: 52
sha: 7f934481eea6402d07e6ad5ba66d10b774f7b4e3
upstream: https://github.com/eriemon/verilog-generator/blob/HEAD/scripts/python/installation/__init__.py

```text
"""参数化技能安装器的标准库实现。"""
```

## File: scripts/python/installation/bundle.py
size: 16678
sha: f1e6608231d4bdbaacb5a73f8b701b414c20e28d
upstream: https://github.com/eriemon/verilog-generator/blob/HEAD/scripts/python/installation/bundle.py

Content is not inlined in the catalog. Read the upstream file: https://github.com/eriemon/verilog-generator/blob/HEAD/scripts/python/installation/bundle.py

## File: scripts/python/installation/catalog.py
size: 16950
sha: bd019b0a995f8cf1c9d497f676e7b563c9aa5531
upstream: https://github.com/eriemon/verilog-generator/blob/HEAD/scripts/python/installation/catalog.py

Content is not inlined in the catalog. Read the upstream file: https://github.com/eriemon/verilog-generator/blob/HEAD/scripts/python/installation/catalog.py

## File: scripts/python/installation/cli.py
size: 27002
sha: c080fdd3f1bda6bf3176c3f5ed516a01411c4a58
upstream: https://github.com/eriemon/verilog-generator/blob/HEAD/scripts/python/installation/cli.py

Content is not inlined in the catalog. Read the upstream file: https://github.com/eriemon/verilog-generator/blob/HEAD/scripts/python/installation/cli.py

## File: scripts/python/installation/projection.py
size: 14584
sha: b06d9145cf927c929ce526f4672003fbed1f0b36
upstream: https://github.com/eriemon/verilog-generator/blob/HEAD/scripts/python/installation/projection.py

Content is not inlined in the catalog. Read the upstream file: https://github.com/eriemon/verilog-generator/blob/HEAD/scripts/python/installation/projection.py

## File: scripts/python/installation/receipt.py
size: 13763
sha: fe72eab40646d06277119dba6b1941e64301409e
upstream: https://github.com/eriemon/verilog-generator/blob/HEAD/scripts/python/installation/receipt.py

Content is not inlined in the catalog. Read the upstream file: https://github.com/eriemon/verilog-generator/blob/HEAD/scripts/python/installation/receipt.py

## File: scripts/python/installation/transaction.py
size: 29663
sha: c62b0a9c3d17e973d1e130c63c78ac853fcdffca
upstream: https://github.com/eriemon/verilog-generator/blob/HEAD/scripts/python/installation/transaction.py

Content is not inlined in the catalog. Read the upstream file: https://github.com/eriemon/verilog-generator/blob/HEAD/scripts/python/installation/transaction.py

## File: scripts/python/quality/clock_name_roles.py
size: 1059
sha: e8a3806d4a5ce072e986353574fe6be08f02adcf
upstream: https://github.com/eriemon/verilog-generator/blob/HEAD/scripts/python/quality/clock_name_roles.py

```text
"""集中定义 Verilog 时钟名称的下划线语义段识别规则。"""

# 推迟类型标注求值，保持质量模块导入边界稳定。
from __future__ import annotations

# 正则表达式只处理已经抽取出的 Verilog 标识符名称。
import re

# 时钟词干覆盖通用、AXI、AHB 和 APB 常见命名。
CLOCK_NAME_PATTERN = re.compile(  # 完整时钟语义段名称模式
    r"(?:^|_)(?:clk|clock|aclk|hclk|pclk)(?=_|$)",  # 时钟段前后必须是下划线边界或名称边界
    flags=re.IGNORECASE,  # Verilog 标识符角色不依赖大小写风格
)

# 单个标识符只要包含完整时钟段就具有 clock 角色。
def is_clock_name(str_name: str) -> bool:
    """判断标识符是否包含完整的时钟语义段。

    参数:
        str_name: 待判断的 Verilog 标识符。
    返回:
        名称包含受控 clock 语义段时返回 True。
    """

    # search 允许时钟段出现在任意下划线分隔位置。
    return CLOCK_NAME_PATTERN.search(str_name) is not None
```

## File: scripts/python/quality/comment_placement.py
size: 50648
sha: 71b975d1439fbd120459f4733fa2e1d4c8e4f5a5
upstream: https://github.com/eriemon/verilog-generator/blob/HEAD/scripts/python/quality/comment_placement.py

Content is not inlined in the catalog. Read the upstream file: https://github.com/eriemon/verilog-generator/blob/HEAD/scripts/python/quality/comment_placement.py

## File: scripts/python/quality/declaration_region_policy.py
size: 8194
sha: 56d8012ee6fe8aaad4f75b67a451acddedbea704
upstream: https://github.com/eriemon/verilog-generator/blob/HEAD/scripts/python/quality/declaration_region_policy.py

Content is not inlined in the catalog. Read the upstream file: https://github.com/eriemon/verilog-generator/blob/HEAD/scripts/python/quality/declaration_region_policy.py

## File: scripts/python/quality/deliverable_gate.py
size: 53183
sha: f5c26d8372e0fc38e6f5d81a073fdcba1c48c981
upstream: https://github.com/eriemon/verilog-generator/blob/HEAD/scripts/python/quality/deliverable_gate.py

Content is not inlined in the catalog. Read the upstream file: https://github.com/eriemon/verilog-generator/blob/HEAD/scripts/python/quality/deliverable_gate.py

## File: scripts/python/quality/external_interface_stubs.py
size: 42458
sha: 5ddf7314fb406f4d8a4e3e03590170af4a1a1ddd
upstream: https://github.com/eriemon/verilog-generator/blob/HEAD/scripts/python/quality/external_interface_stubs.py

Content is not inlined in the catalog. Read the upstream file: https://github.com/eriemon/verilog-generator/blob/HEAD/scripts/python/quality/external_interface_stubs.py

## File: scripts/python/quality/formatter_ast.py
size: 87084
sha: 248afe5f3b3d19974b36a3cd2e5e1c1541293f0b
upstream: https://github.com/eriemon/verilog-generator/blob/HEAD/scripts/python/quality/formatter_ast.py

Content is not inlined in the catalog. Read the upstream file: https://github.com/eriemon/verilog-generator/blob/HEAD/scripts/python/quality/formatter_ast.py

## File: scripts/python/quality/formatter_ast_instances.py
size: 5564
sha: b5ffb3212fd7e7d962a1a6c83978e4281e69ec24
upstream: https://github.com/eriemon/verilog-generator/blob/HEAD/scripts/python/quality/formatter_ast_instances.py

Content is not inlined in the catalog. Read the upstream file: https://github.com/eriemon/verilog-generator/blob/HEAD/scripts/python/quality/formatter_ast_instances.py

## File: scripts/python/quality/formatter_backend/__init__.py
size: 777
sha: 6c2309c06def508ac9fb132a1c9405caae1e5c55
upstream: https://github.com/eriemon/verilog-generator/blob/HEAD/scripts/python/quality/formatter_backend/__init__.py

```text
"""汇总 Verilog formatter 后端的公开入口。"""

# 后端协议和默认实现保持旧导入路径兼容。
from .base import FormatterBackend
from .builtin_backend import BuiltinFormatterBackend
from .engine import VerilogFormatterEngine, VerilogFormatterError
from .factory import create_backend
from .format_routing import FormatRouteResult

# __all__ 明确暴露 formatter backend 的稳定 API 名称。
__all__ = [
    "FormatterBackend",  # 抽象后端协议
    "BuiltinFormatterBackend",  # 随包 formatter 默认实现
    "VerilogFormatterEngine",  # 具体解析和渲染引擎
    "VerilogFormatterError",  # formatter 层统一异常
    "FormatRouteResult",  # 路由阶段结果模型
    "create_backend",  # 后端工厂入口
]
```

## File: scripts/python/quality/formatter_backend/analysis_mixin.py
size: 207851
sha: 36cb5ba808ac4225efb61655b3eff7cc179c985b
upstream: https://github.com/eriemon/verilog-generator/blob/HEAD/scripts/python/quality/formatter_backend/analysis_mixin.py

Content is not inlined in the catalog. Read the upstream file: https://github.com/eriemon/verilog-generator/blob/HEAD/scripts/python/quality/formatter_backend/analysis_mixin.py

## File: scripts/python/quality/formatter_backend/banners.py
size: 8793
sha: 68d775219c6a70a4bcfd310dcf2bd548896583fc
upstream: https://github.com/eriemon/verilog-generator/blob/HEAD/scripts/python/quality/formatter_backend/banners.py

Content is not inlined in the catalog. Read the upstream file: https://github.com/eriemon/verilog-generator/blob/HEAD/scripts/python/quality/formatter_backend/banners.py

## File: scripts/python/quality/formatter_backend/base.py
size: 3335
sha: 4cf6c585da8bffbd131a03e46d1ac721c7858b68
upstream: https://github.com/eriemon/verilog-generator/blob/HEAD/scripts/python/quality/formatter_backend/base.py

```text
"""定义 Verilog formatter 后端需要实现的抽象接口。"""

# 延迟类型注解求值，降低接口模块导入成本
from __future__ import annotations

# 抽象基类用于约束具体后端必须实现的能力
from abc import ABC, abstractmethod
from pathlib import Path

# FormatterBackend 是 formatter CLI 和 runtime AST 检查之间的稳定协议
class FormatterBackend(ABC):
    """约束 formatter 后端的格式化和检查接口。"""

    # 路径级格式化接口同时覆盖写文件、检查和 diff 三类 CLI 模式
    @abstractmethod

    # 路径级入口承载 CLI 写回策略，具体后端必须明确实现
    def format_path(
        self,
        input_path: Path,
        output_path: Path | None = None,

        # 以下布尔参数直接映射 CLI 行为开关，保持接口层显式可读
        inplace: bool = False,
        check: bool = False,
        diff: bool = False,
    ) -> tuple[int, str]:
        """
        格式化或检查指定路径的 RTL 文件。

        :param input_path: 输入 RTL 文件路径。
        :param output_path: 可选输出文件路径。
        :param inplace: 是否原地改写输入文件。
        :param check: 是否只检查格式而不写出。
        :param diff: 是否输出格式差异。
        :return: 进程式状态码和用户可读消息。
        :raises NotImplementedError: 具体后端未提供路径级格式化实现时抛出。
        """

        # 路径格式化涉及写盘策略，必须由具体后端按自身能力实现
        raise NotImplementedError("> ERR: [Python] formatter 后端未实现路径级格式化接口。")

    # 文本级格式化接口供 runtime AST 检查和单测直接复用
    @abstractmethod

    # 文本级入口服务内存中的 generated RTL，不应触碰文件系统
    def format_text(self, source: str, source_path: Path | None = None) -> str:
        """
        格式化内存中的 RTL 文本。

        :param source: 待格式化的 Verilog 文本。
        :param source_path: 可选来源路径，用于错误消息和规则上下文。
        :return: 格式化后的 RTL 文本。
        :raises NotImplementedError: 具体后端未提供文本格式化实现时抛出。
        """

        # 文本格式化不能在协议层猜测语法策略，交给后端实现
        raise NotImplementedError("> ERR: [Python] formatter 后端未实现文本格式化接口。")

    # 文本级检查接口只返回诊断，不改写输入文本
    @abstractmethod

    # 检查入口只报告格式问题，调用方据此决定是否阻断写回
    def check_text(self, source: str, source_path: Path | None = None) -> list[str]:
        """
        检查内存中的 RTL 文本并返回诊断列表。

        :param source: 待检查的 Verilog 文本。
        :param source_path: 可选来源路径，用于诊断定位。
        :return: formatter 检查发现的诊断消息列表。
        :raises NotImplementedError: 具体后端未提供文本检查实现时抛出。
        """

        # 诊断生成依赖后端规则集，协议层只固定返回类型
        raise NotImplementedError("> ERR: [Python] formatter 后端未实现文本检查接口。")

```

## File: scripts/python/quality/formatter_backend/builtin_backend.py
size: 525
sha: 4cefc54381cc4414244f4111d1d1894c88f48dcf
upstream: https://github.com/eriemon/verilog-generator/blob/HEAD/scripts/python/quality/formatter_backend/builtin_backend.py

```text
"""提供随包内置 Verilog formatter 后端类型。"""

# 延迟类型注解求值，保持后端导入轻量
from __future__ import annotations

# 后端接口与本地模板驱动引擎共同组成内置实现
from .base import FormatterBackend
from .engine import VerilogFormatterEngine

# 内置后端复用本地引擎，并显式声明符合 FormatterBackend 协议
class BuiltinFormatterBackend(VerilogFormatterEngine, FormatterBackend):
    """基于本地模板驱动引擎的 formatter 后端。"""
```

## File: scripts/python/quality/formatter_backend/constants.py
size: 26252
sha: 5503ff18375b3ff9c8d8ba1e42bb9876f00f6acc
upstream: https://github.com/eriemon/verilog-generator/blob/HEAD/scripts/python/quality/formatter_backend/constants.py

Content is not inlined in the catalog. Read the upstream file: https://github.com/eriemon/verilog-generator/blob/HEAD/scripts/python/quality/formatter_backend/constants.py

## File: scripts/python/quality/formatter_backend/control_node_classifier.py
size: 2795
sha: 29a59c2c54c7a3663a9384ff405c3e77db4a9279
upstream: https://github.com/eriemon/verilog-generator/blob/HEAD/scripts/python/quality/formatter_backend/control_node_classifier.py

Content is not inlined in the catalog. Read the upstream file: https://github.com/eriemon/verilog-generator/blob/HEAD/scripts/python/quality/formatter_backend/control_node_classifier.py

## File: scripts/python/quality/formatter_backend/control_node_collectors.py
size: 12153
sha: b4bba12b65f1f8443d5fe9b42cf71b68d36b2252
upstream: https://github.com/eriemon/verilog-generator/blob/HEAD/scripts/python/quality/formatter_backend/control_node_collectors.py

Content is not inlined in the catalog. Read the upstream file: https://github.com/eriemon/verilog-generator/blob/HEAD/scripts/python/quality/formatter_backend/control_node_collectors.py

## File: scripts/python/quality/formatter_backend/control_node_normalize.py
size: 12800
sha: 81e2b80945a6a8a8dc2e79b3ed96f38c6db1f883
upstream: https://github.com/eriemon/verilog-generator/blob/HEAD/scripts/python/quality/formatter_backend/control_node_normalize.py

Content is not inlined in the catalog. Read the upstream file: https://github.com/eriemon/verilog-generator/blob/HEAD/scripts/python/quality/formatter_backend/control_node_normalize.py

## File: scripts/python/quality/formatter_backend/control_node_parse_mixin.py
size: 77204
sha: 538de326462dc84fc80e7b2e003b2745c1076543
upstream: https://github.com/eriemon/verilog-generator/blob/HEAD/scripts/python/quality/formatter_backend/control_node_parse_mixin.py

Content is not inlined in the catalog. Read the upstream file: https://github.com/eriemon/verilog-generator/blob/HEAD/scripts/python/quality/formatter_backend/control_node_parse_mixin.py

## File: scripts/python/quality/formatter_backend/control_parse_mixin.py
size: 172909
sha: 0a9d89827a86bc8b5b17c895e1e0d4733116e2da
upstream: https://github.com/eriemon/verilog-generator/blob/HEAD/scripts/python/quality/formatter_backend/control_parse_mixin.py

Content is not inlined in the catalog. Read the upstream file: https://github.com/eriemon/verilog-generator/blob/HEAD/scripts/python/quality/formatter_backend/control_parse_mixin.py

## File: scripts/python/quality/formatter_backend/engine.py
size: 72612
sha: 8fd7e59f287bf911c4267a0d9a18be924bcac252
upstream: https://github.com/eriemon/verilog-generator/blob/HEAD/scripts/python/quality/formatter_backend/engine.py

Content is not inlined in the catalog. Read the upstream file: https://github.com/eriemon/verilog-generator/blob/HEAD/scripts/python/quality/formatter_backend/engine.py

## File: scripts/python/quality/formatter_backend/expression_facts.py
size: 101219
sha: 1ae810b20e189d898433f2c5d64322bfb851efb0
upstream: https://github.com/eriemon/verilog-generator/blob/HEAD/scripts/python/quality/formatter_backend/expression_facts.py

Content is not inlined in the catalog. Read the upstream file: https://github.com/eriemon/verilog-generator/blob/HEAD/scripts/python/quality/formatter_backend/expression_facts.py

## File: scripts/python/quality/formatter_backend/factory.py
size: 1639
sha: 9a633ca4abad6fa1f685280e0091c0235a30bf45
upstream: https://github.com/eriemon/verilog-generator/blob/HEAD/scripts/python/quality/formatter_backend/factory.py

Content is not inlined in the catalog. Read the upstream file: https://github.com/eriemon/verilog-generator/blob/HEAD/scripts/python/quality/formatter_backend/factory.py

## File: scripts/python/quality/formatter_backend/file_discovery.py
size: 5958
sha: 29d82b1b405dd2fba21b7afe0ac3c7f8697c565e
upstream: https://github.com/eriemon/verilog-generator/blob/HEAD/scripts/python/quality/formatter_backend/file_discovery.py

Content is not inlined in the catalog. Read the upstream file: https://github.com/eriemon/verilog-generator/blob/HEAD/scripts/python/quality/formatter_backend/file_discovery.py

## File: scripts/python/quality/formatter_backend/format_routing.py
size: 12440
sha: 475e8e70d9a8e7aae042458997094f2b69bf9959
upstream: https://github.com/eriemon/verilog-generator/blob/HEAD/scripts/python/quality/formatter_backend/format_routing.py

Content is not inlined in the catalog. Read the upstream file: https://github.com/eriemon/verilog-generator/blob/HEAD/scripts/python/quality/formatter_backend/format_routing.py

## File: scripts/python/quality/formatter_backend/guards.py
size: 7038
sha: e423eb4307c61bccaff86417c77920ed4accd293
upstream: https://github.com/eriemon/verilog-generator/blob/HEAD/scripts/python/quality/formatter_backend/guards.py

Content is not inlined in the catalog. Read the upstream file: https://github.com/eriemon/verilog-generator/blob/HEAD/scripts/python/quality/formatter_backend/guards.py

## File: scripts/python/quality/formatter_backend/header_mixin.py
size: 114652
sha: 334de1fd341cf93872eb2b37830a79364d26cea8
upstream: https://github.com/eriemon/verilog-generator/blob/HEAD/scripts/python/quality/formatter_backend/header_mixin.py

Content is not inlined in the catalog. Read the upstream file: https://github.com/eriemon/verilog-generator/blob/HEAD/scripts/python/quality/formatter_backend/header_mixin.py

## File: scripts/python/quality/formatter_backend/instance_lexing.py
size: 13682
sha: 16aed53617a574593961b2f5ae3924d8759ed153
upstream: https://github.com/eriemon/verilog-generator/blob/HEAD/scripts/python/quality/formatter_backend/instance_lexing.py

Content is not inlined in the catalog. Read the upstream file: https://github.com/eriemon/verilog-generator/blob/HEAD/scripts/python/quality/formatter_backend/instance_lexing.py

## File: scripts/python/quality/formatter_backend/layout_mixin.py
size: 133883
sha: 48926d5e021712c6b282459349f17813e6631d2b
upstream: https://github.com/eriemon/verilog-generator/blob/HEAD/scripts/python/quality/formatter_backend/layout_mixin.py

Content is not inlined in the catalog. Read the upstream file: https://github.com/eriemon/verilog-generator/blob/HEAD/scripts/python/quality/formatter_backend/layout_mixin.py

## File: scripts/python/quality/formatter_backend/lvalue_mixin.py
size: 39142
sha: 55ea0a53c2eae1d5142f330d832a62f9248b56d1
upstream: https://github.com/eriemon/verilog-generator/blob/HEAD/scripts/python/quality/formatter_backend/lvalue_mixin.py

Content is not inlined in the catalog. Read the upstream file: https://github.com/eriemon/verilog-generator/blob/HEAD/scripts/python/quality/formatter_backend/lvalue_mixin.py

## File: scripts/python/quality/formatter_backend/models.py
size: 36203
sha: 6aee4ef86a983aeff69440a5f17f405c8e1a3e97
upstream: https://github.com/eriemon/verilog-generator/blob/HEAD/scripts/python/quality/formatter_backend/models.py

Content is not inlined in the catalog. Read the upstream file: https://github.com/eriemon/verilog-generator/blob/HEAD/scripts/python/quality/formatter_backend/models.py

## File: scripts/python/quality/formatter_backend/parse_mixin.py
size: 87394
sha: 74d1e7098b7aab3087ab9695c78f48a54da06960
upstream: https://github.com/eriemon/verilog-generator/blob/HEAD/scripts/python/quality/formatter_backend/parse_mixin.py

Content is not inlined in the catalog. Read the upstream file: https://github.com/eriemon/verilog-generator/blob/HEAD/scripts/python/quality/formatter_backend/parse_mixin.py

## File: scripts/python/quality/formatter_backend/rename_mixin.py
size: 119625
sha: fe051a93205d4e963f48c54fe0f65b75f4e5573a
upstream: https://github.com/eriemon/verilog-generator/blob/HEAD/scripts/python/quality/formatter_backend/rename_mixin.py

Content is not inlined in the catalog. Read the upstream file: https://github.com/eriemon/verilog-generator/blob/HEAD/scripts/python/quality/formatter_backend/rename_mixin.py

## File: scripts/python/quality/formatter_backend/render_mixin.py
size: 154407
sha: 06e15990fe4edc9a5479adf1315a51543cd32e93
upstream: https://github.com/eriemon/verilog-generator/blob/HEAD/scripts/python/quality/formatter_backend/render_mixin.py

Content is not inlined in the catalog. Read the upstream file: https://github.com/eriemon/verilog-generator/blob/HEAD/scripts/python/quality/formatter_backend/render_mixin.py

## File: scripts/python/quality/formatter_backend/statement_render_mixin.py
size: 174143
sha: 4303c9d26b215440477bebe802323879ef7c312e
upstream: https://github.com/eriemon/verilog-generator/blob/HEAD/scripts/python/quality/formatter_backend/statement_render_mixin.py

Content is not inlined in the catalog. Read the upstream file: https://github.com/eriemon/verilog-generator/blob/HEAD/scripts/python/quality/formatter_backend/statement_render_mixin.py

## File: scripts/python/quality/formatter_backend/syntax_utils.py
size: 83760
sha: 91a71d5fa47924a5b2bd20382bcdcf71d7191166
upstream: https://github.com/eriemon/verilog-generator/blob/HEAD/scripts/python/quality/formatter_backend/syntax_utils.py

Content is not inlined in the catalog. Read the upstream file: https://github.com/eriemon/verilog-generator/blob/HEAD/scripts/python/quality/formatter_backend/syntax_utils.py

## File: scripts/python/quality/formatter_backend/textio.py
size: 1521
sha: 0010f67efbfca8642ec1046cbb051e9062511d6b
upstream: https://github.com/eriemon/verilog-generator/blob/HEAD/scripts/python/quality/formatter_backend/textio.py

Content is not inlined in the catalog. Read the upstream file: https://github.com/eriemon/verilog-generator/blob/HEAD/scripts/python/quality/formatter_backend/textio.py

## File: scripts/python/quality/formatter_comments.py
size: 15253
sha: 75bfe93dbf69acf3bef3b2b19107345897ad7006
upstream: https://github.com/eriemon/verilog-generator/blob/HEAD/scripts/python/quality/formatter_comments.py

Content is not inlined in the catalog. Read the upstream file: https://github.com/eriemon/verilog-generator/blob/HEAD/scripts/python/quality/formatter_comments.py

## File: scripts/python/quality/formatter_config.py
size: 9480
sha: 93b71d195c2514fab9ccccc865a7b0bfdfc84c6b
upstream: https://github.com/eriemon/verilog-generator/blob/HEAD/scripts/python/quality/formatter_config.py

Content is not inlined in the catalog. Read the upstream file: https://github.com/eriemon/verilog-generator/blob/HEAD/scripts/python/quality/formatter_config.py

## File: scripts/python/quality/quality_gate.py
size: 45758
sha: 49f6a7a1d1656137c2eee3bbe5092523e1548fb6
upstream: https://github.com/eriemon/verilog-generator/blob/HEAD/scripts/python/quality/quality_gate.py

Content is not inlined in the catalog. Read the upstream file: https://github.com/eriemon/verilog-generator/blob/HEAD/scripts/python/quality/quality_gate.py

## File: scripts/python/quality/quality_gate_ast.py
size: 6314
sha: caeb8ba20b25d605cbe0faf87c63b6f6301ca3dd
upstream: https://github.com/eriemon/verilog-generator/blob/HEAD/scripts/python/quality/quality_gate_ast.py

Content is not inlined in the catalog. Read the upstream file: https://github.com/eriemon/verilog-generator/blob/HEAD/scripts/python/quality/quality_gate_ast.py

## File: scripts/python/quality/quality_gate_comment_rules.py
size: 94684
sha: d8e83ec569b7d4b9c82adacec4d07afd3e5cb982
upstream: https://github.com/eriemon/verilog-generator/blob/HEAD/scripts/python/quality/quality_gate_comment_rules.py

Content is not inlined in the catalog. Read the upstream file: https://github.com/eriemon/verilog-generator/blob/HEAD/scripts/python/quality/quality_gate_comment_rules.py

## File: scripts/python/quality/quality_gate_common.py
size: 64368
sha: 10f8397791041267cf1d98e8b5abdfd4c6c725ca
upstream: https://github.com/eriemon/verilog-generator/blob/HEAD/scripts/python/quality/quality_gate_common.py

Content is not inlined in the catalog. Read the upstream file: https://github.com/eriemon/verilog-generator/blob/HEAD/scripts/python/quality/quality_gate_common.py

## File: scripts/python/quality/quality_gate_fsm_rules.py
size: 46875
sha: de5624277c781fa9d37cf462df17ee6842c76122
upstream: https://github.com/eriemon/verilog-generator/blob/HEAD/scripts/python/quality/quality_gate_fsm_rules.py

Content is not inlined in the catalog. Read the upstream file: https://github.com/eriemon/verilog-generator/blob/HEAD/scripts/python/quality/quality_gate_fsm_rules.py

## File: scripts/python/quality/quality_gate_header_rules.py
size: 54892
sha: 522797ebe7527ced868e22654bd06118d740ee8d
upstream: https://github.com/eriemon/verilog-generator/blob/HEAD/scripts/python/quality/quality_gate_header_rules.py

Content is not inlined in the catalog. Read the upstream file: https://github.com/eriemon/verilog-generator/blob/HEAD/scripts/python/quality/quality_gate_header_rules.py

## File: scripts/python/quality/quality_gate_protocol_rules.py
size: 34492
sha: 5de04d8c0e51d2eb3c4f751874ecbc00a1f3189f
upstream: https://github.com/eriemon/verilog-generator/blob/HEAD/scripts/python/quality/quality_gate_protocol_rules.py

Content is not inlined in the catalog. Read the upstream file: https://github.com/eriemon/verilog-generator/blob/HEAD/scripts/python/quality/quality_gate_protocol_rules.py

## File: scripts/python/quality/quality_gate_region_rules.py
size: 63680
sha: b3f2574b89bf26a2713223d5b9d5ccb53cd32e6f
upstream: https://github.com/eriemon/verilog-generator/blob/HEAD/scripts/python/quality/quality_gate_region_rules.py

Content is not inlined in the catalog. Read the upstream file: https://github.com/eriemon/verilog-generator/blob/HEAD/scripts/python/quality/quality_gate_region_rules.py

## File: scripts/python/quality/quality_gate_reports.py
size: 2220
sha: 6a58388493ba9ba792d5383067f940356aeae56a
upstream: https://github.com/eriemon/verilog-generator/blob/HEAD/scripts/python/quality/quality_gate_reports.py

Content is not inlined in the catalog. Read the upstream file: https://github.com/eriemon/verilog-generator/blob/HEAD/scripts/python/quality/quality_gate_reports.py

## File: scripts/python/quality/quality_gate_structure_rules.py
size: 202315
sha: 491316e592685a1a17fbb4117b8833d236713222
upstream: https://github.com/eriemon/verilog-generator/blob/HEAD/scripts/python/quality/quality_gate_structure_rules.py

Content is not inlined in the catalog. Read the upstream file: https://github.com/eriemon/verilog-generator/blob/HEAD/scripts/python/quality/quality_gate_structure_rules.py

## File: scripts/python/quality/quality_gate_text_rules.py
size: 76390
sha: 6ba408ca7a1a5a1b34472e75691efc9ca6c336e7
upstream: https://github.com/eriemon/verilog-generator/blob/HEAD/scripts/python/quality/quality_gate_text_rules.py

Content is not inlined in the catalog. Read the upstream file: https://github.com/eriemon/verilog-generator/blob/HEAD/scripts/python/quality/quality_gate_text_rules.py

## File: scripts/python/quality/quality_gate_types.py
size: 24386
sha: c84cbf2ef2b1fda7ae7b0db43ccc525716adb8be
upstream: https://github.com/eriemon/verilog-generator/blob/HEAD/scripts/python/quality/quality_gate_types.py

Content is not inlined in the catalog. Read the upstream file: https://github.com/eriemon/verilog-generator/blob/HEAD/scripts/python/quality/quality_gate_types.py

## File: scripts/python/quality/reset_name_roles.py
size: 2155
sha: 44f0527e40e3b5120bfe11baf425864bc3bf1286
upstream: https://github.com/eriemon/verilog-generator/blob/HEAD/scripts/python/quality/reset_name_roles.py

Content is not inlined in the catalog. Read the upstream file: https://github.com/eriemon/verilog-generator/blob/HEAD/scripts/python/quality/reset_name_roles.py

## File: scripts/python/quality/static_lint.py
size: 6016
sha: 3289208165653363063ad6c295d2199229432d35
upstream: https://github.com/eriemon/verilog-generator/blob/HEAD/scripts/python/quality/static_lint.py

Content is not inlined in the catalog. Read the upstream file: https://github.com/eriemon/verilog-generator/blob/HEAD/scripts/python/quality/static_lint.py

## File: scripts/python/quality/verify_verilog_comment_only.py
size: 32985
sha: 49f18b98eb278a08d1b5dcb521196f1047739095
upstream: https://github.com/eriemon/verilog-generator/blob/HEAD/scripts/python/quality/verify_verilog_comment_only.py

Content is not inlined in the catalog. Read the upstream file: https://github.com/eriemon/verilog-generator/blob/HEAD/scripts/python/quality/verify_verilog_comment_only.py

## File: scripts/python/quality/verilog_lint.py
size: 16056
sha: 2aeeae7bbba52309552b4ddfc5208a76e7af1b5b
upstream: https://github.com/eriemon/verilog-generator/blob/HEAD/scripts/python/quality/verilog_lint.py

Content is not inlined in the catalog. Read the upstream file: https://github.com/eriemon/verilog-generator/blob/HEAD/scripts/python/quality/verilog_lint.py

## File: scripts/python/quality/verilog_quality_gate.py
size: 11053
sha: 1231f4e8b359d8c40d98077423e37ad05968a7c7
upstream: https://github.com/eriemon/verilog-generator/blob/HEAD/scripts/python/quality/verilog_quality_gate.py

Content is not inlined in the catalog. Read the upstream file: https://github.com/eriemon/verilog-generator/blob/HEAD/scripts/python/quality/verilog_quality_gate.py

## File: scripts/python/quality/vg_branch_rules.py
size: 44367
sha: b2687b196a36b0f4918c4299679b408c650be685
upstream: https://github.com/eriemon/verilog-generator/blob/HEAD/scripts/python/quality/vg_branch_rules.py

Content is not inlined in the catalog. Read the upstream file: https://github.com/eriemon/verilog-generator/blob/HEAD/scripts/python/quality/vg_branch_rules.py

## File: scripts/python/quality/vg_clock_rules.py
size: 40695
sha: 2bef73179052aa9156fd2214853af6a9d26c36e1
upstream: https://github.com/eriemon/verilog-generator/blob/HEAD/scripts/python/quality/vg_clock_rules.py

Content is not inlined in the catalog. Read the upstream file: https://github.com/eriemon/verilog-generator/blob/HEAD/scripts/python/quality/vg_clock_rules.py

## File: scripts/python/quality/vg_comb_cone.py
size: 74203
sha: 7f8fcf50480742408dd4e8560c7adf3fe3a00d8c
upstream: https://github.com/eriemon/verilog-generator/blob/HEAD/scripts/python/quality/vg_comb_cone.py

Content is not inlined in the catalog. Read the upstream file: https://github.com/eriemon/verilog-generator/blob/HEAD/scripts/python/quality/vg_comb_cone.py

## File: scripts/python/quality/vg_comb_model.py
size: 25735
sha: 9c6d5b4a17db5f1490460f32fcce32741ce530e8
upstream: https://github.com/eriemon/verilog-generator/blob/HEAD/scripts/python/quality/vg_comb_model.py

Content is not inlined in the catalog. Read the upstream file: https://github.com/eriemon/verilog-generator/blob/HEAD/scripts/python/quality/vg_comb_model.py

## File: scripts/python/quality/vg_comb_selectors.py
size: 33468
sha: 3185431c8007177aa5ef2c7e5834a43501a5be24
upstream: https://github.com/eriemon/verilog-generator/blob/HEAD/scripts/python/quality/vg_comb_selectors.py

Content is not inlined in the catalog. Read the upstream file: https://github.com/eriemon/verilog-generator/blob/HEAD/scripts/python/quality/vg_comb_selectors.py

## File: scripts/python/quality/vg_comb_targets.py
size: 218406
sha: 0c0ceb1df656c355c51b5a4df5ff205961ae3a02
upstream: https://github.com/eriemon/verilog-generator/blob/HEAD/scripts/python/quality/vg_comb_targets.py

Content is not inlined in the catalog. Read the upstream file: https://github.com/eriemon/verilog-generator/blob/HEAD/scripts/python/quality/vg_comb_targets.py

## File: scripts/python/quality/vg_comb_tracing.py
size: 5062
sha: 34695db8d47dc403481d923a5bb3e47aaedc96b6
upstream: https://github.com/eriemon/verilog-generator/blob/HEAD/scripts/python/quality/vg_comb_tracing.py

Content is not inlined in the catalog. Read the upstream file: https://github.com/eriemon/verilog-generator/blob/HEAD/scripts/python/quality/vg_comb_tracing.py

## File: scripts/python/quality/vg_comment_integrity.py
size: 32611
sha: 184f0a60cdbfa1b7e299e0c4eb19f5d86d810ea2
upstream: https://github.com/eriemon/verilog-generator/blob/HEAD/scripts/python/quality/vg_comment_integrity.py

Content is not inlined in the catalog. Read the upstream file: https://github.com/eriemon/verilog-generator/blob/HEAD/scripts/python/quality/vg_comment_integrity.py

## File: scripts/python/quality/vg_comment_version.py
size: 5227
sha: 1e79a4631fb8077d1f32016672febddb413e7339
upstream: https://github.com/eriemon/verilog-generator/blob/HEAD/scripts/python/quality/vg_comment_version.py

Content is not inlined in the catalog. Read the upstream file: https://github.com/eriemon/verilog-generator/blob/HEAD/scripts/python/quality/vg_comment_version.py

## File: scripts/python/quality/vg_contract_handshake.py
size: 13057
sha: b1d287d464dc72bd30b8f73881f0273d67da0ca2
upstream: https://github.com/eriemon/verilog-generator/blob/HEAD/scripts/python/quality/vg_contract_handshake.py

Content is not inlined in the catalog. Read the upstream file: https://github.com/eriemon/verilog-generator/blob/HEAD/scripts/python/quality/vg_contract_handshake.py

## File: scripts/python/quality/vg_contract_liveness.py
size: 19390
sha: 79de9f74ebbe8a8fada6074b31156869df17910a
upstream: https://github.com/eriemon/verilog-generator/blob/HEAD/scripts/python/quality/vg_contract_liveness.py

Content is not inlined in the catalog. Read the upstream file: https://github.com/eriemon/verilog-generator/blob/HEAD/scripts/python/quality/vg_contract_liveness.py

## File: scripts/python/quality/vg_contract_parameter.py
size: 20477
sha: e62a7bec536f24a8715850c9764d882c515b91b2
upstream: https://github.com/eriemon/verilog-generator/blob/HEAD/scripts/python/quality/vg_contract_parameter.py

Content is not inlined in the catalog. Read the upstream file: https://github.com/eriemon/verilog-generator/blob/HEAD/scripts/python/quality/vg_contract_parameter.py

## File: scripts/python/quality/vg_contract_parser.py
size: 28422
sha: d174d25745ef4410b20c5775dc1eed1371a8e563
upstream: https://github.com/eriemon/verilog-generator/blob/HEAD/scripts/python/quality/vg_contract_parser.py

Content is not inlined in the catalog. Read the upstream file: https://github.com/eriemon/verilog-generator/blob/HEAD/scripts/python/quality/vg_contract_parser.py

## File: scripts/python/quality/vg_contract_resource.py
size: 12102
sha: e5e884a3e5a05a56b3d3dfbd32afa87bb383e26e
upstream: https://github.com/eriemon/verilog-generator/blob/HEAD/scripts/python/quality/vg_contract_resource.py

Content is not inlined in the catalog. Read the upstream file: https://github.com/eriemon/verilog-generator/blob/HEAD/scripts/python/quality/vg_contract_resource.py

## File: scripts/python/quality/vg_contract_rules.py
size: 1747
sha: 2d739ed0ebcfa9fbdecc463999da450968040ff9
upstream: https://github.com/eriemon/verilog-generator/blob/HEAD/scripts/python/quality/vg_contract_rules.py

Content is not inlined in the catalog. Read the upstream file: https://github.com/eriemon/verilog-generator/blob/HEAD/scripts/python/quality/vg_contract_rules.py

## File: scripts/python/quality/vg_control_rules.py
size: 56568
sha: 96ef494e940cfd0cfbd07317f44425595bc2d071
upstream: https://github.com/eriemon/verilog-generator/blob/HEAD/scripts/python/quality/vg_control_rules.py

Content is not inlined in the catalog. Read the upstream file: https://github.com/eriemon/verilog-generator/blob/HEAD/scripts/python/quality/vg_control_rules.py

## File: scripts/python/quality/vg_diagnostic_render.py
size: 15495
sha: 1dd7a6f671a49e9a475b78b142cfc48051c17490
upstream: https://github.com/eriemon/verilog-generator/blob/HEAD/scripts/python/quality/vg_diagnostic_render.py

Content is not inlined in the catalog. Read the upstream file: https://github.com/eriemon/verilog-generator/blob/HEAD/scripts/python/quality/vg_diagnostic_render.py

## File: scripts/python/quality/vg_diagnostics.py
size: 31257
sha: 6d70e9ad603ab8b630e06b430d2c8edfa8f7e9eb
upstream: https://github.com/eriemon/verilog-generator/blob/HEAD/scripts/python/quality/vg_diagnostics.py

Content is not inlined in the catalog. Read the upstream file: https://github.com/eriemon/verilog-generator/blob/HEAD/scripts/python/quality/vg_diagnostics.py

## File: scripts/python/quality/vg_driver_rules.py
size: 12230
sha: e02d1ef8acb4f5505b5be98d401e9cdd3fa69230
upstream: https://github.com/eriemon/verilog-generator/blob/HEAD/scripts/python/quality/vg_driver_rules.py

Content is not inlined in the catalog. Read the upstream file: https://github.com/eriemon/verilog-generator/blob/HEAD/scripts/python/quality/vg_driver_rules.py

## File: scripts/python/quality/vg_expression_rules.py
size: 44377
sha: ded39e65a28b831cf9f9a3439db6b172f46a9fbd
upstream: https://github.com/eriemon/verilog-generator/blob/HEAD/scripts/python/quality/vg_expression_rules.py

Content is not inlined in the catalog. Read the upstream file: https://github.com/eriemon/verilog-generator/blob/HEAD/scripts/python/quality/vg_expression_rules.py

## File: scripts/python/quality/vg_file_rules.py
size: 56838
sha: cca9ac3a65da2852576b60c0bf7baa1fe5931399
upstream: https://github.com/eriemon/verilog-generator/blob/HEAD/scripts/python/quality/vg_file_rules.py

Content is not inlined in the catalog. Read the upstream file: https://github.com/eriemon/verilog-generator/blob/HEAD/scripts/python/quality/vg_file_rules.py

## File: scripts/python/quality/vg_fsm_rules.py
size: 41269
sha: adeded5b9e2baa61dac80fb60ae131dfffaa2b18
upstream: https://github.com/eriemon/verilog-generator/blob/HEAD/scripts/python/quality/vg_fsm_rules.py

Content is not inlined in the catalog. Read the upstream file: https://github.com/eriemon/verilog-generator/blob/HEAD/scripts/python/quality/vg_fsm_rules.py

## File: scripts/python/quality/vg_identifier_rules.py
size: 23153
sha: 18d75dd424c449e8554f3a0044fded0a856aa74a
upstream: https://github.com/eriemon/verilog-generator/blob/HEAD/scripts/python/quality/vg_identifier_rules.py

Content is not inlined in the catalog. Read the upstream file: https://github.com/eriemon/verilog-generator/blob/HEAD/scripts/python/quality/vg_identifier_rules.py

## File: scripts/python/quality/vg_instance_rules.py
size: 24365
sha: f6e79d8e2dc393d22394bc7c5073df9d66435f25
upstream: https://github.com/eriemon/verilog-generator/blob/HEAD/scripts/python/quality/vg_instance_rules.py

Content is not inlined in the catalog. Read the upstream file: https://github.com/eriemon/verilog-generator/blob/HEAD/scripts/python/quality/vg_instance_rules.py

## File: scripts/python/quality/vg_primitive_facts.py
size: 26141
sha: aa280d0694efe92ac5f2b2f10605b270e007e7ed
upstream: https://github.com/eriemon/verilog-generator/blob/HEAD/scripts/python/quality/vg_primitive_facts.py

Content is not inlined in the catalog. Read the upstream file: https://github.com/eriemon/verilog-generator/blob/HEAD/scripts/python/quality/vg_primitive_facts.py

## File: scripts/python/quality/vg_report_publisher.py
size: 5701
sha: 53eb4f4b1a58bb5dab369e434b1e4da44af692b3
upstream: https://github.com/eriemon/verilog-generator/blob/HEAD/scripts/python/quality/vg_report_publisher.py

Content is not inlined in the catalog. Read the upstream file: https://github.com/eriemon/verilog-generator/blob/HEAD/scripts/python/quality/vg_report_publisher.py

## File: scripts/python/quality/vg_reset_rules.py
size: 56149
sha: 01f0ebebb791bf00c26f833af8a833fde8608b18
upstream: https://github.com/eriemon/verilog-generator/blob/HEAD/scripts/python/quality/vg_reset_rules.py

Content is not inlined in the catalog. Read the upstream file: https://github.com/eriemon/verilog-generator/blob/HEAD/scripts/python/quality/vg_reset_rules.py

## File: scripts/python/quality/vg_rule_models.py
size: 10176
sha: f0864e53f7a1e5c0ec7468e01ed0f73e7dd781af
upstream: https://github.com/eriemon/verilog-generator/blob/HEAD/scripts/python/quality/vg_rule_models.py

Content is not inlined in the catalog. Read the upstream file: https://github.com/eriemon/verilog-generator/blob/HEAD/scripts/python/quality/vg_rule_models.py

## File: scripts/python/quality/vg_semantic_engine.py
size: 40091
sha: 1286c5eaf4e3b09bdcf146f4ed0bfe8645182684
upstream: https://github.com/eriemon/verilog-generator/blob/HEAD/scripts/python/quality/vg_semantic_engine.py

Content is not inlined in the catalog. Read the upstream file: https://github.com/eriemon/verilog-generator/blob/HEAD/scripts/python/quality/vg_semantic_engine.py

## File: scripts/python/quality/vg_semantic_facts.py
size: 21973
sha: dc9dcb244790444a70fc9a7c9f39317b8861ea14
upstream: https://github.com/eriemon/verilog-generator/blob/HEAD/scripts/python/quality/vg_semantic_facts.py

Content is not inlined in the catalog. Read the upstream file: https://github.com/eriemon/verilog-generator/blob/HEAD/scripts/python/quality/vg_semantic_facts.py

## File: scripts/python/quality/vg_structure_rules.py
size: 50413
sha: 266dc10d67813921b88a5254b5845877855543f6
upstream: https://github.com/eriemon/verilog-generator/blob/HEAD/scripts/python/quality/vg_structure_rules.py

Content is not inlined in the catalog. Read the upstream file: https://github.com/eriemon/verilog-generator/blob/HEAD/scripts/python/quality/vg_structure_rules.py

## File: scripts/python/quality/vg_subprogram_rules.py
size: 32023
sha: 215dd6e3ecd23e7f19a8bbd90221afc4808b1dde
upstream: https://github.com/eriemon/verilog-generator/blob/HEAD/scripts/python/quality/vg_subprogram_rules.py

Content is not inlined in the catalog. Read the upstream file: https://github.com/eriemon/verilog-generator/blob/HEAD/scripts/python/quality/vg_subprogram_rules.py

## File: scripts/python/quality/vg_trace_session.py
size: 26517
sha: 1dbe4fcb16dbfe6660769d5e13aab1f4ebc2018b
upstream: https://github.com/eriemon/verilog-generator/blob/HEAD/scripts/python/quality/vg_trace_session.py

Content is not inlined in the catalog. Read the upstream file: https://github.com/eriemon/verilog-generator/blob/HEAD/scripts/python/quality/vg_trace_session.py

## File: scripts/python/quality/vg_trace_walk.py
size: 59585
sha: b90c6249e7da8c6e24f76b0426f2e9aa5f7787ac
upstream: https://github.com/eriemon/verilog-generator/blob/HEAD/scripts/python/quality/vg_trace_walk.py

Content is not inlined in the catalog. Read the upstream file: https://github.com/eriemon/verilog-generator/blob/HEAD/scripts/python/quality/vg_trace_walk.py

## File: scripts/python/quality/vg_value_facts.py
size: 41867
sha: 3663321107c846aef613ce1565dbd5e8aa2655b0
upstream: https://github.com/eriemon/verilog-generator/blob/HEAD/scripts/python/quality/vg_value_facts.py

Content is not inlined in the catalog. Read the upstream file: https://github.com/eriemon/verilog-generator/blob/HEAD/scripts/python/quality/vg_value_facts.py

## File: scripts/python/registry/__init__.py
size: 0
sha: e69de29bb2d1d6434b8b29ae775ad8c2e48c5391
upstream: https://github.com/eriemon/verilog-generator/blob/HEAD/scripts/python/registry/__init__.py

```text

```

## File: scripts/python/registry/build_registry.py
size: 20869
sha: abf6c31b6bb6e99e6194097d0af810d74d40bd4a
upstream: https://github.com/eriemon/verilog-generator/blob/HEAD/scripts/python/registry/build_registry.py

Content is not inlined in the catalog. Read the upstream file: https://github.com/eriemon/verilog-generator/blob/HEAD/scripts/python/registry/build_registry.py

## File: scripts/python/registry/document_registry_common.py
size: 63776
sha: d77b90fdeb32083eb411639cc06411bf7d32eac7
upstream: https://github.com/eriemon/verilog-generator/blob/HEAD/scripts/python/registry/document_registry_common.py

Content is not inlined in the catalog. Read the upstream file: https://github.com/eriemon/verilog-generator/blob/HEAD/scripts/python/registry/document_registry_common.py

## File: scripts/python/registry/manage_document_registry.py
size: 13217
sha: 1f4f1ccde742081b134ae7da38b218286bf39bde
upstream: https://github.com/eriemon/verilog-generator/blob/HEAD/scripts/python/registry/manage_document_registry.py

Content is not inlined in the catalog. Read the upstream file: https://github.com/eriemon/verilog-generator/blob/HEAD/scripts/python/registry/manage_document_registry.py

## File: scripts/python/registry/query_registry.py
size: 38013
sha: ecc0a7af47492be8720fc46efbd5e5e2e299ea68
upstream: https://github.com/eriemon/verilog-generator/blob/HEAD/scripts/python/registry/query_registry.py

Content is not inlined in the catalog. Read the upstream file: https://github.com/eriemon/verilog-generator/blob/HEAD/scripts/python/registry/query_registry.py

## File: scripts/python/registry/registry_common.py
size: 59403
sha: cdc0cc79719b345b491f72673990000af3ce6d4f
upstream: https://github.com/eriemon/verilog-generator/blob/HEAD/scripts/python/registry/registry_common.py

Content is not inlined in the catalog. Read the upstream file: https://github.com/eriemon/verilog-generator/blob/HEAD/scripts/python/registry/registry_common.py

## File: scripts/python/remote/remote_archive_integrity.py
size: 969
sha: e9045da80c5743d0e980bfc58155e704661b735c
upstream: https://github.com/eriemon/verilog-generator/blob/HEAD/scripts/python/remote/remote_archive_integrity.py

Content is not inlined in the catalog. Read the upstream file: https://github.com/eriemon/verilog-generator/blob/HEAD/scripts/python/remote/remote_archive_integrity.py

## File: scripts/python/remote/remote_evidence_runtime.py
size: 31590
sha: 2b6a82b282474ef80a237c2acd7d6c0fb037fac7
upstream: https://github.com/eriemon/verilog-generator/blob/HEAD/scripts/python/remote/remote_evidence_runtime.py

Content is not inlined in the catalog. Read the upstream file: https://github.com/eriemon/verilog-generator/blob/HEAD/scripts/python/remote/remote_evidence_runtime.py

## File: scripts/python/remote/remote_output_cleanup.py
size: 1804
sha: 499fb246e9a945707cadc6cbf92f245295bfa3a1
upstream: https://github.com/eriemon/verilog-generator/blob/HEAD/scripts/python/remote/remote_output_cleanup.py

Content is not inlined in the catalog. Read the upstream file: https://github.com/eriemon/verilog-generator/blob/HEAD/scripts/python/remote/remote_output_cleanup.py

## File: scripts/python/remote/remote_pytest_summary.py
size: 13780
sha: 89e18eeec3b2b269852c0a3323b23bdf3f07d824
upstream: https://github.com/eriemon/verilog-generator/blob/HEAD/scripts/python/remote/remote_pytest_summary.py

Content is not inlined in the catalog. Read the upstream file: https://github.com/eriemon/verilog-generator/blob/HEAD/scripts/python/remote/remote_pytest_summary.py

## File: scripts/python/remote/remote_selection.py
size: 12566
sha: 10bf82b4d2d65436c4dbf4259c5726b18ddf554f
upstream: https://github.com/eriemon/verilog-generator/blob/HEAD/scripts/python/remote/remote_selection.py

Content is not inlined in the catalog. Read the upstream file: https://github.com/eriemon/verilog-generator/blob/HEAD/scripts/python/remote/remote_selection.py

## File: scripts/python/remote/remote_stage_manifest.py
size: 14454
sha: ca7792bf0e13fefd04736132fd737f792060b854
upstream: https://github.com/eriemon/verilog-generator/blob/HEAD/scripts/python/remote/remote_stage_manifest.py

Content is not inlined in the catalog. Read the upstream file: https://github.com/eriemon/verilog-generator/blob/HEAD/scripts/python/remote/remote_stage_manifest.py

## File: scripts/python/remote/remote_validate_execution.py
size: 89246
sha: b606cc32893bac913d8b93e72bc52fb5cde7c993
upstream: https://github.com/eriemon/verilog-generator/blob/HEAD/scripts/python/remote/remote_validate_execution.py

Content is not inlined in the catalog. Read the upstream file: https://github.com/eriemon/verilog-generator/blob/HEAD/scripts/python/remote/remote_validate_execution.py

## File: scripts/python/remote/remote_validate_gates.py
size: 15051
sha: 3337633e669859b74e4465d651109039ecc9bbca
upstream: https://github.com/eriemon/verilog-generator/blob/HEAD/scripts/python/remote/remote_validate_gates.py

Content is not inlined in the catalog. Read the upstream file: https://github.com/eriemon/verilog-generator/blob/HEAD/scripts/python/remote/remote_validate_gates.py

## File: scripts/python/remote/remote_validate_selection.py
size: 25127
sha: c5f05ed4605b3b040f0c6512d686bbaa65f45dd2
upstream: https://github.com/eriemon/verilog-generator/blob/HEAD/scripts/python/remote/remote_validate_selection.py

Content is not inlined in the catalog. Read the upstream file: https://github.com/eriemon/verilog-generator/blob/HEAD/scripts/python/remote/remote_validate_selection.py

## File: scripts/python/remote/remote_validate_snippets.py
size: 61215
sha: b480969ce595e4c0d635510be611f93504e002e9
upstream: https://github.com/eriemon/verilog-generator/blob/HEAD/scripts/python/remote/remote_validate_snippets.py

Content is not inlined in the catalog. Read the upstream file: https://github.com/eriemon/verilog-generator/blob/HEAD/scripts/python/remote/remote_validate_snippets.py

## File: scripts/python/remote/remote_validate_verilog_skill.py
size: 78953
sha: 079b0f330448f83fdac08916433dd128ccb400c5
upstream: https://github.com/eriemon/verilog-generator/blob/HEAD/scripts/python/remote/remote_validate_verilog_skill.py

Content is not inlined in the catalog. Read the upstream file: https://github.com/eriemon/verilog-generator/blob/HEAD/scripts/python/remote/remote_validate_verilog_skill.py

## File: scripts/python/remote/remote_validation_context.py
size: 23817
sha: a19855ebda55a4433a8701450d115e9b48318389
upstream: https://github.com/eriemon/verilog-generator/blob/HEAD/scripts/python/remote/remote_validation_context.py

Content is not inlined in the catalog. Read the upstream file: https://github.com/eriemon/verilog-generator/blob/HEAD/scripts/python/remote/remote_validation_context.py

## File: scripts/python/remote/test_evidence_receipt.py
size: 30191
sha: 91ee3b1779ead4736bd7d37ef9ddd8cf3cae434e
upstream: https://github.com/eriemon/verilog-generator/blob/HEAD/scripts/python/remote/test_evidence_receipt.py

Content is not inlined in the catalog. Read the upstream file: https://github.com/eriemon/verilog-generator/blob/HEAD/scripts/python/remote/test_evidence_receipt.py

## File: scripts/python/toolchain/dependency_fpga_route.py
size: 20448
sha: 647065ac2dd09e08fcd8a2e8d8cfa59bb21887f3
upstream: https://github.com/eriemon/verilog-generator/blob/HEAD/scripts/python/toolchain/dependency_fpga_route.py

Content is not inlined in the catalog. Read the upstream file: https://github.com/eriemon/verilog-generator/blob/HEAD/scripts/python/toolchain/dependency_fpga_route.py

## File: scripts/python/toolchain/dependency_install.py
size: 19541
sha: 604793fa494cd6cdf35a83d44943cd093c4c8d41
upstream: https://github.com/eriemon/verilog-generator/blob/HEAD/scripts/python/toolchain/dependency_install.py

Content is not inlined in the catalog. Read the upstream file: https://github.com/eriemon/verilog-generator/blob/HEAD/scripts/python/toolchain/dependency_install.py

## File: scripts/python/toolchain/dependency_state.py
size: 52914
sha: 52e1aebf94542975c737a80f548243afb510f44c
upstream: https://github.com/eriemon/verilog-generator/blob/HEAD/scripts/python/toolchain/dependency_state.py

Content is not inlined in the catalog. Read the upstream file: https://github.com/eriemon/verilog-generator/blob/HEAD/scripts/python/toolchain/dependency_state.py

## File: scripts/python/toolchain/manage_skill_dependencies.py
size: 40731
sha: af08fa2d6a3e88525054d976a283f7ab9c5b0cac
upstream: https://github.com/eriemon/verilog-generator/blob/HEAD/scripts/python/toolchain/manage_skill_dependencies.py

Content is not inlined in the catalog. Read the upstream file: https://github.com/eriemon/verilog-generator/blob/HEAD/scripts/python/toolchain/manage_skill_dependencies.py

## File: scripts/python/toolchain/preflight_verilog_toolchain.py
size: 23989
sha: 85465faa36a00bc3af286db1f763eee8f008da39
upstream: https://github.com/eriemon/verilog-generator/blob/HEAD/scripts/python/toolchain/preflight_verilog_toolchain.py

Content is not inlined in the catalog. Read the upstream file: https://github.com/eriemon/verilog-generator/blob/HEAD/scripts/python/toolchain/preflight_verilog_toolchain.py

## File: scripts/python/toolchain/wavedrom_runtime.py
size: 59579
sha: 7c84861f94c2411bd51cddbdfb7a5675092ebfed
upstream: https://github.com/eriemon/verilog-generator/blob/HEAD/scripts/python/toolchain/wavedrom_runtime.py

Content is not inlined in the catalog. Read the upstream file: https://github.com/eriemon/verilog-generator/blob/HEAD/scripts/python/toolchain/wavedrom_runtime.py

## File: scripts/python/validation/audit.py
size: 18417
sha: be3f0844c172a1575509e96b0e5938490142ebf2
upstream: https://github.com/eriemon/verilog-generator/blob/HEAD/scripts/python/validation/audit.py

Content is not inlined in the catalog. Read the upstream file: https://github.com/eriemon/verilog-generator/blob/HEAD/scripts/python/validation/audit.py

## File: scripts/python/validation/eval_suite.py
size: 10515
sha: 8291a39bd6ea7e9904f2e0d717093eea3cd717da
upstream: https://github.com/eriemon/verilog-generator/blob/HEAD/scripts/python/validation/eval_suite.py

Content is not inlined in the catalog. Read the upstream file: https://github.com/eriemon/verilog-generator/blob/HEAD/scripts/python/validation/eval_suite.py

## File: scripts/python/validation/evaluation.py
size: 44145
sha: 65ee2afbd516ee5774587128fe9080785805e93a
upstream: https://github.com/eriemon/verilog-generator/blob/HEAD/scripts/python/validation/evaluation.py

Content is not inlined in the catalog. Read the upstream file: https://github.com/eriemon/verilog-generator/blob/HEAD/scripts/python/validation/evaluation.py

## File: scripts/python/validation/evidence.py
size: 25866
sha: b2b9766f72aba8fe9f2e62cc291718fb2a9dc464
upstream: https://github.com/eriemon/verilog-generator/blob/HEAD/scripts/python/validation/evidence.py

Content is not inlined in the catalog. Read the upstream file: https://github.com/eriemon/verilog-generator/blob/HEAD/scripts/python/validation/evidence.py

## File: scripts/python/validation/generated_deliverable_gate.py
size: 13276
sha: 5e9b84634b6190f66abdf05d8d0391ed6453351c
upstream: https://github.com/eriemon/verilog-generator/blob/HEAD/scripts/python/validation/generated_deliverable_gate.py

Content is not inlined in the catalog. Read the upstream file: https://github.com/eriemon/verilog-generator/blob/HEAD/scripts/python/validation/generated_deliverable_gate.py

## File: scripts/python/validation/installer_audit.py
size: 41649
sha: 50a12cf28f932e33adc697df700bf2d35ef593a5
upstream: https://github.com/eriemon/verilog-generator/blob/HEAD/scripts/python/validation/installer_audit.py

Content is not inlined in the catalog. Read the upstream file: https://github.com/eriemon/verilog-generator/blob/HEAD/scripts/python/validation/installer_audit.py

## File: scripts/python/validation/rulebook.py
size: 7013
sha: 75a97d8cebefbd6da76f398c75001a15b3490d34
upstream: https://github.com/eriemon/verilog-generator/blob/HEAD/scripts/python/validation/rulebook.py

Content is not inlined in the catalog. Read the upstream file: https://github.com/eriemon/verilog-generator/blob/HEAD/scripts/python/validation/rulebook.py

## File: scripts/python/validation/skill_effectiveness.py
size: 129704
sha: 7a6c897c6f139ebcebb13eb82fa40e55cb6d2a16
upstream: https://github.com/eriemon/verilog-generator/blob/HEAD/scripts/python/validation/skill_effectiveness.py

Content is not inlined in the catalog. Read the upstream file: https://github.com/eriemon/verilog-generator/blob/HEAD/scripts/python/validation/skill_effectiveness.py

## File: scripts/python/validation/skill_effectiveness_support.py
size: 55615
sha: 36235ad484a774e9e21d495d323cb6f65e4c2450
upstream: https://github.com/eriemon/verilog-generator/blob/HEAD/scripts/python/validation/skill_effectiveness_support.py

Content is not inlined in the catalog. Read the upstream file: https://github.com/eriemon/verilog-generator/blob/HEAD/scripts/python/validation/skill_effectiveness_support.py

## File: scripts/python/validation/validate_verilog_skill.py
size: 55258
sha: 4ee8dfaacb52ce3f0763ff8806be5da910a04760
upstream: https://github.com/eriemon/verilog-generator/blob/HEAD/scripts/python/validation/validate_verilog_skill.py

Content is not inlined in the catalog. Read the upstream file: https://github.com/eriemon/verilog-generator/blob/HEAD/scripts/python/validation/validate_verilog_skill.py

## File: scripts/python/validation/validation.py
size: 12293
sha: 77559c9358d3dec02bf9fb49be0ddeec06976aec
upstream: https://github.com/eriemon/verilog-generator/blob/HEAD/scripts/python/validation/validation.py

Content is not inlined in the catalog. Read the upstream file: https://github.com/eriemon/verilog-generator/blob/HEAD/scripts/python/validation/validation.py

## File: scripts/python/validation/validation_checks.py
size: 60936
sha: c3ca18e7878441dafd50f223447da4133be825ed
upstream: https://github.com/eriemon/verilog-generator/blob/HEAD/scripts/python/validation/validation_checks.py

Content is not inlined in the catalog. Read the upstream file: https://github.com/eriemon/verilog-generator/blob/HEAD/scripts/python/validation/validation_checks.py

## File: scripts/python/validation/validation_gate_facade.py
size: 30476
sha: 8dee47cfddf9381eb7313258bfc35fb1d22d74de
upstream: https://github.com/eriemon/verilog-generator/blob/HEAD/scripts/python/validation/validation_gate_facade.py

Content is not inlined in the catalog. Read the upstream file: https://github.com/eriemon/verilog-generator/blob/HEAD/scripts/python/validation/validation_gate_facade.py

## File: scripts/python/validation/validation_governance_gate.py
size: 34324
sha: e4a1544e1017a7abae8fd41b1c9a6c4c2aa36f7d
upstream: https://github.com/eriemon/verilog-generator/blob/HEAD/scripts/python/validation/validation_governance_gate.py

Content is not inlined in the catalog. Read the upstream file: https://github.com/eriemon/verilog-generator/blob/HEAD/scripts/python/validation/validation_governance_gate.py

## File: scripts/python/validation/validation_impl.py
size: 12245
sha: b3c3031ebc48522d4366a8b9f8442f484434bccf
upstream: https://github.com/eriemon/verilog-generator/blob/HEAD/scripts/python/validation/validation_impl.py

Content is not inlined in the catalog. Read the upstream file: https://github.com/eriemon/verilog-generator/blob/HEAD/scripts/python/validation/validation_impl.py

## File: scripts/python/validation/validation_models.py
size: 11713
sha: 195e8edbdd625e10d256a88e0a0b510df8b715d8
upstream: https://github.com/eriemon/verilog-generator/blob/HEAD/scripts/python/validation/validation_models.py

Content is not inlined in the catalog. Read the upstream file: https://github.com/eriemon/verilog-generator/blob/HEAD/scripts/python/validation/validation_models.py

## File: scripts/python/validation/validation_readiness.py
size: 51362
sha: e0e74c89d22bc932f2fb27ccf1b925272a29c8b9
upstream: https://github.com/eriemon/verilog-generator/blob/HEAD/scripts/python/validation/validation_readiness.py

Content is not inlined in the catalog. Read the upstream file: https://github.com/eriemon/verilog-generator/blob/HEAD/scripts/python/validation/validation_readiness.py

## File: scripts/python/validation/validation_reports.py
size: 17510
sha: f416e15ca7e694153050265e2a1e33a989eb968c
upstream: https://github.com/eriemon/verilog-generator/blob/HEAD/scripts/python/validation/validation_reports.py

Content is not inlined in the catalog. Read the upstream file: https://github.com/eriemon/verilog-generator/blob/HEAD/scripts/python/validation/validation_reports.py

## File: scripts/python/validation/validation_runtime.py
size: 7851
sha: 3f03262c5e59fd69b6976a9b805c66fee6e774f8
upstream: https://github.com/eriemon/verilog-generator/blob/HEAD/scripts/python/validation/validation_runtime.py

Content is not inlined in the catalog. Read the upstream file: https://github.com/eriemon/verilog-generator/blob/HEAD/scripts/python/validation/validation_runtime.py

## File: scripts/python/validation/validation_smoke_gate.py
size: 40463
sha: b9f376ab665c28da6b09d4fdd8811b562625d1d4
upstream: https://github.com/eriemon/verilog-generator/blob/HEAD/scripts/python/validation/validation_smoke_gate.py

Content is not inlined in the catalog. Read the upstream file: https://github.com/eriemon/verilog-generator/blob/HEAD/scripts/python/validation/validation_smoke_gate.py

## File: scripts/python/validation/validation_source_audit.py
size: 63903
sha: cc2ffe086880a464758c41920c5b040d03325ebd
upstream: https://github.com/eriemon/verilog-generator/blob/HEAD/scripts/python/validation/validation_source_audit.py

Content is not inlined in the catalog. Read the upstream file: https://github.com/eriemon/verilog-generator/blob/HEAD/scripts/python/validation/validation_source_audit.py

## File: scripts/python/validation/validation_workspace_gate.py
size: 22578
sha: 885c15be571f26bda4a53b093cf5cc43f2d16730
upstream: https://github.com/eriemon/verilog-generator/blob/HEAD/scripts/python/validation/validation_workspace_gate.py

Content is not inlined in the catalog. Read the upstream file: https://github.com/eriemon/verilog-generator/blob/HEAD/scripts/python/validation/validation_workspace_gate.py

## File: scripts/python/version.py
size: 328
sha: 795b1263a48dd8a14b58f346aa7b23676291419e
upstream: https://github.com/eriemon/verilog-generator/blob/HEAD/scripts/python/version.py

```text
"""readable-verilog-generator 的源码版本常量。"""

# 公开版本号供 validate、发布门禁和报告逻辑稳定读取。
__all__ = ["__version__"]  # 对外暴露的源码版本常量名清单

# 版本值与 skill 根目录 VERSION 文件保持一致。
__version__ = "2.0.0"  # 当前 skill 源码版本号
```

## File: scripts/python/workflow/artifact_graph.py
size: 19294
sha: af83b177fb787c91da965b648af19c9be310f2d1
upstream: https://github.com/eriemon/verilog-generator/blob/HEAD/scripts/python/workflow/artifact_graph.py

Content is not inlined in the catalog. Read the upstream file: https://github.com/eriemon/verilog-generator/blob/HEAD/scripts/python/workflow/artifact_graph.py

## File: scripts/python/workflow/cli.py
size: 5029
sha: 6d88fa426cd89243975ab222da792bd39183fd17
upstream: https://github.com/eriemon/verilog-generator/blob/HEAD/scripts/python/workflow/cli.py

Content is not inlined in the catalog. Read the upstream file: https://github.com/eriemon/verilog-generator/blob/HEAD/scripts/python/workflow/cli.py

## File: scripts/python/workflow/cli_audit_commands.py
size: 8883
sha: e057c5af6269f8ed0a28a6dcc4706db743142280
upstream: https://github.com/eriemon/verilog-generator/blob/HEAD/scripts/python/workflow/cli_audit_commands.py

Content is not inlined in the catalog. Read the upstream file: https://github.com/eriemon/verilog-generator/blob/HEAD/scripts/python/workflow/cli_audit_commands.py

## File: scripts/python/workflow/cli_existing_commands.py
size: 23796
sha: 214e4116a82a6547ab76afebe5ef23931fbd1918
upstream: https://github.com/eriemon/verilog-generator/blob/HEAD/scripts/python/workflow/cli_existing_commands.py

Content is not inlined in the catalog. Read the upstream file: https://github.com/eriemon/verilog-generator/blob/HEAD/scripts/python/workflow/cli_existing_commands.py

## File: scripts/python/workflow/cli_feedback_commands.py
size: 19226
sha: d70f329bd4f0ffbee33ad32d51c3a4e2e8f3c4b4
upstream: https://github.com/eriemon/verilog-generator/blob/HEAD/scripts/python/workflow/cli_feedback_commands.py

Content is not inlined in the catalog. Read the upstream file: https://github.com/eriemon/verilog-generator/blob/HEAD/scripts/python/workflow/cli_feedback_commands.py

## File: scripts/python/workflow/cli_generation_commands.py
size: 21616
sha: 1db92467506a8b77db0ff71f082aaf3f5d1e55b7
upstream: https://github.com/eriemon/verilog-generator/blob/HEAD/scripts/python/workflow/cli_generation_commands.py

Content is not inlined in the catalog. Read the upstream file: https://github.com/eriemon/verilog-generator/blob/HEAD/scripts/python/workflow/cli_generation_commands.py

## File: scripts/python/workflow/cli_parser.py
size: 30554
sha: bd38739388bcd46dd960498283fac5205fc80e24
upstream: https://github.com/eriemon/verilog-generator/blob/HEAD/scripts/python/workflow/cli_parser.py

Content is not inlined in the catalog. Read the upstream file: https://github.com/eriemon/verilog-generator/blob/HEAD/scripts/python/workflow/cli_parser.py

## File: scripts/python/workflow/cli_support.py
size: 12881
sha: 949c08a4953946f469320943a080df16e31ced46
upstream: https://github.com/eriemon/verilog-generator/blob/HEAD/scripts/python/workflow/cli_support.py

Content is not inlined in the catalog. Read the upstream file: https://github.com/eriemon/verilog-generator/blob/HEAD/scripts/python/workflow/cli_support.py

## File: scripts/python/workflow/cli_workflow_commands.py
size: 18009
sha: 3f0d4523520d9cd8ca1d367b2891e09ff3ff6e6c
upstream: https://github.com/eriemon/verilog-generator/blob/HEAD/scripts/python/workflow/cli_workflow_commands.py

Content is not inlined in the catalog. Read the upstream file: https://github.com/eriemon/verilog-generator/blob/HEAD/scripts/python/workflow/cli_workflow_commands.py

## File: scripts/python/workflow/config.py
size: 65045
sha: a3be0cb53c2413cbca37dbf9e575117eb3ebfb85
upstream: https://github.com/eriemon/verilog-generator/blob/HEAD/scripts/python/workflow/config.py

Content is not inlined in the catalog. Read the upstream file: https://github.com/eriemon/verilog-generator/blob/HEAD/scripts/python/workflow/config.py

## File: scripts/python/workflow/extractor.py
size: 33241
sha: 8ea0b8248f205c0bf0eb9024bd4c4b178bba3a56
upstream: https://github.com/eriemon/verilog-generator/blob/HEAD/scripts/python/workflow/extractor.py

Content is not inlined in the catalog. Read the upstream file: https://github.com/eriemon/verilog-generator/blob/HEAD/scripts/python/workflow/extractor.py

## File: scripts/python/workflow/interface_contract.py
size: 25192
sha: 14542ee98f31a9be3f77fd0f7694dca29bc62c4c
upstream: https://github.com/eriemon/verilog-generator/blob/HEAD/scripts/python/workflow/interface_contract.py

Content is not inlined in the catalog. Read the upstream file: https://github.com/eriemon/verilog-generator/blob/HEAD/scripts/python/workflow/interface_contract.py

## File: scripts/python/workflow/interface_templates.py
size: 11092
sha: ae8c2cfab7881c045af93426494f11dce22c05df
upstream: https://github.com/eriemon/verilog-generator/blob/HEAD/scripts/python/workflow/interface_templates.py

Content is not inlined in the catalog. Read the upstream file: https://github.com/eriemon/verilog-generator/blob/HEAD/scripts/python/workflow/interface_templates.py

## File: scripts/python/workflow/model_provider.py
size: 8261
sha: d64d8717abc89958e0eaf86a1397e6e673011b5a
upstream: https://github.com/eriemon/verilog-generator/blob/HEAD/scripts/python/workflow/model_provider.py

Content is not inlined in the catalog. Read the upstream file: https://github.com/eriemon/verilog-generator/blob/HEAD/scripts/python/workflow/model_provider.py

## File: scripts/python/workflow/model_provider_command.py
size: 10395
sha: 2ef0f7c08d09b9e2b89f8085f68bd7d88797dde7
upstream: https://github.com/eriemon/verilog-generator/blob/HEAD/scripts/python/workflow/model_provider_command.py

Content is not inlined in the catalog. Read the upstream file: https://github.com/eriemon/verilog-generator/blob/HEAD/scripts/python/workflow/model_provider_command.py

## File: scripts/python/workflow/model_provider_mock.py
size: 6612
sha: 55a357b078bdfe552a8f4d771a15559a55d77981
upstream: https://github.com/eriemon/verilog-generator/blob/HEAD/scripts/python/workflow/model_provider_mock.py

Content is not inlined in the catalog. Read the upstream file: https://github.com/eriemon/verilog-generator/blob/HEAD/scripts/python/workflow/model_provider_mock.py

## File: scripts/python/workflow/model_provider_mock_comments.py
size: 23197
sha: 5387f9e5dacb40ea62e5ae0baca457e6bbe7a5db
upstream: https://github.com/eriemon/verilog-generator/blob/HEAD/scripts/python/workflow/model_provider_mock_comments.py

Content is not inlined in the catalog. Read the upstream file: https://github.com/eriemon/verilog-generator/blob/HEAD/scripts/python/workflow/model_provider_mock_comments.py

## File: scripts/python/workflow/model_provider_mock_content.py
size: 18434
sha: e415b24e09bc430de0599a1c6d53b64b151daaef
upstream: https://github.com/eriemon/verilog-generator/blob/HEAD/scripts/python/workflow/model_provider_mock_content.py

Content is not inlined in the catalog. Read the upstream file: https://github.com/eriemon/verilog-generator/blob/HEAD/scripts/python/workflow/model_provider_mock_content.py

## File: scripts/python/workflow/model_provider_mock_rtl.py
size: 77445
sha: e8351838bca55fd91119f39ce060ae41a4429f14
upstream: https://github.com/eriemon/verilog-generator/blob/HEAD/scripts/python/workflow/model_provider_mock_rtl.py

Content is not inlined in the catalog. Read the upstream file: https://github.com/eriemon/verilog-generator/blob/HEAD/scripts/python/workflow/model_provider_mock_rtl.py

## File: scripts/python/workflow/model_provider_mock_testbench.py
size: 36965
sha: cb35841b818f6752409c3b8003d4963e57757879
upstream: https://github.com/eriemon/verilog-generator/blob/HEAD/scripts/python/workflow/model_provider_mock_testbench.py

Content is not inlined in the catalog. Read the upstream file: https://github.com/eriemon/verilog-generator/blob/HEAD/scripts/python/workflow/model_provider_mock_testbench.py

## File: scripts/python/workflow/pattern_templates.py
size: 17350
sha: d440e87b531363cfcefa0154dd2254ddb7740623
upstream: https://github.com/eriemon/verilog-generator/blob/HEAD/scripts/python/workflow/pattern_templates.py

Content is not inlined in the catalog. Read the upstream file: https://github.com/eriemon/verilog-generator/blob/HEAD/scripts/python/workflow/pattern_templates.py

## File: scripts/python/workflow/planning.py
size: 23030
sha: dc006521cb71c7aa50a64894c8d91957ccea421e
upstream: https://github.com/eriemon/verilog-generator/blob/HEAD/scripts/python/workflow/planning.py

Content is not inlined in the catalog. Read the upstream file: https://github.com/eriemon/verilog-generator/blob/HEAD/scripts/python/workflow/planning.py

## File: scripts/python/workflow/primitive_catalog.py
size: 18497
sha: d479246b8a55681ef44ce43cb2a373b920e81ff5
upstream: https://github.com/eriemon/verilog-generator/blob/HEAD/scripts/python/workflow/primitive_catalog.py

Content is not inlined in the catalog. Read the upstream file: https://github.com/eriemon/verilog-generator/blob/HEAD/scripts/python/workflow/primitive_catalog.py

## File: scripts/python/workflow/prompt.py
size: 85570
sha: 7ce6b7f8af0a3c117a225a4413c51352a172c6b9
upstream: https://github.com/eriemon/verilog-generator/blob/HEAD/scripts/python/workflow/prompt.py

Content is not inlined in the catalog. Read the upstream file: https://github.com/eriemon/verilog-generator/blob/HEAD/scripts/python/workflow/prompt.py

## File: scripts/python/workflow/requirements.py
size: 1295
sha: 5e7ce7891503a4cfd02b02472bdb4cbb8f23f00e
upstream: https://github.com/eriemon/verilog-generator/blob/HEAD/scripts/python/workflow/requirements.py

Content is not inlined in the catalog. Read the upstream file: https://github.com/eriemon/verilog-generator/blob/HEAD/scripts/python/workflow/requirements.py

## File: scripts/python/workflow/requirements_extract.py
size: 17758
sha: 4e076a3923df1c15d8e7653ab2a0ea2c82974d3a
upstream: https://github.com/eriemon/verilog-generator/blob/HEAD/scripts/python/workflow/requirements_extract.py

Content is not inlined in the catalog. Read the upstream file: https://github.com/eriemon/verilog-generator/blob/HEAD/scripts/python/workflow/requirements_extract.py

## File: scripts/python/workflow/requirements_normalize.py
size: 55624
sha: 89b3cd014994674dd32d55fa05c56a114cc942ad
upstream: https://github.com/eriemon/verilog-generator/blob/HEAD/scripts/python/workflow/requirements_normalize.py

Content is not inlined in the catalog. Read the upstream file: https://github.com/eriemon/verilog-generator/blob/HEAD/scripts/python/workflow/requirements_normalize.py

## File: scripts/python/workflow/requirements_render.py
size: 49097
sha: bcee53f94a4a388bf29b01715763b4f324553be2
upstream: https://github.com/eriemon/verilog-generator/blob/HEAD/scripts/python/workflow/requirements_render.py

Content is not inlined in the catalog. Read the upstream file: https://github.com/eriemon/verilog-generator/blob/HEAD/scripts/python/workflow/requirements_render.py

## File: scripts/python/workflow/spec.py
size: 49085
sha: c94a145b4958a56b78417a66a6cb2f99e6bd541b
upstream: https://github.com/eriemon/verilog-generator/blob/HEAD/scripts/python/workflow/spec.py

Content is not inlined in the catalog. Read the upstream file: https://github.com/eriemon/verilog-generator/blob/HEAD/scripts/python/workflow/spec.py

## File: scripts/python/workflow/spec_document.py
size: 67620
sha: 96e26c48fc50847e2e50fb5d35b1fa03b92361ec
upstream: https://github.com/eriemon/verilog-generator/blob/HEAD/scripts/python/workflow/spec_document.py

Content is not inlined in the catalog. Read the upstream file: https://github.com/eriemon/verilog-generator/blob/HEAD/scripts/python/workflow/spec_document.py

## File: scripts/python/workflow/spec_document_io.py
size: 5760
sha: 8fe68f79fb0bf0778a9b3a201a97f622d1e535cb
upstream: https://github.com/eriemon/verilog-generator/blob/HEAD/scripts/python/workflow/spec_document_io.py

Content is not inlined in the catalog. Read the upstream file: https://github.com/eriemon/verilog-generator/blob/HEAD/scripts/python/workflow/spec_document_io.py

## File: scripts/python/workflow/trace.py
size: 8511
sha: c2ddedd10ee689c528655c6f8002ef1c77f3720f
upstream: https://github.com/eriemon/verilog-generator/blob/HEAD/scripts/python/workflow/trace.py

Content is not inlined in the catalog. Read the upstream file: https://github.com/eriemon/verilog-generator/blob/HEAD/scripts/python/workflow/trace.py

## File: scripts/python/workflow/use_case_templates.py
size: 20652
sha: 69bbcb0a18fcb5a6c51c339f469fd2b6b242f6d3
upstream: https://github.com/eriemon/verilog-generator/blob/HEAD/scripts/python/workflow/use_case_templates.py

Content is not inlined in the catalog. Read the upstream file: https://github.com/eriemon/verilog-generator/blob/HEAD/scripts/python/workflow/use_case_templates.py

## File: scripts/python/workflow/vectors.py
size: 14690
sha: 38634c134e92608c150ab1f306916ac3478dc7b6
upstream: https://github.com/eriemon/verilog-generator/blob/HEAD/scripts/python/workflow/vectors.py

Content is not inlined in the catalog. Read the upstream file: https://github.com/eriemon/verilog-generator/blob/HEAD/scripts/python/workflow/vectors.py

## File: scripts/python/workflow/verilog_gate_catalog.py
size: 15508
sha: e7f6d04661edce54a301d822e5acbbc6d730a455
upstream: https://github.com/eriemon/verilog-generator/blob/HEAD/scripts/python/workflow/verilog_gate_catalog.py

Content is not inlined in the catalog. Read the upstream file: https://github.com/eriemon/verilog-generator/blob/HEAD/scripts/python/workflow/verilog_gate_catalog.py

## File: scripts/python/workflow/waveform_alignment.py
size: 13330
sha: 4b1f98867ea10f8157c1ab7b903a4a4b6f46326f
upstream: https://github.com/eriemon/verilog-generator/blob/HEAD/scripts/python/workflow/waveform_alignment.py

Content is not inlined in the catalog. Read the upstream file: https://github.com/eriemon/verilog-generator/blob/HEAD/scripts/python/workflow/waveform_alignment.py

## File: scripts/python/workflow/waveform_alignment_support.py
size: 9440
sha: 66f78d54a906f6b288f9eea92262d8c93488f701
upstream: https://github.com/eriemon/verilog-generator/blob/HEAD/scripts/python/workflow/waveform_alignment_support.py

Content is not inlined in the catalog. Read the upstream file: https://github.com/eriemon/verilog-generator/blob/HEAD/scripts/python/workflow/waveform_alignment_support.py

## File: scripts/python/workflow/workflow.py
size: 20921
sha: d666cb386907db6fa45947615d6c0b30f1d16205
upstream: https://github.com/eriemon/verilog-generator/blob/HEAD/scripts/python/workflow/workflow.py

Content is not inlined in the catalog. Read the upstream file: https://github.com/eriemon/verilog-generator/blob/HEAD/scripts/python/workflow/workflow.py

## File: scripts/python/workflow/workflow_execution.py
size: 73777
sha: 1af0c4d1265667662ec8e3da846c2ffb76a4ce14
upstream: https://github.com/eriemon/verilog-generator/blob/HEAD/scripts/python/workflow/workflow_execution.py

Content is not inlined in the catalog. Read the upstream file: https://github.com/eriemon/verilog-generator/blob/HEAD/scripts/python/workflow/workflow_execution.py

## File: scripts/python/workflow/workflow_gates.py
size: 31946
sha: d6c7b8ed9e2a34021f5a92525a540dbe42f00c52
upstream: https://github.com/eriemon/verilog-generator/blob/HEAD/scripts/python/workflow/workflow_gates.py

Content is not inlined in the catalog. Read the upstream file: https://github.com/eriemon/verilog-generator/blob/HEAD/scripts/python/workflow/workflow_gates.py

## File: scripts/python/workflow/workflow_router.py
size: 48709
sha: 6d192da4951d1eacd5195b2667892a386bd1326f
upstream: https://github.com/eriemon/verilog-generator/blob/HEAD/scripts/python/workflow/workflow_router.py

Content is not inlined in the catalog. Read the upstream file: https://github.com/eriemon/verilog-generator/blob/HEAD/scripts/python/workflow/workflow_router.py

## File: scripts/python/workflow/workflow_stage.py
size: 43236
sha: 88008f3f4abc42461975120f25b07b7ace1f0a79
upstream: https://github.com/eriemon/verilog-generator/blob/HEAD/scripts/python/workflow/workflow_stage.py

Content is not inlined in the catalog. Read the upstream file: https://github.com/eriemon/verilog-generator/blob/HEAD/scripts/python/workflow/workflow_stage.py

## File: scripts/python/workflow/workflow_support.py
size: 44214
sha: 5681a20181b6bd45b7cc89c22dc61ffe2a1c6e90
upstream: https://github.com/eriemon/verilog-generator/blob/HEAD/scripts/python/workflow/workflow_support.py

Content is not inlined in the catalog. Read the upstream file: https://github.com/eriemon/verilog-generator/blob/HEAD/scripts/python/workflow/workflow_support.py

## File: scripts/python/workflow/workspace.py
size: 28994
sha: 663f1a8b7650a23badb0318e2f31f95d62ad0357
upstream: https://github.com/eriemon/verilog-generator/blob/HEAD/scripts/python/workflow/workspace.py

Content is not inlined in the catalog. Read the upstream file: https://github.com/eriemon/verilog-generator/blob/HEAD/scripts/python/workflow/workspace.py

## File: references/checklists/capability-distillation-checklist.md
size: 3046
sha: c5889c3f7f14ae47012e5197d0d5815a924d9e2d
upstream: https://github.com/eriemon/verilog-generator/blob/HEAD/references/checklists/capability-distillation-checklist.md

Content is not inlined in the catalog. Read the upstream file: https://github.com/eriemon/verilog-generator/blob/HEAD/references/checklists/capability-distillation-checklist.md

## File: references/checklists/lint-checklist.md
size: 3686
sha: ae8a86ddf706e0d1baa6229f10dbb3e7a3858002
upstream: https://github.com/eriemon/verilog-generator/blob/HEAD/references/checklists/lint-checklist.md

Content is not inlined in the catalog. Read the upstream file: https://github.com/eriemon/verilog-generator/blob/HEAD/references/checklists/lint-checklist.md

## File: references/checklists/verilog-readability-gate.md
size: 3619
sha: abebea85955a397c03e6b17b277ff1df6ae7a5d7
upstream: https://github.com/eriemon/verilog-generator/blob/HEAD/references/checklists/verilog-readability-gate.md

Content is not inlined in the catalog. Read the upstream file: https://github.com/eriemon/verilog-generator/blob/HEAD/references/checklists/verilog-readability-gate.md

## File: references/corpus/verilog-style-observations.md
size: 4714
sha: e0b90bf917c80ec6bf19db1fc6369833944227fc
upstream: https://github.com/eriemon/verilog-generator/blob/HEAD/references/corpus/verilog-style-observations.md

Content is not inlined in the catalog. Read the upstream file: https://github.com/eriemon/verilog-generator/blob/HEAD/references/corpus/verilog-style-observations.md

## File: references/integration/configuration.md
size: 20376
sha: 3f5f991918de02c8f7119d8c5ad71e099620e59f
upstream: https://github.com/eriemon/verilog-generator/blob/HEAD/references/integration/configuration.md

Content is not inlined in the catalog. Read the upstream file: https://github.com/eriemon/verilog-generator/blob/HEAD/references/integration/configuration.md

## File: references/integration/host-integration.md
size: 10835
sha: 57ea0d2b0167b57d6094908686a7cec9623e35a8
upstream: https://github.com/eriemon/verilog-generator/blob/HEAD/references/integration/host-integration.md

Content is not inlined in the catalog. Read the upstream file: https://github.com/eriemon/verilog-generator/blob/HEAD/references/integration/host-integration.md

## File: references/rules/asic-verilog-quality.md
size: 3961
sha: 2c1f0417bba323cc5e4def0719e002f577697ceb
upstream: https://github.com/eriemon/verilog-generator/blob/HEAD/references/rules/asic-verilog-quality.md

Content is not inlined in the catalog. Read the upstream file: https://github.com/eriemon/verilog-generator/blob/HEAD/references/rules/asic-verilog-quality.md

## File: references/rules/erie-style.md
size: 6406
sha: 2001599c4b0ec2e7f8b24765f1d5375bad6bbde0
upstream: https://github.com/eriemon/verilog-generator/blob/HEAD/references/rules/erie-style.md

Content is not inlined in the catalog. Read the upstream file: https://github.com/eriemon/verilog-generator/blob/HEAD/references/rules/erie-style.md

## File: references/rules/testbench-patterns.md
size: 3237
sha: 5f487cc0ddc07a55387e89722c993d81a0148957
upstream: https://github.com/eriemon/verilog-generator/blob/HEAD/references/rules/testbench-patterns.md

Content is not inlined in the catalog. Read the upstream file: https://github.com/eriemon/verilog-generator/blob/HEAD/references/rules/testbench-patterns.md

## File: references/rules/verilog-code-comment-naming-standard.md
size: 56905
sha: 8ae941aec764aeab0b5e2374a491eefc291cda59
upstream: https://github.com/eriemon/verilog-generator/blob/HEAD/references/rules/verilog-code-comment-naming-standard.md

Content is not inlined in the catalog. Read the upstream file: https://github.com/eriemon/verilog-generator/blob/HEAD/references/rules/verilog-code-comment-naming-standard.md

## File: references/rules/verilog-comment-placement.md
size: 8617
sha: 3fa05687d1b835ca01f05f8f3d654c65e787f062
upstream: https://github.com/eriemon/verilog-generator/blob/HEAD/references/rules/verilog-comment-placement.md

Content is not inlined in the catalog. Read the upstream file: https://github.com/eriemon/verilog-generator/blob/HEAD/references/rules/verilog-comment-placement.md

## File: references/rules/verilog-pattern-templates.md
size: 1104
sha: 250b2b1fde5f00ebcce4fb0615284b2fb7f04103
upstream: https://github.com/eriemon/verilog-generator/blob/HEAD/references/rules/verilog-pattern-templates.md

Content is not inlined in the catalog. Read the upstream file: https://github.com/eriemon/verilog-generator/blob/HEAD/references/rules/verilog-pattern-templates.md

## File: references/rules/verilog-quality-gates.md
size: 21932
sha: 40ffcfe6a176ceaa7cbdea53c5d46f30f6d2e3ec
upstream: https://github.com/eriemon/verilog-generator/blob/HEAD/references/rules/verilog-quality-gates.md

Content is not inlined in the catalog. Read the upstream file: https://github.com/eriemon/verilog-generator/blob/HEAD/references/rules/verilog-quality-gates.md

## File: references/rules/xilinx-primitive-exemptions.md
size: 10811
sha: a63f8bd77b59a32b437174deea935a0e582c476d
upstream: https://github.com/eriemon/verilog-generator/blob/HEAD/references/rules/xilinx-primitive-exemptions.md

Content is not inlined in the catalog. Read the upstream file: https://github.com/eriemon/verilog-generator/blob/HEAD/references/rules/xilinx-primitive-exemptions.md

## File: references/skill/installation.md
size: 6205
sha: 0da2df53c1ed1302bcb183000a228b69e00708be
upstream: https://github.com/eriemon/verilog-generator/blob/HEAD/references/skill/installation.md

Content is not inlined in the catalog. Read the upstream file: https://github.com/eriemon/verilog-generator/blob/HEAD/references/skill/installation.md

## File: references/skill/script-guide.md
size: 7659
sha: 18760c74d6fd89a975a7a0814de079c5c58ac7bc
upstream: https://github.com/eriemon/verilog-generator/blob/HEAD/references/skill/script-guide.md

Content is not inlined in the catalog. Read the upstream file: https://github.com/eriemon/verilog-generator/blob/HEAD/references/skill/script-guide.md

## File: references/skill/skill-standards.md
size: 2177
sha: 44858ee44d881457169c86ce6bc980aa14dcbe9b
upstream: https://github.com/eriemon/verilog-generator/blob/HEAD/references/skill/skill-standards.md

Content is not inlined in the catalog. Read the upstream file: https://github.com/eriemon/verilog-generator/blob/HEAD/references/skill/skill-standards.md

## File: references/workflows/verilog_dispatcher.md
size: 6600
sha: ce2927b672c0a4781578b5f2e1e5f8f23f69e2bd
upstream: https://github.com/eriemon/verilog-generator/blob/HEAD/references/workflows/verilog_dispatcher.md

Content is not inlined in the catalog. Read the upstream file: https://github.com/eriemon/verilog-generator/blob/HEAD/references/workflows/verilog_dispatcher.md

## File: references/workflows/workflow-contracts.md
size: 15502
sha: 69fbcaa0d0fa985326ab15ff314f91813e06b309
upstream: https://github.com/eriemon/verilog-generator/blob/HEAD/references/workflows/workflow-contracts.md

Content is not inlined in the catalog. Read the upstream file: https://github.com/eriemon/verilog-generator/blob/HEAD/references/workflows/workflow-contracts.md

## File: assets/examples/existing_rtl/fsm_without_default.v
size: 761
sha: 1ea9fbfd6e82a58591747a55efe71396470b7aa5
upstream: https://github.com/eriemon/verilog-generator/blob/HEAD/assets/examples/existing_rtl/fsm_without_default.v

Content is not inlined in the catalog. Read the upstream file: https://github.com/eriemon/verilog-generator/blob/HEAD/assets/examples/existing_rtl/fsm_without_default.v

## File: assets/examples/existing_rtl/fsm_without_default_spec.md
size: 311
sha: 2d164820bab2260a98e25a61e020b640b56db084
upstream: https://github.com/eriemon/verilog-generator/blob/HEAD/assets/examples/existing_rtl/fsm_without_default_spec.md

```text
# Existing RTL Verification Notes

- Module `fsm_without_default` should return to `IDLE` after a single `WORK` cycle.
- The state transition logic should keep deterministic behavior for any unlisted `state` encoding.
- Preserve the public interface and clock/reset behavior while repairing control logic.
```

## File: assets/examples/existing_rtl/leaf_counter.v
size: 314
sha: bf232f280d61c034481be51acf54880b5e32bf95
upstream: https://github.com/eriemon/verilog-generator/blob/HEAD/assets/examples/existing_rtl/leaf_counter.v

Content is not inlined in the catalog. Read the upstream file: https://github.com/eriemon/verilog-generator/blob/HEAD/assets/examples/existing_rtl/leaf_counter.v

## File: assets/examples/existing_rtl/missing_output_register.v
size: 423
sha: d7aebd1fbde8cc06e36d6ea0b3787a83366bf701
upstream: https://github.com/eriemon/verilog-generator/blob/HEAD/assets/examples/existing_rtl/missing_output_register.v

Content is not inlined in the catalog. Read the upstream file: https://github.com/eriemon/verilog-generator/blob/HEAD/assets/examples/existing_rtl/missing_output_register.v

## File: assets/examples/existing_rtl/missing_output_register_spec.md
size: 331
sha: fa444aac5a33c3bd90bce217c5622a5b4037b11d
upstream: https://github.com/eriemon/verilog-generator/blob/HEAD/assets/examples/existing_rtl/missing_output_register_spec.md

Content is not inlined in the catalog. Read the upstream file: https://github.com/eriemon/verilog-generator/blob/HEAD/assets/examples/existing_rtl/missing_output_register_spec.md

## File: assets/examples/existing_rtl/ready_valid_slice.v
size: 967
sha: 527382c38e0511fa2e487077a6ea2aee7756ac50
upstream: https://github.com/eriemon/verilog-generator/blob/HEAD/assets/examples/existing_rtl/ready_valid_slice.v

Content is not inlined in the catalog. Read the upstream file: https://github.com/eriemon/verilog-generator/blob/HEAD/assets/examples/existing_rtl/ready_valid_slice.v

## File: assets/examples/existing_rtl/ready_valid_slice_spec.md
size: 420
sha: a7a6e319c29306b437efd7e2b6400156c1ff1d90
upstream: https://github.com/eriemon/verilog-generator/blob/HEAD/assets/examples/existing_rtl/ready_valid_slice_spec.md

Content is not inlined in the catalog. Read the upstream file: https://github.com/eriemon/verilog-generator/blob/HEAD/assets/examples/existing_rtl/ready_valid_slice_spec.md

## File: assets/examples/existing_rtl/reset_gap_counter.v
size: 319
sha: 29cc7483655958a806d911707bcbf302e24c0a1a
upstream: https://github.com/eriemon/verilog-generator/blob/HEAD/assets/examples/existing_rtl/reset_gap_counter.v

Content is not inlined in the catalog. Read the upstream file: https://github.com/eriemon/verilog-generator/blob/HEAD/assets/examples/existing_rtl/reset_gap_counter.v

## File: assets/examples/existing_rtl/reset_gap_counter_spec.md
size: 212
sha: bad3c4c4ee2470d0167bb4b3db4b1fff58ac5824
upstream: https://github.com/eriemon/verilog-generator/blob/HEAD/assets/examples/existing_rtl/reset_gap_counter_spec.md

Content is not inlined in the catalog. Read the upstream file: https://github.com/eriemon/verilog-generator/blob/HEAD/assets/examples/existing_rtl/reset_gap_counter_spec.md

## File: assets/examples/existing_rtl/tb_ready_valid_slice.v
size: 846
sha: 0097c89445be17464648c4c8a1c564821591afdd
upstream: https://github.com/eriemon/verilog-generator/blob/HEAD/assets/examples/existing_rtl/tb_ready_valid_slice.v

Content is not inlined in the catalog. Read the upstream file: https://github.com/eriemon/verilog-generator/blob/HEAD/assets/examples/existing_rtl/tb_ready_valid_slice.v

## File: assets/examples/existing_rtl/top_counter.v
size: 271
sha: 7ada954ac28fe5f863f92bf2306441d773efd2b8
upstream: https://github.com/eriemon/verilog-generator/blob/HEAD/assets/examples/existing_rtl/top_counter.v

Content is not inlined in the catalog. Read the upstream file: https://github.com/eriemon/verilog-generator/blob/HEAD/assets/examples/existing_rtl/top_counter.v

## File: assets/examples/existing_rtl/traffic_light.v
size: 2557
sha: a2569ac005bbafafed4d2017b71f29d8c563a3b7
upstream: https://github.com/eriemon/verilog-generator/blob/HEAD/assets/examples/existing_rtl/traffic_light.v

Content is not inlined in the catalog. Read the upstream file: https://github.com/eriemon/verilog-generator/blob/HEAD/assets/examples/existing_rtl/traffic_light.v

## File: assets/examples/existing_rtl/traffic_light_spec.md
size: 585
sha: 26c64301837e9a9160b9e271fbfa010dffa79785
upstream: https://github.com/eriemon/verilog-generator/blob/HEAD/assets/examples/existing_rtl/traffic_light_spec.md

Content is not inlined in the catalog. Read the upstream file: https://github.com/eriemon/verilog-generator/blob/HEAD/assets/examples/existing_rtl/traffic_light_spec.md

## File: assets/examples/readme/axis_packet_meter.v
size: 10404
sha: f4443ce6ad928fe2efed4e2a9f2b99c3d5799438
upstream: https://github.com/eriemon/verilog-generator/blob/HEAD/assets/examples/readme/axis_packet_meter.v

Content is not inlined in the catalog. Read the upstream file: https://github.com/eriemon/verilog-generator/blob/HEAD/assets/examples/readme/axis_packet_meter.v

## File: assets/examples/remote_fixtures/comb_hierarchy_budget/generated/rtl/comb_hierarchy_budget.v
size: 1905
sha: ac8431098bd93cfbcc6826f26b07e0e9471820f6
upstream: https://github.com/eriemon/verilog-generator/blob/HEAD/assets/examples/remote_fixtures/comb_hierarchy_budget/generated/rtl/comb_hierarchy_budget.v

Content is not inlined in the catalog. Read the upstream file: https://github.com/eriemon/verilog-generator/blob/HEAD/assets/examples/remote_fixtures/comb_hierarchy_budget/generated/rtl/comb_hierarchy_budget.v

## File: assets/examples/remote_fixtures/comb_hierarchy_budget/generated/tb/tb_comb_hierarchy_budget.v
size: 2570
sha: e23959b1071c7c643b2a508f88bffbe53e3df6c9
upstream: https://github.com/eriemon/verilog-generator/blob/HEAD/assets/examples/remote_fixtures/comb_hierarchy_budget/generated/tb/tb_comb_hierarchy_budget.v

Content is not inlined in the catalog. Read the upstream file: https://github.com/eriemon/verilog-generator/blob/HEAD/assets/examples/remote_fixtures/comb_hierarchy_budget/generated/tb/tb_comb_hierarchy_budget.v

## File: assets/examples/remote_fixtures/comb_hierarchy_budget/hierarchy_child_loop.v
size: 447
sha: 84284a58bfc6d3607d636951aac4fe8bc90ddffc
upstream: https://github.com/eriemon/verilog-generator/blob/HEAD/assets/examples/remote_fixtures/comb_hierarchy_budget/hierarchy_child_loop.v

Content is not inlined in the catalog. Read the upstream file: https://github.com/eriemon/verilog-generator/blob/HEAD/assets/examples/remote_fixtures/comb_hierarchy_budget/hierarchy_child_loop.v

## File: assets/examples/remote_fixtures/comb_hierarchy_budget/hierarchy_over_budget.v
size: 527
sha: 5800337569d90bd488ecfe7129ff089355bb28b0
upstream: https://github.com/eriemon/verilog-generator/blob/HEAD/assets/examples/remote_fixtures/comb_hierarchy_budget/hierarchy_over_budget.v

Content is not inlined in the catalog. Read the upstream file: https://github.com/eriemon/verilog-generator/blob/HEAD/assets/examples/remote_fixtures/comb_hierarchy_budget/hierarchy_over_budget.v

## File: assets/examples/remote_fixtures/comb_hierarchy_budget/hierarchy_q_cut.v
size: 467
sha: 5611e7444241c054948ac374933297d818c15728
upstream: https://github.com/eriemon/verilog-generator/blob/HEAD/assets/examples/remote_fixtures/comb_hierarchy_budget/hierarchy_q_cut.v

Content is not inlined in the catalog. Read the upstream file: https://github.com/eriemon/verilog-generator/blob/HEAD/assets/examples/remote_fixtures/comb_hierarchy_budget/hierarchy_q_cut.v

## File: assets/examples/remote_fixtures/comb_hierarchy_budget/hierarchy_within_budget.v
size: 450
sha: ea5649ff72fc072d93c4c59c5dadadb40fcc0c21
upstream: https://github.com/eriemon/verilog-generator/blob/HEAD/assets/examples/remote_fixtures/comb_hierarchy_budget/hierarchy_within_budget.v

Content is not inlined in the catalog. Read the upstream file: https://github.com/eriemon/verilog-generator/blob/HEAD/assets/examples/remote_fixtures/comb_hierarchy_budget/hierarchy_within_budget.v

## File: assets/examples/remote_fixtures/comb_hierarchy_budget/spec.json
size: 1784
sha: 15181af27d5b3d9b13de24818866242af8e12f93
upstream: https://github.com/eriemon/verilog-generator/blob/HEAD/assets/examples/remote_fixtures/comb_hierarchy_budget/spec.json

Content is not inlined in the catalog. Read the upstream file: https://github.com/eriemon/verilog-generator/blob/HEAD/assets/examples/remote_fixtures/comb_hierarchy_budget/spec.json

## File: assets/examples/remote_fixtures/comb_operation_budget/comb_operation_budget_bad.v
size: 187
sha: b334590d4feda31005e65a7556bd88874364a962
upstream: https://github.com/eriemon/verilog-generator/blob/HEAD/assets/examples/remote_fixtures/comb_operation_budget/comb_operation_budget_bad.v

Content is not inlined in the catalog. Read the upstream file: https://github.com/eriemon/verilog-generator/blob/HEAD/assets/examples/remote_fixtures/comb_operation_budget/comb_operation_budget_bad.v

## File: assets/examples/remote_fixtures/comb_operation_budget/generated/rtl/comb_operation_budget.v
size: 6212
sha: 316125743725c85a0dd04d93faba14244852627c
upstream: https://github.com/eriemon/verilog-generator/blob/HEAD/assets/examples/remote_fixtures/comb_operation_budget/generated/rtl/comb_operation_budget.v

Content is not inlined in the catalog. Read the upstream file: https://github.com/eriemon/verilog-generator/blob/HEAD/assets/examples/remote_fixtures/comb_operation_budget/generated/rtl/comb_operation_budget.v

## File: assets/examples/remote_fixtures/comb_operation_budget/generated/tb/tb_comb_operation_budget.v
size: 5883
sha: a99990f8538b0611557b6038b79bd5875d86def4
upstream: https://github.com/eriemon/verilog-generator/blob/HEAD/assets/examples/remote_fixtures/comb_operation_budget/generated/tb/tb_comb_operation_budget.v

Content is not inlined in the catalog. Read the upstream file: https://github.com/eriemon/verilog-generator/blob/HEAD/assets/examples/remote_fixtures/comb_operation_budget/generated/tb/tb_comb_operation_budget.v

## File: assets/examples/remote_fixtures/comb_operation_budget/spec.json
size: 2977
sha: 09daf148fef2c75ba5b62d6d91a9d3ce2600ab60
upstream: https://github.com/eriemon/verilog-generator/blob/HEAD/assets/examples/remote_fixtures/comb_operation_budget/spec.json

Content is not inlined in the catalog. Read the upstream file: https://github.com/eriemon/verilog-generator/blob/HEAD/assets/examples/remote_fixtures/comb_operation_budget/spec.json

## File: assets/examples/remote_fixtures/comb_parity_mux/generated/rtl/comb_parity_mux.v
size: 2159
sha: 0f066aabe0ab2ccc7c9d31a8096633d844878413
upstream: https://github.com/eriemon/verilog-generator/blob/HEAD/assets/examples/remote_fixtures/comb_parity_mux/generated/rtl/comb_parity_mux.v

Content is not inlined in the catalog. Read the upstream file: https://github.com/eriemon/verilog-generator/blob/HEAD/assets/examples/remote_fixtures/comb_parity_mux/generated/rtl/comb_parity_mux.v

## File: assets/examples/remote_fixtures/comb_parity_mux/generated/tb/tb_comb_parity_mux.v
size: 2826
sha: 396c37bdc7edd7d75ab439ea698df1f127ffffbd
upstream: https://github.com/eriemon/verilog-generator/blob/HEAD/assets/examples/remote_fixtures/comb_parity_mux/generated/tb/tb_comb_parity_mux.v

Content is not inlined in the catalog. Read the upstream file: https://github.com/eriemon/verilog-generator/blob/HEAD/assets/examples/remote_fixtures/comb_parity_mux/generated/tb/tb_comb_parity_mux.v

## File: assets/examples/remote_fixtures/comb_parity_mux/spec.json
size: 1988
sha: 3d3c13f8ceb5d6825d19cbf90ed4909d87eb91d2
upstream: https://github.com/eriemon/verilog-generator/blob/HEAD/assets/examples/remote_fixtures/comb_parity_mux/spec.json

Content is not inlined in the catalog. Read the upstream file: https://github.com/eriemon/verilog-generator/blob/HEAD/assets/examples/remote_fixtures/comb_parity_mux/spec.json

## File: assets/examples/remote_fixtures/pipeline_delay/generated/rtl/pipeline_delay.v
size: 4564
sha: ef9617534d2f4d1f57c71fedb9f791b1ede8fdfd
upstream: https://github.com/eriemon/verilog-generator/blob/HEAD/assets/examples/remote_fixtures/pipeline_delay/generated/rtl/pipeline_delay.v

Content is not inlined in the catalog. Read the upstream file: https://github.com/eriemon/verilog-generator/blob/HEAD/assets/examples/remote_fixtures/pipeline_delay/generated/rtl/pipeline_delay.v

## File: assets/examples/remote_fixtures/pipeline_delay/generated/tb/tb_pipeline_delay.v
size: 2626
sha: c57b696e0fe7979cc2f38086dd72f133abbcb018
upstream: https://github.com/eriemon/verilog-generator/blob/HEAD/assets/examples/remote_fixtures/pipeline_delay/generated/tb/tb_pipeline_delay.v

Content is not inlined in the catalog. Read the upstream file: https://github.com/eriemon/verilog-generator/blob/HEAD/assets/examples/remote_fixtures/pipeline_delay/generated/tb/tb_pipeline_delay.v

## File: assets/examples/remote_fixtures/pipeline_delay/spec.json
size: 2260
sha: e2b4f74f79cee127d552ac97bd050d81604c35e6
upstream: https://github.com/eriemon/verilog-generator/blob/HEAD/assets/examples/remote_fixtures/pipeline_delay/spec.json

Content is not inlined in the catalog. Read the upstream file: https://github.com/eriemon/verilog-generator/blob/HEAD/assets/examples/remote_fixtures/pipeline_delay/spec.json

## File: assets/examples/remote_fixtures/ready_valid_slice/generated/rtl/ready_valid_slice.v
size: 5342
sha: 1234a7e360bbce82423486a811a13401ff40bfb2
upstream: https://github.com/eriemon/verilog-generator/blob/HEAD/assets/examples/remote_fixtures/ready_valid_slice/generated/rtl/ready_valid_slice.v

Content is not inlined in the catalog. Read the upstream file: https://github.com/eriemon/verilog-generator/blob/HEAD/assets/examples/remote_fixtures/ready_valid_slice/generated/rtl/ready_valid_slice.v

## File: assets/examples/remote_fixtures/ready_valid_slice/generated/tb/tb_ready_valid_slice.v
size: 3004
sha: dce9cb5094e00d9ecc1677cd03ba7a04cffbd767
upstream: https://github.com/eriemon/verilog-generator/blob/HEAD/assets/examples/remote_fixtures/ready_valid_slice/generated/tb/tb_ready_valid_slice.v

Content is not inlined in the catalog. Read the upstream file: https://github.com/eriemon/verilog-generator/blob/HEAD/assets/examples/remote_fixtures/ready_valid_slice/generated/tb/tb_ready_valid_slice.v

## File: assets/examples/remote_fixtures/ready_valid_slice/spec.json
size: 2674
sha: b3a5eabcdcb341a99a62ca2b59f929c1f60846c9
upstream: https://github.com/eriemon/verilog-generator/blob/HEAD/assets/examples/remote_fixtures/ready_valid_slice/spec.json

Content is not inlined in the catalog. Read the upstream file: https://github.com/eriemon/verilog-generator/blob/HEAD/assets/examples/remote_fixtures/ready_valid_slice/spec.json

## File: assets/examples/rtl_erie_verilog_spec.json
size: 2194
sha: 6a3f7bbe9bce83cd10c03b3359c85b2517b479e1
upstream: https://github.com/eriemon/verilog-generator/blob/HEAD/assets/examples/rtl_erie_verilog_spec.json

Content is not inlined in the catalog. Read the upstream file: https://github.com/eriemon/verilog-generator/blob/HEAD/assets/examples/rtl_erie_verilog_spec.json

## File: assets/examples/use_case_templates/jesd_adc.json
size: 2433
sha: 7037eae1b7a25e1df7f290b155cc70f1cef3f9b0
upstream: https://github.com/eriemon/verilog-generator/blob/HEAD/assets/examples/use_case_templates/jesd_adc.json

Content is not inlined in the catalog. Read the upstream file: https://github.com/eriemon/verilog-generator/blob/HEAD/assets/examples/use_case_templates/jesd_adc.json

## File: assets/examples/use_case_templates/jesd_dac.json
size: 2552
sha: 8e04eea17bd9af414caee831993e026a8168a662
upstream: https://github.com/eriemon/verilog-generator/blob/HEAD/assets/examples/use_case_templates/jesd_dac.json

Content is not inlined in the catalog. Read the upstream file: https://github.com/eriemon/verilog-generator/blob/HEAD/assets/examples/use_case_templates/jesd_dac.json

## File: assets/examples/use_case_templates/mxfe_mixed.json
size: 2776
sha: f08ae3d5827206b14ca5f80d7417196dbaa07f07
upstream: https://github.com/eriemon/verilog-generator/blob/HEAD/assets/examples/use_case_templates/mxfe_mixed.json

Content is not inlined in the catalog. Read the upstream file: https://github.com/eriemon/verilog-generator/blob/HEAD/assets/examples/use_case_templates/mxfe_mixed.json

## File: assets/examples/use_case_templates/spi_adc.json
size: 2844
sha: be058e293d0ceecde0b14601f5a0da4e0811bb8c
upstream: https://github.com/eriemon/verilog-generator/blob/HEAD/assets/examples/use_case_templates/spi_adc.json

Content is not inlined in the catalog. Read the upstream file: https://github.com/eriemon/verilog-generator/blob/HEAD/assets/examples/use_case_templates/spi_adc.json

## File: assets/examples/use_case_templates/spi_dac.json
size: 2775
sha: 97aedcf98c99233ab772aac4c87998a0024ac0f9
upstream: https://github.com/eriemon/verilog-generator/blob/HEAD/assets/examples/use_case_templates/spi_dac.json

Content is not inlined in the catalog. Read the upstream file: https://github.com/eriemon/verilog-generator/blob/HEAD/assets/examples/use_case_templates/spi_dac.json

## File: assets/examples/verilog_pattern_templates/axi4_lite_csr.json
size: 2107
sha: 9da06da46af7415896723b2996296e1cd8a1c4aa
upstream: https://github.com/eriemon/verilog-generator/blob/HEAD/assets/examples/verilog_pattern_templates/axi4_lite_csr.json

Content is not inlined in the catalog. Read the upstream file: https://github.com/eriemon/verilog-generator/blob/HEAD/assets/examples/verilog_pattern_templates/axi4_lite_csr.json

## File: assets/examples/verilog_pattern_templates/axi_interconnect_dma.json
size: 2376
sha: f42267f8a9a1fedccbaaccb5ef15c775729d171e
upstream: https://github.com/eriemon/verilog-generator/blob/HEAD/assets/examples/verilog_pattern_templates/axi_interconnect_dma.json

Content is not inlined in the catalog. Read the upstream file: https://github.com/eriemon/verilog-generator/blob/HEAD/assets/examples/verilog_pattern_templates/axi_interconnect_dma.json

## File: assets/examples/verilog_pattern_templates/axis_ready_valid.json
size: 2358
sha: abed6ad69a035131e84536230ae70c05913880a8
upstream: https://github.com/eriemon/verilog-generator/blob/HEAD/assets/examples/verilog_pattern_templates/axis_ready_valid.json

Content is not inlined in the catalog. Read the upstream file: https://github.com/eriemon/verilog-generator/blob/HEAD/assets/examples/verilog_pattern_templates/axis_ready_valid.json

## File: assets/examples/verilog_pattern_templates/conv_load_store.json
size: 1882
sha: 374d62fc91ad266043c4b1ef903988a36c56944d
upstream: https://github.com/eriemon/verilog-generator/blob/HEAD/assets/examples/verilog_pattern_templates/conv_load_store.json

Content is not inlined in the catalog. Read the upstream file: https://github.com/eriemon/verilog-generator/blob/HEAD/assets/examples/verilog_pattern_templates/conv_load_store.json

## File: assets/external_interface_catalog.json
size: 2942
sha: fe0d3447bf58e727cca0c7cbe39cf7499cf29a3c
upstream: https://github.com/eriemon/verilog-generator/blob/HEAD/assets/external_interface_catalog.json

Content is not inlined in the catalog. Read the upstream file: https://github.com/eriemon/verilog-generator/blob/HEAD/assets/external_interface_catalog.json

## File: assets/ideal_bad_style_metrics.json
size: 17946
sha: 91957263129ae5a4380627ed1be1273018c0c9d0
upstream: https://github.com/eriemon/verilog-generator/blob/HEAD/assets/ideal_bad_style_metrics.json

Content is not inlined in the catalog. Read the upstream file: https://github.com/eriemon/verilog-generator/blob/HEAD/assets/ideal_bad_style_metrics.json

## File: assets/installer/manifest.projection.json
size: 2895
sha: 02482800fa877e0da2dbd6d6ea7d77e2721bad8d
upstream: https://github.com/eriemon/verilog-generator/blob/HEAD/assets/installer/manifest.projection.json

Content is not inlined in the catalog. Read the upstream file: https://github.com/eriemon/verilog-generator/blob/HEAD/assets/installer/manifest.projection.json

## File: assets/installer/platforms.json
size: 1349
sha: 59a01083aa099f6b038d6ccea62971816aac27ea
upstream: https://github.com/eriemon/verilog-generator/blob/HEAD/assets/installer/platforms.json

Content is not inlined in the catalog. Read the upstream file: https://github.com/eriemon/verilog-generator/blob/HEAD/assets/installer/platforms.json

## File: assets/interface_templates/ahb_lite_config.vinc
size: 2364
sha: 0425022e27acdae8f8598c18e1097dfa9057fede
upstream: https://github.com/eriemon/verilog-generator/blob/HEAD/assets/interface_templates/ahb_lite_config.vinc

Content is not inlined in the catalog. Read the upstream file: https://github.com/eriemon/verilog-generator/blob/HEAD/assets/interface_templates/ahb_lite_config.vinc

## File: assets/interface_templates/apb_config.vinc
size: 861
sha: 6bf7f7120797fa1b0226e0e50dd0961584ab4b97
upstream: https://github.com/eriemon/verilog-generator/blob/HEAD/assets/interface_templates/apb_config.vinc

Content is not inlined in the catalog. Read the upstream file: https://github.com/eriemon/verilog-generator/blob/HEAD/assets/interface_templates/apb_config.vinc

## File: assets/interface_templates/axi4_full_master.vinc
size: 1864
sha: 3113ad64a1283f0c03d91514740b6460b74b6b29
upstream: https://github.com/eriemon/verilog-generator/blob/HEAD/assets/interface_templates/axi4_full_master.vinc

Content is not inlined in the catalog. Read the upstream file: https://github.com/eriemon/verilog-generator/blob/HEAD/assets/interface_templates/axi4_full_master.vinc

## File: assets/interface_templates/axi4_full_slave.vinc
size: 1859
sha: 3dd40ad9da1f50a708018c17c95aec8b8748543a
upstream: https://github.com/eriemon/verilog-generator/blob/HEAD/assets/interface_templates/axi4_full_slave.vinc

Content is not inlined in the catalog. Read the upstream file: https://github.com/eriemon/verilog-generator/blob/HEAD/assets/interface_templates/axi4_full_slave.vinc

## File: assets/interface_templates/axi4_lite_config.vinc
size: 1621
sha: ef7f825c9a8c2707d446b11bb286674e2583dbb5
upstream: https://github.com/eriemon/verilog-generator/blob/HEAD/assets/interface_templates/axi4_lite_config.vinc

Content is not inlined in the catalog. Read the upstream file: https://github.com/eriemon/verilog-generator/blob/HEAD/assets/interface_templates/axi4_lite_config.vinc

## File: assets/interface_templates/axi_stream_duplex.vinc
size: 1105
sha: 895ad5c44209e784d02cad6f16a58dd83013113a
upstream: https://github.com/eriemon/verilog-generator/blob/HEAD/assets/interface_templates/axi_stream_duplex.vinc

Content is not inlined in the catalog. Read the upstream file: https://github.com/eriemon/verilog-generator/blob/HEAD/assets/interface_templates/axi_stream_duplex.vinc

## File: assets/interface_templates/catalog.json
size: 2620
sha: 49ba14eedb260c2d80fc3024661a7a560700e060
upstream: https://github.com/eriemon/verilog-generator/blob/HEAD/assets/interface_templates/catalog.json

Content is not inlined in the catalog. Read the upstream file: https://github.com/eriemon/verilog-generator/blob/HEAD/assets/interface_templates/catalog.json

## File: assets/project_ip_interface_manifest.template.json
size: 9668
sha: 7dd38014518daac098cc3519934a7218c7977559
upstream: https://github.com/eriemon/verilog-generator/blob/HEAD/assets/project_ip_interface_manifest.template.json

Content is not inlined in the catalog. Read the upstream file: https://github.com/eriemon/verilog-generator/blob/HEAD/assets/project_ip_interface_manifest.template.json

## File: assets/readme-workflow.png
size: 1508821
sha: f6db6071d9dc736f7a016926af6aa905cae848bf
upstream: https://github.com/eriemon/verilog-generator/blob/HEAD/assets/readme-workflow.png

Content is not inlined in the catalog. Read the upstream file: https://github.com/eriemon/verilog-generator/blob/HEAD/assets/readme-workflow.png

## File: assets/readme/design-profile-cn.png
size: 1507487
sha: 2f320466f6dbc35110448e7abe49ea4b0a96fb5f
upstream: https://github.com/eriemon/verilog-generator/blob/HEAD/assets/readme/design-profile-cn.png

Content is not inlined in the catalog. Read the upstream file: https://github.com/eriemon/verilog-generator/blob/HEAD/assets/readme/design-profile-cn.png

## File: assets/readme/design-profile.png
size: 1448674
sha: 9429cba13e459579194da120e6fba33c0c82938b
upstream: https://github.com/eriemon/verilog-generator/blob/HEAD/assets/readme/design-profile.png

Content is not inlined in the catalog. Read the upstream file: https://github.com/eriemon/verilog-generator/blob/HEAD/assets/readme/design-profile.png

## File: assets/readme/evidence-guard-cn.png
size: 1508821
sha: f6db6071d9dc736f7a016926af6aa905cae848bf
upstream: https://github.com/eriemon/verilog-generator/blob/HEAD/assets/readme/evidence-guard-cn.png

Content is not inlined in the catalog. Read the upstream file: https://github.com/eriemon/verilog-generator/blob/HEAD/assets/readme/evidence-guard-cn.png

## File: assets/readme/evidence-guard.png
size: 1508821
sha: f6db6071d9dc736f7a016926af6aa905cae848bf
upstream: https://github.com/eriemon/verilog-generator/blob/HEAD/assets/readme/evidence-guard.png

Content is not inlined in the catalog. Read the upstream file: https://github.com/eriemon/verilog-generator/blob/HEAD/assets/readme/evidence-guard.png

## File: assets/readme/hero-overview-cn.png
size: 1570180
sha: c1e5e8784796b732d011c884c32b7f49885c8a49
upstream: https://github.com/eriemon/verilog-generator/blob/HEAD/assets/readme/hero-overview-cn.png

Content is not inlined in the catalog. Read the upstream file: https://github.com/eriemon/verilog-generator/blob/HEAD/assets/readme/hero-overview-cn.png

## File: assets/readme/hero-overview.png
size: 1592571
sha: 0851ae383b11c9e5d76a92bc54cce1e59746891a
upstream: https://github.com/eriemon/verilog-generator/blob/HEAD/assets/readme/hero-overview.png

Content is not inlined in the catalog. Read the upstream file: https://github.com/eriemon/verilog-generator/blob/HEAD/assets/readme/hero-overview.png

## File: assets/readme/project-facts-cn.png
size: 1223842
sha: 3b4f9317ef02ccc4e8da67f52b899512e4996c71
upstream: https://github.com/eriemon/verilog-generator/blob/HEAD/assets/readme/project-facts-cn.png

Content is not inlined in the catalog. Read the upstream file: https://github.com/eriemon/verilog-generator/blob/HEAD/assets/readme/project-facts-cn.png

## File: assets/readme/project-facts.png
size: 1327312
sha: b4091fd39a1570b1ae299760f2ccb6a21503e9e9
upstream: https://github.com/eriemon/verilog-generator/blob/HEAD/assets/readme/project-facts.png

Content is not inlined in the catalog. Read the upstream file: https://github.com/eriemon/verilog-generator/blob/HEAD/assets/readme/project-facts.png

## File: assets/readme/rule-rendering-cn.png
size: 1430712
sha: 184956ade8efc820defa4cf37327772e6f4e47e1
upstream: https://github.com/eriemon/verilog-generator/blob/HEAD/assets/readme/rule-rendering-cn.png

Content is not inlined in the catalog. Read the upstream file: https://github.com/eriemon/verilog-generator/blob/HEAD/assets/readme/rule-rendering-cn.png

## File: assets/readme/rule-rendering.png
size: 1279196
sha: 65fbd29a275753a1ebdfd0954e42eed3901139da
upstream: https://github.com/eriemon/verilog-generator/blob/HEAD/assets/readme/rule-rendering.png

Content is not inlined in the catalog. Read the upstream file: https://github.com/eriemon/verilog-generator/blob/HEAD/assets/readme/rule-rendering.png

## File: assets/style_templates/header_prompt_none_mode.txt
size: 2139
sha: 5dc02c392b0e143e21dbd36d13110e8a557a2fcb
upstream: https://github.com/eriemon/verilog-generator/blob/HEAD/assets/style_templates/header_prompt_none_mode.txt

Content is not inlined in the catalog. Read the upstream file: https://github.com/eriemon/verilog-generator/blob/HEAD/assets/style_templates/header_prompt_none_mode.txt

## File: assets/style_templates/header_prompt_table_mode.txt
size: 2565
sha: 7e0289caa99d3b1729e5e6c17cdb617c5e8a4561
upstream: https://github.com/eriemon/verilog-generator/blob/HEAD/assets/style_templates/header_prompt_table_mode.txt

Content is not inlined in the catalog. Read the upstream file: https://github.com/eriemon/verilog-generator/blob/HEAD/assets/style_templates/header_prompt_table_mode.txt

## File: assets/style_templates/rtl_bus_grouping.tpl
size: 1045
sha: 8065c2ff64f2419a29350a5e841cf8cb5131101f
upstream: https://github.com/eriemon/verilog-generator/blob/HEAD/assets/style_templates/rtl_bus_grouping.tpl

Content is not inlined in the catalog. Read the upstream file: https://github.com/eriemon/verilog-generator/blob/HEAD/assets/style_templates/rtl_bus_grouping.tpl

## File: assets/style_templates/rtl_fsm.tpl
size: 832
sha: b174f16cf36e892aaccbc7257a1eed77b685a4af
upstream: https://github.com/eriemon/verilog-generator/blob/HEAD/assets/style_templates/rtl_fsm.tpl

Content is not inlined in the catalog. Read the upstream file: https://github.com/eriemon/verilog-generator/blob/HEAD/assets/style_templates/rtl_fsm.tpl

## File: assets/style_templates/rtl_header_bilingual.tpl
size: 1599
sha: db9ce30ddae0bf3330c7fd7be063d5707748f2b0
upstream: https://github.com/eriemon/verilog-generator/blob/HEAD/assets/style_templates/rtl_header_bilingual.tpl

Content is not inlined in the catalog. Read the upstream file: https://github.com/eriemon/verilog-generator/blob/HEAD/assets/style_templates/rtl_header_bilingual.tpl

## File: assets/style_templates/rtl_instantiation.tpl
size: 496
sha: 31370cfe62a2e2fdc6d8df416d77fe861dd3c514
upstream: https://github.com/eriemon/verilog-generator/blob/HEAD/assets/style_templates/rtl_instantiation.tpl

Content is not inlined in the catalog. Read the upstream file: https://github.com/eriemon/verilog-generator/blob/HEAD/assets/style_templates/rtl_instantiation.tpl

## File: assets/style_templates/rtl_region_order.tpl
size: 987
sha: 4919cef67e32f637985097eeef2beec6dc415e6a
upstream: https://github.com/eriemon/verilog-generator/blob/HEAD/assets/style_templates/rtl_region_order.tpl

Content is not inlined in the catalog. Read the upstream file: https://github.com/eriemon/verilog-generator/blob/HEAD/assets/style_templates/rtl_region_order.tpl

## File: assets/use_case_templates/catalog.json
size: 2820
sha: 09ccacfbbf2a790fb0b14d7aec2886a4eda59ae8
upstream: https://github.com/eriemon/verilog-generator/blob/HEAD/assets/use_case_templates/catalog.json

Content is not inlined in the catalog. Read the upstream file: https://github.com/eriemon/verilog-generator/blob/HEAD/assets/use_case_templates/catalog.json

## File: assets/use_case_templates/jesd_adc/constraints/system_constr.xdc
size: 454
sha: 93d266a76e3fee460823093b6b1bb122ae397495
upstream: https://github.com/eriemon/verilog-generator/blob/HEAD/assets/use_case_templates/jesd_adc/constraints/system_constr.xdc

Content is not inlined in the catalog. Read the upstream file: https://github.com/eriemon/verilog-generator/blob/HEAD/assets/use_case_templates/jesd_adc/constraints/system_constr.xdc

## File: assets/use_case_templates/jesd_adc/manifest.json
size: 1717
sha: 1480c24c37745e01abad67dc22a2056405600f23
upstream: https://github.com/eriemon/verilog-generator/blob/HEAD/assets/use_case_templates/jesd_adc/manifest.json

Content is not inlined in the catalog. Read the upstream file: https://github.com/eriemon/verilog-generator/blob/HEAD/assets/use_case_templates/jesd_adc/manifest.json

## File: assets/use_case_templates/jesd_adc/tcl/common_bd.tcl
size: 4141
sha: ad93b9e3e1988bec64aa17de17b9f68c2667db88
upstream: https://github.com/eriemon/verilog-generator/blob/HEAD/assets/use_case_templates/jesd_adc/tcl/common_bd.tcl

Content is not inlined in the catalog. Read the upstream file: https://github.com/eriemon/verilog-generator/blob/HEAD/assets/use_case_templates/jesd_adc/tcl/common_bd.tcl

## File: assets/use_case_templates/jesd_adc/tcl/system_bd.tcl
size: 920
sha: 79209230b20e992ff6e5fc26b396c1922445d1d0
upstream: https://github.com/eriemon/verilog-generator/blob/HEAD/assets/use_case_templates/jesd_adc/tcl/system_bd.tcl

Content is not inlined in the catalog. Read the upstream file: https://github.com/eriemon/verilog-generator/blob/HEAD/assets/use_case_templates/jesd_adc/tcl/system_bd.tcl

## File: assets/use_case_templates/jesd_adc/tcl/system_project.tcl
size: 1050
sha: 55340c95adfd99065410bd211ad6f15263ea917d
upstream: https://github.com/eriemon/verilog-generator/blob/HEAD/assets/use_case_templates/jesd_adc/tcl/system_project.tcl

Content is not inlined in the catalog. Read the upstream file: https://github.com/eriemon/verilog-generator/blob/HEAD/assets/use_case_templates/jesd_adc/tcl/system_project.tcl

## File: assets/use_case_templates/jesd_adc/verilog/system_top.v
size: 2972
sha: 8ed704400cdad2ddcd27c900d1d93ebf43062d1b
upstream: https://github.com/eriemon/verilog-generator/blob/HEAD/assets/use_case_templates/jesd_adc/verilog/system_top.v

Content is not inlined in the catalog. Read the upstream file: https://github.com/eriemon/verilog-generator/blob/HEAD/assets/use_case_templates/jesd_adc/verilog/system_top.v

## File: assets/use_case_templates/jesd_dac/constraints/system_constr.xdc
size: 299
sha: 15651927b102f3be6f0744699d70631be3877ba7
upstream: https://github.com/eriemon/verilog-generator/blob/HEAD/assets/use_case_templates/jesd_dac/constraints/system_constr.xdc

Content is not inlined in the catalog. Read the upstream file: https://github.com/eriemon/verilog-generator/blob/HEAD/assets/use_case_templates/jesd_dac/constraints/system_constr.xdc

## File: assets/use_case_templates/jesd_dac/manifest.json
size: 1752
sha: aaed61fe36e049809f822b3d18c2aebe9fb7f0a4
upstream: https://github.com/eriemon/verilog-generator/blob/HEAD/assets/use_case_templates/jesd_dac/manifest.json

Content is not inlined in the catalog. Read the upstream file: https://github.com/eriemon/verilog-generator/blob/HEAD/assets/use_case_templates/jesd_dac/manifest.json

## File: assets/use_case_templates/jesd_dac/tcl/common_bd.tcl
size: 4880
sha: 0f7d057769ba86a8ea762eee50c9e367f21ba3c1
upstream: https://github.com/eriemon/verilog-generator/blob/HEAD/assets/use_case_templates/jesd_dac/tcl/common_bd.tcl

Content is not inlined in the catalog. Read the upstream file: https://github.com/eriemon/verilog-generator/blob/HEAD/assets/use_case_templates/jesd_dac/tcl/common_bd.tcl

## File: assets/use_case_templates/jesd_dac/tcl/system_bd.tcl
size: 923
sha: d155f903464bb858640dc37e964f554f4d09d5c5
upstream: https://github.com/eriemon/verilog-generator/blob/HEAD/assets/use_case_templates/jesd_dac/tcl/system_bd.tcl

Content is not inlined in the catalog. Read the upstream file: https://github.com/eriemon/verilog-generator/blob/HEAD/assets/use_case_templates/jesd_dac/tcl/system_bd.tcl

## File: assets/use_case_templates/jesd_dac/tcl/system_project.tcl
size: 1102
sha: 9459d040d22a91d4a27aa6267c9699ad130c574d
upstream: https://github.com/eriemon/verilog-generator/blob/HEAD/assets/use_case_templates/jesd_dac/tcl/system_project.tcl

Content is not inlined in the catalog. Read the upstream file: https://github.com/eriemon/verilog-generator/blob/HEAD/assets/use_case_templates/jesd_dac/tcl/system_project.tcl

## File: assets/use_case_templates/jesd_dac/verilog/system_top.v
size: 2994
sha: 7d1a2ae21facb5aa66f75dd94f2981a535e9dc04
upstream: https://github.com/eriemon/verilog-generator/blob/HEAD/assets/use_case_templates/jesd_dac/verilog/system_top.v

Content is not inlined in the catalog. Read the upstream file: https://github.com/eriemon/verilog-generator/blob/HEAD/assets/use_case_templates/jesd_dac/verilog/system_top.v

## File: assets/use_case_templates/mxfe_mixed/constraints/system_constr.xdc
size: 380
sha: 5d7b38994cb5736e74df05f7b69b6ef40a70899b
upstream: https://github.com/eriemon/verilog-generator/blob/HEAD/assets/use_case_templates/mxfe_mixed/constraints/system_constr.xdc

Content is not inlined in the catalog. Read the upstream file: https://github.com/eriemon/verilog-generator/blob/HEAD/assets/use_case_templates/mxfe_mixed/constraints/system_constr.xdc

## File: assets/use_case_templates/mxfe_mixed/manifest.json
size: 1817
sha: 64cbb93b596f5bcc862e9b326bef2a81d3d7e007
upstream: https://github.com/eriemon/verilog-generator/blob/HEAD/assets/use_case_templates/mxfe_mixed/manifest.json

Content is not inlined in the catalog. Read the upstream file: https://github.com/eriemon/verilog-generator/blob/HEAD/assets/use_case_templates/mxfe_mixed/manifest.json

## File: assets/use_case_templates/mxfe_mixed/tcl/common_bd.tcl
size: 5546
sha: 83c1c4fa6aa9a2197520bfc06176d5922d61e954
upstream: https://github.com/eriemon/verilog-generator/blob/HEAD/assets/use_case_templates/mxfe_mixed/tcl/common_bd.tcl

Content is not inlined in the catalog. Read the upstream file: https://github.com/eriemon/verilog-generator/blob/HEAD/assets/use_case_templates/mxfe_mixed/tcl/common_bd.tcl

## File: assets/use_case_templates/mxfe_mixed/tcl/system_bd.tcl
size: 1255
sha: d5bf394426a9b95cd640654c3b78a66a1ed8a37b
upstream: https://github.com/eriemon/verilog-generator/blob/HEAD/assets/use_case_templates/mxfe_mixed/tcl/system_bd.tcl

Content is not inlined in the catalog. Read the upstream file: https://github.com/eriemon/verilog-generator/blob/HEAD/assets/use_case_templates/mxfe_mixed/tcl/system_bd.tcl

## File: assets/use_case_templates/mxfe_mixed/tcl/system_project.tcl
size: 1186
sha: 98df6d8989ab86b32cf85835121c2115f9120ece
upstream: https://github.com/eriemon/verilog-generator/blob/HEAD/assets/use_case_templates/mxfe_mixed/tcl/system_project.tcl

Content is not inlined in the catalog. Read the upstream file: https://github.com/eriemon/verilog-generator/blob/HEAD/assets/use_case_templates/mxfe_mixed/tcl/system_project.tcl

## File: assets/use_case_templates/mxfe_mixed/verilog/system_top.v
size: 3487
sha: c5a17d3461fa6b2896af96cf9c96d2d1c6006074
upstream: https://github.com/eriemon/verilog-generator/blob/HEAD/assets/use_case_templates/mxfe_mixed/verilog/system_top.v

Content is not inlined in the catalog. Read the upstream file: https://github.com/eriemon/verilog-generator/blob/HEAD/assets/use_case_templates/mxfe_mixed/verilog/system_top.v

## File: assets/use_case_templates/spi_adc/constraints/system_constr.xdc
size: 635
sha: 193beba035cdc27df88da3d16f7b0639c95f1b0d
upstream: https://github.com/eriemon/verilog-generator/blob/HEAD/assets/use_case_templates/spi_adc/constraints/system_constr.xdc

Content is not inlined in the catalog. Read the upstream file: https://github.com/eriemon/verilog-generator/blob/HEAD/assets/use_case_templates/spi_adc/constraints/system_constr.xdc

## File: assets/use_case_templates/spi_adc/manifest.json
size: 1756
sha: 1b48f521d9ab5e3be3ac02c144e3507cedece122
upstream: https://github.com/eriemon/verilog-generator/blob/HEAD/assets/use_case_templates/spi_adc/manifest.json

Content is not inlined in the catalog. Read the upstream file: https://github.com/eriemon/verilog-generator/blob/HEAD/assets/use_case_templates/spi_adc/manifest.json

## File: assets/use_case_templates/spi_adc/tcl/common_bd.tcl
size: 6401
sha: cd8f9cc8e674f1220001a4864494b710c5c14957
upstream: https://github.com/eriemon/verilog-generator/blob/HEAD/assets/use_case_templates/spi_adc/tcl/common_bd.tcl

Content is not inlined in the catalog. Read the upstream file: https://github.com/eriemon/verilog-generator/blob/HEAD/assets/use_case_templates/spi_adc/tcl/common_bd.tcl

## File: assets/use_case_templates/spi_adc/tcl/system_bd.tcl
size: 1687
sha: 9f435c961dfbfa4971fb7680072d1dc7bc2eadf9
upstream: https://github.com/eriemon/verilog-generator/blob/HEAD/assets/use_case_templates/spi_adc/tcl/system_bd.tcl

Content is not inlined in the catalog. Read the upstream file: https://github.com/eriemon/verilog-generator/blob/HEAD/assets/use_case_templates/spi_adc/tcl/system_bd.tcl

## File: assets/use_case_templates/spi_adc/tcl/system_project.tcl
size: 982
sha: ff80f45d52b14cceb90fb3bbb6d2b694cc05b46b
upstream: https://github.com/eriemon/verilog-generator/blob/HEAD/assets/use_case_templates/spi_adc/tcl/system_project.tcl

Content is not inlined in the catalog. Read the upstream file: https://github.com/eriemon/verilog-generator/blob/HEAD/assets/use_case_templates/spi_adc/tcl/system_project.tcl

## File: assets/use_case_templates/spi_adc/verilog/system_top.v
size: 4313
sha: df106db89827b57c844aff49b28da698fb3555ac
upstream: https://github.com/eriemon/verilog-generator/blob/HEAD/assets/use_case_templates/spi_adc/verilog/system_top.v

Content is not inlined in the catalog. Read the upstream file: https://github.com/eriemon/verilog-generator/blob/HEAD/assets/use_case_templates/spi_adc/verilog/system_top.v

## File: assets/use_case_templates/spi_dac/constraints/system_constr.xdc
size: 546
sha: 741391c69f9356bfb749d642d5764eb8d8616c87
upstream: https://github.com/eriemon/verilog-generator/blob/HEAD/assets/use_case_templates/spi_dac/constraints/system_constr.xdc

Content is not inlined in the catalog. Read the upstream file: https://github.com/eriemon/verilog-generator/blob/HEAD/assets/use_case_templates/spi_dac/constraints/system_constr.xdc

## File: assets/use_case_templates/spi_dac/manifest.json
size: 1674
sha: aebf4c53f1e7e6a7da78104c5d517e08cbf93742
upstream: https://github.com/eriemon/verilog-generator/blob/HEAD/assets/use_case_templates/spi_dac/manifest.json

Content is not inlined in the catalog. Read the upstream file: https://github.com/eriemon/verilog-generator/blob/HEAD/assets/use_case_templates/spi_dac/manifest.json

## File: assets/use_case_templates/spi_dac/tcl/common_bd.tcl
size: 5819
sha: 577e091b45e266d35626ae51d2da8d87b070304d
upstream: https://github.com/eriemon/verilog-generator/blob/HEAD/assets/use_case_templates/spi_dac/tcl/common_bd.tcl

Content is not inlined in the catalog. Read the upstream file: https://github.com/eriemon/verilog-generator/blob/HEAD/assets/use_case_templates/spi_dac/tcl/common_bd.tcl

## File: assets/use_case_templates/spi_dac/tcl/system_bd.tcl
size: 1060
sha: 26dcc268711aceae037871d03d78b9b80e1ff164
upstream: https://github.com/eriemon/verilog-generator/blob/HEAD/assets/use_case_templates/spi_dac/tcl/system_bd.tcl

Content is not inlined in the catalog. Read the upstream file: https://github.com/eriemon/verilog-generator/blob/HEAD/assets/use_case_templates/spi_dac/tcl/system_bd.tcl

## File: assets/use_case_templates/spi_dac/tcl/system_project.tcl
size: 981
sha: 0a0159082cb72a2c0534e80fb09cd7e97df8a8b2
upstream: https://github.com/eriemon/verilog-generator/blob/HEAD/assets/use_case_templates/spi_dac/tcl/system_project.tcl

Content is not inlined in the catalog. Read the upstream file: https://github.com/eriemon/verilog-generator/blob/HEAD/assets/use_case_templates/spi_dac/tcl/system_project.tcl

## File: assets/use_case_templates/spi_dac/verilog/system_top.v
size: 3610
sha: 5dc29afcdfae82913923f70c2a608261af85bd2d
upstream: https://github.com/eriemon/verilog-generator/blob/HEAD/assets/use_case_templates/spi_dac/verilog/system_top.v

Content is not inlined in the catalog. Read the upstream file: https://github.com/eriemon/verilog-generator/blob/HEAD/assets/use_case_templates/spi_dac/verilog/system_top.v

## File: assets/verilog_formatter_config/defaults.json
size: 6301
sha: 4d356de36401580819c93a8b7b26969cbaf2b1ad
upstream: https://github.com/eriemon/verilog-generator/blob/HEAD/assets/verilog_formatter_config/defaults.json

Content is not inlined in the catalog. Read the upstream file: https://github.com/eriemon/verilog-generator/blob/HEAD/assets/verilog_formatter_config/defaults.json

## File: assets/verilog_formatter_config/profiles/conservative.json
size: 283
sha: 7209265493c52e4fb6ea2e247df45efeb6c0b520
upstream: https://github.com/eriemon/verilog-generator/blob/HEAD/assets/verilog_formatter_config/profiles/conservative.json

Content is not inlined in the catalog. Read the upstream file: https://github.com/eriemon/verilog-generator/blob/HEAD/assets/verilog_formatter_config/profiles/conservative.json

## File: assets/verilog_formatter_config/profiles/example_compat.json
size: 484
sha: a3601a223f2aadbcea85ba1da0a5c71a83c9438a
upstream: https://github.com/eriemon/verilog-generator/blob/HEAD/assets/verilog_formatter_config/profiles/example_compat.json

Content is not inlined in the catalog. Read the upstream file: https://github.com/eriemon/verilog-generator/blob/HEAD/assets/verilog_formatter_config/profiles/example_compat.json

## File: assets/verilog_formatter_config/profiles/formatter-lint.json
size: 121
sha: c28c8fb6938e484d5adf5a0e03433c6d0d10d68a
upstream: https://github.com/eriemon/verilog-generator/blob/HEAD/assets/verilog_formatter_config/profiles/formatter-lint.json

Content is not inlined in the catalog. Read the upstream file: https://github.com/eriemon/verilog-generator/blob/HEAD/assets/verilog_formatter_config/profiles/formatter-lint.json

## File: assets/verilog_formatter_config/profiles/formatter-normalize.json
size: 182
sha: 9f6ba5809a9844aa39fff2546db5a613393ac61a
upstream: https://github.com/eriemon/verilog-generator/blob/HEAD/assets/verilog_formatter_config/profiles/formatter-normalize.json

Content is not inlined in the catalog. Read the upstream file: https://github.com/eriemon/verilog-generator/blob/HEAD/assets/verilog_formatter_config/profiles/formatter-normalize.json

## File: assets/verilog_formatter_config/profiles/formatter-preserve.json
size: 385
sha: 750a4fad4db20ebdeb5d0e4148d9bc9504bb0d22
upstream: https://github.com/eriemon/verilog-generator/blob/HEAD/assets/verilog_formatter_config/profiles/formatter-preserve.json

Content is not inlined in the catalog. Read the upstream file: https://github.com/eriemon/verilog-generator/blob/HEAD/assets/verilog_formatter_config/profiles/formatter-preserve.json

## File: assets/verilog_formatter_config/profiles/formatting.json
size: 270
sha: b99b0a32c37950bc9656e1a7a8ea8ec4b76cd806
upstream: https://github.com/eriemon/verilog-generator/blob/HEAD/assets/verilog_formatter_config/profiles/formatting.json

Content is not inlined in the catalog. Read the upstream file: https://github.com/eriemon/verilog-generator/blob/HEAD/assets/verilog_formatter_config/profiles/formatting.json

## File: assets/verilog_formatter_config/profiles/lint.json
size: 269
sha: 3c881e2eae793b90b37a6ca47cbde3455f7b1e46
upstream: https://github.com/eriemon/verilog-generator/blob/HEAD/assets/verilog_formatter_config/profiles/lint.json

Content is not inlined in the catalog. Read the upstream file: https://github.com/eriemon/verilog-generator/blob/HEAD/assets/verilog_formatter_config/profiles/lint.json

## File: assets/verilog_formatter_config/profiles/migration.json
size: 239
sha: d2f126cd34c9d3e14602898798e9d9a0d30caa4e
upstream: https://github.com/eriemon/verilog-generator/blob/HEAD/assets/verilog_formatter_config/profiles/migration.json

Content is not inlined in the catalog. Read the upstream file: https://github.com/eriemon/verilog-generator/blob/HEAD/assets/verilog_formatter_config/profiles/migration.json

## File: assets/verilog_formatter_config/profiles/stress_cases_compat.json
size: 484
sha: a3601a223f2aadbcea85ba1da0a5c71a83c9438a
upstream: https://github.com/eriemon/verilog-generator/blob/HEAD/assets/verilog_formatter_config/profiles/stress_cases_compat.json

Content is not inlined in the catalog. Read the upstream file: https://github.com/eriemon/verilog-generator/blob/HEAD/assets/verilog_formatter_config/profiles/stress_cases_compat.json

## File: assets/verilog_formatter_config/profiles/vitis-wrapper.json
size: 486
sha: 0e2d56656942739618ba27345572e396288b885c
upstream: https://github.com/eriemon/verilog-generator/blob/HEAD/assets/verilog_formatter_config/profiles/vitis-wrapper.json

Content is not inlined in the catalog. Read the upstream file: https://github.com/eriemon/verilog-generator/blob/HEAD/assets/verilog_formatter_config/profiles/vitis-wrapper.json

## File: assets/verilog_formatter_config/schema.json
size: 14060
sha: 2bfe913f319e838f81770c23885efa2abba3f06a
upstream: https://github.com/eriemon/verilog-generator/blob/HEAD/assets/verilog_formatter_config/schema.json

Content is not inlined in the catalog. Read the upstream file: https://github.com/eriemon/verilog-generator/blob/HEAD/assets/verilog_formatter_config/schema.json

## File: assets/verilog_formatter_config/templates/task-batch.json
size: 212
sha: d1661c0be9f05f1d4728d45bbe76a364d7f4118c
upstream: https://github.com/eriemon/verilog-generator/blob/HEAD/assets/verilog_formatter_config/templates/task-batch.json

Content is not inlined in the catalog. Read the upstream file: https://github.com/eriemon/verilog-generator/blob/HEAD/assets/verilog_formatter_config/templates/task-batch.json

## File: assets/verilog_formatter_config/templates/task-inplace.json
size: 221
sha: 0b33a78bda25e3ce1bf66dffab148f7a835e081a
upstream: https://github.com/eriemon/verilog-generator/blob/HEAD/assets/verilog_formatter_config/templates/task-inplace.json

Content is not inlined in the catalog. Read the upstream file: https://github.com/eriemon/verilog-generator/blob/HEAD/assets/verilog_formatter_config/templates/task-inplace.json

## File: assets/verilog_formatter_config/templates/task-single-file.json
size: 220
sha: 446bbd1f1fa70bb3d45c9c2e7d205cadd70549e2
upstream: https://github.com/eriemon/verilog-generator/blob/HEAD/assets/verilog_formatter_config/templates/task-single-file.json

Content is not inlined in the catalog. Read the upstream file: https://github.com/eriemon/verilog-generator/blob/HEAD/assets/verilog_formatter_config/templates/task-single-file.json

## File: assets/verilog_pattern_templates/axi4_lite_csr_shell.vinc
size: 562
sha: af80bea879efd0e27cbfdb68b028022a743af1d9
upstream: https://github.com/eriemon/verilog-generator/blob/HEAD/assets/verilog_pattern_templates/axi4_lite_csr_shell.vinc

Content is not inlined in the catalog. Read the upstream file: https://github.com/eriemon/verilog-generator/blob/HEAD/assets/verilog_pattern_templates/axi4_lite_csr_shell.vinc

## File: assets/verilog_pattern_templates/axi_interconnect_port_groups.vinc
size: 592
sha: c38fdcafad246d05352527632a3c96d28be701fe
upstream: https://github.com/eriemon/verilog-generator/blob/HEAD/assets/verilog_pattern_templates/axi_interconnect_port_groups.vinc

Content is not inlined in the catalog. Read the upstream file: https://github.com/eriemon/verilog-generator/blob/HEAD/assets/verilog_pattern_templates/axi_interconnect_port_groups.vinc

## File: assets/verilog_pattern_templates/axis_ready_valid_slice.vinc
size: 494
sha: ac6f4d664a5aab13d58742d93cee453a5619e3cf
upstream: https://github.com/eriemon/verilog-generator/blob/HEAD/assets/verilog_pattern_templates/axis_ready_valid_slice.vinc

Content is not inlined in the catalog. Read the upstream file: https://github.com/eriemon/verilog-generator/blob/HEAD/assets/verilog_pattern_templates/axis_ready_valid_slice.vinc

## File: assets/verilog_pattern_templates/catalog.json
size: 2282
sha: 0eb2c9f2f0c370037c3f354c473c2094954ed23a
upstream: https://github.com/eriemon/verilog-generator/blob/HEAD/assets/verilog_pattern_templates/catalog.json

Content is not inlined in the catalog. Read the upstream file: https://github.com/eriemon/verilog-generator/blob/HEAD/assets/verilog_pattern_templates/catalog.json

## File: assets/verilog_pattern_templates/conv_load_store_pipeline.vinc
size: 457
sha: 605bfd837d18cb018170015dcd8c5720f864eed9
upstream: https://github.com/eriemon/verilog-generator/blob/HEAD/assets/verilog_pattern_templates/conv_load_store_pipeline.vinc

Content is not inlined in the catalog. Read the upstream file: https://github.com/eriemon/verilog-generator/blob/HEAD/assets/verilog_pattern_templates/conv_load_store_pipeline.vinc

## File: assets/verilog_pattern_templates/counter_state_bridge.vinc
size: 443
sha: af4b5f705ed0833c05a5ba5c4bca3cf959e4d2f9
upstream: https://github.com/eriemon/verilog-generator/blob/HEAD/assets/verilog_pattern_templates/counter_state_bridge.vinc

Content is not inlined in the catalog. Read the upstream file: https://github.com/eriemon/verilog-generator/blob/HEAD/assets/verilog_pattern_templates/counter_state_bridge.vinc

## File: assets/verilog_pattern_templates/equivalence_wrapper_probe.vinc
size: 306
sha: 2e7ec6bc170d18d199a6001e3a03bea751360607
upstream: https://github.com/eriemon/verilog-generator/blob/HEAD/assets/verilog_pattern_templates/equivalence_wrapper_probe.vinc

Content is not inlined in the catalog. Read the upstream file: https://github.com/eriemon/verilog-generator/blob/HEAD/assets/verilog_pattern_templates/equivalence_wrapper_probe.vinc

## File: assets/verilog_pattern_templates/fsm_state_transition.vinc
size: 1030
sha: 374d050a46f5157a77f5a4a1034121d97854a08d
upstream: https://github.com/eriemon/verilog-generator/blob/HEAD/assets/verilog_pattern_templates/fsm_state_transition.vinc

Content is not inlined in the catalog. Read the upstream file: https://github.com/eriemon/verilog-generator/blob/HEAD/assets/verilog_pattern_templates/fsm_state_transition.vinc

## File: assets/verilog_pattern_templates/phase_output_registering.vinc
size: 404
sha: a0e47cbf26c75c9e938732257caecbcfb65fd1ba
upstream: https://github.com/eriemon/verilog-generator/blob/HEAD/assets/verilog_pattern_templates/phase_output_registering.vinc

Content is not inlined in the catalog. Read the upstream file: https://github.com/eriemon/verilog-generator/blob/HEAD/assets/verilog_pattern_templates/phase_output_registering.vinc

## File: assets/verilog_pattern_templates/wrapper_top_stitching.vinc
size: 608
sha: e02cb9f7349bf1f0ae195cee08921ec540c40428
upstream: https://github.com/eriemon/verilog-generator/blob/HEAD/assets/verilog_pattern_templates/wrapper_top_stitching.vinc

Content is not inlined in the catalog. Read the upstream file: https://github.com/eriemon/verilog-generator/blob/HEAD/assets/verilog_pattern_templates/wrapper_top_stitching.vinc

## File: assets/verilog_quality_gates.json
size: 39153
sha: 6da875504edfde432f252d1e767dc68200456aa1
upstream: https://github.com/eriemon/verilog-generator/blob/HEAD/assets/verilog_quality_gates.json

Content is not inlined in the catalog. Read the upstream file: https://github.com/eriemon/verilog-generator/blob/HEAD/assets/verilog_quality_gates.json

## File: assets/verilog_style_rules.json
size: 12075
sha: aa075e4dca9ef71736ddb9a075f62be2d843b9a1
upstream: https://github.com/eriemon/verilog-generator/blob/HEAD/assets/verilog_style_rules.json

Content is not inlined in the catalog. Read the upstream file: https://github.com/eriemon/verilog-generator/blob/HEAD/assets/verilog_style_rules.json

## File: assets/xilinx_primitive_semantics.json
size: 21908
sha: 902dfa8968adc4ffadeb89d65b65fdc57acada0d
upstream: https://github.com/eriemon/verilog-generator/blob/HEAD/assets/xilinx_primitive_semantics.json

Content is not inlined in the catalog. Read the upstream file: https://github.com/eriemon/verilog-generator/blob/HEAD/assets/xilinx_primitive_semantics.json

## File: agents/openai.yaml
size: 363
sha: 10779120d5b9f525f62f5bfc83046f238b94cc5f
upstream: https://github.com/eriemon/verilog-generator/blob/HEAD/agents/openai.yaml

Content is not inlined in the catalog. Read the upstream file: https://github.com/eriemon/verilog-generator/blob/HEAD/agents/openai.yaml

## File: CITATION.cff
size: 999
sha: 0858b2ddbf56b1ed80f0268482771eb630e41cd7
upstream: https://github.com/eriemon/verilog-generator/blob/HEAD/CITATION.cff

Content is not inlined in the catalog. Read the upstream file: https://github.com/eriemon/verilog-generator/blob/HEAD/CITATION.cff

## File: config/defaults.json
size: 19369
sha: 83a37a922c804ff7cc3bb436215edc491b9f470a
upstream: https://github.com/eriemon/verilog-generator/blob/HEAD/config/defaults.json

Content is not inlined in the catalog. Read the upstream file: https://github.com/eriemon/verilog-generator/blob/HEAD/config/defaults.json

## File: config/installer/installer-manifest.json
size: 3207
sha: f2e5ae68b670497440e01c780effcb736007a313
upstream: https://github.com/eriemon/verilog-generator/blob/HEAD/config/installer/installer-manifest.json

Content is not inlined in the catalog. Read the upstream file: https://github.com/eriemon/verilog-generator/blob/HEAD/config/installer/installer-manifest.json

## File: config/installer/installer-manifest.schema.json
size: 835
sha: 464cb19b61f13a3531b20211eec86fb198c294f2
upstream: https://github.com/eriemon/verilog-generator/blob/HEAD/config/installer/installer-manifest.schema.json

Content is not inlined in the catalog. Read the upstream file: https://github.com/eriemon/verilog-generator/blob/HEAD/config/installer/installer-manifest.schema.json

## File: config/installer/installer-projection.schema.json
size: 253
sha: fea6b3c6fec98ad6a2096d61d5968f54c5c6bf34
upstream: https://github.com/eriemon/verilog-generator/blob/HEAD/config/installer/installer-projection.schema.json

Content is not inlined in the catalog. Read the upstream file: https://github.com/eriemon/verilog-generator/blob/HEAD/config/installer/installer-projection.schema.json

## File: config/installer/platform-catalog.json
size: 1839
sha: 190ad11a2faa6c4f4c510109e76b674da5dc8de2
upstream: https://github.com/eriemon/verilog-generator/blob/HEAD/config/installer/platform-catalog.json

Content is not inlined in the catalog. Read the upstream file: https://github.com/eriemon/verilog-generator/blob/HEAD/config/installer/platform-catalog.json

## File: config/installer/platform-catalog.schema.json
size: 292
sha: 0f4aa69350fb74c06e9e6906092f7e5a91cc1749
upstream: https://github.com/eriemon/verilog-generator/blob/HEAD/config/installer/platform-catalog.schema.json

Content is not inlined in the catalog. Read the upstream file: https://github.com/eriemon/verilog-generator/blob/HEAD/config/installer/platform-catalog.schema.json

## File: config/installer/platform-overrides.json
size: 45
sha: 8be1c2069cc481f29b16819dd0a7140800121d2f
upstream: https://github.com/eriemon/verilog-generator/blob/HEAD/config/installer/platform-overrides.json

```text
{
  "schema_version": 1,
  "platforms": []
}
```

## File: config/installer/release-installer-manifest.json
size: 3429
sha: e7074794f7dc572388d6be4f88d04012647f0837
upstream: https://github.com/eriemon/verilog-generator/blob/HEAD/config/installer/release-installer-manifest.json

Content is not inlined in the catalog. Read the upstream file: https://github.com/eriemon/verilog-generator/blob/HEAD/config/installer/release-installer-manifest.json

## File: config/installer/verification-cases.json
size: 2212
sha: 7d9928933e12b439a98df474fbdfa409ee56686b
upstream: https://github.com/eriemon/verilog-generator/blob/HEAD/config/installer/verification-cases.json

Content is not inlined in the catalog. Read the upstream file: https://github.com/eriemon/verilog-generator/blob/HEAD/config/installer/verification-cases.json

## File: config/installer/verification-cases.schema.json
size: 339
sha: 912fd8ef9259927d447e3591759ee4f44e07405c
upstream: https://github.com/eriemon/verilog-generator/blob/HEAD/config/installer/verification-cases.schema.json

Content is not inlined in the catalog. Read the upstream file: https://github.com/eriemon/verilog-generator/blob/HEAD/config/installer/verification-cases.schema.json

## File: config/registry/commands/external.json
size: 10025
sha: d28e598db8b2de3e93fe24b75cd3fdbf51a22d97
upstream: https://github.com/eriemon/verilog-generator/blob/HEAD/config/registry/commands/external.json

Content is not inlined in the catalog. Read the upstream file: https://github.com/eriemon/verilog-generator/blob/HEAD/config/registry/commands/external.json

## File: config/registry/commands/generation.json
size: 3086
sha: ca1176cbbdf8dabf153a89db3ea1d7121e588a2a
upstream: https://github.com/eriemon/verilog-generator/blob/HEAD/config/registry/commands/generation.json

Content is not inlined in the catalog. Read the upstream file: https://github.com/eriemon/verilog-generator/blob/HEAD/config/registry/commands/generation.json

## File: config/registry/commands/quality.json
size: 9597
sha: 1c73110823f174a0fd2c8b5aa5fe3069b7ab7116
upstream: https://github.com/eriemon/verilog-generator/blob/HEAD/config/registry/commands/quality.json

Content is not inlined in the catalog. Read the upstream file: https://github.com/eriemon/verilog-generator/blob/HEAD/config/registry/commands/quality.json

## File: config/registry/commands/registry.json
size: 6699
sha: 9f71250b5ab19bac0356992e85a293bb1d1d2dad
upstream: https://github.com/eriemon/verilog-generator/blob/HEAD/config/registry/commands/registry.json

Content is not inlined in the catalog. Read the upstream file: https://github.com/eriemon/verilog-generator/blob/HEAD/config/registry/commands/registry.json

## File: config/registry/commands/remote.json
size: 7983
sha: 37c2e7dca35cb1d69fa7b045fa5cf26dc0a2e8d5
upstream: https://github.com/eriemon/verilog-generator/blob/HEAD/config/registry/commands/remote.json

Content is not inlined in the catalog. Read the upstream file: https://github.com/eriemon/verilog-generator/blob/HEAD/config/registry/commands/remote.json

## File: config/registry/commands/toolchain.json
size: 15450
sha: b241fba6517cc2b836b288ae981483cbe475efd8
upstream: https://github.com/eriemon/verilog-generator/blob/HEAD/config/registry/commands/toolchain.json

Content is not inlined in the catalog. Read the upstream file: https://github.com/eriemon/verilog-generator/blob/HEAD/config/registry/commands/toolchain.json

## File: config/registry/commands/validation.json
size: 5411
sha: 23d3e92b3e1c0305e93da06e31d527069fd97947
upstream: https://github.com/eriemon/verilog-generator/blob/HEAD/config/registry/commands/validation.json

Content is not inlined in the catalog. Read the upstream file: https://github.com/eriemon/verilog-generator/blob/HEAD/config/registry/commands/validation.json

## File: config/registry/commands/workflow.json
size: 34201
sha: 2f53b5e2ac6a822c860c91d1688a9c899e6163c2
upstream: https://github.com/eriemon/verilog-generator/blob/HEAD/config/registry/commands/workflow.json

Content is not inlined in the catalog. Read the upstream file: https://github.com/eriemon/verilog-generator/blob/HEAD/config/registry/commands/workflow.json

## File: config/registry/documents/catalog.json
size: 15360
sha: 0b9764f29ec7e2804595ec3e04b7779ca37695ae
upstream: https://github.com/eriemon/verilog-generator/blob/HEAD/config/registry/documents/catalog.json

Content is not inlined in the catalog. Read the upstream file: https://github.com/eriemon/verilog-generator/blob/HEAD/config/registry/documents/catalog.json

## File: config/registry/governance/config.json
size: 353
sha: 08c9516d1925e5948e4dd556486a81509554bed9
upstream: https://github.com/eriemon/verilog-generator/blob/HEAD/config/registry/governance/config.json

Content is not inlined in the catalog. Read the upstream file: https://github.com/eriemon/verilog-generator/blob/HEAD/config/registry/governance/config.json

## File: config/registry/governance/reviews.json
size: 25446
sha: eb232630c55a8acafa331d04c84dbac43a3c66df
upstream: https://github.com/eriemon/verilog-generator/blob/HEAD/config/registry/governance/reviews.json

Content is not inlined in the catalog. Read the upstream file: https://github.com/eriemon/verilog-generator/blob/HEAD/config/registry/governance/reviews.json

## File: config/registry/manifest.json
size: 913
sha: 2d59c3073f2d8d2fccef11ff12d6ef8052267feb
upstream: https://github.com/eriemon/verilog-generator/blob/HEAD/config/registry/manifest.json

Content is not inlined in the catalog. Read the upstream file: https://github.com/eriemon/verilog-generator/blob/HEAD/config/registry/manifest.json

## File: config/registry/registry.sqlite3
size: 622592
sha: c13fd0a30add137ff53089500b272ebac8789797
upstream: https://github.com/eriemon/verilog-generator/blob/HEAD/config/registry/registry.sqlite3

Content is not inlined in the catalog. Read the upstream file: https://github.com/eriemon/verilog-generator/blob/HEAD/config/registry/registry.sqlite3

## File: config/registry/schemas/command.schema.json
size: 3400
sha: eca319c78472bfcf3f30c3fabd54e1569d23ae5f
upstream: https://github.com/eriemon/verilog-generator/blob/HEAD/config/registry/schemas/command.schema.json

Content is not inlined in the catalog. Read the upstream file: https://github.com/eriemon/verilog-generator/blob/HEAD/config/registry/schemas/command.schema.json

## File: config/registry/schemas/document-catalog.schema.json
size: 1385
sha: a560d249e9c3d8c61205dcc89e59201da21bd7a5
upstream: https://github.com/eriemon/verilog-generator/blob/HEAD/config/registry/schemas/document-catalog.schema.json

Content is not inlined in the catalog. Read the upstream file: https://github.com/eriemon/verilog-generator/blob/HEAD/config/registry/schemas/document-catalog.schema.json

## File: config/registry/schemas/governance-config.schema.json
size: 1059
sha: 23a520c076e3d86fe06941bb49cab753321417c3
upstream: https://github.com/eriemon/verilog-generator/blob/HEAD/config/registry/schemas/governance-config.schema.json

Content is not inlined in the catalog. Read the upstream file: https://github.com/eriemon/verilog-generator/blob/HEAD/config/registry/schemas/governance-config.schema.json

## File: config/registry/schemas/governance-reviews.schema.json
size: 682
sha: ac47b84296dcc2142ff4e2a9aae8b04d33fa4ef6
upstream: https://github.com/eriemon/verilog-generator/blob/HEAD/config/registry/schemas/governance-reviews.schema.json

Content is not inlined in the catalog. Read the upstream file: https://github.com/eriemon/verilog-generator/blob/HEAD/config/registry/schemas/governance-reviews.schema.json

## File: config/registry/schemas/workflow.schema.json
size: 1054
sha: 68cfefa925d793d44a907211e1d7538cfa4c9fd2
upstream: https://github.com/eriemon/verilog-generator/blob/HEAD/config/registry/schemas/workflow.schema.json

Content is not inlined in the catalog. Read the upstream file: https://github.com/eriemon/verilog-generator/blob/HEAD/config/registry/schemas/workflow.schema.json

## File: config/registry/workflows/catalog.json
size: 3409
sha: 381b15bac6b9492b60571fd3d4f20516507b6806
upstream: https://github.com/eriemon/verilog-generator/blob/HEAD/config/registry/workflows/catalog.json

Content is not inlined in the catalog. Read the upstream file: https://github.com/eriemon/verilog-generator/blob/HEAD/config/registry/workflows/catalog.json

## File: config/runtime-manifest.json
size: 451
sha: 3f1c8e64f5da96edabdf35d0551bddf563ff24ae
upstream: https://github.com/eriemon/verilog-generator/blob/HEAD/config/runtime-manifest.json

Content is not inlined in the catalog. Read the upstream file: https://github.com/eriemon/verilog-generator/blob/HEAD/config/runtime-manifest.json

## File: CONTRIBUTING.md
size: 1881
sha: 128efa0b31cfa0017a6fc31f71cfc561cff6d3b3
upstream: https://github.com/eriemon/verilog-generator/blob/HEAD/CONTRIBUTING.md

Content is not inlined in the catalog. Read the upstream file: https://github.com/eriemon/verilog-generator/blob/HEAD/CONTRIBUTING.md

## File: evals/evals.json
size: 14787
sha: 0a670d537aa9467c7bff2b74952a18dacf0e95a9
upstream: https://github.com/eriemon/verilog-generator/blob/HEAD/evals/evals.json

Content is not inlined in the catalog. Read the upstream file: https://github.com/eriemon/verilog-generator/blob/HEAD/evals/evals.json

## File: evals/vg_semantic_gate_cases.json
size: 53481
sha: 094c47a20c87d23c8b713f4fa347eb0d058a192a
upstream: https://github.com/eriemon/verilog-generator/blob/HEAD/evals/vg_semantic_gate_cases.json

Content is not inlined in the catalog. Read the upstream file: https://github.com/eriemon/verilog-generator/blob/HEAD/evals/vg_semantic_gate_cases.json

## File: install.bat
size: 2501
sha: 8ebee79dcf4b3280b56dbf11d73ccda09ea3d7d4
upstream: https://github.com/eriemon/verilog-generator/blob/HEAD/install.bat

Content is not inlined in the catalog. Read the upstream file: https://github.com/eriemon/verilog-generator/blob/HEAD/install.bat

## File: install.ps1
size: 7857
sha: 5b34e7fa2fcadc049965f835b0ac13d4a3996e6e
upstream: https://github.com/eriemon/verilog-generator/blob/HEAD/install.ps1

Content is not inlined in the catalog. Read the upstream file: https://github.com/eriemon/verilog-generator/blob/HEAD/install.ps1

## File: install.sh
size: 6110
sha: 2b5499ab1d8c2a40a245bc3b93cecbdfee6f3e9a
upstream: https://github.com/eriemon/verilog-generator/blob/HEAD/install.sh

Content is not inlined in the catalog. Read the upstream file: https://github.com/eriemon/verilog-generator/blob/HEAD/install.sh

## File: installer.manifest.env
size: 612
sha: c49b085b4e466707915fca09a67799dbd401de16
upstream: https://github.com/eriemon/verilog-generator/blob/HEAD/installer.manifest.env

Content is not inlined in the catalog. Read the upstream file: https://github.com/eriemon/verilog-generator/blob/HEAD/installer.manifest.env

## File: LICENSE
size: 9193
sha: 5d7ca4cce57b799130182b81c2f95fcc59337e94
upstream: https://github.com/eriemon/verilog-generator/blob/HEAD/LICENSE

Content is not inlined in the catalog. Read the upstream file: https://github.com/eriemon/verilog-generator/blob/HEAD/LICENSE

## File: pyproject.toml
size: 496
sha: 480df066bf3eeb6227a697968d37639241020062
upstream: https://github.com/eriemon/verilog-generator/blob/HEAD/pyproject.toml

Content is not inlined in the catalog. Read the upstream file: https://github.com/eriemon/verilog-generator/blob/HEAD/pyproject.toml

## File: README-CN.md
size: 8033
sha: 619197b33447719b9c19712a7cc34956b13458a5
upstream: https://github.com/eriemon/verilog-generator/blob/HEAD/README-CN.md

Content is not inlined in the catalog. Read the upstream file: https://github.com/eriemon/verilog-generator/blob/HEAD/README-CN.md

## File: RELEASE_RECEIPT.json
size: 4448751
sha: 26a30506982e3ff1dc256b211db10e0f6c6aaeba
upstream: https://github.com/eriemon/verilog-generator/blob/HEAD/RELEASE_RECEIPT.json

Content is not inlined in the catalog. Read the upstream file: https://github.com/eriemon/verilog-generator/blob/HEAD/RELEASE_RECEIPT.json

## File: SECURITY.md
size: 1093
sha: 73677f69dac07463640455363fd039a54b168999
upstream: https://github.com/eriemon/verilog-generator/blob/HEAD/SECURITY.md

Content is not inlined in the catalog. Read the upstream file: https://github.com/eriemon/verilog-generator/blob/HEAD/SECURITY.md

## File: VERSION
size: 7
sha: 46b105a30dcc14a31c702e5c69e1dc1c1ee35ec1
upstream: https://github.com/eriemon/verilog-generator/blob/HEAD/VERSION

```text
v2.0.0
```
