avorelo 0.1.0 → 0.3.0

package/scripts/lib/activation/activation-summary.js

@@ -1,191 +0,0 @@
-"use strict";
-
-const fs = require("fs");
-const path = require("path");
-
-const { safeReadJson } = require("../fsx");
-const {
-  ACTIVATION_STATE_REL,
-  readActivationState,
-} = require("./activation-state");
-const {
-  USER_STATE_REL,
-  readAccountState,
-} = require("./account-state");
-
-const PUBLIC_ACTIVATE_COMMAND = "npx avorelo@latest activate";
-
-function safeActivateNextAction() {
-  return {
-    label: "Activate Avorelo",
-    command: PUBLIC_ACTIVATE_COMMAND,
-    reason: "Activation has not run yet in this project.",
-    blocking: false,
-  };
-}
-
-function isNonEmptyObject(value) {
-  return Boolean(value) && typeof value === "object" && !Array.isArray(value);
-}
-
-function probeJson(cwd, relPath) {
-  const abs = path.join(cwd, relPath);
-  const exists = fs.existsSync(abs);
-  const raw = safeReadJson(cwd, relPath, null);
-  return {
-    exists,
-    raw,
-    unreadable: exists && !isNonEmptyObject(raw),
-  };
-}
-
-function normalizeEnabledIntegrations(list) {
-  if (!Array.isArray(list)) return [];
-  return list.filter((item) => typeof item === "string" && item.trim()).map((item) => item.trim());
-}
-
-function normalizeNextAction(nextAction, status, firstValueAvailable) {
-  if (!isNonEmptyObject(nextAction)) {
-    if (status === "first_value_ready" || status === "active") {
-      return {
-        label: "Continue working",
-        command: null,
-        reason: firstValueAvailable
-          ? "Activation already produced a first-value result in this project."
-          : "Activation has already completed in this project.",
-        blocking: false,
-      };
-    }
-    return safeActivateNextAction();
-  }
-
-  const label = typeof nextAction.label === "string" && nextAction.label.trim()
-    ? nextAction.label.trim()
-    : "Continue working";
-  const command = typeof nextAction.command === "string" && nextAction.command.trim()
-    ? nextAction.command.trim()
-    : null;
-  const reason = typeof nextAction.reason === "string" && nextAction.reason.trim()
-    ? nextAction.reason.trim()
-    : (status === "first_value_ready" || status === "active"
-      ? "Activation has already completed in this project."
-      : "Activation has not run yet in this project.");
-  const blocking = nextAction.blocking === true;
-
-  if ((status === "first_value_ready" || status === "active") && command === PUBLIC_ACTIVATE_COMMAND) {
-    return {
-      label: "Continue working",
-      command: null,
-      reason: firstValueAvailable
-        ? "Activation already produced a first-value result in this project."
-        : "Activation has already completed in this project.",
-      blocking: false,
-    };
-  }
-
-  return { label, command, reason, blocking };
-}
-
-function normalizeFirstValue(firstValue) {
-  if (!isNonEmptyObject(firstValue)) {
-    return {
-      available: false,
-      summary: null,
-    };
-  }
-  return {
-    available: firstValue.available === true,
-    summary: typeof firstValue.summary === "string" && firstValue.summary.trim() ? firstValue.summary.trim() : null,
-  };
-}
-
-function buildActivationSummary(cwd) {
-  const warnings = [];
-  const activationProbe = probeJson(cwd, ACTIVATION_STATE_REL);
-  const accountProbe = probeJson(cwd, USER_STATE_REL);
-  const activationState = readActivationState(cwd);
-  const accountState = readAccountState(cwd);
-
-  if (activationProbe.unreadable) {
-    warnings.push("Activation state is unreadable; rerun activation to refresh local state.");
-  }
-  if (accountProbe.unreadable) {
-    warnings.push("Account state is unreadable; using safe local defaults.");
-  }
-
-  const activationStatus = typeof activationState?.status === "string" && activationState.status.trim()
-    ? activationState.status.trim()
-    : "not_started";
-  const firstValue = normalizeFirstValue(activationState?.firstValue);
-  const enabledIntegrations = normalizeEnabledIntegrations(activationState?.enabledIntegrations);
-  const activationAccount = isNonEmptyObject(activationState?.account) ? activationState.account : {};
-  const connected = accountProbe.exists
-    ? accountState.connected
-    : activationAccount.connected === true;
-  const plan = accountProbe.exists
-    ? accountState.plan
-    : (typeof activationAccount.plan === "string" && activationAccount.plan.trim()
-      ? String(activationAccount.plan).trim().toLowerCase()
-      : "free");
-  const localOnly = accountProbe.exists
-    ? accountState.localOnly
-    : connected !== true;
-  const present = activationProbe.exists
-    && !activationProbe.unreadable
-    && activationStatus !== "not_started";
-
-  const nextAction = present
-    ? normalizeNextAction(activationState?.nextAction, activationStatus, firstValue.available)
-    : safeActivateNextAction();
-
-  return {
-    present,
-    status: present ? activationStatus : "not_started",
-    firstValue,
-    account: {
-      connected,
-      plan,
-      localOnly,
-    },
-    enabledIntegrations,
-    nextAction,
-    warnings,
-  };
-}
-
-function summarizeIntegrationList(enabledIntegrations) {
-  const visible = normalizeEnabledIntegrations(enabledIntegrations).filter((item) => {
-    if (item === "local") return false;
-    if (item.endsWith("-project-ready")) return false;
-    if (item.endsWith("-context-pack")) return false;
-    if (item.endsWith("-local-layer")) return false;
-    return true;
-  });
-  return visible.length ? visible.join(",") : "none";
-}
-
-function formatActivationStatusLine(summary) {
-  if (!summary?.present) {
-    return `Activation: not activated · run ${PUBLIC_ACTIVATE_COMMAND}`;
-  }
-
-  const statusLabel = summary.status === "first_value_ready"
-    ? "ready"
-    : summary.status === "not_started"
-      ? "not activated"
-      : summary.status;
-  const modeLabel = summary.account?.connected === true ? "connected" : "local-only";
-  const plan = summary.account?.plan || "unknown";
-  const integrations = summarizeIntegrationList(summary.enabledIntegrations);
-  let line = `Activation: ${statusLabel} · ${modeLabel} · ${plan} · ${integrations}`;
-  if (Array.isArray(summary.warnings) && summary.warnings.length) {
-    line += ` · warning: ${summary.warnings[0]}`;
-  }
-  return line;
-}
-
-module.exports = {
-  PUBLIC_ACTIVATE_COMMAND,
-  buildActivationSummary,
-  formatActivationStatusLine,
-};

