@timekast/factory 1.17.5 → 1.18.0

package/dist/lib/constants.js

@@ -123,38 +123,39 @@ export const INVITE_ADMIN_SCRIPT_CMD = 'npx @timekast/factory invite-admin';
 export const INVITE_ADMIN_SCRIPT_FILE = 'scripts/tools/invite-admin.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.
+ * CODEBASE, HOOKS, SCHEMA, API). Each shells a `scripts/tools/generate-*.ts`
+ * (run via `tsx`, same as the other TS tools) 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',
+        cmd: 'tsx scripts/tools/generate-inventory.ts',
+        file: 'scripts/tools/generate-inventory.ts',
     },
     {
         name: 'generate:codebase',
-        cmd: 'node scripts/tools/generate-codebase.mjs',
-        file: 'scripts/tools/generate-codebase.mjs',
+        cmd: 'tsx scripts/tools/generate-codebase.ts',
+        file: 'scripts/tools/generate-codebase.ts',
     },
     {
         name: 'generate:hooks',
-        cmd: 'node scripts/tools/generate-hooks.mjs',
-        file: 'scripts/tools/generate-hooks.mjs',
+        cmd: 'tsx scripts/tools/generate-hooks.ts',
+        file: 'scripts/tools/generate-hooks.ts',
     },
     {
         name: 'generate:schema',
-        cmd: 'node scripts/tools/generate-schema.mjs',
-        file: 'scripts/tools/generate-schema.mjs',
+        cmd: 'tsx scripts/tools/generate-schema.ts',
+        file: 'scripts/tools/generate-schema.ts',
     },
     {
         name: 'generate:api',
-        cmd: 'node scripts/tools/generate-api.mjs',
-        file: 'scripts/tools/generate-api.mjs',
+        cmd: 'tsx scripts/tools/generate-api.ts',
+        file: 'scripts/tools/generate-api.ts',
     },
 ];
 /**
@@ -165,5 +166,21 @@ export const GENERATOR_SCRIPTS = [
  * 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';
+export const GENERATE_REFERENCE_CMD = 'tsx scripts/tools/generate-inventory.ts && tsx scripts/tools/generate-codebase.ts && tsx scripts/tools/generate-hooks.ts && tsx scripts/tools/generate-schema.ts && tsx scripts/tools/generate-api.ts';
+export const GENERATE_REFERENCE_GATE_FILE = 'scripts/tools/generate-schema.ts';
+/**
+ * Update-time healing registry: for each kit-owned script, the prior command(s)
+ * the kit used to ship. When the kit changes HOW a script is invoked (e.g. the
+ * `node`/`.mjs` → `tsx`/`.ts` migration of the reference generators), an existing
+ * derivative carries the OLD command in its `package.json`; `factory update`
+ * overwrites that stale kit-owned alias with the current command — but NEVER a
+ * value the dev diverged on their own (see `ensureFactoryScripts`). Add an entry
+ * whenever a kit-owned script's invocation changes, so existing derivatives
+ * self-heal on their next update instead of pointing at a deleted file.
+ */
+export const OBSOLETE_SCRIPT_CMDS = {
+    ...Object.fromEntries(GENERATOR_SCRIPTS.map((g) => [g.name, [`node ${g.file.replace(/\.ts$/, '.mjs')}`]])),
+    [GENERATE_REFERENCE_NAME]: [
+        GENERATOR_SCRIPTS.map((g) => `node ${g.file.replace(/\.ts$/, '.mjs')}`).join(' && '),
+    ],
+};

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, GENERATE_REFERENCE_CMD, GENERATE_REFERENCE_GATE_FILE, GENERATE_REFERENCE_NAME, GENERATOR_SCRIPTS, INVITE_ADMIN_SCRIPT_CMD, INVITE_ADMIN_SCRIPT_FILE, INVITE_ADMIN_SCRIPT_NAME, 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, INVITE_ADMIN_SCRIPT_CMD, INVITE_ADMIN_SCRIPT_FILE, INVITE_ADMIN_SCRIPT_NAME, OBSOLETE_SCRIPT_CMDS, 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
@@ -82,6 +82,14 @@ function ensureFactoryScripts(pkg, extraScripts = {}) {
         else if (existing === cmd) {
             result = { action: 'already-correct' };
         }
+        else if ((OBSOLETE_SCRIPT_CMDS[name] ?? []).includes(existing)) {
+            // The value is a KNOWN-OBSOLETE kit command (e.g. the old `node …mjs` that
+            // the .ts migration retired) — heal it to the current command. A genuinely
+            // dev-divergent value falls through to `conflict` and is left intact.
+            scripts[name] = cmd;
+            changed = true;
+            result = { action: 'healed' };
+        }
         else {
             result = { action: 'conflict', existingValue: existing };
         }

package/package.json

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