riasec-co 0.1.0

package/dist/index.d.ts

@@ -0,0 +1,8 @@
+export { createQuiz } from "./quiz.js";
+export type { Quiz } from "./quiz.js";
+export { uniformPrior, updateAlpha, posteriorMean, entropy, confidence, cosineSimilarity, klDivergence, expectedInfoGain, MAX_ENTROPY, } from "./scoring.js";
+export { loadItems, getItemsByType } from "./items.js";
+export { loadPrograms, loadMapping, getCINEFields, getDepartments, } from "./programs.js";
+export { recommend } from "./recommender.js";
+export { RIASEC_TYPES, type RIASECType, type RIASECProfile, type DirichletAlpha, type LikertResponse, type Item, type ItemBank, type Answer, type QuizConfig, type QuizProgress, type Program, type Cobertura, type Convenio, type FieldMapping, type TypeMapping, type RecommendConfig, type ProgramFilters, type PriorWeights, type Recommendation, } from "./types.js";
+//# sourceMappingURL=index.d.ts.map

package/dist/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,UAAU,EAAE,MAAM,WAAW,CAAC;AACvC,YAAY,EAAE,IAAI,EAAE,MAAM,WAAW,CAAC;AAEtC,OAAO,EACL,YAAY,EACZ,WAAW,EACX,aAAa,EACb,OAAO,EACP,UAAU,EACV,gBAAgB,EAChB,YAAY,EACZ,gBAAgB,EAChB,WAAW,GACZ,MAAM,cAAc,CAAC;AAEtB,OAAO,EAAE,SAAS,EAAE,cAAc,EAAE,MAAM,YAAY,CAAC;AACvD,OAAO,EACL,YAAY,EACZ,WAAW,EACX,aAAa,EACb,cAAc,GACf,MAAM,eAAe,CAAC;AAEvB,OAAO,EAAE,SAAS,EAAE,MAAM,kBAAkB,CAAC;AAE7C,OAAO,EACL,YAAY,EACZ,KAAK,UAAU,EACf,KAAK,aAAa,EAClB,KAAK,cAAc,EACnB,KAAK,cAAc,EACnB,KAAK,IAAI,EACT,KAAK,QAAQ,EACb,KAAK,MAAM,EACX,KAAK,UAAU,EACf,KAAK,YAAY,EACjB,KAAK,OAAO,EACZ,KAAK,SAAS,EACd,KAAK,QAAQ,EACb,KAAK,YAAY,EACjB,KAAK,WAAW,EAChB,KAAK,eAAe,EACpB,KAAK,cAAc,EACnB,KAAK,YAAY,EACjB,KAAK,cAAc,GACpB,MAAM,YAAY,CAAC"}

package/dist/index.js

@@ -0,0 +1,7 @@
+export { createQuiz } from "./quiz.js";
+export { uniformPrior, updateAlpha, posteriorMean, entropy, confidence, cosineSimilarity, klDivergence, expectedInfoGain, MAX_ENTROPY, } from "./scoring.js";
+export { loadItems, getItemsByType } from "./items.js";
+export { loadPrograms, loadMapping, getCINEFields, getDepartments, } from "./programs.js";
+export { recommend } from "./recommender.js";
+export { RIASEC_TYPES, } from "./types.js";
+//# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,UAAU,EAAE,MAAM,WAAW,CAAC;AAGvC,OAAO,EACL,YAAY,EACZ,WAAW,EACX,aAAa,EACb,OAAO,EACP,UAAU,EACV,gBAAgB,EAChB,YAAY,EACZ,gBAAgB,EAChB,WAAW,GACZ,MAAM,cAAc,CAAC;AAEtB,OAAO,EAAE,SAAS,EAAE,cAAc,EAAE,MAAM,YAAY,CAAC;AACvD,OAAO,EACL,YAAY,EACZ,WAAW,EACX,aAAa,EACb,cAAc,GACf,MAAM,eAAe,CAAC;AAEvB,OAAO,EAAE,SAAS,EAAE,MAAM,kBAAkB,CAAC;AAE7C,OAAO,EACL,YAAY,GAmBb,MAAM,YAAY,CAAC"}

package/dist/items.d.ts

@@ -0,0 +1,11 @@
+/**
+ * items.ts — IPIP RIASEC item bank loader
+ *
+ * Loads the 48-item IPIP Basic Interest Markers from bundled JSON.
+ */
+import type { Item, ItemBank } from "./types.js";
+/** Load the IPIP RIASEC item bank */
+export declare function loadItems(language?: "en" | "es"): ItemBank;
+/** Get all items for a specific RIASEC type */
+export declare function getItemsByType(items: Item[], type: string): Item[];
+//# sourceMappingURL=items.d.ts.map

package/dist/items.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"items.d.ts","sourceRoot":"","sources":["../src/items.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAKH,OAAO,KAAK,EAAE,IAAI,EAAE,QAAQ,EAAE,MAAM,YAAY,CAAC;AAsBjD,qCAAqC;AACrC,wBAAgB,SAAS,CAAC,QAAQ,GAAE,IAAI,GAAG,IAAW,GAAG,QAAQ,CAahE;AAED,+CAA+C;AAC/C,wBAAgB,cAAc,CAAC,KAAK,EAAE,IAAI,EAAE,EAAE,IAAI,EAAE,MAAM,GAAG,IAAI,EAAE,CAElE"}

package/dist/items.js

@@ -0,0 +1,45 @@
+/**
+ * items.ts — IPIP RIASEC item bank loader
+ *
+ * Loads the 48-item IPIP Basic Interest Markers from bundled JSON.
+ */
+import { readFileSync } from "node:fs";
+import { resolve, dirname } from "node:path";
+import { fileURLToPath } from "node:url";
+const __dirname = dirname(fileURLToPath(import.meta.url));
+/** Path to the canonical data directory */
+const DATA_DIR = resolve(__dirname, "../../data/canonical");
+// Fallback: when running from packages/core/src, data is at repo root
+const DATA_DIR_ALT = resolve(__dirname, "../../../data/canonical");
+function findDataDir() {
+    try {
+        readFileSync(resolve(DATA_DIR, "items_en.json"));
+        return DATA_DIR;
+    }
+    catch {
+        return DATA_DIR_ALT;
+    }
+}
+let cachedEn = null;
+let cachedEs = null;
+/** Load the IPIP RIASEC item bank */
+export function loadItems(language = "en") {
+    if (language === "en" && cachedEn)
+        return cachedEn;
+    if (language === "es" && cachedEs)
+        return cachedEs;
+    const dataDir = findDataDir();
+    const path = resolve(dataDir, `items_${language}.json`);
+    const raw = readFileSync(path, "utf-8");
+    const bank = JSON.parse(raw);
+    if (language === "en")
+        cachedEn = bank;
+    else
+        cachedEs = bank;
+    return bank;
+}
+/** Get all items for a specific RIASEC type */
+export function getItemsByType(items, type) {
+    return items.filter((i) => i.type === type);
+}
+//# sourceMappingURL=items.js.map

