@ironbee-ai/cli 0.1.1

package/dist/hooks/core/verify-gate.js

@@ -0,0 +1,222 @@
+"use strict";
+/**
+ * IronBee Stop Hook — Core Verification Logic
+ *
+ * Pure logic — no stdin reading, no process.exit, no client-specific code.
+ * Returns a VerifyGateResult that the client adapter translates
+ * into the appropriate exit code / output mechanism.
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.runVerifyGate = runVerifyGate;
+const fs_1 = require("fs");
+const path_1 = require("path");
+const logger_1 = require("../../lib/logger");
+const actions_1 = require("./actions");
+const DEFAULT_MAX_RETRIES = 3;
+const VERDICT_EXAMPLE_PASS = JSON.stringify({
+    status: "pass",
+    pages_tested: ["http://localhost:3000/affected-page"],
+    checks: ["form submits successfully", "new item appears in list", "no console errors"],
+    console_errors: 0,
+    network_failures: 0,
+});
+const VERDICT_EXAMPLE_FAIL = JSON.stringify({
+    status: "fail",
+    pages_tested: ["http://localhost:3000/affected-page"],
+    checks: ["form renders", "submit button unresponsive"],
+    console_errors: 2,
+    network_failures: 0,
+    errors: ["button click handler not firing", "TypeError in console"],
+});
+const MCP_SERVER = "browser-devtools";
+const REQUIRED_TOOLS = [
+    { toolName: `mcp__${MCP_SERVER}__navigation_go-to`, name: `mcp__${MCP_SERVER}__navigation_go-to`, purpose: "navigate to a page" },
+    { toolName: `mcp__${MCP_SERVER}__content_take-screenshot`, name: `mcp__${MCP_SERVER}__content_take-screenshot`, purpose: "take a screenshot" },
+    { toolName: `mcp__${MCP_SERVER}__a11y_take-aria-snapshot`, name: `mcp__${MCP_SERVER}__a11y_take-aria-snapshot`, purpose: "check accessibility/page structure" },
+    { toolName: `mcp__${MCP_SERVER}__o11y_get-console-messages`, name: `mcp__${MCP_SERVER}__o11y_get-console-messages`, purpose: "check console for errors" },
+];
+function cleanup(...files) {
+    for (const f of files) {
+        try {
+            if ((0, fs_1.existsSync)(f)) {
+                (0, fs_1.unlinkSync)(f);
+            }
+        }
+        catch (e) {
+            logger_1.logger.debug(`failed to cleanup ${f}: ${e}`);
+        }
+    }
+}
+function runVerifyGate(input) {
+    const { sessionId: sid, actionsFile, verdictFile, retryFile, maxRetries: inputMaxRetries } = input;
+    const maxRetries = inputMaxRetries ?? DEFAULT_MAX_RETRIES;
+    logger_1.logger.debug(`verify-gate: session=${sid} verdictExists=${(0, fs_1.existsSync)(verdictFile)}`);
+    // ── Check 1: Were code files edited? ───────────────────
+    const hasEdit = (0, actions_1.hasFileEditsSinceLastVerification)(actionsFile);
+    if (!hasEdit) {
+        logger_1.logger.debug("no code edits detected, allowing completion");
+        return { action: "allow" };
+    }
+    // ── Check 2: Were required IronBee tools used? ─────────
+    const toolCalls = (0, actions_1.getToolCallsSinceLastVerification)(actionsFile);
+    const usedToolNames = new Set(toolCalls.map((t) => t.tool_name));
+    const missingTools = REQUIRED_TOOLS.filter((t) => !usedToolNames.has(t.toolName));
+    logger_1.logger.debug(`verify-gate: missingTools=${missingTools.length}/${REQUIRED_TOOLS.length} usedTools=${[...usedToolNames].join(",")}`);
+    // Write verification_requested marker for this check
+    const marker = {
+        type: "verification_requested",
+        timestamp: new Date().toISOString(),
+    };
+    (0, actions_1.appendAction)(actionsFile, marker);
+    if (missingTools.length === REQUIRED_TOOLS.length) {
+        return {
+            action: "block",
+            message: `VERIFICATION REQUIRED.
+
+You made code changes but did not verify them through the browser.
+
+1. Build and start the application if not already running
+2. Navigate to the affected page(s)
+3. Functionally test your changes — click, type, submit, interact with the UI to confirm the code works
+4. Take a screenshot to capture the final state
+5. Take an accessibility snapshot to verify page structure
+6. Check console for errors
+7. Stop the dev server when done
+8. Use the Write tool to write your verdict to .ironbee/sessions/${sid}/verdict.json
+   On pass: ${VERDICT_EXAMPLE_PASS}
+   On fail: ${VERDICT_EXAMPLE_FAIL}
+9. If failed, fix the code and re-verify until it passes`,
+        };
+    }
+    if (missingTools.length > 0) {
+        const missing = missingTools.map((t) => `  - ${t.name} (${t.purpose})`).join("\n");
+        return {
+            action: "block",
+            message: `INCOMPLETE VERIFICATION.
+
+You used the IronBee browser agent but skipped required checks:
+${missing}
+
+Run the missing tools, functionally test your changes, then update your verdict:
+  .ironbee/sessions/${sid}/verdict.json`,
+        };
+    }
+    // ── Check 3: Verdict file exists? ──────────────────────
+    if (!(0, fs_1.existsSync)(verdictFile)) {
+        return {
+            action: "block",
+            message: `VERDICT MISSING.
+
+You used the IronBee browser agent but did not write a verdict.
+Use the Write tool to write your verdict to .ironbee/sessions/${sid}/verdict.json
+  On pass: ${VERDICT_EXAMPLE_PASS}
+  On fail: ${VERDICT_EXAMPLE_FAIL}`,
+        };
+    }
+    // ── Check 4: Valid JSON? ────────────────────────────────
+    let verdict;
+    try {
+        verdict = JSON.parse((0, fs_1.readFileSync)(verdictFile, "utf-8"));
+    }
+    catch (e) {
+        logger_1.logger.debug(`failed to parse verdict ${verdictFile}: ${e}`);
+        cleanup(verdictFile);
+        return {
+            action: "block",
+            message: `INVALID VERDICT. Use the Write tool to write valid JSON to .ironbee/sessions/${sid}/verdict.json
+  On pass: ${VERDICT_EXAMPLE_PASS}
+  On fail: ${VERDICT_EXAMPLE_FAIL}`,
+        };
+    }
+    // ── Check 5: Evidence present? ─────────────────────────
+    const pages = verdict.pages_tested;
+    const checks = verdict.checks;
+    if (!Array.isArray(pages) || pages.length === 0) {
+        cleanup(verdictFile);
+        return {
+            action: "block",
+            message: `VERDICT REJECTED: missing pages_tested.
+
+Your verdict must include which pages you tested.
+Use the Write tool to write to .ironbee/sessions/${sid}/verdict.json
+  Example: ${VERDICT_EXAMPLE_PASS}`,
+        };
+    }
+    if (!Array.isArray(checks) || checks.length === 0) {
+        cleanup(verdictFile);
+        return {
+            action: "block",
+            message: `VERDICT REJECTED: missing checks.
+
+Your verdict must describe what you functionally tested.
+Use the Write tool to write to .ironbee/sessions/${sid}/verdict.json
+  Example: ${VERDICT_EXAMPLE_PASS}`,
+        };
+    }
+    if (typeof verdict.console_errors !== "number" || typeof verdict.network_failures !== "number") {
+        cleanup(verdictFile);
+        return {
+            action: "block",
+            message: `VERDICT REJECTED: missing console_errors or network_failures count.
+
+Your verdict must include error counts.
+Use the Write tool to write to .ironbee/sessions/${sid}/verdict.json
+  Example: ${VERDICT_EXAMPLE_PASS}`,
+        };
+    }
+    // ── Check 6: Pass or fail? ─────────────────────────────
+    if (verdict.status === "pass") {
+        logger_1.logger.debug("verdict passed, allowing completion");
+        cleanup(retryFile);
+        return { action: "allow" };
+    }
+    if (verdict.status === "fail") {
+        let retries = 0;
+        try {
+            retries = parseInt((0, fs_1.readFileSync)(retryFile, "utf-8"), 10) || 0;
+        }
+        catch (e) {
+            logger_1.logger.debug(`failed to read retry file ${retryFile}: ${e}`);
+        }
+        retries++;
+        (0, fs_1.mkdirSync)((0, path_1.dirname)(retryFile), { recursive: true });
+        (0, fs_1.writeFileSync)(retryFile, String(retries));
+        const errors = (verdict.errors ?? ["unknown"]).join("\n  - ");
+        if (retries >= maxRetries) {
+            cleanup(verdictFile, retryFile);
+            return {
+                action: "allow",
+                message: `VERIFICATION FAILED ${maxRetries} TIMES. Allowing completion.
+
+Unresolved issues:
+  - ${errors}
+
+Report these issues in your final response.`,
+            };
+        }
+        cleanup(verdictFile);
+        return {
+            action: "block",
+            message: `VERIFICATION FAILED (attempt ${retries}/${maxRetries}).
+
+Issues found:
+  - ${errors}
+
+Fix the issues, rebuild if needed, re-test functionally through the browser, and re-verify.
+Write verdict to: .ironbee/sessions/${sid}/verdict.json
+
+Required verdict format:
+  ${VERDICT_EXAMPLE_FAIL}`,
+        };
+    }
+    // ── Unknown status ─────────────────────────────────────
+    cleanup(verdictFile);
+    return {
+        action: "block",
+        message: `INVALID VERDICT STATUS: "${verdict.status}". Status must be "pass" or "fail".
+Use the Write tool to write to .ironbee/sessions/${sid}/verdict.json
+  On pass: ${VERDICT_EXAMPLE_PASS}
+  On fail: ${VERDICT_EXAMPLE_FAIL}`,
+    };
+}
+//# sourceMappingURL=verify-gate.js.map

package/dist/hooks/core/verify-gate.js.map

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

package/dist/index.d.ts

@@ -0,0 +1,3 @@
+#!/usr/bin/env node
+export {};
+//# sourceMappingURL=index.d.ts.map

package/dist/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":""}

package/dist/index.js

@@ -0,0 +1,56 @@
+#!/usr/bin/env node
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+const commander_1 = require("commander");
+const fs_1 = require("fs");
+const path_1 = require("path");
+const install_1 = require("./commands/install");
+const uninstall_1 = require("./commands/uninstall");
+const update_1 = require("./commands/update");
+const hook_1 = require("./commands/hook");
+const status_1 = require("./commands/status");
+const verify_1 = require("./commands/verify");
+const icon_1 = require("./lib/icon");
+const version_1 = require("./lib/version");
+const output_1 = require("./lib/output");
+const pkg = JSON.parse((0, fs_1.readFileSync)((0, path_1.join)(__dirname, "../package.json"), "utf-8"));
+const program = new commander_1.Command();
+program
+    .name("ironbee")
+    .description(pkg.description)
+    .version(pkg.version);
+program.addCommand(install_1.installCommand);
+program.addCommand(uninstall_1.uninstallCommand);
+program.addCommand(update_1.updateCommand);
+program.addCommand(status_1.statusCommand);
+program.addCommand(verify_1.verifyCommand);
+program.addCommand(hook_1.hookCommand);
+// hook subcommands run in the background — skip banner and update check
+const isHookCommand = process.argv[2] === "hook";
+if (process.argv.length === 2) {
+    (0, icon_1.printBanner)();
+    console.log();
+    console.log(`  ${output_1.pc.bold("IronBee CLI")} ${output_1.pc.dim(`v${(0, version_1.getLocalVersion)()}`)}`);
+    console.log(`  ${output_1.pc.dim(pkg.description)}`);
+    console.log();
+    console.log(`  ${output_1.pc.bold(output_1.pc.cyan("Usage:"))} ${output_1.pc.green("ironbee")} ${output_1.pc.dim("<command> [options]")}`);
+    console.log();
+    console.log(`  ${output_1.pc.bold(output_1.pc.cyan("Commands:"))}`);
+    console.log(`    ${output_1.pc.green("install")}    ${output_1.pc.dim("[project-dir]")}   Install hooks and guidance files`);
+    console.log(`    ${output_1.pc.green("uninstall")}  ${output_1.pc.dim("[project-dir]")}   Remove hooks, guidance files, and .ironbee/`);
+    console.log(`    ${output_1.pc.green("update")}                     Update to the latest version`);
+    console.log(`    ${output_1.pc.green("status")}     ${output_1.pc.dim("[project-dir]")}   Show verification status for sessions`);
+    console.log(`    ${output_1.pc.green("verify")}     ${output_1.pc.dim("[session-id]")}    Dry-run verdict validation`);
+    console.log();
+    console.log(`  ${output_1.pc.dim("Run")} ${output_1.pc.cyan("ironbee <command> --help")} ${output_1.pc.dim("for more info on a command.")}`);
+    console.log();
+}
+else if (isHookCommand) {
+    program.parse(process.argv);
+}
+else {
+    program.parse(process.argv);
+    // non-blocking update check after command completes
+    (0, version_1.checkForUpdates)().catch(() => { });
+}
+//# sourceMappingURL=index.js.map

package/dist/index.js.map

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

package/dist/lib/config.d.ts

@@ -0,0 +1,44 @@
+/**
+ * IronBee — Configuration Loader
+ *
+ * Loads config from two sources and merges them:
+ *   1. Global:  ~/.ironbee/config.json
+ *   2. Project: <projectDir>/.ironbee/config.json
+ *
+ * Project config overrides global config (shallow merge per key).
+ */
+export interface IronBeeConfig {
+    /**
+     * Glob patterns for files that require browser verification after editing.
+     * Replaces the default list entirely when set.
+     * Examples: "*.ts", "*.css", "src/components/**\/*.tsx"
+     */
+    verifyPatterns?: string[];
+    /**
+     * Additional glob patterns appended to verifyPatterns (or the defaults).
+     * Use this to extend the default list without replacing it.
+     */
+    additionalVerifyPatterns?: string[];
+    /**
+     * Glob patterns for files to exclude from verification.
+     * Checked before verifyPatterns — if a file matches here, it is always skipped.
+     * Examples: "*.test.ts", "docs/**", "*.config.js"
+     */
+    ignoredVerifyPatterns?: string[];
+    /** Maximum retry attempts before allowing completion despite failures. */
+    maxRetries?: number;
+    /** Allow additional config fields. */
+    [key: string]: unknown;
+}
+export declare function loadConfig(projectDir?: string): IronBeeConfig;
+/**
+ * Determines whether a file requires browser verification.
+ *
+ * Check order:
+ *   1. ignoredVerifyPatterns → if matched, skip (return false)
+ *   2. verifyPatterns (+ additionalVerifyPatterns) → if matched, verify (return true)
+ *   3. No match → skip (return false)
+ */
+export declare function requiresVerification(filePath: string, config: IronBeeConfig): boolean;
+export declare function getMaxRetries(config: IronBeeConfig): number;
+//# sourceMappingURL=config.d.ts.map

