Skip to content

CodeStrata Community Edition v0.1.0

Choose a tag to compare

View all tags
@sknampally sknampally released this 29 Jul 17:27
· 9 commits to main since this release
v0.1.0
99072eb

CodeStrata Community Edition v0.1.0

First public release of CodeStrata Community Edition — an open-source CLI that assesses a software repository and produces deterministic findings, recommendations, and self-contained Engineering Assessment reports in HTML and JSON, together with findings artifacts.

The Engine produces structured engineering intelligence.

Community Edition scope

Community Edition supports local, single-repository assessment:

  • Technology detection and evidence extraction
  • Deterministic rules, findings, and recommendations
  • Self-contained HTML and JSON reports
  • Optional MCP server support
  • Optional AI narrative through --with-ai

AI is not required for the basic Community workflow.

Community Edition does not include hosted SaaS or CodeStrata Platform capabilities such as Engineering Knowledge Graph, Repository Retrieval and Answering, Portfolio Intelligence, Executive Intelligence, or Strategic Roadmap.

Public repositories

Repository Role
codestrata-engine Assessment CLI and Engine documentation
codestrata-examples Pinned real-world showcase manifests and fetch/showcase scripts

Requires Python 3.12 or newer.

Install

git clone https://github.com/CodeStrata/codestrata-engine.git
cd codestrata-engine

python3.12 -m venv .venv
source .venv/bin/activate
python -m pip install --upgrade pip
python -m pip install -e .

codestrata version
codestrata init
codestrata doctor

If python -m pip fails after activation (for example a shell python alias), use:

.venv/bin/python -m pip install --upgrade pip
.venv/bin/python -m pip install -e .

Offline sample assessment

codestrata assess --repo test-fixtures/sample-js-app --output reports --no-ai

Generated under reports/sample-js-app/<timestamp>/:

  • report.html
  • report.json
  • findings.json (and related assessment artifacts)

Basic analysis is deterministic. Use --no-ai for zero provider calls — AI is not required.

Optional MCP

python -m pip install -e '.[mcp]'

MCP is optional and not required for Quick Start.

Standalone PetClinic showcase

git clone https://github.com/CodeStrata/codestrata-examples.git
cd codestrata-examples

python real-world/scripts/run_showcase.py spring-petclinic

Or fetch then assess:

python real-world/scripts/fetch_example.py spring-petclinic
codestrata assess \
  --repo .codestrata-examples/spring-petclinic \
  --output reports/showcases/spring-petclinic \
  --profile community \
  --no-ai

codestrata-examples ships a root codestrata.toml so this works from a standalone clone. Showcase runs need network access to fetch the pinned upstream commit.

Known limitations

  • Bundled offline fixture: sample-js-app only in this release
  • Real-world showcases require network access to pinned third-party repositories
  • Optional AI narrative needs separate provider credentials and is outside the basic verified workflow
  • Language samples beyond the published JS fixture are not part of this Community release surface

Contributing and feedback

  • Open issues and pull requests on codestrata-engine for the CLI and Engine docs
  • Open issues and pull requests on codestrata-examples for showcase manifests and scripts
  • Security reports: see SECURITY.md in this repository
  • License: MIT (LICENSE)

Thank you for trying CodeStrata Community Edition.

Assets 2
Loading