@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.
Files changed (80) hide show
  1. package/CHANGELOG.md +9 -0
  2. package/callback-shape.mjs +344 -0
  3. package/client-boundary.mjs +1 -1
  4. package/docs/hooks-folder.md +1 -1
  5. package/env-owner.mjs +120 -9
  6. package/function-budget.mjs +49 -0
  7. package/hooks-folder.mjs +149 -18
  8. package/icon.mjs +67 -0
  9. package/index.mjs +47 -0
  10. package/lib/own-hook-origin.mjs +53 -0
  11. package/lib/program-for.mjs +22 -0
  12. package/lib/pure-owner-helper.mjs +148 -0
  13. package/lib/redux-hook-origin.mjs +44 -0
  14. package/next-conventions.mjs +38 -35
  15. package/package.json +1 -1
  16. package/runtime/config.example.yaml +7 -6
  17. package/runtime/engine/config.mjs +10 -18
  18. package/runtime/engine/removed-vocabulary.mjs +0 -2
  19. package/runtime/knowledge/hfs/canon-pins.yaml +11 -11
  20. package/runtime/knowledge/hfs/fe-stack.yaml +22 -1
  21. package/runtime/knowledge/hfs/slots.yaml +333 -62
  22. package/runtime/knowledge/patterns/fe/folder.yaml +1 -0
  23. package/runtime/knowledge/sonar-gate.yaml +1 -1
  24. package/runtime/modules/kernel/removed-vocabulary.yaml +30 -0
  25. package/runtime/modules/models/runtimes.yaml +5 -7
  26. package/runtime/packages/hfs/templates/app/package-scripts/package.json +1 -0
  27. package/runtime/scripts/api/git/lib.mjs +4 -1
  28. package/runtime/scripts/api/git/merge-base.mjs +9 -0
  29. package/runtime/scripts/api/git/recorded-lines.mjs +54 -8
  30. package/runtime/scripts/hfs/architecture/backend-app-files.mjs +1 -8
  31. package/runtime/scripts/hfs/architecture/backend.mjs +2 -7
  32. package/runtime/scripts/hfs/architecture/client-reaches-server.mjs +6 -3
  33. package/runtime/scripts/hfs/architecture/config.mjs +1 -1
  34. package/runtime/scripts/hfs/architecture/dead-exports-bindings.mjs +149 -0
  35. package/runtime/scripts/hfs/architecture/dead-exports.mjs +9 -41
  36. package/runtime/scripts/hfs/architecture/default-deny.mjs +8 -6
  37. package/runtime/scripts/hfs/architecture/frontend-world.mjs +1 -1
  38. package/runtime/scripts/hfs/architecture/function-spec-providers.mjs +153 -0
  39. package/runtime/scripts/hfs/architecture/hfs.mjs +3 -3
  40. package/runtime/scripts/hfs/architecture/index.mjs +1 -1
  41. package/runtime/scripts/hfs/architecture/module-per-transport.mjs +28 -13
  42. package/runtime/scripts/hfs/architecture/next-data-inference.mjs +176 -0
  43. package/runtime/scripts/hfs/architecture/next-data-symbols.mjs +26 -0
  44. package/runtime/scripts/hfs/architecture/next-data.mjs +31 -23
  45. package/runtime/scripts/hfs/architecture/reachability.mjs +14 -0
  46. package/runtime/scripts/hfs/architecture/register-once.mjs +2 -2
  47. package/runtime/scripts/hfs/architecture/source-names.mjs +48 -3
  48. package/runtime/scripts/hfs/architecture/supabase-ast.mjs +211 -11
  49. package/runtime/scripts/hfs/architecture/supabase-be.mjs +1 -1
  50. package/runtime/scripts/hfs/architecture/supabase.mjs +59 -21
  51. package/runtime/scripts/hfs/architecture/surface.mjs +2 -1
  52. package/runtime/scripts/hfs/architecture/tiers.mjs +4 -4
  53. package/runtime/scripts/hfs/architecture/unit-spec-providers.mjs +8 -2
  54. package/runtime/scripts/hfs/declaration-shape.mjs +39 -3
  55. package/runtime/scripts/hfs/edition-slots.mjs +2 -2
  56. package/runtime/scripts/hfs/manifest-shape.mjs +69 -9
  57. package/runtime/scripts/hfs/param-names.mjs +1 -1
  58. package/runtime/scripts/hfs/project-rule.mjs +3 -1
  59. package/runtime/scripts/hfs/rule-catalog.mjs +158 -11
  60. package/runtime/scripts/hfs/rule-params-shape.mjs +22 -10
  61. package/runtime/scripts/hfs/rules/secrets.mjs +13 -0
  62. package/runtime/scripts/hfs/slot-imports.mjs +18 -5
  63. package/runtime/scripts/hfs/slots.mjs +3 -2
  64. package/runtime/scripts/hfs/typescript-programs.mjs +0 -8
  65. package/runtime/scripts/lib/env.mjs +20 -0
  66. package/runtime/scripts/lib/event-contract.mjs +107 -0
  67. package/runtime/scripts/lib/git.mjs +1 -1
  68. package/runtime/scripts/lib/i18n.mjs +0 -2
  69. package/runtime/scripts/lib/json-clone.mjs +61 -0
  70. package/runtime/scripts/lib/language.mjs +1 -1
  71. package/runtime/scripts/lib/list.mjs +4 -0
  72. package/runtime/scripts/lib/secret-patterns.mjs +60 -5
  73. package/runtime/scripts/lib/stack-services.mjs +1 -1
  74. package/runtime/scripts/lib/ts-analysis.mjs +5 -2
  75. package/runtime/scripts/lib/ts-ast.mjs +27 -2
  76. package/served-locale.mjs +80 -9
  77. package/size-growth.mjs +10 -6
  78. package/swr-family.mjs +197 -0
  79. package/translation.mjs +135 -7
  80. package/transport.mjs +126 -59
