codapact 0.1.0__tar.gz → 0.2.0__tar.gz

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
Files changed (82) hide show
  1. codapact-0.2.0/.github/workflows/codeql.yml +35 -0
  2. {codapact-0.1.0 → codapact-0.2.0}/.github/workflows/mutation.yml +2 -2
  3. codapact-0.2.0/.release-please-manifest.json +1 -0
  4. codapact-0.2.0/CHANGELOG.md +47 -0
  5. {codapact-0.1.0 → codapact-0.2.0}/PKG-INFO +13 -1
  6. {codapact-0.1.0 → codapact-0.2.0}/README.md +12 -0
  7. {codapact-0.1.0 → codapact-0.2.0}/docs/architecture.md +12 -2
  8. {codapact-0.1.0 → codapact-0.2.0}/docs/configuration.md +8 -0
  9. codapact-0.2.0/docs/mutation-review-ab121cb.json +427 -0
  10. {codapact-0.1.0 → codapact-0.2.0}/docs/mutation.md +37 -2
  11. codapact-0.2.0/docs/security.md +35 -0
  12. codapact-0.2.0/docs/selection.md +176 -0
  13. {codapact-0.1.0 → codapact-0.2.0}/docs/support.md +23 -0
  14. {codapact-0.1.0 → codapact-0.2.0}/docs/verification.md +10 -0
  15. codapact-0.2.0/examples/domains.openapi.yaml +109 -0
  16. codapact-0.2.0/examples/pets-read.cli.yaml +6 -0
  17. codapact-0.2.0/examples/pets-read.codapact.yaml +19 -0
  18. {codapact-0.1.0 → codapact-0.2.0}/pyproject.toml +1 -1
  19. {codapact-0.1.0 → codapact-0.2.0}/pyproject.toml.orig +1 -1
  20. {codapact-0.1.0 → codapact-0.2.0}/scripts/mutation_alerts.py +38 -4
  21. codapact-0.2.0/src/codapact/__init__.py +3 -0
  22. {codapact-0.1.0 → codapact-0.2.0}/src/codapact/__main__.py +31 -7
  23. codapact-0.2.0/src/codapact/auth.py +68 -0
  24. {codapact-0.1.0 → codapact-0.2.0}/src/codapact/cli.py +6 -6
  25. {codapact-0.1.0 → codapact-0.2.0}/src/codapact/configuration.py +4 -1
  26. {codapact-0.1.0 → codapact-0.2.0}/src/codapact/generation.py +18 -2
  27. {codapact-0.1.0 → codapact-0.2.0}/src/codapact/loading.py +14 -0
  28. {codapact-0.1.0 → codapact-0.2.0}/src/codapact/model.py +38 -2
  29. {codapact-0.1.0 → codapact-0.2.0}/src/codapact/net.py +10 -4
  30. {codapact-0.1.0 → codapact-0.2.0}/src/codapact/openapi.py +11 -1
  31. {codapact-0.1.0 → codapact-0.2.0}/src/codapact/profiles.py +6 -2
  32. {codapact-0.1.0 → codapact-0.2.0}/src/codapact/project.py +57 -21
  33. {codapact-0.1.0 → codapact-0.2.0}/src/codapact/runtime.py +21 -123
  34. codapact-0.2.0/src/codapact/schemas/generation.v1.json +227 -0
  35. codapact-0.2.0/src/codapact/selection.py +198 -0
  36. codapact-0.2.0/src/codapact/validation.py +67 -0
  37. codapact-0.2.0/tests/__init__.py +1 -0
  38. codapact-0.2.0/tests/assertions.py +15 -0
  39. {codapact-0.1.0 → codapact-0.2.0}/tests/conftest.py +42 -6
  40. {codapact-0.1.0 → codapact-0.2.0}/tests/test_adversarial.py +11 -10
  41. {codapact-0.1.0 → codapact-0.2.0}/tests/test_configuration.py +40 -20
  42. {codapact-0.1.0 → codapact-0.2.0}/tests/test_distribution.py +8 -1
  43. codapact-0.2.0/tests/test_entrypoint.py +75 -0
  44. codapact-0.2.0/tests/test_generated_contracts.py +746 -0
  45. {codapact-0.1.0 → codapact-0.2.0}/tests/test_generation.py +60 -11
  46. codapact-0.2.0/tests/test_loading.py +244 -0
  47. {codapact-0.1.0 → codapact-0.2.0}/tests/test_mutation_alerts.py +86 -0
  48. codapact-0.2.0/tests/test_mutation_contracts.py +1281 -0
  49. codapact-0.2.0/tests/test_net.py +272 -0
  50. {codapact-0.1.0 → codapact-0.2.0}/tests/test_openapi.py +3 -2
  51. codapact-0.2.0/tests/test_reference_text_budget.py +34 -0
  52. codapact-0.2.0/tests/test_residual_contracts.py +137 -0
  53. {codapact-0.1.0 → codapact-0.2.0}/tests/test_runtime.py +18 -17
  54. codapact-0.2.0/tests/test_selection.py +248 -0
  55. codapact-0.2.0/tests/test_selection_generation.py +377 -0
  56. {codapact-0.1.0 → codapact-0.2.0}/uv.lock +1 -1
  57. codapact-0.1.0/.release-please-manifest.json +0 -1
  58. codapact-0.1.0/CHANGELOG.md +0 -14
  59. codapact-0.1.0/src/codapact/__init__.py +0 -3
  60. codapact-0.1.0/src/codapact/schemas/generation.v1.json +0 -57
  61. codapact-0.1.0/tests/test_entrypoint.py +0 -41
  62. codapact-0.1.0/tests/test_loading.py +0 -82
  63. codapact-0.1.0/tests/test_net.py +0 -100
  64. {codapact-0.1.0 → codapact-0.2.0}/.github/workflows/ci.yml +0 -0
  65. {codapact-0.1.0 → codapact-0.2.0}/.github/workflows/mutation-alerts.yml +0 -0
  66. {codapact-0.1.0 → codapact-0.2.0}/.github/workflows/release.yml +0 -0
  67. {codapact-0.1.0 → codapact-0.2.0}/LICENSE +0 -0
  68. {codapact-0.1.0 → codapact-0.2.0}/branding/mark.svg +0 -0
  69. {codapact-0.1.0 → codapact-0.2.0}/branding/wordmark.svg +0 -0
  70. {codapact-0.1.0 → codapact-0.2.0}/docs/branding.md +0 -0
  71. {codapact-0.1.0 → codapact-0.2.0}/docs/releasing.md +0 -0
  72. {codapact-0.1.0 → codapact-0.2.0}/examples/cli.json +0 -0
  73. {codapact-0.1.0 → codapact-0.2.0}/examples/pets.codapact.yaml +0 -0
  74. {codapact-0.1.0 → codapact-0.2.0}/examples/pets.yaml +0 -0
  75. {codapact-0.1.0 → codapact-0.2.0}/examples/runtime.json +0 -0
  76. {codapact-0.1.0 → codapact-0.2.0}/release-please-config.json +0 -0
  77. {codapact-0.1.0 → codapact-0.2.0}/schemas/cli.v1.schema.json +0 -0
  78. {codapact-0.1.0 → codapact-0.2.0}/scripts/mutation_report.py +0 -0
  79. {codapact-0.1.0 → codapact-0.2.0}/scripts/verify_dist.py +0 -0
  80. {codapact-0.1.0 → codapact-0.2.0}/src/codapact/errors.py +0 -0
  81. {codapact-0.1.0 → codapact-0.2.0}/src/codapact/py.typed +0 -0
  82. {codapact-0.1.0 → codapact-0.2.0}/src/codapact/values.py +0 -0
