bps-mcp-server 0.16.3 → 0.17.0

package/dist/services/file-store.d.ts

@@ -2,7 +2,9 @@ import type { IPersistentStore } from "./persistent-store.js";
 /**
  * File-based persistent store for stdio transport.
  * Reads from disk on init, writes debounced.
- * Syncs with remote Worker for shared learning.
+ *
+ * Remote sync is opt-in: set BPS_WORKER_URL explicitly. The server will not
+ * send your BPS API key to a third-party host by default.
  */
 export declare class FileStore implements IPersistentStore {
     private data;
@@ -21,6 +23,8 @@ export declare class FileStore implements IPersistentStore {
     get(key: string): Promise<string | null>;
     set(key: string, value: string): Promise<void>;
     delete(key: string): Promise<void>;
+    /** Flush pending changes synchronously (called on process exit). */
+    flushNow(): void;
     getAll(): Promise<Record<string, string>>;
     merge(entries: Record<string, string>): Promise<void>;
 }

package/dist/services/file-store.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"file-store.d.ts","sourceRoot":"","sources":["../../src/services/file-store.ts"],"names":[],"mappings":"AAGA,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,uBAAuB,CAAC;AAU9D;;;;GAIG;AACH,qBAAa,SAAU,YAAW,gBAAgB;IAChD,OAAO,CAAC,IAAI,CAA8B;IAC1C,OAAO,CAAC,KAAK,CAAS;IACtB,OAAO,CAAC,UAAU,CAA8C;IAChE,OAAO,CAAC,QAAQ,CAAC,SAAS,CAAS;IACnC,OAAO,CAAC,QAAQ,CAAC,MAAM,CAAgB;gBAE3B,SAAS,CAAC,EAAE,MAAM,EAAE,MAAM,CAAC,EAAE,MAAM;IAO/C,OAAO,CAAC,IAAI;IAaZ,gEAAgE;IAChE,OAAO,CAAC,cAAc;IAyBtB,mEAAmE;IACnE,OAAO,CAAC,YAAY;IAgBpB,OAAO,CAAC,aAAa;IAQrB,OAAO,CAAC,KAAK;IAYP,GAAG,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,GAAG,IAAI,CAAC;IAIxC,GAAG,CAAC,GAAG,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC;IAO9C,MAAM,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC;IAQlC,MAAM,IAAI,OAAO,CAAC,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;IAIzC,KAAK,CAAC,OAAO,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,GAAG,OAAO,CAAC,IAAI,CAAC;CAa5D"}
+{"version":3,"file":"file-store.d.ts","sourceRoot":"","sources":["../../src/services/file-store.ts"],"names":[],"mappings":"AAGA,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,uBAAuB,CAAC;AAQ9D;;;;;;GAMG;AACH,qBAAa,SAAU,YAAW,gBAAgB;IAChD,OAAO,CAAC,IAAI,CAA8B;IAC1C,OAAO,CAAC,KAAK,CAAS;IACtB,OAAO,CAAC,UAAU,CAA8C;IAChE,OAAO,CAAC,QAAQ,CAAC,SAAS,CAAS;IACnC,OAAO,CAAC,QAAQ,CAAC,MAAM,CAAgB;gBAE3B,SAAS,CAAC,EAAE,MAAM,EAAE,MAAM,CAAC,EAAE,MAAM;IAS/C,OAAO,CAAC,IAAI;IAaZ,gEAAgE;IAChE,OAAO,CAAC,cAAc;IAyBtB,mEAAmE;IACnE,OAAO,CAAC,YAAY;IAgBpB,OAAO,CAAC,aAAa;IAQrB,OAAO,CAAC,KAAK;IAYP,GAAG,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,GAAG,IAAI,CAAC;IAIxC,GAAG,CAAC,GAAG,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC;IAO9C,MAAM,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC;IAQxC,oEAAoE;IACpE,QAAQ,IAAI,IAAI;IAQV,MAAM,IAAI,OAAO,CAAC,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;IAIzC,KAAK,CAAC,OAAO,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,GAAG,OAAO,CAAC,IAAI,CAAC;CAa5D"}

package/dist/services/file-store.js

