eai-cli 0.0.0-bootstrap.0

package/dist/lib/update-check.js

@@ -0,0 +1,271 @@
+/**
+ * Update check — non-blocking background version check with 24h cache.
+ *
+ * Skipped entirely in CI, when NO_UPDATE_NOTIFIER=1, or non-TTY output.
+ */
+import { readFile, writeFile, mkdir } from 'node:fs/promises';
+import { spawn } from 'node:child_process';
+import { join } from 'node:path';
+import { homedir } from 'node:os';
+import process from 'node:process';
+import chalk from 'chalk';
+const EAI_DIR = join(homedir(), '.eai');
+const CACHE_FILE = join(EAI_DIR, 'update-check.json');
+export const STATIC_REGISTRY_URL = 'https://eai-tools.github.io/eai/registry/';
+export const STATIC_PACKUMENT_URL = `${STATIC_REGISTRY_URL}@enterpriseai/cli`;
+export const NPMJS_REGISTRY_URL = 'https://registry.npmjs.org/';
+export const NPMJS_PACKUMENT_URL = `${NPMJS_REGISTRY_URL}@enterpriseai%2fcli`;
+const CHECK_INTERVAL_MS = 24 * 60 * 60 * 1000; // 24 hours
+const DEFAULT_FETCH_TIMEOUT_MS = 5000;
+const DISCOVERY_FETCH_TIMEOUT_MS = 1200;
+function shouldSkip() {
+    if (process.env['NO_UPDATE_NOTIFIER'] === '1') {
+        return true;
+    }
+    if (process.env['EAI_UPDATE_NOTIFIER_FORCE'] === '1') {
+        return false;
+    }
+    return (!!process.env['CI'] ||
+        !process.stderr.isTTY);
+}
+function getStaticPackumentUrl() {
+    return process.env['EAI_UPDATE_PACKUMENT_URL'] || STATIC_PACKUMENT_URL;
+}
+function getNpmjsPackumentUrl() {
+    return process.env['EAI_UPDATE_NPMJS_PACKUMENT_URL'] || NPMJS_PACKUMENT_URL;
+}
+export function isMachineReadableInvocation(args) {
+    for (let index = 0; index < args.length; index += 1) {
+        const arg = args[index];
+        if (!arg) {
+            continue;
+        }
+        if (arg === '--describe' || arg === '--json') {
+            return true;
+        }
+        if (arg === '--format' && args[index + 1] === 'json') {
+            return true;
+        }
+        if (arg === '--format=json') {
+            return true;
+        }
+    }
+    return false;
+}
+export function shouldOfferInteractiveUpdatePrompt(args, env = process.env, stdin = process.stdin, stderr = process.stderr) {
+    if (env['NO_UPDATE_NOTIFIER'] === '1' || env['EAI_UPDATE_PROMPT_SUPPRESS'] === '1') {
+        return false;
+    }
+    if (env['CI'] || isMachineReadableInvocation(args)) {
+        return false;
+    }
+    return Boolean(stdin.isTTY && stderr.isTTY);
+}
+/** Compare two semver strings (major.minor.patch). */
+export function isNewerVersion(current, latest) {
+    const cur = current.split('.').map(Number);
+    const lat = latest.split('.').map(Number);
+    for (let i = 0; i < 3; i++) {
+        if ((lat[i] ?? 0) > (cur[i] ?? 0))
+            return true;
+        if ((lat[i] ?? 0) < (cur[i] ?? 0))
+            return false;
+    }
+    return false;
+}
+export function compareVersions(left, right) {
+    const lhs = left.split('.').map(Number);
+    const rhs = right.split('.').map(Number);
+    for (let i = 0; i < 3; i++) {
+        const delta = (lhs[i] ?? 0) - (rhs[i] ?? 0);
+        if (delta !== 0) {
+            return delta;
+        }
+    }
+    return 0;
+}
+export function selectNewestRelease(candidates) {
+    if (candidates.length === 0) {
+        return null;
+    }
+    const channelPriority = {
+        npmjs: 0,
+        'static-registry': 1,
+    };
+    return [...candidates].sort((left, right) => {
+        const versionDelta = compareVersions(right.version, left.version);
+        if (versionDelta !== 0) {
+            return versionDelta;
+        }
+        return channelPriority[left.channel] - channelPriority[right.channel];
+    })[0] ?? null;
+}
+async function fetchChannelLatest(url, channel, timeoutMs = DEFAULT_FETCH_TIMEOUT_MS) {
+    let timeout;
+    try {
+        const controller = new AbortController();
+        timeout = setTimeout(() => controller.abort(), timeoutMs);
+        const res = await fetch(url, { signal: controller.signal });
+        if (!res.ok)
+            return null;
+        const data = (await res.json());
+        const version = data['dist-tags']?.latest ?? null;
+        if (!version) {
+            return null;
+        }
+        return { channel, version };
+    }
+    catch {
+        return null;
+    }
+    finally {
+        if (timeout) {
+            clearTimeout(timeout);
+        }
+    }
+}
+/** Fetch the newest release from the public npm registry, falling back to the static EAI registry. */
+export async function fetchLatestRelease(timeoutMs = DEFAULT_FETCH_TIMEOUT_MS) {
+    const [npmjsRelease, staticRelease] = await Promise.all([
+        fetchChannelLatest(getNpmjsPackumentUrl(), 'npmjs', timeoutMs),
+        fetchChannelLatest(getStaticPackumentUrl(), 'static-registry', timeoutMs),
+    ]);
+    return selectNewestRelease([
+        ...(npmjsRelease ? [npmjsRelease] : []),
+        ...(staticRelease ? [staticRelease] : []),
+    ]);
+}
+/** Fetch the latest version from the available release channels. */
+export async function fetchLatestVersion(timeoutMs = DEFAULT_FETCH_TIMEOUT_MS) {
+    return (await fetchLatestRelease(timeoutMs))?.version ?? null;
+}
+async function readCache() {
+    try {
+        const raw = await readFile(CACHE_FILE, 'utf-8');
+        return JSON.parse(raw);
+    }
+    catch {
+        return null;
+    }
+}
+async function writeCache(cache) {
+    try {
+        await mkdir(EAI_DIR, { recursive: true });
+        await writeFile(CACHE_FILE, JSON.stringify(cache), 'utf-8');
+    }
+    catch {
+        // Best-effort — don't fail the CLI
+    }
+}
+async function refreshCache(currentVersion, timeoutMs = DEFAULT_FETCH_TIMEOUT_MS) {
+    const latest = await fetchLatestVersion(timeoutMs);
+    if (!latest) {
+        return null;
+    }
+    const cache = {
+        lastCheck: Date.now(),
+        latestVersion: latest,
+        currentVersion,
+    };
+    await writeCache(cache);
+    return cache;
+}
+async function readFreshOrRefreshCache(currentVersion, timeoutMs = DEFAULT_FETCH_TIMEOUT_MS) {
+    const cache = await readCache();
+    if (cache && Date.now() - cache.lastCheck < CHECK_INTERVAL_MS) {
+        return cache;
+    }
+    return await refreshCache(currentVersion, timeoutMs) ?? cache;
+}
+/**
+ * Fire-and-forget background update check.
+ * Reads cache; skips if checked within 24h; otherwise fetches and caches.
+ */
+export function checkForUpdate(currentVersion) {
+    if (shouldSkip())
+        return;
+    // Fire-and-forget — errors are swallowed
+    void (async () => {
+        await readFreshOrRefreshCache(currentVersion);
+    })();
+}
+/**
+ * Print update banner to stderr if a newer version is cached.
+ * Called after command execution so the banner appears last.
+ */
+export async function notifyIfUpdateAvailable(currentVersion, options = {}) {
+    if (shouldSkip())
+        return;
+    const cache = await readCache();
+    await printUpdateNotice(currentVersion, cache, options);
+}
+export async function runCurrentCliUpdate() {
+    return new Promise((resolve) => {
+        const entry = process.argv[1];
+        if (!entry) {
+            resolve(false);
+            return;
+        }
+        const child = spawn(process.execPath, [entry, 'update'], {
+            stdio: 'inherit',
+            env: {
+                ...process.env,
+                EAI_UPDATE_PROMPT_SUPPRESS: '1',
+                NO_UPDATE_NOTIFIER: '1',
+            },
+        });
+        child.on('error', () => resolve(false));
+        child.on('close', (code) => resolve(code === 0));
+    });
+}
+async function promptForUpdate() {
+    const { default: inquirer } = await import('inquirer');
+    const { updateNow } = await inquirer.prompt([
+        {
+            type: 'confirm',
+            name: 'updateNow',
+            message: 'Update eai now?',
+            default: true,
+        },
+    ]);
+    return Boolean(updateNow);
+}
+export async function printUpdateNotice(currentVersion, cache, options = {}) {
+    if (!cache)
+        return;
+    if (!isNewerVersion(currentVersion, cache.latestVersion))
+        return;
+    const current = chalk.dim(currentVersion);
+    const latest = chalk.green(cache.latestVersion);
+    const cmd = chalk.cyan('eai update');
+    console.error('');
+    console.error(`  Update available: ${current} → ${latest}`);
+    if (shouldOfferInteractiveUpdatePrompt(options.args ?? [])) {
+        const accepted = await promptForUpdate();
+        if (accepted) {
+            const ran = await (options.runUpdate ?? runCurrentCliUpdate)();
+            if (!ran) {
+                console.error(`  Run ${cmd} to update`);
+            }
+            console.error('');
+            return;
+        }
+        console.error(`  Run ${cmd} when you are ready`);
+        console.error('');
+        return;
+    }
+    console.error(`  Run ${cmd} to update`);
+    console.error('');
+}
+/**
+ * Discovery commands are where stale CLIs hurt most: a user or agent asks
+ * "what can this do?" and old binaries cannot list new commands. Do a bounded
+ * foreground refresh so root help and unknown commands can point at eai update.
+ */
+export async function notifyIfUpdateAvailableForDiscovery(currentVersion) {
+    if (shouldSkip())
+        return;
+    const cache = await readFreshOrRefreshCache(currentVersion, DISCOVERY_FETCH_TIMEOUT_MS);
+    await printUpdateNotice(currentVersion, cache);
+}
+//# sourceMappingURL=update-check.js.map

