@medicine-wheel/transformation-tracker 0.2.2

package/dist/reciprocity-ledger.js

@@ -0,0 +1,98 @@
+"use strict";
+/**
+ * @medicine-wheel/transformation-tracker — Reciprocity Ledger Module
+ *
+ * Manages the reciprocity ledger: tracking giving and receiving
+ * across the research process. Wilson's relational accountability
+ * demands balanced reciprocity — what you take, you must give back.
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.logGiving = logGiving;
+exports.logReceiving = logReceiving;
+exports.balanceCheck = balanceCheck;
+exports.reciprocityDebt = reciprocityDebt;
+/**
+ * Log a giving entry to the reciprocity ledger.
+ * Records something the researcher has given back to the community,
+ * land, spirit, or future generations.
+ */
+function logGiving(log, entry) {
+    const givingEntry = { ...entry, type: 'giving' };
+    return {
+        ...log,
+        reciprocityLedger: [...log.reciprocityLedger, givingEntry],
+    };
+}
+/**
+ * Log a receiving entry to the reciprocity ledger.
+ * Records something the researcher has received from the community,
+ * land, spirit, or ancestors.
+ */
+function logReceiving(log, entry) {
+    const receivingEntry = { ...entry, type: 'receiving' };
+    return {
+        ...log,
+        reciprocityLedger: [...log.reciprocityLedger, receivingEntry],
+    };
+}
+/**
+ * Check whether reciprocity is balanced.
+ * Balance is assessed per-category and overall.
+ */
+function balanceCheck(log) {
+    const categories = ['human', 'land', 'spirit', 'future'];
+    const categoryBalances = [];
+    for (const category of categories) {
+        const giving = log.reciprocityLedger.filter((e) => e.type === 'giving' && e.category === category).length;
+        const receiving = log.reciprocityLedger.filter((e) => e.type === 'receiving' && e.category === category).length;
+        const balanced = giving > 0 && receiving > 0 && giving / receiving >= 0.5 && giving / receiving <= 2.0;
+        categoryBalances.push({ category, giving, receiving, balanced });
+    }
+    const totalGiving = log.reciprocityLedger.filter((e) => e.type === 'giving').length;
+    const totalReceiving = log.reciprocityLedger.filter((e) => e.type === 'receiving').length;
+    const overallBalanced = totalGiving > 0 &&
+        totalReceiving > 0 &&
+        totalGiving / totalReceiving >= 0.5 &&
+        totalGiving / totalReceiving <= 2.0;
+    return {
+        overallBalanced,
+        totalGiving,
+        totalReceiving,
+        categoryBalances,
+        summary: overallBalanced
+            ? 'Reciprocity is balanced overall.'
+            : totalGiving === 0 && totalReceiving === 0
+                ? 'No reciprocity entries. Begin tracking what you give and receive.'
+                : totalGiving < totalReceiving
+                    ? 'Reciprocity imbalance: receiving more than giving. Consider what you can return.'
+                    : 'Reciprocity imbalance: giving more than receiving. Be open to receiving.',
+    };
+}
+/**
+ * Identify reciprocity debts — areas where receiving outpaces giving.
+ * These represent relational obligations that need to be honored.
+ */
+function reciprocityDebt(log) {
+    const categories = ['human', 'land', 'spirit', 'future'];
+    const debts = [];
+    for (const category of categories) {
+        const giving = log.reciprocityLedger.filter((e) => e.type === 'giving' && e.category === category);
+        const receiving = log.reciprocityLedger.filter((e) => e.type === 'receiving' && e.category === category);
+        if (receiving.length > giving.length) {
+            debts.push({
+                category,
+                deficit: receiving.length - giving.length,
+                receivedFrom: [...new Set(receiving.map((e) => e.relatedTo))],
+                suggestion: `You have received ${receiving.length} time(s) from ${category} relations but given back only ${giving.length} time(s). Consider ways to reciprocate.`,
+            });
+        }
+    }
+    return {
+        hasDebts: debts.length > 0,
+        debts,
+        summary: debts.length === 0
+            ? 'No reciprocity debts detected.'
+            : `Reciprocity debts in ${debts.length} category/categories: ${debts.map((d) => d.category).join(', ')}.`,
+    };
+}
+//# sourceMappingURL=reciprocity-ledger.js.map

