@lucern/graph-primitives 0.1.0-alpha.2

package/README.md

@@ -0,0 +1,29 @@
+# Graph Primitives Module
+
+## Responsibility
+
+Core epistemic graph primitives, identifiers, and base object lifecycles.
+
+## Current owned paths
+
+1. `modules/graph-primitives/src/index.ts`
+2. `modules/graph-primitives/src/epistemicNodes.ts`
+3. `modules/graph-primitives/src/epistemicEdges.ts`
+4. `modules/graph-primitives/src/epistemicBeliefs.ts`
+5. `modules/graph-primitives/src/epistemicQuestions.ts`
+6. `modules/graph-primitives/src/epistemicEvidence.ts`
+7. `modules/graph-primitives/src/graphTypes.ts`
+8. `modules/graph-primitives/src/globalId.ts`
+9. `convex/epistemicNodes.ts`
+10. `convex/epistemicEdges.ts`
+11. `convex/epistemicBeliefs.ts`
+12. `convex/epistemicQuestions.ts`
+13. `convex/epistemicEvidence.ts`
+14. `convex/lib/graphTypes.ts`
+15. `convex/lib/globalId.ts`
+
+## Canonical and compatibility contract
+
+1. Canonical implementation lives in `modules/graph-primitives/src/**`.
+2. Legacy `convex/epistemic*.ts` and `convex/lib/{graphTypes,globalId}.ts` remain compatibility surfaces until callers are migrated.
+3. New graph primitive logic must land in Lucern canonical source, not compatibility wrappers.

package/dist/beliefDecay-Q_26RTc-.d.ts

@@ -0,0 +1,72 @@
+import { DEADLINE_URGENCY, DECAY_TIERS, bayesianUpdate, computeBaseDecay, computeDeadlineUrgency, computeEffectiveDecay, getRescoringSchedule } from '@lucern/confidence';
+
+/**
+ * Belief Decay Algorithm
+ *
+ * A standalone, refinable module that governs confidence decay for ALL beliefs.
+ *
+ * Core principles:
+ *   1. All beliefs decay over time — confidence is not permanent
+ *   2. Forecast beliefs decay FASTER as their deadline approaches
+ *   3. The algorithm doesn't auto-rescore — it identifies WHEN rescoring is needed
+ *   4. Bayesian updates combine inherited confidence with new human assessments
+ *
+ * Used by:
+ *   - Cross-project discovery (adoption with decayed confidence)
+ *   - Morning briefs (surface beliefs needing rescore)
+ *   - Sprint planning (flag stale beliefs in scope)
+ *   - BI agents (automated rescore reminders)
+ *   - Confidence display (show effective vs raw confidence)
+ *
+ * @module beliefDecay
+ */
+
+/**
+ * Identify all beliefs in a project that need rescoring.
+ *
+ * Returns beliefs sorted by urgency (critical first), with their
+ * rescoring schedule and decay details.
+ *
+ * Used by:
+ *   - Morning briefs: "3 beliefs need your attention this week"
+ *   - Sprint planning: "these beliefs in scope are stale"
+ *   - BI agents: automated rescore reminders
+ *   - Project dashboard: health indicators
+ */
+declare const identifyBeliefsNeedingRescore: any;
+/**
+ * Global belief health across ALL projects for a user.
+ *
+ * Returns beliefs needing attention from every accessible project,
+ * sorted by urgency. This powers a permanent "Belief Health" section
+ * in the workspace that surfaces stale beliefs regardless of which
+ * project they belong to.
+ *
+ * Key design decision: push model, not pull. Users don't revisit
+ * completed theme project pages, so stale beliefs from finished
+ * themes only surface here, in morning briefs, and in chat.
+ */
+declare const getGlobalBeliefHealth: any;
+/**
+ * Get decay info for a single belief.
+ *
+ * Lightweight query for UI components that need to show
+ * freshness indicators on individual beliefs.
+ */
+declare const getBeliefDecayInfo: any;
+
+declare const beliefDecay_DEADLINE_URGENCY: typeof DEADLINE_URGENCY;
+declare const beliefDecay_DECAY_TIERS: typeof DECAY_TIERS;
+declare const beliefDecay_bayesianUpdate: typeof bayesianUpdate;
+declare const beliefDecay_computeBaseDecay: typeof computeBaseDecay;
+declare const beliefDecay_computeDeadlineUrgency: typeof computeDeadlineUrgency;
+declare const beliefDecay_computeEffectiveDecay: typeof computeEffectiveDecay;
+declare const beliefDecay_getBeliefDecayInfo: typeof getBeliefDecayInfo;
+declare const beliefDecay_getGlobalBeliefHealth: typeof getGlobalBeliefHealth;
+declare const beliefDecay_getRescoringSchedule: typeof getRescoringSchedule;
+declare const beliefDecay_identifyBeliefsNeedingRescore: typeof identifyBeliefsNeedingRescore;
+declare namespace beliefDecay {
+  export { beliefDecay_DEADLINE_URGENCY as DEADLINE_URGENCY, beliefDecay_DECAY_TIERS as DECAY_TIERS, beliefDecay_bayesianUpdate as bayesianUpdate, beliefDecay_computeBaseDecay as computeBaseDecay, beliefDecay_computeDeadlineUrgency as computeDeadlineUrgency, beliefDecay_computeEffectiveDecay as computeEffectiveDecay, beliefDecay_getBeliefDecayInfo as getBeliefDecayInfo, beliefDecay_getGlobalBeliefHealth as getGlobalBeliefHealth, beliefDecay_getRescoringSchedule as getRescoringSchedule, beliefDecay_identifyBeliefsNeedingRescore as identifyBeliefsNeedingRescore };
+}
+
+export { getBeliefDecayInfo as a, beliefDecay as b, getGlobalBeliefHealth as g, identifyBeliefsNeedingRescore as i };

package/dist/beliefDecay.d.ts

@@ -0,0 +1,2 @@
+export { DEADLINE_URGENCY, DECAY_TIERS, bayesianUpdate, computeBaseDecay, computeDeadlineUrgency, computeEffectiveDecay, getRescoringSchedule } from '@lucern/confidence';
+export { a as getBeliefDecayInfo, g as getGlobalBeliefHealth, i as identifyBeliefsNeedingRescore } from './beliefDecay-Q_26RTc-.js';