@mindot/will 0.5.0 → 0.7.0

package/src/cognition/agency/selection.scoring.ts

@@ -7,13 +7,18 @@
 // learned, and what it fears. This is the basal-ganglia Go/NoGo arithmetic,
 // kept pure so it is trivially testable and replay-deterministic.
 //
-//   activation = goalRelevance + expectedReward + novelty + driveUrgency
+//   activation = goalRelevance
+//              + expectedReward
+//              + novelty
+//              + driveUrgency
 //              + habitStrength·W                              (additive habit bonus)
 //              + planBias·W                                   (top-down prior)
-//              − cost − inhibition − risk
+//              − cost
+//              − inhibition
+//              − risk
 //
 // The habit term is additive (per design decision): an overlearned schema wins
-// cheaply AND lowers its own deliberation threshold (see selector.ts), which is
+// cheaply AND lowers its own deliberation threshold (see action.selector.ts), which is
 // how the instrumental→habitual gradient cashes out as falling LLM spend.
 // ─────────────────────────────────────────────────────────────
 
@@ -77,22 +82,29 @@ export const DEFAULT_TEMPERATURE = 0.15
  */
 export function collectGoalTargets( state: ReadonlySimulationState ): Map<string, number> {
   const targets = new Map<string, number>()
+
   for( const e of state.entities.values() ){
-    if( e.type !== 'goal' ) continue
+    if( e.type !== 'goal') continue
+
     const m = e.metadata as Record<string, unknown> | undefined
     const status = typeof m?.['status'] === 'string' ? m['status'] : undefined
-    if( status !== 'active' && status !== 'in_progress' ) continue
+
+    if( status !== 'active' && status !== 'in_progress') continue
+
     const priority = typeof m?.['priority'] === 'number' ? m['priority'] as number : 0
     const link = ( id: unknown ): void => {
       if( typeof id !== 'string' || !id ) return
       targets.set( id, Math.max( targets.get( id ) ?? 0, priority ) )
     }
+
     link( m?.['targetEntityId'] )
     link( m?.['requestingEntityId'] )
+
     if( Array.isArray( m?.['tags'] ) )
       for( const t of m['tags'] as unknown[] )
-        if( typeof t === 'string' && t.startsWith( 'keid:' ) ) link( t.slice( 5 ) )
+        if( typeof t === 'string' && t.startsWith('keid:') ) link( t.slice( 5 ) )
   }
+
   return targets
 }
 
@@ -100,18 +112,22 @@ export function collectGoalTargets( state: ReadonlySimulationState ): Map<string
 export function goalRelevance( a: Affordance, bias: BiasContext ): number {
   if( a.targetEntityId && bias.goalTargets.has( a.targetEntityId ) )
     return bias.maxGoalPriority
+
   return 0
 }
 
 /** Homeostatic urgency routed to the affordance by its schema tags. */
 export function driveUrgency( a: Affordance, bias: BiasContext ): number {
   const t = a.tags
-  if( t.includes( 'regulatory' ) || t.includes( 'self-care' ) || t.includes( 'rest' ) )
+  if( t.includes('regulatory') || t.includes('self-care') || t.includes('rest') )
     return Math.max( bias.drives.energy, bias.drives.sleep )
-  if( t.includes( 'social' ) )
+
+  if( t.includes('social') )
     return bias.drives.social
-  if( t.includes( 'self-protection' ) )
+
+  if( t.includes('self-protection') )
     return Math.max( bias.drives.stress, bias.threat )
+
   return 0
 }
 