package/dist/items.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"items.js","sourceRoot":"","sources":["../src/items.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH,OAAO,EAAE,YAAY,EAAE,MAAM,SAAS,CAAC;AACvC,OAAO,EAAE,OAAO,EAAE,OAAO,EAAE,MAAM,WAAW,CAAC;AAC7C,OAAO,EAAE,aAAa,EAAE,MAAM,UAAU,CAAC;AAGzC,MAAM,SAAS,GAAG,OAAO,CAAC,aAAa,CAAC,MAAM,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC,CAAC;AAE1D,2CAA2C;AAC3C,MAAM,QAAQ,GAAG,OAAO,CAAC,SAAS,EAAE,sBAAsB,CAAC,CAAC;AAE5D,sEAAsE;AACtE,MAAM,YAAY,GAAG,OAAO,CAAC,SAAS,EAAE,yBAAyB,CAAC,CAAC;AAEnE,SAAS,WAAW;IAClB,IAAI,CAAC;QACH,YAAY,CAAC,OAAO,CAAC,QAAQ,EAAE,eAAe,CAAC,CAAC,CAAC;QACjD,OAAO,QAAQ,CAAC;IAClB,CAAC;IAAC,MAAM,CAAC;QACP,OAAO,YAAY,CAAC;IACtB,CAAC;AACH,CAAC;AAED,IAAI,QAAQ,GAAoB,IAAI,CAAC;AACrC,IAAI,QAAQ,GAAoB,IAAI,CAAC;AAErC,qCAAqC;AACrC,MAAM,UAAU,SAAS,CAAC,WAAwB,IAAI;IACpD,IAAI,QAAQ,KAAK,IAAI,IAAI,QAAQ;QAAE,OAAO,QAAQ,CAAC;IACnD,IAAI,QAAQ,KAAK,IAAI,IAAI,QAAQ;QAAE,OAAO,QAAQ,CAAC;IAEnD,MAAM,OAAO,GAAG,WAAW,EAAE,CAAC;IAC9B,MAAM,IAAI,GAAG,OAAO,CAAC,OAAO,EAAE,SAAS,QAAQ,OAAO,CAAC,CAAC;IACxD,MAAM,GAAG,GAAG,YAAY,CAAC,IAAI,EAAE,OAAO,CAAC,CAAC;IACxC,MAAM,IAAI,GAAG,IAAI,CAAC,KAAK,CAAC,GAAG,CAAa,CAAC;IAEzC,IAAI,QAAQ,KAAK,IAAI;QAAE,QAAQ,GAAG,IAAI,CAAC;;QAClC,QAAQ,GAAG,IAAI,CAAC;IAErB,OAAO,IAAI,CAAC;AACd,CAAC;AAED,+CAA+C;AAC/C,MAAM,UAAU,cAAc,CAAC,KAAa,EAAE,IAAY;IACxD,OAAO,KAAK,CAAC,MAAM,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,IAAI,KAAK,IAAI,CAAC,CAAC;AAC9C,CAAC"}

package/dist/programs.d.ts

@@ -0,0 +1,15 @@
+/**
+ * programs.ts — SNIES program data loader
+ *
+ * Loads the canonical programs.csv into typed Program objects.
+ */
+import type { Program, TypeMapping, RIASECType } from "./types.js";
+/** Load all programs from canonical CSV */
+export declare function loadPrograms(): Program[];
+/** Load the RIASEC → CINE field mapping */
+export declare function loadMapping(): Record<RIASECType, TypeMapping>;
+/** Get unique CINE broad fields from programs */
+export declare function getCINEFields(programs: Program[]): string[];
+/** Get unique departments from programs */
+export declare function getDepartments(programs: Program[]): string[];
+//# sourceMappingURL=programs.d.ts.map

package/dist/programs.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"programs.d.ts","sourceRoot":"","sources":["../src/programs.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAKH,OAAO,KAAK,EAAE,OAAO,EAAE,WAAW,EAAE,UAAU,EAAE,MAAM,YAAY,CAAC;AAmDnE,2CAA2C;AAC3C,wBAAgB,YAAY,IAAI,OAAO,EAAE,CAoDxC;AAED,2CAA2C;AAC3C,wBAAgB,WAAW,IAAI,MAAM,CAAC,UAAU,EAAE,WAAW,CAAC,CAQ7D;AAED,iDAAiD;AACjD,wBAAgB,aAAa,CAAC,QAAQ,EAAE,OAAO,EAAE,GAAG,MAAM,EAAE,CAE3D;AAED,2CAA2C;AAC3C,wBAAgB,cAAc,CAAC,QAAQ,EAAE,OAAO,EAAE,GAAG,MAAM,EAAE,CAE5D"}

package/dist/programs.js

@@ -0,0 +1,127 @@
+/**
+ * programs.ts — SNIES program data loader
+ *
+ * Loads the canonical programs.csv into typed Program objects.
+ */
+import { readFileSync } from "node:fs";
+import { resolve, dirname } from "node:path";
+import { fileURLToPath } from "node:url";
+const __dirname = dirname(fileURLToPath(import.meta.url));
+const DATA_DIR = resolve(__dirname, "../../data/canonical");
+const DATA_DIR_ALT = resolve(__dirname, "../../../data/canonical");
+function findDataDir() {
+    try {
+        readFileSync(resolve(DATA_DIR, "programs.csv"), { encoding: "utf-8", flag: "r" });
+        return DATA_DIR;
+    }
+    catch {
+        return DATA_DIR_ALT;
+    }
+}
+let cachedPrograms = null;
+let cachedMapping = null;
+/** Parse a CSV line handling quoted fields */
+function parseCSVLine(line) {
+    const result = [];
+    let current = "";
+    let inQuotes = false;
+    for (let i = 0; i < line.length; i++) {
+        const ch = line[i];
+        if (inQuotes) {
+            if (ch === '"') {
+                if (i + 1 < line.length && line[i + 1] === '"') {
+                    current += '"';
+                    i++;
+                }
+                else {
+                    inQuotes = false;
+                }
+            }
+            else {
+                current += ch;
+            }
+        }
+        else if (ch === '"') {
+            inQuotes = true;
+        }
+        else if (ch === ",") {
+            result.push(current);
+            current = "";
+        }
+        else {
+            current += ch;
+        }
+    }
+    result.push(current);
+    return result;
+}
+/** Load all programs from canonical CSV */
+export function loadPrograms() {
+    if (cachedPrograms)
+        return cachedPrograms;
+    const dataDir = findDataDir();
+    const csv = readFileSync(resolve(dataDir, "programs.csv"), "utf-8");
+    const lines = csv.trim().split("\n");
+    const headers = parseCSVLine(lines[0]);
+    const programs = [];
+    for (let i = 1; i < lines.length; i++) {
+        const values = parseCSVLine(lines[i]);
+        const row = {};
+        for (let j = 0; j < headers.length; j++) {
+            row[headers[j]] = values[j] ?? "";
+        }
+        programs.push({
+            codigo_institucion_padre: row.codigo_institucion_padre,
+            codigo_snies: parseInt(row.codigo_snies, 10),
+            nombre_programa: row.nombre_programa,
+            codigo_institucion: row.codigo_institucion,
+            nombre_institucion: row.nombre_institucion,
+            estado: row.estado,
+            estado_institucion: row.estado_institucion,
+            caracter_academico: row.caracter_academico,
+            sector: row.sector,
+            nivel_academico: row.nivel_academico,
+            nivel_formacion: row.nivel_formacion,
+            modalidad: row.modalidad,
+            titulo_otorgado: row.titulo_otorgado,
+            reconocimiento: row.reconocimiento || null,
+            cine_amplio: row.cine_amplio,
+            cine_especifico: row.cine_especifico,
+            cine_detallado: row.cine_detallado,
+            area_conocimiento: row.area_conocimiento,
+            nucleo_conocimiento: row.nucleo_conocimiento,
+            departamento: row.departamento,
+            municipio: row.municipio,
+            creditos: row.creditos ? parseInt(row.creditos, 10) : null,
+            periodos_duracion: row.periodos_duracion ? parseInt(row.periodos_duracion, 10) : null,
+            periodicidad: row.periodicidad || null,
+            periodicidad_admisiones: row.periodicidad_admisiones || null,
+            costo_matricula: row.costo_matricula ? parseFloat(row.costo_matricula) : null,
+            en_convenio: row.en_convenio || null,
+            vigencia_anos: row.vigencia_anos || null,
+            ciclos_propedeuticos: row.ciclos_propedeuticos || null,
+            fecha_registro_snies: row.fecha_registro_snies || null,
+        });
+    }
+    cachedPrograms = programs;
+    return programs;
+}
+/** Load the RIASEC → CINE field mapping */
+export function loadMapping() {
+    if (cachedMapping)
+        return cachedMapping;
+    const dataDir = findDataDir();
+    const raw = readFileSync(resolve(dataDir, "mapping.json"), "utf-8");
+    const data = JSON.parse(raw);
+    cachedMapping = data.mapping;
+    return cachedMapping;
+}
+/** Get unique CINE broad fields from programs */
+export function getCINEFields(programs) {
+    return [...new Set(programs.map((p) => p.cine_amplio))].filter(Boolean).sort();
+}
+/** Get unique departments from programs */
+export function getDepartments(programs) {
+    return [...new Set(programs.map((p) => p.departamento))].filter(Boolean).sort();
+}
+//# sourceMappingURL=programs.js.map