package/dist/reciprocity-ledger.js.map

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

package/dist/relational-shift.d.ts

@@ -0,0 +1,69 @@
+/**
+ * @medicine-wheel/transformation-tracker — Relational Shift Module
+ *
+ * Tracks changes in relational strength and quality over time.
+ * In Wilson's framework, strengthened relations are a primary
+ * indicator of valid research.
+ */
+import type { TransformationLog, RelationalShift } from './types.js';
+/**
+ * Record a relational shift in the transformation log.
+ * Captures the before/after state and what catalyzed the change.
+ */
+export declare function trackRelationalChange(log: TransformationLog, shift: RelationalShift): TransformationLog;
+/**
+ * Get the before/after state for a specific relation.
+ * Returns the most recent shift for the given relation ID.
+ */
+export declare function beforeAfter(log: TransformationLog, relationId: string): RelationalShiftSummary | null;
+/**
+ * Compute aggregate relational strength changes across all tracked relations.
+ * Returns overall direction of relational health.
+ */
+export declare function strengthDelta(log: TransformationLog): StrengthDeltaResult;
+/**
+ * Count and describe new relations formed during the research.
+ * New relations are detected by relation IDs that appear only in
+ * "after" states with no prior "before" baseline.
+ */
+export declare function newRelationsFormed(log: TransformationLog): NewRelationsResult;
+/** Summary of a relation's full shift history */
+export interface RelationalShiftSummary {
+    relationId: string;
+    originalState: {
+        strength: number;
+        description: string;
+    };
+    currentState: {
+        strength: number;
+        description: string;
+    };
+    totalShifts: number;
+    netStrengthChange: number;
+    catalysts: string[];
+}
+/** Aggregate relational strength delta result */
+export interface StrengthDeltaResult {
+    totalShifts: number;
+    averageDelta: number;
+    strengthened: number;
+    weakened: number;
+    unchanged: number;
+    summary: string;
+}
+/** New relation descriptor */
+export interface NewRelationDescriptor {
+    relationId: string;
+    currentStrength: number;
+    description: string;
+    catalyst: string;
+    direction: string;
+    formedAt: string;
+}
+/** Result of new relations analysis */
+export interface NewRelationsResult {
+    count: number;
+    relations: NewRelationDescriptor[];
+    summary: string;
+}
+//# sourceMappingURL=relational-shift.d.ts.map

