@marcopeg/hal 1.0.20 → 1.0.23

package/dist/engine/types.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../../src/engine/types.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,OAAO,IAAI,aAAa,EAAE,MAAM,QAAQ,CAAC;AACvD,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,aAAa,CAAC;AAIlD,MAAM,MAAM,UAAU,GAAG,QAAQ,GAAG,SAAS,GAAG,OAAO,GAAG,UAAU,GAAG,QAAQ,CAAC;AAEhF,eAAO,MAAM,YAAY,EAAE,SAAS,UAAU,EAMpC,CAAC;AAIX,MAAM,WAAW,oBAAoB;IACnC,MAAM,EAAE,MAAM,CAAC;IACf,OAAO,EAAE,MAAM,CAAC;IAChB,OAAO,CAAC,EAAE,aAAa,CAAC;IACxB,aAAa,CAAC,EAAE,MAAM,CAAC;IACvB,SAAS,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;IAC1B,UAAU,CAAC,EAAE,CAAC,OAAO,EAAE,MAAM,KAAK,IAAI,CAAC;IACvC,8EAA8E;IAC9E,eAAe,CAAC,EAAE,OAAO,CAAC;IAG1B,cAAc,CAAC,EAAE,OAAO,CAAC;CAC1B;AAED,MAAM,WAAW,YAAY;IAC3B,OAAO,EAAE,OAAO,CAAC;IACjB,MAAM,EAAE,MAAM,CAAC;IACf,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,KAAK,CAAC,EAAE,MAAM,CAAC;CAChB;AAED,MAAM,WAAW,cAAc;IAC7B,IAAI,EAAE,MAAM,CAAC;IACb,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,YAAY,CAAC,EAAE,MAAM,CAAC;CACvB;AAID,MAAM,WAAW,aAAa;IAC5B,iDAAiD;IACjD,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;IACtB,uDAAuD;IACvD,QAAQ,CAAC,OAAO,EAAE,MAAM,CAAC;IACzB,kEAAkE;IAClE,KAAK,IAAI,IAAI,CAAC;IACd,sDAAsD;IACtD,OAAO,CACL,OAAO,EAAE,oBAAoB,EAC7B,GAAG,EAAE,cAAc,GAClB,OAAO,CAAC,YAAY,CAAC,CAAC;IACzB,iDAAiD;IACjD,KAAK,CAAC,MAAM,EAAE,YAAY,GAAG,cAAc,CAAC;IAC5C,qDAAqD;IACrD,SAAS,CAAC,UAAU,EAAE,MAAM,GAAG,MAAM,CAAC;IACtC,4DAA4D;IAC5D,gBAAgB,IAAI,MAAM,CAAC;CAC5B"}
+{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../../src/engine/types.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,OAAO,IAAI,aAAa,EAAE,MAAM,QAAQ,CAAC;AACvD,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,aAAa,CAAC;AAIlD,MAAM,MAAM,UAAU,GAClB,QAAQ,GACR,SAAS,GACT,OAAO,GACP,UAAU,GACV,QAAQ,GACR,aAAa,CAAC;AAElB,eAAO,MAAM,YAAY,EAAE,SAAS,UAAU,EAOpC,CAAC;AAIX,MAAM,WAAW,oBAAoB;IACnC,MAAM,EAAE,MAAM,CAAC;IACf,OAAO,EAAE,MAAM,CAAC;IAChB,OAAO,CAAC,EAAE,aAAa,CAAC;IACxB,aAAa,CAAC,EAAE,MAAM,CAAC;IACvB,SAAS,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;IAC1B,UAAU,CAAC,EAAE,CAAC,OAAO,EAAE,MAAM,KAAK,IAAI,CAAC;IACvC,8EAA8E;IAC9E,eAAe,CAAC,EAAE,OAAO,CAAC;IAG1B,cAAc,CAAC,EAAE,OAAO,CAAC;CAC1B;AAED,MAAM,WAAW,YAAY;IAC3B,OAAO,EAAE,OAAO,CAAC;IACjB,MAAM,EAAE,MAAM,CAAC;IACf,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,KAAK,CAAC,EAAE,MAAM,CAAC;CAChB;AAED,MAAM,WAAW,cAAc;IAC7B,IAAI,EAAE,MAAM,CAAC;IACb,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,YAAY,CAAC,EAAE,MAAM,CAAC;CACvB;AAID,MAAM,WAAW,aAAa;IAC5B,iDAAiD;IACjD,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;IACtB,uDAAuD;IACvD,QAAQ,CAAC,OAAO,EAAE,MAAM,CAAC;IACzB,kEAAkE;IAClE,KAAK,IAAI,IAAI,CAAC;IACd,sDAAsD;IACtD,OAAO,CACL,OAAO,EAAE,oBAAoB,EAC7B,GAAG,EAAE,cAAc,GAClB,OAAO,CAAC,YAAY,CAAC,CAAC;IACzB,iDAAiD;IACjD,KAAK,CAAC,MAAM,EAAE,YAAY,GAAG,cAAc,CAAC;IAC5C,yFAAyF;IACzF,UAAU,CAAC,UAAU,EAAE,MAAM,GAAG,MAAM,EAAE,CAAC;IACzC,4DAA4D;IAC5D,gBAAgB,IAAI,MAAM,CAAC;CAC5B"}

package/dist/engine/types.js

@@ -4,5 +4,6 @@ export const ENGINE_NAMES = [
     "codex",
     "opencode",
     "cursor",
+    "antigravity",
 ];
 //# sourceMappingURL=types.js.map

package/dist/engine/types.js.map

@@ -1 +1 @@
-{"version":3,"file":"types.js","sourceRoot":"","sources":["../../src/engine/types.ts"],"names":[],"mappings":"AAOA,MAAM,CAAC,MAAM,YAAY,GAA0B;IACjD,QAAQ;IACR,SAAS;IACT,OAAO;IACP,UAAU;IACV,QAAQ;CACA,CAAC"}
+{"version":3,"file":"types.js","sourceRoot":"","sources":["../../src/engine/types.ts"],"names":[],"mappings":"AAaA,MAAM,CAAC,MAAM,YAAY,GAA0B;IACjD,QAAQ;IACR,SAAS;IACT,OAAO;IACP,UAAU;IACV,QAAQ;IACR,aAAa;CACL,CAAC"}

package/dist/logger.d.ts

@@ -1,7 +1,8 @@
 import pino from "pino";
 import type { ResolvedProjectConfig } from "./config.js";
 /**
- * A startup logger for CLI-level messages. Always writes to stdout at info level.
+ * A startup logger for CLI-level messages. Writes human-readable lines to stdout
+ * at info level and flushes synchronously so boot order is stable.
  * Used before per-project loggers are created, and for process-level notices.
  */
 export declare function createStartupLogger(): pino.Logger;

package/dist/logger.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"logger.d.ts","sourceRoot":"","sources":["../src/logger.ts"],"names":[],"mappings":"AAGA,OAAO,IAAI,MAAM,MAAM,CAAC;AACxB,OAAO,KAAK,EAAE,qBAAqB,EAAE,MAAM,aAAa,CAAC;AAEzD;;;GAGG;AACH,wBAAgB,mBAAmB,IAAI,IAAI,CAAC,MAAM,CAEjD;AAED;;;;;;;GAOG;AACH,wBAAgB,mBAAmB,CACjC,MAAM,EAAE,qBAAqB,GAC5B,IAAI,CAAC,MAAM,CA4Bb"}
+{"version":3,"file":"logger.d.ts","sourceRoot":"","sources":["../src/logger.ts"],"names":[],"mappings":"AAGA,OAAO,IAAI,MAAM,MAAM,CAAC;AACxB,OAAO,KAAK,EAAE,qBAAqB,EAAE,MAAM,aAAa,CAAC;AA6DzD;;;;GAIG;AACH,wBAAgB,mBAAmB,IAAI,IAAI,CAAC,MAAM,CAEjD;AAED;;;;;;;GAOG;AACH,wBAAgB,mBAAmB,CACjC,MAAM,EAAE,qBAAqB,GAC5B,IAAI,CAAC,MAAM,CA4Bb"}