package/dist/lib/update-check.js.map

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

package/dist/lib/update-maintenance.d.ts

@@ -0,0 +1,15 @@
+export type ProjectMaintenanceMode = "check" | "apply";
+export interface ProjectUpdateMaintenanceOptions {
+    readonly mode: ProjectMaintenanceMode;
+    readonly offerTemplateCheck?: boolean;
+    readonly runTemplateCheck?: () => Promise<boolean>;
+}
+export interface ProjectUpdateMaintenanceResult {
+    readonly projectRoot: string | null;
+    readonly gofer: "skipped" | "current" | "checked" | "refreshed";
+    readonly template: "skipped" | "current" | "review-recommended" | "custom-source" | "untracked";
+}
+export declare function runProjectUpdateMaintenance(options: ProjectUpdateMaintenanceOptions): Promise<ProjectUpdateMaintenanceResult>;
+export declare function runCurrentCliCommand(args: readonly string[]): Promise<boolean>;
+export declare function runInstalledEaiCommand(args: readonly string[]): Promise<boolean>;
+//# sourceMappingURL=update-maintenance.d.ts.map

package/dist/lib/update-maintenance.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"update-maintenance.d.ts","sourceRoot":"","sources":["../../src/lib/update-maintenance.ts"],"names":[],"mappings":"AAaA,MAAM,MAAM,sBAAsB,GAAG,OAAO,GAAG,OAAO,CAAC;AAEvD,MAAM,WAAW,+BAA+B;IAC9C,QAAQ,CAAC,IAAI,EAAE,sBAAsB,CAAC;IACtC,QAAQ,CAAC,kBAAkB,CAAC,EAAE,OAAO,CAAC;IACtC,QAAQ,CAAC,gBAAgB,CAAC,EAAE,MAAM,OAAO,CAAC,OAAO,CAAC,CAAC;CACpD;AAED,MAAM,WAAW,8BAA8B;IAC7C,QAAQ,CAAC,WAAW,EAAE,MAAM,GAAG,IAAI,CAAC;IACpC,QAAQ,CAAC,KAAK,EAAE,SAAS,GAAG,SAAS,GAAG,SAAS,GAAG,WAAW,CAAC;IAChE,QAAQ,CAAC,QAAQ,EACb,SAAS,GACT,SAAS,GACT,oBAAoB,GACpB,eAAe,GACf,WAAW,CAAC;CACjB;AAkJD,wBAAsB,2BAA2B,CAC/C,OAAO,EAAE,+BAA+B,GACvC,OAAO,CAAC,8BAA8B,CAAC,CA4DzC;AAED,wBAAgB,oBAAoB,CAAC,IAAI,EAAE,SAAS,MAAM,EAAE,GAAG,OAAO,CAAC,OAAO,CAAC,CAmB9E;AAED,wBAAgB,sBAAsB,CAAC,IAAI,EAAE,SAAS,MAAM,EAAE,GAAG,OAAO,CAAC,OAAO,CAAC,CAchF"}

