longguard 0.2.2__tar.gz → 0.2.4__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 (131) hide show
  1. longguard-0.2.4/.github/workflows/canary.yml +120 -0
  2. {longguard-0.2.2 → longguard-0.2.4}/.github/workflows/ci.yml +50 -40
  3. longguard-0.2.2/.github/workflows/release.yml → longguard-0.2.4/.github/workflows/publish.yml +4 -7
  4. {longguard-0.2.2 → longguard-0.2.4}/CHANGELOG.md +42 -0
  5. {longguard-0.2.2 → longguard-0.2.4}/PKG-INFO +9 -6
  6. {longguard-0.2.2 → longguard-0.2.4}/README.md +5 -3
  7. {longguard-0.2.2 → longguard-0.2.4}/docs/guides/compatibility.md +17 -3
  8. longguard-0.2.4/docs/guides/publishing-standards.md +75 -0
  9. {longguard-0.2.2 → longguard-0.2.4}/docs/index.md +1 -0
  10. {longguard-0.2.2 → longguard-0.2.4}/mkdocs.yml +1 -0
  11. {longguard-0.2.2 → longguard-0.2.4}/pyproject.toml +8 -2
  12. longguard-0.2.4/scripts/canary_issue.py +281 -0
  13. {longguard-0.2.2 → longguard-0.2.4}/scripts/check_version.py +4 -4
  14. {longguard-0.2.2 → longguard-0.2.4}/scripts/prepare_merge_release.py +6 -6
  15. {longguard-0.2.2 → longguard-0.2.4}/scripts/release_notes.py +5 -4
  16. {longguard-0.2.2 → longguard-0.2.4}/scripts/verify_release.py +5 -3
  17. {longguard-0.2.2 → longguard-0.2.4}/src/longguard/__init__.py +1 -1
  18. {longguard-0.2.2 → longguard-0.2.4}/tests/benchmarks/run.py +1 -1
  19. {longguard-0.2.2 → longguard-0.2.4}/tests/test_benchmark.py +2 -2
  20. longguard-0.2.4/tests/test_canary_issue.py +153 -0
  21. {longguard-0.2.2 → longguard-0.2.4}/tests/test_crewai_callback_contracts.py +2 -0
  22. {longguard-0.2.2 → longguard-0.2.4}/tests/test_crewai_execution.py +2 -0
  23. {longguard-0.2.2 → longguard-0.2.4}/tests/test_crewai_integration.py +2 -0
  24. {longguard-0.2.2 → longguard-0.2.4}/tests/test_langchain_integration.py +2 -0
  25. {longguard-0.2.2 → longguard-0.2.4}/tests/test_langgraph_integration.py +4 -0
  26. {longguard-0.2.2 → longguard-0.2.4}/tests/test_langgraph_node_contracts.py +2 -0
  27. {longguard-0.2.2 → longguard-0.2.4}/tests/test_langgraph_resume.py +4 -0
  28. {longguard-0.2.2 → longguard-0.2.4}/tests/test_prepare_merge_release.py +7 -6
  29. {longguard-0.2.2 → longguard-0.2.4}/tests/test_report_persistence.py +4 -4
  30. {longguard-0.2.2 → longguard-0.2.4}/tests/test_strands_integration.py +2 -0
  31. {longguard-0.2.2 → longguard-0.2.4}/uv.lock +183 -32
  32. longguard-0.2.2/.github/workflows/release-on-merge.yml +0 -102
  33. longguard-0.2.2/tests/test_merge_release_workflow.py +0 -99
  34. {longguard-0.2.2 → longguard-0.2.4}/.github/ISSUE_TEMPLATE/bug_report.yml +0 -0
  35. {longguard-0.2.2 → longguard-0.2.4}/.github/ISSUE_TEMPLATE/config.yml +0 -0
  36. {longguard-0.2.2 → longguard-0.2.4}/.github/ISSUE_TEMPLATE/feature_request.yml +0 -0
  37. {longguard-0.2.2 → longguard-0.2.4}/.github/PR_v0.2.0_DRAFT.md +0 -0
  38. {longguard-0.2.2 → longguard-0.2.4}/.github/PULL_REQUEST_TEMPLATE.md +0 -0
  39. {longguard-0.2.2 → longguard-0.2.4}/.github/dependabot.yml +0 -0
  40. {longguard-0.2.2 → longguard-0.2.4}/.github/release.yml +0 -0
  41. {longguard-0.2.2 → longguard-0.2.4}/.github/workflows/docs.yml +0 -0
  42. {longguard-0.2.2 → longguard-0.2.4}/.gitignore +0 -0
  43. {longguard-0.2.2 → longguard-0.2.4}/CODE_OF_CONDUCT.md +0 -0
  44. {longguard-0.2.2 → longguard-0.2.4}/CONTRIBUTING.md +0 -0
  45. {longguard-0.2.2 → longguard-0.2.4}/LICENSE +0 -0
  46. {longguard-0.2.2 → longguard-0.2.4}/SECURITY.md +0 -0
  47. {longguard-0.2.2 → longguard-0.2.4}/SUPPORT.md +0 -0
  48. {longguard-0.2.2 → longguard-0.2.4}/assets/LongGuard-Logo.png +0 -0
  49. {longguard-0.2.2 → longguard-0.2.4}/assets/architecture.svg +0 -0
  50. {longguard-0.2.2 → longguard-0.2.4}/assets/icon.svg +0 -0
  51. {longguard-0.2.2 → longguard-0.2.4}/assets/linkedin_card.png +0 -0
  52. {longguard-0.2.2 → longguard-0.2.4}/assets/linkedin_launch.jpg +0 -0
  53. {longguard-0.2.2 → longguard-0.2.4}/assets/logo-dark.svg +0 -0
  54. {longguard-0.2.2 → longguard-0.2.4}/assets/logo-light.svg +0 -0
  55. {longguard-0.2.2 → longguard-0.2.4}/assets/logo.svg +0 -0
  56. {longguard-0.2.2 → longguard-0.2.4}/docs/assets/LongGuard-Logo.png +0 -0
  57. {longguard-0.2.2 → longguard-0.2.4}/docs/assets/architecture.svg +0 -0
  58. {longguard-0.2.2 → longguard-0.2.4}/docs/assets/icon.svg +0 -0
  59. {longguard-0.2.2 → longguard-0.2.4}/docs/assets/logo-dark.svg +0 -0
  60. {longguard-0.2.2 → longguard-0.2.4}/docs/assets/logo-light.svg +0 -0
  61. {longguard-0.2.2 → longguard-0.2.4}/docs/assets/logo.svg +0 -0
  62. {longguard-0.2.2 → longguard-0.2.4}/docs/changelog.md +0 -0
  63. {longguard-0.2.2 → longguard-0.2.4}/docs/concepts/detectors.md +0 -0
  64. {longguard-0.2.2 → longguard-0.2.4}/docs/concepts/how-it-works.md +0 -0
  65. {longguard-0.2.2 → longguard-0.2.4}/docs/concepts/reflect-and-pivot.md +0 -0
  66. {longguard-0.2.2 → longguard-0.2.4}/docs/contributing.md +0 -0
  67. {longguard-0.2.2 → longguard-0.2.4}/docs/getting-started.md +0 -0
  68. {longguard-0.2.2 → longguard-0.2.4}/docs/guides/benchmarks.md +0 -0
  69. {longguard-0.2.2 → longguard-0.2.4}/docs/guides/configuration.md +0 -0
  70. {longguard-0.2.2 → longguard-0.2.4}/docs/guides/decorator.md +0 -0
  71. {longguard-0.2.2 → longguard-0.2.4}/docs/guides/development-evidence.md +0 -0
  72. {longguard-0.2.2 → longguard-0.2.4}/docs/guides/model-pricing-sources.md +0 -0
  73. {longguard-0.2.2 → longguard-0.2.4}/docs/guides/reporting.md +0 -0
  74. {longguard-0.2.2 → longguard-0.2.4}/docs/integrations/crewai.md +0 -0
  75. {longguard-0.2.2 → longguard-0.2.4}/docs/integrations/langchain.md +0 -0
  76. {longguard-0.2.2 → longguard-0.2.4}/docs/integrations/langgraph.md +0 -0
  77. {longguard-0.2.2 → longguard-0.2.4}/docs/integrations/raw-client.md +0 -0
  78. {longguard-0.2.2 → longguard-0.2.4}/examples/crewai_guarded.py +0 -0
  79. {longguard-0.2.2 → longguard-0.2.4}/examples/custom_detector.py +0 -0
  80. {longguard-0.2.2 → longguard-0.2.4}/examples/langchain_agent.py +0 -0
  81. {longguard-0.2.2 → longguard-0.2.4}/examples/langgraph_basic.py +0 -0
  82. {longguard-0.2.2 → longguard-0.2.4}/examples/langgraph_resume.py +0 -0
  83. {longguard-0.2.2 → longguard-0.2.4}/examples/openai_raw_guard.py +0 -0
  84. {longguard-0.2.2 → longguard-0.2.4}/src/longguard/config.py +0 -0
  85. {longguard-0.2.2 → longguard-0.2.4}/src/longguard/core/__init__.py +0 -0
  86. {longguard-0.2.2 → longguard-0.2.4}/src/longguard/core/breaker.py +0 -0
  87. {longguard-0.2.2 → longguard-0.2.4}/src/longguard/core/decorator.py +0 -0
  88. {longguard-0.2.2 → longguard-0.2.4}/src/longguard/core/detectors/__init__.py +0 -0
  89. {longguard-0.2.2 → longguard-0.2.4}/src/longguard/core/detectors/base.py +0 -0
  90. {longguard-0.2.2 → longguard-0.2.4}/src/longguard/core/detectors/dead_end.py +0 -0
  91. {longguard-0.2.2 → longguard-0.2.4}/src/longguard/core/detectors/semantic_osc.py +0 -0
  92. {longguard-0.2.2 → longguard-0.2.4}/src/longguard/core/detectors/token_velocity.py +0 -0
  93. {longguard-0.2.2 → longguard-0.2.4}/src/longguard/core/detectors/tool_repeat.py +0 -0
  94. {longguard-0.2.2 → longguard-0.2.4}/src/longguard/core/pivot.py +0 -0
  95. {longguard-0.2.2 → longguard-0.2.4}/src/longguard/core/reporter.py +0 -0
  96. {longguard-0.2.2 → longguard-0.2.4}/src/longguard/core/step.py +0 -0
  97. {longguard-0.2.2 → longguard-0.2.4}/src/longguard/integrations/__init__.py +0 -0
  98. {longguard-0.2.2 → longguard-0.2.4}/src/longguard/integrations/crewai.py +0 -0
  99. {longguard-0.2.2 → longguard-0.2.4}/src/longguard/integrations/graph_runner.py +0 -0
  100. {longguard-0.2.2 → longguard-0.2.4}/src/longguard/integrations/langchain.py +0 -0
  101. {longguard-0.2.2 → longguard-0.2.4}/src/longguard/integrations/langgraph.py +0 -0
  102. {longguard-0.2.2 → longguard-0.2.4}/src/longguard/integrations/messages.py +0 -0
  103. {longguard-0.2.2 → longguard-0.2.4}/src/longguard/integrations/strands.py +0 -0
  104. {longguard-0.2.2 → longguard-0.2.4}/src/longguard/pricing.py +0 -0
  105. {longguard-0.2.2 → longguard-0.2.4}/src/longguard/py.typed +0 -0
  106. {longguard-0.2.2 → longguard-0.2.4}/tests/__init__.py +0 -0
  107. {longguard-0.2.2 → longguard-0.2.4}/tests/benchmarks/LABEL_REVIEW.md +0 -0
  108. {longguard-0.2.2 → longguard-0.2.4}/tests/benchmarks/corpus.json +0 -0
  109. {longguard-0.2.2 → longguard-0.2.4}/tests/benchmarks/results/baseline-hash.json +0 -0
  110. {longguard-0.2.2 → longguard-0.2.4}/tests/benchmarks/results/current-hash.json +0 -0
  111. {longguard-0.2.2 → longguard-0.2.4}/tests/conftest.py +0 -0
  112. {longguard-0.2.2 → longguard-0.2.4}/tests/fixtures/report_v014.json +0 -0
  113. {longguard-0.2.2 → longguard-0.2.4}/tests/test_breaker.py +0 -0
  114. {longguard-0.2.2 → longguard-0.2.4}/tests/test_check_version.py +0 -0
  115. {longguard-0.2.2 → longguard-0.2.4}/tests/test_config.py +0 -0
  116. {longguard-0.2.2 → longguard-0.2.4}/tests/test_dead_end.py +0 -0
  117. {longguard-0.2.2 → longguard-0.2.4}/tests/test_decorator.py +0 -0
  118. {longguard-0.2.2 → longguard-0.2.4}/tests/test_decorator_contracts.py +0 -0
  119. {longguard-0.2.2 → longguard-0.2.4}/tests/test_pivot.py +0 -0
  120. {longguard-0.2.2 → longguard-0.2.4}/tests/test_policy_edge_contracts.py +0 -0
  121. {longguard-0.2.2 → longguard-0.2.4}/tests/test_pricing.py +0 -0
  122. {longguard-0.2.2 → longguard-0.2.4}/tests/test_public_exports.py +0 -0
  123. {longguard-0.2.2 → longguard-0.2.4}/tests/test_release_notes.py +0 -0
  124. {longguard-0.2.2 → longguard-0.2.4}/tests/test_reporter.py +0 -0
  125. {longguard-0.2.2 → longguard-0.2.4}/tests/test_semantic_osc.py +0 -0
  126. {longguard-0.2.2 → longguard-0.2.4}/tests/test_step.py +0 -0
  127. {longguard-0.2.2 → longguard-0.2.4}/tests/test_step_adapters.py +0 -0
  128. {longguard-0.2.2 → longguard-0.2.4}/tests/test_terminal_state.py +0 -0
  129. {longguard-0.2.2 → longguard-0.2.4}/tests/test_token_velocity.py +0 -0
  130. {longguard-0.2.2 → longguard-0.2.4}/tests/test_tool_cleanup.py +0 -0
  131. {longguard-0.2.2 → longguard-0.2.4}/tests/test_tool_repeat.py +0 -0