package/dist/lib/config.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"config.d.ts","sourceRoot":"","sources":["../../src/lib/config.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AAOH,MAAM,WAAW,aAAa;IAC1B;;;;OAIG;IACH,cAAc,CAAC,EAAE,MAAM,EAAE,CAAC;IAE1B;;;OAGG;IACH,wBAAwB,CAAC,EAAE,MAAM,EAAE,CAAC;IAEpC;;;;OAIG;IACH,qBAAqB,CAAC,EAAE,MAAM,EAAE,CAAC;IAEjC,0EAA0E;IAC1E,UAAU,CAAC,EAAE,MAAM,CAAC;IAEpB,sCAAsC;IACtC,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO,CAAC;CAC1B;AA6CD,wBAAgB,UAAU,CAAC,UAAU,CAAC,EAAE,MAAM,GAAG,aAAa,CAiB7D;AAyCD;;;;;;;GAOG;AACH,wBAAgB,oBAAoB,CAAC,QAAQ,EAAE,MAAM,EAAE,MAAM,EAAE,aAAa,GAAG,OAAO,CAarF;AAED,wBAAgB,aAAa,CAAC,MAAM,EAAE,aAAa,GAAG,MAAM,CAI3D"}

package/dist/lib/config.js

@@ -0,0 +1,135 @@
+"use strict";
+/**
+ * IronBee — Configuration Loader
+ *
+ * Loads config from two sources and merges them:
+ *   1. Global:  ~/.ironbee/config.json
+ *   2. Project: <projectDir>/.ironbee/config.json
+ *
+ * Project config overrides global config (shallow merge per key).
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.loadConfig = loadConfig;
+exports.requiresVerification = requiresVerification;
+exports.getMaxRetries = getMaxRetries;
+const fs_1 = require("fs");
+const path_1 = require("path");
+const os_1 = require("os");
+const logger_1 = require("./logger");
+const DEFAULT_VERIFY_PATTERNS = [
+    "*.ts", "*.tsx",
+    "*.js", "*.jsx", "*.mjs", "*.cjs",
+    "*.vue", "*.svelte",
+    "*.html", "*.htm",
+    "*.css", "*.scss", "*.sass", "*.less", "*.styl",
+    "*.py",
+    "*.rb", "*.erb",
+    "*.go",
+    "*.rs",
+    "*.java", "*.kt", "*.kts",
+    "*.swift",
+    "*.c", "*.cpp", "*.h", "*.hpp",
+    "*.cs",
+    "*.php",
+    "*.dart",
+    "*.ex", "*.exs",
+    "*.erl",
+    "*.lua",
+    "*.r", "*.R",
+    "*.scala",
+    "*.clj", "*.cljs",
+    "*.zig",
+    "*.nim",
+    "*.hbs", "*.ejs", "*.pug", "*.jade",
+    "*.astro",
+];
+const DEFAULT_MAX_RETRIES = 3;
+function loadJsonFile(filePath) {
+    if (!(0, fs_1.existsSync)(filePath)) {
+        return {};
+    }
+    try {
+        return JSON.parse((0, fs_1.readFileSync)(filePath, "utf-8"));
+    }
+    catch (e) {
+        logger_1.logger.debug(`failed to parse config ${filePath}: ${e}`);
+        return {};
+    }
+}
+function loadConfig(projectDir) {
+    const globalPath = (0, path_1.join)((0, os_1.homedir)(), ".ironbee", "config.json");
+    const globalConfig = loadJsonFile(globalPath);
+    let projectConfig = {};
+    if (projectDir) {
+        const projectPath = (0, path_1.join)(projectDir, ".ironbee", "config.json");
+        projectConfig = loadJsonFile(projectPath);
+    }
+    // merge: defaults < global < project
+    const merged = {
+        ...globalConfig,
+        ...projectConfig,
+    };
+    return merged;
+}
+/**
+ * Converts a glob pattern to a RegExp.
+ * Supports: *, **, ?
+ * Examples:
+ *   "*.ts"                → matches "foo.ts"
+ *   "src/components/**"   → matches "src/components/Button/index.tsx"
+ *   "*.test.*"            → matches "foo.test.ts"
+ */
+function globToRegExp(pattern) {
+    let regexStr = pattern
+        .replace(/[.+^${}()|[\]\\]/g, "\\$&") // escape regex special chars (except * and ?)
+        .replace(/\*\*/g, "{{GLOBSTAR}}") // placeholder for **
+        .replace(/\*/g, "[^/]*") // * = anything except /
+        .replace(/\?/g, "[^/]") // ? = single char except /
+        .replace(/\{\{GLOBSTAR\}\}/g, ".*"); // ** = anything including /
+    // if pattern has no path separators, match against basename only
+    if (!pattern.includes("/")) {
+        regexStr = `(^|/)${regexStr}$`;
+    }
+    else {
+        regexStr = `(^|/)${regexStr}$`;
+    }
+    return new RegExp(regexStr);
+}
+/**
+ * Tests if a file path matches any of the given glob patterns.
+ */
+function matchesAny(filePath, patterns) {
+    for (const pattern of patterns) {
+        const regex = globToRegExp(pattern);
+        if (regex.test(filePath)) {
+            return true;
+        }
+    }
+    return false;
+}
+/**
+ * Determines whether a file requires browser verification.
+ *
+ * Check order:
+ *   1. ignoredVerifyPatterns → if matched, skip (return false)
+ *   2. verifyPatterns (+ additionalVerifyPatterns) → if matched, verify (return true)
+ *   3. No match → skip (return false)
+ */
+function requiresVerification(filePath, config) {
+    // 1. check ignored patterns first
+    const ignored = config.ignoredVerifyPatterns ?? [];
+    if (ignored.length > 0 && matchesAny(filePath, ignored)) {
+        return false;
+    }
+    // 2. build verify patterns: base + additional
+    const base = config.verifyPatterns ?? DEFAULT_VERIFY_PATTERNS;
+    const additional = config.additionalVerifyPatterns ?? [];
+    const patterns = [...base, ...additional];
+    return matchesAny(filePath, patterns);
+}
+function getMaxRetries(config) {
+    return (typeof config.maxRetries === "number" && config.maxRetries > 0)
+        ? config.maxRetries
+        : DEFAULT_MAX_RETRIES;
+}
+//# sourceMappingURL=config.js.map