package/dist/lib/update-maintenance.js

@@ -0,0 +1,187 @@
+import { spawn } from "node:child_process";
+import process from "node:process";
+import chalk from "chalk";
+import inquirer from "inquirer";
+import { findProjectRoot } from "./config.js";
+import { applyGoferRefresh, planGoferRefresh } from "./gofer-refresh.js";
+import { resolveProjectManifest } from "./project-manifest.js";
+import * as out from "./output.js";
+import { isDefaultTemplateSource, resolveTemplateClonePlan } from "../commands/init.js";
+const DEFAULT_TEMPLATE_SOURCE = "https://github.com/eai-tools/eai-app-template.git";
+function isInteractiveTerminal() {
+    return Boolean(process.stdin.isTTY &&
+        process.stdout.isTTY &&
+        !process.env["CI"]);
+}
+function hasGoferWork(summary) {
+    return (summary.added > 0 ||
+        summary.updated > 0 ||
+        summary.deleted > 0 ||
+        summary.conflicted > 0);
+}
+function renderGoferSummary(rows) {
+    out.table([
+        ["Added", String(rows.added)],
+        ["Updated", String(rows.updated)],
+        ["Deleted", String(rows.deleted)],
+        ["Conflicted", String(rows.conflicted)],
+        ...(typeof rows.unchanged === "number"
+            ? [["Unchanged", String(rows.unchanged)]]
+            : []),
+        ...(typeof rows.backedUp === "number"
+            ? [["Backed up", String(rows.backedUp)]]
+            : []),
+    ]);
+}
+function describeTemplateSnapshot(template) {
+    if (template.displaySource) {
+        return template.displaySource;
+    }
+    if (template.commit && template.repo) {
+        return `${template.repo}@${template.commit.slice(0, 7)}`;
+    }
+    return template.repo || "unknown";
+}
+async function maybeOfferTemplateCheck(options) {
+    if (!options.offerTemplateCheck || !options.runTemplateCheck || !isInteractiveTerminal()) {
+        return;
+    }
+    const { runTemplateCheck } = await inquirer.prompt([
+        {
+            type: "confirm",
+            name: "runTemplateCheck",
+            message: "Run `eai template check` now to review app-template drift?",
+            default: true,
+        },
+    ]);
+    if (runTemplateCheck) {
+        await options.runTemplateCheck();
+    }
+}
+async function renderTemplateStatus(projectRoot, options) {
+    const resolvedManifest = await resolveProjectManifest(projectRoot);
+    const manifest = resolvedManifest.manifest;
+    if (!manifest?.template) {
+        out.info("Template provenance is not recorded for this project. Run `eai template check` after recording template provenance if you need app-template drift detail.");
+        return "untracked";
+    }
+    const bundledTemplate = resolveTemplateClonePlan(DEFAULT_TEMPLATE_SOURCE);
+    const projectTemplateLabel = describeTemplateSnapshot(manifest.template);
+    const bundledTemplateLabel = describeTemplateSnapshot({
+        repo: bundledTemplate.cloneSource,
+        commit: bundledTemplate.pinnedCommit,
+        displaySource: bundledTemplate.displaySource,
+    });
+    if (manifest.template.repo &&
+        !isDefaultTemplateSource(manifest.template.repo) &&
+        manifest.template.repo !== bundledTemplate.cloneSource) {
+        out.info(`Project template source: ${projectTemplateLabel}`);
+        out.info(`Current bundled default template: ${bundledTemplateLabel}`);
+        out.info("This project uses a custom template source, so app-template updates require manual review.");
+        out.dim(`  Review: ${chalk.cyan("eai template check")}`);
+        return "custom-source";
+    }
+    if (manifest.template.commit &&
+        bundledTemplate.pinnedCommit &&
+        manifest.template.commit !== bundledTemplate.pinnedCommit) {
+        out.warn(`App-template snapshot has changed since this project was initialized: ${projectTemplateLabel} -> ${bundledTemplateLabel}`);
+        out.info("Template and UI files are not auto-merged into existing apps. Review the diff before copying anything.");
+        out.dim(`  Review: ${chalk.cyan("eai template check")}`);
+        await maybeOfferTemplateCheck(options);
+        return "review-recommended";
+    }
+    if (!manifest.template.commit || !bundledTemplate.pinnedCommit) {
+        out.info(`Template snapshot: ${projectTemplateLabel}. Run ${chalk.cyan("eai template check")} for file-level review when needed.`);
+        return "review-recommended";
+    }
+    out.success(`Template snapshot is current: ${projectTemplateLabel}`);
+    return "current";
+}
+export async function runProjectUpdateMaintenance(options) {
+    const projectRoot = await findProjectRoot();
+    if (!projectRoot) {
+        out.info("No EAI project detected here; skipping Gofer and app-template maintenance.");
+        return {
+            projectRoot: null,
+            gofer: "skipped",
+            template: "skipped",
+        };
+    }
+    out.blank();
+    out.heading("Project Maintenance");
+    out.blank();
+    out.success(`Project root: ${chalk.dim(projectRoot)}`);
+    const resolvedManifest = await resolveProjectManifest(projectRoot);
+    const plan = await planGoferRefresh(projectRoot, resolvedManifest.manifest, {
+        workflowProfile: "enterpriseai",
+    });
+    if (options.mode === "check") {
+        if (hasGoferWork(plan.summary) || plan.firstRefresh) {
+            out.info("Gofer-managed asset refresh is available.");
+            renderGoferSummary(plan.summary);
+            out.dim(`  Apply: ${chalk.cyan("eai gofer refresh")}`);
+        }
+        else {
+            out.success("Gofer-managed assets are already up to date.");
+        }
+        const template = await renderTemplateStatus(projectRoot, options);
+        return {
+            projectRoot,
+            gofer: hasGoferWork(plan.summary) || plan.firstRefresh ? "checked" : "current",
+            template,
+        };
+    }
+    const applyResult = await applyGoferRefresh(plan, { force: false });
+    if (hasGoferWork(applyResult.summary) || plan.firstRefresh) {
+        out.success("Gofer-managed assets refreshed.");
+        renderGoferSummary(applyResult.summary);
+        if (applyResult.backupDirectory) {
+            out.info(`Backup directory: ${applyResult.backupDirectory}`);
+        }
+        if (applyResult.summary.conflicted > 0) {
+            out.warn("Some managed files were left untouched because they have local edits. Re-run `eai gofer refresh --force` only after reviewing the backups.");
+        }
+    }
+    else {
+        out.success("Gofer-managed assets are already up to date.");
+    }
+    const template = await renderTemplateStatus(projectRoot, options);
+    return {
+        projectRoot,
+        gofer: "refreshed",
+        template,
+    };
+}
+export function runCurrentCliCommand(args) {
+    return new Promise((resolve) => {
+        const entry = process.argv[1];
+        if (!entry) {
+            resolve(false);
+            return;
+        }
+        const child = spawn(process.execPath, [entry, ...args], {
+            stdio: "inherit",
+            env: {
+                ...process.env,
+                NO_UPDATE_NOTIFIER: "1",
+            },
+        });
+        child.on("error", () => resolve(false));
+        child.on("close", (code) => resolve(code === 0));
+    });
+}
+export function runInstalledEaiCommand(args) {
+    return new Promise((resolve) => {
+        const executable = process.platform === "win32" ? "eai.cmd" : "eai";
+        const child = spawn(executable, args, {
+            stdio: "inherit",
+            env: {
+                ...process.env,
+                NO_UPDATE_NOTIFIER: "1",
+            },
+        });
+        child.on("error", () => resolve(false));
+        child.on("close", (code) => resolve(code === 0));
+    });
+}
+//# sourceMappingURL=update-maintenance.js.map

