@n-dx/core 0.1.0

package/packages/rex/dist/cli/commands/usage.js

@@ -0,0 +1,192 @@
+import { join } from "node:path";
+import { resolveStore } from "../../store/index.js";
+import { aggregateTokenUsage, estimateCost, collectTokenEvents, groupByCommand, groupByTimePeriod, checkBudget, } from "../../core/token-usage.js";
+import { formatAggregateTokenUsage, formatBudgetWarnings } from "./token-format.js";
+import { CLIError, BudgetExceededError } from "../errors.js";
+import { REX_DIR } from "./constants.js";
+import { info, warn, result } from "../output.js";
+const VALID_FORMATS = ["json", "tree"];
+const VALID_GROUPS = ["day", "week", "month"];
+/** Format a number with locale-aware commas. */
+function fmt(n) {
+    return n.toLocaleString();
+}
+/**
+ * Format detailed per-package breakdown for tree output.
+ * Shows input/output split and call count for each package with usage.
+ */
+function formatPackageDetail(usage) {
+    const lines = [];
+    const entries = [
+        { name: "rex", pkg: usage.packages.rex, unit: "calls" },
+        { name: "hench", pkg: usage.packages.hench, unit: "runs" },
+        { name: "sv", pkg: usage.packages.sv, unit: "calls" },
+    ];
+    for (const { name, pkg, unit } of entries) {
+        const total = pkg.inputTokens + pkg.outputTokens;
+        if (total === 0)
+            continue;
+        lines.push(`  ${name}: ${fmt(total)} tokens (${fmt(pkg.inputTokens)} in / ${fmt(pkg.outputTokens)} out) — ${pkg.calls} ${unit}`);
+    }
+    return lines;
+}
+/**
+ * Format per-command breakdown for tree output.
+ */
+function formatCommandDetail(commands) {
+    const lines = [];
+    for (const cmd of commands) {
+        const total = cmd.inputTokens + cmd.outputTokens;
+        const unit = cmd.package === "hench" ? "runs" : "calls";
+        lines.push(`  ${cmd.package} ${cmd.command}: ${fmt(total)} tokens (${fmt(cmd.inputTokens)} in / ${fmt(cmd.outputTokens)} out) — ${cmd.calls} ${unit}`);
+    }
+    return lines;
+}
+/**
+ * Format period buckets for tree output.
+ */
+function formatPeriodBuckets(buckets) {
+    const lines = [];
+    for (const bucket of buckets) {
+        const total = bucket.usage.totalInputTokens + bucket.usage.totalOutputTokens;
+        lines.push(`  ${bucket.period}: ${fmt(total)} tokens (${fmt(bucket.usage.totalInputTokens)} in / ${fmt(bucket.usage.totalOutputTokens)} out) — ${bucket.estimatedCost.total}`);
+    }
+    return lines;
+}
+export async function cmdUsage(dir, flags) {
+    const format = flags.format;
+    const group = flags.group;
+    if (format && !VALID_FORMATS.includes(format)) {
+        throw new CLIError(`Unknown format: "${format}"`, `Valid formats: ${VALID_FORMATS.join(", ")}`);
+    }
+    if (group && !VALID_GROUPS.includes(group)) {
+        throw new CLIError(`Unknown group period: "${group}"`, `Valid periods: ${VALID_GROUPS.join(", ")}`);
+    }
+    const rexDir = join(dir, REX_DIR);
+    const store = await resolveStore(rexDir);
+    // Build time filter
+    const tokenFilter = {};
+    if (flags.since)
+        tokenFilter.since = flags.since;
+    if (flags.until)
+        tokenFilter.until = flags.until;
+    const logEntries = await store.readLog();
+    // Collect individual events for command and period breakdowns
+    const events = await collectTokenEvents(logEntries, dir, tokenFilter);
+    const commands = groupByCommand(events);
+    // Aggregate totals (reuse existing infrastructure)
+    const usage = await aggregateTokenUsage(logEntries, dir, tokenFilter);
+    const cost = estimateCost(usage);
+    // Period grouping (optional)
+    const periodBuckets = group ? groupByTimePeriod(events, group) : undefined;
+    // Budget checking
+    const config = await store.loadConfig();
+    const budgetResult = config.budget
+        ? checkBudget(usage, config.budget)
+        : undefined;
+    if (format === "json") {
+        const output = { ...usage };
+        output.estimatedCost = {
+            total: cost.total,
+            inputCost: cost.inputCost,
+            outputCost: cost.outputCost,
+        };
+        // Per-command breakdown
+        output.commands = commands.map((cmd) => ({
+            package: cmd.package,
+            command: cmd.command,
+            inputTokens: cmd.inputTokens,
+            outputTokens: cmd.outputTokens,
+            calls: cmd.calls,
+        }));
+        // Period breakdown (if --group specified)
+        if (periodBuckets) {
+            output.periods = periodBuckets.map((b) => ({
+                period: b.period,
+                ...b.usage,
+                estimatedCost: {
+                    total: b.estimatedCost.total,
+                    inputCost: b.estimatedCost.inputCost,
+                    outputCost: b.estimatedCost.outputCost,
+                },
+            }));
+            output.group = group;
+        }
+        // Only include filter if filters were applied
+        if (tokenFilter.since || tokenFilter.until) {
+            const filter = {};
+            if (tokenFilter.since)
+                filter.since = tokenFilter.since;
+            if (tokenFilter.until)
+                filter.until = tokenFilter.until;
+            output.filter = filter;
+        }
+        // Budget status (when configured)
+        if (budgetResult) {
+            output.budget = {
+                severity: budgetResult.severity,
+                tokens: budgetResult.tokens,
+                cost: budgetResult.cost,
+                warnings: budgetResult.warnings,
+            };
+        }
+        result(JSON.stringify(output, null, 2));
+        return;
+    }
+    // Tree output
+    for (const line of formatAggregateTokenUsage(usage)) {
+        result(line);
+    }
+    // Detailed output (only when there is data)
+    const total = usage.totalInputTokens + usage.totalOutputTokens;
+    if (total > 0) {
+        // Per-package breakdown
+        info("");
+        info("By package:");
+        for (const line of formatPackageDetail(usage)) {
+            info(line);
+        }
+        // Per-command breakdown
+        if (commands.length > 0) {
+            info("");
+            info("By command:");
+            for (const line of formatCommandDetail(commands)) {
+                info(line);
+            }
+        }
+        // Period breakdown
+        if (periodBuckets && periodBuckets.length > 0) {
+            info("");
+            info(`By ${group}:`);
+            for (const line of formatPeriodBuckets(periodBuckets)) {
+                info(line);
+            }
+        }
+        // Cost estimation
+        info("");
+        info(`Estimated cost: ${cost.total} (based on Sonnet pricing)`);
+    }
+    // Filter notice
+    if (tokenFilter.since || tokenFilter.until) {
+        const parts = [];
+        if (tokenFilter.since)
+            parts.push(`since ${tokenFilter.since}`);
+        if (tokenFilter.until)
+            parts.push(`until ${tokenFilter.until}`);
+        info(`  (filtered: ${parts.join(", ")})`);
+    }
+    // Budget warnings
+    if (budgetResult) {
+        const budgetLines = formatBudgetWarnings(budgetResult);
+        if (budgetLines.length > 0) {
+            warn("");
+            for (const line of budgetLines) {
+                warn(line);
+            }
+        }
+        if (budgetResult.severity === "exceeded" && config.budget?.abort) {
+            throw new BudgetExceededError(budgetResult.warnings);
+        }
+    }
+}
+//# sourceMappingURL=usage.js.map

