@botconnector/bccli 0.4.0-beta.9 → 0.4.1

package/dist/ghBotDispatch.d.ts

@@ -0,0 +1,68 @@
+import type { CommentDelivery } from './ghBotWebhook';
+export interface GhBotConfig {
+    enabled: boolean;
+    path: string;
+    secretEnv: string;
+    repos: string[];
+    users: string[];
+    maxBodyBytes: number;
+    maxActive: number;
+    maxQueue: number;
+    stepLimit: number;
+    timeoutMs: number;
+    /** Kapasitas completed-LRU (opsional; default 1000) — dipakai test utk memperkecil. */
+    dedupCap?: number;
+}
+/** Validasi ketat + default aman (off-by-default). */
+export declare function ghBotConfigFrom(raw: unknown): GhBotConfig;
+export type AcceptResult = 'queued' | 'dedup' | 'inflight' | 'filtered' | 'full' | 'closed';
+export interface GhBotHubDeps {
+    out(s: string): void;
+    err(s: string): void;
+    /** SATU signal (deadline ∪ close) diteruskan ke collect+draft+post. */
+    runJob(d: CommentDelivery, signal: AbortSignal): Promise<{
+        ok: boolean;
+        reason?: string;
+    }>;
+}
+export interface CloseSummary {
+    aborted: number;
+    terminationConfirmed: number;
+    terminationUnconfirmed: number;
+}
+/**
+ * Admission atomik (spec §4): filter → cek duplikat (inFlight/LRU) → cek kapasitas →
+ * reservasi dalam satu blok sinkron. `full` TIDAK menyimpan dedup. Worker membersihkan
+ * active/inFlight di finally pada resolve MAUPUN reject (dibungkus Promise.resolve().then
+ * agar throw sinkron pun masuk jalur catch). Job gagal tidak masuk completed-LRU.
+ */
+export declare class GhBotHub {
+    private readonly cfg;
+    private readonly deps;
+    private readonly inFlight;
+    private readonly completed;
+    private readonly completedOrder;
+    private readonly queue;
+    private active;
+    private closed;
+    private closing;
+    private readonly closeController;
+    private readonly closeReasons;
+    private readonly idleWaiters;
+    private readonly dedupCap;
+    /** Akumulasi SEMUA job (di/di luar close) — §9.19: unconfirmed terhitung walau gagal sebelum close. */
+    private unconfirmedTotal;
+    constructor(cfg: GhBotConfig, deps: GhBotHubDeps);
+    accept(delivery: CommentDelivery): AcceptResult;
+    private pump;
+    private pushCompleted;
+    private maybeIdle;
+    whenIdle(): Promise<void>;
+    close(): Promise<CloseSummary>;
+    stats(): {
+        queued: number;
+        active: number;
+        inflight: number;
+        completed: number;
+    };
+}

package/dist/ghBotRunner.d.ts

