avorelo 0.1.0

package/scripts/lib/visual-qa.js

@@ -0,0 +1,231 @@
+"use strict";
+
+const fs = require("fs");
+const path = require("path");
+const { nowIso, ensureCcoDirs, safeWriteJson } = require("./fsx");
+const { getCurrentPlan, capabilityEnabled } = require("./entitlements");
+const { getQuotaStatus, consumeQuota } = require("./usage-ledger");
+const { evaluateAgentAction } = require("./agent-enforcement");
+
+const VISUAL_QA_REPORT_REL_PATH = ".claude/cco/reports/visual-qa-latest.json";
+
+function exists(cwd, relPath) {
+  return fs.existsSync(path.join(cwd, relPath));
+}
+
+function detectVisualQaRunner(cwd) {
+  const landingSpec = "e2e-tests/tests/landingPageVisualQA.spec.ts";
+  const landingConfig = "e2e-tests/playwright.landing-qa.config.ts";
+  const artifactsDir = "artifacts/landing-page-review";
+  const available = exists(cwd, landingSpec) && exists(cwd, landingConfig);
+  return {
+    available,
+    targets: available ? ["landing_page"] : [],
+    defaultTarget: available ? "landing_page" : null,
+    command: available
+      ? `npx playwright test ${landingSpec} -c ${landingConfig}`
+      : null,
+    artifactsDir: exists(cwd, artifactsDir) ? artifactsDir : null,
+  };
+}
+
+function countScreenshots(cwd, artifactsDir) {
+  if (!artifactsDir) return 0;
+  const absDir = path.join(cwd, artifactsDir);
+  if (!fs.existsSync(absDir)) return 0;
+  let count = 0;
+
+  function walk(absPath) {
+    const entries = fs.readdirSync(absPath, { withFileTypes: true });
+    entries.forEach((entry) => {
+      const next = path.join(absPath, entry.name);
+      if (entry.isDirectory()) {
+        walk(next);
+        return;
+      }
+      if (entry.isFile() && /\.(png|jpg|jpeg|webp)$/i.test(entry.name)) {
+        count += 1;
+      }
+    });
+  }
+
+  walk(absDir);
+  return count;
+}
+
+function buildVisualQaSurface(cwd, options = {}) {
+  const plan = options.plan || getCurrentPlan({ cwd });
+  const runner = detectVisualQaRunner(cwd);
+  const capabilityId = plan === "pro" ? "visual_qa_advanced" : "visual_qa_weekly";
+  const quota = getQuotaStatus(cwd, "visual_qa_weekly", { plan });
+  const evidencePath = path.join(cwd, VISUAL_QA_REPORT_REL_PATH);
+  let latestEvidence = null;
+  let evidenceWarning = null;
+  if (fs.existsSync(evidencePath)) {
+    try {
+      latestEvidence = JSON.parse(fs.readFileSync(evidencePath, "utf8"));
+    } catch (error) {
+      evidenceWarning = `Latest Visual QA report is unreadable: ${error.message}`;
+    }
+  }
+
+  return {
+    plan,
+    capabilityId,
+    enabled: capabilityEnabled(capabilityId, { cwd, plan }),
+    runner,
+    quota,
+    latestEvidence,
+    evidenceWarning,
+    summary: runner.available
+      ? `Visual QA is available locally${quota.tracked ? ` (${quota.used}/${quota.limit} ${quota.period} used)` : ""}.`
+      : "Visual QA wrapper is present, but no local screenshot runner is configured in this repo.",
+  };
+}
+
+function writeVisualQaReport(cwd, report) {
+  ensureCcoDirs(cwd);
+  safeWriteJson(cwd, VISUAL_QA_REPORT_REL_PATH, report);
+}
+
+function evaluateVisualQaTarget(cwd, options = {}) {
+  const target = String(options.target || "").trim();
+  const url = /^https?:\/\//i.test(target)
+    ? target
+    : /^(localhost|127\.0\.0\.1|::1)(:\d+)?(\/|$)/i.test(target)
+      ? `http://${target}`
+      : "http://localhost";
+
+  return evaluateAgentAction({
+    actionType: "visual_qa_run",
+    requestedBy: "visual_qa",
+    taskType: "qa_visual",
+    userIntent: options.task || "check local visual changes",
+    target: url,
+    url,
+    domain: (() => {
+      try { return new URL(url).hostname; } catch { return null; }
+    })(),
+    domainBoundaryReady: options.domainBoundaryReady === true,
+    runnerAvailable: options.runnerAvailable,
+    plan: options.plan,
+  }, {
+    cwd,
+    writeEvidence: options.writeEvidence,
+    source: "visual_qa",
+  });
+}
+
+function runVisualQa(cwd, options = {}) {
+  const plan = options.plan || getCurrentPlan({ cwd });
+  if (!capabilityEnabled("visual_qa_weekly", { cwd, plan })) {
+    return {
+      ok: false,
+      what: "Visual QA is not enabled for the current plan.",
+      plan,
+    };
+  }
+
+  const runner = detectVisualQaRunner(cwd);
+  const guardDecision = evaluateVisualQaTarget(cwd, {
+    target: options.target || (runner.available ? "http://localhost" : "http://localhost"),
+    plan,
+    runnerAvailable: runner.available,
+    writeEvidence: options.writeEvidence !== false,
+  });
+  if (guardDecision.decision === "block") {
+    return {
+      ok: false,
+      what: `Visual QA blocked: ${guardDecision.explanation}`,
+      nextAction: guardDecision.saferAlternative,
+      plan,
+      guardDecision,
+    };
+  }
+  if (guardDecision.decision === "approval_required") {
+    return {
+      ok: false,
+      what: `Visual QA needs approval: ${guardDecision.explanation}`,
+      nextAction: guardDecision.saferAlternative,
+      plan,
+      guardDecision,
+    };
+  }
+  if (!runner.available) {
+    return {
+      ok: false,
+      what: "Visual QA runner is not configured locally in this repo.",
+      nextAction: "Add or enable the local Playwright-based screenshot harness before running Visual QA.",
+      plan,
+      runner,
+      guardDecision,
+    };
+  }
+
+  const quota = getQuotaStatus(cwd, "visual_qa_weekly", { plan });
+  if (!quota.allowed) {
+    return {
+      ok: false,
+      what: "Visual QA quota is exhausted for the current window.",
+      quota,
+      nextAction: "Wait for the quota window to reset or switch to Pro for a higher local quota.",
+      plan,
+    };
+  }
+
+  if (options.dryRun === true) {
+    return {
+      ok: true,
+      dryRun: true,
+      plan,
+      target: options.target || runner.defaultTarget,
+      checkedSurface: "Landing page visual QA flow",
+      screenshotsCaptured: false,
+      evidenceStoredAt: runner.artifactsDir,
+      nextAction: "Run without --dry-run to execute the local screenshot-backed flow.",
+      command: runner.command,
+      quota,
+      guardDecision,
+    };
+  }
+
+  const executor = options.executor || ((command) => ({ exitCode: 0, stdout: command, stderr: "" }));
+  const beforeCount = countScreenshots(cwd, runner.artifactsDir);
+  const result = executor(runner.command, { cwd });
+  const afterCount = countScreenshots(cwd, runner.artifactsDir);
+  const captured = Math.max(0, afterCount - beforeCount);
+  const usage = consumeQuota(cwd, "visual_qa_weekly", { plan });
+
+  const report = {
+    generatedAt: nowIso(),
+    plan,
+    target: options.target || runner.defaultTarget,
+    checkedSurface: "Landing page visual QA flow",
+    screenshotsCaptured: captured > 0,
+    screenshotCount: captured,
+    evidenceStoredAt: runner.artifactsDir,
+    lookedBrokenOrRisky: result.exitCode === 0 ? [] : ["Visual QA command failed. Review the local runner output."],
+    nextAction: result.exitCode === 0
+      ? "Review the latest screenshots and fix any visual or flow regressions that remain."
+      : "Review the local Visual QA command output and fix the runner or the page under test.",
+    command: runner.command,
+    stdoutPreview: String(result.stdout || "").slice(0, 240),
+    stderrPreview: String(result.stderr || "").slice(0, 240),
+    quota: usage,
+    guardDecision,
+  };
+
+  writeVisualQaReport(cwd, report);
+  return {
+    ok: result.exitCode === 0,
+    ...report,
+  };
+}
+
+module.exports = {
+  VISUAL_QA_REPORT_REL_PATH,
+  detectVisualQaRunner,
+  evaluateVisualQaTarget,
+  buildVisualQaSurface,
+  runVisualQa,
+};

