aiox-core 5.0.2 → 5.0.3

package/pro/squads/squad-creator-pro/scripts/inventory.py

@@ -0,0 +1,269 @@
+#!/usr/bin/env python3
+"""
+Script: inventory.py
+Purpose: Scan squad directory and return structured inventory
+Operations: 30+ deterministic checks
+
+Usage:
+    python scripts/inventory.py squads/{squad-name}/
+    python scripts/inventory.py squads/{squad-name}/ --output json
+    python scripts/inventory.py squads/{squad-name}/ --output yaml
+"""
+
+import os
+import sys
+import json
+import yaml
+import argparse
+from pathlib import Path
+from typing import Dict, List, Any, Optional
+from dataclasses import dataclass, asdict
+from datetime import datetime
+
+
+@dataclass
+class ComponentInventory:
+    """Inventory for a single component type"""
+    count: int
+    files: List[str]
+
+
+@dataclass
+class SquadInventory:
+    """Complete inventory of a squad"""
+    squad_name: str
+    squad_path: str
+    exists: bool
+    scan_date: str
+
+    # Component counts
+    agents: ComponentInventory
+    tasks: ComponentInventory
+    workflows: ComponentInventory
+    templates: ComponentInventory
+    checklists: ComponentInventory
+    data_files: ComponentInventory
+    docs: ComponentInventory
+
+    # Required files
+    has_config_yaml: bool
+    has_readme: bool
+    has_changelog: bool
+
+    # Config metadata (if exists)
+    config_name: Optional[str]
+    config_version: Optional[str]
+    config_description: Optional[str]
+    config_slash_prefix: Optional[str]
+
+    # Totals
+    total_components: int
+
+    # Issues found
+    issues: List[Dict[str, str]]
+
+
+def list_files(directory: Path, patterns: List[str]) -> List[str]:
+    """List files matching patterns in directory"""
+    if not directory.exists():
+        return []
+
+    files = []
+    for pattern in patterns:
+        for f in directory.glob(pattern):
+            if f.is_file() and not f.name.startswith('.'):
+                files.append(f.name)
+
+    return sorted(set(files))
+
+
+def read_config_yaml(squad_path: Path) -> Optional[Dict]:
+    """Read and parse config.yaml"""
+    config_file = squad_path / "config.yaml"
+    if not config_file.exists():
+        return None
+
+    try:
+        with open(config_file, 'r', encoding='utf-8') as f:
+            return yaml.safe_load(f)
+    except Exception:
+        return None
+
+
+def scan_squad(squad_path: Path) -> SquadInventory:
+    """Scan a squad directory and return inventory"""
+
+    issues = []
+
+    # Check if squad exists
+    if not squad_path.exists():
+        return SquadInventory(
+            squad_name=squad_path.name,
+            squad_path=str(squad_path),
+            exists=False,
+            scan_date=datetime.now().isoformat(),
+            agents=ComponentInventory(0, []),
+            tasks=ComponentInventory(0, []),
+            workflows=ComponentInventory(0, []),
+            templates=ComponentInventory(0, []),
+            checklists=ComponentInventory(0, []),
+            data_files=ComponentInventory(0, []),
+            docs=ComponentInventory(0, []),
+            has_config_yaml=False,
+            has_readme=False,
+            has_changelog=False,
+            config_name=None,
+            config_version=None,
+            config_description=None,
+            config_slash_prefix=None,
+            total_components=0,
+            issues=[{"type": "BLOCKING", "message": f"Squad directory does not exist: {squad_path}"}]
+        )
+
+    # Scan each component directory
+    agents_files = list_files(squad_path / "agents", ["*.md"])
+    tasks_files = list_files(squad_path / "tasks", ["*.md"])
+    workflows_files = list_files(squad_path / "workflows", ["*.md", "*.yaml"])
+    templates_files = list_files(squad_path / "templates", ["*.md", "*.yaml"])
+    checklists_files = list_files(squad_path / "checklists", ["*.md"])
+    data_files = list_files(squad_path / "data", ["*.md", "*.yaml"])
+    docs_files = list_files(squad_path / "docs", ["*.md"])
+
+    # Check required files
+    has_config = (squad_path / "config.yaml").exists()
+    has_readme = (squad_path / "README.md").exists()
+    has_changelog = (squad_path / "CHANGELOG.md").exists()
+
+    # Track issues
+    if not has_config:
+        issues.append({"type": "BLOCKING", "message": "Missing config.yaml"})
+    if not has_readme:
+        issues.append({"type": "WARNING", "message": "Missing README.md"})
+    if len(agents_files) == 0:
+        issues.append({"type": "WARNING", "message": "No agents found in agents/"})
+
+    # Read config metadata
+    config = read_config_yaml(squad_path)
+    config_name = config.get("name") if config else None
+    config_version = config.get("version") if config else None
+    config_description = config.get("description") if config else None
+    config_slash_prefix = config.get("slashPrefix") if config else None
+
+    # Check config name matches folder
+    if config_name and config_name != squad_path.name:
+        issues.append({
+            "type": "WARNING",
+            "message": f"config.yaml name '{config_name}' doesn't match folder '{squad_path.name}'"
+        })
+
+    # Calculate totals
+    total = (
+        len(agents_files) +
+        len(tasks_files) +
+        len(workflows_files) +
+        len(templates_files) +
+        len(checklists_files) +
+        len(data_files)
+    )
+
+    return SquadInventory(
+        squad_name=squad_path.name,
+        squad_path=str(squad_path),
+        exists=True,
+        scan_date=datetime.now().isoformat(),
+        agents=ComponentInventory(len(agents_files), agents_files),
+        tasks=ComponentInventory(len(tasks_files), tasks_files),
+        workflows=ComponentInventory(len(workflows_files), workflows_files),
+        templates=ComponentInventory(len(templates_files), templates_files),
+        checklists=ComponentInventory(len(checklists_files), checklists_files),
+        data_files=ComponentInventory(len(data_files), data_files),
+        docs=ComponentInventory(len(docs_files), docs_files),
+        has_config_yaml=has_config,
+        has_readme=has_readme,
+        has_changelog=has_changelog,
+        config_name=config_name,
+        config_version=config_version,
+        config_description=config_description,
+        config_slash_prefix=config_slash_prefix,
+        total_components=total,
+        issues=issues
+    )
+
+
+def format_output(inventory: SquadInventory, format: str) -> str:
+    """Format inventory for output"""
+    data = asdict(inventory)
+
+    if format == "json":
+        return json.dumps(data, indent=2, ensure_ascii=False)
+    elif format == "yaml":
+        return yaml.dump(data, allow_unicode=True, default_flow_style=False, sort_keys=False)
+    else:  # summary
+        lines = [
+            f"Squad Inventory: {inventory.squad_name}",
+            "=" * 50,
+            f"Path: {inventory.squad_path}",
+            f"Exists: {inventory.exists}",
+            f"Scan Date: {inventory.scan_date}",
+            "",
+            "Components:",
+            f"  Agents:     {inventory.agents.count:3d}  {inventory.agents.files[:3]}{'...' if len(inventory.agents.files) > 3 else ''}",
+            f"  Tasks:      {inventory.tasks.count:3d}  {inventory.tasks.files[:3]}{'...' if len(inventory.tasks.files) > 3 else ''}",
+            f"  Workflows:  {inventory.workflows.count:3d}  {inventory.workflows.files[:3]}{'...' if len(inventory.workflows.files) > 3 else ''}",
+            f"  Templates:  {inventory.templates.count:3d}",
+            f"  Checklists: {inventory.checklists.count:3d}",
+            f"  Data:       {inventory.data_files.count:3d}",
+            f"  Docs:       {inventory.docs.count:3d}",
+            f"  TOTAL:      {inventory.total_components:3d}",
+            "",
+            "Required Files:",
+            f"  config.yaml:  {'✓' if inventory.has_config_yaml else '✗ MISSING'}",
+            f"  README.md:    {'✓' if inventory.has_readme else '✗ MISSING'}",
+            f"  CHANGELOG.md: {'✓' if inventory.has_changelog else '○ Optional'}",
+            "",
+            "Config Metadata:",
+            f"  Name:        {inventory.config_name or 'N/A'}",
+            f"  Version:     {inventory.config_version or 'N/A'}",
+            f"  slashPrefix: {inventory.config_slash_prefix or 'N/A'}",
+        ]
+
+        if inventory.issues:
+            lines.extend(["", "Issues Found:"])
+            for issue in inventory.issues:
+                icon = "🚫" if issue["type"] == "BLOCKING" else "⚠️"
+                lines.append(f"  {icon} [{issue['type']}] {issue['message']}")
+
+        return "\n".join(lines)
+
+
+def main():
+    parser = argparse.ArgumentParser(
+        description="Scan squad directory and return inventory"
+    )
+    parser.add_argument(
+        "squad_path",
+        type=Path,
+        help="Path to squad directory (e.g., squads/{squad-name}/)"
+    )
+    parser.add_argument(
+        "--output", "-o",
+        choices=["json", "yaml", "summary"],
+        default="summary",
+        help="Output format"
+    )
+
+    args = parser.parse_args()
+
+    # Scan squad
+    inventory = scan_squad(args.squad_path)
+
+    # Output
+    print(format_output(inventory, args.output))
+
+    # Exit code based on blocking issues
+    blocking = [i for i in inventory.issues if i["type"] == "BLOCKING"]
+    sys.exit(1 if blocking else 0)
+
+
+if __name__ == "__main__":
+    main()

