avorelo 0.1.0 → 0.3.0

package/scripts/lib/cross-host-install-plan.js

@@ -1,308 +0,0 @@
-"use strict";
-
-// ── Cross-Host Install Plan ───────────────────────────────────────────────────
-// Contract: avorelo.crossHostInstallPlan.v1
-// Answers: "What is the exact install path for each host? What requires approval?
-// Which hosts are caveated or unsupported?"
-// Does NOT install. Does NOT auto-apply. Does NOT publish. Read+plan only.
-
-const fs = require("fs");
-const path = require("path");
-const { nowIso } = require("./fsx");
-const { appendProductLearningEvent } = require("./product-learning-events");
-
-const CONTRACT = "avorelo.crossHostInstallPlan.v1";
-const SCHEMA_VERSION = 1;
-const ARTIFACT_DIR_REL = ".claude/cco/orchestration/adapter-readiness";
-const ARTIFACT_REL = ARTIFACT_DIR_REL + "/latest-install-plan.json";
-
-function safeReadJson(absPath) {
-  try {
-    if (!fs.existsSync(absPath)) return null;
-    return JSON.parse(fs.readFileSync(absPath, "utf8").replace(/^/, ""));
-  } catch { return null; }
-}
-
-// ── Host Install Definitions ──────────────────────────────────────────────────
-
-const HOST_INSTALL_DEFS = [
-  {
-    hostId: "cli",
-    hostLabel: "CLI (local)",
-    installMethod: "cli_prompt",
-    commandSequence: [
-      "node bin/avorelo activate",
-      "node bin/avorelo status",
-    ],
-    approvalBoundaries: [
-      "Hook config changes require explicit --yes flag",
-      "MCP config changes require manual review",
-    ],
-    caveats: [],
-    supported: true,
-    tier: "core",
-  },
-  {
-    hostId: "claude_code",
-    hostLabel: "Claude Code",
-    installMethod: "ai_prompt",
-    commandSequence: [
-      "Run: node bin/avorelo install-ai --prompt (copy prompt to Claude Code chat)",
-      "Run in terminal: node bin/avorelo activate",
-      "Review hook config preview: node bin/avorelo hooks preview",
-      "Apply hooks (explicit approval): node bin/avorelo hooks apply --yes",
-    ],
-    approvalBoundaries: [
-      "Hook config changes require explicit --yes flag",
-      "MCP config changes require user review in .claude/settings.json",
-      "All install-ai steps surface approval checkpoints",
-    ],
-    caveats: [
-      "Package not yet public — use local install path (node bin/avorelo)",
-      "Hook depth: full lifecycle available",
-      "MCP supported",
-    ],
-    supported: true,
-    tier: "primary",
-  },
-  {
-    hostId: "codex",
-    hostLabel: "Codex CLI",
-    installMethod: "terminal_fallback",
-    commandSequence: [
-      "Run in terminal: node bin/avorelo activate",
-      "Review hook config: node bin/avorelo hooks preview",
-      "Apply hooks with explicit approval: node bin/avorelo hooks apply --yes",
-    ],
-    approvalBoundaries: [
-      "Hook config changes require explicit --yes flag",
-    ],
-    caveats: [
-      "No dedicated Codex adapter yet — terminal path only",
-      "Hook depth: partial lifecycle",
-      "MCP: partial support",
-    ],
-    supported: true,
-    tier: "partial",
-  },
-  {
-    hostId: "vscode",
-    hostLabel: "VS Code",
-    installMethod: "terminal_fallback",
-    commandSequence: [
-      "Open VS Code integrated terminal",
-      "Run: node bin/avorelo activate",
-      "Review hook config: node bin/avorelo hooks preview",
-    ],
-    approvalBoundaries: [
-      "Hook config changes require explicit --yes flag",
-      "No VS Code extension — terminal path only",
-    ],
-    caveats: [
-      "No VS Code extension implemented — terminal path only",
-      "Hook depth: extension-bridge only",
-      "MCP: limited",
-    ],
-    supported: true,
-    tier: "partial",
-  },
-  {
-    hostId: "cursor",
-    hostLabel: "Cursor",
-    installMethod: "terminal_fallback",
-    commandSequence: [
-      "Open Cursor integrated terminal",
-      "Run: node bin/avorelo activate",
-      "Review hook config: node bin/avorelo hooks preview",
-    ],
-    approvalBoundaries: [
-      "Hook config changes require explicit --yes flag",
-      "No Cursor extension — terminal path only",
-    ],
-    caveats: [
-      "No Cursor extension implemented — terminal path only",
-      "Hook depth: partial",
-      "MCP: partial",
-    ],
-    supported: true,
-    tier: "partial",
-  },
-  {
-    hostId: "openhands",
-    hostLabel: "OpenHands",
-    installMethod: "unsupported",
-    commandSequence: [],
-    approvalBoundaries: [],
-    caveats: [
-      "OpenHands adapter not yet implemented",
-      "Use CLI path if running from terminal environment",
-    ],
-    supported: false,
-    tier: "unsupported",
-    safeAlternative: "Use CLI path: node bin/avorelo activate",
-  },
-  {
-    hostId: "unknown",
-    hostLabel: "Unknown / Generic",
-    installMethod: "terminal_fallback",
-    commandSequence: [
-      "Run in terminal: node bin/avorelo activate",
-    ],
-    approvalBoundaries: [
-      "Hook config changes require explicit --yes flag",
-    ],
-    caveats: [
-      "Host not detected — using generic CLI fallback",
-      "Some features may not be available",
-    ],
-    supported: true,
-    tier: "fallback",
-  },
-];
-
-// ── Build Plan for Single Host ────────────────────────────────────────────────
-
-function buildCrossHostInstallPlan(cwd, hostId, options) {
-  options = options || {};
-  const def = HOST_INSTALL_DEFS.find(function(d) { return d.hostId === hostId; });
-  if (!def) {
-    return {
-      hostId,
-      hostLabel: hostId,
-      installMethod: "unknown",
-      commandSequence: [],
-      approvalBoundaries: [],
-      caveats: ["Host definition not found"],
-      supported: false,
-      safeNextAction: "Use CLI path: node bin/avorelo activate",
-      evidenceRefs: [],
-    };
-  }
-
-  // Check if install-ai artifact is available for hosts that support it
-  let evidenceRefs = [];
-  const installAiPath = path.join(cwd, ".claude/cco/orchestration/ai-install/latest-prompt.json");
-  if (fs.existsSync(installAiPath) && def.installMethod === "ai_prompt") {
-    evidenceRefs.push(".claude/cco/orchestration/ai-install/latest-prompt.json");
-  }
-
-  const safeNextAction = def.supported
-    ? "Run: " + (def.commandSequence[0] || "node bin/avorelo activate")
-    : (def.safeAlternative || "Host unsupported — use CLI path instead");
-
-  return Object.assign({}, def, {
-    safeNextAction,
-    evidenceRefs,
-  });
-}
-
-// ── Build All Host Plans ──────────────────────────────────────────────────────
-
-function buildAllHostInstallPlans(cwd, options) {
-  options = options || {};
-
-  const plans = HOST_INSTALL_DEFS.map(function(def) {
-    return buildCrossHostInstallPlan(cwd, def.hostId, options);
-  });
-
-  const supportedHostIds = plans.filter(function(p) { return p.supported; }).map(function(p) { return p.hostId; });
-  const unsupportedHostIds = plans.filter(function(p) { return !p.supported; }).map(function(p) { return p.hostId; });
-  const corePlans = plans.filter(function(p) { return p.tier === "core" || p.tier === "primary"; });
-  const coreBroken = corePlans.some(function(p) { return !p.supported; });
-
-  const blockerCount = coreBroken ? 1 : 0;
-  const warningCount = unsupportedHostIds.length;
-
-  const status = blockerCount > 0 ? "blocked" : warningCount > 0 ? "warn" : "pass";
-
-  const safeNextAction = blockerCount > 0
-    ? "Core install path (cli/claude_code) is broken — repair before proceeding."
-    : warningCount > 0
-    ? "Some hosts are unsupported or partial. Core CLI path is available. Caveats documented."
-    : "All supported hosts have install plans. Unsupported hosts have safe alternatives documented.";
-
-  return {
-    contract: CONTRACT,
-    schemaVersion: SCHEMA_VERSION,
-    generatedAt: nowIso(),
-    status,
-    plans,
-    supportedHostIds,
-    unsupportedHostIds,
-    blockerCount,
-    warningCount,
-    safeNextAction,
-    noWorksEverywhereClaim: true,
-    noPublicLaunchClaim: true,
-    redacted: true,
-  };
-}
-
-// ── Write ─────────────────────────────────────────────────────────────────────
-
-function writeCrossHostInstallPlan(cwd, plan) {
-  const dir = path.join(cwd, ARTIFACT_DIR_REL);
-  if (!fs.existsSync(dir)) fs.mkdirSync(dir, { recursive: true });
-  fs.writeFileSync(path.join(cwd, ARTIFACT_REL), JSON.stringify(plan, null, 2));
-}
-
-// ── Surface ───────────────────────────────────────────────────────────────────
-
-function buildCrossHostInstallSurface(cwd, options) {
-  const plan = buildAllHostInstallPlans(cwd, options);
-  writeCrossHostInstallPlan(cwd, plan);
-  try {
-    appendProductLearningEvent(cwd, {
-      event: "cross_host_install_plan_built",
-      contract: CONTRACT,
-      status: plan.status,
-      supportedCount: plan.supportedHostIds.length,
-      unsupportedCount: plan.unsupportedHostIds.length,
-    });
-  } catch { /* non-fatal */ }
-  return {
-    status: plan.status,
-    supportedHostIds: plan.supportedHostIds,
-    unsupportedHostIds: plan.unsupportedHostIds,
-    blockerCount: plan.blockerCount,
-    warningCount: plan.warningCount,
-    noWorksEverywhereClaim: true,
-    noPublicLaunchClaim: true,
-  };
-}
-
-// ── Format ────────────────────────────────────────────────────────────────────
-
-function formatCrossHostInstallText(plan, options) {
-  options = options || {};
-  var lines = [
-    "Cross-Host Install Plan [" + (plan.status || "?").toUpperCase() + "]",
-    "  Supported hosts: " + (plan.supportedHostIds || []).join(", "),
-    "  Unsupported hosts: " + (plan.unsupportedHostIds || []).join(", "),
-    "  Blockers: " + (plan.blockerCount || 0),
-    "  Warnings: " + (plan.warningCount || 0),
-  ];
-  if (options.debug && plan.plans) {
-    plan.plans.forEach(function(p) {
-      lines.push("  [" + p.hostId + "] " + p.installMethod + (p.supported ? "" : " (unsupported)"));
-      if (p.caveats && p.caveats.length) {
-        p.caveats.forEach(function(c) { lines.push("    caveat: " + c); });
-      }
-    });
-  }
-  lines.push("  No works-everywhere claim. Unsupported hosts caveated.");
-  lines.push("  Next: " + (plan.safeNextAction || "Review cross-host install plan."));
-  return lines.join("\n");
-}
-
-module.exports = {
-  CONTRACT,
-  SCHEMA_VERSION,
-  ARTIFACT_REL,
-  HOST_INSTALL_DEFS,
-  buildCrossHostInstallPlan,
-  buildAllHostInstallPlans,
-  writeCrossHostInstallPlan,
-  buildCrossHostInstallSurface,
-  formatCrossHostInstallText,
-};

