mirror of
https://github.com/diegosouzapw/OmniRoute.git
synced 2026-11-21 15:05:56 +00:00
Compare commits
186 Commits
chore/deri
...
docs/agent
| Author | SHA1 | Date | |
|---|---|---|---|
|
|
b470798f23 | ||
|
|
1771948e1a | ||
|
|
59e3965a8a | ||
|
|
76b26b8ead | ||
|
|
c8688bcd69 | ||
|
|
59bf5d718f | ||
|
|
78a20f38dc | ||
|
|
696498a972 | ||
|
|
4d76573bb1 | ||
|
|
b748429cf5 | ||
|
|
fa2199bde7 | ||
|
|
355eb07c36 | ||
|
|
6f3b810297 | ||
|
|
1bc776ea6c | ||
|
|
186db2e375 | ||
|
|
b254710df1 | ||
|
|
baabf7b423 | ||
|
|
707b0f9757 | ||
|
|
8dd7157b8c | ||
|
|
d7727a7e99 | ||
|
|
492d650774 | ||
|
|
f866adce29 | ||
|
|
4625936608 | ||
|
|
c28fec4e9f | ||
|
|
0d56007238 | ||
|
|
035b02bcd1 | ||
|
|
380b6a7786 | ||
|
|
c0a9ad1553 | ||
|
|
2d62d6440f | ||
|
|
bdf1b3248a | ||
|
|
b2e85375e7 | ||
|
|
a05f32a9a1 | ||
|
|
eec0dbba04 | ||
|
|
bbf2ced076 | ||
|
|
a61261846f | ||
|
|
42f63d548f | ||
|
|
1ec3442acc | ||
|
|
c68f193075 | ||
|
|
07a790f5c1 | ||
|
|
10cff9e8ca | ||
|
|
aee0423c29 | ||
|
|
67e2b79aa3 | ||
|
|
c80b0c1b24 | ||
|
|
b47c4dec93 | ||
|
|
343003808d | ||
|
|
9fef1327bc | ||
|
|
bdd89f3b36 | ||
|
|
14a323a3b8 | ||
|
|
32ba6215a7 | ||
|
|
526a4387ad | ||
|
|
8d4ae3e0ec | ||
|
|
3833e42097 | ||
|
|
760357c44a | ||
|
|
667e8bf086 | ||
|
|
347fa663eb | ||
|
|
763fa9896d | ||
|
|
3924a54945 | ||
|
|
dc51d9ddad | ||
|
|
2f6bdc590a | ||
|
|
5920565793 | ||
|
|
7415ccd084 | ||
|
|
8f56803041 | ||
|
|
0c9e0356f9 | ||
|
|
5855af6172 | ||
|
|
9e4dfa1411 | ||
|
|
cf8baca2eb | ||
|
|
24e8074019 | ||
|
|
632d84f569 | ||
|
|
ded34718eb | ||
|
|
c8c3c306b5 | ||
|
|
fe99346fd5 | ||
|
|
786f6b2318 | ||
|
|
2c886cdf05 | ||
|
|
a9e2ba3459 | ||
|
|
8ce4563356 | ||
|
|
cd90930aab | ||
|
|
1b5dc9b650 | ||
|
|
f8ba9806fc | ||
|
|
a6a6f0ca34 | ||
|
|
442a7c8da2 | ||
|
|
72e9012e92 | ||
|
|
e051b9fd66 | ||
|
|
29dcc9115a | ||
|
|
e64c56e67a | ||
|
|
0fac8c6c7a | ||
|
|
1a0c5a6902 | ||
|
|
3d4ab0b2ca | ||
|
|
13f40a68f6 | ||
|
|
a2ecc10114 | ||
|
|
10e1d1be77 | ||
|
|
89986ee091 | ||
|
|
a05328b926 | ||
|
|
7266f1dd4e | ||
|
|
c594cca68d | ||
|
|
d62a0ce8c2 | ||
|
|
700fcb22f2 | ||
|
|
66da83b5af | ||
|
|
51714c011f | ||
|
|
50ad62a9ad | ||
|
|
5270afefcd | ||
|
|
04264cea50 | ||
|
|
7dc9e0c806 | ||
|
|
2a8675603b | ||
|
|
6911667c26 | ||
|
|
9b4ca56549 | ||
|
|
1068297dc2 | ||
|
|
761ca3ec7a | ||
|
|
37391ca5c5 | ||
|
|
8989742a3e | ||
|
|
bdda4c2e0f | ||
|
|
3735aa9304 | ||
|
|
ef66a01c52 | ||
|
|
a1d3298bb8 | ||
|
|
729f8c44cc | ||
|
|
4e34224ba7 | ||
|
|
36c01108d8 | ||
|
|
15ea600082 | ||
|
|
2ae6770fb5 | ||
|
|
295a31a8a6 | ||
|
|
c09c6f524e | ||
|
|
1339e147b2 | ||
|
|
e97f95598d | ||
|
|
1a81ed6664 | ||
|
|
b29692f9b5 | ||
|
|
16f070422d | ||
|
|
63407581f7 | ||
|
|
d0b69c4548 | ||
|
|
f7dc55db50 | ||
|
|
8761f1c70d | ||
|
|
e66081afa8 | ||
|
|
3bd1513ffd | ||
|
|
039a8807ef | ||
|
|
1a910ce4df | ||
|
|
d99569c275 | ||
|
|
4f59754077 | ||
|
|
fed5dbe257 | ||
|
|
251aa07308 | ||
|
|
98023ecaf9 | ||
|
|
a86a33f7fb | ||
|
|
f51e8cbdb3 | ||
|
|
d28c7ccd0a | ||
|
|
0c02884f2a | ||
|
|
e10ab8d321 | ||
|
|
f9128a1ddb | ||
|
|
17ad4dad93 | ||
|
|
1b74852d79 | ||
|
|
df06001d50 | ||
|
|
30d0dd7183 | ||
|
|
618423e5df | ||
|
|
8f3d93fbd0 | ||
|
|
731e72aa3d | ||
|
|
09173e167c | ||
|
|
e431f17823 | ||
|
|
0aab5edeb4 | ||
|
|
80645477f7 | ||
|
|
e4de8175d9 | ||
|
|
7857556efe | ||
|
|
ac67a3ab46 | ||
|
|
ded449ed40 | ||
|
|
fa5449e69d | ||
|
|
b8e1b3e66c | ||
|
|
61704fba0a | ||
|
|
fe3f990f2a | ||
|
|
9c286a536c | ||
|
|
bdee7aaff4 | ||
|
|
74a1ee515a | ||
|
|
cc910531f4 | ||
|
|
22cf8baa1a | ||
|
|
2456ea6b6b | ||
|
|
11352894d8 | ||
|
|
bc75d0a683 | ||
|
|
51ecc4669e | ||
|
|
0c2266f51f | ||
|
|
bfed0db59f | ||
|
|
56b87f2dc3 | ||
|
|
3a0f1f9749 | ||
|
|
30a0c10e04 | ||
|
|
3c9fe154da | ||
|
|
2fa8083b96 | ||
|
|
3e4bd8818e | ||
|
|
ffdda1e5a2 | ||
|
|
ce7fa60a99 | ||
|
|
7e621d822d | ||
|
|
7ed996ee1d | ||
|
|
8ce5bd184b | ||
|
|
eab177cf7e |
95
.github/workflows/ci.yml
vendored
95
.github/workflows/ci.yml
vendored
@@ -38,6 +38,9 @@ env:
|
||||
# system TLS). Belt-and-suspenders with tests/_setup/isolateDataDir.ts.
|
||||
OMNIROUTE_SKIP_SYSTEM_TRUST: "1"
|
||||
CI_NODE_VERSION: "24"
|
||||
# The V8 manifests require the producer and aggregator to have the same Node
|
||||
# patch. A floating major can resolve to different patch versions on runner caches.
|
||||
CI_V8_NODE_VERSION: "24.22.3"
|
||||
CI_NODE_24_VERSION: "24"
|
||||
CI_NODE_26_VERSION: "26"
|
||||
|
||||
@@ -1172,7 +1175,7 @@ jobs:
|
||||
- uses: actions/setup-node@949feb2413d6458794dcd2491c4babbbce0c15c1 # v7
|
||||
with:
|
||||
package-manager-cache: false
|
||||
node-version: ${{ env.CI_NODE_VERSION }}
|
||||
node-version: ${{ env.CI_V8_NODE_VERSION }}
|
||||
- uses: ./.github/actions/prepare-unit-storage
|
||||
with:
|
||||
cache: ${{ github.event_name == 'pull_request' }}
|
||||
@@ -1192,6 +1195,7 @@ jobs:
|
||||
- name: Unit tests (shard ${{ matrix.shard }}/8) with V8 coverage
|
||||
env:
|
||||
TEST_SHARD: ${{ matrix.shard }}/8
|
||||
TMPDIR: ${{ runner.temp }}/v8-tsx-${{ github.run_id }}-${{ github.run_attempt }}-${{ matrix.shard }}
|
||||
# NODE_OPTIONS (nao so o flag em test:unit:ci:shard) porque quem estoura o
|
||||
# heap e o processo `c8` que embrulha a suite — ele agrega ~577 MB de JSON
|
||||
# de cobertura bruta. Subir o teto so no node filho deixa o pai no default
|
||||
@@ -1201,6 +1205,12 @@ jobs:
|
||||
run: |
|
||||
trap 'status=$?; { df -h "$GITHUB_WORKSPACE" "$RUNNER_TEMP"; du -sh coverage-shard; } || :; exit "$status"' EXIT
|
||||
rm -rf coverage-shard coverage-shard-report
|
||||
# Capture the transforms this producer actually executes; a reused or
|
||||
# shared TSX cache cannot establish generated-layout provenance.
|
||||
node scripts/ci/prepare-v8-coverage.mjs init-cache "$TMPDIR" "$TEST_SHARD" "$GITHUB_SHA" "$GITHUB_RUN_ID" "$GITHUB_RUN_ATTEMPT" "$GITHUB_WORKSPACE"
|
||||
V8_CACHE_PRELOAD="$(node -p 'require("node:url").pathToFileURL(process.argv[1]).href' "$GITHUB_WORKSPACE/scripts/ci/atomic-tsx-cache.mjs")"
|
||||
V8_NATIVE_PRELOAD="$(node -p 'require("node:url").pathToFileURL(process.argv[1]).href' "$GITHUB_WORKSPACE/scripts/ci/native-worker-v8-layout.mjs")"
|
||||
OMNIROUTE_CI_SYNC_TSX_CACHE="$TMPDIR" NODE_OPTIONS="$NODE_OPTIONS --import=$V8_CACHE_PRELOAD --import=$V8_NATIVE_PRELOAD" \
|
||||
npx c8 --merge-async \
|
||||
--temp-directory=coverage-shard \
|
||||
--reports-dir=coverage-shard-report \
|
||||
@@ -1208,11 +1218,23 @@ jobs:
|
||||
--exclude=tests/** \
|
||||
--exclude=**/*.test.* \
|
||||
npm run test:unit:ci:shard
|
||||
- name: Upload raw shard coverage
|
||||
if: always()
|
||||
- name: Package successful shard coverage
|
||||
env:
|
||||
TEST_SHARD: ${{ matrix.shard }}/8
|
||||
TMPDIR: ${{ runner.temp }}/v8-tsx-${{ github.run_id }}-${{ github.run_attempt }}-${{ matrix.shard }}
|
||||
run: node scripts/ci/prepare-v8-coverage.mjs pack coverage-shard coverage-shard-upload "$TEST_SHARD" "$GITHUB_SHA" "$GITHUB_RUN_ID" "$GITHUB_RUN_ATTEMPT" "$GITHUB_WORKSPACE" "$TMPDIR"
|
||||
- name: Upload complete shard coverage
|
||||
uses: actions/upload-artifact@cf430e030ddbb5b0abf93d22962f4752f3646cd9 # v7
|
||||
with:
|
||||
name: coverage-shard-${{ matrix.shard }}
|
||||
name: coverage-shard-${{ github.run_attempt }}-${{ matrix.shard }}
|
||||
path: coverage-shard-upload/
|
||||
compression-level: 0
|
||||
if-no-files-found: error
|
||||
- name: Preserve raw coverage from failed shards
|
||||
if: failure()
|
||||
uses: actions/upload-artifact@cf430e030ddbb5b0abf93d22962f4752f3646cd9 # v7
|
||||
with:
|
||||
name: failed-unit-coverage-${{ github.run_attempt }}-${{ matrix.shard }}
|
||||
path: coverage-shard/*.json
|
||||
if-no-files-found: error
|
||||
|
||||
@@ -1315,6 +1337,9 @@ jobs:
|
||||
# the release gate can still exercise them via workflow_dispatch when needed).
|
||||
test-coverage:
|
||||
name: Coverage
|
||||
permissions:
|
||||
contents: read
|
||||
actions: read
|
||||
runs-on: ubuntu-latest
|
||||
# 10min was sized before #7114 added the lcov reporter (Codecov/Sonar need it);
|
||||
# merging 8 shard JSONs + text+json+lcov now takes ~10-12min — three consecutive
|
||||
@@ -1354,41 +1379,47 @@ jobs:
|
||||
- uses: actions/setup-node@949feb2413d6458794dcd2491c4babbbce0c15c1 # v7
|
||||
with:
|
||||
package-manager-cache: false
|
||||
node-version: ${{ env.CI_NODE_VERSION }}
|
||||
node-version: ${{ env.CI_V8_NODE_VERSION }}
|
||||
- uses: ./.github/actions/npm-ci-retry
|
||||
with:
|
||||
# PR acceleration is not release-candidate provenance.
|
||||
cache: ${{ github.event_name == 'pull_request' }}
|
||||
- name: Select coverage producers for this attempt
|
||||
id: coverage_selection
|
||||
env:
|
||||
GITHUB_TOKEN: ${{ github.token }}
|
||||
run: |
|
||||
mkdir -p coverage
|
||||
node scripts/ci/select-v8-coverage.mjs coverage/coverage-selection.json 8
|
||||
- name: Download all shard coverage
|
||||
uses: actions/download-artifact@9000827ccba6bdab643e8b6fd33ac0654aef8333 # v8
|
||||
with:
|
||||
pattern: coverage-shard-*
|
||||
artifact-ids: ${{ steps.coverage_selection.outputs.artifact_ids }}
|
||||
path: coverage-shards/
|
||||
merge-multiple: true
|
||||
merge-multiple: false
|
||||
- name: Merge + report + gate
|
||||
# Merging 8 shards of raw v8 coverage is memory-heavy. `--merge-async`
|
||||
# keeps the V8 coverage merge incremental instead of loading every raw
|
||||
# JSON blob into one in-memory merge, which avoids Node heap OOMs.
|
||||
# lcov only outside pull_request (2026-10-26): its sole consumer on a PR was the
|
||||
# informational Codecov upload below (SonarQube is off: vars.SONARQUBE_ENABLED is
|
||||
# unset), and the PR gate only needs the json/text summaries. The step took ~21 min
|
||||
# on a measured PR against the org's 20-job hosted cap.
|
||||
# Verify and merge each raw report in order without storing a second
|
||||
# raw copy. c8 reads the aggregate for source mapping and reporting.
|
||||
# lcov on a PR only when SonarQube runs (#20725). #18336 (2026-10-26) dropped it on
|
||||
# pull_request because its only PR consumer was the informational Codecov upload while
|
||||
# SonarQube was off; once vars.SONARQUBE_ENABLED came back the `sonarqube` job scanned
|
||||
# with no coverage/lcov.info and every PR showed 0.0% coverage on new code. Without
|
||||
# Sonar the PR gate still only needs the json/text summaries, so lcov stays skipped.
|
||||
env:
|
||||
NODE_OPTIONS: --max-old-space-size=8192
|
||||
EVENT_NAME: ${{ github.event_name }}
|
||||
SONARQUBE_ENABLED: ${{ vars.SONARQUBE_ENABLED }}
|
||||
RUN_HEAD_SHA: ${{ github.event_name == 'pull_request' && github.event.pull_request.head.sha || github.sha }}
|
||||
run: |
|
||||
LCOV_REPORTER=()
|
||||
if [ "$EVENT_NAME" != "pull_request" ]; then LCOV_REPORTER=(--reporter=lcov); fi
|
||||
if [ "$EVENT_NAME" != "pull_request" ] || [ "${SONARQUBE_ENABLED:-}" = "true" ]; then
|
||||
LCOV_REPORTER=(--reporter=lcov)
|
||||
fi
|
||||
mkdir -p coverage
|
||||
first_coverage_file=""
|
||||
if [ -d coverage-shards ]; then
|
||||
first_coverage_file="$(find coverage-shards -maxdepth 1 -type f -name '*.json' -print -quit)"
|
||||
fi
|
||||
if [ -z "$first_coverage_file" ]; then
|
||||
echo "::error::No raw coverage shard data was downloaded."
|
||||
find . -maxdepth 3 -type f | sort
|
||||
exit 1
|
||||
fi
|
||||
# Retained producers keep their original attempts. The receipt binds all
|
||||
# eight job/artifact identities and the aggregate sent to c8.
|
||||
node scripts/ci/prepare-v8-coverage.mjs prepare coverage-shards coverage-shards-verified 8 "$GITHUB_SHA" "$GITHUB_RUN_ID" "$GITHUB_RUN_ATTEMPT" "$GITHUB_WORKSPACE" coverage/coverage-selection.json "$RUN_HEAD_SHA" "$GITHUB_REPOSITORY" > coverage/coverage-preparation.json
|
||||
cat coverage/coverage-preparation.json
|
||||
# Gate aligned to the project's local coverage bar: `npm run test:coverage`
|
||||
# gates at 60/60/60/60, so CI must match it (the previous CI floor of 40
|
||||
# silently undershot the local bar — a real drift). Real merged coverage is
|
||||
@@ -1396,7 +1427,7 @@ jobs:
|
||||
# coverage ratchet (quality-baseline.json) layers "must not drop vs baseline"
|
||||
# on top of this floor.
|
||||
npx c8 report \
|
||||
--temp-directory coverage-shards \
|
||||
--temp-directory coverage-shards-verified \
|
||||
--reports-dir coverage \
|
||||
--merge-async \
|
||||
--reporter=text-summary \
|
||||
@@ -1406,6 +1437,7 @@ jobs:
|
||||
--exclude=**/*.test.* \
|
||||
--check-coverage \
|
||||
--statements 60 --lines 60 --functions 60 --branches 60
|
||||
node scripts/ci/prepare-v8-coverage.mjs verify-report coverage
|
||||
- name: Build coverage summary
|
||||
if: always()
|
||||
run: |
|
||||
@@ -1456,6 +1488,8 @@ jobs:
|
||||
path: |
|
||||
coverage/coverage-summary.json
|
||||
coverage/coverage-report.md
|
||||
coverage/coverage-selection.json
|
||||
coverage/coverage-preparation.json
|
||||
coverage/lcov.info
|
||||
if-no-files-found: warn
|
||||
|
||||
@@ -1484,6 +1518,17 @@ jobs:
|
||||
with:
|
||||
name: coverage-report
|
||||
path: coverage/
|
||||
# Without lcov.info the scan still "succeeds" and publishes 0.0% coverage on new code
|
||||
# (#20725): fail here, naming the cause, instead of letting the quality gate blame the PR.
|
||||
- name: Require coverage/lcov.info for the scan
|
||||
if: ${{ github.event_name == 'pull_request' && env.SONAR_TOKEN != '' && env.SONAR_HOST_URL != '' }}
|
||||
run: |
|
||||
if [ ! -s coverage/lcov.info ]; then
|
||||
echo "::error::coverage/lcov.info is missing or empty after downloading coverage-report; SonarQube would report 0% coverage on new code. Check the lcov reporter in the test-coverage job's merge step (#20725)."
|
||||
ls -la coverage || true
|
||||
exit 1
|
||||
fi
|
||||
echo "coverage/lcov.info: $(wc -l < coverage/lcov.info) lines"
|
||||
- name: Explain SonarQube skip
|
||||
if: ${{ github.event_name != 'pull_request' || env.SONAR_TOKEN == '' || env.SONAR_HOST_URL == '' }}
|
||||
run: |
|
||||
|
||||
38
.github/workflows/omni-queue.yml
vendored
38
.github/workflows/omni-queue.yml
vendored
@@ -22,7 +22,11 @@ name: omni-queue
|
||||
# • Both jobs run in the `omni-queue` environment, which holds the App's credentials and the
|
||||
# owner's OMNI_QUEUE_LAND_TOKEN and admits the default branch only, by its exact name: a
|
||||
# workflow on a candidate branch cannot read them. The App writes omni-queue/land, the status release rulesets
|
||||
# require, so its private key is the root of trust. The land token reaches the tick only.
|
||||
# require, so its private key is the root of trust. The land token reaches the tick only
|
||||
# (the landing with landing.actor "owner"; the comments, label removals and issues with
|
||||
# config voice "owner"). The owner's merge-commit signing key (OMNI_QUEUE_SIGNING_KEY,
|
||||
# config landing.signing "ssh") reaches one step of the tick, which writes it to a 0600 file
|
||||
# under RUNNER_TEMP; the job's last step removes it, whatever happened.
|
||||
# • action=bless (the explicit emergency exit): the tick writes omni-queue/land on ONE commit
|
||||
# for a hotfix, sync-back or base repair, after checking that both the dispatcher
|
||||
# (github.actor) and whoever triggered the run (github.triggering_actor, the re-runner of a
|
||||
@@ -235,10 +239,35 @@ jobs:
|
||||
echo "name=${login}"
|
||||
echo "email=${id}+${login}@users.noreply.github.com"
|
||||
} >> "$GITHUB_OUTPUT"
|
||||
# config.landing.signing "ssh": the owner's SSH signing key, for the queue's merge commits
|
||||
# (scripts/merge-queue/compose.mjs reads it at compose.signingKeyPath(RUNNER_TEMP) and hands
|
||||
# git the path as per-command configuration, never as an argument). The key exists only in
|
||||
# this step's environment and in a file only the runner user can read; it is never
|
||||
# printed. Without the secret nothing is written and a tick that is asked to sign composes
|
||||
# unsigned, with one `error` event per batch. This step never fails the job: a key it
|
||||
# cannot write is the same case (signing never blocks the queue).
|
||||
- name: Write the merge-commit signing key
|
||||
env:
|
||||
OMNI_QUEUE_SIGNING_KEY: ${{ secrets.OMNI_QUEUE_SIGNING_KEY }}
|
||||
run: |
|
||||
set -uo pipefail
|
||||
if [ -z "${OMNI_QUEUE_SIGNING_KEY:-}" ]; then
|
||||
echo "no merge-commit signing key in the environment: nothing written"
|
||||
exit 0
|
||||
fi
|
||||
umask 077
|
||||
if ! { mkdir -p "$RUNNER_TEMP/omni-queue-signing" \
|
||||
&& chmod 700 "$RUNNER_TEMP/omni-queue-signing" \
|
||||
&& printf '%s\n' "$OMNI_QUEUE_SIGNING_KEY" > "$RUNNER_TEMP/omni-queue-signing/signing-key" \
|
||||
&& chmod 600 "$RUNNER_TEMP/omni-queue-signing/signing-key"; }; then
|
||||
rm -rf "$RUNNER_TEMP/omni-queue-signing"
|
||||
echo "::warning::the merge-commit signing key could not be written: merge commits stay unsigned"
|
||||
fi
|
||||
# Inputs travel through env and are assembled into an argv array: no expression is ever
|
||||
# expanded inside the script body. Scheduled, workflow_run and pull_request_target ticks
|
||||
# pass no base (the tick discovers the bases with work). The owner's land token is used
|
||||
# only by the landing itself when config.landing.actor is "owner" (never printed).
|
||||
# by the landing itself when config.landing.actor is "owner", and by the queue's comments,
|
||||
# label removals and issues when config.voice is "owner" (never printed).
|
||||
# GITHUB_ACTOR and GITHUB_TRIGGERING_ACTOR are the runner's own default variables, named
|
||||
# here because a bless is checked against both: the original dispatcher, whose inputs a
|
||||
# re-run keeps, and whoever triggered this run (the re-runner of a re-run).
|
||||
@@ -265,3 +294,8 @@ jobs:
|
||||
if [ -n "${INPUT_SHA:-}" ]; then args+=(--sha "$INPUT_SHA"); fi
|
||||
fi
|
||||
node scripts/merge-queue/tick.mjs "${args[@]}"
|
||||
# Last step, whatever happened before it (failure, cancellation): the signing key leaves
|
||||
# the runner. Needs no secret; nothing to remove is not an error.
|
||||
- name: Remove the merge-commit signing key
|
||||
if: always()
|
||||
run: rm -rf "$RUNNER_TEMP/omni-queue-signing"
|
||||
|
||||
3046
.i18n-state.json
generated
3046
.i18n-state.json
generated
File diff suppressed because it is too large
Load Diff
167
.mergify.yml
167
.mergify.yml
@@ -1,122 +1,53 @@
|
||||
# Mergify merge queue — WS3.4/D5 of the v3.8.49 quality/velocity master plan.
|
||||
# Mergify — merge queue RETIRED by the owner's decision of 2026-11-19.
|
||||
#
|
||||
# WHY: ~85-100 active PR authors/month and 300+ PRs/week peaks, all merged by ONE
|
||||
# identity. The manual merge-train validated batches by hand; this queue automates
|
||||
# it with batching + automatic batch bisection (a red batch of N costs ~log2(N)
|
||||
# revalidations instead of N). Mergify Open Source plan: free, unlimited, public repo.
|
||||
# History: the Mergify `release` queue (WS3.4/D5 of the v3.8.49 quality/velocity master plan:
|
||||
# owner-applied `queue` label, serial squash, checks_timeout 240 min) and the opt-in
|
||||
# `relay-integration` queue landed release PRs until 2026-11-19 (last Mergify merge: #19538,
|
||||
# 2026-11-15). Their rules, and the rule that removed the `queue` label after a merge, are in
|
||||
# git history. Release PRs are now merged by hand under the repository ruleset "Require green
|
||||
# gates on the active release" (`Gate / CI` + `Gate / Quality`) until omni-queue runs in live
|
||||
# mode, and through omni-queue after that (docs/ops/OMNI_QUEUE.md).
|
||||
#
|
||||
# GOVERNANCE (non-negotiable, mirrors CLAUDE.md Hard Rules #21/#22 + the owner's
|
||||
# pre-merge ⭐ gate):
|
||||
# • A PR enters the queue ONLY via the `queue` label — applied by the owner (or a
|
||||
# session acting for the owner) AFTER the pre-merge ⭐ report/decision. The label
|
||||
# IS the merge approval; Mergify only executes it.
|
||||
# • During a release-freeze (open issue labeled `release-freeze`), do NOT label PRs
|
||||
# targeting the frozen branch — the freeze is a human-honored coordination signal
|
||||
# the queue cannot see. Retarget to the active release/vX+1 first (Hard Rule #21).
|
||||
# • Never label a PR another session is actively working (Hard Rule #22b).
|
||||
# • Fallback path if Mergify misbehaves or the OSS plan changes: the manual
|
||||
# merge-train runbook (docs/ops/MERGE_TRAIN.md) — remove labels, proceed by hand.
|
||||
# WHY this file is kept instead of deleted: the Mergify GitHub App is still installed, and
|
||||
# Mergify documents that "With no Mergify configuration, your queue already ... Merges
|
||||
# automatically when your required checks pass" once someone comments `@mergifyio queue`
|
||||
# (docs.mergify.com/merge-queue/setup). The docs do not say what that command does on a config
|
||||
# without `queue_rules`, so the commands that would merge or rewrite a pull request are
|
||||
# refused here: each condition list below is `closed` AND `-closed`, which no pull request can
|
||||
# match. `commands_restrictions` is read whatever Mergify products are enabled
|
||||
# (docs.mergify.com/configuration/file-format). `refresh` and `dequeue` keep their defaults:
|
||||
# they neither merge nor push.
|
||||
#
|
||||
# Contract: tests/unit/mergify-queue-config.test.ts. Do not add `queue_rules`,
|
||||
# `merge_protections_settings` or a merging `pull_request_rules` action back: two queues would
|
||||
# act on the same release PRs.
|
||||
|
||||
# Auto-enqueue (current Mergify model, 2026): auto_merge_conditions in
|
||||
# merge_protections_settings — the rules-based queue action / autoqueue path is
|
||||
# deprecated (EOL 2026-07-16). The owner-applied `queue` label IS the approval.
|
||||
merge_protections_settings:
|
||||
auto_merge_conditions:
|
||||
- label = queue
|
||||
|
||||
queue_rules:
|
||||
- name: release
|
||||
# Any current or future release branch — the reason GitHub's native queue was
|
||||
# rejected (no wildcard support on personal-account repos).
|
||||
queue_conditions:
|
||||
- base~=^release/v\d+\.\d+\.\d+$
|
||||
- label=queue
|
||||
- -draft
|
||||
- -conflict
|
||||
# A reviewed integration candidate must never be squashed by this queue,
|
||||
# including when its second approval label is missing or its ref changed.
|
||||
- -label=integration-reviewed
|
||||
- -head~=^fix/relay-integration-candidate-
|
||||
# "Everything that ran is green, nothing still running, AND the always-on
|
||||
# anchor check succeeded" — robust to the path-filtered fast-gates (docs-only
|
||||
# PRs skip code jobs; matrix shard names vary) while never fail-open: a PR with
|
||||
# zero checks cannot vacuously merge, because `Merge integrity` runs on EVERY
|
||||
# non-draft PR (quality.yml) and must be an affirmative success. Review approval
|
||||
# is intentionally NOT a condition here: the owner-applied `queue` label IS the
|
||||
# approval in this repo's single-maintainer model (see governance header).
|
||||
merge_conditions:
|
||||
# "Zero failures" — EXCEPT the advisory "Build (advisory)" job (quality.yml):
|
||||
# continue-on-error by design, and its GH-hosted Turbopack build hangs
|
||||
# recurrently mid-"Creating an optimized production build" (100% failure rate
|
||||
# across every sampled PR since the job was added 2026-07-27, always killed by
|
||||
# a runner timeout/shutdown signal, never a real compile error). Any OTHER
|
||||
# failure still blocks (anti-fail-open kept). The prior dast-smoke exception
|
||||
# (#7225) was dropped here: dast-smoke's hang (#7226) has been dormant for
|
||||
# weeks (0 failures in the last 30 runs; 2 all-time, none since 2026-07-13) —
|
||||
# carrying its tolerance forward would mask problems it no longer causes.
|
||||
- or:
|
||||
- "#check-failure=0"
|
||||
- and:
|
||||
- "#check-failure=1"
|
||||
- check-failure=Build (advisory)
|
||||
- "#check-pending=0"
|
||||
- "#check-success>=1"
|
||||
- check-success=Merge integrity (changelog + generated skills)
|
||||
- check-success=Gate / CI
|
||||
- check-success=Gate / Quality
|
||||
# NO batching: 'Merge Queue Batch' requires a paid Mergify tier (live finding
|
||||
# 2026-07-15 — the queue command fails with "Cannot use Merge Queue batch" on
|
||||
# the free plan; #7220). Serial queue (1 PR at a time) still automates the train.
|
||||
# Rail G11 (v3.8.54) asks for batch_size ~5: it stays BLOCKED on that tier —
|
||||
# adding batch_size/batch_max_wait_time here would dequeue EVERY PR again. Do not
|
||||
# re-add them unless the Mergify subscription is upgraded (owner decision).
|
||||
#
|
||||
# checks_timeout = 2 x p95 wall-clock of the quality.yml workflow (the fast-gates
|
||||
# that run on PR -> release/**), measured over the last 100 successful runs
|
||||
# (2026-09-28 .. 2026-10-08, createdAt -> updatedAt, so runner queueing counts):
|
||||
# mean 34.5 min · p50 1.8 min · p90 101.0 min · p95 119.75 min · max 468.6 min
|
||||
# (bimodal: path-filtered docs-only runs ~2 min vs full runs ~72 min median).
|
||||
# 2 x 119.75 = 239.5 -> rounded up to 240 min. A PR whose checks are still
|
||||
# pending past this is dequeued instead of blocking the serial queue forever.
|
||||
# Re-measure with: gh run list --workflow quality.yml --status success
|
||||
# --limit 100 --json createdAt,updatedAt (contract: tests/unit/mergify-queue-config.test.ts).
|
||||
checks_timeout: 240 min
|
||||
# Squash keeps the one-commit-per-PR history the CHANGELOG reconciliation expects.
|
||||
merge_method: squash
|
||||
|
||||
# One already-composed PR, NOT Mergify's paid multi-PR batching feature.
|
||||
# Activation requires this configuration to land on the default branch first.
|
||||
# See docs/ops/RELAY_INTEGRATION_QUEUE.md for ownership, admission and readback.
|
||||
- name: relay-integration
|
||||
queue_conditions:
|
||||
- base=release/v3.8.52
|
||||
- head=fix/relay-integration-candidate-20261015
|
||||
- author=diegosouzapw
|
||||
- label=queue
|
||||
- label=integration-reviewed
|
||||
- -draft
|
||||
- -conflict
|
||||
merge_conditions:
|
||||
- or:
|
||||
- "#check-failure=0"
|
||||
- and:
|
||||
- "#check-failure=1"
|
||||
- check-failure=Build (advisory)
|
||||
- "#check-pending=0"
|
||||
- "#check-success>=1"
|
||||
- check-success=Merge integrity (changelog + generated skills)
|
||||
- check-success=Gate / CI
|
||||
- check-success=Gate / Quality
|
||||
checks_timeout: 240 min
|
||||
# Preserve the reviewed original PR heads; rebasing or squash would lose them.
|
||||
update_method: merge
|
||||
merge_method: merge
|
||||
|
||||
pull_request_rules:
|
||||
- name: clean up the queue label after merge
|
||||
commands_restrictions:
|
||||
queue:
|
||||
conditions:
|
||||
- merged
|
||||
actions:
|
||||
label:
|
||||
remove:
|
||||
- queue
|
||||
- closed
|
||||
- -closed
|
||||
requeue:
|
||||
conditions:
|
||||
- closed
|
||||
- -closed
|
||||
rebase:
|
||||
conditions:
|
||||
- closed
|
||||
- -closed
|
||||
update:
|
||||
conditions:
|
||||
- closed
|
||||
- -closed
|
||||
squash:
|
||||
conditions:
|
||||
- closed
|
||||
- -closed
|
||||
backport:
|
||||
conditions:
|
||||
- closed
|
||||
- -closed
|
||||
copy:
|
||||
conditions:
|
||||
- closed
|
||||
- -closed
|
||||
|
||||
31
AGENTS.md
31
AGENTS.md
@@ -326,12 +326,33 @@ If red: never treat or "fix" the inherited failures in your branch (a base-red f
|
||||
freeze-gated `fix/release-vX.Y.Z-basereds` PR); a PR opened anyway carries
|
||||
`⚠️ base-red inherited: #<issue>` in its body. Full procedure: `docs/ops/WORKTREE_ISOLATION.md`.
|
||||
|
||||
### Sync-back landings are fast-forward, never squash
|
||||
### Landing on a release branch: omni-queue
|
||||
|
||||
A `main → release/vX+1` sync-back lands as the merge commit it already is
|
||||
(`git push origin <head>:refs/heads/release/vX+1`), never squashed — a squash drops `main` from
|
||||
the release ancestry and the next sync-back re-conflicts on every file (551 on v3.8.50 → v3.8.51).
|
||||
After landing, `git merge-base --is-ancestor origin/main origin/release/vX+1` must be true.
|
||||
`release/vX.Y.Z` branches are served by the project's merge queue (runbook:
|
||||
[`docs/ops/OMNI_QUEUE.md`](docs/ops/OMNI_QUEUE.md)). Read its `mode` in
|
||||
`config/merge-queue/config.json` on the default branch before landing anything:
|
||||
|
||||
- **`shadow`** — the queue tests but lands nothing; merges are manual. Green checks on a PR head
|
||||
prove the PR against the base they ran on, not against today's base, so before a manual merge
|
||||
apply the `omni-queue` label at the PR's final head and wait for the queue's verdict on that
|
||||
head (`npm run queue -- why <PR>`, `npm run queue -- history --base <branch>`): `would-land` →
|
||||
merge; `culprit-found` / `would-dequeue` → do not merge, fix first. A merge train whose full CI
|
||||
is green on the current base tip, or a head that already contains the base tip, needs no
|
||||
separate verdict.
|
||||
- **`live`** — the `omni-queue` label is the landing. Never run a merge command or push against
|
||||
the branch: its ruleset refuses both.
|
||||
|
||||
Apply the label only to a PR the owner authorized you to land; a PR that touches a protected path
|
||||
also needs `protected-approved`, which is the owner's decision per PR. Never push to
|
||||
`omni-queue-state` or `omni-queue/**`.
|
||||
|
||||
### Sync-back landings are merge commits, never squash
|
||||
|
||||
A `main → release/vX+1` sync-back lands through a pull request merged with a merge commit
|
||||
(`scripts/release/sync-next-cycle.mjs` opens it; the default branch refuses a direct push), never
|
||||
squashed — a squash drops `main` from the release ancestry and the next sync-back re-conflicts on
|
||||
every file (551 on v3.8.50 → v3.8.51). After landing,
|
||||
`git merge-base --is-ancestor origin/main origin/release/vX+1` must be true.
|
||||
Steps + baseline-freeze check: `docs/ops/WORKTREE_ISOLATION.md` → "Sync-back landings".
|
||||
|
||||
---
|
||||
|
||||
1
changelog.d/features/20294-task-routing-model-scoping.md
Normal file
1
changelog.d/features/20294-task-routing-model-scoping.md
Normal file
@@ -0,0 +1 @@
|
||||
- feat(routing): allow scoping task-aware routing to specific target or excluded models/combos via `targetModels` and `excludedModels` in TaskRoutingConfig (#20294)
|
||||
@@ -0,0 +1 @@
|
||||
- **feat(ci):** omni-queue can speak as the owner and sign its merge commits, both off by default. With `voice: "owner"` in `config/merge-queue/config.json`, the queue's comments and label removals on pull requests, the dashboard issue and its comments, base-red comments and the tree-divergence issue go out with `OMNI_QUEUE_LAND_TOKEN`; statuses, refs, the state branch, re-runs and reads stay the App's, and a missing or refused token falls back to the App with one `error` event. With `landing.signing: "ssh"` (owner actor only), every merge commit the queue composes is signed with the owner's key from the `OMNI_QUEUE_SIGNING_KEY` environment secret, and a missing key composes unsigned with one `error` event per batch ([#20792](https://github.com/cheaper-inference/OmniRoute/pull/20792))
|
||||
1
changelog.d/fixes/0000-v8-coverage-consumer-disk.md
Normal file
1
changelog.d/fixes/0000-v8-coverage-consumer-disk.md
Normal file
@@ -0,0 +1 @@
|
||||
- Merge verified coverage shards in their original reporting order and write a single aggregate for c8, reducing temporary disk use on CI runners.
|
||||
1
changelog.d/fixes/19665-firecrawl-v2-scrape-migration.md
Normal file
1
changelog.d/fixes/19665-firecrawl-v2-scrape-migration.md
Normal file
@@ -0,0 +1 @@
|
||||
- Move the Firecrawl cloud scrape call and the dashboard key probe from `/v1/scrape` to `/v2/scrape` before the 2026-12-10 v1 shutdown (#19636): a CSS `wait_for_selector` becomes a v2 `wait` action, a plain integer becomes the `waitFor` delay in milliseconds (capped at 60000), and `maxDepth` is no longer sent to the cloud endpoint. Self-hosted base URLs stay on `/v1/scrape` with the previous body.
|
||||
@@ -0,0 +1 @@
|
||||
- **fix(providers):** preserve multi-key JSON payloads and solitary thought objects in Gemini leak filter instead of stripping structured responses to 0 chars ([#19805](https://github.com/cheaper-inference/OmniRoute/issues/19805)) — thanks @ctrindade0503
|
||||
@@ -0,0 +1 @@
|
||||
- **fix(translator):** translate Responses `compaction` input items carrying readable content or text into standard Chat messages (assistant summaries keep `output_text` parts) instead of rejecting them. Previously, compaction items without `ocx1:` bridge encryption were rejected with `400 unsupported_feature`, causing combo fallbacks to fail for Responses-native clients. Remote compaction (`compaction_trigger`) still fails explicitly on Chat Completions targets, since they cannot return the required `compaction` output item ([#19730](https://github.com/cheaper-inference/OmniRoute/issues/19730)).
|
||||
1
changelog.d/fixes/19916-specificity-rules-redos.md
Normal file
1
changelog.d/fixes/19916-specificity-rules-redos.md
Normal file
@@ -0,0 +1 @@
|
||||
- **auto-combo**: Count the `import … from`, `SELECT … FROM` and `${…}` code indicators in `detectCodeComplexity` with a linear scan, and stop the `if … then` pattern in `detectReasoningDepth` from backtracking across long whitespace runs, eliminating quadratic backtracking on long lines without dropping long valid spans (#19881)
|
||||
@@ -0,0 +1 @@
|
||||
- **fix(api):** derived model display names drop dash-separated release dates, so `gpt-5-2025-08-07` reads `GPT-5` instead of `GPT-5.2025 08.07`. (fixes #20070) ([#20071](https://github.com/cheaper-inference/OmniRoute/pull/20071))
|
||||
@@ -0,0 +1 @@
|
||||
- **fix(sse):** Consider fallback-excluded accounts with short retryable model lockouts when checking remaining accounts for quota exhaustion, returning the short lockout cooldown instead of a multi-hour quota reset; an excluded account that is in an account cooldown or whose own quota for the model is exhausted is still ignored ([#20084](https://github.com/cheaper-inference/OmniRoute/pull/20084), [#20083](https://github.com/cheaper-inference/OmniRoute/issues/20083)) — thanks @bojackduy and @rafacpti23
|
||||
@@ -0,0 +1 @@
|
||||
- Roll over compact count formatting (`fmtCompact`) to `M` and `B` at rounding boundaries (e.g. 999,950 to `1.0M` and 999,999,999 to `1.0B`) to prevent displaying `1000.0K` or `1000.0M` in analytics and dashboard counts (#20068).
|
||||
@@ -0,0 +1 @@
|
||||
- **fix(gamification):** One XP award (audit row, action counter, level row and the global, weekly and monthly leaderboard scores) is now a single SQLite transaction instead of six separate commits per authenticated request, and a failure part-way no longer leaves XP without a score. ([#20226](https://github.com/cheaper-inference/OmniRoute/pull/20226))
|
||||
1
changelog.d/fixes/20226-usage-rollup-late-rows.md
Normal file
1
changelog.d/fixes/20226-usage-rollup-late-rows.md
Normal file
@@ -0,0 +1 @@
|
||||
- **fix(usage):** A usage row that arrives late for a day the retention job already rolled up and deleted is now added to that day's summary. Before, the next rollup replaced the day's totals with the late row alone and the earlier requests vanished from the analytics. The job records the day it purged to and the highest row id it counted, in one settings row (no migration). ([#20226](https://github.com/cheaper-inference/OmniRoute/pull/20226))
|
||||
1
changelog.d/fixes/20226-usage-write-retry-backoff.md
Normal file
1
changelog.d/fixes/20226-usage-write-retry-backoff.md
Normal file
@@ -0,0 +1 @@
|
||||
- **fix(usage):** A usage row whose write meets a locked database (for example a second writer process on the same file) is now retried on a backoff for about 31 seconds before it is dropped, not once after one second, so a billed request no longer ends with no usage row. ([#20226](https://github.com/cheaper-inference/OmniRoute/pull/20226))
|
||||
1
changelog.d/fixes/20248-cursor-grok-47-standard-speed.md
Normal file
1
changelog.d/fixes/20248-cursor-grok-47-standard-speed.md
Normal file
@@ -0,0 +1 @@
|
||||
- Allow standard-speed Grok 4.7 variants (`medium`, `low`, `xhigh`) and bare effort aliases to use standard speed by omitting `ModelDetails` and setting `reasoning_effort`, preventing Cursor from falling back to `grok-4.7-high-fast` (#20077).
|
||||
@@ -0,0 +1 @@
|
||||
- Skip per-request long-context pricing tier on aggregated window token sums in per-key USD usage limits (`apiKeyUsageLimits.ts`), preventing false threshold trips from overstating spend (~5x) and prematurely blocking keys (#20153).
|
||||
1
changelog.d/fixes/20272-auggie-cli-quiet-flag.md
Normal file
1
changelog.d/fixes/20272-auggie-cli-quiet-flag.md
Normal file
@@ -0,0 +1 @@
|
||||
- **fix(providers):** remove the deprecated `--quiet` flag from the Auggie CLI invocation arguments ([#20250](https://github.com/cheaper-inference/OmniRoute/issues/20250)). Auggie CLI 1.2+ removed the `--quiet` option, which previously caused all requests to fail with `Error: Unknown option: --quiet` and a 502 status code.
|
||||
1
changelog.d/fixes/20449-call-log-worker-win32-url.md
Normal file
1
changelog.d/fixes/20449-call-log-worker-win32-url.md
Normal file
@@ -0,0 +1 @@
|
||||
- **fix(callLogs):** guard call-log artifact worker path resolution when build-time `import.meta.url` is not a valid local file URL on Windows ([#20449](https://github.com/cheaper-inference/OmniRoute/issues/20449))
|
||||
1
changelog.d/fixes/20645-sync-next-cycle-opens-pr.md
Normal file
1
changelog.d/fixes/20645-sync-next-cycle-opens-pr.md
Normal file
@@ -0,0 +1 @@
|
||||
- **fix(release):** `scripts/release/sync-next-cycle.mjs` no longer pushes the sync-back straight to the release branch, which ruleset 21899981 refuses on the default branch: it pushes the merge commit to `chore/sync-back-main-<sha12>` and opens a PR into the release branch (land it as a merge commit), re-runs find the open PR instead of creating another, and the old push stays behind `--direct-push` ([#20645](https://github.com/cheaper-inference/OmniRoute/pull/20645))
|
||||
1
changelog.d/fixes/20770-om-usage-text-account-scope.md
Normal file
1
changelog.d/fixes/20770-om-usage-text-account-scope.md
Normal file
@@ -0,0 +1 @@
|
||||
- Apply the same account rule to the text form of the usage command (`@@om-usage`): keys without `self:account-quota` or a management scope see only their personal quota, and the shared provider accounts are not read for them.
|
||||
@@ -0,0 +1 @@
|
||||
- **fix(security):** Marketplace plugin installs need a management credential in every auth mode, and plugin config writes only accept the keys the plugin declares in its config schema (a plugin without a schema has no writable config)
|
||||
@@ -0,0 +1 @@
|
||||
- **fix(security):** an HTTP 400 counts subscription/plan quota wording ("usage limit reached", "plan limit", weekly/session usage limits) as quota exhaustion only when the structured error code is a credit/quota code or the provider documents a message-only 400 form (`command-code`, `bai`, `openai-compatible-*`), the same contract as #20567, so such a phrase echoed from the request no longer puts a shared LLM or search connection on hold
|
||||
1
changelog.d/fixes/20819-operator-only-path-roots.md
Normal file
1
changelog.d/fixes/20819-operator-only-path-roots.md
Normal file
@@ -0,0 +1 @@
|
||||
- **fix(security):** Choosing the local corpus root (`POST /api/settings/local-corpus`) or the Obsidian WebDAV vault (`POST /api/settings/obsidian/webdav`) now needs a dashboard session or the local CLI: API keys and access tokens of any scope get 403. Both routes also refuse the filesystem root, the home directory itself and system directories (`/etc`, `/usr`, `/bin`, `/sbin`, `/var`, `/proc`, `/sys`, `/dev`, `/boot`, `/root`) with a fixed 400 (CodeQL #1371, #1372, #1373)
|
||||
@@ -0,0 +1 @@
|
||||
- **fix(security):** The internal chat admission bypass and the internal upstream-start cap are granted only on a per-process token held in memory; the deployment env key (`OMNIROUTE_API_KEY` / `ROUTER_API_KEY`) still authenticates requests but no longer marks them as internal
|
||||
1
changelog.d/fixes/20824-media-poll-clamp-syntx-rules.md
Normal file
1
changelog.d/fixes/20824-media-poll-clamp-syntx-rules.md
Normal file
@@ -0,0 +1 @@
|
||||
- **fix(security):** Image generation on NanoBanana, Magnific, Black Forest Labs and RenderHour caps a caller's `poll_interval_ms` at 30 s and `timeout_ms` / `poll_timeout_ms` at 10 minutes (defaults unchanged), and RenderHour stops waiting between polls when the request is aborted; SYNTX provider rules only run for names defined in the rules table, so an `ai_name` such as `constructor` or `__proto__` no longer reaches an inherited `Object.prototype` member (CodeQL #1389, #1392) ([#20824](https://github.com/cheaper-inference/OmniRoute/pull/20824))
|
||||
1
changelog.d/fixes/pending-v8-shard-evidence.md
Normal file
1
changelog.d/fixes/pending-v8-shard-evidence.md
Normal file
@@ -0,0 +1 @@
|
||||
- **fix(ci):** Preserve all eight V8 coverage shards with lossless transport, verified manifests and explicit checkout-path relocation before the native c8 report. Bind generated TSX code and source maps from exclusive producer caches before projecting a proven filename layout, and archive the preparation receipt. Support partial reruns by selecting successful producer jobs and immutable artifact IDs while retaining their original attempts. Reject incomplete, duplicate, corrupted or unproven evidence and empty coverage without changing coverage thresholds.
|
||||
@@ -0,0 +1 @@
|
||||
- **test(providers):** regression tests for the Cloudflare Workers AI "Check" button sending the Account ID to `/api/providers/validate` (#19304, fixed in #19384) ([#19851](https://github.com/cheaper-inference/OmniRoute/pull/19851)) — thanks @rafacpti23
|
||||
1
changelog.d/maintenance/20616-retire-mergify-queue.md
Normal file
1
changelog.d/maintenance/20616-retire-mergify-queue.md
Normal file
@@ -0,0 +1 @@
|
||||
- **chore(ci):** retire the Mergify merge queue: `.mergify.yml` drops the `release` and `relay-integration` queues, the auto-merge label condition and the label-cleanup rule, and refuses the Mergify commands that merge or rewrite a pull request; rail gate G11 of `release:dry-run-lts-cut` now checks omni-queue (valid config, release branch managed, mode `live`, label present) ([#20616](https://github.com/cheaper-inference/OmniRoute/pull/20616))
|
||||
1
changelog.d/maintenance/20769-sonar-lcov.md
Normal file
1
changelog.d/maintenance/20769-sonar-lcov.md
Normal file
@@ -0,0 +1 @@
|
||||
- **fix(ci):** SonarCloud gets `coverage/lcov.info` on pull requests again — the coverage merge skipped the lcov reporter on PRs since #18336, so every PR showed 0.0% coverage on new code; the SonarQube job now also fails clearly when the file is missing ([#20769](https://github.com/cheaper-inference/OmniRoute/pull/20769))
|
||||
@@ -14,7 +14,8 @@
|
||||
"name": "diegosouzapw",
|
||||
"email": "8016841+diegosouzapw@users.noreply.github.com"
|
||||
},
|
||||
"statusContext": "omni-queue/land"
|
||||
"statusContext": "omni-queue/land",
|
||||
"signing": "none"
|
||||
},
|
||||
"requiredChecks": [
|
||||
"Gate / CI",
|
||||
@@ -51,5 +52,6 @@
|
||||
"config/merge-queue/**",
|
||||
".mergify.yml"
|
||||
],
|
||||
"mode": "shadow"
|
||||
"mode": "shadow",
|
||||
"voice": "app"
|
||||
}
|
||||
|
||||
@@ -1,6 +1,7 @@
|
||||
{
|
||||
"_comment": "Allowlist anti-slopsquatting (check-deps.mjs). Toda dep nova exige adicao EXPLICITA aqui apos verificar que e legitima.",
|
||||
"_justifications": {
|
||||
"@bcoe/v8-coverage": "V8 coverage report utilities (bcoe/v8-coverage), pinned at 1.0.2 for the development-only shard aggregation in PR #20515. The npm tarball and SHA-512 integrity match the existing transitive c8 dependency on both base branches.",
|
||||
"@msgpack/msgpack": "Official MessagePack JavaScript implementation (msgpack/msgpack-javascript, ISC), required by Fal's documented specialized realtime protocol. Version 3.1.3 name, repository, license and SHA-512 tarball integrity verified against the npm registry on 2026-11-03 for PR #18849; no additional runtime dependency is introduced by this correction.",
|
||||
"@agentclientprotocol/sdk": "Official Agent Client Protocol TypeScript SDK (agentclientprotocol/typescript-sdk, Apache-2.0). Exact 1.4.0 registry tarball and integrity verified for the registered native Gemini ACP launcher.",
|
||||
"@fontsource/ibm-plex-mono": "Self-hosted Keak type ramp for the vendored CI UI Kit (fontsource, OFL fonts; same no-CDN reasoning as Material Symbols #3695). KEA-7886 — CI UI Kit runtime dependency.",
|
||||
@@ -34,6 +35,7 @@
|
||||
"@atjsh/llmlingua-2",
|
||||
"@aws-sdk/client-bedrock-runtime",
|
||||
"@axe-core/playwright",
|
||||
"@bcoe/v8-coverage",
|
||||
"@cyclonedx/cyclonedx-npm",
|
||||
"@dnd-kit/core",
|
||||
"@dnd-kit/sortable",
|
||||
|
||||
@@ -157,12 +157,13 @@
|
||||
"dedicatedGate": true
|
||||
},
|
||||
"codeqlAlerts": {
|
||||
"value": 6,
|
||||
"value": 103,
|
||||
"direction": "down",
|
||||
"dedicatedGate": true,
|
||||
"_rebaseline_2026_08_06_base_grew": "Base branch file-size drift: translator-openai-to-gemini.test.ts grew 1619->1622 (test assertions for Gemini translator compatibility). CodeQL alert (js/insufficient-password-hash in raycast.ts) is pre-existing base-red; incremented baseline to match.",
|
||||
"_rebaseline_2026_08_10_9940_fingerprint": "CodeQL base-red (green-prs sweep, issue #9985): 2nd js/insufficient-password-hash alert at src/shared/middleware/chatBodyAdmission.ts:265,269 introduced by #9940 (per-connection virtual admission lanes). Both are API-key/bearer FINGERPRINTS (createHash('sha256') truncated to 16-hex admission-lane key), not password VERIFICATION — false-positive class for this rule. Reproduces on release/v3.8.50 tip. Owner-authorized rebaseline 1->2; revisit at v3.9.0.",
|
||||
"_rebaseline_2026_08_11_merge_storm_drift": "2 -> 9. Drift from the 2026-08-11 authorized merge storm (99 PRs into release/v3.8.50): js/insufficient-password-hash in open-sse/executors/chatgpt-web-codex/storageState.ts x3 + conol-web.ts (PRs #8949/#8974 — Chromium browser-profile credential storage SKUs that CodeQL flags under the password-hash rule; same fingerprint/credential-cache false-positive class already rebaselined in #9940/2026-08-06), js/stack-trace-exposure (chatgpt-web-codex.ts, #8949 debug logging), js/double-escaping (environment.ts, #8949), js/insecure-randomness (tinycms.ts, #9435). None introduced by this base-fix PR. Owner-authorized rebaseline (2026-08-11); revisit hardening at v3.9.0."
|
||||
"_rebaseline_2026_08_11_merge_storm_drift": "2 -> 9. Drift from the 2026-08-11 authorized merge storm (99 PRs into release/v3.8.50): js/insufficient-password-hash in open-sse/executors/chatgpt-web-codex/storageState.ts x3 + conol-web.ts (PRs #8949/#8974 — Chromium browser-profile credential storage SKUs that CodeQL flags under the password-hash rule; same fingerprint/credential-cache false-positive class already rebaselined in #9940/2026-08-06), js/stack-trace-exposure (chatgpt-web-codex.ts, #8949 debug logging), js/double-escaping (environment.ts, #8949), js/insecure-randomness (tinycms.ts, #9435). None introduced by this base-fix PR. Owner-authorized rebaseline (2026-08-11); revisit hardening at v3.9.0.",
|
||||
"_rebaseline_2026_11_20_codeql_2_27_5": "6 -> 103. Tool upgrade, not code: the default setup moved CodeQL 2.27.4 -> 2.27.5 on 2026-11-20 and the release/v3.8.55 JS analysis went 236 -> 339 results with the same 87 rules (760357c4 only touched a test file). 101 alerts were created together at 14:07:12Z (path-injection 34, polynomial-redos 30, request-forgery 22, unvalidated-dynamic-method-call 6, regex-injection 6, resource-exhaustion 3). Owner-authorized temporary ceiling (2026-11-20) to unblock merges while the security wave triages them (dismiss false positives with justification, fix real defects); a follow-up PR lowers the value to the measured count."
|
||||
},
|
||||
"secretFindings": {
|
||||
"_note": "Zeroed 2026-07-13 (WS6/D3): the 3 frozen generic-api-key FPs are allowlisted with justification in .gitleaks.toml — any NEW finding regresses the ratchet.",
|
||||
|
||||
@@ -348,5 +348,6 @@
|
||||
"@omniroute/opencode-plugin/tests/log-level.test.ts": "the v1 plugin no longer fetches /api/combos/auto on refresh; the retired fetcher 404 test and its import are removed with the source (21 to 19). Remaining level coverage unchanged.",
|
||||
"@omniroute/opencode-plugin/tests/config-shim.test.ts": "the v1 plugin no longer fetches /api/combos/auto on refresh; the retired twin-wins case and its fixtures are removed with the static publication block (162 to 159). Remaining builder coverage unchanged.",
|
||||
"tests/unit/stepfun-mono-fallback-and-sidebar-hydration-7743.test.ts": "ec27d84e (KEA-7886, F4, 2026-10-21): the legacy DashboardLayout and its synchronous localStorage collapse initializer were removed; the one dropped assert pinned that initializer. The replacement block pins the kit shell contract instead: no localStorage read in the layout files and the server passing the ci_sidebar_state cookie as sidebarDefaultOpen (3 new asserts in place of the old structure). Net count 9 -> 8 is the realignment, not a weakening. Release-green base-red #17219 (2026-10-24).",
|
||||
"tests/unit/ui/rtl-logical-classes.test.tsx": "ec27d84e (KEA-7886, F4, 2026-10-21): the legacy mobile sidebar drawer (.dashboard-sidebar-mobile, start-0/-translate-x-full RTL rules) was removed with the legacy shell; its six drawer cases were replaced by the Kit shell block in the same file, which asserts the kit Sidebar Sheet anchoring by side. Net 21 -> 19 is the realignment, not a weakening. Release-green base-red #17219 (2026-10-24)."
|
||||
"tests/unit/ui/rtl-logical-classes.test.tsx": "ec27d84e (KEA-7886, F4, 2026-10-21): the legacy mobile sidebar drawer (.dashboard-sidebar-mobile, start-0/-translate-x-full RTL rules) was removed with the legacy shell; its six drawer cases were replaced by the Kit shell block in the same file, which asserts the kit Sidebar Sheet anchoring by side. Net 21 -> 19 is the realignment, not a weakening. Release-green base-red #17219 (2026-10-24).",
|
||||
"tests/unit/mergify-queue-config.test.ts": "PR #20616 (2026-11-19): the owner retired the Mergify merge queue, so .mergify.yml no longer carries queue_rules, merge_protections_settings or pull_request_rules. The 10 tests that pinned the release and relay-integration queue rules (squash method, label/draft/conflict conditions, the fail-closed anchor check, paid-tier and deprecated keys, integration routing and admission) have no surface left to assert. They are replaced by 5 tests of what remains: the file holds only commands_restrictions, no queue or auto-merge key exists, each of the 7 commands that merge or rewrite a pull request keeps an unsatisfiable condition list, and the two rules that outlive Mergify (checks timeout >= 2x the measured quality.yml p95; Gate / CI, Gate / Quality and Merge integrity required) are now asserted against omni-queue's config. The replacement queue's own admission contract is pinned in tests/unit/merge-queue/. Net 28 -> 11 is a retired surface, not a weakening. Prune after v3.8.55 merges to main."
|
||||
}
|
||||
|
||||
@@ -47,6 +47,12 @@ separate administrative change; adding these jobs does not itself protect a bran
|
||||
|
||||
### Merge queue
|
||||
|
||||
> **2026-11-19: the Mergify merge queue is retired** (owner's decision). `.mergify.yml` no
|
||||
> longer defines a queue and refuses the Mergify commands that merge or rewrite a pull request.
|
||||
> Release PRs are merged by hand under the repository ruleset "Require green gates on the active
|
||||
> release" (`Gate / CI` + `Gate / Quality`) until omni-queue runs in live mode, and through
|
||||
> omni-queue after that ([OMNI_QUEUE.md](../ops/OMNI_QUEUE.md)). The workflow handling of Mergify drafts described below is still in `ci.yml` and `quality.yml`, but no Mergify draft is opened any more.
|
||||
|
||||
The `queue` label sends a PR to the Mergify queue (`.mergify.yml`). Mergify opens a draft PR on
|
||||
a `mergify/merge-queue/` branch, CI runs the full selection there, and the original PR merges
|
||||
when `Gate / CI`, `Gate / Quality` and `Merge integrity (changelog + generated skills)` pass.
|
||||
|
||||
@@ -92,18 +92,19 @@ All endpoints require management auth (`requireManagementAuth`) **and** are
|
||||
loopback-only — `/api/plugins` and `/api/plugins/` are listed in
|
||||
`LOCAL_ONLY_API_PREFIXES` (`src/server/authz/routeGuard.ts`).
|
||||
|
||||
| Endpoint | Method | Description |
|
||||
| -------------------------------- | ------ | --------------------------------------------------- |
|
||||
| `/api/plugins` | GET | List installed plugins (optional `?status=` filter) |
|
||||
| `/api/plugins` | POST | Install a plugin from the plugin sources directory |
|
||||
| `/api/plugins/scan` | POST | Scan the plugin directory and register new plugins |
|
||||
| `/api/plugins/marketplace` | GET | List marketplace catalog entries |
|
||||
| `/api/plugins/[name]` | GET | Get installed plugin details |
|
||||
| `/api/plugins/[name]` | DELETE | Uninstall a plugin |
|
||||
| `/api/plugins/[name]/activate` | POST | Activate (load + register hooks) |
|
||||
| `/api/plugins/[name]/deactivate` | POST | Deactivate (fire `onDeactivate`, unregister hooks) |
|
||||
| `/api/plugins/[name]/config` | GET | Get plugin config + config schema |
|
||||
| `/api/plugins/[name]/config` | PUT | Update plugin config (validated against schema) |
|
||||
| Endpoint | Method | Description |
|
||||
| ---------------------------------- | ------ | --------------------------------------------------- |
|
||||
| `/api/plugins` | GET | List installed plugins (optional `?status=` filter) |
|
||||
| `/api/plugins` | POST | Install a plugin from the plugin sources directory |
|
||||
| `/api/plugins/scan` | POST | Scan the plugin directory and register new plugins |
|
||||
| `/api/plugins/marketplace` | GET | List marketplace catalog entries |
|
||||
| `/api/plugins/marketplace/install` | POST | Install a marketplace plugin by name |
|
||||
| `/api/plugins/[name]` | GET | Get installed plugin details |
|
||||
| `/api/plugins/[name]` | DELETE | Uninstall a plugin |
|
||||
| `/api/plugins/[name]/activate` | POST | Activate (load + register hooks) |
|
||||
| `/api/plugins/[name]/deactivate` | POST | Deactivate (fire `onDeactivate`, unregister hooks) |
|
||||
| `/api/plugins/[name]/config` | GET | Get plugin config + config schema |
|
||||
| `/api/plugins/[name]/config` | PUT | Update plugin config (validated against schema) |
|
||||
|
||||
The `GET /api/plugins` `status` filter accepts one of
|
||||
`installed` / `active` / `inactive` / `error`. An invalid value returns `400`.
|
||||
@@ -137,7 +138,8 @@ the response is `201` with the installed plugin row.
|
||||
|
||||
Unlike the other plugin routes, this one requires the management credential (a
|
||||
dashboard session or a manage-scoped API key) even when login is disabled
|
||||
(`requireLogin=false`): installing code is never an anonymous action.
|
||||
(`requireLogin=false`): installing code is never an anonymous action. The same
|
||||
applies to `POST /api/plugins/marketplace/install` (body `{ "name": "<plugin>" }`).
|
||||
|
||||
### Browse the marketplace
|
||||
|
||||
@@ -155,10 +157,13 @@ curl -X PUT http://localhost:20128/api/plugins/my-plugin/config \
|
||||
-d '{ "config": { "level": "debug", "maxItems": 100 } }'
|
||||
```
|
||||
|
||||
`PUT .../config` validates each provided value against the plugin's
|
||||
`configSchema` (declared in the manifest): `number` fields honor `min`/`max`,
|
||||
`select` fields must match the declared `enum`. Keys not present in the schema
|
||||
are allowed through.
|
||||
`PUT .../config` validates the body against the plugin's `configSchema`
|
||||
(declared in the manifest) with `validatePluginConfig()` from
|
||||
`src/lib/plugins/manifest.ts`: every key must be declared in the schema, values
|
||||
must match the declared type, `number` fields honor `min`/`max`, and `select`
|
||||
fields must match the declared `enum`. Any violation returns `400` and nothing is
|
||||
stored. A plugin that declares no `configSchema` has no configurable keys, so the
|
||||
request is refused with `400` ("Plugin does not declare any configurable keys").
|
||||
|
||||
## Configuration
|
||||
|
||||
|
||||
@@ -19,16 +19,18 @@
|
||||
|
||||
### የእጩዎች መግቢያ
|
||||
|
||||
CI እና የጥራት ጌትስ የስራ ፍሰቶች እያንዳንዳቸው የተረጋጋ ብይን ይሰጣሉ `Gate / CI` እና `Gate / Quality`. የእነርሱ ስሪት ያለው የመግቢያ ፖሊሲ እንደ አስፈላጊነቱ ወይም እንደ ምክር ሁሉንም የወራጅ ስራዎችን ይዘረዝራል። የሚመለከተው አስፈላጊ ሥራ ሊሳካለት ይገባል፡ የጠፋ፣ የተሰረዘ፣ የተዘለለ፣ በመጠባበቅ ላይ እና ያልታወቁ ውጤቶች PASS መመስረት አይችሉም። የሚሰራ ሰነዶች-ብቻ ወይም ካታሎግ-ብቻ ምደባ የኮድ መስመርን የማይተገበር ያደርገዋል። ረቂቅ PR ተቀባይነት ያለው እጩ አይደለም። የ `hotfix` መለያ ማስረጃን አይተውም።
|
||||
CI እና የጥራት ጌትስ የስራ ፍሰቶች እያንዳንዳቸው የተረጋጋ ብይን ይሰጣሉ `Gate / CI` እና `Gate / Quality`. የእነርሱ ስሪት ያለው የመግቢያ ፖሊሲ እንደ አስፈላጊነቱ ወይም እንደ ምክር ሁሉንም የወራጅ ስራዎችን ይዘረዝራል። የሚመለከተው አስፈላጊ ሥራ ስኬታማ መሆን አለበት፡ ጠፍቷል፣ የተሰረዘ፣ የተዘለለ፣ በመጠባበቅ ላይ እና ያልታወቁ ውጤቶች PASS መመስረት አይችሉም። የሚሰራ ሰነዶች-ብቻ ወይም ካታሎግ-ብቻ ምደባ የኮድ መስመርን የማይተገበር ያደርገዋል። ረቂቅ PR ተቀባይነት ያለው እጩ አይደለም። የ `hotfix` መለያ ማስረጃን አይተውም።
|
||||
|
||||
ሁለቱም የስራ ፍሰቶች PRs ወደ main/release ቅርንጫፎች ይሸፍናሉ፣ ወደ `main` ይገፋሉ፣ በእጅ መላኪያ እና የቡድን ውህደት ክስተቶች። ሙሉ ምርጫውን ይግፉ፣ ይላኩ እና ያዋህዱ። ወደ `release/**` የሚገፋፉ አይጀምራቸውም (2026-10-18)፡ እያንዳንዱ ለውጥ ማትሪክስ ቀድሞውንም በ PR ላይ ሰርቷል እና የተዋሃደው ጥምር የልቀት-አረንጓዴ ስራ ነው (`docs/ops/RUNNER_BOX.md` → የሚስተናገድ ሌይን)። ሹካ እና የተዋሃዱ ቡድኖች በራሳቸው የሚስተናገዱ ሯጮችን ለሚመርጡ ስራዎች የተስተናገዱ ሯጮችን ይጠቀማሉ። ከታቀደው ልቀት በፊት በቂ የተስተናገደ አቅም መረጋገጥ አለበት።
|
||||
|
||||
አንድ ተራ PR ፈጣን ምርጫን ያካሂዳል. የ `full-code` እና `full-code-e2e` የመግቢያ ፖሊሲ መስመሮች (E2E፣ ውህደት፣ የጥቅል ቅርስ፣ Electron ጭስ፣ Bun SQLite፣ ምህዳር እና ፕሮቶኮል ደንበኞች) በ Mergify ወረፋ ረቂቅ ወይም ሙሉ ሩጫ ላይ ብቻ ይሰራሉ `gh workflow run ci.yml --ref <branch>`.
|
||||
|
||||
እያንዳንዱ JSON ደረሰኝ ተመዝግቦ የወጣውን SHA፣ የስራ ሂደትን እና ሙከራን ይለያል። CLI የ checkout/event SHA አለመዛመድን ውድቅ ያደርጋል። የስራ ፍሰት ሙከራዎች የፖሊሲ አባልነትን ከፍርዱ ስራ `needs` ዝርዝር ጋር ስለሚያቆራኙ አዲስ ወይም የተወገደ መስመር በፀጥታ ሊጠፋ አይችልም። ደረሰኞቹ የራሳቸውን የስራ ሂደት ይሸፍናሉ እንጂ ማተምን፣ ማሰማራትን ወይም ነባር የአማካሪ ስካነርን ውስጣዊ ነገሮች አይሸፍኑም። በቅርንጫፍ ደንቦች ውስጥ ሁለቱንም የቼክ ስሞች ማግበር የተለየ አስተዳደራዊ ለውጥ ነው; እነዚህን ስራዎች መጨመር እራሱን ቅርንጫፍ አይከላከልም.
|
||||
እያንዳንዱ JSON ደረሰኝ ተመዝግቦ የወጣውን SHA፣ የስራ ሂደትን እና ሙከራን ይለያል። CLI የ checkout/event SHA አለመዛመድን ውድቅ ያደርጋል። የስራ ፍሰት ሙከራዎች የፖሊሲ አባልነትን ከፍርዱ ስራ `needs` ዝርዝር ጋር ስለሚያቆራኙ አዲስ ወይም የተወገደ መስመር በፀጥታ እንዳይጠፋ። ደረሰኞቹ የራሳቸውን የስራ ሂደት ይሸፍናሉ እንጂ ማተምን፣ ማሰማራትን ወይም ነባር የአማካሪ ስካነርን ውስጣዊ ነገሮች አይሸፍኑም። በቅርንጫፍ ደንቦች ውስጥ ሁለቱንም የቼክ ስሞች ማግበር የተለየ አስተዳደራዊ ለውጥ ነው; እነዚህን ስራዎች መጨመር እራሱን ቅርንጫፍ አይከላከልም.
|
||||
|
||||
### ወረፋ አዋህድ
|
||||
|
||||
> **2026-11-19፡ የመርግፋይ ውህደት ወረፋ ጡረታ ወጥቷል።** (የባለቤቱ ውሳኔ). `.mergify.yml` ከአሁን በኋላ ወረፋን አይገልጽም እና የመሳብ ጥያቄን የሚያዋህዱ ወይም የሚጽፉ የ Mergify ትዕዛዞችን አይቀበልም። ልቀቅ PRs በማከማቻ ደንቡ መሠረት "በነቃ ልቀቱ ላይ አረንጓዴ በሮች ጠይቅ" (`Gate / CI` + `Gate / Quality`) omni-ወረፋ በቀጥታ ሁነታ ላይ እስኪሄድ ድረስ እና ከዚያ በኋላ በኦምኒ ወረፋ ( [OMNI_QUEUE.md](../ops/OMNI_QUEUE.md) ) ስር ይደባለቃሉ። ከዚህ በታች የተገለጹት የ Mergify ረቂቆች የስራ ፍሰት አያያዝ አሁንም በ `ci.yml` እና `quality.yml` ነው፣ ነገር ግን ምንም የ Mergify ረቂቅ ከአሁን በኋላ አልተከፈተም።
|
||||
|
||||
`queue` መለያው ወደ Mergify ወረፋ (`.mergify.yml`) PR ይልካል። Mergify ረቂቅ PR በ `mergify/merge-queue/` ቅርንጫፍ ላይ ይከፍታል፣ CI ሙሉውን ምርጫ እዚያ ያካሂዳል፣ እና የመጀመሪያው PR `Gate / CI`, `Gate / Quality` እና `Merge integrity (changelog + generated skills)` ሲያልፍ ይዋሃዳሉ።
|
||||
|
||||
Mergify የወረፋ ማጠቃለያውን ወደ ረቂቁ መግለጫ ይጽፋል፣ እና ሌሎች መተግበሪያዎችም አርትዖት ሊያደርጉት ይችላሉ። በእንደዚህ አይነት ረቂቅ ላይ `pull_request` `edited` ክስተት የራሱ የሆነ የተጓዳኝ ቡድን (`-queue-edit-<run_id>`) ስለሚወስድ የረቂቁን ትክክለኛ ሩጫ መሰረዝ አይችልም፣ እና በሩን እና ማትሪክስ ይዘላል። አሁንም የሚሄደው `Merge integrity` ብቻ ነው። የተዘለለው የጌት ስራ የተለየ የፍተሻ ስም ይይዛል፣ ምክንያቱም Mergify የተዘለለ `Gate / CI` እንደ ያልተሳካ ቼክ አንብቦ PR ስለሚያጠፋ ነው።
|
||||
@@ -37,7 +39,7 @@ Mergify የወረፋ ማጠቃለያውን ወደ ረቂቁ መግለጫ ይጽ
|
||||
|
||||
### በተቀባይ ተቀባይ ውስጥ የተያዙ ማስረጃዎች
|
||||
|
||||
`scripts/quality/validate-release-acceptance.mjs` የቀረበውን እቅድ እና መግለጫዎቹን ይቀንሳል; እቅዱ ሙሉ ለሙሉ የመልቀቂያ ቧንቧን እንደሚሸፍን አያረጋግጥም. የእሱ ሪፖርቶች በግልጽ `releaseAcceptance: false` ያስቀምጣሉ፣ ምንም እንኳን ያ እቅድ `VERIFIED` ቢሆንም። የ `release-acceptance.yml` የስራ ፍሰቱ አሁንም የጥላ ዕቃዎችን ይጠቀማል እንጂ እውነተኛ ግንባታ፣ ጥቅል፣ ቡት ወይም የማስተዋወቂያ ደረሰኞች አይደለም።
|
||||
`scripts/quality/validate-release-acceptance.mjs` የቀረበውን እቅድ እና መግለጫዎቹን ይቀንሳል; እቅዱ የተጠናቀቀውን የመልቀቂያ ቧንቧ የሚሸፍን መሆኑን አያረጋግጥም. የእሱ ሪፖርቶች በግልጽ `releaseAcceptance: false` ያስቀምጣሉ፣ ምንም እንኳን ያ እቅድ `VERIFIED` ቢሆንም። የ `release-acceptance.yml` የስራ ፍሰቱ አሁንም ቢሆን የጥላ ዕቃዎችን ይጠቀማል እንጂ እውነተኛ ግንባታ፣ ጥቅል፣ ቡት ወይም የማስተዋወቂያ ደረሰኞች አይደለም።
|
||||
|
||||
የተያዙ ማስረጃዎችን ለማረጋገጥ CLI `--evidence-root` ያስፈልገዋል። ፋይሎች እንደ `<evidence-root>/<artifact_id>/<member>` እና hashed እንደ SHA-256 ተፈትተዋል። የ PASS መዝገብ ያለ ማስረጃ፣ የጠፋ ወይም የተለወጠ ፋይል፣ ደህንነቱ ያልተጠበቀ መንገድ ወይም ሲምሊንክ ማረጋገጥን ይከለክላል። የጎደሉ ፋይሎች ስኬታማ ከሆኑ ምዝግብ ማስታወሻዎች ባዶ ጋር እኩል አይደሉም። አሁን ያሉት SHA/run/attempt ቼኮች ነጻ ሆነው ይቆያሉ፡ ተዛማጅ ባይት የቆየ ደረሰኝን ማዳን አይችልም። የፋይል ታማኝነት የአፈፃፀም ትክክለኛነት ወይም የቅርስ ማስተዋወቅ ማረጋገጫ አይደለም።
|
||||
|
||||
@@ -47,7 +49,7 @@ Mergify የወረፋ ማጠቃለያውን ወደ ረቂቁ መግለጫ ይጽ
|
||||
|
||||
የተመረጡትን ተለዋጭ ስሞች ሳትፈጽም ለመመርመር `npm run quality:scan -- --list` ወይም `npm run quality:scan:fast -- --list` ይጠቀሙ። ሯጩ የ npm መግቢያ ነጥብን ይጠራል፣ ስለዚህ የሩጫ ሰዓቱ (ከተዋቀረ Bun ጨምሮ) ተጠብቆ ይቆያል። አንጸባራቂው ከነዚያ መገለጫዎች ውጭ ተለዋጭ ስሞችን ለብቻው በተጠራ መልኩ ይመዘግባል፣ እና የጥገና ትዕዛዞች በተነባቢ-ብቻ ቅኝት መገለጫዎች የተከለከሉ ናቸው።
|
||||
|
||||
እነዚህ መገለጫዎች የማይንቀሳቀስ ቅኝትን ብቻ ይሸፍናሉ። የምርት ሙከራዎችን፣ ሽፋንን፣ ማሸግን፣ የውጭ ቼኮችን ወይም የእጩን ሙሉ ልቀት መቀበልን አያረጋግጡም። የስራ ፍሰት መግቢያ የተገናኘውን `config/quality/admission-policy.json` እና `scripts/quality/admission-verdict.mjs` ይጠቀማል። የመልቀቂያ-ታዛቢ መገለጫዎች ተለይተው ይቀራሉ; የሚመለከታቸውን ቼኮች እና ደረሰኞች በተናጥል ይፈትሹ። የሙሉ ተመልካቾች የማይለዋወጡ ትዕዛዞች `audit:deps`፣ ሚውቴሽን-ሙከራ ምርጫ እና የትርጉም ፍተሻዎችን ጨምሮ በ `config/quality/release-green-static-profile.json` ውስጥ ተገልፀዋል። ጫኚው የ npm ትዕዛዞችን በ package.json እና በተቀረጹ CI/Quality መግለጫዎች ላይ ያረጋግጣል። የሼል ቶከኖችን እንደ ክርክር ከማስፈጸም ይልቅ ተንሸራታትን ውድቅ ያደርጋል። የሚያስፈልግ ስካነር SKIP/INCOMPLETE ውፅዓት PASS መመስረት አይችልም። መገለጫው ውጫዊ ማግለያዎቹን ይመዘግባል እና የተስተናገደ ሽፋን፣ የሙከራ ማትሪክስ፣ ጥቅል ወይም የማሰማራት ማስረጃን አይተካም። ከታች ያለው የስድ መዝገብ ዝርዝር ዋቢ እንጂ በር በትክክል መሮጡን ማረጋገጫ አይደለም።
|
||||
እነዚህ መገለጫዎች የማይንቀሳቀስ ቅኝትን ብቻ ይሸፍናሉ። የምርት ሙከራዎችን፣ ሽፋንን፣ ማሸግን፣ የውጭ ቼኮችን ወይም የእጩን ሙሉ ልቀት መቀበሉን አያረጋግጡም። የስራ ፍሰት መግቢያ የተገናኘውን `config/quality/admission-policy.json` እና `scripts/quality/admission-verdict.mjs` ይጠቀማል። የመልቀቂያ-ታዛቢ መገለጫዎች ተለይተው ይቀራሉ; የሚመለከታቸውን ቼኮች እና ደረሰኞች በተናጥል ይፈትሹ። የሙሉ ተመልካቾች የማይለዋወጡ ትዕዛዞች `audit:deps`፣ ሚውቴሽን-ሙከራ ምርጫ እና የትርጉም ፍተሻዎችን ጨምሮ በ `config/quality/release-green-static-profile.json` ውስጥ ታውጇል። ጫኚው የ npm ትዕዛዞችን በ package.json እና በተቀረጹ CI/Quality መግለጫዎች ላይ ያረጋግጣል። የሼል ቶከኖችን እንደ ክርክር ከማስፈጸም ይልቅ ተንሸራታትን ውድቅ ያደርጋል። የሚያስፈልግ ስካነር SKIP/INCOMPLETE ውፅዓት PASS መመስረት አይችልም። መገለጫው ውጫዊ ማግለያዎቹን ይመዘግባል እና የተስተናገደ ሽፋን፣ የሙከራ ማትሪክስ፣ ጥቅል ወይም የማሰማራት ማስረጃን አይተካም። ከታች ያለው የስድ መዝገብ ዝርዝር ዋቢ እንጂ በር በትክክል መሮጡን ማረጋገጫ አይደለም።
|
||||
|
||||
ስክሪፕቶች በ `scripts/check/` (የፖሊሲ በሮች) እና `scripts/quality/` (የራትቼ ሞተር) ስር ይኖራሉ። CI የእውነት ምንጭ `.github/workflows/ci.yml` ነው።
|
||||
|
||||
@@ -64,9 +66,9 @@ Mergify የወረፋ ማጠቃለያውን ወደ ረቂቁ መግለጫ ይጽ
|
||||
|
||||
#### የተረሱ ወንድም እህት ፈተናዎች ሪፖርት ያደርጋሉ
|
||||
|
||||
`npm run check:forgotten-sibling-tests` እንደ `Fast Quality Gates` የአማካሪ ደረጃ ይሰራል እና የማስመጣት ፈላጊውን ከሙከራ-ተጽእኖ ካርታው ጀርባ እንደገና ይጠቀማል። ለእያንዳንዱ የተለወጠ የምርት ሞጁል፣ የእጩው ፈተና ከመጎተት-ጥያቄ ልዩነት በማይኖርበት ጊዜ ቆራጥ የሆኑ `changed module/symbol -> static consumer -> candidate sibling test` ሰንሰለቶችን ሪፖርት ያደርጋል። የ Markdown ማጠቃለያ እና JSON ውጤት ከማንኛውም ማገድ መልቀቅ በፊት እንደ `forgotten-sibling-tests` የስራ ፍሰት ቅርስ ሆኖ እንዲቆይ ተደርጓል።
|
||||
`npm run check:forgotten-sibling-tests` እንደ `Fast Quality Gates` የማማከር ደረጃ ይሰራል እና ከሙከራ-ተፅእኖ ካርታ በስተጀርባ የማስመጣት ፈላጊውን እንደገና ይጠቀማል። ለእያንዳንዱ የተለወጠ የምርት ሞጁል፣ የእጩው ፈተና ከመጎተት-ጥያቄ ልዩነት በማይኖርበት ጊዜ ቆራጥ የሆኑ `changed module/symbol -> static consumer -> candidate sibling test` ሰንሰለቶችን ሪፖርት ያደርጋል። የማርክዳው ማጠቃለያ እና JSON ውጤት ከማናቸውም የማገድ ልቀት በፊት እንደ `forgotten-sibling-tests` የስራ ፍሰት ቅርስ ሆኖ እንዲቆይ ተደርጓል።
|
||||
|
||||
በርሜል እንደገና ወደ ውጭ መላክ እና ተለዋዋጭ ወደ ሀገር ውስጥ መግባቶች የመፍትሄ ምርመራዎች ብቻ ናቸው; የማገድ ግኝትን ፈጽሞ አይፈጥሩም። የተገመገሙ ልዩ ሁኔታዎች በ `config/quality/forgotten-sibling-allowlist.json` ውስጥ ይኖራሉ። እያንዳንዱ ግቤት የሸማቹን እና የእጩዎችን ፈተና መሰየም፣ የተለየ ምክንያት መስጠት እና GitHub ጉዳይን ማገናኘት ወይም የመሳብ ጥያቄን ማያያዝ አለበት። የተበላሹ ምዝግቦች አልተዘጉም። ልዩ ሁኔታዎች የተሰረዘ እጩ ፈተናን ወይም `.skip`/`.todo` የሚጨምር ልዩነትን ማፈን አይችሉም። ማዳከም እና ሌሎች ጭንብል መሸፈኛዎች በተናጥል በተዘጋው `check:test-masking` በር ባለቤትነት ይቆያሉ።
|
||||
በርሜል እንደገና ወደ ውጭ መላክ እና ተለዋዋጭ ወደ አገር ውስጥ መግባቶች የመፍትሄ ምርመራዎች ብቻ ናቸው; የማገድ ግኝትን ፈጽሞ አይፈጥሩም። የተገመገሙ ልዩ ሁኔታዎች በ `config/quality/forgotten-sibling-allowlist.json` ውስጥ ይኖራሉ። እያንዳንዱ ግቤት የሸማቹን እና የእጩዎችን ፈተና መሰየም፣ የተለየ ምክንያት መስጠት እና GitHub ጉዳይን ማገናኘት ወይም የመሳብ ጥያቄን ማያያዝ አለበት። የተበላሹ ምዝግቦች አልተዘጉም። ልዩ ሁኔታዎች የተሰረዘ እጩ ፈተናን ወይም `.skip`/`.todo` የሚጨምር ልዩነትን ማፈን አይችሉም። ማዳከም እና ሌሎች ጭንብል መሸፈኛዎች በተናጥል በተዘጋው `check:test-masking` በር ባለቤትነት ይቆያሉ።
|
||||
|
||||
### ሥራ `lint`
|
||||
|
||||
@@ -175,11 +177,11 @@ Mergify የወረፋ ማጠቃለያውን ወደ ረቂቁ መግለጫ ይጽ
|
||||
|
||||
`scripts/i18n/sync-llm-mirrors.mjs` (እንዲሁም እንደ `syncLlmMirrors()` ወደ ውጭ ይላካል, ከ `--dry-run` ጋር) የ `llm.txt` መስተዋቶችን እንደገና ይጽፋል; የመልቀቂያው አድስ፣ የትርጉም ሞገድ እና የታቀደው `i18n-mirror-refresh.yml` ያካሂዱት (ማደሱ የቆዩ `llm.txt` መስተዋቶችን በደረቅ ሩጫ ይገነዘባል፣ ተንሳፋፊ ሪፖርቱ ስለማይዘረዝራቸው እና ከ `check:docs-all` በፊት ያመሳስላቸዋል)።
|
||||
|
||||
በ `docs/diagrams/` ስር ያሉት አስራ ሁለቱ README SVGs ይፈጠራሉ (`scripts/docs/gen-readme-<name>.mjs`፣ `npm run docs:readme-diagrams` ሁሉንም ያድሳል)። እያንዳንዱ የባይት-ንጽጽር አሃድ ሙከራ (`tests/unit/docs/readme-*-svg.test.ts`, job `test-unit`) ያለው የተፈፀመው ፋይል በመልቀቂያ ሁነታ ላይ ሲያልቅ የማይሳካው; በ PR፣ `check:generated-artifacts` አንድ SVG PR አርትዖቶችን ይፈርዳል እና የመሠረቱ ተንሸራታች ለመልቀቂያው እድሳት ይቀራል ( [የተፈጠሩ ፋይሎችን እና የመነሻ መስመሮችን](#generated-files-and-derived-baselines-written-at-release) ይመልከቱ) — እና `check:docs-counts` ቀኖናዊ ቁጥሮችን ከ `<text>` nodes — ያነባሉ ለዚህም ነው የዝርዝር ሂደቱ በፋይሉ ውስጥ ያሉትን እያንዳንዱን ሕብረቁምፊዎች በማይታይ `<text>` ያቆየዋል። የ SVG ቀኖናዊ-ቁጥሮች ቼክ በ `SVG_DIAGRAM_FILES` (`scripts/check/check-docs-counts-sync.mjs`) የተዘረዘሩትን ፋይሎች ያነባል `docs/diagrams/readme-hero.svg`, `free-tier-budget.svg`, `promise-pillars.svg`, `comparison-table.svg`, `cli-terminal.svg`, `tier-cascade.svg`, plus `public/images/tier-flow-dark.svg` እና `tier-flow-light.svg` የነፃው-ዘላለም፣ ካታሎግ-መግቢያ፣ ተደጋጋሚ ገንዳ እና የውጤት መንስኤዎች የይገባኛል ጥያቄዎች በተጨማሪ `promise-pillars.svg`, `free-tier-budget.svg` እና `strategies-grid.svg` አንብበዋል. እነዚህ ጄነሬተሮች የሚሳሉት ቆጠራዎች (የአቅራቢው ጠቅላላ፣ MCP መሣሪያዎች፣ የማዞሪያ ስልቶች፣ ለዘለዓለም ነጻ የሆኑ አቅራቢዎች፣ …) ከእውነታዎች ቅጽበታዊ ገጽ እይታ `docs/reference/derived-facts.json` እስከ `scripts/docs/readmeFacts.mjs` በኩል የሚመጡት እንጂ ከጥሬ ቃላት አይደሉም፣ ስለዚህ በማንኛውም ቅርንጫፍ ላይ ዲያግራምን እንደገና ማመንጨት የገባውን ፋይል እንደገና ያባዛል። `free-tier-budget.svg` ረድፎቹን ከተመሳሳዩ ቅጽበታዊ ገጽ እይታ ይሳሉ (`code.freeTierBudget`፣ ካታሎግ ማጠቃለያው የእውነታ መመርመሪያ መዝገቦች)፣ ስለዚህ `FREE_MODEL_BUDGETS` ወደ CI ቀይ ከመቀየር ይልቅ በሚቀጥለው ማደስ ካርዱ ላይ ይደርሳል።
|
||||
በ `docs/diagrams/` ስር ያሉት አስራ ሁለቱ README SVGs ይፈጠራሉ (`scripts/docs/gen-readme-<name>.mjs`፣ `npm run docs:readme-diagrams` ሁሉንም ያድሳል)። እያንዳንዱ የባይት-ንጽጽር አሃድ ፈተና (`tests/unit/docs/readme-*-svg.test.ts`, job `test-unit`) ያለው የተፈፀመው ፋይል በመልቀቂያ ሁነታ ላይ ሲቀር አይሳካም; በ PR፣ `check:generated-artifacts` አንድ SVG PR አርትዖቶችን ይፈርዳል እና የመሠረቱ ተንሸራታች ለመልቀቂያው እድሳት ይቀራል ( [የተፈጠሩ ፋይሎችን እና የመነሻ መስመሮችን](#generated-files-and-derived-baselines-written-at-release) ይመልከቱ) — እና `check:docs-counts` ቀኖናዊ ቁጥሮችን ከ `<text>` nodes — ያነባሉ ለዚህም ነው የዝርዝር ሂደቱ በፋይሉ ውስጥ ያሉትን እያንዳንዱን ሕብረቁምፊዎች በማይታይ `<text>` ያቆየዋል። የ SVG ቀኖናዊ-ቁጥሮች ቼክ በ `SVG_DIAGRAM_FILES` (`scripts/check/check-docs-counts-sync.mjs`) የተዘረዘሩትን ፋይሎች ያነባል `docs/diagrams/readme-hero.svg`, `free-tier-budget.svg`, `promise-pillars.svg`, `comparison-table.svg`, `cli-terminal.svg`, `tier-cascade.svg`, plus `public/images/tier-flow-dark.svg` እና `tier-flow-light.svg` የነፃው-ዘላለም፣ ካታሎግ-መግቢያ፣ ተደጋጋሚ ገንዳ እና የውጤት መንስኤዎች የይገባኛል ጥያቄዎች በተጨማሪ `promise-pillars.svg`, `free-tier-budget.svg` እና `strategies-grid.svg` አንብበዋል. እነዚህ ጄነሬተሮች የሚሳሉት ቆጠራዎች (የአቅራቢው ጠቅላላ፣ MCP መሣሪያዎች፣ የማዞሪያ ስልቶች፣ ለዘለዓለም ነጻ የሆኑ አቅራቢዎች፣ …) ከእውነታዎች ቅጽበታዊ ገጽ እይታ `docs/reference/derived-facts.json` እስከ `scripts/docs/readmeFacts.mjs` በኩል የሚመጡት እንጂ ከጥሬ ቃላት አይደሉም፣ ስለዚህ በማንኛውም ቅርንጫፍ ላይ ዲያግራምን እንደገና ማመንጨት የገባውን ፋይል እንደገና ያባዛል። `free-tier-budget.svg` ረድፎቹን ከተመሳሳዩ ቅጽበታዊ ገጽ እይታ ይሳሉ (`code.freeTierBudget`፣ ካታሎግ ማጠቃለያው የእውነታ መመርመሪያ መዝገቦች)፣ ስለዚህ `FREE_MODEL_BUDGETS` ወደ CI ቀይ ከመቀየር ይልቅ በሚቀጥለው ማደስ ካርዱ ላይ ይደርሳል።
|
||||
|
||||
### የተገኙ እሴቶች፡ የ `pr` እና `release` በር ሁነታዎች
|
||||
|
||||
PR ባህሪ እንደ መነሻው ሁኔታ የሚወሰን እሴትን በጭራሽ አይጽፍም፡ አቅራቢ፣ ፍልሰት፣ MCP-መሳሪያ እና የስትራቴጂ ቆጠራዎች፣ የ README SVG ቁጥሮች፣ የእውነታዎች ቅጽበታዊ ገጽ እይታ። አንድ እርምጃ ሁሉንም ያሰላል፣ `npm run release:refresh-derived`፣ በተለቀቀው እና በምሽት በመነጨ-እድሳት PR የሚተዳደር። ስለዚህ** በተለቀቁት መካከል መሠረቱ ከቀጥታ ኮድ በንድፍ በስተጀርባ ነው።** , እና ዛፉን ከቀጥታ ኮድ ጋር የሚያነጻጽር በር ወይም ፈተና በእያንዳንዱ PR ላይ አንድ ወንድም ወይም እህት አቅራቢ ካከሉ በኋላ ቀይ ይሆናል። የተገኙትን እሴቶች የሚዳኙት በሮች ከሁለቱ ሁነታዎች በአንዱ ይሰራሉ በ `scripts/check/lib/gateMode.mjs` (የመጀመሪያ ግጥሚያ አሸነፈ)
|
||||
PR ባህሪ እንደ መነሻው ሁኔታ የሚወሰን እሴትን በጭራሽ አይጽፍም፡ አቅራቢ፣ ፍልሰት፣ MCP-መሳሪያ እና የስትራቴጂ ቆጠራዎች፣ የ README SVG ቁጥሮች፣ የእውነታዎች ቅጽበታዊ ገጽ እይታ። አንድ እርምጃ ሁሉንም ያሰላል፣ `npm run release:refresh-derived`፣ በተለቀቀው እና በምሽት በመነጨ-እድሳት PR የሚተዳደር። ስለዚህ** በተለቀቁት መካከል መሠረቱ ከቀጥታ ኮድ በንድፍ በስተጀርባ ነው።** , እና ዛፉን ከቀጥታ ኮድ ጋር የሚያወዳድረው በር ወይም ፈተና በእያንዳንዱ PR ላይ አንድ ወንድም ወይም እህት አቅራቢ ካከሉ በኋላ ቀይ ይሆናል። የተገኙትን እሴቶች የሚዳኙት በሮች ከሁለቱ ሁነታዎች በአንዱ ይሰራሉ በ `scripts/check/lib/gateMode.mjs` (የመጀመሪያ ግጥሚያ አሸነፈ)
|
||||
|
||||
1. `--mode=pr|release` በትእዛዝ መስመር ላይ;
|
||||
2. የ `OMNIROUTE_GATE_MODE` አካባቢ ተለዋዋጭ (`pr` ወይም `release`);
|
||||
@@ -213,7 +215,7 @@ PR ባህሪ እንደ መነሻው ሁኔታ የሚወሰን እሴትን በ
|
||||
|
||||
- `npm run facts` እያንዳንዱን የተገኘ ቁጥር እንደ JSON (`scripts/release/facts.mjs`) ያትማል። `--key=code.mcpTools` አንድ እሴት ያትማል፣ `--snapshot` ከቀጥታ ዛፍ ይልቅ የተፈጸመውን ቅጽበታዊ ገጽ እይታ ያነባል። እውነታውን መሰብሰብ በማይቻልበት ጊዜ 2 ውጣ።
|
||||
- `npm run release:refresh-derived` (`scripts/release/refresh-derived.mjs`) recomputes the derived files in one pass, in this order (step ids for `--only=`): `provider-reference` (`docs/reference/PROVIDER_REFERENCE.md`), `facts` (the snapshot), `numbers` (the counts gate's rewrite plan applied to the docs, then carried to their `docs/i18n/` mirrors), `readme-diagrams`, `skills` (generated `SKILL.md`), `e2e-timings` (skipped until the tree ships `syncE2eTimings`), `ui-keys` (prunes keys `en.json` dropped and, with `--rewritten-since=<ref>` — default `origin/main` — re-queues English values rewritten since the last release; the values are translated in the same run by the backend configured in the environment or in `.env` (`OMNIROUTE_TRANSLATION_*`, only those keys are read) or by the Google engine. Without a backend it never writes `__MISSING__` markers: the release profile fails, the nightly skips the keys, and `--allow-untranslated` writes them on purpose), `llm-mirrors` and `verify-generated` (after a write, `check:generated-artifacts` and `check:agent-skills-sync` in release mode must pass; skipped in `--check` and when `--only` leaves it out; a failure is exit 2). The `changelog` step is opt-in (`--with-changelog`, release profile only). `--profile=nightly` never touches a version claim. With `-- --check` it writes nothing and exits 1 when any file would change or a managed value needs a manual edit (listing both); exit 2 on an infrastructure failure. `--json` prints the result as JSON.
|
||||
- `docs/reference/derived-facts.json` የመጨረሻው ማደስ ጥቅም ላይ የዋለው የእውነታዎች ቅጽበታዊ ገጽ እይታ ነው። ማደስ ብቻ ነው የሚጽፈው። የ README SVG ጀነሬተሮች አንብበውታል፣ እና የPR-time ዩኒት ሙከራዎች የተፈጸሙትን ሰነዶች እና የመነጩ ፋይሎች ከእሱ ጋር — በጭራሽ ከቀጥታ ኮድ ጋር ያወዳድራሉ። የስብስቡ ነጠላ የቀጥታ ንፅፅር በ `tests/unit/check-docs-counts-sync.test.ts` ውስጥ "የልቀት መታደስ ዑደቱን ይዘጋል" ነው፡ ከቀጥታ እውነታዎች ጋር፣ የማደስ ዳግም መፃፍ እቅድ በማህደረ ትውስታ ውስጥ የተተገበረው ምንም STRICT መንቀጥቀጥ አይተወውም፣ እና እንደገና እቅድ ማውጣት ምንም አይቀይረውም።
|
||||
- `docs/reference/derived-facts.json` ጥቅም ላይ የዋለው የመጨረሻው ማደስ የእውነታዎች ቅጽበታዊ ገጽ እይታ ነው። ማደስ ብቻ ነው የሚጽፈው። የ README SVG ጀነሬተሮች አንብበውታል፣ እና የPR-time ዩኒት ሙከራዎች የተፈጸሙትን ሰነዶች እና የመነጩ ፋይሎች ከእሱ ጋር — በጭራሽ ከቀጥታ ኮድ ጋር ያወዳድራሉ። የስብስቡ ነጠላ የቀጥታ ንፅፅር በ `tests/unit/check-docs-counts-sync.test.ts` ውስጥ "የልቀት መታደስ ዑደቱን ይዘጋል" ነው፡ ከቀጥታ እውነታዎች ጋር፣ የማደስ ዳግም መፃፍ እቅድ በማህደረ ትውስታ ውስጥ የተተገበረው ምንም STRICT መንቀጥቀጥ አይተወውም፣ እና እንደገና እቅድ ማውጣት ምንም አይቀይረውም።
|
||||
|
||||
በአካባቢው ለመራባት (አካባቢያዊ አሂድ ወደ `release` ነባሪዎች)፡-
|
||||
|
||||
@@ -249,7 +251,7 @@ npm run release:refresh-derived -- --check # what the rele
|
||||
|
||||
አንዱን i18n regression ይይዛል ሌላኛው በመዋቅራዊ መልኩ በሮች ማየት አይችሉም፡ የእንግሊዘኛ እሴት እንደገና ይፃፋል እና ከ _ቀዳሚ_ እንግሊዘኛ የተገኙት ትርጉሞች ወደ ኋላ ይቆያሉ፣ ስለዚህ እንግሊዛዊ ያልሆኑ ተጠቃሚዎች በልበ ሙሉነት-ቃል ያለው አሁን የተሳሳተ ቅጂ ያነባሉ።
|
||||
|
||||
ይህ በእውነቱ ተልኳል። `oauthModal.googleOAuthWarning` በድጋሚ የተጻፈው አንቲግራቪቲ መግቢያ ረዳት ሲያርፍ (#5203);** 39 ከ 43 አከባቢዎች** ለኦፕሬተሮች "ሙሉውን URL ገልብጠው ከዚህ በታች ለጥፍ" — ለዚያ አገልግሎት አቅራቢ ማጠናቀቅ የማይችል ፍሰት እንዲያደርጉ የሚገልጽ ጽሁፍ ቀጠለ። እስከ #8463 ድረስ ሳይስተዋል ቀርቷል ምክንያቱም፡-
|
||||
ይህ በእውነቱ ተልኳል። `oauthModal.googleOAuthWarning` እንደገና የተጻፈው Antigravity መግቢያ ረዳት ሲያርፍ (#5203);** 39 ከ 43 አከባቢዎች** ለኦፕሬተሮች "ሙሉውን URL ገልብጠው ከዚህ በታች ለጥፍ" የሚል ጽሁፍ ደጋግሞ ለአገልግሎት አቅራቢው ማጠናቀቅ የማይችል — ። እስከ #8463 ድረስ ሳይስተዋል ቀርቷል ምክንያቱም፡-
|
||||
|
||||
- `sync-ui-keys` ያሉትን ቁልፎች ብቻ ነው የሚሞላው።** የለም** ፣ በጭራሽ ያልሆኑት።** የቆየ** ;
|
||||
- `check-ui-keys-coverage` ቁልፍ _presence_ ይቆጥራል፣ ስለዚህ የቆየ ትርጉም እንደተሸፈነ ይቆጠራል።
|
||||
|
||||
@@ -42,25 +42,23 @@ flowchart LR
|
||||
`main` የዕለት ተዕለት ውህደት ቅርንጫፍ አይደለም። `main`ን በማነጣጠር የተከፈቱ PRዎች
|
||||
ከመዋሃዳቸው በፊት ብዙውን ጊዜ ወደ ሌላ ቅርንጫፍ እንዲያነጣጥሩ መቀየር ያስፈልጋቸዋል።
|
||||
|
||||
## የልቀት ማገድ (ትይዩ ዑደቶች)
|
||||
## የተለቀቀው በረዶ (ትይዩ ዑደቶች)
|
||||
|
||||
አንድ ልቀት በሚጣጣምበት ጊዜ፣ `release-freeze` የሚል መለያ ያለው ምልክት ጉዳይ
|
||||
ይከፈታል። ይህ **ልማትን አያቆምም**፦
|
||||
ልቀትን በሚታረቅበት ጊዜ `release-freeze` የሚል ምልክት ማድረጊያ ችግር ይከፈታል። ያ** ልማትን አያቆምም።** :
|
||||
|
||||
- የታገደው `release/vX.Y.Z` ለዚያ ልቀት የልቀት ኃላፊው ይሆናል።
|
||||
- አስተዋጽዖ አድራጊዎች ሥራቸውን ማስገባታቸውን እንዲቀጥሉ፣ የቀጣዩ ዑደት `release/vX+1`
|
||||
ከታገደው ጫፍ ይፈጠራል።
|
||||
- አሁንም የታገደውን ቅርንጫፍ የሚያነጣጥሩ ክፍት PRዎች ንቁውን (ከፍተኛውን)
|
||||
`release/v*` ቅርንጫፍ **እንዲያነጣጥሩ መቀየር** አለባቸው።
|
||||
- የቀዘቀዘው `release/vX.Y.Z` የዚያ መርከብ የተለቀቀው ካፒቴን ነው።
|
||||
- የሚቀጥለው ዑደት `release/vX+1` ከቀዘቀዘው ጫፍ ተቆርጧል ስለዚህ አስተዋፅዖ አበርካቾች የማረፍ ስራቸውን ይቀጥላሉ.
|
||||
- አሁንም የታሰረውን ቅርንጫፍ ያነጣጠረ PRs ይክፈቱ** እንደገና ዒላማ አድርጓል** ወደ ንቁ (ከፍተኛ) `release/v*` ቅርንጫፍ።
|
||||
|
||||
የሚፈልጉት ቅርንጫፍ ሊዋሃድ የሚችል ነው ብለው ከመገመትዎ በፊት፣ ክፍት የማገድ ጉዳይ እንዳለ ያረጋግጡ፦
|
||||
የሚፈልጉትን ቅርንጫፍ ሊዋሃድ ይችላል ብለው ከመገመትዎ በፊት ክፍት ቅዝቃዜ እንዳለ ያረጋግጡ፡-
|
||||
|
||||
```bash
|
||||
gh issue list --repo diegosouzapw/OmniRoute --label release-freeze --state open
|
||||
```
|
||||
|
||||
የውህደት አሠራሮች (የባለቤቱ `queue` መለያ → Mergify) በ
|
||||
[MERGE_TRAIN.md](./MERGE_TRAIN.md) ውስጥ ተመዝግበዋል።
|
||||
ውህደት ሜካኒክስ (ባለቤት `queue` መለያ → Mergify) በ [MERGE_TRAIN.md](./MERGE_TRAIN.md) ውስጥ ተመዝግቧል።
|
||||
|
||||
> **2026-11-19፡ የመርግፋይ ውህደት ወረፋ ጡረታ ወጥቷል።** (የባለቤቱ ውሳኔ). `.mergify.yml` ከአሁን በኋላ ወረፋን አይገልጽም እና የመሳብ ጥያቄን የሚያዋህዱ ወይም የሚጽፉ የ Mergify ትዕዛዞችን አይቀበልም። ልቀቅ PRs በማከማቻ ደንቡ መሠረት "በነቃ ልቀቱ ላይ አረንጓዴ በሮች ጠይቅ" (`Gate / CI` + `Gate / Quality`) omni-ወረፋ በቀጥታ ሁነታ ላይ እስኪሄድ ድረስ እና ከዚያ በኋላ በኦምኒ ወረፋ ( [OMNI_QUEUE.md](./OMNI_QUEUE.md) ) ስር ይደባለቃሉ። የ `queue` መለያው ከእንግዲህ ምንም አያዋህድም።
|
||||
|
||||
## ቅርንጫፍና መለያ ሁለቱም ለምን ያስፈልጋሉ?
|
||||
|
||||
|
||||
@@ -4,10 +4,9 @@
|
||||
|
||||
---
|
||||
|
||||
v3.8.49 (የquality/velocity ዕቅድ WS3.2/WS3.4) ጀምሮ፣ የተገመገሙ PRs ወደ
|
||||
`release/vX.Y.Z` የሚዋሃዱበት ነባሪ መንገድ **Mergify merge queue** (`.mergify.yml`) ነው፤
|
||||
ከታች የተመዘገበው **manual merge-train** የመጠባበቂያ አማራጭ ነው — በክስተቶች፣
|
||||
በrelease freezes ወቅት፣ ወይም የMergify Open Source ዕቅድ ከተቀየረ ጥቅም ላይ ይውላል።
|
||||
> **2026-11-19፡ የመርግፋይ ውህደት ወረፋ ጡረታ ወጥቷል።** (የባለቤቱ ውሳኔ). `.mergify.yml` ከአሁን በኋላ ወረፋን አይገልጽም እና የመሳብ ጥያቄን የሚያዋህዱ ወይም የሚጽፉ የ Mergify ትዕዛዞችን አይቀበልም። ልቀቅ PRs በማከማቻ ደንቡ መሠረት "በነቃ ልቀቱ ላይ አረንጓዴ በሮች ጠይቅ" (`Gate / CI` + `Gate / Quality`) omni-ወረፋ በቀጥታ ሁነታ ላይ እስኪሄድ ድረስ እና ከዚያ በኋላ በኦምኒ ወረፋ ( [OMNI_QUEUE.md](./OMNI_QUEUE.md) ) ስር ይደባለቃሉ። ከታች ያሉት የመርግፋይ ክፍሎች ወረፋውን እንደነበረ ይገልጻሉ።
|
||||
|
||||
ከ v3.8.49 (WS3.2/WS3.4 of the quality/velocity plan) ጀምሮ ለግምገማ PRs ወደ `release/vX.Y.Z` ነባሪ የውህደት መንገድ ነው።** የውህደት ወረፋን አዋህድ** (`.mergify.yml`); የ** በእጅ ውህደት-ባቡር** ከዚህ በታች በሰነድ የተመዘገበው FALLBACK — በአደጋዎች ጊዜ ጥቅም ላይ የሚውለው ፣በሚለቀቁበት ወቅት ወይም የ Mergify ክፍት ምንጭ ዕቅድ ከተለወጠ ነው።
|
||||
|
||||
## ነባሪ መንገድ፦ የMergify ወረፋ
|
||||
|
||||
|
||||
@@ -379,8 +379,7 @@ grafted parent ላይ packን ውድቅ ያደርጋል፤ ስለዚህ ከሙ
|
||||
የቀድሞው tag አለ፣ `package.json` የዒላማው ስሪት ነው፣ የ`release-freeze` issue ክፍት ነው፣
|
||||
እና በነባር release branch ላይ ክፍት `Release branch not green` issue የለም —
|
||||
የሌለ branch `?` ያልታወቀ ብሎ ይመልሳል፣ ፈጽሞ green አይባልም —
|
||||
የMergify `release` queue ተዋቅሯል (G11፦ `queue_rules`፣ `checks_timeout`፣
|
||||
መለያ `queue`)፣ የ`release/*` ruleset አሁንም መሰረዝን እና force-pushን ይከለክላል፣ እንዲሁም
|
||||
omni-queue የማዋሃድ ጥያቄዎችን ወደ መልቀቂያ ቅርንጫፍ ያዋህዳል (G11: `config/merge-queue/config.json` የሚሰራ፣ የእሱ `bases` የመልቀቂያ ቅርንጫፉን ያስተዳድራል፣ `mode` `live`፣ መለያው አለ)፣ የ`release/*` ruleset አሁንም መሰረዝን እና force-pushን ይከለክላል፣ እንዲሁም
|
||||
`stable/v3` እና `develop` ገና የሉም)፣ ሁለቱን የbranch ደረጃዎች፣ የትኞቹ የቦዘኑ workflow
|
||||
triggerዎች እና `if:` ሁኔታዎች true እንደሚሆኑ (እና የትኞቹ በrepository variable
|
||||
እንደታገዱ ወይም ወደ canonical repository እንደተወሰኑ)፣ የሚጠበቁ dist-tagዎችን (`latest` → 3.9.0፣
|
||||
|
||||
@@ -136,34 +136,22 @@ job ሳይያያዝበት RAM እና CPU መጠቀሙን ይቀጥላል። እ
|
||||
ደቂቃ፣ ከdisk ላይ upload ለመደረግ ደግሞ 2 ደቂቃ ወስዷል።
|
||||
- `.15` VPS ለhomologation ብቻ ነው — CI runnersን ፈጽሞ አያስኬድም።
|
||||
|
||||
## የተስተናገደ መስመር (በGitHub የሚስተናገዱ runners)
|
||||
## የተስተናገደ መስመር (GitHub-የተስተናገዱ ሯጮች)
|
||||
|
||||
repositoryው የ`cheaper-inference` ድርጅት ነው፣ በ**Team** ዕቅድ ላይ፦ **60 በአንድ ጊዜ የሚሰሩ የተስተናገዱ jobs** አሉት፤ እነዚህም በድርጅቱ ውስጥ ባሉ ሁሉም repositories፣ በእያንዳንዱ PR ፍተሻ፣ በእያንዳንዱ በpush በሚነሳ workflow እና በCodeQL ነባሪ ቅንብር መካከል ይጋራሉ። ከዚህ በታች ያሉት አሃዞች የተለኩት በ**Pro** ዕቅድ ላይ ነው (40 በአንድ ጊዜ የሚሰሩ የተስተናገዱ jobs)። በ2026-10-18 በአንድ
|
||||
የማዋሃድ ዘመቻ ወቅት (~10 merges/hour በ`release/v3.8.52`) የተለካው፦ በ
|
||||
24 h ውስጥ **2,500 workflow runs ተፈጥረዋል**፣ በ6 h ውስጥ ወደ branch 44 pushes ተደርገዋል፣
|
||||
PR ፍተሻዎች ለሰዓታት ሲጠብቁ **106 hosted jobs ወረፋ ይዘዋል**፣ እና PR-ዎች ያለእነሱ
|
||||
ተዋህደዋል። ወደ branch በተደረገ እያንዳንዱ push ላይ ዘጠኝ workflows ተነስተዋል፦
|
||||
ማከማቻው `cheaper-inference` ድርጅት ነው፣ በ** ቡድን** እቅድ፡-** 60 በአንድ ጊዜ የሚስተናገዱ ስራዎች** ፣ በድርጅቱ ውስጥ ባሉ እያንዳንዱ ማከማቻዎች የተጋራ ፣ እያንዳንዱ PR ቼክ ፣ እያንዳንዱ የግፋ-ቀስቃሽ የስራ ፍሰት እና CodeQL ነባሪ ማዋቀር። ከታች ያሉት ምስሎች በ ላይ ይለካሉ** ፕሮ** እቅድ (40 በአንድ ጊዜ የሚስተናገዱ ስራዎች). በ2026-10-18 በውህደት ዘመቻ ጊዜ (~ 10 merges/hour on `release/v3.8.52`):** በ24 ሰአት ውስጥ 2,500 የስራ ሂደት ተፈጥሯል።** በ 6 ሰዓት ውስጥ 44 ወደ ቅርንጫፉ ይገፋፋል ፣** 106 የተስተናገዱ ስራዎች ተሰልፈዋል** PR ቼኮች ለሰዓታት ሲጠበቁ እና PRs ያለ እነርሱ ተቀላቅለዋል. በእያንዳንዱ ግፋ ወደ ቅርንጫፉ ላይ ዘጠኝ የስራ ፍሰቶች ተኮሱ፡-
|
||||
|
||||
| በእያንዳንዱ push ወደ `release/v*` | የተስተናገዱ jobs | በውድቀት ማዕበሉ ወቅት የነበረው ውጤት | ከ2026-10-18 ጀምሮ |
|
||||
| ------------------------------------------- | -----------: | ------------------------------------------------------------------ | ------------------------------------------------------------------------ |
|
||||
| `ci.yml` (ሙሉ matrix) | እስከ 30 | በሚቀጥለው push ተሰርዟል፣ በአንድ ቀን ውስጥ 24 ከ24 | በ`release/**` pushes ላይ አልተጀመረም (PR run + Release-Green) |
|
||||
| `quality.yml` | ~6 | ተሰርዟል፣ 23 ከ23 | በ`release/**` pushes ላይ አልተጀመረም |
|
||||
| `Release-Green` `--quick` | 0 | በ`omni-build` ላይ ሰርቷል፣ 97 ከ100 ተሰርዟል | `omni-release` slot፣ ፈጽሞ አይሰረዝም፣ pending run ይጠቀለላል |
|
||||
| `Lock released branch`, `OpenSSF Scorecard` | 2 | በእያንዳንዱ push አንድ run ወረፋ ይዟል | በእያንዳንዱ ref አንድ run (`tests/unit/build/hosted-lane-concurrency.test.ts`) |
|
||||
| `Release acceptance` (የshadow ሪፖርት) | 1 | በእያንዳንዱ push አንድ የተስተናገደ `npm ci`፣ ፈጽሞ አልተሰረዘም | አልተለወጠም — ለ`paths:` filter እጩ ነው |
|
||||
| `Publish to Docker Hub` → `Deploy to VPS` | 2 | በእያንዳንዱ push ተሰርዟል፤ amd64 leg በ`omni-build` ላይ ይወዳደራል | አልተለወጠም — የባለቤቱ deploy ቻናል |
|
||||
| CodeQL ነባሪ ቅንብር (`dynamic`) | 4 | በእያንዳንዱ push `javascript-typescript`፣ `actions`፣ `c-cpp`፣ `python` | አልተለወጠም — Settings → Code security፤ `c-cpp`/`python` እዚህ ምንም አይቃኙም |
|
||||
| በአንድ ግፊት ወደ `release/v*` | የተስተናገዱ ስራዎች | በአውሎ ነፋሱ ስር ያለው ውጤት | ከ2026-10-18 ጀምሮ |
|
||||
| ------------------------------------------- | -----------: | -------------------------------------------------------------- | ------------------------------------------------------------------- |
|
||||
| `ci.yml` (ሙሉ ማትሪክስ) | እስከ 30 | በአንድ ቀን ውስጥ 24 ከ 24 በሚቀጥለው ግፊት ተሰርዟል። | በ `release/**` ግፊቶች ላይ አልተጀመረም (PR run + መልቀቅ-አረንጓዴ) |
|
||||
| `quality.yml` | ~6 | ተሰርዟል፣ 23 ከ23 | በ `release/**` ግፊት አልተጀመረም። |
|
||||
| `Release-Green` `--quick` | 0 | `omni-build` ላይ ሮጦ፣ 97 ከ100 ተሰርዟል። | `omni-release` ማስገቢያ፣ በጭራሽ አልተሰረዘም፣ በመጠባበቅ ላይ ያለ ሩጫ ይወድቃል |
|
||||
| `Lock released branch`, `OpenSSF Scorecard` | 2 | አንድ ወረፋ ሩጫ በአንድ ግፊት | አንድ ሩጫ በአንድ ሪፍ (`tests/unit/build/hosted-lane-concurrency.test.ts`) |
|
||||
| `Release acceptance` (የጥላ ዘገባ) | 1 | አንድ የተስተናገደ `npm ci` በአንድ ግፊት፣ በጭራሽ አልተሰረዘም | ለ `paths:` ማጣሪያ ያልተለወጠ — እጩ |
|
||||
| `Publish to Docker Hub` → `Deploy to VPS` | 2 | በአንድ ግፊት ተሰርዟል; amd64 እግር `omni-build` ላይ ይወዳደራል። | ያልተለወጠ — ባለቤት የማሰማራት ሰርጥ |
|
||||
| CodeQL ነባሪ ማዋቀር (`dynamic`) | 4 | `javascript-typescript`, `actions`, `c-cpp`, `python` በአንድ ግፊት | ያልተለወጠ — ቅንብሮች → ኮድ ደህንነት; `c-cpp`/`python` እዚህ ምንም አይቃኝም። |
|
||||
|
||||
`tests/unit/build/push-storm-diet.test.ts` የ`ci.yml` እና
|
||||
`quality.yml` የ`main`-ብቻ push triggerን ያረጋግጣል። የጎንዮሽ ውጤት፦ Codecov ከእንግዲህ በእያንዳንዱ release push የbase upload
|
||||
አያገኝም (ደረጃው ለመረጃ ብቻ ነው እና `continue-on-error` ተደርጎለታል)፤ በrepository ውስጥ ያለው coverage gate እና PR comment
|
||||
አልተነኩም።
|
||||
`tests/unit/build/push-storm-diet.test.ts` የ `main` -only የግፋ ማስጀመሪያን የዝቅድ እና `ci.yml` ፒን ያያል `quality.yml` የጎንዮሽ ጉዳት: Codecov ከአሁን በኋላ የመሠረት ሰቀላ በእያንዳንዱ ልቀት ግፊት አይቀበልም (እርምጃው መረጃዊ እና `continue-on-error` ነው); የውስጠ-repo ሽፋን በር እና PR አስተያየት አልተነኩም።
|
||||
|
||||
**ተጨማሪ self-hosted capacity የhosted queueን አያስተካክልም።** devbox
|
||||
(`devbox-vm-06-dev002`፣ 24 vCPU / 54 GB) runner ማስተናገድ ይችላል፣ ነገር ግን agent sessions አስቀድመው
|
||||
loadን በ20–26 ያቆዩታል፣ agent container Docker daemon የለውም፣ እና ሙሉ በሙሉ የተጨናነቀው መስመር
|
||||
hosted የሆነው ነው። በዚያው ጊዜ `.113` box 71 GB ነፃ ቦታ እና 5–8 load ነበረው፤ ገደቡ
|
||||
ከላይ ያለው የእያንዳንዱ listener የmemory budget ነው (ከፍተኛው 6 listeners)፣ CPU አይደለም። የቀሩት መፍትሔዎች
|
||||
የሂደት ለውጦች ናቸው፦ የዘመቻ PR-ዎችን በMergify queue (`label=queue`) በኩል ማዋሃድ፣ batches
|
||||
ለእያንዳንዱ PR አንድ run እና ለእያንዳንዱ push አንድ run ከመፍጠር ይልቅ አንድ `merge_group` CI run
|
||||
ይጋራሉ፤ የCodeQL ነባሪ-ቅንብር languagesን መቀነስ፣ እና `release-acceptance.yml`ን በሚያነባቸው files መሠረት ማጣራት።
|
||||
**የበለጠ በራሱ የሚስተናገድ አቅም የተስተናገደውን ወረፋ አያስተካክለውም።** ዴቭቦክስ (`devbox-vm-06-dev002`፣ 24 vCPU / 54 GB) ሯጭን ሊያስተናግድ ይችላል፣ ነገር ግን የወኪሉ ክፍለ ጊዜዎች ጭነቱን በ20-26 ያቆዩታል፣ የወኪሉ መያዣ ምንም Docker ዴሞን የለውም፣ እና የሳቹሬትድ ሌይን የሚስተናገደው ነው። የ `.113` ሳጥኑ 71 GB ነፃ እና በተመሳሳይ ጊዜ 5-8 ጭነት ነበረው; እገዳው ከላይ ያለው የአድማጭ ማህደረ ትውስታ በጀት ነው (ጣሪያ 6 አድማጮች) እንጂ CPU አይደለም። የተቀሩት ዘንጎች የሂደቱ ናቸው፡ የመሬት ዘመቻ PRs በ Mergify ወረፋ (`label=queue`፣ batches share share one `merge_group` CI run a run per PR plus one per push)፣ CodeQL ነባሪ ማዋቀሪያ ቋንቋዎችን ይከርክሙ እና `release-acceptance.yml` በሚያነቡ ፋይሎች ያጣሩ።
|
||||
|
||||
> **2026-11-19፡ የመርግፋይ ውህደት ወረፋ ጡረታ ወጥቷል።** (የባለቤቱ ውሳኔ). `.mergify.yml` ከአሁን በኋላ ወረፋን አይገልጽም እና የመሳብ ጥያቄን የሚያዋህዱ ወይም የሚጽፉ የ Mergify ትዕዛዞችን አይቀበልም። ልቀቅ PRs በማከማቻ ደንቡ መሠረት "በነቃ ልቀቱ ላይ አረንጓዴ በሮች ጠይቅ" (`Gate / CI` + `Gate / Quality`) omni-ወረፋ በቀጥታ ሁነታ ላይ እስኪሄድ ድረስ እና ከዚያ በኋላ በኦምኒ ወረፋ ( [OMNI_QUEUE.md](./OMNI_QUEUE.md) ) ስር ይደባለቃሉ። ከላይ ያለው የሜርጂፋይ ዱላ ከአሁን በኋላ የለም።
|
||||
|
||||
@@ -19,7 +19,7 @@
|
||||
|
||||
### قبول المرشح
|
||||
|
||||
يصدر كل من سير عمل CI وQuality Gates حكمًا ثابتًا: `Gate / CI` و `Gate / Quality`. تعداد سياسة القبول الخاصة بهم كل وظيفة تمهيدية كما هو مطلوب أو استشاري. يجب أن تنجح المهمة المطلوبة القابلة للتطبيق: لا يمكن للنتائج المفقودة أو الملغاة أو التي تم تخطيها أو المعلقة أو غير المعروفة إنشاء PASS. يمكن أن يؤدي التصنيف الصالح للمستندات فقط أو الكتالوج فقط إلى جعل مسار التعليمات البرمجية غير قابل للتطبيق؛ مشروع PR ليس مرشحا مقبولا. تسمية `hotfix` لا تتنازل عن الأدلة.
|
||||
يصدر كل من سير عمل CI وQuality Gates حكمًا ثابتًا: `Gate / CI` و `Gate / Quality`. تعدد سياسة القبول الخاصة بهم كل وظيفة تمهيدية كما هو مطلوب أو استشاري. يجب أن تنجح المهمة المطلوبة القابلة للتطبيق: لا يمكن للنتائج المفقودة أو الملغاة أو التي تم تخطيها أو المعلقة أو غير المعروفة إنشاء PASS. يمكن أن يؤدي التصنيف الصالح للمستندات فقط أو الكتالوج فقط إلى جعل مسار التعليمات البرمجية غير قابل للتطبيق؛ مشروع PR ليس مرشحا مقبولا. تسمية `hotfix` لا تتنازل عن الأدلة.
|
||||
|
||||
يغطي كلا سير العمل PRs في فروع main/release ، ويدفع إلى `main`، والإرسال اليدوي، وأحداث دمج المجموعة. يقوم الدفع والإرسال ودمج المجموعة بتشغيل التحديد الكامل. لا تبدأ عمليات الدفع إلى `release/**` (18/10/2026): كل تغيير قام بالفعل بتشغيل المصفوفة على PR الخاص به والتركيبة المدمجة هي مهمة Release-Green (مسار `docs/ops/RUNNER_BOX.md` → المستضاف). تستخدم الشوكات ومجموعات الدمج برامج تشغيل مستضافة للوظائف التي تحدد برامج تشغيل مستضافة ذاتيًا؛ ويجب التحقق من السعة المستضافة الكافية قبل بدء التشغيل.
|
||||
|
||||
@@ -29,6 +29,8 @@
|
||||
|
||||
### دمج قائمة الانتظار
|
||||
|
||||
> **19-11-2026: تم إيقاف قائمة انتظار دمج Mergify** (قرار المالك). لم يعد `.mergify.yml` يحدد قائمة الانتظار ويرفض أوامر Mergify التي تدمج طلب السحب أو تعيد كتابته. يتم دمج الإصدار PRs يدويًا ضمن مجموعة قواعد المستودع "يتطلب بوابات خضراء عند الإصدار النشط" (`Gate / CI` + `Gate / Quality`) حتى يتم تشغيل قائمة الانتظار المتعددة في الوضع المباشر، ومن خلال قائمة الانتظار المتعددة بعد ذلك ( [OMNI_QUEUE.md](../ops/OMNI_QUEUE.md) ). لا تزال معالجة سير العمل لمسودات Mergify الموضحة أدناه في `ci.yml` و `quality.yml`، ولكن لم يتم فتح مسودة Mergify بعد الآن.
|
||||
|
||||
ترسل تسمية `queue` PR إلى قائمة انتظار Mergify (`.mergify.yml`). يفتح Mergify مسودة PR على فرع `mergify/merge-queue/` ، ويقوم CI بتشغيل التحديد الكامل هناك، ويتم دمج PR الأصلي عند مرور `Gate / CI` و `Gate / Quality` و `Merge integrity (changelog + generated skills)`.
|
||||
|
||||
يقوم Mergify بكتابة ملخص قائمة الانتظار الخاصة به في وصف المسودة، ويمكن للتطبيقات الأخرى تحريره أيضًا. يأخذ حدث `pull_request` `edited` في مثل هذه المسودة مجموعة التزامن الخاصة به (`-queue-edit-<run_id>`) لذا لا يمكنه إلغاء التشغيل الحقيقي للمسودة، ويتخطى البوابة والمصفوفة. فقط `Merge integrity` لا يزال يعمل. تحمل وظيفة البوابة التي تم تخطيها اسم فحص مختلف، لأن Mergify يقرأ `Gate / CI` الذي تم تخطيه باعتباره فحصًا فاشلاً ويضع PR في قائمة الانتظار.
|
||||
@@ -55,12 +57,12 @@
|
||||
|
||||
`.github/workflows/quality.yml` يكمل CI على main/release PRs، ويدفع إلى `main`، ويرسل ويدمج المجموعات. يستخدم PRs عمليات الفحص السريع التي تمت تصفيتها بواسطة المسار. تمت إزالة البنية المكررة المعطلة نهائيًا؛ الشيكات build/package/boot الحقيقية تبقى في CI. يتم تشغيل جناح الوحدة وvitest فقط في CI (`Unit Tests (N/8)` و `Vitest`).
|
||||
|
||||
| وظيفة | نِطَاق | الحظر |
|
||||
| ------------------------------------------------ | -------------------------------------------------------------------------------------------------------------------------------------------- | --------------------- |
|
||||
| `Docs Gates (fast-path)` | Docs/code PRs; مراجع مستندات API وdocs-all | نعم |
|
||||
| `Fast Quality Gates` | كود PRs; عمليات الفحص الثابتة، والتحقق من الكتابة، والتحقق من لوحة المعلومات، واختبارات الوحدة المتأثرة، واختبارات الأخوة المنسية (استشارية) |
|
||||
| `No new ESLint warnings` | كود PRs; واقي الوبر المدرك للقمع | نعم، بما في ذلك الشوك |
|
||||
| `Merge integrity (changelog + generated skills)` | PRs غير مسودة ؛ سجل التغيير ومزامنة المهارات التي تم إنشاؤها | نعم، بما في ذلك الشوك |
|
||||
| وظيفة | نِطَاق | الحظر |
|
||||
| ------------------------------------------------ | ------------------------------------------------------------------------------------------------------------------------------------------- | --------------------- |
|
||||
| `Docs Gates (fast-path)` | Docs/code PRs; مراجع مستندات API وdocs-all | نعم |
|
||||
| `Fast Quality Gates` | كود PRs; عمليات الفحص الثابتة، والتحقق من الكتابة، والتحقق من لوحة المعلومات، واختبارات الوحدة المتأثرة، واختبارات الأخوة المنسية (استشاري) |
|
||||
| `No new ESLint warnings` | كود PRs; واقي الوبر المدرك للقمع | نعم، بما في ذلك الشوك |
|
||||
| `Merge integrity (changelog + generated skills)` | PRs غير مسودة ؛ سجل التغيير ومزامنة المهارات التي تم إنشاؤها | نعم، بما في ذلك الشوك |
|
||||
|
||||
#### تقرير اختبارات الأخوة المنسية
|
||||
|
||||
@@ -72,39 +74,39 @@
|
||||
|
||||
يعمل على كل PR إلى `main`. دمج الكتل عند الفشل.
|
||||
|
||||
| السيناريو (`npm run ...`) | التحقق من صحة | الحظر |
|
||||
| --------------------------------- | -------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | ---------------------------------------- |
|
||||
| `check:node-runtime` | إصدار Node.js ضمن النطاق المدعوم | نعم |
|
||||
| `check:cycles` | الواردات الدائرية عبر جميع `src/` + `open-sse/` (المعتمدة على AST، والتي تم حلها بواسطة tsconfig `paths` ). يخرج Bare 1 عند وجود أي دورة (تم إغلاق الفشل منذ #15281) ويسرد SCCs. يتم حظر `check:cycles:ratchet` (ما يعمله CI ) عندما يتجاوز العدد سقف `metrics.cycles` في `quality-baseline.json` — حاليًا 14، `direction: down`، لذلك يمكن أن يسقط فقط (#15159 G-01/G-02) | نعم (السقاطة) |
|
||||
| `check:boundary` | اقتران `open-sse → src` : عمليات استيراد فريدة من ملف إلى ملف من المحرك إلى التطبيق (`scripts/quality/measure-boundary.mjs`؛ قائمة الحافة هي تراكم معالجة v4 core/module-split ). التقرير الاستشاري لـ = (مثل `quality:boundary`). `check:boundary:ratchet` (ما يتم تشغيله CI ، أيضًا في حلقة السقاطة ذات البوابات السريعة `quality.yml` ) يتم حظره عندما يتجاوز العدد سقف `metrics.boundaryOpenSseToSrc` في `quality-baseline.json` — المصنف عند القياس 771، `direction: down`؛ `--update` يخفضه فقط؛ قاعدة نسبية على PRs (`--base-ref`، انظر أدناه) | نعم (السقاطة) |
|
||||
| `check:route-validation:t06` | مخططات Zod موجودة على كافة المسارات (سياسة المستوى 6) | نعم |
|
||||
| `check:any-budget:t11` | عدد `@ts-expect-error // any` لا يتجاوز الميزانية (المستوى 11 catraca) | نعم |
|
||||
| `check:provider-consistency` | كل مزود في `providers.ts` لديه إدخال مطابق في `providerRegistry.ts` (والعكس صحيح، ضمن القائمة المسموح بها). | نعم |
|
||||
| `check:model-lifecycle` | تظل جداول التوجيه الثلاثة التي يتم صيانتها يدويًا متسقة مع لقطة دورة الحياة التي تم تسجيلها (#11503): `FITNESS_TABLE` (`taskFitness.ts`) لا يسجل أي معرف متقاعد يمكن لـ `REGISTRY` توجيهه؛ كل هدف `BUILT_IN_ALIASES` موجود في `REGISTRY` وهو غائب عن لقطة المعرف المتقاعد؛ تتم إعادة توجيه كل معرف متقاعد لا يزال في `REGISTRY` أو إدراجه في `allowedRetiredInCatalog`؛ ولا يظهر أي مصدر أو هدف `DEFAULT_DEGRADATION_MAP` متقاعدًا في تلك اللقطة. هذا لا يثبت أن النموذج يتم تقديمه حاليًا بواسطة البث المباشر. تتم مقارنة — دون الاتصال بـ `config/quality/model-lifecycle.json`، ويتم تحديثه يدويًا باستخدام `npm run quality:refresh-model-lifecycle` (شبكة؛ غير موصلة بـ CI). `allowedRetiredInCatalog` عبارة عن سقاطة محترق: قم بإضافة إدخال فقط مع وجود مشكلة في التتبع. | نعم |
|
||||
| `check:fetch-targets` | كل `fetch("/api/...")` في `src/` من جانب العميل يتحول إلى `route.ts` حقيقي | نعم |
|
||||
| `check:deps` | جميع `npm install` -able deps عبر كل `package.json` في الريبو موجودة في `dependency-allowlist.json`؛ تم وضع علامة على الحزم الجديدة غير المثبتة أو المائلة | نعم |
|
||||
| `audit:deps` | تدقيق npm لجميع ملفات القفل الخمسة المستقلة (root، Electron، OpenCode plugins، v1/v2 وprovider). كتلة النصائح الهامة؛ تظل التحذيرات العالية تحذيرات مرئية. عمليات تدقيق Missing/failed هي INCOMPLETE وblock؛ يتم الاحتفاظ بتجزئة القفل والتقارير لكل نطاق. | نعم |
|
||||
| `check:lockfile` | تسجيل `package-lock.json` Integrity — https، تجزئة التكامل، لا يوجد تجاوزات للمضيف | نعم |
|
||||
| `check:licenses` | القائمة المسموح بها لترخيص SPDX لتبعيات الإنتاج | نعم |
|
||||
| `check:tracked-artifacts` | لا توجد عناصر بناء / روابط `node_modules` الرمزية المخصصة (يتم تشغيلها أيضًا في الالتزام المسبق الهاسكي؛ الدفع المسبق خفيف عمدًا — #6716) | نعم |
|
||||
| `check:ai-attribution` | لا يوجد مقطع دعائي AI/bot `Co-Authored-By` أو تذييل جيل الذكاء الاصطناعي في عمليات PR أو العنوان أو النص — Hard Rule #16 (في حلقة `quality.yml` fast-gates لـ PR→ `release/**` — يقرأ حمولة الحدث، no-op off PRs — وخطوة العلاقات العامة فقط في `ci.yml` lint لـ PR→ `main`؛ وأيضًا خطاف `commit-msg` الهاسكي؛ يُسمح للمؤلفين المشاركين من البشر؛ #14436) |
|
||||
| `check:vitest-exclusions` | يشير كل استبعاد Vitest إلى مشكلة تتبع ويظهر في `config/quality/vitest-exclusions.json` (#13204) | نعم |
|
||||
| `check:file-size` | ملفات المصدر (`.ts`/`.tsx` في `src/`، `open-sse/`، `electron/`، `bin/`) تبقى ضمن `cap` وملفات الاختبار (`*.test.ts(x)`) داخل `testCap`؛ الملفات المجمدة في `file-size-baseline.json` (`frozen` / `testFrozen`) يجب ألا تتجاوز حجمها المسجل | نعم |
|
||||
| `check:error-helper` | استجابات الخطأ في executors/handlers تستخدم `buildErrorBody()` / `sanitizeErrorMessage()` (القاعدة الصعبة #12) | نعم |
|
||||
| `check:migration-numbering` | أسماء ملفات الترحيل: تم تجميد سلسلة `001`–`241` القديمة والملفات الجديدة هي `YYYYMMDDHHMMSS_<description>.sql`. مقابل قاعدة PR فإنها ترفض الترحيل المحذوف، والترحيل المعاد تسميته دون إدخال توافق، والترحيل خارج الترتيب أو المحرر والذي لا يتم تغيير مخططه النهائي |
|
||||
| `check:public-creds` | لا توجد مفاتيح OAuth `client_id`/`client_secret` أو Firebase Web حرفية خارج `publicCreds.ts` (القاعدة الصلبة #11) | نعم |
|
||||
| `check:db-rules` | لا يوجد SQL خام خارج وحدات `src/lib/db/` ؛ لا توجد واردات برميل من `localDb.ts` (القواعد الصارمة #2/#5) | نعم |
|
||||
| `check:known-symbols` | يتطابق منفذو الموفر واستراتيجيات التوجيه والمترجمون المسجلون في جداول الإرسال الخاصة بهم مع الملفات الموجودة على القرص — ولا توجد رموز معزولة أو غير معلنة | نعم |
|
||||
| `check:route-guard-membership` | يتم تصنيف كل مسار يولد عملية فرعية حسب `isLocalOnlyPath()` (القواعد الصارمة #15/#17) | نعم |
|
||||
| `check:test-discovery` | يتم جمع كل ملف `*.test.ts` / `*.spec.ts` في الريبو بواسطة عداء اختبار واحد على الأقل (السقاطة: يمكن تقليص القائمة اليتيمة في `test-discovery-baseline.json` فقط) | نعم |
|
||||
| `check:test-tla-order` | لا يوجد ملف `node:test` ضمن `tests/unit` يسجل اختبارًا، ويصل إلى `await` عالي المستوى، ثم يسجل المزيد (#18045; اسئلة: `test-tla-order-allowlist.json` يمكن أن يتقلص فقط) | نعم |
|
||||
| `check:agent-skills-sync` | تتوافق عناصر مهارات العميل التي تم إنشاؤها مع كتالوج المصدر الخاص بها (بدون انحراف). وضع الإصدار يتحقق من كل مهارة؛ تعمل ميزة PR (وضع `pr` ) على التحقق فقط من المهارات التي يقوم بتحرير النص الذي تم إنشاؤه — راجع [الملفات التي تم إنشاؤها وخطوط الأساس المشتقة](#generated-files-and-derived-baselines-written-at-release) |
|
||||
| `check:provider-asset-provenance` | مزود logos/assets يحمل إدخال مصدر مسجل |
|
||||
| `lint:json` | تقوم ملفات التكوين JSON بتحليل وتلبية قواعد الريبو لينت |
|
||||
| `typecheck:core` | تجميع TypeScript بدون أخطاء (التحذيرات الاستشارية فقط) | نعم |
|
||||
| `typecheck:noimplicit:core` | تطلعية صارمة `noImplicitAny` — ؛ لا تزال العديد من مواقع الاتصال الموجودة مسبقًا بحاجة إلى التعليقات التوضيحية | **استشارية** (`continue-on-error: true`) |
|
||||
| `check:dashboard-typecheck` | تم تحديد نطاق `tsc` إلى `src/app/(dashboard)/**` (#7033) — `typecheck:core` لا تتضمن القائمة المسموح بها المكونة من 27 ملفًا أي لوحة معلومات TSX، ولم يتحقق `next build` أبدًا من الكتابة أيضًا (`next.config.mjs` يحدد `ignoreBuildErrors: true`) ، لذلك كانت انحدارات المعرف اليتيم هناك (#6625/#6909) غير مرئية لـ CI. يختلف عن خط الأساس لعدد per-file/per-TS-code المجمد (`config/quality/dashboard-typecheck-baseline.json`، نفس نمط الإنفاذ الذي لا معنى له مثل `check:known-symbols`) — فقط أخطاء NEW التي تتجاوز العد الأساسي تفشل في البوابة؛ قم بالسحب لأسفل باستخدام `--update` عند إصلاح خطأ موجود مسبقًا. | نعم |
|
||||
| `check:build-typecheck` | التحقق من نوع إنتاج التطبيق بالكامل عبر `tsconfig.build.json` (`src`, `open-sse`, `packages`, `bin`, `scripts`, `electron/**/*.d.ts`)، ولا تغطي القائمة المسموح بها المكونة من 27 ملفًا لـ `typecheck:core` السطحي وبوابة لوحة المعلومات. يختلف ضد `config/quality/build-typecheck-baseline.json`; يفشل عدد جديد أو مرتفع لكل (ملف، رمز)، ويطلب منك عدد أقل التصعيد. يرفض `--update` بينما يحتوي التشغيل على زوج جديد أو مرفوع ما لم يتم تمرير `--force-regressions` ، ويرفض ملفًا تم إسكاته حديثًا ما لم يتم تمرير `--force-nocheck` ، لذا فإن توسيع خط الأساس للحصول على اللون الأخضر ومنح صمت دائم هما عملان متعمدان منفصلان. تم رفض `--force` العارية. يقوم أيضًا بفحص نطاق البناء لـ `@ts-nocheck` مقابل `config/quality/ts-nocheck-baseline.json`، لأن الملف الذي يستخدمه لا يُبلغ عن أي تشخيصات على الإطلاق، وإلا سيكون غير مرئي لكل بوابة. | نعم |
|
||||
| السيناريو (`npm run ...`) | التحقق من صحة | الحظر |
|
||||
| --------------------------------- | --------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | ---------------------------------------- |
|
||||
| `check:node-runtime` | إصدار Node.js ضمن النطاق المدعوم | نعم |
|
||||
| `check:cycles` | الواردات الدائرية عبر جميع `src/` + `open-sse/` (المعتمدة على AST، والتي تم حلها بواسطة tsconfig `paths` ). يخرج Bare 1 عند وجود أي دورة (تم إغلاق الفشل منذ #15281) ويسرد SCCs. يتم حظر `check:cycles:ratchet` (ما يعمله CI ) عندما يتجاوز العدد سقف `metrics.cycles` في `quality-baseline.json` — حاليًا 14، `direction: down`، لذلك يمكن أن يسقط فقط (#15159 G-01/G-02) | نعم (السقاطة) |
|
||||
| `check:boundary` | اقتران `open-sse → src` : عمليات استيراد فريدة من ملف إلى ملف من المحرك إلى التطبيق (`scripts/quality/measure-boundary.mjs`؛ قائمة الحافة هي تراكم معالجة v4 core/module-split ). التقرير الاستشاري لـ = (مثل `quality:boundary`). `check:boundary:ratchet` (ما يتم تشغيله CI ، أيضًا في حلقة السقاطة ذات البوابات السريعة `quality.yml` ) يتم حظره عندما يتجاوز العدد سقف `metrics.boundaryOpenSseToSrc` في `quality-baseline.json` — المصنف عند القياس 771، `direction: down`؛ `--update` يخفضه فقط؛ قاعدة نسبية على PRs (`--base-ref`، انظر أدناه) | نعم (السقاطة) |
|
||||
| `check:route-validation:t06` | مخططات Zod موجودة على كافة المسارات (سياسة المستوى 6) | نعم |
|
||||
| `check:any-budget:t11` | عدد `@ts-expect-error // any` لا يتجاوز الميزانية (المستوى 11 catraca) | نعم |
|
||||
| `check:provider-consistency` | كل مزود في `providers.ts` لديه إدخال مطابق في `providerRegistry.ts` (والعكس صحيح، ضمن القائمة المسموح بها). | نعم |
|
||||
| `check:model-lifecycle` | تظل جداول التوجيه الثلاثة التي يتم صيانتها يدويًا متسقة مع لقطة دورة الحياة التي تم تسجيلها (#11503): لا يسجل `FITNESS_TABLE` (`taskFitness.ts`) أي معرف متقاعد يمكن لـ `REGISTRY` توجيهه؛ كل هدف `BUILT_IN_ALIASES` موجود في `REGISTRY` وهو غائب عن لقطة المعرف المتقاعد؛ تتم إعادة توجيه كل معرف متقاعد لا يزال في `REGISTRY` أو إدراجه في `allowedRetiredInCatalog`؛ ولا يظهر أي مصدر أو هدف `DEFAULT_DEGRADATION_MAP` متقاعدًا في تلك اللقطة. هذا لا يثبت أن النموذج يتم تقديمه حاليًا بواسطة البث المباشر. تتم مقارنة — دون الاتصال بالإنترنت مع `config/quality/model-lifecycle.json`، ويتم تحديثه يدويًا باستخدام `npm run quality:refresh-model-lifecycle` (شبكة؛ غير متصلة بـ CI). `allowedRetiredInCatalog` عبارة عن سقاطة محترق: قم بإضافة إدخال فقط مع وجود مشكلة في التتبع. | نعم |
|
||||
| `check:fetch-targets` | كل `fetch("/api/...")` في `src/` من جانب العميل يتحول إلى `route.ts` حقيقي | نعم |
|
||||
| `check:deps` | جميع `npm install` -able deps عبر كل `package.json` في الريبو موجودة في `dependency-allowlist.json`؛ تم وضع علامة على الحزم الجديدة غير المثبتة أو المائلة | نعم |
|
||||
| `audit:deps` | تدقيق npm لجميع ملفات القفل الخمسة المستقلة (root، Electron، OpenCode plugins، v1/v2 وprovider). كتلة النصائح الهامة؛ تظل التحذيرات العالية تحذيرات مرئية. عمليات تدقيق Missing/failed هي INCOMPLETE وblock؛ يتم الاحتفاظ بتجزئة القفل والتقارير لكل نطاق. | نعم |
|
||||
| `check:lockfile` | تسجيل `package-lock.json` Integrity — https، تجزئة التكامل، لا يوجد تجاوزات للمضيف | نعم |
|
||||
| `check:licenses` | القائمة المسموح بها لترخيص SPDX لتبعيات الإنتاج | نعم |
|
||||
| `check:tracked-artifacts` | لا توجد عناصر بناء / روابط `node_modules` الرمزية المخصصة (يتم تشغيلها أيضًا في الالتزام المسبق الهاسكي؛ الدفع المسبق خفيف عمدًا — #6716) | نعم |
|
||||
| `check:ai-attribution` | لا يوجد مقطع دعائي AI/bot `Co-Authored-By` أو تذييل جيل الذكاء الاصطناعي في عمليات PR أو العنوان أو النص — Hard Rule #16 (في حلقة `quality.yml` fast-gates لـ PR→ `release/**` — يقرأ حمولة الحدث، no-op off PRs — وخطوة العلاقات العامة فقط في `ci.yml` lint لـ PR→ `main`؛ وأيضًا خطاف `commit-msg` الهاسكي؛ يُسمح للمؤلفين المشاركين من البشر؛ #14436) |
|
||||
| `check:vitest-exclusions` | يشير كل استبعاد Vitest إلى مشكلة تتبع ويظهر في `config/quality/vitest-exclusions.json` (#13204) | نعم |
|
||||
| `check:file-size` | ملفات المصدر (`.ts`/`.tsx` في `src/`، `open-sse/`، `electron/`، `bin/`) تبقى ضمن `cap` وملفات الاختبار (`*.test.ts(x)`) داخل `testCap`؛ يجب ألا تتجاوز الملفات المجمدة في `file-size-baseline.json` (`frozen` / `testFrozen`) حجمها المسجل | نعم |
|
||||
| `check:error-helper` | استجابات الخطأ في executors/handlers تستخدم `buildErrorBody()` / `sanitizeErrorMessage()` (القاعدة الصعبة #12) | نعم |
|
||||
| `check:migration-numbering` | أسماء ملفات الترحيل: تم تجميد سلسلة `001`–`241` القديمة والملفات الجديدة هي `YYYYMMDDHHMMSS_<description>.sql`. مقابل قاعدة PR فإنها ترفض الترحيل المحذوف، والترحيل المعاد تسميته دون إدخال توافق، والترحيل خارج الترتيب أو المحرر والذي لا يتم تغيير مخططه النهائي |
|
||||
| `check:public-creds` | لا توجد مفاتيح OAuth `client_id`/`client_secret` أو Firebase Web حرفية خارج `publicCreds.ts` (القاعدة الصلبة #11) | نعم |
|
||||
| `check:db-rules` | لا يوجد SQL خام خارج وحدات `src/lib/db/` ؛ لا توجد واردات برميل من `localDb.ts` (القواعد الصارمة #2/#5) | نعم |
|
||||
| `check:known-symbols` | يتطابق منفذو الموفر واستراتيجيات التوجيه والمترجمون المسجلون في جداول الإرسال الخاصة بهم مع الملفات الموجودة على القرص — ولا توجد رموز معزولة أو غير معلنة | نعم |
|
||||
| `check:route-guard-membership` | يتم تصنيف كل مسار يولد عملية فرعية حسب `isLocalOnlyPath()` (القواعد الصارمة #15/#17) | نعم |
|
||||
| `check:test-discovery` | يتم جمع كل ملف `*.test.ts` / `*.spec.ts` في الريبو بواسطة عداء اختبار واحد على الأقل (السقاطة: يمكن تقليص القائمة اليتيمة في `test-discovery-baseline.json` فقط) | نعم |
|
||||
| `check:test-tla-order` | لا يوجد ملف `node:test` ضمن `tests/unit` يسجل اختبارًا، ويصل إلى `await` عالي المستوى، ثم يسجل المزيد (#18045;ratchet: `test-tla-order-allowlist.json` يمكن أن يتقلص فقط) | نعم |
|
||||
| `check:agent-skills-sync` | تتوافق عناصر مهارات العميل التي تم إنشاؤها مع كتالوج المصدر الخاص بها (بدون انحراف). وضع الإصدار يتحقق من كل مهارة؛ تتحقق ميزة PR (وضع `pr` ) فقط من المهارات التي يقوم بتحرير النص الذي تم إنشاؤها — راجع [الملفات التي تم إنشاؤها وخطوط الأساس المشتقة](#generated-files-and-derived-baselines-written-at-release) |
|
||||
| `check:provider-asset-provenance` | مزود logos/assets يحمل إدخال مصدر مسجل |
|
||||
| `lint:json` | تقوم ملفات التكوين JSON بتحليل وتلبية قواعد الريبو لينت |
|
||||
| `typecheck:core` | تجميع TypeScript بدون أخطاء (التحذيرات الاستشارية فقط) | نعم |
|
||||
| `typecheck:noimplicit:core` | تطلعية صارمة `noImplicitAny` — ؛ لا تزال العديد من مواقع الاتصال الموجودة مسبقًا بحاجة إلى التعليقات التوضيحية | **استشارية** (`continue-on-error: true`) |
|
||||
| `check:dashboard-typecheck` | تم تحديد نطاق `tsc` إلى `src/app/(dashboard)/**` (#7033) — `typecheck:core` لا تتضمن القائمة المسموح بها المكونة من 27 ملفًا أي لوحة معلومات TSX، ولم يتحقق `next build` أبدًا من الكتابة أيضًا (`next.config.mjs` يحدد `ignoreBuildErrors: true`) ، لذلك كانت انحدارات المعرف اليتيم هناك (#6625/#6909) غير مرئية لـ CI. يختلف عن خط الأساس لعدد per-file/per-TS-code المجمد (`config/quality/dashboard-typecheck-baseline.json`، نفس نمط الإنفاذ الذي لا معنى له مثل `check:known-symbols`) — فقط أخطاء NEW التي تتجاوز العد الأساسي تفشل في البوابة؛ قم بالسحب لأسفل باستخدام `--update` عند إصلاح خطأ موجود مسبقًا. | نعم |
|
||||
| `check:build-typecheck` | التحقق من نوع إنتاج التطبيق بالكامل عبر `tsconfig.build.json` (`src`, `open-sse`, `packages`, `bin`, `scripts`, `electron/**/*.d.ts`)، ولا تشمل القائمة المسموح بها لـ `typecheck:core` السطحية المكونة من 27 ملفًا وبوابة لوحة المعلومات. يختلف ضد `config/quality/build-typecheck-baseline.json`; يفشل عدد جديد أو مرتفع لكل (ملف، رمز)، ويطلب منك عدد أقل التصعيد. يرفض `--update` بينما يحتوي التشغيل على زوج جديد أو مرفوع ما لم يتم تمرير `--force-regressions` ، ويرفض ملفًا تم إسكاته حديثًا ما لم يتم تمرير `--force-nocheck` ، لذا فإن توسيع خط الأساس للحصول على اللون الأخضر ومنح صمت دائم هما عملان متعمدان منفصلان. تم رفض `--force` العارية. يقوم أيضًا بفحص نطاق البناء لـ `@ts-nocheck` مقابل `config/quality/ts-nocheck-baseline.json`، لأن الملف الذي يستخدمه لا يُبلغ عن أي تشخيصات على الإطلاق، وإلا سيكون غير مرئي لكل بوابة. | نعم |
|
||||
|
||||
#### هناك برنامجان للتحقق من الكتابة يجيبان بشكل مختلف
|
||||
|
||||
@@ -120,11 +122,11 @@
|
||||
|
||||
| البرنامج النصي | التحقق من صحة | الحظر |
|
||||
| ---------------------------- | ----------------------------------------------------------------------------------------------------------------------------------------------------------- | ----------------------- |
|
||||
| `quality:collect` | يصدر `quality-metrics.json` (عدد تحذيرات ESLint ، التغطية من تقرير الجزء المدمج) | نعم (المنبع من السقاطة) |
|
||||
| `quality:collect` | يصدر `quality-metrics.json` (عدد تحذيرات ESLint ، تغطية من تقرير الجزء المدمج) | نعم (المنبع من السقاطة) |
|
||||
| `quality:ratchet` | لم يتراجع كل مقياس في `quality-baseline.json` (تحذيرات ESLint خط الأساس ≤ ؛ خط الأساس ≥ التغطية) | نعم |
|
||||
| `check:duplication` | لا يتجاوز تكرار الكود (jscpd@4) خط الأساس في `quality-baseline.json` | نعم |
|
||||
| `check:complexity` | لا يتجاوز التعقيد الدوري على مستوى الملف الحد الأقصى (core ESLint `complexity` + `max-lines-per-function`) | نعم |
|
||||
| `check:cognitive-complexity` | سقاطة التعقيد المعرفي (`eslint-plugin-sonarjs`) — تمريرة ESLint منفصلة؛ يعمل CI على حد سواء مدمجين كخطوة `check:complexity-ratchets` الفردية | نعم |
|
||||
| `check:cognitive-complexity` | سقاطة التعقيد المعرفي (`eslint-plugin-sonarjs`) — ممر ESLint منفصل؛ يعمل CI على حد سواء مدمجين كخطوة `check:complexity-ratchets` الفردية | نعم |
|
||||
| `check:dead-code` | لا تتراجع الصادرات/الملفات غير المستخدمة (knip) عن خط الأساس | نعم |
|
||||
| `check:compression-budget` | يجب ألا تتراجع حدود توفير الرمز المميز للميزانية المعيارية للضغط — لكل محرك | نعم |
|
||||
| `check:type-coverage` | السقاطة المكتوبة بنسبة مئوية (`type-coverage`) لا تتراجع؛ يتضمن إلى حد كبير `typecheck:noimplicit:core` | نعم |
|
||||
@@ -133,7 +135,7 @@
|
||||
|
||||
### الوظيفة: `quality-extended`
|
||||
|
||||
وظيفة مختلطة، مع عدم وجود `continue-on-error` على مستوى الوظيفة: الخطوة التي تتجاوز `--ratchet` تفشل الوظيفة على الانحدار المقاس مقابل `quality-baseline.json`. تعتبر `check:circular-deps` وخطوة تثبيت الماسح الضوئي فقط بمثابة خطوات استشارية ( `continue-on-error: true` على مستوى الخطوة). يتم تثبيت الماسحات الضوئية الخارجية عبر `gh release download`؛ `check:secrets` يتخطى نفسه (مخرج 0) عند غياب gitleaks، بينما يفشل `check:vuln-ratchet` و `check:workflows` و `check:openapi-breaking` في الإغلاق عندما يكون قياسهم مفقودًا.
|
||||
وظيفة مختلطة، بدون `continue-on-error` على مستوى الوظيفة: الخطوة التي تتجاوز `--ratchet` تفشل الوظيفة على انحدار مُقاس مقابل `quality-baseline.json`. تعتبر `check:circular-deps` وخطوة تثبيت الماسح الضوئي فقط بمثابة خطوات استشارية ( `continue-on-error: true` على مستوى الخطوة). يتم تثبيت الماسحات الضوئية الخارجية عبر `gh release download`؛ يقوم `check:secrets` بالتخطي الذاتي (المخرج 0) عند غياب gitleaks، بينما يفشل `check:vuln-ratchet` و `check:workflows` و `check:openapi-breaking` في الإغلاق عندما يكون قياسهم مفقودًا.
|
||||
|
||||
| البرنامج النصي | التحقق من صحة | الحظر |
|
||||
| ------------------------ | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------ | --------------------------------------- |
|
||||
@@ -142,7 +144,7 @@
|
||||
| `check:secrets` | يتم تخطي المسح السري (gitleaks) — في حالة غياب الثنائي | **الحظر باستخدام --ratchet** |
|
||||
| `check:vuln-ratchet` | لا تتراجع ثغرات التبعية (osv-scanner) عن فشل — `--ratchet` كـ INCOMPLETE (مخرج 2) إذا لم يتم قياسها | **الحظر باستخدام --ratchet** |
|
||||
| `check:workflows` | لينت سير العمل (actionlint + zizmor)؛ تفشل الماسحات الضوئية missing/broken أو التقارير غير الصالحة أو خط الأساس المفقود في حالة INCOMPLETE. تتبع النتائج الصالحة سياسة strict/advisory/ratchet المحددة | التنفيذ مطلوب؛ zizmor حجب السقاطة في CI |
|
||||
| `check:openapi-breaking` | عقد API العام مقابل تنفيذ الأحداث المثبتة (قاعدة دمج PR ، الدفع قبل، قاعدة مجموعة الدمج؛ scheduled/manual checkout أول أصل)؛ فشل القياس المطلوب مغلقة | **الحظر باستخدام --ratchet** |
|
||||
| `check:openapi-breaking` | عقد API العام ضد عمليات ارتكاب الأحداث المثبتة (قاعدة دمج PR ، الدفع قبل، قاعدة مجموعة الدمج؛ scheduled/manual checkout أول أصل)؛ فشل القياس المطلوب مغلقة | **الحظر باستخدام --ratchet** |
|
||||
|
||||
### الوظيفة: `docs-sync-strict`
|
||||
|
||||
@@ -166,7 +168,7 @@
|
||||
|
||||
#### مرايا الترجمة هي ملفات مشتقة (وضع PR مقابل وضع الإصدار)
|
||||
|
||||
ميزة PR تقوم بتحرير المصادر الإنجليزية فقط. تتم إعادة كتابة مرايا `docs/i18n/<locale>/**` (بما في ذلك نسخ `llm.txt` الـ 66 وملفات `CHANGELOG.md` المترجمة) و `.i18n-state.json` في خطوة واحدة بواسطة موجة الترجمة (فروع `docs/i18n-*` / `chore/i18n-*` ، `i18n-mirror-refresh.yml` المجدولة) ومن خلال الإصدار (`npm run release:sync-changelog-i18n`). لذلك تعمل البوابات المرآة في وضعين، يتم حلها بواسطة `scripts/check/lib/gateMode.mjs` (`--mode=pr|release`، ثم `OMNIROUTE_GATE_MODE`، ثم حدث Actions؛ والتشغيل المحلي هو `release`):
|
||||
ميزة PR تقوم بتحرير المصادر الإنجليزية فقط. تتم إعادة كتابة مرايا `docs/i18n/<locale>/**` (بما في ذلك نسخ `llm.txt` الـ 66 وملفات `CHANGELOG.md` المترجمة) و `.i18n-state.json` في خطوة واحدة بواسطة موجة الترجمة (فروع `docs/i18n-*` / `chore/i18n-*` ، `i18n-mirror-refresh.yml` المجدولة) ومن خلال الإصدار (`npm run release:sync-changelog-i18n`). وبالتالي، تعمل البوابات المرآة في وضعين، يتم حلهما بواسطة `scripts/check/lib/gateMode.mjs` (`--mode=pr|release`، ثم `OMNIROUTE_GATE_MODE`، ثم حدث Actions؛ والتشغيل المحلي هو `release`):
|
||||
|
||||
- يعمل وضع تحرير `check:docs-sync` — على تشغيل كل فحص. يحتفظ وضع PR بإصدار package.json/OpenAPI ، وعناوين الجذر CHANGELOG وحارس المستندات التي تم استبدالها، ويطبع `SKIP reason=pr-mode` لنسخ مرآة `llm.txt` وأقسام CHANGELOG المترجمة — ما لم يكتب PR مرايا: يقوم فرع رئيسي تم الإعلان عنه ككاتب لعائلة `docs/i18n/**` في `config/quality/derived-paths/*.json` بإجراء كلا الفحصين بدقة، وعندما يتم حل قاعدة الاختلاف، فإن التغيير الذي يقوم بتحريره diff `docs/i18n/<locale>/llm.txt` أو `CHANGELOG.md` يقوم بتشغيل هذا الفحص بدقة. لا يتم حل قاعدة الاختلاف في فحص depth-1 (مهمة `docs-sync-strict` )، لذلك يقوم وضع PR أيضًا بإجراء فحص واحد لا يحتاج إلى قاعدة: يجب أن تكون كل مرآة `llm.txt` موجودة، وتحتفظ بفاصل `---` الخاص بها وتحمل إما الجسم الجذر أو الجسم الذي تشترك فيه معظم المرايا. القاعدة التي تحركت تترك جميع المرايا قديمة بشكل متساوٍ وتمر؛ فشل التعديل اليدوي على مرآة واحدة. لا تحتوي ملفات `CHANGELOG.md` المترجمة على مثل هذا الفحص في عملية الدفع depth-1 PR.
|
||||
- يعمل خطاف الالتزام المسبق على تشغيل `check-docs-sync.mjs --mode=pr`: يتم الحكم على الالتزام بناءً على ما يفعله. بدون العلم، يكون التشغيل المحلي هو وضع الإصدار، وسيعمل PR المدمج الذي يحرر الجذر `llm.txt` على منع كل التزام لاحق على تلك القاعدة حتى يتم تشغيل الموجة. تنطبق نفس القاعدة على أي بوابة مدركة للوضع يتم تشغيلها بواسطة خطاف Husky: يمر الخطاف `--mode=pr`، ويظل الحكم الصارم مع تشغيل وضع الإصدار (يدفع الإصدار PR إلى `main`، وهو تشغيل محلي عادي).
|
||||
@@ -179,7 +181,7 @@
|
||||
|
||||
### القيم المشتقة: أوضاع بوابة `pr` و `release`
|
||||
|
||||
الميزة PR لا تكتب أبدًا قيمة تعتمد على حالة قاعدتها: الموفر، والترحيل، وأداة MCP وعدد الاستراتيجيات، وأرقام README SVG ، ولقطات الحقائق. تقوم خطوة واحدة بإعادة حساب كل منهم، `npm run release:refresh-derived`، الذي يتم تشغيله من خلال الإصدار ومن خلال التحديث المشتق ليلاً PR. لذا** بين الإصدارات، تكون القاعدة خلف الكود المباشر حسب التصميم** ، وستكون البوابة أو الاختبار الذي يقارن الشجرة بالرمز المباشر باللون الأحمر في كل PR بعد أن يقوم الأخ بإضافة موفر. وبالتالي فإن البوابات التي تحكم على القيم المشتقة تعمل في أحد الوضعين، ويتم حلها بواسطة `scripts/check/lib/gateMode.mjs` (المباراة الأولى تفوز):
|
||||
الميزة PR لا تكتب أبدًا قيمة تعتمد على حالة قاعدتها: الموفر، والترحيل، وأداة MCP وعدد الاستراتيجيات، وأرقام README SVG ، ولقطات الحقائق. تقوم خطوة واحدة بإعادة حساب كل منهم، `npm run release:refresh-derived`، الذي يتم تشغيله بواسطة الإصدار ومن خلال التحديث المشتق ليلاً PR. لذا** بين الإصدارات، تكون القاعدة خلف الكود المباشر حسب التصميم** ، وستكون البوابة أو الاختبار الذي يقارن الشجرة بالرمز المباشر باللون الأحمر في كل PR بعد أن يقوم الأخ بإضافة موفر. وبالتالي فإن البوابات التي تحكم على القيم المشتقة تعمل في أحد الوضعين، ويتم حلها بواسطة `scripts/check/lib/gateMode.mjs` (المباراة الأولى تفوز):
|
||||
|
||||
1. `--mode=pr|release` في سطر الأوامر؛
|
||||
2. متغير البيئة `OMNIROUTE_GATE_MODE` (`pr` أو `release`) ؛
|
||||
@@ -237,7 +239,7 @@ npm run release:refresh-derived -- --check # what the rele
|
||||
| `check-key-completeness` (مضمنة) | كل كتالوج UI (ومع `--catalog=cli`، كل كتالوج CLI ) يحمل بالضبط مجموعة مفاتيح `en.json` الخاصة به؛ في وضع `pr` ، يتم تغيير كل كتالوج PR ضد نفسه عند قاعدة الدمج | نعم (كلا الوضعين) |
|
||||
| `check-translation-ratio` | يجب ألا تتجاوز نسبة الترجمة الحقيقية لكل لغة (متطابقة مع اللغة الإنجليزية / العنصر النائب / الأوراق المفقودة خارج القائمة المسموح بها) `config/quality/i18n-translation-baseline.json` + slack | نعم (وضع التحرير فقط) |
|
||||
|
||||
يحتاج `fetch-depth: 0` — إلى أن تختلف بوابة انجراف القيمة `en.json` عن قاعدة الدمج.
|
||||
تحتاج إلى `fetch-depth: 0` — حيث تختلف بوابة انجراف القيمة `en.json` عن قاعدة الدمج.
|
||||
|
||||
**وضعين (منذ 2026-11-13).** تضيف ميزة PR أو تعيد كتابة المفاتيح في `en.json` (و `bin/cli/locales/en.json`) ولا تلمس أي لغة أخرى؛ `check:pr-derived-paths` (job `pr-test-policy`, Family `config/quality/derived-paths/translation.json`) يفشل في ميزة PR التي تفعل ذلك. يتم إكمال اللغات الأخرى مرة واحدة لكل إصدار بواسطة `release:refresh-derived`، الذي يستدعي `syncUiKeys()` في `scripts/i18n/sync-ui-keys.mjs` (إضافة المفاتيح المفقودة، تقليم المفاتيح المسقطة، وضع علامة على ترجمات اللغة الإنجليزية المعاد كتابتها باستخدام `rewrittenSinceRef`، ترجمة)، أو عن طريق موجة الترجمة. تقرأ البوابات الوضع من `scripts/check/lib/gateMode.mjs`: في وضع `pr` (ميزة PRs، `merge_group`، `omni-queue/**`) بوابات وضع التحرير فوق print `SKIP reason=pr-mode` والخروج 0؛ في وضع `release` (الإصدار PR، يدفع إلى `main`، `workflow_dispatch`، عمليات التشغيل المحلية) يكونون صارمين كما كان من قبل، وفي الإصدار PR يحصل الأشخاص الذين يدركون الفرق على `BASE_REF=origin/main`، لذا فهم يحكمون على كل مفتاح تمت إضافته أو إعادة كتابته في الدورة. قم بمعاينة حكم الميزة-PR محليًا باستخدام `--mode=pr`.
|
||||
|
||||
|
||||
@@ -4,14 +4,9 @@
|
||||
|
||||
---
|
||||
|
||||
يستخدم OmniRoute نموذج إصدار **الدورات المتوازية**: فرعًا مخصصًا باسم `release/vX.Y.Z`
|
||||
للدورة النشطة، و`main` لمسار الإصدارات المنشورة، ووسمًا غير قابل للتغيير باسم
|
||||
`vX.Y.Z` عند نشر تلك الدورة. من المتوقع أن ترى الإيداعات تصل إلى `release/*` _وكذلك_ إلى
|
||||
`main` — فهذا ليس خطأً.
|
||||
يستخدم OmniRoute أ** دورة متوازية** نموذج الإصدار: فرع `release/vX.Y.Z` مخصص للدورة النشطة، `main` للخط المنشور، وعلامة `vX.Y.Z` غير قابلة للتغيير عند شحن تلك الدورة. رؤية ارتكاب الأرض على `release/*` _and_ على `main` من المتوقع أن تكون — وليس اختلاطًا.
|
||||
|
||||
توجد التفاصيل الخاصة بالمشرفين في `CLAUDE.md` (القاعدة الصارمة رقم 21) وفي
|
||||
[RELEASE_CHECKLIST.md](./RELEASE_CHECKLIST.md). تمثل هذه الصفحة الملخص العام
|
||||
الموجّه للمساهمين.
|
||||
تفاصيل المشرف تعيش في `CLAUDE.md` (Hard Rule #21) و [RELEASE_CHECKLIST.md](./RELEASE_CHECKLIST.md). هذه الصفحة هي الملخص العام الذي يواجه المساهمين.
|
||||
|
||||
## نظرة سريعة
|
||||
|
||||
@@ -30,37 +25,33 @@ flowchart LR
|
||||
C --> F["الدورة التالية: يُنشأ release/vX+1 من الطرف المجمّد"]
|
||||
```
|
||||
|
||||
## ما الفرع الذي ينبغي أن يستهدفه طلب السحب الخاص بي؟
|
||||
## أين يجب أن تستهدف PR الخاص بي؟
|
||||
|
||||
**استهدف فرع `release/vX.Y.Z` النشط — وليس `main`.**
|
||||
|
||||
1. ابحث عن أعلى فرع `release/v*` مفتوح (مثال وقت كتابة هذا المستند:
|
||||
`release/v3.8.49`).
|
||||
2. أنشئ فرعك من طرفه (`git fetch` ثم checkout / rebase عليه).
|
||||
3. افتح طلب السحب مع ضبط **الفرع الأساسي = فرع `release/vX.Y.Z` ذاك**.
|
||||
1. ابحث عن أعلى فرع `release/v*` مفتوح (مثال وقت كتابة هذا المقال: `release/v3.8.49`).
|
||||
2. تفرع من هذا الطرف (`git fetch` + checkout / rebase عليه).
|
||||
3. افتح PR مع** قاعدة = أن `release/vX.Y.Z`** .
|
||||
|
||||
`main` ليس فرع التكامل اليومي. وعادةً ما تحتاج طلبات السحب المفتوحة ضده
|
||||
إلى إعادة توجيه قبل الدمج.
|
||||
`main` ليس فرع التكامل اليومي. عادةً ما يحتاج PRs المفتوح ضد `main` إلى إعادة الاستهداف قبل الدمج.
|
||||
|
||||
## تجميد الإصدار (الدورات المتوازية)
|
||||
## تجميد الافراج (دورات متوازية)
|
||||
|
||||
عند إجراء تسوية لأحد الإصدارات، تُفتح مشكلة علامة تحمل التصنيف `release-freeze`.
|
||||
وهذا **لا يوقف التطوير**:
|
||||
عندما تتم تسوية الإصدار، يتم فتح مشكلة علامة تحمل اسم `release-freeze`. الذي - التي** لا يتوقف عن التنمية** :
|
||||
|
||||
- يصبح فرع `release/vX.Y.Z` المجمّد تحت مسؤولية قائد الإصدار الخاص بذلك النشر.
|
||||
- يُنشأ فرع الدورة التالية `release/vX+1` من الطرف المجمّد حتى يتمكن المساهمون من مواصلة
|
||||
دمج أعمالهم.
|
||||
- ينبغي **إعادة توجيه** طلبات السحب المفتوحة التي ما زالت تستهدف الفرع المجمّد إلى
|
||||
فرع `release/v*` النشط (الأعلى).
|
||||
- `release/vX.Y.Z` المجمدة مملوكة لقبطان تلك السفينة.
|
||||
- يتم قطع `release/vX+1` للدورة التالية من الطرف المتجمد حتى يواصل المساهمون أعمال الهبوط.
|
||||
- يجب فتح PRs الذي لا يزال يستهدف الفرع المجمد** إعادة استهداف** إلى فرع `release/v*` النشط (الأعلى).
|
||||
|
||||
تحقق من وجود تجميد مفتوح قبل افتراض أن الفرع المطلوب قابل للدمج:
|
||||
تحقق من وجود تجميد مفتوح قبل افتراض أن الفرع الذي تريده قابل للدمج:
|
||||
|
||||
```bash
|
||||
gh issue list --repo diegosouzapw/OmniRoute --label release-freeze --state open
|
||||
```
|
||||
|
||||
آليات الدمج (تصنيف المالك `queue` ← Mergify) موثّقة في
|
||||
[MERGE_TRAIN.md](./MERGE_TRAIN.md).
|
||||
تم توثيق آليات الدمج (علامة المالك `queue` → Mergify) في [MERGE_TRAIN.md](./MERGE_TRAIN.md).
|
||||
|
||||
> **19-11-2026: تم إيقاف قائمة انتظار دمج Mergify** (قرار المالك). لم يعد `.mergify.yml` يحدد قائمة الانتظار ويرفض أوامر Mergify التي تدمج طلب السحب أو تعيد كتابته. يتم دمج الإصدار PRs يدويًا ضمن مجموعة قواعد المستودع "يتطلب بوابات خضراء عند الإصدار النشط" (`Gate / CI` + `Gate / Quality`) حتى يتم تشغيل قائمة الانتظار المتعددة في الوضع المباشر، ومن خلال قائمة الانتظار المتعددة بعد ذلك ( [OMNI_QUEUE.md](./OMNI_QUEUE.md) ). لم تعد تسمية `queue` تدمج أي شيء.
|
||||
|
||||
## لماذا نحتاج إلى فرع ووسم معًا؟
|
||||
|
||||
|
||||
@@ -4,10 +4,9 @@
|
||||
|
||||
---
|
||||
|
||||
منذ الإصدار v3.8.49 (WS3.2/WS3.4 من خطة الجودة/السرعة)، أصبح مسار الدمج الافتراضي لطلبات السحب
|
||||
التي تمت مراجعتها إلى `release/vX.Y.Z` هو **طابور الدمج في Mergify** (`.mergify.yml`)؛
|
||||
أما **قطار الدمج اليدوي** الموثّق أدناه فهو المسار الاحتياطي — ويُستخدم أثناء الحوادث،
|
||||
أو تجميد الإصدارات، أو إذا تغيّرت خطة Mergify Open Source يومًا ما.
|
||||
> **19-11-2026: تم إيقاف قائمة انتظار دمج Mergify** (قرار المالك). لم يعد `.mergify.yml` يحدد قائمة الانتظار ويرفض أوامر Mergify التي تدمج طلب السحب أو تعيد كتابته. يتم دمج الإصدار PRs يدويًا ضمن مجموعة قواعد المستودع "يتطلب بوابات خضراء عند الإصدار النشط" (`Gate / CI` + `Gate / Quality`) حتى يتم تشغيل قائمة الانتظار المتعددة في الوضع المباشر، ومن خلال قائمة الانتظار المتعددة بعد ذلك ( [OMNI_QUEUE.md](./OMNI_QUEUE.md) ). تصف أقسام Mergify أدناه قائمة الانتظار كما كانت.
|
||||
|
||||
منذ الإصدار 3.8.49 (WS3.2/WS3.4 من خطة quality/velocity ) فإن مسار الدمج الافتراضي لـ PRs الذي تمت مراجعته في `release/vX.Y.Z` هو** دمج قائمة الانتظار** (`.mergify.yml`)؛ ال** قطار الدمج اليدوي** الموثق أدناه هو FALLBACK — المستخدم أثناء الحوادث، أو تجميد الإصدار، أو إذا تغيرت خطة Mergify Open Source.
|
||||
|
||||
## المسار الافتراضي: قائمة انتظار Mergify
|
||||
|
||||
|
||||
@@ -355,111 +355,70 @@ npm run build:release
|
||||
|
||||
---
|
||||
|
||||
## اقتطاع 3.9.0 LTS (تمت تجربته في 3.8.58)
|
||||
## 3.9.0 قطع LTS (تم التدرب عليه في 3.8.58)
|
||||
|
||||
بعد v3.8.59 سيكون الإصدار التالي هو 3.9.0، وستصبح قمته فرعين طويلي الأجل:
|
||||
`stable/v3` (خط v3 LTS، ووسم npm `latest`) و`develop` (الإصدار v4، مع رفعه إلى 4.0.0، ووسم npm
|
||||
`nightly`). يوجد نموذج الفروع/القنوات، والنقل إلى الأمام، والتسميات في
|
||||
[RELEASE_STRATEGY.md](./RELEASE_STRATEGY.md)؛ وتوجد الخطة في [ROADMAP](../../ROADMAP.md) (المرحلة 3). يُنفَّذ الاقتطاع مرة واحدة؛
|
||||
ويجري 3.8.58 تجربةً شاملة له من البداية إلى النهاية على نسخة متفرعة، بينما يُختتم 3.8.59 باستخدام
|
||||
[قائمة تحقق GO/NO-GO](./LTS_GO_NO_GO.md).
|
||||
بعد v3.8.59، الإصدار التالي هو 3.9.0، ويصبح طرفه فرعين طويلي العمر: `stable/v3` (خط v3 LTS ، npm `latest`) و `develop` (v4، تم رفعه إلى 4.0.0، npm `nightly`). نموذج branch/channel والمنفذ الأمامي والتسميات موجودة بصيغة [RELEASE_STRATEGY.md](./RELEASE_STRATEGY.md) ؛ الخطة في [ROADMAP](../../ROADMAP.md) (المرحلة 3). يتم القطع مرة واحدة؛ 3.8.58 يتدرب على ذلك من طرف إلى طرف على شوكة، ويغلق 3.8.59 [بقائمة التحقق GO/NO-GO](./LTS_GO_NO_GO.md).
|
||||
|
||||
### التشغيل التجريبي (للقراءة فقط، وآمن في أي وقت)
|
||||
### التشغيل الجاف (للقراءة فقط، آمن في أي وقت)
|
||||
|
||||
```bash
|
||||
npm run release:dry-run-lts-cut # الاقتطاع الفعلي: 3.9.0 من HEAD، والوسم السابق v3.8.59
|
||||
npm run release:dry-run-lts-cut -- --from <3.9.0-tip> # تثبيت التزام المصدر
|
||||
npm run release:dry-run-lts-cut # the real cut: 3.9.0 from HEAD, previous tag v3.8.59
|
||||
npm run release:dry-run-lts-cut -- --from <3.9.0-tip> # pin the source commit
|
||||
```
|
||||
|
||||
لا ينفّذ `scripts/release/dry-run-lts-cut.mjs` أي شيء: فهو يقرأ git و`gh` ويطبع
|
||||
التسلسل بالكامل — الشروط المسبقة (إمكانية تحليل المصدر، واحتواء مستودع المصدر على السجل الكامل —
|
||||
إذ لا يمكن لنسخة سطحية دفع `stable/v3`، ويرفض الطرف المستقبِل الحزمة عند أول
|
||||
أصل مطعَّم، لذا نفّذ الاقتطاع من نسخة كاملة أو نفّذ `git fetch --unshallow origin` أولًا —
|
||||
وجود الوسم السابق، وكون `package.json` بالإصدار المستهدف، ووجود مسألة `release-freeze` مفتوحة، وعدم وجود
|
||||
مسألة `Release branch not green` مفتوحة
|
||||
على فرع إصدار موجود — أما الفرع غير الموجود فيُبلغ عنه بالحالة `?` غير معروف، ولا يُعد
|
||||
أخضر أبدًا — وتهيئة قائمة انتظار Mergify `release` (G11: `queue_rules`، و`checks_timeout`،
|
||||
والتسمية `queue`)، واستمرار مجموعة قواعد `release/*` في حظر الحذف والدفع القسري، وعدم
|
||||
وجود `stable/v3` و`develop` بعد)، وخطوتَي الفرعين، ومشغلات سير العمل الخامل
|
||||
وشروط `if:` التي تصبح صحيحة (وتلك التي تظل محجوبة بمتغير مستودع أو
|
||||
مثبّتة على المستودع الأساسي)، ووسوم dist-tags المتوقعة (`latest` ← 3.9.0، و`next` و
|
||||
`nightly` فارغان)، والتراجع. رمز الخروج `0` = `RESULT: READY`، و`1` = فشل شرط مسبق حاجب
|
||||
(`✗`)، و`2` = خطأ استخدام. يخفض `--advisory <id,...>` مستوى أحد الفحوصات إلى تحذير (`!`)
|
||||
من دون إخفائه.
|
||||
`scripts/release/dry-run-lts-cut.mjs` لا ينفذ شيئًا: فهو يقرأ git و `gh` ويطبع الشروط المسبقة — للتسلسل بالكامل (تم حل المصدر، ويحتوي مستودع المصدر على سجل كامل — ولا يمكن لاستنساخ سطحي دفع `stable/v3`، ويرفض الجانب المتلقي الحزمة عند الأصل المطعم الأول، لذلك يتم القطع من استنساخ كامل أو `git fetch --unshallow origin` أول علامة — السابقة موجودة، `package.json` هو الإصدار المستهدف، ومشكلة `release-freeze` مفتوحة، ولا توجد مشكلة `Release branch not green` مفتوحة في فرع إصدار موجود — فرع غير موجود، تقارير `?` غير معروفة، قائمة انتظار — متعددة الاستخدامات لا تصل إلى الإصدار PRs (G11: `config/merge-queue/config.json` صالح، `bases` الخاص به يدير فرع الإصدار، `mode` `live`، التسمية الخاصة به موجودة)، لا تزال مجموعة قواعد `release/*` تحظر الحذف والدفع القسري، و `stable/v3` و `develop` غير موجودين بعد)، خطوتان فرعيتان، التي يطلقها سير العمل الخامل وتتحول شروط `if:` إلى حقيقة (والتي تبقى مُحاطًا بمتغير مستودع أو مُثبت في المستودع الأساسي)، وعلامات التوزيع المتوقعة (`latest` → 3.9.0 و `next` و `nightly` فارغة) والتراجع. الخروج `0` = `RESULT: READY`، `1` = فشل شرط مسبق للحظر (`✗`)، خطأ في استخدام `2` =. يقوم `--advisory <id,...>` بخفض مستوى الشيك إلى تحذير (`!`) دون إخفاءه.
|
||||
|
||||
شغّل التشغيل التجريبي للاقتطاع الفعلي بينما لا يزال تجميد إصدار 3.9.0 مفتوحًا — إذ تُنشأ الفروع
|
||||
بعد الوسم وقبل أن ترفع المرحلة 12c التجميد.
|
||||
قم بتشغيل التشغيل الجاف للقطع الحقيقي بينما لا يزال تجميد الإصدار 3.9.0 مفتوحًا — يتم إنشاء الفروع بعد العلامة وقبل أن ترفع المرحلة 12ج التجميد.
|
||||
|
||||
### تجربة 3.8.58 (على نسخة متفرعة فقط)
|
||||
### 3.8.58 بروفة (شوكة فقط)
|
||||
|
||||
```bash
|
||||
# 1. التشغيل التجريبي على القمة الحالية باستخدام معاملات التجربة
|
||||
# 1. Dry-run on the current tip with rehearsal parameters
|
||||
npm run release:dry-run-lts-cut -- --target-version 3.8.58 --previous-tag v3.8.57 \
|
||||
--advisory freeze,base-green
|
||||
|
||||
# 2. التنفيذ مقابل وحدة تحكم بعيدة لنسخة متفرعة (يُرفض origin أو أي وحدة تحكم بعيدة يكون عنوان URL الخاص بها
|
||||
# هو المستودع الأساسي؛ وتطلب كل خطوة تأكيدًا في الطرفية)
|
||||
# 2. Execute against a FORK remote (origin, or any remote whose URL is the canonical
|
||||
# repository, is refused; every step asks for confirmation on the terminal)
|
||||
git remote add rehearsal https://github.com/<you>/OmniRoute.git
|
||||
node scripts/release/dry-run-lts-cut.mjs --execute --remote rehearsal \
|
||||
--target-version 3.8.58 --previous-tag v3.8.57 --advisory freeze,base-green
|
||||
|
||||
# 3. اختبار مسارات العمل الخاملة في النسخة المتفرعة (workflow_dispatch عندما يُبلغ التشغيل التجريبي
|
||||
# عن تثبيت على المستودع الأساسي)، ثم التراجع
|
||||
# 3. Exercise the dormant workflows in the fork (workflow_dispatch where the dry-run
|
||||
# reports a canonical-repository pin), then roll back
|
||||
node scripts/release/dry-run-lts-cut.mjs --execute --rollback --remote rehearsal \
|
||||
--target-version 3.8.58 --previous-tag v3.8.57 --advisory freeze,base-green
|
||||
```
|
||||
|
||||
يُنشأ التزام رفع إصدار develop باستخدام أدوات git منخفضة المستوى (من دون لمس شجرة العمل)، ويرفع إصدارات
|
||||
الملفات الخمسة نفسها التي يغيّرها التزام فتح دورة: `package.json`، و`open-sse/package.json`،
|
||||
و`electron/package.json`، و`package-lock.json`، و`docs/openapi.yaml`. يُفتح قسم `[4.0.0]`
|
||||
في CHANGELOG ونُسخه المترجمة ضمن i18n على `develop` بعد ذلك، وقبل أول
|
||||
PR له. لا يغيّر البرنامج النصي وسوم npm dist-tags مطلقًا — اختبرها على حزمة مؤقتة.
|
||||
تم إنشاء التزام تطوير العثرة باستخدام git Plumbing (لم يتم لمس أي شجرة عمل) ويطرح نفس الملفات الخمسة كالتزام مفتوح للدورة: `package.json` و `open-sse/package.json` و `electron/package.json` و `package-lock.json` و `docs/openapi.yaml`. يتم فتح قسم `[4.0.0]` CHANGELOG ومرايا i18n الخاصة به على `develop` بعد ذلك، قبل PR الأول. لا يغير البرنامج النصي أبدًا علامات التوزيع npm — التي تتدرب على تلك الموجودة في الحزمة المؤقتة.
|
||||
|
||||
### أداة معاينة PR (أنشئها مرة واحدة، وروّج البايتات نفسها)
|
||||
### قطعة معاينة PR (يتم إنشاؤها مرة واحدة، والترويج لنفس البايتات)
|
||||
|
||||
ينشئ `.github/workflows/preview-artifact.yml` حزمة tarball إنتاجية واحدة من رأس PR
|
||||
ويتحقق من ذلك البناء نفسه (#8084، الشريحة (a)). يقتصر ذلك على طلبات PR من المستودع نفسه؛ ولا يُنشر أي شيء.
|
||||
تقوم `.github/workflows/preview-artifact.yml` ببناء كرة قطران إنتاجية واحدة من رأس PR وتتحقق من صحة هذا البناء الدقيق (شريحة #8084 (أ)). نفس المستودع PRs فقط؛ لم يتم نشر أي شيء.
|
||||
|
||||
```bash
|
||||
gh workflow run preview-artifact.yml -f pr_number=<N> # أو أضف التسمية `preview-artifact`
|
||||
gh workflow run preview-artifact.yml -f pr_number=<N> # or add the `preview-artifact` label
|
||||
gh run download <run-id> --name preview-artifact-pr<N>-<sha7> --dir preview
|
||||
cd preview && sha256sum -c SHA256SUMS
|
||||
gh attestation verify omniroute-*.tgz --repo diegosouzapw/OmniRoute
|
||||
npm install -g ./omniroute-*.tgz # تثبيت المعاينة
|
||||
npm install -g ./omniroute-*.tgz # preview install
|
||||
```
|
||||
|
||||
ينفّذ التشغيل `npm ci`، و`npm run build:release`، و`npm run check:pack-artifact`، ويحزم
|
||||
حزمة tarball، ثم ينفّذ `npm run check:pack-boot` (أسرار وهمية ودليل بيانات مؤقت)، ويعيد الحزم،
|
||||
ويفشل ما لم تكن البصمة متطابقة، ثم يسجّل `artifact-identity.json` (SHA للرأس، وSHA
|
||||
للأساس، وتجزئة ملف القفل، والمنصة، والمعمارية، وnode ABI، وأداة التجميع، وسياسة البناء —
|
||||
`scripts/release/artifact-identity.mjs`) ويشهد على حزمة tarball في مهمة منفصلة. يعني ترويج
|
||||
معاينة تثبيت حزمة tarball تلك: لا تُعِد البناء من المصدر مطلقًا.
|
||||
يقوم التشغيل بإجراء `npm ci` و `npm run build:release` و `npm run check:pack-artifact` وحزم كرة القطران وتشغيل `npm run check:pack-boot` (أسرار مزيفة وبيانات سريعة الزوال) وإعادة التعبئة والفشل ما لم يكن الملخص متطابقًا، ثم تسجيل `artifact-identity.json` (head SHA وbase SHA وlockfile hash وplatform وarch وnode ABI وbundler وbuild Policy — `scripts/release/artifact-identity.mjs`) ويشهد على tarball في مهمة منفصلة. الترويج للمعاينة يعني تثبيت كرة القطران هذه: لا تقم أبدًا بإعادة البناء من المصدر.
|
||||
|
||||
### الاقتطاع (3.9.0، بعد GO)
|
||||
### القطع (3.9.0، بعد GO)
|
||||
|
||||
1. تسجيل GO في [LTS_GO_NO_GO.md](./LTS_GO_NO_GO.md).
|
||||
2. يطبع `npm run release:dry-run-lts-cut -- --from v3.9.0` النتيجة `RESULT: READY`.
|
||||
3. أنشئ الفرعين على `origin` يدويًا باستخدام الأوامر التي يطبعها التشغيل التجريبي — إذ يرفض
|
||||
البرنامج النصي الدفع إلى `origin`. لإعادة استخدام التزام develop خضع للمراجعة، شغّل
|
||||
تجربة `--execute` على قمة 3.9.0 مقابل نسختك المتفرعة أولًا؛ إذ تطبع قيمتَي SHA، ويمكن
|
||||
دفع الالتزامين نفسيهما:
|
||||
1. GO المسجلة في [LTS_GO_NO_GO.md](./LTS_GO_NO_GO.md).
|
||||
2. `npm run release:dry-run-lts-cut -- --from v3.9.0` يطبع `RESULT: READY`.
|
||||
3. قم بإنشاء الفروع على `origin` يدويًا باستخدام الأوامر التي يطبعها التشغيل الجاف — يرفض البرنامج النصي دفعه إلى `origin`. لإعادة استخدام التزام التطوير الذي تمت مراجعته، قم بإجراء بروفة `--execute` على الطرف 3.9.0 مقابل شوكتك أولاً؛ يطبع كلاً من SHAs، ويمكن دفع نفس الالتزامات:
|
||||
|
||||
```bash
|
||||
git push origin <stable-sha>:refs/heads/stable/v3 <develop-sha>:refs/heads/develop
|
||||
```
|
||||
|
||||
4. احمِ `stable/v3` و`develop` (مجموعات القواعد + قائمة انتظار الدمج) قبل وصول أول PR.
|
||||
5. تُفعَّل تدفقات العمل الخاملة عند وجود الفرع: `forward-port.yml` (الدفع إلى
|
||||
`stable/v3`)، و`validate-stable-pr.yml` (طلبات PR إلى `stable/v3`)، و`nightly-v4-build.yml`
|
||||
(يبني `develop`). قبل الإطلاق، عيّن سر المستودع `secrets.FORWARD_PORT_TOKEN` (لكي يعمل CI على
|
||||
طلبات PR الخاصة بالنقل إلى الإصدارات اللاحقة)؛ يظل النشر الليلي متوقفًا حتى يعيّن المالك متغير المستودع
|
||||
`vars.NIGHTLY_PUBLISH` إلى `true` ويقبل النشر الموثوق به في npm ملف
|
||||
`nightly-v4-build.yml`. تُحدَّد القناة عبر `scripts/release/dist-tag.mjs`، وهو نفس
|
||||
المحلّل الذي يستخدمه `npm-publish.yml`.
|
||||
6. تحقّق من القنوات: يعرض `npm view omniroute dist-tags --json` أن `latest` = 3.9.0، ومن دون
|
||||
`next` / `nightly` حتى يُنشر v4.
|
||||
7. التراجع، إذا لزم الأمر: `git push origin --delete refs/heads/stable/v3 refs/heads/develop`
|
||||
و`npm dist-tag add omniroute@3.8.59 latest`.
|
||||
4. قم بحماية `stable/v3` و `develop` (قائمة انتظار دمج مجموعات القواعد + ) قبل وصول PR الأول.
|
||||
5. يتم تشغيل سير العمل الخامل من خلال وجود الفرع: `forward-port.yml` (ادفع إلى `stable/v3`) و `validate-stable-pr.yml` (PRs إلى `stable/v3`) و `nightly-v4-build.yml` (يبني `develop`). قبل بدء البث المباشر، قم بتعيين سر مستودع `secrets.FORWARD_PORT_TOKEN` (بحيث يعمل CI على المنفذ الأمامي PRs); يظل النشر الليلي متوقفًا حتى يقوم المالك بتعيين متغير المستودع `vars.NIGHTLY_PUBLISH` إلى `true` ويقبل npm Trusted Publishing `nightly-v4-build.yml`. دقة القناة هي `scripts/release/dist-tag.mjs`، وهو نفس المحلل الذي يستخدمه `npm-publish.yml`.
|
||||
6. التحقق من القنوات: يعرض `npm view omniroute dist-tags --json` `latest` = 3.9.0 ولا يوجد `next` / `nightly` حتى يتم نشر الإصدار 4.
|
||||
7. التراجع، إذا لزم الأمر: `git push origin --delete refs/heads/stable/v3 refs/heads/develop` و `npm dist-tag add omniroute@3.8.59 latest`.
|
||||
|
||||
---
|
||||
|
||||
|
||||
@@ -140,34 +140,22 @@ CPU من دون مهمة مرتبطة بها. تحتوي كل وحدة OmniRoute
|
||||
tmpfs مدة 27–32 دقيقة، بينما استغرق رفعه من القرص دقيقتين.
|
||||
- خادم VPS ذو اللاحقة `.15` مخصص للاختبارات التمهيدية فقط — ولا يشغّل مشغّلات CI أبدًا.
|
||||
|
||||
## المسار المستضاف (مشغّلات مستضافة على GitHub)
|
||||
## المسار المستضاف (المتسابقون المستضافون على GitHub)
|
||||
|
||||
ينتمي المستودع إلى مؤسسة `cheaper-inference`، ضمن خطة **Team**: **60 مهمة مستضافة متزامنة**، تتشاركها جميع مستودعات المؤسسة
|
||||
وجميع عمليات التحقق من طلبات السحب، وكل سير عمل يُشغَّل عند الدفع، والإعداد الافتراضي لـ CodeQL. قيست الأرقام أدناه
|
||||
ضمن خطة **Pro** (40 مهمة مستضافة متزامنة). أظهرت القياسات في 2026-10-18 أثناء
|
||||
حملة دمج (نحو 10 عمليات دمج/ساعة على `release/v3.8.52`) أنه تم إنشاء **2,500 تشغيل لسير العمل خلال
|
||||
24 ساعة**، مع 44 عملية دفع إلى الفرع خلال 6 ساعات، ووجود **106 مهام مستضافة في قائمة الانتظار** بينما انتظرت عمليات التحقق من طلبات السحب
|
||||
لساعات، ودُمجت طلبات السحب من دونها. كانت تسعة تدفقات عمل تُشغَّل عند كل عملية دفع إلى الفرع:
|
||||
المستودع تابع لمنظمة `cheaper-inference` ، على** فريق** يخطط:** 60 وظيفة مستضافة متزامنة** ، يتم مشاركتها بواسطة كل مستودع في المؤسسة، وكل فحص PR ، وكل سير عمل يتم تشغيله بالدفع، والإعداد الافتراضي لـ CodeQL. تم قياس الأرقام أدناه على** برو** الخطة (40 وظيفة مستضافة متزامنة). تم القياس بتاريخ 18-10-2026 أثناء حملة الدمج (~ 10 merges/hour على `release/v3.8.52`):** تم إنشاء 2500 عملية سير عمل خلال 24 ساعة** ، 44 دفعة إلى الفرع خلال 6 ساعات،** 106 وظيفة مستضافة في قائمة الانتظار** بينما انتظرت شيكات PR لساعات وتم دمج PRs بدونها. تم إطلاق تسعة مسارات عمل في كل دفعة إلى الفرع:
|
||||
|
||||
| لكل عملية دفع إلى `release/v*` | المهام المستضافة | النتيجة أثناء العاصفة | منذ 2026-10-18 |
|
||||
| ------------------------------------------- | ---------------: | ---------------------------------------------------------------------- | ------------------------------------------------------------------------- |
|
||||
| `ci.yml` (المصفوفة الكاملة) | حتى 30 | ألغتها عملية الدفع التالية، 24 من أصل 24 خلال يوم | لا يبدأ عند الدفع إلى `release/**` (تشغيل طلب السحب + Release-Green) |
|
||||
| `quality.yml` | ~6 | أُلغيت، 23 من أصل 23 | لا يبدأ عند الدفع إلى `release/**` |
|
||||
| `Release-Green` `--quick` | 0 | عمل على `omni-build`، وأُلغي 97 من أصل 100 | خانة `omni-release`، لا يُلغى مطلقًا، وتُدمج عمليات التشغيل المعلّقة |
|
||||
| `Lock released branch`، `OpenSSF Scorecard` | 2 | تشغيل واحد في قائمة الانتظار لكل عملية دفع | تشغيل واحد لكل مرجع (`tests/unit/build/hosted-lane-concurrency.test.ts`) |
|
||||
| `Release acceptance` (تقرير الظل) | 1 | عملية `npm ci` مستضافة واحدة لكل عملية دفع، ولا تُلغى مطلقًا | بلا تغيير — مرشح لمرشح `paths:` |
|
||||
| `Publish to Docker Hub` → `Deploy to VPS` | 2 | يُلغى عند كل عملية دفع؛ يتنافس مسار amd64 على `omni-build` | بلا تغيير — قناة النشر الخاصة بالمالك |
|
||||
| الإعداد الافتراضي لـ CodeQL (`dynamic`) | 4 | `javascript-typescript`، و`actions`، و`c-cpp`، و`python` لكل عملية دفع | بلا تغيير — Settings → Code security؛ لا يفحص `c-cpp`/`python` أي شيء هنا |
|
||||
| لكل دفعة إلى `release/v*` | وظائف مستضافة | النتيجة تحت العاصفة | منذ 2026-10-18 |
|
||||
| ------------------------------------------- | ------------: | -------------------------------------------------------------- | ------------------------------------------------------------------------ |
|
||||
| `ci.yml` (مصفوفة كاملة) | ما يصل إلى 30 | تم إلغاؤه بواسطة الدفعة التالية، 24 من 24 في اليوم | لم يبدأ عند دفعات `release/**` (PR run + Release-Green) |
|
||||
| `quality.yml` | ~6 | تم الإلغاء، 23 من 23 | لم تبدأ على دفعات `release/**` |
|
||||
| `Release-Green` `--quick` | 0 | ركض على `omni-build`، ألغى 97 من 100 | فتحة `omni-release` ، لم يتم إلغاؤها أبدًا، ينهار التشغيل المعلق |
|
||||
| `Lock released branch`, `OpenSSF Scorecard` | 2 | تشغيل واحد في قائمة الانتظار لكل دفعة | تشغيل واحد لكل مرجع (`tests/unit/build/hosted-lane-concurrency.test.ts`) |
|
||||
| `Release acceptance` (تقرير الظل) | 1 | واحد مستضاف `npm ci` لكل دفعة، لم يتم إلغاؤه أبدًا | مرشح — دون تغيير لمرشح `paths:` |
|
||||
| `Publish to Docker Hub` → `Deploy to VPS` | 2 | تم الإلغاء لكل دفعة؛ AMD64 Leg تتنافس على `omni-build` | قناة نشر مالك — دون تغيير |
|
||||
| الإعداد الافتراضي CodeQL (`dynamic`) | 4 | `javascript-typescript`، `actions`، `c-cpp`، `python` لكل دفعة | إعدادات — دون تغيير أمان رمز → ؛ `c-cpp`/`python` مسح أي شيء هنا |
|
||||
|
||||
يثبّت `tests/unit/build/push-storm-diet.test.ts` مشغّل الدفع الخاص بفرع `main` فقط في `ci.yml` و
|
||||
`quality.yml`. أثر جانبي: لم يعد Codecov يتلقى رفعًا أساسيًا عند كل عملية دفع إلى فرع إصدار (هذه
|
||||
الخطوة معلوماتية وتستخدم `continue-on-error`)؛ ولا تتأثر بوابة التغطية داخل المستودع ولا تعليق طلب السحب.
|
||||
`tests/unit/build/push-storm-diet.test.ts` دبابيس `main` -only دفع الزناد من `ci.yml` و `quality.yml`. التأثير الجانبي: لم يعد Codecov يتلقى تحميلًا أساسيًا لكل دفعة إصدار (الخطوة إعلامية و `continue-on-error`)؛ ولا تتأثر بوابة التغطية داخل الريبو وتعليق PR.
|
||||
|
||||
**لا تؤدي زيادة السعة ذاتية الاستضافة إلى حل مشكلة قائمة انتظار المهام المستضافة.** يمكن لجهاز التطوير
|
||||
(`devbox-vm-06-dev002`، 24 vCPU / 54 GB) استضافة مشغّل، لكن جلسات الوكلاء تُبقي
|
||||
حِمله بالفعل عند 20–26، ولا تحتوي حاوية الوكيل على Docker daemon، كما أن المسار المشبع هو
|
||||
المسار المستضاف. كان لدى جهاز `.113` مساحة خالية تبلغ 71 GB وحِمل يتراوح بين 5 و8 في اللحظة نفسها؛ ويتمثل القيد
|
||||
لديه في ميزانية الذاكرة لكل مستمع المذكورة أعلاه (بحد أقصى 6 مستمعين)، وليس في وحدة المعالجة المركزية. أما الأدوات المتبقية
|
||||
فهي إجرائية: دمج طلبات السحب الخاصة بالحملة عبر قائمة انتظار Mergify (`label=queue`، حيث تشترك الدُفعات
|
||||
في تشغيل CI واحد من نوع `merge_group` بدلًا من تشغيل لكل طلب سحب وآخر لكل عملية دفع)، وتقليص لغات
|
||||
الإعداد الافتراضي لـ CodeQL، وترشيح `release-acceptance.yml` بحسب الملفات التي يقرأها.
|
||||
**المزيد من السعة ذاتية الاستضافة لا تؤدي إلى إصلاح قائمة الانتظار المستضافة.** يمكن لـ devbox (`devbox-vm-06-dev002`، 24 vCPU / 54 GB) أن يستضيف عداءًا، لكن جلسات الوكيل تحافظ بالفعل على حملها عند 20-26، ولا تحتوي حاوية الوكيل على البرنامج الخفي Docker ، والمسار المشبع هو المسار المستضاف. يحتوي صندوق `.113` على 71 GB مجانًا ويتم تحميله من 5 إلى 8 في نفس اللحظة؛ القيد الخاص بها هو ميزانية الذاكرة لكل مستمع أعلاه (السقف 6 مستمعين)، وليس CPU. الروافع المتبقية هي أدوات المعالجة: حملة الأرض PRs من خلال قائمة انتظار Mergify (`label=queue`، تشترك الدُفعات في تشغيل `merge_group` CI واحدًا بدلاً من تشغيل واحد لكل PR بالإضافة إلى واحد لكل دفعة)، وقص لغات الإعداد الافتراضية CodeQL ، وتصفية `release-acceptance.yml` حسب الملفات التي يقرأها.
|
||||
|
||||
> **19-11-2026: تم إيقاف قائمة انتظار دمج Mergify** (قرار المالك). لم يعد `.mergify.yml` يحدد قائمة الانتظار ويرفض أوامر Mergify التي تدمج طلب السحب أو تعيد كتابته. يتم دمج الإصدار PRs يدويًا ضمن مجموعة قواعد المستودع "يتطلب بوابات خضراء عند الإصدار النشط" (`Gate / CI` + `Gate / Quality`) حتى يتم تشغيل قائمة الانتظار المتعددة في الوضع المباشر، ومن خلال قائمة الانتظار المتعددة بعد ذلك ( [OMNI_QUEUE.md](./OMNI_QUEUE.md) ). لم تعد رافعة Mergify أعلاه موجودة.
|
||||
|
||||
@@ -26,9 +26,11 @@ Hər bir JSON qəbzi yoxlanılmış SHA, iş axını və cəhdi müəyyən edir.
|
||||
|
||||
### Növbəni birləşdirin
|
||||
|
||||
> **2026-11-19: the Mergify merge queue is retired** (owner's decision). `.mergify.yml` no longer defines a queue and refuses the Mergify commands that merge or rewrite a pull request. Release PRs are merged by hand under the repository ruleset "Require green gates on the active release" (`Gate / CI` + `Gate / Quality`) until omni-queue runs in live mode, and through omni-queue after that ([OMNI_QUEUE.md](../ops/OMNI_QUEUE.md)). The workflow handling of Mergify drafts described below is still in `ci.yml` and `quality.yml`, but no Mergify draft is opened any more.
|
||||
|
||||
`queue` etiketi Birləşdirmə növbəsinə (`.mergify.yml`) PR göndərir. Mergify `mergify/merge-queue/` filialında qaralama PR açır, CI orada tam seçimi işə salır və `Gate / CI`, `Gate / Quality` və `Merge integrity (changelog + generated skills)` keçəndə orijinal PR birləşir.
|
||||
|
||||
Mergify öz növbə xülasəsini qaralamanın təsvirinə yazır və digər proqramlar da onu redaktə edə bilər. Belə qaralamada `pull_request` `edited` hadisəsi özünün paralellik qrupunu (`-queue-edit-<run_id>`) götürür, ona görə də o, qaralamanın real qaçışını ləğv edə bilməz və o, qapını və matrisi atlar. Yalnız `Merge integrity` hələ də işləyir. Atlanmış qapı işi fərqli çek adı daşıyır, çünki Mergify atlanmış `Gate / CI` uğursuz çek kimi oxuyur və PR sıradan çıxarır.
|
||||
Mergify öz növbə xülasəsini qaralamanın təsvirinə yazır və digər proqramlar da onu redaktə edə bilər. Belə qaralamada `pull_request` `edited` hadisəsi özünün paralellik qrupunu (`-queue-edit-<run_id>`) götürür, ona görə də o, qaralamanın real qaçışını ləğv edə bilməz və o, qapını və matrisi atlar. Yalnız `Merge integrity` hələ də işləyir. Atlanan qapı işi fərqli çek adı daşıyır, çünki Mergify atlanmış `Gate / CI` uğursuz çek kimi oxuyur və PR sıradan çıxarır.
|
||||
|
||||
Dequeue sonra, bir təkan həmişə PR requeue deyil. Bu barədə `@mergifyio queue` şərh edin.
|
||||
|
||||
@@ -40,11 +42,11 @@ CLI saxlanılan sübutları yoxlamaq üçün `--evidence-root` tələb edir. Fay
|
||||
|
||||
### Statik skan edilmiş inventar
|
||||
|
||||
Versiyalaşdırılmış npm-ləqəbli inventar və statik-skan üzvlüyü `config/quality/gate-manifest.json`-da yaşayır. Skript adlarını və `package.json` qarşı dəqiq əmrləri təsdiqləmək üçün `npm run check:gate-manifest` işə salın; əlavələr, silinmələr və komanda sürüşməsi həm yerli çəngəl, həm də CI-də dəyişiklik təsnifatı işlərini uğursuz edir. Ləqəb iş axını işi, matris nümunəsi və ya sınaq işi deyil: bu saylar bir-birini əvəz edə bilən kimi təqdim edilməməlidir.
|
||||
Versiyalaşdırılmış npm-ləqəbli inventar və statik skan üzvlüyü `config/quality/gate-manifest.json`-da yaşayır. Skript adlarını və `package.json` qarşı dəqiq əmrləri yoxlamaq üçün `npm run check:gate-manifest` işə salın; əlavələr, silinmələr və komanda sürüşməsi həm yerli çəngəl, həm də CI-də dəyişiklik təsnifatı işlərini uğursuz edir. Ləqəb iş axını işi, matris nümunəsi və ya sınaq işi deyil: bu saylar bir-birini əvəz edə bilən kimi təqdim edilməməlidir.
|
||||
|
||||
Seçilmiş ləqəbləri icra etmədən yoxlamaq üçün `npm run quality:scan -- --list` və ya `npm run quality:scan:fast -- --list` istifadə edin. Qaçışçı npm giriş nöqtəsini çağırır, ona görə də onun işləmə vaxtı (konfiqurasiya edilmiş Bun daxil olmaqla) saxlanılır. Manifest həmin profillərdən kənar ləqəbləri ayrıca çağırılmış kimi qeyd edir və baxım əmrləri yalnız oxumaq üçün skan profillərində qadağandır.
|
||||
Seçilmiş ləqəbləri icra etmədən yoxlamaq üçün `npm run quality:scan -- --list` və ya `npm run quality:scan:fast -- --list` istifadə edin. Qaçışçı npm giriş nöqtəsini çağırır, ona görə də onun işləmə müddəti (konfiqurasiya edilmiş Bun daxil olmaqla) saxlanılır. Manifest həmin profillərdən kənar ləqəbləri ayrıca çağırılmış kimi qeyd edir və baxım əmrləri yalnız oxumaq üçün skan profillərində qadağandır.
|
||||
|
||||
Bu profillər yalnız statik taramanı əhatə edir. Onlar məhsul testlərini, əhatə dairəsini, qablaşdırmanı, xarici yoxlamaları və ya namizədin tam buraxılış qəbulunu təsdiq etmir. İş axınının qəbulu əlaqəli `config/quality/admission-policy.json` və `scripts/quality/admission-verdict.mjs` istifadə edir. Buraxılış-müşahidəçi profilləri ayrı qalır; onların müvafiq çek və qəbzlərini müstəqil şəkildə yoxlayın. Tam müşahidəçinin statik əmrləri `audit:deps`, mutasiya testi seçimi və tərcümə yoxlamaları daxil olmaqla `config/quality/release-green-static-profile.json`-də elan edilir. Yükləyici package.json və modelləşdirilmiş CI/Quality bəyannamələrinə qarşı npm əmrlərini təsdiq edir; o, arqument kimi qabıq işarələrini yerinə yetirmək əvəzinə drifti rədd edir. Tələb olunan skaner SKIP/INCOMPLETE çıxışı PASS qura bilmir. Profil öz xarici istisnalarını qeyd edir və yerləşdirilən əhatə dairəsini, sınaq matrislərini, paket və ya yerləşdirmə sübutlarını əvəz etmir. Aşağıdakı nəsr inventar bir istinaddır, bir qapının həqiqətən qaçdığını sübut etmir.
|
||||
Bu profillər yalnız statik taramanı əhatə edir. Onlar məhsul testlərini, əhatə dairəsini, qablaşdırmanı, xarici yoxlamaları və ya namizədin tam buraxılış qəbulunu təsdiq etmirlər. İş axınının qəbulu əlaqəli `config/quality/admission-policy.json` və `scripts/quality/admission-verdict.mjs` istifadə edir. Buraxılış-müşahidəçi profilləri ayrı qalır; onların tətbiq olunan çeklərini və qəbzlərini müstəqil şəkildə yoxlayın. Tam müşahidəçinin statik əmrləri `audit:deps`, mutasiya testi seçimi və tərcümə yoxlamaları daxil olmaqla `config/quality/release-green-static-profile.json`-də elan edilir. Yükləyici package.json və modelləşdirilmiş CI/Quality bəyannamələrinə qarşı npm əmrlərini təsdiq edir; o, arqument kimi qabıq işarələrini yerinə yetirmək əvəzinə drifti rədd edir. Tələb olunan skaner SKIP/INCOMPLETE çıxışı PASS qura bilməz. Profil öz xarici istisnalarını qeyd edir və yerləşdirilən əhatə dairəsini, test matrislərini, paket və ya yerləşdirmə sübutlarını əvəz etmir. Aşağıdakı nəsr inventar bir keçiddir, əslində bir qapının işlədiyini sübut etmir.
|
||||
|
||||
Skriptlər `scripts/check/` (siyasət qapıları) və `scripts/quality/` (ratchet engine) altında yaşayır. Həqiqətin CI mənbəyi `.github/workflows/ci.yml` dir.
|
||||
|
||||
@@ -63,7 +65,7 @@ Skriptlər `scripts/check/` (siyasət qapıları) və `scripts/quality/` (ratche
|
||||
|
||||
`npm run check:forgotten-sibling-tests` `Fast Quality Gates` -nin məsləhət addımı kimi işləyir və test-təsir xəritəsinin arxasında idxal həlledicisini yenidən istifadə edir. Hər dəyişdirilmiş istehsal modulu üçün, namizəd testi çəkilmə tələbi fərqində olmadıqda, deterministik `changed module/symbol -> static consumer -> candidate sibling test` zəncirləri haqqında məlumat verir. Markdown xülasəsi və JSON nəticəsi hər hansı bloklama yayımından əvvəl kalibrləmə üçün `forgotten-sibling-tests` iş axını artefaktı kimi saxlanılır.
|
||||
|
||||
Barelin təkrar ixracı və dinamik idxalı yalnız həlledici diaqnostikadır; onlar heç vaxt bloklayan tapıntı yaratmırlar. Nəzərdən keçirilmiş istisnalar `config/quality/forgotten-sibling-allowlist.json` yaşayır. Hər bir giriş istehlakçı və namizəd testini adlandırmalı, xüsusi əsaslandırma verməli və GitHub məsələsini əlaqələndirməlidir və ya sorğunu çəkməlidir. Səhv tərtib edilmiş girişlər bağlana bilmir. İstisnalar silinmiş namizəd testini və ya `.skip`/`.todo` əlavə edən fərqi sıxışdıra bilməz; təsdiqin zəifləməsi və digər maskalanma müstəqil şəkildə bloklanan `check:test-masking` qapısına məxsus olaraq qalır.
|
||||
Barelin təkrar ixracı və dinamik idxalı yalnız həlledici diaqnostikadır; onlar heç vaxt bloklayan tapıntı yaratmırlar. Nəzərdən keçirilmiş istisnalar `config/quality/forgotten-sibling-allowlist.json` yaşayır. Hər bir giriş istehlakçı və namizəd testini adlandırmalı, konkret əsaslandırma verməli və GitHub məsələsini əlaqələndirməlidir və ya sorğunu çəkməlidir. Səhv tərtib edilmiş girişlər bağlana bilmir. İstisnalar silinmiş namizəd testini və ya `.skip`/`.todo` əlavə edən fərqi sıxışdıra bilməz; iddianın zəifləməsi və digər maskalanma müstəqil şəkildə bloklanan `check:test-masking` qapısına məxsus olaraq qalır.
|
||||
|
||||
### İş: `lint`
|
||||
|
||||
@@ -73,11 +75,11 @@ Hər PR dan `main` qədər işləyir. Bloklar uğursuzluqla birləşir.
|
||||
| --------------------------------- | ---------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | ---------------------------------------- |
|
||||
| `check:node-runtime` | Node.js versiyası dəstəklənən diapazondadır | Bəli |
|
||||
| `check:cycles` | Bütün `src/` + `open-sse/` üzrə dövri idxal (AST əsaslı, tsconfig `paths` həll olundu). Çılpaq hər hansı bir dövrə mövcud olduqda 1-dən çıxır ( #15281 dən bəri uğursuz bağlanıb) və SCCs siyahıya alır. `check:cycles:ratchet` ( CI nə işləyir) sayı `quality-baseline.json` — -da `metrics.cycles` tavanını aşdıqda bloklanır, `direction: down`, ona görə də yalnız düşə bilər (#15159 G-01/G-02) | Bəli (ratchet) |
|
||||
| `check:boundary` | `open-sse → src` birləşməsi: mühərrikdən proqrama unikal fayldan fayla idxal (`scripts/quality/measure-boundary.mjs`; kənar siyahı v4 core/module-split remediation backlogudur). Çılpaq = məsləhət hesabatı ( `quality:boundary` ilə eyni). `check:boundary:ratchet` ( CI nə işlədir, həmçinin `quality.yml` sürətli qapılar ratchet döngəsində) bloklar hesablama `quality-baseline.json` — -da `metrics.boundaryOpenSseToSrc` tavanını aşdıqda bloklanır 771, `direction: down`; `--update` yalnız onu aşağı salır; PRs üzrə baza-nisbi (`--base-ref`, aşağıya baxın) | Bəli (ratchet) |
|
||||
| `check:boundary` | `open-sse → src` birləşməsi: mühərrikdən proqrama unikal fayldan fayla idxal (`scripts/quality/measure-boundary.mjs`; kənar siyahı v4 core/module-split remediation backlogudur). Çılpaq = məsləhət hesabatı ( `quality:boundary` ilə eyni). `check:boundary:ratchet` ( CI nə işlədir, həmçinin `quality.yml` sürətli qapıların ratchet döngəsində) bloklar hesablanmış `quality-baseline.json` — -da `metrics.boundaryOpenSseToSrc` tavanını aşdıqda bloklanır 771, `direction: down`; `--update` yalnız onu aşağı salır; PRs üzrə baza-nisbi (`--base-ref`, aşağıya baxın) | Bəli (ratchet) |
|
||||
| `check:route-validation:t06` | Zod sxemləri bütün marşrutlarda mövcuddur (Tier 6 siyasəti) | Bəli |
|
||||
| `check:any-budget:t11` | `@ts-expect-error // any` sayı büdcədən çox deyil (Tier 11 catraca) | Bəli |
|
||||
| `check:provider-consistency` | `providers.ts` -dakı hər bir provayderin `providerRegistry.ts` -də uyğun girişi var (və əksinə, icazə verilən siyahıda) | Bəli |
|
||||
| `check:model-lifecycle` | Əl ilə saxlanılan üç marşrutlaşdırma cədvəli yoxlanılmış həyat dövrü snapşotuna (#11503) uyğun olaraq qalır: `FITNESS_TABLE` (`taskFitness.ts`) `REGISTRY` istiqamətləndirə biləcəyi heç bir təqaüdçü identifikatoru hesab etmir; hər bir `BUILT_IN_ALIASES` hədəfi `REGISTRY` -də mövcuddur və təqaüdçü-id snapshot-da yoxdur; `REGISTRY` də olan hər bir təqaüdçü identifikatoru yönləndirilir və ya `allowedRetiredInCatalog`-da siyahıya alınır; və həmin snapshotda heç bir `DEFAULT_DEGRADATION_MAP` mənbəyi və ya hədəfi təqaüdə çıxmış görünmür. Bu, bir modelə hazırda canlı yuxarı axının xidmət etdiyini sübut etmir. Oflayn —, `config/quality/model-lifecycle.json` ilə əl ilə yenilənmiş `npm run quality:refresh-model-lifecycle` ilə müqayisə edir (şəbəkə; CI-ə qoşulmayıb). `allowedRetiredInCatalog` yandırılmış cırcırdır: yalnız izləmə problemi olan bir giriş əlavə edin. | Bəli |
|
||||
| `check:model-lifecycle` | Əl ilə saxlanılan üç marşrutlaşdırma cədvəli yoxlanılmış həyat dövrü snapshotuna (#11503) uyğun olaraq qalır: `FITNESS_TABLE` (`taskFitness.ts`) `REGISTRY` nin istiqamətləndirə biləcəyi heç bir təqaüdçü identifikatoru hesab etmir; hər bir `BUILT_IN_ALIASES` hədəfi `REGISTRY` -də mövcuddur və təqaüdçü-id snapshot-da yoxdur; `REGISTRY` də olan hər bir təqaüdçü identifikatoru yönləndirilir və ya `allowedRetiredInCatalog`-da siyahıya alınır; və həmin snapshotda heç bir `DEFAULT_DEGRADATION_MAP` mənbəyi və ya hədəfi təqaüdə çıxmış görünmür. Bu, bir modelə hazırda canlı yuxarı axının xidmət etdiyini sübut etmir. Oflayn —, `config/quality/model-lifecycle.json` ilə əl ilə yenilənmiş `npm run quality:refresh-model-lifecycle` ilə müqayisə edir (şəbəkə; CI-ə qoşulmayıb). `allowedRetiredInCatalog` yandırılmış cırcırdır: yalnız izləmə problemi olan bir giriş əlavə edin. | Bəli |
|
||||
| `check:fetch-targets` | Müştəri tərəfi `src/` -də hər bir `fetch("/api/...")` real `route.ts`-ə həll olunur | Bəli |
|
||||
| `check:deps` | Repodakı hər `package.json` üzrə bütün `npm install` -able depsləri `dependency-allowlist.json` dədir; yeni açılmış və ya əyilmiş paketlər işarələnib | Bəli |
|
||||
| `audit:deps` | bütün beş müstəqil kilid faylının npm auditi (root, Electron, OpenCode plaginləri v1/v2 və provayder). Kritik məsləhətlər bloku; yüksək tövsiyələr görünən xəbərdarlıq olaraq qalır. Missing/failed auditləri INCOMPLETE və blokdur; əhatə dairəsi üzrə kilid hashləri və hesabatlar saxlanılır. | Bəli |
|
||||
@@ -88,8 +90,8 @@ Hər PR dan `main` qədər işləyir. Bloklar uğursuzluqla birləşir.
|
||||
| `check:vitest-exclusions` | Hər Vitest istisnası izləmə problemini adlandırır və `config/quality/vitest-exclusions.json` (#13204) - da görünür | Bəli |
|
||||
| `check:file-size` | Mənbə fayllar ( `src/`, `open-sse/`, `electron/`, `bin/` də `.ts`/`.tsx` ) `cap` daxilində və test faylları (`*.test.ts(x)`) `testCap` daxilində qalır; `file-size-baseline.json` (`frozen` / `testFrozen`) ilə dondurulmuş fayllar qeydə alınmış ölçüsünü keçməməlidir | Bəli |
|
||||
| `check:error-helper` | executors/handlers -da səhv cavabları `buildErrorBody()` / `sanitizeErrorMessage()` istifadə edir (Sərt Qayda #12) | Bəli |
|
||||
| `check:migration-numbering` | Miqrasiya fayl adları: köhnə `001`–`241` seriyası dondurulur və yeni fayllar `YYYYMMDDHHMMSS_<description>.sql`. PR bazasına qarşı o, silinmiş miqrasiyanı, uyğunluq girişi olmayan adının dəyişdirilməsini və son sxemi işləməyən sıradan çıxmış və ya redaktə edilmiş köçürməni rədd edir. |
|
||||
| `check:public-creds` | `publicCreds.ts` xaricində hərfi OAuth `client_id`/`client_secret` və ya Firebase Veb düymələri yoxdur (Hard Rule #11) | Bəli |
|
||||
| `check:migration-numbering` | Miqrasiya fayl adları: köhnə `001`–`241` seriyası dondurulub və yeni fayllar `YYYYMMDDHHMMSS_<description>.sql`. PR bazasına qarşı o, silinmiş miqrasiyanı, uyğunluq girişi olmayan adının dəyişdirilməsini və son sxemi işləməyən sıradan çıxmış və ya redaktə edilmiş köçürməni rədd edir. |
|
||||
| `check:public-creds` | `publicCreds.ts` xaricində hərfi OAuth `client_id`/`client_secret` və ya Firebase Veb düymələri yoxdur (Sərt Qayda #11) | Bəli |
|
||||
| `check:db-rules` | `src/lib/db/` modulları xaricində xam SQL yoxdur; `localDb.ts` -dən barel idxalı yoxdur (Sərt Qaydalar #2/#5) | Bəli |
|
||||
| `check:known-symbols` | Göndərmə cədvəllərində qeydə alınmış provayder icraçıları, marşrutlaşdırma strategiyaları və tərcüməçilər — diskindəki fayllarla uyğun gəlir, yetim və ya elan olunmamış simvollar yoxdur | Bəli |
|
||||
| `check:route-guard-membership` | Uşaq prosesi yaradan hər marşrut `isLocalOnlyPath()` (Sərt Qaydalar #15/#17) ilə təsnif edilir. | Bəli |
|
||||
@@ -154,8 +156,8 @@ Hər PR dan `main` qədər işləyir. Bloklar uğursuzluqla birləşir.
|
||||
| ↳ `check:deprecated-versions` | Sənədlərdə köhnəlmiş versiya sətirləri yoxdur | Bəli |
|
||||
| ↳ `check:doc-links` | Sənədlərdəki daxili işarələmə bağlantıları real fayllara həll olunur (`[text]`/`(path)` forması) | Bəli |
|
||||
| ↳ `check:fabricated-docs` | Sənədlərdə göstərilən marşrutlar, env vars, CLI əmrləri, çəngəl adları və fayl yolları kod bazasında mövcuddur. `--strict` vasitəsilə sərt qapı; bayraqsız soft-fail. | Bəli ( CI-də `--strict` vasitəsilə) |
|
||||
| `check:cli-i18n` | CLI `t()` düymələri `bin/cli/locales/en.json` -də mövcuddur (hər iki rejim); pt-BR / zh-CN / zh-TW pariteti yalnız buraxılış rejimində `en.json` ilə | Bəli |
|
||||
| `check:openapi-coverage` | OpenAPI spec ən azı real marşrutların cızıqlanmış mərtəbəsini əhatə edir | Bəli |
|
||||
| `check:cli-i18n` | CLI `t()` açarları `bin/cli/locales/en.json` -də mövcuddur (hər iki rejim); pt-BR / zh-CN / zh-TW pariteti yalnız buraxılış rejimində `en.json` ilə | Bəli |
|
||||
| `check:openapi-coverage` | OpenAPI spec real marşrutların ən azı cızıqlanmış mərtəbəsini əhatə edir | Bəli |
|
||||
| `check:openapi-security-tiers` | `openapi.yaml` -da təhlükəsizlik səviyyəsi annotasiyaları `routeGuard.ts` təsnifatlarına uyğundur | **Məsləhət** |
|
||||
| `check:openapi-routes` | `openapi.yaml` -da hər bir yol əsl `route.ts` (anti-hallüsinasiya) həll olur. | Bəli |
|
||||
| `check:docs-symbols` | `docs/**/*.md` -dəki hər `/api/...` istinadı real `route.ts` (anti-hallüsinasiya) çevrilir. | Bəli |
|
||||
@@ -209,7 +211,7 @@ Hər rejimin işlədiyi yer:
|
||||
Bunun arxasındakı əmrlər:
|
||||
|
||||
- `npm run facts` hər törəmə ədədi JSON (`scripts/release/facts.mjs`) kimi çap edir. `--key=code.mcpTools` bir dəyəri çap edir, `--snapshot` canlı ağacın yerinə yerinə yetirilən snapshotı oxuyur. Faktları toplamaq mümkün olmadıqda 2-dən çıxın.
|
||||
- `npm run release:refresh-derived` (`scripts/release/refresh-derived.mjs`) əldə edilmiş faylları bir keçiddə bu ardıcıllıqla ( `--only=` üçün addım identifikatorları) yenidən hesablayır: `provider-reference` (`docs/reference/PROVIDER_REFERENCE.md`), `facts` (snapshot), `numbers` (sayım qapısının yenidən yazma planı sənədlərə tətbiq edilir, sonra onların `docs/i18n/` güzgülərinə `readme-diagrams`, generasiya olunur), `skills` ), `SKILL.md`(ağac `syncE2eTimings` göndərənə qədər atlanır), `e2e-timings` `--rewritten-since=<ref>` gavalı açarları `en.json` endirilir və `ui-keys` — default `origin/main` — ilə son buraxılışdan bəri yenidən yazılmış İngilis dəyərləri yenidən növbəyə qoyulur; dəyərlər mühitdə konfiqurasiya edilmiş backend tərəfindən eyni icrada tərcümə olunur və ya `.env` (`OMNIROUTE_TRANSLATION_*`) və ya mühərrik tərəfindən Google. Backend olmadan o, heç vaxt `__MISSING__` markerlərini yazmır: buraxılış profili uğursuz olur, gecə açarları atlayır və `--allow-untranslated` onları məqsədli şəkildə yazır), `llm-mirrors` və `verify-generated` (yazdıqdan sonra buraxılış rejimində `check:generated-artifacts` və `check:agent-skills-sync` keçməlidir; `--check` -də atlanır və `--only` onu tərk etdikdə; uğursuzluq exitdir). `changelog` addımı daxil olmaqdır (`--with-changelog`, yalnız buraxılış profili). `--profile=nightly` heç vaxt versiya iddiasına toxunmur. `-- --check` ilə heç nə yazmır və hər hansı bir fayl dəyişdikdə və ya idarə olunan dəyər əl ilə redaktəyə ehtiyac olduqda (hər ikisini sadalayır) 1-dən çıxır; infrastruktur nasazlığı ilə bağlı 2-ci çıxış. `--json` nəticəni JSON kimi çap edir.
|
||||
- `npm run release:refresh-derived` (`scripts/release/refresh-derived.mjs`) əldə edilmiş faylları bir keçiddə bu ardıcıllıqla ( `--only=` üçün addım identifikatorları) yenidən hesablayır: `provider-reference` (`docs/reference/PROVIDER_REFERENCE.md`), `facts` (snapshot), `numbers` (sayım qapısının yenidən yazma planı sənədlərə tətbiq edilir, sonra onların `docs/i18n/` güzgülərinə köçürülür, generasiya `SKILL.md`), `readme-diagrams`), `skills` (ağac `syncE2eTimings` göndərənə qədər atlanır), `e2e-timings` `--rewritten-since=<ref>` gavalı açarları `en.json` endirilir və `ui-keys` — default `origin/main` — ilə son buraxılışdan bəri yenidən yazılmış İngilis dəyərləri yenidən növbəyə qoyulur; dəyərlər mühitdə konfiqurasiya edilmiş backend tərəfindən eyni icrada tərcümə olunur və ya `.env` (`OMNIROUTE_TRANSLATION_*`) və ya mühərrik tərəfindən Google. Backend olmadan o, heç vaxt `__MISSING__` markerlərini yazmır: buraxılış profili uğursuz olur, gecə açarları atlayır və `--allow-untranslated` onları məqsədli şəkildə yazır), `llm-mirrors` və `verify-generated` (yazdıqdan sonra buraxılış rejimində `check:generated-artifacts` və `check:agent-skills-sync` keçməlidir; `--check` -də atlanır və `--only` onu tərk etdikdə; uğursuzluq exitdir). `changelog` addımı daxil olmaqdır (`--with-changelog`, yalnız buraxılış profili). `--profile=nightly` heç vaxt versiya iddiasına toxunmur. `-- --check` ilə heç nə yazmır və hər hansı bir fayl dəyişdikdə və ya idarə olunan dəyər əl ilə redaktəyə ehtiyac olduqda (hər ikisini sadalayır) 1-dən çıxır; infrastruktur nasazlığı ilə bağlı 2-ci çıxış. `--json` nəticəni JSON kimi çap edir.
|
||||
- `docs/reference/derived-facts.json` son yeniləmədə istifadə edilən faktların şəklidir. Yalnız yeniləmə onu yazır. README SVG generatorları onu oxuyur və PR-vaxt vahidi testləri onunla bağlı sənədləri və yaradılan faylları — heç vaxt canlı kodla müqayisə edir. Paketin tək canlı müqayisəsi `tests/unit/check-docs-counts-sync.test.ts`-də "buraxılış yeniləməsi dövrü bağlayır": canlı faktlarla yaddaşda tətbiq edilən yeniləmənin yenidən yazma planı hesabat vermədiyi heç bir STRICT drift qoymur və yenidən planlaşdırma heç nəyi dəyişmir.
|
||||
|
||||
Yerli olaraq çoxaltmaq üçün (yerli iş defolt olaraq `release`):
|
||||
@@ -225,14 +227,14 @@ Həll edilə bilən baza olmadan ( `BASE_SHA`/`BASE_REF` yoxdur, yerli `origin/r
|
||||
|
||||
### İş: `i18n-ui-coverage`
|
||||
|
||||
| Skript | Doğrulayır | Bloklama |
|
||||
| --------------------------------- | ----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | ------------------------------ |
|
||||
| `check-ui-keys-coverage` (daxili) | UI i18n açarının əhatə dairəsi ≥ 65% | Bəli (hər iki rejim) |
|
||||
| `check:ui-icu` | Hər UI kataloqunun hər mesajı `IntlMessageFormat` ilə tərtib edilir | Bəli (hər iki rejim) |
|
||||
| `check-ui-value-drift` (daxili) | Yenidən yazılmış ingilis dili** dəyər** geridə heç bir köhnəlmiş tərcümə qoymur | Bəli (yalnız buraxılış rejimi) |
|
||||
| `check-new-key-coverage` (daxili) | A** yeni** İngilis açarı hər dilə tərcümə olunur — a `__MISSING__:` markeri rədd edilir | Bəli (yalnız buraxılış rejimi) |
|
||||
| `check-key-completeness` (daxili) | Hər bir UI kataloqu (və `--catalog=cli` ilə, hər CLI kataloqu) öz `en.json` nin açar dəstini daşıyır; `pr` rejimində, hər bir kataloq PR birləşmə bazasında özünə qarşı dəyişdi | Bəli (hər iki rejim) |
|
||||
| `check-translation-ratio` | Lokal üçün real tərcümə nisbəti (icazə siyahısından kənarda eyni-ingilis dili / yer tutucu / itkin yarpaqlar) `config/quality/i18n-translation-baseline.json` + boşluqdan çox olmamalıdır | Bəli (yalnız buraxılış rejimi) |
|
||||
| Skript | Doğrulayır | Bloklama |
|
||||
| --------------------------------- | ---------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | ------------------------------ |
|
||||
| `check-ui-keys-coverage` (daxili) | UI i18n açarının əhatə dairəsi ≥ 65% | Bəli (hər iki rejim) |
|
||||
| `check:ui-icu` | Hər UI kataloqunun hər mesajı `IntlMessageFormat` ilə tərtib edilir | Bəli (hər iki rejim) |
|
||||
| `check-ui-value-drift` (daxili) | Yenidən yazılmış ingilis dili** dəyər** geridə heç bir köhnəlmiş tərcümə qoymur | Bəli (yalnız buraxılış rejimi) |
|
||||
| `check-new-key-coverage` (daxili) | A** yeni** İngilis açarı hər dilə tərcümə olunur — a `__MISSING__:` markeri rədd edilir | Bəli (yalnız buraxılış rejimi) |
|
||||
| `check-key-completeness` (daxili) | Hər bir UI kataloqu (və `--catalog=cli` ilə, hər CLI kataloqu) öz `en.json` nin açar dəstini daşıyır; `pr` rejimində, hər bir kataloq PR birləşmə bazasında özünə qarşı dəyişdi | Bəli (hər iki rejim) |
|
||||
| `check-translation-ratio` | Lokal üçün real tərcümə nisbəti (icazə siyahısından kənarda eyni-ingilis dili / yer tutucu / çatışmayan yarpaqlar) `config/quality/i18n-translation-baseline.json` + boşluqdan çox olmamalıdır | Bəli (yalnız buraxılış rejimi) |
|
||||
|
||||
`fetch-depth: 0` — lazımdır dəyər-drift qapısı birləşmə bazasına qarşı `en.json` fərqlənir.
|
||||
|
||||
@@ -246,7 +248,7 @@ Yerli bərabərlik vahidi testləri (`cli-i18n-catalog`, `i18n-pt-br`, `i18n-vi-
|
||||
|
||||
Digər qapıların struktur olaraq görə bilmədiyi bir i18n reqressiyasını tutur: İngilis dəyəri yenidən yazılır və _əvvəlki_ İngilis dilindən alınan tərcümələr geridə qalır, beləliklə qeyri-ingilis istifadəçilər əminliklə yazılmış, indi səhv olan surəti oxumağa davam edirlər.
|
||||
|
||||
Bu real olaraq göndərildi. `oauthModal.googleOAuthWarning` Antigravity giriş köməkçisi eniş zamanı yenidən yazılmışdır (#5203);** 43 yerdən 39-u** operatorlara "tam URL ni kopyalayın və aşağıya yapışdırın" deyən mətni saxladı — həmin provayder üçün tamamlaya bilməyən bir axını. #8463 ə qədər diqqətdən kənarda qaldı, çünki:
|
||||
Bu real olaraq göndərildi. Antigravity giriş köməkçisi yerə endikdə `oauthModal.googleOAuthWarning` yenidən yazılmışdır (#5203);** 43 yerdən 39-u** operatorlara "tam URL kopyalayın və aşağıya yapışdırın" deyən mətni saxladı ki, bu provayder üçün tamamlana bilməyən bir —. #8463 qədər diqqətdən kənarda qaldı, çünki:
|
||||
|
||||
- `sync-ui-keys` yalnız olan açarları doldurur** yox** , heç vaxt olanlar** köhnəlmiş** ;
|
||||
- `check-ui-keys-coverage` açarı _presence_ hesablayır, buna görə də köhnə tərcümə əhatə olunduğu kimi qiymətləndirir;
|
||||
@@ -267,7 +269,7 @@ npm run i18n:check-value-drift:warn # report only
|
||||
BASE_REF=origin/release/vX.Y.Z npm run i18n:check-value-drift
|
||||
```
|
||||
|
||||
Əsas kataloqu oxumaq mümkün olmadıqda `SKIP reason=base-unresolved` ilə 0-dan çıxır (əsas ref olmadan dayaz klon), `check-openapi-breaking` aynası. Yalnız buraxılış rejimi: PR funksiyası ingilis dilini yenidən yazır və orada dayanır; buraxılış yeniləməsi geridə qoyduğu tərcümələri qeyd edir (`node scripts/i18n/sync-ui-keys.mjs --rewritten-since=<ref>`, eyni `findStaleTranslations`).
|
||||
Əsas kataloqu oxumaq mümkün olmadıqda (əsas ref olmadan dayaz klon), `check-openapi-breaking` aynası ilə 0-dan `SKIP reason=base-unresolved` ilə çıxır. Yalnız buraxılış rejimi: PR funksiyası ingilis dilini yenidən yazır və orada dayanır; buraxılış yeniləməsi geridə qoyduğu tərcümələri qeyd edir (`node scripts/i18n/sync-ui-keys.mjs --rewritten-since=<ref>`, eyni `findStaleTranslations`).
|
||||
|
||||
### İş: `i18n`
|
||||
|
||||
@@ -306,7 +308,7 @@ Bunlar cron cədvəlində (və `workflow_dispatch`) işləyir, heç vaxt PRs olm
|
||||
| `nightly-resilience` | yığın-böyümə qapısı, xaos fay-injection, k6 load/soak | **Məsləhət** |
|
||||
| `nightly-llm-security` | promptfoo injection mühafizəsi (blok rejimi) + garak zondları (provayder sirri olmadan atlandı) | **Məsləhət** |
|
||||
| `nightly-schemathesis` | `docs/openapi.yaml` — səthlərinin spesifik pozuntuları / idarə olunmayan 500s (Fase 8 B.4) istifadə edərək canlı OmniRoute ə qarşı OpenAPI müqaviləsinin puslanması (sxeması) | **Məsləhət** |
|
||||
| `nightly-mutation` | Sürətli vahid zolaqlı — üzərində Stryker mutasiya testi balı, sağ qalan mutantların zəif təsdiqini göstərir. | **Məsləhət** |
|
||||
| `nightly-mutation` | Sürətli vahid zolağı — üzərində Stryker mutasiya sınağı balı sağ qalan mutantların zəif təsdiqini göstərir. | **Məsləhət** |
|
||||
| `nightly-compat` | Dəstəklənən `engines.node` diapazonlarında mühərrik uyğunluğu matrisi | **Məsləhət** |
|
||||
|
||||
Performansın əsas göstəriciləri (yığın, TTFB, qurulma vaxtı) qeyd olunur, qapalı deyil: bax [`PERF_BASELINE.md`](../ops/PERF_BASELINE.md) (`npm run perf:lts-baseline`).
|
||||
|
||||
@@ -42,26 +42,23 @@ flowchart LR
|
||||
`main` gündəlik inteqrasiya budağı deyil. `main` üçün açılmış PR-ların adətən
|
||||
birləşdirilməzdən əvvəl başqa hədəfə yönəldilməsi tələb olunur.
|
||||
|
||||
## Buraxılışın dondurulması (paralel dövrlər)
|
||||
## Dondurmanı buraxın (paralel dövrlər)
|
||||
|
||||
Buraxılış uyğunlaşdırılarkən `release-freeze` etiketli marker məsələ açılır.
|
||||
Bu, **inkişafı dayandırmır**:
|
||||
Buraxılış uyğunlaşdırılarkən, `release-freeze` etiketli marker məsələsi açılır. Bu** inkişafı dayandırmır** :
|
||||
|
||||
- Dondurulmuş `release/vX.Y.Z` həmin buraxılış üçün buraxılış rəhbərinə aiddir.
|
||||
- İştirakçıların işlərini daxil etməyə davam edə bilməsi üçün növbəti dövrün
|
||||
`release/vX+1` budağı dondurulmuş son nöqtədən yaradılır.
|
||||
- Hələ də dondurulmuş budağı hədəfləyən açıq PR-lar aktiv (ən yüksək)
|
||||
`release/v*` budağına **yenidən yönəldilməlidir**.
|
||||
- Dondurulmuş `release/vX.Y.Z` həmin gəminin buraxılış kapitanına məxsusdur.
|
||||
- Növbəti dövrənin `release/vX+1` dondurulmuş ucundan kəsilir ki, ianəçilər eniş işlərini davam etdirsinlər.
|
||||
- Hələ də dondurulmuş filialı hədəf alan açıq PRs olmalıdır** yenidən hədəflənmişdir** aktiv (ən yüksək) `release/v*` filialına.
|
||||
|
||||
İstədiyiniz budağın birləşdirilə biləcəyini güman etməzdən əvvəl açıq dondurulmanın
|
||||
olub-olmadığını yoxlayın:
|
||||
İstədiyiniz filialın birləşdirilə biləcəyini fərz etməzdən əvvəl açıq donma olub olmadığını yoxlayın:
|
||||
|
||||
```bash
|
||||
gh issue list --repo diegosouzapw/OmniRoute --label release-freeze --state open
|
||||
```
|
||||
|
||||
Birləşdirmə mexanizmləri (sahibin `queue` etiketi → Mergify)
|
||||
[MERGE_TRAIN.md](./MERGE_TRAIN.md) sənədində təsvir edilib.
|
||||
Birləşmə mexanikası (sahibi `queue` etiketi → Mergify) [MERGE_TRAIN.md](./MERGE_TRAIN.md) -də sənədləşdirilmişdir.
|
||||
|
||||
> **11-19-2026: Birləşdirmə növbəsi ləğv edildi** (sahibinin qərarı). `.mergify.yml` artıq növbə təyin etmir və çəkmə sorğusunu birləşdirən və ya yenidən yazan Birləşdirmə əmrlərini rədd edir. Buraxılış PRs "Aktiv buraxılışda yaşıl qapılar tələb olun" (`Gate / CI` + `Gate / Quality`) repozitoriya qaydaları altında əl ilə birləşdirilir, omni-növbə canlı rejimdə və ondan sonra omni-növbə vasitəsilə ( [OMNI_QUEUE.md](./OMNI_QUEUE.md) ). `queue` etiketi artıq heç nəyi birləşdirmir.
|
||||
|
||||
## Nə üçün həm budaq, həm də teq var?
|
||||
|
||||
|
||||
@@ -4,8 +4,9 @@
|
||||
|
||||
---
|
||||
|
||||
v3.8.49 versiyasından (keyfiyyət/sürət planının WS3.2/WS3.4 mərhələlərindən) etibarən nəzərdən keçirilmiş PR-lərin `release/vX.Y.Z` budağına birləşdirilməsi üçün standart yol **Mergify birləşdirmə növbəsidir** (`.mergify.yml`);
|
||||
aşağıda sənədləşdirilmiş **əl ilə birləşdirmə qatarı** isə EHTİYAT VARİANTIDIR — insidentlər, reliz dondurmaları zamanı və ya Mergify Open Source planı nə vaxtsa dəyişərsə istifadə olunur.
|
||||
> **11-19-2026: Birləşdirmə növbəsi ləğv edildi** (sahibinin qərarı). `.mergify.yml` artıq növbə təyin etmir və çəkmə sorğusunu birləşdirən və ya yenidən yazan Birləşdirmə əmrlərini rədd edir. Buraxılış PRs "Aktiv buraxılışda yaşıl qapılar tələb olun" (`Gate / CI` + `Gate / Quality`) repozitoriya qaydaları altında əl ilə birləşdirilir, omni-növbə canlı rejimdə və ondan sonra omni-növbə vasitəsilə ( [OMNI_QUEUE.md](./OMNI_QUEUE.md) ). Aşağıdakı Birləşdirmə bölmələri növbəni olduğu kimi təsvir edir.
|
||||
|
||||
v3.8.49 ( quality/velocity planının WS3.2/WS3.4 ) versiyasından bəri nəzərdən keçirilən PRs üçün `release/vX.Y.Z` -yə defolt birləşmə yolu** Birləşmə növbəsini birləşdirin** (`.mergify.yml`); the** əl ilə birləşmə qatarı** aşağıda sənədləşdirilmiş FALLBACK — hadisələr zamanı, buraxılışların dondurulması və ya Merge Açıq Mənbə planı dəyişdikdə istifadə olunur.
|
||||
|
||||
## Standart yol: Mergify növbəsi
|
||||
|
||||
|
||||
@@ -386,109 +386,70 @@ Embedded services dəyişikliklərini ehtiva edən hər hansı buraxılışı ya
|
||||
|
||||
---
|
||||
|
||||
## 3.9.0 LTS kəsimi (3.8.58-də məşq edilib)
|
||||
## 3.9.0 LTS kəsmə (3.8.58-də məşq edilmişdir)
|
||||
|
||||
v3.8.59-dan sonra növbəti versiya 3.9.0 olur və onun son vəziyyətindən iki uzunömürlü budaq yaranır:
|
||||
`stable/v3` (v3 LTS xətti, npm `latest`) və `develop` (v4, 4.0.0-a yüksəldilir, npm
|
||||
`nightly`). Budaq/kanal modeli, forward-port və etiketlər
|
||||
[RELEASE_STRATEGY.md](./RELEASE_STRATEGY.md) faylındadır; plan [ROADMAP](../../ROADMAP.md)
|
||||
sənədindədir (Mərhələ 3). Kəsim bir dəfə icra olunur;
|
||||
3.8.58 onu fork üzərində başdan sona məşq edir, 3.8.59 isə
|
||||
[GO/NO-GO yoxlama siyahısı](./LTS_GO_NO_GO.md) ilə tamamlanır.
|
||||
v3.8.59-dan sonra növbəti versiya 3.9.0-dır və onun ucu iki uzunömürlü budaq olur: `stable/v3` (v3 LTS xətti, npm `latest`) və `develop` (v4, 4.0.0-a çatdı, npm `nightly`). branch/channel modeli, irəli port və etiketlər [RELEASE_STRATEGY.md-](./RELEASE_STRATEGY.md) dədir; plan [ROADMAP](../../ROADMAP.md) dadır (Mərhələ 3). Kəsmə bir dəfə aparılır; 3.8.58 çəngəldə başdan sona məşq edir və 3.8.59 [GO/NO-GO yoxlama siyahısı](./LTS_GO_NO_GO.md) ilə bağlayır.
|
||||
|
||||
### Sınaq icrası (yalnız oxuma, istənilən vaxt təhlükəsiz)
|
||||
### Dry run (yalnız oxumaq üçün, istənilən vaxt təhlükəsizdir)
|
||||
|
||||
```bash
|
||||
npm run release:dry-run-lts-cut # real kəsim: HEAD-dən 3.9.0, əvvəlki teq v3.8.59
|
||||
npm run release:dry-run-lts-cut -- --from <3.9.0-tip> # mənbə commit-ini sabitlə
|
||||
npm run release:dry-run-lts-cut # the real cut: 3.9.0 from HEAD, previous tag v3.8.59
|
||||
npm run release:dry-run-lts-cut -- --from <3.9.0-tip> # pin the source commit
|
||||
```
|
||||
|
||||
`scripts/release/dry-run-lts-cut.mjs` heç nə icra etmir: git və `gh` məlumatlarını oxuyur və
|
||||
bütün ardıcıllığı çap edir — ilkin şərtləri (mənbə həll olunur, mənbə repozitoriyası tam tarixçəyə malikdir —
|
||||
dayaz klon `stable/v3`-ə push edə bilməz, qəbul edən tərəf ilk graft edilmiş parent-də pack-i rədd edir, buna görə
|
||||
tam klondan kəsim edin və ya əvvəlcə `git fetch --unshallow origin` icra edin — əvvəlki
|
||||
teq mövcuddur, `package.json` hədəf versiyadadır, `release-freeze` issue-su açıqdır, mövcud release budağında
|
||||
açıq `Release branch not green` issue-su yoxdur — mövcud olmayan budaq `?` naməlum nəticəsi verir, heç vaxt
|
||||
green nəticəsi vermir — Mergify `release` növbəsi konfiqurasiya olunub (`queue_rules`, `checks_timeout`,
|
||||
`queue` etiketi), `release/*` ruleset-i hələ də silinməni və force-push-u bloklayır, `stable/v3` və
|
||||
`develop` hələ mövcud deyil), iki budaq addımını, hansı deaktiv workflow trigger-lərinin və
|
||||
`if:` şərtlərinin doğru olduğunu (və hansılarının repozitoriya dəyişəni ilə məhdudlaşdırıldığını və ya
|
||||
kanonik repozitoriyaya sabitlənmiş qaldığını), gözlənilən dist-tag-ləri (`latest` → 3.9.0, `next` və
|
||||
`nightly` boşdur) və geri qaytarma əməliyyatını. Çıxış `0` = `RESULT: READY`, `1` = bloklayıcı ilkin şərt
|
||||
uğursuz oldu (`✗`), `2` = istifadə xətası. `--advisory <id,...>` yoxlamanı gizlətmədən onu xəbərdarlıq
|
||||
səviyyəsinə (`!`) endirir.
|
||||
`scripts/release/dry-run-lts-cut.mjs` executes nothing: it reads git and `gh` and prints the whole sequence — preconditions (source resolves, the source repository has full history — a shallow clone cannot push `stable/v3`, the receiving side rejects the pack at the first grafted parent, so cut from a full clone or `git fetch --unshallow origin` first — previous tag exists, `package.json` is the target version, a `release-freeze` issue is open, no open `Release branch not green` issue on an existing release branch — a branch that does not exist reports `?` unknown, never green — omni-queue lands the release PRs (G11: `config/merge-queue/config.json` valid, its `bases` manage the release branch, `mode` `live`, its label exists), the `release/*` ruleset still blocks deletion and force-push, and `stable/v3` and `develop` do not exist yet), the two branch steps, which dormant-workflow triggers and `if:` conditions turn true (and which stay gated by a repository variable or pinned to the canonical repository), the expected dist-tags (`latest` → 3.9.0, `next` and `nightly` empty) and the rollback. Exit `0` = `RESULT: READY`, `1` = a blocking precondition failed (`✗`), `2` = usage error. `--advisory <id,...>` downgrades a check to a warning (`!`) without hiding it.
|
||||
|
||||
3.9.0 release freeze hələ açıq olduğu müddətdə real kəsimin sınaq icrasını başladın — budaqlar teqdən
|
||||
sonra və 12c mərhələsi freeze-i qaldırmazdan əvvəl yaradılır.
|
||||
3.9.0 buraxılışının dondurulması hələ də açıq — real kəsmənin quru işini həyata keçirin.
|
||||
|
||||
### 3.8.58 məşqi (yalnız fork)
|
||||
### 3.8.58 məşq (yalnız çəngəl)
|
||||
|
||||
```bash
|
||||
# 1. Məşq parametrləri ilə cari tip üzərində sınaq icrası
|
||||
# 1. Dry-run on the current tip with rehearsal parameters
|
||||
npm run release:dry-run-lts-cut -- --target-version 3.8.58 --previous-tag v3.8.57 \
|
||||
--advisory freeze,base-green
|
||||
|
||||
# 2. FORK remote-a qarşı icra edin (origin və ya URL-i kanonik
|
||||
# repozitoriyaya uyğun gələn hər hansı remote rədd edilir; hər addım terminalda təsdiq istəyir)
|
||||
# 2. Execute against a FORK remote (origin, or any remote whose URL is the canonical
|
||||
# repository, is refused; every step asks for confirmation on the terminal)
|
||||
git remote add rehearsal https://github.com/<you>/OmniRoute.git
|
||||
node scripts/release/dry-run-lts-cut.mjs --execute --remote rehearsal \
|
||||
--target-version 3.8.58 --previous-tag v3.8.57 --advisory freeze,base-green
|
||||
|
||||
# 3. Fork-da deaktiv workflow-ları sınaqdan keçirin (sınaq icrasının kanonik-repozitoriya
|
||||
# sabitlənməsi bildirdiyi workflow_dispatch ilə), sonra geri qaytarın
|
||||
# 3. Exercise the dormant workflows in the fork (workflow_dispatch where the dry-run
|
||||
# reports a canonical-repository pin), then roll back
|
||||
node scripts/release/dry-run-lts-cut.mjs --execute --rollback --remote rehearsal \
|
||||
--target-version 3.8.58 --previous-tag v3.8.57 --advisory freeze,base-green
|
||||
```
|
||||
|
||||
develop yüksəltmə commit-i git plumbing ilə yaradılır (işçi ağacına toxunulmur) və cycle-open commit-i ilə
|
||||
eyni beş faylı yüksəldir: `package.json`, `open-sse/package.json`,
|
||||
`electron/package.json`, `package-lock.json` və `docs/openapi.yaml`. `[4.0.0]`
|
||||
CHANGELOG bölməsi və onun i18n güzgüləri sonradan, ilk PR-dan əvvəl, `develop` üzərində açılır.
|
||||
Skript npm dist-tag-lərini heç vaxt dəyişmir — bunları scratch package üzərində məşq edin.
|
||||
İnkişaf etmə öhdəliyi git santexnika ilə qurulur (heç bir işləyən ağaca toxunulmur) və dövrə açıq öhdəliyi ilə eyni beş faylı vurur: `package.json`, `open-sse/package.json`, `electron/package.json`, `package-lock.json` və `docs/openapi.yaml`. `[4.0.0]` CHANGELOG bölməsi və onun i18n güzgüləri `develop` -də daha sonra, ilk PR dən əvvəl açılır. Skript heç vaxt npm dist-teqlərini dəyişmir — skretch paketindəkiləri təkrarlayır.
|
||||
|
||||
### PR önizləmə artefaktı (bir dəfə qurun, eyni baytları yayımlayın)
|
||||
### PR önizləmə artefaktı (bir dəfə qurun, eyni baytları təşviq edin)
|
||||
|
||||
`.github/workflows/preview-artifact.yml` PR head-dən bir production tarball qurur və həmin dəqiq build-i
|
||||
doğrulayır (#8084 dilimi (a)). Yalnız eyni repozitoriyadakı PR-lər; heç nə yayımlanmır.
|
||||
`.github/workflows/preview-artifact.yml` PR başlığından bir istehsal tarball qurur və bu dəqiq quruluşu təsdiqləyir (#8084 dilimi (a)). Yalnız eyni depo PRs ; heç nə dərc olunmur.
|
||||
|
||||
```bash
|
||||
gh workflow run preview-artifact.yml -f pr_number=<N> # və ya `preview-artifact` etiketini əlavə edin
|
||||
gh workflow run preview-artifact.yml -f pr_number=<N> # or add the `preview-artifact` label
|
||||
gh run download <run-id> --name preview-artifact-pr<N>-<sha7> --dir preview
|
||||
cd preview && sha256sum -c SHA256SUMS
|
||||
gh attestation verify omniroute-*.tgz --repo diegosouzapw/OmniRoute
|
||||
npm install -g ./omniroute-*.tgz # önizləmə quraşdırması
|
||||
npm install -g ./omniroute-*.tgz # preview install
|
||||
```
|
||||
|
||||
İcra `npm ci`, `npm run build:release`, `npm run check:pack-artifact` əməliyyatlarını yerinə yetirir, tarball-ı
|
||||
paketləyir, `npm run check:pack-boot` işlədir (saxta secret-lər, müvəqqəti data qovluğu), yenidən paketləyir
|
||||
və digest eyni olmadıqda uğursuz olur; sonra `artifact-identity.json` faylını (head SHA, base
|
||||
SHA, lockfile heşi, platforma, arxitektura, node ABI, bundler, build siyasəti —
|
||||
`scripts/release/artifact-identity.mjs`) qeyd edir və ayrıca job-da tarball üçün attestasiya yaradır.
|
||||
Önizləməni yayımlamaq həmin tarball-ı quraşdırmaq deməkdir: mənbədən heç vaxt yenidən build etməyin.
|
||||
Qaçış `npm ci`, `npm run build:release`, `npm run check:pack-artifact` edir, tarballu yığır, `npm run check:pack-boot` (saxta sirlər, efemer data direktoru) işlədir, yenidən paketlənir və həzm eyni olmadıqda uğursuz olur, sonra `artifact-identity.json` qeyd edir (head SHA, base SHA, lockfile build , ABI, buckfile arch , nodez , buzzler — `scripts/release/artifact-identity.mjs`) və ayrıca işdə tarballu təsdiqləyir. Önizləməni təşviq etmək həmin tarballu quraşdırmaq deməkdir: heç vaxt mənbədən yenidən qurmayın.
|
||||
|
||||
### Kəsim (3.9.0, GO-dan sonra)
|
||||
### Kəsmə (3.9.0, GO dan sonra)
|
||||
|
||||
1. GO [LTS_GO_NO_GO.md](./LTS_GO_NO_GO.md) faylında qeyd edilir.
|
||||
1. GO [LTS_GO_NO_GO-da qeydə alınmışdır .md](./LTS_GO_NO_GO.md).
|
||||
2. `npm run release:dry-run-lts-cut -- --from v3.9.0` `RESULT: READY` çap edir.
|
||||
3. Budaqları `origin` üzərində sınaq icrasının çap etdiyi əmrlərlə əl ilə yaradın —
|
||||
skript `origin`-ə push etməyi rədd edir. Yoxlanılmış develop commit-ini yenidən istifadə etmək üçün
|
||||
əvvəlcə 3.9.0 tip-i üzərində `--execute` məşqini fork-unuzda başladın; skript hər iki SHA-nı çap edir və
|
||||
eyni commit-lər push edilə bilər:
|
||||
3. Əmrləri ilə əl ilə `origin` -da budaqlar yaradın — skript `origin`-ə basmaqdan imtina edir. Nəzərdən keçirilmiş inkişaf öhdəliyindən təkrar istifadə etmək üçün əvvəlcə 3.9.0 ucunda `--execute` məşqini çəngəlinizə qarşı aparın; SHAs hər ikisini çap edir və eyni öhdəliklər itələnə bilər:
|
||||
|
||||
```bash
|
||||
git push origin <stable-sha>:refs/heads/stable/v3 <develop-sha>:refs/heads/develop
|
||||
```
|
||||
|
||||
4. İlk PR birləşdirilməzdən əvvəl `stable/v3` və `develop` qollarını qoruyun (qayda dəstləri + birləşdirmə növbəsi).
|
||||
5. Aktiv olmayan workflow-lar budağın mövcudluğuna görə aktivləşir: `forward-port.yml` (`stable/v3`-ə push), `validate-stable-pr.yml` (`stable/v3`-ə yönələn PR-lər) və `nightly-v4-build.yml`
|
||||
(`develop` qolu ilə build-lər). Go-live-dan əvvəl repository secret-i `secrets.FORWARD_PORT_TOKEN` təyin edin (beləliklə CI
|
||||
forward-port PR-lərində işləyəcək); nightly publishing owner repository
|
||||
variable-ını `vars.NIGHTLY_PUBLISH` dəyərinə `true` təyin edənə və npm Trusted Publishing `nightly-v4-build.yml` faylını qəbul edənə qədər
|
||||
aktiv olmayacaq. Kanalın təyini `scripts/release/dist-tag.mjs` faylındadır və `npm-publish.yml` də eyni
|
||||
resolver-dən istifadə edir.
|
||||
6. Kanalları yoxlayın: `npm view omniroute dist-tags --json` nəticəsində `latest` = 3.9.0 göstərilməli və v4 yayımlanana qədər `next` / `nightly` olmamalıdır.
|
||||
7. Lazım gələrsə geri qaytarma: `git push origin --delete refs/heads/stable/v3 refs/heads/develop`
|
||||
və `npm dist-tag add omniroute@3.8.59 latest`.
|
||||
4. İlk PR yerlərindən əvvəl `stable/v3` və `develop` (qaydalar + birləşmə növbəsi) qoruyun.
|
||||
5. Fasiləsiz iş axınları filialın mövcudluğuna görə işə düşür: `forward-port.yml` ( `stable/v3`-ə təkan), `validate-stable-pr.yml` (PRs to `stable/v3`) və `nightly-v4-build.yml` ( `develop` qurur). Canlı yayıma başlamazdan əvvəl, `secrets.FORWARD_PORT_TOKEN` repozitoriya sirrini təyin edin (beləliklə, CI irəli port PRs üzərində işləyir); sahibi `vars.NIGHTLY_PUBLISH` repozitor dəyişənini `true` -ə təyin edənə və npm Trusted Publishing `nightly-v4-build.yml` qəbul edənə qədər gecə nəşriyyatı qeyri-aktiv qalır. Kanalın həlli `scripts/release/dist-tag.mjs`, eyni həlledici `npm-publish.yml` istifadə edir.
|
||||
6. Kanalları yoxlayın: `npm view omniroute dist-tags --json` `latest` = 3.9.0-ı göstərir və v4 dərc olunana qədər `next` / `nightly` yoxdur.
|
||||
7. Lazım gələrsə, geri qaytarma: `git push origin --delete refs/heads/stable/v3 refs/heads/develop` və `npm dist-tag add omniroute@3.8.59 latest`.
|
||||
|
||||
---
|
||||
|
||||
|
||||
@@ -134,35 +134,22 @@ runner-ı və yalnız boş olduqda** yenidən başladın.
|
||||
dəqiqə, diskdən yüklənməsi isə 2 dəqiqə çəkmişdi.
|
||||
- `.15` VPS yalnız homologasiya üçündür — onun üzərində heç vaxt CI runner-ləri işləmir.
|
||||
|
||||
## Host edilən zolaq (GitHub tərəfindən host edilən icraçılar)
|
||||
## Hosted zolaq (GitHub-a ev sahibliyi edən qaçışçılar)
|
||||
|
||||
Repo `cheaper-inference` təşkilatına məxsusdur və **Team** planındadır: **eyni vaxtda 60 host edilən tapşırıq**; bu limit təşkilatdakı hər bir repo, hər bir PR yoxlaması, push ilə işə düşən hər bir iş axını və CodeQL-in standart konfiqurasiyası arasında paylaşılır. Aşağıdakı rəqəmlər **Pro** planında (eyni vaxtda 40 host edilən tapşırıq) ölçülüb.
|
||||
2026-10-18 tarixində birləşdirmə kampaniyası zamanı (`release/v3.8.52` üzərində saatda təxminən
|
||||
10 birləşdirmə) aparılan ölçmələr: **24 saatda 2,500 iş axını icrası yaradıldı**, 6 saat ərzində
|
||||
budağa 44 push edildi, PR yoxlamaları saatlarla gözlədiyi və PR-lər onlarsız birləşdirildiyi halda
|
||||
**106 host edilən tapşırıq növbəyə düşdü**. Budağa edilən hər push zamanı doqquz iş axını işə düşürdü:
|
||||
Anbar `cheaper-inference` təşkilatına məxsusdur** Komanda** plan:** 60 paralel iş yeri** , təşkilatdakı hər bir depo, hər PR yoxlanışı, hər təkanla işə salınan iş axını və CodeQL-nin standart quraşdırması tərəfindən paylaşılır. Aşağıdakı rəqəmlər üzərində ölçüldü** Pro** plan (40 eyni vaxtda qəbul edilən iş). Birləşmə kampaniyası zamanı 2026-10-18 tarixində ölçüldü ( `release/v3.8.52` üzrə ~ 10 merges/hour ):** 24 saat ərzində 2500 iş axını yaradıldı** , 6 saat ərzində filiala 44 itələyir,** 106 hosted iş növbəyə** PR çekləri isə saatlarla gözlədi və PRs onsuz birləşdirildi. Filial üçün hər təkanda doqquz iş axını işə salındı:
|
||||
|
||||
| `release/v*` üçün hər push | host edilən tapşırıqlar | yüklənmə zamanı nəticə | 2026-10-18 tarixindən etibarən |
|
||||
| ------------------------------------------- | ----------------------: | ------------------------------------------------------------------- | -------------------------------------------------------------------------------- |
|
||||
| `ci.yml` (tam matris) | 30-a qədər | növbəti push tərəfindən ləğv edildi, bir gündə 24-dən 24-ü | `release/**` push-larında başladılmır (PR icrası + Release-Green) |
|
||||
| `quality.yml` | ~6 | ləğv edildi, 23-dən 23-ü | `release/**` push-larında başladılmır |
|
||||
| `Release-Green` `--quick` | 0 | `omni-build` üzərində işlədi, 100-dən 97-si ləğv edildi | `omni-release` yuvası, heç vaxt ləğv edilmir, gözləyən icralar birləşdirilir |
|
||||
| `Lock released branch`, `OpenSSF Scorecard` | 2 | hər push üçün növbədə bir icra | hər ref üçün bir icra (`tests/unit/build/hosted-lane-concurrency.test.ts`) |
|
||||
| `Release acceptance` (kölgə hesabatı) | 1 | hər push üçün host edilən bir `npm ci`, heç vaxt ləğv edilmir | dəyişməyib — `paths:` filtri üçün namizəddir |
|
||||
| `Publish to Docker Hub` → `Deploy to VPS` | 2 | hər push üçün ləğv edilir; amd64 qolu `omni-build` üçün yarışır | dəyişməyib — sahibin yerləşdirmə kanalı |
|
||||
| CodeQL standart konfiqurasiyası (`dynamic`) | 4 | hər push üçün `javascript-typescript`, `actions`, `c-cpp`, `python` | dəyişməyib — Settings → Code security; `c-cpp`/`python` burada heç nə skan etmir |
|
||||
| `release/v*` üçün təkan başına | iş yerləri tutur | fırtına altında nəticə | 2026-10-18 tarixindən |
|
||||
| ------------------------------------------- | ---------------: | --------------------------------------------------------------- | ---------------------------------------------------------------------------------------- |
|
||||
| `ci.yml` (tam matris) | 30-a qədər | növbəti təkanla ləğv edildi, gündə 24-dən 24-ü | `release/**` təkanlarında başlamadı (PR run + Release-Green) |
|
||||
| `quality.yml` | ~6 | ləğv edildi, 23-dən 23-ü | `release/**` push-da başlamadı |
|
||||
| `Release-Green` `--quick` | 0 | `omni-build` da qaçdı, 100-dən 97-ni ləğv etdi | `omni-release` slot, heç vaxt ləğv edilməyib, gözlənilən qaçış dağılır |
|
||||
| `Lock released branch`, `OpenSSF Scorecard` | 2 | təkan başına bir növbəli qaçış | ref hər bir qaçış (`tests/unit/build/hosted-lane-concurrency.test.ts`) |
|
||||
| `Release acceptance` (kölgə hesabatı) | 1 | bir təkan başına `npm ci` hosted, ləğv heç vaxt | `paths:` filtri üçün dəyişməz — namizədi |
|
||||
| `Publish to Docker Hub` → `Deploy to VPS` | 2 | təkan üçün ləğv edilir; amd64 ayağı `omni-build` üzrə yarışır | dəyişməmiş — sahibinin yerləşdirmə kanalı |
|
||||
| CodeQL defolt quraşdırma (`dynamic`) | 4 | `javascript-typescript`, `actions`, `c-cpp`, `python` hər təkan | dəyişməz — Parametrləri → Kodu təhlükəsizliyi; `c-cpp`/`python` burada heç nə skan etmir |
|
||||
|
||||
`tests/unit/build/push-storm-diet.test.ts`, `ci.yml` və `quality.yml` fayllarının yalnız `main`
|
||||
üçün olan push trigger-ini sabitləyir. Yan təsir: Codecov artıq hər release push-u üçün baza
|
||||
yükləməsi almır (addım məlumat xarakterlidir və `continue-on-error` istifadə edir); repozitoriya
|
||||
daxilindəki əhatə qapısı və PR şərhi bundan təsirlənmir.
|
||||
`tests/unit/build/push-storm-diet.test.ts` `ci.yml` və `quality.yml` nin `main` -only təkan tetikleyicisini bərkidir. Yan təsir: Codecov artıq hər buraxılış üçün əsas yükləmə qəbul etmir (addım məlumat xarakterlidir və `continue-on-error`); in-repo əhatə qapısı və PR şərhi təsirlənmir.
|
||||
|
||||
**Daha çox self-hosted tutum host edilən növbəni düzəltmir.** Devbox
|
||||
(`devbox-vm-06-dev002`, 24 vCPU / 54 GB) bir icraçını host edə bilərdi, lakin agent sessiyaları
|
||||
artıq onun yükünü 20–26 səviyyəsində saxlayır, agent konteynerində Docker demonu yoxdur və
|
||||
doymuş zolaq host edilən zolaqdır. Eyni anda `.113` maşınında 71 GB boş yer və 5–8 yük var idi;
|
||||
onun məhdudiyyəti CPU deyil, yuxarıda göstərilən hər listener üçün yaddaş büdcəsidir
|
||||
(maksimum 6 listener). Qalan imkanlar proseslə bağlıdır: kampaniya PR-lərini Mergify növbəsi
|
||||
vasitəsilə birləşdirin (`label=queue`; paketlər hər PR üçün bir icra və hər push üçün əlavə bir
|
||||
icra əvəzinə bir `merge_group` CI icrasını paylaşır), CodeQL standart konfiqurasiyasındakı
|
||||
dilləri azaldın və `release-acceptance.yml` faylını oxuduğu fayllara əsasən filtrləyin.
|
||||
**Daha çox öz-özünə yerləşdirilən tutum ev sahibliyi növbəsini düzəltmir.** Devbox (`devbox-vm-06-dev002`, 24 vCPU / 54 GB) bir qaçışçıya ev sahibliyi edə bilər, lakin agent seansları artıq yükünü 20-26 səviyyəsində saxlayır, agent konteynerində Docker demonu yoxdur və doymuş zolaq hosteddir. `.113` qutusunda 71 GB boş və eyni anda 5-8 yük var idi; onun məhdudiyyəti yuxarıdakı hər dinləyici üçün yaddaş büdcəsidir (tavan 6 dinləyici), CPU deyil. Qalan rıçaqlar prosesdir: Birləşdirmə növbəsi vasitəsilə torpaq kampaniyası PRs (`label=queue`, partiyalar hər PR başına bir qaçış əvəzinə bir `merge_group` CI qaçışını paylaşır və hər təkan üçün bir qaçış), CodeQL defolt quraşdırma dillərini kəsin və oxuduğu fayllara görə `release-acceptance.yml` süzün.
|
||||
|
||||
> **2026-11-19: the Mergify merge queue is retired** (owner's decision). `.mergify.yml` no longer defines a queue and refuses the Mergify commands that merge or rewrite a pull request. Release PRs are merged by hand under the repository ruleset "Require green gates on the active release" (`Gate / CI` + `Gate / Quality`) until omni-queue runs in live mode, and through omni-queue after that ([OMNI_QUEUE.md](./OMNI_QUEUE.md)). The Mergify lever above no longer exists.
|
||||
|
||||
@@ -25,10 +25,12 @@
|
||||
|
||||
Обикновен PR изпълнява бързия избор. Лентите `full-code` и `full-code-e2e` на правилата за допускане (E2E, интеграция, артефакт на пакета, Electron дим, Bun SQLite, клиенти на екосистема и протокол) се изпълняват само на чернова на опашка на Mergify или на пълно изпълнение: `gh workflow run ci.yml --ref <branch>`.
|
||||
|
||||
Всяка разписка JSON идентифицира извършения SHA, изпълнение и опит за работен поток. CLI отхвърля checkout/event SHA несъответствие. Тестовете на работния процес обвързват членството в правилата към `needs` списъка на заданието за присъда, така че нова или премахната лента не може да изчезне тихо. Разписките покриват техния собствен работен процес, а не публикуване, внедряване или вътрешността на съществуващ консултативен скенер. Активирането на двете имена на проверка в правилата на клона е отделна административна промяна; добавянето на тези работни места само по себе си не защитава клон.
|
||||
Всяка разписка JSON идентифицира извършения SHA, изпълнение и опит за работен поток. CLI отхвърля checkout/event SHA несъответствие. Тестовете на работния процес обвързват членството в правилата към `needs` списъка на заданието за присъда, така че нова или премахната лента не може да изчезне тихо. Разписките покриват техния собствен работен процес, а не публикуване, внедряване или вътрешността на съществуващ консултативен скенер. Активирането на двете имена на проверка в правилата на клоновете е отделна административна промяна; добавянето на тези работни места само по себе си не защитава клон.
|
||||
|
||||
### Обединяване на опашка
|
||||
|
||||
> **2026-11-19: опашката за сливане на Mergify е оттеглена** (решение на собственика). `.mergify.yml` вече не дефинира опашка и отказва командите Mergify, които обединяват или пренаписват заявка за изтегляне. Изданието PRs се обединява на ръка под набора от правила на хранилището „Изискване на зелени порти при активното издание“ (`Gate / CI` + `Gate / Quality`), докато omni-queue работи в режим на живо и през omni-queue след това ( [OMNI_QUEUE.md](../ops/OMNI_QUEUE.md) ). Обработката на работния процес на чернови на Mergify, описана по-долу, все още е в `ci.yml` и `quality.yml`, но вече не се отваря чернова на Mergify.
|
||||
|
||||
Етикетът `queue` изпраща PR към опашката Mergify (`.mergify.yml`). Mergify отваря чернова PR на `mergify/merge-queue/` клон, CI изпълнява пълната селекция там и оригиналният PR се слива, когато `Gate / CI`, `Gate / Quality` и `Merge integrity (changelog + generated skills)` преминат.
|
||||
|
||||
Mergify записва резюмето на своята опашка в описанието на черновата и други приложения също могат да го редактират. Събитие `pull_request` `edited` на такава чернова приема своя собствена паралелна група (`-queue-edit-<run_id>`), така че не може да отмени реалното изпълнение на черновата и прескача портата и матрицата. Само `Merge integrity` все още работи. Пропуснатата задача на порта носи различно име на проверка, тъй като Mergify чете пропуснато `Gate / CI` като неуспешна проверка и депоставя PR.
|
||||
@@ -55,56 +57,56 @@ CLI изисква `--evidence-root` да провери запазените д
|
||||
|
||||
`.github/workflows/quality.yml` допълва CI на main/release PRs, избутва към `main`, изпраща и обединява групи. PRs използва бързи проверки, филтрирани по пътя. Постоянно деактивираната дублирана компилация беше премахната; истинските build/package/boot проверки остават в CI. Единичният пакет и vitest работят само в CI (`Unit Tests (N/8)` и `Vitest`).
|
||||
|
||||
| работа | Обхват | Блокиране |
|
||||
| ------------------------------------------------ | ------------------------------------------------------------------------------------------------------------------------------------------------------------- | ---------------------- |
|
||||
| `Docs Gates (fast-path)` | Docs/code PRs; API docs refs и docs-all | да |
|
||||
| `Fast Quality Gates` | Код PRs; статични проверки, проверка на тип, проверка на тип на таблото за управление, повлияни тестове на единици, забравени братски тестове (консултативно) |
|
||||
| `No new ESLint warnings` | Код PRs; предпазител за власинки, осведомен за потискане | Да, включително вилици |
|
||||
| `Merge integrity (changelog + generated skills)` | Нечернова PRs; регистър на промените и синхронизиране на генерирани умения | Да, включително вилици |
|
||||
| работа | Обхват | Блокиране |
|
||||
| ------------------------------------------------ | ----------------------------------------------------------------------------------------------------------------------------------------------- | ---------------------- |
|
||||
| `Docs Gates (fast-path)` | Docs/code PRs; API docs refs и docs-all | да |
|
||||
| `Fast Quality Gates` | Код PRs; статични проверки, проверка на тип, проверка на тип на таблото, повлияни тестове на единици, забравени братски тестове (консултативно) |
|
||||
| `No new ESLint warnings` | Код PRs; предпазител за власинки, осведомен за потискане | Да, включително вилици |
|
||||
| `Merge integrity (changelog + generated skills)` | Нечернова PRs; регистър на промените и синхронизиране на генерирани умения | Да, включително вилици |
|
||||
|
||||
#### Доклад от тестовете за забравени братя и сестри
|
||||
|
||||
`npm run check:forgotten-sibling-tests` работи като препоръчителна стъпка на `Fast Quality Gates` и използва повторно резолвера за импортиране зад картата на въздействието на теста. За всеки променен производствен модул той отчита детерминистични `changed module/symbol -> static consumer -> candidate sibling test` вериги, когато кандидат тестът отсъства от diff. Обобщението на Markdown и резултатът JSON се запазват като артефакт на работния поток `forgotten-sibling-tests` за калибриране преди всяко блокиращо внедряване.
|
||||
`npm run check:forgotten-sibling-tests` работи като препоръчителна стъпка на `Fast Quality Gates` и използва повторно резолвера за импортиране зад картата на въздействието на теста. За всеки променен производствен модул той отчита детерминистични `changed module/symbol -> static consumer -> candidate sibling test` вериги, когато тестът за кандидат отсъства от diff. Обобщението на Markdown и резултатът JSON се запазват като артефакт на работния поток `forgotten-sibling-tests` за калибриране преди всяко блокиращо внедряване.
|
||||
|
||||
Реекспортирането на барел и динамичното импортиране са само диагностика на разделителната способност; те никога не създават блокираща констатация. Прегледани изключения на живо в `config/quality/forgotten-sibling-allowlist.json`. Всеки запис трябва да посочи потребителския и кандидат теста, да даде конкретна обосновка и да свърже GitHub проблем или заявка за изтегляне. Деформираните записи не са затворени. Изключенията не могат да потиснат изтрит кандидат тест или разлика, която добавя `.skip`/`.todo`; отслабването на твърдението и друго маскиране остават собственост на независимо блокиращия порт `check:test-masking`.
|
||||
Реекспортирането на барел и динамичното импортиране са само диагностика на разделителната способност; те никога не създават блокираща констатация. Прегледани изключения на живо в `config/quality/forgotten-sibling-allowlist.json`. Всеки запис трябва да назовава теста на потребителя и кандидата, да дава конкретна обосновка и да свързва GitHub проблем или заявка за изтегляне. Деформираните записи не са затворени. Изключенията не могат да потиснат изтрит кандидат тест или разлика, която добавя `.skip`/`.todo`; отслабването на твърдението и друго маскиране остават собственост на независимо блокиращия `check:test-masking` порт.
|
||||
|
||||
### Работа: `lint`
|
||||
|
||||
Работи на всеки PR до `main`. Блоковете се сливат при повреда.
|
||||
|
||||
| Скрипт (`npm run ...`) | Валидира | Блокиране |
|
||||
| --------------------------------- | -------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | --------------------------------------------- |
|
||||
| `check:node-runtime` | Node.js версията е в рамките на поддържания диапазон | да |
|
||||
| `check:cycles` | Циркулярно импортиране в целия `src/` + `open-sse/` (базиран на AST, tsconfig `paths` разрешен). Bare излиза от 1 всеки път, когато съществува някакъв цикъл (неуспешно затворен от #15281) и изброява SCCs. `check:cycles:ratchet` (какво изпълнява CI ) блокира, когато броячът надвиши тавана на `metrics.cycles` в `quality-baseline.json` — в момента е 14, `direction: down`, така че може да падне само (#15159 G-01/G-02) | Да (тресчотка) |
|
||||
| `check:boundary` | `open-sse → src` свързване: уникално импортиране от файл към файл от двигателя в приложението (`scripts/quality/measure-boundary.mjs`; крайният списък е v4 core/module-split remediation backlog). Голи = консултативен доклад (същото като `quality:boundary`). `check:boundary:ratchet` (това, което CI изпълнява, също и в `quality.yml` бързите порти с тресчотка) блокира, когато броячът надвиши тавана `metrics.boundaryOpenSseToSrc` в `quality-baseline.json` — зареден при измерените 771, `direction: down`; `--update` само го понижава; базово относително на PRs (`--base-ref`, вижте по-долу) | Да (тресчотка) |
|
||||
| `check:route-validation:t06` | Zod схеми присъстват на всички маршрути (Tier 6 policy) | да |
|
||||
| `check:any-budget:t11` | `@ts-expect-error // any` броят не надвишава бюджета (Tier 11 catraca) | да |
|
||||
| `check:provider-consistency` | Всеки доставчик в `providers.ts` има съответстващ запис в `providerRegistry.ts` (и обратно, в списъка с разрешени) | да |
|
||||
| `check:model-lifecycle` | Трите ръчно поддържани таблици за маршрутизиране остават в съответствие с регистрираната моментна снимка на жизнения цикъл (#11503): `FITNESS_TABLE` (`taskFitness.ts`) не отбелязва оттеглен идентификатор, който `REGISTRY` може да маршрутизира; всяка `BUILT_IN_ALIASES` цел присъства в `REGISTRY` и отсъства от моментната снимка на пенсионирания идентификатор; всеки оттеглен идентификатор, който все още е в `REGISTRY`, се препраща или се посочва в `allowedRetiredInCatalog`; и нито един `DEFAULT_DEGRADATION_MAP` източник или цел не изглежда пенсиониран в тази моментна снимка. Това не доказва, че даден модел в момента се обслужва от живо нагоре по веригата. Офлайн — сравнява с `config/quality/model-lifecycle.json`, обновен ръчно с `npm run quality:refresh-model-lifecycle` (мрежа; не е свързан към CI). `allowedRetiredInCatalog` е тресчотка за изгаряне: добавете запис само с проблем с проследяването. | да |
|
||||
| `check:fetch-targets` | Всеки `fetch("/api/...")` в `src/` от страна на клиента се разрешава до истински `route.ts` | да |
|
||||
| `check:deps` | Всички `npm install` -able deps във всеки `package.json` в репото са в `dependency-allowlist.json`; маркирани с флаг за нови незакрепени или неправилни пакети | да |
|
||||
| `audit:deps` | npm одит на всичките пет независими заключващи файла (root, Electron, OpenCode добавки v1/v2 и доставчик). Блокиране на критични съвети; високите съвети остават видими предупреждения. Missing/failed одитите са INCOMPLETE и блокират; хешовете и отчетите за заключване на обхват се запазват. | да |
|
||||
| `check:lockfile` | `package-lock.json` интегритет — https регистър, хешове за интегритет, без заместване на хост | да |
|
||||
| `check:licenses` | SPDX списък с разрешени лицензи за производствени зависимости | да |
|
||||
| `check:tracked-artifacts` | Без артефакти на компилация/коммитирани `node_modules` символни връзки (също се изпълнява в husky pre-commit; pre-push е умишлено лек — #6716) | да |
|
||||
| `check:ai-attribution` | Без AI/bot `Co-Authored-By` трейлър или долен колонтитул за генериране на изкуствен интелект в PR ангажименти, заглавие или тяло — Твърдо правило #16 (в `quality.yml` цикъла за бързи врати за PR→ `release/**` — чете полезния товар на събитието, без операция изключване PRs — и стъпка само за PR в `ci.yml` lint за PR→ `main`; също хъски `commit-msg` hook; позволени човешки съавтори #14436) |
|
||||
| `check:vitest-exclusions` | Всяко Vitest изключване назовава проблем с проследяването и се появява в `config/quality/vitest-exclusions.json` (#13204) | да |
|
||||
| `check:file-size` | Изходните файлове (`.ts`/`.tsx` в `src/`, `open-sse/`, `electron/`, `bin/`) остават в `cap`, а тестовите файлове (`*.test.ts(x)`) в `testCap`; файловете, замразени в `file-size-baseline.json` (`frozen` / `testFrozen`), не трябва да нарастват над техния записан размер | да |
|
||||
| `check:error-helper` | Отговорите за грешка в executors/handlers използват `buildErrorBody()` / `sanitizeErrorMessage()` (твърдо правило #12) | да |
|
||||
| `check:migration-numbering` | Имена на файлове за миграция: старата серия `001`–`241` е замразена, а новите файлове са `YYYYMMDDHHMMSS_<description>.sql`. Спрямо PR базата отхвърля премахната миграция, преименувана без запис за съвместимост и неправилна или редактирана, чиято окончателна схема не се движи |
|
||||
| `check:public-creds` | Без литерал OAuth `client_id`/`client_secret` или Firebase уеб ключове извън `publicCreds.ts` (твърдо правило #11) | да |
|
||||
| `check:db-rules` | Без необработен SQL извън `src/lib/db/` модули; без импортиране на барел от `localDb.ts` (твърди правила #2/#5) | да |
|
||||
| `check:known-symbols` | Изпълнители на доставчици, стратегии за маршрутизиране и преводачи, регистрирани в техните таблици за изпращане, съответстват на файловете на диска — без осиротели или недекларирани символи | да |
|
||||
| `check:route-guard-membership` | Всеки маршрут, който ражда дъщерен процес, се класифицира от `isLocalOnlyPath()` (твърди правила #15/#17) | да |
|
||||
| `check:test-discovery` | Всеки `*.test.ts` / `*.spec.ts` файл в репото се събира от поне един тестов участник (ratchet: списъкът на осиротели в `test-discovery-baseline.json` може само да се свие) | да |
|
||||
| `check:test-tla-order` | Нито един `node:test` файл под `tests/unit` не регистрира тест, достига `await` от най-високо ниво, след което регистрира още (#18045; тресчотка: `test-tla-order-allowlist.json` може само да се свие) | да |
|
||||
| `check:agent-skills-sync` | Генерираните артефакти на агент-умения съответстват на изходния им каталог (без дрейф). Режимът на освобождаване проверява всяко умение; функция PR (режим `pr` ) проверява само уменията, чийто генериран текст редактира — вижте [Генерирани файлове и извлечени базови линии](#generated-files-and-derived-baselines-written-at-release) |
|
||||
| `check:provider-asset-provenance` | Доставчикът logos/assets носи записан запис за произход |
|
||||
| `lint:json` | JSON конфигурационните файлове анализират и удовлетворяват правилата за repo lint |
|
||||
| `typecheck:core` | TypeScript компилация без грешки (само препоръчителни предупреждения) | да |
|
||||
| `typecheck:noimplicit:core` | Строго `noImplicitAny` — гледащ напред; много вече съществуващи сайтове за обаждания все още се нуждаят от анотации | **Консултативен** (`continue-on-error: true`) |
|
||||
| `check:dashboard-typecheck` | `tsc` обхваща `src/app/(dashboard)/**` (#7033) — Курираният списък с разрешени 27 файла `typecheck:core` не включва никакво табло за управление TSX и `next build` също никога не го проверява тип (`next.config.mjs` задава `ignoreBuildErrors: true`), така че регресиите на осиротели идентификатори там (#6625/#6909) бяха невидими за CI. Разлики спрямо замразена изходна линия на преброяване per-file/per-TS-code (`config/quality/dashboard-typecheck-baseline.json`, същият модел на остаряло прилагане като `check:known-symbols`) — само NEW грешки извън преброяването на изходната линия пропускат портата; се понижава с `--update` когато е коригирана съществуваща грешка. | да |
|
||||
| `check:build-typecheck` | Производствената проверка на цялото приложение през `tsconfig.build.json` (`src`, `open-sse`, `packages`, `bin`, `scripts`, `electron/**/*.d.ts`), повърхностният списък с 27 разрешени файла на `typecheck:core` и портата на таблото не покриват. Разлики спрямо `config/quality/build-typecheck-baseline.json`; нов или повишен брой на (файл, код) е неуспешен, по-нисък брой ви моли да увеличите. `--update` отказва, докато изпълнението съдържа нова или повдигната двойка, освен ако не бъде подаден `--force-regressions`, и отказва наскоро заглушен файл, освен ако не бъде подаден `--force-nocheck`, така че разширяването на базовата линия, за да стане зелено, и предоставянето на постоянно мълчание са две отделни умишлени действия. Голият `--force` се отхвърля. Също така сканира обхвата на компилация за `@ts-nocheck` срещу `config/quality/ts-nocheck-baseline.json`, тъй като файл, който го използва, не отчита никаква диагностика и иначе би бил невидим за всеки портал. | да |
|
||||
| Скрипт (`npm run ...`) | Валидира | Блокиране |
|
||||
| --------------------------------- | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | --------------------------------------------- |
|
||||
| `check:node-runtime` | Node.js версията е в рамките на поддържания диапазон | да |
|
||||
| `check:cycles` | Циркулярно импортиране в целия `src/` + `open-sse/` (базиран на AST, tsconfig `paths` разрешен). Bare излиза от 1 всеки път, когато съществува някакъв цикъл (неуспешно затворен от #15281) и изброява SCCs. `check:cycles:ratchet` (какво изпълнява CI ) блокира, когато броячът надвиши тавана на `metrics.cycles` в `quality-baseline.json` — в момента е 14, `direction: down`, така че може да падне само (#15159 G-01/G-02) | Да (тресчотка) |
|
||||
| `check:boundary` | `open-sse → src` свързване: уникално импортиране от файл към файл от двигателя в приложението (`scripts/quality/measure-boundary.mjs`; крайният списък е v4 core/module-split remediation backlog). Голи = консултативен доклад (същото като `quality:boundary`). `check:boundary:ratchet` (това, което CI изпълнява, също и в `quality.yml` бързите порти с тресчотка) блокира, когато броячът надвиши тавана `metrics.boundaryOpenSseToSrc` в `quality-baseline.json` — зареден при измерените 771, `direction: down`; `--update` само го понижава; базово относително на PRs (`--base-ref`, вижте по-долу) | Да (тресчотка) |
|
||||
| `check:route-validation:t06` | Zod схеми присъстват на всички маршрути (Tier 6 policy) | да |
|
||||
| `check:any-budget:t11` | `@ts-expect-error // any` броят не надвишава бюджета (Tier 11 catraca) | да |
|
||||
| `check:provider-consistency` | Всеки доставчик в `providers.ts` има съответстващ запис в `providerRegistry.ts` (и обратно, в списъка с разрешени) | да |
|
||||
| `check:model-lifecycle` | Трите ръчно поддържани таблици за маршрутизиране остават в съответствие с регистрираната моментна снимка на жизнения цикъл (#11503): `FITNESS_TABLE` (`taskFitness.ts`) не отбелязва оттеглен идентификатор, който `REGISTRY` може да маршрутизира; всяка `BUILT_IN_ALIASES` цел присъства в `REGISTRY` и отсъства от моментната снимка на пенсионирания идентификатор; всеки оттеглен идентификатор, който все още е в `REGISTRY`, се препраща или се посочва в `allowedRetiredInCatalog`; и нито един `DEFAULT_DEGRADATION_MAP` източник или цел не изглежда пенсиониран в тази моментна снимка. Това не доказва, че даден модел в момента се обслужва от живо нагоре по веригата. Офлайн — сравнява с `config/quality/model-lifecycle.json`, обновен ръчно с `npm run quality:refresh-model-lifecycle` (мрежа; не е свързан към CI). `allowedRetiredInCatalog` е тресчотка за изгаряне: добавете запис само с проблем с проследяването. | да |
|
||||
| `check:fetch-targets` | Всеки `fetch("/api/...")` в `src/` от страна на клиента се разрешава до истински `route.ts` | да |
|
||||
| `check:deps` | Всички `npm install` -able deps във всеки `package.json` в репото са в `dependency-allowlist.json`; маркирани с флаг за нови незакрепени или слепени пакети | да |
|
||||
| `audit:deps` | npm одит на всичките пет независими заключващи файла (root, Electron, OpenCode добавки v1/v2 и доставчик). Блокиране на критични съвети; високите съвети остават видими предупреждения. Missing/failed одитите са INCOMPLETE и блокират; хешовете и отчетите за заключване на обхват се запазват. | да |
|
||||
| `check:lockfile` | `package-lock.json` интегритет — https регистър, хешове за интегритет, без заместване на хост | да |
|
||||
| `check:licenses` | SPDX списък с разрешени лицензи за производствени зависимости | да |
|
||||
| `check:tracked-artifacts` | Без артефакти на компилация/коммитирани `node_modules` символни връзки (също се изпълнява в husky pre-commit; pre-push е умишлено лек — #6716) | да |
|
||||
| `check:ai-attribution` | Без AI/bot `Co-Authored-By` трейлър или AI-генериран долен колонтитул в PR ангажименти, заглавие или тяло — Hard Rule #16 (в `quality.yml` цикъла за бързи порти за PR→ `release/**` — чете полезния товар на събитието, без операция изключване PRs — и стъпка само за PR в `ci.yml` lint за PR→ `main`; също хъски `commit-msg` hook; разрешени са човешки съавтори #14436) |
|
||||
| `check:vitest-exclusions` | Всяко Vitest изключване назовава проблем с проследяването и се появява в `config/quality/vitest-exclusions.json` (#13204) | да |
|
||||
| `check:file-size` | Изходните файлове (`.ts`/`.tsx` в `src/`, `open-sse/`, `electron/`, `bin/`) остават в `cap`, а тестовите файлове (`*.test.ts(x)`) в `testCap`; файловете, замразени в `file-size-baseline.json` (`frozen` / `testFrozen`), не трябва да нарастват над техния записан размер | да |
|
||||
| `check:error-helper` | Отговорите за грешка в executors/handlers използват `buildErrorBody()` / `sanitizeErrorMessage()` (твърдо правило #12) | да |
|
||||
| `check:migration-numbering` | Имена на файлове за миграция: старата серия `001`–`241` е замразена, а новите файлове са `YYYYMMDDHHMMSS_<description>.sql`. Спрямо PR базата отхвърля премахната миграция, преименувана без запис за съвместимост и нередактирана или редактирана, чиято окончателна схема не комутира |
|
||||
| `check:public-creds` | Без литерал OAuth `client_id`/`client_secret` или Firebase уеб ключове извън `publicCreds.ts` (твърдо правило #11) | да |
|
||||
| `check:db-rules` | Без необработен SQL извън `src/lib/db/` модули; без импортиране на барел от `localDb.ts` (твърди правила #2/#5) | да |
|
||||
| `check:known-symbols` | Изпълнители на доставчици, стратегии за маршрутизиране и преводачи, регистрирани в техните таблици за изпращане, съответстват на файловете на диска — без осиротели или недекларирани символи | да |
|
||||
| `check:route-guard-membership` | Всеки маршрут, който ражда дъщерен процес, се класифицира от `isLocalOnlyPath()` (твърди правила #15/#17) | да |
|
||||
| `check:test-discovery` | Всеки `*.test.ts` / `*.spec.ts` файл в репото се събира от поне един тестов участник (ratchet: списъкът на осиротели в `test-discovery-baseline.json` може само да се свие) | да |
|
||||
| `check:test-tla-order` | Нито един `node:test` файл под `tests/unit` не регистрира тест, достига `await` от най-високо ниво, след което регистрира още (#18045; тресчотка: `test-tla-order-allowlist.json` може само да се свие) | да |
|
||||
| `check:agent-skills-sync` | Генерираните артефакти на агент-умения съответстват на изходния им каталог (без дрейф). Режимът на освобождаване проверява всяко умение; функция PR (режим `pr` ) проверява само уменията, чийто генериран текст редактира — вижте [Генерирани файлове и извлечени базови линии](#generated-files-and-derived-baselines-written-at-release) |
|
||||
| `check:provider-asset-provenance` | Доставчикът logos/assets носи записан запис за произход |
|
||||
| `lint:json` | JSON конфигурационните файлове анализират и удовлетворяват правилата за repo lint |
|
||||
| `typecheck:core` | TypeScript компилация без грешки (само препоръчителни предупреждения) | да |
|
||||
| `typecheck:noimplicit:core` | Строго `noImplicitAny` — с поглед към бъдещето; много вече съществуващи сайтове за обаждания все още се нуждаят от анотации | **Консултативен** (`continue-on-error: true`) |
|
||||
| `check:dashboard-typecheck` | `tsc` обхваща `src/app/(dashboard)/**` (#7033) — Курираният списък с разрешени 27 файла `typecheck:core` не включва никакво табло за управление TSX и `next build` също никога не го проверява тип (`next.config.mjs` задава `ignoreBuildErrors: true`), така че регресиите на осиротели идентификатори там (#6625/#6909) бяха невидими за CI. Разлики спрямо замразена изходна линия на преброяване per-file/per-TS-code (`config/quality/dashboard-typecheck-baseline.json`, същият модел на остаряло прилагане като `check:known-symbols`) — само NEW грешки извън преброяването на изходната линия пропускат портата; затягане надолу с `--update`, когато е коригирана съществуваща грешка. | да |
|
||||
| `check:build-typecheck` | Производствената проверка на цялото приложение през `tsconfig.build.json` (`src`, `open-sse`, `packages`, `bin`, `scripts`, `electron/**/*.d.ts`), повърхностният списък с 27 разрешени файла на `typecheck:core` и портата на таблото не покриват. Разлики срещу `config/quality/build-typecheck-baseline.json`; нов или повишен брой за (файл, код) е неуспешен, по-нисък брой ви моли да увеличите. `--update` отказва, докато изпълнението съдържа нова или повдигната двойка, освен ако не бъде подаден `--force-regressions`, и отказва наскоро заглушен файл, освен ако не бъде подаден `--force-nocheck`, така че разширяването на базовата линия, за да стане зелено, и предоставянето на постоянно мълчание са две отделни умишлени действия. Голият `--force` се отхвърля. Също така сканира обхвата на компилация за `@ts-nocheck` срещу `config/quality/ts-nocheck-baseline.json`, тъй като файл, който го използва, не отчита никаква диагностика и иначе би бил невидим за всеки портал. | да |
|
||||
|
||||
#### Две програми за проверка на типа отговарят по различен начин
|
||||
|
||||
@@ -166,16 +168,16 @@ CLI изисква `--evidence-root` да провери запазените д
|
||||
|
||||
#### Огледалата за превод са производни файлове (режим PR срещу режим на освобождаване)
|
||||
|
||||
Функция PR редактира само английски източници. `docs/i18n/<locale>/**` огледалата (включително 66 `llm.txt` копия и преведените `CHANGELOG.md` файлове) и `.i18n-state.json` се пренаписват на една стъпка от вълната на превод (`docs/i18n-*` / `chore/i18n-*` клонове, планираният `i18n-mirror-refresh.yml`) и от изданието (`npm run release:sync-changelog-i18n`). Следователно огледалните порти работят в два режима, разрешени от `scripts/check/lib/gateMode.mjs` (`--mode=pr|release`, след това `OMNIROUTE_GATE_MODE`, след това събитието Действия; локално изпълнение е `release`):
|
||||
Функция PR редактира само английски източници. `docs/i18n/<locale>/**` огледалата (включително 66 `llm.txt` копия и преведените `CHANGELOG.md` файлове) и `.i18n-state.json` се пренаписват на една стъпка от вълната на транслацията (`docs/i18n-*` / `chore/i18n-*` клонове, планираният `i18n-mirror-refresh.yml`) и от изданието (`npm run release:sync-changelog-i18n`). Следователно огледалните порти работят в два режима, разрешени от `scripts/check/lib/gateMode.mjs` (`--mode=pr|release`, след това `OMNIROUTE_GATE_MODE`, след това събитието Действия; локално изпълнение е `release`):
|
||||
|
||||
- `check:docs-sync` — освобождаване режим изпълнява всяка проверка. PR режимът запазва package.json/OpenAPI версията, основните CHANGELOG заглавия и защитата на заменените документи и отпечатва `SKIP reason=pr-mode` за `llm.txt` огледалните копия и преведените CHANGELOG секции — освен ако PR не пише огледално: главен клон, деклариран като писател на семейството `docs/i18n/**` в `config/quality/derived-paths/*.json` изпълнява стриктно и двете проверки и, когато diff базата се разреши, промяна, чийто собствен diff редактира `docs/i18n/<locale>/llm.txt` или `CHANGELOG.md` работи, които проверяват стриктно. Основата на разликата не се разрешава в проверка depth-1 (заданието `docs-sync-strict` ), така че режимът PR също изпълнява една проверка, която не се нуждае от база: всяко `llm.txt` огледало трябва да съществува, да запази своя `---` разделител и да носи или основното тяло, или тялото, което повечето огледала споделят. Преместена основа оставя всички огледала еднакво остарели и преминава; ръчното редактиране на едно огледало е неуспешно. Преведените `CHANGELOG.md` файлове нямат такава проверка в depth-1 PR checkout.
|
||||
- Куката преди поемане изпълнява `check-docs-sync.mjs --mode=pr`: поемането се преценява според това, което прави. Без флага локалното изпълнение е режим на освобождаване и един обединен PR, който редактира корена `llm.txt` ще блокира всеки по-късен комит на тази база, докато вълната не се изпълни. Същото правило важи за всяка порта, съобразена с режима, която изпълнява Husky кука: куката преминава `--mode=pr` и строгата присъда остава с изпълнението на режима на освобождаване (освобождаването PR, натиска към `main`, обикновено локално изпълнение).
|
||||
- Куката преди поемане изпълнява `check-docs-sync.mjs --mode=pr`: поемането се преценява според това, което прави. Без флага локалното изпълнение е режим на освобождаване и един обединен PR, който редактира корена `llm.txt` ще блокира всеки по-късен комит на тази база, докато вълната не се изпълни. Същото правило важи за всяка врата, съобразена с режима, която изпълнява Husky кука: куката преминава `--mode=pr` и строгата присъда остава с изпълнението на режима на освобождаване (освобождаването PR, натиска към `main`, обикновено локално изпълнение).
|
||||
- Единични тестове с огледално съдържание (`tests/_helpers/mirrorFreshness.ts`: `cycle-docs-mirror-contract`, `resilience-pre-dispatch-docs-mirrors`, `cli-env-quality-docs-mirrors`, `docs/*-locales`) Режимът на издаване на — потвърждава всеки локал. Режимът PR потвърждава само огледалата, които са актуални с английския източник според `.i18n-state.json` (хеш на целия файл или записаната хеш на секция на секцията, която тестовите пинове) и пропуска остарелите с причина. Проверките за произход `target_hash` се изпълняват за всеки локал и в двата режима. Свежестта е за `## ` раздел, единицата `run-translation.mjs` хешове; дълъг раздел (описът на портала на този файл е около половината от него) означава, че всяка редакция в него оставя тези огледала остарели и техните твърдения в PR режим прескачат до следващата вълна. Котва, която английският източник вече не съдържа, се връща към сравнението на целия файл.
|
||||
- `i18n translation drift` — съвети за PRs, стриктно за натискане, нощно изрязване и освобождаване, така че остаряло огледало не може да бъде изпратено в издание.
|
||||
|
||||
`scripts/i18n/sync-llm-mirrors.mjs` (също експортиран като `syncLlmMirrors()`, с `--dry-run`) пренаписва `llm.txt` огледалата; опресняването на изданието, вълната на превода и планираното `i18n-mirror-refresh.yml` стартиране (опресняването открива остарели `llm.txt` огледала със суха работа, тъй като отчетът за отклонение не ги изброява и ги синхронизира преди `check:docs-all`).
|
||||
|
||||
Генерират се дванадесетте README SVGs под `docs/diagrams/` (`scripts/docs/gen-readme-<name>.mjs`; `npm run docs:readme-diagrams` регенерира всички). Всеки има единичен тест за сравнение на байтове (`tests/unit/docs/readme-*-svg.test.ts`, задание `test-unit`), който се проваля, когато ангажираният файл е остарял в режим на освобождаване; в PR, `check:generated-artifacts` преценява SVG, PR редактира и отклонението на базата е оставено на опресняване на изданието (вижте [Генерирани файлове и извлечени базови линии](#generated-files-and-derived-baselines-written-at-release) ) — и `check:docs-counts` чете канонични числа от техните `<text>` възли — поради което стъпката на очертаване запазва всеки очертан низ във файла като невидим `<text>`. Проверката на каноничните числа SVG чете файловете, изброени в `SVG_DIAGRAM_FILES` (`scripts/check/check-docs-counts-sync.mjs`): `docs/diagrams/readme-hero.svg`, `free-tier-budget.svg`, `promise-pillars.svg`, `comparison-table.svg`, `cli-terminal.svg`, `tier-cascade.svg`, плюс `public/images/tier-flow-dark.svg` и `tier-flow-light.svg`; претенциите за безплатен завинаги, влизане в каталог, повтарящ се пул и коефициенти за оценка също гласят `promise-pillars.svg`, `free-tier-budget.svg` и `strategies-grid.svg`. Преброяването, което тези генератори извличат (обща сума на доставчика, инструменти MCP, стратегии за маршрутизиране, безплатни завинаги доставчици, …) идва от моментната снимка на фактите `docs/reference/derived-facts.json` до `scripts/docs/readmeFacts.mjs`, а не от литерали, така че повторното генериране на диаграма във всеки клон възпроизвежда ангажирания файл. `free-tier-budget.svg` черпи своите редове от същата моментна снимка (`code.freeTierBudget`, резюмето на каталога, записвано от сондата), така че промяната на `FREE_MODEL_BUDGETS` достига картата при следващото опресняване, вместо да оцвети CI в червено.
|
||||
Генерират се дванадесетте README SVGs под `docs/diagrams/` (`scripts/docs/gen-readme-<name>.mjs`; `npm run docs:readme-diagrams` регенерира всички). Всеки има единичен тест за сравнение на байтове (`tests/unit/docs/readme-*-svg.test.ts`, задание `test-unit`), който се проваля, когато ангажираният файл е остарял в режим на освобождаване; в PR, `check:generated-artifacts` преценява SVG, PR редактира и отклонението на базата е оставено на опресняване на изданието (вижте [Генерирани файлове и извлечени базови линии](#generated-files-and-derived-baselines-written-at-release) ) — и `check:docs-counts` чете канонични числа от техните `<text>` възли — поради което стъпката на очертаване запазва всеки очертан низ във файла като невидим `<text>`. Проверката на каноничните числа SVG чете файловете, изброени в `SVG_DIAGRAM_FILES` (`scripts/check/check-docs-counts-sync.mjs`): `docs/diagrams/readme-hero.svg`, `free-tier-budget.svg`, `promise-pillars.svg`, `comparison-table.svg`, `cli-terminal.svg`, `tier-cascade.svg`, плюс `public/images/tier-flow-dark.svg` и `tier-flow-light.svg`; претенциите за безплатен завинаги, влизане в каталог, повтарящ се пул и коефициенти за оценка също гласят `promise-pillars.svg`, `free-tier-budget.svg` и `strategies-grid.svg`. Преброяването, което тези генератори изготвят (обща сума на доставчика, MCP инструменти, стратегии за маршрутизиране, безплатни завинаги доставчици, …) идва от моментната снимка на фактите `docs/reference/derived-facts.json` до `scripts/docs/readmeFacts.mjs`, а не от литерали, така че повторното генериране на диаграма във всеки клон възпроизвежда ангажирания файл. `free-tier-budget.svg` черпи своите редове от същата моментна снимка (`code.freeTierBudget`, резюмето на каталога, записвано от сондата), така че промяната на `FREE_MODEL_BUDGETS` достига до картата при следващото опресняване, вместо да оцвети CI в червено.
|
||||
|
||||
### Изведени стойности: гейт режимите `pr` и `release`
|
||||
|
||||
@@ -189,10 +191,10 @@ CLI изисква `--evidence-root` да провери запазените д
|
||||
|
||||
| Режим | Проваля се | Има нужда от живи факти |
|
||||
| --------- | --------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | ----------------------- |
|
||||
| `release` | Всяка проверка, стриктно равенство спрямо фактите, събрани от дървото (поведението, което порталът винаги е имал): остарял брой, версия, етаж на покритие или SVG номер е STRICT дрейф | да |
|
||||
| `release` | Всяка проверка, стриктно равенство спрямо фактите, събрани от дървото (поведението, което портата винаги е имала): остарял брой, версия, етаж на покритие или SVG номер е STRICT дрейф | да |
|
||||
| `pr` | Само това, което направи промяната, се различава спрямо базата PR със същите инструменти за извличане на искания: (1) управлявана стойност, която не съществува в базата за тази проверка и файл ("PR редактира управляван номер — възстанови реда към основния текст"); (2) задължителен иск основата носеше и главата беше изгубена. Инвариантите на съдържанието, които не се нуждаят от факти, работят като в режим на освобождаване; проверките само за освобождаване са изброени и пропуснати | не |
|
||||
|
||||
Файловете с инструкции на агента носят** не** производен брой изобщо: `AGENTS.md`, `llm.txt` (и неговите `docs/i18n/*/llm.txt` копия), bs `AGENTS.md` fork, `open-sse/services/AGENTS.md`, `src/shared/constants/agentSkills.ts`, `skills/README.md` и всеки `skills/*/SKILL.md` сочи към източника (например `ROUTING_STRATEGY_VALUES` в `src/shared/constants/routingStrategies.ts`) и към `npm run facts` вместо това. Инвариантът „Няма извлечени преброявания (файл с инструкции за агент …)“ не успява да преброи там (доставчици, миграции, инструменти и обхвати MCP, стратегии за маршрутизиране, фактори за оценяване, пакети на режими) и в двата режима, така че опресняването на изданието никога не трябва да пренаписва файл с инструкции.
|
||||
Файловете с инструкции на агента носят** не** производен брой изобщо: `AGENTS.md`, `llm.txt` (и неговите `docs/i18n/*/llm.txt` копия), bs `AGENTS.md` fork, `open-sse/services/AGENTS.md`, `src/shared/constants/agentSkills.ts`, `skills/README.md` и всеки `skills/*/SKILL.md` сочат към източника (например `ROUTING_STRATEGY_VALUES` в `src/shared/constants/routingStrategies.ts`) и към `npm run facts` вместо това. Инвариантът „Няма извлечени преброявания (файл с инструкции за агент …)“ не успява да преброи там (доставчици, миграции, MCP инструменти и обхвати, стратегии за маршрутизиране, точкуващи фактори, режимни пакети) и в двата режима, така че опресняването на изданието никога не трябва да пренаписва файл с инструкции.
|
||||
|
||||
В режим `pr` клоновете на писателя могат да редактират управлявани стойности: `chore/derived-*` (нощното опресняване PR), `release/v*` и вълните на транслация `docs/i18n-*` и `chore/i18n-*` (`scripts/check/lib/derivedClaimsDiff.mjs`). Пакетите от опашки (`merge_group`, Mergify чернови, `omni-queue/**`) не се оценяват отново: те сумират PRs вече преценения порт един по един.
|
||||
|
||||
@@ -241,21 +243,21 @@ npm run release:refresh-derived -- --check # what the rele
|
||||
|
||||
**Два режима (от 2026-11-13).** Функция PR добавя или пренаписва ключове в `en.json` (и `bin/cli/locales/en.json`) и не засяга друг локал; `check:pr-derived-paths` (job `pr-test-policy`, семейство `config/quality/derived-paths/translation.json`) не работи функция PR която го прави. Другите локали се допълват веднъж на издание от `release:refresh-derived`, който извиква `syncUiKeys()` в `scripts/i18n/sync-ui-keys.mjs` (добавяне на липсващи ключове, премахване на изпуснати, маркиране на преводи на пренаписан английски с `rewrittenSinceRef`, превод), или от вълна за превод. Портите четат режима от `scripts/check/lib/gateMode.mjs`: в режим `pr` (функция PRs, `merge_group`, `omni-queue/**`) портите за режим на освобождаване отгоре отпечатват `SKIP reason=pr-mode` и излизат 0; в режим `release` (версията PR, натиска към `main`, `workflow_dispatch`, локално изпълнение) те са стриктни както преди, а при версията PR тези, които са наясно с diff, получават `BASE_REF=origin/main`, така че преценяват всеки ключ, добавен или пренаписан от цикъла. Визуализирайте локално присъдата за функцията PR с `--mode=pr`.
|
||||
|
||||
PR, който все още променя локалните каталози в `pr` режим (вълна за превод, опресняване на версията, корекция само за превод), не се пропуска: `check-key-completeness` преценява всеки каталог, който е променил, спрямо същия каталог в базата за сливане (`scripts/i18n/lib/touched-catalogs.mjs`) и се проваля на ключ, който каталогът е изгубил, ключ, който липсва на `en.json`, истински превод, превърнат в `__MISSING__:` маркер или в английския текст, или стойност, която вече не интерполира placeholders/tags от английски низ, който PR не докосна. Нов каталог в PR трябва да съдържа целия комплект `en.json` ключове. Това обхваща, за каталозите, които PR докосва, какво ще видят съотношението и портите за CLI-паритет.
|
||||
PR, който все още променя локалните каталози в режим `pr` (вълна за превод, опресняване на версията, корекция само за превод), не се пропуска: `check-key-completeness` преценява всеки каталог, който е променил, спрямо същия каталог в базата за сливане (`scripts/i18n/lib/touched-catalogs.mjs`) и се проваля на ключ, който каталогът е изгубил, ключ, който липсва на `en.json`, истински превод, превърнат в `__MISSING__:` маркер или в английския текст, или стойност, която вече не интерполира placeholders/tags от английски низ, който PR не докосна. Нов каталог в PR трябва да съдържа целия комплект `en.json` ключове. Това обхваща, за каталозите, които PR докосва, какво ще видят съотношението и портите за CLI-паритет.
|
||||
|
||||
Единичните тестове за локален паритет (`cli-i18n-catalog`, `i18n-pt-br`, `i18n-vi-completeness`, `i18n-placeholder-parity`) следват същите режими през `tests/_helpers/localeParityMode.ts`: в режим `pr` те пропускат твърденията за паритет на ключове и оставят на изданието да обновят паритета на заместителя на ключовете, чийто английски се е променил след базата за сливане (всеки ключ, когато плитката проверка на заданието за единичен тест не може да го прочете). Този помощник е** само** санкциониран режим-условно пропускане: `check:test-masking` брои `.skip(` и `{ skip: true }`, но не и изчисления `{ skip: "<reason>" }` който връща, така че `tests/unit/locale-parity-mode.test.ts` закрепва списъка с тестове, на които е разрешено да го използват. — добавянето на един е прегледана редакция към този списък.
|
||||
Единичните тестове за паритет на локал (`cli-i18n-catalog`, `i18n-pt-br`, `i18n-vi-completeness`, `i18n-placeholder-parity`) следват същите режими през `tests/_helpers/localeParityMode.ts`: в режим `pr` те пропускат твърденията за паритет на ключове и оставят на изданието да обновят паритета на заместителя на ключове, чийто английски език се е променил след базата за сливане (всеки ключ, когато плитката проверка на заданието за единичен тест не може да го прочете). Този помощник е** само** санкциониран режим-условно пропускане: `check:test-masking` брои `.skip(` и `{ skip: true }`, но не и изчисления `{ skip: "<reason>" }` който връща, така че `tests/unit/locale-parity-mode.test.ts` закрепва списъка с тестове, на които е позволено да го използва — добавянето на един е прегледана редакция към този списък.
|
||||
|
||||
#### `check-ui-value-drift` — порта за остарял превод
|
||||
|
||||
Улавя една i18n регресия, която другите порти структурно не могат да видят: английска стойност се пренаписва и преводите, получени от _предишния_ английски остават назад, така че неанглийските потребители продължават да четат уверено формулирано, сега грешно копие.
|
||||
|
||||
Това е изпратено наистина. `oauthModal.googleOAuthWarning` беше пренаписан, когато помощникът за влизане в Antigravity се приземи (#5203);** 39 от 43 локализации** запазен текст, казващ на операторите да „копират пълния URL и да го поставят по-долу“ — поток, който не може да завърши за този доставчик. Остана незабелязано до #8463 защото:
|
||||
Това е изпратено наистина. `oauthModal.googleOAuthWarning` беше пренаписан, когато Antigravity помощникът за влизане се приземи (#5203);** 39 от 43 локализации** запазен текст, казващ на операторите да „копират пълния URL и да го поставят по-долу“ — поток, който не може да завърши за този доставчик. Остана незабелязано до #8463 защото:
|
||||
|
||||
- `sync-ui-keys` запълва само ключове, които са** отсъстващ** , никога такива, които са** остаряла** ;
|
||||
- `check-ui-keys-coverage` отчита _присъствие_ на ключ, така че остарелият превод се оценява като покрит;
|
||||
- `check-ui-keys-coverage` отчита _присъствието_ на ключ, така че остарелият превод се оценява като покрит;
|
||||
- `check-translation-drift` проследява `docs/i18n/<locale>/**.md` документацията, отразява — никога не чете `src/i18n/messages/*.json`. Изпълнява се в задание `docs-sync-strict`: съветник за PRs, строг при натискане и всяка нощ; преводната вълна опреснява огледалата, а не функцията PR.
|
||||
|
||||
**Съобразен с разликите, без поддръжка на базовата линия.** Той сравнява `en.json` в основата на сливане с работното дърво; за всеки ключ, чиято английска стойност се промени, всеки локал, който все още съдържа недокоснат превод, е остарял. Това умишлено** замразява вече съществуващ дълг** — a diff не може да разкрие от кой стар английски идва дългогодишен превод, така че портата преценява само какво засяга текущата промяна. Алтернативата (базова хеш линия за ключ) би струвала ~ 600 KB генериран файл, 3 × най-голямата съществуваща базова линия, разбиване на всеки i18n PR.
|
||||
**Съобразен с разликите, не е подкрепен от базовата линия.** Той сравнява `en.json` в основата на сливане с работното дърво; за всеки ключ, чиято английска стойност се промени, всеки локал, който все още съдържа недокоснат превод, е остарял. Това умишлено** замразява вече съществуващ дълг** — a diff не може да разкрие от кой стар английски идва дългогодишен превод, така че портата преценява само какво засяга текущата промяна. Алтернативата (базова хеш линия за ключ) би струвала ~ 600 KB генериран файл, 3 × най-голямата съществуваща базова линия, разбиване на всеки i18n PR.
|
||||
|
||||
Два начина да го задоволите:
|
||||
|
||||
@@ -270,11 +272,11 @@ npm run i18n:check-value-drift:warn # report only
|
||||
BASE_REF=origin/release/vX.Y.Z npm run i18n:check-value-drift
|
||||
```
|
||||
|
||||
Излиза от 0 с `SKIP reason=base-unresolved` когато основният каталог не може да бъде прочетен (плитък клонинг без основната реф), отразявайки `check-openapi-breaking`. Само режим на освобождаване: функция PR пренаписва английския и спира дотук; опресняването на изданието маркира преводите, които е оставило (`node scripts/i18n/sync-ui-keys.mjs --rewritten-since=<ref>`, същото `findStaleTranslations`).
|
||||
Излиза от 0 с `SKIP reason=base-unresolved` когато основният каталог не може да бъде прочетен (плитък клонинг без базовата реф), отразявайки `check-openapi-breaking`. Само режим на освобождаване: функция PR пренаписва английския и спира дотук; опресняването на изданието маркира преводите, които е оставило (`node scripts/i18n/sync-ui-keys.mjs --rewritten-since=<ref>`, същото `findStaleTranslations`).
|
||||
|
||||
### Работа: `i18n`
|
||||
|
||||
Пълна i18n матрица за валидиране (едно задание на локал). Цялата работа е консултативна.
|
||||
Пълна матрица за валидиране на i18n (едно задание на локал). Цялата работа е консултативна.
|
||||
|
||||
| Скрипт | Валидира | Блокиране |
|
||||
| ------------------------------- | --------------------------------- | -------------------------------------------------------------- |
|
||||
@@ -294,10 +296,10 @@ BASE_REF=origin/release/vX.Y.Z npm run i18n:check-value-drift
|
||||
|
||||
Изпълнява се след `build`. Блоковете се сливат при повреда.
|
||||
|
||||
| Апартамент | Валидира | Блокиране |
|
||||
| ---------------- | ------------------------------------------------------------ | ---------------------------------------------------------------------------------------------------------------- |
|
||||
| `test:vitest` | MCP сървър (110 инструмента), autoCombo, кеш — vitest runner | да |
|
||||
| `test:vitest:ui` | UI компонент тества — vitest runner | **Блокиране** — съществуващите повреди са изрично изключени в `vitest.config.ts`; нови провали провалят работата |
|
||||
| Апартамент | Валидира | Блокиране |
|
||||
| ---------------- | ------------------------------------------------------------ | ------------------------------------------------------------------------------------------------------------------ |
|
||||
| `test:vitest` | MCP сървър (110 инструмента), autoCombo, кеш — vitest runner | да |
|
||||
| `test:vitest:ui` | UI компонент тества — vitest runner | **Блокиране** — съществуващите повреди са изрично изключени в `vitest.config.ts`; новите провали провалят работата |
|
||||
|
||||
### Нощни работни процеси (планирани, консултативни)
|
||||
|
||||
|
||||
@@ -4,14 +4,9 @@
|
||||
|
||||
---
|
||||
|
||||
OmniRoute използва модел за издания с **паралелни цикли**: специален клон `release/vX.Y.Z`
|
||||
за активния цикъл, `main` за публикуваната линия и неизменяем таг
|
||||
`vX.Y.Z` при публикуването на съответния цикъл. Нормално е комити да попадат както в `release/*`, _така и_ в
|
||||
`main` — това не е грешка.
|
||||
OmniRoute използва a** паралелен цикъл** модел на освобождаване: специален `release/vX.Y.Z` клон за активния цикъл, `main` за публикувания ред и неизменен `vX.Y.Z` етикет, когато този цикъл бъде изпратен. Виждайки, че ангажиментите кацат на `release/*` _и_ на `main` се очаква — а не объркване.
|
||||
|
||||
Подробностите за поддържащите проекта се намират в `CLAUDE.md` (Строго правило №21) и
|
||||
[RELEASE_CHECKLIST.md](./RELEASE_CHECKLIST.md). Тази страница представлява публичното
|
||||
обобщение за сътрудниците.
|
||||
Подробностите за поддържащия се намират в `CLAUDE.md` (Hard Rule #21) и [RELEASE_CHECKLIST.md](./RELEASE_CHECKLIST.md). Тази страница е обобщението за публичните сътрудници.
|
||||
|
||||
## Накратко
|
||||
|
||||
@@ -42,25 +37,23 @@ flowchart LR
|
||||
`main` не е клонът за ежедневна интеграция. PR-ите, отворени към `main`,
|
||||
обикновено трябва да бъдат пренасочени преди сливане.
|
||||
|
||||
## Замразяване на издание (паралелни цикли)
|
||||
## Освобождаване на замразяване (паралелни цикли)
|
||||
|
||||
Когато се извършва съгласуване на дадено издание, се отваря маркерен issue с етикет `release-freeze`.
|
||||
Това **не спира разработката**:
|
||||
Когато дадено издание се съгласува, се отваря проблем с маркер, обозначен като `release-freeze`. това** не спира развитието** :
|
||||
|
||||
- Замразеният `release/vX.Y.Z` е под контрола на отговорника за съответното издание.
|
||||
- `release/vX+1` за следващия цикъл се създава от замразения връх, за да могат сътрудниците да продължат
|
||||
да добавят промени.
|
||||
- Отворените PR-и, които все още са насочени към замразения клон, трябва да бъдат **пренасочени** към
|
||||
активния клон `release/v*` с най-висока версия.
|
||||
- Замразеният `release/vX.Y.Z` принадлежи на капитана за освобождаване на този кораб.
|
||||
- `release/vX+1` на следващия цикъл се изрязва от замразения връх, така че участниците да продължат да работят.
|
||||
- Трябва да се отвори PRs, който все още е насочен към замразения клон** пренасочени** към активния (най-висок) `release/v*` клон.
|
||||
|
||||
Проверете за активно замразяване, преди да приемете, че желаният от вас клон може да бъде сливан:
|
||||
Проверете за отворено замразяване, преди да приемете, че клонът, който искате, може да се слее:
|
||||
|
||||
```bash
|
||||
gh issue list --repo diegosouzapw/OmniRoute --label release-freeze --state open
|
||||
```
|
||||
|
||||
Механизмът за сливане (етикет `queue` от собственика → Mergify) е документиран в
|
||||
[MERGE_TRAIN.md](./MERGE_TRAIN.md).
|
||||
Механиката на сливане (собственик `queue` етикет → Mergify) е документирана в [MERGE_TRAIN.md](./MERGE_TRAIN.md).
|
||||
|
||||
> **2026-11-19: опашката за сливане на Mergify е оттеглена** (решение на собственика). `.mergify.yml` вече не дефинира опашка и отказва командите Mergify, които обединяват или пренаписват заявка за изтегляне. Изданието PRs се обединява на ръка под набора от правила на хранилището „Изискване на зелени порти при активното издание“ (`Gate / CI` + `Gate / Quality`), докато omni-queue работи в режим на живо и през omni-queue след това ( [OMNI_QUEUE.md](./OMNI_QUEUE.md) ). Етикетът `queue` вече не обединява нищо.
|
||||
|
||||
## Защо има и клон, и таг?
|
||||
|
||||
|
||||
@@ -4,10 +4,9 @@
|
||||
|
||||
---
|
||||
|
||||
От v3.8.49 (WS3.2/WS3.4 от плана за качество/скорост) пътят по подразбиране за сливане на
|
||||
прегледани PR-и в `release/vX.Y.Z` е **опашката за сливане на Mergify** (`.mergify.yml`);
|
||||
документираният по-долу **ръчен влак за сливания** е РЕЗЕРВНИЯТ ВАРИАНТ — използван при инциденти,
|
||||
замразяване на издания или ако планът Mergify Open Source някога се промени.
|
||||
> **2026-11-19: опашката за сливане на Mergify е оттеглена** (решение на собственика). `.mergify.yml` вече не дефинира опашка и отказва командите Mergify, които обединяват или пренаписват заявка за изтегляне. Изданието PRs се обединява на ръка под набора от правила на хранилището „Изискване на зелени порти при активното издание“ (`Gate / CI` + `Gate / Quality`), докато omni-queue работи в режим на живо и през omni-queue след това ( [OMNI_QUEUE.md](./OMNI_QUEUE.md) ). Секциите Mergify по-долу описват опашката такава, каквато беше.
|
||||
|
||||
От v3.8.49 (WS3.2/WS3.4 на плана quality/velocity ) пътят за сливане по подразбиране за прегледани PRs в `release/vX.Y.Z` е** Mergify опашка за сливане** (`.mergify.yml`); на** ръчен влак за сливане** документиран по-долу е FALLBACK — използван по време на инциденти, замръзване на издания или ако планът Mergify Open Source някога се промени.
|
||||
|
||||
## Път по подразбиране: опашката на Mergify
|
||||
|
||||
|
||||
@@ -355,111 +355,70 @@ npm run build:release
|
||||
|
||||
---
|
||||
|
||||
## Отделяне на 3.9.0 LTS (репетирано в 3.8.58)
|
||||
## 3.9.0 LTS cut (репетирано в 3.8.58)
|
||||
|
||||
След v3.8.59 следващата версия е 3.9.0, а върхът ѝ става основа на два дългосрочни клона:
|
||||
`stable/v3` (линията v3 LTS, npm `latest`) и `develop` (v4, повишена до 4.0.0, npm
|
||||
`nightly`). Моделът на клоновете/каналите, пренасянето напред и етикетите са описани в
|
||||
[RELEASE_STRATEGY.md](./RELEASE_STRATEGY.md); планът е в [ROADMAP](../../ROADMAP.md) (Фаза 3). Отделянето се изпълнява веднъж;
|
||||
3.8.58 го репетира от начало до край във fork, а 3.8.59 завършва с
|
||||
[контролния списък GO/NO-GO](./LTS_GO_NO_GO.md).
|
||||
След v3.8.59 следващата версия е 3.9.0 и нейният връх се превръща в два дълготрайни клона: `stable/v3` (линията v3 LTS, npm `latest`) и `develop` (v4, увеличен до 4.0.0, npm `nightly`). branch/channel моделът, пренасочващият порт и етикетите са в [RELEASE_STRATEGY.md](./RELEASE_STRATEGY.md) ; планът е в [ROADMAP](../../ROADMAP.md) (Фаза 3). Разрезът се изпълнява веднъж; 3.8.58 го репетира от край до край на вилица, а 3.8.59 затваря с [GO/NO-GO контролния списък](./LTS_GO_NO_GO.md).
|
||||
|
||||
### Пробно изпълнение (само за четене, безопасно по всяко време)
|
||||
### Суха работа (само за четене, безопасно по всяко време)
|
||||
|
||||
```bash
|
||||
npm run release:dry-run-lts-cut # реалното отделяне: 3.9.0 от HEAD, предишен таг v3.8.59
|
||||
npm run release:dry-run-lts-cut -- --from <3.9.0-tip> # фиксиране на изходния commit
|
||||
npm run release:dry-run-lts-cut # the real cut: 3.9.0 from HEAD, previous tag v3.8.59
|
||||
npm run release:dry-run-lts-cut -- --from <3.9.0-tip> # pin the source commit
|
||||
```
|
||||
|
||||
`scripts/release/dry-run-lts-cut.mjs` не изпълнява нищо: той чете git и `gh` и извежда
|
||||
цялата последователност — предварителните условия (източникът се намира, изходното хранилище има пълна история —
|
||||
shallow clone не може да изпрати `stable/v3`, приемащата страна отхвърля пакета при първия
|
||||
присаден родител, затова първо извършете отделянето от пълен clone или изпълнете `git fetch --unshallow origin` —
|
||||
предишният таг съществува, `package.json` съдържа целевата версия, отворен е issue с `release-freeze`, няма отворен
|
||||
issue с `Release branch not green`
|
||||
за съществуващ release клон — несъществуващ клон се отчита като `?` неизвестен, никога
|
||||
като зелен — опашката `release` на Mergify е конфигурирана (G11: `queue_rules`, `checks_timeout`,
|
||||
етикет `queue`), наборът от правила за `release/*` все още блокира изтриването и принудителното изпращане, а
|
||||
`stable/v3` и `develop` все още не съществуват), двете стъпки за клоновете, кои тригери на
|
||||
неактивни workflow-и и условия `if:` стават истина (и кои остават блокирани от променлива на хранилището или
|
||||
фиксирани към каноничното хранилище), очакваните dist-tag-ове (`latest` → 3.9.0, `next` и
|
||||
`nightly` са празни) и връщането назад. Изходен код `0` = `RESULT: READY`, `1` = неизпълнено блокиращо предварително
|
||||
условие (`✗`), `2` = грешка при употреба. `--advisory <id,...>` понижава проверка до предупреждение (`!`),
|
||||
без да я скрива.
|
||||
`scripts/release/dry-run-lts-cut.mjs` не изпълнява нищо: чете git и `gh` и отпечатва цялата последователност — предварителни условия (източник разрешава, хранилището на източника има пълна история — плитък клонинг не може да избута `stable/v3`, приемащата страна отхвърля пакета при първия присаден родител, така че изрежете от пълен клонинг или `git fetch --unshallow origin` съществува първи — предишен етикет, `package.json` е целевата версия, `release-freeze` проблем е отворен, няма отворен `Release branch not green` проблем на съществуващ клон на изданието — клон, който не съществува, докладва `?` неизвестно, никога зелено — omni-queue приземява изданието PRs (G11: `config/merge-queue/config.json` валиден, неговият `bases` управлява клона на изданието, `mode` `live`, етикетът му съществува), `release/*` наборът от правила все още блокира изтриването и принудителното натискане, а `stable/v3` и `develop` все още не съществуват), двете стъпки на клона, които задействанията на пасивния работен поток и условията `if:` се превръщат в истина (и които остават затворени от променлива на хранилището или фиксирани към каноничното хранилище), очакваните dist-тагове (`latest` → 3.9.0, `next` и `nightly` празни) и връщането назад. Излезте `0` = `RESULT: READY`, `1` = неуспешно предварително условие за блокиране (`✗`), грешка при използване на `2` =. `--advisory <id,...>` понижава проверката до предупреждение (`!`), без да я крие.
|
||||
|
||||
Изпълнете пробното изпълнение на реалното отделяне, докато замразяването на release-а за 3.9.0 все още е активно — клоновете се
|
||||
създават след тага и преди Фаза 12c да отмени замразяването.
|
||||
Изпълнете сухото изпълнение на истинското изрязване, докато замразяването на версията 3.9.0 все още е отворено — разклоненията се създават след етикета и преди фаза 12c да премахне замразяването.
|
||||
|
||||
### Репетиция с 3.8.58 (само във fork)
|
||||
### 3.8.58 репетиция (само вилица)
|
||||
|
||||
```bash
|
||||
# 1. Пробно изпълнение върху текущия връх с параметри за репетицията
|
||||
# 1. Dry-run on the current tip with rehearsal parameters
|
||||
npm run release:dry-run-lts-cut -- --target-version 3.8.58 --previous-tag v3.8.57 \
|
||||
--advisory freeze,base-green
|
||||
|
||||
# 2. Изпълнение спрямо отдалечен FORK (origin или всеки remote, чийто URL е на каноничното
|
||||
# хранилище, се отказва; всяка стъпка изисква потвърждение в терминала)
|
||||
# 2. Execute against a FORK remote (origin, or any remote whose URL is the canonical
|
||||
# repository, is refused; every step asks for confirmation on the terminal)
|
||||
git remote add rehearsal https://github.com/<you>/OmniRoute.git
|
||||
node scripts/release/dry-run-lts-cut.mjs --execute --remote rehearsal \
|
||||
--target-version 3.8.58 --previous-tag v3.8.57 --advisory freeze,base-green
|
||||
|
||||
# 3. Изпробване на неактивните workflow-и във fork-а (workflow_dispatch там, където пробното изпълнение
|
||||
# отчита фиксиране към каноничното хранилище), след което връщане назад
|
||||
# 3. Exercise the dormant workflows in the fork (workflow_dispatch where the dry-run
|
||||
# reports a canonical-repository pin), then roll back
|
||||
node scripts/release/dry-run-lts-cut.mjs --execute --rollback --remote rehearsal \
|
||||
--target-version 3.8.58 --previous-tag v3.8.57 --advisory freeze,base-green
|
||||
```
|
||||
|
||||
Commit-ът за повишаване на `develop` се създава чрез git plumbing (работното дърво не се засяга) и повишава
|
||||
същите пет файла като commit за отваряне на цикъл: `package.json`, `open-sse/package.json`,
|
||||
`electron/package.json`, `package-lock.json` и `docs/openapi.yaml`. Секцията `[4.0.0]` в
|
||||
CHANGELOG и нейните i18n копия се отварят впоследствие в `develop`, преди първия му
|
||||
PR. Скриптът никога не променя npm dist-tag-ове — репетирайте ги с тестов пакет.
|
||||
Комитът за разработка на бум е изграден с git plumbing (не се докосва работещо дърво) и сблъсква същите пет файла като комит за отваряне на цикъл: `package.json`, `open-sse/package.json`, `electron/package.json`, `package-lock.json` и `docs/openapi.yaml`. Разделът `[4.0.0]` CHANGELOG и неговите i18n огледала се отварят на `develop` след това, преди първия му PR. Скриптът никога не променя npm dist-tags — rehearse тези на скреч пакет.
|
||||
|
||||
### Артефакт за предварителен преглед на PR (изграждане веднъж, повишаване на същите байтове)
|
||||
### PR артефакт за предварителен преглед (изграждане веднъж, насърчаване на същите байтове)
|
||||
|
||||
`.github/workflows/preview-artifact.yml` изгражда един production tarball от върха на PR и
|
||||
валидира точно тази компилация (част (a) от #8084). Само за PR-и от същото хранилище; нищо не се публикува.
|
||||
`.github/workflows/preview-artifact.yml` изгражда един производствен архив от PR глава и валидира тази точна компилация (#8084 срез (a)). Същото хранилище само PRs ; нищо не се публикува.
|
||||
|
||||
```bash
|
||||
gh workflow run preview-artifact.yml -f pr_number=<N> # или добавете етикета `preview-artifact`
|
||||
gh workflow run preview-artifact.yml -f pr_number=<N> # or add the `preview-artifact` label
|
||||
gh run download <run-id> --name preview-artifact-pr<N>-<sha7> --dir preview
|
||||
cd preview && sha256sum -c SHA256SUMS
|
||||
gh attestation verify omniroute-*.tgz --repo diegosouzapw/OmniRoute
|
||||
npm install -g ./omniroute-*.tgz # инсталиране на предварителния преглед
|
||||
npm install -g ./omniroute-*.tgz # preview install
|
||||
```
|
||||
|
||||
Изпълнението стартира `npm ci`, `npm run build:release`, `npm run check:pack-artifact`, пакетира
|
||||
tarball-а, стартира `npm run check:pack-boot` (фиктивни тайни, временна директория за данни), пакетира отново и
|
||||
се проваля, освен ако digest-ът не е идентичен, след което записва `artifact-identity.json` (SHA на върха, SHA на основата,
|
||||
hash на lockfile-а, платформа, архитектура, node ABI, bundler, политика за компилация —
|
||||
`scripts/release/artifact-identity.mjs`) и атестира tarball-а в отделен job. Повишаването
|
||||
на предварителен преглед означава инсталиране на този tarball: никога не изграждайте повторно от изходния код.
|
||||
Изпълнението прави `npm ci`, `npm run build:release`, `npm run check:pack-artifact`, пакетира tarball, изпълнява `npm run check:pack-boot` (фалшиви тайни, ефимерна директория на данни), повторно пакетира и се проваля, освен ако дайджестът не е идентичен, след това записва `artifact-identity.json` (глава SHA, база SHA, хеш на заключващ файл, платформа, арка, възел ABI, пакет, политика за изграждане — `scripts/release/artifact-identity.mjs`) и удостоверява tarball в отделна работа. Насърчаването на предварителен преглед означава инсталиране на този tarball: никога не изграждайте отново от източника.
|
||||
|
||||
### Отделянето (3.9.0, след GO)
|
||||
### Изрязването (3.9.0, след GO)
|
||||
|
||||
1. GO е записано в [LTS_GO_NO_GO.md](./LTS_GO_NO_GO.md).
|
||||
2. `npm run release:dry-run-lts-cut -- --from v3.9.0` извежда `RESULT: READY`.
|
||||
3. Създайте клоновете ръчно в `origin` с командите, изведени от пробното изпълнение —
|
||||
скриптът отказва да изпраща към `origin`. За да използвате повторно прегледан commit за `develop`, първо изпълнете
|
||||
репетицията с `--execute` върху върха на 3.9.0 спрямо своя fork; тя извежда и двата SHA, а
|
||||
същите commit-и могат да бъдат изпратени:
|
||||
1. GO записано в [LTS_GO_NO_GO.md](./LTS_GO_NO_GO.md).
|
||||
2. `npm run release:dry-run-lts-cut -- --from v3.9.0` отпечатва `RESULT: READY`.
|
||||
3. Създайте разклоненията на `origin` на ръка с командите, които се отпечатват на сухо — скриптът отказва да натисне `origin`. За да използвате повторно прегледан ангажимент за разработка, първо изпълнете `--execute` репетицията на върха 3.9.0 срещу вашата вилица; той отпечатва както SHAs, така и същите ангажименти могат да бъдат насочени:
|
||||
|
||||
```bash
|
||||
git push origin <stable-sha>:refs/heads/stable/v3 <develop-sha>:refs/heads/develop
|
||||
```
|
||||
|
||||
4. Защитете `stable/v3` и `develop` (набори от правила + опашка за сливане), преди да бъде приета първата PR.
|
||||
5. Неактивните работни процеси се включват при съществуване на съответния клон: `forward-port.yml` (push към
|
||||
`stable/v3`), `validate-stable-pr.yml` (PR-и към `stable/v3`) и `nightly-v4-build.yml`
|
||||
(компилира `develop`). Преди пускането задайте тайната `secrets.FORWARD_PORT_TOKEN` на хранилището (така че CI да се изпълнява при
|
||||
PR-и за пренасяне напред); нощното публикуване остава изключено, докато собственикът не зададе променливата на хранилището
|
||||
`vars.NIGHTLY_PUBLISH` на `true` и npm Trusted Publishing не приеме
|
||||
`nightly-v4-build.yml`. Определянето на канала се извършва от `scripts/release/dist-tag.mjs` — същата
|
||||
логика за определяне, която използва `npm-publish.yml`.
|
||||
6. Проверете каналите: `npm view omniroute dist-tags --json` показва `latest` = 3.9.0 и липса на
|
||||
`next` / `nightly`, докато не бъде публикувана v4.
|
||||
7. Връщане назад, ако е необходимо: `git push origin --delete refs/heads/stable/v3 refs/heads/develop`
|
||||
и `npm dist-tag add omniroute@3.8.59 latest`.
|
||||
4. Защитете `stable/v3` и `develop` (опашка за сливане на набори от правила + ) преди първият PR да се приземи.
|
||||
5. Спящите работни потоци се включват от съществуването на клон: `forward-port.yml` (натискане към `stable/v3`), `validate-stable-pr.yml` (PRs към `stable/v3`) и `nightly-v4-build.yml` (изгражда `develop`). Преди да стартирате на живо, задайте тайната на `secrets.FORWARD_PORT_TOKEN` хранилището (така че CI да работи на преден порт PRs); нощното публикуване остава изключено, докато собственикът не зададе променливата на хранилището `vars.NIGHTLY_PUBLISH` на `true` и npm Trusted Publishing приеме `nightly-v4-build.yml`. Разделителната способност на канала е `scripts/release/dist-tag.mjs`, същият резолвер, който `npm-publish.yml` използва.
|
||||
6. Проверете каналите: `npm view omniroute dist-tags --json` показва `latest` = 3.9.0 и няма `next` / `nightly`, докато v4 не бъде публикувано.
|
||||
7. Връщане, ако е необходимо: `git push origin --delete refs/heads/stable/v3 refs/heads/develop` и `npm dist-tag add omniroute@3.8.59 latest`.
|
||||
|
||||
---
|
||||
|
||||
|
||||
@@ -137,36 +137,22 @@ CPU без прикачена задача. Всеки unit на OmniRoute съ
|
||||
минути на tmpfs и се качваше от диска за 2 минути.
|
||||
- VPS машината `.15` е само за homologation — на нея никога не се изпълняват CI runner-и.
|
||||
|
||||
## Хостван канал (изпълнители, хоствани от GitHub)
|
||||
## Хоствана лента (хоствани от GitHub бегачи)
|
||||
|
||||
Хранилището принадлежи на организацията `cheaper-inference`, на план **Team**: **60
|
||||
едновременно изпълнявани хоствани задачи**, споделени от всички хранилища в организацията, всички проверки на PR,
|
||||
всички работни процеси, задействани при push, и конфигурацията по подразбиране на CodeQL. Данните по-долу са измерени на
|
||||
план **Pro** (40 едновременно изпълнявани хоствани задачи). Измерено на 2026-10-18 по време на
|
||||
кампания за сливане (~10 сливания/час в `release/v3.8.52`): **2 500 изпълнения на работни процеси, създадени за
|
||||
24 ч.**, 44 push операции към клона за 6 ч., **106 хоствани задачи на опашка**, докато проверките на PR чакаха с
|
||||
часове, а PR бяха сливани без тях. При всяка push операция към клона се задействаха девет работни процеса:
|
||||
Хранилището принадлежи на организацията `cheaper-inference`, на** Екип** план:** 60 едновременно хоствани работни места** , споделено от всяко хранилище в организацията, всяка проверка PR, всеки работен процес, задействан чрез натискане, и настройката по подразбиране на CodeQL. Цифрите по-долу са измерени на** Професионалист** план (40 едновременно хоствани работни места). Измерено на 2026-10-18 по време на кампания за сливане (~ 10 merges/hour на `release/v3.8.52`):** 2500 стартирания на работния процес, създадени за 24 часа** , 44 натискания до клона за 6 часа,** 106 хоствани задания са на опашка** докато PR проверките чакаха с часове и PRs бяха обединени без тях. Девет работни потока, задействани при всяко натискане към клона:
|
||||
|
||||
| при всяка push операция към `release/v*` | хоствани задачи | резултат при претоварването | от 2026-10-18 |
|
||||
| -------------------------------------------------- | --------------: | ----------------------------------------------------------------------------- | ----------------------------------------------------------------------------- |
|
||||
| `ci.yml` (пълна матрица) | до 30 | отменен от следващата push операция, 24 от 24 за един ден | не се стартира при push към `release/**` (изпълнение за PR + Release-Green) |
|
||||
| `quality.yml` | ~6 | отменен, 23 от 23 | не се стартира при push към `release/**` |
|
||||
| `Release-Green` `--quick` | 0 | изпълняваше се на `omni-build`, отменени 97 от 100 | слот `omni-release`, никога не се отменя, чакащите изпълнения се обединяват |
|
||||
| `Lock released branch`, `OpenSSF Scorecard` | 2 | по едно изпълнение на опашка за всяка push операция | едно изпълнение за ref (`tests/unit/build/hosted-lane-concurrency.test.ts`) |
|
||||
| `Release acceptance` (паралелен отчет) | 1 | по едно хоствано `npm ci` за всяка push операция, без отмяна | без промяна — кандидат за филтър `paths:` |
|
||||
| `Publish to Docker Hub` → `Deploy to VPS` | 2 | отменен при всяка push операция; етапът amd64 се конкурира в `omni-build` | без промяна — каналът за внедряване на собственика |
|
||||
| конфигурация по подразбиране на CodeQL (`dynamic`) | 4 | `javascript-typescript`, `actions`, `c-cpp`, `python` при всяка push операция | без промяна — Settings → Code security; `c-cpp`/`python` не сканират нищо тук |
|
||||
| на натискане към `release/v*` | хоствани работни места | резултат под бурята | от 2026-10-18 |
|
||||
| -------------------------------------------- | ---------------------: | ------------------------------------------------------------------ | -------------------------------------------------------------------------------------- |
|
||||
| `ci.yml` (пълна матрица) | до 30 | анулирани от следващото натискане, 24 от 24 за един ден | не се стартира при натискане `release/**` (PR стартира + Release-Green) |
|
||||
| `quality.yml` | ~6 | отменен, 23 от 23 | не се стартира при натискане на `release/**` |
|
||||
| `Release-Green` `--quick` | 0 | работи на `omni-build`, анулира 97 от 100 | `omni-release` слот, никога не е отменен, чакащо изпълнение се срива |
|
||||
| `Lock released branch`, `OpenSSF Scorecard` | 2 | едно изпълнение на опашка на натискане | едно изпълнение на референтен съд (`tests/unit/build/hosted-lane-concurrency.test.ts`) |
|
||||
| `Release acceptance` (доклад в сянка) | 1 | един хостван `npm ci` на натискане, никога не се отменя | непроменен — кандидат за `paths:` филтър |
|
||||
| `Publish to Docker Hub` → `Deploy to VPS` | 2 | отменя се на натискане; amd64 крак се състезава на `omni-build` | непроменен канал за разгръщане на собственика на — |
|
||||
| CodeQL настройка по подразбиране (`dynamic`) | 4 | `javascript-typescript`, `actions`, `c-cpp`, `python` на натискане | непроменен — Настройки → Сигурност на кода; `c-cpp`/`python` сканира нищо тук |
|
||||
|
||||
`tests/unit/build/push-storm-diet.test.ts` фиксира задействането само при push към `main` за `ci.yml` и
|
||||
`quality.yml`. Страничен ефект: Codecov вече не получава базово качване при всяка push операция към release клон (стъпката
|
||||
е само информативна и е с `continue-on-error`); вградената в хранилището проверка на покритието и коментарът в PR
|
||||
не са засегнати.
|
||||
`tests/unit/build/push-storm-diet.test.ts` закрепва `main` -only push тригера на `ci.yml` и `quality.yml`. Страничен ефект: Codecov вече не получава базово качване на освобождаване (стъпката е информационна и `continue-on-error`); вратата за покритие в репо и PR коментарът не са засегнати.
|
||||
|
||||
**Повече собствен хостван капацитет не решава проблема с опашката за хоствани задачи.** Машината за разработка
|
||||
(`devbox-vm-06-dev002`, 24 vCPU / 54 GB) би могла да хоства изпълнител, но сесиите на агентите вече
|
||||
поддържат натоварването ѝ на ниво 20–26, контейнерът на агента няма Docker демон, а претовареният канал е
|
||||
хостваният. Машината `.113` разполагаше със 71 GB свободно пространство и натоварване 5–8 в същия момент; нейното ограничение
|
||||
е посоченият по-горе бюджет за памет на слушател (максимум 6 слушателя), а не процесорът. Оставащите възможности
|
||||
са свързани с процеса: PR от кампаниите да се сливат чрез опашката на Mergify (`label=queue`, пакетите споделят
|
||||
едно CI изпълнение на `merge_group` вместо по едно изпълнение за всеки PR плюс едно за всяка push операция), да се намалят езиците
|
||||
в конфигурацията по подразбиране на CodeQL и `release-acceptance.yml` да се филтрира според файловете, които чете.
|
||||
**Повече самостоятелно хостван капацитет не коригира хостваната опашка.** Devbox (`devbox-vm-06-dev002`, 24 vCPU / 54 GB) може да хоства бегач, но сесиите на агента вече поддържат натоварването си на 20–26, контейнерът на агента няма Docker демон и наситената лента е хостваната. Кутията `.113` имаше 71 GB свободни и зареди 5–8 в същия момент; ограничението му е бюджетът за памет на слушател по-горе (таван от 6 слушателя), а не CPU. Останалите лостове са процесни: приземете кампанията PRs през опашката Mergify (`label=queue`, партидите споделят едно изпълнение `merge_group` CI вместо едно изпълнение на PR плюс едно на натискане), изрежете езиците за настройка по подразбиране CodeQL и филтрирайте `release-acceptance.yml` по файловете, които чете.
|
||||
|
||||
> **2026-11-19: опашката за сливане на Mergify е оттеглена** (решение на собственика). `.mergify.yml` вече не дефинира опашка и отказва командите Mergify, които обединяват или пренаписват заявка за изтегляне. Изданието PRs се обединява на ръка под набора от правила на хранилището „Изискване на зелени порти при активното издание“ (`Gate / CI` + `Gate / Quality`), докато omni-queue работи в режим на живо и през omni-queue след това ( [OMNI_QUEUE.md](./OMNI_QUEUE.md) ). Лостът Mergify по-горе вече не съществува.
|
||||
|
||||
@@ -29,6 +29,8 @@ CI এবং কোয়ালিটি গেটস কর্মপ্রব
|
||||
|
||||
### সারি মার্জ করুন
|
||||
|
||||
> **2026-11-19: মার্জিফাই মার্জ কিউ অবসরপ্রাপ্ত** (মালিকের সিদ্ধান্ত)। `.mergify.yml` আর একটি সারি সংজ্ঞায়িত করে না এবং Mergify কমান্ডগুলিকে প্রত্যাখ্যান করে যা একটি পুল অনুরোধকে একত্রিত করে বা পুনর্লিখন করে। রিলিজ PRs রিপোজিটরি রুলসেট "সক্রিয় রিলিজে সবুজ গেটস প্রয়োজন" (`Gate / CI` + `Gate / Quality`) এর অধীনে হাত দ্বারা মার্জ করা হয় যতক্ষণ না ওমনি-কিউ লাইভ মোডে চলে এবং তার পরে ওমনি-কিউয়ের মাধ্যমে ( [OMNI_QUEUE.md](../ops/OMNI_QUEUE.md) )। নীচে বর্ণিত Mergify খসড়াগুলির কার্যপ্রবাহ পরিচালনা এখনও `ci.yml` এবং `quality.yml` এ রয়েছে, কিন্তু কোনও Mergify খসড়া আর খোলা হয়নি।
|
||||
|
||||
`queue` লেবেল Mergify কিউতে একটি PR পাঠায় (`.mergify.yml`)। Mergify একটি `mergify/merge-queue/` শাখায় একটি খসড়া PR খোলে, CI সেখানে সম্পূর্ণ নির্বাচন চালায়, এবং `Gate / CI`, `Gate / Quality` এবং `Merge integrity (changelog + generated skills)` পাস করলে আসল PR একত্রিত হয়।
|
||||
|
||||
Mergify খসড়ার বিবরণে তার সারির সারাংশ লিখে, এবং অন্যান্য অ্যাপগুলিও এটি সম্পাদনা করতে পারে। এই ধরনের একটি খসড়াতে একটি `pull_request` `edited` ইভেন্ট তার নিজস্ব সমবর্তী গোষ্ঠী (`-queue-edit-<run_id>`) নেয় তাই এটি খসড়াটির আসল রান বাতিল করতে পারে না এবং এটি গেট এবং ম্যাট্রিক্স এড়িয়ে যায়। শুধুমাত্র `Merge integrity` এখনও চলে। বাদ দেওয়া গেট কাজের একটি ভিন্ন চেকের নাম রয়েছে, কারণ Mergify একটি এড়িয়ে যাওয়া `Gate / CI` একটি ব্যর্থ চেক হিসাবে পড়ে এবং PR dequeues করে।
|
||||
@@ -45,9 +47,9 @@ Mergify খসড়ার বিবরণে তার সারির সা
|
||||
|
||||
সংস্করণযুক্ত npm-alias ইনভেন্টরি এবং স্ট্যাটিক-স্ক্যান সদস্যতা `config/quality/gate-manifest.json` তে লাইভ। স্ক্রিপ্টের নাম এবং `package.json` বিরুদ্ধে সঠিক কমান্ড যাচাই করতে `npm run check:gate-manifest` চালান; সংযোজন, অপসারণ এবং কমান্ড ড্রিফ্ট স্থানীয় হুক এবং CI এ পরিবর্তন-শ্রেণীবিভাগের কাজ উভয়ই ব্যর্থ করে। একটি উপনাম একটি ওয়ার্কফ্লো কাজ, ম্যাট্রিক্স উদাহরণ বা পরীক্ষার ক্ষেত্রে নয়: এই গণনাগুলিকে বিনিময়যোগ্য হিসাবে উপস্থাপন করা উচিত নয়৷
|
||||
|
||||
`npm run quality:scan -- --list` বা `npm run quality:scan:fast -- --list` ব্যবহার করে নির্বাচিত উপনামগুলি নির্বাহ না করেই পরিদর্শন করুন৷ রানার এনপিএম এন্ট্রিপয়েন্টকে আহ্বান করে, তাই এর রানটাইম (যেখানে কনফিগার করা Bun সহ) সংরক্ষিত থাকে। ম্যানিফেস্ট সেই প্রোফাইলগুলির বাইরের উপনামগুলিকে আলাদাভাবে আহ্বান করা হিসাবে রেকর্ড করে, এবং রক্ষণাবেক্ষণ আদেশগুলি শুধুমাত্র পঠনযোগ্য স্ক্যান প্রোফাইলগুলিতে নিষিদ্ধ৷
|
||||
`npm run quality:scan -- --list` বা `npm run quality:scan:fast -- --list` ব্যবহার করে নির্বাচিত উপনামগুলি কার্যকর না করেই পরিদর্শন করুন৷ রানার npm এন্ট্রিপয়েন্টকে আহ্বান করে, তাই এর রানটাইম (যেখানে কনফিগার করা Bun সহ) সংরক্ষিত থাকে। ম্যানিফেস্ট সেই প্রোফাইলগুলির বাইরের উপনামগুলিকে আলাদাভাবে আহ্বান করা হিসাবে রেকর্ড করে, এবং রক্ষণাবেক্ষণ আদেশগুলি শুধুমাত্র-পঠনযোগ্য স্ক্যান প্রোফাইলগুলিতে নিষিদ্ধ৷
|
||||
|
||||
এই প্রোফাইলগুলি শুধুমাত্র স্ট্যাটিক স্ক্যান কভার করে। তারা পণ্য পরীক্ষা, কভারেজ, প্যাকেজিং, বাহ্যিক চেক বা প্রার্থীর সম্পূর্ণ রিলিজ গ্রহণযোগ্যতা প্রত্যয়িত করে না। কর্মপ্রবাহ ভর্তি লিঙ্কযুক্ত `config/quality/admission-policy.json` এবং `scripts/quality/admission-verdict.mjs` ব্যবহার করে। রিলিজ-পর্যবেক্ষক প্রোফাইল আলাদা থাকে; তাদের প্রযোজ্য চেক এবং রসিদ স্বাধীনভাবে পরিদর্শন করুন। সম্পূর্ণ পর্যবেক্ষকের স্ট্যাটিক কমান্ড `config/quality/release-green-static-profile.json` এ ঘোষণা করা হয়, যার মধ্যে `audit:deps`, মিউটেশন-পরীক্ষা নির্বাচন এবং অনুবাদ পরীক্ষা। লোডার package.json এবং মডেল করা CI/Quality ঘোষণার বিরুদ্ধে npm কমান্ড যাচাই করে; এটি আর্গুমেন্ট হিসাবে শেল টোকেন কার্যকর করার পরিবর্তে ড্রিফট প্রত্যাখ্যান করে। প্রয়োজনীয় স্ক্যানার SKIP/INCOMPLETE আউটপুট PASS প্রতিষ্ঠা করতে পারে না। প্রোফাইল তার বাহ্যিক বর্জন রেকর্ড করে এবং হোস্ট করা কভারেজ, টেস্ট ম্যাট্রিক্স, প্যাকেজ বা স্থাপনার প্রমাণ প্রতিস্থাপন করে না। নীচের গদ্য তালিকাটি একটি রেফারেন্স, এটি প্রমাণ নয় যে একটি গেট আসলে দৌড়েছিল।
|
||||
এই প্রোফাইলগুলি শুধুমাত্র স্ট্যাটিক স্ক্যান কভার করে। তারা পণ্য পরীক্ষা, কভারেজ, প্যাকেজিং, বাহ্যিক চেক বা প্রার্থীর সম্পূর্ণ রিলিজ গ্রহণযোগ্যতা প্রত্যয়িত করে না। কর্মপ্রবাহ ভর্তি লিঙ্কযুক্ত `config/quality/admission-policy.json` এবং `scripts/quality/admission-verdict.mjs` ব্যবহার করে। রিলিজ-পর্যবেক্ষক প্রোফাইল আলাদা থাকে; তাদের প্রযোজ্য চেক এবং রসিদ স্বাধীনভাবে পরিদর্শন করুন। সম্পূর্ণ পর্যবেক্ষকের স্ট্যাটিক কমান্ড `config/quality/release-green-static-profile.json` এ ঘোষণা করা হয়, যার মধ্যে `audit:deps`, মিউটেশন-পরীক্ষা নির্বাচন এবং অনুবাদ পরীক্ষা। লোডার package.json এবং মডেল করা CI/Quality ঘোষণার বিরুদ্ধে npm কমান্ড যাচাই করে; এটি আর্গুমেন্ট হিসাবে শেল টোকেন কার্যকর করার পরিবর্তে ড্রিফ্ট প্রত্যাখ্যান করে। প্রয়োজনীয় স্ক্যানার SKIP/INCOMPLETE আউটপুট PASS প্রতিষ্ঠা করতে পারে না। প্রোফাইলটি তার বাহ্যিক বর্জন রেকর্ড করে এবং হোস্ট করা কভারেজ, টেস্ট ম্যাট্রিক্স, প্যাকেজ বা স্থাপনার প্রমাণ প্রতিস্থাপন করে না। নীচের গদ্য তালিকাটি একটি রেফারেন্স, এটি প্রমাণ নয় যে একটি গেট আসলে দৌড়েছিল।
|
||||
|
||||
স্ক্রিপ্টগুলি `scripts/check/` (পলিসি গেট) এবং `scripts/quality/` (র্যাচেট ইঞ্জিন) এর অধীনে থাকে। সত্যের CI উৎস হল `.github/workflows/ci.yml`।
|
||||
|
||||
@@ -55,18 +57,18 @@ Mergify খসড়ার বিবরণে তার সারির সা
|
||||
|
||||
`.github/workflows/quality.yml` main/release PRs এ CI পরিপূরক করে, `main` এ ঠেলে দেয়, গোষ্ঠী প্রেরণ এবং একত্রিত করে। PRs পাথ-ফিল্টার করা দ্রুত চেক ব্যবহার করে। স্থায়ীভাবে অক্ষম ডুপ্লিকেট বিল্ড সরানো হয়েছে; আসল build/package/boot চেক CI এ থাকে। ইউনিট স্যুট এবং ভিটেস্ট শুধুমাত্র CI (`Unit Tests (N/8)` এবং `Vitest`) এ চলে।
|
||||
|
||||
| চাকরি | ব্যাপ্তি | ব্লকিং |
|
||||
| ------------------------------------------------ | ----------------------------------------------------------------------------------------------------------------- | --------------- |
|
||||
| `Docs Gates (fast-path)` | Docs/code PRs; API ডক্স রেফ এবং ডক্স-সমস্ত | হ্যাঁ |
|
||||
| চাকরি | ব্যাপ্তি | ব্লকিং |
|
||||
| ------------------------------------------------ | ----------------------------------------------------------------------------------------------------------------- | ------------------- |
|
||||
| `Docs Gates (fast-path)` | Docs/code PRs; API ডক্স রেফ এবং ডক্স-সমস্ত | হ্যাঁ |
|
||||
| `Fast Quality Gates` | কোড PRs; স্ট্যাটিক চেক, টাইপচেক, ড্যাশবোর্ড টাইপচেক, প্রভাবিত ইউনিট পরীক্ষা, ভুলে যাওয়া ভাইবোন পরীক্ষা (পরামর্শ) |
|
||||
| `No new ESLint warnings` | কোড PRs; দমন-সচেতন লিন্ট গার্ড | হ্যাঁ, কাঁটা সহ |
|
||||
| `Merge integrity (changelog + generated skills)` | অ-খসড়া PRs; চেঞ্জলগ এবং জেনারেটেড স্কিল সিঙ্ক | হ্যাঁ, কাঁটা সহ |
|
||||
| `No new ESLint warnings` | কোড PRs; দমন-সচেতন লিন্ট গার্ড | হ্যাঁ, কাঁটাচামচ সহ |
|
||||
| `Merge integrity (changelog + generated skills)` | অ-খসড়া PRs; চেঞ্জলগ এবং জেনারেটেড স্কিল সিঙ্ক | হ্যাঁ, কাঁটাচামচ সহ |
|
||||
|
||||
#### ভুলে যাওয়া ভাইবোনের পরীক্ষার রিপোর্ট
|
||||
|
||||
`npm run check:forgotten-sibling-tests` `Fast Quality Gates` এর একটি পরামর্শমূলক পদক্ষেপ হিসাবে চলে এবং পরীক্ষা-প্রভাব মানচিত্রের পিছনে আমদানি সমাধানকারী পুনরায় ব্যবহার করে। প্রতিটি পরিবর্তিত উৎপাদন মডিউলের জন্য, এটি নির্ধারক `changed module/symbol -> static consumer -> candidate sibling test` চেইন রিপোর্ট করে যখন প্রার্থী পরীক্ষাটি পুল-অনুরোধের পার্থক্য থেকে অনুপস্থিত থাকে। মার্কডাউন সারাংশ এবং JSON ফলাফল যেকোন ব্লকিং রোলআউটের আগে ক্রমাঙ্কনের জন্য `forgotten-sibling-tests` ওয়ার্কফ্লো আর্টিফ্যাক্ট হিসাবে ধরে রাখা হয়।
|
||||
`npm run check:forgotten-sibling-tests` `Fast Quality Gates` এর একটি পরামর্শমূলক পদক্ষেপ হিসাবে চলে এবং পরীক্ষা-প্রভাব মানচিত্রের পিছনে আমদানি সমাধানকারীকে পুনরায় ব্যবহার করে। প্রতিটি পরিবর্তিত উৎপাদন মডিউলের জন্য, এটি নির্ধারক `changed module/symbol -> static consumer -> candidate sibling test` চেইন রিপোর্ট করে যখন প্রার্থী পরীক্ষাটি পুল-অনুরোধের পার্থক্য থেকে অনুপস্থিত থাকে। মার্কডাউন সারাংশ এবং JSON ফলাফল যেকোন ব্লকিং রোলআউটের আগে ক্রমাঙ্কনের জন্য `forgotten-sibling-tests` ওয়ার্কফ্লো আর্টিফ্যাক্ট হিসাবে ধরে রাখা হয়।
|
||||
|
||||
ব্যারেল পুনরায় রপ্তানি এবং গতিশীল আমদানি শুধুমাত্র রেজোলিউশন ডায়াগনস্টিক; তারা কখনই একটি ব্লকিং ফাইন্ডিং তৈরি করে না। পর্যালোচনা করা ব্যতিক্রমগুলি `config/quality/forgotten-sibling-allowlist.json` তে বাস করে। প্রতিটি এন্ট্রিতে ভোক্তা এবং প্রার্থীর পরীক্ষার নাম দিতে হবে, একটি নির্দিষ্ট যুক্তি দিতে হবে এবং একটি GitHub সমস্যা বা পুল অনুরোধ লিঙ্ক করতে হবে। বিকৃত এন্ট্রি ব্যর্থ হয়েছে বন্ধ. ব্যতিক্রমগুলি মুছে ফেলা প্রার্থী পরীক্ষা বা `.skip`/`.todo` যোগ করে এমন একটি পার্থক্য দমন করতে পারে না; দাবি দুর্বল করা এবং অন্যান্য মাস্কিং স্বাধীনভাবে ব্লক করা `check:test-masking` গেটের মালিকানাধীন থাকে।
|
||||
ব্যারেল পুনরায় রপ্তানি এবং গতিশীল আমদানি শুধুমাত্র রেজোলিউশন ডায়াগনস্টিক; তারা কখনই একটি ব্লকিং ফাইন্ডিং তৈরি করে না। পর্যালোচনা করা ব্যতিক্রমগুলি `config/quality/forgotten-sibling-allowlist.json` তে বাস করে। প্রতিটি এন্ট্রিতে ভোক্তা এবং প্রার্থীর পরীক্ষার নাম দিতে হবে, একটি নির্দিষ্ট যুক্তি দিতে হবে এবং একটি GitHub সমস্যা বা পুল অনুরোধ লিঙ্ক করতে হবে। বিকৃত এন্ট্রি ব্যর্থ হয়েছে বন্ধ. ব্যতিক্রমগুলি মুছে ফেলা প্রার্থীর পরীক্ষা বা `.skip`/`.todo` যোগ করে এমন একটি পার্থক্য দমন করতে পারে না; দাবি দুর্বল করা এবং অন্যান্য মাস্কিং স্বাধীনভাবে ব্লক করা `check:test-masking` গেটের মালিকানাধীন থাকে।
|
||||
|
||||
### চাকরি: `lint`
|
||||
|
||||
@@ -80,7 +82,7 @@ Mergify খসড়ার বিবরণে তার সারির সা
|
||||
| `check:route-validation:t06` | সমস্ত রুটেZod স্কিমা উপস্থিত (টায়ার 6 নীতি) | হ্যাঁ |
|
||||
| `check:any-budget:t11` | `@ts-expect-error // any` গণনা বাজেটের বেশি নয় (টিয়ার 11 ক্যাট্রাকা) | হ্যাঁ |
|
||||
| `check:provider-consistency` | `providers.ts` এর প্রতিটি প্রদানকারীর `providerRegistry.ts` এ একটি ম্যাচিং এন্ট্রি রয়েছে (এবং এর বিপরীতে, অনুমোদিত তালিকার মধ্যে) | হ্যাঁ |
|
||||
| `check:model-lifecycle` | তিনটি হাতে রক্ষণাবেক্ষণ করা রাউটিং টেবিল চেক-ইন লাইফসাইকেল স্ন্যাপশট (#11503) এর সাথে সামঞ্জস্যপূর্ণ থাকে : `FITNESS_TABLE` (`taskFitness.ts`) স্কোর কোনো অবসরপ্রাপ্ত আইডি নেই যা `REGISTRY` রুট করতে পারে; প্রতিটি `BUILT_IN_ALIASES` টার্গেট `REGISTRY` এ উপস্থিত এবং অবসরপ্রাপ্ত-আইডি স্ন্যাপশট থেকে অনুপস্থিত; `REGISTRY` এ থাকা প্রতিটি অবসরপ্রাপ্ত আইডি `allowedRetiredInCatalog` এ ফরোয়ার্ড বা তালিকাভুক্ত করা হয়; এবং কোন `DEFAULT_DEGRADATION_MAP` উৎস বা লক্ষ্য সেই স্ন্যাপশটে অবসরপ্রাপ্ত প্রদর্শিত হবে না। এটি প্রমাণ করে না যে একটি মডেল বর্তমানে একটি লাইভ আপস্ট্রিম দ্বারা পরিবেশিত হয়৷ অফলাইন — `config/quality/model-lifecycle.json` সাথে তুলনা করে, `npm run quality:refresh-model-lifecycle` দিয়ে হাতে রিফ্রেশ করা হয় (নেটওয়ার্ক; CI এ তারযুক্ত নয়)। `allowedRetiredInCatalog` হল একটি বার্ন-ডাউন র্যাচেট: শুধুমাত্র একটি ট্র্যাকিং সমস্যা সহ একটি এন্ট্রি যোগ করুন। | হ্যাঁ |
|
||||
| `check:model-lifecycle` | তিনটি হাতে রক্ষণাবেক্ষণ করা রাউটিং টেবিল চেক-ইন লাইফসাইকেল স্ন্যাপশট (#11503) এর সাথে সামঞ্জস্যপূর্ণ থাকে : `FITNESS_TABLE` (`taskFitness.ts`) স্কোর কোনো অবসরপ্রাপ্ত আইডি নেই যা `REGISTRY` রুট করতে পারে; প্রতিটি `BUILT_IN_ALIASES` টার্গেট `REGISTRY` এ উপস্থিত এবং অবসরপ্রাপ্ত-আইডি স্ন্যাপশট থেকে অনুপস্থিত; `REGISTRY` এ থাকা প্রতিটি অবসরপ্রাপ্ত আইডি `allowedRetiredInCatalog` এ ফরোয়ার্ড বা তালিকাভুক্ত করা হয়েছে; এবং সেই স্ন্যাপশটে কোন `DEFAULT_DEGRADATION_MAP` উৎস বা লক্ষ্য অবসরপ্রাপ্ত দেখা যায় না। এটি প্রমাণ করে না যে একটি মডেল বর্তমানে একটি লাইভ আপস্ট্রিম দ্বারা পরিবেশিত হয়৷ অফলাইন — `config/quality/model-lifecycle.json` সাথে তুলনা করে, `npm run quality:refresh-model-lifecycle` দিয়ে হাতে রিফ্রেশ করা হয় (নেটওয়ার্ক; CI এ তারযুক্ত নয়)। `allowedRetiredInCatalog` হল একটি বার্ন-ডাউন র্যাচেট: শুধুমাত্র একটি ট্র্যাকিং সমস্যা সহ একটি এন্ট্রি যোগ করুন। | হ্যাঁ |
|
||||
| `check:fetch-targets` | ক্লায়েন্ট-সাইড `src/` এর প্রতিটি `fetch("/api/...")` একটি বাস্তব `route.ts` তে সমাধান করে | হ্যাঁ |
|
||||
| `check:deps` | রেপোর প্রতিটি `package.json` জুড়ে সমস্ত `npm install` -able deps `dependency-allowlist.json` এ রয়েছে; নতুন আনপিন বা স্লপস্কোয়াট প্যাকেজ পতাকাঙ্কিত | হ্যাঁ |
|
||||
| `audit:deps` | সমস্ত পাঁচটি স্বাধীন লকফাইলের npm অডিট (root, Electron, OpenCode প্লাগইন v1/v2 এবং প্রদানকারী)। সমালোচনামূলক পরামর্শ ব্লক; উচ্চ পরামর্শ দৃশ্যমান সতর্কতা অবশেষ. Missing/failed অডিট হল INCOMPLETE এবং ব্লক; প্রতি-স্কোপ লক হ্যাশ এবং রিপোর্ট বজায় রাখা হয়। | হ্যাঁ |
|
||||
@@ -90,7 +92,7 @@ Mergify খসড়ার বিবরণে তার সারির সা
|
||||
| `check:ai-attribution` | PR কমিট, শিরোনাম বা বডি — হার্ড রুল #16 এ কোন AI/bot `Co-Authored-By` ট্রেলার বা AI-জেনারেশন `commit-msg` নেই ( PR→ `release/**` — #14436 জন্য `quality.yml` ফাস্ট-গেটস লুপে ইভেন্ট পেলোড পড়ে, `ci.yml` -অফ অফ PRs — `main`-এর জন্য একটি ধাপ PR→; |
|
||||
| `check:vitest-exclusions` | প্রতিটি Vitest বর্জন একটি ট্র্যাকিং সমস্যার নাম দেয় এবং `config/quality/vitest-exclusions.json` (#13204) এ প্রদর্শিত হয় | হ্যাঁ |
|
||||
| `check:file-size` | সোর্স ফাইল (`.ts`/`.tsx` `src/`, `open-sse/`, `electron/`, `bin/`) `cap` এর মধ্যে থাকে এবং `testCap` মধ্যে পরীক্ষা ফাইল (`*.test.ts(x)`) থাকে ; `file-size-baseline.json` (`frozen` / `testFrozen`) তে হিমায়িত ফাইলগুলি অবশ্যই তাদের রেকর্ড করা আকারের আগে বাড়বে না | হ্যাঁ |
|
||||
| `check:error-helper` | executors/handlers তে ত্রুটির প্রতিক্রিয়া `buildErrorBody()` / `sanitizeErrorMessage()` ব্যবহার করে (হার্ড রুল #12) | হ্যাঁ |
|
||||
| `check:error-helper` | executors/handlers এ ত্রুটির প্রতিক্রিয়া `buildErrorBody()` / `sanitizeErrorMessage()` ব্যবহার করে (হার্ড রুল #12) | হ্যাঁ |
|
||||
| `check:migration-numbering` | মাইগ্রেশন ফাইলের নাম: পুরানো `001`–`241` সিরিজ হিমায়িত এবং নতুন ফাইলগুলি `YYYYMMDDHHMMSS_<description>.sql`। PR বেসের বিপরীতে এটি একটি সরানো স্থানান্তর প্রত্যাখ্যান করে, একটি সামঞ্জস্যপূর্ণ এন্ট্রি ছাড়াই একটি পুনঃনামকরণ করা হয় এবং একটি বহিরাগত বা সম্পাদিত একটি যার চূড়ান্ত স্কিমা যাতায়াত করে না |
|
||||
| `check:public-creds` | `publicCreds.ts` এর বাইরে কোন আক্ষরিক OAuth `client_id`/`client_secret` বা ফায়ারবেস ওয়েব কী নেই (হার্ড রুল #11) | হ্যাঁ |
|
||||
| `check:db-rules` | `src/lib/db/` মডিউলের বাইরে কোন কাঁচা SQL নেই; `localDb.ts` থেকে ব্যারেল-আমদানি নেই (হার্ড রুলস #2/#5) | হ্যাঁ |
|
||||
@@ -108,11 +110,11 @@ Mergify খসড়ার বিবরণে তার সারির সা
|
||||
|
||||
#### দুটি টাইপচেক প্রোগ্রাম ভিন্নভাবে উত্তর দেয়
|
||||
|
||||
`typecheck:core` এবং `check:build-typecheck` বিভিন্ন বিকল্পের অধীনে বিভিন্ন প্রোগ্রাম কম্পাইল করে এবং একই ফাইল একটিতে পরিষ্কার এবং অন্যটিতে ত্রুটিপূর্ণ হতে পারে।
|
||||
`typecheck:core` এবং `check:build-typecheck` বিভিন্ন বিকল্পের অধীনে বিভিন্ন প্রোগ্রাম কম্পাইল করে, এবং একই ফাইল একটিতে পরিষ্কার এবং অন্যটিতে ত্রুটিপূর্ণ হতে পারে।
|
||||
|
||||
`tsconfig.build.json` `"strict": false` সেট করে, তাই `noImplicitAny` বন্ধ। মূল কনফিগারেশন কঠোর বিকল্পগুলির সাথে একটি কিউরেটেড 27-ফাইল অনুমোদন তালিকা সংকলন করে এবং প্রতিটি এন্ট্রির আমদানি গ্রাফ অনুসরণ করে, তাই যে ফাইলগুলি বিল্ড প্রোগ্রামে উপস্থিত হয় না সেগুলি এখনও সেখানে চেক করা হয়।
|
||||
|
||||
একটি ফাইল টাইপ করা হয়েছে কিনা তা বিচার করার সময় ফলাফল গুরুত্বপূর্ণ:** `check:build-typecheck` অধীনে শূন্য ডায়াগনস্টিক মানে শূন্য নয়** . 26টি ফাইল থেকে `@ts-nocheck` বের করে বিল্ড প্রোগ্রামে তাদের মধ্যে 23টি পরিষ্কার দেখায়; এর মধ্যে ষোলটি প্রায় 120টি অন্তর্নিহিত-কঠোরটিতে যে কোনও ত্রুটি রয়েছে। একটি ফাইল পরিষ্কার কল করার আগে উভয় চেক করুন.
|
||||
একটি ফাইল টাইপ করা হয়েছে কিনা তা বিচার করার সময় ফলাফল গুরুত্বপূর্ণ:** `check:build-typecheck` অধীনে শূন্য ডায়াগনস্টিক মানে শূন্য নয়** . 26টি ফাইল থেকে `@ts-nocheck` বের করে বিল্ড প্রোগ্রামে তাদের মধ্যে 23টি পরিষ্কার দেখায়; এর মধ্যে ষোলটি প্রায় 120টি অন্তর্নিহিত-কঠোরটিতে যেকোন ত্রুটি রয়েছে। একটি ফাইল পরিষ্কার কল করার আগে উভয় চেক করুন.
|
||||
|
||||
### চাকরি: `quality-gate`
|
||||
|
||||
@@ -121,7 +123,7 @@ Mergify খসড়ার বিবরণে তার সারির সা
|
||||
| স্ক্রিপ্ট | যাচাই করে | ব্লকিং |
|
||||
| ---------------------------- | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------ | ----------------------- |
|
||||
| `quality:collect` | নির্গত `quality-metrics.json` (ESLint সতর্কতা গণনা, মার্জড শার্ড রিপোর্ট থেকে কভারেজ) | হ্যাঁ (র্যাচেটের উজানে) |
|
||||
| `quality:ratchet` | `quality-baseline.json` তে প্রতিটি মেট্রিক প্রত্যাবর্তন করেনি (ESLint সতর্কতা ≤ বেসলাইন; কভারেজ ≥ বেসলাইন) | হ্যাঁ |
|
||||
| `quality:ratchet` | `quality-baseline.json` এর প্রতিটি মেট্রিক প্রত্যাবর্তন করেনি (ESLint সতর্কতা ≤ বেসলাইন; কভারেজ ≥ বেসলাইন) | হ্যাঁ |
|
||||
| `check:duplication` | কোড ডুপ্লিকেশন (jscpd@4) `quality-baseline.json` তে বেসলাইন অতিক্রম করে না | হ্যাঁ |
|
||||
| `check:complexity` | ফাইল-স্তরের সাইক্লোমেটিক জটিলতা ক্যাপ অতিক্রম করে না (কোর ESLint `complexity` + `max-lines-per-function`) | হ্যাঁ |
|
||||
| `check:cognitive-complexity` | জ্ঞানীয় জটিলতা র্যাচেট (`eslint-plugin-sonarjs`) — পৃথক ESLint পাস; CI রান উভয়ই একক `check:complexity-ratchets` ধাপ হিসেবে একত্রিত হয় | হ্যাঁ |
|
||||
@@ -141,28 +143,28 @@ Mergify খসড়ার বিবরণে তার সারির সা
|
||||
| `check:bundle-size` | বান্ডিল আকার ক্যাপ অতিক্রম না; একটি পরিমাপযোগ্য আকারও ব্যর্থ হয় | **--ratchet দিয়ে ব্লক করা** |
|
||||
| `check:secrets` | বাইনারি অনুপস্থিত থাকলে সিক্রেট স্ক্যানিং (gitleaks) — এড়িয়ে যায় | **--ratchet দিয়ে ব্লক করা** |
|
||||
| `check:vuln-ratchet` | নির্ভরতা দুর্বলতা (ওএসভি-স্ক্যানার) — `--ratchet` INCOMPLETE হিসাবে ব্যর্থ হয় না (প্রস্থান 2) যদি পরিমাপ না করা হয় | **--ratchet দিয়ে ব্লক করা** |
|
||||
| `check:workflows` | কর্মপ্রবাহ লিন্ট (অ্যাকশনলিন্ট + zizmor); missing/broken স্ক্যানার, অবৈধ রিপোর্ট বা অনুপস্থিত ratchet বেসলাইন INCOMPLETE হিসাবে ব্যর্থ হয়। বৈধ ফলাফল নির্বাচিত strict/advisory/ratchet নীতি অনুসরণ করে | মৃত্যুদন্ড প্রয়োজন; CI তে zizmor ratchet ব্লক করা |
|
||||
| `check:workflows` | কর্মপ্রবাহ লিন্ট (অ্যাকশনলিন্ট + zizmor); missing/broken স্ক্যানার, অবৈধ রিপোর্ট বা অনুপস্থিত র্যাচেট বেসলাইন INCOMPLETE হিসাবে ব্যর্থ হয়। বৈধ ফলাফল নির্বাচিত strict/advisory/ratchet নীতি অনুসরণ করে | মৃত্যুদন্ড প্রয়োজন; CI তে zizmor ratchet ব্লক করা |
|
||||
| `check:openapi-breaking` | পিন করা ইভেন্ট কমিটের বিরুদ্ধে পাবলিক API চুক্তি (PR মার্জ-বেস, পুশ আগে, মার্জ-গ্রুপ বেস; scheduled/manual চেকআউট ফার্স্ট প্যারেন্ট); প্রয়োজনীয় পরিমাপ ব্যর্থ হয় বন্ধ | **--ratchet দিয়ে ব্লক করা** |
|
||||
|
||||
### চাকরি: `docs-sync-strict`
|
||||
|
||||
প্রতিটি PR থেকে `main` পর্যন্ত চলে। ব্লকগুলি ব্যর্থতার উপর একত্রিত হয়।
|
||||
|
||||
| স্ক্রিপ্ট | যাচাই করে | ব্লকিং |
|
||||
| ------------------------------ | ---------------------------------------------------------------------------------------------------------------------------------------- | ------------------------------------ |
|
||||
| `check:docs-all` | মেটা-গেট যা ক্রমানুসারে নিচের 6টি সাব-গেট চালায় | হ্যাঁ |
|
||||
| ↳ `check:docs-sync` | CHANGELOG / OpenAPI সংস্করণের ধারাবাহিকতা; রিলিজ মোড এছাড়াও 66 `llm.txt` মিরর এবং অনুবাদিত CHANGELOG বিভাগ (PR মোড: মিরর সম্মত) | হ্যাঁ |
|
||||
| ↳ `check:docs-counts` | গদ্যে গণনা (প্রদানকারীর সংখ্যা, স্থানান্তর গণনা, ইত্যাদি)। দুটি মোড: `pr` বৈশিষ্ট্য PRs, `release` অন্যত্র — নীচে "উত্পন্ন মান" দেখুন | হ্যাঁ |
|
||||
| ↳ `check:env-doc-sync` | `.env.example` তে প্রতিটি env var একটি ডক্স টেবিলে নথিভুক্ত করা হয় এবং এর বিপরীতে | হ্যাঁ |
|
||||
| ↳ `check:deprecated-versions` | ডক্সে কোনো অবচয়িত সংস্করণ স্ট্রিং নেই | হ্যাঁ |
|
||||
| ↳ `check:doc-links` | ডক্সে অভ্যন্তরীণ মার্কডাউন লিঙ্কগুলি বাস্তব ফাইলগুলিতে সমাধান করে (`[text]`/`(path)` ফর্ম) | হ্যাঁ |
|
||||
| ↳ `check:fabricated-docs` | রুট, env vars, CLI কমান্ড, হুকের নাম এবং ডক্সে উদ্ধৃত ফাইল পাথ কোডবেসে বিদ্যমান। `--strict` এর মাধ্যমে হার্ড গেট; পতাকা ছাড়া soft-fail. | হ্যাঁ ( CI তে `--strict` এর মাধ্যমে) |
|
||||
| `check:cli-i18n` | CLI `t()` কী `bin/cli/locales/en.json` তে বিদ্যমান (উভয় মোড); শুধুমাত্র রিলিজ মোডে `en.json` সহ pt-BR/zh-CN/zh-TW প্যারিটি | হ্যাঁ |
|
||||
| `check:openapi-coverage` | OpenAPI স্পেক বাস্তব রুটের অন্তত একটি র্যাচেটেড ফ্লোর কভার করে | হ্যাঁ |
|
||||
| `check:openapi-security-tiers` | `openapi.yaml` তে নিরাপত্তা স্তরের টীকাগুলি `routeGuard.ts` শ্রেণীবিভাগের সাথে সামঞ্জস্যপূর্ণ | **উপদেষ্টা** |
|
||||
| `check:openapi-routes` | `openapi.yaml` এর প্রতিটি পথ একটি বাস্তব `route.ts` প্রতি সংকল্প করে (অ্যান্টি-হ্যালুসিনেশন) | হ্যাঁ |
|
||||
| `check:docs-symbols` | `docs/**/*.md` এর প্রতিটি `/api/...` রেফারেন্স একটি বাস্তব `route.ts` (অ্যান্টি-হ্যালুসিনেশন) এর প্রতি মীমাংসা করে | হ্যাঁ |
|
||||
| `i18n translation drift` | `docs/i18n/**` মিরর বনাম `.i18n-state.json` — PRs এ পরামর্শ (আয়না অনুবাদ তরঙ্গ দ্বারা সতেজ হয়), ধাক্কা এবং রাতের বেলায় কঠোর | **উপদেষ্টা** PRs |
|
||||
| স্ক্রিপ্ট | যাচাই করে | ব্লকিং |
|
||||
| ------------------------------ | --------------------------------------------------------------------------------------------------------------------------------------- | ------------------------------------ |
|
||||
| `check:docs-all` | মেটা-গেট যা ক্রমানুসারে নিচের 6টি সাব-গেট চালায় | হ্যাঁ |
|
||||
| ↳ `check:docs-sync` | CHANGELOG / OpenAPI সংস্করণের ধারাবাহিকতা; রিলিজ মোড এছাড়াও 66 `llm.txt` মিরর এবং অনুবাদিত CHANGELOG বিভাগ (PR মোড: মিরর সম্মত) | হ্যাঁ |
|
||||
| ↳ `check:docs-counts` | গদ্যে গণনা (প্রদানকারীর সংখ্যা, স্থানান্তর গণনা, ইত্যাদি)। দুটি মোড: `pr` বৈশিষ্ট্য PRs, `release` অন্যত্র — নীচে "উত্পন্ন মান" দেখুন | হ্যাঁ |
|
||||
| ↳ `check:env-doc-sync` | `.env.example` তে প্রতিটি env var একটি ডক্স টেবিলে নথিভুক্ত করা হয় এবং এর বিপরীতে | হ্যাঁ |
|
||||
| ↳ `check:deprecated-versions` | ডক্সে কোনো অবচয়িত সংস্করণ স্ট্রিং নেই | হ্যাঁ |
|
||||
| ↳ `check:doc-links` | ডক্সে অভ্যন্তরীণ মার্কডাউন লিঙ্কগুলি বাস্তব ফাইলগুলিতে সমাধান করে (`[text]`/`(path)` ফর্ম) | হ্যাঁ |
|
||||
| ↳ `check:fabricated-docs` | রুট, env vars, CLI কমান্ড, হুকের নাম এবং ডক্সে উদ্ধৃত ফাইল পাথ কোডবেসে বিদ্যমান। `--strict` এর মাধ্যমে শক্ত গেট; পতাকা ছাড়া soft-fail. | হ্যাঁ ( CI তে `--strict` এর মাধ্যমে) |
|
||||
| `check:cli-i18n` | CLI `t()` কী `bin/cli/locales/en.json` তে বিদ্যমান (উভয় মোড); শুধুমাত্র রিলিজ মোডে `en.json` সহ pt-BR/zh-CN/zh-TW প্যারিটি | হ্যাঁ |
|
||||
| `check:openapi-coverage` | OpenAPI স্পেক বাস্তব রুটের অন্তত একটি র্যাচেটেড ফ্লোর কভার করে | হ্যাঁ |
|
||||
| `check:openapi-security-tiers` | `openapi.yaml` তে নিরাপত্তা স্তরের টীকাগুলি `routeGuard.ts` শ্রেণীবিভাগের সাথে সামঞ্জস্যপূর্ণ | **উপদেষ্টা** |
|
||||
| `check:openapi-routes` | `openapi.yaml` এর প্রতিটি পথ একটি বাস্তব `route.ts` প্রতি সংকল্প করে (অ্যান্টি-হ্যালুসিনেশন) | হ্যাঁ |
|
||||
| `check:docs-symbols` | `docs/**/*.md` তে প্রতিটি `/api/...` রেফারেন্স একটি বাস্তব `route.ts` (অ্যান্টি-হ্যালুসিনেশন) এর প্রতি মীমাংসা করে | হ্যাঁ |
|
||||
| `i18n translation drift` | `docs/i18n/**` মিরর বনাম `.i18n-state.json` — PRs এ পরামর্শ (আয়না অনুবাদ তরঙ্গ দ্বারা সতেজ হয়), ধাক্কা এবং রাতের বেলায় কঠোর | **উপদেষ্টা** PRs |
|
||||
|
||||
#### অনুবাদ আয়নাগুলি প্রাপ্ত ফাইলগুলি (PR মোড বনাম রিলিজ মোড)
|
||||
|
||||
@@ -170,16 +172,16 @@ Mergify খসড়ার বিবরণে তার সারির সা
|
||||
|
||||
- `check:docs-sync` — রিলিজ মোড প্রতিটি চেক চালায়। PR মোড package.json/OpenAPI সংস্করণ, রুট CHANGELOG শিরোনাম এবং সুপারসেড-ডক্স গার্ড রাখে এবং `llm.txt` মিরর কপিগুলির জন্য `SKIP reason=pr-mode` প্রিন্ট করে এবং অনূদিত CHANGELOG বিভাগ — যদি না PR মিরর লেখে: একটি প্রধান শাখা `docs/i18n/**` এর লেখক হিসাবে ঘোষিত হয়, যখন `config/quality/derived-paths/*.json` ফ্যামিলিতে কঠোরভাবে কাজ করে, উভয়ই পরীক্ষা করে একটি পরিবর্তন যার নিজস্ব পার্থক্য `docs/i18n/<locale>/llm.txt` বা `CHANGELOG.md` সম্পাদনা করে তা কঠোরভাবে পরীক্ষা করে। ডিফ বেস একটি depth-1 চেকআউটে ( `docs-sync-strict` জব) সমাধান করে না, তাই PR মোড এমন একটি চেকও চালায় যার কোন ভিত্তির প্রয়োজন নেই: প্রতিটি `llm.txt` আয়না অবশ্যই থাকতে হবে, এর `---` বিভাজক রাখতে হবে এবং মূল বডি বা বেশিরভাগ আয়না শেয়ার করে বডি বহন করে। একটি ভিত্তি যা সরানো সমস্ত আয়নাকে সমানভাবে বাসি ছেড়ে দেয় এবং পাস করে; একটি আয়না একটি হাত সম্পাদনা ব্যর্থ হয়. অনূদিত `CHANGELOG.md` ফাইলগুলির একটি depth-1 PR চেকআউটে এমন কোন চেক নেই।
|
||||
- প্রি-কমিট হুক `check-docs-sync.mjs --mode=pr` চালায়: একটি কমিট কি করে তার উপর বিচার করা হয়। পতাকা ছাড়া একটি স্থানীয় রান হল রিলিজ মোড, এবং একটি মার্জড PR যা রুট `llm.txt` সম্পাদনা করে তরঙ্গটি না চলা পর্যন্ত সেই বেসটিতে প্রতিটি পরবর্তী কমিট ব্লক করবে। একই নিয়ম যেকোন মোড-সচেতন গেট একটি হাস্কি হুক রানের জন্য ধারণ করে: হুক `--mode=pr` পাস করে, এবং কঠোর রায় রিলিজ-মোড রানের সাথে থাকে (রিলিজ PR, `main` তে ঠেলে, একটি সাধারণ স্থানীয় রান)।
|
||||
- মিরর-কন্টেন্ট ইউনিট পরীক্ষা (`tests/_helpers/mirrorFreshness.ts`: `cycle-docs-mirror-contract`, `resilience-pre-dispatch-docs-mirrors`, `cli-env-quality-docs-mirrors`, `docs/*-locales`) — রিলিজ মোড প্রতিটি লোকেলে জোর দেয়। PR মোড `.i18n-state.json` (পুরো-ফাইল হ্যাশ, বা পরীক্ষার পিন বিভাগের রেকর্ডকৃত সেকশন হ্যাশ) অনুসারে ইংরেজি উৎসের সাথে বর্তমান থাকা আয়নাগুলিকে জোর করে এবং একটি কারণ সহ বাসিগুলিকে এড়িয়ে যায়। উভয় মোডে প্রতিটি লোকেলের জন্য `target_hash` প্রোভেন্যান্স চেক চালানো হয়। সতেজতা প্রতি `## ` বিভাগে, ইউনিট `run-translation.mjs` হ্যাশ; একটি দীর্ঘ অংশ (এই ফাইলের গেট ইনভেন্টরি এটির প্রায় অর্ধেক) মানে এতে যে কোনও সম্পাদনা সেই আয়নাগুলিকে বাসি করে দেয় এবং তাদের পিআর-মোড দাবিগুলি পরবর্তী তরঙ্গ পর্যন্ত এড়িয়ে যায়। ইংরেজি উৎসের একটি অ্যাঙ্কর যা আর ধারণ করে না তা সম্পূর্ণ-ফাইলের তুলনাতে ফিরে আসে।
|
||||
- `i18n translation drift` — PRs এর উপর পরামর্শ, ধাক্কার উপর কঠোর, রাত্রিকালীন এবং রিলিজ কাট, তাই একটি বাসি আয়না রিলিজে পাঠানো যাবে না।
|
||||
- মিরর-কন্টেন্ট ইউনিট পরীক্ষা (`tests/_helpers/mirrorFreshness.ts`: `cycle-docs-mirror-contract`, `resilience-pre-dispatch-docs-mirrors`, `cli-env-quality-docs-mirrors`, `docs/*-locales`) — রিলিজ মোড প্রতিটি লোকেলে জোর দেয়। PR মোড `.i18n-state.json` (পুরো-ফাইল হ্যাশ, বা পরীক্ষার পিন বিভাগের রেকর্ডকৃত সেকশন হ্যাশ) অনুসারে ইংরেজি উৎসের সাথে বর্তমান থাকা আয়নাগুলিকে জোর করে এবং একটি কারণ সহ বাসিগুলিকে এড়িয়ে যায়। উভয় মোডে প্রতিটি লোকেলের জন্য `target_hash` প্রোভেন্যান্স চেক চালানো হয়। সতেজতা প্রতি `## ` বিভাগে, ইউনিট `run-translation.mjs` হ্যাশ; একটি দীর্ঘ অংশ (এই ফাইলের গেট ইনভেন্টরি এটির প্রায় অর্ধেক) মানে এতে যে কোনও সম্পাদনা সেই আয়নাগুলিকে বাসি করে দেয় এবং তাদের পিআর-মোড দাবিগুলি পরবর্তী তরঙ্গ পর্যন্ত এড়িয়ে যায়। ইংরেজি উৎসের একটি অ্যাঙ্কর যা আর ধারণ করে না পুরো-ফাইলের তুলনাতে ফিরে আসে।
|
||||
- `i18n translation drift` — PRs এর উপর পরামর্শ, পুশের উপর কঠোর, রাত্রিকালীন এবং রিলিজ কাট, তাই একটি বাসি আয়না রিলিজে পাঠানো যাবে না।
|
||||
|
||||
`scripts/i18n/sync-llm-mirrors.mjs` (এছাড়াও `syncLlmMirrors()` হিসাবে রপ্তানি করা হয়, `--dry-run` সহ) `llm.txt` মিররগুলিকে পুনর্লিখন করে; রিলিজ রিফ্রেশ, অনুবাদ তরঙ্গ এবং নির্ধারিত `i18n-mirror-refresh.yml` এটি চালায় (রিফ্রেশ একটি ড্রাই রানের সাথে বাসি `llm.txt` মিরর সনাক্ত করে, যেহেতু ড্রিফ্ট রিপোর্ট তাদের তালিকাভুক্ত করে না এবং `check:docs-all` আগে তাদের সিঙ্ক করে)।
|
||||
|
||||
`docs/diagrams/` অধীনে বারোটি README SVGs তৈরি হয় (`scripts/docs/gen-readme-<name>.mjs`; `npm run docs:readme-diagrams` তাদের সকলকে পুনরুত্থিত করে)। প্রতিটির একটি বাইট-তুলনা ইউনিট পরীক্ষা রয়েছে (`tests/unit/docs/readme-*-svg.test.ts`, job `test-unit`) যা ব্যর্থ হয় যখন প্রতিশ্রুতিবদ্ধ ফাইলটি রিলিজ মোডে বাসি হয়; একটি PR এ, `check:generated-artifacts` একটি SVG PR সম্পাদনাগুলি বিচার করে এবং বেসের ড্রিফ্টটি রিলিজ রিফ্রেশের জন্য ছেড়ে দেওয়া হয় (দেখুন [জেনারেটেড ফাইল এবং প্রাপ্ত বেসলাইন](#generated-files-and-derived-baselines-written-at-release) ) — এবং `check:docs-counts` তাদের `<text>` নোড — থেকে ক্যানোনিকাল সংখ্যাগুলি পড়ে যার কারণে আউটলাইন করা `<text>` ফাইলের প্রতিটি ধাপে আউটলাইন করা হয়। SVG ক্যানোনিকাল-সংখ্যার চেক `SVG_DIAGRAM_FILES` (`scripts/check/check-docs-counts-sync.mjs`): `docs/diagrams/readme-hero.svg`, `free-tier-budget.svg`, `promise-pillars.svg`, `comparison-table.svg`, `cli-terminal.svg`, `tier-cascade.svg`, প্লাস `public/images/tier-flow-dark.svg` এবং `tier-flow-light.svg`; ফ্রি-এভার, ক্যাটালগ-এন্ট্রি, রেকারিং-পুল এবং স্কোরিং-ফ্যাক্টর দাবিগুলিও `promise-pillars.svg`, `free-tier-budget.svg` এবং `strategies-grid.svg` পড়ে। এই জেনারেটরগুলি যে গণনাগুলি আঁকেন (প্রোভাইডার মোট, MCP টুলস, রাউটিং কৌশল, ফ্রি-অস্থায়ী প্রদানকারী, …) ফ্যাক্ট স্ন্যাপশট `docs/reference/derived-facts.json` `scripts/docs/readmeFacts.mjs` মাধ্যমে আসে, লিটারাল থেকে নয়, তাই যে কোনও শাখায় একটি ডায়াগ্রাম পুনরুত্পাদন করা প্রতিশ্রুতিবদ্ধ ফাইলটি পুনরুত্পাদন করে। `free-tier-budget.svg` একই স্ন্যাপশট থেকে তার সারিগুলি আঁকে (`code.freeTierBudget`, ক্যাটালগ সারাংশ তথ্য অনুসন্ধানের রেকর্ড), তাই `FREE_MODEL_BUDGETS` এ পরিবর্তন CI লাল করার পরিবর্তে পরবর্তী রিফ্রেশে কার্ডে পৌঁছায়।
|
||||
`docs/diagrams/` অধীনে বারোটি README SVGs তৈরি হয় (`scripts/docs/gen-readme-<name>.mjs`; `npm run docs:readme-diagrams` তাদের সকলকে পুনরুত্পাদন করে)। প্রতিটির একটি বাইট-তুলনা ইউনিট পরীক্ষা রয়েছে (`tests/unit/docs/readme-*-svg.test.ts`, job `test-unit`) যা ব্যর্থ হয় যখন প্রতিশ্রুতিবদ্ধ ফাইলটি রিলিজ মোডে বাসি হয়; একটি PR এ, `check:generated-artifacts` একটি SVG PR সম্পাদনাগুলি বিচার করে এবং বেসের ড্রিফ্টটি রিলিজ রিফ্রেশের জন্য ছেড়ে দেওয়া হয় (দেখুন [জেনারেটেড ফাইল এবং প্রাপ্ত বেসলাইন](#generated-files-and-derived-baselines-written-at-release) ) — এবং `check:docs-counts` তাদের `<text>` নোড — থেকে ক্যানোনিকাল সংখ্যাগুলি পড়ে যার কারণে আউটলাইন করা `<text>` ফাইলের প্রতিটি ধাপে আউটলাইন করা হয়। SVG ক্যানোনিকাল-সংখ্যার চেক `SVG_DIAGRAM_FILES` (`scripts/check/check-docs-counts-sync.mjs`): `docs/diagrams/readme-hero.svg`, `free-tier-budget.svg`, `promise-pillars.svg`, `comparison-table.svg`, `cli-terminal.svg`, `tier-cascade.svg`, প্লাস `public/images/tier-flow-dark.svg` এবং `tier-flow-light.svg`; ফ্রি-এভার, ক্যাটালগ-এন্ট্রি, রেকারিং-পুল এবং স্কোরিং-ফ্যাক্টর দাবিগুলিও `promise-pillars.svg`, `free-tier-budget.svg` এবং `strategies-grid.svg` পড়ে। এই জেনারেটরগুলি যে গণনাগুলি আঁকেন (প্রোভাইডার মোট, MCP টুলস, রাউটিং কৌশল, ফ্রি-অস্থায়ী প্রদানকারী, …) ফ্যাক্ট স্ন্যাপশট `docs/reference/derived-facts.json` `scripts/docs/readmeFacts.mjs` মাধ্যমে আসে, লিটারাল থেকে নয়, তাই যে কোনও শাখায় একটি ডায়াগ্রাম পুনরুত্পাদন করা প্রতিশ্রুতিবদ্ধ ফাইলটি পুনরুত্পাদন করে। `free-tier-budget.svg` একই স্ন্যাপশট থেকে তার সারিগুলি আঁকে (`code.freeTierBudget`, ক্যাটালগ সারাংশ তথ্য অনুসন্ধানের রেকর্ড), তাই `FREE_MODEL_BUDGETS` এ পরিবর্তন CI লাল করার পরিবর্তে পরবর্তী রিফ্রেশে কার্ডে পৌঁছায়।
|
||||
|
||||
### প্রাপ্ত মান: `pr` এবং `release` গেট মোড
|
||||
|
||||
একটি বৈশিষ্ট্য PR কখনই এমন একটি মান লেখে না যা তার ভিত্তির অবস্থার উপর নির্ভর করে: প্রদানকারী, মাইগ্রেশন, MCP- টুল এবং কৌশল গণনা, README SVG সংখ্যা, তথ্যের স্ন্যাপশট। এক ধাপ তাদের সবগুলোকে পুনরায় গণনা করে, `npm run release:refresh-derived`, রিলিজ দ্বারা পরিচালিত হয় এবং রাত্রিকালীন উদ্ভূত-রিফ্রেশ PR দ্বারা। তাই** রিলিজের মধ্যে বেস ডিজাইন দ্বারা লাইভ কোডের পিছনে থাকে** , এবং একটি গেট বা পরীক্ষা যা লাইভ কোডের সাথে গাছের তুলনা করে, একজন ভাইবোন একটি প্রদানকারী যোগ করার পরে প্রতিটি PR এ লাল হবে। যে গেটগুলি প্রাপ্ত মান বিচার করে তাই দুটি মোডের একটিতে চলে, `scripts/check/lib/gateMode.mjs` দ্বারা সমাধান করা হয় (প্রথম ম্যাচে জয়):
|
||||
একটি বৈশিষ্ট্য PR কখনই এমন একটি মান লেখে না যা তার ভিত্তির অবস্থার উপর নির্ভর করে: প্রদানকারী, মাইগ্রেশন, MCP- টুল এবং কৌশল গণনা, README SVG সংখ্যা, তথ্যের স্ন্যাপশট। এক ধাপে তাদের সকলের পুনরায় গণনা করা হয়, `npm run release:refresh-derived`, রিলিজ দ্বারা পরিচালিত হয় এবং রাত্রিকালীন প্রাপ্ত-রিফ্রেশ PR দ্বারা। তাই** রিলিজের মধ্যে বেস ডিজাইন দ্বারা লাইভ কোডের পিছনে থাকে** , এবং একটি গেট বা পরীক্ষা যা লাইভ কোডের সাথে গাছের তুলনা করে একটি ভাইবোন একটি প্রদানকারী যোগ করার পরে প্রতিটি PR এ লাল হবে। যে গেটগুলি প্রাপ্ত মান বিচার করে তাই দুটি মোডের একটিতে চলে, `scripts/check/lib/gateMode.mjs` দ্বারা সমাধান করা হয় (প্রথম ম্যাচে জয়):
|
||||
|
||||
1. কমান্ড লাইনে`--mode=pr|release` ;
|
||||
2. `OMNIROUTE_GATE_MODE` পরিবেশ পরিবর্তনশীল (`pr` বা `release`);
|
||||
@@ -202,7 +204,7 @@ Exit codes: `0` clean · `1` STRICT drift (or soft drift with `--strict`) or a m
|
||||
|
||||
| যেখানে | মোড |
|
||||
| ---------------------------------------------------------------------------------------------------- | ----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
|
||||
| ফিচার PR — `ci.yml` জব `docs-sync-strict`, `quality.yml` ধাপ "ডক্সের নির্ভুলতা" | `pr` (স্বয়ংক্রিয়); কাজটি `BASE_SHA` হিসাবে বেস পাস করে এবং `fetch-depth: 2` দিয়ে চেক আউট করে |
|
||||
| ফিচার PR — `ci.yml` জব `docs-sync-strict`, `quality.yml` ধাপ "ডক্স সঠিকতা" | `pr` (স্বয়ংক্রিয়); কাজটি `BASE_SHA` হিসাবে বেস পাস করে এবং `fetch-depth: 2` দিয়ে চেক আউট করে |
|
||||
| `merge_group`, `omni-queue/**` প্রার্থী, মার্জ ট্রেনের পুরো গেটের তালিকা | `pr` |
|
||||
| রিলিজ PR (`release/v* → main`), পুশ, নির্ধারিত এবং ম্যানুয়াল রান | `release` |
|
||||
| রিলিজ-সবুজ (`scripts/quality/validate-release-green.mjs`) | HARD আইটেমগুলি `OMNIROUTE_GATE_MODE=pr` দিয়ে চলে ("বেসটি কি ভেঙে গেছে?"); DRIFT আইটেম `derived-refresh` `npm run release:refresh-derived -- --check` চালায় (কঠোর দৃষ্টিভঙ্গি, কখনই বেস-লাল খোলে না) |
|
||||
@@ -237,7 +239,7 @@ npm run release:refresh-derived -- --check # what the rele
|
||||
| `check-key-completeness` (ইনলাইন) | প্রতিটি UI ক্যাটালগ (এবং, `--catalog=cli` সহ, প্রতিটি CLI ক্যাটালগ) ঠিক তার `en.json` এর কী সেট বহন করে; `pr` মোডে, প্রতিটি ক্যাটালগ PR মার্জ বেসে নিজের বিরুদ্ধে পরিবর্তিত হয় | হ্যাঁ (উভয় মোড) |
|
||||
| `check-translation-ratio` | প্রতি লোকেলে বাস্তব-অনুবাদের অনুপাত (অনুরূপ-থেকে-ইংরেজি/স্থানধারক/অনুমতি তালিকার বাইরে থাকা পাতা) অবশ্যই `config/quality/i18n-translation-baseline.json` + স্ল্যাকের বেশি হবে না | হ্যাঁ (শুধুমাত্র রিলিজ মোড) |
|
||||
|
||||
প্রয়োজন `fetch-depth: 0` — মান-ড্রিফট গেট মার্জ বেসের বিপরীতে `en.json` আলাদা করে।
|
||||
`fetch-depth: 0` — প্রয়োজন মান-প্রবাহ গেট মার্জ বেসের বিপরীতে `en.json` আলাদা করে।
|
||||
|
||||
**দুটি মোড (2026-11-13 থেকে)।** একটি বৈশিষ্ট্য PR `en.json` (এবং `bin/cli/locales/en.json`) এ কীগুলি যোগ করে বা পুনর্লিখন করে এবং অন্য কোনও লোকেল স্পর্শ করে না; `check:pr-derived-paths` (job `pr-test-policy`, family `config/quality/derived-paths/translation.json`) একটি ফিচার PR ব্যর্থ করে যা করে। অন্যান্য লোকেলগুলি `release:refresh-derived` দ্বারা রিলিজ প্রতি একবার সম্পূর্ণ হয়, যা `scripts/i18n/sync-ui-keys.mjs` এ `syncUiKeys()` বলে (অনুপস্থিত কীগুলি যোগ করুন, বাদ দেওয়াগুলিকে ছাঁটাই করুন, `rewrittenSinceRef` দিয়ে পুনঃলিখিত ইংরেজির অনুবাদগুলি চিহ্নিত করুন , অনুবাদ করুন), বা একটি অনুবাদ তরঙ্গ দ্বারা। গেটগুলি `scripts/check/lib/gateMode.mjs` থেকে মোড পড়ে: `pr` মোডে (ফিচার PRs, `merge_group`, `omni-queue/**`) রিলিজ-মোড গেটগুলি `SKIP reason=pr-mode` এবং প্রিন্ট 0 এর উপরে; `release` মোডে (রিলিজ PR, `main`, `workflow_dispatch`, লোকাল রানে ঠেলে দেয়) তারা আগের মতোই কঠোর, এবং PR রিলিজে ডিফ-অ্যায়াররা `BASE_REF=origin/main` পায়, তাই তারা চক্রটি যোগ করা বা পুনরায় লেখা প্রতিটি কী বিচার করে। স্থানীয়ভাবে `--mode=pr` দিয়ে বৈশিষ্ট্য-পিআর রায়ের পূর্বরূপ দেখুন।
|
||||
|
||||
@@ -249,13 +251,13 @@ npm run release:refresh-derived -- --check # what the rele
|
||||
|
||||
একটি i18n রিগ্রেশন ক্যাচ করে যা অন্য গেটগুলি কাঠামোগতভাবে দেখতে পায় না: একটি ইংরেজি মান পুনরায় লেখা হয় এবং _আগের_ ইংরেজি থেকে প্রাপ্ত অনুবাদগুলি পিছনে থাকে, তাই অ-ইংরেজি ব্যবহারকারীরা আত্মবিশ্বাসের সাথে-শব্দযুক্ত, এখন-ভুল অনুলিপি পড়তে থাকে।
|
||||
|
||||
এই বাস্তব জন্য পাঠানো হয়েছে. অ্যান্টিগ্র্যাভিটি লগইন হেল্পার যখন অবতরণ করে তখন `oauthModal.googleOAuthWarning` পুনরায় লেখা হয়েছিল (#5203);** 43টির মধ্যে 39টি লোকেল** টেক্সট অপারেটরদের "সম্পূর্ণ URL অনুলিপি করুন এবং নীচে পেস্ট করুন" — একটি প্রবাহ যা সেই প্রদানকারীর জন্য সম্পূর্ণ করতে পারে না। এটি #8463 পর্যন্ত অলক্ষিত ছিল কারণ:
|
||||
এই বাস্তব জন্য পাঠানো হয়েছে. `oauthModal.googleOAuthWarning` পুনরায় লেখা হয়েছিল যখন Antigravity লগইন হেল্পার (#5203);** 43টির মধ্যে 39টি লোকেল** টেক্সট অপারেটরদের "সম্পূর্ণ URL অনুলিপি করুন এবং এটি নীচে পেস্ট করুন" — একটি প্রবাহ যা সেই প্রদানকারীর জন্য সম্পূর্ণ করতে পারে না। এটি #8463 পর্যন্ত অলক্ষিত ছিল কারণ:
|
||||
|
||||
- `sync-ui-keys` শুধুমাত্র backfills কী যে হয়** অনুপস্থিত** , যারা হয় না** বাসি** ;
|
||||
- `check-ui-keys-coverage` কী _presence_ গণনা করে, তাই একটি বাসি অনুবাদ কভার হিসাবে স্কোর করে;
|
||||
- `check-translation-drift` `docs/i18n/<locale>/**.md` ডকুমেন্টেশন মিরর — ট্র্যাক করে এটি কখনই `src/i18n/messages/*.json` পড়ে না। এটি কাজ `docs-sync-strict` এ চলে: PRs এর পরামর্শ, ধাক্কা এবং রাতের বেলায় কঠোর; অনুবাদ তরঙ্গ আয়না রিফ্রেশ করে, বৈশিষ্ট্য PR নয়।
|
||||
|
||||
**ভিন্ন-সচেতন, বেসলাইন-সমর্থিত নয়।** এটি কার্যকারী গাছের সাথে মার্জ বেসে `en.json` তুলনা করে; প্রতিটি কীর জন্য যার ইংরেজি মান পরিবর্তিত হয়েছে, যে কোনো লোকেল এখনও অস্পর্শিত অনুবাদ ধারণ করে বাসি। ইচ্ছাকৃতভাবে এই** পূর্ব-বিদ্যমান ঋণ জমা করে** — a diff প্রকাশ করতে পারে না যে কোন পুরানো ইংরেজি থেকে একটি দীর্ঘস্থায়ী অনুবাদ এসেছে, তাই গেট শুধুমাত্র বর্তমান পরিবর্তন স্পর্শ করে তা বিচার করে। বিকল্প (একটি প্রতি-কী হ্যাশ বেসলাইন) একটি ~ 600 KB জেনারেট করা ফাইলের জন্য খরচ হবে, 3 × বৃহত্তম বিদ্যমান বেসলাইন, প্রতি i18n PR এ মন্থন।
|
||||
**ভিন্ন-সচেতন, বেসলাইন-সমর্থিত নয়।** এটি কার্যকারী গাছের সাথে মার্জ বেসে `en.json` তুলনা করে; প্রতিটি কীর জন্য যার ইংরেজি মান পরিবর্তিত হয়েছে, যে কোনো লোকেল এখনও অস্পর্শিত অনুবাদ ধারণ করে বাসি। ইচ্ছাকৃতভাবে এই** পূর্ব-বিদ্যমান ঋণ জমা করে** — a diff প্রকাশ করতে পারে না কোন পুরানো ইংরেজি থেকে দীর্ঘস্থায়ী অনুবাদ এসেছে, তাই গেট বিচার করে শুধু বর্তমান পরিবর্তনটি কী স্পর্শ করে। বিকল্প (একটি প্রতি-কী হ্যাশ বেসলাইন) একটি ~ 600 KB জেনারেট করা ফাইলের জন্য খরচ হবে, 3 × বৃহত্তম বিদ্যমান বেসলাইন, প্রতি i18n PR এ মন্থন।
|
||||
|
||||
এটি সন্তুষ্ট করার দুটি উপায়:
|
||||
|
||||
@@ -309,10 +311,10 @@ BASE_REF=origin/release/vX.Y.Z npm run i18n:check-value-drift
|
||||
| `nightly-resilience` | হিপ-গ্রোথ গেট, ক্যাওস ফল্ট-ইনজেকশন, k6 load/soak | **উপদেষ্টা** |
|
||||
| `nightly-llm-security` | promptfoo ইনজেকশন গার্ড (ব্লক মোড) + garak প্রোব (একটি প্রদানকারী গোপন ছাড়া এড়িয়ে যাওয়া) | **উপদেষ্টা** |
|
||||
| `nightly-schemathesis` | OpenAPI কন্ট্রাক্ট ফাজিং (স্কিম্যাথিসিস) একটি লাইভ OmniRoute ব্যবহার করে `docs/openapi.yaml` — সারফেস স্পেক লঙ্ঘন / আনহ্যান্ডেলড 500s (Fase 8 B.4) | **উপদেষ্টা** |
|
||||
| `nightly-mutation` | স্ট্রাইকার মিউটেশন-টেস্টিং স্কোর ওভার ফাস্ট ইউনিট লেন — বেঁচে থাকা মিউট্যান্টদের পৃষ্ঠের দুর্বল দাবি | **উপদেষ্টা** |
|
||||
| `nightly-mutation` | দ্রুত ইউনিট লেনের উপর স্ট্রাইকার মিউটেশন-পরীক্ষার স্কোর — বেঁচে থাকা মিউট্যান্টদের পৃষ্ঠের দুর্বল দাবি | **উপদেষ্টা** |
|
||||
| `nightly-compat` | সমর্থিত `engines.node` রেঞ্জ জুড়ে নোড ইঞ্জিন সামঞ্জস্যপূর্ণ ম্যাট্রিক্স | **উপদেষ্টা** |
|
||||
|
||||
কর্মক্ষমতা বেসলাইন (হিপ, TTFB, বিল্ড টাইম) রেকর্ড করা হয়, গেটেড নয়: [`PERF_BASELINE.md`](../ops/PERF_BASELINE.md) (`npm run perf:lts-baseline`) দেখুন।
|
||||
পারফরমেন্স বেসলাইন (হিপ, TTFB, বিল্ড টাইম) রেকর্ড করা হয়েছে, গেটেড নয়: [`PERF_BASELINE.md`](../ops/PERF_BASELINE.md) (`npm run perf:lts-baseline`) দেখুন।
|
||||
|
||||
---
|
||||
|
||||
|
||||
@@ -43,23 +43,21 @@ flowchart LR
|
||||
|
||||
## রিলিজ ফ্রিজ (সমান্তরাল চক্র)
|
||||
|
||||
কোনো রিলিজ সমন্বয় করার সময় `release-freeze` লেবেলযুক্ত একটি মার্কার ইস্যু
|
||||
খোলা হয়। এটি **ডেভেলপমেন্ট বন্ধ করে না**:
|
||||
যখন একটি রিলিজ মিলিত হয়, তখন `release-freeze` লেবেলযুক্ত একটি মার্কার সমস্যা খোলা হয়। যে** উন্নয়ন বন্ধ করে না** :
|
||||
|
||||
- স্থির করা `release/vX.Y.Z` সেই প্রকাশের রিলিজ ক্যাপ্টেনের নিয়ন্ত্রণে থাকে।
|
||||
- পরবর্তী চক্রের `release/vX+1` স্থির করা সর্বশেষ প্রান্ত থেকে তৈরি করা হয়, যাতে কন্ট্রিবিউটররা
|
||||
কাজ যুক্ত করা চালিয়ে যেতে পারেন।
|
||||
- যেসব খোলা PR এখনও স্থির করা ব্রাঞ্চকে লক্ষ্য করে, সেগুলোকে **পুনরায় লক্ষ্য নির্ধারণ** করে
|
||||
সক্রিয় (সর্বোচ্চ) `release/v*` ব্রাঞ্চে নিতে হবে।
|
||||
- হিমায়িত `release/vX.Y.Z` সেই জাহাজের রিলিজ ক্যাপ্টেনের অন্তর্গত।
|
||||
- পরবর্তী চক্রের `release/vX+1` হিমায়িত ডগা থেকে কাটা হয় যাতে অবদানকারীরা অবতরণ কাজ চালিয়ে যান।
|
||||
- খোলা PRs যে এখনও হিমায়িত শাখা লক্ষ্য করা উচিত** retargeted** সক্রিয় (সর্বোচ্চ) `release/v*` শাখায়।
|
||||
|
||||
আপনার কাঙ্ক্ষিত ব্রাঞ্চটি মার্জযোগ্য ধরে নেওয়ার আগে কোনো খোলা ফ্রিজ আছে কি না পরীক্ষা করুন:
|
||||
আপনি যে শাখাটি একত্রিত করতে চান তা অনুমান করার আগে একটি খোলা ফ্রিজের জন্য পরীক্ষা করুন:
|
||||
|
||||
```bash
|
||||
gh issue list --repo diegosouzapw/OmniRoute --label release-freeze --state open
|
||||
```
|
||||
|
||||
মার্জের প্রক্রিয়া (মালিকের `queue` লেবেল → Mergify) সম্পর্কে
|
||||
[MERGE_TRAIN.md](./MERGE_TRAIN.md)-এ নথিভুক্ত করা হয়েছে।
|
||||
মার্জ মেকানিক্স (মালিক `queue` লেবেল → Mergify) [MERGE_TRAIN.md](./MERGE_TRAIN.md) এ নথিভুক্ত করা হয়েছে।
|
||||
|
||||
> **2026-11-19: মার্জিফাই মার্জ কিউ অবসরপ্রাপ্ত** (মালিকের সিদ্ধান্ত)। `.mergify.yml` আর একটি সারি সংজ্ঞায়িত করে না এবং Mergify কমান্ডগুলিকে প্রত্যাখ্যান করে যা একটি পুল অনুরোধকে একত্রিত করে বা পুনর্লিখন করে। রিলিজ PRs রিপোজিটরি রুলসেট "সক্রিয় রিলিজে সবুজ গেটস প্রয়োজন" (`Gate / CI` + `Gate / Quality`) এর অধীনে হাত দ্বারা মার্জ করা হয় যতক্ষণ না ওমনি-কিউ লাইভ মোডে চলে এবং তার পরে ওমনি-কিউয়ের মাধ্যমে ( [OMNI_QUEUE.md](./OMNI_QUEUE.md) )। `queue` লেবেল আর কিছু মার্জ করে না।
|
||||
|
||||
## ব্রাঞ্চ এবং ট্যাগ—দুটিই কেন?
|
||||
|
||||
|
||||
@@ -4,10 +4,9 @@
|
||||
|
||||
---
|
||||
|
||||
v3.8.49 (quality/velocity পরিকল্পনার WS3.2/WS3.4) থেকে পর্যালোচিত PR-গুলোকে
|
||||
`release/vX.Y.Z`-এ মার্জ করার ডিফল্ট পথ হলো **Mergify merge queue** (`.mergify.yml`);
|
||||
নিচে নথিভুক্ত **manual merge-train** হলো FALLBACK — যা ইনসিডেন্ট, রিলিজ ফ্রিজের সময়,
|
||||
অথবা Mergify Open Source প্ল্যান কখনও পরিবর্তিত হলে ব্যবহৃত হয়।
|
||||
> **2026-11-19: মার্জিফাই মার্জ কিউ অবসরপ্রাপ্ত** (মালিকের সিদ্ধান্ত)। `.mergify.yml` আর একটি সারি সংজ্ঞায়িত করে না এবং Mergify কমান্ডগুলিকে প্রত্যাখ্যান করে যা একটি পুল অনুরোধকে একত্রিত করে বা পুনর্লিখন করে। রিলিজ PRs রিপোজিটরি রুলসেট "সক্রিয় রিলিজে সবুজ গেটস প্রয়োজন" (`Gate / CI` + `Gate / Quality`) এর অধীনে হাত দ্বারা মার্জ করা হয় যতক্ষণ না ওমনি-কিউ লাইভ মোডে চলে এবং তার পরে ওমনি-কিউয়ের মাধ্যমে ( [OMNI_QUEUE.md](./OMNI_QUEUE.md) )। নীচের মার্জিফাই বিভাগগুলি সারিটিকে বর্ণনা করে যেমন ছিল৷
|
||||
|
||||
যেহেতু v3.8.49 ( quality/velocity প্ল্যানের WS3.2/WS3.4 ) `release/vX.Y.Z` এ পর্যালোচনা করা PRs এর ডিফল্ট মার্জ পাথ হল** মার্জিফাই মার্জ কিউ** (`.mergify.yml`); দ** ম্যানুয়াল মার্জ-ট্রেন** ঘটনা, রিলিজ ফ্রিজ, অথবা Mergify ওপেন সোর্স প্ল্যান কখনও পরিবর্তনের সময় ব্যবহৃত FALLBACK — নীচে নথিভুক্ত করা হয়েছে।
|
||||
|
||||
## ডিফল্ট পথ: Mergify কিউ
|
||||
|
||||
|
||||
@@ -394,106 +394,70 @@ Radar ঘোষণা ইচ্ছাকৃতভাবে `active: false` স
|
||||
|
||||
---
|
||||
|
||||
## 3.9.0 LTS কাট (3.8.58-এ মহড়া করা হয়েছে)
|
||||
## 3.9.0 LTS কাট (3.8.58 এ রিহার্সাল করা হয়েছে)
|
||||
|
||||
v3.8.59-এর পরবর্তী সংস্করণ হলো 3.9.0, এবং এর tip থেকে দুটি দীর্ঘস্থায়ী branch তৈরি হবে:
|
||||
`stable/v3` (v3 LTS line, npm `latest`) এবং `develop` (v4, 4.0.0-এ উন্নীত, npm
|
||||
`nightly`)। Branch/channel মডেল, forward-port এবং label-গুলো
|
||||
[RELEASE_STRATEGY.md](./RELEASE_STRATEGY.md)-এ রয়েছে; পরিকল্পনাটি [ROADMAP](../../ROADMAP.md)-এ
|
||||
(Phase 3)। কাটটি একবারই চলে;
|
||||
3.8.58 একটি fork-এ শুরু থেকে শেষ পর্যন্ত এর মহড়া করে, এবং 3.8.59
|
||||
[GO/NO-GO checklist](./LTS_GO_NO_GO.md) দিয়ে সমাপ্ত হয়।
|
||||
v3.8.59-এর পরে পরবর্তী সংস্করণ হল 3.9.0, এবং এর টিপ দুটি দীর্ঘজীবী শাখায় পরিণত হয়: `stable/v3` (v3 LTS লাইন, npm `latest`) এবং `develop` (v4, 4.0.0-এ ধাক্কা দেওয়া, npm `nightly`)। branch/channel মডেল, ফরোয়ার্ড-পোর্ট এবং লেবেলগুলি [RELEASE_STRATEGY.md](./RELEASE_STRATEGY.md) ; পরিকল্পনাটি [ROADMAP](../../ROADMAP.md) এ রয়েছে (পর্যায় 3)। কাটা একবার সঞ্চালিত হয়; 3.8.58 এটি একটি কাঁটাচামচের উপর শেষ থেকে শেষ পর্যন্ত রিহার্সাল করে এবং 3.8.59 [GO/NO-GO চেকলিস্টের](./LTS_GO_NO_GO.md) সাথে বন্ধ হয়।
|
||||
|
||||
### Dry-run (শুধু-পঠন, যেকোনো সময় নিরাপদ)
|
||||
### ড্রাই-রান (কেবল-পঠন, যেকোনো সময় নিরাপদ)
|
||||
|
||||
```bash
|
||||
npm run release:dry-run-lts-cut # প্রকৃত কাট: HEAD থেকে 3.9.0, আগের tag v3.8.59
|
||||
npm run release:dry-run-lts-cut -- --from <3.9.0-tip> # source commit নির্দিষ্ট করুন
|
||||
npm run release:dry-run-lts-cut # the real cut: 3.9.0 from HEAD, previous tag v3.8.59
|
||||
npm run release:dry-run-lts-cut -- --from <3.9.0-tip> # pin the source commit
|
||||
```
|
||||
|
||||
`scripts/release/dry-run-lts-cut.mjs` কিছুই execute করে না: এটি git এবং `gh` পড়ে এবং
|
||||
সম্পূর্ণ sequence মুদ্রণ করে — precondition-গুলো (source resolve হয়, source repository-তে সম্পূর্ণ history আছে —
|
||||
একটি shallow clone `stable/v3` push করতে পারে না, receiving side প্রথম grafted parent-এই pack প্রত্যাখ্যান করে, তাই
|
||||
সম্পূর্ণ clone থেকে কাট করুন অথবা আগে `git fetch --unshallow origin` চালান — আগের
|
||||
tag বিদ্যমান, `package.json` target version-এ আছে, একটি `release-freeze` issue খোলা আছে, বিদ্যমান release branch-এ
|
||||
কোনো খোলা `Release branch not green` issue নেই
|
||||
— যে branch বিদ্যমান নয় সেটি `?` unknown হিসেবে রিপোর্ট করে, কখনো
|
||||
green নয় — Mergify `release` queue কনফিগার করা আছে (`queue_rules`, `checks_timeout`,
|
||||
label `queue`), `release/*` ruleset এখনও deletion এবং force-push আটকে রাখে, এবং
|
||||
`stable/v3` ও `develop` এখনও বিদ্যমান নয়), দুটি branch step, কোন dormant-workflow
|
||||
trigger এবং `if:` condition সত্য হবে (এবং কোনগুলো repository variable দ্বারা gated থাকবে অথবা
|
||||
canonical repository-তে pinned থাকবে), প্রত্যাশিত dist-tag (`latest` → 3.9.0, `next` এবং
|
||||
`nightly` খালি) এবং rollback। Exit `0` = `RESULT: READY`, `1` = একটি blocking precondition
|
||||
ব্যর্থ হয়েছে (`✗`), `2` = usage error। `--advisory <id,...>` কোনো check-কে warning (`!`)-এ
|
||||
নামিয়ে দেয়, কিন্তু সেটি আড়াল করে না।
|
||||
`scripts/release/dry-run-lts-cut.mjs` executes nothing: it reads git and `gh` and prints the whole sequence — preconditions (source resolves, the source repository has full history — a shallow clone cannot push `stable/v3`, the receiving side rejects the pack at the first grafted parent, so cut from a full clone or `git fetch --unshallow origin` first — previous tag exists, `package.json` is the target version, a `release-freeze` issue is open, no open `Release branch not green` issue on an existing release branch — a branch that does not exist reports `?` unknown, never green — omni-queue lands the release PRs (G11: `config/merge-queue/config.json` valid, its `bases` manage the release branch, `mode` `live`, its label exists), the `release/*` ruleset still blocks deletion and force-push, and `stable/v3` and `develop` do not exist yet), the two branch steps, which dormant-workflow triggers and `if:` conditions turn true (and which stay gated by a repository variable or pinned to the canonical repository), the expected dist-tags (`latest` → 3.9.0, `next` and `nightly` empty) and the rollback. Exit `0` = `RESULT: READY`, `1` = a blocking precondition failed (`✗`), `2` = usage error. `--advisory <id,...>` downgrades a check to a warning (`!`) without hiding it.
|
||||
|
||||
3.9.0 release freeze এখনও খোলা থাকতেই প্রকৃত cut-এর dry-run চালান — tag তৈরির
|
||||
পরে এবং Phase 12c freeze তুলে নেওয়ার আগে branch-গুলো তৈরি হয়।
|
||||
রিয়েল কাটের ড্রাই-রান চালান যখন 3.9.0 রিলিজ ফ্রিজ এখনও খোলা থাকে — ট্যাগের পরে এবং ফেজ 12c ফ্রিজ তুলে নেওয়ার আগে শাখাগুলি তৈরি হয়।
|
||||
|
||||
### 3.8.58 মহড়া (শুধু fork-এ)
|
||||
### 3.8.58 রিহার্সাল (শুধুমাত্র কাঁটা)
|
||||
|
||||
```bash
|
||||
# ১. মহড়ার parameter ব্যবহার করে বর্তমান tip-এ dry-run
|
||||
# 1. Dry-run on the current tip with rehearsal parameters
|
||||
npm run release:dry-run-lts-cut -- --target-version 3.8.58 --previous-tag v3.8.57 \
|
||||
--advisory freeze,base-green
|
||||
|
||||
# ২. একটি FORK remote-এর বিরুদ্ধে execute করুন (origin, অথবা যার URL canonical
|
||||
# repository, প্রত্যাখ্যাত হবে; প্রতিটি step terminal-এ confirmation চাইবে)
|
||||
# 2. Execute against a FORK remote (origin, or any remote whose URL is the canonical
|
||||
# repository, is refused; every step asks for confirmation on the terminal)
|
||||
git remote add rehearsal https://github.com/<you>/OmniRoute.git
|
||||
node scripts/release/dry-run-lts-cut.mjs --execute --remote rehearsal \
|
||||
--target-version 3.8.58 --previous-tag v3.8.57 --advisory freeze,base-green
|
||||
|
||||
# ৩. fork-এ dormant workflow-গুলো চালান (যেখানে dry-run canonical-repository pin
|
||||
# রিপোর্ট করে সেখানে workflow_dispatch ব্যবহার করুন), তারপর rollback করুন
|
||||
# 3. Exercise the dormant workflows in the fork (workflow_dispatch where the dry-run
|
||||
# reports a canonical-repository pin), then roll back
|
||||
node scripts/release/dry-run-lts-cut.mjs --execute --rollback --remote rehearsal \
|
||||
--target-version 3.8.58 --previous-tag v3.8.57 --advisory freeze,base-green
|
||||
```
|
||||
|
||||
develop bump commit-টি git plumbing ব্যবহার করে তৈরি হয় (কোনো working tree স্পর্শ করা হয় না) এবং
|
||||
cycle-open commit-এর মতো একই পাঁচটি file-এ bump করে: `package.json`, `open-sse/package.json`,
|
||||
`electron/package.json`, `package-lock.json` এবং `docs/openapi.yaml`। `[4.0.0]`
|
||||
CHANGELOG section এবং এর i18n mirror-গুলো পরে `develop`-এ খোলা হয়, এর প্রথম
|
||||
PR-এর আগে। Script কখনো npm dist-tag পরিবর্তন করে না — সেগুলো একটি scratch package-এ
|
||||
মহড়া করুন।
|
||||
ডেভেলপ বাম্প কমিট গিট প্লাম্বিং দিয়ে তৈরি করা হয়েছে (কোনও কাজের গাছকে স্পর্শ করা হয়নি) এবং সাইকেল-ওপেন কমিট হিসাবে একই পাঁচটি ফাইল বাম্প করে: `package.json`, `open-sse/package.json`, `electron/package.json`, `package-lock.json` এবং `docs/openapi.yaml`। `[4.0.0]` CHANGELOG বিভাগ এবং এর i18n আয়না `develop` এর পরে, প্রথম PR এর আগে খোলা হয়। স্ক্র্যাচ প্যাকেজে থাকা npm dist-tags — রিহার্সেল স্ক্রিপ্ট কখনই পরিবর্তন করে না।
|
||||
|
||||
### PR preview artifact (একবার build করুন, একই bytes promote করুন)
|
||||
### PR প্রিভিউ আর্টিফ্যাক্ট (একবার তৈরি করুন, একই বাইট প্রচার করুন)
|
||||
|
||||
`.github/workflows/preview-artifact.yml` একটি PR head থেকে একটি production tarball build করে এবং
|
||||
সেই exact build-টি validate করে (#8084 slice (a))। শুধু একই repository-র PR; কিছু publish করা হয় না।
|
||||
`.github/workflows/preview-artifact.yml` একটি PR হেড থেকে একটি প্রোডাকশন টারবল তৈরি করে এবং সঠিক বিল্ড (#8084 স্লাইস (a)) যাচাই করে। একই-রিপোজিটরি PRs শুধুমাত্র; কিছুই প্রকাশিত হয় না।
|
||||
|
||||
```bash
|
||||
gh workflow run preview-artifact.yml -f pr_number=<N> # অথবা `preview-artifact` label যোগ করুন
|
||||
gh workflow run preview-artifact.yml -f pr_number=<N> # or add the `preview-artifact` label
|
||||
gh run download <run-id> --name preview-artifact-pr<N>-<sha7> --dir preview
|
||||
cd preview && sha256sum -c SHA256SUMS
|
||||
gh attestation verify omniroute-*.tgz --repo diegosouzapw/OmniRoute
|
||||
npm install -g ./omniroute-*.tgz # preview install
|
||||
```
|
||||
|
||||
Run-টি `npm ci`, `npm run build:release`, `npm run check:pack-artifact` চালায়, tarball
|
||||
pack করে, `npm run check:pack-boot` চালায় (fake secret, ephemeral data dir), পুনরায়
|
||||
pack করে এবং digest অভিন্ন না হলে ব্যর্থ হয়, তারপর `artifact-identity.json` রেকর্ড করে (head SHA, base
|
||||
SHA, lockfile hash, platform, arch, node ABI, bundler, build policy —
|
||||
`scripts/release/artifact-identity.mjs`) এবং একটি পৃথক job-এ tarball attest করে। Preview promote করার
|
||||
অর্থ হলো সেই tarball install করা: source থেকে কখনো পুনরায় build করবেন না।
|
||||
রান `npm ci`, `npm run build:release`, `npm run check:pack-artifact`, টারবল প্যাক করে, `npm run check:pack-boot` চালায় (জাল গোপনীয়তা, ক্ষণস্থায়ী ডেটা ডির), পুনরায় প্যাক করে এবং ব্যর্থ হয় যদি না ডাইজেস্ট অভিন্ন হয়, তারপর `artifact-identity.json` রেকর্ড করে (হেড SHA, বেস SHA, লকফাইল ABI, বিল্ড প্ল্যাটফর্ম, প্ল্যাটফর্ম নকল — `scripts/release/artifact-identity.mjs`) এবং একটি পৃথক কাজে টারবলকে সত্যায়িত করে। একটি পূর্বরূপ প্রচার করার অর্থ হল সেই টারবল ইনস্টল করা: উত্স থেকে কখনও পুনর্নির্মাণ করবেন না৷
|
||||
|
||||
### কাট (3.9.0, GO-এর পরে)
|
||||
### কাট (3.9.0, GO পরে)
|
||||
|
||||
1. [LTS_GO_NO_GO.md](./LTS_GO_NO_GO.md)-এ GO রেকর্ড করা হয়েছে।
|
||||
2. `npm run release:dry-run-lts-cut -- --from v3.9.0` `RESULT: READY` মুদ্রণ করে।
|
||||
3. dry-run যে command-গুলো মুদ্রণ করে, সেগুলো ব্যবহার করে `origin`-এ branch-গুলো হাতে তৈরি করুন —
|
||||
script `origin`-এ push করতে অস্বীকার করে। পর্যালোচনা করা develop commit পুনর্ব্যবহার করতে, প্রথমে
|
||||
আপনার fork-এর বিরুদ্ধে 3.9.0 tip-এ `--execute` rehearsal চালান; এটি উভয় SHA মুদ্রণ করে, এবং
|
||||
একই commit-গুলো push করা যায়:
|
||||
1. GO [LTS_GO_NO_GO.md](./LTS_GO_NO_GO.md) এ রেকর্ড করা হয়েছে।
|
||||
2. `npm run release:dry-run-lts-cut -- --from v3.9.0` `RESULT: READY` প্রিন্ট করে।
|
||||
3. ড্রাই-রান প্রিন্ট — স্ক্রিপ্ট `origin` এ ঠেলে দিতে অস্বীকার করে কমান্ড দিয়ে `origin` তে শাখা তৈরি করুন। রিভিউ করা ডেভেলপ কমিট পুনরায় ব্যবহার করতে, প্রথমে আপনার ফর্কের বিপরীতে 3.9.0 টিপে `--execute` রিহার্সাল চালান; এটি উভয় SHAs প্রিন্ট করে, এবং একই কমিটগুলিকে ধাক্কা দেওয়া যেতে পারে:
|
||||
|
||||
```bash
|
||||
git push origin <stable-sha>:refs/heads/stable/v3 <develop-sha>:refs/heads/develop
|
||||
```
|
||||
|
||||
4. প্রথম PR আসার আগেই `stable/v3` এবং `develop` সুরক্ষিত করুন (রুলসেট + মার্জ কিউ)।
|
||||
5. নিষ্ক্রিয় ওয়ার্কফ্লোগুলি ব্রাঞ্চের অস্তিত্বের ভিত্তিতে সক্রিয় হয়: `forward-port.yml` (`stable/v3`-এ পুশ), `validate-stable-pr.yml` (`stable/v3`-এর জন্য PR) এবং `nightly-v4-build.yml` (`develop` বিল্ড করে)। গো-লাইভের আগে, রিপোজিটরি সিক্রেট `secrets.FORWARD_PORT_TOKEN` সেট করুন (যাতে CI forward-port PR-গুলিতে চলে); মালিক রিপোজিটরি ভেরিয়েবল `vars.NIGHTLY_PUBLISH`-কে `true` সেট না করা এবং npm Trusted Publishing `nightly-v4-build.yml` গ্রহণ না করা পর্যন্ত নাইটলি প্রকাশনা বন্ধ থাকবে। চ্যানেল নির্ধারণ করে `scripts/release/dist-tag.mjs`; `npm-publish.yml` একই রিজলভার ব্যবহার করে।
|
||||
6. চ্যানেলগুলি যাচাই করুন: `npm view omniroute dist-tags --json` দেখায় যে `latest` = 3.9.0 এবং v4 প্রকাশিত না হওয়া পর্যন্ত কোনো `next` / `nightly` নেই।
|
||||
7. প্রয়োজন হলে রোলব্যাক করুন: `git push origin --delete refs/heads/stable/v3 refs/heads/develop`
|
||||
এবং `npm dist-tag add omniroute@3.8.59 latest`।
|
||||
4. প্রথম PR ল্যান্ড করার আগে `stable/v3` এবং `develop` (রুলসেট + মার্জ কিউ) রক্ষা করুন।
|
||||
5. সুপ্ত কর্মপ্রবাহগুলি শাখার অস্তিত্ব দ্বারা চালু হয়: `forward-port.yml` ( `stable/v3` এ ঠেলে), `validate-stable-pr.yml` (PRs থেকে `stable/v3`) এবং `nightly-v4-build.yml` ( `develop` তৈরি করে)। গো-লাইভ করার আগে, `secrets.FORWARD_PORT_TOKEN` রিপোজিটরি সিক্রেট সেট করুন (তাই CI ফরওয়ার্ড-পোর্ট PRs এ চলে); রাত্রিকালীন প্রকাশনা বন্ধ থাকে যতক্ষণ না মালিক রিপোজিটরি ভেরিয়েবল `vars.NIGHTLY_PUBLISH` `true` এ সেট না করে এবং npm বিশ্বস্ত প্রকাশনা `nightly-v4-build.yml` গ্রহণ করে। চ্যানেল রেজোলিউশন হল `scripts/release/dist-tag.mjs`, একই রেজোলিউর `npm-publish.yml` ব্যবহার করে।
|
||||
6. চ্যানেলগুলি যাচাই করুন: `npm view omniroute dist-tags --json` `latest` = 3.9.0 দেখায় এবং v4 প্রকাশ না হওয়া পর্যন্ত `next` / `nightly` নয়৷
|
||||
7. রোলব্যাক, যদি প্রয়োজন হয়: `git push origin --delete refs/heads/stable/v3 refs/heads/develop` এবং `npm dist-tag add omniroute@3.8.59 latest`।
|
||||
|
||||
---
|
||||
|
||||
|
||||
@@ -137,33 +137,20 @@ check এবং restart একই command-এ রাখুন।
|
||||
|
||||
## হোস্টেড লেন (GitHub-হোস্টেড রানার)
|
||||
|
||||
repository-টি `cheaper-inference` organization-এর অন্তর্গত, **Team** প্ল্যানে: **60টি সমসাময়িক হোস্টেড জব**, যা organization-এর প্রতিটি repository, প্রতিটি PR চেক, প্রতিটি push-ট্রিগারড workflow এবং CodeQL-এর ডিফল্ট সেটআপের মধ্যে ভাগ করা হয়। নিচের পরিসংখ্যানগুলো **Pro** প্ল্যানে (40টি সমসাময়িক হোস্টেড জব) পরিমাপ করা হয়েছিল। 2026-10-18 তারিখে
|
||||
একটি merge campaign চলাকালে (`release/v3.8.52`-এ ঘণ্টায় ~10টি merge) পরিমাপ করা হয়েছে: **24 ঘণ্টায়
|
||||
2,500টি workflow run তৈরি হয়েছে**, 6 ঘণ্টায় branch-টিতে 44টি push হয়েছে, এবং PR চেকগুলো
|
||||
ঘণ্টার পর ঘণ্টা অপেক্ষা করার সময় **106টি হোস্টেড জব queued ছিল** ও সেগুলো ছাড়াই PR merge করা হয়েছিল।
|
||||
branch-টিতে প্রতিটি push-এর সময় নয়টি workflow চালু হতো:
|
||||
ভান্ডারটি `cheaper-inference` সংস্থার অন্তর্গত** দল** পরিকল্পনা:** 60টি সমসাময়িক হোস্ট করা চাকরি** , সংস্থার প্রতিটি সংগ্রহস্থল, প্রতিটি PR চেক, প্রতিটি পুশ-ট্রিগার করা ওয়ার্কফ্লো এবং CodeQL এর ডিফল্ট সেটআপ দ্বারা ভাগ করা হয়েছে। নীচের পরিসংখ্যান পরিমাপ করা হয়েছে** প্রো** পরিকল্পনা (40 সমসাময়িক হোস্টেড কাজ)। 2026-10-18 তারিখে একটি মার্জ ক্যাম্পেইনের সময় পরিমাপ করা হয়েছে (~ 10 merges/hour on `release/v3.8.52`):** 24 ঘন্টায় 2,500 ওয়ার্কফ্লো চলে** , 44টি 6 ঘন্টার মধ্যে শাখায় ধাক্কা দেয়,** 106টি হোস্ট করা চাকরি সারিবদ্ধ** যখন PR চেকগুলি ঘন্টার জন্য অপেক্ষা করেছিল এবং PRs তাদের ছাড়াই একত্রিত হয়েছিল৷ শাখায় প্রতিটি ধাক্কায় নয়টি কর্মপ্রবাহ গুলি করা হয়েছে:
|
||||
|
||||
| `release/v*`-এ প্রতি push | হোস্টেড জব | চাপের সময় ফলাফল | 2026-10-18 থেকে |
|
||||
| ------------------------------------------- | ----------: | ------------------------------------------------------------------ | ------------------------------------------------------------------------------- |
|
||||
| `ci.yml` (সম্পূর্ণ matrix) | সর্বোচ্চ 30 | পরবর্তী push-এ বাতিল, এক দিনে 24টির মধ্যে 24টিই | `release/**` push-এ শুরু হয় না (PR run + Release-Green) |
|
||||
| `quality.yml` | ~6 | বাতিল, 23টির মধ্যে 23টিই | `release/**` push-এ শুরু হয় না |
|
||||
| `Release-Green` `--quick` | 0 | `omni-build`-এ চলেছে, 100টির মধ্যে 97টি বাতিল | `omni-release` slot, কখনো বাতিল হয় না, pending run একত্রিত হয় |
|
||||
| `Lock released branch`, `OpenSSF Scorecard` | 2 | প্রতি push-এ একটি queued run | প্রতি ref-এ একটি run (`tests/unit/build/hosted-lane-concurrency.test.ts`) |
|
||||
| `Release acceptance` (shadow report) | 1 | প্রতি push-এ একটি হোস্টেড `npm ci`, কখনো বাতিল হয় না | অপরিবর্তিত — একটি `paths:` filter-এর উপযুক্ত প্রার্থী |
|
||||
| `Publish to Docker Hub` → `Deploy to VPS` | 2 | প্রতি push-এ বাতিল; amd64 leg `omni-build`-এ প্রতিযোগিতা করে | অপরিবর্তিত — মালিকের deploy channel |
|
||||
| CodeQL ডিফল্ট সেটআপ (`dynamic`) | 4 | প্রতি push-এ `javascript-typescript`, `actions`, `c-cpp`, `python` | অপরিবর্তিত — Settings → Code security; `c-cpp`/`python` এখানে কিছুই scan করে না |
|
||||
| `release/v*` প্রতি ধাক্কা | হোস্ট করা চাকরি | ঝড় অধীনে ফলাফল | 2026-10-18 থেকে |
|
||||
| ------------------------------------------- | --------------: | ------------------------------------------------------------------ | ---------------------------------------------------------------------------------- |
|
||||
| `ci.yml` (সম্পূর্ণ ম্যাট্রিক্স) | 30 পর্যন্ত | পরবর্তী ধাক্কায় বাতিল করা হয়েছে, একদিনে 24টির মধ্যে 24টি৷ | `release/**` pushes এ শুরু হয়নি (PR রান + রিলিজ-সবুজ) |
|
||||
| `quality.yml` | ~6 | বাতিল করা হয়েছে, 23টির মধ্যে 23টি | `release/**` pushes শুরু হয়নি |
|
||||
| `Release-Green` `--quick` | 0 | `omni-build` তে চলেছিল, 100টির মধ্যে 97টি বাতিল হয়েছে | `omni-release` স্লট, কখনই বাতিল হয়নি, মুলতুবি রান ধসে |
|
||||
| `Lock released branch`, `OpenSSF Scorecard` | 2 | প্রতি ধাক্কায় এক সারিবদ্ধ রান | রেফ প্রতি এক রান (`tests/unit/build/hosted-lane-concurrency.test.ts`) |
|
||||
| `Release acceptance` (ছায়া রিপোর্ট) | 1 | প্রতি ধাক্কায় একটি হোস্টেড `npm ci`, কখনই বাতিল হয় না | একটি `paths:` ফিল্টারের জন্য অপরিবর্তিত — প্রার্থী |
|
||||
| `Publish to Docker Hub` → `Deploy to VPS` | 2 | ধাক্কা প্রতি বাতিল; amd64 leg `omni-build` তে প্রতিদ্বন্দ্বিতা করে | অপরিবর্তিত — মালিকের স্থাপন চ্যানেল |
|
||||
| CodeQL ডিফল্ট সেটআপ (`dynamic`) | 4 | `javascript-typescript`, `actions`, `c-cpp`, `python` প্রতি ধাক্কা | অপরিবর্তিত — সেটিংস → কোড নিরাপত্তা; `c-cpp`/`python` এখানে কিছুই স্ক্যান করবেন না |
|
||||
|
||||
`tests/unit/build/push-storm-diet.test.ts`, `ci.yml` এবং `quality.yml`-এর শুধু-`main`
|
||||
push trigger স্থিরভাবে নিশ্চিত করে। পার্শ্বপ্রতিক্রিয়া: Codecov আর প্রতি release push-এ base upload
|
||||
পায় না (ধাপটি কেবল তথ্যমূলক এবং `continue-on-error`); repository-এর অভ্যন্তরীণ coverage gate এবং
|
||||
PR comment প্রভাবিত হয় না।
|
||||
`tests/unit/build/push-storm-diet.test.ts` `ci.yml` এবং `quality.yml` এর `main` -only পুশ ট্রিগার পিন করে। পার্শ্ব প্রতিক্রিয়া: কোডকভ আর রিলিজ পুশ প্রতি একটি বেস আপলোড পায় না (পদক্ষেপটি তথ্যমূলক এবং `continue-on-error`); ইন-রেপো কভারেজ গেট এবং PR মন্তব্য প্রভাবিত হয় না।
|
||||
|
||||
**আরও self-hosted capacity হোস্টেড queue-এর সমস্যার সমাধান করে না।** devbox
|
||||
(`devbox-vm-06-dev002`, 24 vCPU / 54 GB)-এ একটি runner হোস্ট করা সম্ভব, কিন্তু agent session-গুলো
|
||||
ইতিমধ্যেই এর load 20–26-এ রাখে, agent container-এ কোনো Docker daemon নেই, এবং যে লেনটি
|
||||
পূর্ণ ক্ষমতায় চলছে সেটি হলো হোস্টেড লেন। একই সময়ে `.113` box-এ 71 GB খালি জায়গা ছিল এবং
|
||||
load ছিল 5–8; এর সীমাবদ্ধতা CPU নয়, বরং উপরের প্রতি-listener memory budget (সর্বোচ্চ 6টি listener)।
|
||||
বাকি করণীয়গুলো প্রক্রিয়াভিত্তিক: Mergify queue-এর মাধ্যমে campaign PR merge করুন
|
||||
(`label=queue`, batch-গুলো প্রতি PR-এ একটি run এবং প্রতি push-এ আরেকটি run-এর পরিবর্তে একটি
|
||||
`merge_group` CI run ভাগ করে নেয়), CodeQL ডিফল্ট-সেটআপের language-গুলো কমিয়ে দিন, এবং
|
||||
`release-acceptance.yml` যে file-গুলো পড়ে সেগুলোর ভিত্তিতে এটিকে filter করুন।
|
||||
**বেশি স্ব-হোস্টেড ক্ষমতা হোস্ট করা সারি ঠিক করে না।** ডেভবক্স (`devbox-vm-06-dev002`, 24 vCPU / 54 GB) একজন রানারকে হোস্ট করতে পারে, কিন্তু এজেন্ট সেশনগুলি ইতিমধ্যেই এর লোড 20-26 এ রাখে, এজেন্ট কন্টেইনারে কোন Docker ডেমন নেই, এবং স্যাচুরেটেড লেন হোস্ট করা হয়। `.113` বক্সে 71 GB বিনামূল্যে এবং একই মুহূর্তে 5-8 লোড ছিল; এর সীমাবদ্ধতা হল প্রতি-শ্রোতার মেমরি বাজেট উপরে (সিলিং 6 শ্রোতা), CPU নয়। অবশিষ্ট লিভারগুলি হল প্রক্রিয়া: মার্জিফাই সারির মাধ্যমে ল্যান্ড ক্যাম্পেইন PRs (`label=queue`, ব্যাচগুলি শেয়ার করে এক `merge_group` CI রান প্রতি PR প্লাস প্রতি ধাক্কায় এক রানের পরিবর্তে), CodeQL ডিফল্ট-সেটআপ ল্যাঙ্গুয়েজগুলি ট্রিম করুন এবং এটি পড়া ফাইলগুলির দ্বারা `release-acceptance.yml` ফিল্টার করুন৷
|
||||
|
||||
> **2026-11-19: মার্জিফাই মার্জ কিউ অবসরপ্রাপ্ত** (মালিকের সিদ্ধান্ত)। `.mergify.yml` আর একটি সারি সংজ্ঞায়িত করে না এবং Mergify কমান্ডগুলিকে প্রত্যাখ্যান করে যা একটি পুল অনুরোধকে একত্রিত করে বা পুনর্লিখন করে। রিলিজ PRs রিপোজিটরি রুলসেট "সক্রিয় রিলিজে সবুজ গেটস প্রয়োজন" (`Gate / CI` + `Gate / Quality`) এর অধীনে হাত দ্বারা মার্জ করা হয় যতক্ষণ না ওমনি-কিউ লাইভ মোডে চলে এবং তার পরে ওমনি-কিউয়ের মাধ্যমে ( [OMNI_QUEUE.md](./OMNI_QUEUE.md) )। উপরের Mergify লিভারটি আর বিদ্যমান নেই।
|
||||
|
||||
@@ -23,7 +23,7 @@ istog sistema nezavisan od alata, pogledajte
|
||||
|
||||
CI i Quality Gates radni tok svaki daje stabilnu presudu: `Gate / CI` i `Gate / Quality`. Njihova verzionirana politika prijema nabraja svaki prethodni posao prema potrebi ili savjetu. Primjenjivi traženi posao mora uspjeti: nedostaje, otkazan, preskočen, na čekanju i nepoznati rezultati ne mogu uspostaviti PASS. Važeća klasifikacija samo za dokumente ili samo za katalog može učiniti traku koda neprimjenjivom; nacrt PR nije prihvaćen kandidat. `hotfix` oznaka ne odustaje od dokaza.
|
||||
|
||||
Oba toka rada pokrivaju PRs u main/release grane, potiskuje u `main`, ručno otpremanje i događaje spajanja grupe. Push, dispatch i merge-group pokreću punu selekciju. Guranje na `release/**` ih ne pokreće (2026-10-18): svaka promjena je već pokrenula matricu na svom PR i spojena kombinacija je Release-Green-ov posao (`docs/ops/RUNNER_BOX.md` → Hosted lane). Forks i grupe spajanja koriste hostovane trkače za poslove koji inače biraju samo-hostovane runnere; dovoljan hostovani kapacitet se mora provjeriti prije uvođenja.
|
||||
Oba toka rada pokrivaju PRs u main/release grane, potiskuje u `main`, ručno otpremanje i događaje spajanja grupe. Push, dispatch i merge-group pokreću punu selekciju. Guranje na `release/**` ih ne pokreće (2026-10-18): svaka promjena je već pokrenula matricu na svom PR i spojena kombinacija je Release-Green-ov posao (`docs/ops/RUNNER_BOX.md` → Hosted lane). Forks i stapanje grupe koriste hostovane runnere za poslove koji inače biraju samo-hostovane runnere; dovoljan hostovani kapacitet se mora provjeriti prije uvođenja.
|
||||
|
||||
Običan PR pokreće brzu selekciju. `full-code` i `full-code-e2e` trake politike prijema (E2E, integracija, artefakt paketa, Electron smoke, Bun SQLite, klijenti ekosistema i protokola) pokreću se samo na nacrtu reda za spajanje ili na punom pokretanju: `gh workflow run ci.yml --ref <branch>`.
|
||||
|
||||
@@ -31,6 +31,8 @@ Svaki JSON račun identifikuje odjavljeni SHA, radni tok i pokušaj. CLI odbija
|
||||
|
||||
### Red za spajanje
|
||||
|
||||
> **2026-11-19: Red spajanja Mergeify je povučen** (odluka vlasnika). `.mergify.yml` više ne definira red i odbija naredbe za spajanje koje spajaju ili prepisuju zahtjev za povlačenjem. Izdanja PRs se spajaju ručno pod skupom pravila spremišta "Zahtijevajte zelene kapije na aktivnom izdanju" (`Gate / CI` + `Gate / Quality`) dok se omni-red ne pokrene u živom modu, a nakon toga kroz omni-red ( [OMNI_QUEUE.md](../ops/OMNI_QUEUE.md) ). Rukovanje tijekom posla sa nacrtima za spajanje opisano u nastavku je još uvijek u `ci.yml` i `quality.yml`, ali nijedan skica za spajanje više nije otvoren.
|
||||
|
||||
Oznaka `queue` šalje PR u red za spajanje (`.mergify.yml`). Objedinjavanje otvara nacrt PR na `mergify/merge-queue/` grani, CI tamo pokreće punu selekciju, a originalni PR se spaja kada `Gate / CI`, `Gate / Quality` i `Merge integrity (changelog + generated skills)` prođu.
|
||||
|
||||
Mergify upisuje svoj sažetak reda u opis nacrta, a druge aplikacije ga također mogu uređivati. Događaj `pull_request` `edited` na takvom nacrtu uzima sopstvenu grupu konkurentnosti (`-queue-edit-<run_id>`) tako da ne može otkazati stvarno pokretanje nacrta i preskače kapiju i matricu. Samo `Merge integrity` još uvijek radi. Posao preskočenih vrata nosi drugačije ime provjere, jer Mergify čita preskočeni `Gate / CI` kao neuspješnu provjeru i iz reda stavlja PR.
|
||||
@@ -39,7 +41,7 @@ Nakon dequeua, push ne stavlja uvijek u red PR. Komentirajte `@mergifyio queue`
|
||||
|
||||
### Zadržani dokazi u reduktoru prihvata
|
||||
|
||||
`scripts/quality/validate-release-acceptance.mjs` smanjuje isporučeni plan i njegove manifeste; ne utvrđuje da plan pokriva kompletan cevovod za oslobađanje. Njegovi izvještaji eksplicitno postavljaju `releaseAcceptance: false`, čak i kada je taj plan `VERIFIED`. `release-acceptance.yml` radni tok još uvijek koristi sjenčane postavke, a ne priznanice o stvarnoj izgradnji, paketu, pokretanju ili promociji.
|
||||
`scripts/quality/validate-release-acceptance.mjs` smanjuje isporučeni plan i njegove manifeste; ne utvrđuje da plan pokriva kompletan cevovod za oslobađanje. Njegovi izvještaji eksplicitno postavljaju `releaseAcceptance: false`, čak i kada je taj plan `VERIFIED`. `release-acceptance.yml` radni tok i dalje koristi sjenčane postavke, a ne priznanice stvarne izrade, paketa, pokretanja ili promocije.
|
||||
|
||||
CLI zahtijeva `--evidence-root` da provjeri zadržane dokaze. Datoteke se rješavaju kao `<evidence-root>/<artifact_id>/<member>` i heširaju kao SHA-256. PASS zapis bez dokaza, datoteka koja nedostaje ili je promijenjena, nesigurna putanja ili simbolična veza sprječava verifikaciju. Fajlovi koji nedostaju nisu ekvivalentni praznim uspješnim zapisnicima. Postojeće SHA/run/attempt provjere ostaju nezavisne: odgovarajući bajtovi ne mogu spasiti zastarjeli račun. Integritet datoteke nije dokaz autentičnosti izvršenja ili promocije artefakta.
|
||||
|
||||
@@ -89,7 +91,7 @@ Radi na svakom PR do `main`. Blokovi se spajaju u slučaju kvara.
|
||||
| `check:lockfile` | `package-lock.json` integritet — https registar, hešovi integriteta, bez zamjene hosta | Da |
|
||||
| `check:licenses` | lista dopuštenja SPDX licence za ovisnosti o proizvodnji | Da |
|
||||
| `check:tracked-artifacts` | Nema artefakata građenja / učinjenih `node_modules` simboličnih veza (također radi u husky pre-commit; pre-push je namjerno lagan — #6716) | Da |
|
||||
| `check:ai-attribution` | Nema prikolice AI/bot `Co-Authored-By` ili podnožja AI-generacije u PR urezivanja, naslova ili tijela — Hard Rule #16 (u `quality.yml` petlji brzih vrata za PR→ `release/**` — čita sadržaj događaja, no-op off PRs — i korak samo za PR za `ci.yml` PR `main` također `commit-msg` → hook dozvoljeni koautori #14436 |
|
||||
| `check:ai-attribution` | Nema prikolice AI/bot `Co-Authored-By` ili podnožja AI-generacije u PR urezivanja, naslova ili tijela — Hard Rule #16 (u `quality.yml` petlji brzih vrata za PR→ `release/**` — čita sadržaj događaja, no `commit-msg` op off PRs — i korak samo za PR `main` `ci.yml` PR→#14436 koautori; |
|
||||
| `check:vitest-exclusions` | Svako Vitest izuzimanje imenuje problem praćenja i pojavljuje se u `config/quality/vitest-exclusions.json` (#13204) | Da |
|
||||
| `check:file-size` | Izvorni fajlovi (`.ts`/`.tsx` u `src/`, `open-sse/`, `electron/`, `bin/`) ostaju unutar `cap` a test fajlovi (`*.test.ts(x)`) unutar `testCap`; datoteke zamrznute u `file-size-baseline.json` (`frozen` / `testFrozen`) ne smiju prerasti svoju snimljenu veličinu | Da |
|
||||
| `check:error-helper` | Odgovori na greške u executors/handlers koriste `buildErrorBody()` / `sanitizeErrorMessage()` (tvrdo pravilo #12) | Da |
|
||||
@@ -104,7 +106,7 @@ Radi na svakom PR do `main`. Blokovi se spajaju u slučaju kvara.
|
||||
| `check:provider-asset-provenance` | Provajder logos/assets nosi zabilježeni unos porijekla |
|
||||
| `lint:json` | JSON konfiguracijske datoteke analiziraju i zadovoljavaju pravila repo linta |
|
||||
| `typecheck:core` | TypeScript kompilacija bez grešaka (samo savjetodavna upozorenja) | Da |
|
||||
| `typecheck:noimplicit:core` | Strogi `noImplicitAny` — usmjeren prema budućnosti; mnogim već postojećim lokacijama za pozive i dalje su potrebne napomene | **Savjetodavno** (`continue-on-error: true`) |
|
||||
| `typecheck:noimplicit:core` | Strogi `noImplicitAny` — usmjeren prema budućnosti; mnogim već postojećim stranicama za pozive i dalje su potrebne napomene | **Savjetodavno** (`continue-on-error: true`) |
|
||||
| `check:dashboard-typecheck` | `tsc` u opsegu do `src/app/(dashboard)/**` (#7033) — `typecheck:core`-ova kurirana lista dozvoljenih datoteka od 27 datoteka ne uključuje nijednu kontrolnu tablu TSX, a `next build` ni nju nikada ne provjerava (`next.config.mjs` postavlja `ignoreBuildErrors: true`), tako da su regresije siročeta identifikatora tamo (#6625/#6909CI bile nevidljive. Diffs u odnosu na zamrznutu osnovnu liniju brojanja per-file/per-TS-code (`config/quality/dashboard-typecheck-baseline.json`, isti obrazac zastarjele primjene kao `check:known-symbols`) — samo NEW greške izvan osnovnog brojanja ne uspijevaju na kapiji; zategnite `--update` kada se popravi već postojeća greška. | Da |
|
||||
| `check:build-typecheck` | Provjera tipa proizvodnje cijele aplikacije preko `tsconfig.build.json` (`src`, `open-sse`, `packages`, `bin`, `scripts`, `electron/**/*.d.ts`), površinske `typecheck:core` liste dopuštenih od 27 datoteka i kapije kontrolne ploče ne pokrivaju. Diffs against `config/quality/build-typecheck-baseline.json`; novi ili povećan broj po (datoteci, kodu) ne uspijeva, manji broj traži od vas da zategnete. `--update` odbija dok run sadrži novi ili podignuti par osim ako `--force-regressions` nije proslijeđen, i odbija novo utišani fajl osim ako se ne prođe `--force-nocheck`, tako da su proširenje osnovne linije kako bi se dobilo zeleno i davanje trajne tišine dva odvojena namjerna čina. Goli `--force` je odbijen. Također skenira opseg izgradnje za `@ts-nocheck` protiv `config/quality/ts-nocheck-baseline.json`, jer datoteka koja ga koristi ne prijavljuje nikakvu dijagnostiku i inače bi bila nevidljiva za svaku kapiju. | Da |
|
||||
|
||||
@@ -232,7 +234,7 @@ Bez razlučive baze (bez `BASE_SHA`/`BASE_REF`, bez lokalnog `origin/release/v<v
|
||||
|
||||
| Skripta | Validates | Blokiranje |
|
||||
| --------------------------------- | -------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | -------------------------- |
|
||||
| `check-ui-keys-coverage` (inline) | UI i18n pokrivenost ključem je ≥ 65% | Da (oba načina) |
|
||||
| `check-ui-keys-coverage` (inline) | UI i18n ključna pokrivenost je ≥ 65% | Da (oba načina) |
|
||||
| `check:ui-icu` | Svaka poruka svakog UI kataloga kompajlira se sa `IntlMessageFormat` | Da (oba načina) |
|
||||
| `check-ui-value-drift` (inline) | Prepisani engleski** vrijednost** ne ostavlja zastarjeli prijevod iza sebe | Da (samo način otpuštanja) |
|
||||
| `check-new-key-coverage` (inline) | A** novo** Engleski ključ se prevodi u svakom lokalu — `__MISSING__:` marker je odbijen | Da (samo način otpuštanja) |
|
||||
@@ -247,11 +249,11 @@ PR koji i dalje mijenja kataloge lokalizacije u `pr` modu (val prijevoda, osvje
|
||||
|
||||
Jedinični testovi pariteta lokalizacije (`cli-i18n-catalog`, `i18n-pt-br`, `i18n-vi-completeness`, `i18n-placeholder-parity`) prate iste modove kroz `tests/_helpers/localeParityMode.ts`: u `pr` modu preskaču tvrdnje pariteta ključeva i ostavljaju za oslobađanje osvježavanje pariteta rezerviranog mjesta ključeva čiji se engleski promijenio od baze spajanja (svaki ključ kada zadatak testa jedinica ne može pročitati plitko odjavljivanje). Taj pomagač je** samo** sankcionisani režim-uslovno preskakanje: `check:test-masking` broji `.skip(` i `{ skip: true }`, ali ne i izračunati `{ skip: "<reason>" }` koji vraća, tako da `tests/unit/locale-parity-mode.test.ts` prikačuje listu testova kojima je dozvoljeno da ga koristi — dodavanjem jednog je recenzirana izmena na tu listu.
|
||||
|
||||
#### `check-ui-value-drift` — stale-translation kapija
|
||||
#### `check-ui-value-drift` — stale-translation gate
|
||||
|
||||
Hvata jednu i18n regresiju koju druge kapije strukturno ne mogu vidjeti: engleska vrijednost je prepisana i prijevodi izvedeni iz _prethodnog_ engleskog ostaju iza, tako da korisnici koji nisu engleski nastavljaju čitati samouvjereno napisanu, sada pogrešnu kopiju.
|
||||
|
||||
Ovo je stvarno poslano. `oauthModal.googleOAuthWarning` je ponovo napisan kada je Antigravity pomoćnik za prijavu sletio (#5203);** 39 od 43 lokala** zadržao tekst koji govori operaterima da "kopiraju cijeli URL i zalijepe ga ispod" — tok koji se ne može završiti za tog provajdera. Prošlo je nezapaženo do #8463 jer:
|
||||
Ovo je stvarno poslano. `oauthModal.googleOAuthWarning` je ponovo napisan kada je Antigravity pomoćnik za prijavu sletio (#5203);** 39 od 43 lokaliteta** zadržao tekst koji govori operaterima da "kopiraju cijeli URL i zalijepe ga ispod" — tok koji se ne može završiti za tog provajdera. Prošlo je nezapaženo do #8463 jer:
|
||||
|
||||
- `sync-ui-keys` popunjava samo ključeve koji su** odsutan** , nikad one koje jesu** ustajao** ;
|
||||
- `check-ui-keys-coverage` broji ključno _prisutnost_, tako da se zastarjeli prijevod smatra pokrivenim;
|
||||
@@ -264,7 +266,7 @@ Dva načina da se to zadovolji:
|
||||
1. ažurirati zahvaćene prijevode, ili
|
||||
2. postavite ih na `__MISSING__:<new english>` — vrijeme izvođenja tada služi ispravljeni engleski (`src/i18n/request.ts::deepMergeFallback`, #7258) i redove ključeva za prijevod.
|
||||
|
||||
Ako je niz** značenje** promijenio, preferiram** preimenovanje ključa** : novi ključ ne može naslijediti zastarjeli prijevod. To je obrazac #8463 koji se koristi.
|
||||
Ako je niz** značenje** promijenio, preferiram** preimenovanje ključa** : novi ključ ne može naslijediti zastarjeli prijevod. To je obrazac koji se koristio #8463.
|
||||
|
||||
```bash
|
||||
npm run i18n:check-value-drift # strict (what CI runs)
|
||||
@@ -276,15 +278,15 @@ Izlazi iz 0 sa `SKIP reason=base-unresolved` kada se osnovni katalog ne može pr
|
||||
|
||||
### Posao: `i18n`
|
||||
|
||||
Potpuna i18n matrica validacije (jedan posao po lokalizaciji). Cijeli posao je savjetodavan.
|
||||
Potpuna i18n matrica valjanosti (jedan posao po lokalizaciji). Cijeli posao je savjetodavan.
|
||||
|
||||
| Skripta | Validates | Blokiranje |
|
||||
| ------------------------------- | ------------------------------------- | ------------------------------------------------------------- |
|
||||
| `validate_translation.py quick` | Kompletnost prijevoda po lokalizaciji | **Savjetodavno** (`continue-on-error: true` na cijelom poslu) |
|
||||
| Skripta | Validates | Blokiranje |
|
||||
| ------------------------------- | ----------------------------------- | ------------------------------------------------------------- |
|
||||
| `validate_translation.py quick` | Kompletnost prijevoda po lokalitetu | **Savjetodavno** (`continue-on-error: true` na cijelom poslu) |
|
||||
|
||||
### Posao: `pr-test-policy`
|
||||
|
||||
Radi samo na zahtjevima za povlačenje.
|
||||
Radi samo na zahtjevima za povlačenjem.
|
||||
|
||||
| Skripta | Validates | Blokiranje |
|
||||
| ---------------------- | ------------------------------------------------------------------------------------------------------------------------------------- | ---------- |
|
||||
|
||||
@@ -37,21 +37,23 @@ flowchart LR
|
||||
|
||||
`main` nije grana za svakodnevnu integraciju. PR-ovi otvoreni prema `main` obično zahtijevaju promjenu ciljane grane prije spajanja.
|
||||
|
||||
## Zamrzavanje izdanja (paralelni ciklusi)
|
||||
## Pusti zamrzavanje (paralelni ciklusi)
|
||||
|
||||
Kada se izdanje usklađuje, otvara se marker issue sa oznakom `release-freeze`. To **ne zaustavlja razvoj**:
|
||||
Kada se izdanje usaglašava, otvara se problem markera označen `release-freeze`. To** ne zaustavlja razvoj** :
|
||||
|
||||
- Zamrznuta `release/vX.Y.Z` pripada kapetanu izdanja za tu isporuku.
|
||||
- Sljedeći ciklus `release/vX+1` se kreira iz zamrznutog vrha kako bi saradnici mogli nastaviti sa radom.
|
||||
- Otvoreni PR-ovi koji i dalje ciljaju zamrznutu granu trebaju biti **preusmjereni** na aktivnu (najvišu) `release/v*` granu.
|
||||
- Zamrznuti `release/vX.Y.Z` pripada kapetanu koji je otpustio taj brod.
|
||||
- `release/vX+1` sljedećeg ciklusa se isječe od smrznutog vrha tako da saradnici nastavljaju s radom.
|
||||
- Otvoreni PRs koji još uvijek ciljaju zamrznutu granu bi trebao biti** retargeted** na aktivnu (najvišu) `release/v*` granu.
|
||||
|
||||
Provjerite da li postoji otvoreno zamrzavanje prije nego što pretpostavite da je grana koju želite spojiva:
|
||||
Provjerite postoji li otvoreno zamrzavanje prije nego pretpostavite da je grana koju želite spojiva:
|
||||
|
||||
```bash
|
||||
gh issue list --repo diegosouzapw/OmniRoute --label release-freeze --state open
|
||||
```
|
||||
|
||||
Mehanika spajanja (vlasnik `queue` oznaka → Mergify) je dokumentovana u [MERGE_TRAIN.md](./MERGE_TRAIN.md).
|
||||
Mehanika spajanja (vlasnik `queue` label → Mergify) je dokumentirana u [MERGE_TRAIN.md](./MERGE_TRAIN.md).
|
||||
|
||||
> **2026-11-19: Red spajanja Mergeify je povučen** (odluka vlasnika). `.mergify.yml` više ne definira red i odbija naredbe za spajanje koje spajaju ili prepisuju zahtjev za povlačenjem. Izdanja PRs se spajaju ručno pod skupom pravila spremišta "Zahtijevajte zelene kapije na aktivnom izdanju" (`Gate / CI` + `Gate / Quality`) dok se omni-red ne pokrene u živom modu, a nakon toga kroz omni-red ( [OMNI_QUEUE.md](./OMNI_QUEUE.md) ). Oznaka `queue` više ništa ne spaja.
|
||||
|
||||
## Zašto i grana i oznaka (tag)?
|
||||
|
||||
|
||||
@@ -4,10 +4,9 @@
|
||||
|
||||
---
|
||||
|
||||
Od v3.8.49 (WS3.2/WS3.4 plana kvaliteta/brzine), zadani put spajanja
|
||||
pregledanih PR-ova u `release/vX.Y.Z` jeste **Mergify red za spajanje** (`.mergify.yml`);
|
||||
**ručni voz za spajanje** dokumentovan u nastavku predstavlja REZERVNU OPCIJU — koristi se tokom incidenata,
|
||||
zamrzavanja izdanja ili ako se Mergify Open Source plan ikada promijeni.
|
||||
> **2026-11-19: Red spajanja Mergeify je povučen** (odluka vlasnika). `.mergify.yml` više ne definira red i odbija naredbe za spajanje koje spajaju ili prepisuju zahtjev za povlačenjem. Izdanja PRs se spajaju ručno pod skupom pravila spremišta "Zahtijevajte zelene kapije na aktivnom izdanju" (`Gate / CI` + `Gate / Quality`) dok se omni-red ne pokrene u živom modu, a nakon toga kroz omni-red ( [OMNI_QUEUE.md](./OMNI_QUEUE.md) ). Odjeljci za spajanje ispod opisuju red čekanja kakav je bio.
|
||||
|
||||
Od v3.8.49 (WS3.2/WS3.4 plana quality/velocity ) zadana staza stapanja za pregledani PRs u `release/vX.Y.Z` je** Spoji red spajanja** (`.mergify.yml`); the** ručno spajanje** dole je dokumentovan FALLBACK — koji se koristi tokom incidenata, zamrzavanja izdanja ili ako se plan Mergify Open Source ikada promeni.
|
||||
|
||||
## Zadana putanja: Mergify red čekanja
|
||||
|
||||
|
||||
@@ -355,112 +355,70 @@ Prije objavljivanja bilo kojeg izdanja v3.8.x, provjerite i sljedeće stavke:
|
||||
|
||||
---
|
||||
|
||||
## Izdvajanje 3.9.0 LTS-a (uvježbano u 3.8.58)
|
||||
## 3.9.0 LTS cut (uvježbano u 3.8.58)
|
||||
|
||||
Nakon v3.8.59 sljedeća verzija je 3.9.0, a njen vrh postaje osnova za dvije dugotrajne grane:
|
||||
`stable/v3` (v3 LTS linija, npm `latest`) i `develop` (v4, povećana na 4.0.0, npm
|
||||
`nightly`). Model grana/kanala, prosljeđivanje izmjena i oznake nalaze se u
|
||||
[RELEASE_STRATEGY.md](./RELEASE_STRATEGY.md); plan se nalazi u dokumentu [ROADMAP](../../ROADMAP.md) (faza 3). Izdvajanje se izvršava jednom;
|
||||
3.8.58 ga uvježbava od početka do kraja na forku, a 3.8.59 se zaključuje pomoću
|
||||
[GO/NO-GO kontrolne liste](./LTS_GO_NO_GO.md).
|
||||
Nakon v3.8.59 sljedeća verzija je 3.9.0, a njen vrh postaje dvije dugovječne grane: `stable/v3` (linija v3 LTS, npm `latest`) i `develop` (v4, nabačena na 4.0.0, npm `nightly`). branch/channel model, naprijed-port i oznake su u [RELEASE_STRATEGY.md](./RELEASE_STRATEGY.md) ; plan je u [ROADMAP](../../ROADMAP.md) (faza 3). Rez se izvodi jednom; 3.8.58 se uvježbava od kraja do kraja na račvanju, a 3.8.59 se zatvara sa [GO/NO-GO kontrolnom listom](./LTS_GO_NO_GO.md).
|
||||
|
||||
### Probno pokretanje (samo za čitanje, sigurno u bilo kojem trenutku)
|
||||
### Rad na suho (samo za čitanje, siguran u bilo koje vrijeme)
|
||||
|
||||
```bash
|
||||
npm run release:dry-run-lts-cut # stvarno izdvajanje: 3.9.0 iz HEAD-a, prethodna oznaka v3.8.59
|
||||
npm run release:dry-run-lts-cut -- --from <3.9.0-tip> # fiksiraj izvorni commit
|
||||
npm run release:dry-run-lts-cut # the real cut: 3.9.0 from HEAD, previous tag v3.8.59
|
||||
npm run release:dry-run-lts-cut -- --from <3.9.0-tip> # pin the source commit
|
||||
```
|
||||
|
||||
`scripts/release/dry-run-lts-cut.mjs` ne izvršava ništa: čita git i `gh` te ispisuje
|
||||
cijeli slijed — preduslove (izvor se može razriješiti, izvorni repozitorij ima potpunu historiju —
|
||||
plitki klon ne može poslati `stable/v3`, prijemna strana odbija paket kod prvog
|
||||
naknadno spojenog roditelja, stoga prvo izvršite izdvajanje iz potpunog klona ili
|
||||
`git fetch --unshallow origin` — prethodna oznaka postoji, `package.json` sadrži ciljnu
|
||||
verziju, otvoren je problem `release-freeze`, nema otvorenog problema
|
||||
`Release branch not green`
|
||||
na postojećoj grani izdanja — grana koja ne postoji prijavljuje `?` kao nepoznato, nikada
|
||||
kao zeleno — Mergify red `release` je konfigurisan (G11: `queue_rules`, `checks_timeout`,
|
||||
oznaka `queue`), skup pravila `release/*` i dalje blokira brisanje i prisilno slanje, a
|
||||
`stable/v3` i `develop` još ne postoje), dva koraka za grane, koji se okidači neaktivnih tokova rada
|
||||
i `if:` uslovi aktiviraju (a koji ostaju blokirani varijablom repozitorija ili
|
||||
fiksirani na kanonski repozitorij), očekivane dist-oznake (`latest` → 3.9.0, `next` i
|
||||
`nightly` prazne) i vraćanje na prethodno stanje. Izlazni kod `0` = `RESULT: READY`,
|
||||
`1` = blokirajući preduslov nije ispunjen (`✗`), `2` = greška upotrebe.
|
||||
`--advisory <id,...>` spušta nivo provjere na upozorenje (`!`) bez njenog skrivanja.
|
||||
`scripts/release/dry-run-lts-cut.mjs` ne izvršava ništa: čita git i `gh` i ispisuje cijeli niz — preduslova (izvor rješava, izvorno spremište ima punu historiju — plitki klon ne može gurati `stable/v3`, strana koja prima paket odbija paket na prvom cijepljenom roditelju, tako da se izrezuje iz punog klona ili `git fetch --unshallow origin` postoji prva ciljna verzija —, `package.json` `release-freeze` prethodna verzija otvoren, nema otvorenog problema `Release branch not green` na postojećoj grani izdanja — grana koja ne postoji prijavljuje `?` nepoznato, nikad zeleno — omni-red postavlja izdanje PRs (G11: `config/merge-queue/config.json` valjan, njegov `bases` upravlja granom izdanja, `mode` `live`, njegova oznaka postoji), `release/*` pravila još uvijek blokira brisanje i `stable/v3` još ne postoji grana, i `develop` još ne postoji. koji okidači toka rada u mirovanju i `if:` uslovi postaju istiniti (i koji ostaju zatvoreni promenljivom spremišta ili zakačeni za kanonsko spremište), očekivane dist-tagove (`latest` → 3.9.0, `next` i `nightly` prazni) i vraćanje unazad. Izađi `0` = `RESULT: READY`, `1` = neuspješan preduslov za blokiranje (`✗`), greška upotrebe `2` =. `--advisory <id,...>` snižava ček na upozorenje (`!`) bez skrivanja.
|
||||
|
||||
Pokrenite probno pokretanje stvarnog izdvajanja dok je zamrzavanje izdanja 3.9.0 još aktivno — grane se
|
||||
kreiraju nakon oznake i prije nego što faza 12c ukine zamrzavanje.
|
||||
Pokrenite suhi rad stvarnog rezanja dok je zamrzavanje izdanja 3.9.0 još otvoreno — se grane stvaraju nakon oznake i prije nego što faza 12c ukloni zamrzavanje.
|
||||
|
||||
### Proba 3.8.58 (samo fork)
|
||||
### 3.8.58 proba (samo viljuške)
|
||||
|
||||
```bash
|
||||
# 1. Probno pokretanje na trenutnom vrhu s parametrima probe
|
||||
# 1. Dry-run on the current tip with rehearsal parameters
|
||||
npm run release:dry-run-lts-cut -- --target-version 3.8.58 --previous-tag v3.8.57 \
|
||||
--advisory freeze,base-green
|
||||
|
||||
# 2. Izvrši nad FORK udaljenim repozitorijem (origin ili bilo koji udaljeni repozitorij čiji je URL
|
||||
# kanonski repozitorij se odbija; svaki korak traži potvrdu u terminalu)
|
||||
# 2. Execute against a FORK remote (origin, or any remote whose URL is the canonical
|
||||
# repository, is refused; every step asks for confirmation on the terminal)
|
||||
git remote add rehearsal https://github.com/<you>/OmniRoute.git
|
||||
node scripts/release/dry-run-lts-cut.mjs --execute --remote rehearsal \
|
||||
--target-version 3.8.58 --previous-tag v3.8.57 --advisory freeze,base-green
|
||||
|
||||
# 3. Isprobaj neaktivne tokove rada u forku (workflow_dispatch tamo gdje probno pokretanje
|
||||
# prijavi fiksiranje na kanonski repozitorij), a zatim vrati prethodno stanje
|
||||
# 3. Exercise the dormant workflows in the fork (workflow_dispatch where the dry-run
|
||||
# reports a canonical-repository pin), then roll back
|
||||
node scripts/release/dry-run-lts-cut.mjs --execute --rollback --remote rehearsal \
|
||||
--target-version 3.8.58 --previous-tag v3.8.57 --advisory freeze,base-green
|
||||
```
|
||||
|
||||
Commit povećanja verzije na grani develop izrađuje se pomoću git plumbing komandi (radno stablo se ne mijenja) i ažurira
|
||||
istih pet datoteka kao commit otvaranja ciklusa: `package.json`, `open-sse/package.json`,
|
||||
`electron/package.json`, `package-lock.json` i `docs/openapi.yaml`. Odjeljak `[4.0.0]`
|
||||
u CHANGELOG-u i njegove i18n kopije otvaraju se na grani `develop` nakon toga, prije njenog prvog
|
||||
PR-a. Skripta nikada ne mijenja npm dist-oznake — uvježbajte ih na privremenom paketu.
|
||||
Urezivanje bump-a za razvoj je izgrađeno pomoću git-a (nijedno radno stablo se ne dira) i izbacuje istih pet fajlova kao urezivanje sa otvorenim ciklusom: `package.json`, `open-sse/package.json`, `electron/package.json`, `package-lock.json` i `docs/openapi.yaml`. `[4.0.0]` CHANGELOG odjeljak i njegova i18n ogledala se otvaraju na `develop` nakon toga, prije njegovog prvog PR. Skripta nikada ne mijenja npm dist-tagove — uvježbava one na scratch paketu.
|
||||
|
||||
### Artefakt za pregled PR-a (izgradite jednom, promovirajte iste bajtove)
|
||||
### PR preview artefakt (napravi jednom, promovira iste bajtove)
|
||||
|
||||
`.github/workflows/preview-artifact.yml` izrađuje jednu produkcijsku tarball arhivu iz vrha PR-a i
|
||||
provjerava upravo tu izgradnju (dio (a) zadatka #8084). Samo PR-ovi iz istog repozitorija; ništa se ne objavljuje.
|
||||
`.github/workflows/preview-artifact.yml` gradi jedan produkcijski tarball iz PR glave i potvrđuje tu tačnu konstrukciju (#8084 slice (a)). Samo PRs spremišta; ništa nije objavljeno.
|
||||
|
||||
```bash
|
||||
gh workflow run preview-artifact.yml -f pr_number=<N> # ili dodaj oznaku `preview-artifact`
|
||||
gh workflow run preview-artifact.yml -f pr_number=<N> # or add the `preview-artifact` label
|
||||
gh run download <run-id> --name preview-artifact-pr<N>-<sha7> --dir preview
|
||||
cd preview && sha256sum -c SHA256SUMS
|
||||
gh attestation verify omniroute-*.tgz --repo diegosouzapw/OmniRoute
|
||||
npm install -g ./omniroute-*.tgz # instalacija pregleda
|
||||
npm install -g ./omniroute-*.tgz # preview install
|
||||
```
|
||||
|
||||
Pokretanje izvršava `npm ci`, `npm run build:release`, `npm run check:pack-artifact`, pakuje
|
||||
tarball arhivu, pokreće `npm run check:pack-boot` (lažne tajne, privremeni direktorij podataka), ponovo je pakuje i
|
||||
ne uspijeva ako sažetak nije identičan, a zatim bilježi `artifact-identity.json` (SHA vrha, SHA baze,
|
||||
hash datoteke zaključavanja, platformu, arhitekturu, node ABI, alat za objedinjavanje, pravila izgradnje —
|
||||
`scripts/release/artifact-identity.mjs`) i potvrđuje tarball arhivu u zasebnom poslu. Promoviranje
|
||||
pregleda znači instaliranje te tarball arhive: nikada je nemojte ponovo izgrađivati iz izvornog koda.
|
||||
The run does `npm ci`, `npm run build:release`, `npm run check:pack-artifact`, packs the tarball, runs `npm run check:pack-boot` (fake secrets, ephemeral data dir), re-packs and fails unless the digest is identical, then records `artifact-identity.json` (head SHA, base SHA, lockfile hash, platform, arch, node ABI, bundler, build policy — `scripts/release/artifact-identity.mjs`) and attests the tarball in a separate job. Promoting a preview means installing that tarball: never rebuild from source.
|
||||
|
||||
### Izdvajanje (3.9.0, nakon odluke GO)
|
||||
### Rez (3.9.0, nakon GO)
|
||||
|
||||
1. Odluka GO zabilježena je u [LTS_GO_NO_GO.md](./LTS_GO_NO_GO.md).
|
||||
1. GO snimljeno u [LTS_GO_NO_GO.md](./LTS_GO_NO_GO.md).
|
||||
2. `npm run release:dry-run-lts-cut -- --from v3.9.0` ispisuje `RESULT: READY`.
|
||||
3. Ručno kreirajte grane na `origin` pomoću komandi koje ispiše probno pokretanje —
|
||||
skripta odbija slanje na `origin`. Da biste ponovo koristili pregledani develop commit, prvo pokrenite
|
||||
probu s opcijom `--execute` na vrhu 3.9.0 prema svom forku; ona ispisuje oba SHA-a, a
|
||||
isti commitovi mogu se poslati:
|
||||
3. Kreirajte grane na `origin` ručno pomoću komandi suho pokretanje ispisuje — skripta odbija gurnuti u `origin`. Da biste ponovo koristili revidirani razvojni urezivanje, prvo pokrenite `--execute` probu na tipu 3.9.0 na svom viljušku; ispisuje oba SHAs, a isto urezivanje se može gurati:
|
||||
|
||||
```bash
|
||||
git push origin <stable-sha>:refs/heads/stable/v3 <develop-sha>:refs/heads/develop
|
||||
```
|
||||
|
||||
4. Zaštitite `stable/v3` i `develop` (skupovi pravila + red čekanja za spajanje) prije nego što se spoji prvi PR.
|
||||
5. Neaktivni radni tokovi uključuju se postojanjem grane: `forward-port.yml` (slanje na
|
||||
`stable/v3`), `validate-stable-pr.yml` (PR-ovi prema `stable/v3`) i `nightly-v4-build.yml`
|
||||
(izgradnje za `develop`). Prije puštanja u rad postavite repozitorijsku tajnu `secrets.FORWARD_PORT_TOKEN` (kako bi se CI pokretao za
|
||||
PR-ove za prijenos unaprijed); noćno objavljivanje ostaje isključeno dok vlasnik ne postavi repozitorijsku
|
||||
varijablu `vars.NIGHTLY_PUBLISH` na `true` i dok npm Trusted Publishing ne prihvati
|
||||
`nightly-v4-build.yml`. Određivanje kanala vrši `scripts/release/dist-tag.mjs`, isti
|
||||
razrješivač koji koristi `npm-publish.yml`.
|
||||
6. Provjerite kanale: `npm view omniroute dist-tags --json` prikazuje `latest` = 3.9.0 i nema
|
||||
`next` / `nightly` dok se v4 ne objavi.
|
||||
7. Vraćanje na prethodno stanje, ako bude potrebno: `git push origin --delete refs/heads/stable/v3 refs/heads/develop`
|
||||
i `npm dist-tag add omniroute@3.8.59 latest`.
|
||||
4. Zaštitite `stable/v3` i `develop` (red za spajanje skupova pravila + ) prije nego što prvi PR sleti.
|
||||
5. Neaktivni tokovi posla se uključuju prema postojanju grane: `forward-port.yml` (push to `stable/v3`), `validate-stable-pr.yml` (PRs to `stable/v3`) i `nightly-v4-build.yml` (gradi `develop`). Prije pokretanja uživo, postavite tajnu `secrets.FORWARD_PORT_TOKEN` spremišta (tako da CI radi na naprijed-portu PRs); noćno objavljivanje ostaje isključeno sve dok vlasnik ne postavi varijablu spremišta `vars.NIGHTLY_PUBLISH` na `true` i npm Pouzdano objavljivanje prihvati `nightly-v4-build.yml`. Rezolucija kanala je `scripts/release/dist-tag.mjs`, isti rezolver koji koristi `npm-publish.yml`.
|
||||
6. Provjerite kanale: `npm view omniroute dist-tags --json` prikazuje `latest` = 3.9.0 i nema `next` / `nightly` dok se v4 ne objavi.
|
||||
7. Vraćanje, ako je potrebno: `git push origin --delete refs/heads/stable/v3 refs/heads/develop` i `npm dist-tag add omniroute@3.8.59 latest`.
|
||||
|
||||
---
|
||||
|
||||
|
||||
@@ -137,36 +137,22 @@ odjednom, samo kada nije aktivan**, pri čemu provjera neaktivnosti i ponovno po
|
||||
minute da se smjesti na tmpfs i 2 minute da se otpremi s diska.
|
||||
- VPS `.15` namijenjen je samo homologaciji — na njemu se nikada ne pokreću CI runneri.
|
||||
|
||||
## Hostovana traka (izvršioci koje hostuje GitHub)
|
||||
## Hostirana traka (trkači hostovani na GitHubu)
|
||||
|
||||
Repozitorij pripada organizaciji `cheaper-inference`, na **Team** planu: **60
|
||||
istovremenih hostovanih poslova**, koje dijele svi repozitoriji u organizaciji, sve PR provjere,
|
||||
svi radni tokovi pokrenuti slanjem izmjena i zadana postavka za CodeQL. Brojke u nastavku izmjerene su na
|
||||
**Pro** planu (40 istovremenih hostovanih poslova). Izmjereno 2026-10-18 tokom
|
||||
kampanje spajanja (~10 spajanja/sat na `release/v3.8.52`): **2.500 izvršavanja radnih tokova kreirano je
|
||||
za 24 h**, 44 slanja izmjena na granu za 6 h, **106 hostovanih poslova na čekanju**, dok su PR provjere čekale
|
||||
satima, a PR-ovi su spajani bez njih. Devet radnih tokova pokretalo se pri svakom slanju izmjena na granu:
|
||||
Repozitorijum pripada `cheaper-inference` organizaciji, na** Tim** plan:** 60 istovremeno hostiranih poslova** , koji dijeli svako spremište u organizaciji, svaka PR provjera, svaki tok posla pokrenut i CodeQL-ova zadana postavka. Cifre ispod su izmjerene na** Pro** plan (40 istovremeno hostiranih poslova). Izmjereno 18.10.2026. tokom kampanje spajanja (~ 10 merges/hour na `release/v3.8.52`):** 2.500 pokretanja toka posla kreirano za 24 h** , 44 guranja do grane za 6 h,** 106 hostovanih poslova na čekanju** dok su PR provjere čekale satima i PRs su spojeni bez njih. Devet tokova posla je pokrenuto pri svakom pritisku na granu:
|
||||
|
||||
| po slanju izmjena na `release/v*` | hostovani poslovi | ishod tokom navale | od 2026-10-18 |
|
||||
| ------------------------------------------- | ----------------: | ----------------------------------------------------------------------- | ------------------------------------------------------------------------------------ |
|
||||
| `ci.yml` (puna matrica) | do 30 | otkazano sljedećim slanjem izmjena, 24 od 24 u jednom danu | ne pokreće se pri slanjima na `release/**` (PR izvršavanje + Release-Green) |
|
||||
| `quality.yml` | ~6 | otkazano, 23 od 23 | ne pokreće se pri slanjima na `release/**` |
|
||||
| `Release-Green` `--quick` | 0 | izvršeno na `omni-build`, otkazano 97 od 100 | `omni-release` mjesto, nikad se ne otkazuje, objedinjuje izvršavanja na čekanju |
|
||||
| `Lock released branch`, `OpenSSF Scorecard` | 2 | jedno izvršavanje na čekanju po slanju izmjena | jedno izvršavanje po ref-u (`tests/unit/build/hosted-lane-concurrency.test.ts`) |
|
||||
| `Release acceptance` (izvještaj u sjeni) | 1 | jedan hostovani `npm ci` po slanju izmjena, nikad se ne otkazuje | nepromijenjeno — kandidat za `paths:` filter |
|
||||
| `Publish to Docker Hub` → `Deploy to VPS` | 2 | otkazano po slanju izmjena; amd64 dio se nadmeće na `omni-build` | nepromijenjeno — vlasnikov kanal za implementaciju |
|
||||
| Zadana postavka za CodeQL (`dynamic`) | 4 | `javascript-typescript`, `actions`, `c-cpp`, `python` po slanju izmjena | nepromijenjeno — Settings → Code security; `c-cpp`/`python` ovdje ništa ne skeniraju |
|
||||
| po push to `release/v*` | hosted jobs | ishod pod olujom | od 2026-10-18 |
|
||||
| ------------------------------------------- | ----------: | ------------------------------------------------------------- | ----------------------------------------------------------------------------------- |
|
||||
| `ci.yml` (puna matrica) | do 30 | otkazan sljedećim pritiskom, 24 od 24 u danu | nije pokrenut na `release/**` pushes (PR run + Release-Green) |
|
||||
| `quality.yml` | ~6 | otkazan, 23 od 23 | nije pokrenut na `release/**` guranje |
|
||||
| `Release-Green` `--quick` | 0 | pokrenut na `omni-build`, otkazan 97 od 100 | `omni-release` slot, nikad otkazan, na čekanju se sruši |
|
||||
| `Lock released branch`, `OpenSSF Scorecard` | 2 | jedno trčanje u redu po potisku | jedna vožnja po ref (`tests/unit/build/hosted-lane-concurrency.test.ts`) |
|
||||
| `Release acceptance` (izvještaj u senci) | 1 | jedan hosted `npm ci` po push, nikad otkazan | nepromijenjen — kandidat za `paths:` filter |
|
||||
| `Publish to Docker Hub` → `Deploy to VPS` | 2 | poništeno po guranje; amd64 noga se takmiči na `omni-build` | nepromijenjen kanal raspoređivanja vlasnika — |
|
||||
| zadana postavka CodeQL (`dynamic`) | 4 | `javascript-typescript`, `actions`, `c-cpp`, `python` po push | nepromijenjena — Postavke → Sigurnost koda; `c-cpp`/`python` ne skenira ništa ovdje |
|
||||
|
||||
`tests/unit/build/push-storm-diet.test.ts` učvršćuje okidač za slanje izmjena samo na `main` za `ci.yml` i
|
||||
`quality.yml`. Nuspojava: Codecov više ne prima osnovno otpremanje pri svakom slanju izmjena za izdanje (taj
|
||||
korak je informativan i koristi `continue-on-error`); provjera pokrivenosti unutar repozitorija i PR komentar
|
||||
nisu pogođeni.
|
||||
`tests/unit/build/push-storm-diet.test.ts` pričvršćuje `main` -only push okidač za `ci.yml` i `quality.yml`. Nuspojava: Codecov više ne prima osnovni upload po guranju izdanja (korak je informativni i `continue-on-error`); kapija pokrivenosti u repo-u i PR komentar su nepromijenjeni.
|
||||
|
||||
**Dodatni samostalno hostovani kapacitet ne rješava red čekanja hostovane trake.** Razvojni računar
|
||||
(`devbox-vm-06-dev002`, 24 vCPU / 54 GB) mogao bi hostovati izvršioca, ali sesije agenata već
|
||||
održavaju njegovo opterećenje na 20–26, kontejner agenta nema Docker demon, a zasićena je
|
||||
hostovana traka. `.113` računar je u istom trenutku imao 71 GB slobodnog prostora i opterećenje 5–8; njegovo
|
||||
ograničenje je prethodno navedeni memorijski budžet po slušaocu (najviše 6 slušalaca), a ne CPU. Preostale
|
||||
mogućnosti su procesne: spojiti PR-ove kampanje putem Mergify reda (`label=queue`, grupe dijele
|
||||
jedno `merge_group` CI izvršavanje umjesto jednog izvršavanja po PR-u plus jednog po slanju izmjena), smanjiti broj jezika
|
||||
u zadanoj postavci za CodeQL i filtrirati `release-acceptance.yml` prema datotekama koje čita.
|
||||
**Više samostalnog hostinga ne popravlja hostirani red čekanja.** Devbox (`devbox-vm-06-dev002`, 24 vCPU / 54 GB) može ugostiti pokretač, ali sesije agenta već drže svoje opterećenje na 20–26, kontejner agenta nema Docker demona, a zasićena traka je hostovana. `.113` kutija je imala 71 GB slobodno i opterećenje 5–8 u istom trenutku; njegovo ograničenje je viši budžet memorije po slušaocu (gornja granica od 6 slušalaca), a ne CPU. Preostale poluge su procesne: uzemite kampanju PRs kroz red čekanja za spajanje (`label=queue`, grupe dijele jedno `merge_group` CI pokretanje umjesto jednog pokretanja po PR plus jedno po guranje), skraćivanje jezika za zadano podešavanje CodeQL -a i filtriranje `release-acceptance.yml` prema datotekama koje čita.
|
||||
|
||||
> **2026-11-19: Red spajanja Mergeify je povučen** (odluka vlasnika). `.mergify.yml` više ne definira red i odbija naredbe za spajanje koje spajaju ili prepisuju zahtjev za povlačenjem. Izdanja PRs se spajaju ručno pod skupom pravila spremišta "Zahtijevajte zelene kapije na aktivnom izdanju" (`Gate / CI` + `Gate / Quality`) dok se omni-red ne pokrene u živom modu, a nakon toga kroz omni-red ( [OMNI_QUEUE.md](./OMNI_QUEUE.md) ). Gore navedena poluga Mergify više ne postoji.
|
||||
|
||||
@@ -25,10 +25,12 @@ Oba pracovní postupy pokrývají PRs do větví main/release, push to `main`, r
|
||||
|
||||
Rychlý výběr spustí běžná PR. Pruhy `full-code` a `full-code-e2e` politiky přístupu (E2E, integrace, artefakt balíčku, Electron smoke, Bun SQLite, klienti ekosystému a protokolu) běží pouze na konceptu fronty Mergify nebo na úplném spuštění: `gh workflow run ci.yml --ref <branch>`.
|
||||
|
||||
Každá účtenka JSON identifikuje odhlášenou SHA, běh pracovního postupu a pokus. CLI odmítne nesoulad checkout/event SHA. Testy pracovního postupu vážou členství v zásadách k seznamu `needs` úlohy verdiktu, takže nový nebo odstraněný pruh nemůže tiše zmizet. Potvrzení pokrývá jejich vlastní pracovní postup, nikoli publikaci, nasazení nebo vnitřní části stávajícího poradenského skeneru. Aktivace obou kontrolních jmen v pravidlech pobočky je samostatnou administrativní změnou; přidání těchto úloh samo o sobě nechrání pobočku.
|
||||
Každá účtenka JSON identifikuje odhlášenou SHA, běh pracovního postupu a pokus. CLI odmítne nesoulad checkout/event SHA. Testy pracovního postupu vážou členství v zásadě k seznamu `needs` úlohy verdiktu, takže nový nebo odstraněný pruh nemůže tiše zmizet. Potvrzení pokrývá jejich vlastní pracovní postup, nikoli publikaci, nasazení nebo vnitřní části stávajícího poradenského skeneru. Aktivace obou kontrolních jmen v pravidlech pobočky je samostatnou administrativní změnou; přidání těchto úloh samo o sobě nechrání pobočku.
|
||||
|
||||
### Sloučit frontu
|
||||
|
||||
> **2026-11-19: fronta sloučení Mergify je vyřazena** (rozhodnutí vlastníka). `.mergify.yml` již nedefinuje frontu a odmítá příkazy Mergify, které slučují nebo přepisují požadavek na stažení. Vydání PRs jsou sloučena ručně pod sadou pravidel úložiště "Vyžadovat zelené brány u aktivního vydání" (`Gate / CI` + `Gate / Quality`), dokud omni-queue běží v živém režimu, a poté prostřednictvím omni-queue ( [OMNI_QUEUE.md](../ops/OMNI_QUEUE.md) ). Pracovní postup zpracování konceptů Mergify popsané níže je stále v `ci.yml` a `quality.yml`, ale žádný koncept Mergify již není otevřen.
|
||||
|
||||
Štítek `queue` odešle PR do fronty Mergify (`.mergify.yml`). Mergify otevře koncept PR ve větvi `mergify/merge-queue/`, CI tam spustí úplný výběr a původní PR se sloučí, když projdou `Gate / CI`, `Gate / Quality` a `Merge integrity (changelog + generated skills)`.
|
||||
|
||||
Mergify zapíše svůj souhrn fronty do popisu konceptu a další aplikace ho mohou také upravit. Událost `pull_request` `edited` na takovém konceptu má svou vlastní skupinu souběžnosti (`-queue-edit-<run_id>`), takže nemůže zrušit skutečný běh konceptu a přeskočí bránu a matici. Stále běží pouze `Merge integrity`. Úloha přeskočené brány nese jiný název kontroly, protože Mergify čte přeskočené `Gate / CI` jako neúspěšnou kontrolu a z fronty PR.
|
||||
@@ -47,7 +49,7 @@ Verzovaný inventář npm-alias a členství ve statickém skenování fungují
|
||||
|
||||
Použijte `npm run quality:scan -- --list` nebo `npm run quality:scan:fast -- --list` ke kontrole vybraných aliasů bez jejich provedení. Runtime vyvolá vstupní bod npm, takže jeho runtime (včetně Bun pokud je nakonfigurováno) je zachováno. Manifest zaznamenává aliasy mimo tyto profily, které jsou vyvolány samostatně, a příkazy údržby jsou v profilech skenování pouze pro čtení zakázány.
|
||||
|
||||
Tyto profily pokrývají pouze statické skenování. Necertifikují testy produktů, pokrytí, balení, externí kontroly ani úplné přijetí kandidáta na vydání. Přijetí pracovního postupu používá propojené `config/quality/admission-policy.json` a `scripts/quality/admission-verdict.mjs`. Profily pozorovatele uvolnění zůstávají oddělené; nezávisle kontrolovat jejich příslušné šeky a účtenky. Úplné statické příkazy pozorovatele jsou deklarovány v `config/quality/release-green-static-profile.json`, včetně `audit:deps`, výběru testu mutace a kontroly překladu. Zavaděč ověřuje příkazy npm proti package.json a modelovaným deklaracím CI/Quality ; odmítá drift místo provádění tokenů shellu jako argumentů. Požadovaný výstup SKIP/INCOMPLETE skeneru nemůže navázat PASS. Profil zaznamenává svá externí vyloučení a nenahrazuje hostované pokrytí, testovací matrice, balíčky nebo důkazy o nasazení. Níže uvedený inventář prózy je odkazem, nikoli důkazem, že brána skutečně běžela.
|
||||
Tyto profily pokrývají pouze statické skenování. Necertifikují testy produktů, pokrytí, balení, externí kontroly ani úplné přijetí kandidáta na vydání. Přijetí pracovního postupu používá propojené `config/quality/admission-policy.json` a `scripts/quality/admission-verdict.mjs`. Profily pozorovatele uvolnění zůstávají oddělené; nezávisle kontrolovat jejich příslušné šeky a účtenky. Úplné statické příkazy pozorovatele jsou deklarovány v `config/quality/release-green-static-profile.json`, včetně `audit:deps`, výběru testu mutace a kontroly překladu. Zavaděč ověřuje příkazy npm proti package.json a modelovaným deklaracím CI/Quality ; odmítá drift místo provádění tokenů shellu jako argumentů. Požadovaný výstup SKIP/INCOMPLETE skeneru nemůže vytvořit PASS. Profil zaznamenává svá externí vyloučení a nenahrazuje hostované pokrytí, testovací matrice, balíčky nebo důkazy o nasazení. Níže uvedený soupis prózy je odkazem, nikoli důkazem, že brána skutečně běžela.
|
||||
|
||||
Skripty fungují pod `scripts/check/` (brány zásad) a `scripts/quality/` (řehtací motor). Zdrojem pravdy CI je `.github/workflows/ci.yml`.
|
||||
|
||||
@@ -60,7 +62,7 @@ Skripty fungují pod `scripts/check/` (brány zásad) a `scripts/quality/` (řeh
|
||||
| `Docs Gates (fast-path)` | Docs/code PRs; API dokumenty refs a docs-all | Ano |
|
||||
| `Fast Quality Gates` | Kód PRs; statické kontroly, typová kontrola, typová kontrola palubní desky, impaktované jednotkové testy, zapomenuté sourozenecké testy (poradní) |
|
||||
| `No new ESLint warnings` | Kód PRs; ochrana proti žmolkům reagující na potlačení | Ano, včetně vidlic |
|
||||
| `Merge integrity (changelog + generated skills)` | Nenávrh PRs; changelog a vygenerovaná synchronizace dovedností | Ano, včetně vidlic |
|
||||
| `Merge integrity (changelog + generated skills)` | Nenávrh PRs; changelog a generovaná synchronizace dovedností | Ano, včetně vidlic |
|
||||
|
||||
#### Zpráva o testech zapomenutého sourozence
|
||||
|
||||
@@ -87,7 +89,7 @@ Běží na každém PR až `main`. Při selhání se bloky spojí.
|
||||
| `check:lockfile` | `package-lock.json` integrita — https registr, integrita hash, žádná přepsání hostitele | Ano |
|
||||
| `check:licenses` | SPDX licenční seznam povolených pro produkční závislosti | Ano |
|
||||
| `check:tracked-artifacts` | Žádné artefakty sestavení / potvrzené symbolické odkazy `node_modules` (také běží v husky pre-commit; pre-push je záměrně lehký — #6716) | Ano |
|
||||
| `check:ai-attribution` | Žádná upoutávka AI/bot `Co-Authored-By` nebo zápatí generace AI v commitech PR, názvu nebo těle — Hard Rule #16 (ve smyčce rychlých bran `quality.yml` pro PR→ `release/**` — čte datovou část události, no-op off PRs — a krok pouze PR v `ci.yml` lint pro PR→ `main` také `commit-msg` co; #14436 povoleno; |
|
||||
| `check:ai-attribution` | Žádná upoutávka AI/bot `Co-Authored-By` nebo zápatí generace AI v commitech PR, názvu nebo těle — Hard Rule #16 (ve smyčce rychlých bran `quality.yml` pro PR→ `release/**` — čte užitečné zatížení události, PRs — bez možnosti vypnutí a krok pouze pro PR v `ci.yml` lint pro PR→ `main` také `commit-msg` co; #14436 povoleno; |
|
||||
| `check:vitest-exclusions` | Každé vyloučení Vitest pojmenuje problém se sledováním a zobrazí se v `config/quality/vitest-exclusions.json` (#13204) | Ano |
|
||||
| `check:file-size` | Zdrojové soubory (`.ts`/`.tsx` v `src/`, `open-sse/`, `electron/`, `bin/`) zůstávají v `cap` a testovací soubory (`*.test.ts(x)`) v `testCap`; soubory zmrazené v `file-size-baseline.json` (`frozen` / `testFrozen`) nesmí přesáhnout svou zaznamenanou velikost | Ano |
|
||||
| `check:error-helper` | Chybové reakce v executors/handlers používají `buildErrorBody()` / `sanitizeErrorMessage()` (pevné pravidlo #12) | Ano |
|
||||
@@ -103,7 +105,7 @@ Běží na každém PR až `main`. Při selhání se bloky spojí.
|
||||
| `lint:json` | Konfigurační soubory JSON analyzují a splňují pravidla repo lint |
|
||||
| `typecheck:core` | kompilace TypeScript bez chyb (pouze informativní upozornění) | Ano |
|
||||
| `typecheck:noimplicit:core` | Přísné `noImplicitAny` — hledící do budoucnosti; mnoho již existujících stránek pro volání stále potřebuje poznámky | **Poradní** (`continue-on-error: true`) |
|
||||
| `check:dashboard-typecheck` | `tsc` v rozsahu `src/app/(dashboard)/**` (#7033) — Seznam povolených 27 souborů spravovaný `typecheck:core` neobsahuje žádný řídicí panel TSX a `next build` jej také nikdy nekontroluje typu (`next.config.mjs` nastavuje `ignoreBuildErrors: true`), takže regrese osiřelých identifikátorů tam (#6625/#6909) byly pro CI neviditelné. Rozdíly proti zamrzlé základní linii počtu per-file/per-TS-code (`config/quality/dashboard-typecheck-baseline.json`, stejný vzor zastaralého vynucení jako `check:known-symbols`) — pouze chyby NEW za základní linií selžou; ráčnou dolů pomocí `--update`, když je opravena již existující chyba. | Ano |
|
||||
| `check:dashboard-typecheck` | `tsc` v rozsahu `src/app/(dashboard)/**` (#7033) — Seznam povolených 27 souborů spravovaný `typecheck:core` neobsahuje žádný řídicí panel TSX a `next build` jej také nikdy nekontroluje typu (`next.config.mjs` nastavuje `ignoreBuildErrors: true`), takže regrese osiřelých identifikátorů tam (#6625/#6909) byly pro CI neviditelné. Rozdíly proti zamrzlé základní linii počtu per-file/per-TS-code (`config/quality/dashboard-typecheck-baseline.json`, stejný vzor zastaralého vynucení jako `check:known-symbols`) — pouze chyby NEW za základní linií selžou; snížit pomocí `--update`, když je opravena již existující chyba. | Ano |
|
||||
| `check:build-typecheck` | Kontrola produkčního typu celé aplikace přes `tsconfig.build.json` (`src`, `open-sse`, `packages`, `bin`, `scripts`, `electron/**/*.d.ts`), seznam povolených souborů `typecheck:core` s 27 soubory a brána palubní desky nepokrývají. Rozdíly proti `config/quality/build-typecheck-baseline.json`; nový nebo zvýšený počet za (soubor, kód) selže, nižší počet vás požádá o ratchetování. `--update` odmítne, když běh obsahuje nový nebo zvýšený pár, pokud není předán `--force-regressions`, a odmítne nově umlčený soubor, pokud není předán `--force-nocheck`, takže rozšíření základní linie na zelenou a udělení trvalého ticha jsou dva samostatné záměrné činy. Holý `--force` je odmítnut. Také prohledá rozsah sestavení pro `@ts-nocheck` proti `config/quality/ts-nocheck-baseline.json`, protože soubor, který jej používá, nehlásí vůbec žádnou diagnostiku a jinak by byl pro každou bránu neviditelný. | Ano |
|
||||
|
||||
#### Dva programy pro kontrolu typu odpovídají odlišně
|
||||
@@ -112,7 +114,7 @@ Běží na každém PR až `main`. Při selhání se bloky spojí.
|
||||
|
||||
`tsconfig.build.json` nastavuje `"strict": false`, takže `noImplicitAny` je vypnuto. Základní konfigurace zkompiluje upravený seznam povolených souborů s 27 soubory s přísnějšími možnostmi a sleduje graf importu každé položky, takže soubory, které se nikdy neobjeví v sestavení programu, jsou tam stále kontrolovány.
|
||||
|
||||
Důsledek je důležitý při posuzování, zda je soubor napsán:** nulová diagnostika pod `check:build-typecheck` neznamená nulu** . Odstranění `@ts-nocheck` z 26 souborů ukázalo, že 23 z nich je v sestavení programu čisté; šestnáct z nich se objevilo kolem 120 implicitních – jakékoli chyby v tom přísném. Před voláním souboru clean zkontrolujte obojí.
|
||||
Důsledek je důležitý při posuzování, zda je soubor napsán:** nulová diagnostika pod `check:build-typecheck` neznamená nulu** . Odstranění `@ts-nocheck` z 26 souborů ukázalo, že 23 z nich je v sestavení programu čisté; šestnáct z nich se objevilo kolem 120 implicitních – žádné chyby v přísném. Před voláním souboru clean zkontrolujte obojí.
|
||||
|
||||
### Práce: `quality-gate`
|
||||
|
||||
@@ -183,7 +185,7 @@ Funkce PR nikdy nezapisuje hodnotu, která závisí na stavu její základny: po
|
||||
|
||||
1. `--mode=pr|release` na příkazovém řádku;
|
||||
2. proměnná prostředí `OMNIROUTE_GATE_MODE` (`pr` nebo `release`);
|
||||
3. automaticky z události GitHub Actions: `pull_request`, jehož hlava není `release/v*`, `merge_group`, nebo push to `omni-queue/**` → `pr`; vše ostatní (push, plán, odeslání, vydání PR `release/v* → main`, jakékoli místní spuštění) → `release`.
|
||||
3. automaticky, z události GitHub Actions: a `pull_request`, jehož hlava není `release/v*`, `merge_group`, nebo push to `omni-queue/**` → `pr`; vše ostatní (push, plán, odeslání, vydání PR `release/v* → main`, jakékoli místní spuštění) → `release`.
|
||||
|
||||
Co `check:docs-counts` (`scripts/check/check-docs-counts-sync.mjs`) selže v každém režimu:
|
||||
|
||||
@@ -249,7 +251,7 @@ Testy jednotek národní parity (`cli-i18n-catalog`, `i18n-pt-br`, `i18n-vi-comp
|
||||
|
||||
Zachycuje jednu regresi i18n, kterou ostatní brány strukturálně nevidí: anglická hodnota je přepsána a překlady odvozené z _předchozí_ angličtiny zůstávají pozadu, takže neangličtí uživatelé stále čtou sebevědomě formulovanou, nyní chybnou kopii.
|
||||
|
||||
Toto bylo skutečně odesláno. `oauthModal.googleOAuthWarning` bylo přepsáno, když přistál pomocník pro přihlášení do Antigravity (#5203);** 39 ze 43 lokalit** stále text, který operátorům říká, aby „zkopírovali celé URL a vložili jej níže“ — tok, který pro daného poskytovatele nelze dokončit. Až do #8463 to zůstalo bez povšimnutí, protože:
|
||||
Toto bylo skutečně odesláno. `oauthModal.googleOAuthWarning` bylo přepsáno, když přistál pomocník pro přihlášení Antigravity (#5203);** 39 ze 43 lokalit** stále text, který operátorům říká, aby „zkopírovali celý URL a vložili jej níže“ — tok, který pro daného poskytovatele nelze dokončit. Až do #8463 to zůstalo bez povšimnutí, protože:
|
||||
|
||||
- `sync-ui-keys` vyplní pouze klíče, které jsou** nepřítomný** , nikdy ty, které jsou** zatuchlý** ;
|
||||
- `check-ui-keys-coverage` počítá klíč _prezence_, takže zastaralý překlad je hodnocen jako pokrytý;
|
||||
|
||||
@@ -4,14 +4,9 @@
|
||||
|
||||
---
|
||||
|
||||
OmniRoute používá model vydávání s **paralelními cykly**: vyhrazenou větev `release/vX.Y.Z`
|
||||
pro aktivní cyklus, `main` pro publikovanou řadu a neměnnou značku
|
||||
`vX.Y.Z`, jakmile je daný cyklus vydán. Je očekávané, že commity přibývají do `release/*` _i_ do
|
||||
`main` — nejde o omyl.
|
||||
OmniRoute používá a** paralelní cyklus** model vydání: vyhrazená větev `release/vX.Y.Z` pro aktivní cyklus, `main` pro publikovaný řádek a neměnný tag `vX.Y.Z`, když se tento cyklus dodává. Očekává se, že — přistane na `release/*` _and_ na `main`, není to záměna.
|
||||
|
||||
Podrobnosti pro správce jsou uvedeny v `CLAUDE.md` (Pevné pravidlo č. 21) a
|
||||
[RELEASE_CHECKLIST.md](./RELEASE_CHECKLIST.md). Tato stránka je veřejným
|
||||
souhrnem určeným přispěvatelům.
|
||||
Detail správce žije v `CLAUDE.md` (tvrdé pravidlo #21) a [RELEASE_CHECKLIST.md](./RELEASE_CHECKLIST.md). Tato stránka je veřejným souhrnem pro přispěvatele.
|
||||
|
||||
## Stručný přehled
|
||||
|
||||
@@ -42,25 +37,23 @@ flowchart LR
|
||||
`main` není integrační větev pro každodenní práci. PR otevřené proti `main`
|
||||
je obvykle nutné před sloučením přesměrovat.
|
||||
|
||||
## Zmrazení vydání (paralelní cykly)
|
||||
## Uvolnění zmrazení (paralelní cykly)
|
||||
|
||||
Když probíhá finalizace vydání, otevře se označovací issue se štítkem `release-freeze`.
|
||||
To **nezastavuje vývoj**:
|
||||
Při odsouhlasení vydání se otevře problém se značkou označený `release-freeze`. Že** vývoj nezastaví** :
|
||||
|
||||
- Zmrazená větev `release/vX.Y.Z` náleží vedoucímu daného vydání.
|
||||
- Další cyklus `release/vX+1` se vytvoří ze zmrazené špičky, aby přispěvatelé mohli
|
||||
pokračovat ve slučování své práce.
|
||||
- Otevřené PR, které stále cílí na zmrazenou větev, je třeba **přesměrovat** na
|
||||
aktivní (nejvyšší) větev `release/v*`.
|
||||
- Zmrazená `release/vX.Y.Z` patří vypouštěcímu kapitánovi pro tuto loď.
|
||||
- `release/vX+1` dalšího cyklu je odříznuta od zamrzlé špičky, takže přispěvatelé pokračují v práci na přistání.
|
||||
- Otevřená PRs, která stále cílí na zmrazenou větev, by měla být** přesměrováno** do aktivní (nejvyšší) větve `release/v*`.
|
||||
|
||||
Než budete předpokládat, že lze požadovanou větev slučovat, zkontrolujte, zda není aktivní zmrazení:
|
||||
Před předpokladem, že požadovaná větev je slučitelná, zkontrolujte, zda nedošlo k otevřenému zmrazení:
|
||||
|
||||
```bash
|
||||
gh issue list --repo diegosouzapw/OmniRoute --label release-freeze --state open
|
||||
```
|
||||
|
||||
Mechanismus slučování (štítek `queue` od vlastníka → Mergify) je zdokumentován v
|
||||
[MERGE_TRAIN.md](./MERGE_TRAIN.md).
|
||||
Mechanika sloučení (vlastník `queue` label → Mergify) je dokumentována v [MERGE_TRAIN.md](./MERGE_TRAIN.md).
|
||||
|
||||
> **2026-11-19: fronta sloučení Mergify je vyřazena** (rozhodnutí vlastníka). `.mergify.yml` již nedefinuje frontu a odmítá příkazy Mergify, které slučují nebo přepisují požadavek na stažení. Vydání PRs jsou sloučena ručně pod sadou pravidel úložiště "Vyžadovat zelené brány u aktivního vydání" (`Gate / CI` + `Gate / Quality`), dokud omni-queue běží v živém režimu, a poté prostřednictvím omni-queue ( [OMNI_QUEUE.md](./OMNI_QUEUE.md) ). Štítek `queue` již nic neslučuje.
|
||||
|
||||
## Proč větev i značka?
|
||||
|
||||
|
||||
@@ -4,38 +4,22 @@
|
||||
|
||||
---
|
||||
|
||||
Od verze v3.8.49 (WS3.2/WS3.4 plánu kvality/rychlosti) je výchozí cestou slučování
|
||||
zkontrolovaných PR do `release/vX.Y.Z` **fronta slučování Mergify** (`.mergify.yml`);
|
||||
níže zdokumentovaný **ruční merge-train** je ZÁLOŽNÍ postup — používá se během incidentů,
|
||||
zmrazení vydání nebo pokud se někdy změní plán Mergify Open Source.
|
||||
> **2026-11-19: fronta sloučení Mergify je vyřazena** (rozhodnutí vlastníka). `.mergify.yml` již nedefinuje frontu a odmítá příkazy Mergify, které slučují nebo přepisují požadavek na stažení. Vydání PRs jsou sloučena ručně pod sadou pravidel úložiště "Vyžadovat zelené brány u aktivního vydání" (`Gate / CI` + `Gate / Quality`), dokud omni-queue běží v živém režimu, a poté prostřednictvím omni-queue ( [OMNI_QUEUE.md](./OMNI_QUEUE.md) ). Části Sloučit níže popisují frontu tak, jak byla.
|
||||
|
||||
## Výchozí cesta: fronta Mergify
|
||||
Od verze 3.8.49 (WS3.2/WS3.4 plánu quality/velocity ) je výchozí slučovací cesta pro revidované PRs do `release/vX.Y.Z`** Sloučit frontu sloučení** (`.mergify.yml`); a** ruční slučovací vlak** níže je zdokumentováno FALLBACK — používané během incidentů, zamrznutí vydání nebo pokud se plán Mergify Open Source někdy změní.
|
||||
|
||||
1. PR je zkontrolován kampaněmi, získá zelený stav a je schválen předslučovací ⭐
|
||||
bránou vlastníka (report + rozhodnutí pro každou položku — viz `/merge-prs`, krok 0.75).
|
||||
2. Vlastník (nebo relace jednající na základě rozhodnutí vlastníka) přidá štítek **`queue`**.
|
||||
Tento štítek JE schválením sloučení; Mergify jej pouze provede.
|
||||
3. Mergify ověřuje PR zařazené do fronty **sériově** (jeden po druhém) pomocí rychlých
|
||||
kontrol a slučuje je (squash). Dávkové zpracování + automatické půlení vyžaduje
|
||||
placenou úroveň Mergify („Cannot use Merge Queue batch“ u bezplatného plánu, #7220),
|
||||
proto `.mergify.yml` nenastavuje žádný `batch_size`; dávkové zpracování zůstává
|
||||
úlohou níže popsaného ručního slučovacího vlaku. PR, jehož kontroly stále čekají
|
||||
po uplynutí `checks_timeout` (240 min = 2× naměřený p95 pro `quality.yml`), je
|
||||
odebrán z fronty, aby ji nezablokoval.
|
||||
4. Po sloučení průběžný workflow kontroly zeleného stavu vydání ověří nový vrchol
|
||||
při pushi a v případě, že kombinace způsobila regresi, otevře problém s uvedením
|
||||
původu (nikdy neprovádí automatický revert).
|
||||
## Výchozí cesta: fronta Sloučit
|
||||
|
||||
Ochranná pravidla (odpovídají přísným pravidlům č. 21/22 v `CLAUDE.md`):
|
||||
1. PR je reviewed/greened podle kampaní a schváleno vlastníkovou bránou ⭐ před sloučením (rozhodnutí + pro jednotlivé položky — viz `/merge-prs` krok 0.75).
|
||||
2. Vlastník (nebo relace jednající na základě rozhodnutí vlastníka) aplikuje**`queue`** označení. Štítek IS schválení sloučení; Mergify jej pouze provede.
|
||||
3. Mergify ověřuje PRs ve frontě** sériově** (jeden po druhém) proti rychlým branám a spojím (squash). Dávkování automatického půlení + je placená úroveň Mergify („Nelze použít dávku Merge Queue“ u bezplatného plánu, #7220), takže `.mergify.yml` nenastavuje žádné `batch_size`; dávkování zůstává úkolem ručního slučovacího vlaku níže. PR, jehož kontroly stále čekají na zpracování po `checks_timeout` (240 min = 2 × naměřené p95 `quality.yml`), je vyřazeno z fronty namísto zastavení fronty.
|
||||
4. Po sloučení ověřuje nepřetržitý zelený pracovní postup nový tip při push a otevře problém s přiřazením, pokud kombinace regrese (nikdy se nevrací automaticky).
|
||||
|
||||
- **Probíhá zmrazení vydání** → NEPŘIDÁVEJTE štítky k PR cílícím na zmrazenou větev;
|
||||
nejprve je přesměrujte na aktivní `release/vX+1`.
|
||||
- **Rozpracovaný PR jiné relace** → nikdy k němu nepřidávejte štítek; pouze vlastnící
|
||||
relace zařazuje svou práci do fronty.
|
||||
- Změny pouze v testech a PR se štítkem `hotfix` již používají omezenou sadu CI
|
||||
kontrol (viz `RELEASE_CHECKLIST.md` → Hotfix Fast-Lane); podmínky fronty akceptují
|
||||
libovolnou sadu kontrol, která se skutečně spustila (`#check-failure=0` +
|
||||
`#check-pending=0`).
|
||||
Zábradlí (zrcadlo `CLAUDE.md` Hard Rules #21/#22):
|
||||
|
||||
- **Uvolněte zmrazení otevřené** → do NOT štítek PRs zacílení na zmrazenou větev; přesměrujte nejprve na aktivní `release/vX+1`.
|
||||
- **PR další relace za letu** → nikdy neoznačte; pouze vlastnící relace řadí svou vlastní práci do fronty.
|
||||
- Rozdíly pouze pro testy a `hotfix` -labeled PRs již běží snížené CI (viz `RELEASE_CHECKLIST.md` → Hotfix Fast-Lane); podmínky fronty přijímají jakoukoli kontrolní sadu, která skutečně proběhla (`#check-failure=0` + `#check-pending=0`).
|
||||
|
||||
## Záložní postup: ruční merge-train
|
||||
|
||||
|
||||
@@ -355,114 +355,70 @@ Před vydáním jakékoli verze v3.8.x ověřte také následující položky:
|
||||
|
||||
---
|
||||
|
||||
## Vydání 3.9.0 LTS (nacvičeno ve verzi 3.8.58)
|
||||
## 3.9.0 LTS střih (zkoušeno v 3.8.58)
|
||||
|
||||
Po v3.8.59 následuje verze 3.9.0 a její vrchol se stane základem dvou dlouhodobých větví:
|
||||
`stable/v3` (řada v3 LTS, npm `latest`) a `develop` (v4, zvýšená na 4.0.0, npm
|
||||
`nightly`). Model větví/kanálů, forward-port a štítky jsou popsány v
|
||||
[RELEASE_STRATEGY.md](./RELEASE_STRATEGY.md); plán je v dokumentu [ROADMAP](../../ROADMAP.md) (fáze 3). Vydání se provede jednou;
|
||||
ve verzi 3.8.58 se celý postup od začátku do konce nacvičí na forku a verze 3.8.59 bude uzavřena pomocí
|
||||
[kontrolního seznamu GO/NO-GO](./LTS_GO_NO_GO.md).
|
||||
Po verzi 3.8.59 je další verze 3.9.0 a její špičkou se stávají dvě větve s dlouhou životností: `stable/v3` (čára v3 LTS, npm `latest`) a `develop` (v4, naražená na 4.0.0, npm `nightly`). Model branch/channel, dopředný port a štítky jsou v [RELEASE_STRATEGY.md](./RELEASE_STRATEGY.md) ; plán je v [ROADMAP](../../ROADMAP.md) (fáze 3). Řez probíhá jednou; 3.8.58 to nacvičuje od konce k konci na vidličku a 3.8.59 to uzavírá [kontrolním seznamem GO/NO-GO](./LTS_GO_NO_GO.md).
|
||||
|
||||
### Zkušební běh (pouze pro čtení, bezpečný kdykoli)
|
||||
### Spuštění nasucho (pouze pro čtení, bezpečné kdykoli)
|
||||
|
||||
```bash
|
||||
npm run release:dry-run-lts-cut # skutečné vydání: 3.9.0 z HEAD, předchozí značka v3.8.59
|
||||
npm run release:dry-run-lts-cut -- --from <3.9.0-tip> # připnutí zdrojového commitu
|
||||
npm run release:dry-run-lts-cut # the real cut: 3.9.0 from HEAD, previous tag v3.8.59
|
||||
npm run release:dry-run-lts-cut -- --from <3.9.0-tip> # pin the source commit
|
||||
```
|
||||
|
||||
`scripts/release/dry-run-lts-cut.mjs` nic nevykonává: načte git a `gh` a vypíše
|
||||
celou posloupnost — předpoklady (zdroj lze přeložit, zdrojový repozitář má úplnou historii —
|
||||
mělký klon nemůže odeslat `stable/v3`, přijímající strana odmítne balíček u prvního
|
||||
naroubovaného rodiče, proto vydání proveďte z úplného klonu nebo nejprve spusťte `git fetch --unshallow origin` —
|
||||
předchozí značka existuje, `package.json` obsahuje cílovou verzi, je otevřen problém se štítkem
|
||||
`release-freeze`, na existující vydávací větvi není otevřen žádný problém
|
||||
`Release branch not green` — u větve, která neexistuje, se zobrazí neznámý stav `?`, nikdy
|
||||
zelený — fronta Mergify `release` je nakonfigurována (G11: `queue_rules`, `checks_timeout`,
|
||||
štítek `queue`), sada pravidel `release/*` stále blokuje odstranění a vynucené odeslání a
|
||||
`stable/v3` ani `develop` dosud neexistují), dva kroky pro větve, které spouštěče neaktivních
|
||||
workflow a podmínky `if:` se stanou pravdivými (a které zůstanou blokovány proměnnou repozitáře
|
||||
nebo připnuty ke kanonickému repozitáři), očekávané dist-tag (`latest` → 3.9.0, `next` a
|
||||
`nightly` prázdné) a postup vrácení změn. Návratový kód `0` = `RESULT: READY`, `1` = nesplněný
|
||||
blokující předpoklad (`✗`), `2` = chyba použití. `--advisory <id,...>` sníží závažnost kontroly
|
||||
na varování (`!`), aniž by ji skryl.
|
||||
`scripts/release/dry-run-lts-cut.mjs` executes nothing: it reads git and `gh` and prints the whole sequence — preconditions (source resolves, the source repository has full history — a shallow clone cannot push `stable/v3`, the receiving side rejects the pack at the first grafted parent, so cut from a full clone or `git fetch --unshallow origin` first — previous tag exists, `package.json` is the target version, a `release-freeze` issue is open, no open `Release branch not green` issue on an existing release branch — a branch that does not exist reports `?` unknown, never green — omni-queue lands the release PRs (G11: `config/merge-queue/config.json` valid, its `bases` manage the release branch, `mode` `live`, its label exists), the `release/*` ruleset still blocks deletion and force-push, and `stable/v3` and `develop` do not exist yet), the two branch steps, which dormant-workflow triggers and `if:` conditions turn true (and which stay gated by a repository variable or pinned to the canonical repository), the expected dist-tags (`latest` → 3.9.0, `next` and `nightly` empty) and the rollback. Exit `0` = `RESULT: READY`, `1` = a blocking precondition failed (`✗`), `2` = usage error. `--advisory <id,...>` downgrades a check to a warning (`!`) without hiding it.
|
||||
|
||||
Zkušební běh skutečného vydání spusťte, dokud je zmrazení vydání 3.9.0 stále aktivní — větve
|
||||
se vytvoří po značce a předtím, než fáze 12c zmrazení zruší.
|
||||
Spusťte suchý běh skutečného řezu, dokud je zmrazení vydání 3.9.0 stále otevřené — větve se vytvoří po tagu a než fáze 12c zmrazení zruší.
|
||||
|
||||
### Nácvik verze 3.8.58 (pouze na forku)
|
||||
### 3.8.58 zkouška (pouze vidlice)
|
||||
|
||||
```bash
|
||||
# 1. Zkušební běh na aktuálním vrcholu s parametry nácviku
|
||||
# 1. Dry-run on the current tip with rehearsal parameters
|
||||
npm run release:dry-run-lts-cut -- --target-version 3.8.58 --previous-tag v3.8.57 \
|
||||
--advisory freeze,base-green
|
||||
|
||||
# 2. Provedení vůči vzdálenému FORKU (origin ani žádný vzdálený repozitář, jehož URL odpovídá
|
||||
# kanonickému repozitáři, není povolen; každý krok vyžaduje potvrzení v terminálu)
|
||||
# 2. Execute against a FORK remote (origin, or any remote whose URL is the canonical
|
||||
# repository, is refused; every step asks for confirmation on the terminal)
|
||||
git remote add rehearsal https://github.com/<you>/OmniRoute.git
|
||||
node scripts/release/dry-run-lts-cut.mjs --execute --remote rehearsal \
|
||||
--target-version 3.8.58 --previous-tag v3.8.57 --advisory freeze,base-green
|
||||
|
||||
# 3. Vyzkoušení neaktivních workflow ve forku (workflow_dispatch tam, kde zkušební běh
|
||||
# hlásí připnutí ke kanonickému repozitáři), poté vrácení změn
|
||||
# 3. Exercise the dormant workflows in the fork (workflow_dispatch where the dry-run
|
||||
# reports a canonical-repository pin), then roll back
|
||||
node scripts/release/dry-run-lts-cut.mjs --execute --rollback --remote rehearsal \
|
||||
--target-version 3.8.58 --previous-tag v3.8.57 --advisory freeze,base-green
|
||||
```
|
||||
|
||||
Commit zvyšující verzi ve větvi develop se vytvoří pomocí nízkoúrovňových nástrojů gitu
|
||||
(pracovní strom zůstane nedotčen) a aktualizuje stejných pět souborů jako commit otevírající
|
||||
cyklus: `package.json`, `open-sse/package.json`, `electron/package.json`, `package-lock.json`
|
||||
a `docs/openapi.yaml`. Sekce `[4.0.0]` souboru CHANGELOG a její lokalizované kopie se následně
|
||||
otevřou ve větvi `develop`, ještě před jejím prvním PR. Skript nikdy nemění npm dist-tag —
|
||||
jejich postup nacvičte na pomocném balíčku.
|
||||
Vyvíjecí bump odevzdání je vytvořeno pomocí git plumbing (nedotkne se žádného pracovního stromu) a zkopíruje stejných pět souborů jako cyklicky otevřené odevzdání: `package.json`, `open-sse/package.json`, `electron/package.json`, `package-lock.json` a `docs/openapi.yaml`. Sekce `[4.0.0]` CHANGELOG a její zrcátka i18n se následně otevřou na `develop`, před jejím prvním PR. Skript se nikdy nemění npm dist-tags — nacvičují ty na odkládacím balíčku.
|
||||
|
||||
### Artefakt náhledu PR (sestavte jednou, propagujte stejné bajty)
|
||||
### Artefakt náhledu PR (sestavit jednou, povýšit stejné bajty)
|
||||
|
||||
`.github/workflows/preview-artifact.yml` vytvoří jeden produkční tarball z hlavičky PR a
|
||||
ověří přesně toto sestavení (část (a) problému #8084). Pouze PR ze stejného repozitáře;
|
||||
nic se nepublikuje.
|
||||
`.github/workflows/preview-artifact.yml` sestaví jeden produkční tarball z hlavy PR a ověří toto přesné sestavení (#8084 řez (a)). Pouze stejné úložiště PRs ; nic není zveřejněno.
|
||||
|
||||
```bash
|
||||
gh workflow run preview-artifact.yml -f pr_number=<N> # nebo přidejte štítek `preview-artifact`
|
||||
gh workflow run preview-artifact.yml -f pr_number=<N> # or add the `preview-artifact` label
|
||||
gh run download <run-id> --name preview-artifact-pr<N>-<sha7> --dir preview
|
||||
cd preview && sha256sum -c SHA256SUMS
|
||||
gh attestation verify omniroute-*.tgz --repo diegosouzapw/OmniRoute
|
||||
npm install -g ./omniroute-*.tgz # instalace náhledu
|
||||
npm install -g ./omniroute-*.tgz # preview install
|
||||
```
|
||||
|
||||
Běh provede `npm ci`, `npm run build:release`, `npm run check:pack-artifact`, zabalí
|
||||
tarball, spustí `npm run check:pack-boot` (falešné tajné údaje, dočasný datový adresář),
|
||||
znovu jej zabalí a selže, pokud kontrolní součet není totožný; poté zaznamená
|
||||
`artifact-identity.json` (SHA hlavičky, SHA základu, hash zamykacího souboru, platformu,
|
||||
architekturu, ABI Node, bundler, zásady sestavení —
|
||||
`scripts/release/artifact-identity.mjs`) a v samostatné úloze vytvoří atestaci tarballu.
|
||||
Propagovat náhled znamená nainstalovat tento tarball: nikdy jej znovu nesestavujte ze zdrojového kódu.
|
||||
Spuštění provede `npm ci`, `npm run build:release`, `npm run check:pack-artifact`, zabalí tarball, spustí `npm run check:pack-boot` (falešná tajemství, pomíjivý datový adresář), znovu se sbalí a selže, pokud není výtah identický, pak zaznamená `artifact-identity.json` (head SHA, základ SHA, hash lockfile, platforma, oblouk, uzel ABI, bundler a sestavení samostatné úlohy sestavy — `scripts/release/artifact-identity.mjs`) Propagace náhledu znamená instalaci tohoto tarballu: nikdy nepřestavujte ze zdroje.
|
||||
|
||||
### Vydání (3.9.0, po rozhodnutí GO)
|
||||
### Střih (3.9.0, po GO)
|
||||
|
||||
1. Rozhodnutí GO je zaznamenáno v [LTS_GO_NO_GO.md](./LTS_GO_NO_GO.md).
|
||||
2. `npm run release:dry-run-lts-cut -- --from v3.9.0` vypíše `RESULT: READY`.
|
||||
3. Větve na `origin` vytvořte ručně pomocí příkazů vypsaných zkušebním během — skript
|
||||
odmítne odesílat změny do `origin`. Chcete-li znovu použít zkontrolovaný commit pro
|
||||
větev develop, nejprve spusťte nácvik s `--execute` na vrcholu 3.9.0 vůči svému forku;
|
||||
vypíše obě SHA a stejné commity pak lze odeslat:
|
||||
1. GO zaznamenané v [LTS_GO_NO_GO.md](./LTS_GO_NO_GO.md).
|
||||
2. `npm run release:dry-run-lts-cut -- --from v3.9.0` tiskne `RESULT: READY`.
|
||||
3. Vytvořte větve na `origin` ručně pomocí příkazů dry-run vypíše — skript odmítá vložit do `origin`. Chcete-li znovu použít recenzovaný vývojový commit, spusťte nejprve zkoušku `--execute` na tipu 3.9.0 na vaší vidlici; vypíše obě SHAs a lze odeslat stejné potvrzení:
|
||||
|
||||
```bash
|
||||
git push origin <stable-sha>:refs/heads/stable/v3 <develop-sha>:refs/heads/develop
|
||||
```
|
||||
|
||||
4. Chraňte `stable/v3` a `develop` (sady pravidel + fronta slučování) ještě před začleněním prvního PR.
|
||||
5. Neaktivní pracovní postupy se zapnou existencí větve: `forward-port.yml` (push do
|
||||
`stable/v3`), `validate-stable-pr.yml` (PR směřující do `stable/v3`) a `nightly-v4-build.yml`
|
||||
(sestavuje `develop`). Před spuštěním nastavte tajný údaj repozitáře `secrets.FORWARD_PORT_TOKEN` (aby CI běželo u
|
||||
PR pro přenos změn vpřed); noční publikování zůstane vypnuté, dokud vlastník nenastaví proměnnou repozitáře
|
||||
`vars.NIGHTLY_PUBLISH` na `true` a npm Trusted Publishing nepovolí
|
||||
`nightly-v4-build.yml`. Určení kanálu zajišťuje `scripts/release/dist-tag.mjs`, stejný
|
||||
resolver, který používá `npm-publish.yml`.
|
||||
6. Ověřte kanály: `npm view omniroute dist-tags --json` zobrazí `latest` = 3.9.0 a žádné
|
||||
`next` / `nightly`, dokud nebude publikována verze v4.
|
||||
7. V případě potřeby proveďte návrat zpět: `git push origin --delete refs/heads/stable/v3 refs/heads/develop`
|
||||
a `npm dist-tag add omniroute@3.8.59 latest`.
|
||||
4. Chraňte `stable/v3` a `develop` (rulessets + merge queue) před tím, než přistane první PR.
|
||||
5. Neaktivní pracovní toky se zapínají existencí větve: `forward-port.yml` (push to `stable/v3`), `validate-stable-pr.yml` (PRs to `stable/v3`) a `nightly-v4-build.yml` (builds `develop`). Před spuštěním nastavte tajemství úložiště `secrets.FORWARD_PORT_TOKEN` (takže CI běží na dopředném portu PRs); noční publikování zůstane vypnuté, dokud vlastník nenastaví proměnnou úložiště `vars.NIGHTLY_PUBLISH` na `true` a npm Trusted Publishing přijme `nightly-v4-build.yml`. Rozlišení kanálu je `scripts/release/dist-tag.mjs`, stejný resolver používá `npm-publish.yml`.
|
||||
6. Ověřte kanály: `npm view omniroute dist-tags --json` zobrazuje `latest` = 3.9.0 a žádné `next` / `nightly`, dokud nebude zveřejněna v4.
|
||||
7. Vrácení zpět, je-li třeba: `git push origin --delete refs/heads/stable/v3 refs/heads/develop` a `npm dist-tag add omniroute@3.8.59 latest`.
|
||||
|
||||
---
|
||||
|
||||
|
||||
@@ -130,33 +130,22 @@ a to jen tehdy, když je nečinný**, přičemž kontrolu nečinnosti a restart
|
||||
minut, zatímco jeho nahrání z disku trvalo 2 minuty.
|
||||
- VPS `.15` je určen výhradně pro homologaci — nikdy na něm neběží CI runnery.
|
||||
|
||||
## Hostovaná kapacita (běhová prostředí hostovaná GitHubem)
|
||||
## Hostovaná dráha (běžci hostovaní na GitHubu)
|
||||
|
||||
Repozitář patří organizaci `cheaper-inference` s tarifem **Team**: **60 souběžných hostovaných úloh**, sdílených všemi repozitáři organizace, všemi kontrolami PR, všemi pracovními postupy spouštěnými při pushi a výchozím nastavením CodeQL. Níže uvedená čísla byla naměřena na tarifu **Pro** (40 souběžných hostovaných úloh). Měřeno 2026-10-18 během
|
||||
kampaně slučování (~10 sloučení za hodinu do `release/v3.8.52`): **2 500 běhů pracovních postupů vytvořených za
|
||||
24 h**, 44 pushů do větve za 6 h, **106 hostovaných úloh ve frontě**, zatímco kontroly PR čekaly
|
||||
hodiny a PR byly sloučeny bez nich. Při každém pushi do větve se spustilo devět pracovních postupů:
|
||||
Úložiště patří organizaci `cheaper-inference`, na** Tým** plán:** 60 souběžně hostovaných úloh** , sdílené každým úložištěm v organizaci, každou kontrolou PR, každým pracovním postupem spouštěným push a výchozím nastavením CodeQL. Níže uvedená čísla byla naměřena na** Pro** plán (40 souběžně hostovaných úloh). Měřeno 2026-10-18 během slučovací kampaně (~ 10 merges/hour na `release/v3.8.52`):** Za 24 hodin bylo vytvořeno 2 500 pracovních postupů** , 44 zatlačení na větev za 6 h,** 106 hostovaných úloh ve frontě** zatímco kontroly PR čekaly hodiny a PRs byly sloučeny bez nich. Devět pracovních postupů spuštěných při každém zatlačení na pobočku:
|
||||
|
||||
| při každém pushi do `release/v*` | hostované úlohy | výsledek během náporu | od 2026-10-18 |
|
||||
| ------------------------------------------- | --------------: | ------------------------------------------------------------- | ----------------------------------------------------------------------------- |
|
||||
| `ci.yml` (úplná matice) | až 30 | zrušeno následujícím pushem, 24 z 24 za den | nespouští se při pushích do `release/**` (běh PR + Release-Green) |
|
||||
| `quality.yml` | ~6 | zrušeno, 23 z 23 | nespouští se při pushích do `release/**` |
|
||||
| `Release-Green` `--quick` | 0 | běželo na `omni-build`, zrušeno 97 ze 100 | slot `omni-release`, nikdy se neruší, čekající běhy se slučují |
|
||||
| `Lock released branch`, `OpenSSF Scorecard` | 2 | jeden běh ve frontě na každý push | jeden běh na každý ref (`tests/unit/build/hosted-lane-concurrency.test.ts`) |
|
||||
| `Release acceptance` (stínový report) | 1 | jedno hostované `npm ci` na každý push, nikdy se neruší | beze změny — kandidát na filtr `paths:` |
|
||||
| `Publish to Docker Hub` → `Deploy to VPS` | 2 | ruší se při každém pushi; větev amd64 soupeří na `omni-build` | beze změny — kanál vlastníka pro nasazení |
|
||||
| Výchozí nastavení CodeQL (`dynamic`) | 4 | `javascript-typescript`, `actions`, `c-cpp`, `python` na push | beze změny — Nastavení → Zabezpečení kódu; `c-cpp`/`python` zde nic neskenují |
|
||||
| za stisknutí `release/v*` | hostované úlohy | výsledek pod bouří | od 18.10.2026 |
|
||||
| ------------------------------------------- | --------------: | ------------------------------------------------------------------ | ------------------------------------------------------------------------------- |
|
||||
| `ci.yml` (úplná matice) | do 30 | zrušeno dalším stisknutím, 24 z 24 za den | nespuštěno na `release/**` push (PR spustit + Release-Green) |
|
||||
| `quality.yml` | ~6 | zrušeno, 23 z 23 | nezačal na pushech `release/**` |
|
||||
| `Release-Green` `--quick` | 0 | běžel na `omni-build`, zrušeno 97 ze 100 | `omni-release` slot, nikdy nezrušen, čekající běh kolabuje |
|
||||
| `Lock released branch`, `OpenSSF Scorecard` | 2 | jedno spuštění ve frontě na jedno stisknutí | jeden běh na referenci (`tests/unit/build/hosted-lane-concurrency.test.ts`) |
|
||||
| `Release acceptance` (stínová zpráva) | 1 | jeden hostovaný `npm ci` na push, nikdy zrušen | nezměněný — kandidát na filtr `paths:` |
|
||||
| `Publish to Docker Hub` → `Deploy to VPS` | 2 | zrušeno po stisknutí; amd64 leg soutěží na `omni-build` | nezměněný distribuční kanál vlastníka — |
|
||||
| výchozí nastavení CodeQL (`dynamic`) | 4 | `javascript-typescript`, `actions`, `c-cpp`, `python` za stisknutí | beze změny — Nastavení → Zabezpečení kódu; `c-cpp`/`python` zde nic nenaskenuje |
|
||||
|
||||
`tests/unit/build/push-storm-diet.test.ts` ukotvuje trigger `ci.yml` a
|
||||
`quality.yml` pro push pouze do `main`. Vedlejší efekt: Codecov již nedostává základní nahrání při každém pushi do release větve (tento
|
||||
krok je pouze informativní a používá `continue-on-error`); kontrola pokrytí v repozitáři ani komentář k PR
|
||||
nejsou ovlivněny.
|
||||
`tests/unit/build/push-storm-diet.test.ts` připíná spoušť `main` -only `ci.yml` a `quality.yml`. Vedlejší efekt: Codecov již nedostává základní upload za vydání push (krok je informativní a `continue-on-error`); brána pokrytí in-repo a komentář PR nejsou ovlivněny.
|
||||
|
||||
**Větší kapacita na vlastních běhových prostředích nevyřeší frontu hostovaných úloh.** Devbox
|
||||
(`devbox-vm-06-dev002`, 24 vCPU / 54 GB) by mohl hostovat běhové prostředí, ale relace agentů již
|
||||
udržují jeho zátěž na hodnotách 20–26, kontejner agenta nemá démona Dockeru a přetížená je
|
||||
hostovaná kapacita. Server `.113` měl ve stejnou chvíli 71 GB volného místa a zátěž 5–8; jeho omezením
|
||||
je výše uvedený paměťový rozpočet na každý listener (maximum 6 listenerů), nikoli CPU. Zbývající možnosti
|
||||
jsou procesní: slučovat PR kampaně prostřednictvím fronty Mergify (`label=queue`, dávky sdílejí
|
||||
jeden běh CI `merge_group` namísto jednoho běhu na každý PR a dalšího na každý push), omezit jazyky
|
||||
ve výchozím nastavení CodeQL a filtrovat `release-acceptance.yml` podle souborů, které čte.
|
||||
**Větší kapacita vlastního hostování neopraví hostovanou frontu.** Devbox (`devbox-vm-06-dev002`, 24 vCPU / 54 GB) by mohl hostit běžce, ale relace agenta si již udržují zátěž na 20–26, kontejner agenta nemá žádného démona Docker a saturovaný pruh je hostovaný. Krabice `.113` měla 71 GB volného a zatížení 5–8 ve stejném okamžiku; jeho omezením je výše rozpočtu paměti na posluchače (strop 6 posluchačů), nikoli CPU. Zbývající páky jsou procesní: přiložte kampaň PRs přes frontu Mergify (`label=queue`, dávky sdílejí jedno spuštění `merge_group` CI místo jednoho spuštění na PR plus jedno na push), ořízněte jazyky výchozího nastavení CodeQL a filtrujte `release-acceptance.yml` podle souborů, které čte.
|
||||
|
||||
> **2026-11-19: fronta sloučení Mergify je vyřazena** (rozhodnutí vlastníka). `.mergify.yml` již nedefinuje frontu a odmítá příkazy Mergify, které slučují nebo přepisují požadavek na stažení. Vydání PRs jsou sloučena ručně pod sadou pravidel úložiště "Vyžadovat zelené brány u aktivního vydání" (`Gate / CI` + `Gate / Quality`), dokud omni-queue běží v živém režimu, a poté prostřednictvím omni-queue ( [OMNI_QUEUE.md](./OMNI_QUEUE.md) ). Páka Sloučit výše již neexistuje.
|
||||
|
||||
@@ -25,10 +25,12 @@ Begge arbejdsgange dækker PRs til main/release grene, push til `main`, manuel a
|
||||
|
||||
En almindelig PR kører det hurtige udvalg. `full-code` og `full-code-e2e` -banerne i adgangspolitikken (E2E, integration, pakkeartefakt, Electron smoke, Bun SQLite, økosystem- og protokolklienter) kører kun på et Mergify-køudkast eller på en fuld kørsel: `gh workflow run ci.yml --ref <branch>`.
|
||||
|
||||
Hver JSON -kvittering identificerer den udtjekkede SHA, arbejdsgang og forsøg. CLI afviser en checkout/event SHA -uoverensstemmelse. Workflow-tests binder politikmedlemskab til domsjobbets `needs` liste, så en ny eller fjernet bane ikke stille kan forsvinde. Kvitteringerne dækker deres egen arbejdsgang, ikke udgivelse, implementering eller det interne i en eksisterende rådgivende scanner. Aktivering af begge kontrolnavne i grenregler er en separat administrativ ændring; tilføjelse af disse job beskytter ikke i sig selv en filial.
|
||||
Hver JSON -kvittering identificerer den udtjekkede SHA, arbejdsgang og forsøg. CLI afviser en checkout/event SHA -uoverensstemmelse. Workflow-tests binder politikmedlemskab til domsjobbets `needs` liste, så en ny eller fjernet bane kan ikke stille forsvinde. Kvitteringerne dækker deres egen arbejdsgang, ikke udgivelse, implementering eller det interne i en eksisterende rådgivende scanner. Aktivering af begge kontrolnavne i grenregler er en separat administrativ ændring; tilføjelse af disse job beskytter ikke i sig selv en filial.
|
||||
|
||||
### Flet kø
|
||||
|
||||
> **2026-11-19: Mergify-fletningskøen er trukket tilbage** (ejers beslutning). `.mergify.yml` definerer ikke længere en kø og afviser de Mergify-kommandoer, der fusionerer eller omskriver en pull-anmodning. Release PRs flettes i hånden under repository-regelsættet "Kræv grønne porte på den aktive udgivelse" (`Gate / CI` + `Gate / Quality`) indtil omni-queue kører i live mode, og gennem omni-queue derefter ( [OMNI_QUEUE.md](../ops/OMNI_QUEUE.md) ). Workflow-håndteringen af Mergify-kladder beskrevet nedenfor er stadig i `ci.yml` og `quality.yml`, men der åbnes ikke mere Mergify-kladder.
|
||||
|
||||
`queue` etiketten sender en PR til Mergify-køen (`.mergify.yml`). Mergify åbner et udkast til PR på en `mergify/merge-queue/` -gren, CI kører hele markeringen der, og den originale PR smelter sammen, når `Gate / CI`, `Gate / Quality` og `Merge integrity (changelog + generated skills)` passerer.
|
||||
|
||||
Mergify skriver sin køoversigt i udkastets beskrivelse, og andre apps kan også redigere den. En `pull_request` `edited` -begivenhed på sådan et udkast tager sin egen samtidighedsgruppe (`-queue-edit-<run_id>`), så den kan ikke annullere udkastets rigtige løb, og den springer porten og matrixen over. Kun `Merge integrity` kører stadig. Det oversprungne gate-job har et andet kontrolnavn, fordi Mergify læser en oversprunget `Gate / CI` som en mislykket kontrol og sætter PR i kø.
|
||||
@@ -72,39 +74,39 @@ Tønde-reeksport og dynamisk import er kun opløsningsdiagnostik; de skaber aldr
|
||||
|
||||
Kører på hver PR til `main`. Blokke smelter sammen ved fejl.
|
||||
|
||||
| Script (`npm run ...`) | Validerer | Blokering |
|
||||
| --------------------------------- | ----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | ------------------------------------------ |
|
||||
| `check:node-runtime` | Node.js versionen er inden for det understøttede område | Ja |
|
||||
| `check:cycles` | Cirkulær import på tværs af hele `src/` + `open-sse/` (AST-baseret, tsconfig `paths` løst). Bare udgange 1, når der eksisterer en cyklus (fail-closed siden #15281) og viser SCCs. `check:cycles:ratchet` (hvad CI kører) blokerer, når antallet overstiger `metrics.cycles` -loftet i `quality-baseline.json` — i øjeblikket 14, `direction: down`, så det kan kun falde (#15159 G-01/G-02) | Ja (skralde) |
|
||||
| `check:boundary` | `open-sse → src` -kobling: unik fil-til-fil-import fra motoren til appen (`scripts/quality/measure-boundary.mjs`; kantlisten er v4 core/module-split afhjælpningsefterslæbet). Bare = -rådgivningsrapport (samme som `quality:boundary`). `check:boundary:ratchet` (hvad CI kører, også i `quality.yml` fast-gates skraldeløkken) blokerer, når antallet overstiger `metrics.boundaryOpenSseToSrc` loftet i `quality-baseline.json` — seeded ved de målte 771, `direction: down`; `--update` sænker det kun; base-relativ på PRs (`--base-ref`, se nedenfor) | Ja (skralde) |
|
||||
| `check:route-validation:t06` | Zod skemaer til stede på alle ruter (Tier 6-politik) | Ja |
|
||||
| `check:any-budget:t11` | `@ts-expect-error // any` antallet overstiger ikke budgettet (Tier 11 catraca) | Ja |
|
||||
| `check:provider-consistency` | Hver udbyder i `providers.ts` har en matchende post i `providerRegistry.ts` (og omvendt inden for tilladelseslisten) | Ja |
|
||||
| `check:model-lifecycle` | De tre håndvedligeholdte routingtabeller forbliver i overensstemmelse med det indtjekkede livscyklus-øjebliksbillede (#11503): `FITNESS_TABLE` (`taskFitness.ts`) scorer ikke noget pensioneret id, som `REGISTRY` kan dirigere; hvert `BUILT_IN_ALIASES` mål er til stede i `REGISTRY` og fraværende fra det pensionerede-id-øjebliksbillede; alle tilbagetrukne id'er, der stadig er i `REGISTRY` videresendes eller vises i `allowedRetiredInCatalog`; og ingen `DEFAULT_DEGRADATION_MAP` kilde eller -mål vises tilbagetrukket i det øjebliksbillede. Dette beviser ikke, at en model i øjeblikket betjenes af en live upstream. Offline — sammenlignes med `config/quality/model-lifecycle.json`, opdateret manuelt med `npm run quality:refresh-model-lifecycle` (netværk; ikke tilsluttet CI). `allowedRetiredInCatalog` er en nedbrændt skralde: Tilføj kun en post med et sporingsproblem. | Ja |
|
||||
| `check:fetch-targets` | Hver `fetch("/api/...")` i `src/` på klientsiden løses til en rigtig `route.ts` | Ja |
|
||||
| `check:deps` | Alle `npm install` -able deps på tværs af hver `package.json` i repoen er i `dependency-allowlist.json`; nye unpinned eller slopsquatted pakker markeret | Ja |
|
||||
| `audit:deps` | npm revision af alle fem uafhængige låsefiler (root, Electron, OpenCode plugins v1/v2 og provider). Kritisk rådgivning blok; høje advarsler forbliver synlige advarsler. Missing/failed revisioner er INCOMPLETE og blok; per-scope låsehasher og rapporter bevares. | Ja |
|
||||
| `check:lockfile` | `package-lock.json` integritet — https-registrering, integritets-hash, ingen host-tilsidesættelser | Ja |
|
||||
| `check:licenses` | SPDX -licenstilladelsesliste for produktionsafhængigheder | Ja |
|
||||
| `check:tracked-artifacts` | Ingen byggeartefakter/committerede `node_modules` symlinks (kører også i husky pre-commit; pre-push er bevidst let — #6716) | Ja |
|
||||
| `check:ai-attribution` | Ingen AI/bot `Co-Authored-By` trailer eller AI-generations footer i PR commits, titel eller body — Hard Rule #16 `commit-msg` i `quality.yml` fast `main` gates loop for PR→ `release/**` — læser begivenhedens nyttelast, no-op off PRs — og et PR-kun trin i `ci.yml` PR den menneskelige →; medforfattere tilladt #14436 |
|
||||
| `check:vitest-exclusions` | Hver Vitest -ekskludering navngiver et sporingsproblem og vises i `config/quality/vitest-exclusions.json` (#13204) | Ja |
|
||||
| `check:file-size` | Kildefiler (`.ts`/`.tsx` i `src/`, `open-sse/`, `electron/`, `bin/`) forbliver inden for `cap` og testfiler (`*.test.ts(x)`) inden for `testCap`; filer frosset i `file-size-baseline.json` (`frozen` / `testFrozen`) må ikke vokse forbi deres registrerede størrelse | Ja |
|
||||
| `check:error-helper` | Fejlsvar i executors/handlers bruger `buildErrorBody()` / `sanitizeErrorMessage()` (hård regel #12) | Ja |
|
||||
| `check:migration-numbering` | Migrationsfilnavne: den gamle `001`–`241` -serie er frosset, og nye filer er `YYYYMMDDHHMMSS_<description>.sql`. Mod PR basen afviser den en fjernet migrering, en omdøbt uden en kompatibilitetsindgang og en ude af orden eller redigeret, hvis endelige skema ikke pendler |
|
||||
| `check:public-creds` | Ingen bogstavelige OAuth `client_id`/`client_secret` eller Firebase-webnøgler uden for `publicCreds.ts` (Hard Rule #11) | Ja |
|
||||
| `check:db-rules` | Ingen rå SQL uden for `src/lib/db/` moduler; ingen tønde-import fra `localDb.ts` (Hårde regler #2/#5) | Ja |
|
||||
| `check:known-symbols` | Udbydere, routingstrategier og oversættere, der er registreret i deres afsendelsestabeller, matcher filerne på disken — ingen forældreløse eller ikke-erklærede symboler | Ja |
|
||||
| `check:route-guard-membership` | Hver rute, der afføder en underordnet proces, er klassificeret efter `isLocalOnlyPath()` (Hårde regler #15/#17) | Ja |
|
||||
| `check:test-discovery` | Hver `*.test.ts` / `*.spec.ts` -fil i repoen indsamles af mindst én testløber (ratchet: forældreløse liste i `test-discovery-baseline.json` kan kun krympe) | Ja |
|
||||
| `check:test-tla-order` | Ingen `node:test` fil under `tests/unit` registrerer en test, rammer en `await` på øverste niveau og registrerer derefter mere (#18045; skralde: `test-tla-order-allowlist.json` kan kun krympe) | Ja |
|
||||
| `check:agent-skills-sync` | Genererede agentfærdighedsartefakter matcher deres kildekatalog (ingen drift). Frigivelsestilstand kontrollerer alle færdigheder; en funktion PR (`pr` tilstand) kontrollerer kun de færdigheder, hvis genererede tekst den redigerer — se [Genererede filer og afledte basislinjer](#generated-files-and-derived-baselines-written-at-release) |
|
||||
| `check:provider-asset-provenance` | Udbyder logos/assets har en registreret herkomstpost |
|
||||
| `lint:json` | JSON config-filer parser og opfylder repo lint-reglerne |
|
||||
| `typecheck:core` | TypeScript -kompilering uden fejl (kun rådgivende advarsler) | Ja |
|
||||
| `typecheck:noimplicit:core` | Strenge `noImplicitAny` — fremadskuende; mange allerede eksisterende opkaldswebsteder har stadig brug for annoteringer | **Rådgivende** (`continue-on-error: true`) |
|
||||
| `check:dashboard-typecheck` | `tsc` scoped til `src/app/(dashboard)/**` (#7033) — `typecheck:core` kurerede tilladelsesliste med 27 filer inkluderer ikke noget dashboard TSX, og `next build` typechecker det heller aldrig (`next.config.mjs` sætter `ignoreBuildErrors: true`), så forældreløse identifikator-regressioner der (#6625/#6909) var usynlige for CI. Forskelle i forhold til en fastfrosset per-file/per-TS-code count baseline (`config/quality/dashboard-typecheck-baseline.json`, samme forældede håndhævelsesmønster som `check:known-symbols`) — kun NEW fejl ud over den baselined count fejler porten; skralde ned med `--update` når en allerede eksisterende fejl er rettet. | Ja |
|
||||
| `check:build-typecheck` | Hele-app produktionstype check over `tsconfig.build.json` (`src`, `open-sse`, `packages`, `bin`, `scripts`, `electron/**/*.d.ts`), overfladen `typecheck:core`'s tilladelsesliste med 27 filer og dashboard-porten dækker ikke. Forskelle mod `config/quality/build-typecheck-baseline.json`; en ny eller forhøjet tælling pr. (fil, kode) mislykkes, en lavere tælling beder dig om at skralde. `--update` nægter, mens kørslen indeholder et nyt eller hævet par, medmindre `--force-regressions` er bestået, og nægter en nyligt dæmpet fil, medmindre `--force-nocheck` er bestået, så at udvide basislinjen for at blive grøn og give en permanent stilhed er to separate bevidste handlinger. En bar `--force` afvises. Scanner også build-omfanget for `@ts-nocheck` mod `config/quality/ts-nocheck-baseline.json`, fordi en fil, der bruger det, rapporterer ingen diagnostik overhovedet og ellers ville være usynlig for enhver gate. | Ja |
|
||||
| Script (`npm run ...`) | Validerer | Blokering |
|
||||
| --------------------------------- | -------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | ------------------------------------------ |
|
||||
| `check:node-runtime` | Node.js versionen er inden for det understøttede område | Ja |
|
||||
| `check:cycles` | Cirkulær import på tværs af hele `src/` + `open-sse/` (AST-baseret, tsconfig `paths` løst). Bare udgange 1, når der eksisterer en cyklus (fail-closed siden #15281) og viser SCCs. `check:cycles:ratchet` (hvad CI kører) blokerer, når antallet overstiger `metrics.cycles` -loftet i `quality-baseline.json` — i øjeblikket 14, `direction: down`, så det kan kun falde (#15159 G-01/G-02) | Ja (skralde) |
|
||||
| `check:boundary` | `open-sse → src` -kobling: unik fil-til-fil-import fra motoren til appen (`scripts/quality/measure-boundary.mjs`; kantlisten er v4 core/module-split afhjælpningsefterslæbet). Bare = -rådgivningsrapport (samme som `quality:boundary`). `check:boundary:ratchet` (hvad CI kører, også i `quality.yml` fast-gates skraldeløkken) blokerer, når antallet overstiger `metrics.boundaryOpenSseToSrc` loftet i `quality-baseline.json` — seeded ved de målte 771, `direction: down`; `--update` sænker det kun; base-relativ på PRs (`--base-ref`, se nedenfor) | Ja (skralde) |
|
||||
| `check:route-validation:t06` | Zod skemaer til stede på alle ruter (Tier 6-politik) | Ja |
|
||||
| `check:any-budget:t11` | `@ts-expect-error // any` antallet overstiger ikke budgettet (Tier 11 catraca) | Ja |
|
||||
| `check:provider-consistency` | Hver udbyder i `providers.ts` har en matchende post i `providerRegistry.ts` (og omvendt inden for tilladelseslisten) | Ja |
|
||||
| `check:model-lifecycle` | De tre håndvedligeholdte routingtabeller forbliver i overensstemmelse med det indtjekkede livscyklus-øjebliksbillede (#11503): `FITNESS_TABLE` (`taskFitness.ts`) scorer ikke noget pensioneret id, som `REGISTRY` kan dirigere; hvert `BUILT_IN_ALIASES` mål er til stede i `REGISTRY` og fraværende fra det pensionerede-id-øjebliksbillede; alle tilbagetrukne id'er, der stadig er i `REGISTRY` videresendes eller vises i `allowedRetiredInCatalog`; og ingen `DEFAULT_DEGRADATION_MAP` kilde eller -mål vises tilbagetrukket i det øjebliksbillede. Dette beviser ikke, at en model i øjeblikket betjenes af en live upstream. Offline — sammenlignes med `config/quality/model-lifecycle.json`, opdateret manuelt med `npm run quality:refresh-model-lifecycle` (netværk; ikke tilsluttet CI). `allowedRetiredInCatalog` er en nedbrændt skralde: Tilføj kun en post med et sporingsproblem. | Ja |
|
||||
| `check:fetch-targets` | Hver `fetch("/api/...")` i `src/` på klientsiden løses til en rigtig `route.ts` | Ja |
|
||||
| `check:deps` | Alle `npm install` -able deps på tværs af hver `package.json` i repoen er i `dependency-allowlist.json`; nye unpinned eller slopsquatted pakker markeret | Ja |
|
||||
| `audit:deps` | npm revision af alle fem uafhængige låsefiler (root, Electron, OpenCode plugins v1/v2 og provider). Kritisk rådgivning blok; høje advarsler forbliver synlige advarsler. Missing/failed revisioner er INCOMPLETE og blok; per-scope låsehash og rapporter bevares. | Ja |
|
||||
| `check:lockfile` | `package-lock.json` integritet — https-registrering, integritets-hash, ingen host-tilsidesættelser | Ja |
|
||||
| `check:licenses` | SPDX -licenstilladelsesliste for produktionsafhængigheder | Ja |
|
||||
| `check:tracked-artifacts` | Ingen byggeartefakter/committerede `node_modules` symlinks (kører også i husky pre-commit; pre-push er bevidst let — #6716) | Ja |
|
||||
| `check:ai-attribution` | Ingen AI/bot `Co-Authored-By` trailer eller AI-generations footer i PR commits, titel eller body — Hard Rule #16 `commit-msg` i `quality.yml` fast-gates loop for PR→ `release/**` — læser hændelsens nyttelast, no-op off PRs — og et PR-kun trin i `ci.yml` `main` PR menneskelige →; medforfattere tilladt #14436 |
|
||||
| `check:vitest-exclusions` | Hver Vitest -ekskludering navngiver et sporingsproblem og vises i `config/quality/vitest-exclusions.json` (#13204) | Ja |
|
||||
| `check:file-size` | Kildefiler (`.ts`/`.tsx` i `src/`, `open-sse/`, `electron/`, `bin/`) forbliver inden for `cap` og testfiler (`*.test.ts(x)`) inden for `testCap`; filer frosset i `file-size-baseline.json` (`frozen` / `testFrozen`) må ikke vokse forbi deres registrerede størrelse | Ja |
|
||||
| `check:error-helper` | Fejlsvar i executors/handlers bruger `buildErrorBody()` / `sanitizeErrorMessage()` (hård regel #12) | Ja |
|
||||
| `check:migration-numbering` | Migrationsfilnavne: den gamle `001`–`241` -serie er frosset, og nye filer er `YYYYMMDDHHMMSS_<description>.sql`. Mod PR basen afviser den en fjernet migrering, en omdøbt uden en kompatibilitetsindgang og en ude af orden eller redigeret, hvis endelige skema ikke pendler |
|
||||
| `check:public-creds` | Ingen bogstavelige OAuth `client_id`/`client_secret` eller Firebase-webnøgler uden for `publicCreds.ts` (Hard Rule #11) | Ja |
|
||||
| `check:db-rules` | Ingen rå SQL uden for `src/lib/db/` moduler; ingen tønde-import fra `localDb.ts` (Hårde regler #2/#5) | Ja |
|
||||
| `check:known-symbols` | Udbydere, routingstrategier og oversættere, der er registreret i deres afsendelsestabeller, matcher filerne på disken — ingen forældreløse eller ikke-erklærede symboler | Ja |
|
||||
| `check:route-guard-membership` | Hver rute, der afføder en underordnet proces, er klassificeret efter `isLocalOnlyPath()` (Hårde regler #15/#17) | Ja |
|
||||
| `check:test-discovery` | Hver `*.test.ts` / `*.spec.ts` -fil i repoen indsamles af mindst én testløber (ratchet: forældreløse liste i `test-discovery-baseline.json` kan kun krympe) | Ja |
|
||||
| `check:test-tla-order` | Ingen `node:test` fil under `tests/unit` registrerer en test, rammer en `await` på øverste niveau og registrerer derefter mere (#18045; skralde: `test-tla-order-allowlist.json` kan kun krympe) | Ja |
|
||||
| `check:agent-skills-sync` | Genererede agentfærdighedsartefakter matcher deres kildekatalog (ingen drift). Frigivelsestilstand kontrollerer alle færdigheder; en funktion PR (`pr` tilstand) kontrollerer kun de færdigheder, hvis genererede tekst den redigerer — se [Genererede filer og afledte basislinjer](#generated-files-and-derived-baselines-written-at-release) |
|
||||
| `check:provider-asset-provenance` | Udbyder logos/assets har en registreret herkomstpost |
|
||||
| `lint:json` | JSON config-filer parser og opfylder repo lint-reglerne |
|
||||
| `typecheck:core` | TypeScript -kompilering uden fejl (kun rådgivende advarsler) | Ja |
|
||||
| `typecheck:noimplicit:core` | Strenge `noImplicitAny` — fremadskuende; mange allerede eksisterende opkaldswebsteder har stadig brug for annoteringer | **Rådgivende** (`continue-on-error: true`) |
|
||||
| `check:dashboard-typecheck` | `tsc` scoped til `src/app/(dashboard)/**` (#7033) — `typecheck:core` kurerede tilladelsesliste med 27 filer inkluderer ikke noget dashboard TSX, og `next build` typechecker det heller aldrig (`next.config.mjs` sætter `ignoreBuildErrors: true`), så forældreløse identifikator-regressioner der (#6625/#6909) var usynlige for CI. Forskelle i forhold til en fastfrosset per-file/per-TS-code count baseline (`config/quality/dashboard-typecheck-baseline.json`, samme forældede håndhævelsesmønster som `check:known-symbols`) — kun NEW fejl ud over den baselined count fejler porten; skralde ned med `--update` når en allerede eksisterende fejl er rettet. | Ja |
|
||||
| `check:build-typecheck` | Hele-app produktionstype check over `tsconfig.build.json` (`src`, `open-sse`, `packages`, `bin`, `scripts`, `electron/**/*.d.ts`), overfladen `typecheck:core`'s tilladelsesliste med 27 filer og dashboard-porten dækker ikke. Forskelle mod `config/quality/build-typecheck-baseline.json`; et nyt eller forhøjet antal pr. (fil, kode) mislykkes, et lavere antal beder dig om at skralde. `--update` nægter, mens kørslen indeholder et nyt eller hævet par, medmindre `--force-regressions` er bestået, og nægter en nyligt dæmpet fil, medmindre `--force-nocheck` er bestået, så at udvide basislinjen for at blive grøn og give en permanent stilhed er to separate bevidste handlinger. En bar `--force` afvises. Scanner også build-omfanget for `@ts-nocheck` mod `config/quality/ts-nocheck-baseline.json`, fordi en fil, der bruger det, rapporterer ingen diagnostik overhovedet og ellers ville være usynlig for enhver gate. | Ja |
|
||||
|
||||
#### To typecheck-programmer svarer forskelligt
|
||||
|
||||
@@ -116,7 +118,7 @@ Konsekvensen har betydning, når man skal vurdere, om en fil er maskinskrevet:**
|
||||
|
||||
### Job: `quality-gate`
|
||||
|
||||
Runs after `test-coverage`. Blokke smelter sammen ved fejl.
|
||||
Løber efter `test-coverage`. Blokke smelter sammen ved fejl.
|
||||
|
||||
| Manuskript | Validerer | Blokering |
|
||||
| ---------------------------- | ----------------------------------------------------------------------------------------------------------------------------------------------------------------------- | ------------------------- |
|
||||
@@ -160,7 +162,7 @@ Kører på hver PR til `main`. Blokke smelter sammen ved fejl.
|
||||
| `check:cli-i18n` | CLI `t()` nøgler findes i `bin/cli/locales/en.json` (begge tilstande); pt-BR / zh-CN / zh-TW paritet med `en.json` kun i frigivelsestilstand | Ja |
|
||||
| `check:openapi-coverage` | OpenAPI spec dækker mindst et skraldet gulv af rigtige ruter | Ja |
|
||||
| `check:openapi-security-tiers` | Sikkerhedsniveauannoteringer i `openapi.yaml` er i overensstemmelse med `routeGuard.ts` klassifikationer | **Rådgivende** |
|
||||
| `check:openapi-routes` | Hver vej i `openapi.yaml` forvandles til en rigtig `route.ts` (anti-hallucination) | Ja |
|
||||
| `check:openapi-routes` | Hver sti i `openapi.yaml` forvandles til en rigtig `route.ts` (anti-hallucination) | Ja |
|
||||
| `check:docs-symbols` | Hver `/api/...` reference i `docs/**/*.md` løses til en rigtig `route.ts` (anti-hallucination) | Ja |
|
||||
| `i18n translation drift` | `docs/i18n/**` spejle vs `.i18n-state.json` — rådgivning på PRs (spejle genopfriskes af oversættelsesbølgen), streng på push og om natten | **Rådgivende** på PRs |
|
||||
|
||||
@@ -253,7 +255,7 @@ Dette blev sendt for alvor. `oauthModal.googleOAuthWarning` blev omskrevet, da A
|
||||
|
||||
- `sync-ui-keys` udfylder kun nøgler, der er** fraværende** , aldrig dem der er** forældet** ;
|
||||
- `check-ui-keys-coverage` tæller nøglen _tilstedeværelse_, så en forældet oversættelse scorer som dækket;
|
||||
- `check-translation-drift` sporer `docs/i18n/<locale>/**.md` -dokumentationen spejler — den læser aldrig `src/i18n/messages/*.json`. Den kører i job `docs-sync-strict`: rådgivende om PRs, streng på push og natlig; oversættelsesbølgen genopfrisker spejlene, ikke funktionen PR.
|
||||
- `check-translation-drift` sporer `docs/i18n/<locale>/**.md` -dokumentationen spejler — den læser aldrig `src/i18n/messages/*.json`. Den kører i job `docs-sync-strict`: rådgivende på PRs, streng på push og natlig; oversættelsesbølgen genopfrisker spejlene, ikke funktionen PR.
|
||||
|
||||
**Diff-bevidst, ikke baseline-understøttet.** Den sammenligner `en.json` ved flettebasen med arbejdstræet; for hver nøgle, hvis engelske værdi er ændret, er enhver lokalitet, der stadig har en uberørt oversættelse, forældet. Dette bevidst** indefryser allerede eksisterende gæld** — a diff kan ikke afsløre, hvilket gammelt engelsk en mangeårig oversættelse kom fra, så porten bedømmer kun, hvad den aktuelle ændring berører. Alternativet (en per-nøgle hash-baseline) ville koste en ~ 600 KB -genereret fil, 3 × den største eksisterende baseline, der churning på hver i18n PR.
|
||||
|
||||
@@ -270,7 +272,7 @@ npm run i18n:check-value-drift:warn # report only
|
||||
BASE_REF=origin/release/vX.Y.Z npm run i18n:check-value-drift
|
||||
```
|
||||
|
||||
Afslutter 0 med `SKIP reason=base-unresolved`, når basiskataloget ikke kan læses (overfladisk klon uden basisreferens), spejler `check-openapi-breaking`. Kun udgivelsestilstand: en funktion PR omskriver det engelske og stopper der; udgivelsesopdateringen markerer de oversættelser, den efterlod (`node scripts/i18n/sync-ui-keys.mjs --rewritten-since=<ref>`, same `findStaleTranslations`).
|
||||
Afslutter 0 med `SKIP reason=base-unresolved`, når basiskataloget ikke kan læses (overfladisk klon uden basisreferen), spejler `check-openapi-breaking`. Kun udgivelsestilstand: en funktion PR omskriver det engelske og stopper der; udgivelsesopdateringen markerer de oversættelser, den efterlod (`node scripts/i18n/sync-ui-keys.mjs --rewritten-since=<ref>`, same `findStaleTranslations`).
|
||||
|
||||
### Job: `i18n`
|
||||
|
||||
|
||||
@@ -4,14 +4,9 @@
|
||||
|
||||
---
|
||||
|
||||
OmniRoute bruger en **parallelcyklusbaseret** udgivelsesmodel: en dedikeret `release/vX.Y.Z`-gren
|
||||
til den aktive cyklus, `main` til den udgivne linje og et uforanderligt
|
||||
`vX.Y.Z`-tag, når cyklussen udgives. Det er forventeligt, at commits lander både på `release/*` _og_ på
|
||||
`main` — det er ikke en fejl.
|
||||
OmniRoute bruger en** parallel-cyklus** frigivelsesmodel: en dedikeret `release/vX.Y.Z` -gren til den aktive cyklus, `main` for den offentliggjorte linje og et uforanderligt `vX.Y.Z` tag, når den cyklus sendes. At se commit lande på `release/*` _og_ på `main` forventes — ikke en sammenblanding.
|
||||
|
||||
Detaljer for vedligeholdere findes i `CLAUDE.md` (ufravigelig regel nr. 21) og
|
||||
[RELEASE_CHECKLIST.md](./RELEASE_CHECKLIST.md). Denne side er den offentlige
|
||||
oversigt rettet mod bidragydere.
|
||||
Vedligeholdelsesdetaljerne findes i `CLAUDE.md` (Hard Rule #21) og [RELEASE_CHECKLIST.md](./RELEASE_CHECKLIST.md). Denne side er den offentlige bidragyder-vendte oversigt.
|
||||
|
||||
## Kort fortalt
|
||||
|
||||
@@ -42,25 +37,23 @@ flowchart LR
|
||||
`main` er ikke integrationsgrenen til det daglige arbejde. PR'er, der åbnes mod `main`,
|
||||
skal normalt målrettes mod en anden gren før sammenfletning.
|
||||
|
||||
## Udgivelsesfrysning (parallelle cyklusser)
|
||||
## Frigør fryse (parallelle cyklusser)
|
||||
|
||||
Når en udgivelse afstemmes, åbnes en markørsag med etiketten `release-freeze`.
|
||||
Det **stopper ikke udviklingen**:
|
||||
Når en udgivelse bliver afstemt, åbnes et markørproblem mærket `release-freeze`. At** stopper ikke udviklingen** :
|
||||
|
||||
- Den frosne `release/vX.Y.Z` tilhører den udgivelsesansvarlige for denne udgivelse.
|
||||
- Den næste cyklus' `release/vX+1` oprettes fra den frosne spids, så bidragydere fortsat kan
|
||||
få deres arbejde sammenflettet.
|
||||
- Åbne PR'er, der stadig er målrettet mod den frosne gren, skal **målrettes på ny** mod den
|
||||
aktive (højeste) `release/v*`-gren.
|
||||
- Den frosne `release/vX.Y.Z` tilhører frigivelseskaptajnen for det skib.
|
||||
- Den næste cyklus `release/vX+1` skæres fra den frosne spids, så bidragyderne fortsætter med at lande.
|
||||
- Åbn PRs, der stadig målrette den frosne gren skal være** retargeted** til den aktive (højeste) `release/v*` gren.
|
||||
|
||||
Kontrollér, om der er en åben frysning, før du antager, at den ønskede gren kan sammenflettes:
|
||||
Tjek for en åben frysning, før du antager, at den gren, du ønsker, kan flettes:
|
||||
|
||||
```bash
|
||||
gh issue list --repo diegosouzapw/OmniRoute --label release-freeze --state open
|
||||
```
|
||||
|
||||
Mekanismerne for sammenfletning (ejerens `queue`-etiket → Mergify) er dokumenteret i
|
||||
[MERGE_TRAIN.md](./MERGE_TRAIN.md).
|
||||
Merge mekanik (ejer `queue` label → Mergify) er dokumenteret i [MERGE_TRAIN.md](./MERGE_TRAIN.md).
|
||||
|
||||
> **2026-11-19: Mergify-fletningskøen er trukket tilbage** (ejers beslutning). `.mergify.yml` definerer ikke længere en kø og afviser de Mergify-kommandoer, der fusionerer eller omskriver en pull-anmodning. Release PRs flettes i hånden under repository-regelsættet "Kræv grønne porte på den aktive udgivelse" (`Gate / CI` + `Gate / Quality`) indtil omni-queue kører i live mode, og gennem omni-queue derefter ( [OMNI_QUEUE.md](./OMNI_QUEUE.md) ). `queue` etiketten fletter ikke længere noget.
|
||||
|
||||
## Hvorfor både en gren og et tag?
|
||||
|
||||
|
||||
@@ -4,10 +4,9 @@
|
||||
|
||||
---
|
||||
|
||||
Siden v3.8.49 (WS3.2/WS3.4 i kvalitets-/hastighedsplanen) er standardflettevejen for
|
||||
gennemgåede PR'er til `release/vX.Y.Z` **Mergify-flettekøen** (`.mergify.yml`);
|
||||
det **manuelle flettetog**, der er dokumenteret nedenfor, er RESERVELØSNINGEN — den bruges under hændelser,
|
||||
release-frysninger, eller hvis Mergifys Open Source-plan nogensinde ændres.
|
||||
> **2026-11-19: Mergify-fletningskøen er trukket tilbage** (ejers beslutning). `.mergify.yml` definerer ikke længere en kø og afviser de Mergify-kommandoer, der fusionerer eller omskriver en pull-anmodning. Release PRs flettes i hånden under repository-regelsættet "Kræv grønne porte på den aktive udgivelse" (`Gate / CI` + `Gate / Quality`) indtil omni-queue kører i live mode, og gennem omni-queue derefter ( [OMNI_QUEUE.md](./OMNI_QUEUE.md) ). Mergify-sektionerne nedenfor beskriver køen, som den var.
|
||||
|
||||
Siden v3.8.49 (WS3.2/WS3.4 af quality/velocity planen) er standardfletningsstien for gennemgået PRs til `release/vX.Y.Z`** Flet sammenfletningskø** (`.mergify.yml`); de** manuelt sammenfletningstog** dokumenteret nedenfor er FALLBACK — der bruges under hændelser, udgivelsesfrysninger, eller hvis Mergify Open Source-planen nogensinde ændres.
|
||||
|
||||
## Standardforløb: Mergify-køen
|
||||
|
||||
|
||||
@@ -355,111 +355,70 @@ Før en v3.8.x-udgivelse frigives, skal disse yderligere punkter verificeres:
|
||||
|
||||
---
|
||||
|
||||
## 3.9.0 LTS-udskæring (afprøvet i 3.8.58)
|
||||
## 3.9.0 LTS cut (øvet i 3.8.58)
|
||||
|
||||
Efter v3.8.59 er den næste version 3.9.0, og dens spids bliver til to langlivede branches:
|
||||
`stable/v3` (v3 LTS-linjen, npm `latest`) og `develop` (v4, opgraderet til 4.0.0, npm
|
||||
`nightly`). Branch-/kanalmodellen, forward-port og labels findes i
|
||||
[RELEASE_STRATEGY.md](./RELEASE_STRATEGY.md); planen findes i [ROADMAP](../../ROADMAP.md) (fase 3). Udskæringen køres én gang;
|
||||
3.8.58 afprøver den fra ende til anden på en fork, og 3.8.59 afsluttes med
|
||||
[GO/NO-GO-tjeklisten](./LTS_GO_NO_GO.md).
|
||||
Efter v3.8.59 er den næste version 3.9.0, og dens spids bliver to langlivede grene: `stable/v3` (v3 LTS linjen, npm `latest`) og `develop` (v4, stødt til 4.0.0, npm `nightly`). branch/channel modellen, forward-porten og etiketterne er i [RELEASE_STRATEGY.md](./RELEASE_STRATEGY.md) ; planen er i [ROADMAP](../../ROADMAP.md) (fase 3). Snittet løber en gang; 3.8.58 øver det ende mod ende på en gaffel, og 3.8.59 lukker med [GO/NO-GO tjeklisten](./LTS_GO_NO_GO.md).
|
||||
|
||||
### Prøvekørsel (skrivebeskyttet, sikker når som helst)
|
||||
### Tørløb (skrivebeskyttet, sikkert til enhver tid)
|
||||
|
||||
```bash
|
||||
npm run release:dry-run-lts-cut # den rigtige udskæring: 3.9.0 fra HEAD, forrige tag v3.8.59
|
||||
npm run release:dry-run-lts-cut -- --from <3.9.0-tip> # fastlås kildecommit
|
||||
npm run release:dry-run-lts-cut # the real cut: 3.9.0 from HEAD, previous tag v3.8.59
|
||||
npm run release:dry-run-lts-cut -- --from <3.9.0-tip> # pin the source commit
|
||||
```
|
||||
|
||||
`scripts/release/dry-run-lts-cut.mjs` udfører intet: det læser git og `gh` og udskriver hele
|
||||
sekvensen — forudsætninger (kilden kan opløses, kilderepositoriet har fuld historik —
|
||||
en shallow clone kan ikke pushe `stable/v3`, den modtagende side afviser pakken ved den første
|
||||
grafted parent, så foretag udskæringen fra en fuld klon, eller kør først `git fetch --unshallow origin` — det forrige
|
||||
tag findes, `package.json` har målversionen, en `release-freeze`-issue er åben, der er ingen åben
|
||||
`Release branch not green`-issue
|
||||
på en eksisterende release-branch — en branch, der ikke findes, rapporterer `?` ukendt, aldrig
|
||||
grøn — Mergifys `release`-kø er konfigureret (G11: `queue_rules`, `checks_timeout`,
|
||||
label `queue`), `release/*`-regelsættet blokerer stadig sletning og force-push, og
|
||||
`stable/v3` og `develop` findes endnu ikke), de to branch-trin, hvilke udløsere for inaktive workflows
|
||||
og `if:`-betingelser der bliver sande (og hvilke der fortsat er blokeret af en repositorievariabel eller
|
||||
fastlåst til det kanoniske repositorium), de forventede dist-tags (`latest` → 3.9.0, `next` og
|
||||
`nightly` tomme) samt tilbagerulningen. Afslutningskode `0` = `RESULT: READY`, `1` = en blokerende forudsætning
|
||||
mislykkedes (`✗`), `2` = brugsfejl. `--advisory <id,...>` nedgraderer et tjek til en advarsel (`!`)
|
||||
uden at skjule det.
|
||||
`scripts/release/dry-run-lts-cut.mjs` executes nothing: it reads git and `gh` and prints the whole sequence — preconditions (source resolves, the source repository has full history — a shallow clone cannot push `stable/v3`, the receiving side rejects the pack at the first grafted parent, so cut from a full clone or `git fetch --unshallow origin` first — previous tag exists, `package.json` is the target version, a `release-freeze` issue is open, no open `Release branch not green` issue on an existing release branch — a branch that does not exist reports `?` unknown, never green — omni-queue lands the release PRs (G11: `config/merge-queue/config.json` valid, its `bases` manage the release branch, `mode` `live`, its label exists), the `release/*` ruleset still blocks deletion and force-push, and `stable/v3` and `develop` do not exist yet), the two branch steps, which dormant-workflow triggers and `if:` conditions turn true (and which stay gated by a repository variable or pinned to the canonical repository), the expected dist-tags (`latest` → 3.9.0, `next` and `nightly` empty) and the rollback. Exit `0` = `RESULT: READY`, `1` = a blocking precondition failed (`✗`), `2` = usage error. `--advisory <id,...>` downgrades a check to a warning (`!`) without hiding it.
|
||||
|
||||
Kør prøvekørslen for den rigtige udskæring, mens release freeze for 3.9.0 stadig er aktiv — branchene
|
||||
oprettes efter tagget og før fase 12c ophæver fastfrysningen.
|
||||
Kør det rigtige snits tørløb, mens 3.9.0-frigivelsesfrysningen stadig er åben — grenene oprettes efter mærket og før fase 12c løfter frysepunktet.
|
||||
|
||||
### 3.8.58-afprøvning (kun fork)
|
||||
### 3.8.58 øve (kun gaffel)
|
||||
|
||||
```bash
|
||||
# 1. Prøvekørsel på den aktuelle spids med afprøvningsparametre
|
||||
# 1. Dry-run on the current tip with rehearsal parameters
|
||||
npm run release:dry-run-lts-cut -- --target-version 3.8.58 --previous-tag v3.8.57 \
|
||||
--advisory freeze,base-green
|
||||
|
||||
# 2. Udfør mod en FORK-remote (origin eller enhver remote, hvis URL er det kanoniske
|
||||
# repositorium, afvises; hvert trin beder om bekræftelse i terminalen)
|
||||
# 2. Execute against a FORK remote (origin, or any remote whose URL is the canonical
|
||||
# repository, is refused; every step asks for confirmation on the terminal)
|
||||
git remote add rehearsal https://github.com/<you>/OmniRoute.git
|
||||
node scripts/release/dry-run-lts-cut.mjs --execute --remote rehearsal \
|
||||
--target-version 3.8.58 --previous-tag v3.8.57 --advisory freeze,base-green
|
||||
|
||||
# 3. Afprøv de inaktive workflows i forken (workflow_dispatch, hvor prøvekørslen
|
||||
# rapporterer en fastlåsning til det kanoniske repositorium), og rul derefter tilbage
|
||||
# 3. Exercise the dormant workflows in the fork (workflow_dispatch where the dry-run
|
||||
# reports a canonical-repository pin), then roll back
|
||||
node scripts/release/dry-run-lts-cut.mjs --execute --rollback --remote rehearsal \
|
||||
--target-version 3.8.58 --previous-tag v3.8.57 --advisory freeze,base-green
|
||||
```
|
||||
|
||||
Develop-opgraderingscommittet bygges med Git-plumbing (intet working tree berøres) og opgraderer
|
||||
de samme fem filer som et commit, der åbner en cyklus: `package.json`, `open-sse/package.json`,
|
||||
`electron/package.json`, `package-lock.json` og `docs/openapi.yaml`. `[4.0.0]`-
|
||||
sektionen i CHANGELOG og dens i18n-spejlinger åbnes efterfølgende på `develop`, før dens første
|
||||
PR. Scriptet ændrer aldrig npm-dist-tags — afprøv dem på en midlertidig pakke.
|
||||
Development bump commit er bygget med git plumbing (intet arbejdstræ berøres) og bumper de samme fem filer som en cycle-open commit: `package.json`, `open-sse/package.json`, `electron/package.json`, `package-lock.json` og `docs/openapi.yaml`. `[4.0.0]` CHANGELOG sektionen og dens i18n-spejle åbnes på `develop` bagefter, før dens første PR. Scriptet ændrer aldrig npm dist-tags — øver dem på en scratch-pakke.
|
||||
|
||||
### PR-preview-artifakt (byg én gang, promover de samme bytes)
|
||||
### PR preview artefakt (byg én gang, promover de samme bytes)
|
||||
|
||||
`.github/workflows/preview-artifact.yml` bygger én produktionstarball fra et PR-head og
|
||||
validerer præcis dette build (#8084 del (a)). Kun PR'er fra samme repositorium; intet publiceres.
|
||||
`.github/workflows/preview-artifact.yml` bygger en produktions-tarball fra et PR -hoved og validerer den nøjagtige build (#8084 slice (a)). Kun samme lager PRs ; intet er offentliggjort.
|
||||
|
||||
```bash
|
||||
gh workflow run preview-artifact.yml -f pr_number=<N> # eller tilføj labelen `preview-artifact`
|
||||
gh workflow run preview-artifact.yml -f pr_number=<N> # or add the `preview-artifact` label
|
||||
gh run download <run-id> --name preview-artifact-pr<N>-<sha7> --dir preview
|
||||
cd preview && sha256sum -c SHA256SUMS
|
||||
gh attestation verify omniroute-*.tgz --repo diegosouzapw/OmniRoute
|
||||
npm install -g ./omniroute-*.tgz # preview-installation
|
||||
npm install -g ./omniroute-*.tgz # preview install
|
||||
```
|
||||
|
||||
Kørslen udfører `npm ci`, `npm run build:release`, `npm run check:pack-artifact`, pakker
|
||||
tarballen, kører `npm run check:pack-boot` (falske secrets, midlertidig datamappe), pakker igen og
|
||||
mislykkes, medmindre digest-værdien er identisk, hvorefter den registrerer `artifact-identity.json` (head-SHA, base-
|
||||
SHA, lockfile-hash, platform, arkitektur, Node ABI, bundler, build-politik —
|
||||
`scripts/release/artifact-identity.mjs`) og attesterer tarballen i et separat job. Promovering
|
||||
af en preview betyder installation af denne tarball: genbyg aldrig fra kildekoden.
|
||||
Kørslen udfører `npm ci`, `npm run build:release`, `npm run check:pack-artifact`, pakker tarballen, kører `npm run check:pack-boot` (falske hemmeligheder, flygtige data dir), pakker om og mislykkes, medmindre digest er identisk, og optager derefter `artifact-identity.json` (head SHA, base SHA, lockfile hash, platform, arch, node ABI `scripts/release/artifact-identity.mjs` — et separat job. At promovere en forhåndsvisning betyder at installere denne tarball: genopbygg aldrig fra kilden.
|
||||
|
||||
### Udskæringen (3.9.0, efter GO)
|
||||
### Snittet (3.9.0, efter GO)
|
||||
|
||||
1. GO registreret i [LTS_GO_NO_GO.md](./LTS_GO_NO_GO.md).
|
||||
1. GO optaget i [LTS_GO_NO_GO.md](./LTS_GO_NO_GO.md).
|
||||
2. `npm run release:dry-run-lts-cut -- --from v3.9.0` udskriver `RESULT: READY`.
|
||||
3. Opret branchene på `origin` manuelt med de kommandoer, som prøvekørslen udskriver —
|
||||
scriptet nægter at pushe til `origin`. For at genbruge et gennemgået develop-commit skal du først køre
|
||||
`--execute`-afprøvningen på 3.9.0-spidsen mod din fork; den udskriver begge SHA'er, og
|
||||
de samme commits kan pushes:
|
||||
3. Opret grenene på `origin` i hånden med kommandoerne dry-run prints — scriptet nægter at skubbe til `origin`. For at genbruge en gennemgået udviklingsindsats skal du først køre `--execute` øvelsen på 3.9.0-spidsen mod din gaffel; den udskriver både SHAs, og de samme commits kan skubbes:
|
||||
|
||||
```bash
|
||||
git push origin <stable-sha>:refs/heads/stable/v3 <develop-sha>:refs/heads/develop
|
||||
```
|
||||
|
||||
4. Beskyt `stable/v3` og `develop` (regelsæt + fletningskø), før den første PR lander.
|
||||
5. De inaktive workflows aktiveres, når branchene findes: `forward-port.yml` (push til
|
||||
`stable/v3`), `validate-stable-pr.yml` (PR'er til `stable/v3`) og `nightly-v4-build.yml`
|
||||
(bygger `develop`). Før idriftsættelse skal repository-hemmeligheden `secrets.FORWARD_PORT_TOKEN` angives (så CI kører på
|
||||
forward-port-PR'er); natlig publicering forbliver deaktiveret, indtil ejeren angiver repository-variablen
|
||||
`vars.NIGHTLY_PUBLISH` til `true`, og npm Trusted Publishing accepterer
|
||||
`nightly-v4-build.yml`. Kanalbestemmelsen foretages af `scripts/release/dist-tag.mjs`, den samme
|
||||
resolver, som `npm-publish.yml` bruger.
|
||||
6. Verificer kanalerne: `npm view omniroute dist-tags --json` viser `latest` = 3.9.0 og ingen
|
||||
`next` / `nightly`, før v4 publiceres.
|
||||
7. Tilbagerulning om nødvendigt: `git push origin --delete refs/heads/stable/v3 refs/heads/develop`
|
||||
og `npm dist-tag add omniroute@3.8.59 latest`.
|
||||
4. Beskyt `stable/v3` og `develop` (regelsæt + merge queue) før den første PR lander.
|
||||
5. De sovende arbejdsgange tænder efter filialeksistens: `forward-port.yml` (push til `stable/v3`), `validate-stable-pr.yml` (PRs til `stable/v3`) og `nightly-v4-build.yml` (bygger `develop`). Inden start, skal du indstille `secrets.FORWARD_PORT_TOKEN` lagerhemmeligheden (så CI kører på forward-port PRs); natlig udgivelse forbliver slukket, indtil ejeren indstiller lagervariablen `vars.NIGHTLY_PUBLISH` til `true`, og npm Trusted Publishing accepterer `nightly-v4-build.yml`. Kanalopløsningen er `scripts/release/dist-tag.mjs`, den samme resolver `npm-publish.yml` bruger.
|
||||
6. Bekræft kanalerne: `npm view omniroute dist-tags --json` viser `latest` = 3.9.0 og ingen `next` / `nightly` indtil v4 udgives.
|
||||
7. Tilbageføring, hvis nødvendigt: `git push origin --delete refs/heads/stable/v3 refs/heads/develop` og `npm dist-tag add omniroute@3.8.59 latest`.
|
||||
|
||||
---
|
||||
|
||||
|
||||
@@ -140,37 +140,22 @@ gangen, og kun når den er inaktiv**, med inaktivitetskontrollen og genstarten i
|
||||
1,3 GB at lande på tmpfs og 2 minutter at uploade det fra disk.
|
||||
- `.15`-VPS'en er kun til homologering — den kører aldrig CI-runners.
|
||||
|
||||
## Hostet spor (GitHub-hostede runners)
|
||||
## Hosted bane (GitHub-hostede løbere)
|
||||
|
||||
Repositoriet tilhører organisationen `cheaper-inference` på **Team**-abonnementet: **60
|
||||
samtidige hostede jobs**, som deles af alle repositorier i organisationen, alle PR-kontroller,
|
||||
alle push-udløste workflows og CodeQL's standardopsætning. Tallene nedenfor blev målt på
|
||||
**Pro**-abonnementet (40 samtidige hostede jobs). Målt 2026-10-18 under en
|
||||
mergekampagne (~10 merges/time på `release/v3.8.52`): **2.500 workflowkørsler oprettet på
|
||||
24 timer**, 44 pushes til grenen på 6 timer, **106 hostede jobs i kø**, mens PR-kontroller ventede i
|
||||
timevis, og PR'er blev merget uden dem. Ni workflows blev udløst ved hvert push til grenen:
|
||||
Depotet tilhører `cheaper-inference` organisationen, på** Hold** plan:** 60 samtidige hostede job** , delt af hvert lager i organisationen, hver PR kontrol, hver push-udløst arbejdsgang og CodeQL's standardopsætning. Tallene nedenfor er målt på** Pro** plan (40 samtidige hostede job). Målt 2026-10-18 under en fusionskampagne (~ 10 merges/hour på `release/v3.8.52`):** 2.500 arbejdsgangskørsler oprettet på 24 timer** , 44 skubber til grenen på 6 timer,** 106 hostede job i kø** mens PR -checks ventede i timevis, og PRs blev slået sammen uden dem. Ni arbejdsgange affyret ved hvert skub til filialen:
|
||||
|
||||
| pr. push til `release/v*` | hostede jobs | resultat under stormen | siden 2026-10-18 |
|
||||
| ------------------------------------------- | -----------: | -------------------------------------------------------------- | --------------------------------------------------------------------------- |
|
||||
| `ci.yml` (fuld matrix) | op til 30 | annulleret af næste push, 24 ud af 24 på én dag | startes ikke ved pushes til `release/**` (PR-kørsel + Release-Green) |
|
||||
| `quality.yml` | ~6 | annulleret, 23 ud af 23 | startes ikke ved pushes til `release/**` |
|
||||
| `Release-Green` `--quick` | 0 | kørte på `omni-build`, 97 ud af 100 annulleret | `omni-release`-plads, annulleres aldrig, afventende kørsel slås sammen |
|
||||
| `Lock released branch`, `OpenSSF Scorecard` | 2 | én kørsel i kø pr. push | én kørsel pr. ref (`tests/unit/build/hosted-lane-concurrency.test.ts`) |
|
||||
| `Release acceptance` (skyggerapport) | 1 | ét hostet `npm ci` pr. push, aldrig annulleret | uændret — kandidat til et `paths:`-filter |
|
||||
| `Publish to Docker Hub` → `Deploy to VPS` | 2 | annulleret pr. push; amd64-delen konkurrerer på `omni-build` | uændret — ejerens implementeringskanal |
|
||||
| CodeQL-standardopsætning (`dynamic`) | 4 | `javascript-typescript`, `actions`, `c-cpp`, `python` pr. push | uændret — Indstillinger → Kodesikkerhed; `c-cpp`/`python` scanner intet her |
|
||||
| pr. tryk til `release/v*` | vært job | udfald under stormen | siden 2026-10-18 |
|
||||
| ------------------------------------------- | --------: | -------------------------------------------------------------- | --------------------------------------------------------------------------- |
|
||||
| `ci.yml` (fuld matrix) | op til 30 | annulleret ved næste tryk, 24 af 24 på en dag | ikke startet på `release/**` skub (PR run + Release-Green) |
|
||||
| `quality.yml` | ~6 | aflyst, 23 af 23 | ikke startet på `release/**` skub |
|
||||
| `Release-Green` `--quick` | 0 | kørte på `omni-build`, annullerede 97 af 100 | `omni-release` slot, aldrig annulleret, afventende kørsel kollapser |
|
||||
| `Lock released branch`, `OpenSSF Scorecard` | 2 | et køløb pr. tryk | et løb pr. ref (`tests/unit/build/hosted-lane-concurrency.test.ts`) |
|
||||
| `Release acceptance` (skyggerapport) | 1 | én hostet `npm ci` pr. push, aldrig annulleret | uændret — kandidat til et `paths:` filter |
|
||||
| `Publish to Docker Hub` → `Deploy to VPS` | 2 | annulleret pr. tryk; amd64 ben konkurrerer på `omni-build` | uændret — -ejers implementeringskanal |
|
||||
| CodeQL standardopsætning (`dynamic`) | 4 | `javascript-typescript`, `actions`, `c-cpp`, `python` pr. tryk | uændret — Indstillinger → Kodesikkerhed; `c-cpp`/`python` scanner intet her |
|
||||
|
||||
`tests/unit/build/push-storm-diet.test.ts` fastholder den push-trigger i `ci.yml` og
|
||||
`quality.yml`, som kun gælder for `main`. Bivirkning: Codecov modtager ikke længere en basisupload
|
||||
pr. release-push (trinnet er informativt og har `continue-on-error`); dækningskontrollen i
|
||||
repositoryet og PR-kommentaren påvirkes ikke.
|
||||
`tests/unit/build/push-storm-diet.test.ts` stifter `main` -only push-udløseren for `ci.yml` og `quality.yml`. Bivirkning: Codecov modtager ikke længere en basisupload pr. release-push (trinnet er informativt og `continue-on-error`); In-repo coverage gate og PR kommentar er upåvirket.
|
||||
|
||||
**Mere selvhostet kapacitet løser ikke køen for hostede jobs.** Devboxen
|
||||
(`devbox-vm-06-dev002`, 24 vCPU / 54 GB) kunne hoste en runner, men agentsessionerne holder
|
||||
allerede dens belastning på 20–26, agentcontaineren har ingen Docker-daemon, og det mættede spor
|
||||
er det hostede. `.113`-maskinen havde 71 GB ledig plads og en belastning på 5–8 på samme
|
||||
tidspunkt; dens begrænsning er hukommelsesbudgettet pr. listener ovenfor (maksimalt 6 listeners),
|
||||
ikke CPU. De resterende muligheder er procesmæssige: før kampagnens PR'er igennem Mergify-køen
|
||||
(`label=queue`, batches deler én `merge_group`-CI-kørsel i stedet for én kørsel pr. PR plus én
|
||||
pr. push), reducer sprogene i CodeQL's standardopsætning, og filtrer `release-acceptance.yml`
|
||||
efter de filer, den læser.
|
||||
**Mere selv-hostet kapacitet løser ikke den hostede kø.** Devboksen (`devbox-vm-06-dev002`, 24 vCPU / 54 GB) kunne være vært for en runner, men agentsessionerne holder allerede sin belastning på 20-26, agentbeholderen har ingen Docker dæmon, og den mættede bane er den hostede. `.113` boksen havde 71 GB fri og last 5-8 på samme tidspunkt; dens begrænsning er hukommelsesbudgettet pr. lytter ovenfor (loft 6 lyttere), ikke CPU. De resterende håndtag er proces-en: land kampagne PRs gennem Mergify-køen (`label=queue`, batches deler en `merge_group` CI -kørsel i stedet for én kørsel pr. PR plus en pr. push), trim CodeQL -standardopsætningssprogene, og filtrer `release-acceptance.yml` efter de filer, den læser.
|
||||
|
||||
> **2026-11-19: Mergify-fletningskøen er trukket tilbage** (ejers beslutning). `.mergify.yml` definerer ikke længere en kø og afviser de Mergify-kommandoer, der fusionerer eller omskriver en pull-anmodning. Release PRs flettes i hånden under repository-regelsættet "Kræv grønne porte på den aktive udgivelse" (`Gate / CI` + `Gate / Quality`) indtil omni-queue kører i live mode, og gennem omni-queue derefter ( [OMNI_QUEUE.md](./OMNI_QUEUE.md) ). Mergify-håndtaget ovenfor eksisterer ikke længere.
|
||||
|
||||
@@ -29,6 +29,8 @@ Jeder JSON -Beleg identifiziert den ausgecheckten SHA, die Workflow-Ausführung
|
||||
|
||||
### Warteschlange zusammenführen
|
||||
|
||||
> **19.11.2026: Die Mergify-Merge-Warteschlange wird eingestellt** (Entscheidung des Eigentümers). `.mergify.yml` definiert keine Warteschlange mehr und lehnt die Mergify-Befehle ab, die eine Pull-Anfrage zusammenführen oder neu schreiben. Release- PRs werden manuell unter dem Repository-Regelsatz „Erfordern grüne Gates für das aktive Release“ (`Gate / CI` + `Gate / Quality`) zusammengeführt, bis Omni-Queue im Live-Modus ausgeführt wird, und danach über Omni-Queue ( [OMNI_QUEUE.md](../ops/OMNI_QUEUE.md) ). Die unten beschriebene Workflow-Verarbeitung von Mergify-Entwürfen ist weiterhin in `ci.yml` und `quality.yml` vorhanden, es wird jedoch kein Mergify-Entwurf mehr geöffnet.
|
||||
|
||||
Das `queue` Label sendet einen PR an die Mergify-Warteschlange (`.mergify.yml`). Mergify öffnet einen PR -Entwurf in einem `mergify/merge-queue/` Zweig, CI führt dort die vollständige Auswahl aus und der ursprüngliche PR wird zusammengeführt, wenn `Gate / CI`, `Gate / Quality` und `Merge integrity (changelog + generated skills)` übergeben werden.
|
||||
|
||||
Mergify schreibt seine Warteschlangenzusammenfassung in die Beschreibung des Entwurfs und andere Apps können sie auch bearbeiten. Ein `pull_request` `edited` -Ereignis für einen solchen Entwurf benötigt eine eigene Parallelitätsgruppe (`-queue-edit-<run_id>`), sodass es die tatsächliche Ausführung des Entwurfs nicht abbrechen kann und das Gate und die Matrix überspringt. Nur `Merge integrity` läuft noch. Der übersprungene Gate-Job trägt einen anderen Prüfnamen, da Mergify einen übersprungenen `Gate / CI` als fehlgeschlagene Prüfung liest und den PR aus der Warteschlange entfernt.
|
||||
@@ -173,7 +175,7 @@ Eine Funktion PR bearbeitet nur englische Quellen. Die `docs/i18n/<locale>/**` S
|
||||
- Unit-Tests mit gespiegeltem Inhalt (`tests/_helpers/mirrorFreshness.ts`: `cycle-docs-mirror-contract`, `resilience-pre-dispatch-docs-mirrors`, `cli-env-quality-docs-mirrors`, `docs/*-locales`) — Release-Modus bestätigt jedes Gebietsschema. PR Modus bestätigt nur die Spiegelungen, die mit der englischen Quelle gemäß `.i18n-state.json` (Whole-File-Hash oder der aufgezeichnete Abschnitts-Hash des Abschnitts, den die Test-Pins darstellen) aktuell sind, und überspringt die veralteten Spiegelungen mit einem Grund. Die `target_hash` Herkunftsprüfungen werden für jedes Gebietsschema in beiden Modi ausgeführt. Die Frische gilt pro `## ` Abschnitt, die Einheit `run-translation.mjs` Hashes; Ein langer Abschnitt (das Gate-Inventar dieser Datei beträgt etwa die Hälfte davon) bedeutet, dass jede Bearbeitung darin diese Spiegel veraltet lässt und ihre PR-Modus-Behauptungen bis zur nächsten Welle überspringen. Ein Anker, der in der englischen Quelle nicht mehr enthalten ist, greift auf den Vergleich der gesamten Datei zurück.
|
||||
- `i18n translation drift` — -Hinweis zu PRs, strikt bei Push, Nightly und dem Release-Cut, sodass ein veralteter Mirror nicht in einem Release ausgeliefert werden kann.
|
||||
|
||||
`scripts/i18n/sync-llm-mirrors.mjs` (auch als `syncLlmMirrors()` exportiert, mit `--dry-run`) schreibt die `llm.txt` Spiegel neu; Die Release-Aktualisierung, die Übersetzungswelle und die geplante `i18n-mirror-refresh.yml` führen sie aus (die Aktualisierung erkennt veraltete `llm.txt` Spiegel mit einem Probelauf, da der Driftbericht sie nicht auflistet, und synchronisiert sie vor `check:docs-all`).
|
||||
`scripts/i18n/sync-llm-mirrors.mjs` (auch als `syncLlmMirrors()` exportiert, mit `--dry-run`) schreibt die `llm.txt` Spiegel neu; die Release-Aktualisierung, die Übersetzungswelle und die geplante `i18n-mirror-refresh.yml` -Ausführung (die Aktualisierung erkennt veraltete `llm.txt` Spiegel mit einem Probelauf, da der Driftbericht sie nicht auflistet, und synchronisiert sie vor `check:docs-all`).
|
||||
|
||||
Die zwölf README SVGs unter `docs/diagrams/` werden generiert (`scripts/docs/gen-readme-<name>.mjs`; `npm run docs:readme-diagrams` regeneriert sie alle). Jeder verfügt über einen Byte-Vergleichs-Einheitentest (`tests/unit/docs/readme-*-svg.test.ts`, Job `test-unit`), der fehlschlägt, wenn die festgeschriebene Datei im Release-Modus veraltet ist; In einem PR beurteilt `check:generated-artifacts` und SVG die PR -Änderungen und die Drift der Basis bleibt der Aktualisierung der Version überlassen (siehe [Generierte Dateien und abgeleitete Baselines](#generated-files-and-derived-baselines-written-at-release) ). — und `check:docs-counts` lesen kanonische Zahlen aus ihren `<text>` Knoten — weshalb der Outlining-Schritt jede umrissene Zeichenfolge in der Datei als unsichtbares `<text>` behält. Die SVG -Prüfung auf kanonische Zahlen liest die in `SVG_DIAGRAM_FILES` (`scripts/check/check-docs-counts-sync.mjs`) aufgeführten Dateien: `docs/diagrams/readme-hero.svg`, `free-tier-budget.svg`, `promise-pillars.svg`, `comparison-table.svg`, `cli-terminal.svg`, `tier-cascade.svg` sowie `public/images/tier-flow-dark.svg` und `tier-flow-light.svg`; Die Ansprüche „Für immer kostenlos“, „Katalogeintrag“, „Wiederkehrender Pool“ und „Bewertungsfaktoren“ lauten auch `promise-pillars.svg`, `free-tier-budget.svg` und `strategies-grid.svg`. Die von diesen Generatoren ermittelten Zahlen (Anbieter-Gesamtzahl, MCP Tools, Routing-Strategien, für immer kostenlose Anbieter usw.) stammen aus dem Fakten-Snapshot `docs/reference/derived-facts.json` bis `scripts/docs/readmeFacts.mjs` und nicht aus Literalen. Daher wird bei der Neugenerierung eines Diagramms in einem Zweig die festgeschriebene Datei reproduziert. `free-tier-budget.svg` bezieht seine Zeilen aus demselben Snapshot (`code.freeTierBudget`, die Katalogzusammenfassung, die die Faktenprobe aufzeichnet), sodass eine Änderung an `FREE_MODEL_BUDGETS` die Karte bei der nächsten Aktualisierung erreicht, anstatt CI rot zu färben.
|
||||
|
||||
@@ -196,7 +198,7 @@ Die Agent-Anweisungsdateien enthalten** NEIN** abgeleitete Anzahl überhaupt: `A
|
||||
|
||||
Im `pr` Modus können die Writer-Zweige verwaltete Werte bearbeiten: `chore/derived-*` (die nächtliche Aktualisierung PR), `release/v*` und die Übersetzungswellen `docs/i18n-*` und `chore/i18n-*` (`scripts/check/lib/derivedClaimsDiff.mjs`). Warteschlangenstapel (`merge_group`, Mergify Drafts, `omni-queue/**`) werden nicht erneut beurteilt: Sie summieren PRs das bereits beurteilte Gate nacheinander.
|
||||
|
||||
Exit-Codes: `0` clean · `1` STRICT drift (oder Soft drift mit `--strict`) oder eine Verletzung verwalteter Werte · `2` Infrastruktur — Die Codefakten konnten nicht erfasst werden (die tsx-Probe ist fehlgeschlagen oder es ist eine Zeitüberschreitung aufgetreten; das Timeout ist `OMNIROUTE_FACTS_TIMEOUT_MS`, Standard 600000 ms) oder in CI konnte die PR -Diff-Basis nicht aufgelöst werden. Ein Exit 2 stellt niemals eine Dokumentationsabweichung dar: Führen Sie den Job erneut aus oder reparieren Sie die Umgebung.
|
||||
Exit-Codes: `0` clean · `1` STRICT Drift (oder Soft Drift mit `--strict`) oder eine Verletzung verwalteter Werte · `2` Infrastructure — Die Codefakten konnten nicht erfasst werden (die tsx-Probe ist fehlgeschlagen oder es kam zu einer Zeitüberschreitung; die Zeitüberschreitung ist `OMNIROUTE_FACTS_TIMEOUT_MS`, Standard 600000 ms) oder in CI konnte die PR -Diff-Basis nicht aufgelöst werden. Ein Exit 2 stellt niemals eine Dokumentationsabweichung dar: Führen Sie den Job erneut aus oder reparieren Sie die Umgebung.
|
||||
|
||||
Wo jeder Modus ausgeführt wird:
|
||||
|
||||
@@ -212,7 +214,7 @@ Wo jeder Modus ausgeführt wird:
|
||||
Die Befehle dahinter:
|
||||
|
||||
- `npm run facts` gibt jede abgeleitete Zahl als JSON (`scripts/release/facts.mjs`) aus. `--key=code.mcpTools` gibt einen Wert aus, `--snapshot` liest den festgeschriebenen Snapshot anstelle des Live-Baums. Ausgang 2, wenn die Fakten nicht erfasst werden können.
|
||||
- `npm run release:refresh-derived` (`scripts/release/refresh-derived.mjs`) berechnet die abgeleiteten Dateien in einem Durchgang neu, in dieser Reihenfolge (Schritt-IDs für `--only=`): `provider-reference` (`docs/reference/PROVIDER_REFERENCE.md`), `facts` (der Snapshot), `numbers` (der Umschreibungsplan des Zählgatters, der auf die Dokumente angewendet und dann auf ihre `docs/i18n/` Spiegel übertragen wird), `readme-diagrams`, `skills` (generiertes `SKILL.md`), `e2e-timings` (übersprungen, bis der Baum `syncE2eTimings` versendet), `ui-keys` (Beschneidet die `en.json` gelöschten Schlüssel und stellt mit `--rewritten-since=<ref>` `origin/main` — — die seit der letzten Veröffentlichung neu geschriebenen englischen Werte erneut in die Warteschlange; die Werte werden im selben Lauf durch das in der Umgebung oder in `.env` konfigurierte Backend (`OMNIROUTE_TRANSLATION_*`, nur diese Schlüssel werden gelesen) oder durch die Google Engine übersetzt. Ohne ein Backend werden niemals `__MISSING__` -Marker geschrieben: Das Release-Profil schlägt fehl, die Nightly überspringt die Schlüssel und `--allow-untranslated` schreibt sie absichtlich.) `llm-mirrors` und `verify-generated` (nach einem Schreibvorgang müssen `check:generated-artifacts` und `check:agent-skills-sync` im Freigabemodus bestehen; werden in `--check` übersprungen und bei `--only` weggelassen; ein Fehler ist Exit 2). Der `changelog` Schritt ist Opt-in (`--with-changelog`, nur Release-Profil). `--profile=nightly` berührt niemals einen Versionsanspruch. Mit `-- --check` schreibt es nichts und beendet 1, wenn sich eine Datei ändern würde oder ein verwalteter Wert eine manuelle Bearbeitung erfordert (wobei beides aufgelistet wird); Ausgang 2 bei einem Infrastrukturausfall. `--json` gibt das Ergebnis als JSON aus.
|
||||
- `npm run release:refresh-derived` (`scripts/release/refresh-derived.mjs`) berechnet die abgeleiteten Dateien in einem Durchgang neu, in dieser Reihenfolge (Schritt-IDs für `--only=`): `provider-reference` (`docs/reference/PROVIDER_REFERENCE.md`), `facts` (der Snapshot), `numbers` (der Umschreibungsplan des Zählgatters, der auf die Dokumente angewendet und dann auf ihre `docs/i18n/` Spiegel übertragen wird), `readme-diagrams`, `skills` (generiertes `SKILL.md`), `e2e-timings` (übersprungen, bis der Baum `syncE2eTimings` versendet), `ui-keys` (Beschneidet die `en.json` gelöschten Schlüssel und stellt mit `--rewritten-since=<ref>` `origin/main` — — die seit der letzten Veröffentlichung neu geschriebenen englischen Werte erneut in die Warteschlange; die Werte werden im selben Lauf durch das in der Umgebung oder in `.env` konfigurierte Backend (`OMNIROUTE_TRANSLATION_*`, nur diese Schlüssel werden gelesen) oder durch die Google Engine übersetzt. Ohne ein Backend werden niemals `__MISSING__` -Marker geschrieben: Das Release-Profil schlägt fehl, die Nightly überspringt die Schlüssel und `--allow-untranslated` schreibt sie absichtlich.) `llm-mirrors` und `verify-generated` (nach einem Schreibvorgang müssen `check:generated-artifacts` und `check:agent-skills-sync` im Freigabemodus bestehen; werden in `--check` übersprungen und bei `--only` weggelassen; ein Fehler ist Exit 2). Der `changelog` Schritt ist Opt-in (`--with-changelog`, nur Release-Profil). `--profile=nightly` berührt niemals einen Versionsanspruch. Mit `-- --check` schreibt es nichts und beendet 1, wenn sich eine Datei ändern würde oder ein verwalteter Wert eine manuelle Bearbeitung erfordert (wobei beides aufgelistet wird); Ausgang 2 bei einem Infrastrukturfehler. `--json` gibt das Ergebnis als JSON aus.
|
||||
- `docs/reference/derived-facts.json` ist die Momentaufnahme der Fakten, die bei der letzten Aktualisierung verwendet wurden. Nur die Aktualisierung schreibt es. Die README SVG Generatoren lesen es und PR-Time-Unit-Tests vergleichen die festgeschriebenen Dokumente und generierten Dateien damit — niemals mit dem Live-Code. Der einzige Live-Vergleich der Suite ist „die Release-Aktualisierung schließt den Zyklus“ in `tests/unit/check-docs-counts-sync.test.ts`: Mit den Live-Fakten hinterlässt der im Speicher angewendete Rewrite-Plan der Aktualisierung keine STRICT Abweichung, die er nicht meldet, und eine Neuplanung ändert nichts.
|
||||
|
||||
So reproduzieren Sie lokal (eine lokale Ausführung ist standardmäßig `release`):
|
||||
@@ -241,7 +243,7 @@ Benötigt `fetch-depth: 0` — das Value-Drift-Gate unterscheidet `en.json` von
|
||||
|
||||
**Zwei Modi (seit 13.11.2026).** Eine Funktion PR fügt Schlüssel in `en.json` (und `bin/cli/locales/en.json`) hinzu oder schreibt sie neu und berührt kein anderes Gebietsschema; `check:pr-derived-paths` (Job `pr-test-policy`, Familie `config/quality/derived-paths/translation.json`) schlägt bei einer Funktion PR fehl, die dies tut. Die anderen Gebietsschemata werden einmal pro Veröffentlichung durch `release:refresh-derived` vervollständigt, das `syncUiKeys()` in `scripts/i18n/sync-ui-keys.mjs` aufruft (fehlende Schlüssel hinzufügen, weggelassene Schlüssel bereinigen, Übersetzungen von umgeschriebenem Englisch mit `rewrittenSinceRef` markieren, übersetzen) oder durch eine Übersetzungswelle. Die Tore lesen den Modus von `scripts/check/lib/gateMode.mjs`: Im `pr` Modus (Funktion PRs, `merge_group`, `omni-queue/**`) drucken die Release-Modus-Gates oben `SKIP reason=pr-mode` und beenden 0; Im `release` Modus (das Release PR, pusht zu `main`, `workflow_dispatch`, lokale Läufe) sind sie streng wie zuvor, und beim Release PR erhalten die Diff-bewussten `BASE_REF=origin/main`, sodass sie jeden Schlüssel beurteilen, den der Zyklus hinzugefügt oder neu geschrieben hat. Sehen Sie sich das Feature-PR-Urteil lokal mit `--mode=pr` in der Vorschau an.
|
||||
|
||||
Ein PR, der weiterhin Gebietsschemakataloge im `pr` Modus ändert (eine Übersetzungswelle, die Veröffentlichungsaktualisierung, ein nur auf die Übersetzung beschränkter Fix), wird nicht übersprungen: `check-key-completeness` beurteilt jeden geänderten Katalog anhand desselben Katalogs an der Zusammenführungsbasis (`scripts/i18n/lib/touched-catalogs.mjs`) und schlägt fehl, wenn der Katalog einen Schlüssel verloren hat, ein Schlüssel `en.json` fehlt, eine echte Übersetzung in einen `__MISSING__:` Marker oder in den englischen Text umgewandelt wurde oder einen Wert, der den placeholders/tags einer englischen Zeichenfolge nicht mehr interpoliert, was PR nicht tat berühren. Ein neuer Katalog im PR muss den gesamten `en.json` -Schlüsselsatz enthalten. Das deckt für die Kataloge, die ein PR berührt, ab, was die Verhältnis- und CLI-Paritätstore sehen würden.
|
||||
Ein PR, der weiterhin Gebietsschemakataloge im `pr` Modus ändert (eine Übersetzungswelle, die Veröffentlichungsaktualisierung, ein nur auf die Übersetzung beschränkter Fix), wird nicht übersprungen: `check-key-completeness` beurteilt jeden geänderten Katalog anhand desselben Katalogs an der Zusammenführungsbasis (`scripts/i18n/lib/touched-catalogs.mjs`) und schlägt fehl, wenn der Katalog einen Schlüssel verloren hat, ein `en.json` Schlüssel fehlt, eine echte Übersetzung in einen `__MISSING__:` Marker oder in den englischen Text umgewandelt wurde oder einen Wert, der den placeholders/tags einer englischen Zeichenfolge nicht mehr interpoliert, was PR nicht tat berühren. Ein neuer Katalog im PR muss den gesamten `en.json` -Schlüsselsatz enthalten. Das deckt für die Kataloge, die ein PR berührt, ab, was die Verhältnis- und CLI-Paritätstore sehen würden.
|
||||
|
||||
Die Locale-Parity-Unit-Tests (`cli-i18n-catalog`, `i18n-pt-br`, `i18n-vi-completeness`, `i18n-placeholder-parity`) folgen den gleichen Modi bis `tests/_helpers/localeParityMode.ts`: Im `pr` Modus überspringen sie Schlüsselparitätszusicherungen und überlassen der Release-Aktualisierung die Platzhalterparität von Schlüsseln, deren Englisch sich seit der Zusammenführungsbasis geändert hat (jeder Schlüssel kann beim flachen Auschecken des Unit-Test-Jobs nicht gelesen werden). Dieser Helfer ist der** nur** Sanktioniertes modusbedingtes Überspringen: `check:test-masking` zählt `.skip(` und `{ skip: true }`, aber nicht das berechnete `{ skip: "<reason>" }` das es zurückgibt, daher pinnen `tests/unit/locale-parity-mode.test.ts` die Liste der Tests an, die es verwenden dürfen — Das Hinzufügen eines solchen Tests ist eine überprüfte Bearbeitung dieser Liste.
|
||||
|
||||
@@ -249,20 +251,20 @@ Die Locale-Parity-Unit-Tests (`cli-i18n-catalog`, `i18n-pt-br`, `i18n-vi-complet
|
||||
|
||||
Fängt die eine i18n-Regression ab, die die anderen Tore strukturell nicht sehen können: Ein englischer Wert wird umgeschrieben und die aus dem _vorherigen_ Englisch abgeleiteten Übersetzungen bleiben erhalten, sodass nicht-englische Benutzer weiterhin sicher formulierte, jetzt falsche Kopien lesen.
|
||||
|
||||
Das wurde echt geliefert. `oauthModal.googleOAuthWarning` wurde neu geschrieben, als der Antigravity-Anmeldehelfer landete (#5203);** 39 von 43 Orten** Behalten Sie den Text bei, der die Bediener auffordert, „den vollständigen URL zu kopieren und unten einzufügen“. — einen Fluss erstellt, der für diesen Anbieter nicht abgeschlossen werden kann. Es blieb bis #8463 unbemerkt, weil:
|
||||
Das wurde echt geliefert. `oauthModal.googleOAuthWarning` wurde neu geschrieben, als der Antigravity -Anmeldehelfer landete (#5203);** 39 von 43 Orten** Behalten Sie den Text bei, der die Bediener auffordert, „den vollständigen URL zu kopieren und unten einzufügen“ — einen Fluss, der für diesen Anbieter nicht abgeschlossen werden kann. Es blieb bis #8463 unbemerkt, weil:
|
||||
|
||||
- `sync-ui-keys` füllt nur Schlüssel auf, die vorhanden sind** abwesend** , niemals diejenigen, die es sind** abgestanden** ;
|
||||
- `check-ui-keys-coverage` zählt die _Präsenz_ des Schlüssels, sodass eine veraltete Übersetzung als abgedeckt gilt;
|
||||
- `check-translation-drift` verfolgt die `docs/i18n/<locale>/**.md` -Dokumentation und spiegelt — wider, es liest niemals `src/i18n/messages/*.json`. Es läuft im Job `docs-sync-strict`: Advisory auf PRs, strikt bei Push und nächtlich; Die Übersetzungswelle aktualisiert die Spiegel, nicht die Funktion PR.
|
||||
|
||||
**Differenzbewusst, nicht baseline-unterstützt.** Es vergleicht `en.json` an der Zusammenführungsbasis mit dem Arbeitsbaum; Für jeden Schlüssel, dessen englischer Wert sich geändert hat, ist jedes Gebietsschema, das noch eine unberührte Übersetzung enthält, veraltet. Dies bewusst** Friert bereits bestehende Schulden ein** — a diff kann nicht offenbaren, aus welchem alten Englisch eine langjährige Übersetzung stammt, daher beurteilt das Gate nur, was die aktuelle Änderung betrifft. Die Alternative (eine Hash-Basislinie pro Schlüssel) würde eine generierte Datei ~ 600 KB kosten, 3 × die größte vorhandene Basislinie, die bei jedem i18n PR abwandert.
|
||||
**Differenzbewusst, nicht baseline-unterstützt.** Es vergleicht `en.json` an der Zusammenführungsbasis mit dem Arbeitsbaum; Für jeden Schlüssel, dessen englischer Wert sich geändert hat, ist jedes Gebietsschema, das noch eine unberührte Übersetzung enthält, veraltet. Dies bewusst** Friert bereits bestehende Schulden ein** — a diff kann nicht offenbaren, aus welchem alten Englisch eine langjährige Übersetzung stammt, daher beurteilt das Gate nur, was die aktuelle Änderung betrifft. Die Alternative (eine Pro-Schlüssel-Hash-Baseline) würde eine generierte Datei ~ 600 KB kosten, 3 × die größte existierende Baseline, die bei jedem i18n PR abwandert.
|
||||
|
||||
Zwei Möglichkeiten, es zu befriedigen:
|
||||
|
||||
1. die betroffenen Übersetzungen aktualisieren, oder
|
||||
2. Setzen Sie sie auf `__MISSING__:<new english>` — Die Laufzeit stellt dann das korrigierte Englisch (`src/i18n/request.ts::deepMergeFallback`, #7258) und die Schlüsselwarteschlangen zur Übersetzung bereit.
|
||||
|
||||
If the string's** Bedeutung** changed, prefer** renaming the key** : Ein neuer Schlüssel kann keine veraltete Übersetzung erben. Das ist das Muster, #8463 verwendet hat.
|
||||
Wenn die Zeichenfolge** Bedeutung** geändert, lieber** Umbenennen des Schlüssels** : Ein neuer Schlüssel kann keine veraltete Übersetzung erben. Das ist das Muster, #8463 verwendet hat.
|
||||
|
||||
```bash
|
||||
npm run i18n:check-value-drift # strict (what CI runs)
|
||||
@@ -274,11 +276,11 @@ Beendet 0 mit `SKIP reason=base-unresolved`, wenn der Basiskatalog nicht gelesen
|
||||
|
||||
### Arbeit: `i18n`
|
||||
|
||||
Vollständige i18n-Validierungsmatrix (ein Job pro Gebietsschema). Entire job is advisory.
|
||||
Vollständige i18n-Validierungsmatrix (ein Job pro Gebietsschema). Die gesamte Arbeit ist beratend.
|
||||
|
||||
| Skript | Validiert | Blockierung |
|
||||
| ------------------------------- | ------------------------------------------------- | ----------------------------------------------------- |
|
||||
| `validate_translation.py quick` | Vollständigkeit der Übersetzung pro Gebietsschema | **Beratung** (`continue-on-error: true` on whole job) |
|
||||
| Skript | Validiert | Blockierung |
|
||||
| ------------------------------- | ------------------------------------------------- | ------------------------------------------------------------- |
|
||||
| `validate_translation.py quick` | Vollständigkeit der Übersetzung pro Gebietsschema | **Beratung** (`continue-on-error: true` für den gesamten Job) |
|
||||
|
||||
### Arbeit: `pr-test-policy`
|
||||
|
||||
@@ -294,14 +296,14 @@ Wird nur auf Pull-Anfragen ausgeführt.
|
||||
|
||||
Läuft nach `build`. Bei einem Fehler werden Blöcke zusammengeführt.
|
||||
|
||||
| Suite | Validiert | Blockierung |
|
||||
| ---------------- | -------------------------------------------------------- | --------------------------------------------------------------------------------------------------------------------- |
|
||||
| `test:vitest` | MCP server (110 tools), autoCombo, cache — vitest runner | Ja |
|
||||
| `test:vitest:ui` | UI Komponente testet — Vitest-Runner | **Blockierung** — pre-existing failures are explicitly excluded in `vitest.config.ts`; Neue Ausfälle scheitern am Job |
|
||||
| Suite | Validiert | Blockierung |
|
||||
| ---------------- | -------------------------------------------------------- | -------------------------------------------------------------------------------------------------------------------------------- |
|
||||
| `test:vitest` | MCP Server (110 Tools), autoCombo, Cache — Vitest Runner | Ja |
|
||||
| `test:vitest:ui` | UI Komponente testet — Vitest-Runner | **Blockierung** — bereits vorhandene Fehler werden in `vitest.config.ts` explizit ausgeschlossen; Neue Ausfälle scheitern am Job |
|
||||
|
||||
### Nächtliche Arbeitsabläufe (geplant, beratend)
|
||||
|
||||
These run on a cron schedule (and `workflow_dispatch`), never on PRs. Alle sind beratend.
|
||||
Diese laufen nach einem Cron-Zeitplan (und `workflow_dispatch`), niemals nach PRs. Alle sind beratend.
|
||||
|
||||
| Arbeitsablauf | Validiert | Blockierung |
|
||||
| ---------------------- | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------ | ------------ |
|
||||
|
||||
@@ -4,14 +4,9 @@
|
||||
|
||||
---
|
||||
|
||||
OmniRoute verwendet ein **Parallelzyklus**-Release-Modell: einen dedizierten Branch `release/vX.Y.Z`
|
||||
für den aktiven Zyklus, `main` für die veröffentlichte Linie und ein unveränderliches
|
||||
`vX.Y.Z`-Tag, sobald dieser Zyklus veröffentlicht wird. Dass Commits sowohl auf `release/*` _als auch_ auf
|
||||
`main` landen, ist zu erwarten — es handelt sich nicht um eine Verwechslung.
|
||||
OmniRoute verwendet a** Parallelzyklus** Release-Modell: ein dedizierter `release/vX.Y.Z` Zweig für den aktiven Zyklus, `main` für die veröffentlichte Zeile und ein unveränderliches `vX.Y.Z` Tag, wenn dieser Zyklus ausgeliefert wird. Es ist zu erwarten, dass Commits auf `release/*` _und_ auf `main` landen, — ist keine Verwechslung.
|
||||
|
||||
Details für Maintainer befinden sich in `CLAUDE.md` (Feste Regel Nr. 21) und
|
||||
[RELEASE_CHECKLIST.md](./RELEASE_CHECKLIST.md). Diese Seite ist die öffentliche,
|
||||
an Mitwirkende gerichtete Zusammenfassung.
|
||||
Betreuerdetails befinden sich in `CLAUDE.md` (Hard Rule #21) und [RELEASE_CHECKLIST.md](./RELEASE_CHECKLIST.md). Diese Seite ist die öffentliche Zusammenfassung für Mitwirkende.
|
||||
|
||||
## Auf einen Blick
|
||||
|
||||
@@ -42,25 +37,23 @@ flowchart LR
|
||||
`main` ist nicht der Integrations-Branch für die tägliche Entwicklung. PRs, die gegen `main`
|
||||
geöffnet werden, müssen vor dem Merge normalerweise auf einen anderen Ziel-Branch umgestellt werden.
|
||||
|
||||
## Release-Freeze (parallele Zyklen)
|
||||
## Release Freeze (parallele Zyklen)
|
||||
|
||||
Wenn ein Release abgeglichen wird, wird ein Markierungs-Issue mit dem Label `release-freeze`
|
||||
geöffnet. Das **hält die Entwicklung nicht auf**:
|
||||
Wenn ein Release abgeglichen wird, wird ein Markierungsproblem mit der Bezeichnung `release-freeze` geöffnet. Das** stoppt die Entwicklung nicht** :
|
||||
|
||||
- Der eingefrorene Branch `release/vX.Y.Z` gehört für dieses Release dem Release-Captain.
|
||||
- Der nächste Zyklus `release/vX+1` wird von der eingefrorenen Spitze abgezweigt, damit Mitwirkende ihre
|
||||
Arbeit weiterhin einbringen können.
|
||||
- Offene PRs, die weiterhin auf den eingefrorenen Branch abzielen, sollten auf den
|
||||
aktiven (höchsten) Branch `release/v*` **umgestellt** werden.
|
||||
- Der gefrorene `release/vX.Y.Z` gehört dem Freilassungskapitän dieses Schiffes.
|
||||
- Der `release/vX+1` des nächsten Zyklus wird von der gefrorenen Spitze abgeschnitten, sodass die Mitwirkenden mit der Landungsarbeit fortfahren können.
|
||||
- Öffnen Sie PRs, das immer noch auf den eingefrorenen Zweig abzielen sollte** neu ausgerichtet** zum aktiven (höchsten) `release/v*` Zweig.
|
||||
|
||||
Prüfe, ob ein offener Freeze besteht, bevor du davon ausgehst, dass der gewünschte Branch zusammengeführt werden kann:
|
||||
Überprüfen Sie, ob ein offenes Einfrieren vorliegt, bevor Sie davon ausgehen, dass der gewünschte Zweig zusammengeführt werden kann:
|
||||
|
||||
```bash
|
||||
gh issue list --repo diegosouzapw/OmniRoute --label release-freeze --state open
|
||||
```
|
||||
|
||||
Die Merge-Mechanik (`queue`-Label des Owners → Mergify) ist in
|
||||
[MERGE_TRAIN.md](./MERGE_TRAIN.md) dokumentiert.
|
||||
Merge-Mechaniken (Eigentümer `queue` label → Mergify) sind in [MERGE_TRAIN.md](./MERGE_TRAIN.md) dokumentiert.
|
||||
|
||||
> **19.11.2026: Die Mergify-Merge-Warteschlange wird eingestellt** (Entscheidung des Eigentümers). `.mergify.yml` definiert keine Warteschlange mehr und lehnt die Mergify-Befehle ab, die eine Pull-Anfrage zusammenführen oder neu schreiben. Release- PRs werden manuell unter dem Repository-Regelsatz „Erfordern grüne Gates für das aktive Release“ (`Gate / CI` + `Gate / Quality`) zusammengeführt, bis Omni-Queue im Live-Modus ausgeführt wird, und danach über Omni-Queue ( [OMNI_QUEUE.md](./OMNI_QUEUE.md) ). Das `queue` Label führt nichts mehr zusammen.
|
||||
|
||||
## Warum sowohl ein Branch als auch ein Tag?
|
||||
|
||||
|
||||
@@ -4,10 +4,9 @@
|
||||
|
||||
---
|
||||
|
||||
Seit v3.8.49 (WS3.2/WS3.4 des Qualitäts-/Geschwindigkeitsplans) ist der standardmäßige Merge-Pfad für
|
||||
reviewte PRs nach `release/vX.Y.Z` die **Mergify-Merge-Queue** (`.mergify.yml`);
|
||||
der unten dokumentierte **manuelle Merge-Train** ist die RÜCKFALLEBENE — er wird bei Störungen,
|
||||
Release-Freezes oder dann verwendet, wenn sich der Mergify-Open-Source-Tarif jemals ändert.
|
||||
> **19.11.2026: Die Mergify-Merge-Warteschlange wird eingestellt** (Entscheidung des Eigentümers). `.mergify.yml` definiert keine Warteschlange mehr und lehnt die Mergify-Befehle ab, die eine Pull-Anfrage zusammenführen oder neu schreiben. Release- PRs werden manuell unter dem Repository-Regelsatz „Erfordern grüne Gates für das aktive Release“ (`Gate / CI` + `Gate / Quality`) zusammengeführt, bis Omni-Queue im Live-Modus ausgeführt wird, und danach über Omni-Queue ( [OMNI_QUEUE.md](./OMNI_QUEUE.md) ). In den folgenden Mergify-Abschnitten wird die Warteschlange so beschrieben, wie sie war.
|
||||
|
||||
Seit v3.8.49 (WS3.2/WS3.4 des quality/velocity Plans) ist der Standard-Mergepfad für überprüftes PRs in `release/vX.Y.Z` der** Zusammenführungswarteschlange zusammenführen** (`.mergify.yml`); Die** manueller Zusammenführungszug** Unten dokumentiert ist das FALLBACK — das bei Vorfällen, Release-Einfrierungen oder wenn sich der Mergify Open Source-Plan jemals ändert, verwendet wird.
|
||||
|
||||
## Standardpfad: die Mergify-Warteschlange
|
||||
|
||||
|
||||
@@ -355,113 +355,70 @@ Vor der Veröffentlichung eines v3.8.x-Releases diese zusätzlichen Punkte über
|
||||
|
||||
---
|
||||
|
||||
## 3.9.0-LTS-Abzweigung (in 3.8.58 erprobt)
|
||||
## 3.9.0 LTS -Schnitt (in 3.8.58 einstudiert)
|
||||
|
||||
Nach v3.8.59 ist die nächste Version 3.9.0, und ihre Spitze wird zum Ausgangspunkt zweier langlebiger Branches:
|
||||
`stable/v3` (die v3-LTS-Linie, npm `latest`) und `develop` (v4, auf 4.0.0 angehoben, npm
|
||||
`nightly`). Das Branch-/Kanalmodell, der Forward-Port und die Labels sind in
|
||||
[RELEASE_STRATEGY.md](./RELEASE_STRATEGY.md) beschrieben; der Plan befindet sich in der [ROADMAP](../../ROADMAP.md) (Phase 3). Die Abzweigung wird einmal durchgeführt;
|
||||
3.8.58 erprobt sie vollständig auf einem Fork, und 3.8.59 schließt mit der
|
||||
[GO/NO-GO-Checkliste](./LTS_GO_NO_GO.md) ab.
|
||||
Nach v3.8.59 ist die nächste Version 3.9.0, und ihre Spitze wird zu zwei langlebigen Zweigen: `stable/v3` (die v3- LTS Linie, npm `latest`) und `develop` (v4, angehoben auf 4.0.0, npm `nightly`). Das branch/channel Modell, der Forward-Port und die Labels befinden sich in [RELEASE_STRATEGY.md](./RELEASE_STRATEGY.md) ; Der Plan befindet sich im [ROADMAP](../../ROADMAP.md) (Phase 3). Der Schnitt läuft einmal; 3.8.58 probt es Ende für Ende auf einer Verzweigung und 3.8.59 schließt mit der [GO/NO-GO -Checkliste](./LTS_GO_NO_GO.md).
|
||||
|
||||
### Probelauf (schreibgeschützt, jederzeit sicher)
|
||||
|
||||
```bash
|
||||
npm run release:dry-run-lts-cut # die echte Abzweigung: 3.9.0 von HEAD, vorheriges Tag v3.8.59
|
||||
npm run release:dry-run-lts-cut -- --from <3.9.0-tip> # Quell-Commit festlegen
|
||||
npm run release:dry-run-lts-cut # the real cut: 3.9.0 from HEAD, previous tag v3.8.59
|
||||
npm run release:dry-run-lts-cut -- --from <3.9.0-tip> # pin the source commit
|
||||
```
|
||||
|
||||
`scripts/release/dry-run-lts-cut.mjs` führt nichts aus: Es liest git und `gh` aus und gibt die
|
||||
gesamte Abfolge aus — Voraussetzungen (die Quelle kann aufgelöst werden, das Quell-Repository verfügt über den vollständigen Verlauf —
|
||||
ein flacher Klon kann `stable/v3` nicht pushen, die empfangende Seite weist das Paket beim ersten
|
||||
aufgepfropften Parent zurück; führen Sie die Abzweigung daher von einem vollständigen Klon aus oder führen Sie zuerst
|
||||
`git fetch --unshallow origin` aus — das vorherige Tag ist vorhanden, `package.json` enthält die Zielversion, ein
|
||||
`release-freeze`-Issue ist offen, es gibt kein offenes
|
||||
`Release branch not green`-Issue
|
||||
auf einem vorhandenen Release-Branch — ein nicht vorhandener Branch meldet `?` als unbekannt, niemals
|
||||
grün — die Mergify-`release`-Queue ist konfiguriert (G11: `queue_rules`, `checks_timeout`,
|
||||
Label `queue`), das `release/*`-Regelwerk blockiert weiterhin das Löschen und Force-Pushes, und
|
||||
`stable/v3` sowie `develop` sind noch nicht vorhanden), die beiden Branch-Schritte, welche Trigger
|
||||
inaktiver Workflows und `if:`-Bedingungen wahr werden (und welche weiterhin durch eine Repository-Variable
|
||||
gesperrt oder auf das kanonische Repository festgelegt bleiben), die erwarteten Dist-Tags (`latest` → 3.9.0,
|
||||
`next` und `nightly` leer) sowie das Rollback. Exit `0` = `RESULT: READY`, `1` = eine blockierende Voraussetzung
|
||||
ist fehlgeschlagen (`✗`), `2` = Verwendungsfehler. `--advisory <id,...>` stuft eine Prüfung zu einer Warnung (`!`)
|
||||
herab, ohne sie auszublenden.
|
||||
`scripts/release/dry-run-lts-cut.mjs` führt nichts aus: Es liest git und `gh` und gibt die gesamte Sequenz aus — -Vorbedingungen (Quelle wird aufgelöst, das Quell-Repository hat den vollständigen Verlauf — ein flacher Klon kann `stable/v3` nicht pushen, die empfangende Seite lehnt das Paket beim ersten gepfropften übergeordneten Element ab, also schneidet es von einem vollständigen Klon oder `git fetch --unshallow origin` ab, erstes — Vorheriges-Tag existiert, `package.json` ist die Zielversion, ein `release-freeze` Problem ist offen, kein offenes `Release branch not green` Problem auf einem bestehenden Release-Zweig — a Zweig, der nicht existiert, meldet `?` unbekannt, nie grün. Die — -Omni-Warteschlange landet den Release- PRs (G11: `config/merge-queue/config.json` gültig, sein `bases` verwaltet den Release-Zweig, `mode` `live`, sein Label existiert), der `release/*` Regelsatz blockiert immer noch Löschung und Force-Push, und `stable/v3` und `develop` existieren noch nicht), die beiden Verzweigungsschritte, die Ruhe-Workflow auslösen und `if:` Bedingungen wahr werden (und die durch a Repository-Variable oder an das kanonische Repository angeheftet), die erwarteten Dist-Tags (`latest` → 3.9.0, `next` und `nightly` leer) und das Rollback. Exit `0` = `RESULT: READY`, `1` = eine Blockierungsvorbedingung fehlgeschlagen (`✗`), `2` = Verwendungsfehler. `--advisory <id,...>` stuft einen Scheck auf eine Warnung (`!`) herab, ohne ihn auszublenden.
|
||||
|
||||
Führen Sie den Probelauf der echten Abzweigung aus, solange der Release-Freeze für 3.9.0 noch aktiv ist — die Branches werden
|
||||
nach dem Tag und bevor Phase 12c den Freeze aufhebt erstellt.
|
||||
Führen Sie den Probelauf des echten Schnitts aus, während der 3.9.0-Release-Freeze noch offen ist — die Zweige nach dem Tag erstellt werden und bevor Phase 12c den Freeze aufhebt.
|
||||
|
||||
### 3.8.58-Erprobung (nur Fork)
|
||||
### 3.8.58 Probe (nur Gabel)
|
||||
|
||||
```bash
|
||||
# 1. Probelauf auf der aktuellen Spitze mit Erprobungsparametern
|
||||
# 1. Dry-run on the current tip with rehearsal parameters
|
||||
npm run release:dry-run-lts-cut -- --target-version 3.8.58 --previous-tag v3.8.57 \
|
||||
--advisory freeze,base-green
|
||||
|
||||
# 2. Gegen ein FORK-Remote ausführen (origin oder jedes Remote, dessen URL dem kanonischen
|
||||
# Repository entspricht, wird abgelehnt; jeder Schritt fordert im Terminal eine Bestätigung an)
|
||||
# 2. Execute against a FORK remote (origin, or any remote whose URL is the canonical
|
||||
# repository, is refused; every step asks for confirmation on the terminal)
|
||||
git remote add rehearsal https://github.com/<you>/OmniRoute.git
|
||||
node scripts/release/dry-run-lts-cut.mjs --execute --remote rehearsal \
|
||||
--target-version 3.8.58 --previous-tag v3.8.57 --advisory freeze,base-green
|
||||
|
||||
# 3. Die inaktiven Workflows im Fork durchlaufen lassen (workflow_dispatch, wenn der Probelauf
|
||||
# eine Festlegung auf das kanonische Repository meldet), anschließend zurücksetzen
|
||||
# 3. Exercise the dormant workflows in the fork (workflow_dispatch where the dry-run
|
||||
# reports a canonical-repository pin), then roll back
|
||||
node scripts/release/dry-run-lts-cut.mjs --execute --rollback --remote rehearsal \
|
||||
--target-version 3.8.58 --previous-tag v3.8.57 --advisory freeze,base-green
|
||||
```
|
||||
|
||||
Der Commit zum Anheben von develop wird mit Git-Plumbing erstellt (der Arbeitsbaum bleibt unberührt) und hebt
|
||||
dieselben fünf Dateien wie ein Commit zur Zykluseröffnung an: `package.json`, `open-sse/package.json`,
|
||||
`electron/package.json`, `package-lock.json` und `docs/openapi.yaml`. Der Abschnitt `[4.0.0]`
|
||||
im CHANGELOG und seine i18n-Entsprechungen werden anschließend auf `develop` eröffnet, noch vor dessen erstem
|
||||
PR. Das Skript ändert niemals npm-Dist-Tags — erproben Sie diese mit einem Wegwerf-Paket.
|
||||
Der Develop-Bump-Commit wird mit Git-Plumbing erstellt (kein Arbeitsbaum wird berührt) und stößt dieselben fünf Dateien wie ein Cycle-Open-Commit an: `package.json`, `open-sse/package.json`, `electron/package.json`, `package-lock.json` und `docs/openapi.yaml`. Der Abschnitt `[4.0.0]` CHANGELOG und seine i18n-Spiegel werden anschließend auf `develop` vor seinem ersten PR geöffnet. Das Skript ändert niemals die npm dist-tags — und testet diese auf einem Scratch-Paket.
|
||||
|
||||
### PR-Vorschauartefakt (einmal bauen, dieselben Bytes übernehmen)
|
||||
### PR -Vorschauartefakt (einmal erstellen, dieselben Bytes hochstufen)
|
||||
|
||||
`.github/workflows/preview-artifact.yml` erstellt einen Produktions-Tarball von der Spitze eines PRs und
|
||||
validiert exakt diesen Build (Ausschnitt (a) von #8084). Nur PRs aus demselben Repository; es wird nichts veröffentlicht.
|
||||
`.github/workflows/preview-artifact.yml` erstellt einen Produktions-Tarball aus einem PR Kopf und validiert genau diesen Build (#8084 -Slice (a)). Nur Same-Repository PRs ; nichts wird veröffentlicht.
|
||||
|
||||
```bash
|
||||
gh workflow run preview-artifact.yml -f pr_number=<N> # oder das Label `preview-artifact` hinzufügen
|
||||
gh workflow run preview-artifact.yml -f pr_number=<N> # or add the `preview-artifact` label
|
||||
gh run download <run-id> --name preview-artifact-pr<N>-<sha7> --dir preview
|
||||
cd preview && sha256sum -c SHA256SUMS
|
||||
gh attestation verify omniroute-*.tgz --repo diegosouzapw/OmniRoute
|
||||
npm install -g ./omniroute-*.tgz # Vorschauinstallation
|
||||
npm install -g ./omniroute-*.tgz # preview install
|
||||
```
|
||||
|
||||
Der Lauf führt `npm ci`, `npm run build:release` und `npm run check:pack-artifact` aus, packt den
|
||||
Tarball, führt `npm run check:pack-boot` aus (gefälschte Secrets, temporäres Datenverzeichnis), packt ihn
|
||||
erneut und schlägt fehl, sofern der Digest nicht identisch ist. Anschließend zeichnet er
|
||||
`artifact-identity.json` auf (Head-SHA, Base-SHA, Lockfile-Hash, Plattform, Architektur, Node-ABI,
|
||||
Bundler, Build-Richtlinie — `scripts/release/artifact-identity.mjs`) und attestiert den Tarball in einem
|
||||
separaten Job. Eine Vorschau zu übernehmen bedeutet, diesen Tarball zu installieren: niemals erneut aus
|
||||
dem Quellcode bauen.
|
||||
Der Lauf führt `npm ci`, `npm run build:release`, `npm run check:pack-artifact` aus, packt den Tarball, führt `npm run check:pack-boot` (gefälschte Geheimnisse, ephemeres Datenverzeichnis) aus, packt neu und schlägt fehl, sofern der Digest nicht identisch ist, zeichnet dann `artifact-identity.json` auf (Kopf SHA, Basis SHA, Lockfile-Hash, Plattform, Arch, Knoten ABI, Bundler, Build-Richtlinie — `scripts/release/artifact-identity.mjs`) und attestiert den Tarball in einem separaten Job. Um eine Vorschau zu bewerben, muss dieser Tarball installiert werden: Niemals aus dem Quellcode neu erstellen.
|
||||
|
||||
### Die Abzweigung (3.9.0, nach GO)
|
||||
### Der Schnitt (3.9.0, nach GO)
|
||||
|
||||
1. GO ist in [LTS_GO_NO_GO.md](./LTS_GO_NO_GO.md) festgehalten.
|
||||
1. GO wurde in [LTS_GO_NO_GO.md](./LTS_GO_NO_GO.md) aufgezeichnet.
|
||||
2. `npm run release:dry-run-lts-cut -- --from v3.9.0` gibt `RESULT: READY` aus.
|
||||
3. Erstellen Sie die Branches auf `origin` manuell mit den vom Probelauf ausgegebenen Befehlen — das
|
||||
Skript verweigert Pushes zu `origin`. Um einen geprüften develop-Commit wiederzuverwenden, führen Sie
|
||||
zunächst die `--execute`-Erprobung auf der 3.9.0-Spitze gegen Ihren Fork aus; sie gibt beide SHAs aus,
|
||||
und dieselben Commits können gepusht werden:
|
||||
3. Erstellen Sie die Zweige auf `origin` manuell mit den Befehlen, die im Probelauf — gedruckt werden. Das Skript weigert sich, sie an `origin` zu übertragen. Um einen überprüften Entwicklungs-Commit wiederzuverwenden, führen Sie zuerst die `--execute` Probe auf der 3.9.0-Spitze für Ihren Fork aus; Es gibt beide SHAs aus und die gleichen Commits können gepusht werden:
|
||||
|
||||
```bash
|
||||
git push origin <stable-sha>:refs/heads/stable/v3 <develop-sha>:refs/heads/develop
|
||||
```
|
||||
|
||||
4. Schützen Sie `stable/v3` und `develop` (Regelsätze + Merge-Warteschlange), bevor der erste PR eingeht.
|
||||
5. Die inaktiven Workflows werden durch die Existenz der Branches aktiviert: `forward-port.yml` (Push auf
|
||||
`stable/v3`), `validate-stable-pr.yml` (PRs für `stable/v3`) und `nightly-v4-build.yml`
|
||||
(baut `develop`). Legen Sie vor der Inbetriebnahme das Repository-Secret `secrets.FORWARD_PORT_TOKEN` fest (damit CI für
|
||||
Forward-Port-PRs ausgeführt wird); die nächtliche Veröffentlichung bleibt deaktiviert, bis der Verantwortliche die Repository-
|
||||
Variable `vars.NIGHTLY_PUBLISH` auf `true` setzt und npm Trusted Publishing
|
||||
`nightly-v4-build.yml` akzeptiert. Die Kanalauflösung erfolgt über `scripts/release/dist-tag.mjs`, denselben
|
||||
Resolver, den `npm-publish.yml` verwendet.
|
||||
6. Überprüfen Sie die Kanäle: `npm view omniroute dist-tags --json` zeigt `latest` = 3.9.0 und kein
|
||||
`next` / `nightly`, bis v4 veröffentlicht wird.
|
||||
7. Rollback, falls erforderlich: `git push origin --delete refs/heads/stable/v3 refs/heads/develop`
|
||||
und `npm dist-tag add omniroute@3.8.59 latest`.
|
||||
4. Schützen Sie `stable/v3` und `develop` (Regelsätze + Merge-Warteschlange), bevor der erste PR landet.
|
||||
5. Die ruhenden Workflows werden je nach Branch-Existenz aktiviert: `forward-port.yml` (push to `stable/v3`), `validate-stable-pr.yml` (PRs to `stable/v3`) und `nightly-v4-build.yml` (builds `develop`). Legen Sie vor dem Go-Live das `secrets.FORWARD_PORT_TOKEN` Repository-Geheimnis fest (damit CI auf dem Forward-Port PRs ausgeführt wird); Die nächtliche Veröffentlichung bleibt deaktiviert, bis der Eigentümer die Repository-Variable `vars.NIGHTLY_PUBLISH` auf `true` setzt und npm Trusted Publishing `nightly-v4-build.yml` akzeptiert. Die Kanalauflösung ist `scripts/release/dist-tag.mjs`, derselbe Resolver `npm-publish.yml` verwendet.
|
||||
6. Überprüfen Sie die Kanäle: `npm view omniroute dist-tags --json` zeigt `latest` = 3.9.0 und kein `next` / `nightly`, bis Version 4 veröffentlicht wird.
|
||||
7. Rollback, falls erforderlich: `git push origin --delete refs/heads/stable/v3 refs/heads/develop` und `npm dist-tag add omniroute@3.8.59 latest`.
|
||||
|
||||
---
|
||||
|
||||
|
||||
@@ -145,33 +145,22 @@ die Prüfung auf Inaktivität und der Neustart im selben Befehl erfolgen müssen
|
||||
27–32 Minuten, um auf dem tmpfs abgelegt zu werden, und 2 Minuten für den Upload von der Festplatte.
|
||||
- Der `.15`-VPS dient ausschließlich der Homologation — darauf laufen niemals CI-Runner.
|
||||
|
||||
## Gehostete Lane (GitHub-gehostete Runner)
|
||||
## Gehostete Spur (von GitHub gehostete Läufer)
|
||||
|
||||
Das Repository gehört zur Organisation `cheaper-inference` mit dem **Team**-Tarif: **60 gleichzeitig ausgeführte gehostete Jobs**, die von sämtlichen Repositories der Organisation, allen PR-Prüfungen, allen durch Pushes ausgelösten Workflows und dem Standard-Setup von CodeQL gemeinsam genutzt werden. Die folgenden Zahlen wurden noch mit dem **Pro**-Tarif (40 gleichzeitig ausgeführte gehostete Jobs) gemessen. Gemessen am 2026-10-18 während einer
|
||||
Merge-Kampagne (~10 Merges/Stunde auf `release/v3.8.52`): **2.500 Workflow-Ausführungen wurden innerhalb von
|
||||
24 Stunden erstellt**, 44 Pushes auf den Branch innerhalb von 6 Stunden, **106 gehostete Jobs in der Warteschlange**, während PR-Prüfungen
|
||||
stundenlang warteten und PRs ohne sie gemergt wurden. Bei jedem Push auf den Branch wurden neun Workflows ausgelöst:
|
||||
Das Repository gehört der `cheaper-inference` -Organisation** Team** planen:** 60 gleichzeitig gehostete Jobs** , gemeinsam genutzt von jedem Repository in der Organisation, jeder PR Prüfung, jedem Push-ausgelösten Workflow und dem Standard-Setup von CodeQL. Die folgenden Zahlen wurden am gemessen** Profi** Plan (40 gleichzeitig gehostete Jobs). Gemessen am 18.10.2026 während einer Merge-Kampagne (~ 10 merges/hour auf `release/v3.8.52`):** 2.500 Workflow-Läufe in 24 Stunden erstellt** , 44 Pushs zur Filiale in 6 h,** 106 gehostete Jobs in der Warteschlange** während PR -Prüfungen stundenlang warteten und PRs ohne sie zusammengeführt wurden. Neun Workflows wurden bei jedem Push an die Verzweigung ausgelöst:
|
||||
|
||||
| pro Push auf `release/v*` | gehostete Jobs | Ergebnis während des Ansturms | seit 2026-10-18 |
|
||||
| pro Push zu `release/v*` | gehostete Jobs | Ergebnis unter dem Sturm | seit 18.10.2026 |
|
||||
| ------------------------------------------- | -------------: | -------------------------------------------------------------- | ---------------------------------------------------------------------------------- |
|
||||
| `ci.yml` (vollständige Matrix) | bis 30 | durch den nächsten Push abgebrochen, 24 von 24 an einem Tag | wird bei Pushes auf `release/**` nicht gestartet (PR-Lauf + Release-Green) |
|
||||
| `quality.yml` | ~6 | abgebrochen, 23 von 23 | wird bei Pushes auf `release/**` nicht gestartet |
|
||||
| `Release-Green` `--quick` | 0 | lief auf `omni-build`, 97 von 100 abgebrochen | `omni-release`-Slot, niemals abgebrochen, ausstehende Läufe werden zusammengeführt |
|
||||
| `Lock released branch`, `OpenSSF Scorecard` | 2 | ein Lauf pro Push in der Warteschlange | ein Lauf pro Ref (`tests/unit/build/hosted-lane-concurrency.test.ts`) |
|
||||
| `Release acceptance` (Schattenbericht) | 1 | ein gehostetes `npm ci` pro Push, niemals abgebrochen | unverändert — Kandidat für einen `paths:`-Filter |
|
||||
| `Publish to Docker Hub` → `Deploy to VPS` | 2 | pro Push abgebrochen; amd64-Teil konkurriert auf `omni-build` | unverändert — Deployment-Kanal des Eigentümers |
|
||||
| CodeQL-Standard-Setup (`dynamic`) | 4 | `javascript-typescript`, `actions`, `c-cpp`, `python` pro Push | unverändert — Einstellungen → Codesicherheit; `c-cpp`/`python` scannen hier nichts |
|
||||
| `ci.yml` (vollständige Matrix) | bis 30 | durch den nächsten Push abgebrochen, 24 von 24 an einem Tag | nicht bei `release/**` Pushs gestartet (PR run + Release-Green) |
|
||||
| `quality.yml` | ~6 | abgesagt, 23 von 23 | nicht auf `release/**` Pushs gestartet |
|
||||
| `Release-Green` `--quick` | 0 | lief auf `omni-build`, stornierte 97 von 100 | `omni-release` -Slot, nie abgesagt, bis der Lauf zusammenbricht |
|
||||
| `Lock released branch`, `OpenSSF Scorecard` | 2 | ein Lauf in der Warteschlange pro Push | ein Lauf pro Referenz (`tests/unit/build/hosted-lane-concurrency.test.ts`) |
|
||||
| `Release acceptance` (Schattenbericht) | 1 | ein gehosteter `npm ci` pro Push, nie abgebrochen | unveränderter — Kandidat für einen `paths:` Filter |
|
||||
| `Publish to Docker Hub` → `Deploy to VPS` | 2 | per Push stornierbar; AMD64-Bein konkurriert auf `omni-build` | Unveränderter Bereitstellungskanal des — Besitzers |
|
||||
| CodeQL -Standardeinstellung (`dynamic`) | 4 | `javascript-typescript`, `actions`, `c-cpp`, `python` pro Push | unveränderte — Einstellungen → Codesicherheit; `c-cpp`/`python` scannt hier nichts |
|
||||
|
||||
`tests/unit/build/push-storm-diet.test.ts` schreibt den reinen `main`-Push-Trigger von `ci.yml` und
|
||||
`quality.yml` fest. Nebeneffekt: Codecov erhält nicht mehr bei jedem Release-Push einen Basis-Upload (der
|
||||
Schritt dient nur zur Information und verwendet `continue-on-error`); das repository-interne Coverage-Gate und der PR-Kommentar
|
||||
bleiben davon unberührt.
|
||||
`tests/unit/build/push-storm-diet.test.ts` steckt den `main` -only Push-Trigger von `ci.yml` und `quality.yml` fest. Nebeneffekt: Codecov erhält keinen Basis-Upload mehr pro Release-Push (der Schritt ist informativ und `continue-on-error`); Das In-Repo-Coverage-Gate und PR Kommentar bleiben davon unberührt.
|
||||
|
||||
**Mehr selbst gehostete Kapazität behebt die Warteschlange der gehosteten Lane nicht.** Die Devbox
|
||||
(`devbox-vm-06-dev002`, 24 vCPU / 54 GB) könnte einen Runner hosten, aber die Agentensitzungen
|
||||
halten ihre Last bereits bei 20–26, der Agentencontainer verfügt über keinen Docker-Daemon, und ausgelastet ist
|
||||
die gehostete Lane. Die `.113`-Box hatte zum selben Zeitpunkt 71 GB freien Speicher und eine Last von 5–8; ihre Einschränkung
|
||||
ist das oben beschriebene Speicherbudget pro Listener (Obergrenze von 6 Listenern), nicht die CPU. Die verbleibenden Stellschrauben
|
||||
betreffen die Prozesse: Kampagnen-PRs über die Mergify-Warteschlange einbringen (`label=queue`; Batches nutzen
|
||||
gemeinsam einen `merge_group`-CI-Lauf anstelle eines Laufs pro PR plus eines Laufs pro Push), die Sprachen
|
||||
des CodeQL-Standard-Setups reduzieren und `release-acceptance.yml` anhand der gelesenen Dateien filtern.
|
||||
**Mehr selbstgehostete Kapazität repariert die gehostete Warteschlange nicht.** Die Devbox (`devbox-vm-06-dev002`, 24 vCPU / 54 GB) könnte einen Runner hosten, aber die Agent-Sitzungen halten ihre Auslastung bereits bei 20–26, der Agent-Container hat keinen Docker Daemon und die gesättigte Lane ist die gehostete. Die `.113` Box hatte 71 GB frei und lud gleichzeitig 5–8; Seine Einschränkung ist das oben genannte Speicherbudget pro Hörer (Obergrenze 6 Hörer), nicht CPU. Die verbleibenden Hebel sind Prozesshebel: Kampagne PRs durch die Mergify-Warteschlange landen (`label=queue`, Stapel teilen sich einen `merge_group` CI Lauf anstelle eines Laufs pro PR plus einen pro Push), die CodeQL -Standard-Setup-Sprachen kürzen und `release-acceptance.yml` nach den Dateien filtern, die es liest.
|
||||
|
||||
> **19.11.2026: Die Mergify-Merge-Warteschlange wird eingestellt** (Entscheidung des Eigentümers). `.mergify.yml` definiert keine Warteschlange mehr und lehnt die Mergify-Befehle ab, die eine Pull-Anfrage zusammenführen oder neu schreiben. Release- PRs werden manuell unter dem Repository-Regelsatz „Erfordern grüne Gates für das aktive Release“ (`Gate / CI` + `Gate / Quality`) zusammengeführt, bis Omni-Queue im Live-Modus ausgeführt wird, und danach über Omni-Queue ( [OMNI_QUEUE.md](./OMNI_QUEUE.md) ). Der Mergify-Hebel oben existiert nicht mehr.
|
||||
|
||||
@@ -21,7 +21,7 @@
|
||||
|
||||
Οι ροές εργασίας CI και Quality Gates εκπέμπουν η καθεμία μια σταθερή ετυμηγορία: `Gate / CI` και `Gate / Quality`. Η τροποποιημένη πολιτική εισδοχής τους απαριθμεί κάθε εργασία ανάντη ως απαιτούμενη ή συμβουλευτική. Μια απαιτούμενη εργασία που ισχύει πρέπει να είναι επιτυχής: λείπει, ακυρώθηκε, παραλείφθηκε, εκκρεμεί και άγνωστα αποτελέσματα δεν μπορούν να δημιουργήσουν PASS. Μια έγκυρη ταξινόμηση μόνο για έγγραφα ή μόνο για κατάλογο μπορεί να καταστήσει μη εφαρμόσιμη μια λωρίδα κωδικών. ένα σχέδιο PR δεν είναι αποδεκτός υποψήφιος. Μια ετικέτα `hotfix` δεν παραιτείται από στοιχεία.
|
||||
|
||||
Και οι δύο ροές εργασίας καλύπτουν PRs σε κλάδους main/release, ωθήσεις σε `main`, μη αυτόματη αποστολή και συγχώνευση συμβάντων. Push, αποστολή και συγχώνευση-ομαδοποίηση εκτελέστε την πλήρη επιλογή. Οι ωθήσεις στο `release/**` δεν τις ξεκινούν (2026-10-18): κάθε αλλαγή εκτελούσε ήδη τον πίνακα στο PR του και ο συγχωνευμένος συνδυασμός είναι δουλειά του Release-Green (`docs/ops/RUNNER_BOX.md` → Hosted lane). Οι ομάδες διχάλων και συγχωνεύσεων χρησιμοποιούν φιλοξενούμενους δρομείς για εργασίες που επιλέγουν κατά τα άλλα αυτο-φιλοξενούμενους δρομείς. πρέπει να επαληθευτεί επαρκής χωρητικότητα φιλοξενίας πριν από την κυκλοφορία.
|
||||
Και οι δύο ροές εργασίας καλύπτουν PRs σε κλάδους main/release, ωθήσεις σε `main`, μη αυτόματη αποστολή και συγχώνευση συμβάντων. Push, αποστολή και συγχώνευση-ομαδοποίηση εκτελέστε την πλήρη επιλογή. Οι ωθήσεις στο `release/**` δεν τις ξεκινούν (2026-10-18): κάθε αλλαγή εκτελούσε ήδη τον πίνακα στο PR του και ο συγχωνευμένος συνδυασμός είναι δουλειά του Release-Green (`docs/ops/RUNNER_BOX.md` → Hosted lane). Τα forks και οι ομάδες συγχώνευσης χρησιμοποιούν φιλοξενούμενους δρομείς για εργασίες που διαφορετικά επιλέγουν αυτο-φιλοξενούμενους δρομείς. πρέπει να επαληθευτεί επαρκής χωρητικότητα φιλοξενίας πριν από την κυκλοφορία.
|
||||
|
||||
Ένα συνηθισμένο PR εκτελεί τη γρήγορη επιλογή. Οι λωρίδες `full-code` και `full-code-e2e` της πολιτικής εισδοχής (E2E, ενσωμάτωση, τεχνούργημα πακέτου, Electron smoke, Bun SQLite, πελάτες οικοσυστήματος και πρωτοκόλλου) εκτελούνται μόνο σε πρόχειρο ουράς Mergify ή σε πλήρη εκτέλεση: `gh workflow run ci.yml --ref <branch>`.
|
||||
|
||||
@@ -29,9 +29,11 @@
|
||||
|
||||
### Ουρά συγχώνευσης
|
||||
|
||||
> **2026-11-19: η ουρά συγχώνευσης Mergify αποσύρεται** (απόφαση ιδιοκτήτη). `.mergify.yml` δεν ορίζει πλέον μια ουρά και απορρίπτει τις εντολές Mergify που συγχωνεύουν ή ξαναγράφουν ένα αίτημα έλξης. Η κυκλοφορία PRs συγχωνεύεται με το χέρι κάτω από το σύνολο κανόνων αποθετηρίου "Απαιτούνται πράσινες πύλες στην ενεργή κυκλοφορία" (`Gate / CI` + `Gate / Quality`) μέχρι να εκτελεστεί η omni-queue σε ζωντανή λειτουργία και μετά από αυτήν μέσω της omni-queue ( [OMNI_QUEUE.md](../ops/OMNI_QUEUE.md) ). Ο χειρισμός της ροής εργασίας των πρόχειρων του Mergify που περιγράφεται παρακάτω εξακολουθεί να είναι σε `ci.yml` και `quality.yml`, αλλά δεν ανοίγει πλέον κανένα πρόχειρο Mergify.
|
||||
|
||||
Η ετικέτα `queue` στέλνει ένα PR στην ουρά Mergify (`.mergify.yml`). Το Mergify ανοίγει ένα πρόχειρο PR σε έναν κλάδο `mergify/merge-queue/`, CI εκτελεί την πλήρη επιλογή εκεί και το αρχικό PR συγχωνεύεται όταν περάσουν `Gate / CI`, `Gate / Quality` και `Merge integrity (changelog + generated skills)`.
|
||||
|
||||
Το Mergify γράφει τη σύνοψη της ουράς του στην περιγραφή του προχείρου και άλλες εφαρμογές μπορούν επίσης να το επεξεργαστούν. Ένα συμβάν `pull_request` `edited` σε ένα τέτοιο προσχέδιο παίρνει τη δική του ομάδα συγχρονισμού (`-queue-edit-<run_id>`), επομένως δεν μπορεί να ακυρώσει την πραγματική εκτέλεση του σχεδίου και παρακάμπτει την πύλη και τη μήτρα. Μόνο `Merge integrity` τρέχει ακόμα. Η εργασία παράλειψης πύλης φέρει διαφορετικό όνομα ελέγχου, επειδή το Mergify διαβάζει ένα παραλειφθέν `Gate / CI` ως αποτυχημένο έλεγχο και αφαιρεί το PR.
|
||||
Το Mergify γράφει τη σύνοψη της ουράς στην περιγραφή του προχείρου και άλλες εφαρμογές μπορούν επίσης να το επεξεργαστούν. Ένα συμβάν `pull_request` `edited` σε ένα τέτοιο προσχέδιο παίρνει τη δική του ομάδα συγχρονισμού (`-queue-edit-<run_id>`), επομένως δεν μπορεί να ακυρώσει την πραγματική εκτέλεση του σχεδίου και παρακάμπτει την πύλη και τη μήτρα. Μόνο `Merge integrity` τρέχει ακόμα. Η εργασία παράλειψης πύλης φέρει διαφορετικό όνομα ελέγχου, επειδή το Mergify διαβάζει ένα παραλειφθέν `Gate / CI` ως αποτυχημένο έλεγχο και αφαιρεί το PR.
|
||||
|
||||
Μετά από dequeue, μια ώθηση δεν επαναφέρει πάντα το PR. Σχολιάστε `@mergifyio queue`.
|
||||
|
||||
@@ -80,7 +82,7 @@
|
||||
| `check:route-validation:t06` | Σχήματα Zod που υπάρχουν σε όλες τις διαδρομές (πολιτική επιπέδου 6) | Ναί |
|
||||
| `check:any-budget:t11` | Ο αριθμός `@ts-expect-error // any` δεν υπερβαίνει τον προϋπολογισμό (Tier 11 catraca) | Ναί |
|
||||
| `check:provider-consistency` | Κάθε πάροχος στο `providers.ts` έχει μια αντίστοιχη καταχώριση στο `providerRegistry.ts` (και αντίστροφα, στη λίστα επιτρεπόμενων) | Ναί |
|
||||
| `check:model-lifecycle` | Οι τρεις πίνακες δρομολόγησης που διατηρούνται στο χέρι παραμένουν συνεπείς με το στιγμιότυπο του κύκλου ζωής με check-in (#11503): `FITNESS_TABLE` (`taskFitness.ts`) δεν βαθμολογεί κανένα αναγνωριστικό απόσυρσης που μπορεί να δρομολογήσει `REGISTRY`. κάθε στόχος `BUILT_IN_ALIASES` υπάρχει στο `REGISTRY` και απουσιάζει από το στιγμιότυπο του retired-id. Κάθε αναγνωριστικό που έχει αποσυρθεί ακόμα σε `REGISTRY` προωθείται ή παρατίθεται σε `allowedRetiredInCatalog`. και καμία πηγή ή στόχος `DEFAULT_DEGRADATION_MAP` δεν εμφανίζεται σε αυτό το στιγμιότυπο. Αυτό δεν αποδεικνύει ότι ένα μοντέλο εξυπηρετείται επί του παρόντος από ζωντανό upstream. Το offline — συγκρίνει με `config/quality/model-lifecycle.json`, ανανεώνεται χειροκίνητα με `npm run quality:refresh-model-lifecycle` (δίκτυο, μη ενσύρματο σε CI). `allowedRetiredInCatalog` είναι μια καστάνια καύσης: προσθέστε μια καταχώριση μόνο με πρόβλημα παρακολούθησης. | Ναί |
|
||||
| `check:model-lifecycle` | Οι τρεις πίνακες δρομολόγησης που διατηρούνται στο χέρι παραμένουν συνεπείς με το στιγμιότυπο του κύκλου ζωής με check-in (#11503): `FITNESS_TABLE` (`taskFitness.ts`) δεν βαθμολογεί κανένα αναγνωριστικό απόσυρσης που μπορεί να δρομολογήσει `REGISTRY`. κάθε στόχος `BUILT_IN_ALIASES` υπάρχει στο `REGISTRY` και απουσιάζει από το στιγμιότυπο του retired-id. Κάθε αναγνωριστικό που έχει αποσυρθεί ακόμα σε `REGISTRY` προωθείται ή παρατίθεται σε `allowedRetiredInCatalog`. και καμία πηγή ή στόχος `DEFAULT_DEGRADATION_MAP` δεν εμφανίζεται σε αυτό το στιγμιότυπο. Αυτό δεν αποδεικνύει ότι ένα μοντέλο εξυπηρετείται αυτήν τη στιγμή από ζωντανό upstream. Το offline — συγκρίνει με `config/quality/model-lifecycle.json`, ανανεώνεται χειροκίνητα με `npm run quality:refresh-model-lifecycle` (δίκτυο, μη ενσύρματο σε CI). `allowedRetiredInCatalog` είναι μια καστάνια καύσης: προσθέστε μια καταχώριση μόνο με πρόβλημα παρακολούθησης. | Ναί |
|
||||
| `check:fetch-targets` | Κάθε `fetch("/api/...")` στο `src/` από την πλευρά του πελάτη καταλήγει σε πραγματικό `route.ts` | Ναί |
|
||||
| `check:deps` | Όλα `npm install` -able deps σε κάθε `package.json` στο repo είναι σε `dependency-allowlist.json`. νέα αποκαρφιτσωμένα ή slopsquatted πακέτα επισημασμένα | Ναί |
|
||||
| `audit:deps` | Έλεγχος npm και των πέντε ανεξάρτητων lockfiles (root, Electron, OpenCode plugins v1/v2 και πάροχος). Αποκλεισμός κρίσιμων συμβουλών. οι υψηλές προειδοποιήσεις παραμένουν ορατές προειδοποιήσεις. Οι έλεγχοι Missing/failed είναι INCOMPLETE και μπλοκ. Οι κατακερματισμοί κλειδώματος ανά εμβέλεια και οι αναφορές διατηρούνται. | Ναί |
|
||||
@@ -129,7 +131,7 @@
|
||||
| `check:compression-budget` | Ο προϋπολογισμός αναφοράς συμπίεσης — ανά κινητήρα δεν πρέπει να υποχωρεί | Ναί |
|
||||
| `check:type-coverage` | Η καστάνια (`type-coverage`) με πληκτρολόγηση ποσοστού δεν υποχωρεί. συνυπολογίζει σε μεγάλο βαθμό `typecheck:noimplicit:core` | Ναί |
|
||||
| `check:codeql-ratchet` | Ανοιχτό πλήθος ειδοποιήσεων CodeQL δεν υποχωρεί (διαβάζεται μέσω `gh api`, χαριτωμένη παράβλεψη χωρίς διακριτικό) Ρυθμός ανανέωσης — και μη αυτόματη ενεργοποίηση: βλέπε "CodeQL ratchet" παρακάτω | Ναί |
|
||||
| `check:type-scale-ratchet` | Κλίμακα τύπου κιτ: τα μεγέθη κάτω από 12 px και `font-bold` σε `src/` μόνο μειώνονται (`typeScaleSubFloorSizes`, `typeScaleFontBold`). επίσης στο άγκιστρο προ-δέσμευσης | Ναί |
|
||||
| `check:type-scale-ratchet` | Κλίμακα τύπου κιτ: τα μεγέθη κάτω από 12 px και `font-bold` σε `src/` μόνο μειώνονται (`typeScaleSubFloorSizes`, `typeScaleFontBold`); επίσης στο άγκιστρο προ-δέσμευσης | Ναί |
|
||||
|
||||
### Δουλειά: `quality-extended`
|
||||
|
||||
@@ -153,7 +155,7 @@
|
||||
| `check:docs-all` | Μετα-πύλη που τρέχει τις 6 υποπύλες παρακάτω διαδοχικά | Ναί |
|
||||
| ↳ `check:docs-sync` | Συνοχή έκδοσης CHANGELOG / OpenAPI. λειτουργία απελευθέρωσης επίσης τους καθρέφτες 66 `llm.txt` και τις μεταφρασμένες ενότητες CHANGELOG (λειτουργία PR : οι καθρέφτες συμφωνούν) | Ναί |
|
||||
| ↳ `check:docs-counts` | Μετράει στην πεζογραφία (πλήθος παρόχων, αριθμός μετανάστευσης κ.λπ.). Δύο λειτουργίες: `pr` στο χαρακτηριστικό PRs, `release` αλλού — δείτε τις "Παράγωγες τιμές" παρακάτω | Ναί |
|
||||
| ↳ `check:env-doc-sync` | Κάθε env var στο `.env.example` τεκμηριώνεται σε έναν πίνακα εγγράφων και αντίστροφα | Ναί |
|
||||
| ↳ `check:env-doc-sync` | Κάθε env var στο `.env.example` τεκμηριώνεται σε έναν πίνακα εγγράφων και το αντίστροφο | Ναί |
|
||||
| ↳ `check:deprecated-versions` | Δεν υπάρχουν συμβολοσειρές καταργημένης έκδοσης στα έγγραφα | Ναί |
|
||||
| ↳ `check:doc-links` | Οι εσωτερικοί σύνδεσμοι σήμανσης στα έγγραφα επιλύονται σε πραγματικά αρχεία (μορφή `[text]`/`(path)` ) | Ναί |
|
||||
| ↳ `check:fabricated-docs` | Διαδρομές, env vars, εντολές CLI, ονόματα αγκίστρων και διαδρομές αρχείων που αναφέρονται στα έγγραφα υπάρχουν στη βάση κώδικα. Σκληρή πύλη μέσω `--strict`; soft-fail χωρίς σημαία. | Ναι (μέσω `--strict` στο CI) |
|
||||
@@ -194,7 +196,7 @@
|
||||
|
||||
Τα αρχεία οδηγιών του πράκτορα φέρουν** Όχι** παράγωγο μέτρημα καθόλου: `AGENTS.md`, `llm.txt` (και τα αντίγραφά του `docs/i18n/*/llm.txt` ), τα bs `AGENTS.md` fork, `open-sse/services/AGENTS.md`, `src/shared/constants/agentSkills.ts`, `skills/README.md` και κάθε `skills/*/SKILL.md` δείχνουν στην πηγή (για παράδειγμα `ROUTING_STRATEGY_VALUES` στο `src/shared/constants/routingStrategies.ts`) και αντ 'αυτού στο `npm run facts`. Το αμετάβλητο "Χωρίς παράγωγες μετρήσεις (αρχείο οδηγιών…)" αποτυγχάνει να μετρήσει εκεί (πάροχοι, μετεγκαταστάσεις, εργαλεία και πεδία MCP, στρατηγικές δρομολόγησης, παράγοντες βαθμολόγησης, πακέτα λειτουργιών) και στις δύο λειτουργίες, επομένως η ανανέωση έκδοσης δεν χρειάζεται ποτέ να ξαναγράψει ένα αρχείο οδηγιών.
|
||||
|
||||
Στη λειτουργία `pr` οι κλάδοι εγγραφής μπορούν να επεξεργαστούν τις διαχειριζόμενες τιμές: `chore/derived-*` (η νυχτερινή ανανέωση PR), `release/v*` και τα κύματα μετάφρασης `docs/i18n-*` και `chore/i18n-*` (`scripts/check/lib/derivedClaimsDiff.mjs`). Οι παρτίδες ουράς (`merge_group`, Mergify drafts, `omni-queue/**`) δεν κρίνονται ξανά: αθροίζουν PRs την πύλη που έχει ήδη κριθεί μία προς μία.
|
||||
Στη λειτουργία `pr` οι κλάδοι εγγραφής μπορούν να επεξεργαστούν τις διαχειριζόμενες τιμές: `chore/derived-*` (η νυχτερινή ανανέωση PR), `release/v*` και τα κύματα μετάφρασης `docs/i18n-*` και `chore/i18n-*` (`scripts/check/lib/derivedClaimsDiff.mjs`). Οι παρτίδες ουρών (`merge_group`, Mergify drafts, `omni-queue/**`) δεν κρίνονται ξανά: αθροίζουν PRs την πύλη που έχει ήδη κριθεί μία προς μία.
|
||||
|
||||
Κωδικοί εξόδου: `0` clean · `1` STRICT drift (ή soft drift με `--strict`) ή παραβίαση διαχειριζόμενης τιμής · `2` υποδομή — δεν ήταν δυνατή η συλλογή γεγονότων κώδικα (η ανίχνευση tsx απέτυχε ή έληξε, το χρονικό όριο είναι `OMNIROUTE_FACTS_TIMEOUT_MS`, προεπιλογή 600000 ms) ή, σε CI βάση δεν μπορούσε να επιλυθεί η βάση PR. Η έξοδος 2 δεν αποτελεί ποτέ απόκλιση τεκμηρίωσης: εκτελέστε ξανά την εργασία ή διορθώστε το περιβάλλον.
|
||||
|
||||
@@ -212,10 +214,10 @@
|
||||
Οι εντολές πίσω από αυτό:
|
||||
|
||||
- `npm run facts` εκτυπώνει κάθε παράγωγο αριθμό ως JSON (`scripts/release/facts.mjs`). `--key=code.mcpTools` εκτυπώνει μία τιμή, `--snapshot` διαβάζει το δεσμευμένο στιγμιότυπο αντί για το ζωντανό δέντρο. Έξοδος 2 όταν δεν μπορούν να συλλεχθούν τα γεγονότα.
|
||||
- `npm run release:refresh-derived` (`scripts/release/refresh-derived.mjs`) υπολογίζει εκ νέου τα παράγωγα αρχεία με ένα πέρασμα, με αυτή τη σειρά (αναγνωριστικά βημάτων για `--only=`): `provider-reference` (`docs/reference/PROVIDER_REFERENCE.md`), `facts` (το στιγμιότυπο), `numbers` (το σχέδιο επανεγγραφής της πύλης μετρήσεων εφαρμόζεται στα έγγραφα και στη συνέχεια μεταφέρεται στους καθρέφτες `docs/i18n/` τους), `readme-diagrams`, `skills` (το `SKILL.md` `ui-keys` `syncE2eTimings`), `e2e-timings` (τα πλήκτρα prunes `en.json` έπεσαν και, με `--rewritten-since=<ref>` — προεπιλεγμένη `origin/main` — επαναλαμβάνει ουρές αγγλικών τιμών που έχουν ξαναγραφτεί από την τελευταία έκδοση. Οι τιμές μεταφράζονται στην ίδια εκτέλεση από το backend που έχει διαμορφωθεί στο περιβάλλον ή σε `.env` (`OMNIROUTE_TRANSLATION_*`, μόνο αυτά τα κλειδιά διαβάζονται ποτέ από το Google recorders backend. αποτυγχάνει, το νυχτερινό παραλείπει τα πλήκτρα και `--allow-untranslated` `__MISSING__` γράφει επίτηδες), `llm-mirrors` και `verify-generated` (μετά από εγγραφή, `check:generated-artifacts` και `check:agent-skills-sync` στη λειτουργία απελευθέρωσης πρέπει να περάσουν, παραλείπονται στο `--check` και όταν `--only` το αφήνει έξω, μια αποτυχία είναι η έξοδος 2). Το βήμα `changelog` είναι συμμετοχή (`--with-changelog`, μόνο προφίλ έκδοσης). `--profile=nightly` δεν αγγίζει ποτέ μια αξίωση έκδοσης. Με `-- --check` δεν γράφει τίποτα και βγαίνει από το 1 όταν άλλαζε οποιοδήποτε αρχείο ή μια διαχειριζόμενη τιμή χρειάζεται χειροκίνητη επεξεργασία (αναφέρονται και τα δύο). έξοδος 2 σε αστοχία υποδομής. `--json` εκτυπώνει το αποτέλεσμα ως JSON.
|
||||
- `npm run release:refresh-derived` (`scripts/release/refresh-derived.mjs`) υπολογίζει εκ νέου τα παράγωγα αρχεία με ένα πέρασμα, με αυτή τη σειρά (αναγνωριστικά βημάτων για `--only=`): `provider-reference` (`docs/reference/PROVIDER_REFERENCE.md`), `facts` (το στιγμιότυπο), `numbers` (το σχέδιο επανεγγραφής της πύλης μετρήσεων εφαρμόζεται στα έγγραφα και στη συνέχεια μεταφέρεται στους καθρέφτες `docs/i18n/` τους), `readme-diagrams`, `skills` (το `SKILL.md` `ui-keys` `syncE2eTimings`), `e2e-timings` (τα πλήκτρα prunes `en.json` έπεσαν και, με `--rewritten-since=<ref>` — προεπιλεγμένη `origin/main` — επαναλαμβάνει ουρές αγγλικών τιμών που έχουν ξαναγραφτεί από την τελευταία έκδοση. Οι τιμές μεταφράζονται στην ίδια εκτέλεση από το backend που έχει διαμορφωθεί στο περιβάλλον ή σε `.env` (`OMNIROUTE_TRANSLATION_*`, μόνο αυτά τα κλειδιά διαβάζονται ποτέ από το Google recorders backend. αποτυγχάνει, το νυχτερινό παραλείπει τα πλήκτρα και `--allow-untranslated` `__MISSING__` γράφει επίτηδες), `llm-mirrors` και `verify-generated` (μετά από εγγραφή, `check:generated-artifacts` και `check:agent-skills-sync` στη λειτουργία απελευθέρωσης πρέπει να περάσουν, παραλείπονται στο `--check` και όταν `--only` το αφήνει έξω, μια αποτυχία είναι η έξοδος 2). Το βήμα `changelog` είναι συμμετοχή (`--with-changelog`, μόνο προφίλ έκδοσης). `--profile=nightly` δεν αγγίζει ποτέ μια αξίωση έκδοσης. Με `-- --check` δεν γράφει τίποτα και βγαίνει από το 1 όταν άλλαζε κάποιο αρχείο ή όταν μια διαχειριζόμενη τιμή χρειάζεται χειροκίνητη επεξεργασία (αναφέρονται και τα δύο). έξοδος 2 σε αστοχία υποδομής. `--json` εκτυπώνει το αποτέλεσμα ως JSON.
|
||||
- `docs/reference/derived-facts.json` είναι το στιγμιότυπο των γεγονότων που χρησιμοποιήθηκε η τελευταία ανανέωση. Μόνο το refresh το γράφει. Οι γεννήτριες README SVG το διαβάζουν και οι δοκιμές μονάδων PR-time συγκρίνουν τα δεσμευμένα έγγραφα και τα αρχεία που δημιουργούνται με αυτό — ποτέ με τον ζωντανό κώδικα. Η μοναδική ζωντανή σύγκριση της σουίτας είναι "η ανανέωση κυκλοφορίας κλείνει τον κύκλο" στο `tests/unit/check-docs-counts-sync.test.ts`: με τα ζωντανά γεγονότα, το σχέδιο επανεγγραφής της ανανέωσης που εφαρμόζεται στη μνήμη δεν αφήνει drift STRICT που δεν αναφέρει και ο επανασχεδιασμός δεν αλλάζει τίποτα.
|
||||
|
||||
Για αναπαραγωγή τοπικά (μια τοπική εκτέλεση είναι προεπιλεγμένη σε `release`):
|
||||
Για αναπαραγωγή τοπικά (μια τοπική εκτέλεση είναι από προεπιλογή `release`):
|
||||
|
||||
```bash
|
||||
npm run check:docs-counts # release: strict, live facts
|
||||
@@ -239,7 +241,7 @@ npm run release:refresh-derived -- --check # what the rele
|
||||
|
||||
Χρειάζεται `fetch-depth: 0` — η πύλη μετατόπισης αξίας διαφέρει `en.json` από τη βάση συγχώνευσης.
|
||||
|
||||
**Δύο λειτουργίες (από 13-11-2026).** Ένα χαρακτηριστικό PR προσθέτει ή ξαναγράφει κλειδιά σε `en.json` (και `bin/cli/locales/en.json`) και δεν αγγίζει άλλες τοπικές ρυθμίσεις. `check:pr-derived-paths` (εργασία `pr-test-policy`, οικογένεια `config/quality/derived-paths/translation.json`) αποτυγχάνει ένα χαρακτηριστικό PR που το κάνει. Οι άλλες τοπικές ρυθμίσεις συμπληρώνονται μία φορά ανά έκδοση από το `release:refresh-derived`, το οποίο καλεί `syncUiKeys()` σε `scripts/i18n/sync-ui-keys.mjs` (προσθήκη πλήκτρων που λείπουν, κλάδεμα που έχουν απορριφθεί, επισημάνετε τις μεταφράσεις των ξαναγραμμένων αγγλικών με `rewrittenSinceRef`, μετάφραση) ή με ένα μεταφραστικό κύμα. Οι πύλες διαβάζουν τη λειτουργία από `scripts/check/lib/gateMode.mjs`: στη λειτουργία `pr` (χαρακτηριστικό PRs, `merge_group`, `omni-queue/**`) οι πύλες λειτουργίας απελευθέρωσης πάνω από την εκτύπωση `SKIP reason=pr-mode` και έξοδος 0. στη λειτουργία `release` (η απελευθέρωση PR, ώθηση σε `main`, `workflow_dispatch`, τοπικές εκτελέσεις) είναι αυστηρές όπως πριν, και στην έκδοση PR οι diff-aware παίρνουν `BASE_REF=origin/main`, οπότε κρίνουν κάθε πλήκτρο που προστέθηκε ή ξαναέγραψε ο κύκλος. Κάντε προεπισκόπηση της ετυμηγορίας χαρακτηριστικό PR τοπικά με `--mode=pr`.
|
||||
**Δύο λειτουργίες (από 13-11-2026).** Ένα χαρακτηριστικό PR προσθέτει ή ξαναγράφει κλειδιά σε `en.json` (και `bin/cli/locales/en.json`) και δεν αγγίζει άλλες τοπικές ρυθμίσεις. `check:pr-derived-paths` (εργασία `pr-test-policy`, οικογένεια `config/quality/derived-paths/translation.json`) αποτυγχάνει ένα χαρακτηριστικό PR που το κάνει. Οι άλλες τοπικές ρυθμίσεις συμπληρώνονται μία φορά ανά έκδοση από το `release:refresh-derived`, το οποίο καλεί `syncUiKeys()` σε `scripts/i18n/sync-ui-keys.mjs` (προσθήκη πλήκτρων που λείπουν, κλάδεμα που έχουν απορριφθεί, επισημάνετε τις μεταφράσεις των ξαναγραμμένων αγγλικών με `rewrittenSinceRef`, μετάφραση) ή με ένα μεταφραστικό κύμα. Οι πύλες διαβάζουν τη λειτουργία από `scripts/check/lib/gateMode.mjs`: στη λειτουργία `pr` (χαρακτηριστικό PRs, `merge_group`, `omni-queue/**`) οι πύλες λειτουργίας απελευθέρωσης πάνω από την εκτύπωση `SKIP reason=pr-mode` και έξοδος 0. στη λειτουργία `release` (η απελευθέρωση PR, ώθηση σε `main`, `workflow_dispatch`, τοπικές εκτελέσεις) είναι αυστηρές όπως πριν, και στην έκδοση PR οι diff-aware παίρνουν `BASE_REF=origin/main`, οπότε κρίνουν κάθε πλήκτρο που προστέθηκε ή ξαναέγραψε ο κύκλος. Κάντε προεπισκόπηση της ετυμηγορίας χαρακτηριστικό-PR τοπικά με `--mode=pr`.
|
||||
|
||||
Ένα PR που εξακολουθεί να αλλάζει τους καταλόγους τοπικών ρυθμίσεων στη λειτουργία `pr` (κύμα μετάφρασης, ανανέωση έκδοσης, επιδιόρθωση μόνο για μετάφραση) δεν παραλείπεται: `check-key-completeness` κρίνει κάθε κατάλογο που άλλαξε με βάση τον ίδιο κατάλογο στη βάση συγχώνευσης (`scripts/i18n/lib/touched-catalogs.mjs`) και αποτυγχάνει σε ένα κλειδί ο κατάλογος χάθηκε, ένα κλειδί `en.json` λείπει, μια πραγματική μετάφραση κειμένου δεν μετατρέπεται πλέον σε `__MISSING__:` ή η τιμή στα αγγλικά. placeholders/tags μιας αγγλικής χορδής το PR δεν άγγιξε. Ένας νέος κατάλογος στο PR πρέπει να φέρει ολόκληρο το σετ κλειδιών `en.json`. Αυτό καλύπτει, για τους καταλόγους που αγγίζει PR, τι θα έβλεπαν οι πύλες αναλογίας και ισοτιμίας CLI.
|
||||
|
||||
@@ -249,13 +251,13 @@ npm run release:refresh-derived -- --check # what the rele
|
||||
|
||||
Πιάνει τη μία παλινδρόμηση i18n που οι άλλες πύλες δομικά δεν μπορούν να δουν: μια αγγλική τιμή ξαναγράφεται και οι μεταφράσεις που προέρχονται από τα _προηγούμενα_ αγγλικά παραμένουν πίσω, έτσι οι μη Άγγλοι χρήστες συνεχίζουν να διαβάζουν αντίγραφο με σιγουριά, τώρα λάθος.
|
||||
|
||||
Αυτό στάλθηκε πραγματικά. `oauthModal.googleOAuthWarning` γράφτηκε ξανά όταν προσγειώθηκε ο βοηθός σύνδεσης Antigravity (#5203).** 39 από 43 τοποθεσίες** διατήρησε κείμενο λέγοντας στους χειριστές να "αντιγράψουν το πλήρες URL και να το επικολλήσουν παρακάτω" — μια ροή που δεν μπορεί να ολοκληρωθεί για αυτόν τον πάροχο. Πέρασε απαρατήρητο μέχρι #8463 γιατί:
|
||||
Αυτό στάλθηκε πραγματικά. `oauthModal.googleOAuthWarning` ξαναγράφτηκε όταν προσγειώθηκε το βοηθητικό πρόγραμμα σύνδεσης Antigravity (#5203);** 39 από 43 τοποθεσίες** διατήρησε κείμενο που έλεγε στους χειριστές να "αντιγράψουν το πλήρες URL και να το επικολλήσουν παρακάτω" — μια ροή που δεν μπορεί να ολοκληρωθεί για αυτόν τον πάροχο. Πέρασε απαρατήρητο μέχρι #8463 γιατί:
|
||||
|
||||
- `sync-ui-keys` συμπληρώνει μόνο τα κλειδιά που είναι** απών** , ποτέ αυτά που είναι** μπαγιάτικος** ;
|
||||
- `check-ui-keys-coverage` μετράει το κλειδί _παρουσία_, οπότε μια μπαγιάτικη μετάφραση βαθμολογείται ως καλυμμένη.
|
||||
- `check-translation-drift` παρακολουθεί την τεκμηρίωση `docs/i18n/<locale>/**.md` αντικατοπτρίζει — ποτέ δεν διαβάζει `src/i18n/messages/*.json`. Λειτουργεί σε job `docs-sync-strict`: συμβουλευτικό για PRs, αυστηρό για ώθηση και βραδινή. το κύμα μετάφρασης ανανεώνει τους καθρέφτες, όχι το χαρακτηριστικό PR.
|
||||
|
||||
**Με επίγνωση των διαφορών, όχι με βάση τη γραμμή βάσης.** Συγκρίνει `en.json` στη βάση συγχώνευσης με το δέντρο εργασίας. Για κάθε κλειδί του οποίου η αγγλική τιμή έχει αλλάξει, οποιαδήποτε τοπική γλώσσα εξακολουθεί να διατηρεί μια ανέγγιχτη μετάφραση είναι μπαγιάτικη. Αυτό σκόπιμα** παγώνει το προϋπάρχον χρέος** — μια διαφορά δεν μπορεί να αποκαλύψει από ποια παλιά αγγλικά προήλθε μια μακροχρόνια μετάφραση, επομένως η πύλη κρίνει μόνο τι αγγίζει η τρέχουσα αλλαγή. Η εναλλακτική λύση (μια βασική γραμμή κατακερματισμού ανά κλειδί) θα κόστιζε ένα αρχείο που δημιουργείται ~ 600 KB, 3 × η μεγαλύτερη υπάρχουσα γραμμή βάσης, που αναδεύεται σε κάθε i18n PR.
|
||||
**Με επίγνωση των διαφορών, όχι με βάση τη γραμμή βάσης.** Συγκρίνει `en.json` στη βάση συγχώνευσης με το δέντρο εργασίας. Για κάθε κλειδί του οποίου η τιμή στα αγγλικά άλλαξε, κάθε τοπική γλώσσα που εξακολουθεί να διατηρεί μια ανέγγιχτη μετάφραση είναι μπαγιάτικη. Αυτό σκόπιμα** παγώνει το προϋπάρχον χρέος** — μια διαφορά δεν μπορεί να αποκαλύψει από ποια παλιά αγγλικά προήλθε μια μακροχρόνια μετάφραση, επομένως η πύλη κρίνει μόνο τι αγγίζει η τρέχουσα αλλαγή. Η εναλλακτική λύση (μια βασική γραμμή κατακερματισμού ανά κλειδί) θα κόστιζε ένα αρχείο που δημιουργείται ~ 600 KB, 3 × η μεγαλύτερη υπάρχουσα γραμμή βάσης, που αναδεύεται σε κάθε i18n PR.
|
||||
|
||||
Δύο τρόποι για να το ικανοποιήσεις:
|
||||
|
||||
@@ -288,7 +290,7 @@ BASE_REF=origin/release/vX.Y.Z npm run i18n:check-value-drift
|
||||
| ---------------------- | ----------------------------------------------------------------------------------------------------------------------------------------------------- | ----------- |
|
||||
| `check:pr-test-policy` | PRs που αλλάζει τον κωδικό παραγωγής σε `src/`, `open-sse/`, `electron/` ή `bin/` πρέπει να περιλαμβάνει ή να ενημερώνει δοκιμές (Σκληρός κανόνας #8) | Ναί |
|
||||
| `check:test-masking` | Τα τροποποιημένα αρχεία δοκιμής δεν μειώνουν τον καθαρό αριθμό ισχυρισμών ούτε προσθέτουν ταυτολογίες `assert.ok(true)` | Ναί |
|
||||
| `check:pr-evidence` | Το σώμα PR παραθέτει στοιχεία test/VPS για την αλλαγή (μηχανοποιεί τον σκληρό κανόνα #18 με το grepping PR prose — fragile, βλ. | Ναί |
|
||||
| `check:pr-evidence` | Το σώμα PR παραθέτει στοιχεία test/VPS για την αλλαγή (μηχανοποιεί τον σκληρό κανόνα #18 με το grepping PR prose — fragile, βλέπε Backlog) | Ναί |
|
||||
|
||||
### Δουλειά: `test-vitest`
|
||||
|
||||
@@ -307,7 +309,7 @@ BASE_REF=origin/release/vX.Y.Z npm run i18n:check-value-drift
|
||||
| ---------------------- | ------------------------------------------------------------------------------------------------------------------------------------------------------------------- | ------------------ |
|
||||
| `nightly-property` | γρήγορος έλεγχος δοκιμών ιδιοτήτων με τυχαίο πλήθος τυχαίων σπόρων + | **Συμβουλευτικός** |
|
||||
| `nightly-resilience` | πύλη ανάπτυξης σωρών, σφάλμα χάους-ένεση, k6 load/soak | **Συμβουλευτικός** |
|
||||
| `nightly-llm-security` | Promptfoo injection guard (λειτουργία μπλοκ) ανιχνευτές + garak (παράβλεψη χωρίς μυστικό παρόχου) | **Συμβουλευτικός** |
|
||||
| `nightly-llm-security` | Promptfoo injection guard (block mode) probes + garak (παραβλήθηκε χωρίς μυστικό παρόχου) | **Συμβουλευτικός** |
|
||||
| `nightly-schemathesis` | Σύμπτυξη συμβάσεων OpenAPI (σχήμα) έναντι ζωντανού OmniRoute με χρήση παραβιάσεων προδιαγραφών επιφανειών `docs/openapi.yaml` — / μη χειριζόμενες 500s (Φάση 8 B.4) | **Συμβουλευτικός** |
|
||||
| `nightly-mutation` | Βαθμολογία δοκιμής μετάλλαξης Stryker στη γρήγορη μονάδα λωρίδας — επιζώντες μεταλλάκτες επιφάνεια αδύναμοι ισχυρισμοί | **Συμβουλευτικός** |
|
||||
| `nightly-compat` | Πίνακας συμβατότητας κινητήρα κόμβου σε όλες τις υποστηριζόμενες περιοχές `engines.node` | **Συμβουλευτικός** |
|
||||
|
||||
@@ -42,25 +42,23 @@ flowchart LR
|
||||
Το `main` δεν είναι ο κλάδος καθημερινής ενσωμάτωσης. Τα PR που ανοίγονται με στόχο το `main`
|
||||
συνήθως χρειάζεται να αλλάξουν στόχο πριν από τη συγχώνευση.
|
||||
|
||||
## Πάγωμα έκδοσης (παράλληλοι κύκλοι)
|
||||
## Απελευθερώστε το πάγωμα (παράλληλοι κύκλοι)
|
||||
|
||||
Όταν γίνεται η ενοποίηση μιας έκδοσης, ανοίγει ένα ζήτημα-δείκτης με την ετικέτα `release-freeze`.
|
||||
Αυτό **δεν σταματά την ανάπτυξη**:
|
||||
Όταν γίνεται συμφωνία για μια έκδοση, ανοίγει ένα ζήτημα δείκτη με την ένδειξη `release-freeze`. Οτι** δεν σταματά την ανάπτυξη** :
|
||||
|
||||
- Το παγωμένο `release/vX.Y.Z` ανήκει στον υπεύθυνο έκδοσης για τη συγκεκριμένη κυκλοφορία.
|
||||
- Ο επόμενος κύκλος `release/vX+1` δημιουργείται από την παγωμένη κορυφή, ώστε οι συνεισφέροντες να συνεχίσουν
|
||||
να ενσωματώνουν εργασίες.
|
||||
- Τα ανοιχτά PR που εξακολουθούν να στοχεύουν τον παγωμένο κλάδο πρέπει να **αλλάξουν στόχο** στον
|
||||
ενεργό (υψηλότερο) κλάδο `release/v*`.
|
||||
- Το παγωμένο `release/vX.Y.Z` ανήκει στον καπετάνιο απελευθέρωσης αυτού του πλοίου.
|
||||
- Το `release/vX+1` του επόμενου κύκλου κόβεται από την παγωμένη άκρη, ώστε οι συνεισφέροντες να συνεχίσουν να προσγειώνονται.
|
||||
- Ανοίξτε PRs που εξακολουθούν να στοχεύουν τον παγωμένο κλάδο θα πρέπει να είναι** επαναστοχευμένο** στον ενεργό (υψηλότερο) κλάδο `release/v*`.
|
||||
|
||||
Ελέγξτε αν υπάρχει ενεργό πάγωμα προτού θεωρήσετε ότι ο κλάδος που θέλετε μπορεί να δεχτεί συγχωνεύσεις:
|
||||
Ελέγξτε για ανοιχτό πάγωμα προτού υποθέσετε ότι το υποκατάστημα που θέλετε είναι συγχωνεύσιμο:
|
||||
|
||||
```bash
|
||||
gh issue list --repo diegosouzapw/OmniRoute --label release-freeze --state open
|
||||
```
|
||||
|
||||
Οι μηχανισμοί συγχώνευσης (ετικέτα `queue` από τον ιδιοκτήτη → Mergify) τεκμηριώνονται στο
|
||||
[MERGE_TRAIN.md](./MERGE_TRAIN.md).
|
||||
Οι μηχανισμοί συγχώνευσης (ιδιοκτήτρια ετικέτα `queue` → Mergify) τεκμηριώνονται στο [MERGE_TRAIN.md](./MERGE_TRAIN.md).
|
||||
|
||||
> **2026-11-19: η ουρά συγχώνευσης Mergify αποσύρεται** (απόφαση ιδιοκτήτη). `.mergify.yml` δεν ορίζει πλέον μια ουρά και απορρίπτει τις εντολές Mergify που συγχωνεύουν ή ξαναγράφουν ένα αίτημα έλξης. Η κυκλοφορία PRs συγχωνεύεται με το χέρι κάτω από το σύνολο κανόνων αποθετηρίου "Απαιτούνται πράσινες πύλες στην ενεργή κυκλοφορία" (`Gate / CI` + `Gate / Quality`) μέχρι να εκτελεστεί η omni-queue σε ζωντανή λειτουργία και μετά από αυτήν μέσω της omni-queue ( [OMNI_QUEUE.md](./OMNI_QUEUE.md) ). Η ετικέτα `queue` δεν συγχωνεύει πλέον τίποτα.
|
||||
|
||||
## Γιατί και κλάδος και ετικέτα;
|
||||
|
||||
|
||||
@@ -4,10 +4,9 @@
|
||||
|
||||
---
|
||||
|
||||
Από την έκδοση v3.8.49 (WS3.2/WS3.4 του πλάνου ποιότητας/ταχύτητας), η προεπιλεγμένη διαδρομή συγχώνευσης για
|
||||
ελεγμένα PRs προς το `release/vX.Y.Z` είναι η **ουρά συγχώνευσης του Mergify** (`.mergify.yml`)·
|
||||
η **μη αυτόματη αμαξοστοιχία συγχώνευσης** που τεκμηριώνεται παρακάτω είναι η ΕΦΕΔΡΙΚΗ ΛΥΣΗ — χρησιμοποιείται κατά τη διάρκεια συμβάντων,
|
||||
παγώματος έκδοσης ή αν αλλάξει ποτέ το πρόγραμμα Ανοιχτού Κώδικα του Mergify.
|
||||
> **2026-11-19: η ουρά συγχώνευσης Mergify αποσύρεται** (απόφαση ιδιοκτήτη). `.mergify.yml` δεν ορίζει πλέον μια ουρά και απορρίπτει τις εντολές Mergify που συγχωνεύουν ή ξαναγράφουν ένα αίτημα έλξης. Η κυκλοφορία PRs συγχωνεύεται με το χέρι κάτω από το σύνολο κανόνων αποθετηρίου "Απαιτούνται πράσινες πύλες στην ενεργή κυκλοφορία" (`Gate / CI` + `Gate / Quality`) μέχρι να εκτελεστεί η omni-queue σε ζωντανή λειτουργία και μετά από αυτήν μέσω της omni-queue ( [OMNI_QUEUE.md](./OMNI_QUEUE.md) ). Οι παρακάτω ενότητες Mergify περιγράφουν την ουρά όπως ήταν.
|
||||
|
||||
Δεδομένου ότι η έκδοση 3.8.49 (WS3.2/WS3.4 του σχεδίου quality/velocity ) η προεπιλεγμένη διαδρομή συγχώνευσης για το αναθεωρημένο PRs σε `release/vX.Y.Z` είναι η** Συγχώνευση ουράς συγχώνευσης** (`.mergify.yml`); ο** χειροκίνητη συγχώνευση** που τεκμηριώνεται παρακάτω είναι το FALLBACK — που χρησιμοποιείται κατά τη διάρκεια περιστατικών, παγώσεων εκδόσεων ή εάν αλλάξει ποτέ το πρόγραμμα Mergify Open Source.
|
||||
|
||||
## Προεπιλεγμένη διαδρομή: η ουρά του Mergify
|
||||
|
||||
|
||||
@@ -355,111 +355,70 @@ npm run build:release
|
||||
|
||||
---
|
||||
|
||||
## Αποκοπή της 3.9.0 LTS (πρόβα στην 3.8.58)
|
||||
## 3.9.0 LTS cut (πρόβα στο 3.8.58)
|
||||
|
||||
Μετά τη v3.8.59, η επόμενη έκδοση είναι η 3.9.0 και η κορυφή της μετατρέπεται σε δύο μακρόβιους κλάδους:
|
||||
`stable/v3` (η γραμμή v3 LTS, npm `latest`) και `develop` (v4, αναβαθμισμένη σε 4.0.0, npm
|
||||
`nightly`). Το μοντέλο κλάδων/καναλιών, το forward-port και οι ετικέτες βρίσκονται στο
|
||||
[RELEASE_STRATEGY.md](./RELEASE_STRATEGY.md)· το σχέδιο βρίσκεται στο [ROADMAP](../../ROADMAP.md) (Φάση 3). Η αποκοπή εκτελείται μία φορά·
|
||||
η 3.8.58 αποτελεί πλήρη πρόβα της σε ένα fork και η 3.8.59 ολοκληρώνεται με τη
|
||||
[λίστα ελέγχου GO/NO-GO](./LTS_GO_NO_GO.md).
|
||||
Μετά την έκδοση 3.8.59, η επόμενη έκδοση είναι η 3.9.0 και η άκρη της γίνεται δύο κλάδοι με μεγάλη διάρκεια ζωής: `stable/v3` (η γραμμή v3 LTS, npm `latest`) και `develop` (v4, μειώθηκε σε 4.0.0, npm `nightly`). Το μοντέλο branch/channel, η θύρα προς τα εμπρός και οι ετικέτες είναι σε [RELEASE_STRATEGY.md](./RELEASE_STRATEGY.md) ; το σχέδιο είναι στο [ROADMAP](../../ROADMAP.md) (Φάση 3). Η περικοπή εκτελείται μία φορά. Το 3.8.58 το κάνει πρόβες από άκρη σε άκρη σε ένα πιρούνι και το 3.8.59 κλείνει με τη [λίστα ελέγχου GO/NO-GO](./LTS_GO_NO_GO.md).
|
||||
|
||||
### Δοκιμαστική εκτέλεση (μόνο για ανάγνωση, ασφαλής ανά πάσα στιγμή)
|
||||
### Ξηρή λειτουργία (μόνο για ανάγνωση, ασφαλής ανά πάσα στιγμή)
|
||||
|
||||
```bash
|
||||
npm run release:dry-run-lts-cut # η πραγματική αποκοπή: 3.9.0 από το HEAD, προηγούμενο tag v3.8.59
|
||||
npm run release:dry-run-lts-cut -- --from <3.9.0-tip> # καθορισμός του commit προέλευσης
|
||||
npm run release:dry-run-lts-cut # the real cut: 3.9.0 from HEAD, previous tag v3.8.59
|
||||
npm run release:dry-run-lts-cut -- --from <3.9.0-tip> # pin the source commit
|
||||
```
|
||||
|
||||
Το `scripts/release/dry-run-lts-cut.mjs` δεν εκτελεί τίποτα: διαβάζει τα git και `gh` και εμφανίζει
|
||||
ολόκληρη την ακολουθία — προϋποθέσεις (η προέλευση επιλύεται, το αποθετήριο προέλευσης έχει πλήρες ιστορικό —
|
||||
ένα shallow clone δεν μπορεί να προωθήσει το `stable/v3`, η πλευρά λήψης απορρίπτει το πακέτο στον πρώτο
|
||||
grafted γονέα, επομένως εκτελέστε την αποκοπή από ένα πλήρες clone ή εκτελέστε πρώτα `git fetch --unshallow origin` — το προηγούμενο
|
||||
tag υπάρχει, το `package.json` έχει την έκδοση-στόχο, υπάρχει ανοιχτό issue `release-freeze`, δεν υπάρχει ανοιχτό
|
||||
issue `Release branch not green`
|
||||
σε υπάρχοντα κλάδο έκδοσης — ένας κλάδος που δεν υπάρχει αναφέρεται ως `?` άγνωστος, ποτέ
|
||||
πράσινος — η ουρά `release` του Mergify είναι διαμορφωμένη (G11: `queue_rules`, `checks_timeout`,
|
||||
ετικέτα `queue`), το σύνολο κανόνων `release/*` εξακολουθεί να αποκλείει τη διαγραφή και το force-push και
|
||||
τα `stable/v3` και `develop` δεν υπάρχουν ακόμη), τα δύο βήματα δημιουργίας κλάδων, ποια εναύσματα ανενεργών workflow
|
||||
και ποιες συνθήκες `if:` γίνονται αληθείς (και ποια παραμένουν αποκλεισμένα από μια μεταβλητή αποθετηρίου ή
|
||||
καρφιτσωμένα στο κανονικό αποθετήριο), τα αναμενόμενα dist-tags (`latest` → 3.9.0, `next` και
|
||||
`nightly` κενά) και την επαναφορά. Κωδικός εξόδου `0` = `RESULT: READY`, `1` = αποτυχία προϋπόθεσης
|
||||
που εμποδίζει τη διαδικασία (`✗`), `2` = σφάλμα χρήσης. Το `--advisory <id,...>` υποβαθμίζει έναν έλεγχο σε προειδοποίηση (`!`)
|
||||
χωρίς να τον αποκρύπτει.
|
||||
`scripts/release/dry-run-lts-cut.mjs` δεν εκτελεί τίποτα: διαβάζει git και `gh` και εκτυπώνει ολόκληρη τη σειρά — προϋποθέσεις (η πηγή επιλύεται, το αποθετήριο πηγής έχει πλήρες ιστορικό — ένας ρηχός κλώνος δεν μπορεί να ωθήσει `stable/v3`, η πλευρά λήψης απορρίπτει το πακέτο στον πρώτο ενοφθαλμισμένο γονέα, οπότε κόψτε από έναν πλήρη κλώνο ή `git fetch --unshallow origin` η πρώτη έκδοση — είναι ανοιχτή, το `package.json` είναι ανοιχτό το προηγούμενο θέμα `release-freeze` `Release branch not green` σε έναν υπάρχοντα κλάδο έκδοσης — ένας κλάδος που δεν υπάρχει αναφέρει `?` άγνωστο, ποτέ πράσινο — omni-queue προσγειώνει την έκδοση PRs (G11: `config/merge-queue/config.json` ισχύει, `bases` του διαχειρίζεται τον κλάδο έκδοσης, `mode` `live`, η ετικέτα του υπάρχει), το σύνολο κανόνων `release/*` εξακολουθεί να μπλοκάρει τη διαγραφή και την εξαναγκαστική ώθηση του κλάδου, και `stable/v3` `develop` οι ενεργοποιήσεις και οι συνθήκες `if:` γίνονται αληθείς (και οι οποίες παραμένουν περιφραγμένες από μια μεταβλητή χώρου αποθήκευσης ή καρφιτσωμένες στο κανονικό αποθετήριο), οι αναμενόμενες ετικέτες απόστασης (`latest` → 3.9.0, `next` και `nightly` κενές) και η επαναφορά. Έξοδος `0` = `RESULT: READY`, `1` = απέτυχε μια προϋπόθεση αποκλεισμού (`✗`), σφάλμα χρήσης `2` =. `--advisory <id,...>` υποβαθμίζει μια επιταγή σε προειδοποίηση (`!`) χωρίς να την κρύβει.
|
||||
|
||||
Εκτελέστε τη δοκιμαστική εκτέλεση της πραγματικής αποκοπής όσο το πάγωμα έκδοσης της 3.9.0 παραμένει ανοιχτό — οι κλάδοι
|
||||
δημιουργούνται μετά το tag και πριν η Φάση 12c άρει το πάγωμα.
|
||||
Εκτελέστε το dry-run της πραγματικής κοπής — το freeze απελευθέρωσης 3.9.0 είναι ακόμα ανοιχτό.
|
||||
|
||||
### Πρόβα της 3.8.58 (μόνο σε fork)
|
||||
### 3.8.58 πρόβα (μόνο πιρούνι)
|
||||
|
||||
```bash
|
||||
# 1. Δοκιμαστική εκτέλεση στην τρέχουσα κορυφή με παραμέτρους πρόβας
|
||||
# 1. Dry-run on the current tip with rehearsal parameters
|
||||
npm run release:dry-run-lts-cut -- --target-version 3.8.58 --previous-tag v3.8.57 \
|
||||
--advisory freeze,base-green
|
||||
|
||||
# 2. Εκτέλεση σε remote ενός FORK (το origin ή οποιοδήποτε remote του οποίου το URL είναι αυτό του κανονικού
|
||||
# αποθετηρίου απορρίπτεται· κάθε βήμα ζητά επιβεβαίωση στο τερματικό)
|
||||
# 2. Execute against a FORK remote (origin, or any remote whose URL is the canonical
|
||||
# repository, is refused; every step asks for confirmation on the terminal)
|
||||
git remote add rehearsal https://github.com/<you>/OmniRoute.git
|
||||
node scripts/release/dry-run-lts-cut.mjs --execute --remote rehearsal \
|
||||
--target-version 3.8.58 --previous-tag v3.8.57 --advisory freeze,base-green
|
||||
|
||||
# 3. Δοκιμή των ανενεργών workflow στο fork (workflow_dispatch όπου η δοκιμαστική εκτέλεση
|
||||
# αναφέρει καρφίτσωμα στο κανονικό αποθετήριο) και, στη συνέχεια, επαναφορά
|
||||
# 3. Exercise the dormant workflows in the fork (workflow_dispatch where the dry-run
|
||||
# reports a canonical-repository pin), then roll back
|
||||
node scripts/release/dry-run-lts-cut.mjs --execute --rollback --remote rehearsal \
|
||||
--target-version 3.8.58 --previous-tag v3.8.57 --advisory freeze,base-green
|
||||
```
|
||||
|
||||
Το commit αναβάθμισης του develop δημιουργείται με χαμηλού επιπέδου εντολές του git (χωρίς να επηρεάζεται το working tree) και αναβαθμίζει
|
||||
τα ίδια πέντε αρχεία με ένα commit ανοίγματος κύκλου: `package.json`, `open-sse/package.json`,
|
||||
`electron/package.json`, `package-lock.json` και `docs/openapi.yaml`. Η ενότητα `[4.0.0]`
|
||||
του CHANGELOG και τα αντίστοιχα i18n αντίγραφά της ανοίγονται κατόπιν στο `develop`, πριν από το πρώτο
|
||||
PR του. Το script δεν αλλάζει ποτέ τα npm dist-tags — κάντε πρόβα αυτών σε ένα δοκιμαστικό πακέτο.
|
||||
Το develop bump commit είναι χτισμένο με git plumbing (δεν αγγίζεται δέντρο που λειτουργεί) και προσκρούει τα ίδια πέντε αρχεία με μια δέσμευση κυκλικού ανοιχτού: `package.json`, `open-sse/package.json`, `electron/package.json`, `package-lock.json` και `docs/openapi.yaml`. Το τμήμα `[4.0.0]` CHANGELOG και οι καθρέφτες του i18n ανοίγουν στο `develop` μετά, πριν από το πρώτο PR. Το σενάριο δεν αλλάζει ποτέ npm dist-tags — κάνουν πρόβα εκείνων σε πακέτο scratch.
|
||||
|
||||
### Artifact προεπισκόπησης PR (δημιουργία μία φορά, προώθηση των ίδιων byte)
|
||||
### τεχνούργημα προεπισκόπησης PR (δημιουργήστε μία φορά, προωθήστε τα ίδια byte)
|
||||
|
||||
Το `.github/workflows/preview-artifact.yml` δημιουργεί ένα tarball παραγωγής από την κεφαλή ενός PR και
|
||||
επικυρώνει ακριβώς αυτό το build (τμήμα (a) του #8084). Μόνο PR από το ίδιο αποθετήριο· τίποτα δεν δημοσιεύεται.
|
||||
`.github/workflows/preview-artifact.yml` κατασκευάζει ένα tarball παραγωγής από μια κεφαλή PR και επικυρώνει αυτό ακριβώς το build (#8084 slice (a)). Μόνο PRs ίδιου αποθετηρίου. τίποτα δεν δημοσιεύεται.
|
||||
|
||||
```bash
|
||||
gh workflow run preview-artifact.yml -f pr_number=<N> # ή προσθέστε την ετικέτα `preview-artifact`
|
||||
gh workflow run preview-artifact.yml -f pr_number=<N> # or add the `preview-artifact` label
|
||||
gh run download <run-id> --name preview-artifact-pr<N>-<sha7> --dir preview
|
||||
cd preview && sha256sum -c SHA256SUMS
|
||||
gh attestation verify omniroute-*.tgz --repo diegosouzapw/OmniRoute
|
||||
npm install -g ./omniroute-*.tgz # εγκατάσταση προεπισκόπησης
|
||||
npm install -g ./omniroute-*.tgz # preview install
|
||||
```
|
||||
|
||||
Η εκτέλεση πραγματοποιεί `npm ci`, `npm run build:release`, `npm run check:pack-artifact`, συσκευάζει το
|
||||
tarball, εκτελεί `npm run check:pack-boot` (ψεύτικα μυστικά, προσωρινός κατάλογος δεδομένων), επανασυσκευάζει και
|
||||
αποτυγχάνει εκτός αν το digest είναι πανομοιότυπο, έπειτα καταγράφει το `artifact-identity.json` (SHA κεφαλής, SHA βάσης,
|
||||
hash του lockfile, πλατφόρμα, αρχιτεκτονική, ABI του node, bundler, πολιτική build —
|
||||
`scripts/release/artifact-identity.mjs`) και πιστοποιεί το tarball σε ξεχωριστό job. Η προώθηση
|
||||
μιας προεπισκόπησης σημαίνει εγκατάσταση αυτού του tarball: ποτέ μην εκτελείτε νέο build από τον πηγαίο κώδικα.
|
||||
Η εκτέλεση εκτελεί `npm ci`, `npm run build:release`, `npm run check:pack-artifact`, γεμίζει το tarball, εκτελεί `npm run check:pack-boot` (ψεύτικα μυστικά, εφήμερα δεδομένα dir), επανασυσκευάζεται και αποτυγχάνει, εκτός εάν η σύνοψη είναι πανομοιότυπη, και στη συνέχεια καταγράφει `artifact-identity.json` (κεφαλή SHA, βάση SHA, lockfile hash, arch, κόμβος ABI `scripts/release/artifact-identity.mjs` πλατφόρμα — το tarball σε ξεχωριστή δουλειά. Η προώθηση μιας προεπισκόπησης σημαίνει εγκατάσταση αυτού του tarball: ποτέ μην αναδημιουργείτε από την πηγή.
|
||||
|
||||
### Η αποκοπή (3.9.0, μετά το GO)
|
||||
### Το cut (3.9.0, μετά GO)
|
||||
|
||||
1. Το GO καταγράφεται στο [LTS_GO_NO_GO.md](./LTS_GO_NO_GO.md).
|
||||
2. Το `npm run release:dry-run-lts-cut -- --from v3.9.0` εμφανίζει `RESULT: READY`.
|
||||
3. Δημιουργήστε τους κλάδους στο `origin` χειροκίνητα με τις εντολές που εμφανίζει η δοκιμαστική εκτέλεση — το
|
||||
script αρνείται να κάνει push στο `origin`. Για να επαναχρησιμοποιήσετε ένα ελεγμένο commit του develop, εκτελέστε πρώτα την
|
||||
πρόβα με `--execute` στην κορυφή της 3.9.0, χρησιμοποιώντας το fork σας· εμφανίζει και τα δύο SHA και
|
||||
μπορούν να γίνουν push τα ίδια commit:
|
||||
1. GO καταγράφηκε σε [LTS_GO_NO_GO.md](./LTS_GO_NO_GO.md).
|
||||
2. `npm run release:dry-run-lts-cut -- --from v3.9.0` εκτυπώνει `RESULT: READY`.
|
||||
3. Δημιουργήστε τα κλαδιά στο `origin` με το χέρι με τις εντολές που εκτυπώνει η ξηρή εκτέλεση — το σενάριο αρνείται να ωθήσει στο `origin`. Για να επαναχρησιμοποιήσετε ένα αναθεωρημένο commit ανάπτυξης, εκτελέστε πρώτα την πρόβα `--execute` στο άκρο 3.9.0 στο πιρούνι σας. Εκτυπώνει και τα δύο SHAs και μπορούν να προωθηθούν οι ίδιες δεσμεύσεις:
|
||||
|
||||
```bash
|
||||
git push origin <stable-sha>:refs/heads/stable/v3 <develop-sha>:refs/heads/develop
|
||||
```
|
||||
|
||||
4. Προστατέψτε τα `stable/v3` και `develop` (rulesets + merge queue) πριν ενσωματωθεί το πρώτο PR.
|
||||
5. Οι ανενεργές ροές εργασίας ενεργοποιούνται με την ύπαρξη των κλάδων: `forward-port.yml` (push στο
|
||||
`stable/v3`), `validate-stable-pr.yml` (PRs προς το `stable/v3`) και `nightly-v4-build.yml`
|
||||
(κάνει build το `develop`). Πριν από την έναρξη λειτουργίας, ορίστε το repository secret `secrets.FORWARD_PORT_TOKEN` (ώστε το CI να εκτελείται στα
|
||||
forward-port PRs)· η νυχτερινή δημοσίευση παραμένει απενεργοποιημένη μέχρι ο ιδιοκτήτης να ορίσει τη μεταβλητή repository
|
||||
`vars.NIGHTLY_PUBLISH` σε `true` και το npm Trusted Publishing να αποδεχτεί το
|
||||
`nightly-v4-build.yml`. Η επίλυση του καναλιού γίνεται από το `scripts/release/dist-tag.mjs`, το ίδιο
|
||||
resolver που χρησιμοποιεί το `npm-publish.yml`.
|
||||
6. Επαληθεύστε τα κανάλια: το `npm view omniroute dist-tags --json` εμφανίζει `latest` = 3.9.0 και κανένα
|
||||
`next` / `nightly` μέχρι να δημοσιευτεί η v4.
|
||||
7. Επαναφορά, αν χρειαστεί: `git push origin --delete refs/heads/stable/v3 refs/heads/develop`
|
||||
και `npm dist-tag add omniroute@3.8.59 latest`.
|
||||
4. Προστατέψτε `stable/v3` και `develop` (κανόνες ουράς συγχώνευσης + ) πριν προσγειωθεί το πρώτο PR.
|
||||
5. Οι αδρανείς ροές εργασίας ενεργοποιούνται ανάλογα με την ύπαρξη διακλάδωσης: `forward-port.yml` (ώθηση σε `stable/v3`), `validate-stable-pr.yml` (PRs σε `stable/v3`) και `nightly-v4-build.yml` (δημιουργία `develop`). Πριν το go-live, ορίστε το μυστικό αποθετηρίου `secrets.FORWARD_PORT_TOKEN` (έτσι CI εκτελείται στη θύρα προώθησης PRs). Η νυχτερινή δημοσίευση παραμένει απενεργοποιημένη έως ότου ο κάτοχος ορίσει τη μεταβλητή χώρου αποθήκευσης `vars.NIGHTLY_PUBLISH` σε `true` και η npm Trusted Publishing αποδεχτεί `nightly-v4-build.yml`. Η ανάλυση καναλιού είναι `scripts/release/dist-tag.mjs`, την ίδια ανάλυση που χρησιμοποιεί `npm-publish.yml`.
|
||||
6. Επαληθεύστε τα κανάλια: `npm view omniroute dist-tags --json` εμφανίζει `latest` = 3.9.0 και κανένα `next` / `nightly` μέχρι να δημοσιευτεί το v4.
|
||||
7. Επαναφορά, εάν χρειάζεται: `git push origin --delete refs/heads/stable/v3 refs/heads/develop` και `npm dist-tag add omniroute@3.8.59 latest`.
|
||||
|
||||
---
|
||||
|
||||
|
||||
@@ -136,36 +136,22 @@ CPU χωρίς συνδεδεμένη εργασία. Κάθε μονάδα Omni
|
||||
λεπτά για να αποθηκευτεί στο tmpfs και 2 λεπτά για να μεταφορτωθεί από τον δίσκο.
|
||||
- Το VPS `.15` προορίζεται μόνο για homologation — δεν εκτελεί ποτέ CI runners.
|
||||
|
||||
## Φιλοξενούμενος δίαυλος (runners που φιλοξενούνται στο GitHub)
|
||||
## Φιλοξενούμενη λωρίδα (δρομείς που φιλοξενούνται από το GitHub)
|
||||
|
||||
Το αποθετήριο ανήκει στον οργανισμό `cheaper-inference`, στο πρόγραμμα **Team**: **60
|
||||
ταυτόχρονες φιλοξενούμενες εργασίες**, κοινόχρηστες από κάθε αποθετήριο του οργανισμού, κάθε έλεγχο PR,
|
||||
κάθε workflow που ενεργοποιείται από push και την προεπιλεγμένη ρύθμιση του CodeQL. Τα παρακάτω στοιχεία μετρήθηκαν στο
|
||||
πρόγραμμα **Pro** (40 ταυτόχρονες φιλοξενούμενες εργασίες). Μετρήθηκε στις 2026-10-18 κατά τη διάρκεια μιας
|
||||
εκστρατείας συγχωνεύσεων (~10 συγχωνεύσεις/ώρα στο `release/v3.8.52`): δημιουργήθηκαν **2.500 εκτελέσεις workflow μέσα σε
|
||||
24 ώρες**, 44 push στον κλάδο μέσα σε 6 ώρες, **106 φιλοξενούμενες εργασίες σε αναμονή**, ενώ οι έλεγχοι PR περίμεναν για
|
||||
ώρες και τα PR συγχωνεύονταν χωρίς αυτούς. Εννέα workflow ενεργοποιούνταν σε κάθε push προς τον κλάδο:
|
||||
Το αποθετήριο ανήκει στον οργανισμό `cheaper-inference`, στο** Ομάδα** σχέδιο:** 60 ταυτόχρονες φιλοξενούμενες θέσεις εργασίας** , κοινόχρηστο από κάθε χώρο αποθήκευσης στον οργανισμό, κάθε έλεγχος PR, κάθε ροή εργασίας που ενεργοποιείται από push και η προεπιλεγμένη ρύθμιση του CodeQL. Τα παρακάτω στοιχεία μετρήθηκαν στο** Pro** σχέδιο (40 ταυτόχρονες φιλοξενούμενες θέσεις εργασίας). Μετρήθηκε στις 18-10-2026 κατά τη διάρκεια μιας καμπάνιας συγχώνευσης (~ 10 merges/hour on `release/v3.8.52`):** 2.500 εκτελέσεις ροής εργασιών που δημιουργήθηκαν σε 24 ώρες** , 44 ωθήσεις στο κλαδί σε 6 ώρες,** 106 φιλοξενούμενες θέσεις εργασίας στην ουρά** ενώ οι επιταγές PR περίμεναν για ώρες και PRs συγχωνεύτηκε χωρίς αυτούς. Εννέα ροές εργασίας ενεργοποιήθηκαν σε κάθε ώθηση προς το υποκατάστημα:
|
||||
|
||||
| ανά push στο `release/v*` | φιλοξενούμενες εργασίες | αποτέλεσμα υπό τον καταιγισμό | από τις 2026-10-18 |
|
||||
| ------------------------------------------- | ----------------------: | ------------------------------------------------------------------- | ------------------------------------------------------------------------------------- |
|
||||
| `ci.yml` (πλήρες matrix) | έως 30 | ακυρωνόταν από το επόμενο push, 24 από 24 σε μία ημέρα | δεν ξεκινά σε push προς `release/**` (εκτέλεση PR + Release-Green) |
|
||||
| `quality.yml` | ~6 | ακυρώθηκε, 23 από 23 | δεν ξεκινά σε push προς `release/**` |
|
||||
| `Release-Green` `--quick` | 0 | εκτελούνταν στο `omni-build`, ακυρώθηκαν 97 από 100 | θέση `omni-release`, δεν ακυρώνεται ποτέ, οι εκκρεμείς εκτελέσεις συμπτύσσονται |
|
||||
| `Lock released branch`, `OpenSSF Scorecard` | 2 | μία εκτέλεση σε αναμονή ανά push | μία εκτέλεση ανά ref (`tests/unit/build/hosted-lane-concurrency.test.ts`) |
|
||||
| `Release acceptance` (σκιώδης αναφορά) | 1 | ένα φιλοξενούμενο `npm ci` ανά push, δεν ακυρώνεται ποτέ | αμετάβλητο — υποψήφιο για φίλτρο `paths:` |
|
||||
| `Publish to Docker Hub` → `Deploy to VPS` | 2 | ακυρώνεται ανά push· το σκέλος amd64 ανταγωνίζεται στο `omni-build` | αμετάβλητο — το κανάλι ανάπτυξης του κατόχου |
|
||||
| Προεπιλεγμένη ρύθμιση CodeQL (`dynamic`) | 4 | `javascript-typescript`, `actions`, `c-cpp`, `python` ανά push | αμετάβλητο — Ρυθμίσεις → Ασφάλεια κώδικα· τα `c-cpp`/`python` δεν σαρώνουν τίποτα εδώ |
|
||||
| ανά ώθηση σε `release/v*` | φιλοξενούμενες θέσεις εργασίας | έκβαση κάτω από την καταιγίδα | από το 2026-10-18 |
|
||||
| ------------------------------------------- | -----------------------------: | ----------------------------------------------------------------- | --------------------------------------------------------------------------------- |
|
||||
| `ci.yml` (πλήρης μήτρα) | έως 30 | ακυρώθηκε με την επόμενη ώθηση, 24 από 24 σε μια ημέρα | δεν ξεκίνησε σε pushes `release/**` (PR εκτέλεση + Release-Green) |
|
||||
| `quality.yml` | ~6 | ακυρώθηκε, 23 από 23 | δεν ξεκίνησε στις ωθήσεις `release/**` |
|
||||
| `Release-Green` `--quick` | 0 | έτρεξε στο `omni-build`, ακυρώθηκε 97 από 100 | Υποδοχή `omni-release`, δεν ακυρώθηκε ποτέ, καταρρέει σε εκκρεμότητα |
|
||||
| `Lock released branch`, `OpenSSF Scorecard` | 2 | μία ουρά ανά ώθηση | ένα τρέξιμο ανά ref (`tests/unit/build/hosted-lane-concurrency.test.ts`) |
|
||||
| `Release acceptance` (σκιώδης αναφορά) | 1 | ένα φιλοξενούμενο `npm ci` ανά ώθηση, δεν ακυρώθηκε ποτέ | αμετάβλητο υποψήφιο — για φίλτρο `paths:` |
|
||||
| `Publish to Docker Hub` → `Deploy to VPS` | 2 | ακυρώνεται ανά ώθηση. Το amd64 leg ανταγωνίζεται στο `omni-build` | αμετάβλητο το κανάλι ανάπτυξης του κατόχου — |
|
||||
| προεπιλεγμένη ρύθμιση CodeQL (`dynamic`) | 4 | `javascript-typescript`, `actions`, `c-cpp`, `python` ανά ώθηση | αμετάβλητο — Ρυθμίσεις → Ασφάλεια κώδικα. `c-cpp`/`python` δεν σαρώνει τίποτα εδώ |
|
||||
|
||||
Το `tests/unit/build/push-storm-diet.test.ts` κατοχυρώνει την ενεργοποίηση μέσω push μόνο για το `main` των `ci.yml` και
|
||||
`quality.yml`. Παρενέργεια: το Codecov δεν λαμβάνει πλέον μεταφόρτωση βάσης ανά push έκδοσης (το
|
||||
βήμα είναι ενημερωτικό και χρησιμοποιεί `continue-on-error`)· η πύλη κάλυψης εντός του αποθετηρίου και το σχόλιο στο PR
|
||||
δεν επηρεάζονται.
|
||||
`tests/unit/build/push-storm-diet.test.ts` καρφώνει τη σκανδάλη ώθησης `main` -only των `ci.yml` και `quality.yml`. Παρενέργεια: Το Codecov δεν λαμβάνει πλέον βασική μεταφόρτωση ανά ώθηση απελευθέρωσης (το βήμα είναι ενημερωτικό και `continue-on-error`). η πύλη κάλυψης σε repo και το σχόλιο PR δεν επηρεάζονται.
|
||||
|
||||
**Η επιπλέον αυτοφιλοξενούμενη χωρητικότητα δεν διορθώνει την ουρά φιλοξενούμενων εργασιών.** Το devbox
|
||||
(`devbox-vm-06-dev002`, 24 vCPU / 54 GB) θα μπορούσε να φιλοξενήσει έναν runner, αλλά οι συνεδρίες των agent διατηρούν ήδη
|
||||
το φορτίο του στο 20–26, το container του agent δεν διαθέτει δαίμονα Docker και ο κορεσμένος δίαυλος είναι
|
||||
ο φιλοξενούμενος. Το μηχάνημα `.113` είχε 71 GB ελεύθερα και φορτίο 5–8 την ίδια στιγμή· ο περιορισμός του
|
||||
είναι ο παραπάνω προϋπολογισμός μνήμης ανά listener (ανώτατο όριο 6 listeners), όχι η CPU. Οι εναπομείναντες μοχλοί
|
||||
αφορούν τις διαδικασίες: ενσωματώστε τα PR της εκστρατείας μέσω της ουράς του Mergify (`label=queue`, τα batches μοιράζονται
|
||||
μία εκτέλεση CI `merge_group` αντί για μία εκτέλεση ανά PR συν μία ανά push), περιορίστε τις γλώσσες της
|
||||
προεπιλεγμένης ρύθμισης του CodeQL και φιλτράρετε το `release-acceptance.yml` βάσει των αρχείων που διαβάζει.
|
||||
**Η μεγαλύτερη χωρητικότητα αυτο-φιλοξενίας δεν διορθώνει τη φιλοξενούμενη ουρά.** Το devbox (`devbox-vm-06-dev002`, 24 vCPU / 54 GB) θα μπορούσε να φιλοξενήσει έναν δρομέα, αλλά οι περίοδοι σύνδεσης agent διατηρούν ήδη το φορτίο του στα 20–26, το κοντέινερ πράκτορα δεν έχει δαίμονα Docker και η κορεσμένη λωρίδα είναι η φιλοξενούμενη. Το κουτί `.113` είχε 71 GB ελεύθερο και φορτώθηκε 5–8 την ίδια στιγμή. Ο περιορισμός του είναι ο παραπάνω προϋπολογισμός μνήμης ανά ακροατή (ανώτατο όριο 6 ακροατές), όχι CPU. Οι υπόλοιποι μοχλοί είναι αυτοί της διαδικασίας: προσγειώστε την καμπάνια PRs μέσω της ουράς Mergify (`label=queue`, παρτίδες μοιράζονται μία εκτέλεση `merge_group` CI αντί για μία εκτέλεση ανά PR συν μία ανά ώθηση), περικόψτε τις γλώσσες προεπιλεγμένης ρύθμισης CodeQL και φιλτράρετε `release-acceptance.yml` με τα αρχεία που διαβάζει.
|
||||
|
||||
> **2026-11-19: η ουρά συγχώνευσης Mergify αποσύρεται** (απόφαση ιδιοκτήτη). `.mergify.yml` δεν ορίζει πλέον μια ουρά και απορρίπτει τις εντολές Mergify που συγχωνεύουν ή ξαναγράφουν ένα αίτημα έλξης. Η κυκλοφορία PRs συγχωνεύεται με το χέρι κάτω από το σύνολο κανόνων αποθετηρίου "Απαιτούνται πράσινες πύλες στην ενεργή κυκλοφορία" (`Gate / CI` + `Gate / Quality`) μέχρι να εκτελεστεί η omni-queue σε ζωντανή λειτουργία και μετά από αυτήν μέσω της omni-queue ( [OMNI_QUEUE.md](./OMNI_QUEUE.md) ). Ο μοχλός Mergify παραπάνω δεν υπάρχει πλέον.
|
||||
|
||||
@@ -29,6 +29,8 @@ Cada recibo JSON identifica el SHA retirado, la ejecución del flujo de trabajo
|
||||
|
||||
### Fusionar cola
|
||||
|
||||
> **2026-11-19: se retira la cola de combinación Mergify** (decisión del propietario). `.mergify.yml` ya no define una cola y rechaza los comandos Mergify que fusionan o reescriben una solicitud de extracción. Las versiones PRs se fusionan manualmente bajo el conjunto de reglas del repositorio "Requerir puertas verdes en la versión activa" (`Gate / CI` + `Gate / Quality`) hasta que omni-queue se ejecuta en modo en vivo, y luego a través de omni-queue ( [OMNI_QUEUE.md](../ops/OMNI_QUEUE.md) ). El manejo del flujo de trabajo de los borradores de Mergify que se describe a continuación todavía está en `ci.yml` y `quality.yml`, pero ya no se abre ningún borrador de Mergify.
|
||||
|
||||
La etiqueta `queue` envía un PR a la cola Mergify (`.mergify.yml`). Mergify abre un borrador PR en una rama `mergify/merge-queue/`, CI ejecuta la selección completa allí y el PR original se fusiona cuando pasan `Gate / CI`, `Gate / Quality` y `Merge integrity (changelog + generated skills)`.
|
||||
|
||||
Mergify escribe el resumen de su cola en la descripción del borrador y otras aplicaciones también pueden editarlo. Un evento `pull_request` `edited` en dicho borrador toma su propio grupo de concurrencia (`-queue-edit-<run_id>`), por lo que no puede cancelar la ejecución real del borrador y omite la puerta y la matriz. Sólo `Merge integrity` todavía se ejecuta. El trabajo de puerta omitido lleva un nombre de verificación diferente, porque Mergify lee un `Gate / CI` omitido como una verificación fallida y retira el PR la cola.
|
||||
@@ -47,7 +49,7 @@ El inventario versionado de npm-alias y la membresía de escaneo estático se en
|
||||
|
||||
Utilice `npm run quality:scan -- --list` o `npm run quality:scan:fast -- --list` para inspeccionar los alias seleccionados sin ejecutarlos. El ejecutor invoca el punto de entrada npm, por lo que se conserva su tiempo de ejecución (incluido Bun cuando esté configurado). El manifiesto registra alias fuera de esos perfiles como invocados por separado, y los comandos de mantenimiento están prohibidos en perfiles de análisis de solo lectura.
|
||||
|
||||
Estos perfiles cubren únicamente el análisis estático. No certifican pruebas de producto, cobertura, embalaje, controles externos ni la aceptación total de la liberación de un candidato. La admisión del flujo de trabajo utiliza `config/quality/admission-policy.json` y `scripts/quality/admission-verdict.mjs` vinculados. Los perfiles de observadores de liberaciones permanecen separados; inspeccionar sus cheques y recibos aplicables de forma independiente. Los comandos estáticos completos del observador se declaran en `config/quality/release-green-static-profile.json`, incluidos `audit:deps`, selección de prueba de mutación y comprobaciones de traducción. El cargador valida los comandos npm contra package.json y declaraciones CI/Quality modeladas; rechaza la deriva en lugar de ejecutar tokens de shell como argumentos. La salida SKIP/INCOMPLETE del escáner requerida no puede establecer PASS. El perfil registra sus exclusiones externas y no reemplaza la cobertura alojada, las matrices de prueba, el paquete ni la evidencia de implementación. El inventario en prosa que aparece a continuación es una referencia, no una prueba de que realmente existiera una puerta.
|
||||
Estos perfiles cubren únicamente el análisis estático. No certifican pruebas de producto, cobertura, embalaje, controles externos ni la aceptación total de la liberación de un candidato. La admisión del flujo de trabajo utiliza `config/quality/admission-policy.json` y `scripts/quality/admission-verdict.mjs` vinculados. Los perfiles de observadores de liberaciones permanecen separados; inspeccionar sus cheques y recibos aplicables de forma independiente. Los comandos estáticos completos del observador se declaran en `config/quality/release-green-static-profile.json`, incluidos `audit:deps`, selección de prueba de mutación y comprobaciones de traducción. El cargador valida los comandos npm contra package.json y declaraciones CI/Quality modeladas; rechaza la deriva en lugar de ejecutar tokens de shell como argumentos. La salida SKIP/INCOMPLETE del escáner requerida no puede establecer PASS. El perfil registra sus exclusiones externas y no reemplaza la cobertura alojada, las matrices de prueba, el paquete o la evidencia de implementación. El inventario en prosa que aparece a continuación es una referencia, no una prueba de que realmente existiera una puerta.
|
||||
|
||||
Los scripts viven bajo `scripts/check/` (puertas de políticas) y `scripts/quality/` (motor de trinquete). La fuente de verdad de CI es `.github/workflows/ci.yml`.
|
||||
|
||||
@@ -78,7 +80,7 @@ Se ejecuta en cada PR a `main`. Los bloques se fusionan en caso de falla.
|
||||
| `check:cycles` | Importaciones circulares en todo `src/` + `open-sse/` (basado en AST, tsconfig `paths` resuelto). Bare sale de 1 cada vez que existe algún ciclo (cerrado por falla desde #15281) y enumera el SCCs. `check:cycles:ratchet` (lo que ejecuta CI ) se bloquea cuando el recuento excede el techo `metrics.cycles` en `quality-baseline.json` — actualmente 14, `direction: down`, por lo que solo puede caer (#15159 G-01/G-02). | Sí (trinquete) |
|
||||
| `check:boundary` | Acoplamiento `open-sse → src` : importaciones únicas de archivo a archivo desde el motor a la aplicación (`scripts/quality/measure-boundary.mjs`; la lista de bordes es el trabajo pendiente de corrección core/module-split v4). Informe de asesoramiento = desnudo (igual que `quality:boundary`). `check:boundary:ratchet` (lo que ejecuta CI, también en el bucle de trinquete de puertas rápidas `quality.yml` ) se bloquea cuando el recuento excede el techo `metrics.boundaryOpenSseToSrc` en `quality-baseline.json` — sembrado en el 771 medido, `direction: down`; `--update` sólo lo reduce; relativa a la base en PRs (`--base-ref`, ver más abajo) | Sí (trinquete) |
|
||||
| `check:route-validation:t06` | Esquemas Zod presentes en todas las rutas (política de nivel 6) | Sí |
|
||||
| `check:any-budget:t11` | El recuento `@ts-expect-error // any` no supera el presupuesto (cateraca de nivel 11) | Sí |
|
||||
| `check:any-budget:t11` | El recuento `@ts-expect-error // any` no excede el presupuesto (cateraca de nivel 11) | Sí |
|
||||
| `check:provider-consistency` | Cada proveedor en `providers.ts` tiene una entrada coincidente en `providerRegistry.ts` (y viceversa, dentro de la lista de permitidos) | Sí |
|
||||
| `check:model-lifecycle` | Las tres tablas de enrutamiento mantenidas manualmente se mantienen consistentes con la instantánea del ciclo de vida registrada (#11503): `FITNESS_TABLE` (`taskFitness.ts`) no obtiene ninguna identificación retirada que `REGISTRY` pueda enrutar; cada objetivo `BUILT_IN_ALIASES` está presente en `REGISTRY` y ausente en la instantánea de identificación retirada; cada identificación retirada que aún esté en `REGISTRY` se reenvía o se enumera en `allowedRetiredInCatalog`; y ninguna fuente o destino `DEFAULT_DEGRADATION_MAP` aparece retirado en esa instantánea. Esto no prueba que un modelo cuente actualmente con un flujo ascendente en vivo. — sin conexión se compara con `config/quality/model-lifecycle.json`, actualizado manualmente con `npm run quality:refresh-model-lifecycle` (red; no conectado a CI). `allowedRetiredInCatalog` es un trinquete quemado: agregue una entrada solo con un problema de seguimiento. | Sí |
|
||||
| `check:fetch-targets` | Cada `fetch("/api/...")` en `src/` del lado del cliente se resuelve en un `route.ts` real | Sí |
|
||||
@@ -112,7 +114,7 @@ Se ejecuta en cada PR a `main`. Los bloques se fusionan en caso de falla.
|
||||
|
||||
`tsconfig.build.json` establece `"strict": false`, por lo que `noImplicitAny` está desactivado. La configuración principal compila una lista de permitidos seleccionada de 27 archivos con opciones más estrictas y sigue el gráfico de importación de cada entrada, por lo que los archivos que nunca aparecen en el programa de compilación aún se verifican allí.
|
||||
|
||||
La consecuencia es importante al juzgar si se escribe un archivo:** diagnóstico cero bajo `check:build-typecheck` no significa cero** . Al eliminar `@ts-nocheck` de 26 archivos, 23 de ellos estaban limpios en el programa de compilación; dieciséis de ellos arrojaron alrededor de 120 errores implícitos (cualquier error en el estricto). Verifique ambos antes de limpiar un archivo.
|
||||
La consecuencia es importante al juzgar si se escribe un archivo:** diagnóstico cero bajo `check:build-typecheck` no significa cero** . Al eliminar `@ts-nocheck` de 26 archivos, 23 de ellos estaban limpios en el programa de compilación; dieciséis de ellos arrojaron alrededor de 120 errores implícitos (cualquiera en el estricto). Verifique ambos antes de limpiar un archivo.
|
||||
|
||||
### Trabajo: `quality-gate`
|
||||
|
||||
@@ -249,7 +251,7 @@ Las pruebas unitarias de paridad local (`cli-i18n-catalog`, `i18n-pt-br`, `i18n-
|
||||
|
||||
Capta la regresión i18n que las otras puertas estructuralmente no pueden ver: se reescribe un valor en inglés y las traducciones derivadas del inglés _anterior_ se quedan atrás, por lo que los usuarios que no hablan inglés siguen leyendo una copia redactada con confianza y ahora incorrecta.
|
||||
|
||||
Esto se envió de verdad. `oauthModal.googleOAuthWarning` fue reescrito cuando aterrizó el asistente de inicio de sesión de Antigravity (#5203);** 39 de 43 locales** mantuvo el texto que decía a los operadores que "copiaran el URL completo y lo pegaran debajo" — un flujo que no se puede completar para ese proveedor. Pasó desapercibido hasta #8463 porque:
|
||||
Esto se envió de verdad. `oauthModal.googleOAuthWarning` se reescribió cuando llegó el asistente de inicio de sesión Antigravity (#5203);** 39 de 43 locales** Se mantuvo el texto que indicaba a los operadores "copiar el URL completo y pegarlo debajo" — un flujo que no se puede completar para ese proveedor. Pasó desapercibido hasta #8463 porque:
|
||||
|
||||
- `sync-ui-keys` solo rellena las claves que están** ausente** , nunca los que son** duro** ;
|
||||
- `check-ui-keys-coverage` cuenta la _presencia_ clave, por lo que una traducción obsoleta se considera cubierta;
|
||||
|
||||
@@ -4,14 +4,9 @@
|
||||
|
||||
---
|
||||
|
||||
OmniRoute utiliza un modelo de lanzamientos de **ciclos paralelos**: una rama
|
||||
dedicada `release/vX.Y.Z` para el ciclo activo, `main` para la línea publicada y
|
||||
una etiqueta inmutable `vX.Y.Z` cuando se publica ese ciclo. Es normal ver que los
|
||||
commits lleguen tanto a `release/*` _como_ a `main`; no se trata de una confusión.
|
||||
OmniRoute usa un** ciclo paralelo** modelo de lanzamiento: una rama `release/vX.Y.Z` dedicada para el ciclo activo, `main` para la línea publicada y una etiqueta `vX.Y.Z` inmutable cuando se envía ese ciclo. Ver que las confirmaciones aterrizan en `release/*` _y_ en `main` se espera que — no sea una confusión.
|
||||
|
||||
Los detalles para los mantenedores se encuentran en `CLAUDE.md` (Regla estricta
|
||||
n.º 21) y [RELEASE_CHECKLIST.md](./RELEASE_CHECKLIST.md). Esta página es el
|
||||
resumen público dirigido a los colaboradores.
|
||||
Los detalles del mantenedor se encuentran en `CLAUDE.md` (regla estricta #21) y [RELEASE_CHECKLIST.md](./RELEASE_CHECKLIST.md). Esta página es el resumen público para los contribuyentes.
|
||||
|
||||
## De un vistazo
|
||||
|
||||
@@ -42,27 +37,23 @@ flowchart LR
|
||||
`main` no es la rama de integración diaria. Por lo general, los PR abiertos
|
||||
contra `main` deben redirigirse antes de integrarlos.
|
||||
|
||||
## Congelación de lanzamiento (ciclos paralelos)
|
||||
## Liberar congelación (ciclos paralelos)
|
||||
|
||||
Cuando se está conciliando un lanzamiento, se abre una incidencia marcadora con
|
||||
la etiqueta `release-freeze`. Esto **no detiene el desarrollo**:
|
||||
Cuando se concilia una versión, se abre una emisión de marcador denominada `release-freeze`. Eso** no detiene el desarrollo** :
|
||||
|
||||
- La rama congelada `release/vX.Y.Z` queda a cargo del responsable de ese
|
||||
lanzamiento.
|
||||
- El siguiente ciclo, `release/vX+1`, se crea desde la punta congelada para que
|
||||
los colaboradores puedan seguir integrando trabajo.
|
||||
- Los PR abiertos que aún apunten a la rama congelada deben **redirigirse** a la
|
||||
rama `release/v*` activa (la de versión más alta).
|
||||
- El `release/vX.Y.Z` congelado pertenece al capitán liberado de ese barco.
|
||||
- El `release/vX+1` del siguiente ciclo se corta de la punta congelada para que los contribuyentes sigan trabajando.
|
||||
- Abrir PRs que todavía apunta a la rama congelada debe ser** reorientado** a la rama `release/v*` activa (más alta).
|
||||
|
||||
Comprueba si hay una congelación abierta antes de asumir que la rama que deseas
|
||||
se puede integrar:
|
||||
Verifique si hay una congelación abierta antes de asumir que la rama que desea se puede fusionar:
|
||||
|
||||
```bash
|
||||
gh issue list --repo diegosouzapw/OmniRoute --label release-freeze --state open
|
||||
```
|
||||
|
||||
Los mecanismos de integración (etiqueta `queue` del propietario → Mergify) están
|
||||
documentados en [MERGE_TRAIN.md](./MERGE_TRAIN.md).
|
||||
La mecánica de fusión (propietario `queue` etiqueta → Mergify) está documentada en [MERGE_TRAIN.md](./MERGE_TRAIN.md).
|
||||
|
||||
> **2026-11-19: se retira la cola de combinación Mergify** (decisión del propietario). `.mergify.yml` ya no define una cola y rechaza los comandos Mergify que fusionan o reescriben una solicitud de extracción. Las versiones PRs se fusionan manualmente bajo el conjunto de reglas del repositorio "Requerir puertas verdes en la versión activa" (`Gate / CI` + `Gate / Quality`) hasta que omni-queue se ejecuta en modo en vivo, y luego a través de omni-queue ( [OMNI_QUEUE.md](./OMNI_QUEUE.md) ). La etiqueta `queue` ya no fusiona nada.
|
||||
|
||||
## ¿Por qué se usan tanto una rama como una etiqueta?
|
||||
|
||||
|
||||
@@ -4,10 +4,9 @@
|
||||
|
||||
---
|
||||
|
||||
Desde v3.8.49 (WS3.2/WS3.4 del plan de calidad/velocidad), la ruta de fusión predeterminada para
|
||||
los PR revisados hacia `release/vX.Y.Z` es la **cola de fusión de Mergify** (`.mergify.yml`);
|
||||
el **tren de fusiones manual** documentado a continuación es la ALTERNATIVA, utilizada durante incidentes,
|
||||
congelaciones de versiones o si el plan Open Source de Mergify llegara a cambiar.
|
||||
> **2026-11-19: se retira la cola de combinación Mergify** (decisión del propietario). `.mergify.yml` ya no define una cola y rechaza los comandos Mergify que fusionan o reescriben una solicitud de extracción. Las versiones PRs se fusionan manualmente bajo el conjunto de reglas del repositorio "Requerir puertas verdes en la versión activa" (`Gate / CI` + `Gate / Quality`) hasta que omni-queue se ejecuta en modo en vivo, y luego a través de omni-queue ( [OMNI_QUEUE.md](./OMNI_QUEUE.md) ). Las secciones de Mergify a continuación describen la cola tal como estaba.
|
||||
|
||||
Desde v3.8.49 (WS3.2/WS3.4 del plan quality/velocity ), la ruta de fusión predeterminada para PRs revisado en `release/vX.Y.Z` es la** Fusionar cola de fusión** (`.mergify.yml`); el** tren de fusión manual** A continuación se documenta el FALLBACK — utilizado durante incidentes, congelaciones de versiones o si el plan Mergify Open Source cambia alguna vez.
|
||||
|
||||
## Ruta predeterminada: la cola de Mergify
|
||||
|
||||
|
||||
@@ -355,111 +355,70 @@ Antes de publicar cualquier versión v3.8.x, verifica también estos elementos:
|
||||
|
||||
---
|
||||
|
||||
## Corte LTS 3.9.0 (ensayado en 3.8.58)
|
||||
## 3.9.0 corte LTS (ensayado en 3.8.58)
|
||||
|
||||
Después de v3.8.59, la siguiente versión es 3.9.0, y su punta se convierte en dos ramas de larga duración:
|
||||
`stable/v3` (la línea LTS de v3, npm `latest`) y `develop` (v4, actualizada a 4.0.0, npm
|
||||
`nightly`). El modelo de ramas/canales, el forward-port y las etiquetas están en
|
||||
[RELEASE_STRATEGY.md](./RELEASE_STRATEGY.md); el plan está en el [ROADMAP](../../ROADMAP.md) (Fase 3). El corte se ejecuta una sola vez;
|
||||
3.8.58 lo ensaya de principio a fin en un fork, y 3.8.59 finaliza con la
|
||||
[lista de comprobación GO/NO-GO](./LTS_GO_NO_GO.md).
|
||||
Después de v3.8.59, la siguiente versión es 3.9.0, y su punta se convierte en dos ramas de larga duración: `stable/v3` (la línea v3 LTS, npm `latest`) y `develop` (v4, mejorada a 4.0.0, npm `nightly`). El modelo branch/channel, el puerto directo y las etiquetas están en [RELEASE_STRATEGY.md](./RELEASE_STRATEGY.md) ; el plan está en la [ROADMAP](../../ROADMAP.md) (Fase 3). El corte se ejecuta una vez; 3.8.58 lo ensaya de punta a punta en una bifurcación, y 3.8.59 cierra con la [lista de verificación GO/NO-GO](./LTS_GO_NO_GO.md).
|
||||
|
||||
### Simulación (solo lectura, segura en cualquier momento)
|
||||
### Ejecución en seco (solo lectura, seguro en cualquier momento)
|
||||
|
||||
```bash
|
||||
npm run release:dry-run-lts-cut # el corte real: 3.9.0 desde HEAD, etiqueta anterior v3.8.59
|
||||
npm run release:dry-run-lts-cut -- --from <3.9.0-tip> # fija el commit de origen
|
||||
npm run release:dry-run-lts-cut # the real cut: 3.9.0 from HEAD, previous tag v3.8.59
|
||||
npm run release:dry-run-lts-cut -- --from <3.9.0-tip> # pin the source commit
|
||||
```
|
||||
|
||||
`scripts/release/dry-run-lts-cut.mjs` no ejecuta nada: lee git y `gh` e imprime la
|
||||
secuencia completa: condiciones previas (el origen se resuelve, el repositorio de origen tiene el historial completo;
|
||||
un clon superficial no puede enviar `stable/v3`, el lado receptor rechaza el paquete en el primer
|
||||
padre injertado, por lo que primero debe realizarse el corte desde un clon completo o ejecutar `git fetch --unshallow origin`;
|
||||
la etiqueta anterior existe, `package.json` tiene la versión de destino, hay una incidencia `release-freeze` abierta, no hay
|
||||
ninguna incidencia `Release branch not green` abierta
|
||||
en una rama de publicación existente; una rama que no existe informa `?` como desconocido, nunca
|
||||
como correcto; la cola `release` de Mergify está configurada (G11: `queue_rules`, `checks_timeout`,
|
||||
etiqueta `queue`), el conjunto de reglas `release/*` sigue bloqueando la eliminación y el envío forzado, y
|
||||
`stable/v3` y `develop` aún no existen), los dos pasos de creación de ramas, qué activadores de flujos de trabajo
|
||||
inactivos y qué condiciones `if:` pasan a ser verdaderas (y cuáles siguen bloqueadas por una variable del repositorio o
|
||||
fijadas al repositorio canónico), las dist-tags esperadas (`latest` → 3.9.0, `next` y
|
||||
`nightly` vacías) y la reversión. Código de salida `0` = `RESULT: READY`, `1` = una condición previa bloqueante
|
||||
ha fallado (`✗`), `2` = error de uso. `--advisory <id,...>` rebaja una comprobación a advertencia (`!`)
|
||||
sin ocultarla.
|
||||
`scripts/release/dry-run-lts-cut.mjs` no ejecuta nada: lee git y `gh` e imprime la secuencia completa de condiciones previas — (el origen se resuelve, el repositorio de origen tiene un historial completo — un clon superficial no puede enviar `stable/v3`, el lado receptor rechaza el paquete en el primer padre injertado, por lo que se corta de un clon completo o `git fetch --unshallow origin`, existe la primera etiqueta anterior —, `package.json` es la versión de destino, hay un problema `release-freeze` abierto, no hay un problema `Release branch not green` abierto en una rama de lanzamiento existente — una rama que no existe informa `?` desconocido, nunca está verde — omni-queue obtiene el lanzamiento PRs (G11: `config/merge-queue/config.json` válido, su `bases` administra la rama de lanzamiento, `mode` `live`, su etiqueta existe), el conjunto de reglas `release/*` aún bloquea la eliminación y el push-push, y `stable/v3` y `develop` aún no existen), los dos pasos de la rama, que desencadenan el flujo de trabajo inactivo y las condiciones `if:` se vuelven verdaderas (y que permanecen cerradas por un variable del repositorio o anclada al repositorio canónico), las etiquetas dist esperadas (`latest` → 3.9.0, `next` y `nightly` vacías) y la reversión. Salga `0` = `RESULT: READY`, `1` = falló una condición previa de bloqueo (`✗`), error de uso `2` =. `--advisory <id,...>` degrada una verificación a una advertencia (`!`) sin ocultarla.
|
||||
|
||||
Ejecute la simulación del corte real mientras el bloqueo de publicación de 3.9.0 siga abierto; las ramas se
|
||||
crean después de la etiqueta y antes de que la Fase 12c levante el bloqueo.
|
||||
Ejecute el ensayo del corte real mientras la congelación de la versión 3.9.0 aún esté abierta — las ramas se crean después de la etiqueta y antes de que la Fase 12c levante la congelación.
|
||||
|
||||
### Ensayo de 3.8.58 (solo en un fork)
|
||||
### 3.8.58 ensayo (solo tenedor)
|
||||
|
||||
```bash
|
||||
# 1. Simulación en la punta actual con parámetros de ensayo
|
||||
# 1. Dry-run on the current tip with rehearsal parameters
|
||||
npm run release:dry-run-lts-cut -- --target-version 3.8.58 --previous-tag v3.8.57 \
|
||||
--advisory freeze,base-green
|
||||
|
||||
# 2. Ejecutar contra un remoto de un FORK (se rechaza origin, o cualquier remoto cuya URL
|
||||
# sea la del repositorio canónico; cada paso solicita confirmación en la terminal)
|
||||
# 2. Execute against a FORK remote (origin, or any remote whose URL is the canonical
|
||||
# repository, is refused; every step asks for confirmation on the terminal)
|
||||
git remote add rehearsal https://github.com/<you>/OmniRoute.git
|
||||
node scripts/release/dry-run-lts-cut.mjs --execute --remote rehearsal \
|
||||
--target-version 3.8.58 --previous-tag v3.8.57 --advisory freeze,base-green
|
||||
|
||||
# 3. Probar los flujos de trabajo inactivos en el fork (workflow_dispatch cuando la simulación
|
||||
# informa de una fijación al repositorio canónico) y, después, revertir
|
||||
# 3. Exercise the dormant workflows in the fork (workflow_dispatch where the dry-run
|
||||
# reports a canonical-repository pin), then roll back
|
||||
node scripts/release/dry-run-lts-cut.mjs --execute --rollback --remote rehearsal \
|
||||
--target-version 3.8.58 --previous-tag v3.8.57 --advisory freeze,base-green
|
||||
```
|
||||
|
||||
El commit de actualización de develop se construye mediante las operaciones internas de git (sin modificar el árbol de trabajo) y actualiza
|
||||
los mismos cinco archivos que un commit de apertura de ciclo: `package.json`, `open-sse/package.json`,
|
||||
`electron/package.json`, `package-lock.json` y `docs/openapi.yaml`. La sección `[4.0.0]` del
|
||||
CHANGELOG y sus equivalentes i18n se abren posteriormente en `develop`, antes de su primer
|
||||
PR. El script nunca cambia las dist-tags de npm; ensáyelas en un paquete de prueba.
|
||||
La confirmación de desarrollo se construye con git plumbing (no se toca ningún árbol de trabajo) y actualiza los mismos cinco archivos que una confirmación de apertura de ciclo: `package.json`, `open-sse/package.json`, `electron/package.json`, `package-lock.json` y `docs/openapi.yaml`. La sección `[4.0.0]` CHANGELOG y sus espejos i18n se abren en `develop` después, antes de su primer PR. El script nunca cambia las etiquetas npm dist-tags — ensayadas en un paquete borrador.
|
||||
|
||||
### Artefacto de vista previa del PR (compilar una vez, promover exactamente los mismos bytes)
|
||||
### Artefacto de vista previa PR (compila una vez, promueve los mismos bytes)
|
||||
|
||||
`.github/workflows/preview-artifact.yml` compila un único tarball de producción desde la cabecera de un PR y
|
||||
valida exactamente esa compilación (parte (a) de #8084). Solo para PR del mismo repositorio; no se publica nada.
|
||||
`.github/workflows/preview-artifact.yml` construye un tarball de producción a partir de un encabezado PR y valida esa compilación exacta (#8084 slice (a)). Solo PRs en el mismo repositorio; no se publica nada.
|
||||
|
||||
```bash
|
||||
gh workflow run preview-artifact.yml -f pr_number=<N> # o añada la etiqueta `preview-artifact`
|
||||
gh workflow run preview-artifact.yml -f pr_number=<N> # or add the `preview-artifact` label
|
||||
gh run download <run-id> --name preview-artifact-pr<N>-<sha7> --dir preview
|
||||
cd preview && sha256sum -c SHA256SUMS
|
||||
gh attestation verify omniroute-*.tgz --repo diegosouzapw/OmniRoute
|
||||
npm install -g ./omniroute-*.tgz # instalación de vista previa
|
||||
npm install -g ./omniroute-*.tgz # preview install
|
||||
```
|
||||
|
||||
La ejecución realiza `npm ci`, `npm run build:release`, `npm run check:pack-artifact`, empaqueta el
|
||||
tarball, ejecuta `npm run check:pack-boot` (secretos falsos, directorio de datos efímero), vuelve a empaquetarlo y
|
||||
falla a menos que el resumen sea idéntico; después, registra `artifact-identity.json` (SHA de la cabecera, SHA de la base,
|
||||
hash del lockfile, plataforma, arquitectura, ABI de node, empaquetador, política de compilación;
|
||||
`scripts/release/artifact-identity.mjs`) y certifica el tarball en un trabajo separado. Promover
|
||||
una vista previa significa instalar ese tarball: nunca vuelva a compilar desde el código fuente.
|
||||
La ejecución hace `npm ci`, `npm run build:release`, `npm run check:pack-artifact`, empaqueta el tarball, ejecuta `npm run check:pack-boot` (secretos falsos, directorio de datos efímeros), vuelve a empaquetar y falla a menos que el resumen sea idéntico, luego registra `artifact-identity.json` (head SHA, base SHA, lockfile hash, plataforma, arch, nodo ABI, paquete, política de compilación — `scripts/release/artifact-identity.mjs`) y certifica el tarball en un trabajo separado. Promocionar una vista previa significa instalar ese tarball: nunca reconstruir desde la fuente.
|
||||
|
||||
### El corte (3.9.0, después de GO)
|
||||
|
||||
1. GO registrado en [LTS_GO_NO_GO.md](./LTS_GO_NO_GO.md).
|
||||
1. GO grabado en [LTS_GO_NO_GO.md](./LTS_GO_NO_GO.md).
|
||||
2. `npm run release:dry-run-lts-cut -- --from v3.9.0` imprime `RESULT: READY`.
|
||||
3. Cree manualmente las ramas en `origin` con los comandos que imprime la simulación; el
|
||||
script se niega a enviar a `origin`. Para reutilizar un commit de develop revisado, ejecute primero el
|
||||
ensayo con `--execute` en la punta de 3.9.0 contra su fork; este imprime ambos SHA, y
|
||||
pueden enviarse los mismos commits:
|
||||
3. Cree las ramas en `origin` a mano con los comandos que el ensayo imprime — el script se niega a enviar a `origin`. Para reutilizar una confirmación de desarrollo revisada, primero ejecute el ensayo `--execute` en el consejo 3.9.0 contra su bifurcación; imprime ambos SHAs y se pueden enviar las mismas confirmaciones:
|
||||
|
||||
```bash
|
||||
git push origin <stable-sha>:refs/heads/stable/v3 <develop-sha>:refs/heads/develop
|
||||
```
|
||||
|
||||
4. Protege `stable/v3` y `develop` (conjuntos de reglas + cola de fusión) antes de que llegue el primer PR.
|
||||
5. Los flujos de trabajo inactivos se activan al existir las ramas: `forward-port.yml` (push a
|
||||
`stable/v3`), `validate-stable-pr.yml` (PRs dirigidos a `stable/v3`) y `nightly-v4-build.yml`
|
||||
(compila `develop`). Antes de la puesta en producción, configura el secreto del repositorio `secrets.FORWARD_PORT_TOKEN` (para que CI se ejecute en
|
||||
los PRs de forward-port); la publicación nocturna permanece desactivada hasta que el propietario establezca la variable del repositorio
|
||||
`vars.NIGHTLY_PUBLISH` en `true` y npm Trusted Publishing acepte
|
||||
`nightly-v4-build.yml`. La resolución de canales se realiza en `scripts/release/dist-tag.mjs`, el mismo
|
||||
solucionador que utiliza `npm-publish.yml`.
|
||||
6. Verifica los canales: `npm view omniroute dist-tags --json` muestra `latest` = 3.9.0 y ningún
|
||||
`next` / `nightly` hasta que se publique v4.
|
||||
7. Reversión, si es necesario: `git push origin --delete refs/heads/stable/v3 refs/heads/develop`
|
||||
y `npm dist-tag add omniroute@3.8.59 latest`.
|
||||
4. Proteja `stable/v3` y `develop` (cola de fusión de conjuntos de reglas + ) antes de que llegue el primer PR.
|
||||
5. Los flujos de trabajo inactivos se activan según la existencia de una rama: `forward-port.yml` (empujar a `stable/v3`), `validate-stable-pr.yml` (PRs a `stable/v3`) y `nightly-v4-build.yml` (compila `develop`). Antes de entrar en funcionamiento, establezca el secreto del repositorio `secrets.FORWARD_PORT_TOKEN` (para que CI se ejecute en el puerto directo PRs); La publicación nocturna permanece desactivada hasta que el propietario establece la variable del repositorio `vars.NIGHTLY_PUBLISH` en `true` y npm Trusted Publishing acepta `nightly-v4-build.yml`. La resolución del canal es `scripts/release/dist-tag.mjs`, el mismo solucionador que utiliza `npm-publish.yml`.
|
||||
6. Verifique los canales: `npm view omniroute dist-tags --json` muestra `latest` = 3.9.0 y no `next` / `nightly` hasta que se publique la versión 4.
|
||||
7. Revertir, si es necesario: `git push origin --delete refs/heads/stable/v3 refs/heads/develop` y `npm dist-tag add omniroute@3.8.59 latest`.
|
||||
|
||||
---
|
||||
|
||||
|
||||
@@ -138,33 +138,22 @@ la vez, solo cuando esté inactivo**, con la comprobación de inactividad y el r
|
||||
minutos en guardarse en tmpfs y 2 minutos en subirse desde el disco.
|
||||
- El VPS `.15` es solo para homologación; nunca ejecuta runners de CI.
|
||||
|
||||
## Canal alojado (runners alojados en GitHub)
|
||||
## Carril alojado (corredores alojados en GitHub)
|
||||
|
||||
El repositorio pertenece a la organización `cheaper-inference`, en el plan **Team**: **60 trabajos alojados simultáneos**, compartidos por todos los repositorios de la organización, todas las comprobaciones de PR, todos los workflows activados por push y la configuración predeterminada de CodeQL. Las cifras siguientes se midieron en el plan **Pro** (40 trabajos alojados simultáneos). Medido el 2026-10-18 durante una
|
||||
campaña de fusiones (~10 fusiones/hora en `release/v3.8.52`): **2.500 ejecuciones de workflows creadas en
|
||||
24 h**, 44 pushes a la rama en 6 h, **106 trabajos alojados en cola** mientras las comprobaciones de PR esperaban durante
|
||||
horas y los PR se fusionaban sin ellas. Nueve workflows se activaban con cada push a la rama:
|
||||
El repositorio pertenece a la organización `cheaper-inference`, en el** Equipo** plan:** 60 trabajos alojados simultáneos** , compartido por cada repositorio de la organización, cada verificación PR, cada flujo de trabajo activado por inserción y la configuración predeterminada de CodeQL. Las siguientes cifras se midieron en el** Pro** plan (40 trabajos alojados simultáneos). Medido el 18 de octubre de 2026 durante una campaña de fusión (~ 10 merges/hour en `release/v3.8.52`):** 2500 ejecuciones de flujo de trabajo creadas en 24 h** , 44 empujones a la sucursal en 6 h,** 106 trabajos alojados en cola** mientras que los cheques PR esperaron durante horas y PRs se fusionaron sin ellos. Nueve flujos de trabajo se activaron en cada envío a la sucursal:
|
||||
|
||||
| por push a `release/v*` | trabajos alojados | resultado durante la saturación | desde 2026-10-18 |
|
||||
| -------------------------------------------------- | ----------------: | -------------------------------------------------------------- | ------------------------------------------------------------------------------------------ |
|
||||
| `ci.yml` (matriz completa) | hasta 30 | cancelado por el siguiente push, 24 de 24 en un día | no se inicia con pushes a `release/**` (ejecución de PR + Release-Green) |
|
||||
| `quality.yml` | ~6 | cancelado, 23 de 23 | no se inicia con pushes a `release/**` |
|
||||
| `Release-Green` `--quick` | 0 | se ejecutó en `omni-build`, 97 de 100 cancelados | ranura `omni-release`, nunca se cancela, la ejecución pendiente se agrupa |
|
||||
| `Lock released branch`, `OpenSSF Scorecard` | 2 | una ejecución en cola por push | una ejecución por ref (`tests/unit/build/hosted-lane-concurrency.test.ts`) |
|
||||
| `Release acceptance` (informe paralelo) | 1 | un `npm ci` alojado por push, nunca cancelado | sin cambios — candidato para un filtro `paths:` |
|
||||
| `Publish to Docker Hub` → `Deploy to VPS` | 2 | cancelado en cada push; la etapa amd64 compite en `omni-build` | sin cambios — canal de despliegue del propietario |
|
||||
| Configuración predeterminada de CodeQL (`dynamic`) | 4 | `javascript-typescript`, `actions`, `c-cpp`, `python` por push | sin cambios — Configuración → Seguridad del código; `c-cpp`/`python` no analizan nada aquí |
|
||||
| por impulso a `release/v*` | trabajos alojados | resultado bajo la tormenta | desde 2026-10-18 |
|
||||
| ----------------------------------------------- | ----------------: | ------------------------------------------------------------------- | -------------------------------------------------------------------------------------- |
|
||||
| `ci.yml` (matriz completa) | hasta 30 | cancelado por el siguiente empujón, 24 de 24 en un día | no iniciado en `release/**` push (PR run + Release-Green) |
|
||||
| `quality.yml` | ~6 | cancelado, 23 de 23 | no iniciado en `release/**` empuja |
|
||||
| `Release-Green` `--quick` | 0 | corrió en `omni-build`, canceló 97 de 100 | Ranura `omni-release`, nunca cancelada, pendiente de colapso de ejecución |
|
||||
| `Lock released branch`, `OpenSSF Scorecard` | 2 | una ejecución en cola por impulso | una carrera por árbitro (`tests/unit/build/hosted-lane-concurrency.test.ts`) |
|
||||
| `Release acceptance` (informe sombra) | 1 | un `npm ci` alojado por envío, nunca cancelado | candidato — sin cambios para un filtro `paths:` |
|
||||
| `Publish to Docker Hub` → `Deploy to VPS` | 2 | cancelado por empujón; La pierna amd64 compite en `omni-build` | Canal de implementación del propietario — sin cambios. |
|
||||
| Configuración predeterminada CodeQL (`dynamic`) | 4 | `javascript-typescript`, `actions`, `c-cpp`, `python` por pulsación | sin cambios — Configuración → Seguridad del código; `c-cpp`/`python` escanea nada aquí |
|
||||
|
||||
`tests/unit/build/push-storm-diet.test.ts` fija que el activador por push de `ci.yml` y
|
||||
`quality.yml` sea exclusivo de `main`. Efecto secundario: Codecov ya no recibe una carga base por cada push de release (el
|
||||
paso es informativo y usa `continue-on-error`); el control de cobertura dentro del repositorio y el comentario del PR no
|
||||
se ven afectados.
|
||||
`tests/unit/build/push-storm-diet.test.ts` fija el gatillo `main` -only de `ci.yml` y `quality.yml`. Efecto secundario: Codecov ya no recibe una carga base por lanzamiento de lanzamiento (el paso es informativo y `continue-on-error`); la puerta de cobertura en el repositorio y el comentario PR no se ven afectados.
|
||||
|
||||
**Más capacidad autoalojada no soluciona la cola alojada.** La máquina de desarrollo
|
||||
(`devbox-vm-06-dev002`, 24 vCPU / 54 GB) podría alojar un runner, pero las sesiones de los agentes ya
|
||||
mantienen su carga entre 20 y 26, el contenedor de los agentes no tiene un daemon de Docker y el canal saturado es
|
||||
el alojado. La máquina `.113` tenía 71 GB libres y una carga de 5–8 en ese mismo momento; su limitación
|
||||
es el presupuesto de memoria por listener indicado anteriormente (máximo de 6 listeners), no la CPU. Las opciones
|
||||
restantes son de proceso: integrar los PR de la campaña mediante la cola de Mergify (`label=queue`; los lotes comparten
|
||||
una ejecución de CI de `merge_group` en lugar de una ejecución por PR más otra por push), reducir los lenguajes de la
|
||||
configuración predeterminada de CodeQL y filtrar `release-acceptance.yml` según los archivos que lee.
|
||||
**Más capacidad autohospedada no soluciona la cola alojada.** El devbox (`devbox-vm-06-dev002`, 24 vCPU / 54 GB) podría albergar un ejecutor, pero las sesiones del agente ya mantienen su carga entre 20 y 26, el contenedor del agente no tiene un demonio Docker y el carril saturado es el alojado. La caja `.113` tenía 71 GB libres y cargaba entre 5 y 8 al mismo tiempo; su restricción es el presupuesto de memoria por oyente anterior (techo máximo de 6 oyentes), no CPU. Las palancas restantes son de proceso: realizar la campaña PRs a través de la cola Mergify (`label=queue`, los lotes comparten una ejecución `merge_group` CI en lugar de una ejecución por PR más una por inserción), recortar los idiomas de configuración predeterminada CodeQL y filtrar `release-acceptance.yml` por los archivos que lee.
|
||||
|
||||
> **2026-11-19: se retira la cola de combinación Mergify** (decisión del propietario). `.mergify.yml` ya no define una cola y rechaza los comandos Mergify que fusionan o reescriben una solicitud de extracción. Las versiones PRs se fusionan manualmente bajo el conjunto de reglas del repositorio "Requerir puertas verdes en la versión activa" (`Gate / CI` + `Gate / Quality`) hasta que omni-queue se ejecuta en modo en vivo, y luego a través de omni-queue ( [OMNI_QUEUE.md](./OMNI_QUEUE.md) ). La palanca Mergify de arriba ya no existe.
|
||||
|
||||
@@ -29,6 +29,8 @@ Iga JSON kviitung tuvastab väljamakstud SHA, töövoo käitamise ja katse. CLI
|
||||
|
||||
### Ühenda järjekord
|
||||
|
||||
> **2026-11-19: Mergify ühendamisjärjekord on lõpetatud** (omaniku otsus). `.mergify.yml` ei määratle enam järjekorda ja lükkab tagasi Mergify käsud, mis liidavad või kirjutavad ümber tõmbetaotluse. Tõmbetaotlused väljalaskeharule liidetakse käsitsi hoidla reeglistiku "Require green gates on the active release" (`Gate / CI` + `Gate / Quality`) alusel, kuni omni-queue töötab live-režiimis ja seejärel omni-queue kaudu ([OMNI_QUEUE.md](../ops/OMNI_QUEUE.md)). Allpool kirjeldatud Mergify mustandite töövoo käsitlemine on endiselt `ci.yml` ja `quality.yml`, kuid Mergify mustandit enam ei avata.
|
||||
|
||||
`queue` silt saadab PR ühendamisjärjekorda (`.mergify.yml`). Mergify avab `mergify/merge-queue/` -harus mustandi PR, CI käivitab seal täieliku valiku ja `Gate / CI`, `Gate / Quality` ja `Merge integrity (changelog + generated skills)` möödumisel liidetakse algne PR.
|
||||
|
||||
Mergify kirjutab oma järjekorra kokkuvõtte mustandi kirjeldusse ja ka teised rakendused saavad seda muuta. Sellise mustandi `pull_request` `edited` sündmus võtab oma samaaegsusrühma (`-queue-edit-<run_id>`), nii et see ei saa mustandi tegelikku käitamist tühistada ning jätab värava ja maatriksi vahele. Ainult `Merge integrity` töötab veel. Vahelejäetud värava töö kannab teistsugust kontrolli nime, kuna Mergify loeb vahele jäetud `Gate / CI` ebaõnnestunud kontrollina ja eemaldab PR.
|
||||
|
||||
@@ -4,9 +4,9 @@
|
||||
|
||||
---
|
||||
|
||||
OmniRoute kasutab **paralleeltsükli** väljalaskemudelit: aktiivse tsükli jaoks on eraldi haru `release/vX.Y.Z`, avaldatud versioonirea jaoks `main` ning tsükli väljalaskmisel muutumatu märgend `vX.Y.Z`. On ootuspärane, et commit'id jõuavad nii harudesse `release/*` _kui ka_ harusse `main` — see ei ole eksitus.
|
||||
OmniRoute kasutab a** paralleelne tsükkel** väljalaske mudel: spetsiaalne `release/vX.Y.Z` haru aktiivse tsükli jaoks, `main` avaldatud rea jaoks ja muutumatu `vX.Y.Z` silt selle tsükli tarnimisel. Kui näha, et toimingud langevad `release/*` _ja_ `main` siis eeldatakse, et — ei ole segadus.
|
||||
|
||||
Haldajatele mõeldud üksikasjad asuvad failis `CLAUDE.md` (range reegel nr 21) ja dokumendis [RELEASE_CHECKLIST.md](./RELEASE_CHECKLIST.md). See leht on avalik kaastöötajatele mõeldud kokkuvõte.
|
||||
Hooldaja üksikasjad elavad `CLAUDE.md` (Hard Rule #21) ja [RELEASE_CHECKLIST.md](./RELEASE_CHECKLIST.md). See leht on avalikele kaastöölistele suunatud kokkuvõte.
|
||||
|
||||
## Lühidalt
|
||||
|
||||
@@ -36,21 +36,23 @@ flowchart LR
|
||||
|
||||
`main` ei ole igapäevane integratsiooniharu. Haru `main` vastu avatud PR-id tuleb tavaliselt enne mestimist ümber suunata.
|
||||
|
||||
## Väljalaske külmutamine (paralleelsed tsüklid)
|
||||
## Vabastage külmutamine (paralleelsed tsüklid)
|
||||
|
||||
Väljalaske kooskõlastamise ajal avatakse märgendiga `release-freeze` tähistatud probleem. See **ei peata arendust**:
|
||||
Väljalaske vastavusse viimisel avatakse tähisprobleem `release-freeze`. See** ei peata arengut** :
|
||||
|
||||
- Külmutatud `release/vX.Y.Z` kuulub selle väljalaske eest vastutavale isikule.
|
||||
- Järgmise tsükli `release/vX+1` luuakse külmutatud tipust, et kaastöötajad saaksid tööde lisamist jätkata.
|
||||
- Avatud PR-id, mis on endiselt suunatud külmutatud harule, tuleb **ümber suunata** aktiivsele (suurima versiooniga) harule `release/v*`.
|
||||
- Külmutatud `release/vX.Y.Z` kuulub selle laeva vabastamiskaptenile.
|
||||
- Järgmise tsükli `release/vX+1` lõigatakse külmunud otsa küljest ära, et panustajad jätkaksid maandumistööd.
|
||||
- Avatud PRs, mis on endiselt suunatud külmunud oksale, peaksid olema** uuesti sihitud** aktiivsele (kõrgeimale) `release/v*` harule.
|
||||
|
||||
Enne soovitud haru mestitavaks pidamist kontrollige, kas mõni külmutamine on aktiivne:
|
||||
Enne kui eeldate, et soovitud haru on ühendatav, kontrollige, kas see on külmutatud:
|
||||
|
||||
```bash
|
||||
gh issue list --repo diegosouzapw/OmniRoute --label release-freeze --state open
|
||||
```
|
||||
|
||||
Mestimise mehhanism (omaniku märgend `queue` → Mergify) on dokumenteeritud failis [MERGE_TRAIN.md](./MERGE_TRAIN.md).
|
||||
Ühendamise mehaanika (omanik `queue` silt → Mergify) on dokumenteeritud failis [MERGE_TRAIN.md](./MERGE_TRAIN.md).
|
||||
|
||||
> **2026-11-19: Mergify liitmisjärjekord on lõpetatud** (omaniku otsus). `.mergify.yml` ei määratle enam järjekorda ja keeldub ühendamiskäskudest, mis ühendavad või kirjutavad ümber tõmbamistaotluse. Väljalasked PRs liidetakse käsitsi hoidla reeglistiku "Nõua aktiivsel väljalaskmisel rohelisi väravaid" (`Gate / CI` + `Gate / Quality`) alusel, kuni omni-järjekord töötab reaalajas režiimis, ja seejärel omni-järjekorra kaudu ( [OMNI_QUEUE.md](./OMNI_QUEUE.md) ). `queue` silt ei ühenda enam midagi.
|
||||
|
||||
## Miks on vaja nii haru kui ka märgendit?
|
||||
|
||||
|
||||
@@ -4,6 +4,8 @@
|
||||
|
||||
---
|
||||
|
||||
> **2026-11-19: Mergify ühendamisjärjekord on lõpetatud** (omaniku otsus). `.mergify.yml` ei määratle enam järjekorda ja lükkab tagasi Mergify käsud, mis liidavad või kirjutavad ümber tõmbetaotluse. Tõmbetaotlused väljalaskeharule liidetakse käsitsi hoidla reeglistiku "Require green gates on the active release" (`Gate / CI` + `Gate / Quality`) alusel, kuni omni-queue töötab live-režiimis ja seejärel omni-queue kaudu ([OMNI_QUEUE.md](./OMNI_QUEUE.md)). Allolevad Mergify jaotised kirjeldavad järjekorda sellisena, nagu see oli.
|
||||
|
||||
Alates versioonist v3.8.49 (kvaliteedi-/kiirusplaani WS3.2/WS3.4) on üle vaadatud PR-ide harusse `release/vX.Y.Z` liitmise vaikimisi tee **Mergify liitmisjärjekord** (`.mergify.yml`);
|
||||
allpool dokumenteeritud **käsitsi hallatav liitmisrong** on VARULAHENDUS — seda kasutatakse intsidentide ja väljalaske külmutamise ajal või juhul, kui Mergify avatud lähtekoodiga projektide pakett peaks kunagi muutuma.
|
||||
|
||||
|
||||
@@ -355,112 +355,70 @@ Enne mis tahes v3.8.x versiooni väljalaskmist kontrollige ka järgmisi punkte:
|
||||
|
||||
---
|
||||
|
||||
## 3.9.0 LTS-i haru loomine (läbi harjutatud versioonis 3.8.58)
|
||||
## 3.9.0 LTS lõige (harjutatud 3.8.58)
|
||||
|
||||
Pärast versiooni v3.8.59 on järgmine versioon 3.9.0 ja selle tipust saavad kaks pikaealist haru:
|
||||
`stable/v3` (v3 LTS-i versiooniliin, npm `latest`) ja `develop` (v4, versioon tõstetud 4.0.0-ni, npm
|
||||
`nightly`). Harude/kanalite mudelit, edasipordimist ja silte kirjeldab
|
||||
[RELEASE_STRATEGY.md](./RELEASE_STRATEGY.md); plaan asub dokumendis [ROADMAP](../../ROADMAP.md) (3. etapp). Haru loomine toimub üks kord;
|
||||
versioonis 3.8.58 harjutatakse seda algusest lõpuni fork-repositooriumis ning 3.8.59 lõpetatakse
|
||||
[GO/NO-GO kontrollnimekirjaga](./LTS_GO_NO_GO.md).
|
||||
Pärast v3.8.59 on järgmine versioon 3.9.0 ja selle tipust saab kaks pikaealist haru: `stable/v3` (v3 LTS rida, npm `latest`) ja `develop` (v4, 4.0.0, npm `nightly`). branch/channel mudel, edasi-port ja sildid on formaadis [RELEASE_STRATEGY.md](./RELEASE_STRATEGY.md) ; plaan on [ROADMAP](../../ROADMAP.md) (3. faas). Lõige jookseb üks kord; 3.8.58 harjutab seda otsast lõpuni kahvlil ja 3.8.59 lõpetab [GO/NO-GO kontrollnimekirjaga](./LTS_GO_NO_GO.md).
|
||||
|
||||
### Proovikäivitus (kirjutuskaitstud, alati ohutu)
|
||||
### Kuivtöö (kirjutuskaitstud, ohutu igal ajal)
|
||||
|
||||
```bash
|
||||
npm run release:dry-run-lts-cut # tegelik haru loomine: 3.9.0 lähtekohast HEAD, eelmine silt v3.8.59
|
||||
npm run release:dry-run-lts-cut -- --from <3.9.0-tip> # fikseeri lähtekommit
|
||||
npm run release:dry-run-lts-cut # the real cut: 3.9.0 from HEAD, previous tag v3.8.59
|
||||
npm run release:dry-run-lts-cut -- --from <3.9.0-tip> # pin the source commit
|
||||
```
|
||||
|
||||
`scripts/release/dry-run-lts-cut.mjs` ei käivita midagi: see loeb git-i ja `gh` andmeid ning prindib
|
||||
kogu jada — eeltingimused (lähtekoht lahendub, lähterepositoorium sisaldab täielikku ajalugu —
|
||||
pinnapealne kloon ei saa haru `stable/v3` üles laadida, sest vastuvõttev pool lükkab paketi esimese
|
||||
poogitud eellase juures tagasi, seega looge haru täielikust kloonist või käivitage esmalt
|
||||
`git fetch --unshallow origin` — eelmine silt on olemas, `package.json` sisaldab sihtversiooni,
|
||||
`release-freeze` probleem on avatud, olemasoleval väljalaskeharul pole avatud probleemi
|
||||
`Release branch not green`
|
||||
— olematu haru olekuks kuvatakse `?` ehk teadmata, mitte kunagi roheline — Mergify `release`-i
|
||||
järjekord on seadistatud (G11: `queue_rules`, `checks_timeout`, silt `queue`), `release/*`
|
||||
reeglistik blokeerib endiselt kustutamise ja sunnitud üleslaadimise ning harusid
|
||||
`stable/v3` ja `develop` pole veel olemas), kaks haru loomise sammu, millised uinuvad töövood
|
||||
käivituvad ja millised `if:`-tingimused muutuvad tõeseks (ning millised jäävad repositooriumi
|
||||
muutuja taha või on fikseeritud kanoonilisele repositooriumile), eeldatavad dist-sildid
|
||||
(`latest` → 3.9.0, `next` ja `nightly` on tühjad) ning tagasipööramine. Väljumiskood `0` =
|
||||
`RESULT: READY`, `1` = blokeeriv eeltingimus ebaõnnestus (`✗`), `2` = kasutusviga.
|
||||
`--advisory <id,...>` muudab kontrolli hoiatuseks (`!`) ilma seda peitmata.
|
||||
`scripts/release/dry-run-lts-cut.mjs` ei käivita midagi: loeb git ja `gh` ning prindib kogu jada — eeltingimused (allikas lahendab, allikahoidlal on täielik ajalugu — madal kloon ei saa `stable/v3` lükata, vastuvõttev pool lükkab paki tagasi esimese poogitud vanema juures, nii et lõigatakse eelmisest kloonist või `git fetch --unshallow origin` on esimene —, sihtmärk on olemas `package.json` probleem on avatud, pole avatud `release-freeze` probleem olemasolevas väljalaskeharus `Release branch not green` haru — mida pole olemas, teatab `?` tundmatu, mitte kunagi roheline — omni-queue toob välja väljalaske PRs (G11: `config/merge-queue/config.json` kehtib, selle `bases` haldab väljalaskeharu, `mode` `live`, selle silt on olemas ja `release/*` -puss ja kustutamise reeglid on endiselt blokeeritud) `stable/v3` - `develop` pole veel olemas), kaks haruetappi, mis seisva töövoo päästikud ja `if:` tingimused muutuvad tõeseks (ja mis jäävad hoidla muutujaga piiratuks või kanoonilise hoidla külge kinnitatud), eeldatavad dist-sildid (`latest` → 3.9.0, `next` ja `nightly` tühi) ja tagasipööramine. Välju `0` = `RESULT: READY`, `1` = blokeerimise eeltingimus ebaõnnestus (`✗`), `2` = kasutusviga. `--advisory <id,...>` alandab tšeki hoiatuseks (`!`) seda varjamata.
|
||||
|
||||
Käivitage tegeliku haru loomise proovikäivitus ajal, mil 3.9.0 väljalaske külmutus on veel aktiivne —
|
||||
harud luuakse pärast silti ja enne seda, kui etapp 12c külmutuse lõpetab.
|
||||
Käivitage tõeline lõikamine kuivalt, kuni 3.9.0 vabastuskülm on veel avatud — oksad luuakse pärast silti ja enne, kui faas 12c külmutamise tühistab.
|
||||
|
||||
### 3.8.58 harjutus (ainult fork-repositooriumis)
|
||||
### 3.8.58 proov (ainult kahvel)
|
||||
|
||||
```bash
|
||||
# 1. Proovikäivitus praeguse tipu põhjal koos harjutuse parameetritega
|
||||
# 1. Dry-run on the current tip with rehearsal parameters
|
||||
npm run release:dry-run-lts-cut -- --target-version 3.8.58 --previous-tag v3.8.57 \
|
||||
--advisory freeze,base-green
|
||||
|
||||
# 2. Käivitage FORK-kaugserveri vastu (origin või mis tahes kaugserver, mille URL on kanoonilise
|
||||
# repositooriumi oma, lükatakse tagasi; iga samm küsib terminalis kinnitust)
|
||||
# 2. Execute against a FORK remote (origin, or any remote whose URL is the canonical
|
||||
# repository, is refused; every step asks for confirmation on the terminal)
|
||||
git remote add rehearsal https://github.com/<you>/OmniRoute.git
|
||||
node scripts/release/dry-run-lts-cut.mjs --execute --remote rehearsal \
|
||||
--target-version 3.8.58 --previous-tag v3.8.57 --advisory freeze,base-green
|
||||
|
||||
# 3. Käivitage fork-repositooriumis uinuvad töövood (workflow_dispatch seal, kus proovikäivitus
|
||||
# teatab fikseeritusest kanoonilisele repositooriumile), seejärel pöörake muudatused tagasi
|
||||
# 3. Exercise the dormant workflows in the fork (workflow_dispatch where the dry-run
|
||||
# reports a canonical-repository pin), then roll back
|
||||
node scripts/release/dry-run-lts-cut.mjs --execute --rollback --remote rehearsal \
|
||||
--target-version 3.8.58 --previous-tag v3.8.57 --advisory freeze,base-green
|
||||
```
|
||||
|
||||
Harus `develop` versiooni tõstev kommit luuakse git-i madala taseme vahenditega (tööpuud ei muudeta) ja see tõstab
|
||||
sama viie faili versiooni nagu tsükli avamise kommit: `package.json`, `open-sse/package.json`,
|
||||
`electron/package.json`, `package-lock.json` ja `docs/openapi.yaml`. Jaotis `[4.0.0]`
|
||||
failis CHANGELOG ja selle i18n-peeglid avatakse seejärel harus `develop` enne selle esimest
|
||||
PR-i. Skript ei muuda kunagi npm-i dist-silte — harjutage neid ajutise paketiga.
|
||||
Arendamise tõkestus on üles ehitatud git torustikuga (tööpuud pole puudutatud) ja tõrjub samad viis faili nagu tsükliliselt avatud tagatis: `package.json`, `open-sse/package.json`, `electron/package.json`, `package-lock.json` ja `docs/openapi.yaml`. Sektsioon `[4.0.0]` CHANGELOG ja selle i18n peeglid avatakse `develop` hiljem, enne selle esimest PR. Skript ei muutu kunagi npm dist-tags — harjutab neid, mis on kriimustatud pakendil.
|
||||
|
||||
### PR-i eelvaate artefakt (koosta üks kord, eduta samad baidid)
|
||||
### PR eelvaate artefakt (ehitage üks kord, reklaamige samu baite)
|
||||
|
||||
`.github/workflows/preview-artifact.yml` koostab PR-i tipust ühe tootmiskeskkonna tarball-faili ja
|
||||
valideerib täpselt selle järgu (#8084 osa (a)). Ainult sama repositooriumi PR-id; midagi ei avaldata.
|
||||
`.github/workflows/preview-artifact.yml` koostab PR -peast ühe tootmistarkvara ja kinnitab selle täpse ehituse (#8084 slice (a)). Ainult sama hoidla PRs ; midagi ei avaldata.
|
||||
|
||||
```bash
|
||||
gh workflow run preview-artifact.yml -f pr_number=<N> # või lisa silt `preview-artifact`
|
||||
gh workflow run preview-artifact.yml -f pr_number=<N> # or add the `preview-artifact` label
|
||||
gh run download <run-id> --name preview-artifact-pr<N>-<sha7> --dir preview
|
||||
cd preview && sha256sum -c SHA256SUMS
|
||||
gh attestation verify omniroute-*.tgz --repo diegosouzapw/OmniRoute
|
||||
npm install -g ./omniroute-*.tgz # eelvaate installimine
|
||||
npm install -g ./omniroute-*.tgz # preview install
|
||||
```
|
||||
|
||||
Käivitus täidab käsud `npm ci`, `npm run build:release` ja `npm run check:pack-artifact`, pakib
|
||||
tarball-faili, käivitab `npm run check:pack-boot` (võltsitud saladused, ajutine andmekataloog), pakib selle
|
||||
uuesti ning ebaõnnestub, kui räsi pole identne; seejärel salvestab `artifact-identity.json` (tipu SHA, baasi
|
||||
SHA, lukufaili räsi, platvorm, arhitektuur, node ABI, komplekteerija, järgu poliitika —
|
||||
`scripts/release/artifact-identity.mjs`) ja atesteerib tarball-faili eraldi töös. Eelvaate edutamine
|
||||
tähendab selle tarball-faili installimist: ärge kunagi koostage lähtekoodist uuesti.
|
||||
Käivitamine teeb `npm ci`, `npm run build:release`, `npm run check:pack-artifact`, pakib tarballi, käivitab `npm run check:pack-boot` (võltssaladused, lühiajaline andmekataloog), pakib uuesti ja ebaõnnestub, kui kokkuvõte pole identne, seejärel salvestab `artifact-identity.json` (pea SHA, baasi SHA, lukufaili ehitamine, räsi, de platvormi ABI, — `scripts/release/artifact-identity.mjs`) ja atesteerib tarballi eraldi töös. Eelvaate reklaamimine tähendab selle tarballi installimist: ärge kunagi allikast uuesti üles ehitage.
|
||||
|
||||
### Haru loomine (3.9.0, pärast GO-otsust)
|
||||
### Lõige (3.9.0, pärast GO)
|
||||
|
||||
1. GO-otsus on salvestatud dokumendis [LTS_GO_NO_GO.md](./LTS_GO_NO_GO.md).
|
||||
1. GO salvestatud failis [LTS_GO_NO_GO.md](./LTS_GO_NO_GO.md).
|
||||
2. `npm run release:dry-run-lts-cut -- --from v3.9.0` prindib `RESULT: READY`.
|
||||
3. Looge harud `origin`-is käsitsi proovikäivituse prinditud käskudega — skript keeldub
|
||||
`origin`-isse üles laadimast. Ülevaadatud develop-kommiti taaskasutamiseks käivitage
|
||||
esmalt `--execute`-harjutus 3.9.0 tipus oma fork-repositooriumi vastu; see prindib mõlemad SHA-d ja
|
||||
samad kommitid saab üles laadida:
|
||||
3. Looge `origin` harud käsitsi, kasutades käske kuivkäivitus prindib — skript keeldub `origin`-le surumast. Ülevaadatud arenduskohustuse taaskasutamiseks käivitage esmalt `--execute` proovi 3.9.0 otsas; see prindib mõlemad SHAs ja samad sissekanded saab lükata:
|
||||
|
||||
```bash
|
||||
git push origin <stable-sha>:refs/heads/stable/v3 <develop-sha>:refs/heads/develop
|
||||
```
|
||||
|
||||
4. Kaitske harusid `stable/v3` ja `develop` (reeglistikud + liitmisjärjekord) enne esimese PR-i saabumist.
|
||||
5. Ootel töövood aktiveeruvad haru olemasolul: `forward-port.yml` (tõuge harusse
|
||||
`stable/v3`), `validate-stable-pr.yml` (harusse `stable/v3` suunatud PR-id) ja `nightly-v4-build.yml`
|
||||
(koostab haru `develop`). Enne kasutuselevõttu määrake hoidla saladus `secrets.FORWARD_PORT_TOKEN` (et CI käivituks
|
||||
edasikantud PR-ide puhul); öine avaldamine jääb väljalülitatuks, kuni omanik määrab hoidla
|
||||
muutuja `vars.NIGHTLY_PUBLISH` väärtuseks `true` ja npm Trusted Publishing aktsepteerib
|
||||
faili `nightly-v4-build.yml`. Kanali määrab `scripts/release/dist-tag.mjs`, sama
|
||||
lahendaja, mida kasutab `npm-publish.yml`.
|
||||
6. Kontrollige kanaleid: `npm view omniroute dist-tags --json` näitab, et `latest` = 3.9.0 ning
|
||||
`next` / `nightly` puuduvad kuni v4 avaldamiseni.
|
||||
7. Vajaduse korral tagasipööramine: `git push origin --delete refs/heads/stable/v3 refs/heads/develop`
|
||||
ja `npm dist-tag add omniroute@3.8.59 latest`.
|
||||
4. Kaitske `stable/v3` ja `develop` (reeglistiku + ühendamisjärjekord) enne esimese PR maandumist.
|
||||
5. Seisvad töövood lülituvad sisse haru olemasolu järgi: `forward-port.yml` (tõuke `stable/v3`-le), `validate-stable-pr.yml` (PRs -le `stable/v3`) ja `nightly-v4-build.yml` (ehitab `develop`). Enne reaalajas käivitamist määrake `secrets.FORWARD_PORT_TOKEN` hoidla saladus (nii et CI töötab edasi-pordis PRs); igaõhtune avaldamine jääb välja, kuni omanik määrab hoidla muutuja `vars.NIGHTLY_PUBLISH` väärtuseks `true` ja npm Trusted Publishing aktsepteerib `nightly-v4-build.yml`. Kanali eraldusvõime on `scripts/release/dist-tag.mjs`, sama lahendaja `npm-publish.yml`.
|
||||
6. Kontrollige kanaleid: `npm view omniroute dist-tags --json` näitab `latest` = 3.9.0 ja `next` / `nightly` pole kuni v4 avaldamiseni.
|
||||
7. Vajadusel tagasipööramine: `git push origin --delete refs/heads/stable/v3 refs/heads/develop` ja `npm dist-tag add omniroute@3.8.59 latest`.
|
||||
|
||||
---
|
||||
|
||||
|
||||
@@ -141,38 +141,22 @@ jõudeoleku kontrolli ja taaskäivituse sama käsuga.
|
||||
minutit, kuid kettalt üleslaadimiseks 2 minutit.
|
||||
- VPS `.15` on mõeldud ainult homologeerimiseks — sellel ei käitata kunagi CI runnereid.
|
||||
|
||||
## Majutatud kanal (GitHubi majutatud käitajad)
|
||||
## Hostitud rada (GitHubi hostitud jooksjad)
|
||||
|
||||
Repositoorium kuulub organisatsioonile `cheaper-inference`, mis kasutab paketti **Team**: **60
|
||||
samaaegset majutatud tööd**, mida jagavad kõik organisatsiooni repositooriumid, kõik PR-i kontrollid,
|
||||
iga tõukamisel käivitatav töövoog ja CodeQL-i vaikeseadistus. Allolevad arvud mõõdeti paketi
|
||||
**Pro** ajal (40 samaaegset majutatud tööd). Mõõdetud 2026-10-18
|
||||
ühendamiskampaania ajal (~10 ühendamist tunnis harus `release/v3.8.52`): **24 tunni jooksul
|
||||
loodi 2,500 töövoo käivitust**, 6 tunni jooksul tehti harusse 44 tõukamist, **106 majutatud tööd
|
||||
olid järjekorras**, samal ajal kui PR-i kontrollid ootasid tunde ja PR-id ühendati ilma nendeta.
|
||||
Igal harusse tõukamisel käivitus üheksa töövoogu:
|
||||
Hoidla kuulub `cheaper-inference` organisatsioonile** Meeskond** plaan:** 60 samaaegselt hostitud töökohta** , mida jagavad kõik organisatsiooni hoidlad, iga PR -kontroll, iga tõukekäivitatud töövoog ja CodeQL vaikeseade. Allolevad arvud mõõdeti** Pro** plaan (40 samaaegset hostitud tööd). Mõõdetud 2026-10-18 liitmiskampaania ajal (~ 10 merges/hour kohta `release/v3.8.52`):** 24 tunni jooksul loodud 2500 töövoogu** , 44 tõuget oksale 6 h jooksul,** Järjekorras on 106 hostitud tööd** samal ajal kui PR -tšekid ootasid tunde ja PRs liideti ilma nendeta. Üheksa töövoogu käivitati igal oksale vajutamisel:
|
||||
|
||||
| iga tõukamise kohta harusse `release/v*` | majutatud tööd | tulemus koormustormi ajal | alates 2026-10-18 |
|
||||
| ------------------------------------------- | -------------: | -------------------------------------------------------------------------------- | ----------------------------------------------------------------------------- |
|
||||
| `ci.yml` (täielik maatriks) | kuni 30 | järgmine tõukamine tühistas; ühe päevaga 24 juhtumit 24-st | ei käivitata `release/**` tõukamistel (PR-i käivitus + Release-Green) |
|
||||
| `quality.yml` | ~6 | tühistati, 23 juhtumit 23-st | ei käivitata `release/**` tõukamistel |
|
||||
| `Release-Green` `--quick` | 0 | töötas keskkonnas `omni-build`, 100-st tühistati 97 | `omni-release` pesa, ei tühistata kunagi, ootel käivitused koondatakse |
|
||||
| `Lock released branch`, `OpenSSF Scorecard` | 2 | üks järjekorras olev käivitus iga tõukamise kohta | üks käivitus viite kohta (`tests/unit/build/hosted-lane-concurrency.test.ts`) |
|
||||
| `Release acceptance` (variraport) | 1 | üks majutatud `npm ci` iga tõukamise kohta, ei tühistata kunagi | muutmata — sobib `paths:` filtriga piiramiseks |
|
||||
| `Publish to Docker Hub` → `Deploy to VPS` | 2 | tühistatakse iga tõukamise järel; amd64 haru konkureerib keskkonnas `omni-build` | muutmata — omaniku juurutuskanal |
|
||||
| CodeQL-i vaikeseadistus (`dynamic`) | 4 | `javascript-typescript`, `actions`, `c-cpp`, `python` iga tõukamise kohta | muutmata — Settings → Code security; `c-cpp`/`python` ei skanni siin midagi |
|
||||
| `release/v*` tõuke kohta | hostitud töökohad | tulemus tormi all | alates 2026-10-18 |
|
||||
| ------------------------------------------- | ----------------: | ----------------------------------------------------------------- | ---------------------------------------------------------------------------------- |
|
||||
| `ci.yml` (täismaatriks) | kuni 30 | tühistati järgmise tõukega, 24 24-st päevas | ei käivitu `release/**` tõugetel (PR run + Release-Green) |
|
||||
| `quality.yml` | ~6 | tühistatud, 23/23 | ei käivitunud `release/**` tõugetel |
|
||||
| `Release-Green` `--quick` | 0 | jooksis `omni-build` peal, tühistas 97 100-st | `omni-release` pesa, kunagi tühistatud, ootel jooks aheneb |
|
||||
| `Lock released branch`, `OpenSSF Scorecard` | 2 | üks järjekord tõuke kohta | üks jooks reflektsiooni kohta (`tests/unit/build/hosted-lane-concurrency.test.ts`) |
|
||||
| `Release acceptance` (variaruanne) | 1 | üks hostitud `npm ci` tõuke kohta, pole kunagi tühistatud | muutmata — kandidaat `paths:` filtrile |
|
||||
| `Publish to Docker Hub` → `Deploy to VPS` | 2 | tühistatud tõuke kohta; amd64 jalg võistleb `omni-build` peal | muutmata — omaniku juurutuskanal |
|
||||
| CodeQL vaikeseade (`dynamic`) | 4 | `javascript-typescript`, `actions`, `c-cpp`, `python` tõuke kohta | muutmata — Seaded → Koodi turvalisus; `c-cpp`/`python` ei skaneeri siin midagi |
|
||||
|
||||
`tests/unit/build/push-storm-diet.test.ts` fikseerib failide `ci.yml` ja
|
||||
`quality.yml` ainult `main` harule mõeldud tõukamispäästiku. Kõrvalmõju: Codecov ei saa enam
|
||||
iga väljalaskeharusse tõukamise kohta baastaseme üleslaadimist (samm on informatiivne ja kasutab
|
||||
`continue-on-error`); hoidlasisene katvuse kontrollvärav ja PR-i kommentaar jäävad puutumata.
|
||||
`tests/unit/build/push-storm-diet.test.ts` kinnitab `ci.yml` ja `quality.yml` -only `main`. Kõrvalmõju: Codecov ei saa enam põhiüleslaadimist väljalasketõuke kohta (samm on informatiivne ja `continue-on-error`); reposisene leviala värav ja PR -kommentaar ei muutu.
|
||||
|
||||
**Suurem isemajutatud läbilaskevõime ei lahenda majutatud järjekorra probleemi.** Arendusmasin
|
||||
(`devbox-vm-06-dev002`, 24 vCPU / 54 GB) võiks käitajat majutada, kuid agendisessioonid hoiavad
|
||||
selle koormuse juba tasemel 20–26, agendikonteineril puudub Dockeri deemon ning küllastunud on
|
||||
majutatud kanal. Masinal `.113` oli samal hetkel 71 GB vaba ruumi ja koormus 5–8; selle piirang
|
||||
on ülal kirjeldatud kuulajapõhine mälueelarve (ülempiir 6 kuulajat), mitte CPU. Ülejäänud
|
||||
hoovad on protsessipõhised: ühendage kampaania PR-id Mergify järjekorra kaudu (`label=queue`,
|
||||
partiid jagavad üht `merge_group` CI-käivitust, selle asemel et käivitada üks kord iga PR-i
|
||||
kohta ja lisaks üks kord iga tõukamise kohta), vähendage CodeQL-i vaikeseadistuse keelte hulka
|
||||
ning filtreerige `release-acceptance.yml` failide järgi, mida see loeb.
|
||||
**Suurem isehostitav võimsus ei paranda hostitud järjekorda.** Devbox (`devbox-vm-06-dev002`, 24 vCPU / 54 GB) võib majutada jooksjat, kuid agendiseansside koormus on juba 20–26, agendikonteineris pole Docker deemonit ja küllastunud rada on hostitud. `.113` kastis oli samal hetkel 71 GB vaba ja koormus 5–8; selle piirang on ülaltoodud mälueelarve kuulaja kohta (ülempiir 6 kuulajat), mitte CPU. Ülejäänud hoovad on protsessi hoovad: maandage kampaania PRs läbi ühendamisjärjekorra (`label=queue`, partiid jagavad ühte `merge_group` CI käitamist ühe PR käitamise asemel pluss üks tõuke kohta), kärpige CodeQL vaikeseadekeeli ja filtreerige `release-acceptance.yml` loetavate failide järgi.
|
||||
|
||||
> **2026-11-19: Mergify liitmisjärjekord on lõpetatud** (omaniku otsus). `.mergify.yml` ei määratle enam järjekorda ja keeldub ühendamiskäskudest, mis ühendavad või kirjutavad ümber tõmbamistaotluse. Väljalasked PRs liidetakse käsitsi hoidla reeglistiku "Nõua aktiivsel väljalaskmisel rohelisi väravaid" (`Gate / CI` + `Gate / Quality`) alusel, kuni omni-järjekord töötab reaalajas režiimis, ja seejärel omni-järjekorra kaudu ( [OMNI_QUEUE.md](./OMNI_QUEUE.md) ). Ülaltoodud ühendamise hooba pole enam olemas.
|
||||
|
||||
@@ -29,6 +29,8 @@
|
||||
|
||||
### صف ادغام
|
||||
|
||||
> **19/11/2026: صف ادغام Mergify بازنشسته شده است** (تصمیم مالک). `.mergify.yml` دیگر یک صف تعریف نمی کند و دستورات Mergify را که یک درخواست کشش را ادغام یا بازنویسی می کنند، رد می کند. انتشار PRs با دست در زیر مجموعه قوانین مخزن «نیاز به دروازههای سبز در انتشار فعال» (`Gate / CI` + `Gate / Quality`) ادغام میشود تا زمانی که صف omni در حالت زنده اجرا شود، و پس از آن از طریق صف omni ( [OMNI_QUEUE.md](../ops/OMNI_QUEUE.md) ). مدیریت گردش کار پیشنویسهای Mergify که در زیر توضیح داده شده است، همچنان در `ci.yml` و `quality.yml` است، اما هیچ پیشنویس Mergify دیگر باز نمیشود.
|
||||
|
||||
برچسب `queue` یک PR را به صف Mergify ارسال می کند (`.mergify.yml`). Mergify یک پیش نویس PR را در یک شاخه `mergify/merge-queue/` باز می کند، CI انتخاب کامل را در آنجا اجرا می کند، و PR اصلی با عبور `Gate / CI`، `Gate / Quality` و `Merge integrity (changelog + generated skills)` ادغام می شود.
|
||||
|
||||
Mergify خلاصه صف خود را در توضیحات پیش نویس می نویسد و سایر برنامه ها نیز می توانند آن را ویرایش کنند. یک رویداد `pull_request` `edited` در چنین پیش نویسی گروه همزمانی خود را می گیرد (`-queue-edit-<run_id>`) بنابراین نمی تواند اجرای واقعی پیش نویس را لغو کند و از گیت و ماتریس می گذرد. فقط `Merge integrity` هنوز اجرا می شود. کار دروازه رد شده دارای یک نام چک متفاوت است، زیرا Mergify یک `Gate / CI` نادیده گرفته شده را به عنوان یک چک ناموفق می خواند و PR را حذف می کند.
|
||||
@@ -66,7 +68,7 @@ CLI به `--evidence-root` برای تأیید شواهد حفظ شده نیاز
|
||||
|
||||
`npm run check:forgotten-sibling-tests` به عنوان یک گام مشاوره ای از `Fast Quality Gates` اجرا می شود و از حل کننده واردات در پشت نقشه تست ضربه مجدد استفاده می کند. برای هر ماژول تولید تغییر یافته، زمانی که آزمون کاندید در تفاوت درخواست کشش وجود نداشته باشد، زنجیرههای `changed module/symbol -> static consumer -> candidate sibling test` قطعی را گزارش میکند. خلاصه Markdown و نتیجه JSON بهعنوان مصنوع گردش کار `forgotten-sibling-tests` برای کالیبراسیون قبل از هرگونه عرضه مسدود نگهداری میشوند.
|
||||
|
||||
صادرات مجدد بشکه و واردات پویا فقط تشخیص قطعنامه است. آنها هرگز یک یافته مسدود کننده ایجاد نمی کنند. استثناهای بررسی شده در `config/quality/forgotten-sibling-allowlist.json` زندگی می کنند. هر ورودی باید نام تست مصرف کننده و داوطلب را ذکر کند، دلیل خاصی را ارائه دهد، و یک مشکل GitHub یا درخواست کشش را پیوند دهد. ورودی های نادرست بسته نشدند. استثناها نمی توانند آزمون داوطلب حذف شده یا تفاوتی را که `.skip`/`.todo` اضافه می کند سرکوب کند. تضعیف ادعا و سایر پوششها متعلق به دروازه `check:test-masking` است که به طور مستقل مسدود میشود.
|
||||
صادرات مجدد بشکه و واردات پویا فقط تشخیص قطعنامه است. آنها هرگز یک یافته مسدود کننده ایجاد نمی کنند. استثناهای بررسی شده در `config/quality/forgotten-sibling-allowlist.json` زندگی می کنند. هر ورودی باید نام تست مصرف کننده و داوطلب را ذکر کند، یک دلیل منطقی خاص ارائه دهد، و یک مسئله GitHub یا درخواست کشش را پیوند دهد. ورودی های نادرست بسته نشدند. استثناها نمی توانند آزمون داوطلب حذف شده یا تفاوتی را که `.skip`/`.todo` اضافه می کند سرکوب کند. تضعیف ادعا و سایر پوششها متعلق به دروازه `check:test-masking` است که به طور مستقل مسدود میشود.
|
||||
|
||||
### شغل: `lint`
|
||||
|
||||
@@ -77,7 +79,7 @@ CLI به `--evidence-root` برای تأیید شواهد حفظ شده نیاز
|
||||
| `check:node-runtime` | نسخه Node.js در محدوده پشتیبانی شده است | بله |
|
||||
| `check:cycles` | واردات دایره ای در تمام `src/` + `open-sse/` (بر اساس AST، tsconfig `paths` حل شد). هر زمان که چرخه ای وجود داشته باشد، Bare از 1 خارج می شود (از زمان #15281 بسته شده است) و SCCs را لیست می کند. `check:cycles:ratchet` (آنچه CI اجرا میشود) وقتی تعداد از سقف `metrics.cycles` در `quality-baseline.json` — در حال حاضر 14، `direction: down` بیشتر شود بلوک میکند، بنابراین فقط میتواند سقوط کند (#15159 G-01/G-02) | بله (زاغه دار) |
|
||||
| `check:boundary` | جفت `open-sse → src` : وارد کردن فایل به فایل منحصر به فرد از موتور به برنامه (`scripts/quality/measure-boundary.mjs`؛ لیست لبه، بک لاگ اصلاح v4 core/module-split است). گزارش مشورتی بره = (همان `quality:boundary`). `check:boundary:ratchet` (آنچه CI اجرا میشود، همچنین در حلقه ضامن دار سریع دروازههای `quality.yml` ) وقتی تعداد از سقف `metrics.boundaryOpenSseToSrc` در `quality-baseline.json` — در 771 `direction: down` اندازهگیری شده بیشتر شود، بلوک میکند. `--update` فقط آن را پایین می آورد. نسبی پایه در PRs (`--base-ref`، در زیر ببینید) | بله (زاغه دار) |
|
||||
| `check:route-validation:t06` | طرحوارههای Zod موجود در همه مسیرها (خطمشی ردیف 6) | بله |
|
||||
| `check:route-validation:t06` | طرحواره های Zod موجود در همه مسیرها (خط مشی سطح 6) | بله |
|
||||
| `check:any-budget:t11` | تعداد `@ts-expect-error // any` از بودجه تجاوز نمی کند (Tier 11 catraca) | بله |
|
||||
| `check:provider-consistency` | هر ارائه دهنده در `providers.ts` دارای یک ورودی منطبق در `providerRegistry.ts` است (و بالعکس، در لیست مجاز) | بله |
|
||||
| `check:model-lifecycle` | سه جدول مسیریابی که بهصورت دستی نگهداری میشوند، با عکس فوری چرخه حیات ثبتشده (#11503) سازگار هستند: `FITNESS_TABLE` (`taskFitness.ts`) هیچ شناسه بازنشستهای را که `REGISTRY` بتواند مسیریابی کند، به دست نمیآورد. هر هدف `BUILT_IN_ALIASES` در `REGISTRY` وجود دارد و در عکس فوری شناسه بازنشسته وجود ندارد. هر شناسه بازنشسته هنوز در `REGISTRY` ارسال می شود یا در `allowedRetiredInCatalog` فهرست می شود. و هیچ منبع یا هدف `DEFAULT_DEGRADATION_MAP` در آن عکس فوری بازنشسته به نظر نمی رسد. این ثابت نمی کند که یک مدل در حال حاضر توسط یک بالادست زنده ارائه می شود. — آفلاین با `config/quality/model-lifecycle.json` مقایسه میشود، با دست با `npm run quality:refresh-model-lifecycle` (شبکه؛ به CI سیمکشی نشده) تازهسازی میشود. `allowedRetiredInCatalog` یک جغجغه سوخته است: فقط یک ورودی با مشکل ردیابی اضافه کنید. | بله |
|
||||
@@ -123,7 +125,7 @@ CLI به `--evidence-root` برای تأیید شواهد حفظ شده نیاز
|
||||
| `quality:collect` | `quality-metrics.json` منتشر می کند (تعداد هشدار ESLint ، پوشش از گزارش ادغام شده خردهای) | بله (بالا دست ضامن دار) |
|
||||
| `quality:ratchet` | هر معیار در `quality-baseline.json` پسرفت نکرده است (خط پایه ≤ هشدار ESLint ؛ خط مبنا ≥ پوشش) | بله |
|
||||
| `check:duplication` | تکرار کد (jscpd@4) در `quality-baseline.json` از خط پایه تجاوز نمی کند | بله |
|
||||
| `check:complexity` | پیچیدگی سیکلوماتیک در سطح فایل از سقف تجاوز نمی کند (core ESLint `complexity` + `max-lines-per-function`) | بله |
|
||||
| `check:complexity` | پیچیدگی سیکلوماتیک در سطح فایل از سقف فراتر نمی رود (core ESLint `complexity` + `max-lines-per-function`) | بله |
|
||||
| `check:cognitive-complexity` | پیچیدگی شناختی جغجغه (`eslint-plugin-sonarjs`) — جداگانه ESLint pass; CI هر دو را به عنوان یک مرحله `check:complexity-ratchets` ادغام شده اجرا می کند | بله |
|
||||
| `check:dead-code` | صادرات / فایل های استفاده نشده ضامن دار (knip) در مقابل خط پایه پسرفت نمی کند | بله |
|
||||
| `check:compression-budget` | بودجه معیار تراکم — به ازای هر موتور، طبقات پس انداز نباید پسرفت کنند | بله |
|
||||
@@ -133,7 +135,7 @@ CLI به `--evidence-root` برای تأیید شواهد حفظ شده نیاز
|
||||
|
||||
### شغل: `quality-extended`
|
||||
|
||||
کار مختلط، بدون `continue-on-error` در سطح شغل: مرحلهای که از `--ratchet` عبور میکند، در یک رگرسیون اندازهگیری شده در مقابل `quality-baseline.json` کار را با شکست مواجه میکند. فقط `check:circular-deps` و مرحله نصب اسکنر مشاوره ای هستند ( `continue-on-error: true` در سطح مرحله). نصب اسکنرهای خارجی از طریق `gh release download`. هنگامی که gitleaks وجود ندارد `check:secrets` خود پرش میشود (خروج 0)، در حالی که `check:vuln-ratchet`، `check:workflows` و `check:openapi-breaking` زمانی که اندازهگیری آنها وجود ندارد بسته میشوند.
|
||||
کار مختلط، بدون `continue-on-error` در سطح شغل: مرحله ای که از `--ratchet` عبور می کند، کار را در رگرسیون اندازه گیری شده در مقابل `quality-baseline.json` شکست می دهد. فقط `check:circular-deps` و مرحله نصب اسکنر مشاوره ای هستند ( `continue-on-error: true` سطح گام). نصب اسکنرهای خارجی از طریق `gh release download`. هنگامی که gitleaks وجود ندارد `check:secrets` خود پرش میشود (خروج 0)، در حالی که `check:vuln-ratchet`، `check:workflows` و `check:openapi-breaking` زمانی که اندازهگیری آنها وجود ندارد بسته میشوند.
|
||||
|
||||
| اسکریپت | اعتبار سنجی می کند | مسدود کردن |
|
||||
| ------------------------ | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | ------------------------------------------- |
|
||||
@@ -170,7 +172,7 @@ CLI به `--evidence-root` برای تأیید شواهد حفظ شده نیاز
|
||||
|
||||
- حالت انتشار `check:docs-sync` — هر بررسی را اجرا می کند. حالت PR نسخه package.json/OpenAPI ، سرفصلهای ریشه CHANGELOG و محافظ جایگزین اسناد را نگه میدارد، و `SKIP reason=pr-mode` برای کپیهای آینه `llm.txt` و بخشهای CHANGELOG ترجمه — چاپ میکند، مگر اینکه PR آینهها را بنویسد: یک شاخه سر که بهعنوان نویسنده خانواده `docs/i18n/**` در `config/quality/derived-paths/*.json` اعلام شده است، هر دو را بررسی میکند، و زمانی که diffdit خود را بررسی میکند، یا زمانی که diffqm خود را بررسی میکند `CHANGELOG.md` `docs/i18n/<locale>/llm.txt` می کند که به شدت چک می کند. پایه تفاوت در پرداخت depth-1 (کار `docs-sync-strict` ) حل نمیشود، بنابراین حالت PR یک بررسی را نیز اجرا میکند که نیازی به پایه ندارد: هر آینه `llm.txt` باید وجود داشته باشد، جداکننده `---` خود را حفظ کند و یا بدنه ریشه یا بدنه مشترک اکثر آینهها را حمل کند. پایه ای که حرکت می کند همه آینه ها را به یک اندازه کهنه می کند و می گذرد. ویرایش دستی در یک آینه با شکست مواجه می شود. فایلهای `CHANGELOG.md` ترجمهشده چنین چکی در پرداخت depth-1 PR ندارند.
|
||||
- قلاب pre-commit `check-docs-sync.mjs --mode=pr` را اجرا می کند: یک commit بر اساس آنچه انجام می دهد مورد قضاوت قرار می گیرد. بدون پرچم، یک اجرای محلی حالت انتشار است و یک PR ادغام شده که `llm.txt` ریشه را ویرایش میکند، هر commit بعدی را در آن پایه تا زمانی که موج اجرا شود مسدود میکند. همین قانون برای هر دروازه آگاه از حالت، یک هوسک هاسکی اجرا میشود: قلاب از `--mode=pr` عبور میکند، و حکم سختگیرانه در اجرای حالت آزاد باقی میماند (بازسازی PR، به `main` فشار میدهد، یک اجرای محلی ساده).
|
||||
- آزمایشهای واحد محتوای آینهای (`tests/_helpers/mirrorFreshness.ts`: `cycle-docs-mirror-contract`، `resilience-pre-dispatch-docs-mirrors`، `cli-env-quality-docs-mirrors`، `docs/*-locales`) حالت انتشار — هر محلی را تأیید میکند. حالت PR فقط آینههایی را تأیید میکند که با منبع انگلیسی مطابق `.i18n-state.json` (هش کل فایل، یا هش بخش ضبطشده قسمت پینهای آزمایشی) جاری هستند و از آینههای قدیمی با دلیل میگذرد. بررسی منشأ `target_hash` برای هر محلی در هر دو حالت اجرا می شود. طراوت در هر بخش `## ` ، واحد `run-translation.mjs` هش است. یک بخش طولانی (موجودی گیت این فایل تقریباً نیمی از آن است) به این معنی است که هر ویرایشی در آن آینه ها را کهنه می کند و ادعاهای حالت PR آنها تا موج بعدی رد می شود. لنگری که منبع انگلیسی دیگر حاوی آن نیست، به مقایسه کل فایل بازمی گردد.
|
||||
- آزمایشهای واحد محتوای آینهای (`tests/_helpers/mirrorFreshness.ts`: `cycle-docs-mirror-contract`، `resilience-pre-dispatch-docs-mirrors`، `cli-env-quality-docs-mirrors`، `docs/*-locales`) حالت انتشار — هر محلی را تأیید میکند. حالت PR فقط آینههایی را تأیید میکند که با منبع انگلیسی مطابق `.i18n-state.json` (هش کل فایل، یا هش بخش ضبطشده قسمت پینهای آزمایشی) جاری هستند و از آینههای قدیمی با دلیل میگذرد. بررسی منشأ `target_hash` برای هر محلی در هر دو حالت اجرا می شود. طراوت در هر بخش `## ` ، واحد `run-translation.mjs` هش است. یک بخش طولانی (موجودی گیت این فایل تقریباً نیمی از آن است) به این معنی است که هر ویرایشی در آن آینه ها را کهنه می کند و ادعاهای حالت PR آنها تا موج بعدی رد می شود. یک لنگر که منبع انگلیسی دیگر حاوی آن نیست، به مقایسه کل فایل بازمی گردد.
|
||||
- مشاوره `i18n translation drift` — در مورد PRs، سختگیرانه در مورد فشار، شبانه و برش رهاسازی، بنابراین یک آینه کهنه نمی تواند در آزادسازی ارسال شود.
|
||||
|
||||
`scripts/i18n/sync-llm-mirrors.mjs` (همچنین به عنوان `syncLlmMirrors()` صادر می شود، با `--dry-run`) آینه های `llm.txt` را بازنویسی می کند. بازخوانی انتشار، موج ترجمه و `i18n-mirror-refresh.yml` زمانبندیشده آن را اجرا میکنند (بازسازی آینههای کهنه `llm.txt` را با اجرای خشک شناسایی میکند، زیرا گزارش رانش آنها را فهرست نمیکند و آنها را قبل از `check:docs-all` همگامسازی میکند).
|
||||
@@ -203,8 +205,8 @@ CLI به `--evidence-root` برای تأیید شواهد حفظ شده نیاز
|
||||
| کجا | حالت |
|
||||
| ------------------------------------------------------------------------------------------------------- | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------ |
|
||||
| ویژگی PR — `ci.yml` job `docs-sync-strict`, `quality.yml` step "Docs accuracy" | `pr` (اتوماتیک)؛ کار از پایه به عنوان `BASE_SHA` عبور می کند و با `fetch-depth: 2` بررسی می شود |
|
||||
| `merge_group`، نامزدهای `omni-queue/**` ، فهرست دروازه کامل قطار ادغام | `pr` |
|
||||
| PR (`release/v* → main`)، فشارها، اجرای برنامه ریزی شده و دستی را آزاد کنید | `release` |
|
||||
| `merge_group`، نامزدهای `omni-queue/**` ، لیست دروازه کامل قطار ادغام | `pr` |
|
||||
| PR (`release/v* → main`)، فشارها، اجراهای برنامه ریزی شده و دستی را آزاد کنید | `release` |
|
||||
| انتشار-سبز (`scripts/quality/validate-release-green.mjs`) | آیتم های HARD با `OMNIROUTE_GATE_MODE=pr` اجرا می شوند ("آیا پایه شکست؟"); مورد DRIFT `derived-refresh` `npm run release:refresh-derived -- --check` را اجرا میکند (نمای دقیق، هرگز پایه قرمز را باز نمیکند) |
|
||||
| انتشار (فازهای `/generate-release` 0a و 1؛ سیمکشی مهارت تغییر جداگانهای است که توسط مالک تأیید شده است) | `npm run release:refresh-derived` فایل های مشتق شده را می نویسد. چک های خود PR را آزاد کنید سپس در حالت `release` اجرا کنید |
|
||||
| `nightly-derived-refresh.yml` (روزانه، بالاترین `release/vX.Y.Z`، حذف شده در زمان انتشار-انجماد) | `npm run release:refresh-derived -- --profile=nightly`; در یک تفاوت، ONE PR از `chore/derived-refresh` باز نگه میدارد. هرگز ادغام نمی شود |
|
||||
@@ -249,13 +251,13 @@ PR که همچنان کاتالوگهای محلی را در حالت `pr` تغ
|
||||
|
||||
یک رگرسیون i18n را میگیرد که دروازههای دیگر از نظر ساختاری نمیتوانند ببینند: یک مقدار انگلیسی بازنویسی میشود و ترجمههای مشتقشده از انگلیسی _قبلی باقی میمانند، بنابراین کاربران غیرانگلیسی به خواندن نسخهای با اعتماد به نفس و اکنون اشتباه ادامه میدهند.
|
||||
|
||||
این به صورت واقعی ارسال شد. `oauthModal.googleOAuthWarning` هنگامی که کمک کننده ورود به سیستم Antigravity فرود آمد بازنویسی شد (#5203).** 39 از 43 منطقه** متنی را نگه داشت و به اپراتورها میگفت که " URL کامل را کپی کرده و آن را در زیر بچسبانند" — جریانی که نمیتواند برای آن ارائهدهنده کامل شود. تا زمان #8463 مورد توجه قرار نگرفت زیرا:
|
||||
این به صورت واقعی ارسال شد. `oauthModal.googleOAuthWarning` هنگامی که کمک کننده ورود به سیستم Antigravity فرود آمد بازنویسی شد (#5203).** 39 از 43 منطقه** متنی را نگه داشت و به اپراتورها میگفت که " URL کامل را کپی کرده و آن را در زیر جایگذاری کنید" — که نمیتواند برای آن ارائهدهنده کامل شود. تا زمان #8463 بی توجه بود زیرا:
|
||||
|
||||
- `sync-ui-keys` فقط کلیدهایی را که هستند پر می کند** غایب** ، هرگز آنهایی که نیستند** کهنه** ;
|
||||
- `check-ui-keys-coverage` کلید _presence_ را می شمارد، بنابراین یک ترجمه کهنه به عنوان پوشش داده می شود.
|
||||
- `check-translation-drift` tracks the `docs/i18n/<locale>/**.md` documentation mirrors — it never reads `src/i18n/messages/*.json`. It runs in job `docs-sync-strict`: advisory on PRs, strict on push and nightly; the translation wave refreshes the mirrors, not the feature PR.
|
||||
|
||||
**آگاه از تفاوت، نه با پشتوانه پایه.** `en.json` در پایه ادغام با درخت کار مقایسه می کند. برای هر کلیدی که مقدار انگلیسی آن تغییر کرده است، هر محلی که هنوز ترجمه دست نخورده آن را نگه دارد، قدیمی است. این عمدا** بدهی های قبلی را مسدود می کند** — a diff نمی تواند آشکار کند که یک ترجمه قدیمی از کدام انگلیسی قدیمی آمده است، بنابراین دروازه فقط آنچه را که تغییر فعلی لمس می کند قضاوت می کند. جایگزین (خط پایه هش به ازای هر کلید) یک فایل تولید شده ~ 600 KB هزینه خواهد داشت، که 3 × بزرگترین خط پایه موجود است که در هر i18n PR ایجاد می شود.
|
||||
**آگاه از تفاوت، نه با پشتوانه پایه.** `en.json` در پایه ادغام با درخت کار مقایسه می کند. برای هر کلیدی که مقدار انگلیسی آن تغییر کرده است، هر محلی که هنوز ترجمه دست نخورده آن را نگه داشته باشد، قدیمی است. این عمدا** بدهی های قبلی را مسدود می کند** — a diff نمی تواند نشان دهد که یک ترجمه قدیمی از کدام انگلیسی قدیمی آمده است، بنابراین دروازه فقط آنچه را که تغییر فعلی لمس می کند قضاوت می کند. جایگزین (خط پایه هش به ازای هر کلید) یک فایل تولید شده ~ 600 KB هزینه خواهد داشت، که 3 × بزرگترین خط پایه موجود است که در هر i18n PR ایجاد می شود.
|
||||
|
||||
دو راه برای ارضای آن:
|
||||
|
||||
@@ -284,11 +286,11 @@ BASE_REF=origin/release/vX.Y.Z npm run i18n:check-value-drift
|
||||
|
||||
فقط با درخواست های کششی اجرا می شود.
|
||||
|
||||
| اسکریپت | اعتبار سنجی می کند | مسدود کردن |
|
||||
| ---------------------- | ---------------------------------------------------------------------------------------------------------------------------------- | ---------- |
|
||||
| `check:pr-test-policy` | PRs که کد تولید را در `src/`، `open-sse/`، `electron/`، یا `bin/` تغییر میدهد باید شامل تستها یا بهروزرسانی باشد (Hard Rule #8) | بله |
|
||||
| `check:test-masking` | فایلهای آزمایشی تغییر یافته تعداد خالص ادعاها را کاهش نمیدهند یا توتولوژیهای `assert.ok(true)` را اضافه نمیکنند | بله |
|
||||
| `check:pr-evidence` | بدن PR شواهد test/VPS را برای این تغییر ذکر میکند (قاعده سخت #18 با برداشتن PR نثر — شکننده مکانیزه میکند، به Backlog مراجعه کنید) | بله |
|
||||
| اسکریپت | اعتبار سنجی می کند | مسدود کردن |
|
||||
| ---------------------- | -------------------------------------------------------------------------------------------------------------------------------------- | ---------- |
|
||||
| `check:pr-test-policy` | PRs که کد تولید را در `src/`، `open-sse/`، `electron/`، یا `bin/` تغییر میدهد باید شامل تستها یا بهروزرسانی باشد (Hard Rule #8) | بله |
|
||||
| `check:test-masking` | فایلهای آزمایشی تغییر یافته تعداد خالص ادعاها را کاهش نمیدهند یا توتولوژیهای `assert.ok(true)` را اضافه نمیکنند | بله |
|
||||
| `check:pr-evidence` | بدن PR شواهد test/VPS را برای تغییر ذکر میکند (قاعده سخت #18 با برداشتن PR نثر — شکننده مکانیزه مکانیزه میکند، به Backlog مراجعه کنید) | بله |
|
||||
|
||||
### شغل: `test-vitest`
|
||||
|
||||
|
||||
Some files were not shown because too many files have changed in this diff Show More
Reference in New Issue
Block a user