@@ -0,0 +1,35 @@
1
+ name: CodeQL
2
+ on:
3
+ pull_request:
4
+ push:
5
+ branches: [main]
6
+ schedule:
7
+ - cron: '23 6 * * 1'
8
+ workflow_dispatch:
9
+ permissions:
10
+ contents: read
11
+ concurrency:
12
+ group: codeql-${{ github.event.pull_request.number || github.ref }}
13
+ cancel-in-progress: true
14
+ jobs:
15
+ analyze:
16
+ name: Analyze (${{ matrix.language }})
17
+ runs-on: ubuntu-latest
18
+ permissions:
19
+ contents: read
20
+ security-events: write
21
+ strategy:
22
+ fail-fast: false
23
+ matrix:
24
+ language: [python, actions]
25
+ steps:
26
+ - uses: actions/checkout@3d3c42e5aac5ba805825da76410c181273ba90b1 # v7.0.1
27
+ with:
28
+ persist-credentials: false
29
+ - uses: github/codeql-action/init@2892aa5e19bbd11bc0cff5427e3b750a04d9e3c2 # v4.38.2
30
+ with:
31
+ languages: ${{ matrix.language }}
32
+ queries: security-and-quality
33
+ - uses: github/codeql-action/analyze@2892aa5e19bbd11bc0cff5427e3b750a04d9e3c2 # v4.38.2
34
+ with:
35
+ category: /language:${{ matrix.language }}
@@ -20,7 +20,7 @@ jobs:
20
20
  needs: validate-ref
21
21
  if: github.ref == 'refs/heads/main'
22
22
  runs-on: ubuntu-latest
23
- timeout-minutes: 25
23
+ timeout-minutes: 40
24
24
  steps:
25
25
  - uses: actions/checkout@3d3c42e5aac5ba805825da76410c181273ba90b1 # v7.0.1
26
26
  with:
@@ -34,7 +34,7 @@ jobs:
34
34
  run: |
35
35
  mkdir -p mutation-report
36
36
  set +e
37
- timeout --signal=TERM --kill-after=10s 18m uv run --group mutation mutmut run --max-children 2 > mutation-report/run.log 2>&1
37
+ timeout --signal=TERM --kill-after=10s 30m uv run --group mutation mutmut run --max-children 2 > mutation-report/run.log 2>&1
38
38
  code=$?
39
39
  uv run --group mutation mutmut export-cicd-stats >> mutation-report/run.log 2>&1
40
40
  uv run --group mutation mutmut results --all true > mutation-report/results.txt 2>&1
