@hominis/fireforge 0.54.0 → 0.60.0

package/dist/src/core/furnace-apply-overwrite-warn.js

@@ -1,124 +0,0 @@
-// SPDX-License-Identifier: EUPL-1.2
-/**
- * Patch-owned overwrite warnings for `furnace apply`.
- *
- * For Furnace-managed components, apply overwrites the deployed engine
- * copies with the `components/` sources. A fix made directly in `engine/` and
- * exported into a patch (but never back-ported to the component source) is
- * silently undone by the next apply, and a plain drift line reads like
- * "someone's uncommitted work". This module detects that case before
- * the copy (deployed bytes differ from the component source and the file is
- * patch-owned) and produces a per-file warning naming the file, the owning
- * patch, and the consequence.
- *
- * The per-file byte comparison already exists:
- * `checkRegistrationConsistency` for custom components (fragment- and
- * ftl-aware) and the copy-candidate walk for overrides. This module only
- * surfaces what those comparisons compute.
- */
-import { readdir } from 'node:fs/promises';
-import { join, relative } from 'node:path';
-import { toError } from '../utils/errors.js';
-import { pathExists, readText } from '../utils/fs.js';
-import { verbose } from '../utils/logger.js';
-import { normalizePathSlashes } from '../utils/paths.js';
-import { getProjectPaths } from './config.js';
-import { getOverrideEngineTargetPath, isOverrideCopyCandidate } from './furnace-apply-helpers.js';
-import { FTL_DIR } from './furnace-constants.js';
-import { isRegularFile } from './furnace-dir-entry.js';
-import { checkRegistrationConsistency } from './furnace-validate-registration.js';
-import { loadPatchesManifest } from './patch-manifest.js';
-import { buildPatchClaims } from './status-classify.js';
-/**
- * Loads the file → owning-patch map for the overwrite warning.
- * A missing or unreadable patches manifest degrades to an empty map. The
- * warning is advisory and must never block an apply.
- */
-export async function loadPatchClaimsForApply(root) {
-    try {
-        const manifest = await loadPatchesManifest(getProjectPaths(root).patches);
-        return manifest ? buildPatchClaims(manifest.patches) : new Map();
-    }
-    catch {
-        return new Map();
-    }
-}
-/** Appends formatted overwrite warnings onto the run's result. */
-export function recordOverwriteWarnings(result, warnings) {
-    if (warnings.length === 0)
-        return;
-    result.warnings ??= [];
-    result.warnings.push(...warnings.map(formatPatchOwnedOverwriteWarning));
-}
-/** Renders the operator-facing warning line for one overwrite. */
-export function formatPatchOwnedOverwriteWarning(warning) {
-    const owners = warning.owners.join(', ');
-    return (`${warning.component}: overwriting deployed ${warning.file} — its engine content differs ` +
-        `from the components/ source, and the path is owned by patch ${owners}. If the engine ` +
-        `edit was an intentional shipped fix, port it into the component source and re-export ` +
-        `the patch — the deployed copy is being replaced now.`);
-}
-/** Custom components: reuse the validate oracle's drifted-file list. */
-async function findCustomOverwrites(args) {
-    const { root, name, config, ftlDir, patchClaims } = args;
-    const status = await checkRegistrationConsistency(root, name, config, ftlDir);
-    const warnings = [];
-    for (const entryName of status.driftedFiles) {
-        const engineRel = entryName.endsWith('.ftl')
-            ? `${ftlDir || FTL_DIR}/${entryName}`
-            : `${config.targetPath}/${entryName}`;
-        const owners = patchClaims.get(engineRel);
-        if (owners !== undefined && owners.length > 0) {
-            warnings.push({ component: name, file: engineRel, owners: [...owners] });
-        }
-    }
-    return warnings;
-}
-/** Override components: byte-compare each copy candidate against its engine target. */
-async function findOverrideOverwrites(args) {
-    const { engineDir, name, componentDir, config, ftlDir, patchClaims } = args;
-    const warnings = [];
-    const entries = await readdir(componentDir, { withFileTypes: true, encoding: 'utf8' });
-    for (const entry of entries) {
-        if (!isRegularFile(entry))
-            continue;
-        if (!isOverrideCopyCandidate(entry.name, config.type))
-            continue;
-        const enginePath = getOverrideEngineTargetPath(engineDir, config, entry.name, ftlDir);
-        // A missing target is a fresh deploy, not a lost engine edit.
-        if (!(await pathExists(enginePath)))
-            continue;
-        const engineRel = normalizePathSlashes(relative(engineDir, enginePath));
-        const owners = patchClaims.get(engineRel);
-        if (owners === undefined || owners.length === 0)
-            continue;
-        const [engineContent, sourceContent] = await Promise.all([
-            readText(enginePath),
-            readText(join(componentDir, entry.name)),
-        ]);
-        if (engineContent !== sourceContent) {
-            warnings.push({ component: name, file: engineRel, owners: [...owners] });
-        }
-    }
-    return warnings;
-}
-/**
- * Finds deployed files this component's apply is about to overwrite whose
- * engine bytes differ from the component source and that are patch-owned.
- * Probe failures degrade to a verbose line and an empty list. The apply
- * itself must not fail because the warning probe could not run.
- */
-export async function findPatchOwnedOverwrites(args) {
-    if (args.patchClaims.size === 0)
-        return [];
-    try {
-        if (args.type === 'custom') {
-            return await findCustomOverwrites(args);
-        }
-        return await findOverrideOverwrites(args);
-    }
-    catch (error) {
-        verbose(`Skipping patch-owned overwrite probe for ${args.name}: ${toError(error).message}`);
-        return [];
-    }
-}

