@hominis/fireforge 0.54.0 → 0.60.0

package/dist/src/commands/furnace/status.js

@@ -1,209 +0,0 @@
-// SPDX-License-Identifier: EUPL-1.2
-import { join } from 'node:path';
-import { getProjectPaths, loadConfig } from '../../core/config.js';
-import { extractComponentChecksums, hasComponentChanged, hasCustomEngineDrift, hasOverrideEngineDrift, } from '../../core/furnace-apply-helpers.js';
-import { furnaceConfigExists, getFurnacePaths, loadFurnaceConfig, loadFurnaceState, } from '../../core/furnace-config.js';
-import { resolveFtlDir } from '../../core/furnace-constants.js';
-import { checkRegistrationConsistency } from '../../core/furnace-validate-checks.js';
-import { findOverrideBaseVersionDrift, formatOverrideBaseVersionDriftWarning, } from '../../core/furnace-version-drift.js';
-import { FurnaceError } from '../../errors/furnace.js';
-import { pathExists } from '../../utils/fs.js';
-import { info, intro, note, outro, warn } from '../../utils/logger.js';
-/**
- * Displays detailed status for a single Furnace component, including registration drift.
- * @param options - See {@link DetailedComponentStatusOptions}
- */
-async function showDetailedComponentStatus(options) {
-    const { name, config, state, projectRoot, paths, furnacePaths, ftlDir } = options;
-    const customConfig = config.custom[name];
-    const overrideConfig = config.overrides[name];
-    if (!customConfig && !overrideConfig && !config.stock.includes(name)) {
-        throw new FurnaceError(`Component "${name}" not found in furnace.json.`, name);
-    }
-    if (overrideConfig) {
-        info(`"${name}" is an override component (${overrideConfig.type}).`);
-        info(`Base path: ${overrideConfig.basePath}`);
-        info(`Base version: ${overrideConfig.baseVersion}`);
-        // baseVersion drift is advisory but reported here alongside the other
-        // override metadata so the operator sees the warning before drilling
-        // into registration drift or file diff.
-        const forgeConfig = await loadConfig(projectRoot);
-        const scopedDrift = findOverrideBaseVersionDrift(config, forgeConfig.firefox.version).filter((entry) => entry.name === name);
-        for (const entry of scopedDrift) {
-            warn(formatOverrideBaseVersionDriftWarning(entry));
-        }
-        const overrideDir = join(furnacePaths.overridesDir, name);
-        const sourceExists = await pathExists(overrideDir);
-        const lines = [`${sourceExists ? '\u2713' : '\u2717'} Override directory exists`];
-        if (!sourceExists) {
-            lines.push('\u2717 Workspace status unavailable (override directory missing)');
-            lines.push('\u2717 Engine comparison unavailable (override directory missing)');
-            note(lines.join('\n'), `${name} Override Status`);
-            outro('Status complete');
-            return;
-        }
-        const previous = extractComponentChecksums(state.appliedChecksums, 'override', name);
-        const workspaceChanged = await hasComponentChanged(overrideDir, previous);
-        lines.push(`${workspaceChanged ? '\u2717' : '\u2713'} Workspace unchanged since last apply`);
-        const engineExists = await pathExists(paths.engine);
-        if (!engineExists) {
-            lines.push('\u2717 Engine comparison unavailable (engine directory missing)');
-            note(lines.join('\n'), `${name} Override Status`);
-            outro('Status complete');
-            return;
-        }
-        const engineDrifted = await hasOverrideEngineDrift({ engineDir: paths.engine, componentDir: overrideDir, ftlDir }, overrideConfig);
-        lines.push(`${engineDrifted ? '\u2717' : '\u2713'} Engine matches override workspace`);
-        note(lines.join('\n'), `${name} Override Status`);
-        outro('Status complete');
-        return;
-    }
-    if (config.stock.includes(name)) {
-        info(`"${name}" is a stock component. No local registration to check.`);
-        outro('Status complete');
-        return;
-    }
-    if (!customConfig) {
-        outro('Status complete');
-        return;
-    }
-    // Custom component: run registration consistency check
-    const status = await checkRegistrationConsistency(projectRoot, name, customConfig, ftlDir);
-    const lines = [];
-    const check = (ok, label) => {
-        lines.push(`${ok ? '\u2713' : '\u2717'} ${label}`);
-    };
-    check(status.sourceExists, 'Source directory exists');
-    check(status.targetExists, 'Target directory exists in engine');
-    check(status.filesInSync, 'Source and target files in sync');
-    check(status.jarMnMjs, `jar.mn has ${name}.mjs entry`);
-    check(status.jarMnCss, `jar.mn has ${name}.css entry`);
-    check(status.customElementsPresent, 'Registered in customElements.js');
-    check(status.customElementsCorrectBlock, 'In correct DOMContentLoaded block');
-    if (status.driftedFiles.length > 0) {
-        lines.push(`Drifted files: ${status.driftedFiles.join(', ')}`);
-    }
-    if (status.missingTargetFiles.length > 0) {
-        lines.push(`Missing in engine: ${status.missingTargetFiles.join(', ')}`);
-    }
-    note(lines.join('\n'), `${name} Registration Status`);
-    outro('Status complete');
-}
-/**
- * Runs the furnace status command to show an overview of Furnace state.
- * When a component name is provided, shows detailed registration status.
- * @param projectRoot - Root directory of the project
- * @param name - Optional component name for detailed status
- */
-export async function furnaceStatusCommand(projectRoot, name) {
-    intro('Furnace');
-    if (!(await furnaceConfigExists(projectRoot))) {
-        info('Furnace is not configured. Run `fireforge furnace create` or `fireforge furnace override` to get started.');
-        outro('');
-        return;
-    }
-    const config = await loadFurnaceConfig(projectRoot);
-    const state = await loadFurnaceState(projectRoot);
-    const paths = getProjectPaths(projectRoot);
-    const furnacePaths = getFurnacePaths(projectRoot);
-    const ftlDir = resolveFtlDir(config.ftlBasePath);
-    if (name) {
-        await showDetailedComponentStatus({
-            name,
-            config,
-            state,
-            projectRoot,
-            paths,
-            furnacePaths,
-            ftlDir,
-        });
-        return;
-    }
-    // Surface a pendingRepair marker before the normal summary so it cannot
-    // be missed. The marker means the last mutation could not roll back
-    // cleanly, so the engine and workspace may have drifted in ways apply
-    // cannot detect from checksums alone, so doctor is the right next step.
-    if (state.pendingRepair) {
-        warn(`Furnace is in pending-repair state from ${state.pendingRepair.operation} (${state.pendingRepair.timestamp}): ${state.pendingRepair.reason}. Run \`fireforge doctor --repair-furnace\` to reconcile.`);
-    }
-    // --- Overview mode ---
-    const overrideCount = Object.keys(config.overrides).length;
-    const customCount = Object.keys(config.custom).length;
-    const stockCount = config.stock.length;
-    // Build summary lines
-    const lines = [];
-    lines.push(`Component prefix: ${config.componentPrefix || '(none)'}`);
-    lines.push(`Stock components: ${stockCount}`);
-    // Overrides
-    lines.push(`Override components: ${overrideCount}`);
-    if (overrideCount > 0) {
-        for (const [oName, entry] of Object.entries(config.overrides)) {
-            lines.push(`  ${oName} (${entry.type})`);
-        }
-    }
-    // Custom
-    lines.push(`Custom components: ${customCount}`);
-    if (customCount > 0) {
-        for (const cName of Object.keys(config.custom)) {
-            lines.push(`  ${cName}`);
-        }
-    }
-    // Last apply
-    lines.push(`Last apply: ${state.lastApply ?? 'never'}`);
-    note(lines.join('\n'), 'Furnace Status');
-    // Surface override baseVersion drift from the project config. This check
-    // is cheap (no I/O besides the already-loaded fireforge.json) and catches
-    // the single most common silent-drift case: Firefox bumped, overrides
-    // still point at the old version. Advisory only. Status never fails.
-    const forgeConfig = await loadConfig(projectRoot);
-    for (const entry of findOverrideBaseVersionDrift(config, forgeConfig.firefox.version)) {
-        warn(formatOverrideBaseVersionDriftWarning(entry));
-    }
-    // Check for both workspace changes (developer edits) and engine drift
-    // (reset/download/manual edits). The two have different remediation
-    // hints, so report them separately rather than collapsing into a single
-    // "something is off" message.
-    if (await pathExists(paths.engine)) {
-        // Held in an object rather than two `let`s: the scanner below mutates
-        // them from inside a closure, and TS's control-flow analysis does not
-        // propagate that through the call. It would narrow both to the literal
-        // `false` and flag every later read as always-falsy.
-        const drift = { workspaceChanged: false, engineDrifted: false };
-        /**
-         * Scans one component family for workspace or engine drift.
-         *
-         * The engine probe sits behind `else if` on purpose: a component whose
-         * workspace already changed does not need an engine comparison to decide
-         * what `status` reports, and the probe is the expensive half (it
-         * re-hashes deployed files). The consequence is that engine drift goes
-         * unreported for a component that also has workspace changes. The
-         * summary says "workspace changed", not both.
-         */
-        const scanFamily = async (entries, baseDir, kind, probeEngineDrift) => {
-            for (const [componentName, componentConfig] of entries) {
-                if (drift.workspaceChanged && drift.engineDrifted)
-                    return;
-                const componentDir = join(baseDir, componentName);
-                if (!(await pathExists(componentDir)))
-                    continue;
-                const previous = extractComponentChecksums(state.appliedChecksums, kind, componentName);
-                if (await hasComponentChanged(componentDir, previous)) {
-                    drift.workspaceChanged = true;
-                }
-                else if (await probeEngineDrift(componentName, componentDir, componentConfig)) {
-                    drift.engineDrifted = true;
-                }
-            }
-        };
-        await scanFamily(Object.entries(config.overrides), furnacePaths.overridesDir, 'override', (_name, componentDir, cfg) => hasOverrideEngineDrift({ engineDir: paths.engine, componentDir, ftlDir }, cfg));
-        await scanFamily(Object.entries(config.custom), furnacePaths.customDir, 'custom', (name, componentDir, cfg) => hasCustomEngineDrift({ root: projectRoot, name, componentDir, ftlDir }, cfg));
-        if (drift.workspaceChanged) {
-            warn('Components have been modified since last apply. Run `fireforge build` or `fireforge furnace apply`.');
-        }
-        if (drift.engineDrifted) {
-            warn('Engine drift detected since last apply (reset/download/manual edit). Run `fireforge furnace apply` to re-deploy.');
-        }
-    }
-    info('Tip: run `fireforge furnace status <name>` for detailed component info, or `fireforge furnace --help` for all subcommands.');
-    outro('Status complete');
-}