package/dist/relational-shift.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"relational-shift.d.ts","sourceRoot":"","sources":["../src/relational-shift.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAEH,OAAO,KAAK,EAAE,iBAAiB,EAAE,eAAe,EAAE,MAAM,YAAY,CAAC;AAErE;;;GAGG;AACH,wBAAgB,qBAAqB,CACnC,GAAG,EAAE,iBAAiB,EACtB,KAAK,EAAE,eAAe,GACrB,iBAAiB,CAKnB;AAED;;;GAGG;AACH,wBAAgB,WAAW,CACzB,GAAG,EAAE,iBAAiB,EACtB,UAAU,EAAE,MAAM,GACjB,sBAAsB,GAAG,IAAI,CAkB/B;AAED;;;GAGG;AACH,wBAAgB,aAAa,CAAC,GAAG,EAAE,iBAAiB,GAAG,mBAAmB,CA8CzE;AAED;;;;GAIG;AACH,wBAAgB,kBAAkB,CAAC,GAAG,EAAE,iBAAiB,GAAG,kBAAkB,CA0B7E;AAID,iDAAiD;AACjD,MAAM,WAAW,sBAAsB;IACrC,UAAU,EAAE,MAAM,CAAC;IACnB,aAAa,EAAE;QAAE,QAAQ,EAAE,MAAM,CAAC;QAAC,WAAW,EAAE,MAAM,CAAA;KAAE,CAAC;IACzD,YAAY,EAAE;QAAE,QAAQ,EAAE,MAAM,CAAC;QAAC,WAAW,EAAE,MAAM,CAAA;KAAE,CAAC;IACxD,WAAW,EAAE,MAAM,CAAC;IACpB,iBAAiB,EAAE,MAAM,CAAC;IAC1B,SAAS,EAAE,MAAM,EAAE,CAAC;CACrB;AAED,iDAAiD;AACjD,MAAM,WAAW,mBAAmB;IAClC,WAAW,EAAE,MAAM,CAAC;IACpB,YAAY,EAAE,MAAM,CAAC;IACrB,YAAY,EAAE,MAAM,CAAC;IACrB,QAAQ,EAAE,MAAM,CAAC;IACjB,SAAS,EAAE,MAAM,CAAC;IAClB,OAAO,EAAE,MAAM,CAAC;CACjB;AAED,8BAA8B;AAC9B,MAAM,WAAW,qBAAqB;IACpC,UAAU,EAAE,MAAM,CAAC;IACnB,eAAe,EAAE,MAAM,CAAC;IACxB,WAAW,EAAE,MAAM,CAAC;IACpB,QAAQ,EAAE,MAAM,CAAC;IACjB,SAAS,EAAE,MAAM,CAAC;IAClB,QAAQ,EAAE,MAAM,CAAC;CAClB;AAED,uCAAuC;AACvC,MAAM,WAAW,kBAAkB;IACjC,KAAK,EAAE,MAAM,CAAC;IACd,SAAS,EAAE,qBAAqB,EAAE,CAAC;IACnC,OAAO,EAAE,MAAM,CAAC;CACjB"}

package/dist/relational-shift.js

