@starci/eslint-canon-fe 8.3.0 → 8.4.1
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 +9 -0
- package/callback-shape.mjs +344 -0
- package/client-boundary.mjs +1 -1
- package/docs/hooks-folder.md +1 -1
- package/env-owner.mjs +120 -9
- package/function-budget.mjs +49 -0
- package/hooks-folder.mjs +149 -18
- package/icon.mjs +67 -0
- package/index.mjs +47 -0
- package/lib/own-hook-origin.mjs +53 -0
- package/lib/program-for.mjs +22 -0
- package/lib/pure-owner-helper.mjs +148 -0
- package/lib/redux-hook-origin.mjs +44 -0
- package/next-conventions.mjs +38 -35
- package/package.json +1 -1
- package/runtime/config.example.yaml +7 -6
- package/runtime/engine/config.mjs +10 -18
- package/runtime/engine/removed-vocabulary.mjs +0 -2
- package/runtime/knowledge/hfs/canon-pins.yaml +11 -11
- package/runtime/knowledge/hfs/fe-stack.yaml +22 -1
- package/runtime/knowledge/hfs/slots.yaml +333 -62
- package/runtime/knowledge/patterns/fe/folder.yaml +1 -0
- package/runtime/knowledge/sonar-gate.yaml +1 -1
- package/runtime/modules/kernel/removed-vocabulary.yaml +30 -0
- package/runtime/modules/models/runtimes.yaml +5 -7
- package/runtime/packages/hfs/templates/app/package-scripts/package.json +1 -0
- package/runtime/scripts/api/git/lib.mjs +4 -1
- package/runtime/scripts/api/git/merge-base.mjs +9 -0
- package/runtime/scripts/api/git/recorded-lines.mjs +54 -8
- package/runtime/scripts/hfs/architecture/backend-app-files.mjs +1 -8
- package/runtime/scripts/hfs/architecture/backend.mjs +2 -7
- package/runtime/scripts/hfs/architecture/client-reaches-server.mjs +6 -3
- package/runtime/scripts/hfs/architecture/config.mjs +1 -1
- package/runtime/scripts/hfs/architecture/dead-exports-bindings.mjs +149 -0
- package/runtime/scripts/hfs/architecture/dead-exports.mjs +9 -41
- package/runtime/scripts/hfs/architecture/default-deny.mjs +8 -6
- package/runtime/scripts/hfs/architecture/frontend-world.mjs +1 -1
- package/runtime/scripts/hfs/architecture/function-spec-providers.mjs +153 -0
- package/runtime/scripts/hfs/architecture/hfs.mjs +3 -3
- package/runtime/scripts/hfs/architecture/index.mjs +1 -1
- package/runtime/scripts/hfs/architecture/module-per-transport.mjs +28 -13
- package/runtime/scripts/hfs/architecture/next-data-inference.mjs +176 -0
- package/runtime/scripts/hfs/architecture/next-data-symbols.mjs +26 -0
- package/runtime/scripts/hfs/architecture/next-data.mjs +31 -23
- package/runtime/scripts/hfs/architecture/reachability.mjs +14 -0
- package/runtime/scripts/hfs/architecture/register-once.mjs +2 -2
- package/runtime/scripts/hfs/architecture/source-names.mjs +48 -3
- package/runtime/scripts/hfs/architecture/supabase-ast.mjs +211 -11
- package/runtime/scripts/hfs/architecture/supabase-be.mjs +1 -1
- package/runtime/scripts/hfs/architecture/supabase.mjs +59 -21
- package/runtime/scripts/hfs/architecture/surface.mjs +2 -1
- package/runtime/scripts/hfs/architecture/tiers.mjs +4 -4
- package/runtime/scripts/hfs/architecture/unit-spec-providers.mjs +8 -2
- package/runtime/scripts/hfs/declaration-shape.mjs +39 -3
- package/runtime/scripts/hfs/edition-slots.mjs +2 -2
- package/runtime/scripts/hfs/manifest-shape.mjs +69 -9
- package/runtime/scripts/hfs/param-names.mjs +1 -1
- package/runtime/scripts/hfs/project-rule.mjs +3 -1
- package/runtime/scripts/hfs/rule-catalog.mjs +158 -11
- package/runtime/scripts/hfs/rule-params-shape.mjs +22 -10
- package/runtime/scripts/hfs/rules/secrets.mjs +13 -0
- package/runtime/scripts/hfs/slot-imports.mjs +18 -5
- package/runtime/scripts/hfs/slots.mjs +3 -2
- package/runtime/scripts/hfs/typescript-programs.mjs +0 -8
- package/runtime/scripts/lib/env.mjs +20 -0
- package/runtime/scripts/lib/event-contract.mjs +107 -0
- package/runtime/scripts/lib/git.mjs +1 -1
- package/runtime/scripts/lib/i18n.mjs +0 -2
- package/runtime/scripts/lib/json-clone.mjs +61 -0
- package/runtime/scripts/lib/language.mjs +1 -1
- package/runtime/scripts/lib/list.mjs +4 -0
- package/runtime/scripts/lib/secret-patterns.mjs +60 -5
- package/runtime/scripts/lib/stack-services.mjs +1 -1
- package/runtime/scripts/lib/ts-analysis.mjs +5 -2
- package/runtime/scripts/lib/ts-ast.mjs +27 -2
- package/served-locale.mjs +80 -9
- package/size-growth.mjs +10 -6
- package/swr-family.mjs +197 -0
- package/translation.mjs +135 -7
- package/transport.mjs +126 -59
package/next-conventions.mjs
CHANGED
|
@@ -12,12 +12,13 @@
|
|
|
12
12
|
*/
|
|
13
13
|
|
|
14
14
|
import { attribute, attributeValue, calleeName, leadingTextOf, stringOf } from "./lib/ast.mjs"
|
|
15
|
+
import { variableOf } from "./lib/bindings.mjs"
|
|
15
16
|
import { forbiddingConcern } from "./lib/fe-stack.mjs"
|
|
16
17
|
import { hfsOf } from "./lib/hfs.mjs"
|
|
17
|
-
import { baseName, classOf, fileOf, inSlot, roleOfFile, slotOfFile
|
|
18
|
+
import { baseName, classOf, fileOf, inSlot, roleOfFile, slotOfFile } from "./lib/scope.mjs"
|
|
18
19
|
|
|
19
20
|
/** Another i18n stack: a second place that decides which language a reader sees (one the fe-stack catalog forbids by name is fe-stack-import's finding). */
|
|
20
|
-
const OTHER_I18N = /^(?:react-i18next|i18next|next-i18next|react-intl|next-translate
|
|
21
|
+
const OTHER_I18N = /^(?:react-i18next|i18next|next-i18next|react-intl|next-translate|typesafe-i18n|rosetta)(?:\/.*)?$|^@lingui\/.+$/
|
|
21
22
|
|
|
22
23
|
// -- FE-NEXT-1 -------------------------------------------------------------------------------------
|
|
23
24
|
|
|
@@ -137,21 +138,23 @@ export const htmlLangFromLocale = {
|
|
|
137
138
|
|
|
138
139
|
// -- FE-NEXT-5 -------------------------------------------------------------------------------------
|
|
139
140
|
|
|
140
|
-
/** The names
|
|
141
|
-
const
|
|
142
|
-
|
|
143
|
-
|
|
144
|
-
|
|
145
|
-
|
|
146
|
-
|
|
147
|
-
|
|
148
|
-
|
|
141
|
+
/** The names one named-export statement introduces. */
|
|
142
|
+
const statementExportNames = (statement) => {
|
|
143
|
+
if (statement.type !== "ExportNamedDeclaration") return []
|
|
144
|
+
const declaration = statement.declaration
|
|
145
|
+
const names = (statement.specifiers ?? []).map((specifier) => specifier.exported.name)
|
|
146
|
+
if (declaration?.id) names.push(declaration.id.name)
|
|
147
|
+
if (declaration?.type === "VariableDeclaration") {
|
|
148
|
+
for (const entry of declaration.declarations) {
|
|
149
|
+
if (entry.id.type === "Identifier") names.push(entry.id.name)
|
|
149
150
|
}
|
|
150
|
-
for (const specifier of statement.specifiers ?? []) names.add(specifier.exported.name)
|
|
151
151
|
}
|
|
152
152
|
return names
|
|
153
153
|
}
|
|
154
154
|
|
|
155
|
+
/** The names a module exports, from declarations and specifiers. */
|
|
156
|
+
const exportedNames = (program) => new Set(program.body.flatMap(statementExportNames))
|
|
157
|
+
|
|
155
158
|
/** Every page names itself: `metadata` or `generateMetadata`. */
|
|
156
159
|
export const pageExportsMetadata = {
|
|
157
160
|
meta: {
|
|
@@ -338,34 +341,34 @@ const STACK_FACTORIES = new Map([
|
|
|
338
341
|
["next-intl/middleware", new Set(["default"])],
|
|
339
342
|
])
|
|
340
343
|
|
|
341
|
-
/** The
|
|
342
|
-
const
|
|
343
|
-
|
|
344
|
-
|
|
345
|
-
const variable = scope.set.get(identifier.name)
|
|
346
|
-
if (variable) return variable.defs[0] ?? null
|
|
347
|
-
scope = scope.upper
|
|
348
|
-
}
|
|
344
|
+
/** The public name selected by a named or default import. */
|
|
345
|
+
const importedName = (specifier) => {
|
|
346
|
+
if (specifier.type === "ImportSpecifier") return specifier.imported.name ?? specifier.imported.value
|
|
347
|
+
if (specifier.type === "ImportDefaultSpecifier") return "default"
|
|
349
348
|
return null
|
|
350
349
|
}
|
|
351
350
|
|
|
351
|
+
/** The known next-intl factory selected from an import. */
|
|
352
|
+
const stackFactory = (definition, exported) => {
|
|
353
|
+
const source = String(definition.parent.source.value)
|
|
354
|
+
if (!STACK_FACTORIES.get(source)?.has(exported)) return null
|
|
355
|
+
return { source, name: exported === "default" ? "createMiddleware" : exported }
|
|
356
|
+
}
|
|
357
|
+
|
|
358
|
+
/** A factory called through a namespace import, else null. */
|
|
359
|
+
const namespaceFactory = (context, callee) => {
|
|
360
|
+
if (callee.type !== "MemberExpression" || callee.computed || callee.object.type !== "Identifier" || callee.property.type !== "Identifier") return null
|
|
361
|
+
const definition = variableOf(context, callee.object)?.defs[0] ?? null
|
|
362
|
+
if (definition?.type !== "ImportBinding" || definition.node.type !== "ImportNamespaceSpecifier") return null
|
|
363
|
+
return stackFactory(definition, callee.property.name)
|
|
364
|
+
}
|
|
365
|
+
|
|
352
366
|
/** The name a stack factory has where the call reads it: "defineRouting" (next-intl/routing), else null. */
|
|
353
367
|
const stackFactoryOf = (context, callee) => {
|
|
354
|
-
if (callee.type
|
|
355
|
-
|
|
356
|
-
|
|
357
|
-
|
|
358
|
-
const specifier = definition.node
|
|
359
|
-
const exported = specifier.type === "ImportSpecifier" ? specifier.imported.name ?? specifier.imported.value : specifier.type === "ImportDefaultSpecifier" ? "default" : null
|
|
360
|
-
return exported !== null && STACK_FACTORIES.get(source)?.has(exported) ? { source, name: exported === "default" ? "createMiddleware" : exported } : null
|
|
361
|
-
}
|
|
362
|
-
if (callee.type === "MemberExpression" && !callee.computed && callee.object.type === "Identifier" && callee.property.type === "Identifier") {
|
|
363
|
-
const definition = bindingOf(context, callee.object)
|
|
364
|
-
if (definition?.type !== "ImportBinding" || definition.node.type !== "ImportNamespaceSpecifier") return null
|
|
365
|
-
const source = String(definition.parent.source.value)
|
|
366
|
-
return STACK_FACTORIES.get(source)?.has(callee.property.name) ? { source, name: callee.property.name } : null
|
|
367
|
-
}
|
|
368
|
-
return null
|
|
368
|
+
if (callee.type !== "Identifier") return namespaceFactory(context, callee)
|
|
369
|
+
const definition = variableOf(context, callee)?.defs[0] ?? null
|
|
370
|
+
if (definition?.type !== "ImportBinding") return null
|
|
371
|
+
return stackFactory(definition, importedName(definition.node))
|
|
369
372
|
}
|
|
370
373
|
|
|
371
374
|
/**
|
package/package.json
CHANGED
|
@@ -1,6 +1,6 @@
|
|
|
1
1
|
{
|
|
2
2
|
"name": "@starci/eslint-canon-fe",
|
|
3
|
-
"version": "8.
|
|
3
|
+
"version": "8.4.1",
|
|
4
4
|
"description": "The StarCi front-end lint canon: every rule its laws publish, gathered as one flat-config plugin and attached by one factory.",
|
|
5
5
|
"type": "module",
|
|
6
6
|
"license": "MIT",
|
|
@@ -185,10 +185,11 @@ sonar: {organization: null}
|
|
|
185
185
|
# minFreeRamPct free-RAM percentage below which no new heavy op starts
|
|
186
186
|
# set them only in the gitignored config.yaml copy, e.g.
|
|
187
187
|
# resources: {minFreeDiskGb: 5, minFreeDiskPct: 1, minFreeRamPct: 10}
|
|
188
|
-
# release
|
|
189
|
-
# suite: local the shipped default: `starci release cut` runs the root
|
|
190
|
-
#
|
|
191
|
-
#
|
|
192
|
-
#
|
|
193
|
-
#
|
|
188
|
+
# release - where the Linux parity of a release is judged (scripts/guards/release-suite-mode.mjs; docs/releasing.md "Where the suite runs"). One key:
|
|
189
|
+
# suite: local the shipped default: `starci release cut` runs the root rows (npm run test:packages, npm run test:e2e, npm run check) and the Linux parity container before it pushes,
|
|
190
|
+
# and the pre-push gate asks for the green root rows
|
|
191
|
+
# suite: ci the owner's recorded choice (2026-10-09): no local Linux container; the GitHub ci workflow runs the Linux parity (and SonarCloud) AFTER the push.
|
|
192
|
+
# The cut still runs the same root rows and the example apps; the record lists linux-parity as delegated, never green.
|
|
193
|
+
# A release can reach GitHub and its tag before the Linux parity has run; a red CI is fixed forward with the next pre-release (starci release ci-status).
|
|
194
|
+
# "none" is refused: the Linux parity does not vanish, it moves to CI. Set it only in the gitignored config.yaml copy: release: {suite: ci}
|
|
194
195
|
release: {suite: local}
|
|
@@ -9,7 +9,7 @@ import {validateSonar} from './sonar-config.mjs';
|
|
|
9
9
|
import {validateRelease,RELEASE_KEYS} from './release-config.mjs';
|
|
10
10
|
import {validateOrca,ORCA_KEYS} from './orca-config.mjs';
|
|
11
11
|
import {validateResources,RESOURCE_KEYS} from './resources-config.mjs';
|
|
12
|
-
import {ENV_NAME,
|
|
12
|
+
import { ENV_NAME, connectorSecret } from './secrets.mjs';
|
|
13
13
|
import {byCodeUnit} from './by-code-unit.mjs';
|
|
14
14
|
import {EFFORT_LEVELS,MODELS_KEYS,validateModelsBlock,refuseRemovedKeys,shippedTiers} from './model-config.mjs';
|
|
15
15
|
const knownNames=names=>[...names].sort(byCodeUnit).join(', ');
|
|
@@ -162,8 +162,6 @@ function validateConnectors(connectors){
|
|
|
162
162
|
if(connectors.cloudflare!==undefined)validateCloudflareConnector(connectors.cloudflare);
|
|
163
163
|
if(connectors.telegram!==undefined)validateTelegramConnector(connectors.telegram);
|
|
164
164
|
}
|
|
165
|
-
/** Load connector credentials from the explicitly verified runtime main; never print the returned environment. */
|
|
166
|
-
export function connectorEnv(config,env=process.env,verifiedRuntimeRoot=undefined){return secretEnv(verifiedRuntimeRoot,env);}
|
|
167
165
|
/**
|
|
168
166
|
* The normalized `connectors` block: defaults filled in, the secrets' PRESENCE (booleans, never values),
|
|
169
167
|
* whether each connector is ready to run, and the owner-facing warnings the security posture earns.
|
|
@@ -243,8 +241,8 @@ export function uatSettings(config=loadConfig()){
|
|
|
243
241
|
const GRANT=/^([a-z0-9][a-z0-9.-]*)=(\d+)@([a-z]+(?:\+[a-z]+)*)$/;
|
|
244
242
|
/** One grant string `<pool>=<slots>@<role>+<role>` as {pool, slots, roles}, or null when it is not that shape. */
|
|
245
243
|
/** The closed set of top-level config.yaml blocks: the validator accepts these and refuses every other key. */
|
|
246
|
-
|
|
247
|
-
|
|
244
|
+
const CONFIG_BLOCKS=Object.freeze(['language','model','effort','models','allocation','kernel','budgets','supervisor','parallel','delegation','connectors','asks','uat','specs','reconciler','debugLoop','orca','roots','resources','sonar','release','launchTrust','retention']);
|
|
245
|
+
function parseAllocationGrant(text){
|
|
248
246
|
const m=typeof text==='string'?GRANT.exec(text.trim()):null;
|
|
249
247
|
return m?{pool:m[1],slots:Number(m[2]),roles:m[3].split('+')}:null;
|
|
250
248
|
}
|
|
@@ -327,7 +325,7 @@ const validateEarlyConfigBlocks=(config)=>{
|
|
|
327
325
|
if(config?.orca!==undefined){validateOrca(config.orca);} if(config?.roots!==undefined){validateRoots(config.roots);} if(config?.resources!==undefined){validateResources(config.resources);} if(config?.sonar!==undefined){validateSonar(config.sonar);} if(config?.release!==undefined){validateRelease(config.release);}
|
|
328
326
|
};
|
|
329
327
|
const validateConfigBlocks=(config,knownProviders,runtimes,profile)=>{
|
|
330
|
-
// specs (owner 2026-09-28): {
|
|
328
|
+
// specs (owner 2026-09-28): {unit?, e2e?} booleans - each family a boolean; absent = its default (SPEC_DEFAULTS: unit on, e2e off; specsSettings).
|
|
331
329
|
if(config?.specs!==undefined&&config.specs!==null&&(!plain(config.specs)||Object.keys(config.specs).some(key=>!CONFIG_KEY_TREE.specs.includes(key)||typeof config.specs[key]!=='boolean')))throw new Error(`Invalid config.yaml: specs must be {${SPEC_FAMILIES.map(k=>k+'?: boolean').join(', ')}}, or null.`);
|
|
332
330
|
// reconciler (scripts/reconciler/state.mjs reconcilerConfig): {enabled?: boolean, profile?: operational|observe, controllers?: {<name>: {mode: off|shadow|active}}}, or null.
|
|
333
331
|
if(config?.reconciler!==undefined&&config.reconciler!==null){validateReconcilerBlock(config.reconciler);} if(config?.allocation!==undefined){validateAllocationBlock(config.allocation,runtimes);}
|
|
@@ -356,8 +354,8 @@ export function configuredAllocationPolicy(config=loadConfig()){
|
|
|
356
354
|
:null;
|
|
357
355
|
return {grants,source:allocation?'allocation':'default'};
|
|
358
356
|
}
|
|
359
|
-
/** The variable that confines the owner's `config.yaml` to a directory tree: set, an owner file is read only from under that directory (
|
|
360
|
-
|
|
357
|
+
/** The variable that confines the owner's `config.yaml` to a directory tree: set, an owner file is read only from under that directory (e2e/setup/isolated-temp.mjs points it at a spec's own temp root). */
|
|
358
|
+
const OWNER_CONFIG_WITHIN_ENV='STARCI_OWNER_CONFIG_WITHIN';
|
|
361
359
|
const foldPath=p=>process.platform==='win32'?path.resolve(p).toLowerCase():path.resolve(p);
|
|
362
360
|
/**
|
|
363
361
|
* Whether the owner's `config.yaml` under `root` is visible to this process. Unconfined (the variable unset) every owner file is visible; confined, only the files under the named
|
|
@@ -398,31 +396,25 @@ export function inspectOwnerConfig(root=configRoot){
|
|
|
398
396
|
}
|
|
399
397
|
/**
|
|
400
398
|
* The owner's spec switches (config.yaml root `specs`, owner 2026-09-28; defaults set 2026-09-29, none needs a config block):
|
|
401
|
-
* harness - .claude's own specs. Default false = touching-only: harness work writes and runs the specs of new or changed code
|
|
402
|
-
* and the land gate runs only the specs touching the landed files (`land.mjs --specs touching`, its default);
|
|
403
|
-
* the whole suite never runs in a land - `--specs all` is refused unless this is true. The full suite runs in
|
|
404
|
-
* the owner-approved /starci release flow (scripts/supervisor/release-cut.mjs), which needs no key. true = `--specs all` may run;
|
|
405
399
|
* unit - product unit specs in workflows. Default on: a code-writing op writes/updates the unit specs of the source it
|
|
406
400
|
* adds or changes and runs only those; the full unit suite is unit.verify's or the approved /starci release flow's. false = the ops'
|
|
407
401
|
* policy.specsToggle deferral path (scripts/route/spec-deferral.mjs);
|
|
408
402
|
* e2e - product e2e in workflows. Default OFF: e2e runs only when the goal or the owner explicitly asks (set true,
|
|
409
403
|
* or `starci kernel run-deferred-tests`); e2e.verify then runs the FULL e2e suite.
|
|
410
|
-
* An absent, null or unreadable owner file reads as the defaults:
|
|
404
|
+
* An absent, null or unreadable owner file reads as the defaults: unit on, e2e off. The runtime itself has no specs (owner ruling no-runtime-specs), so there is no switch for them.
|
|
411
405
|
*/
|
|
412
|
-
const SPEC_FAMILIES=Object.freeze(['
|
|
406
|
+
const SPEC_FAMILIES=Object.freeze(['unit','e2e']);
|
|
413
407
|
const SEAT_KEYS=Object.freeze(['agent','model','effort']);
|
|
414
408
|
/** The keys each config block accepts directly under it (the validators read these lists; docs/config-format.md and the example are checked against them). Blocks whose keys are open or deeper than this are not listed. */
|
|
415
|
-
|
|
409
|
+
const CONFIG_KEY_TREE=Object.freeze({
|
|
416
410
|
models:MODELS_KEYS,allocation:Object.freeze(['grants']),kernel:SEAT_KEYS,budgets:Object.freeze(['maxOps']),parallel:Object.freeze(['gear']),
|
|
417
411
|
supervisor:Object.freeze(['mode','pollIntervalMs','repos','stallMinutes','kernel','workers','landGate','frozenMinutes']),
|
|
418
412
|
delegation:Object.freeze(['asks','until','excludes','note']),asks:Object.freeze(['autoAcceptRecommended','excludes']),uat:Object.freeze(['maxConcurrent']),
|
|
419
413
|
specs:SPEC_FAMILIES,reconciler:Object.freeze(['enabled','profile','controllers']),debugLoop:Object.freeze(['interval','worktreeLimit']),
|
|
420
414
|
orca:ORCA_KEYS,roots:ROOT_KEYS,resources:RESOURCE_KEYS,release:RELEASE_KEYS,
|
|
421
415
|
});
|
|
422
|
-
export const SPEC_DEFAULTS=Object.freeze({
|
|
416
|
+
export const SPEC_DEFAULTS=Object.freeze({unit:true,e2e:false});
|
|
423
417
|
export function specsSettings(config){const specs=plain(config?.specs)?config.specs:{};return Object.fromEntries(SPEC_FAMILIES.map(key=>[key,typeof specs[key]==='boolean'?specs[key]:SPEC_DEFAULTS[key]]));}
|
|
424
|
-
/** specs.harness of the owner file under `root` (tolerant read: inspectOwnerConfig): true only when the owner opted in to `--specs all`. */
|
|
425
|
-
export function harnessSpecsEnabled(root=configRoot){return specsSettings(inspectOwnerConfig(root).config).harness;}
|
|
426
418
|
/**
|
|
427
419
|
* config.yaml `debugLoop` (skills/starci, scripts/debug/digest): {interval?, worktreeLimit?}, each optional.
|
|
428
420
|
* interval <n>s | <n>m | <n>h — the cadence of the chat /loop that runs `starci debug digest`.
|
|
@@ -12,8 +12,6 @@ function loaded(){
|
|
|
12
12
|
return cache.doc;
|
|
13
13
|
}
|
|
14
14
|
|
|
15
|
-
/** The kinds a removed spelling has. */
|
|
16
|
-
export const removedKinds=()=>loaded().kinds;
|
|
17
15
|
|
|
18
16
|
/** modules/kernel/removed-vocabulary.yaml: the one list of spellings the runtime refuses, each with its replacement and the release that removed it. */
|
|
19
17
|
export const removedVocabulary=()=>loaded().removed;
|
|
@@ -29,14 +29,14 @@ pins:
|
|
|
29
29
|
source: packages/grammar/package.json
|
|
30
30
|
why: 'the grammar front ends read: the brand layer sets `--font-sans` and `--font-mono` and the grammar reads them; it carries the Input tel kind, the copyable and read-only Input, the IconButton disclosure props and count badge, ChatBubble, FillViewport, Textarea mentions and Enter-to-send, the leading PrimaryRailLayout rail, the plate-less Image, ListRow, the soft Alert, Progress steps, the floating primary IconButton, FlowGraph, the STATE-8 loading views and the bordered selectable TagGroup chips. The runtime source version wins for a @starci package.'
|
|
31
31
|
'@starci/eslint-canon-be':
|
|
32
|
-
version: 3.
|
|
32
|
+
version: 3.4.1
|
|
33
33
|
group: starci
|
|
34
34
|
install: registry
|
|
35
35
|
side: be
|
|
36
36
|
source: packages/eslint/be/package.json
|
|
37
37
|
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.'
|
|
38
38
|
'@starci/eslint-canon-fe':
|
|
39
|
-
version: 8.
|
|
39
|
+
version: 8.4.1
|
|
40
40
|
group: starci
|
|
41
41
|
install: registry
|
|
42
42
|
side: fe
|
|
@@ -62,28 +62,28 @@ pins:
|
|
|
62
62
|
side: both
|
|
63
63
|
source: packages/prettier-config/package.json
|
|
64
64
|
'@starci/jest-preset':
|
|
65
|
-
version: 2.
|
|
65
|
+
version: 2.3.0
|
|
66
66
|
group: starci
|
|
67
67
|
install: registry
|
|
68
68
|
side: be
|
|
69
69
|
source: packages/jest-preset/package.json
|
|
70
70
|
why: 'the Jest preset of a back end: the world runner runs up to min(--maxWorkers, slots) world files at once, each in its own process bound to one data slot of the test world (STARCI_TEST_WORLD_SLOT), and reads test-world state protocol 2 only: it pairs exactly with @starci/test-world, and any other state file is JEST_PRESET_WORLD_PAIR_MISMATCH. The unit run writes the lcov Sonar and Codecov import (services only); the integration, e2e and contract projects run every spec file in a worker process of its own (world-runner.cjs), so a process-global framework registry (@nestjs/graphql type metadata) never leaks between e2e files; it ships the unit kit (mockEntityManager, fakeTransaction, fakeIds, FakeClock, Outcome matchers) and the recordingOutbox claim side.'
|
|
71
71
|
'@starci/test-world':
|
|
72
|
-
version: 1.2.
|
|
72
|
+
version: 1.2.2
|
|
73
73
|
group: starci
|
|
74
74
|
install: registry
|
|
75
75
|
side: be
|
|
76
76
|
source: packages/test-world/package.json
|
|
77
77
|
why: 'the shared e2e library of every back end (R47, R48), a devDependency of every back end: the warm stack behind toxiproxy, the network-edge fakes, the Nest boot, the typed useTestWorld handle, useSandbox for contract specs and the outage lock. Kafka is real own infra (the one digest-pinned apache/kafka KRaft image, a broker listener and proxy per slot, slot-prefixed topics, consumer groups and client ids) and Postgres is schema-per-context (a schema and a login role per context in a shared database). Each worker has its own data slot (<ns>_w<k>) with its own databases, Keycloak realm, leased Redis DB, bucket/collection/topic prefixes, fakes host, toxiproxy proxies and outage lock; a run provisions min(jest workers, workers cap, default 2) slots, and state file protocol 2 pairs exactly with @starci/jest-preset (TEST_WORLD_PAIR_MISMATCH otherwise). A modules world boots real peer apps beside its modules, world.apps.<name>.during(fn) is the outage of a peer app, w.keycloak.clientSecret(client) answers the run-generated secret of a confidential realm client, world.keycloak.events/sessions read the realm user events and live sessions, world.infra.postgresql.connection(name) takes one database connection down while the others serve, and world.resolve and scope.resolve take any Nest token. Every path a declaration names (`stack`, seeds, the realm, Dockerfiles) resolves from the app root (the directory of hfs.json); the globalSetup registers the path aliases as TypeScript resolves them. Its CLI main is exported at ./cli for starci app stack.'
|
|
78
78
|
'@starci/cli':
|
|
79
|
-
version: 1.
|
|
79
|
+
version: 1.4.1
|
|
80
80
|
group: starci
|
|
81
81
|
install: registry
|
|
82
82
|
side: both
|
|
83
83
|
source: packages/cli/package.json
|
|
84
84
|
why: 'the only StarCi command package; product repositories install it for starci app, while @starci/hfs remains its pinned transitive implementation.'
|
|
85
85
|
'@starci/hfs':
|
|
86
|
-
version: 4.
|
|
86
|
+
version: 4.4.1
|
|
87
87
|
group: starci
|
|
88
88
|
install: registry
|
|
89
89
|
side: both
|
|
@@ -180,7 +180,7 @@ pins:
|
|
|
180
180
|
side: be
|
|
181
181
|
# --- framework
|
|
182
182
|
next:
|
|
183
|
-
version: 16.
|
|
183
|
+
version: 16.4.2
|
|
184
184
|
group: framework
|
|
185
185
|
side: fe
|
|
186
186
|
react:
|
|
@@ -206,7 +206,7 @@ pins:
|
|
|
206
206
|
group: framework
|
|
207
207
|
side: be
|
|
208
208
|
'@nestjs/platform-express':
|
|
209
|
-
version: 11.2.
|
|
209
|
+
version: 11.2.7
|
|
210
210
|
group: framework
|
|
211
211
|
side: be
|
|
212
212
|
'@nestjs/testing':
|
|
@@ -316,7 +316,7 @@ pins:
|
|
|
316
316
|
side: fe
|
|
317
317
|
why: 'the codegen preset of the front-end wire types (fe-stack codegen); the latest registry version on 2026-10-13.'
|
|
318
318
|
'axios':
|
|
319
|
-
version: 1.
|
|
319
|
+
version: 1.20.0
|
|
320
320
|
group: framework
|
|
321
321
|
side: fe
|
|
322
322
|
why: 'the REST client of the front end for uploads, presigned URLs and auth endpoints (fe-stack rest); version read from the starci-academy package-lock on 2026-10-13.'
|
|
@@ -465,12 +465,12 @@ pins:
|
|
|
465
465
|
version: 13.4.5
|
|
466
466
|
group: framework
|
|
467
467
|
side: be
|
|
468
|
-
why: 'the GraphQL transport of every back end (be.transport.graphql) that the front end calls; the ecommerce-app resolution on 2026-10-13.'
|
|
468
|
+
why: 'the GraphQL transport of every back end (be.transport.graphql) that the front end calls; the ecommerce-app resolution on 2026-10-13. Stays on 13.x for alpha.18: the npm-audit advisory fixed by 14.0.3 (semver major) is a documented accepted exception, upgrade deferred to alpha.19 (owner ruling graphql-13-advisory-accepted-until-a19, 2026-10-16).'
|
|
469
469
|
'@nestjs/apollo':
|
|
470
470
|
version: 13.4.5
|
|
471
471
|
group: framework
|
|
472
472
|
side: be
|
|
473
|
-
why: 'the Apollo driver of @nestjs/graphql; the ecommerce-app resolution on 2026-10-13.'
|
|
473
|
+
why: 'the Apollo driver of @nestjs/graphql; the ecommerce-app resolution on 2026-10-13. Stays on 13.x with @nestjs/graphql (accepted advisory, major deferred to alpha.19).'
|
|
474
474
|
'@apollo/server':
|
|
475
475
|
version: 5.5.1
|
|
476
476
|
group: framework
|
|
@@ -1,6 +1,6 @@
|
|
|
1
1
|
schema: starci/fe-stack@1
|
|
2
2
|
purpose: >-
|
|
3
|
-
The front-end stack of every app, lite and full alike (owner ruling 2026-10-13, R212 case-2): for each common front-end concern the
|
|
3
|
+
The front-end stack of every app, lite and full alike (owner ruling 2026-10-13, R212 case-2 (owner:lite-production-swarm), with the Work boundary amended by ruling:R212/case-4): for each common front-end concern the
|
|
4
4
|
ONE canonical library, its HFS home (slot ids of knowledge/hfs/slots.yaml), the pattern id that teaches it
|
|
5
5
|
(knowledge/patterns/fe/*.yaml) and the alternatives a front end never depends on or imports. Versions live in
|
|
6
6
|
knowledge/hfs/canon-pins.yaml only. `tier: core` packages are installed by every scaffold; `opt` packages are added when a feature
|
|
@@ -219,3 +219,24 @@ concerns:
|
|
|
219
219
|
pattern: FE-LINT
|
|
220
220
|
forbids: []
|
|
221
221
|
why: the canon lint and format configuration.
|
|
222
|
+
- id: auth-supabase
|
|
223
|
+
tier: opt
|
|
224
|
+
packages: ['@supabase/supabase-js', '@supabase/ssr']
|
|
225
|
+
home: [fe.modules.auth]
|
|
226
|
+
pattern: FE-AUTH
|
|
227
|
+
forbids: []
|
|
228
|
+
why: the lite auth provider client and PKCE server cookie adapter, confined to modules/auth; data still goes through the back end.
|
|
229
|
+
- id: framework-support
|
|
230
|
+
tier: opt
|
|
231
|
+
packages: [server-only, rxjs]
|
|
232
|
+
home: [fe.source-root-pinned]
|
|
233
|
+
pattern: FE-ROUTE
|
|
234
|
+
forbids: []
|
|
235
|
+
why: the Next server boundary marker and Apollo peer support used by canonical workspaces.
|
|
236
|
+
- id: tool-support
|
|
237
|
+
tier: opt
|
|
238
|
+
packages: ['@types/node', '@types/react', '@types/react-dom', '@starci/tsconfig', '@starci/stylelint-canon', '@tailwindcss/postcss', postcss-value-parser, stylelint, eslint-plugin-react-hooks]
|
|
239
|
+
home: [fe.tool-config]
|
|
240
|
+
pattern: FE-LINT
|
|
241
|
+
forbids: []
|
|
242
|
+
why: the compiler, CSS and lint support packages of the canonical front-end configs.
|