codecortex-context-engine 0.1.0a5__tar.gz → 0.1.0a7__tar.gz

{codecortex_context_engine-0.1.0a5 → codecortex_context_engine-0.1.0a7}/.github/workflows/bootstrap-release.yml

@@ -18,19 +18,19 @@ jobs:
         with:
           fetch-depth: 0
           persist-credentials: true
-      - name: Create v0.1.0a5 release tag from validated main
+      - name: Create v0.1.0a7 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.0a5 >/dev/null; then
-            echo "v0.1.0a5 already exists"
+          if git rev-parse -q --verify refs/tags/v0.1.0a7 >/dev/null; then
+            echo "v0.1.0a7 already exists"
           else
-            git tag -a v0.1.0a5 -m "CodeCortex Context Engine v0.1.0a5"
-            git push origin refs/tags/v0.1.0a5
+            git tag -a v0.1.0a7 -m "CodeCortex Context Engine v0.1.0a7"
+            git push origin refs/tags/v0.1.0a7
           fi
       - name: Dispatch release workflow
         env:
           GH_TOKEN: ${{ github.token }}
-        run: gh workflow run release.yml --ref main -f tag=v0.1.0a5
+        run: gh workflow run release.yml --ref main -f tag=v0.1.0a7

codecortex_context_engine-0.1.0a7/.github/workflows/mcp-registry.yml

@@ -0,0 +1,64 @@
+name: MCP Registry Manifest
+
+on:
+  pull_request:
+    paths:
+      - server.json
+      - pyproject.toml
+      - README.md
+      - scripts/generate_readme.py
+      - .github/workflows/release.yml
+      - .github/workflows/mcp-registry.yml
+  push:
+    branches: [main]
+    paths:
+      - server.json
+      - pyproject.toml
+      - README.md
+      - scripts/generate_readme.py
+      - .github/workflows/release.yml
+      - .github/workflows/mcp-registry.yml
+
+permissions:
+  contents: read
+
+jobs:
+  validate:
+    runs-on: ubuntu-latest
+    steps:
+      - uses: actions/checkout@3d3c42e5aac5ba805825da76410c181273ba90b1 # v7
+        with:
+          persist-credentials: false
+      - name: Verify registry/package identity
+        shell: bash
+        run: |
+          set -euo pipefail
+          python - <<'PY'
+          import json, tomllib
+          from pathlib import Path
+
+          server = json.loads(Path("server.json").read_text(encoding="utf-8"))
+          project = tomllib.loads(Path("pyproject.toml").read_text(encoding="utf-8"))["project"]
+          package = server["packages"][0]
+          expected = "io.github.BehnamJalaliCo/codecortex-context-engine"
+          assert server["name"] == expected
+          assert package["registryType"] == "pypi"
+          assert package["identifier"] == project["name"]
+          assert package["version"] == project["version"] == server["version"]
+          assert f"mcp-name: {expected}" in Path("README.md").read_text(encoding="utf-8")
+          assert "codecortex-context-engine" in project["scripts"]
+          print("CodeCortex MCP registry identity is internally consistent")
+          PY
+      - name: Install verified MCP Registry publisher
+        shell: bash
+        env:
+          MCP_PUBLISHER_VERSION: v1.8.1
+          MCP_PUBLISHER_SHA256: a06c9096dcb9727c13555b6be26c7effa707b01f06a4c561ba7a3635443cf2cc
+        run: |
+          set -euo pipefail
+          archive="mcp-publisher_linux_amd64.tar.gz"
+          curl -fsSL "https://github.com/modelcontextprotocol/registry/releases/download/${MCP_PUBLISHER_VERSION}/${archive}" -o "${archive}"
+          echo "${MCP_PUBLISHER_SHA256}  ${archive}" | sha256sum -c -
+          tar xzf "${archive}" mcp-publisher
+      - name: Validate server.json against official registry schema
+        run: ./mcp-publisher validate server.json

