@marcopeg/hal 1.0.32 → 1.0.34

package/dist/wizard/config-builder.js

@@ -0,0 +1,199 @@
+import { stringify as stringifyYaml } from "yaml";
+const DOCS_CONFIG = "https://github.com/marcopeg/hal/blob/main/docs/config/README.md";
+/**
+ * Build the final config object by merging wizard results over the existing
+ * config (if any), then serialize it in the appropriate format.
+ */
+export function buildConfigFromResults(ctx) {
+    const results = ctx.results;
+    const secretsMode = results.secretsMode ?? "env";
+    const projectEdits = ctx.results.projectEdits ?? {};
+    // Determine project key and name
+    const projectKey = results.projectKey ??
+        (ctx.existingConfig?.projects
+            ? Object.keys(ctx.existingConfig.projects)[0]
+            : undefined) ??
+        "prj1";
+    const projectName = results.projectName;
+    // Start from existing config or a fresh skeleton
+    const base = ctx.existingConfig
+        ? JSON.parse(JSON.stringify(ctx.existingConfig)) // deep clone
+        : {};
+    // Ensure projects map exists
+    if (!base.projects)
+        base.projects = {};
+    if (!base.projects[projectKey])
+        base.projects[projectKey] = {};
+    const project = base.projects[projectKey];
+    // Apply project name
+    if (projectEdits[projectKey]?.name) {
+        project.name = projectEdits[projectKey].name;
+    }
+    else if (projectName) {
+        project.name = projectName;
+    }
+    else {
+        // Do not force deletion for existing projects; only remove when explicitly reset in future.
+        if (!ctx.existingConfig)
+            delete project.name;
+    }
+    // Apply cwd
+    if (projectEdits[projectKey]?.cwd) {
+        project.cwd = projectEdits[projectKey].cwd;
+    }
+    else if (results.cwd) {
+        project.cwd = results.cwd;
+    }
+    // Apply cwd edits for any other projects
+    for (const [k, edit] of Object.entries(projectEdits)) {
+        if (!edit.cwd)
+            continue;
+        if (!base.projects[k])
+            base.projects[k] = {};
+        base.projects[k].cwd = edit.cwd;
+        if (edit.name && edit.name.trim() !== "") {
+            base.projects[k].name = edit.name;
+        }
+    }
+    // Engines enabled (providers) + default engine (globals)
+    if (Array.isArray(results.enabledEngines)) {
+        // Create a providers map that enables /engine switching.
+        // Use null so it stays lean; runtime CLI discovery can still populate names.
+        const enabled = results.enabledEngines;
+        base.providers = base.providers ?? {};
+        const providers = {};
+        for (const e of enabled)
+            providers[e] = null;
+        base.providers = providers;
+    }
+    if (results.engine || results.model || results.session !== undefined) {
+        base.globals = base.globals ?? {};
+        base.globals.engine = base.globals.engine ?? {};
+        const globalsEngine = base.globals.engine;
+        if (results.engine)
+            globalsEngine.name = results.engine;
+        if (results.model)
+            globalsEngine.model = results.model;
+        if (results.session !== undefined) {
+            globalsEngine.session = results.session;
+        }
+        // Keep project config lean: remove project.engine when it only duplicates globals
+        if (results.engine) {
+            const projects = base.projects ?? {};
+            for (const p of Object.values(projects)) {
+                if (!p.engine)
+                    continue;
+                const pe = p.engine;
+                const sameName = pe.name === globalsEngine.name;
+                const sameModel = pe.model === globalsEngine.model;
+                const sameSession = pe.session === globalsEngine.session ||
+                    pe.session === undefined;
+                if (sameName && sameModel && sameSession) {
+                    delete p.engine;
+                }
+            }
+        }
+    }
+    // Secrets: bot token + user IDs can be inline or via .env placeholders
+    let envEntries;
+    const editedProjectKeys = Object.keys(projectEdits);
+    const tokenTargets = editedProjectKeys.length > 0
+        ? editedProjectKeys
+        : results.botToken
+            ? [projectKey]
+            : [];
+    for (const k of tokenTargets) {
+        if (!base.projects[k])
+            base.projects[k] = {};
+        const p = base.projects[k];
+        const token = projectEdits[k]?.botToken ??
+            (k === projectKey ? results.botToken : undefined);
+        if (!token)
+            continue;
+        if (!p.telegram)
+            p.telegram = {};
+        if (secretsMode === "inline") {
+            p.telegram.botToken = token;
+            continue;
+        }
+        // Prefer keeping an existing placeholder var name when present.
+        const existing = p.telegram.botToken;
+        let varName = null;
+        if (typeof existing === "string") {
+            const m = /^\$\{([^}]+)\}$/.exec(existing.trim());
+            if (m)
+                varName = m[1]?.trim() || null;
+        }
+        if (!varName) {
+            varName = `${k.replace(/[^A-Za-z0-9]+/g, "_").toUpperCase()}_TELEGRAM_TOKEN`;
+        }
+        // Intentional placeholder — not a template literal
+        p.telegram.botToken = String.raw `\${${varName}}`;
+        envEntries = { ...(envEntries ?? {}), [varName]: token };
+    }
+    // Apply user IDs to globals.access
+    const allUserIds = [];
+    if (results.userId)
+        allUserIds.push(results.userId);
+    if (Array.isArray(results.additionalUserIds)) {
+        allUserIds.push(...results.additionalUserIds);
+    }
+    if (allUserIds.length > 0) {
+        base.globals = base.globals ?? {};
+        base.globals.access = base.globals.access ?? {};
+        if (secretsMode === "inline") {
+            base.globals.access.allowedUserIds = allUserIds;
+        }
+        else {
+            const placeholders = [];
+            allUserIds.forEach((id, idx) => {
+                const key = idx === 0 ? "TELEGRAM_USER_ID" : `TELEGRAM_USER_ID_${idx + 1}`;
+                placeholders.push(`\${${key}}`);
+                envEntries = { ...(envEntries ?? {}), [key]: String(id) };
+            });
+            base.globals.access.allowedUserIds = placeholders;
+        }
+    }
+    // Serialize with fixed key order: providers, globals, projects
+    const format = ctx.existingConfigFormat ?? "yaml";
+    const targetPath = ctx.existingConfigPath ?? `${ctx.cwd}/hal.config.yaml`;
+    let content;
+    if (format === "yaml") {
+        content = buildYamlContent(base);
+    }
+    else {
+        const ordered = orderTopLevelKeys(base);
+        content = `${JSON.stringify(ordered, null, 2)}\n`;
+    }
+    return { content, targetPath, envEntries };
+}
+/** Top-level key order and blank line between sections. */
+const TOP_LEVEL_ORDER = [
+    "providers",
+    "globals",
+    "projects",
+];
+function orderTopLevelKeys(config) {
+    const out = {};
+    for (const key of TOP_LEVEL_ORDER) {
+        const v = config[key];
+        if (v !== undefined && v !== null)
+            out[key] = v;
+    }
+    return out;
+}
+function buildYamlContent(config) {
+    const header = [
+        "# HAL configuration",
+        `# Full config docs: ${DOCS_CONFIG}`,
+        "",
+    ].join("\n");
+    const ordered = orderTopLevelKeys(config);
+    const body = stringifyYaml(ordered, { indent: 2 });
+    // Insert blank line before each top-level key except the first
+    const withBlanks = body
+        .replace(/\n(globals:)/m, "\n\n$1")
+        .replace(/\n(projects:)/m, "\n\n$1");
+    return `${header}\n${withBlanks}`;
+}
+//# sourceMappingURL=config-builder.js.map

