euparliamentmonitor 0.8.4

package/scripts/types/analysis.d.ts

@@ -0,0 +1,115 @@
+/**
+ * @module Types/Analysis
+ * @description Extended analysis types for multi-iteration AI refinement with structured
+ * reasoning chains, scenario planning, confidence indicators, and evidence links.
+ */
+import type { DeepAnalysis } from './common.js';
+/** Confidence level for analysis findings */
+export type ConfidenceLevel = 'high' | 'medium' | 'low';
+/** Reference to a primary source that supports a claim */
+export interface EvidenceReference {
+    /** Unique identifier of the source document / event */
+    readonly id: string;
+    /** Source type */
+    readonly type: 'vote' | 'document' | 'speech' | 'question' | 'procedure';
+    /** Human-readable title */
+    readonly title: string;
+    /** ISO 8601 date string, if available */
+    readonly date?: string;
+    /** Canonical URL for the source, if available */
+    readonly url?: string;
+}
+/** A single step in a structured reasoning chain */
+export interface ReasoningChain {
+    /** The starting assertion or observation */
+    readonly premise: string;
+    /** Supporting evidence documents */
+    readonly evidence: readonly EvidenceReference[];
+    /** The logical step derived from the premise and evidence */
+    readonly inference: string;
+    /** How confident the analyst is in this chain */
+    readonly confidence: ConfidenceLevel;
+    /** Plausible objections to the inference */
+    readonly counterArguments: readonly string[];
+    /** The final deduction drawn from this chain */
+    readonly conclusion: string;
+}
+/** Impact on a specific stakeholder within a scenario */
+export interface ScenarioStakeholderImpact {
+    /** Name or description of the stakeholder */
+    readonly stakeholder: string;
+    /** Description of how they are affected */
+    readonly impact: string;
+    /** Severity of the impact */
+    readonly severity: 'low' | 'medium' | 'high' | 'critical';
+}
+/** A single plausible future scenario */
+export interface Scenario {
+    /** Narrative description of the scenario */
+    readonly description: string;
+    /** Probability estimate in the range [0, 1] */
+    readonly probability: number;
+    /** Conditions that would trigger or confirm this scenario */
+    readonly triggers: readonly string[];
+    /** How different stakeholders are affected */
+    readonly implications: readonly ScenarioStakeholderImpact[];
+    /** Expected timeframe for the scenario to materialise */
+    readonly timeline: string;
+}
+/** Three-scenario planning framework plus wildcard signals */
+export interface ScenarioPlanning {
+    /** Optimistic future state */
+    readonly bestCase: Scenario;
+    /** Pessimistic future state */
+    readonly worstCase: Scenario;
+    /** Most probable future state */
+    readonly mostLikely: Scenario;
+    /** Low-probability, high-impact events that could invalidate all scenarios */
+    readonly wildcards: readonly string[];
+}
+/** A single refinement pass in the multi-iteration analysis process */
+export interface EnhancedAnalysisIteration {
+    /** Pass number (1 = initial, 2 = stakeholder_challenge, 3 = evidence_validation, 4 = synthesis) */
+    readonly pass: 1 | 2 | 3 | 4;
+    /** Type of analytical work performed in this pass */
+    readonly type: 'initial' | 'stakeholder_challenge' | 'evidence_validation' | 'synthesis';
+    /** Overall confidence level for findings in this pass */
+    readonly confidence: ConfidenceLevel;
+    /** Key findings from this pass */
+    readonly findings: readonly string[];
+    /** Evidence references consulted */
+    readonly evidenceRefs: readonly EvidenceReference[];
+    /** How this pass refined the previous pass's conclusions */
+    readonly refinements: readonly string[];
+}
+/** Quality and provenance metadata for a completed analysis */
+export interface AnalysisQualityMetadata {
+    /** Aggregate confidence across all iterations */
+    readonly overallConfidence: ConfidenceLevel;
+    /** Strength of the evidence base */
+    readonly evidenceStrength: 'strong' | 'moderate' | 'weak';
+    /** Total number of refinement iterations performed */
+    readonly iterationCount: number;
+    /** Individual iteration records */
+    readonly iterations: readonly EnhancedAnalysisIteration[];
+}
+/**
+ * Extended deep analysis that adds multi-iteration AI refinement on top of
+ * the base "5W + Impact" framework defined in `DeepAnalysis`.
+ *
+ * All additional fields are optional so that existing `DeepAnalysis` objects
+ * remain valid.
+ */
+export interface EnhancedDeepAnalysis extends DeepAnalysis {
+    /** Quality and provenance metadata produced by the multi-iteration pipeline */
+    readonly qualityMetadata?: AnalysisQualityMetadata;
+    /** Three-scenario forward-looking planning section */
+    readonly scenarioPlanning?: ScenarioPlanning;
+    /** Structured reasoning chains that support the main conclusions */
+    readonly reasoningChains?: readonly ReasoningChain[];
+    /** One-paragraph executive summary of the entire analysis */
+    readonly executiveSummary?: string;
+    /** Comparative context: how this event compares with historical precedents */
+    readonly comparativeContext?: string;
+}
+//# sourceMappingURL=analysis.d.ts.map

package/scripts/types/analysis.d.ts.map

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

package/scripts/types/analysis.js

@@ -0,0 +1,4 @@
+// SPDX-FileCopyrightText: 2024-2026 Hack23 AB
+// SPDX-License-Identifier: Apache-2.0
+export {};
+//# sourceMappingURL=analysis.js.map

package/scripts/types/analysis.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"analysis.js","sourceRoot":"","sources":["../../src/types/analysis.ts"],"names":[],"mappings":"AAAA,8CAA8C;AAC9C,sCAAsC"}