safesink 0.4.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 (140) hide show
  1. safesink-0.4.0/.env.example +4 -0
  2. safesink-0.4.0/.github/dependabot.yml +14 -0
  3. safesink-0.4.0/.github/workflows/live-kafka-postgres.yml +79 -0
  4. safesink-0.4.0/.github/workflows/mcp-conformance.yml +37 -0
  5. safesink-0.4.0/.github/workflows/release.yml +46 -0
  6. safesink-0.4.0/.github/workflows/test.yml +93 -0
  7. safesink-0.4.0/.gitignore +8 -0
  8. safesink-0.4.0/.pre-commit-config.yaml +15 -0
  9. safesink-0.4.0/CHANGELOG.md +128 -0
  10. safesink-0.4.0/CODE_OF_CONDUCT.md +5 -0
  11. safesink-0.4.0/CONTRIBUTING.md +22 -0
  12. safesink-0.4.0/Dockerfile +5 -0
  13. safesink-0.4.0/LICENSE +201 -0
  14. safesink-0.4.0/PKG-INFO +230 -0
  15. safesink-0.4.0/README.md +204 -0
  16. safesink-0.4.0/SECURITY.md +24 -0
  17. safesink-0.4.0/action.yml +44 -0
  18. safesink-0.4.0/benchmark/cases/ACKLOSS-01.json +15 -0
  19. safesink-0.4.0/benchmark/cases/ACKLOSS-02.json +15 -0
  20. safesink-0.4.0/benchmark/cases/ACKLOSS-03.json +15 -0
  21. safesink-0.4.0/benchmark/cases/CONCURRENT-01.json +17 -0
  22. safesink-0.4.0/benchmark/cases/CONCURRENT-02.json +17 -0
  23. safesink-0.4.0/benchmark/cases/CONCURRENT-03.json +17 -0
  24. safesink-0.4.0/benchmark/cases/CRASH-EFFECT-01.json +17 -0
  25. safesink-0.4.0/benchmark/cases/CRASH-EFFECT-02.json +17 -0
  26. safesink-0.4.0/benchmark/cases/CRASH-EFFECT-03.json +17 -0
  27. safesink-0.4.0/benchmark/cases/CRASH-EFFECT-04.json +17 -0
  28. safesink-0.4.0/benchmark/cases/EXPIRE-01.json +17 -0
  29. safesink-0.4.0/benchmark/cases/EXPIRE-02.json +17 -0
  30. safesink-0.4.0/benchmark/cases/EXPIRE-03.json +17 -0
  31. safesink-0.4.0/benchmark/cases/IDEM-CRASH-01.json +17 -0
  32. safesink-0.4.0/benchmark/cases/IDEM-CRASH-02.json +17 -0
  33. safesink-0.4.0/benchmark/cases/IDEM-CRASH-03.json +17 -0
  34. safesink-0.4.0/benchmark/cases/IDEM-CRASH-04.json +17 -0
  35. safesink-0.4.0/benchmark/cases/IDEM-EXPIRE-01.json +15 -0
  36. safesink-0.4.0/benchmark/cases/IDEM-EXPIRE-02.json +15 -0
  37. safesink-0.4.0/benchmark/cases/IDEM-EXPIRE-03.json +15 -0
  38. safesink-0.4.0/benchmark/cases/IDEM-EXPIRE-04.json +15 -0
  39. safesink-0.4.0/benchmark/cases/NAIVE-ACKLOSS-01.json +15 -0
  40. safesink-0.4.0/benchmark/cases/NAIVE-ACKLOSS-02.json +15 -0
  41. safesink-0.4.0/benchmark/cases/NAIVE-ACKLOSS-03.json +15 -0
  42. safesink-0.4.0/benchmark/cases/NAIVE-ACKLOSS-04.json +15 -0
  43. safesink-0.4.0/benchmark/cases/NAIVE-CRASH-01.json +17 -0
  44. safesink-0.4.0/benchmark/cases/NAIVE-CRASH-02.json +17 -0
  45. safesink-0.4.0/benchmark/cases/NAIVE-CRASH-03.json +17 -0
  46. safesink-0.4.0/benchmark/cases/NAIVE-CRASH-04.json +17 -0
  47. safesink-0.4.0/benchmark/cases/OUTBOX-01.json +17 -0
  48. safesink-0.4.0/benchmark/cases/OUTBOX-02.json +17 -0
  49. safesink-0.4.0/benchmark/cases/OUTBOX-03.json +17 -0
  50. safesink-0.4.0/benchmark/cases/OUTBOX-04.json +17 -0
  51. safesink-0.4.0/benchmark/cases/OUTBOX-CRASH-01.json +17 -0
  52. safesink-0.4.0/benchmark/cases/OUTBOX-CRASH-02.json +17 -0
  53. safesink-0.4.0/benchmark/cases/OUTBOX-CRASH-03.json +17 -0
  54. safesink-0.4.0/benchmark/cases/OUTBOX-CRASH-04.json +17 -0
  55. safesink-0.4.0/benchmark/cases/SAFE-FENCE-01.json +17 -0
  56. safesink-0.4.0/benchmark/cases/SAFE-FENCE-02.json +17 -0
  57. safesink-0.4.0/benchmark/cases/SAFE-FENCE-03.json +17 -0
  58. safesink-0.4.0/benchmark/cases/SAFE-FENCE-04.json +17 -0
  59. safesink-0.4.0/benchmark/cases/SAFE-IDEM-01.json +15 -0
  60. safesink-0.4.0/benchmark/cases/SAFE-IDEM-02.json +15 -0
  61. safesink-0.4.0/benchmark/cases/SAFE-IDEM-03.json +15 -0
  62. safesink-0.4.0/benchmark/cases/SAFE-NAIVE-01.json +15 -0
  63. safesink-0.4.0/benchmark/cases/SAFE-NAIVE-02.json +15 -0
  64. safesink-0.4.0/benchmark/cases/SAFE-OUTBOX-01.json +15 -0
  65. safesink-0.4.0/benchmark/cases/SAFE-OUTBOX-02.json +15 -0
  66. safesink-0.4.0/benchmark/cases/SAFE-SINGLE-01.json +15 -0
  67. safesink-0.4.0/benchmark/cases/SAFE-SINGLE-02.json +15 -0
  68. safesink-0.4.0/benchmark/cases/SAFE-SINGLE-03.json +15 -0
  69. safesink-0.4.0/benchmark/cases/STALE-01.json +17 -0
  70. safesink-0.4.0/benchmark/cases/STALE-02.json +17 -0
  71. safesink-0.4.0/benchmark/cases/STALE-03.json +17 -0
  72. safesink-0.4.0/benchmark/corpus.json +216 -0
  73. safesink-0.4.0/benchmark/results.json +375 -0
  74. safesink-0.4.0/build_backend.py +177 -0
  75. safesink-0.4.0/docker-compose.live.yml +29 -0
  76. safesink-0.4.0/docs/EFFECT_SAFETY_PROTOCOL.md +13 -0
  77. safesink-0.4.0/docs/FROZEN_CRASH_RETRY.md +67 -0
  78. safesink-0.4.0/docs/LIVE_KAFKA_POSTGRES.md +107 -0
  79. safesink-0.4.0/docs/MCP_CONFORMANCE.md +204 -0
  80. safesink-0.4.0/effectfence/__init__.py +15 -0
  81. safesink-0.4.0/effectfence/__main__.py +5 -0
  82. safesink-0.4.0/effectfence/benchmark.py +3 -0
  83. safesink-0.4.0/effectfence/cli.py +26 -0
  84. safesink-0.4.0/effectfence/explore.py +3 -0
  85. safesink-0.4.0/effectfence/httpdemo.py +3 -0
  86. safesink-0.4.0/effectfence/io.py +3 -0
  87. safesink-0.4.0/effectfence/ledger.py +3 -0
  88. safesink-0.4.0/effectfence/live.py +3 -0
  89. safesink-0.4.0/effectfence/mcp_client.py +3 -0
  90. safesink-0.4.0/effectfence/mcp_reports.py +3 -0
  91. safesink-0.4.0/effectfence/mcp_scan.py +3 -0
  92. safesink-0.4.0/effectfence/mcp_verifier.py +3 -0
  93. safesink-0.4.0/effectfence/model.py +3 -0
  94. safesink-0.4.0/effectfence/observers.py +3 -0
  95. safesink-0.4.0/effectfence/reports.py +3 -0
  96. safesink-0.4.0/effectfence/schemas/__init__.py +1 -0
  97. safesink-0.4.0/effectfence/schemas/mcp-manifest-v1.schema.json +351 -0
  98. safesink-0.4.0/effectfence/simulator.py +3 -0
  99. safesink-0.4.0/effectfence/sinks.py +3 -0
  100. safesink-0.4.0/examples/crash_after_effect.json +17 -0
  101. safesink-0.4.0/examples/mcp-conformance/failing.json +39 -0
  102. safesink-0.4.0/examples/mcp-conformance/fixture_server.py +165 -0
  103. safesink-0.4.0/examples/mcp-conformance/passing.json +33 -0
  104. safesink-0.4.0/examples/mcp-conformance/reset_fixture.py +12 -0
  105. safesink-0.4.0/examples/safe_fenced_recovery.json +17 -0
  106. safesink-0.4.0/pyproject.toml +44 -0
  107. safesink-0.4.0/ruff.toml +10 -0
  108. safesink-0.4.0/safesink/__init__.py +4 -0
  109. safesink-0.4.0/safesink/__main__.py +2 -0
  110. safesink-0.4.0/safesink/cli.py +262 -0
  111. safesink-0.4.0/safesink/legacy/__init__.py +20 -0
  112. safesink-0.4.0/safesink/legacy/benchmark.py +46 -0
  113. safesink-0.4.0/safesink/legacy/cli.py +225 -0
  114. safesink-0.4.0/safesink/legacy/explore.py +42 -0
  115. safesink-0.4.0/safesink/legacy/httpdemo.py +19 -0
  116. safesink-0.4.0/safesink/legacy/io.py +16 -0
  117. safesink-0.4.0/safesink/legacy/ledger.py +81 -0
  118. safesink-0.4.0/safesink/legacy/live.py +594 -0
  119. safesink-0.4.0/safesink/legacy/model.py +43 -0
  120. safesink-0.4.0/safesink/legacy/reports.py +45 -0
  121. safesink-0.4.0/safesink/legacy/simulator.py +150 -0
  122. safesink-0.4.0/safesink/legacy/sinks.py +32 -0
  123. safesink-0.4.0/safesink/mcp_client.py +323 -0
  124. safesink-0.4.0/safesink/mcp_reports.py +193 -0
  125. safesink-0.4.0/safesink/mcp_scan.py +360 -0
  126. safesink-0.4.0/safesink/mcp_verifier.py +860 -0
  127. safesink-0.4.0/safesink/observers.py +399 -0
  128. safesink-0.4.0/safesink/schemas/__init__.py +1 -0
  129. safesink-0.4.0/safesink/schemas/mcp-manifest-v1.schema.json +351 -0
  130. safesink-0.4.0/scripts/format_check.py +12 -0
  131. safesink-0.4.0/scripts/lint.py +13 -0
  132. safesink-0.4.0/scripts/typecheck.py +36 -0
  133. safesink-0.4.0/scripts/update_evidence_hashes.py +32 -0
  134. safesink-0.4.0/tests/test_build_backend.py +85 -0
  135. safesink-0.4.0/tests/test_ci_free_tier.py +72 -0
  136. safesink-0.4.0/tests/test_live.py +97 -0
  137. safesink-0.4.0/tests/test_mcp_conformance.py +501 -0
  138. safesink-0.4.0/tests/test_mcp_scan.py +240 -0
  139. safesink-0.4.0/tests/test_package_compat.py +147 -0
  140. safesink-0.4.0/tests/test_safesink.py +58 -0
