avorelo 0.1.0

package/scripts/lib/status-value-summary.js

@@ -0,0 +1,32 @@
+#!/usr/bin/env node
+// Thin deterministic value-summary builder for cco-status
+// Local-first, bounded, no ML, no remote
+"use strict";
+
+const path = require("path");
+const fs = require("fs");
+
+/**
+ * Build deterministic value-summary from available evidence signals
+ * Given current status snapshot, returns single-line summary of bounded work/value
+ * @param {object} status - snapshot from buildStatusDashboard
+ * @returns {string} deterministic summary (50 chars max)
+ */
+function buildValueSummary(status) {
+  // Available signals from dashboard:
+  // - status.tier (free/pro/teams)
+  // - status.profile (terse/standard/deep)
+  // - status.topRecommendedFixes (array, 0-3 items)
+  // - status.benefitSummary?.minutesSavedEstimate (number or 0)
+  // - status.nextBestAction (string or null)
+  const fixCount = (status.topRecommendedFixes || []).length;
+  const minutes = status.benefitSummary?.minutesSavedEstimate || 0;
+  const next = status.nextBestAction || "Pending";
+  const profile = status.profile || "standard";
+
+  // Deterministic bounded summary (max ~50 chars):
+  // "Avorelo: 3 fixes (~8 min), next: Run tests, profile: standard"
+  return `Avorelo: ${fixCount} fix${fixCount !== 1 ? "es" : ""} (~${minutes} min), next: ${next}, profile: ${profile}`;
+}
+
+module.exports = { buildValueSummary };

package/scripts/lib/support-bundle.js