package/dist/programs.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"programs.js","sourceRoot":"","sources":["../src/programs.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH,OAAO,EAAE,YAAY,EAAE,MAAM,SAAS,CAAC;AACvC,OAAO,EAAE,OAAO,EAAE,OAAO,EAAE,MAAM,WAAW,CAAC;AAC7C,OAAO,EAAE,aAAa,EAAE,MAAM,UAAU,CAAC;AAGzC,MAAM,SAAS,GAAG,OAAO,CAAC,aAAa,CAAC,MAAM,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC,CAAC;AAE1D,MAAM,QAAQ,GAAG,OAAO,CAAC,SAAS,EAAE,sBAAsB,CAAC,CAAC;AAC5D,MAAM,YAAY,GAAG,OAAO,CAAC,SAAS,EAAE,yBAAyB,CAAC,CAAC;AAEnE,SAAS,WAAW;IAClB,IAAI,CAAC;QACH,YAAY,CAAC,OAAO,CAAC,QAAQ,EAAE,cAAc,CAAC,EAAE,EAAE,QAAQ,EAAE,OAAO,EAAE,IAAI,EAAE,GAAG,EAAE,CAAC,CAAC;QAClF,OAAO,QAAQ,CAAC;IAClB,CAAC;IAAC,MAAM,CAAC;QACP,OAAO,YAAY,CAAC;IACtB,CAAC;AACH,CAAC;AAED,IAAI,cAAc,GAAqB,IAAI,CAAC;AAC5C,IAAI,aAAa,GAA2C,IAAI,CAAC;AAEjE,8CAA8C;AAC9C,SAAS,YAAY,CAAC,IAAY;IAChC,MAAM,MAAM,GAAa,EAAE,CAAC;IAC5B,IAAI,OAAO,GAAG,EAAE,CAAC;IACjB,IAAI,QAAQ,GAAG,KAAK,CAAC;IAErB,KAAK,IAAI,CAAC,GAAG,CAAC,EAAE,CAAC,GAAG,IAAI,CAAC,MAAM,EAAE,CAAC,EAAE,EAAE,CAAC;QACrC,MAAM,EAAE,GAAG,IAAI,CAAC,CAAC,CAAC,CAAC;QACnB,IAAI,QAAQ,EAAE,CAAC;YACb,IAAI,EAAE,KAAK,GAAG,EAAE,CAAC;gBACf,IAAI,CAAC,GAAG,CAAC,GAAG,IAAI,CAAC,MAAM,IAAI,IAAI,CAAC,CAAC,GAAG,CAAC,CAAC,KAAK,GAAG,EAAE,CAAC;oBAC/C,OAAO,IAAI,GAAG,CAAC;oBACf,CAAC,EAAE,CAAC;gBACN,CAAC;qBAAM,CAAC;oBACN,QAAQ,GAAG,KAAK,CAAC;gBACnB,CAAC;YACH,CAAC;iBAAM,CAAC;gBACN,OAAO,IAAI,EAAE,CAAC;YAChB,CAAC;QACH,CAAC;aAAM,IAAI,EAAE,KAAK,GAAG,EAAE,CAAC;YACtB,QAAQ,GAAG,IAAI,CAAC;QAClB,CAAC;aAAM,IAAI,EAAE,KAAK,GAAG,EAAE,CAAC;YACtB,MAAM,CAAC,IAAI,CAAC,OAAO,CAAC,CAAC;YACrB,OAAO,GAAG,EAAE,CAAC;QACf,CAAC;aAAM,CAAC;YACN,OAAO,IAAI,EAAE,CAAC;QAChB,CAAC;IACH,CAAC;IACD,MAAM,CAAC,IAAI,CAAC,OAAO,CAAC,CAAC;IACrB,OAAO,MAAM,CAAC;AAChB,CAAC;AAED,2CAA2C;AAC3C,MAAM,UAAU,YAAY;IAC1B,IAAI,cAAc;QAAE,OAAO,cAAc,CAAC;IAE1C,MAAM,OAAO,GAAG,WAAW,EAAE,CAAC;IAC9B,MAAM,GAAG,GAAG,YAAY,CAAC,OAAO,CAAC,OAAO,EAAE,cAAc,CAAC,EAAE,OAAO,CAAC,CAAC;IACpE,MAAM,KAAK,GAAG,GAAG,CAAC,IAAI,EAAE,CAAC,KAAK,CAAC,IAAI,CAAC,CAAC;IACrC,MAAM,OAAO,GAAG,YAAY,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC,CAAC;IAEvC,MAAM,QAAQ,GAAc,EAAE,CAAC;IAC/B,KAAK,IAAI,CAAC,GAAG,CAAC,EAAE,CAAC,GAAG,KAAK,CAAC,MAAM,EAAE,CAAC,EAAE,EAAE,CAAC;QACtC,MAAM,MAAM,GAAG,YAAY,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC,CAAC;QACtC,MAAM,GAAG,GAA2B,EAAE,CAAC;QACvC,KAAK,IAAI,CAAC,GAAG,CAAC,EAAE,CAAC,GAAG,OAAO,CAAC,MAAM,EAAE,CAAC,EAAE,EAAE,CAAC;YACxC,GAAG,CAAC,OAAO,CAAC,CAAC,CAAC,CAAC,GAAG,MAAM,CAAC,CAAC,CAAC,IAAI,EAAE,CAAC;QACpC,CAAC;QAED,QAAQ,CAAC,IAAI,CAAC;YACZ,wBAAwB,EAAE,GAAG,CAAC,wBAAwB;YACtD,YAAY,EAAE,QAAQ,CAAC,GAAG,CAAC,YAAY,EAAE,EAAE,CAAC;YAC5C,eAAe,EAAE,GAAG,CAAC,eAAe;YACpC,kBAAkB,EAAE,GAAG,CAAC,kBAAkB;YAC1C,kBAAkB,EAAE,GAAG,CAAC,kBAAkB;YAC1C,MAAM,EAAE,GAAG,CAAC,MAA+B;YAC3C,kBAAkB,EAAE,GAAG,CAAC,kBAAkB;YAC1C,kBAAkB,EAAE,GAAG,CAAC,kBAAkB;YAC1C,MAAM,EAAE,GAAG,CAAC,MAAM;YAClB,eAAe,EAAE,GAAG,CAAC,eAAe;YACpC,eAAe,EAAE,GAAG,CAAC,eAAe;YACpC,SAAS,EAAE,GAAG,CAAC,SAAS;YACxB,eAAe,EAAE,GAAG,CAAC,eAAe;YACpC,cAAc,EAAE,GAAG,CAAC,cAAc,IAAI,IAAI;YAC1C,WAAW,EAAE,GAAG,CAAC,WAAW;YAC5B,eAAe,EAAE,GAAG,CAAC,eAAe;YACpC,cAAc,EAAE,GAAG,CAAC,cAAc;YAClC,iBAAiB,EAAE,GAAG,CAAC,iBAAiB;YACxC,mBAAmB,EAAE,GAAG,CAAC,mBAAmB;YAC5C,YAAY,EAAE,GAAG,CAAC,YAAY;YAC9B,SAAS,EAAE,GAAG,CAAC,SAAS;YACxB,QAAQ,EAAE,GAAG,CAAC,QAAQ,CAAC,CAAC,CAAC,QAAQ,CAAC,GAAG,CAAC,QAAQ,EAAE,EAAE,CAAC,CAAC,CAAC,CAAC,IAAI;YAC1D,iBAAiB,EAAE,GAAG,CAAC,iBAAiB,CAAC,CAAC,CAAC,QAAQ,CAAC,GAAG,CAAC,iBAAiB,EAAE,EAAE,CAAC,CAAC,CAAC,CAAC,IAAI;YACrF,YAAY,EAAE,GAAG,CAAC,YAAY,IAAI,IAAI;YACtC,uBAAuB,EAAE,GAAG,CAAC,uBAAuB,IAAI,IAAI;YAC5D,eAAe,EAAE,GAAG,CAAC,eAAe,CAAC,CAAC,CAAC,UAAU,CAAC,GAAG,CAAC,eAAe,CAAC,CAAC,CAAC,CAAC,IAAI;YAC7E,WAAW,EAAE,GAAG,CAAC,WAAW,IAAI,IAAI;YACpC,aAAa,EAAE,GAAG,CAAC,aAAa,IAAI,IAAI;YACxC,oBAAoB,EAAE,GAAG,CAAC,oBAAoB,IAAI,IAAI;YACtD,oBAAoB,EAAE,GAAG,CAAC,oBAAoB,IAAI,IAAI;SACvD,CAAC,CAAC;IACL,CAAC;IAED,cAAc,GAAG,QAAQ,CAAC;IAC1B,OAAO,QAAQ,CAAC;AAClB,CAAC;AAED,2CAA2C;AAC3C,MAAM,UAAU,WAAW;IACzB,IAAI,aAAa;QAAE,OAAO,aAAa,CAAC;IAExC,MAAM,OAAO,GAAG,WAAW,EAAE,CAAC;IAC9B,MAAM,GAAG,GAAG,YAAY,CAAC,OAAO,CAAC,OAAO,EAAE,cAAc,CAAC,EAAE,OAAO,CAAC,CAAC;IACpE,MAAM,IAAI,GAAG,IAAI,CAAC,KAAK,CAAC,GAAG,CAAC,CAAC;IAC7B,aAAa,GAAG,IAAI,CAAC,OAA0C,CAAC;IAChE,OAAO,aAAa,CAAC;AACvB,CAAC;AAED,iDAAiD;AACjD,MAAM,UAAU,aAAa,CAAC,QAAmB;IAC/C,OAAO,CAAC,GAAG,IAAI,GAAG,CAAC,QAAQ,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,WAAW,CAAC,CAAC,CAAC,CAAC,MAAM,CAAC,OAAO,CAAC,CAAC,IAAI,EAAE,CAAC;AACjF,CAAC;AAED,2CAA2C;AAC3C,MAAM,UAAU,cAAc,CAAC,QAAmB;IAChD,OAAO,CAAC,GAAG,IAAI,GAAG,CAAC,QAAQ,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,YAAY,CAAC,CAAC,CAAC,CAAC,MAAM,CAAC,OAAO,CAAC,CAAC,IAAI,EAAE,CAAC;AAClF,CAAC"}

