busya/ss-tools
1
0
Fork 0
Code Issues Pull Requests 1 Actions Packages Projects Releases Wiki Activity

semantics

Browse Source
This commit is contained in:
busya
2026-03-27 21:27:31 +03:00
parent 7c85552132
commit 2ed66bfebc
182 changed files with 21186 additions and 10254 deletions
Download Patch File Download Diff File Expand all files Collapse all files

20
specs/017-llm-analysis-plugin/contracts/modules.md
View File

@@ -21,15 +21,15 @@
# @PURPOSE: Analyze dashboard health using screenshot and logs.
# @PRE: Dashboard ID exists and provider is configured.
# @POST: ValidationResult is persisted and notification sent if failed.
# [/DEF:validate_dashboard]
# [/DEF:validate_dashboard:Function]
# [DEF:generate_documentation:Function]
# @PURPOSE: Generate and apply metadata descriptions for datasets.
# @PRE: Dataset is accessible and schema is valid.
# @POST: Dataset metadata is updated in the database.
# [/DEF:generate_documentation]
# [/DEF:generate_documentation:Function]
# [/DEF:backend/src/plugins/llm_analysis/plugin.py]
# [/DEF:backend/src/plugins/llm_analysis/plugin.py:Module]
```
### LLM Service
@@ -49,9 +49,9 @@
# @PRE: Provider is active and quota is available.
# @POST: Returns structured analysis or raises RetryError.
# @SIDE_EFFECT: Makes external HTTP request.
# [/DEF:analyze_multimodal]
# [/DEF:analyze_multimodal:Function]
# [/DEF:backend/src/plugins/llm_analysis/service.py]
# [/DEF:backend/src/plugins/llm_analysis/service.py:Module]
```
### Provider Management Service
@@ -69,9 +69,9 @@
# @PURPOSE: Instantiate an authenticated LLM client for a specific provider.
# @PRE: Provider ID exists and is active.
# @POST: Returns configured client instance with decrypted key.
# [/DEF:get_provider_client]
# [/DEF:get_provider_client:Function]
# [/DEF:backend/src/services/llm_provider.py]
# [/DEF:backend/src/services/llm_provider.py:Module]
```
### Data Models
@@ -82,7 +82,7 @@
# @SEMANTICS: dto, pydantic, schema
# @PURPOSE: Define Pydantic models for configuration, requests, and results.
# @LAYER: Domain/Data
# [/DEF:backend/src/plugins/llm_analysis/models.py]
# [/DEF:backend/src/plugins/llm_analysis/models.py:Module]
```
## Frontend Components
@@ -94,7 +94,7 @@
<!-- @TIER: STANDARD -->
<!-- @PURPOSE: Form for adding/editing LLM providers with connection testing. -->
<!-- @RELATION: CALLS -> /api/settings/llm/providers -->
<!-- [/DEF:frontend/src/components/llm/ProviderConfig.svelte] -->
<!-- [/DEF:frontend/src/components/llm/ProviderConfig.svelte:Component] -->
```
### Validation Report
@@ -104,4 +104,4 @@
<!-- @TIER: STANDARD -->
<!-- @PURPOSE: Display formatted analysis results including screenshot and issues list. -->
<!-- @INVARIANT: Must handle missing screenshots gracefully. -->
<!-- [/DEF:frontend/src/components/llm/ValidationReport.svelte] -->
<!-- [/DEF:frontend/src/components/llm/ValidationReport.svelte:Component] -->