@hominis/fireforge 0.46.0 → 0.46.2

package/dist/src/errors/codes.d.ts

@@ -26,7 +26,7 @@ export declare const ExitCode: {
     /** Patch conflict resolution error */
     readonly RESOLUTION_ERROR: 10;
     /**
-     * An internal invariant did not hold — a bug in FireForge itself, not a
+     * An internal invariant did not hold: a bug in FireForge itself, not a
      * user or environment failure. Distinct from GENERAL_ERROR because the
      * two call for opposite responses: a GENERAL_ERROR usually means the
      * operator must change something (fix a config, free a lock, retry), and
@@ -43,30 +43,30 @@ export declare const ExitCode: {
     readonly SMOKE_EXIT_FAILURE: 12;
     /**
      * `fireforge run --smoke-exit` saw the browser exit with a non-clean
-     * status before the smoke window elapsed — a launch-side failure that
-     * did NOT surface as a console error line (crash before console wiring,
-     * missing profile, etc.).
+     * status before the smoke window elapsed. This is a launch-side failure
+     * that did not surface as a console error line (crash before console
+     * wiring, missing profile, etc.).
      */
     readonly SMOKE_LAUNCH_FAILURE: 13;
     /**
-     * A `fireforge test` run produced a harness result that cannot be trusted
-     * — `engine/` moved (or became unprobeable) while the tests ran. Distinct
-     * from BUILD_ERROR because the two are opposites: a 5 is a suite that
-     * FAILED, a 14 is a suite whose result was THROWN AWAY. A consumer should
+     * A `fireforge test` run produced a harness result that cannot be
+     * trusted: `engine/` moved (or became unprobeable) while the tests ran.
+     * Distinct from BUILD_ERROR because the two are opposites: a 5 is a suite
+     * that failed, a 14 is a suite whose result was thrown away. A consumer should
      * re-run a 14 (after settling the writers) and must not report it as red.
      */
     readonly INCONCLUSIVE: 14;
     /**
      * A lock wait expired: the run never started, because another FireForge
      * process held the lock for the whole budget. Distinct from GENERAL_ERROR
-     * because nothing about the request was wrong — a consumer should re-queue
+     * because nothing about the request was wrong. A consumer should re-queue
      * it, with a larger `--wait-lock` budget, rather than treat it as a
      * failure of the work it asked for.
      */
     readonly LOCK_TIMEOUT: 15;
     /**
      * The user cancelled an interactive prompt. 130 = 128 + SIGINT, the
-     * conventional "interrupted by the user" code — scripts and CI can tell
+     * conventional "interrupted by the user" code, so scripts and CI can tell
      * a deliberate cancellation apart from a real failure (GENERAL_ERROR).
      */
     readonly USER_CANCELLED: 130;

package/dist/src/errors/codes.js

@@ -27,7 +27,7 @@ export const ExitCode = {
     /** Patch conflict resolution error */
     RESOLUTION_ERROR: 10,
     /**
-     * An internal invariant did not hold — a bug in FireForge itself, not a
+     * An internal invariant did not hold: a bug in FireForge itself, not a
      * user or environment failure. Distinct from GENERAL_ERROR because the
      * two call for opposite responses: a GENERAL_ERROR usually means the
      * operator must change something (fix a config, free a lock, retry), and
@@ -44,30 +44,30 @@ export const ExitCode = {
     SMOKE_EXIT_FAILURE: 12,
     /**
      * `fireforge run --smoke-exit` saw the browser exit with a non-clean
-     * status before the smoke window elapsed — a launch-side failure that
-     * did NOT surface as a console error line (crash before console wiring,
-     * missing profile, etc.).
+     * status before the smoke window elapsed. This is a launch-side failure
+     * that did not surface as a console error line (crash before console
+     * wiring, missing profile, etc.).
      */
     SMOKE_LAUNCH_FAILURE: 13,
     /**
-     * A `fireforge test` run produced a harness result that cannot be trusted
-     * — `engine/` moved (or became unprobeable) while the tests ran. Distinct
-     * from BUILD_ERROR because the two are opposites: a 5 is a suite that
-     * FAILED, a 14 is a suite whose result was THROWN AWAY. A consumer should
+     * A `fireforge test` run produced a harness result that cannot be
+     * trusted: `engine/` moved (or became unprobeable) while the tests ran.
+     * Distinct from BUILD_ERROR because the two are opposites: a 5 is a suite
+     * that failed, a 14 is a suite whose result was thrown away. A consumer should
      * re-run a 14 (after settling the writers) and must not report it as red.
      */
     INCONCLUSIVE: 14,
     /**
      * A lock wait expired: the run never started, because another FireForge
      * process held the lock for the whole budget. Distinct from GENERAL_ERROR
-     * because nothing about the request was wrong — a consumer should re-queue
+     * because nothing about the request was wrong. A consumer should re-queue
      * it, with a larger `--wait-lock` budget, rather than treat it as a
      * failure of the work it asked for.
      */
     LOCK_TIMEOUT: 15,
     /**
      * The user cancelled an interactive prompt. 130 = 128 + SIGINT, the
-     * conventional "interrupted by the user" code — scripts and CI can tell
+     * conventional "interrupted by the user" code, so scripts and CI can tell
      * a deliberate cancellation apart from a real failure (GENERAL_ERROR).
      */
     USER_CANCELLED: 130,

package/dist/src/errors/furnace.d.ts

@@ -8,10 +8,10 @@ export declare class FurnaceError extends FireForgeError {
     constructor(message: string, component?: string | undefined, cause?: Error, options?: {
         /**
          * Suppresses the "run furnace validate" advice line. Set by callers
-         * whose message already tells the user to run validate, or that ARE
+         * whose message already tells the user to run validate, or that are
          * the validate command. An explicit flag rather than sniffing the
          * message for `furnace validate`, which drops the advice from any
-         * error that merely MENTIONS the command.
+         * error that merely mentions the command.
          */
         omitValidateAdvice?: boolean;
     });

package/dist/src/errors/git.d.ts

@@ -40,7 +40,7 @@ export declare class GitIndexLockError extends GitError {
     get userMessage(): string;
 }
 /**
- * Detects transient git `index.lock` contention — an external git process
+ * Detects transient git `index.lock` contention: an external git process
  * holding `.git/index.lock` while we stage or diff. Mirrors the message
  * heuristics `core/git.ts` uses when wrapping stale-lock failures during
  * download, but lives here so command modules can consult it without

package/dist/src/errors/git.js

@@ -87,7 +87,7 @@ export class GitIndexLockError extends GitError {
     }
 }
 /**
- * Detects transient git `index.lock` contention — an external git process
+ * Detects transient git `index.lock` contention: an external git process
  * holding `.git/index.lock` while we stage or diff. Mirrors the message
  * heuristics `core/git.ts` uses when wrapping stale-lock failures during
  * download, but lives here so command modules can consult it without

package/dist/src/errors/patch.d.ts

@@ -2,11 +2,11 @@ import { FireForgeError } from './base.js';
 /**
  * Error thrown when `patches.json` exists but cannot be parsed or validated.
  *
- * This must be a HARD error on every mutating path. Collapsing "corrupt"
- * into "absent" — a `loadPatchesManifest` that returns null for both — makes
+ * This must be a hard error on every mutating path. Collapsing "corrupt"
+ * into "absent" (a `loadPatchesManifest` that returns null for both) makes
  * the next `fireforge export` rebuild the manifest containing only the new
  * patch, silently destroying every other patch's metadata (tiers,
- * descriptions, lintIgnore, staged dependencies); a failed export's rollback
+ * descriptions, lintIgnore, staged dependencies). A failed export's rollback
  * then deletes `patches.json` outright, because the "before" state looked
  * absent.
  */

package/dist/src/errors/patch.js

@@ -4,11 +4,11 @@ import { ExitCode } from './codes.js';
 /**
  * Error thrown when `patches.json` exists but cannot be parsed or validated.
  *
- * This must be a HARD error on every mutating path. Collapsing "corrupt"
- * into "absent" — a `loadPatchesManifest` that returns null for both — makes
+ * This must be a hard error on every mutating path. Collapsing "corrupt"
+ * into "absent" (a `loadPatchesManifest` that returns null for both) makes
  * the next `fireforge export` rebuild the manifest containing only the new
  * patch, silently destroying every other patch's metadata (tiers,
- * descriptions, lintIgnore, staged dependencies); a failed export's rollback
+ * descriptions, lintIgnore, staged dependencies). A failed export's rollback
  * then deletes `patches.json` outright, because the "before" state looked
  * absent.
  */

package/dist/src/errors/rebase.d.ts

@@ -23,7 +23,7 @@ export declare class NoRebaseSessionError extends RebaseError {
  *
  * Without an error of its own, this case is reported as
  * {@link NoRebaseSessionError} by `--continue`/`--abort` while `rebase`
- * reports {@link RebaseSessionExistsError} — a closed cycle in which each
+ * reports {@link RebaseSessionExistsError}, a closed cycle in which each
  * command points at the other two. The message names the file so an operator
  * always has a way out, and `--abort` clears a corrupt session rather than
  * refusing to run against one.

package/dist/src/errors/rebase.js

@@ -37,7 +37,7 @@ export class NoRebaseSessionError extends RebaseError {
  *
  * Without an error of its own, this case is reported as
  * {@link NoRebaseSessionError} by `--continue`/`--abort` while `rebase`
- * reports {@link RebaseSessionExistsError} — a closed cycle in which each
+ * reports {@link RebaseSessionExistsError}, a closed cycle in which each
  * command points at the other two. The message names the file so an operator
  * always has a way out, and `--abort` clears a corrupt session rather than
  * refusing to run against one.

package/dist/src/errors/run.d.ts

@@ -2,7 +2,7 @@ import { FireForgeError } from './base.js';
 import { ExitCode } from './codes.js';
 /**
  * Error raised by `fireforge run --smoke-exit` when the captured console
- * stream produced one or more error lines that did NOT match the
+ * stream produced one or more error lines that did not match the
  * configured allowlist.
  *
  * Distinct from `BuildError` so CI pipelines can route smoke failures

package/dist/src/errors/run.js

@@ -3,7 +3,7 @@ import { FireForgeError } from './base.js';
 import { ExitCode } from './codes.js';
 /**
  * Error raised by `fireforge run --smoke-exit` when the captured console
- * stream produced one or more error lines that did NOT match the
+ * stream produced one or more error lines that did not match the
  * configured allowlist.
  *
  * Distinct from `BuildError` so CI pipelines can route smoke failures

package/dist/src/index.d.ts

@@ -1,15 +1,15 @@
 /**
- * FireForge — a toolkit for building and maintaining Firefox-based browsers.
+ * FireForge: a toolkit for building and maintaining Firefox-based browsers.
  *
  * This module re-exports the public API surface used by downstream consumers.
  * For CLI usage, see `bin/fireforge.ts`.
  *
- * **Stability:** Pre-1.0. The exports listed here are functional and tested,
+ * Stability: pre-1.0. The exports listed here are functional and tested,
  * but may change between minor versions until 1.0 is released. Pin to an
  * exact version if you depend on the programmatic API.
  *
- * **What belongs here:** a type earns a place on this surface only if it is
- * reachable from the signature of an exported VALUE — i.e. a consumer needs
+ * What belongs here: a type earns a place on this surface only if it is
+ * reachable from the signature of an exported value, i.e. a consumer needs
  * it to name an argument or a return. Everything else stays internal to
  * `src/types/`.
  *

package/dist/src/index.js

@@ -1,16 +1,16 @@
 // SPDX-License-Identifier: EUPL-1.2
 /**
- * FireForge — a toolkit for building and maintaining Firefox-based browsers.
+ * FireForge: a toolkit for building and maintaining Firefox-based browsers.
  *
  * This module re-exports the public API surface used by downstream consumers.
  * For CLI usage, see `bin/fireforge.ts`.
  *
- * **Stability:** Pre-1.0. The exports listed here are functional and tested,
+ * Stability: pre-1.0. The exports listed here are functional and tested,
  * but may change between minor versions until 1.0 is released. Pin to an
  * exact version if you depend on the programmatic API.
  *
- * **What belongs here:** a type earns a place on this surface only if it is
- * reachable from the signature of an exported VALUE — i.e. a consumer needs
+ * What belongs here: a type earns a place on this surface only if it is
+ * reachable from the signature of an exported value, i.e. a consumer needs
  * it to name an argument or a return. Everything else stays internal to
  * `src/types/`.
  *