package/dist/wizard/config-builder.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"config-builder.js","sourceRoot":"","sources":["../../src/wizard/config-builder.ts"],"names":[],"mappings":"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"}

package/dist/wizard/confirm-and-write.d.ts

@@ -0,0 +1,7 @@
+import type { WizardContext } from "./types.js";
+/**
+ * Final wizard step: show summary, confirm, write config, offer to start.
+ * Stores `ctx.results.startBot = true` when the user wants to start.
+ */
+export declare function runConfirmAndWrite(ctx: WizardContext): Promise<void>;
+//# sourceMappingURL=confirm-and-write.d.ts.map

package/dist/wizard/confirm-and-write.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"confirm-and-write.d.ts","sourceRoot":"","sources":["../../src/wizard/confirm-and-write.ts"],"names":[],"mappings":"AAOA,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,YAAY,CAAC;AAEhD;;;GAGG;AACH,wBAAsB,kBAAkB,CAAC,GAAG,EAAE,aAAa,GAAG,OAAO,CAAC,IAAI,CAAC,CAgG1E"}

package/dist/wizard/confirm-and-write.js

@@ -0,0 +1,135 @@
+import { existsSync, readFileSync, writeFileSync } from "node:fs";
+import { join } from "node:path";
+import { confirm, select } from "@clack/prompts";
+import { resolveCustomEnvPaths } from "../config.js";
+import { getEngine } from "../engine/index.js";
+import { buildConfigFromResults } from "./config-builder.js";
+import { guardCancel } from "./runner.js";
+/**
+ * Final wizard step: show summary, confirm, write config, offer to start.
+ * Stores `ctx.results.startBot = true` when the user wants to start.
+ */
+export async function runConfirmAndWrite(ctx) {
+    // Ask secrets mode before generating previews
+    const secretsMode = await select({
+        message: "Where should API keys and user IDs be stored?",
+        options: [
+            { value: "env", label: "Use .env variables (recommended)" },
+            { value: "inline", label: "Inline in config file" },
+        ],
+    });
+    guardCancel(secretsMode);
+    ctx.results.secretsMode = secretsMode;
+    const built = buildConfigFromResults(ctx);
+    console.log("\n─── Proposed configuration ──────────────────────────────\n");
+    console.log(built.content);
+    console.log("─────────────────────────────────────────────────────────\n");
+    if (built.envEntries && Object.keys(built.envEntries).length > 0) {
+        const envPath = pickEnvPath(ctx);
+        console.log(`Proposed ${envPath} entries:\n`);
+        for (const [k, v] of Object.entries(built.envEntries)) {
+            console.log(`  ${k}=${v}`);
+        }
+        console.log("\n─────────────────────────────────────────────────────────\n");
+    }
+    const ok = await confirm({
+        message: built.envEntries && Object.keys(built.envEntries).length > 0
+            ? "Write config and .env changes?"
+            : "Write this configuration?",
+    });
+    guardCancel(ok);
+    if (!ok) {
+        console.log("Aborted. No files were written.");
+        process.exit(0);
+    }
+    // Write config file
+    writeFileSync(built.targetPath, built.content, "utf-8");
+    console.log(`\n  Config written: ${built.targetPath}`);
+    // Write env entries
+    if (built.envEntries && Object.keys(built.envEntries).length > 0) {
+        const envPath = pickEnvPath(ctx);
+        upsertEnvFile(envPath, built.envEntries);
+        console.log(`  Env updated:    ${envPath}`);
+    }
+    // Create engine instructions file if missing
+    const engineName = ctx.results.engine;
+    if (engineName) {
+        try {
+            const engine = getEngine(engineName, undefined, "");
+            const instrFile = engine.instructionsFile();
+            const instrPath = join(ctx.cwd, instrFile);
+            if (!existsSync(instrPath)) {
+                writeFileSync(instrPath, "# Project Instructions\n\nAdd your project-specific instructions here.\n", "utf-8");
+                console.log(`  Created:        ${instrFile}`);
+            }
+        }
+        catch {
+            // engine lookup failed — not critical
+        }
+    }
+    console.log("");
+    const action = await select({
+        message: "What would you like to do next?",
+        options: [
+            { value: "start", label: "Start the bot now" },
+            { value: "exit", label: "Exit" },
+        ],
+    });
+    guardCancel(action);
+    if (action === "start") {
+        ctx.results.startBot = true;
+    }
+    else {
+        console.log("Setup complete! Run `npx @marcopeg/hal` when you're ready.");
+        process.exit(0);
+    }
+}
+function pickEnvPath(ctx) {
+    // Respect existing config's custom env path (task 041).
+    const configured = ctx.existingConfig?.env;
+    if (typeof configured === "string" && configured.trim() !== "") {
+        const { mainPath } = resolveCustomEnvPaths(ctx.cwd, configured);
+        return mainPath;
+    }
+    const envLocal = join(ctx.cwd, ".env.local");
+    const env = join(ctx.cwd, ".env");
+    if (existsSync(env))
+        return env;
+    if (existsSync(envLocal))
+        return envLocal;
+    return env;
+}
+function upsertEnvFile(envPath, entries) {
+    const content = existsSync(envPath) ? readFileSync(envPath, "utf-8") : "";
+    const lines = content.split(/\r?\n/);
+    const keys = new Set(Object.keys(entries));
+    const out = [];
+    const seen = new Set();
+    for (const line of lines) {
+        const m = /^([A-Za-z_][A-Za-z0-9_]*)=(.*)$/.exec(line);
+        if (!m) {
+            out.push(line);
+            continue;
+        }
+        const key = m[1];
+        if (!keys.has(key)) {
+            out.push(line);
+            continue;
+        }
+        if (seen.has(key))
+            continue;
+        out.push(`${key}=${entries[key]}`);
+        seen.add(key);
+    }
+    for (const [k, v] of Object.entries(entries)) {
+        if (seen.has(k))
+            continue;
+        if (out.length > 0 && out[out.length - 1] !== "")
+            out.push("");
+        out.push(`${k}=${v}`);
+    }
+    // Ensure trailing newline
+    const final = out.join("\n").replace(/\n*$/, "\n");
+    writeFileSync(envPath, final, "utf-8");
+}
+//# sourceMappingURL=confirm-and-write.js.map

