wizz-method 1.4.0 → 1.5.0

package/src/squads/traffic-masters/agents/traffic-chief.md

@@ -1,97 +0,0 @@
-# Traffic Chief
-
-> ACTIVATION-NOTICE: You are the Traffic Chief — orchestrator of the Traffic Masters Squad. You do NOT buy media or write ads. You DIAGNOSE traffic problems, ROUTE them to the correct specialist, and REVIEW their output. You think in platforms, funnels, metrics, and creative. Every traffic problem maps to a platform expert or functional specialist.
-
-## COMPLETE AGENT DEFINITION
-
-```yaml
-agent:
-  name: "Traffic Chief"
-  id: traffic-chief
-  title: "Traffic Masters Orchestrator"
-  icon: "🎯"
-  tier: 0
-  squad: traffic-masters
-  role: orchestrator
-
-persona:
-  role: "Traffic Problem Diagnostician & Squad Router"
-  identity: "The central nervous system of the Traffic Masters Squad. Fluent in all major ad platforms and traffic strategies. Diagnoses whether a traffic problem is platform-specific, creative-related, targeting-based, budget-driven, or funnel-connected. Routes to the right expert or specialist."
-  style: "Analytical, metric-driven, diagnostic. Gets to the root cause fast. Speaks in ROAS, CPA, CTR, and funnel stages."
-
-core_diagnostic:
-  step_1: "What's the ACTUAL problem? (Not enough traffic? Wrong traffic? Traffic that doesn't convert?)"
-  step_2: "Which platform(s)? (Facebook, Google, YouTube, TikTok, LinkedIn, multi-platform)"
-  step_3: "Where in the funnel? (Top = awareness/reach, Middle = consideration/clicks, Bottom = conversion)"
-  step_4: "What's the budget level? (<$1K/mo, $1K-$10K, $10K-$100K, $100K+)"
-  step_5: "Route to the right specialist."
-
-routing_logic:
-  platform_specific:
-    facebook_meta:
-      signals: ["Facebook ads", "Meta ads", "Instagram ads", "Reels ads"]
-      route_to: [molly-pittman, depesh-mandalia, ralph-burns]
-    youtube:
-      signals: ["YouTube ads", "pre-roll", "TrueView", "video ads on YouTube"]
-      route_to: tom-breeze
-    google:
-      signals: ["Google Ads", "Search ads", "Performance Max", "Shopping ads"]
-      route_to: kasim-aslam
-    brazil_latam:
-      signals: ["Brazilian market", "LATAM", "Portuguese-speaking", "gestor de trafego"]
-      route_to: pedro-sobral
-
-  function_specific:
-    creative_problem:
-      signals: ["ads not getting clicks", "creative fatigue", "need better ad creative", "low CTR"]
-      route_to: [ad-midas, creative-analyst]
-    scaling_problem:
-      signals: ["can't scale spend", "CPA increases with budget", "diminishing returns"]
-      route_to: [scale-optimizer, depesh-mandalia]
-    tracking_problem:
-      signals: ["attribution issues", "pixel not firing", "iOS tracking", "conversion tracking broken"]
-      route_to: pixel-specialist
-    analysis_problem:
-      signals: ["don't know what's working", "need audit", "can't read the data"]
-      route_to: [performance-analyst, ads-analyst]
-    budget_problem:
-      signals: ["budget allocation", "cashflow for ads", "ROAS targets", "profitability"]
-      route_to: fiscal
-    execution_problem:
-      signals: ["need someone to set up campaigns", "campaign structure", "media buying"]
-      route_to: media-buyer
-
-quality_review:
-  checks:
-    - "Is the offer validated before spending on ads?"
-    - "Is tracking properly set up?"
-    - "Are we testing creatives systematically?"
-    - "Is the CPA sustainable relative to LTV?"
-    - "Are we scaling profitably, not just spending more?"
-    - "Is there a clear funnel from click to conversion?"
-
-commands:
-  - name: diagnose
-    description: "Diagnose the traffic problem and recommend the right specialist"
-  - name: route
-    description: "Route a specific request to the correct traffic agent"
-  - name: review
-    description: "Review any traffic strategy for completeness"
-  - name: roster
-    description: "Show all 16 Traffic Masters agents and their specialties"
-  - name: metrics
-    description: "Quick metrics health check on any campaign"
-```
-
----
-
-## How the Traffic Chief Routes
-
-1. **Listen to the problem.** What's actually happening with their traffic/ads?
-2. **Identify the platform.** Facebook? Google? YouTube? Multi-platform?
-3. **Identify the function.** Creative? Targeting? Scaling? Tracking? Budget?
-4. **Check the budget level.** Strategy differs at $1K/mo vs. $100K/mo.
-5. **Route to specialist.** Platform expert for strategy, functional agent for execution.
-6. **Review output.** Does it meet ROAS targets? Is it scalable?
-
-The Chief NEVER writes ads, buys media, or sets up campaigns. The Chief DIAGNOSES and ROUTES.

