Skip to content

Upgrade repository trust surface and bilingual docs#3

Merged
ToussaintKnight merged 1 commit into
mainfrom
agent/upgrade-repo-trust-surface
Jul 12, 2026
Merged

Upgrade repository trust surface and bilingual docs#3
ToussaintKnight merged 1 commit into
mainfrom
agent/upgrade-repo-trust-surface

Conversation

@ToussaintKnight

Copy link
Copy Markdown
Owner

Summary

Upgrade Codex Sync2 from a technically solid private repository into a release-ready trust surface for agentic engineering.

What changed

  • Reframed the README around the multi-device Codex pain, target user, executable proof, and ecosystem position.
  • Moved the detailed privacy warning below Quick Start and retained a concise security note.
  • Added paired English/Simplified Chinese README, security, contributing, changelog, demo, roadmap, and architecture documents with relative language switchers.
  • Added an architecture diagram explaining the boundary between transport and Codex-semantic safety.
  • Added privacy:scan to reject secrets, private paths, device IDs, private-network IPs, forbidden local-state files, and non-example email addresses.
  • Added docs:check to validate local links, language switchers, heading parity, and fenced-code parity.
  • Updated CI to run the full npm run check gate on Windows, macOS, and Linux.
  • Updated actions/checkout and actions/setup-node to their current Node 24-based major versions.

Why

The repository already had strong implementation and tests, but its first screen led with risk instead of user value, public-facing documentation was English-only, CI had runtime deprecation warnings, and privacy checks were manual rather than reproducible.

Validation

  • npm run privacy:scan — 35 files passed
  • npm run docs:check — 19 Markdown files and 7 language pairs passed
  • npm test — 65 checks passed
  • git diff --check
  • Git author uses the GitHub noreply address

Remaining boundary

The repository remains Private. This improves credibility and launch readiness, but it does not create public GitHub influence until visibility is explicitly changed and a real community launch is authorized.

@ToussaintKnight
ToussaintKnight marked this pull request as ready for review July 12, 2026 03:57
@ToussaintKnight
ToussaintKnight merged commit f64678a into main Jul 12, 2026
3 checks passed
@ToussaintKnight
ToussaintKnight deleted the agent/upgrade-repo-trust-surface branch July 12, 2026 03:57
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.

1 participant