codecortex-context-engine 0.1.0a9__tar.gz → 0.1.0a10__tar.gz

codecortex_context_engine-0.1.0a10/.github/FUNDING.yml

@@ -0,0 +1,3 @@
+# GitHub displays this as a Sponsor button for the repository.
+custom:
+  - "https://behnamjalalico.github.io/CodeCortex/SUPPORT/"

codecortex_context_engine-0.1.0a10/.github/ISSUE_TEMPLATE/cloud-enterprise-interest.yml

@@ -0,0 +1,68 @@
+name: CodeCortex Cloud / Enterprise early access
+description: Register non-confidential interest in hosted, team, or enterprise CodeCortex
+title: "[Early Access] "
+body:
+  - type: markdown
+    attributes:
+      value: |
+        Thanks for your interest in CodeCortex Cloud and Enterprise.
+
+        This issue is public. Do not include secrets, proprietary repository details, customer data, security findings, or personal information.
+  - type: dropdown
+    id: plan
+    attributes:
+      label: Interested plan
+      options:
+        - Cloud Pro
+        - Team
+        - Enterprise
+        - Not sure yet
+    validations:
+      required: true
+  - type: dropdown
+    id: team-size
+    attributes:
+      label: Team size
+      options:
+        - "1"
+        - "2-10"
+        - "11-50"
+        - "51-200"
+        - "201+"
+    validations:
+      required: true
+  - type: dropdown
+    id: deployment
+    attributes:
+      label: Preferred deployment
+      options:
+        - Managed cloud
+        - Private cloud / VPC
+        - Self-hosted private deployment
+        - Hybrid
+        - Not sure yet
+    validations:
+      required: true
+  - type: textarea
+    id: workflow
+    attributes:
+      label: Main workflow
+      description: Describe the non-confidential workflow you want CodeCortex to improve.
+      placeholder: Example: shared context and impact analysis across several repositories.
+    validations:
+      required: true
+  - type: textarea
+    id: requirements
+    attributes:
+      label: Important capabilities
+      description: List the capabilities that would make an early-access deployment useful.
+      placeholder: Example: SSO, RBAC, audit logs, shared memory, hosted sync.
+    validations:
+      required: false
+  - type: checkboxes
+    id: public-data
+    attributes:
+      label: Public issue confirmation
+      options:
+        - label: I confirm that this issue contains no confidential or sensitive information.
+          required: true

{codecortex_context_engine-0.1.0a9 → codecortex_context_engine-0.1.0a10}/.github/workflows/bootstrap-release.yml

@@ -18,19 +18,19 @@ jobs:
         with:
           fetch-depth: 0
           persist-credentials: true
-      - name: Create v0.1.0a9 release tag from validated main
+      - name: Create v0.1.0a10 release tag from validated main
         shell: bash
         run: |
           set -euo pipefail
           git config user.name "Behnam Jalali"
           git config user.email "behnamjalalico@gmail.com"
-          if git rev-parse -q --verify refs/tags/v0.1.0a9 >/dev/null; then
-            echo "v0.1.0a9 already exists"
+          if git rev-parse -q --verify refs/tags/v0.1.0a10 >/dev/null; then
+            echo "v0.1.0a10 already exists"
           else
-            git tag -a v0.1.0a9 -m "CodeCortex Context Engine v0.1.0a9"
-            git push origin refs/tags/v0.1.0a9
+            git tag -a v0.1.0a10 -m "CodeCortex Context Engine v0.1.0a10"
+            git push origin refs/tags/v0.1.0a10
           fi
       - name: Dispatch release workflow
         env:
           GH_TOKEN: ${{ github.token }}
-        run: gh workflow run release.yml --ref main -f tag=v0.1.0a9
+        run: gh workflow run release.yml --ref main -f tag=v0.1.0a10

{codecortex_context_engine-0.1.0a9 → codecortex_context_engine-0.1.0a10}/.github/workflows/ci.yml

@@ -39,7 +39,7 @@ jobs:
           fi
       - name: Upload coverage
         if: matrix.python-version == '3.13' && !cancelled()
