codecortex-context-engine 0.1.0a1__tar.gz

codecortex_context_engine-0.1.0a1/.dockerignore

@@ -0,0 +1,16 @@
+.git
+.github
+.codecortex
+.venv
+venv
+__pycache__
+*.pyc
+*.pyo
+.pytest_cache
+.mypy_cache
+.ruff_cache
+build
+dist
+*.egg-info
+benchmarks/production/results.json
+benchmarks/production/agent-results.json

codecortex_context_engine-0.1.0a1/.github/CODEOWNERS

@@ -0,0 +1,10 @@
+# Default ownership
+* @BehnamJalaliCo
+
+# Security and release-sensitive surfaces
+/.github/ @BehnamJalaliCo
+/SECURITY.md @BehnamJalaliCo
+/LICENSE @BehnamJalaliCo
+/pyproject.toml @BehnamJalaliCo
+/src/codecortex/backends/ @BehnamJalaliCo
+/src/codecortex/mcp/ @BehnamJalaliCo

codecortex_context_engine-0.1.0a1/.github/ISSUE_TEMPLATE/bug.yml

@@ -0,0 +1,38 @@
+name: Bug report
+description: Report a reproducible CodeCortex problem
+title: "[Bug]: "
+labels: ["bug"]
+body:
+  - type: markdown
+    attributes:
+      value: "Thanks for helping improve CodeCortex. Do not include secrets or vulnerability details here."
+  - type: input
+    id: version
+    attributes:
+      label: Version or commit
+    validations:
+      required: true
+  - type: textarea
+    id: reproduce
+    attributes:
+      label: Reproduction
+      description: Minimal steps or repository-independent example.
+    validations:
+      required: true
+  - type: textarea
+    id: expected
+    attributes:
+      label: Expected behavior
+    validations:
+      required: true
+  - type: textarea
+    id: actual
+    attributes:
+      label: Actual behavior
+    validations:
+      required: true
+  - type: input
+    id: environment
+    attributes:
+      label: Environment
+      description: OS, Python version, and relevant agent/CLI.

codecortex_context_engine-0.1.0a1/.github/ISSUE_TEMPLATE/config.yml

@@ -0,0 +1,5 @@
+blank_issues_enabled: false
+contact_links:
+  - name: Security vulnerability
+    url: https://github.com/BehnamJalaliCo/CodeCortex/security/advisories/new
+    about: Report suspected vulnerabilities privately.

codecortex_context_engine-0.1.0a1/.github/ISSUE_TEMPLATE/feature.yml

@@ -0,0 +1,22 @@
+name: Feature request
+description: Propose a focused product or engineering improvement
+title: "[Feature]: "
+labels: ["enhancement"]
+body:
+  - type: textarea
+    id: problem
+    attributes:
+      label: Problem
+      description: What user or engineering problem should be solved?
+    validations:
+      required: true
+  - type: textarea
+    id: proposal
+    attributes:
+      label: Proposed solution
+    validations:
+      required: true
+  - type: textarea
+    id: alternatives
+    attributes:
+      label: Alternatives considered

codecortex_context_engine-0.1.0a1/.github/PULL_REQUEST_TEMPLATE.md

@@ -0,0 +1,16 @@
+## Summary
+
+Describe what changed and why.
+
+## Validation
+
+- [ ] Tests added or updated when behavior changed
+- [ ] `ruff check .` passes
+- [ ] `pytest -q` passes
+- [ ] Security implications considered
+- [ ] Documentation updated when user-visible behavior changed
+- [ ] No secrets, private source, or generated credentials are included
+
+## Compatibility / risk
+
+Describe compatibility impact, migration needs, or rollout risk. Write `None` when not applicable.

codecortex_context_engine-0.1.0a1/.github/dependabot.yml

@@ -0,0 +1,20 @@
+version: 2
+updates:
+  - package-ecosystem: pip
+    directory: "/"
+    schedule:
+      interval: weekly
+    open-pull-requests-limit: 10
+    labels: ["dependencies"]
+  - package-ecosystem: github-actions
+    directory: "/"
+    schedule:
+      interval: weekly
+    open-pull-requests-limit: 10
+    labels: ["dependencies", "github-actions"]
+  - package-ecosystem: docker
+    directory: "/"
+    schedule:
+      interval: weekly
+    open-pull-requests-limit: 5
+    labels: ["dependencies", "docker"]

codecortex_context_engine-0.1.0a1/.github/pull_request_template.md