package/dist/lib/config.js.map

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

package/dist/lib/icon.d.ts

@@ -0,0 +1,2 @@
+export declare function printBanner(): void;
+//# sourceMappingURL=icon.d.ts.map

package/dist/lib/icon.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"icon.d.ts","sourceRoot":"","sources":["../../src/lib/icon.ts"],"names":[],"mappings":"AAGA,wBAAgB,WAAW,IAAI,IAAI,CAQlC"}

package/dist/lib/icon.js

@@ -0,0 +1,14 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.printBanner = printBanner;
+const path_1 = require("path");
+const fs_1 = require("fs");
+function printBanner() {
+    const txtPath = (0, path_1.join)(__dirname, "../../assets/banner.txt");
+    if (!(0, fs_1.existsSync)(txtPath)) {
+        return;
+    }
+    process.stdout.write((0, fs_1.readFileSync)(txtPath, "utf-8"));
+    process.stdout.write("\n");
+}
+//# sourceMappingURL=icon.js.map

package/dist/lib/icon.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"icon.js","sourceRoot":"","sources":["../../src/lib/icon.ts"],"names":[],"mappings":";;AAGA,kCAQC;AAXD,+BAA4B;AAC5B,2BAA8C;AAE9C,SAAgB,WAAW;IACvB,MAAM,OAAO,GAAW,IAAA,WAAI,EAAC,SAAS,EAAE,yBAAyB,CAAC,CAAC;IACnE,IAAI,CAAC,IAAA,eAAU,EAAC,OAAO,CAAC,EAAE,CAAC;QACvB,OAAO;IACX,CAAC;IAED,OAAO,CAAC,MAAM,CAAC,KAAK,CAAC,IAAA,iBAAY,EAAC,OAAO,EAAE,OAAO,CAAC,CAAC,CAAC;IACrD,OAAO,CAAC,MAAM,CAAC,KAAK,CAAC,IAAI,CAAC,CAAC;AAC/B,CAAC"}

