learngraph 0.1.1 → 0.2.0

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

@@ -0,0 +1,70 @@
+/**
+ * In-memory storage adapter for testing and prototyping
+ *
+ * @packageDocumentation
+ */
+import type { SkillNode, SkillId, SkillNodeInput, SkillNodeUpdate, PrerequisiteEdge, EdgeId, PrerequisiteEdgeInput, GraphStorage, StorageConfig, ConnectionStatus, ImportResult, GraphExport, GraphStats, Subgraph, SkillQuery } from '../types/index.js';
+/**
+ * In-memory graph storage adapter.
+ *
+ * Stores all data in memory - lost on process exit.
+ * Ideal for unit tests and rapid prototyping.
+ *
+ * @example
+ * ```typescript
+ * 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: {},
+ * });
+ *
+ * console.log(skill.id); // skill_abc123...
+ * ```
+ */
+export declare class MemoryStorage implements GraphStorage {
+    private nodes;
+    private edges;
+    private _connected;
+    connect(config: StorageConfig): Promise<void>;
+    disconnect(): Promise<void>;
+    isConnected(): boolean;
+    getStatus(): Promise<ConnectionStatus>;
+    createSkill(input: SkillNodeInput): Promise<SkillNode>;
+    getSkill(id: SkillId): Promise<SkillNode | null>;
+    getSkills(ids: SkillId[]): Promise<SkillNode[]>;
+    updateSkill(id: SkillId, updates: SkillNodeUpdate): Promise<SkillNode>;
+    deleteSkill(id: SkillId): Promise<void>;
+    findSkills(query: Partial<SkillQuery>): Promise<SkillNode[]>;
+    countSkills(query?: Partial<SkillQuery>): Promise<number>;
+    createPrerequisite(input: PrerequisiteEdgeInput): Promise<PrerequisiteEdge>;
+    getPrerequisite(id: EdgeId): Promise<PrerequisiteEdge | null>;
+    deletePrerequisite(id: EdgeId): Promise<void>;
+    findPrerequisites(criteria: {
+        sourceId?: SkillId;
+        targetId?: SkillId;
+        type?: string;
+        minStrength?: number;
+    }): Promise<PrerequisiteEdge[]>;
+    getPrerequisitesOf(skillId: SkillId): Promise<SkillNode[]>;
+    getDependentsOf(skillId: SkillId): Promise<SkillNode[]>;
+    getSubgraph(rootId: SkillId, depth: number): Promise<Subgraph>;
+    getRootSkills(): Promise<SkillNode[]>;
+    getLeafSkills(): Promise<SkillNode[]>;
+    getPath(fromId: SkillId, toId: SkillId): Promise<SkillNode[] | null>;
+    importGraph(nodes: SkillNodeInput[], edges: PrerequisiteEdgeInput[], options?: {
+        clearExisting?: boolean;
+    }): Promise<ImportResult>;
+    exportGraph(): Promise<GraphExport>;
+    clearAll(): Promise<void>;
+    getStats(): Promise<GraphStats>;
+}
+//# sourceMappingURL=memory.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"memory.d.ts","sourceRoot":"","sources":["../../../src/storage/memory.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH,OAAO,KAAK,EACV,SAAS,EACT,OAAO,EACP,cAAc,EACd,eAAe,EACf,gBAAgB,EAChB,MAAM,EACN,qBAAqB,EACrB,YAAY,EACZ,aAAa,EAEb,gBAAgB,EAChB,YAAY,EACZ,WAAW,EACX,UAAU,EACV,QAAQ,EACR,UAAU,EACX,MAAM,mBAAmB,CAAC;AAiB3B;;;;;;;;;;;;;;;;;;;;;;;;;GAyBG;AACH,qBAAa,aAAc,YAAW,YAAY;IAChD,OAAO,CAAC,KAAK,CAAqC;IAClD,OAAO,CAAC,KAAK,CAA4C;IACzD,OAAO,CAAC,UAAU,CAAS;IAMrB,OAAO,CAAC,MAAM,EAAE,aAAa,GAAG,OAAO,CAAC,IAAI,CAAC;IAmB7C,UAAU,IAAI,OAAO,CAAC,IAAI,CAAC;IAMjC,WAAW,IAAI,OAAO;IAIhB,SAAS,IAAI,OAAO,CAAC,gBAAgB,CAAC;IAatC,WAAW,CAAC,KAAK,EAAE,cAAc,GAAG,OAAO,CAAC,SAAS,CAAC;IActD,QAAQ,CAAC,EAAE,EAAE,OAAO,GAAG,OAAO,CAAC,SAAS,GAAG,IAAI,CAAC;IAKhD,SAAS,CAAC,GAAG,EAAE,OAAO,EAAE,GAAG,OAAO,CAAC,SAAS,EAAE,CAAC;IAU/C,WAAW,CAAC,EAAE,EAAE,OAAO,EAAE,OAAO,EAAE,eAAe,GAAG,OAAO,CAAC,SAAS,CAAC;IAoBtE,WAAW,CAAC,EAAE,EAAE,OAAO,GAAG,OAAO,CAAC,IAAI,CAAC;IAcvC,UAAU,CAAC,KAAK,EAAE,OAAO,CAAC,UAAU,CAAC,GAAG,OAAO,CAAC,SAAS,EAAE,CAAC;IAiE5D,WAAW,CAAC,KAAK,CAAC,EAAE,OAAO,CAAC,UAAU,CAAC,GAAG,OAAO,CAAC,MAAM,CAAC;IAiBzD,kBAAkB,CAAC,KAAK,EAAE,qBAAqB,GAAG,OAAO,CAAC,gBAAgB,CAAC;IA8B3E,eAAe,CAAC,EAAE,EAAE,MAAM,GAAG,OAAO,CAAC,gBAAgB,GAAG,IAAI,CAAC;IAK7D,kBAAkB,CAAC,EAAE,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC;IAK7C,iBAAiB,CAAC,QAAQ,EAAE;QAChC,QAAQ,CAAC,EAAE,OAAO,CAAC;QACnB,QAAQ,CAAC,EAAE,OAAO,CAAC;QACnB,IAAI,CAAC,EAAE,MAAM,CAAC;QACd,WAAW,CAAC,EAAE,MAAM,CAAC;KACtB,GAAG,OAAO,CAAC,gBAAgB,EAAE,CAAC;IAyBzB,kBAAkB,CAAC,OAAO,EAAE,OAAO,GAAG,OAAO,CAAC,SAAS,EAAE,CAAC;IAa1D,eAAe,CAAC,OAAO,EAAE,OAAO,GAAG,OAAO,CAAC,SAAS,EAAE,CAAC;IAavD,WAAW,CAAC,MAAM,EAAE,OAAO,EAAE,KAAK,EAAE,MAAM,GAAG,OAAO,CAAC,QAAQ,CAAC;IA+C9D,aAAa,IAAI,OAAO,CAAC,SAAS,EAAE,CAAC;IAarC,aAAa,IAAI,OAAO,CAAC,SAAS,EAAE,CAAC;IAarC,OAAO,CAAC,MAAM,EAAE,OAAO,EAAE,IAAI,EAAE,OAAO,GAAG,OAAO,CAAC,SAAS,EAAE,GAAG,IAAI,CAAC;IA+CpE,WAAW,CACf,KAAK,EAAE,cAAc,EAAE,EACvB,KAAK,EAAE,qBAAqB,EAAE,EAC9B,OAAO,CAAC,EAAE;QAAE,aAAa,CAAC,EAAE,OAAO,CAAA;KAAE,GACpC,OAAO,CAAC,YAAY,CAAC;IAoElB,WAAW,IAAI,OAAO,CAAC,WAAW,CAAC;IAWnC,QAAQ,IAAI,OAAO,CAAC,IAAI,CAAC;IAUzB,QAAQ,IAAI,OAAO,CAAC,UAAU,CAAC;CAOtC"}

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