-        uses: codecov/codecov-action@fb8b3582c8e4def4969c97caa2f19720cb33a72f # v7.0.0
+        uses: codecov/codecov-action@303a32d7a59b442fa8d48b6a1cc6825c09c847a5 # v7.1.1
         with:
           use_oidc: true
           files: ./coverage.xml

{codecortex_context_engine-0.1.0a9 → codecortex_context_engine-0.1.0a10}/.github/workflows/codeql.yml

@@ -22,10 +22,10 @@ jobs:
       - uses: actions/checkout@3d3c42e5aac5ba805825da76410c181273ba90b1 # v7
         with:
           persist-credentials: false
-      - uses: github/codeql-action/init@cdf488f595d80d6e07e03d4674febd5ab45fa938 # v4
+      - uses: github/codeql-action/init@2892aa5e19bbd11bc0cff5427e3b750a04d9e3c2 # v4
         with:
           languages: python
           queries: security-extended
-      - uses: github/codeql-action/analyze@cdf488f595d80d6e07e03d4674febd5ab45fa938 # v4
+      - uses: github/codeql-action/analyze@2892aa5e19bbd11bc0cff5427e3b750a04d9e3c2 # v4
         with:
           category: /language:python

{codecortex_context_engine-0.1.0a9 → codecortex_context_engine-0.1.0a10}/.github/workflows/docker.yml

@@ -31,9 +31,9 @@ jobs:
       - uses: actions/checkout@3d3c42e5aac5ba805825da76410c181273ba90b1 # v7
         with:
           persist-credentials: false
-      - uses: docker/setup-buildx-action@8d2750c68a42422c14e847fe6c8ac0403b4cbd6f # v3
+      - uses: docker/setup-buildx-action@f87e5991a6d7451dcb8d9637bfbc97413f497069 # v4.4.1
       - name: Build core image
-        uses: docker/build-push-action@10e90e3645eae34f1e60eeb005ba3a3d33f178e8 # v6
+        uses: docker/build-push-action@c3c9e263c25d99ce0380d002d59b67737d91b0dc # v7.4.0
         with:
           context: .
           target: core
@@ -57,9 +57,9 @@ jobs:
       - uses: actions/checkout@3d3c42e5aac5ba805825da76410c181273ba90b1 # v7
         with:
           persist-credentials: false
-      - uses: docker/setup-buildx-action@8d2750c68a42422c14e847fe6c8ac0403b4cbd6f # v3
+      - uses: docker/setup-buildx-action@f87e5991a6d7451dcb8d9637bfbc97413f497069 # v4.4.1
       - name: Build full image
-        uses: docker/build-push-action@10e90e3645eae34f1e60eeb005ba3a3d33f178e8 # v6
+        uses: docker/build-push-action@c3c9e263c25d99ce0380d002d59b67737d91b0dc # v7.4.0
         with:
           context: .
           target: full

{codecortex_context_engine-0.1.0a9 → codecortex_context_engine-0.1.0a10}/.github/workflows/release.yml

@@ -205,8 +205,8 @@ jobs:
         with:
           persist-credentials: false
           ref: ${{ env.RELEASE_TAG }}
-      - uses: docker/setup-qemu-action@c7c53464625b32c7a7e944ae62b3e17d2b600130 # v3
-      - uses: docker/setup-buildx-action@8d2750c68a42422c14e847fe6c8ac0403b4cbd6f # v3
+      - uses: docker/setup-qemu-action@99012661954931238ded8c8b007157a8430204e1 # v4.4.0
+      - uses: docker/setup-buildx-action@f87e5991a6d7451dcb8d9637bfbc97413f497069 # v4.4.1
       - uses: docker/login-action@c94ce9fb468520275223c153574b00df6fe4bcc9 # v3
         with:
           registry: ghcr.io
@@ -217,7 +217,7 @@ jobs:
         shell: bash
         run: echo "name=ghcr.io/${GITHUB_REPOSITORY,,}${{ matrix.suffix }}" >> "$GITHUB_OUTPUT"
       - id: build
