Compare commits

..

2 Commits

Author SHA1 Message Date
diegosouzapw
4625936608 chore(changelog): number the media polling fragment for #20824 2026-11-20 18:32:15 -03:00
diegosouzapw
0d56007238 fix(security): clamp media polling and guard syntx provider rules (CodeQL #1389, #1392)
Caller-supplied poll_interval_ms, timeout_ms and poll_timeout_ms on the
NanoBanana, Magnific, Black Forest Labs and RenderHour image handlers are
clamped (30 s interval, 10 min window) by a shared helper that never
shortens a default. The RenderHour poller passes the request abort signal
to sleep(). applySyntxProviderRules only runs own entries of the rules
table.
2026-11-20 18:22:31 -03:00
490 changed files with 10211 additions and 16172 deletions

View File

@@ -38,9 +38,6 @@ 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"
@@ -1175,7 +1172,7 @@ jobs:
- uses: actions/setup-node@949feb2413d6458794dcd2491c4babbbce0c15c1 # v7
with:
package-manager-cache: false
node-version: ${{ env.CI_V8_NODE_VERSION }}
node-version: ${{ env.CI_NODE_VERSION }}
- uses: ./.github/actions/prepare-unit-storage
with:
cache: ${{ github.event_name == 'pull_request' }}
@@ -1195,7 +1192,6 @@ 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
@@ -1205,12 +1201,6 @@ 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 \
@@ -1218,23 +1208,11 @@ jobs:
--exclude=tests/** \
--exclude=**/*.test.* \
npm run test:unit:ci:shard
- 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
- name: Upload raw shard coverage
if: always()
uses: actions/upload-artifact@cf430e030ddbb5b0abf93d22962f4752f3646cd9 # v7
with:
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 }}
name: coverage-shard-${{ matrix.shard }}
path: coverage-shard/*.json
if-no-files-found: error
@@ -1337,9 +1315,6 @@ 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
@@ -1379,27 +1354,21 @@ jobs:
- uses: actions/setup-node@949feb2413d6458794dcd2491c4babbbce0c15c1 # v7
with:
package-manager-cache: false
node-version: ${{ env.CI_V8_NODE_VERSION }}
node-version: ${{ env.CI_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:
artifact-ids: ${{ steps.coverage_selection.outputs.artifact_ids }}
pattern: coverage-shard-*
path: coverage-shards/
merge-multiple: false
merge-multiple: true
- name: Merge + report + gate
# Verify and merge each raw report in order without storing a second
# raw copy. c8 reads the aggregate for source mapping and reporting.
# 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 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
@@ -1409,17 +1378,21 @@ jobs:
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" ] || [ "${SONARQUBE_ENABLED:-}" = "true" ]; then
if [ "$EVENT_NAME" != "pull_request" ] || [ "$SONARQUBE_ENABLED" = "true" ]; then
LCOV_REPORTER=(--reporter=lcov)
fi
mkdir -p coverage
# 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
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
# 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
@@ -1427,7 +1400,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-verified \
--temp-directory coverage-shards \
--reports-dir coverage \
--merge-async \
--reporter=text-summary \
@@ -1437,7 +1410,6 @@ 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: |
@@ -1488,8 +1460,6 @@ 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

3046
.i18n-state.json generated

File diff suppressed because it is too large Load Diff

View File

@@ -1 +0,0 @@
- feat(routing): allow scoping task-aware routing to specific target or excluded models/combos via `targetModels` and `excludedModels` in TaskRoutingConfig (#20294)

View File

@@ -1 +0,0 @@
- Merge verified coverage shards in their original reporting order and write a single aggregate for c8, reducing temporary disk use on CI runners.

View File

@@ -1 +0,0 @@
- 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.

View File

@@ -1 +0,0 @@
- **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

View File

@@ -1 +0,0 @@
- **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)).

View File

@@ -1 +0,0 @@
- **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)

View File

@@ -1 +0,0 @@
- **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))

View File

@@ -1 +0,0 @@
- **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

View File

@@ -1 +0,0 @@
- 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).

View File

@@ -1 +0,0 @@
- **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))

View File

@@ -1 +0,0 @@
- **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))

View File

@@ -1 +0,0 @@
- **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))

View File

@@ -1 +0,0 @@
- 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).

View File

@@ -1 +0,0 @@
- 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).

View File

@@ -1 +0,0 @@
- **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.

View File

@@ -1 +0,0 @@
- **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))

View File

@@ -1 +0,0 @@
- 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.

View File

@@ -1 +0,0 @@
- **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)

View 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))

View File

@@ -1 +0,0 @@
- **fix(security):** Compression engines bound their regex work on hostile input: the headroom GCF inline-array check and the RTK raw-output command slug run in linear time, and CCR `grep` rejects patterns with more than one unbounded quantifier and stops a scan that exceeds a 1 s time budget (CodeQL #1301, #1302, #1349)

View File

@@ -1 +0,0 @@
- **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.

View File

@@ -1 +0,0 @@
- **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

View File

@@ -1,7 +1,6 @@
{
"_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.",
@@ -35,7 +34,6 @@
"@atjsh/llmlingua-2",
"@aws-sdk/client-bedrock-runtime",
"@axe-core/playwright",
"@bcoe/v8-coverage",
"@cyclonedx/cyclonedx-npm",
"@dnd-kit/core",
"@dnd-kit/sortable",

View File

@@ -92,19 +92,18 @@ 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/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) |
| 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) |
The `GET /api/plugins` `status` filter accepts one of
`installed` / `active` / `inactive` / `error`. An invalid value returns `400`.
@@ -138,8 +137,7 @@ 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. The same
applies to `POST /api/plugins/marketplace/install` (body `{ "name": "<plugin>" }`).
(`requireLogin=false`): installing code is never an anonymous action.
### Browse the marketplace
@@ -157,13 +155,10 @@ curl -X PUT http://localhost:20128/api/plugins/my-plugin/config \
-d '{ "config": { "level": "debug", "maxItems": 100 } }'
```
`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").
`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.
## Configuration

View File

@@ -19,18 +19,16 @@
### የእጩዎች መግቢያ
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 ስለሚያጠፋ ነው።
@@ -39,7 +37,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 ቼኮች ነጻ ሆነው ይቆያሉ፡ ተዛማጅ ባይት የቆየ ደረሰኝን ማዳን አይችልም። የፋይል ታማኝነት የአፈፃፀም ትክክለኛነት ወይም የቅርስ ማስተዋወቅ ማረጋገጫ አይደለም።
@@ -49,7 +47,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` ነው።
@@ -66,9 +64,9 @@ Mergify የወረፋ ማጠቃለያውን ወደ ረቂቁ መግለጫ ይጽ
#### የተረሱ ወንድም እህት ፈተናዎች ሪፖርት ያደርጋሉ
`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` ሰንሰለቶችን ሪፖርት ያደርጋል። የ 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`
@@ -177,11 +175,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`);
@@ -215,7 +213,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` ነባሪዎች)፡-
@@ -251,7 +249,7 @@ npm run release:refresh-derived -- --check # what the rele
አንዱን i18n regression ይይዛል ሌላኛው በመዋቅራዊ መልኩ በሮች ማየት አይችሉም፡ የእንግሊዘኛ እሴት እንደገና ይፃፋል እና ከ _ቀዳሚ_ እንግሊዘኛ የተገኙት ትርጉሞች ወደ ኋላ ይቆያሉ፣ ስለዚህ እንግሊዛዊ ያልሆኑ ተጠቃሚዎች በልበ ሙሉነት-ቃል ያለው አሁን የተሳሳተ ቅጂ ያነባሉ።
ይህ በእውነቱ ተልኳል። `oauthModal.googleOAuthWarning` እንደገና የተጻፈው Antigravity መግቢያ ረዳት ሲያርፍ (#5203);** 39 ከ 43 አከባቢዎች** ለኦፕሬተሮች "ሙሉውን URL ገልብጠው ከዚህ በታች ለጥፍ" የሚል ጽሁፍ ደጋግሞ ለአገልግሎት አቅራቢው ማጠናቀቅ የማይችል — ። እስከ #8463 ድረስ ሳይስተዋል ቀርቷል ምክንያቱም፡-
ይህ በእውነቱ ተልኳል። `oauthModal.googleOAuthWarning` በድጋሚ የተጻፈው አንቲግራቪቲ መግቢያ ረዳት ሲያርፍ (#5203);** 39 ከ 43 አከባቢዎች** ለኦፕሬተሮች "ሙሉውን URL ገልብጠው ከዚህ በታች ለጥፍ" — ለዚያ አገልግሎት አቅራቢ ማጠናቀቅ የማይችል ፍሰት እንዲያደርጉ የሚገልጽ ጽሁፍ ቀጠለ። እስከ #8463 ድረስ ሳይስተዋል ቀርቷል ምክንያቱም፡-
- `sync-ui-keys` ያሉትን ቁልፎች ብቻ ነው የሚሞላው።** የለም** ፣ በጭራሽ ያልሆኑት።** የቆየ** ;
- `check-ui-keys-coverage` ቁልፍ _presence_ ይቆጥራል፣ ስለዚህ የቆየ ትርጉም እንደተሸፈነ ይቆጠራል።

View File

@@ -42,23 +42,25 @@ flowchart LR
`main` የዕለት ተዕለት ውህደት ቅርንጫፍ አይደለም። `main`ን በማነጣጠር የተከፈቱ PRዎች
ከመዋሃዳቸው በፊት ብዙውን ጊዜ ወደ ሌላ ቅርንጫፍ እንዲያነጣጥሩ መቀየር ያስፈልጋቸዋል።
## የተለቀቀው በረዶ (ትይዩ ዑደቶች)
## የልቀት ማገድ (ትይዩ ዑደቶች)
ልቀትን በሚታረቅበት ጊዜ `release-freeze` የሚል ምልክት ማድረጊያ ችግር ይከፈታል። ያ** ልማትን አያቆምም።** :
አንድ ልቀት በሚጣጣምበት ጊዜ፣ `release-freeze` የሚል መለያ ያለው ምልክት ጉዳይ
ይከፈታል። ይህ **ልማትን አያቆምም**፦
- የቀዘቀዘው `release/vX.Y.Z` የዚያ መርከብ የተለቀቀው ካፒቴን ነው።
- የሚቀጥለው ዑደት `release/vX+1` ከቀዘቀዘው ጫፍ ተቆርጧል ስለዚህ አስተዋፅዖ አበርካቾች የማረፍ ስራቸውን ይቀጥላሉ.
- አሁንም የታሰረውን ቅርንጫፍ ያነጣጠረ PRs ይክፈቱ** እንደገና ዒላማ አድርጓል** ወደ ንቁ (ከፍተኛ) `release/v*` ቅርንጫፍ።
- የታገደው `release/vX.Y.Z` ለዚያ ልቀት የልቀት ኃላፊው ይሆናል።
- አስተዋጽዖ አድራጊዎች ሥራቸውን ማስገባታቸውን እንዲቀጥሉ፣ የቀጣዩ ዑደት `release/vX+1`
ከታገደው ጫፍ ይፈጠራል።
- አሁንም የታገደውን ቅርንጫፍ የሚያነጣጥሩ ክፍት PRዎች ንቁውን (ከፍተኛውን)
`release/v*` ቅርንጫፍ **እንዲያነጣጥሩ መቀየር** አለባቸው።
የሚፈልጉትን ቅርንጫፍ ሊዋሃድ ይችላል ብለው ከመገመትዎ በፊት ክፍት ቅዝቃዜ እንዳለ ያረጋግጡ፡-
የሚፈልጉት ቅርንጫፍ ሊዋሃድ የሚችል ነው ብለው ከመገመትዎ በፊት፣ ክፍት የማገድ ጉዳይ እንዳለ ያረጋግጡ፦
```bash
gh issue list --repo diegosouzapw/OmniRoute --label release-freeze --state open
```
ውህደት ሜካኒክስ (ባለቤት `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` መለያው ከእንግዲህ ምንም አያዋህድም።
የውህደት አሠራሮች (የባለቤቱ `queue` መለያ → Mergify) በ
[MERGE_TRAIN.md](./MERGE_TRAIN.md) ውስጥ ተመዝግበዋል።
## ቅርንጫፍና መለያ ሁለቱም ለምን ያስፈልጋሉ?

View File

@@ -4,9 +4,10 @@
---
> **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 ክፍት ምንጭ ዕቅድ ከተለወጠ ነው።
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 ዕቅድ ከተቀየረ ጥቅም ላይ ይውላል።
## ነባሪ መንገድ፦ የMergify ወረፋ

View File

@@ -379,7 +379,8 @@ grafted parent ላይ packን ውድቅ ያደርጋል፤ ስለዚህ ከሙ
የቀድሞው tag አለ፣ `package.json` የዒላማው ስሪት ነው፣ የ`release-freeze` issue ክፍት ነው፣
እና በነባር release branch ላይ ክፍት `Release branch not green` issue የለም —
የሌለ branch `?` ያልታወቀ ብሎ ይመልሳል፣ ፈጽሞ green አይባልም —
omni-queue የማዋሃድ ጥያቄዎችን ወደ መልቀቂያ ቅርንጫፍ ያዋህዳል (G11: `config/merge-queue/config.json` የሚሰራ፣ የእሱ `bases` የመልቀቂያ ቅርንጫፉን ያስተዳድራል፣ `mode` `live`፣ መለያው አለ)፣ የ`release/*` ruleset አሁንም መሰረዝን እና force-pushን ይከለክላል፣ እንዲሁም
የMergify `release` queue ተዋቅሯል (G11፦ `queue_rules`፣ `checks_timeout`፣
መለያ `queue`)፣ የ`release/*` ruleset አሁንም መሰረዝን እና force-pushን ይከለክላል፣ እንዲሁም
`stable/v3` እና `develop` ገና የሉም)፣ ሁለቱን የbranch ደረጃዎች፣ የትኞቹ የቦዘኑ workflow
triggerዎች እና `if:` ሁኔታዎች true እንደሚሆኑ (እና የትኞቹ በrepository variable
እንደታገዱ ወይም ወደ canonical repository እንደተወሰኑ)፣ የሚጠበቁ dist-tagዎችን (`latest` → 3.9.0፣

View File

@@ -136,22 +136,34 @@ job ሳይያያዝበት RAM እና CPU መጠቀሙን ይቀጥላል። እ
ደቂቃ፣ ከdisk ላይ upload ለመደረግ ደግሞ 2 ደቂቃ ወስዷል።
- `.15` VPS ለhomologation ብቻ ነው — CI runnersን ፈጽሞ አያስኬድም።
## የተስተናገደ መስመር (GitHub-የተስተናገዱ ሯጮች)
## የተስተናገደ መስመር (በGitHub የሚስተናገዱ runners)
ማከማቻው `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 ያለ እነርሱ ተቀላቅለዋል. በእያንዳንዱ ግፋ ወደ ቅርንጫፉ ላይ ዘጠኝ የስራ ፍሰቶች ተኮሱ፡-
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 ተነስተዋል፦
| በአንድ ግፊት ወደ `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` እዚህ ምንም አይቃኝም። |
| በእያንዳንዱ 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` እዚህ ምንም አይቃኙም |
`tests/unit/build/push-storm-diet.test.ts` የ `main` -only የግፋ ማስጀመሪያን የዝቅድ እና `ci.yml` ፒን ያያል `quality.yml` የጎንዮሽ ጉዳት: Codecov ከአሁን በኋላ የመሠረት ሰቀላ በእያንዳንዱ ልቀት ግፊት አይቀበልም (እርምጃው መረጃዊ እና `continue-on-error` ነው); የውስጠ-repo ሽፋን በር እና PR አስተያየት አልተነኩም።
`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
አልተነኩም።
**የበለጠ በራሱ የሚስተናገድ አቅም የተስተናገደውን ወረፋ አያስተካክለውም።** ዴቭቦክስ (`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) ) ስር ይደባለቃሉ። ከላይ ያለው የሜርጂፋይ ዱላ ከአሁን በኋላ የለም።
**ተጨማሪ 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 መሠረት ማጣራት።

View File

@@ -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,8 +29,6 @@
### دمج قائمة الانتظار
> **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 في قائمة الانتظار.
@@ -57,12 +55,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 غير مسودة ؛ سجل التغيير ومزامنة المهارات التي تم إنشاؤها | نعم، بما في ذلك الشوك |
#### تقرير اختبارات الأخوة المنسية
@@ -74,39 +72,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;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`، لأن الملف الذي يستخدمه لا يُبلغ عن أي تشخيصات على الإطلاق، وإلا سيكون غير مرئي لكل بوابة. | نعم |
| السيناريو (`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`، لأن الملف الذي يستخدمه لا يُبلغ عن أي تشخيصات على الإطلاق، وإلا سيكون غير مرئي لكل بوابة. | نعم |
#### هناك برنامجان للتحقق من الكتابة يجيبان بشكل مختلف
@@ -122,11 +120,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` | نعم |
@@ -135,7 +133,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` في الإغلاق عندما يكون قياسهم مفقودًا.
| البرنامج النصي | التحقق من صحة | الحظر |
| ------------------------ | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------ | --------------------------------------- |
@@ -144,7 +142,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`
@@ -168,7 +166,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`، وهو تشغيل محلي عادي).
@@ -181,7 +179,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`) ؛
@@ -239,7 +237,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`.

View File

@@ -4,9 +4,14 @@
---
يستخدم OmniRoute أ** دورة متوازية** نموذج الإصدار: فرع `release/vX.Y.Z` مخصص للدورة النشطة، `main` للخط المنشور، وعلامة `vX.Y.Z` غير قابلة للتغيير عند شحن تلك الدورة. رؤية ارتكاب الأرض على `release/*` _and_ على `main` من المتوقع أن تكون — وليس اختلاطًا.
يستخدم OmniRoute نموذج إصدار **الدورات المتوازية**: فرعًا مخصصًا باسم `release/vX.Y.Z`
للدورة النشطة، و`main` لمسار الإصدارات المنشورة، ووسمًا غير قابل للتغيير باسم
`vX.Y.Z` عند نشر تلك الدورة. من المتوقع أن ترى الإيداعات تصل إلى `release/*` _وكذلك_ إلى
`main` — فهذا ليس خطأً.
تفاصيل المشرف تعيش في `CLAUDE.md` (Hard Rule #21) و [RELEASE_CHECKLIST.md](./RELEASE_CHECKLIST.md). هذه الصفحة هي الملخص العام الذي يواجه المساهمين.
توجد التفاصيل الخاصة بالمشرفين في `CLAUDE.md` (القاعدة الصارمة رقم 21) وفي
[RELEASE_CHECKLIST.md](./RELEASE_CHECKLIST.md). تمثل هذه الصفحة الملخص العام
الموجّه للمساهمين.
## نظرة سريعة
@@ -25,33 +30,37 @@ 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. افتح PR مع** قاعدة = أن `release/vX.Y.Z`** .
1. ابحث عن أعلى فرع `release/v*` مفتوح (مثال وقت كتابة هذا المستند:
`release/v3.8.49`).
2. أنشئ فرعك من طرفه (`git fetch` ثم checkout / rebase عليه).
3. افتح طلب السحب مع ضبط **الفرع الأساسي = فرع `release/vX.Y.Z` ذاك**.
`main` ليس فرع التكامل اليومي. عادةً ما يحتاج PRs المفتوح ضد `main` إلى إعادة الاستهداف قبل الدمج.
`main` ليس فرع التكامل اليومي. وعادةً ما تحتاج طلبات السحب المفتوحة ضده
إلى إعادة توجيه قبل الدمج.
## تجميد الافراج (دورات متوازية)
## تجميد الإصدار (الدورات المتوازية)
عندما تتم تسوية الإصدار، يتم فتح مشكلة علامة تحمل اسم `release-freeze`. الذي - التي** لا يتوقف عن التنمية** :
عند إجراء تسوية لأحد الإصدارات، تُفتح مشكلة علامة تحمل التصنيف `release-freeze`.
وهذا **لا يوقف التطوير**:
- `release/vX.Y.Z` المجمدة مملوكة لقبطان تلك السفينة.
- يتم قطع `release/vX+1` للدورة التالية من الطرف المتجمد حتى يواصل المساهمون أعمال الهبوط.
- يجب فتح PRs الذي لا يزال يستهدف الفرع المجمد** إعادة استهداف** إلى فرع `release/v*` النشط (الأعلى).
- يصبح فرع `release/vX.Y.Z` المجمّد تحت مسؤولية قائد الإصدار الخاص بذلك النشر.
- يُنشأ فرع الدورة التالية `release/vX+1` من الطرف المجمّد حتى يتمكن المساهمون من مواصلة
دمج أعمالهم.
- ينبغي **إعادة توجيه** طلبات السحب المفتوحة التي ما زالت تستهدف الفرع المجمّد إلى
فرع `release/v*` النشط (الأعلى).
تحقق من وجود تجميد مفتوح قبل افتراض أن الفرع الذي تريده قابل للدمج:
تحقق من وجود تجميد مفتوح قبل افتراض أن الفرع المطلوب قابل للدمج:
```bash
gh issue list --repo diegosouzapw/OmniRoute --label release-freeze --state open
```
تم توثيق آليات الدمج (علامة المالك `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` تدمج أي شيء.
آليات الدمج (تصنيف المالك `queue` ← Mergify) موثّقة في
[MERGE_TRAIN.md](./MERGE_TRAIN.md).
## لماذا نحتاج إلى فرع ووسم معًا؟

View File

@@ -4,9 +4,10 @@
---
> **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.
منذ الإصدار v3.8.49 (‏WS3.2/WS3.4 من خطة الجودة/السرعة)، أصبح مسار الدمج الافتراضي لطلبات السحب
التي تمت مراجعتها إلى `release/vX.Y.Z` هو **طابور الدمج في Mergify** (`.mergify.yml`)؛
أما **قطار الدمج اليدوي** الموثّق أدناه فهو المسار الاحتياطي — ويُستخدم أثناء الحوادث،
أو تجميد الإصدارات، أو إذا تغيّرت خطة Mergify Open Source يومًا ما.
## المسار الافتراضي: قائمة انتظار Mergify

View File

@@ -355,70 +355,111 @@ 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`). نموذج 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).
بعد 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).
### التشغيل الجاف (للقراءة فقط، آمن في أي وقت)
### التشغيل التجريبي (للقراءة فقط، وآمن في أي وقت)
```bash
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
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> # تثبيت التزام المصدر
```
`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,...>` بخفض مستوى الشيك إلى تحذير (`!`) دون إخفاءه.
لا ينفّذ `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,...>` مستوى أحد الفحوصات إلى تحذير (`!`)
من دون إخفائه.
قم بتشغيل التشغيل الجاف للقطع الحقيقي بينما لا يزال تجميد الإصدار 3.9.0 مفتوحًا — يتم إنشاء الفروع بعد العلامة وقبل أن ترفع المرحلة 12ج التجميد.
شغّل التشغيل التجريبي للاقتطاع الفعلي بينما لا يزال تجميد إصدار 3.9.0 مفتوحًا — إذ تُنشأ الفروع
بعد الوسم وقبل أن ترفع المرحلة 12c التجميد.
### 3.8.58 بروفة (شوكة فقط)
### تجربة 3.8.58 (على نسخة متفرعة فقط)
```bash
# 1. Dry-run on the current tip with rehearsal parameters
# 1. التشغيل التجريبي على القمة الحالية باستخدام معاملات التجربة
npm run release:dry-run-lts-cut -- --target-version 3.8.58 --previous-tag v3.8.57 \
--advisory freeze,base-green
# 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)
# 2. التنفيذ مقابل وحدة تحكم بعيدة لنسخة متفرعة (يُرفض origin أو أي وحدة تحكم بعيدة يكون عنوان URL الخاص بها
# هو المستودع الأساسي؛ وتطلب كل خطوة تأكيدًا في الطرفية)
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. Exercise the dormant workflows in the fork (workflow_dispatch where the dry-run
# reports a canonical-repository pin), then roll back
# 3. اختبار مسارات العمل الخاملة في النسخة المتفرعة (workflow_dispatch عندما يُبلغ التشغيل التجريبي
# عن تثبيت على المستودع الأساسي)، ثم التراجع
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
```
تم إنشاء التزام تطوير العثرة باستخدام 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 — التي تتدرب على تلك الموجودة في الحزمة المؤقتة.
يُنشأ التزام رفع إصدار 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 مطلقًا — اختبرها على حزمة مؤقتة.
### قطعة معاينة PR (يتم إنشاؤها مرة واحدة، والترويج لنفس البايتات)
### أداة معاينة PR (أنشئها مرة واحدة، وروّج البايتات نفسها)
تقوم `.github/workflows/preview-artifact.yml` ببناء كرة قطران إنتاجية واحدة من رأس PR وتتحقق من صحة هذا البناء الدقيق (شريحة #8084 (أ)). نفس المستودع PRs فقط؛ لم يتم نشر أي شيء.
ينشئ `.github/workflows/preview-artifact.yml` حزمة tarball إنتاجية واحدة من رأس PR
ويتحقق من ذلك البناء نفسه (#8084، الشريحة (a)). يقتصر ذلك على طلبات PR من المستودع نفسه؛ ولا يُنشر أي شيء.
```bash
gh workflow run preview-artifact.yml -f pr_number=<N> # or add the `preview-artifact` label
gh workflow run preview-artifact.yml -f pr_number=<N> # أو أضف التسمية `preview-artifact`
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
npm install -g ./omniroute-*.tgz # تثبيت المعاينة
```
يقوم التشغيل بإجراء `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 في مهمة منفصلة. الترويج للمعاينة يعني تثبيت كرة القطران هذه: لا تقم أبدًا بإعادة البناء من المصدر.
ينفّذ التشغيل `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 تلك: لا تُعِد البناء من المصدر مطلقًا.
### القطع (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`. لإعادة استخدام التزام التطوير الذي تمت مراجعته، قم بإجراء بروفة `--execute` على الطرف 3.9.0 مقابل شوكتك أولاً؛ يطبع كلاً من SHAs، ويمكن دفع نفس الالتزامات:
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، ويمكن
دفع الالتزامين نفسيهما:
```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` (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`.
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`.
---

View File

@@ -140,22 +140,34 @@ CPU من دون مهمة مرتبطة بها. تحتوي كل وحدة OmniRoute
tmpfs مدة 27–32 دقيقة، بينما استغرق رفعه من القرص دقيقتين.
- خادم VPS ذو اللاحقة `.15` مخصص للاختبارات التمهيدية فقط — ولا يشغّل مشغّلات CI أبدًا.
## المسار المستضاف (المتسابقون المستضافون على GitHub)
## المسار المستضاف (مشغّلات مستضافة على GitHub)
المستودع تابع لمنظمة `cheaper-inference` ، على** فريق** يخطط:** 60 وظيفة مستضافة متزامنة** ، يتم مشاركتها بواسطة كل مستودع في المؤسسة، وكل فحص PR ، وكل سير عمل يتم تشغيله بالدفع، والإعداد الافتراضي لـ CodeQL. تم قياس الأرقام أدناه على** برو** الخطة (40 وظيفة مستضافة متزامنة). تم القياس بتاريخ 18-10-2026 أثناء حملة الدمج (~ 10 merges/hour على `release/v3.8.52`):** تم إنشاء 2500 عملية سير عمل خلال 24 ساعة** ، 44 دفعة إلى الفرع خلال 6 ساعات،** 106 وظيفة مستضافة في قائمة الانتظار** بينما انتظرت شيكات PR لساعات وتم دمج PRs بدونها. تم إطلاق تسعة مسارات عمل في كل دفعة إلى الفرع:
ينتمي المستودع إلى مؤسسة `cheaper-inference`، ضمن خطة **Team**: **60 مهمة مستضافة متزامنة**، تتشاركها جميع مستودعات المؤسسة
وجميع عمليات التحقق من طلبات السحب، وكل سير عمل يُشغَّل عند الدفع، والإعداد الافتراضي لـ CodeQL. قيست الأرقام أدناه
ضمن خطة **Pro** (40 مهمة مستضافة متزامنة). أظهرت القياسات في 2026-10-18 أثناء
حملة دمج (نحو 10 عمليات دمج/ساعة على `release/v3.8.52`) أنه تم إنشاء **2,500 تشغيل لسير العمل خلال
24 ساعة**، مع 44 عملية دفع إلى الفرع خلال 6 ساعات، ووجود **106 مهام مستضافة في قائمة الانتظار** بينما انتظرت عمليات التحقق من طلبات السحب
لساعات، ودُمجت طلبات السحب من دونها. كانت تسعة تدفقات عمل تُشغَّل عند كل عملية دفع إلى الفرع:
| لكل دفعة إلى `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` مسح أي شيء هنا |
| لكل عملية دفع إلى `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` أي شيء هنا |
`tests/unit/build/push-storm-diet.test.ts` دبابيس `main` -only دفع الزناد من `ci.yml` و `quality.yml`. التأثير الجانبي: لم يعد Codecov يتلقى تحميلًا أساسيًا لكل دفعة إصدار (الخطوة إعلامية و `continue-on-error`)؛ ولا تتأثر بوابة التغطية داخل الريبو وتعليق PR.
يثبّت `tests/unit/build/push-storm-diet.test.ts` مشغّل الدفع الخاص بفرع `main` فقط في `ci.yml` و
`quality.yml`. أثر جانبي: لم يعد Codecov يتلقى رفعًا أساسيًا عند كل عملية دفع إلى فرع إصدار (هذه
الخطوة معلوماتية وتستخدم `continue-on-error`)؛ ولا تتأثر بوابة التغطية داخل المستودع ولا تعليق طلب السحب.
**المزيد من السعة ذاتية الاستضافة لا تؤدي إلى إصلاح قائمة الانتظار المستضافة.** يمكن لـ 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 أعلاه موجودة.
**لا تؤدي زيادة السعة ذاتية الاستضافة إلى حل مشكلة قائمة انتظار المهام المستضافة.** يمكن لجهاز التطوير
(`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` بحسب الملفات التي يقرأها.

View File

@@ -26,11 +26,9 @@ 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. 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.
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.
Dequeue sonra, bir təkan həmişə PR requeue deyil. Bu barədə `@mergifyio queue` şərh edin.
@@ -42,11 +40,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 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.
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.
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.
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.
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.
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.
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.
@@ -65,7 +63,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ı, 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.
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.
### İş: `lint`
@@ -75,11 +73,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ı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: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: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ü 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: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: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 |
@@ -90,8 +88,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ı 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: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: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 |
@@ -156,8 +154,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()` 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: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: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 |
@@ -211,7 +209,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ə 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.
- `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.
- `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`):
@@ -227,14 +225,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 / çatışmayan 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 / itkin 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.
@@ -248,7 +246,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. 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:
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:
- `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;
@@ -269,7 +267,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 (ə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`).
Ə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`).
### İş: `i18n`
@@ -308,7 +306,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 zolağı — üzərində Stryker mutasiya sınağı balı sağ qalan mutantların zəif təsdiqini göstərir. | **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-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`).

View File

@@ -42,23 +42,26 @@ 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.
## Dondurmanı buraxın (paralel dövrlər)
## Buraxılışın dondurulması (paralel dövrlə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** :
Buraxılış uyğunlaşdırılarkən `release-freeze` etiketli marker məsələ açılır.
Bu, **inkişafı dayandırmır**:
- 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.
- 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**.
İstədiyiniz filialın birləşdirilə biləcəyini fərz etməzdən əvvəl açıq donma olub olmadığını yoxlayın:
İ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:
```bash
gh issue list --repo diegosouzapw/OmniRoute --label release-freeze --state open
```
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.
Birləşdirmə mexanizmləri (sahibin `queue` etiketi → Mergify)
[MERGE_TRAIN.md](./MERGE_TRAIN.md) sənədində təsvir edilib.
## Nə üçün həm budaq, həm də teq var?

View File

@@ -4,9 +4,8 @@
---
> **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.
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.
## Standart yol: Mergify növbəsi

View File

@@ -386,70 +386,109 @@ Embedded services dəyişikliklərini ehtiva edən hər hansı buraxılışı ya
---
## 3.9.0 LTS kəsmə (3.8.58-də məşq edilmişdir)
## 3.9.0 LTS kəsimi (3.8.58-də məşq edilib)
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.
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.
### Dry run (yalnız oxumaq üçün, istənilən vaxt təhlükəsizdir)
### Sınaq icrası (yalnız oxuma, istənilən vaxt təhlükəsiz)
```bash
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
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ə
```
`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.
`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.
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.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.8.58 məşq (yalnız çəngəl)
### 3.8.58 məşqi (yalnız fork)
```bash
# 1. Dry-run on the current tip with rehearsal parameters
# 1. Məşq parametrləri ilə cari tip üzərində sınaq icrası
npm run release:dry-run-lts-cut -- --target-version 3.8.58 --previous-tag v3.8.57 \
--advisory freeze,base-green
# 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)
# 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)
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. Exercise the dormant workflows in the fork (workflow_dispatch where the dry-run
# reports a canonical-repository pin), then roll back
# 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
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
```
İ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.
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.
### PR önizləmə artefaktı (bir dəfə qurun, eyni baytları təşviq edin)
### PR önizləmə artefaktı (bir dəfə qurun, eyni baytları yayımlayın)
`.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.
`.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.
```bash
gh workflow run preview-artifact.yml -f pr_number=<N> # or add the `preview-artifact` label
gh workflow run preview-artifact.yml -f pr_number=<N> # və ya `preview-artifact` etiketini əlavə edin
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
npm install -g ./omniroute-*.tgz # önizləmə quraşdırması
```
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.
İ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.
### Kəsmə (3.9.0, GO dan sonra)
### Kəsim (3.9.0, GO-dan sonra)
1. GO [LTS_GO_NO_GO-da qeydə alınmışdır .md](./LTS_GO_NO_GO.md).
1. GO [LTS_GO_NO_GO.md](./LTS_GO_NO_GO.md) faylında qeyd edilir.
2. `npm run release:dry-run-lts-cut -- --from v3.9.0` `RESULT: READY` çap edir.
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:
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:
```bash
git push origin <stable-sha>:refs/heads/stable/v3 <develop-sha>:refs/heads/develop
```
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`.
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`.
---

View File

@@ -134,22 +134,35 @@ 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.
## Hosted zolaq (GitHub-a ev sahibliyi edən qaçışçılar)
## Host edilən zolaq (GitHub tərəfindən host edilən icraçılar)
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ı:
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ü:
| `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 |
| `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 |
`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.
`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.
**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.
**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.

View File

@@ -25,12 +25,10 @@
Обикновен 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.
@@ -57,56 +55,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` трейлър или 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`, тъй като файл, който го използва, не отчита никаква диагностика и иначе би бил невидим за всеки портал. | да |
| Скрипт (`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`, тъй като файл, който го използва, не отчита никаква диагностика и иначе би бил невидим за всеки портал. | да |
#### Две програми за проверка на типа отговарят по различен начин
@@ -168,16 +166,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`
@@ -191,10 +189,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 вече преценения порт един по един.
@@ -243,21 +241,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.
Два начина да го задоволите:
@@ -272,11 +270,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 матрица за валидиране (едно задание на локал). Цялата работа е консултативна.
| Скрипт | Валидира | Блокиране |
| ------------------------------- | --------------------------------- | -------------------------------------------------------------- |
@@ -296,10 +294,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`; нови провали провалят работата |
### Нощни работни процеси (планирани, консултативни)

View File

@@ -4,9 +4,14 @@
---
OmniRoute използва a** паралелен цикъл** модел на освобождаване: специален `release/vX.Y.Z` клон за активния цикъл, `main` за публикувания ред и неизменен `vX.Y.Z` етикет, когато този цикъл бъде изпратен. Виждайки, че ангажиментите кацат на `release/*` _и_ на `main` се очаква — а не объркване.
OmniRoute използва модел за издания с **паралелни цикли**: специален клон `release/vX.Y.Z`
за активния цикъл, `main` за публикуваната линия и неизменяем таг
`vX.Y.Z` при публикуването на съответния цикъл. Нормално е комити да попадат както в `release/*`, _така и_ в
`main` — това не е грешка.
Подробностите за поддържащия се намират в `CLAUDE.md` (Hard Rule #21) и [RELEASE_CHECKLIST.md](./RELEASE_CHECKLIST.md). Тази страница е обобщението за публичните сътрудници.
Подробностите за поддържащите проекта се намират в `CLAUDE.md` (Строго правило №21) и
[RELEASE_CHECKLIST.md](./RELEASE_CHECKLIST.md). Тази страница представлява публичното
обобщение за сътрудниците.
## Накратко
@@ -37,23 +42,25 @@ flowchart LR
`main` не е клонът за ежедневна интеграция. PR-ите, отворени към `main`,
обикновено трябва да бъдат пренасочени преди сливане.
## Освобождаване на замразяване (паралелни цикли)
## Замразяване на издание (паралелни цикли)
Когато дадено издание се съгласува, се отваря проблем с маркер, обозначен като `release-freeze`. това** не спира развитието** :
Когато се извършва съгласуване на дадено издание, се отваря маркерен issue с етикет `release-freeze`.
Това **не спира разработката**:
- Замразеният `release/vX.Y.Z` принадлежи на капитана за освобождаване на този кораб.
- `release/vX+1` на следващия цикъл се изрязва от замразения връх, така че участниците да продължат да работят.
- Трябва да се отвори PRs, който все още е насочен към замразения клон** пренасочени** към активния (най-висок) `release/v*` клон.
- Замразеният `release/vX.Y.Z` е под контрола на отговорника за съответното издание.
- `release/vX+1` за следващия цикъл се създава от замразения връх, за да могат сътрудниците да продължат
да добавят промени.
- Отворените PR-и, които все още са насочени към замразения клон, трябва да бъдат **пренасочени** към
активния клон `release/v*` с най-висока версия.
Проверете за отворено замразяване, преди да приемете, че клонът, който искате, може да се слее:
Проверете за активно замразяване, преди да приемете, че желаният от вас клон може да бъде сливан:
```bash
gh issue list --repo diegosouzapw/OmniRoute --label release-freeze --state open
```
Механиката на сливане (собственик `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` вече не обединява нищо.
Механизмът за сливане (етикет `queue` от собственика → Mergify) е документиран в
[MERGE_TRAIN.md](./MERGE_TRAIN.md).
## Защо има и клон, и таг?

View File

@@ -4,9 +4,10 @@
---
> **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 някога се промени.
От v3.8.49 (WS3.2/WS3.4 от плана за качество/скорост) пътят по подразбиране за сливане на
прегледани PR-и в `release/vX.Y.Z` е **опашката за сливане на Mergify** (`.mergify.yml`);
документираният по-долу **ръчен влак за сливания** е РЕЗЕРВНИЯТ ВАРИАНТ — използван при инциденти,
замразяване на издания или ако планът Mergify Open Source някога се промени.
## Път по подразбиране: опашката на Mergify

View File

@@ -355,70 +355,111 @@ npm run build:release
---
## 3.9.0 LTS cut (репетирано в 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`). 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).
След 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).
### Суха работа (само за четене, безопасно по всяко време)
### Пробно изпълнение (само за четене, безопасно по всяко време)
```bash
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
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
```
`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,...>` понижава проверката до предупреждение (`!`), без да я крие.
`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,...>` понижава проверка до предупреждение (`!`),
без да я скрива.
Изпълнете сухото изпълнение на истинското изрязване, докато замразяването на версията 3.9.0 все още е отворено — разклоненията се създават след етикета и преди фаза 12c да премахне замразяването.
Изпълнете пробното изпълнение на реалното отделяне, докато замразяването на release-а за 3.9.0 все още е активно — клоновете се
създават след тага и преди Фаза 12c да отмени замразяването.
### 3.8.58 репетиция (само вилица)
### Репетиция с 3.8.58 (само във fork)
```bash
# 1. Dry-run on the current tip with rehearsal parameters
# 1. Пробно изпълнение върху текущия връх с параметри за репетицията
npm run release:dry-run-lts-cut -- --target-version 3.8.58 --previous-tag v3.8.57 \
--advisory freeze,base-green
# 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)
# 2. Изпълнение спрямо отдалечен FORK (origin или всеки remote, чийто URL е на каноничното
# хранилище, се отказва; всяка стъпка изисква потвърждение в терминала)
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. Exercise the dormant workflows in the fork (workflow_dispatch where the dry-run
# reports a canonical-repository pin), then roll back
# 3. Изпробване на неактивните workflow-и във fork-а (workflow_dispatch там, където пробното изпълнение
# отчита фиксиране към каноничното хранилище), след което връщане назад
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
```
Комитът за разработка на бум е изграден с 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 тези на скреч пакет.
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-ове — репетирайте ги с тестов пакет.
### PR артефакт за предварителен преглед (изграждане веднъж, насърчаване на същите байтове)
### Артефакт за предварителен преглед на PR (изграждане веднъж, повишаване на същите байтове)
`.github/workflows/preview-artifact.yml` изгражда един производствен архив от PR глава и валидира тази точна компилация (#8084 срез (a)). Същото хранилище само PRs ; нищо не се публикува.
`.github/workflows/preview-artifact.yml` изгражда един production tarball от върха на PR и
валидира точно тази компилация (част (a) от #8084). Само за PR-и от същото хранилище; нищо не се публикува.
```bash
gh workflow run preview-artifact.yml -f pr_number=<N> # or add the `preview-artifact` label
gh workflow run preview-artifact.yml -f pr_number=<N> # или добавете етикета `preview-artifact`
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
npm install -g ./omniroute-*.tgz # инсталиране на предварителния преглед
```
Изпълнението прави `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: никога не изграждайте отново от източника.
Изпълнението стартира `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: никога не изграждайте повторно от изходния код.
### Изрязването (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`. За да използвате повторно прегледан ангажимент за разработка, първо изпълнете `--execute` репетицията на върха 3.9.0 срещу вашата вилица; той отпечатва както SHAs, така и същите ангажименти могат да бъдат насочени:
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-и могат да бъдат изпратени:
```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` (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`.
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`.
---

View File

@@ -137,22 +137,36 @@ CPU без прикачена задача. Всеки unit на OmniRoute съ
минути на tmpfs и се качваше от диска за 2 минути.
- VPS машината `.15` е само за homologation — на нея никога не се изпълняват CI runner-и.
## Хоствана лента (хоствани от GitHub бегачи)
## Хостван канал (изпълнители, хоствани от GitHub)
Хранилището принадлежи на организацията `cheaper-inference`, на** Екип** план:** 60 едновременно хоствани работни места** , споделено от всяко хранилище в организацията, всяка проверка PR, всеки работен процес, задействан чрез натискане, и настройката по подразбиране на CodeQL. Цифрите по-долу са измерени на** Професионалист** план (40 едновременно хоствани работни места). Измерено на 2026-10-18 по време на кампания за сливане (~ 10 merges/hour на `release/v3.8.52`):** 2500 стартирания на работния процес, създадени за 24 часа** , 44 натискания до клона за 6 часа,** 106 хоствани задания са на опашка** докато PR проверките чакаха с часове и PRs бяха обединени без тях. Девет работни потока, задействани при всяко натискане към клона:
Хранилището принадлежи на организацията `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 операция към клона се задействаха девет работни процеса:
| на натискане към `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` сканира нищо тук |
| при всяка 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` не сканират нищо тук |
`tests/unit/build/push-storm-diet.test.ts` закрепва `main` -only push тригера на `ci.yml` и `quality.yml`. Страничен ефект: Codecov вече не получава базово качване на освобождаване (стъпката е информационна и `continue-on-error`); вратата за покритие в репо и PR коментарът не са засегнати.
`tests/unit/build/push-storm-diet.test.ts` фиксира задействането само при push към `main` за `ci.yml` и
`quality.yml`. Страничен ефект: Codecov вече не получава базово качване при всяка push операция към release клон (стъпката
е само информативна и е с `continue-on-error`); вградената в хранилището проверка на покритието и коментарът в PR
не са засегнати.
**Повече самостоятелно хостван капацитет не коригира хостваната опашка.** 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 по-горе вече не съществува.
**Повече собствен хостван капацитет не решава проблема с опашката за хоствани задачи.** Машината за разработка
(`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` да се филтрира според файловете, които чете.

View File

@@ -29,8 +29,6 @@ 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 করে।
@@ -47,9 +45,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` ব্যবহার করে নির্বাচিত উপনামগুলি কার্যকর না করেই পরিদর্শন করুন৷ রানার npm এন্ট্রিপয়েন্টকে আহ্বান করে, তাই এর রানটাইম (যেখানে কনফিগার করা Bun সহ) সংরক্ষিত থাকে। ম্যানিফেস্ট সেই প্রোফাইলগুলির বাইরের উপনামগুলিকে আলাদাভাবে আহ্বান করা হিসাবে রেকর্ড করে, এবং রক্ষণাবেক্ষণ আদেশগুলি শুধুমাত্র-পঠনযোগ্য স্ক্যান প্রোফাইলগুলিতে নিষিদ্ধ৷
`npm run quality:scan -- --list` বা `npm run quality:scan:fast -- --list` ব্যবহার করে নির্বাচিত উপনামগুলি নির্বাহ না করেই পরিদর্শন করুন৷ রানার এনপিএম এন্ট্রিপয়েন্টকে আহ্বান করে, তাই এর রানটাইম (যেখানে কনফিগার করা 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`।
@@ -57,18 +55,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`
@@ -82,7 +80,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 এবং ব্লক; প্রতি-স্কোপ লক হ্যাশ এবং রিপোর্ট বজায় রাখা হয়। | হ্যাঁ |
@@ -92,7 +90,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) | হ্যাঁ |
@@ -110,11 +108,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`
@@ -123,7 +121,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` ধাপ হিসেবে একত্রিত হয় | হ্যাঁ |
@@ -143,28 +141,28 @@ Mergify খসড়ার বিবরণে তার সারির সা
| `check:bundle-size` | বান্ডিল আকার ক্যাপ অতিক্রম না; একটি পরিমাপযোগ্য আকারও ব্যর্থ হয় | **--ratchet দিয়ে ব্লক করা** |
| `check:secrets` | বাইনারি অনুপস্থিত থাকলে সিক্রেট স্ক্যানিং (gitleaks) — এড়িয়ে যায় | **--ratchet দিয়ে ব্লক করা** |
| `check:vuln-ratchet` | নির্ভরতা দুর্বলতা (ওএসভি-স্ক্যানার) — `--ratchet` INCOMPLETE হিসাবে ব্যর্থ হয় না (প্রস্থান 2) যদি পরিমাপ না করা হয় | **--ratchet দিয়ে ব্লক করা** |
| `check:workflows` | কর্মপ্রবাহ লিন্ট (অ্যাকশনলিন্ট + zizmor); missing/broken স্ক্যানার, অবৈধ রিপোর্ট বা অনুপস্থিত র্যাচেট বেসলাইন INCOMPLETE হিসাবে ব্যর্থ হয়। বৈধ ফলাফল নির্বাচিত strict/advisory/ratchet নীতি অনুসরণ করে | মৃত্যুদন্ড প্রয়োজন; CI তে zizmor ratchet ব্লক করা |
| `check:workflows` | কর্মপ্রবাহ লিন্ট (অ্যাকশনলিন্ট + zizmor); missing/broken স্ক্যানার, অবৈধ রিপোর্ট বা অনুপস্থিত ratchet বেসলাইন 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 মোড বনাম রিলিজ মোড)
@@ -172,16 +170,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`);
@@ -204,7 +202,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` চালায় (কঠোর দৃষ্টিভঙ্গি, কখনই বেস-লাল খোলে না) |
@@ -239,7 +237,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` দিয়ে বৈশিষ্ট্য-পিআর রায়ের পূর্বরূপ দেখুন।
@@ -251,13 +249,13 @@ npm run release:refresh-derived -- --check # what the rele
একটি i18n রিগ্রেশন ক্যাচ করে যা অন্য গেটগুলি কাঠামোগতভাবে দেখতে পায় না: একটি ইংরেজি মান পুনরায় লেখা হয় এবং _আগের_ ইংরেজি থেকে প্রাপ্ত অনুবাদগুলি পিছনে থাকে, তাই অ-ইংরেজি ব্যবহারকারীরা আত্মবিশ্বাসের সাথে-শব্দযুক্ত, এখন-ভুল অনুলিপি পড়তে থাকে।
এই বাস্তব জন্য পাঠানো হয়েছে. `oauthModal.googleOAuthWarning` পুনরায় লেখা হয়েছিল যখন Antigravity লগইন হেল্পার (#5203);** 43টির মধ্যে 39টি লোকেল** টেক্সট অপারেটরদের "সম্পূর্ণ URL অনুলিপি করুন এবং এটি নীচে পেস্ট করুন" — একটি প্রবাহ যা সেই প্রদানকারীর জন্য সম্পূর্ণ করতে পারে না। এটি #8463 পর্যন্ত অলক্ষিত ছিল কারণ:
এই বাস্তব জন্য পাঠানো হয়েছে. অ্যান্টিগ্র্যাভিটি লগইন হেল্পার যখন অবতরণ করে তখন `oauthModal.googleOAuthWarning` পুনরায় লেখা হয়েছিল (#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 এ মন্থন।
এটি সন্তুষ্ট করার দুটি উপায়:
@@ -311,10 +309,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`) দেখুন।
---

View File

@@ -43,21 +43,23 @@ flowchart LR
## রিলিজ ফ্রিজ (সমান্তরাল চক্র)
যখন একটি রিলিজ মিলিত হয়, তখন `release-freeze` লেবেলযুক্ত একটি মার্কার সমস্যা খোলা হয়। যে** উন্নয়ন বন্ধ করে না** :
কোনো রিলিজ সমন্বয় করার সময় `release-freeze` লেবেলযুক্ত একটি মার্কার ইস্যু
খোলা হয়। এটি **ডেভেলপমেন্ট বন্ধ করে না**:
- হিমায়িত `release/vX.Y.Z` সেই জাহাজের রিলিজ ক্যাপ্টেনের অন্তর্গত।
- পরবর্তী চক্রের `release/vX+1` হিমায়িত ডগা থেকে কাটা হয় যাতে অবদানকারীরা অবতরণ কাজ চালিয়ে যান।
- খোলা PRs যে এখনও হিমায়িত শাখা লক্ষ্য করা উচিত** retargeted** সক্রিয় (সর্বোচ্চ) `release/v*` শাখায়।
- স্থির করা `release/vX.Y.Z` সেই প্রকাশের রিলিজ ক্যাপ্টেনের নিয়ন্ত্রণে থাকে।
- পরবর্তী চক্রের `release/vX+1` স্থির করা সর্বশেষ প্রান্ত থেকে তৈরি করা হয়, যাতে কন্ট্রিবিউটররা
কাজ যুক্ত করা চালিয়ে যেতে পারেন।
- যেসব খোলা PR এখনও স্থির করা ব্রাঞ্চকে লক্ষ্য করে, সেগুলোকে **পুনরায় লক্ষ্য নির্ধারণ** করে
সক্রিয় (সর্বোচ্চ) `release/v*` ব্রাঞ্চে নিতে হবে।
আপনি যে শাখাটি একত্রিত করতে চান তা অনুমান করার আগে একটি খোলা ফ্রিজের জন্য পরীক্ষা করুন:
আপনার কাঙ্ক্ষিত ব্রাঞ্চটি মার্জযোগ্য ধরে নেওয়ার আগে কোনো খোলা ফ্রিজ আছে কি না পরীক্ষা করুন:
```bash
gh issue list --repo diegosouzapw/OmniRoute --label release-freeze --state open
```
মার্জ মেকানিক্স (মালিক `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` লেবেল আর কিছু মার্জ করে না।
মার্জের প্রক্রিয়া (মালিকের `queue` লেবেল → Mergify) সম্পর্কে
[MERGE_TRAIN.md](./MERGE_TRAIN.md)-এ নথিভুক্ত করা হয়েছে।
## ব্রাঞ্চ এবং ট্যাগ—দুটিই কেন?

View File

@@ -4,9 +4,10 @@
---
> **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 — নীচে নথিভুক্ত করা হয়েছে।
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 প্ল্যান কখনও পরিবর্তিত হলে ব্যবহৃত হয়।
## ডিফল্ট পথ: Mergify কিউ

View File

@@ -394,70 +394,106 @@ Radar ঘোষণা ইচ্ছাকৃতভাবে `active: false` স
---
## 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`)। 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) সাথে বন্ধ হয়।
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) দিয়ে সমাপ্ত হয়।
### ড্রাই-রান (কেবল-পঠন, যেকোনো সময় নিরাপদ)
### Dry-run (শুধু-পঠন, যেকোনো সময় নিরাপদ)
```bash
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
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 নির্দিষ্ট করুন
```
`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.
`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 (`!`)-এ
নামিয়ে দেয়, কিন্তু সেটি আড়াল করে না।
রিয়েল কাটের ড্রাই-রান চালান যখন 3.9.0 রিলিজ ফ্রিজ এখনও খোলা থাকে — ট্যাগের পরে এবং ফেজ 12c ফ্রিজ তুলে নেওয়ার আগে শাখাগুলি তৈরি হয়।
3.9.0 release freeze এখনও খোলা থাকতেই প্রকৃত cut-এর dry-run চালান — tag তৈরির
পরে এবং Phase 12c freeze তুলে নেওয়ার আগে branch-গুলো তৈরি হয়।
### 3.8.58 রিহার্সাল (শুধুমাত্র কাঁটা)
### 3.8.58 মহড়া (শুধু fork-এ)
```bash
# 1. Dry-run on the current tip with rehearsal parameters
# ১. মহড়ার parameter ব্যবহার করে বর্তমান tip-এ dry-run
npm run release:dry-run-lts-cut -- --target-version 3.8.58 --previous-tag v3.8.57 \
--advisory freeze,base-green
# 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)
# ২. একটি FORK remote-এর বিরুদ্ধে execute করুন (origin, অথবা যার URL canonical
# repository, প্রত্যাখ্যাত হবে; প্রতিটি step terminal-এ confirmation চাইবে)
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. Exercise the dormant workflows in the fork (workflow_dispatch where the dry-run
# reports a canonical-repository pin), then roll back
# ৩. fork-এ dormant workflow-গুলো চালান (যেখানে dry-run canonical-repository pin
# রিপোর্ট করে সেখানে workflow_dispatch ব্যবহার করুন), তারপর rollback করুন
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
```
ডেভেলপ বাম্প কমিট গিট প্লাম্বিং দিয়ে তৈরি করা হয়েছে (কোনও কাজের গাছকে স্পর্শ করা হয়নি) এবং সাইকেল-ওপেন কমিট হিসাবে একই পাঁচটি ফাইল বাম্প করে: `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 — রিহার্সেল স্ক্রিপ্ট কখনই পরিবর্তন করে না।
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-এ
মহড়া করুন।
### PR প্রিভিউ আর্টিফ্যাক্ট (একবার তৈরি করুন, একই বাইট প্রচার করুন)
### PR preview artifact (একবার build করুন, একই bytes promote করুন)
`.github/workflows/preview-artifact.yml` একটি PR হেড থেকে একটি প্রোডাকশন টারবল তৈরি করে এবং সঠিক বিল্ড (#8084 স্লাইস (a)) যাচাই করে। একই-রিপোজিটরি PRs শুধুমাত্র; কিছুই প্রকাশিত হয় না।
`.github/workflows/preview-artifact.yml` একটি PR head থেকে একটি production tarball build করে এবং
সেই exact build-টি validate করে (#8084 slice (a))। শুধু একই repository-র PR; কিছু publish করা হয় না।
```bash
gh workflow run preview-artifact.yml -f pr_number=<N> # or add the `preview-artifact` label
gh workflow run preview-artifact.yml -f pr_number=<N> # অথবা `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
```
রান `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`) এবং একটি পৃথক কাজে টারবলকে সত্যায়িত করে। একটি পূর্বরূপ প্রচার করার অর্থ হল সেই টারবল ইনস্টল করা: উত্স থেকে কখনও পুনর্নির্মাণ করবেন না৷
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 করবেন না।
### কাট (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` তে শাখা তৈরি করুন। রিভিউ করা ডেভেলপ কমিট পুনরায় ব্যবহার করতে, প্রথমে আপনার ফর্কের বিপরীতে 3.9.0 টিপে `--execute` রিহার্সাল চালান; এটি উভয় SHAs প্রিন্ট করে, এবং একই কমিটগুলিকে ধাক্কা দেওয়া যেতে পারে:
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 করা যায়:
```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` (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`।
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`।
---

View File

@@ -137,20 +137,33 @@ check এবং restart একই command-এ রাখুন।
## হোস্টেড লেন (GitHub-হোস্টেড রানার)
ভান্ডারটি `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 তাদের ছাড়াই একত্রিত হয়েছিল৷ শাখায় প্রতিটি ধাক্কায় নয়টি কর্মপ্রবাহ গুলি করা হয়েছে:
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 চালু হতো:
| `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` এখানে কিছুই স্ক্যান করবেন না |
| `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 করে না |
`tests/unit/build/push-storm-diet.test.ts` `ci.yml` এবং `quality.yml` এর `main` -only পুশ ট্রিগার পিন করে। পার্শ্ব প্রতিক্রিয়া: কোডকভ আর রিলিজ পুশ প্রতি একটি বেস আপলোড পায় না (পদক্ষেপটি তথ্যমূলক এবং `continue-on-error`); ইন-রেপো কভারেজ গেট এবং PR মন্তব্য প্রভাবিত হয় না।
`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 প্রভাবিত হয় না।
**বেশি স্ব-হোস্টেড ক্ষমতা হোস্ট করা সারি ঠিক করে না।** ডেভবক্স (`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 লিভারটি আর বিদ্যমান নেই।
**আরও 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 করুন।

View File

@@ -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 stapanje grupe koriste hostovane runnere 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 grupe spajanja koriste hostovane trkače 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,8 +31,6 @@ 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.
@@ -41,7 +39,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 i dalje koristi sjenčane postavke, a ne priznanice stvarne izrade, paketa, pokretanja ili promocije.
`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.
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.
@@ -91,7 +89,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 `commit-msg` op off PRs — i korak samo za PR `main` `ci.yml` PR→#14436 koautori; |
| `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: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 |
@@ -106,7 +104,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 stranicama 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 lokacijama 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 |
@@ -234,7 +232,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 ključna pokrivenost je ≥ 65% | Da (oba načina) |
| `check-ui-keys-coverage` (inline) | UI i18n pokrivenost ključem 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) |
@@ -249,11 +247,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 gate
#### `check-ui-value-drift` — stale-translation kapija
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 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:
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:
- `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;
@@ -266,7 +264,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 koji se koristio #8463.
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.
```bash
npm run i18n:check-value-drift # strict (what CI runs)
@@ -278,15 +276,15 @@ Izlazi iz 0 sa `SKIP reason=base-unresolved` kada se osnovni katalog ne može pr
### Posao: `i18n`
Potpuna i18n matrica valjanosti (jedan posao po lokalizaciji). Cijeli posao je savjetodavan.
Potpuna i18n matrica validacije (jedan posao po lokalizaciji). Cijeli posao je savjetodavan.
| Skripta | Validates | Blokiranje |
| ------------------------------- | ----------------------------------- | ------------------------------------------------------------- |
| `validate_translation.py quick` | Kompletnost prijevoda po lokalitetu | **Savjetodavno** (`continue-on-error: true` na cijelom poslu) |
| Skripta | Validates | Blokiranje |
| ------------------------------- | ------------------------------------- | ------------------------------------------------------------- |
| `validate_translation.py quick` | Kompletnost prijevoda po lokalizaciji | **Savjetodavno** (`continue-on-error: true` na cijelom poslu) |
### Posao: `pr-test-policy`
Radi samo na zahtjevima za povlačenjem.
Radi samo na zahtjevima za povlačenje.
| Skripta | Validates | Blokiranje |
| ---------------------- | ------------------------------------------------------------------------------------------------------------------------------------- | ---------- |

View File

@@ -37,23 +37,21 @@ flowchart LR
`main` nije grana za svakodnevnu integraciju. PR-ovi otvoreni prema `main` obično zahtijevaju promjenu ciljane grane prije spajanja.
## Pusti zamrzavanje (paralelni ciklusi)
## Zamrzavanje izdanja (paralelni ciklusi)
Kada se izdanje usaglašava, otvara se problem markera označen `release-freeze`. To** ne zaustavlja razvoj** :
Kada se izdanje usklađuje, otvara se marker issue sa oznakom `release-freeze`. To **ne zaustavlja razvoj**:
- 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.
- 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.
Provjerite postoji li otvoreno zamrzavanje prije nego pretpostavite da je grana koju želite spojiva:
Provjerite da li postoji otvoreno zamrzavanje prije nego što pretpostavite da je grana koju želite spojiva:
```bash
gh issue list --repo diegosouzapw/OmniRoute --label release-freeze --state open
```
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.
Mehanika spajanja (vlasnik `queue` oznaka → Mergify) je dokumentovana u [MERGE_TRAIN.md](./MERGE_TRAIN.md).
## Zašto i grana i oznaka (tag)?

View File

@@ -4,9 +4,10 @@
---
> **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.
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.
## Zadana putanja: Mergify red čekanja

View File

@@ -355,70 +355,112 @@ Prije objavljivanja bilo kojeg izdanja v3.8.x, provjerite i sljedeće stavke:
---
## 3.9.0 LTS cut (uvježbano u 3.8.58)
## Izdvajanje 3.9.0 LTS-a (uvježbano u 3.8.58)
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).
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).
### Rad na suho (samo za čitanje, siguran u bilo koje vrijeme)
### Probno pokretanje (samo za čitanje, sigurno u bilo kojem trenutku)
```bash
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
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
```
`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.
`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.
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.
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.
### 3.8.58 proba (samo viljuške)
### Proba 3.8.58 (samo fork)
```bash
# 1. Dry-run on the current tip with rehearsal parameters
# 1. Probno pokretanje na trenutnom vrhu s parametrima probe
npm run release:dry-run-lts-cut -- --target-version 3.8.58 --previous-tag v3.8.57 \
--advisory freeze,base-green
# 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)
# 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)
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. Exercise the dormant workflows in the fork (workflow_dispatch where the dry-run
# reports a canonical-repository pin), then roll back
# 3. Isprobaj neaktivne tokove rada u forku (workflow_dispatch tamo gdje probno pokretanje
# prijavi fiksiranje na kanonski repozitorij), a zatim vrati prethodno stanje
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
```
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.
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.
### PR preview artefakt (napravi jednom, promovira iste bajtove)
### Artefakt za pregled PR-a (izgradite jednom, promovirajte iste bajtove)
`.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.
`.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.
```bash
gh workflow run preview-artifact.yml -f pr_number=<N> # or add the `preview-artifact` label
gh workflow run preview-artifact.yml -f pr_number=<N> # ili dodaj oznaku `preview-artifact`
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
npm install -g ./omniroute-*.tgz # instalacija pregleda
```
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.
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.
### Rez (3.9.0, nakon GO)
### Izdvajanje (3.9.0, nakon odluke GO)
1. GO snimljeno u [LTS_GO_NO_GO.md](./LTS_GO_NO_GO.md).
1. Odluka GO zabilježena je 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. 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:
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:
```bash
git push origin <stable-sha>:refs/heads/stable/v3 <develop-sha>:refs/heads/develop
```
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`.
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`.
---

View File

@@ -137,22 +137,36 @@ 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.
## Hostirana traka (trkači hostovani na GitHubu)
## Hostovana traka (izvršioci koje hostuje GitHub)
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:
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:
| 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 |
| 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 |
`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.
`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.
**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.
**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.

View File

@@ -25,12 +25,10 @@ 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ě 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á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.
### 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.
@@ -49,7 +47,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 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.
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.
Skripty fungují pod `scripts/check/` (brány zásad) a `scripts/quality/` (řehtací motor). Zdrojem pravdy CI je `.github/workflows/ci.yml`.
@@ -62,7 +60,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 generovaná synchronizace dovedností | Ano, včetně vidlic |
| `Merge integrity (changelog + generated skills)` | Nenávrh PRs; changelog a vygenerovaná synchronizace dovedností | Ano, včetně vidlic |
#### Zpráva o testech zapomenutého sourozence
@@ -89,7 +87,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 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: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: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 |
@@ -105,7 +103,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; snížit 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; ráčnou dolů 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ě
@@ -114,7 +112,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 – žádné chyby v 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 – jakékoli chyby v tom přísném. Před voláním souboru clean zkontrolujte obojí.
### Práce: `quality-gate`
@@ -185,7 +183,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: 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`.
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`.
Co `check:docs-counts` (`scripts/check/check-docs-counts-sync.mjs`) selže v každém režimu:
@@ -251,7 +249,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í 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í 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:
- `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ý;

View File

@@ -4,9 +4,14 @@
---
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.
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.
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.
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.
## Stručný přehled
@@ -37,23 +42,25 @@ 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.
## Uvolnění zmrazení (paralelní cykly)
## Zmrazení vydání (paralelní cykly)
Při odsouhlasení vydání se otevře problém se značkou označený `release-freeze`. Že** vývoj nezastaví** :
Když probíhá finalizace vydání, otevře se označovací issue se štítkem `release-freeze`.
To **nezastavuje vývoj**:
- 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*`.
- 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*`.
Před předpokladem, že požadovaná větev je slučitelná, zkontrolujte, zda nedošlo k otevřenému zmrazení:
Než budete předpokládat, že lze požadovanou větev slučovat, zkontrolujte, zda není aktivní zmrazení:
```bash
gh issue list --repo diegosouzapw/OmniRoute --label release-freeze --state open
```
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.
Mechanismus slučování (štítek `queue` od vlastníka → Mergify) je zdokumentován v
[MERGE_TRAIN.md](./MERGE_TRAIN.md).
## Proč větev i značka?

View File

@@ -4,22 +4,38 @@
---
> **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.
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.
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í.
## Výchozí cesta: fronta Mergify
## Výchozí cesta: fronta Sloučit
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).
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).
Ochranná pravidla (odpovídají přísným pravidlům č. 21/22 v `CLAUDE.md`):
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`).
- **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áložní postup: ruční merge-train

View File

@@ -355,70 +355,114 @@ Před vydáním jakékoli verze v3.8.x ověřte také následující položky:
---
## 3.9.0 LTS střih (zkoušeno v 3.8.58)
## Vydání 3.9.0 LTS (nacvičeno ve verzi 3.8.58)
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).
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).
### Spuštění nasucho (pouze pro čtení, bezpečné kdykoli)
### Zkušební běh (pouze pro čtení, bezpečný kdykoli)
```bash
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
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
```
`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.
`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.
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ší.
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ší.
### 3.8.58 zkouška (pouze vidlice)
### Nácvik verze 3.8.58 (pouze na forku)
```bash
# 1. Dry-run on the current tip with rehearsal parameters
# 1. Zkušební běh na aktuálním vrcholu s parametry nácviku
npm run release:dry-run-lts-cut -- --target-version 3.8.58 --previous-tag v3.8.57 \
--advisory freeze,base-green
# 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)
# 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)
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. Exercise the dormant workflows in the fork (workflow_dispatch where the dry-run
# reports a canonical-repository pin), then roll back
# 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
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
```
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.
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.
### Artefakt náhledu PR (sestavit jednou, povýšit stejné bajty)
### Artefakt náhledu PR (sestavte jednou, propagujte stejné bajty)
`.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.
`.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.
```bash
gh workflow run preview-artifact.yml -f pr_number=<N> # or add the `preview-artifact` label
gh workflow run preview-artifact.yml -f pr_number=<N> # nebo přidejte štítek `preview-artifact`
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
npm install -g ./omniroute-*.tgz # instalace náhledu
```
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.
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.
### Střih (3.9.0, po GO)
### Vydání (3.9.0, po rozhodnutí GO)
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í:
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:
```bash
git push origin <stable-sha>:refs/heads/stable/v3 <develop-sha>:refs/heads/develop
```
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`.
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`.
---

View File

@@ -130,22 +130,33 @@ 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á dráha (běžci hostovaní na GitHubu)
## Hostovaná kapacita (běhová prostředí hostovaná GitHubem)
Ú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:
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ů:
| 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 |
| 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í |
`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.
`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.
**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.
**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.

View File

@@ -25,12 +25,10 @@ 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 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.
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.
### 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ø.
@@ -74,39 +72,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å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 |
| 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 |
#### To typecheck-programmer svarer forskelligt
@@ -118,7 +116,7 @@ Konsekvensen har betydning, når man skal vurdere, om en fil er maskinskrevet:**
### Job: `quality-gate`
Løber efter `test-coverage`. Blokke smelter sammen ved fejl.
Runs after `test-coverage`. Blokke smelter sammen ved fejl.
| Manuskript | Validerer | Blokering |
| ---------------------------- | ----------------------------------------------------------------------------------------------------------------------------------------------------------------------- | ------------------------- |
@@ -162,7 +160,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 sti i `openapi.yaml` forvandles til en rigtig `route.ts` (anti-hallucination) | Ja |
| `check:openapi-routes` | Hver vej 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 |
@@ -255,7 +253,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 på 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 om 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.
@@ -272,7 +270,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 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`).
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`).
### Job: `i18n`

View File

@@ -4,9 +4,14 @@
---
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.
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.
Vedligeholdelsesdetaljerne findes i `CLAUDE.md` (Hard Rule #21) og [RELEASE_CHECKLIST.md](./RELEASE_CHECKLIST.md). Denne side er den offentlige bidragyder-vendte oversigt.
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.
## Kort fortalt
@@ -37,23 +42,25 @@ 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.
## Frigør fryse (parallelle cyklusser)
## Udgivelsesfrysning (parallelle cyklusser)
Når en udgivelse bliver afstemt, åbnes et markørproblem mærket `release-freeze`. At** stopper ikke udviklingen** :
Når en udgivelse afstemmes, åbnes en markørsag med etiketten `release-freeze`.
Det **stopper ikke udviklingen**:
- 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.
- 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.
Tjek for en åben frysning, før du antager, at den gren, du ønsker, kan flettes:
Kontrollér, om der er en åben frysning, før du antager, at den ønskede gren kan sammenflettes:
```bash
gh issue list --repo diegosouzapw/OmniRoute --label release-freeze --state open
```
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.
Mekanismerne for sammenfletning (ejerens `queue`-etiket → Mergify) er dokumenteret i
[MERGE_TRAIN.md](./MERGE_TRAIN.md).
## Hvorfor både en gren og et tag?

View File

@@ -4,9 +4,10 @@
---
> **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.
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.
## Standardforløb: Mergify-køen

View File

@@ -355,70 +355,111 @@ Før en v3.8.x-udgivelse frigives, skal disse yderligere punkter verificeres:
---
## 3.9.0 LTS cut (øvet i 3.8.58)
## 3.9.0 LTS-udskæring (afprøvet i 3.8.58)
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).
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).
### Tørløb (skrivebeskyttet, sikkert til enhver tid)
### Prøvekørsel (skrivebeskyttet, sikker når som helst)
```bash
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
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
```
`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.
`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.
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.
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.
### 3.8.58 øve (kun gaffel)
### 3.8.58-afprøvning (kun fork)
```bash
# 1. Dry-run on the current tip with rehearsal parameters
# 1. Prøvekørsel på den aktuelle spids med afprøvningsparametre
npm run release:dry-run-lts-cut -- --target-version 3.8.58 --previous-tag v3.8.57 \
--advisory freeze,base-green
# 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)
# 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)
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. Exercise the dormant workflows in the fork (workflow_dispatch where the dry-run
# reports a canonical-repository pin), then roll back
# 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
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
```
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.
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.
### PR preview artefakt (byg én gang, promover de samme bytes)
### PR-preview-artifakt (byg én gang, promover de samme bytes)
`.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.
`.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.
```bash
gh workflow run preview-artifact.yml -f pr_number=<N> # or add the `preview-artifact` label
gh workflow run preview-artifact.yml -f pr_number=<N> # eller tilføj labelen `preview-artifact`
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
npm install -g ./omniroute-*.tgz # preview-installation
```
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.
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.
### Snittet (3.9.0, efter GO)
### Udskæringen (3.9.0, efter GO)
1. GO optaget i [LTS_GO_NO_GO.md](./LTS_GO_NO_GO.md).
1. GO registreret 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 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:
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:
```bash
git push origin <stable-sha>:refs/heads/stable/v3 <develop-sha>:refs/heads/develop
```
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`.
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`.
---

View File

@@ -140,22 +140,37 @@ 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.
## Hosted bane (GitHub-hostede løbere)
## Hostet spor (GitHub-hostede runners)
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:
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:
| 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 |
| 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 |
`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.
`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.
**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.
**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.

View File

@@ -29,8 +29,6 @@ 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.
@@ -175,7 +173,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` -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`).
`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`).
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.
@@ -198,7 +196,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` 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.
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.
Wo jeder Modus ausgeführt wird:
@@ -214,7 +212,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 Infrastrukturfehler. `--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 Infrastrukturausfall. `--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`):
@@ -243,7 +241,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 `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.
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.
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.
@@ -251,20 +249,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, 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 erstellt, 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 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.
**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.
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.
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.
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.
```bash
npm run i18n:check-value-drift # strict (what CI runs)
@@ -276,11 +274,11 @@ Beendet 0 mit `SKIP reason=base-unresolved`, wenn der Basiskatalog nicht gelesen
### Arbeit: `i18n`
Vollständige i18n-Validierungsmatrix (ein Job pro Gebietsschema). Die gesamte Arbeit ist beratend.
Vollständige i18n-Validierungsmatrix (ein Job pro Gebietsschema). Entire job is advisory.
| Skript | Validiert | Blockierung |
| ------------------------------- | ------------------------------------------------- | ------------------------------------------------------------- |
| `validate_translation.py quick` | Vollständigkeit der Übersetzung pro Gebietsschema | **Beratung** (`continue-on-error: true` für den gesamten Job) |
| Skript | Validiert | Blockierung |
| ------------------------------- | ------------------------------------------------- | ----------------------------------------------------- |
| `validate_translation.py quick` | Vollständigkeit der Übersetzung pro Gebietsschema | **Beratung** (`continue-on-error: true` on whole job) |
### Arbeit: `pr-test-policy`
@@ -296,14 +294,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** — bereits vorhandene Fehler werden in `vitest.config.ts` explizit ausgeschlossen; 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** — pre-existing failures are explicitly excluded in `vitest.config.ts`; Neue Ausfälle scheitern am Job |
### Nächtliche Arbeitsabläufe (geplant, beratend)
Diese laufen nach einem Cron-Zeitplan (und `workflow_dispatch`), niemals nach PRs. Alle sind beratend.
These run on a cron schedule (and `workflow_dispatch`), never on PRs. Alle sind beratend.
| Arbeitsablauf | Validiert | Blockierung |
| ---------------------- | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------ | ------------ |

View File

@@ -4,9 +4,14 @@
---
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.
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.
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.
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.
## Auf einen Blick
@@ -37,23 +42,25 @@ 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 Markierungsproblem mit der Bezeichnung `release-freeze` geöffnet. Das** stoppt die Entwicklung nicht** :
Wenn ein Release abgeglichen wird, wird ein Markierungs-Issue mit dem Label `release-freeze`
geöffnet. Das **hält die Entwicklung nicht auf**:
- 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.
- 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.
Überprüfen Sie, ob ein offenes Einfrieren vorliegt, bevor Sie davon ausgehen, dass der gewünschte Zweig zusammengeführt werden kann:
Prüfe, ob ein offener Freeze besteht, bevor du davon ausgehst, dass der gewünschte Branch zusammengeführt werden kann:
```bash
gh issue list --repo diegosouzapw/OmniRoute --label release-freeze --state open
```
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.
Die Merge-Mechanik (`queue`-Label des Owners → Mergify) ist in
[MERGE_TRAIN.md](./MERGE_TRAIN.md) dokumentiert.
## Warum sowohl ein Branch als auch ein Tag?

View File

@@ -4,9 +4,10 @@
---
> **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.
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.
## Standardpfad: die Mergify-Warteschlange

View File

@@ -355,70 +355,113 @@ Vor der Veröffentlichung eines v3.8.x-Releases diese zusätzlichen Punkte über
---
## 3.9.0 LTS -Schnitt (in 3.8.58 einstudiert)
## 3.9.0-LTS-Abzweigung (in 3.8.58 erprobt)
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).
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.
### Probelauf (schreibgeschützt, jederzeit sicher)
```bash
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
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
```
`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.
`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.
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.
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.
### 3.8.58 Probe (nur Gabel)
### 3.8.58-Erprobung (nur Fork)
```bash
# 1. Dry-run on the current tip with rehearsal parameters
# 1. Probelauf auf der aktuellen Spitze mit Erprobungsparametern
npm run release:dry-run-lts-cut -- --target-version 3.8.58 --previous-tag v3.8.57 \
--advisory freeze,base-green
# 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)
# 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)
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. Exercise the dormant workflows in the fork (workflow_dispatch where the dry-run
# reports a canonical-repository pin), then roll back
# 3. Die inaktiven Workflows im Fork durchlaufen lassen (workflow_dispatch, wenn der Probelauf
# eine Festlegung auf das kanonische Repository meldet), anschließend zurücksetzen
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 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.
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.
### PR -Vorschauartefakt (einmal erstellen, dieselben Bytes hochstufen)
### PR-Vorschauartefakt (einmal bauen, dieselben Bytes übernehmen)
`.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.
`.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.
```bash
gh workflow run preview-artifact.yml -f pr_number=<N> # or add the `preview-artifact` label
gh workflow run preview-artifact.yml -f pr_number=<N> # oder das Label `preview-artifact` hinzufügen
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
npm install -g ./omniroute-*.tgz # Vorschauinstallation
```
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.
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 Schnitt (3.9.0, nach GO)
### Die Abzweigung (3.9.0, nach GO)
1. GO wurde in [LTS_GO_NO_GO.md](./LTS_GO_NO_GO.md) aufgezeichnet.
1. GO ist in [LTS_GO_NO_GO.md](./LTS_GO_NO_GO.md) festgehalten.
2. `npm run release:dry-run-lts-cut -- --from v3.9.0` gibt `RESULT: READY` aus.
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:
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:
```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 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`.
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`.
---

View File

@@ -145,22 +145,33 @@ 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 Spur (von GitHub gehostete Läufer)
## Gehostete Lane (GitHub-gehostete Runner)
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:
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:
| pro Push zu `release/v*` | gehostete Jobs | Ergebnis unter dem Sturm | seit 18.10.2026 |
| pro Push auf `release/v*` | gehostete Jobs | Ergebnis während des Ansturms | seit 2026-10-18 |
| ------------------------------------------- | -------------: | -------------------------------------------------------------- | ---------------------------------------------------------------------------------- |
| `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 |
| `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 |
`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.
`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.
**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.
**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.

View File

@@ -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). Τα forks και οι ομάδες συγχώνευσης χρησιμοποιούν φιλοξενούμενους δρομείς για εργασίες που διαφορετικά επιλέγουν αυτο-φιλοξενούμενους δρομείς. πρέπει να επαληθευτεί επαρκής χωρητικότητα φιλοξενίας πριν από την κυκλοφορία.
Και οι δύο ροές εργασίας καλύπτουν PRs σε κλάδους main/release, ωθήσεις σε `main`, μη αυτόματη αποστολή και συγχώνευση συμβάντων. Push, αποστολή και συγχώνευση-ομαδοποίηση εκτελέστε την πλήρη επιλογή. Οι ωθήσεις στο `release/**` δεν τις ξεκινούν (2026-10-18): κάθε αλλαγή εκτελούσε ήδη τον πίνακα στο PR του και ο συγχωνευμένος συνδυασμός είναι δουλειά του Release-Green (`docs/ops/RUNNER_BOX.md` → Hosted lane). Οι ομάδες διχάλων και συγχωνεύσεων χρησιμοποιούν φιλοξενούμενους δρομείς για εργασίες που επιλέγουν κατά τα άλλα αυτο-φιλοξενούμενους δρομείς. πρέπει να επαληθευτεί επαρκής χωρητικότητα φιλοξενίας πριν από την κυκλοφορία.
Ένα συνηθισμένο PR εκτελεί τη γρήγορη επιλογή. Οι λωρίδες `full-code` και `full-code-e2e` της πολιτικής εισδοχής (E2E, ενσωμάτωση, τεχνούργημα πακέτου, Electron smoke, Bun SQLite, πελάτες οικοσυστήματος και πρωτοκόλλου) εκτελούνται μόνο σε πρόχειρο ουράς Mergify ή σε πλήρη εκτέλεση: `gh workflow run ci.yml --ref <branch>`.
@@ -29,11 +29,9 @@
### Ουρά συγχώνευσης
> **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`.
@@ -82,7 +80,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 και μπλοκ. Οι κατακερματισμοί κλειδώματος ανά εμβέλεια και οι αναφορές διατηρούνται. | Ναί |
@@ -131,7 +129,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`
@@ -155,7 +153,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) |
@@ -196,7 +194,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 δεν αποτελεί ποτέ απόκλιση τεκμηρίωσης: εκτελέστε ξανά την εργασία ή διορθώστε το περιβάλλον.
@@ -214,10 +212,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
@@ -241,7 +239,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.
@@ -251,13 +249,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.
Δύο τρόποι για να το ικανοποιήσεις:
@@ -290,7 +288,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, βλέπε Backlog) | Ναί |
| `check:pr-evidence` | Το σώμα PR παραθέτει στοιχεία test/VPS για την αλλαγή (μηχανοποιεί τον σκληρό κανόνα #18 με το grepping PR prose — fragile, βλ. | Ναί |
### Δουλειά: `test-vitest`
@@ -309,7 +307,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 (block mode) probes + garak (παραβλήθηκε χωρίς μυστικό παρόχου) | **Συμβουλευτικός** |
| `nightly-llm-security` | Promptfoo injection guard (λειτουργία μπλοκ) ανιχνευτές + garak (παράβλεψη χωρίς μυστικό παρόχου) | **Συμβουλευτικός** |
| `nightly-schemathesis` | Σύμπτυξη συμβάσεων OpenAPI (σχήμα) έναντι ζωντανού OmniRoute με χρήση παραβιάσεων προδιαγραφών επιφανειών `docs/openapi.yaml` — / μη χειριζόμενες 500s (Φάση 8 B.4) | **Συμβουλευτικός** |
| `nightly-mutation` | Βαθμολογία δοκιμής μετάλλαξης Stryker στη γρήγορη μονάδα λωρίδας — επιζώντες μεταλλάκτες επιφάνεια αδύναμοι ισχυρισμοί | **Συμβουλευτικός** |
| `nightly-compat` | Πίνακας συμβατότητας κινητήρα κόμβου σε όλες τις υποστηριζόμενες περιοχές `engines.node` | **Συμβουλευτικός** |

View File

@@ -42,23 +42,25 @@ flowchart LR
Το `main` δεν είναι ο κλάδος καθημερινής ενσωμάτωσης. Τα PR που ανοίγονται με στόχο το `main`
συνήθως χρειάζεται να αλλάξουν στόχο πριν από τη συγχώνευση.
## Απελευθερώστε το πάγωμα (παράλληλοι κύκλοι)
## Πάγωμα έκδοσης (παράλληλοι κύκλοι)
Όταν γίνεται συμφωνία για μια έκδοση, ανοίγει ένα ζήτημα δείκτη με την ένδειξη `release-freeze`. Οτι** δεν σταματά την ανάπτυξη** :
Όταν γίνεται η ενοποίηση μιας έκδοσης, ανοίγει ένα ζήτημα-δείκτης με την ετικέτα `release-freeze`.
Αυτό **δεν σταματά την ανάπτυξη**:
- Το παγωμένο `release/vX.Y.Z` ανήκει στον καπετάνιο απελευθέρωσης αυτού του πλοίου.
- Το `release/vX+1` του επόμενου κύκλου κόβεται από την παγωμένη άκρη, ώστε οι συνεισφέροντες να συνεχίσουν να προσγειώνονται.
- Ανοίξτε PRs που εξακολουθούν να στοχεύουν τον παγωμένο κλάδο θα πρέπει να είναι** επαναστοχευμένο** στον ενεργό (υψηλότερο) κλάδο `release/v*`.
- Το παγωμένο `release/vX.Y.Z` ανήκει στον υπεύθυνο έκδοσης για τη συγκεκριμένη κυκλοφορία.
- Ο επόμενος κύκλος `release/vX+1` δημιουργείται από την παγωμένη κορυφή, ώστε οι συνεισφέροντες να συνεχίσουν
να ενσωματώνουν εργασίες.
- Τα ανοιχτά PR που εξακολουθούν να στοχεύουν τον παγωμένο κλάδο πρέπει να **αλλάξουν στόχο** στον
ενεργό (υψηλότερο) κλάδο `release/v*`.
Ελέγξτε για ανοιχτό πάγωμα προτού υποθέσετε ότι το υποκατάστημα που θέλετε είναι συγχωνεύσιμο:
Ελέγξτε αν υπάρχει ενεργό πάγωμα προτού θεωρήσετε ότι ο κλάδος που θέλετε μπορεί να δεχτεί συγχωνεύσεις:
```bash
gh issue list --repo diegosouzapw/OmniRoute --label release-freeze --state open
```
Οι μηχανισμοί συγχώνευσης (ιδιοκτήτρια ετικέτα `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` δεν συγχωνεύει πλέον τίποτα.
Οι μηχανισμοί συγχώνευσης (ετικέτα `queue` από τον ιδιοκτήτη → Mergify) τεκμηριώνονται στο
[MERGE_TRAIN.md](./MERGE_TRAIN.md).
## Γιατί και κλάδος και ετικέτα;

View File

@@ -4,9 +4,10 @@
---
> **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.
Από την έκδοση v3.8.49 (WS3.2/WS3.4 του πλάνου ποιότητας/ταχύτητας), η προεπιλεγμένη διαδρομή συγχώνευσης για
ελεγμένα PRs προς το `release/vX.Y.Z` είναι η **ουρά συγχώνευσης του Mergify** (`.mergify.yml`)·
η **μη αυτόματη αμαξοστοιχία συγχώνευσης** που τεκμηριώνεται παρακάτω είναι η ΕΦΕΔΡΙΚΗ ΛΥΣΗ — χρησιμοποιείται κατά τη διάρκεια συμβάντων,
παγώματος έκδοσης ή αν αλλάξει ποτέ το πρόγραμμα Ανοιχτού Κώδικα του Mergify.
## Προεπιλεγμένη διαδρομή: η ουρά του Mergify

View File

@@ -355,70 +355,111 @@ npm run build:release
---
## 3.9.0 LTS cut (πρόβα στο 3.8.58)
## Αποκοπή της 3.9.0 LTS (πρόβα στην 3.8.58)
Μετά την έκδοση 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).
Μετά τη 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).
### Ξηρή λειτουργία (μόνο για ανάγνωση, ασφαλής ανά πάσα στιγμή)
### Δοκιμαστική εκτέλεση (μόνο για ανάγνωση, ασφαλής ανά πάσα στιγμή)
```bash
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
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 προέλευσης
```
`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,...>` υποβαθμίζει μια επιταγή σε προειδοποίηση (`!`) χωρίς να την κρύβει.
Το `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,...>` υποβαθμίζει έναν έλεγχο σε προειδοποίηση (`!`)
χωρίς να τον αποκρύπτει.
Εκτελέστε το dry-run της πραγματικής κοπής — το freeze απελευθέρωσης 3.9.0 είναι ακόμα ανοιχτό.
Εκτελέστε τη δοκιμαστική εκτέλεση της πραγματικής αποκοπής όσο το πάγωμα έκδοσης της 3.9.0 παραμένει ανοιχτό — οι κλάδοι
δημιουργούνται μετά το tag και πριν η Φάση 12c άρει το πάγωμα.
### 3.8.58 πρόβα (μόνο πιρούνι)
### Πρόβα της 3.8.58 (μόνο σε fork)
```bash
# 1. Dry-run on the current tip with rehearsal parameters
# 1. Δοκιμαστική εκτέλεση στην τρέχουσα κορυφή με παραμέτρους πρόβας
npm run release:dry-run-lts-cut -- --target-version 3.8.58 --previous-tag v3.8.57 \
--advisory freeze,base-green
# 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)
# 2. Εκτέλεση σε remote ενός FORK (το origin ή οποιοδήποτε remote του οποίου το URL είναι αυτό του κανονικού
# αποθετηρίου απορρίπτεται· κάθε βήμα ζητά επιβεβαίωση στο τερματικό)
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. Exercise the dormant workflows in the fork (workflow_dispatch where the dry-run
# reports a canonical-repository pin), then roll back
# 3. Δοκιμή των ανενεργών workflow στο fork (workflow_dispatch όπου η δοκιμαστική εκτέλεση
# αναφέρει καρφίτσωμα στο κανονικό αποθετήριο) και, στη συνέχεια, επαναφορά
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 (δεν αγγίζεται δέντρο που λειτουργεί) και προσκρούει τα ίδια πέντε αρχεία με μια δέσμευση κυκλικού ανοιχτού: `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.
Το 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 — κάντε πρόβα αυτών σε ένα δοκιμαστικό πακέτο.
### τεχνούργημα προεπισκόπησης PR (δημιουργήστε μία φορά, προωθήστε τα ίδια byte)
### Artifact προεπισκόπησης PR (δημιουργία μία φορά, προώθηση των ίδιων byte)
`.github/workflows/preview-artifact.yml` κατασκευάζει ένα tarball παραγωγής από μια κεφαλή PR και επικυρώνει αυτό ακριβώς το build (#8084 slice (a)). Μόνο PRs ίδιου αποθετηρίου. τίποτα δεν δημοσιεύεται.
Το `.github/workflows/preview-artifact.yml` δημιουργεί ένα tarball παραγωγής από την κεφαλή ενός PR και
επικυρώνει ακριβώς αυτό το build (τμήμα (a) του #8084). Μόνο PR από το ίδιο αποθετήριο· τίποτα δεν δημοσιεύεται.
```bash
gh workflow run preview-artifact.yml -f pr_number=<N> # or add the `preview-artifact` label
gh workflow run preview-artifact.yml -f pr_number=<N> # ή προσθέστε την ετικέτα `preview-artifact`
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
npm install -g ./omniroute-*.tgz # εγκατάσταση προεπισκόπησης
```
Η εκτέλεση εκτελεί `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: ποτέ μην αναδημιουργείτε από την πηγή.
Η εκτέλεση πραγματοποιεί `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 από τον πηγαίο κώδικα.
### Το cut (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 ανάπτυξης, εκτελέστε πρώτα την πρόβα `--execute` στο άκρο 3.9.0 στο πιρούνι σας. Εκτυπώνει και τα δύο SHAs και μπορούν να προωθηθούν οι ίδιες δεσμεύσεις:
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:
```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` (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`.
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`.
---

View File

@@ -136,22 +136,36 @@ CPU χωρίς συνδεδεμένη εργασία. Κάθε μονάδα Omni
λεπτά για να αποθηκευτεί στο tmpfs και 2 λεπτά για να μεταφορτωθεί από τον δίσκο.
- Το VPS `.15` προορίζεται μόνο για homologation — δεν εκτελεί ποτέ CI runners.
## Φιλοξενούμενη λωρίδα (δρομείς που φιλοξενούνται από το GitHub)
## Φιλοξενούμενος δίαυλος (runners που φιλοξενούνται στο GitHub)
Το αποθετήριο ανήκει στον οργανισμό `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 συγχωνεύτηκε χωρίς αυτούς. Εννέα ροές εργασίας ενεργοποιήθηκαν σε κάθε ώθηση προς το υποκατάστημα:
Το αποθετήριο ανήκει στον οργανισμό `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 προς τον κλάδο:
| ανά ώθηση σε `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` δεν σαρώνει τίποτα εδώ |
| ανά 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` δεν σαρώνουν τίποτα εδώ |
`tests/unit/build/push-storm-diet.test.ts` καρφώνει τη σκανδάλη ώθησης `main` -only των `ci.yml` και `quality.yml`. Παρενέργεια: Το Codecov δεν λαμβάνει πλέον βασική μεταφόρτωση ανά ώθηση απελευθέρωσης (το βήμα είναι ενημερωτικό και `continue-on-error`). η πύλη κάλυψης σε repo και το σχόλιο PR δεν επηρεάζονται.
Το `tests/unit/build/push-storm-diet.test.ts` κατοχυρώνει την ενεργοποίηση μέσω push μόνο για το `main` των `ci.yml` και
`quality.yml`. Παρενέργεια: το Codecov δεν λαμβάνει πλέον μεταφόρτωση βάσης ανά push έκδοσης (το
βήμα είναι ενημερωτικό και χρησιμοποιεί `continue-on-error`)· η πύλη κάλυψης εντός του αποθετηρίου και το σχόλιο στο PR
δεν επηρεάζονται.
**Η μεγαλύτερη χωρητικότητα αυτο-φιλοξενίας δεν διορθώνει τη φιλοξενούμενη ουρά.** Το 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 παραπάνω δεν υπάρχει πλέον.
**Η επιπλέον αυτοφιλοξενούμενη χωρητικότητα δεν διορθώνει την ουρά φιλοξενούμενων εργασιών.** Το 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` βάσει των αρχείων που διαβάζει.

View File

@@ -29,8 +29,6 @@ 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.
@@ -49,7 +47,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 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.
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.
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`.
@@ -80,7 +78,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 excede el presupuesto (cateraca de nivel 11) | Sí |
| `check:any-budget:t11` | El recuento `@ts-expect-error // any` no supera 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í |
@@ -114,7 +112,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 (cualquiera 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 (cualquier error en el estricto). Verifique ambos antes de limpiar un archivo.
### Trabajo: `quality-gate`
@@ -251,7 +249,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` 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:
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:
- `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;

View File

@@ -4,9 +4,14 @@
---
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.
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.
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.
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.
## De un vistazo
@@ -37,23 +42,27 @@ flowchart LR
`main` no es la rama de integración diaria. Por lo general, los PR abiertos
contra `main` deben redirigirse antes de integrarlos.
## Liberar congelación (ciclos paralelos)
## Congelación de lanzamiento (ciclos paralelos)
Cuando se concilia una versión, se abre una emisión de marcador denominada `release-freeze`. Eso** no detiene el desarrollo** :
Cuando se está conciliando un lanzamiento, se abre una incidencia marcadora con
la etiqueta `release-freeze`. Esto **no detiene el desarrollo**:
- 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).
- 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).
Verifique si hay una congelación abierta antes de asumir que la rama que desea se puede fusionar:
Comprueba si hay una congelación abierta antes de asumir que la rama que deseas
se puede integrar:
```bash
gh issue list --repo diegosouzapw/OmniRoute --label release-freeze --state open
```
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.
Los mecanismos de integración (etiqueta `queue` del propietario → Mergify) están
documentados en [MERGE_TRAIN.md](./MERGE_TRAIN.md).
## ¿Por qué se usan tanto una rama como una etiqueta?

View File

@@ -4,9 +4,10 @@
---
> **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.
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.
## Ruta predeterminada: la cola de Mergify

View File

@@ -355,70 +355,111 @@ Antes de publicar cualquier versión v3.8.x, verifica también estos elementos:
---
## 3.9.0 corte LTS (ensayado en 3.8.58)
## Corte LTS 3.9.0 (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 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).
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).
### Ejecución en seco (solo lectura, seguro en cualquier momento)
### Simulación (solo lectura, segura en cualquier momento)
```bash
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
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
```
`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.
`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.
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.
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.
### 3.8.58 ensayo (solo tenedor)
### Ensayo de 3.8.58 (solo en un fork)
```bash
# 1. Dry-run on the current tip with rehearsal parameters
# 1. Simulación en la punta actual con parámetros de ensayo
npm run release:dry-run-lts-cut -- --target-version 3.8.58 --previous-tag v3.8.57 \
--advisory freeze,base-green
# 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)
# 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)
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. Exercise the dormant workflows in the fork (workflow_dispatch where the dry-run
# reports a canonical-repository pin), then roll back
# 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
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
```
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.
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.
### Artefacto de vista previa PR (compila una vez, promueve los mismos bytes)
### Artefacto de vista previa del PR (compilar una vez, promover exactamente los mismos bytes)
`.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.
`.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.
```bash
gh workflow run preview-artifact.yml -f pr_number=<N> # or add the `preview-artifact` label
gh workflow run preview-artifact.yml -f pr_number=<N> # o añada la etiqueta `preview-artifact`
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
npm install -g ./omniroute-*.tgz # instalación de vista previa
```
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.
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.
### El corte (3.9.0, después de GO)
1. GO grabado en [LTS_GO_NO_GO.md](./LTS_GO_NO_GO.md).
1. GO registrado 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 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:
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:
```bash
git push origin <stable-sha>:refs/heads/stable/v3 <develop-sha>:refs/heads/develop
```
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`.
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`.
---

View File

@@ -138,22 +138,33 @@ 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.
## Carril alojado (corredores alojados en GitHub)
## Canal alojado (runners alojados en GitHub)
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:
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:
| 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í |
| 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í |
`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.
`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.
**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.
**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.

View File

@@ -29,8 +29,6 @@ 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.

View File

@@ -4,9 +4,9 @@
---
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.
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.
Hooldaja üksikasjad elavad `CLAUDE.md` (Hard Rule #21) ja [RELEASE_CHECKLIST.md](./RELEASE_CHECKLIST.md). See leht on avalikele kaastöölistele suunatud kokkuvõte.
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.
## Lühidalt
@@ -36,23 +36,21 @@ flowchart LR
`main` ei ole igapäevane integratsiooniharu. Haru `main` vastu avatud PR-id tuleb tavaliselt enne mestimist ümber suunata.
## Vabastage külmutamine (paralleelsed tsüklid)
## Väljalaske külmutamine (paralleelsed tsüklid)
Väljalaske vastavusse viimisel avatakse tähisprobleem `release-freeze`. See** ei peata arengut** :
Väljalaske kooskõlastamise ajal avatakse märgendiga `release-freeze` tähistatud probleem. See **ei peata arendust**:
- 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.
- 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*`.
Enne kui eeldate, et soovitud haru on ühendatav, kontrollige, kas see on külmutatud:
Enne soovitud haru mestitavaks pidamist kontrollige, kas mõni külmutamine on aktiivne:
```bash
gh issue list --repo diegosouzapw/OmniRoute --label release-freeze --state open
```
Ü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.
Mestimise mehhanism (omaniku märgend `queue` → Mergify) on dokumenteeritud failis [MERGE_TRAIN.md](./MERGE_TRAIN.md).
## Miks on vaja nii haru kui ka märgendit?

View File

@@ -4,8 +4,6 @@
---
> **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.

View File

@@ -355,70 +355,112 @@ Enne mis tahes v3.8.x versiooni väljalaskmist kontrollige ka järgmisi punkte:
---
## 3.9.0 LTS lõige (harjutatud 3.8.58)
## 3.9.0 LTS-i haru loomine (läbi harjutatud versioonis 3.8.58)
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).
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).
### Kuivtöö (kirjutuskaitstud, ohutu igal ajal)
### Proovikäivitus (kirjutuskaitstud, alati ohutu)
```bash
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
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
```
`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.
`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.
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.
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.
### 3.8.58 proov (ainult kahvel)
### 3.8.58 harjutus (ainult fork-repositooriumis)
```bash
# 1. Dry-run on the current tip with rehearsal parameters
# 1. Proovikäivitus praeguse tipu põhjal koos harjutuse parameetritega
npm run release:dry-run-lts-cut -- --target-version 3.8.58 --previous-tag v3.8.57 \
--advisory freeze,base-green
# 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)
# 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)
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. Exercise the dormant workflows in the fork (workflow_dispatch where the dry-run
# reports a canonical-repository pin), then roll back
# 3. Käivitage fork-repositooriumis uinuvad töövood (workflow_dispatch seal, kus proovikäivitus
# teatab fikseeritusest kanoonilisele repositooriumile), seejärel pöörake muudatused tagasi
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
```
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.
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.
### PR eelvaate artefakt (ehitage üks kord, reklaamige samu baite)
### PR-i eelvaate artefakt (koosta üks kord, eduta samad baidid)
`.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.
`.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.
```bash
gh workflow run preview-artifact.yml -f pr_number=<N> # or add the `preview-artifact` label
gh workflow run preview-artifact.yml -f pr_number=<N> # või lisa silt `preview-artifact`
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
npm install -g ./omniroute-*.tgz # eelvaate installimine
```
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.
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.
### Lõige (3.9.0, pärast GO)
### Haru loomine (3.9.0, pärast GO-otsust)
1. GO salvestatud failis [LTS_GO_NO_GO.md](./LTS_GO_NO_GO.md).
1. GO-otsus on salvestatud dokumendis [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 `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:
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:
```bash
git push origin <stable-sha>:refs/heads/stable/v3 <develop-sha>:refs/heads/develop
```
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`.
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`.
---

View File

@@ -141,22 +141,38 @@ 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.
## Hostitud rada (GitHubi hostitud jooksjad)
## Majutatud kanal (GitHubi majutatud käitajad)
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:
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:
| `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 |
| 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 |
`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.
`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.
**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.
**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.

View File

@@ -29,8 +29,6 @@
### صف ادغام
> **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 را حذف می کند.
@@ -68,7 +66,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`
@@ -79,7 +77,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` یک جغجغه سوخته است: فقط یک ورودی با مشکل ردیابی اضافه کنید. | بله |
@@ -125,7 +123,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` | بودجه معیار تراکم — به ازای هر موتور، طبقات پس انداز نباید پسرفت کنند | بله |
@@ -135,7 +133,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` زمانی که اندازهگیری آنها وجود ندارد بسته میشوند.
| اسکریپت | اعتبار سنجی می کند | مسدود کردن |
| ------------------------ | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | ------------------------------------------- |
@@ -172,7 +170,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` همگامسازی میکند).
@@ -205,8 +203,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` باز نگه میدارد. هرگز ادغام نمی شود |
@@ -251,13 +249,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 ایجاد می شود.
دو راه برای ارضای آن:
@@ -286,11 +284,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`

View File

@@ -4,9 +4,14 @@
---
OmniRoute از a استفاده می کند** چرخه موازی** مدل انتشار: یک شاخه `release/vX.Y.Z` اختصاصی برای چرخه فعال، `main` برای خط منتشر شده، و یک برچسب `vX.Y.Z` تغییرناپذیر زمانی که آن چرخه ارسال میشود. دیدن commits زمین در `release/*` _and_ در `main` انتظار می رود — یک مخلوط نیست.
OmniRoute از مدل انتشار **چرخههای موازی** استفاده میکند: یک شاخهٔ اختصاصی `release/vX.Y.Z`
برای چرخهٔ فعال، `main` برای خط منتشرشده و یک تگ تغییرناپذیر
`vX.Y.Z` هنگام انتشار آن چرخه. مشاهدهٔ ثبت شدن کامیتها هم در `release/*` _و_ هم در
`main` طبیعی است — این موضوع ناشی از اشتباه نیست.
جزئیات نگهدارنده در `CLAUDE.md` (قاعده سخت #21) و [RELEASE_CHECKLIST.md](./RELEASE_CHECKLIST.md) زندگی می کند. این صفحه خلاصه ای است که مشارکت کننده عمومی دارد.
جزئیات ویژهٔ نگهدارندگان در `CLAUDE.md` (قانون سختگیرانهٔ شمارهٔ ۲۱) و
[RELEASE_CHECKLIST.md](./RELEASE_CHECKLIST.md) آمده است. این صفحه خلاصهای عمومی
برای مشارکتکنندگان است.
## مرور کلی
@@ -37,23 +42,25 @@ flowchart LR
`main` شاخهٔ یکپارچهسازی روزمره نیست. PRهایی که به مقصد `main`
باز میشوند، معمولاً پیش از ادغام باید به شاخهٔ دیگری هدایت شوند.
## آزاد کردن انجماد (چرخه های موازی)
## توقف موقت انتشار (چرخههای موازی)
هنگامی که یک نسخه در حال تطبیق است، یک مشکل نشانگر با عنوان `release-freeze` باز می شود. که** توسعه را متوقف نمی کند** :
هنگامی که یک انتشار در حال تطبیق نهایی است، یک issue نشانگر با برچسب `release-freeze`
باز میشود. این کار **توسعه را متوقف نمیکند**:
- `release/vX.Y.Z` منجمد متعلق به کاپیتان آزادسازی آن کشتی است.
- `release/vX+1` چرخه بعدی از نوک یخ زده بریده می شود تا مشارکت کنندگان به کار فرود ادامه دهند.
- PRs باز که هنوز شاخه یخ زده را هدف قرار می دهد باید باشد** مجددا هدف گذاری شده است** به فعال (بالاترین) شاخه `release/v*`.
- شاخهٔ منجمدشدهٔ `release/vX.Y.Z` برای آن انتشار در اختیار مسئول انتشار است.
- چرخهٔ بعدی، یعنی `release/vX+1`، از نوک منجمدشده ایجاد میشود تا مشارکتکنندگان بتوانند
به ثبت تغییرات خود ادامه دهند.
- PRهای بازی که همچنان شاخهٔ منجمدشده را هدف قرار دادهاند، باید به شاخهٔ فعال
`release/v*` (بالاترین نسخه) **هدایت مجدد** شوند.
قبل از اینکه فرض کنید شاخه مورد نظر شما قابل ادغام است، انجماد باز را بررسی کنید:
پیش از اینکه فرض کنید شاخهٔ موردنظر شما قابل ادغام است، وجود توقف موقت باز را بررسی کنید:
```bash
gh issue list --repo diegosouzapw/OmniRoute --label release-freeze --state open
```
مکانیک ادغام (مالک برچسب `queue` → Mergify) در [MERGE_TRAIN.md](./MERGE_TRAIN.md) مستند شده است.
> **19/11/2026: صف ادغام Mergify بازنشسته شده است** (تصمیم مالک). `.mergify.yml` دیگر یک صف تعریف نمی کند و دستورات Mergify را که یک درخواست کشش را ادغام یا بازنویسی می کنند، رد می کند. انتشار PRs با دست در زیر مجموعه قوانین مخزن «نیاز به دروازههای سبز در انتشار فعال» (`Gate / CI` + `Gate / Quality`) ادغام میشود تا زمانی که صف omni در حالت زنده اجرا شود، و پس از آن از طریق صف omni ( [OMNI_QUEUE.md](./OMNI_QUEUE.md) ). برچسب `queue` دیگر چیزی را ادغام نمی کند.
سازوکار ادغام (برچسب `queue` توسط مالک → Mergify) در
[MERGE_TRAIN.md](./MERGE_TRAIN.md) مستند شده است.
## چرا هم شاخه و هم تگ؟

View File

@@ -4,9 +4,10 @@
---
> **19/11/2026: صف ادغام Mergify بازنشسته شده است** (تصمیم مالک). `.mergify.yml` دیگر یک صف تعریف نمی کند و دستورات Mergify را که یک درخواست کشش را ادغام یا بازنویسی می کنند، رد می کند. انتشار PRs با دست در زیر مجموعه قوانین مخزن «نیاز به دروازههای سبز در انتشار فعال» (`Gate / CI` + `Gate / Quality`) ادغام میشود تا زمانی که صف omni در حالت زنده اجرا شود، و پس از آن از طریق صف omni ( [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 هرگز تغییر کند استفاده می شود.
از نسخهٔ v3.8.49 (WS3.2/WS3.4 از برنامهٔ کیفیت/سرعت)، مسیر پیشفرض ادغام برای
PRهای بازبینیشده در `release/vX.Y.Z`، **صف ادغام Mergify** (`.mergify.yml`) است؛
**قطار ادغام دستی** که در ادامه مستند شده، مسیر جایگزین است — و هنگام رخدادها،
توقف انتشار، یا در صورت تغییر طرح متنباز Mergify استفاده میشود.
## مسیر پیشفرض: صف Mergify

View File

@@ -378,7 +378,8 @@ npm run release:dry-run-lts-cut -- --from <3.9.0-tip> # ثابتکردن کام
تگ قبلی وجود دارد، `package.json` دارای نسخه هدف است، یک issue با برچسب `release-freeze` باز است، هیچ
issue بازی با عنوان `Release branch not green`
در یک شاخه انتشار موجود وجود ندارد — شاخهای که وجود ندارد وضعیت ناشناخته `?` را گزارش میکند و هرگز
سبز نیست — omni-queue درخواست‌های ادغام را در شاخهٔ انتشار ادغام می‌کند (G11: `config/merge-queue/config.json` معتبر است، `bases` آن شعبه انتشار را مدیریت میکند، `mode` `live`، برچسب آن وجود دارد)، مجموعهقواعد `release/*` همچنان حذف و force-push را مسدود میکند، و
سبز نیست — صف `release` در Mergify پیکربندی شده است (G11: `queue_rules`، `checks_timeout`،
برچسب `queue`)، مجموعهقواعد `release/*` همچنان حذف و force-push را مسدود میکند، و
`stable/v3` و `develop` هنوز وجود ندارند)، دو مرحله شاخه، اینکه کدام triggerهای workflow غیرفعال و
شرطهای `if:` برقرار میشوند (و کدامیک همچنان توسط یک متغیر مخزن محدود میمانند یا
به مخزن canonical مقید هستند)، dist-tagهای مورد انتظار (`latest` ← 3.9.0 و `next` و

View File

@@ -146,22 +146,33 @@ SIGKILL برای کل cgroup ارسال میشود. این تنظیم در را
2 دقیقه زمان برد.
- VPS با آدرس `.15` فقط برای homologation است — هرگز runnerهای CI را اجرا نمیکند.
## Hosted Lane (دوندگان میزبان GitHub)
## مسیر میزبانیشده (اجراکنندههای میزبانیشده توسط GitHub)
مخزن متعلق به سازمان `cheaper-inference` ، در** تیم** طرح:** 60 شغل میزبانی همزمان** ، به اشتراک گذاشته شده توسط هر مخزن در سازمان، هر بررسی PR ، هر گردش کار با فشار و تنظیمات پیش فرض CodeQL. ارقام زیر بر روی اندازه گیری شد** حرفه ای** طرح (40 شغل میزبانی همزمان). اندازهگیریشده در ۱۸/۱۰/۲۰۲۶ طی یک کمپین ادغام (~ 10 merges/hour on `release/v3.8.52`):** 2500 گردش کار ایجاد شده در 24 ساعت** ، 44 فشار به شاخه در 6 ساعت،** 106 شغل میزبان در صف قرار گرفتند** در حالی که چک های PR ساعت ها منتظر ماندند و PRs بدون آنها ادغام شدند. 9 گردش کار در هر فشار به شاخه شلیک می شود:
این مخزن متعلق به سازمان `cheaper-inference` و روی طرح **Team** است: **60 کار میزبانی‌شدهٔ همزمان** که میان همهٔ مخزن‌های سازمان، همهٔ بررسی‌های PR، همهٔ گردش‌کارهای فعال‌شده با push و پیکربندی پیش‌فرض CodeQL مشترک‌اند. ارقام زیر روی طرح **Pro** (40 کار میزبانی‌شدهٔ همزمان) اندازه‌گیری شده‌اند. طبق اندازهگیری در 2026-10-18 طی یک
کارزار ادغام (~10 ادغام در ساعت روی `release/v3.8.52`): در مدت
24 ساعت **2,500 اجرای گردشکار ایجاد شد**، طی 6 ساعت 44 بار push به شاخه انجام شد و درحالیکه بررسیهای PR
ساعتها منتظر ماندند و PRها بدون آنها ادغام شدند، **106 کار میزبانیشده در صف قرار گرفت**. در هر push به این شاخه، نُه گردشکار اجرا میشد:
| هر فشار به `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 leg در `omni-build` رقابت می کند | کانال استقرار مالک — بدون تغییر |
| تنظیم پیش فرض CodeQL (`dynamic`) | 4 | `javascript-typescript`, `actions`, `c-cpp`, `python` per push | بدون تغییر تنظیمات — → امنیت کد. `c-cpp`/`python` چیزی را در اینجا اسکن نمی کند |
| بهازای هر 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 | بهازای هر push یک `npm ci` میزبانیشده؛ هرگز لغو نشد | بدون تغییر — نامزد استفاده از فیلتر `paths:` |
| `Publish to Docker Hub` → `Deploy to VPS` | 2 | بهازای هر push لغو شد؛ بخش amd64 روی `omni-build` رقابت میکند | بدون تغییر — کانال استقرار مالک |
| پیکربندی پیشفرض CodeQL (`dynamic`) | 4 | بهازای هر push، `javascript-typescript`، `actions`، `c-cpp` و `python` | بدون تغییر — Settings → Code security؛ `c-cpp`/`python` در اینجا چیزی را اسکن نمیکنند |
`tests/unit/build/push-storm-diet.test.ts` ماشه فشار `main` -only `ci.yml` و `quality.yml` را پین می کند. عواقب جانبی: Codecov دیگر آپلود پایه در هر فشار انتشار دریافت نمی کند (مرحله اطلاعاتی و `continue-on-error` است). گیت پوشش داخل مخزن و نظر PR تحت تأثیر قرار نگرفته است.
`tests/unit/build/push-storm-diet.test.ts` محرک push صرفاً برای `main` در `ci.yml` و
`quality.yml` را تثبیت میکند. پیامد جانبی: Codecov دیگر بهازای هر push انتشار، بارگذاری پایه دریافت نمیکند (این
مرحله صرفاً اطلاعرسانی است و `continue-on-error` دارد)؛ دروازهٔ پوشش درون مخزن و دیدگاه PR
تحت تأثیر قرار نمیگیرند.
**ظرفیت میزبانی بیشتر، صف میزبانی را برطرف نمی کند.** 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 در حالت زنده اجرا شود، و پس از آن از طریق صف omni ( [OMNI_QUEUE.md](./OMNI_QUEUE.md) ). اهرم Mergify در بالا دیگر وجود ندارد.
**ظرفیت بیشترِ خودمیزبانیشده، صف میزبانیشده را اصلاح نمیکند.** devbox
(`devbox-vm-06-dev002`، 24 vCPU / 54 GB) میتواند میزبان یک اجراکننده باشد، اما نشستهای عامل از قبل
بار آن را روی 20 تا 26 نگه میدارند، کانتینر عامل فاقد daemon مربوط به Docker است و مسیر اشباعشده
همان مسیر میزبانیشده است. دستگاه `.113` در همان لحظه 71 GB فضای آزاد و بار 5 تا 8 داشت؛ محدودیت آن
بودجهٔ حافظه بهازای هر listener ذکرشده در بالا است (حداکثر 6 listener)، نه CPU. اهرمهای باقیمانده
فرایندی هستند: PRهای کارزار را از طریق صف Mergify ادغام کنید (`label=queue`، دستهها بهجای یک اجرا برای هر PR
بهعلاوهٔ یک اجرا برای هر push، یک اجرای CI مشترک `merge_group` دارند)، زبانهای پیکربندی پیشفرض CodeQL
را کاهش دهید و `release-acceptance.yml` را بر اساس فایلهایی که میخواند فیلتر کنید.

View File

@@ -29,8 +29,6 @@ Jokainen JSON -kuitti tunnistaa uloskirjatun SHA, työnkulun suorituksen ja yrit
### Yhdistä jono
> **2026-11-19: Mergify-yhdistämisjono on poistettu käytöstä** (omistajan päätös). `.mergify.yml` ei enää määritä jonoa ja hylkää Mergify-komennot, jotka yhdistävät tai kirjoittavat uudelleen vetopyynnön. Julkaisuhaaran vetopyynnöt yhdistetään manuaalisesti arkiston sääntöjoukon "Require green gates on the active release" (`Gate / CI` + `Gate / Quality`) alla, kunnes omni-queue toimii live-tilassa ja sen jälkeen omni-queue kautta ([OMNI_QUEUE.md](../ops/OMNI_QUEUE.md)). Alla kuvattu Mergify luonnosten työnkulku on edelleen `ci.yml` ja `quality.yml` muodossa, mutta Mergify-luonnoksia ei enää avata.
`queue` -tunniste lähettää PR n yhdistämisjonoon (`.mergify.yml`). Mergify avaa PR -luonnoksen `mergify/merge-queue/` -haarassa, CI suorittaa siellä täyden valikoiman ja alkuperäinen PR sulautuu, kun `Gate / CI`, `Gate / Quality` ja `Merge integrity (changelog + generated skills)` kulkevat.
Mergify kirjoittaa jonon yhteenvedon luonnoksen kuvaukseen, ja myös muut sovellukset voivat muokata sitä. Tällaisen luonnoksen `pull_request` `edited` -tapahtuma ottaa oman samanaikaisuusryhmänsä (`-queue-edit-<run_id>`), joten se ei voi peruuttaa luonnoksen todellista ajoa ja se ohittaa portin ja matriisin. Vain `Merge integrity` toimii edelleen. Ohitetulla porttityöllä on eri tarkistusnimi, koska Mergify lukee ohitetun `Gate / CI` epäonnistuneena tarkistuksena ja poistaa PR n jonosta.

View File

@@ -39,23 +39,25 @@ flowchart LR
`main` ei ole päivittäinen integraatiohaara. `main`-haaraan kohdistetut PR:t
on yleensä kohdistettava uudelleen ennen yhdistämistä.
## Vapauta jäädytys (rinnakkaisjaksot)
## Julkaisujäädytys (rinnakkaiset syklit)
Kun julkaisua sovitetaan, `release-freeze` -merkkiongelma avataan. Että** ei pysäytä kehitystä** :
Kun julkaisua sovitetaan yhteen, avataan `release-freeze`-merkinnällä varustettu
merkintäissue. Tämä **ei pysäytä kehitystä**:
- Jäätynyt `release/vX.Y.Z` kuuluu aluksen vapautuskapteenille.
- Seuraavan syklin `release/vX+1` leikataan jäätyneestä kärjestä, jotta avustajat jatkavat laskeutumistyötä.
- Avoin PRs, joka edelleen kohdistuu jäätyneeseen oksaan, pitäisi olla** uudelleen kohdistettu** aktiiviseen (korkeimpaan) `release/v*` -haaraan.
- Jäädytetty `release/vX.Y.Z` kuuluu kyseisen julkaisun julkaisuvastaavalle.
- Seuraavan syklin `release/vX+1` luodaan jäädytetystä kärjestä, jotta kontribuoijat voivat jatkaa
työnsä yhdistämistä.
- Avoimet PR:t, jotka edelleen kohdistuvat jäädytettyyn haaraan, tulee **kohdistaa uudelleen**
aktiiviseen (suurimman versionumeron omaavaan) `release/v*`-haaraan.
Tarkista, onko avoin jäädytys, ennen kuin oletat, että haluamasi haara on yhdistettävissä:
Tarkista avoin jäädytys ennen kuin oletat haluamasi haaran olevan yhdistettävissä:
```bash
gh issue list --repo diegosouzapw/OmniRoute --label release-freeze --state open
```
Yhdistämismekaniikka (omistaja `queue` label → Mergify) on dokumentoitu [MERGE_TRAIN.md](./MERGE_TRAIN.md) -tiedostossa.
> **19.11.2026: Mergify-yhdistämisjono on poistettu käytöstä** (omistajan päätös). `.mergify.yml` ei enää määritä jonoa ja hylkää yhdistämiskomennot, jotka yhdistävät tai kirjoittavat uudelleen vetopyynnön. Julkaisut PRs yhdistetään käsin arkiston sääntöjoukon "Vaadi vihreät portit aktiivisessa julkaisussa" (`Gate / CI` + `Gate / Quality`) mukaisesti, kunnes omni-queue toimii live-tilassa, ja omni-jonon kautta sen jälkeen ( [OMNI_QUEUE.md](./OMNI_QUEUE.md) ). `queue` -tunniste ei enää yhdistä mitään.
Yhdistämismekaniikka (omistajan `queue`-merkintä → Mergify) on dokumentoitu tiedostossa
[MERGE_TRAIN.md](./MERGE_TRAIN.md).
## Miksi tarvitaan sekä haara että tunniste?

View File

@@ -4,9 +4,9 @@
---
> **19.11.2026: Mergify-yhdistämisjono on poistettu käytöstä** (omistajan päätös). `.mergify.yml` ei enää määritä jonoa ja hylkää yhdistämiskomennot, jotka yhdistävät tai kirjoittavat uudelleen vetopyynnön. Julkaisut PRs yhdistetään käsin arkiston sääntöjoukon "Vaadi vihreät portit aktiivisessa julkaisussa" (`Gate / CI` + `Gate / Quality`) mukaisesti, kunnes omni-queue toimii live-tilassa, ja omni-jonon kautta sen jälkeen ( [OMNI_QUEUE.md](./OMNI_QUEUE.md) ). Alla olevat Yhdistä-osiot kuvaavat jonoa sellaisena kuin se oli.
Koska versio 3.8.49 ( quality/velocity -suunnitelman WS3.2/WS3.4 ), oletusarvoinen yhdistämispolku tarkistetulle PRs :lle `release/vX.Y.Z` :hen on** Yhdistä yhdistämisjono** (`.mergify.yml`); the** manuaalinen yhdistämisjuna** alla on dokumentoitu FALLBACK — jota käytetään tapahtumien, julkaisujen jäätymisen tai yhdistämissuunnitelman muuttuessa.
Versiosta v3.8.49 lähtien (laatu-/nopeussuunnitelman WS3.2/WS3.4) katselmoitujen PR:ien oletusyhdistämispolku haaraan `release/vX.Y.Z` on **Mergifyn yhdistämisjono** (`.mergify.yml`);
alla kuvattu **manuaalinen yhdistämisjuna** on VARAJÄRJESTELY — sitä käytetään häiriötilanteissa,
julkaisujäädytysten aikana tai jos Mergifyn Open Source -paketti joskus muuttuu.
## Oletuspolku: Mergify-jono

View File

@@ -355,70 +355,112 @@ Ennen minkään v3.8.x-julkaisun toimittamista varmista lisäksi seuraavat asiat
---
## 3.9.0 LTS -leikkaus (harjoitettu 3.8.58)
## 3.9.0 LTS-haarautus (harjoiteltu versiossa 3.8.58)
V3.8.59:n jälkeen seuraava versio on 3.9.0, ja sen kärjestä tulee kaksi pitkäikäistä haaraa: `stable/v3` (v3 LTS -linja, npm `latest`) ja `develop` (v4, 4.0.0, npm `nightly`). branch/channel malli, eteenpäin suuntautuva portti ja tarrat ovat muodossa [RELEASE_STRATEGY.md](./RELEASE_STRATEGY.md) ; suunnitelma on [ROADMAP](../../ROADMAP.md) :ssa (vaihe 3). Leikkaus suoritetaan kerran; 3.8.58 harjoittelee sen päästä päähän haarukalla ja 3.8.59 päättää [GO/NO-GO tarkistuslistalla](./LTS_GO_NO_GO.md).
Version v3.8.59 jälkeen seuraava versio on 3.9.0, ja sen kärjestä muodostetaan kaksi pitkäikäistä haaraa:
`stable/v3` (v3:n LTS-linja, npm `latest`) ja `develop` (v4, jonka versioksi nostetaan 4.0.0, npm
`nightly`). Haara-/kanavamalli, eteenpäin siirto ja tunnisteet on kuvattu tiedostossa
[RELEASE_STRATEGY.md](./RELEASE_STRATEGY.md); suunnitelma on [ROADMAPissa](../../ROADMAP.md) (vaihe 3). Haarautus suoritetaan kerran;
versiossa 3.8.58 se harjoitellaan alusta loppuun forkissa, ja 3.8.59 viimeistellään
[GO/NO-GO-tarkistuslistalla](./LTS_GO_NO_GO.md).
### Kuivakäynti (vain luku, turvallinen milloin tahansa)
### Kuivaharjoittelu (vain luku, turvallinen milloin tahansa)
```bash
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
npm run release:dry-run-lts-cut # varsinainen haarautus: 3.9.0 HEADista, edellinen tunniste v3.8.59
npm run release:dry-run-lts-cut -- --from <3.9.0-tip> # kiinnitä lähde-commit
```
`scripts/release/dry-run-lts-cut.mjs` ei suorita mitään: se lukee git ja `gh` ja tulostaa koko sekvenssin — -ehdot (lähde ratkaisee, lähdearkistolla on täysi historia — matala klooni ei voi työntää `stable/v3`, vastaanottava puoli hylkää paketin ensimmäisellä siirretyllä vanhemmalla, joten leikataan aiemmasta kloonista tai `git fetch --unshallow origin` on olemassa ensin — versio ongelma on avoin, ei avointa `release-freeze` -ongelmaa olemassa olevassa julkaisuhaarassa `Release branch not green` haara — jota ei ole olemassa `package.json` ilmoittaa `?` tuntematon, ei koskaan vihreä — omni-queue laskeutuu julkaisuun PRs (G11: `config/merge-queue/config.json` valid, sen `bases` hallitsee julkaisuhaaraa, `mode` `live`, sen nimiö on olemassa ja `release/*` -pushs anddeleet edelleen). `stable/v3` ei ole vielä olemassa), kaksi haaravaihetta, jotka lepotilan työnkulun laukaisevat ja `develop` `if:` ehdot muuttuvat todeksi (ja jotka pysyvät arkistomuuttujan porteilla tai kiinnitettyinä kanoniseen arkistoon), odotetut dist-tagit (`latest` → 3.9.0, `next` ja `nightly` tyhjä) ja palautus. Poistu `0` = `RESULT: READY`, `1` = a estoehto epäonnistui (`✗`), `2` = käyttövirhe. `--advisory <id,...>` alentaa shekin varoitukseksi (`!`) piilottamatta sitä.
`scripts/release/dry-run-lts-cut.mjs` ei suorita mitään: se lukee gitin ja `gh`:n tiedot ja tulostaa
koko sarjan — ennakkoehdot (lähde voidaan selvittää, lähderepossa on täydellinen historia —
matalasta kloonista ei voi puskea `stable/v3`-haaraa, koska vastaanottava osapuoli hylkää paketin ensimmäisen
liitetyn vanhemman kohdalla, joten tee haarautus täydestä kloonista tai suorita ensin `git fetch --unshallow origin` —
edellinen tunniste on olemassa, `package.json` sisältää kohdeversion, avoin `release-freeze`-issue on olemassa eikä
olemassa olevassa julkaisuhaarassa ole avointa
`Release branch not green` -issuea
— haara, jota ei ole olemassa, ilmoitetaan tuntemattomaksi `?`, ei koskaan vihreäksi —
Mergifyn `release`-jono on määritetty (G11: `queue_rules`, `checks_timeout`,
tunniste `queue`), `release/*`-sääntöjoukko estää edelleen poistamisen ja pakotetun puskemisen, eivätkä
`stable/v3` ja `develop` ole vielä olemassa), kaksi haaravaihetta, mitkä käyttämättöminä olleiden työnkulkujen
laukaisimet ja `if:`-ehdot muuttuvat tosiksi (ja mitkä pysyvät repomuuttujan estäminä tai
kanoniseen repoon kiinnitettyinä), odotetut dist-tagit (`latest` → 3.9.0, `next` ja
`nightly` tyhjiä) sekä palautus. Poistumiskoodi `0` = `RESULT: READY`, `1` = estävä ennakkoehto
epäonnistui (`✗`), `2` = käyttövirhe. `--advisory <id,...>` alentaa tarkistuksen varoitukseksi (`!`)
piilottamatta sitä.
Suorita todellisen leikkauksen kuivaajo, kun 3.9.0:n vapautusjäädytys on vielä auki — oksat luodaan tagin jälkeen ja ennen kuin vaihe 12c nostaa jäädytyksen.
Suorita varsinaisen haarautuksen kuivaharjoittelu, kun version 3.9.0 julkaisujäädytys on vielä voimassa — haarat
luodaan tunnisteen jälkeen ja ennen kuin vaihe 12c päättää jäädytyksen.
### 3.8.58 harjoitus (vain haarukka)
### Version 3.8.58 harjoittelu (vain forkissa)
```bash
# 1. Dry-run on the current tip with rehearsal parameters
# 1. Kuivaharjoittele nykyisellä kärjellä käyttäen harjoitteluparametreja
npm run release:dry-run-lts-cut -- --target-version 3.8.58 --previous-tag v3.8.57 \
--advisory freeze,base-green
# 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)
# 2. Suorita FORK-etärepoa vasten (origin tai mikä tahansa etärepo, jonka URL on kanonisen
# repon URL, hylätään; jokainen vaihe pyytää vahvistuksen päätteessä)
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. Exercise the dormant workflows in the fork (workflow_dispatch where the dry-run
# reports a canonical-repository pin), then roll back
# 3. Testaa forkissa käyttämättöminä olleet työnkulut (workflow_dispatch, jos kuivaharjoittelu
# ilmoittaa kiinnityksestä kanoniseen repoon) ja palauta sitten muutokset
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
```
Kehitysbump commit on rakennettu git-putkistolla (työpuuhun ei kosketa) ja se tekee samat viisi tiedostoa kuin cycl-open commit: `package.json`, `open-sse/package.json`, `electron/package.json`, `package-lock.json` ja `docs/openapi.yaml`. `[4.0.0]` CHANGELOG -osio ja sen i18n-peilit avataan `develop` ssa jälkeenpäin, ennen sen ensimmäistä PR. Käsikirjoitus ei koskaan muutu npm dist-tags — harjoittelee niitä scratch-paketissa.
Develop-versionnostocommit muodostetaan gitin matalan tason komennoilla (työpuuhun ei kosketa), ja se päivittää
samat viisi tiedostoa kuin kehityssyklin avaava commit: `package.json`, `open-sse/package.json`,
`electron/package.json`, `package-lock.json` ja `docs/openapi.yaml`. CHANGELOGin `[4.0.0]`-osio
ja sen i18n-vastineet avataan tämän jälkeen `develop`-haarassa ennen sen ensimmäistä
PR:ää. Skripti ei koskaan muuta npm:n dist-tageja — harjoittele niitä testipaketilla.
### PR preview artefakti (koonti kerran, mainosta samoja tavuja)
### PR-esikatseluartifakti (koosta kerran, ylennä samat tavut)
`.github/workflows/preview-artifact.yml` rakentaa yhden tuotantotarballin PR -päästä ja vahvistaa sen tarkan koontiversion (#8084 slice (a)). Vain saman arkiston PRs ; mitään ei julkaista.
`.github/workflows/preview-artifact.yml` koostaa yhden tuotantotarballin PR:n kärjestä ja
validoi täsmälleen kyseisen koosteen (#8084:n osa (a)). Vain saman repon PR:t; mitään ei julkaista.
```bash
gh workflow run preview-artifact.yml -f pr_number=<N> # or add the `preview-artifact` label
gh workflow run preview-artifact.yml -f pr_number=<N> # tai lisää `preview-artifact`-tunniste
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
npm install -g ./omniroute-*.tgz # esikatseluasennus
```
Suoritus suorittaa `npm ci`, `npm run build:release`, `npm run check:pack-artifact`, pakkaa tarballin, suorittaa `npm run check:pack-boot` (väärennössalaisuudet, lyhytaikainen datakansio), pakkaa uudelleen ja epäonnistuu, ellei tiivistelmä ole identtinen, ja tallentaa sitten `artifact-identity.json` (head SHA, base SHA, lockfile build, no policy ABI, q arch, no policy, de platform, — `scripts/release/artifact-identity.mjs`) ja todistaa tarballin erillisessä työssä. Esikatselun edistäminen tarkoittaa kyseisen tarballin asentamista: älä koskaan rakenna uudelleen lähteestä.
Suoritus ajaa komennot `npm ci`, `npm run build:release` ja `npm run check:pack-artifact`, paketoi
tarballin, ajaa komennon `npm run check:pack-boot` (väärennetyt salaisuudet, tilapäinen datahakemisto), paketoi uudelleen ja
epäonnistuu, ellei tiiviste ole identtinen, minkä jälkeen se tallentaa tiedoston `artifact-identity.json` (kärjen SHA, pohjan
SHA, lockfile-tiiviste, alusta, arkkitehtuuri, node ABI, paketoija, koostekäytäntö —
`scripts/release/artifact-identity.mjs`) ja varmentaa tarballin erillisessä työssä. Esikatselun
ylentäminen tarkoittaa kyseisen tarballin asentamista: älä koskaan koosta sitä uudelleen lähdekoodista.
### Leikkaus (3.9.0, GO jälkeen)
### Haarautus (3.9.0, GO-päätöksen jälkeen)
1. GO tallennettu muodossa [LTS_GO_NO_GO.md](./LTS_GO_NO_GO.md).
1. GO-päätös on kirjattu tiedostoon [LTS_GO_NO_GO.md](./LTS_GO_NO_GO.md).
2. `npm run release:dry-run-lts-cut -- --from v3.9.0` tulostaa `RESULT: READY`.
3. Luo `origin` haarat käsin komennoilla kuiva-ajo tulostaa — komentosarja kieltäytyy työntämästä tiedostoon `origin`. Jos haluat käyttää tarkistettua kehityssitoumusta uudelleen, suorita `--execute` -harjoitus 3.9.0-kärjellä ensin haarukkaa vasten; se tulostaa molemmat SHAs ja samat commits voidaan työntää:
3. Luo haarat käsin `origin`-repoon kuivaharjoittelun tulostamilla komennoilla —
skripti kieltäytyy puskemasta `origin`-repoon. Jos haluat käyttää uudelleen tarkastettua develop-committia, suorita
`--execute`-harjoittelu ensin version 3.9.0 kärjellä omaa forkiasi vasten; se tulostaa molemmat SHA:t, ja
samat commitit voidaan puskea:
```bash
git push origin <stable-sha>:refs/heads/stable/v3 <develop-sha>:refs/heads/develop
```
4. Suojaa `stable/v3` ja `develop` (sääntöjoukot + yhdistämisjono) ennen kuin ensimmäinen PR laskeutuu.
5. Lepotilassa olevat työnkulut kytkeytyvät päälle haaran olemassaolon mukaan: `forward-port.yml` (työnä `stable/v3`), `validate-stable-pr.yml` (PRs to `stable/v3`) ja `nightly-v4-build.yml` (rakenna `develop`). Aseta `secrets.FORWARD_PORT_TOKEN` tietovaraston salaisuus ennen käyttöönottoa (joten CI toimii eteenpäin suunnatussa portissa PRs); iltajulkaisu pysyy pois päältä, kunnes omistaja asettaa arkistomuuttujan `vars.NIGHTLY_PUBLISH` arvoksi `true` ja npm Trusted Publishing hyväksyy `nightly-v4-build.yml`. Kanavan resoluutio on `scripts/release/dist-tag.mjs`, jota `npm-publish.yml` käyttää.
6. Tarkista kanavat: `npm view omniroute dist-tags --json` näyttää `latest` = 3.9.0 ja ei `next` / `nightly` ennen kuin v4 julkaistaan.
7. Palautus tarvittaessa: `git push origin --delete refs/heads/stable/v3 refs/heads/develop` ja `npm dist-tag add omniroute@3.8.59 latest`.
4. Suojaa `stable/v3` ja `develop` (sääntöjoukot + yhdistämisjono) ennen ensimmäisen PR:n saapumista.
5. Lepotilassa olevat työnkulut aktivoituvat haaran olemassaolon perusteella: `forward-port.yml` (push kohteeseen
`stable/v3`), `validate-stable-pr.yml` (PR:t kohteeseen `stable/v3`) ja `nightly-v4-build.yml`
(koostaa `develop`-haaran). Aseta ennen käyttöönottoa repositorion salaisuus `secrets.FORWARD_PORT_TOKEN` (jotta CI suoritetaan
eteenpäin siirtävissä PR:issä); öinen julkaiseminen pysyy poissa käytöstä, kunnes omistaja asettaa repositorion
muuttujan `vars.NIGHTLY_PUBLISH` arvoksi `true` ja npm Trusted Publishing hyväksyy
`nightly-v4-build.yml`-työnkulun. Kanavan määritys tapahtuu tiedostossa `scripts/release/dist-tag.mjs`, jota myös
`npm-publish.yml` käyttää.
6. Tarkista kanavat: `npm view omniroute dist-tags --json` näyttää `latest` = 3.9.0 eikä
`next`- tai `nightly`-tunnisteita, ennen kuin v4 julkaistaan.
7. Palautus tarvittaessa: `git push origin --delete refs/heads/stable/v3 refs/heads/develop`
ja `npm dist-tag add omniroute@3.8.59 latest`.
---

View File

@@ -137,22 +137,36 @@ kerrallaan ja vain sen ollessa käyttämätön** siten, että käyttämättömyy
minuuttia, kun taas sen lähettäminen levyltä kesti 2 minuuttia.
- `.15`-VPS on tarkoitettu vain homologointiin — siinä ei koskaan suoriteta CI-suorittajia.
## Isännöity kaista (GitHubin isännöimät juoksijat)
## GitHub-hostattu suorituskaista (GitHub-hosted runners)
Arkisto kuuluu `cheaper-inference` -organisaatiolle** Joukkue** suunnitelma:** 60 concurrent hosted jobs** , joka jaetaan organisaation jokaisen arkiston, jokaisen PR tarkistuksen, jokaisen push-käynnistetty työnkulun ja CodeQL:n oletusasetuksen kanssa. The figures below were measured on the** Pro** plan (40 concurrent hosted jobs). Mitattu 18.10.2026 yhdistämiskampanjan aikana (~ 10 merges/hour on `release/v3.8.52`):** 2,500 workflow runs created in 24 h** , 44 pushes to the branch in 6 h,** 106 isännöityä työtä jonossa** kun PR -shekit odottivat tunteja ja PRs yhdistettiin ilman niitä. Yhdeksän työnkulkua käynnistettiin jokaisella oksalle tehdyllä työnnöllä:
Repositorio kuuluu `cheaper-inference`-organisaatiolle, joka on **Team**-tilauksessa: käytettävissä on **60
samanaikaista GitHub-hostattua työtä**, jotka jaetaan kaikkien organisaation repositorioiden, kaikkien PR-tarkistusten,
kaikkien push-tapahtumien käynnistämien työnkulkujen ja CodeQL:n oletusmäärityksen kesken. Alla olevat luvut mitattiin
**Pro**-tilauksen aikana (40 samanaikaista GitHub-hostattua työtä). Mittauksessa 2026-10-18
yhdistämiskampanjan aikana (~10 yhdistämistä tunnissa haarassa `release/v3.8.52`) **2 500 työnkulun suoritusta luotiin
24 tunnissa**, haaraan tehtiin 44 push-tapahtumaa 6 tunnissa ja **106 GitHub-hostattua työtä jäi jonoon**, kun PR-tarkistukset odottivat
tunteja ja PR:t yhdistettiin ilman niitä. Yhdeksän työnkulkua käynnistyi jokaisesta haaraan tehdystä push-tapahtumasta:
| per työntö `release/v*` | isännöityjä työpaikkoja | lopputulos myrskyn alla | 18.10.2026 alkaen |
| ------------------------------------------- | ----------------------: | ---------------------------------------------------------------- | ----------------------------------------------------------------------------------- |
| `ci.yml` (täysi matriisi) | 30 asti | peruutettu seuraavan työnnön yhteydessä, 24/24 päivässä | ei käynnistynyt `release/**` -työntöillä (PR run + Release-Green) |
| `quality.yml` | ~6 | peruutettu, 23/23 | ei käynnistynyt `release/**` -työntöillä |
| `Release-Green` `--quick` | 0 | juoksi `omni-build`, peruutettu 97/100 | `omni-release` -paikka, ei koskaan peruutettu, odotusaika romahtaa |
| `Lock released branch`, `OpenSSF Scorecard` | 2 | yksi jonossa oleva juoksu työntöä kohden | yksi juoksu per ref (`tests/unit/build/hosted-lane-concurrency.test.ts`) |
| `Release acceptance` (varjoraportti) | 1 | yksi isännöity `npm ci` työntöä kohti, ei koskaan peruutettu | muuttumaton — ehdokas `paths:` -suodattimelle |
| `Publish to Docker Hub` → `Deploy to VPS` | 2 | peruutettu työntöä kohti; amd64 jalka kilpailee `omni-build` | muuttumaton — omistajan käyttöönottokanava |
| CodeQL oletusasetukset (`dynamic`) | 4 | `javascript-typescript`, `actions`, `c-cpp`, `python` per työntö | muuttumaton — Asetukset → Koodin suojaus; `c-cpp`/`python` ei skannaa täällä mitään |
| per push kohteeseen `release/v*` | GitHub-hostattuja töitä | lopputulos ruuhkan aikana | 2026-10-18 alkaen |
| ------------------------------------------- | ----------------------: | -------------------------------------------------------------------------------------- | ---------------------------------------------------------------------------------- |
| `ci.yml` (koko matriisi) | enintään 30 | seuraava push peruutti, 24/24 yhden päivän aikana | ei käynnistetä `release/**`-push-tapahtumista (PR-suoritus + Release-Green) |
| `quality.yml` | ~6 | peruutettiin, 23/23 | ei käynnistetä `release/**`-push-tapahtumista |
| `Release-Green` `--quick` | 0 | suoritettiin `omni-build`-ympäristössä, 97/100 peruutettiin | `omni-release`-paikka, ei koskaan peruuteta, odottavat suoritukset yhdistetään |
| `Lock released branch`, `OpenSSF Scorecard` | 2 | yksi jonotettu suoritus kutakin push-tapahtumaa kohden | yksi suoritus viitettä kohden (`tests/unit/build/hosted-lane-concurrency.test.ts`) |
| `Release acceptance` (varjoraportti) | 1 | yksi GitHub-hostattu `npm ci` kutakin push-tapahtumaa kohden, ei koskaan peruuteta | ennallaan — ehdokas `paths:`-suodattimelle |
| `Publish to Docker Hub` → `Deploy to VPS` | 2 | peruutetaan push-tapahtumakohtaisesti; amd64-osuus kilpailee `omni-build`-ympäristössä | ennallaan — omistajan käyttöönottokanava |
| CodeQL:n oletusmääritys (`dynamic`) | 4 | `javascript-typescript`, `actions`, `c-cpp`, `python` kutakin push-tapahtumaa kohden | ennallaan — Settings → Code security; `c-cpp`/`python` eivät skannaa täällä mitään |
`tests/unit/build/push-storm-diet.test.ts` kiinnittää `ci.yml` ja `quality.yml`:n `main` -only push -liipaisimen. Sivuvaikutus: Codecov ei enää saa peruslatausta julkaisutyöntöä kohden (vaihe on informatiivinen ja `continue-on-error`); in-repo coverage gate ja PR kommentti eivät muutu.
`tests/unit/build/push-storm-diet.test.ts` lukitsee `ci.yml`- ja
`quality.yml`-tiedostojen push-käynnistimen vain `main`-haaraan. Sivuvaikutus: Codecov ei enää vastaanota peruslatausta kustakin julkaisuhaaran push-tapahtumasta (vaihe on
vain informatiivinen ja käyttää `continue-on-error`-asetusta); repositorion sisäinen kattavuusportti ja PR-kommentti
eivät muutu.
**Enemmän itseisännöityä kapasiteettia ei korjaa isännöityä jonoa.** Devbox (`devbox-vm-06-dev002`, 24 vCPU / 54 GB) voisi isännöidä juoksijaa, mutta agenttiistunnot pitävät jo kuormituksensa 20–26:ssa, agenttisäiliössä ei ole Docker daemonia ja kyllästetty kaista on isännöity. `.113` laatikossa oli 71 GB vapaata ja kuormaa 5–8 samalla hetkellä; sen rajoitus on yllä oleva kuuntelijakohtainen muistibudjetti (6 kuuntelijan enimmäismäärä), ei CPU. Loput ovat prosessivipuja: laske kampanja PRs Mergify-jonon läpi (`label=queue`, erät jakavat yhden `merge_group` CI -ajon yhden ajon sijasta PR kohti plus yksi per push), leikkaa CodeQL oletusasetuskieliä ja suodata `release-acceptance.yml` sen lukemien tiedostojen mukaan.
> **19.11.2026: Mergify-yhdistämisjono on poistettu käytöstä** (omistajan päätös). `.mergify.yml` ei enää määritä jonoa ja hylkää yhdistämiskomennot, jotka yhdistävät tai kirjoittavat uudelleen vetopyynnön. Julkaisut PRs yhdistetään käsin arkiston sääntöjoukon "Vaadi vihreät portit aktiivisessa julkaisussa" (`Gate / CI` + `Gate / Quality`) mukaisesti, kunnes omni-queue toimii live-tilassa, ja omni-jonon kautta sen jälkeen ( [OMNI_QUEUE.md](./OMNI_QUEUE.md) ). The Mergify lever above no longer exists.
**Itse ylläpidetyn kapasiteetin lisääminen ei korjaa GitHub-hostattua jonoa.** Kehityspalvelin
(`devbox-vm-06-dev002`, 24 vCPU / 54 GB) voisi isännöidä runneria, mutta agentti-istunnot pitävät jo
sen kuorman tasolla 20–26, agenttisäilössä ei ole Docker-daemonia, ja ylikuormittunut kaista on
GitHub-hostattu. `.113`-palvelimella oli samalla hetkellä 71 GB vapaata tilaa ja kuorma 5–8; sen rajoitteena
on edellä mainittu kuuntelijakohtainen muistibudjetti (enintään 6 kuuntelijaa), ei CPU. Jäljellä olevat keinot
liittyvät prosessiin: yhdistä kampanjan PR:t Mergify-jonon kautta (`label=queue`, jolloin erät jakavat
yhden `merge_group`-CI-suorituksen sen sijaan, että kutakin PR:ää ja push-tapahtumaa kohden tehtäisiin oma suoritus), karsi CodeQL:n
oletusmäärityksen kielet ja suodata `release-acceptance.yml` sen lukemien tiedostojen perusteella.

View File

@@ -29,8 +29,6 @@ Chaque reçu JSON identifie le SHA extrait, l'exécution et la tentative de flux
### Fusionner la file d'attente
> **19/11/2026 : la file d'attente de fusion Mergify est supprimée** (décision du propriétaire). `.mergify.yml` ne définit plus de file d'attente et refuse les commandes Mergify qui fusionnent ou réécrivent une pull request. Les versions PRs sont fusionnées manuellement sous l'ensemble de règles du référentiel "Exiger des portes vertes sur la version active" (`Gate / CI` + `Gate / Quality`) jusqu'à ce que la file d'attente omni s'exécute en mode live, et via la file d'attente omni après cela ( [OMNI_QUEUE.md](../ops/OMNI_QUEUE.md) ). La gestion du workflow des brouillons Mergify décrite ci-dessous est toujours dans `ci.yml` et `quality.yml`, mais aucun brouillon Mergify n'est plus ouvert.
L'étiquette `queue` envoie un PR à la file d'attente Mergify (`.mergify.yml`). Mergify ouvre un brouillon PR sur une branche `mergify/merge-queue/`, CI y exécute la sélection complète et le PR original fusionne lorsque `Gate / CI`, `Gate / Quality` et `Merge integrity (changelog + generated skills)` passent.
Mergify écrit son résumé de file d'attente dans la description du brouillon, et d'autres applications peuvent également le modifier. Un événement `pull_request` `edited` sur un tel brouillon prend son propre groupe de concurrence (`-queue-edit-<run_id>`), il ne peut donc pas annuler l'exécution réelle du brouillon et ignore la porte et la matrice. Seul `Merge integrity` fonctionne toujours. Le travail de porte ignoré porte un nom de contrôle différent, car Mergify lit un `Gate / CI` ignoré comme un échec de contrôle et retire le PR.
@@ -74,39 +72,39 @@ Les réexportations de barils et les importations dynamiques sont uniquement des
S'exécute sur chaque PR à `main`. Les blocs fusionnent en cas d'échec.
| Script (`npm run ...`) | Valide | Blocage |
| --------------------------------- | ---------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | ------------------------------------------- |
| `check:node-runtime` | la version Node.js se situe dans la plage prise en charge | Oui |
| `check:cycles` | Importations circulaires sur l'ensemble de `src/` + `open-sse/` (basé sur AST, tsconfig `paths` résolu). Bare quitte 1 chaque fois qu'un cycle existe (fermé en cas d'échec depuis #15281) et répertorie le SCCs. `check:cycles:ratchet` (ce que CI exécute) se bloque lorsque le nombre dépasse le plafond `metrics.cycles` dans `quality-baseline.json` — actuellement 14, `direction: down`, donc il ne peut que tomber (#15159 G-01/G-02) | Oui (cliquet) |
| `check:boundary` | Couplage `open-sse → src` : importations de fichier à fichier uniques du moteur vers l'application (`scripts/quality/measure-boundary.mjs`; la liste des bords est le backlog de remédiation core/module-split v4). Rapport consultatif = nu (identique à `quality:boundary`). `check:boundary:ratchet` (ce que CI exécute, également dans la boucle à cliquet à portes rapides `quality.yml` ) se bloque lorsque le nombre dépasse le plafond `metrics.boundaryOpenSseToSrc` dans `quality-baseline.json` — ensemencé à 771 mesuré, `direction: down`; `--update` ne fait que le baisser ; base-relative sur PRs (`--base-ref`, voir ci-dessous) | Oui (cliquet) |
| `check:route-validation:t06` | schémas Zod présents sur toutes les routes (politique de niveau 6) | Oui |
| `check:any-budget:t11` | Le nombre `@ts-expect-error // any` ne dépasse pas le budget (catraca de niveau 11) | Oui |
| `check:provider-consistency` | Chaque fournisseur de `providers.ts` a une entrée correspondante dans `providerRegistry.ts` (et vice-versa, dans la liste autorisée) | Oui |
| `check:model-lifecycle` | Les trois tables de routage gérées manuellement restent cohérentes avec l'instantané du cycle de vie enregistré (#11503) : `FITNESS_TABLE` (`taskFitness.ts`) n'obtient aucun identifiant retiré que `REGISTRY` peut acheminer ; chaque cible `BUILT_IN_ALIASES` est présente dans `REGISTRY` et absente de l'instantané retiré-id ; chaque identifiant retraité encore dans `REGISTRY` est transmis ou répertorié dans `allowedRetiredInCatalog`; et aucune source ou cible `DEFAULT_DEGRADATION_MAP` ne semble retirée dans cet instantané. Cela ne prouve pas qu'un modèle soit actuellement servi par un live en amont. Hors ligne — se compare à `config/quality/model-lifecycle.json`, actualisé à la main avec `npm run quality:refresh-model-lifecycle` (réseau ; non connecté à CI). `allowedRetiredInCatalog` est un cliquet de burn-down : ajoutez une entrée uniquement avec un problème de suivi. | Oui |
| `check:fetch-targets` | Chaque `fetch("/api/...")` dans `src/` côté client se résout en un vrai `route.ts` | Oui |
| `check:deps` | Tous les dépôts `npm install` -able sur chaque `package.json` du dépôt sont en `dependency-allowlist.json`; nouveaux packages non épinglés ou slopsquattés signalés | Oui |
| `audit:deps` | Audit npm des cinq fichiers de verrouillage indépendants (plugins racine, Electron, OpenCode, v1/v2 et fournisseur). Blocage des avis critiques ; les avis élevés restent des avertissements visibles. les audits Missing/failed sont INCOMPLETE et block ; les hachages de verrouillage et les rapports par portée sont conservés. | Oui |
| `check:lockfile` | intégrité `package-lock.json` registre https —, hachages d'intégrité, aucun remplacement d'hôte | Oui |
| `check:licenses` | liste d'autorisation de licence SPDX pour les dépendances de production | Oui |
| `check:tracked-artifacts` | Aucun artefact de construction / liens symboliques `node_modules` validés (fonctionne également dans le pré-commit husky ; le pré-push est intentionnellement léger — #6716) | Oui |
| `check:ai-attribution` | Pas de bande-annonce AI/bot `Co-Authored-By` ou de pied de page de génération AI dans les commits PR, le titre ou le corps — Hard Rule #16 (dans la boucle `quality.yml` fast-gates pour PR→ `release/**` — lit la charge utile de l'événement, aucune opération hors PRs — et une étape PR uniquement dans `ci.yml` lint pour PR→ `main`; également le husky crochet `commit-msg` ; co-auteurs humains autorisés ; #14436) |
| `check:vitest-exclusions` | Chaque exclusion Vitest nomme un problème de suivi et apparaît dans `config/quality/vitest-exclusions.json` (#13204) | Oui |
| `check:file-size` | Les fichiers sources (`.ts`/`.tsx` dans `src/`, `open-sse/`, `electron/`, `bin/`) restent dans `cap` et les fichiers de test (`*.test.ts(x)`) dans `testCap`; les fichiers gelés dans `file-size-baseline.json` (`frozen` / `testFrozen`) ne doivent pas dépasser leur taille enregistrée | Oui |
| `check:error-helper` | Les réponses d'erreur dans executors/handlers utilisent `buildErrorBody()` / `sanitizeErrorMessage()` (Hard Rule #12) | Oui |
| `check:migration-numbering` | Noms des fichiers de migration : l'ancienne série `001`–`241` est gelée et les nouveaux fichiers sont `YYYYMMDDHHMMSS_<description>.sql`. Par rapport à la base PR il rejette une migration supprimée, une migration renommée sans entrée de compatibilité et une migration dans le désordre ou modifiée dont le schéma final ne commute pas |
| `check:public-creds` | Pas de clés littérales OAuth `client_id`/`client_secret` ou Firebase Web en dehors de `publicCreds.ts` (Hard Rule #11) | Oui |
| `check:db-rules` | Pas de SQL brut en dehors des modules `src/lib/db/` ; pas d'importation de barils depuis `localDb.ts` (Hard Rules #2/#5) | Oui |
| `check:known-symbols` | Les exécuteurs du fournisseur, les stratégies de routage et les traducteurs enregistrés dans leurs tables de répartition correspondent aux fichiers sur le disque — pas de symboles orphelins ou non déclarés | Oui |
| `check:route-guard-membership` | Chaque route qui génère un processus enfant est classée par `isLocalOnlyPath()` (Hard Rules #15/#17) | Oui |
| `check:test-discovery` | Chaque fichier `*.test.ts` / `*.spec.ts` du dépôt est collecté par au moins un exécuteur de test (ratchet : la liste des orphelins dans `test-discovery-baseline.json` ne peut que diminuer) | Oui |
| `check:test-tla-order` | Aucun fichier `node:test` sous `tests/unit` n'enregistre un test, n'atteint un `await` de niveau supérieur, puis n'en enregistre davantage (#18045; ratchet : `test-tla-order-allowlist.json` ne peut que rétrécir) | Oui |
| `check:agent-skills-sync` | Les artefacts de compétences d'agent générés correspondent à leur catalogue source (pas de dérive). Le mode Release vérifie chaque compétence ; une fonctionnalité PR (mode `pr` ) vérifie uniquement les compétences dont elle édite le texte généré — voir [Fichiers générés et lignes de base dérivées](#generated-files-and-derived-baselines-written-at-release) |
| `check:provider-asset-provenance` | Le fournisseur logos/assets comporte une entrée de provenance enregistrée |
| `lint:json` | les fichiers de configuration JSON analysent et satisfont aux règles de repo lint |
| `typecheck:core` | compilation TypeScript sans erreurs (avertissements consultatifs uniquement) | Oui |
| `typecheck:noimplicit:core` | `noImplicitAny` strict — vers l'avenir ; de nombreux sites d'appel préexistants ont encore besoin d'annotations | **Consultatif** (`continue-on-error: true`) |
| `check:dashboard-typecheck` | `tsc` étendu à `src/app/(dashboard)/**` (#7033) — La liste autorisée de 27 fichiers de `typecheck:core` n'inclut aucun tableau de bord TSX, et `next build` ne le vérifie jamais non plus (`next.config.mjs` définit `ignoreBuildErrors: true`), donc les régressions d'identifiants orphelins (#6625/#6909) étaient invisibles pour CI. Les différences par rapport à une ligne de base de décompte per-file/per-TS-code gelée (`config/quality/dashboard-typecheck-baseline.json`, même modèle d'application obsolète que `check:known-symbols`) — seules les erreurs NEW au-delà du décompte de base font échouer la porte ; diminuez avec `--update` lorsqu'une erreur préexistante est corrigée. | Oui |
| `check:build-typecheck` | La vérification du type de production de l'application entière sur `tsconfig.build.json` (`src`, `open-sse`, `packages`, `bin`, `scripts`, `electron/**/*.d.ts`), la liste autorisée de 27 fichiers de la surface `typecheck:core` et la porte du tableau de bord ne couvrent pas. Diffère avec `config/quality/build-typecheck-baseline.json`; un décompte nouveau ou augmenté par (fichier, code) échoue, un décompte inférieur vous demande de cliqueter. `--update` refuse tant que l'exécution contient une paire nouvelle ou augmentée à moins que `--force-regressions` ne soit transmis, et refuse un fichier nouvellement réduit au silence à moins que `--force-nocheck` ne soit transmis, donc élargir la ligne de base pour passer au vert et accorder un silence permanent sont deux actes délibérés distincts. Un `--force` nu est rejeté. Analyse également la portée de construction de `@ts-nocheck` par rapport à `config/quality/ts-nocheck-baseline.json`, car un fichier qui l'utilise ne signale aucun diagnostic et serait autrement invisible pour chaque porte. | Oui |
| Script (`npm run ...`) | Valide | Blocage |
| --------------------------------- | -------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | ------------------------------------------- |
| `check:node-runtime` | La version Node.js se situe dans la plage prise en charge | Oui |
| `check:cycles` | Importations circulaires sur l'ensemble de `src/` + `open-sse/` (basé sur AST, tsconfig `paths` résolu). Bare quitte 1 chaque fois qu'un cycle existe (fermé en cas d'échec depuis #15281) et répertorie le SCCs. `check:cycles:ratchet` (ce que CI exécute) se bloque lorsque le nombre dépasse le plafond `metrics.cycles` dans `quality-baseline.json` — actuellement 14, `direction: down`, donc il ne peut que tomber (#15159 G-01/G-02) | Oui (cliquet) |
| `check:boundary` | Couplage `open-sse → src` : importations de fichier à fichier uniques du moteur vers l'application (`scripts/quality/measure-boundary.mjs`; la liste des bords est le backlog de remédiation core/module-split v4). Rapport consultatif = nu (identique à `quality:boundary`). `check:boundary:ratchet` (ce que CI exécute, également dans la boucle à cliquet à portes rapides `quality.yml` ) se bloque lorsque le nombre dépasse le plafond `metrics.boundaryOpenSseToSrc` dans `quality-baseline.json` — ensemencé à 771 mesuré, `direction: down`; `--update` ne fait que le baisser ; base-relative sur PRs (`--base-ref`, voir ci-dessous) | Oui (cliquet) |
| `check:route-validation:t06` | schémas Zod présents sur toutes les routes (politique de niveau 6) | Oui |
| `check:any-budget:t11` | Le nombre `@ts-expect-error // any` ne dépasse pas le budget (catraca de niveau 11) | Oui |
| `check:provider-consistency` | Chaque fournisseur de `providers.ts` a une entrée correspondante dans `providerRegistry.ts` (et vice-versa, dans la liste autorisée) | Oui |
| `check:model-lifecycle` | Les trois tables de routage gérées manuellement restent cohérentes avec l'instantané du cycle de vie enregistré (#11503) : `FITNESS_TABLE` (`taskFitness.ts`) n'obtient aucun identifiant retiré que `REGISTRY` peut acheminer ; chaque cible `BUILT_IN_ALIASES` est présente dans `REGISTRY` et absente de l'instantané retiré-id ; chaque identifiant retraité encore dans `REGISTRY` est transmis ou répertorié dans `allowedRetiredInCatalog`; et aucune source ou cible `DEFAULT_DEGRADATION_MAP` ne semble retirée dans cet instantané. Cela ne prouve pas qu'un modèle soit actuellement servi par un live en amont. Hors ligne — se compare à `config/quality/model-lifecycle.json`, actualisé à la main avec `npm run quality:refresh-model-lifecycle` (réseau ; non connecté à CI). `allowedRetiredInCatalog` est un cliquet de burn-down : ajoutez une entrée uniquement avec un problème de suivi. | Oui |
| `check:fetch-targets` | Chaque `fetch("/api/...")` dans `src/` côté client se résout en un vrai `route.ts` | Oui |
| `check:deps` | Tous les dépôts `npm install` -able sur chaque `package.json` du dépôt sont en `dependency-allowlist.json`; nouveaux packages non épinglés ou slopsquattés signalés | Oui |
| `audit:deps` | Audit npm des cinq fichiers de verrouillage indépendants (plugins racine, Electron, OpenCode, v1/v2 et fournisseur). Blocage des avis critiques ; les avis élevés restent des avertissements visibles. les audits Missing/failed sont INCOMPLETE et block ; les hachages de verrouillage et les rapports par portée sont conservés. | Oui |
| `check:lockfile` | intégrité `package-lock.json` registre https —, hachages d'intégrité, aucun remplacement d'hôte | Oui |
| `check:licenses` | liste d'autorisation de licence SPDX pour les dépendances de production | Oui |
| `check:tracked-artifacts` | Aucun artefact de construction / liens symboliques `node_modules` validés (fonctionne également dans le pré-commit husky ; le pré-push est intentionnellement léger — #6716) | Oui |
| `check:ai-attribution` | Pas de bande-annonce AI/bot `Co-Authored-By` ou de pied de page de génération AI dans les commits PR, le titre ou le corps — Hard Rule #16 (dans la boucle `quality.yml` fast-gates pour PR→ `release/**` — lit la charge utile de l'événement, aucune opération hors PRs — et une étape PR uniquement dans `ci.yml` lint pour PR→ `main`; également le husky crochet `commit-msg` ; co-auteurs humains autorisés ; #14436) |
| `check:vitest-exclusions` | Chaque exclusion Vitest nomme un problème de suivi et apparaît dans `config/quality/vitest-exclusions.json` (#13204) | Oui |
| `check:file-size` | Les fichiers sources (`.ts`/`.tsx` dans `src/`, `open-sse/`, `electron/`, `bin/`) restent dans `cap` et les fichiers de test (`*.test.ts(x)`) dans `testCap`; les fichiers gelés dans `file-size-baseline.json` (`frozen` / `testFrozen`) ne doivent pas dépasser leur taille enregistrée | Oui |
| `check:error-helper` | Les réponses d'erreur dans executors/handlers utilisent `buildErrorBody()` / `sanitizeErrorMessage()` (Hard Rule #12) | Oui |
| `check:migration-numbering` | Noms des fichiers de migration : l'ancienne série `001`–`241` est gelée et les nouveaux fichiers sont `YYYYMMDDHHMMSS_<description>.sql`. Par rapport à la base PR il rejette une migration supprimée, une migration renommée sans entrée de compatibilité et une migration dans le désordre ou modifiée dont le schéma final ne commute pas |
| `check:public-creds` | Pas de clés littérales OAuth `client_id`/`client_secret` ou Firebase Web en dehors de `publicCreds.ts` (Hard Rule #11) | Oui |
| `check:db-rules` | Pas de SQL brut en dehors des modules `src/lib/db/` ; pas d'importation de barils depuis `localDb.ts` (Hard Rules #2/#5) | Oui |
| `check:known-symbols` | Les exécuteurs du fournisseur, les stratégies de routage et les traducteurs enregistrés dans leurs tables de répartition correspondent aux fichiers sur le disque — pas de symboles orphelins ou non déclarés | Oui |
| `check:route-guard-membership` | Chaque route qui génère un processus enfant est classée par `isLocalOnlyPath()` (Hard Rules #15/#17) | Oui |
| `check:test-discovery` | Chaque fichier `*.test.ts` / `*.spec.ts` du dépôt est collecté par au moins un exécuteur de test (ratchet : la liste des orphelins dans `test-discovery-baseline.json` ne peut que diminuer) | Oui |
| `check:test-tla-order` | Aucun fichier `node:test` sous `tests/unit` n'enregistre un test, n'atteint un `await` de niveau supérieur, puis n'en enregistre davantage (#18045; ratchet : `test-tla-order-allowlist.json` ne peut que rétrécir) | Oui |
| `check:agent-skills-sync` | Les artefacts de compétences d'agent générés correspondent à leur catalogue source (pas de dérive). Le mode Release vérifie chaque compétence ; une fonctionnalité PR (mode `pr` ) vérifie uniquement les compétences dont elle édite le texte généré — voir [Fichiers générés et lignes de base dérivées](#generated-files-and-derived-baselines-written-at-release) |
| `check:provider-asset-provenance` | Le fournisseur logos/assets comporte une entrée de provenance enregistrée |
| `lint:json` | les fichiers de configuration JSON analysent et satisfont aux règles de repo lint |
| `typecheck:core` | compilation TypeScript sans erreurs (avertissements consultatifs uniquement) | Oui |
| `typecheck:noimplicit:core` | `noImplicitAny` strict — vers l'avenir ; de nombreux sites d'appel préexistants ont encore besoin d'annotations | **Consultatif** (`continue-on-error: true`) |
| `check:dashboard-typecheck` | `tsc` étendu à `src/app/(dashboard)/**` (#7033) — La liste autorisée de 27 fichiers de `typecheck:core` n'inclut aucun tableau de bord TSX, et `next build` ne le vérifie jamais non plus (`next.config.mjs` définit `ignoreBuildErrors: true`), donc les régressions d'identifiants orphelins (#6625/#6909) étaient invisibles pour CI. Les différences par rapport à une ligne de base de décompte per-file/per-TS-code gelée (`config/quality/dashboard-typecheck-baseline.json`, même modèle d'application obsolète que `check:known-symbols`) — seules les erreurs NEW au-delà du décompte de base font échouer la porte ; diminuez avec `--update` lorsqu'une erreur préexistante est corrigée. | Oui |
| `check:build-typecheck` | La vérification du type de production de l'application entière sur `tsconfig.build.json` (`src`, `open-sse`, `packages`, `bin`, `scripts`, `electron/**/*.d.ts`), la liste autorisée de 27 fichiers de la surface `typecheck:core` et la porte du tableau de bord ne couvrent pas. Diffs avec `config/quality/build-typecheck-baseline.json`; un décompte nouveau ou augmenté par (fichier, code) échoue, un décompte inférieur vous demande de cliqueter. `--update` refuse tant que l'exécution contient une paire nouvelle ou augmentée à moins que `--force-regressions` ne soit transmis, et refuse un fichier nouvellement réduit au silence à moins que `--force-nocheck` ne soit transmis, donc élargir la ligne de base pour passer au vert et accorder un silence permanent sont deux actes délibérés distincts. Un `--force` nu est rejeté. Analyse également la portée de construction de `@ts-nocheck` par rapport à `config/quality/ts-nocheck-baseline.json`, car un fichier qui l'utilise ne signale aucun diagnostic et serait autrement invisible pour chaque porte. | Oui |
#### Deux programmes de vérification de type répondent différemment
@@ -135,7 +133,7 @@ Fonctionne après `test-coverage`. Les blocs fusionnent en cas d'échec.
### Emploi : `quality-extended`
Travail mixte, sans `continue-on-error` au niveau du travail : une étape qui réussit `--ratchet` fait échouer le travail sur une régression mesurée par rapport à `quality-baseline.json`. Seuls `check:circular-deps` et l'étape d'installation du scanner sont consultatifs ( `continue-on-error: true` au niveau de l'étape). Les scanners externes s'installent via `gh release download`; `check:secrets` s'auto-saute (sortie 0) lorsque gitleaks est absent, tandis que `check:vuln-ratchet`, `check:workflows` et `check:openapi-breaking` échouent à la fermeture lorsque leur mesure est manquante.
Travail mixte, sans `continue-on-error` au niveau du travail : une étape qui réussit `--ratchet` fait échouer le travail sur une régression mesurée par rapport à `quality-baseline.json`. Seuls `check:circular-deps` et l'étape d'installation du scanner sont consultatifs ( `continue-on-error: true` au niveau de l'étape). Les scanners externes s'installent via `gh release download`; `check:secrets` s'auto-saute (sortie 0) lorsque gitleaks est absent, tandis que `check:vuln-ratchet`, `check:workflows` et `check:openapi-breaking` échouent lorsque leur mesure est manquante.
| Scénario | Valide | Blocage |
| ------------------------ | --------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | ----------------------------------------------------- |
@@ -189,10 +187,10 @@ Une fonctionnalité PR n'écrit jamais une valeur qui dépend de l'état de sa b
Qu'est-ce que `check:docs-counts` (`scripts/check/check-docs-counts-sync.mjs`) échoue dans chaque mode :
| Mode | Échec | A besoin des faits en direct |
| --------- | ---------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | ---------------------------- |
| `release` | A chaque contrôle, égalité stricte avec les faits collectés à partir de l'arbre (le comportement que le portail a toujours eu) : un décompte, une version, un plancher de couverture ou un numéro SVG est une dérive STRICT | Oui |
| `pr` | Seul ce que le changement a fait, comparé à la base PR avec les mêmes extracteurs de réclamations : (1) une valeur gérée qui n'existait pas dans la base pour cette vérification et ce fichier ("PR a modifié un numéro géré — a restauré la ligne dans le texte de base "); (2) une réclamation requise pour la base transportée et la tête perdue. Les invariants de contenu qui ne nécessitent aucun fait s'exécutent comme en mode version ; les vérifications de version uniquement sont répertoriées et ignorées | Non |
| Mode | Échec | A besoin des faits en direct |
| --------- | ---------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | ---------------------------- |
| `release` | A chaque contrôle, égalité stricte avec les faits collectés à partir de l'arbre (le comportement que le portail a toujours eu) : un décompte, une version, un plancher de couverture ou un numéro SVG est une dérive STRICT | Oui |
| `pr` | Seul ce que le changement a fait, comparé à la base PR avec les mêmes extracteurs de réclamations : (1) une valeur gérée qui n'existait pas dans la base pour cette vérification et ce fichier ("PR a modifié un numéro géré — a restauré la ligne dans le texte de base "); (2) une réclamation requise pour la base transportée et la tête perdue. Les invariants de contenu qui ne nécessitent aucun fait s'exécutent comme en mode version ; les contrôles de version uniquement sont répertoriés et ignorés | Non |
Les fichiers d'instructions de l'agent portent** Non** nombre dérivé : `AGENTS.md`, `llm.txt` (et ses copies `docs/i18n/*/llm.txt` ), le fork bs `AGENTS.md`, `open-sse/services/AGENTS.md`, `src/shared/constants/agentSkills.ts`, `skills/README.md` et chaque `skills/*/SKILL.md` pointent vers la source (par exemple `ROUTING_STRATEGY_VALUES` dans `src/shared/constants/routingStrategies.ts`) et vers `npm run facts` à la place. L'invariant "Aucun décompte dérivé (fichier d'instructions d'agent …)" échoue dans un décompte (fournisseurs, migrations, outils et étendues MCP, stratégies de routage, facteurs de notation, packs de modes) dans les deux modes, de sorte que l'actualisation de la version n'a jamais besoin de réécrire un fichier d'instructions.
@@ -299,7 +297,7 @@ Fonctionne après `build`. Les blocs fusionnent en cas d'échec.
| Suite | Valide | Blocage |
| ---------------- | ---------------------------------------------------------- | ----------------------------------------------------------------------------------------------------------------------------------- |
| `test:vitest` | serveur MCP (110 outils), autoCombo, cache — vitest runner | Oui |
| `test:vitest:ui` | test de composants UI — vitest runner | **Blocage** les échecs préexistants — sont explicitement exclus dans `vitest.config.ts`; de nouveaux échecs font échouer le travail |
| `test:vitest:ui` | tests de composants UI — vitest runner | **Blocage** les échecs préexistants — sont explicitement exclus dans `vitest.config.ts`; de nouveaux échecs font échouer le travail |
### Flux de travail nocturnes (programmés, consultatifs)

View File

@@ -4,9 +4,14 @@
---
OmniRoute utilise un** cycle parallèle** modèle de version : une branche `release/vX.Y.Z` dédiée pour le cycle actif, `main` pour la ligne publiée et une balise `vX.Y.Z` immuable lorsque ce cycle est expédié. Voir les commits atterrir sur `release/*` _et_ sur `main` est attendu — ce n'est pas une confusion.
OmniRoute utilise un modèle de publication en **cycles parallèles** : une branche dédiée `release/vX.Y.Z`
pour le cycle actif, `main` pour la lignée publiée et un tag immuable
`vX.Y.Z` lorsque ce cycle est publié. Il est normal de voir des commits arriver à la fois sur `release/*` _et_ sur
`main` — ce n’est pas une erreur.
Les détails du responsable résident dans `CLAUDE.md` (Hard Rule #21) et [RELEASE_CHECKLIST.md](./RELEASE_CHECKLIST.md). Cette page est le résumé public destiné aux contributeurs.
Les détails destinés aux mainteneurs figurent dans `CLAUDE.md` (règle stricte nº 21) et
[RELEASE_CHECKLIST.md](./RELEASE_CHECKLIST.md). Cette page en présente le résumé public
destiné aux contributeurs.
## En bref
@@ -37,23 +42,25 @@ flowchart LR
`main` n’est pas la branche d’intégration quotidienne. Les PR ouvertes vers `main`
doivent généralement être redirigées avant leur fusion.
## Libérer le gel (cycles parallèles)
## Gel de publication (cycles parallèles)
Lorsqu'une version est rapprochée, un problème de marqueur intitulé `release-freeze` est ouvert. Que** n'arrête pas le développement** :
Lorsqu’une publication est en cours de rapprochement, une issue servant de marqueur et portant le label `release-freeze` est
ouverte. Cela **n’interrompt pas le développement** :
- Le `release/vX.Y.Z` gelé appartient au capitaine de libération de ce navire.
- Le `release/vX+1` du cycle suivant est coupé de la pointe gelée afin que les contributeurs continuent à travailler.
- PRs ouvert qui cible toujours la branche gelée devrait être** reciblé** à la branche `release/v*` active (la plus élevée).
- La branche `release/vX.Y.Z` gelée est sous la responsabilité du responsable de cette publication.
- La branche `release/vX+1` du cycle suivant est créée depuis la pointe gelée afin que les contributeurs puissent continuer
à intégrer leurs travaux.
- Les PR ouvertes qui ciblent encore la branche gelée doivent être **redirigées** vers la branche
`release/v*` active (celle ayant la version la plus élevée).
Recherchez un gel ouvert avant de supposer que la branche souhaitée est fusionnable :
Vérifiez s’il existe un gel en cours avant de supposer que la branche souhaitée accepte les fusions :
```bash
gh issue list --repo diegosouzapw/OmniRoute --label release-freeze --state open
```
Les mécanismes de fusion (propriétaire `queue` label → Mergify) sont documentés dans [MERGE_TRAIN.md](./MERGE_TRAIN.md).
> **19/11/2026 : la file d'attente de fusion Mergify est supprimée** (décision du propriétaire). `.mergify.yml` ne définit plus de file d'attente et refuse les commandes Mergify qui fusionnent ou réécrivent une pull request. Les versions PRs sont fusionnées manuellement selon l'ensemble de règles du référentiel "Exiger des portes vertes sur la version active" (`Gate / CI` + `Gate / Quality`) jusqu'à ce que la file d'attente omni s'exécute en mode live, et via la file d'attente omni après cela ( [OMNI_QUEUE.md](./OMNI_QUEUE.md) ). Le label `queue` ne fusionne plus rien.
Les mécanismes de fusion (label `queue` du propriétaire → Mergify) sont documentés dans
[MERGE_TRAIN.md](./MERGE_TRAIN.md).
## Pourquoi une branche et un tag ?

View File

@@ -4,9 +4,10 @@
---
> **19/11/2026 : la file d'attente de fusion Mergify est supprimée** (décision du propriétaire). `.mergify.yml` ne définit plus de file d'attente et refuse les commandes Mergify qui fusionnent ou réécrivent une pull request. Les versions PRs sont fusionnées manuellement selon l'ensemble de règles du référentiel "Exiger des portes vertes sur la version active" (`Gate / CI` + `Gate / Quality`) jusqu'à ce que la file d'attente omni s'exécute en mode live, et via la file d'attente omni après cela ( [OMNI_QUEUE.md](./OMNI_QUEUE.md) ). Les sections Mergify ci-dessous décrivent la file d'attente telle qu'elle était.
Depuis la v3.8.49 (WS3.2/WS3.4 du plan quality/velocity ), le chemin de fusion par défaut pour PRs révisé dans `release/vX.Y.Z` est le** Fusionner la file d'attente de fusion** (`.mergify.yml`); le** train de fusion manuel** documenté ci-dessous est le FALLBACK — utilisé lors d'incidents, de blocages de versions ou si le plan Mergify Open Source change un jour.
Depuis la v3.8.49 (WS3.2/WS3.4 du plan qualité/vélocité), le chemin de fusion par défaut des
PR examinées vers `release/vX.Y.Z` est la **file de fusion Mergify** (`.mergify.yml`) ;
le **train de fusion manuel** décrit ci-dessous est la SOLUTION DE REPLI — utilisée pendant les incidents,
les gels de version, ou si jamais l’offre Open Source de Mergify venait à changer.
## Chemin par défaut : la file d’attente Mergify

View File

@@ -354,70 +354,111 @@ Avant de publier toute version v3.8.x, vérifiez également les éléments suiva
---
## 3.9.0 LTS cut (répété en 3.8.58)
## Découpage de la version LTS 3.9.0 (répété avec la version 3.8.58)
Après la v3.8.59, la version suivante est la 3.9.0, et sa pointe devient deux branches de longue durée : `stable/v3` (la ligne LTS v3, npm `latest`) et `develop` (v4, passée à 4.0.0, npm `nightly`). Le modèle branch/channel, le port direct et les étiquettes sont dans [RELEASE_STRATEGY.md](./RELEASE_STRATEGY.md) ; le plan est dans le [ROADMAP](../../ROADMAP.md) (Phase 3). La coupe s'exécute une fois ; 3.8.58 le répète bout à bout sur un fork, et 3.8.59 se termine avec la [liste de contrôle GO/NO-GO](./LTS_GO_NO_GO.md).
Après la v3.8.59, la version suivante est la 3.9.0, et son sommet devient deux branches à longue durée de vie :
`stable/v3` (la ligne LTS v3, npm `latest`) et `develop` (v4, passée à 4.0.0, npm
`nightly`). Le modèle de branches/canaux, le portage en aval et les labels sont décrits dans
[RELEASE_STRATEGY.md](./RELEASE_STRATEGY.md) ; le plan figure dans la [FEUILLE DE ROUTE](../../ROADMAP.md) (Phase 3). Le découpage n'est effectué qu'une fois ;
la version 3.8.58 permet de le répéter de bout en bout sur un fork, et la version 3.8.59 se termine avec la
[liste de contrôle GO/NO-GO](./LTS_GO_NO_GO.md).
### Exécution à sec (lecture seule, sécurisée à tout moment)
### Simulation (lecture seule, sûre à tout moment)
```bash
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
npm run release:dry-run-lts-cut # le véritable découpage : 3.9.0 depuis HEAD, balise précédente v3.8.59
npm run release:dry-run-lts-cut -- --from <3.9.0-tip> # épingler le commit source
```
`scripts/release/dry-run-lts-cut.mjs` n'exécute rien : il lit git et `gh` et imprime la séquence entière des conditions préalables — (la source est résolue, le référentiel source a un historique complet — un clone superficiel ne peut pas pousser `stable/v3`, le côté récepteur rejette le pack au premier parent greffé, donc coupé d'un clone complet ou `git fetch --unshallow origin` en premier — la balise précédente existe, `package.json` est la version cible, un problème `release-freeze` est ouvert, aucun problème `Release branch not green` ouvert sur une branche de version existante — une branche qui n'existe pas signale `?` inconnu, jamais verte la file d'attente omni — obtient la version PRs (G11 : `config/merge-queue/config.json` valide, son `bases` gère la branche de version, `mode` `live`, son étiquette existe), l'ensemble de règles `release/*` bloque toujours la suppression et la poussée forcée, et `stable/v3` et `develop` n'existent pas encore), les deux étapes de branche, qui dorment-workflow les déclencheurs et les conditions `if:` deviennent vrais (et qui restent contrôlés par une variable du référentiel ou épinglés au référentiel canonique), les balises dist attendues (`latest` → 3.9.0, `next` et `nightly` vides) et la restauration. Quittez `0` = `RESULT: READY`, `1` = une condition préalable de blocage a échoué (`✗`), erreur d'utilisation `2` =. `--advisory <id,...>` rétrograde une vérification en avertissement (`!`) sans la masquer.
`scripts/release/dry-run-lts-cut.mjs` n'exécute rien : il lit git et `gh`, puis affiche la
séquence complète — les conditions préalables (la source est résolue, le dépôt source possède un historique complet —
un clone superficiel ne peut pas pousser `stable/v3`, le côté récepteur rejette le paquet au premier
parent greffé ; effectuez donc le découpage depuis un clone complet ou exécutez d'abord `git fetch --unshallow origin` — la balise
précédente existe, `package.json` contient la version cible, un ticket `release-freeze` est ouvert, aucun
ticket `Release branch not green` ouvert
sur une branche de publication existante — une branche qui n'existe pas renvoie `?` pour inconnu, jamais
vert — la file d'attente `release` de Mergify est configurée (G11 : `queue_rules`, `checks_timeout`,
label `queue`), le jeu de règles `release/*` bloque toujours la suppression et le push forcé, et
`stable/v3` et `develop` n'existent pas encore), les deux étapes de branchement, les déclencheurs de workflows
dormants et les conditions `if:` qui deviennent vraies (ainsi que celles qui restent bloquées par une variable
de dépôt ou épinglées au dépôt canonique), les dist-tags attendus (`latest` → 3.9.0, `next` et
`nightly` vides) et le retour arrière. Code de sortie `0` = `RESULT: READY`, `1` = échec d'une condition
préalable bloquante (`✗`), `2` = erreur d'utilisation. `--advisory <id,...>` rétrograde une vérification en
avertissement (`!`) sans la masquer.
Exécutez l'essai à sec de la coupe réelle pendant que le gel de la version 3.9.0 est encore ouvert — les branches sont créées après la balise et avant que la phase 12c ne lève le gel.
Exécutez la simulation du véritable découpage pendant que le gel de publication de la version 3.9.0 est toujours actif — les branches sont
créées après la balise et avant que la Phase 12c ne lève le gel.
### 3.8.58 répétition (fork seulement)
### Répétition avec la version 3.8.58 (fork uniquement)
```bash
# 1. Dry-run on the current tip with rehearsal parameters
# 1. Simulation sur le sommet actuel avec les paramètres de répétition
npm run release:dry-run-lts-cut -- --target-version 3.8.58 --previous-tag v3.8.57 \
--advisory freeze,base-green
# 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)
# 2. Exécution sur un dépôt distant de type FORK (`origin`, ou tout dépôt distant dont l'URL est celle du dépôt
# canonique, est refusé ; chaque étape demande une confirmation dans le 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. Exercise the dormant workflows in the fork (workflow_dispatch where the dry-run
# reports a canonical-repository pin), then roll back
# 3. Exécution des workflows dormants dans le fork (`workflow_dispatch` lorsque la simulation
# signale un épinglage au dépôt canonique), puis retour arrière
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
```
Le commit de développement est construit avec git plumbing (aucun arbre de travail n'est touché) et supprime les cinq mêmes fichiers qu'un commit à ouverture de cycle : `package.json`, `open-sse/package.json`, `electron/package.json`, `package-lock.json` et `docs/openapi.yaml`. La section `[4.0.0]` CHANGELOG et ses miroirs i18n sont ensuite ouverts sur `develop`, avant son premier PR. Le script ne change jamais les balises npm dist — pour répéter celles d'un package de travail.
Le commit de passage de `develop` à la version suivante est créé avec la plomberie git (aucun arbre de travail n'est modifié) et met à jour
les cinq mêmes fichiers qu'un commit d'ouverture de cycle : `package.json`, `open-sse/package.json`,
`electron/package.json`, `package-lock.json` et `docs/openapi.yaml`. La section `[4.0.0]` du
CHANGELOG et ses miroirs i18n sont ensuite ouverts sur `develop`, avant sa première
PR. Le script ne modifie jamais les dist-tags npm — répétez cette opération sur un package de test.
### Artefact d'aperçu PR (construit une fois, favorise les mêmes octets)
### Artefact de prévisualisation de PR (compiler une fois, promouvoir exactement les mêmes octets)
`.github/workflows/preview-artifact.yml` crée une archive tar de production à partir d'une tête PR et valide cette version exacte (#8084 slice (a)). PRs dans le même référentiel uniquement ; rien n'est publié.
`.github/workflows/preview-artifact.yml` compile une archive tar de production à partir de la tête d'une PR et
valide exactement ce même build (partie (a) de #8084). Uniquement pour les PR provenant du même dépôt ; rien n'est publié.
```bash
gh workflow run preview-artifact.yml -f pr_number=<N> # or add the `preview-artifact` label
gh workflow run preview-artifact.yml -f pr_number=<N> # ou ajouter le label `preview-artifact`
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
npm install -g ./omniroute-*.tgz # installation de prévisualisation
```
L'exécution effectue `npm ci`, `npm run build:release`, `npm run check:pack-artifact`, emballe l'archive tar, exécute `npm run check:pack-boot` (faux secrets, répertoire de données éphémères), remballe et échoue à moins que le résumé ne soit identique, puis enregistre `artifact-identity.json` (tête SHA, base SHA, hachage de fichier de verrouillage, plateforme, arch, nœud ABI, bundler, politique de construction — `scripts/release/artifact-identity.mjs`) et atteste l'archive tar dans un travail à part. Promouvoir un aperçu signifie installer cette archive tar : ne jamais reconstruire à partir des sources.
L'exécution lance `npm ci`, `npm run build:release`, `npm run check:pack-artifact`, empaquette
l'archive tar, lance `npm run check:pack-boot` (faux secrets, répertoire de données éphémère), recrée le paquet et
échoue si l'empreinte n'est pas identique, puis enregistre `artifact-identity.json` (SHA de la tête, SHA de la base,
empreinte du fichier de verrouillage, plateforme, architecture, ABI Node, bundler, politique de build —
`scripts/release/artifact-identity.mjs`) et atteste l'archive tar dans une tâche distincte. Promouvoir
une prévisualisation signifie installer cette archive tar : ne la recompilez jamais depuis les sources.
### La coupe (3.9.0, après GO)
### Le découpage (3.9.0, après le GO)
1. GO enregistré dans [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. Créez les branches sur `origin` à la main avec les commandes, l'exécution à sec imprime — le script refuse de pousser vers `origin`. Pour réutiliser un commit de développement révisé, exécutez d'abord la répétition `--execute` sur la pointe 3.9.0 contre votre fork ; il imprime les deux SHAs, et les mêmes commits peuvent être poussés :
1. GO consigné dans [LTS_GO_NO_GO.md](./LTS_GO_NO_GO.md).
2. `npm run release:dry-run-lts-cut -- --from v3.9.0` affiche `RESULT: READY`.
3. Créez manuellement les branches sur `origin` avec les commandes affichées par la simulation — le
script refuse de pousser vers `origin`. Pour réutiliser un commit `develop` révisé, lancez d'abord la
répétition avec `--execute` sur le sommet de la version 3.9.0 vers votre fork ; elle affiche les deux SHA, et
les mêmes commits peuvent être poussés :
```bash
git push origin <stable-sha>:refs/heads/stable/v3 <develop-sha>:refs/heads/develop
```
4. Protégez `stable/v3` et `develop` (file d'attente de fusion des ensembles de règles + ) avant l'arrivée du premier PR.
5. Les workflows dormants s'activent selon l'existence d'une branche : `forward-port.yml` (push to `stable/v3`), `validate-stable-pr.yml` (PRs to `stable/v3`) et `nightly-v4-build.yml` (builds `develop`). Avant la mise en ligne, définissez le secret du référentiel `secrets.FORWARD_PORT_TOKEN` (pour que CI s'exécute sur le port forward PRs) ; la publication nocturne reste désactivée jusqu'à ce que le propriétaire définisse la variable du référentiel `vars.NIGHTLY_PUBLISH` sur `true` et que npm Trusted Publishing accepte `nightly-v4-build.yml`. La résolution du canal est `scripts/release/dist-tag.mjs`, le même résolveur `npm-publish.yml` utilise.
6. Vérifiez les chaînes : `npm view omniroute dist-tags --json` affiche `latest` = 3.9.0 et pas `next` / `nightly` jusqu'à la publication de la v4.
7. Rollback, si nécessaire : `git push origin --delete refs/heads/stable/v3 refs/heads/develop` et `npm dist-tag add omniroute@3.8.59 latest`.
4. Protégez `stable/v3` et `develop` (ensembles de règles + file d’attente de fusion) avant l’arrivée de la première PR.
5. Les workflows inactifs s’activent lorsque les branches existent : `forward-port.yml` (push vers
`stable/v3`), `validate-stable-pr.yml` (PR vers `stable/v3`) et `nightly-v4-build.yml`
(builds de `develop`). Avant la mise en production, définissez le secret de dépôt `secrets.FORWARD_PORT_TOKEN` (afin que la CI s’exécute sur
les PR de report en avant) ; la publication nocturne reste désactivée jusqu’à ce que le propriétaire définisse la variable de dépôt
`vars.NIGHTLY_PUBLISH` sur `true` et que npm Trusted Publishing accepte
`nightly-v4-build.yml`. La résolution des canaux se trouve dans `scripts/release/dist-tag.mjs`, le même
résolveur que celui utilisé par `npm-publish.yml`.
6. Vérifiez les canaux : `npm view omniroute dist-tags --json` affiche `latest` = 3.9.0 et aucun
`next` / `nightly` jusqu’à la publication de la v4.
7. Restauration, si nécessaire : `git push origin --delete refs/heads/stable/v3 refs/heads/develop`
et `npm dist-tag add omniroute@3.8.59 latest`.
---

Some files were not shown because too many files have changed in this diff Show More