@dsh-enhanced/assistant-recovery 0.1.12

package/lib/index.js

@@ -0,0 +1,26 @@
+import { AssistantRecoveryService, Config } from './service.js';
+import { version } from './version.js';
+export const name = 'dsh-enhanced-assistant-recovery';
+export const inject = [
+    'assistantAutomations',
+    'assistantDelivery',
+    'assistantEvaluation',
+    'assistantEvolution',
+    'assistantPreferenceLearning',
+    'assistantHealth',
+];
+export { AssistantRecoveryService, Config, version };
+export * from './attestation.js';
+export * from './automation-executor.js';
+export * from './catalog.js';
+export { ConfigSchema, normalizeRecoveryConfig, } from './config.js';
+export * from './executor.js';
+export * from './port.js';
+export { AssistantRecoveryError, recoveryActivationPlanDigest, recoveryAutomationDefinition, recoveryAutomationId, } from './service.js';
+export * from './store.js';
+export * from './types.js';
+export function apply(ctx, config) {
+    new AssistantRecoveryService(ctx, config);
+}
+export default AssistantRecoveryService;
+//# sourceMappingURL=index.js.map

package/lib/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,wBAAwB,EAAE,MAAM,EAAE,MAAM,cAAc,CAAA;AAE/D,OAAO,EAAE,OAAO,EAAE,MAAM,cAAc,CAAA;AAEtC,MAAM,CAAC,MAAM,IAAI,GAAG,iCAAiC,CAAA;AACrD,MAAM,CAAC,MAAM,MAAM,GAAG;IACpB,sBAAsB;IACtB,mBAAmB;IACnB,qBAAqB;IACrB,oBAAoB;IACpB,6BAA6B;IAC7B,iBAAiB;CAClB,CAAA;AACD,OAAO,EAAE,wBAAwB,EAAE,MAAM,EAAE,OAAO,EAAE,CAAA;AAEpD,cAAc,kBAAkB,CAAA;AAChC,cAAc,0BAA0B,CAAA;AACxC,cAAc,cAAc,CAAA;AAC5B,OAAO,EACL,YAAY,EACZ,uBAAuB,GACxB,MAAM,aAAa,CAAA;AAOpB,cAAc,eAAe,CAAA;AAC7B,cAAc,WAAW,CAAA;AACzB,OAAO,EACL,sBAAsB,EACtB,4BAA4B,EAC5B,4BAA4B,EAC5B,oBAAoB,GACrB,MAAM,cAAc,CAAA;AACrB,cAAc,YAAY,CAAA;AAC1B,cAAc,YAAY,CAAA;AAE1B,MAAM,UAAU,KAAK,CAAC,GAAY,EAAE,MAAkB;IACpD,IAAI,wBAAwB,CAAC,GAAG,EAAE,MAAM,CAAC,CAAA;AAC3C,CAAC;AAED,eAAe,wBAAwB,CAAA"}

package/lib/port.d.ts