package/dist/lib/update-maintenance.js.map

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

package/dist/lib/utils.d.ts

@@ -0,0 +1,23 @@
+/**
+ * Shared utilities — consolidated from duplicate definitions across commands.
+ */
+/**
+ * Convert an object type name (camelCase or snake_case) to a kebab-case slug.
+ * Previously duplicated in: api.ts, types.ts, resources.ts
+ */
+export declare function toObjectTypeSlug(objectType: string): string;
+/**
+ * Type guard for plain objects.
+ * Previously duplicated in: types.ts, resources.ts, verify.ts
+ */
+export declare function isRecord(value: unknown): value is Record<string, unknown>;
+/**
+ * Extract a message string from an unknown error.
+ * Replaces inline `err instanceof Error ? err.message : String(err)` ternaries.
+ */
+export declare function errMsg(err: unknown): string;
+export declare const CHILD_TENANT_NAME_REQUIRED_MESSAGE = "A child company tenant name is required. Pass `--child-tenant <name>`.";
+export declare const CHILD_TENANT_SLUG_REQUIRED_MESSAGE = "A child company tenant slug is required. Pass `--child-tenant-slug <slug>`.";
+export declare function normalizeChildTenantDisplayNameOption(value: string | undefined): string | undefined;
+export declare function normalizeChildTenantSlugOption(value: string | undefined): string | undefined;
+//# sourceMappingURL=utils.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"utils.d.ts","sourceRoot":"","sources":["../../src/lib/utils.ts"],"names":[],"mappings":"AAAA;;GAEG;AAEH;;;GAGG;AACH,wBAAgB,gBAAgB,CAAC,UAAU,EAAE,MAAM,GAAG,MAAM,CAQ3D;AAED;;;GAGG;AACH,wBAAgB,QAAQ,CAAC,KAAK,EAAE,OAAO,GAAG,KAAK,IAAI,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAEzE;AAED;;;GAGG;AACH,wBAAgB,MAAM,CAAC,GAAG,EAAE,OAAO,GAAG,MAAM,CAE3C;AAED,eAAO,MAAM,kCAAkC,2EAC2B,CAAC;AAC3E,eAAO,MAAM,kCAAkC,gFACgC,CAAC;AAWhF,wBAAgB,qCAAqC,CAAC,KAAK,EAAE,MAAM,GAAG,SAAS,GAAG,MAAM,GAAG,SAAS,CAEnG;AAED,wBAAgB,8BAA8B,CAAC,KAAK,EAAE,MAAM,GAAG,SAAS,GAAG,MAAM,GAAG,SAAS,CAE5F"}

