structural_engineering_lib

Hard-learned development rules by domain — Python, FastAPI, React, Testing. Prevents the specific mistakes that caused 70+ audit findings across v0.21.0-v0.21.3.

Mandatory pre-merge quality checks for production code — security scan, packaging test, API consistency, no silent failures. Prevents the issues that caused 4 emergency releases in v0.21.x.

Pre-release validation — packaging verification, user acceptance testing, security scan, API drift detection. Prevents the recurring pattern of shipping broken wheels and missing files.

Test the library from an end-user perspective — pip install, import, run all workflows. Catches packaging, import, and API issues that internal tests miss.

Discover exact API function signatures, parameter names, and types from structural_lib. Use BEFORE wrapping or calling any API function. Prevents the #1 agent mistake: guessing parameter names (b_mm not width, fck not concrete_grade).

Run a structured innovation research cycle — discover gaps, propose novel capabilities, prototype and validate breakthrough ideas for structural engineering.

Automate AI agent session start and end workflows. Use when beginning a new work session or finishing one. Handles reading priorities, verifying environment, logging changes, updating handoff docs, and committing session artifacts.

Run self-evolution cycle — score agents, detect drift, propose instruction improvements. Use at session end, weekly cadence, or monthly deep review.

Step-by-step workflow for adding a new structural element (column, slab, footing) to the library. Covers IS 456 clause research, type definitions, pure math implementation, API wiring, tests, and frontend integration.

Validate 4-layer architecture boundaries, import direction, code duplication, and structural integrity. Use during code review or after cross-layer changes. Wraps check_architecture_boundaries.py, validate_imports.py, and duplication scans.

Run IS 456:2000 compliance verification tests and benchmark checks. Use to validate structural calculations, verify code compliance, run regression tests, and check design results against known benchmarks.

Run React build, lint, type-check, and test validation. Use after modifying React components, hooks, or configuration. Catches TypeScript errors, Tailwind issues, and build failures before commit.

Safely move, rename, or delete files while preserving 870+ internal documentation links. Use INSTEAD of manual mv, rm, or git mv. Wraps safe_file_move.py and safe_file_delete.py scripts.