sanityops-cli 0.1.9__tar.gz → 0.1.11__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.
- {sanityops_cli-0.1.9 → sanityops_cli-0.1.11}/CHANGELOG.md +4 -2
- {sanityops_cli-0.1.9 → sanityops_cli-0.1.11}/PKG-INFO +3 -34
- {sanityops_cli-0.1.9 → sanityops_cli-0.1.11}/README.md +2 -33
- {sanityops_cli-0.1.9 → sanityops_cli-0.1.11}/docs/superpowers/plans/2026-09-08-config-command.md +1 -1
- {sanityops_cli-0.1.9 → sanityops_cli-0.1.11}/docs/superpowers/plans/2026-09-20-cross-artifact-rendering.md +1 -1
- {sanityops_cli-0.1.9 → sanityops_cli-0.1.11}/docs/superpowers/plans/2026-09-20-help-panel-migration.md +2 -2
- {sanityops_cli-0.1.9 → sanityops_cli-0.1.11}/docs/superpowers/plans/2026-09-20-repair-feature.md +2 -2
- {sanityops_cli-0.1.9 → sanityops_cli-0.1.11}/docs/superpowers/specs/2026-09-08-config-command-design.md +2 -2
- {sanityops_cli-0.1.9 → sanityops_cli-0.1.11}/docs/superpowers/specs/2026-09-20-cross-artifact-rendering-design.md +1 -1
- {sanityops_cli-0.1.9 → sanityops_cli-0.1.11}/docs/superpowers/specs/2026-09-20-help-panel-migration-design.md +6 -6
- {sanityops_cli-0.1.9 → sanityops_cli-0.1.11}/docs/superpowers/specs/2026-09-20-repair-feature-design.md +4 -4
- {sanityops_cli-0.1.9 → sanityops_cli-0.1.11}/pyproject.toml +1 -1
- {sanityops_cli-0.1.9 → sanityops_cli-0.1.11}/src/sanityops_cli/__init__.py +1 -1
- {sanityops_cli-0.1.9 → sanityops_cli-0.1.11}/src/sanityops_cli/agents/scanner_agent/models/finding.py +36 -7
- {sanityops_cli-0.1.9 → sanityops_cli-0.1.11}/src/sanityops_cli/agents/scanner_agent/prompts.py +114 -18
- {sanityops_cli-0.1.9 → sanityops_cli-0.1.11}/src/sanityops_cli/agents/scanner_agent/tools/grep_tool.py +1 -1
- {sanityops_cli-0.1.9 → sanityops_cli-0.1.11}/src/sanityops_cli/agents/scanner_agent/tools/readfile_tool.py +1 -1
- {sanityops_cli-0.1.9 → sanityops_cli-0.1.11}/src/sanityops_cli/commands/inspect.py +6 -12
- {sanityops_cli-0.1.9 → sanityops_cli-0.1.11}/src/sanityops_cli/defect_checker/checker.py +1 -1
- {sanityops_cli-0.1.9 → sanityops_cli-0.1.11}/src/sanityops_cli/defect_checker/markdown_reporter.py +4 -28
- {sanityops_cli-0.1.9 → sanityops_cli-0.1.11}/src/sanityops_cli/defect_checker/renderer.py +3 -13
- {sanityops_cli-0.1.9 → sanityops_cli-0.1.11}/src/sanityops_cli/help_panel.py +2 -3
- {sanityops_cli-0.1.9 → sanityops_cli-0.1.11}/tests/commands/test_inspect_repair.py +8 -9
- {sanityops_cli-0.1.9 → sanityops_cli-0.1.11}/tests/test_help_panel.py +1 -3
- {sanityops_cli-0.1.9 → sanityops_cli-0.1.11}/tests/unit/commands/test_inspect.py +67 -0
- {sanityops_cli-0.1.9 → sanityops_cli-0.1.11}/tests/unit/defect_checker/test_checker.py +2 -2
- {sanityops_cli-0.1.9 → sanityops_cli-0.1.11}/tests/unit/defect_checker/test_markdown_reporter.py +80 -25
- {sanityops_cli-0.1.9 → sanityops_cli-0.1.11}/.github/ISSUE_TEMPLATE/bug_report.yml +0 -0
- {sanityops_cli-0.1.9 → sanityops_cli-0.1.11}/.github/ISSUE_TEMPLATE/config.yml +0 -0
- {sanityops_cli-0.1.9 → sanityops_cli-0.1.11}/.github/ISSUE_TEMPLATE/feature_request.yml +0 -0
- {sanityops_cli-0.1.9 → sanityops_cli-0.1.11}/.github/PULL_REQUEST_TEMPLATE.md +0 -0
- {sanityops_cli-0.1.9 → sanityops_cli-0.1.11}/.github/dependabot.yml +0 -0
- {sanityops_cli-0.1.9 → sanityops_cli-0.1.11}/.github/scripts/pr_review_bot.py +0 -0
- {sanityops_cli-0.1.9 → sanityops_cli-0.1.11}/.github/workflows/ai-review.yml +0 -0
- {sanityops_cli-0.1.9 → sanityops_cli-0.1.11}/.github/workflows/ci.yml +0 -0
- {sanityops_cli-0.1.9 → sanityops_cli-0.1.11}/.github/workflows/release.yml +0 -0
- {sanityops_cli-0.1.9 → sanityops_cli-0.1.11}/.gitignore +0 -0
- {sanityops_cli-0.1.9 → sanityops_cli-0.1.11}/CODE_OF_CONDUCT.md +0 -0
- {sanityops_cli-0.1.9 → sanityops_cli-0.1.11}/CONTRIBUTING.md +0 -0
- {sanityops_cli-0.1.9 → sanityops_cli-0.1.11}/LICENSE +0 -0
- {sanityops_cli-0.1.9 → sanityops_cli-0.1.11}/NOTICE +0 -0
- {sanityops_cli-0.1.9 → sanityops_cli-0.1.11}/SECURITY.md +0 -0
- {sanityops_cli-0.1.9 → sanityops_cli-0.1.11}/docs/superpowers/plans/2026-08-13-model-config-comments-in-init-template.md +0 -0
- {sanityops_cli-0.1.9 → sanityops_cli-0.1.11}/docs/superpowers/plans/2026-08-14-loading-animations.md +0 -0
- {sanityops_cli-0.1.9 → sanityops_cli-0.1.11}/docs/superpowers/plans/2026-08-14-skills-files-banner-readme.md +0 -0
- {sanityops_cli-0.1.9 → sanityops_cli-0.1.11}/docs/superpowers/plans/2026-08-28-copyright-compliance.md +0 -0
- {sanityops_cli-0.1.9 → sanityops_cli-0.1.11}/docs/superpowers/specs/2026-08-13-model-config-comments-in-init-template-design.md +0 -0
- {sanityops_cli-0.1.9 → sanityops_cli-0.1.11}/docs/superpowers/specs/2026-08-14-loading-animations-design.md +0 -0
- {sanityops_cli-0.1.9 → sanityops_cli-0.1.11}/docs/superpowers/specs/2026-08-14-skills-files-banner-readme-design.md +0 -0
- {sanityops_cli-0.1.9 → sanityops_cli-0.1.11}/docs/superpowers/specs/2026-08-28-copyright-compliance-design.md +0 -0
- {sanityops_cli-0.1.9 → sanityops_cli-0.1.11}/entry.py +0 -0
- {sanityops_cli-0.1.9 → sanityops_cli-0.1.11}/release.sh +0 -0
- {sanityops_cli-0.1.9 → sanityops_cli-0.1.11}/scripts/generate-checksums.ps1 +0 -0
- {sanityops_cli-0.1.9 → sanityops_cli-0.1.11}/scripts/install.ps1 +0 -0
- {sanityops_cli-0.1.9 → sanityops_cli-0.1.11}/scripts/install.sh +0 -0
- {sanityops_cli-0.1.9 → sanityops_cli-0.1.11}/src/sanityops_cli/agents/__init__.py +0 -0
- {sanityops_cli-0.1.9 → sanityops_cli-0.1.11}/src/sanityops_cli/agents/repair_agent/__init__.py +0 -0
- {sanityops_cli-0.1.9 → sanityops_cli-0.1.11}/src/sanityops_cli/agents/repair_agent/agent.py +0 -0
- {sanityops_cli-0.1.9 → sanityops_cli-0.1.11}/src/sanityops_cli/agents/repair_agent/prompts.py +0 -0
- {sanityops_cli-0.1.9 → sanityops_cli-0.1.11}/src/sanityops_cli/agents/repair_agent/tools/__init__.py +0 -0
- {sanityops_cli-0.1.9 → sanityops_cli-0.1.11}/src/sanityops_cli/agents/repair_agent/tools/store_repairs_tool.py +0 -0
- {sanityops_cli-0.1.9 → sanityops_cli-0.1.11}/src/sanityops_cli/agents/scanner_agent/agent.py +0 -0
- {sanityops_cli-0.1.9 → sanityops_cli-0.1.11}/src/sanityops_cli/agents/scanner_agent/hooks/progress_hook.py +0 -0
- {sanityops_cli-0.1.9 → sanityops_cli-0.1.11}/src/sanityops_cli/agents/scanner_agent/tools/listfiles_tool.py +0 -0
- {sanityops_cli-0.1.9 → sanityops_cli-0.1.11}/src/sanityops_cli/agents/scanner_agent/tools/storefindings_tool.py +0 -0
- {sanityops_cli-0.1.9 → sanityops_cli-0.1.11}/src/sanityops_cli/api/__init__.py +0 -0
- {sanityops_cli-0.1.9 → sanityops_cli-0.1.11}/src/sanityops_cli/api/client.py +0 -0
- {sanityops_cli-0.1.9 → sanityops_cli-0.1.11}/src/sanityops_cli/code_contract_checker/__init__.py +0 -0
- {sanityops_cli-0.1.9 → sanityops_cli-0.1.11}/src/sanityops_cli/code_contract_checker/checker.py +0 -0
- {sanityops_cli-0.1.9 → sanityops_cli-0.1.11}/src/sanityops_cli/code_contract_checker/markdown_reporter.py +0 -0
- {sanityops_cli-0.1.9 → sanityops_cli-0.1.11}/src/sanityops_cli/code_contract_checker/models.py +0 -0
- {sanityops_cli-0.1.9 → sanityops_cli-0.1.11}/src/sanityops_cli/code_contract_checker/renderer.py +0 -0
- {sanityops_cli-0.1.9 → sanityops_cli-0.1.11}/src/sanityops_cli/code_contract_checker/rules/__init__.py +0 -0
- {sanityops_cli-0.1.9 → sanityops_cli-0.1.11}/src/sanityops_cli/code_contract_checker/rules/qc0_baseline.py +0 -0
- {sanityops_cli-0.1.9 → sanityops_cli-0.1.11}/src/sanityops_cli/code_contract_checker/rules/qc1_syntax.py +0 -0
- {sanityops_cli-0.1.9 → sanityops_cli-0.1.11}/src/sanityops_cli/code_contract_checker/rules/qc2_resource.py +0 -0
- {sanityops_cli-0.1.9 → sanityops_cli-0.1.11}/src/sanityops_cli/code_contract_checker/rules/qc3_pattern.py +0 -0
- {sanityops_cli-0.1.9 → sanityops_cli-0.1.11}/src/sanityops_cli/commands/__init__.py +0 -0
- {sanityops_cli-0.1.9 → sanityops_cli-0.1.11}/src/sanityops_cli/commands/config.py +0 -0
- {sanityops_cli-0.1.9 → sanityops_cli-0.1.11}/src/sanityops_cli/commands/init.py +0 -0
- {sanityops_cli-0.1.9 → sanityops_cli-0.1.11}/src/sanityops_cli/constants/__init__.py +0 -0
- {sanityops_cli-0.1.9 → sanityops_cli-0.1.11}/src/sanityops_cli/constants/config_defaults.py +0 -0
- {sanityops_cli-0.1.9 → sanityops_cli-0.1.11}/src/sanityops_cli/constants/exit_codes.py +0 -0
- {sanityops_cli-0.1.9 → sanityops_cli-0.1.11}/src/sanityops_cli/defect_checker/__init__.py +0 -0
- {sanityops_cli-0.1.9 → sanityops_cli-0.1.11}/src/sanityops_cli/defect_checker/llm_config.py +0 -0
- {sanityops_cli-0.1.9 → sanityops_cli-0.1.11}/src/sanityops_cli/exceptions/__init__.py +0 -0
- {sanityops_cli-0.1.9 → sanityops_cli-0.1.11}/src/sanityops_cli/exceptions/api_exceptions.py +0 -0
- {sanityops_cli-0.1.9 → sanityops_cli-0.1.11}/src/sanityops_cli/exceptions/base_exceptions.py +0 -0
- {sanityops_cli-0.1.9 → sanityops_cli-0.1.11}/src/sanityops_cli/logging/__init__.py +0 -0
- {sanityops_cli-0.1.9 → sanityops_cli-0.1.11}/src/sanityops_cli/logging/logger.py +0 -0
- {sanityops_cli-0.1.9 → sanityops_cli-0.1.11}/src/sanityops_cli/main.py +0 -0
- {sanityops_cli-0.1.9 → sanityops_cli-0.1.11}/src/sanityops_cli/progress/__init__.py +0 -0
- {sanityops_cli-0.1.9 → sanityops_cli-0.1.11}/src/sanityops_cli/progress/tracker.py +0 -0
- {sanityops_cli-0.1.9 → sanityops_cli-0.1.11}/src/sanityops_cli/renderers/__init__.py +0 -0
- {sanityops_cli-0.1.9 → sanityops_cli-0.1.11}/src/sanityops_cli/renderers/command_renderer/inspect_command_renderer.py +0 -0
- {sanityops_cli-0.1.9 → sanityops_cli-0.1.11}/src/sanityops_cli/templates/__init__.py +0 -0
- {sanityops_cli-0.1.9 → sanityops_cli-0.1.11}/src/sanityops_cli/templates/inspect_config.yaml +0 -0
- {sanityops_cli-0.1.9 → sanityops_cli-0.1.11}/src/sanityops_cli/utils/__init__.py +0 -0
- {sanityops_cli-0.1.9 → sanityops_cli-0.1.11}/src/sanityops_cli/utils/artifact_packer.py +0 -0
- {sanityops_cli-0.1.9 → sanityops_cli-0.1.11}/src/sanityops_cli/utils/config_loader.py +0 -0
- {sanityops_cli-0.1.9 → sanityops_cli-0.1.11}/src/sanityops_cli/utils/config_resolver.py +0 -0
- {sanityops_cli-0.1.9 → sanityops_cli-0.1.11}/src/sanityops_cli/utils/validators.py +0 -0
- {sanityops_cli-0.1.9 → sanityops_cli-0.1.11}/tests/__init__.py +0 -0
- {sanityops_cli-0.1.9 → sanityops_cli-0.1.11}/tests/commands/__init__.py +0 -0
- {sanityops_cli-0.1.9 → sanityops_cli-0.1.11}/tests/commands/test_config.py +0 -0
- {sanityops_cli-0.1.9 → sanityops_cli-0.1.11}/tests/commands/test_init.py +0 -0
- {sanityops_cli-0.1.9 → sanityops_cli-0.1.11}/tests/unit/__init__.py +0 -0
- {sanityops_cli-0.1.9 → sanityops_cli-0.1.11}/tests/unit/agents/__init__.py +0 -0
- {sanityops_cli-0.1.9 → sanityops_cli-0.1.11}/tests/unit/agents/repair_agent/__init__.py +0 -0
- {sanityops_cli-0.1.9 → sanityops_cli-0.1.11}/tests/unit/agents/repair_agent/test_agent.py +0 -0
- {sanityops_cli-0.1.9 → sanityops_cli-0.1.11}/tests/unit/agents/repair_agent/test_store_repairs_tool.py +0 -0
- {sanityops_cli-0.1.9 → sanityops_cli-0.1.11}/tests/unit/agents/scanner_agent/__init__.py +0 -0
- {sanityops_cli-0.1.9 → sanityops_cli-0.1.11}/tests/unit/agents/scanner_agent/models/__init__.py +0 -0
- {sanityops_cli-0.1.9 → sanityops_cli-0.1.11}/tests/unit/agents/scanner_agent/models/test_finding.py +0 -0
- {sanityops_cli-0.1.9 → sanityops_cli-0.1.11}/tests/unit/agents/scanner_agent/test_agent.py +0 -0
- {sanityops_cli-0.1.9 → sanityops_cli-0.1.11}/tests/unit/agents/scanner_agent/test_deterministic_capture.py +0 -0
- {sanityops_cli-0.1.9 → sanityops_cli-0.1.11}/tests/unit/agents/scanner_agent/test_progress_hook.py +0 -0
- {sanityops_cli-0.1.9 → sanityops_cli-0.1.11}/tests/unit/agents/scanner_agent/test_prompts.py +0 -0
- {sanityops_cli-0.1.9 → sanityops_cli-0.1.11}/tests/unit/api/__init__.py +0 -0
- {sanityops_cli-0.1.9 → sanityops_cli-0.1.11}/tests/unit/api/test_client.py +0 -0
- {sanityops_cli-0.1.9 → sanityops_cli-0.1.11}/tests/unit/code_contract_checker/__init__.py +0 -0
- {sanityops_cli-0.1.9 → sanityops_cli-0.1.11}/tests/unit/code_contract_checker/test_checker.py +0 -0
- {sanityops_cli-0.1.9 → sanityops_cli-0.1.11}/tests/unit/code_contract_checker/test_renderer.py +0 -0
- {sanityops_cli-0.1.9 → sanityops_cli-0.1.11}/tests/unit/code_contract_checker/test_rules.py +0 -0
- {sanityops_cli-0.1.9 → sanityops_cli-0.1.11}/tests/unit/commands/test_version.py +0 -0
- {sanityops_cli-0.1.9 → sanityops_cli-0.1.11}/tests/unit/defect_checker/__init__.py +0 -0
- {sanityops_cli-0.1.9 → sanityops_cli-0.1.11}/tests/unit/defect_checker/test_llm_config.py +0 -0
- {sanityops_cli-0.1.9 → sanityops_cli-0.1.11}/tests/unit/defect_checker/test_renderer.py +0 -0
- {sanityops_cli-0.1.9 → sanityops_cli-0.1.11}/tests/unit/logging/__init__.py +0 -0
- {sanityops_cli-0.1.9 → sanityops_cli-0.1.11}/tests/unit/logging/test_logger.py +0 -0
- {sanityops_cli-0.1.9 → sanityops_cli-0.1.11}/tests/unit/progress/__init__.py +0 -0
- {sanityops_cli-0.1.9 → sanityops_cli-0.1.11}/tests/unit/progress/test_tracker.py +0 -0
- {sanityops_cli-0.1.9 → sanityops_cli-0.1.11}/tests/unit/utils/test_artifact_packer.py +0 -0
- {sanityops_cli-0.1.9 → sanityops_cli-0.1.11}/tests/unit/utils/test_config_loader.py +0 -0
- {sanityops_cli-0.1.9 → sanityops_cli-0.1.11}/tests/utils/test_config_resolver.py +0 -0
|
@@ -15,6 +15,8 @@ and this project adheres to [Semantic Versioning](https://semver.org/spec/v2.0.0
|
|
|
15
15
|
|
|
16
16
|
### Changed
|
|
17
17
|
|
|
18
|
+
- **Breaking**: `inspect` no longer accepts `--check-level`; the defect check
|
|
19
|
+
always runs at the deep L3 level
|
|
18
20
|
- **Breaking**: tool schema uploads now emit the provider-neutral flat format
|
|
19
21
|
`{name, description, parameters}` in both upload paths (push and inspect).
|
|
20
22
|
The OpenAI `{type, function}` wrapper is stripped during packing; the
|
|
@@ -33,13 +35,13 @@ and this project adheres to [Semantic Versioning](https://semver.org/spec/v2.0.0
|
|
|
33
35
|
|
|
34
36
|
- `inspect repair` subcommand to generate repaired artifacts from inspection reports
|
|
35
37
|
- Cross-artifact result rendering with aggregate CROSS score in markdown reports
|
|
36
|
-
- Getting Started and Advanced Usage help panels migrated from
|
|
38
|
+
- Getting Started and Advanced Usage help panels migrated from sanityops-cli
|
|
37
39
|
|
|
38
40
|
## [0.0.7] - 2026-09-10
|
|
39
41
|
|
|
40
42
|
### Added
|
|
41
43
|
|
|
42
|
-
- Init command alignment with
|
|
44
|
+
- Init command alignment with sanityops-cli: placeholder UUID, project.name, model block
|
|
43
45
|
- Nested `.gitignore` in `.sanityops` directory to prevent accidental secret commits
|
|
44
46
|
|
|
45
47
|
### Changed
|
|
@@ -1,6 +1,6 @@
|
|
|
1
1
|
Metadata-Version: 2.5
|
|
2
2
|
Name: sanityops-cli
|
|
3
|
-
Version: 0.1.
|
|
3
|
+
Version: 0.1.11
|
|
4
4
|
Summary: CLI tool for static defect inspection of AI logical artifacts
|
|
5
5
|
Project-URL: Homepage, https://sanityops.org
|
|
6
6
|
Project-URL: Documentation, https://sanityops.org
|
|
@@ -46,7 +46,7 @@ A command-line tool for static defect inspection of AI logical artifacts (System
|
|
|
46
46
|
|
|
47
47
|
## Features
|
|
48
48
|
|
|
49
|
-
- **
|
|
49
|
+
- **Deep inspection** — Runs a comprehensive L3 defect check on every artifact by default
|
|
50
50
|
- **Multiple artifact types** — Inspect System Prompts, Skills, and Tool Schemas
|
|
51
51
|
- **CI/CD friendly** — Non-interactive runs, configuration via environment variables, dated markdown reports for pipeline artifacts
|
|
52
52
|
- **Configurable rules** — Customize inspection behavior via YAML configuration
|
|
@@ -140,15 +140,9 @@ skills:
|
|
|
140
140
|
### 3. Run Inspection
|
|
141
141
|
|
|
142
142
|
```bash
|
|
143
|
-
# Standard inspection (
|
|
143
|
+
# Standard inspection (deep L3 defect check)
|
|
144
144
|
sanityops-cli inspect
|
|
145
145
|
|
|
146
|
-
# Fast inspection (L1 depth)
|
|
147
|
-
sanityops-cli inspect --check-level L1
|
|
148
|
-
|
|
149
|
-
# Deep inspection (L3 depth)
|
|
150
|
-
sanityops-cli inspect --check-level L3
|
|
151
|
-
|
|
152
146
|
# Skip defect check, only analyze artifacts
|
|
153
147
|
sanityops-cli inspect --skip-defect-check
|
|
154
148
|
|
|
@@ -160,23 +154,6 @@ sanityops-cli inspect --config path/to/config.yaml
|
|
|
160
154
|
|
|
161
155
|
`inspect` exits `0` when the run completes — including when defects are found — and non-zero on failure. CI pipelines should therefore gate on the generated report (`.sanityops/results/inspect-*.md`), not on the exit code.
|
|
162
156
|
|
|
163
|
-
### 4. Generate Repairs (Optional)
|
|
164
|
-
|
|
165
|
-
After inspection, generate repaired artifacts from the report:
|
|
166
|
-
|
|
167
|
-
```bash
|
|
168
|
-
# Use the latest inspection report
|
|
169
|
-
sanityops-cli inspect repair
|
|
170
|
-
|
|
171
|
-
# Use a specific report
|
|
172
|
-
sanityops-cli inspect repair --report .sanityops/results/inspect-20250115-120000.md
|
|
173
|
-
|
|
174
|
-
# Specify timeout and token budget for large projects
|
|
175
|
-
sanityops-cli inspect repair --timeout 3600 --token-budget 500000
|
|
176
|
-
```
|
|
177
|
-
|
|
178
|
-
Repairs are written to `.sanityops/repairs/repair-<timestamp>.md` without modifying source files.
|
|
179
|
-
|
|
180
157
|
## Data Handling
|
|
181
158
|
|
|
182
159
|
What leaves your machine, and when:
|
|
@@ -260,14 +237,6 @@ CLI flags (`--timeout`, `--token-budget`) override these values when explicitly
|
|
|
260
237
|
|
|
261
238
|
All CLI operations are logged to `~/.sanityops/logs/sanityops-cli-<YYYY-MM-DD>.log`. Logs include timestamps, log levels, and redacted API keys for security.
|
|
262
239
|
|
|
263
|
-
### Check Levels
|
|
264
|
-
|
|
265
|
-
| Level | Description | Use Case |
|
|
266
|
-
|-------|-------------|----------|
|
|
267
|
-
| L1 | Fast | Quick validation during development |
|
|
268
|
-
| L2 | Standard | Default, balanced depth for regular use |
|
|
269
|
-
| L3 | Deep | Comprehensive analysis for production releases |
|
|
270
|
-
|
|
271
240
|
## Documentation
|
|
272
241
|
|
|
273
242
|
Full documentation is available at [sanityops.org](https://sanityops.org).
|
|
@@ -6,7 +6,7 @@ A command-line tool for static defect inspection of AI logical artifacts (System
|
|
|
6
6
|
|
|
7
7
|
## Features
|
|
8
8
|
|
|
9
|
-
- **
|
|
9
|
+
- **Deep inspection** — Runs a comprehensive L3 defect check on every artifact by default
|
|
10
10
|
- **Multiple artifact types** — Inspect System Prompts, Skills, and Tool Schemas
|
|
11
11
|
- **CI/CD friendly** — Non-interactive runs, configuration via environment variables, dated markdown reports for pipeline artifacts
|
|
12
12
|
- **Configurable rules** — Customize inspection behavior via YAML configuration
|
|
@@ -100,15 +100,9 @@ skills:
|
|
|
100
100
|
### 3. Run Inspection
|
|
101
101
|
|
|
102
102
|
```bash
|
|
103
|
-
# Standard inspection (
|
|
103
|
+
# Standard inspection (deep L3 defect check)
|
|
104
104
|
sanityops-cli inspect
|
|
105
105
|
|
|
106
|
-
# Fast inspection (L1 depth)
|
|
107
|
-
sanityops-cli inspect --check-level L1
|
|
108
|
-
|
|
109
|
-
# Deep inspection (L3 depth)
|
|
110
|
-
sanityops-cli inspect --check-level L3
|
|
111
|
-
|
|
112
106
|
# Skip defect check, only analyze artifacts
|
|
113
107
|
sanityops-cli inspect --skip-defect-check
|
|
114
108
|
|
|
@@ -120,23 +114,6 @@ sanityops-cli inspect --config path/to/config.yaml
|
|
|
120
114
|
|
|
121
115
|
`inspect` exits `0` when the run completes — including when defects are found — and non-zero on failure. CI pipelines should therefore gate on the generated report (`.sanityops/results/inspect-*.md`), not on the exit code.
|
|
122
116
|
|
|
123
|
-
### 4. Generate Repairs (Optional)
|
|
124
|
-
|
|
125
|
-
After inspection, generate repaired artifacts from the report:
|
|
126
|
-
|
|
127
|
-
```bash
|
|
128
|
-
# Use the latest inspection report
|
|
129
|
-
sanityops-cli inspect repair
|
|
130
|
-
|
|
131
|
-
# Use a specific report
|
|
132
|
-
sanityops-cli inspect repair --report .sanityops/results/inspect-20250115-120000.md
|
|
133
|
-
|
|
134
|
-
# Specify timeout and token budget for large projects
|
|
135
|
-
sanityops-cli inspect repair --timeout 3600 --token-budget 500000
|
|
136
|
-
```
|
|
137
|
-
|
|
138
|
-
Repairs are written to `.sanityops/repairs/repair-<timestamp>.md` without modifying source files.
|
|
139
|
-
|
|
140
117
|
## Data Handling
|
|
141
118
|
|
|
142
119
|
What leaves your machine, and when:
|
|
@@ -220,14 +197,6 @@ CLI flags (`--timeout`, `--token-budget`) override these values when explicitly
|
|
|
220
197
|
|
|
221
198
|
All CLI operations are logged to `~/.sanityops/logs/sanityops-cli-<YYYY-MM-DD>.log`. Logs include timestamps, log levels, and redacted API keys for security.
|
|
222
199
|
|
|
223
|
-
### Check Levels
|
|
224
|
-
|
|
225
|
-
| Level | Description | Use Case |
|
|
226
|
-
|-------|-------------|----------|
|
|
227
|
-
| L1 | Fast | Quick validation during development |
|
|
228
|
-
| L2 | Standard | Default, balanced depth for regular use |
|
|
229
|
-
| L3 | Deep | Comprehensive analysis for production releases |
|
|
230
|
-
|
|
231
200
|
## Documentation
|
|
232
201
|
|
|
233
202
|
Full documentation is available at [sanityops.org](https://sanityops.org).
|
{sanityops_cli-0.1.9 → sanityops_cli-0.1.11}/docs/superpowers/plans/2026-09-08-config-command.md
RENAMED
|
@@ -2,7 +2,7 @@
|
|
|
2
2
|
|
|
3
3
|
> **For agentic workers:** REQUIRED SUB-SKILL: Use superpowers:subagent-driven-development (recommended) or superpowers:executing-plans to implement this plan task-by-task. Steps use checkbox (`- [ ]`) syntax for tracking.
|
|
4
4
|
|
|
5
|
-
**Goal:** Migrate the `config` subcommand from
|
|
5
|
+
**Goal:** Migrate the `config` subcommand from sanityops-cli to sanityops-cli, providing CLI-based configuration management for server URL and API key.
|
|
6
6
|
|
|
7
7
|
**Architecture:** Create three new files (`constants/config_defaults.py`, `utils/config_resolver.py`, `commands/config.py`) and modify `main.py` to register the config subcommand. ConfigResolver handles the precedence chain (project > global > env > default) with YAML read/write. The config command provides get/set/list/unset operations via Typer CLI.
|
|
8
8
|
|
|
@@ -2,7 +2,7 @@
|
|
|
2
2
|
|
|
3
3
|
> **For agentic workers:** REQUIRED SUB-SKILL: Use superpowers:subagent-driven-development (recommended) or superpowers:executing-plans to implement this plan task-by-task. Steps use checkbox (`- [ ]`) syntax for tracking.
|
|
4
4
|
|
|
5
|
-
**Goal:** Migrate cross-artifact result rendering from
|
|
5
|
+
**Goal:** Migrate cross-artifact result rendering from sanityops-cli to sanityops-cli, enabling terminal and markdown display of CROSS module defects.
|
|
6
6
|
|
|
7
7
|
**Architecture:** Add helper functions to resolve artifact names from defect references and aggregate multiple CROSS sub-results into a unified section. The terminal renderer uses Rich panels with artifact names in titles; the markdown reporter merges PS/PT/ST sub-results and calculates a unified score via SDK.
|
|
8
8
|
|
|
@@ -2,7 +2,7 @@
|
|
|
2
2
|
|
|
3
3
|
> **For agentic workers:** REQUIRED SUB-SKILL: Use superpowers:subagent-driven-development (recommended) or superpowers:executing-plans to implement this plan task-by-task. Steps use checkbox (`- [ ]`) syntax for tracking.
|
|
4
4
|
|
|
5
|
-
**Goal:** Migrate Getting Started and Advanced Usage help panels from
|
|
5
|
+
**Goal:** Migrate Getting Started and Advanced Usage help panels from sanityops-cli to sanityops-cli.
|
|
6
6
|
|
|
7
7
|
**Architecture:** Copy `help_panel.py` verbatim, add `--help` interception logic in `main.py`, update entry points (`entry.py`, `pyproject.toml`) to call `main()` instead of `app()`, and add tests.
|
|
8
8
|
|
|
@@ -82,7 +82,7 @@ def get_advanced_usage_panel() -> Panel:
|
|
|
82
82
|
)
|
|
83
83
|
```
|
|
84
84
|
|
|
85
|
-
**Note:** Step 5 (`inspect cover`) from
|
|
85
|
+
**Note:** Step 5 (`inspect cover`) from sanityops-cli was removed because sanityops-cli has no `cover` subcommand.
|
|
86
86
|
|
|
87
87
|
- [ ] **Step 2: Verify file is importable**
|
|
88
88
|
|
{sanityops_cli-0.1.9 → sanityops_cli-0.1.11}/docs/superpowers/plans/2026-09-20-repair-feature.md
RENAMED
|
@@ -2,7 +2,7 @@
|
|
|
2
2
|
|
|
3
3
|
> **For agentic workers:** REQUIRED SUB-SKILL: Use superpowers:subagent-driven-development (recommended) or superpowers:executing-plans to implement this plan task-by-task. Steps use checkbox (`- [ ]`) syntax for tracking.
|
|
4
4
|
|
|
5
|
-
**Goal:** Migrate local repair functionality from
|
|
5
|
+
**Goal:** Migrate local repair functionality from sanityops-cli to sanityops-cli, enabling users to generate repaired artifact content from inspection reports.
|
|
6
6
|
|
|
7
7
|
**Architecture:** Create a RepairAgent that reads inspection reports and uses an LLM to rewrite defective artifacts. The agent uses StoreRepairsTool to collect repairs, which are then written to a markdown report file.
|
|
8
8
|
|
|
@@ -1438,5 +1438,5 @@ Create a test scenario:
|
|
|
1438
1438
|
|
|
1439
1439
|
```bash
|
|
1440
1440
|
git add -A
|
|
1441
|
-
git commit -m "feat(repair): complete repair feature migration from
|
|
1441
|
+
git commit -m "feat(repair): complete repair feature migration from sanityops-cli"
|
|
1442
1442
|
```
|
|
@@ -2,11 +2,11 @@
|
|
|
2
2
|
|
|
3
3
|
**Date:** 2026-09-08
|
|
4
4
|
**Status:** Approved
|
|
5
|
-
**Source:**
|
|
5
|
+
**Source:** sanityops-cli → sanityops-cli
|
|
6
6
|
|
|
7
7
|
## Overview
|
|
8
8
|
|
|
9
|
-
Migrate the `config` subcommand from
|
|
9
|
+
Migrate the `config` subcommand from sanityops-cli to sanityops-cli. This provides CLI-based configuration management for the sanityops server backend URL and API key.
|
|
10
10
|
|
|
11
11
|
## Architecture
|
|
12
12
|
|
|
@@ -8,7 +8,7 @@
|
|
|
8
8
|
|
|
9
9
|
sanityops-cli currently skips rendering of cross-artifact defects (module type "CROSS") in both terminal and markdown outputs. The defect-check SDK returns cross-artifact analysis results, but the CLI explicitly skips them.
|
|
10
10
|
|
|
11
|
-
This design migrates the cross-artifact rendering functionality from
|
|
11
|
+
This design migrates the cross-artifact rendering functionality from sanityops-cli to sanityops-cli.
|
|
12
12
|
|
|
13
13
|
## Migration Scope
|
|
14
14
|
|
|
@@ -1,12 +1,12 @@
|
|
|
1
1
|
# Help Panel Migration — Design Spec
|
|
2
2
|
|
|
3
3
|
**Date:** 2026-09-20
|
|
4
|
-
**Source:** `/Users/a1234/Documents/project/gitlab/
|
|
4
|
+
**Source:** `/Users/a1234/Documents/project/gitlab/sanityops-cli`
|
|
5
5
|
**Target:** `/Users/a1234/Documents/project/sanityops-cli`
|
|
6
6
|
|
|
7
7
|
## Summary
|
|
8
8
|
|
|
9
|
-
Migrate the Getting Started and Advanced Usage help panels from
|
|
9
|
+
Migrate the Getting Started and Advanced Usage help panels from sanityops-cli to sanityops-cli. The panels appear when users run `sanityops-cli --help` or `sanityops-cli` with no arguments, providing a 4-step quick start workflow and CI/CD integration guidance.
|
|
10
10
|
|
|
11
11
|
**Note:** The original 5-step workflow was reduced to 4 steps because sanityops-cli has no `inspect cover` subcommand.
|
|
12
12
|
|
|
@@ -14,7 +14,7 @@ Migrate the Getting Started and Advanced Usage help panels from deeplogic-cli to
|
|
|
14
14
|
|
|
15
15
|
| File | Action |
|
|
16
16
|
|------|--------|
|
|
17
|
-
| `src/sanityops_cli/help_panel.py` | Create (localized from
|
|
17
|
+
| `src/sanityops_cli/help_panel.py` | Create (localized from sanityops-cli) |
|
|
18
18
|
| `src/sanityops_cli/main.py` | Modify (add help interception logic) |
|
|
19
19
|
| `entry.py` | Modify (call `main()` instead of `app()`) |
|
|
20
20
|
| `pyproject.toml` | Modify (entry point `:app` → `:main`) |
|
|
@@ -130,8 +130,8 @@ sanityops-cli = "sanityops_cli.main:main"
|
|
|
130
130
|
|
|
131
131
|
### 5. `tests/test_help_panel.py` (new)
|
|
132
132
|
|
|
133
|
-
Copy from
|
|
134
|
-
- Import path `
|
|
133
|
+
Copy from sanityops-cli with these changes:
|
|
134
|
+
- Import path `sanityops_cli` → `sanityops_cli`
|
|
135
135
|
- **Remove** `test_getting_started_text_is_english()` and `test_advanced_usage_text_is_english()` (CJK assertion tests — will be added back when text is localized)
|
|
136
136
|
|
|
137
137
|
Tests included:
|
|
@@ -169,7 +169,7 @@ sanityops-cli inspect --help
|
|
|
169
169
|
## Out of Scope
|
|
170
170
|
|
|
171
171
|
- Adding `project` command (does not exist in sanityops-cli)
|
|
172
|
-
- Migrating other
|
|
172
|
+
- Migrating other sanityops-cli features
|
|
173
173
|
|
|
174
174
|
## Acceptance Criteria
|
|
175
175
|
|
|
@@ -2,11 +2,11 @@
|
|
|
2
2
|
|
|
3
3
|
**Date:** 2026-09-20
|
|
4
4
|
**Status:** Approved
|
|
5
|
-
**Source:** Migration from
|
|
5
|
+
**Source:** Migration from sanityops-cli
|
|
6
6
|
|
|
7
7
|
## Overview
|
|
8
8
|
|
|
9
|
-
Migrate the local `repair` feature from
|
|
9
|
+
Migrate the local `repair` feature from sanityops-cli to sanityops-cli. The repair feature reads an inspection report and uses an LLM agent to generate fixed artifact content.
|
|
10
10
|
|
|
11
11
|
## Scope
|
|
12
12
|
|
|
@@ -241,8 +241,8 @@ Use the store_repairs tool with operation "add" for each repaired artifact:
|
|
|
241
241
|
|
|
242
242
|
**Method:** Direct migration with import path adjustment
|
|
243
243
|
|
|
244
|
-
1. Copy `RepairAgent` from
|
|
245
|
-
2. Copy `StoreRepairsTool` from
|
|
244
|
+
1. Copy `RepairAgent` from sanityops-cli
|
|
245
|
+
2. Copy `StoreRepairsTool` from sanityops-cli
|
|
246
246
|
3. Change imports: `aidynamic_agent` → `sanityops_agent`
|
|
247
247
|
4. Add `repair` subcommand to `inspect.py`
|
|
248
248
|
5. Reuse existing utilities:
|
|
@@ -30,6 +30,7 @@ class FindingType(StrEnum):
|
|
|
30
30
|
|
|
31
31
|
class Section(BaseModel):
|
|
32
32
|
"""A markdown section within a skill file."""
|
|
33
|
+
|
|
33
34
|
title: str = Field(description="Section heading text")
|
|
34
35
|
content: str = Field(description="Section body content")
|
|
35
36
|
|
|
@@ -37,7 +38,9 @@ class Section(BaseModel):
|
|
|
37
38
|
class ToolSchema(BaseModel):
|
|
38
39
|
name: str
|
|
39
40
|
description: str = ""
|
|
40
|
-
parameters: dict = Field(
|
|
41
|
+
parameters: dict = Field(
|
|
42
|
+
default_factory=dict, description="Tool parameters, JSON Schema (Draft-07) format"
|
|
43
|
+
)
|
|
41
44
|
|
|
42
45
|
|
|
43
46
|
class SkillContent(BaseModel):
|
|
@@ -54,7 +57,11 @@ class SkillContent(BaseModel):
|
|
|
54
57
|
#: Frontmatter fields that must be positive integers (QDS-0.4). LLM-based
|
|
55
58
|
#: extraction can stringify numeric values, so coerce them back to int.
|
|
56
59
|
_POSITIVE_INT_FIELDS: tuple[str, ...] = (
|
|
57
|
-
"max_items",
|
|
60
|
+
"max_items",
|
|
61
|
+
"max_chars",
|
|
62
|
+
"timeout_seconds",
|
|
63
|
+
"max_tool_calls",
|
|
64
|
+
"max_retries",
|
|
58
65
|
)
|
|
59
66
|
|
|
60
67
|
@model_validator(mode="after")
|
|
@@ -100,23 +107,45 @@ class SkillContent(BaseModel):
|
|
|
100
107
|
if not parts:
|
|
101
108
|
return ""
|
|
102
109
|
parts.append(
|
|
103
|
-
"\n\n".join(
|
|
104
|
-
f"## {section.title}\n\n{section.content}"
|
|
105
|
-
for section in self.sections
|
|
106
|
-
)
|
|
110
|
+
"\n\n".join(f"## {section.title}\n\n{section.content}" for section in self.sections)
|
|
107
111
|
)
|
|
108
112
|
return "\n".join(parts)
|
|
109
113
|
|
|
110
114
|
|
|
111
115
|
class ToolContent(BaseModel):
|
|
112
116
|
"""Extracted content from a tool file."""
|
|
117
|
+
|
|
113
118
|
name: str = Field(description="Tool name from definition")
|
|
114
119
|
description: str = Field(description="Tool description")
|
|
115
|
-
parameters: dict[str, Any] = Field(
|
|
120
|
+
parameters: dict[str, Any] = Field(
|
|
121
|
+
default_factory=dict, description="JSON Schema of parameters"
|
|
122
|
+
)
|
|
123
|
+
#: pre-inspect-extract alignment: extraction fidelity labels. Default empty
|
|
124
|
+
#: when the analyzer does not provide them (backward compatible).
|
|
125
|
+
completeness: str = Field(
|
|
126
|
+
default="",
|
|
127
|
+
description=(
|
|
128
|
+
"Completeness level per pre-inspect-extract: full original / "
|
|
129
|
+
"assembled / incomplete / summary / not inspectable"
|
|
130
|
+
),
|
|
131
|
+
)
|
|
132
|
+
evidence: str = Field(
|
|
133
|
+
default="", description="Short verbatim excerpt from the source proving the extraction"
|
|
134
|
+
)
|
|
116
135
|
|
|
117
136
|
|
|
118
137
|
class PromptContent(BaseModel):
|
|
119
138
|
content: str
|
|
139
|
+
#: pre-inspect-extract alignment: extraction fidelity labels. Default empty
|
|
140
|
+
#: when the analyzer does not provide them (backward compatible).
|
|
141
|
+
completeness: str = Field(
|
|
142
|
+
default="",
|
|
143
|
+
description=(
|
|
144
|
+
"Completeness level per pre-inspect-extract: full original / "
|
|
145
|
+
"original · variable unexpanded / assembled / incomplete / summary / not inspectable"
|
|
146
|
+
),
|
|
147
|
+
)
|
|
148
|
+
evidence: str = Field(default="", description="Short verbatim excerpt from the source")
|
|
120
149
|
|
|
121
150
|
|
|
122
151
|
class Finding(BaseModel):
|