@@ -0,0 +1,578 @@
+"use strict";
+
+// ── Support Bundle ────────────────────────────────────────────────────────────
+//
+// Contract: avorelo.supportBundle.v1
+//
+// Generates a redacted support/debug bundle for alpha users and support.
+// Includes references/summaries from existing artifacts — no raw code,
+// prompts, secrets, PII, or config dumps.
+
+const fs = require("fs");
+const path = require("path");
+const { ensureCcoDirs, nowIso } = require("./fsx");
+const { appendProductLearningEvent } = require("./product-learning-events");
+
+const CONTRACT = "avorelo.supportBundle.v1";
+const SCHEMA_VERSION = 1;
+const BUNDLE_REL = ".claude/cco/support/latest-support-bundle.json";
+const BUNDLE_DIR_REL = ".claude/cco/support";
+
+// ── Helpers ───────────────────────────────────────────────────────────────────
+
+function safeReadJson(absPath) {
+  try {
+    if (!fs.existsSync(absPath)) return null;
+    return JSON.parse(fs.readFileSync(absPath, "utf8").replace(/^/, ""));
+  } catch {
+    return null;
+  }
+}
+
+function artifactSummary(cwd, rel, label) {
+  const absPath = path.join(cwd, rel);
+  if (!fs.existsSync(absPath)) {
+    return { label, path: rel, available: false };
+  }
+  try {
+    const data = JSON.parse(fs.readFileSync(absPath, "utf8").replace(/^/, ""));
+    const bytes = fs.statSync(absPath).size;
+    return {
+      label,
+      path: rel,
+      available: true,
+      bytes,
+      contract: data.contract || null,
+      status: data.status || null,
+      createdAt: data.createdAt || null,
+      schemaVersion: data.schemaVersion || null,
+    };
+  } catch {
+    return { label, path: rel, available: true, bytes: 0, contract: null, status: "parse_error" };
+  }
+}
+
+function countJsonFiles(cwd, rel) {
+  const dirAbs = path.join(cwd, rel);
+  try {
+    if (!fs.existsSync(dirAbs)) return 0;
+    return fs.readdirSync(dirAbs).filter((f) => f.endsWith(".json")).length;
+  } catch {
+    return 0;
+  }
+}
+
+function countJsonlLines(cwd, rel) {
+  const absPath = path.join(cwd, rel);
+  try {
+    if (!fs.existsSync(absPath)) return 0;
+    const content = fs.readFileSync(absPath, "utf8");
+    return content.split("\n").filter((l) => l.trim().startsWith("{")).length;
+  } catch {
+    return 0;
+  }
+}
+
+function nodeVersion() {
+  return process.version;
+}
+
+function platformInfo() {
+  return {
+    platform: process.platform,
+    arch: process.arch,
+    node: nodeVersion(),
+  };
+}
+
+// ── Build bundle ──────────────────────────────────────────────────────────────
+
+function buildSupportBundle(cwd, options = {}) {
+  const artifacts = [
+    artifactSummary(cwd, ".claude/cco/state/activation.json", "activation-state"),
+    artifactSummary(cwd, ".claude/cco/orchestration/activation/latest-activation.json", "alpha-activation"),
+    artifactSummary(cwd, ".claude/cco/orchestration/alpha-readiness/latest-gate.json", "alpha-readiness-gate"),
+    artifactSummary(cwd, ".claude/cco/orchestration/safe-run/latest-run.json", "latest-safe-run"),
+    artifactSummary(cwd, ".claude/cco/orchestration/hook-apply/latest-doctor.json", "hook-doctor"),
+    artifactSummary(cwd, ".claude/cco/orchestration/hook-apply/latest-apply.json", "hook-apply"),
+    artifactSummary(cwd, ".claude/cco/orchestration/seamless-outcome/latest-reality-gate.json", "proof-reality-gate"),
+    artifactSummary(cwd, ".claude/cco/orchestration/seamless-outcome/latest-value-summary.json", "value-summary"),
+    artifactSummary(cwd, ".claude/cco/orchestration/company-loop/latest-report.json", "company-loop"),
+    artifactSummary(cwd, ".claude/cco/orchestration/work-ledger/latest-ledger.json", "work-ledger"),
+    artifactSummary(cwd, ".claude/cco/orchestration/smart-work-routing/latest-route.json", "smart-route"),
+    artifactSummary(cwd, ".claude/cco/orchestration/worker-handoff/latest-handoff.json", "worker-handoff"),
+    artifactSummary(cwd, ".claude/cco/orchestration/hook-baseline/latest-baseline.json", "hook-baseline"),
+    artifactSummary(cwd, ".claude/cco/orchestration/project-profile/latest-profile.json", "project-profile"),
+    // PR #143 — Token Efficiency + Context Quality Hardening
+    artifactSummary(cwd, ".claude/cco/orchestration/token-efficiency/latest-evidence.json", "token-efficiency-evidence"),
+    artifactSummary(cwd, ".claude/cco/orchestration/token-efficiency/latest-quality-gate.json", "token-context-quality-gate"),
+    artifactSummary(cwd, ".claude/cco/orchestration/repo-map/latest-map.json", "repo-map"),
+    artifactSummary(cwd, ".claude/cco/orchestration/context-acquisition/latest-plan.json", "context-acquisition-plan"),
+    artifactSummary(cwd, ".claude/cco/orchestration/cache-readiness/latest-readiness.json", "cache-readiness"),
+    // PR #145 — MCP Least-Privilege Tool Governance (summaries only, no raw config)
+    artifactSummary(cwd, ".claude/cco/orchestration/mcp-tool-governance/latest-inventory.json", "mcp-tool-inventory"),
+    artifactSummary(cwd, ".claude/cco/orchestration/mcp-tool-governance/latest-risk.json", "mcp-tool-risk"),
+    artifactSummary(cwd, ".claude/cco/orchestration/mcp-tool-governance/latest-policy.json", "mcp-policy"),
+    artifactSummary(cwd, ".claude/cco/orchestration/mcp-tool-governance/latest-pretooluse-decision.json", "mcp-pretooluse-decision"),
+    // PR #146 — AI Install + Pre-Launch Readiness
+    artifactSummary(cwd, ".claude/cco/orchestration/ai-install/latest-prompt.json", "ai-install-prompt"),
+    artifactSummary(cwd, ".claude/cco/orchestration/prelaunch-readiness/latest-activation-readiness.json", "prelaunch-readiness"),
+    // PR #147 — Pre-Launch Intelligence Layer (summaries only, no raw prompts/feedback/code)
+    artifactSummary(cwd, ".claude/cco/orchestration/prelaunch-intelligence/latest-intelligence.json", "prelaunch-intelligence"),
+    artifactSummary(cwd, ".claude/cco/orchestration/prelaunch-intelligence/latest-feedback-intelligence.json", "feedback-intelligence"),
+    artifactSummary(cwd, ".claude/cco/orchestration/prelaunch-intelligence/latest-token-cost-intelligence.json", "token-cost-intelligence"),
+    artifactSummary(cwd, ".claude/cco/evidence/token-cost/latest-capture.json", "token-cost-capture"),
+    artifactSummary(cwd, ".claude/cco/evidence/token-cost/summary.json", "token-cost-summary"),
+    artifactSummary(cwd, ".claude/cco/orchestration/prelaunch-intelligence/latest-install-journey.json", "install-journey-intelligence"),
+    artifactSummary(cwd, ".claude/cco/orchestration/full-readiness/latest-evidence-closure.json", "readiness-evidence-closure"),
+    artifactSummary(cwd, ".claude/cco/orchestration/seamless-outcome/latest-proof-outcome-evidence.json", "proof-outcome-evidence"),
+  ];
+
+  // Feedback summary (counts only, no content)
+  const feedbackCount = countJsonFiles(cwd, ".claude/cco/feedback") + countJsonlLines(cwd, ".claude/cco/evidence/feedback/feedback.jsonl");
+  const feedbackSummary = { count: feedbackCount, dir: ".claude/cco/feedback" };
+
+  // Prompt readiness summary (status/score only — no raw promptText)
+  const prelaunchReadinessArtifact = safeReadJson(
+    path.join(cwd, ".claude/cco/orchestration/prelaunch-readiness/latest-activation-readiness.json")
+  );
+  const promptReadinessSummary = prelaunchReadinessArtifact
+    ? {
+        status: prelaunchReadinessArtifact.status,
+        score: prelaunchReadinessArtifact.score,
+        noPublicLaunchClaim: prelaunchReadinessArtifact.noPublicLaunchClaim,
+        checkCount: (prelaunchReadinessArtifact.checks || []).length,
+        passCount: (prelaunchReadinessArtifact.checks || []).filter((c) => c.status === "pass").length,
+        warnCount: (prelaunchReadinessArtifact.checks || []).filter((c) => c.status === "warn").length,
+        artifactPath: ".claude/cco/orchestration/prelaunch-readiness/latest-activation-readiness.json",
+        redacted: true,
+      }
+    : null;
+
+  // Pre-launch intelligence summary (status/score only — no raw feedback/prompts)
+  const intelligenceArtifact = safeReadJson(
+    path.join(cwd, ".claude/cco/orchestration/prelaunch-intelligence/latest-intelligence.json")
+  );
+  const intelligenceSummary = intelligenceArtifact
+    ? {
+        status: intelligenceArtifact.status,
+        score: intelligenceArtifact.score,
+        topFriction: intelligenceArtifact.frictionSummary?.topFriction,
+        tokenEvidenceLevel: intelligenceArtifact.tokenCostSummary?.evidenceLevel,
+        missingEvidenceCount: (intelligenceArtifact.missingEvidence || []).length,
+        recommendedNextPr: intelligenceArtifact.recommendedNextPr?.recommendation,
+        noPublicLaunchClaim: true,
+        redacted: true,
+      }
+    : null;
+
+  const feedbackArtifact = safeReadJson(
+    path.join(cwd, ".claude/cco/orchestration/prelaunch-intelligence/latest-feedback-intelligence.json")
+  );
+  const feedbackIntelligenceSummary = feedbackArtifact
+    ? {
+        status: feedbackArtifact.status,
+        readinessStatus: feedbackArtifact.readinessStatus,
+        score: feedbackArtifact.score,
+        qualifiedFeedbackItemsCount: feedbackArtifact.qualifiedFeedbackItemsCount || 0,
+        topFriction: feedbackArtifact.topFriction,
+        redacted: true,
+      }
+    : null;
+
+  const tokenCostArtifact = safeReadJson(
+    path.join(cwd, ".claude/cco/orchestration/prelaunch-intelligence/latest-token-cost-intelligence.json")
+  );
+  const tokenCostCaptureArtifact = safeReadJson(
+    path.join(cwd, ".claude/cco/evidence/token-cost/latest-capture.json")
+  );
+  const tokenCostSummaryArtifact = safeReadJson(
+    path.join(cwd, ".claude/cco/evidence/token-cost/summary.json")
+  );
+  const tokenCostEvidenceSummary = tokenCostArtifact
+    ? {
+        status: tokenCostArtifact.status,
+        readinessStatus: tokenCostArtifact.readinessStatus,
+        evidenceLevel: tokenCostArtifact.evidenceLevel,
+        evidenceMode: tokenCostSummaryArtifact?.evidenceMode || tokenCostArtifact.evidenceMode || "missing",
+        realUsageSamplesCount: tokenCostArtifact.realUsageSamplesCount || 0,
+        capturedUsageSamplesCount: tokenCostSummaryArtifact?.capturedUsageSamplesCount || tokenCostCaptureArtifact?.realUsageSamplesCount || 0,
+        confidence: tokenCostArtifact.confidence || "missing",
+        noExactSavingsClaim: tokenCostArtifact.noExactSavingsClaim === true,
+        noSavingsClaimUnlessMeasured: tokenCostSummaryArtifact?.noSavingsClaimUnlessMeasured === true,
+        redacted: true,
+      }
+    : null;
+
+  const proofOutcomeArtifact = safeReadJson(
+    path.join(cwd, ".claude/cco/orchestration/seamless-outcome/latest-proof-outcome-evidence.json")
+  );
+  const proofOutcomeSummary = proofOutcomeArtifact
+    ? {
+        status: proofOutcomeArtifact.status,
+        latestProofAvailable: proofOutcomeArtifact.latestProofAvailable === true,
+        realTaskProofCount: proofOutcomeArtifact.realTaskProofCount || 0,
+        simulatedProofDetected: proofOutcomeArtifact.simulatedProofDetected === true,
+        proofQuality: proofOutcomeArtifact.proofQuality || "missing",
+        rawContentExcluded: true,
+        redacted: true,
+      }
+    : null;
+
+  let failureRecoveryReadinessSummary = null;
+  let hookSafetyBoundarySummary = null;
+  let installAiReadinessSummary = null;
+  try {
+    const { buildFailureRecoveryReadiness } = require("./failure-recovery-readiness");
+    const { buildHookSafetyBoundaryReadiness } = require("./hook-safety-boundary-readiness");
+    const { buildInstallAiReadiness } = require("./install-ai-readiness");
+    const failureSurface = buildFailureRecoveryReadiness(cwd);
+    const hookSurface = buildHookSafetyBoundaryReadiness(cwd);
+    const installSurface = buildInstallAiReadiness(cwd);
+    failureRecoveryReadinessSummary = {
+      status: failureSurface.status,
+      receiptAvailable: failureSurface.receiptAvailable === true,
+      launchHardeningAvailable: failureSurface.launchHardeningAvailable === true,
+      safeNextAction: failureSurface.safeNextAction || null,
+      redacted: true,
+    };
+    hookSafetyBoundarySummary = {
+      status: hookSurface.status,
+      hookDoctorStatus: hookSurface.hookDoctorStatus,
+      approvalBoundaryExported: hookSurface.approvalBoundaryExported === true,
+      installPromptBoundariesAvailable: hookSurface.installPromptBoundariesAvailable === true,
+      redacted: true,
+    };
+    installAiReadinessSummary = {
+      status: installSurface.status,
+      approvalBoundariesAvailable: installSurface.approvalBoundariesAvailable === true,
+      firstValuePathAvailable: installSurface.firstValuePathAvailable === true,
+      recoveryPathAvailable: installSurface.recoveryPathAvailable === true,
+      redacted: true,
+    };
+  } catch {}
+
+  // Full readiness gate summary (PR #148)
+  const fullReadinessArtifact = safeReadJson(
+    path.join(cwd, ".claude/cco/orchestration/full-readiness/latest-gate.json")
+  );
+  const knownLimitationsArtifact = safeReadJson(
+    path.join(cwd, ".claude/cco/orchestration/full-readiness/latest-known-limitations.json")
+  );
+  const evidenceClosureArtifact = safeReadJson(
+    path.join(cwd, ".claude/cco/orchestration/full-readiness/latest-evidence-closure.json")
+  );
+  const fullReadinessSummary = fullReadinessArtifact
+    ? {
+        status: fullReadinessArtifact.status,
+        score: fullReadinessArtifact.score,
+        releaseCandidateStatus: fullReadinessArtifact.releaseCandidateStatus,
+        blockerCount: (fullReadinessArtifact.blockers || []).length,
+        warningCount: (fullReadinessArtifact.warnings || []).length,
+        recommendedNextPr: fullReadinessArtifact.recommendedNextPr,
+        noPublicLaunchClaim: true,
+        redacted: true,
+      }
+    : null;
+  const knownLimitationsSummary = knownLimitationsArtifact
+    ? {
+        totalLimitations: knownLimitationsArtifact.totalLimitations,
+        blockerLimitationsCount: knownLimitationsArtifact.blockerLimitationsCount,
+        overallImpact: knownLimitationsArtifact.overallImpact,
+        redacted: true,
+      }
+    : null;
+  const evidenceClosureSummary = evidenceClosureArtifact
+    ? {
+        status: evidenceClosureArtifact.status,
+        evidencePresentCount: evidenceClosureArtifact.evidencePresentCount,
+        evidenceMissingCount: evidenceClosureArtifact.evidenceMissingCount,
+        nextAction: evidenceClosureArtifact.nextAction,
+        rawContentExcluded: true,
+        redacted: true,
+      }
+    : null;
+
+  // Activation distribution readiness summary (PR #149)
+  let activationDistributionSummary = null;
+  try {
+    const { buildActivationDistributionSurface } = require("./activation-distribution-readiness");
+    const adrSurface = buildActivationDistributionSurface(cwd, {});
+    if (adrSurface.status !== "not_available") {
+      activationDistributionSummary = {
+        status: adrSurface.status,
+        score: adrSurface.score,
+        blockerCount: adrSurface.blockerCount,
+        warningCount: adrSurface.warningCount,
+        noPublicLaunchClaim: true,
+        redacted: true,
+      };
+    }
+  } catch {}
+
+  // Public distribution summary (PR #161)
+  let publicDistributionSummary = null;
+  try {
+    const gateArtifact = safeReadJson(
+      path.join(cwd, ".claude/cco/orchestration/public-distribution/latest-gate.json")
+    );
+    if (gateArtifact) {
+      publicDistributionSummary = {
+        status: gateArtifact.status,
+        score: gateArtifact.score,
+        publicInstallStatus: gateArtifact.publicInstallStatus,
+        localPackageStatus: gateArtifact.localPackageStatus,
+        packageContentStatus: gateArtifact.packageContentStatus,
+        claimSafetyStatus: gateArtifact.claimSafetyStatus,
+        provenanceStatus: gateArtifact.provenanceStatus,
+        blockerCount: gateArtifact.blockerCount,
+        warningCount: gateArtifact.warningCount,
+        noPublicLaunchClaim: true,
+        redacted: true,
+      };
+    }
+  } catch {}
+
+  // Adapter technical readiness summary (PR #162)
+  let adapterTechnicalReadinessSummary = null;
+  try {
+    const adapterGateArtifact = safeReadJson(
+      path.join(cwd, ".claude/cco/orchestration/adapter-readiness/latest-technical-gate.json")
+    );
+    if (adapterGateArtifact) {
+      adapterTechnicalReadinessSummary = {
+        status: adapterGateArtifact.status,
+        score: adapterGateArtifact.score,
+        verdict: adapterGateArtifact.verdict,
+        blockerCount: adapterGateArtifact.blockerCount || 0,
+        warningCount: adapterGateArtifact.warningCount || 0,
+        browserRequired: false,
+        noBrowserLaunch: true,
+        noPublicLaunchClaim: true,
+        redacted: true,
+      };
+    }
+  } catch {}
+
+  // Host context summary (PR #163/#164) — compact, no secrets, no env dumps
+  // Contract: avorelo.supportBundleHostContext.v1
+  let hostContext = null;
+  try {
+    const adapterReadinessArtifact = safeReadJson(
+      path.join(cwd, ".claude/cco/orchestration/adapter-readiness/latest-readiness.json")
+    );
+    const hostMatrixArtifact = safeReadJson(
+      path.join(cwd, ".claude/cco/orchestration/adapter-readiness/latest-host-capability-matrix.json")
+    );
+    const installPlanArtifact = safeReadJson(
+      path.join(cwd, ".claude/cco/orchestration/adapter-readiness/latest-install-plan.json")
+    );
+    const browserPreflightArtifact = safeReadJson(
+      path.join(cwd, ".claude/cco/orchestration/adapter-readiness/latest-browser-proof-preflight.json")
+    );
+    const safetyBoundariesArtifact = safeReadJson(
+      path.join(cwd, ".claude/cco/orchestration/adapter-readiness/latest-adapter-safety-boundaries.json")
+    );
+
+    hostContext = {
+      contract: "avorelo.supportBundleHostContext.v1",
+      generatedAt: nowIso(),
+      // Adapter readiness (7-host detection + scoring)
+      adapterReadiness: adapterReadinessArtifact ? {
+        status: adapterReadinessArtifact.status,
+        score: adapterReadinessArtifact.score,
+        verdict: adapterReadinessArtifact.verdict,
+        readyHosts: adapterReadinessArtifact.readyHosts || [],
+        partialHosts: adapterReadinessArtifact.partialHosts || [],
+        unsupportedHosts: adapterReadinessArtifact.unsupportedHosts || [],
+        blockerCount: adapterReadinessArtifact.blockers ? adapterReadinessArtifact.blockers.length : 0,
+        warningCount: adapterReadinessArtifact.warnings ? adapterReadinessArtifact.warnings.length : 0,
+        approvalRequiredBeforeApply: true,
+        noWorksEverywhereClaim: true,
+      } : null,
+      // Host capability matrix (which hosts detected, per-host capabilities)
+      hostCapabilityMatrix: hostMatrixArtifact ? {
+        status: hostMatrixArtifact.status,
+        detectedCount: hostMatrixArtifact.detectedCount || 0,
+        primaryHost: hostMatrixArtifact.primaryHost || "none",
+        detectedHosts: hostMatrixArtifact.detectedHosts || [],
+        fullValueHosts: hostMatrixArtifact.fullValueHosts || [],
+        partialValueHosts: hostMatrixArtifact.partialValueHosts || [],
+        blockerCount: hostMatrixArtifact.blockerCount || 0,
+        warningCount: hostMatrixArtifact.warningCount || 0,
+      } : null,
+      // Cross-host install plan (per-host install paths and approval boundaries)
+      crossHostInstallPlan: installPlanArtifact ? {
+        status: installPlanArtifact.status,
+        supportedHostIds: installPlanArtifact.supportedHostIds || [],
+        unsupportedHostIds: installPlanArtifact.unsupportedHostIds || [],
+        blockerCount: installPlanArtifact.blockerCount || 0,
+        warningCount: installPlanArtifact.warningCount || 0,
+        noWorksEverywhereClaim: installPlanArtifact.noWorksEverywhereClaim === true,
+      } : null,
+      // Browser proof preflight (preflight only — no browser launched)
+      browserProofPreflight: browserPreflightArtifact ? {
+        status: browserPreflightArtifact.status,
+        localFirstPathVerified: browserPreflightArtifact.localFirstPathVerified === true,
+        browserRequired: false,
+        noBrowserLaunch: true,
+        blockerCount: browserPreflightArtifact.blockerCount || 0,
+        warningCount: browserPreflightArtifact.warningCount || 0,
+      } : null,
+      // Adapter safety boundaries (no tokens, no auto-apply, MCP isolation)
+      safetyBoundaries: safetyBoundariesArtifact ? {
+        status: safetyBoundariesArtifact.status,
+        approvalRequiredBeforeApply: true,
+        blockerCount: safetyBoundariesArtifact.blockerCount || 0,
+        warningCount: safetyBoundariesArtifact.warningCount || 0,
+      } : null,
+      // Explicit contract markers — support is per-host, not universal
+      noWorksEverywhereClaim: true,
+      hostSupportIsPerEnvironment: true,
+      redacted: true,
+    };
+  } catch {}
+
+  // Design partner feedback summary (PR #160)
+  let designPartnerFeedbackSummary = null;
+  try {
+    const { buildDesignPartnerFeedbackSummary } = require("./design-partner-feedback");
+    const dpSummary = buildDesignPartnerFeedbackSummary(cwd, {});
+    designPartnerFeedbackSummary = {
+      status: dpSummary.status,
+      qualifiedSessionCount: dpSummary.qualifiedSessionCount,
+      blockerCount: dpSummary.blockerCount,
+      partnerAliasCount: dpSummary.partnerAliasCount,
+      noPublicLaunchClaim: true,
+      redacted: true,
+    };
+  } catch {}
+
+  // Product learning events (count only)
+  const eventCount = countJsonlLines(cwd, ".claude/cco/events/product-learning.jsonl");
+
+  // Node/platform info
+  const platform = platformInfo();
+
+  // Available artifacts count
+  const available = artifacts.filter((a) => a.available).length;
+  const missing = artifacts.filter((a) => !a.available).length;
+
+  const bundle = {
+    contract: CONTRACT,
+    schemaVersion: SCHEMA_VERSION,
+    createdAt: nowIso(),
+    status: available > 0 ? "ready" : "empty",
+    summary: {
+      artifactsAvailable: available,
+      artifactsMissing: missing,
+      feedbackItems: feedbackCount,
+      productLearningEvents: eventCount,
+    },
+    platform,
+    artifacts,
+    feedbackSummary,
+    promptReadinessSummary,
+    intelligenceSummary,
+    feedbackIntelligenceSummary,
+    tokenCostEvidenceSummary,
+    proofOutcomeSummary,
+    failureRecoveryReadinessSummary,
+    hookSafetyBoundarySummary,
+    installAiReadinessSummary,
+    fullReadinessSummary,
+    knownLimitationsSummary,
+    activationDistributionSummary,
+    publicDistributionSummary,
+    adapterTechnicalReadinessSummary,
+    hostContext,
+    designPartnerFeedbackSummary,
+    evidenceClosureSummary,
+    note: [
+      "This bundle contains only artifact references and status summaries.",
+      "No raw code, prompts, secrets, PII, or config dumps are included.",
+      "Share this file with support if requested.",
+    ],
+    redacted: true,
+  };
+
+  return bundle;
+}
+
+// ── Write bundle ──────────────────────────────────────────────────────────────
+
+function writeSupportBundle(cwd, bundle) {
+  try {
+    ensureCcoDirs(cwd);
+    const dirAbs = path.join(cwd, BUNDLE_DIR_REL);
+    if (!fs.existsSync(dirAbs)) fs.mkdirSync(dirAbs, { recursive: true });
+    const bundleAbs = path.join(cwd, BUNDLE_REL);
+    fs.writeFileSync(bundleAbs, JSON.stringify(bundle, null, 2), "utf8");
+    return bundleAbs;
+  } catch {
+    return null;
+  }
+}
+
+// ── Generate bundle ───────────────────────────────────────────────────────────
+
+function generateSupportBundle(cwd, options = {}) {
+  const bundle = buildSupportBundle(cwd, options);
+  const written = writeSupportBundle(cwd, bundle);
+
+  try {
+    appendProductLearningEvent(cwd, {
+      eventName: "support_bundle_generated",
+      status: bundle.status,
+      artifactsAvailable: bundle.summary.artifactsAvailable,
+      artifactsMissing: bundle.summary.artifactsMissing,
+    });
+  } catch {}
+
+  return { ...bundle, artifactPath: written ? BUNDLE_REL : null };
+}
+
+// ── Format text ───────────────────────────────────────────────────────────────
+
+function formatSupportBundleText(bundle) {
+  const lines = [];
+  lines.push(`Support bundle: ${bundle.status}`);
+  lines.push(`  Artifacts: ${bundle.summary.artifactsAvailable} available, ${bundle.summary.artifactsMissing} missing`);
+  lines.push(`  Feedback items: ${bundle.summary.feedbackItems}`);
+  lines.push(`  Product learning events: ${bundle.summary.productLearningEvents}`);
+  lines.push(`  Platform: ${bundle.platform.platform} / Node ${bundle.platform.node}`);
+  lines.push("");
+  lines.push("Artifact status:");
+  (bundle.artifacts || []).forEach((a) => {
+    const icon = a.available ? "+" : "-";
+    const statusStr = a.status ? ` [${a.status}]` : "";
+    lines.push(`  ${icon} ${a.label}${statusStr}`);
+  });
+  lines.push("");
+  lines.push(bundle.note ? bundle.note.join(" ") : "");
+  if (bundle.artifactPath) lines.push(`\nBundle written: ${bundle.artifactPath}`);
+  return lines.join("\n");
+}
+
+function buildSupportBundleSurface(cwd, options) {
+  const bundle = buildSupportBundle(cwd, options);
+  const written = writeSupportBundle(cwd, bundle);
+  return {
+    status: bundle.status,
+    redacted: bundle.redacted,
+    noWorksEverywhereClaim: bundle.noWorksEverywhereClaim,
+    artifactPath: written ? BUNDLE_REL : null,
+    written: !!written,
+  };
+}
+
+module.exports = {
+  CONTRACT,
+  SCHEMA_VERSION,
+  BUNDLE_REL,
+  buildSupportBundle,
+  writeSupportBundle,
+  generateSupportBundle,
+  buildSupportBundleSurface,
+  formatSupportBundleText,
+};