@hominis/fireforge 0.27.0 → 0.27.2

package/dist/src/core/rebase-session.d.ts

@@ -1,9 +1,10 @@
 /**
- * Rebase session persistence for multi-patch ESR version upgrades.
+ * Rebase session persistence for multi-patch Firefox source upgrades.
  * Session state is stored at `.fireforge/rebase-session.json` and
  * survives across CLI invocations so the user can fix conflicts and
  * resume with `fireforge rebase --continue`.
  */
+import type { FirefoxProduct } from '../types/config.js';
 export type RebasePatchStatus = 'pending' | 'applied-clean' | 'applied-fuzz' | 'failed' | 'resolved' | 'skipped';
 export interface RebasePatchEntry {
     filename: string;
@@ -18,9 +19,13 @@ export interface RebasePatchEntry {
 export interface RebaseSession {
     /** ISO timestamp when the rebase started. */
     startedAt: string;
-    /** ESR version being rebased FROM. */
+    /** Source product being rebased FROM. */
+    fromProduct?: FirefoxProduct;
+    /** Source product being rebased TO. */
+    toProduct?: FirefoxProduct;
+    /** Source version being rebased FROM. */
     fromVersion: string;
-    /** ESR version being rebased TO. */
+    /** Source version being rebased TO. */
     toVersion: string;
     /** Commit hash recorded before the rebase started (for --abort). */
     preRebaseCommit: string;

package/dist/src/core/rebase-session.js

@@ -1,6 +1,6 @@
 // SPDX-License-Identifier: EUPL-1.2
 /**
- * Rebase session persistence for multi-patch ESR version upgrades.
+ * Rebase session persistence for multi-patch Firefox source upgrades.
  * Session state is stored at `.fireforge/rebase-session.json` and
  * survives across CLI invocations so the user can fix conflicts and
  * resume with `fireforge rebase --continue`.

package/dist/src/core/status-classify.d.ts

@@ -9,6 +9,9 @@
  * Classification buckets for engine file changes:
  * - `patch-backed`: content matches the expected post-patch state —
  *   normal after `fireforge import`.
+ * - `patch-owned-drift`: the file is claimed by exactly one patch, but
+ *   the live engine content no longer matches that patch's expected
+ *   post-apply content.
  * - `unmanaged`: edits not explained by any patch or tool — local
  *   drift to export or discard.
  * - `branding`: files under tool-managed branding paths, written by
@@ -23,7 +26,7 @@
  *   in `--json`, which misled scripts built on top of the JSON view
  *   into treating the file as routine local drift.
  */
-export type FileClassification = 'patch-backed' | 'unmanaged' | 'branding' | 'furnace' | 'conflict';
+export type FileClassification = 'patch-backed' | 'patch-owned-drift' | 'unmanaged' | 'branding' | 'furnace' | 'conflict';
 export interface StatusFile {
     status: string;
     file: string;

package/dist/src/core/status-classify.js

@@ -123,7 +123,7 @@ export async function classifyFiles(files, engineDir, patchesDir, binaryName, fu
             const expected = await computePatchedContent(patchesDir, engineDir, entry.file);
             results.push({
                 ...entry,
-                classification: expected === null ? 'patch-backed' : 'unmanaged',
+                classification: expected === null ? 'patch-backed' : 'patch-owned-drift',
             });
             continue;
         }
@@ -135,13 +135,12 @@ export async function classifyFiles(files, engineDir, patchesDir, binaryName, fu
             ]);
             results.push({
                 ...entry,
-                classification: actual === expected ? 'patch-backed' : 'unmanaged',
+                classification: actual === expected ? 'patch-backed' : 'patch-owned-drift',
             });
         }
         catch (error) {
-            verbose(`Treating ${entry.file} as unmanaged because patch-backed classification failed: ${toError(error).message}`);
-            // If we can't read the file, treat as unmanaged
-            results.push({ ...entry, classification: 'unmanaged' });
+            verbose(`Treating ${entry.file} as patch-owned drift because patch-backed classification failed: ${toError(error).message}`);
+            results.push({ ...entry, classification: 'patch-owned-drift' });
         }
     }
     return results;

package/dist/src/types/commands/index.d.ts

@@ -1,6 +1,6 @@
 /**
  * Re-exports all command-related types from focused sub-modules.
  */
-export type { BuildOptions, DiscardOptions, DoctorOptions, DownloadOptions, ExportOptions, FurnaceApplyOptions, FurnaceCreateOptions, FurnaceDeployOptions, FurnaceOverrideOptions, FurnacePreviewOptions, FurnaceRefreshOptions, FurnaceRemoveOptions, FurnaceSyncOptions, FurnaceValidateOptions, GlobalOptions, ImportOptions, PackageOptions, PatchCompactOptions, PatchDeleteOptions, PatchLintIgnoreOptions, PatchMoveFilesOptions, PatchRenameOptions, PatchReorderOptions, PatchStagedDependencyOptions, PatchTierOptions, RebaseOptions, ReExportOptions, RegisterOptions, ResetOptions, RunOptions, SetupOptions, StatusOptions, TestOptions, TokenAddOptions, WireOptions, } from './options.js';
+export type { BuildOptions, DiscardOptions, DoctorOptions, DownloadOptions, ExportOptions, FurnaceApplyOptions, FurnaceCreateOptions, FurnaceDeployOptions, FurnaceOverrideOptions, FurnacePreviewOptions, FurnaceRefreshOptions, FurnaceRemoveOptions, FurnaceSyncOptions, FurnaceValidateOptions, GlobalOptions, ImportOptions, PackageOptions, PatchCompactOptions, PatchDeleteOptions, PatchLintIgnoreOptions, PatchMoveFilesOptions, PatchRenameOptions, PatchReorderOptions, PatchStagedDependencyOptions, PatchTierOptions, RebaseOptions, ReExportOptions, RegisterOptions, ResetOptions, RunOptions, SetupOptions, SourceSetOptions, StatusOptions, TestOptions, TokenAddOptions, WireOptions, } from './options.js';
 export type { ImportSummary, PatchCategory, PatchesManifest, PatchInfo, PatchLintIssue, PatchMetadata, PatchResult, PatchStagedDependencies, PatchStagedForwardImport, } from './patches.js';
 export type { DoctorCheck, ProjectStatus, TokenCoverageFileEntry, TokenCoverageReport, } from './project.js';

package/dist/src/types/commands/options.d.ts

@@ -17,7 +17,7 @@ export interface SetupOptions {
     binaryName?: string;
     /** Firefox version to base on */
     firefoxVersion?: string;
-    /** Firefox product type (firefox, firefox-esr, firefox-beta) */
+    /** Firefox product type (firefox, firefox-esr, firefox-beta, firefox-devedition) */
     product?: FirefoxProduct;
     /** Overwrite existing configuration without prompting */
     force?: boolean;
@@ -31,6 +31,19 @@ export interface DownloadOptions {
     /** Force re-download, deleting existing engine/ */
     force?: boolean;
 }
+/**
+ * Options for the source command.
+ */
+export interface SourceSetOptions {
+    /** Firefox version to set */
+    version: string;
+    /** Firefox product type */
+    product: FirefoxProduct;
+    /** Optional pinned SHA-256 for the resolved source archive */
+    sha256?: string;
+    /** Clear any existing pinned SHA-256 */
+    clearSha256?: boolean;
+}
 /**
  * Options for the build command.
  */
@@ -651,6 +664,8 @@ export interface DoctorOptions {
      * and side-effect-free.
      */
     repairFurnace?: boolean;
+    /** Run extra post-rebase checks for common Firefox registration surfaces. */
+    postRebaseAudit?: boolean;
 }
 /**
  * Global CLI options available to all commands.

package/dist/src/types/commands/patches.d.ts

@@ -1,6 +1,7 @@
 /**
  * Types for the patch system: patch metadata, manifests, lint, and import results.
  */
+import type { FirefoxProduct } from '../config.js';
 /**
  * Patch categories for organizational classification.
  */
@@ -47,8 +48,15 @@ export interface PatchMetadata {
     description: string;
     /** ISO timestamp of when the patch was created */
     createdAt: string;
-    /** ESR version the patch was created against (e.g., "140.9.0esr") */
+    /**
+     * Deprecated compatibility alias for the source version the patch was
+     * created against. New writes also include `sourceVersion`.
+     */
     sourceEsrVersion: string;
+    /** Firefox source product the patch was created against. */
+    sourceProduct?: FirefoxProduct;
+    /** Firefox source version the patch was created against. */
+    sourceVersion?: string;
     /** Array of file paths affected by this patch */
     filesAffected: string[];
     /**

package/dist/src/types/config.d.ts

@@ -1,7 +1,7 @@
 /**
  * Firefox product type for downloads.
  */
-export type FirefoxProduct = 'firefox' | 'firefox-esr' | 'firefox-beta';
+export type FirefoxProduct = 'firefox' | 'firefox-esr' | 'firefox-beta' | 'firefox-devedition';
 /**
  * Firefox version configuration.
  */

package/dist/src/utils/elapsed.d.ts

@@ -0,0 +1,4 @@
+/** Formats elapsed milliseconds for progress messages. */
+export declare function formatElapsed(ms: number): string;
+/** Returns formatted elapsed time since a start timestamp from Date.now(). */
+export declare function elapsedSince(startedAt: number): string;

package/dist/src/utils/elapsed.js

@@ -0,0 +1,15 @@
+// SPDX-License-Identifier: EUPL-1.2
+/** Formats elapsed milliseconds for progress messages. */
+export function formatElapsed(ms) {
+    const totalSeconds = Math.max(0, Math.round(ms / 1000));
+    const minutes = Math.floor(totalSeconds / 60);
+    const seconds = totalSeconds % 60;
+    if (minutes === 0)
+        return `${seconds}s`;
+    return `${minutes}m ${seconds}s`;
+}
+/** Returns formatted elapsed time since a start timestamp from Date.now(). */
+export function elapsedSince(startedAt) {
+    return formatElapsed(Date.now() - startedAt);
+}
+//# sourceMappingURL=elapsed.js.map

package/dist/src/utils/validation.d.ts

@@ -71,7 +71,7 @@ export declare function assertObject(value: unknown, name: string): asserts valu
 export declare function isValidFirefoxVersion(version: string): boolean;
 /**
  * Validates a Firefox product string.
- * Accepts: firefox, firefox-esr, firefox-beta
+ * Accepts: firefox, firefox-esr, firefox-beta, firefox-devedition
  */
 export declare function isValidFirefoxProduct(product: string): boolean;
 /**
@@ -108,7 +108,7 @@ export declare function inferProductFromVersion(version: string): 'firefox' | 'f
  *
  * Rules:
  * - `firefox-esr` requires an ESR version (e.g. "140.9.0esr", "128.0.1esr").
- * - `firefox-beta` requires a beta version (e.g. "147.0b1").
+ * - `firefox-beta` and `firefox-devedition` require a beta version (e.g. "147.0b1").
  * - `firefox` (stable) rejects both ESR and beta version strings.
  *
  * @returns An error message if incompatible, or undefined if valid.

package/dist/src/utils/validation.js

@@ -106,10 +106,10 @@ export function isValidFirefoxVersion(version) {
 }
 /**
  * Validates a Firefox product string.
- * Accepts: firefox, firefox-esr, firefox-beta
+ * Accepts: firefox, firefox-esr, firefox-beta, firefox-devedition
  */
 export function isValidFirefoxProduct(product) {
-    return ['firefox', 'firefox-esr', 'firefox-beta'].includes(product);
+    return ['firefox', 'firefox-esr', 'firefox-beta', 'firefox-devedition'].includes(product);
 }
 /**
  * Valid project license SPDX identifiers.
@@ -161,7 +161,7 @@ export function inferProductFromVersion(version) {
  *
  * Rules:
  * - `firefox-esr` requires an ESR version (e.g. "140.9.0esr", "128.0.1esr").
- * - `firefox-beta` requires a beta version (e.g. "147.0b1").
+ * - `firefox-beta` and `firefox-devedition` require a beta version (e.g. "147.0b1").
  * - `firefox` (stable) rejects both ESR and beta version strings.
  *
  * @returns An error message if incompatible, or undefined if valid.
@@ -177,9 +177,9 @@ export function validateFirefoxProductVersionCompatibility(version, product) {
             }
             break;
         case 'firefox-beta':
+        case 'firefox-devedition':
             if (!versionIsBeta) {
-                return (`Product "firefox-beta" requires a beta version (e.g. "147.0b1"), ` +
-                    `but got "${version}"`);
+                return (`Product "${product}" requires a beta version (e.g. "147.0b1"), ` + `but got "${version}"`);
             }
             break;
         case 'firefox':

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@hominis/fireforge",
-  "version": "0.27.0",
+  "version": "0.27.2",
   "description": "FireForge — a build tool for customizing Firefox",
   "type": "module",
   "main": "./dist/src/index.js",