package/scripts/lib/activation/adapters/claude-code.js

@@ -1,77 +0,0 @@
-"use strict";
-
-const fs = require("fs");
-const path = require("path");
-const { safeWriteJson, safeWriteText, nowIso } = require("../../fsx");
-
-function hasLocalAvoreloState(cwd) {
-  return fs.existsSync(path.join(cwd, ".claude", "cco", "config.json"));
-}
-
-function getActivationStatus(cwd) {
-  try {
-    const raw = fs.readFileSync(path.join(cwd, ".claude", "cco", "state", "activation.json"), "utf8");
-    return JSON.parse(raw).status || null;
-  } catch {
-    return null;
-  }
-}
-
-module.exports = {
-  id: "claude-code",
-  label: "Claude Code",
-  depth: "deep",
-  canAutoConfigure: true,
-  detect(cwd) {
-    return (
-      fs.existsSync(path.join(cwd, ".claude")) ||
-      fs.existsSync(path.join(cwd, "CLAUDE.md")) ||
-      fs.existsSync(path.join(cwd, ".claude-plugin"))
-    );
-  },
-  getInstallState(cwd) {
-    const status = getActivationStatus(cwd);
-    if (status === "active") return "active";
-    if (hasLocalAvoreloState(cwd)) return "configured";
-    return this.detect(cwd) ? "available" : "not_installed";
-  },
-  getRecommendedActions() {
-    return [
-      {
-        label: "Install the Claude Code plugin",
-        command: "/plugin install avorelo@avorelo-marketplace",
-        reason: "Claude Code can provide the deepest Avorelo integration once the plugin is installed.",
-      },
-    ];
-  },
-  configureIfSafe(cwd, options = {}) {
-    const rel = ".claude/cco/state/hosts/claude-code.json";
-    safeWriteJson(cwd, rel, {
-      id: "claude-code",
-      configuredAt: nowIso(),
-      contextPack: options.contextPackRel || null,
-      manualStepRequired: true,
-    });
-    safeWriteText(
-      cwd,
-      ".claude/cco/reports/claude-code-activation.md",
-      [
-        "# Claude Code Setup",
-        "",
-        "Run this inside Claude Code:",
-        "",
-        "/plugin install avorelo@avorelo-marketplace",
-      ].join("\n")
-    );
-    return {
-      applied: true,
-      integrationId: "claude-code-project-ready",
-      wrote: [rel, ".claude/cco/reports/claude-code-activation.md"],
-    };
-  },
-  getLimitations() {
-    return [
-      "Plugin installation still requires a manual command inside Claude Code.",
-    ];
-  },
-};

