@timekast/factory 1.7.0 → 1.8.0

package/dist/commands/new.js

@@ -52,9 +52,20 @@ async function createRepo(name) {
         throw new CLIError(`No se pudo crear el repo \`${FACTORY_ORG}/${name}\` en GitHub.${detail}`);
     }
 }
-export async function runNew(name) {
+/**
+ * Parse `new`'s argv slice into flags. Lets a GUI launcher / headless caller run
+ * non-interactively (`new <Name> --full`); without a flag, `new` still prompts.
+ */
+export function parseNewFlags(argv) {
+    return { core: argv.includes('--core'), full: argv.includes('--full') };
+}
+export async function runNew(name, flags = { core: false, full: false }) {
     // 1. Validate offline, before any network call.
     const validName = validateProjectName(name);
+    // Reject contradictory profile flags before any network call (mirrors `add`).
+    if (flags.core && flags.full) {
+        throw new CLIError('No puedes combinar `--core` con `--full`.');
+    }
     // 2. Refuse to run inside an existing repo (before any destructive action).
     const cwd = process.cwd();
     if (existsSync(path.join(cwd, '.git'))) {
@@ -68,8 +79,13 @@ export async function runNew(name) {
     }
     // 4. Preflight: gh installed + authed + org member.
     await runPreflight();
-    // 5. Choose profile.
-    const profile = await promptProfile();
+    // 5. Choose profile. A `--full`/`--core` flag skips the prompt (lets a GUI or
+    //    headless caller run non-interactively); absent → interactive select.
+    const profile = flags.full
+        ? PROFILES.full
+        : flags.core
+            ? PROFILES.core
+            : await promptProfile();
     // 6. Network: create the repo.
     await createRepo(validName);
     // 7. Download + unpack into a temp dir, validate, then move into place (M2).

package/dist/index.js

@@ -12,7 +12,7 @@ import { fileURLToPath } from 'node:url';
 import { CLIError } from './lib/cli-error.js';
 import { parseAddFlags, runAdd } from './commands/add.js';
 import { runDoctor } from './commands/doctor.js';
-import { runNew } from './commands/new.js';
+import { parseNewFlags, runNew } from './commands/new.js';
 import { parsePublishArgs, runPublish } from './commands/publish.js';
 import { runStatus } from './commands/status.js';
 import { parseUnpublishTargets, runUnpublish } from './commands/unpublish.js';
@@ -33,6 +33,10 @@ Comandos:
   publish <qué>    Publica el entregable (proposal|mockup|both) a proposals.timekast.mx
   unpublish [qué]  Baja del hub un entregable publicado (proposal|mockup|both; default both)
 
+Sobre \`new\`:
+  Pregunta el perfil de forma interactiva. Los flags \`--full\` / \`--core\` lo
+  fijan sin preguntar (útil para un lanzador GUI o uso headless).
+
 Sobre \`add\`:
   Requiere estar dentro de un repo git (al menos \`git init\`). Por default instala
   el cerebro \`full\` (incluye sk-* + SK.md) si el repo es un derivado del Factory
@@ -97,7 +101,7 @@ async function main(argv) {
             if (!name) {
                 throw new CLIError('Falta el nombre del proyecto. Uso: `factory new <Nombre>`.');
             }
-            await runNew(name);
+            await runNew(name, parseNewFlags(rest));
             return;
         }
         case 'add': {

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.8.0",
   "description": "Public, thin CLI to bootstrap and maintain TimeKast Factory derived projects.",
   "type": "module",
   "license": "UNLICENSED",