package/src/squads/traffic-masters/squad.yaml

@@ -1,59 +0,0 @@
-name: traffic-masters
-version: "1.0.0"
-short-title: "Traffic Masters"
-description: "Squad de 16 agentes especialistas em trafego pago. Facebook, YouTube, Google Ads, media buying, creative analysis, scaling, tracking."
-author: "Synkra AIOS"
-license: MIT
-slashPrefix: "traffic-masters"
-
-aios:
-  minVersion: "4.0.0"
-  type: squad
-
-tags:
-  - traffic
-  - ads
-  - facebook
-  - google
-  - youtube
-  - media-buying
-  - creative
-  - scaling
-  - tracking
-
-components:
-  agents:
-    - traffic-chief.md
-    - molly-pittman.md
-    - ralph-burns.md
-    - depesh-mandalia.md
-    - nicholas-kusmich.md
-    - tom-breeze.md
-    - kasim-aslam.md
-    - pedro-sobral.md
-    - ad-midas.md
-    - media-buyer.md
-    - performance-analyst.md
-    - creative-analyst.md
-    - scale-optimizer.md
-    - pixel-specialist.md
-    - ads-analyst.md
-    - fiscal.md
-  tasks:
-    - analyze-performance.md
-    - audit-ad-account.md
-    - create-ad-creative.md
-    - create-ad-strategy.md
-    - diagnose.md
-    - manage-budget.md
-    - review.md
-    - scale-campaign.md
-    - setup-tracking.md
-  workflows:
-    - wf-account-audit.yaml
-    - wf-campaign-launch.yaml
-  checklists:
-    - output-quality.md
-
-config:
-  extends: extend

package/tools/bundle-web-bundles.js