@@ -6,11 +6,12 @@ const STORE_DIR = join(homedir(), ".bps-mcp");
 const STORE_FILE = join(STORE_DIR, "learned-vars.json");
 const FLUSH_DELAY_MS = 5_000;
 const SYNC_TIMEOUT_MS = 5_000;
-const DEFAULT_WORKER_URL = "https://bps-mcp-server.murphi.my.id";
 /**
  * File-based persistent store for stdio transport.
  * Reads from disk on init, writes debounced.
- * Syncs with remote Worker for shared learning.
+ *
+ * Remote sync is opt-in: set BPS_WORKER_URL explicitly. The server will not
+ * send your BPS API key to a third-party host by default.
  */
 export class FileStore {
     data = {};
@@ -19,10 +20,12 @@ export class FileStore {
     workerUrl;
     apiKey;
     constructor(workerUrl, apiKey) {
-        this.workerUrl = workerUrl || process.env.BPS_WORKER_URL || DEFAULT_WORKER_URL;
+        this.workerUrl = workerUrl || process.env.BPS_WORKER_URL || "";
         this.apiKey = apiKey || process.env.BPS_API_KEY || null;
         this.load();
-        this.syncFromWorker();
+        if (this.workerUrl && this.apiKey) {
+            this.syncFromWorker();
+        }
     }
     load() {
         try {
@@ -65,7 +68,7 @@ export class FileStore {
     }
     /** Push a single entry to Worker (background, fire-and-forget). */
     pushToWorker(key, value) {
-        if (!this.apiKey)
+        if (!this.workerUrl || !this.apiKey)
             return;
         const endpoint = key.startsWith("period:") ? "/api/learned-periods" : "/api/learned-vars";
         fetch(`${this.workerUrl}${endpoint}`, {
@@ -117,6 +120,14 @@ export class FileStore {
             this.scheduleFlush();
         }
     }
+    /** Flush pending changes synchronously (called on process exit). */
+    flushNow() {
+        if (this.flushTimer) {
+            clearTimeout(this.flushTimer);
+            this.flushTimer = null;
+        }
+        this.flush();
+    }
     async getAll() {
         return { ...this.data };
     }

package/dist/services/file-store.js.map

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

package/dist/services/intent-detector.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"intent-detector.d.ts","sourceRoot":"","sources":["../../src/services/intent-detector.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAEH,MAAM,MAAM,SAAS,GACjB,cAAc,GACd,YAAY,GACZ,OAAO,GACP,SAAS,GACT,OAAO,GACP,aAAa,GACb,SAAS,CAAC;AAEd,MAAM,WAAW,YAAY;IAC3B,MAAM,EAAE,SAAS,CAAC;IAClB,UAAU,EAAE,MAAM,CAAC;IACnB,aAAa,EAAE,MAAM,CAAC;IACtB,eAAe,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;IACxC,KAAK,EAAE,MAAM,EAAE,CAAC;CACjB;AA6CD;;GAEG;AACH,wBAAgB,YAAY,CAC1B,KAAK,EAAE,MAAM,EACb,MAAM,EAAE,MAAM,EACd,IAAI,CAAC,EAAE,MAAM,GACZ,YAAY,CAmGd;AAED;;GAEG;AACH,wBAAgB,mBAAmB,CACjC,KAAK,EAAE,MAAM,EACb,MAAM,EAAE,MAAM,EACd,UAAU,EAAE,MAAM,EAClB,MAAM,CAAC,EAAE,MAAM,EACf,SAAS,CAAC,EAAE,MAAM,GACjB,MAAM,EAAE,CAiCV"}
+{"version":3,"file":"intent-detector.d.ts","sourceRoot":"","sources":["../../src/services/intent-detector.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAEH,MAAM,MAAM,SAAS,GACjB,cAAc,GACd,YAAY,GACZ,OAAO,GACP,SAAS,GACT,OAAO,GACP,aAAa,GACb,SAAS,CAAC;AAEd,MAAM,WAAW,YAAY;IAC3B,MAAM,EAAE,SAAS,CAAC;IAClB,UAAU,EAAE,MAAM,CAAC;IACnB,aAAa,EAAE,MAAM,CAAC;IACtB,eAAe,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;IACxC,KAAK,EAAE,MAAM,EAAE,CAAC;CACjB;AA4CD;;GAEG;AACH,wBAAgB,YAAY,CAC1B,KAAK,EAAE,MAAM,EACb,MAAM,EAAE,MAAM,EACd,IAAI,CAAC,EAAE,MAAM,GACZ,YAAY,CAyGd;AAED;;GAEG;AACH,wBAAgB,mBAAmB,CACjC,KAAK,EAAE,MAAM,EACb,MAAM,EAAE,MAAM,EACd,UAAU,EAAE,MAAM,EAClB,MAAM,CAAC,EAAE,MAAM,EACf,SAAS,CAAC,EAAE,MAAM,GACjB,MAAM,EAAE,CAkCV"}

package/dist/services/intent-detector.js

@@ -4,12 +4,11 @@
  */
 // --- Intent patterns ---
 const COMPARISON_PATTERNS = [
-    /\b(bandingkan|banding|vs|versus|dibandingkan|dibanding|membandingkan)\b/i,
+    /\b(bandingkan|banding|perbandingan|komparasi|vs|versus|dibandingkan|dibanding|membandingkan)\b/i,
     /\b(antara)\s+(.+?)\s+(dan|dengan)\s+(.+?)(?:\s|$)/i,
     /\b(manakah?\s+(yang|lebih))\b/i,
     /\b(lebih\s+(tinggi|rendah|besar|kecil|baik|buruk))\b/i,
     /\b(perbedaan|selisih|beda)\b/i,
-    /\b(dan)\b.*\b(dan)\b/i, // "X dan Y" pattern (2+ regions)
 ];
 const TREND_PATTERNS = [
     /\b(tren|trend|perkembangan|perubahan|fluktuasi|naik\s*turun)\b/i,
@@ -52,11 +51,16 @@ export function detectIntent(query, region, year) {
             extractedParams.year = `${yearRange[1]},${yearRange[2]}`;
         }
     }
-    // Extract regions for comparison
-    const comparisonMatch = query.match(/(antara)\s+(.+?)\s+(dan|dengan)\s+(.+?)(?:\s+(pada|tahun|di)|$)/i);
+    // Extract regions for comparison: "antara X dan Y", "bandingkan X dan Y",
+    // or "X vs Y". Only add them when both sides look like names.
+    const comparisonMatch = query.match(/(?:antara|bandingkan|perbandingan|komparasi)\s+(.+?)\s+(?:dan|dengan|vs|versus)\s+(.+?)(?:\s+(?:pada|tahun|di)|[,.;]|$)/i) ||
+        query.match(/([a-z][a-z .]+?)\s+(?:vs|versus)\s+([a-z][a-z .]+?)(?:\s+(?:pada|tahun|di)|[,.;]|$)/i);
     if (comparisonMatch) {
-        extractedParams.region1 = comparisonMatch[2].trim();
-        extractedParams.region2 = comparisonMatch[4].trim();
+        const stripIndicator = (value) => value
+            .replace(/^(kemiskinan|pengangguran|ipm|penduduk|inflasi|pdrb|gini|indeks pembangunan manusia|tingkat pengangguran terbuka)\s+/i, "")
+            .trim();
+        extractedParams.region1 = stripIndicator(comparisonMatch[1]);
+        extractedParams.region2 = stripIndicator(comparisonMatch[2]);
     }
     // Score each intent
     const scores = {
@@ -88,10 +92,6 @@ export function detectIntent(query, region, year) {
         if (pattern.test(query))
             scores.publication += 30;
     }
-    // Bonus for multiple regions in query
-    const regionCount = (query.match(/(dan|,|versus|vs)/g) || []).length;
-    if (regionCount >= 2)
-        scores.comparison += 20;
     // Bonus for year range
     if (year && year.includes(","))
         scores.trend += 20;
@@ -159,6 +159,7 @@ export function generateResultHints(query, domain, domainName, _varId, _varTitle
     }
     // If query is about unemployment, suggest related indicators
     if (kw.includes("pengangguran") || kw.includes("nganggur")) {
+        hints.push(`💡 Peringkat kabupaten/kota: get_ranking(query="pengangguran", level="kabkota", order="highest")`);
         hints.push(`💡 TPak: find_variable(keyword="tpak", domain="${domain}")`);
         hints.push(`💡 Angkatan kerja: find_variable(keyword="angkatan kerja", domain="${domain}")`);
     }

package/dist/services/intent-detector.js.map

@@ -1 +1 @@
-{"version":3,"file":"intent-detector.js","sourceRoot":"","sources":["../../src/services/intent-detector.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"intent-detector.js","sourceRoot":"","sources":["../../src/services/intent-detector.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAmBH,0BAA0B;AAE1B,MAAM,mBAAmB,GAAG;IAC1B,iGAAiG;IACjG,oDAAoD;IACpD,gCAAgC;IAChC,uDAAuD;IACvD,+BAA+B;CAChC,CAAC;AAEF,MAAM,cAAc,GAAG;IACrB,iEAAiE;IACjE,yDAAyD;IACzD,8BAA8B;IAC9B,0CAA0C;IAC1C,sDAAsD;IACtD,qDAAqD;CACtD,CAAC;AAEF,MAAM,gBAAgB,GAAG;IACvB,6CAA6C;IAC7C,4FAA4F;IAC5F,sDAAsD;IACtD,6BAA6B;IAC7B,uDAAuD;CACxD,CAAC;AAEF,MAAM,cAAc,GAAG;IACrB,mCAAmC;IACnC,8DAA8D;IAC9D,0DAA0D;IAC1D,iCAAiC;IACjC,sCAAsC;CACvC,CAAC;AAEF,MAAM,oBAAoB,GAAG;IAC3B,4DAA4D;IAC5D,yDAAyD;IACzD,yBAAyB;IACzB,wDAAwD;CACzD,CAAC;AAEF;;GAEG;AACH,MAAM,UAAU,YAAY,CAC1B,KAAa,EACb,MAAc,EACd,IAAa;IAEb,MAAM,KAAK,GAAa,EAAE,CAAC;IAC3B,MAAM,eAAe,GAA2B,EAAE,CAAC;IAEnD,gDAAgD;IAChD,IAAI,CAAC,IAAI,EAAE,CAAC;QACV,MAAM,SAAS,GAAG,KAAK,CAAC,KAAK,CAAC,2BAA2B,CAAC,CAAC;QAC3D,IAAI,SAAS,EAAE,CAAC;YACd,eAAe,CAAC,IAAI,GAAG,GAAG,SAAS,CAAC,CAAC,CAAC,IAAI,SAAS,CAAC,CAAC,CAAC,EAAE,CAAC;QAC3D,CAAC;IACH,CAAC;IAED,0EAA0E;IAC1E,8DAA8D;IAC9D,MAAM,eAAe,GACnB,KAAK,CAAC,KAAK,CAAC,0HAA0H,CAAC;QACvI,KAAK,CAAC,KAAK,CAAC,sFAAsF,CAAC,CAAC;IACtG,IAAI,eAAe,EAAE,CAAC;QACpB,MAAM,cAAc,GAAG,CAAC,KAAa,EAAE,EAAE,CACvC,KAAK;aACF,OAAO,CACN,uHAAuH,EACvH,EAAE,CACH;aACA,IAAI,EAAE,CAAC;QACZ,eAAe,CAAC,OAAO,GAAG,cAAc,CAAC,eAAe,CAAC,CAAC,CAAC,CAAC,CAAC;QAC7D,eAAe,CAAC,OAAO,GAAG,cAAc,CAAC,eAAe,CAAC,CAAC,CAAC,CAAC,CAAC;IAC/D,CAAC;IAED,oBAAoB;IACpB,MAAM,MAAM,GAA8B;QACxC,YAAY,EAAE,EAAE,EAAE,UAAU;QAC5B,UAAU,EAAE,CAAC;QACb,KAAK,EAAE,CAAC;QACR,OAAO,EAAE,CAAC;QACV,KAAK,EAAE,CAAC;QACR,WAAW,EAAE,CAAC;QACd,OAAO,EAAE,CAAC;KACX,CAAC;IAEF,KAAK,MAAM,OAAO,IAAI,mBAAmB,EAAE,CAAC;QAC1C,IAAI,OAAO,CAAC,IAAI,CAAC,KAAK,CAAC;YAAE,MAAM,CAAC,UAAU,IAAI,EAAE,CAAC;IACnD,CAAC;IACD,KAAK,MAAM,OAAO,IAAI,cAAc,EAAE,CAAC;QACrC,IAAI,OAAO,CAAC,IAAI,CAAC,KAAK,CAAC;YAAE,MAAM,CAAC,KAAK,IAAI,EAAE,CAAC;IAC9C,CAAC;IACD,KAAK,MAAM,OAAO,IAAI,gBAAgB,EAAE,CAAC;QACvC,IAAI,OAAO,CAAC,IAAI,CAAC,KAAK,CAAC;YAAE,MAAM,CAAC,OAAO,IAAI,EAAE,CAAC;IAChD,CAAC;IACD,KAAK,MAAM,OAAO,IAAI,cAAc,EAAE,CAAC;QACrC,IAAI,OAAO,CAAC,IAAI,CAAC,KAAK,CAAC;YAAE,MAAM,CAAC,KAAK,IAAI,EAAE,CAAC;IAC9C,CAAC;IACD,KAAK,MAAM,OAAO,IAAI,oBAAoB,EAAE,CAAC;QAC3C,IAAI,OAAO,CAAC,IAAI,CAAC,KAAK,CAAC;YAAE,MAAM,CAAC,WAAW,IAAI,EAAE,CAAC;IACpD,CAAC;IAED,uBAAuB;IACvB,IAAI,IAAI,IAAI,IAAI,CAAC,QAAQ,CAAC,GAAG,CAAC;QAAE,MAAM,CAAC,KAAK,IAAI,EAAE,CAAC;IAEnD,wBAAwB;IACxB,IAAI,UAAU,GAAc,cAAc,CAAC;IAC3C,IAAI,SAAS,GAAG,MAAM,CAAC,YAAY,CAAC;IAEpC,KAAK,MAAM,CAAC,MAAM,EAAE,KAAK,CAAC,IAAI,MAAM,CAAC,OAAO,CAAC,MAAM,CAAC,EAAE,CAAC;QACrD,IAAI,KAAK,GAAG,SAAS,EAAE,CAAC;YACtB,SAAS,GAAG,KAAK,CAAC;YAClB,UAAU,GAAG,MAAmB,CAAC;QACnC,CAAC;IACH,CAAC;IAED,6BAA6B;IAC7B,MAAM,UAAU,GAAG,IAAI,CAAC,GAAG,CAAC,SAAS,GAAG,EAAE,EAAE,CAAC,CAAC,CAAC;IAE/C,+BAA+B;IAC/B,MAAM,OAAO,GAA8B;QACzC,YAAY,EAAE,WAAW;QACzB,UAAU,EAAE,cAAc;QAC1B,KAAK,EAAE,WAAW;QAClB,OAAO,EAAE,aAAa;QACtB,KAAK,EAAE,WAAW,EAAE,sCAAsC;QAC1D,WAAW,EAAE,QAAQ;QACrB,OAAO,EAAE,WAAW;KACrB,CAAC;IAEF,iBAAiB;IACjB,IAAI,UAAU,KAAK,OAAO,EAAE,CAAC;QAC3B,KAAK,CAAC,IAAI,CAAC,+HAA+H,CAAC,CAAC;IAC9I,CAAC;IACD,IAAI,UAAU,KAAK,YAAY,EAAE,CAAC;QAChC,KAAK,CAAC,IAAI,CAAC,sFAAsF,CAAC,CAAC;IACrG,CAAC;IACD,IAAI,UAAU,KAAK,OAAO,EAAE,CAAC;QAC3B,KAAK,CAAC,IAAI,CAAC,kFAAkF,CAAC,CAAC;IACjG,CAAC;IACD,IAAI,UAAU,KAAK,SAAS,EAAE,CAAC;QAC7B,KAAK,CAAC,IAAI,CAAC,gFAAgF,CAAC,CAAC;IAC/F,CAAC;IAED,OAAO;QACL,MAAM,EAAE,UAAU;QAClB,UAAU;QACV,aAAa,EAAE,OAAO,CAAC,UAAU,CAAC;QAClC,eAAe;QACf,KAAK;KACN,CAAC;AACJ,CAAC;AAED;;GAEG;AACH,MAAM,UAAU,mBAAmB,CACjC,KAAa,EACb,MAAc,EACd,UAAkB,EAClB,MAAe,EACf,SAAkB;IAElB,MAAM,KAAK,GAAa,EAAE,CAAC;IAC3B,MAAM,EAAE,GAAG,KAAK,CAAC,WAAW,EAAE,CAAC;IAE/B,iEAAiE;IACjE,IAAI,MAAM,CAAC,MAAM,KAAK,CAAC,IAAI,CAAC,MAAM,CAAC,QAAQ,CAAC,IAAI,CAAC,EAAE,CAAC;QAClD,MAAM,UAAU,GAAG,MAAM,CAAC,KAAK,CAAC,CAAC,EAAE,CAAC,CAAC,GAAG,IAAI,CAAC;QAC7C,KAAK,CAAC,IAAI,CAAC,sCAAsC,KAAK,kCAAkC,UAAU,GAAG,CAAC,CAAC;IACzG,CAAC;IAED,mDAAmD;IACnD,IAAI,EAAE,CAAC,QAAQ,CAAC,OAAO,CAAC,IAAI,EAAE,CAAC,QAAQ,CAAC,QAAQ,CAAC,EAAE,CAAC;QAClD,KAAK,CAAC,IAAI,CAAC,mDAAmD,MAAM,qBAAqB,CAAC,CAAC;IAC7F,CAAC;IAED,wDAAwD;IACxD,IAAI,EAAE,CAAC,QAAQ,CAAC,QAAQ,CAAC,IAAI,EAAE,CAAC,QAAQ,CAAC,YAAY,CAAC,EAAE,CAAC;QACvD,KAAK,CAAC,IAAI,CAAC,2CAA2C,MAAM,cAAc,CAAC,CAAC;QAC5E,KAAK,CAAC,IAAI,CAAC,0EAA0E,MAAM,IAAI,CAAC,CAAC;IACnG,CAAC;IAED,6DAA6D;IAC7D,IAAI,EAAE,CAAC,QAAQ,CAAC,cAAc,CAAC,IAAI,EAAE,CAAC,QAAQ,CAAC,UAAU,CAAC,EAAE,CAAC;QAC3D,KAAK,CAAC,IAAI,CAAC,kGAAkG,CAAC,CAAC;QAC/G,KAAK,CAAC,IAAI,CAAC,kDAAkD,MAAM,IAAI,CAAC,CAAC;QACzE,KAAK,CAAC,IAAI,CAAC,sEAAsE,MAAM,IAAI,CAAC,CAAC;IAC/F,CAAC;IAED,oDAAoD;IACpD,IAAI,EAAE,CAAC,QAAQ,CAAC,KAAK,CAAC,IAAI,EAAE,CAAC,QAAQ,CAAC,qBAAqB,CAAC,EAAE,CAAC;QAC7D,KAAK,CAAC,IAAI,CAAC,oDAAoD,UAAU,IAAI,CAAC,CAAC;IACjF,CAAC;IAED,OAAO,KAAK,CAAC;AACf,CAAC"}

package/dist/services/kabkota-ranking.d.ts

@@ -0,0 +1,61 @@
+import type { BpsClient } from "../client/bps-client.js";
+import type { DomainResolver } from "./domain-resolver.js";
+/**
+ * National ranking across kabupaten/kota.
+ *
+ * BPS has no national kab/kota table for most indicators: the numbers live in
+ * each provincial domain under a different var_id. This service fans out over
+ * the provinces (the client's scheduler keeps the request rate safe), extracts
+ * one value per kabupaten/kota, and merges the result into a single ranking —
+ * so the agent needs one tool call instead of ~170.
+ */
+export interface KabkotaRankOptions {
+    query: string;
+    year?: string;
+    topN: number;
+    order: "highest" | "lowest";
+    /** Optional province names/codes to restrict the sweep. */
+    provinces?: string[];
+    /** How many provinces to query in parallel (client throttles the rest). */
+    concurrency?: number;
+    /**
+     * "common" (default): use the newest year that enough provinces publish, so
+     * every row in the ranking is comparable.
+     * "latest": use each province's own newest period (mixed years).
+     */
+    periodMode?: "common" | "latest";
+}
+export interface KabkotaRankRow {
+    region: string;
+    province: string;
+    domain: string;
+    value: number;
+    period: string;
+    series?: string;
+    unit?: string;
+    indicator: string;
+}
+export interface KabkotaRankingResult {
+    rows: KabkotaRankRow[];
+    /** Regions with a usable value (before top-N slicing). */
+    totalRegions: number;
+    provincesCovered: number;
+    provincesConsidered: number;
+    periods: string[];
+    series: string[];
+    indicatorLabel: string;
+    missing: Array<{
+        province: string;
+        reason: string;
+    }>;
+    /** Year actually used for every row (undefined when periodMode="latest"). */
+    targetYear?: string;
+    /** Set when the caller asked for a specific year. */
+    yearRequested?: string;
+}
+export declare function rankKabkota(client: BpsClient, resolver: DomainResolver, options: KabkotaRankOptions): Promise<KabkotaRankingResult>;
+export declare function formatKabkotaRanking(result: KabkotaRankingResult, options: {
+    order: "highest" | "lowest";
+    query: string;
+}): string;
+//# sourceMappingURL=kabkota-ranking.d.ts.map

package/dist/services/kabkota-ranking.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"kabkota-ranking.d.ts","sourceRoot":"","sources":["../../src/services/kabkota-ranking.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,yBAAyB,CAAC;AACzD,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,sBAAsB,CAAC;AAO3D;;;;;;;;GAQG;AAEH,MAAM,WAAW,kBAAkB;IACjC,KAAK,EAAE,MAAM,CAAC;IACd,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,IAAI,EAAE,MAAM,CAAC;IACb,KAAK,EAAE,SAAS,GAAG,QAAQ,CAAC;IAC5B,2DAA2D;IAC3D,SAAS,CAAC,EAAE,MAAM,EAAE,CAAC;IACrB,2EAA2E;IAC3E,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB;;;;OAIG;IACH,UAAU,CAAC,EAAE,QAAQ,GAAG,QAAQ,CAAC;CAClC;AAED,MAAM,WAAW,cAAc;IAC7B,MAAM,EAAE,MAAM,CAAC;IACf,QAAQ,EAAE,MAAM,CAAC;IACjB,MAAM,EAAE,MAAM,CAAC;IACf,KAAK,EAAE,MAAM,CAAC;IACd,MAAM,EAAE,MAAM,CAAC;IACf,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,SAAS,EAAE,MAAM,CAAC;CACnB;AAED,MAAM,WAAW,oBAAoB;IACnC,IAAI,EAAE,cAAc,EAAE,CAAC;IACvB,0DAA0D;IAC1D,YAAY,EAAE,MAAM,CAAC;IACrB,gBAAgB,EAAE,MAAM,CAAC;IACzB,mBAAmB,EAAE,MAAM,CAAC;IAC5B,OAAO,EAAE,MAAM,EAAE,CAAC;IAClB,MAAM,EAAE,MAAM,EAAE,CAAC;IACjB,cAAc,EAAE,MAAM,CAAC;IACvB,OAAO,EAAE,KAAK,CAAC;QAAE,QAAQ,EAAE,MAAM,CAAC;QAAC,MAAM,EAAE,MAAM,CAAA;KAAE,CAAC,CAAC;IACrD,6EAA6E;IAC7E,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,qDAAqD;IACrD,aAAa,CAAC,EAAE,MAAM,CAAC;CACxB;AAoBD,wBAAsB,WAAW,CAC/B,MAAM,EAAE,SAAS,EACjB,QAAQ,EAAE,cAAc,EACxB,OAAO,EAAE,kBAAkB,GAC1B,OAAO,CAAC,oBAAoB,CAAC,CA8F/B;AAmTD,wBAAgB,oBAAoB,CAClC,MAAM,EAAE,oBAAoB,EAC5B,OAAO,EAAE;IAAE,KAAK,EAAE,SAAS,GAAG,QAAQ,CAAC;IAAC,KAAK,EAAE,MAAM,CAAA;CAAE,GACtD,MAAM,CA2DR"}

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