-        uses: docker/build-push-action@10e90e3645eae34f1e60eeb005ba3a3d33f178e8 # v6
+        uses: docker/build-push-action@c3c9e263c25d99ce0380d002d59b67737d91b0dc # v7.4.0
         with:
           context: .
           target: ${{ matrix.target }}

{codecortex_context_engine-0.1.0a9 → codecortex_context_engine-0.1.0a10}/.github/workflows/scorecard.yml

@@ -28,7 +28,7 @@ jobs:
           results_format: sarif
           publish_results: true
       - name: Upload SARIF
-        uses: github/codeql-action/upload-sarif@cdf488f595d80d6e07e03d4674febd5ab45fa938 # v4
+        uses: github/codeql-action/upload-sarif@2892aa5e19bbd11bc0cff5427e3b750a04d9e3c2 # v4
         with:
           sarif_file: results.sarif
       - name: Upload Scorecard artifact

codecortex_context_engine-0.1.0a10/.github/workflows/swebench-codecortex-ab.yml

@@ -0,0 +1,247 @@
+name: SWE-bench CodeCortex A/B
+
+on:
+  workflow_dispatch:
+    inputs:
+      instance_ids:
+        description: 'JSON list used when sample_size is 0'
+        required: true
+        default: '["sympy__sympy-20590"]'
+        type: string
+      sample_size:
+        description: 'Deterministic fresh-task sample size; 0 uses instance_ids'
+        required: true
+        default: 0
+        type: number
+      sample_seed:
+        description: 'Seed for deterministic unique-repository sampling'
+        required: true
+        default: 'codecortex-public-v1'
+        type: string
+      model:
+        description: 'OpenAI model used by Codex in both arms'
+        required: true
+        default: 'gpt-5.3-codex'
+        type: string
+      effort:
+        description: 'Reasoning effort used in both arms'
+        required: true
+        default: 'high'
+        type: choice
+        options:
+          - low
+          - medium
+          - high
+          - xhigh
+      submit_cloud_eval:
+        description: 'Submit both prediction files to official SWE-bench cloud evaluation'
+        required: true
+        default: false
+        type: boolean
+
+permissions:
+  contents: read
+
+jobs:
+  select-instances:
+    name: Select benchmark instances
+    runs-on: ubuntu-latest
+    outputs:
+      instance_ids: ${{ steps.select.outputs.instance_ids }}
+    steps:
+      - uses: actions/checkout@3d3c42e5aac5ba805825da76410c181273ba90b1 # v7
+        with:
+          persist-credentials: false
+
+      - uses: actions/setup-python@5fda3b95a4ea91299a34e894583c3862153e4b97 # v7
+        with:
+          python-version: "3.13"
+
+      - name: Install selector dependency
+        run: python -m pip install "datasets>=3,<5"
+
+      - name: Select deterministic task set
+        id: select
+        run: |
+          python scripts/swebench_ab.py select \
+            --count "${{ inputs.sample_size }}" \
+            --seed "${{ inputs.sample_seed }}" \
+            --explicit '${{ inputs.instance_ids }}' \
+            --github-output "$GITHUB_OUTPUT"
+
+  generate-patches:
+    name: ${{ matrix.mode }} / ${{ matrix.instance_id }}
+    needs: select-instances
+    runs-on: ubuntu-latest
+    timeout-minutes: 60
+    strategy:
+      fail-fast: false
+      max-parallel: 2
+      matrix:
+        mode: [baseline, codecortex]
+        instance_id: ${{ fromJSON(needs.select-instances.outputs.instance_ids) }}
+
+    steps:
+      - uses: actions/checkout@3d3c42e5aac5ba805825da76410c181273ba90b1 # v7
+        with:
+          persist-credentials: false
+
+      - uses: actions/setup-python@5fda3b95a4ea91299a34e894583c3862153e4b97 # v7
+        with:
+          python-version: "3.13"
+
+      - name: Install benchmark dependencies
+        run: python -m pip install "datasets>=3,<5"
+
+      - name: Install CodeCortex only in the enabled arm
+        if: matrix.mode == 'codecortex'
+        run: python -m pip install -e ".[parsers]"
+
+      - name: Prepare exact SWE-bench checkout
+        run: |
+          python scripts/swebench_ab.py prepare \
+            --instance-id "${{ matrix.instance_id }}" \
+            --workspace ".benchmark/run"
+
+      - name: Build CodeCortex index
+        if: matrix.mode == 'codecortex'
+        working-directory: .benchmark/run/target
+        run: |
+          cortex init .
+          cortex index
+
+      - name: Prepare trusted Codex configuration
+        shell: bash
+        env:
+          MODE: ${{ matrix.mode }}
+        run: |
+          mkdir -p .benchmark/codex-home
+          : > .benchmark/codex-home/config.toml
+          if [ "$MODE" = "codecortex" ]; then
+            target="$(realpath .benchmark/run/target)"
+            cat > .benchmark/codex-home/config.toml <<EOF
+          [mcp_servers.codecortex]
+          command = "cortex"
+          args = ["mcp", "--path", "$target"]
+          env = { CODECORTEX_BACKENDS = "auto" }
+          enabled = true
+          required = true
+          startup_timeout_sec = 60
+          tool_timeout_sec = 180
+          EOF
+          fi
+
+      - name: Run identical Codex agent
+        uses: openai/codex-action@52fe01ec70a42f454c9d2ebd47598f9fd6893d56 # v1.11
+        with:
+          openai-api-key: ${{ secrets.OPENAI_API_KEY }}
+          prompt-file: .benchmark/run/prompt.txt
+          working-directory: .benchmark/run/target
+          codex-home: .benchmark/codex-home
+          codex-version: "0.153.4"
+          model: ${{ inputs.model }}
+          effort: ${{ inputs.effort }}
+          permission-profile: ":workspace"
+          safety-strategy: "drop-sudo"
+          codex-args: '["--ephemeral"]'
+          output-file: .benchmark/final-message.txt
+
+      - name: Collect patch and provenance
+        if: always()
+        run: |
+          python scripts/swebench_ab.py collect \
+            --workspace ".benchmark/run" \
+            --output ".benchmark/results" \
+            --mode "${{ matrix.mode }}" \
+            --model "${{ inputs.model }}" \
+            --effort "${{ inputs.effort }}"
+          cp .benchmark/final-message.txt .benchmark/results/ 2>/dev/null || true
+
+      - name: Upload immutable evidence
+        if: always()
+        uses: actions/upload-artifact@043fb46d1a93c77aae656e7c1c64a875d1fc6a0a # v7
+        with:
+          name: swebench-${{ matrix.mode }}-${{ matrix.instance_id }}
+          path: .benchmark/results/
+          retention-days: 90
+          if-no-files-found: error
+
+  combine:
+    name: Combine A/B predictions
+    needs: generate-patches
+    if: always()
+    runs-on: ubuntu-latest
+    steps:
+      - uses: actions/checkout@3d3c42e5aac5ba805825da76410c181273ba90b1 # v7
+        with:
+          persist-credentials: false
+
+      - uses: actions/setup-python@5fda3b95a4ea91299a34e894583c3862153e4b97 # v7
+        with:
+          python-version: "3.13"
+
+      - uses: actions/download-artifact@3e5f45b2cfb9172054b4087a40e8e0b5a5461e7c # v8
+        with:
+          pattern: swebench-*
+          path: .benchmark/downloads
+          merge-multiple: true
+
+      - name: Combine
+        run: |
+          python scripts/swebench_ab.py combine \
+            --source .benchmark/downloads \
+            --output .benchmark/combined
+
+      - name: Upload combined predictions
+        uses: actions/upload-artifact@043fb46d1a93c77aae656e7c1c64a875d1fc6a0a # v7
+        with:
+          name: swebench-ab-combined-${{ github.run_id }}
+          path: .benchmark/combined/
+          retention-days: 90
+
+  cloud-evaluate:
+    name: Official SWE-bench cloud evaluation
+    needs: combine
+    if: ${{ inputs.submit_cloud_eval }}
+    runs-on: ubuntu-latest
+    timeout-minutes: 90
+    steps:
+      - uses: actions/download-artifact@3e5f45b2cfb9172054b4087a40e8e0b5a5461e7c # v8
+        with:
+          name: swebench-ab-combined-${{ github.run_id }}
+          path: .benchmark/combined
+
+      - uses: actions/setup-python@5fda3b95a4ea91299a34e894583c3862153e4b97 # v7
+        with:
+          python-version: "3.13"
+
+      - name: Install official SWE-bench cloud CLI
+        run: python -m pip install sb-cli
+
+      - name: Evaluate baseline
+        env:
+          SWEBENCH_API_KEY: ${{ secrets.SWEBENCH_API_KEY }}
+        run: |
+          sb-cli submit swe-bench_verified test \
+            --predictions_path .benchmark/combined/predictions-baseline.json \
+            --run_id "codecortex-baseline-${GITHUB_RUN_ID}" \
+            --output_dir .benchmark/reports/baseline \
+            --gen_report 1
+
+      - name: Evaluate CodeCortex
+        env:
+          SWEBENCH_API_KEY: ${{ secrets.SWEBENCH_API_KEY }}
+        run: |
+          sb-cli submit swe-bench_verified test \
+            --predictions_path .benchmark/combined/predictions-codecortex.json \
+            --run_id "codecortex-enabled-${GITHUB_RUN_ID}" \
+            --output_dir .benchmark/reports/codecortex \
+            --gen_report 1
+
+      - name: Upload cloud reports
+        if: always()
+        uses: actions/upload-artifact@043fb46d1a93c77aae656e7c1c64a875d1fc6a0a # v7
+        with:
+          name: swebench-cloud-reports-${{ github.run_id }}
+          path: .benchmark/reports/
+          retention-days: 90