{codecortex_context_engine-0.1.0a5 → codecortex_context_engine-0.1.0a7}/.github/workflows/release.yml

@@ -143,6 +143,45 @@ jobs:
           packages-dir: dist/
           skip-existing: true
 
+
+  publish-mcp-registry:
+    if: vars.PYPI_PUBLISH_ENABLED == 'true'
+    needs: publish-pypi
+    runs-on: ubuntu-latest
+    permissions:
+      contents: read
+      id-token: write
+    steps:
+      - uses: actions/checkout@3d3c42e5aac5ba805825da76410c181273ba90b1 # v7
+        with:
+          persist-credentials: false
+          ref: ${{ env.RELEASE_TAG }}
+      - name: Set registry version from release tag
+        shell: bash
+        run: |
+          set -euo pipefail
+          VERSION="${RELEASE_TAG#v}"
+          jq --arg v "$VERSION" '.version = $v | .packages |= map(if .registryType == "pypi" then .version = $v else . end)' server.json > server.tmp
+          mv server.tmp server.json
+      - name: Install verified MCP Registry publisher
+        shell: bash
+        env:
+          MCP_PUBLISHER_VERSION: v1.8.1
+          MCP_PUBLISHER_SHA256: a06c9096dcb9727c13555b6be26c7effa707b01f06a4c561ba7a3635443cf2cc
+        run: |
+          set -euo pipefail
+          archive="mcp-publisher_linux_amd64.tar.gz"
+          curl -fsSL "https://github.com/modelcontextprotocol/registry/releases/download/${MCP_PUBLISHER_VERSION}/${archive}" -o "${archive}"
+          echo "${MCP_PUBLISHER_SHA256}  ${archive}" | sha256sum -c -
+          tar xzf "${archive}" mcp-publisher
+          ./mcp-publisher --help >/dev/null
+      - name: Validate MCP Registry manifest
+        run: ./mcp-publisher validate server.json
+      - name: Authenticate to official MCP Registry
+        run: ./mcp-publisher login github-oidc
+      - name: Publish MCP Registry metadata
+        run: ./mcp-publisher publish server.json
+
   publish-containers:
     needs: quality
     runs-on: ubuntu-latest

{codecortex_context_engine-0.1.0a5 → codecortex_context_engine-0.1.0a7}/CHANGELOG.md

@@ -2,6 +2,21 @@
 
 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.0a7
+
+- Fixed a Windows lock-directory race in `FileMutex` discovered by the release matrix.
+- Added bounded retry behavior for transient Windows `PermissionError` lock contention.
+- Added a deterministic regression test for the transient permission-error path.
+- Carries forward the GitHub discovery, onboarding, and official MCP Registry publication work from the unreleased `v0.1.0a6` attempt.
+
+## 0.1.0a6
+
+- Reworked GitHub discovery and first-run onboarding for CodeCortex Context Engine.
+- Added official MCP Registry manifest, PyPI ownership marker, manifest validation, and release publishing.
+- Surfaced Claude Code, Codex, Cursor, Gemini CLI, and OpenCode integration setup.
+- Expanded MkDocs navigation, Getting Started, benchmark evidence, launch materials, and discovery documentation.
+- Added contributor-friendly `good first issue` entry points and product/social discovery assets.
+
 ## Unreleased
 
 ### Added

{codecortex_context_engine-0.1.0a5 → codecortex_context_engine-0.1.0a7}/CONTRIBUTING.md

@@ -2,6 +2,12 @@
 
 Thank you for improving CodeCortex. Focused, tested changes are easier to review and safer to release.
 
