qtiming 0.1.0__tar.gz

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
Files changed (226) hide show
  1. qtiming-0.1.0/.gitignore +18 -0
  2. qtiming-0.1.0/CHANGELOG.md +57 -0
  3. qtiming-0.1.0/CITATION.cff +12 -0
  4. qtiming-0.1.0/CONTRIBUTING.md +16 -0
  5. qtiming-0.1.0/Docs/Timed semantics for dynamic quantum programs.md +617 -0
  6. qtiming-0.1.0/Docs/Timing rulebook for quantum computers.md +49 -0
  7. qtiming-0.1.0/Docs/cli.md +82 -0
  8. qtiming-0.1.0/Docs/contracts.md +133 -0
  9. qtiming-0.1.0/Docs/errors.md +98 -0
  10. qtiming-0.1.0/Docs/index.md +69 -0
  11. qtiming-0.1.0/Docs/install.md +59 -0
  12. qtiming-0.1.0/Docs/obligations.md +89 -0
  13. qtiming-0.1.0/Docs/personality-spec/artiq.md +64 -0
  14. qtiming-0.1.0/Docs/personality-spec/ibm.md +62 -0
  15. qtiming-0.1.0/Docs/personality-spec/q1.md +65 -0
  16. qtiming-0.1.0/Docs/personality-spec/qua.md +54 -0
  17. qtiming-0.1.0/Docs/policies.md +114 -0
  18. qtiming-0.1.0/Docs/qiskit.md +104 -0
  19. qtiming-0.1.0/Docs/quickstart.md +100 -0
  20. qtiming-0.1.0/Docs/status.md +43 -0
  21. qtiming-0.1.0/Docs/theory/T4-windowing.md +26 -0
  22. qtiming-0.1.0/Docs/theory/dc-rules.md +54 -0
  23. qtiming-0.1.0/Docs/theory/definitions.md +91 -0
  24. qtiming-0.1.0/Docs/theory/index.md +21 -0
  25. qtiming-0.1.0/Docs/theory/sc-derivation.md +92 -0
  26. qtiming-0.1.0/Docs/theory/theorems.md +303 -0
  27. qtiming-0.1.0/Docs/verdicts.md +127 -0
  28. qtiming-0.1.0/LICENSE +177 -0
  29. qtiming-0.1.0/NOTICE +8 -0
  30. qtiming-0.1.0/PKG-INFO +262 -0
  31. qtiming-0.1.0/README.md +210 -0
  32. qtiming-0.1.0/artifact/README.md +31 -0
  33. qtiming-0.1.0/benchmarks/README.md +70 -0
  34. qtiming-0.1.0/benchmarks/families/dynamarq/README.md +10 -0
  35. qtiming-0.1.0/experiments/ibm_dryrun/README.md +53 -0
  36. qtiming-0.1.0/prereg/README.md +21 -0
  37. qtiming-0.1.0/pyproject.toml +83 -0
  38. qtiming-0.1.0/src/qtiming/__init__.py +0 -0
  39. qtiming-0.1.0/src/qtiming/bench/__init__.py +327 -0
  40. qtiming-0.1.0/src/qtiming/bench/diff.py +230 -0
  41. qtiming-0.1.0/src/qtiming/bench/report.py +161 -0
  42. qtiming-0.1.0/src/qtiming/bench/truth.py +88 -0
  43. qtiming-0.1.0/src/qtiming/cli/__init__.py +0 -0
  44. qtiming-0.1.0/src/qtiming/cli/cmd_evidence.py +35 -0
  45. qtiming-0.1.0/src/qtiming/cli/main.py +398 -0
  46. qtiming-0.1.0/src/qtiming/contract/__init__.py +0 -0
  47. qtiming-0.1.0/src/qtiming/contract/compat.py +49 -0
  48. qtiming-0.1.0/src/qtiming/contract/instances/README.md +30 -0
  49. qtiming-0.1.0/src/qtiming/contract/instances/artiq.toml +45 -0
  50. qtiming-0.1.0/src/qtiming/contract/instances/ibm_heron.toml +62 -0
  51. qtiming-0.1.0/src/qtiming/contract/instances/ibm_heron_snapshot.json +22 -0
  52. qtiming-0.1.0/src/qtiming/contract/instances/q1.toml +88 -0
  53. qtiming-0.1.0/src/qtiming/contract/instances/qua.toml +65 -0
  54. qtiming-0.1.0/src/qtiming/contract/loader.py +355 -0
  55. qtiming-0.1.0/src/qtiming/contract/model.py +123 -0
  56. qtiming-0.1.0/src/qtiming/contract/schema.py +106 -0
  57. qtiming-0.1.0/src/qtiming/contract/target_import.py +46 -0
  58. qtiming-0.1.0/src/qtiming/core/__init__.py +0 -0
  59. qtiming-0.1.0/src/qtiming/core/ast.py +140 -0
  60. qtiming-0.1.0/src/qtiming/core/errors.py +36 -0
  61. qtiming-0.1.0/src/qtiming/core/ids.py +34 -0
  62. qtiming-0.1.0/src/qtiming/core/labels.py +121 -0
  63. qtiming-0.1.0/src/qtiming/core/provenance.py +77 -0
  64. qtiming-0.1.0/src/qtiming/core/time.py +96 -0
  65. qtiming-0.1.0/src/qtiming/dispatch/__init__.py +22 -0
  66. qtiming-0.1.0/src/qtiming/dispatch/artiq.py +70 -0
  67. qtiming-0.1.0/src/qtiming/dispatch/ibm.py +83 -0
  68. qtiming-0.1.0/src/qtiming/dispatch/q1.py +102 -0
  69. qtiming-0.1.0/src/qtiming/dispatch/qua.py +88 -0
  70. qtiming-0.1.0/src/qtiming/elab/__init__.py +360 -0
  71. qtiming-0.1.0/src/qtiming/evidence/__init__.py +15 -0
  72. qtiming-0.1.0/src/qtiming/evidence/ingest.py +235 -0
  73. qtiming-0.1.0/src/qtiming/exec/__init__.py +0 -0
  74. qtiming-0.1.0/src/qtiming/exec/artiq.py +100 -0
  75. qtiming-0.1.0/src/qtiming/exec/engine.py +235 -0
  76. qtiming-0.1.0/src/qtiming/exec/explore.py +43 -0
  77. qtiming-0.1.0/src/qtiming/exec/ibm.py +117 -0
  78. qtiming-0.1.0/src/qtiming/exec/oracle.py +88 -0
  79. qtiming-0.1.0/src/qtiming/exec/q1.py +95 -0
  80. qtiming-0.1.0/src/qtiming/exec/qua.py +95 -0
  81. qtiming-0.1.0/src/qtiming/frontend/__init__.py +40 -0
  82. qtiming-0.1.0/src/qtiming/frontend/_shared.py +149 -0
  83. qtiming-0.1.0/src/qtiming/frontend/annotations.py +81 -0
  84. qtiming-0.1.0/src/qtiming/frontend/lint.py +116 -0
  85. qtiming-0.1.0/src/qtiming/frontend/payload.py +113 -0
  86. qtiming-0.1.0/src/qtiming/frontend/program.py +51 -0
  87. qtiming-0.1.0/src/qtiming/frontend/qasm3_fe.py +341 -0
  88. qtiming-0.1.0/src/qtiming/frontend/qiskit_expr.py +89 -0
  89. qtiming-0.1.0/src/qtiming/frontend/qiskit_fe.py +220 -0
  90. qtiming-0.1.0/src/qtiming/frontend/serialise.py +63 -0
  91. qtiming-0.1.0/src/qtiming/frontend/stretch.py +71 -0
  92. qtiming-0.1.0/src/qtiming/graph/__init__.py +0 -0
  93. qtiming-0.1.0/src/qtiming/graph/builder.py +245 -0
  94. qtiming-0.1.0/src/qtiming/graph/export.py +25 -0
  95. qtiming-0.1.0/src/qtiming/graph/invariants.py +67 -0
  96. qtiming-0.1.0/src/qtiming/graph/lteg.py +153 -0
  97. qtiming-0.1.0/src/qtiming/graph/window.py +120 -0
  98. qtiming-0.1.0/src/qtiming/oblig/__init__.py +0 -0
  99. qtiming-0.1.0/src/qtiming/oblig/generate.py +145 -0
  100. qtiming-0.1.0/src/qtiming/oblig/model.py +76 -0
  101. qtiming-0.1.0/src/qtiming/py.typed +0 -0
  102. qtiming-0.1.0/src/qtiming/qiskit_pass/__init__.py +7 -0
  103. qtiming-0.1.0/src/qtiming/qiskit_pass/_common.py +21 -0
  104. qtiming-0.1.0/src/qtiming/qiskit_pass/equalize.py +171 -0
  105. qtiming-0.1.0/src/qtiming/qiskit_pass/plugin.py +23 -0
  106. qtiming-0.1.0/src/qtiming/qiskit_pass/strip.py +42 -0
  107. qtiming-0.1.0/src/qtiming/qiskit_pass/timing_check.py +40 -0
  108. qtiming-0.1.0/src/qtiming/repair/__init__.py +0 -0
  109. qtiming-0.1.0/src/qtiming/repair/suggest.py +146 -0
  110. qtiming-0.1.0/src/qtiming/solve/__init__.py +0 -0
  111. qtiming-0.1.0/src/qtiming/solve/concrete.py +148 -0
  112. qtiming-0.1.0/src/qtiming/solve/dispatcher.py +55 -0
  113. qtiming-0.1.0/src/qtiming/solve/interval.py +185 -0
  114. qtiming-0.1.0/src/qtiming/solve/smt.py +167 -0
  115. qtiming-0.1.0/src/qtiming/solve/smt_o5.py +1 -0
  116. qtiming-0.1.0/src/qtiming/solve/synth/__init__.py +0 -0
  117. qtiming-0.1.0/src/qtiming/solve/synth/bruteforce_dc.py +156 -0
  118. qtiming-0.1.0/src/qtiming/solve/synth/model.py +59 -0
  119. qtiming-0.1.0/src/qtiming/solve/synth/relax.py +93 -0
  120. qtiming-0.1.0/src/qtiming/solve/synth/rigid.py +33 -0
  121. qtiming-0.1.0/src/qtiming/solve/synth/sc.py +55 -0
  122. qtiming-0.1.0/src/qtiming/solve/synth/stn.py +74 -0
  123. qtiming-0.1.0/src/qtiming/solve/synth/stnu_dc.py +93 -0
  124. qtiming-0.1.0/src/qtiming/verdict/__init__.py +0 -0
  125. qtiming-0.1.0/src/qtiming/verdict/minimise.py +45 -0
  126. qtiming-0.1.0/src/qtiming/verdict/model.py +107 -0
  127. qtiming-0.1.0/src/qtiming/verdict/render.py +72 -0
  128. qtiming-0.1.0/src/qtiming/verdict/render_html.py +80 -0
  129. qtiming-0.1.0/src/qtiming/verdict/render_json.py +12 -0
  130. qtiming-0.1.0/src/qtiming/verdict/render_sarif.py +104 -0
  131. qtiming-0.1.0/src/qtiming/verdict/replay.py +77 -0
  132. qtiming-0.1.0/src/qtiming/verdict/run.py +174 -0
  133. qtiming-0.1.0/src/qtiming/verdict/rus.py +53 -0
  134. qtiming-0.1.0/tests/differential/test_graph_vs_executor.py +184 -0
  135. qtiming-0.1.0/tests/differential/test_window_vs_whole.py +70 -0
  136. qtiming-0.1.0/tests/fixtures/evidence/conclusive/ff1.json +38 -0
  137. qtiming-0.1.0/tests/fixtures/evidence/conclusive/ff2.json +38 -0
  138. qtiming-0.1.0/tests/fixtures/evidence/conclusive/pad1.json +52 -0
  139. qtiming-0.1.0/tests/fixtures/evidence/conclusive/pad2.json +52 -0
  140. qtiming-0.1.0/tests/fixtures/evidence/inconclusive/ff1.json +38 -0
  141. qtiming-0.1.0/tests/fixtures/evidence/inconclusive/pad1.json +52 -0
  142. qtiming-0.1.0/tests/fixtures/evidence/inconclusive/restart1.json +43 -0
  143. qtiming-0.1.0/tests/fixtures/free_stn_false_proof.py +36 -0
  144. qtiming-0.1.0/tests/fixtures/sarif-schema-2.1.0.json +3389 -0
  145. qtiming-0.1.0/tests/golden/frontend/test_frontends_agree.py +158 -0
  146. qtiming-0.1.0/tests/golden/reports/snapshots/tp_basic_ibm.json +168 -0
  147. qtiming-0.1.0/tests/golden/reports/snapshots/tp_basic_ibm.sarif +85 -0
  148. qtiming-0.1.0/tests/golden/reports/snapshots/tp_basic_ibm.txt +8 -0
  149. qtiming-0.1.0/tests/golden/reports/snapshots/tp_sync_ibm.json +142 -0
  150. qtiming-0.1.0/tests/golden/reports/snapshots/tp_sync_ibm.sarif +128 -0
  151. qtiming-0.1.0/tests/golden/reports/snapshots/tp_sync_ibm.txt +17 -0
  152. qtiming-0.1.0/tests/golden/reports/test_reports_golden.py +38 -0
  153. qtiming-0.1.0/tests/personality/_support.py +135 -0
  154. qtiming-0.1.0/tests/personality/artiq/golden/01_pulse_sequence.json +74 -0
  155. qtiming-0.1.0/tests/personality/artiq/golden/02_underflow.json +70 -0
  156. qtiming-0.1.0/tests/personality/artiq/golden/03_input_read_negative_slack.json +77 -0
  157. qtiming-0.1.0/tests/personality/artiq/golden/04_delay_restores_slack.json +78 -0
  158. qtiming-0.1.0/tests/personality/artiq/golden/05_kernel_if_then.json +100 -0
  159. qtiming-0.1.0/tests/personality/artiq/golden/06_kernel_if_else.json +99 -0
  160. qtiming-0.1.0/tests/personality/artiq/golden/07_collision_drop.json +79 -0
  161. qtiming-0.1.0/tests/personality/ibm/golden/01_gate_chain.json +52 -0
  162. qtiming-0.1.0/tests/personality/ibm/golden/02_two_qubit_waits_for_both.json +51 -0
  163. qtiming-0.1.0/tests/personality/ibm/golden/03_measure_feedforward.json +41 -0
  164. qtiming-0.1.0/tests/personality/ibm/golden/04_if_pad_then_taken.json +70 -0
  165. qtiming-0.1.0/tests/personality/ibm/golden/05_if_pad_else_taken.json +70 -0
  166. qtiming-0.1.0/tests/personality/ibm/golden/06_if_restart_at_join.json +70 -0
  167. qtiming-0.1.0/tests/personality/ibm/golden/07_block_waits_for_busy_arm_resource.json +78 -0
  168. qtiming-0.1.0/tests/personality/ibm/golden/08_eq_elaborated_is_latency_independent.json +87 -0
  169. qtiming-0.1.0/tests/personality/q1/golden/01_straight_line.json +63 -0
  170. qtiming-0.1.0/tests/personality/q1/golden/02_underflow_halt.json +78 -0
  171. qtiming-0.1.0/tests/personality/q1/golden/03_stale_read.json +75 -0
  172. qtiming-0.1.0/tests/personality/q1/golden/04_wait_covers_latency.json +76 -0
  173. qtiming-0.1.0/tests/personality/q1/golden/05_skipped_arm_then_taken.json +108 -0
  174. qtiming-0.1.0/tests/personality/q1/golden/06_skipped_arm_else_taken.json +108 -0
  175. qtiming-0.1.0/tests/personality/q1/golden/07_queue_back_pressure.json +81 -0
  176. qtiming-0.1.0/tests/personality/qua/golden/01_deterministic_align.json +89 -0
  177. qtiming-0.1.0/tests/personality/qua/golden/02_measure_valid.json +58 -0
  178. qtiming-0.1.0/tests/personality/qua/golden/03_if_then_nondeterministic_align.json +98 -0
  179. qtiming-0.1.0/tests/personality/qua/golden/04_implicit_align_after_dynamic.json +113 -0
  180. qtiming-0.1.0/tests/personality/qua/golden/05_skip_implicit_align_per_element.json +99 -0
  181. qtiming-0.1.0/tests/personality/qua/golden/06_implicit_align_all_elements.json +95 -0
  182. qtiming-0.1.0/tests/personality/qua/golden/07_single_conditional_play_stays_deterministic.json +86 -0
  183. qtiming-0.1.0/tests/personality/qua/golden/08_single_conditional_play_taken.json +86 -0
  184. qtiming-0.1.0/tests/personality/test_executor.py +41 -0
  185. qtiming-0.1.0/tests/personality/test_graph_goldens.py +27 -0
  186. qtiming-0.1.0/tests/personality/test_oracles.py +70 -0
  187. qtiming-0.1.0/tests/property/test_soundness.py +107 -0
  188. qtiming-0.1.0/tests/property/test_tier_properties.py +94 -0
  189. qtiming-0.1.0/tests/property/test_vertex_lemma.py +83 -0
  190. qtiming-0.1.0/tests/release/test_wheel_contents.py +38 -0
  191. qtiming-0.1.0/tests/unit/bench/test_bench.py +30 -0
  192. qtiming-0.1.0/tests/unit/bench/test_families.py +115 -0
  193. qtiming-0.1.0/tests/unit/cli/test_check.py +97 -0
  194. qtiming-0.1.0/tests/unit/cli/test_exit_codes.py +43 -0
  195. qtiming-0.1.0/tests/unit/cli/test_reports_and_cli.py +148 -0
  196. qtiming-0.1.0/tests/unit/contract/test_compat.py +39 -0
  197. qtiming-0.1.0/tests/unit/contract/test_instances.py +73 -0
  198. qtiming-0.1.0/tests/unit/contract/test_loader.py +251 -0
  199. qtiming-0.1.0/tests/unit/core/test_ast_errors_ids.py +88 -0
  200. qtiming-0.1.0/tests/unit/core/test_labels.py +63 -0
  201. qtiming-0.1.0/tests/unit/core/test_provenance.py +54 -0
  202. qtiming-0.1.0/tests/unit/core/test_time.py +89 -0
  203. qtiming-0.1.0/tests/unit/elab/test_elab.py +158 -0
  204. qtiming-0.1.0/tests/unit/elab/test_while_remeasure.py +110 -0
  205. qtiming-0.1.0/tests/unit/evidence/test_collector_safeguard.py +63 -0
  206. qtiming-0.1.0/tests/unit/evidence/test_evidence_ingest.py +123 -0
  207. qtiming-0.1.0/tests/unit/frontend/test_annotations.py +104 -0
  208. qtiming-0.1.0/tests/unit/frontend/test_lint.py +105 -0
  209. qtiming-0.1.0/tests/unit/frontend/test_payload.py +83 -0
  210. qtiming-0.1.0/tests/unit/frontend/test_qasm3_fe.py +60 -0
  211. qtiming-0.1.0/tests/unit/frontend/test_qiskit_fe.py +358 -0
  212. qtiming-0.1.0/tests/unit/frontend/test_stretch.py +46 -0
  213. qtiming-0.1.0/tests/unit/graph/test_invariants.py +47 -0
  214. qtiming-0.1.0/tests/unit/graph/test_window.py +122 -0
  215. qtiming-0.1.0/tests/unit/qiskit_pass/test_passes.py +93 -0
  216. qtiming-0.1.0/tests/unit/qiskit_pass/test_strip.py +74 -0
  217. qtiming-0.1.0/tests/unit/repair/test_suggest.py +62 -0
  218. qtiming-0.1.0/tests/unit/solve/synth/test_synth_dc.py +81 -0
  219. qtiming-0.1.0/tests/unit/solve/synth/test_synth_relax.py +92 -0
  220. qtiming-0.1.0/tests/unit/solve/synth/test_synth_sc.py +84 -0
  221. qtiming-0.1.0/tests/unit/solve/synth/test_synth_stn.py +48 -0
  222. qtiming-0.1.0/tests/unit/solve/test_appendix_a.py +85 -0
  223. qtiming-0.1.0/tests/unit/solve/test_smt.py +93 -0
  224. qtiming-0.1.0/tests/unit/solve/test_tier1_snap.py +40 -0
  225. qtiming-0.1.0/tests/unit/theory/test_theorem_index.py +58 -0
  226. qtiming-0.1.0/tests/unit/verdict/test_rus.py +52 -0
