@starci/eslint-canon-be 3.16.3 → 3.17.0
This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
package/CHANGELOG.md
CHANGED
|
@@ -1,5 +1,17 @@
|
|
|
1
1
|
# Changelog
|
|
2
2
|
|
|
3
|
+
## 3.17.0 - 2026-11-04
|
|
4
|
+
|
|
5
|
+
- Changed: the runtime copies carry the R378 and R379 laws of `@starci/hfs` 5.10.0 and its canon pins.
|
|
6
|
+
|
|
7
|
+
## 3.16.5 - 2026-11-04
|
|
8
|
+
|
|
9
|
+
- Changed: the runtime copy of the canon pins names `@starci/hfs` 5.9.1.
|
|
10
|
+
|
|
11
|
+
## 3.16.4 - 2026-11-04
|
|
12
|
+
|
|
13
|
+
- Changed: the runtime copies carry the R377 law of `@starci/hfs` 5.9.0 and its canon pins.
|
|
14
|
+
|
|
3
15
|
## 3.16.3 - 2026-11-04
|
|
4
16
|
|
|
5
17
|
- Changed: the runtime copy of the canon pins names `@starci/hfs` 5.8.3.
|
package/package.json
CHANGED
|
@@ -38,7 +38,7 @@ pins:
|
|
|
38
38
|
source: packages/next-data/package.json
|
|
39
39
|
why: 'the SWR data helpers of every front end (fe-stack data, owner:next-data-package): pollingRestart, the viewer and tenant key helpers, viewerSwrConfig and the viewer cache; each operation hook stays in the app and the package holds no component.'
|
|
40
40
|
'@starci/grammar':
|
|
41
|
-
version: 0.21.
|
|
41
|
+
version: 0.21.29
|
|
42
42
|
group: starci
|
|
43
43
|
install: registry
|
|
44
44
|
side: fe
|
|
@@ -52,28 +52,28 @@ pins:
|
|
|
52
52
|
source: packages/next-i18n/package.json
|
|
53
53
|
why: 'the next-intl stack of every front end (fe-stack i18n, owner:next-i18n-package): defineI18n over the locales of the app, the locale-negotiating proxy, the locale-aware navigation, the request config that loads the catalogs of the app and the locale read of the [locale] layout; the app keeps its message catalogs and writes none of the stack.'
|
|
54
54
|
'@starci/eslint-canon-be':
|
|
55
|
-
version: 3.
|
|
55
|
+
version: 3.17.0
|
|
56
56
|
group: starci
|
|
57
57
|
install: registry
|
|
58
58
|
side: be
|
|
59
59
|
source: packages/eslint-canon-be/package.json
|
|
60
60
|
why: 'the back-end ESLint canon: `loadHfs(import.meta.url)` of be/eslint.config.mjs finds the app-root hfs.json (kind app) and gives every linted file the view of the be side, and the project graph is built per side; its bundled runtime copies (slots, canon-pins, failure codes, the architecture machine) put .starcistacks and .sops.yaml at the app root; `starciBeConfig({ hfs: loadHfs(import.meta.url) })` is the typed factory and the BE-CONVENTION laws are its rules.'
|
|
61
61
|
'@starci/eslint-canon-fe':
|
|
62
|
-
version: 9.13.
|
|
62
|
+
version: 9.13.12
|
|
63
63
|
group: starci
|
|
64
64
|
install: registry
|
|
65
65
|
side: fe
|
|
66
66
|
source: packages/eslint-canon-fe/package.json
|
|
67
67
|
why: 'the front-end ESLint canon: `loadHfs(import.meta.url)` of fe/eslint.config.mjs finds the app-root hfs.json (kind app) and gives every linted file the view of the fe side, and the project graph is built per side; its bundled runtime copies (slots, canon-pins, failure codes, the architecture machine) put .starcistacks and .sops.yaml at the app root; the front end has no tests (FE_NO_TESTS R97 in hfs) and no-vietnamese-in-source (R91) applies.'
|
|
68
68
|
'@starci/eslint-grammar-core':
|
|
69
|
-
version: 0.21.
|
|
69
|
+
version: 0.21.29
|
|
70
70
|
group: starci
|
|
71
71
|
install: registry
|
|
72
72
|
side: fe
|
|
73
73
|
source: packages/eslint-grammar-core/package.json
|
|
74
74
|
why: 'the StarCi Grammar component API lint, versioned with @starci/grammar; front ends compose this family package with the universal FE canon.'
|
|
75
75
|
'@starci/eslint-grammar-offset-pop':
|
|
76
|
-
version: 0.21.
|
|
76
|
+
version: 0.21.29
|
|
77
77
|
group: starci
|
|
78
78
|
install: registry
|
|
79
79
|
side: fe
|
|
@@ -120,7 +120,7 @@ pins:
|
|
|
120
120
|
source: packages/ai-router/package.json
|
|
121
121
|
why: 'the AI pool router of a back end: a NestJS module that routes OpenAI-compatible chat, stream and embeddings calls across keys, models and providers, with @starci/ai-router/testing for its specs; @starci/jest-preset compiles it as an ESM-only dependency.'
|
|
122
122
|
'@starci/nest-kit':
|
|
123
|
-
version: 0.
|
|
123
|
+
version: 0.2.0
|
|
124
124
|
group: starci
|
|
125
125
|
install: registry
|
|
126
126
|
side: be
|
|
@@ -155,7 +155,7 @@ pins:
|
|
|
155
155
|
source: packages/mail/package.json
|
|
156
156
|
why: 'outgoing mail of a back end: a NestJS module and the Mailer port over SMTP (connect, greeting, socket and total timeouts, STARTTLS required by default, recipient, message and attachment checks, a shared SMTP target policy, coded errors, typed escaping render helpers returning { subject, text, html }), with @starci/mail/testing for its specs; the only importer of nodemailer (R90).'
|
|
157
157
|
'@starci/hfs':
|
|
158
|
-
version: 5.
|
|
158
|
+
version: 5.10.0
|
|
159
159
|
group: starci
|
|
160
160
|
install: registry
|
|
161
161
|
side: both
|
|
@@ -6040,10 +6040,10 @@ rules:
|
|
|
6040
6040
|
code: "HFS_CHECK_CACHE_FORGED"
|
|
6041
6041
|
editions: ["lite", "full"]
|
|
6042
6042
|
docs: [contexts/hfs/README.md#rule-notes]
|
|
6043
|
-
law: "An app's committed check cache (.starcistacks/cache/) is trusted in CI only as it stands at the trusted base; a record whose key matches the tree and whose findings differ from the inherited or computed result is HFS_CHECK_CACHE_FORGED (a hard blocker at any count), a touched key without a current record is HFS_CHECK_CACHE_STALE and a missing cache is HFS_CHECK_CACHE_MISSING (both report-only warnings in CI); every push carries the warm cache a real run on its tree writes, refused at the pre-push hook as HFS_CHECK_CACHE_UNWARMED (a cache that run had to change, or uncommitted cache files) or HFS_CHECK_CACHE_UNPORTABLE (a host whose fingerprint is not portable); and the release gate, which trusts the warm cache, is refused HFS_CHECK_CACHE_VERIFY_LOCKED while the newest nightly verify of the default branch is red or cannot be read."
|
|
6043
|
+
law: "An app's committed check cache (.starcistacks/cache/) is trusted in CI only as it stands at the trusted base; a record whose key matches the tree and whose findings differ from the inherited or computed result is HFS_CHECK_CACHE_FORGED (a hard blocker at any count), a touched key without a current record is HFS_CHECK_CACHE_STALE and a missing cache is HFS_CHECK_CACHE_MISSING (both report-only warnings in CI); every push carries the warm cache a real run on its tree writes, refused at the pre-push hook as HFS_CHECK_CACHE_UNWARMED (a cache that run had to change, or uncommitted cache files) or HFS_CHECK_CACHE_UNPORTABLE (a host whose fingerprint is not portable), and a cache file over the limit a push may carry (STARCI_CACHE_FILE_MAX_MB, 90 MB) is HFS_CHECK_CACHE_FILE_TOO_LARGE, a hard blocker, while a run splits its records into files under 32 MB; and the release gate, which trusts the warm cache, is refused HFS_CHECK_CACHE_VERIFY_LOCKED while the newest nightly verify of the default branch is red or cannot be read."
|
|
6044
6044
|
kinds: [codemod]
|
|
6045
6045
|
gates: [ci]
|
|
6046
|
-
failureCodes: ["HFS_CHECK_CACHE_FORGED", "HFS_CHECK_CACHE_STALE", "HFS_CHECK_CACHE_MISSING", "HFS_CHECK_CACHE_UNWARMED", "HFS_CHECK_CACHE_UNPORTABLE", "HFS_CHECK_CACHE_VERIFY_LOCKED"]
|
|
6046
|
+
failureCodes: ["HFS_CHECK_CACHE_FORGED", "HFS_CHECK_CACHE_STALE", "HFS_CHECK_CACHE_MISSING", "HFS_CHECK_CACHE_UNWARMED", "HFS_CHECK_CACHE_UNPORTABLE", "HFS_CHECK_CACHE_FILE_TOO_LARGE", "HFS_CHECK_CACHE_VERIFY_LOCKED"]
|
|
6047
6047
|
enforcers:
|
|
6048
6048
|
- {kind: hfs, id: check-cache, at: packages/hfs/cache/trust.mjs}
|
|
6049
6049
|
- {kind: hfs, id: check-cache-fresh, at: packages/hfs/cache/freshness.mjs}
|
|
@@ -6663,3 +6663,51 @@ rules:
|
|
|
6663
6663
|
- {path: packages/hfs/templates/be/skeleton/apps/cli/src/main.ts, editions: [lite, full]}
|
|
6664
6664
|
witness:
|
|
6665
6665
|
- {path: packages/hfs/src/hfs-boot-logger.spec.mjs, editions: [lite, full]}
|
|
6666
|
+
- id: R377
|
|
6667
|
+
code: "BE_FLOW_FAILURE_SWALLOWED"
|
|
6668
|
+
law: "Every job and saga flow runs itself again after a failure of any kind: a processor, a job step, a saga step or compensation and a message consumer never catch a failure without rethrowing or parking it, and no back-end source sets BullMQ's `removeOnFail`; the runner classifies the failure (`classifyFailure`), retries a transient one and parks any other as `failed_awaiting_fix` with one alert until a resume, so no flow ends as a silent dead letter."
|
|
6669
|
+
kinds: [check]
|
|
6670
|
+
gates: [settle, land, ci]
|
|
6671
|
+
failureCodes: ["BE_FLOW_FAILURE_SWALLOWED"]
|
|
6672
|
+
enforcers:
|
|
6673
|
+
- {kind: hfs, id: flow-failure, at: scripts/hfs/rules/flow-failure.mjs}
|
|
6674
|
+
editions: [lite, full]
|
|
6675
|
+
docs:
|
|
6676
|
+
- {path: contexts/code/be/resilience.md#be-resilience-2-every-job-and-saga-flow-runs-itself-again-after-a-failure-of-any-kind, editions: [lite, full]}
|
|
6677
|
+
proves:
|
|
6678
|
+
- {path: packages/hfs/src/hfs-flow-failure.spec.mjs, editions: [lite, full]}
|
|
6679
|
+
exemplifiedBy:
|
|
6680
|
+
- {path: packages/hfs/templates/be/patterns/jobs/platform/job-runner.service.ts.tpl, editions: [lite, full]}
|
|
6681
|
+
witness:
|
|
6682
|
+
- {path: packages/hfs/src/hfs-flow-failure.spec.mjs, editions: [lite, full]}
|
|
6683
|
+
- id: R378
|
|
6684
|
+
code: "HFS_BRANCH_PROFILE_INVALID"
|
|
6685
|
+
law: "An app's branch profile (`branches` of .starcistacks/application-stacks.yaml) lowers only the polish gates lint, sonar and codecov, to report or off, on a branch policy/loosening.yaml branchProfiles allows; the safety gates hfs, types, wiring, db, secrets, format and test block on every branch, and the default branch (main, master or ci.github.defaultBranch) is never declared and always runs the full gate, as does a pull request into it; a refused profile lowers nothing."
|
|
6686
|
+
kinds: [check]
|
|
6687
|
+
gates: [pre-commit, settle, land, ci]
|
|
6688
|
+
failureCodes: ["HFS_BRANCH_PROFILE_INVALID"]
|
|
6689
|
+
enforcers:
|
|
6690
|
+
- {kind: hfs, id: branch-profile, at: scripts/lib/stack-declaration.mjs}
|
|
6691
|
+
- {kind: hfs, id: stacks-shape, at: scripts/hfs/rules/stacks.mjs}
|
|
6692
|
+
editions: [lite, full]
|
|
6693
|
+
docs:
|
|
6694
|
+
- {path: contexts/project/lint.md#project-lint-2-a-branch-profile-lowers-only-the-polish-gates, editions: [lite, full]}
|
|
6695
|
+
proves:
|
|
6696
|
+
- {path: packages/hfs/src/branch-profile.spec.mjs, editions: [lite, full]}
|
|
6697
|
+
witness:
|
|
6698
|
+
- {path: packages/hfs/src/branch-profile.spec.mjs, editions: [lite, full]}
|
|
6699
|
+
- id: R379
|
|
6700
|
+
code: "LINT_RATCHET_RAISED"
|
|
6701
|
+
law: "On a branch whose profile runs lint as report, a commit never adds lint findings to a file it touches: each touched source file has no more ESLint error findings than at the base (the parent commit for the pre-commit hook, the merge-base with the pushed range or the remote branch, else HEAD^, for the pre-push hook and CI) and a new file has none, judged by linting both versions of the touched files through the side's installed config; the findings a file already carried stay report-only, and a ratchet violation blocks at any count."
|
|
6702
|
+
kinds: [check]
|
|
6703
|
+
gates: [pre-commit, settle, land, ci]
|
|
6704
|
+
failureCodes: ["LINT_RATCHET_RAISED"]
|
|
6705
|
+
enforcers:
|
|
6706
|
+
- {kind: hfs, id: lint-ratchet, at: lint/ratchet.mjs}
|
|
6707
|
+
editions: [lite, full]
|
|
6708
|
+
docs:
|
|
6709
|
+
- {path: contexts/project/lint.md#project-lint-2-a-branch-profile-lowers-only-the-polish-gates, editions: [lite, full]}
|
|
6710
|
+
proves:
|
|
6711
|
+
- {path: packages/hfs/src/branch-profile.spec.mjs, editions: [lite, full]}
|
|
6712
|
+
witness:
|
|
6713
|
+
- {path: packages/hfs/src/branch-profile.spec.mjs, editions: [lite, full]}
|
|
@@ -458,6 +458,9 @@ ruleParams:
|
|
|
458
458
|
- {name: public.job_advance, reason: "platform/jobs (add job, lite): the token-guarded step write of jobs.sql"}
|
|
459
459
|
- {name: public.job_complete, reason: "platform/jobs (add job, lite): the token-guarded completion of jobs.sql"}
|
|
460
460
|
- {name: public.job_fail, reason: "platform/jobs (add job, lite): the token-guarded failure of jobs.sql"}
|
|
461
|
+
- {name: public.job_park, reason: "platform/jobs (add job, lite): the token-guarded park as failed_awaiting_fix of jobs.sql (BE-RESILIENCE-2)"}
|
|
462
|
+
- {name: public.job_resume, reason: "platform/jobs (add job, lite): marks parked jobs resumed by id, build or sweep, jobs.sql (BE-RESILIENCE-2)"}
|
|
463
|
+
- {name: public.job_awaiting_fix, reason: "platform/jobs (add job, lite): the parked jobs, the owner's work items, jobs.sql (BE-RESILIENCE-2)"}
|
|
461
464
|
- {name: public.job_tick_claim, reason: "platform/jobs (add job, lite): the once-per-minute claim of a scheduler tick, jobs.sql (R335)"}
|
|
462
465
|
- {name: public.queue_write, reason: "platform/queue (add queue, lite): the outbox insert of queue-outbox.sql"}
|
|
463
466
|
- {name: public.queue_waiting, reason: "platform/queue (add queue, lite): the relay read FOR UPDATE SKIP LOCKED of queue-outbox.sql"}
|