A Reliable, Predictable, and Automated Release Process.
As a leader, you need a reliable, predictable, and automated release process. Manual versioning is prone to human error, leading to incorrect release tags, broken downstream dependencies, and a loss of trust in your versioning scheme. Insipio replaces manual guesswork with automated, data-driven precision.
Insipio answers your critical questions:
- How can we be 100% certain that a breaking API change results in a MAJOR version bump, every single time?
- How do we stop wasting developer time debating whether a change is a MINOR feature or a PATCH fix?
- How can we create a fully automated, auditable history of every version change and the specific code changes that justified it?
Key Business Values:
- Enforce Semantic Versioning Automatically
- Insipio acts as a CI gate that guarantees your version numbers accurately reflect the impact of your code changes, preventing accidental breaking changes in minor/patch releases.
- Accelerate Release Cadence
- By automating the versioning and tagging process, you can eliminate a slow, manual step in your release workflow, enabling faster and more frequent deployments.
- Improve Downstream Reliability
- Consumers of your packages and APIs can trust your version numbers, knowing that a PATCH release will never contain a breaking change. This reduces integration failures across your organization.
Insipio understands your code, not just your commit messages.
As a developer, you want to focus on writing code, not on administrative release tasks. Insipio integrates into your CI/CD pipeline and automates the tedious process of versioning and tagging.
Key Technical Values:
- Deep Semantic Analysis
- The tool goes beyond Git history, parsing your code into an AST to detect high-impact changes that commit-message parsers would miss, such as a public method's signature changing or a class no longer implementing an interface.
- Configurable Impact Rules
- You define what constitutes a `MAJOR`, `MINOR`, or `PATCH` change in a simple, version-controlled `insipio/config.json` file. This allows you to tailor the versioning rules to your project's specific needs.
- Automated Git Tagging
- Once the analysis is complete, Insipio automatically generates and pushes the correct semantic and marketing version tags to your Git repository.
A Predictable, Configurable, and Easy to Integrate Versioning Engine.
As an operator, you need tools that are predictable, configurable, and easy to integrate. Insipio is a containerized application designed for seamless inclusion in any CI/CD pipeline.
Execution Modes:
init: A one-time setup command that creates a default `insipio/config.json` file in your repository and applies the initial version tags (e.g., `v0.0.0`).execute: The primary CI mode. It analyzes the changes since the last version tag, calculates the next version, generates the `insipio-metadata.json` artifact, and pushes the new version tags to Git.interactive: Starts a local web server to host the "Governance Hub" UI, which provides a "Codebase Explorer" to visualize your project's structure and helps you build and test your impact rules.
Licensing & Degraded Mode
If a valid license cannot be acquired, Insipio runs in a Degraded Mode. In this mode, it performs the full semantic analysis and logs its findings to the console, but it will not generate any artifacts or push any tags to your Git repository.