package/dist/lib/utils.js

@@ -0,0 +1,48 @@
+/**
+ * Shared utilities — consolidated from duplicate definitions across commands.
+ */
+/**
+ * Convert an object type name (camelCase or snake_case) to a kebab-case slug.
+ * Previously duplicated in: api.ts, types.ts, resources.ts
+ */
+export function toObjectTypeSlug(objectType) {
+    return objectType
+        .trim()
+        .replace(/([a-z0-9])([A-Z])/g, '$1-$2')
+        .replace(/([A-Z])([A-Z][a-z])/g, '$1-$2')
+        .replace(/[_\s]+/g, '-')
+        .replace(/-+/g, '-')
+        .toLowerCase();
+}
+/**
+ * Type guard for plain objects.
+ * Previously duplicated in: types.ts, resources.ts, verify.ts
+ */
+export function isRecord(value) {
+    return typeof value === 'object' && value !== null && !Array.isArray(value);
+}
+/**
+ * Extract a message string from an unknown error.
+ * Replaces inline `err instanceof Error ? err.message : String(err)` ternaries.
+ */
+export function errMsg(err) {
+    return err instanceof Error ? err.message : String(err);
+}
+export const CHILD_TENANT_NAME_REQUIRED_MESSAGE = "A child company tenant name is required. Pass `--child-tenant <name>`.";
+export const CHILD_TENANT_SLUG_REQUIRED_MESSAGE = "A child company tenant slug is required. Pass `--child-tenant-slug <slug>`.";
+function normalizeRequiredCliOptionValue(value, message) {
+    if (value === undefined)
+        return undefined;
+    const trimmed = value.trim();
+    if (!trimmed) {
+        throw new Error(message);
+    }
+    return trimmed;
+}
+export function normalizeChildTenantDisplayNameOption(value) {
+    return normalizeRequiredCliOptionValue(value, CHILD_TENANT_NAME_REQUIRED_MESSAGE);
+}
+export function normalizeChildTenantSlugOption(value) {
+    return normalizeRequiredCliOptionValue(value, CHILD_TENANT_SLUG_REQUIRED_MESSAGE);
+}
+//# sourceMappingURL=utils.js.map