package/packages/rex/dist/cli/commands/usage.js.map

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

package/packages/rex/dist/cli/commands/validate-interactive.d.ts

@@ -0,0 +1,46 @@
+import type { PRDDocument } from "../../schema/index.js";
+import type { EpiclessFeature } from "../../core/structural.js";
+export type EpiclessAction = "correlate" | "delete" | "skip";
+export interface EpiclessResolution {
+    featureId: string;
+    action: EpiclessAction;
+    /** Target epic ID when action is "correlate". */
+    targetEpicId?: string;
+}
+/**
+ * Function signature for interactive prompts.
+ * Abstracted for testability — production uses readline, tests inject stubs.
+ */
+export type PromptFn = (question: string) => Promise<string>;
+/**
+ * Present interactive prompts to resolve epicless features found during validation.
+ *
+ * For each epicless feature, the system first runs correlation analysis to suggest
+ * semantically similar parent epics. The user can:
+ * - **Correlate**: move under a suggested epic (ranked by similarity) or browse all epics
+ * - **Delete**: remove the feature (and its children) from the PRD
+ * - **Skip**: leave it unchanged (still reported as validation error)
+ *
+ * When a high-confidence match is found (≥50% similarity), the top suggestion
+ * is highlighted in the prompt to guide the user.
+ *
+ * Returns an array of resolutions describing the chosen action per feature.
+ *
+ * @param doc              The loaded PRD document (read-only for resolution gathering)
+ * @param epiclessFeatures Detected epicless features from structural validation
+ * @param options.prompt   Injectable prompt function (default: readline-based TTY prompt)
+ */
+export declare function resolveEpiclessFeatures(doc: PRDDocument, epiclessFeatures: EpiclessFeature[], options?: {
+    prompt?: PromptFn;
+}): Promise<EpiclessResolution[]>;
+/**
+ * Apply epicless feature resolutions to the PRD document.
+ *
+ * Mutates `doc.items` in place:
+ * - **correlate**: removes the feature from root and inserts it under the target epic
+ * - **delete**: removes the feature (and children) from the tree entirely
+ * - **skip**: no mutation
+ *
+ * @returns The number of mutations applied.
+ */
+export declare function applyEpiclessResolutions(doc: PRDDocument, resolutions: EpiclessResolution[]): number;

package/packages/rex/dist/cli/commands/validate-interactive.js

