@plune-ai/cairn 0.2.1

package/dist/browser/index.js

@@ -0,0 +1,59 @@
+import { PlaywrightLibBackend } from "./backends/playwright-lib.js";
+import { PlaywrightCliBackend } from "./backends/playwright-cli.js";
+export * from "./gateway.js";
+export * from "./types.js";
+/**
+ * Composite gateway (ADR-0003): observe/act → backend per config; session/runTests → ALWAYS lib.
+ */
+class GatewayImpl {
+    observeBackend;
+    libBackend;
+    constructor(observeBackend, libBackend) {
+        this.observeBackend = observeBackend;
+        this.libBackend = libBackend;
+    }
+    observe(opts) {
+        return this.observeBackend.observe(opts);
+    }
+    act(action) {
+        return this.observeBackend.act(action);
+    }
+    async verify(elements) {
+        if (this.observeBackend.verify)
+            return this.observeBackend.verify(elements);
+        return elements.map((e) => ({ ...e, count: -1, verified: false }));
+    }
+    async getState(element) {
+        if (this.observeBackend.getState)
+            return this.observeBackend.getState(element);
+        return { visible: false, enabled: false };
+    }
+    session() {
+        if (!this.libBackend.session)
+            throw new Error("The lib backend does not provide session().");
+        return this.libBackend.session();
+    }
+    runTests(globs) {
+        if (!this.libBackend.runTests)
+            throw new Error("The lib backend does not provide runTests().");
+        return this.libBackend.runTests(globs);
+    }
+    async close() {
+        await this.observeBackend.close();
+        if (this.libBackend !== this.observeBackend)
+            await this.libBackend.close();
+    }
+}
+export function makeGateway(cfg) {
+    const lib = new PlaywrightLibBackend({
+        headless: cfg.headless ?? true,
+        storageState: cfg.storageState,
+        channel: cfg.channel,
+    });
+    if (cfg.backend === "cli") {
+        // observe/act → cli (token-efficient); session/runTests → lib (ADR-0003).
+        return new GatewayImpl(new PlaywrightCliBackend(), lib);
+    }
+    return new GatewayImpl(lib, lib);
+}
+//# sourceMappingURL=index.js.map