@@ -0,0 +1,15 @@
+## What changed
+
+Describe the behavior and why it belongs in CodeCortex.
+
+## Verification
+
+- [ ] Tests added or updated
+- [ ] `ruff check .` passes
+- [ ] `pytest -q` passes
+- [ ] No benchmark or performance claim is included without a reproducible measurement
+- [ ] Backend contract changes include compatibility coverage
+
+## Risk
+
+Describe compatibility, security, performance, or migration risk.

codecortex_context_engine-0.1.0a1/.github/workflows/backend-conformance.yml

@@ -0,0 +1,45 @@
+name: Backend Boundary Conformance
+
+on:
+  workflow_dispatch:
+  push:
+    branches: [main]
+    paths:
+      - "src/codecortex/backends/**"
+      - "src/codecortex/context/integrated.py"
+      - "tests/test_backend_*.py"
+      - "tests/test_context_backend_adapter.py"
+      - ".github/workflows/backend-conformance.yml"
+      - "pyproject.toml"
+  pull_request:
+    paths:
+      - "src/codecortex/backends/**"
+      - "src/codecortex/context/integrated.py"
+      - "tests/test_backend_*.py"
+      - "tests/test_context_backend_adapter.py"
+      - ".github/workflows/backend-conformance.yml"
+      - "pyproject.toml"
+
+permissions:
+  contents: read
+
+jobs:
+  backend-boundary:
+    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"
+          cache: pip
+      - run: python -m pip install --upgrade pip
+      - run: pip install -e ".[dev]"
+      - run: >-
+          pytest -q
+          tests/test_backend_contracts.py
+          tests/test_backend_factory.py
+          tests/test_backend_manager.py
+          tests/test_backend_session_pool.py
+          tests/test_context_backend_adapter.py

codecortex_context_engine-0.1.0a1/.github/workflows/bootstrap-release.yml

@@ -0,0 +1,28 @@
+name: Bootstrap First Release
+
+on:
+  push:
+    paths:
+      - .github/workflows/bootstrap-release.yml
+
+permissions:
+  contents: write
+  actions: write
+
+jobs:
+  release:
+    runs-on: ubuntu-latest
+    steps:
+      - uses: actions/checkout@3d3c42e5aac5ba805825da76410c181273ba90b1
+        with:
+          fetch-depth: 0
+      - name: Point v0.1.0a1 at the validated release commit
+        run: |
+          git config user.name "github-actions[bot]"
+          git config user.email "41898282+github-actions[bot]@users.noreply.github.com"
+          git tag -fa v0.1.0a1 -m "CodeCortex Context Engine v0.1.0a1"
+          git push --force origin refs/tags/v0.1.0a1
+      - name: Dispatch release workflow
+        env:
+          GH_TOKEN: ${{ github.token }}
+        run: gh workflow run release.yml --ref main -f tag=v0.1.0a1

codecortex_context_engine-0.1.0a1/.github/workflows/ci.yml