@@ -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, stem } from "./lib/scope.mjs"
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|@lingui\/.+|typesafe-i18n|rosetta)(?:\/.*)?$/
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 a module exports, from declarations and specifiers. */
141
- const exportedNames = (program) => {
142
- const names = new Set()
143
- for (const statement of program.body) {
144
- if (statement.type !== "ExportNamedDeclaration") continue
145
- const declaration = statement.declaration
146
- if (declaration && declaration.id) names.add(declaration.id.name)
147
- if (declaration && declaration.type === "VariableDeclaration") {
148
- for (const entry of declaration.declarations) if (entry.id.type === "Identifier") names.add(entry.id.name)
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 variable a name binds to, walking up from the scope of a node. */
342
- const bindingOf = (context, identifier) => {
343
- let scope = (context.sourceCode ?? context.getSourceCode()).getScope(identifier)
344
- while (scope) {
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 === "Identifier") {
355
- const definition = bindingOf(context, callee)
356
- if (definition?.type !== "ImportBinding") return null
357
- const source = String(definition.parent.source.value)
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.0",
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 — where the full test suite 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 suite and the Linux parity container before it pushes, and the pre-push gate asks for their green rows
190
- # suite: ci the owner's recorded choice (2026-10-09): no local full suite and no Linux container; the GitHub ci workflow runs the suite (with coverage, Codecov, SonarCloud) AFTER the push.
191
- # The cut still runs npm run check, npm run test:packages, the specs affected by the release, the live Orca smokes and the example apps; the record lists the root suite as
192
- # delegated, never green. A release can reach GitHub and its tag before the suite has run; a red CI is fixed forward with the next pre-release (starci release ci-status).
193
- # "none" is refused: the suite does not vanish, it moves to CI. Set it only in the gitignored config.yaml copy: release: {suite: ci}
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,secretEnv,connectorSecret} from './secrets.mjs';
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
- export 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']);
247
- export function parseAllocationGrant(text){
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): {harness?, unit?, e2e?} booleans - each family a boolean; absent = its default (SPEC_DEFAULTS: harness off, unit on, e2e off; specsSettings).
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 (tests/setup/isolated-temp.mjs points it at a spec's own temp root). */
360
- export const OWNER_CONFIG_WITHIN_ENV='STARCI_OWNER_CONFIG_WITHIN';
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: harness off, unit on, e2e off.
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(['harness','unit','e2e']);
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
- export const CONFIG_KEY_TREE=Object.freeze({
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({harness:false,unit:true,e2e:false});
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.3.1
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.3.0
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.2.7
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.1
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.3.0
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.3.0
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.1.6
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.5
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.15.2
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.