learngraph 0.1.1 → 0.3.0

package/dist/types/storage/seeds.d.ts

@@ -0,0 +1,27 @@
+/**
+ * Sample educational graphs for testing and demos
+ *
+ * @packageDocumentation
+ */
+import type { SkillNodeInput, PrerequisiteEdgeInput, GraphStorage, ImportResult } from '../types/index.js';
+/**
+ * Sample fractions curriculum (elementary math)
+ */
+export declare const FRACTIONS_CURRICULUM: {
+    nodes: SkillNodeInput[];
+    edges: PrerequisiteEdgeInput[];
+};
+/**
+ * Sample programming fundamentals curriculum
+ */
+export declare const PROGRAMMING_CURRICULUM: {
+    nodes: SkillNodeInput[];
+    edges: PrerequisiteEdgeInput[];
+};
+/**
+ * Seed a storage instance with sample data
+ */
+export declare function seedStorage(storage: GraphStorage, curriculum?: 'fractions' | 'programming' | 'all', options?: {
+    clearExisting?: boolean;
+}): Promise<ImportResult>;
+//# sourceMappingURL=seeds.d.ts.map

package/dist/types/storage/seeds.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"seeds.d.ts","sourceRoot":"","sources":["../../../src/storage/seeds.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH,OAAO,KAAK,EACV,cAAc,EACd,qBAAqB,EACrB,YAAY,EACZ,YAAY,EACb,MAAM,mBAAmB,CAAC;AAG3B;;GAEG;AACH,eAAO,MAAM,oBAAoB,EAAE;IACjC,KAAK,EAAE,cAAc,EAAE,CAAC;IACxB,KAAK,EAAE,qBAAqB,EAAE,CAAC;CAoThC,CAAC;AAEF;;GAEG;AACH,eAAO,MAAM,sBAAsB,EAAE;IACnC,KAAK,EAAE,cAAc,EAAE,CAAC;IACxB,KAAK,EAAE,qBAAqB,EAAE,CAAC;CA6MhC,CAAC;AAEF;;GAEG;AACH,wBAAsB,WAAW,CAC/B,OAAO,EAAE,YAAY,EACrB,UAAU,GAAE,WAAW,GAAG,aAAa,GAAG,KAAa,EACvD,OAAO,CAAC,EAAE;IAAE,aAAa,CAAC,EAAE,OAAO,CAAA;CAAE,GACpC,OAAO,CAAC,YAAY,CAAC,CA0CvB"}

package/dist/types/types/index.d.ts