package/dist/src/commands/furnace/sync.d.ts

@@ -1,12 +0,0 @@
-import type { FurnaceSyncOptions } from '../../types/commands/index.js';
-/**
- * Runs the furnace sync command: detects overrides with baseVersion drift,
- * refreshes them (three-way merge), and re-applies all components.
- *
- * This is the recommended single command to run after `fireforge download`
- * updates the Firefox source.
- *
- * @param projectRoot - Root directory of the project
- * @param options - Sync options
- */
-export declare function furnaceSyncCommand(projectRoot: string, options?: FurnaceSyncOptions): Promise<void>;

package/dist/src/commands/furnace/sync.js

@@ -1,145 +0,0 @@
-// SPDX-License-Identifier: EUPL-1.2
-import { readdir } from 'node:fs/promises';
-import { join } from 'node:path';
-import { loadConfig } from '../../core/config.js';
-import { applyAllComponents } from '../../core/furnace-apply.js';
-import { formatSkipBreakdown, logApplyResult } from '../../core/furnace-apply-output.js';
-import { getFurnacePaths, loadFurnaceConfig } from '../../core/furnace-config.js';
-import { reportJsconfigPathsSync } from '../../core/furnace-jsconfig.js';
-import { runFurnaceMutation, waitLockMutationOptions } from '../../core/furnace-operation.js';
-import { assertFurnaceReady } from '../../core/furnace-precondition.js';
-import { countEntriesWithBlockingStepErrors } from '../../core/furnace-step-errors.js';
-import { containsMergeConflictMarkers } from '../../core/furnace-validate-structure.js';
-import { findOverrideBaseVersionDrift, formatOverrideBaseVersionDriftWarning, } from '../../core/furnace-version-drift.js';
-import { FurnaceError } from '../../errors/furnace.js';
-import { pathExists, readText } from '../../utils/fs.js';
-import { info, intro, outro, spinner, warn } from '../../utils/logger.js';
-import { furnaceRefreshCommand } from './refresh.js';
-/**
- * Scans every configured override/custom component workspace for files
- * carrying unresolved merge conflict markers. Returns the component names
- * (sorted, unique) that must be resolved before an apply may run.
- */
-async function findComponentsWithConflictMarkers(furnacePaths, config) {
-    const conflicted = new Set();
-    const componentDirs = [
-        ...Object.keys(config.overrides).map((name) => ({
-            name,
-            dir: join(furnacePaths.overridesDir, name),
-        })),
-        ...Object.keys(config.custom).map((name) => ({
-            name,
-            dir: join(furnacePaths.customDir, name),
-        })),
-    ];
-    for (const { name, dir } of componentDirs) {
-        if (!(await pathExists(dir)))
-            continue;
-        const entries = await readdir(dir, { withFileTypes: true });
-        for (const entry of entries) {
-            if (!entry.isFile())
-                continue;
-            if (!entry.name.endsWith('.mjs') &&
-                !entry.name.endsWith('.css') &&
-                !entry.name.endsWith('.ftl')) {
-                continue;
-            }
-            if (containsMergeConflictMarkers(await readText(join(dir, entry.name)))) {
-                conflicted.add(name);
-                break;
-            }
-        }
-    }
-    return [...conflicted].sort();
-}
-/**
- * Runs the furnace sync command: detects overrides with baseVersion drift,
- * refreshes them (three-way merge), and re-applies all components.
- *
- * This is the recommended single command to run after `fireforge download`
- * updates the Firefox source.
- *
- * @param projectRoot - Root directory of the project
- * @param options - Sync options
- */
-export async function furnaceSyncCommand(projectRoot, options = {}) {
-    intro('Furnace Sync');
-    const { config } = await assertFurnaceReady(projectRoot);
-    const forgeConfig = await loadConfig(projectRoot);
-    const overrideCount = Object.keys(config.overrides).length;
-    const customCount = Object.keys(config.custom).length;
-    if (overrideCount === 0 && customCount === 0) {
-        info('No components to sync.');
-        outro('Done');
-        return;
-    }
-    // Phase 1: Detect and report baseVersion drift
-    const driftEntries = findOverrideBaseVersionDrift(config, forgeConfig.firefox.version);
-    if (driftEntries.length > 0) {
-        info(`Found ${driftEntries.length} override(s) with baseVersion drift:`);
-        for (const entry of driftEntries) {
-            warn(formatOverrideBaseVersionDriftWarning(entry));
-        }
-        // Phase 2: Refresh drifted overrides via three-way merge
-        info('\nRefreshing drifted overrides...');
-        await furnaceRefreshCommand(projectRoot, undefined, {
-            all: true,
-            ...(options.dryRun !== undefined ? { dryRun: options.dryRun } : {}),
-            ...(options.strategy !== undefined ? { strategy: options.strategy } : {}),
-        });
-    }
-    else {
-        info('All overrides are up-to-date with the current Firefox version.');
-    }
-    // Phase 2.5: post-refresh gates. Refresh leaves conflict markers in
-    // workspace files and does not bump baseVersion on conflict, so without
-    // this gate sync warns about conflicts and then copies the marker-laden
-    // files straight into the engine via Phase 3, producing a broken build
-    // from the one command meant to make an upgrade safe.
-    // Apply and deploy both enforce a drift gate. Sync must not be the back
-    // door around it.
-    if (!options.dryRun) {
-        const refreshedConfig = await loadFurnaceConfig(projectRoot);
-        const furnacePaths = getFurnacePaths(projectRoot);
-        const conflicted = await findComponentsWithConflictMarkers(furnacePaths, refreshedConfig);
-        const remainingDrift = findOverrideBaseVersionDrift(refreshedConfig, forgeConfig.firefox.version);
-        if (conflicted.length > 0 || remainingDrift.length > 0) {
-            if (conflicted.length > 0) {
-                warn(`Unresolved merge conflicts in: ${conflicted.join(', ')}`);
-            }
-            for (const entry of remainingDrift) {
-                warn(formatOverrideBaseVersionDriftWarning(entry));
-            }
-            throw new FurnaceError('Sync stopped before applying: ' +
-                (conflicted.length > 0
-                    ? `${conflicted.length} component(s) contain unresolved merge conflict markers` +
-                        (remainingDrift.length > 0 ? ' and ' : '')
-                    : '') +
-                (remainingDrift.length > 0
-                    ? `${remainingDrift.length} override(s) still have baseVersion drift`
-                    : '') +
-                '. Resolve the conflicts in the component workspace files, re-run ' +
-                '"fireforge furnace refresh <name>" to update baseVersion, then run ' +
-                '"fireforge furnace sync" again. Nothing was applied to the engine.');
-        }
-    }
-    // Phase 3: Re-apply all components to the engine
-    if (!options.dryRun) {
-        info('\nApplying all components to engine...');
-        const applySpinner = spinner('Applying components...');
-        const result = await runFurnaceMutation(projectRoot, 'apply-rollback', (ctx) => applyAllComponents(projectRoot, false, { operationContext: ctx }), { dryRun: false, ...waitLockMutationOptions(options.waitLockSeconds) });
-        applySpinner.stop('Components applied');
-        logApplyResult(result, false);
-        const appliedWithStepErrorsCount = countEntriesWithBlockingStepErrors(result.applied);
-        const totalFailures = result.errors.length + appliedWithStepErrorsCount;
-        if (totalFailures > 0) {
-            throw new FurnaceError(`${totalFailures} component${totalFailures === 1 ? '' : 's'} failed to apply cleanly`);
-        }
-        await reportJsconfigPathsSync(projectRoot, config, false);
-        outro(`Sync complete — ${result.applied.length} applied, ${result.skipped.length} skipped` +
-            formatSkipBreakdown(result.skipped));
-    }
-    else {
-        outro('Dry run complete');
-    }
-}

