bps-mcp-server 0.16.4 → 0.18.0

package/dist/services/kabkota-ranking.js

@@ -0,0 +1,378 @@
+import { getPeriodId, getPeriodLabel, isNeutralPeriodLabel } from "../client/fields.js";
+import { buildStructuredPayload } from "./data-formatter.js";
+import { computeRelevanceScore, searchVariables } from "./variable-search.js";
+import { findKabkotaIndicator } from "../config/kabkota-indicators.js";
+import { logger } from "../utils/logger.js";
+const DEFAULT_CONCURRENCY = 3;
+/** Share of provinces that must publish a year before it is used for all. */
+const COMMON_YEAR_COVERAGE = 0.6;
+/** Kab/kota series older than this are reported as gaps, not ranked. */
+const MAX_DATA_AGE_YEARS = 2;
+export async function rankKabkota(client, resolver, options) {
+    const hint = findKabkotaIndicator(options.query);
+    const provinces = await resolveProvinces(resolver, options.provinces);
+    const missing = [];
+    // Provinces we know only publish province totals: report them as gaps
+    // instead of spending 3 requests each to rediscover that.
+    const included = [];
+    for (const province of provinces) {
+        const knownGap = hint?.unavailable[province.domain];
+        if (knownGap) {
+            missing.push({ province: province.name, reason: knownGap });
+            continue;
+        }
+        included.push(province);
+    }
+    const concurrency = Math.max(1, options.concurrency ?? DEFAULT_CONCURRENCY);
+    // 1. Which variable holds the kab/kota breakdown in each province.
+    const targets = [];
+    for (const province of included) {
+        const candidates = await candidateVariables(client, province, options.query, hint);
+        if (candidates.length === 0) {
+            missing.push({ province: province.name, reason: "tidak ada tabel kabupaten/kota yang cocok" });
+            continue;
+        }
+        targets.push({ province, candidates });
+    }
+    // 2. Pick one comparison year. Each BPS province releases Sakernas at its own
+    //    pace; defaulting to "latest per province" mixes 2024/2025/2026 and makes
+    //    the ranking incomparable (an agent then re-sweeps everything by hand to
+    //    normalise the year — exactly what this tool must prevent).
+    const targetYear = options.year ??
+        (options.periodMode === "latest"
+            ? undefined
+            : await selectTargetYear(client, targets, concurrency));
+    // 3. Fetch and merge.
+    const collected = [];
+    for (let index = 0; index < targets.length; index += concurrency) {
+        const batch = targets.slice(index, index + concurrency);
+        const settled = await Promise.allSettled(batch.map((target) => fetchProvinceRows(client, target, options.query, targetYear)));
+        settled.forEach((outcome, position) => {
+            const target = batch[position];
+            if (outcome.status === "fulfilled") {
+                if (outcome.value.rows.length === 0) {
+                    missing.push({
+                        province: target.province.name,
+                        reason: outcome.value.reason ?? "tidak ada tabel kabupaten/kota yang cocok",
+                    });
+                }
+                else {
+                    collected.push(...outcome.value.rows);
+                }
+            }
+            else {
+                const reason = outcome.reason instanceof Error ? outcome.reason.message : String(outcome.reason);
+                logger.debug(`rankKabkota: ${target.province.name} failed: ${reason}`);
+                missing.push({ province: target.province.name, reason: `gagal diambil (${reason.slice(0, 120)})` });
+            }
+        });
+    }
+    const sorted = collected.sort((a, b) => options.order === "highest" ? b.value - a.value : a.value - b.value);
+    const periods = [...new Set(sorted.map((row) => row.period))];
+    const series = [
+        ...new Set(sorted
+            .map((row) => row.series?.trim())
+            .filter((value) => !!value && !/^tidak ada$/i.test(value))
+            .map((value) => value.replace(/\s+/g, " "))),
+    ];
+    return {
+        rows: sorted.slice(0, Math.max(1, options.topN)),
+        totalRegions: sorted.length,
+        provincesCovered: new Set(collected.map((row) => row.domain)).size,
+        provincesConsidered: provinces.length,
+        periods,
+        series,
+        indicatorLabel: hint?.label ?? (collected[0]?.indicator ?? options.query),
+        missing,
+        targetYear,
+        yearRequested: options.year,
+    };
+}
+async function resolveProvinces(resolver, requested) {
+    await resolver.ensureLoaded();
+    const isProvince = (domain) => domain.length === 4 && domain.endsWith("00") && domain !== "0000";
+    const all = resolver
+        .getDomains()
+        .filter((domain) => isProvince(domain.domain_id))
+        .map((domain) => ({ domain: domain.domain_id, name: domain.domain_name }));
+    const unique = new Map(all.map((province) => [province.domain, province]));
+    if (!requested || requested.length === 0) {
+        return [...unique.values()];
+    }
+    const selected = [];
+    for (const query of requested) {
+        const resolved = await resolver.resolve(query);
+        if (resolved && unique.has(resolved.domainId)) {
+            selected.push(unique.get(resolved.domainId));
+        }
+    }
+    return selected;
+}
+/**
+ * Newest year that enough provinces actually publish. Using the newest *shared*
+ * year keeps the ranking apples-to-apples instead of mixing 2024/2025/2026.
+ */
+async function selectTargetYear(client, targets, concurrency) {
+    if (targets.length === 0)
+        return undefined;
+    const yearCounts = new Map();
+    let reporting = 0;
+    for (let index = 0; index < targets.length; index += concurrency) {
+        const batch = targets.slice(index, index + concurrency);
+        const settled = await Promise.allSettled(batch.map(async (target) => {
+            const periods = await client.listPeriods(target.province.domain, Number(target.candidates[0].varId));
+            const years = new Set(periods
+                .map((period) => getPeriodLabel(period).match(/\d{4}/)?.[0])
+                .filter((year) => !!year));
+            return years;
+        }));
+        for (const outcome of settled) {
+            if (outcome.status !== "fulfilled" || outcome.value.size === 0)
+                continue;
+            reporting += 1;
+            for (const year of outcome.value) {
+                yearCounts.set(year, (yearCounts.get(year) ?? 0) + 1);
+            }
+        }
+    }
+    if (yearCounts.size === 0)
+        return undefined;
+    const threshold = Math.max(2, Math.ceil(reporting * COMMON_YEAR_COVERAGE));
+    const eligible = [...yearCounts.entries()]
+        .filter(([, count]) => count >= threshold)
+        .map(([year]) => year)
+        .sort();
+    if (eligible.length > 0)
+        return eligible[eligible.length - 1];
+    // No shared year: take the most common one rather than mixing all of them.
+    return [...yearCounts.entries()]
+        .sort((a, b) => b[1] - a[1] || b[0].localeCompare(a[0]))[0]?.[0];
+}
+async function fetchProvinceRows(client, target, query, year) {
+    const { province, candidates } = target;
+    for (const candidate of candidates) {
+        try {
+            const periodId = await findPeriodId(client, province.domain, candidate.varId, year);
+            if (!periodId) {
+                if (year)
+                    return { rows: [], reason: `belum ada data ${year}` };
+                continue;
+            }
+            const response = await client.getDynamicData(province.domain, candidate.varId, periodId);
+            const payload = buildStructuredPayload(response, province.domain);
+            const rows = pickRegionRows(payload.rows, query, province);
+            if (rows.length >= 2) {
+                const staleYear = stalenessYear(rows);
+                if (staleYear !== null) {
+                    return {
+                        rows: [],
+                        reason: `data terbaru ${staleYear} (lebih dari ${MAX_DATA_AGE_YEARS} tahun)`,
+                    };
+                }
+                logger.debug(`rankKabkota: ${province.name} → var ${candidate.varId} (${rows.length} kab/kota)`);
+                return { rows };
+            }
+        }
+        catch (error) {
+            logger.debug(`rankKabkota: ${province.name} var ${candidate.varId} failed: ${error instanceof Error ? error.message : String(error)}`);
+        }
+    }
+    return { rows: [], reason: "tidak ada tabel kabupaten/kota yang cocok" };
+}
+/** Year of the newest row, or null when the whole series is recent enough. */
+function stalenessYear(rows) {
+    const years = rows
+        .map((row) => Number(row.period.match(/\d{4}/)?.[0] ?? 0))
+        .filter((year) => year > 1900);
+    if (years.length === 0)
+        return null;
+    const newest = Math.max(...years);
+    return new Date().getFullYear() - newest > MAX_DATA_AGE_YEARS ? newest : null;
+}
+async function candidateVariables(client, province, query, hint) {
+    const hinted = hint?.variables[province.domain];
+    if (hinted) {
+        return [{ varId: hinted, title: hint.label }];
+    }
+    const discovered = await searchVariables(client, province.domain, query, {
+        maxSubjects: 6,
+        maxPagesPerSubject: 3,
+        maxCandidates: 12,
+    });
+    return discovered
+        .slice(0, 4)
+        .map((candidate) => ({ varId: String(candidate.var_id), title: candidate.title }));
+}
+/**
+ * Resolve the period to request. BPS requires `th`, so with no year we take the
+ * newest period the variable publishes (periods come back newest-first).
+ */
+async function findPeriodId(client, domain, varId, year) {
+    const periods = await client.listPeriods(domain, Number(varId));
+    if (periods.length === 0)
+        return undefined;
+    if (!year)
+        return getPeriodId(periods[0]) || undefined;
+    const matching = periods.filter((period) => getPeriodLabel(period).includes(year));
+    if (matching.length === 0)
+        return undefined;
+    // Prefer the annual/August period when a year has several (Feb vs Aug).
+    const withAgustus = matching.find((period) => /agustus|tahunan/i.test(getPeriodLabel(period)));
+    return getPeriodId(withAgustus ?? matching[matching.length - 1]) || undefined;
+}
+/**
+ * Keep one value per kabupaten/kota, choosing the series that matches the query
+ * (e.g. TPT rather than TPAK when a table packs several indicators).
+ */
+function pickRegionRows(rows, query, province) {
+    const regions = rows.filter((row) => isRegionRow(row, province));
+    if (regions.length === 0)
+        return [];
+    const series = selectSeries(regions, query);
+    let candidates = regions;
+    if (series !== null) {
+        const matching = regions.filter((row) => normalize(row.series) === series);
+        if (matching.length > 0)
+            candidates = matching;
+    }
+    const subperiod = selectSubperiod(candidates);
+    if (subperiod !== null) {
+        const matching = candidates.filter((row) => normalize(row.subperiod) === subperiod);
+        if (matching.length > 0)
+            candidates = matching;
+    }
+    const byRegion = new Map();
+    for (const row of candidates) {
+        const region = (row.category ?? "").replace(/^\d+\s*[-–]?\s*/, "").trim();
+        if (!region || byRegion.has(region))
+            continue;
+        if (typeof row.value !== "number" || !Number.isFinite(row.value))
+            continue;
+        const unit = row.unit ?? "";
+        // Guard against broken source rows (e.g. an unemployment count of 9.154
+        // published as a percentage). Percentages above 100 are data errors.
+        if (/persen|percent|%/i.test(unit) && (row.value < 0 || row.value > 100))
+            continue;
+        byRegion.set(region, {
+            region: titleCaseRegion(region),
+            province: province.name,
+            domain: province.domain,
+            value: row.value,
+            period: [row.period, isNeutralPeriodLabel(row.subperiod) ? undefined : row.subperiod]
+                .filter(Boolean)
+                .join(" "),
+            series: row.series?.trim(),
+            unit,
+            indicator: row.indicator,
+        });
+    }
+    return [...byRegion.values()];
+}
+function isRegionRow(row, province) {
+    const label = (row.category ?? "").trim();
+    if (!label)
+        return false;
+    if (/^(indonesia|nasional|total|jumlah)$/i.test(label))
+        return false;
+    if (/provinsi/i.test(label))
+        return false;
+    // Rows often carry the domain code: "7600 - Provinsi Sulawesi Barat",
+    // "3301 Kabupaten Cilacap". The province row starts with the province code.
+    if (label.startsWith(province.domain))
+        return false;
+    const stripped = normalize(label.replace(/^\d+\s*[-–]?\s*/, ""));
+    if (stripped === normalize(province.name))
+        return false;
+    return stripped.length > 1;
+}
+/** Pick the series (derived variable) that best matches the query. */
+function selectSeries(rows, query) {
+    const labels = [
+        ...new Set(rows
+            .map((row) => row.series?.trim())
+            .filter((label) => !!label && !/^tidak ada$/i.test(label))),
+    ];
+    if (labels.length === 0)
+        return null;
+    if (labels.length === 1)
+        return normalize(labels[0]);
+    const scored = labels
+        .map((label) => {
+        let score = computeRelevanceScore(query, label);
+        if (/persentase|tingkat|rasio|%/i.test(label))
+            score += 15;
+        return { label, score };
+    })
+        .sort((a, b) => b.score - a.score);
+    return scored[0] && scored[0].score > 0 ? normalize(scored[0].label) : normalize(labels[0]);
+}
+/** Prefer the August/annual series when a table has several sub-periods. */
+function selectSubperiod(rows) {
+    const labels = [...new Set(rows.map((row) => row.subperiod).filter((label) => !!label))];
+    if (labels.length <= 1)
+        return null;
+    const preference = [/^agustus$/i, /^tahunan$/i, /semester\s*2/i, /desember/i, /november/i];
+    for (const pattern of preference) {
+        const match = labels.find((label) => pattern.test(label.trim()));
+        if (match)
+            return normalize(match);
+    }
+    return normalize(labels[labels.length - 1]);
+}
+function normalize(value) {
+    return (value ?? "").trim().toLowerCase();
+}
+function titleCaseRegion(value) {
+    // Banten publishes "Kab Pandeglang"/"Kab Serang"; expand for readability.
+    const expanded = value.replace(/^kab\.?\s+/i, "Kabupaten ");
+    if (expanded !== expanded.toUpperCase())
+        return expanded;
+    return expanded
+        .toLowerCase()
+        .split(/\s+/)
+        .map((word) => (word.length > 2 ? word[0].toUpperCase() + word.slice(1) : word.toUpperCase()))
+        .join(" ");
+}
+export function formatKabkotaRanking(result, options) {
+    const lines = [];
+    const unit = result.rows[0]?.unit ? ` (${result.rows[0].unit})` : "";
+    const direction = options.order === "highest" ? "Tertinggi" : "Terendah";
+    const periodLabel = result.periods.length === 1
+        ? result.periods[0]
+        : result.periods.length === 0
+            ? "-"
+            : `${result.periods[0]} … ${result.periods[result.periods.length - 1]}`;
+    const periodHeader = result.targetYear
+        ? `${result.targetYear} (tahun yang sama untuk semua provinsi)`
+        : periodLabel;
+    lines.push(`## Ranking Kabupaten/Kota: ${result.indicatorLabel}${unit}`);
+    lines.push(`**Urutan:** ${direction} | **Periode:** ${periodHeader}`);
+    lines.push("");
+    lines.push("| # | Kabupaten/Kota | Provinsi | Nilai | Periode |");
+    lines.push("| --- | --- | --- | --- | --- |");
+    result.rows.forEach((row, index) => {
+        lines.push(`| ${index + 1} | ${row.region} | ${row.province} | ${row.value.toLocaleString("id-ID")} | ${row.period} |`);
+    });
+    lines.push("");
+    lines.push(`_Cakupan: ${result.totalRegions} kabupaten/kota dari ${result.provincesCovered} provinsi. ` +
+        `Menampilkan ${result.rows.length} teratas._`);
+    if (result.targetYear) {
+        lines.push(`_Angka di atas sudah diseragamkan ke tahun ${result.targetYear}; tidak perlu menyisir ulang tabel provinsi. ` +
+            `Untuk tahun lain: get_ranking(..., year="2025"). Untuk seri terbaru per provinsi: period_mode="latest"._`);
+    }
+    else if (result.periods.length > 1) {
+        lines.push(`_Catatan: periode tidak seragam (${result.periods.join(", ")}) karena period_mode="latest". ` +
+            `Sebutkan tahun per baris, atau panggil ulang dengan year="<tahun>" agar sebanding._`);
+    }
+    if (result.series.length > 1) {
+        lines.push(`_Seri yang dipakai: ${result.series[0]}; seri lain di tabel: ${result.series.slice(1).join(", ")}._`);
+    }
+    if (result.missing.length > 0) {
+        const listed = result.missing.slice(0, 12).map((item) => `${item.province} (${item.reason})`);
+        lines.push("");
+        lines.push(`**Provinsi tanpa data kabupaten/kota:** ${listed.join("; ")}${result.missing.length > 12 ? "; …" : ""}`);
+        lines.push(`_Untuk provinsi tersebut, TPT hanya tersedia level provinsi — gunakan get_ranking(level="provinsi") atau find_data._`);
+    }
+    return lines.join("\n");
+}
+//# sourceMappingURL=kabkota-ranking.js.map

