raptor-studio 0.8.0__tar.gz

raptor_studio-0.8.0/LICENSE

@@ -0,0 +1,49 @@
+## Booz Allen Public License v1.0 
+
+
+### INTRODUCTION
+The Booz Allen Public License allows government, non-profit academic, other non-profit, and commercial entities access to distinctive, disruptive, and robust code with the goal of Empowering People to Change the World℠. Products licensed under the Booz Allen Public License are founded on the basis that collective ingenuity can make the largest impact in the community. 
+
+### DEFINITIONS
+* **Commercial Entity.** “Commercial Entity” means any individual or entity other than a government, non-profit academic, or other non-profit entity.
+* **Derivative.** “Derivative” means any work of authorship in Source Code or Object Code form that results from an addition to, deletion from, or modification of the Source Code of the Product.
+* **License.**  “License” means this Booz Allen Public License.
+* **Object Code.** “Object Code” means the form resulting from transformation or translation of Source Code into machine readable code, including but not limited to, compiled object code.
+* **Originator.** “Originator” means each individual or legal entity that creates, contributes to the creation of, or owns the Product. 
+* **Patent Claims.** “Patent Claims” means any patent claim(s) in any patent to which Originator has a right to grant a license that would be infringed by Your making, using, selling, offering for sale, having made, or importing of the Product, but for the grant of this License. 
+* **Product.** “Product” means the Source Code of the software which the initial Originator made available under this License, and any Derivative of such Source Code. 
+* **Source Code.** “Source Code” means software in human-readable form.
+* **You.** “You” means either an individual or an entity (if you are taking this license on behalf of an entity) that exercises the rights granted under this License.  
+  
+### LICENSE
+**Government/Non-Profit Academic/Other Non-Profit.**  
+This Section applies if You are not a Commercial Entity.  
+
+* **License.** Subject to the terms and conditions of this License, each Originator hereby grants You a perpetual, worldwide, non-exclusive, royalty-free license to reproduce, display, perform, modify, distribute and otherwise use the Product and Derivatives, in Source Code and Object Code form, in accordance with the terms and conditions of this License in order to support the general public good and for your internal business purposes.
+* **Distribution.** You may distribute to third parties copies of the Product, including any Derivative that You create, in Source Code or Object Code form.  If You distribute copies of the Product, including any Derivative that You create, in Source Code form, such distribution must be under the terms of this License and You must inform recipients of the Source Code that the Product is governed under this License and how they can obtain a copy of this License.  You may distribute to third parties copies of the Product, including any Derivative that You create, in Object Code form, or allow third parties to access or use the Product, including any Derivative that You create, under a license of Your choice.
+* **Commercial Sales.** You may not distribute, or allow third parties to access or use, the Product or any Derivative for a fee, unless You first obtain permission from the Originator. If Booz Allen Hamilton is the Originator, please contact Booz Allen Hamilton at  <opensource@bah.com>.  
+
+**Commercial Entities**.  
+This Section applies if You are a Commercial Entity.
+
+* **License.** Subject to the terms and conditions of this License, each Originator hereby grants You a perpetual, worldwide, non-exclusive, royalty-free license to reproduce, display, perform, modify, distribute and otherwise use the Product and Derivatives, in Source Code and Object Code form, in accordance with the terms and conditions of this License for the sole purpose of Your internal business purposes and the provision of services to government, non-profit academic, and other non-profit entities. 
+* **Distribution and Derivatives.** You may distribute to third parties copies of the Product, including any Derivative that You create, in Source Code or Object Code form.  If You distribute copies of the Product, including any Derivative that You create, in Source Code form, such distribution must be under the terms of this License and You must inform recipients of the Source Code that the Product is governed under this License and how they can obtain a copy of this License.  You may distribute to third parties copies of the Product, including any Derivative that You create, in Object Code form, or allow third parties to access or use the Product, including any Derivative that You create, under a license of Your choice, provided that You make available, and inform the recipient of such distribution how they can obtain, a copy of the Source Code thereof, at no charge, and inform the recipient of the Source Code that the Product is governed under this License and how they can obtain a copy of this License.
+* **Commercial Sales.** You may not distribute, or allow third parties to access or use, the Product or any Derivative for a fee, unless You first obtain permission from the Originator. If Booz Allen Hamilton, please contact Booz Allen Hamilton at <opensource@bah.com>.   
+
+ 
+**Patent Claim(s)**.  
+This Section applies regardless of whether You are a government, non-profit academic, or other non-profit entity or a Commercial Entity. 
+
+* **Patent License.** Subject to the limitations in the Sections above, each Originator hereby grants You a perpetual, worldwide, non-exclusive, royalty-free license under Patent Claims of such Originator to make, use, sell, offer for sale, have made, and import the Product.  The foregoing patent license does not apply (a) to any code that an Originator has removed from the Product, or (b) for infringement caused by Your modifications of the Product or the combination of any Derivative created by You or on Your behalf with other software.      
+
+### GENERAL TERMS 
+This Section applies regardless of whether You are a government, non-profit academic, or other non-profit entity or a Commercial Entity.
+
+* **Required Notices.** If You distribute the Product or a Derivative, in Object Code or Source Code form, You shall not remove or otherwise modify any proprietary markings or notices contained within or placed upon the Product or any Derivative. Any distribution of the Product or a Derivative, in Object Code or Source Code form, shall contain a clear and conspicuous Originator copyright and license reference in accordance with the below:
+	* *Unmodified Product Notice*: “This software package is licensed under the Booz Allen Public License. Copyright © 20__ [Copyright Holder Name].  All Rights Reserved.”
+	* *Derivative Notice*: “This software package is licensed under the Booz Allen Public License. Portions of this code are Copyright © 20__ [Copyright Holder Name].  All Rights Reserved.”
+* **Compliance with Laws.** You agree that You shall not reproduce, display, perform, modify, distribute and otherwise use the Product in any way that violates applicable law or regulation or infringes or violates the rights of others, including, but not limited to, third party intellectual property, privacy, and publicity rights.
+* **Disclaimer.** You understand that the Product is licensed to You, and not sold. The Product is provided on an “As Is” basis, without any warranties, representations, and guarantees, whether oral or written, express, implied or statutory, with regard to the Product, including without limitation, warranties of merchantability, fitness for a particular purpose, title, non-infringement, non-interference, and warranties arising from course of dealing or usage of trade, to the maximum extent permitted by applicable law.  Originator does not warrant that (i) the Product will meet your needs; (ii) the Product will be error-free or accessible at all times; or (iii) the use or the results of the use of the Product will be correct, accurate, timely, or otherwise reliable. You acknowledge that the Product has not been prepared to meet Your individual requirements, whether or not such requirements have been communicated to Originator. You assume all responsibility for use of the Product.
+* **Limitation of Liability.** Under no circumstances and under no legal theory, whether tort (including negligence), contract, or otherwise, shall any Originator, or anyone who distributes the Product in accordance with this License, be liable to You for any direct, indirect, special, incidental, or consequential damages of any character including, without limitation, damages for lost profits, loss of goodwill, work stoppage, computer failure or malfunction, or any and all other commercial damages or losses, even if informed of the possibility of such damages.
+* **Severability.** If the application of any provision of this License to any particular facts or circumstances shall be held to be invalid or unenforceable, then the validity and enforceability of other provisions of this License shall not in any way be affected or impaired thereby.  
+

