@gurulu/cli 0.4.6 → 1.0.0

package/dist/install-intent-proposal.js

@@ -1,202 +0,0 @@
-"use strict";
-/**
- * Phase 18.6 — CLI install-time intent proposal rendering + interaction.
- *
- * Pure UI logic (plus a small interactive loop) that turns an `InstallIntent`
- * payload into a human-readable proposal and lets the user toggle individual
- * events/funnels before sending the accepted subset to the backend. This file
- * has NO hard limit on event/funnel count — a full iGaming intent with 20
- * events is rendered in full.
- *
- * Testability: the render function returns a plain string so snapshot-style
- * tests can assert structure. The interactive runner accepts injected I/O so
- * tests can drive it without real stdin/stdout.
- */
-Object.defineProperty(exports, "__esModule", { value: true });
-exports.initProposalState = initProposalState;
-exports.renderProposal = renderProposal;
-exports.applyCommand = applyCommand;
-exports.splitDecision = splitDecision;
-exports.runProposal = runProposal;
-function initProposalState(intent) {
-    return {
-        intent,
-        eventSelected: intent.events.map(() => true),
-        funnelSelected: intent.funnels.map(() => true),
-    };
-}
-function formatSource(src) {
-    if (src.route)
-        return src.route;
-    if (src.mutation)
-        return `mutation: ${src.mutation}`;
-    if (src.inferred)
-        return `inferred: ${src.inferredFrom || 'pattern'}`;
-    return 'unspecified';
-}
-function pad(str, width) {
-    if (str.length >= width)
-        return str;
-    return str + ' '.repeat(width - str.length);
-}
-/**
- * Render the proposal to a plain string (TTY colour escapes applied by the
- * caller if `colorize` is true). No truncation — every event/funnel is shown.
- */
-function renderProposal(state, opts = {}) {
-    const { intent } = state;
-    const lines = [];
-    const analyzerBanner = intent.analyzerMode === 'llm'
-        ? ''
-        : '  [basic analysis — LLM unavailable or disabled]';
-    lines.push('');
-    lines.push(`  Detected: ${intent.vertical} (${intent.confidence} confidence)`);
-    if (analyzerBanner)
-        lines.push(analyzerBanner);
-    if (intent.reasoning) {
-        lines.push('');
-        lines.push('  Reasoning:');
-        for (const w of wrap(intent.reasoning, 72))
-            lines.push(`    ${w}`);
-    }
-    if (intent.alternativeVerticals.length > 0) {
-        lines.push('');
-        lines.push('  Alternative interpretations:');
-        for (const a of intent.alternativeVerticals) {
-            lines.push(`    - ${a.name} (${a.confidence})${a.note ? ` - ${a.note}` : ''}`);
-        }
-    }
-    lines.push('');
-    lines.push(`  Proposed events (${intent.events.length}):`);
-    const nameWidth = Math.max(12, ...intent.events.map((e) => e.name.length));
-    const catWidth = Math.max(8, ...intent.events.map((e) => e.category.length));
-    intent.events.forEach((ev, i) => {
-        const mark = state.eventSelected[i] ? '[x]' : '[ ]';
-        lines.push(`    ${pad(String(i + 1), 3)}${mark} ${pad(ev.name, nameWidth + 2)}${pad(ev.category, catWidth + 2)}${formatSource(ev.source)}`);
-        if (ev.reasoning) {
-            for (const w of wrap(ev.reasoning, 68))
-                lines.push(`         ${w}`);
-        }
-    });
-    lines.push('');
-    lines.push(`  Proposed funnels (${intent.funnels.length}):`);
-    intent.funnels.forEach((fn, i) => {
-        const mark = state.funnelSelected[i] ? '[x]' : '[ ]';
-        lines.push(`    F${pad(String(i + 1), 2)}${mark} ${fn.name} (${fn.category})`);
-        lines.push(`          ${fn.steps.join(' -> ')}`);
-        if (fn.reasoning) {
-            for (const w of wrap(fn.reasoning, 68))
-                lines.push(`          ${w}`);
-        }
-    });
-    lines.push('');
-    lines.push('  [x] = include, [ ] = skip.');
-    lines.push('  Type number to toggle event, F<n> to toggle funnel, A to toggle all, Enter to continue, Q to quit.');
-    lines.push('');
-    if (opts.colorize) {
-        // cheap colorization: highlight the "Detected:" line
-        return lines
-            .map((l) => l.includes('Detected:')
-            ? `\x1b[1m${l}\x1b[0m`
-            : l.includes('[x]')
-                ? l
-                : l)
-            .join('\n');
-    }
-    return lines.join('\n');
-}
-function wrap(str, width) {
-    const words = str.split(/\s+/).filter(Boolean);
-    const out = [];
-    let line = '';
-    for (const w of words) {
-        if ((line + ' ' + w).trim().length > width) {
-            if (line)
-                out.push(line);
-            line = w;
-        }
-        else {
-            line = line ? `${line} ${w}` : w;
-        }
-    }
-    if (line)
-        out.push(line);
-    return out;
-}
-/**
- * Apply a single user command to the proposal state. Exported so tests can
- * exercise the state machine directly without any I/O.
- */
-function applyCommand(state, raw) {
-    const cmd = (raw || '').trim();
-    if (cmd === '')
-        return { state, done: true, quit: false };
-    const upper = cmd.toUpperCase();
-    if (upper === 'Q')
-        return { state, done: true, quit: true };
-    if (upper === 'A') {
-        // If any event is unchecked, select all; else uncheck all.
-        const anyOff = state.eventSelected.some((v) => !v);
-        const next = state.eventSelected.map(() => anyOff);
-        return {
-            state: { ...state, eventSelected: next },
-            done: false,
-            quit: false,
-        };
-    }
-    const funnelMatch = upper.match(/^F(\d+)$/);
-    if (funnelMatch) {
-        const idx = parseInt(funnelMatch[1], 10) - 1;
-        if (idx >= 0 && idx < state.funnelSelected.length) {
-            const next = [...state.funnelSelected];
-            next[idx] = !next[idx];
-            return { state: { ...state, funnelSelected: next }, done: false, quit: false };
-        }
-        return { state, done: false, quit: false };
-    }
-    const eventMatch = cmd.match(/^(\d+)$/);
-    if (eventMatch) {
-        const idx = parseInt(eventMatch[1], 10) - 1;
-        if (idx >= 0 && idx < state.eventSelected.length) {
-            const next = [...state.eventSelected];
-            next[idx] = !next[idx];
-            return { state: { ...state, eventSelected: next }, done: false, quit: false };
-        }
-    }
-    return { state, done: false, quit: false };
-}
-function splitDecision(state) {
-    const accepted = {
-        events: state.intent.events.filter((_, i) => state.eventSelected[i]),
-        funnels: state.intent.funnels.filter((_, i) => state.funnelSelected[i]),
-    };
-    const rejected = {
-        events: state.intent.events.filter((_, i) => !state.eventSelected[i]),
-        funnels: state.intent.funnels.filter((_, i) => !state.funnelSelected[i]),
-    };
-    return { accepted, rejected, quit: false };
-}
-/**
- * Drive the interactive proposal loop. Returns the accepted + rejected split
- * plus a `quit` flag the caller uses to decide whether to continue the install.
- */
-async function runProposal(opts) {
-    let state = initProposalState(opts.intent);
-    if (opts.nonInteractive) {
-        opts.io.print(renderProposal(state));
-        opts.io.print('  Non-interactive mode: accepting all proposed events and funnels.');
-        return splitDecision(state);
-    }
-    while (true) {
-        opts.io.print(renderProposal(state));
-        const answer = await opts.io.prompt('  > ');
-        const res = applyCommand(state, answer);
-        state = res.state;
-        if (res.done) {
-            if (res.quit) {
-                return { ...splitDecision(state), quit: true };
-            }
-            return splitDecision(state);
-        }
-    }
-}