package/dist/logger.js

@@ -2,12 +2,63 @@ import { createWriteStream, mkdirSync } from "node:fs";
 import { join } from "node:path";
 import { Writable } from "node:stream";
 import pino from "pino";
+const LEVEL_NAMES = {
+    10: "TRACE",
+    20: "DEBUG",
+    30: "INFO",
+    40: "WARN",
+    50: "ERROR",
+    60: "FATAL",
+};
 /**
- * A startup logger for CLI-level messages. Always writes to stdout at info level.
+ * Human-readable stream for terminal logs: parses pino NDJSON and writes
+ * "[HH:mm:ss] LEVEL  message" so boot and runtime output is readable.
+ */
+function createPrettyLogStream(out = process.stdout) {
+    let buffer = "";
+    return new Writable({
+        write(chunk, _enc, cb) {
+            buffer += chunk.toString();
+            const lines = buffer.split("\n");
+            buffer = lines.pop() ?? "";
+            for (const line of lines) {
+                if (!line.trim())
+                    continue;
+                try {
+                    const obj = JSON.parse(line);
+                    const time = obj.time != null ? new Date(obj.time) : new Date();
+                    const ts = time.toTimeString().slice(0, 8);
+                    const levelName = LEVEL_NAMES[obj.level ?? 30] ?? "INFO";
+                    const msg = obj.msg ?? "";
+                    const rest = [];
+                    for (const [k, v] of Object.entries(obj)) {
+                        if (k === "level" ||
+                            k === "time" ||
+                            k === "msg" ||
+                            k === "pid" ||
+                            k === "hostname")
+                            continue;
+                        if (v !== undefined && v !== null)
+                            rest.push(`${k}=${JSON.stringify(v)}`);
+                    }
+                    const suffix = rest.length > 0 ? ` ${rest.join(" ")}` : "";
+                    out.write(`${ts} ${levelName}  ${msg}${suffix}\n`);
+                }
+                catch {
+                    out.write(line + "\n");
+                }
+            }
+            cb();
+        },
+    });
+}
+/**
+ * A startup logger for CLI-level messages. Writes human-readable lines to stdout
+ * at info level and flushes synchronously so boot order is stable.
  * Used before per-project loggers are created, and for process-level notices.
  */
 export function createStartupLogger() {
-    return pino({ level: "info" });
+    return pino({ level: "info" }, createPrettyLogStream());
 }
 /**
  * Create a per-project logger that respects flow and persist settings.
@@ -21,7 +72,7 @@ export function createProjectLogger(config) {
     const { level, flow, persist } = config.logging;
     const streams = [];
     if (flow) {
-        streams.push({ stream: process.stdout });
+        streams.push({ stream: createPrettyLogStream() });
     }
     if (persist) {
         mkdirSync(config.logDir, { recursive: true });

package/dist/logger.js.map

@@ -1 +1 @@
-{"version":3,"file":"logger.js","sourceRoot":"","sources":["../src/logger.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,iBAAiB,EAAE,SAAS,EAAE,MAAM,SAAS,CAAC;AACvD,OAAO,EAAE,IAAI,EAAE,MAAM,WAAW,CAAC;AACjC,OAAO,EAAE,QAAQ,EAAE,MAAM,aAAa,CAAC;AACvC,OAAO,IAAI,MAAM,MAAM,CAAC;AAGxB;;;GAGG;AACH,MAAM,UAAU,mBAAmB;IACjC,OAAO,IAAI,CAAC,EAAE,KAAK,EAAE,MAAM,EAAE,CAAC,CAAC;AACjC,CAAC;AAED;;;;;;;GAOG;AACH,MAAM,UAAU,mBAAmB,CACjC,MAA6B;IAE7B,MAAM,EAAE,KAAK,EAAE,IAAI,EAAE,OAAO,EAAE,GAAG,MAAM,CAAC,OAAO,CAAC;IAEhD,MAAM,OAAO,GAAuB,EAAE,CAAC;IAEvC,IAAI,IAAI,EAAE,CAAC;QACT,OAAO,CAAC,IAAI,CAAC,EAAE,MAAM,EAAE,OAAO,CAAC,MAAM,EAAE,CAAC,CAAC;IAC3C,CAAC;IAED,IAAI,OAAO,EAAE,CAAC;QACZ,SAAS,CAAC,MAAM,CAAC,MAAM,EAAE,EAAE,SAAS,EAAE,IAAI,EAAE,CAAC,CAAC;QAC9C,MAAM,IAAI,GAAG,IAAI,IAAI,EAAE,CAAC,WAAW,EAAE,CAAC,KAAK,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,aAAa;QACjE,MAAM,OAAO,GAAG,IAAI,CAAC,MAAM,CAAC,MAAM,EAAE,GAAG,IAAI,MAAM,CAAC,CAAC;QACnD,OAAO,CAAC,IAAI,CAAC,EAAE,MAAM,EAAE,iBAAiB,CAAC,OAAO,EAAE,EAAE,KAAK,EAAE,GAAG,EAAE,CAAC,EAAE,CAAC,CAAC;IACvE,CAAC;IAED,IAAI,OAAO,CAAC,MAAM,KAAK,CAAC,EAAE,CAAC;QACzB,0EAA0E;QAC1E,OAAO,CAAC,IAAI,CAAC;YACX,MAAM,EAAE,IAAI,QAAQ,CAAC;gBACnB,KAAK,CAAC,MAAM,EAAE,IAAI,EAAE,EAAE;oBACpB,EAAE,EAAE,CAAC;gBACP,CAAC;aACF,CAAC;SACH,CAAC,CAAC;IACL,CAAC;IAED,OAAO,IAAI,CAAC,EAAE,KAAK,EAAE,EAAE,IAAI,CAAC,WAAW,CAAC,OAAO,CAAC,CAAC,CAAC;AACpD,CAAC"}
+{"version":3,"file":"logger.js","sourceRoot":"","sources":["../src/logger.ts"],"names":[],"mappings":"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"}

package/dist/prompts.d.ts

@@ -0,0 +1,19 @@
+/** Close the shared readline. Call once when all prompts are done. */
+export declare function closePrompts(): void;
+export declare function confirm(options: {
+    message: string;
+    default?: boolean;
+}): Promise<boolean>;
+export declare function input(options: {
+    message: string;
+    default?: string;
+    validate?: (val: string) => string | true;
+}): Promise<string>;
+export declare function select<T extends string>(options: {
+    message: string;
+    choices: Array<{
+        name: string;
+        value: T;
+    }>;
+}): Promise<T>;
+//# sourceMappingURL=prompts.d.ts.map