package/dist/lib/utils.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"utils.js","sourceRoot":"","sources":["../../src/lib/utils.ts"],"names":[],"mappings":"AAAA;;GAEG;AAEH;;;GAGG;AACH,MAAM,UAAU,gBAAgB,CAAC,UAAkB;IACjD,OAAO,UAAU;SACd,IAAI,EAAE;SACN,OAAO,CAAC,oBAAoB,EAAE,OAAO,CAAC;SACtC,OAAO,CAAC,sBAAsB,EAAE,OAAO,CAAC;SACxC,OAAO,CAAC,SAAS,EAAE,GAAG,CAAC;SACvB,OAAO,CAAC,KAAK,EAAE,GAAG,CAAC;SACnB,WAAW,EAAE,CAAC;AACnB,CAAC;AAED;;;GAGG;AACH,MAAM,UAAU,QAAQ,CAAC,KAAc;IACrC,OAAO,OAAO,KAAK,KAAK,QAAQ,IAAI,KAAK,KAAK,IAAI,IAAI,CAAC,KAAK,CAAC,OAAO,CAAC,KAAK,CAAC,CAAC;AAC9E,CAAC;AAED;;;GAGG;AACH,MAAM,UAAU,MAAM,CAAC,GAAY;IACjC,OAAO,GAAG,YAAY,KAAK,CAAC,CAAC,CAAC,GAAG,CAAC,OAAO,CAAC,CAAC,CAAC,MAAM,CAAC,GAAG,CAAC,CAAC;AAC1D,CAAC;AAED,MAAM,CAAC,MAAM,kCAAkC,GAC7C,wEAAwE,CAAC;AAC3E,MAAM,CAAC,MAAM,kCAAkC,GAC7C,6EAA6E,CAAC;AAEhF,SAAS,+BAA+B,CAAC,KAAyB,EAAE,OAAe;IACjF,IAAI,KAAK,KAAK,SAAS;QAAE,OAAO,SAAS,CAAC;IAC1C,MAAM,OAAO,GAAG,KAAK,CAAC,IAAI,EAAE,CAAC;IAC7B,IAAI,CAAC,OAAO,EAAE,CAAC;QACb,MAAM,IAAI,KAAK,CAAC,OAAO,CAAC,CAAC;IAC3B,CAAC;IACD,OAAO,OAAO,CAAC;AACjB,CAAC;AAED,MAAM,UAAU,qCAAqC,CAAC,KAAyB;IAC7E,OAAO,+BAA+B,CAAC,KAAK,EAAE,kCAAkC,CAAC,CAAC;AACpF,CAAC;AAED,MAAM,UAAU,8BAA8B,CAAC,KAAyB;IACtE,OAAO,+BAA+B,CAAC,KAAK,EAAE,kCAAkC,CAAC,CAAC;AACpF,CAAC"}