{codecortex_context_engine-0.1.0a9 → codecortex_context_engine-0.1.0a10}/.gitignore

@@ -15,3 +15,5 @@ build/
 .codecortex/cache/
 .codecortex/index/
 .codecortex/runtime/
+web/node_modules/
+web/tsconfig.tsbuildinfo

{codecortex_context_engine-0.1.0a9 → codecortex_context_engine-0.1.0a10}/CHANGELOG.md

@@ -2,6 +2,15 @@
 
 All notable changes to CodeCortex are documented here. The project follows semantic versioning while in alpha; breaking changes may occur before 1.0 and will be called out explicitly.
 
+## 0.1.0a10
+
+- Fixed MCP protocol negotiation for unsupported and released protocol versions, and added read-only tool safety annotations for non-interactive agents.
+- Added reproducible SWE-bench CodeCortex A/B benchmarking with deterministic multi-task batches and verification of observed MCP usage.
+- Added a reproducible web-console lockfile, Cloud/Enterprise early-access materials, project support/funding documentation, and PowerShell setup guidance.
+- Updated build and release dependencies, including Docker Buildx, Nginx 1.29 Alpine, CodeQL 4.38.2, Codecov, and release container actions.
+- Kept CodeQL init, analyze, and SARIF upload actions on compatible pinned revisions while preserving required CI and security checks.
+- Synchronized package, MCP server, and registry version metadata for the v0.1.0a10 release.
+
 ## 0.1.0a9
 
 - Removed the final remaining named vendor reference from the current CodeCortex tree.

