euparliamentmonitor 0.8.4

package/scripts/types/common.js

@@ -0,0 +1,96 @@
+// SPDX-FileCopyrightText: 2024-2026 Hack23 AB
+// SPDX-License-Identifier: Apache-2.0
+/**
+ * Article category — the primary classifier for content generation.
+ * Each value represents a distinct article type with its own data pipeline,
+ * template structure, and editorial voice.
+ */
+export var ArticleCategory;
+(function (ArticleCategory) {
+    // Prospective — looking ahead
+    ArticleCategory["WEEK_AHEAD"] = "week-ahead";
+    ArticleCategory["MONTH_AHEAD"] = "month-ahead";
+    ArticleCategory["YEAR_AHEAD"] = "year-ahead";
+    // Retrospective — looking back
+    ArticleCategory["WEEK_IN_REVIEW"] = "week-in-review";
+    ArticleCategory["MONTH_IN_REVIEW"] = "month-in-review";
+    ArticleCategory["YEAR_IN_REVIEW"] = "year-in-review";
+    // Real-time
+    ArticleCategory["BREAKING_NEWS"] = "breaking";
+    // Domain-specific
+    ArticleCategory["COMMITTEE_REPORTS"] = "committee-reports";
+    ArticleCategory["MOTIONS"] = "motions";
+    ArticleCategory["PROPOSITIONS"] = "propositions";
+    // Analytical
+    ArticleCategory["DEEP_ANALYSIS"] = "deep-analysis";
+})(ArticleCategory || (ArticleCategory = {}));
+/**
+ * Temporal perspective of an article — derived from its category.
+ * Determines the editorial framing and verb tense.
+ */
+export var ArticlePerspective;
+(function (ArticlePerspective) {
+    /** Forward-looking: previews, agendas, upcoming events */
+    ArticlePerspective["PROSPECTIVE"] = "prospective";
+    /** Backward-looking: reviews, summaries, retrospectives */
+    ArticlePerspective["RETROSPECTIVE"] = "retrospective";
+    /** Live/current: breaking news, urgent developments */
+    ArticlePerspective["REAL_TIME"] = "real-time";
+    /** Deep dive: multi-perspective analysis, root cause */
+    ArticlePerspective["ANALYTICAL"] = "analytical";
+})(ArticlePerspective || (ArticlePerspective = {}));
+/**
+ * Time period scope for periodic articles (look-ahead or in-review).
+ */
+export var TimePeriod;
+(function (TimePeriod) {
+    TimePeriod["WEEK"] = "week";
+    TimePeriod["MONTH"] = "month";
+    TimePeriod["YEAR"] = "year";
+})(TimePeriod || (TimePeriod = {}));
+/**
+ * Analysis perspective for "5 Whys" deep analysis articles.
+ * Each perspective frames the same events through a different lens,
+ * asking "why" iteratively to uncover root causes.
+ */
+export var AnalysisPerspective;
+(function (AnalysisPerspective) {
+    /** Party dynamics, power shifts, political strategy */
+    AnalysisPerspective["POLITICAL"] = "political";
+    /** Budget impact, market effects, fiscal policy */
+    AnalysisPerspective["ECONOMIC"] = "economic";
+    /** Citizen impact, public opinion, social equity */
+    AnalysisPerspective["SOCIAL"] = "social";
+    /** Treaty basis, legal competence, compliance */
+    AnalysisPerspective["LEGAL"] = "legal";
+    /** Climate, sustainability, green transition */
+    AnalysisPerspective["ENVIRONMENTAL"] = "environmental";
+    /** EU external relations, global positioning */
+    AnalysisPerspective["GEOPOLITICAL"] = "geopolitical";
+    /** EU institutional mechanics, inter-institutional balance */
+    AnalysisPerspective["INSTITUTIONAL"] = "institutional";
+})(AnalysisPerspective || (AnalysisPerspective = {}));
+/** Mapping from ArticleCategory to its inherent ArticlePerspective */
+export const CATEGORY_PERSPECTIVE = {
+    [ArticleCategory.WEEK_AHEAD]: ArticlePerspective.PROSPECTIVE,
+    [ArticleCategory.MONTH_AHEAD]: ArticlePerspective.PROSPECTIVE,
+    [ArticleCategory.YEAR_AHEAD]: ArticlePerspective.PROSPECTIVE,
+    [ArticleCategory.WEEK_IN_REVIEW]: ArticlePerspective.RETROSPECTIVE,
+    [ArticleCategory.MONTH_IN_REVIEW]: ArticlePerspective.RETROSPECTIVE,
+    [ArticleCategory.YEAR_IN_REVIEW]: ArticlePerspective.RETROSPECTIVE,
+    [ArticleCategory.BREAKING_NEWS]: ArticlePerspective.REAL_TIME,
+    [ArticleCategory.COMMITTEE_REPORTS]: ArticlePerspective.RETROSPECTIVE,
+    [ArticleCategory.MOTIONS]: ArticlePerspective.RETROSPECTIVE,
+    [ArticleCategory.PROPOSITIONS]: ArticlePerspective.PROSPECTIVE,
+    [ArticleCategory.DEEP_ANALYSIS]: ArticlePerspective.ANALYTICAL,
+};
+/** Mapping from periodic categories to their time period scope */
+export const CATEGORY_TIME_PERIOD = {
+    [ArticleCategory.WEEK_AHEAD]: TimePeriod.WEEK,
+    [ArticleCategory.MONTH_AHEAD]: TimePeriod.MONTH,
+    [ArticleCategory.YEAR_AHEAD]: TimePeriod.YEAR,
+    [ArticleCategory.WEEK_IN_REVIEW]: TimePeriod.WEEK,
+    [ArticleCategory.MONTH_IN_REVIEW]: TimePeriod.MONTH,
+    [ArticleCategory.YEAR_IN_REVIEW]: TimePeriod.YEAR,
+};
+//# sourceMappingURL=common.js.map

