@alan512/experienceengine 0.1.0 → 0.1.3

package/dist/interaction/service.d.ts

@@ -1,9 +1,6 @@
 import type { ExperienceEngineConfig } from "../config/config-schema.js";
-import { type DeployCompiledPackResult } from "../compiler/deployer.js";
-import type { CompilerTarget, CompileResult } from "../compiler/types.js";
-import type { ExperiencePackCompiledArtifact, ExperiencePackCompileStatus, ExperiencePackSummary, ExperiencePackVersionManifest } from "../packs/types.js";
 import { type BenchmarkSummary } from "../evaluation/benchmark-summary.js";
-import type { CandidateLifecycleState, DistillationSource, DistillationJobState, EvaluationMode, ExperienceInputRecord, FeedbackAttributionReason, InjectionEvent, InjectionScorecard, ExperienceNode, ExperienceNodeType, ExperienceState } from "../types/domain.js";
+import type { CandidateLifecycleState, DistillationSource, DistillationJobState, EvaluationMode, ExperienceInputRecord, FeedbackAttributionReason, InjectionEvent, InjectionScorecard, ExperienceNode, ExperienceNodeType, ExperienceState, TaskRun } from "../types/domain.js";
 import { type ExperienceRepoSummary } from "./repo-summary.js";
 export type ExperienceNodeSummary = {
     id: string;
@@ -14,6 +11,11 @@ export type ExperienceNodeSummary = {
     distillationMode?: ExperienceNode["distillation_mode_used"];
     distillationSource?: ExperienceNode["distillation_source"];
     redistilledFrom?: ExperienceNode["redistilled_from"];
+    promotionSignal?: ExperienceNode["promotion_signal"];
+    promotionReason?: ExperienceNode["promotion_reason"];
+    mergeDecision?: ExperienceNode["merge_decision"];
+    mergeReason?: ExperienceNode["merge_reason"];
+    priorityPromotionApplied?: boolean;
     triggerPattern: string;
     evidenceSummary: string;
     originRecordIds: string[];
@@ -21,6 +23,15 @@ export type ExperienceNodeSummary = {
     harmed: number;
     lastUsedAt?: string;
     hint: string;
+    qualityBand: "strong" | "building" | "risky";
+    qualityDrivers: string[];
+    applicabilityProfile: {
+        bestFit: string;
+        scopeValidity: string;
+        confidence: "high" | "medium" | "low";
+        risk: "low" | "medium" | "high";
+        avoidWhen?: string;
+    };
 };
 export type ExperienceNodeDetail = ExperienceNodeSummary & {
     scopeId: string;
@@ -53,9 +64,12 @@ export type ExperienceLastInspection = {
     hints: string[];
     evidence: string[];
     scorecard?: InjectionScorecard;
+    decisionExplanation?: string;
+    trustSummary?: string;
+    retrievalNotes: string[];
     timeline: ExperienceTimelineEntry[];
-    activePacks: ExperienceScopePackActivationView[];
-    matchedPacks: ExperienceScopePackActivationView[];
+    learningStatus?: TaskRun["learning_status"];
+    learningReason?: string;
     summary: string;
     createdAt: string;
 };
@@ -115,14 +129,6 @@ export type ExperienceLearningSummary = {
         outcomes: number;
         reviews: number;
     };
-    compiler: {
-        publishedPacks: number;
-        compiledTargets: number;
-        stalePublishedPacks: number;
-        latestCompiledArtifact?: (ExperiencePackCompiledArtifact & {
-            packId: string;
-        }) | undefined;
-    };
     latestRecordCreatedAt?: string;
 };
 export type ExperienceFirstValueReadiness = {
@@ -132,50 +138,25 @@ export type ExperienceFirstValueReadiness = {
     nodes: number;
     nextStep: string;
 };
-export type ExperiencePackSummaryView = ExperiencePackSummary;
-export type ExperiencePackDetailView = ExperiencePackSummary & {
-    manifest: ExperiencePackVersionManifest;
-    nodeIds: string[];
-    compiledArtifacts: ExperiencePackCompiledArtifact[];
-    compileStatus: ExperiencePackCompileStatus;
-    activations: Array<{
-        scopeId: string;
-        enabled: boolean;
-        pinnedVersion?: string;
-        updatedAt: string;
-    }>;
-};
-export type ExperienceScopePackActivationView = {
-    scopeId: string;
-    packId: string;
-    status: ExperiencePackSummary["status"];
-    currentVersion: string;
-    pinnedVersion?: string;
-    enabled: boolean;
-    updatedAt: string;
-};
-export type ExperienceScopePackStatusView = {
-    scopeId: string;
-    enabledCount: number;
-    activations: ExperienceScopePackActivationView[];
-    compiler: {
-        publishedPacks: number;
-        compiledTargets: number;
-        stalePublishedPacks: number;
-        latestCompiledArtifact?: (ExperiencePackCompiledArtifact & {
-            packId: string;
-        }) | undefined;
-    };
-};
-export type ExperiencePackCompileView = CompileResult;
-export type ExperiencePackDeploymentStatusView = DeployCompiledPackResult;
-export type ExperiencePackActivationResult = {
+export type ExperienceSilenceReason = "warming_up" | "no_strong_match" | "withheld_low_confidence" | "non_applicable_turn" | "unknown";
+export type ExperienceDecisionHealth = {
     scopeId: string;
-    packId: string;
-    enabled: boolean;
-    pinnedVersion?: string;
-    updatedAt: string;
+    recentDecisions: number;
+    recentInjects: number;
+    recentConservativeInjects: number;
+    recentSkips: number;
+    recentFastPathActivations: number;
+    recentRerankParticipations: number;
+    recentQueryRewriteUsages: number;
+    currentPriorityCandidates: number;
+    recentConvergedUpdates: number;
+    recentPriorityPromotions: number;
+    lastDecisionMode?: "inject" | "inject_conservative" | "skip";
 };
+export declare const deriveStructuredSilenceReason: (input: {
+    inspection: ExperienceLastInspection;
+    readiness: ExperienceFirstValueReadiness;
+}) => ExperienceSilenceReason;
 export declare class ExperienceInteractionService {
     private readonly inputRepo;
     private readonly injectionRepo;
@@ -186,14 +167,11 @@ export declare class ExperienceInteractionService {
     private readonly outcomeRepo;
     private readonly reviewEventRepo;
     private readonly scopeRepo;
-    private readonly packRepo;
-    private readonly packRegistry;
-    private readonly packsDir;
-    constructor(config: ExperienceEngineConfig, options?: {
-        packsDir?: string;
-    });
+    constructor(config: ExperienceEngineConfig);
     private inspectRecord;
-    inspectLast(): ExperienceLastInspection | undefined;
+    private inspectInjectionEvent;
+    inspectLast(cwd?: string): ExperienceLastInspection | undefined;
+    inspectLatestInjected(cwd?: string): ExperienceLastInspection | undefined;
     inspectRecent(options?: {
         injectedOnly?: boolean;
         limit?: number;
@@ -201,42 +179,14 @@ export declare class ExperienceInteractionService {
     listActiveNodes(): ExperienceNodeSummary[];
     listAllNodes(): ExperienceNodeSummary[];
     inspectNode(nodeId: string): ExperienceNodeDetail | undefined;
-    listPacks(): ExperiencePackSummaryView[];
-    inspectPack(packId: string): ExperiencePackDetailView | undefined;
-    enablePack(args: {
-        packId: string;
-        cwd?: string;
-    }): ExperiencePackActivationResult;
-    disablePack(args: {
-        packId: string;
-        cwd?: string;
-    }): ExperiencePackActivationResult;
-    compilePack(args: {
-        packId: string;
-        version?: string;
-        target: CompilerTarget;
-    }): ExperiencePackCompileView;
-    inspectPackDeploymentStatus(args: {
-        packId: string;
-        version?: string;
-        target: CompilerTarget;
-        repoPath: string;
-    }): ExperiencePackDeploymentStatusView;
-    deployPackPreview(args: {
-        packId: string;
-        version?: string;
-        target: CompilerTarget;
-        repoPath: string;
-    }): ExperiencePackDeploymentStatusView;
-    inspectScopePackStatus(cwd?: string): ExperienceScopePackStatusView;
-    private inspectScopePackStatusByScopeId;
     listNodesByState(state: ExperienceState): ExperienceNodeSummary[];
     listNodesByType(nodeType: ExperienceNodeType): ExperienceNodeSummary[];
     inspectLearningSummary(): ExperienceLearningSummary;
     private buildLearningSummary;
     inspectRepoSummary(cwd?: string): ExperienceRepoSummary;
-    inspectFirstValueReadiness(): ExperienceFirstValueReadiness;
-    feedbackLast(feedback: FeedbackValue): FeedbackResult;
+    inspectFirstValueReadiness(cwd?: string): ExperienceFirstValueReadiness;
+    inspectDecisionHealth(cwd?: string, limit?: number): ExperienceDecisionHealth;
+    feedbackLast(feedback: FeedbackValue, cwd?: string): FeedbackResult;
     feedbackNode(nodeId: string, feedback: FeedbackValue): FeedbackResult;
     disableScope(cwd?: string): ScopeToggleResult;
     enableScope(cwd?: string): ScopeToggleResult;
@@ -244,5 +194,4 @@ export declare class ExperienceInteractionService {
     retireNode(nodeId: string): NodeLifecycleResult;
     private setScopeDisabled;
     private setNodeState;
-    private inspectRepoDeploymentStatuses;
 }