Crate academy_forge 

Academy Forge

Extract structured knowledge from nexcore Rust source into a universal Intermediate Representation (IR) that feeds both Observatory (3D spatial rendering) and Academy (experiential learning pathways).

MCP Tools

Tool	Input	Output
forge_extract	crate_name, domain?	CrateAnalysis JSON
forge_validate	content (JSON)	ValidationReport JSON
forge_schema	(none)	StaticPathway JSON Schema
forge_compile	input_path, output_dir	TypeScript files

Workflow

1. forge_extract(crate="nexcore-tov", domain="vigilance") → IR
2. Claude writes academy content using IR + educational theory
3. forge_validate(content) → pass/fail + specific errors
4. Fix errors, re-validate until clean
5. forge_compile(input, output_dir) → Studio TypeScript files

Re-exports

pub use atomize::atomize;

pub use compile::CompileParams;

pub use compile::CompileResult;

pub use compile::compile as compile_pathway;

pub use error::ForgeError;

pub use error::ForgeResult;

pub use extract::extract_crate;

pub use graph::build_graph;

pub use guidance::GuidanceInput;

pub use guidance::GuidanceScaffoldParams;

pub use guidance::generate as guidance_scaffold;

pub use ir::AloEdge;

pub use ir::AloEdgeType;

pub use ir::AloType;

pub use ir::AtomicLearningObject;

pub use ir::AtomizedPathway;

pub use ir::BloomLevel;

pub use ir::CrateAnalysis;

pub use ir::DomainAnalysis;

pub use ir::GraphTopology;

pub use ir::LearningGraph;

pub use scaffold::ScaffoldParams;

pub use scaffold::generate as scaffold;

pub use validate::ValidationReport;

pub use validate::validate;

Modules

atomize

Atomize: decompose StaticPathway stages into Atomic Learning Objects.

compile

Compile module — transforms forge pathway JSON into Studio TypeScript files.

domain

Domain-specific extraction plugins.

error

Error types for the academy-forge crate.

extract

Generic extraction pipeline for Rust crates.

graph

Learning Graph: cross-pathway DAG builder and query engine.

guidance

Guidance-based scaffold generation for academy pathway authoring.

ir

Intermediate Representation (IR) types for Academy Forge.

scaffold

Scaffold generation for academy pathway authoring.

validate

Validation engine for academy content.