@@ -15,4 +15,6 @@ export type { Subgraph, GraphExport, GraphStats, GraphValidation, GraphValidatio
 export { GRAPH_VERSION } from './graph.js';
 export type { QueryOperator, QueryFilter, QuerySort, QueryPagination, SkillQuery, ZPDResult, LearningPath, LearningSession, ReviewSchedule, ReviewItem, ZPDOptions, PathOptions, ReviewOptions, } from './query.js';
 export type { StorageBackend, StorageConfigBase, Neo4jConfig, LevelGraphConfig, MemoryConfig, StorageConfig, ConnectionStatus, ImportResult, GraphStorage, StorageFactory, } from './storage.js';
+export type { ParseFormat, DocumentMetadata, LearningObjective, Topic, Module, ParseResult, ParseWarning, ParseStats, ExtractedSkill, SkillExtractionResult, ParseOptions, ExtractionOptions, Parser, SkillExtractor, } from './parser.js';
+export type { LLMProvider, LLMConfig, OpenAIConfig, AnthropicConfig, OllamaConfig, MessageRole, ChatMessage, CompletionRequest, CompletionResponse, SkillExtractionRequest, ExtractedSkillLLM, SkillExtractionResponse, PrerequisiteInferenceRequest, InferredPrerequisite, PrerequisiteInferenceResponse, BloomAnalysisRequest, BloomAnalysisResponse, DecompositionRequest, DecompositionResponse, LLMAdapter, LLMOrchestrator, } from './llm.js';
 //# sourceMappingURL=index.d.ts.map

package/dist/types/types/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/types/index.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAKH,YAAY,EAAE,UAAU,EAAE,MAAM,YAAY,CAAC;AAC7C,OAAO,EACL,iBAAiB,EACjB,WAAW,EACX,gBAAgB,EAChB,kBAAkB,EAClB,mBAAmB,GACpB,MAAM,YAAY,CAAC;AAKpB,YAAY,EAAE,OAAO,EAAE,SAAS,EAAE,cAAc,EAAE,eAAe,EAAE,MAAM,YAAY,CAAC;AACtF,OAAO,EACL,aAAa,EACb,cAAc,EACd,yBAAyB,EACzB,iBAAiB,EACjB,uBAAuB,GACxB,MAAM,YAAY,CAAC;AAKpB,YAAY,EAAE,MAAM,EAAE,QAAQ,EAAE,gBAAgB,EAAE,qBAAqB,EAAE,MAAM,WAAW,CAAC;AAC3F,OAAO,EACL,YAAY,EACZ,wBAAwB,EACxB,mBAAmB,EACnB,eAAe,GAChB,MAAM,WAAW,CAAC;AAKnB,YAAY,EAAE,YAAY,EAAE,cAAc,EAAE,iBAAiB,EAAE,MAAM,cAAc,CAAC;AACpF,OAAO,EAAE,kBAAkB,EAAE,UAAU,EAAE,UAAU,EAAE,MAAM,cAAc,CAAC;AAK1E,YAAY,EACV,QAAQ,EACR,WAAW,EACX,UAAU,EACV,eAAe,EACf,oBAAoB,EACpB,sBAAsB,GACvB,MAAM,YAAY,CAAC;AACpB,OAAO,EAAE,aAAa,EAAE,MAAM,YAAY,CAAC;AAK3C,YAAY,EACV,aAAa,EACb,WAAW,EACX,SAAS,EACT,eAAe,EACf,UAAU,EACV,SAAS,EACT,YAAY,EACZ,eAAe,EACf,cAAc,EACd,UAAU,EACV,UAAU,EACV,WAAW,EACX,aAAa,GACd,MAAM,YAAY,CAAC;AAKpB,YAAY,EACV,cAAc,EACd,iBAAiB,EACjB,WAAW,EACX,gBAAgB,EAChB,YAAY,EACZ,aAAa,EACb,gBAAgB,EAChB,YAAY,EACZ,YAAY,EACZ,cAAc,GACf,MAAM,cAAc,CAAC"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/types/index.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAKH,YAAY,EAAE,UAAU,EAAE,MAAM,YAAY,CAAC;AAC7C,OAAO,EACL,iBAAiB,EACjB,WAAW,EACX,gBAAgB,EAChB,kBAAkB,EAClB,mBAAmB,GACpB,MAAM,YAAY,CAAC;AAKpB,YAAY,EAAE,OAAO,EAAE,SAAS,EAAE,cAAc,EAAE,eAAe,EAAE,MAAM,YAAY,CAAC;AACtF,OAAO,EACL,aAAa,EACb,cAAc,EACd,yBAAyB,EACzB,iBAAiB,EACjB,uBAAuB,GACxB,MAAM,YAAY,CAAC;AAKpB,YAAY,EAAE,MAAM,EAAE,QAAQ,EAAE,gBAAgB,EAAE,qBAAqB,EAAE,MAAM,WAAW,CAAC;AAC3F,OAAO,EACL,YAAY,EACZ,wBAAwB,EACxB,mBAAmB,EACnB,eAAe,GAChB,MAAM,WAAW,CAAC;AAKnB,YAAY,EAAE,YAAY,EAAE,cAAc,EAAE,iBAAiB,EAAE,MAAM,cAAc,CAAC;AACpF,OAAO,EAAE,kBAAkB,EAAE,UAAU,EAAE,UAAU,EAAE,MAAM,cAAc,CAAC;AAK1E,YAAY,EACV,QAAQ,EACR,WAAW,EACX,UAAU,EACV,eAAe,EACf,oBAAoB,EACpB,sBAAsB,GACvB,MAAM,YAAY,CAAC;AACpB,OAAO,EAAE,aAAa,EAAE,MAAM,YAAY,CAAC;AAK3C,YAAY,EACV,aAAa,EACb,WAAW,EACX,SAAS,EACT,eAAe,EACf,UAAU,EACV,SAAS,EACT,YAAY,EACZ,eAAe,EACf,cAAc,EACd,UAAU,EACV,UAAU,EACV,WAAW,EACX,aAAa,GACd,MAAM,YAAY,CAAC;AAKpB,YAAY,EACV,cAAc,EACd,iBAAiB,EACjB,WAAW,EACX,gBAAgB,EAChB,YAAY,EACZ,aAAa,EACb,gBAAgB,EAChB,YAAY,EACZ,YAAY,EACZ,cAAc,GACf,MAAM,cAAc,CAAC;AAKtB,YAAY,EACV,WAAW,EACX,gBAAgB,EAChB,iBAAiB,EACjB,KAAK,EACL,MAAM,EACN,WAAW,EACX,YAAY,EACZ,UAAU,EACV,cAAc,EACd,qBAAqB,EACrB,YAAY,EACZ,iBAAiB,EACjB,MAAM,EACN,cAAc,GACf,MAAM,aAAa,CAAC;AAKrB,YAAY,EACV,WAAW,EACX,SAAS,EACT,YAAY,EACZ,eAAe,EACf,YAAY,EACZ,WAAW,EACX,WAAW,EACX,iBAAiB,EACjB,kBAAkB,EAClB,sBAAsB,EACtB,iBAAiB,EACjB,uBAAuB,EACvB,4BAA4B,EAC5B,oBAAoB,EACpB,6BAA6B,EAC7B,oBAAoB,EACpB,qBAAqB,EACrB,oBAAoB,EACpB,qBAAqB,EACrB,UAAU,EACV,eAAe,GAChB,MAAM,UAAU,CAAC"}