@@ -0,0 +1,120 @@
1
+ name: Upstream Compatibility Canary
2
+
3
+ on:
4
+ schedule:
5
+ - cron: '0 3 * * *' # 03:00 UTC daily
6
+ workflow_dispatch:
7
+ inputs:
8
+ target:
9
+ description: 'Canary target matrix job to run'
10
+ required: true
11
+ default: 'all'
12
+ type: choice
13
+ options:
14
+ - all
15
+ - latest
16
+ - minimum
17
+
18
+ permissions:
19
+ contents: read
20
+ issues: write
21
+
22
+ jobs:
23
+ canary-latest:
24
+ name: Upstream Latest Frameworks (Python 3.12)
25
+ if: github.event_name != 'workflow_dispatch' || inputs.target == 'all' || inputs.target == 'latest'
26
+ runs-on: ubuntu-latest
27
+
28
+ steps:
29
+ - uses: actions/checkout@v7
30
+
31
+ - name: Install uv
32
+ uses: astral-sh/setup-uv@v7
33
+ with:
34
+ version: "latest"
35
+
36
+ - name: Set up Python 3.12
37
+ run: uv python install 3.12
38
+
39
+ - name: Install baseline framework contracts
40
+ run: uv sync --python 3.12 --extra dev --extra langgraph --extra langchain --extra crewai --extra docs
41
+
42
+ - name: Upgrade upstream frameworks to newest compatible releases
43
+ run: |
44
+ uv pip install --upgrade 'langgraph>=1.0.0' 'langchain>=1.0.0' 'crewai>=1.15.19,<1.15.29' 'openai' 'anthropic'
45
+
46
+ - name: Inspect resolved framework versions
47
+ run: >-
48
+ uv run --no-sync python -c "from importlib.metadata import version; print({n: version(n) for n in ('langgraph', 'langchain', 'crewai', 'openai', 'anthropic')})"
49
+
50
+ - name: Run Integration Test Suite
51
+ run: uv run --no-sync pytest -m integration -v
52
+
53
+ - name: Run Release Verification Gate
54
+ run: uv run --no-sync python scripts/verify_release.py
55
+
56
+ - name: Upload Canary Evidence Artifacts
57
+ if: always()
58
+ uses: actions/upload-artifact@v7
59
+ with:
60
+ name: canary-evidence-latest
61
+ path: |
62
+ release-evidence.json
63
+ release-coverage.json
64
+
65
+ - name: Report Canary Failure to GitHub Issues
66
+ if: failure() && github.repository == 'ENDEVSOLS/LongGuard'
67
+ env:
68
+ GITHUB_TOKEN: ${{ secrets.GITHUB_TOKEN }}
69
+ run: |
70
+ uv run --no-sync python scripts/canary_issue.py \
71
+ --target latest \
72
+ --summary "Canary failure: Integration tests or verify_release failed against latest upstream framework packages."
73
+
74
+ canary-minimum:
75
+ name: Minimum Declared Bounds (lowest-direct, Python 3.11)
76
+ if: github.event_name != 'workflow_dispatch' || inputs.target == 'all' || inputs.target == 'minimum'
77
+ runs-on: ubuntu-latest
78
+
79
+ steps:
80
+ - uses: actions/checkout@v7
81
+
82
+ - name: Install uv
83
+ uses: astral-sh/setup-uv@v7
84
+ with:
85
+ version: "latest"
86
+
87
+ - name: Set up Python 3.11
88
+ run: uv python install 3.11
89
+
90
+ - name: Resolve and install lowest declared dependencies
91
+ run: |
92
+ uv sync --python 3.11 --resolution lowest-direct --extra dev --extra langgraph --extra langchain --extra crewai --extra docs
93
+
94
+ - name: Inspect resolved lowest framework versions
95
+ run: >-
96
+ uv run --no-sync python -c "from importlib.metadata import version; print({n: version(n) for n in ('langgraph', 'langchain', 'crewai', 'numpy')})"
97
+
98
+ - name: Run Integration Test Suite
99
+ run: uv run --no-sync pytest -m integration -v
100
+
101
+ - name: Run Release Verification Gate
102
+ run: uv run --no-sync python scripts/verify_release.py
103
+
104
+ - name: Upload Canary Evidence Artifacts
105
+ if: always()
106
+ uses: actions/upload-artifact@v7
107
+ with:
108
+ name: canary-evidence-minimum
109
+ path: |
110
+ release-evidence.json
111
+ release-coverage.json
112
+
113
+ - name: Report Canary Failure to GitHub Issues
114
+ if: failure() && github.repository == 'ENDEVSOLS/LongGuard'
115
+ env:
116
+ GITHUB_TOKEN: ${{ secrets.GITHUB_TOKEN }}
117
+ run: |
118
+ uv run --no-sync python scripts/canary_issue.py \
119
+ --target minimum \
120
+ --summary "Canary failure: Integration tests or verify_release failed against lowest declared dependency bounds (lowest-direct)."
@@ -7,15 +7,9 @@ on:
7
7
  branches: [ main, master ]