@@ -0,0 +1 @@
1
+ {".":"0.2.0"}
@@ -0,0 +1,47 @@
1
+ # Changelog
2
+
3
+ <!-- markdownlint-configure-file { "MD024": { "siblings_only": true } } -->
4
+
5
+ ## [0.2.0](https://github.com/mikejhill/codapact/compare/v0.1.1...v0.2.0) (2026-10-29)
6
+
7
+ ### Features
8
+
9
+ * Generate the same specialized endpoint subset for typed clients and CLI wrappers, using
10
+ operation IDs, method names, path globs, and domain tags with explicit include/exclude rules.
11
+ * Add versioned generation settings, CLI overrides, an owned selection report, and dry-run
12
+ generation/ownership preflight without output writes.
13
+ * Preserve selected nested schema dependencies and authentication requirements, stable CLI
14
+ renames, deterministic regeneration, and unrelated user files.
15
+ * Provide a GET/HEAD/OPTIONS read preset and runnable domain profiles. Method selection is
16
+ not a safety guarantee or server authorization control.
17
+
18
+ Implemented in [PR #16](https://github.com/mikejhill/codapact/pull/16).
19
+
20
+ ## [0.1.1](https://github.com/mikejhill/codapact/compare/v0.1.0...v0.1.1) (2026-10-29)
21
+
22
+ ### Bug Fixes
23
+
24
+ * Reject whitespace and DEL in literal OpenAPI operation paths during translation.
25
+ * Validate and bound ownership manifests before regeneration writes, including malformed roots,
26
+ non-integer versions, and oversized inventories.
27
+ * Honor explicit base URL, timeout, and private-network flags in wrappers without discovery profiles;
28
+ preserve configured values when flags are omitted.
29
+ * Reject all ASCII control characters and DEL in parameter and custom-auth request headers before
30
+ transport, with redacted diagnostics.
31
+
32
+ * Bound expanded reference text, counting repeated large string keys and values before serialization.
33
+
34
+ The first four fixes are included in [3e21fd7](https://github.com/mikejhill/codapact/commit/3e21fd7b42dc370e27bfa7617c6ed9174d2cb284).
35
+
36
+ ## 0.1.0 (2026-10-29)
37
+
38
+ ### Features
39
+
40
+ * add generation manifests and XDG runtime profiles ([cd0e6a2](https://github.com/mikejhill/codapact/commit/cd0e6a20e813423d3b33ca5ba277a036c482dd8c))
41
+ * initialize codapact ([7daa7e2](https://github.com/mikejhill/codapact/commit/7daa7e2534bdd59bcd555dc90ec2e97a002f130c))
42
+
43
+ ### Bug Fixes
44
+
45
+ * document generated commands and release handoff ([9ea472c](https://github.com/mikejhill/codapact/commit/9ea472ca5e3cfe9fdf4bbc94bb22511d87eece22))
46
+ * harden contracts and add mutation alerts ([b4b1a06](https://github.com/mikejhill/codapact/commit/b4b1a06d2029a53fa68783f6ecd1c0dedb7854e2))
47
+ * reconcile asynchronous mutation alerts ([ba1737d](https://github.com/mikejhill/codapact/commit/ba1737d33f9e6157a7d9fe6f6c8b1d2878917dec))
@@ -1,6 +1,6 @@
1
1
  Metadata-Version: 2.4
2
2
  Name: codapact
3
- Version: 0.1.0
3
+ Version: 0.2.0
4
4
  Summary: Contracts into callable tools: pluggable API client and CLI generation.
5
5
  License-Expression: MIT
6
6
  License-File: LICENSE
@@ -49,10 +49,22 @@ Reusable generation values are supported with `uv run codapact generate
49
49
  Override its directory with `pets --config-dir PATH ...`. See the configuration
50
50
  guide for precedence, credential-file permissions, and every generation override.
51
51
 
52
+ Generate a specialized surface with `--preset read` and operation ID, path,
53
+ method, or domain-tag rules. Preview the selected operations without writes:
54
+
55
+ ```console
56
+ uv run codapact generate --manifest examples/pets-read.codapact.yaml --dry-run
57
+ ```
58
+
59
+ The read preset selects GET/HEAD/OPTIONS by name; it is not a safety or
60
+ authorization guarantee. The generated library and CLI share the same selection.
61
+
52
62
  - [Architecture and extension contracts](docs/architecture.md)
53
63
  - [Supported features and safety boundaries](docs/support.md)
54
64
  - [CLI definition and runtime configuration](docs/configuration.md)
65
+ - [Endpoint selection and domain profiles](docs/selection.md)
55
66
  - [Release process](docs/releasing.md)
67
+ - [Security analysis](docs/security.md)
56
68
  - [Verification evidence and limits](docs/verification.md)
57
69
  - [Asynchronous mutation testing and open alerts](docs/mutation.md)
58
70
 
@@ -34,10 +34,22 @@ Reusable generation values are supported with `uv run codapact generate
34
34
  Override its directory with `pets --config-dir PATH ...`. See the configuration
35
35
  guide for precedence, credential-file permissions, and every generation override.
36
36
 
37
+ Generate a specialized surface with `--preset read` and operation ID, path,
38
+ method, or domain-tag rules. Preview the selected operations without writes:
39
+
40
+ ```console
41
+ uv run codapact generate --manifest examples/pets-read.codapact.yaml --dry-run
42
+ ```
43
+
44
+ The read preset selects GET/HEAD/OPTIONS by name; it is not a safety or
45
+ authorization guarantee. The generated library and CLI share the same selection.
46
+
37
47
  - [Architecture and extension contracts](docs/architecture.md)
38
48
  - [Supported features and safety boundaries](docs/support.md)
39
49
  - [CLI definition and runtime configuration](docs/configuration.md)
50
+ - [Endpoint selection and domain profiles](docs/selection.md)
40
51
  - [Release process](docs/releasing.md)
52
+ - [Security analysis](docs/security.md)
41
53
  - [Verification evidence and limits](docs/verification.md)
42
54
  - [Asynchronous mutation testing and open alerts](docs/mutation.md)
43
55
 
@@ -9,8 +9,9 @@ of static annotations. TypeScript remains a future target.
9
9
  flowchart LR
10
10
  A[Bounded JSON/YAML loader] --> B[Contract translator plugin]
11
11
  B --> C[Version 1 shared IR]
12
- C --> D[Python generator plugin]
13
- C --> E[CLI generator plugin]
12
+ C --> S[Selection plugin and audit report]
13
+ S --> D[Python generator plugin]
14
+ S --> E[CLI generator plugin]
14
15
  D --> F[Ownership manifest]
15
16
  E --> F
16
17
  F --> G[Generated client and CLI]
@@ -26,6 +27,7 @@ flowchart LR
26
27
  | Loading | Bounded JSON/YAML; local files and HTTP(S) | Explicit transport injection |
27
28
  | Translation | OpenAPI 3.0 JSON HTTP subset | `Translator.translate(document) -> Contract` |
28
29
  | Shared model | Frozen contract and operation records; schema dictionaries | IR major version, metadata, capability identifiers |
30
+ | Selection | Operation IDs, methods, path globs, tags, read method preset | `Selector.select(contract, definition) -> SelectionResult` |
29
31
  | Library generation | Typed dictionaries, typed methods, JSON IR resource | `Generator.generate(contract, package) -> files` |
30
32
  | CLI generation | Version 1 definition, argparse commands | Independent generator and CLI runtime |
31
33
  | Execution | Schema validation and JSON serialization | Generated client inherits `ClientBase` |
@@ -72,3 +74,11 @@ the next run fails closed on mismatched ownership. Preserve edited files and
72
74
  generate into a new directory to recover. Concurrent generation into the same
73
75
  directory is unsupported. Local plugins and users able to race filesystem
74
76
  mutations are trusted; this is not an operating-system sandbox.
77
+
78
+ Authentication and policy contracts live in `auth.py`; data-only JSON/runtime
79
+ validation lives in `validation.py`. Neither depends on execution or filesystem
80
+ credential discovery. `profiles.py` composes these services without importing
81
+ `runtime.py`; the execution layer can therefore validate profiles without an
82
+ import cycle. Existing runtime imports of the auth/policy/validation services
83
+ remain available for compatibility. Protocol methods are explicit abstract
84
+ contracts; incomplete nominal implementations cannot silently satisfy them.
@@ -55,6 +55,7 @@ An empty map at the root adds no overrides. `--set` accepts JSON, not YAML.
55
55
  | contract.type | `--contract-type` | openapi |
56
56
  | contract.allow_private | `--allow-private` / `--no-allow-private` | false |
57
57
  | output.directory | `--output` | generated |
58
+ | output.dry_run | `--dry-run` / `--no-dry-run` | false |
58
59
  | client.language | `--client-language` | python |
59
60
  | client.package | `--package` | slug with underscores, plus _client |
60
61
  | cli.style | `--cli-style` | argparse |
@@ -66,8 +67,15 @@ An empty map at the root adds no overrides. `--set` accepts JSON, not YAML.
66
67
  | runtime.defaults.allow_private | `--runtime-allow-private` / `--no-runtime-allow-private` | false |
67
68
  | runtime.defaults.policy.allow | `--runtime-policy-allow JSON` | All except denied operations |
68
69
  | runtime.defaults.policy.deny | `--runtime-policy-deny JSON` | Empty list |
70
+ | selection.version | `--selection-version` | 1 |
71
+ | selection.plugin | `--selection-plugin` | operations |
72
+ | selection.preset | `--preset` | all |
73
+ | selection.include | `--include JSON` | Empty list: include all |
74
+ | selection.exclude | `--exclude JSON` | Empty list: remove none |
69
75
 
70
76
  All fields, including whole maps and explicit nulls, also support `--set`.
77
+ See [endpoint selection](selection.md) for rule composition, domain/read profiles,
78
+ strict unmatched-selector handling, and the inspectable dry-run report.
71
79
  Relative source, output, and CLI-definition paths are anchored to the manifest
72
80
  folder, including relative flag overrides. Without a manifest they use the
73
81
  invocation directory. Absolute paths stay absolute. Contract HTTP(S) URLs remain
@@ -0,0 +1,427 @@
1
+ {
2
+ "baseline_commit": "ab121cb1f493929926012ed687fabb85e60ad686",
3
+ "baseline_run": "https://github.com/mikejhill/codapact/actions/runs/40838704218",
4
+ "scope": "Only the 46 previously unresolved survivors; no score adjustment or exclusion applied.",
5
+ "counts": {
6
+ "behavior-asserted": 20,
7
+ "presentation": 12,
8
+ "equivalence-candidate": 7,
9
+ "representation-policy": 7
10
+ },
11
+ "review_limit": "Equivalence candidates are reasoned classifications, not universal proofs. Presentation and representation differences remain observable; no arbitrary snapshots were added.",
12
+ "version_schema_witness": {
13
+ "jsonschema": "4.26.0",
14
+ "values": [
15
+ "null",
16
+ "false",
17
+ "true",
18
+ "0",
19
+ "1",
20
+ "1.0",
21
+ "1.5",
22
+ "2",
23
+ "\"1\"",
24
+ "[]",
25
+ "{}",
26
+ "[1]",
27
+ "{\"version\":1}"
28
+ ],
29
+ "accepted_by_both_integer_const_and_const_only": [
30
+ "1",
31
+ "1.0"
32
+ ],
33
+ "source_observation": "jsonschema._utils.equal uses unbool to keep booleans distinct from integers."
34
+ },
35
+ "items": {
36
+ "codapact.__main__.x_main__mutmut_26": {
37
+ "classification": "behavior-asserted",
38
+ "reason": "Help must describe the command, inputs and assignment syntax, without fixed wording.",
39
+ "evidence": [
40
+ "tests/test_residual_contracts.py::test_generator_help_explains_command_and_inputs_without_fixed_wording"
41
+ ],
42
+ "mutated_body_sha256": "00d1acbf3c6f0f5bcb0f2805d0730b07ee017def65e57e8ea997f2c9bbc04a51"
43
+ },
44
+ "codapact.__main__.x_main__mutmut_28": {
45
+ "classification": "behavior-asserted",
46
+ "reason": "Help must describe the command, inputs and assignment syntax, without fixed wording.",
47
+ "evidence": [
48
+ "tests/test_residual_contracts.py::test_generator_help_explains_command_and_inputs_without_fixed_wording"
49
+ ],
50
+ "mutated_body_sha256": "916c430e811aebf75cb36d475b580d0cb31b185f90ee441d2b8ac6cd51e83af6"
51
+ },
52
+ "codapact.__main__.x_main__mutmut_36": {
53
+ "classification": "behavior-asserted",
54
+ "reason": "Help must describe the command, inputs and assignment syntax, without fixed wording.",
55
+ "evidence": [
56
+ "tests/test_residual_contracts.py::test_generator_help_explains_command_and_inputs_without_fixed_wording"
57
+ ],
58
+ "mutated_body_sha256": "359bfce2a5ddb453f1225591c91ad8ad1aedb8062c85cd784bac3047fec8fa9c"
59
+ },
60
+ "codapact.__main__.x_main__mutmut_39": {
61
+ "classification": "behavior-asserted",
62
+ "reason": "Help must describe the command, inputs and assignment syntax, without fixed wording.",
63
+ "evidence": [
64
+ "tests/test_residual_contracts.py::test_generator_help_explains_command_and_inputs_without_fixed_wording"
65
+ ],
66
+ "mutated_body_sha256": "d2e3bf2e05a1c0d7c1b779b0edf18431dd13c2db498a12fdfbb20c199ca783a1"
67
+ },
68
+ "codapact.__main__.x_main__mutmut_47": {
69
+ "classification": "behavior-asserted",
70
+ "reason": "Help must describe the command, inputs and assignment syntax, without fixed wording.",
71
+ "evidence": [
72
+ "tests/test_residual_contracts.py::test_generator_help_explains_command_and_inputs_without_fixed_wording"
73
+ ],
74
+ "mutated_body_sha256": "09d574268782dc50a15b3bd27a67eb1fe826c06b70b558a08fc292109af12a84"
75
+ },
76
+ "codapact.__main__.x_main__mutmut_49": {
77
+ "classification": "behavior-asserted",
78
+ "reason": "Help must describe the command, inputs and assignment syntax, without fixed wording.",
79
+ "evidence": [
80
+ "tests/test_residual_contracts.py::test_generator_help_explains_command_and_inputs_without_fixed_wording"
81
+ ],
82
+ "mutated_body_sha256": "277c83a9aae4d862abf008887d54de7b76dc10f5f44d4b1bbf126b1a22d365e4"
83
+ },
84
+ "codapact.__main__.x_main__mutmut_144": {
85
+ "classification": "behavior-asserted",
86
+ "reason": "Help must describe the command, inputs and assignment syntax, without fixed wording.",
87
+ "evidence": [
88
+ "tests/test_residual_contracts.py::test_generator_help_explains_command_and_inputs_without_fixed_wording"
89
+ ],
90
+ "mutated_body_sha256": "6a759af7dbee6607515f0209c44c5a5bea10359e4eeb41a08d59a7af9be95f7d"
91
+ },
92
+ "codapact.__main__.x_main__mutmut_148": {
93
+ "classification": "behavior-asserted",
94
+ "reason": "Help must describe the command, inputs and assignment syntax, without fixed wording.",
95
+ "evidence": [
96
+ "tests/test_residual_contracts.py::test_generator_help_explains_command_and_inputs_without_fixed_wording"
97
+ ],
98
+ "mutated_body_sha256": "f6a7bbb420293e6832165f923a6a5892b43f141b19726e81c4845c93fd5fd0e7"
99
+ },
100
+ "codapact.__main__.x_main__mutmut_267": {
101
+ "classification": "presentation",
102
+ "reason": "Safe nonempty OS diagnostic changes only casing or decoration.",
103
+ "evidence": [
104
+ "tests/test_entrypoint.py::test_generation_os_failures_have_safe_diagnostics"
105
+ ],
106
+ "mutated_body_sha256": "1ecc90d84eb15b63c2e99394c6d861b071c892f78f5e6f8749f82ceab079678e"
107
+ },
108
+ "codapact.__main__.x_main__mutmut_268": {
109
+ "classification": "presentation",
110
+ "reason": "Safe nonempty OS diagnostic changes only casing or decoration.",
111
+ "evidence": [
112
+ "tests/test_entrypoint.py::test_generation_os_failures_have_safe_diagnostics"
113
+ ],
114
+ "mutated_body_sha256": "c62afc050e03ee47bd718366ab9c30eb06c0420812f4866f694bddd5c4bc0051"
115
+ },
116
+ "codapact.cli.x_run_cli__mutmut_2": {
117
+ "classification": "behavior-asserted",
118
+ "reason": "Help must retain a CLI description and configuration-directory guidance.",
119
+ "evidence": [
120
+ "tests/test_residual_contracts.py::test_generated_cli_help_has_description_and_config_directory_guidance"
121
+ ],
122
+ "mutated_body_sha256": "c124457f303034f985e4cbd1f4b009601ce4fadc8abf2905f2a0fdcd4d17a936"
123
+ },
124
+ "codapact.cli.x_run_cli__mutmut_16": {
125
+ "classification": "behavior-asserted",
126
+ "reason": "Help must retain a CLI description and configuration-directory guidance.",
127
+ "evidence": [
128
+ "tests/test_residual_contracts.py::test_generated_cli_help_has_description_and_config_directory_guidance"
129
+ ],
130
+ "mutated_body_sha256": "1b0c85cb4735a60fc4a8337a70e5c9d4472b4c76bee93297a5ee82cdd327134a"
131
+ },
132
+ "codapact.cli.x_run_cli__mutmut_18": {
133
+ "classification": "behavior-asserted",
134
+ "reason": "Help must retain a CLI description and configuration-directory guidance.",
135
+ "evidence": [
136
+ "tests/test_residual_contracts.py::test_generated_cli_help_has_description_and_config_directory_guidance"
137
+ ],
138
+ "mutated_body_sha256": "537267a68b66b1059e3b2559aa6a76f9f8662490f34b4c5c04a83c90daa87b7c"
139
+ },
140
+ "codapact.cli.x_run_cli__mutmut_294": {
141
+ "classification": "behavior-asserted",
142
+ "reason": "Custom factories are an execution boundary; the CLI must reject nonfinite output independently.",
143
+ "evidence": [
144
+ "tests/test_residual_contracts.py::test_cli_factory_output_must_still_be_json"
145
+ ],
146
+ "mutated_body_sha256": "afc631d5bc8e275080b573ceeaa1fdcefe8bbb7ecc2f663acdce8ff3085b2ba7"
147
+ },
148
+ "codapact.cli.x_run_cli__mutmut_299": {
149
+ "classification": "behavior-asserted",
150
+ "reason": "Custom factories are an execution boundary; the CLI must reject nonfinite output independently.",
151
+ "evidence": [
152
+ "tests/test_residual_contracts.py::test_cli_factory_output_must_still_be_json"
153
+ ],
154
+ "mutated_body_sha256": "5c6be66b1c099855349381b63ddbcd039f8424c35622c78804925e7a97017aa2"
155
+ },
156
+ "codapact.cli.x_run_cli__mutmut_297": {
157
+ "classification": "presentation",
158
+ "reason": "Three-space instead of two-space pretty JSON preserves valid indented JSON. Exact width is not declared compatible.",
159
+ "evidence": [
160
+ "src/codapact/cli.py"
161
+ ],
162
+ "mutated_body_sha256": "738f12f445428e8b341b21016d386c3286b8cf098051a0e16e5a4b60fa7ca512"
163
+ },
164
+ "codapact.cli.x_run_cli__mutmut_319": {
165
+ "classification": "presentation",
166
+ "reason": "Safe nonempty JSON diagnostic changes only casing or decoration.",
167
+ "evidence": [
168
+ "tests/test_generated_contracts.py",
169
+ "docs/support.md"
170
+ ],
171
+ "mutated_body_sha256": "d04ab495b21ea319d7fb7ee17f31ac78c4576f42a672e795dfc474dbd74caf05"
172
+ },
173
+ "codapact.cli.x_run_cli__mutmut_320": {
174
+ "classification": "presentation",
175
+ "reason": "Safe nonempty JSON diagnostic changes only casing or decoration.",
176
+ "evidence": [
177
+ "tests/test_generated_contracts.py",
178
+ "docs/support.md"
179
+ ],
180
+ "mutated_body_sha256": "eb6d6faa36a4bdfbb705923d7da01662851f4488ef1c3ee33239097c5a8a82f1"
181
+ },
182
+ "codapact.cli.x_run_cli__mutmut_321": {
183
+ "classification": "presentation",
184
+ "reason": "Safe nonempty JSON diagnostic changes only casing or decoration.",
185
+ "evidence": [
186
+ "tests/test_generated_contracts.py",
187
+ "docs/support.md"
188
+ ],
189
+ "mutated_body_sha256": "dabd8ab95a9a528ff9f8b1a86f92b4765589134c13e703d68b0909a4286eb565"
190
+ },
191
+ "codapact.configuration.x_resolve_generation__mutmut_48": {
192
+ "classification": "equivalence-candidate",
193
+ "reason": "Missing separators still fail JSON parsing; unsupported dotted keys still fail the closed generation schema. The earlier safe diagnostic can differ.",
194
+ "evidence": [
195
+ "src/codapact/configuration.py",
196
+ "src/codapact/schemas/generation.v1.json"
197
+ ],
198
+ "mutated_body_sha256": "b31531fc9037a8fe4ff51b6e5d213b12077ef8c5d561a93db4201d75bb0a330b"
199
+ },
200
+ "codapact.configuration.x_resolve_generation__mutmut_147": {
201
+ "classification": "behavior-asserted",
202
+ "reason": "Unsupported URL schemes must fail before local-path resolution.",
203
+ "evidence": [
204
+ "tests/test_residual_contracts.py::test_manifest_rejects_unsupported_source_scheme_before_local_path_resolution"
205
+ ],
206
+ "mutated_body_sha256": "4628d8d639025093a2cd1b57dc4a10a2c194d37f5233ecacb67e0e334172f4db"
207
+ },
208
+ "codapact.generation.x_canonical__mutmut_4": {
209
+ "classification": "presentation",
210
+ "reason": "Changed indentation changes serialized bytes while retaining deterministic valid JSON. Exact indentation is not declared compatible.",
211
+ "evidence": [
212
+ "src/codapact/generation.py::canonical"
213
+ ],
214
+ "mutated_body_sha256": "1498294f286a49001b6ddb8e9b169527f4728896511e0e372f814c22e8e22443"
215
+ },
216
+ "codapact.generation.x_canonical__mutmut_9": {
217
+ "classification": "presentation",
218
+ "reason": "Changed indentation changes serialized bytes while retaining deterministic valid JSON. Exact indentation is not declared compatible.",
219
+ "evidence": [
220
+ "src/codapact/generation.py::canonical"
221
+ ],
222
+ "mutated_body_sha256": "ecf75bcdfee53a9bb3d03d239b50206bb0754cfc80cb66287c18c4de6bd1e238"
223
+ },
224
+ "codapact.generation.x_canonical__mutmut_13": {
225
+ "classification": "presentation",
226
+ "reason": "Changed indentation changes serialized bytes while retaining deterministic valid JSON. Exact indentation is not declared compatible.",
227
+ "evidence": [
228
+ "src/codapact/generation.py::canonical"
229
+ ],
230
+ "mutated_body_sha256": "c9dc9a237afd7bd89e5799f1a9c4513c1a06318b79d1f6825c7c09055e4a371a"
231
+ },
232
+ "codapact.generation.x\u01c1PythonGenerator\u01c1generate__mutmut_136": {
233
+ "classification": "representation-policy",
234
+ "reason": "The py.typed marker still exists but its contents differ. Marker discovery is tested; universal typing-tool equivalence is not established.",
235
+ "evidence": [
236
+ "tests/test_generated_contracts.py::test_generated_types_and_call_signatures_are_usable"
237
+ ],
238
+ "mutated_body_sha256": "8cdf6554c20508c61d0a6743080af9be919ee547bf62e0e43682cd48f85e890a"
239
+ },
240
+ "codapact.generation.x\u01c1PythonGenerator\u01c1generate__mutmut_151": {
241
+ "classification": "presentation",
242
+ "reason": "Generated README prose changes casing or decoration while retaining installation instructions.",
243
+ "evidence": [
244
+ "src/codapact/generation.py::PythonGenerator.generate"
245
+ ],
246
+ "mutated_body_sha256": "af40fe0389b2912fb3bec4f574d49f82de09542271febde641c09046a29d9e6b"
247
+ },
248
+ "codapact.generation.x\u01c1PythonGenerator\u01c1generate__mutmut_152": {
249
+ "classification": "presentation",
250
+ "reason": "Generated README prose changes casing or decoration while retaining installation instructions.",
251
+ "evidence": [
252
+ "src/codapact/generation.py::PythonGenerator.generate"
253
+ ],
254
+ "mutated_body_sha256": "cf725db676590a1c46a201561b431ee014ab13aa1ef3ea6ccd7bf71fbe5ec6e1"
255
+ },
256
+ "codapact.generation.x\u01c1PythonGenerator\u01c1generate__mutmut_153": {
257
+ "classification": "presentation",
258
+ "reason": "Generated README prose changes casing or decoration while retaining installation instructions.",
259
+ "evidence": [
260
+ "src/codapact/generation.py::PythonGenerator.generate"
261
+ ],
262
+ "mutated_body_sha256": "17cdc5fc4f3eea4ffa2823c6b0a0df4803dd8d39035d5bd2088c6f5bc6619722"
263
+ },
264
+ "codapact.profiles.x_validate_profile__mutmut_29": {
265
+ "classification": "equivalence-candidate",
266
+ "reason": "Version const=1 independently rejects booleans and other JSON values; its accepted numeric values already satisfy JSON Schema integer. See witness matrix.",
267
+ "evidence": [
268
+ "src/codapact/profiles.py::validate_profile",
269
+ "jsonschema._utils.equal"
270
+ ],
271
+ "mutated_body_sha256": "5d00dd98573f392f4c43e7e8d05168169f050ddc5241103e85ce31055bc6ab58"
272
+ },
273
+ "codapact.profiles.x_validate_profile__mutmut_30": {
274
+ "classification": "equivalence-candidate",
275
+ "reason": "Version const=1 independently rejects booleans and other JSON values; its accepted numeric values already satisfy JSON Schema integer. See witness matrix.",
276
+ "evidence": [
277
+ "src/codapact/profiles.py::validate_profile",
278
+ "jsonschema._utils.equal"
279
+ ],
280
+ "mutated_body_sha256": "09a570956e80dc9c4b0ca49af0cbc9959ecba62ed29f23feab0b3bbe0419180c"
281
+ },
282
+ "codapact.profiles.x_validate_profile__mutmut_52": {
283
+ "classification": "behavior-asserted",
284
+ "reason": "Null defaults must yield a safe configuration error before downstream membership checks; other non-object defaults also reject safely.",
285
+ "evidence": [
286
+ "tests/test_residual_contracts.py::test_profile_defaults_reject_non_objects_with_safe_diagnostics"
287
+ ],
288
+ "mutated_body_sha256": "24ce71557255bbe75372391d91263d0077d738f699df2032c9e0c4915e1fee31"
289
+ },
290
+ "codapact.profiles.x_validate_profile__mutmut_53": {
291
+ "classification": "behavior-asserted",
292
+ "reason": "Null defaults must yield a safe configuration error before downstream membership checks; other non-object defaults also reject safely.",
293
+ "evidence": [
294
+ "tests/test_residual_contracts.py::test_profile_defaults_reject_non_objects_with_safe_diagnostics"
295
+ ],
296
+ "mutated_body_sha256": "7ea36f05e178e9bb31cb507d83ab41b0f296c37881da329c779a1edab771bf0c"
297
+ },
298
+ "codapact.profiles.x\u01c1JsonFileStore\u01c1__init____mutmut_21": {
299
+ "classification": "equivalence-candidate",
300
+ "reason": "The preceding read_file -> loading.parse pipeline already rejects non-object roots. This constructor accepts a path, not an independent document object.",
301
+ "evidence": [
302
+ "src/codapact/profiles.py::read_file",
303
+ "src/codapact/loading.py::parse"
304
+ ],
305
+ "mutated_body_sha256": "a1cb1029d63e78b4ce92edb99f544041dfdfbe00fefec1f02db11f3a3068916c"
306
+ },
307
+ "codapact.profiles.x\u01c1JsonFileStore\u01c1__init____mutmut_22": {
308
+ "classification": "equivalence-candidate",
309
+ "reason": "The preceding read_file -> loading.parse pipeline already rejects non-object roots. This constructor accepts a path, not an independent document object.",
310
+ "evidence": [
311
+ "src/codapact/profiles.py::read_file",
312
+ "src/codapact/loading.py::parse"
313
+ ],
314
+ "mutated_body_sha256": "67721ef35bbe7a59bbce52a1c2f57b06ae61a1e3fd0d417c7ed5a86f60907ccd"
315
+ },
316
+ "codapact.profiles.x\u01c1JsonFileStore\u01c1__init____mutmut_39": {
317
+ "classification": "equivalence-candidate",
318
+ "reason": "Version const=1 independently enforces the same accepted numeric values. See witness matrix.",
319
+ "evidence": [
320
+ "src/codapact/profiles.py::JsonFileStore.__init__",
321
+ "jsonschema._utils.equal"
322
+ ],
323
+ "mutated_body_sha256": "a0e8816a4c0668168dcf85fbf8a3b3b51d5ba214bd946dc54a773a12983c4209"
324
+ },
325
+ "codapact.profiles.x\u01c1JsonFileStore\u01c1__init____mutmut_40": {
326
+ "classification": "equivalence-candidate",
327
+ "reason": "Version const=1 independently enforces the same accepted numeric values. See witness matrix.",
328
+ "evidence": [
329
+ "src/codapact/profiles.py::JsonFileStore.__init__",
330
+ "jsonschema._utils.equal"
331
+ ],
332
+ "mutated_body_sha256": "b793817700c4f1459fe6f0ac6df340889f55f65794ecbdd14309804077e33f4d"
333
+ },
334
+ "codapact.project.x_write_project__mutmut_6": {
335
+ "classification": "representation-policy",
336
+ "reason": "The probe is an internal name, not a generated output. Changing it can affect collisions with unrelated symlinks, so filesystem equivalence is not claimed. Preserve path safety rather than freeze this incidental name.",
337
+ "evidence": [
338
+ "src/codapact/project.py::write_project",
339
+ "src/codapact/project.py::_safe_path"
340
+ ],
341
+ "mutated_body_sha256": "11b551320df3044185c82679052fcd6503ac51308d563430955ba1a0852644c3"
342
+ },
343
+ "codapact.project.x_write_project__mutmut_7": {
344
+ "classification": "representation-policy",
345
+ "reason": "The probe is an internal name, not a generated output. Changing it can affect collisions with unrelated symlinks, so filesystem equivalence is not claimed. Preserve path safety rather than freeze this incidental name.",
346
+ "evidence": [
347
+ "src/codapact/project.py::write_project",
348
+ "src/codapact/project.py::_safe_path"
349
+ ],
350
+ "mutated_body_sha256": "f2fa4244ec43c76ba9f7cb1424ac18a29b0768aa492bddd7694e550082581e70"
351
+ },
352
+ "codapact.project.x_write_project__mutmut_82": {
353
+ "classification": "behavior-asserted",
354
+ "reason": "Ownership at the exact cap must be accepted; one extra byte must fail before writes. Regeneration must apply the same read limit.",
355
+ "evidence": [
356
+ "tests/test_residual_contracts.py::test_ownership_read_and_write_agree_at_exact_size",
357
+ "tests/test_residual_contracts.py::test_ownership_limit_rejects_one_extra_serialized_byte_before_writes"
358
+ ],
359
+ "mutated_body_sha256": "beadfe5dc403cc5d98f9190666f95669ef4ada130ceb5946458df119648dc90b"
360
+ },
361
+ "codapact.project.x__atomic__mutmut_2": {
362
+ "classification": "representation-policy",
363
+ "reason": "Temporary prefixes are observable to filesystem watchers. Secure unique creation in the destination directory and atomic replacement remain the intended contract; no exact prefix is promised.",
364
+ "evidence": [
365
+ "src/codapact/project.py::_atomic"
366
+ ],
367
+ "mutated_body_sha256": "869fd643db9fa78c2502cb344fc75fcaa69e98f46d848fb7aab9699d95c7d812"
368
+ },
369
+ "codapact.project.x__atomic__mutmut_4": {
370
+ "classification": "representation-policy",
371
+ "reason": "Temporary prefixes are observable to filesystem watchers. Secure unique creation in the destination directory and atomic replacement remain the intended contract; no exact prefix is promised.",
372
+ "evidence": [
373
+ "src/codapact/project.py::_atomic"
374
+ ],
375
+ "mutated_body_sha256": "d58718a2611ebc56fa776521e94c1a9751c17a1d888ed5c2e2ee27b34be50267"
376
+ },
377
+ "codapact.project.x__atomic__mutmut_6": {
378
+ "classification": "representation-policy",
379
+ "reason": "Temporary prefixes are observable to filesystem watchers. Secure unique creation in the destination directory and atomic replacement remain the intended contract; no exact prefix is promised.",
380
+ "evidence": [
381
+ "src/codapact/project.py::_atomic"
382
+ ],
383
+ "mutated_body_sha256": "711a053ae7323bcee787bd18fdad7d94835a25e758c8b7eb8a6785fd228c67c3"
384
+ },
385
+ "codapact.project.x__atomic__mutmut_7": {
386
+ "classification": "representation-policy",
387
+ "reason": "Temporary prefixes are observable to filesystem watchers. Secure unique creation in the destination directory and atomic replacement remain the intended contract; no exact prefix is promised.",
388
+ "evidence": [
389
+ "src/codapact/project.py::_atomic"
390
+ ],
391
+ "mutated_body_sha256": "99f8df359e7ee93c1727fd25f655912f00c6738d405bcf6be7e7d3b864a5dbcf"
392
+ },
393
+ "codapact.validation.x_validate__mutmut_19": {
394
+ "classification": "behavior-asserted",
395
+ "reason": "Dictionary edges must advance depth once, including mixed dictionary/list nesting; depth48 accepts and depth49 rejects.",
396
+ "evidence": [
397
+ "tests/test_residual_contracts.py::test_object_depth_counts_each_container_edge"
398
+ ],
399
+ "mutated_body_sha256": "86ff6b996c2759d1c40208e6cd9bad6c30336087223c8140dab0a269a22dd51a"
400
+ },
401
+ "codapact.validation.x_validate__mutmut_20": {
402
+ "classification": "behavior-asserted",
403
+ "reason": "Dictionary edges must advance depth once, including mixed dictionary/list nesting; depth48 accepts and depth49 rejects.",
404
+ "evidence": [
405
+ "tests/test_residual_contracts.py::test_object_depth_counts_each_container_edge"
406
+ ],
407
+ "mutated_body_sha256": "3b625eb1768bc866874b9d1d7c5d32c47e198c4d2c400b19f874f0fd4dda5ef9"
408
+ },
409
+ "codapact.validation.x_validate__mutmut_21": {
410
+ "classification": "behavior-asserted",
411
+ "reason": "Dictionary edges must advance depth once, including mixed dictionary/list nesting; depth48 accepts and depth49 rejects.",
412
+ "evidence": [
413
+ "tests/test_residual_contracts.py::test_object_depth_counts_each_container_edge"
414
+ ],
415
+ "mutated_body_sha256": "8e473b65a8a60117ca66b7e57aa31a28b0e4555ff6bbc6568da0dc2e2481df7b"
416
+ }
417
+ },
418
+ "behavior_verification": {
419
+ "environment": "Local Linux, Python3.13; unchanged production source",
420
+ "selected_counterexamples": 20,
421
+ "killed": 20,
422
+ "survived": 0,
423
+ "incomplete_results": 0,
424
+ "identity_check": "Every mutated function-body AST SHA256 matches the baseline artifact; numeric IDs alone were not used.",
425
+ "limitation": "Focused results are not the full project mutation score."
426
+ }
427
+ }