package/dist/types/types/llm.d.ts

@@ -0,0 +1,298 @@
+/**
+ * LLM provider types for skill extraction and prerequisite inference
+ *
+ * @packageDocumentation
+ */
+import type { BloomLevel } from './bloom.js';
+import type { SkillNodeInput } from './skill.js';
+/**
+ * Supported LLM providers
+ */
+export type LLMProvider = 'openai' | 'anthropic' | 'ollama' | 'custom';
+/**
+ * Base configuration for all LLM providers
+ */
+export interface LLMConfig {
+    /** Provider type */
+    provider: LLMProvider;
+    /** Model identifier (e.g., 'gpt-4o', 'claude-3-5-sonnet-20241022', 'llama3.2') */
+    model: string;
+    /** API key (not needed for Ollama) */
+    apiKey?: string;
+    /** Base URL for API (optional, for custom endpoints) */
+    baseUrl?: string;
+    /** Maximum tokens to generate */
+    maxTokens?: number;
+    /** Temperature for generation (0-1) */
+    temperature?: number;
+    /** Request timeout in milliseconds */
+    timeout?: number;
+    /** Number of retries on failure */
+    retries?: number;
+}
+/**
+ * OpenAI-specific configuration
+ */
+export interface OpenAIConfig extends LLMConfig {
+    provider: 'openai';
+    /** Organization ID (optional) */
+    organization?: string;
+}
+/**
+ * Anthropic-specific configuration
+ */
+export interface AnthropicConfig extends LLMConfig {
+    provider: 'anthropic';
+}
+/**
+ * Ollama-specific configuration (local models)
+ */
+export interface OllamaConfig extends LLMConfig {
+    provider: 'ollama';
+    /** Default: http://localhost:11434 */
+    baseUrl?: string;
+}
+/**
+ * Message role in conversation
+ */
+export type MessageRole = 'system' | 'user' | 'assistant';
+/**
+ * Chat message
+ */
+export interface ChatMessage {
+    role: MessageRole;
+    content: string;
+}
+/**
+ * LLM completion request
+ */
+export interface CompletionRequest {
+    /** Messages for chat completion */
+    messages: ChatMessage[];
+    /** Override temperature for this request */
+    temperature?: number;
+    /** Override max tokens for this request */
+    maxTokens?: number;
+    /** Response format (for structured output) */
+    responseFormat?: 'text' | 'json';
+    /** JSON schema for structured output (if responseFormat is 'json') */
+    jsonSchema?: Record<string, unknown>;
+}
+/**
+ * LLM completion response
+ */
+export interface CompletionResponse {
+    /** Generated text content */
+    content: string;
+    /** Parsed JSON (if responseFormat was 'json') */
+    json?: unknown;
+    /** Token usage statistics */
+    usage: {
+        promptTokens: number;
+        completionTokens: number;
+        totalTokens: number;
+    };
+    /** Model used for completion */
+    model: string;
+    /** Finish reason */
+    finishReason: 'stop' | 'length' | 'content_filter' | 'error';
+}
+/**
+ * Request to extract skills from curriculum content
+ */
+export interface SkillExtractionRequest {
+    /** Raw curriculum/syllabus content */
+    content: string;
+    /** Content format hint */
+    format?: 'markdown' | 'text' | 'html' | 'pdf';
+    /** Domain/subject area hint */
+    domain?: string;
+    /** Target audience/grade level */
+    gradeLevel?: string;
+    /** Additional context for extraction */
+    context?: string;
+    /** Tags to apply to all extracted skills */
+    tags?: string[];
+    /** Minimum confidence threshold (0-1) */
+    minConfidence?: number;
+}
+/**
+ * LLM-extracted skill with metadata
+ */
+export interface ExtractedSkillLLM {
+    /** Skill name (concise) */
+    name: string;
+    /** Skill description */
+    description: string;
+    /** Detected Bloom's level */
+    bloomLevel: BloomLevel;
+    /** Difficulty estimate (0-1) */
+    difficulty: number;
+    /** Confidence in extraction (0-1) */
+    confidence: number;
+    /** Whether this is a threshold concept */
+    isThresholdConcept: boolean;
+    /** Estimated time to master in minutes */
+    estimatedMinutes?: number;
+    /** Source text that generated this skill */
+    sourceText?: string;
+    /** LLM's reasoning for this extraction */
+    reasoning?: string;
+    /** Keywords/concepts associated with this skill */
+    keywords?: string[];
+}
+/**
+ * Result of skill extraction
+ */
+export interface SkillExtractionResponse {
+    /** Extracted skills */
+    skills: ExtractedSkillLLM[];
+    /** Overall extraction confidence */
+    confidence: number;
+    /** Token usage */
+    usage: CompletionResponse['usage'];
+    /** Warnings or notes from extraction */
+    warnings: string[];
+    /** Processing time in milliseconds */
+    durationMs: number;
+}
+/**
+ * Request to infer prerequisites between skills
+ */
+export interface PrerequisiteInferenceRequest {
+    /** Skills to analyze for prerequisites */
+    skills: Array<{
+        id: string;
+        name: string;
+        description: string;
+        bloomLevel: BloomLevel;
+        difficulty: number;
+    }>;
+    /** Domain context */
+    domain?: string;
+    /** Whether to infer transitive prerequisites */
+    inferTransitive?: boolean;
+    /** Minimum confidence for edge suggestion */
+    minConfidence?: number;
+}
+/**
+ * Inferred prerequisite relationship
+ */
+export interface InferredPrerequisite {
+    /** Source skill ID (the prerequisite) */
+    sourceId: string;
+    /** Target skill ID (depends on source) */
+    targetId: string;
+    /** Relationship strength (0-1) */
+    strength: number;
+    /** Type of prerequisite */
+    type: 'hard' | 'soft' | 'recommended';
+    /** Confidence in this inference (0-1) */
+    confidence: number;
+    /** LLM's reasoning for this relationship */
+    reasoning: string;
+}
+/**
+ * Result of prerequisite inference
+ */
+export interface PrerequisiteInferenceResponse {
+    /** Inferred prerequisites */
+    prerequisites: InferredPrerequisite[];
+    /** Token usage */
+    usage: CompletionResponse['usage'];
+    /** Processing time in milliseconds */
+    durationMs: number;
+}
+/**
+ * Request to analyze Bloom's level of text
+ */
+export interface BloomAnalysisRequest {
+    /** Text to analyze */
+    text: string;
+    /** Context for analysis */
+    context?: string;
+}
+/**
+ * Result of Bloom's level analysis
+ */
+export interface BloomAnalysisResponse {
+    /** Detected Bloom's level */
+    level: BloomLevel;
+    /** Confidence in detection (0-1) */
+    confidence: number;
+    /** Key verbs/phrases that indicated this level */
+    indicators: string[];
+    /** LLM's reasoning */
+    reasoning: string;
+    /** Token usage */
+    usage: CompletionResponse['usage'];
+}
+/**
+ * Request to decompose curriculum into a skill graph
+ */
+export interface DecompositionRequest {
+    /** Curriculum content */
+    content: string;
+    /** Title of the course/curriculum */
+    title?: string;
+    /** Domain/subject */
+    domain?: string;
+    /** Target grade level */
+    gradeLevel?: string;
+    /** Additional context */
+    context?: string;
+    /** Maximum depth of skill hierarchy */
+    maxDepth?: number;
+    /** Whether to infer prerequisites */
+    inferPrerequisites?: boolean;
+}
+/**
+ * Result of curriculum decomposition
+ */
+export interface DecompositionResponse {
+    /** Course/curriculum title */
+    title: string;
+    /** Extracted skills */
+    skills: ExtractedSkillLLM[];
+    /** Inferred prerequisites (if requested) */
+    prerequisites: InferredPrerequisite[];
+    /** Skill inputs ready for storage */
+    skillInputs: SkillNodeInput[];
+    /** Token usage */
+    usage: CompletionResponse['usage'];
+    /** Processing time in milliseconds */
+    durationMs: number;
+    /** Warnings from processing */
+    warnings: string[];
+}
+/**
+ * LLM adapter interface for different providers
+ */
+export interface LLMAdapter {
+    /** Provider name */
+    readonly provider: LLMProvider;
+    /** Model identifier */
+    readonly model: string;
+    /** Send a completion request */
+    complete(request: CompletionRequest): Promise<CompletionResponse>;
+    /** Check if the adapter is properly configured */
+    isConfigured(): boolean;
+    /** Get current configuration (without sensitive data) */
+    getConfig(): Omit<LLMConfig, 'apiKey'>;
+}
+/**
+ * High-level LLM orchestrator for educational tasks
+ */
+export interface LLMOrchestrator {
+    /** Extract skills from curriculum content */
+    extractSkills(request: SkillExtractionRequest): Promise<SkillExtractionResponse>;
+    /** Infer prerequisites between skills */
+    inferPrerequisites(request: PrerequisiteInferenceRequest): Promise<PrerequisiteInferenceResponse>;
+    /** Analyze Bloom's level of text */
+    analyzeBloomLevel(request: BloomAnalysisRequest): Promise<BloomAnalysisResponse>;
+    /** Full curriculum decomposition */
+    decompose(request: DecompositionRequest): Promise<DecompositionResponse>;
+    /** Get the underlying adapter */
+    getAdapter(): LLMAdapter;
+}
+//# sourceMappingURL=llm.d.ts.map