package/dist/wizard/confirm-and-write.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"confirm-and-write.js","sourceRoot":"","sources":["../../src/wizard/confirm-and-write.ts"],"names":[],"mappings":"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"}

package/dist/wizard/engine-discovery.d.ts

@@ -0,0 +1,8 @@
+export type EngineName = "claude" | "copilot" | "codex" | "opencode" | "cursor" | "antigravity";
+/**
+ * Async (non-blocking) engine availability discovery.
+ * Runs `<cmd> --version` checks in parallel (with a per-engine timeout).
+ */
+export declare function discoverAvailableEngines(timeoutMsPerEngine?: number): Promise<EngineName[]>;
+export declare function defaultEngineCommand(engine: EngineName): string;
+//# sourceMappingURL=engine-discovery.d.ts.map

package/dist/wizard/engine-discovery.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"engine-discovery.d.ts","sourceRoot":"","sources":["../../src/wizard/engine-discovery.ts"],"names":[],"mappings":"AAEA,MAAM,MAAM,UAAU,GAClB,QAAQ,GACR,SAAS,GACT,OAAO,GACP,UAAU,GACV,QAAQ,GACR,aAAa,CAAC;AAiClB;;;GAGG;AACH,wBAAsB,wBAAwB,CAC5C,kBAAkB,SAAO,GACxB,OAAO,CAAC,UAAU,EAAE,CAAC,CAiBvB;AAED,wBAAgB,oBAAoB,CAAC,MAAM,EAAE,UAAU,GAAG,MAAM,CAE/D"}