@@ -0,0 +1,123 @@
+"use strict";
+/**
+ * @medicine-wheel/transformation-tracker — Relational Shift Module
+ *
+ * Tracks changes in relational strength and quality over time.
+ * In Wilson's framework, strengthened relations are a primary
+ * indicator of valid research.
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.trackRelationalChange = trackRelationalChange;
+exports.beforeAfter = beforeAfter;
+exports.strengthDelta = strengthDelta;
+exports.newRelationsFormed = newRelationsFormed;
+/**
+ * Record a relational shift in the transformation log.
+ * Captures the before/after state and what catalyzed the change.
+ */
+function trackRelationalChange(log, shift) {
+    return {
+        ...log,
+        relationalShifts: [...log.relationalShifts, shift],
+    };
+}
+/**
+ * Get the before/after state for a specific relation.
+ * Returns the most recent shift for the given relation ID.
+ */
+function beforeAfter(log, relationId) {
+    const shifts = log.relationalShifts
+        .filter((s) => s.relationId === relationId)
+        .sort((a, b) => a.timestamp.localeCompare(b.timestamp));
+    if (shifts.length === 0)
+        return null;
+    const first = shifts[0];
+    const last = shifts[shifts.length - 1];
+    return {
+        relationId,
+        originalState: first.before,
+        currentState: last.after,
+        totalShifts: shifts.length,
+        netStrengthChange: last.after.strength - first.before.strength,
+        catalysts: shifts.map((s) => s.catalyst),
+    };
+}
+/**
+ * Compute aggregate relational strength changes across all tracked relations.
+ * Returns overall direction of relational health.
+ */
+function strengthDelta(log) {
+    if (log.relationalShifts.length === 0) {
+        return {
+            totalShifts: 0,
+            averageDelta: 0,
+            strengthened: 0,
+            weakened: 0,
+            unchanged: 0,
+            summary: 'No relational shifts tracked yet.',
+        };
+    }
+    const relationMap = new Map();
+    for (const shift of log.relationalShifts) {
+        const existing = relationMap.get(shift.relationId) || [];
+        existing.push(shift);
+        relationMap.set(shift.relationId, existing);
+    }
+    let strengthened = 0;
+    let weakened = 0;
+    let unchanged = 0;
+    let totalDelta = 0;
+    for (const [, shifts] of relationMap) {
+        const sorted = shifts.sort((a, b) => a.timestamp.localeCompare(b.timestamp));
+        const first = sorted[0];
+        const last = sorted[sorted.length - 1];
+        const delta = last.after.strength - first.before.strength;
+        totalDelta += delta;
+        if (delta > 0.05)
+            strengthened++;
+        else if (delta < -0.05)
+            weakened++;
+        else
+            unchanged++;
+    }
+    const averageDelta = totalDelta / relationMap.size;
+    return {
+        totalShifts: log.relationalShifts.length,
+        averageDelta,
+        strengthened,
+        weakened,
+        unchanged,
+        summary: `${relationMap.size} relations tracked: ${strengthened} strengthened, ${weakened} weakened, ${unchanged} stable. Average delta: ${averageDelta.toFixed(3)}.`,
+    };
+}
+/**
+ * Count and describe new relations formed during the research.
+ * New relations are detected by relation IDs that appear only in
+ * "after" states with no prior "before" baseline.
+ */
+function newRelationsFormed(log) {
+    const firstAppearance = new Map();
+    for (const shift of log.relationalShifts) {
+        if (!firstAppearance.has(shift.relationId)) {
+            firstAppearance.set(shift.relationId, shift);
+        }
+    }
+    const newRelations = [...firstAppearance.values()]
+        .filter((s) => s.before.strength === 0 && s.before.description === '')
+        .map((s) => ({
+        relationId: s.relationId,
+        currentStrength: s.after.strength,
+        description: s.after.description,
+        catalyst: s.catalyst,
+        direction: s.direction,
+        formedAt: s.timestamp,
+    }));
+    return {
+        count: newRelations.length,
+        relations: newRelations,
+        summary: newRelations.length === 0
+            ? 'No new relations formed yet.'
+            : `${newRelations.length} new relation(s) formed during this research cycle.`,
+    };
+}
+//# sourceMappingURL=relational-shift.js.map

package/dist/relational-shift.js.map

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

package/dist/researcher.d.ts

@@ -0,0 +1,49 @@
+/**
+ * @medicine-wheel/transformation-tracker — Researcher Module
+ *
+ * Tracks researcher self-reflection, understanding snapshots,
+ * and growth detection across the research cycle.
+ */
+import type { DirectionName } from '@medicine-wheel/ontology-core';
+import type { TransformationLog, GrowthSnapshot } from './types.js';
+/**
+ * Add a reflection entry to the transformation log.
+ * Reflections capture the researcher's evolving relationship
+ * with the research — Wilson's internal transformation signal.
+ */
+export declare function logReflection(log: TransformationLog, prompt: string, response: string, direction: DirectionName): TransformationLog;
+/**
+ * Capture a point-in-time snapshot of the researcher's understanding.
+ * Snapshots form the basis for growth detection over time.
+ */
+export declare function snapshotUnderstanding(log: TransformationLog, snapshot: GrowthSnapshot): TransformationLog;
+/**
+ * Compare two snapshots to detect growth signals.
+ * Returns a summary of changes across all measured dimensions.
+ */
+export declare function compareSnapshots(before: GrowthSnapshot, after: GrowthSnapshot): SnapshotComparison;
+/**
+ * Analyze the full transformation log for genuine growth signals.
+ * Wilson says growth must be relational, not just intellectual.
+ */
+export declare function detectGrowth(log: TransformationLog): GrowthSignal;
+/** Result of comparing two growth snapshots */
+export interface SnapshotComparison {
+    relationsGrowth: number;
+    alignmentGrowth: number;
+    newInsights: string[];
+    resolvedQuestions: string[];
+    newQuestions: string[];
+    understandingShifted: boolean;
+    directionShifted: boolean;
+    overallGrowth: number;
+}
+/** Growth signal analysis result */
+export interface GrowthSignal {
+    detected: boolean;
+    relationalGrowth: number;
+    intellectualGrowth: number;
+    reciprocityGrowth: number;
+    summary: string;
+}
+//# sourceMappingURL=researcher.d.ts.map