package/dist/utils/api.d.ts

@@ -1,20 +0,0 @@
-export declare class GuruluAPI {
-    private apiKey;
-    private baseUrl;
-    constructor(apiKey?: string, baseUrl?: string);
-    listSites(): Promise<Array<{
-        id: string;
-        domain: string;
-        name: string;
-    }>>;
-    getSiteCredentials(siteId: string): Promise<{
-        siteId: string;
-        token: string;
-    }>;
-    listEvents(siteId: string): Promise<unknown[]>;
-    checkHealth(siteId: string): Promise<{
-        connected: boolean;
-        lastEvent?: string;
-        eventsToday?: number;
-    }>;
-}

package/dist/utils/api.js

@@ -1,47 +0,0 @@
-"use strict";
-Object.defineProperty(exports, "__esModule", { value: true });
-exports.GuruluAPI = void 0;
-const config_1 = require("./config");
-class GuruluAPI {
-    apiKey;
-    baseUrl;
-    constructor(apiKey, baseUrl) {
-        this.apiKey = apiKey || (0, config_1.loadConfig)().apiKey || '';
-        this.baseUrl = baseUrl || 'https://app.gurulu.io';
-    }
-    async listSites() {
-        const res = await fetch(`${this.baseUrl}/api/v1/sites`, {
-            headers: { 'Authorization': `Bearer ${this.apiKey}` },
-        });
-        if (!res.ok)
-            throw new Error(`API error: ${res.status}`);
-        const data = await res.json();
-        return data.sites;
-    }
-    async getSiteCredentials(siteId) {
-        const res = await fetch(`${this.baseUrl}/api/v1/sites/${siteId}/credentials`, {
-            headers: { 'Authorization': `Bearer ${this.apiKey}` },
-        });
-        if (!res.ok)
-            throw new Error(`API error: ${res.status}`);
-        return await res.json();
-    }
-    async listEvents(siteId) {
-        const res = await fetch(`${this.baseUrl}/api/events/catalog?siteId=${siteId}`, {
-            headers: { 'Authorization': `Bearer ${this.apiKey}` },
-        });
-        if (!res.ok)
-            throw new Error(`API error: ${res.status}`);
-        const data = await res.json();
-        return data.events;
-    }
-    async checkHealth(siteId) {
-        const res = await fetch(`${this.baseUrl}/api/v1/sites/${siteId}/health`, {
-            headers: { 'Authorization': `Bearer ${this.apiKey}` },
-        });
-        if (!res.ok)
-            throw new Error(`API error: ${res.status}`);
-        return await res.json();
-    }
-}
-exports.GuruluAPI = GuruluAPI;

