@soleri/core 9.3.1 → 9.5.0

package/src/hooks/candidate-scorer.test.ts

@@ -0,0 +1,76 @@
+import { describe, it, expect } from 'vitest';
+import { scoreCandidateForConversion } from './candidate-scorer.js';
+import type { CandidateDimensions } from './candidate-scorer.js';
+
+describe('scoreCandidateForConversion', () => {
+  it('should identify strong candidate (4/4 HIGH)', () => {
+    const dimensions: CandidateDimensions = {
+      frequency: 'HIGH',
+      eventCorrelation: 'HIGH',
+      determinism: 'HIGH',
+      autonomy: 'HIGH',
+    };
+    const result = scoreCandidateForConversion(dimensions);
+    expect(result.highCount).toBe(4);
+    expect(result.candidate).toBe(true);
+  });
+
+  it('should identify borderline candidate (3/4 HIGH)', () => {
+    const dimensions: CandidateDimensions = {
+      frequency: 'HIGH',
+      eventCorrelation: 'HIGH',
+      determinism: 'HIGH',
+      autonomy: 'LOW',
+    };
+    const result = scoreCandidateForConversion(dimensions);
+    expect(result.highCount).toBe(3);
+    expect(result.candidate).toBe(true);
+  });
+
+  it('should reject non-candidate (2/4 HIGH)', () => {
+    const dimensions: CandidateDimensions = {
+      frequency: 'HIGH',
+      eventCorrelation: 'LOW',
+      determinism: 'HIGH',
+      autonomy: 'LOW',
+    };
+    const result = scoreCandidateForConversion(dimensions);
+    expect(result.highCount).toBe(2);
+    expect(result.candidate).toBe(false);
+  });
+
+  it('should reject weak candidate (1/4 HIGH)', () => {
+    const dimensions: CandidateDimensions = {
+      frequency: 'LOW',
+      eventCorrelation: 'LOW',
+      determinism: 'LOW',
+      autonomy: 'HIGH',
+    };
+    const result = scoreCandidateForConversion(dimensions);
+    expect(result.highCount).toBe(1);
+    expect(result.candidate).toBe(false);
+  });
+
+  it('should reject zero score (0/4 HIGH)', () => {
+    const dimensions: CandidateDimensions = {
+      frequency: 'LOW',
+      eventCorrelation: 'LOW',
+      determinism: 'LOW',
+      autonomy: 'LOW',
+    };
+    const result = scoreCandidateForConversion(dimensions);
+    expect(result.highCount).toBe(0);
+    expect(result.candidate).toBe(false);
+  });
+
+  it('should preserve dimension values in result', () => {
+    const dimensions: CandidateDimensions = {
+      frequency: 'HIGH',
+      eventCorrelation: 'LOW',
+      determinism: 'HIGH',
+      autonomy: 'HIGH',
+    };
+    const result = scoreCandidateForConversion(dimensions);
+    expect(result.dimensions).toEqual(dimensions);
+  });
+});

package/src/hooks/candidate-scorer.ts

@@ -0,0 +1,39 @@
+/**
+ * Candidate scoring rubric for skill-to-hook conversion.
+ * 4-dimension scoring: frequency, eventCorrelation, determinism, autonomy.
+ * Threshold: >= 3 HIGH dimensions = candidate for conversion.
+ */
+
+export type DimensionLevel = 'HIGH' | 'LOW';
+
+export interface CandidateDimensions {
+  /** 3+ manual calls per session for same event type → HIGH */
+  frequency: DimensionLevel;
+  /** Skill consistently triggers on a recognizable hook event → HIGH */
+  eventCorrelation: DimensionLevel;
+  /** Skill produces consistent, non-exploratory guidance → HIGH */
+  determinism: DimensionLevel;
+  /** Skill requires no interactive user decisions mid-execution → HIGH */
+  autonomy: DimensionLevel;
+}
+
+export interface CandidateScore {
+  dimensions: CandidateDimensions;
+  highCount: number;
+  candidate: boolean;
+}
+
+/**
+ * Score a skill for hook conversion candidacy.
+ * @param dimensions - The 4 scored dimensions (each HIGH or LOW)
+ * @returns Score with candidate boolean (true if >= 3 HIGH)
+ */
+export function scoreCandidateForConversion(dimensions: CandidateDimensions): CandidateScore {
+  const values = Object.values(dimensions);
+  const highCount = values.filter((v) => v === 'HIGH').length;
+  return {
+    dimensions,
+    highCount,
+    candidate: highCount >= 3,
+  };
+}

package/src/hooks/index.ts

@@ -0,0 +1,6 @@
+export {
+  scoreCandidateForConversion,
+  type CandidateDimensions,
+  type CandidateScore,
+  type DimensionLevel,
+} from './candidate-scorer.js';

package/src/index.ts

@@ -551,6 +551,8 @@ export { createSemanticFacades } from './runtime/facades/index.js';
 export { createDomainFacade, createDomainFacades } from './runtime/domain-ops.js';
 export { FeatureFlags } from './runtime/feature-flags.js';
 export type { FlagDefinition } from './runtime/feature-flags.js';
+export { ShutdownRegistry } from './runtime/shutdown-registry.js';
+export type { ShutdownCallback } from './runtime/shutdown-registry.js';
 export type { AgentRuntimeConfig, AgentRuntime } from './runtime/types.js';
 export {
   deprecationWarning,
@@ -627,6 +629,7 @@ export type {
   LockEntry,
   PackType,
   PackSource,
+  PackTier,
   LockfileData,
   ResolvedPack,
   ResolveOptions,
@@ -799,3 +802,24 @@ export type {
   ProfileSnapshot,
   OperatorProfileHistory,
 } from './operator/operator-types.js';
+
+// ─── Operator Context (Adaptive Persona) ────────────────────────────
+export { OperatorContextStore } from './operator/operator-context-store.js';
+export { DECLINED_CATEGORIES } from './operator/operator-context-types.js';
+export type {
+  OperatorSignals,
+  ExpertiseSignal,
+  CorrectionSignal,
+  InterestSignal,
+  WorkPatternSignal,
+  OperatorContext,
+  ExpertiseItem,
+  CorrectionItem,
+  InterestItem,
+  WorkPatternItem,
+  ExpertiseLevel,
+  SignalScope,
+  PatternFrequency,
+  ContextItemType,
+  DeclinedCategory,
+} from './operator/operator-context-types.js';

package/src/llm/llm-client.ts

@@ -237,6 +237,7 @@ export class LLMClient {
           temperature: options.temperature ?? 0.3,
           max_completion_tokens: options.maxTokens ?? 500,
         }),
+        signal: AbortSignal.timeout(60_000),
       });
 
       if (response.headers) {