@@ -0,0 +1,61 @@
+name: CI
+
+on:
+  push:
+    branches: [main]
+  pull_request:
+
+permissions:
+  contents: read
+
+jobs:
+  test:
+    runs-on: ubuntu-latest
+    permissions:
+      contents: read
+      id-token: write
+    strategy:
+      fail-fast: false
+      matrix:
+        python-version: ["3.11", "3.12", "3.13"]
+    steps:
+      - uses: actions/checkout@3d3c42e5aac5ba805825da76410c181273ba90b1 # v7
+        with:
+          persist-credentials: false
+      - uses: actions/setup-python@5fda3b95a4ea91299a34e894583c3862153e4b97 # v7
+        with:
+          python-version: ${{ matrix.python-version }}
+          cache: pip
+      - run: python -m pip install --upgrade pip
+      - run: pip install -e ".[dev]"
+      - run: ruff check .
+      - name: Tests
+        run: |
+          if [ "${{ matrix.python-version }}" = "3.13" ]; then
+            pytest -q --cov=codecortex --cov-report=xml --cov-report=term-missing --cov-fail-under=65
+          else
+            pytest -q
+          fi
+      - name: Upload coverage
+        if: matrix.python-version == '3.13' && !cancelled()
+        uses: codecov/codecov-action@fb8b3582c8e4def4969c97caa2f19720cb33a72f # v7.0.0
+        with:
+          use_oidc: true
+          files: ./coverage.xml
+          fail_ci_if_error: false
+
+  package:
+    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"
+      - run: python -m pip install --upgrade pip build twine
+      - run: python -m build
+      - run: python -m twine check dist/*
+      - run: pip install dist/*.whl
+      - run: cortex --help
+      - run: cortex version

codecortex_context_engine-0.1.0a1/.github/workflows/codeql.yml

@@ -0,0 +1,31 @@
+name: CodeQL
+
+on:
+  push:
+    branches: [main]
+  pull_request:
+    branches: [main]
+  schedule:
+    - cron: "7 2 * * 5"
+
+permissions:
+  security-events: write
+  packages: read
+  actions: read
+  contents: read
+
+jobs:
+  analyze:
+    runs-on: ubuntu-latest
+    timeout-minutes: 30
+    steps:
+      - uses: actions/checkout@3d3c42e5aac5ba805825da76410c181273ba90b1 # v7
+        with:
+          persist-credentials: false
+      - uses: github/codeql-action/init@cdf488f595d80d6e07e03d4674febd5ab45fa938 # v4
+        with:
+          languages: python
+          queries: security-extended
+      - uses: github/codeql-action/analyze@cdf488f595d80d6e07e03d4674febd5ab45fa938 # v4
+        with:
+          category: /language:python

codecortex_context_engine-0.1.0a1/.github/workflows/docker.yml

@@ -0,0 +1,78 @@
+name: Docker
+
+on:
+  workflow_dispatch:
+  push:
+    branches: [main]
+    paths:
+      - "Dockerfile"
+      - "compose.yaml"
+      - ".dockerignore"
+      - "pyproject.toml"
+      - "src/**"
+      - ".github/workflows/docker.yml"
+  pull_request:
+    paths:
+      - "Dockerfile"
+      - "compose.yaml"
+      - ".dockerignore"
+      - "pyproject.toml"
+      - "src/**"
+      - ".github/workflows/docker.yml"
+
+permissions:
+  contents: read
+
+jobs:
+  core-image:
+    runs-on: ubuntu-latest
+    timeout-minutes: 30
+    steps:
+      - uses: actions/checkout@3d3c42e5aac5ba805825da76410c181273ba90b1 # v7
+        with:
+          persist-credentials: false
+      - uses: docker/setup-buildx-action@8d2750c68a42422c14e847fe6c8ac0403b4cbd6f # v3
+      - name: Build core image
+        uses: docker/build-push-action@10e90e3645eae34f1e60eeb005ba3a3d33f178e8 # v6
+        with:
+          context: .
+          target: core
+          load: true
+          tags: codecortex:test-core
+          cache-from: type=gha,scope=core
+          cache-to: type=gha,mode=max,scope=core
+      - name: CLI smoke
+        run: |
+          docker run --rm codecortex:test-core --help
+          docker run --rm codecortex:test-core version
+      - name: Runtime smoke
+        run: |
+          docker run --rm -v "$PWD/examples/demo_project:/workspace" --tmpfs /workspace/.codecortex:uid=10001,gid=10001 codecortex:test-core doctor --path /workspace
+          docker run --rm -v "$PWD/examples/demo_project:/workspace" --tmpfs /workspace/.codecortex:uid=10001,gid=10001 codecortex:test-core index --path /workspace
+
+  full-image:
+    runs-on: ubuntu-latest
+    timeout-minutes: 90
+    steps:
+      - uses: actions/checkout@3d3c42e5aac5ba805825da76410c181273ba90b1 # v7
+        with:
+          persist-credentials: false
+      - uses: docker/setup-buildx-action@8d2750c68a42422c14e847fe6c8ac0403b4cbd6f # v3
+      - name: Build full image
+        uses: docker/build-push-action@10e90e3645eae34f1e60eeb005ba3a3d33f178e8 # v6
+        with:
+          context: .
+          target: full
+          load: true
+          tags: codecortex:test-full
+          cache-from: type=gha,scope=full
+          cache-to: type=gha,mode=max,scope=full
+      - name: Backend smoke
+        run: |
+          docker run --rm codecortex:test-full backend list
+          docker run --rm -v "$PWD/examples/demo_project:/workspace" --tmpfs /workspace/.codecortex:uid=10001,gid=10001 codecortex:test-full backend doctor --path /workspace
+      - name: MCP discovery smoke
+        run: |
+          printf '%s\n' '{"jsonrpc":"2.0","id":1,"method":"initialize","params":{}}' '{"jsonrpc":"2.0","id":2,"method":"tools/list","params":{}}' | docker run -i --rm -v "$PWD/examples/demo_project:/workspace" --tmpfs /workspace/.codecortex:uid=10001,gid=10001 codecortex:test-full mcp --path /workspace | tee /tmp/mcp.out
+          grep -q 'cortex_repository_map' /tmp/mcp.out
+          grep -q 'cortex_rename_symbol' /tmp/mcp.out

codecortex_context_engine-0.1.0a1/.github/workflows/docs.yml

@@ -0,0 +1,58 @@
+name: Docs
+
+on:
+  workflow_dispatch:
+  push:
+    branches: [main]
+    paths:
+      - "docs/**"
+      - "mkdocs.yml"
+      - ".github/workflows/docs.yml"
+  pull_request:
+    paths:
+      - "docs/**"
+      - "mkdocs.yml"
+      - ".github/workflows/docs.yml"
+
+permissions:
+  contents: read
+
+concurrency:
+  group: pages
+  cancel-in-progress: true
+
+jobs:
+  build:
+    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"
+          cache: pip
+      - name: Install docs toolchain
+        run: pip install "mkdocs>=1.6,<2" "mkdocs-material>=9.6,<10"
+      - name: Build documentation
+        run: mkdocs build --strict
+      - name: Upload Pages artifact
+        if: github.event_name != 'pull_request'
+        uses: actions/upload-pages-artifact@7b1f4a764d45c48632c6b24a0339c27f5614fb0b # v4
+        with:
+          path: site
+
+  deploy:
+    if: github.event_name != 'pull_request'
+    needs: build
+    runs-on: ubuntu-latest
+    environment:
+      name: github-pages
+      url: ${{ steps.deployment.outputs.page_url }}
+    permissions:
+      pages: write
+      id-token: write
+    steps:
+      - name: Deploy to GitHub Pages
+        id: deployment
+        uses: actions/deploy-pages@d6db90164ac5ed86f2b6aed7e0febac5b3c0c03e # v4

codecortex_context_engine-0.1.0a1/.github/workflows/live-agent-e2e.yml

@@ -0,0 +1,67 @@
+name: Live Agent E2E
+
+on:
+  workflow_dispatch:
+  schedule:
+    - cron: "13 6 * * 2"
+
+permissions:
+  contents: read
+
+jobs:
+  live-agent:
+    runs-on: ubuntu-latest
+    timeout-minutes: 45
+    strategy:
+      fail-fast: false
+      matrix:
+        include:
+          - agent: opencode
+            install: npm install -g opencode-ai
+            configure: cortex agents configure --target opencode
+            command: opencode run {prompt}
+            key_env: OPENAI_API_KEY
+          - agent: codex
+            install: npm install -g @openai/codex
+            configure: cortex agents configure --target codex
+            command: codex exec {prompt}
+            key_env: OPENAI_API_KEY
+          - agent: claude
+            install: npm install -g @anthropic-ai/claude-code
+            configure: cortex agents configure --target claude
+            command: claude -p {prompt}
+            key_env: ANTHROPIC_API_KEY
+          - agent: gemini
+            install: npm install -g @google/gemini-cli
+            configure: cortex agents configure --target gemini
+            command: gemini -p {prompt}
+            key_env: GEMINI_API_KEY
+    steps:
+      - uses: actions/checkout@3d3c42e5aac5ba805825da76410c181273ba90b1 # v7
+        with:
+          persist-credentials: false
+      - uses: actions/setup-python@5fda3b95a4ea91299a34e894583c3862153e4b97 # v7
+        with:
+          python-version: "3.13"
+      - uses: actions/setup-node@49933ea5288caeca8642d1e84afbd3f7d6820020 # v4
+        with:
+          node-version: "22"
+      - run: pip install -e ".[dev]"
+      - run: cortex init .
+      - name: Install agent
+        run: ${{ matrix.install }}
+      - name: Verify agent binary and generate MCP config
+        run: |
+          ${{ matrix.configure }}
+          command -v ${{ matrix.agent }} || true
+      - name: Run live MCP tool-use check
+        if: ${{ matrix.key_env == 'OPENAI_API_KEY' && secrets.OPENAI_API_KEY != '' || matrix.key_env == 'ANTHROPIC_API_KEY' && secrets.ANTHROPIC_API_KEY != '' || matrix.key_env == 'GEMINI_API_KEY' && secrets.GEMINI_API_KEY != '' }}
+        env:
+          OPENAI_API_KEY: ${{ secrets.OPENAI_API_KEY }}
+          ANTHROPIC_API_KEY: ${{ secrets.ANTHROPIC_API_KEY }}
+          GEMINI_API_KEY: ${{ secrets.GEMINI_API_KEY }}
+          CODECORTEX_SOURCE_ROOT: ${{ github.workspace }}
+        run: python scripts/live_agent_e2e.py --agent "${{ matrix.agent }}" --command "${{ matrix.command }}"
+      - name: Record credential-gated skip
+        if: ${{ !(matrix.key_env == 'OPENAI_API_KEY' && secrets.OPENAI_API_KEY != '' || matrix.key_env == 'ANTHROPIC_API_KEY' && secrets.ANTHROPIC_API_KEY != '' || matrix.key_env == 'GEMINI_API_KEY' && secrets.GEMINI_API_KEY != '') }}
+        run: echo "${{ matrix.agent }} installed/configured; live model call skipped because its API secret is not configured." >> "$GITHUB_STEP_SUMMARY"

codecortex_context_engine-0.1.0a1/.github/workflows/parser-providers.yml

@@ -0,0 +1,38 @@
+name: Native Parser Providers
+
+on:
+  workflow_dispatch:
+  push:
+    branches: [main]
+    paths:
+      - "src/codecortex/languages/**"
+      - "tests/test_native_parsers.py"
+      - "pyproject.toml"
+      - ".github/workflows/parser-providers.yml"
+  pull_request:
+    paths:
+      - "src/codecortex/languages/**"
+      - "tests/test_native_parsers.py"
+      - "pyproject.toml"
+      - ".github/workflows/parser-providers.yml"
+
+permissions:
+  contents: read
+
+jobs:
+  native-parsers:
+    strategy:
+      fail-fast: false
+      matrix:
+        python-version: ["3.11", "3.13"]
+    runs-on: ubuntu-latest
+    steps:
+      - uses: actions/checkout@3d3c42e5aac5ba805825da76410c181273ba90b1 # v7
+        with:
+          persist-credentials: false
+      - uses: actions/setup-python@5fda3b95a4ea91299a34e894583c3862153e4b97 # v7
+        with:
+          python-version: ${{ matrix.python-version }}
+          cache: pip
+      - run: pip install -e ".[dev,parsers]"
+      - run: pytest -q tests/test_native_parsers.py tests/test_languages.py

codecortex_context_engine-0.1.0a1/.github/workflows/production-benchmark.yml

@@ -0,0 +1,56 @@
+name: Production Benchmark
+
+on:
+  workflow_dispatch:
+  push:
+    branches: [main]
+    paths:
+      - "benchmarks/production/**"
+      - "scripts/run_production_benchmark.py"
+      - "src/codecortex/evaluation/production.py"
+      - "src/codecortex/backends/**"
+      - ".github/workflows/production-benchmark.yml"
+  schedule:
+    - cron: "41 4 * * 0"
+
+permissions:
+  contents: read
+
+jobs:
+  production-benchmark:
+    runs-on: ubuntu-latest
+    timeout-minutes: 120
+    env:
+      CODECORTEX_SOURCE_ROOT: ${{ github.workspace }}
+      CODECORTEX_BACKENDS: builtin
+    steps:
+      - uses: actions/checkout@3d3c42e5aac5ba805825da76410c181273ba90b1 # v7
+        with:
+          persist-credentials: false
+      - uses: actions/setup-python@5fda3b95a4ea91299a34e894583c3862153e4b97 # v7
+        with:
+          python-version: "3.13"
+          cache: pip
+      - name: Install tooling
+        run: |
+          python -m pip install --upgrade pip uv
+          pip install -e ".[dev]"
+      - name: Run benchmark matrix
+        run: python scripts/run_production_benchmark.py --output benchmark-results.json
+      - name: Publish benchmark summary
+        run: |
+          python - <<'PY' >> "$GITHUB_STEP_SUMMARY"
+          import json
+          p=json.load(open('benchmark-results.json', encoding='utf-8'))
+          print('# CodeCortex production benchmark')
+          print('| Scenario | Completed | Success | Avg ms | Avg est. tokens |')
+          print('|---|---:|---:|---:|---:|')
+          for name,row in p.get('summary',{}).items():
+              print(f"| {name} | {row.get('completed')} | {row.get('success_rate')} | {row.get('avg_wall_time_ms')} | {row.get('avg_estimated_context_tokens')} |")
+          PY
+      - uses: actions/upload-artifact@043fb46d1a93c77aae656e7c1c64a875d1fc6a0a # v7
+        with:
+          name: codecortex-production-benchmark-${{ github.sha }}
+          path: benchmark-results.json
+          if-no-files-found: error
+          retention-days: 90