package/dist/researcher.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"researcher.d.ts","sourceRoot":"","sources":["../src/researcher.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,+BAA+B,CAAC;AACnE,OAAO,KAAK,EACV,iBAAiB,EACjB,cAAc,EAEf,MAAM,YAAY,CAAC;AAEpB;;;;GAIG;AACH,wBAAgB,aAAa,CAC3B,GAAG,EAAE,iBAAiB,EACtB,MAAM,EAAE,MAAM,EACd,QAAQ,EAAE,MAAM,EAChB,SAAS,EAAE,aAAa,GACvB,iBAAiB,CAanB;AAED;;;GAGG;AACH,wBAAgB,qBAAqB,CACnC,GAAG,EAAE,iBAAiB,EACtB,QAAQ,EAAE,cAAc,GACvB,iBAAiB,CAKnB;AAED;;;GAGG;AACH,wBAAgB,gBAAgB,CAC9B,MAAM,EAAE,cAAc,EACtB,KAAK,EAAE,cAAc,GACpB,kBAAkB,CA4BpB;AAED;;;GAGG;AACH,wBAAgB,YAAY,CAAC,GAAG,EAAE,iBAAiB,GAAG,YAAY,CAsCjE;AAID,+CAA+C;AAC/C,MAAM,WAAW,kBAAkB;IACjC,eAAe,EAAE,MAAM,CAAC;IACxB,eAAe,EAAE,MAAM,CAAC;IACxB,WAAW,EAAE,MAAM,EAAE,CAAC;IACtB,iBAAiB,EAAE,MAAM,EAAE,CAAC;IAC5B,YAAY,EAAE,MAAM,EAAE,CAAC;IACvB,oBAAoB,EAAE,OAAO,CAAC;IAC9B,gBAAgB,EAAE,OAAO,CAAC;IAC1B,aAAa,EAAE,MAAM,CAAC;CACvB;AAED,oCAAoC;AACpC,MAAM,WAAW,YAAY;IAC3B,QAAQ,EAAE,OAAO,CAAC;IAClB,gBAAgB,EAAE,MAAM,CAAC;IACzB,kBAAkB,EAAE,MAAM,CAAC;IAC3B,iBAAiB,EAAE,MAAM,CAAC;IAC1B,OAAO,EAAE,MAAM,CAAC;CACjB"}

package/dist/researcher.js