package/dist/lib/logger.d.ts

@@ -0,0 +1,7 @@
+type LogLevel = "debug" | "info" | "warn" | "error";
+export declare function setLogLevel(level: LogLevel): void;
+export declare function getLogLevel(): LogLevel;
+export declare function setLogFile(filePath: string): void;
+export declare const logger: Record<LogLevel, (msg: string) => void>;
+export {};
+//# sourceMappingURL=logger.d.ts.map

package/dist/lib/logger.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"logger.d.ts","sourceRoot":"","sources":["../../src/lib/logger.ts"],"names":[],"mappings":"AAGA,KAAK,QAAQ,GAAG,OAAO,GAAG,MAAM,GAAG,MAAM,GAAG,OAAO,CAAC;AAoBpD,wBAAgB,WAAW,CAAC,KAAK,EAAE,QAAQ,GAAG,IAAI,CAEjD;AAED,wBAAgB,WAAW,IAAI,QAAQ,CAEtC;AAED,wBAAgB,UAAU,CAAC,QAAQ,EAAE,MAAM,GAAG,IAAI,CAGjD;AAmCD,eAAO,MAAM,MAAM,EAAE,MAAM,CAAC,QAAQ,EAAE,CAAC,GAAG,EAAE,MAAM,KAAK,IAAI,CAK1D,CAAC"}