package/scripts/lib/cross-host-install-readiness.js

@@ -1,237 +0,0 @@
-"use strict";
-
-// ── Cross-Host Install Readiness ──────────────────────────────────────────────
-// Contract: avorelo.crossHostInstallReadiness.v1
-// Answers: "Does install-ai work on each detected host? Is the bin entry viable?
-// Is there a clear activation path per host?"
-// Reads existing install-ai artifacts. Does NOT run installs. Does NOT publish.
-
-const fs = require("fs");
-const path = require("path");
-const { nowIso } = require("./fsx");
-const { appendProductLearningEvent } = require("./product-learning-events");
-
-const CONTRACT = "avorelo.crossHostInstallReadiness.v1";
-const SCHEMA_VERSION = 1;
-const ARTIFACT_DIR_REL = ".claude/cco/orchestration/adapter-readiness";
-const ARTIFACT_REL = ARTIFACT_DIR_REL + "/latest-cross-host-install.json";
-
-function safeReadJson(absPath) {
-  try {
-    if (!fs.existsSync(absPath)) return null;
-    return JSON.parse(fs.readFileSync(absPath, "utf8").replace(/^/, ""));
-  } catch { return null; }
-}
-
-function pass(id, label, evidence, detail) {
-  return { id, label, status: "pass", evidence: evidence || null, detail: detail || null, safeNextAction: null };
-}
-function warn(id, label, safeNextAction, evidence, detail) {
-  return { id, label, status: "warn", evidence: evidence || null, detail: detail || null, safeNextAction: safeNextAction || "Review and resolve." };
-}
-function blocked(id, label, safeNextAction, evidence, detail) {
-  return { id, label, status: "blocked", evidence: evidence || null, detail: detail || null, safeNextAction: safeNextAction || "Fix blocker before proceeding." };
-}
-function info(id, label, evidence, detail) {
-  return { id, label, status: "info", evidence: evidence || null, detail: detail || null, safeNextAction: null };
-}
-
-// ── Shared Checks ─────────────────────────────────────────────────────────────
-
-function checkBinEntryPresent(cwd) {
-  const binPath = path.join(cwd, "bin", "avorelo");
-  if (fs.existsSync(binPath)) {
-    return pass("bin_entry_present", "bin/avorelo entry present", { path: "bin/avorelo" });
-  }
-  return blocked("bin_entry_present", "bin/avorelo entry missing",
-    "Create bin/avorelo entry point before cross-host testing.", null, "bin/avorelo not found.");
-}
-
-function checkInstallAiArtifact(cwd) {
-  const installAiPath = path.join(cwd, ".claude/cco/orchestration/ai-install/latest-prompt.json");
-  const artifact = safeReadJson(installAiPath);
-  if (!artifact) {
-    return warn("install_ai_artifact", "install-ai artifact not yet generated",
-      "Run: node bin/avorelo install-ai --json to generate the install-ai artifact.",
-      null, "latest-prompt.json not found.");
-  }
-  return pass("install_ai_artifact", "install-ai artifact present",
-    { path: ".claude/cco/orchestration/ai-install/latest-prompt.json" });
-}
-
-function checkActivationStatePresent(cwd) {
-  const statePath = path.join(cwd, ".claude/cco/state/activation.json");
-  if (fs.existsSync(statePath)) {
-    return pass("activation_state_present", "Activation state file present",
-      { path: ".claude/cco/state/activation.json" });
-  }
-  return warn("activation_state_present", "Activation state file not found",
-    "Run: node bin/avorelo activate to initialize activation state.",
-    null, ".claude/cco/state/activation.json not found.");
-}
-
-// ── Per-Host Install Checks ───────────────────────────────────────────────────
-
-function checkHostInstallReadiness(cwd, hostId, hostLabel, installAiSupported) {
-  const checks = [];
-
-  if (!installAiSupported) {
-    checks.push(warn("install_ai_supported_" + hostId,
-      "install-ai not supported on " + hostLabel,
-      "Document manual install path for " + hostLabel + " in docs/INSTALL.md.",
-      { hostId }));
-    return { hostId, hostLabel, supported: false, checks, status: "warn" };
-  }
-
-  // For supported hosts, verify the install-ai prompt would work
-  const installAiArtifact = safeReadJson(path.join(cwd, ".claude/cco/orchestration/ai-install/latest-prompt.json"));
-  if (installAiArtifact) {
-    checks.push(pass("install_ai_prompt_" + hostId,
-      "install-ai prompt ready for " + hostLabel,
-      { hostId, hasPrompt: true }));
-  } else {
-    checks.push(warn("install_ai_prompt_" + hostId,
-      "install-ai prompt not yet generated for " + hostLabel,
-      "Run: node bin/avorelo install-ai --json",
-      { hostId }));
-  }
-
-  // Check host-specific state
-  const hostStatePath = path.join(cwd, ".claude/cco/state/hosts/" + hostId + ".json");
-  if (fs.existsSync(hostStatePath)) {
-    checks.push(pass("host_state_" + hostId, hostLabel + " host state present",
-      { path: ".claude/cco/state/hosts/" + hostId + ".json" }));
-  } else {
-    checks.push(info("host_state_" + hostId, hostLabel + " host state not yet written",
-      { hostId }, "Will be created on first activation."));
-  }
-
-  const status = checks.some(function(c) { return c.status === "blocked"; }) ? "blocked"
-    : checks.every(function(c) { return c.status === "pass" || c.status === "info"; }) ? "pass"
-    : "warn";
-
-  return { hostId, hostLabel, supported: true, checks, status };
-}
-
-// ── Build Cross-Host Install Readiness ────────────────────────────────────────
-
-const HOST_INSTALL_DEFS = [
-  { id: "claude_code", label: "Claude Code", installAiSupported: true },
-  { id: "cursor", label: "Cursor", installAiSupported: true },
-  { id: "windsurf", label: "Windsurf", installAiSupported: true },
-  { id: "codex", label: "Codex CLI", installAiSupported: true },
-  { id: "vscode", label: "VS Code", installAiSupported: true },
-  { id: "github_agent", label: "GitHub Copilot Agent", installAiSupported: false },
-];
-
-function buildCrossHostInstallReadiness(cwd, options) {
-  const sharedChecks = [
-    checkBinEntryPresent(cwd),
-    checkInstallAiArtifact(cwd),
-    checkActivationStatePresent(cwd),
-  ];
-
-  const hostResults = HOST_INSTALL_DEFS.map(function(def) {
-    return checkHostInstallReadiness(cwd, def.id, def.label, def.installAiSupported);
-  });
-
-  const allChecks = sharedChecks.concat(
-    hostResults.reduce(function(acc, h) { return acc.concat(h.checks); }, [])
-  );
-
-  const blockers = allChecks.filter(function(c) { return c.status === "blocked"; });
-  const warnings = allChecks.filter(function(c) { return c.status === "warn"; });
-
-  const supportedHosts = hostResults.filter(function(h) { return h.supported; }).map(function(h) { return h.hostId; });
-  const unsupportedHosts = hostResults.filter(function(h) { return !h.supported; }).map(function(h) { return h.hostId; });
-
-  var status;
-  if (blockers.length > 0) {
-    status = "blocked";
-  } else if (warnings.length > 0) {
-    status = "warn";
-  } else {
-    status = "pass";
-  }
-
-  const safeNextAction = blockers.length > 0
-    ? "Fix install blockers before cross-host testing. Ensure bin/avorelo exists."
-    : warnings.length > 0
-    ? "Review cross-host install warnings. Generate install-ai artifact if missing."
-    : "Cross-host install readiness verified for all supported hosts.";
-
-  return {
-    contract: CONTRACT,
-    schemaVersion: SCHEMA_VERSION,
-    generatedAt: nowIso(),
-    status,
-    supportedHosts,
-    unsupportedHosts,
-    sharedChecks,
-    hostResults,
-    blockerCount: blockers.length,
-    warningCount: warnings.length,
-    safeNextAction,
-    noPublicLaunchClaim: true,
-    redacted: true,
-  };
-}
-
-// ── Write ─────────────────────────────────────────────────────────────────────
-
-function writeCrossHostInstallReadiness(cwd, readiness) {
-  const dir = path.join(cwd, ARTIFACT_DIR_REL);
-  if (!fs.existsSync(dir)) fs.mkdirSync(dir, { recursive: true });
-  fs.writeFileSync(path.join(cwd, ARTIFACT_REL), JSON.stringify(readiness, null, 2));
-}
-
-// ── Surface ───────────────────────────────────────────────────────────────────
-
-function buildCrossHostInstallSurface(cwd, options) {
-  const readiness = buildCrossHostInstallReadiness(cwd, options);
-  writeCrossHostInstallReadiness(cwd, readiness);
-  try {
-    appendProductLearningEvent(cwd, {
-      event: "cross_host_install_readiness_built",
-      contract: CONTRACT,
-      status: readiness.status,
-      blockerCount: readiness.blockerCount,
-    });
-  } catch { /* non-fatal */ }
-  return {
-    status: readiness.status,
-    supportedHosts: readiness.supportedHosts,
-    unsupportedHosts: readiness.unsupportedHosts,
-    blockerCount: readiness.blockerCount,
-    warningCount: readiness.warningCount,
-    noPublicLaunchClaim: true,
-  };
-}
-
-// ── Format ────────────────────────────────────────────────────────────────────
-
-function formatCrossHostInstallText(readiness) {
-  var lines = [
-    "Cross-Host Install Readiness [" + (readiness.status || "?").toUpperCase() + "]",
-    "  Supported hosts: " + (readiness.supportedHosts || []).join(", "),
-    "  Unsupported hosts: " + (readiness.unsupportedHosts || []).join(", "),
-    "  Blockers: " + (readiness.blockerCount || 0),
-    "  Warnings: " + (readiness.warningCount || 0),
-    "  Next: " + (readiness.safeNextAction || "Review cross-host install readiness."),
-  ];
-  return lines.join("\n");
-}
-
-module.exports = {
-  CONTRACT,
-  SCHEMA_VERSION,
-  ARTIFACT_REL,
-  HOST_INSTALL_DEFS,
-  buildCrossHostInstallReadiness,
-  writeCrossHostInstallReadiness,
-  buildCrossHostInstallSurface,
-  formatCrossHostInstallText,
-  checkBinEntryPresent,
-  checkInstallAiArtifact,
-  checkHostInstallReadiness,
-};