@starci/eslint-canon-fe 9.1.11 → 9.1.12

package/CHANGELOG.md

@@ -1,5 +1,9 @@
 # Changelog
 
+## 9.1.12 - 2026-10-27
+
+- Changed: owner ruling two-grammars: the bundled Grammar catalog names the core family `core` and carries the one alias table (`familyAliases`: `starci`, `starci-core` -> `core`); the bundled grammar-lint resolver answers by the canonical id, so a front end with `sides.fe.grammar: core` resolves its component contract and lint family. The runtime copy is refreshed from starci-academy-backend/.claude 180193f12 (canon pins: the Grammar family 0.12.15, hfs 4.7.48). No rule changes.
+
 ## 9.1.11 - 2026-10-27
 
 - Changed: licensed MIT (was UNLICENSED); the package metadata names the repository, homepage and bugs so npm can attach provenance. No rule or behaviour changed.

package/README.md

@@ -51,6 +51,6 @@ Regression specs belong to this package. Application front ends and Grammar libr
 
 `runtime/` holds the StarCi runtime files the rules import (the slot manifest and view, the project graph and the
 architecture machine it runs, the Sonar syntax rules), byte for byte at their runtime paths. In this repository it is a
-committed snapshot taken from the legacy runtime (starci-academy-backend/.claude at 7424b89ca), where
+committed snapshot taken from the legacy runtime (starci-academy-backend/.claude at 180193f12), where
 `scripts/hfs/sync-runtime.mjs` generates it; refresh it by running that generator there and copying
 `packages/eslint/fe/runtime/` over this folder. Nothing in this package edits it.

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@starci/eslint-canon-fe",
-  "version": "9.1.11",
+  "version": "9.1.12",
   "description": "Universal front-end lint laws for TypeScript and Next.js, independent of the selected Grammar family.",
   "type": "module",
   "license": "MIT",

package/runtime/knowledge/grammars/index.yaml

@@ -66,6 +66,12 @@ topics:
     title: Heritage Grammar
     summary: |
       Generated snapshot of the Heritage family's parity declaration, arrangement, scoped tokens and Common renderers.
+# The one alias table of Grammar family ids (ruling two-grammars, 2026-10-27): `core` is the canonical id of the
+# legacy core grammar; the legacy catalog id `starci` and the DNA id `starci-core` are deprecated spellings that
+# resolve to it. Every reader resolves a selection through scripts/lib/grammar-lint.mjs, never through its own list.
+familyAliases:
+  starci: core
+  starci-core: core
 families:
   - id: heritage
     title: heritage
@@ -85,8 +91,8 @@ families:
       (`defineGrammarFamily`), not a family that ships a palette, so `authority`, `reusableStyle`,
       `productComposition` and `index` have nothing to name here. Universal semantics, renderer anatomy,
       state and accessibility remain owned by knowledge/ui.
-  - id: starci
-    title: starci
+  - id: core
+    title: core
     contractRef: common
     lint:
       package: '@starci/eslint-grammar-starci'

package/runtime/knowledge/hfs/canon-pins.yaml

@@ -30,35 +30,35 @@ pins:
     source: packages/event-stream/package.json
     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.'
   '@starci/grammar':
-    version: 0.12.13
+    version: 0.12.15
     group: starci
     install: registry
     side: fe
     source: packages/grammar/package.json
     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.'
   '@starci/eslint-canon-be':
-    version: 3.4.55
+    version: 3.4.56
     group: starci
     install: registry
     side: be
     source: packages/eslint/be/package.json
     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.'
   '@starci/eslint-canon-fe':
-    version: 9.1.9
+    version: 9.1.10
     group: starci
     install: registry
     side: fe
     source: packages/eslint/fe/package.json
     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.'
   '@starci/eslint-grammar-starci':
-    version: 0.12.13
+    version: 0.12.15
     group: starci
     install: registry
     side: fe
     source: packages/eslint/grammar-starci/package.json
     why: 'the StarCi Grammar component API lint, versioned with @starci/grammar; front ends compose this family package with the universal FE canon.'
   '@starci/eslint-grammar-offset-pop':
-    version: 0.12.13
+    version: 0.12.15
     group: starci
     install: registry
     side: fe
@@ -98,14 +98,14 @@ pins:
     source: packages/test-world/package.json
     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.'
   '@starci/cli':
