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

semantic update

Browse Source
This commit is contained in:
busya
2026-02-24 21:08:12 +03:00
parent 7a12ed0931
commit 95ae9c6af1
32 changed files with 60376 additions and 59911 deletions
Download Patch File Download Diff File Expand all files Collapse all files

200
.ai/PROJECT_MAP.md
View File

@@ -2,7 +2,46 @@
> Compressed view for AI Context. Generated automatically.
- 📦 **generate_semantic_map** (`Module`) `[CRITICAL]`
- 📦 **backend.src.services.reports.report_service** (`Module`) `[CRITICAL]`
- 📝 Aggregate, normalize, filter, and paginate task reports for unified list/detail API use cases.
- 🏗️ Layer: Domain
- 🔒 Invariant: List responses are deterministic and include applied filter echo metadata.
- 🔗 DEPENDS_ON -> `backend.src.core.task_manager.manager.TaskManager`
- 🔗 DEPENDS_ON -> `backend.src.models.report`
- 🔗 DEPENDS_ON -> `backend.src.services.reports.normalizer`
- ℂ **ReportsService** (`Class`) `[CRITICAL]`
- 📝 Service layer for list/detail report retrieval and normalization.
- 🔒 Invariant: Service methods are read-only over task history source.
- ƒ **__init__** (`Function`) `[CRITICAL]`
- 📝 Initialize service with TaskManager dependency.
- 🔒 Invariant: Constructor performs no task mutations.
- ƒ **_load_normalized_reports** (`Function`)
- 📝 Build normalized reports from all available tasks.
- 🔒 Invariant: Every returned item is a TaskReport.
- ƒ **_to_utc_datetime** (`Function`)
- 📝 Normalize naive/aware datetime values to UTC-aware datetime for safe comparisons.
- 🔒 Invariant: Naive datetimes are interpreted as UTC to preserve deterministic ordering/filtering.
- ƒ **_datetime_sort_key** (`Function`)
- 📝 Produce stable numeric sort key for report timestamps.
- 🔒 Invariant: Mixed naive/aware datetimes never raise TypeError.
- ƒ **_matches_query** (`Function`)
- 📝 Apply query filtering to a report.
- 🔒 Invariant: Filter evaluation is side-effect free.
- ƒ **_sort_reports** (`Function`)
- 📝 Sort reports deterministically according to query settings.
- 🔒 Invariant: Sorting criteria are deterministic for equal input.
- ƒ **list_reports** (`Function`)
- 📝 Return filtered, sorted, paginated report collection.
- ƒ **get_report_detail** (`Function`)
- 📝 Return one normalized report with timeline/diagnostics/next actions.
- ƒ **print_entity** (`Function`) `[TRIVIAL]`
- 📝 Auto-detected function (orphan)
- 📦 **test_analyze** (`Module`) `[TRIVIAL]`
- 📝 Auto-generated module for test_analyze.py
- 🏗️ Layer: Unknown
- ƒ **print_issues** (`Function`) `[TRIVIAL]`
- 📝 Auto-detected function (orphan)
- 📦 **generate_semantic_map** (`Module`)
- 📝 Scans the codebase to generate a Semantic Map, Module Map, and Compliance Report based on the System Standard.
- 🏗️ Layer: DevOps/Tooling
- 🔒 Invariant: All DEF anchors must have matching closing anchors; TIER determines validation strictness.
@@ -60,7 +99,7 @@
- ƒ **_process_file_results** (`Function`)
- 📝 Validates entities and calculates file scores with tier awareness.
- ƒ **validate_recursive** (`Function`)
- 📝 Recursively validates a list of entities.
- 📝 Calculate score and determine module's max tier for weighted global score
- ƒ **_generate_artifacts** (`Function`) `[CRITICAL]`
- 📝 Writes output files with tier-based compliance data.
- ƒ **_generate_report** (`Function`) `[CRITICAL]`
@@ -532,6 +571,8 @@
- ⬅️ READS_FROM `lib`
- ⬅️ READS_FROM `taskDrawerStore`
- ➡️ WRITES_TO `taskDrawerStore`
- ƒ **disconnectWebSocket** (`Function`)
- 📝 Disconnects the active WebSocket connection
- ƒ **loadRecentTasks** (`Function`)
- 📝 Load recent tasks for list mode display
- ƒ **selectTask** (`Function`)
@@ -545,12 +586,10 @@
- 📝 Auto-detected function (orphan)
- ƒ **goToReportsPage** (`Function`) `[TRIVIAL]`
- 📝 Auto-detected function (orphan)
- ƒ **handleOverlayClick** (`Function`) `[TRIVIAL]`
- ƒ **handleGlobalKeydown** (`Function`) `[TRIVIAL]`
- 📝 Auto-detected function (orphan)
- ƒ **connectWebSocket** (`Function`) `[TRIVIAL]`
- 📝 Auto-detected function (orphan)
- ƒ **disconnectWebSocket** (`Function`) `[TRIVIAL]`
- 📝 Auto-detected function (orphan)
- 📦 **test_breadcrumbs.svelte** (`Module`) `[TRIVIAL]`
- 📝 Auto-generated module for frontend/src/lib/components/layout/__tests__/test_breadcrumbs.svelte.js
- 🏗️ Layer: Unknown
@@ -671,6 +710,80 @@
- 📝 Fetches the list of available environments.
- ƒ **fetchDashboards** (`Function`)
- 📝 Fetches dashboards for a specific environment.
- 📦 **DashboardHub** (`Page`) `[CRITICAL]`
- 📝 Dashboard Hub - Central hub for managing dashboards with Git status and task actions
- 🏗️ Layer: UI
- 🔒 Invariant: Always shows environment selector and dashboard grid
- 📦 **+page** (`Module`) `[TRIVIAL]`
- 📝 Auto-generated module for frontend/src/routes/dashboards/+page.svelte
- 🏗️ Layer: Unknown
- ƒ **handleDocumentClick** (`Function`) `[TRIVIAL]`
- 📝 Auto-detected function (orphan)
- ƒ **loadEnvironments** (`Function`) `[TRIVIAL]`
- 📝 Auto-detected function (orphan)
- ƒ **loadDashboards** (`Function`) `[TRIVIAL]`
- 📝 Auto-detected function (orphan)
- ƒ **handleEnvChange** (`Function`) `[TRIVIAL]`
- 📝 Auto-detected function (orphan)
- ƒ **handleSearch** (`Function`) `[TRIVIAL]`
- 📝 Auto-detected function (orphan)
- ƒ **handlePageChange** (`Function`) `[TRIVIAL]`
- 📝 Auto-detected function (orphan)
- ƒ **handlePageSizeChange** (`Function`) `[TRIVIAL]`
- 📝 Auto-detected function (orphan)
- ƒ **updateSelectionState** (`Function`) `[TRIVIAL]`
- 📝 Auto-detected function (orphan)
- ƒ **handleCheckboxChange** (`Function`) `[TRIVIAL]`
- 📝 Auto-detected function (orphan)
- ƒ **handleSelectAll** (`Function`) `[TRIVIAL]`
- 📝 Auto-detected function (orphan)
- ƒ **handleSelectVisible** (`Function`) `[TRIVIAL]`
- 📝 Auto-detected function (orphan)
- ƒ **toggleActionDropdown** (`Function`) `[TRIVIAL]`
- 📝 Auto-detected function (orphan)
- ƒ **closeActionDropdown** (`Function`) `[TRIVIAL]`
- 📝 Auto-detected function (orphan)
- ƒ **handleAction** (`Function`) `[TRIVIAL]`
- 📝 Auto-detected function (orphan)
- ƒ **handleValidate** (`Function`) `[TRIVIAL]`
- 📝 Auto-detected function (orphan)
- ƒ **handleTargetEnvChange** (`Function`) `[TRIVIAL]`
- 📝 Auto-detected function (orphan)
- ƒ **loadDatabases** (`Function`) `[TRIVIAL]`
- 📝 Auto-detected function (orphan)
- ƒ **handleMappingUpdate** (`Function`) `[TRIVIAL]`
- 📝 Auto-detected function (orphan)
- ƒ **loadDbMappings** (`Function`) `[TRIVIAL]`
- 📝 Auto-detected function (orphan)
- ƒ **handleBulkMigrate** (`Function`) `[TRIVIAL]`
- 📝 Auto-detected function (orphan)
- ƒ **handleBulkBackup** (`Function`) `[TRIVIAL]`
- 📝 Auto-detected function (orphan)
- ƒ **handleTaskStatusClick** (`Function`) `[TRIVIAL]`
- 📝 Auto-detected function (orphan)
- ƒ **navigateToDashboardDetail** (`Function`) `[TRIVIAL]`
- 📝 Auto-detected function (orphan)
- ƒ **getStatusBadgeClass** (`Function`) `[TRIVIAL]`
- 📝 Auto-detected function (orphan)
- ƒ **getTaskStatusIcon** (`Function`) `[TRIVIAL]`
- 📝 Auto-detected function (orphan)
- ƒ **getPaginationRange** (`Function`) `[TRIVIAL]`
- 📝 Auto-detected function (orphan)
- 📦 **DashboardDetail** (`Page`) `[CRITICAL]`
- 📝 Dashboard Detail View - Overview of charts and datasets linked to a dashboard
- 🏗️ Layer: UI
- 🔒 Invariant: Shows dashboard metadata, charts, and datasets for selected environment
- 📦 **+page** (`Module`) `[TRIVIAL]`
- 📝 Auto-generated module for frontend/src/routes/dashboards/[id]/+page.svelte
- 🏗️ Layer: Unknown
- ƒ **loadDashboardDetail** (`Function`) `[TRIVIAL]`
- 📝 Auto-detected function (orphan)
- ƒ **goBack** (`Function`) `[TRIVIAL]`
- 📝 Auto-detected function (orphan)
- ƒ **openDataset** (`Function`) `[TRIVIAL]`
- 📝 Auto-detected function (orphan)
- ƒ **formatDate** (`Function`) `[TRIVIAL]`
- 📝 Auto-detected function (orphan)
- 🧩 **AdminRolesPage** (`Component`)
- 📝 UI for managing system roles and their permissions.
- 🏗️ Layer: Domain
@@ -985,14 +1098,19 @@
- ➡️ WRITES_TO `props`
- ➡️ WRITES_TO `state`
- 📦 **handleRealTimeLogs** (`Action`)
- 📝 Sync real-time logs to the current log list
- ƒ **fetchLogs** (`Function`)
- 📦 **TaskLogViewer** (`Module`) `[TRIVIAL]`
- 📝 Auto-generated module for frontend/src/components/TaskLogViewer.svelte
- 🏗️ Layer: Unknown
- ƒ **handleFilterChange** (`Function`) `[TRIVIAL]`
- 📝 Auto-detected function (orphan)
- ƒ **handleRefresh** (`Function`) `[TRIVIAL]`
- 📝 Auto-detected function (orphan)
- 📝 Fetches logs for a given task ID
- ƒ **handleFilterChange** (`Function`)
- 📝 Updates filter conditions for the log viewer
- ƒ **handleRefresh** (`Function`)
- 📝 Refreshes the logs by polling the API
- 🧩 **showInline** (`Component`)
- 📝 Shows inline logs -->
- 🏗️ Layer: UI -->
- 🧩 **showModal** (`Component`)
- 📝 Shows modal logs -->
- 🏗️ Layer: UI -->
- 🧩 **Footer** (`Component`) `[TRIVIAL]`
- 📝 Displays the application footer with copyright information.
- 🏗️ Layer: UI
@@ -1380,6 +1498,8 @@
- 📝 Handles application startup tasks, such as starting the scheduler.
- ƒ **shutdown_event** (`Function`)
- 📝 Handles application shutdown tasks, such as stopping the scheduler.
- ƒ **network_error_handler** (`Function`)
- 📝 Global exception handler for NetworkError.
- ƒ **log_requests** (`Function`)
- 📝 Middleware to log incoming HTTP requests and their response status.
- 📦 **api.include_routers** (`Action`)
@@ -1393,8 +1513,6 @@
- 📝 Serves the SPA frontend for any path not matched by API routes.
- ƒ **read_root** (`Function`)
- 📝 A simple root endpoint to confirm that the API is running when frontend is missing.
- ƒ **network_error_handler** (`Function`) `[TRIVIAL]`
- 📝 Auto-detected function (orphan)
- ƒ **matches_filters** (`Function`) `[TRIVIAL]`
- 📝 Auto-detected function (orphan)
- 📦 **Dependencies** (`Module`)
@@ -1706,6 +1824,12 @@
- 📝 A decorator that wraps a function in a belief scope.
- ƒ **decorator** (`Function`)
- 📝 Internal decorator for belief scope.
- ƒ **explore** (`Function`)
- 📝 Logs an EXPLORE message (Van der Waals force) for searching, alternatives, and hypotheses.
- ƒ **reason** (`Function`)
- 📝 Logs a REASON message (Covalent bond) for strict deduction and core logic.
- ƒ **reflect** (`Function`)
- 📝 Logs a REFLECT message (Hydrogen bond) for self-check and structural validation.
- ℂ **PluginLoader** (`Class`)
- 📝 Scans a specified directory for Python modules, dynamically loads them, and registers any classes that are valid implementations of the PluginBase interface.
- 🏗️ Layer: Core
@@ -2008,12 +2132,19 @@
- 📝 Log an ERROR level message.
- ƒ **progress** (`Function`)
- 📝 Log a progress update with percentage.
- 📦 **TaskPersistenceModule** (`Module`)
- 📦 **TaskPersistenceModule** (`Module`) `[CRITICAL]`
- 📝 Handles the persistence of tasks using SQLAlchemy and the tasks.db database.
- 🏗️ Layer: Core
- 🔒 Invariant: Database schema must match the TaskRecord model structure.
- ℂ **TaskPersistenceService** (`Class`)
- ℂ **TaskPersistenceService** (`Class`) `[CRITICAL]`
- 📝 Provides methods to save and load tasks from the tasks.db database using SQLAlchemy.
- 🔒 Invariant: Persistence must handle potentially missing task fields natively.
- ƒ **_json_load_if_needed** (`Function`)
- 📝 Safely load JSON strings from DB if necessary
- ƒ **_parse_datetime** (`Function`)
- 📝 Safely parse a datetime string from the database
- ƒ **_resolve_environment_id** (`Function`)
- 📝 Resolve environment id based on provided value or fallback to default
- ƒ **__init__** (`Function`)
- 📝 Initializes the persistence service.
- ƒ **persist_task** (`Function`)
@@ -2029,7 +2160,7 @@
- 🔒 Invariant: Log entries are batch-inserted for performance.
- 🔗 DEPENDS_ON -> `TaskLogRecord`
- ƒ **__init__** (`Function`)
- 📝 Initialize the log persistence service.
- 📝 Initializes the TaskLogPersistenceService
- ƒ **add_logs** (`Function`)
- 📝 Batch insert log entries for a task.
- ƒ **get_logs** (`Function`)
@@ -2042,15 +2173,9 @@
- 📝 Delete all logs for a specific task.
- ƒ **delete_logs_for_tasks** (`Function`)
- 📝 Delete all logs for multiple tasks.
- ƒ **_json_load_if_needed** (`Function`) `[TRIVIAL]`
- 📝 Auto-detected function (orphan)
- ƒ **_parse_datetime** (`Function`) `[TRIVIAL]`
- 📝 Auto-detected function (orphan)
- ƒ **_resolve_environment_id** (`Function`) `[TRIVIAL]`
- 📝 Auto-detected function (orphan)
- ƒ **json_serializable** (`Function`) `[TRIVIAL]`
- 📝 Auto-detected function (orphan)
- 📦 **TaskManagerModule** (`Module`)
- 📦 **TaskManagerModule** (`Module`) `[CRITICAL]`
- 📝 Manages the lifecycle of tasks, including their creation, execution, and state tracking. It uses a thread pool to run plugins asynchronously.
- 🏗️ Layer: Core
- 🔒 Invariant: Task IDs are unique.
@@ -2474,6 +2599,8 @@
- 📝 Resolve default environment id from settings or first configured environment.
- ƒ **_resolve_dashboard_id_by_ref** (`Function`)
- 📝 Resolve dashboard id by title or slug reference in selected environment.
- ƒ **_resolve_dashboard_id_entity** (`Function`)
- 📝 Resolve dashboard id from intent entities using numeric id or dashboard_ref fallback.
- ƒ **_parse_command** (`Function`)
- 📝 Deterministically parse RU/EN command text into intent payload.
- ƒ **_check_any_permission** (`Function`)
@@ -2891,20 +3018,27 @@
- 🏗️ Layer: Domain
- 🔒 Invariant: Canonical report fields are always present for every report item.
- 🔗 DEPENDS_ON -> `backend.src.core.task_manager.models`
- ℂ **TaskType** (`Class`)
- ℂ **TaskType** (`Class`) `[CRITICAL]`
- 📝 Supported normalized task report types.
- ℂ **ReportStatus** (`Class`)
- 🔒 Invariant: Must contain valid generic task type mappings.
- ℂ **ReportStatus** (`Class`) `[CRITICAL]`
- 📝 Supported normalized report status values.
- ℂ **ErrorContext** (`Class`)
- 🔒 Invariant: TaskStatus enum mapping logic holds.
- ℂ **ErrorContext** (`Class`) `[CRITICAL]`
- 📝 Error and recovery context for failed/partial reports.
- ℂ **TaskReport** (`Class`)
- 🔒 Invariant: The properties accurately describe error state.
- ℂ **TaskReport** (`Class`) `[CRITICAL]`
- 📝 Canonical normalized report envelope for one task execution.
- ℂ **ReportQuery** (`Class`)
- 🔒 Invariant: Must represent canonical task record attributes.
- ℂ **ReportQuery** (`Class`) `[CRITICAL]`
- 📝 Query object for server-side report filtering, sorting, and pagination.
- ℂ **ReportCollection** (`Class`)
- 🔒 Invariant: Time and pagination queries are mutually consistent.
- ℂ **ReportCollection** (`Class`) `[CRITICAL]`
- 📝 Paginated collection of normalized task reports.
- ℂ **ReportDetailView** (`Class`)
- 🔒 Invariant: Represents paginated data correctly.
- ℂ **ReportDetailView** (`Class`) `[CRITICAL]`
- 📝 Detailed report representation including diagnostics and recovery actions.
- 🔒 Invariant: Incorporates a report and logs correctly.
- ƒ **_non_empty_str** (`Function`) `[TRIVIAL]`
- 📝 Auto-detected function (orphan)
- ƒ **_validate_sort_by** (`Function`) `[TRIVIAL]`
@@ -3425,6 +3559,8 @@
- 📝 Wrapper for LLM provider APIs.
- ƒ **LLMClient.__init__** (`Function`)
- 📝 Initializes the LLMClient with provider settings.
- ƒ **LLMClient._supports_json_response_format** (`Function`)
- 📝 Detect whether provider/model is likely compatible with response_format=json_object.
- ƒ **LLMClient.get_json_completion** (`Function`)
- 📝 Helper to handle LLM calls with JSON mode and fallback parsing.
- ƒ **LLMClient.analyze_dashboard** (`Function`)
@@ -3440,6 +3576,8 @@
- 📝 Auto-detected function (orphan)
- ƒ **__init__** (`Function`) `[TRIVIAL]`
- 📝 Auto-detected function (orphan)
- ƒ **_supports_json_response_format** (`Function`) `[TRIVIAL]`
- 📝 Auto-detected function (orphan)
- ƒ **_should_retry** (`Function`) `[TRIVIAL]`
- 📝 Auto-detected function (orphan)
- ƒ **get_json_completion** (`Function`) `[TRIVIAL]`