@@ -0,0 +1,236 @@
+import { isRootLevel } from "../../schema/index.js";
+import { correlateEpiclessFeatures, formatScore, } from "../../core/epic-correlation.js";
+import { insertChild, removeFromTree } from "../../core/tree.js";
+import { preCheckFeatureDeletion, removeFeature, } from "../../core/remove-feature.js";
+import { info, warn } from "../output.js";
+// ── Interactive resolution ───────────────────────────────────────────────────
+/**
+ * Present interactive prompts to resolve epicless features found during validation.
+ *
+ * For each epicless feature, the system first runs correlation analysis to suggest
+ * semantically similar parent epics. The user can:
+ * - **Correlate**: move under a suggested epic (ranked by similarity) or browse all epics
+ * - **Delete**: remove the feature (and its children) from the PRD
+ * - **Skip**: leave it unchanged (still reported as validation error)
+ *
+ * When a high-confidence match is found (≥50% similarity), the top suggestion
+ * is highlighted in the prompt to guide the user.
+ *
+ * Returns an array of resolutions describing the chosen action per feature.
+ *
+ * @param doc              The loaded PRD document (read-only for resolution gathering)
+ * @param epiclessFeatures Detected epicless features from structural validation
+ * @param options.prompt   Injectable prompt function (default: readline-based TTY prompt)
+ */
+export async function resolveEpiclessFeatures(doc, epiclessFeatures, options) {
+    const prompt = options?.prompt ?? defaultPrompt;
+    const resolutions = [];
+    // Collect available epics for correlation
+    const availableEpics = doc.items.filter((item) => isRootLevel(item.level) && item.status !== "deleted");
+    // Run correlation analysis for all epicless features
+    const correlations = correlateEpiclessFeatures(doc.items, epiclessFeatures);
+    // Build a lookup map for correlation results
+    const correlationMap = new Map();
+    for (const cr of correlations) {
+        correlationMap.set(cr.featureId, cr);
+    }
+    info("");
+    info(`Found ${epiclessFeatures.length} feature${epiclessFeatures.length === 1 ? "" : "s"} without parent epic${epiclessFeatures.length === 1 ? "" : "s"}:`);
+    for (const feature of epiclessFeatures) {
+        const correlation = correlationMap.get(feature.itemId);
+        const childInfo = feature.childCount > 0
+            ? `, ${feature.childCount} child${feature.childCount === 1 ? "" : "ren"}`
+            : "";
+        info("");
+        info(`  Feature: "${feature.title}" [${feature.itemId.slice(0, 8)}] (${feature.status}${childInfo})`);
+        // Show correlation suggestions if available
+        if (correlation && correlation.candidates.length > 0) {
+            info("");
+            info("  Suggested parent epics (by similarity):");
+            for (let i = 0; i < correlation.candidates.length; i++) {
+                const c = correlation.candidates[i];
+                const marker = i === 0 && correlation.hasHighConfidence ? " ★" : "";
+                info(`    ${i + 1}. "${c.epicTitle}" [${c.epicId.slice(0, 8)}] — ${formatScore(c.score)} match${marker}`);
+            }
+            info("");
+        }
+        // Present action options with context-aware hints
+        if (correlation?.hasHighConfidence) {
+            const top = correlation.candidates[0];
+            info(`    [1] Correlate — move under "${top.epicTitle}" (${formatScore(top.score)} match, recommended)`);
+        }
+        else {
+            info("    [1] Correlate — move under an existing epic");
+        }
+        info("    [2] Delete — remove this feature and its children");
+        info("    [3] Skip — leave as-is");
+        const choice = await prompt("  Choice (1-3): ");
+        switch (choice.trim()) {
+            case "1": {
+                if (availableEpics.length === 0) {
+                    warn("  No epics available for correlation. Skipping.");
+                    resolutions.push({ featureId: feature.itemId, action: "skip" });
+                    break;
+                }
+                // If high-confidence match, offer to accept the top suggestion directly
+                if (correlation?.hasHighConfidence) {
+                    const top = correlation.candidates[0];
+                    info("");
+                    info(`  Top suggestion: "${top.epicTitle}" (${formatScore(top.score)} match)`);
+                    info("    [y] Accept this suggestion");
+                    info("    [n] Browse all epics");
+                    const accept = await prompt("  Accept? (y/n): ");
+                    if (accept.trim().toLowerCase() === "y") {
+                        resolutions.push({
+                            featureId: feature.itemId,
+                            action: "correlate",
+                            targetEpicId: top.epicId,
+                        });
+                        info(`  ✓ Will move under "${top.epicTitle}"`);
+                        break;
+                    }
+                }
+                // Show full epic list (sorted by correlation score when available)
+                info("");
+                info("  Available epics:");
+                const epicOrder = buildEpicDisplayOrder(availableEpics, correlation);
+                for (let i = 0; i < epicOrder.length; i++) {
+                    const epic = epicOrder[i];
+                    const scoreLabel = epic.score !== undefined
+                        ? ` — ${formatScore(epic.score)} match`
+                        : "";
+                    info(`    [${i + 1}] "${epic.title}" [${epic.id.slice(0, 8)}]${scoreLabel}`);
+                }
+                const epicChoice = await prompt(`  Move under which epic? (1-${epicOrder.length}): `);
+                const epicIdx = parseInt(epicChoice.trim(), 10) - 1;
+                if (epicIdx >= 0 && epicIdx < epicOrder.length) {
+                    resolutions.push({
+                        featureId: feature.itemId,
+                        action: "correlate",
+                        targetEpicId: epicOrder[epicIdx].id,
+                    });
+                    info(`  ✓ Will move under "${epicOrder[epicIdx].title}"`);
+                }
+                else {
+                    warn("  Invalid epic selection. Skipping.");
+                    resolutions.push({ featureId: feature.itemId, action: "skip" });
+                }
+                break;
+            }
+            case "2": {
+                // Run integrity pre-checks before confirming deletion
+                const preCheck = preCheckFeatureDeletion(doc.items, feature.itemId);
+                if (!preCheck.safe) {
+                    info("");
+                    warn("  ⚠ Integrity warnings:");
+                    for (const w of preCheck.warnings) {
+                        warn(`    • ${w}`);
+                    }
+                    info("");
+                    info(`    This will permanently delete ${preCheck.subtreeCount} item${preCheck.subtreeCount === 1 ? "" : "s"}.`);
+                    info("    [y] Confirm deletion");
+                    info("    [n] Cancel (skip instead)");
+                    const confirm = await prompt("  Proceed? (y/n): ");
+                    if (confirm.trim().toLowerCase() !== "y") {
+                        resolutions.push({ featureId: feature.itemId, action: "skip" });
+                        info("  → Deletion cancelled, skipping");
+                        break;
+                    }
+                }
+                else {
+                    info(`    Deleting ${preCheck.subtreeCount} item${preCheck.subtreeCount === 1 ? "" : "s"} (no external dependencies or sync references).`);
+                }
+                resolutions.push({ featureId: feature.itemId, action: "delete" });
+                info("  ✓ Marked for deletion");
+                break;
+            }
+            case "3":
+                resolutions.push({ featureId: feature.itemId, action: "skip" });
+                info("  → Skipped");
+                break;
+            default:
+                warn("  Invalid choice. Skipping.");
+                resolutions.push({ featureId: feature.itemId, action: "skip" });
+                break;
+        }
+    }
+    return resolutions;
+}
+/**
+ * Build an ordered list of epics for display, merging correlation scores
+ * with the full epic list. Scored epics appear first (highest score first),
+ * followed by any unscored epics in their original order.
+ */
+function buildEpicDisplayOrder(availableEpics, correlation) {
+    if (!correlation || correlation.candidates.length === 0) {
+        return availableEpics.map((e) => ({ id: e.id, title: e.title }));
+    }
+    const scoreMap = new Map();
+    for (const c of correlation.candidates) {
+        scoreMap.set(c.epicId, c.score);
+    }
+    const scored = [];
+    const unscored = [];
+    for (const epic of availableEpics) {
+        const s = scoreMap.get(epic.id);
+        if (s !== undefined) {
+            scored.push({ id: epic.id, title: epic.title, score: s });
+        }
+        else {
+            unscored.push({ id: epic.id, title: epic.title });
+        }
+    }
+    // Sort scored epics by score descending
+    scored.sort((a, b) => (b.score ?? 0) - (a.score ?? 0));
+    return [...scored, ...unscored];
+}
+// ── Apply resolutions ────────────────────────────────────────────────────────
+/**
+ * Apply epicless feature resolutions to the PRD document.
+ *
+ * Mutates `doc.items` in place:
+ * - **correlate**: removes the feature from root and inserts it under the target epic
+ * - **delete**: removes the feature (and children) from the tree entirely
+ * - **skip**: no mutation
+ *
+ * @returns The number of mutations applied.
+ */
+export function applyEpiclessResolutions(doc, resolutions) {
+    let mutated = 0;
+    for (const resolution of resolutions) {
+        if (resolution.action === "skip")
+            continue;
+        if (resolution.action === "correlate" && resolution.targetEpicId) {
+            const feature = removeFromTree(doc.items, resolution.featureId);
+            if (feature) {
+                const inserted = insertChild(doc.items, resolution.targetEpicId, feature);
+                if (inserted) {
+                    mutated++;
+                }
+                else {
+                    // Insertion failed (shouldn't happen with valid epic target) — restore
+                    doc.items.push(feature);
+                }
+            }
+        }
+        if (resolution.action === "delete") {
+            const result = removeFeature(doc.items, resolution.featureId);
+            if (result.ok) {
+                mutated++;
+            }
+        }
+    }
+    return mutated;
+}
+// ── Default readline prompt ──────────────────────────────────────────────────
+async function defaultPrompt(question) {
+    const readline = await import("node:readline");
+    const rl = readline.createInterface({
+        input: process.stdin,
+        output: process.stdout,
+    });
+    const answer = await new Promise((resolve) => rl.question(question, resolve));
+    rl.close();
+    return answer;
+}
+//# sourceMappingURL=validate-interactive.js.map