package/dist/prompts.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"prompts.d.ts","sourceRoot":"","sources":["../src/prompts.ts"],"names":[],"mappings":"AA6BA,sEAAsE;AACtE,wBAAgB,YAAY,IAAI,IAAI,CAKnC;AAUD,wBAAsB,OAAO,CAAC,OAAO,EAAE;IACrC,OAAO,EAAE,MAAM,CAAC;IAChB,OAAO,CAAC,EAAE,OAAO,CAAC;CACnB,GAAG,OAAO,CAAC,OAAO,CAAC,CAQnB;AAID,wBAAsB,KAAK,CAAC,OAAO,EAAE;IACnC,OAAO,EAAE,MAAM,CAAC;IAChB,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,QAAQ,CAAC,EAAE,CAAC,GAAG,EAAE,MAAM,KAAK,MAAM,GAAG,IAAI,CAAC;CAC3C,GAAG,OAAO,CAAC,MAAM,CAAC,CAkBlB;AAID,wBAAsB,MAAM,CAAC,CAAC,SAAS,MAAM,EAAE,OAAO,EAAE;IACtD,OAAO,EAAE,MAAM,CAAC;IAChB,OAAO,EAAE,KAAK,CAAC;QAAE,IAAI,EAAE,MAAM,CAAC;QAAC,KAAK,EAAE,CAAC,CAAA;KAAE,CAAC,CAAC;CAC5C,GAAG,OAAO,CAAC,CAAC,CAAC,CAiBb"}

