crapkit 0.7.2__tar.gz → 0.7.3__tar.gz

{crapkit-0.7.2/src/crapkit.egg-info → crapkit-0.7.3}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: crapkit
-Version: 0.7.2
+Version: 0.7.3
 Summary: Scores every function on complexity times uncovered risk, ranks the worst, and blocks commits that add more.
 Author: Jean-Francois Gagne
 License: MIT
@@ -199,7 +199,7 @@ files. Review those commands before running Crapkit in a repository you do not t
 
 ```
 $ crapkit --version
-crapkit 0.7.2
+crapkit 0.7.3
 ```
 
 `python -m crapkit` works identically to the console script and is what to use from a
@@ -455,7 +455,7 @@ crapkit ships a `.pre-commit-hooks.yaml` declaring `id: crapkit-gate`. In your
 repos:
   - repo: https://github.com/JeanFrancoisGagne/crapkit
     # crapkit's release step rewrites this line to the tag it just cut
-    rev: v0.7.2
+    rev: v0.7.3
     hooks:
       - id: crapkit-gate
 ```
@@ -563,7 +563,7 @@ to a workflow, and every input has a default:
       - uses: actions/checkout@v4
         with:
           fetch-depth: 0
-      - uses: JeanFrancoisGagne/crapkit@v0.7.2
+      - uses: JeanFrancoisGagne/crapkit@v0.7.3
 ```
 
 The whole job those four lines sit in:
@@ -583,7 +583,7 @@ jobs:
         with:
           python-version: "3.12"       # the interpreter the install below lands in
       - run: pip install -e ".[dev]"   # whatever your lanes need to run
-      - uses: JeanFrancoisGagne/crapkit@v0.7.2
+      - uses: JeanFrancoisGagne/crapkit@v0.7.3
         with:
           gate: "false"
 ```

{crapkit-0.7.2 → crapkit-0.7.3}/README.md

@@ -158,7 +158,7 @@ files. Review those commands before running Crapkit in a repository you do not t
 
 ```
 $ crapkit --version
-crapkit 0.7.2
+crapkit 0.7.3
 ```
 
 `python -m crapkit` works identically to the console script and is what to use from a
@@ -414,7 +414,7 @@ crapkit ships a `.pre-commit-hooks.yaml` declaring `id: crapkit-gate`. In your
 repos:
   - repo: https://github.com/JeanFrancoisGagne/crapkit
     # crapkit's release step rewrites this line to the tag it just cut
-    rev: v0.7.2
+    rev: v0.7.3
     hooks:
       - id: crapkit-gate
 ```
@@ -522,7 +522,7 @@ to a workflow, and every input has a default:
       - uses: actions/checkout@v4
         with:
           fetch-depth: 0
-      - uses: JeanFrancoisGagne/crapkit@v0.7.2
+      - uses: JeanFrancoisGagne/crapkit@v0.7.3
 ```
 
 The whole job those four lines sit in:
@@ -542,7 +542,7 @@ jobs:
         with:
           python-version: "3.12"       # the interpreter the install below lands in
       - run: pip install -e ".[dev]"   # whatever your lanes need to run
-      - uses: JeanFrancoisGagne/crapkit@v0.7.2
+      - uses: JeanFrancoisGagne/crapkit@v0.7.3
         with:
           gate: "false"
 ```

{crapkit-0.7.2 → crapkit-0.7.3}/pyproject.toml

@@ -4,7 +4,7 @@ build-backend = "setuptools.build_meta"
 
 [project]
 name = "crapkit"
-version = "0.7.2"
+version = "0.7.3"
 description = "Scores every function on complexity times uncovered risk, ranks the worst, and blocks commits that add more."
 readme = { file = "README.md", content-type = "text/markdown" }
 license = { text = "MIT" }

{crapkit-0.7.2 → crapkit-0.7.3}/src/crapkit/__init__.py

@@ -1,2 +1,2 @@
 """crapkit: deterministic CRAP-score framework."""
-__version__ = "0.7.2"
+__version__ = "0.7.3"

{crapkit-0.7.2 → crapkit-0.7.3}/src/crapkit/cli/scoring.py