package/dist/wizard/engine-discovery.js

@@ -0,0 +1,55 @@
+import { spawn } from "node:child_process";
+const DEFAULT_ENGINE_COMMAND = {
+    claude: "claude",
+    copilot: "copilot",
+    codex: "codex",
+    opencode: "opencode",
+    cursor: "agent",
+    antigravity: "gemini",
+};
+function runVersionCheck(command, timeoutMs) {
+    return new Promise((resolve) => {
+        const proc = spawn(command, ["--version"], {
+            stdio: ["ignore", "ignore", "ignore"],
+        });
+        const timer = setTimeout(() => {
+            try {
+                proc.kill();
+            }
+            catch { }
+            resolve(false);
+        }, timeoutMs);
+        proc.on("error", () => {
+            clearTimeout(timer);
+            resolve(false);
+        });
+        proc.on("exit", (code) => {
+            clearTimeout(timer);
+            resolve(code === 0);
+        });
+    });
+}
+/**
+ * Async (non-blocking) engine availability discovery.
+ * Runs `<cmd> --version` checks in parallel (with a per-engine timeout).
+ */
+export async function discoverAvailableEngines(timeoutMsPerEngine = 1500) {
+    const engines = [
+        "claude",
+        "copilot",
+        "codex",
+        "opencode",
+        "cursor",
+        "antigravity",
+    ];
+    const checks = await Promise.all(engines.map(async (e) => {
+        const cmd = DEFAULT_ENGINE_COMMAND[e];
+        const ok = await runVersionCheck(cmd, timeoutMsPerEngine);
+        return ok ? e : null;
+    }));
+    return checks.filter((x) => x !== null);
+}
+export function defaultEngineCommand(engine) {
+    return DEFAULT_ENGINE_COMMAND[engine];
+}
+//# sourceMappingURL=engine-discovery.js.map