package/dist/types/types/llm.d.ts.map

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

package/dist/types/types/parser.d.ts

@@ -0,0 +1,208 @@
+/**
+ * Parser types for syllabus and curriculum parsing
+ *
+ * @packageDocumentation
+ */
+import type { BloomLevel } from './bloom.js';
+import type { SkillNodeInput } from './skill.js';
+/**
+ * Supported input formats for parsing
+ */
+export type ParseFormat = 'markdown' | 'json' | 'yaml' | 'pdf' | 'text';
+/**
+ * Source document metadata
+ */
+export interface DocumentMetadata {
+    /** Original filename or URL */
+    source: string;
+    /** Document format */
+    format: ParseFormat;
+    /** Document title if detected */
+    title?: string;
+    /** Course or subject name */
+    course?: string;
+    /** Institution name */
+    institution?: string;
+    /** Grade level or audience */
+    gradeLevel?: string;
+    /** Parse timestamp */
+    parsedAt: string;
+    /** Additional metadata */
+    custom?: Record<string, unknown>;
+}
+/**
+ * A learning objective extracted from a syllabus
+ */
+export interface LearningObjective {
+    /** Original text of the objective */
+    text: string;
+    /** Detected Bloom's level (null if not detected) */
+    bloomLevel: BloomLevel | null;
+    /** Confidence score for Bloom's detection (0-1) */
+    bloomConfidence: number;
+    /** Chapter or section this belongs to */
+    section?: string;
+    /** Week or unit number */
+    week?: number;
+    /** Suggested skill name derived from objective */
+    suggestedName?: string;
+}
+/**
+ * A topic or concept extracted from a syllabus
+ */
+export interface Topic {
+    /** Topic name */
+    name: string;
+    /** Description if available */
+    description?: string;
+    /** Parent topic (for hierarchical structures) */
+    parent?: string;
+    /** Week or unit number */
+    week?: number;
+    /** Associated learning objectives */
+    objectives: LearningObjective[];
+    /** Estimated time in minutes */
+    estimatedMinutes?: number;
+}
+/**
+ * A module or chapter extracted from a syllabus
+ */
+export interface Module {
+    /** Module/chapter number or ID */
+    id: string;
+    /** Module title */
+    title: string;
+    /** Description or summary */
+    description?: string;
+    /** Week number (for weekly syllabi) */
+    week?: number;
+    /** Topics covered in this module */
+    topics: Topic[];
+    /** Direct learning objectives (not under topics) */
+    objectives: LearningObjective[];
+    /** Estimated duration in minutes */
+    estimatedMinutes?: number;
+}
+/**
+ * Result of parsing a syllabus document
+ */
+export interface ParseResult {
+    /** Document metadata */
+    metadata: DocumentMetadata;
+    /** Extracted modules/chapters */
+    modules: Module[];
+    /** Standalone topics (not in modules) */
+    topics: Topic[];
+    /** Standalone objectives (not in topics) */
+    objectives: LearningObjective[];
+    /** Parse warnings (non-fatal issues) */
+    warnings: ParseWarning[];
+    /** Parse statistics */
+    stats: ParseStats;
+}
+/**
+ * Warning generated during parsing
+ */
+export interface ParseWarning {
+    /** Warning type */
+    type: 'ambiguous_bloom' | 'missing_objective' | 'unclear_structure' | 'unknown';
+    /** Warning message */
+    message: string;
+    /** Line number or location (if applicable) */
+    location?: string;
+}
+/**
+ * Statistics about the parse operation
+ */
+export interface ParseStats {
+    /** Total modules found */
+    moduleCount: number;
+    /** Total topics found */
+    topicCount: number;
+    /** Total learning objectives found */
+    objectiveCount: number;
+    /** Objectives with detected Bloom's level */
+    bloomDetectedCount: number;
+    /** Parse duration in milliseconds */
+    durationMs: number;
+}
+/**
+ * An extracted skill ready for graph creation
+ */
+export interface ExtractedSkill {
+    /** Suggested skill input (ready for storage) */
+    skill: SkillNodeInput;
+    /** Source objective or topic */
+    source: LearningObjective | Topic;
+    /** Extraction confidence (0-1) */
+    confidence: number;
+    /** Suggested prerequisites (names, not IDs yet) */
+    suggestedPrerequisites?: string[];
+}
+/**
+ * Result of extracting skills from parsed content
+ */
+export interface SkillExtractionResult {
+    /** Extracted skills */
+    skills: ExtractedSkill[];
+    /** Suggested prerequisite relationships */
+    suggestedEdges: Array<{
+        sourceName: string;
+        targetName: string;
+        strength: number;
+        reasoning?: string;
+    }>;
+    /** Extraction warnings */
+    warnings: ParseWarning[];
+}
+/**
+ * Options for parsing operations
+ */
+export interface ParseOptions {
+    /** Attempt to detect Bloom's levels */
+    detectBloom?: boolean;
+    /** Extract time estimates */
+    extractTime?: boolean;
+    /** Suggest skill names from objectives */
+    suggestNames?: boolean;
+    /** Include raw text in output */
+    includeRaw?: boolean;
+    /** Custom section headers to recognize */
+    sectionHeaders?: string[];
+    /** Custom objective markers (e.g., "LO:", "Students will be able to:") */
+    objectiveMarkers?: string[];
+}
+/**
+ * Options for skill extraction
+ */
+export interface ExtractionOptions extends ParseOptions {
+    /** Default difficulty for extracted skills */
+    defaultDifficulty?: number;
+    /** Default mastery threshold */
+    defaultMasteryThreshold?: number;
+    /** Default estimated minutes */
+    defaultEstimatedMinutes?: number;
+    /** Tags to apply to all extracted skills */
+    tags?: string[];
+    /** Domain to apply to all extracted skills */
+    domain?: string;
+    /** Grade level to apply */
+    gradeLevel?: string;
+}
+/**
+ * Base parser interface
+ */
+export interface Parser {
+    /** Parse content from a string */
+    parse(content: string, options?: ParseOptions): Promise<ParseResult>;
+    /** Get supported format */
+    format: ParseFormat;
+}
+/**
+ * Skill extractor interface (can use LLM)
+ */
+export interface SkillExtractor {
+    /** Extract skills from parse result */
+    extract(parseResult: ParseResult, options?: ExtractionOptions): Promise<SkillExtractionResult>;
+}
+//# sourceMappingURL=parser.d.ts.map

