Limoxel v1.4.0 - SDK and APIs

[unhield]

Pull Request

Thank you for contributing to Limoxel.

---

Summary

Limoxel v1.4.0 introduces the public SDK and API layer, extending Limoxel's repository analysis and engineering capabilities for programmatic use.

This Pull Request also includes SDK examples, application templates, the developer portal, distribution support, compatibility tooling, documentation, and the associated version consistency updates.

---

Motivation

Limoxel now provides a reusable public interface in addition to its command-line experience.

The change is necessary to provide developers and external applications with a supported way to consume Limoxel capabilities programmatically while keeping the existing internal implementation intact.

The release also establishes a maintainable approach for current-version consumption so that applicable code does not need to duplicate the active Limoxel version throughout the repository.

---

Type of Change

Select all that apply.

• Bug Fix
• Documentation Improvement
• Performance Improvement
• Platform Enhancement
• Refactoring
• Testing
• Build / CI
• Repository Maintenance
• Other

---

Description

This Pull Request adds the v1.4.0 SDK and public API capabilities, including:

• Public Core SDK for repository, file, package, symbol, and search operations.
• Intelligence SDK for graph, analysis, navigation, reasoning, recommendations, and events.
• Unified intelligence access through the public SDK.
• Structured SDK error handling.
• Pagination and context-aware operation support where applicable.
• SDK lifecycle and concurrency support.
• SDK compatibility and versioning utilities.
• SDK examples covering common integration and intelligence workflows.
• Application templates for common SDK integration scenarios.
• Developer portal and public SDK documentation resources.
• API exploration and example resources.
• SDK distribution and integrity verification support.
• Public compatibility and migration guidance.
• Supporting SDK tests and validation.
• Updated README and CHANGELOG for v1.4.0.
• Updated CLI user documentation for the current release.
• Canonical version consumption through internal/version/version.go where appropriate.
• Preservation of intentional historical and version-specific version references.

The public SDK is additive to the existing Limoxel capabilities and does not replace or modify the existing internal CLI foundation.

---

Engineering Impact

• Architecture: Adds a public SDK/API layer that consumes existing Limoxel capabilities without modifying the existing core CLI foundation.
• Platform Components: Extends access to existing repository and intelligence capabilities through public SDK contracts.
• Repository Organization: Adds the public sdk/ area for SDK code, examples, templates, and supporting public-facing resources while maintaining the existing repository organization.
• Engineering Contracts: Adds public SDK contracts and compatibility-related interfaces.
• Public Interfaces: Introduces the v1.4.0 public SDK/API surface.
• Performance: No intentional regression or material performance change.
• Backward Compatibility: Existing functionality remains available; historical version-specific compatibility behavior is preserved.

---

Documentation

Does this change require documentation updates?

• Yes
• No

Updated documentation includes:

• Public SDK foundation documentation.
• Core SDK documentation.
• Intelligence SDK documentation.
• Master SDK and Public API user manual.
• SDK examples and usage guidance.
• Developer portal documentation.
• README.
• CHANGELOG.
• CLI user manual version information.

---

Validation

• Unit Tests
• Integration Tests
• SDK Tests
• Compatibility Tests
• Distribution Tests
• Manual Validation
• Build Verification
• Runtime Validation
• Documentation Review
• Public API validation
• Example and template validation
• Repository-wide validation

The completed validation covered the SDK, public API contracts, examples, templates, distribution behavior, compatibility behavior, version handling, existing repository functionality, and documentation.

---

Breaking Changes

Does this Pull Request introduce breaking changes?

• Yes
• No

No intentional breaking changes are introduced to existing Limoxel functionality or the public SDK surface.

---

Additional Notes

This Pull Request represents the complete v1.4.0 SDK and Public API release work.

The active Limoxel version is maintained through the canonical version source where dynamic version consumption is appropriate. Historical release values and intentionally version-specific test or compatibility values remain explicit where required.

The public SDK is additive and consumes existing Limoxel capabilities rather than duplicating or replacing them.

The branch is intended to be merged into main after maintainer review.

---

Contributor Checklist

Please confirm the following before submitting.

• I have read the Contributing Guidelines.
• My changes follow the engineering standards of Limoxel.
• I have updated documentation where required.
• I have executed the appropriate validation.
• My contribution preserves repository organization.
• My contribution maintains architectural consistency.
• My contribution does not introduce unrelated changes.

---

Maintainer Review

Every Pull Request is reviewed according to the engineering standards of Limoxel.

Review considers:

• Engineering Quality
• Architectural Consistency
• Repository Organization
• Documentation Quality
• Validation Results
• Long-Term Maintainability
• Alignment with the Project Vision

Submission of a Pull Request does not guarantee acceptance.

A Pull Request may be:

• Merged
• Merged after requested revisions
• Deferred for a future milestone
• Closed if it does not align with the engineering direction of the project

Contributors are encouraged to discuss significant architectural or platform-wide changes before implementation.

If you are uncertain whether a proposed contribution aligns with the project's long-term direction, please contact:

hello.limoxel@gmail.com

Thank you for contributing to Limoxel.

[Copilot]

Copilot was unable to review this pull request because the user who requested the review has reached their quota limit.