@starci/hfs 4.2.17 → 4.4.0

package/scaffold/app.mjs

@@ -23,10 +23,13 @@ import { SUPABASE_PORT_VARIABLES, supabasePortVars } from './supabase-ports.mjs'
 import { FE_APP_SCRIPTS, PACKAGE_MANAGER, WORKSPACES, WORKSPACE_LINT, feAppPackageName } from '../runtime/scripts/hfs/rules/monorepo.mjs';
 import { isLinkLike } from '../runtime/scripts/api/fs/is-link-like.mjs';
 import { unlinkOnly } from '../runtime/scripts/api/fs/lib.mjs';
+import { initializeAppIdentity } from '../runtime/scripts/hfs/secret-init.mjs';
+import { declaredSealedMembers, materializeDeclaredPlaceholders } from '../runtime/scripts/hfs/sealed-members.mjs';
 import { revParseQuery } from '../runtime/scripts/api/git/rev-parse-query.mjs';
 import { lsFiles } from '../runtime/scripts/api/git/ls-files.mjs';
 import { insidePath, samePath } from '../runtime/scripts/lib/path-key.mjs';
 import { byCodeUnit } from '../report/order.mjs';
+import { sonarGateName } from '../sync/sonar-key.mjs';
 
 const NAME = /^[a-z][a-z0-9-]*$/;
 const APP_DIR = '__app__';
@@ -96,12 +99,14 @@ export function jsonText(value) {
     const inner = `${indent}  `;
     if (Array.isArray(item)) {
       if (item.every(entry => entry === null || typeof entry !== 'object')) return `[${item.map(entry => JSON.stringify(entry)).join(', ')}]`;
-      return `[\n${item.map(entry => `${inner}${print(entry, inner)}`).join(',\n')}\n${indent}]`;
+      const entries = item.map(entry => `${inner}${print(entry, inner)}`).join(',\n');
+      return `[\n${entries}\n${indent}]`;
     }
     if (item !== null && typeof item === 'object') {
       const keys = Object.keys(item);
       if (!keys.length) return '{}';
-      return `{\n${keys.map(key => `${inner}${JSON.stringify(key)}: ${print(item[key], inner)}`).join(',\n')}\n${indent}}`;
+      const entries = keys.map(key => `${inner}${JSON.stringify(key)}: ${print(item[key], inner)}`).join(',\n');
+      return `{\n${entries}\n${indent}}`;
     }
     return JSON.stringify(item);
   };
@@ -161,7 +166,7 @@ const STARTER_DEPENDENCIES = Object.freeze({
 });
 
 /**
- * Lite keeps the production stack, the canon tools and the back end's unit run (owner ruling 2026-10-12); it runs no test world of
+ * Lite keeps the production stack, the canon tools and the back end's unit run (ruling:R212/case-1, amended by ruling:R212/case-4); it runs no test world of
  * its own (no @starci/test-world). Both editions serve GraphQL from the api app (@nestjs/graphql over Apollo, owner ruling
  * 2026-10-13); the fe stack's root tools are added from fe-stack.yaml by packageManifest.
  */
