learngraph 0.1.0 → 0.1.1

package/README.md

@@ -1,8 +1,27 @@
-# jali
+# LearnGraph
 
-AI-powered educational knowledge graph infrastructure.
+**The world's first AI-powered learning path generator.**
 
-See the [main README](../../README.md) for full documentation.
+Transform any syllabus into personalized mastery paths with learning science built in. Every student's path to mastery, powered by decades of educational research.
+
+[![npm version](https://img.shields.io/npm/v/learngraph.svg)](https://www.npmjs.com/package/learngraph)
+[![License: MIT](https://img.shields.io/badge/License-MIT-yellow.svg)](https://opensource.org/licenses/MIT)
+
+## Why LearnGraph?
+
+**The Problem**: Traditional curricula treat all learners the same. They present content linearly, ignore prerequisite gaps, and fail to adapt to individual progress.
+
+**The Solution**: LearnGraph decomposes curricula into skill graphs, automatically identifies each learner's Zone of Proximal Development (ZPD), and generates personalized learning paths that respect cognitive load limits.
+
+### Key Features
+
+- **Zone of Proximal Development (ZPD)** - Identifies skills that are challenging but achievable
+- **Bloom's Taxonomy Integration** - Automatic detection and progression through cognitive levels
+- **Bayesian Knowledge Tracing (BKT)** - Probabilistic mastery estimation from performance data
+- **Spaced Repetition** - Optimal review scheduling based on memory science
+- **Prerequisite Mapping** - Hard, soft, and recommended dependency relationships
+- **Threshold Concepts** - Identifies transformative "gateway" skills that unlock understanding
+- **Cognitive Load Management** - Respects working memory limits in session planning
 
 ## Installation
 
@@ -13,13 +32,95 @@ npm install learngraph
 ## Quick Start
 
 ```typescript
-import { createSkillId, type SkillNode, detectBloomLevel } from 'learngraph';
+import {
+  createSkillId,
+  detectBloomLevel,
+  hasMastery,
+  type SkillNode
+} from 'learngraph';
 
 // Detect Bloom's level from a learning objective
 const level = detectBloomLevel('Calculate the derivative of a polynomial');
 console.log(level); // 'apply'
+
+// Define a skill in the knowledge graph
+const skill: SkillNode = {
+  id: createSkillId('derivatives-polynomials'),
+  name: 'Polynomial Derivatives',
+  description: 'Calculate derivatives of polynomial functions using power rule',
+  bloomLevel: 'apply',
+  difficulty: 0.4,
+  isThresholdConcept: false,
+  masteryThreshold: 0.8,
+  estimatedMinutes: 30,
+  tags: ['calculus', 'derivatives'],
+  metadata: {},
+  createdAt: new Date().toISOString(),
+  updatedAt: new Date().toISOString(),
+};
+
+// Check if learner has mastered a skill
+const mastered = hasMastery(0.85); // true (above 0.8 threshold)
+```
+
+## Educational Research Foundations
+
+LearnGraph is built on decades of peer-reviewed educational psychology research:
+
+| Framework | Purpose | Key Benefit |
+|-----------|---------|-------------|
+| **Zone of Proximal Development** | Vygotsky's theory of optimal learning challenge | Keeps learners in the "sweet spot" |
+| **Bloom's Taxonomy** | Cognitive complexity hierarchy | Ensures proper skill progression |
+| **Bayesian Knowledge Tracing** | Probabilistic mastery modeling | Accurate knowledge state estimation |
+| **Item Response Theory** | Skill difficulty calibration | Fair assessment across items |
+| **Spaced Repetition** | Memory consolidation optimization | Long-term retention |
+| **Cognitive Load Theory** | Working memory management | Prevents overwhelm |
+
+## Submodule Exports
+
+```typescript
+// Core types and utilities
+import { SkillNode, SkillEdge } from 'learngraph';
+
+// Storage adapters (Neo4j, LevelGraph)
+import { GraphStorage } from 'learngraph/storage';
+
+// LLM integration for curriculum decomposition
+import { LLMProvider } from 'learngraph/llm';
+
+// Query builders and ZPD calculation
+import { ZPDResult, LearningPath } from 'learngraph/query';
+
+// Educational utilities (Bloom's, mastery, etc.)
+import { detectBloomLevel, hasMastery } from 'learngraph/education';
 ```
 
+## Use Cases
+
+- **Intelligent Tutoring Systems (ITS)** - Build adaptive learning platforms
+- **Curriculum Decomposition** - Transform syllabi into skill graphs
+- **Learning Path Generation** - Personalized routes to mastery
+- **Prerequisite Analysis** - Identify and fill knowledge gaps
+- **Competency-Based Education** - Track and verify skill mastery
+- **Corporate Training** - Personalized upskilling programs
+
+## Author
+
+**Dr. Ernesto Lee** - Educational technologist and learning scientist
+
+- Email: dr.ernesto.lee@gmail.com
+- GitHub: [@fenago](https://github.com/fenago)
+
+## Contributing
+
+Contributions are welcome! Please see the [main repository](https://github.com/fenago/Jali) for guidelines.
+
 ## License
 
-MIT
+MIT - See [LICENSE](./LICENSE) for details.
+
+## Links
+
+- [GitHub Repository](https://github.com/fenago/Jali)
+- [Issue Tracker](https://github.com/fenago/Jali/issues)
+- [Sponsor](https://github.com/sponsors/fenago)

package/dist/cjs/index.js

@@ -53,7 +53,7 @@ __exportStar(require("./types/index.js"), exports);
 /**
  * Package version
  */
-exports.VERSION = '0.1.0';
+exports.VERSION = '0.1.1';
 /**
  * Package name
  */

package/dist/esm/index.js

@@ -36,7 +36,7 @@ export * from './types/index.js';
 /**
  * Package version
  */
-export const VERSION = '0.1.0';
+export const VERSION = '0.1.1';
 /**
  * Package name
  */

package/dist/types/index.d.ts

@@ -30,7 +30,7 @@ export * from './types/index.js';
 /**
  * Package version
  */
-export declare const VERSION = "0.1.0";
+export declare const VERSION = "0.1.1";
 /**
  * Package name
  */

package/package.json

@@ -1,14 +1,22 @@
 {
   "name": "learngraph",
-  "version": "0.1.0",
-  "description": "AI-powered educational knowledge graph infrastructure - decompose curricula into skill graphs with learning science built in",
-  "author": "LearnGraph Team",
+  "version": "0.1.1",
+  "description": "The world's first AI-powered learning path generator. Transform syllabi into personalized mastery paths with Zone of Proximal Development (ZPD), Bloom's Taxonomy, spaced repetition, and Bayesian Knowledge Tracing built in. Every student's path to mastery.",
+  "author": "Dr. Ernesto Lee <dr.ernesto.lee@gmail.com>",
   "license": "MIT",
+  "homepage": "https://github.com/fenago/Jali#readme",
+  "bugs": {
+    "url": "https://github.com/fenago/Jali/issues"
+  },
   "repository": {
     "type": "git",
-    "url": "https://github.com/fenago/Jali.git",
+    "url": "git+https://github.com/fenago/Jali.git",
     "directory": "packages/core"
   },
+  "funding": {
+    "type": "github",
+    "url": "https://github.com/sponsors/fenago"
+  },
   "keywords": [
     "education",
     "knowledge-graph",
@@ -20,9 +28,26 @@
     "llm",
     "mastery-learning",
     "zpd",
+    "zone-of-proximal-development",
     "blooms-taxonomy",
     "adaptive-learning",
-    "edtech"
+    "edtech",
+    "intelligent-tutoring-system",
+    "its",
+    "bayesian-knowledge-tracing",
+    "bkt",
+    "item-response-theory",
+    "irt",
+    "spaced-repetition",
+    "cognitive-load-theory",
+    "personalized-learning",
+    "learning-path",
+    "skill-graph",
+    "prerequisite-mapping",
+    "educational-psychology",
+    "learning-science",
+    "curriculum-decomposition",
+    "mastery-threshold"
   ],
   "type": "module",
   "main": "./dist/cjs/index.js",