@starci/eslint-canon-be 3.11.19 → 3.13.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,16 @@
1
1
  # Changelog
2
2
 
3
+ ## 3.13.0 - 2026-11-03
4
+
5
+ - Changed: the runtime copies of the slot manifest carry the managed sign-in slots and the slot field `managedOnly`.
6
+ - Changed: `own-jwks-only` refuses `jwtVerify`, `decodeJwt`, `decodeProtectedHeader` and `createRemoteJWKSet` of jose in every app file; `refresh-token-cookie-only` no longer exempts `integrations/passport` (the package sets the cookie); the infrastructure table owns the identity libraries by nobody and `@starci/auth` by `integrations/passport` (R328, R329, R330).
7
+
8
+ ## 3.12.0
9
+
10
+ - Added: `starci-be/explicit-export-surface` (R368, `HFS_EXPLICIT_EXPORT_SURFACE`) at error: an exported function's return type, an exported variable's type and a parameter's type are written, not inferred from a body or from other files. It reports each export the isolated declaration emit cannot write, at the offending span, and says what to annotate. It reads the classifier the lint result cache reads.
11
+ - Added: `projectGraphSnapshot`, the findings of the project graph the process has already built, which the ESLint child hands to the cache; `projectGraph` stays the fresh build.
12
+ - Changed: carry the bundled runtime of @starci/hfs 5.1.0 (the classifier, the rule factory, the rule catalog with R368, the canon pins).
13
+
3
14
  ## 3.11.19
4
15
 
5
16
  - Changed: Carry the bundled runtime of @starci/hfs 5.0.8 (the rule texts name `app check`, the read-set helper of the rule memo) and its canon pins; the comments name `app check` for the removed lint verb.