package/dist/browser/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/browser/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,oBAAoB,EAAE,MAAM,8BAA8B,CAAC;AACpE,OAAO,EAAE,oBAAoB,EAAE,MAAM,8BAA8B,CAAC;AAgBpE,cAAc,cAAc,CAAC;AAC7B,cAAc,YAAY,CAAC;AAY3B;;GAEG;AACH,MAAM,WAAW;IAEI;IACA;IAFnB,YACmB,cAA8B,EAC9B,UAA0B;QAD1B,mBAAc,GAAd,cAAc,CAAgB;QAC9B,eAAU,GAAV,UAAU,CAAgB;IAC1C,CAAC;IAEJ,OAAO,CAAC,IAAoB;QAC1B,OAAO,IAAI,CAAC,cAAc,CAAC,OAAO,CAAC,IAAI,CAAC,CAAC;IAC3C,CAAC;IACD,GAAG,CAAC,MAAc;QAChB,OAAO,IAAI,CAAC,cAAc,CAAC,GAAG,CAAC,MAAM,CAAC,CAAC;IACzC,CAAC;IACD,KAAK,CAAC,MAAM,CAAC,QAAsB;QACjC,IAAI,IAAI,CAAC,cAAc,CAAC,MAAM;YAAE,OAAO,IAAI,CAAC,cAAc,CAAC,MAAM,CAAC,QAAQ,CAAC,CAAC;QAC5E,OAAO,QAAQ,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,EAAE,GAAG,CAAC,EAAE,KAAK,EAAE,CAAC,CAAC,EAAE,QAAQ,EAAE,KAAK,EAAE,CAAC,CAAC,CAAC;IACrE,CAAC;IACD,KAAK,CAAC,QAAQ,CAAC,OAAmB;QAChC,IAAI,IAAI,CAAC,cAAc,CAAC,QAAQ;YAAE,OAAO,IAAI,CAAC,cAAc,CAAC,QAAQ,CAAC,OAAO,CAAC,CAAC;QAC/E,OAAO,EAAE,OAAO,EAAE,KAAK,EAAE,OAAO,EAAE,KAAK,EAAE,CAAC;IAC5C,CAAC;IACD,OAAO;QACL,IAAI,CAAC,IAAI,CAAC,UAAU,CAAC,OAAO;YAAE,MAAM,IAAI,KAAK,CAAC,6CAA6C,CAAC,CAAC;QAC7F,OAAO,IAAI,CAAC,UAAU,CAAC,OAAO,EAAE,CAAC;IACnC,CAAC;IACD,QAAQ,CAAC,KAAe;QACtB,IAAI,CAAC,IAAI,CAAC,UAAU,CAAC,QAAQ;YAAE,MAAM,IAAI,KAAK,CAAC,8CAA8C,CAAC,CAAC;QAC/F,OAAO,IAAI,CAAC,UAAU,CAAC,QAAQ,CAAC,KAAK,CAAC,CAAC;IACzC,CAAC;IACD,KAAK,CAAC,KAAK;QACT,MAAM,IAAI,CAAC,cAAc,CAAC,KAAK,EAAE,CAAC;QAClC,IAAI,IAAI,CAAC,UAAU,KAAK,IAAI,CAAC,cAAc;YAAE,MAAM,IAAI,CAAC,UAAU,CAAC,KAAK,EAAE,CAAC;IAC7E,CAAC;CACF;AAED,MAAM,UAAU,WAAW,CAAC,GAAkB;IAC5C,MAAM,GAAG,GAAG,IAAI,oBAAoB,CAAC;QACnC,QAAQ,EAAE,GAAG,CAAC,QAAQ,IAAI,IAAI;QAC9B,YAAY,EAAE,GAAG,CAAC,YAAY;QAC9B,OAAO,EAAE,GAAG,CAAC,OAAO;KACrB,CAAC,CAAC;IACH,IAAI,GAAG,CAAC,OAAO,KAAK,KAAK,EAAE,CAAC;QAC1B,0EAA0E;QAC1E,OAAO,IAAI,WAAW,CAAC,IAAI,oBAAoB,EAAE,EAAE,GAAG,CAAC,CAAC;IAC1D,CAAC;IACD,OAAO,IAAI,WAAW,CAAC,GAAG,EAAE,GAAG,CAAC,CAAC;AACnC,CAAC"}

package/dist/browser/types.d.ts