package/scripts/types/common.js.map

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

package/scripts/types/generation.d.ts

@@ -0,0 +1,104 @@
+/**
+ * @module Types/Generation
+ * @description Types for the article generation pipeline — article options, metadata,
+ * sitemap entries, and generation statistics.
+ */
+import type { AnalysisPerspective, ArticleCategory, LanguageCode } from './common.js';
+/** Parsed article metadata from filename */
+export interface ParsedArticle {
+    date: string;
+    slug: string;
+    lang: LanguageCode;
+    filename: string;
+}
+/** Article source reference */
+export interface ArticleSource {
+    title: string;
+    url: string;
+}
+/** Options for generating article HTML */
+export interface ArticleOptions {
+    slug: string;
+    title: string;
+    subtitle: string;
+    date: string;
+    category: ArticleCategory;
+    readTime: number;
+    lang: LanguageCode;
+    content: string;
+    keywords?: string[] | undefined;
+    sources?: ArticleSource[] | undefined;
+    analysisPerspectives?: AnalysisPerspective[] | undefined;
+    /** SRI hash (sha256/sha384/sha512) for the styles.css link (e.g. "sha384-…"). If provided, adds integrity and crossorigin attributes. */
+    stylesHash?: string | undefined;
+    /** Languages for which this article has been generated. When provided, the language switcher only shows links for these languages. Defaults to all supported languages. */
+    availableLanguages?: ReadonlyArray<LanguageCode> | undefined;
+}
+/** Sitemap URL entry */
+export interface SitemapUrl {
+    loc: string;
+    lastmod: string;
+    changefreq: string;
+    priority: string;
+}
+/** News article metadata entry */
+export interface ArticleMetadataEntry {
+    filename: string;
+    date: string;
+    slug: string;
+    lang: LanguageCode;
+    title: string;
+    description?: string | undefined;
+    type?: string | undefined;
+}
+/** News metadata database */
+export interface NewsMetadataDatabase {
+    lastUpdated: string;
+    articles: ArticleMetadataEntry[];
+}
+/** Date range for article generation */
+export interface DateRange {
+    start: string;
+    end: string;
+}
+/** Generation statistics */
+export interface GenerationStats {
+    generated: number;
+    skipped: number;
+    dryRun: number;
+    errors: number;
+    articles: string[];
+    timestamp: string;
+    /** Count of translation quality warnings emitted during generation */
+    translationWarnings?: number;
+}
+/** Generation result */
+export interface GenerationResult {
+    success: boolean;
+    files?: number | undefined;
+    slug?: string | undefined;
+    error?: string | undefined;
+}
+/** Article quality score metadata */
+export interface ArticleQualityScore {
+    /** Approximate word count (HTML-stripped) */
+    wordCount: number;
+    /** Number of analysis sections (excludes visualization sections like dashboard, mindmap, SWOT) */
+    analysisSections: number;
+    /** Number of data visualizations (charts, dashboards, mindmaps, SWOT analyses) */
+    visualizationCount: number;
+    /** Number of external evidence references (links to EP resources with a path beyond the homepage) */
+    evidenceReferences: number;
+    /** Overall quality rating */
+    overallScore: 'excellent' | 'good' | 'adequate' | 'needs-improvement';
+}
+/** Table of contents entry */
+export interface TOCEntry {
+    /** Anchor id (without #) */
+    id: string;
+    /** Display label */
+    label: string;
+    /** Nesting level (1 = top-level) */
+    level: 1 | 2;
+}
+//# sourceMappingURL=generation.d.ts.map

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

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