package/pro/squads/squad-creator-pro/scripts/lib/config-loader.js

@@ -0,0 +1,151 @@
+/**
+ * Config Loader for Squad Creator Scripts
+ *
+ * Detecta o root do projeto automaticamente e carrega paths do squad-config.yaml.
+ * NUNCA usa paths absolutos hardcoded.
+ *
+ * Usage:
+ *   const config = require('./lib/config-loader');
+ *   console.log(config.paths.tasks);  // /path/to/project/squads/squad-creator-pro/tasks
+ */
+
+const fs = require('fs');
+const path = require('path');
+const yaml = require('js-yaml');
+
+// ============================================================================
+// PROJECT ROOT DETECTION
+// ============================================================================
+
+function findProjectRoot(startDir = __dirname) {
+  let currentDir = startDir;
+  const maxDepth = 10;
+  let depth = 0;
+
+  while (depth < maxDepth) {
+    // Check for markers that indicate project root
+    const markers = [
+      'package.json',
+      '.git',
+      '.claude'
+    ];
+
+    for (const marker of markers) {
+      const markerPath = path.join(currentDir, marker);
+      if (fs.existsSync(markerPath)) {
+        // Verify it's the right project by checking for squads/squad-creator
+        const squadCreatorPath = path.join(currentDir, 'squads', 'squad-creator');
+        if (fs.existsSync(squadCreatorPath)) {
+          return currentDir;
+        }
+      }
+    }
+
+    // Move up one directory
+    const parentDir = path.dirname(currentDir);
+    if (parentDir === currentDir) {
+      // Reached filesystem root
+      break;
+    }
+    currentDir = parentDir;
+    depth++;
+  }
+
+  throw new Error('Could not find project root. Make sure you are running from within the project.');
+}
+
+// ============================================================================
+// CONFIG LOADER
+// ============================================================================
+
+function loadSquadConfig(projectRoot) {
+  const configPath = path.join(projectRoot, 'squads', 'squad-creator', 'config', 'squad-config.yaml');
+
+  if (!fs.existsSync(configPath)) {
+    throw new Error(`Squad config not found: ${configPath}`);
+  }
+
+  const content = fs.readFileSync(configPath, 'utf-8');
+  return yaml.load(content);
+}
+
+// ============================================================================
+// PATH RESOLVER
+// ============================================================================
+
+function resolvePaths(projectRoot, pathsConfig) {
+  const resolved = {};
+
+  function resolve(obj, prefix = '') {
+    for (const [key, value] of Object.entries(obj)) {
+      const fullKey = prefix ? `${prefix}.${key}` : key;
+
+      if (typeof value === 'string') {
+        // It's a path - resolve it
+        resolved[fullKey] = path.join(projectRoot, value);
+      } else if (typeof value === 'object' && value !== null) {
+        // It's a nested object - recurse
+        resolve(value, fullKey);
+      }
+    }
+  }
+
+  resolve(pathsConfig);
+  return resolved;
+}
+
+// ============================================================================
+// EXPORTS
+// ============================================================================
+
+let _config = null;
+
+function getConfig() {
+  if (_config) return _config;
+
+  const projectRoot = findProjectRoot();
+  const squadConfig = loadSquadConfig(projectRoot);
+  const pathsConfig = squadConfig.squad_config?.paths || {};
+  const resolvedPaths = resolvePaths(projectRoot, pathsConfig);
+
+  // Flatten for easy access
+  _config = {
+    projectRoot,
+    squadConfig,
+
+    // Resolved absolute paths
+    paths: {
+      // Squad-creator paths
+      squadRoot: resolvedPaths['squad_root'],
+      tasks: resolvedPaths['tasks'],
+      agents: resolvedPaths['agents'],
+      config: resolvedPaths['config'],
+      scripts: resolvedPaths['scripts'],
+
+      // Output paths
+      outputs: resolvedPaths['outputs.root'],
+      minds: resolvedPaths['outputs.minds'],
+      llmTests: resolvedPaths['outputs.llm_tests'],
+      llmTestInputs: resolvedPaths['outputs.llm_test_inputs'],
+
+      // Infrastructure
+      envLoader: resolvedPaths['infrastructure.env_loader'],
+      llmRouter: resolvedPaths['infrastructure.llm_router'],
+    },
+
+    // Helper to join paths relative to project root
+    resolve: (...segments) => path.join(projectRoot, ...segments),
+
+    // Helper to join paths relative to squad-creator
+    squadResolve: (...segments) => path.join(projectRoot, 'squads', 'squad-creator', ...segments),
+  };
+
+  return _config;
+}
+
+module.exports = getConfig();
+
+// Also export the functions for testing
+module.exports.findProjectRoot = findProjectRoot;
+module.exports.loadSquadConfig = loadSquadConfig;
+module.exports.resolvePaths = resolvePaths;