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

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

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: vector-task-mcp
-Version: 1.7.0
+Version: 1.7.2
 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.0 → vector_task_mcp-1.7.2}/pyproject.toml

@@ -1,6 +1,6 @@
 [project]
 name = "vector-task-mcp"
-version = "1.7.0"
+version = "1.7.2"
 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.0 → vector_task_mcp-1.7.2}/src/CASES.md

@@ -2154,7 +2154,8 @@ mcp__vector-memory__store_memory(
 
 ---
 
-## Gates & Rules Scenarios
+## Gates Rules Scenarios
+<!-- description: Critical gates and constitutional rules. WHEN to enforce, not HOW to implement. -->
 
 Critical rules and guardrails for task operations. Violations break system integrity.
 
@@ -2287,6 +2288,154 @@ VIOLATION: Analyze dependencies. Only mark parallel: true when independence conf
 
 ---
 
+### Six Constitutional Gates
+
+Six mandatory gates that protect system integrity. Each gate is a self-contained enforcement point.
+
+---
+
+#### Gate 1: MCP-JSON-ONLY
+
+```
+RULE: ALL MCP calls MUST use JSON-RPC via MCP tools. NEVER direct database/file access.
+WHY: MCP ensures embedding generation, validation, and data integrity.
+TRIGGER: Any task/memory operation.
+
+ENFORCEMENT:
+  BEFORE: Verify using mcp__vector-task__* or mcp__vector-memory__*
+  AFTER: If direct access detected → REJECT + escalate
+
+BAD:  sqlite3.connect('./memory/tasks.db')
+GOOD: mcp__vector-task__task_list({...})
+```
+
+---
+
+#### Gate 2: Lightweight Lawyer Gate
+
+```
+RULE: ALL proposals MUST pass 5-check verification before storage.
+WHY: Prevents low-quality proposals from polluting memory.
+TRIGGER: Self-improvement proposals, instruction changes.
+
+CHECKLIST:
+  1. Iron Rules: Does NOT violate any → PASS
+  2. Measurable: Has specific metric → PASS
+  3. Reversible: Has rollback plan → PASS
+  4. Scope: Does NOT expand task → PASS
+  5. Security: Does NOT weaken (or improves) → PASS
+
+ENFORCEMENT:
+  IF 5/5 PASS → Store proposal
+  IF security/iron_rules/scope FAIL → REJECT
+  ELSE → CLARIFY
+
+See: "Lightweight Lawyer Gate Scenarios" section for full details.
+```
+
+---
+
+#### Gate 3: Constitutional Learn Protocol
+
+```
+RULE: ALL failures with trigger signals MUST store lessons to memory.
+WHY: Captures failure patterns for future prevention.
+TRIGGER: retries > 0, stuck tag, validation-fix, blocked, user correction.
+
+STEPS:
+  1. Detect trigger signal in task
+  2. Search memory for duplicates
+  3. IF unique → Store with format:
+     FAILURE: {what}
+     ROOT CAUSE: {why}
+     FIX: {how}
+     PREVENTION: {pattern}
+     CONTEXT: Task #{id}
+  4. Link memory ID in task comment
+
+ENFORCEMENT:
+  AFTER task completion: IF trigger detected AND no lesson stored → ESCALATE
+
+See: "Constitutional Learn Protocol Scenarios" section for full details.
+```
+
+---
+
+#### Gate 4: Category Discipline Contract
+
+```
+RULE: Categories are FIXED. NEVER create new categories dynamically.
+WHY: Prevents category drift and search fragmentation.
+TRIGGER: Any memory/task storage.
+
+ALLOWED CATEGORIES (Task MCP):
+  (None - tasks use tags only)
+
+ALLOWED CATEGORIES (Memory MCP):
+  code-solution, bug-fix, architecture, learning, debugging,
+  performance, security, project-context, other
+
+ENFORCEMENT:
+  BEFORE storage: IF category not in allowed list → REJECT
+  AFTER storage: IF category mismatch detected → DELETE + re-store
+
+BAD:  store_memory({category: "new-feature", ...})
+GOOD: store_memory({category: "code-solution", ...})
+```
+
+---
+
+#### Gate 5: Cookbook-First Gate
+
+```
+RULE: When uncertain, CALL cookbook() BEFORE assuming or searching elsewhere.
+WHY: Cookbook contains authoritative patterns, tools, and best practices.
+TRIGGER: Uncertainty about tools, patterns, rules, or procedures.
+
+STEPS:
+  1. IF uncertain → mcp__vector-task__cookbook() or mcp__vector-memory__cookbook()
+  2. IF answer found → Apply pattern
+  3. IF not found → THEN search memory/docs/web
+
+ENFORCEMENT:
+  IF question answered by cookbook BUT not called first → WARN
+  IF repeated violations → ESCALATE
+
+PRIORITY ORDER:
+  1. cookbook() - authoritative
+  2. vector memory - context-specific
+  3. external docs - supplementary
+```
+
+---
+
+#### Gate 6: Failure Escalation Gate
+
+```
+RULE: Failures MUST escalate according to severity. NEVER silently continue.
+WHY: Prevents error cascades and ensures visibility.
+TRIGGER: Any failure, error, or unexpected state.
+
+ESCALATION LEVELS:
+
+| Severity | Condition | Action |
+|----------|-----------|--------|
+| CRITICAL | Data loss risk, security breach | STOP + ALERT human immediately |
+| HIGH | System integrity at risk | STOP + Log + Store lesson |
+| MEDIUM | Task failure, retry possible | RETRY (max 3) + Store lesson |
+| LOW | Minor issue, workaround exists | LOG + Continue |
+
+ENFORCEMENT:
+  IF CRITICAL failure AND continued → SEVERE VIOLATION
+  IF retries > 3 AND no escalation → VIOLATION
+  IF lesson stored but no retry/escalation → INCOMPLETE
+
+ESCALATION PATH:
+  Agent → Brain → Human (CRITICAL only)
+```
+
+---
+
 ### Cross-Reference with Memory MCP Rules
 
 | Task Rule | Memory Rule | Coordination |

vector_task_mcp-1.7.2/tests/test_cases_integrity.py

@@ -0,0 +1,211 @@
+"""
+Test CASES.md integrity: all categories must have description and content.
+
+Run: pytest tests/test_cases_integrity.py -v
+
+This test ensures:
+1. All categories have non-empty description in <!-- description: ... -->
+2. All categories have actual content (not empty when queried)
+3. Category naming follows conventions
+"""
+
+import re
+import pytest
+from pathlib import Path
+
+
+CASES_FILE = Path(__file__).parent.parent / "src" / "CASES.md"
+
+
+def parse_categories_from_cases():
+    """Parse all category headers with their descriptions from CASES.md"""
+    content = CASES_FILE.read_text()
+    
+    # Pattern: ## Name Scenarios (optional) followed by optional <!-- description: ... -->
+    pattern = r'^## (.+?)(?: Scenarios)?(?: \([A-Z]+\))?\n(?:<!-- description: (.+?) -->)?'
+    matches = re.findall(pattern, content, re.MULTILINE)
+    
+    categories = []
+    for name, description in matches:
+        # Convert name to key: "Gates & Rules" -> "gates-rules"
+        key = name.lower()
+        key = re.sub(r'[&()]', '', key)
+        key = re.sub(r'\s+', '-', key)
+        key = re.sub(r'-+', '-', key).strip('-')
+        
+        categories.append({
+            "name": name,
+            "key": key,
+            "description": description.strip() if description else ""
+        })
+    
+    return categories
+
+
+def get_expected_categories():
+    """Expected categories based on cookbook API"""
+    return [
+        "essential-patterns",
+        "task-decision", 
+        "task-creation",
+        "task-execution",
+        "search-query",
+        "tag-normalization",
+        "hierarchy-decomposition",
+        "status-time-tracking",
+        "error-handling-recovery",
+        "parallel-execution",
+        "validation",
+        "tag-intelligence",
+        "debug-developer",
+        "tag-selection",
+        "statistics-reporting",
+        "brainstorm-ideation",
+        "multi-probe-search",
+        "comment-context",
+        "memory-integration",
+        "gates-rules",
+        "cookbook-usage",
+        "garbage-collection-cleanup",
+        "anti-pattern-examples",
+        "technical-debt-management",
+        "constitutional-learn-protocol",
+        "self-improvement",
+        "lightweight-lawyer-gate",
+        "standard-search-patterns-quick-reference",
+        "tag-taxonomy-quick-reference",
+    ]
+
+
+class TestCasesIntegrity:
+    """Test suite for CASES.md integrity"""
+    
+    def test_cases_file_exists(self):
+        """CASES.md must exist"""
+        assert CASES_FILE.exists(), f"CASES.md not found at {CASES_FILE}"
+    
+    def test_all_categories_have_description(self):
+        """All categories must have non-empty description"""
+        categories = parse_categories_from_cases()
+        
+        missing_descriptions = []
+        for cat in categories:
+            if not cat["description"]:
+                missing_descriptions.append(cat["key"])
+        
+        assert not missing_descriptions, (
+            f"Categories missing description:\n"
+            + "\n".join(f"  - {k}" for k in missing_descriptions)
+            + "\n\nFix: Add <!-- description: Your description here --> after the ## header"
+        )
+    
+    def test_expected_categories_exist(self):
+        """All expected categories must be present in CASES.md"""
+        categories = parse_categories_from_cases()
+        found_keys = {cat["key"] for cat in categories}
+        expected_keys = set(get_expected_categories())
+        
+        missing = expected_keys - found_keys
+        extra = found_keys - expected_keys
+        
+        error_parts = []
+        if missing:
+            error_parts.append(f"Missing categories:\n" + "\n".join(f"  - {k}" for k in sorted(missing)))
+        if extra:
+            error_parts.append(f"Unexpected categories:\n" + "\n".join(f"  - {k}" for k in sorted(extra)))
+        
+        assert not missing and not extra, "\n\n".join(error_parts)
+    
+    def test_category_key_format(self):
+        """Category keys must follow lowercase-with-dashes format"""
+        categories = parse_categories_from_cases()
+        
+        invalid_keys = []
+        for cat in categories:
+            # Should be lowercase, dashes only, no double dashes
+            if not re.match(r'^[a-z0-9]+(-[a-z0-9]+)*$', cat["key"]):
+                invalid_keys.append(f"{cat['name']} -> {cat['key']}")
+        
+        assert not invalid_keys, (
+            f"Invalid category key formats:\n"
+            + "\n".join(f"  - {k}" for k in invalid_keys)
+            + "\n\nKeys must be lowercase with single dashes: 'gates-rules', not 'Gates & Rules'"
+        )
+    
+    def test_description_quality(self):
+        """Descriptions should be meaningful (not too short, not placeholder)"""
+        categories = parse_categories_from_cases()
+        
+        weak_descriptions = []
+        for cat in categories:
+            desc = cat["description"]
+            # Check for placeholder-like descriptions
+            if desc.lower() in ["", "todo", "tbd", "n/a", "none"]:
+                weak_descriptions.append(f"{cat['key']}: '{desc}' (empty/placeholder)")
+            elif len(desc) < 20:
+                weak_descriptions.append(f"{cat['key']}: '{desc}' (too short, min 20 chars)")
+        
+        assert not weak_descriptions, (
+            f"Weak descriptions found:\n"
+            + "\n".join(f"  - {d}" for d in weak_descriptions)
+            + "\n\nDescriptions should be informative and at least 20 characters"
+        )
+    
+    def test_gates_rules_has_content(self):
+        """gates-rules category must have 6 constitutional gates"""
+        content = CASES_FILE.read_text()
+        
+        gates_match = re.search(
+            r'^## Gates.*?Rules.*?(?=^## |\Z)',
+            content,
+            re.MULTILINE | re.DOTALL
+        )
+        
+        assert gates_match, "gates-rules section not found in CASES.md"
+        
+        gates_content = gates_match.group(0)
+        
+        required_gates = [
+            "Gate 1: MCP-JSON-ONLY",
+            "Gate 2: Lightweight Lawyer Gate",
+            "Gate 3: Constitutional Learn Protocol",
+            "Gate 4: Category Discipline Contract",
+            "Gate 5: Cookbook-First Gate",
+            "Gate 6: Failure Escalation Gate"
+        ]
+        
+        missing_gates = []
+        for gate in required_gates:
+            if gate.lower() not in gates_content.lower():
+                missing_gates.append(gate)
+        
+        assert not missing_gates, (
+            f"gates-rules missing required gates:\n"
+            + "\n".join(f"  - {g}" for g in missing_gates)
+        )
+        
+        assert "[CRITICAL]" in gates_content, "gates-rules must contain CRITICAL priority rules"
+        assert "[HIGH]" in gates_content, "gates-rules must contain HIGH priority rules"
+
+
+# CLI helper to show current status
+if __name__ == "__main__":
+    print("=== CASES.md Integrity Check ===\n")
+    
+    categories = parse_categories_from_cases()
+    expected = set(get_expected_categories())
+    
+    print("Categories with descriptions:\n")
+    for cat in categories:
+        status = "✓" if cat["description"] else "✗ MISSING"
+        print(f"  {status} {cat['key']}")
+        if cat["description"]:
+            print(f"      {cat['description'][:60]}{'...' if len(cat['description']) > 60 else ''}")
+    
+    print(f"\nTotal: {len(categories)} categories")
+    print(f"Missing descriptions: {sum(1 for c in categories if not c['description'])}")
+    
+    found_keys = {cat["key"] for cat in categories}
+    missing = expected - found_keys
+    if missing:
+        print(f"\nMissing categories: {missing}")

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

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: vector-task-mcp
-Version: 1.7.0
+Version: 1.7.2
 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.0 → vector_task_mcp-1.7.2}/vector_task_mcp.egg-info/SOURCES.txt

@@ -17,6 +17,7 @@ src/models.py
 src/normalization.py
 src/security.py
 src/task_store.py
+tests/test_cases_integrity.py
 tests/test_normalization.py
 tests/test_task_store.py
 vector_task_mcp.egg-info/PKG-INFO