package/dist/prompts.js

@@ -0,0 +1,73 @@
+import { createInterface } from "node:readline";
+let sharedRl = null;
+function getRl() {
+    if (!sharedRl) {
+        sharedRl = createInterface({
+            input: process.stdin,
+            output: process.stdout,
+        });
+        // Clean up when stdin closes naturally
+        sharedRl.on("close", () => {
+            sharedRl = null;
+        });
+    }
+    return sharedRl;
+}
+/** Close the shared readline. Call once when all prompts are done. */
+export function closePrompts() {
+    if (sharedRl) {
+        sharedRl.close();
+        sharedRl = null;
+    }
+}
+function ask(rl, q) {
+    return new Promise((resolve) => {
+        rl.question(q, (answer) => resolve(answer));
+    });
+}
+// ─── confirm ────────────────────────────────────────────────────────────────
+export async function confirm(options) {
+    const defaultVal = options.default ?? true;
+    const hint = defaultVal ? "Y/n" : "y/N";
+    const rl = getRl();
+    const answer = await ask(rl, `? ${options.message} (${hint}) `);
+    const trimmed = answer.trim().toLowerCase();
+    if (trimmed === "")
+        return defaultVal;
+    return trimmed === "y" || trimmed === "yes";
+}
+// ─── input ──────────────────────────────────────────────────────────────────
+export async function input(options) {
+    const rl = getRl();
+    const suffix = options.default ? ` (${options.default})` : "";
+    while (true) {
+        const answer = await ask(rl, `? ${options.message}${suffix} `);
+        const value = answer.trim() || options.default || "";
+        if (options.validate) {
+            const result = options.validate(value);
+            if (result !== true) {
+                console.log(`  ${result}`);
+                continue;
+            }
+        }
+        return value;
+    }
+}
+// ─── select ─────────────────────────────────────────────────────────────────
+export async function select(options) {
+    const { choices } = options;
+    const rl = getRl();
+    console.log(`? ${options.message}`);
+    for (let i = 0; i < choices.length; i++) {
+        console.log(`  ${i + 1}. ${choices[i].name}`);
+    }
+    while (true) {
+        const answer = await ask(rl, `Enter choice (1-${choices.length}): `);
+        const num = Number.parseInt(answer.trim(), 10);
+        if (num >= 1 && num <= choices.length) {
+            return choices[num - 1].value;
+        }
+        console.log(`  Please enter a number between 1 and ${choices.length}.`);
+    }
+}
+//# sourceMappingURL=prompts.js.map

