Skip to content

[codex] add QSL architecture governance docs - #169

Merged
Pigbibi merged 2 commits into
mainfrom
codex/qsl-org-architecture-docs
Jul 6, 2026
Merged

[codex] add QSL architecture governance docs#169
Pigbibi merged 2 commits into
mainfrom
codex/qsl-org-architecture-docs

Conversation

@Pigbibi

@Pigbibi Pigbibi commented Jul 6, 2026

Copy link
Copy Markdown
Contributor

Summary

  • Add org-level QSL architecture governance documentation.
  • Update 2026.07.2 CN strategy compat pin and dependency matrix.
  • Add standard QSL architecture role sections to English and Chinese READMEs.

Validation

  • check_internal_dependency_matrix.py --projects-root /Users/lisiyi/Projects --strict
  • qslctl.py check-all --projects-root /Users/lisiyi/Projects --strict
  • python3 -m unittest discover -s python/tests
  • node tests/strategy_switch_worker_validation.mjs

Risk

  • Documentation-only for this repository unless noted above.
  • No secrets, broker credentials, or live order settings are changed.

Co-Authored-By: Codex <noreply@openai.com>
@Pigbibi
Pigbibi enabled auto-merge (squash) July 6, 2026 11:05
@cursor

cursor Bot commented Jul 6, 2026

Copy link
Copy Markdown

Bugbot is not enabled for your account, so this pull request was not reviewed.

Enable Bugbot in the Cursor dashboard to get automatic reviews on future PRs.

@github-actions

github-actions Bot commented Jul 6, 2026

Copy link
Copy Markdown

🤖 Codex PR Review

⚠️ Human review required: The Codex review could not be completed.

No Codex service URL or API key configured. Set CODEX_AUDIT_SERVICE_URL, ANTHROPIC_API_KEY, or OPENAI_API_KEY.

Please ensure a human reviewer checks this PR before merging.

@chatgpt-codex-connector chatgpt-codex-connector Bot left a comment

Copy link
Copy Markdown

Choose a reason for hiding this comment

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

💡 Codex Review

Here are some automated review suggestions for this pull request.

Reviewed commit: 394716bd3d

ℹ️ About Codex in GitHub

Your team has set up Codex to review pull requests in this repo. Reviews are triggered when you

  • Open a pull request for review
  • Mark a draft as ready
  • Comment "@codex review".

If Codex has suggestions, it will comment; otherwise it will react with 👍.

Codex can also answer questions or update the PR. Try commenting "@codex address that feedback".

UsEquityStrategies = "17ddb86c72d44b2c7b78ba7a10d8f71b21180166"
HkEquityStrategies = "b6a8ac2ad3c8110b5ea74fb059c8206388d63bcd"
CnEquityStrategies = "8dfadcf8a4dc6cc516f27a4013248474603d8ce2"
CnEquityStrategies = "73844e92a8570a61e5a9dc6c245809d0b27b89bc"

Copy link
Copy Markdown

Choose a reason for hiding this comment

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

P2 Badge Update the current-baseline CnEquityStrategies SHA

When a consumer follows the repository's current baseline documentation, this new bundle pin conflicts with docs/qsl_compat_upgrade.md:60, which still lists CnEquityStrategies for bundle 2026.07.2 as 8dfadcf8a4dc6cc516f27a4013248474603d8ce2. That doc is presented as the current central compatibility baseline, so users can pin the documented SHA and then fail check_qsl_compat.py against this manifest, which now expects 73844e92a8570a61e5a9dc6c245809d0b27b89bc.

Useful? React with 👍 / 👎.

UsEquityStrategies = "17ddb86c72d44b2c7b78ba7a10d8f71b21180166"
HkEquityStrategies = "b6a8ac2ad3c8110b5ea74fb059c8206388d63bcd"
CnEquityStrategies = "8dfadcf8a4dc6cc516f27a4013248474603d8ce2"
CnEquityStrategies = "73844e92a8570a61e5a9dc6c245809d0b27b89bc"

Copy link
Copy Markdown

Choose a reason for hiding this comment

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

P2 Badge Re-pin QmtPlatform CN strategy refs with the bundle

This new bundle makes 73844e92a8570a61e5a9dc6c245809d0b27b89bc the expected CnEquityStrategies SHA, but internal_dependency_matrix.json still records QmtPlatform's pyproject.toml and uv.lock CN strategy refs as 8dfadcf8a4dc6cc516f27a4013248474603d8ce2 at lines 271-289. The new governance doc says consumer manifests must match declared bundle pins, so publishing the bundle without updating or exceptioning QmtPlatform leaves the CN runtime platform out of compliance and will keep strict workspace checks failing when that repo is present.

Useful? React with 👍 / 👎.

Use the compatibility checker as the repo-level contract gate:

```bash
python3 python/scripts/qslctl.py check --repo-root /path/to/repo

Copy link
Copy Markdown

Choose a reason for hiding this comment

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

P2 Badge Add --strict to the repo gate command

This command is documented as the repo-level contract gate, but qslctl.py check only exits non-zero when --strict is supplied (python/scripts/qslctl.py:378-384). In CI or release scripts that copy this example, a repository with compatibility issues will print a failing result while the command still exits 0, so the intended gate does not block the bad pin.

Useful? React with 👍 / 👎.

Co-Authored-By: Codex <noreply@openai.com>
@cursor

cursor Bot commented Jul 6, 2026

Copy link
Copy Markdown

Bugbot is not enabled for your account, so this pull request was not reviewed.

Enable Bugbot in the Cursor dashboard to get automatic reviews on future PRs.

@Pigbibi
Pigbibi merged commit 63ab3e8 into main Jul 6, 2026
8 checks passed
@Pigbibi
Pigbibi deleted the codex/qsl-org-architecture-docs branch July 6, 2026 11:33
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