mini-antemortem-cli 0.2.0__tar.gz → 0.4.0__tar.gz

mini_antemortem_cli-0.4.0/AUTHORS.md

@@ -0,0 +1,42 @@
+# Authors
+
+This project was conceived, designed, and authored by:
+
+**Primary Author**: Kyunghoon Gwak (곽경훈) *(see [PRE_EXISTING_IP.md](PRE_EXISTING_IP.md) for full IP binding)*
+**GitHub Handle**: [@hibou04-ops](https://github.com/hibou04-ops)
+**Primary Email**: `hibouaile04@gmail.com` — Primary, Verified, Connected to Google on the GitHub account. **The Primary Author's only verified personal email.**
+
+> **Note on commit-author email misconfiguration.** Some commits in the git history before 2026-04-29 carry `hibou04@gmail.com` in the *email* field of the author. This was an unintended local git client misconfiguration on the Primary Author's machine; `hibou04@gmail.com` is **not** an email account belonging to the Primary Author. That address was added to the Primary Author's GitHub account by mistake at some point, was never verified, and was removed on 2026-04-29. The author *name* on every commit is `Hibou04-ops`, the Primary Author's GitHub handle, which is the unambiguous identifier across the repository's history. From 2026-04-29 onwards every repository in this toolkit has its local git configuration set to `hibouaile04@gmail.com`, so all subsequent commits carry the verified primary email. All work in this repository is the Primary Author's regardless of the email value recorded in any specific commit.
+
+The GitHub handle [@hibou04-ops](https://github.com/hibou04-ops) is operated by the Primary Author throughout.
+
+## Authorship Scope
+
+The following work in this repository is the personal intellectual property of
+the Primary Author, developed independently using personal time, equipment, and
+resources:
+
+- The mini-antemortem-cli analytical preflight classifier — deterministic
+  rule-based classification of seven calibration trap patterns
+  (self-agreement bias, small-sample KC-4 power, variant homogeneity,
+  rubric concentration, judge budget, empty reference, missing held-out slice)
+- All source code under `src/mini_antemortem_cli/`
+- Test suite under `tests/`
+- Documentation (README, EASY_README, EASY_README_KR)
+- Adapter plumbing mapping classifier outputs to omegaprompt's `AnalyticalFinding` contract
+
+This project is a sub-tool of the [omegaprompt](https://github.com/hibou04-ops/omegaprompt)
+calibration framework, authored by the same Primary Author, and applies the
+[Antemortem](https://github.com/hibou04-ops/Antemortem) methodology authored by
+the same Primary Author. See [PRE_EXISTING_IP.md](PRE_EXISTING_IP.md) for the
+full toolkit binding.
+
+## Contributors
+
+External contributions are accepted under the terms of the Apache License 2.0.
+Contributors retain copyright in their own contributions and grant the project
+a license under Apache 2.0 §5.
+
+---
+
+See [LICENSE](LICENSE), [NOTICE](NOTICE), and [PRE_EXISTING_IP.md](PRE_EXISTING_IP.md).

mini_antemortem_cli-0.4.0/NOTICE

@@ -0,0 +1,11 @@
+mini-antemortem-cli
+Copyright 2026 Kyunghoon Gwak (곽경훈)
+
+This product includes software developed by Kyunghoon Gwak (곽경훈),
+operating under the GitHub handle @hibou04-ops.
+
+For author binding and pre-existing IP declaration, see AUTHORS.md and
+PRE_EXISTING_IP.md in this repository.
+
+Licensed under the Apache License, Version 2.0 (the "License");
+see LICENSE file for the full license text.

{mini_antemortem_cli-0.2.0 → mini_antemortem_cli-0.4.0}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: mini-antemortem-cli
-Version: 0.2.0
+Version: 0.4.0
 Summary: Analytical preflight for omegaprompt calibration: deterministic classifier over seven calibration trap patterns (self-agreement bias, small-sample KC-4 power, variant homogeneity, rubric concentration, judge budget, empty reference, missing held-out slice). Emits AnalyticalFinding records the omegaprompt pipeline consumes via derive_adaptation_plan.
 Project-URL: Homepage, https://github.com/hibou04-ops/mini-antemortem-cli
 Project-URL: Repository, https://github.com/hibou04-ops/mini-antemortem-cli
@@ -208,6 +208,7 @@ License:                                  Apache License
            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.
+License-File: AUTHORS.md
 License-File: LICENSE
 License-File: NOTICE
 Keywords: analytical-audit,antemortem,omega-lock,omegaprompt,preflight,prompt-calibration
@@ -224,22 +225,97 @@ Requires-Dist: omegaprompt>=1.1.0
 Requires-Dist: pydantic>=2.6.0
 Provides-Extra: dev
 Requires-Dist: pytest>=8.0.0; extra == 'dev'
+Provides-Extra: mcp
+Requires-Dist: mcp>=1.0.0; extra == 'mcp'
 Description-Content-Type: text/markdown
 
 # mini-antemortem-cli
 
-> **New to this?** Start here: [EASY_README.md](EASY_README.md) (English) · [EASY_README_KR.md](EASY_README_KR.md) (한국어). Compressed plain-language introductions for readers who find the full doc below intimidating.
+> **Analytical preflight for [omegaprompt](https://pypi.org/project/omegaprompt/) calibration.** Reads run config, classifies seven calibration-specific trap patterns against deterministic rules. **No API calls, no network** — reasoning is deterministic given inputs. Emits `AnalyticalFinding` records that feed omegaprompt's `derive_adaptation_plan`.
 
+[![CI](https://github.com/hibou04-ops/mini-antemortem-cli/actions/workflows/ci.yml/badge.svg)](https://github.com/hibou04-ops/mini-antemortem-cli/actions/workflows/ci.yml)
+[![PyPI](https://img.shields.io/badge/pypi-0.3.0-blue.svg)](https://pypi.org/project/mini-antemortem-cli/)
 [![License: Apache 2.0](https://img.shields.io/badge/license-Apache--2.0-blue.svg)](LICENSE)
 [![Python](https://img.shields.io/badge/python-3.11%2B-blue.svg)](https://www.python.org)
-[![Parent](https://img.shields.io/badge/parent-omegaprompt%E2%89%A51.1.0-blueviolet.svg)](https://pypi.org/project/omegaprompt/)
+[![Tests](https://img.shields.io/badge/tests-69%20passing-brightgreen.svg)](tests/)
+[![Parent](https://img.shields.io/badge/parent-omegaprompt%E2%89%A51.4.0-blueviolet.svg)](https://pypi.org/project/omegaprompt/)
 
-> **Analytical preflight for [omegaprompt](https://pypi.org/project/omegaprompt/) calibration.** Reads the run configuration and classifies seven calibration-specific trap patterns against deterministic rules. No API calls, no network; reasoning is deterministic given the inputs. Emits `AnalyticalFinding` records that feed `omegaprompt`'s `derive_adaptation_plan`.
+> **Part of the omegaprompt toolkit** — [omegaprompt](https://github.com/hibou04-ops/omegaprompt) (calibration engine) · [omega-lock](https://github.com/hibou04-ops/omega-lock) (audit framework) · [antemortem-cli](https://github.com/hibou04-ops/antemortem-cli) (pre-implementation recon CLI) · [mini-omega-lock](https://github.com/hibou04-ops/mini-omega-lock) (empirical preflight) · [mini-antemortem-cli](https://github.com/hibou04-ops/mini-antemortem-cli) (analytical preflight, this repo) · [Antemortem](https://github.com/hibou04-ops/Antemortem) (methodology). Cross-toolkit cookbook: [AGENT_TRIGGERS.md](https://github.com/hibou04-ops/omegaprompt/blob/main/AGENT_TRIGGERS.md).
 
 ```bash
-pip install mini-antemortem-cli
+pip install omegaprompt mini-antemortem-cli
 ```
 
+**MCP server.** This package also exposes its analytical classifier as agent-callable MCP tools (`analytical_preflight`, `list_traps`). Run `pip install "mini-antemortem-cli[mcp]"` then `python -m mini_antemortem_cli.mcp` (stdio, default for Claude Code). Deterministic, zero LLM cost. See [AGENT_TRIGGERS.md scenario 2](https://github.com/hibou04-ops/omegaprompt/blob/main/AGENT_TRIGGERS.md#scenario-2--pre-calibration-sanity-check).
+
+---
+
+## TL;DR
+
+`omegaprompt` ships a **plugin interface** for preflight (`omegaprompt.preflight.contracts` + `omegaprompt.preflight.adaptation`) but no classifier code. This package fills that gap with seven deterministic trap classifiers — fully offline, fully reproducible:
+
+- **`self_agreement_bias`** — target and judge share a vendor; judge biases overlap with target.
+- **`small_sample_kc4_power`** — dataset too small for Pearson correlation to carry statistical power.
+- **`variants_homogeneous`** — system-prompt variants too similar for sensitivity to have signal.
+- **`rubric_weight_concentration`** — single rubric dimension carries most of the weight.
+- **`judge_budget_too_small`** — judge output budget is SMALL but rubric has many dimensions + gates.
+- **`empty_reference_with_strict_rubric`** — no dataset item has a reference; rubric implies ground-truth comparison.
+- **`no_held_out_slice`** — no `--test` slice; walk-forward cannot run.
+
+Each pattern returns `REAL` / `GHOST` / `NEW` / `UNRESOLVED` with a severity (`blocker` / `high` / `medium` / `low`) and a remediation hint.
+
+> **Looking for the empirical (LLM-probe) preflight?** See sibling tool [`mini-omega-lock`](https://pypi.org/project/mini-omega-lock/) — same plugin interface, runs actual provider calls instead of static analysis.
+
+---
+
+## Quick start (1-minute, fully offline)
+
+```python
+from omegaprompt.domain.dataset import Dataset, DatasetItem
+from omegaprompt.domain.judge import Dimension, HardGate, JudgeRubric
+from omegaprompt.domain.params import PromptVariants
+from omegaprompt.preflight import PreflightReport, derive_adaptation_plan
+from mini_antemortem_cli import analytical_preflight
+
+# Your run config
+rubric = JudgeRubric(
+    dimensions=[Dimension(name="accuracy", description="x", weight=1.0)],
+    hard_gates=[HardGate(name="no_violation", description="y", evaluator="judge")],
+)
+train = Dataset(items=[DatasetItem(id="ex1", input="2+2", reference="4")])
+test  = Dataset(items=[DatasetItem(id="ex2", input="3+3", reference="6")])
+variants = PromptVariants(system_prompts=["You are an assistant."], few_shot_examples=[])
+
+# Run all seven trap classifiers — fully offline, fully deterministic.
+# (Every keyword is required — analytical_preflight does not infer
+# target_provider / judge_provider from the dataset.)
+findings = analytical_preflight(
+    target_provider="anthropic",
+    target_model="claude-opus-4-7",
+    judge_provider="openai",
+    judge_model="gpt-4.1",
+    train_dataset=train,
+    test_dataset=test,                  # optional but strongly recommended
+    rubric=rubric,
+    variants=variants,
+    judge_output_budget="small",        # "small" | "medium" | "large"
+)
+
+for f in findings:
+    print(f"{f.trap_id}: {f.label} / {f.severity}")
+
+# Feed into omegaprompt's adaptation layer
+report = PreflightReport(analytical_findings=findings)
+plan = derive_adaptation_plan(report)
+print(plan.recommendations)
+```
+
+No API keys, no network, no LLM calls — output is fully reproducible given inputs.
+
+> 👋 Simpler intro: [EASY_README.md](EASY_README.md) (English) · [EASY_README_KR.md](EASY_README_KR.md)
+
+---
+
 ## Why this is separate from omegaprompt
 
 `omegaprompt` ships a **plugin interface** (`omegaprompt.preflight.contracts` + `omegaprompt.preflight.adaptation`) but no classifier code. Standalone users do not need analytical preflight — the main pipeline runs with declared defaults. Users who want analytical risk assessment over their configuration install this package alongside:

mini_antemortem_cli-0.4.0/PRE_EXISTING_IP.md

@@ -0,0 +1,109 @@
+# Pre-existing Intellectual Property Declaration
+
+> **Purpose**: This document is a tamper-evident timestamped declaration that the
+> work in this repository constitutes pre-existing personal intellectual property
+> of the Primary Author, authored prior to and independent of any current or
+> future employment relationship.
+
+## Repository Identification
+
+- **Repository**: [hibou04-ops/mini-antemortem-cli](https://github.com/hibou04-ops/mini-antemortem-cli)
+- **License**: Apache License 2.0
+- **Primary Author**: **Kyunghoon Gwak (곽경훈)** — operating as [@hibou04-ops](https://github.com/hibou04-ops)
+  - Primary email: `hibouaile04@gmail.com` (verified, primary on the GitHub account; the Primary Author's only personal email)
+  - Note: some commits in the git history before 2026-04-29 carry `hibou04@gmail.com` in the author email field. That address is **not** an account belonging to the Primary Author — it was an unintended local git client misconfiguration. The author *name* `Hibou04-ops` is the unambiguous identifier across the entire history. From 2026-04-29 onwards every repository in this toolkit is configured to commit under `hibouaile04@gmail.com`.
+
+## Authorship Timeline (Tamper-Evident)
+
+The following git artifacts establish the authorship timeline. The git commit graph
+and the public GitHub remote (`github.com/hibou04-ops/mini-antemortem-cli`) provide
+independent timestamp witnesses.
+
+| Anchor | Commit Hash | Date (KST) | Description |
+|---|---|---|---|
+| First commit | `032d0a1` | 2026-04-22 | feat: initial release v0.1.0 — analytical preflight for omegaprompt |
+| Apache 2.0 relicense | `d2d7eb7` | 2026-04-22 | MIT → Apache 2.0 for patent grant + trademark preservation |
+| 0.2.0 release | `e72935e` | 2026-04-28 | License MIT->Apache 2.0 PyPI distribution alignment |
+| Pre-employment snapshot | (tagged on commit) | 2026-04-29 | This declaration committed; tagged `pre-employment-ip-snapshot-2026-04-29` |
+
+## Scope of Pre-existing IP
+
+The following work product is declared as pre-existing personal intellectual property:
+
+1. **Analytical Preflight Classifier**: A deterministic rule-based classifier
+   over seven calibration trap patterns:
+   - Self-agreement bias (target and judge from the same vendor)
+   - Small-sample KC-4 power
+   - Variant homogeneity
+   - Rubric concentration (single-dimension dominance)
+   - Judge budget (insufficient max_tokens for grading)
+   - Empty reference (held-out items missing reference outputs)
+   - Missing held-out slice (no walk-forward dataset)
+2. **Adapter Plumbing**: All code under `src/mini_antemortem_cli/` mapping
+   classifier outputs to omegaprompt's `AnalyticalFinding` contract.
+3. **Test Suite**: All materials under `tests/`.
+4. **Documentation**: README, EASY_README, EASY_README_KR, NOTICE.
+5. **Specific Terminology and Application**: The compound term "mini-antemortem-cli"
+   as a sub-tool name within the omegaprompt toolkit, applying the Antemortem
+   methodology authored by the same Primary Author in the companion repository.
+   *No claim is made to the generic word "antemortem" in isolation; the claim
+   is to the specific compound and its application within this corpus.*
+
+## Companion Repositories
+
+This repository is part of a multi-repo IP defense package authored by the same
+Primary Author:
+
+- [omegaprompt](https://github.com/hibou04-ops/omegaprompt) — parent calibration framework
+- [omega-lock](https://github.com/hibou04-ops/omega-lock) — sensitivity-driven coordinate descent calibration framework
+- [Antemortem](https://github.com/hibou04-ops/Antemortem) — pre-implementation reconnaissance methodology
+- [antemortem-cli](https://github.com/hibou04-ops/antemortem-cli) — CLI for the Antemortem methodology
+- [mini-omega-lock](https://github.com/hibou04-ops/mini-omega-lock) — empirical sibling preflight tool
+
+See each repository's `PRE_EXISTING_IP.md` for its own authorship binding.
+
+## Development Conditions
+
+This work was developed:
+
+- Using **personal time** (outside of any third-party working hours)
+- Using **personal equipment** (no employer-issued hardware)
+- Using **personal accounts** (no employer-issued cloud, LLM, or API credentials)
+- **Without reference** to any third party's confidential or proprietary information
+
+## Use in Future Employment Agreements
+
+This declaration is intended to be attached as a Schedule / Exhibit (commonly
+"Schedule A: Pre-existing IP") to any future employment, contractor, or
+consulting agreement, to clarify that:
+
+- The work in this repository remains the personal property of the Primary Author.
+- Future development on this codebase, conducted on personal time and outside the
+  scope of any employment, continues to be the Primary Author's personal IP.
+- Any contributions from a future employer's domain, made on employer time using
+  employer resources, would be governed by the relevant employment agreement —
+  the boundary is preserved by maintaining a separate repository, fork, or
+  branch for any such employer-domain contributions.
+
+## Verification
+
+To independently verify this declaration:
+
+1. Inspect git log:
+   ```
+   git log --format="%H | %ai | %an <%ae>" | grep "Hibou04-ops"
+   ```
+2. Confirm tag (when committed):
+   ```
+   git tag -l "pre-employment-ip-snapshot-*"
+   git show pre-employment-ip-snapshot-2026-04-29
+   ```
+3. Cross-reference with public GitHub timestamps:
+   - https://github.com/hibou04-ops/mini-antemortem-cli/commit/032d0a1
+   - https://github.com/hibou04-ops/mini-antemortem-cli/releases
+
+---
+
+**Declaration date**: 2026-04-29
+**License**: Apache License 2.0
+**Document version**: 1.0

mini_antemortem_cli-0.4.0/README.md

@@ -0,0 +1,170 @@
+# mini-antemortem-cli
+
+> **Analytical preflight for [omegaprompt](https://pypi.org/project/omegaprompt/) calibration.** Reads run config, classifies seven calibration-specific trap patterns against deterministic rules. **No API calls, no network** — reasoning is deterministic given inputs. Emits `AnalyticalFinding` records that feed omegaprompt's `derive_adaptation_plan`.
+
+[![CI](https://github.com/hibou04-ops/mini-antemortem-cli/actions/workflows/ci.yml/badge.svg)](https://github.com/hibou04-ops/mini-antemortem-cli/actions/workflows/ci.yml)
+[![PyPI](https://img.shields.io/badge/pypi-0.3.0-blue.svg)](https://pypi.org/project/mini-antemortem-cli/)
+[![License: Apache 2.0](https://img.shields.io/badge/license-Apache--2.0-blue.svg)](LICENSE)
+[![Python](https://img.shields.io/badge/python-3.11%2B-blue.svg)](https://www.python.org)
+[![Tests](https://img.shields.io/badge/tests-69%20passing-brightgreen.svg)](tests/)
+[![Parent](https://img.shields.io/badge/parent-omegaprompt%E2%89%A51.4.0-blueviolet.svg)](https://pypi.org/project/omegaprompt/)
+
+> **Part of the omegaprompt toolkit** — [omegaprompt](https://github.com/hibou04-ops/omegaprompt) (calibration engine) · [omega-lock](https://github.com/hibou04-ops/omega-lock) (audit framework) · [antemortem-cli](https://github.com/hibou04-ops/antemortem-cli) (pre-implementation recon CLI) · [mini-omega-lock](https://github.com/hibou04-ops/mini-omega-lock) (empirical preflight) · [mini-antemortem-cli](https://github.com/hibou04-ops/mini-antemortem-cli) (analytical preflight, this repo) · [Antemortem](https://github.com/hibou04-ops/Antemortem) (methodology). Cross-toolkit cookbook: [AGENT_TRIGGERS.md](https://github.com/hibou04-ops/omegaprompt/blob/main/AGENT_TRIGGERS.md).
+
+```bash
+pip install omegaprompt mini-antemortem-cli
+```
+
+**MCP server.** This package also exposes its analytical classifier as agent-callable MCP tools (`analytical_preflight`, `list_traps`). Run `pip install "mini-antemortem-cli[mcp]"` then `python -m mini_antemortem_cli.mcp` (stdio, default for Claude Code). Deterministic, zero LLM cost. See [AGENT_TRIGGERS.md scenario 2](https://github.com/hibou04-ops/omegaprompt/blob/main/AGENT_TRIGGERS.md#scenario-2--pre-calibration-sanity-check).
+
+---
+
+## TL;DR
+
+`omegaprompt` ships a **plugin interface** for preflight (`omegaprompt.preflight.contracts` + `omegaprompt.preflight.adaptation`) but no classifier code. This package fills that gap with seven deterministic trap classifiers — fully offline, fully reproducible:
+
+- **`self_agreement_bias`** — target and judge share a vendor; judge biases overlap with target.
+- **`small_sample_kc4_power`** — dataset too small for Pearson correlation to carry statistical power.
+- **`variants_homogeneous`** — system-prompt variants too similar for sensitivity to have signal.
+- **`rubric_weight_concentration`** — single rubric dimension carries most of the weight.
+- **`judge_budget_too_small`** — judge output budget is SMALL but rubric has many dimensions + gates.
+- **`empty_reference_with_strict_rubric`** — no dataset item has a reference; rubric implies ground-truth comparison.
+- **`no_held_out_slice`** — no `--test` slice; walk-forward cannot run.
+
+Each pattern returns `REAL` / `GHOST` / `NEW` / `UNRESOLVED` with a severity (`blocker` / `high` / `medium` / `low`) and a remediation hint.
+
+> **Looking for the empirical (LLM-probe) preflight?** See sibling tool [`mini-omega-lock`](https://pypi.org/project/mini-omega-lock/) — same plugin interface, runs actual provider calls instead of static analysis.
+
+---
+
+## Quick start (1-minute, fully offline)
+
+```python
+from omegaprompt.domain.dataset import Dataset, DatasetItem
+from omegaprompt.domain.judge import Dimension, HardGate, JudgeRubric
+from omegaprompt.domain.params import PromptVariants
+from omegaprompt.preflight import PreflightReport, derive_adaptation_plan
+from mini_antemortem_cli import analytical_preflight
+
+# Your run config
+rubric = JudgeRubric(
+    dimensions=[Dimension(name="accuracy", description="x", weight=1.0)],
+    hard_gates=[HardGate(name="no_violation", description="y", evaluator="judge")],
+)
+train = Dataset(items=[DatasetItem(id="ex1", input="2+2", reference="4")])
+test  = Dataset(items=[DatasetItem(id="ex2", input="3+3", reference="6")])
+variants = PromptVariants(system_prompts=["You are an assistant."], few_shot_examples=[])
+
+# Run all seven trap classifiers — fully offline, fully deterministic.
+# (Every keyword is required — analytical_preflight does not infer
+# target_provider / judge_provider from the dataset.)
+findings = analytical_preflight(
+    target_provider="anthropic",
+    target_model="claude-opus-4-7",
+    judge_provider="openai",
+    judge_model="gpt-4.1",
+    train_dataset=train,
+    test_dataset=test,                  # optional but strongly recommended
+    rubric=rubric,
+    variants=variants,
+    judge_output_budget="small",        # "small" | "medium" | "large"
+)
+
+for f in findings:
+    print(f"{f.trap_id}: {f.label} / {f.severity}")
+
+# Feed into omegaprompt's adaptation layer
+report = PreflightReport(analytical_findings=findings)
+plan = derive_adaptation_plan(report)
+print(plan.recommendations)
+```
+
+No API keys, no network, no LLM calls — output is fully reproducible given inputs.
+
+> 👋 Simpler intro: [EASY_README.md](EASY_README.md) (English) · [EASY_README_KR.md](EASY_README_KR.md)
+
+---
+
+## Why this is separate from omegaprompt
+
+`omegaprompt` ships a **plugin interface** (`omegaprompt.preflight.contracts` + `omegaprompt.preflight.adaptation`) but no classifier code. Standalone users do not need analytical preflight — the main pipeline runs with declared defaults. Users who want analytical risk assessment over their configuration install this package alongside:
+
+```bash
+pip install omegaprompt mini-antemortem-cli
+```
+
+## Trap patterns
+
+Seven deterministic classifications run against the run config:
+
+| Trap id | Hypothesis |
+|---|---|
+| `self_agreement_bias` | Target and judge share a vendor; judge's biases overlap with target. |
+| `small_sample_kc4_power` | Dataset too small for Pearson correlation to carry statistical power. |
+| `variants_homogeneous` | System-prompt variants are too similar for sensitivity to have signal. |
+| `rubric_weight_concentration` | A single rubric dimension carries most of the weight. |
+| `judge_budget_too_small` | Judge output budget is SMALL but rubric has many dimensions + gates. |
+| `empty_reference_with_strict_rubric` | No dataset item has a reference; rubric implies ground-truth comparison. |
+| `no_held_out_slice` | No `--test` slice; walk-forward cannot run. |
+
+Each pattern returns one of `REAL` / `GHOST` / `NEW` / `UNRESOLVED` with a severity (`blocker` / `high` / `medium` / `low`) and a remediation hint.
+
+## Usage
+
+```python
+from omegaprompt.domain.dataset import Dataset, DatasetItem
+from omegaprompt.domain.judge import Dimension, HardGate, JudgeRubric
+from omegaprompt.domain.params import PromptVariants
+from omegaprompt.preflight import PreflightReport, derive_adaptation_plan
+from mini_antemortem_cli import analytical_preflight
+
+rubric = JudgeRubric(
+    dimensions=[
+        Dimension(name="accuracy", description="correct", weight=0.85),
+        Dimension(name="clarity",  description="readable", weight=0.15),
+    ],
+    hard_gates=[HardGate(name="no_refusal", description="x", evaluator="judge")],
+)
+variants = PromptVariants(system_prompts=["You are an assistant."], few_shot_examples=[])
+train = Dataset(items=[DatasetItem(id=f"t{i}", input=f"task {i}") for i in range(5)])
+test = Dataset(items=[DatasetItem(id=f"v{i}", input=f"val {i}") for i in range(3)])
+
+findings = analytical_preflight(
+    target_provider="openai",
+    target_model="gpt-4o-mini",
+    judge_provider="openai",
+    judge_model="gpt-4o-mini",
+    train_dataset=train,
+    test_dataset=test,
+    rubric=rubric,
+    variants=variants,
+    judge_output_budget="small",
+)
+
+report = PreflightReport(analytical_findings=findings)
+plan = derive_adaptation_plan(report=report)
+# plan.skip_axes, plan.max_gap_override, etc.
+```
+
+## Design principles
+
+- **Deterministic.** Same config in, same findings out. No LLM calls; no sampling noise.
+- **Source-level citations.** Each finding carries a `note` describing the rule that fired and a `remediation` hint. No hand-wave.
+- **Severity discipline.** `high` severity findings drive `AdaptationPlan` overrides that *only strengthen* the discipline (per `apply_adaptation_plan` invariants).
+- **Extensible.** Add your own `TrapPattern` and classifier function; compose with the built-in seven.
+
+## Validation
+
+Every trap pattern has positive + negative test cases. No API calls, fully offline. Run with `pytest -q`.
+
+## Relation to the family
+
+- **[Antemortem](https://github.com/hibou04-ops/Antemortem)** / **[antemortem-cli](https://pypi.org/project/antemortem/)** — pre-implementation reconnaissance discipline for code changes. The naming "mini-antemortem-cli" echoes this family; the *enumerate-then-classify* pattern comes from there.
+- **[omegaprompt](https://pypi.org/project/omegaprompt/)** — prompt calibration engine. This package feeds its preflight plugin interface.
+- **[mini-omega-lock](https://pypi.org/project/mini-omega-lock/)** — empirical sibling. Runs live probes to measure judge consistency and endpoint reliability.
+
+## License
+
+Apache 2.0. See [LICENSE](LICENSE).
+
+**License history.** PyPI distributions of version 0.1.0 were shipped with an MIT `LICENSE` file. The repository was relicensed to Apache 2.0 on 2026-04-22 (commit `d2d7eb7`); 0.2.0 (2026-04-28) and all later versions ship under Apache 2.0. Anyone who installed 0.1.0 holds an MIT license to that copy — license changes do not apply retroactively.

{mini_antemortem_cli-0.2.0 → mini_antemortem_cli-0.4.0}/pyproject.toml

@@ -1,63 +1,71 @@
-[build-system]
-requires = ["hatchling"]
-build-backend = "hatchling.build"
-
-[project]
-name = "mini-antemortem-cli"
-version = "0.2.0"
-description = "Analytical preflight for omegaprompt calibration: deterministic classifier over seven calibration trap patterns (self-agreement bias, small-sample KC-4 power, variant homogeneity, rubric concentration, judge budget, empty reference, missing held-out slice). Emits AnalyticalFinding records the omegaprompt pipeline consumes via derive_adaptation_plan."
-readme = "README.md"
-requires-python = ">=3.11"
-license = { file = "LICENSE" }
-authors = [
-    { name = "hibou04-ops" },
-]
-keywords = [
-    "prompt-calibration",
-    "preflight",
-    "antemortem",
-    "analytical-audit",
-    "omegaprompt",
-    "omega-lock",
-]
-classifiers = [
-    "Development Status :: 3 - Alpha",
-    "Intended Audience :: Developers",
-    "License :: OSI Approved :: Apache Software License",
-    "Operating System :: OS Independent",
-    "Programming Language :: Python :: 3",
-    "Programming Language :: Python :: 3.11",
-    "Programming Language :: Python :: 3.12",
-    "Topic :: Scientific/Engineering :: Artificial Intelligence",
-]
-dependencies = [
-    "omegaprompt>=1.1.0",
-    "pydantic>=2.6.0",
-]
-
-[project.optional-dependencies]
-dev = [
-    "pytest>=8.0.0",
-]
-
-[project.urls]
-Homepage = "https://github.com/hibou04-ops/mini-antemortem-cli"
-Repository = "https://github.com/hibou04-ops/mini-antemortem-cli"
-"Parent package" = "https://github.com/hibou04-ops/omegaprompt"
-Issues = "https://github.com/hibou04-ops/mini-antemortem-cli/issues"
-
-[tool.hatch.build.targets.wheel]
-packages = ["src/mini_antemortem_cli"]
-
-[tool.hatch.build.targets.sdist]
-include = [
-    "src/mini_antemortem_cli",
-    "README.md",
-    "LICENSE",
-    "pyproject.toml",
-]
-
-[tool.pytest.ini_options]
-testpaths = ["tests"]
-python_files = ["test_*.py"]
-addopts = "-ra -q"
+[build-system]
+requires = ["hatchling"]
+build-backend = "hatchling.build"
+
+[project]
+name = "mini-antemortem-cli"
+version = "0.4.0"
+description = "Analytical preflight for omegaprompt calibration: deterministic classifier over seven calibration trap patterns (self-agreement bias, small-sample KC-4 power, variant homogeneity, rubric concentration, judge budget, empty reference, missing held-out slice). Emits AnalyticalFinding records the omegaprompt pipeline consumes via derive_adaptation_plan."
+readme = "README.md"
+requires-python = ">=3.11"
+license = { file = "LICENSE" }
+authors = [
+    { name = "hibou04-ops" },
+]
+keywords = [
+    "prompt-calibration",
+    "preflight",
+    "antemortem",
+    "analytical-audit",
+    "omegaprompt",
+    "omega-lock",
+]
+classifiers = [
+    "Development Status :: 3 - Alpha",
+    "Intended Audience :: Developers",
+    "License :: OSI Approved :: Apache Software License",
+    "Operating System :: OS Independent",
+    "Programming Language :: Python :: 3",
+    "Programming Language :: Python :: 3.11",
+    "Programming Language :: Python :: 3.12",
+    "Topic :: Scientific/Engineering :: Artificial Intelligence",
+]
+dependencies = [
+    "omegaprompt>=1.1.0",
+    "pydantic>=2.6.0",
+]
+
+[project.optional-dependencies]
+dev = [
+    "pytest>=8.0.0",
+]
+mcp = ["mcp>=1.0.0"]
+
+[project.scripts]
+mini-antemortem-cli = "mini_antemortem_cli.cli:main"
+mini-antemortem-cli-mcp = "mini_antemortem_cli.mcp.__main__:main"
+
+[project.urls]
+Homepage = "https://github.com/hibou04-ops/mini-antemortem-cli"
+Repository = "https://github.com/hibou04-ops/mini-antemortem-cli"
+"Parent package" = "https://github.com/hibou04-ops/omegaprompt"
+Issues = "https://github.com/hibou04-ops/mini-antemortem-cli/issues"
+
+[tool.hatch.build.targets.wheel]
+packages = ["src/mini_antemortem_cli"]
+
+[tool.hatch.build.targets.sdist]
+include = [
+    "src/mini_antemortem_cli",
+    "README.md",
+    "LICENSE",
+    "NOTICE",
+    "AUTHORS.md",
+    "PRE_EXISTING_IP.md",
+    "pyproject.toml",
+]
+
+[tool.pytest.ini_options]
+testpaths = ["tests"]
+python_files = ["test_*.py"]
+addopts = "-ra -q"

{mini_antemortem_cli-0.2.0 → mini_antemortem_cli-0.4.0}/src/mini_antemortem_cli/__init__.py

@@ -33,16 +33,20 @@ used alone; both compose into the same ``PreflightReport``.
 from mini_antemortem_cli.traps import (
     CALIBRATION_TRAPS,
     TrapPattern,
+    TrapPolicy,
     analytical_preflight,
     analytical_traps,
+    summarize_findings,
 )
 
-__version__ = "0.2.0"
+__version__ = "0.4.0"
 
 __all__ = [
     "CALIBRATION_TRAPS",
     "TrapPattern",
+    "TrapPolicy",
     "analytical_preflight",
     "analytical_traps",
+    "summarize_findings",
     "__version__",
 ]