Skip to content

refactor: harden LinkForge architecture and centralize Core API for v1.4.0#246

Merged
arounamounchili merged 45 commits into
mainfrom
docs/refine-init-docstring
May 16, 2026
Merged

refactor: harden LinkForge architecture and centralize Core API for v1.4.0#246
arounamounchili merged 45 commits into
mainfrom
docs/refine-init-docstring

Conversation

@arounamounchili

@arounamounchili arounamounchili commented May 14, 2026 •
edited
Loading

Copy link
Copy Markdown
Owner

Pull Request

Important

This project uses Conventional Commits and Release Please for automated versioning.
Please ensure your PR title follows the Conventional Commits format (e.g., feat: add lidar sensor, fix: core logic bug).

📝 Description

This PR evolved into a comprehensive architectural hardening to stabilize the v1.4.0 release

🛠️ Type of change

  • 🧹 Refactor (refactor)
  • 📚 Documentation (docs)

✅ Checklist

  • I have run uv run pytest and all tests pass
  • I have run uv run pre-commit run --all-files and all hooks pass
  • I have verified the changes manually in the Blender viewport
  • I have updated the documentation or verified no changes are needed

@arounamounchili
docs: refine linkforge_core package docstring for accuracy
8e912d3 
Signed-off-by: arounamounchili <patouossa.mounchili@gmail.com>
@arounamounchili
feat: expand public API in linkforge_core to include parsers, generat…
e1c7ca6 
…ors, and models

Signed-off-by: arounamounchili <patouossa.mounchili@gmail.com>
@arounamounchili
docs: refine constants.py docstring for Google-style compliance
025bae5 
Signed-off-by: arounamounchili <patouossa.mounchili@gmail.com>
@arounamounchili
feat: add numerical stability guardrails and joint defaults to constants
7f7e50e 
Signed-off-by: arounamounchili <patouossa.mounchili@gmail.com>
@arounamounchili
refactor: enforce numerical stability constants in Link model and Val…
b5326a5 
…idation checks

Signed-off-by: arounamounchili <patouossa.mounchili@gmail.com>
@arounamounchili
test: consolidate stability enforcement tests into test_physics_stabi…
82f9e04 
…lity.py

Signed-off-by: arounamounchili <patouossa.mounchili@gmail.com>
@arounamounchili
docs: simplify constants docstring to Lean Google Style
e601395 
Signed-off-by: arounamounchili <patouossa.mounchili@gmail.com>
@arounamounchili
docs: standardize models package docstring
148434b 
Signed-off-by: arounamounchili <patouossa.mounchili@gmail.com>
@arounamounchili
docs: standardize geometry primitives documentation
e5f6d9b 
Signed-off-by: arounamounchili <patouossa.mounchili@gmail.com>
@arounamounchili
docs: standardize material and color documentation
9ddd8ea 
Signed-off-by: arounamounchili <patouossa.mounchili@gmail.com>
@arounamounchili
docs: standardize link model documentation
66c5e4b 
Signed-off-by: arounamounchili <patouossa.mounchili@gmail.com>
@arounamounchili
docs: standardize joint model documentation and defaults
ecd4d69 
Signed-off-by: arounamounchili <patouossa.mounchili@gmail.com>
@arounamounchili
docs: standardize robot model documentation
c4edc2f 
Signed-off-by: arounamounchili <patouossa.mounchili@gmail.com>
@arounamounchili
refactor: unify stability constants across core modules
03403c5 
Signed-off-by: arounamounchili <patouossa.mounchili@gmail.com>
@arounamounchili
docs: standardize SRDF model documentation
2e273b1 
Signed-off-by: arounamounchili <patouossa.mounchili@gmail.com>
@arounamounchili
docs: standardize sensor model documentation and stability
19c64d1 
Signed-off-by: arounamounchili <patouossa.mounchili@gmail.com>
@arounamounchili
docs: standardize transmission model documentation and stability
5811ea4 
Signed-off-by: arounamounchili <patouossa.mounchili@gmail.com>
@arounamounchili
docs: refine models with inline context for better maintainability
7eb9152 
Signed-off-by: arounamounchili <patouossa.mounchili@gmail.com>
@arounamounchili
docs: standardize gazebo model documentation
f4a8fc0 
Signed-off-by: arounamounchili <patouossa.mounchili@gmail.com>
@arounamounchili
docs: standardize kinematic graph documentation
8c7d75c 
Signed-off-by: arounamounchili <patouossa.mounchili@gmail.com>
@arounamounchili
chore: finalize core audit and blender sensor synchronization
3190d72 
- Standardized all core modules with Lean Google Style documentation.
- Hardened SensorTranslator with explicit casting and 3D LIDAR support.
- Synchronized Blender SensorPropertyGroup with core LIDAR requirements.
- Formalized 'Physics as Truth' design principle in contributing guide.
- Added PHYSICS_AS_TRUTH.md developer documentation.
- Resolved LIDAR validation regression in blender integration tests.