8
8
 
9
9
  jobs:
10
- test:
11
- name: Test on Python ${{ matrix.python-version }} (${{ matrix.os }})
12
- runs-on: ${{ matrix.os }}
13
- strategy:
14
- fail-fast: false
15
- matrix:
16
- os: [ubuntu-latest, macos-latest]
17
- python-version: ["3.11", "3.12"]
18
-
10
+ checks:
11
+ name: Code Quality, Typing, Docs & Package Verification
12
+ runs-on: ubuntu-latest
19
13
  steps:
20
14
  - uses: actions/checkout@v7
21
15
 
@@ -24,59 +18,75 @@ jobs:
24
18
  with:
25
19
  version: "latest"
26
20
 
27
- - name: Set up Python ${{ matrix.python-version }}
28
- run: uv python install ${{ matrix.python-version }}
21
+ - name: Set up Python 3.11
22
+ run: uv python install 3.11
29
23
 
30
24
  - name: Install dependencies
31
- run: |
32
- uv sync --python ${{ matrix.python-version }} --extra dev
25
+ run: uv sync --python 3.11 --extra dev
33
26
 
34
27
  - name: Run Ruff Linter & Formatter
35
28
  run: |
36
- uv run --python ${{ matrix.python-version }} ruff check src/ tests/ scripts/
29
+ uv run --python 3.11 ruff check src/ tests/ scripts/
30
+
31
+ - name: Run MyPy Type Checker
32
+ run: uv run --python 3.11 mypy src/
37
33
 
