mapify-cli 3.2.0__tar.gz → 3.3.0__tar.gz

{mapify_cli-3.2.0 → mapify_cli-3.3.0}/.claude/skills/README.md

@@ -54,7 +54,6 @@ MAP: [Shows decision tree and comparison matrix]
 - `map-feature-deep-dive.md` - Full validation workflow (PLANNED)
 - `map-refactor-deep-dive.md` - Dependency analysis (PLANNED)
 - `agent-architecture.md` - How 12 agents orchestrate
-- `playbook-system.md` - Knowledge storage and search
 
 ---
 
@@ -124,7 +123,6 @@ Skills work seamlessly with the prompt improvement system:
         ├── map-debug-deep-dive.md
         ├── map-refactor-deep-dive.md
         ├── agent-architecture.md
-        ├── playbook-system.md
 ```
 
 ---
@@ -154,12 +152,12 @@ Skills work seamlessly with the prompt improvement system:
 
 **Check:**
 1. `skill-rules.json` has correct triggers
-2. `improve-prompt.py` hook is enabled in `settings.hooks.json`
+2. `improve-prompt.py` hook is enabled in `.claude/settings.json`
 3. Hook processes UserPromptSubmit events
 
 **Fix:**
 - Update trigger patterns in `skill-rules.json`
-- Verify hook configuration in `.claude/settings.hooks.json`
+- Verify hook configuration in `.claude/settings.json`
 
 ### Skill content too long
 

{mapify_cli-3.2.0 → mapify_cli-3.3.0}/.gitignore

@@ -27,15 +27,7 @@ wheels/
 data/
 htmlcov/
 
-# ACE Playbook - user-specific data
 .claude/embeddings_cache/
-# LEGACY: playbook.json entries for migration support (ignore old format files)
-.claude/playbook.json
-.claude/playbook.json.backup.*
-# Current format: SQLite database
-.claude/playbook.db
-.claude/playbook.db-shm
-.claude/playbook.db-wal
 .claude/mcp_config.json
 .claude/settings.local.json
 
@@ -66,15 +58,6 @@ docs/claude-code-infrastructure-showcase
 docs/claude-code-subagents
 
 
-# Curator temporary files
-.claude/curator_delta_operations.json
-.claude/curator_integration_report.json
-.claude/curator_operations.json
-.claude/*_integration_report.json
-.claude/apply_*_deltas.py
-.claude/insert_*_bullets.sql
-curator_operations*.json
-curator_final_report.json
 docs/claude-code-prompt-improver
 
 # macOS system files

{mapify_cli-3.2.0 → mapify_cli-3.3.0}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: mapify-cli
-Version: 3.2.0
+Version: 3.3.0
 Summary: MAP Framework installer - Modular Agentic Planner for Claude Code
 Project-URL: Homepage, https://github.com/azalio/map-framework
 Project-URL: Repository, https://github.com/azalio/map-framework.git

{mapify_cli-3.2.0 → mapify_cli-3.3.0}/pyproject.toml

@@ -1,6 +1,6 @@
 [project]
 name = "mapify-cli"
-version = "3.2.0"
+version = "3.3.0"
 description = "MAP Framework installer - Modular Agentic Planner for Claude Code"
 authors = [{ name = "MAP Framework Contributors" }]
 readme = "README.md"

{mapify_cli-3.2.0 → mapify_cli-3.3.0}/src/mapify_cli/__init__.py

@@ -23,7 +23,7 @@ Or install globally:
     mapify check
 """
 
-__version__ = "3.2.0"
+__version__ = "3.3.0"
 
 import copy
 import os
@@ -83,16 +83,13 @@ ssl_context = create_ssl_context()
 # Constants
 MCP_SERVER_CHOICES = {
     "all": "All available MCP servers",
-    "essential": "Essential (claude-reviewer, sequential-thinking)",
-    "docs": "Documentation (context7, deepwiki)",
+    "essential": "Essential (sequential-thinking, deepwiki)",
     "custom": "Select individually",
     "none": "Skip MCP setup",
 }
 
 INDIVIDUAL_MCP_SERVERS = {
-    "claude-reviewer": "Professional code review",
     "sequential-thinking": "Chain-of-thought reasoning",
-    "context7": "Library documentation",
     "deepwiki": "GitHub repository intelligence",
 }
 
@@ -538,7 +535,6 @@ def create_agent_files(project_path: Path, mcp_servers: List[str]) -> None:
             "predictor": create_predictor_content(mcp_servers),
             "evaluator": create_evaluator_content(mcp_servers),
             "reflector": create_reflector_content(mcp_servers),
-            "curator": create_curator_content(mcp_servers),
             "documentation-reviewer": create_documentation_reviewer_content(
                 mcp_servers
             ),
@@ -552,7 +548,7 @@ def create_agent_files(project_path: Path, mcp_servers: List[str]) -> None:
 def create_task_decomposer_content(mcp_servers: List[str]) -> str:
     """Create task-decomposer agent content"""
     mcp_section = ""
-    if any(s in mcp_servers for s in ["sequential-thinking", "deepwiki", "context7"]):
+    if any(s in mcp_servers for s in ["sequential-thinking", "deepwiki"]):
         mcp_section = """
 ## MCP Integration
 
@@ -568,11 +564,6 @@ def create_task_decomposer_content(mcp_servers: List[str]) -> str:
 2. **mcp__deepwiki__ask_question** - Get insights from GitHub repositories
    - Ask: "How does [repo] implement [feature]?"
 """
-        if "context7" in mcp_servers:
-            mcp_section += """
-3. **mcp__context7__get-library-docs** - Get up-to-date library documentation
-   - First use resolve-library-id to find the library
-"""
 
     return f"""---
 name: task-decomposer
@@ -601,20 +592,13 @@ Return a valid JSON document with subtasks, dependencies, and acceptance criteri
 def create_actor_content(mcp_servers: List[str]) -> str:
     """Create actor agent content"""
     mcp_section = ""
-    if any(s in mcp_servers for s in ["context7", "deepwiki"]):
+    if "deepwiki" in mcp_servers:
         mcp_section = """
 # MCP INTEGRATION
 
 **ALWAYS use these MCP tools:**
-"""
-        if "context7" in mcp_servers:
-            mcp_section += """
-1. **mcp__context7__get-library-docs** - Get current library documentation
-   - Essential when using external libraries/frameworks
-"""
-        if "deepwiki" in mcp_servers:
-            mcp_section += """
-2. **mcp__deepwiki__read_wiki_contents** - Study implementation patterns
+
+1. **mcp__deepwiki__read_wiki_contents** - Study implementation patterns
    - Learn from production code examples
 """
 
@@ -684,18 +668,7 @@ Provide implementation with approach, code changes, trade-offs, and testing cons
 
 def create_monitor_content(mcp_servers: List[str]) -> str:
     """Create monitor agent content"""
-    mcp_section = ""
-    if "claude-reviewer" in mcp_servers:
-        mcp_section = """
-# MCP INTEGRATION
-
-**ALWAYS use these MCP tools for comprehensive review:**
-
-1. **mcp__claude-reviewer__request_review** - Get professional AI code review
-   - Use FIRST to get baseline review, then add your analysis
-"""
-
-    return f"""---
+    return """---
 name: monitor
 description: Reviews code for correctness, standards, security, and testability (MAP)
 tools: Read, Grep, Bash, Glob
@@ -705,7 +678,7 @@ model: sonnet
 # IDENTITY
 
 You are a meticulous code reviewer and security expert. Your mission is to catch bugs, vulnerabilities, and violations before code reaches production.
-{mcp_section}
+
 # REVIEW CHECKLIST
 
 Work through: Correctness, Security, Code Quality, Performance, Testability, Maintainability
@@ -752,22 +725,15 @@ Return strictly valid JSON with validation results and specific issues.
 def create_predictor_content(mcp_servers: List[str]) -> str:
     """Create predictor agent content"""
     mcp_section = ""
-    if any(s in mcp_servers for s in ["deepwiki", "context7"]):
+    if "deepwiki" in mcp_servers:
         mcp_section = """
 ## MCP Integration
 
 **ALWAYS use these MCP tools:**
-"""
-        if "deepwiki" in mcp_servers:
-            mcp_section += """
+
 1. **mcp__deepwiki__ask_question** - Check how repos handle similar changes
    - Ask: "What breaks when changing [component]?"
 """
-        if "context7" in mcp_servers:
-            mcp_section += """
-2. **mcp__context7__get-library-docs** - Check library compatibility
-   - Verify API changes against current documentation
-"""
 
     return f"""---
 name: predictor
@@ -827,7 +793,7 @@ def create_reflector_content(mcp_servers: List[str]) -> str:
 
     return f"""---
 name: reflector
-description: Extracts structured lessons from execution attempts (ACE)
+description: Extracts structured lessons from execution attempts
 tools: Read, Grep, Glob
 model: sonnet
 ---
@@ -850,70 +816,24 @@ Return JSON with:
 - key_insight: Main lesson learned
 - success_patterns: What worked well
 - failure_patterns: What went wrong
-- suggested_new_bullets: Playbook entries to add
+- suggested_new_patterns: Pattern entries to add
 - confidence: How reliable this insight is
 """
 
 
-def create_curator_content(mcp_servers: List[str]) -> str:
-    """Create curator agent content"""
-    mcp_section = ""
-
-    return f"""---
-name: curator
-description: Manages structured playbook with incremental updates (ACE)
-tools: Read, Write, Edit
-model: sonnet
----
-
-# IDENTITY
-
-You are a knowledge curator who maintains the ACE playbook by integrating Reflector insights.
-{mcp_section}
-# ROLE
-
-Integrate Reflector insights into playbook using delta operations:
-- ADD: New pattern bullets
-- UPDATE: Increment helpful/harmful counters
-- DEPRECATE: Remove harmful patterns
-
-## Quality Gates
-
-- Content length ≥ 100 characters
-- Code examples for technical patterns
-- Deduplication via semantic similarity
-- Technology-specific (not generic advice)
-
-## Output Format (JSON)
-
-Return JSON with:
-- reasoning: Why these operations improve playbook
-- operations: Array of ADD/UPDATE/DEPRECATE operations
-- deduplication_check: What duplicates were found
-"""
-
-
 # Note: test-generator agent removed
 
 
 def create_documentation_reviewer_content(mcp_servers: List[str]) -> str:
     """Create documentation-reviewer agent content"""
     mcp_section = ""
-    if any(s in mcp_servers for s in ["context7", "deepwiki"]):
+    if "deepwiki" in mcp_servers:
         mcp_section = """
 # MCP INTEGRATION
 
 **ALWAYS use these tools for documentation review:**
-"""
-        if "context7" in mcp_servers:
-            mcp_section += """
-1. **mcp__context7__get-library-docs** - Verify library requirements
-   - Check official docs for installation requirements
-   - Validate version compatibility
-"""
-        if "deepwiki" in mcp_servers:
-            mcp_section += """
-2. **mcp__deepwiki__ask_question** - Compare with similar projects
+
+1. **mcp__deepwiki__ask_question** - Compare with similar projects
    - Ask: "How do other projects handle [integration]?"
    - Learn from successful implementations
 """
@@ -1086,7 +1006,7 @@ Extract and preserve lessons from recent workflow:
 
 $ARGUMENTS
 
-Call Reflector to extract patterns, then Curator to update playbook.
+Call Reflector to extract patterns from recent workflow.
 """,
         }
 
@@ -1269,15 +1189,16 @@ def configure_global_permissions() -> None:
 
 
 def create_or_merge_project_settings_local(project_path: Path) -> None:
-    """Create/merge .claude/settings.local.json with safe project allowlist and hooks.
+    """Create/merge .claude/settings.local.json with safe project allowlist.
 
     Claude Code supports per-project approvals via `.claude/settings.local.json`.
     This file is user-local (should not be committed) and is merged by Claude Code
     with global settings from `~/.claude/settings.json`.
 
-    IMPORTANT: Claude Code only reads hooks from `settings.json` or `settings.local.json`.
-    The separate `settings.hooks.json` file is NOT read by Claude Code. Therefore, this
-    function merges hooks from the template `settings.hooks.json` into `settings.local.json`.
+    IMPORTANT:
+    - Shared, repo-committed hooks MUST be configured in `.claude/settings.json`.
+    - `.claude/settings.local.json` is for user-local approvals/allowlists and should
+      not be used as the primary distribution mechanism for project hooks.
 
     We keep this allowlist intentionally narrow and focused on common safe actions
     for local development workflows.
@@ -1288,8 +1209,6 @@ def create_or_merge_project_settings_local(project_path: Path) -> None:
 
     default_permissions: Dict[str, Any] = {
         "allow": [
-            # Allow all mem0 MCP tools (project-scoped)
-            "mcp__mem0__*",
             # SourceCraft MCP helpers (project-scoped)
             "mcp__sourcecraft__list_pull_request_comments",
             # Common safe Go workflows (project-scoped)
@@ -1313,20 +1232,6 @@ def create_or_merge_project_settings_local(project_path: Path) -> None:
         "ask": [],
     }
 
-    # Load hooks from template settings.hooks.json
-    # Claude Code doesn't read hooks from settings.hooks.json, so we merge them here
-    hooks_config: Dict[str, Any] = {}
-    templates_dir = get_templates_dir()
-    hooks_template_file = templates_dir / "settings.hooks.json"
-    if hooks_template_file.exists():
-        try:
-            hooks_data = json.loads(hooks_template_file.read_text(encoding="utf-8"))
-            hooks_config = hooks_data.get("hooks", {})
-        except (json.JSONDecodeError, OSError) as e:
-            console.print(
-                f"[yellow]Warning:[/yellow] Could not read hooks template: {e}"
-            )
-
     # Load existing settings if present
     if settings_file.exists():
         try:
@@ -1339,6 +1244,14 @@ def create_or_merge_project_settings_local(project_path: Path) -> None:
     else:
         existing_settings = {}
 
+    if isinstance(existing_settings, dict) and existing_settings.get("hooks"):
+        console.print(
+            "[yellow]Warning:[/yellow] .claude/settings.local.json contains hooks. "
+            "Claude Code loads hooks from BOTH .claude/settings.json and .claude/settings.local.json, "
+            "so this can cause duplicate hook executions. "
+            "Move shared hooks to .claude/settings.json and remove the hooks section from settings.local.json."
+        )
+
     existing_settings.setdefault("permissions", {})
     permissions = existing_settings["permissions"]
 
@@ -1351,12 +1264,6 @@ def create_or_merge_project_settings_local(project_path: Path) -> None:
     permissions.setdefault("deny", permissions.get("deny", []))
     permissions.setdefault("ask", permissions.get("ask", []))
 
-    # Replace hooks configuration from template
-    # Always use template hooks to ensure correct $CLAUDE_PROJECT_DIR paths
-    # User customizations should be done by editing the template or post-init
-    if hooks_config:
-        existing_settings["hooks"] = hooks_config
-
     settings_file.write_text(json.dumps(existing_settings, indent=2) + "\n")
 
 
@@ -1371,7 +1278,6 @@ def create_mcp_config(project_path: Path, mcp_servers: List[str]) -> None:
             "predictor": [],
             "evaluator": [],
             "reflector": [],
-            "curator": [],
             "documentation-reviewer": [],
             "debate-arbiter": [],
             "synthesizer": [],
@@ -1389,15 +1295,6 @@ def create_mcp_config(project_path: Path, mcp_servers: List[str]) -> None:
 
     # Add server configurations
     server_configs = {
-        "claude-reviewer": {
-            "enabled": True,
-            "description": "Professional AI code review",
-            "config": {
-                "auto_review": True,
-                "focus_areas": ["security", "performance", "testing"],
-                "severity_threshold": "medium",
-            },
-        },
         "sequential-thinking": {
             "enabled": True,
             "description": "Chain-of-thought reasoning",
@@ -1407,11 +1304,6 @@ def create_mcp_config(project_path: Path, mcp_servers: List[str]) -> None:
                 "hypothesis_verification": True,
             },
         },
-        "context7": {
-            "enabled": True,
-            "description": "Up-to-date library documentation",
-            "config": {"tokens": 5000, "auto_resolve": True, "cache_duration": 3600},
-        },
         "deepwiki": {
             "enabled": True,
             "description": "GitHub repository intelligence",
@@ -1436,15 +1328,6 @@ def create_mcp_config(project_path: Path, mcp_servers: List[str]) -> None:
             if agent in config["agent_mcp_mappings"]:
                 config["agent_mcp_mappings"][agent].append("sequential-thinking")
 
-    if "claude-reviewer" in mcp_servers:
-        for agent in ["monitor", "evaluator", "final-verifier"]:
-            if agent in config["agent_mcp_mappings"]:
-                config["agent_mcp_mappings"][agent].append("claude-reviewer")
-
-    if "context7" in mcp_servers:
-        for agent in config["agent_mcp_mappings"]:
-            config["agent_mcp_mappings"][agent].append("context7")
-
     if "deepwiki" in mcp_servers:
         for agent in config["agent_mcp_mappings"]:
             config["agent_mcp_mappings"][agent].append("deepwiki")
@@ -1474,10 +1357,6 @@ def build_standard_mcp_servers() -> Dict[str, Dict[str, Any]]:
             "command": "npx",
             "args": ["-y", "@modelcontextprotocol/server-sequential-thinking"],
         },
-        "context7": {
-            "type": "http",
-            "url": "https://mcp.context7.com/mcp",
-        },
         "deepwiki": {
             "type": "http",
             "url": "https://mcp.deepwiki.com/mcp",
@@ -1590,7 +1469,7 @@ def create_or_merge_project_mcp_json(
 
     Args:
         project_path: Project root directory
-        mcp_servers: List of MCP server names to configure (e.g., ["context7", "deepwiki"])
+        mcp_servers: List of MCP server names to configure (e.g., ["sequential-thinking", "deepwiki"])
 
     Behavior:
         - If mcp_servers is empty: No file created/modified (early return)
@@ -1904,7 +1783,6 @@ def create_config_files(project_path: Path) -> int:
 
     Copies configuration files:
     - settings.json
-    - settings.hooks.json
     - ralph-loop-config.json
     - workflow-rules.json
 
@@ -1919,7 +1797,6 @@ def create_config_files(project_path: Path) -> int:
 
     config_files = [
         "settings.json",
-        "settings.hooks.json",
         "ralph-loop-config.json",
         "workflow-rules.json",
     ]
@@ -1945,7 +1822,7 @@ def init(
     mcp: str = typer.Option(
         "all",
         "--mcp",
-        help="MCP server installation (default: all). Options: all, essential, docs, none, or comma-separated list (e.g. context7,deepwiki)",
+        help="MCP server installation (default: all). Options: all, essential, none, or comma-separated list (e.g. sequential-thinking,deepwiki)",
     ),
     no_git: bool = typer.Option(
         False, "--no-git", help="Skip git repository initialization"
@@ -1973,7 +1850,7 @@ def init(
         mapify init my-project              # Installs all MCP servers
         mapify init my-project --mcp none   # Skip MCP installation
         mapify init my-project --mcp essential
-        mapify init my-project --mcp "context7,deepwiki"
+        mapify init my-project --mcp "sequential-thinking,deepwiki"
         mapify init .
         mapify init . --force  # Force init in non-empty current directory
         mapify init --debug  # Enable workflow logging
@@ -2071,9 +1948,7 @@ def init(
     if mcp == "all":
         selected_mcp_servers = list(INDIVIDUAL_MCP_SERVERS.keys())
     elif mcp == "essential":
-        selected_mcp_servers = ["claude-reviewer", "sequential-thinking"]
-    elif mcp == "docs":
-        selected_mcp_servers = ["context7", "deepwiki"]
+        selected_mcp_servers = ["sequential-thinking", "deepwiki"]
     elif mcp == "none":
         selected_mcp_servers = []
     else:

{mapify_cli-3.2.0 → mapify_cli-3.3.0}/src/mapify_cli/dependency_graph.py

@@ -327,6 +327,122 @@ class DependencyGraph:
 
         return result
 
+    def compute_waves(self) -> Optional[List[List[str]]]:
+        """
+        Compute execution waves from the dependency DAG using Kahn's algorithm.
+
+        Each wave contains subtasks whose dependencies are all satisfied by
+        prior waves. Within a wave, subtasks can execute in parallel.
+
+        Returns:
+            List of waves (each wave is a list of subtask IDs), or None if
+            cycle detected. Empty graph returns [].
+
+        Performance: O(V+E) where V = nodes, E = edges
+
+        Example:
+            >>> graph = DependencyGraph()
+            >>> graph.add_node(SubtaskNode(id="ST-001", dependencies=[]))
+            >>> graph.add_node(SubtaskNode(id="ST-002", dependencies=["ST-001"]))
+            >>> graph.add_node(SubtaskNode(id="ST-003", dependencies=["ST-001"]))
+            >>> graph.add_node(SubtaskNode(id="ST-004", dependencies=["ST-002", "ST-003"]))
+            >>> graph.compute_waves()
+            [['ST-001'], ['ST-002', 'ST-003'], ['ST-004']]
+        """
+        if not self.nodes:
+            return []
+
+        # Compute in-degree for each node (only count edges to nodes in graph)
+        in_degree: Dict[str, int] = {nid: 0 for nid in self.nodes}
+        for nid, node in self.nodes.items():
+            for dep_id in node.dependencies:
+                if dep_id in self.nodes:
+                    in_degree[nid] += 1
+
+        # Collect initial zero-in-degree nodes as wave 0
+        waves: List[List[str]] = []
+        current_wave = sorted([nid for nid, deg in in_degree.items() if deg == 0])
+
+        processed = 0
+        while current_wave:
+            waves.append(current_wave)
+            processed += len(current_wave)
+            next_wave_set: Set[str] = set()
+
+            for nid in current_wave:
+                # Decrement in-degree for all dependents
+                for dependent_id in self.get_dependents(nid):
+                    in_degree[dependent_id] -= 1
+                    if in_degree[dependent_id] == 0:
+                        next_wave_set.add(dependent_id)
+
+            current_wave = sorted(next_wave_set)
+
+        # If not all nodes processed, there's a cycle
+        if processed != len(self.nodes):
+            return None
+
+        return waves
+
+    def split_wave_by_file_conflicts(
+        self, wave: List[str], affected_files_map: Dict[str, Set[str]]
+    ) -> List[List[str]]:
+        """
+        Split a single wave into sub-waves where no two subtasks share files.
+
+        Uses greedy coloring: each subtask is placed in the first sub-wave
+        that has no file overlap. Subtasks with empty/unknown affected_files
+        are treated as conflicting with all others (placed alone).
+
+        Args:
+            wave: List of subtask IDs in one wave
+            affected_files_map: Dict mapping subtask_id -> set of affected file paths
+
+        Returns:
+            List of sub-waves where no two subtasks in the same sub-wave share files
+
+        Example:
+            >>> graph = DependencyGraph()
+            >>> wave = ["ST-002", "ST-003", "ST-004"]
+            >>> files = {"ST-002": {"a.py"}, "ST-003": {"b.py"}, "ST-004": {"a.py"}}
+            >>> graph.split_wave_by_file_conflicts(wave, files)
+            [['ST-002', 'ST-003'], ['ST-004']]
+        """
+        if len(wave) <= 1:
+            return [wave] if wave else []
+
+        sub_waves: List[List[str]] = []
+        sub_wave_files: List[Set[str]] = []
+
+        for subtask_id in wave:
+            files = affected_files_map.get(subtask_id, set())
+
+            # Empty/unknown files = conflict with everything, place alone
+            if not files:
+                sub_waves.append([subtask_id])
+                sub_wave_files.append(set())  # placeholder
+                continue
+
+            placed = False
+            for i, sw_files in enumerate(sub_wave_files):
+                # Skip sub-waves that contain an "unknown files" subtask
+                # (those have empty sw_files but exist in sub_waves)
+                if not sw_files and sub_waves[i]:
+                    # This sub-wave has a subtask with unknown files
+                    continue
+                # Check for file overlap
+                if not files & sw_files:
+                    sub_waves[i].append(subtask_id)
+                    sub_wave_files[i] |= files
+                    placed = True
+                    break
+
+            if not placed:
+                sub_waves.append([subtask_id])
+                sub_wave_files.append(set(files))
+
+        return sub_waves
+
     def clear(self) -> None:
         """
         Remove all nodes from graph.