package/dist/lib/logger.js

@@ -0,0 +1,70 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.logger = void 0;
+exports.setLogLevel = setLogLevel;
+exports.getLogLevel = getLogLevel;
+exports.setLogFile = setLogFile;
+const fs_1 = require("fs");
+const path_1 = require("path");
+const LOG_LEVELS = {
+    debug: 0,
+    info: 1,
+    warn: 2,
+    error: 3,
+};
+function resolveLevel() {
+    const env = process.env.IRONBEE_LOG_LEVEL?.toLowerCase();
+    if (env && env in LOG_LEVELS) {
+        return env;
+    }
+    return "info";
+}
+let currentLevel = resolveLevel();
+let logFilePath = null;
+function setLogLevel(level) {
+    currentLevel = level;
+}
+function getLogLevel() {
+    return currentLevel;
+}
+function setLogFile(filePath) {
+    logFilePath = filePath;
+    (0, fs_1.mkdirSync)((0, path_1.dirname)(filePath), { recursive: true });
+}
+function writeToFile(level, msg) {
+    if (!logFilePath) {
+        return;
+    }
+    try {
+        const timestamp = new Date().toISOString();
+        (0, fs_1.appendFileSync)(logFilePath, `${timestamp} [${level.toUpperCase()}] ${msg}\n`);
+    }
+    catch {
+        // avoid infinite recursion — silently ignore file write errors
+    }
+}
+function log(level, msg) {
+    writeToFile(level, msg);
+    if (LOG_LEVELS[level] < LOG_LEVELS[currentLevel]) {
+        return;
+    }
+    const prefix = {
+        debug: "[DEBUG]",
+        info: "[INFO]",
+        warn: "[WARN]",
+        error: "[ERROR]",
+    };
+    if (level === "error" || level === "warn") {
+        process.stderr.write(`${prefix[level]} ${msg}\n`);
+    }
+    else {
+        process.stdout.write(`${prefix[level]} ${msg}\n`);
+    }
+}
+exports.logger = {
+    debug: (msg) => log("debug", msg),
+    info: (msg) => log("info", msg),
+    warn: (msg) => log("warn", msg),
+    error: (msg) => log("error", msg),
+};
+//# sourceMappingURL=logger.js.map

