feat: attention-optimized semantic protocol v2.7
Core changes: - Add @defgroup/@ingroup to 1791 C2+ contracts (555 files) for HCA 128× pre-training DSA grouping - Add §0.1 Pre-Training Frequency matrix to semantics-core - Add §VIII Attention Architecture rules (ATTN_1-4) with MLA/CSA/HCA/DSA mechanics - Add @defgroup/@ingroup to canonical syntax (§II) and all contract examples Agent prompts (5 files): - Add ZERO-STATE RATIONALE with MLA/CSA/HCA/DSA compression mechanics - Add pre-training note: @RATIONALE/@REJECTED are in-context learned tags - svelte-coder: add missing #region contract, fix Svelte rule violations - python-coder/fullstack-coder: honor function contracts from speckit plan - qa-tester: add attention compliance audit (P3 ATTN_1-4 checks) Skills (6 files): - Translate all axiom_config descriptions to English - Fix doc_dirs to index .opencode/ and .specify/ - Deduplicate 5× complexity_rules → single global_tags catalog - Reduce semantics-svelte 591→485 lines (remove duplicate code blocks) - Fix semantics-testing: 'Short IDs' → 'Short hierarchical IDs' - Fix all examples: flat IDs → hierarchical Domain.Name format - Fix Svelte examples: replace raw Tailwind + <button> with semantic tokens + /ui Speckit workflow (commands + templates): - speckit.plan: add Function-Level Contracts for C3+ with @PRE/@POST/@TEST_EDGE - speckit.plan: add Attention Compliance Gate (ATTN_1-4 before contract generation) - speckit.tasks: add function contract inlining format (constraints in task description) - speckit.specify: load semantics-core for spec density rules - spec-template: add #region contract, @SEMANTICS grouping, hierarchical IDs - ux-reference-template: add #region wrapper - plan-template: add attention gate, @defgroup/@ingroup guidance - tasks-template: add attention audit + rebuild + orphan check tasks - constitution.md: translate to English, add Principle VIII (attention-optimized contracts) Reference modules rewritten (hierarchical IDs + full contracts): - Auth.Jwt: 6 child contracts with @RATIONALE/@REJECTED/@TEST_EDGE - Api.Auth: 5 endpoints with @TEST_EDGE + molecular CoT markers - Migration.Model: @defgroup Migration with 18 @ACTION + 6 @INVARIANT Scripts: - add_defgroup_ingroup.py: zero-risk additive @ingroup migration (1791 insertions) - migrate_hierarchical.py: flat→hierarchical ID dry-run analysis (792 contracts) - merge_prompts.py: merge all prompts/skills/commands into one review file Config: - axiom_config.yaml: 749→395 lines (-47%), English, doc_dirs include prompts - Fix test_datasets.py import collision (rename → test_datasets_routes.py) - Fix test_preview.py: SupersetClient→get_superset_client, AsyncMock, logger f-string
This commit is contained in:
@@ -1,4 +1,5 @@
|
||||
# #region normalizer [C:5] [TYPE Module] [SEMANTICS pydantic, report, task, normalize, status]
|
||||
# @defgroup Services Module group.
|
||||
# @BRIEF Convert task manager task objects into canonical unified TaskReport entities with deterministic fallback behavior.
|
||||
# @LAYER Domain
|
||||
# @RELATION DEPENDS_ON -> [EXT:frontend:TaskModel]
|
||||
@@ -20,6 +21,7 @@ from .type_profiles import get_type_profile, resolve_task_type
|
||||
|
||||
|
||||
# #region status_to_report_status [TYPE Function]
|
||||
# @ingroup Services
|
||||
# @BRIEF Normalize internal task status to canonical report status.
|
||||
# @PRE status may be known or unknown string/enum value.
|
||||
# @POST Always returns one of canonical ReportStatus values.
|
||||
@@ -37,6 +39,7 @@ def status_to_report_status(status: Any) -> ReportStatus:
|
||||
|
||||
|
||||
# #region build_summary [TYPE Function]
|
||||
# @ingroup Services
|
||||
# @BRIEF Build deterministic user-facing summary from task payload and status.
|
||||
# @PRE report_status is canonical; plugin_id may be unknown.
|
||||
# @POST Returns non-empty summary text.
|
||||
@@ -59,6 +62,7 @@ def build_summary(task: Task, report_status: ReportStatus) -> str:
|
||||
|
||||
|
||||
# #region extract_error_context [TYPE Function]
|
||||
# @ingroup Services
|
||||
# @BRIEF Extract normalized error context and next actions for failed/partial reports.
|
||||
# @PRE task is a valid Task object.
|
||||
# @POST Returns ErrorContext for failed/partial when context exists; otherwise None.
|
||||
@@ -100,6 +104,7 @@ def extract_error_context(task: Task, report_status: ReportStatus) -> ErrorConte
|
||||
|
||||
|
||||
# #region normalize_task_report [TYPE Function]
|
||||
# @ingroup Services
|
||||
# @BRIEF Convert one Task to canonical TaskReport envelope.
|
||||
# @PRE task has valid id and plugin_id fields.
|
||||
# @POST Returns TaskReport with required fields and deterministic fallback behavior.
|
||||
|
||||
Reference in New Issue
Block a user