raptor_studio-0.8.0/LICENSES/Apache-2.0.txt

@@ -0,0 +1,201 @@
+                                 Apache License
+                           Version 2.0, January 2004
+                        http://www.apache.org/licenses/
+
+   TERMS AND CONDITIONS FOR USE, REPRODUCTION, AND DISTRIBUTION
+
+   1. Definitions.
+
+      "License" shall mean the terms and conditions for use, reproduction,
+      and distribution as defined by Sections 1 through 9 of this document.
+
+      "Licensor" shall mean the copyright owner or entity authorized by
+      the copyright owner that is granting the License.
+
+      "Legal Entity" shall mean the union of the acting entity and all
+      other entities that control, are controlled by, or are under common
+      control with that entity. For the purposes of this definition,
+      "control" means (i) the power, direct or indirect, to cause the
+      direction or management of such entity, whether by contract or
+      otherwise, or (ii) ownership of fifty percent (50%) or more of the
+      outstanding shares, or (iii) beneficial ownership of such entity.
+
+      "You" (or "Your") shall mean an individual or Legal Entity
+      exercising permissions granted by this License.
+
+      "Source" form shall mean the preferred form for making modifications,
+      including but not limited to software source code, documentation
+      source, and configuration files.
+
+      "Object" form shall mean any form resulting from mechanical
+      transformation or translation of a Source form, including but
+      not limited to compiled object code, generated documentation,
+      and conversions to other media types.
+
+      "Work" shall mean the work of authorship, whether in Source or
+      Object form, made available under the License, as indicated by a
+      copyright notice that is included in or attached to the work
+      (an example is provided in the Appendix below).
+
+      "Derivative Works" shall mean any work, whether in Source or Object
+      form, that is based on (or derived from) the Work and for which the
+      editorial revisions, annotations, elaborations, or other modifications
+      represent, as a whole, an original work of authorship. For the purposes
+      of this License, Derivative Works shall not include works that remain
+      separable from, or merely link (or bind by name) to the interfaces of,
+      the Work and Derivative Works thereof.
+
+      "Contribution" shall mean any work of authorship, including
+      the original version of the Work and any modifications or additions
+      to that Work or Derivative Works thereof, that is intentionally
+      submitted to Licensor for inclusion in the Work by the copyright owner
+      or by an individual or Legal Entity authorized to submit on behalf of
+      the copyright owner. For the purposes of this definition, "submitted"
+      means any form of electronic, verbal, or written communication sent
+      to the Licensor or its representatives, including but not limited to
+      communication on electronic mailing lists, source code control systems,
+      and issue tracking systems that are managed by, or on behalf of, the
+      Licensor for the purpose of discussing and improving the Work, but
+      excluding communication that is conspicuously marked or otherwise
+      designated in writing by the copyright owner as "Not a Contribution."
+
+      "Contributor" shall mean Licensor and any individual or Legal Entity
+      on behalf of whom a Contribution has been received by Licensor and
+      subsequently incorporated within the Work.
+
+   2. Grant of Copyright License. Subject to the terms and conditions of
+      this License, each Contributor hereby grants to You a perpetual,
+      worldwide, non-exclusive, no-charge, royalty-free, irrevocable
+      copyright license to reproduce, prepare Derivative Works of,
+      publicly display, publicly perform, sublicense, and distribute the
+      Work and such Derivative Works in Source or Object form.
+
+   3. Grant of Patent License. Subject to the terms and conditions of
+      this License, each Contributor hereby grants to You a perpetual,
+      worldwide, non-exclusive, no-charge, royalty-free, irrevocable
+      (except as stated in this section) patent license to make, have made,
+      use, offer to sell, sell, import, and otherwise transfer the Work,
+      where such license applies only to those patent claims licensable
+      by such Contributor that are necessarily infringed by their
+      Contribution(s) alone or by combination of their Contribution(s)
+      with the Work to which such Contribution(s) was submitted. If You
+      institute patent litigation against any entity (including a
+      cross-claim or counterclaim in a lawsuit) alleging that the Work
+      or a Contribution incorporated within the Work constitutes direct
+      or contributory patent infringement, then any patent licenses
+      granted to You under this License for that Work shall terminate
+      as of the date such litigation is filed.
+
+   4. Redistribution. You may reproduce and distribute copies of the
+      Work or Derivative Works thereof in any medium, with or without
+      modifications, and in Source or Object form, provided that You
+      meet the following conditions:
+
+      (a) You must give any other recipients of the Work or
+          Derivative Works a copy of this License; and
+
+      (b) You must cause any modified files to carry prominent notices
+          stating that You changed the files; and
+
+      (c) You must retain, in the Source form of any Derivative Works
+          that You distribute, all copyright, patent, trademark, and
+          attribution notices from the Source form of the Work,
+          excluding those notices that do not pertain to any part of
+          the Derivative Works; and
+
+      (d) If the Work includes a "NOTICE" text file as part of its
+          distribution, then any Derivative Works that You distribute must
+          include a readable copy of the attribution notices contained
+          within such NOTICE file, excluding those notices that do not
+          pertain to any part of the Derivative Works, in at least one
+          of the following places: within a NOTICE text file distributed
+          as part of the Derivative Works; within the Source form or
+          documentation, if provided along with the Derivative Works; or,
+          within a display generated by the Derivative Works, if and
+          wherever such third-party notices normally appear. The contents
+          of the NOTICE file are for informational purposes only and
+          do not modify the License. You may add Your own attribution
+          notices within Derivative Works that You distribute, alongside
+          or as an addendum to the NOTICE text from the Work, provided
+          that such additional attribution notices cannot be construed
+          as modifying the License.
+
+      You may add Your own copyright statement to Your modifications and
+      may provide additional or different license terms and conditions
+      for use, reproduction, or distribution of Your modifications, or
+      for any such Derivative Works as a whole, provided Your use,
+      reproduction, and distribution of the Work otherwise complies with
+      the conditions stated in this License.
+
+   5. Submission of Contributions. Unless You explicitly state otherwise,
+      any Contribution intentionally submitted for inclusion in the Work
+      by You to the Licensor shall be under the terms and conditions of
+      this License, without any additional terms or conditions.
+      Notwithstanding the above, nothing herein shall supersede or modify
+      the terms of any separate license agreement you may have executed
+      with Licensor regarding such Contributions.
+
+   6. Trademarks. This License does not grant permission to use the trade
+      names, trademarks, service marks, or product names of the Licensor,
+      except as required for reasonable and customary use in describing the
+      origin of the Work and reproducing the content of the NOTICE file.
+
+   7. Disclaimer of Warranty. Unless required by applicable law or
+      agreed to in writing, Licensor provides the Work (and each
+      Contributor provides its Contributions) on an "AS IS" BASIS,
+      WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or
+      implied, including, without limitation, any warranties or conditions
+      of TITLE, NON-INFRINGEMENT, MERCHANTABILITY, or FITNESS FOR A
+      PARTICULAR PURPOSE. You are solely responsible for determining the
+      appropriateness of using or redistributing the Work and assume any
+      risks associated with Your exercise of permissions under this License.
+
+   8. Limitation of Liability. In no event and under no legal theory,
+      whether in tort (including negligence), contract, or otherwise,
+      unless required by applicable law (such as deliberate and grossly
+      negligent acts) or agreed to in writing, shall any Contributor be
+      liable to You for damages, including any direct, indirect, special,
+      incidental, or consequential damages of any character arising as a
+      result of this License or out of the use or inability to use the
+      Work (including but not limited to damages for loss of goodwill,
+      work stoppage, computer failure or malfunction, or any and all
+      other commercial damages or losses), even if such Contributor
+      has been advised of the possibility of such damages.
+
+   9. Accepting Warranty or Additional Liability. While redistributing
+      the Work or Derivative Works thereof, You may choose to offer,
+      and charge a fee for, acceptance of support, warranty, indemnity,
+      or other liability obligations and/or rights consistent with this
+      License. However, in accepting such obligations, You may act only
+      on Your own behalf and on Your sole responsibility, not on behalf
+      of any other Contributor, and only if You agree to indemnify,
+      defend, and hold each Contributor harmless for any liability
+      incurred by, or claims asserted against, such Contributor by reason
+      of your accepting any such warranty or additional liability.
+
+   END OF TERMS AND CONDITIONS
+
+   APPENDIX: How to apply the Apache License to your work.
+
+      To apply the Apache License to your work, attach the following
+      boilerplate notice, with the fields enclosed by brackets "[]"
+      replaced with your own identifying information. (Don't include
+      the brackets!)  The text should be enclosed in the appropriate
+      comment syntax for the file format. We also recommend that a
+      file or class name and description of purpose be included on the
+      same "printed page" as the copyright notice for easier
+      identification within third-party archives.
+
+   Copyright [yyyy] [name of copyright owner]
+
+   Licensed under the Apache License, Version 2.0 (the "License");
+   you may not use this file except in compliance with the License.
+   You may obtain a copy of the License at
+
+       http://www.apache.org/licenses/LICENSE-2.0
+
+   Unless required by applicable law or agreed to in writing, software
+   distributed under the License is distributed on an "AS IS" BASIS,
+   WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+   See the License for the specific language governing permissions and
+   limitations under the License.