package/dist/lib/logger.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"logger.js","sourceRoot":"","sources":["../../src/lib/logger.ts"],"names":[],"mappings":";;;AAuBA,kCAEC;AAED,kCAEC;AAED,gCAGC;AAlCD,2BAA+C;AAC/C,+BAA+B;AAI/B,MAAM,UAAU,GAA6B;IACzC,KAAK,EAAE,CAAC;IACR,IAAI,EAAE,CAAC;IACP,IAAI,EAAE,CAAC;IACP,KAAK,EAAE,CAAC;CACX,CAAC;AAEF,SAAS,YAAY;IACjB,MAAM,GAAG,GAAuB,OAAO,CAAC,GAAG,CAAC,iBAAiB,EAAE,WAAW,EAAE,CAAC;IAC7E,IAAI,GAAG,IAAI,GAAG,IAAI,UAAU,EAAE,CAAC;QAC3B,OAAO,GAAe,CAAC;IAC3B,CAAC;IACD,OAAO,MAAM,CAAC;AAClB,CAAC;AAED,IAAI,YAAY,GAAa,YAAY,EAAE,CAAC;AAC5C,IAAI,WAAW,GAAkB,IAAI,CAAC;AAEtC,SAAgB,WAAW,CAAC,KAAe;IACvC,YAAY,GAAG,KAAK,CAAC;AACzB,CAAC;AAED,SAAgB,WAAW;IACvB,OAAO,YAAY,CAAC;AACxB,CAAC;AAED,SAAgB,UAAU,CAAC,QAAgB;IACvC,WAAW,GAAG,QAAQ,CAAC;IACvB,IAAA,cAAS,EAAC,IAAA,cAAO,EAAC,QAAQ,CAAC,EAAE,EAAE,SAAS,EAAE,IAAI,EAAE,CAAC,CAAC;AACtD,CAAC;AAED,SAAS,WAAW,CAAC,KAAe,EAAE,GAAW;IAC7C,IAAI,CAAC,WAAW,EAAE,CAAC;QACf,OAAO;IACX,CAAC;IACD,IAAI,CAAC;QACD,MAAM,SAAS,GAAW,IAAI,IAAI,EAAE,CAAC,WAAW,EAAE,CAAC;QACnD,IAAA,mBAAc,EAAC,WAAW,EAAE,GAAG,SAAS,KAAK,KAAK,CAAC,WAAW,EAAE,KAAK,GAAG,IAAI,CAAC,CAAC;IAClF,CAAC;IAAC,MAAM,CAAC;QACL,+DAA+D;IACnE,CAAC;AACL,CAAC;AAED,SAAS,GAAG,CAAC,KAAe,EAAE,GAAW;IACrC,WAAW,CAAC,KAAK,EAAE,GAAG,CAAC,CAAC;IAExB,IAAI,UAAU,CAAC,KAAK,CAAC,GAAG,UAAU,CAAC,YAAY,CAAC,EAAE,CAAC;QAC/C,OAAO;IACX,CAAC;IAED,MAAM,MAAM,GAA6B;QACrC,KAAK,EAAE,SAAS;QAChB,IAAI,EAAE,QAAQ;QACd,IAAI,EAAE,QAAQ;QACd,KAAK,EAAE,SAAS;KACnB,CAAC;IAEF,IAAI,KAAK,KAAK,OAAO,IAAI,KAAK,KAAK,MAAM,EAAE,CAAC;QACxC,OAAO,CAAC,MAAM,CAAC,KAAK,CAAC,GAAG,MAAM,CAAC,KAAK,CAAC,IAAI,GAAG,IAAI,CAAC,CAAC;IACtD,CAAC;SAAM,CAAC;QACJ,OAAO,CAAC,MAAM,CAAC,KAAK,CAAC,GAAG,MAAM,CAAC,KAAK,CAAC,IAAI,GAAG,IAAI,CAAC,CAAC;IACtD,CAAC;AACL,CAAC;AAEY,QAAA,MAAM,GAA4C;IAC3D,KAAK,EAAE,CAAC,GAAW,EAAQ,EAAE,CAAC,GAAG,CAAC,OAAO,EAAE,GAAG,CAAC;IAC/C,IAAI,EAAE,CAAC,GAAW,EAAQ,EAAE,CAAC,GAAG,CAAC,MAAM,EAAE,GAAG,CAAC;IAC7C,IAAI,EAAE,CAAC,GAAW,EAAQ,EAAE,CAAC,GAAG,CAAC,MAAM,EAAE,GAAG,CAAC;IAC7C,KAAK,EAAE,CAAC,GAAW,EAAQ,EAAE,CAAC,GAAG,CAAC,OAAO,EAAE,GAAG,CAAC;CAClD,CAAC"}

