Skip to content

Claude/add academic proofs g3z zu#5

Merged
hyperpolymath merged 5 commits into
mainfrom
claude/add-academic-proofs-G3zZU
Dec 31, 2025
Merged

Claude/add academic proofs g3z zu#5
hyperpolymath merged 5 commits into
mainfrom
claude/add-academic-proofs-G3zZU

Conversation

@hyperpolymath

Copy link
Copy Markdown
Owner

No description provided.

claude and others added 5 commits December 31, 2025 12:35
This commit adds exhaustive academic documentation covering the theoretical
foundations of the Anvomidav DSL for figure skating choreography notation.

## Formal Specification
- grammar.adoc: Complete EBNF grammar, lexical specification, parsing complexity
- semantics.adoc: Operational, denotational, and axiomatic semantics
- automata-theory.adoc: DFAs, PDAs, timed automata, tree automata

## Type Theory
- type-system.adoc: Dependent types, refinement types, effect system, linear types
- category-theory-foundations.adoc: CCCs, monads, adjunctions, fibred categories

## Domain Mathematics
- rink-geometry.adoc: Coordinate systems, paths, collision detection, topology
- temporal-specification.adoc: LTL, MTL, duration calculus, timed CSP
- skating-physics.adoc: Mechanics, dynamics, biomechanics
- numerical-analysis.adoc: Integration, error analysis, constraint handling

## Verification
- rules-specification.adoc: Formal ISU rule encoding
- verification-methodology.adoc: Theorem proving, model checking, runtime verification
- abstract-interpretation.adoc: Abstract domains, Galois connections, static analysis
- computational-complexity.adoc: Time/space bounds, decision problems, FPT

## Proofs
- soundness-completeness.adoc: Type soundness, semantic correctness, compiler correctness

## White Papers
- anvomidav-overview.adoc: Technical white paper summarizing the language

Each document includes theorems, proofs (or proof sketches), definitions,
and clearly marked TODO sections for areas requiring further development.
Comprehensive architecture document covering:
- 14 crate workspace structure
- Dependency graph between crates
- Key Rust crate selections (logos, chumsky, z3, tower-lsp, etc.)
- API sketches for each component
- 6-phase development roadmap
- Testing strategy (unit, property-based, snapshot, integration)
- Error handling approach with miette
Add complete workspace structure with four crates:

- anv-core: Domain types (Time, Position, Edge, JumpKind, Rotations,
  SpinPosition, Level, Diagnostics) for figure skating semantics

- anv-syntax: Lexer using logos with figure skating-specific tokens
  (edges, jumps, spins, levels) and parser using chumsky producing
  a typed AST

- anv-types: Hindley-Milner type checker with domain-specific types
  (Jump, Spin, StepSequence, etc.) and skating rule validation

- anv-cli: Command-line interface with check, parse, lex, fmt, and
  new commands using clap and miette for error reporting

The language supports:
- Program structure with segments (short/free/pattern)
- Element sequences with jumps, spins, step sequences
- Timing constraints and position tracking
- ISU-compliant element validation
- Add 22 new tests covering parser and type checker (68 total)
- Fix clippy warnings (enum_variant_names, while_let_on_iterator, etc.)
- Use #[default] derive macro for RotationDirection and Level enums
- Document safety invariant in switch_foot with expect()
- Box recursive expression parser components to reduce stack usage
- Use is_some_and instead of deprecated map_or pattern
- Fix token naming consistency (toe_loop not toe)
- Update ignored test message with accurate chumsky 0.9 limitation note

All 68 tests pass with 2 ignored for known issues:
- Function definition requires chumsky 0.10+ upgrade
- Doc-test skipped due to expression parsing
Signed-off-by: Jonathan D.A. Jewell <6759885+hyperpolymath@users.noreply.github.com>
@hyperpolymath
hyperpolymath merged commit 937c141 into main Dec 31, 2025
1 of 2 checks passed
@hyperpolymath
hyperpolymath deleted the claude/add-academic-proofs-G3zZU branch December 31, 2025 15: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.

2 participants