package/dist/utils/config.d.ts

@@ -1,13 +0,0 @@
-export interface GuruluConfig {
-    email?: string;
-    apiKey?: string;
-    defaultSiteId?: string;
-    sites?: Array<{
-        id: string;
-        domain: string;
-        name: string;
-    }>;
-}
-export declare function loadConfig(): GuruluConfig;
-export declare function saveConfig(config: GuruluConfig): void;
-export declare function clearConfig(): void;

package/dist/utils/config.js

@@ -1,30 +0,0 @@
-"use strict";
-var __importDefault = (this && this.__importDefault) || function (mod) {
-    return (mod && mod.__esModule) ? mod : { "default": mod };
-};
-Object.defineProperty(exports, "__esModule", { value: true });
-exports.loadConfig = loadConfig;
-exports.saveConfig = saveConfig;
-exports.clearConfig = clearConfig;
-const fs_1 = __importDefault(require("fs"));
-const path_1 = __importDefault(require("path"));
-const os_1 = __importDefault(require("os"));
-const CONFIG_DIR = path_1.default.join(os_1.default.homedir(), '.gurulu');
-const CONFIG_FILE = path_1.default.join(CONFIG_DIR, 'config.json');
-function loadConfig() {
-    try {
-        if (fs_1.default.existsSync(CONFIG_FILE)) {
-            return JSON.parse(fs_1.default.readFileSync(CONFIG_FILE, 'utf-8'));
-        }
-    }
-    catch { }
-    return {};
-}
-function saveConfig(config) {
-    fs_1.default.mkdirSync(CONFIG_DIR, { recursive: true });
-    fs_1.default.writeFileSync(CONFIG_FILE, JSON.stringify(config, null, 2));
-}
-function clearConfig() {
-    if (fs_1.default.existsSync(CONFIG_FILE))
-        fs_1.default.unlinkSync(CONFIG_FILE);
-}

package/dist/utils/confirm.d.ts