package/dist/quiz.d.ts

@@ -0,0 +1,29 @@
+/**
+ * quiz.ts — Bayesian adaptive RIASEC quiz engine
+ *
+ * Implements an adaptive testing engine that selects the most informative
+ * question at each step using expected information gain (KL divergence).
+ * Stops when posterior entropy drops below a configurable threshold.
+ */
+import type { Item, Answer, QuizConfig, QuizProgress, RIASECProfile, DirichletAlpha, LikertResponse, RIASECType } from "./types.js";
+export interface Quiz {
+    /** Get the next question to ask. Returns null if quiz is complete. */
+    nextQuestion(): Item | null;
+    /** Record an answer */
+    answer(itemId: string, response: LikertResponse): void;
+    /** Check if the quiz should stop */
+    isComplete(): boolean;
+    /** Get current progress */
+    progress(): QuizProgress;
+    /** Get current RIASEC profile (posterior mean) */
+    profile(): RIASECProfile;
+    /** Get current Dirichlet alpha parameters */
+    alpha(): DirichletAlpha;
+    /** Get all recorded answers */
+    answers(): Answer[];
+    /** Get the top N RIASEC types */
+    topTypes(n?: number): RIASECType[];
+}
+/** Create a new quiz instance */
+export declare function createQuiz(config?: Partial<QuizConfig>): Quiz;
+//# sourceMappingURL=quiz.d.ts.map

package/dist/quiz.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"quiz.d.ts","sourceRoot":"","sources":["../src/quiz.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAWH,OAAO,KAAK,EACV,IAAI,EACJ,MAAM,EACN,UAAU,EACV,YAAY,EACZ,aAAa,EACb,cAAc,EACd,cAAc,EACd,UAAU,EACX,MAAM,YAAY,CAAC;AAUpB,MAAM,WAAW,IAAI;IACnB,sEAAsE;IACtE,YAAY,IAAI,IAAI,GAAG,IAAI,CAAC;IAC5B,uBAAuB;IACvB,MAAM,CAAC,MAAM,EAAE,MAAM,EAAE,QAAQ,EAAE,cAAc,GAAG,IAAI,CAAC;IACvD,oCAAoC;IACpC,UAAU,IAAI,OAAO,CAAC;IACtB,2BAA2B;IAC3B,QAAQ,IAAI,YAAY,CAAC;IACzB,kDAAkD;IAClD,OAAO,IAAI,aAAa,CAAC;IACzB,6CAA6C;IAC7C,KAAK,IAAI,cAAc,CAAC;IACxB,+BAA+B;IAC/B,OAAO,IAAI,MAAM,EAAE,CAAC;IACpB,iCAAiC;IACjC,QAAQ,CAAC,CAAC,CAAC,EAAE,MAAM,GAAG,UAAU,EAAE,CAAC;CACpC;AAED,iCAAiC;AACjC,wBAAgB,UAAU,CAAC,MAAM,CAAC,EAAE,OAAO,CAAC,UAAU,CAAC,GAAG,IAAI,CA6H7D"}