@@ -0,0 +1,18 @@
1
+ *.pyc
2
+ __pycache__/
3
+ .venv/
4
+ .pytest_cache/
5
+ .mypy_cache/
6
+ .ruff_cache/
7
+ .hypothesis/
8
+ *.egg-info/
9
+ dist/
10
+ build/
11
+ .coverage
12
+ results/
13
+ .superpowers/
14
+ graphify-out/
15
+ .playwright-mcp/
16
+ .import_linter_cache/
17
+ _site/
18
+ site/
@@ -0,0 +1,57 @@
1
+ # Changelog
2
+
3
+ All notable changes are listed here. Format: [Keep a Changelog](https://keepachangelog.com/en/1.1.0/).
4
+
5
+ ## [0.1.0] - 2026-11-20 (first public alpha)
6
+
7
+ Phases P0 to P9 are committed (`git log`). P10 to P14 are present in the working tree but were not
8
+ committed when this entry was written; check `git log` before quoting them as released.
9
+
10
+ ### Added
11
+ - P0, P1: repository skeleton, tooling (ruff, mypy --strict on `core`, import-linter layering), the
12
+ `core` data model (AST, exact time arithmetic, labels, provenance, errors).
13
+ - P2: timing contracts (pydantic schema, TOML loader, `--assume` overrides, compatibility table), four
14
+ shipped instances (`ibm_heron`, `q1`, `artiq`, `qua`), `qtiming contract validate`.
15
+ - P3: front end: `timing.*` annotations with QASM 3 and QPY round trip, Qiskit circuit to AST,
16
+ OpenQASM 3 parser, `stretch` resolution, IBM front-end lint.
17
+ - P4, P5: normative personality specs with hand-computed goldens; independent reference executor
18
+ for IBM, Q1, ARTIQ and QUA with fixed/random/extreme oracles and exhaustive exploration.
19
+ - P6: elaboration (EQ, SYNC, EXP policies, loop unrolling), timed event graph and per-personality
20
+ dispatch rules; graph-versus-executor differential (1000 random programs per personality and policy).
21
+ - P7, P8: obligations O1 to O5 and O7; Tier 0 (exact), Tier 1 (interval, proves only) and Tier 2 (Z3,
22
+ optional) solvers; verdict lattice; `qtiming check`; exact rational counterexamples, minimisation
23
+ and replay in the executor (`I-REPLAY-MISMATCH` on disagreement).
24
+ - P9: reports (text, JSON, SARIF 2.1.0, static HTML timeline), `explain`, `lint`, `replay`,
25
+ `contract show|diff`, RUS formulas, teleportation benchmark family, report goldens.
26
+ - P10 to P14 (uncommitted at time of writing): windowing of long loops (IBM only), controllability
27
+ synthesis modules and `qtiming repair` (O1 only), Qiskit passes (`strip`, equalise, timing check) and the
28
+ `qiskit.transpiler.scheduling` plugin, `qtiming-bench` and 56 benchmark programs in 8 families,
29
+ IBM dry-run evidence tooling (`qtiming evidence ingest|report`).
30
+ - P16: README, this changelog, mkdocs site, artifact Dockerfile and `smoke.sh`, release and docs workflows.
31
+
32
+ ### Fixed (packaging, found while preparing the release)
33
+ - `tomli` is now a dependency on Python 3.10 (the contract loader imports it there).
34
+ - The `qiskit` extra now installs `openqasm3[parser]` and `qiskit-qasm3-import`; without them
35
+ `qtiming check` failed with "Parsing is not available" in a clean install.
36
+ - Removed unused `networkx`, `pandas` and `pyyaml` from the `synth` and `bench` extras.
37
+
38
+ ### Fixed (checker, found while building P13 to P15)
39
+ - Elaboration: a capped `while` whose body re-measures the bit it tests unrolled into iterations that all
40
+ tested the stale pre-loop measurement (contradictory nested arms, `AssertionError`). Iteration j+1 now
41
+ reads the bit's latest measurement.
42
+ - QUA: a join over an empty qubit set (an empty final loop arm) had a label and no in-edge
43
+ (`E-GRAPH-LABEL`). The graph now matches the reference executor on those events.
44
+ - Tier 1 soundness: a snapped node downstream of an unbounded latency was dropped from the forms and an
45
+ obligation about it was reported PROVED ("vacuous"). It now stays unproved. No shipped builder emits
46
+ snap nodes, so the pipeline was not exposed, but the solver was unsound on such graphs.
47
+
48
+ ### Known issues
49
+ - The DC checker (`solve/synth/stnu_dc.py`) is flagged UNVERIFIED: rules transcribed from memory, not yet
50
+ validated against the paper or the 621-network oracle suite. Not used for verdicts.
51
+ - No real IBM hardware evidence exists; the evidence fixtures are synthetic.
52
+ - Theory status (`Docs/theory/index.md`): T5 holds only for non-negative weights, bounded latencies and
53
+ Diff obligations; T3 does not hold for QUA; T4 is one-directional and windows IBM only.
54
+ - IBM gate durations come from an unofficial snapshot and the IBM feed-forward latency is a vendor
55
+ claim; unpublished numbers are left absent, so dependent obligations are UNKNOWN.
56
+ - Not built: O4a, O6, O8, O9, O5 symbolic encoding, RUS wiring into `check`; `repair` handles O1 only.
57
+ - There is no `qtiming synth` command yet; the Tier 3 algorithms are library code used by `repair`.
@@ -0,0 +1,12 @@
1
+ cff-version: 1.2.0
2
+ message: "If you use qtiming, please cite it as below."
3
+ title: "qtiming: a static timing checker for dynamic quantum circuits"
4
+ type: software
5
+ license: Apache-2.0
6
+ version: 0.1.0
7
+ date-released: 2026-11-20
8
+ authors:
9
+ - family-names: "Deshpande"
10
+ given-names: "Pratul"
11
+ repository-code: "https://github.com/PratulDeshpande/QTiming"
12
+ url: "https://github.com/PratulDeshpande/QTiming"
@@ -0,0 +1,16 @@
1
+ # Contributing
2
+
3
+ Setup: `python -m venv .venv && .venv/Scripts/pip install -e ".[dev]"`
4
+
5
+ Gate (must be green before a PR):
6
+
7
+ ruff check . && mypy --strict src/qtiming/core && lint-imports && pytest -q
8
+
9
+ Rules: tests first (a test must fail before the code that fixes it); `core/` imports only the
10
+ standard library; `exec/` never imports the graph/solver side (see `.importlinter`).
11
+ Behaviour changes to a personality go through the decision log in the implementation plan.
12
+
13
+ Release checks (maintainers): `python -m build --outdir <scratch>` then `twine check <scratch>/*`;
14
+ install the wheel in a clean venv with `[qiskit,z3]` and run `qtiming contract validate` plus one
15
+ `qtiming check`; `mkdocs build --strict`; `bash artifact/smoke.sh`. `tests/release` pins the data
16
+ files that must ship in the wheel.