@medicine-wheel/ontology-core 0.2.2

package/dist/queries.js

@@ -0,0 +1,218 @@
+"use strict";
+/**
+ * @medicine-wheel/ontology-core — Semantic Query Helpers
+ *
+ * Functions for traversing relational webs, computing Wilson alignment
+ * metrics, and checking OCAP® compliance. These helpers operate on
+ * in-memory collections — the storage layer (Redis, etc.) is external.
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.nodesByDirection = nodesByDirection;
+exports.nodesByType = nodesByType;
+exports.nodeById = nodeById;
+exports.relationsForNode = relationsForNode;
+exports.relationsByType = relationsByType;
+exports.neighborIds = neighborIds;
+exports.traverseRelationalWeb = traverseRelationalWeb;
+exports.computeWilsonAlignment = computeWilsonAlignment;
+exports.aggregateWilsonAlignment = aggregateWilsonAlignment;
+exports.cycleWilsonAlignment = cycleWilsonAlignment;
+exports.findAccountabilityGaps = findAccountabilityGaps;
+exports.checkOcapCompliance = checkOcapCompliance;
+exports.auditOcapCompliance = auditOcapCompliance;
+exports.beatsByDirection = beatsByDirection;
+exports.beatsByAct = beatsByAct;
+exports.allDirectionsVisited = allDirectionsVisited;
+exports.ceremoniesByDirection = ceremoniesByDirection;
+exports.ceremonyCounts = ceremonyCounts;
+exports.relationalCompleteness = relationalCompleteness;
+// ── Node Queries ────────────────────────────────────────────────────────────
+/** Find all nodes aligned with a given direction */
+function nodesByDirection(nodes, direction) {
+    return nodes.filter(n => n.direction === direction);
+}
+/** Find all nodes of a given type */
+function nodesByType(nodes, type) {
+    return nodes.filter(n => n.type === type);
+}
+/** Find a node by ID */
+function nodeById(nodes, id) {
+    return nodes.find(n => n.id === id);
+}
+// ── Relational Traversal ────────────────────────────────────────────────────
+/** Get all relations connected to a given node (as source or target) */
+function relationsForNode(relations, nodeId) {
+    return relations.filter(r => r.from_id === nodeId || r.to_id === nodeId);
+}
+/** Get all relations of a given type */
+function relationsByType(relations, type) {
+    return relations.filter(r => r.relationship_type === type);
+}
+/** Get neighbor node IDs for a given node through its relations */
+function neighborIds(relations, nodeId) {
+    const ids = new Set();
+    for (const r of relations) {
+        if (r.from_id === nodeId)
+            ids.add(r.to_id);
+        if (r.to_id === nodeId)
+            ids.add(r.from_id);
+    }
+    return [...ids];
+}
+/** Traverse the relational web from a starting node up to a given depth */
+function traverseRelationalWeb(nodes, relations, startNodeId, maxDepth = 3) {
+    const visited = new Set();
+    const paths = [];
+    const queue = [
+        { nodeId: startNodeId, path: [startNodeId], depth: 0 },
+    ];
+    while (queue.length > 0) {
+        const { nodeId, path, depth } = queue.shift();
+        if (visited.has(nodeId) || depth > maxDepth)
+            continue;
+        visited.add(nodeId);
+        if (path.length > 1)
+            paths.push(path);
+        for (const nId of neighborIds(relations, nodeId)) {
+            if (!visited.has(nId)) {
+                queue.push({ nodeId: nId, path: [...path, nId], depth: depth + 1 });
+            }
+        }
+    }
+    return { visited, paths };
+}
+// ── Wilson Alignment Metrics ────────────────────────────────────────────────
+/**
+ * Compute Wilson alignment score for a single accountability tracking object.
+ * Wilson's three R's (Respect, Reciprocity, Responsibility) are averaged.
+ */
+function computeWilsonAlignment(accountability) {
+    const { respect, reciprocity, responsibility } = accountability;
+    return (respect + reciprocity + responsibility) / 3;
+}
+/**
+ * Compute aggregate Wilson alignment across a collection of relations.
+ * Returns 0 if no relations exist.
+ */
+function aggregateWilsonAlignment(relations) {
+    if (relations.length === 0)
+        return 0;
+    const total = relations.reduce((sum, r) => sum + computeWilsonAlignment(r.accountability), 0);
+    return total / relations.length;
+}
+/**
+ * Compute Wilson alignment for a Medicine Wheel cycle based on its
+ * ceremonies conducted and relations mapped.
+ */
+function cycleWilsonAlignment(cycle, relations) {
+    if (relations.length === 0)
+        return cycle.wilson_alignment;
+    return aggregateWilsonAlignment(relations);
+}
+/**
+ * Identify relations with low Wilson alignment (below threshold).
+ * These represent accountability gaps requiring ceremonial attention.
+ */
+function findAccountabilityGaps(relations, threshold = 0.5) {
+    return relations.filter(r => computeWilsonAlignment(r.accountability) < threshold);
+}
+// ── OCAP® Compliance ────────────────────────────────────────────────────────
+/**
+ * Check whether OCAP® flags meet compliance requirements.
+ * Full compliance requires: ownership specified, control specified,
+ * access not 'public' (for Indigenous data), and compliant flag true.
+ */
+function checkOcapCompliance(ocap) {
+    const issues = [];
+    if (!ocap.ownership || ocap.ownership.trim() === '') {
+        issues.push('Ownership not specified');
+    }
+    if (!ocap.control || ocap.control.trim() === '') {
+        issues.push('Control not specified');
+    }
+    if (!ocap.compliant) {
+        issues.push('OCAP® compliance flag not set');
+    }
+    if (ocap.consent_given === false) {
+        issues.push('Consent not given for this use');
+    }
+    return {
+        compliant: issues.length === 0,
+        issues,
+    };
+}
+/**
+ * Check OCAP® compliance across all relations.
+ * Returns summary with overall status and per-relation issues.
+ */
+function auditOcapCompliance(relations) {
+    const results = relations.map(r => ({
+        relation_id: r.id,
+        ...checkOcapCompliance(r.ocap),
+    }));
+    const non_compliant = results.filter(r => !r.compliant);
+    return {
+        overall_compliant: non_compliant.length === 0,
+        compliant_count: results.length - non_compliant.length,
+        non_compliant_count: non_compliant.length,
+        issues: non_compliant.map(r => ({
+            relation_id: r.relation_id,
+            issues: r.issues,
+        })),
+    };
+}
+// ── Narrative Queries ───────────────────────────────────────────────────────
+/** Get beats for a specific direction */
+function beatsByDirection(beats, direction) {
+    return beats.filter(b => b.direction === direction);
+}
+/** Get beats for a specific act number */
+function beatsByAct(beats, act) {
+    return beats.filter(b => b.act === act);
+}
+/** Check whether all four directions have been visited in a set of beats */
+function allDirectionsVisited(beats) {
+    const visited = new Set(beats.map(b => b.direction));
+    return visited.has('east') && visited.has('south') &&
+        visited.has('west') && visited.has('north');
+}
+// ── Ceremony Queries ────────────────────────────────────────────────────────
+/** Get ceremonies for a specific direction */
+function ceremoniesByDirection(ceremonies, direction) {
+    return ceremonies.filter(c => c.direction === direction);
+}
+/** Count ceremonies across all directions */
+function ceremonyCounts(ceremonies) {
+    return {
+        east: ceremonies.filter(c => c.direction === 'east').length,
+        south: ceremonies.filter(c => c.direction === 'south').length,
+        west: ceremonies.filter(c => c.direction === 'west').length,
+        north: ceremonies.filter(c => c.direction === 'north').length,
+    };
+}
+// ── Relational Completeness ─────────────────────────────────────────────────
+/**
+ * Assess relational completeness of a node — how well connected it is
+ * across all obligation categories (human, land, spirit, future).
+ */
+function relationalCompleteness(nodeId, relations) {
+    const nodeRelations = relationsForNode(relations, nodeId);
+    const categories = new Set();
+    for (const r of nodeRelations) {
+        for (const o of r.obligations) {
+            categories.add(o.category);
+        }
+    }
+    const allCategories = ['human', 'land', 'spirit', 'future'];
+    const missing = allCategories.filter(c => !categories.has(c));
+    const ceremonied = nodeRelations.filter(r => r.ceremony_context?.ceremony_honored).length;
+    return {
+        total_relations: nodeRelations.length,
+        obligation_categories_covered: [...categories],
+        missing_categories: missing,
+        ceremony_coverage: nodeRelations.length > 0
+            ? ceremonied / nodeRelations.length
+            : 0,
+    };
+}
+//# sourceMappingURL=queries.js.map

package/dist/queries.js.map

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