avorelo 0.3.8 → 0.4.0-rc.2

package/scripts/cco-dashboard.js

@@ -0,0 +1,346 @@
+"use strict";
+
+const { buildStatusDashboard, buildEffectivenessScorecard } = require("./lib/dashboard");
+const { buildPlanSurface } = require("./lib/plan-surface");
+const { normalizeDashboardForPlatform, normalizePlatform } = require("./lib/adapter-conformance");
+const { formatProductHomeStatusLine } = require("./lib/product-home-receipt");
+const { formatAgentActivationStatusLine } = require("./lib/agent-activation-readiness");
+const {
+  buildCompactProMomentLines,
+  buildProMomentSurface,
+  recordProMomentEvaluation,
+} = require("./lib/pro-moments");
+
+function optionalRequire(modulePath, fallback) {
+  try {
+    return require(modulePath);
+  } catch {
+    return fallback;
+  }
+}
+
+const { ValueLedger, buildValueLedgerSummary } = optionalRequire("./lib/value-ledger", {
+  ValueLedger: class {
+    loadAll() {
+      return [];
+    }
+  },
+  buildValueLedgerSummary: () => null,
+});
+const { buildActivationSummary, formatActivationStatusLine } = optionalRequire("./lib/activation/activation-summary", {
+  buildActivationSummary: () => null,
+  formatActivationStatusLine: () => "Activation: local status surface unavailable",
+});
+const { readWorkspaceMap } = optionalRequire("./lib/workspace-map", {
+  readWorkspaceMap: () => null,
+});
+const { summarizeLatestLearningSignals } = optionalRequire("./lib/product-learning-events", {
+  summarizeLatestLearningSignals: () => null,
+});
+
+const args = process.argv.slice(2);
+const JSON_MODE = args.includes("--json");
+const TEXT_MODE = !JSON_MODE;
+
+function readPlatformArg(argv) {
+  const arg = argv.find((a) => a.startsWith("--platform="));
+  if (!arg) return "claude";
+  return normalizePlatform(arg.split("=")[1]);
+}
+
+function formatBoundedDashboard(dash) {
+  const planSurface = buildPlanSurface(dash.cwd || process.cwd());
+  const proMoment = dash?.proMoment || buildProMomentSurface(dash.cwd || process.cwd(), {
+    surface: "dashboard",
+    status: dash,
+  });
+  const workspaceMap = readWorkspaceMap(dash.cwd || process.cwd());
+  const productLearning = summarizeLatestLearningSignals(dash.cwd || process.cwd());
+  const planSecurityLine = planSurface.security
+    ? [`Plan security: ${planSurface.security.postureLine.replace(/^Security posture:\s*/i, "")}`]
+    : [];
+  const productHomeLine = dash.productHome
+    ? [formatProductHomeStatusLine(dash.productHome)]
+    : [];
+  const agentReadinessLine = dash.agentReadiness
+    ? [formatAgentActivationStatusLine(dash.agentReadiness)]
+    : [];
+  const browserCapabilityLine = dash.browserCapability?.showInDashboard
+    ? [`Browser capability: ${dash.browserCapability.overallTier} — ${dash.browserCapability.summary}`]
+    : [];
+  const safeRepairLine = dash.safeRepair?.showInDashboard
+    ? [dash.safeRepair.statusLine]
+    : [];
+  const governanceLine = dash.agentAccessGovernance?.showInDashboard
+    ? [`Agent Access Governance: ${String(dash.agentAccessGovernance.status || "partial").toUpperCase()} - reviewed=${dash.agentAccessGovernance.subjectsReviewed} - unknown=${dash.agentAccessGovernance.unknownSubjects} - latest receipt ${dash.agentAccessGovernance.latestReceiptPath ? "available" : "missing"}`]
+    : [];
+  const safePathLine = dash.safePath?.showInDashboard
+    ? [`Safe Path: ${String(dash.safePath.status || "foundation").toUpperCase()} - last=${dash.safePath.lastDecision || "none"} - reductions=${dash.safePath.reductionsRecommended} - approvals=${dash.safePath.approvalsRequired} - blocks-preserved=${dash.safePath.blocksPreserved}`]
+    : [];
+  const intakeLine = dash.installIntakeRisk?.showInDashboard
+    ? [`Install Intake: ${String(dash.installIntakeRisk.status || "foundation").toUpperCase()} - items=${dash.installIntakeRisk.totalItems} - unknown=${dash.installIntakeRisk.unknownItems} - high=${dash.installIntakeRisk.highRiskItems} - latest receipt ${dash.installIntakeRisk.latestReceiptPath ? "available" : "missing"}`]
+    : [];
+  const capabilityIntakeLine = dash.capabilityIntake?.showInDashboard
+    ? [dash.capabilityIntake.statusLine]
+    : [];
+  const skillsLine = dash.skillsOperatingLayer?.showInDashboard
+    ? [`Skills Operating Layer: ${String(dash.skillsOperatingLayer.status || "foundation").toUpperCase()} - reviewed=${dash.skillsOperatingLayer.reviewedSources} - deferred=${dash.skillsOperatingLayer.deferredSources} - parsed=${dash.skillsOperatingLayer.parsedSkills} - latest receipt ${dash.skillsOperatingLayer.latestSourceAdoptionReceiptPath ? "available" : "missing"}`]
+    : [];
+  const governedActionExposureLine = dash.governedActionExposure?.showInDashboard
+    ? [dash.governedActionExposure.statusLine]
+    : [];
+  const governedWorkspaceHygieneLine = dash.governedWorkspaceHygiene?.showInDashboard
+    ? [dash.governedWorkspaceHygiene.statusLine]
+    : [];
+  const learningExperimentationLine = dash.learningExperimentation?.showInDashboard
+    ? [dash.learningExperimentation.statusLine]
+    : [];
+  const browserProofWorkflowLine = dash.browserProofWorkflow?.showInDashboard
+    ? [dash.browserProofWorkflow.statusLine]
+    : [];
+  const nextRunContinuityLine = dash.nextRunContinuity?.showInDashboard
+    ? [dash.nextRunContinuity.statusLine]
+    : [];
+  const dataPermissionsLine = dash.dataPermissions?.showInDashboard
+    ? [dash.dataPermissions.statusLine]
+    : [];
+  const deploymentEnvironmentLine = dash.deploymentEnvironment?.showInDashboard
+    ? [dash.deploymentEnvironment.statusLine]
+    : [];
+  const supplyChainDependencyLine = dash.supplyChainDependency?.showInDashboard
+    ? [dash.supplyChainDependency.statusLine]
+    : [];
+  const scopeRepairLine = dash.scopeRepair?.showInDashboard
+    ? [dash.scopeRepair.statusLine]
+    : [];
+  const orchestrationLine = dash.orchestration?.showInStatus
+    ? [dash.orchestration.statusLine]
+    : [];
+  const outcomeEvidenceLine = dash.outcomeEvidence?.showInDashboard
+    ? [dash.outcomeEvidence.statusLine]
+    : [];
+  const productionConfidenceLine = dash.productionConfidence?.showInDashboard
+    ? [dash.productionConfidence.statusLine]
+    : [];
+  const valueSignalsLine = dash.valueSignals?.showInDashboard
+    ? [dash.valueSignals.statusLine]
+    : [];
+  const workspaceMapLine = workspaceMap
+    ? [`Workspace Map: ${workspaceMap.status} - ${workspaceMap.topGaps[0] || "ready for compact navigation"}`]
+    : [];
+  const productLearningLine = productLearning?.totalEvents
+    ? [`Product learning: ${productLearning.totalEvents} local event(s) recorded.`]
+    : [];
+  const proMomentLines = buildCompactProMomentLines(proMoment);
+  const runImprovementsLine = (() => {
+    try {
+      const { formatRunImprovementsStatusLine } = require("./lib/run-improvements");
+      const line = formatRunImprovementsStatusLine(dash.cwd || process.cwd());
+      return line ? [line] : [];
+    } catch { return []; }
+  })();
+  let agentSecurityLine = [];
+  if (dash.agentSecurity?.showInDashboard && dash.agentSecurity?.productSummary) {
+    const summary = dash.agentSecurity.productSummary;
+    agentSecurityLine = [
+      `Agent security: ${summary.headline}${summary.summary ? ` - ${summary.summary}` : ""}`,
+    ];
+  } else if (dash.agentSecurity?.showInDashboard && dash.agentSecurity?.dashboardCard) {
+    const card = dash.agentSecurity.dashboardCard;
+    if (dash.agentSecurity.mode === "warn") {
+      agentSecurityLine = [
+        `Agent security: ${card.subtitle} - ${card.surfaceLabel} - ${card.changeLabel}${card.enforcementLabel ? ` - ${card.enforcementLabel}` : ""}`,
+      ];
+    } else if (dash.agentSecurity.mode === "auto") {
+      agentSecurityLine = [
+        `Agent security: ${card.subtitle}${card.enforcementLabel ? ` - ${card.enforcementLabel}` : ""}`,
+      ];
+    } else if (dash.agentSecurity.mode === "visibility") {
+      agentSecurityLine = [
+        `Agent security: ${card.subtitle} - ${card.surfaceLabel} - ${card.changeLabel}`,
+      ];
+    } else {
+      agentSecurityLine = [
+        `Agent security: ${card.checkedLabel} - ${card.newLabel} - ${card.riskLabel}`,
+      ];
+    }
+  }
+  return [
+    "Avorelo Dashboard",
+    `Plan: ${planSurface.planLabel}`,
+    ...(planSurface.overrideNote ? [planSurface.overrideNote] : []),
+    planSurface.includedLine,
+    `Platform: ${dash.platform} Profile: ${dash.tier}`,
+    `Focus: ${dash.what} ${dash.why}`,
+    formatActivationStatusLine(dash.activation || buildActivationSummary(dash.cwd || process.cwd())),
+    ...agentReadinessLine,
+    ...productHomeLine,
+    ...planSecurityLine,
+    ...agentSecurityLine,
+    ...governanceLine,
+    ...safePathLine,
+    ...intakeLine,
+    ...capabilityIntakeLine,
+    ...skillsLine,
+    ...governedActionExposureLine,
+    ...governedWorkspaceHygieneLine,
+    ...learningExperimentationLine,
+    ...browserCapabilityLine,
+    ...browserProofWorkflowLine,
+    ...safeRepairLine,
+    ...scopeRepairLine,
+    ...nextRunContinuityLine,
+    ...dataPermissionsLine,
+    ...deploymentEnvironmentLine,
+    ...supplyChainDependencyLine,
+    ...orchestrationLine,
+    ...outcomeEvidenceLine,
+    ...productionConfidenceLine,
+    ...valueSignalsLine,
+    ...proMomentLines,
+    ...workspaceMapLine,
+    ...productLearningLine,
+    ...runImprovementsLine,
+    "Top fixes:",
+    ...(dash.topFixesNow || []).map((f, i) => `${i + 1}. ${f.text || f}`),
+    `Next: ${dash.nextBestAction} Savings: ~${dash.benefitSummary?.minutesSavedEstimate || 0}min`,
+  ].join("\n").trim();
+}
+
+function buildDashboardJson(dashboard, platform, cwd) {
+  const resolvedCwd = dashboard?.cwd || cwd;
+  const planSurface = buildPlanSurface(resolvedCwd);
+  const proMoment = dashboard?.proMoment || buildProMomentSurface(resolvedCwd, {
+    surface: "dashboard",
+    status: dashboard,
+  });
+  let valueLedger = null;
+  try {
+    const ledger = new ValueLedger(resolvedCwd);
+    const events = ledger.loadAll();
+    valueLedger = buildValueLedgerSummary(events);
+  } catch {}
+  const out = {
+    title: "Avorelo Dashboard",
+    cwd: resolvedCwd,
+    platform,
+    what: "Quick view of optimization opportunities.",
+    why: "See Time, Risk, Cost impact and clear next steps.",
+    planSummary: planSurface,
+    securitySummary: planSurface.security || null,
+    proMoment,
+    summaryFraming: dashboard.teamRollup?.summaryFraming || "Time + Risk + Cost dashboard.",
+    tier: dashboard.tier,
+    benefitSummary: dashboard.benefitSummary || null,
+    memorySummary: dashboard.memorySummary || null,
+    contextBudgetPlan: dashboard.contextBudgetPlan || null,
+    weeklySummary: dashboard.weeklySummary || null,
+    nextBestAction: dashboard.nextBestAction || "",
+    topRecommendedFixes: dashboard.topRecommendedFixes || [],
+    topFixesNow: (dashboard.topRecommendedFixes || []).slice(0, 3),
+    teamDefaultsApplied: dashboard.teamDefaultsApplied || null,
+    teamRollup: dashboard.teamRollup || null,
+    settingsControls: dashboard.settingsControls || null,
+    activation: dashboard.activation || buildActivationSummary(resolvedCwd),
+    agentReadiness: dashboard.agentReadiness || null,
+    productHome: dashboard.productHome || null,
+    workspaceMap: readWorkspaceMap(resolvedCwd),
+    productLearning: summarizeLatestLearningSignals(resolvedCwd),
+    valueLedger,
+    ...(dashboard.agentSecurity ? { agentSecurity: dashboard.agentSecurity } : {}),
+    ...(dashboard.agentAccessGovernance ? { agentAccessGovernance: dashboard.agentAccessGovernance } : {}),
+    ...(dashboard.safePath ? { safePath: dashboard.safePath } : {}),
+    ...(dashboard.installIntakeRisk ? { installIntakeRisk: dashboard.installIntakeRisk } : {}),
+    ...(dashboard.capabilityIntake ? { capabilityIntake: dashboard.capabilityIntake } : {}),
+    ...(dashboard.skillsOperatingLayer ? { skillsOperatingLayer: dashboard.skillsOperatingLayer } : {}),
+    ...(dashboard.governedActionExposure ? { governedActionExposure: dashboard.governedActionExposure } : {}),
+    ...(dashboard.governedWorkspaceHygiene ? { governedWorkspaceHygiene: dashboard.governedWorkspaceHygiene } : {}),
+    ...(dashboard.learningExperimentation ? { learningExperimentation: dashboard.learningExperimentation } : {}),
+    ...(dashboard.browserCapability ? { browserCapability: dashboard.browserCapability } : {}),
+    ...(dashboard.browserProofWorkflow ? { browserProofWorkflow: dashboard.browserProofWorkflow } : {}),
+    ...(dashboard.safeRepair ? { safeRepair: dashboard.safeRepair } : {}),
+    ...(dashboard.scopeRepair ? { scopeRepair: dashboard.scopeRepair } : {}),
+    ...(dashboard.nextRunContinuity ? { nextRunContinuity: dashboard.nextRunContinuity } : {}),
+    ...(dashboard.dataPermissions ? { dataPermissions: dashboard.dataPermissions } : {}),
+    ...(dashboard.deploymentEnvironment ? { deploymentEnvironment: dashboard.deploymentEnvironment } : {}),
+    ...(dashboard.supplyChainDependency ? { supplyChainDependency: dashboard.supplyChainDependency } : {}),
+    ...(dashboard.orchestration ? { orchestration: dashboard.orchestration } : {}),
+    ...(dashboard.outcomeEvidence ? { outcomeEvidence: dashboard.outcomeEvidence } : {}),
+    ...(dashboard.productionConfidence ? { productionConfidence: dashboard.productionConfidence } : {}),
+    ...(dashboard.valueSignals ? { valueSignals: dashboard.valueSignals } : {}),
+    operatingValue: dashboard.operatingValue || null,
+    effectivenessScorecard: null,
+    runImprovements: (() => {
+      try {
+        const { loadRunImprovements } = require("./lib/run-improvements");
+        return loadRunImprovements(resolvedCwd);
+      } catch { return null; }
+    })(),
+  };
+  try {
+    out.effectivenessScorecard = buildEffectivenessScorecard(resolvedCwd, { days: 7 });
+  } catch {
+    out.effectivenessScorecard = { error: "Could not compute scorecard." };
+  }
+  return out;
+}
+
+function main() {
+  const cwd = process.cwd();
+  const platform = readPlatformArg(process.argv.slice(2));
+  const dashboard = buildStatusDashboard(cwd, { limit: 7 });
+  normalizeDashboardForPlatform(platform, dashboard);
+  dashboard.proMoment = buildProMomentSurface(cwd, {
+    surface: "dashboard",
+    status: dashboard,
+  });
+
+  if (TEXT_MODE) {
+    const out = {
+      cwd,
+      platform,
+      tier: dashboard.tier,
+      what: "Quick view of optimization opportunities.",
+      why: "See Time, Risk, Cost impact and clear next steps.",
+      nextBestAction: dashboard.nextBestAction,
+      topFixesNow: (dashboard.topRecommendedFixes || []).slice(0, 3),
+      benefitSummary: dashboard.benefitSummary,
+      agentReadiness: dashboard.agentReadiness || null,
+      productHome: dashboard.productHome || null,
+      activation: dashboard.activation || buildActivationSummary(cwd),
+      agentSecurity: dashboard.agentSecurity || null,
+      agentAccessGovernance: dashboard.agentAccessGovernance || null,
+      safePath: dashboard.safePath || null,
+      installIntakeRisk: dashboard.installIntakeRisk || null,
+      capabilityIntake: dashboard.capabilityIntake || null,
+      skillsOperatingLayer: dashboard.skillsOperatingLayer || null,
+      governedActionExposure: dashboard.governedActionExposure || null,
+      governedWorkspaceHygiene: dashboard.governedWorkspaceHygiene || null,
+      browserCapability: dashboard.browserCapability || null,
+      nextRunContinuity: dashboard.nextRunContinuity || null,
+      dataPermissions: dashboard.dataPermissions || null,
+      deploymentEnvironment: dashboard.deploymentEnvironment || null,
+      supplyChainDependency: dashboard.supplyChainDependency || null,
+      orchestration: dashboard.orchestration || null,
+      outcomeEvidence: dashboard.outcomeEvidence || null,
+      productionConfidence: dashboard.productionConfidence || null,
+      valueSignals: dashboard.valueSignals || null,
+      settingsControls: dashboard.settingsControls || null,
+      proMoment: dashboard.proMoment,
+    };
+    process.stdout.write(formatBoundedDashboard(out));
+    recordProMomentEvaluation(cwd, dashboard.proMoment, { humanVisible: true });
+  } else {
+    process.stdout.write(JSON.stringify(buildDashboardJson(dashboard, platform, cwd)));
+    recordProMomentEvaluation(cwd, dashboard.proMoment, { humanVisible: false });
+  }
+}
+
+if (require.main === module) {
+  main();
+}
+
+module.exports = {
+  buildDashboardJson,
+  formatBoundedDashboard,
+};