@salestouch/cli 0.1.0

package/dist/setup-wizard.js

@@ -0,0 +1,492 @@
+import { box, cancel, confirm, intro, isCancel, log, multiselect, note, password, select, spinner, } from "@clack/prompts";
+import pc from "picocolors";
+import { readFlagBoolean } from "./core.js";
+import { detectCliLocale } from "./locale.js";
+import { resolveSetupAgents } from "./setup.js";
+const SETUP_TRIGGER_FLAGS = [
+    "claude",
+    "cursor",
+    "codex",
+    "opencode",
+    "global",
+    "mcp",
+    "cli",
+    "skills",
+    "no-skills",
+    "local-mcp",
+    "login",
+    "api-key",
+    "access-token",
+];
+const SETUP_STEPS_TOTAL = 5;
+const ORANGE_OPEN = "\u001B[38;5;208m";
+const ORANGE_CLOSE = "\u001B[39m";
+function isFrench(locale) {
+    return locale === "fr";
+}
+function getSetupCancelMessage(locale) {
+    return isFrench(locale) ? "Configuration SalesTouch annulée." : "SalesTouch setup cancelled.";
+}
+function accent(text) {
+    return process.stdout.isTTY ? `${ORANGE_OPEN}${text}${ORANGE_CLOSE}` : text;
+}
+function reorderAgents(recommendedAgent) {
+    const allAgents = ["claude", "cursor", "codex", "opencode"];
+    return [recommendedAgent, ...allAgents.filter((agent) => agent !== recommendedAgent)];
+}
+function formatAgentList(agents, locale = detectCliLocale()) {
+    const labels = agents.map((agent) => getAgentLabel(agent));
+    if (labels.length <= 1) {
+        return labels[0] ?? "";
+    }
+    if (labels.length === 2) {
+        return isFrench(locale) ? `${labels[0]} et ${labels[1]}` : `${labels[0]} and ${labels[1]}`;
+    }
+    const head = labels.slice(0, -1).join(", ");
+    const tail = labels[labels.length - 1];
+    return isFrench(locale) ? `${head} et ${tail}` : `${head}, and ${tail}`;
+}
+function getAgentLabel(agent) {
+    switch (agent) {
+        case "claude":
+            return "Claude";
+        case "cursor":
+            return "Cursor";
+        case "codex":
+            return "Codex";
+        case "opencode":
+            return "OpenCode";
+    }
+}
+function getModeLabel(mode, mcpTarget, locale = detectCliLocale()) {
+    if (mode === "cli") {
+        return "CLI";
+    }
+    if (isFrench(locale)) {
+        return mcpTarget === "remote" ? "MCP distant" : "MCP local";
+    }
+    return mcpTarget === "remote" ? "Remote MCP" : "Local MCP";
+}
+function getScopeLabel(scope, locale = detectCliLocale()) {
+    if (isFrench(locale)) {
+        return scope === "global" ? "Global" : "Projet";
+    }
+    return scope === "global" ? "Global" : "Project";
+}
+function getScopePitch(scope, locale = detectCliLocale()) {
+    if (isFrench(locale)) {
+        return scope === "global"
+            ? "Installez-le une fois et gardez SalesTouch prêt partout où vous travaillez."
+            : "Gardez-le dans ce repo pour que la configuration voyage avec le projet.";
+    }
+    return scope === "global"
+        ? "Set it once and keep SalesTouch ready wherever you work."
+        : "Keep it in this repo so the setup travels with the project.";
+}
+function getAuthChoiceLabel(authChoice, existingAuth, locale = detectCliLocale()) {
+    if (authChoice === "reuse") {
+        if (isFrench(locale)) {
+            return existingAuth?.authMethod === "api_key"
+                ? "Utiliser la clé API existante"
+                : "Utiliser la connexion existante";
+        }
+        return existingAuth?.authMethod === "api_key" ? "Use existing API key" : "Use existing login";
+    }
+    if (authChoice === "login") {
+        return isFrench(locale) ? "Se connecter dans le navigateur" : "Sign in with browser";
+    }
+    return isFrench(locale) ? "Clé API" : "API key";
+}
+function canUseApiKeyForSelection(agent, mode, mcpTarget) {
+    return !(agent === "codex" && mode === "mcp" && mcpTarget === "remote");
+}
+function getStepTitle(step, title, locale = detectCliLocale()) {
+    return `${isFrench(locale) ? "Étape" : "Step"} ${step}/${SETUP_STEPS_TOTAL} · ${title}`;
+}
+function getAgentPitch(agent, locale = detectCliLocale()) {
+    if (isFrench(locale)) {
+        switch (agent) {
+            case "claude":
+                return "L'expérience SalesTouch la plus fluide aujourd'hui si vous voulez vitesse, contexte et finition.";
+            case "cursor":
+                return "Un très bon choix quand votre prospection vit à côté du code, de la doc et de l'exécution.";
+            case "codex":
+                return "Idéal pour les agents IA natifs au repo et les workflows pilotés par AGENTS.";
+            case "opencode":
+                return "Un workflow plus léger et plus ouvert, avec SalesTouch branché directement dans la boucle.";
+        }
+    }
+    switch (agent) {
+        case "claude":
+            return "The smoothest SalesTouch experience today if you want speed, context and polish.";
+        case "cursor":
+            return "A strong fit when prospecting sits next to your code, docs and execution.";
+        case "codex":
+            return "Ideal for repo-native AI agents and AGENTS-driven workflows.";
+        case "opencode":
+            return "A lighter open workflow with SalesTouch plugged straight into the loop.";
+    }
+}
+function getAgentSelectionPitch(agents, locale = detectCliLocale()) {
+    if (agents.length <= 1) {
+        return getAgentPitch(agents[0] ?? "codex", locale);
+    }
+    return isFrench(locale)
+        ? `SalesTouch va s'installer en une passe dans ${formatAgentList(agents, locale)}.`
+        : `SalesTouch will install across ${formatAgentList(agents, locale)} in one pass.`;
+}
+function getModePitch(mode, mcpTarget, locale = detectCliLocale()) {
+    if (isFrench(locale)) {
+        if (mode === "cli") {
+            return "Recommandé. Rapide, fiable et simple à faire confiance. SalesTouch donne à votre agent IA les bonnes commandes et les bons garde-fous.";
+        }
+        return mcpTarget === "remote"
+            ? "Donnez à votre agent IA le contexte, les tools et les resources SalesTouch en direct, sans lancer de serveur local."
+            : "Gardez le MCP sur votre machine si vous voulez un fallback 100% local.";
+    }
+    if (mode === "cli") {
+        return "Recommended. Fast, reliable, and easy to trust. SalesTouch gives your AI agent the right commands and guardrails.";
+    }
+    return mcpTarget === "remote"
+        ? "Give your AI agent live SalesTouch context, tools and resources without running a local server."
+        : "Keep the MCP on your machine when you want a fully local fallback.";
+}
+function getSkillsChoiceLabel(installSkills, locale = detectCliLocale()) {
+    if (isFrench(locale)) {
+        return installSkills ? "Oui, installer les skills" : "Non, sans les skills";
+    }
+    return installSkills ? "Yes, install the skills" : "No, skip the skills";
+}
+function getSkillsPitch(installSkills, mode, locale = detectCliLocale()) {
+    if (isFrench(locale)) {
+        return installSkills
+            ? mode === "mcp"
+                ? "Les skills SalesTouch seront installés en plus de la config MCP pour mieux guider votre agent."
+                : "Les skills SalesTouch seront installés avec la config CLI pour mieux guider votre agent."
+            : "La configuration sera installée sans les skills. Vous pourrez les réinstaller plus tard avec `salestouch skills reinstall`.";
+    }
+    return installSkills
+        ? mode === "mcp"
+            ? "SalesTouch skills will be installed alongside the MCP config to guide your agent."
+            : "SalesTouch skills will be installed alongside the CLI setup to guide your agent."
+        : "The setup will be installed without skills. You can reinstall them later with `salestouch skills reinstall`.";
+}
+function getAuthPitch(authChoice, locale = detectCliLocale()) {
+    if (isFrench(locale)) {
+        switch (authChoice) {
+            case "reuse":
+                return "Repartez tout de suite avec ce qui est déjà configuré.";
+            case "login":
+                return "Connectez-vous une fois dans le navigateur, puis laissez SalesTouch prêt pour les prochaines sessions.";
+            case "api_key":
+                return "Le bon choix pour l'automatisation ou quand vous voulez garder un contrôle total sur les credentials.";
+        }
+    }
+    switch (authChoice) {
+        case "reuse":
+            return "Pick up where you left off and reuse what is already configured.";
+        case "login":
+            return "Connect once in the browser, then let SalesTouch stay ready for future sessions.";
+        case "api_key":
+            return "Best for automation or for setups where you want full credential control.";
+    }
+}
+function getBrandHeader(locale = detectCliLocale()) {
+    return `${pc.bold(accent("SalesTouch"))} ${pc.bold(accent(isFrench(locale) ? "Configuration" : "Setup"))}`;
+}
+export function shouldRunSetupWizard(flags, isInteractive) {
+    if (!isInteractive || readFlagBoolean(flags, "json")) {
+        return false;
+    }
+    return !SETUP_TRIGGER_FLAGS.some((flag) => flags[flag] !== undefined);
+}
+export function buildSetupWizardAuthChoices(params) {
+    const { agent, agents = agent ? [agent] : [], mode, mcpTarget, existingAuth, locale = detectCliLocale(), } = params;
+    const choices = [];
+    const supportsApiKey = agents.every((candidate) => canUseApiKeyForSelection(candidate, mode, mcpTarget));
+    const canReuseExistingAuth = existingAuth !== null &&
+        (existingAuth.authMethod === "session" || supportsApiKey);
+    if (canReuseExistingAuth) {
+        choices.push({
+            label: getAuthChoiceLabel("reuse", existingAuth, locale),
+            value: "reuse",
+            hint: isFrench(locale)
+                ? "Continuez avec les identifiants déjà stockés dans la config CLI ou dans l'env"
+                : "Keep going with the credentials already stored in the CLI config or env",
+        });
+    }
+    choices.push({
+        label: getAuthChoiceLabel("login", null, locale),
+        value: "login",
+        hint: isFrench(locale)
+            ? "Lancez une fois le flow de connexion SalesTouch et gardez la session prête"
+            : "Run the SalesTouch login flow once and keep the session ready",
+    });
+    if (supportsApiKey) {
+        choices.push({
+            label: isFrench(locale) ? "Coller une clé API" : "Paste an API key",
+            value: "api_key",
+            hint: isFrench(locale)
+                ? "Utilisez une clé API SalesTouch pour l'automatisation ou un setup non interactif"
+                : "Use a SalesTouch API key for automation or non-interactive setup",
+        });
+    }
+    return choices;
+}
+export function applySetupWizardSelections(flags, selections) {
+    const nextFlags = {
+        ...flags,
+        [selections.mode]: true,
+    };
+    for (const agent of selections.agents) {
+        nextFlags[agent] = true;
+    }
+    if (selections.scope === "global") {
+        nextFlags.global = true;
+    }
+    if (selections.mode === "mcp" && selections.mcpTarget === "local") {
+        nextFlags["local-mcp"] = true;
+    }
+    if (!selections.installSkills) {
+        nextFlags["no-skills"] = true;
+    }
+    if (selections.authChoice === "login") {
+        nextFlags.login = true;
+    }
+    else if (selections.authChoice === "api_key" && selections.apiKey) {
+        nextFlags["api-key"] = selections.apiKey;
+    }
+    return nextFlags;
+}
+function unwrapPromptResult(value) {
+    if (isCancel(value)) {
+        cancel(getSetupCancelMessage(detectCliLocale()));
+        return null;
+    }
+    return value;
+}
+async function promptChoice(question, choices, defaultIndex = 0, locale = detectCliLocale()) {
+    const options = choices.map((choice, index) => ({
+        value: choice.value,
+        label: index === defaultIndex
+            ? `${choice.label} ${pc.dim(isFrench(locale) ? "(recommandé)" : "(recommended)")}`
+            : choice.label,
+        hint: choice.hint,
+    }));
+    return unwrapPromptResult(await select({
+        message: question,
+        initialValue: choices[defaultIndex]?.value,
+        options,
+    }));
+}
+async function promptMultiChoice(question, choices, initialValues) {
+    const options = choices.map((choice) => ({
+        value: choice.value,
+        label: choice.label,
+        hint: choice.hint,
+    }));
+    return unwrapPromptResult(await multiselect({
+        message: question,
+        options,
+        initialValues,
+        required: true,
+    }));
+}
+async function promptApiKey(question, locale = detectCliLocale(), defaultValue = "st_") {
+    return unwrapPromptResult(await password({
+        message: question,
+        mask: "*",
+        validate(value) {
+            if (!value || !value.trim()) {
+                return isFrench(locale) ? "Valeur requise." : "Value required.";
+            }
+            if (!value.trim().startsWith(defaultValue)) {
+                return isFrench(locale)
+                    ? "Les clés API SalesTouch commencent par `st_`."
+                    : "SalesTouch API keys start with `st_`.";
+            }
+            return undefined;
+        },
+    }));
+}
+function buildWizardSummary(params) {
+    const { agents, mode, scope, mcpTarget, installSkills, authChoice, existingAuth, locale = detectCliLocale(), } = params;
+    return [
+        `${pc.bold(isFrench(locale) ? "Agents IA" : "AI agents")}      ${formatAgentList(agents, locale)}`,
+        `${pc.bold(isFrench(locale) ? "Installation" : "Install in")}   ${getScopeLabel(scope, locale)}`,
+        `${pc.bold(isFrench(locale) ? "Connexion" : "Connection")}     ${getModeLabel(mode, mcpTarget, locale)}`,
+        `${pc.bold(isFrench(locale) ? "Skills" : "Skills")}         ${getSkillsChoiceLabel(installSkills, locale)}`,
+        `${pc.bold(isFrench(locale) ? "Accès" : "Sign-in")}          ${getAuthChoiceLabel(authChoice, existingAuth, locale)}`,
+    ].join("\n");
+}
+export async function runInteractiveSetupWizard(params) {
+    const locale = detectCliLocale();
+    intro(getBrandHeader(locale));
+    box([
+        isFrench(locale)
+            ? `${pc.bold("Transformez votre agent IA préféré en équipe de recherche personnelle pour une prospection plus juste.")}`
+            : `${pc.bold("Turn your favorite AI agent into a personal research team for better prospecting.")}`,
+        isFrench(locale)
+            ? "Quelques choix, et SalesTouch s'occupe de la config, de la rule et, si vous le voulez, du pack de skills."
+            : "A few choices, and SalesTouch takes care of the config, the rule, and optionally the skill pack.",
+        "",
+        `${pc.dim(isFrench(locale) ? "Contrôles" : "Controls")}  ${isFrench(locale) ? "flèches pour naviguer · Entrée pour confirmer · Ctrl+C pour annuler" : "arrows to move · Enter to confirm · Ctrl+C to cancel"}`,
+    ].join("\n"), isFrench(locale) ? "Créez des relations, pas du spam." : "Build relationships, not spam.", {
+        rounded: true,
+        contentPadding: 1,
+        titleAlign: "left",
+    });
+    const scope = await promptChoice(getStepTitle(1, isFrench(locale) ? "Choisissez où l'installer" : "Choose where to install", locale), [
+        {
+            label: isFrench(locale) ? "Ce repo" : "This repo",
+            value: "project",
+            hint: isFrench(locale)
+                ? "Gardez la configuration SalesTouch au plus près du projet sur lequel vous travaillez"
+                : "Keep the SalesTouch setup close to the project you are working on",
+        },
+        {
+            label: isFrench(locale) ? "Toute votre machine" : "Your whole machine",
+            value: "global",
+            hint: isFrench(locale)
+                ? "Installez une fois dans votre config perso et réutilisez partout"
+                : "Install once in your home config and reuse it everywhere",
+        },
+    ], 0, locale);
+    if (!scope) {
+        return null;
+    }
+    log.step(getScopePitch(scope, locale));
+    const detectionSpinner = spinner();
+    detectionSpinner.start(isFrench(locale)
+        ? "Recherche d'agents IA déjà disponibles sur cette machine"
+        : "Looking for AI agents already available on this machine");
+    const detectedAgents = await resolveSetupAgents([], scope);
+    detectionSpinner.stop(detectedAgents.length > 0
+        ? `${isFrench(locale) ? "Détecté" : "Found"} ${detectedAgents.map((agent) => getAgentLabel(agent)).join(", ")}`
+        : isFrench(locale)
+            ? "Aucun agent détecté. Codex est le point de départ le plus sûr."
+            : "No agent detected. Codex is the safest starting point.");
+    const recommendedAgent = detectedAgents[0] ?? "codex";
+    const orderedAgents = reorderAgents(recommendedAgent);
+    if (detectedAgents.length > 0) {
+        note(isFrench(locale)
+            ? `${getAgentLabel(recommendedAgent)} a été détecté dans votre environnement ${scope === "global" ? "global" : "de projet"}.`
+            : `Detected ${getAgentLabel(recommendedAgent)} from your current ${scope === "global" ? "home" : "project"} environment.`, isFrench(locale) ? "Meilleur match" : "Best match");
+    }
+    const suggestedAgents = detectedAgents.length > 0 ? detectedAgents : [recommendedAgent];
+    const agents = await promptMultiChoice(getStepTitle(2, isFrench(locale) ? "Choisissez vos agents IA" : "Choose your AI agents", locale), orderedAgents.map((candidate) => ({
+        label: getAgentLabel(candidate),
+        value: candidate,
+        hint: detectedAgents.includes(candidate)
+            ? isFrench(locale)
+                ? "Détecté sur cette machine"
+                : "Detected on this machine"
+            : isFrench(locale)
+                ? "Supporté, mais non détecté ici"
+                : "Supported, but not detected here",
+    })), suggestedAgents);
+    if (!agents || agents.length === 0) {
+        return null;
+    }
+    log.step(getAgentSelectionPitch(agents, locale));
+    const setupType = await promptChoice(getStepTitle(3, isFrench(locale) ? "Choisissez le style de setup" : "Choose the setup style", locale), [
+        {
+            label: isFrench(locale) ? "Mode Copilote · CLI" : "Copilot mode · CLI",
+            value: { mode: "cli", mcpTarget: "remote" },
+            hint: isFrench(locale)
+                ? "Le meilleur défaut. Commandes fiables, bons garde-fous, presque zéro friction."
+                : "Best default. Reliable commands, strong guardrails, and almost zero friction.",
+        },
+        {
+            label: isFrench(locale) ? "Mode Live · MCP distant" : "Live mode · Remote MCP",
+            value: { mode: "mcp", mcpTarget: "remote" },
+            hint: isFrench(locale)
+                ? "Laissez votre agent IA parler directement au serveur MCP hébergé par SalesTouch."
+                : "Let your AI agent talk directly to the hosted SalesTouch MCP server.",
+        },
+        {
+            label: isFrench(locale) ? "Mode Manuel · MCP local" : "Hands-on mode · Local MCP",
+            value: { mode: "mcp", mcpTarget: "local" },
+            hint: isFrench(locale)
+                ? "Lancez `pnpm salestouch mcp serve` vous-même si vous voulez un fallback local."
+                : "Run `pnpm salestouch mcp serve` yourself when you want a local fallback.",
+        },
+    ], 0, locale);
+    if (!setupType) {
+        return null;
+    }
+    note(getModePitch(setupType.mode, setupType.mcpTarget, locale), isFrench(locale) ? "Style choisi" : "Selected style");
+    const installSkills = await promptChoice(getStepTitle(4, isFrench(locale) ? "Choisissez si vous voulez les skills" : "Choose whether to install skills", locale), [
+        {
+            label: getSkillsChoiceLabel(true, locale),
+            value: true,
+            hint: isFrench(locale)
+                ? "Recommandé. Ajoute le pack SalesTouch dans vos agents IA."
+                : "Recommended. Adds the SalesTouch skill pack to your AI agents.",
+        },
+        {
+            label: getSkillsChoiceLabel(false, locale),
+            value: false,
+            hint: isFrench(locale)
+                ? "Installe seulement la config et les rules. Vous pourrez remettre les skills plus tard."
+                : "Install only the config and rules. You can bring the skills back later.",
+        },
+    ], 0, locale);
+    if (installSkills === null) {
+        return null;
+    }
+    log.step(getSkillsPitch(installSkills, setupType.mode, locale));
+    const authChoices = buildSetupWizardAuthChoices({
+        agents,
+        mode: setupType.mode,
+        mcpTarget: setupType.mcpTarget,
+        existingAuth: params.existingAuth,
+        locale,
+    });
+    const defaultAuthIndex = authChoices.findIndex((choice) => choice.value === "reuse");
+    const authChoice = await promptChoice(getStepTitle(5, isFrench(locale) ? "Choisissez comment vous connecter" : "Choose how to connect", locale), authChoices, defaultAuthIndex >= 0 ? defaultAuthIndex : 0, locale);
+    if (!authChoice) {
+        return null;
+    }
+    log.step(getAuthPitch(authChoice, locale));
+    let apiKey = null;
+    if (authChoice === "api_key") {
+        apiKey = await promptApiKey(isFrench(locale) ? "Collez votre clé API SalesTouch" : "Paste your SalesTouch API key", locale);
+        if (!apiKey) {
+            return null;
+        }
+    }
+    note(buildWizardSummary({
+        agents,
+        mode: setupType.mode,
+        scope,
+        mcpTarget: setupType.mcpTarget,
+        installSkills,
+        authChoice,
+        existingAuth: params.existingAuth,
+        locale,
+    }), isFrench(locale) ? "Votre setup" : "Your setup");
+    const shouldContinue = unwrapPromptResult(await confirm({
+        message: isFrench(locale) ? "C'est le bon setup ?" : "Does this look right?",
+        initialValue: true,
+        active: isFrench(locale) ? "Installer" : "Install it",
+        inactive: isFrench(locale) ? "Annuler" : "Cancel",
+        vertical: true,
+    }));
+    if (shouldContinue !== true) {
+        cancel(getSetupCancelMessage(locale));
+        return null;
+    }
+    log.step(isFrench(locale)
+        ? `Connexion de SalesTouch à ${formatAgentList(agents, locale)}.`
+        : `Bringing SalesTouch into ${formatAgentList(agents, locale)}.`);
+    return {
+        agents,
+        mode: setupType.mode,
+        scope,
+        mcpTarget: setupType.mcpTarget,
+        installSkills,
+        authChoice,
+        apiKey,
+    };
+}