package/dist/lib/workflow-provisioning.d.ts

@@ -0,0 +1,54 @@
+export declare const SHARED_WORKFLOW_CONFIG_OBJECT_TYPE = "shared-workflow-config";
+export declare const VERTICAL_PRODUCT_CONFIG_OBJECT_TYPE = "vertical-product-config";
+export declare const SHARED_AI_PROFILE_OBJECT_TYPE = "shared-ai-profile";
+export declare const SHARED_CHATBOT_CONFIG_OBJECT_TYPE = "shared-chatbot-config";
+export declare const SHARED_ASSET_ADOPTION_OBJECT_TYPE = "shared-asset-adoption";
+export declare const SHARED_ASSET_DISPOSITION_OBJECT_TYPE = "shared-asset-disposition";
+export declare const WORKFLOW_VERTICAL_CONFIG_PREFIX = "workflow:";
+export type WorkflowProvisionStatus = "active" | "draft";
+export interface WorkflowProvisionStage {
+    id: string;
+    name?: string;
+    order?: number;
+}
+export interface WorkflowProvisionDefinitionInput {
+    tenantId: string;
+    verticalKey: string;
+    workflowKey: string;
+    displayName: string;
+    stages: WorkflowProvisionStage[];
+    usecase?: string;
+    scopeKey?: string;
+    status?: WorkflowProvisionStatus;
+    source?: string;
+}
+export interface WorkflowProvisionPayloads {
+    workflowConfig: Record<string, unknown>;
+    verticalConfig: Record<string, unknown>;
+    workflowEnvKey: string;
+    envValues: Record<string, string>;
+}
+export interface WorkflowAiRuntimeBindingInput extends WorkflowProvisionDefinitionInput {
+    providerIntegrationKey: string;
+    model: string;
+    profileKey?: string;
+    stagePrompts?: Record<string, string>;
+}
+export interface WorkflowAiRuntimeBindingPayloads {
+    aiProfile: Record<string, unknown>;
+    chatbotConfigs: Array<Record<string, unknown>>;
+}
+export declare function workflowVerticalConfigKey(workflowKey: string): string;
+export declare function toEnvToken(value: string): string;
+export declare function humanizeSlug(value: string): string;
+export declare function parseStageSpec(value: string, index: number): WorkflowProvisionStage;
+export declare function parseEnvMapping(value: string): [string, string];
+export declare function validateStageEnvMappings(stages: WorkflowProvisionStage[], stageEnv: Record<string, string>): void;
+export declare function validateStagePromptMappings(stages: WorkflowProvisionStage[], stagePrompts: Record<string, string>): void;
+export declare function buildWorkflowProvisionPayloads(input: WorkflowProvisionDefinitionInput, options?: {
+    workflowEnvKey?: string;
+    stageEnv?: Record<string, string>;
+}): WorkflowProvisionPayloads;
+export declare function parseStagePrompt(value: string): [string, string];
+export declare function buildWorkflowAiRuntimeBindingPayloads(input: WorkflowAiRuntimeBindingInput): WorkflowAiRuntimeBindingPayloads;
+//# sourceMappingURL=workflow-provisioning.d.ts.map

package/dist/lib/workflow-provisioning.d.ts.map

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