package/dist/quiz.js

@@ -0,0 +1,130 @@
+/**
+ * quiz.ts — Bayesian adaptive RIASEC quiz engine
+ *
+ * Implements an adaptive testing engine that selects the most informative
+ * question at each step using expected information gain (KL divergence).
+ * Stops when posterior entropy drops below a configurable threshold.
+ */
+import { uniformPrior, updateAlpha, posteriorMean, entropy, confidence, expectedInfoGain, } from "./scoring.js";
+import { loadItems } from "./items.js";
+const DEFAULT_CONFIG = {
+    language: "es",
+    mode: "adaptive",
+    entropyThreshold: 1.5,
+    maxQuestions: 24,
+    minQuestions: 12,
+};
+/** Create a new quiz instance */
+export function createQuiz(config) {
+    const cfg = { ...DEFAULT_CONFIG, ...config };
+    const bank = loadItems(cfg.language);
+    const allItems = [...bank.items];
+    let alpha = uniformPrior();
+    const answeredItems = new Set();
+    const recordedAnswers = [];
+    function nextQuestion() {
+        if (isComplete())
+            return null;
+        const remaining = allItems.filter((i) => !answeredItems.has(i.id));
+        if (remaining.length === 0)
+            return null;
+        if (cfg.mode === "full") {
+            // In full mode, return items in order
+            return remaining[0];
+        }
+        // Adaptive mode: pick the item with highest expected information gain
+        let bestItem = remaining[0];
+        let bestGain = -Infinity;
+        for (const item of remaining) {
+            const gain = expectedInfoGain(alpha, item.type);
+            if (gain > bestGain) {
+                bestGain = gain;
+                bestItem = item;
+            }
+        }
+        return bestItem;
+    }
+    function answer(itemId, response) {
+        const item = allItems.find((i) => i.id === itemId);
+        if (!item)
+            throw new Error(`Unknown item: ${itemId}`);
+        if (answeredItems.has(itemId))
+            throw new Error(`Item already answered: ${itemId}`);
+        if (response < 1 || response > 5)
+            throw new Error(`Invalid response: ${response}`);
+        answeredItems.add(itemId);
+        alpha = updateAlpha(alpha, item.type, response, item.keyed);
+        recordedAnswers.push({
+            itemId,
+            type: item.type,
+            response,
+            keyed: item.keyed,
+        });
+    }
+    function isComplete() {
+        const answered = answeredItems.size;
+        if (cfg.mode === "full") {
+            return answered >= allItems.length;
+        }
+        // Adaptive: stop when we have enough data and entropy is low enough
+        if (answered >= cfg.maxQuestions)
+            return true;
+        if (answered < cfg.minQuestions)
+            return false;
+        return entropy(alpha) < cfg.entropyThreshold;
+    }
+    function progress() {
+        const answered = answeredItems.size;
+        const total = cfg.mode === "full" ? allItems.length : cfg.maxQuestions;
+        const currentEntropy = entropy(alpha);
+        const conf = confidence(alpha);
+        let estimatedRemaining;
+        if (cfg.mode === "full") {
+            estimatedRemaining = allItems.length - answered;
+        }
+        else if (answered < cfg.minQuestions) {
+            estimatedRemaining = cfg.minQuestions - answered;
+        }
+        else if (currentEntropy < cfg.entropyThreshold) {
+            estimatedRemaining = 0;
+        }
+        else {
+            // Rough estimate based on entropy decay rate
+            estimatedRemaining = Math.min(cfg.maxQuestions - answered, Math.ceil((currentEntropy - cfg.entropyThreshold) * 8));
+        }
+        return {
+            answered,
+            total,
+            estimatedRemaining,
+            confidence: conf,
+            entropy: currentEntropy,
+        };
+    }
+    function getProfile() {
+        return posteriorMean(alpha);
+    }
+    function getAlpha() {
+        return { ...alpha };
+    }
+    function getAnswers() {
+        return [...recordedAnswers];
+    }
+    function topTypes(n = 3) {
+        const profile = getProfile();
+        return Object.entries(profile)
+            .sort((a, b) => b[1] - a[1])
+            .slice(0, n)
+            .map(([type]) => type);
+    }
+    return {
+        nextQuestion,
+        answer,
+        isComplete,
+        progress,
+        profile: getProfile,
+        alpha: getAlpha,
+        answers: getAnswers,
+        topTypes,
+    };
+}
+//# sourceMappingURL=quiz.js.map

package/dist/quiz.js.map

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

package/dist/recommender.d.ts

@@ -0,0 +1,21 @@
+/**
+ * recommender.ts — Program recommendation engine
+ *
+ * Matches a student's RIASEC profile to SNIES programs using
+ * the RIASEC → CINE field mapping. Supports enrollment-weighted
+ * priors that surface hidden-gem programs.
+ */
+import type { RecommendConfig, Recommendation } from "./types.js";
+/**
+ * Recommend programs based on RIASEC profile.
+ *
+ * score(program) = similarity(student_profile, program_cine_vector)
+ *               × prior(program)
+ *
+ * prior(program) = base
+ *               × (1 + enrollmentWeight × log(national / field_count))
+ *               × (1 + regionalBoost × isInRegion)
+ *               × (1 + virtualBoost × isVirtual)
+ */
+export declare function recommend(config: RecommendConfig): Recommendation[];
+//# sourceMappingURL=recommender.d.ts.map

package/dist/recommender.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"recommender.d.ts","sourceRoot":"","sources":["../src/recommender.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAKH,OAAO,KAAK,EAKV,eAAe,EAEf,cAAc,EACf,MAAM,YAAY,CAAC;AAgFpB;;;;;;;;;;GAUG;AACH,wBAAgB,SAAS,CAAC,MAAM,EAAE,eAAe,GAAG,cAAc,EAAE,CAsFnE"}

package/dist/recommender.js