raptor_studio-0.8.0/NOTICE.md

@@ -0,0 +1,38 @@
+# NOTICE
+
+This product, **RAPTOR Studio**, is a Python port of the
+RAPTOR reliability simulation tool (Raptor 7).
+
+## Original RAPTOR
+
+RAPTOR was originally created at **ARINC** by:
+
+- Chuck Carter
+- Steve Brown
+- Tony Malerich
+- Elizabeth Grimes
+
+The original source was later released as open source by
+**Booz Allen Hamilton** (https://github.com/boozallen/raptor) under the
+**Booz Allen Public License v1.0**. We gratefully thank Booz Allen
+Hamilton for making RAPTOR open source, without which this project
+would not exist. The original RAPTOR code and its documentation remain
+© ARINC and Booz Allen Hamilton; see `LICENSE` (Booz Allen Public
+License v1.0).
+
+## This port
+
+Copyright © 2026 OpenPowerShift. New code contributed to this project
+(the Python simulation engine, the RAPTOR Studio GUI, documentation and
+installers) is licensed under the **Apache License, Version 2.0**
+(see `LICENSES/Apache-2.0.txt`). As a derivative of the original RAPTOR
+product, this distribution as a whole remains subject to the Booz Allen
+Public License v1.0 for the portions derived from RAPTOR.
+
+Distribution of this software package must carry a clear and
+conspicuous Originator copyright and license reference in accordance
+with the Booz Allen Public License's Required Notices, e.g.:
+
+> This software package is licensed under the Booz Allen Public
+> License. Portions of this code are Copyright © 2026 OpenPowerShift.
+> All Rights Reserved.

raptor_studio-0.8.0/PKG-INFO

@@ -0,0 +1,275 @@
+Metadata-Version: 2.4
+Name: raptor-studio
+Version: 0.8.0
+Summary: RAPTOR Studio — reliability block diagram simulation (open Python port of Raptor 7)
+Author: OpenPowerShift
+License-Expression: LicenseRef-BAPL-1.0 AND Apache-2.0
+Project-URL: Homepage, https://github.com/openpowershift/RaptorStudio
+Project-URL: Issues, https://github.com/openpowershift/RaptorStudio/issues
+Keywords: reliability,simulation,rbd,ram,raptor,monte-carlo
+Classifier: Development Status :: 4 - Beta
+Classifier: Environment :: X11 Applications :: Qt
+Classifier: Intended Audience :: Science/Research
+Classifier: Intended Audience :: Manufacturing
+Classifier: Operating System :: Microsoft :: Windows
+Classifier: Operating System :: MacOS
+Classifier: Operating System :: POSIX :: Linux
+Classifier: Programming Language :: Python :: 3 :: Only
+Classifier: Programming Language :: Python :: 3.12
+Classifier: Programming Language :: Python :: 3.13
+Classifier: Programming Language :: Python :: 3.14
+Classifier: Topic :: Scientific/Engineering
+Requires-Python: >=3.12
+Description-Content-Type: text/markdown
+License-File: LICENSE
+License-File: LICENSES/Apache-2.0.txt
+License-File: NOTICE.md
+License-File: THIRD_PARTY_NOTICES.md
+Requires-Dist: PySide6==6.11.1
+Requires-Dist: weasyprint>=61
+Provides-Extra: dev
+Requires-Dist: pytest; extra == "dev"
+Requires-Dist: pytest-cov; extra == "dev"
+Requires-Dist: pytest-xdist; extra == "dev"
+Requires-Dist: hypothesis; extra == "dev"
+Requires-Dist: pyinstaller>=6; extra == "dev"
+Requires-Dist: build; extra == "dev"
+Requires-Dist: ruff; extra == "dev"
+Requires-Dist: mypy; extra == "dev"
+Provides-Extra: mcp
+Requires-Dist: mcp<3,>=2.2; extra == "mcp"
+Requires-Dist: pydantic>=2; extra == "mcp"
+Dynamic: license-file
+
+# RAPTOR Studio
+
+An open-source reliability block diagram (RBD) simulator for Windows, macOS and Linux. Draw a diagram of parts that
+can fail and be repaired, run thousands of simulated futures, and read availability, reliability, maintenance,
+spares and cost numbers like an engineer, then find out **which part to spend money on**.
+
+![RAPTOR Studio: draw a system, simulate it, read the results (animated tour of the application)](https://raw.githubusercontent.com/openpowershift/RaptorStudio/main/docs/readme/app-tour.gif)
+
+RAPTOR Studio carries on from Raptor 7, the simulator written at ARINC and released as open source by Booz Allen
+Hamilton. Its simulation engine was ported from Raptor 7's own source and checked, event by event, against what Raptor 7
+itself writes, so the numbers are the ones reliability engineers already trust. Models made in Raptor 7 open here.
+Around that engine is a new application, a command line, and an AI-assistant server.
+
+Like Raptor 7, it is released under the Booz Allen Public License (BAPL). Anyone may use, modify and share it, but a
+commercial entity may use it only for its internal business and for services to government and non-profit
+organisations, and nobody may charge a fee for it without Booz Allen Hamilton's permission. See
+[Licence & credits](#licence--credits).
+
+## Why use it
+
+- **Numbers you can rely on.** The detailed event logs and report files of hundreds of models captured from Raptor 7
+  are reproduced character for character, including its random-number generator. Where Raptor 7 does something
+  surprising, the port reproduces it and says so.
+- **It tells you what to fix, not just how you are doing.** Weak-link analysis, single-point-failure lists and
+  **importance measures** (Birnbaum, RAW, RRW and Vesely–Fussell, see below) rank the parts of your system by how much
+  they matter, and colour the diagram to match.
+- **Built for speed.** Runs split across your processor cores, and the engine, layout, validation and file loading
+  have been tuned so that models with hundreds or thousands of blocks are practical to build, open and run. We expect
+  it to be faster than Raptor 7 on most models, particularly large ones and batches on several cores. `raptor estimate`
+  times a few runs and tells you how long a full batch will take before you start it.
+- **Runs anywhere.** One installer or `pip install`, on Windows, macOS and Linux.
+- **Scriptable.** Everything the application does is also a command (`raptor run`, `sweep`, `compare`, `diff`,
+  `estimate`, `validate`, `spf`, `fev`, `step`, `extract`, `render` and more) with machine-readable results. It fits in
+  a continuous-integration job, a Jupyter notebook or a shell loop.
+- **Usable from an AI assistant.** An MCP server with **64 tools** lets an assistant build, edit, validate, simulate,
+  compare and explain models, run long batches in the background, and draw the diagram. The
+  [MCP server reference](https://github.com/openpowershift/RaptorStudio/blob/main/docs/MCP.md) covers install, client
+  setup and every tool, resource and prompt. The recording below is a real run of those tools (the numbers are the
+  engine's; the assistant's narration is scripted):
+
+  ![An assistant builds a cooling-loop model, simulates it, lists its single points of failure and sweeps a parameter through the MCP server](https://raw.githubusercontent.com/openpowershift/RaptorStudio/main/docs/readme/mcp-demo.gif)
+
+- **A model file you can read and diff.** `.rbds` is one JSON document with friendly field names, and `raptor diff`
+  (or **File ▸ Differences**) says in words what changed between two versions of a model. `.rbd` files open and save
+  exactly as before.
+- **Documentation that ships with it.** _Break It Before It Breaks_, a 23-chapter tutorial book with a model for each
+  chapter that opens from the page, a field-by-field reference manual, and a formulas page. **F1** opens the right
+  section.
+
+## Which part matters most? Importance measures
+
+Availability says how good the system is. Importance says **which block to improve**. Switch on **Run ▸ Analysis ▸
+Importance measures** (or `raptor run --importance both`, or `importance` on the MCP `simulate` tool) and RAPTOR Studio
+re-simulates the model with each block in turn made unable to fail, and with it dead, then ranks every block by how
+much the system moves. You get:
+
+- **Birnbaum**, **RAW** (risk achievement worth), **RRW** (risk reduction worth) and **Vesely–Fussell** importance, the
+  IEC 61078 Annex D measures, each with its sampling error so you can tell a real ranking from noise;
+- an **Importance** tab in the results, and a **Show on Canvas** colouring that paints the most influential blocks red
+  and badges each block with its rank;
+- an up-front time estimate that includes the extra batches, so a long analysis never surprises you.
+
+The equations are on the Formulas page, and the tutorial's weak-link chapter works through an example.
+
+## What is new compared with Raptor 7
+
+|                                      |                                                                                                                                                                                                                                  |
+| ------------------------------------ | -------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
+| **Importance measures**              | Rank blocks by Birnbaum, RAW, RRW and Vesely–Fussell importance, with sampling error, a results tab and a canvas overlay.                                                                                                        |
+| **Parallel batches**                 | Runs spread over your cores (`-j N` on the command line); results are reproducible for a given core count, and one core reproduces Raptor 7's own random sequence exactly.                                                        |
+| **Run-time estimate**                | Know how long a batch will take before you start it, in the app, on the command line and from an assistant.                                                                                                                      |
+| **Check part of a model**            | Run one hierarchy on its own, with its input assumed available, or save it as a standalone model (`raptor extract`). The results are labelled as isolated.                                                                      |
+| **Parameter sweeps and comparisons** | Vary any field over a list of values, or run two or more models side by side, from the application, the command line or an assistant. **Differences** shows what is different between two models, and runs nothing.              |
+| **AI assistant (MCP)**               | 64 tools to build, edit, run, analyse and explain models, over stdio or authenticated HTTP.                                                                                                                                      |
+| **Stepping debugger**                | Step a run event by event, pause on a condition, jump to the next run, and see what each step changed. Failure Effects View and the Single Point Failure file are also available headless.                                       |
+| **Several models at once**           | Each model opens in its own window with its own undo history and results.                                                                                                                                                         |
+| **Edit while looking at results**    | Results stay on screen while you edit; undo and redo for edits; spread-banded Weak Link, Cost, Capacity, Spares and Importance colourings.                                                                                       |
+| **Block labels and rates**           | Choose what the lines under each block show (mean, standard deviation, rate); keep the derivation of a failure rate in a named, reusable Rate.                                                                                   |
+| **Reports**                          | Results export as PDF, HTML, AsciiDoc, spreadsheet, CSV or JSON (a versioned schema).                                                                                                                                            |
+| **Diagram**                          | Light and dark themes, dockable panels, annotations, mini-map, key tips for every ribbon button, and a diagram renderer for documents (`raptor render`).                                                                          |
+| **Safer files**                      | Validation catches the model shapes that crash Raptor 7 on open (a node's declared path count, a stale phase header) before you save them.                                                                                       |
+
+## Install
+
+### Windows / macOS / Linux (recommended for non-technical users)
+
+Grab the installer for your platform from the
+[Releases page](https://github.com/openpowershift/RaptorStudio/releases):
+
+| File                                   | Platform                          | Install                                          |
+| -------------------------------------- | --------------------------------- | ------------------------------------------------ |
+| `raptor-studio-*-windows-setup.exe`    | Windows 10/11 (x64)               | Double-click, follow the wizard                  |
+| `raptor-studio-*-windows-portable.zip` | Windows 10/11 (x64)               | Unzip anywhere, run `raptor-studio.exe`          |
+| `raptor-studio-*-macos-arm64.dmg`      | macOS 13+ (Apple Silicon)         | Open the DMG, drag RAPTOR Studio to Applications |
+| `raptor-studio-*-macos-x64.dmg`        | macOS 13+ (Intel)                 | Open the DMG, drag RAPTOR Studio to Applications |
+| `raptor-studio-*-linux-amd64.deb`      | Debian/Ubuntu (x64)               | Double-click or `sudo apt install ./…deb`        |
+| `raptor-studio-*-linux-x86_64.AppImage` | Most Linux distros (x64)         | `chmod +x` the file, then run it                 |
+
+Verify the checksums against `SHA256SUMS.txt` in the same release. The installers carry the desktop application only;
+the `raptor` command line and the MCP server come with the pip package (below).
+
+**macOS note (unsigned build):** Gatekeeper will ask for confirmation.
+Right-click **RAPTOR Studio** → **Open** → **Open**, or run
+`xattr -cr "/Applications/RAPTOR Studio.app"` once in Terminal.
+
+**Windows note (unsigned build):** SmartScreen may show
+"Windows protected your PC" — click **More info** → **Run anyway**.
+
+### PyPI (technical users, and for the MCP server)
+
+```bash
+pip install raptor-studio              # the application and command line
+pip install "raptor-studio[mcp]"       # plus the MCP server for AI assistants
+```
+
+or, isolated from your system Python:
+
+```bash
+pipx install "raptor-studio[mcp]"
+```
+
+For the assistant server alone, `uvx raptor-studio-mcp --workspace ~/raptor-models` runs it without an install
+step.
+
+Then run `raptor-studio` for the application, `raptor --help` for the command line, or `raptor-studio-mcp` for the
+assistant server. Requirements: Python 3.12+. The PDF export uses WeasyPrint, which needs system Pango — Linux:
+`sudo apt install libpango-1.0-0 libpangocairo-1.0-0`, macOS: `brew install pango`. The Windows/macOS installers
+bundle it.
+
+## A first run from the command line
+
+```bash
+raptor validate model.rbd            # errors and warnings
+raptor run model.rbd -n 200 -j 4     # 200 runs on 4 processes, summary on screen
+raptor run model.rbd -n 500 --importance both   # also rank the blocks by importance
+raptor run model.rbd -r events -r end-of-run -o results/   # also write Raptor 7-format report files
+raptor sweep model.rbd --vary "block:Pump A.repair_params[0]=12,24,48" --metric Availability
+raptor diff before.rbds after.rbds   # what changed between two versions
+```
+
+`raptor help` lists every command and topic.
+
+## Learning materials
+
+The app opens on a start page with a blank model, worked examples (from the guide's basics to a hospital's
+emergency power, a water-treatment works, a data centre and a phased airliner flight) and links to the
+built-in documentation, which the **Help** ribbon tab also opens:
+
+- **User Guide** — the tutorial book _Break It Before It Breaks_: 23 chapters, from a three-block lantern to a tuned
+  data centre, with companion `.rbds` models you can open straight from the book (the `opsmodel` buttons).
+- **Reference Manual** — field-by-field reference; **F1** jumps to the section for the focused panel or dialog.
+- **Formulas** — every metric, the importance measures and the distribution table as equations, on one page.
+- **Keyboard shortcuts** — [`docs/KEYBOARD_SHORTCUTS.md`](https://github.com/openpowershift/RaptorStudio/blob/main/docs/KEYBOARD_SHORTCUTS.md), also under **Help**. Press **Alt**
+  in the app to show a key tip on every ribbon button.
+- **AI assistant** — [`docs/MCP.md`](https://github.com/openpowershift/RaptorStudio/blob/main/docs/MCP.md) and the book's last chapter.
+- **File format** — [`docs/RBDS_FORMAT.md`](https://github.com/openpowershift/RaptorStudio/blob/main/docs/RBDS_FORMAT.md) describes the `.rbds` JSON format.
+
+## IEC 61078
+
+IEC 61078:2016 defines reliability block diagrams and the methods used to evaluate them. RAPTOR Studio uses the same
+vocabulary (series, parallel, m-out-of-n, sub-RBDs, repaired and non-repaired blocks) but evaluates a model by
+**Monte Carlo simulation**, which lets it include repair, spares, phases, dependencies and limited resources. It is not
+a certified implementation of the standard, and this is a capability statement, not a compliance claim.
+
+In short: series, parallel, mixed and m-out-of-n structures, repaired and non-repaired blocks and sub-RBDs are
+supported, and the standard's worked examples are regression-tested against the simulator. The Annex D importance
+measures are **estimated by re-simulation** (see above). Minimal cut/tie sets, Boolean and BDD evaluation, analytical
+availability and PFD<sub>avg</sub>, repeated blocks, non-coherent blocks and PAND/SEQ/CCF gates are **not** implemented.
+The full clause-by-clause table is in [`docs/IEC61078.md`](https://github.com/openpowershift/RaptorStudio/blob/main/docs/IEC61078.md); MCP clients can read it with
+`read_doc('iec61078')`.
+
+## How the fidelity is checked
+
+The engine is tested against files written by Raptor 7 itself, captured while driving it under Wine and, for the
+hardest cases, while following its scheduler with a debugger.
+
+- `tests/golden/` holds over 200 models with Raptor 7's output for each. Their event logs, report files and
+  random-draw logs are compared exactly, and a scan of the captured event logs currently finds **none** of the
+  recorded runs different.
+- The engine code names the Raptor 7 procedure each part reproduces, and the design of each part is described in [`docs/engine-design/`](https://github.com/openpowershift/RaptorStudio/blob/main/docs/engine-design/README.adoc).
+- More than 7,500 automated tests run on every change, including the application's own windows and dialogs and an
+  adversarial test of the MCP server.
+
+## Development
+
+```bash
+pip install -e ".[dev,mcp]"   # `mcp` extra needed by the MCP server tests
+pytest                        # unit + fast integration; add -m slow for UI sweeps
+```
+
+[`CONTRIBUTING.md`](https://github.com/openpowershift/RaptorStudio/blob/main/CONTRIBUTING.md) describes the test tiers and the conventions for changing the engine.
+The docs render with Ruby asciidoctor: `new_docs/tools/render_docs.sh` (see `new_docs/README.md`).
+
+### Repository layout
+
+| Path                    | Contents                                                                                                                                                          |
+| ----------------------- | ----------------------------------------------------------------------------------------------------------------------------------------------------------------- |
+| `raptor/`               | The application: `core/` engine, `api/`, `cli/`, `gui/`, `mcp/`, `render/`                                                                                        |
+| `tests/`                | `unit/`, `behaviour/`, `integration/` (incl. `sweeps/`), `golden/` (Raptor 7's captured output; large captures gzipped), `fixtures/` (probe models), `ladder/`, `data/` (shared sample models) |
+| `new_docs/`             | User Guide (tutorial book), its models and build tools                                                                                                            |
+| `docs/`                 | Reference manual, [engine design](https://github.com/openpowershift/RaptorStudio/blob/main/docs/engine-design/README.adoc), [MCP server reference](https://github.com/openpowershift/RaptorStudio/blob/main/docs/MCP.md), formulas, [keyboard shortcuts](https://github.com/openpowershift/RaptorStudio/blob/main/docs/KEYBOARD_SHORTCUTS.md), [`.rbds` file format](https://github.com/openpowershift/RaptorStudio/blob/main/docs/RBDS_FORMAT.md), [IEC 61078](https://github.com/openpowershift/RaptorStudio/blob/main/docs/IEC61078.md) |
+| `tools/`                | Developer tools the tests and CI run: engine snapshot, coverage, type gate, doc generators                                                                        |
+| `installer/`            | Packaging (PyInstaller, Inno Setup, deb/AppImage)                                                                                                                 |
+| `packaging/`            | `raptor-studio-mcp`, the small PyPI package the MCP Registry lists                                                                                                |
+
+## Roadmap
+
+Directions under consideration — ideas, not commitments, in no fixed order:
+
+- **A live view of an assistant's work.** Watch the model an AI assistant is
+  building through the MCP server in a second, read-only window, redrawn on
+  each edit.
+- **More Raptor 7 parity checks.** Keep comparing results with the original
+  on new model shapes and rarely used options.
+- **Further solution methods.** Analytical and fault-tree solvers beside the
+  simulation, for quick answers and cross-checks; minimal cut/tie sets and BDD
+  evaluation; importance of whole hierarchies; common-cause and dynamic gates.
+- **Richer maintenance and logistics.** Crews, shifts and supply chains that
+  the model can express directly.
+- **Uncertainty and sensitivity analysis.** Ask which input matters most, and
+  how sure the answer is.
+
+## Licence & credits
+
+RAPTOR was originally created at ARINC (Chuck Carter, Steve Brown,
+Tony Malerich, Elizabeth Grimes) and released as open source by
+**Booz Allen Hamilton** — many thanks to BAH. RAPTOR-derived material
+stays under the **Booz Allen Public License v1.0** (`LICENSE`); new
+code in this port is licensed under the **Apache License 2.0**
+(`LICENSES/Apache-2.0.txt`). See `NOTICE.md` for attribution details.
+
+<!-- mcp-name: io.github.OpenPowerShift/raptor-studio -->