[{"data":1,"prerenderedAt":-1},["ShallowReactive",2],{"skill:01M7ABTJ43ZCCQJMF86AXWH6FC":3,"skill-same:01M7ABTJ43ZCCQJMF86AXWH6FC":51},{"skillNo":4,"name":5,"nameZh":6,"description":7,"descriptionZh":6,"repositoryFullName":8,"ownerLogin":9,"ownerAvatarUrl":10,"ownerAccountNo":11,"ownerDisplayName":6,"repositoryNo":12,"starsCount":13,"licenseSpdxId":14,"licenseFileUrl":6,"sourceHtmlUrl":15,"categories":16,"keywords":17,"publishedAt":18,"linkOnly":19,"markdownContent":20,"markdownBody":21,"frontMatter":22,"refName":26,"commitSha":27,"skillDirectory":28,"forksCount":13,"repositoryHtmlUrl":29,"repositoryHomepageUrl":6,"ownerHtmlUrl":30,"ownerBlogUrl":6,"ownerDescription":6,"updatedAt":31,"install":32,"resources":44},"01M7ABTJ43ZCCQJMF86AXWH6FC","amx-ecm-integration",null,"Load this skill when mapping or integrating AMX memory systems with ECM collaboration tracking and Vibe.\n\nProvides end-to-end architecture mapping for:\n- AMX v1.1 canonical portable memory\n- ECM collaboration state tracking\n- MCP server interfaces\n- Vibe skill integration\n- AutoDev project constraints\n\nUse this when the user needs to understand how AMX, ECM, MCP, and Vibe integrate together.","asshat1981ar\u002FAutoDev","asshat1981ar","https:\u002F\u002Favatars.githubusercontent.com\u002Fu\u002F215423827?v=4","01M7ABSCGSJRTWD09ZWDH8X3SS","01M7ABSCHGJ263MKCYD2KR4R2Y",0,"MIT","https:\u002F\u002Fgithub.com\u002Fasshat1981ar\u002FAutoDev\u002Fblob\u002Fmain\u002F.vibe\u002Fskills\u002Famx-ecm-integration\u002FSKILL.md",[],[],"2026-11-15 14:19:17",false,"---\nname: amx-ecm-integration\ndescription: |\n  Load this skill when mapping or integrating AMX memory systems with ECM collaboration tracking and Vibe.\n  \n  Provides end-to-end architecture mapping for:\n  - AMX v1.1 canonical portable memory\n  - ECM collaboration state tracking\n  - MCP server interfaces\n  - Vibe skill integration\n  - AutoDev project constraints\n  \n  Use this when the user needs to understand how AMX, ECM, MCP, and Vibe integrate together.\nmodel: mistral-medium-3.5\nuser-invocable: true\n---\n\n# AMX\u002FECM\u002FVibe End-to-End Integration Guide\n\n**Purpose:** Complete architecture mapping and integration patterns for AMX memory, ECM collaboration tracking, MCP servers, and Vibe skills within AutoDev constraints.\n\n## Architecture Overview\n\n```\n┌─────────────────────────────────────────────────────────────────┐\n│                        Vibe Agent Runtime                         │\n├─────────────────────────────────────────────────────────────────┤\n│                                                                  │\n│  ┌──────────────┐    ┌──────────────┐    ┌──────────────────┐  │\n│  │   User       │    │   Skills     │    │    MCP Servers    │  │\n│  │   Request    │───▶│   System     │───▶│    (External)     │  │\n│  └──────────────┘    └──────────────┘    └──────────────────┘  │\n│           │                  │                     │             │\n│           └──────────────────┴─────────────────────┘             │\n│                              │                                     │\n│                    ┌─────────┴─────────┐                          │\n│                    │   Tool Registry    │                          │\n│                    └─────────┬─────────┘                          │\n│                              │                                     │\n│         ┌────────────────────┼────────────────────┐              │\n│         │                    │                    │              │\n│   ┌─────▼─────┐      ┌─────▼─────┐        ┌─────▼─────┐        │\n│   │ AMX Memory│      │ ECM State │        │ Engram MCP │        │\n│   │ Component │      │ Component │        │  Server    │        │\n│   └─────┬─────┘      └─────┬─────┘        └─────┬─────┘        │\n│         │                    │                    │              │\n│   ┌─────▼─────┐      ┌─────▼─────┐        ┌─────▼─────┐        │\n│   │ SQLite    │      │ JSON      │        │ HTTP      │        │\n│   │ Storage   │      │ Storage   │        │ Interface │        │\n│   └───────────┘      └───────────┘        └───────────┘        │\n│                                                                  │\n└─────────────────────────────────────────────────────────────────┘\n```\n\n## Component Breakdown\n\n### 1. AMX (Agent Memory eXchange) v1.1\n\n**Purpose:** Canonical portable memory format for AI agents.\n\n**Required Fields (11 total):**\n```python\nAMX_MEMORY_REQUIRED_FIELDS = {\n    \"schema_version\",           # Always \"amx-memory-v1\"\n    \"origin\",                  # Source identifier\n    \"logical_identity\",        # Unique memory ID\n    \"repository_scope\",        # Repository\u002Fworktree\u002Fproject scope\n    \"provenance\",              # List of provenance entries\n    \"causal_ancestry\",         # List of ancestor references\n    \"trust_validity_state\",    # Trust\u002Fvalidity metadata\n    \"visibility\",              # Access control scope\n    \"purpose\",                 # Intended use metadata\n    \"retraction_deletion_barriers\",  # Deletion controls\n    \"canonical_semantic_digest\"    # SHA-256 hash\n}\n```\n\n**Field Specifications:**\n\n| Field | Type | Required | Default | Description |\n|-------|------|----------|---------|-------------|\n| schema_version | string | Yes | \"amx-memory-v1\" | Schema version identifier |\n| origin | string | Yes | None | Source of the memory |\n| logical_identity | string | Yes | None | Unique identifier |\n| repository_scope | dict | Yes | {} | Repository\u002Fworktree\u002Fproject scope |\n| provenance | list | Yes | [] | Causal history entries |\n| causal_ancestry | list | Yes | [] | Ancestry chain references |\n| trust_validity_state | dict | Yes | See below | Trust and validity metadata |\n| visibility | dict | Yes | {\"scope\": \"workspace\", \"access_level\": \"read\"} | Access control |\n| purpose | dict | Yes | {\"primary\": \"memory\", \"task_class\": \"memory:amx\"} | Intended use |\n| retraction_deletion_barriers | dict | Yes | See below | Deletion controls |\n| canonical_semantic_digest | string | Yes | Computed | SHA-256 hash |\n\n**trust_validity_state defaults:**\n```python\n{\n    \"trust_level\": \"medium\",\n    \"validity_status\": \"unverified\",\n    \"last_validated\": \"\u003CISO-8601 timestamp>\"\n}\n```\n\n**retraction_deletion_barriers defaults:**\n```python\n{\n    \"can_retract\": False,\n    \"can_delete\": False,\n    \"retention_period\": \"infinite\"\n}\n```\n\n**Provenance Entry Structure:**\n```python\n{\n    \"source\": \"skill-name\",\n    \"timestamp\": \"2026-08-21T00:00:00Z\",\n    \"checksum\": \"sha256:...\",\n    \"description\": \"Operation description\"\n}\n```\n\n### 2. ECM (Entity-Collaboration Model)\n\n**Purpose:** Track collaboration history and coordination state.\n\n**Tracked Entity Types (9 total):**\n```python\nECM_ENTITY_TYPES = {\n    \"task\",              # Collaboration task\n    \"attempt\",           # Task attempt\n    \"role\",              # Role assignment\n    \"role_lease\",        # Role lease (time-bound)\n    \"message\",           # Communication message\n    \"artifact_reference\", # Artifact reference\n    \"evidence_reference\", # Evidence reference\n    \"memory_binding\",    # Memory to ECM binding\n    \"ContextView\"        # Context view state\n}\n```\n\n**ECM State Structure:**\n```json\n{\n  \"tasks\": {\n    \"\u003Ctask-id>\": {\n      \"id\": \"\u003Ctask-id>\",\n      \"description\": \"\u003Cdescription>\",\n      \"type\": \"\u003Ctype>\",\n      \"status\": \"\u003Ccreated\u002Fcompleted\u002Ffailed>\",\n      \"created_at\": \"\u003CISO-8601>\",\n      \"completed_at\": \"\u003CISO-8601>\",\n      \"memory_logical_identity\": \"\u003Cmemory-id>\",\n      \"origin\": \"\u003Corigin>\"\n    }\n  },\n  \"attempts\": {\n    \"\u003Cattempt-id>\": {\n      \"id\": \"\u003Cattempt-id>\",\n      \"task_id\": \"\u003Ctask-id>\",\n      \"status\": \"\u003Ccreated\u002Fcompleted\u002Ffailed>\",\n      \"started_at\": \"\u003CISO-8601>\",\n      \"completed_at\": \"\u003CISO-8601>\",\n      \"result\": \"\u003Cresult>\"\n    }\n  },\n  \"roles\": {\n    \"\u003Crole-id>\": {\n      \"id\": \"\u003Crole-id>\",\n      \"name\": \"\u003Cname>\",\n      \"capabilities\": [\"\u003Ccapability>\"],\n      \"assigned_at\": \"\u003CISO-8601>\"\n    }\n  },\n  \"role_leases\": {\n    \"\u003Clease-id>\": {\n      \"id\": \"\u003Clease-id>\",\n      \"role_id\": \"\u003Crole-id>\",\n      \"assigned_to\": \"\u003Cassignee>\",\n      \"expires_at\": \"\u003CISO-8601>\",\n      \"granted_at\": \"\u003CISO-8601>\"\n    }\n  },\n  \"messages\": {\n    \"\u003Cmessage-id>\": {\n      \"id\": \"\u003Cmessage-id>\",\n      \"task_id\": \"\u003Ctask-id>\",\n      \"sender\": \"\u003Csender>\",\n      \"content\": \"\u003Ccontent>\",\n      \"timestamp\": \"\u003CISO-8601>\"\n    }\n  },\n  \"artifact_references\": {\n    \"\u003Cartifact-id>\": {\n      \"id\": \"\u003Cartifact-id>\",\n      \"checksum\": \"\u003Chash>\",\n      \"type\": \"\u003Ctype>\",\n      \"logical_identity\": \"\u003Cmemory-id>\",\n      \"created_at\": \"\u003CISO-8601>\"\n    }\n  },\n  \"evidence_references\": {\n    \"\u003Cevidence-id>\": {\n      \"id\": \"\u003Cevidence-id>\",\n      \"check_name\": \"\u003Ccheck>\",\n      \"passed\": true\u002Ffalse,\n      \"details\": \"\u003Cdetails>\",\n      \"timestamp\": \"\u003CISO-8601>\",\n      \"memory_logical_identity\": \"\u003Cmemory-id>\"\n    }\n  },\n  \"memory_bindings\": {\n    \"\u003Cbinding-id>\": {\n      \"id\": \"\u003Cbinding-id>\",\n      \"memory_logical_identity\": \"\u003Cmemory-id>\",\n      \"ecm_task_id\": \"\u003Ctask-id>\",\n      \"ecm_attempt_id\": \"\u003Cattempt-id>\",\n      \"artifact_id\": \"\u003Cartifact-id>\",\n      \"created_at\": \"\u003CISO-8601>\"\n    }\n  },\n  \"context_views\": {\n    \"\u003Cview-id>\": {\n      \"id\": \"\u003Cview-id>\",\n      \"memory_ids\": [\"\u003Cmemory-id>\"],\n      \"created_at\": \"\u003CISO-8601>\",\n      \"updated_at\": \"\u003CISO-8601>\"\n    }\n  }\n}\n```\n\n### 3. MCP (Model Context Protocol)\n\n**Purpose:** Standard protocol for AI agents to access external resources.\n\n**MCP Server Types in AutoDev:**\n```\n1. Engram MCP Server\n   - SQLite storage\n   - AMX-compliant memory\n   - ECM tracking\n   - HTTP interface\n\n2. GitHub App MCP\n   - GitHub API integration\n   - Repository access\n   - Issue\u002FPR management\n\n3. Linear MCP\n   - Linear API integration\n   - Issue tracking\n   - Project management\n```\n\n**MCP HTTP Endpoints (Engram):**\n```\nGET  \u002Fmemory\u002Flist              # List all memories\nGET  \u002Fmemory\u002F{id}              # Retrieve specific memory\nGET  \u002Fmemory\u002Fsearch            # Search memories (type, limit)\nPOST \u002Fmemory\u002Fstore            # Store new memory\nGET  \u002Fmemory\u002Fvalidate          # Validate AMX compliance\nGET  \u002Fecm\u002Fmemory\u002F{id}\u002Ftask    # Get ECM task\nGET  \u002Fecm\u002Fmemory\u002F{id}\u002Fattempts # Get ECM attempts\nGET  \u002Fecm\u002Fmemory\u002F{id}\u002Fbinding  # Get ECM binding\nGET  \u002Fecm\u002Fmemory\u002F{id}\u002Fevidence # Get ECM evidence\n```\n\n### 4. Vibe Skills System\n\n**Skill Discovery Order:**\n1. `skill_paths` from config.toml\n2. `.vibe\u002Fskills\u002F` (project)\n3. `.agents\u002Fskills\u002F` (project)\n4. `~\u002F.vibe\u002Fskills\u002F` (user)\n5. `~\u002F.agents\u002Fskills\u002F` (user)\n\n**Skill Types in AutoDev:**\n```python\nclass SkillType(Enum):\n    AMX_MEMORY = \"amx-memory\"        # AMX memory skills\n    ECM = \"ecm\"                      # ECM tracking skills\n    EVIDENCE = \"evidence\"            # Evidence\u002Fverification skills\n    HOST_ADAPTER = \"host-adapter\"    # Vibe tool extensions\n    MCP_SERVER = \"mcp-server\"        # MCP server skills\n    ENGRAM_MCP = \"engram-mcp\"        # Engram MCP skills\n    GENERAL = \"general\"              # General purpose skills\n```\n\n## Integration Patterns\n\n### Pattern 1: AMX + ECM in Engram MCP\n\n```python\nclass EngramMCPServer:\n    \"\"\"Engram MCP Server with AMX compliance and ECM tracking.\"\"\"\n    \n    def __init__(self):\n        # AMX compliance\n        self.AMX_REQUIRED_FIELDS = {...}\n        \n        # ECM state\n        self.ecm_state = {\n            \"tasks\": {},\n            \"attempts\": {},\n            \"roles\": {},\n            # ... all ECM entity types\n        }\n        \n        # Database\n        self.db_path = \".vibe\u002Fengram-memory\u002Fmemory.db\"\n        self.ecm_state_path = \".vibe\u002Fengram-memory\u002Fecm-state.json\"\n    \n    def store_memory(self, memory: Dict[str, Any]) -> str:\n        \"\"\"Store memory with AMX compliance and ECM tracking.\"\"\"\n        \n        # 1. Validate AMX compliance\n        validation = self.validate_amx(memory)\n        if not validation[\"valid\"]:\n            raise ValueError(validation[\"message\"])\n        \n        # 2. Auto-populate missing AMX fields\n        memory = self._auto_populate_amx(memory)\n        \n        # 3. Compute canonical digest\n        memory[\"canonical_semantic_digest\"] = self.compute_digest(memory)\n        \n        # 4. Track in ECM\n        ecm_task_id = self._track_ecm_store(memory)\n        \n        # 5. Store in database\n        return self._store_in_db(memory, ecm_task_id)\n    \n    def validate_amx(self, memory: Dict[str, Any]) -> Dict[str, Any]:\n        \"\"\"Validate memory against AMX v1.1 schema.\"\"\"\n        missing = self.AMX_REQUIRED_FIELDS - set(memory.keys())\n        \n        # Auto-populate defaults\n        for field, default in AMX_DEFAULTS.items():\n            if field in missing:\n                memory[field] = default\n                missing.discard(field)\n        \n        # Type validation\n        if not isinstance(memory.get(\"provenance\"), list):\n            return {\"valid\": False, \"message\": \"provenance must be a list\"}\n        \n        if not isinstance(memory.get(\"causal_ancestry\"), list):\n            return {\"valid\": False, \"message\": \"causal_ancestry must be a list\"}\n        \n        return {\n            \"valid\": len(missing) == 0,\n            \"missing_fields\": sorted(list(missing)),\n            \"message\": \"AMX v1.1 compliant\" if not missing else \n                       f\"Missing fields: {', '.join(sorted(missing))}\"\n        }\n    \n    def _track_ecm_store(self, memory: Dict[str, Any]) -> str:\n        \"\"\"Create ECM records for store operation.\"\"\"\n        timestamp = datetime.now(timezone.utc).isoformat()\n        task_id = f\"memory:{memory['logical_identity']}:store\"\n        \n        # Create task\n        self.ecm_state[\"tasks\"][task_id] = {\n            \"id\": task_id,\n            \"description\": f\"Store AMX memory {memory['logical_identity']}\",\n            \"type\": \"memory:store\",\n            \"status\": \"completed\",\n            \"created_at\": timestamp,\n            \"completed_at\": timestamp,\n            \"memory_logical_identity\": memory[\"logical_identity\"],\n            \"origin\": memory.get(\"origin\", \"engram-mcp\")\n        }\n        \n        # Create attempt\n        attempt_id = f\"{task_id}:attempt:1\"\n        self.ecm_state[\"attempts\"][attempt_id] = {\n            \"id\": attempt_id,\n            \"task_id\": task_id,\n            \"status\": \"completed\",\n            \"started_at\": timestamp,\n            \"completed_at\": timestamp,\n            \"result\": \"stored\"\n        }\n        \n        # Create role\n        role_id = \"memory:amx\"\n        if role_id not in self.ecm_state[\"roles\"]:\n            self.ecm_state[\"roles\"][role_id] = {\n                \"id\": role_id,\n                \"name\": \"AMX Memory Manager\",\n                \"capabilities\": [\"memory:store\", \"memory:retrieve\", \"memory:validate\"],\n                \"assigned_at\": timestamp\n            }\n        \n        # Create artifact reference\n        artifact_id = f\"artifact:memory:{memory['logical_identity']}\"\n        self.ecm_state[\"artifact_references\"][artifact_id] = {\n            \"id\": artifact_id,\n            \"checksum\": memory.get(\"canonical_semantic_digest\", \"\"),\n            \"type\": \"memory\",\n            \"logical_identity\": memory[\"logical_identity\"],\n            \"created_at\": timestamp\n        }\n        \n        # Create memory binding\n        binding_id = f\"binding:memory:{memory['logical_identity']}:ecm:task:{task_id}\"\n        self.ecm_state[\"memory_bindings\"][binding_id] = {\n            \"id\": binding_id,\n            \"memory_logical_identity\": memory[\"logical_identity\"],\n            \"ecm_task_id\": task_id,\n            \"ecm_attempt_id\": attempt_id,\n            \"artifact_id\": artifact_id,\n            \"created_at\": timestamp\n        }\n        \n        # Create evidence reference\n        evidence_id = f\"evidence:amx:memory:{memory['logical_identity']}:store\"\n        validation_result = self.validate_amx(memory)\n        self.ecm_state[\"evidence_references\"][evidence_id] = {\n            \"id\": evidence_id,\n            \"check_name\": \"amx_compliance\",\n            \"passed\": validation_result[\"valid\"],\n            \"details\": validation_result[\"message\"],\n            \"timestamp\": timestamp,\n            \"memory_logical_identity\": memory[\"logical_identity\"]\n        }\n        \n        self._save_ecm_state()\n        return task_id\n```\n\n### Pattern 2: MCP Server with AMX\u002FECM\n\n```python\nclass AMXECMMCPServer(MCPServer):\n    \"\"\"MCP Server with full AMX\u002FECM integration.\"\"\"\n    \n    def __init__(self):\n        super().__init__()\n        self.memory_store = EngramMCPServer()\n    \n    def handle_resource_read(self, uri: str) -> Dict[str, Any]:\n        \"\"\"Handle MCP resource read requests.\"\"\"\n        if uri.startswith(\"memory:\u002F\u002F\"):\n            # Extract logical identity from URI\n            logical_id = uri.replace(\"memory:\u002F\u002F\", \"\")\n            memory = self.memory_store.retrieve(logical_id)\n            \n            # Track ECM retrieve operation\n            self.memory_store._track_ecm_retrieve(logical_id)\n            \n            return {\"memory\": memory}\n        \n        elif uri.startswith(\"ecm:\u002F\u002F\"):\n            # Handle ECM resource\n            parts = uri.split(\"\u002F\")\n            entity_type = parts[2]  # memory, task, attempt, etc.\n            entity_id = parts[3]\n            \n            if entity_type == \"memory\":\n                ecm_data = self._get_ecm_for_memory(entity_id)\n                return {\"ecm\": ecm_data}\n        \n        raise ValueError(f\"Unknown resource URI: {uri}\")\n    \n    def handle_resource_list(self, uri_prefix: str) -> List[str]:\n        \"\"\"Handle MCP resource list requests.\"\"\"\n        if uri_prefix == \"memory:\u002F\u002F\":\n            memories = self.memory_store.query(limit=100)\n            return [f\"memory:\u002F\u002F{m['logical_identity']}\" for m in memories]\n        \n        elif uri_prefix == \"ecm:\u002F\u002F\":\n            tasks = list(self.memory_store.ecm_state[\"tasks\"].keys())\n            return [f\"ecm:\u002F\u002Ftask\u002F{task_id}\" for task_id in tasks]\n        \n        return []\n    \n    def handle_tool_call(self, name: str, arguments: Dict[str, Any]) -> Dict[str, Any]:\n        \"\"\"Handle MCP tool calls.\"\"\"\n        if name == \"memory_store\":\n            # Validate AMX\n            validation = self.memory_store.validate_amx(arguments.get(\"memory\", {}))\n            if not validation[\"valid\"]:\n                return {\"error\": validation[\"message\"]}\n            \n            # Store with ECM tracking\n            logical_id = self.memory_store.store(arguments[\"memory\"])\n            return {\"logical_identity\": logical_id, \"status\": \"stored\"}\n        \n        elif name == \"memory_retrieve\":\n            memory = self.memory_store.retrieve(arguments[\"logical_identity\"])\n            return {\"memory\": memory} if memory else {\"error\": \"Not found\"}\n        \n        elif name == \"amx_validate\":\n            validation = self.memory_store.validate_amx(arguments.get(\"memory\", {}))\n            return validation\n        \n        raise ValueError(f\"Unknown tool: {name}\")\n```\n\n### Pattern 3: Vibe Skill with AMX\u002FECM\n\n```python\nclass AMXECMSkill:\n    \"\"\"Vibe skill with AMX memory and ECM tracking.\"\"\"\n    \n    def __init__(self):\n        self.memory_client = AMXMemoryClient()\n        self.ecm_client = ECMClient()\n    \n    def create_session_memory(self, session_data: Dict[str, Any]) -> str:\n        \"\"\"Create AMX-compliant session memory with ECM tracking.\"\"\"\n        # Build AMX memory\n        memory = {\n            \"schema_version\": \"amx-memory-v1\",\n            \"origin\": \"vibe-session\",\n            \"logical_identity\": f\"session:{uuid.uuid4()}\",\n            \"repository_scope\": {\n                \"repository_path\": \"\u002Fdata\u002Fdata\u002Fcom.termux\u002Ffiles\u002Fhome\u002FAutoDev\",\n                \"worktree_id\": \"primary\"\n            },\n            \"provenance\": [{\n                \"source\": \"vibe-skill\",\n                \"timestamp\": datetime.now(timezone.utc).isoformat(),\n                \"description\": \"Session memory creation\"\n            }],\n            \"causal_ancestry\": [],\n            \"trust_validity_state\": {\n                \"trust_level\": \"high\",\n                \"validity_status\": \"valid\",\n                \"last_validated\": datetime.now(timezone.utc).isoformat()\n            },\n            \"visibility\": {\n                \"scope\": \"session\",\n                \"access_level\": \"read_write\"\n            },\n            \"purpose\": {\n                \"primary\": \"session_memory\",\n                \"task_class\": \"memory:session\"\n            },\n            \"retraction_deletion_barriers\": {\n                \"can_retract\": True,\n                \"can_delete\": False,\n                \"retention_period\": \"session\"\n            },\n            \"memory_type\": \"session\",\n            \"content\": session_data\n        }\n        \n        # Store with AMX\u002FECM\n        logical_id = self.memory_client.store(memory)\n        \n        # Track in ECM\n        self.ecm_client.track_session_start(\n            memory_logical_identity=logical_id,\n            session_data=session_data\n        )\n        \n        return logical_id\n    \n    def end_session(self, session_id: str) -> None:\n        \"\"\"End session and update ECM.\"\"\"\n        # Update memory\n        memory = self.memory_client.retrieve(session_id)\n        if memory:\n            memory[\"purpose\"][\"session_status\"] = \"ended\"\n            memory[\"trust_validity_state\"][\"last_validated\"] = datetime.now(timezone.utc).isoformat()\n            self.memory_client.store(memory)\n        \n        # Update ECM\n        self.ecm_client.track_session_end(\n            memory_logical_identity=session_id,\n            status=\"completed\"\n        )\n```\n\n## AutoDev Integration Points\n\n### 1. ForgeCore Trusted Execution\n\n**Constraint:** Only `crates\u002Fforge-core` can perform untrusted I\u002FO.\n\n**Integration Pattern:**\n```python\n# Vibe skill must delegate to ForgeCore for execution\nclass SafeExecutionSkill:\n    \"\"\"Skill that respects ForgeCore boundaries.\"\"\"\n    \n    def __init__(self):\n        self.forge_core = ForgeCoreAdapter()\n    \n    def execute_workflow(self, workflow: Dict[str, Any]) -> Dict[str, Any]:\n        \"\"\"Execute workflow through ForgeCore.\"\"\"\n        # Create authorization grant\n        grant = AuthorizationGrant(\n            workspace=\"\u002Fdata\u002Fdata\u002Fcom.termux\u002Ffiles\u002Fhome\u002FAutoDev\",\n            permissions=[\"read\", \"write\"],\n            scope=[\"crates\u002Fforge-core\"]\n        )\n        \n        # Delegate to ForgeCore\n        result = self.forge_core.execute(workflow, grant)\n        \n        # Store result as AMX memory\n        memory = self._create_result_memory(workflow, result)\n        self.memory_client.store(memory)\n        \n        return result\n```\n\n### 2. Harness Drift Checking\n\n**Integration with `scripts\u002Fcheck_harness_drift.py`:**\n```python\nclass HarnessDriftChecker:\n    \"\"\"Check AMX\u002FECM compliance in harness drift checks.\"\"\"\n    \n    def check_amx_compliance(self, file_path: str) -> List[Dict[str, Any]]:\n        \"\"\"Check AMX compliance in a file.\"\"\"\n        issues = []\n        \n        # Read file\n        content = read_file(file_path)\n        \n        # Check for AMX memory records\n        memories = self._extract_amx_memories(content)\n        \n        for memory in memories:\n            # Validate AMX\n            validation = self.memory_client.validate_amx(memory)\n            if not validation[\"valid\"]:\n                issues.append({\n                    \"file\": file_path,\n                    \"type\": \"amx_compliance\",\n                    \"severity\": \"error\",\n                    \"message\": validation[\"message\"],\n                    \"missing_fields\": validation.get(\"missing_fields\", [])\n                })\n        \n        return issues\n    \n    def check_ecm_tracking(self, directory: str) -> List[Dict[str, Any]]:\n        \"\"\"Check ECM tracking in a directory.\"\"\"\n        issues = []\n        \n        # Check for ECM state file\n        ecm_file = os.path.join(directory, \".vibe\u002Fengram-memory\u002Fecm-state.json\")\n        if os.path.exists(ecm_file):\n            ecm_state = json.loads(read_file(ecm_file))\n            \n            # Check required ECM entity types\n            required_types = [\"tasks\", \"attempts\", \"memory_bindings\"]\n            for entity_type in required_types:\n                if entity_type not in ecm_state:\n                    issues.append({\n                        \"file\": ecm_file,\n                        \"type\": \"ecm_missing_entity\",\n                        \"severity\": \"warning\",\n                        \"message\": f\"Missing ECM entity type: {entity_type}\"\n                    })\n        \n        return issues\n```\n\n### 3. CI Integration\n\n**Add to `.github\u002Fworkflows\u002Fci.yml`:**\n```yaml\n- name: Check AMX\u002FECM Compliance\n  run: |\n    python -c \"\n    from skills.amx_ecm_integration import AMXECMChecker\n    checker = AMXECMChecker()\n    \n    # Check all Python files for AMX compliance\n    import os\n    for root, dirs, files in os.walk('.'):\n        for file in files:\n            if file.endswith('.py'):\n                path = os.path.join(root, file)\n                issues = checker.check_amx_compliance(path)\n                if issues:\n                    print(f'::error file={path}::AMX compliance issues found')\n                    for issue in issues:\n                        print(f'  - {issue[\\\"message\\\"]}')\n                    exit(1)\n    \n    # Check ECM tracking\n    ecm_issues = checker.check_ecm_tracking('.')\n    if ecm_issues:\n        print('::warning::ECM tracking issues found')\n        for issue in ecm_issues:\n            print(f'  - {issue[\\\"message\\\"]}')\n    \"\n```\n\n## End-to-End Flow Examples\n\n### Example 1: User Request to Skill Action\n\n```\nUser: \"Store this memory: {\\\"content\\\": \\\"Hello\\\", \\\"type\\\": \\\"note\\\"}\"\n\nVibe Flow:\n1. Route to meta-creator skill (user-invocable)\n2. meta-creator recognizes this as AMX memory request\n3. meta-creator delegates to amx-ecm-integration skill\n4. amx-ecm-integration validates AMX fields\n5. amx-ecm-integration auto-populates missing fields\n6. amx-ecm-integration computes canonical digest\n7. amx-ecm-integration tracks in ECM\n8. amx-ecm-integration stores in SQLite\n9. amx-ecm-integration returns logical_identity\n10. meta-creator returns success to user\n\nResult:\n- AMX memory stored with all 11 required fields\n- ECM task, attempt, artifact, binding, evidence all created\n- SQLite database updated\n- ECM state file updated\n- User receives: {\"logical_identity\": \"memory:note:001\", \"status\": \"stored\"}\n```\n\n### Example 2: MCP Client Memory Query\n\n```\nMCP Client Request:\n  Method: GET\n  URI: memory:\u002F\u002Fnote-001\n\nVibe Flow:\n1. MCP server (engram-mcp) receives request\n2. MCP server delegates to EngramMCPServer\n3. EngramMCPServer tracks ECM retrieve operation\n4. EngramMCPServer queries SQLite database\n5. EngramMCPServer converts row to AMX memory dict\n6. EngramMCPServer returns memory to MCP server\n7. MCP server returns to client\n\nResponse:\n{\n  \"memory\": {\n    \"schema_version\": \"amx-memory-v1\",\n    \"origin\": \"engram-mcp\",\n    \"logical_identity\": \"note-001\",\n    \"repository_scope\": {...},\n    \"provenance\": [...],\n    \"causal_ancestry\": [],\n    \"trust_validity_state\": {...},\n    \"visibility\": {...},\n    \"purpose\": {...},\n    \"retraction_deletion_barriers\": {...},\n    \"canonical_semantic_digest\": \"sha256:...\",\n    \"memory_type\": \"note\",\n    \"content\": \"Hello\",\n    \"ecm_task_id\": \"memory:note-001:retrieve\"\n  }\n}\n\nECM State Updated:\n- New task: memory:note-001:retrieve\n- New attempt: memory:note-001:retrieve:attempt:1\n```\n\n### Example 3: Skill Creation with AMX\u002FECM\n\n```\nUser: \"\u002Fskill-creator create amx-powered-tool\"\n\nVibe Flow:\n1. skill-creator skill loaded\n2. skill-creator prompts for skill details\n3. User provides: name, description, purpose\n4. skill-creator generates skill directory\n5. skill-creator uses ENGRAM_MCP_IMPL_TEMPLATE\n6. Template includes AMX validation\n7. Template includes ECM tracking\n8. skill-creator writes SKILL.md, implementation.py, tests\n9. skill-creator returns success\n\nGenerated Files:\n.vibe\u002Fskills\u002Famx-powered-tool\u002F\n├── SKILL.md              # With AMX\u002FECM documentation\n├── __init__.py           # Package init\n├── amx_tool.py           # With AMX_REQUIRED_FIELDS\n└── tests\u002F\n    └── test_amx_tool.py   # With AMX validation tests\n\nImplementation includes:\n- AMX_MEMORY_REQUIRED_FIELDS constant\n- validate_amx() method\n- _track_ecm_store() method\n- _track_ecm_retrieve() method\n- SQLite storage with AMX schema\n```\n\n## Verification and Testing\n\n### Unit Tests\n\n```python\nimport unittest\nfrom skills.engram_memory.engram_mcp import EngramMemory\n\nclass TestAMXECMIntegration(unittest.TestCase):\n    \"\"\"Test AMX\u002FECM integration.\"\"\"\n    \n    def setUp(self):\n        self.engram = EngramMemory(\n            db_path=\":memory:\",\n            ecm_state_path=\":memory:\"\n        )\n    \n    def test_amx_validation(self):\n        \"\"\"Test AMX validation.\"\"\"\n        # Test with all fields\n        memory = {\n            \"schema_version\": \"amx-memory-v1\",\n            \"origin\": \"test\",\n            \"logical_identity\": \"test-001\",\n            \"repository_scope\": {},\n            \"provenance\": [],\n            \"causal_ancestry\": [],\n            \"trust_validity_state\": {},\n            \"visibility\": {},\n            \"purpose\": {},\n            \"retraction_deletion_barriers\": {},\n            \"canonical_semantic_digest\": \"\"\n        }\n        result = self.engram.validate_amx(memory)\n        self.assertTrue(result[\"valid\"])\n        \n        # Test with missing fields\n        incomplete = {\"logical_identity\": \"test-002\"}\n        result = self.engram.validate_amx(incomplete)\n        self.assertFalse(result[\"valid\"])\n        self.assertIn(\"schema_version\", result[\"missing_fields\"])\n    \n    def test_ecm_tracking(self):\n        \"\"\"Test ECM tracking.\"\"\"\n        memory = {\n            \"logical_identity\": \"test-003\",\n            \"content\": \"test\"\n        }\n        # Auto-populate AMX fields\n        self.engram.validate_amx(memory)\n        \n        # Store (triggers ECM tracking)\n        self.engram.store(memory)\n        \n        # Check ECM state\n        task_id = f\"memory:test-003:store\"\n        self.assertIn(task_id, self.engram.ecm_state[\"tasks\"])\n        \n        attempt_id = f\"{task_id}:attempt:1\"\n        self.assertIn(attempt_id, self.engram.ecm_state[\"attempts\"])\n    \n    def test_store_and_retrieve(self):\n        \"\"\"Test store and retrieve.\"\"\"\n        memory = {\n            \"logical_identity\": \"test-004\",\n            \"content\": \"Hello World\",\n            \"memory_type\": \"note\"\n        }\n        \n        # Store\n        logical_id = self.engram.store(memory)\n        self.assertEqual(logical_id, \"test-004\")\n        \n        # Retrieve\n        retrieved = self.engram.retrieve(logical_id)\n        self.assertIsNotNone(retrieved)\n        self.assertEqual(retrieved[\"logical_identity\"], logical_id)\n        self.assertEqual(retrieved[\"content\"], \"Hello World\")\n        self.assertIn(\"canonical_semantic_digest\", retrieved)\n```\n\n### Integration Tests\n\n```python\nclass TestAMXECMIntegration(unittest.TestCase):\n    \"\"\"Integration tests for AMX\u002FECM\u002FVibe.\"\"\"\n    \n    def test_end_to_end_flow(self):\n        \"\"\"Test complete flow from user request to stored memory.\"\"\"\n        # Simulate user request\n        user_memory = {\n            \"content\": \"Test content\",\n            \"memory_type\": \"user_note\"\n        }\n        \n        # Process through Vibe\n        skill = AMXECMSkill()\n        logical_id = skill.create_session_memory(user_memory)\n        \n        # Verify AMX compliance\n        memory = skill.memory_client.retrieve(logical_id)\n        self.assertTrue(skill.memory_client.validate_amx(memory)[\"valid\"])\n        \n        # Verify ECM tracking\n        ecm_task = skill.ecm_client.get_task(logical_id)\n        self.assertIsNotNone(ecm_task)\n        self.assertEqual(ecm_task[\"status\"], \"completed\")\n        \n        # Verify binding\n        binding = skill.ecm_client.get_memory_binding(logical_id)\n        self.assertIsNotNone(binding)\n        self.assertEqual(binding[\"memory_logical_identity\"], logical_id)\n```\n\n## Performance Considerations\n\n### Optimization Strategies\n\n1. **Connection Pooling:**\n```python\n# Use connection pool for SQLite\nfrom sqlite3 import Connection\nfrom threading import local\n\nconnection_pool = local()\n\ndef get_connection(db_path: str) -> Connection:\n    if not hasattr(connection_pool, 'connection'):\n        connection_pool.connection = sqlite3.connect(db_path)\n        connection_pool.connection.row_factory = sqlite3.Row\n    return connection_pool.connection\n```\n\n2. **Batch Operations:**\n```python\ndef batch_store(self, memories: List[Dict[str, Any]]) -> List[str]:\n    \"\"\"Store multiple memories in a batch.\"\"\"\n    logical_ids = []\n    \n    with sqlite3.connect(self.db_path) as conn:\n        conn.row_factory = sqlite3.Row\n        cursor = conn.cursor()\n        \n        for memory in memories:\n            # Validate\n            self.validate_amx(memory)\n            \n            # Track ECM\n            ecm_task_id = self._track_ecm_store(memory)\n            \n            # Store\n            cursor.execute(\n                \"INSERT OR REPLACE INTO memories VALUES (...)\",\n                (...)  # Parameters\n            )\n            logical_ids.append(memory[\"logical_identity\"])\n        \n        conn.commit()\n    \n    return logical_ids\n```\n\n3. **Caching:**\n```python\nfrom functools import lru_cache\n\n@lru_cache(maxsize=1000)\ndef retrieve_cached(self, logical_identity: str) -> Optional[Dict[str, Any]]:\n    \"\"\"Retrieve memory with caching.\"\"\"\n    return self._retrieve_from_db(logical_identity)\n```\n\n## Security Considerations\n\n### Permission Boundaries\n\n```python\nclass PermissionGuard:\n    \"\"\"Enforce permission boundaries.\"\"\"\n    \n    ALLOWED_TOOLS = [\"read_file\", \"write_file\", \"edit\", \"grep\", \"bash\"]\n    DENIED_PATHS = [\"\u002Fetc\", \"\u002Froot\", \"\u002Fhome\"]\n    \n    @staticmethod\n    def check_tool(tool_name: str) -> bool:\n        \"\"\"Check if tool is allowed.\"\"\"\n        return tool_name in PermissionGuard.ALLOWED_TOOLS\n    \n    @staticmethod\n    def check_path(path: str) -> bool:\n        \"\"\"Check if path is allowed.\"\"\"\n        for denied in PermissionGuard.DENIED_PATHS:\n            if path.startswith(denied):\n                return False\n        return True\n    \n    @staticmethod\n    def guard_tool_call(tool_name: str, **kwargs) -> Any:\n        \"\"\"Guarded tool call.\"\"\"\n        if not PermissionGuard.check_tool(tool_name):\n            raise PermissionError(f\"Tool not allowed: {tool_name}\")\n        \n        # Check path parameters\n        for key, value in kwargs.items():\n            if key.endswith(\"_path\") and isinstance(value, str):\n                if not PermissionGuard.check_path(value):\n                    raise PermissionError(f\"Path not allowed: {value}\")\n        \n        # Call tool\n        return getattr(tools, tool_name)(**kwargs)\n```\n\n### Input Validation\n\n```python\ndef validate_memory_input(memory: Dict[str, Any]) -> None:\n    \"\"\"Validate memory input.\"\"\"\n    if not isinstance(memory, dict):\n        raise ValueError(\"Memory must be a dictionary\")\n    \n    if \"logical_identity\" in memory:\n        if not isinstance(memory[\"logical_identity\"], str):\n            raise ValueError(\"logical_identity must be a string\")\n        if len(memory[\"logical_identity\"]) > 256:\n            raise ValueError(\"logical_identity too long (max 256 chars)\")\n    \n    if \"provenance\" in memory:\n        if not isinstance(memory[\"provenance\"], list):\n            raise ValueError(\"provenance must be a list\")\n        for entry in memory[\"provenance\"]:\n            if not isinstance(entry, dict):\n                raise ValueError(\"provenance entries must be dictionaries\")\n    \n    if \"content\" in memory:\n        if not isinstance(memory[\"content\"], (str, dict, list)):\n            raise ValueError(\"content must be string, dict, or list\")\n```\n\n## References\n\n- [AMX Specification](AMX-v1.1.md) - Canonical portable memory format\n- [ECM Specification](ECM-v1.1.md) - Collaboration history tracking\n- [MCP Specification](https:\u002F\u002Fgithub.com\u002Fmodelcontextprotocol\u002Fspec) - Model Context Protocol\n- [Vibe Documentation](https:\u002F\u002Fgithub.com\u002Fmistralai\u002Fvibe) - Vibe agent runtime\n- [AutoDev AGENTS.md](\u002Fdata\u002Fdata\u002Fcom.termux\u002Ffiles\u002Fhome\u002FAutoDev\u002FAGENTS.md) - Project constraints\n- [Engram MCP Integration Plan](docs\u002Fsuperpowers\u002Fplans\u002F2026-08-21-engram-mcp-integration.md) - Implementation details\n","# AMX\u002FECM\u002FVibe End-to-End Integration Guide\n\n**Purpose:** Complete architecture mapping and integration patterns for AMX memory, ECM collaboration tracking, MCP servers, and Vibe skills within AutoDev constraints.\n\n## Architecture Overview\n\n```\n┌─────────────────────────────────────────────────────────────────┐\n│                        Vibe Agent Runtime                         │\n├─────────────────────────────────────────────────────────────────┤\n│                                                                  │\n│  ┌──────────────┐    ┌──────────────┐    ┌──────────────────┐  │\n│  │   User       │    │   Skills     │    │    MCP Servers    │  │\n│  │   Request    │───▶│   System     │───▶│    (External)     │  │\n│  └──────────────┘    └──────────────┘    └──────────────────┘  │\n│           │                  │                     │             │\n│           └──────────────────┴─────────────────────┘             │\n│                              │                                     │\n│                    ┌─────────┴─────────┐                          │\n│                    │   Tool Registry    │                          │\n│                    └─────────┬─────────┘                          │\n│                              │                                     │\n│         ┌────────────────────┼────────────────────┐              │\n│         │                    │                    │              │\n│   ┌─────▼─────┐      ┌─────▼─────┐        ┌─────▼─────┐        │\n│   │ AMX Memory│      │ ECM State │        │ Engram MCP │        │\n│   │ Component │      │ Component │        │  Server    │        │\n│   └─────┬─────┘      └─────┬─────┘        └─────┬─────┘        │\n│         │                    │                    │              │\n│   ┌─────▼─────┐      ┌─────▼─────┐        ┌─────▼─────┐        │\n│   │ SQLite    │      │ JSON      │        │ HTTP      │        │\n│   │ Storage   │      │ Storage   │        │ Interface │        │\n│   └───────────┘      └───────────┘        └───────────┘        │\n│                                                                  │\n└─────────────────────────────────────────────────────────────────┘\n```\n\n## Component Breakdown\n\n### 1. AMX (Agent Memory eXchange) v1.1\n\n**Purpose:** Canonical portable memory format for AI agents.\n\n**Required Fields (11 total):**\n```python\nAMX_MEMORY_REQUIRED_FIELDS = {\n    \"schema_version\",           # Always \"amx-memory-v1\"\n    \"origin\",                  # Source identifier\n    \"logical_identity\",        # Unique memory ID\n    \"repository_scope\",        # Repository\u002Fworktree\u002Fproject scope\n    \"provenance\",              # List of provenance entries\n    \"causal_ancestry\",         # List of ancestor references\n    \"trust_validity_state\",    # Trust\u002Fvalidity metadata\n    \"visibility\",              # Access control scope\n    \"purpose\",                 # Intended use metadata\n    \"retraction_deletion_barriers\",  # Deletion controls\n    \"canonical_semantic_digest\"    # SHA-256 hash\n}\n```\n\n**Field Specifications:**\n\n| Field | Type | Required | Default | Description |\n|-------|------|----------|---------|-------------|\n| schema_version | string | Yes | \"amx-memory-v1\" | Schema version identifier |\n| origin | string | Yes | None | Source of the memory |\n| logical_identity | string | Yes | None | Unique identifier |\n| repository_scope | dict | Yes | {} | Repository\u002Fworktree\u002Fproject scope |\n| provenance | list | Yes | [] | Causal history entries |\n| causal_ancestry | list | Yes | [] | Ancestry chain references |\n| trust_validity_state | dict | Yes | See below | Trust and validity metadata |\n| visibility | dict | Yes | {\"scope\": \"workspace\", \"access_level\": \"read\"} | Access control |\n| purpose | dict | Yes | {\"primary\": \"memory\", \"task_class\": \"memory:amx\"} | Intended use |\n| retraction_deletion_barriers | dict | Yes | See below | Deletion controls |\n| canonical_semantic_digest | string | Yes | Computed | SHA-256 hash |\n\n**trust_validity_state defaults:**\n```python\n{\n    \"trust_level\": \"medium\",\n    \"validity_status\": \"unverified\",\n    \"last_validated\": \"\u003CISO-8601 timestamp>\"\n}\n```\n\n**retraction_deletion_barriers defaults:**\n```python\n{\n    \"can_retract\": False,\n    \"can_delete\": False,\n    \"retention_period\": \"infinite\"\n}\n```\n\n**Provenance Entry Structure:**\n```python\n{\n    \"source\": \"skill-name\",\n    \"timestamp\": \"2026-08-21T00:00:00Z\",\n    \"checksum\": \"sha256:...\",\n    \"description\": \"Operation description\"\n}\n```\n\n### 2. ECM (Entity-Collaboration Model)\n\n**Purpose:** Track collaboration history and coordination state.\n\n**Tracked Entity Types (9 total):**\n```python\nECM_ENTITY_TYPES = {\n    \"task\",              # Collaboration task\n    \"attempt\",           # Task attempt\n    \"role\",              # Role assignment\n    \"role_lease\",        # Role lease (time-bound)\n    \"message\",           # Communication message\n    \"artifact_reference\", # Artifact reference\n    \"evidence_reference\", # Evidence reference\n    \"memory_binding\",    # Memory to ECM binding\n    \"ContextView\"        # Context view state\n}\n```\n\n**ECM State Structure:**\n```json\n{\n  \"tasks\": {\n    \"\u003Ctask-id>\": {\n      \"id\": \"\u003Ctask-id>\",\n      \"description\": \"\u003Cdescription>\",\n      \"type\": \"\u003Ctype>\",\n      \"status\": \"\u003Ccreated\u002Fcompleted\u002Ffailed>\",\n      \"created_at\": \"\u003CISO-8601>\",\n      \"completed_at\": \"\u003CISO-8601>\",\n      \"memory_logical_identity\": \"\u003Cmemory-id>\",\n      \"origin\": \"\u003Corigin>\"\n    }\n  },\n  \"attempts\": {\n    \"\u003Cattempt-id>\": {\n      \"id\": \"\u003Cattempt-id>\",\n      \"task_id\": \"\u003Ctask-id>\",\n      \"status\": \"\u003Ccreated\u002Fcompleted\u002Ffailed>\",\n      \"started_at\": \"\u003CISO-8601>\",\n      \"completed_at\": \"\u003CISO-8601>\",\n      \"result\": \"\u003Cresult>\"\n    }\n  },\n  \"roles\": {\n    \"\u003Crole-id>\": {\n      \"id\": \"\u003Crole-id>\",\n      \"name\": \"\u003Cname>\",\n      \"capabilities\": [\"\u003Ccapability>\"],\n      \"assigned_at\": \"\u003CISO-8601>\"\n    }\n  },\n  \"role_leases\": {\n    \"\u003Clease-id>\": {\n      \"id\": \"\u003Clease-id>\",\n      \"role_id\": \"\u003Crole-id>\",\n      \"assigned_to\": \"\u003Cassignee>\",\n      \"expires_at\": \"\u003CISO-8601>\",\n      \"granted_at\": \"\u003CISO-8601>\"\n    }\n  },\n  \"messages\": {\n    \"\u003Cmessage-id>\": {\n      \"id\": \"\u003Cmessage-id>\",\n      \"task_id\": \"\u003Ctask-id>\",\n      \"sender\": \"\u003Csender>\",\n      \"content\": \"\u003Ccontent>\",\n      \"timestamp\": \"\u003CISO-8601>\"\n    }\n  },\n  \"artifact_references\": {\n    \"\u003Cartifact-id>\": {\n      \"id\": \"\u003Cartifact-id>\",\n      \"checksum\": \"\u003Chash>\",\n      \"type\": \"\u003Ctype>\",\n      \"logical_identity\": \"\u003Cmemory-id>\",\n      \"created_at\": \"\u003CISO-8601>\"\n    }\n  },\n  \"evidence_references\": {\n    \"\u003Cevidence-id>\": {\n      \"id\": \"\u003Cevidence-id>\",\n      \"check_name\": \"\u003Ccheck>\",\n      \"passed\": true\u002Ffalse,\n      \"details\": \"\u003Cdetails>\",\n      \"timestamp\": \"\u003CISO-8601>\",\n      \"memory_logical_identity\": \"\u003Cmemory-id>\"\n    }\n  },\n  \"memory_bindings\": {\n    \"\u003Cbinding-id>\": {\n      \"id\": \"\u003Cbinding-id>\",\n      \"memory_logical_identity\": \"\u003Cmemory-id>\",\n      \"ecm_task_id\": \"\u003Ctask-id>\",\n      \"ecm_attempt_id\": \"\u003Cattempt-id>\",\n      \"artifact_id\": \"\u003Cartifact-id>\",\n      \"created_at\": \"\u003CISO-8601>\"\n    }\n  },\n  \"context_views\": {\n    \"\u003Cview-id>\": {\n      \"id\": \"\u003Cview-id>\",\n      \"memory_ids\": [\"\u003Cmemory-id>\"],\n      \"created_at\": \"\u003CISO-8601>\",\n      \"updated_at\": \"\u003CISO-8601>\"\n    }\n  }\n}\n```\n\n### 3. MCP (Model Context Protocol)\n\n**Purpose:** Standard protocol for AI agents to access external resources.\n\n**MCP Server Types in AutoDev:**\n```\n1. Engram MCP Server\n   - SQLite storage\n   - AMX-compliant memory\n   - ECM tracking\n   - HTTP interface\n\n2. GitHub App MCP\n   - GitHub API integration\n   - Repository access\n   - Issue\u002FPR management\n\n3. Linear MCP\n   - Linear API integration\n   - Issue tracking\n   - Project management\n```\n\n**MCP HTTP Endpoints (Engram):**\n```\nGET  \u002Fmemory\u002Flist              # List all memories\nGET  \u002Fmemory\u002F{id}              # Retrieve specific memory\nGET  \u002Fmemory\u002Fsearch            # Search memories (type, limit)\nPOST \u002Fmemory\u002Fstore            # Store new memory\nGET  \u002Fmemory\u002Fvalidate          # Validate AMX compliance\nGET  \u002Fecm\u002Fmemory\u002F{id}\u002Ftask    # Get ECM task\nGET  \u002Fecm\u002Fmemory\u002F{id}\u002Fattempts # Get ECM attempts\nGET  \u002Fecm\u002Fmemory\u002F{id}\u002Fbinding  # Get ECM binding\nGET  \u002Fecm\u002Fmemory\u002F{id}\u002Fevidence # Get ECM evidence\n```\n\n### 4. Vibe Skills System\n\n**Skill Discovery Order:**\n1. `skill_paths` from config.toml\n2. `.vibe\u002Fskills\u002F` (project)\n3. `.agents\u002Fskills\u002F` (project)\n4. `~\u002F.vibe\u002Fskills\u002F` (user)\n5. `~\u002F.agents\u002Fskills\u002F` (user)\n\n**Skill Types in AutoDev:**\n```python\nclass SkillType(Enum):\n    AMX_MEMORY = \"amx-memory\"        # AMX memory skills\n    ECM = \"ecm\"                      # ECM tracking skills\n    EVIDENCE = \"evidence\"            # Evidence\u002Fverification skills\n    HOST_ADAPTER = \"host-adapter\"    # Vibe tool extensions\n    MCP_SERVER = \"mcp-server\"        # MCP server skills\n    ENGRAM_MCP = \"engram-mcp\"        # Engram MCP skills\n    GENERAL = \"general\"              # General purpose skills\n```\n\n## Integration Patterns\n\n### Pattern 1: AMX + ECM in Engram MCP\n\n```python\nclass EngramMCPServer:\n    \"\"\"Engram MCP Server with AMX compliance and ECM tracking.\"\"\"\n    \n    def __init__(self):\n        # AMX compliance\n        self.AMX_REQUIRED_FIELDS = {...}\n        \n        # ECM state\n        self.ecm_state = {\n            \"tasks\": {},\n            \"attempts\": {},\n            \"roles\": {},\n            # ... all ECM entity types\n        }\n        \n        # Database\n        self.db_path = \".vibe\u002Fengram-memory\u002Fmemory.db\"\n        self.ecm_state_path = \".vibe\u002Fengram-memory\u002Fecm-state.json\"\n    \n    def store_memory(self, memory: Dict[str, Any]) -> str:\n        \"\"\"Store memory with AMX compliance and ECM tracking.\"\"\"\n        \n        # 1. Validate AMX compliance\n        validation = self.validate_amx(memory)\n        if not validation[\"valid\"]:\n            raise ValueError(validation[\"message\"])\n        \n        # 2. Auto-populate missing AMX fields\n        memory = self._auto_populate_amx(memory)\n        \n        # 3. Compute canonical digest\n        memory[\"canonical_semantic_digest\"] = self.compute_digest(memory)\n        \n        # 4. Track in ECM\n        ecm_task_id = self._track_ecm_store(memory)\n        \n        # 5. Store in database\n        return self._store_in_db(memory, ecm_task_id)\n    \n    def validate_amx(self, memory: Dict[str, Any]) -> Dict[str, Any]:\n        \"\"\"Validate memory against AMX v1.1 schema.\"\"\"\n        missing = self.AMX_REQUIRED_FIELDS - set(memory.keys())\n        \n        # Auto-populate defaults\n        for field, default in AMX_DEFAULTS.items():\n            if field in missing:\n                memory[field] = default\n                missing.discard(field)\n        \n        # Type validation\n        if not isinstance(memory.get(\"provenance\"), list):\n            return {\"valid\": False, \"message\": \"provenance must be a list\"}\n        \n        if not isinstance(memory.get(\"causal_ancestry\"), list):\n            return {\"valid\": False, \"message\": \"causal_ancestry must be a list\"}\n        \n        return {\n            \"valid\": len(missing) == 0,\n            \"missing_fields\": sorted(list(missing)),\n            \"message\": \"AMX v1.1 compliant\" if not missing else \n                       f\"Missing fields: {', '.join(sorted(missing))}\"\n        }\n    \n    def _track_ecm_store(self, memory: Dict[str, Any]) -> str:\n        \"\"\"Create ECM records for store operation.\"\"\"\n        timestamp = datetime.now(timezone.utc).isoformat()\n        task_id = f\"memory:{memory['logical_identity']}:store\"\n        \n        # Create task\n        self.ecm_state[\"tasks\"][task_id] = {\n            \"id\": task_id,\n            \"description\": f\"Store AMX memory {memory['logical_identity']}\",\n            \"type\": \"memory:store\",\n            \"status\": \"completed\",\n            \"created_at\": timestamp,\n            \"completed_at\": timestamp,\n            \"memory_logical_identity\": memory[\"logical_identity\"],\n            \"origin\": memory.get(\"origin\", \"engram-mcp\")\n        }\n        \n        # Create attempt\n        attempt_id = f\"{task_id}:attempt:1\"\n        self.ecm_state[\"attempts\"][attempt_id] = {\n            \"id\": attempt_id,\n            \"task_id\": task_id,\n            \"status\": \"completed\",\n            \"started_at\": timestamp,\n            \"completed_at\": timestamp,\n            \"result\": \"stored\"\n        }\n        \n        # Create role\n        role_id = \"memory:amx\"\n        if role_id not in self.ecm_state[\"roles\"]:\n            self.ecm_state[\"roles\"][role_id] = {\n                \"id\": role_id,\n                \"name\": \"AMX Memory Manager\",\n                \"capabilities\": [\"memory:store\", \"memory:retrieve\", \"memory:validate\"],\n                \"assigned_at\": timestamp\n            }\n        \n        # Create artifact reference\n        artifact_id = f\"artifact:memory:{memory['logical_identity']}\"\n        self.ecm_state[\"artifact_references\"][artifact_id] = {\n            \"id\": artifact_id,\n            \"checksum\": memory.get(\"canonical_semantic_digest\", \"\"),\n            \"type\": \"memory\",\n            \"logical_identity\": memory[\"logical_identity\"],\n            \"created_at\": timestamp\n        }\n        \n        # Create memory binding\n        binding_id = f\"binding:memory:{memory['logical_identity']}:ecm:task:{task_id}\"\n        self.ecm_state[\"memory_bindings\"][binding_id] = {\n            \"id\": binding_id,\n            \"memory_logical_identity\": memory[\"logical_identity\"],\n            \"ecm_task_id\": task_id,\n            \"ecm_attempt_id\": attempt_id,\n            \"artifact_id\": artifact_id,\n            \"created_at\": timestamp\n        }\n        \n        # Create evidence reference\n        evidence_id = f\"evidence:amx:memory:{memory['logical_identity']}:store\"\n        validation_result = self.validate_amx(memory)\n        self.ecm_state[\"evidence_references\"][evidence_id] = {\n            \"id\": evidence_id,\n            \"check_name\": \"amx_compliance\",\n            \"passed\": validation_result[\"valid\"],\n            \"details\": validation_result[\"message\"],\n            \"timestamp\": timestamp,\n            \"memory_logical_identity\": memory[\"logical_identity\"]\n        }\n        \n        self._save_ecm_state()\n        return task_id\n```\n\n### Pattern 2: MCP Server with AMX\u002FECM\n\n```python\nclass AMXECMMCPServer(MCPServer):\n    \"\"\"MCP Server with full AMX\u002FECM integration.\"\"\"\n    \n    def __init__(self):\n        super().__init__()\n        self.memory_store = EngramMCPServer()\n    \n    def handle_resource_read(self, uri: str) -> Dict[str, Any]:\n        \"\"\"Handle MCP resource read requests.\"\"\"\n        if uri.startswith(\"memory:\u002F\u002F\"):\n            # Extract logical identity from URI\n            logical_id = uri.replace(\"memory:\u002F\u002F\", \"\")\n            memory = self.memory_store.retrieve(logical_id)\n            \n            # Track ECM retrieve operation\n            self.memory_store._track_ecm_retrieve(logical_id)\n            \n            return {\"memory\": memory}\n        \n        elif uri.startswith(\"ecm:\u002F\u002F\"):\n            # Handle ECM resource\n            parts = uri.split(\"\u002F\")\n            entity_type = parts[2]  # memory, task, attempt, etc.\n            entity_id = parts[3]\n            \n            if entity_type == \"memory\":\n                ecm_data = self._get_ecm_for_memory(entity_id)\n                return {\"ecm\": ecm_data}\n        \n        raise ValueError(f\"Unknown resource URI: {uri}\")\n    \n    def handle_resource_list(self, uri_prefix: str) -> List[str]:\n        \"\"\"Handle MCP resource list requests.\"\"\"\n        if uri_prefix == \"memory:\u002F\u002F\":\n            memories = self.memory_store.query(limit=100)\n            return [f\"memory:\u002F\u002F{m['logical_identity']}\" for m in memories]\n        \n        elif uri_prefix == \"ecm:\u002F\u002F\":\n            tasks = list(self.memory_store.ecm_state[\"tasks\"].keys())\n            return [f\"ecm:\u002F\u002Ftask\u002F{task_id}\" for task_id in tasks]\n        \n        return []\n    \n    def handle_tool_call(self, name: str, arguments: Dict[str, Any]) -> Dict[str, Any]:\n        \"\"\"Handle MCP tool calls.\"\"\"\n        if name == \"memory_store\":\n            # Validate AMX\n            validation = self.memory_store.validate_amx(arguments.get(\"memory\", {}))\n            if not validation[\"valid\"]:\n                return {\"error\": validation[\"message\"]}\n            \n            # Store with ECM tracking\n            logical_id = self.memory_store.store(arguments[\"memory\"])\n            return {\"logical_identity\": logical_id, \"status\": \"stored\"}\n        \n        elif name == \"memory_retrieve\":\n            memory = self.memory_store.retrieve(arguments[\"logical_identity\"])\n            return {\"memory\": memory} if memory else {\"error\": \"Not found\"}\n        \n        elif name == \"amx_validate\":\n            validation = self.memory_store.validate_amx(arguments.get(\"memory\", {}))\n            return validation\n        \n        raise ValueError(f\"Unknown tool: {name}\")\n```\n\n### Pattern 3: Vibe Skill with AMX\u002FECM\n\n```python\nclass AMXECMSkill:\n    \"\"\"Vibe skill with AMX memory and ECM tracking.\"\"\"\n    \n    def __init__(self):\n        self.memory_client = AMXMemoryClient()\n        self.ecm_client = ECMClient()\n    \n    def create_session_memory(self, session_data: Dict[str, Any]) -> str:\n        \"\"\"Create AMX-compliant session memory with ECM tracking.\"\"\"\n        # Build AMX memory\n        memory = {\n            \"schema_version\": \"amx-memory-v1\",\n            \"origin\": \"vibe-session\",\n            \"logical_identity\": f\"session:{uuid.uuid4()}\",\n            \"repository_scope\": {\n                \"repository_path\": \"\u002Fdata\u002Fdata\u002Fcom.termux\u002Ffiles\u002Fhome\u002FAutoDev\",\n                \"worktree_id\": \"primary\"\n            },\n            \"provenance\": [{\n                \"source\": \"vibe-skill\",\n                \"timestamp\": datetime.now(timezone.utc).isoformat(),\n                \"description\": \"Session memory creation\"\n            }],\n            \"causal_ancestry\": [],\n            \"trust_validity_state\": {\n                \"trust_level\": \"high\",\n                \"validity_status\": \"valid\",\n                \"last_validated\": datetime.now(timezone.utc).isoformat()\n            },\n            \"visibility\": {\n                \"scope\": \"session\",\n                \"access_level\": \"read_write\"\n            },\n            \"purpose\": {\n                \"primary\": \"session_memory\",\n                \"task_class\": \"memory:session\"\n            },\n            \"retraction_deletion_barriers\": {\n                \"can_retract\": True,\n                \"can_delete\": False,\n                \"retention_period\": \"session\"\n            },\n            \"memory_type\": \"session\",\n            \"content\": session_data\n        }\n        \n        # Store with AMX\u002FECM\n        logical_id = self.memory_client.store(memory)\n        \n        # Track in ECM\n        self.ecm_client.track_session_start(\n            memory_logical_identity=logical_id,\n            session_data=session_data\n        )\n        \n        return logical_id\n    \n    def end_session(self, session_id: str) -> None:\n        \"\"\"End session and update ECM.\"\"\"\n        # Update memory\n        memory = self.memory_client.retrieve(session_id)\n        if memory:\n            memory[\"purpose\"][\"session_status\"] = \"ended\"\n            memory[\"trust_validity_state\"][\"last_validated\"] = datetime.now(timezone.utc).isoformat()\n            self.memory_client.store(memory)\n        \n        # Update ECM\n        self.ecm_client.track_session_end(\n            memory_logical_identity=session_id,\n            status=\"completed\"\n        )\n```\n\n## AutoDev Integration Points\n\n### 1. ForgeCore Trusted Execution\n\n**Constraint:** Only `crates\u002Fforge-core` can perform untrusted I\u002FO.\n\n**Integration Pattern:**\n```python\n# Vibe skill must delegate to ForgeCore for execution\nclass SafeExecutionSkill:\n    \"\"\"Skill that respects ForgeCore boundaries.\"\"\"\n    \n    def __init__(self):\n        self.forge_core = ForgeCoreAdapter()\n    \n    def execute_workflow(self, workflow: Dict[str, Any]) -> Dict[str, Any]:\n        \"\"\"Execute workflow through ForgeCore.\"\"\"\n        # Create authorization grant\n        grant = AuthorizationGrant(\n            workspace=\"\u002Fdata\u002Fdata\u002Fcom.termux\u002Ffiles\u002Fhome\u002FAutoDev\",\n            permissions=[\"read\", \"write\"],\n            scope=[\"crates\u002Fforge-core\"]\n        )\n        \n        # Delegate to ForgeCore\n        result = self.forge_core.execute(workflow, grant)\n        \n        # Store result as AMX memory\n        memory = self._create_result_memory(workflow, result)\n        self.memory_client.store(memory)\n        \n        return result\n```\n\n### 2. Harness Drift Checking\n\n**Integration with `scripts\u002Fcheck_harness_drift.py`:**\n```python\nclass HarnessDriftChecker:\n    \"\"\"Check AMX\u002FECM compliance in harness drift checks.\"\"\"\n    \n    def check_amx_compliance(self, file_path: str) -> List[Dict[str, Any]]:\n        \"\"\"Check AMX compliance in a file.\"\"\"\n        issues = []\n        \n        # Read file\n        content = read_file(file_path)\n        \n        # Check for AMX memory records\n        memories = self._extract_amx_memories(content)\n        \n        for memory in memories:\n            # Validate AMX\n            validation = self.memory_client.validate_amx(memory)\n            if not validation[\"valid\"]:\n                issues.append({\n                    \"file\": file_path,\n                    \"type\": \"amx_compliance\",\n                    \"severity\": \"error\",\n                    \"message\": validation[\"message\"],\n                    \"missing_fields\": validation.get(\"missing_fields\", [])\n                })\n        \n        return issues\n    \n    def check_ecm_tracking(self, directory: str) -> List[Dict[str, Any]]:\n        \"\"\"Check ECM tracking in a directory.\"\"\"\n        issues = []\n        \n        # Check for ECM state file\n        ecm_file = os.path.join(directory, \".vibe\u002Fengram-memory\u002Fecm-state.json\")\n        if os.path.exists(ecm_file):\n            ecm_state = json.loads(read_file(ecm_file))\n            \n            # Check required ECM entity types\n            required_types = [\"tasks\", \"attempts\", \"memory_bindings\"]\n            for entity_type in required_types:\n                if entity_type not in ecm_state:\n                    issues.append({\n                        \"file\": ecm_file,\n                        \"type\": \"ecm_missing_entity\",\n                        \"severity\": \"warning\",\n                        \"message\": f\"Missing ECM entity type: {entity_type}\"\n                    })\n        \n        return issues\n```\n\n### 3. CI Integration\n\n**Add to `.github\u002Fworkflows\u002Fci.yml`:**\n```yaml\n- name: Check AMX\u002FECM Compliance\n  run: |\n    python -c \"\n    from skills.amx_ecm_integration import AMXECMChecker\n    checker = AMXECMChecker()\n    \n    # Check all Python files for AMX compliance\n    import os\n    for root, dirs, files in os.walk('.'):\n        for file in files:\n            if file.endswith('.py'):\n                path = os.path.join(root, file)\n                issues = checker.check_amx_compliance(path)\n                if issues:\n                    print(f'::error file={path}::AMX compliance issues found')\n                    for issue in issues:\n                        print(f'  - {issue[\\\"message\\\"]}')\n                    exit(1)\n    \n    # Check ECM tracking\n    ecm_issues = checker.check_ecm_tracking('.')\n    if ecm_issues:\n        print('::warning::ECM tracking issues found')\n        for issue in ecm_issues:\n            print(f'  - {issue[\\\"message\\\"]}')\n    \"\n```\n\n## End-to-End Flow Examples\n\n### Example 1: User Request to Skill Action\n\n```\nUser: \"Store this memory: {\\\"content\\\": \\\"Hello\\\", \\\"type\\\": \\\"note\\\"}\"\n\nVibe Flow:\n1. Route to meta-creator skill (user-invocable)\n2. meta-creator recognizes this as AMX memory request\n3. meta-creator delegates to amx-ecm-integration skill\n4. amx-ecm-integration validates AMX fields\n5. amx-ecm-integration auto-populates missing fields\n6. amx-ecm-integration computes canonical digest\n7. amx-ecm-integration tracks in ECM\n8. amx-ecm-integration stores in SQLite\n9. amx-ecm-integration returns logical_identity\n10. meta-creator returns success to user\n\nResult:\n- AMX memory stored with all 11 required fields\n- ECM task, attempt, artifact, binding, evidence all created\n- SQLite database updated\n- ECM state file updated\n- User receives: {\"logical_identity\": \"memory:note:001\", \"status\": \"stored\"}\n```\n\n### Example 2: MCP Client Memory Query\n\n```\nMCP Client Request:\n  Method: GET\n  URI: memory:\u002F\u002Fnote-001\n\nVibe Flow:\n1. MCP server (engram-mcp) receives request\n2. MCP server delegates to EngramMCPServer\n3. EngramMCPServer tracks ECM retrieve operation\n4. EngramMCPServer queries SQLite database\n5. EngramMCPServer converts row to AMX memory dict\n6. EngramMCPServer returns memory to MCP server\n7. MCP server returns to client\n\nResponse:\n{\n  \"memory\": {\n    \"schema_version\": \"amx-memory-v1\",\n    \"origin\": \"engram-mcp\",\n    \"logical_identity\": \"note-001\",\n    \"repository_scope\": {...},\n    \"provenance\": [...],\n    \"causal_ancestry\": [],\n    \"trust_validity_state\": {...},\n    \"visibility\": {...},\n    \"purpose\": {...},\n    \"retraction_deletion_barriers\": {...},\n    \"canonical_semantic_digest\": \"sha256:...\",\n    \"memory_type\": \"note\",\n    \"content\": \"Hello\",\n    \"ecm_task_id\": \"memory:note-001:retrieve\"\n  }\n}\n\nECM State Updated:\n- New task: memory:note-001:retrieve\n- New attempt: memory:note-001:retrieve:attempt:1\n```\n\n### Example 3: Skill Creation with AMX\u002FECM\n\n```\nUser: \"\u002Fskill-creator create amx-powered-tool\"\n\nVibe Flow:\n1. skill-creator skill loaded\n2. skill-creator prompts for skill details\n3. User provides: name, description, purpose\n4. skill-creator generates skill directory\n5. skill-creator uses ENGRAM_MCP_IMPL_TEMPLATE\n6. Template includes AMX validation\n7. Template includes ECM tracking\n8. skill-creator writes SKILL.md, implementation.py, tests\n9. skill-creator returns success\n\nGenerated Files:\n.vibe\u002Fskills\u002Famx-powered-tool\u002F\n├── SKILL.md              # With AMX\u002FECM documentation\n├── __init__.py           # Package init\n├── amx_tool.py           # With AMX_REQUIRED_FIELDS\n└── tests\u002F\n    └── test_amx_tool.py   # With AMX validation tests\n\nImplementation includes:\n- AMX_MEMORY_REQUIRED_FIELDS constant\n- validate_amx() method\n- _track_ecm_store() method\n- _track_ecm_retrieve() method\n- SQLite storage with AMX schema\n```\n\n## Verification and Testing\n\n### Unit Tests\n\n```python\nimport unittest\nfrom skills.engram_memory.engram_mcp import EngramMemory\n\nclass TestAMXECMIntegration(unittest.TestCase):\n    \"\"\"Test AMX\u002FECM integration.\"\"\"\n    \n    def setUp(self):\n        self.engram = EngramMemory(\n            db_path=\":memory:\",\n            ecm_state_path=\":memory:\"\n        )\n    \n    def test_amx_validation(self):\n        \"\"\"Test AMX validation.\"\"\"\n        # Test with all fields\n        memory = {\n            \"schema_version\": \"amx-memory-v1\",\n            \"origin\": \"test\",\n            \"logical_identity\": \"test-001\",\n            \"repository_scope\": {},\n            \"provenance\": [],\n            \"causal_ancestry\": [],\n            \"trust_validity_state\": {},\n            \"visibility\": {},\n            \"purpose\": {},\n            \"retraction_deletion_barriers\": {},\n            \"canonical_semantic_digest\": \"\"\n        }\n        result = self.engram.validate_amx(memory)\n        self.assertTrue(result[\"valid\"])\n        \n        # Test with missing fields\n        incomplete = {\"logical_identity\": \"test-002\"}\n        result = self.engram.validate_amx(incomplete)\n        self.assertFalse(result[\"valid\"])\n        self.assertIn(\"schema_version\", result[\"missing_fields\"])\n    \n    def test_ecm_tracking(self):\n        \"\"\"Test ECM tracking.\"\"\"\n        memory = {\n            \"logical_identity\": \"test-003\",\n            \"content\": \"test\"\n        }\n        # Auto-populate AMX fields\n        self.engram.validate_amx(memory)\n        \n        # Store (triggers ECM tracking)\n        self.engram.store(memory)\n        \n        # Check ECM state\n        task_id = f\"memory:test-003:store\"\n        self.assertIn(task_id, self.engram.ecm_state[\"tasks\"])\n        \n        attempt_id = f\"{task_id}:attempt:1\"\n        self.assertIn(attempt_id, self.engram.ecm_state[\"attempts\"])\n    \n    def test_store_and_retrieve(self):\n        \"\"\"Test store and retrieve.\"\"\"\n        memory = {\n            \"logical_identity\": \"test-004\",\n            \"content\": \"Hello World\",\n            \"memory_type\": \"note\"\n        }\n        \n        # Store\n        logical_id = self.engram.store(memory)\n        self.assertEqual(logical_id, \"test-004\")\n        \n        # Retrieve\n        retrieved = self.engram.retrieve(logical_id)\n        self.assertIsNotNone(retrieved)\n        self.assertEqual(retrieved[\"logical_identity\"], logical_id)\n        self.assertEqual(retrieved[\"content\"], \"Hello World\")\n        self.assertIn(\"canonical_semantic_digest\", retrieved)\n```\n\n### Integration Tests\n\n```python\nclass TestAMXECMIntegration(unittest.TestCase):\n    \"\"\"Integration tests for AMX\u002FECM\u002FVibe.\"\"\"\n    \n    def test_end_to_end_flow(self):\n        \"\"\"Test complete flow from user request to stored memory.\"\"\"\n        # Simulate user request\n        user_memory = {\n            \"content\": \"Test content\",\n            \"memory_type\": \"user_note\"\n        }\n        \n        # Process through Vibe\n        skill = AMXECMSkill()\n        logical_id = skill.create_session_memory(user_memory)\n        \n        # Verify AMX compliance\n        memory = skill.memory_client.retrieve(logical_id)\n        self.assertTrue(skill.memory_client.validate_amx(memory)[\"valid\"])\n        \n        # Verify ECM tracking\n        ecm_task = skill.ecm_client.get_task(logical_id)\n        self.assertIsNotNone(ecm_task)\n        self.assertEqual(ecm_task[\"status\"], \"completed\")\n        \n        # Verify binding\n        binding = skill.ecm_client.get_memory_binding(logical_id)\n        self.assertIsNotNone(binding)\n        self.assertEqual(binding[\"memory_logical_identity\"], logical_id)\n```\n\n## Performance Considerations\n\n### Optimization Strategies\n\n1. **Connection Pooling:**\n```python\n# Use connection pool for SQLite\nfrom sqlite3 import Connection\nfrom threading import local\n\nconnection_pool = local()\n\ndef get_connection(db_path: str) -> Connection:\n    if not hasattr(connection_pool, 'connection'):\n        connection_pool.connection = sqlite3.connect(db_path)\n        connection_pool.connection.row_factory = sqlite3.Row\n    return connection_pool.connection\n```\n\n2. **Batch Operations:**\n```python\ndef batch_store(self, memories: List[Dict[str, Any]]) -> List[str]:\n    \"\"\"Store multiple memories in a batch.\"\"\"\n    logical_ids = []\n    \n    with sqlite3.connect(self.db_path) as conn:\n        conn.row_factory = sqlite3.Row\n        cursor = conn.cursor()\n        \n        for memory in memories:\n            # Validate\n            self.validate_amx(memory)\n            \n            # Track ECM\n            ecm_task_id = self._track_ecm_store(memory)\n            \n            # Store\n            cursor.execute(\n                \"INSERT OR REPLACE INTO memories VALUES (...)\",\n                (...)  # Parameters\n            )\n            logical_ids.append(memory[\"logical_identity\"])\n        \n        conn.commit()\n    \n    return logical_ids\n```\n\n3. **Caching:**\n```python\nfrom functools import lru_cache\n\n@lru_cache(maxsize=1000)\ndef retrieve_cached(self, logical_identity: str) -> Optional[Dict[str, Any]]:\n    \"\"\"Retrieve memory with caching.\"\"\"\n    return self._retrieve_from_db(logical_identity)\n```\n\n## Security Considerations\n\n### Permission Boundaries\n\n```python\nclass PermissionGuard:\n    \"\"\"Enforce permission boundaries.\"\"\"\n    \n    ALLOWED_TOOLS = [\"read_file\", \"write_file\", \"edit\", \"grep\", \"bash\"]\n    DENIED_PATHS = [\"\u002Fetc\", \"\u002Froot\", \"\u002Fhome\"]\n    \n    @staticmethod\n    def check_tool(tool_name: str) -> bool:\n        \"\"\"Check if tool is allowed.\"\"\"\n        return tool_name in PermissionGuard.ALLOWED_TOOLS\n    \n    @staticmethod\n    def check_path(path: str) -> bool:\n        \"\"\"Check if path is allowed.\"\"\"\n        for denied in PermissionGuard.DENIED_PATHS:\n            if path.startswith(denied):\n                return False\n        return True\n    \n    @staticmethod\n    def guard_tool_call(tool_name: str, **kwargs) -> Any:\n        \"\"\"Guarded tool call.\"\"\"\n        if not PermissionGuard.check_tool(tool_name):\n            raise PermissionError(f\"Tool not allowed: {tool_name}\")\n        \n        # Check path parameters\n        for key, value in kwargs.items():\n            if key.endswith(\"_path\") and isinstance(value, str):\n                if not PermissionGuard.check_path(value):\n                    raise PermissionError(f\"Path not allowed: {value}\")\n        \n        # Call tool\n        return getattr(tools, tool_name)(**kwargs)\n```\n\n### Input Validation\n\n```python\ndef validate_memory_input(memory: Dict[str, Any]) -> None:\n    \"\"\"Validate memory input.\"\"\"\n    if not isinstance(memory, dict):\n        raise ValueError(\"Memory must be a dictionary\")\n    \n    if \"logical_identity\" in memory:\n        if not isinstance(memory[\"logical_identity\"], str):\n            raise ValueError(\"logical_identity must be a string\")\n        if len(memory[\"logical_identity\"]) > 256:\n            raise ValueError(\"logical_identity too long (max 256 chars)\")\n    \n    if \"provenance\" in memory:\n        if not isinstance(memory[\"provenance\"], list):\n            raise ValueError(\"provenance must be a list\")\n        for entry in memory[\"provenance\"]:\n            if not isinstance(entry, dict):\n                raise ValueError(\"provenance entries must be dictionaries\")\n    \n    if \"content\" in memory:\n        if not isinstance(memory[\"content\"], (str, dict, list)):\n            raise ValueError(\"content must be string, dict, or list\")\n```\n\n## References\n\n- [AMX Specification](AMX-v1.1.md) - Canonical portable memory format\n- [ECM Specification](ECM-v1.1.md) - Collaboration history tracking\n- [MCP Specification](https:\u002F\u002Fgithub.com\u002Fmodelcontextprotocol\u002Fspec) - Model Context Protocol\n- [Vibe Documentation](https:\u002F\u002Fgithub.com\u002Fmistralai\u002Fvibe) - Vibe agent runtime\n- [AutoDev AGENTS.md](\u002Fdata\u002Fdata\u002Fcom.termux\u002Ffiles\u002Fhome\u002FAutoDev\u002FAGENTS.md) - Project constraints\n- [Engram MCP Integration Plan](docs\u002Fsuperpowers\u002Fplans\u002F2026-08-21-engram-mcp-integration.md) - Implementation details\n",{"name":5,"model":23,"description":24,"user-invocable":25},"mistral-medium-3.5","Load this skill when mapping or integrating AMX memory systems with ECM collaboration tracking and Vibe.\n\nProvides end-to-end architecture mapping for:\n- AMX v1.1 canonical portable memory\n- ECM collaboration state tracking\n- MCP server interfaces\n- Vibe skill integration\n- AutoDev project constraints\n\nUse this when the user needs to understand how AMX, ECM, MCP, and Vibe integrate together.\n",true,"main","1bc4344c530bba46dfb6c32ad56f155b81e19b66",".vibe\u002Fskills\u002Famx-ecm-integration","https:\u002F\u002Fgithub.com\u002Fasshat1981ar\u002FAutoDev","https:\u002F\u002Fgithub.com\u002Fasshat1981ar","2026-11-14 21:51:15",{"source":8,"skillName":5,"commands":33,"prompt":43,"zipAvailable":25},[34,37,40],{"tool":35,"command":36},"npx","npx skills add asshat1981ar\u002FAutoDev --skill amx-ecm-integration",{"tool":38,"command":39},"bunx","bunx skills add asshat1981ar\u002FAutoDev --skill amx-ecm-integration",{"tool":41,"command":42},"pnpm","pnpm dlx skills add asshat1981ar\u002FAutoDev --skill amx-ecm-integration","安装技能，技能地址：https:\u002F\u002Fgithub.com\u002Fasshat1981ar\u002FAutoDev\u002Fblob\u002Fmain\u002F.vibe\u002Fskills\u002Famx-ecm-integration\u002FSKILL.md",[45],{"path":46,"resourceType":47,"resourceTypeDesc":48,"sizeBytes":49,"sourceHtmlUrl":50},"__init__.py","SCRIPT","脚本",219,"https:\u002F\u002Fgithub.com\u002Fasshat1981ar\u002FAutoDev\u002Fblob\u002Fmain\u002F.vibe\u002Fskills\u002Famx-ecm-integration\u002F__init__.py",[52,59,66,73,80,87],{"skillNo":53,"name":54,"nameZh":6,"description":55,"descriptionZh":6,"repositoryFullName":8,"ownerLogin":9,"ownerAvatarUrl":10,"ownerAccountNo":11,"ownerDisplayName":6,"repositoryNo":12,"starsCount":13,"licenseSpdxId":14,"licenseFileUrl":6,"sourceHtmlUrl":56,"categories":57,"keywords":58,"publishedAt":18},"01M7ABVFYJZPZWWBDEEMS25RED","skill-creator","Agentic skill creation and management for Vibe\u002FAutoDev.\n\nThis meta-skill provides:\n- Skill definition templates (AMX-compliant, ECM-aware, Cline-compatible)\n- Validation against AGENTS.md rules and AMCX-1 specifications\n- Worktree-isolated skill development\n- RED-GREEN-REFACTOR test scaffolding\n- Integration with AMX Memory and ECM state\n\nUse this skill to create new agentic skills that comply with:\n- AutoDev AGENTS.md boundaries (ForgeCore, Cline fabric purity)\n- AMCX-1 v1.1 AMX\u002FECM requirements\n- Vibe tool permission model\n- Cline Skills\u002FHooks\u002FPlugins architecture","https:\u002F\u002Fgithub.com\u002Fasshat1981ar\u002FAutoDev\u002Fblob\u002Fmain\u002Fskills\u002Fskill_creator\u002FSKILL.md",[],[],{"skillNo":60,"name":61,"nameZh":6,"description":62,"descriptionZh":6,"repositoryFullName":8,"ownerLogin":9,"ownerAvatarUrl":10,"ownerAccountNo":11,"ownerDisplayName":6,"repositoryNo":12,"starsCount":13,"licenseSpdxId":14,"licenseFileUrl":6,"sourceHtmlUrl":63,"categories":64,"keywords":65,"publishedAt":18},"01M7ABVC08W0W62SR59AG6D17Q","engram-memory","Production Engram MCP Server for AI agent persistent memory\n\nEngram MCP Server - Persistent memory for AI agents.\n\nProvides:\n- SQLite-backed persistent memory storage\n- MCP server interface for agent access\n- Semantic search capabilities\n- Knowledge graph support\n- Memory lifecycle management\n\nAMCX-1 Compliance: Implements AMX memory component with MCP interface.","https:\u002F\u002Fgithub.com\u002Fasshat1981ar\u002FAutoDev\u002Fblob\u002Fmain\u002Fskills\u002Fengram_memory\u002FSKILL.md",[],[],{"skillNo":67,"name":68,"nameZh":6,"description":69,"descriptionZh":6,"repositoryFullName":8,"ownerLogin":9,"ownerAvatarUrl":10,"ownerAccountNo":11,"ownerDisplayName":6,"repositoryNo":12,"starsCount":13,"licenseSpdxId":14,"licenseFileUrl":6,"sourceHtmlUrl":70,"categories":71,"keywords":72,"publishedAt":18},"01M7ABV811NXP0R05C99XPA8AK","amx-memory","AMCX-1 v1.1 Agent Memory (AMX) canonical portable memory history implementation.\n\nProvides durable, machine-readable memory storage conforming to AMCX-1 specifications.\nEvery memory retains: origin, logical identity, repository\u002Fworktree\u002Fproject scope,\nprovenance, causal ancestry, trust\u002Fvalidity state, visibility, purpose, retraction\u002Fdeletion\nbarriers, and canonical semantic digest.","https:\u002F\u002Fgithub.com\u002Fasshat1981ar\u002FAutoDev\u002Fblob\u002Fmain\u002Fskills\u002Famx_memory\u002FSKILL.md",[],[],{"skillNo":74,"name":75,"nameZh":6,"description":76,"descriptionZh":6,"repositoryFullName":8,"ownerLogin":9,"ownerAvatarUrl":10,"ownerAccountNo":11,"ownerDisplayName":6,"repositoryNo":12,"starsCount":13,"licenseSpdxId":14,"licenseFileUrl":6,"sourceHtmlUrl":77,"categories":78,"keywords":79,"publishedAt":18},"01M7ABV2BJY8XT8T917VVT38BP","vibe-setup","Load this skill when setting up, configuring, or troubleshooting Vibe in a project.\n\nProvides comprehensive guidance on:\n- Vibe installation and configuration\n- Project setup and initialization\n- Trusted folder and permission management\n- Skill discovery and loading\n- MCP server configuration\n- Integration with AutoDev's AGENTS.md rules\n\nUse this when the user needs help with Vibe environment setup.","https:\u002F\u002Fgithub.com\u002Fasshat1981ar\u002FAutoDev\u002Fblob\u002Fmain\u002F.vibe\u002Fskills\u002Fvibe-setup\u002FSKILL.md",[],[],{"skillNo":81,"name":82,"nameZh":6,"description":83,"descriptionZh":6,"repositoryFullName":8,"ownerLogin":9,"ownerAvatarUrl":10,"ownerAccountNo":11,"ownerDisplayName":6,"repositoryNo":12,"starsCount":13,"licenseSpdxId":14,"licenseFileUrl":6,"sourceHtmlUrl":84,"categories":85,"keywords":86,"publishedAt":18},"01M7ABTSEJVK4MCGDNXWZG81Z6","meta-creator","Load this skill when the user requests guidance on creating new skills, MCP servers, tools, or plugins for Vibe.\n\nThis is a meta-skill that provides comprehensive guidance on the entire lifecycle:\n- Skill creation and structure\n- MCP server implementation\n- Tool and plugin development\n- Vibe system setup and configuration\n- AMX\u002FECM integration patterns\n\nUse this when the user needs architectural guidance rather than direct implementation.","https:\u002F\u002Fgithub.com\u002Fasshat1981ar\u002FAutoDev\u002Fblob\u002Fmain\u002F.vibe\u002Fskills\u002Fmeta-creator\u002FSKILL.md",[],[],{"skillNo":88,"name":89,"nameZh":6,"description":90,"descriptionZh":6,"repositoryFullName":8,"ownerLogin":9,"ownerAvatarUrl":10,"ownerAccountNo":11,"ownerDisplayName":6,"repositoryNo":12,"starsCount":13,"licenseSpdxId":14,"licenseFileUrl":6,"sourceHtmlUrl":91,"categories":92,"keywords":93,"publishedAt":18},"01M7ABTERP1RZY7FPP18FM9KAA","vertical-slice","Implement a smallest end-to-end usable slice.","https:\u002F\u002Fgithub.com\u002Fasshat1981ar\u002FAutoDev\u002Fblob\u002Fmain\u002F.cline\u002Fskills\u002Fvertical-slice\u002FSKILL.md",[],[]]