codecortex_context_engine-0.1.0a10/COMMERCIAL.md

@@ -0,0 +1,15 @@
+# Commercial Use and Services
+
+CodeCortex is available under the Apache License 2.0 as described in `LICENSE`. Those open-source rights remain available under that license.
+
+The Community core stays open source. The project does not require a paid license for the core CLI, MCP server, local indexing, search, impact analysis, or local use.
+
+Optional paid services may include managed hosting, synchronization, shared workspaces, team administration, enterprise controls, support, deployment assistance, warranty or indemnity terms, and negotiated enterprise agreements.
+
+A commercial agreement does not revoke rights already granted under Apache-2.0. Any commercial license or proprietary component must cover only material for which the licensor has the legal right to offer those terms.
+
+## Cloud and Enterprise early access
+
+Planned packaging and the public early-access intake are documented in [Cloud and Enterprise Early Access](docs/CLOUD_EARLY_ACCESS.md).
+
+The early-access form is a public GitHub issue. Do not include confidential, security-sensitive, or personal information. Organizations that need a private discussion can contact the maintainer through the GitHub profile.

{codecortex_context_engine-0.1.0a9 → codecortex_context_engine-0.1.0a10}/Dockerfile

@@ -36,7 +36,7 @@ RUN npm install
 COPY web ./
 RUN npm run build
 