package/dist/prompts.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"prompts.js","sourceRoot":"","sources":["../src/prompts.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,eAAe,EAAE,MAAM,eAAe,CAAC;AAahD,IAAI,QAAQ,GAAc,IAAI,CAAC;AAE/B,SAAS,KAAK;IACZ,IAAI,CAAC,QAAQ,EAAE,CAAC;QACd,QAAQ,GAAG,eAAe,CAAC;YACzB,KAAK,EAAE,OAAO,CAAC,KAAK;YACpB,MAAM,EAAE,OAAO,CAAC,MAAM;SACvB,CAAC,CAAC;QACH,uCAAuC;QACvC,QAAQ,CAAC,EAAE,CAAC,OAAO,EAAE,GAAG,EAAE;YACxB,QAAQ,GAAG,IAAI,CAAC;QAClB,CAAC,CAAC,CAAC;IACL,CAAC;IACD,OAAO,QAAQ,CAAC;AAClB,CAAC;AAED,sEAAsE;AACtE,MAAM,UAAU,YAAY;IAC1B,IAAI,QAAQ,EAAE,CAAC;QACb,QAAQ,CAAC,KAAK,EAAE,CAAC;QACjB,QAAQ,GAAG,IAAI,CAAC;IAClB,CAAC;AACH,CAAC;AAED,SAAS,GAAG,CAAC,EAAM,EAAE,CAAS;IAC5B,OAAO,IAAI,OAAO,CAAC,CAAC,OAAO,EAAE,EAAE;QAC7B,EAAE,CAAC,QAAQ,CAAC,CAAC,EAAE,CAAC,MAAM,EAAE,EAAE,CAAC,OAAO,CAAC,MAAM,CAAC,CAAC,CAAC;IAC9C,CAAC,CAAC,CAAC;AACL,CAAC;AAED,+EAA+E;AAE/E,MAAM,CAAC,KAAK,UAAU,OAAO,CAAC,OAG7B;IACC,MAAM,UAAU,GAAG,OAAO,CAAC,OAAO,IAAI,IAAI,CAAC;IAC3C,MAAM,IAAI,GAAG,UAAU,CAAC,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC,KAAK,CAAC;IACxC,MAAM,EAAE,GAAG,KAAK,EAAE,CAAC;IACnB,MAAM,MAAM,GAAG,MAAM,GAAG,CAAC,EAAE,EAAE,KAAK,OAAO,CAAC,OAAO,KAAK,IAAI,IAAI,CAAC,CAAC;IAChE,MAAM,OAAO,GAAG,MAAM,CAAC,IAAI,EAAE,CAAC,WAAW,EAAE,CAAC;IAC5C,IAAI,OAAO,KAAK,EAAE;QAAE,OAAO,UAAU,CAAC;IACtC,OAAO,OAAO,KAAK,GAAG,IAAI,OAAO,KAAK,KAAK,CAAC;AAC9C,CAAC;AAED,+EAA+E;AAE/E,MAAM,CAAC,KAAK,UAAU,KAAK,CAAC,OAI3B;IACC,MAAM,EAAE,GAAG,KAAK,EAAE,CAAC;IACnB,MAAM,MAAM,GAAG,OAAO,CAAC,OAAO,CAAC,CAAC,CAAC,KAAK,OAAO,CAAC,OAAO,GAAG,CAAC,CAAC,CAAC,EAAE,CAAC;IAE9D,OAAO,IAAI,EAAE,CAAC;QACZ,MAAM,MAAM,GAAG,MAAM,GAAG,CAAC,EAAE,EAAE,KAAK,OAAO,CAAC,OAAO,GAAG,MAAM,GAAG,CAAC,CAAC;QAC/D,MAAM,KAAK,GAAG,MAAM,CAAC,IAAI,EAAE,IAAI,OAAO,CAAC,OAAO,IAAI,EAAE,CAAC;QAErD,IAAI,OAAO,CAAC,QAAQ,EAAE,CAAC;YACrB,MAAM,MAAM,GAAG,OAAO,CAAC,QAAQ,CAAC,KAAK,CAAC,CAAC;YACvC,IAAI,MAAM,KAAK,IAAI,EAAE,CAAC;gBACpB,OAAO,CAAC,GAAG,CAAC,KAAK,MAAM,EAAE,CAAC,CAAC;gBAC3B,SAAS;YACX,CAAC;QACH,CAAC;QAED,OAAO,KAAK,CAAC;IACf,CAAC;AACH,CAAC;AAED,+EAA+E;AAE/E,MAAM,CAAC,KAAK,UAAU,MAAM,CAAmB,OAG9C;IACC,MAAM,EAAE,OAAO,EAAE,GAAG,OAAO,CAAC;IAC5B,MAAM,EAAE,GAAG,KAAK,EAAE,CAAC;IAEnB,OAAO,CAAC,GAAG,CAAC,KAAK,OAAO,CAAC,OAAO,EAAE,CAAC,CAAC;IACpC,KAAK,IAAI,CAAC,GAAG,CAAC,EAAE,CAAC,GAAG,OAAO,CAAC,MAAM,EAAE,CAAC,EAAE,EAAE,CAAC;QACxC,OAAO,CAAC,GAAG,CAAC,KAAK,CAAC,GAAG,CAAC,KAAK,OAAO,CAAC,CAAC,CAAC,CAAC,IAAI,EAAE,CAAC,CAAC;IAChD,CAAC;IAED,OAAO,IAAI,EAAE,CAAC;QACZ,MAAM,MAAM,GAAG,MAAM,GAAG,CAAC,EAAE,EAAE,mBAAmB,OAAO,CAAC,MAAM,KAAK,CAAC,CAAC;QACrE,MAAM,GAAG,GAAG,MAAM,CAAC,QAAQ,CAAC,MAAM,CAAC,IAAI,EAAE,EAAE,EAAE,CAAC,CAAC;QAC/C,IAAI,GAAG,IAAI,CAAC,IAAI,GAAG,IAAI,OAAO,CAAC,MAAM,EAAE,CAAC;YACtC,OAAO,OAAO,CAAC,GAAG,GAAG,CAAC,CAAC,CAAC,KAAK,CAAC;QAChC,CAAC;QACD,OAAO,CAAC,GAAG,CAAC,yCAAyC,OAAO,CAAC,MAAM,GAAG,CAAC,CAAC;IAC1E,CAAC;AACH,CAAC"}