@@ -1,117 +0,0 @@
-/**
- * Web Bundle Release Packager
- *
- * Zips each bundle under web-bundles/ into dist/web-bundles/{slug}.zip
- * for attachment to a GitHub Release.
- *
- * Usage:
- *   node tools/bundle-web-bundles.js
- *
- * After running, the script prints the exact `gh release create` command
- * (with the correct tag from bundles.json) for you to copy.
- */
-
-const fs = require('node:fs');
-const path = require('node:path');
-const { execSync, execFileSync } = require('node:child_process');
-
-const REPO_ROOT = path.resolve(__dirname, '..');
-const BUNDLES_DIR = path.join(REPO_ROOT, 'web-bundles');
-const DIST_DIR = path.join(REPO_ROOT, 'dist', 'web-bundles');
-const MANIFEST = path.join(BUNDLES_DIR, 'bundles.json');
-const SLUG_RE = /^[a-z0-9][a-z0-9-]*$/;
-
-function fail(msg) {
-  console.error(`[ERROR] ${msg}`);
-  process.exit(1);
-}
-
-function requireZipCli() {
-  try {
-    execSync('zip -v', { stdio: 'ignore' });
-  } catch {
-    fail("'zip' CLI not found on PATH. Install zip (macOS: preinstalled; Debian/Ubuntu: apt install zip; Alpine: apk add zip) and re-run.");
-  }
-}
-
-function loadManifest() {
-  if (!fs.existsSync(MANIFEST)) {
-    fail(`bundles.json not found at ${MANIFEST}`);
-  }
-  let manifest;
-  try {
-    manifest = JSON.parse(fs.readFileSync(MANIFEST, 'utf-8'));
-  } catch (error) {
-    fail(`bundles.json is not valid JSON: ${error.message}`);
-  }
-  if (!Array.isArray(manifest.bundles) || manifest.bundles.length === 0) {
-    fail('bundles.json is missing a non-empty "bundles" array.');
-  }
-  if (typeof manifest.releaseTag !== 'string' || !manifest.releaseTag) {
-    fail('bundles.json is missing "releaseTag".');
-  }
-  return manifest;
-}
-
-function main() {
-  requireZipCli();
-  const manifest = loadManifest();
-  const releaseTag = manifest.releaseTag;
-
-  fs.mkdirSync(DIST_DIR, { recursive: true });
-
-  console.log(`Packaging ${manifest.bundles.length} bundles for release ${releaseTag}\n`);
-
-  const zipped = [];
-  const missing = [];
-  const invalid = [];
-  for (const bundle of manifest.bundles) {
-    if (!bundle.slug || !SLUG_RE.test(bundle.slug)) {
-      invalid.push(bundle.slug || '(no slug)');
-      console.error(`  [INVALID] slug must match ${SLUG_RE} — got: ${bundle.slug}`);
-      continue;
-    }
-    const src = path.join(BUNDLES_DIR, bundle.slug);
-    if (!fs.existsSync(src)) {
-      missing.push(bundle.slug);
-      console.error(`  [MISSING] ${bundle.slug} — directory not found`);
-      continue;
-    }
-
-    const out = path.join(DIST_DIR, `${bundle.slug}.zip`);
-    if (fs.existsSync(out)) fs.unlinkSync(out);
-
-    try {
-      execFileSync('zip', ['-r', '-X', '-q', out, bundle.slug, '-x', '*.DS_Store'], {
-        cwd: BUNDLES_DIR,
-        stdio: 'inherit',
-      });
-    } catch (error) {
-      fail(`zip failed for ${bundle.slug}: ${error.message}`);
-    }
-
-    const size = (fs.statSync(out).size / 1024).toFixed(1);
-    console.log(`  [OK] ${bundle.slug}.zip (${size} KB)`);
-    zipped.push(bundle.slug);
-  }
-
-  if (invalid.length > 0) {
-    fail(`Refusing to publish: ${invalid.length} bundle(s) have invalid slugs: ${invalid.join(', ')}`);
-  }
-  if (missing.length > 0) {
-    fail(`Refusing to publish an incomplete release: missing directories for ${missing.join(', ')}`);
-  }
-  if (zipped.length === 0) {
-    fail('No bundles were packaged. Check bundles.json against web-bundles/ subdirectories.');
-  }
-
-  console.log(`\nWrote ${zipped.length} bundles to ${path.relative(REPO_ROOT, DIST_DIR)}/`);
-  console.log('\nNext step — create or update the GitHub Release:\n');
-  console.log(`  gh release create ${releaseTag} dist/web-bundles/*.zip \\`);
-  console.log(`    --title "${releaseTag}" \\`);
-  console.log(`    --notes "Wizz web bundles for Gemini Gems and ChatGPT Custom GPTs. See https://bmadcode.com/web-bundles/"\n`);
-  console.log('Or, to refresh an existing release:\n');
-  console.log(`  gh release upload ${releaseTag} dist/web-bundles/*.zip --clobber\n`);
-}
-
-main();

package/tools/format-workflow-md.js

