Skip to main content

Turnkey CI verification for Mipiti threat model assertions

Project description

mipiti-verify

Turnkey CI verification for Mipiti threat model assertions. Security controls that never drift.

Install

pip install mipiti-verify[all]

Usage

# Verify all models in the workspace (recommended)
mipiti-verify run --all \
  --api-key $MIPITI_API_KEY \
  --tier2-provider openai \
  --tier2-model gpt-4o-mini \
  --project-root .

# Verify a single model
mipiti-verify run <model_id> \
  --api-key $MIPITI_API_KEY \
  --tier2-provider openai \
  --project-root .

# List pending assertions
mipiti-verify list <model_id>

# Show verification report
mipiti-verify report <model_id>

API keys are workspace-scoped — --all verifies every model accessible by the key.

API key scopes

Prefix Scope Use
mk_ Developer Local development. Runs assertions but does not submit results.
mv_ Verifier CI pipelines. Runs assertions and submits results to update verification status.

Developer keys skip result submission automatically — no --dry-run needed.

Key flags

Flag Default Description
--reverify / --no-reverify --reverify Re-verify all assertions, not just pending. Catches regressions.
--changed-files FILE none Only verify assertions referencing files listed in FILE. Use git diff --name-only HEAD~1 > changed.txt.
--concurrency N 1 Max concurrent Tier 2 LLM calls. Tune based on API rate limits.
--dry-run off Run verifiers but don't submit results.
--output github text Emit GitHub Actions annotations (errors, warnings, notices).
--tier2-provider none AI provider: openai, anthropic, or ollama. Omit for Tier 1 only.
--tier2-model gpt-4o Model name (e.g., gpt-4o-mini, claude-sonnet-4-5-20250514).

GitHub Action

- uses: Mipiti/mipiti-verify@v0.10.0
  with:
    api-key: ${{ secrets.MIPITI_API_KEY }}
    all: true
    tier2-provider: openai
    tier2-model: gpt-4o-mini
    tier2-api-key: ${{ secrets.OPENAI_API_KEY }}

All assertions are re-verified by default. Use reverify: false to only check new assertions (e.g., to reduce Tier 2 API costs on PRs). Omitting tier2-provider runs Tier 1 only — controls won't reach "verified" status without Tier 2.

Development

git clone https://github.com/Mipiti/mipiti-verify.git
cd mipiti-verify
pip install -e ".[dev]"
python -m pytest -v

License

Proprietary. Copyright (c) 2026 Mipiti, LLC. All rights reserved. See LICENSE for details.

Project details


Release history Release notifications | RSS feed

Download files

Download the file for your platform. If you're not sure which to choose, learn more about installing packages.

Source Distribution

mipiti_verify-0.12.0.tar.gz (36.0 kB view details)

Uploaded Source

Built Distribution

If you're not sure about the file name format, learn more about wheel file names.

mipiti_verify-0.12.0-py3-none-any.whl (32.3 kB view details)

Uploaded Python 3

File details

Details for the file mipiti_verify-0.12.0.tar.gz.

File metadata

  • Download URL: mipiti_verify-0.12.0.tar.gz
  • Upload date:
  • Size: 36.0 kB
  • Tags: Source
  • Uploaded using Trusted Publishing? Yes
  • Uploaded via: twine/6.1.0 CPython/3.13.7

File hashes

Hashes for mipiti_verify-0.12.0.tar.gz
Algorithm Hash digest
SHA256 b179151e8c6babd8805bbe444e50722dc24460c08708a75a80fc455d335a6e69
MD5 46c26dd85b072c45ee59bf011ae99742
BLAKE2b-256 7987b5b3bb372c2ba1f0c5015a6b5cea830b5700f73931d17dca7c4da7cd432b

See more details on using hashes here.

Provenance

The following attestation bundles were made for mipiti_verify-0.12.0.tar.gz:

Publisher: publish.yml on Mipiti/mipiti-verify

Attestations: Values shown here reflect the state when the release was signed and may no longer be current.

File details

Details for the file mipiti_verify-0.12.0-py3-none-any.whl.

File metadata

  • Download URL: mipiti_verify-0.12.0-py3-none-any.whl
  • Upload date:
  • Size: 32.3 kB
  • Tags: Python 3
  • Uploaded using Trusted Publishing? Yes
  • Uploaded via: twine/6.1.0 CPython/3.13.7

File hashes

Hashes for mipiti_verify-0.12.0-py3-none-any.whl
Algorithm Hash digest
SHA256 16ed024aac4ff892f84f66d8c6f378e338f88935bbe7e6f2cd3a90c3b742ad4f
MD5 5a6e3193696c229500d977dfe805ffea
BLAKE2b-256 228e62c14837dabf80a8d7423e7547a98712a380a33b11c1a3f249583a1a61d3

See more details on using hashes here.

Provenance

The following attestation bundles were made for mipiti_verify-0.12.0-py3-none-any.whl:

Publisher: publish.yml on Mipiti/mipiti-verify

Attestations: Values shown here reflect the state when the release was signed and may no longer be current.

Supported by

AWS Cloud computing and Security Sponsor Datadog Monitoring Depot Continuous Integration Fastly CDN Google Download Analytics Pingdom Monitoring Sentry Error logging StatusPage Status page