package/dist/src/commands/furnace/test-file-name.d.ts

@@ -1,28 +0,0 @@
-/**
- * Derives the underscored stem a component's generated test files are named
- * after.
- *
- * Five modules (`create-browser-test`, `create-dry-run`, `remove`, `rename`,
- * `rename-browser-test`) had each inlined this three-step transform. The steps
- * are not arbitrary and must agree exactly, or `furnace rename` and
- * `furnace remove` compute a different filename than `furnace create` wrote
- * and silently leave the old test behind:
- *
- * 1. drop the upstream `moz-` custom-element prefix, which never appears in a
- *    test filename.
- * 2. drop a leading `<binaryName>-`, because the test directory is already
- *    named after the binary and the prefix would be doubled.
- * 3. underscore the remaining dashes, matching mozilla-central's
- *    `browser_*.js` convention.
- * @param componentName - Custom-element name, e.g. `moz-mybrowser-sidebar`.
- * @param binaryName - Configured binary name, e.g. `mybrowser`.
- * @returns The stem, e.g. `sidebar`.
- */
-export declare function deriveTestStem(componentName: string, binaryName: string): string;
-/**
- * Builds the browser-chrome test filename for a component.
- * @param componentName - Custom-element name.
- * @param binaryName - Configured binary name.
- * @returns The filename, e.g. `browser_mybrowser_sidebar.js`.
- */
-export declare function browserTestFileName(componentName: string, binaryName: string): string;