@@ -1,263 +0,0 @@
-/**
- * WIZZ Workflow Markdown Formatter
- *
- * Formats mixed markdown + XML workflow instruction files with:
- * - 2-space XML indentation
- * - Preserved markdown content
- * - Proper tag nesting
- * - Consistent formatting
- */
-
-const fs = require('node:fs');
-const path = require('node:path');
-
-class WorkflowFormatter {
-  constructor(options = {}) {
-    this.indentSize = options.indentSize || 2;
-    this.preserveMarkdown = options.preserveMarkdown !== false;
-    this.verbose = options.verbose || false;
-  }
-
-  /**
-   * Format a workflow markdown file
-   */
-  format(filePath) {
-    if (this.verbose) {
-      console.log(`Formatting: ${filePath}`);
-    }
-
-    const content = fs.readFileSync(filePath, 'utf8');
-    const formatted = this.formatContent(content);
-
-    // Only write if content changed
-    if (content === formatted) {
-      if (this.verbose) {
-        console.log(`- No changes: ${filePath}`);
-      }
-      return false;
-    } else {
-      fs.writeFileSync(filePath, formatted, 'utf8');
-      if (this.verbose) {
-        console.log(`✓ Formatted: ${filePath}`);
-      }
-      return true;
-    }
-  }
-
-  /**
-   * Format content string with stateful indentation tracking
-   */
-  formatContent(content) {
-    const lines = content.split('\n');
-    const formatted = [];
-    let indentLevel = 0;
-    let inCodeBlock = false;
-    let checkBlockDepth = 0; // Track nested check blocks
-
-    for (let i = 0; i < lines.length; i++) {
-      const line = lines[i];
-      const trimmed = line.trim();
-
-      // Track code blocks (don't format inside them)
-      if (trimmed.startsWith('```')) {
-        if (inCodeBlock) {
-          inCodeBlock = false;
-        } else {
-          inCodeBlock = true;
-        }
-        formatted.push(line);
-        continue;
-      }
-
-      // Don't format inside code blocks
-      if (inCodeBlock) {
-        formatted.push(line);
-        continue;
-      }
-
-      // Handle XML tags
-      if (this.isXMLLine(trimmed)) {
-        const result = this.formatXMLLine(trimmed, indentLevel, checkBlockDepth, i, lines);
-        formatted.push(result.line);
-        indentLevel = result.nextIndent;
-        checkBlockDepth = result.nextCheckDepth;
-      } else if (trimmed === '') {
-        // Preserve blank lines
-        formatted.push('');
-      } else {
-        // Markdown content - preserve as-is but maintain current indent if inside XML
-        formatted.push(line);
-      }
-    }
-
-    return formatted.join('\n');
-  }
-
-  /**
-   * Check if line contains XML tag
-   */
-  isXMLLine(line) {
-    return /^<[a-zA-Z-]+(\s|>|\/)/.test(line) || /^<\/[a-zA-Z-]+>/.test(line);
-  }
-
-  /**
-   * Format a single XML line with context awareness
-   */
-  formatXMLLine(line, currentIndent, checkDepth, lineIndex, allLines) {
-    const trimmed = line.trim();
-    let indent = currentIndent;
-    let nextIndent = currentIndent;
-    let nextCheckDepth = checkDepth;
-
-    // Get the tag name
-    const tagMatch = trimmed.match(/^<\/?([a-zA-Z-]+)/);
-    const tagName = tagMatch ? tagMatch[1] : '';
-
-    // Closing tag - decrease indent before this line
-    if (trimmed.startsWith('</')) {
-      indent = Math.max(0, currentIndent - 1);
-      nextIndent = indent;
-
-      // If closing a step, reset check depth
-      if (tagName === 'step' || tagName === 'workflow') {
-        nextCheckDepth = 0;
-      }
-    }
-    // Self-closing tags (opens and closes on same line)
-    // EXCEPT <check> tags which create logical blocks
-    else if (this.isSelfClosingTag(trimmed) && tagName !== 'check') {
-      // These don't change indent level
-      indent = currentIndent;
-      nextIndent = currentIndent;
-    }
-    // Opening tags
-    else if (trimmed.startsWith('<')) {
-      // Check if this is a <check> tag - these create logical blocks
-      if (tagName === 'check') {
-        indent = currentIndent;
-        // Check tags increase indent for following content
-        nextIndent = currentIndent + 1;
-        nextCheckDepth = checkDepth + 1;
-      }
-      // <action> tags inside check blocks stay at current indent
-      else if (tagName === 'action' && checkDepth > 0) {
-        indent = currentIndent;
-        nextIndent = currentIndent; // Don't increase further
-      }
-      // Other tags close check blocks and return to structural level
-      else if (checkDepth > 0) {
-        // Close all check blocks - return to base structural level
-        indent = Math.max(0, currentIndent - checkDepth);
-        nextIndent = indent + 1;
-        nextCheckDepth = 0;
-      }
-      // Regular opening tags (no check blocks active)
-      else {
-        indent = currentIndent;
-        nextIndent = currentIndent + 1;
-      }
-    }
-
-    const indentStr = ' '.repeat(indent * this.indentSize);
-    return {
-      line: indentStr + trimmed,
-      nextIndent: nextIndent,
-      nextCheckDepth: nextCheckDepth,
-    };
-  }
-
-  /**
-   * Check if tag opens and closes on same line
-   */
-  isSelfClosingTag(line) {
-    // Self-closing with />
-    if (line.endsWith('/>')) {
-      return true;
-    }
-    // Opens and closes on same line: <tag>content</tag>
-    const match = line.match(/^<([a-zA-Z-]+)(\s[^>]*)?>.*<\/\1>$/);
-    return match !== null;
-  }
-
-  /**
-   * Check if tag is a block-level structural tag
-   */
-  isBlockLevelTag(tagName) {
-    return ['step', 'workflow', 'check'].includes(tagName);
-  }
-}
-
-/**
- * CLI Entry Point
- */
-function main() {
-  const args = process.argv.slice(2);
-
-  if (args.length === 0 || args.includes('--help') || args.includes('-h')) {
-    console.log(`
-WIZZ Workflow Markdown Formatter
-
-Usage:
-  node format-workflow-md.js <file-pattern> [options]
-
-Options:
-  --verbose, -v     Verbose output
-  --check, -c       Check formatting without writing (exit 1 if changes needed)
-  --help, -h        Show this help
-
-Examples:
-  node format-workflow-md.js src/**/instructions.md
-  node format-workflow-md.js "src/modules/bmb/**/*.md" --verbose
-  node format-workflow-md.js file.md --check
-`);
-    process.exit(0);
-  }
-
-  const verbose = args.includes('--verbose') || args.includes('-v');
-  const check = args.includes('--check') || args.includes('-c');
-
-  // Remove flags from args
-  const files = args.filter((arg) => !arg.startsWith('-'));
-
-  const formatter = new WorkflowFormatter({ verbose });
-  let hasChanges = false;
-  let formattedCount = 0;
-
-  // Process files
-  for (const pattern of files) {
-    // For now, treat as direct file path
-    // TODO: Add glob support for patterns
-    if (fs.existsSync(pattern)) {
-      const stat = fs.statSync(pattern);
-      if (stat.isFile()) {
-        const changed = formatter.format(pattern);
-        if (changed) {
-          hasChanges = true;
-          formattedCount++;
-        }
-      } else if (stat.isDirectory()) {
-        console.error(`Error: ${pattern} is a directory. Please specify file paths.`);
-      }
-    } else {
-      console.error(`Error: File not found: ${pattern}`);
-    }
-  }
-
-  if (verbose || formattedCount > 0) {
-    console.log(`\nFormatted ${formattedCount} file(s)`);
-  }
-
-  if (check && hasChanges) {
-    console.error('\n❌ Some files need formatting. Run without --check to format.');
-    process.exit(1);
-  }
-
-  process.exit(0);
-}
-
-// Run if called directly
-if (require.main === module) {
-  main();
-}
-
-module.exports = { WorkflowFormatter };