@@ -0,0 +1,82 @@
+import { spawn } from 'node:child_process';
+import type { AgentEvent } from './agent';
+import { type CommentDelivery } from './ghBotWebhook';
+export interface GhDeps {
+    /** ASYNC (spawn, bukan spawnSync), argv array tanpa shell; stdin opsional utk `--input -`
+     *  (EPIPE ditangani); signal → child di-kill; settle sekali via close/error. */
+    spawn(argv: string[], opts?: {
+        signal?: AbortSignal;
+        stdin?: string;
+    }): Promise<{
+        code: number;
+        stdout: string;
+        stderr: string;
+    }>;
+}
+/** Instruksi draf — system prompt murni (tanpa data konteks). */
+export declare function ghSystemPrompt(): string;
+export interface CreateGhSpawnOptions {
+    spawnImpl?: typeof spawn;
+    killGraceMs?: number;
+    hardMs?: number;
+}
+/**
+ * Spawn async dgn settle HANYA dari `close` (KECUALI hard-timeout force-settle),
+ * eskalasi `kill('SIGKILL')` eksplisit, marker SELALU ikut di hard-timeout, dan
+ * cleanup listener/pipe di settle (data telat aman). Lihat spec §6.4.
+ */
+export declare function createGhSpawn(cmd?: string, o?: CreateGhSpawnOptions): GhDeps['spawn'];
+/**
+ * Konteks di-pra-kumpulkan: selalu issue view; bila isPR → pr view + pr diff.
+ * SEMUA gh command membawa --repo dari delivery tervalidasi (tanpa cwd).
+ * Data masuk blok <untrusted-github>; komentar 8KB, issue body 64KB, diff 100KB (byte UTF-8).
+ */
+export declare function collectGhContext(d: CommentDelivery, deps: {
+    gh: GhDeps;
+    signal: AbortSignal;
+}): Promise<{
+    ok: true;
+    context: string;
+} | {
+    ok: false;
+    reason: string;
+}>;
+export type DraftStopReason = 'done' | 'aborted' | 'stepLimit' | 'budgetExceeded' | 'error' | 'none';
+/** Kolektor event agent: text append; textReplace MENGGANTI; stopReason = event terminal terakhir. */
+export declare function createDraftCollector(): {
+    onEvent(e: AgentEvent): void;
+    result(): {
+        text: string;
+        stopReason: DraftStopReason;
+    };
+};
+/**
+ * Sukses HANYA stopReason 'done' + teks non-kosong; selain itu gagal (tanpa post).
+ * dispose SELALU di finally.
+ */
+export declare function runDraft(context: string, signal: AbortSignal, deps: {
+    createAgent(): {
+        run(prompt: string, signal: AbortSignal): Promise<{
+            text: string;
+            stopReason: DraftStopReason;
+        }>;
+        dispose(): Promise<void> | void;
+    };
+    system: string;
+}): Promise<{
+    ok: true;
+    text: string;
+} | {
+    ok: false;
+    reason: string;
+}>;
+/** Post komentar via stdin JSON — hasil TERSTRUKTUR (koreksi review #1). */
+export declare function postReply(d: CommentDelivery, text: string, deps: {
+    gh: GhDeps;
+    signal: AbortSignal;
+}): Promise<{
+    ok: true;
+} | {
+    ok: false;
+    reason: string;
+}>;

package/dist/ghBotServe.d.ts

@@ -0,0 +1,21 @@
+import { type GhBotConfig, type CloseSummary } from './ghBotDispatch';
+import type { Provider } from './provider';
+import { type GhDeps } from './ghBotRunner';
+export interface GhBotServeOptions {
+    port?: number;
+    host?: string;
+    config: GhBotConfig;
+    /** Aksesor per-request (rotasi secret tanpa restart — spec §3). */
+    getSecret: () => string | undefined;
+    env?: NodeJS.ProcessEnv;
+    provider?: Provider;
+    fetch?: typeof globalThis.fetch;
+    gh?: GhDeps;
+    out?: (s?: string) => void;
+    err?: (s?: string) => void;
+}
+export interface GhBotHandle {
+    port: number;
+    close(): Promise<CloseSummary>;
+}
+export declare function startGhBot(opts: GhBotServeOptions): Promise<GhBotHandle>;

package/dist/ghBotWebhook.d.ts