@@ -0,0 +1,150 @@
+/**
+ * recommender.ts — Program recommendation engine
+ *
+ * Matches a student's RIASEC profile to SNIES programs using
+ * the RIASEC → CINE field mapping. Supports enrollment-weighted
+ * priors that surface hidden-gem programs.
+ */
+import { cosineSimilarity } from "./scoring.js";
+import { loadMapping } from "./programs.js";
+import { RIASEC_TYPES } from "./types.js";
+const VIRTUAL_MODALITIES = new Set([
+    "Virtual",
+    "A distancia",
+    "Virtual-A distancia",
+]);
+/**
+ * Build a RIASEC profile vector for a given CINE broad field,
+ * based on the mapping weights.
+ */
+function fieldToProfile(cineAmplio, mapping) {
+    const profile = { R: 0, I: 0, A: 0, S: 0, E: 0, C: 0 };
+    for (const type of RIASEC_TYPES) {
+        const entry = mapping[type];
+        for (const field of entry.fields) {
+            if (field.cine_amplio === cineAmplio) {
+                profile[type] = field.weight;
+            }
+        }
+    }
+    return profile;
+}
+/** Apply filters to a program list */
+function applyFilters(programs, filters) {
+    if (!filters)
+        return programs;
+    let result = programs;
+    if (filters.active !== undefined) {
+        const status = filters.active ? "Activo" : "Inactivo";
+        result = result.filter((p) => p.estado === status);
+    }
+    if (filters.departments?.length) {
+        const depts = new Set(filters.departments);
+        result = result.filter((p) => depts.has(p.departamento));
+    }
+    if (filters.nivel_formacion?.length) {
+        const niveles = new Set(filters.nivel_formacion);
+        result = result.filter((p) => niveles.has(p.nivel_formacion));
+    }
+    if (filters.modalidad?.length) {
+        const mods = new Set(filters.modalidad);
+        result = result.filter((p) => mods.has(p.modalidad));
+    }
+    if (filters.sector?.length) {
+        const sectors = new Set(filters.sector);
+        result = result.filter((p) => sectors.has(p.sector));
+    }
+    return result;
+}
+/**
+ * Compute program counts per CINE broad field (for enrollment-based priors).
+ * Uses program count as a proxy for enrollment when actual enrollment data
+ * is not available.
+ */
+function computeFieldCounts(programs) {
+    const counts = new Map();
+    for (const p of programs) {
+        const field = p.cine_amplio;
+        if (field) {
+            counts.set(field, (counts.get(field) ?? 0) + 1);
+        }
+    }
+    return counts;
+}
+/**
+ * Recommend programs based on RIASEC profile.
+ *
+ * score(program) = similarity(student_profile, program_cine_vector)
+ *               × prior(program)
+ *
+ * prior(program) = base
+ *               × (1 + enrollmentWeight × log(national / field_count))
+ *               × (1 + regionalBoost × isInRegion)
+ *               × (1 + virtualBoost × isVirtual)
+ */
+export function recommend(config) {
+    const { profile, programs, filters, limit = 20, } = config;
+    const mapping = config.mapping ?? loadMapping();
+    const priors = {
+        enrollmentWeight: config.priors?.enrollmentWeight ?? -0.3,
+        regionalBoost: config.priors?.regionalBoost ?? 1.0,
+        virtualBoost: config.priors?.virtualBoost ?? 1.0,
+    };
+    const filtered = applyFilters(programs, filters);
+    const fieldCounts = computeFieldCounts(programs); // use full dataset for counts
+    const totalPrograms = programs.filter((p) => p.estado === "Activo").length;
+    // Pre-compute field profiles
+    const fieldProfileCache = new Map();
+    for (const field of fieldCounts.keys()) {
+        fieldProfileCache.set(field, fieldToProfile(field, mapping));
+    }
+    const regionalDepts = filters?.departments
+        ? new Set(filters.departments)
+        : null;
+    const results = [];
+    for (const program of filtered) {
+        const fieldProfile = fieldProfileCache.get(program.cine_amplio);
+        if (!fieldProfile)
+            continue;
+        // Profile similarity (cosine)
+        const similarity = cosineSimilarity(profile, fieldProfile);
+        if (similarity === 0)
+            continue;
+        // Enrollment-based prior
+        const fieldCount = fieldCounts.get(program.cine_amplio) ?? 1;
+        const enrollmentFactor = 1 + priors.enrollmentWeight * Math.log(totalPrograms / fieldCount);
+        // Regional boost
+        const isRegional = regionalDepts?.has(program.departamento) ? 1 : 0;
+        const regionalFactor = 1 + priors.regionalBoost * isRegional;
+        // Virtual boost
+        const isVirtual = VIRTUAL_MODALITIES.has(program.modalidad) ? 1 : 0;
+        const virtualFactor = 1 + priors.virtualBoost * isVirtual;
+        const priorAdjustment = enrollmentFactor * regionalFactor * virtualFactor;
+        const score = similarity * priorAdjustment;
+        // Find which RIASEC types match this field
+        const matchingTypes = RIASEC_TYPES.filter((t) => fieldProfile[t] > 0);
+        results.push({
+            program,
+            score,
+            matchDetails: {
+                profileSimilarity: similarity,
+                priorAdjustment,
+                matchingTypes,
+            },
+        });
+    }
+    // Sort by score descending, deduplicate by program name + institution
+    results.sort((a, b) => b.score - a.score);
+    // Deduplicate: keep highest-scoring entry per unique program
+    const seen = new Set();
+    const deduped = [];
+    for (const r of results) {
+        const key = `${r.program.codigo_snies}`;
+        if (!seen.has(key)) {
+            seen.add(key);
+            deduped.push(r);
+        }
+    }
+    return deduped.slice(0, limit);
+}
+//# sourceMappingURL=recommender.js.map

package/dist/recommender.js.map

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

package/dist/scoring.d.ts

@@ -0,0 +1,60 @@
+/**
+ * scoring.ts — Dirichlet-based Bayesian scoring for RIASEC profiles
+ *
+ * Uses Dirichlet distribution as conjugate prior for the categorical
+ * distribution over 6 RIASEC types. Each answer updates the alpha
+ * (concentration) parameters.
+ */
+import { type RIASECType, type RIASECProfile, type DirichletAlpha, type LikertResponse } from "./types.js";
+/** Create uniform Dirichlet prior: α = (1, 1, 1, 1, 1, 1) */
+export declare function uniformPrior(): DirichletAlpha;
+/**
+ * Update Dirichlet alpha after observing a response.
+ *
+ * For a positively-keyed item of type T with response r (1-5):
+ *   α_T += (r - 1) / 4  (normalized to [0, 1])
+ *
+ * For negatively-keyed items, the response is reversed:
+ *   α_T += (5 - r) / 4
+ */
+export declare function updateAlpha(alpha: DirichletAlpha, type: RIASECType, response: LikertResponse, keyed: "+" | "-"): DirichletAlpha;
+/**
+ * Compute the posterior mean (expected profile) from Dirichlet alpha.
+ * E[θ_k] = α_k / Σα
+ */
+export declare function posteriorMean(alpha: DirichletAlpha): RIASECProfile;
+/** Sum of all alpha parameters */
+export declare function alphaSum(alpha: DirichletAlpha): number;
+/**
+ * Shannon entropy of the posterior mean.
+ * H = -Σ p_k log2(p_k)
+ *
+ * Maximum entropy (uniform) = log2(6) ≈ 2.585
+ * Minimum entropy = 0 (all mass on one type)
+ */
+export declare function entropy(alpha: DirichletAlpha): number;
+/** Maximum possible entropy for 6 categories */
+export declare const MAX_ENTROPY: number;
+/**
+ * Confidence: 1 - (entropy / max_entropy)
+ * 0 = uniform (no info), 1 = certain (all mass on one type)
+ */
+export declare function confidence(alpha: DirichletAlpha): number;
+/**
+ * Expected information gain from asking an item of a given type.
+ *
+ * Approximation: items of the type with lowest alpha (most uncertain)
+ * yield the most information gain. We compute the expected KL divergence
+ * between the current posterior and the expected posterior after answering.
+ */
+export declare function expectedInfoGain(alpha: DirichletAlpha, type: RIASECType): number;
+/**
+ * KL divergence: D_KL(P || Q) = Σ P(x) log2(P(x) / Q(x))
+ */
+export declare function klDivergence(p: RIASECProfile, q: RIASECProfile): number;
+/**
+ * Cosine similarity between two RIASEC profiles.
+ * Returns value in [0, 1].
+ */
+export declare function cosineSimilarity(a: RIASECProfile, b: RIASECProfile): number;
+//# sourceMappingURL=scoring.d.ts.map