@@ -0,0 +1,88 @@
+/**
+ * Neo4j storage adapter
+ *
+ * Production-ready graph storage using Neo4j graph database
+ * with full Cypher query support and connection pooling.
+ *
+ * @packageDocumentation
+ */
+import type { SkillNode, SkillId, SkillNodeInput, SkillNodeUpdate, PrerequisiteEdge, EdgeId, PrerequisiteEdgeInput, GraphStorage, StorageConfig, ConnectionStatus, ImportResult, GraphExport, GraphStats, Subgraph, SkillQuery } from '../types/index.js';
+/**
+ * Neo4j storage adapter.
+ *
+ * Production-ready graph storage with full CRUD operations,
+ * connection pooling, and optimized Cypher queries.
+ *
+ * @example
+ * ```typescript
+ * import { Neo4jStorage } from 'learngraph/storage';
+ *
+ * const storage = new Neo4jStorage();
+ * await storage.connect({
+ *   backend: 'neo4j',
+ *   uri: 'bolt://localhost:7687',
+ *   username: 'neo4j',
+ *   password: 'password',
+ *   database: 'learngraph',
+ * });
+ *
+ * // Create a skill
+ * 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: {},
+ * });
+ *
+ * // Query the graph
+ * const prerequisites = await storage.getPrerequisitesOf(skill.id);
+ * ```
+ */
+export declare class Neo4jStorage implements GraphStorage {
+    private driver;
+    private config;
+    private _connected;
+    private getSession;
+    private runQuery;
+    private recordToSkill;
+    private recordToEdge;
+    connect(config: StorageConfig): Promise<void>;
+    private initializeSchema;
+    disconnect(): Promise<void>;
+    isConnected(): boolean;
+    getStatus(): Promise<ConnectionStatus>;
+    createSkill(input: SkillNodeInput): Promise<SkillNode>;
+    getSkill(id: SkillId): Promise<SkillNode | null>;
+    getSkills(ids: SkillId[]): Promise<SkillNode[]>;
+    updateSkill(id: SkillId, updates: SkillNodeUpdate): Promise<SkillNode>;
+    deleteSkill(id: SkillId): Promise<void>;
+    findSkills(query: Partial<SkillQuery>): Promise<SkillNode[]>;
+    countSkills(query?: Partial<SkillQuery>): Promise<number>;
+    createPrerequisite(input: PrerequisiteEdgeInput): Promise<PrerequisiteEdge>;
+    getPrerequisite(id: EdgeId): Promise<PrerequisiteEdge | null>;
+    deletePrerequisite(id: EdgeId): Promise<void>;
+    findPrerequisites(criteria: {
+        sourceId?: SkillId;
+        targetId?: SkillId;
+        type?: string;
+        minStrength?: number;
+    }): Promise<PrerequisiteEdge[]>;
+    getPrerequisitesOf(skillId: SkillId): Promise<SkillNode[]>;
+    getDependentsOf(skillId: SkillId): Promise<SkillNode[]>;
+    getSubgraph(rootId: SkillId, depth: number): Promise<Subgraph>;
+    getRootSkills(): Promise<SkillNode[]>;
+    getLeafSkills(): Promise<SkillNode[]>;
+    getPath(fromId: SkillId, toId: SkillId): Promise<SkillNode[] | null>;
+    importGraph(nodes: SkillNodeInput[], edges: PrerequisiteEdgeInput[], options?: {
+        clearExisting?: boolean;
+    }): Promise<ImportResult>;
+    exportGraph(): Promise<GraphExport>;
+    clearAll(): Promise<void>;
+    getStats(): Promise<GraphStats>;
+}
+//# sourceMappingURL=neo4j.d.ts.map

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

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

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,5 @@ 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';
 //# 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"}

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.2.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);