@@ -198,7 +203,7 @@ const FE_APP_DEPENDENCIES = Object.freeze({
  * the front end is the Auth client of modules/auth only) and server-only for its own next-intl request config.
  */
 const LITE_FE_APP_DEPENDENCIES = Object.freeze({
-  '@heroui/react': null, '@heroui/styles': null, '@starci/grammar': null, '@xyflow/react': null,
+  '@heroicons/react': null, '@heroui/react': null, '@heroui/styles': null, '@starci/grammar': null, '@starci/heroicons': null, '@xyflow/react': null,
   '@supabase/supabase-js': null, next: null, 'next-intl': null, react: null, 'react-dom': null, 'server-only': null,
 });
 
@@ -209,7 +214,7 @@ const LITE_FE_APP_DEPENDENCIES = Object.freeze({
  * ./routing, client-safe: the default locale a client boundary reads).
  */
 const FE_PACKAGES = Object.freeze({
-  ui: { exports: ['.'], dependencies: { '@heroui/react': null, '@starci/grammar': null, '@xyflow/react': null, 'next-intl': null, react: null } },
+  ui: { exports: ['.'], dependencies: { '@heroui/react': null, '@starci/grammar': null, '@starci/heroicons': null, '@xyflow/react': null, 'next-intl': null, react: null } },
   i18n: { exports: ['.', './proxy', './routing'], dependencies: { next: null, 'next-intl': null, 'server-only': null } },
 });
 
@@ -226,6 +231,47 @@ const starterDeclaration = (name, manifest = loadSlotManifest(), edition = 'full
   sides: structuredClone(edition === 'lite' ? LITE_STARTER_SIDES : STARTER_SIDES),
 });
 
+/** Opting into a server PKCE callback also selects Supabase Auth and declares its route slot. */
+function enableAuthCallback(declaration) {
+  requireAuthCallbackConnection(declaration);
+  declaration.sides.fe.optionalSlots = [...(declaration.sides.fe.optionalSlots ?? []), 'fe.route.callback'];
+  declaration.supabase ??= structuredClone(LITE_STARTER_SUPABASE);
+  declaration.supabase.redirectUrls = ['http://127.0.0.1:3000/auth/callback'];
+}
+
+/** Callback-specific source files are excluded from the browser-only starter. */
+const CALLBACK_SOURCE_FILES = Object.freeze(new Set([
+  'src/app/auth/callback/route.ts', 'src/modules/auth/server.ts', 'src/modules/auth/pkce-client.ts',
+]));
+export const hasAuthCallback = repo => (repo.sides.fe.optionalSlots ?? []).includes('fe.route.callback');
+
+function requireAuthCallbackConnection(repo) {
+  if (!(repo.sides.be?.connections ?? []).some(entry => entry.provider === 'supabase'))
+    throw new ScaffoldError('HFS_ADD_CONNECTION_REQUIRED', 'the auth callback requires an existing Supabase connection; the full starter has none');
+}
+
+/** Apply the callback's cookie-backed auth owner and its config readers to product apps only. */
+export function callbackSourceFiles(files, repo) {
+  const enabled = hasAuthCallback(repo);
+  if (enabled) requireAuthCallbackConnection(repo);
+  const selected = files.filter(file => {
+    const [, , app, ...parts] = file.path.split('/');
+    const relative = parts.join('/');
+    if (relative === 'src/modules/auth/pkce-client.ts') return false;
+    return MARKETING_FE_APPS.has(app) || enabled || !CALLBACK_SOURCE_FILES.has(relative);
+  });
+  if (!enabled) return selected;
+  const config = fs.readFileSync(path.join(TEMPLATES_DIR, 'fe/skeleton-lite/apps/web/src/modules/config/index.ts'), 'utf8');
+  const client = render(fs.readFileSync(path.join(TEMPLATES_DIR, 'fe/skeleton/apps/__app__/src/modules/auth/pkce-client.ts'), 'utf8').replace(/\r\n/g, '\n'), PARTIAL_VARIABLES);
+  return selected.map(file => {
+    const [, , app, ...parts] = file.path.split('/');
+    if (MARKETING_FE_APPS.has(app)) return file;
+    const relative = parts.join('/');
+    if (relative === 'src/modules/config/index.ts') return { ...file, content: config };
+    return relative === 'src/modules/auth/client.ts' ? { ...file, content: client } : file;
+  });
+}
+
 /** A dependency section at the canon pins (a null range takes the pin, which must exist; every pinned name is null). */
 function pinnedSection(entries, pins) {
   const pinned = (dependency, range) => {
@@ -278,9 +324,10 @@ const workspaceSection = (entries, project, pins) => pinnedSection(Object.fromEn
  * The package.json of the fe app workspace `app` of the app `project`: @<project>/<app>, private, the workspace scripts, its own
  * dependencies. A product app (`core`, it carries the shared app core) also takes every core runtime package of the fe stack.
  */
-function feAppManifest(project, app, pins, edition, { core = true, stack = coreFeStackPackages() } = {}) {
+function feAppManifest(project, app, pins, edition, { core = true, authCallback = false, stack = coreFeStackPackages() } = {}) {
   const base = edition === 'lite' ? LITE_FE_APP_DEPENDENCIES : FE_APP_DEPENDENCIES;
   const dependencies = { ...base, ...(core ? Object.fromEntries(stack.app.filter(name => !Object.hasOwn(base, name)).map(name => [name, null])) : {}) };
+  if (core && authCallback) Object.assign(dependencies, { '@supabase/ssr': null, '@supabase/supabase-js': null, 'server-only': null });
   return { name: feAppPackageName(project, app), version: '0.0.0', private: true, scripts: { ...FE_APP_SCRIPTS }, dependencies: workspaceSection(dependencies, project, pins) };
 }
 
@@ -329,15 +376,15 @@ function nextAppTsconfig() {
   };
 }
 
-/** The names a skeleton file may fill: {{project}}, {{app}}, {{appPascal}} (the side's app), {{sonarGate}} and the lite Supabase port block ({{supabasePort<Section>}}, supabase-ports.mjs). */
-const SKELETON_VARIABLES = Object.freeze(['project', 'app', 'appPascal', 'sonarGate', ...SUPABASE_PORT_VARIABLES]);
+/** The names a skeleton file may fill: {{project}}, {{app}}, {{appPascal}} (the side's app), {{sonarGate}}, {{registryVisibility}} (the image visibility written once into deploy.registry) and the lite Supabase port block ({{supabasePort<Section>}}, supabase-ports.mjs). */
+const SKELETON_VARIABLES = Object.freeze(['project', 'app', 'appPascal', 'sonarGate', 'registryVisibility', ...SUPABASE_PORT_VARIABLES]);
 
 /**
  * A skeleton file with its variables filled. Only the skeleton names are variables: every other `{{name}}` is source the app keeps
  * (a message placeholder of the i18n canon, `{{title}}` in a catalog), and a skeleton name with no value for this file is an error.
  */
 function fill(source, vars, file) {
-  return source.replace(new RegExp(`\\{\\{(${SKELETON_VARIABLES.join('|')})\\}\\}`, 'g'), (_, key) => {
+  return source.replace(new RegExp(String.raw`\{\{(${SKELETON_VARIABLES.join('|')})\}\}`, 'g'), (_, key) => {
     if (!Object.hasOwn(vars, key)) throw new ScaffoldError('HFS_SCAFFOLD_TEMPLATE_VARIABLE', `${file} names {{${key}}}, which has no value outside a __app__ folder`);
     return vars[key];
   });
@@ -353,8 +400,7 @@ export const PARTIAL_VARIABLES = new Proxy(Object.create(null), {
 const CLI_APP_DIR = 'apps/cli/';
 const declaresCliApp = app => app.sides.be.apps.some(entry => entry.kind === 'cli' && entry.name === 'cli');
 
-const LITE_APP_REUSED = new Set(['.editorconfig', '.gitattributes', '.nvmrc', '.starciwork/workspace.yaml',
-  '.starciwork/index.yaml', '.starciwork/features/system-health/index.yaml']);
+const LITE_APP_REUSED = new Set(['.editorconfig', '.gitattributes', '.nvmrc']);
 const LITE_DEFERRED_GENERATOR_FILES = new Set([
   'src/modules/platform/database/database.sql.ts',
   'src/modules/platform/database/migration-runner.service.ts',
@@ -376,7 +422,7 @@ const liteOverlaid = (() => {
 })();
 /**
  * A base be file lite reuses: a source file of the shared shape, and the unit spec beside a reused source file that the lite overlay
- * does not replace (owner ruling 2026-10-12: a lite back end keeps full's unit specs).
+ * does not replace (ruling:R212/case-1, amended by ruling:R212/case-4: a lite back end keeps full's unit specs).
  */
 const liteBaseFile = (scope, rel) => {
   if (scope === 'app') return LITE_APP_REUSED.has(rel);
@@ -388,35 +434,58 @@ const liteBaseFile = (scope, rel) => {
 };
 const liteOverlayFile = (scope, rel) => scope !== 'be' || !LITE_DEFERRED_GENERATOR_FILES.has(rel);
 
+function skeletonOutputPath(relative, { scope, app, vars }) {
+  const prefix = scope === 'app' ? '' : `${scope}/`;
+  const output = relative.split(PROJECT_DIR).join(app.project).split(TIMESTAMP).join(vars.timestamp);
+  return `${prefix}${output}`;
+}
+
+function fixedSkeletonFiles(context, relative, source) {
+  const { scope, directory, app, vars, apps } = context;
+  if (scope === 'be' && relative === 'src/tests/fixtures/builders/cli.builder.ts' && !declaresCliApp(app)) return [];
+  if (scope === 'be' && relative.startsWith(CLI_APP_DIR) && !declaresCliApp(app)) return [];
+  const fixedApp = apps.find(entry => relative.startsWith(`apps/${entry.name}/`));
+  if (scope === 'fe' && relative.startsWith('apps/') && !fixedApp) return [];
+  const appVars = fixedApp ? { app: fixedApp.name, appPascal: pascal(fixedApp.name) } : {};
+  return [{
+    path: skeletonOutputPath(relative, context),
+    content: fill(source, { project: app.project, ...vars, ...appVars }, `${directory}/${relative}`),
+  }];
+}
+
+function variableSkeletonFiles(context, relative, source) {
+  const { scope, directory, app, vars, apps } = context;
+  const leaves = `apps/${APP_DIR}/src/components/leaves/`;
+  if (scope === 'fe' && app.edition === 'full' && relative.startsWith(leaves)) {
+    return fixedSkeletonFiles(context, relative.replace(leaves, `packages/${PROJECT_DIR}-ui/src/leaves/`), source);
+  }
+  const selectedApps = scope === 'fe' ? coreFeApps(apps) : apps;
+  return selectedApps.map(entry => ({
+    path: skeletonOutputPath(relative.split(APP_DIR).join(entry.name), context),
+    content: fill(source, { project: app.project, ...vars, app: entry.name, appPascal: pascal(entry.name) }, `${directory}/${relative}`),
+  }));
+}
+
 /** One skeleton directory rendered to app-relative files; `include` filters source-relative paths before variables are expanded. */
 function skeletonDirectory(scope, directory, app, vars, include = () => true) {
   const dir = path.join(TEMPLATES_DIR, scope, directory);
   if (!fs.existsSync(dir)) throw new ScaffoldError('HFS_SCAFFOLD_SKELETON_MISSING', `no skeleton templates in templates/${scope}/${directory}`);
   const apps = scope === 'app' ? [] : app.sides[scope].apps.filter(entry => scope === 'fe' || entry.kind === 'api');
-  const appsOf = rel => (scope === 'fe' && rel.includes(APP_DIR) ? coreFeApps(apps) : apps);
-  const prefix = scope === 'app' ? '' : `${scope}/`;
+  const context = { scope, directory, app, vars, apps };
   const files = [];
-  for (const rel of listFiles(dir).filter(include)) {
-    const source = render(fs.readFileSync(path.join(dir, rel), 'utf8').replace(/\r\n/g, '\n'), PARTIAL_VARIABLES);
-    const once = { project: app.project, ...vars };
-    const output = candidate => candidate.split(PROJECT_DIR).join(app.project).split(TIMESTAMP).join(vars.timestamp);
-    if (!rel.includes(APP_DIR)) {
-      if (scope === 'be' && rel.startsWith(CLI_APP_DIR) && !declaresCliApp(app)) continue;
-      const fixedApp = apps.find(entry => rel.startsWith(`apps/${entry.name}/`));
-      if (scope === 'fe' && rel.startsWith('apps/') && !fixedApp) continue;
-      const appVars = fixedApp ? { app: fixedApp.name, appPascal: pascal(fixedApp.name) } : {};
-      files.push({ path: `${prefix}${output(rel)}`, content: fill(source, { ...once, ...appVars }, `${directory}/${rel}`) });
-      continue;
-    }
-    for (const entry of appsOf(rel)) files.push({ path: `${prefix}${output(rel.split(APP_DIR).join(entry.name))}`, content: fill(source, { ...once, app: entry.name, appPascal: pascal(entry.name) }, `${directory}/${rel}`) });
+  for (const rel of listFiles(dir).filter(relative => include(relative))) {
+    let source = render(fs.readFileSync(path.join(dir, rel), 'utf8').replace(/\r\n/g, '\n'), PARTIAL_VARIABLES);
+    if (scope === 'fe' && app.edition === 'full') source = source.replaceAll('"@/components/leaves/Icon"', `"@${app.project}/ui"`);
+    const rendered = rel.includes(APP_DIR) ? variableSkeletonFiles(context, rel, source) : fixedSkeletonFiles(context, rel, source);
+    files.push(...rendered);
   }
   return files;
 }
 
-/** The canonical product catalog and feature nodes shared by scaffold and upgrades of older lite apps. */
+/** The canonical full Work workspace, catalog and feature nodes an edition upgrade may need. */
 export function scaffoldWorkSeeds(project) {
   return skeletonDirectory('app', 'skeleton', { project }, {},
-    rel => rel === '.starciwork/index.yaml' || rel.startsWith('.starciwork/features/'));
+    rel => rel === '.starciwork/workspace.yaml' || rel === '.starciwork/index.yaml' || rel.startsWith('.starciwork/features/'));
 }
 
 /**
@@ -433,7 +502,7 @@ function skeletonOf(scope, app, vars) {
   for (const entry of scope === 'fe' ? app.sides.fe.apps : []) {
     if (!unique.some(file => file.path.startsWith(`fe/apps/${entry.name}/`))) throw new ScaffoldError('HFS_SCAFFOLD_SKELETON_MISSING', `no skeleton templates for the fe app ${entry.name}`);
   }
-  return unique;
+  return scope === 'fe' ? [...new Map(callbackSourceFiles(unique, app).map(file => [file.path, file])).values()] : unique;
 }
 
 /** The npm step that resolves the lockfile of a new app, exactly as the error names it. */
@@ -546,17 +615,40 @@ function scaffoldWrites(root, original) {
   };
 }
 
+/** Generate the lite database types and translate generation errors into the scaffold failure contract. */
+function emitScaffoldDatabaseTypes(root, name, writes, emitTypes) {
+  try {
+    const text = emitTypes({ root });
+    if (typeof text !== 'string' || !text.trim()) throw new Error('the Supabase CLI returned no database types');
+    writes.write(dbTypesPath, text);
+  } catch (error) {
+    throw new ScaffoldError('HFS_SCAFFOLD_TYPES_FAILED', `Supabase database types could not be generated for ${root} (${String(error?.message ?? error)}). Start the local Supabase stack and run starci app scaffold ${name} --edition lite again`);
+  }
+}
+
 /**
  * `starci app scaffold <name>`: writes the new app under `into`, resolves its lockfile with npm (`lock`, npmLock), and returns
  * `{ root, files }` (app-relative paths, sorted). `presets` is what sync loads from the installed @starci/jest-preset (the Sonar
  * exclusions); the CLI passes the one it resolves. Failure removes only scaffold-owned entries, retaining an existing .git.
  */
-export function scaffoldApp({ name, into, presets, edition = 'full', manifest = loadSlotManifest(), pins = bundledPins(), lock = npmLock, emitTypes = generateDbTypes, now = () => new Date() }) {
+/** Seal declared starter members to a fresh app recipient through the scaffold rollback owner. */
+function initializeScaffoldSecrets(root, writes) {
+  if (!declaredSealedMembers(root).length) return [];
+  const write = (file, content) => writes.write(path.relative(root, file), content);
+  const initialized = initializeAppIdentity(root, { write });
+  const materialized = materializeDeclaredPlaceholders(root, { recipient: initialized.recipient, write });
+  return [...initialized.files, ...materialized.members];
+}
+
+export function scaffoldApp({ name, into, presets, edition = 'full', authCallback = false, registryVisibility = 'public', manifest = loadSlotManifest(), pins = bundledPins(), lock = npmLock, emitTypes = generateDbTypes, now = () => new Date() }) {
   if (!NAME.test(String(name))) throw new ScaffoldError('HFS_SCAFFOLD_NAME_INVALID', `the app name ${name} must be kebab-case (a project name: ${NAME})`);
   const root = path.resolve(into, name);
   const original = fs.lstatSync(root, { throwIfNoEntry: false });
   if (original && !emptyUnbornGit(root, original)) throw new ScaffoldError('HFS_SCAFFOLD_EXISTS', `${root} already exists; only a plain directory containing solely .git with unborn main and an empty index can be scaffolded`);
+  if (!['public', 'private'].includes(registryVisibility)) throw new ScaffoldError('HFS_SCAFFOLD_REGISTRY_VISIBILITY', `--registry-visibility accepts public or private (got ${registryVisibility})`);
+  if (typeof authCallback !== 'boolean') throw new ScaffoldError('HFS_SCAFFOLD_NAME_INVALID', 'authCallback must be a boolean');
   const declaration = starterDeclaration(name, manifest, edition);
+  if (authCallback) enableAuthCallback(declaration);
   const app = resolveRepoDeclaration(manifest, declaration);
   const pkg = packageManifest(name, pins, app.edition);
   const timestamp = now().toISOString().replace(/\D/g, '').slice(0, 14);
@@ -569,14 +661,14 @@ export function scaffoldApp({ name, into, presets, edition = 'full', manifest =
       path: `fe/apps/${entry.name}/src/modules/types/ambient/styles.d.ts`,
       content: '/** Declares stylesheets loaded by the Next bundler; non-CSS side-effect imports remain checked. */\ndeclare module "*.css" {}\n',
     })),
-    ...app.sides.fe.apps.map(entry => ({ path: `fe/apps/${entry.name}/package.json`, content: packageJsonText(feAppManifest(name, entry.name, pins, app.edition, { core: coreFeApps([entry]).length === 1 })) })),
+    ...app.sides.fe.apps.map(entry => ({ path: `fe/apps/${entry.name}/package.json`, content: packageJsonText(feAppManifest(name, entry.name, pins, app.edition, { core: coreFeApps([entry]).length === 1, authCallback })) })),
     ...imageFiles(app),
     ...(app.edition === 'lite' ? [] : Object.keys(FE_PACKAGES).flatMap(pkg => [
       { path: `fe/packages/${name}-${pkg}/package.json`, content: packageJsonText(fePackageManifest(name, pkg, pins)) },
       { path: `fe/packages/${name}-${pkg}/tsconfig.json`, content: jsonText(fePackageTsconfig()) },
       { path: `fe/packages/${name}-${pkg}/tsconfig.build.json`, content: jsonText(fePackageBuildTsconfig()) },
     ])),
-    ...['app', 'be', 'fe'].flatMap(scope => skeletonOf(scope, app, { sonarGate: parseYaml(fs.readFileSync(SONAR_GATE_FILE, 'utf8')).gate.name, timestamp, ...supabasePortVars(name) })),
+    ...['app', 'be', 'fe'].flatMap(scope => skeletonOf(scope, app, { sonarGate: sonarGateName(parseYaml(fs.readFileSync(SONAR_GATE_FILE, 'utf8')), app.edition), timestamp, registryVisibility, ...supabasePortVars(name) })),
   ];
   const writes = scaffoldWrites(root, original);
   try {
@@ -584,19 +676,12 @@ export function scaffoldApp({ name, into, presets, edition = 'full', manifest =
     const targets = renderTargets(declaration, presets, { manifest, source: appSource(root) });
     for (const target of targets) writes.claim(target.path);
     writeTargets(root, targets);
-    if (app.edition === 'lite') {
-      try {
-        const text = emitTypes({ root });
-        if (typeof text !== 'string' || !text.trim()) throw new Error('the Supabase CLI returned no database types');
-        writes.write(dbTypesPath, text);
-      } catch (error) {
-        throw new ScaffoldError('HFS_SCAFFOLD_TYPES_FAILED', `Supabase database types could not be generated for ${root} (${String(error?.message ?? error)}). Start the local Supabase stack and run starci app scaffold ${name} --edition lite again`);
-      }
-    }
+    if (app.edition === 'lite') emitScaffoldDatabaseTypes(root, name, writes, emitTypes);
+    const secretFiles = initializeScaffoldSecrets(root, writes);
     let locked;
     try { locked = lock(root); } finally { writes.lockfile(); }
     if (!locked.ok) throw new ScaffoldError('HFS_SCAFFOLD_LOCK_FAILED', `\`${LOCK_STEP}\` could not resolve the lockfile of ${root} (${locked.detail}). Check the network and the npm registry, then run starci app scaffold ${name} again`);
-    return { root, files: [...new Set([...files.map(file => file.path), ...targets.map(target => target.path), ...(app.edition === 'lite' ? [dbTypesPath] : []), 'package-lock.json'])].sort(byCodeUnit) };
+    return { root, files: [...new Set([...files.map(file => file.path), ...targets.map(target => target.path), ...secretFiles, ...(app.edition === 'lite' ? [dbTypesPath] : []), 'package-lock.json'])].sort(byCodeUnit) };
   } catch (error) {
     const held = writes.rollback();
     if (held.length) error.message += `; cleanup retained replaced or occupied entries: ${held.join(', ')}`;

package/scaffold/edition-gate.mjs

@@ -14,9 +14,9 @@ export class EditionRefusal extends Error {
 }
 
 /**
- * The refusal of a pattern noun in a lite app whose topic carries a `liteAdapter` (owner ruling 2026-10-12): lite HAS the pattern,
- * but the package's templates are the full adapter (BullMQ, Kafka, sockets, TypeORM entities, e2e proofs), so generating them would
- * write what lite forbids. The pattern is written by hand on its Supabase adapter until the package carries a lite template.
+ * The refusal of a pattern noun in a lite app whose topic carries a `liteAdapter` (ruling:R212/case-1, amended by ruling:R212/case-4):
+ * lite has the pattern, but the package carries only its full-adapter templates, so generating them would write adapter paths
+ * unavailable in lite. The pattern is written by hand using the topic's declared lite adapter until the package carries a lite template.
  */
 export class LiteAdapterRefusal extends EditionRefusal {
   constructor(command, topics) {

package/scaffold/image.mjs

@@ -2,11 +2,11 @@
 // (templates/<side>/image/<kind>, the same render starci app scaffold uses). It never overwrites a file.
 import fs from 'node:fs';
 import path from 'node:path';
-import { imageFiles, loadHfs, validateHfs } from '../sync/index.mjs';
+import { appSource, imageFiles, loadHfs, validateHfs } from '../sync/index.mjs';
 
 /** Writes the missing Dockerfiles of the app at `repoRoot` (the folder of hfs.json); the app-relative paths written. */
 export function newImages({ repoRoot }) {
-  const files = imageFiles(validateHfs(loadHfs(repoRoot)));
+  const files = imageFiles(validateHfs(loadHfs(repoRoot)), appSource(repoRoot));
   const written = [];
   for (const file of files) {
     const target = path.join(repoRoot, ...file.path.split('/'));

package/scaffold/lite-exports.mjs

@@ -32,7 +32,8 @@ const REGISTRATIONS = Object.freeze({
     {
       file: "be/src/modules/platform/database/index.ts",
       source: "./primary.decorators",
-      names: ["InjectPrimaryEntityManager"],
+      // PRIMARY_ENTITY_MANAGER: the token a generated table service's unit spec provides its EntityManager double under.
+      names: ["InjectPrimaryEntityManager", "PRIMARY_ENTITY_MANAGER"],
     },
   ],
   webhook: [

package/scaffold/service.mjs

@@ -319,7 +319,7 @@ const writeNew = (repoRoot, relative, text) => {
 
 /** `starci app new spec be/<file>.service.ts` at the app root: writes the spec skeleton of an existing service; returns the created app-relative paths. */
 export function newSpec({ repoRoot: appRoot, file, ts, manifest = loadSlotManifest() }) {
-  // A unit spec belongs to both editions (owner ruling 2026-10-12): a lite back end keeps full's unit specs.
+  // A unit spec belongs to both editions (ruling:R212/case-1, amended by ruling:R212/case-4): a lite back end keeps full's unit specs.
   const { beRoot: repoRoot } = backEndOf(appRoot, manifest);
   const relative = belowBackEnd(file);
   if (!relative.endsWith('.service.ts')) throw new ScaffoldError('HFS_NEW_NOT_A_SERVICE', `${relative} is not a *.service.ts file: only services have a unit spec`);
@@ -333,7 +333,7 @@ export function newSpec({ repoRoot: appRoot, file, ts, manifest = loadSlotManife
 
 /** `starci app new service be/<dir> <name> [--inject ...]` at the app root: writes the service and its spec skeleton; returns the created app-relative paths. */
 export function newService({ repoRoot: appRoot, dir, name, inject = [], ts, manifest = loadSlotManifest() }) {
-  // The service and its unit spec belong to both editions (owner ruling 2026-10-12).
+  // The service and its unit spec belong to both editions (ruling:R212/case-1, amended by ruling:R212/case-4).
   const { beRoot: repoRoot } = backEndOf(appRoot, manifest);
   if (!SERVICE_NAME.test(name)) throw new ScaffoldError('HFS_NEW_NAME_INVALID', `the service name ${name} must be kebab-case (member-profile), without the .service suffix`);
   const relative = path.posix.join(belowBackEnd(dir), `${name}.service.ts`);