@principles/core 1.131.0 → 1.132.0

package/dist/runtime-v2/types/evidence-chain-contract.d.ts

@@ -0,0 +1,173 @@
+/**
+ * EvidenceChainContract — shared core contracts and assembly mapper for
+ * the Pain Evidence Chain (PRI-385).
+ *
+ * This file is purely logical (no fs, db, or network dependencies) and
+ * lives inside principles-core to be shared by Console read models,
+ * CLI commands, and test fixtures.
+ */
+export type EvidenceChainState = 'recorded-only' | 'evidence-only' | 'diagnosis-queued' | 'diagnosis-running' | 'diagnosis-succeeded' | 'diagnosis-failed' | 'diagnosis-retry-wait' | 'candidate-generated' | 'internalization-missing' | 'internalization-pending' | 'internalization-running' | 'internalization-failed' | 'internalization-succeeded' | 'owner-reviewable' | 'malformed' | 'degraded';
+export declare const EvidenceChainStateSchema: import("@sinclair/typebox").TUnion<[import("@sinclair/typebox").TLiteral<"recorded-only">, import("@sinclair/typebox").TLiteral<"evidence-only">, import("@sinclair/typebox").TLiteral<"diagnosis-queued">, import("@sinclair/typebox").TLiteral<"diagnosis-running">, import("@sinclair/typebox").TLiteral<"diagnosis-succeeded">, import("@sinclair/typebox").TLiteral<"diagnosis-failed">, import("@sinclair/typebox").TLiteral<"diagnosis-retry-wait">, import("@sinclair/typebox").TLiteral<"candidate-generated">, import("@sinclair/typebox").TLiteral<"internalization-missing">, import("@sinclair/typebox").TLiteral<"internalization-pending">, import("@sinclair/typebox").TLiteral<"internalization-running">, import("@sinclair/typebox").TLiteral<"internalization-failed">, import("@sinclair/typebox").TLiteral<"internalization-succeeded">, import("@sinclair/typebox").TLiteral<"owner-reviewable">, import("@sinclair/typebox").TLiteral<"malformed">, import("@sinclair/typebox").TLiteral<"degraded">]>;
+export interface EvidenceChainRecord {
+    id: string;
+    sourceKind: string;
+    observedAt: string;
+    state: EvidenceChainState;
+    summary: string;
+    admissionDecision?: string;
+    linkedPainId?: string;
+    linkedTaskId?: string;
+    linkedTaskStatus?: string;
+    linkedCandidateId?: string;
+    linkedPrincipleId?: string;
+    failureReason?: string;
+    degradedReason?: string;
+    nextAction?: string;
+    candidateTitle?: string;
+    candidateSummary?: string;
+    rootCauseSummary?: string;
+    confidence?: number;
+    recommendationKind?: string;
+    internalizationTaskId?: string;
+    dreamerTaskStatus?: string;
+}
+export declare const EvidenceChainRecordSchema: import("@sinclair/typebox").TObject<{
+    id: import("@sinclair/typebox").TString;
+    sourceKind: import("@sinclair/typebox").TString;
+    observedAt: import("@sinclair/typebox").TString;
+    state: import("@sinclair/typebox").TUnion<[import("@sinclair/typebox").TLiteral<"recorded-only">, import("@sinclair/typebox").TLiteral<"evidence-only">, import("@sinclair/typebox").TLiteral<"diagnosis-queued">, import("@sinclair/typebox").TLiteral<"diagnosis-running">, import("@sinclair/typebox").TLiteral<"diagnosis-succeeded">, import("@sinclair/typebox").TLiteral<"diagnosis-failed">, import("@sinclair/typebox").TLiteral<"diagnosis-retry-wait">, import("@sinclair/typebox").TLiteral<"candidate-generated">, import("@sinclair/typebox").TLiteral<"internalization-missing">, import("@sinclair/typebox").TLiteral<"internalization-pending">, import("@sinclair/typebox").TLiteral<"internalization-running">, import("@sinclair/typebox").TLiteral<"internalization-failed">, import("@sinclair/typebox").TLiteral<"internalization-succeeded">, import("@sinclair/typebox").TLiteral<"owner-reviewable">, import("@sinclair/typebox").TLiteral<"malformed">, import("@sinclair/typebox").TLiteral<"degraded">]>;
+    summary: import("@sinclair/typebox").TString;
+    admissionDecision: import("@sinclair/typebox").TOptional<import("@sinclair/typebox").TString>;
+    linkedPainId: import("@sinclair/typebox").TOptional<import("@sinclair/typebox").TString>;
+    linkedTaskId: import("@sinclair/typebox").TOptional<import("@sinclair/typebox").TString>;
+    linkedTaskStatus: import("@sinclair/typebox").TOptional<import("@sinclair/typebox").TString>;
+    linkedCandidateId: import("@sinclair/typebox").TOptional<import("@sinclair/typebox").TString>;
+    linkedPrincipleId: import("@sinclair/typebox").TOptional<import("@sinclair/typebox").TString>;
+    failureReason: import("@sinclair/typebox").TOptional<import("@sinclair/typebox").TString>;
+    degradedReason: import("@sinclair/typebox").TOptional<import("@sinclair/typebox").TString>;
+    nextAction: import("@sinclair/typebox").TOptional<import("@sinclair/typebox").TString>;
+    candidateTitle: import("@sinclair/typebox").TOptional<import("@sinclair/typebox").TString>;
+    candidateSummary: import("@sinclair/typebox").TOptional<import("@sinclair/typebox").TString>;
+    rootCauseSummary: import("@sinclair/typebox").TOptional<import("@sinclair/typebox").TString>;
+    confidence: import("@sinclair/typebox").TOptional<import("@sinclair/typebox").TNumber>;
+    recommendationKind: import("@sinclair/typebox").TOptional<import("@sinclair/typebox").TString>;
+    internalizationTaskId: import("@sinclair/typebox").TOptional<import("@sinclair/typebox").TString>;
+    dreamerTaskStatus: import("@sinclair/typebox").TOptional<import("@sinclair/typebox").TString>;
+}>;
+export interface EvidenceChainResponse {
+    records: EvidenceChainRecord[];
+    generatedAt: string;
+    degradedReason?: string;
+    nextAction?: string;
+    note?: string;
+}
+export declare const EvidenceChainResponseSchema: import("@sinclair/typebox").TObject<{
+    records: import("@sinclair/typebox").TArray<import("@sinclair/typebox").TObject<{
+        id: import("@sinclair/typebox").TString;
+        sourceKind: import("@sinclair/typebox").TString;
+        observedAt: import("@sinclair/typebox").TString;
+        state: import("@sinclair/typebox").TUnion<[import("@sinclair/typebox").TLiteral<"recorded-only">, import("@sinclair/typebox").TLiteral<"evidence-only">, import("@sinclair/typebox").TLiteral<"diagnosis-queued">, import("@sinclair/typebox").TLiteral<"diagnosis-running">, import("@sinclair/typebox").TLiteral<"diagnosis-succeeded">, import("@sinclair/typebox").TLiteral<"diagnosis-failed">, import("@sinclair/typebox").TLiteral<"diagnosis-retry-wait">, import("@sinclair/typebox").TLiteral<"candidate-generated">, import("@sinclair/typebox").TLiteral<"internalization-missing">, import("@sinclair/typebox").TLiteral<"internalization-pending">, import("@sinclair/typebox").TLiteral<"internalization-running">, import("@sinclair/typebox").TLiteral<"internalization-failed">, import("@sinclair/typebox").TLiteral<"internalization-succeeded">, import("@sinclair/typebox").TLiteral<"owner-reviewable">, import("@sinclair/typebox").TLiteral<"malformed">, import("@sinclair/typebox").TLiteral<"degraded">]>;
+        summary: import("@sinclair/typebox").TString;
+        admissionDecision: import("@sinclair/typebox").TOptional<import("@sinclair/typebox").TString>;
+        linkedPainId: import("@sinclair/typebox").TOptional<import("@sinclair/typebox").TString>;
+        linkedTaskId: import("@sinclair/typebox").TOptional<import("@sinclair/typebox").TString>;
+        linkedTaskStatus: import("@sinclair/typebox").TOptional<import("@sinclair/typebox").TString>;
+        linkedCandidateId: import("@sinclair/typebox").TOptional<import("@sinclair/typebox").TString>;
+        linkedPrincipleId: import("@sinclair/typebox").TOptional<import("@sinclair/typebox").TString>;
+        failureReason: import("@sinclair/typebox").TOptional<import("@sinclair/typebox").TString>;
+        degradedReason: import("@sinclair/typebox").TOptional<import("@sinclair/typebox").TString>;
+        nextAction: import("@sinclair/typebox").TOptional<import("@sinclair/typebox").TString>;
+        candidateTitle: import("@sinclair/typebox").TOptional<import("@sinclair/typebox").TString>;
+        candidateSummary: import("@sinclair/typebox").TOptional<import("@sinclair/typebox").TString>;
+        rootCauseSummary: import("@sinclair/typebox").TOptional<import("@sinclair/typebox").TString>;
+        confidence: import("@sinclair/typebox").TOptional<import("@sinclair/typebox").TNumber>;
+        recommendationKind: import("@sinclair/typebox").TOptional<import("@sinclair/typebox").TString>;
+        internalizationTaskId: import("@sinclair/typebox").TOptional<import("@sinclair/typebox").TString>;
+        dreamerTaskStatus: import("@sinclair/typebox").TOptional<import("@sinclair/typebox").TString>;
+    }>>;
+    generatedAt: import("@sinclair/typebox").TString;
+    degradedReason: import("@sinclair/typebox").TOptional<import("@sinclair/typebox").TString>;
+    nextAction: import("@sinclair/typebox").TOptional<import("@sinclair/typebox").TString>;
+    note: import("@sinclair/typebox").TOptional<import("@sinclair/typebox").TString>;
+}>;
+export declare function mapSourceKind(source: string): string;
+export declare function inferAdmissionDecision(sourceKind: string): string;
+export interface ChainStateParams {
+    sourceKind: string;
+    taskStatus?: string;
+    hasCandidate: boolean;
+    dreamerStatus?: string;
+    ledgerPrincipleStatus?: string;
+}
+export declare function determineState(params: ChainStateParams): EvidenceChainState;
+export interface NextActionContext {
+    state: EvidenceChainState;
+    workspaceDir: string;
+    /**
+     * Display record id (`pain_*` / `manual_*` / task-derived). Carried for context only;
+     * it is NOT a valid `--pain-id` (format mismatch with the `diagnosis_${painId}` convention).
+     */
+    recordId?: string;
+    /** The actual diagnostician task_id; the authoritative source for the retry painId (ERR-008). */
+    linkedTaskId?: string;
+}
+export declare function determineNextAction(ctx: NextActionContext): string | undefined;
+export declare function resolveSummary(fields: {
+    candidateTitle?: string;
+    rootCauseSummary?: string;
+    painText?: string;
+    painReason?: string;
+    fallback: string;
+}): string;
+export interface NormalizationResult {
+    success: boolean;
+    normalized?: string;
+    reason?: string;
+    nextAction?: string;
+}
+export declare function normalizeDiagnosticianTaskId(taskId: string): NormalizationResult;
+export interface TaskMapEntry {
+    taskId: string;
+    status: string;
+    lastError: string | null;
+    createdAt: string;
+    rootCauseSummary?: string;
+    diagnosticJsonDegraded?: boolean;
+    inputRef?: string;
+}
+export declare function crossReferenceByTimestamp(painEvents: {
+    painId: string;
+    createdAt: string;
+    source: string;
+}[], taskMap: Map<string, TaskMapEntry>, coveredPainIds: Set<string>): Map<string, TaskMapEntry>;
+export interface CandidateInfo {
+    candidateId: string;
+    title?: string;
+    description?: string;
+    confidence?: number;
+    recommendationKind?: string;
+}
+export interface DreamerTaskInfo {
+    taskId: string;
+    status: string;
+}
+export interface LedgerPrinciple {
+    id: string;
+    derivedFromPainIds?: string[];
+    text?: string;
+    status?: string;
+    createdAt?: string;
+}
+export declare function assembleEvidenceChain(params: {
+    workspaceDir: string;
+    painEvents: unknown[];
+    tasks: unknown[];
+    candidates: unknown[];
+    dreamerTasks: unknown[];
+    ledgerPrinciples: LedgerPrinciple[];
+    trajectoryDbAvailable: boolean;
+    stateDbAvailable: boolean;
+    degradedReasons?: string[];
+    degradedNextActions?: string[];
+}): EvidenceChainResponse;
+//# sourceMappingURL=evidence-chain-contract.d.ts.map

package/dist/runtime-v2/types/evidence-chain-contract.d.ts.map

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