package/README.md CHANGED
@@ -155,6 +155,16 @@ in `src/lib/hfs-view.ts`, which is emitted, so the published declarations of `lo
155
155
  untyped runtime file. `fixtures/` is spec data and stays JavaScript with
156
156
  `.d.mts` contracts, because the front-end canon and the Grammar lint families import its helpers by path.
157
157
 
158
+ The [explicit exported surface](../../contexts/code/shared/typing.md) (R368, SHARED-TYPING-5) is `explicit-export-surface`
159
+ (`HFS_EXPLICIT_EXPORT_SURFACE`): an exported function's return type, an exported variable's type and a parameter's type are
160
+ written where they are exported, never inferred from a body or from other files; a component that returns only JSX, `null` or
161
+ `undefined` is explicit. It reports each export TypeScript's isolated declaration emit cannot write, at the offending span, and says
162
+ which annotation to add. It reads the classifier the lint result cache reads (`declarationSurface`, the bundled
163
+ `runtime/scripts/lib/declaration-surface.mjs`), so it reports exactly the files the cache counts as open.
164
+
165
+ `projectGraph` and `projectGraphSnapshot` are the cache's two readers of the project graph the graph rules share: the first builds it
166
+ afresh, the second answers from the graph the process has already built, which is how the ESLint child hands its graph to the cache.
167
+
158
168
  ## HFS rules and their why codes
159
169
 
160
170
  Every rule of this plugin is an enforcer of one HFS rule. The relation (rule id -> HFS rule -> catalogued Vietnamese why code)
@@ -1,9 +1,7 @@
1
1
  import type { Recommended, RuleModule } from "./lib/rule.js";
2
- /** The owner id (`<tier>/<capability>`) of the lite identity integration. */
3
- export declare const PASSPORT_OWNER = "integrations/passport";
4
- /** A lite principal comes only from the app's own verified token. */
2
+ /** A lite principal comes only from the app's own token, verified by the package. */
5
3
  export declare const ownJwksOnly: RuleModule;
6
- /** A refresh token lives only in the integration's httpOnly cookie. */
4
+ /** A refresh token lives only in the package's httpOnly cookie. */
7
5
  export declare const refreshTokenCookieOnly: RuleModule;
8
6
  /** The rules of the lite identity law, by name. */
9
7
  export declare const rules: {
@@ -1,44 +1,36 @@
1
1
  /**
2
2
  * The rules of the lite identity (catalog R329 `BE_AUTH_JWT_OWN_JWKS`, R330 `BE_AUTH_REFRESH_COOKIE`; contexts/code/be/api-auth.md
3
3
  * BE-AUTH-2 and BE-AUTH-3). Which owner may import the identity and S3 libraries at all is the infrastructure table of the slot
4
- * manifest (`ruleParams.be.infraOwners`, judged by `infra-import-owner`: R328 `BE_AUTH_PASSPORT_OWNER`, R331 `BE_STORAGE_OWNER`).
4
+ * manifest (`ruleParams.be.infraOwners`, judged by `infra-import-owner`: R328 `BE_AUTH_PASSPORT_OWNER`, R331 `BE_STORAGE_OWNER`): the
5
+ * identity libraries belong to `@starci/auth` and to no app file, and `@starci/auth` itself only to `integrations/passport`.
5
6
  *
6
- * - `own-jwks-only`: the app verifies only its own access tokens. `createRemoteJWKSet` (a remote identity provider's key set),
7
- * `decodeJwt` and `decodeProtectedHeader` (a token read without its signature) are refused wherever jose is imported, and
8
- * `jwtVerify` is imported only by `integrations/passport`. The architecture machine (`own-jwks-principal`) proves the rest:
9
- * the verifier checks `createLocalJWKSet` over the app's keys with issuer, audience and algorithms pinned.
10
- * - `refresh-token-cookie-only`: a refresh token never travels in a body. Outside `integrations/passport` no object literal,
11
- * class property or type member is named `refreshToken` or `refresh_token`, and no `.cookie()`/`.clearCookie()` call names a
12
- * refresh cookie: the cookie is set, rotated and cleared only by the integration's `setRefreshCookie`/`clearRefreshCookie`.
13
- * Its attributes (httpOnly, Secure, SameSite=Strict, the refresh path) are `response-cookie-attributes` (R141) and the
14
- * integration's own spec; rotation with reuse detection is held by the identity domain's spec and review.
7
+ * - `own-jwks-only`: the app verifies no token itself. `createRemoteJWKSet` (a remote identity provider's key set), `decodeJwt`,
8
+ * `decodeProtectedHeader` (a token read without its signature) and `jwtVerify` are refused wherever jose is imported; the package
9
+ * verifies against its own key set. The architecture machine (`own-jwks-principal`) proves the same on the call sites.
10
+ * - `refresh-token-cookie-only`: a refresh token never travels in a body. No object literal, class property or type member is
11
+ * named `refreshToken` or `refresh_token`, and no `.cookie()`/`.clearCookie()` call names a refresh cookie: `@starci/auth` sets,
12
+ * rotates and clears it. Its attributes and rotation with reuse detection are the package's own specs.
15
13
  */
16
14
  import { keyName, staticText } from "./lib/ast.js";
17
- import { hfsOf } from "./lib/hfs.js";
18
- /** The owner id (`<tier>/<capability>`) of the lite identity integration. */
19
- export const PASSPORT_OWNER = "integrations/passport";
20
- /** The jose exports no file uses: a remote key set and the unverified decoders. */
21
- const FORBIDDEN_JOSE = new Set(["createRemoteJWKSet", "decodeJwt", "decodeProtectedHeader"]);
15
+ /** The jose exports no app file uses: a remote key set, the unverified decoders and the verifier itself. */
16
+ const FORBIDDEN_JOSE = new Set(["createRemoteJWKSet", "decodeJwt", "decodeProtectedHeader", "jwtVerify"]);
22
17
  const REFRESH_NAME = /^refresh_?token$/i;
23
18
  const REFRESH_COOKIE = /refresh/i;
24
- /** The owner id of a file: the last two segments of its owner root, or null when no owner holds it. */
25
- const ownerIdOf = (context, filename) => {
26
- const root = hfsOf(context).ownerOf(filename);
27
- return root === null ? null : root.split("/").slice(-2).join("/");
19
+ const WHY = {
20
+ createRemoteJWKSet: "trusts another issuer's key set",
21
+ jwtVerify: "verifies a token in the app",
28
22
  };
29
- /** A lite principal comes only from the app's own verified token. */
23
+ /** A lite principal comes only from the app's own token, verified by the package. */
30
24
  export const ownJwksOnly = {
31
25
  meta: {
32
26
  type: "problem",
33
- docs: { description: "Only integrations/passport verifies a token (jose jwtVerify over the app's own key set); no remote JWKS and no unverified decode anywhere." },
27
+ docs: { description: "No app file verifies or decodes a token with jose: `@starci/auth` verifies the app's own access tokens against its own key set." },
34
28
  schema: [],
35
29
  messages: {
36
- forbidden: "`{{name}}` of jose {{why}}. The app verifies only its own access tokens through the token kit of `integrations/passport` (jwtVerify over createLocalJWKSet).",
37
- verifier: "`jwtVerify` is imported outside `integrations/passport`. Verify a token through the integration's verifier (`OWN_TOKEN_VERIFIER`), which domain/identity turns into the principal.",
30
+ forbidden: "`{{name}}` of jose {{why}}. The app verifies only its own access tokens, and `@starci/auth` does it (the verifier of `integrations/passport`, `OWN_TOKEN_VERIFIER`, which `domain/identity` turns into the principal).",
38
31
  },
39
32
  },
40
33
  create(context) {
41
- const owner = ownerIdOf(context, context.filename) === PASSPORT_OWNER;
42
34
  return {
43
35
  ImportDeclaration(node) {
44
36
  if (node.source.value !== "jose")
@@ -48,29 +40,25 @@ export const ownJwksOnly = {
48
40
  continue;
49
41
  const name = keyName(specifier.imported);
50
42
  if (name !== null && FORBIDDEN_JOSE.has(name)) {
51
- context.report({ node: specifier, messageId: "forbidden", data: { name, why: name === "createRemoteJWKSet" ? "trusts another issuer's key set" : "reads a token without proving its signature" } });
43
+ context.report({ node: specifier, messageId: "forbidden", data: { name, why: WHY[name] ?? "reads a token without proving its signature" } });
52
44
  }
53
- else if (name === "jwtVerify" && !owner)
54
- context.report({ node: specifier, messageId: "verifier" });
55
45
  }
56
46
  },
57
47
  };
58
48
  },
59
49
  };
60
- /** A refresh token lives only in the integration's httpOnly cookie. */
50
+ /** A refresh token lives only in the package's httpOnly cookie. */
61
51
  export const refreshTokenCookieOnly = {
62
52
  meta: {
63
53
  type: "problem",
64
- docs: { description: "A refresh token never appears as a body field, and only integrations/passport sets or clears the refresh cookie." },
54
+ docs: { description: "A refresh token never appears as a body field, and no app file sets or clears the refresh cookie: `@starci/auth` does." },
65
55
  schema: [],
66
56
  messages: {
67
- field: "`{{name}}` carries a refresh token in a body. The refresh token lives only in the httpOnly, Secure, SameSite=Strict cookie that `integrations/passport` rotates (`setRefreshCookie`).",
68
- cookie: "`{{call}}` names the refresh cookie outside `integrations/passport`. Set and clear it only through `setRefreshCookie` and `clearRefreshCookie`.",
57
+ field: "`{{name}}` carries a refresh token in a body. The refresh token lives only in the httpOnly, Secure cookie that `@starci/auth` sets, rotates and clears.",
58
+ cookie: "`{{call}}` names the refresh cookie in the app. `@starci/auth` sets and clears it through `AuthDoors`; the app never writes it.",
69
59
  },
70
60
  },
71
61
  create(context) {
72
- if (ownerIdOf(context, context.filename) === PASSPORT_OWNER)
73
- return {};
74
62
  const field = (node, key, computed) => {
75
63
  const name = computed ? null : keyName(key);
76
64
  if (name !== null && REFRESH_NAME.test(name))
@@ -0,0 +1,7 @@
1
+ import type { Recommended, RuleModule } from "./lib/rule.js";
2
+ /** The rules this law contributes to the plugin. */
3
+ export declare const rules: {
4
+ "explicit-export-surface": RuleModule;
5
+ };
6
+ /** Every exported type is written out, at error. */
7
+ export declare const recommended: Recommended;
@@ -0,0 +1,19 @@
1
+ /**
2
+ * The explicit exported surface (HFS R368, `HFS_EXPLICIT_EXPORT_SURFACE`): an exported declaration states its type, in the file that exports it.
3
+ *
4
+ * A return type, variable type or parameter type left to inference is a surface importers read from the body and from the files the body uses, so
5
+ * the result cache of `starci app check --gate lint` lints every importer again whenever the file changes (check-cache.md, ESLint). The rule
6
+ * reports each export the isolated declaration emit (`ts.transpileDeclaration`) cannot write without inference, where it is written, and says
7
+ * what to annotate. A component that returns only JSX has the type the JSX namespace gives it and is not reported. It is the very classifier the
8
+ * cache reads (`declarationSurface` of the bundled runtime), so the rule reports exactly the files the cache counts as open.
9
+ */
10
+ import ts from "typescript";
11
+ import { explicitSurfaceRule } from "../runtime/scripts/hfs/explicit-surface-rule.mjs";
12
+ /** The rules this law contributes to the plugin. */
13
+ export const rules = {
14
+ "explicit-export-surface": explicitSurfaceRule({ ts }),
15
+ };
16
+ /** Every exported type is written out, at error. */
17
+ export const recommended = {
18
+ "starci-be/explicit-export-surface": "error",
19
+ };
package/dist/index.d.ts CHANGED
@@ -54,5 +54,5 @@ export { linterOptions } from "./lib/config.js";
54
54
  export { loadHfs } from "./lib/hfs.js";
55
55
  export { crossFileInputs } from "./lib/cross-file-inputs.js";
56
56
  export type { CrossFileInput } from "./lib/cross-file-inputs.js";
57
- export { projectGraph } from "./project-graph.js";
57
+ export { projectGraph, projectGraphSnapshot } from "./project-graph.js";
58
58
  export type { ProjectGraphFinding, ProjectGraphSnapshot } from "./project-graph.js";
package/dist/index.js CHANGED
@@ -61,6 +61,7 @@ import { recommended as serviceIsolationRecommended, rules as serviceIsolationRu
61
61
  import { recommended as sizeBudgetRecommended, rules as sizeBudgetRules } from "./size-budget.js";
62
62
  import { recommended as specNoSkipRecommended, rules as specNoSkipRules } from "./spec-no-skip.js";
63
63
  import { recommended as specQualityRecommended, rules as specQualityRules } from "./spec-quality.js";
64
+ import { recommended as explicitSurfaceRecommended, rules as explicitSurfaceRules } from "./explicit-surface.js";
64
65
  import { recommended as suppressionRecommended, rules as suppressionRules } from "./suppression.js";
65
66
  import { recommended as temporalRecommended, rules as temporalRules } from "./temporal.js";
66
67
  import { recommended as testingRecommended, rules as testingRules } from "./testing.js";
@@ -121,6 +122,7 @@ const CONTRIBUTIONS = [
121
122
  { law: "size-budget", rules: sizeBudgetRules, recommended: sizeBudgetRecommended },
122
123
  { law: "spec-no-skip", rules: specNoSkipRules, recommended: specNoSkipRecommended },
123
124
  { law: "spec-quality", rules: specQualityRules, recommended: specQualityRecommended },
125
+ { law: "explicit-surface", rules: explicitSurfaceRules, recommended: explicitSurfaceRecommended },
124
126
  { law: "suppression", rules: suppressionRules, recommended: suppressionRecommended },
125
127
  { law: "temporal", rules: temporalRules, recommended: temporalRecommended },
126
128
  { law: "testing", rules: testingRules, recommended: testingRecommended },
@@ -220,4 +222,4 @@ for (const entry of [
220
222
  }
221
223
  // The result cache of `starci app check --gate lint` (contexts/project/check-cache.md) reads these two declarations of the installed canon.
222
224
  export { crossFileInputs } from "./lib/cross-file-inputs.js";
223
- export { projectGraph } from "./project-graph.js";
225
+ export { projectGraph, projectGraphSnapshot } from "./project-graph.js";
@@ -49,8 +49,8 @@ const inRoleSlot = (hfs, role, filename) => (role.optional === true ? inCoverage
49
49
  /** The path of a classified file below the instance root of its slot. */
50
50
  const slotRelative = (found) => (found.root !== undefined && found.path.startsWith(`${found.root}/`) ? found.path.slice(found.root.length + 1) : baseOf(found.path));
51
51
  /**
52
- * The optional spec role of a spec beside a logic file its slot declares (`logic`): `passport.tokens.spec.ts` beside the declared
53
- * `passport.tokens.ts` gives `{ role: "tokens", spec: "tokens.spec" }`, so the subject resolves as a logic role's does. It holds for that
52
+ * The optional spec role of a spec beside a logic file its slot declares (`logic`): `passport.kit.spec.ts` beside the declared
53
+ * `passport.kit.ts` gives `{ role: "kit", spec: "kit.spec" }`, so the subject resolves as a logic role's does. It holds for that
54
54
  * one declared file only, never for another `*.tokens.ts`, and adds no role name to the manifest.
55
55
  */
56
56
  const declaredLogicRole = (hfs, filename) => {
@@ -34,3 +34,17 @@ export declare const projectGraph: ({ repoRoot, injectedTypeScript }: {
34
34
  repoRoot: string;
35
35
  injectedTypeScript?: object;
36
36
  }) => ProjectGraphSnapshot;
37
+ /**
38
+ * The same findings from the graph this process has already built, so a process that linted the side hands them out without building the graph again.
39
+ *
40
+ * The rules read one graph per process and per side, built when the first file is linted. The ESLint child of `starci app check --gate lint` calls
41
+ * this after its run and writes the result beside its report; the result cache keeps the graph findings from it instead of building the graph a
42
+ * second time in the CLI. A process that has not built the graph yet builds it here, once, exactly as `projectGraph` does, and the value is the
43
+ * same: `projectGraph` is a fresh build, this is the build the rules used.
44
+ *
45
+ * @param input - The side folder (`repoRoot`, the folder of the side's `eslint.config.mjs`).
46
+ * @returns The findings of the rules of `recommended`, keyed by path relative to the side folder.
47
+ */
48
+ export declare const projectGraphSnapshot: ({ repoRoot }: {
49
+ repoRoot: string;
50
+ }) => ProjectGraphSnapshot;
@@ -32,7 +32,22 @@ export const recommended = Object.fromEntries(mine.map((e) => [`starci-be/${e.id
32
32
  */
33
33
  export const projectGraph = ({ repoRoot, injectedTypeScript }) => {
34
34
  resetProjectGraphs();
35
- const graph = buildProjectGraph({ repoRoot, ...(injectedTypeScript === undefined ? {} : { injectedTypeScript }), runtimeRoot: RUNTIME_ROOT });
35
+ return snapshotOf(buildProjectGraph({ repoRoot, ...(injectedTypeScript === undefined ? {} : { injectedTypeScript }), runtimeRoot: RUNTIME_ROOT }));
36
+ };
37
+ /**
38
+ * The same findings from the graph this process has already built, so a process that linted the side hands them out without building the graph again.
39
+ *
40
+ * The rules read one graph per process and per side, built when the first file is linted. The ESLint child of `starci app check --gate lint` calls
41
+ * this after its run and writes the result beside its report; the result cache keeps the graph findings from it instead of building the graph a
42
+ * second time in the CLI. A process that has not built the graph yet builds it here, once, exactly as `projectGraph` does, and the value is the
43
+ * same: `projectGraph` is a fresh build, this is the build the rules used.
44
+ *
45
+ * @param input - The side folder (`repoRoot`, the folder of the side's `eslint.config.mjs`).
46
+ * @returns The findings of the rules of `recommended`, keyed by path relative to the side folder.
47
+ */
48
+ export const projectGraphSnapshot = ({ repoRoot }) => snapshotOf(buildProjectGraph({ repoRoot, runtimeRoot: RUNTIME_ROOT }));
49
+ /** The findings of the rules of this canon in a built graph, by side-relative path, each list sorted by line, column, code and message. */
50
+ const snapshotOf = (graph) => {
36
51
  const byFile = {};
37
52
  for (const [file, findings] of graph.byFile) {
38
53
  for (const finding of findings) {
package/package.json CHANGED
@@ -1,6 +1,6 @@
1
1
  {
2
2
  "name": "@starci/eslint-canon-be",
3
- "version": "3.11.19",
3
+ "version": "3.13.0",
4
4
  "description": "The StarCi back-end lint canon: every rule its laws publish, gathered as one flat-config plugin.",
5
5
  "type": "module",
6
6
  "license": "MIT",
@@ -126,6 +126,7 @@
126
126
  "scripts/hfs/declaration-shape.mjs",
127
127
  "scripts/hfs/declaration-slots.mjs",
128
128
  "scripts/hfs/edition-slots.mjs",
129
+ "scripts/hfs/explicit-surface-rule.mjs",
129
130
  "scripts/hfs/linear-text.mjs",
130
131
  "scripts/hfs/param-names.mjs",
131
132
  "scripts/hfs/path-findings.mjs",
@@ -151,6 +152,7 @@
151
152
  "scripts/hfs/trailing-slashes.mjs",
152
153
  "scripts/hfs/typescript-programs.mjs",
153
154
  "scripts/hfs/view.mjs",
155
+ "scripts/lib/declaration-surface.mjs",
154
156
  "scripts/lib/dockerfile.mjs",
155
157
  "scripts/lib/env.mjs",
156
158
  "scripts/lib/event-contract.mjs",
@@ -30,36 +30,43 @@ pins:
30
30
  side: fe
31
31
  source: packages/event-stream/package.json
32
32
  why: 'the one server-sent-events client of every front end (fe-stack event-stream, owner:event-stream-package): the transport client layer (modules/api/sse/clients) creates one instance for the app with the bearer token source and the stream operations follow on it; it carries Last-Event-ID resume, the capped doubling backoff, the heartbeat timeout, the single 401 renewal and the useSWRSubscription adapter, so no app keeps a hand-written reader.'
33
+ '@starci/next-data':
34
+ version: 0.1.0
35
+ group: starci
36
+ install: registry
37
+ side: fe
38
+ source: packages/next-data/package.json
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.'
33
40
  '@starci/grammar':
34
- version: 0.21.12
41
+ version: 0.21.14
35
42
  group: starci
36
43
  install: registry
37
44
  side: fe
38
45
  source: packages/grammar/package.json
39
46
  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.'
40
47
  '@starci/eslint-canon-be':
41
- version: 3.11.19
48
+ version: 3.13.0
42
49
  group: starci
43
50
  install: registry
44
51
  side: be
45
52
  source: packages/eslint-canon-be/package.json
46
53
  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.'
47
54
  '@starci/eslint-canon-fe':
48
- version: 9.9.12
55
+ version: 9.11.0
49
56
  group: starci
50
57
  install: registry
51
58
  side: fe
52
59
  source: packages/eslint-canon-fe/package.json
53
60
  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.'
54
61
  '@starci/eslint-grammar-core':
55
- version: 0.21.12
62
+ version: 0.21.14
56
63
  group: starci
57
64
  install: registry
58
65
  side: fe
59
66
  source: packages/eslint-grammar-core/package.json
60
67
  why: 'the StarCi Grammar component API lint, versioned with @starci/grammar; front ends compose this family package with the universal FE canon.'
61
68
  '@starci/eslint-grammar-offset-pop':
62
- version: 0.21.12
69
+ version: 0.21.14
63
70
  group: starci
64
71
  install: registry
65
72
  side: fe
@@ -85,14 +92,14 @@ pins:
85
92
  side: both
86
93
  source: packages/prettier-config/package.json
87
94
  '@starci/jest-preset':
88
- version: 2.6.0
95
+ version: 2.6.1
89
96
  group: starci
90
97
  install: registry
91
98
  side: be
92
99
  source: packages/jest-preset/package.json
93
100
  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, fakeQueryBuilder, queueQueryBuilders, fakeIds, FakeClock, Outcome matchers) and the recordingOutbox claim side.'
94
101
  '@starci/test-world':
95
- version: 1.3.3
102
+ version: 1.3.4
96
103
  group: starci
97
104
  install: registry
98
105
  side: be
@@ -105,8 +112,22 @@ pins:
105
112
  side: be
106
113
  source: packages/ai-router/package.json
107
114
  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.'
115
+ '@starci/auth':
116
+ version: 0.1.0
117
+ group: starci
118
+ install: registry
119
+ side: both
120
+ source: packages/auth/package.json
121
+ why: 'the lite sign-in: the NestJS module (EdDSA access tokens with a multi-key JWKS, passwords, Google OAuth with state and PKCE, rotating refresh sessions, the sign-in budget, the refresh cookie), the front-end client and its React bindings, the door contracts and test doubles; the one importer of the identity libraries, reached by a back end only through integrations/passport; @starci/jest-preset compiles it as an ESM-only dependency.'
122
+ '@starci/object-storage':
123
+ version: 0.1.0
124
+ group: starci
125
+ install: registry
126
+ side: be
127
+ source: packages/object-storage/package.json
128
+ why: 'object storage of a back end: a NestJS module and the ObjectStorage port over S3-compatible storage (presigned PUT and GET that sign the content type and size, head, get, put, list, delete, bucket setup, size and content-type limits, coded errors), with @starci/object-storage/testing for its specs; the only importer of @aws-sdk/client-s3 and @aws-sdk/s3-request-presigner (R331).'
108
129
  '@starci/hfs':
109
- version: 5.0.8
130
+ version: 5.2.0
110
131
  group: starci
111
132
  install: registry
112
133
  side: both
@@ -543,12 +564,12 @@ pins:
543
564
  version: 3.1150.0
544
565
  group: framework
545
566
  side: be
546
- why: 'the S3 transport of integrations/object-storage, the one ObjectStorage adapter of both editions (MinIO, S3, Spaces); 3.1150.0 is the release of 2026-10-12, chosen over newer ones that had not aged two weeks.'
567
+ why: 'the S3 transport inside @starci/object-storage, the one ObjectStorage adapter of both editions (MinIO, S3, Spaces), which depends on it at exactly this version and which no app file imports; 3.1150.0 is the release of 2026-10-12, chosen over newer ones that had not aged two weeks.'
547
568
  '@aws-sdk/s3-request-presigner':
548
569
  version: 3.1150.0
549
570
  group: framework
550
571
  side: be
551
- why: 'signs the presigned PUT and GET of integrations/object-storage locally, the same release as client-s3.'
572
+ why: 'signs the presigned PUT and GET inside @starci/object-storage locally, the same release as client-s3; no app file imports it.'
552
573
  '@apollo/server':
553
574
  version: 5.5.1
554
575
  group: framework
@@ -37,17 +37,17 @@ concerns:
37
37
  - id: rest
38
38
  tier: core
39
39
  packages: [axios]
40
- home: [fe.modules.api, fe.modules.auth]
40
+ home: [fe.modules.api]
41
41
  pattern: FE-API-REST
42
42
  forbids: [ky, superagent, node-fetch, cross-fetch, isomorphic-fetch]
43
- why: modules/api/rest/<area>/*.ts for uploads and presigned URLs, and modules/auth/auth-door.ts for the app's own auth doors only; GraphQL carries every other call.
43
+ why: modules/api/rest/<area>/*.ts for uploads and presigned URLs, only; GraphQL carries every other call.
44
44
  - id: data
45
45
  tier: core
46
- packages: [swr]
46
+ packages: [swr, '@starci/next-data']
47
47
  home: [fe.hooks.swr]
48
48
  pattern: FE-DATA-SWR
49
49
  forbids: ['@tanstack/react-query', react-query]
50
- why: hooks/swr/api/{graphql,rest}/{queries,mutations}/use*Swr.ts wrap one operation each; components call hooks only.
50
+ why: hooks/swr/api/{graphql,rest}/{queries,mutations}/use*Swr.ts wrap one operation each; components call hooks only. The polling-restart middleware (pollingRestart), the key helpers, the viewer-keyed config and the viewer cache are @starci/next-data's (owner next-data-package); an app imports no Middleware or ScopedMutator type of swr and writes none of them.
51
51
  - id: toast
52
52
  tier: core
53
53
  packages: ['@heroui/react']
@@ -96,11 +96,11 @@ concerns:
96
96
  hand-written reader (read-event-stream.ts) and no second SSE library is installed.
97
97
  - id: auth
98
98
  tier: core
99
- packages: []
99
+ packages: ['@starci/auth']
100
100
  home: [fe.modules.auth]
101
101
  pattern: FE-AUTH
102
- forbids: ['@supabase/supabase-js', '@supabase/ssr', '@supabase/auth-js']
103
- why: modules/auth is the session issuer's client (lite - auth-door.ts over the app's own back-end auth doors with the in-memory token store; full - the app's IdP client); it yields the session and the access token for the Apollo link and never reads data.
102
+ forbids: ['@supabase/supabase-js', '@supabase/ssr', '@supabase/auth-js', jose, jwt-decode, next-auth, '@auth/core', keycloak-js, oidc-client-ts]
103
+ why: modules/auth is the session issuer's client (one @starci/auth client instance over the app's own back-end auth doors, the access token in its memory; full - the app's IdP client); it yields the session and the access token for the Apollo link and never reads data.
104
104
  - id: i18n
105
105
  tier: core
106
106
  packages: [next-intl]