38
34
  - name: Check Version Consistency
39
- run: |
40
- uv run --python ${{ matrix.python-version }} python scripts/check_version.py
35
+ run: uv run --python 3.11 python scripts/check_version.py
41
36
 
42
37
  - name: Strict Documentation Build Check
43
- if: matrix.os == 'ubuntu-latest' && matrix.python-version == '3.12'
44
- run: |
45
- uv run --python ${{ matrix.python-version }} mkdocs build --strict
46
-
47
- - name: Run MyPy Type Checker
48
- run: |
49
- uv run --python ${{ matrix.python-version }} mypy src/
50
-
51
- - name: Run Pytest Suite with Coverage
52
- run: |
53
- uv run --python ${{ matrix.python-version }} pytest tests/ --cov=longguard --cov-report=xml --cov-report=term-missing
38
+ run: uv run --python 3.11 mkdocs build --strict
54
39
 
55
40
  - name: Verify Package Build
56
- run: |
57
- uv build
41
+ run: uv build
58
42
 
59
43
  - name: Validate Built Distribution and Metadata
60
44
  run: |
61
- uv run --python ${{ matrix.python-version }} twine check --strict dist/*
62
- uv run --python ${{ matrix.python-version }} python scripts/check_version.py --check-dist
45
+ uv run --python 3.11 twine check --strict dist/*
46
+ uv run --python 3.11 python scripts/check_version.py --check-dist
63
47
 
64
- frameworks:
65
- name: Real frameworks (${{ matrix.dependencies }})
66
- runs-on: ubuntu-latest
48
+ test:
49
+ name: Test on Python ${{ matrix.python-version }} (${{ matrix.os }})
50
+ needs: [checks]
51
+ runs-on: ${{ matrix.os }}
67
52
  strategy:
68
53
  fail-fast: false
69
54
  matrix:
70
- dependencies: [locked, newest]
55
+ os: [ubuntu-latest, macos-latest, windows-latest]
56
+ python-version: ["3.11", "3.12", "3.13"]
57
+
58
+ steps:
59
+ - uses: actions/checkout@v7
60
+
61
+ - name: Install uv
62
+ uses: astral-sh/setup-uv@v7
63
+ with:
64
+ version: "latest"
65
+
66
+ - name: Set up Python ${{ matrix.python-version }}
67
+ run: uv python install ${{ matrix.python-version }}
68
+
69
+ - name: Install dependencies
70
+ run: uv sync --python ${{ matrix.python-version }} --extra dev
71
+
72
+ - name: Run Pytest Suite with Coverage
73
+ if: matrix.os == 'ubuntu-latest' && matrix.python-version == '3.12'
74
+ run: uv run --python ${{ matrix.python-version }} pytest tests/ --cov=longguard --cov-report=xml --cov-report=term-missing
75
+
76
+ - name: Run Pytest Suite
77
+ if: "!(matrix.os == 'ubuntu-latest' && matrix.python-version == '3.12')"
78
+ run: uv run --python ${{ matrix.python-version }} pytest tests/
79
+
80
+ frameworks:
81
+ name: Real frameworks (locked)
82
+ needs: [checks]
83
+ runs-on: ubuntu-latest
71
84
  steps:
72
85
  - uses: actions/checkout@v7
73
86
  - uses: astral-sh/setup-uv@v7
74
87
  - run: uv python install 3.12
75
88
  - name: Install framework contracts
76
89
  run: uv sync --locked --python 3.12 --extra dev --extra langgraph --extra langchain --extra crewai
77
- - name: Exercise newest compatible frameworks without changing the lockfile
78
- if: matrix.dependencies == 'newest'
79
- run: uv pip install --upgrade 'langgraph>=1.0.0' 'langchain>=1.0.0' 'crewai>=0.28.0,<1.15.29'
80
90
  - name: Require framework presence
81
91
  run: >-
82
92
  uv run --no-sync python -c "from importlib.metadata import version; print({n: version(n) for n in ('langgraph', 'langchain', 'crewai')})"
@@ -85,7 +95,7 @@ jobs:
85
95
  - uses: actions/upload-artifact@v7
86
96
  if: always()
87
97
  with:
88
- name: checks-${{ matrix.dependencies }}
98
+ name: checks-locked
89
99
  path: |
90
100
  release-evidence.json
91
101
  release-coverage.json
@@ -93,5 +103,5 @@ jobs:
93
103
  run: uv run --no-sync python tests/benchmarks/run.py --output /tmp/benchmark.json
94
104
  - uses: actions/upload-artifact@v7
95
105
  with:
96
- name: benchmark-${{ matrix.dependencies }}
106
+ name: benchmark-locked
97
107
  path: /tmp/benchmark.json
@@ -1,4 +1,4 @@
1
- name: Release
1
+ name: Publish to PyPI
2
2
 
3
3
  on:
4
4
  workflow_call:
@@ -12,8 +12,6 @@ on:
12
12
  testpypi:
13
13
  default: false
14
14
  type: boolean
15
- push:
16
- tags: ["v*"]
17
15
  workflow_dispatch:
18
16
  inputs:
19
17
  tag:
@@ -78,10 +76,9 @@ jobs:
78
76
  - name: Determine publish flags
79
77
  id: flags
80
78
  run: |
81
- IS_PUSH="${{ github.event_name == 'push' && startsWith(github.ref, 'refs/tags/v') }}"
82
79
  PUBLISH="${{ inputs.publish == true }}"
83
80
  TESTPYPI="${{ inputs.testpypi == true }}"
84
- if [ "$IS_PUSH" = "true" ] || [ "$PUBLISH" = "true" ]; then
81
+ if [ "$PUBLISH" = "true" ]; then
85
82
  echo "publish=true" >> "$GITHUB_OUTPUT"
86
83
  else
87
84
  echo "publish=false" >> "$GITHUB_OUTPUT"
@@ -124,7 +121,7 @@ jobs:
124
121
  id-token: write
125
122
  steps:
126
123
  - name: Download distribution packages
127
- uses: actions/download-artifact@v7
124
+ uses: actions/download-artifact@v8
128
125
  with:
129
126
  name: dist-packages
130
127
  path: dist
@@ -144,7 +141,7 @@ jobs:
144
141
  id-token: write
145
142
  steps:
146
143
  - name: Download distribution packages
147
- uses: actions/download-artifact@v7
144
+ uses: actions/download-artifact@v8
148
145
  with:
149
146
  name: dist-packages
150
147
  path: dist
@@ -7,6 +7,48 @@ and this project adheres to [Semantic Versioning](https://semver.org/spec/v2.0.0
7
7
 
8
8
  ---
9
9
 
10
+ ## [0.2.4] - 2026-11-16
11
+
12
+ ### Added
13
+
14
+ - Scheduled nightly (03:00 UTC) and on-demand (`workflow_dispatch`) upstream compatibility canary workflow (`.github/workflows/canary.yml`) validating LongGuard against latest upstream releases (`langgraph`, `langchain`, `crewai`, `openai`, `anthropic`) and lowest declared dependency bounds (`lowest-direct`).
15
+ - Automated failure-to-issue reporting and deduplication script (`scripts/canary_issue.py` with test suite `tests/test_canary_issue.py`) automatically creating or appending to GitHub issues labeled `compat-break` on upstream breakages.
16
+ - Selective integration test marker tagging (`pytest.mark.integration`) allowing isolated execution of optional framework contracts (`pytest -m integration`).
17
+ - Published upstream compatibility matrix table and live canary status badge in `docs/guides/compatibility.md` and `README.md`.
18
+ - Documented EnDevSols Long Suite PyPI publishing standards and onboarding checklist in `docs/guides/publishing-standards.md`.
19
+
20
+ ### Changed
21
+
22
+ - Standardized release workflow filename from `.github/workflows/release.yml` to `.github/workflows/publish.yml` to unify PyPI Trusted Publishing configuration across all EnDevSols Long Suite tools (`LongCache`, `LongParser`, `LongGuard`).
23
+ - Aligned CrewAI optional dependency lower bound in `pyproject.toml` to verified functional baseline `crewai>=1.15.19,<1.15.29` (verified support for execution-scoped hooks).
24
+ - Decoupled PR CI framework testing in `.github/workflows/ci.yml` to run strictly against locked dependencies, preventing external upstream package releases from blocking unrelated PRs.
25
+
26
+ ### Compatibility and limits
27
+
28
+ - No runtime behavior change: detectors, circuit breaker state machine, defaults, budget boundaries, and report schemas are identical to 0.2.0.
29
+ - Users installing optional `crewai` extra require `crewai>=1.15.19` for verified sequential ReAct execution hooks.
30
+
31
+ ## [0.2.3] - 2026-11-12
32
+
33
+ ### Added
34
+
35
+ - 9-cell continuous integration matrix across Ubuntu, macOS, and Windows on Python 3.11, 3.12, and 3.13 (`.github/workflows/ci.yml`).
36
+ - Added official `Programming Language :: Python :: 3.13` classifier to `pyproject.toml`.
37
+ - Configured explicit `asyncio_default_fixture_loop_scope = "function"` in pytest configuration for modern pytest-asyncio compatibility.
38
+
39
+ ### Changed
40
+
41
+ - CI efficiency optimization: separated code quality, strict typing (`mypy`), documentation builds (`mkdocs --strict`), and package validation (`twine check`) into a fast standalone quality gates job, eliminating redundant execution across matrix cells.
42
+ - Updated README badges and documentation with verified cross-platform compatibility across Linux, macOS, and Windows.
43
+
44
+ ### Fixed
45
+
46
+ - Enforced explicit `utf-8` encoding across report persistence, version validation, benchmark execution, and test fixtures for Windows compatibility (preventing default ANSI/CP1252 decoding failures).
47
+
48
+ ### Compatibility and limits
49
+
50
+ - No runtime change: detectors, circuit breaker state machine, defaults, budget boundaries, and report schemas are identical to 0.2.0.
51
+
10
52
  ## [0.2.2] - 2026-11-10
11
53
 
12
54
  ### Added
@@ -1,6 +1,6 @@
1
1
  Metadata-Version: 2.5
2
2
  Name: longguard
3
- Version: 0.2.2
3
+ Version: 0.2.4
4
4
  Summary: Circuit breaker middleware for LangGraph/LangChain agents — detect loops, inject Reflect & Pivot, prevent runaway costs
5
5
  Project-URL: Homepage, https://github.com/ENDEVSOLS/LongGuard
6
6
  Project-URL: Repository, https://github.com/ENDEVSOLS/LongGuard
@@ -19,6 +19,7 @@ Classifier: Operating System :: OS Independent
19
19
  Classifier: Programming Language :: Python :: 3
20
20
  Classifier: Programming Language :: Python :: 3.11
21
21
  Classifier: Programming Language :: Python :: 3.12
22
+ Classifier: Programming Language :: Python :: 3.13
22
23
  Classifier: Topic :: Scientific/Engineering :: Artificial Intelligence
23
24
  Classifier: Topic :: Software Development :: Libraries :: Python Modules
24
25
  Classifier: Topic :: System :: Monitoring
@@ -26,7 +27,7 @@ Classifier: Typing :: Typed
26
27
  Requires-Python: >=3.11
27
28
  Requires-Dist: numpy>=1.24.0
28
29
  Provides-Extra: all
29
- Requires-Dist: crewai<1.15.29,>=0.28.0; extra == 'all'
30
+ Requires-Dist: crewai<1.15.29,>=1.15.19; extra == 'all'
30
31
  Requires-Dist: langchain-core>=1.0.0; extra == 'all'
31
32
  Requires-Dist: langchain>=1.0.0; extra == 'all'
32
33
  Requires-Dist: langgraph>=1.0.0; extra == 'all'
@@ -35,7 +36,7 @@ Requires-Dist: mkdocs>=1.5.0; extra == 'all'
35
36
  Requires-Dist: pymdown-extensions>=10.7; extra == 'all'
36
37
  Requires-Dist: sentence-transformers>=2.7.0; extra == 'all'
37
38
  Provides-Extra: crewai
38
- Requires-Dist: crewai<1.15.29,>=0.28.0; extra == 'crewai'
39
+ Requires-Dist: crewai<1.15.29,>=1.15.19; extra == 'crewai'
39
40
  Provides-Extra: dev
40
41
  Requires-Dist: mkdocs-material>=9.5.0; extra == 'dev'
41
42
  Requires-Dist: mkdocs>=1.5.0; extra == 'dev'
@@ -62,7 +63,7 @@ Description-Content-Type: text/markdown
62
63
  <div align="center">
63
64
 
64
65
  <p align="center">
65
- <img src="assets/LongGuard-Logo.png" alt="LongGuard Logo" width="320">
66
+ <img src="https://raw.githubusercontent.com/ENDEVSOLS/LongGuard/main/assets/LongGuard-Logo.png" alt="LongGuard Logo" width="320">
66
67
  </p>
67
68
 
68
69
  **In-flight circuit breaker & reasoning loop recovery for LangGraph & LangChain agents**
@@ -70,12 +71,14 @@ Description-Content-Type: text/markdown
70
71
  [![PyPI version](https://img.shields.io/pypi/v/longguard.svg?color=blue)](https://pypi.org/project/longguard/)
71
72
  [![PyPI Downloads](https://img.shields.io/pypi/dm/longguard.svg?color=blue&label=downloads)](https://pypi.org/project/longguard/)
72
73
  [![Python Versions](https://img.shields.io/pypi/pyversions/longguard.svg)](https://pypi.org/project/longguard/)
74
+ [![Platform: Linux | macOS | Windows](https://img.shields.io/badge/platform-linux%20%7C%20macos%20%7C%20windows-lightgrey.svg)](https://github.com/ENDEVSOLS/LongGuard)
73
75
  [![CI](https://github.com/ENDEVSOLS/LongGuard/actions/workflows/ci.yml/badge.svg)](https://github.com/ENDEVSOLS/LongGuard/actions/workflows/ci.yml)
76
+ [![Canary](https://github.com/ENDEVSOLS/LongGuard/actions/workflows/canary.yml/badge.svg)](https://github.com/ENDEVSOLS/LongGuard/actions/workflows/canary.yml)
74
77
  [![Documentation](https://img.shields.io/badge/docs-mkdocs-blue.svg)](https://endevsols.github.io/LongGuard/)
75
78
  [![License: MIT](https://img.shields.io/badge/License-MIT-yellow.svg)](https://opensource.org/licenses/MIT)
76
79
  [![LangGraph](https://img.shields.io/badge/LangGraph-1.0%2B-orange.svg)](https://github.com/langchain-ai/langgraph)
77
80
  [![LangChain](https://img.shields.io/badge/LangChain-1.0%2B-green.svg)](https://github.com/langchain-ai/langchain)
78
- [![CrewAI](https://img.shields.io/badge/CrewAI-Supported-purple.svg)](https://github.com/crewAIInc/crewAI)
81
+ [![CrewAI](https://img.shields.io/badge/CrewAI-1.15.19%2B-purple.svg)](https://github.com/crewAIInc/crewAI)
79
82
  [![OpenAI](https://img.shields.io/badge/OpenAI-SDK-412991.svg)](https://github.com/openai/openai-python)
80
83
  [![Anthropic](https://img.shields.io/badge/Anthropic-SDK-c75a2b.svg)](https://github.com/anthropic/anthropic-sdk-python)
81
84
 
@@ -155,7 +158,7 @@ pip install longguard[embeddings]
155
158
  pip install longguard[all]
156
159
  ```
157
160
 
158
- > **Python 3.11+ required** as of v0.2.0.
161
+ > **Python 3.11 – 3.13 tested and supported** on Linux, macOS, and Windows.
159
162
 
160
163
  ### 1. LangGraph Integration (1 Line)
161
164
 
@@ -1,7 +1,7 @@
1
1
  <div align="center">
2
2
 
3
3
  <p align="center">
4
- <img src="assets/LongGuard-Logo.png" alt="LongGuard Logo" width="320">
4
+ <img src="https://raw.githubusercontent.com/ENDEVSOLS/LongGuard/main/assets/LongGuard-Logo.png" alt="LongGuard Logo" width="320">
5
5
  </p>
6
6
 
7
7
  **In-flight circuit breaker & reasoning loop recovery for LangGraph & LangChain agents**
@@ -9,12 +9,14 @@
9
9
  [![PyPI version](https://img.shields.io/pypi/v/longguard.svg?color=blue)](https://pypi.org/project/longguard/)
10
10
  [![PyPI Downloads](https://img.shields.io/pypi/dm/longguard.svg?color=blue&label=downloads)](https://pypi.org/project/longguard/)
11
11
  [![Python Versions](https://img.shields.io/pypi/pyversions/longguard.svg)](https://pypi.org/project/longguard/)
12
+ [![Platform: Linux | macOS | Windows](https://img.shields.io/badge/platform-linux%20%7C%20macos%20%7C%20windows-lightgrey.svg)](https://github.com/ENDEVSOLS/LongGuard)
12
13
  [![CI](https://github.com/ENDEVSOLS/LongGuard/actions/workflows/ci.yml/badge.svg)](https://github.com/ENDEVSOLS/LongGuard/actions/workflows/ci.yml)
14
+ [![Canary](https://github.com/ENDEVSOLS/LongGuard/actions/workflows/canary.yml/badge.svg)](https://github.com/ENDEVSOLS/LongGuard/actions/workflows/canary.yml)
13
15
  [![Documentation](https://img.shields.io/badge/docs-mkdocs-blue.svg)](https://endevsols.github.io/LongGuard/)
14
16
  [![License: MIT](https://img.shields.io/badge/License-MIT-yellow.svg)](https://opensource.org/licenses/MIT)
15
17
  [![LangGraph](https://img.shields.io/badge/LangGraph-1.0%2B-orange.svg)](https://github.com/langchain-ai/langgraph)
16
18
  [![LangChain](https://img.shields.io/badge/LangChain-1.0%2B-green.svg)](https://github.com/langchain-ai/langchain)
17
- [![CrewAI](https://img.shields.io/badge/CrewAI-Supported-purple.svg)](https://github.com/crewAIInc/crewAI)
19
+ [![CrewAI](https://img.shields.io/badge/CrewAI-1.15.19%2B-purple.svg)](https://github.com/crewAIInc/crewAI)
18
20
  [![OpenAI](https://img.shields.io/badge/OpenAI-SDK-412991.svg)](https://github.com/openai/openai-python)
19
21
  [![Anthropic](https://img.shields.io/badge/Anthropic-SDK-c75a2b.svg)](https://github.com/anthropic/anthropic-sdk-python)
20
22
 
@@ -94,7 +96,7 @@ pip install longguard[embeddings]
94
96
  pip install longguard[all]
95
97
  ```
96
98
 
97
- > **Python 3.11+ required** as of v0.2.0.
99
+ > **Python 3.11 – 3.13 tested and supported** on Linux, macOS, and Windows.
98
100
 
99
101
  ### 1. LangGraph Integration (1 Line)
100
102
 
@@ -1,8 +1,22 @@
1
1
  # Tested execution and compatibility
2
2
 
3
- LongGuard 0.2.x extends the existing circuit breaker. Package dependency minimums
4
- remain unchanged; they do not guarantee that every permitted framework release supports
5
- these execution contracts. Bare `import longguard` keeps framework dependencies optional.
3
+ [![Upstream Compatibility Canary](https://github.com/ENDEVSOLS/LongGuard/actions/workflows/canary.yml/badge.svg)](https://github.com/ENDEVSOLS/LongGuard/actions/workflows/canary.yml)
4
+
5
+ LongGuard 0.2.x extends the existing circuit breaker. Optional framework dependency
6
+ lower bounds are tested and verified against the execution contracts shown below. Bare `import longguard`
7
+ keeps framework dependencies optional.
8
+
9
+ ## Upstream Compatibility Matrix
10
+
11
+ LongGuard continuously verifies compatibility through scheduled nightly and on-demand canary CI workflows that execute integration test suites against both the lowest declared dependency bounds and the latest upstream releases.
12
+
13
+ | Framework / Library | Declared Minimum | Verified Latest | Canary Status | Verified Integration Contracts |
14
+ |---|---|---|---|---|
15
+ | **LangGraph** | `>=1.0.0` | `1.2.14` | [![Canary](https://github.com/ENDEVSOLS/LongGuard/actions/workflows/canary.yml/badge.svg)](https://github.com/ENDEVSOLS/LongGuard/actions/workflows/canary.yml) | Synchronous 2-node graph execution, `compile_guarded_graph`, `GuardedGraph.resume` checkpoint recovery |
16
+ | **LangChain Core** | `>=1.0.0` | `1.6.7` | Passing | Tool execution wrappers, message normalization, `AIMessage`/`ToolMessage` histories |
17
+ | **LangChain** | `>=1.0.0` | `1.4.3` | Passing | `GuardedAgentExecutor`, callback-driven step and loop interception |
18
+ | **CrewAI** | `>=1.15.19` | `1.15.25` (`<1.15.29`) | Passing | Sequential ReAct `Crew.kickoff` execution, `add_guard_to_crew`, execution-scoped hook API (`crewai.hooks.dispatch`) |
19
+ | **OpenAI / Anthropic Client** | Unpinned | Latest | Passing | Direct client decoration (`@guarded`), unresolved tool call cleanup, usage extraction |
6
20
 
7
21
  ## Execution modes
8
22
 
@@ -0,0 +1,75 @@
1
+ # EnDevSols Long Suite — PyPI Publishing Standards & Checklist
2
+
3
+ This document defines the unified release and publishing standards across all repositories in the **EnDevSols Long Suite** (`LongGuard`, `LongCache`, `LongParser`, `LongProbe`, etc.).
4
+
5
+ Following a uniform workflow name, environment structure, and setup protocol ensures zero friction, predictable CI/CD pipelines, and foolproof PyPI Trusted Publishing configuration.
6
+
7
+ ---
8
+
9
+ ## 1. Unified Workflow Architecture
10
+
11
+ To eliminate configuration drift and avoid claim mismatches on PyPI, **all Long Suite repositories use the identical workflow file path and naming convention**:
12
+
13
+ * **Standard File Path:** `.github/workflows/publish.yml`
14
+ * **Workflow Name:** `Publish to PyPI`
15
+
16
+ ### Why `publish.yml`?
17
+ PyPI Trusted Publishing requires repository owners to declare the exact workflow filename generating the OpenID Connect (OIDC) identity token. By standardizing on `publish.yml` across all tools, maintainers and administrators always register the same filename on PyPI regardless of which tool is being configured.
18
+
19
+ ---
20
+
21
+ ## 2. GitHub Environments Standard
22
+
23
+ Every Long Suite repository must configure two environments under **Settings → Environments**:
24
+
25
+ 1. **`pypi`**:
26
+ - Used for production package publication to [PyPI](https://pypi.org/).
27
+ - Recommended: Configure **Required reviewers** (e.g., repository maintainers / admin) to prevent accidental releases.
28
+ 2. **`testpypi`**:
29
+ - Used for pre-release rehearsals and verification on [TestPyPI](https://test.pypi.org/).
30
+ - Open access for release testing.
31
+
32
+ ---
33
+
34
+ ## 3. PyPI Trusted Publishing Configuration Matrix
35
+
36
+ When registering a GitHub Actions publisher on PyPI or TestPyPI, use the standardized claims:
37
+
38
+ | Field | TestPyPI (`test.pypi.org`) | Production PyPI (`pypi.org`) |
39
+ |---|---|---|
40
+ | **Owner** | `ENDEVSOLS` | `ENDEVSOLS` |
41
+ | **Repository name** | `<RepositoryName>` (e.g. `LongGuard`) | `<RepositoryName>` (e.g. `LongGuard`) |
42
+ | **Workflow name** | `publish.yml` | `publish.yml` |
43
+ | **Environment name** | `testpypi` | `pypi` |
44
+
45
+ > [!IMPORTANT]
46
+ > The **Workflow name** field on PyPI must only contain the file name (`publish.yml`), **never** the full directory path (do not enter `.github/workflows/publish.yml`).
47
+
48
+ ---
49
+
50
+ ## 4. Setup Checklist for New Long Suite Repositories
51
+
52
+ Use this checklist whenever creating a new repository or onboarding a project into the Long Suite:
53
+
54
+ ### Phase A: Repository Setup
55
+ - [ ] Add `.github/workflows/publish.yml` using the suite-standard release template.
56
+ - [ ] Verify that permissions in `publish.yml` include:
57
+ ```yaml
58
+ permissions:
59
+ id-token: write
60
+ contents: write
61
+ ```
62
+ - [ ] In GitHub repo **Settings → Environments**, create:
63
+ - [ ] Environment `pypi`
64
+ - [ ] Environment `testpypi`
65
+
66
+ ### Phase B: PyPI Registration (Complete both at the same time)
67
+ - [ ] Log in to **TestPyPI** (`https://test.pypi.org/manage/account/publishing/`):
68
+ - [ ] Add pending or project publisher for `ENDEVSOLS/<RepositoryName>`, workflow `publish.yml`, environment `testpypi`.
69
+ - [ ] Log in to **Production PyPI** (`https://pypi.org/manage/account/publishing/`):
70
+ - [ ] Add pending or project publisher for `ENDEVSOLS/<RepositoryName>`, workflow `publish.yml`, environment `pypi`.
71
+
72
+ ### Phase C: Rehearsal & Verification
73
+ - [ ] Create a release candidate tag (e.g. `v0.1.0rc1`).
74
+ - [ ] Dispatch `Publish to PyPI` with `testpypi: true` and verify successful publication on TestPyPI.
75
+ - [ ] Dispatch `Publish to PyPI` with `publish: true` for the final tagged stable release.
@@ -11,6 +11,7 @@
11
11
  [![Python 3.11+](https://img.shields.io/badge/python-3.11+-blue.svg)](https://www.python.org/downloads/)
12
12
  [![License: MIT](https://img.shields.io/badge/License-MIT-yellow.svg)](https://opensource.org/licenses/MIT)
13
13
  [![CI](https://github.com/ENDEVSOLS/LongGuard/actions/workflows/ci.yml/badge.svg)](https://github.com/ENDEVSOLS/LongGuard/actions/workflows/ci.yml)
14
+ [![Canary](https://github.com/ENDEVSOLS/LongGuard/actions/workflows/canary.yml/badge.svg)](https://github.com/ENDEVSOLS/LongGuard/actions/workflows/canary.yml)
14
15
 
15
16
  ---
16
17
 
@@ -95,5 +95,6 @@ nav:
95
95
  - Detector Benchmarks: guides/benchmarks.md
96
96
  - Model Pricing Sources: guides/model-pricing-sources.md
97
97
  - Preview Development Evidence: guides/development-evidence.md
98
+ - Publishing Standards: guides/publishing-standards.md
98
99
  - Contributing: contributing.md
99
100
  - Changelog: changelog.md
@@ -4,7 +4,7 @@ build-backend = "hatchling.build"
4
4
 
5
5
  [project]
6
6
  name = "longguard"
7
- version = "0.2.2"
7
+ version = "0.2.4"
8
8
  description = "Circuit breaker middleware for LangGraph/LangChain agents — detect loops, inject Reflect & Pivot, prevent runaway costs"
9
9
  readme = "README.md"
10
10
  license = "MIT"
@@ -38,6 +38,7 @@ classifiers = [
38
38
  "Programming Language :: Python :: 3",
39
39
  "Programming Language :: Python :: 3.11",
40
40
  "Programming Language :: Python :: 3.12",
41
+ "Programming Language :: Python :: 3.13",
41
42
  "Topic :: Software Development :: Libraries :: Python Modules",
42
43
  "Topic :: Scientific/Engineering :: Artificial Intelligence",
43
44
  "Topic :: System :: Monitoring",
@@ -65,7 +66,7 @@ langchain = [
65
66
  "langchain-core>=1.0.0",
66
67
  ]
67
68
  crewai = [
68
- "crewai>=0.28.0,<1.15.29",
69
+ "crewai>=1.15.19,<1.15.29",
69
70
  ]
70
71
  embeddings = [
71
72
  "sentence-transformers>=2.7.0",
@@ -120,9 +121,14 @@ module = [
120
121
  ]
121
122
  ignore_missing_imports = true
122
123
 
124
+ [[tool.mypy.overrides]]
125
+ module = "tests.*"
126
+ ignore_errors = true
127
+
123
128
  [tool.pytest.ini_options]
124
129
  testpaths = ["tests"]
125
130
  asyncio_mode = "auto"
131
+ asyncio_default_fixture_loop_scope = "function"
126
132
  markers = [
127
133
  "integration: marks tests requiring optional dependencies",
128
134
  ]