-FROM nginx:1.27-alpine AS console
+FROM nginx:1.29-alpine AS console
 COPY deploy/nginx.conf /etc/nginx/conf.d/default.conf
 COPY --from=web-build /web/dist /usr/share/nginx/html
 EXPOSE 8080

{codecortex_context_engine-0.1.0a9 → codecortex_context_engine-0.1.0a10}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.5
 Name: codecortex-context-engine
-Version: 0.1.0a9
+Version: 0.1.0a10
 Summary: Context intelligence infrastructure for AI coding agents
 Project-URL: Homepage, https://github.com/BehnamJalaliCo/CodeCortex
 Project-URL: Repository, https://github.com/BehnamJalaliCo/CodeCortex
@@ -238,7 +238,7 @@ Requires-Dist: bandit>=1.7; extra == 'security'
 Requires-Dist: cyclonedx-bom>=4; extra == 'security'
 Requires-Dist: pip-audit>=2.7; extra == 'security'
 Provides-Extra: semantic
-Requires-Dist: sentence-transformers<6,>=3; extra == 'semantic'
+Requires-Dist: sentence-transformers<7,>=3; extra == 'semantic'
 Provides-Extra: web
 Requires-Dist: fastapi<1,>=0.116; extra == 'web'
 Requires-Dist: uvicorn<1,>=0.35; extra == 'web'
