semantics

specs/021-llm-project-assistant/contracts/modules.md

@@ -15,7 +15,7 @@
 # @PRE: Authenticated user context and non-empty user message are provided.
 # @POST: Returns one of deterministic states: needs_clarification, denied, needs_confirmation, started, success, failed.
 # @POST: Long-running operation responses include task_id when task is created.
-# [/DEF:AssistantOrchestratorModule]
+# [/DEF:AssistantOrchestratorModule:Module]
 
 ---
 
@@ -30,7 +30,7 @@
 # @INVARIANT: Parsed intent always includes confidence score and risk_level.
 # @PRE: Input text is available and sanitized.
 # @POST: Returns normalized intent or unknown intent with low confidence.
-# [/DEF:AssistantIntentParserModule]
+# [/DEF:AssistantIntentParserModule:Module]
 
 ---
 
@@ -46,7 +46,7 @@
 # @INVARIANT: Dangerous operations never execute without explicit confirmation token.
 # @PRE: Normalized intent and authenticated user context are available.
 # @POST: Returns one of {denied, needs_confirmation, allowed}.
-# [/DEF:AssistantSecurityGuardModule]
+# [/DEF:AssistantSecurityGuardModule:Module]
 
 ---
 
@@ -65,7 +65,7 @@
 # @INVARIANT: Adapter reuses existing execution paths and does not duplicate domain logic.
 # @PRE: ExecutionRequest is validated and authorized.
 # @POST: Returns operation result or started task_id for async flows.
-# [/DEF:AssistantExecutionAdapterModule]
+# [/DEF:AssistantExecutionAdapterModule:Module]
 
 ---
 
@@ -80,7 +80,7 @@
 # @INVARIANT: Every processed command emits one audit record.
 # @PRE: Command processing context is available.
 # @POST: Structured audit entry persisted with decision/outcome/task_id (if present).
-# [/DEF:AssistantAuditLogModule]
+# [/DEF:AssistantAuditLogModule:Module]
 
 ---
 
@@ -97,7 +97,7 @@
 # @POST: Message endpoint returns assistant response state + metadata.
 # @POST: Confirm endpoint executes pending dangerous command exactly once.
 # @POST: Cancel endpoint prevents execution of pending dangerous command.
-# [/DEF:AssistantApiContract]
+# [/DEF:AssistantApiContract:Module]
 
 ---
 
@@ -110,7 +110,7 @@
  * @PURPOSE: Render in-app assistant conversation and operational command interactions.
  * @LAYER: UI
  * @RELATION: DEPENDS_ON -> [DEF:AssistantApiClient]
- * @RELATION: USES -> [DEF:TaskDrawerStore]
+ * @RELATION: BINDS_TO -> [DEF:TaskDrawerStore:Store]
  * @INVARIANT: Every assistant response is rendered with explicit state badge.
  * @PRE: User is authenticated and assistant panel is accessible.
  * @POST: User can send command, receive response, and confirm/cancel risky operations.
@@ -121,7 +121,7 @@
  * @UX_STATE: Error -> Error card with retry/rephrase guidance displayed.
  * @UX_RECOVERY: User can rephrase ambiguous command or retry after error.
  */
-<!-- [/DEF:AssistantChatPanel] -->
+<!-- [/DEF:AssistantChatPanel:Component] -->
 
 ---
 
@@ -136,7 +136,7 @@
 # @INVARIANT: No direct native fetch bypassing project API wrapper conventions.
 # @PRE: Valid auth context/token exists.
 # @POST: Returns typed assistant response payload or structured error object.
-# [/DEF:AssistantApiClient]
+# [/DEF:AssistantApiClient:Module]
 
 ---