@timekast/factory 1.5.0 → 1.6.0

package/dist/commands/new.js

@@ -18,7 +18,7 @@ import prompts from 'prompts';
 import { CLIError } from '../lib/cli-error.js';
 import { FACTORY_ORG, PROFILES } from '../lib/constants.js';
 import { parseLockfile, writeInitialLockfile } from '../lib/lockfile.js';
-import { applyPackageJsonEdits } from '../lib/package-json.js';
+import { applyPackageJsonEdits, kitLocalScripts } from '../lib/package-json.js';
 import { renderDerivedReadme } from '../lib/readme.js';
 import { runPreflight } from '../lib/preflight.js';
 import { downloadProfileTarball, moveContentsInto, stageProfileTarball } from '../lib/unpack.js';
@@ -103,7 +103,7 @@ export async function runNew(name) {
         const pkgPath = path.join(destDir, 'package.json');
         const hasPackageJson = existsSync(pkgPath);
         if (hasPackageJson) {
-            const { content, scriptAlreadyPresent } = applyPackageJsonEdits(readFileSync(pkgPath, 'utf8'), validName);
+            const { content, scriptAlreadyPresent } = applyPackageJsonEdits(readFileSync(pkgPath, 'utf8'), validName, kitLocalScripts(destDir));
             writeFileSync(pkgPath, content, 'utf8');
             if (scriptAlreadyPresent) {
                 console.warn('Aviso: `factory:update` ya existía en package.json con otro valor; no se sobrescribió.');

package/dist/lib/constants.js

@@ -83,3 +83,14 @@ export const FACTORY_SCRIPTS = {
     [PUBLISH_SCRIPT_NAME]: PUBLISH_SCRIPT_CMD,
     [UNPUBLISH_SCRIPT_NAME]: UNPUBLISH_SCRIPT_CMD,
 };
+/**
+ * Kit-local convenience script: the readiness sweep (`pnpm preflight`, consumed
+ * by the /deploy gate and /preflight). Unlike the npx-based `factory:*` scripts
+ * it shells a file that ships with the FULL brain, so the installer ensures it
+ * only when that file exists in the repo (file-gated — a core/non-Factory repo
+ * never gets a broken entry). Insert-if-missing like the rest: a dev's own
+ * `preflight` script is never overwritten.
+ */
+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';

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, PROFILES, UPDATE_SCRIPT_NAME } from './constants.js';
+import { FACTORY_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
@@ -66,12 +66,12 @@ export function parsePackageJson(raw) {
  * only on a real edit) + the result for the primary `factory:update` script
  * (which drives the install messaging).
  */
-function ensureFactoryScripts(pkg) {
+function ensureFactoryScripts(pkg, extraScripts = {}) {
     const scripts = pkg.scripts ?? {};
     pkg.scripts = scripts;
     let changed = false;
     let primary = { action: 'already-correct' };
-    for (const [name, cmd] of Object.entries(FACTORY_SCRIPTS)) {
+    for (const [name, cmd] of Object.entries({ ...FACTORY_SCRIPTS, ...extraScripts })) {
         const existing = scripts[name];
         let result;
         if (existing === undefined) {
@@ -91,27 +91,41 @@ function ensureFactoryScripts(pkg) {
     return { changed, primary };
 }
 /**
- * Rename `package.json.name` and ensure the `factory:*` scripts exist,
- * preserving everything else. Returns the serialized document (with the
- * original indentation + trailing newline).
+ * 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.
+ */
+export function kitLocalScripts(rootDir) {
+    return existsSync(path.join(rootDir, PREFLIGHT_SCRIPT_FILE))
+        ? { [PREFLIGHT_SCRIPT_NAME]: PREFLIGHT_SCRIPT_CMD }
+        : {};
+}
+/**
+ * Rename `package.json.name` and ensure the `factory:*` scripts (+ the
+ * file-gated kit-local `extraScripts`, see `kitLocalScripts`) exist, preserving
+ * everything else. Returns the serialized document (with the original
+ * indentation + trailing newline).
  *
  * If `factory:update` already exists with a different value it is left intact;
  * `scriptAlreadyPresent` reports that so the caller can warn the user.
  */
-export function applyPackageJsonEdits(raw, name) {
+export function applyPackageJsonEdits(raw, name, extraScripts = {}) {
     const indent = detectIndent(raw);
     const pkg = parsePackageJson(raw);
     pkg.name = name;
-    const { primary } = ensureFactoryScripts(pkg);
+    const { primary } = ensureFactoryScripts(pkg, extraScripts);
     const content = `${JSON.stringify(pkg, null, indent)}\n`;
     return { content, scriptAlreadyPresent: primary.action === 'conflict' };
 }
 /**
  * Surgically ensure the `factory:*` scripts (`update` / `doctor` / `status`)
- * exist in the `package.json` at `pkgPath` (design §7.4). Reads, mutates only
- * those keys, and re-serializes with the original indentation + trailing
- * newline. NEVER overwrites a divergent value and NEVER touches `name`, deps,
- * or any other script.
+ * plus the file-gated kit-local scripts (`preflight` when its file ships —
+ * `kitLocalScripts` on the package.json's own directory) exist in the
+ * `package.json` at `pkgPath` (design §7.4). Reads, mutates only those keys,
+ * and re-serializes with the original indentation + trailing newline. NEVER
+ * overwrites a divergent value and NEVER touches `name`, deps, or any other
+ * script.
  *
  * Writes the file only when at least one script was added; if all are already
  * present (correct or divergent) the file is left byte-identical.
@@ -123,7 +137,7 @@ export function insertFactoryUpdateScript(pkgPath) {
     const raw = readFileSync(pkgPath, 'utf8');
     const indent = detectIndent(raw);
     const pkg = parsePackageJson(raw);
-    const { changed, primary } = ensureFactoryScripts(pkg);
+    const { changed, primary } = ensureFactoryScripts(pkg, kitLocalScripts(path.dirname(pkgPath)));
     if (changed) {
         writeFileSync(pkgPath, `${JSON.stringify(pkg, null, indent)}\n`, 'utf8');
     }

package/package.json

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