promptmc 0.3.0__tar.gz

promptmc-0.3.0/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 PromptMC Contributors
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

promptmc-0.3.0/PKG-INFO

@@ -0,0 +1,154 @@
+Metadata-Version: 2.4
+Name: promptmc
+Version: 0.3.0
+Summary: AI Assistant and CLI for OpenMC simulation workflows
+License: MIT
+License-File: LICENSE
+Keywords: openmc,monte-carlo,nuclear,simulation,mcp
+Author: PromptMC Contributors
+Requires-Python: >=3.10,<4.0
+Classifier: Development Status :: 4 - Beta
+Classifier: Intended Audience :: Science/Research
+Classifier: License :: OSI Approved :: MIT License
+Classifier: Programming Language :: Python :: 3
+Classifier: Programming Language :: Python :: 3.10
+Classifier: Programming Language :: Python :: 3.11
+Classifier: Programming Language :: Python :: 3.12
+Classifier: Programming Language :: Python :: 3.13
+Classifier: Programming Language :: Python :: 3.14
+Classifier: Topic :: Scientific/Engineering :: Physics
+Provides-Extra: telemetry
+Requires-Dist: defusedxml (>=0.7.1,<0.8.0)
+Requires-Dist: google-genai (>=0.1.0)
+Requires-Dist: h5py (>=3.11.0,<4.0.0)
+Requires-Dist: mcp (>=1.0.0)
+Requires-Dist: opentelemetry-api (>=1.26.0,<2.0.0) ; extra == "telemetry"
+Requires-Dist: opentelemetry-exporter-otlp (>=1.26.0,<2.0.0) ; extra == "telemetry"
+Requires-Dist: opentelemetry-sdk (>=1.26.0,<2.0.0) ; extra == "telemetry"
+Requires-Dist: psutil (>=6.0.0,<7.0.0)
+Requires-Dist: pydantic (>=2.8.0,<3.0.0)
+Requires-Dist: pyyaml (>=6.0.0,<7.0.0)
+Requires-Dist: rich (>=13.7.0,<14.0.0)
+Requires-Dist: tenacity (>=9.1.4,<10.0.0)
+Requires-Dist: typer[all] (>=0.12.0)
+Project-URL: Changelog, https://github.com/rjonace/promptmc/blob/main/CHANGELOG.md
+Project-URL: Issues, https://github.com/rjonace/promptmc/issues
+Project-URL: Repository, https://github.com/rjonace/promptmc
+Description-Content-Type: text/markdown
+
+<p align="center">
+  <img src="docs/assets/logo.svg" alt="PromptMC logo" width="140">
+</p>
+
+<h1 align="center">PromptMC</h1>
+
+<p align="center">
+  <img src="https://img.shields.io/badge/python-3.10%2B-blue" alt="Python">
+  <img src="https://img.shields.io/badge/license-MIT-green" alt="License">
+  <img src="https://img.shields.io/github/actions/workflow/status/rjonace/promptmc/ci.yml" alt="CI">
+</p>
+
+[OpenMC](https://docs.openmc.org/en/stable/) is powerful but can be painful to use: you hand-write XML, manage batch runs, and read results out of [HDF5](https://www.hdfgroup.org/solutions/hdf5/). It would be great if we could safely use AI to reduce that friction.
+
+PromptMC does that by providing infrastructure and tooling that allows both AI LLM assistants and humans to interact with OpenMC through typed, schema-driven workflows.
+
+It works like a grammar checker between an AI LLM assistant and OpenMC: your AI proposes a configuration, PromptMC validates XML structure and supported schema constraints before the simulator runs, and catches malformed inputs early.
+
+Because AI [hallucination](https://link.springer.com/article/10.1007/s10676-024-09775-5) is a valid concern in reactor physics, the system is designed with deterministic blast walls. Every configuration (from a human, the deterministic local planner, or AI) is validated against the same typed [Pydantic](https://docs.pydantic.dev/) schemas before it reaches the simulator.
+
+## What you can do
+
+Most planning and schema-validation workflows work without OpenMC installed; execution, geometry-debug checks, and 2D plot rendering require OpenMC.
+
+**Without OpenMC installed:**
+- Describe a simulation in plain English → a validated plan and `settings.xml` (the default planner uses no generative AI)
+- Validate XML structure and PromptMC's supported OpenMC schemas
+- Drive planning and schema validation from an AI client via the MCP server
+
+**With OpenMC installed:**
+- Run simulations (subprocess or Python API)
+- Run geometry-debug overlap checks and generate 2D slice plots inside your AI chat client
+- Parse [statepoint and tally](https://docs.openmc.org/en/stable/usersguide/tallies.html) outputs without touching HDF5
+
+## Installation
+
+**Prerequisites:**
+- Python 3.10 or higher
+- Pip
+
+**PromptMC** can be installed using pip. Use the following commands to install PromptMC:
+
+```bash
+pip install promptmc              # core (includes CLI, MCP server, and Gemini planner)
+pip install promptmc[telemetry]   # + OpenTelemetry tracing
+```
+
+**OpenMC** (required for simulation execution, geometry-debug checks, and plot rendering) can be installed via Conda, Spack, Docker, or build from source per [docs.openmc.org](https://docs.openmc.org/en/stable/quickinstall.html). Planning and XML/schema validation work without it.
+
+**[Cross-section data](https://www.nndc.bnl.gov/endf/)** (for running simulations):
+
+```bash
+pip install openmc-data-downloader
+openmc_data_downloader -l TENDL-2019 -i U235 U238 O16 H1 -d cross_sections
+export OPENMC_CROSS_SECTIONS=$(pwd)/cross_sections/cross_sections.xml
+```
+
+See [installation](docs/installation.md) for more details.
+
+## MCP server
+
+PromptMC exposes a [Model Context Protocol](https://modelcontextprotocol.io) server so AI assistants can run OpenMC workflows natively — validation, plotting, execution, and result parsing from inside your LLM chat client, such as Claude Desktop, Cursor, and Google Antigravity.
+
+**[Tools](https://modelcontextprotocol.io/docs/concepts/tools):** `openmc_validate`, `openmc_schema_check`, `openmc_template`, `openmc_list_templates`, `openmc_run`, `openmc_analyze`, `openmc_plot` (2D slice, returned to the chat client), `openmc_geometry_debug`, `openmc_check_installation`, `openmc_check_cross_sections`.
+
+[Resources](https://modelcontextprotocol.io/docs/concepts/resources) expose the configured cross-sections path, the session's tool-call history, and the bundled examples.
+
+**Setup:** see the [MCP server configuration guide](docs/mcp.md) for per-client steps (Claude Desktop/Code, Cursor, Google Antigravity, VS Code).
+
+## CLI
+
+By default, `plan` uses a deterministic local planner, needing no API key, no network, no generative AI. The optional `--llm` flag calls Google Gemini (set GEMINI_API_KEY), which can interpret more open-ended natural-language requests. Customize the model name with GEMINI_MODEL (defaults to gemini-3.5-flash).
+
+```bash
+promptmc plan "concrete shielding calculation with 1 million particles"
+promptmc plan "pin cell criticality with 50k particles" --write
+promptmc template criticality --particles 10000                 # generate settings.xml
+promptmc validate input.xml --schema
+promptmc run input.xml --threads 4                              # needs OpenMC
+promptmc batch batch_spec.yaml --parallel threads --workers 4
+promptmc analyze ./output --json results.json
+promptmc info                                                   # environment status
+```
+
+Full options in the [CLI reference](docs/cli-reference.md).
+
+## Safety
+
+PromptMC is an engineering-assist tool that keeps a human in the loop. It is not a substitute for professional engineering judgment, independent verification and validation, or regulatory review, and is not for safety, licensing, or other regulated decisions. Reproducing a published benchmark is not qualification for safety analysis. Provided as-is (see [LICENSE](LICENSE)).
+
+The goal is not autonomous reactor design; the goal is safer, faster OpenMC iteration.
+
+## Documentation
+
+- [Installation](docs/installation.md) — setup paths for PromptMC, OpenMC, and nuclear data
+- [MCP server](docs/mcp.md) — connecting AI assistants (Claude Desktop/Code, Cursor, Antigravity, VS Code)
+- [CLI reference](docs/cli-reference.md) — commands, flags, environment variables
+- [Python API](docs/python-api.md) — scripting PromptMC
+- [Templates](docs/cli-reference.md#templates) · [Telemetry](docs/telemetry-and-audit.md)
+- [Examples](src/promptmc/examples/uo2_criticality/README.md) · [MCP example](examples/mcp/README.md)
+- [Roadmap](ROADMAP.md) · [Changelog](CHANGELOG.md) · [Contributing](CONTRIBUTING.md)
+
+## About
+
+I studied nuclear engineering at MIT over 20 years ago, running MCNP 4 for my senior thesis. Though I left during my senior year, I eventually went back to university to get a degree in Computer Science, and I have spent the last 11 years working as a software engineer and site reliability engineer at a major FAANG cloud provider.
+
+PromptMC bridges those two worlds. It is also, for me, an exploration of using agentic programming to build software for fun but still holding professional production principles and standards.
+
+## Contributions and Support
+
+I welcome contributions! Please ensure all checks pass (`pytest`, `ruff check`, `mypy src/`) before opening a PR.
+- **License:** MIT
+- **Documentation:** [GitHub Repository](https://github.com/rjonace/promptmc)
+- **Issues and Discussions:** [GitHub Issues](https://github.com/rjonace/promptmc/issues)
+- **Roadmap:** [ROADMAP.md](ROADMAP.md) for planned features and scope.
+

promptmc-0.3.0/README.md

@@ -0,0 +1,115 @@
+<p align="center">
+  <img src="docs/assets/logo.svg" alt="PromptMC logo" width="140">
+</p>
+
+<h1 align="center">PromptMC</h1>
+
+<p align="center">
+  <img src="https://img.shields.io/badge/python-3.10%2B-blue" alt="Python">
+  <img src="https://img.shields.io/badge/license-MIT-green" alt="License">
+  <img src="https://img.shields.io/github/actions/workflow/status/rjonace/promptmc/ci.yml" alt="CI">
+</p>
+
+[OpenMC](https://docs.openmc.org/en/stable/) is powerful but can be painful to use: you hand-write XML, manage batch runs, and read results out of [HDF5](https://www.hdfgroup.org/solutions/hdf5/). It would be great if we could safely use AI to reduce that friction.
+
+PromptMC does that by providing infrastructure and tooling that allows both AI LLM assistants and humans to interact with OpenMC through typed, schema-driven workflows.
+
+It works like a grammar checker between an AI LLM assistant and OpenMC: your AI proposes a configuration, PromptMC validates XML structure and supported schema constraints before the simulator runs, and catches malformed inputs early.
+
+Because AI [hallucination](https://link.springer.com/article/10.1007/s10676-024-09775-5) is a valid concern in reactor physics, the system is designed with deterministic blast walls. Every configuration (from a human, the deterministic local planner, or AI) is validated against the same typed [Pydantic](https://docs.pydantic.dev/) schemas before it reaches the simulator.
+
+## What you can do
+
+Most planning and schema-validation workflows work without OpenMC installed; execution, geometry-debug checks, and 2D plot rendering require OpenMC.
+
+**Without OpenMC installed:**
+- Describe a simulation in plain English → a validated plan and `settings.xml` (the default planner uses no generative AI)
+- Validate XML structure and PromptMC's supported OpenMC schemas
+- Drive planning and schema validation from an AI client via the MCP server
+
+**With OpenMC installed:**
+- Run simulations (subprocess or Python API)
+- Run geometry-debug overlap checks and generate 2D slice plots inside your AI chat client
+- Parse [statepoint and tally](https://docs.openmc.org/en/stable/usersguide/tallies.html) outputs without touching HDF5
+
+## Installation
+
+**Prerequisites:**
+- Python 3.10 or higher
+- Pip
+
+**PromptMC** can be installed using pip. Use the following commands to install PromptMC:
+
+```bash
+pip install promptmc              # core (includes CLI, MCP server, and Gemini planner)
+pip install promptmc[telemetry]   # + OpenTelemetry tracing
+```
+
+**OpenMC** (required for simulation execution, geometry-debug checks, and plot rendering) can be installed via Conda, Spack, Docker, or build from source per [docs.openmc.org](https://docs.openmc.org/en/stable/quickinstall.html). Planning and XML/schema validation work without it.
+
+**[Cross-section data](https://www.nndc.bnl.gov/endf/)** (for running simulations):
+
+```bash
+pip install openmc-data-downloader
+openmc_data_downloader -l TENDL-2019 -i U235 U238 O16 H1 -d cross_sections
+export OPENMC_CROSS_SECTIONS=$(pwd)/cross_sections/cross_sections.xml
+```
+
+See [installation](docs/installation.md) for more details.
+
+## MCP server
+
+PromptMC exposes a [Model Context Protocol](https://modelcontextprotocol.io) server so AI assistants can run OpenMC workflows natively — validation, plotting, execution, and result parsing from inside your LLM chat client, such as Claude Desktop, Cursor, and Google Antigravity.
+
+**[Tools](https://modelcontextprotocol.io/docs/concepts/tools):** `openmc_validate`, `openmc_schema_check`, `openmc_template`, `openmc_list_templates`, `openmc_run`, `openmc_analyze`, `openmc_plot` (2D slice, returned to the chat client), `openmc_geometry_debug`, `openmc_check_installation`, `openmc_check_cross_sections`.
+
+[Resources](https://modelcontextprotocol.io/docs/concepts/resources) expose the configured cross-sections path, the session's tool-call history, and the bundled examples.
+
+**Setup:** see the [MCP server configuration guide](docs/mcp.md) for per-client steps (Claude Desktop/Code, Cursor, Google Antigravity, VS Code).
+
+## CLI
+
+By default, `plan` uses a deterministic local planner, needing no API key, no network, no generative AI. The optional `--llm` flag calls Google Gemini (set GEMINI_API_KEY), which can interpret more open-ended natural-language requests. Customize the model name with GEMINI_MODEL (defaults to gemini-3.5-flash).
+
+```bash
+promptmc plan "concrete shielding calculation with 1 million particles"
+promptmc plan "pin cell criticality with 50k particles" --write
+promptmc template criticality --particles 10000                 # generate settings.xml
+promptmc validate input.xml --schema
+promptmc run input.xml --threads 4                              # needs OpenMC
+promptmc batch batch_spec.yaml --parallel threads --workers 4
+promptmc analyze ./output --json results.json
+promptmc info                                                   # environment status
+```
+
+Full options in the [CLI reference](docs/cli-reference.md).
+
+## Safety
+
+PromptMC is an engineering-assist tool that keeps a human in the loop. It is not a substitute for professional engineering judgment, independent verification and validation, or regulatory review, and is not for safety, licensing, or other regulated decisions. Reproducing a published benchmark is not qualification for safety analysis. Provided as-is (see [LICENSE](LICENSE)).
+
+The goal is not autonomous reactor design; the goal is safer, faster OpenMC iteration.
+
+## Documentation
+
+- [Installation](docs/installation.md) — setup paths for PromptMC, OpenMC, and nuclear data
+- [MCP server](docs/mcp.md) — connecting AI assistants (Claude Desktop/Code, Cursor, Antigravity, VS Code)
+- [CLI reference](docs/cli-reference.md) — commands, flags, environment variables
+- [Python API](docs/python-api.md) — scripting PromptMC
+- [Templates](docs/cli-reference.md#templates) · [Telemetry](docs/telemetry-and-audit.md)
+- [Examples](src/promptmc/examples/uo2_criticality/README.md) · [MCP example](examples/mcp/README.md)
+- [Roadmap](ROADMAP.md) · [Changelog](CHANGELOG.md) · [Contributing](CONTRIBUTING.md)
+
+## About
+
+I studied nuclear engineering at MIT over 20 years ago, running MCNP 4 for my senior thesis. Though I left during my senior year, I eventually went back to university to get a degree in Computer Science, and I have spent the last 11 years working as a software engineer and site reliability engineer at a major FAANG cloud provider.
+
+PromptMC bridges those two worlds. It is also, for me, an exploration of using agentic programming to build software for fun but still holding professional production principles and standards.
+
+## Contributions and Support
+
+I welcome contributions! Please ensure all checks pass (`pytest`, `ruff check`, `mypy src/`) before opening a PR.
+- **License:** MIT
+- **Documentation:** [GitHub Repository](https://github.com/rjonace/promptmc)
+- **Issues and Discussions:** [GitHub Issues](https://github.com/rjonace/promptmc/issues)
+- **Roadmap:** [ROADMAP.md](ROADMAP.md) for planned features and scope.

promptmc-0.3.0/examples/batch_spec.yaml

@@ -0,0 +1,14 @@
+name: parameter-sweep-example
+description: Example batch specification for parameter sweep simulations
+base_input: ./input.xml
+output_root: ./batch_results
+threads_per_job: 2
+parameter_sweeps:
+  - particles: 1000
+    batches: 50
+  - particles: 5000
+    batches: 50
+  - particles: 10000
+    batches: 100
+  - particles: 50000
+    batches: 200

promptmc-0.3.0/examples/input.xml

@@ -0,0 +1,30 @@
+<?xml version="1.0"?>
+<settings>
+  <!-- Run control -->
+  <run_mode>eigenvalue</run_mode>
+  <batches>100</batches>
+  <inactive>10</inactive>
+  <particles>10000</particles>
+
+  <!-- Energy mode -->
+  <energy_mode>
+    <type>MG</type>
+    <method>CE</method>
+  </energy_mode>
+
+  <!-- Source definition -->
+  <source>
+    <type>point</type>
+    <space>
+      <type>point</type>
+      <parameters>0 0 0</parameters>
+    </space>
+  </source>
+
+  <!-- Output settings -->
+  <output>
+    <path>results</path>
+    <tallies>true</tallies>
+    <summary>true</summary>
+  </output>
+</settings>

promptmc-0.3.0/examples/mcp/README.md

@@ -0,0 +1,41 @@
+# MCP Demo: UO2 Criticality Benchmark
+
+This demonstrates running the bundled UO2 example through PromptMC's [MCP](https://modelcontextprotocol.io) server.
+
+## Connect
+
+Configure an MCP-capable assistant (Claude Desktop, Claude Code, Cursor,
+Google Antigravity, VS Code with Copilot) using the per-client
+setup in the [MCP server configuration guide](../../docs/mcp.md). The client
+launches the `promptmc-mcp` server for you over stdio — you don't run it by
+hand. Set `OPENMC_CROSS_SECTIONS` in that config so this example can execute
+and plot.
+
+To smoke-test the command outside a client:
+
+```bash
+export OPENMC_CROSS_SECTIONS=/path/to/cross_sections.xml
+promptmc-mcp   # serves MCP over stdio; Ctrl-C to exit
+```
+
+## Driving the demo
+
+You don't type the tool calls below — you prompt the assistant in plain English
+and it picks the tools. For example:
+
+> Validate and run the bundled UO2 criticality example with 4 threads, then
+> show me k-effective and an xy slice of the geometry.
+
+The assistant would carry that out with roughly these calls:
+
+1. **Check installation**: `openmc_check_installation` → confirms OpenMC is available
+2. **Check cross sections**: `openmc_check_cross_sections` → confirms `OPENMC_CROSS_SECTIONS` is set
+3. **Validate inputs**: `openmc_validate { "input_path": "examples/uo2_criticality" }`
+4. **Schema check**: `openmc_schema_check { "input_path": "examples/uo2_criticality" }`
+5. **Run simulation**: `openmc_run { "input_path": "examples/uo2_criticality", "threads": 4 }`
+6. **Analyze results**: `openmc_analyze { "output_path": "examples/uo2_criticality" }`
+7. **Plot geometry**: `openmc_plot { "geometry_xml_path": "examples/uo2_criticality", "basis": "xy" }`
+
+The `promptmc://history` resource records each tool call made during the
+session, and `promptmc://examples/uo2_criticality` lists the files in the
+bundled example.

promptmc-0.3.0/pyproject.toml

@@ -0,0 +1,164 @@
+[tool.poetry]
+name = "promptmc"
+version = "0.3.0"
+description = "AI Assistant and CLI for OpenMC simulation workflows"
+authors = ["PromptMC Contributors"]
+license = "MIT"
+readme = "README.md"
+repository = "https://github.com/rjonace/promptmc"
+keywords = ["openmc", "monte-carlo", "nuclear", "simulation", "mcp"]
+classifiers = [
+    "Development Status :: 4 - Beta",
+    "Intended Audience :: Science/Research",
+    "License :: OSI Approved :: MIT License",
+    "Programming Language :: Python :: 3.10",
+    "Programming Language :: Python :: 3.11",
+    "Programming Language :: Python :: 3.12",
+    "Programming Language :: Python :: 3.13",
+    "Topic :: Scientific/Engineering :: Physics",
+]
+packages = [{include = "promptmc", from = "src"}]
+include = [{ path = "examples", format = ["sdist"] }]
+
+[tool.poetry.urls]
+"Changelog" = "https://github.com/rjonace/promptmc/blob/main/CHANGELOG.md"
+"Issues" = "https://github.com/rjonace/promptmc/issues"
+
+[tool.poetry.dependencies]
+python = "^3.10"
+typer = {extras = ["all"], version = ">=0.12.0"}
+rich = "^13.7.0"
+pydantic = "^2.8.0"
+h5py = "^3.11.0"
+pyyaml = "^6.0.0"
+psutil = "^6.0.0"
+defusedxml = "^0.7.1"
+opentelemetry-api = {version = "^1.26.0", optional = true}
+opentelemetry-sdk = {version = "^1.26.0", optional = true}
+opentelemetry-exporter-otlp = {version = "^1.26.0", optional = true}
+tenacity = "^9.1.4"
+mcp = ">=1.0.0"
+google-genai = ">=0.1.0"
+
+[tool.poetry.extras]
+telemetry = ["opentelemetry-api", "opentelemetry-sdk", "opentelemetry-exporter-otlp"]
+
+[tool.poetry.group.dev.dependencies]
+pytest = "^8.2.0"
+pytest-cov = "^5.0.0"
+mypy = "^1.10.0"
+ruff = "^0.5.0"
+pre-commit = "^3.7.0"
+bandit = "^1.7.9"
+types-PyYAML = "^6.0.0"
+types-psutil = "^6.0.0"
+types-defusedxml = "^0.7.0"
+hypothesis = "^6.100.0"
+
+[tool.poetry.scripts]
+promptmc = "promptmc.cli:app"
+promptmc-mcp = "promptmc.mcp.server:main"
+
+[build-system]
+requires = ["poetry-core"]
+build-backend = "poetry.core.masonry.api"
+
+[tool.ruff]
+target-version = "py310"
+line-length = 80
+
+[tool.ruff.lint]
+select = [
+    "E",   # pycodestyle errors
+    "W",   # pycodestyle warnings
+    "F",   # pyflakes
+    "I",   # isort
+    "B",   # flake8-bugbear
+    "C4",  # flake8-comprehensions
+    "UP",  # pyupgrade
+    "ARG", # flake8-unused-arguments
+    "SIM", # flake8-simplify
+    "D",   # pydocstyle (Google convention)
+]
+ignore = [
+    "B008",   # Function calls in argument defaults (Typer pattern)
+    "D100",   # Missing docstring in public module (handled per-file)
+    "D104",   # Missing docstring in public package
+    "D107",   # Missing docstring in __init__ (use class docstring)
+    "D203",   # Conflicts with D211 (no-blank-line-before-class)
+    "D213",   # Conflicts with D212 (multi-line-summary-first-line)
+    "E501",   # Line too long (formatter handles code; strings are exempt per Google style)
+]
+
+[tool.ruff.lint.pydocstyle]
+convention = "google"
+
+[tool.ruff.lint.per-file-ignores]
+"src/promptmc/cli.py" = ["ARG001", "D103", "E501"]
+"src/promptmc/templates.py" = ["ARG002"]
+"src/promptmc/openmc_integration.py" = ["ARG002"]
+"tests/*" = ["ARG001", "ARG002", "D100", "D101", "D102", "D103"]
+
+[tool.ruff.format]
+quote-style = "double"
+indent-style = "space"
+skip-magic-trailing-comma = false
+line-ending = "auto"
+
+[tool.mypy]
+python_version = "3.10"
+warn_return_any = true
+warn_unused_configs = true
+disallow_untyped_defs = true
+disallow_incomplete_defs = true
+check_untyped_defs = true
+no_implicit_optional = true
+warn_redundant_casts = true
+warn_unused_ignores = true
+warn_no_return = true
+strict_equality = true
+
+[[tool.mypy.overrides]]
+module = [
+    "openmc.*",
+    "h5py.*",
+    "opentelemetry.*",
+    "mcp.*",
+]
+ignore_missing_imports = true
+
+[[tool.mypy.overrides]]
+module = "promptmc.telemetry"
+warn_unused_ignores = false
+
+[tool.pytest.ini_options]
+testpaths = ["tests"]
+python_files = ["test_*.py"]
+python_classes = ["Test*"]
+python_functions = ["test_*"]
+addopts = [
+    "--cov=promptmc",
+    "--cov-report=term-missing",
+    "--cov-report=html",
+    "--strict-markers",
+]
+markers = [
+    "integration: MCP integration tests",
+    "requires_openmc: Tests that require openmc to be importable/installed",
+    "requires_openmc_data: Tests that require openmc with cross-section data installed",
+]
+
+[tool.coverage.run]
+source = ["src"]
+omit = ["*/tests/*", "*/test_*.py"]
+
+[tool.coverage.report]
+exclude_lines = [
+    "pragma: no cover",
+    "def __repr__",
+    "raise AssertionError",
+    "raise NotImplementedError",
+    "if __name__ == .__main__.:",
+    "if TYPE_CHECKING:",
+    "@abstractmethod",
+]

promptmc-0.3.0/src/promptmc/__init__.py

@@ -0,0 +1,22 @@
+"""PromptMC: AI Assistant and CLI for OpenMC workflows."""
+
+from promptmc.batch import BatchRunner, ParallelConfig, ParallelMode
+from promptmc.openmc_integration import (
+    ExecutionMode,
+    OpenMCInstaller,
+    OpenMCRunner,
+    OpenMCValidator,
+)
+
+__version__ = "0.3.0"
+
+__all__ = [
+    "__version__",
+    "BatchRunner",
+    "ExecutionMode",
+    "OpenMCInstaller",
+    "OpenMCRunner",
+    "OpenMCValidator",
+    "ParallelConfig",
+    "ParallelMode",
+]

promptmc-0.3.0/src/promptmc/_typing.py

@@ -0,0 +1,5 @@
+"""Common type aliases for PromptMC."""
+
+from pathlib import Path
+
+PathLike = str | Path