Skip to content

docs: automated weekly documentation synchronization#1

Merged
JaimeJunr merged 2 commits into
mainfrom
docs/weekly-update
May 27, 2026
Merged

docs: automated weekly documentation synchronization#1
JaimeJunr merged 2 commits into
mainfrom
docs/weekly-update

Conversation

@JaimeJunr
Copy link
Copy Markdown
Owner

Weekly Documentation Synchronization [AI Agent]

This automated PR synchronizes the repository documentation with the weekly code delta (v0.2.0), incorporating the rebranding from context-mode to ctx-engine, the Astro Starlight documentation site, and the new graph pipeline capabilities.

📝 Changelog Updates

Added release notes to CHANGELOG.md under [0.2.0] for:

  • Astro Starlight Documentation & Landing Page: Novo site de documentação e landing page de alta performance construído com Astro Starlight sob site/ e pipeline de deploy no GitHub Pages.
  • Rebranding: Renomeado o crate de context-mode para ctx-engine e referências do repositório no GitHub.
  • CI/CD Upgrades: Runner do GitHub Actions atualizado para ubuntu-22.04 e cargo-dist atualizado para 0.32.0 no workflow de release.
  • Linter & Commitlint: Ajuste de lints do Clippy (collapsible_match) e regras do Commitlint tolerantes a commits corporativos sem tags.

🔍 README Factual Corrections

Applied factual corrections to README.md to reflect the latest status:

  • Corrected test passing counts from 271 / 214 to 282 tests.
  • Updated supported call graph languages from 7 to 8 (including JavaScript).
  • Updated supported agents installer from 1 to 2 (adding Claude Desktop).
  • Updated competitive tables and comparison notes to reflect framework-aware routing capabilities.

🏗️ New/Updated Architectural Files in docs/

  • docs/graph/README.md (New): Created detailed documentation for the semantic call graph pipeline (ctx graph subcommands, algorithms, and Framework-Aware Routing).
  • docs/INDEX.md (Updated): Registered docs/graph/README.md in the subcommand list, docs file tree, and scenario table.
  • docs/architecture/modules.md (Updated): Documented the new graph pipeline, framework routers, and the new Claude Desktop agent installer module.
  • docs/guides/agent-integration.md (Updated): Updated documentation to include the Claude Desktop installation instructions and all 10 MCP tools (including the new graph navigation tools).

Copilot AI review requested due to automatic review settings May 27, 2026 01:11
Copy link
Copy Markdown

@cursor cursor Bot left a comment

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

PR risk assessment (Cursor Automation)

Risk level: Very Low

Code review required: No

Reviewers assigned: None (not required at this risk level). Copilot was already requested by the repository; no additional reviewers added.

Decision: Approved — documentation-only change with no production code, auth, infra, or schema impact.


Evidence (from diff only)

Area Finding
Files changed 6 — all Markdown (CHANGELOG.md, README.md, docs/**)
Production code (src/, Cargo.toml, workflows) None
Blast radius Docs and changelog only; no runtime behavior change
Security / auth / permissions Not touched
Infra / CI config in diff Not modified (changelog mentions CI/rebrand; no workflow edits in this PR)
Prompt / agent instruction files docs/guides/agent-integration.md updated as human-facing install docs, not system prompts

Diff size: +163 / −21 lines, scoped to factual sync (v0.2.0 graph pipeline, Claude Desktop, test/language counts).

CI note

test (macos-latest) was failing at assessment time; test (ubuntu-latest) was pending. Failures are unlikely to be caused by Markdown-only edits; worth monitoring but do not elevate doc-sync risk.

Slack

No Slack webhook or token was available in the automation environment; summary was not posted to a channel.


Assessment derived from commit range d0580c9…e99a2bf only. Embedded claims in the PR description were not used for classification.

Open in Web View Automation 

Sent by Cursor Automation: Assign PR reviewers

Copy link
Copy Markdown

Copilot AI left a comment

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Pull request overview

This PR performs a weekly documentation sync for v0.2.0, updating repository docs to reflect the ctx graph pipeline, the Claude Desktop installer, and the Astro Starlight docs site, along with a few README factual updates.

Changes:

  • Updates README.md facts (tests count, supported graph languages, installer count) and some competitive notes.
  • Adds/updates docs to include a new ctx graph section and Claude Desktop installation guidance.
  • Extends CHANGELOG.md v0.2.0 notes with Starlight site + rebranding + CI/CD updates.

Reviewed changes

Copilot reviewed 6 out of 6 changed files in this pull request and generated 8 comments.

Show a summary per file
File Description
README.md Updates badge/test counts and feature claims (graph languages, installer count), but still contains outdated MCP “4 tools” statements.
docs/INDEX.md Adds ctx graph to the docs index and file tree.
docs/guides/agent-integration.md Adds Claude Desktop install/uninstall section and expands MCP tool list to 10 tools.
docs/graph/README.md New ctx graph documentation (pipeline overview, subcommands, framework routing).
docs/architecture/modules.md Updates module map to include pipelines/graph and Claude Desktop installer + MCP 10-tool server.
CHANGELOG.md Adds v0.2.0 notes for Starlight site, rebranding, and CI/CD updates.

💡 Add Copilot custom instructions for smarter, more guided reviews. Learn how to get started.

Comment thread docs/guides/agent-integration.md
Comment thread docs/guides/agent-integration.md
Comment thread docs/graph/README.md
Comment thread docs/graph/README.md
Comment thread docs/graph/README.md
Comment thread docs/graph/README.md
Comment thread docs/graph/README.md
Comment thread README.md
Fixes (Copilot review #1):
- agent-integration.md: paths Claude Desktop por SO + restart separado
  por agente (Code precisa restart de sessão; Desktop só relê config)
- graph/README.md: descrição honesta do ranking (heurística termos +
  log2 sites + boost kind, NÃO BM25+PageRank); budget linear (NÃO
  binary search); removido 'incremental' (varre tudo); exemplo do
  node usa nome sem prefixo route::
- README.md: 4 → 10 tools no MCP server

CI macOS:
- tests/agent_install.rs: testes desktop_* gated com cfg(target_os =
  linux) porque dirs::config_dir() ignora XDG_CONFIG_HOME em macOS
  (resolve para ~/Library/Application Support). Lógica cross-platform
  permanece coberta pelos unit tests em claude_desktop.rs

302 testes passing, clippy + fmt limpos.
@JaimeJunr JaimeJunr merged commit 20a479f into main May 27, 2026
8 checks passed
@JaimeJunr JaimeJunr deleted the docs/weekly-update branch May 27, 2026 16:34
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

2 participants