Signed-off-by: arounamounchili <patouossa.mounchili@gmail.com>
@arounamounchili arounamounchili changed the title Docs/refine init docstring refactor: audit and core documentation standardization May 14, 2026
@arounamounchili
refactor(blender): centralize platform constants and harden naming he…
44903b1 
…uristics

Signed-off-by: arounamounchili <patouossa.mounchili@gmail.com>
@arounamounchili
refactor: complete architectural hardening and code quality audit
aac58bd 
- Centralized all magic literals in core and blender platforms.
- Reorganized constants for improved logical flow and maintainability.
- Resolved import instabilities in URDF/SRDF parsers.
- Rephrased legacy comments into professional compatibility notices.
- Fixed numerical precision regressions in joint tests.
- Verified with full test suite, linting, and type checking.

Signed-off-by: arounamounchili <patouossa.mounchili@gmail.com>
@arounamounchili
refactor: harden LinkForge sensor architecture and synchronize centra…
fac5ec0 
…lized constants

Signed-off-by: arounamounchili <patouossa.mounchili@gmail.com>
@arounamounchili
refactor: modernize Blender platform adapter imports to use centraliz…
c52f3c2 
…ed Core API

Signed-off-by: arounamounchili <patouossa.mounchili@gmail.com>
@arounamounchili
refactor: finalize linkforge_core API centralization and flatten blen…
ae73387 
…der imports

- Fully expanded linkforge_core/__init__.py to expose all models, physics, and utilities.
- Refactored entire platforms/blender package to eliminate deep sub-module imports.
- Standardized on top-level API usage across adapters, properties, and operators.
- Verified zero remaining deep imports via repository-wide audit.

Signed-off-by: arounamounchili <patouossa.mounchili@gmail.com>
@arounamounchili
refactor: finalize comprehensive linkforge_core public API
8ce48c7 
- Added KinematicGraph and specialized exceptions (Xacro, Security).
- Exposed core XML parsing/serialization utilities.
- Included SRDF semantic models and resource resolvers.
- Unified public API manifest for all platform adapters.

Signed-off-by: arounamounchili <patouossa.mounchili@gmail.com>
@arounamounchili
refactor: optimize linkforge_core API for strict type checking
ffadd62 
- Implemented explicit re-exports (import-as) for all public members.
- Organized __all__ into logical categories for better scannability.
- Ensured 100% compliance with Mypy's strict re-export policy.
- Verified final architectural integrity with full check suite.

Signed-off-by: arounamounchili <patouossa.mounchili@gmail.com>
@arounamounchili
fix(blender): normalize transmission mapping and harden core API exports
b4a409c 
- Fix case-sensitivity regression in TransmissionTranslator by normalizing mapping
- Consolidate linkforge_core API gateway and explicitly export validation models
- Defer pytest imports in Blender test runner for environment compatibility
- Update integration tests to match normalized transmission types

Signed-off-by: arounamounchili <patouossa.mounchili@gmail.com>
@arounamounchili
refactor: modernize project structure and stabilize v1.3.0
966640c 
- Migrate to standard 'src' layout for linkforge.core and linkforge.blender
- Establish proper linkforge namespace package structure
- Overhaul core/__init__.py with clean exports and domain grouping
- Implement functional I/O API in io.py with 100% test coverage
- Update build and development scripts to handle new namespace paths
- Synchronize ARCHITECTURE and CONTRIBUTING documentation
- Harden type safety with Final and annotations across core/blender
- Verified with full test suite and quality checks (Ruff/MyPy/Pyright)

Signed-off-by: arounamounchili <patouossa.mounchili@gmail.com>
@arounamounchili arounamounchili changed the title refactor: audit and core documentation standardization refactor: harden LinkForge architecture and centralize Core API for v1.4.0 May 16, 2026
@arounamounchili
chore(release): modernize architecture and harden physics for v1.3.0
86353a6 
- Migrate core Enums to StrEnum (Python 3.11+ compliance)
- Implement Mirtich inertia integration unit tests
- Resolve Mypy 2.1.0 strictness in Blender handlers
- Upgrade development toolchain (Ruff, Mypy, Pre-commit)
- Fix broken documentation links in README