@@ -0,0 +1,118 @@
+"use strict";
+/**
+ * @medicine-wheel/transformation-tracker — Researcher Module
+ *
+ * Tracks researcher self-reflection, understanding snapshots,
+ * and growth detection across the research cycle.
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.logReflection = logReflection;
+exports.snapshotUnderstanding = snapshotUnderstanding;
+exports.compareSnapshots = compareSnapshots;
+exports.detectGrowth = detectGrowth;
+/**
+ * Add a reflection entry to the transformation log.
+ * Reflections capture the researcher's evolving relationship
+ * with the research — Wilson's internal transformation signal.
+ */
+function logReflection(log, prompt, response, direction) {
+    const reflection = {
+        id: `ref-${log.reflections.length + 1}-${Date.now()}`,
+        timestamp: new Date().toISOString(),
+        prompt,
+        response,
+        direction,
+        depth: estimateDepth(response),
+    };
+    return {
+        ...log,
+        reflections: [...log.reflections, reflection],
+    };
+}
+/**
+ * Capture a point-in-time snapshot of the researcher's understanding.
+ * Snapshots form the basis for growth detection over time.
+ */
+function snapshotUnderstanding(log, snapshot) {
+    return {
+        ...log,
+        snapshots: [...log.snapshots, snapshot],
+    };
+}
+/**
+ * Compare two snapshots to detect growth signals.
+ * Returns a summary of changes across all measured dimensions.
+ */
+function compareSnapshots(before, after) {
+    const relationsGrowth = after.relationsCount - before.relationsCount;
+    const alignmentGrowth = after.wilsonAlignment - before.wilsonAlignment;
+    const newInsights = after.keyInsights.filter((i) => !before.keyInsights.includes(i));
+    const resolvedQuestions = before.openQuestions.filter((q) => !after.openQuestions.includes(q));
+    const newQuestions = after.openQuestions.filter((q) => !before.openQuestions.includes(q));
+    return {
+        relationsGrowth,
+        alignmentGrowth,
+        newInsights,
+        resolvedQuestions,
+        newQuestions,
+        understandingShifted: before.understanding !== after.understanding,
+        directionShifted: before.direction !== after.direction,
+        overallGrowth: computeOverallGrowth(relationsGrowth, alignmentGrowth, newInsights.length, resolvedQuestions.length),
+    };
+}
+/**
+ * Analyze the full transformation log for genuine growth signals.
+ * Wilson says growth must be relational, not just intellectual.
+ */
+function detectGrowth(log) {
+    if (log.snapshots.length < 2) {
+        return {
+            detected: false,
+            relationalGrowth: 0,
+            intellectualGrowth: 0,
+            reciprocityGrowth: 0,
+            summary: 'Insufficient snapshots — at least two required to detect growth.',
+        };
+    }
+    const first = log.snapshots[0];
+    const last = log.snapshots[log.snapshots.length - 1];
+    const comparison = compareSnapshots(first, last);
+    const relationalGrowth = normalizeScore(comparison.relationsGrowth / Math.max(first.relationsCount, 1));
+    const intellectualGrowth = normalizeScore((comparison.newInsights.length + comparison.resolvedQuestions.length) /
+        Math.max(first.keyInsights.length + first.openQuestions.length, 1));
+    const givingCount = log.reciprocityLedger.filter((e) => e.type === 'giving').length;
+    const receivingCount = log.reciprocityLedger.filter((e) => e.type === 'receiving').length;
+    const reciprocityGrowth = normalizeScore((givingCount + receivingCount) / Math.max(log.snapshots.length, 1));
+    const detected = relationalGrowth > 0.1 || intellectualGrowth > 0.1 || reciprocityGrowth > 0.1;
+    return {
+        detected,
+        relationalGrowth,
+        intellectualGrowth,
+        reciprocityGrowth,
+        summary: detected
+            ? `Growth detected: relational=${relationalGrowth.toFixed(2)}, intellectual=${intellectualGrowth.toFixed(2)}, reciprocity=${reciprocityGrowth.toFixed(2)}`
+            : 'No significant growth detected yet. Continue deepening relational engagement.',
+    };
+}
+// ── Internal Helpers ────────────────────────────────────────────────────────
+function estimateDepth(response) {
+    const wordCount = response.split(/\s+/).length;
+    const hasQuestions = /\?/.test(response);
+    const hasRelationalLanguage = /relat|connect|together|reciproc|obligat|account/i.test(response);
+    let depth = Math.min(wordCount / 500, 0.5);
+    if (hasQuestions)
+        depth += 0.2;
+    if (hasRelationalLanguage)
+        depth += 0.3;
+    return Math.min(depth, 1);
+}
+function computeOverallGrowth(relations, alignment, insights, resolved) {
+    return normalizeScore((Math.max(relations, 0) * 0.3) +
+        (Math.max(alignment, 0) * 0.3) +
+        (insights * 0.1) +
+        (resolved * 0.1));
+}
+function normalizeScore(value) {
+    return Math.max(0, Math.min(1, value));
+}
+//# sourceMappingURL=researcher.js.map

package/dist/researcher.js.map

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