package/scripts/lib/activation/adapters/codex-cli.js

@@ -1,52 +0,0 @@
-"use strict";
-
-const fs = require("fs");
-const path = require("path");
-const { commandExists } = require("../detect-environment");
-const { safeWriteJson, nowIso } = require("../../fsx");
-
-module.exports = {
-  id: "codex-cli",
-  label: "Codex CLI",
-  depth: "host-aware",
-  canAutoConfigure: true,
-  detect(cwd, options = {}) {
-    const env = options.env || process.env;
-    return (
-      fs.existsSync(path.join(cwd, ".codex")) ||
-      Boolean(env.CODEX_HOME) ||
-      commandExists("codex", env)
-    );
-  },
-  getInstallState(cwd, options = {}) {
-    return this.detect(cwd, options) ? "configured" : "not_installed";
-  },
-  getRecommendedActions() {
-    return [
-      {
-        label: "Use the local context pack from Codex",
-        command: "avorelo status",
-        reason: "Codex CLI can pick up the same local project state once activation completes.",
-      },
-    ];
-  },
-  configureIfSafe(cwd, options = {}) {
-    const rel = ".claude/cco/state/hosts/codex-cli.json";
-    safeWriteJson(cwd, rel, {
-      id: "codex-cli",
-      configuredAt: nowIso(),
-      contextPack: options.contextPackRel || null,
-      mode: "project-local",
-    });
-    return {
-      applied: true,
-      integrationId: "codex-cli-context-pack",
-      wrote: [rel],
-    };
-  },
-  getLimitations() {
-    return [
-      "Activation Router v1 does not mutate global Codex configuration.",
-    ];
-  },
-};

package/scripts/lib/activation/adapters/cursor.js

@@ -1,37 +0,0 @@
-"use strict";
-
-const fs = require("fs");
-const path = require("path");
-
-module.exports = {
-  id: "cursor",
-  label: "Cursor",
-  depth: "host-aware",
-  canAutoConfigure: false,
-  detect(cwd) {
-    return (
-      fs.existsSync(path.join(cwd, ".cursor")) ||
-      fs.existsSync(path.join(cwd, ".cursorignore"))
-    );
-  },
-  getInstallState(cwd) {
-    return this.detect(cwd) ? "available" : "not_installed";
-  },
-  getRecommendedActions() {
-    return [
-      {
-        label: "Keep using local Avorelo status in Cursor",
-        command: "avorelo status",
-        reason: "Cursor can benefit from the same project-scoped Avorelo context without extra setup.",
-      },
-    ];
-  },
-  configureIfSafe() {
-    return { applied: false, reason: "Activation Router v1 keeps Cursor setup project-local and non-invasive." };
-  },
-  getLimitations() {
-    return [
-      "Cursor-specific settings are not mutated automatically.",
-    ];
-  },
-};