package/packages/rex/dist/cli/commands/validate-interactive.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"validate-interactive.js","sourceRoot":"","sources":["../../../src/cli/commands/validate-interactive.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,WAAW,EAAE,MAAM,uBAAuB,CAAC;AAEpD,OAAO,EACL,yBAAyB,EACzB,WAAW,GACZ,MAAM,gCAAgC,CAAC;AAExC,OAAO,EAAE,WAAW,EAAE,cAAc,EAAE,MAAM,oBAAoB,CAAC;AACjE,OAAO,EACL,uBAAuB,EACvB,aAAa,GACd,MAAM,8BAA8B,CAAC;AACtC,OAAO,EAAE,IAAI,EAAE,IAAI,EAAE,MAAM,cAAc,CAAC;AAmB1C,gFAAgF;AAEhF;;;;;;;;;;;;;;;;;GAiBG;AACH,MAAM,CAAC,KAAK,UAAU,uBAAuB,CAC3C,GAAgB,EAChB,gBAAmC,EACnC,OAA+B;IAE/B,MAAM,MAAM,GAAG,OAAO,EAAE,MAAM,IAAI,aAAa,CAAC;IAChD,MAAM,WAAW,GAAyB,EAAE,CAAC;IAE7C,0CAA0C;IAC1C,MAAM,cAAc,GAAG,GAAG,CAAC,KAAK,CAAC,MAAM,CACrC,CAAC,IAAI,EAAE,EAAE,CAAC,WAAW,CAAC,IAAI,CAAC,KAAK,CAAC,IAAI,IAAI,CAAC,MAAM,KAAK,SAAS,CAC/D,CAAC;IAEF,qDAAqD;IACrD,MAAM,YAAY,GAAG,yBAAyB,CAC5C,GAAG,CAAC,KAAK,EACT,gBAAgB,CACjB,CAAC;IAEF,6CAA6C;IAC7C,MAAM,cAAc,GAAG,IAAI,GAAG,EAA6B,CAAC;IAC5D,KAAK,MAAM,EAAE,IAAI,YAAY,EAAE,CAAC;QAC9B,cAAc,CAAC,GAAG,CAAC,EAAE,CAAC,SAAS,EAAE,EAAE,CAAC,CAAC;IACvC,CAAC;IAED,IAAI,CAAC,EAAE,CAAC,CAAC;IACT,IAAI,CACF,SAAS,gBAAgB,CAAC,MAAM,WAAW,gBAAgB,CAAC,MAAM,KAAK,CAAC,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,GAAG,uBAAuB,gBAAgB,CAAC,MAAM,KAAK,CAAC,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,GAAG,GAAG,CACtJ,CAAC;IAEF,KAAK,MAAM,OAAO,IAAI,gBAAgB,EAAE,CAAC;QACvC,MAAM,WAAW,GAAG,cAAc,CAAC,GAAG,CAAC,OAAO,CAAC,MAAM,CAAC,CAAC;QACvD,MAAM,SAAS,GACb,OAAO,CAAC,UAAU,GAAG,CAAC;YACpB,CAAC,CAAC,KAAK,OAAO,CAAC,UAAU,SAAS,OAAO,CAAC,UAAU,KAAK,CAAC,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,KAAK,EAAE;YACzE,CAAC,CAAC,EAAE,CAAC;QAET,IAAI,CAAC,EAAE,CAAC,CAAC;QACT,IAAI,CACF,eAAe,OAAO,CAAC,KAAK,MAAM,OAAO,CAAC,MAAM,CAAC,KAAK,CAAC,CAAC,EAAE,CAAC,CAAC,MAAM,OAAO,CAAC,MAAM,GAAG,SAAS,GAAG,CAChG,CAAC;QAEF,4CAA4C;QAC5C,IAAI,WAAW,IAAI,WAAW,CAAC,UAAU,CAAC,MAAM,GAAG,CAAC,EAAE,CAAC;YACrD,IAAI,CAAC,EAAE,CAAC,CAAC;YACT,IAAI,CAAC,2CAA2C,CAAC,CAAC;YAClD,KAAK,IAAI,CAAC,GAAG,CAAC,EAAE,CAAC,GAAG,WAAW,CAAC,UAAU,CAAC,MAAM,EAAE,CAAC,EAAE,EAAE,CAAC;gBACvD,MAAM,CAAC,GAAG,WAAW,CAAC,UAAU,CAAC,CAAC,CAAC,CAAC;gBACpC,MAAM,MAAM,GAAG,CAAC,KAAK,CAAC,IAAI,WAAW,CAAC,iBAAiB,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,CAAC;gBACpE,IAAI,CACF,OAAO,CAAC,GAAG,CAAC,MAAM,CAAC,CAAC,SAAS,MAAM,CAAC,CAAC,MAAM,CAAC,KAAK,CAAC,CAAC,EAAE,CAAC,CAAC,OAAO,WAAW,CAAC,CAAC,CAAC,KAAK,CAAC,SAAS,MAAM,EAAE,CACpG,CAAC;YACJ,CAAC;YACD,IAAI,CAAC,EAAE,CAAC,CAAC;QACX,CAAC;QAED,kDAAkD;QAClD,IAAI,WAAW,EAAE,iBAAiB,EAAE,CAAC;YACnC,MAAM,GAAG,GAAG,WAAW,CAAC,UAAU,CAAC,CAAC,CAAC,CAAC;YACtC,IAAI,CACF,mCAAmC,GAAG,CAAC,SAAS,MAAM,WAAW,CAAC,GAAG,CAAC,KAAK,CAAC,sBAAsB,CACnG,CAAC;QACJ,CAAC;aAAM,CAAC;YACN,IAAI,CAAC,iDAAiD,CAAC,CAAC;QAC1D,CAAC;QACD,IAAI,CAAC,uDAAuD,CAAC,CAAC;QAC9D,IAAI,CAAC,4BAA4B,CAAC,CAAC;QAEnC,MAAM,MAAM,GAAG,MAAM,MAAM,CAAC,kBAAkB,CAAC,CAAC;QAEhD,QAAQ,MAAM,CAAC,IAAI,EAAE,EAAE,CAAC;YACtB,KAAK,GAAG,CAAC,CAAC,CAAC;gBACT,IAAI,cAAc,CAAC,MAAM,KAAK,CAAC,EAAE,CAAC;oBAChC,IAAI,CAAC,iDAAiD,CAAC,CAAC;oBACxD,WAAW,CAAC,IAAI,CAAC,EAAE,SAAS,EAAE,OAAO,CAAC,MAAM,EAAE,MAAM,EAAE,MAAM,EAAE,CAAC,CAAC;oBAChE,MAAM;gBACR,CAAC;gBAED,wEAAwE;gBACxE,IAAI,WAAW,EAAE,iBAAiB,EAAE,CAAC;oBACnC,MAAM,GAAG,GAAG,WAAW,CAAC,UAAU,CAAC,CAAC,CAAC,CAAC;oBACtC,IAAI,CAAC,EAAE,CAAC,CAAC;oBACT,IAAI,CACF,sBAAsB,GAAG,CAAC,SAAS,MAAM,WAAW,CAAC,GAAG,CAAC,KAAK,CAAC,SAAS,CACzE,CAAC;oBACF,IAAI,CAAC,gCAAgC,CAAC,CAAC;oBACvC,IAAI,CAAC,0BAA0B,CAAC,CAAC;oBAEjC,MAAM,MAAM,GAAG,MAAM,MAAM,CAAC,mBAAmB,CAAC,CAAC;oBAEjD,IAAI,MAAM,CAAC,IAAI,EAAE,CAAC,WAAW,EAAE,KAAK,GAAG,EAAE,CAAC;wBACxC,WAAW,CAAC,IAAI,CAAC;4BACf,SAAS,EAAE,OAAO,CAAC,MAAM;4BACzB,MAAM,EAAE,WAAW;4BACnB,YAAY,EAAE,GAAG,CAAC,MAAM;yBACzB,CAAC,CAAC;wBACH,IAAI,CAAC,wBAAwB,GAAG,CAAC,SAAS,GAAG,CAAC,CAAC;wBAC/C,MAAM;oBACR,CAAC;gBACH,CAAC;gBAED,mEAAmE;gBACnE,IAAI,CAAC,EAAE,CAAC,CAAC;gBACT,IAAI,CAAC,oBAAoB,CAAC,CAAC;gBAC3B,MAAM,SAAS,GAAG,qBAAqB,CACrC,cAAc,EACd,WAAW,CACZ,CAAC;gBACF,KAAK,IAAI,CAAC,GAAG,CAAC,EAAE,CAAC,GAAG,SAAS,CAAC,MAAM,EAAE,CAAC,EAAE,EAAE,CAAC;oBAC1C,MAAM,IAAI,GAAG,SAAS,CAAC,CAAC,CAAC,CAAC;oBAC1B,MAAM,UAAU,GAAG,IAAI,CAAC,KAAK,KAAK,SAAS;wBACzC,CAAC,CAAC,MAAM,WAAW,CAAC,IAAI,CAAC,KAAK,CAAC,QAAQ;wBACvC,CAAC,CAAC,EAAE,CAAC;oBACP,IAAI,CACF,QAAQ,CAAC,GAAG,CAAC,MAAM,IAAI,CAAC,KAAK,MAAM,IAAI,CAAC,EAAE,CAAC,KAAK,CAAC,CAAC,EAAE,CAAC,CAAC,IAAI,UAAU,EAAE,CACvE,CAAC;gBACJ,CAAC;gBAED,MAAM,UAAU,GAAG,MAAM,MAAM,CAC7B,+BAA+B,SAAS,CAAC,MAAM,KAAK,CACrD,CAAC;gBACF,MAAM,OAAO,GAAG,QAAQ,CAAC,UAAU,CAAC,IAAI,EAAE,EAAE,EAAE,CAAC,GAAG,CAAC,CAAC;gBAEpD,IAAI,OAAO,IAAI,CAAC,IAAI,OAAO,GAAG,SAAS,CAAC,MAAM,EAAE,CAAC;oBAC/C,WAAW,CAAC,IAAI,CAAC;wBACf,SAAS,EAAE,OAAO,CAAC,MAAM;wBACzB,MAAM,EAAE,WAAW;wBACnB,YAAY,EAAE,SAAS,CAAC,OAAO,CAAC,CAAC,EAAE;qBACpC,CAAC,CAAC;oBACH,IAAI,CAAC,wBAAwB,SAAS,CAAC,OAAO,CAAC,CAAC,KAAK,GAAG,CAAC,CAAC;gBAC5D,CAAC;qBAAM,CAAC;oBACN,IAAI,CAAC,qCAAqC,CAAC,CAAC;oBAC5C,WAAW,CAAC,IAAI,CAAC,EAAE,SAAS,EAAE,OAAO,CAAC,MAAM,EAAE,MAAM,EAAE,MAAM,EAAE,CAAC,CAAC;gBAClE,CAAC;gBACD,MAAM;YACR,CAAC;YAED,KAAK,GAAG,CAAC,CAAC,CAAC;gBACT,sDAAsD;gBACtD,MAAM,QAAQ,GAAG,uBAAuB,CAAC,GAAG,CAAC,KAAK,EAAE,OAAO,CAAC,MAAM,CAAC,CAAC;gBAEpE,IAAI,CAAC,QAAQ,CAAC,IAAI,EAAE,CAAC;oBACnB,IAAI,CAAC,EAAE,CAAC,CAAC;oBACT,IAAI,CAAC,yBAAyB,CAAC,CAAC;oBAChC,KAAK,MAAM,CAAC,IAAI,QAAQ,CAAC,QAAQ,EAAE,CAAC;wBAClC,IAAI,CAAC,SAAS,CAAC,EAAE,CAAC,CAAC;oBACrB,CAAC;oBACD,IAAI,CAAC,EAAE,CAAC,CAAC;oBACT,IAAI,CAAC,oCAAoC,QAAQ,CAAC,YAAY,QAAQ,QAAQ,CAAC,YAAY,KAAK,CAAC,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,GAAG,GAAG,CAAC,CAAC;oBACjH,IAAI,CAAC,0BAA0B,CAAC,CAAC;oBACjC,IAAI,CAAC,+BAA+B,CAAC,CAAC;oBAEtC,MAAM,OAAO,GAAG,MAAM,MAAM,CAAC,oBAAoB,CAAC,CAAC;oBACnD,IAAI,OAAO,CAAC,IAAI,EAAE,CAAC,WAAW,EAAE,KAAK,GAAG,EAAE,CAAC;wBACzC,WAAW,CAAC,IAAI,CAAC,EAAE,SAAS,EAAE,OAAO,CAAC,MAAM,EAAE,MAAM,EAAE,MAAM,EAAE,CAAC,CAAC;wBAChE,IAAI,CAAC,kCAAkC,CAAC,CAAC;wBACzC,MAAM;oBACR,CAAC;gBACH,CAAC;qBAAM,CAAC;oBACN,IAAI,CACF,gBAAgB,QAAQ,CAAC,YAAY,QAAQ,QAAQ,CAAC,YAAY,KAAK,CAAC,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,GAAG,iDAAiD,CACrI,CAAC;gBACJ,CAAC;gBAED,WAAW,CAAC,IAAI,CAAC,EAAE,SAAS,EAAE,OAAO,CAAC,MAAM,EAAE,MAAM,EAAE,QAAQ,EAAE,CAAC,CAAC;gBAClE,IAAI,CAAC,yBAAyB,CAAC,CAAC;gBAChC,MAAM;YACR,CAAC;YAED,KAAK,GAAG;gBACN,WAAW,CAAC,IAAI,CAAC,EAAE,SAAS,EAAE,OAAO,CAAC,MAAM,EAAE,MAAM,EAAE,MAAM,EAAE,CAAC,CAAC;gBAChE,IAAI,CAAC,aAAa,CAAC,CAAC;gBACpB,MAAM;YAER;gBACE,IAAI,CAAC,6BAA6B,CAAC,CAAC;gBACpC,WAAW,CAAC,IAAI,CAAC,EAAE,SAAS,EAAE,OAAO,CAAC,MAAM,EAAE,MAAM,EAAE,MAAM,EAAE,CAAC,CAAC;gBAChE,MAAM;QACV,CAAC;IACH,CAAC;IAED,OAAO,WAAW,CAAC;AACrB,CAAC;AAUD;;;;GAIG;AACH,SAAS,qBAAqB,CAC5B,cAA+C,EAC/C,WAA0C;IAE1C,IAAI,CAAC,WAAW,IAAI,WAAW,CAAC,UAAU,CAAC,MAAM,KAAK,CAAC,EAAE,CAAC;QACxD,OAAO,cAAc,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,EAAE,EAAE,EAAE,CAAC,CAAC,EAAE,EAAE,KAAK,EAAE,CAAC,CAAC,KAAK,EAAE,CAAC,CAAC,CAAC;IACnE,CAAC;IAED,MAAM,QAAQ,GAAG,IAAI,GAAG,EAAkB,CAAC;IAC3C,KAAK,MAAM,CAAC,IAAI,WAAW,CAAC,UAAU,EAAE,CAAC;QACvC,QAAQ,CAAC,GAAG,CAAC,CAAC,CAAC,MAAM,EAAE,CAAC,CAAC,KAAK,CAAC,CAAC;IAClC,CAAC;IAED,MAAM,MAAM,GAAuB,EAAE,CAAC;IACtC,MAAM,QAAQ,GAAuB,EAAE,CAAC;IAExC,KAAK,MAAM,IAAI,IAAI,cAAc,EAAE,CAAC;QAClC,MAAM,CAAC,GAAG,QAAQ,CAAC,GAAG,CAAC,IAAI,CAAC,EAAE,CAAC,CAAC;QAChC,IAAI,CAAC,KAAK,SAAS,EAAE,CAAC;YACpB,MAAM,CAAC,IAAI,CAAC,EAAE,EAAE,EAAE,IAAI,CAAC,EAAE,EAAE,KAAK,EAAE,IAAI,CAAC,KAAK,EAAE,KAAK,EAAE,CAAC,EAAE,CAAC,CAAC;QAC5D,CAAC;aAAM,CAAC;YACN,QAAQ,CAAC,IAAI,CAAC,EAAE,EAAE,EAAE,IAAI,CAAC,EAAE,EAAE,KAAK,EAAE,IAAI,CAAC,KAAK,EAAE,CAAC,CAAC;QACpD,CAAC;IACH,CAAC;IAED,wCAAwC;IACxC,MAAM,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,CAAC,KAAK,IAAI,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC,KAAK,IAAI,CAAC,CAAC,CAAC,CAAC;IAEvD,OAAO,CAAC,GAAG,MAAM,EAAE,GAAG,QAAQ,CAAC,CAAC;AAClC,CAAC;AAED,gFAAgF;AAEhF;;;;;;;;;GASG;AACH,MAAM,UAAU,wBAAwB,CACtC,GAAgB,EAChB,WAAiC;IAEjC,IAAI,OAAO,GAAG,CAAC,CAAC;IAEhB,KAAK,MAAM,UAAU,IAAI,WAAW,EAAE,CAAC;QACrC,IAAI,UAAU,CAAC,MAAM,KAAK,MAAM;YAAE,SAAS;QAE3C,IAAI,UAAU,CAAC,MAAM,KAAK,WAAW,IAAI,UAAU,CAAC,YAAY,EAAE,CAAC;YACjE,MAAM,OAAO,GAAG,cAAc,CAAC,GAAG,CAAC,KAAK,EAAE,UAAU,CAAC,SAAS,CAAC,CAAC;YAChE,IAAI,OAAO,EAAE,CAAC;gBACZ,MAAM,QAAQ,GAAG,WAAW,CAC1B,GAAG,CAAC,KAAK,EACT,UAAU,CAAC,YAAY,EACvB,OAAO,CACR,CAAC;gBACF,IAAI,QAAQ,EAAE,CAAC;oBACb,OAAO,EAAE,CAAC;gBACZ,CAAC;qBAAM,CAAC;oBACN,uEAAuE;oBACvE,GAAG,CAAC,KAAK,CAAC,IAAI,CAAC,OAAO,CAAC,CAAC;gBAC1B,CAAC;YACH,CAAC;QACH,CAAC;QAED,IAAI,UAAU,CAAC,MAAM,KAAK,QAAQ,EAAE,CAAC;YACnC,MAAM,MAAM,GAAG,aAAa,CAAC,GAAG,CAAC,KAAK,EAAE,UAAU,CAAC,SAAS,CAAC,CAAC;YAC9D,IAAI,MAAM,CAAC,EAAE,EAAE,CAAC;gBACd,OAAO,EAAE,CAAC;YACZ,CAAC;QACH,CAAC;IACH,CAAC;IAED,OAAO,OAAO,CAAC;AACjB,CAAC;AAED,gFAAgF;AAEhF,KAAK,UAAU,aAAa,CAAC,QAAgB;IAC3C,MAAM,QAAQ,GAAG,MAAM,MAAM,CAAC,eAAe,CAAC,CAAC;IAC/C,MAAM,EAAE,GAAG,QAAQ,CAAC,eAAe,CAAC;QAClC,KAAK,EAAE,OAAO,CAAC,KAAK;QACpB,MAAM,EAAE,OAAO,CAAC,MAAM;KACvB,CAAC,CAAC;IAEH,MAAM,MAAM,GAAG,MAAM,IAAI,OAAO,CAAS,CAAC,OAAO,EAAE,EAAE,CACnD,EAAE,CAAC,QAAQ,CAAC,QAAQ,EAAE,OAAO,CAAC,CAC/B,CAAC;IACF,EAAE,CAAC,KAAK,EAAE,CAAC;IACX,OAAO,MAAM,CAAC;AAChB,CAAC"}

package/packages/rex/dist/cli/commands/validate.d.ts

@@ -0,0 +1,10 @@
+import type { PromptFn } from "./validate-interactive.js";
+/**
+ * Options for interactive validation behavior.
+ * @internal Exposed for testability — production callers use flags only.
+ */
+export interface ValidateOptions {
+    /** Injectable prompt function for interactive resolution. */
+    prompt?: PromptFn;
+}
+export declare function cmdValidate(dir: string, flags: Record<string, string>, options?: ValidateOptions): Promise<void>;