package/dist/src/commands/furnace/test-file-name.js

@@ -1,39 +0,0 @@
-// SPDX-License-Identifier: EUPL-1.2
-/**
- * Derives the underscored stem a component's generated test files are named
- * after.
- *
- * Five modules (`create-browser-test`, `create-dry-run`, `remove`, `rename`,
- * `rename-browser-test`) had each inlined this three-step transform. The steps
- * are not arbitrary and must agree exactly, or `furnace rename` and
- * `furnace remove` compute a different filename than `furnace create` wrote
- * and silently leave the old test behind:
- *
- * 1. drop the upstream `moz-` custom-element prefix, which never appears in a
- *    test filename.
- * 2. drop a leading `<binaryName>-`, because the test directory is already
- *    named after the binary and the prefix would be doubled.
- * 3. underscore the remaining dashes, matching mozilla-central's
- *    `browser_*.js` convention.
- * @param componentName - Custom-element name, e.g. `moz-mybrowser-sidebar`.
- * @param binaryName - Configured binary name, e.g. `mybrowser`.
- * @returns The stem, e.g. `sidebar`.
- */
-export function deriveTestStem(componentName, binaryName) {
-    const withoutMozPrefix = componentName.startsWith('moz-')
-        ? componentName.slice(4)
-        : componentName;
-    const withoutBinaryPrefix = withoutMozPrefix.startsWith(`${binaryName}-`)
-        ? withoutMozPrefix.slice(binaryName.length + 1)
-        : withoutMozPrefix;
-    return withoutBinaryPrefix.replace(/-/g, '_');
-}
-/**
- * Builds the browser-chrome test filename for a component.
- * @param componentName - Custom-element name.
- * @param binaryName - Configured binary name.
- * @returns The filename, e.g. `browser_mybrowser_sidebar.js`.
- */
-export function browserTestFileName(componentName, binaryName) {
-    return `browser_${binaryName}_${deriveTestStem(componentName, binaryName)}.js`;
-}