@@ -0,0 +1,99 @@
+/**
+ * Browser-layer contracts (ADR-0003). Shared by both backends and PageObserver.
+ * `Observation` — raw observation from the backend; the normalized `PageStudy` is built by PageObserver.
+ */
+/** Stable element identifier for act() (the backend synthesizes them: e1, e2…). */
+export interface ElementRef {
+    ref: string;
+    role: string;
+    name?: string;
+    /** Whether the element is interactive (button/textbox/link/checkbox…). */
+    interactive: boolean;
+    /** Testing importance (higher = more important). */
+    rank: number;
+}
+/** Observed element state (for act→observe grounding). */
+export interface ElementState {
+    visible: boolean;
+    enabled: boolean;
+    /** For checkable elements (switch/checkbox/radio); otherwise undefined. */
+    checked?: boolean;
+}
+/** An element with a verified locator (verify-before-design, grounding). */
+export interface VerifiedElement extends ElementRef {
+    /** How many elements the getByRole(role,{name}) locator resolves to. */
+    count: number;
+    /** count === 1 — suitable for a reliable test. */
+    verified: boolean;
+    /** If the element is hidden behind a tab/view — which switcher to click first (multi-state). */
+    viaSwitcher?: {
+        role: string;
+        name?: string;
+    };
+}
+/** Raw page observation. */
+export interface Observation {
+    url: string;
+    screenshotB64: string;
+    ariaSnapshot: string;
+    capturedBy: BackendKind;
+    /** Page JS errors (console.error + uncaught) — a signal for error-aware design/repair. */
+    consoleErrors?: string[];
+}
+export type BackendKind = "lib" | "cli";
+export interface ObserveOptions {
+    /** If set — navigate to this URL first. */
+    url?: string;
+    /** Screenshot of the whole page (not just the viewport). */
+    fullPage?: boolean;
+}
+export type Action = {
+    kind: "navigate";
+    url: string;
+} | {
+    kind: "click";
+    ref: string;
+} | {
+    kind: "fill";
+    ref: string;
+    value: string;
+};
+export interface ActResult {
+    ok: boolean;
+    ref?: string;
+    error?: string;
+}
+/**
+ * Playwright storageState structure (JSON): cookies + per-origin localStorage.
+ * Defined structurally so that SessionStore and the gateway do not pull in playwright types directly.
+ */
+export interface StorageState {
+    cookies: Array<{
+        name: string;
+        value: string;
+        domain: string;
+        path: string;
+        expires?: number;
+        [k: string]: unknown;
+    }>;
+    origins: Array<{
+        origin: string;
+        localStorage: Array<{
+            name: string;
+            value: string;
+        }>;
+    }>;
+}
+export interface SessionApi {
+    /** Load saved state into the current browser session. */
+    load(state: StorageState): Promise<void>;
+    /** Capture the current state (cookies + localStorage). */
+    save(): Promise<StorageState>;
+}
+/** Run report for the generated tests (populated in Sprint 3). */
+export interface TestRunReport {
+    passed: number;
+    failed: number;
+    flaky: number;
+}
+//# sourceMappingURL=types.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../../src/browser/types.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAEH,mFAAmF;AACnF,MAAM,WAAW,UAAU;IACzB,GAAG,EAAE,MAAM,CAAC;IACZ,IAAI,EAAE,MAAM,CAAC;IACb,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,0EAA0E;IAC1E,WAAW,EAAE,OAAO,CAAC;IACrB,oDAAoD;IACpD,IAAI,EAAE,MAAM,CAAC;CACd;AAED,0DAA0D;AAC1D,MAAM,WAAW,YAAY;IAC3B,OAAO,EAAE,OAAO,CAAC;IACjB,OAAO,EAAE,OAAO,CAAC;IACjB,2EAA2E;IAC3E,OAAO,CAAC,EAAE,OAAO,CAAC;CACnB;AAED,4EAA4E;AAC5E,MAAM,WAAW,eAAgB,SAAQ,UAAU;IACjD,wEAAwE;IACxE,KAAK,EAAE,MAAM,CAAC;IACd,kDAAkD;IAClD,QAAQ,EAAE,OAAO,CAAC;IAClB,gGAAgG;IAChG,WAAW,CAAC,EAAE;QAAE,IAAI,EAAE,MAAM,CAAC;QAAC,IAAI,CAAC,EAAE,MAAM,CAAA;KAAE,CAAC;CAC/C;AAED,4BAA4B;AAC5B,MAAM,WAAW,WAAW;IAC1B,GAAG,EAAE,MAAM,CAAC;IACZ,aAAa,EAAE,MAAM,CAAC;IACtB,YAAY,EAAE,MAAM,CAAC;IACrB,UAAU,EAAE,WAAW,CAAC;IACxB,0FAA0F;IAC1F,aAAa,CAAC,EAAE,MAAM,EAAE,CAAC;CAC1B;AAED,MAAM,MAAM,WAAW,GAAG,KAAK,GAAG,KAAK,CAAC;AAExC,MAAM,WAAW,cAAc;IAC7B,2CAA2C;IAC3C,GAAG,CAAC,EAAE,MAAM,CAAC;IACb,4DAA4D;IAC5D,QAAQ,CAAC,EAAE,OAAO,CAAC;CACpB;AAED,MAAM,MAAM,MAAM,GACd;IAAE,IAAI,EAAE,UAAU,CAAC;IAAC,GAAG,EAAE,MAAM,CAAA;CAAE,GACjC;IAAE,IAAI,EAAE,OAAO,CAAC;IAAC,GAAG,EAAE,MAAM,CAAA;CAAE,GAC9B;IAAE,IAAI,EAAE,MAAM,CAAC;IAAC,GAAG,EAAE,MAAM,CAAC;IAAC,KAAK,EAAE,MAAM,CAAA;CAAE,CAAC;AAEjD,MAAM,WAAW,SAAS;IACxB,EAAE,EAAE,OAAO,CAAC;IACZ,GAAG,CAAC,EAAE,MAAM,CAAC;IACb,KAAK,CAAC,EAAE,MAAM,CAAC;CAChB;AAED;;;GAGG;AACH,MAAM,WAAW,YAAY;IAC3B,OAAO,EAAE,KAAK,CAAC;QACb,IAAI,EAAE,MAAM,CAAC;QACb,KAAK,EAAE,MAAM,CAAC;QACd,MAAM,EAAE,MAAM,CAAC;QACf,IAAI,EAAE,MAAM,CAAC;QACb,OAAO,CAAC,EAAE,MAAM,CAAC;QACjB,CAAC,CAAC,EAAE,MAAM,GAAG,OAAO,CAAC;KACtB,CAAC,CAAC;IACH,OAAO,EAAE,KAAK,CAAC;QACb,MAAM,EAAE,MAAM,CAAC;QACf,YAAY,EAAE,KAAK,CAAC;YAAE,IAAI,EAAE,MAAM,CAAC;YAAC,KAAK,EAAE,MAAM,CAAA;SAAE,CAAC,CAAC;KACtD,CAAC,CAAC;CACJ;AAED,MAAM,WAAW,UAAU;IACzB,yDAAyD;IACzD,IAAI,CAAC,KAAK,EAAE,YAAY,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;IACzC,0DAA0D;IAC1D,IAAI,IAAI,OAAO,CAAC,YAAY,CAAC,CAAC;CAC/B;AAED,kEAAkE;AAClE,MAAM,WAAW,aAAa;IAC5B,MAAM,EAAE,MAAM,CAAC;IACf,MAAM,EAAE,MAAM,CAAC;IACf,KAAK,EAAE,MAAM,CAAC;CACf"}