+## First contribution
+
+Start with the repository's [good first issues](https://github.com/BehnamJalaliCo/CodeCortex/issues?q=is%3Aissue+is%3Aopen+label%3A%22good+first+issue%22). They are intentionally scoped to be reviewable without requiring knowledge of the entire engine.
+
+If an issue is unclear, ask a question on that issue before building a large change. Do not create speculative rewrites for unassigned work.
+
 ## Development
 
 ```bash

{codecortex_context_engine-0.1.0a5 → codecortex_context_engine-0.1.0a7}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.5
 Name: codecortex-context-engine
-Version: 0.1.0a5
+Version: 0.1.0a7
 Summary: Context intelligence infrastructure for AI coding agents
 Project-URL: Homepage, https://github.com/BehnamJalaliCo/CodeCortex
 Project-URL: Repository, https://github.com/BehnamJalaliCo/CodeCortex
@@ -250,9 +250,11 @@ Description-Content-Type: text/markdown
 
 # 🧠 CodeCortex Context Engine
 
-### Context intelligence infrastructure for AI coding agents
+<!-- mcp-name: io.github.BehnamJalaliCo/codecortex-context-engine -->
 
-[![Typing SVG](https://readme-typing-svg.demolab.com?font=JetBrains+Mono&weight=700&size=24&duration=2500&pause=650&center=true&vCenter=true&repeat=true&width=1000&lines=Map+the+repository.;Resolve+the+relationships.;Retrieve+the+right+evidence.;Understand+the+blast+radius.;Change+with+guardrails.;Remember+what+the+team+learned.;Scale+without+hiding+failure.)](https://github.com/BehnamJalaliCo/CodeCortex)
+### Open-source context intelligence infrastructure for AI coding agents
+
+**Map the repository · resolve symbols · retrieve task-specific evidence · estimate impact · edit with guardrails**
 
 [![PyPI](https://img.shields.io/pypi/v/codecortex-context-engine?label=PyPI&logo=pypi)](https://pypi.org/project/codecortex-context-engine/)
 [![Python](https://img.shields.io/pypi/pyversions/codecortex-context-engine?logo=python)](https://pypi.org/project/codecortex-context-engine/)
@@ -262,9 +264,8 @@ Description-Content-Type: text/markdown
 [![OpenSSF Best Practices](https://www.bestpractices.dev/projects/14379/badge)](https://www.bestpractices.dev/projects/14379)
 [![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)
-[![Status](https://img.shields.io/badge/status-alpha-orange.svg)](#project-status)
 
-**Map · Understand · Retrieve · Explain · Impact · Guard · Validate · Remember · Scale**
+[**⭐ 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)
 
 [🇬🇧 English](#english) · [🇮🇷 فارسی](#فارسی)
 
@@ -272,11 +273,88 @@ Description-Content-Type: text/markdown
 
 ---
 
+## Why CodeCortex?
+
+A coding agent can read code. The harder problem is deciding **what matters, what is connected, what can break, and how much context is actually worth sending to the model**.
+
+CodeCortex turns a repository into a query-specific evidence system for coding agents:
+
+- **Repository + symbol intelligence** — structure, definitions, references, dependencies, and call relationships.
+- **Evidence-aware retrieval** — lexical, semantic, structural, graph, Git, architecture, and memory signals are ranked together.
+- **Impact before edits** — reverse dependencies, affected tests, ownership, and change risk are inspectable before mutation.
+- **Guarded changes** — semantic edits and structural rewrite previews keep source boundaries and review steps explicit.
+- **Persistent project context** — architecture, history, project/team memory, traces, and multi-repo workspaces survive beyond one chat.
+
+> **Core rule: retrieve evidence before generating confidence.**
+
+![CodeCortex product overview](docs/assets/codecortex-overview.svg)
+
+## 60-second start
+
+Requires Python 3.11–3.13.
+
+```bash
+python -m pip install --upgrade codecortex-context-engine
+cortex init .
+cortex index
+cortex doctor
+```
+
+Then ask the repository useful questions:
+
+```bash
+cortex architecture
+cortex semantic "authentication and session lifecycle"
+cortex impact AuthService
+```
+
+Or expose the repository to an MCP-capable coding agent:
+
+```bash
+cortex mcp --path .
+```
+
+## Works with coding agents
+
+CodeCortex includes merge-safe project configuration for **Claude Code, Codex, Cursor, Gemini CLI, and OpenCode**.
+
+```bash
+cortex agents detect
+cortex agents configure --dry-run
+# or configure every supported target explicitly:
+cortex agents configure --all
+```
+
+The configurator only manages CodeCortex-owned MCP entries and keeps user-owned configuration intact.
+
+## See it work locally
+
+The repository ships a deterministic demo project and demo runner:
+
+```bash
+python scripts/demo.py
+```
+
+The demo indexes the fixture repository, analyzes the blast radius of `AuthService`, routes an evidence request, and reports measured context/trace data. It does not fabricate benchmark values.
+
+## Reproducible evidence snapshot
+
+These are committed hardening measurements, not generalized performance promises:
+
+| Evidence | Recorded result |
+|---|---:|
+| Hardening test suite | **711 passed, 28 skipped, 0 failed** |
+| Coverage in hardening report | **91.74%** |
+| Warm exact definition lookup | **0.19–0.23 ms median** |
+| Freshness scan across 600 documents | **4.25 ms median** |
+
+See [HARDENING_REPORT.md](HARDENING_REPORT.md) and [benchmarks/](benchmarks/) for scope, methodology, limitations, and reproducibility notes.
+
+---
 
 <a id="english"></a>
 
 # 🇬🇧 English
-
 <div align="center">
 
 ### Give the coding agent a map before asking it to navigate the codebase.

{codecortex_context_engine-0.1.0a5 → codecortex_context_engine-0.1.0a7}/README.md

@@ -2,9 +2,11 @@
 
 # 🧠 CodeCortex Context Engine
 
-### Context intelligence infrastructure for AI coding agents
+<!-- mcp-name: io.github.BehnamJalaliCo/codecortex-context-engine -->
 
-[![Typing SVG](https://readme-typing-svg.demolab.com?font=JetBrains+Mono&weight=700&size=24&duration=2500&pause=650&center=true&vCenter=true&repeat=true&width=1000&lines=Map+the+repository.;Resolve+the+relationships.;Retrieve+the+right+evidence.;Understand+the+blast+radius.;Change+with+guardrails.;Remember+what+the+team+learned.;Scale+without+hiding+failure.)](https://github.com/BehnamJalaliCo/CodeCortex)
+### Open-source context intelligence infrastructure for AI coding agents
+
+**Map the repository · resolve symbols · retrieve task-specific evidence · estimate impact · edit with guardrails**
 
 [![PyPI](https://img.shields.io/pypi/v/codecortex-context-engine?label=PyPI&logo=pypi)](https://pypi.org/project/codecortex-context-engine/)
 [![Python](https://img.shields.io/pypi/pyversions/codecortex-context-engine?logo=python)](https://pypi.org/project/codecortex-context-engine/)
@@ -14,9 +16,8 @@
 [![OpenSSF Best Practices](https://www.bestpractices.dev/projects/14379/badge)](https://www.bestpractices.dev/projects/14379)
 [![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)
-[![Status](https://img.shields.io/badge/status-alpha-orange.svg)](#project-status)
 
-**Map · Understand · Retrieve · Explain · Impact · Guard · Validate · Remember · Scale**
+[**⭐ 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)
 
 [🇬🇧 English](#english) · [🇮🇷 فارسی](#فارسی)
 
@@ -24,11 +25,88 @@
 
 ---
 
+## Why CodeCortex?
+
+A coding agent can read code. The harder problem is deciding **what matters, what is connected, what can break, and how much context is actually worth sending to the model**.
+
+CodeCortex turns a repository into a query-specific evidence system for coding agents:
+
+- **Repository + symbol intelligence** — structure, definitions, references, dependencies, and call relationships.
+- **Evidence-aware retrieval** — lexical, semantic, structural, graph, Git, architecture, and memory signals are ranked together.
+- **Impact before edits** — reverse dependencies, affected tests, ownership, and change risk are inspectable before mutation.
+- **Guarded changes** — semantic edits and structural rewrite previews keep source boundaries and review steps explicit.
+- **Persistent project context** — architecture, history, project/team memory, traces, and multi-repo workspaces survive beyond one chat.
+
+> **Core rule: retrieve evidence before generating confidence.**
+
+![CodeCortex product overview](docs/assets/codecortex-overview.svg)
+
+## 60-second start
+
+Requires Python 3.11–3.13.
+
+```bash
+python -m pip install --upgrade codecortex-context-engine
+cortex init .
+cortex index
+cortex doctor
+```
+
+Then ask the repository useful questions:
+
+```bash
+cortex architecture
+cortex semantic "authentication and session lifecycle"
+cortex impact AuthService
+```
+
+Or expose the repository to an MCP-capable coding agent:
+
+```bash
+cortex mcp --path .
+```
+
+## Works with coding agents
+
+CodeCortex includes merge-safe project configuration for **Claude Code, Codex, Cursor, Gemini CLI, and OpenCode**.
+
+```bash
+cortex agents detect
+cortex agents configure --dry-run
+# or configure every supported target explicitly:
+cortex agents configure --all
+```
+
+The configurator only manages CodeCortex-owned MCP entries and keeps user-owned configuration intact.
+
+## See it work locally
+
+The repository ships a deterministic demo project and demo runner:
+
+```bash
+python scripts/demo.py
+```
+
+The demo indexes the fixture repository, analyzes the blast radius of `AuthService`, routes an evidence request, and reports measured context/trace data. It does not fabricate benchmark values.
+
+## Reproducible evidence snapshot
+
+These are committed hardening measurements, not generalized performance promises:
+
+| Evidence | Recorded result |
+|---|---:|
+| Hardening test suite | **711 passed, 28 skipped, 0 failed** |
+| Coverage in hardening report | **91.74%** |
+| Warm exact definition lookup | **0.19–0.23 ms median** |
+| Freshness scan across 600 documents | **4.25 ms median** |
+
+See [HARDENING_REPORT.md](HARDENING_REPORT.md) and [benchmarks/](benchmarks/) for scope, methodology, limitations, and reproducibility notes.
+
+---
 
 <a id="english"></a>
 
 # 🇬🇧 English
-
 <div align="center">
 
 ### Give the coding agent a map before asking it to navigate the codebase.

{codecortex_context_engine-0.1.0a5 → codecortex_context_engine-0.1.0a7}/SUPPORT.md

@@ -2,7 +2,7 @@
 
 ## Community support
 
-Use GitHub Issues for reproducible bugs and feature requests. Include the CodeCortex version or commit, operating system, Python version, relevant command, expected behavior, and a minimal reproduction when possible.
+Use GitHub Issues for reproducible bugs and feature requests. Include the CodeCortex version or commit, operating system, Python version, relevant command, expected behavior, and a minimal reproduction when possible. New contributors can start from [Good First Issues](https://github.com/BehnamJalaliCo/CodeCortex/issues?q=is%3Aissue+is%3Aopen+label%3A%22good+first+issue%22).
 
 Do not post credentials, private source code, access tokens, or vulnerability details in public issues.
 

codecortex_context_engine-0.1.0a7/docs/BENCHMARKS.md

@@ -0,0 +1,68 @@
+# Benchmarks and Evidence
+
+CodeCortex treats benchmark results as evidence with a scope, revision, methodology, and limitations. Numbers are not generalized beyond what was actually measured.
+
+## Current committed evidence
+
+The Evidence Fusion hardening report records:
+
+| Measurement | Recorded result |
+|---|---:|
+| Hardening test suite | 711 passed, 28 skipped, 0 failed |
+| Repository coverage | 91.74% |
+| Cold real-index import | Python 0.93 ms / TypeScript 0.99 ms median |
+| Warm exact definition lookup | 0.19–0.23 ms median |
+| Warm exact reference lookup | 0.29–0.33 ms median |
+| Unicode caret navigation | 0.18–0.32 ms median |
+| Freshness scan, 600 documents | 4.25 ms median |
+
+These values are hardening-specific measurements on committed fixtures and indexes. They are not promises for arbitrary repositories or machines.
+
+## Evidence-quality benchmark
+
+The same report records three bounded fixture cases:
+
+| Case | Baseline strategy | Evidence strategy |
+|---|---|---|
+| Duplicate symbols | graph heuristic precision 0.50 | precision index 1.00 |
+| Dependency version | source-only 0.00 | dependency intelligence 1.00 |
+| Mechanical migration | lexical scan 0.50 | structural search 1.00 |
+
+The purpose is to demonstrate which evidence layer resolves each controlled ambiguity. It is not a claim that every real-world task improves by the same amount.
+
+## Reproduce local benchmark runs
+
+```bash
+cortex benchmark --path . --cases benchmarks/cases.json --output benchmarks/results.json
+```
+
+Production benchmark tooling uses revision-pinned public repositories:
+
+```bash
+python scripts/run_production_benchmark.py --provision
+```
+
+See [benchmarks/README.md](https://github.com/BehnamJalaliCo/CodeCortex/blob/main/benchmarks/README.md) and [benchmarks/production/README.md](https://github.com/BehnamJalaliCo/CodeCortex/blob/main/benchmarks/production/README.md) in the repository for the exact harness and output fields.
+
+## Real-agent measurements
+
+For an instrumented coding-agent command:
+
+```bash
+python scripts/run_agent_matrix.py --command "./my-instrumented-agent"
+```
+
+Missing provider token counts, cost, files-read telemetry, or other unobserved metrics remain missing. CodeCortex does not infer or invent them.
+
+## Known unavailable evidence
+
+The live dependency-documentation provider remains credential-gated. The hardening report explicitly records its live smoke path as skipped when no credential is configured. Do not interpret that skip as a successful live validation.
+
+## Source of record
+
+For current evidence and caveats, read:
+
+- [HARDENING_REPORT.md](https://github.com/BehnamJalaliCo/CodeCortex/blob/main/HARDENING_REPORT.md)
+- [Quality targets](QUALITY.md)
+- [Testing](TESTING.md)
+- [Release evidence](RELEASE.md)

codecortex_context_engine-0.1.0a7/docs/DISCOVERY_MANUAL_STEPS.md

@@ -0,0 +1,79 @@
+# Discovery Manual Steps
+
+These are repository settings that cannot be changed by the current automation connection. All code/assets needed for them are already prepared in this branch.
+
+## 1. Repository About metadata
+
+Open the CodeCortex repository page and click the **gear icon** next to **About**.
+
+Set description to:
+
+> Open-source context intelligence engine for AI coding agents — repository graph, precise code navigation, MCP, impact analysis, memory, and guarded edits.
+
+Set website to:
+
+`https://behnamjalalico.github.io/CodeCortex/`
+
+Add these topics (GitHub supports up to 20):
+
+- `coding-agents`
+- `ai-agents`
+- `agentic-ai`
+- `mcp`
+- `model-context-protocol`
+- `code-intelligence`
+- `context-engine`
+- `developer-tools`
+- `repository-analysis`
+- `code-search`
+- `semantic-search`
+- `knowledge-graph`
+- `static-analysis`
+- `refactoring`
+- `software-engineering`
+- `llm`
+- `python`
+- `devtools`
+
+## 2. GitHub Discussions
+
+Go to repository **Settings → General → Features** and enable **Discussions**.
+
+Recommended categories:
+
+- Announcements
+- Q&A
+- Ideas
+- Show and tell
+
+After enabling it, replace any temporary issue-only community CTA with the repository Discussions URL.
+
+## 3. Social preview
+
+The source asset is:
+
+`docs/assets/social-preview.svg`
+
+Export it as a 1280×640 PNG, then open repository **Settings → General → Social preview** and upload the PNG.
+
+The preview intentionally contains no partner logos, fake adoption metrics, or unverified claims.
+
+## 4. Glama submission
+
+Submit the public CodeCortex repository to Glama using the canonical metadata in `docs/DISCOVERY_SUBMISSIONS.md`.
+
+## 5. Curated awesome-list PR
+
+Open one PR to the selected maintained MCP awesome list using the exact entry in `docs/DISCOVERY_SUBMISSIONS.md`.
+
+Do not submit duplicate PRs to multiple near-identical forks.
+
+## Completion rule
+
+After these settings are applied, verify the public repository page in a logged-out browser:
+
+- About shows the new description, website, and topics.
+- Discussions tab is visible.
+- Social preview appears when the repository URL is shared.
+- Documentation website opens.
+- Latest release and PyPI links resolve.