package/dist/services/kabkota-ranking.js.map

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

package/dist/services/period-resolver.d.ts

@@ -0,0 +1,29 @@
+import type { BpsClient } from "../client/bps-client.js";
+export interface YearSpec {
+    /** True when the caller supplied anything at all. */
+    hasSpec: boolean;
+    /** Years requested, ascending. */
+    years: string[];
+    /** Tokens that are not years (assumed to be raw period IDs). */
+    periodIds: string[];
+}
+/** Parse "2021,2022", "2021;2022", "2021-2025", "2021 s.d. 2025" or raw IDs. */
+export declare function parseYearSpec(spec?: string | null): YearSpec;
+export interface ResolvedPeriodEntry {
+    id: string;
+    label: string;
+    year?: string;
+}
+export interface ResolvedPeriodsForSpec {
+    hasSpec: boolean;
+    entries: ResolvedPeriodEntry[];
+    missingYears: string[];
+    /** Years the variable actually has data for, ascending. */
+    availableYears: string[];
+    /** Up to 12 recent period labels, for error messages. */
+    availableLabels: string[];
+}
+export declare function resolvePeriodsForSpec(client: BpsClient, domain: string, varId: number, spec?: string | null): Promise<ResolvedPeriodsForSpec>;
+/** Human readable note about years that had no data. */
+export declare function describeMissingYears(missing: string[], available: string[]): string;
+//# sourceMappingURL=period-resolver.d.ts.map

