sksecurity 1.2.7__tar.gz → 1.2.8__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 (174) hide show
  1. sksecurity-1.2.8/.github/workflows/ci.yml +53 -0
  2. {sksecurity-1.2.7 → sksecurity-1.2.8}/CHANGELOG.md +55 -1
  3. sksecurity-1.2.8/PKG-INFO +196 -0
  4. sksecurity-1.2.8/README.md +154 -0
  5. sksecurity-1.2.8/SKILL.md +66 -0
  6. sksecurity-1.2.8/SOP.md +208 -0
  7. sksecurity-1.2.8/docs/ARCHITECTURE.md +41 -0
  8. sksecurity-1.2.8/docs/EVALUATION-2026-11.md +381 -0
  9. {sksecurity-1.2.7 → sksecurity-1.2.8}/docs/INFERENCE-GATEWAY.md +1 -1
  10. {sksecurity-1.2.7 → sksecurity-1.2.8}/docs/QUANTUM_RESISTANCE.md +1 -1
  11. {sksecurity-1.2.7 → sksecurity-1.2.8}/docs/pqc-progression.md +1 -1
  12. sksecurity-1.2.8/docs/sweeps/deps.md +56 -0
  13. sksecurity-1.2.8/docs/sweeps/fs.md +79 -0
  14. sksecurity-1.2.8/docs/sweeps/mail.md +45 -0
  15. sksecurity-1.2.8/docs/sweeps/reporting.md +66 -0
  16. {sksecurity-1.2.7 → sksecurity-1.2.8}/pyproject.toml +5 -23
  17. {sksecurity-1.2.7 → sksecurity-1.2.8}/scripts/install-runtime.sh +1 -1
  18. sksecurity-1.2.8/sksecurity/__init__.py +36 -0
  19. {sksecurity-1.2.7 → sksecurity-1.2.8}/sksecurity/_version.py +3 -3
  20. sksecurity-1.2.8/sksecurity/cli.py +460 -0
  21. {sksecurity-1.2.7 → sksecurity-1.2.8}/sksecurity/email_screener.py +69 -6
  22. sksecurity-1.2.8/sksecurity/filescreen.py +240 -0
  23. sksecurity-1.2.8/sksecurity/findings.py +61 -0
  24. {sksecurity-1.2.7 → sksecurity-1.2.8}/sksecurity/honest_claims.py +10 -10
  25. {sksecurity-1.2.7 → sksecurity-1.2.8}/sksecurity/integration.py +10 -72
  26. sksecurity-1.2.8/sksecurity/mcp_server.py +187 -0
  27. sksecurity-1.2.8/sksecurity/report.py +415 -0
  28. {sksecurity-1.2.7 → sksecurity-1.2.8}/sksecurity/secret_guard.py +2 -2
  29. sksecurity-1.2.8/sksecurity/sweeps/__init__.py +28 -0
  30. sksecurity-1.2.8/sksecurity/sweeps/deps.py +312 -0
  31. sksecurity-1.2.8/sksecurity/sweeps/fs.py +963 -0
  32. sksecurity-1.2.8/sksecurity/sweeps/mail.py +153 -0
  33. sksecurity-1.2.8/sksecurity.egg-info/PKG-INFO +196 -0
  34. sksecurity-1.2.8/sksecurity.egg-info/SOURCES.txt +79 -0
  35. sksecurity-1.2.8/sksecurity.egg-info/requires.txt +15 -0
  36. sksecurity-1.2.8/sksecurity.egg-info/scm_file_list.json +74 -0
  37. sksecurity-1.2.8/sksecurity.egg-info/scm_version.json +8 -0
  38. sksecurity-1.2.8/tests/conftest.py +55 -0
  39. sksecurity-1.2.8/tests/test_cli.py +153 -0
  40. {sksecurity-1.2.7 → sksecurity-1.2.8}/tests/test_email_screener.py +61 -1
  41. sksecurity-1.2.8/tests/test_filescreen.py +203 -0
  42. {sksecurity-1.2.7 → sksecurity-1.2.8}/tests/test_integration_adapter.py +6 -44
  43. sksecurity-1.2.8/tests/test_isolation.py +43 -0
  44. {sksecurity-1.2.7 → sksecurity-1.2.8}/tests/test_kms.py +0 -3
  45. sksecurity-1.2.8/tests/test_mcp_server.py +45 -0
  46. sksecurity-1.2.8/tests/test_never_modifies.py +73 -0
  47. {sksecurity-1.2.7 → sksecurity-1.2.8}/tests/test_pqc_posture.py +0 -1
  48. {sksecurity-1.2.7 → sksecurity-1.2.8}/tests/test_pqc_report.py +2 -3
  49. sksecurity-1.2.8/tests/test_report_itil.py +222 -0
  50. {sksecurity-1.2.7 → sksecurity-1.2.8}/tests/test_secret_guard.py +1 -1
  51. sksecurity-1.2.8/tests/test_sweep_contract.py +52 -0
  52. sksecurity-1.2.8/tests/test_sweep_deps.py +192 -0
  53. sksecurity-1.2.8/tests/test_sweep_fs.py +351 -0
  54. sksecurity-1.2.8/tests/test_sweep_mail.py +111 -0
  55. sksecurity-1.2.7/.env.example +0 -27
  56. sksecurity-1.2.7/.github/workflows/ci.yml +0 -72
  57. sksecurity-1.2.7/AI_REMEDIATION_EXPLAINED.md +0 -255
  58. sksecurity-1.2.7/CONVERSATIONAL_BUG_FIXED.md +0 -190
  59. sksecurity-1.2.7/DNS_STATUS.md +0 -58
  60. sksecurity-1.2.7/INSTALLATION_STATUS.md +0 -123
  61. sksecurity-1.2.7/INTEGRITY_MANIFEST.json +0 -39
  62. sksecurity-1.2.7/MISSION.md +0 -7
  63. sksecurity-1.2.7/PKG-INFO +0 -316
  64. sksecurity-1.2.7/README.md +0 -262
  65. sksecurity-1.2.7/REVOLUTIONARY_BREAKTHROUGH.md +0 -526
  66. sksecurity-1.2.7/SKILL.md +0 -232
  67. sksecurity-1.2.7/SOP.md +0 -397
  68. sksecurity-1.2.7/WHY_SKSECURITY_IS_PIONEERING.md +0 -234
  69. sksecurity-1.2.7/ai_remediation_engine.py +0 -368
  70. sksecurity-1.2.7/assets/dashboard.html +0 -445
  71. sksecurity-1.2.7/assets/security-logo.svg +0 -34
  72. sksecurity-1.2.7/bin/cli.js +0 -8
  73. sksecurity-1.2.7/community-threats/README.md +0 -180
  74. sksecurity-1.2.7/community-threats/patterns/ai-safety.json +0 -177
  75. sksecurity-1.2.7/community-threats/patterns/traditional.json +0 -315
  76. sksecurity-1.2.7/community-threats/schema.json +0 -180
  77. sksecurity-1.2.7/conversational_handler.py +0 -553
  78. sksecurity-1.2.7/dashboard.html +0 -1225
  79. sksecurity-1.2.7/demo_vulnerable.py +0 -20
  80. sksecurity-1.2.7/demo_vulnerable.py.backup.20260216_024836 +0 -20
  81. sksecurity-1.2.7/docker/Dockerfile +0 -53
  82. sksecurity-1.2.7/docker/Dockerfile.alpine +0 -54
  83. sksecurity-1.2.7/docker/docker-compose.prod.yml +0 -75
  84. sksecurity-1.2.7/docker/entrypoint.sh +0 -65
  85. sksecurity-1.2.7/docker-compose.yml +0 -31
  86. sksecurity-1.2.7/docs/ARCHITECTURE.md +0 -334
  87. sksecurity-1.2.7/docs/SKSENTRY.md +0 -616
  88. sksecurity-1.2.7/index.d.ts +0 -4
  89. sksecurity-1.2.7/index.html +0 -263
  90. sksecurity-1.2.7/index.js +0 -30
  91. sksecurity-1.2.7/install.sh +0 -407
  92. sksecurity-1.2.7/marketing/README.md +0 -40
  93. sksecurity-1.2.7/marketing/notebookllm-briefing.md +0 -323
  94. sksecurity-1.2.7/marketing/one-pager.md +0 -90
  95. sksecurity-1.2.7/marketing/pitch-deck.md +0 -216
  96. sksecurity-1.2.7/marketing/taglines.md +0 -75
  97. sksecurity-1.2.7/marketing/video-script.md +0 -199
  98. sksecurity-1.2.7/openclaw-plugin/package.json +0 -34
  99. sksecurity-1.2.7/openclaw-plugin/src/index.ts +0 -219
  100. sksecurity-1.2.7/openclaw-plugin/src/openclaw.plugin.json +0 -10
  101. sksecurity-1.2.7/package.json +0 -28
  102. sksecurity-1.2.7/references/installation_guide.md +0 -112
  103. sksecurity-1.2.7/references/security_config.yml +0 -103
  104. sksecurity-1.2.7/references/threat_patterns.json +0 -109
  105. sksecurity-1.2.7/requirements.txt +0 -41
  106. sksecurity-1.2.7/scripts/advanced_security_system.py +0 -631
  107. sksecurity-1.2.7/scripts/build-docker.sh +0 -82
  108. sksecurity-1.2.7/scripts/conversational_security.py +0 -64
  109. sksecurity-1.2.7/scripts/daily_security_audit.py +0 -214
  110. sksecurity-1.2.7/scripts/generate-manifest.sh +0 -112
  111. sksecurity-1.2.7/scripts/install_security.py +0 -469
  112. sksecurity-1.2.7/scripts/push-docker.sh +0 -76
  113. sksecurity-1.2.7/scripts/scan_skill.py +0 -246
  114. sksecurity-1.2.7/scripts/security_dashboard.py +0 -378
  115. sksecurity-1.2.7/scripts/update_threats.py +0 -163
  116. sksecurity-1.2.7/skill.yaml +0 -26
  117. sksecurity-1.2.7/sksecurity/__init__.py +0 -131
  118. sksecurity-1.2.7/sksecurity/ai_client.py +0 -182
  119. sksecurity-1.2.7/sksecurity/cli.py +0 -853
  120. sksecurity-1.2.7/sksecurity/config.py +0 -272
  121. sksecurity-1.2.7/sksecurity/dashboard.py +0 -387
  122. sksecurity-1.2.7/sksecurity/database.py +0 -199
  123. sksecurity-1.2.7/sksecurity/intelligence.py +0 -283
  124. sksecurity-1.2.7/sksecurity/mcp_server.py +0 -289
  125. sksecurity-1.2.7/sksecurity/monitor.py +0 -236
  126. sksecurity-1.2.7/sksecurity/pdf_report.py +0 -257
  127. sksecurity-1.2.7/sksecurity/quarantine.py +0 -266
  128. sksecurity-1.2.7/sksecurity/scanner.py +0 -518
  129. sksecurity-1.2.7/sksecurity/truth_engine.py +0 -265
  130. sksecurity-1.2.7/sksecurity.egg-info/PKG-INFO +0 -316
  131. sksecurity-1.2.7/sksecurity.egg-info/SOURCES.txt +0 -135
  132. sksecurity-1.2.7/sksecurity.egg-info/requires.txt +0 -27
  133. sksecurity-1.2.7/sksecurity.egg-info/scm_file_list.json +0 -130
  134. sksecurity-1.2.7/sksecurity.egg-info/scm_version.json +0 -8
  135. sksecurity-1.2.7/test_vulnerable_code.py +0 -33
  136. sksecurity-1.2.7/test_vulnerable_code.py.backup.20260216_024723 +0 -33
  137. sksecurity-1.2.7/tests/test_ai_client.py +0 -83
  138. sksecurity-1.2.7/tests/test_cli.py +0 -69
  139. sksecurity-1.2.7/tests/test_config.py +0 -149
  140. sksecurity-1.2.7/tests/test_dashboard_api.py +0 -516
  141. sksecurity-1.2.7/tests/test_database.py +0 -171
  142. sksecurity-1.2.7/tests/test_intelligence.py +0 -185
  143. sksecurity-1.2.7/tests/test_lazy_import.py +0 -70
  144. sksecurity-1.2.7/tests/test_monitor.py +0 -160
  145. sksecurity-1.2.7/tests/test_quarantine.py +0 -196
  146. sksecurity-1.2.7/tests/test_scanner.py +0 -217
  147. sksecurity-1.2.7/tests/test_truth_engine.py +0 -157
  148. {sksecurity-1.2.7 → sksecurity-1.2.8}/.github/workflows/docs-check.yml +0 -0
  149. {sksecurity-1.2.7 → sksecurity-1.2.8}/.github/workflows/honest-claims.yml +0 -0
  150. {sksecurity-1.2.7 → sksecurity-1.2.8}/.github/workflows/publish.yml +0 -0
  151. {sksecurity-1.2.7 → sksecurity-1.2.8}/.github/workflows/secret-scan.yml +0 -0
  152. {sksecurity-1.2.7 → sksecurity-1.2.8}/.gitignore +0 -0
  153. {sksecurity-1.2.7 → sksecurity-1.2.8}/.gitleaks-baseline.json +0 -0
  154. {sksecurity-1.2.7 → sksecurity-1.2.8}/.honestclaims-allow +0 -0
  155. {sksecurity-1.2.7 → sksecurity-1.2.8}/CODE_OF_CONDUCT.md +0 -0
  156. {sksecurity-1.2.7 → sksecurity-1.2.8}/CONTRIBUTING.md +0 -0
  157. {sksecurity-1.2.7 → sksecurity-1.2.8}/LICENSE +0 -0
  158. {sksecurity-1.2.7 → sksecurity-1.2.8}/SECURITY.md +0 -0
  159. {sksecurity-1.2.7 → sksecurity-1.2.8}/docs/audit-2026-06-28.md +0 -0
  160. {sksecurity-1.2.7 → sksecurity-1.2.8}/docs/honest-claims.md +0 -0
  161. {sksecurity-1.2.7 → sksecurity-1.2.8}/docs/pqc-posture.md +0 -0
  162. {sksecurity-1.2.7 → sksecurity-1.2.8}/docs/pqc-progression.json +0 -0
  163. {sksecurity-1.2.7 → sksecurity-1.2.8}/setup.cfg +0 -0
  164. {sksecurity-1.2.7 → sksecurity-1.2.8}/sksecurity/_ver.py +0 -0
  165. {sksecurity-1.2.7 → sksecurity-1.2.8}/sksecurity/kms.py +0 -0
  166. {sksecurity-1.2.7 → sksecurity-1.2.8}/sksecurity/pqc_posture.py +0 -0
  167. {sksecurity-1.2.7 → sksecurity-1.2.8}/sksecurity/pqc_report.py +0 -0
  168. {sksecurity-1.2.7 → sksecurity-1.2.8}/sksecurity/pqc_stacks.py +0 -0
  169. {sksecurity-1.2.7 → sksecurity-1.2.8}/sksecurity.egg-info/dependency_links.txt +0 -0
  170. {sksecurity-1.2.7 → sksecurity-1.2.8}/sksecurity.egg-info/entry_points.txt +0 -0
  171. {sksecurity-1.2.7 → sksecurity-1.2.8}/sksecurity.egg-info/top_level.txt +0 -0
  172. {sksecurity-1.2.7 → sksecurity-1.2.8}/tests/__init__.py +0 -0
  173. {sksecurity-1.2.7 → sksecurity-1.2.8}/tests/test_honest_claims.py +0 -0
  174. {sksecurity-1.2.7 → sksecurity-1.2.8}/tests/test_ratchet_report.py +0 -0