package/dist/types/types/parser.d.ts.map

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

package/package.json

@@ -1,9 +1,9 @@
 {
   "name": "learngraph",
-  "version": "0.1.1",
+  "version": "0.3.0",
   "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",
+  "license": "Apache-2.0",
   "homepage": "https://github.com/fenago/Jali#readme",
   "bugs": {
     "url": "https://github.com/fenago/Jali/issues"
@@ -127,10 +127,12 @@
   },
   "files": [
     "dist",
+    "scripts",
     "README.md",
     "LICENSE"
   ],
   "scripts": {
+    "postinstall": "node scripts/postinstall.js || true",
     "build": "npm run build:esm && npm run build:cjs && npm run build:types",
     "build:esm": "tsc -p tsconfig.esm.json",
     "build:cjs": "tsc -p tsconfig.cjs.json",

package/scripts/postinstall.js

@@ -0,0 +1,68 @@
+#!/usr/bin/env node
+
+/**
+ * LearnGraph Post-Install Script
+ * Displays welcome message with quick start guide
+ */
+
+const CYAN = '\x1b[36m';
+const YELLOW = '\x1b[33m';
+const GREEN = '\x1b[32m';
+const MAGENTA = '\x1b[35m';
+const WHITE = '\x1b[37m';
+const BOLD = '\x1b[1m';
+const DIM = '\x1b[2m';
+const RESET = '\x1b[0m';
+
+const ascii = `
+${CYAN}${BOLD}
+    ╦  ╔═╗╔═╗╦═╗╔╗╔  ╔═╗╦═╗╔═╗╔═╗╦ ╦
+    ║  ║╣ ╠═╣╠╦╝║║║  ║ ╦╠╦╝╠═╣╠═╝╠═╣
+    ╩═╝╚═╝╩ ╩╩╚═╝╚╝  ╚═╝╩╚═╩ ╩╩  ╩ ╩
+${RESET}
+${YELLOW}    ━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━${RESET}
+${WHITE}${BOLD}    AI-Powered Learning Path Generator${RESET}
+${YELLOW}    ━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━${RESET}
+
+${DIM}    Transform syllabi into personalized mastery paths${RESET}
+${DIM}    with ZPD, Bloom's Taxonomy & Knowledge Tracing${RESET}
+
+${MAGENTA}${BOLD}    Created by Dr. Ernesto Lee${RESET}
+${CYAN}    https://DrLee.ai${RESET}
+
+${GREEN}${BOLD}  Quick Start${RESET}
+${GREEN}  ───────────${RESET}
+
+${WHITE}  // In-memory storage (great for testing)${RESET}
+${DIM}  import { MemoryStorage } from 'learngraph/storage';
+
+  const storage = new MemoryStorage();
+  await storage.connect({ backend: 'memory' });
+
+  const skill = await storage.createSkill({
+    name: 'Add Fractions',
+    description: 'Add fractions with like denominators',
+    bloomLevel: 'apply',
+    difficulty: 0.4,
+    isThresholdConcept: false,
+    masteryThreshold: 0.8,
+    estimatedMinutes: 30,
+    tags: ['math', 'fractions'],
+    metadata: {}
+  });${RESET}
+
+${GREEN}${BOLD}  Storage Backends${RESET}
+${GREEN}  ────────────────${RESET}
+
+${WHITE}  Memory${RESET}    ${DIM}Built-in, zero config${RESET}
+${WHITE}  LevelGraph${RESET} ${DIM}npm install level levelgraph${RESET}
+${WHITE}  Neo4j${RESET}     ${DIM}npm install neo4j-driver${RESET}
+
+${YELLOW}  Docs:${RESET}     ${CYAN}https://github.com/fenago/Jali${RESET}
+${YELLOW}  Issues:${RESET}   ${CYAN}https://github.com/fenago/Jali/issues${RESET}
+
+${GREEN}${BOLD}  Thank you for using LearnGraph!${RESET}
+
+`;
+
+console.log(ascii);