@@ -0,0 +1,4 @@
1
+ # No environment variables are required for deterministic verification.
2
+ # The live Docker Compose example uses this disposable local database:
3
+ EFFECTFENCE_KAFKA_BOOTSTRAP=127.0.0.1:9092
4
+ EFFECTFENCE_POSTGRES_DSN=postgresql://effectfence:effectfence-local-only@127.0.0.1:5432/effectfence
@@ -0,0 +1,14 @@
1
+ version: 2
2
+ updates:
3
+ - package-ecosystem: "pip"
4
+ directory: "/"
5
+ schedule:
6
+ interval: "weekly"
7
+ open-pull-requests-limit: 5
8
+ labels: ["dependencies", "python"]
9
+ - package-ecosystem: "github-actions"
10
+ directory: "/"
11
+ schedule:
12
+ interval: "weekly"
13
+ open-pull-requests-limit: 5
14
+ labels: ["dependencies", "github-actions"]
@@ -0,0 +1,79 @@
1
+ name: live-kafka-postgres
2
+
3
+ on:
4
+ pull_request:
5
+ push:
6
+ branches: [main]
7
+ workflow_dispatch:
8
+
9
+ permissions:
10
+ contents: read
11
+
12
+ concurrency:
13
+ group: live-kafka-postgres-${{ github.ref }}
14
+ cancel-in-progress: true
15
+
16
+ jobs:
17
+ killpoint-proof:
18
+ runs-on: ubuntu-latest
19
+ timeout-minutes: 15
20
+ services:
21
+ kafka:
22
+ image: apache/kafka:4.3.1
23
+ ports:
24
+ - 9092:9092
25
+ options: >-
26
+ --health-cmd "/opt/kafka/bin/kafka-topics.sh --bootstrap-server localhost:9092 --list"
27
+ --health-interval 5s
28
+ --health-timeout 5s
29
+ --health-retries 24
30
+ --health-start-period 20s
31
+ postgres:
32
+ image: postgres:18-alpine
33
+ env:
34
+ POSTGRES_DB: effectfence
35
+ POSTGRES_USER: effectfence
36
+ POSTGRES_PASSWORD: effectfence-ci-only
37
+ ports:
38
+ - 5432:5432
39
+ options: >-
40
+ --health-cmd "pg_isready -U effectfence -d effectfence"
41
+ --health-interval 3s
42
+ --health-timeout 3s
43
+ --health-retries 20
44
+
45
+ env:
46
+ EFFECTFENCE_POSTGRES_DSN: postgresql://effectfence:effectfence-ci-only@127.0.0.1:5432/effectfence
47
+ EFFECTFENCE_KAFKA_BOOTSTRAP: 127.0.0.1:9092
48
+
49
+ steps:
50
+ - uses: actions/checkout@v7
51
+ - uses: actions/setup-python@v7
52
+ with:
53
+ python-version: "3.12"
54
+ cache: pip
55
+ - run: python -m pip install ".[live-kafka-postgres]"
56
+ - name: Verify EffectFence stable identity
57
+ run: >-
58
+ safesink-legacy live-kafka-postgres
59
+ --strategy effectfence
60
+ --expect safe
61
+ --run-id ci-safe
62
+ --broker-version-label apache/kafka:4.3.1
63
+ --timeout 120
64
+ - name: Prove the naive retry control duplicates the effect
65
+ run: >-
66
+ safesink-legacy live-kafka-postgres
67
+ --strategy naive
68
+ --expect unsafe
69
+ --run-id ci-naive-control
70
+ --broker-version-label apache/kafka:4.3.1
71
+ --timeout 120
72
+ - name: Upload evidence
73
+ if: always()
74
+ uses: actions/upload-artifact@v7
75
+ with:
76
+ name: effectfence-live-evidence
77
+ path: out/live/
78
+ if-no-files-found: error
79
+ retention-days: 30
@@ -0,0 +1,37 @@
1
+ name: mcp-conformance
2
+ on:
3
+ push:
4
+ pull_request:
5
+ workflow_dispatch:
6
+
7
+ permissions:
8
+ contents: read
9
+
10
+ concurrency:
11
+ group: mcp-conformance-${{ github.ref }}
12
+ cancel-in-progress: true
13
+
14
+ jobs:
15
+ fixture-conformance:
16
+ runs-on: ubuntu-latest
17
+ timeout-minutes: 10
18
+ steps:
19
+ - uses: actions/checkout@v7
20
+ - uses: actions/setup-python@v7
21
+ with:
22
+ python-version: "3.12"
23
+ - name: Run SafeSink against the passing MCP fixture
24
+ uses: ./
25
+ with:
26
+ manifest: examples/mcp-conformance/passing.json
27
+ out: out/mcp/report.json
28
+ junit: out/mcp/junit.xml
29
+ sarif: out/mcp/report.sarif
30
+ - name: Preserve conformance evidence
31
+ if: always()
32
+ uses: actions/upload-artifact@v7
33
+ with:
34
+ name: safesink-mcp-conformance
35
+ path: out/mcp/
36
+ if-no-files-found: warn
37
+ retention-days: 14
@@ -0,0 +1,46 @@
1
+ name: Publish to PyPI
2
+
3
+ on:
4
+ release:
5
+ types: [published]
6
+
7
+ permissions:
8
+ contents: read
9
+
10
+ jobs:
11
+ build:
12
+ runs-on: ubuntu-latest
13
+ timeout-minutes: 15
14
+ steps:
15
+ - uses: actions/checkout@3d3c42e5aac5ba805825da76410c181273ba90b1 # v7.0.1
16
+ - uses: actions/setup-python@5fda3b95a4ea91299a34e894583c3862153e4b97 # v7.0.0
17
+ with:
18
+ python-version: "3.12"
19
+ - name: Build distributions
20
+ run: |
21
+ python -m pip install --upgrade build
22
+ python -m build
23
+ - name: Store distributions
24
+ uses: actions/upload-artifact@043fb46d1a93c77aae656e7c1c64a875d1fc6a0a # v7.0.1
25
+ with:
26
+ name: python-distributions
27
+ path: dist/
28
+ retention-days: 7
29
+
30
+ publish:
31
+ needs: build
32
+ runs-on: ubuntu-latest
33
+ timeout-minutes: 10
34
+ environment:
35
+ name: pypi
36
+ url: https://pypi.org/p/safesink
37
+ permissions:
38
+ id-token: write
39
+ steps:
40
+ - name: Retrieve distributions
41
+ uses: actions/download-artifact@3e5f45b2cfb9172054b4087a40e8e0b5a5461e7c # v8.0.1
42
+ with:
43
+ name: python-distributions
44
+ path: dist/
45
+ - name: Publish distributions
46
+ uses: pypa/gh-action-pypi-publish@dc37677b2e1c63e2034f94d8a5b11f265b73ba33 # release/v1
@@ -0,0 +1,93 @@
1
+ name: test
2
+ on:
3
+ push:
4
+ branches: [main]
5
+ pull_request:
6
+ workflow_dispatch:
7
+
8
+ permissions:
9
+ contents: read
10
+
11
+ concurrency:
12
+ group: test-${{ github.ref }}
13
+ cancel-in-progress: true
14
+
15
+ jobs:
16
+ test:
17
+ name: test (py${{ matrix.python-version }})
18
+ runs-on: ubuntu-latest
19
+ timeout-minutes: 15
20
+ strategy:
21
+ fail-fast: false
22
+ matrix:
23
+ python-version: ["3.10", "3.12", "3.13"]
24
+ steps:
25
+ - uses: actions/checkout@v7
26
+ - uses: actions/setup-python@v7
27
+ with:
28
+ python-version: ${{ matrix.python-version }}
29
+ cache: pip
30
+ - name: Install
31
+ run: python -m pip install .
32
+ - name: Format hygiene
33
+ run: python scripts/format_check.py
34
+ - name: Syntax lint
35
+ run: python scripts/lint.py
36
+ - name: Type interface check
37
+ run: python scripts/typecheck.py
38
+ - name: Compile
39
+ run: python -m compileall -q safesink effectfence tests
40
+ - name: CLI smoke (both entry points)
41
+ run: |
42
+ safesink --version
43
+ effectfence --version
44
+ safesink-legacy verify examples/safe_fenced_recovery.json
45
+ safesink-legacy --version
46
+ - name: Unit tests
47
+ run: python -m unittest discover -s tests -v
48
+ - name: Benchmark corpus (30 cases)
49
+ run: python -m safesink.legacy.cli benchmark benchmark/corpus.json --out benchmark/results.json
50
+ - name: Keep benchmark results
51
+ if: always() && matrix.python-version == '3.12'
52
+ uses: actions/upload-artifact@v7
53
+ with:
54
+ name: benchmark-results-py${{ matrix.python-version }}
55
+ path: benchmark/results.json
56
+ if-no-files-found: warn
57
+ retention-days: 14
58
+
59
+ installed-wheel:
60
+ name: installed wheel (console scripts)
61
+ runs-on: ubuntu-latest
62
+ timeout-minutes: 10
63
+ steps:
64
+ - uses: actions/checkout@v7
65
+ - uses: actions/setup-python@v7
66
+ with:
67
+ python-version: "3.12"
68
+ - name: Build the wheel with the offline backend
69
+ run: |
70
+ python -m pip install --upgrade pip
71
+ python -m pip wheel --no-deps --no-build-isolation --wheel-dir dist .
72
+ ls -l dist
73
+ - name: Install the wheel into a fresh virtual environment
74
+ run: |
75
+ python -m venv "$RUNNER_TEMP/wheel-venv"
76
+ "$RUNNER_TEMP/wheel-venv/bin/python" -m pip install --no-index dist/*.whl
77
+ # Import from a neutral directory so this proves the wheel, not the checkout.
78
+ cd "$RUNNER_TEMP"
79
+ "$RUNNER_TEMP/wheel-venv/bin/python" -c \
80
+ "import safesink; assert 'site-packages' in safesink.__file__, safesink.__file__; print(safesink.__file__)"
81
+ - name: Exercise the installed console scripts
82
+ run: |
83
+ venv="$RUNNER_TEMP/wheel-venv/bin"
84
+ installed_version="$(cd "$RUNNER_TEMP" && "$venv/python" -c 'import safesink; print(safesink.__version__)')"
85
+ reported="$("$venv/safesink" --version)"
86
+ expected="safesink $installed_version"
87
+ echo "reported: $reported"
88
+ test "$reported" = "$expected"
89
+ "$venv/safesink-legacy" verify examples/safe_fenced_recovery.json
90
+ status=0
91
+ "$venv/safesink-legacy" verify examples/crash_after_effect.json || status=$?
92
+ echo "unsafe fixture exit status: $status"
93
+ test "$status" -eq 2
@@ -0,0 +1,8 @@
1
+ __pycache__/
2
+ *.pyc
3
+ .venv/
4
+ build/
5
+ dist/
6
+ *.egg-info/
7
+ out/
8
+ examples/mcp-conformance/.effectfence-state/
@@ -0,0 +1,15 @@
1
+ # minimal hooks that match CI – keep it cheap, no docker
2
+ repos:
3
+ - repo: https://github.com/astral-sh/ruff-pre-commit
4
+ rev: v0.11.0
5
+ hooks:
6
+ - id: ruff
7
+ args: [--fix, --exit-non-zero-on-fix]
8
+ - id: ruff-format
9
+ - repo: https://github.com/pre-commit/pre-commit-hooks
10
+ rev: v5.0.0
11
+ hooks:
12
+ - id: trailing-whitespace
13
+ - id: end-of-file-fixer
14
+ - id: check-yaml
15
+ args: [--allow-multiple-documents]
@@ -0,0 +1,128 @@
1
+ # Changelog
2
+
3
+ All notable changes will be documented here. This project follows Semantic Versioning and the Keep a Changelog structure.
4
+
5
+ ## 0.3.0 - 2026-08-29
6
+
7
+ - Renamed distribution to `safesink` (clean break from `effectfence` per issue #1). `pip install safesink`, `import safesink`, CLI `safesink`. `effectfence` remains as a deprecated alias (`import effectfence` warns, `effectfence` CLI forwards to `safesink`). Strategy `safesink` is an alias for `effectfence`; env vars `SAFESINK_*` preferred with `EFFECTFENCE_*` fallback.
8
+ - New package `safesink` mirrors `effectfence` 0.2.x; wheel now contains both for transition. `CITATION.cff` and `pyproject.toml` point at `virajsabhaya23/effectfence`, the repository that hosts this code.
9
+
10
+ ## 0.4.0 - 2026-11-21
11
+
12
+ - Added `safesink mcp-check <command>`: scan and verify an MCP server in one
13
+ step, with a temporary sandbox, probe fixtures, destructive tools skipped, and
14
+ a report. This is now the documented first-run path; `mcp-scan` and
15
+ `mcp-verify` remain for curated manifests and CI.
16
+ - `mcp-scan` now seeds the observed sandbox with probe fixtures (a text file, a
17
+ valid 1x1 PNG, and a directory with a nested file) and points synthesized file
18
+ arguments at them, distinguishes source from destination arguments, and marks
19
+ every generated case with `generatedArguments: true`. On
20
+ `@modelcontextprotocol/server-filesystem` 2.4.0 this removed 5 false findings
21
+ out of 13 cases; the remaining case is reported as inconclusive.
22
+ - Added a third verdict, `inconclusive`, with exit code 3, for runs where nothing
23
+ was contradicted but at least one case could not be verified. `pass` is 0 and
24
+ `fail` stays 2. Generated cases whose arguments the server rejects are
25
+ reported as `TOOL_ERROR_ON_GENERATED_ARGUMENTS` instead of a
26
+ `TOOL_ERROR_EXPECTATION_MISMATCH` finding, and JUnit writes those cases as
27
+ `skipped` rather than failed.
28
+ - `IDEMPOTENCY_NOT_EXERCISED` is now only reported for `idempotentHint: true`,
29
+ instead of also for servers that explicitly declare `false`.
30
+ - Removed the citation/adoption scaffolding (`safesink citation`,
31
+ `CITATION.cff`, `docs/CITING.md`, `docs/ADOPTION_EVIDENCE.md`,
32
+ `docs/PRIOR_ART.md`, `BUILD_REPORT.md`) so the repository describes one tool
33
+ instead of an originality record.
34
+ - Split the product in two: `safesink` now exposes only the MCP conformance
35
+ verifier (`mcp-check`, `mcp-verify`, `mcp-scan`). The crash/retry simulator,
36
+ SQLite effect ledger, reference sinks, benchmark corpus, and live
37
+ Kafka/PostgreSQL adapter moved to the frozen `safesink.legacy` subpackage and
38
+ are reachable through the separate `safesink-legacy` console script. See
39
+ `docs/FROZEN_CRASH_RETRY.md`.
40
+ - Fixed the broken distribution metadata: `pyproject.toml` and the wheel
41
+ metadata point at the repository that actually exists
42
+ (`github.com/virajsabhaya23/effectfence`) instead of the nonexistent
43
+ `virajsabhaya23/safesink`, and the README no longer tells readers to run a
44
+ `pip install safesink` that 404s (the name is not on PyPI yet).
45
+ - MCP reports no longer hardcode version `0.2.0`. The JSON report's
46
+ `runtime.version`, the SARIF driver version, the MCP `clientInfo` version, and
47
+ the citation metadata now all read `safesink.__version__`.
48
+ - Added `--version` to the CLI (works as `safesink --version`, `python -m safesink
49
+ --version`, and through the deprecated `effectfence` alias, which reports the
50
+ program name it was invoked as).
51
+ - `effectfence` is now a thin deprecation shim that re-exports `safesink` instead of
52
+ a second copy of the implementation, so fixes can no longer diverge between the
53
+ two import paths. A compatibility test asserts every shimmed module re-exports
54
+ the same public objects, that versions agree, and that both CLI entry points
55
+ return identical verdict exit codes.
56
+ - CI and the local gates (format hygiene, lint, type-interface, compile, benchmark)
57
+ now cover the primary `safesink` package as well as the alias; the type-interface
58
+ gate discovers modules automatically instead of using a hand-maintained list.
59
+ - Fixed the installed `effectfence` console script: it was mapped to
60
+ `safesink.cli:main`, so it advertised itself as `safesink` and skipped the
61
+ deprecation warning. It now routes through `effectfence.cli:main`, and the
62
+ packaging tests assert both entry points and that the backend version matches
63
+ `safesink.__version__`.
64
+ - The unit suite now imports `safesink` directly; only the compatibility test
65
+ exercises the deprecated `effectfence` alias.
66
+ - CI is verified to stay within a free GitHub account: public-repo standard
67
+ `ubuntu-latest` runners only, read-only workflow permissions, per-job timeouts,
68
+ a single benchmark artifact, 7-14 day artifact retention (the Free plan shares
69
+ 500 MB of artifact storage), and manual `workflow_dispatch` entry points. A new
70
+ `tests/test_ci_free_tier.py` fails on macOS/Windows/larger runners, merge-queue
71
+ triggers, CodeQL/Pages uploads, missing timeouts, missing permissions, or
72
+ unbounded artifact retention. PyPI release metadata now names `safesink`.
73
+ - CI runs the gates and suite on Python 3.10, 3.12, and 3.13, and a separate job
74
+ builds the wheel, installs it into a fresh virtual environment, and runs
75
+ `safesink --version` plus the safe and unsafe fixtures through the installed
76
+ console script. A test also asserts `pyproject.toml`'s version matches
77
+ `safesink.__version__`.
78
+
79
+ - Added an observer non-interference control schedule. Every MCP case (and every
80
+ ambiguous-result trial) now runs matched no-tool observation rounds using the
81
+ exact same observer sequence before the tool is invoked. A state transition that
82
+ reproduces without the tool is reported as
83
+ `OBSERVER_OR_BACKGROUND_INTERFERENCE`, suppresses annotation-mismatch
84
+ attribution for that window, and makes the case inconclusive instead of a pass
85
+ or a false violation. Configure with `observerControlRounds` (default 1; set 0
86
+ to opt out and forfeit causal attribution evidence).
87
+ - A case now passes only when it has neither violations nor inconclusive
88
+ evidence, so unresolved checks can no longer be reported as verified.
89
+
90
+ - Added deterministic MCP ambiguous-result retry schedules with repeated,
91
+ observer-backed classifications for committed results, no-effect timeouts,
92
+ duplicate retries, and explicitly inconclusive outcomes.
93
+
94
+ - Reworked deterministic broker delivery so a redelivery count is an attempt
95
+ budget, not a command to invoke a handler after durable progress. Trace
96
+ evidence now records delivery eligibility, skipped deliveries, explicit
97
+ progress-loss faults, and the final broker-delivery state.
98
+ - Replays that find durable idempotency or acceptance evidence now checkpoint
99
+ and acknowledge the message, matching production consumer behavior.
100
+ - Added an MCP stdio conformance runner that negotiates protocol initialization,
101
+ discovers paginated tools, invokes declared cases, and verifies observable
102
+ effects against MCP tool annotations or manifest-owned contracts.
103
+ - Added bounded filesystem, read-only SQLite query, and allowlisted HTTP JSON
104
+ observers with sensitive output redaction enabled by default.
105
+ - Added retry/idempotency, read-only, non-destructive, closed-world, tool-error,
106
+ unknown-tool, and minimum-coverage checks.
107
+ - Added a versioned JSON Schema, public Python API, CLI, composite GitHub Action,
108
+ and redacted JSON, JUnit, and SARIF reports.
109
+ - Added honest and deliberately dishonest MCP fixtures plus fourteen MCP,
110
+ security, and packaging tests, bringing the automated suite to 32 tests.
111
+ - Completed the dependency-free PEP 517 backend for reproducible v0.2 wheels,
112
+ packaged schemas, license metadata, and clean source distributions.
113
+ - Added copy-ready BibTeX/CFF/CSL-like JSON citation output and transparent
114
+ adoption-evidence guidance. No DOI is claimed before archival publication.
115
+ - Added a live Apache Kafka protocol/PostgreSQL adapter for the
116
+ sink-commit-before-offset-commit crash window.
117
+ - Added real `SIGKILL`, consumer restart/redelivery, broker-offset inspection,
118
+ and PostgreSQL effect-count evidence.
119
+ - Added a positive unsafe naive-retry control and harness-validity gating.
120
+ - Added redacted JSON/NDJSON evidence artifacts and a SHA-256 report identifier.
121
+ - Added a local Docker Compose environment and a dedicated GitHub Actions proof.
122
+ - Added six unit tests for the live evidence oracle, trace, configuration, and
123
+ credential redaction.
124
+
125
+ ## 0.1.0 - 2026-08-16
126
+
127
+ - Initial public beta release with the deterministic schedule verifier and
128
+ 30-case benchmark corpus.
@@ -0,0 +1,5 @@
1
+ # Code of conduct
2
+
3
+ We are committed to a respectful, harassment-free community. Be constructive, assume good intent, discuss technical decisions with evidence, respect privacy, and avoid discriminatory or threatening behavior.
4
+
5
+ Maintainers may edit or remove abusive content and may temporarily or permanently restrict participation when necessary to protect the community. Report conduct concerns privately to the repository owner after the public repository is launched. Reports will be handled as confidentially as practical.
@@ -0,0 +1,22 @@
1
+ # Contributing
2
+
3
+ Thank you for helping improve this project.
4
+
5
+ 1. Open an issue describing the problem, expected behavior, and a minimal synthetic example.
6
+ 2. Create a focused change with tests covering success, failure, and malformed-input behavior.
7
+ 3. Run `python scripts/format_check.py`, `python scripts/lint.py`,
8
+ `python scripts/typecheck.py`, and `python -m unittest discover -s tests -v`.
9
+ Changes to the live adapter must also run both the safe strategy and the
10
+ expected-unsafe naive control described in `docs/LIVE_KAFKA_POSTGRES.md`.
11
+ MCP changes must also run both manifests in `examples/mcp-conformance/` and
12
+ confirm that the passing fixture exits 0 while the dishonest fixture exits 2.
13
+ 4. Submit a pull request explaining the behavior change and any compatibility implications.
14
+
15
+ CI must stay usable with a free GitHub account. Every workflow runs on
16
+ `ubuntu-latest` standard runners, declares read-only `permissions`, sets
17
+ per-job timeouts, and bounds artifact retention; standard runners are unmetered
18
+ for public repositories, while macOS/Windows runners, larger runners, and
19
+ GitHub Advanced Security features are billed or paid-only. `tests/test_ci_free_tier.py`
20
+ enforces these limits, so add new jobs within them.
21
+
22
+ Never submit credentials, customer data, or undisclosed third-party vulnerabilities. Security-sensitive findings should follow `SECURITY.md`. By contributing, you agree that your contribution is licensed under Apache-2.0.
@@ -0,0 +1,5 @@
1
+ FROM python:3.12-slim
2
+ WORKDIR /work
3
+ COPY . .
4
+ RUN python -m pip install --no-cache-dir .
5
+ ENTRYPOINT ["safesink"]
safesink-0.4.0/LICENSE ADDED
@@ -0,0 +1,201 @@
1
+ Apache License
2
+ Version 2.0, January 2004
3
+ http://www.apache.org/licenses/
4
+
5
+ TERMS AND CONDITIONS FOR USE, REPRODUCTION, AND DISTRIBUTION
6
+
7
+ 1. Definitions.
8
+
9
+ "License" shall mean the terms and conditions for use, reproduction,
10
+ and distribution as defined by Sections 1 through 9 of this document.
11
+
12
+ "Licensor" shall mean the copyright owner or entity authorized by
13
+ the copyright owner that is granting the License.
14
+
15
+ "Legal Entity" shall mean the union of the acting entity and all
16
+ other entities that control, are controlled by, or are under common
17
+ control with that entity. For the purposes of this definition,
18
+ "control" means (i) the power, direct or indirect, to cause the
19
+ direction or management of such entity, whether by contract or
20
+ otherwise, or (ii) ownership of fifty percent (50%) or more of the
21
+ outstanding shares, or (iii) beneficial ownership of such entity.
22
+
23
+ "You" (or "Your") shall mean an individual or Legal Entity
24
+ exercising permissions granted by this License.
25
+
26
+ "Source" form shall mean the preferred form for making modifications,
27
+ including but not limited to software source code, documentation
28
+ source, and configuration files.
29
+
30
+ "Object" form shall mean any form resulting from mechanical
31
+ transformation or translation of a Source form, including but
32
+ not limited to compiled object code, generated documentation,
33
+ and conversions to other media types.
34
+
35
+ "Work" shall mean the work of authorship, whether in Source or
36
+ Object form, made available under the License, as indicated by a
37
+ copyright notice that is included in or attached to the work
38
+ (an example is provided in the Appendix below).
39
+
40
+ "Derivative Works" shall mean any work, whether in Source or Object
41
+ form, that is based on (or derived from) the Work and for which the
42
+ editorial revisions, annotations, elaborations, or other modifications
43
+ represent, as a whole, an original work of authorship. For the purposes
44
+ of this License, Derivative Works shall not include works that remain
45
+ separable from, or merely link (or bind by name) to the interfaces of,
46
+ the Work and Derivative Works thereof.
47
+
48
+ "Contribution" shall mean any work of authorship, including
49
+ the original version of the Work and any modifications or additions
50
+ to that Work or Derivative Works thereof, that is intentionally
51
+ submitted to Licensor for inclusion in the Work by the copyright owner
52
+ or by an individual or Legal Entity authorized to submit on behalf of
53
+ the copyright owner. For the purposes of this definition, "submitted"
54
+ means any form of electronic, verbal, or written communication sent
55
+ to the Licensor or its representatives, including but not limited to
56
+ communication on electronic mailing lists, source code control systems,
57
+ and issue tracking systems that are managed by, or on behalf of, the
58
+ Licensor for the purpose of discussing and improving the Work, but
59
+ excluding communication that is conspicuously marked or otherwise
60
+ designated in writing by the copyright owner as "Not a Contribution."
61
+
62
+ "Contributor" shall mean Licensor and any individual or Legal Entity
63
+ on behalf of whom a Contribution has been received by Licensor and
64
+ subsequently incorporated within the Work.
65
+
66
+ 2. Grant of Copyright License. Subject to the terms and conditions of
67
+ this License, each Contributor hereby grants to You a perpetual,
68
+ worldwide, non-exclusive, no-charge, royalty-free, irrevocable
69
+ copyright license to reproduce, prepare Derivative Works of,
70
+ publicly display, publicly perform, sublicense, and distribute the
71
+ Work and such Derivative Works in Source or Object form.
72
+
73
+ 3. Grant of Patent License. Subject to the terms and conditions of
74
+ this License, each Contributor hereby grants to You a perpetual,
75
+ worldwide, non-exclusive, no-charge, royalty-free, irrevocable
76
+ (except as stated in this section) patent license to make, have made,
77
+ use, offer to sell, sell, import, and otherwise transfer the Work,
78
+ where such license applies only to those patent claims licensable
79
+ by such Contributor that are necessarily infringed by their
80
+ Contribution(s) alone or by combination of their Contribution(s)
81
+ with the Work to which such Contribution(s) was submitted. If You
82
+ institute patent litigation against any entity (including a
83
+ cross-claim or counterclaim in a lawsuit) alleging that the Work
84
+ or a Contribution incorporated within the Work constitutes direct
85
+ or contributory patent infringement, then any patent licenses
86
+ granted to You under this License for that Work shall terminate
87
+ as of the date such litigation is filed.
88
+
89
+ 4. Redistribution. You may reproduce and distribute copies of the
90
+ Work or Derivative Works thereof in any medium, with or without
91
+ modifications, and in Source or Object form, provided that You
92
+ meet the following conditions:
93
+
94
+ (a) You must give any other recipients of the Work or
95
+ Derivative Works a copy of this License; and
96
+
97
+ (b) You must cause any modified files to carry prominent notices
98
+ stating that You changed the files; and
99
+
100
+ (c) You must retain, in the Source form of any Derivative Works
101
+ that You distribute, all copyright, patent, trademark, and
102
+ attribution notices from the Source form of the Work,
103
+ excluding those notices that do not pertain to any part of
104
+ the Derivative Works; and
105
+
106
+ (d) If the Work includes a "NOTICE" text file as part of its
107
+ distribution, then any Derivative Works that You distribute must
108
+ include a readable copy of the attribution notices contained
109
+ within such NOTICE file, excluding those notices that do not
110
+ pertain to any part of the Derivative Works, in at least one
111
+ of the following places: within a NOTICE text file distributed
112
+ as part of the Derivative Works; within the Source form or
113
+ documentation, if provided along with the Derivative Works; or,
114
+ within a display generated by the Derivative Works, if and
115
+ wherever such third-party notices normally appear. The contents
116
+ of the NOTICE file are for informational purposes only and
117
+ do not modify the License. You may add Your own attribution
118
+ notices within Derivative Works that You distribute, alongside
119
+ or as an addendum to the NOTICE text from the Work, provided
120
+ that such additional attribution notices cannot be construed
121
+ as modifying the License.
122
+
123
+ You may add Your own copyright statement to Your modifications and
124
+ may provide additional or different license terms and conditions
125
+ for use, reproduction, or distribution of Your modifications, or
126
+ for any such Derivative Works as a whole, provided Your use,
127
+ reproduction, and distribution of the Work otherwise complies with
128
+ the conditions stated in this License.
129
+
130
+ 5. Submission of Contributions. Unless You explicitly state otherwise,
131
+ any Contribution intentionally submitted for inclusion in the Work
132
+ by You to the Licensor shall be under the terms and conditions of
133
+ this License, without any additional terms or conditions.
134
+ Notwithstanding the above, nothing herein shall supersede or modify
135
+ the terms of any separate license agreement you may have executed
136
+ with Licensor regarding such Contributions.
137
+
138
+ 6. Trademarks. This License does not grant permission to use the trade
139
+ names, trademarks, service marks, or product names of the Licensor,
140
+ except as required for reasonable and customary use in describing the
141
+ origin of the Work and reproducing the content of the NOTICE file.
142
+
143
+ 7. Disclaimer of Warranty. Unless required by applicable law or
144
+ agreed to in writing, Licensor provides the Work (and each
145
+ Contributor provides its Contributions) on an "AS IS" BASIS,
146
+ WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or
147
+ implied, including, without limitation, any warranties or conditions
148
+ of TITLE, NON-INFRINGEMENT, MERCHANTABILITY, or FITNESS FOR A
149
+ PARTICULAR PURPOSE. You are solely responsible for determining the
150
+ appropriateness of using or redistributing the Work and assume any
151
+ risks associated with Your exercise of permissions under this License.
152
+
153
+ 8. Limitation of Liability. In no event and under no legal theory,
154
+ whether in tort (including negligence), contract, or otherwise,
155
+ unless required by applicable law (such as deliberate and grossly
156
+ negligent acts) or agreed to in writing, shall any Contributor be
157
+ liable to You for damages, including any direct, indirect, special,
158
+ incidental, or consequential damages of any character arising as a
159
+ result of this License or out of the use or inability to use the
160
+ Work (including but not limited to damages for loss of goodwill,
161
+ work stoppage, computer failure or malfunction, or any and all
162
+ other commercial damages or losses), even if such Contributor
163
+ has been advised of the possibility of such damages.
164
+
165
+ 9. Accepting Warranty or Additional Liability. While redistributing
166
+ the Work or Derivative Works thereof, You may choose to offer,
167
+ and charge a fee for, acceptance of support, warranty, indemnity,
168
+ or other liability obligations and/or rights consistent with this
169
+ License. However, in accepting such obligations, You may act only
170
+ on Your own behalf and on Your sole responsibility, not on behalf of
171
+ any other Contributor, and only if You agree to indemnify,
172
+ defend, and hold each Contributor harmless for any liability
173
+ incurred by, or claims asserted against, such Contributor by reason
174
+ of your accepting any such warranty or additional liability.
175
+
176
+ END OF TERMS AND CONDITIONS
177
+
178
+ APPENDIX: How to apply the Apache License to your work.
179
+
180
+ To apply the Apache License to your work, attach the following
181
+ boilerplate notice, with the fields enclosed by brackets "[]"
182
+ replaced with your own identifying information. (Don\'t include
183
+ the brackets!) The text should be enclosed in the appropriate
184
+ comment syntax for the file format. We also recommend that a
185
+ file or class name and description of purpose be included on the
186
+ same "printed page" as the copyright notice for easier
187
+ identification within third-party archives.
188
+
189
+ Copyright [yyyy] [name of copyright owner]
190
+
191
+ Licensed under the Apache License, Version 2.0 (the "License");
192
+ you may not use this file except in compliance with the License.
193
+ You may obtain a copy of the License at
194
+
195
+ http://www.apache.org/licenses/LICENSE-2.0
196
+
197
+ Unless required by applicable law or agreed to in writing, software
198
+ distributed under the License is distributed on an "AS IS" BASIS,
199
+ WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
200
+ See the License for the specific language governing permissions and
201
+ limitations under the License.