@@ -0,0 +1,53 @@
1
+ name: CI
2
+
3
+ # Pytest CI for the sksecurity Python package.
4
+ # Runs on GitHub-hosted runners (NOT a sovereign host).
5
+ #
6
+ # No exclusions: every test in tests/ runs on the public runner. Tests set
7
+ # SK_STANDALONE=1 and point HOME/SKCAPSTONE_HOME at tmp dirs (tests/conftest.py),
8
+ # so the optional skcapstone package is never needed or touched.
9
+
10
+ on:
11
+ push:
12
+ branches: [main]
13
+ pull_request:
14
+ branches: [main]
15
+
16
+ jobs:
17
+ test:
18
+ name: pytest (py${{ matrix.python-version }})
19
+ runs-on: ubuntu-latest
20
+ strategy:
21
+ fail-fast: false
22
+ matrix:
23
+ python-version: ["3.11", "3.12"]
24
+ steps:
25
+ - uses: actions/checkout@v4
26
+ with:
27
+ # setuptools-scm needs the history and the tags, otherwise the
28
+ # installed version is 0.0.1.dev1+unknown and `--version` is
29
+ # meaningless in CI.
30
+ fetch-depth: 0
31
+ fetch-tags: true
32
+
33
+ - name: Set up Python ${{ matrix.python-version }}
34
+ uses: actions/setup-python@v5
35
+ with:
36
+ python-version: ${{ matrix.python-version }}
37
+ cache: pip
38
+
39
+ - name: Install package + dev deps
40
+ run: |
41
+ python -m pip install --upgrade pip
42
+ pip install ".[dev]"
43
+
44
+ # Flat layout: the package lives at sksecurity/, NOT src/. Lint that path.
45
+ # No `pip install ruff` here: it pulled the LATEST ruff on every run,
46
+ # ignoring the bounded version in the dev extra installed above, so
47
+ # ruff 0.16's wider defaults turned this gate red with no code change.
48
+ - name: Ruff lint
49
+ if: matrix.python-version == '3.12'
50
+ run: ruff check sksecurity/
51
+
52
+ - name: Run pytest
53
+ run: python -m pytest tests/ -v --tb=short
@@ -4,7 +4,61 @@ All notable changes to `sksecurity` are documented here. The format is based on
4
4
  [Keep a Changelog](https://keepachangelog.com/en/1.1.0/), and this project adheres to
5
5
  [Semantic Versioning](https://semver.org/spec/v2.0.0.html).
6
6
 
7
- ## [Unreleased]
7
+ ## [2.0.0] (unreleased)
8
+
9
+ ### Security
10
+
11
+ - Raised `cryptography` to `>=50.0.0,<51.0.0` (the advisory is fixed only in 50.0.0) and `mcp` to `>=1.30.0` to clear the 2026-11-13 dependency sweep findings.
12
+
13
+ Breaking. Version 1.x presented itself as a security operations platform. Most of
14
+ it did not work (five headline commands crashed on a constructor mismatch) and one
15
+ code path would have moved the scanned directory. 2.0 keeps what works and deletes
16
+ the rest.
17
+
18
+ ### Removed (breaking)
19
+
20
+ - CLI commands `scan`, `audit`, `quarantine`, `status`, `update`, `monitor`,
21
+ `dashboard`, `init`, and the global options `--config`, `--ai`, `--ai-model`,
22
+ `--ai-url` (and their `SKSECURITY_AI*` env vars).
23
+ - Modules `scanner`, `quarantine`, `database`, `dashboard`, `pdf_report`,
24
+ `intelligence` (and the `community-threats/` feed, which could never load),
25
+ `truth_engine`, `ai_client`, `monitor`, `config`. Their public names
26
+ (`SecurityScanner`, `SecurityDatabase`, `SecurityMonitor`, `DashboardServer`,
27
+ `QuarantineManager`, `ThreatIntelligence`, `TruthEngine`, `SecurityConfig` and
28
+ helpers such as `quick_scan`) are gone from `sksecurity`.
29
+ - `integration.ensure_schedule`, `unregister_schedule` and `register_self`. The
30
+ package no longer writes skscheduler drop-ins or skcapstone registry entries. A
31
+ leftover `sksecurity_intel_refresh` drop-in calls the removed `update` command and
32
+ should be deleted.
33
+ - MCP tools `scan_path`, `get_events`, `monitor_status`.
34
+ - The `web` and `pdf` extras and the dependencies `sqlalchemy`, `psutil`, `watchdog`,
35
+ `email-validator`, `pyyaml`, `requests`.
36
+ - Repo debris: hype and status docs, `marketing/`, demo and `.backup` files, OpenClaw
37
+ plugin and `skill.yaml`, the JS bridge, static html pages, `INTEGRITY_MANIFEST.json`,
38
+ `requirements.txt`, legacy `scripts/`, `install.sh`, docker files, `references/`,
39
+ `docs/SKSENTRY.md`.
40
+
41
+ ### Fixed
42
+
43
+ - `scan` no longer auto-quarantines. It used to `shutil.move` the whole scanned path
44
+ when the risk score reached the threshold. (Removed together with the command; the
45
+ report-only change landed first.)
46
+ - `screen_input` over MCP called the secret guard. It now calls the email screener.
47
+ - The test suite no longer touches the real `HOME` or `~/.skcapstone`: it sets tmp
48
+ `HOME` and `SKCAPSTONE_HOME` and `SK_STANDALONE=1`. A prior run rewrote
49
+ `~/.skcapstone/registry/sksecurity.json`.
50
+
51
+ ### Kept
52
+
53
+ `guard`, `claims`, `screen`, `pqc-*`, `sksecurity.kms` (imported by skcapstone),
54
+ `sksecurity.pqc_report` (imported by capauth), `integration.alert()`,
55
+ `is_present()`, `level_for_severity()`, `sksecurity.__version__`, and the MCP tools
56
+ `check_secrets` and `screen_input`.
57
+
58
+ ### Docs
59
+
60
+ - README, SOP, SKILL and ARCHITECTURE rewritten to describe what ships, with real
61
+ example output. SOP evidence block updated.
8
62
 
9
63
  ### Operations
10
64
 
@@ -0,0 +1,196 @@
1
+ Metadata-Version: 2.4
2
+ Name: sksecurity
3
+ Version: 1.2.8
4
+ Summary: Secret guard, honest-claims gate, input screening and post-quantum posture reports for AI agent estates
5
+ Author-email: "smilinTux.org" <hello@smilintux.org>
6
+ License-Expression: GPL-3.0-or-later
7
+ Project-URL: Homepage, https://github.com/smilinTux/SKSecurity
8
+ Project-URL: Repository, https://github.com/smilinTux/SKSecurity
9
+ Project-URL: Issues, https://github.com/smilinTux/sksecurity/issues
10
+ Keywords: security,ai,agents,secrets,pqc,post-quantum,claims
11
+ Classifier: Development Status :: 4 - Beta
12
+ Classifier: Intended Audience :: Developers
13
+ Classifier: Intended Audience :: System Administrators
14
+ Classifier: Intended Audience :: Information Technology
15
+ Classifier: Topic :: Security
16
+ Classifier: Topic :: Software Development :: Quality Assurance
17
+ Classifier: Programming Language :: Python :: 3
18
+ Classifier: Programming Language :: Python :: 3.9
19
+ Classifier: Programming Language :: Python :: 3.10
20
+ Classifier: Programming Language :: Python :: 3.11
21
+ Classifier: Programming Language :: Python :: 3.12
22
+ Classifier: Programming Language :: Python :: 3.13
23
+ Classifier: Operating System :: OS Independent
24
+ Classifier: Environment :: Console
25
+ Requires-Python: >=3.9
26
+ Description-Content-Type: text/markdown
27
+ License-File: LICENSE
28
+ Requires-Dist: click<9.0.0,>=8.0.0
29
+ Requires-Dist: cryptography<51.0.0,>=50.0.0
30
+ Requires-Dist: pydantic<3.0,>=2.0
31
+ Requires-Dist: mcp<2.0,>=1.30.0
32
+ Provides-Extra: skcapstone
33
+ Requires-Dist: skcapstone>=0.6.8; extra == "skcapstone"
34
+ Provides-Extra: dev
35
+ Requires-Dist: pytest>=7.4.0; extra == "dev"
36
+ Requires-Dist: pytest-cov>=4.1.0; extra == "dev"
37
+ Requires-Dist: black>=23.0; extra == "dev"
38
+ Requires-Dist: ruff<0.17,>=0.15; extra == "dev"
39
+ Requires-Dist: flake8>=6.0.0; extra == "dev"
40
+ Requires-Dist: mypy>=1.5.0; extra == "dev"
41
+ Dynamic: license-file
42
+
43
+ # SKSecurity
44
+
45
+ [![CI](https://github.com/smilinTux/sksecurity/actions/workflows/ci.yml/badge.svg)](https://github.com/smilinTux/sksecurity/actions/workflows/ci.yml)
46
+
47
+ Small, local security tools for an AI agent estate. Four things ship:
48
+
49
+ | Tool | What it does | Honest limit |
50
+ |---|---|---|
51
+ | `guard` | Finds leaked credentials in files, directories, staged git changes and text. Redacts what it prints. | 12 regexes. Finds known token shapes and `key = "value"` assignments, nothing else. |
52
+ | `claims` | Fails on forbidden crypto overclaims in docs and code ("quantum-proof", "unbreakable"). Runs in CI. | Pattern match. Honest negations and quoted references are allowed. |
53
+ | `screen` | Scores text for phishing, prompt injection and social engineering. | Text-only regex heuristics. A SAFE verdict is not a guarantee. |
54
+ | `pqc-*` | Post-quantum self-report built from live skcomms / SKStacks data. | Reports what the registry says is deployed, per surface. |
55
+
56
+ Also in the package: `sksecurity.kms` (an HKDF + AES-GCM key-wrapping KMS that
57
+ `skcapstone` imports), an MCP server with two tools, and an optional sk-alert
58
+ adapter.
59
+
60
+ Everything is read-only with respect to the files it inspects. Nothing is moved,
61
+ deleted or modified, nothing runs in the background, and there are no network
62
+ calls. License: GPL-3.0-or-later.
63
+
64
+ 2.0 removed the scanner, quarantine, dashboard, threat-intel feed and monitor
65
+ (see [CHANGELOG.md](CHANGELOG.md)). They did not work and one of them moved the
66
+ scanned directory.
67
+
68
+ ## Install
69
+
70
+ ```bash
71
+ pip install sksecurity # CLI: sksecurity, MCP server: sksecurity-mcp
72
+ pip install 'sksecurity[skcapstone]' # optional: publish alerts on sk-alert
73
+ ```
74
+
75
+ ## Examples
76
+
77
+ Output below was produced by running the commands against a throwaway directory
78
+ with a temporary `HOME`.
79
+
80
+ ### guard: find secrets
81
+
82
+ ```console
83
+ $ sksecurity guard scan demo
84
+ 🔐 SKSecurity Secret Guard Report
85
+ ==================================================
86
+ 📁 Target: demo
87
+ 📄 Files Scanned: 1
88
+
89
+ 🚨 Found 1 secret(s):
90
+ ------------------------------
91
+ 🟠 PostgreSQL Connection String
92
+ File: demo/settings.py:3
93
+ Match: post********************app"
94
+ PostgreSQL connection string with credentials
95
+ Fix: Change the database password. Use environment variables.
96
+ $ echo $?
97
+ 1
98
+ ```
99
+
100
+ Other forms: `guard staged` (what would be committed), `guard text "..."`,
101
+ `guard install` (git pre-commit hook), `--format json`. Exit code is 1 when
102
+ secrets are found.
103
+
104
+ ### claims: block overclaims
105
+
106
+ ```console
107
+ $ sksecurity claims text "our link is quantum-proof"
108
+ 🚨 Found 1 overclaim(s):
109
+ 🔴 quantum-proof: quantum-proof
110
+ Say: Say "post-quantum" / "quantum-resistant" and cite FIPS 203/204.
111
+ $ echo $?
112
+ 1
113
+ ```
114
+
115
+ `sksecurity claims scan .` is the CI gate (`.github/workflows/honest-claims.yml`).
116
+ Suppress an honest reference with `# honest-claims: allow` or list a file in
117
+ `.honestclaims-allow`.
118
+
119
+ ### screen: heuristic input screening
120
+
121
+ ```console
122
+ $ sksecurity screen "Your account is suspended. Verify your password at http://paypa1-login.tk/verify" --subject "Urgent: account suspended"
123
+ 🛡️ SKSecurity Email/Input Screening Report
124
+ ==================================================
125
+ 📊 Risk Score: 59.2/100
126
+ 🎯 Verdict: SUSPICIOUS
127
+
128
+ 🚨 Found 1 issue(s):
129
+ ------------------------------
130
+ 🟠 [HIGH] malicious_link
131
+ Suspicious URL: suspicious TLD (.tk), phishing keyword in domain (login)
132
+ Match: "http://paypa1-login.tk/verify"
133
+ Fix: Do not follow this link. Verify with the sender through a trusted channel.
134
+ ```
135
+
136
+ It misses things. `click http://bit.ly/x to verify your password now` with subject
137
+ `Urgent` scores 0 and SAFE. Treat it as one weak signal, not a filter.
138
+
139
+ ### pqc-*: post-quantum posture
140
+
141
+ `pqc-report`, `pqc-posture`, `pqc-dashboard`, `pqc-snapshot` and `pqc-stacks`
142
+ print a per-surface table (`hybrid-pq`, `gated`, `classical`, `symmetric`) with
143
+ FIPS references and honest notes. `--static` shows the model defaults instead of
144
+ live fleet state. `pqc-stacks` needs SKStacks at `~/clawd/SKStacks` or
145
+ `SKSTACKS_ROOT`. `capauth` imports `sksecurity.pqc_report`.
146
+
147
+ ```console
148
+ $ sksecurity pqc-posture --static
149
+ 🔐 PQC Posture - coverage self-report (per surface)
150
+ ======================================================================
151
+ Mode: static (honest claims only - hybrid = either-leg; no overclaims)
152
+
153
+ surface posture wire-tag suite
154
+ ----------------------------------------------------------------------
155
+ dm-ratchet gated pqdr1 x25519-pgp-wrap-v1 → x25519-mlkem768
156
+ group gated kem_suite rsa-pgp-wrap-v1 → x25519-mlkem768
157
+ ...
158
+ transport classical channel: WireGuard/TLS X25519 wireguard-x25519 / tls1.3-x25519
159
+ ```
160
+
161
+ ## MCP server
162
+
163
+ `sksecurity-mcp` speaks stdio and exposes two tools:
164
+
165
+ - `check_secrets`: run the secret guard on text.
166
+ - `screen_input`: run the email/input screener on text (optional `sender`, `subject`).
167
+
168
+ ```json
169
+ {"mcpServers": {"sksecurity": {"command": "sksecurity-mcp"}}}
170
+ ```
171
+
172
+ ## Library use
173
+
174
+ ```python
175
+ from sksecurity import SecretGuard, EmailScreener
176
+ from sksecurity.honest_claims import HonestClaimsScanner
177
+ from sksecurity.kms import KMS # used by skcapstone
178
+ from sksecurity.pqc_report import build_live_report # used by capauth
179
+ ```
180
+
181
+ ## Development
182
+
183
+ ```bash
184
+ pip install -e '.[dev]'
185
+ pytest
186
+ ruff check sksecurity/
187
+ ```
188
+
189
+ The test suite points `HOME` and `SKCAPSTONE_HOME` at tmp dirs and sets
190
+ `SK_STANDALONE=1` (`tests/conftest.py`), so it never touches real state. Keep
191
+ doing that if you run tests some other way.
192
+
193
+ See [SOP.md](SOP.md) for operations, [docs/ARCHITECTURE.md](docs/ARCHITECTURE.md)
194
+ for the module map, [docs/QUANTUM_RESISTANCE.md](docs/QUANTUM_RESISTANCE.md) for the
195
+ PQC inventory, [SECURITY.md](SECURITY.md) to report a vulnerability, and
196
+ [CONTRIBUTING.md](CONTRIBUTING.md).
@@ -0,0 +1,154 @@
1
+ # SKSecurity
2
+
3
+ [![CI](https://github.com/smilinTux/sksecurity/actions/workflows/ci.yml/badge.svg)](https://github.com/smilinTux/sksecurity/actions/workflows/ci.yml)
4
+
5
+ Small, local security tools for an AI agent estate. Four things ship:
6
+
7
+ | Tool | What it does | Honest limit |
8
+ |---|---|---|
9
+ | `guard` | Finds leaked credentials in files, directories, staged git changes and text. Redacts what it prints. | 12 regexes. Finds known token shapes and `key = "value"` assignments, nothing else. |
10
+ | `claims` | Fails on forbidden crypto overclaims in docs and code ("quantum-proof", "unbreakable"). Runs in CI. | Pattern match. Honest negations and quoted references are allowed. |
11
+ | `screen` | Scores text for phishing, prompt injection and social engineering. | Text-only regex heuristics. A SAFE verdict is not a guarantee. |
12
+ | `pqc-*` | Post-quantum self-report built from live skcomms / SKStacks data. | Reports what the registry says is deployed, per surface. |
13
+
14
+ Also in the package: `sksecurity.kms` (an HKDF + AES-GCM key-wrapping KMS that
15
+ `skcapstone` imports), an MCP server with two tools, and an optional sk-alert
16
+ adapter.
17
+
18
+ Everything is read-only with respect to the files it inspects. Nothing is moved,
19
+ deleted or modified, nothing runs in the background, and there are no network
20
+ calls. License: GPL-3.0-or-later.
21
+
22
+ 2.0 removed the scanner, quarantine, dashboard, threat-intel feed and monitor
23
+ (see [CHANGELOG.md](CHANGELOG.md)). They did not work and one of them moved the
24
+ scanned directory.
25
+
26
+ ## Install
27
+
28
+ ```bash
29
+ pip install sksecurity # CLI: sksecurity, MCP server: sksecurity-mcp
30
+ pip install 'sksecurity[skcapstone]' # optional: publish alerts on sk-alert
31
+ ```
32
+
33
+ ## Examples
34
+
35
+ Output below was produced by running the commands against a throwaway directory
36
+ with a temporary `HOME`.
37
+
38
+ ### guard: find secrets
39
+
40
+ ```console
41
+ $ sksecurity guard scan demo
42
+ 🔐 SKSecurity Secret Guard Report
43
+ ==================================================
44
+ 📁 Target: demo
45
+ 📄 Files Scanned: 1
46
+
47
+ 🚨 Found 1 secret(s):
48
+ ------------------------------
49
+ 🟠 PostgreSQL Connection String
50
+ File: demo/settings.py:3
51
+ Match: post********************app"
52
+ PostgreSQL connection string with credentials
53
+ Fix: Change the database password. Use environment variables.
54
+ $ echo $?
55
+ 1
56
+ ```
57
+
58
+ Other forms: `guard staged` (what would be committed), `guard text "..."`,
59
+ `guard install` (git pre-commit hook), `--format json`. Exit code is 1 when
60
+ secrets are found.
61
+
62
+ ### claims: block overclaims
63
+
64
+ ```console
65
+ $ sksecurity claims text "our link is quantum-proof"
66
+ 🚨 Found 1 overclaim(s):
67
+ 🔴 quantum-proof: quantum-proof
68
+ Say: Say "post-quantum" / "quantum-resistant" and cite FIPS 203/204.
69
+ $ echo $?
70
+ 1
71
+ ```
72
+
73
+ `sksecurity claims scan .` is the CI gate (`.github/workflows/honest-claims.yml`).
74
+ Suppress an honest reference with `# honest-claims: allow` or list a file in
75
+ `.honestclaims-allow`.
76
+
77
+ ### screen: heuristic input screening
78
+
79
+ ```console
80
+ $ sksecurity screen "Your account is suspended. Verify your password at http://paypa1-login.tk/verify" --subject "Urgent: account suspended"
81
+ 🛡️ SKSecurity Email/Input Screening Report
82
+ ==================================================
83
+ 📊 Risk Score: 59.2/100
84
+ 🎯 Verdict: SUSPICIOUS
85
+
86
+ 🚨 Found 1 issue(s):
87
+ ------------------------------
88
+ 🟠 [HIGH] malicious_link
89
+ Suspicious URL: suspicious TLD (.tk), phishing keyword in domain (login)
90
+ Match: "http://paypa1-login.tk/verify"
91
+ Fix: Do not follow this link. Verify with the sender through a trusted channel.
92
+ ```
93
+
94
+ It misses things. `click http://bit.ly/x to verify your password now` with subject
95
+ `Urgent` scores 0 and SAFE. Treat it as one weak signal, not a filter.
96
+
97
+ ### pqc-*: post-quantum posture
98
+
99
+ `pqc-report`, `pqc-posture`, `pqc-dashboard`, `pqc-snapshot` and `pqc-stacks`
100
+ print a per-surface table (`hybrid-pq`, `gated`, `classical`, `symmetric`) with
101
+ FIPS references and honest notes. `--static` shows the model defaults instead of
102
+ live fleet state. `pqc-stacks` needs SKStacks at `~/clawd/SKStacks` or
103
+ `SKSTACKS_ROOT`. `capauth` imports `sksecurity.pqc_report`.
104
+
105
+ ```console
106
+ $ sksecurity pqc-posture --static
107
+ 🔐 PQC Posture - coverage self-report (per surface)
108
+ ======================================================================
109
+ Mode: static (honest claims only - hybrid = either-leg; no overclaims)
110
+
111
+ surface posture wire-tag suite
112
+ ----------------------------------------------------------------------
113
+ dm-ratchet gated pqdr1 x25519-pgp-wrap-v1 → x25519-mlkem768
114
+ group gated kem_suite rsa-pgp-wrap-v1 → x25519-mlkem768
115
+ ...
116
+ transport classical channel: WireGuard/TLS X25519 wireguard-x25519 / tls1.3-x25519
117
+ ```
118
+
119
+ ## MCP server
120
+
121
+ `sksecurity-mcp` speaks stdio and exposes two tools:
122
+
123
+ - `check_secrets`: run the secret guard on text.
124
+ - `screen_input`: run the email/input screener on text (optional `sender`, `subject`).
125
+
126
+ ```json
127
+ {"mcpServers": {"sksecurity": {"command": "sksecurity-mcp"}}}
128
+ ```
129
+
130
+ ## Library use
131
+
132
+ ```python
133
+ from sksecurity import SecretGuard, EmailScreener
134
+ from sksecurity.honest_claims import HonestClaimsScanner
135
+ from sksecurity.kms import KMS # used by skcapstone
136
+ from sksecurity.pqc_report import build_live_report # used by capauth
137
+ ```
138
+
139
+ ## Development
140
+
141
+ ```bash
142
+ pip install -e '.[dev]'
143
+ pytest
144
+ ruff check sksecurity/
145
+ ```
146
+
147
+ The test suite points `HOME` and `SKCAPSTONE_HOME` at tmp dirs and sets
148
+ `SK_STANDALONE=1` (`tests/conftest.py`), so it never touches real state. Keep
149
+ doing that if you run tests some other way.
150
+
151
+ See [SOP.md](SOP.md) for operations, [docs/ARCHITECTURE.md](docs/ARCHITECTURE.md)
152
+ for the module map, [docs/QUANTUM_RESISTANCE.md](docs/QUANTUM_RESISTANCE.md) for the
153
+ PQC inventory, [SECURITY.md](SECURITY.md) to report a vulnerability, and
154
+ [CONTRIBUTING.md](CONTRIBUTING.md).
@@ -0,0 +1,66 @@
1
+ ---
2
+ name: sksecurity
3
+ description: Secret leak detection, honest-claims gate for crypto wording, shallow phishing/prompt-injection screening, and post-quantum posture reports. Read-only, local, no network.
4
+ metadata: {"requires":{"bins":["sksecurity"]},"install":[{"id":"pipx","kind":"shell","command":"pipx install 'sksecurity'","bins":["sksecurity"],"label":"Install sksecurity (pipx)"}]}
5
+ ---
6
+
7
+ # SKSecurity
8
+
9
+ Use this when you need to check text or files for leaked credentials, check docs for
10
+ crypto overclaims, screen a message for obvious phishing or injection, or report the
11
+ post-quantum posture of the SK estate. It does not scan code for vulnerabilities,
12
+ quarantine files, monitor processes or fetch threat intelligence (removed in 2.0).
13
+
14
+ Everything is read-only: no command moves, deletes or modifies the files it inspects.
15
+
16
+ ## Commands
17
+
18
+ ```bash
19
+ # Secrets (exit 1 when found; values are redacted in output)
20
+ sksecurity guard scan <path> # file or directory
21
+ sksecurity guard staged # what git would commit
22
+ sksecurity guard text "<string>" # a string
23
+ sksecurity guard install --repo . # git pre-commit hook
24
+ sksecurity guard scan <path> --format json
25
+
26
+ # Honest-claims gate (exit 1 on a forbidden overclaim)
27
+ sksecurity claims scan .
28
+ sksecurity claims text "<string>"
29
+
30
+ # Screening (shallow regex heuristics; SAFE is not a guarantee)
31
+ sksecurity screen "<text>" [--sender a@b.c] [--subject "..."] [--format json]
32
+
33
+ # Post-quantum posture
34
+ sksecurity pqc-report [--static] [--format json]
35
+ sksecurity pqc-posture [--static]
36
+ sksecurity pqc-dashboard | pqc-snapshot | pqc-stacks
37
+ ```
38
+
39
+ ## When to use which
40
+
41
+ | Situation | Command |
42
+ |---|---|
43
+ | About to commit | `guard staged` |
44
+ | Reviewing a directory for committed credentials | `guard scan <dir>` |
45
+ | Writing or reviewing security docs | `claims scan .` |
46
+ | Untrusted text headed for an agent | `screen` (one weak signal, not a filter) |
47
+ | Asked "are we quantum-resistant?" | `pqc-report`, cite the per-surface result |
48
+
49
+ ## Triage
50
+
51
+ - A `guard` finding is a location and a redacted match. Rotate the credential first,
52
+ then remove it. Do not paste the secret value anywhere.
53
+ - A `claims` finding names the phrase and the honest replacement ("post-quantum",
54
+ "quantum-resistant", cite FIPS 203/204/205). Fix the wording; do not allowlist real claims.
55
+ - `screen` misses plenty (for example a bare shortened link plus "verify your password"
56
+ scores SAFE). Do not treat SAFE as clean.
57
+
58
+ ## MCP
59
+
60
+ `sksecurity-mcp` (stdio) exposes `check_secrets` and `screen_input`.
61
+
62
+ ## Notes
63
+
64
+ - Run tests only with a throwaway `HOME` (`tests/conftest.py` enforces it).
65
+ - `SK_STANDALONE=1` disables the optional skcapstone sk-alert adapter.
66
+ - Docs: `README.md`, `SOP.md`, `docs/ARCHITECTURE.md`.