package/scripts/types/generation.js

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

package/scripts/types/generation.js.map

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

package/scripts/types/index.d.ts

@@ -0,0 +1,24 @@
+/**
+ * @module Types
+ * @description Barrel re-export for all EU Parliament Monitor type definitions.
+ *
+ * Bounded contexts:
+ * - **common** — Language codes, article enums, category mappings
+ * - **parliament** — Domain entities (events, committees, documents, voting)
+ * - **generation** — Article pipeline (options, metadata, stats)
+ * - **mcp** — MCP client transport and tool option interfaces
+ * - **world-bank** — World Bank economic data types for article enrichment
+ */
+export { type LanguageCode, type RTLLanguageCode, type AnyLanguageCode, ArticleCategory, ArticlePerspective, TimePeriod, AnalysisPerspective, CATEGORY_PERSPECTIVE, CATEGORY_TIME_PERIOD, type LanguagePreset, type LanguageMap, type ArticleCategoryLabels, type LangTitleSubtitle, type PropositionsStrings, type EditorialStrings, type MotionsStrings, type WeekAheadStrings, type WeekAheadStakeholderStrings, type StakeholderImpactRow, type StakeholderImpactSection, type PoliticalTemperatureBand, type PoliticalTemperature, type BreakingStrings, type ActionConsequence, type StakeholderOutcome, type PoliticalMistake, type DeepAnalysis, type DeepAnalysisStrings, type CommitteeAnalysisContentStrings, } from './common.js';
+export type { ParliamentEvent, CommitteeMeeting, LegislativeDocument, LegislativeProcedure, ParliamentaryQuestion, WeekAheadData, CommitteeDocument, CommitteeData, VotingRecord, VotingPattern, VotingAnomaly, MotionsQuestion, VotingAnomalyIntelligence, CoalitionIntelligence, MEPInfluenceScore, LegislativeVelocity, EPFeedItem, AdoptedTextFeedItem, EventFeedItem, ProcedureFeedItem, MEPFeedItem, DocumentFeedItem, QuestionFeedItem, DeclarationFeedItem, CorporateBodyFeedItem, BreakingNewsFeedData, EPFeedData, VotingIntensity, CoalitionShift, PolarizationIndex, PoliticalSignificanceScore, VotingTrend, CoalitionStabilityReport, LegislativeVelocityReport, } from './parliament.js';
+export type { ParsedArticle, ArticleSource, ArticleOptions, SitemapUrl, ArticleMetadataEntry, NewsMetadataDatabase, DateRange, GenerationStats, GenerationResult, ArticleQualityScore, TOCEntry, } from './generation.js';
+export { type MCPClientOptions, type MCPContentItem, type MCPToolResult, type JSONRPCRequest, type JSONRPCResponse, type PendingRequest, type GetMEPsOptions, type GetPlenarySessionsOptions, type SearchDocumentsOptions, type GetParliamentaryQuestionsOptions, type GetCommitteeInfoOptions, type MonitorLegislativePipelineOptions, type AssessMEPInfluenceOptions, type AnalyzeCoalitionDynamicsOptions, type DetectVotingAnomaliesOptions, type ComparePoliticalGroupsOptions, type AnalyzeLegislativeEffectivenessOptions, type VotingRecordsOptions, type VotingPatternsOptions, type ReportType, type GenerateReportOptions, type AnalyzeCommitteeActivityOptions, type TrackMEPAttendanceOptions, type AnalyzeCountryDelegationOptions, type GeneratePoliticalLandscapeOptions, type GetCurrentMEPsOptions, type GetSpeechesOptions, type GetProceduresOptions, type GetAdoptedTextsOptions, type GetEventsOptions, type GetMeetingActivitiesOptions, type GetMeetingDecisionsOptions, type GetMEPDeclarationsOptions, type GetIncomingMEPsOptions, type GetOutgoingMEPsOptions, type GetHomonymMEPsOptions, type GetPlenaryDocumentsOptions, type GetCommitteeDocumentsOptions, type GetPlenarySessionDocumentsOptions, type GetPlenarySessionDocumentItemsOptions, type GetControlledVocabulariesOptions, type GetExternalDocumentsOptions, type GetMeetingForeseenActivitiesOptions, type GetProcedureEventsOptions, type GetMeetingPlenarySessionDocumentsOptions, type GetMeetingPlenarySessionDocumentItemsOptions, type NetworkAnalysisOptions, type SentimentTrackerOptions, type EarlyWarningSystemOptions, type ComparativeIntelligenceOptions, type CorrelateIntelligenceOptions, type GeneratedStatsCategory, type GetAllGeneratedStatsOptions, type FeedTimeframe, type FeedBaseOptions, type GetMEPsFeedOptions, type GetEventsFeedOptions, type GetProceduresFeedOptions, type GetAdoptedTextsFeedOptions, type GetMEPDeclarationsFeedOptions, type GetDocumentsFeedOptions, type GetPlenaryDocumentsFeedOptions, type GetCommitteeDocumentsFeedOptions, type GetPlenarySessionDocumentsFeedOptions, type GetExternalDocumentsFeedOptions, type GetParliamentaryQuestionsFeedOptions, type GetCorporateBodiesFeedOptions, type GetControlledVocabulariesFeedOptions, } from './mcp.js';
+export type { WBMCPClientOptions, WorldBankIndicator, WorldBankCountry, EconomicContext, EconomicIndicatorSummary, EUCountryCodeMap, PolicyRelevantIndicators, } from './world-bank.js';
+export type { SwotItem, SwotAnalysis, SwotStrings, SwotBuilderStrings, SwotDimensionName, StakeholderType, SwotDimension, SwotCrossReference, TemporalSwotAssessment, MultiDimensionalSwot, MultiDimensionalSwotStrings, DashboardMetric, ChartDataset, ChartData, ChartConfig, DashboardPanel, DashboardConfig, DashboardStrings, DashboardBuilderStrings, MindmapNodeCategory, PolicyConnectionType, PolicyConnectionStrength, ActorType, MindmapBranchColor, MindmapNode, MindmapLayer, PolicyConnection, ActorNode, InfluenceWeight, IntelligenceMindmap, VotingBloc, VoteHighlight, CoalitionMetrics, LegislativePipeline, TrendMetric, TrendAnalytics, StakeholderMetric, } from './visualization.js';
+export type { ArticleGrade, AnalysisDepthScore, StakeholderCoverage, VisualizationQuality, ArticleQualityReport, } from './quality.js';
+export type { CrossReferenceRelationship, CrossReferenceStrength, ArticleCrossReference, TrendCategory, TrendDirection, TrendConfidence, TrendDetection, ArticleSeriesStatus, ArticleSeries, ArticleIndexEntry, IntelligenceIndex, } from './intelligence.js';
+export type { ConfidenceLevel, EvidenceReference, ReasoningChain, ScenarioStakeholderImpact, Scenario, ScenarioPlanning, EnhancedAnalysisIteration, AnalysisQualityMetadata, EnhancedDeepAnalysis, } from './analysis.js';
+export type { AnalysisStakeholderType, StakeholderImpact, StakeholderSeverity, StakeholderPerspective, AnalysisIterationType, AnalysisIteration, StakeholderOutcomeMatrix, } from './stakeholder.js';
+export { ALL_STAKEHOLDER_TYPES } from './stakeholder.js';
+export type { TranslationValidationResult, TranslationValidationMetrics, } from '../utils/content-validator.js';
+//# sourceMappingURL=index.d.ts.map

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

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

