Skip to content

Add academic extension for scientific documents#16

Merged
gvonness-apolitical merged 1 commit intomainfrom
feature/academic-extension
Feb 1, 2026
Merged

Add academic extension for scientific documents#16
gvonness-apolitical merged 1 commit intomainfrom
feature/academic-extension

Conversation

@gvonness-apolitical
Copy link
Collaborator

Summary

  • Introduces codex.academic extension for academic and scientific documents
  • Adds theorem-like environments (theorem, lemma, definition, proposition, corollary, conjecture, remark, example) with custom variant support
  • Adds proof blocks with method annotations (direct, contradiction, induction, cases, etc.)
  • Adds multi-part exercises with hints and visibility-controlled solutions (hidden, spoiler, instructor-only)
  • Adds exercise sets for grouping problems with shared context
  • Adds multi-line equation groups (align, gather, alignat, split) with numbering and custom tags
  • Adds algorithm blocks with line-numbered pseudocode and input/output specifications
  • Adds cross-reference marks for theorems, equations, and algorithm lines
  • Adds configurable numbering system with counter sharing and reset triggers
  • Includes comprehensive JSON Schema validation

Files Changed

File Description
spec/extensions/academic/README.md Extension specification
schemas/academic.schema.json JSON Schema for validation
schemas/README.md Added extension schemas section
scripts/validate-schemas.ts Added academic schema to validation

Test plan

  • Schema compiles and validates correctly (npm test passes)
  • All existing tests continue to pass
  • Review specification for completeness and consistency

Introduces codex.academic extension supporting:
- Theorem-like environments (theorem, lemma, definition, etc.)
- Custom theorem variants with configurable counter sharing
- Proof blocks with method annotations (induction, contradiction, etc.)
- Multi-part exercises with hints and visibility-controlled solutions
- Exercise sets for grouped problems with shared context
- Multi-line equation groups with custom tags
- Algorithm blocks with line-numbered pseudocode
- Cross-references for theorems, equations, and algorithm lines
- Configurable numbering systems with reset triggers
@gvonness-apolitical gvonness-apolitical merged commit c5d80f4 into main Feb 1, 2026
2 checks passed
@gvonness-apolitical gvonness-apolitical deleted the feature/academic-extension branch February 1, 2026 04:13
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

1 participant