shadok-ai 0.1.0

package/dist/config.js

@@ -0,0 +1,59 @@
+import fs from "node:fs";
+import os from "node:os";
+import path from "node:path";
+export const SHADOK_DIR = path.join(os.homedir(), ".shadok-ai");
+const CONFIG_FILE = path.join(SHADOK_DIR, "config.json");
+const LEGACY_ENV = path.join(SHADOK_DIR, "telegram.env");
+export function loadConfig() {
+    try {
+        const v = JSON.parse(fs.readFileSync(CONFIG_FILE, "utf8"));
+        return v && typeof v === "object" ? v : {};
+    }
+    catch {
+        return {};
+    }
+}
+export function saveConfig(cfg) {
+    fs.mkdirSync(SHADOK_DIR, { recursive: true });
+    // 600: the token is a secret. Write then chmod (umask-independent).
+    fs.writeFileSync(CONFIG_FILE, JSON.stringify(cfg, null, 2), { mode: 0o600 });
+    fs.chmodSync(CONFIG_FILE, 0o600);
+}
+/**
+ * One-time migration of the legacy ~/.shadok-ai/telegram.env
+ * (`TELEGRAM_BOT_TOKEN=...`) into config.json. Returns the migrated token, or
+ * null if there was nothing to migrate. The env file is left on disk but no
+ * longer read by anything.
+ */
+export function migrateLegacyEnv(cfg) {
+    if (cfg.telegramToken !== undefined)
+        return null; // already decided
+    let raw;
+    try {
+        raw = fs.readFileSync(LEGACY_ENV, "utf8");
+    }
+    catch {
+        return null;
+    }
+    const token = parseLegacyToken(raw);
+    if (!token)
+        return null;
+    cfg.telegramToken = token;
+    saveConfig(cfg);
+    return token;
+}
+/** Pull TELEGRAM_BOT_TOKEN out of a shell-style env file body. */
+export function parseLegacyToken(raw) {
+    const m = raw.match(/TELEGRAM_BOT_TOKEN\s*=\s*["']?([^"'\s]+)/);
+    return m ? m[1] : null;
+}
+/**
+ * The effective token to hand the server: an explicit env var always wins,
+ * otherwise the configured value (a null/undefined config means "no token").
+ */
+export function effectiveToken(cfg, env = process.env) {
+    if (env.TELEGRAM_BOT_TOKEN)
+        return env.TELEGRAM_BOT_TOKEN;
+    return cfg.telegramToken ?? null;
+}
+//# sourceMappingURL=config.js.map

package/dist/config.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"config.js","sourceRoot":"","sources":["../src/config.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,MAAM,SAAS,CAAC;AACzB,OAAO,EAAE,MAAM,SAAS,CAAC;AACzB,OAAO,IAAI,MAAM,WAAW,CAAC;AAiB7B,MAAM,CAAC,MAAM,UAAU,GAAG,IAAI,CAAC,IAAI,CAAC,EAAE,CAAC,OAAO,EAAE,EAAE,YAAY,CAAC,CAAC;AAChE,MAAM,WAAW,GAAG,IAAI,CAAC,IAAI,CAAC,UAAU,EAAE,aAAa,CAAC,CAAC;AACzD,MAAM,UAAU,GAAG,IAAI,CAAC,IAAI,CAAC,UAAU,EAAE,cAAc,CAAC,CAAC;AAEzD,MAAM,UAAU,UAAU;IACxB,IAAI,CAAC;QACH,MAAM,CAAC,GAAG,IAAI,CAAC,KAAK,CAAC,EAAE,CAAC,YAAY,CAAC,WAAW,EAAE,MAAM,CAAC,CAAC,CAAC;QAC3D,OAAO,CAAC,IAAI,OAAO,CAAC,KAAK,QAAQ,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,EAAE,CAAC;IAC7C,CAAC;IAAC,MAAM,CAAC;QACP,OAAO,EAAE,CAAC;IACZ,CAAC;AACH,CAAC;AAED,MAAM,UAAU,UAAU,CAAC,GAAW;IACpC,EAAE,CAAC,SAAS,CAAC,UAAU,EAAE,EAAE,SAAS,EAAE,IAAI,EAAE,CAAC,CAAC;IAC9C,oEAAoE;IACpE,EAAE,CAAC,aAAa,CAAC,WAAW,EAAE,IAAI,CAAC,SAAS,CAAC,GAAG,EAAE,IAAI,EAAE,CAAC,CAAC,EAAE,EAAE,IAAI,EAAE,KAAK,EAAE,CAAC,CAAC;IAC7E,EAAE,CAAC,SAAS,CAAC,WAAW,EAAE,KAAK,CAAC,CAAC;AACnC,CAAC;AAED;;;;;GAKG;AACH,MAAM,UAAU,gBAAgB,CAAC,GAAW;IAC1C,IAAI,GAAG,CAAC,aAAa,KAAK,SAAS;QAAE,OAAO,IAAI,CAAC,CAAC,kBAAkB;IACpE,IAAI,GAAW,CAAC;IAChB,IAAI,CAAC;QACH,GAAG,GAAG,EAAE,CAAC,YAAY,CAAC,UAAU,EAAE,MAAM,CAAC,CAAC;IAC5C,CAAC;IAAC,MAAM,CAAC;QACP,OAAO,IAAI,CAAC;IACd,CAAC;IACD,MAAM,KAAK,GAAG,gBAAgB,CAAC,GAAG,CAAC,CAAC;IACpC,IAAI,CAAC,KAAK;QAAE,OAAO,IAAI,CAAC;IACxB,GAAG,CAAC,aAAa,GAAG,KAAK,CAAC;IAC1B,UAAU,CAAC,GAAG,CAAC,CAAC;IAChB,OAAO,KAAK,CAAC;AACf,CAAC;AAED,kEAAkE;AAClE,MAAM,UAAU,gBAAgB,CAAC,GAAW;IAC1C,MAAM,CAAC,GAAG,GAAG,CAAC,KAAK,CAAC,0CAA0C,CAAC,CAAC;IAChE,OAAO,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,IAAI,CAAC;AACzB,CAAC;AAED;;;GAGG;AACH,MAAM,UAAU,cAAc,CAAC,GAAW,EAAE,GAAG,GAAsB,OAAO,CAAC,GAAG;IAC9E,IAAI,GAAG,CAAC,kBAAkB;QAAE,OAAO,GAAG,CAAC,kBAAkB,CAAC;IAC1D,OAAO,GAAG,CAAC,aAAa,IAAI,IAAI,CAAC;AACnC,CAAC"}

package/dist/detect.d.ts

@@ -0,0 +1,17 @@
+/**
+ * Detection of the "Claude is working" state from the rendered TUI screen.
+ *
+ * Kept free of any dependency so it can be unit-tested directly
+ * (debug/detect.test.mjs) against captured screen fixtures.
+ */
+/** True when the screen indicates that Claude is currently working. */
+export declare function screenShowsWork(screen: string): boolean;
+/**
+ * True while the text we just typed is still sitting in the input box (the
+ * last "❯ …" line). Used to confirm a submit: before Enter the probe is in the
+ * box; once Enter is accepted the box clears, so `!inputHasProbe` means "sent".
+ * This is robust to a fast turn scrolling the echo out of the transcript —
+ * unlike looking for the probe anywhere on screen, which false-negatived and
+ * dumped the whole screen as an error.
+ */
+export declare function inputHasProbe(screen: string, probe: string): boolean;

package/dist/detect.js

@@ -0,0 +1,41 @@
+/**
+ * Detection of the "Claude is working" state from the rendered TUI screen.
+ *
+ * Kept free of any dependency so it can be unit-tested directly
+ * (debug/detect.test.mjs) against captured screen fixtures.
+ */
+/**
+ * Marker displayed by Claude Code TUIs while working. The genuine one always
+ * sits in the status group, right after a "·" separator or an opening "(",
+ * e.g. "(… · esc to interrupt)". Requiring that prefix means prose that merely
+ * *mentions* the phrase — Claude explaining shadok-ai's own turn detection,
+ * quoted or not — never reads as "working".
+ */
+const ESC_TO_INTERRUPT = /[·(]\s*esc to interrupt/i;
+/**
+ * Newer TUIs drop the "esc to interrupt" hint; the live spinner line is then
+ * the only working signal: a glyph at column 0 followed by a status and an
+ * "(<elapsed> · …)" group with the elapsed FIRST, e.g.
+ *   ✽ Jitterbugging… (4m 26s · ↓ 7.1k tokens · …)
+ * A finished turn renders past tense without parens ("✻ Baked for 8m 20s"),
+ * and completion lines put the elapsed LAST ("(… · 5m 40s)"): no match.
+ */
+const SPINNER_STATUS = /^[^\s\w].{0,80}?\(\s*(?:\d+h\s*)?(?:\d+m\s*)?\d+s\s*·/m;
+/** True when the screen indicates that Claude is currently working. */
+export function screenShowsWork(screen) {
+    return ESC_TO_INTERRUPT.test(screen) || SPINNER_STATUS.test(screen);
+}
+/**
+ * True while the text we just typed is still sitting in the input box (the
+ * last "❯ …" line). Used to confirm a submit: before Enter the probe is in the
+ * box; once Enter is accepted the box clears, so `!inputHasProbe` means "sent".
+ * This is robust to a fast turn scrolling the echo out of the transcript —
+ * unlike looking for the probe anywhere on screen, which false-negatived and
+ * dumped the whole screen as an error.
+ */
+export function inputHasProbe(screen, probe) {
+    const promptLines = screen.split("\n").filter((l) => l.trimStart().startsWith("❯"));
+    const inputLine = promptLines[promptLines.length - 1] ?? "";
+    return inputLine.includes(probe);
+}
+//# sourceMappingURL=detect.js.map

package/dist/detect.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"detect.js","sourceRoot":"","sources":["../src/detect.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH;;;;;;GAMG;AACH,MAAM,gBAAgB,GAAG,0BAA0B,CAAC;AAEpD;;;;;;;GAOG;AACH,MAAM,cAAc,GAClB,wDAAwD,CAAC;AAE3D,uEAAuE;AACvE,MAAM,UAAU,eAAe,CAAC,MAAc;IAC5C,OAAO,gBAAgB,CAAC,IAAI,CAAC,MAAM,CAAC,IAAI,cAAc,CAAC,IAAI,CAAC,MAAM,CAAC,CAAC;AACtE,CAAC;AAED;;;;;;;GAOG;AACH,MAAM,UAAU,aAAa,CAAC,MAAc,EAAE,KAAa;IACzD,MAAM,WAAW,GAAG,MAAM,CAAC,KAAK,CAAC,IAAI,CAAC,CAAC,MAAM,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,SAAS,EAAE,CAAC,UAAU,CAAC,GAAG,CAAC,CAAC,CAAC;IACpF,MAAM,SAAS,GAAG,WAAW,CAAC,WAAW,CAAC,MAAM,GAAG,CAAC,CAAC,IAAI,EAAE,CAAC;IAC5D,OAAO,SAAS,CAAC,QAAQ,CAAC,KAAK,CAAC,CAAC;AACnC,CAAC"}

package/dist/extract.d.ts

@@ -0,0 +1,55 @@
+/**
+ * Extracts the response: everything after the "❯ <prompt>" echo in the
+ * transcript, minus the final input box and status lines.
+ */
+export declare function extractResponse(buffer: string, prompt: string): string;
+export interface TuiDialogOption {
+    n: number;
+    label: string;
+    hint: string;
+    /** Multi-select only: state of the [ ] / [✔] checkbox. */
+    checked?: boolean;
+}
+export interface TuiDialog {
+    question: string;
+    options: TuiDialogOption[];
+    /**
+     * True for multi-select questions: digits toggle checkboxes, submission
+     * goes through Tab (Submit page) then Enter. In single-select mode,
+     * pressing the digit selects and validates directly.
+     */
+    multi: boolean;
+}
+/**
+ * Detects an interactive TUI dialog (multiple-choice question, permission
+ * prompt…): numbered options, one of which carries the "❯" selector.
+ */
+export declare function detectDialog(screen: string): TuiDialog | null;
+export interface HistoryTurn {
+    role: "user" | "assistant";
+    text: string;
+}
+/**
+ * Reads a session transcript back from its .jsonl file
+ * (~/.claude/projects/<encoded cwd>/<session-id>.jsonl) so the history can
+ * be replayed when resuming the session.
+ */
+export declare function loadHistory(cwd: string, sessionId: string): HistoryTurn[];
+export interface SessionInfo {
+    id: string;
+    /** Last activity, in ms since epoch (file mtime). */
+    mtime: number;
+    /** First real user prompt of the session, truncated. */
+    preview: string;
+}
+/**
+ * Lists the resumable sessions of a directory (newest first), with the
+ * first user prompt as a preview so a session can be recognized by more
+ * than its id.
+ */
+export declare function listSessions(cwd: string): SessionInfo[];
+/**
+ * Finds the id of the most recent session of a directory: Claude Code
+ * writes each session to ~/.claude/projects/<encoded cwd>/<session-id>.jsonl.
+ */
+export declare function findSessionId(cwd: string): string | null;

package/dist/extract.js

@@ -0,0 +1,269 @@
+import fs from "node:fs";
+import os from "node:os";
+import path from "node:path";
+import { newestTranscriptById } from "./tail.js";
+/**
+ * Extracts the response: everything after the "❯ <prompt>" echo in the
+ * transcript, minus the final input box and status lines.
+ */
+export function extractResponse(buffer, prompt) {
+    const lines = buffer.split("\n");
+    const probe = prompt.slice(0, 15);
+    let start = -1;
+    // The prompt echo in the transcript starts with "❯ "; so does the (empty)
+    // input box at the bottom — take the last occurrence containing the
+    // beginning of the prompt.
+    for (let i = lines.length - 1; i >= 0; i--) {
+        if (/^\s*[❯>]/.test(lines[i]) && lines[i].includes(probe)) {
+            start = i + 1;
+            break;
+        }
+    }
+    if (start === -1)
+        return buffer.trim();
+    // A long prompt echo spans several lines: the response starts at the
+    // first "⏺" marker that follows, when there is one.
+    for (let i = start; i < lines.length; i++) {
+        if (/^\s*⏺/.test(lines[i])) {
+            start = i;
+            break;
+        }
+    }
+    const noise = (l) => /^\s*✻/.test(l) || /·\s*\/effort\s*$/.test(l) || /esc to interrupt/i.test(l);
+    // Cut the input area (─── separator followed by ❯) when present.
+    let end = lines.length;
+    for (let i = start; i < lines.length; i++) {
+        if (/^─{10,}/.test(lines[i].trim())) {
+            end = i;
+            break;
+        }
+    }
+    return lines
+        .slice(start, end)
+        .filter((l) => !noise(l))
+        .join("\n")
+        .trim();
+}
+/**
+ * Detects an interactive TUI dialog (multiple-choice question, permission
+ * prompt…): numbered options, one of which carries the "❯" selector.
+ */
+export function detectDialog(screen) {
+    // AskUserQuestion can render a preview (chart, code…) in a right-hand column
+    // on the SAME lines as the options. Strip that column — a run of ≥2 spaces
+    // followed by a box-drawing char — so option labels don't absorb it.
+    const lines = screen
+        .split("\n")
+        .map((l) => l.replace(/\s{2,}[│┌└├┐┘┤┬┴┼─╭╮╰╯].*$/u, "").replace(/\s+$/, ""));
+    const optionRe = /^\s*(❯\s*)?(\d+)\.\s+(?:\[( |✔|✓|x)\]\s*)?(.+)$/;
+    const options = [];
+    let hasSelector = false;
+    let multi = false;
+    let firstOptionLine = -1;
+    let current = null;
+    for (let i = 0; i < lines.length; i++) {
+        const m = lines[i].match(optionRe);
+        if (m) {
+            if (m[1])
+                hasSelector = true;
+            current = { n: Number(m[2]), label: m[4].trim(), hint: "" };
+            if (m[3] !== undefined) {
+                multi = true;
+                current.checked = m[3] !== " ";
+            }
+            options.push(current);
+            if (firstOptionLine === -1)
+                firstOptionLine = i;
+        }
+        else if (current &&
+            /^\s{2,}\S/.test(lines[i]) &&
+            !/Enter to /i.test(lines[i]) &&
+            !/^\s*Submit\s*$/.test(lines[i])) {
+            // Indented line under an option: the option's description.
+            current.hint = (current.hint ? current.hint + " " : "") + lines[i].trim();
+        }
+        else if (lines[i].trim() !== "" && !/^\s*─+/.test(lines[i])) {
+            current = null;
+        }
+    }
+    if (options.length < 2 || !hasSelector)
+        return null;
+    // The question: the text lines right above the first option (skipping
+    // frames, separators and the "← ☐ … ✔ Submit →" tab bar).
+    const questionLines = [];
+    for (let i = firstOptionLine - 1; i >= 0; i--) {
+        const t = lines[i].trim();
+        if (t === "" || /^[─═╭╮╰╯│□⏺←→]/.test(t) || /[☐☒]|✔\s*Submit/.test(t)) {
+            if (questionLines.length)
+                break;
+            continue;
+        }
+        questionLines.unshift(t);
+    }
+    return { question: questionLines.join(" "), options, multi };
+}
+/**
+ * Reads a session transcript back from its .jsonl file
+ * (~/.claude/projects/<encoded cwd>/<session-id>.jsonl) so the history can
+ * be replayed when resuming the session.
+ */
+export function loadHistory(cwd, sessionId) {
+    // Same drift-immunity as the tail: prefer the newest <id>.jsonl anywhere, so a
+    // moved/renamed worktree's history still resolves (see sessionFilePath).
+    const encoded = path.resolve(cwd).replace(/[^a-zA-Z0-9]/g, "-");
+    const file = newestTranscriptById(sessionId) ??
+        path.join(os.homedir(), ".claude", "projects", encoded, sessionId + ".jsonl");
+    let raw;
+    try {
+        raw = fs.readFileSync(file, "utf8");
+    }
+    catch {
+        return [];
+    }
+    const turns = [];
+    for (const line of raw.split("\n")) {
+        if (!line.trim())
+            continue;
+        let e;
+        try {
+            e = JSON.parse(line);
+        }
+        catch {
+            continue;
+        }
+        if (e.isMeta || !e.message)
+            continue;
+        if (e.type === "user") {
+            const c = e.message.content;
+            let text = "";
+            if (typeof c === "string")
+                text = c;
+            else if (Array.isArray(c))
+                text = c
+                    .filter((b) => b.type === "text")
+                    .map((b) => b.text)
+                    .join("\n");
+            text = text.trim();
+            // Skip technical messages (system reminders, commands, tool results,
+            // interruptions).
+            if (!text || text.startsWith("<") || text.startsWith("[Request interrupted"))
+                continue;
+            turns.push({ role: "user", text });
+        }
+        else if (e.type === "assistant" && Array.isArray(e.message.content)) {
+            const text = e.message.content
+                .filter((b) => b.type === "text")
+                .map((b) => b.text)
+                .join("\n")
+                .trim();
+            if (!text)
+                continue;
+            const last = turns[turns.length - 1];
+            if (last && last.role === "assistant")
+                last.text += "\n\n" + text;
+            else
+                turns.push({ role: "assistant", text });
+        }
+    }
+    return turns.slice(-100);
+}
+/**
+ * Lists the resumable sessions of a directory (newest first), with the
+ * first user prompt as a preview so a session can be recognized by more
+ * than its id.
+ */
+export function listSessions(cwd) {
+    const encoded = path.resolve(cwd).replace(/[^a-zA-Z0-9]/g, "-");
+    const dir = path.join(os.homedir(), ".claude", "projects", encoded);
+    let files;
+    try {
+        files = fs.readdirSync(dir).filter((f) => f.endsWith(".jsonl"));
+    }
+    catch {
+        return [];
+    }
+    const sessions = [];
+    for (const f of files) {
+        const file = path.join(dir, f);
+        let mtime;
+        try {
+            mtime = fs.statSync(file).mtimeMs;
+        }
+        catch {
+            continue;
+        }
+        sessions.push({
+            id: f.replace(/\.jsonl$/, ""),
+            mtime,
+            preview: firstUserPrompt(file),
+        });
+    }
+    return sessions.sort((a, b) => b.mtime - a.mtime);
+}
+/** Reads the beginning of a transcript and returns the first real user prompt. */
+function firstUserPrompt(file) {
+    // Only the head of the file is needed — transcripts can be several MB.
+    let head;
+    try {
+        const fd = fs.openSync(file, "r");
+        try {
+            const buf = Buffer.alloc(256 * 1024);
+            const n = fs.readSync(fd, buf, 0, buf.length, 0);
+            head = buf.toString("utf8", 0, n);
+        }
+        finally {
+            fs.closeSync(fd);
+        }
+    }
+    catch {
+        return "";
+    }
+    for (const line of head.split("\n")) {
+        if (!line.trim())
+            continue;
+        let e;
+        try {
+            e = JSON.parse(line);
+        }
+        catch {
+            continue;
+        }
+        if (e.isMeta || e.type !== "user" || !e.message)
+            continue;
+        const c = e.message.content;
+        let text = "";
+        if (typeof c === "string")
+            text = c;
+        else if (Array.isArray(c))
+            text = c
+                .filter((b) => b.type === "text")
+                .map((b) => b.text)
+                .join("\n");
+        text = text.trim();
+        // Same filtering as loadHistory: skip technical messages.
+        if (!text || text.startsWith("<") || text.startsWith("[Request interrupted"))
+            continue;
+        return text.replace(/\s+/g, " ").slice(0, 120);
+    }
+    return "";
+}
+/**
+ * Finds the id of the most recent session of a directory: Claude Code
+ * writes each session to ~/.claude/projects/<encoded cwd>/<session-id>.jsonl.
+ */
+export function findSessionId(cwd) {
+    const encoded = path.resolve(cwd).replace(/[^a-zA-Z0-9]/g, "-");
+    const dir = path.join(os.homedir(), ".claude", "projects", encoded);
+    try {
+        const newest = fs
+            .readdirSync(dir)
+            .filter((f) => f.endsWith(".jsonl"))
+            .map((f) => ({ f, mtime: fs.statSync(path.join(dir, f)).mtimeMs }))
+            .sort((a, b) => b.mtime - a.mtime)[0];
+        return newest ? newest.f.replace(/\.jsonl$/, "") : null;
+    }
+    catch {
+        return null;
+    }
+}
+//# sourceMappingURL=extract.js.map

package/dist/extract.js.map

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

package/dist/main.d.ts

@@ -0,0 +1,2 @@
+#!/usr/bin/env node
+export {};

package/dist/main.js

@@ -0,0 +1,90 @@
+#!/usr/bin/env node
+import { spawn } from "node:child_process";
+import fs from "node:fs";
+import path from "node:path";
+import { fileURLToPath } from "node:url";
+import { parseArgs } from "./args.js";
+import { effectiveToken, loadConfig, migrateLegacyEnv, saveConfig } from "./config.js";
+import { promptToken } from "./setup-prompt.js";
+import { runSupervisor } from "./supervisor.js";
+import { serverEntry, update } from "./updater.js";
+import { writeUpdateResult } from "./update-flag.js";
+const HERE = path.dirname(fileURLToPath(import.meta.url));
+function ownVersion() {
+    try {
+        return JSON.parse(fs.readFileSync(path.join(HERE, "..", "package.json"), "utf8")).version ?? "0.0.0";
+    }
+    catch {
+        return "0.0.0";
+    }
+}
+/** The server to run: the managed (updatable) install if present, else the
+ *  server bundled next to this file. */
+function serverToRun() {
+    const managed = serverEntry();
+    return fs.existsSync(managed) ? managed : path.join(HERE, "server.js");
+}
+async function main() {
+    const args = parseArgs(process.argv.slice(2));
+    if (args.help) {
+        process.stdout.write("shadok-ai — web cockpit for parallel Claude Code sessions\n\n" +
+            "Usage: npx shadok-ai [options]\n" +
+            "  --port, -p <n>   HTTP/WS port (default 3789)\n" +
+            "  --no-telegram    run web-only; don't prompt for or use a bot token\n" +
+            "  --version, -v    print version\n" +
+            "  --help, -h       this help\n\n" +
+            "Open http://localhost:<port>. In your Telegram board group, /setup to bind it.\n");
+        return 0;
+    }
+    if (args.version) {
+        process.stdout.write(ownVersion() + "\n");
+        return 0;
+    }
+    const cfg = loadConfig();
+    migrateLegacyEnv(cfg);
+    // First-run token prompt: only when we've never asked, it's interactive, and
+    // Telegram isn't disabled. A skip is recorded (null) so we never nag again.
+    if (!args.noTelegram &&
+        cfg.telegramToken === undefined &&
+        !process.env.TELEGRAM_BOT_TOKEN &&
+        process.stdin.isTTY) {
+        cfg.telegramToken = await promptToken();
+        saveConfig(cfg);
+    }
+    const port = args.port ?? cfg.port ?? (Number(process.env.PORT) || 3789);
+    const token = args.noTelegram ? null : effectiveToken(cfg);
+    const childEnv = { ...process.env, PORT: String(port) };
+    if (token)
+        childEnv.TELEGRAM_BOT_TOKEN = token;
+    else
+        delete childEnv.TELEGRAM_BOT_TOKEN;
+    let current = null;
+    // Ctrl-C / SIGTERM: bring the child down with us instead of orphaning it.
+    let shuttingDown = false;
+    for (const sig of ["SIGINT", "SIGTERM"]) {
+        process.on(sig, () => {
+            shuttingDown = true;
+            current?.kill(sig);
+            process.exit(0);
+        });
+    }
+    const deps = {
+        spawnServer: () => new Promise((resolve) => {
+            const child = spawn(process.execPath, [serverToRun()], { env: childEnv, stdio: "inherit" });
+            current = child;
+            child.on("exit", (code) => resolve(shuttingDown ? 0 : code ?? 0));
+            child.on("error", () => resolve(1));
+        }),
+        update,
+        writeUpdateResult,
+        sleep: (ms) => new Promise((r) => setTimeout(r, ms)),
+        now: () => Date.now(),
+        log: (m) => process.stdout.write(`[shadok-ai] ${m}\n`),
+    };
+    return runSupervisor(deps);
+}
+main().then((code) => process.exit(code), (e) => {
+    process.stderr.write(`[shadok-ai] fatal: ${e?.message ?? e}\n`);
+    process.exit(1);
+});
+//# sourceMappingURL=main.js.map

package/dist/main.js.map

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

package/dist/pace.d.ts

@@ -0,0 +1,33 @@
+import type { Usage, Window } from "./usage.js";
+/** Durée totale de chaque fenêtre glissante, en secondes. */
+export declare const WINDOW_SEC: {
+    readonly fiveHour: number;
+    readonly sevenDay: number;
+};
+/**
+ * Ajouté au rythme idéal au dénominateur. Sans lui, le rythme est quasi nul
+ * juste après un reset et le moindre message ferait exploser le ratio.
+ */
+export declare const PACE_EPSILON = 2;
+export interface Pace {
+    /** 0–100 : fraction de la fenêtre déjà écoulée. null si non calculable. */
+    idealPacePct: number | null;
+    /** Consommation rapportée au rythme idéal, en %. 100 = pile dans les temps. */
+    ratioPct: number | null;
+}
+export interface PaceVerdict {
+    blocked: boolean;
+    reason: string | null;
+}
+/**
+ * Rapporte la consommation d'une fenêtre au temps qui y est déjà passé.
+ * Renvoie des null si la fenêtre est absente ou son reset inconnu — pas de
+ * données ne vaut pas dépassement.
+ */
+export declare function computePace(w: Window | null, durationSec: number, nowMs: number): Pace;
+/**
+ * Bloque dès qu'UNE des deux fenêtres consomme plus vite que le temps ne passe.
+ * La raison cite la fenêtre au ratio le plus élevé. Sans données, ne bloque pas :
+ * l'indisponibilité de l'API ne doit pas verrouiller l'outil.
+ */
+export declare function paceBlock(u: Usage | null, nowMs: number): PaceVerdict;

package/dist/pace.js

@@ -0,0 +1,53 @@
+/** Durée totale de chaque fenêtre glissante, en secondes. */
+export const WINDOW_SEC = { fiveHour: 5 * 3600, sevenDay: 7 * 86400 };
+/**
+ * Ajouté au rythme idéal au dénominateur. Sans lui, le rythme est quasi nul
+ * juste après un reset et le moindre message ferait exploser le ratio.
+ */
+export const PACE_EPSILON = 2;
+/** Au-delà de ce ratio (en % du rythme idéal), on bloque. En dur, par choix. */
+const BLOCK_RATIO = 100;
+const LABEL = { fiveHour: "5h", sevenDay: "7d" };
+/**
+ * Rapporte la consommation d'une fenêtre au temps qui y est déjà passé.
+ * Renvoie des null si la fenêtre est absente ou son reset inconnu — pas de
+ * données ne vaut pas dépassement.
+ */
+export function computePace(w, durationSec, nowMs) {
+    if (!w || w.resetsAt === null)
+        return { idealPacePct: null, ratioPct: null };
+    const remainingSec = w.resetsAt - nowMs / 1000;
+    // Borné : une horloge en avance sur resetsAt ne doit pas produire de rythme
+    // négatif, ni une fenêtre expirée un rythme supérieur à 100%.
+    const idealPacePct = Math.min(100, Math.max(0, ((durationSec - remainingSec) / durationSec) * 100));
+    return { idealPacePct, ratioPct: (w.usedPercentage / (idealPacePct + PACE_EPSILON)) * 100 };
+}
+/**
+ * Bloque dès qu'UNE des deux fenêtres consomme plus vite que le temps ne passe.
+ * La raison cite la fenêtre au ratio le plus élevé. Sans données, ne bloque pas :
+ * l'indisponibilité de l'API ne doit pas verrouiller l'outil.
+ */
+export function paceBlock(u, nowMs) {
+    if (!u)
+        return { blocked: false, reason: null };
+    let worst = null;
+    for (const key of ["fiveHour", "sevenDay"]) {
+        const w = u[key];
+        const { idealPacePct, ratioPct } = computePace(w, WINDOW_SEC[key], nowMs);
+        if (!w || idealPacePct === null || ratioPct === null)
+            continue;
+        if (ratioPct <= BLOCK_RATIO)
+            continue;
+        if (!worst || ratioPct > worst.ratio) {
+            worst = { label: LABEL[key], used: w.usedPercentage, pace: idealPacePct, ratio: ratioPct };
+        }
+    }
+    if (!worst)
+        return { blocked: false, reason: null };
+    const r = Math.round;
+    return {
+        blocked: true,
+        reason: `${worst.label}: ${r(worst.used)}% used vs ${r(worst.pace)}% ideal pace (${r(worst.ratio)}% of pace)`,
+    };
+}
+//# sourceMappingURL=pace.js.map