mapify-cli 1.0.0__tar.gz → 1.0.3__tar.gz

{mapify_cli-1.0.0 → mapify_cli-1.0.3}/.gitignore

@@ -55,3 +55,5 @@ coverage.json
 
 # Temporary verification files
 mapify_cli_verification_*.json
+
+docs/claude-task-master

{mapify_cli-1.0.0 → mapify_cli-1.0.3}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: mapify-cli
-Version: 1.0.0
+Version: 1.0.3
 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
@@ -40,7 +40,7 @@ Implementation of **Modular Agentic Planner (MAP)** — a cognitive architecture
 - **README** (this file) - Quick start and overview
 - **[INSTALL.md](docs/INSTALL.md)** - Complete installation guide with PATH setup and troubleshooting
 - **[ARCHITECTURE.md](docs/ARCHITECTURE.md)** - Technical deep dive, customization, and MCP integration
-- **[USAGE.md](docs/USAGE.md)** - Practical examples, best practices, and cost optimization
+- **[USAGE.md](docs/USAGE.md)** - Practical examples, best practices, cost optimization, and dependency validation
 
 ## 🚀 Quick Start
 
@@ -92,6 +92,12 @@ mapify --version
 # Initialize in your project
 cd your-project
 mapify init
+
+# Available commands
+mapify --help                     # Show all available commands
+mapify validate graph <file>      # Validate task dependency graphs
+mapify playbook search <query>    # Search playbook patterns
+mapify recitation get-context     # Get current task plan
 ```
 
 **Version Pinning:**
@@ -192,6 +198,7 @@ Built-in learning system that improves with each task:
 - **Reflector** extracts patterns from successes and failures
 - **Curator** maintains structured knowledge base with quality tracking
 - **Semantic search** (optional) finds patterns by meaning, not keywords
+- **Dependency validation** ensures valid task graphs before execution
 - Automatically grows high-quality pattern library
 
 ### Playbook Commands
@@ -205,12 +212,17 @@ mapify playbook search "JWT authentication"
 
 # View high-quality patterns
 mapify playbook sync
+
+# Validate task dependencies with visualization
+python scripts/validate-dependencies.py decomposer-output.json --visualize
 ```
 
 **Optional semantic search**: `pip install -r requirements-semantic.txt` for meaning-based matching. Details in [SEMANTIC_SEARCH_SETUP.md](docs/SEMANTIC_SEARCH_SETUP.md) and [ARCHITECTURE.md](docs/ARCHITECTURE.md#semantic-search).
 
 **Playbook configuration**: See [ARCHITECTURE.md](docs/ARCHITECTURE.md#playbook-configuration) for top_k settings and optimization.
 
+**Dependency validation**: See [USAGE.md](docs/USAGE.md#dependency-validation) for comprehensive guide on validating TaskDecomposer output, including cycle detection, visualization, and CI/CD integration.
+
 ## 💰 Cost Optimization
 
 MAP Framework uses intelligent model selection per agent:

{mapify_cli-1.0.0 → mapify_cli-1.0.3}/README.md

@@ -10,7 +10,7 @@ Implementation of **Modular Agentic Planner (MAP)** — a cognitive architecture
 - **README** (this file) - Quick start and overview
 - **[INSTALL.md](docs/INSTALL.md)** - Complete installation guide with PATH setup and troubleshooting
 - **[ARCHITECTURE.md](docs/ARCHITECTURE.md)** - Technical deep dive, customization, and MCP integration
-- **[USAGE.md](docs/USAGE.md)** - Practical examples, best practices, and cost optimization
+- **[USAGE.md](docs/USAGE.md)** - Practical examples, best practices, cost optimization, and dependency validation
 
 ## 🚀 Quick Start
 
@@ -62,6 +62,12 @@ mapify --version
 # Initialize in your project
 cd your-project
 mapify init
+
+# Available commands
+mapify --help                     # Show all available commands
+mapify validate graph <file>      # Validate task dependency graphs
+mapify playbook search <query>    # Search playbook patterns
+mapify recitation get-context     # Get current task plan
 ```
 
 **Version Pinning:**
@@ -162,6 +168,7 @@ Built-in learning system that improves with each task:
 - **Reflector** extracts patterns from successes and failures
 - **Curator** maintains structured knowledge base with quality tracking
 - **Semantic search** (optional) finds patterns by meaning, not keywords
+- **Dependency validation** ensures valid task graphs before execution
 - Automatically grows high-quality pattern library
 
 ### Playbook Commands
@@ -175,12 +182,17 @@ mapify playbook search "JWT authentication"
 
 # View high-quality patterns
 mapify playbook sync
+
+# Validate task dependencies with visualization
+python scripts/validate-dependencies.py decomposer-output.json --visualize
 ```
 
 **Optional semantic search**: `pip install -r requirements-semantic.txt` for meaning-based matching. Details in [SEMANTIC_SEARCH_SETUP.md](docs/SEMANTIC_SEARCH_SETUP.md) and [ARCHITECTURE.md](docs/ARCHITECTURE.md#semantic-search).
 
 **Playbook configuration**: See [ARCHITECTURE.md](docs/ARCHITECTURE.md#playbook-configuration) for top_k settings and optimization.
 
+**Dependency validation**: See [USAGE.md](docs/USAGE.md#dependency-validation) for comprehensive guide on validating TaskDecomposer output, including cycle detection, visualization, and CI/CD integration.
+
 ## 💰 Cost Optimization
 
 MAP Framework uses intelligent model selection per agent:

{mapify_cli-1.0.0 → mapify_cli-1.0.3}/pyproject.toml

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

{mapify_cli-1.0.0 → mapify_cli-1.0.3}/src/mapify_cli/__init__.py

@@ -358,9 +358,11 @@ app = typer.Typer(
 # Create subcommand groups
 recitation_app = typer.Typer(name="recitation", help="Manage task execution plans (recitation pattern)")
 playbook_app = typer.Typer(name="playbook", help="Manage and search playbook patterns")
+validate_app = typer.Typer(name="validate", help="Validate task dependency graphs")
 
 app.add_typer(recitation_app, name="recitation")
 app.add_typer(playbook_app, name="playbook")
+app.add_typer(validate_app, name="validate")
 
 
 def show_banner():
@@ -1937,6 +1939,68 @@ def playbook_sync(threshold: int = typer.Option(5, help="Minimum helpful count")
     patterns = manager.get_bullets_for_sync(threshold=threshold)
     console.print_json(data={"threshold": threshold, "count": len(patterns), "patterns": [{"id": p.get("id"), "helpful_count": p.get("helpful_count")} for p in patterns]})
 
+# Validate commands
+
+@validate_app.command("graph")
+def validate_graph(
+    input_file: Optional[Path] = typer.Argument(None, help="JSON file to validate (or use stdin)"),
+    visualize: bool = typer.Option(False, "--visualize", help="Show ASCII dependency tree"),
+    no_color: bool = typer.Option(False, "--no-color", help="Disable colored output"),
+    format: str = typer.Option("json", "-f", "--format", help="Output format: json or text"),
+    strict: bool = typer.Option(False, "--strict", help="Fail on warnings (e.g., orphaned tasks), not just critical errors (cycles, forward refs)")
+):
+    """Validate TaskDecomposer dependency graph
+
+    Exit codes:
+      0 - Valid graph (no critical errors; warnings allowed unless --strict)
+      1 - Invalid graph (critical errors found, or warnings with --strict)
+      2 - Malformed input (invalid JSON or missing required fields)
+    """
+    from mapify_cli.tools.validate_dependencies import (
+        load_input, DependencyValidator, ASCIIGraphRenderer, print_report
+    )
+
+    try:
+        # Load input
+        data = load_input(str(input_file) if input_file else None)
+
+        # Validate
+        validator = DependencyValidator(data)
+        is_valid = validator.validate_all()
+        report = validator.get_report()
+
+        # Print report
+        print_report(report, format)
+
+        # Display visualization if requested
+        if visualize:
+            console.print()  # Add blank line separator
+            renderer = ASCIIGraphRenderer(validator)
+            visualization = renderer.render(use_colors=not no_color)
+            console.print(visualization)
+
+        # Determine exit code based on issue severity
+        has_critical = report.get("critical_issues", 0) > 0
+        has_warnings = report.get("warnings", 0) > 0
+
+        if has_critical:
+            # Critical errors always fail
+            raise typer.Exit(1)
+        elif has_warnings and strict:
+            # Warnings fail only in strict mode
+            raise typer.Exit(1)
+        # Otherwise exit 0 (success)
+
+    except ValueError as e:
+        # Input validation error (malformed JSON, missing fields)
+        error_report = {
+            "valid": False,
+            "error": str(e),
+            "error_type": "input_validation"
+        }
+        console.print_json(data=error_report)
+        raise typer.Exit(2)
+
 
 def main():
     app()