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.
- sksecurity-1.2.8/.github/workflows/ci.yml +53 -0
- {sksecurity-1.2.7 → sksecurity-1.2.8}/CHANGELOG.md +55 -1
- sksecurity-1.2.8/PKG-INFO +196 -0
- sksecurity-1.2.8/README.md +154 -0
- sksecurity-1.2.8/SKILL.md +66 -0
- sksecurity-1.2.8/SOP.md +208 -0
- sksecurity-1.2.8/docs/ARCHITECTURE.md +41 -0
- sksecurity-1.2.8/docs/EVALUATION-2026-11.md +381 -0
- {sksecurity-1.2.7 → sksecurity-1.2.8}/docs/INFERENCE-GATEWAY.md +1 -1
- {sksecurity-1.2.7 → sksecurity-1.2.8}/docs/QUANTUM_RESISTANCE.md +1 -1
- {sksecurity-1.2.7 → sksecurity-1.2.8}/docs/pqc-progression.md +1 -1
- sksecurity-1.2.8/docs/sweeps/deps.md +56 -0
- sksecurity-1.2.8/docs/sweeps/fs.md +79 -0
- sksecurity-1.2.8/docs/sweeps/mail.md +45 -0
- sksecurity-1.2.8/docs/sweeps/reporting.md +66 -0
- {sksecurity-1.2.7 → sksecurity-1.2.8}/pyproject.toml +5 -23
- {sksecurity-1.2.7 → sksecurity-1.2.8}/scripts/install-runtime.sh +1 -1
- sksecurity-1.2.8/sksecurity/__init__.py +36 -0
- {sksecurity-1.2.7 → sksecurity-1.2.8}/sksecurity/_version.py +3 -3
- sksecurity-1.2.8/sksecurity/cli.py +460 -0
- {sksecurity-1.2.7 → sksecurity-1.2.8}/sksecurity/email_screener.py +69 -6
- sksecurity-1.2.8/sksecurity/filescreen.py +240 -0
- sksecurity-1.2.8/sksecurity/findings.py +61 -0
- {sksecurity-1.2.7 → sksecurity-1.2.8}/sksecurity/honest_claims.py +10 -10
- {sksecurity-1.2.7 → sksecurity-1.2.8}/sksecurity/integration.py +10 -72
- sksecurity-1.2.8/sksecurity/mcp_server.py +187 -0
- sksecurity-1.2.8/sksecurity/report.py +415 -0
- {sksecurity-1.2.7 → sksecurity-1.2.8}/sksecurity/secret_guard.py +2 -2
- sksecurity-1.2.8/sksecurity/sweeps/__init__.py +28 -0
- sksecurity-1.2.8/sksecurity/sweeps/deps.py +312 -0
- sksecurity-1.2.8/sksecurity/sweeps/fs.py +963 -0
- sksecurity-1.2.8/sksecurity/sweeps/mail.py +153 -0
- sksecurity-1.2.8/sksecurity.egg-info/PKG-INFO +196 -0
- sksecurity-1.2.8/sksecurity.egg-info/SOURCES.txt +79 -0
- sksecurity-1.2.8/sksecurity.egg-info/requires.txt +15 -0
- sksecurity-1.2.8/sksecurity.egg-info/scm_file_list.json +74 -0
- sksecurity-1.2.8/sksecurity.egg-info/scm_version.json +8 -0
- sksecurity-1.2.8/tests/conftest.py +55 -0
- sksecurity-1.2.8/tests/test_cli.py +153 -0
- {sksecurity-1.2.7 → sksecurity-1.2.8}/tests/test_email_screener.py +61 -1
- sksecurity-1.2.8/tests/test_filescreen.py +203 -0
- {sksecurity-1.2.7 → sksecurity-1.2.8}/tests/test_integration_adapter.py +6 -44
- sksecurity-1.2.8/tests/test_isolation.py +43 -0
- {sksecurity-1.2.7 → sksecurity-1.2.8}/tests/test_kms.py +0 -3
- sksecurity-1.2.8/tests/test_mcp_server.py +45 -0
- sksecurity-1.2.8/tests/test_never_modifies.py +73 -0
- {sksecurity-1.2.7 → sksecurity-1.2.8}/tests/test_pqc_posture.py +0 -1
- {sksecurity-1.2.7 → sksecurity-1.2.8}/tests/test_pqc_report.py +2 -3
- sksecurity-1.2.8/tests/test_report_itil.py +222 -0
- {sksecurity-1.2.7 → sksecurity-1.2.8}/tests/test_secret_guard.py +1 -1
- sksecurity-1.2.8/tests/test_sweep_contract.py +52 -0
- sksecurity-1.2.8/tests/test_sweep_deps.py +192 -0
- sksecurity-1.2.8/tests/test_sweep_fs.py +351 -0
- sksecurity-1.2.8/tests/test_sweep_mail.py +111 -0
- sksecurity-1.2.7/.env.example +0 -27
- sksecurity-1.2.7/.github/workflows/ci.yml +0 -72
- sksecurity-1.2.7/AI_REMEDIATION_EXPLAINED.md +0 -255
- sksecurity-1.2.7/CONVERSATIONAL_BUG_FIXED.md +0 -190
- sksecurity-1.2.7/DNS_STATUS.md +0 -58
- sksecurity-1.2.7/INSTALLATION_STATUS.md +0 -123
- sksecurity-1.2.7/INTEGRITY_MANIFEST.json +0 -39
- sksecurity-1.2.7/MISSION.md +0 -7
- sksecurity-1.2.7/PKG-INFO +0 -316
- sksecurity-1.2.7/README.md +0 -262
- sksecurity-1.2.7/REVOLUTIONARY_BREAKTHROUGH.md +0 -526
- sksecurity-1.2.7/SKILL.md +0 -232
- sksecurity-1.2.7/SOP.md +0 -397
- sksecurity-1.2.7/WHY_SKSECURITY_IS_PIONEERING.md +0 -234
- sksecurity-1.2.7/ai_remediation_engine.py +0 -368
- sksecurity-1.2.7/assets/dashboard.html +0 -445
- sksecurity-1.2.7/assets/security-logo.svg +0 -34
- sksecurity-1.2.7/bin/cli.js +0 -8
- sksecurity-1.2.7/community-threats/README.md +0 -180
- sksecurity-1.2.7/community-threats/patterns/ai-safety.json +0 -177
- sksecurity-1.2.7/community-threats/patterns/traditional.json +0 -315
- sksecurity-1.2.7/community-threats/schema.json +0 -180
- sksecurity-1.2.7/conversational_handler.py +0 -553
- sksecurity-1.2.7/dashboard.html +0 -1225
- sksecurity-1.2.7/demo_vulnerable.py +0 -20
- sksecurity-1.2.7/demo_vulnerable.py.backup.20260216_024836 +0 -20
- sksecurity-1.2.7/docker/Dockerfile +0 -53
- sksecurity-1.2.7/docker/Dockerfile.alpine +0 -54
- sksecurity-1.2.7/docker/docker-compose.prod.yml +0 -75
- sksecurity-1.2.7/docker/entrypoint.sh +0 -65
- sksecurity-1.2.7/docker-compose.yml +0 -31
- sksecurity-1.2.7/docs/ARCHITECTURE.md +0 -334
- sksecurity-1.2.7/docs/SKSENTRY.md +0 -616
- sksecurity-1.2.7/index.d.ts +0 -4
- sksecurity-1.2.7/index.html +0 -263
- sksecurity-1.2.7/index.js +0 -30
- sksecurity-1.2.7/install.sh +0 -407
- sksecurity-1.2.7/marketing/README.md +0 -40
- sksecurity-1.2.7/marketing/notebookllm-briefing.md +0 -323
- sksecurity-1.2.7/marketing/one-pager.md +0 -90
- sksecurity-1.2.7/marketing/pitch-deck.md +0 -216
- sksecurity-1.2.7/marketing/taglines.md +0 -75
- sksecurity-1.2.7/marketing/video-script.md +0 -199
- sksecurity-1.2.7/openclaw-plugin/package.json +0 -34
- sksecurity-1.2.7/openclaw-plugin/src/index.ts +0 -219
- sksecurity-1.2.7/openclaw-plugin/src/openclaw.plugin.json +0 -10
- sksecurity-1.2.7/package.json +0 -28
- sksecurity-1.2.7/references/installation_guide.md +0 -112
- sksecurity-1.2.7/references/security_config.yml +0 -103
- sksecurity-1.2.7/references/threat_patterns.json +0 -109
- sksecurity-1.2.7/requirements.txt +0 -41
- sksecurity-1.2.7/scripts/advanced_security_system.py +0 -631
- sksecurity-1.2.7/scripts/build-docker.sh +0 -82
- sksecurity-1.2.7/scripts/conversational_security.py +0 -64
- sksecurity-1.2.7/scripts/daily_security_audit.py +0 -214
- sksecurity-1.2.7/scripts/generate-manifest.sh +0 -112
- sksecurity-1.2.7/scripts/install_security.py +0 -469
- sksecurity-1.2.7/scripts/push-docker.sh +0 -76
- sksecurity-1.2.7/scripts/scan_skill.py +0 -246
- sksecurity-1.2.7/scripts/security_dashboard.py +0 -378
- sksecurity-1.2.7/scripts/update_threats.py +0 -163
- sksecurity-1.2.7/skill.yaml +0 -26
- sksecurity-1.2.7/sksecurity/__init__.py +0 -131
- sksecurity-1.2.7/sksecurity/ai_client.py +0 -182
- sksecurity-1.2.7/sksecurity/cli.py +0 -853
- sksecurity-1.2.7/sksecurity/config.py +0 -272
- sksecurity-1.2.7/sksecurity/dashboard.py +0 -387
- sksecurity-1.2.7/sksecurity/database.py +0 -199
- sksecurity-1.2.7/sksecurity/intelligence.py +0 -283
- sksecurity-1.2.7/sksecurity/mcp_server.py +0 -289
- sksecurity-1.2.7/sksecurity/monitor.py +0 -236
- sksecurity-1.2.7/sksecurity/pdf_report.py +0 -257
- sksecurity-1.2.7/sksecurity/quarantine.py +0 -266
- sksecurity-1.2.7/sksecurity/scanner.py +0 -518
- sksecurity-1.2.7/sksecurity/truth_engine.py +0 -265
- sksecurity-1.2.7/sksecurity.egg-info/PKG-INFO +0 -316
- sksecurity-1.2.7/sksecurity.egg-info/SOURCES.txt +0 -135
- sksecurity-1.2.7/sksecurity.egg-info/requires.txt +0 -27
- sksecurity-1.2.7/sksecurity.egg-info/scm_file_list.json +0 -130
- sksecurity-1.2.7/sksecurity.egg-info/scm_version.json +0 -8
- sksecurity-1.2.7/test_vulnerable_code.py +0 -33
- sksecurity-1.2.7/test_vulnerable_code.py.backup.20260216_024723 +0 -33
- sksecurity-1.2.7/tests/test_ai_client.py +0 -83
- sksecurity-1.2.7/tests/test_cli.py +0 -69
- sksecurity-1.2.7/tests/test_config.py +0 -149
- sksecurity-1.2.7/tests/test_dashboard_api.py +0 -516
- sksecurity-1.2.7/tests/test_database.py +0 -171
- sksecurity-1.2.7/tests/test_intelligence.py +0 -185
- sksecurity-1.2.7/tests/test_lazy_import.py +0 -70
- sksecurity-1.2.7/tests/test_monitor.py +0 -160
- sksecurity-1.2.7/tests/test_quarantine.py +0 -196
- sksecurity-1.2.7/tests/test_scanner.py +0 -217
- sksecurity-1.2.7/tests/test_truth_engine.py +0 -157
- {sksecurity-1.2.7 → sksecurity-1.2.8}/.github/workflows/docs-check.yml +0 -0
- {sksecurity-1.2.7 → sksecurity-1.2.8}/.github/workflows/honest-claims.yml +0 -0
- {sksecurity-1.2.7 → sksecurity-1.2.8}/.github/workflows/publish.yml +0 -0
- {sksecurity-1.2.7 → sksecurity-1.2.8}/.github/workflows/secret-scan.yml +0 -0
- {sksecurity-1.2.7 → sksecurity-1.2.8}/.gitignore +0 -0
- {sksecurity-1.2.7 → sksecurity-1.2.8}/.gitleaks-baseline.json +0 -0
- {sksecurity-1.2.7 → sksecurity-1.2.8}/.honestclaims-allow +0 -0
- {sksecurity-1.2.7 → sksecurity-1.2.8}/CODE_OF_CONDUCT.md +0 -0
- {sksecurity-1.2.7 → sksecurity-1.2.8}/CONTRIBUTING.md +0 -0
- {sksecurity-1.2.7 → sksecurity-1.2.8}/LICENSE +0 -0
- {sksecurity-1.2.7 → sksecurity-1.2.8}/SECURITY.md +0 -0
- {sksecurity-1.2.7 → sksecurity-1.2.8}/docs/audit-2026-06-28.md +0 -0
- {sksecurity-1.2.7 → sksecurity-1.2.8}/docs/honest-claims.md +0 -0
- {sksecurity-1.2.7 → sksecurity-1.2.8}/docs/pqc-posture.md +0 -0
- {sksecurity-1.2.7 → sksecurity-1.2.8}/docs/pqc-progression.json +0 -0
- {sksecurity-1.2.7 → sksecurity-1.2.8}/setup.cfg +0 -0
- {sksecurity-1.2.7 → sksecurity-1.2.8}/sksecurity/_ver.py +0 -0
- {sksecurity-1.2.7 → sksecurity-1.2.8}/sksecurity/kms.py +0 -0
- {sksecurity-1.2.7 → sksecurity-1.2.8}/sksecurity/pqc_posture.py +0 -0
- {sksecurity-1.2.7 → sksecurity-1.2.8}/sksecurity/pqc_report.py +0 -0
- {sksecurity-1.2.7 → sksecurity-1.2.8}/sksecurity/pqc_stacks.py +0 -0
- {sksecurity-1.2.7 → sksecurity-1.2.8}/sksecurity.egg-info/dependency_links.txt +0 -0
- {sksecurity-1.2.7 → sksecurity-1.2.8}/sksecurity.egg-info/entry_points.txt +0 -0
- {sksecurity-1.2.7 → sksecurity-1.2.8}/sksecurity.egg-info/top_level.txt +0 -0
- {sksecurity-1.2.7 → sksecurity-1.2.8}/tests/__init__.py +0 -0
- {sksecurity-1.2.7 → sksecurity-1.2.8}/tests/test_honest_claims.py +0 -0
- {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
|
-
## [
|
|
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
|
+
[](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
|
+
[](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`.
|