codecortex_context_engine-0.1.0a7/docs/DISCOVERY_SUBMISSIONS.md

@@ -0,0 +1,62 @@
+# Discovery Submissions
+
+This file tracks high-signal discovery channels for CodeCortex Context Engine. It intentionally avoids mass directory spam.
+
+## Canonical metadata
+
+- Product: **CodeCortex Context Engine**
+- Repository: https://github.com/BehnamJalaliCo/CodeCortex
+- Documentation: https://behnamjalalico.github.io/CodeCortex/
+- PyPI: `codecortex-context-engine`
+- Install: `python -m pip install --upgrade codecortex-context-engine`
+- MCP transport: stdio
+- MCP command: `cortex mcp --path .`
+- License: Apache-2.0
+- Status: Alpha
+- One-line description: **Open-source context intelligence for AI coding agents: repository graph, precise code navigation, MCP, impact analysis, memory, and guarded edits.**
+
+## 1. Official MCP Registry
+
+Status: **AUTOMATED ON NEXT RELEASE**
+
+The repository contains `server.json`, the PyPI ownership marker in the packaged README, and a release job that validates and publishes the manifest after a successful PyPI publication.
+
+Server name:
+
+`io.github.BehnamJalaliCo/codecortex-context-engine`
+
+Do not mark this channel as published until the release job succeeds and the server can be found in the official Registry.
+
+## 2. Glama
+
+Status: **MANUAL SUBMISSION**
+
+Use the canonical metadata above and submit the public GitHub repository through Glama’s MCP server submission flow.
+
+Recommended description:
+
+> Context intelligence for coding agents: code navigation, repository evidence, impact analysis, memory, and guarded edits through MCP.
+
+Do not claim an official MCP Registry listing until the official publication is live.
+
+## 3. Curated awesome MCP server list
+
+Status: **PR REQUIRED**
+
+Candidate maintained list:
+
+`Sagargupta16/awesome-mcp-servers`
+
+Recommended Developer Tools table entry:
+
+`| [CodeCortex Context Engine](https://github.com/BehnamJalaliCo/CodeCortex) | Context intelligence for AI coding agents with navigation, impact, memory, and guarded edits | Python |`
+
+Before submitting, re-read that repository’s current CONTRIBUTING rules. Use one focused PR and do not cross-post the same change repeatedly.
+
+## Submission policy
+
+- Prefer official registries and maintained curated lists.
+- Do not submit to abandoned directories.
+- Do not create fake accounts, votes, stars, or testimonials.
+- Do not describe CodeCortex as affiliated with agent vendors or MCP maintainers.
+- Keep descriptions consistent with the public repository and current release.