package/scripts/lib/activation/adapters/github-agent.js

@@ -1,39 +0,0 @@
-"use strict";
-
-const fs = require("fs");
-const path = require("path");
-const { commandExists } = require("../detect-environment");
-
-module.exports = {
-  id: "github-agent",
-  label: "GitHub Agent Workflows",
-  depth: "host-aware",
-  canAutoConfigure: false,
-  detect(cwd, options = {}) {
-    const env = options.env || process.env;
-    return (
-      fs.existsSync(path.join(cwd, ".github")) ||
-      commandExists("gh", env)
-    );
-  },
-  getInstallState(cwd, options = {}) {
-    return this.detect(cwd, options) ? "available" : "not_installed";
-  },
-  getRecommendedActions() {
-    return [
-      {
-        label: "Review GitHub agent workflows later",
-        command: null,
-        reason: "GitHub agent integration is intentionally optional in Activation Router v1.",
-      },
-    ];
-  },
-  configureIfSafe() {
-    return { applied: false, reason: "Activation Router v1 does not change GitHub workflows automatically." };
-  },
-  getLimitations() {
-    return [
-      "GitHub agent integration remains optional and manual in Activation Router v1.",
-    ];
-  },
-};

package/scripts/lib/activation/adapters/terminal.js

@@ -1,42 +0,0 @@
-"use strict";
-
-const { safeWriteJson, nowIso } = require("../../fsx");
-
-module.exports = {
-  id: "terminal",
-  label: "Terminal",
-  depth: "local",
-  canAutoConfigure: true,
-  detect() {
-    return true;
-  },
-  getInstallState(cwd) {
-    return "active";
-  },
-  getRecommendedActions() {
-    return [
-      {
-        label: "Run compact Avorelo status from the terminal",
-        command: "avorelo status --text",
-        reason: "The universal local layer works immediately from the terminal.",
-      },
-    ];
-  },
-  configureIfSafe(cwd, options = {}) {
-    const rel = ".claude/cco/state/hosts/terminal.json";
-    safeWriteJson(cwd, rel, {
-      id: "terminal",
-      configuredAt: nowIso(),
-      contextPack: options.contextPackRel || null,
-      ready: true,
-    });
-    return {
-      applied: true,
-      integrationId: "terminal-local-layer",
-      wrote: [rel],
-    };
-  },
-  getLimitations() {
-    return [];
-  },
-};

package/scripts/lib/activation/adapters/vscode.js

@@ -1,39 +0,0 @@
-"use strict";
-
-const fs = require("fs");
-const path = require("path");
-
-module.exports = {
-  id: "vscode",
-  label: "VS Code",
-  depth: "host-aware",
-  canAutoConfigure: false,
-  detect(cwd) {
-    if (fs.existsSync(path.join(cwd, ".vscode"))) return true;
-    try {
-      return fs.readdirSync(cwd).some((name) => name.endsWith(".code-workspace"));
-    } catch {
-      return false;
-    }
-  },
-  getInstallState(cwd) {
-    return this.detect(cwd) ? "available" : "not_installed";
-  },
-  getRecommendedActions() {
-    return [
-      {
-        label: "Open this project in VS Code",
-        command: null,
-        reason: "Avorelo local state is ready and VS Code can use the same project-scoped signals.",
-      },
-    ];
-  },
-  configureIfSafe() {
-    return { applied: false, reason: "No project-scoped VS Code mutation is required for Activation Router v1." };
-  },
-  getLimitations() {
-    return [
-      "Activation Router v1 does not modify VS Code settings automatically.",
-    ];
-  },
-};