package/dist/setup-wizard.d.ts

@@ -0,0 +1,4 @@
+import type pino from "pino";
+export declare function runSetupWizard(configDir: string, logger: pino.Logger): Promise<void>;
+export declare function runConfigRepair(configDir: string, raw: Record<string, unknown>, issues: string[], logger: pino.Logger): Promise<void>;
+//# sourceMappingURL=setup-wizard.d.ts.map

package/dist/setup-wizard.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"setup-wizard.d.ts","sourceRoot":"","sources":["../src/setup-wizard.ts"],"names":[],"mappings":"AAIA,OAAO,KAAK,IAAI,MAAM,MAAM,CAAC;AAY7B,wBAAsB,cAAc,CAClC,SAAS,EAAE,MAAM,EACjB,MAAM,EAAE,IAAI,CAAC,MAAM,GAClB,OAAO,CAAC,IAAI,CAAC,CA+Ff;AAID,wBAAsB,eAAe,CACnC,SAAS,EAAE,MAAM,EACjB,GAAG,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,EAC5B,MAAM,EAAE,MAAM,EAAE,EAChB,MAAM,EAAE,IAAI,CAAC,MAAM,GAClB,OAAO,CAAC,IAAI,CAAC,CAmFf"}

package/dist/setup-wizard.js