@@ -0,0 +1,125 @@
+import type { AssistantAutomationsService } from '@dsh-enhanced/assistant-automations';
+import { canonicalEvaluationHostScope, type AssistantEvaluationService } from '@dsh-enhanced/assistant-evaluation';
+import { type AssistantEvolutionService } from '@dsh-enhanced/assistant-evolution';
+import type { AssistantHealthService } from '@dsh-enhanced/assistant-health';
+import { canonicalPreferenceHostScope, type PreferenceLearningService } from '@dsh-enhanced/preference-learning';
+import type { RecoveryActionReceipt, RecoveryExecutionContext, RecoveryRunbookPort, RecoveryStepPlan } from './executor.js';
+import type { NormalizedRecoveryJob } from './config.js';
+import { type RecoveryStepAction, type RecoveryStepId } from './types.js';
+export declare const RECOVERY_SYSTEM_OWNER: "dsh-enhanced-assistant-recovery";
+/**
+ * Evaluation owns the cross-ledger claim/settle receipt.  Keeping this
+ * structural lets Recovery remain compatible while the optional projection
+ * outbox is rolled out independently from the core Evaluation ledger.
+ */
+export interface RecoveryEvaluationProjectionPort {
+    peekPendingProjection?(input: {
+        scope: ReturnType<typeof canonicalEvaluationHostScope>;
+    }): {
+        evaluationId: string;
+        attemptCount: number;
+    } | undefined;
+    reconcileProjection?(input: {
+        scope: ReturnType<typeof canonicalEvaluationHostScope>;
+        evaluationId: string;
+        operationId: string;
+    }): Promise<{
+        evaluationId: string;
+        status: 'deferred' | 'recorded';
+        attemptCount: number;
+    }>;
+}
+export interface RecoveryRuntimePorts {
+    automations: Pick<AssistantAutomationsService, 'inspectSystemOwned'> & {
+        /** Atomic durable arm + production canary seam. Arm-only repair is unsafe. */
+        probeCircuitAndScheduleCanary?: (input: {
+            owner: string;
+            operationId: string;
+            automationId: string;
+            definitionHash: string;
+            expectedCircuitVersion: number;
+            leaseMs?: number;
+        }) => {
+            operationId: string;
+            circuit: {
+                automationId: string;
+                definitionHash: string;
+                state: string;
+                version: number;
+            };
+            occurrenceId: string;
+            taskId: string;
+            executionMode: 'production';
+            replayed: boolean;
+        };
+    };
+    delivery: {
+        validateOwnerRoute(input: {
+            authorityId: string;
+            principalId: string;
+            workspace: string;
+            agentPreset: string;
+        }): Readonly<{
+            receiptVersion: 2;
+            authorityId: string;
+            authorityHash: string;
+            principalId: string;
+            principalRecordId: string;
+            principalVersion: number;
+            workspace: string;
+            agentPreset: string;
+            bindingVersion: number;
+            generation: number;
+        }>;
+    };
+    evaluation: Pick<AssistantEvaluationService, 'health'> & RecoveryEvaluationProjectionPort;
+    evolution: Pick<AssistantEvolutionService, 'hostCandidates' | 'hostListRules' | 'hostRollbackOne'>;
+    preference: Pick<PreferenceLearningService, 'health' | 'hostActivationCandidate' | 'hostActivateOne' | 'hostMaintainOne' | 'hostReview'> & {
+        hostOwnerFence(input: {
+            scope: ReturnType<typeof canonicalPreferenceHostScope>;
+            principal: string;
+            principalLineage: Readonly<{
+                principalRecordId: string;
+                principalVersion: number;
+            }>;
+            operationId: string;
+        }): Readonly<{
+            ownerGeneration: number;
+            principalLineage: Readonly<{
+                principalRecordId: string;
+                principalVersion: number;
+            }>;
+        }>;
+    };
+    health: Pick<AssistantHealthService, 'hostGlobalSnapshot'>;
+}
+/**
+ * Concrete, model-free adapter over the narrow Host seams of the learning
+ * services. Planning may inspect only the configured scope; mutations are
+ * exact CAS/idempotent operations selected before Recovery persists intent.
+ */
+export declare class HostRecoveryRunbookPort implements RecoveryRunbookPort {
+    private readonly runtime;
+    private readonly jobs;
+    private readonly activationPlanDigests;
+    private readonly authorityHashes;
+    constructor(jobs: ReadonlyMap<string, NormalizedRecoveryJob>, runtime: RecoveryRuntimePorts, activationPlanDigests: ReadonlyMap<string, string>, authorityHashes: ReadonlyMap<string, string>);
+    private validateOwnerRoute;
+    plan(context: RecoveryExecutionContext, stepId: RecoveryStepId, signal: AbortSignal): Promise<RecoveryStepPlan>;
+    execute(context: RecoveryExecutionContext, stepId: RecoveryStepId, action: RecoveryStepAction, idempotencyKey: string, signal: AbortSignal): Promise<RecoveryActionReceipt>;
+    private planAuthority;
+    private planLedger;
+    private planRetention;
+    private planPreferenceActivation;
+    private planEvolutionRollback;
+    private planCircuitProbe;
+    private planVerification;
+    private verifyAuthority;
+    private projectEvaluation;
+    private maintainPreferences;
+    private activatePreference;
+    private rollbackEvolution;
+    private probeCircuit;
+    private verifyHealth;
+}
+//# sourceMappingURL=port.d.ts.map

package/lib/port.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"port.d.ts","sourceRoot":"","sources":["../src/port.ts"],"names":[],"mappings":"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"}