package/scripts/lib/activation/adapters/windsurf.js

@@ -1,37 +0,0 @@
-"use strict";
-
-const fs = require("fs");
-const path = require("path");
-
-module.exports = {
-  id: "windsurf",
-  label: "Windsurf",
-  depth: "host-aware",
-  canAutoConfigure: false,
-  detect(cwd) {
-    return (
-      fs.existsSync(path.join(cwd, ".windsurf")) ||
-      fs.existsSync(path.join(cwd, ".windsurfrules"))
-    );
-  },
-  getInstallState(cwd) {
-    return this.detect(cwd) ? "available" : "not_installed";
-  },
-  getRecommendedActions() {
-    return [
-      {
-        label: "Use Avorelo local status from Windsurf",
-        command: "avorelo status",
-        reason: "Windsurf can reuse the same local Avorelo signals once project state exists.",
-      },
-    ];
-  },
-  configureIfSafe() {
-    return { applied: false, reason: "Activation Router v1 does not write Windsurf settings automatically." };
-  },
-  getLimitations() {
-    return [
-      "Windsurf deep integration is deferred beyond Activation Router v1.",
-    ];
-  },
-};

package/scripts/lib/activation/ai-surface-detector.js

@@ -1,151 +0,0 @@
-"use strict";
-
-const fs = require("fs");
-const path = require("path");
-const net = require("net");
-
-// AI surface file markers
-const AI_SURFACE_MARKERS = Object.freeze([
-  { id: "claude_md",       label: "CLAUDE.md",              rel: "CLAUDE.md" },
-  { id: "claude_dir",      label: ".claude directory",       rel: ".claude" },
-  { id: "agents_md",       label: "AGENTS.md",              rel: "AGENTS.md" },
-  { id: "cursor_rules",    label: "Cursor rules",           rel: ".cursor/rules" },
-  { id: "cursor_dir",      label: ".cursor directory",      rel: ".cursor" },
-  { id: "windsurf_rules",  label: "Windsurf rules",         rel: ".windsurf/rules" },
-  { id: "windsurf_dir",    label: ".windsurf directory",    rel: ".windsurf" },
-  { id: "gemini_md",       label: "GEMINI.md",              rel: "GEMINI.md" },
-  { id: "copilot",         label: "Copilot instructions",   rel: ".github/copilot-instructions.md" },
-  { id: "vscode_ws",       label: "VS Code workspace",      rel: ".vscode" },
-  { id: "avorelo_guidance", label: "Avorelo guidance",     rel: ".claude/cco" },
-  { id: "llms_txt",        label: "llms.txt",               rel: "llms.txt" },
-]);
-
-const MODEL_PROVIDER_ENV_KEYS = Object.freeze([
-  { id: "anthropic_api_key",   key: "ANTHROPIC_API_KEY",   label: "Anthropic API" },
-  { id: "openai_api_key",      key: "OPENAI_API_KEY",      label: "OpenAI API" },
-  { id: "google_api_key",      key: "GOOGLE_API_KEY",      label: "Google API" },
-  { id: "anthropic_base_url",  key: "ANTHROPIC_BASE_URL",  label: "Anthropic base URL override" },
-  { id: "openai_base_url",     key: "OPENAI_BASE_URL",     label: "OpenAI base URL override" },
-  { id: "litellm_api_key",     key: "LITELLM_API_KEY",     label: "LiteLLM API key" },
-  { id: "ollama_host",         key: "OLLAMA_HOST",         label: "Ollama host override" },
-]);
-
-const LOCAL_ENDPOINTS = Object.freeze([
-  { id: "litellm_4000",   host: "127.0.0.1", port: 4000, label: "LiteLLM (4000)" },
-  { id: "litellm_4001",   host: "127.0.0.1", port: 4001, label: "LiteLLM (4001)" },
-  { id: "ollama_11434",   host: "127.0.0.1", port: 11434, label: "Ollama (11434)" },
-  { id: "lmstudio_1234",  host: "127.0.0.1", port: 1234, label: "LM Studio (1234)" },
-]);
-
-function detectAiSurfaces(cwd, options = {}) {
-  const surfaces = [];
-  for (const marker of AI_SURFACE_MARKERS) {
-    try {
-      const abs = path.join(cwd, marker.rel);
-      if (fs.existsSync(abs)) {
-        const stat = fs.statSync(abs);
-        surfaces.push({
-          id: marker.id,
-          label: marker.label,
-          rel: marker.rel,
-          isDir: stat.isDirectory(),
-        });
-      }
-    } catch {
-      // skip
-    }
-  }
-  return surfaces;
-}
-
-function detectModelRoutingEnv(env) {
-  const env_ = env || process.env;
-  const detected = [];
-  for (const { id, key, label } of MODEL_PROVIDER_ENV_KEYS) {
-    if (env_[key] !== undefined && env_[key] !== "") {
-      detected.push({ id, key, label, present: true });
-    }
-  }
-  return detected;
-}
-
-// Safe TCP probe: short timeout, no data sent, no prompt sent
-function probeLocalPort(host, port, timeoutMs = 300) {
-  return new Promise((resolve) => {
-    const socket = new net.Socket();
-    let resolved = false;
-    const done = (result) => {
-      if (!resolved) {
-        resolved = true;
-        socket.destroy();
-        resolve(result);
-      }
-    };
-    socket.setTimeout(timeoutMs);
-    socket.once("connect", () => done(true));
-    socket.once("error", () => done(false));
-    socket.once("timeout", () => done(false));
-    try {
-      socket.connect(port, host);
-    } catch {
-      done(false);
-    }
-  });
-}
-
-async function detectLocalEndpoints(options = {}) {
-  const results = [];
-  const probeEnabled = options.probeLocalEndpoints !== false;
-  for (const ep of LOCAL_ENDPOINTS) {
-    let listening = false;
-    if (probeEnabled) {
-      try {
-        listening = await probeLocalPort(ep.host, ep.port);
-      } catch {
-        listening = false;
-      }
-    }
-    results.push({ ...ep, listening });
-  }
-  return results;
-}
-
-function detectLocalEndpointsSync(options = {}) {
-  // Sync version - no probing, just report config hints from env
-  return LOCAL_ENDPOINTS.map((ep) => ({ ...ep, listening: false, syncOnly: true }));
-}
-
-function deriveRoutingStatus(envProviders, localEndpoints) {
-  const hasEnvKey = envProviders.length > 0;
-  const hasListening = localEndpoints.some((ep) => ep.listening);
-  if (hasEnvKey && hasListening) return "ready";
-  if (hasEnvKey || hasListening) return "partial";
-  return "unknown";
-}
-
-function detectModelRouting(cwd, options = {}) {
-  const env = options.env || process.env;
-  const envProviders = detectModelRoutingEnv(env);
-  const localEndpoints = detectLocalEndpointsSync(options);
-  const routingStatus = deriveRoutingStatus(envProviders, localEndpoints);
-  return {
-    status: routingStatus,
-    envProviders,
-    localEndpoints,
-    redacted: true,
-    note: "Env key names only — values not included.",
-  };
-}
-
-module.exports = {
-  AI_SURFACE_MARKERS,
-  MODEL_PROVIDER_ENV_KEYS,
-  LOCAL_ENDPOINTS,
-  detectAiSurfaces,
-  detectModelRoutingEnv,
-  probeLocalPort,
-  detectLocalEndpoints,
-  detectLocalEndpointsSync,
-  deriveRoutingStatus,
-  detectModelRouting,
-};