sinapse-ai 8.0.2 → 9.1.0

package/.sinapse-ai/core/quality-gates/focus-area-recommender.js

@@ -6,12 +6,16 @@
  * - Business logic
  * - Security considerations
  * - UX/UI implications
+ * - Git-blame hotspot analysis (v2.0)
  *
  * @module core/quality-gates/focus-area-recommender
- * @version 1.0.0
+ * @version 2.0.0
  * @story 3.5 - Human Review Orchestration (Layer 3)
+ * @story 9.0 - Ecosystem Quality (git-blame enrichment)
  */
 
+const { execSync } = require('child_process');
+
 /**
  * Focus Area Recommender
  * Generates intelligent focus areas based on code changes and context
@@ -54,17 +58,48 @@ class FocusAreaRecommender {
       skip: this.skipAreas,
       summary: '',
       highlightedAspects: [],
+      hotspots: [],
     };
 
     // Analyze changed files
     const fileAnalysis = this.analyzeChangedFiles(prContext.changedFiles || []);
     recommendations.highlightedAspects.push(...fileAnalysis.highlights);
 
+    // Git-blame hotspot analysis (v2.0)
+    const blameInsights = this.getGitBlameInsights(prContext.changedFiles || []);
+    if (blameInsights.hotspots.length > 0) {
+      recommendations.hotspots = blameInsights.hotspots;
+      recommendations.highlightedAspects.push(...blameInsights.highlights);
+    }
+
     // Add primary focus areas
     recommendations.primary = this.determinePrimaryAreas(fileAnalysis, layer2Result);
 
+    // Boost priority for hotspot files
+    if (blameInsights.hotspots.length > 0) {
+      const hotspotArea = {
+        area: 'change-hotspot',
+        reason: `${blameInsights.hotspots.length} file(s) changed frequently (high churn)`,
+        files: blameInsights.hotspots.map((h) => h.file).slice(0, 5),
+        questions: [
+          'Is this file changing too often? Consider refactoring.',
+          'Are these changes addressing root cause or symptoms?',
+          'Would a different architecture reduce churn here?',
+        ],
+      };
+      // Insert hotspot as secondary if not already critical
+      if (!recommendations.primary.some((p) => p.area === 'architecture')) {
+        recommendations.primary.push(hotspotArea);
+        recommendations.primary = recommendations.primary.slice(0, 3);
+      } else {
+        recommendations.secondary = [hotspotArea, ...recommendations.secondary].slice(0, 2);
+      }
+    }
+
     // Add secondary focus areas
-    recommendations.secondary = this.determineSecondaryAreas(fileAnalysis, layer2Result);
+    if (recommendations.secondary.length === 0) {
+      recommendations.secondary = this.determineSecondaryAreas(fileAnalysis, layer2Result);
+    }
 
     // Generate summary
     recommendations.summary = this.generateSummary(recommendations);
@@ -72,6 +107,74 @@ class FocusAreaRecommender {
     return recommendations;
   }
 
+  /**
+   * Get git-blame insights for changed files
+   * Identifies hotspots (frequently changed files) and recent contributors
+   * @param {Array} changedFiles - List of changed file paths
+   * @returns {Object} Blame insights with hotspots and highlights
+   */
+  getGitBlameInsights(changedFiles = []) {
+    const insights = {
+      hotspots: [],
+      highlights: [],
+      contributors: new Map(),
+    };
+
+    if (changedFiles.length === 0) return insights;
+
+    for (const file of changedFiles.slice(0, 20)) {
+      try {
+        // Count commits touching this file in last 30 days
+        const commitCount = execSync(
+          `git log --oneline --since="30 days ago" -- "${file}" 2>/dev/null | wc -l`,
+          { encoding: 'utf8', timeout: 5000 },
+        ).trim();
+
+        const count = parseInt(commitCount, 10) || 0;
+
+        if (count >= 5) {
+          insights.hotspots.push({
+            file,
+            commits30d: count,
+            severity: count >= 10 ? 'critical' : 'high',
+          });
+        }
+
+        // Get unique contributors for this file
+        const authors = execSync(
+          `git log --format="%aN" --since="30 days ago" -- "${file}" 2>/dev/null | sort -u`,
+          { encoding: 'utf8', timeout: 5000 },
+        ).trim().split('\n').filter(Boolean);
+
+        for (const author of authors) {
+          insights.contributors.set(author, (insights.contributors.get(author) || 0) + 1);
+        }
+      } catch {
+        // Git not available or file not tracked — skip silently
+        continue;
+      }
+    }
+
+    // Sort hotspots by commit count
+    insights.hotspots.sort((a, b) => b.commits30d - a.commits30d);
+
+    // Generate highlights
+    if (insights.hotspots.length > 0) {
+      const topHotspot = insights.hotspots[0];
+      insights.highlights.push(
+        `Hotspot: ${topHotspot.file} changed ${topHotspot.commits30d}x in 30 days`,
+      );
+    }
+
+    if (insights.contributors.size > 1) {
+      insights.highlights.push(
+        `${insights.contributors.size} contributors touched these files recently`,
+      );
+    }
+
+    return insights;
+  }
+
   /**
    * Analyze changed files to determine focus areas
    * @param {Array} changedFiles - List of changed file paths

package/.sinapse-ai/data/entity-registry.yaml

@@ -1,6 +1,6 @@
 metadata:
   version: 1.0.0
-  lastUpdated: '2026-04-03T17:38:02.917Z'
+  lastUpdated: '2026-04-03T17:07:46.496Z'
   entityCount: 745
   checksumAlgorithm: sha256
   resolutionRate: 100
@@ -12988,8 +12988,8 @@ entities:
         score: 0.3
         constraints: []
         extensionPoints: []
-      checksum: sha256:27674e9afc69241626baceb6e64ecf48f1b0c7c34b5b07bf1daf5bc7cfa7a758
-      lastVerified: '2026-04-03T17:38:02.915Z'
+      checksum: sha256:7241d004f82a1fa583311f9ca0b1a4fc287227bcb66bc2f2973d628914a89433
+      lastVerified: '2026-04-03T07:16:38.860Z'
     sprint-lead:
       path: .sinapse-ai/development/agents/sprint-lead.md
       layer: L2

package/.sinapse-ai/data/registry-update-log.jsonl

@@ -611,3 +611,4 @@
 {"timestamp":"2026-04-03T15:13:09.088Z","action":"change","path":".sinapse-ai/data/sinapse-kb.md","trigger":"watcher"}
 {"timestamp":"2026-04-03T17:07:46.494Z","action":"change","path":".sinapse-ai/infrastructure/scripts/validate-codex-delegation.js","trigger":"watcher"}
 {"timestamp":"2026-04-03T17:38:02.915Z","action":"change","path":".sinapse-ai/development/agents/sinapse-orqx.md","trigger":"watcher"}
+{"timestamp":"2026-04-03T18:34:42.499Z","action":"change","path":".sinapse-ai/core/quality-gates/focus-area-recommender.js","trigger":"watcher"}

package/.sinapse-ai/development/agent-teams/team-all.yaml

@@ -3,9 +3,9 @@ bundle:
   icon: 👥
   description: Includes every core system agent.
 agents:
-  - sinapse-orchestrator
-  - sinapse-developer
-  - '*'
+  - sinapse-orqx        # Imperator — master orchestrator
+  - developer            # Pixel — code implementation
+  - '*'                  # All other agents
 workflows:
   - brownfield-fullstack.yaml
   - brownfield-service.yaml

package/.sinapse-ai/development/agent-teams/team-fullstack.yaml

@@ -3,12 +3,12 @@ bundle:
   icon: 🚀
   description: Team capable of full stack, front end only, or service development.
 agents:
-  - sinapse-orchestrator
-  - analyst
-  - pm
-  - ux-expert
-  - architect
-  - po
+  - sinapse-orqx         # Imperator — master orchestrator
+  - analyst              # Scope — research & analysis
+  - project-lead         # Beacon — epic orchestration
+  - ux-design-expert     # Mosaic — UX/UI design
+  - architect            # Stratum — architecture
+  - product-lead         # Axis — story validation
 workflows:
   - brownfield-fullstack.yaml
   - brownfield-service.yaml

package/.sinapse-ai/development/agent-teams/team-ide-minimal.yaml

@@ -3,8 +3,8 @@ bundle:
   icon: ⚡
   description: Only the bare minimum for the IDE PO SM dev qa cycle.
 agents:
-  - po
-  - sm
-  - dev
-  - qa
+  - product-lead         # Axis — story validation
+  - sprint-lead          # Sync — story creation
+  - developer            # Pixel — code implementation
+  - quality-gate         # Litmus — QA & testing
 workflows: null

package/.sinapse-ai/development/agent-teams/team-no-ui.yaml

@@ -3,11 +3,11 @@ bundle:
   icon: 🔧
   description: Team with no UX or UI Planning.
 agents:
-  - sinapse-orchestrator
-  - analyst
-  - pm
-  - architect
-  - po
+  - sinapse-orqx         # Imperator — master orchestrator
+  - analyst              # Scope — research & analysis
+  - project-lead         # Beacon — epic orchestration
+  - architect            # Stratum — architecture
+  - product-lead         # Axis — story validation
 workflows:
   - greenfield-service.yaml
   - brownfield-service.yaml

package/.sinapse-ai/development/agent-teams/team-qa-focused.yaml

@@ -4,9 +4,9 @@ bundle:
   description: Quality-focused team that orchestrates code review, testing, and deployment validation using CodeRabbit integration. Ideal for pre-PR reviews, deployment gates, and comprehensive quality assurance.
 
 agents:
-  - dev                # Pre-commit CodeRabbit reviews, development quality
-  - qa                 # Automated and manual QA, story validation
-  - github-devops      # PR quality gates, deployment safety checks
+  - developer          # Pixel — pre-commit CodeRabbit reviews, development quality
+  - quality-gate       # Litmus — automated and manual QA, story validation
+  - devops             # Pipeline — PR quality gates, deployment safety checks
 
 workflows:
   - code-quality-gate.yaml          # Unified quality validation (lint, tests, CodeRabbit)
@@ -31,13 +31,13 @@ purpose: |
      - Validate story acceptance criteria
      - Block completion on CRITICAL issues
 
-  3. **PR Phase** (@github-devops):
+  3. **PR Phase** (@devops):
      - Pre-PR quality gate (0 CRITICAL issues required)
      - Automated PR validation workflow
      - Lint + Tests + CodeRabbit scan
      - Generate comprehensive PR validation report
 
-  4. **Deployment Phase** (@github-devops):
+  4. **Deployment Phase** (@devops):
      - Deep security scan with CodeRabbit
      - Risk analysis and blocking issue detection
      - Environment configuration validation
@@ -133,16 +133,16 @@ usage_example: |
   → Validates acceptance criteria
   → Reports any quality gate failures
 
-  ## 3. PR Creation (by @github-devops)
+  ## 3. PR Creation (by @devops)
   "Create PR for this feature"
-  → @github-devops runs pr-validation workflow
+  → @devops runs pr-validation workflow
   → Checks: sync, CodeRabbit, lint, tests, coverage
   → Generates validation report
   → Creates PR with report link
 
-  ## 4. Deployment (by @github-devops)
+  ## 4. Deployment (by @devops)
   "Run deployment safety check for production"
-  → @github-devops runs deployment-safety-check workflow
+  → @devops runs deployment-safety-check workflow
   → Deep scan, risk analysis, env check, migrations, tests
   → Generates safety report with GO/NO-GO decision
   → Blocks if critical issues found

package/.sinapse-ai/install-manifest.yaml

@@ -7,10 +7,10 @@
 # - SHA256 hashes for change detection
 # - File types for categorization
 #
-version: 8.0.2
-generated_at: "2026-04-03T17:55:19.637Z"
+version: 9.1.0
+generated_at: "2026-04-03T18:36:11.847Z"
 generator: scripts/generate-install-manifest.js
-file_count: 1119
+file_count: 1120
 files:
   - path: cli/commands/config/index.js
     hash: sha256:66f111eceef0f60fa0a8904add783b615d55b01d5fe36408623c3dd828e702f6
@@ -112,10 +112,14 @@ files:
     hash: sha256:be706f637b3f54d882a8e1d3ee953a40c7ae7b94ca3bfcafdd4d6865d0526964
     type: cli
     size: 22145
+  - path: cli/commands/qa/audit.js
+    hash: sha256:e177f5eb9cbf3ce4b6decbc24b8c171633aa6cb8506d393a3d4b12d3cc475882
+    type: cli
+    size: 16661
   - path: cli/commands/qa/index.js
-    hash: sha256:db24334e2ca26537a9848c9a3bc0179a2c7a36686e411de1e35406a14df28a55
+    hash: sha256:6712a9c6ae3a2c76c09281a0a63d0f0acea4c2359c607554ef8cfcd2def5804f
     type: cli
-    size: 1528
+    size: 1891
   - path: cli/commands/qa/run.js
     hash: sha256:71877b9d4f1cd127eef2460a113176ed57a461b0f141b0a136106cff0d951f88
     type: cli
@@ -997,9 +1001,9 @@ files:
     type: core
     size: 9003
   - path: core/quality-gates/focus-area-recommender.js
-    hash: sha256:d15cc7f200c4a60405f324123f0b9dd29995eda23177499c2a5285777b664075
+    hash: sha256:4b2e7e432d2f491f339d30622c0f853b84bb4e6f4fa68876977c5c0807791f1a
     type: core
-    size: 10787
+    size: 14346
   - path: core/quality-gates/human-review-orchestrator.js
     hash: sha256:caa61d8bc776eaff9d49ad75daff92039db8c2c04a72595f038ab1b2482fec8b
     type: core
@@ -1237,7 +1241,7 @@ files:
     type: data
     size: 9586
   - path: data/entity-registry.yaml
-    hash: sha256:d2267093edc0e92ae5bb5cadaefa9e44ccd5d57d3395156d550e14bd335e6014
+    hash: sha256:92372ecd9b4c4450cabebb030021019ad3f561c7b7cafe93aac83dcde1d46b9f
     type: data
     size: 514640
   - path: data/learned-patterns.yaml
@@ -1321,25 +1325,25 @@ files:
     type: data
     size: 5355
   - path: development/agent-teams/team-all.yaml
-    hash: sha256:c0772af6353862cb57256a88aa046905d2ab8fca9b1a6816ff4886806ee0f8b9
+    hash: sha256:d97525ebf35bcddde38742e591e3f6a70fec87ba3eff48a92f474a9291fcced7
     type: development
-    size: 323
+    size: 429
   - path: development/agent-teams/team-fullstack.yaml
-    hash: sha256:e12e3e5437b2a3a1790e53ca921719269de96576ce0fd5ee0076f3fcb63f1e09
+    hash: sha256:be636a47d62b4c6dc47ba5a53bc6296caff74d613251c4f15be35ff13fcf55ab
     type: development
-    size: 387
+    size: 639
   - path: development/agent-teams/team-ide-minimal.yaml
-    hash: sha256:600b6795116fd74e66f3544679667fa4b6a546c88eaf5e30b6182b77ba341692
+    hash: sha256:ae1efa02a08e64fd095090704d9dc6a55a31d1a8745a9bbd79709626666efa24
     type: development
-    size: 167
+    size: 350
   - path: development/agent-teams/team-no-ui.yaml
-    hash: sha256:a842b1fc3bc95634930cba476d7e06302bae2ba00ef45f5dee5e161005b05c9a
+    hash: sha256:7f02daec22bdb1a59031ca343c5351f741cf948510fa73882ea5ae853ef790d2
     type: development
-    size: 227
+    size: 442
   - path: development/agent-teams/team-qa-focused.yaml
-    hash: sha256:702c60934a2fe01253e35dce21acbd1a3e35b6ca28ba3307e165f32e19e0c83d
+    hash: sha256:8ebf4dd8e791901c206b5368f39cbb55d21cc9e640698852c6e994e3256825c6
     type: development
-    size: 5066
+    size: 5058
   - path: development/agents/analyst.md
     hash: sha256:16b6bf39b1208f44be26384308beace1fbc6fadd32e43bf8854ce695e9aabf26
     type: agent

package/bin/sinapse.js

@@ -69,6 +69,10 @@ USAGE:
   sinapse validate                    # Validate installation integrity
   sinapse info                        # Show system info
   sinapse doctor                      # Run diagnostics
+  sinapse qa run                      # Run quality gate pipeline
+  sinapse qa run --layer=1            # Run specific layer
+  sinapse qa status                   # Show gate status
+  sinapse qa audit                    # Audit squad ecosystem quality
   sinapse --version                   # Show version
   sinapse --help                      # Show this help
 
@@ -1077,6 +1081,18 @@ async function main() {
       showHelp();
       break;
 
+    case 'qa': {
+      // Quality Gate Manager — sinapse qa run|status|audit
+      try {
+        const { run } = require('../.sinapse-ai/cli/index.js');
+        await run(process.argv);
+      } catch (error) {
+        console.error(`❌ QA command error: ${error.message}`);
+        process.exit(1);
+      }
+      break;
+    }
+
     case 'health': {
       // Framework health analytics
       const { runHealth } = require('../.sinapse-ai/cli/commands/health/index.js');

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "sinapse-ai",
-  "version": "8.0.2",
+  "version": "9.1.0",
   "description": "SINAPSE AI: Framework de orquestracao de IA — 18 squads, 175 agentes especializados",
   "bin": {
     "sinapse": "bin/sinapse.js",

package/scripts/audit-tasks.cjs

@@ -0,0 +1,256 @@
+/**
+ * SINAPSE Task Audit Script
+ * Audits all task markdown files across squads for structural compliance.
+ *
+ * Usage: node scripts/audit-tasks.cjs [--fix] [--json]
+ *   --fix   Add basic frontmatter to tasks missing it entirely
+ *   --json  Output raw JSON instead of summary
+ */
+
+const fs = require('fs');
+const path = require('path');
+const { glob } = require('glob');
+
+const ROOT = path.resolve(__dirname, '..');
+const SQUADS_DIR = path.join(ROOT, 'squads');
+const FIX_MODE = process.argv.includes('--fix');
+const JSON_MODE = process.argv.includes('--json');
+
+// ── Scoring weights ──────────────────────────────────────────────
+const CHECKS = [
+  { id: 'has_frontmatter',    weight: 20, label: 'Has YAML frontmatter' },
+  { id: 'has_task_field',     weight: 15, label: 'Frontmatter has task: field' },
+  { id: 'has_responsavel',    weight: 10, label: 'Frontmatter has responsavel/responsible' },
+  { id: 'has_entrada',        weight: 10, label: 'Frontmatter has Entrada/input' },
+  { id: 'has_saida',          weight: 10, label: 'Frontmatter has Saida/output' },
+  { id: 'has_title',          weight: 10, label: 'Has # Task: or # title' },
+  { id: 'has_steps',          weight: 10, label: 'Has ## Steps or ## Description' },
+  { id: 'has_metadata',       weight: 5,  label: 'Has ## Metadata section' },
+  { id: 'min_content_length', weight: 10, label: 'Content >= 200 chars' },
+];
+
+const MAX_SCORE = CHECKS.reduce((s, c) => s + c.weight, 0);
+
+// ── Parse frontmatter ────────────────────────────────────────────
+function parseFrontmatter(content) {
+  const match = content.match(/^---\r?\n([\s\S]*?)\r?\n---/);
+  if (!match) return null;
+  return match[1];
+}
+
+// ── Audit a single file ──────────────────────────────────────────
+function auditFile(filePath) {
+  const content = fs.readFileSync(filePath, 'utf-8');
+  const filename = path.basename(filePath, '.md');
+  const fm = parseFrontmatter(content);
+  const body = fm ? content.slice(content.indexOf('---', 3) + 3).trim() : content;
+
+  const results = {};
+  const issues = [];
+
+  // 1. Has frontmatter
+  results.has_frontmatter = !!fm;
+  if (!fm) issues.push('Missing frontmatter entirely');
+
+  // 2. task: field
+  results.has_task_field = fm ? /^task:/m.test(fm) : false;
+  if (!results.has_task_field && fm) issues.push('Missing task: field in frontmatter');
+
+  // 3. responsavel / responsible
+  results.has_responsavel = fm ? /^(responsavel|responsible):/m.test(fm) : false;
+  if (!results.has_responsavel && fm) issues.push('Missing responsavel/responsible field');
+
+  // 4. Entrada / input
+  results.has_entrada = fm ? /^(Entrada|input):/m.test(fm) : false;
+  if (!results.has_entrada && fm) issues.push('Missing Entrada/input section');
+
+  // 5. Saida / output
+  results.has_saida = fm ? /^(Saida|output):/m.test(fm) : false;
+  if (!results.has_saida && fm) issues.push('Missing Saida/output section');
+
+  // 6. Title
+  results.has_title = /^#\s+.+/m.test(body);
+  if (!results.has_title) issues.push('Missing # title in body');
+
+  // 7. Steps / Description
+  results.has_steps = /^##\s+(Steps|Description|Etapas)/mi.test(body);
+  if (!results.has_steps) issues.push('Missing ## Steps or ## Description');
+
+  // 8. Metadata
+  results.has_metadata = /^##\s+Metadata/mi.test(body);
+  if (!results.has_metadata) issues.push('Missing ## Metadata section');
+
+  // 9. Content length
+  results.min_content_length = content.length >= 200;
+  if (!results.min_content_length) issues.push(`Content too short (${content.length} chars)`);
+
+  // Score
+  let score = 0;
+  for (const check of CHECKS) {
+    if (results[check.id]) score += check.weight;
+  }
+  const pct = Math.round((score / MAX_SCORE) * 100);
+
+  return { file: filename, path: filePath, score: pct, results, issues };
+}
+
+// ── Fix: add frontmatter to files missing it ─────────────────────
+function fixFrontmatter(filePath) {
+  const content = fs.readFileSync(filePath, 'utf-8');
+  const filename = path.basename(filePath, '.md');
+
+  const frontmatter = [
+    '---',
+    `task: ${filename}`,
+    'responsavel: "TBD"',
+    'responsavel_type: Agent',
+    'atomic_layer: Task',
+    '---',
+    '',
+  ].join('\n');
+
+  fs.writeFileSync(filePath, frontmatter + content, 'utf-8');
+  return true;
+}
+
+// ── Main ─────────────────────────────────────────────────────────
+async function main() {
+  const pattern = path.join(SQUADS_DIR, '*/tasks/*.md').replace(/\\/g, '/');
+  const files = await glob(pattern);
+
+  if (files.length === 0) {
+    console.error('No task files found.');
+    process.exit(1);
+  }
+
+  const squadMap = {};
+  const allResults = [];
+  let fixedCount = 0;
+
+  for (const filePath of files) {
+    const rel = path.relative(SQUADS_DIR, filePath);
+    const squadName = rel.split(/[/\\]/)[0];
+
+    if (!squadMap[squadName]) {
+      squadMap[squadName] = { tasks: [], totalScore: 0, issues: [] };
+    }
+
+    // Fix mode: add frontmatter before auditing
+    if (FIX_MODE) {
+      const content = fs.readFileSync(filePath, 'utf-8');
+      if (!content.startsWith('---')) {
+        fixFrontmatter(filePath);
+        fixedCount++;
+      }
+    }
+
+    const result = auditFile(filePath);
+    squadMap[squadName].tasks.push(result);
+    squadMap[squadName].totalScore += result.score;
+    allResults.push(result);
+  }
+
+  // ── Build report ───────────────────────────────────────────────
+  const squadSummaries = [];
+  for (const [name, data] of Object.entries(squadMap).sort((a, b) => a[0].localeCompare(b[0]))) {
+    const avg = Math.round(data.totalScore / data.tasks.length);
+    const critical = data.tasks.filter(t => t.score < 50).length;
+    const warning = data.tasks.filter(t => t.score >= 50 && t.score < 70).length;
+    squadSummaries.push({
+      squad: name,
+      taskCount: data.tasks.length,
+      avgScore: avg,
+      critical,
+      warning,
+      passing: data.tasks.length - critical - warning,
+    });
+  }
+
+  // Issue frequency
+  const issueFreq = {};
+  for (const r of allResults) {
+    for (const iss of r.issues) {
+      issueFreq[iss] = (issueFreq[iss] || 0) + 1;
+    }
+  }
+  const commonIssues = Object.entries(issueFreq)
+    .sort((a, b) => b[1] - a[1])
+    .map(([issue, count]) => ({ issue, count, pct: Math.round((count / allResults.length) * 100) }));
+
+  const overallAvg = Math.round(allResults.reduce((s, r) => s + r.score, 0) / allResults.length);
+  const problemFiles = allResults.filter(r => r.score < 70).sort((a, b) => a.score - b.score);
+
+  const report = {
+    summary: {
+      totalFiles: allResults.length,
+      totalSquads: squadSummaries.length,
+      overallAvgScore: overallAvg,
+      passingFiles: allResults.filter(r => r.score >= 70).length,
+      warningFiles: allResults.filter(r => r.score >= 50 && r.score < 70).length,
+      criticalFiles: allResults.filter(r => r.score < 50).length,
+      fixedInThisRun: fixedCount,
+    },
+    squadSummaries,
+    commonIssues,
+    problemFiles: problemFiles.map(f => ({
+      file: f.file,
+      squad: path.relative(SQUADS_DIR, f.path).split(/[/\\]/)[0],
+      score: f.score,
+      issues: f.issues,
+    })),
+  };
+
+  if (JSON_MODE) {
+    console.log(JSON.stringify(report, null, 2));
+  } else {
+    // Human-readable output
+    console.log('\n=== SINAPSE Task Audit Report ===\n');
+    console.log(`Total files: ${report.summary.totalFiles}`);
+    console.log(`Total squads: ${report.summary.totalSquads}`);
+    console.log(`Overall avg score: ${report.summary.overallAvgScore}%`);
+    console.log(`Passing (>=70): ${report.summary.passingFiles}`);
+    console.log(`Warning (50-69): ${report.summary.warningFiles}`);
+    console.log(`Critical (<50): ${report.summary.criticalFiles}`);
+    if (fixedCount > 0) console.log(`Fixed (frontmatter added): ${fixedCount}`);
+
+    console.log('\n--- Squad Summary ---\n');
+    console.log('Squad'.padEnd(30) + 'Tasks'.padEnd(8) + 'Avg'.padEnd(6) + 'Crit'.padEnd(6) + 'Warn'.padEnd(6) + 'Pass');
+    console.log('-'.repeat(62));
+    for (const s of squadSummaries) {
+      console.log(
+        s.squad.padEnd(30) +
+        String(s.taskCount).padEnd(8) +
+        `${s.avgScore}%`.padEnd(6) +
+        String(s.critical).padEnd(6) +
+        String(s.warning).padEnd(6) +
+        String(s.passing)
+      );
+    }
+
+    console.log('\n--- Common Issues ---\n');
+    for (const iss of commonIssues) {
+      console.log(`  ${iss.count} files (${iss.pct}%) — ${iss.issue}`);
+    }
+
+    if (problemFiles.length > 0) {
+      console.log(`\n--- Problem Files (score < 70): ${problemFiles.length} files ---\n`);
+      for (const f of problemFiles.slice(0, 50)) {
+        const squad = path.relative(SQUADS_DIR, f.path).split(/[/\\]/)[0];
+        console.log(`  [${f.score}%] ${squad}/${f.file}: ${f.issues.join('; ')}`);
+      }
+      if (problemFiles.length > 50) {
+        console.log(`  ... and ${problemFiles.length - 50} more`);
+      }
+    }
+  }
+
+  // Write JSON for report generation
+  const jsonPath = path.join(ROOT, 'docs', 'reports', '9.3-task-audit.json');
+  fs.writeFileSync(jsonPath, JSON.stringify(report, null, 2), 'utf-8');
+  console.log(`\nJSON saved to: ${jsonPath}`);
+}
+
+main().catch(err => {
+  console.error('Audit failed:', err);
+  process.exit(1);
+});

package/squads/claude-code-mastery/tasks/audit-integration.md

@@ -1,3 +1,9 @@
+---
+task: audit-integration
+responsavel: "TBD"
+responsavel_type: Agent
+atomic_layer: Task
+---
 # Task: Audit Existing Claude Code Integration
 
 **Task ID:** CCM-PI-002