Signed-off-by: arounamounchili <patouossa.mounchili@gmail.com>
@arounamounchili
docs: document architecture decisions and fix broken links
64bfc99 
Signed-off-by: arounamounchili <patouossa.mounchili@gmail.com>
@arounamounchili
docs(core): modernize README to reflect API centralization and hardening
b5ee302 
Signed-off-by: arounamounchili <patouossa.mounchili@gmail.com>
@arounamounchili
docs: refine versioning in ADR-002 and core README
b72f99d 
Signed-off-by: arounamounchili <patouossa.mounchili@gmail.com>
@arounamounchili
docs(core): refine API introduction tone
3fafdff 
Signed-off-by: arounamounchili <patouossa.mounchili@gmail.com>
@arounamounchili
docs: modernize Blender and Test suite READMEs
06c0f11 
Signed-off-by: arounamounchili <patouossa.mounchili@gmail.com>
@arounamounchili
docs: correct relative paths in Blender and Test READMEs
598c15c 
Signed-off-by: arounamounchili <patouossa.mounchili@gmail.com>
@arounamounchili
fix(blender): correct core bundling path for src-layout compatibility
2005ed6 
Signed-off-by: arounamounchili <patouossa.mounchili@gmail.com>
@arounamounchili
refactor(blender): convert absolute core imports to relative for exte…
83564d8 
…nsion compatibility

Signed-off-by: arounamounchili <patouossa.mounchili@gmail.com>
@arounamounchili
fix(blender): fix collision generation bug and refactor import archit…
ca39f7f 
…ecture

- Fixed case-sensitivity bug in collision generation operator (GEOM_AUTO vs "AUTO").
- Refactored import architecture to use absolute imports for core library compatibility.
- Added sys.modules mapping in __init__.py for Blender extension portability.
- Fixed UI property access errors in forge and export panels.

Signed-off-by: arounamounchili <patouossa.mounchili@gmail.com>
@arounamounchili
fix(blender): ensure 'linkforge' and 'linkforge.blender' are aliased …
4f277ca 
…for extensions

- Explicitly alias the 'linkforge' and 'linkforge.blender' packages in sys.modules
  when running as a Blender extension.
- This resolves the 'ModuleNotFoundError: No module named linkforge' occurring
  in bundled builds due to absolute imports in sub-packages.

Signed-off-by: arounamounchili <patouossa.mounchili@gmail.com>
@arounamounchili
refactor(blender): use relative imports and dev symlinks to comply wi…
b8dd3e7 
…th extension policies

- Converted absolute 'linkforge.core' imports to relative '..core' imports.
- Added a development symlink from 'blender/src/linkforge/blender/core' to the real core.
- Removed sys.modules hacks that triggered Blender extension policy violations.
- Updated build script to skip the development symlink during staging.

Signed-off-by: arounamounchili <patouossa.mounchili@gmail.com>
@arounamounchili
feat(blender): automate absolute to relative import transformation fo…
6d2dd53 
…r extensions

- Reverted source code to clean absolute imports to satisfy Mypy/Pyright.
- Added 'transform_to_relative_imports' to 'build.py' to automatically handle
  extension namespace requirements during the build process.
- Removed runtime 'sys.modules' hacks from 'linkforge.blender', resolving
  Blender Extension policy violations.

Signed-off-by: arounamounchili <patouossa.mounchili@gmail.com>
@arounamounchili
fix(build): correct indentation in build_extension logic
c3185cd 
- Fixed an indentation error where the Blender build logic was accidentally
  nested inside the import transformation helper.
- Restored the explicit return of the distribution directory path.

Signed-off-by: arounamounchili <patouossa.mounchili@gmail.com>
@arounamounchili
refactor(build): harden absolute to relative import transformation
4cb145f 
- Fixed a bug where some absolute imports were not being correctly captured.
- Added debug logging to track transformed files during the build process.
- Verified that all 28 critical files are now correctly transformed to relative
  imports in the final extension package.

Signed-off-by: arounamounchili <patouossa.mounchili@gmail.com>
@arounamounchili arounamounchili merged commit 1096425 into main May 16, 2026
13 checks passed
@arounamounchili arounamounchili deleted the docs/refine-init-docstring branch May 16, 2026 18:56
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Reviewers

No reviews

Assignees

No one assigned

Labels

None yet

Projects

None yet

Milestone

No milestone

Development

Successfully merging this pull request may close these issues.

1 participant

@arounamounchili