package/dist/services/period-resolver.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"period-resolver.d.ts","sourceRoot":"","sources":["../../src/services/period-resolver.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,yBAAyB,CAAC;AAazD,MAAM,WAAW,QAAQ;IACvB,qDAAqD;IACrD,OAAO,EAAE,OAAO,CAAC;IACjB,kCAAkC;IAClC,KAAK,EAAE,MAAM,EAAE,CAAC;IAChB,gEAAgE;IAChE,SAAS,EAAE,MAAM,EAAE,CAAC;CACrB;AAED,gFAAgF;AAChF,wBAAgB,aAAa,CAAC,IAAI,CAAC,EAAE,MAAM,GAAG,IAAI,GAAG,QAAQ,CAsC5D;AAgBD,MAAM,WAAW,mBAAmB;IAClC,EAAE,EAAE,MAAM,CAAC;IACX,KAAK,EAAE,MAAM,CAAC;IACd,IAAI,CAAC,EAAE,MAAM,CAAC;CACf;AAED,MAAM,WAAW,sBAAsB;IACrC,OAAO,EAAE,OAAO,CAAC;IACjB,OAAO,EAAE,mBAAmB,EAAE,CAAC;IAC/B,YAAY,EAAE,MAAM,EAAE,CAAC;IACvB,2DAA2D;IAC3D,cAAc,EAAE,MAAM,EAAE,CAAC;IACzB,yDAAyD;IACzD,eAAe,EAAE,MAAM,EAAE,CAAC;CAC3B;AAgBD,wBAAsB,qBAAqB,CACzC,MAAM,EAAE,SAAS,EACjB,MAAM,EAAE,MAAM,EACd,KAAK,EAAE,MAAM,EACb,IAAI,CAAC,EAAE,MAAM,GAAG,IAAI,GACnB,OAAO,CAAC,sBAAsB,CAAC,CAqEjC;AAED,wDAAwD;AACxD,wBAAgB,oBAAoB,CAAC,OAAO,EAAE,MAAM,EAAE,EAAE,SAAS,EAAE,MAAM,EAAE,GAAG,MAAM,CAMnF"}