package/dist/src/commands/furnace/validate-report.d.ts

@@ -1,45 +0,0 @@
-/**
- * `furnace validate` result rendering: the human per-component lines and
- * the `--json` document (schemaVersion 1, docs/machine-output.md), plus
- * the verdict both share, so the exit code and the `passed` key can never
- * disagree.
- */
-import { type ValidationExceptionOutcome } from '../../core/furnace-validate-exceptions.js';
-import type { ValidationIssue } from '../../types/furnace.js';
-/** One finished `furnace validate` run. */
-export interface FurnaceValidateReport {
-    /** Components the run judged, in validation order. */
-    components: string[];
-    /** Findings after `validationExceptions` were applied. */
-    outcome: ValidationExceptionOutcome;
-    /** `--max-warnings`, when given. */
-    maxWarnings?: number | undefined;
-}
-/** The verdict: counts, and whether errors or the warning budget fail it. */
-export interface FurnaceValidateVerdict {
-    errors: number;
-    warnings: number;
-    /** True when `--max-warnings` was given and the warnings exceed it. */
-    warningBudgetExceeded: boolean;
-    passed: boolean;
-}
-/** Computes the verdict both renderings report. */
-export declare function judgeValidateReport(report: FurnaceValidateReport): FurnaceValidateVerdict;
-/**
- * Prints one line per clean component and every finding of the rest.
- * Findings on names outside `components` (a stale exception for a removed
- * component, an orphaned scaffold) print after them.
- */
-export declare function renderValidateHuman(components: readonly string[], issues: readonly ValidationIssue[]): void;
-/**
- * Writes the `--json` document and seals stdout. Every finding is listed
- * once in `issues` (stale-exception warnings included); `excepted` and
- * `staleExceptions` restate the exception bookkeeping for a consumer that
- * audits the list itself.
- */
-export declare function renderValidateJson(report: FurnaceValidateReport): void;
-/**
- * Parses `--max-warnings <n>`: a non-negative integer, or undefined when
- * the flag was not given.
- */
-export declare function parseMaxWarnings(raw: string | undefined): number | undefined;