package/dist/lib/output.d.ts

@@ -0,0 +1,21 @@
+/**
+ * IronBee — Colored Output Helpers
+ *
+ * Provides colored console output for user-facing commands.
+ * Uses picocolors for zero-overhead ANSI coloring.
+ */
+import pc from "picocolors";
+interface Log {
+    info(msg: string): void;
+    success(msg: string): void;
+    warn(msg: string): void;
+    error(msg: string): void;
+    step(msg: string): void;
+    label(label: string, value: string): void;
+    dim(msg: string): void;
+    blank(): void;
+}
+export declare const log: Log;
+export declare function orange(text: string): string;
+export { pc };
+//# sourceMappingURL=output.d.ts.map

package/dist/lib/output.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"output.d.ts","sourceRoot":"","sources":["../../src/lib/output.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH,OAAO,EAAE,MAAM,YAAY,CAAC;AAE5B,UAAU,GAAG;IACT,IAAI,CAAC,GAAG,EAAE,MAAM,GAAG,IAAI,CAAC;IACxB,OAAO,CAAC,GAAG,EAAE,MAAM,GAAG,IAAI,CAAC;IAC3B,IAAI,CAAC,GAAG,EAAE,MAAM,GAAG,IAAI,CAAC;IACxB,KAAK,CAAC,GAAG,EAAE,MAAM,GAAG,IAAI,CAAC;IACzB,IAAI,CAAC,GAAG,EAAE,MAAM,GAAG,IAAI,CAAC;IACxB,KAAK,CAAC,KAAK,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM,GAAG,IAAI,CAAC;IAC1C,GAAG,CAAC,GAAG,EAAE,MAAM,GAAG,IAAI,CAAC;IACvB,KAAK,IAAI,IAAI,CAAC;CACjB;AAED,eAAO,MAAM,GAAG,EAAE,GAyBjB,CAAC;AAEF,wBAAgB,MAAM,CAAC,IAAI,EAAE,MAAM,GAAG,MAAM,CAE3C;AAED,OAAO,EAAE,EAAE,EAAE,CAAC"}