package/dist/wizard/engine-discovery.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"engine-discovery.js","sourceRoot":"","sources":["../../src/wizard/engine-discovery.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,KAAK,EAAE,MAAM,oBAAoB,CAAC;AAU3C,MAAM,sBAAsB,GAA+B;IACzD,MAAM,EAAE,QAAQ;IAChB,OAAO,EAAE,SAAS;IAClB,KAAK,EAAE,OAAO;IACd,QAAQ,EAAE,UAAU;IACpB,MAAM,EAAE,OAAO;IACf,WAAW,EAAE,QAAQ;CACtB,CAAC;AAEF,SAAS,eAAe,CAAC,OAAe,EAAE,SAAiB;IACzD,OAAO,IAAI,OAAO,CAAC,CAAC,OAAO,EAAE,EAAE;QAC7B,MAAM,IAAI,GAAG,KAAK,CAAC,OAAO,EAAE,CAAC,WAAW,CAAC,EAAE;YACzC,KAAK,EAAE,CAAC,QAAQ,EAAE,QAAQ,EAAE,QAAQ,CAAC;SACtC,CAAC,CAAC;QACH,MAAM,KAAK,GAAG,UAAU,CAAC,GAAG,EAAE;YAC5B,IAAI,CAAC;gBACH,IAAI,CAAC,IAAI,EAAE,CAAC;YACd,CAAC;YAAC,MAAM,CAAC,CAAA,CAAC;YACV,OAAO,CAAC,KAAK,CAAC,CAAC;QACjB,CAAC,EAAE,SAAS,CAAC,CAAC;QACd,IAAI,CAAC,EAAE,CAAC,OAAO,EAAE,GAAG,EAAE;YACpB,YAAY,CAAC,KAAK,CAAC,CAAC;YACpB,OAAO,CAAC,KAAK,CAAC,CAAC;QACjB,CAAC,CAAC,CAAC;QACH,IAAI,CAAC,EAAE,CAAC,MAAM,EAAE,CAAC,IAAI,EAAE,EAAE;YACvB,YAAY,CAAC,KAAK,CAAC,CAAC;YACpB,OAAO,CAAC,IAAI,KAAK,CAAC,CAAC,CAAC;QACtB,CAAC,CAAC,CAAC;IACL,CAAC,CAAC,CAAC;AACL,CAAC;AAED;;;GAGG;AACH,MAAM,CAAC,KAAK,UAAU,wBAAwB,CAC5C,kBAAkB,GAAG,IAAI;IAEzB,MAAM,OAAO,GAAiB;QAC5B,QAAQ;QACR,SAAS;QACT,OAAO;QACP,UAAU;QACV,QAAQ;QACR,aAAa;KACd,CAAC;IACF,MAAM,MAAM,GAAG,MAAM,OAAO,CAAC,GAAG,CAC9B,OAAO,CAAC,GAAG,CAAC,KAAK,EAAE,CAAC,EAAE,EAAE;QACtB,MAAM,GAAG,GAAG,sBAAsB,CAAC,CAAC,CAAC,CAAC;QACtC,MAAM,EAAE,GAAG,MAAM,eAAe,CAAC,GAAG,EAAE,kBAAkB,CAAC,CAAC;QAC1D,OAAO,EAAE,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,IAAI,CAAC;IACvB,CAAC,CAAC,CACH,CAAC;IACF,OAAO,MAAM,CAAC,MAAM,CAAC,CAAC,CAAC,EAAmB,EAAE,CAAC,CAAC,KAAK,IAAI,CAAC,CAAC;AAC3D,CAAC;AAED,MAAM,UAAU,oBAAoB,CAAC,MAAkB;IACrD,OAAO,sBAAsB,CAAC,MAAM,CAAC,CAAC;AACxC,CAAC"}

package/dist/wizard/index.d.ts

@@ -0,0 +1,14 @@
+import type { PrefillFlags } from "./types.js";
+export type { PrefillFlags };
+/**
+ * Main entry point for the interactive setup wizard.
+ *
+ * @param cwd      Config directory (where hal.config.* lives or will be created).
+ * @param prefill  Pre-fill values from CLI flags; their steps are skipped.
+ * @param reset    When true, re-ask all questions even if values already exist.
+ * @returns        true when the wizard completes and requests bot start; false otherwise.
+ */
+export declare function startWizard(cwd: string, prefill: PrefillFlags, reset: boolean, options?: {
+    showBanner?: boolean;
+}): Promise<boolean>;
+//# sourceMappingURL=index.d.ts.map