package/dist/scoring.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"scoring.d.ts","sourceRoot":"","sources":["../src/scoring.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAEH,OAAO,EAAgB,KAAK,UAAU,EAAE,KAAK,aAAa,EAAE,KAAK,cAAc,EAAE,KAAK,cAAc,EAAE,MAAM,YAAY,CAAC;AAEzH,6DAA6D;AAC7D,wBAAgB,YAAY,IAAI,cAAc,CAE7C;AAED;;;;;;;;GAQG;AACH,wBAAgB,WAAW,CACzB,KAAK,EAAE,cAAc,EACrB,IAAI,EAAE,UAAU,EAChB,QAAQ,EAAE,cAAc,EACxB,KAAK,EAAE,GAAG,GAAG,GAAG,GACf,cAAc,CAShB;AAED;;;GAGG;AACH,wBAAgB,aAAa,CAAC,KAAK,EAAE,cAAc,GAAG,aAAa,CAKlE;AAED,kCAAkC;AAClC,wBAAgB,QAAQ,CAAC,KAAK,EAAE,cAAc,GAAG,MAAM,CAEtD;AAED;;;;;;GAMG;AACH,wBAAgB,OAAO,CAAC,KAAK,EAAE,cAAc,GAAG,MAAM,CAUrD;AAED,gDAAgD;AAChD,eAAO,MAAM,WAAW,QAAe,CAAC;AAExC;;;GAGG;AACH,wBAAgB,UAAU,CAAC,KAAK,EAAE,cAAc,GAAG,MAAM,CAExD;AAED;;;;;;GAMG;AACH,wBAAgB,gBAAgB,CAAC,KAAK,EAAE,cAAc,EAAE,IAAI,EAAE,UAAU,GAAG,MAAM,CAehF;AAED;;GAEG;AACH,wBAAgB,YAAY,CAAC,CAAC,EAAE,aAAa,EAAE,CAAC,EAAE,aAAa,GAAG,MAAM,CAQvE;AAED;;;GAGG;AACH,wBAAgB,gBAAgB,CAAC,CAAC,EAAE,aAAa,EAAE,CAAC,EAAE,aAAa,GAAG,MAAM,CAS3E"}

package/dist/scoring.js

@@ -0,0 +1,116 @@
+/**
+ * scoring.ts — Dirichlet-based Bayesian scoring for RIASEC profiles
+ *
+ * Uses Dirichlet distribution as conjugate prior for the categorical
+ * distribution over 6 RIASEC types. Each answer updates the alpha
+ * (concentration) parameters.
+ */
+import { RIASEC_TYPES } from "./types.js";
+/** Create uniform Dirichlet prior: α = (1, 1, 1, 1, 1, 1) */
+export function uniformPrior() {
+    return Object.fromEntries(RIASEC_TYPES.map((t) => [t, 1]));
+}
+/**
+ * Update Dirichlet alpha after observing a response.
+ *
+ * For a positively-keyed item of type T with response r (1-5):
+ *   α_T += (r - 1) / 4  (normalized to [0, 1])
+ *
+ * For negatively-keyed items, the response is reversed:
+ *   α_T += (5 - r) / 4
+ */
+export function updateAlpha(alpha, type, response, keyed) {
+    const normalized = keyed === "+"
+        ? (response - 1) / 4
+        : (5 - response) / 4;
+    return {
+        ...alpha,
+        [type]: alpha[type] + normalized,
+    };
+}
+/**
+ * Compute the posterior mean (expected profile) from Dirichlet alpha.
+ * E[θ_k] = α_k / Σα
+ */
+export function posteriorMean(alpha) {
+    const sum = alphaSum(alpha);
+    return Object.fromEntries(RIASEC_TYPES.map((t) => [t, alpha[t] / sum]));
+}
+/** Sum of all alpha parameters */
+export function alphaSum(alpha) {
+    return RIASEC_TYPES.reduce((s, t) => s + alpha[t], 0);
+}
+/**
+ * Shannon entropy of the posterior mean.
+ * H = -Σ p_k log2(p_k)
+ *
+ * Maximum entropy (uniform) = log2(6) ≈ 2.585
+ * Minimum entropy = 0 (all mass on one type)
+ */
+export function entropy(alpha) {
+    const profile = posteriorMean(alpha);
+    let h = 0;
+    for (const t of RIASEC_TYPES) {
+        const p = profile[t];
+        if (p > 0) {
+            h -= p * Math.log2(p);
+        }
+    }
+    return h;
+}
+/** Maximum possible entropy for 6 categories */
+export const MAX_ENTROPY = Math.log2(6);
+/**
+ * Confidence: 1 - (entropy / max_entropy)
+ * 0 = uniform (no info), 1 = certain (all mass on one type)
+ */
+export function confidence(alpha) {
+    return 1 - entropy(alpha) / MAX_ENTROPY;
+}
+/**
+ * Expected information gain from asking an item of a given type.
+ *
+ * Approximation: items of the type with lowest alpha (most uncertain)
+ * yield the most information gain. We compute the expected KL divergence
+ * between the current posterior and the expected posterior after answering.
+ */
+export function expectedInfoGain(alpha, type) {
+    const sum = alphaSum(alpha);
+    // Simulate average response (response=3, neutral contribution)
+    // and high response (response=5, full contribution)
+    // Weight: 50% neutral, 50% positive (approximation of response distribution)
+    let totalKL = 0;
+    for (const response of [1, 3, 5]) {
+        const newAlpha = updateAlpha(alpha, type, response, "+");
+        const kl = klDivergence(posteriorMean(newAlpha), posteriorMean(alpha));
+        totalKL += kl / 3; // uniform weight over simulated responses
+    }
+    return totalKL;
+}
+/**
+ * KL divergence: D_KL(P || Q) = Σ P(x) log2(P(x) / Q(x))
+ */
+export function klDivergence(p, q) {
+    let kl = 0;
+    for (const t of RIASEC_TYPES) {
+        if (p[t] > 0 && q[t] > 0) {
+            kl += p[t] * Math.log2(p[t] / q[t]);
+        }
+    }
+    return kl;
+}
+/**
+ * Cosine similarity between two RIASEC profiles.
+ * Returns value in [0, 1].
+ */
+export function cosineSimilarity(a, b) {
+    let dot = 0, normA = 0, normB = 0;
+    for (const t of RIASEC_TYPES) {
+        dot += a[t] * b[t];
+        normA += a[t] * a[t];
+        normB += b[t] * b[t];
+    }
+    const denom = Math.sqrt(normA) * Math.sqrt(normB);
+    return denom === 0 ? 0 : dot / denom;
+}
+//# sourceMappingURL=scoring.js.map