package/dist/setup.d.ts

@@ -0,0 +1,51 @@
+export type SetupAgent = "claude" | "cursor" | "codex" | "opencode";
+export type SetupMode = "mcp" | "cli";
+export type SetupScope = "project" | "global";
+export type SetupMcpTarget = "remote" | "local";
+export type SetupAuthMode = "oauth" | "api_key" | "local";
+export type SetupManifest = {
+    version: 1;
+    cli_version: string;
+    generated_at: string;
+    scope: SetupScope;
+    mode: SetupMode;
+    mcp_target: SetupMcpTarget | null;
+    auth_mode: SetupAuthMode | null;
+    install_skills: boolean;
+    base_url: string;
+    mcp_url: string | null;
+    agents: SetupAgent[];
+};
+export type SetupResult = {
+    agent: SetupAgent;
+    mode: SetupMode;
+    scope: SetupScope;
+    mcpConfigPath?: string;
+    rulePath: string;
+    skillPath?: string;
+    manifestPath: string;
+};
+export type SkillInstallResult = {
+    agent: SetupAgent;
+    mode: SetupMode;
+    scope: SetupScope;
+    skillPath: string;
+};
+export declare function resolveSetupAgents(requestedAgents: SetupAgent[], scope: SetupScope): Promise<SetupAgent[]>;
+export declare function readSetupManifest(scope: SetupScope): Promise<SetupManifest | null>;
+export declare function runSetup(options: {
+    agents: SetupAgent[];
+    mode: SetupMode;
+    scope: SetupScope;
+    mcpTarget: SetupMcpTarget;
+    authMode: SetupAuthMode;
+    installSkills?: boolean;
+    baseUrl: string;
+    mcpUrl: string;
+    apiKey: string | null;
+}): Promise<SetupResult[]>;
+export declare function runSkillsInstall(options: {
+    agents: SetupAgent[];
+    mode: SetupMode;
+    scope: SetupScope;
+}): Promise<SkillInstallResult[]>;