package/dist/wizard/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/wizard/index.ts"],"names":[],"mappings":"AAMA,OAAO,KAAK,EAAiB,YAAY,EAAiB,MAAM,YAAY,CAAC;AAE7E,YAAY,EAAE,YAAY,EAAE,CAAC;AAsC7B;;;;;;;GAOG;AACH,wBAAsB,WAAW,CAC/B,GAAG,EAAE,MAAM,EACX,OAAO,EAAE,YAAY,EACrB,KAAK,EAAE,OAAO,EACd,OAAO,CAAC,EAAE;IAAE,UAAU,CAAC,EAAE,OAAO,CAAA;CAAE,GACjC,OAAO,CAAC,OAAO,CAAC,CA+ElB"}

package/dist/wizard/index.js

@@ -0,0 +1,116 @@
+import { readFileSync } from "node:fs";
+import { parseConfigContent, resolveConfigFile } from "../config.js";
+import { runConfirmAndWrite } from "./confirm-and-write.js";
+import { discoverAvailableEngines } from "./engine-discovery.js";
+import { runWizard } from "./runner.js";
+import { finalSteps, globalSteps, projectSteps } from "./steps/index.js";
+function supportsAnsiColor(out = process.stdout, env = process.env) {
+    if (!out.isTTY)
+        return false;
+    if ("NO_COLOR" in env)
+        return false;
+    if ((env.TERM ?? "").toLowerCase() === "dumb")
+        return false;
+    return true;
+}
+function renderHalBanner(useColor) {
+    const subtitle = "MULTI-ENGINE TELEGRAM COMMAND DECK FOR AI CODING AGENTS";
+    const frame = "================================================================";
+    const accentStart = useColor ? "\u001b[31;1m" : "";
+    const accentEnd = useColor ? "\u001b[0m" : "";
+    return [
+        frame,
+        "",
+        " _   _      _      _     ",
+        "| | | |    / \\    | |    ",
+        "| |_| |   / _ \\   | |    ",
+        "|  _  |  / ___ \\  | |___ ",
+        "|_| |_| /_/   \\_\\ |_____|",
+        "",
+        `${accentStart}${subtitle}${accentEnd}`,
+        "",
+        frame,
+    ].join("\n");
+}
+function printWizardBanner(out = process.stdout) {
+    const banner = renderHalBanner(supportsAnsiColor(out));
+    out.write(`${banner}\n\n`);
+}
+/**
+ * Main entry point for the interactive setup wizard.
+ *
+ * @param cwd      Config directory (where hal.config.* lives or will be created).
+ * @param prefill  Pre-fill values from CLI flags; their steps are skipped.
+ * @param reset    When true, re-ask all questions even if values already exist.
+ * @returns        true when the wizard completes and requests bot start; false otherwise.
+ */
+export async function startWizard(cwd, prefill, reset, options) {
+    if (options?.showBanner !== false) {
+        printWizardBanner();
+    }
+    let existingConfig = null;
+    let existingConfigPath = null;
+    let existingConfigFormat = null;
+    const resolved = resolveConfigFile(cwd, "hal.config");
+    if (resolved) {
+        existingConfigPath = resolved.path;
+        existingConfigFormat = resolved.format;
+        try {
+            const raw = readFileSync(resolved.path, "utf-8");
+            existingConfig = parseConfigContent(raw, resolved.format, resolved.path);
+        }
+        catch {
+            existingConfig = null;
+        }
+    }
+    const ctx = {
+        cwd,
+        existingConfig,
+        existingConfigPath,
+        existingConfigFormat,
+        prefill,
+        reset,
+        availableEnginesPromise: discoverAvailableEngines(),
+        targetProjectKeys: undefined,
+        currentProjectKey: null,
+        results: {},
+    };
+    // Identify projects to fill.
+    const existingKeys = Object.keys(existingConfig?.projects ?? {});
+    if (existingKeys.length === 0) {
+        // Fresh setup: default to a single project (key prj1); name is asked after cwd.
+        ctx.targetProjectKeys = ["prj1"];
+        ctx.results.projectKey = "prj1";
+    }
+    else {
+        // Existing config: fill only active projects (active !== false).
+        const keys = existingKeys.filter((k) => {
+            const p = existingConfig?.projects?.[k];
+            return p?.active !== false;
+        });
+        ctx.targetProjectKeys = keys.length > 0 ? keys : existingKeys;
+        // Primary project key drives which project is considered for "engine is configured" checks.
+        ctx.results.projectKey = ctx.targetProjectKeys[0];
+    }
+    // Global missing info (access list, enabled providers/default engine, etc.)
+    await runWizard(ctx, globalSteps);
+    // Project-scoped missing info (cwd, name, bot token, etc.)
+    const targets = ctx.targetProjectKeys ?? [];
+    if (targets.length > 1) {
+        process.stdout.write("\nFilling missing project settings...\n");
+    }
+    for (const projectKey of targets) {
+        ctx.currentProjectKey = projectKey;
+        if (targets.length > 1) {
+            process.stdout.write(`\nProject: ${projectKey}\n`);
+        }
+        await runWizard(ctx, projectSteps);
+    }
+    // Final global required info (user id)
+    ctx.currentProjectKey = null;
+    await runWizard(ctx, finalSteps);
+    await runConfirmAndWrite(ctx);
+    // confirm-and-write stores startBot = true when user chooses to start
+    return ctx.results.startBot === true;
+}
+//# sourceMappingURL=index.js.map