package/scripts/lib/voice-alpha.js

@@ -0,0 +1,29 @@
+"use strict";
+
+const fs = require("fs");
+const path = require("path");
+
+function mapIntentToCommand(transcript) {
+  const t = String(transcript || "").toLowerCase();
+
+  if (/status|dashboard|benefit/.test(t)) return { command: "/cco-dashboard", confidence: 0.88, mode: "low-risk" };
+  if (/settings|profile|security mode/.test(t)) return { command: "/cco-settings", confidence: 0.82, mode: "low-risk" };
+  if (/audit|scan|security/.test(t)) return { command: "/cco-audit", confidence: 0.86, mode: "medium-risk" };
+  if (/optimize|cost|tokens|compact/.test(t)) return { command: "/cco-optimize", confidence: 0.84, mode: "low-risk" };
+  if (/batch|queue/.test(t)) return { command: "/cco-batch", confidence: 0.78, mode: "low-risk" };
+
+  return { command: "/cco-status", confidence: 0.55, mode: "low-risk" };
+}
+
+function recordVoiceEvent(cwd, record) {
+  const rel = ".claude/cco/voice/records.jsonl";
+  const abs = path.join(cwd, rel);
+  fs.mkdirSync(path.dirname(abs), { recursive: true });
+  fs.appendFileSync(abs, JSON.stringify(record) + "\n", "utf8");
+  return rel;
+}
+
+module.exports = {
+  mapIntentToCommand,
+  recordVoiceEvent,
+};