@@ -0,0 +1,258 @@
+import { existsSync, readdirSync, statSync, writeFileSync } from "node:fs";
+import { writeFile } from "node:fs/promises";
+import { basename, join, resolve } from "node:path";
+import open from "open";
+import { getDefaultEngineModel } from "./default-models.js";
+import { detectEngine } from "./engine/detect.js";
+import { getEngine } from "./engine/registry.js";
+import { closePrompts, confirm, input, select } from "./prompts.js";
+// ─── Constants ──────────────────────────────────────────────────────────────
+const BOTFATHER_URL = "https://core.telegram.org/bots/tutorial";
+// ─── Full setup wizard (no config file exists) ─────────────────────────────
+export async function runSetupWizard(configDir, logger) {
+    console.log("");
+    console.log("Hey! Looks like you don't have a config file yet.");
+    const wantSetup = await confirm({
+        message: "Want me to help you set one up?",
+    });
+    if (!wantSetup) {
+        console.log('No worries! You can run "npx @marcopeg/hal init" any time to create a template config.');
+        process.exit(0);
+    }
+    // 1. Engine detection (skip both initial and persist prompts — wizard handles config writing)
+    console.log("");
+    console.log("Let's start by finding an AI engine on your system...");
+    const { engine: engineName } = await detectEngine(configDir, logger, {
+        skipInitialPrompt: true,
+        skipPersistPrompt: true,
+    });
+    // 2. Project working directory
+    console.log("");
+    const projectCwd = await askProjectCwd(configDir);
+    // 3. Telegram bot token
+    console.log("");
+    const botToken = await askBotToken();
+    // 4. Project name (optional)
+    console.log("");
+    const defaultName = projectCwd === "."
+        ? basename(resolve(configDir))
+        : basename(resolve(configDir, projectCwd));
+    const projectName = await input({
+        message: "Project name (press Enter to skip):",
+        default: defaultName,
+    });
+    // 5. Dictation / transcription
+    console.log("");
+    const enableDictation = await confirm({
+        message: "Enable voice dictation? (allows sending voice messages to the bot)",
+        default: false,
+    });
+    // 6. Build and write config
+    const config = {
+        globals: {
+            engine: { name: engineName },
+            logging: { level: "info", flow: true, persist: false },
+            rateLimit: { max: 10, windowMs: 60000 },
+            access: { allowedUserIds: [] },
+            ...(enableDictation
+                ? { transcription: { model: "base.en", showTranscription: true } }
+                : {}),
+        },
+        projects: [
+            {
+                ...(projectName.trim() ? { name: projectName.trim() } : {}),
+                cwd: projectCwd.trim(),
+                telegram: { botToken: botToken.trim() },
+                access: { allowedUserIds: [] },
+            },
+        ],
+    };
+    const configPath = join(configDir, "hal.config.json");
+    writeFileSync(configPath, `${JSON.stringify(config, null, 2)}\n`, "utf-8");
+    logger.info({ configPath }, "Configuration file created");
+    // 7. Scaffold engine instructions file
+    const effectiveModel = getDefaultEngineModel(engineName);
+    const engineAdapter = getEngine(engineName, undefined, effectiveModel);
+    const instrFile = engineAdapter.instructionsFile();
+    const instrPath = join(configDir, instrFile);
+    if (!existsSync(instrPath)) {
+        await writeFile(instrPath, "# Project Instructions\n\nAdd your project-specific instructions here.\n", "utf-8");
+        console.log(`Created ${instrFile}`);
+    }
+    closePrompts();
+    console.log("");
+    console.log(`Config written to ${configPath}`);
+    console.log("Setup complete! Starting up...");
+    console.log("");
+}
+// ─── Config repair (config exists but has validation issues) ────────────────
+export async function runConfigRepair(configDir, raw, issues, logger) {
+    console.log("");
+    console.log("Your config file has some issues:");
+    for (const issue of issues) {
+        console.log(`  - ${issue}`);
+    }
+    console.log("");
+    const wantRepair = await confirm({
+        message: "Want me to help you fix them?",
+    });
+    if (!wantRepair) {
+        console.log("Please fix the issues above and try again.");
+        process.exit(1);
+    }
+    const patched = { ...raw };
+    // Ensure globals exists
+    if (!patched.globals || typeof patched.globals !== "object") {
+        patched.globals = {};
+    }
+    const globals = patched.globals;
+    // Check engine
+    const engine = globals.engine;
+    if (!engine?.name) {
+        console.log("");
+        console.log("Let's find an AI engine for you...");
+        const { engine: engineName } = await detectEngine(configDir, logger, {
+            skipInitialPrompt: true,
+            skipPersistPrompt: true,
+        });
+        globals.engine = { ...engine, name: engineName };
+    }
+    // Check projects
+    let projects = patched.projects;
+    if (!Array.isArray(projects) || projects.length === 0) {
+        console.log("");
+        console.log("No projects configured. Let's add one!");
+        const project = await askNewProject(configDir);
+        patched.projects = [project];
+        projects = patched.projects;
+    }
+    // Check each project for missing mandatory fields
+    for (let i = 0; i < projects.length; i++) {
+        const proj = projects[i];
+        const label = proj.name || `project ${i + 1}`;
+        if (!proj.cwd || proj.cwd.trim().length === 0) {
+            console.log("");
+            console.log(`Missing working directory for "${label}".`);
+            proj.cwd = await askProjectCwd(configDir);
+        }
+        const telegram = proj.telegram;
+        const token = telegram?.botToken;
+        if (!token ||
+            token.trim().length === 0 ||
+            token === "YOUR_BOT_TOKEN_HERE") {
+            console.log("");
+            console.log(`Missing Telegram bot token for "${label}".`);
+            const newToken = await askBotToken();
+            proj.telegram = { ...telegram, botToken: newToken.trim() };
+        }
+    }
+    // Write patched config
+    const configPath = join(configDir, "hal.config.json");
+    writeFileSync(configPath, `${JSON.stringify(patched, null, 2)}\n`, "utf-8");
+    logger.info({ configPath }, "Configuration file repaired");
+    closePrompts();
+    console.log("");
+    console.log(`Config updated at ${configPath}`);
+    console.log("Issues fixed! Starting up...");
+    console.log("");
+}
+// ─── Shared prompt helpers ──────────────────────────────────────────────────
+async function askProjectCwd(configDir) {
+    // Scan for subdirectories to offer as choices
+    const subdirs = listSubdirectories(configDir);
+    if (subdirs.length > 0) {
+        const cwdChoice = await select({
+            message: "Which folder should the AI engine work in?",
+            choices: [
+                { name: ". (current directory)", value: "." },
+                ...subdirs.map((d) => ({ name: d, value: d })),
+                { name: "Enter a custom path...", value: "__custom__" },
+            ],
+        });
+        if (cwdChoice !== "__custom__") {
+            return cwdChoice;
+        }
+    }
+    return input({
+        message: "Project working directory:",
+        default: ".",
+        validate: (val) => {
+            if (!val || val.trim().length === 0)
+                return "A working directory is required.";
+            const resolved = resolve(configDir, val.trim());
+            if (!existsSync(resolved))
+                return `Directory not found: ${resolved}`;
+            return true;
+        },
+    });
+}
+async function askBotToken() {
+    const hasToken = await select({
+        message: "Do you have a Telegram bot token?",
+        choices: [
+            {
+                name: "Yes, I have a token",
+                value: "yes",
+            },
+            {
+                name: "No, help me create one",
+                value: "help",
+            },
+        ],
+    });
+    if (hasToken === "help") {
+        console.log("");
+        console.log("Opening the Telegram Bot tutorial — follow the steps to create a bot with @BotFather.");
+        console.log("Once you have the token, come back here and paste it.");
+        await open(BOTFATHER_URL);
+        console.log("");
+    }
+    return input({
+        message: "Telegram bot token (from @BotFather):",
+        validate: (val) => {
+            if (!val || val.trim().length === 0)
+                return "A bot token is required.";
+            return true;
+        },
+    });
+}
+async function askNewProject(configDir) {
+    const cwd = await askProjectCwd(configDir);
+    const botToken = await askBotToken();
+    const defaultName = cwd === "."
+        ? basename(resolve(configDir))
+        : basename(resolve(configDir, cwd));
+    const name = await input({
+        message: "Project name (press Enter to skip):",
+        default: defaultName,
+    });
+    return {
+        ...(name.trim() ? { name: name.trim() } : {}),
+        cwd: cwd.trim(),
+        telegram: { botToken: botToken.trim() },
+        access: { allowedUserIds: [] },
+    };
+}
+// ─── Helpers ────────────────────────────────────────────────────────────────
+function listSubdirectories(dir) {
+    try {
+        return readdirSync(dir)
+            .filter((entry) => {
+            if (entry.startsWith("."))
+                return false;
+            if (entry === "node_modules" || entry === "dist")
+                return false;
+            try {
+                return statSync(join(dir, entry)).isDirectory();
+            }
+            catch {
+                return false;
+            }
+        })
+            .sort();
+    }
+    catch {
+        return [];
+    }
+}
+//# sourceMappingURL=setup-wizard.js.map

package/dist/setup-wizard.js.map

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

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@marcopeg/hal",
-  "version": "1.0.20",
+  "version": "1.0.23",
   "type": "module",
   "main": "dist/index.js",
   "bin": {
@@ -20,7 +20,8 @@
     "prepublishOnly": "pnpm run build",
     "sync-skills": "node .agents/scripts/sync-skills.mjs",
     "prepare": "husky",
-    "deploy": "npm version patch && npm publish --access public"
+    "deploy": "npm version patch && npm publish --access public",
+    "docs": "npx mdts"
   },
   "keywords": [
     "telegram",
@@ -47,6 +48,8 @@
     "grammy": "^1.39.2",
     "nodejs-whisper": "^0.2.9",
     "pino": "^10.2.0",
+    "strip-json-comments": "^5.0.3",
+    "yaml": "^2.8.2",
     "zod": "^4.3.5"
   },
   "devDependencies": {