vector-task-mcp 1.7.2__tar.gz → 1.7.3__tar.gz

{vector_task_mcp-1.7.2 → vector_task_mcp-1.7.3}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: vector-task-mcp
-Version: 1.7.2
+Version: 1.7.3
 Summary: A secure, vector-based task management server for Claude Desktop using sqlite-vec and sentence-transformers
 Author-email: Xsaven <xsaven@gmail.com>
 License-Expression: MIT

{vector_task_mcp-1.7.2 → vector_task_mcp-1.7.3}/pyproject.toml

@@ -1,6 +1,6 @@
 [project]
 name = "vector-task-mcp"
-version = "1.7.2"
+version = "1.7.3"
 description = "A secure, vector-based task management server for Claude Desktop using sqlite-vec and sentence-transformers"
 readme = "README.md"
 requires-python = ">=3.10"

{vector_task_mcp-1.7.2 → vector_task_mcp-1.7.3}/src/CASES.md

@@ -2152,6 +2152,96 @@ mcp__vector-memory__store_memory(
 )
 ```
 
+---
+---
+
+## Workflow Scenarios
+<!-- description: Multi-step MCP operation sequences with verification. Create-then-validate, update-then-confirm patterns. -->
+
+### Create-Then-Validate
+
+After task_create, immediately task_get to confirm fields persisted correctly. Prevents phantom tasks.
+
+**Priority:** HIGH
+
+```python
+# Step 1: Create the task
+result = mcp__vector-task__task_create({
+    "title": "Add rate limiting to API endpoints",
+    "description": "Implement rate limiting middleware for all /api/* routes. Apply to controllers in app/Http/Controllers/Api/.",
+    "tags": ["feature", "api", "strict:standard"],
+    "estimate": 3.0,
+    "priority": "high"
+})
+
+# Step 2: Validate by fetching the created task
+task = mcp__vector-task__task_get({
+    "task_id": result["task_id"]
+})
+
+# Step 3: Confirm fields
+# task.title == "Add rate limiting to API endpoints" → title persisted
+# task.status == "pending" → correct initial status
+# "feature" in task.tags → tags persisted
+# task.estimate == 3.0 → estimate persisted
+# If task_get returns error → creation failed silently
+# If fields mismatch → data integrity issue
+```
+
+**When to use:**
+- After creating tasks with complex tag sets
+- After creating subtasks in a hierarchy (verify parent_id linkage)
+- When task_create returns success but downstream operations depend on the task existing
+- Before starting delegation that references the created task_id
+
+**Iron rule alignment:**
+- `explore-before-execute` (CRITICAL): mandates exploring context before execution
+- This pattern extends it: execute-then-verify for write operations
+- Combined flow: explore (context check) → create → validate (get + confirm)
+
+**Governance:** Uses compile-time preset. No additional cookbook pulls needed.
+
+---
+
+### Create-Subtask-Then-Validate-Hierarchy
+
+For hierarchical tasks: create subtask, verify parent linkage.
+
+```python
+# Step 1: Verify parent exists and is accessible
+parent = mcp__vector-task__task_get({
+    "task_id": "parent-42"
+})
+# Confirm: parent exists, parent.status allows subtask creation
+
+# Step 2: Create subtask
+result = mcp__vector-task__task_create({
+    "title": "Implement rate limiter middleware class",
+    "description": "Create RateLimiterMiddleware in app/Http/Middleware/",
+    "tags": ["feature", "api"],
+    "estimate": 1.5,
+    "parent_id": "parent-42"
+})
+
+# Step 3: Validate subtask + hierarchy
+subtask = mcp__vector-task__task_get({
+    "task_id": result["task_id"]
+})
+# Confirm: subtask.parent_id == "parent-42"
+# Confirm: subtask.status == "pending"
+
+# Step 4: Verify parent sees child (optional)
+parent_refreshed = mcp__vector-task__task_get({
+    "task_id": "parent-42"
+})
+# Confirm: result["task_id"] in parent_refreshed.children
+```
+
+**Iron rule alignment:**
+- `parent-readonly` (CRITICAL): parent task is READ-ONLY, never update parent status manually
+- Status propagation is AUTOMATIC: child→pending implies parent→pending
+
+---
 ---
 
 ## Gates Rules Scenarios

{vector_task_mcp-1.7.2 → vector_task_mcp-1.7.3}/tests/test_cases_integrity.py

@@ -74,6 +74,7 @@ def get_expected_categories():
         "lightweight-lawyer-gate",
         "standard-search-patterns-quick-reference",
         "tag-taxonomy-quick-reference",
+        "workflow",
     ]
 
 
@@ -187,6 +188,103 @@ class TestCasesIntegrity:
         assert "[CRITICAL]" in gates_content, "gates-rules must contain CRITICAL priority rules"
         assert "[HIGH]" in gates_content, "gates-rules must contain HIGH priority rules"
 
+    def test_no_banned_phrases_in_new_categories(self):
+        """New categories (workflow) must not contain uncertainty triggers"""
+        content = CASES_FILE.read_text()
+
+        # Extract only new category: workflow
+        new_sections = []
+        for section_name in ["Workflow"]:
+            match = re.search(
+                rf'^## {section_name}.*?(?=^## |\Z)',
+                content,
+                re.MULTILINE | re.DOTALL
+            )
+            if match:
+                new_sections.append((section_name, match.group(0)))
+
+        banned_patterns = [
+            (r'[Tt]rigger.*[Uu]ncertainty', 'Trigger...Uncertainty'),
+            (r'[Ww]hen uncertain', 'when uncertain'),
+            (r'[Bb]efore assuming', 'before assuming'),
+        ]
+
+        violations = []
+        for section_name, section_content in new_sections:
+            for pattern, label in banned_patterns:
+                matches = re.findall(pattern, section_content)
+                if matches:
+                    violations.append(f"{section_name}: found '{label}' ({len(matches)}x)")
+
+        assert not violations, (
+            f"Banned phrases in new categories:\n"
+            + "\n".join(f"  - {v}" for v in violations)
+            + "\n\nThese phrases are uncertainty triggers banned by Brain governance."
+            + "\n  Use compile-time presets and explicit onViolation instead."
+        )
+
+    def test_mcp_examples_json_syntax(self):
+        """MCP call examples in new categories must use JSON object syntax"""
+        content = CASES_FILE.read_text()
+
+        # Extract workflow section
+        new_sections = []
+        for section_name in ["Workflow"]:
+            match = re.search(
+                rf'^## {section_name}.*?(?=^## |\Z)',
+                content,
+                re.MULTILINE | re.DOTALL
+            )
+            if match:
+                new_sections.append((section_name, match.group(0)))
+
+        violations = []
+        for section_name, section_content in new_sections:
+            # Find all mcp__ calls
+            mcp_calls = re.findall(
+                r'(mcp__[a-z_-]+__[a-z_]+)\(([^)]*)\)',
+                section_content,
+                re.DOTALL
+            )
+            for tool_name, payload in mcp_calls:
+                payload_stripped = payload.strip()
+                if not payload_stripped:
+                    continue  # Empty call (e.g., cookbook()) is valid
+                # Payload must start with { (JSON object)
+                if not payload_stripped.startswith('{'):
+                    violations.append(
+                        f"{section_name}: {tool_name}() payload not JSON object: "
+                        f"'{payload_stripped[:50]}...'"
+                    )
+
+        assert not violations, (
+            f"MCP examples must use JSON object syntax:\n"
+            + "\n".join(f"  - {v}" for v in violations)
+            + "\n\nCorrect: mcp__tool__op({\"key\": \"value\"})"
+            + "\n  Wrong: mcp__tool__op(key=\"value\")"
+        )
+
+    def test_workflow_has_verification_step(self):
+        """Workflow category must contain verification/confirm pattern"""
+        content = CASES_FILE.read_text()
+
+        workflow_match = re.search(
+            r'^## Workflow.*?(?=^## |\Z)',
+            content,
+            re.MULTILINE | re.DOTALL
+        )
+
+        assert workflow_match, "Workflow section not found in CASES.md"
+
+        workflow_content = workflow_match.group(0)
+
+        assert re.search(r'[Vv]erif', workflow_content), (
+            "Workflow section must contain verification step (verify/verified/verification)"
+        )
+        assert re.search(r'[Cc]onfirm', workflow_content), (
+            "Workflow section must contain confirmation step (confirm/confirmed)"
+        )
+
 
 # CLI helper to show current status
 if __name__ == "__main__":

{vector_task_mcp-1.7.2 → vector_task_mcp-1.7.3}/vector_task_mcp.egg-info/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: vector-task-mcp
-Version: 1.7.2
+Version: 1.7.3
 Summary: A secure, vector-based task management server for Claude Desktop using sqlite-vec and sentence-transformers
 Author-email: Xsaven <xsaven@gmail.com>
 License-Expression: MIT