@@ -131,7 +147,7 @@ export function scoreAffordance(
   bias: BiasContext,
   w:    ScoreWeights = DEFAULT_WEIGHTS,
 ): number {
-  return (
+  const raw = (
       w.goal    * goalRelevance( a, bias )
     + w.reward  * a.expectedReward
     + w.novelty * novelty( a )
@@ -142,6 +158,12 @@ export function scoreAffordance(
     - w.inhib   * bias.inhibition
     - w.risk    * risk( a, bias )
   )
+  // POLICY_REAFFERENCE P2 — policy availability damps a POSITIVE activation only,
+  // never flipping its sign: a refused ability competes weakly (so it is rarely
+  // chosen) yet is never removed from the field, keeping re-probe alive as
+  // availability recovers. Absent ⇒ 1 ⇒ no change (byte-identical quiet path).
+  const availability = a.availability ?? 1
+  return raw > 0 ? raw * availability : raw
 }
 
 /**

package/src/cognition/agency/types.ts

@@ -140,6 +140,15 @@ export interface Affordance {
    * competition WITHOUT bypassing it (the plan biases; the field still decides).
    */
   planBias?:       number
+  /**
+   * Policy availability 0..1 (POLICY_REAFFERENCE P2) — learned from refusals,
+   * distinct from `available` (precondition satisfaction) and from competence.
+   * Present only when < 1 (a refusal has dented it); absent ⇒ fully available,
+   * so a never-refused Will's field is byte-identical. Damps positive activation
+   * in the competition without flipping its sign, so a suppressed ability still
+   * gets an occasional re-probe and can climb back as availability recovers.
+   */
+  availability?:   number
   /** Provenance: the plan whose frontier step projected this affordance. */
   planId?:         string
   /** Provenance: the frontier step id — flows through to action.outcome so the plan advances. */

package/src/cognition/bus.ts

@@ -73,11 +73,11 @@ interface Subscription {
 }
 
 function topicMatches( pattern: string, topic: string ): boolean {
-  if( pattern === '*' ) return true   // global workspace subscription
+  if( pattern === '*') return true   // global workspace subscription
   if( pattern === topic ) return true
   if( pattern.endsWith('.*') ){
     const prefix = pattern.slice( 0, -2 )
-    return topic === prefix || topic.startsWith( prefix + '.' )
+    return topic === prefix || topic.startsWith( prefix + '.')
   }
   return false
 }

package/src/cognition/completion.inbox.ts

@@ -70,7 +70,7 @@ export class CompletionInbox {
     for( const { label, apply } of batch ){
       try { apply() }
       catch( err ){
-        logger.error( `[completion-inbox] "${label}" failed while landing at tick ${tick}:`, err )
+        logger.error(`[completion-inbox] "${label}" failed while landing at tick ${tick}:`, err )
       }
     }
 

package/src/cognition/config.mirror.entities.ts

@@ -21,11 +21,11 @@ export interface EngineConfigEntity {
 }
 
 export function buildEngineConfigEntities( config: WillConfig, executiveInterval: number ): EngineConfigEntity[] {
-  const selfBelonging  = parseFloat( process.env.WILL_SELF_BELONGING  ?? '0.35' )
-  const boredomRate    = parseFloat( process.env.WILL_BOREDOM_RATE    ?? '0.005' )
-  const curiosityFloor = parseFloat( process.env.WILL_CURIOSITY_FLOOR ?? '0.08' )
-  const summaryInterval   = parseInt( process.env.WILL_SUMMARY_INTERVAL   ?? '10' )
-  const summaryBufferSize = parseInt( process.env.WILL_SUMMARY_BUFFER_SIZE ?? '12' )
+  const selfBelonging  = parseFloat( process.env.WILL_SELF_BELONGING  ?? '0.35')
+  const boredomRate    = parseFloat( process.env.WILL_BOREDOM_RATE    ?? '0.005')
+  const curiosityFloor = parseFloat( process.env.WILL_CURIOSITY_FLOOR ?? '0.08')
+  const summaryInterval   = parseInt( process.env.WILL_SUMMARY_INTERVAL   ?? '10')
+  const summaryBufferSize = parseInt( process.env.WILL_SUMMARY_BUFFER_SIZE ?? '12')
 
   return [
     // ── System metadata ──────────────────────────────────────────

package/src/cognition/event.log.ts

@@ -84,7 +84,7 @@ export class DefaultEventLog implements EventLog {
   }
 
   private async _writeBatch( batch: CognitiveEvent[] ): Promise<void> {
-    const lines  = batch.map( e => JSON.stringify( e ) ).join( '\n' ) + '\n'
+    const lines  = batch.map( e => JSON.stringify( e ) ).join('\n') + '\n'
     let existing = ''
 
     try {
@@ -92,7 +92,7 @@ export class DefaultEventLog implements EventLog {
         existing = await this._storage.read( this._path )
     } catch { /* file may not exist yet */ }
 
-    await this._storage.ensureDir?.( this._path.replace( /\/[^/]+$/, '' ) )
+    await this._storage.ensureDir?.( this._path.replace( /\/[^/]+$/, '') )
     await this._storage.write( this._path, existing + lines )
   }
 }