package/dist/services/period-resolver.js

@@ -0,0 +1,132 @@
+import { getPeriodId, getPeriodLabel, isNeutralPeriodLabel } from "../client/fields.js";
+/**
+ * BPS' WebAPI only accepts period *IDs* (`th`) — never years. Agents naturally
+ * pass "2021,2022" or "2021-2025", which the API silently answers with an empty
+ * dataset. This module maps human year specs to period IDs so no caller has to
+ * call `list_periods` first.
+ */
+const YEAR_PATTERN = /^(19|20)\d{2}$/;
+/** Parse "2021,2022", "2021;2022", "2021-2025", "2021 s.d. 2025" or raw IDs. */
+export function parseYearSpec(spec) {
+    if (!spec || !spec.trim())
+        return { hasSpec: false, years: [], periodIds: [] };
+    // Normalize word-based ranges ("2021 s.d. 2023", "2021 sampai 2023") so the
+    // whitespace split below does not separate the endpoints.
+    const normalizedSpec = spec.replace(/((?:19|20)\d{2})\s*(?:s\.?\s*d\.?|sampai|hingga|to)\s*((?:19|20)\d{2})/gi, "$1-$2");
+    const tokens = normalizedSpec
+        .split(/[,;|]+|\s+/)
+        .map((token) => token.trim())
+        .filter(Boolean);
+    const years = new Set();
+    const periodIds = new Set();
+    for (const token of tokens) {
+        const range = token.match(/^((?:19|20)\d{2})\s*(?:-|–|—|s\.?\s*d\.?|sampai|hingga|to)\s*((?:19|20)\d{2})$/i);
+        if (range) {
+            const start = Number(range[1]);
+            const end = Number(range[2]);
+            if (Number.isFinite(start) && Number.isFinite(end) && end >= start && end - start <= 60) {
+                for (let year = start; year <= end; year++)
+                    years.add(String(year));
+            }
+            continue;
+        }
+        if (YEAR_PATTERN.test(token)) {
+            years.add(token);
+            continue;
+        }
+        periodIds.add(token);
+    }
+    return { hasSpec: true, years: [...years].sort(), periodIds: [...periodIds] };
+}
+/**
+ * Prefer a comparable series across years: annual > first semester (Maret) >
+ * second semester (September) > anything else.
+ */
+function periodPreference(label) {
+    // A bare year (or "Tahunan") is the annual series — the best comparable one.
+    if (/^\s*(19|20)\d{2}\s*$/.test(label))
+        return 5;
+    if (isNeutralPeriodLabel(label))
+        return 4;
+    if (/semester\s*1|maret|triwulan\s*(i{1}|1)\b|kwartal\s*1/i.test(label))
+        return 3;
+    if (/semester\s*2|september/i.test(label))
+        return 2;
+    if (/desember|desember|december/i.test(label))
+        return 1.5;
+    return 1;
+}
+async function listAllPeriodsSafe(client, domain, varId) {
+    const maybeAll = client.listAllPeriods;
+    if (typeof maybeAll === "function") {
+        return maybeAll.call(client, domain, varId);
+    }
+    return client.listPeriods(domain, varId);
+}
+export async function resolvePeriodsForSpec(client, domain, varId, spec) {
+    const parsed = parseYearSpec(spec);
+    const periods = await listAllPeriodsSafe(client, domain, varId);
+    const labels = periods
+        .map((period) => ({ id: getPeriodId(period), label: getPeriodLabel(period) }))
+        .filter((entry) => entry.id !== "");
+    const availableYears = [
+        ...new Set(labels
+            .map((entry) => entry.label.match(/\d{4}/)?.[0])
+            .filter((year) => Boolean(year))),
+    ].sort();
+    const availableLabels = [...labels]
+        .sort((a, b) => a.label.localeCompare(b.label, "id", { numeric: true }))
+        .reverse()
+        .slice(0, 12)
+        .map((entry) => entry.label);
+    if (!parsed.hasSpec) {
+        const latest = [...labels].sort((a, b) => a.label.localeCompare(b.label, "id", { numeric: true })).pop();
+        return {
+            hasSpec: false,
+            entries: latest ? [{ id: latest.id, label: latest.label, year: latest.label.match(/\d{4}/)?.[0] }] : [],
+            missingYears: [],
+            availableYears,
+            availableLabels,
+        };
+    }
+    const entries = [];
+    const seen = new Set();
+    for (const id of parsed.periodIds) {
+        const match = labels.find((entry) => entry.id === id);
+        if (match && !seen.has(match.id)) {
+            seen.add(match.id);
+            entries.push({ id: match.id, label: match.label, year: match.label.match(/\d{4}/)?.[0] });
+        }
+    }
+    const missingYears = [];
+    for (const year of parsed.years) {
+        const candidates = labels.filter((entry) => entry.label.includes(year));
+        if (candidates.length === 0) {
+            missingYears.push(year);
+            continue;
+        }
+        const best = [...candidates].sort((a, b) => periodPreference(b.label) - periodPreference(a.label) ||
+            a.label.localeCompare(b.label, "id", { numeric: true }))[0];
+        if (seen.has(best.id))
+            continue;
+        seen.add(best.id);
+        entries.push({ id: best.id, label: best.label, year });
+    }
+    return {
+        hasSpec: true,
+        entries,
+        missingYears,
+        availableYears,
+        availableLabels,
+    };
+}
+/** Human readable note about years that had no data. */
+export function describeMissingYears(missing, available) {
+    if (missing.length === 0)
+        return "";
+    const availableNote = available.length > 0
+        ? ` Tahun yang tersedia: ${available.join(", ")}.`
+        : "";
+    return `Tahun ${missing.join(", ")} tidak tersedia untuk variabel ini.${availableNote}`;
+}
+//# sourceMappingURL=period-resolver.js.map