package/dist/scoring.js.map

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

package/dist/types.d.ts

@@ -0,0 +1,159 @@
+/** The six Holland RIASEC types */
+export declare const RIASEC_TYPES: readonly ["R", "I", "A", "S", "E", "C"];
+export type RIASECType = (typeof RIASEC_TYPES)[number];
+/** A RIASEC profile: probability distribution over 6 types */
+export type RIASECProfile = Record<RIASECType, number>;
+/** Dirichlet concentration parameters (alpha vector) */
+export type DirichletAlpha = Record<RIASECType, number>;
+/** Response scale: 1-5 Likert */
+export type LikertResponse = 1 | 2 | 3 | 4 | 5;
+/** A single IPIP RIASEC item */
+export interface Item {
+    id: string;
+    type: RIASECType;
+    text: string;
+    keyed: "+" | "-";
+}
+/** Item bank with metadata */
+export interface ItemBank {
+    meta: {
+        source: string;
+        scale: string;
+        reference: string;
+        license: string;
+        response_scale: Record<string, string>;
+        types: Record<RIASECType, string>;
+    };
+    items: Item[];
+}
+/** A recorded answer */
+export interface Answer {
+    itemId: string;
+    type: RIASECType;
+    response: LikertResponse;
+    keyed: "+" | "-";
+}
+/** Quiz configuration */
+export interface QuizConfig {
+    /** Language for item text */
+    language: "en" | "es";
+    /** Quiz mode: adaptive (entropy-based stopping) or full (all 48 items) */
+    mode: "adaptive" | "full";
+    /** Entropy threshold for adaptive stopping (lower = more questions). Default: 1.5 */
+    entropyThreshold?: number;
+    /** Maximum questions in adaptive mode. Default: 24 */
+    maxQuestions?: number;
+    /** Minimum questions in adaptive mode. Default: 12 */
+    minQuestions?: number;
+}
+/** Quiz progress info */
+export interface QuizProgress {
+    answered: number;
+    total: number;
+    estimatedRemaining: number;
+    confidence: number;
+    entropy: number;
+}
+/** A SNIES program record (canonical CSV row) */
+export interface Program {
+    codigo_institucion_padre: string;
+    codigo_snies: number;
+    nombre_programa: string;
+    codigo_institucion: string;
+    nombre_institucion: string;
+    estado: "Activo" | "Inactivo";
+    estado_institucion: string;
+    caracter_academico: string;
+    sector: string;
+    nivel_academico: string;
+    nivel_formacion: string;
+    modalidad: string;
+    titulo_otorgado: string;
+    reconocimiento: string | null;
+    cine_amplio: string;
+    cine_especifico: string;
+    cine_detallado: string;
+    area_conocimiento: string;
+    nucleo_conocimiento: string;
+    departamento: string;
+    municipio: string;
+    creditos: number | null;
+    periodos_duracion: number | null;
+    periodicidad: string | null;
+    periodicidad_admisiones: string | null;
+    costo_matricula: number | null;
+    en_convenio: string | null;
+    vigencia_anos: string | null;
+    ciclos_propedeuticos: string | null;
+    fecha_registro_snies: string | null;
+}
+/** A coverage record (Cobertura sheet — per-municipality offering) */
+export interface Cobertura {
+    codigo_snies: number;
+    nombre_programa: string;
+    tipo_cubrimiento: string;
+    departamento: string;
+    municipio: string;
+    nombre_institucion: string;
+    codigo_institucion: string;
+    costo_matricula: number | null;
+}
+/** A convenio record (inter-institutional agreement) */
+export interface Convenio {
+    codigo_snies: number;
+    nombre_programa: string;
+    tipo_cubrimiento: string;
+    departamento: string;
+    municipio: string;
+    nombre_institucion: string;
+    codigo_institucion: string;
+}
+/** RIASEC → CINE field mapping entry */
+export interface FieldMapping {
+    cine_amplio: string;
+    weight: number;
+}
+/** Full mapping for one RIASEC type */
+export interface TypeMapping {
+    name: string;
+    name_es: string;
+    description: string;
+    fields: FieldMapping[];
+}
+/** Recommendation config */
+export interface RecommendConfig {
+    profile: RIASECProfile;
+    programs: Program[];
+    mapping?: Record<RIASECType, TypeMapping>;
+    filters?: ProgramFilters;
+    priors?: PriorWeights;
+    limit?: number;
+}
+/** Filters for program recommendations */
+export interface ProgramFilters {
+    departments?: string[];
+    active?: boolean;
+    nivel_formacion?: string[];
+    modalidad?: string[];
+    sector?: string[];
+}
+/** Prior weights for recommendation scoring */
+export interface PriorWeights {
+    /** Weight for enrollment-based adjustment. Negative = downweight popular fields. Default: -0.3 */
+    enrollmentWeight?: number;
+    /** Boost for programs in specified departments. Default: 1.0 */
+    regionalBoost?: number;
+    /** Boost for virtual/distance programs. Default: 1.0 */
+    virtualBoost?: number;
+}
+/** A single program recommendation with score */
+export interface Recommendation {
+    program: Program;
+    score: number;
+    matchDetails: {
+        profileSimilarity: number;
+        priorAdjustment: number;
+        matchingTypes: RIASECType[];
+    };
+}
+//# sourceMappingURL=types.d.ts.map

package/dist/types.d.ts.map

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

package/dist/types.js

@@ -0,0 +1,3 @@
+/** The six Holland RIASEC types */
+export const RIASEC_TYPES = ["R", "I", "A", "S", "E", "C"];
+//# sourceMappingURL=types.js.map

package/dist/types.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.js","sourceRoot":"","sources":["../src/types.ts"],"names":[],"mappings":"AAAA,mCAAmC;AACnC,MAAM,CAAC,MAAM,YAAY,GAAG,CAAC,GAAG,EAAE,GAAG,EAAE,GAAG,EAAE,GAAG,EAAE,GAAG,EAAE,GAAG,CAAU,CAAC"}

package/package.json

@@ -0,0 +1,47 @@
+{
+  "name": "riasec-co",
+  "version": "0.1.0",
+  "description": "Bayesian adaptive RIASEC quiz engine with Colombian SNIES program data",
+  "type": "module",
+  "main": "dist/index.js",
+  "types": "dist/index.d.ts",
+  "exports": {
+    ".": {
+      "import": "./dist/index.js",
+      "types": "./dist/index.d.ts"
+    }
+  },
+  "files": [
+    "dist/",
+    "../../data/canonical/"
+  ],
+  "scripts": {
+    "build": "tsc",
+    "test": "vitest run",
+    "test:watch": "vitest",
+    "ci": "tsc --noEmit && vitest run"
+  },
+  "keywords": [
+    "riasec",
+    "holland",
+    "vocational",
+    "career",
+    "guidance",
+    "bayesian",
+    "snies",
+    "colombia",
+    "education"
+  ],
+  "author": "Andres Romero <me@afromero.co>",
+  "license": "MIT",
+  "repository": {
+    "type": "git",
+    "url": "https://github.com/afromero/riasec-co.git",
+    "directory": "packages/core"
+  },
+  "devDependencies": {
+    "@types/node": "^25.5.0",
+    "typescript": "^5.6.0",
+    "vitest": "^3.0.0"
+  }
+}