@@ -1,17 +0,0 @@
-/**
- * Phase 20 W2 B6 — interactive confirm prompt shared by every write command.
- *
- * Bypass rules, in order:
- *   1. `opts.yes === true` (set by `--yes` flag)
- *   2. `GURULU_NO_CONFIRM=1` environment variable
- *   3. stdin is not a TTY (scripted / CI usage)
- *
- * Returns `true` if the user confirmed (or any bypass fired), `false`
- * otherwise. The default is `false` on empty input — mirroring every
- * well-behaved `[y/N]` prompt.
- */
-export interface ConfirmOptions {
-    yes?: boolean;
-    defaultYes?: boolean;
-}
-export declare function promptConfirm(message: string, opts?: ConfirmOptions): Promise<boolean>;

package/dist/utils/confirm.js

@@ -1,40 +0,0 @@
-"use strict";
-/**
- * Phase 20 W2 B6 — interactive confirm prompt shared by every write command.
- *
- * Bypass rules, in order:
- *   1. `opts.yes === true` (set by `--yes` flag)
- *   2. `GURULU_NO_CONFIRM=1` environment variable
- *   3. stdin is not a TTY (scripted / CI usage)
- *
- * Returns `true` if the user confirmed (or any bypass fired), `false`
- * otherwise. The default is `false` on empty input — mirroring every
- * well-behaved `[y/N]` prompt.
- */
-Object.defineProperty(exports, "__esModule", { value: true });
-exports.promptConfirm = promptConfirm;
-const ui_1 = require("./ui");
-async function promptConfirm(message, opts = {}) {
-    if (opts.yes === true)
-        return true;
-    if (process.env.GURULU_NO_CONFIRM === '1')
-        return true;
-    if (!process.stdin.isTTY)
-        return true;
-    const suffix = opts.defaultYes ? '[Y/n]' : '[y/N]';
-    process.stdout.write(`${(0, ui_1.yellow)('?')} ${message} ${suffix} `);
-    return new Promise((resolve) => {
-        const readline = require('readline');
-        const rl = readline.createInterface({
-            input: process.stdin,
-            output: process.stdout,
-        });
-        rl.question('', (answer) => {
-            rl.close();
-            const a = (answer || '').trim().toLowerCase();
-            if (a === '')
-                return resolve(!!opts.defaultYes);
-            resolve(a === 'y' || a === 'yes');
-        });
-    });
-}

package/dist/utils/dry-run.d.ts

@@ -1,20 +0,0 @@
-/**
- * Phase 20 W2 B6 — dry-run output helper.
- *
- * The server-side of each write route returns a uniform shape when
- * `?dryRun=1` is set:
- *
- *   { dryRun: true, action, resource, before?, after }
- *
- * `printDryRun` renders that as a coloured, line-oriented diff so the
- * CLI user can sanity-check before re-running without `--dry-run`. JSON
- * mode is a straight passthrough for scripts.
- */
-export interface DryRunPayload {
-    dryRun?: boolean;
-    action?: string;
-    resource?: string;
-    before?: unknown;
-    after?: unknown;
-}
-export declare function printDryRun(payload: DryRunPayload, json?: boolean): void;

package/dist/utils/dry-run.js