@@ -263,7 +263,7 @@ Description-Content-Type: text/markdown
 [![OpenSSF Scorecard](https://api.securityscorecards.dev/projects/github.com/BehnamJalaliCo/CodeCortex/badge)](https://securityscorecards.dev/viewer/?uri=github.com/BehnamJalaliCo/CodeCortex)
 [![License](https://img.shields.io/badge/license-Apache--2.0-blue.svg)](LICENSE)
 
-[**⭐ Star CodeCortex**](https://github.com/BehnamJalaliCo/CodeCortex) · [**Documentation**](https://behnamjalalico.github.io/CodeCortex/) · [**Latest Release**](https://github.com/BehnamJalaliCo/CodeCortex/releases/latest) · [**Good First Issues**](https://github.com/BehnamJalaliCo/CodeCortex/issues?q=is%3Aissue+is%3Aopen+label%3A%22good+first+issue%22) · [**Report a Bug**](https://github.com/BehnamJalaliCo/CodeCortex/issues/new?template=bug.yml) · [**Contribute**](CONTRIBUTING.md)
+[**⭐ Star CodeCortex**](https://github.com/BehnamJalaliCo/CodeCortex) · [**❤️ Support Project**](docs/SUPPORT.md) · [**Documentation**](https://behnamjalalico.github.io/CodeCortex/) · [**Latest Release**](https://github.com/BehnamJalaliCo/CodeCortex/releases/latest) · [**Contribute**](CONTRIBUTING.md)
 
 [🇬🇧 English](#english) · [🇮🇷 فارسی](#فارسی)
 
@@ -348,6 +348,8 @@ These are committed hardening measurements, not generalized performance promises
 
 See [HARDENING_REPORT.md](HARDENING_REPORT.md) and [benchmarks/](benchmarks/) for scope, methodology, limitations, and reproducibility notes.
 
+> ❤️ **Support CodeCortex** — If CodeCortex saves you time, consider supporting its continued open-source development. [**Crypto support →**](docs/SUPPORT.md)
+
 ---
 
 <a id="english"></a>
@@ -1109,6 +1111,11 @@ Public interfaces are still evolving. Breaking changes can occur before 1.0. Eva
 
 ---
 
+
+# Community
+
+[**Good First Issues**](https://github.com/BehnamJalaliCo/CodeCortex/issues?q=is%3Aissue+is%3Aopen+label%3A%22good+first+issue%22) · [**Report a Bug**](https://github.com/BehnamJalaliCo/CodeCortex/issues/new?template=bug.yml) · [**Contributing Guide**](CONTRIBUTING.md)
+
 # Documentation
 
 - [Architecture](docs/ARCHITECTURE.md)
@@ -1124,6 +1131,7 @@ Public interfaces are still evolving. Breaking changes can occur before 1.0. Eva
 - [Contributing](CONTRIBUTING.md)
 - [Governance](GOVERNANCE.md)
 - [Roadmap](ROADMAP.md)
+- [Cloud & Enterprise Early Access](docs/CLOUD_EARLY_ACCESS.md)
 
 
 ---
@@ -1940,6 +1948,11 @@ interfaceهای عمومی هنوز تکامل پیدا می‌کنند و قب
 
 ---
 
+
+# مشارکت در پروژه
+
+[**Good First Issues**](https://github.com/BehnamJalaliCo/CodeCortex/issues?q=is%3Aissue+is%3Aopen+label%3A%22good+first+issue%22) · [**گزارش باگ**](https://github.com/BehnamJalaliCo/CodeCortex/issues/new?template=bug.yml) · [**راهنمای مشارکت**](CONTRIBUTING.md)
+
 # مستندات
 
 - [Architecture](docs/ARCHITECTURE.md)
@@ -1955,6 +1968,7 @@ interfaceهای عمومی هنوز تکامل پیدا می‌کنند و قب
 - [Contributing](CONTRIBUTING.md)
 - [Governance](GOVERNANCE.md)
 - [Roadmap](ROADMAP.md)
+- [Cloud & Enterprise Early Access](docs/CLOUD_EARLY_ACCESS.md)
 
 
 ---

{codecortex_context_engine-0.1.0a9 → codecortex_context_engine-0.1.0a10}/README.md

@@ -17,7 +17,7 @@
 [![OpenSSF Scorecard](https://api.securityscorecards.dev/projects/github.com/BehnamJalaliCo/CodeCortex/badge)](https://securityscorecards.dev/viewer/?uri=github.com/BehnamJalaliCo/CodeCortex)
 [![License](https://img.shields.io/badge/license-Apache--2.0-blue.svg)](LICENSE)
 
-[**⭐ Star CodeCortex**](https://github.com/BehnamJalaliCo/CodeCortex) · [**Documentation**](https://behnamjalalico.github.io/CodeCortex/) · [**Latest Release**](https://github.com/BehnamJalaliCo/CodeCortex/releases/latest) · [**Good First Issues**](https://github.com/BehnamJalaliCo/CodeCortex/issues?q=is%3Aissue+is%3Aopen+label%3A%22good+first+issue%22) · [**Report a Bug**](https://github.com/BehnamJalaliCo/CodeCortex/issues/new?template=bug.yml) · [**Contribute**](CONTRIBUTING.md)
+[**⭐ Star CodeCortex**](https://github.com/BehnamJalaliCo/CodeCortex) · [**❤️ Support Project**](docs/SUPPORT.md) · [**Documentation**](https://behnamjalalico.github.io/CodeCortex/) · [**Latest Release**](https://github.com/BehnamJalaliCo/CodeCortex/releases/latest) · [**Contribute**](CONTRIBUTING.md)
 
 [🇬🇧 English](#english) · [🇮🇷 فارسی](#فارسی)
 
@@ -102,6 +102,8 @@ These are committed hardening measurements, not generalized performance promises
 
 See [HARDENING_REPORT.md](HARDENING_REPORT.md) and [benchmarks/](benchmarks/) for scope, methodology, limitations, and reproducibility notes.
 
+> ❤️ **Support CodeCortex** — If CodeCortex saves you time, consider supporting its continued open-source development. [**Crypto support →**](docs/SUPPORT.md)
+
 ---
 
 <a id="english"></a>
@@ -863,6 +865,11 @@ Public interfaces are still evolving. Breaking changes can occur before 1.0. Eva
 
 ---
 
+
+# Community
+
+[**Good First Issues**](https://github.com/BehnamJalaliCo/CodeCortex/issues?q=is%3Aissue+is%3Aopen+label%3A%22good+first+issue%22) · [**Report a Bug**](https://github.com/BehnamJalaliCo/CodeCortex/issues/new?template=bug.yml) · [**Contributing Guide**](CONTRIBUTING.md)
+
 # Documentation
 
 - [Architecture](docs/ARCHITECTURE.md)
@@ -878,6 +885,7 @@ Public interfaces are still evolving. Breaking changes can occur before 1.0. Eva
 - [Contributing](CONTRIBUTING.md)
 - [Governance](GOVERNANCE.md)
 - [Roadmap](ROADMAP.md)
+- [Cloud & Enterprise Early Access](docs/CLOUD_EARLY_ACCESS.md)
 
 
 ---
@@ -1694,6 +1702,11 @@ interfaceهای عمومی هنوز تکامل پیدا می‌کنند و قب
 
 ---
 
+
+# مشارکت در پروژه
+
+[**Good First Issues**](https://github.com/BehnamJalaliCo/CodeCortex/issues?q=is%3Aissue+is%3Aopen+label%3A%22good+first+issue%22) · [**گزارش باگ**](https://github.com/BehnamJalaliCo/CodeCortex/issues/new?template=bug.yml) · [**راهنمای مشارکت**](CONTRIBUTING.md)
+
 # مستندات
 
 - [Architecture](docs/ARCHITECTURE.md)
@@ -1709,6 +1722,7 @@ interfaceهای عمومی هنوز تکامل پیدا می‌کنند و قب
 - [Contributing](CONTRIBUTING.md)
 - [Governance](GOVERNANCE.md)
 - [Roadmap](ROADMAP.md)
+- [Cloud & Enterprise Early Access](docs/CLOUD_EARLY_ACCESS.md)
 
 
 ---

codecortex_context_engine-0.1.0a10/benchmarks/swebench/README.md

@@ -0,0 +1,56 @@
+# SWE-bench Verified A/B
+
+This benchmark measures the effect of CodeCortex on the same coding agent.
+
+## Fairness contract
+
+Both arms use:
+
+- the same SWE-bench Verified task;
+- the same repository base commit;
+- the same Codex CLI version;
+- the same OpenAI model and reasoning effort;
+- the same issue prompt and GitHub-hosted runner class.
+
+The only intended difference is:
+
+- **baseline**: Codex without CodeCortex;
+- **codecortex**: Codex with the CodeCortex MCP server and a prebuilt local index.
+
+The inference prompt forbids web lookup, original-PR lookup, and gold/reference-patch lookup. The SWE-bench gold patch and test patch are never written into the agent workspace.
+
+## First validation run
+
+Start with one task:
+
+`["sympy__sympy-20590"]`
+
+This is a pipeline validation, not a statistical claim. Increase the task set only after both arms produce valid prediction artifacts.
+
+## Required GitHub Actions secrets
+
+- `OPENAI_API_KEY` — used only by the official OpenAI Codex GitHub Action.
+- `SWEBENCH_API_KEY` — used only when `submit_cloud_eval=true`.
+
+Never commit either secret.
+
+## Evidence
+
+Each arm uploads:
+
+- SWE-bench prediction JSON;
+- patch SHA-256 and patch size;
+- exact repository/base commit;
+- CodeCortex repository commit;
+- model and reasoning effort;
+- Git status;
+- observed CodeCortex MCP tool-call counts;
+- the final Codex message.
+
+The combine job creates:
+
+- `predictions-baseline.json`;
+- `predictions-codecortex.json`;
+- `summary.json`.
+
+When cloud evaluation is enabled, both prediction files are submitted separately to the official SWE-bench cloud evaluator with distinct run IDs.