@@ -0,0 +1,45 @@
+/** Header wajib GitHub webhook delivery. */
+export declare const GITHUB_HEADERS: readonly ['x-hub-signature-256', 'x-hub-delivery', 'x-hub-event'];
+export interface CommentDelivery {
+    delivery: string;
+    event: string;
+    action: string;
+    repo: string;
+    number: number;
+    isPR: boolean;
+    author: string;
+    authorType: string;
+    body: string;
+}
+export type VerifyOutcome = {
+    ok: true;
+    delivery: CommentDelivery;
+} | {
+    ok: false;
+    status: 400 | 401 | 405 | 413 | 415 | 503;
+    message: string;
+};
+/** 'sha256=<hex>' atas byte mentah — dipakai verifikasi dan fixture test. */
+export declare function signBody(rawBody: Buffer, secret: string): string;
+declare const HARD_TIMEOUT_MARKER = "<child did not close after termination>";
+export { HARD_TIMEOUT_MARKER };
+/**
+ * Urutan persis spec §3: method → content-type → size (byte) → header wajib →
+ * secret (aksesor per-request) → HMAC atas Buffer MENTAH → decode UTF-8 fatal →
+ * parse → tipe-guard field event. HMAC selalu sebelum decode/parse.
+ */
+export declare function verifyAndParse(rawBody: Buffer, headers: Record<string, string | undefined>, opts: {
+    method: string;
+    contentType: string | undefined;
+    maxBodyBytes: number;
+    getSecret: () => string | undefined;
+}, jsonParse?: (text: string) => unknown): VerifyOutcome;
+/**
+ * '/bccli <task>' → task trim; '/bccli' tanpa task → null (tanpa balasan);
+ * prefix lain / komentar biasa → null.
+ */
+export declare function extractCommand(body: string): string | null;
+/** Potong di batas code point dengan budget byte UTF-8 — tak pernah membelah karakter. */
+export declare function truncateUtf8Bytes(text: string, maxBytes: number, marker?: string): string;
+/** 60% kepala + 40% ekor dalam SATU budget byte, dengan marker di tengah. */
+export declare function truncateHeadTailUtf8(text: string, maxBytes: number, marker?: string): string;

package/dist/hooks.d.ts

@@ -0,0 +1,27 @@
+export type HookEvent = 'PreToolUse' | 'PostToolUse' | 'SessionStart' | 'Stop';
+export interface HookRule {
+    /** Glob over the tool name ('*' matches everything, omitted = every tool). Tool events only. */
+    match?: string;
+    command: string;
+}
+export type HooksConfig = Partial<Record<HookEvent, HookRule[]>>;
+export interface HookOutcome {
+    /** PreToolUse only: the tool call is denied with this message instead of running. */
+    blocked?: string;
+    warnings: string[];
+}
+export interface HookRunOptions {
+    env?: NodeJS.ProcessEnv;
+    cwd?: string;
+    timeoutMs?: number;
+}
+/**
+ * Runs the configured hooks for one event, in order. A PreToolUse hook that exits
+ * with code 2 blocks the tool call (Claude Code semantics); any other failure is a
+ * non-blocking warning. Hooks receive BCCLI_HOOK_EVENT/TOOL/INPUT/OUTPUT env vars.
+ */
+export declare function runHooks(hooks: HooksConfig | undefined, event: HookEvent, payload?: {
+    tool?: string;
+    input?: unknown;
+    output?: string;
+}, opts?: HookRunOptions): Promise<HookOutcome>;

package/dist/i18n/id.d.ts

@@ -0,0 +1 @@
+export declare const ID: Record<string, string>;

package/dist/i18n.d.ts

@@ -0,0 +1,16 @@
+export type Lang = 'en' | 'id';
+export declare const LANGS: readonly Lang[];
+export declare function parseLang(value: string | undefined): Lang | undefined;
+export declare function setLanguage(lang: Lang): void;
+export declare function getLanguage(): Lang;
+/** Locale for dates and numbers, matching the UI language. */
+export declare const locale: () => string;
+/**
+ * User-facing text. The English sentence is the key; Indonesian lives in i18n/id.ts.
+ * Placeholders are `{name}`. Text the model reads (tool results, prompts) is plain English and does not go through here.
+ */
+export declare function t(en: string, params?: Record<string, string | number>): string;
+/** `--lang x` or `--lang=x` from raw argv, so even argument errors can be shown in the right language. */
+export declare function langFromArgv(argv: string[]): Lang | undefined;
+/** --lang, then BCCLI_LANG, then the `language` of the global config, then English. */
+export declare function resolveLanguage(argv: string[], env: NodeJS.ProcessEnv, fromConfig?: string): Lang;