package/dist/browser/types.js

@@ -0,0 +1,6 @@
+/**
+ * Browser-layer contracts (ADR-0003). Shared by both backends and PageObserver.
+ * `Observation` — raw observation from the backend; the normalized `PageStudy` is built by PageObserver.
+ */
+export {};
+//# sourceMappingURL=types.js.map

package/dist/browser/types.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.js","sourceRoot":"","sources":["../../src/browser/types.ts"],"names":[],"mappings":"AAAA;;;GAGG"}

package/dist/checklist/index.d.ts

@@ -0,0 +1,24 @@
+/** A human-authored checklist item (directs WHAT to test). */
+export interface ChecklistItem {
+    text: string;
+    priority?: "low" | "medium" | "high" | "critical";
+}
+/**
+ * Parse a checklist into items. Supports two formats:
+ * - structured doc (headings `## TC-01 …`) → take case headings as items (body is ignored);
+ * - flat checklist (bullets/numbering) → take lines as items.
+ */
+export declare function ingestChecklist(raw: string): ChecklistItem[];
+/** Checklist text for the designer prompt ({{checklist}}). Empty → "". */
+export declare function formatChecklist(items: ChecklistItem[]): string;
+/** Detect the text language (for language-consistent design): Cyrillic → "Ukrainian", otherwise → "English". */
+export declare function detectLanguage(text: string): string;
+/** Planning style (idea from explorbot): directs the design focus. "all"/unknown → "" (balanced). */
+export declare function styleDirective(style: string): string;
+/** checklist_coverage: fraction of checklist items mentioned in at least one case (by shared tokens). */
+export declare function coverageScore(items: ChecklistItem[], cases: {
+    title: string;
+    steps: string[];
+    expected: string;
+}[]): number;
+//# sourceMappingURL=index.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/checklist/index.ts"],"names":[],"mappings":"AAAA,8DAA8D;AAC9D,MAAM,WAAW,aAAa;IAC5B,IAAI,EAAE,MAAM,CAAC;IACb,QAAQ,CAAC,EAAE,KAAK,GAAG,QAAQ,GAAG,MAAM,GAAG,UAAU,CAAC;CACnD;AAED;;;;GAIG;AACH,wBAAgB,eAAe,CAAC,GAAG,EAAE,MAAM,GAAG,aAAa,EAAE,CAoB5D;AAED,0EAA0E;AAC1E,wBAAgB,eAAe,CAAC,KAAK,EAAE,aAAa,EAAE,GAAG,MAAM,CAM9D;AAED,gHAAgH;AAChH,wBAAgB,cAAc,CAAC,IAAI,EAAE,MAAM,GAAG,MAAM,CAEnD;AAED,qGAAqG;AACrG,wBAAgB,cAAc,CAAC,KAAK,EAAE,MAAM,GAAG,MAAM,CAWpD;AAWD,yGAAyG;AACzG,wBAAgB,aAAa,CAC3B,KAAK,EAAE,aAAa,EAAE,EACtB,KAAK,EAAE;IAAE,KAAK,EAAE,MAAM,CAAC;IAAC,KAAK,EAAE,MAAM,EAAE,CAAC;IAAC,QAAQ,EAAE,MAAM,CAAA;CAAE,EAAE,GAC5D,MAAM,CAQR"}