package/tools/javascript-conventions.md

@@ -1,5 +0,0 @@
-# JavaScript Conventions
-
-## Function ordering
-
-Define functions top-to-bottom in call order: callers above callees. If `install()` calls `_initPaths()`, then `install` appears first and `_initPaths` appears after it.

package/tools/migrate-custom-module-paths.js

@@ -1,124 +0,0 @@
-/**
- * Migration script to convert relative paths to absolute paths in custom module manifests
- * This should be run once to update existing installations
- */
-
-const fs = require('./installer/fs-native');
-const path = require('node:path');
-const yaml = require('yaml');
-const chalk = require('chalk');
-
-/**
- * Find WIZZ directory in project
- */
-function findWizzDir(projectDir = process.cwd()) {
-  const possibleNames = ['_wizz'];
-
-  for (const name of possibleNames) {
-    const wizzDir = path.join(projectDir, name);
-    if (fs.existsSync(wizzDir)) {
-      return wizzDir;
-    }
-  }
-
-  return null;
-}
-
-/**
- * Update manifest to use absolute paths
- */
-async function updateManifest(manifestPath, projectRoot) {
-  console.log(chalk.cyan(`\nUpdating manifest: ${manifestPath}`));
-
-  const content = await fs.readFile(manifestPath, 'utf8');
-  const manifest = yaml.parse(content);
-
-  if (!manifest.customModules || manifest.customModules.length === 0) {
-    console.log(chalk.dim('  No custom modules found'));
-    return false;
-  }
-
-  let updated = false;
-
-  for (const customModule of manifest.customModules) {
-    if (customModule.relativePath && !customModule.sourcePath) {
-      // Convert relative path to absolute
-      const absolutePath = path.resolve(projectRoot, customModule.relativePath);
-      customModule.sourcePath = absolutePath;
-
-      // Remove the old relativePath
-      delete customModule.relativePath;
-
-      console.log(chalk.green(`  ✓ Updated ${customModule.id}: ${customModule.relativePath} → ${absolutePath}`));
-      updated = true;
-    } else if (customModule.sourcePath && !path.isAbsolute(customModule.sourcePath)) {
-      // Source path exists but is not absolute
-      const absolutePath = path.resolve(customModule.sourcePath);
-      customModule.sourcePath = absolutePath;
-
-      console.log(chalk.green(`  ✓ Updated ${customModule.id}: ${customModule.sourcePath} → ${absolutePath}`));
-      updated = true;
-    }
-  }
-
-  if (updated) {
-    // Write back the updated manifest
-    const yamlStr = yaml.dump(manifest, {
-      indent: 2,
-      lineWidth: -1,
-      noRefs: true,
-      sortKeys: false,
-    });
-
-    await fs.writeFile(manifestPath, yamlStr);
-    console.log(chalk.green('  Manifest updated successfully'));
-  } else {
-    console.log(chalk.dim('  All paths already absolute'));
-  }
-
-  return updated;
-}
-
-/**
- * Main migration function
- */
-async function migrate(directory) {
-  const projectRoot = path.resolve(directory || process.cwd());
-  const wizzDir = findWizzDir(projectRoot);
-
-  if (!wizzDir) {
-    console.error(chalk.red('✗ No WIZZ installation found in directory'));
-    process.exit(1);
-  }
-
-  console.log(chalk.blue.bold('🔄 WIZZ Custom Module Path Migration'));
-  console.log(chalk.dim(`Project: ${projectRoot}`));
-  console.log(chalk.dim(`WIZZ Directory: ${wizzDir}`));
-
-  const manifestPath = path.join(wizzDir, '_config', 'manifest.yaml');
-
-  if (!fs.existsSync(manifestPath)) {
-    console.error(chalk.red('✗ No manifest.yaml found'));
-    process.exit(1);
-  }
-
-  const updated = await updateManifest(manifestPath, projectRoot);
-
-  if (updated) {
-    console.log(chalk.green.bold('\n✨ Migration completed successfully!'));
-    console.log(chalk.dim('Custom modules now use absolute source paths.'));
-  } else {
-    console.log(chalk.yellow('\n⚠ No migration needed - paths already absolute'));
-  }
-}
-
-// Run migration if called directly
-if (require.main === module) {
-  const directory = process.argv[2];
-  migrate(directory).catch((error) => {
-    console.error(chalk.red('\n✗ Migration failed:'), error.message);
-    process.exit(1);
-  });
-}
-
-module.exports = { migrate };