package/scripts/types/index.js

@@ -0,0 +1,16 @@
+// SPDX-FileCopyrightText: 2024-2026 Hack23 AB
+// SPDX-License-Identifier: Apache-2.0
+/**
+ * @module Types
+ * @description Barrel re-export for all EU Parliament Monitor type definitions.
+ *
+ * Bounded contexts:
+ * - **common** — Language codes, article enums, category mappings
+ * - **parliament** — Domain entities (events, committees, documents, voting)
+ * - **generation** — Article pipeline (options, metadata, stats)
+ * - **mcp** — MCP client transport and tool option interfaces
+ * - **world-bank** — World Bank economic data types for article enrichment
+ */
+export { ArticleCategory, ArticlePerspective, TimePeriod, AnalysisPerspective, CATEGORY_PERSPECTIVE, CATEGORY_TIME_PERIOD, } from './common.js';
+export { ALL_STAKEHOLDER_TYPES } from './stakeholder.js';
+//# sourceMappingURL=index.js.map

package/scripts/types/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/types/index.ts"],"names":[],"mappings":"AAAA,8CAA8C;AAC9C,sCAAsC;AAEtC;;;;;;;;;;GAUG;AAEH,OAAO,EAIL,eAAe,EACf,kBAAkB,EAClB,UAAU,EACV,mBAAmB,EACnB,oBAAoB,EACpB,oBAAoB,GAqBrB,MAAM,aAAa,CAAC;AA0NrB,OAAO,EAAE,qBAAqB,EAAE,MAAM,kBAAkB,CAAC"}