package/dist/checklist/index.js

@@ -0,0 +1,65 @@
+/**
+ * Parse a checklist into items. Supports two formats:
+ * - structured doc (headings `## TC-01 …`) → take case headings as items (body is ignored);
+ * - flat checklist (bullets/numbering) → take lines as items.
+ */
+export function ingestChecklist(raw) {
+    const lines = raw.split(/\r?\n/).map((l) => l.trim());
+    const headings = lines
+        .filter((l) => /^#{2,}\s+/.test(l))
+        .map((l) => l.replace(/^#{2,}\s+/, "").replace(/\*\*/g, "").trim())
+        .filter((l) => l.length > 0);
+    if (headings.length > 0)
+        return headings.map((text) => ({ text }));
+    return lines
+        .filter((l) => l.length > 0 && !l.startsWith("#"))
+        .map((l) => l
+        .replace(/^[-*+]\s+/, "")
+        .replace(/^\d+[.)]\s+/, "")
+        .replace(/\*\*/g, "")
+        .trim())
+        .filter((l) => l.length > 0)
+        .map((text) => ({ text }));
+}
+/** Checklist text for the designer prompt ({{checklist}}). Empty → "". */
+export function formatChecklist(items) {
+    if (items.length === 0)
+        return "";
+    return ("Checklist (directs the design — test EXACTLY these items and prioritize them):\n" +
+        items.map((i) => `- ${i.text}`).join("\n"));
+}
+/** Detect the text language (for language-consistent design): Cyrillic → "Ukrainian", otherwise → "English". */
+export function detectLanguage(text) {
+    return /[Ѐ-ӿ]/i.test(text) ? "Ukrainian" : "English";
+}
+/** Planning style (idea from explorbot): directs the design focus. "all"/unknown → "" (balanced). */
+export function styleDirective(style) {
+    switch (style) {
+        case "happy":
+            return "STYLE FOR THIS RUN: focus on POSITIVE happy-path scenarios (valid data, main flows).";
+        case "negative":
+            return "STYLE FOR THIS RUN: focus on NEGATIVE/edge scenarios (invalid input, errors, boundaries).";
+        case "coverage":
+            return "STYLE FOR THIS RUN: fill coverage GAPS — scenarios that are usually missed (rare states, combinations, decision-table).";
+        default:
+            return "";
+    }
+}
+function tokens(s) {
+    return new Set(s
+        .toLowerCase()
+        .split(/[^a-z0-9а-яіїєґ]+/i)
+        .filter((t) => t.length >= 4));
+}
+/** checklist_coverage: fraction of checklist items mentioned in at least one case (by shared tokens). */
+export function coverageScore(items, cases) {
+    if (items.length === 0)
+        return 0;
+    const caseTokens = cases.map((c) => tokens(`${c.title} ${c.steps.join(" ")} ${c.expected}`));
+    const covered = items.filter((item) => {
+        const itemTokens = [...tokens(item.text)];
+        return caseTokens.some((ct) => itemTokens.some((t) => ct.has(t)));
+    }).length;
+    return covered / items.length;
+}
+//# sourceMappingURL=index.js.map

package/dist/checklist/index.js.map

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

package/dist/cli/branding.d.ts

@@ -0,0 +1,14 @@
+/**
+ * CLI branding + the deprecated-alias notice (C0-03 / C0-04).
+ *
+ * `cairn` is the primary command; `lex-bot` remains a hidden, deprecated alias
+ * (see src/cli/lex-bot.ts) that prints {@link LEXBOT_CLI_NOTICE} before delegating
+ * to the same code path. Nothing is removed yet — full backward compatibility.
+ */
+export declare const PRIMARY_BIN: "cairn";
+export declare const DEPRECATED_BIN: "lex-bot";
+/** Product tagline (umbrella framing across surfaces). */
+export declare const TAGLINE: "Cairn \u2014 an AI that walks your system and leaves a trail of tests: UI, API, unit, docs.";
+/** One-line notice printed to stderr when invoked via the legacy `lex-bot` alias. */
+export declare const LEXBOT_CLI_NOTICE: "\u26A0 `lex-bot` is deprecated and will be removed in 1\u20132 releases \u2014 use `cairn` instead.";
+//# sourceMappingURL=branding.d.ts.map

package/dist/cli/branding.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"branding.d.ts","sourceRoot":"","sources":["../../src/cli/branding.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AACH,eAAO,MAAM,WAAW,EAAG,OAAgB,CAAC;AAC5C,eAAO,MAAM,cAAc,EAAG,SAAkB,CAAC;AAEjD,0DAA0D;AAC1D,eAAO,MAAM,OAAO,EAClB,6FAAiG,CAAC;AAEpG,qFAAqF;AACrF,eAAO,MAAM,iBAAiB,EAC5B,qGAA+F,CAAC"}

package/dist/cli/branding.js

@@ -0,0 +1,14 @@
+/**
+ * CLI branding + the deprecated-alias notice (C0-03 / C0-04).
+ *
+ * `cairn` is the primary command; `lex-bot` remains a hidden, deprecated alias
+ * (see src/cli/lex-bot.ts) that prints {@link LEXBOT_CLI_NOTICE} before delegating
+ * to the same code path. Nothing is removed yet — full backward compatibility.
+ */
+export const PRIMARY_BIN = "cairn";
+export const DEPRECATED_BIN = "lex-bot";
+/** Product tagline (umbrella framing across surfaces). */
+export const TAGLINE = "Cairn — an AI that walks your system and leaves a trail of tests: UI, API, unit, docs.";
+/** One-line notice printed to stderr when invoked via the legacy `lex-bot` alias. */
+export const LEXBOT_CLI_NOTICE = "⚠ `lex-bot` is deprecated and will be removed in 1–2 releases — use `cairn` instead.";
+//# sourceMappingURL=branding.js.map

package/dist/cli/branding.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"branding.js","sourceRoot":"","sources":["../../src/cli/branding.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AACH,MAAM,CAAC,MAAM,WAAW,GAAG,OAAgB,CAAC;AAC5C,MAAM,CAAC,MAAM,cAAc,GAAG,SAAkB,CAAC;AAEjD,0DAA0D;AAC1D,MAAM,CAAC,MAAM,OAAO,GAClB,wFAAiG,CAAC;AAEpG,qFAAqF;AACrF,MAAM,CAAC,MAAM,iBAAiB,GAC5B,sFAA+F,CAAC"}

package/dist/cli/index.d.ts

@@ -0,0 +1,12 @@
+#!/usr/bin/env node
+/**
+ * CLI `cairn`. Commands: observe · explore · design · automate · dataset-add · experiment.
+ * `lex-bot` stays as a hidden, deprecated alias (see ./lex-bot.ts) → same code path.
+ */
+import "dotenv/config";
+/**
+ * Run the CLI. Shared by the primary `cairn` entry (this file) and the deprecated
+ * `lex-bot` alias shim (./lex-bot.ts), so both go through the exact same code path.
+ */
+export declare function runCli(): Promise<void>;
+//# sourceMappingURL=index.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/cli/index.ts"],"names":[],"mappings":";AACA;;;GAGG;AACH,OAAO,eAAe,CAAC;AAuVvB;;;GAGG;AACH,wBAAsB,MAAM,IAAI,OAAO,CAAC,IAAI,CAAC,CAgB5C"}