neat/nge-adult

Rolling reward-delta evidence tracked while the adult phase checks for plateau behavior.

neat/nge-adult/neat.nge-adult.types.ts

AdultState

Persistent adult-phase state shelf reserved for plateau, cooling, and equilibrium passes.

EquilibriumCandidate

Typed equilibrium snapshot emitted once one adult zone looks ready for compaction-first policy.

GainStabilityRecord

Rolling gain evidence tracked while the adult phase checks for stable optimization pressure.

PlateauRecord

Rolling reward-delta evidence tracked while the adult phase checks for plateau behavior.

neat/nge-adult/neat.nge-adult.ts

advanceAdultState

advanceAdultState(
  input: AdvanceAdultStateInput,
): AdvanceAdultStateResult

Advance one complete owner-local adult optimization and equilibrium detection cycle.

Parameters:

• input - Runtime inputs for the current adult cycle.

Returns: The composed adult transition for the current cycle.

AdvanceAdultStateInput

Runtime input bag consumed by one adult-phase orchestration step call.

AdvanceAdultStateResult

Top-level adult orchestration result returned for one full evaluation cycle.

neat/nge-adult/neat.nge-adult.errors.ts

Error raised when adult plateau evaluation cannot produce a valid local decision.

NgeAdult_EquilibriumError

Error raised when adult equilibrium evaluation cannot produce a valid local decision.

NgeAdult_PlateauError

Error raised when adult plateau evaluation cannot produce a valid local decision.

neat/nge-adult/neat.nge-adult.cooling.ts

AdultGrowthCoolingDecision

Budget split emitted by the adult cooling policy for one focus score.

AdultPruneCandidate

Ranked adult prune candidate evaluated before compact morphs are ever considered.

AdultPruneCompactDecision

Local dominance decision produced by the adult prune and compact arbitration step.

arbitratePruneCompactDominance

arbitratePruneCompactDominance(
  candidates: readonly AdultPruneCandidate[],
  compactEligible: boolean,
): AdultPruneCompactDecision

Arbitrate whether adult prune and compact dominate the cooled morph budget.

Selects the highest-priority non-reward-critical prune candidate, preferring inter-module edges and longer edges, then resolves which morph kinds are eligible for the cooled budget based on candidate and compact availability.

Parameters:

• candidates - Ranked prune candidates visible to the local adult module.
• compactEligible - Whether compact still has headroom in the current window.

Returns: Prune-compact decision naming the dominant morph kinds and selected candidate.

Example:

const decision = arbitratePruneCompactDominance(
  [{ candidateId: 'e1', edgeLength: 2, isInterModule: true, isRewardCritical: false }],
  true,
);
console.log(decision.dominantMorphKinds); // ['edgePrune', 'compact']

resolveGrowthCoolingDecision

resolveGrowthCoolingDecision(
  focusScore: number,
  growthCoolingFactor: number,
  focusFloor: number,
): AdultGrowthCoolingDecision

Resolve the current adult cooling decision for one normalized focus score.

Growth cooling is active only when the focus score is above the floor and the residual growth budget is non-zero. A zero cooling factor or a sub-floor focus score fully suppresses adult growth and leaves the entire morph budget for prune and compact actions.

Parameters:

• focusScore - Normalized adult focus score for the active module.
• growthCoolingFactor - Residual growth fraction preserved by adult cooling.
• focusFloor - Minimum focus score that keeps residual growth alive.

Returns: Cooling decision carrying the active flag and budget split for the cycle.

Example:

const decision = resolveGrowthCoolingDecision(0.82, 0.1, 0.6);
console.log(decision.growthCoolingActive); // true
console.log(decision.growthBudgetFraction); // 0.1

neat/nge-adult/neat.nge-adult.plateau.ts

advancePlateauRecord

advancePlateauRecord(
  plateauRecord: PlateauRecord,
  rewardDelta: number,
  marginalEpsilon: number,
): PlateauRecord

Advances one rolling plateau record with a new adult reward delta.

Parameters:

• plateauRecord - Existing reward-delta evidence for the active adult zone.
• rewardDelta - Latest normalized reward delta observed for the current evaluation window.
• marginalEpsilon - Smallest improvement that still counts as meaningful positive return.

Returns: Updated plateau state with the retained reward window and stagnation decision.

computeMarginalReturn

computeMarginalReturn(
  rewardDelta: number,
  structuralEditCount: number,
): number

Resolves one marginal-return score for the current adult structural edit batch.

Parameters:

• rewardDelta - Normalized reward improvement produced by the current edit batch.
• structuralEditCount - Number of structural edits responsible for the observed reward delta.

Returns: Reward improvement normalized by the structural edit count.

neat/nge-adult/neat.nge-adult.constants.ts

Rolling evaluation-window length used by the adult plateau detector. Defaults to 6 evaluation steps.

NGE_ADULT_DEFAULT_GAIN_STABILITY_TOLERANCE

Allowed gain deviation before one adult zone is considered unstable again.

NGE_ADULT_DEFAULT_GAIN_STABILITY_WINDOW

Rolling evaluation-window length used by the adult gain-stability detector. Defaults to 5 evaluation steps.

NGE_ADULT_DEFAULT_GROWTH_COOLING_FACTOR

Residual growth-budget fraction preserved while the adult phase biases toward prune and compact.

NGE_ADULT_DEFAULT_GROWTH_FOCUS_FLOOR

Minimum normalized focus score required before adult growth remains eligible at all.

NGE_ADULT_DEFAULT_MARGINAL_EPSILON

Smallest meaningful reward improvement that still counts as positive adult return.

NGE_ADULT_DEFAULT_PLATEAU_WINDOW

Rolling evaluation-window length used by the adult plateau detector. Defaults to 6 evaluation steps.

neat/nge-adult/neat.nge-adult.equilibrium.ts

advanceGainStabilityRecord

advanceGainStabilityRecord(
  gainStabilityRecord: GainStabilityRecord,
  gainMeasurement: number,
  gainStabilityTolerance: number,
): GainStabilityRecord

Advances one rolling gain-stability record with a new adult neuromodulator gain sample.

Parameters:

• gainStabilityRecord - Existing gain evidence for the active adult zone.
• gainMeasurement - Latest gain measurement observed for the current evaluation window.
• gainStabilityTolerance - Allowed deviation around the rolling mean.

Returns: Updated gain-stability evidence for the active adult zone.

detectEquilibriumCandidate

detectEquilibriumCandidate(
  zoneId: string,
  plateauRecord: PlateauRecord,
  gainStabilityRecord: GainStabilityRecord,
): EquilibriumCandidate | null

Detects whether one adult zone is ready to emit an equilibrium candidate.

Parameters:

• zoneId - Stable adult-zone identifier under evaluation.
• plateauRecord - Plateau evidence for the current adult zone.
• gainStabilityRecord - Gain-stability evidence for the current adult zone.

Returns: An equilibrium candidate when both adult guards hold; otherwise null.

neat/nge-adult/neat.nge-adult.utils.ts

createAdultState

createAdultState(
  zoneId: string,
): AdultState

Create the initial owner-local adult state for one fresh zone instance.

Seeds empty plateau and gain-stability histories, marks the zone as not yet in equilibrium, and disables growth cooling until the first adult cycle resolves it.

Parameters:

• zoneId - Stable adult-zone identifier that anchors the seeded state.

Returns: Fresh adult state ready for the first advanceAdultState cycle.

Example:

const adultState = createAdultState('zone:alpha');
console.log(adultState.equilibriumCandidate.zoneId); // 'zone:alpha'