@timekast/factory 1.7.0 → 1.7.1

package/dist/lib/constants.js

@@ -94,3 +94,49 @@ export const FACTORY_SCRIPTS = {
 export const PREFLIGHT_SCRIPT_NAME = 'preflight';
 export const PREFLIGHT_SCRIPT_CMD = 'tsx scripts/tools/preflight.ts';
 export const PREFLIGHT_SCRIPT_FILE = 'scripts/tools/preflight.ts';
+/**
+ * Kit-local reference generators — autogen of `project/reference/*` (INVENTORY,
+ * CODEBASE, HOOKS, SCHEMA, API). Each shells a `scripts/tools/generate-*.mjs`
+ * that ships with the FULL brain, so the installer ensures each alias ONLY when
+ * its backing file exists (file-gated, insert-if-missing — same contract as
+ * `preflight`). A derivative bootstrapped before a generator existed self-heals
+ * the alias on the next `update`/`beta` (the script file arrives via `scripts/**`
+ * in the tracked set, then the alias appears). Never overwrites a dev's own value.
+ */
+export const GENERATOR_SCRIPTS = [
+    {
+        name: 'generate:inventory',
+        cmd: 'node scripts/tools/generate-inventory.mjs',
+        file: 'scripts/tools/generate-inventory.mjs',
+    },
+    {
+        name: 'generate:codebase',
+        cmd: 'node scripts/tools/generate-codebase.mjs',
+        file: 'scripts/tools/generate-codebase.mjs',
+    },
+    {
+        name: 'generate:hooks',
+        cmd: 'node scripts/tools/generate-hooks.mjs',
+        file: 'scripts/tools/generate-hooks.mjs',
+    },
+    {
+        name: 'generate:schema',
+        cmd: 'node scripts/tools/generate-schema.mjs',
+        file: 'scripts/tools/generate-schema.mjs',
+    },
+    {
+        name: 'generate:api',
+        cmd: 'node scripts/tools/generate-api.mjs',
+        file: 'scripts/tools/generate-api.mjs',
+    },
+];
+/**
+ * Aggregate that runs every shipped reference generator in one shot (the
+ * one-command "regenerate everything" alias). Shells the files directly (not
+ * `pnpm generate:*`) so it works even if the individual aliases were not added.
+ * Gated on the schema generator's presence — a proxy for "the current full
+ * generator set shipped" (they ship together in the FULL brain).
+ */
+export const GENERATE_REFERENCE_NAME = 'generate:reference';
+export const GENERATE_REFERENCE_CMD = 'node scripts/tools/generate-inventory.mjs && node scripts/tools/generate-codebase.mjs && node scripts/tools/generate-hooks.mjs && node scripts/tools/generate-schema.mjs && node scripts/tools/generate-api.mjs';
+export const GENERATE_REFERENCE_GATE_FILE = 'scripts/tools/generate-schema.mjs';

package/dist/lib/package-json.js

@@ -8,7 +8,7 @@
 import { existsSync, readFileSync, writeFileSync } from 'node:fs';
 import path from 'node:path';
 import { CLIError } from './cli-error.js';
-import { FACTORY_SCRIPTS, PREFLIGHT_SCRIPT_CMD, PREFLIGHT_SCRIPT_FILE, PREFLIGHT_SCRIPT_NAME, PROFILES, UPDATE_SCRIPT_NAME, } from './constants.js';
+import { FACTORY_SCRIPTS, GENERATE_REFERENCE_CMD, GENERATE_REFERENCE_GATE_FILE, GENERATE_REFERENCE_NAME, GENERATOR_SCRIPTS, PREFLIGHT_SCRIPT_CMD, PREFLIGHT_SCRIPT_FILE, PREFLIGHT_SCRIPT_NAME, PROFILES, UPDATE_SCRIPT_NAME, } from './constants.js';
 /**
  * Auto-detect the profile to install into an existing repo from its
  * `package.json`: a `factoryVersion` field means the repo was born from the
@@ -91,15 +91,33 @@ function ensureFactoryScripts(pkg, extraScripts = {}) {
     return { changed, primary };
 }
 /**
- * The kit-local scripts to ensure for THIS repo: `preflight` only when its
- * backing file ships here (full brain). File-gated so a core/non-Factory repo
- * never gets an entry that shells a file it does not have — and it self-heals:
- * the entry appears on the first install/update after the file lands.
+ * The kit-local scripts to ensure for THIS repo, each file-gated so a
+ * core/non-Factory repo never gets an entry that shells a file it lacks — and
+ * each self-heals: the entry appears on the first install/update after its
+ * backing file lands.
+ *
+ * - `preflight` — when its sweep script ships (full brain).
+ * - `generate:*` — one alias per reference generator whose `scripts/tools/
+ *   generate-*.mjs` ships (full brain). These arrive via the `scripts/**`
+ *   tracked set on `update`/`beta`, so an existing derivative self-heals the
+ *   aliases without the dev hand-editing `package.json`.
+ * - `generate:reference` — the aggregate that runs the whole set in one command.
+ *
+ * Insert-if-missing for all: a dev's own value for any of these is never
+ * overwritten (see `ensureFactoryScripts`).
  */
 export function kitLocalScripts(rootDir) {
-    return existsSync(path.join(rootDir, PREFLIGHT_SCRIPT_FILE))
-        ? { [PREFLIGHT_SCRIPT_NAME]: PREFLIGHT_SCRIPT_CMD }
-        : {};
+    const has = (relPath) => existsSync(path.join(rootDir, relPath));
+    const scripts = {};
+    if (has(PREFLIGHT_SCRIPT_FILE))
+        scripts[PREFLIGHT_SCRIPT_NAME] = PREFLIGHT_SCRIPT_CMD;
+    for (const gen of GENERATOR_SCRIPTS) {
+        if (has(gen.file))
+            scripts[gen.name] = gen.cmd;
+    }
+    if (has(GENERATE_REFERENCE_GATE_FILE))
+        scripts[GENERATE_REFERENCE_NAME] = GENERATE_REFERENCE_CMD;
+    return scripts;
 }
 /**
  * Source dirs that never ship to a derivative — excluded from BOTH dist profiles

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@timekast/factory",
-  "version": "1.7.0",
+  "version": "1.7.1",
   "description": "Public, thin CLI to bootstrap and maintain TimeKast Factory derived projects.",
   "type": "module",
   "license": "UNLICENSED",