@@ -540,12 +540,25 @@ def _rescored_records(root: Path, cache_path: Path, flat: list,
     return records_by_path
 
 
+def _refuse_missing(root: Path, rel_paths: list) -> None:
+    """A path crapkit cannot open is refused the way one it cannot place is.
+
+    Unchecked, a typo reached the analyzer and came back as a FileNotFoundError
+    traceback with exit 1; through the MCP server that traceback was the whole
+    answer. A config error says which path, and exits 3 like every other
+    argument the command cannot act on."""
+    missing = [rel for rel in rel_paths if not (root / rel).exists()]
+    if missing:
+        raise ConfigError(f"{', '.join(missing)} does not exist under {root}")
+
+
 def _rescore_analyze(root: Path, cfg, files, cwd: Path | None = None) -> tuple[list, list, dict]:
     """Fresh complexity for the named files, said from `cwd` where the user
     stands; the shared cache is merged, never truncated."""
     from ..hook import file_ceilings
 
     rel_paths = sorted({_repo_relative(p, root, cwd) for p in files})
+    _refuse_missing(root, rel_paths)
     files_by_scope = assign_files(rel_paths, cfg, size_of=_file_sizer(root))
     flat = sorted(set().union(*files_by_scope.values())) if files_by_scope else []
     records_by_path = _rescored_records(root, root / ".crapkit" / "cache.json", flat,

{crapkit-0.7.2 → crapkit-0.7.3}/src/crapkit/cli/verifying.py

@@ -558,6 +558,20 @@ def _ratchet_suffix(changes: dict | None, overridden: list, ratchet_file: str) -
     return f" ratchet: {_marks_moved(changes)} -> git add {ratchet_file}"
 
 
+def _forgiven_suffix(out: dict) -> str:
+    """Failures this verdict forgives because the baseline carries them too.
+
+    A regression verdict is about change, so an unchanged failure is not a
+    regression. Saying nothing about it made `verify OK` read as a clean suite
+    beside three failing tests, and the release guard downstream, which does not
+    forgive them, then refused evidence the operator had just watched pass."""
+    forgiven = out.get("forgiven_failures") or ()
+    if not forgiven:
+        return ""
+    plural = "" if len(forgiven) == 1 else "s"
+    return f" ({len(forgiven)} unchanged failure{plural} forgiven, first {forgiven[0]})"
+
+
 def _report_verify(as_json: bool, out: dict, verdict, overridden, ratchet_file: str) -> None:
     if as_json:
         _print_json(out)
@@ -565,6 +579,7 @@ def _report_verify(as_json: bool, out: dict, verdict, overridden, ratchet_file:
     state = "OK" if verdict.ok else "FAILED"
     print(f"verify {state} @ {out['commit'][:11]} vs baseline {out['baseline_commit'][:11]} "
           f"({out['changed_files']} changed files)"
+          f"{_forgiven_suffix(out)}"
           f"{_ratchet_suffix(out['ratchet_changes'], overridden, ratchet_file)}")
     _print_verify_findings(verdict, overridden)
     _print_finding_split(verdict)
@@ -649,7 +664,8 @@ def cmd_verify(args: argparse.Namespace) -> int:
     _report_verify(args.json,
                    {**_verify_result(verdict, overridden, run_id, baseline, commit, ranges,
                                      uncovered, cfg.diff_uncovered_max, len(unmarked)),
-                    **_receipt(tool_versions, saved.sha256, changes)},
+                    **_receipt(tool_versions, saved.sha256, changes),
+                    "forgiven_failures": sorted(set(fresh_failures) - set(verdict.new_failures))},
                    verdict, overridden, cfg.ratchet_file)
     _refuse_override(verdict, args.override)
     return _verify_exit_code(verdict)

{crapkit-0.7.2 → crapkit-0.7.3}/src/crapkit/mcp_server.py

@@ -294,11 +294,13 @@ TOOLS: tuple[dict, ...] = (
         "positional": (),
         "flags": {},
         "description": ("Lists every run in the store, oldest first by id. Use it to date the store "
-        "or to see which commit the other tools answer from, get_trend for per-run "
-        "totals, and get_function_history for one function's scores per run. It reads "
-        "the store only and spawns no git, and baseline true is not always the newest "
-        "run. repo can be any directory under a measured checkout, and an unmeasured "
-        "one answers isError true with the setup pointer."),
+        "or to see which commit the other tools answer from. Use get_trend for "
+        "per-run totals and get_function_history for one function's scores per run. "
+        "It reads the store only and spawns no git. repo may be any directory under "
+        "the checkout, because the server walks up to the nearest crapkit.toml, and a "
+        "relative path resolves from the server's start directory. No crapkit.toml "
+        "above it answers an init pointer, and a checkout never scored answers a "
+        "coverage pointer, both as isError true."),
         "properties": {},
         "output": {
             "schema": {
@@ -1278,13 +1280,14 @@ TOOLS: tuple[dict, ...] = (
         "positional": ("path",),
         "flags": {},
         "verdict_exits": (6,),
-        "description": ("Checks whether an edited file clears the commit gate as the hook will: fresh "
-        "ccn per changed function against its scope's ceiling, less pardoned debt. "
-        "Call it after an edit, once get_function_brief has stated the rule, and "
-        "leave the repo-wide verdict to CLI verify. It re-measures ccn off git diff, "
-        "runs no tests, and answers a breach as gate.ok false, not a tool error. path "
-        "is repo-relative and repo must hold it: a tracked file is judged on its diff "
-        "from HEAD, an untracked one in full, an unchanged one judges 0."),
+        "description": ("Checks whether an edited file clears the hook's commit gate: fresh ccn per "
+        "changed function against its scope's ceiling less pardoned ratchet debt. "
+        "Call it after an edit once get_function_brief states the rule. CLI verify "
+        "gives the repo-wide verdict. It runs no tests, and a breach reads gate.ok "
+        "false, not an error. path is repo-relative or absolute inside repo, outside "
+        "or missing is a config error. A tracked file is judged on its diff from "
+        "HEAD, an untracked one in full, an unchanged or unscoped one judges 0. repo "
+        "may be any directory under the checkout."),
         "properties": {
             "path": {
                 "type": "string",
@@ -1415,12 +1418,13 @@ TOOLS: tuple[dict, ...] = (
         "positional": (),
         "flags": {},
         "description": ("Lists open claims on queue items, oldest first. Use it when get_next_item "
-        "answers empty or skipped_claimed above 0, and get_function_brief's attempts "
-        "for one function. No tool here writes a claim by design, so a stale one is "
-        "released in the CLI with crapkit claims release PATH NAME, and one closes "
-        "when verify finds the function at its ceiling. repo may be any directory "
-        "under a checkout where crapkit init and crapkit coverage have run, and an "
-        "unmeasured one answers isError true with the setup pointer."),
+        "answers empty or skipped_claimed above 0, and use get_function_brief to see "
+        "one function's own attempts. No tool here writes a claim: the CLI releases a "
+        "stale one with crapkit claims release PATH NAME, and verify closes one at "
+        "the ceiling. repo may be any directory under the checkout, since the server "
+        "walks up to the nearest crapkit.toml. No crapkit.toml above it answers an "
+        "init pointer, and a checkout never scored answers a coverage pointer, both "
+        "as isError true."),
         "properties": {},
         "output": {
             "schema": {

{crapkit-0.7.2 → crapkit-0.7.3/src/crapkit.egg-info}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: crapkit
-Version: 0.7.2
+Version: 0.7.3
 Summary: Scores every function on complexity times uncovered risk, ranks the worst, and blocks commits that add more.
 Author: Jean-Francois Gagne
 License: MIT
@@ -199,7 +199,7 @@ files. Review those commands before running Crapkit in a repository you do not t
 
 ```
 $ crapkit --version
-crapkit 0.7.2
+crapkit 0.7.3
 ```
 
 `python -m crapkit` works identically to the console script and is what to use from a
@@ -455,7 +455,7 @@ crapkit ships a `.pre-commit-hooks.yaml` declaring `id: crapkit-gate`. In your
 repos:
   - repo: https://github.com/JeanFrancoisGagne/crapkit
     # crapkit's release step rewrites this line to the tag it just cut
-    rev: v0.7.2
+    rev: v0.7.3
     hooks:
       - id: crapkit-gate
 ```
@@ -563,7 +563,7 @@ to a workflow, and every input has a default:
       - uses: actions/checkout@v4
         with:
           fetch-depth: 0
-      - uses: JeanFrancoisGagne/crapkit@v0.7.2
+      - uses: JeanFrancoisGagne/crapkit@v0.7.3
 ```
 
 The whole job those four lines sit in:
@@ -583,7 +583,7 @@ jobs:
         with:
           python-version: "3.12"       # the interpreter the install below lands in
       - run: pip install -e ".[dev]"   # whatever your lanes need to run
-      - uses: JeanFrancoisGagne/crapkit@v0.7.2
+      - uses: JeanFrancoisGagne/crapkit@v0.7.3
         with:
           gate: "false"
 ```