@@ -1,67 +0,0 @@
-"use strict";
-/**
- * Phase 20 W2 B6 — dry-run output helper.
- *
- * The server-side of each write route returns a uniform shape when
- * `?dryRun=1` is set:
- *
- *   { dryRun: true, action, resource, before?, after }
- *
- * `printDryRun` renders that as a coloured, line-oriented diff so the
- * CLI user can sanity-check before re-running without `--dry-run`. JSON
- * mode is a straight passthrough for scripts.
- */
-Object.defineProperty(exports, "__esModule", { value: true });
-exports.printDryRun = printDryRun;
-const ui_1 = require("./ui");
-function printDryRun(payload, json) {
-    if (json) {
-        process.stdout.write(JSON.stringify(payload, null, 2) + '\n');
-        return;
-    }
-    const { action = '?', resource = '?', before, after } = payload;
-    process.stdout.write(`${(0, ui_1.cyan)('dry-run')} ${(0, ui_1.yellow)(action)} ${resource}\n` + (0, ui_1.dim)('─'.repeat(40)) + '\n');
-    const beforeKeys = isObj(before) ? Object.keys(before) : [];
-    const afterKeys = isObj(after) ? Object.keys(after) : [];
-    const all = Array.from(new Set([...beforeKeys, ...afterKeys])).sort();
-    if (all.length === 0) {
-        if (after !== undefined && after !== null) {
-            process.stdout.write((0, ui_1.green)(`+ ${stringify(after)}\n`));
-        }
-        if (before !== undefined && before !== null && after === null) {
-            process.stdout.write((0, ui_1.red)(`- ${stringify(before)}\n`));
-        }
-        return;
-    }
-    for (const k of all) {
-        const b = isObj(before) ? before[k] : undefined;
-        const a = isObj(after) ? after[k] : undefined;
-        if (stringify(a) === stringify(b)) {
-            process.stdout.write((0, ui_1.dim)(`  ${k}: ${stringify(a)}\n`));
-            continue;
-        }
-        if (b !== undefined) {
-            process.stdout.write((0, ui_1.red)(`- ${k}: ${stringify(b)}\n`));
-        }
-        if (a !== undefined) {
-            process.stdout.write((0, ui_1.green)(`+ ${k}: ${stringify(a)}\n`));
-        }
-    }
-}
-function isObj(v) {
-    return v !== null && typeof v === 'object' && !Array.isArray(v);
-}
-function stringify(v) {
-    if (v === undefined)
-        return 'undefined';
-    if (v === null)
-        return 'null';
-    if (typeof v === 'string')
-        return v;
-    try {
-        return JSON.stringify(v);
-    }
-    catch {
-        return String(v);
-    }
-}

package/dist/utils/from-file.d.ts

@@ -1,9 +0,0 @@
-/**
- * Phase 20 W2 B6 — `--from-file <path>` loader.
- *
- * JSON is handled natively. YAML support is optional: if `js-yaml` is
- * installed in the user's environment we delegate to it, otherwise we
- * throw a clear error asking them to either convert to JSON or install
- * the optional peer.
- */
-export declare function loadFromFile<T = unknown>(filePath: string): T;

package/dist/utils/from-file.js

@@ -1,72 +0,0 @@
-"use strict";
-/**
- * Phase 20 W2 B6 — `--from-file <path>` loader.
- *
- * JSON is handled natively. YAML support is optional: if `js-yaml` is
- * installed in the user's environment we delegate to it, otherwise we
- * throw a clear error asking them to either convert to JSON or install
- * the optional peer.
- */
-var __createBinding = (this && this.__createBinding) || (Object.create ? (function(o, m, k, k2) {
-    if (k2 === undefined) k2 = k;
-    var desc = Object.getOwnPropertyDescriptor(m, k);
-    if (!desc || ("get" in desc ? !m.__esModule : desc.writable || desc.configurable)) {
-      desc = { enumerable: true, get: function() { return m[k]; } };
-    }
-    Object.defineProperty(o, k2, desc);
-}) : (function(o, m, k, k2) {
-    if (k2 === undefined) k2 = k;
-    o[k2] = m[k];
-}));
-var __setModuleDefault = (this && this.__setModuleDefault) || (Object.create ? (function(o, v) {
-    Object.defineProperty(o, "default", { enumerable: true, value: v });
-}) : function(o, v) {
-    o["default"] = v;
-});
-var __importStar = (this && this.__importStar) || (function () {
-    var ownKeys = function(o) {
-        ownKeys = Object.getOwnPropertyNames || function (o) {
-            var ar = [];
-            for (var k in o) if (Object.prototype.hasOwnProperty.call(o, k)) ar[ar.length] = k;
-            return ar;
-        };
-        return ownKeys(o);
-    };
-    return function (mod) {
-        if (mod && mod.__esModule) return mod;
-        var result = {};
-        if (mod != null) for (var k = ownKeys(mod), i = 0; i < k.length; i++) if (k[i] !== "default") __createBinding(result, mod, k[i]);
-        __setModuleDefault(result, mod);
-        return result;
-    };
-})();
-Object.defineProperty(exports, "__esModule", { value: true });
-exports.loadFromFile = loadFromFile;
-const fs = __importStar(require("fs"));
-const path = __importStar(require("path"));
-function loadFromFile(filePath) {
-    const resolved = path.resolve(filePath);
-    if (!fs.existsSync(resolved)) {
-        throw new Error(`File not found: ${resolved}`);
-    }
-    const raw = fs.readFileSync(resolved, 'utf8');
-    const ext = path.extname(resolved).toLowerCase();
-    if (ext === '.json') {
-        return JSON.parse(raw);
-    }
-    if (ext === '.yaml' || ext === '.yml') {
-        try {
-            // Optional peer dep — loaded lazily so JSON users don't need it.
-            // eslint-disable-next-line @typescript-eslint/no-var-requires
-            const yaml = require('js-yaml');
-            return yaml.load(raw);
-        }
-        catch (err) {
-            throw new Error(`YAML support requires the optional \`js-yaml\` package. ` +
-                `Install it with \`npm i -g js-yaml\` or convert the file to JSON. ` +
-                `(${err.message})`);
-        }
-    }
-    // Default to JSON if extension is unknown.
-    return JSON.parse(raw);
-}