package/dist/src/commands/furnace/validate-report.js

@@ -1,91 +0,0 @@
-// SPDX-License-Identifier: EUPL-1.2
-/**
- * `furnace validate` result rendering: the human per-component lines and
- * the `--json` document (schemaVersion 1, docs/machine-output.md), plus
- * the verdict both share, so the exit code and the `passed` key can never
- * disagree.
- */
-import { countValidationSeverities, } from '../../core/furnace-validate-exceptions.js';
-import { InvalidArgumentError } from '../../errors/base.js';
-import { setStdoutSealed, success } from '../../utils/logger.js';
-import { displayValidationIssues } from './validation-output.js';
-/** Computes the verdict both renderings report. */
-export function judgeValidateReport(report) {
-    const { errors, warnings } = countValidationSeverities(report.outcome.issues);
-    const warningBudgetExceeded = report.maxWarnings !== undefined && warnings > report.maxWarnings;
-    return {
-        errors,
-        warnings,
-        warningBudgetExceeded,
-        passed: errors === 0 && !warningBudgetExceeded,
-    };
-}
-/** Groups findings by component, keeping the report's component order first. */
-function groupByComponent(components, issues) {
-    const grouped = new Map(components.map((name) => [name, []]));
-    for (const issue of issues) {
-        const list = grouped.get(issue.component) ?? [];
-        list.push(issue);
-        grouped.set(issue.component, list);
-    }
-    return grouped;
-}
-/**
- * Prints one line per clean component and every finding of the rest.
- * Findings on names outside `components` (a stale exception for a removed
- * component, an orphaned scaffold) print after them.
- */
-export function renderValidateHuman(components, issues) {
-    for (const [name, componentIssues] of groupByComponent(components, issues)) {
-        if (componentIssues.length === 0) {
-            success(`${name} — all checks passed`);
-        }
-        else {
-            displayValidationIssues(componentIssues);
-        }
-    }
-}
-/**
- * Writes the `--json` document and seals stdout. Every finding is listed
- * once in `issues` (stale-exception warnings included); `excepted` and
- * `staleExceptions` restate the exception bookkeeping for a consumer that
- * audits the list itself.
- */
-export function renderValidateJson(report) {
-    const verdict = judgeValidateReport(report);
-    const grouped = groupByComponent(report.components, report.outcome.issues);
-    const payload = {
-        schemaVersion: 1,
-        passed: verdict.passed,
-        summary: {
-            components: report.components.length,
-            errors: verdict.errors,
-            warnings: verdict.warnings,
-            excepted: report.outcome.excepted.length,
-            staleExceptions: report.outcome.stale.length,
-        },
-        ...(report.maxWarnings !== undefined ? { maxWarnings: report.maxWarnings } : {}),
-        components: report.components.map((name) => ({
-            name,
-            ...countValidationSeverities(grouped.get(name) ?? []),
-        })),
-        issues: report.outcome.issues,
-        excepted: report.outcome.excepted,
-        staleExceptions: report.outcome.stale,
-    };
-    process.stdout.write(`${JSON.stringify(payload, null, 2)}\n`);
-    setStdoutSealed(true);
-}
-/**
- * Parses `--max-warnings <n>`: a non-negative integer, or undefined when
- * the flag was not given.
- */
-export function parseMaxWarnings(raw) {
-    if (raw === undefined)
-        return undefined;
-    const value = Number(raw);
-    if (!Number.isInteger(value) || value < 0) {
-        throw new InvalidArgumentError('--max-warnings must be a non-negative integer.', '--max-warnings');
-    }
-    return value;
-}

package/dist/src/commands/furnace/validate.d.ts

@@ -1,8 +0,0 @@
-import type { FurnaceValidateOptions } from '../../types/commands/index.js';
-/**
- * Runs the furnace validate command to perform static analysis on components.
- * @param projectRoot - Root directory of the project
- * @param name - Optional component name to validate (validates all if omitted)
- * @param options - Optional command options (`--fix`, `--json`, `--max-warnings`)
- */
-export declare function furnaceValidateCommand(projectRoot: string, name?: string, options?: FurnaceValidateOptions): Promise<void>;