-    version: 1.7.46
+    version: 1.7.47
     group: starci
     install: registry
     side: both
     source: packages/cli/package.json
     why: 'the only StarCi command package; product repositories install it for starci app, while @starci/hfs remains its pinned transitive implementation.'
   '@starci/hfs':
-    version: 4.7.46
+    version: 4.7.48
     group: starci
     install: registry
     side: both

package/runtime/scripts/lib/grammar-lint.mjs

@@ -4,33 +4,66 @@ import { parseYamlCached } from './yaml-cached.mjs';
 
 const CATALOG_FILE = new URL('../../knowledge/grammars/index.yaml', import.meta.url);
 
+function readCatalog() {
+  return parseYamlCached(fs.readFileSync(CATALOG_FILE, 'utf8'));
+}
+
+/** The catalog's one alias table: a deprecated id names exactly one canonical family and is never itself a family. */
+function aliasTarget(catalog, family) {
+  const aliases = catalog.familyAliases ?? {};
+  if (!Object.hasOwn(aliases, family)) return null;
+  const target = aliases[family];
+  if (typeof target !== 'string' || Object.hasOwn(aliases, target)
+    || (catalog.families ?? []).some(entry => entry.id === family)) {
+    throw new Error(`Grammar family alias ${family} in knowledge/grammars/index.yaml must name one canonical family`);
+  }
+  return target;
+}
+
 function selectedFamily(family) {
   if (typeof family !== 'string' || !family.trim()) throw new Error('sides.fe.grammar must explicitly name the selected Grammar family');
-  const catalog = parseYamlCached(fs.readFileSync(CATALOG_FILE, 'utf8'));
-  const matches = (catalog.families ?? []).filter(entry => entry.id === family);
+  const catalog = readCatalog();
+  const id = aliasTarget(catalog, family) ?? family;
+  const matches = (catalog.families ?? []).filter(entry => entry.id === id);
   if (matches.length !== 1) throw new Error(`Grammar family ${family} has no declared lint contract in knowledge/grammars/index.yaml`);
   return { catalog, selected: matches[0] };
 }
 
+/**
+ * Resolve a selection to its canonical family id through the catalog's alias table.
+ * @param {string} family - The id an app or caller names (sides.fe.grammar).
+ * @returns {{ id: string, alias: string | null, note: string | null }} The canonical id; for a deprecated alias, the alias and a note naming the canonical id.
+ */
+export function resolveGrammarFamily(family) {
+  const { selected } = selectedFamily(family);
+  if (selected.id === family) return Object.freeze({ id: family, alias: null, note: null });
+  return Object.freeze({
+    id: selected.id,
+    alias: family,
+    note: `Grammar family id ${family} is a deprecated alias of ${selected.id}; write sides.fe.grammar: ${selected.id}`,
+  });
+}
+
 /** The explicitly selected authored family entry; callers share the catalog lookup rather than inferring a family. */
 export function grammarFamilyFor(family) {
   return Object.freeze(selectedFamily(family).selected);
 }
 
-/** The declared family's lint contract, including an explicit null package when that family has no rules. */
+/** The declared family's lint contract (keyed by the canonical id), including an explicit null package when that family has no rules. */
 export function grammarLintFor(family) {
   const { selected } = selectedFamily(family);
   if (!selected.lint || !Object.hasOwn(selected.lint, 'package')) {
     throw new Error(`Grammar family ${family} has no declared lint contract in knowledge/grammars/index.yaml`);
   }
   const lint = selected.lint;
-  if (lint.package === null) return Object.freeze({ family, package: null });
+  const canonical = selected.id;
+  if (lint.package === null) return Object.freeze({ family: canonical, package: null });
   if (typeof lint.package !== 'string' || !lint.package.startsWith('@starci/eslint-grammar-')
     || typeof lint.factory !== 'string' || !/^[a-zA-Z][a-zA-Z0-9]*$/.test(lint.factory)
     || typeof lint.prefix !== 'string' || !/^[a-z][a-z0-9-]*$/.test(lint.prefix)) {
     throw new Error(`Grammar family ${family} has an invalid lint contract in knowledge/grammars/index.yaml`);
   }
-  return Object.freeze({ family, package: lint.package, factory: lint.factory, prefix: lint.prefix });
+  return Object.freeze({ family: canonical, package: lint.package, factory: lint.factory, prefix: lint.prefix });
 }
 
 /** The selected family's shared component/export contract, resolved through its catalog reference. */