package/dist/utils/redact.d.ts

@@ -1,14 +0,0 @@
-/**
- * CLI@0.4.4 — sensitive-arg redaction helper.
- *
- * Used before any debug/log/telemetry path that might serialize CLI args.
- * Mask any key whose name contains password / token / secret / api-key / authorization
- * (case-insensitive). Returns a shallow clone with offending values replaced
- * by `***REDACTED***` (or `undefined` when the original was falsy, so the log
- * does not imply a value was present).
- */
-export declare function redactSensitiveArgs<T extends Record<string, unknown>>(args: T): T;
-/**
- * Convenience: produce a JSON string with sensitive fields redacted.
- */
-export declare function safeStringifyArgs(args: Record<string, unknown>): string;

package/dist/utils/redact.js

@@ -1,48 +0,0 @@
-"use strict";
-/**
- * CLI@0.4.4 — sensitive-arg redaction helper.
- *
- * Used before any debug/log/telemetry path that might serialize CLI args.
- * Mask any key whose name contains password / token / secret / api-key / authorization
- * (case-insensitive). Returns a shallow clone with offending values replaced
- * by `***REDACTED***` (or `undefined` when the original was falsy, so the log
- * does not imply a value was present).
- */
-Object.defineProperty(exports, "__esModule", { value: true });
-exports.redactSensitiveArgs = redactSensitiveArgs;
-exports.safeStringifyArgs = safeStringifyArgs;
-const SENSITIVE_KEY_RX = /(password|passwd|pwd|token|secret|api[_-]?key|authorization|auth[_-]?token|access[_-]?key|private[_-]?key|client[_-]?secret|session[_-]?token)/i;
-function redactSensitiveArgs(args) {
-    if (!args || typeof args !== 'object')
-        return args;
-    const out = Array.isArray(args)
-        ? [...args]
-        : { ...args };
-    for (const k of Object.keys(out)) {
-        const v = out[k];
-        if (SENSITIVE_KEY_RX.test(k)) {
-            out[k] = v ? '***REDACTED***' : undefined;
-            continue;
-        }
-        // Recurse into nested objects (but not class instances / Buffers / Dates).
-        if (v &&
-            typeof v === 'object' &&
-            !Buffer.isBuffer(v) &&
-            !(v instanceof Date) &&
-            (Object.getPrototypeOf(v) === Object.prototype || Array.isArray(v))) {
-            out[k] = redactSensitiveArgs(v);
-        }
-    }
-    return out;
-}
-/**
- * Convenience: produce a JSON string with sensitive fields redacted.
- */
-function safeStringifyArgs(args) {
-    try {
-        return JSON.stringify(redactSensitiveArgs(args));
-    }
-    catch {
-        return '[unserializable]';
-    }
-}

package/dist/utils/ui.d.ts

@@ -1,14 +0,0 @@
-export declare const green: (s: string) => string;
-export declare const red: (s: string) => string;
-export declare const yellow: (s: string) => string;
-export declare const cyan: (s: string) => string;
-export declare const bold: (s: string) => string;
-export declare const dim: (s: string) => string;
-export declare function success(msg: string): void;
-export declare function error(msg: string): void;
-export declare function warn(msg: string): void;
-export declare function info(msg: string): void;
-export declare function step(msg: string): void;
-export declare function banner(): void;
-export declare function prompt(question: string): Promise<string>;
-export declare function promptSelect(question: string, options: string[]): Promise<number>;