package/scripts/types/intelligence.d.ts

@@ -0,0 +1,129 @@
+/**
+ * @module Types/Intelligence
+ * @description Cross-article intelligence types for parliamentary trend tracking.
+ * Enables trend detection, historical context linking, and unified intelligence
+ * reporting across all article types.
+ */
+import type { ArticleCategory, LanguageCode } from './common.js';
+/**
+ * Describes a directional relationship between two articles.
+ * - `follows_up`: Current article is a follow-up to the target (target is older)
+ * - `preceded_by`: Current article precedes the target (target is newer)
+ * - `related`: Articles share significant topic/actor overlap
+ * - `contradicts`: Articles present opposing analyses
+ * - `deepens`: Current article provides deeper analysis of the target
+ */
+export type CrossReferenceRelationship = 'follows_up' | 'preceded_by' | 'related' | 'contradicts' | 'deepens';
+/** Signal strength of a cross-reference link */
+export type CrossReferenceStrength = 'strong' | 'moderate' | 'weak';
+/**
+ * A directional reference from one article to another.
+ * Used to build navigational and analytical links between related content.
+ */
+export interface ArticleCrossReference {
+    /** Identifier of the referenced article (YYYY-MM-DD-slug-lang) */
+    targetArticleId: string;
+    /** Nature of the relationship from the source article's perspective */
+    relationship: CrossReferenceRelationship;
+    /** Human-readable description of why these articles are linked */
+    context: string;
+    /** How strongly the two articles are related */
+    strength: CrossReferenceStrength;
+}
+/** Trend category classifying the political domain */
+export type TrendCategory = 'coalition' | 'legislative' | 'procedural' | 'political';
+/** Direction of trend movement over time */
+export type TrendDirection = 'strengthening' | 'weakening' | 'stable' | 'emerging';
+/** Confidence level in a detected trend */
+export type TrendConfidence = 'high' | 'medium' | 'low';
+/**
+ * A parliamentary trend detected across multiple articles.
+ * Requires a minimum of 2 article references to be valid.
+ */
+export interface TrendDetection {
+    /** Unique trend identifier */
+    id: string;
+    /** Human-readable trend name */
+    name: string;
+    /** Political domain this trend belongs to */
+    category: TrendCategory;
+    /** Current momentum direction */
+    direction: TrendDirection;
+    /** ISO date when this trend was first observed */
+    firstSeen: string;
+    /** ISO date when this trend was most recently updated */
+    lastUpdated: string;
+    /** Identifiers of articles that contribute evidence for this trend */
+    articleReferences: string[];
+    /** Key evidence points supporting the trend */
+    evidence: string[];
+    /** Reliability of the trend detection */
+    confidence: TrendConfidence;
+}
+/** Lifecycle status of an article series */
+export type ArticleSeriesStatus = 'ongoing' | 'concluded';
+/**
+ * A named series of articles tracking a single legislative procedure or topic.
+ */
+export interface ArticleSeries {
+    /** Unique series identifier */
+    id: string;
+    /** Human-readable series name */
+    name: string;
+    /** Optional EP procedure reference (e.g. "2024/0001(COD)") */
+    procedureRef?: string | undefined;
+    /** Ordered list of article IDs in this series */
+    articles: string[];
+    /** Whether the series is still being updated */
+    status: ArticleSeriesStatus;
+    /** Brief editorial summary of the series arc */
+    summary: string;
+}
+/**
+ * Lightweight index entry for a single generated article.
+ * The `id` follows the convention YYYY-MM-DD-slug-lang
+ * (e.g. "2025-03-10-week-ahead-en" or "2025-02-14-ai-regulation-committee-fr").
+ */
+export interface ArticleIndexEntry {
+    /** Article identifier: YYYY-MM-DD-slug-lang */
+    id: string;
+    /** ISO date string (YYYY-MM-DD) */
+    date: string;
+    /** Article category / type */
+    type: ArticleCategory;
+    /** Language code */
+    lang: LanguageCode;
+    /** Key topics covered in the article */
+    keyTopics: string[];
+    /** Key actors (MEPs, committees, political groups) mentioned */
+    keyActors: string[];
+    /** EP procedure references covered in the article */
+    procedures: string[];
+    /** Cross-references to other articles */
+    crossReferences: ArticleCrossReference[];
+    /** Trend IDs this article contributes evidence for */
+    trendContributions: string[];
+    /** Series ID if this article belongs to a series */
+    seriesId?: string | undefined;
+}
+/**
+ * The top-level intelligence index that aggregates cross-article analytics.
+ * Uses `Record<string, string[]>` (not Map) for JSON serialisation compatibility.
+ */
+export interface IntelligenceIndex {
+    /** All indexed articles */
+    articles: ArticleIndexEntry[];
+    /** Actor name → list of article IDs mentioning that actor */
+    actors: Record<string, string[]>;
+    /** Policy domain keyword → list of article IDs covering that domain */
+    policyDomains: Record<string, string[]>;
+    /** EP procedure reference → list of article IDs covering that procedure */
+    procedures: Record<string, string[]>;
+    /** Detected trends across articles */
+    trends: TrendDetection[];
+    /** Article series groupings */
+    series: ArticleSeries[];
+    /** ISO timestamp of last index update */
+    lastUpdated: string;
+}
+//# sourceMappingURL=intelligence.d.ts.map

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

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

package/scripts/types/intelligence.js

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

package/scripts/types/intelligence.js.map

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