package/dist/src/core/furnace-apply-undeploy-actions.d.ts

@@ -1,10 +0,0 @@
-/**
- * Dry-run action builders for files deleted from a component workspace since
- * the last apply. Split out of `furnace-apply.ts` to stay under the per-file
- * line budget. The real undeploy paths stay in `furnace-apply-helpers.ts`.
- */
-import type { CustomComponentConfig, DryRunAction, OverrideComponentConfig } from '../types/furnace.js';
-/** Plans the engine-restore actions for deleted override workspace files. */
-export declare function buildOverrideUndeployActions(name: string, config: OverrideComponentConfig, engineDir: string, deletedFiles: string[], ftlDir: string): DryRunAction[];
-/** Plans the engine-removal + deregistration actions for deleted custom workspace files. */
-export declare function buildCustomUndeployActions(name: string, config: CustomComponentConfig, engineDir: string, deletedFiles: string[], ftlDir: string): DryRunAction[];

package/dist/src/core/furnace-apply-undeploy-actions.js

@@ -1,48 +0,0 @@
-// SPDX-License-Identifier: EUPL-1.2
-/**
- * Dry-run action builders for files deleted from a component workspace since
- * the last apply. Split out of `furnace-apply.ts` to stay under the per-file
- * line budget. The real undeploy paths stay in `furnace-apply-helpers.ts`.
- */
-import { join } from 'node:path';
-import { getOverrideEngineTargetPath } from './furnace-apply-helpers.js';
-/** Plans the engine-restore actions for deleted override workspace files. */
-export function buildOverrideUndeployActions(name, config, engineDir, deletedFiles, ftlDir) {
-    return deletedFiles.map((fileName) => ({
-        component: name,
-        action: 'undeploy-restore',
-        target: getOverrideEngineTargetPath(engineDir, config, fileName, ftlDir),
-        description: `Restore engine/${fileName.endsWith('.ftl') ? `${ftlDir}/${fileName}` : `${config.basePath}/${fileName}`} to Firefox baseline`,
-    }));
-}
-/** Plans the engine-removal + deregistration actions for deleted custom workspace files. */
-export function buildCustomUndeployActions(name, config, engineDir, deletedFiles, ftlDir) {
-    const actions = [];
-    for (const fileName of deletedFiles) {
-        const enginePath = fileName.endsWith('.ftl')
-            ? join(engineDir, ftlDir, fileName)
-            : join(engineDir, config.targetPath, fileName);
-        actions.push({
-            component: name,
-            action: 'undeploy-remove',
-            target: enginePath,
-            description: `Remove orphaned ${fileName} from engine`,
-        });
-    }
-    // jar.mn re-sync planned for any custom-file deletion when registered.
-    if (config.register && deletedFiles.some((f) => f.endsWith('.mjs') || f.endsWith('.css'))) {
-        actions.push({
-            component: name,
-            action: 'unregister-jar',
-            description: `Re-sync ${name} jar.mn entries to drop deleted files`,
-        });
-    }
-    if (config.register && deletedFiles.some((f) => f === `${name}.mjs`)) {
-        actions.push({
-            component: name,
-            action: 'unregister-ce',
-            description: `Deregister ${name} from customElements.js (.mjs deleted)`,
-        });
-    }
-    return actions;
-}

package/dist/src/core/furnace-apply.d.ts

@@ -1,49 +0,0 @@
-import type { ApplyResult, DryRunAction } from '../types/furnace.js';
-import { type FurnaceOperationContext } from './furnace-operation.js';
-import { type RollbackJournal } from './furnace-rollback.js';
-export { computeComponentChecksums, prefixChecksums } from './furnace-apply-helpers.js';
-/**
- * Result of {@link applyAllComponents}.
- *
- * Named so consumers can refer to the shape directly instead of going
- * through `Awaited<ReturnType<typeof applyAllComponents>>`.
- *
- * `actions` is populated only on a dry run. `rollbackJournal` is set only
- * when `persistState: false` hands journal ownership back to the caller.
- */
-export type ApplyAllComponentsResult = ApplyResult & {
-    actions?: DryRunAction[];
-    rollbackJournal?: RollbackJournal;
-};
-/**
- * Applies all override and custom components to the engine source tree.
- *
- * Unchanged components (matching checksums) are skipped. If any component
- * fails, FireForge restores only the engine files touched during this apply
- * attempt and leaves the state file unchanged.
- *
- * When `options.persistState` is false, the furnace state file is left alone
- * on success and the rollback journal is returned on the result so the caller
- * can restore the engine later (used by `furnace preview` to stage workspace
- * files for Storybook and then roll them back on teardown).
- *
- * @param root - Root directory of the project
- * @param dryRun - If true, enumerate planned actions without writing
- * @param options - Optional behavior flags. `persistState` controls whether
- *   the furnace state file is updated on success (preview teardown sets this
- *   to false to keep ownership of the journal). `operationContext` is the
- *   lifecycle-wrapper hook used by `runFurnaceMutation` so a Ctrl+C mid-apply
- *   can find the in-flight rollback journal.
- * @returns Summary of applied, skipped, and errored components (with actions
- *          when dry-run, and with rollbackJournal when persistState=false)
- */
-export declare function applyAllComponents(root: string, dryRun?: boolean, options?: {
-    persistState?: boolean;
-    operationContext?: FurnaceOperationContext;
-    componentName?: string;
-}): Promise<ApplyAllComponentsResult>; /**
- * Shared context threaded through the batch apply loops. Bundles the state
- * both loops mutate (result/actions/checksums) with the immutable run
- * parameters. The 12-13 positional parameters this replaced let call sites
- * drift and made every new parameter a two-signature change.
- */