package/dist/wizard/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/wizard/index.ts"],"names":[],"mappings":"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"}

package/dist/wizard/runner.d.ts

@@ -0,0 +1,16 @@
+import type { WizardContext, WizardStep } from "./types.js";
+/**
+ * Iterates through the step registry. For each step:
+ * - Skips if isConfigured() returns true AND --reset is false.
+ * - If shouldSkip() returns true (e.g. prefill provided), runs the step without prompting.
+ * - Shows progress ("Step N of M").
+ * - Calls run().
+ * - Handles Ctrl+C (isCancel) at any point via a thrown symbol that prompts catch.
+ */
+export declare function runWizard(ctx: WizardContext, steps: WizardStep[]): Promise<void>;
+/**
+ * Call after any @clack/prompts prompt returns a value to check for cancellation.
+ * Exits the process cleanly if the user pressed Ctrl+C.
+ */
+export declare function guardCancel(value: unknown): void;
+//# sourceMappingURL=runner.d.ts.map

package/dist/wizard/runner.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"runner.d.ts","sourceRoot":"","sources":["../../src/wizard/runner.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,aAAa,EAAE,UAAU,EAAE,MAAM,YAAY,CAAC;AAE5D;;;;;;;GAOG;AACH,wBAAsB,SAAS,CAC7B,GAAG,EAAE,aAAa,EAClB,KAAK,EAAE,UAAU,EAAE,GAClB,OAAO,CAAC,IAAI,CAAC,CA8Bf;AAED;;;GAGG;AACH,wBAAgB,WAAW,CAAC,KAAK,EAAE,OAAO,GAAG,IAAI,CAKhD"}

package/dist/wizard/runner.js

@@ -0,0 +1,47 @@
+import { isCancel, outro } from "@clack/prompts";
+/**
+ * Iterates through the step registry. For each step:
+ * - Skips if isConfigured() returns true AND --reset is false.
+ * - If shouldSkip() returns true (e.g. prefill provided), runs the step without prompting.
+ * - Shows progress ("Step N of M").
+ * - Calls run().
+ * - Handles Ctrl+C (isCancel) at any point via a thrown symbol that prompts catch.
+ */
+export async function runWizard(ctx, steps) {
+    const promptingSteps = ctx.reset
+        ? steps
+        : steps.filter((s) => {
+            const skip = s.shouldSkip?.(ctx) ?? false;
+            if (skip)
+                return false;
+            if (s.isConfigured(ctx))
+                return false;
+            return true;
+        });
+    let shown = 0;
+    for (const step of steps) {
+        const skip = !ctx.reset && (step.shouldSkip?.(ctx) ?? false);
+        const configured = !ctx.reset && step.isConfigured(ctx);
+        if (configured)
+            continue;
+        if (skip) {
+            // Apply prefill silently (no progress line, no prompt expected).
+            await step.run(ctx);
+            continue;
+        }
+        shown += 1;
+        process.stdout.write(`\n[Step ${shown}/${promptingSteps.length}] ${step.label}\n`);
+        await step.run(ctx);
+    }
+}
+/**
+ * Call after any @clack/prompts prompt returns a value to check for cancellation.
+ * Exits the process cleanly if the user pressed Ctrl+C.
+ */
+export function guardCancel(value) {
+    if (isCancel(value)) {
+        outro("Setup cancelled. No files were written.");
+        process.exit(0);
+    }
+}
+//# sourceMappingURL=runner.js.map