package/dist/services/period-resolver.js.map

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

package/dist/services/region-series.d.ts

@@ -0,0 +1,65 @@
+import type { BpsClient } from "../client/bps-client.js";
+import type { BpsDynamicDataResponse } from "../client/types.js";
+import type { IPersistentStore } from "./persistent-store.js";
+import { getPeriodId, getPeriodLabel } from "../client/fields.js";
+/**
+ * Builds one comparable series (year → value) for a region.
+ *
+ * BPS provincial domains reuse national tables whose only row is "Indonesia",
+ * so "kemiskinan Jawa Timur" used to answer with the national number. Candidates
+ * are therefore accepted only when they actually contain a row for the region,
+ * and the candidate with the widest year coverage wins.
+ */
+export declare function normalizeRegionLabel(label: string): string;
+/** Pick the vervar id that represents the requested region. */
+export declare function pickRegionVervarId(response: BpsDynamicDataResponse, domain: string, domainName?: string): string | null;
+export declare function hasRegionRow(response: BpsDynamicDataResponse, domain: string, domainName?: string): boolean;
+export interface SeriesPoint {
+    id: string;
+    label: string;
+    year: string;
+    value: number;
+}
+export interface RegionSeries {
+    region: string;
+    domain: string;
+    domainName: string;
+    varId: number | null;
+    varTitle: string;
+    unit?: string;
+    seriesLabel?: string;
+    points: SeriesPoint[];
+    missingYears: string[];
+    availableYears: string[];
+    notes: string[];
+}
+export interface BuildSeriesOptions {
+    years: string[];
+    /** How many candidate variables to try before giving up. */
+    maxCandidates?: number;
+}
+export declare function buildRegionSeries(client: BpsClient, store: IPersistentStore | null, query: string, region: string, domain: string, domainName: string, options: BuildSeriesOptions): Promise<RegionSeries>;
+/** List all periods for a variable (used for diagnostics in error messages). */
+export declare function listPeriodLabels(client: BpsClient, domain: string, varId: number): Promise<Array<{
+    id: string;
+    label: string;
+}>>;
+export { getPeriodId, getPeriodLabel };
+export interface NationalBreakdown {
+    varId: number;
+    varTitle: string;
+    unit?: string;
+    seriesLabel?: string;
+    byRegion: Map<string, SeriesPoint[]>;
+}
+/**
+ * One national table (e.g. "Jumlah Penduduk Miskin Menurut Provinsi", var 185)
+ * already carries every province with a consistent unit and precision. Using it
+ * for a province comparison costs ONE request instead of one per province and
+ * avoids "Ribu Jiwa" vs "Juta Jiwa" mixes.
+ */
+export declare function buildNationalBreakdown(client: BpsClient, query: string, regions: Array<{
+    name: string;
+    domainName: string;
+}>, years: string[]): Promise<NationalBreakdown | null>;
+//# sourceMappingURL=region-series.d.ts.map