@haxtheweb/create 9.0.22 → 9.0.24

package/dist/create.js

@@ -7,6 +7,7 @@ var path = _interopRequireWildcard(require("node:path"));
 var p = _interopRequireWildcard(require("@clack/prompts"));
 var _picocolors = _interopRequireDefault(require("picocolors"));
 var _statements = require("./lib/statements.js");
+var _logging = require("./lib/logging.js");
 var _webcomponent = require("./lib/programs/webcomponent.js");
 var _site = require("./lib/programs/site.js");
 var _utils = require("./lib/utils.js");
@@ -28,16 +29,16 @@ exec('git --version', error => {
 });
 async function main() {
   var commandRun = {};
-  _commander.program.option('--').option('--v', 'Verbose output').option('--debug', 'Output for developers').option('--format <char>', 'Output format; json (default), yaml').option('--path <char>', 'where to perform operation').option('--npm-client <char>', 'npm client to use (must be installed) npm, yarn, pnpm', 'npm').option('--y', 'yes to all questions').option('--skip', 'skip frills like animations').option('--quiet', 'remove console logging').option('--auto', 'yes to all questions, alias of y').option('--no-i', 'prevent interactions / sub-process, good for scripting').option('--to-file <char>', 'redirect command output to a file').option('--no-extras', 'skip all extra / automatic command processing')
+  _commander.program.option('--').option('--v', 'Verbose output').option('--debug', 'Output for developers').option('--format <char>', 'Output format; json (default), yaml').option('--path <char>', 'where to perform operation').option('--npm-client <char>', 'npm client to use (must be installed) npm, yarn, pnpm', 'npm').option('--y', 'yes to all questions').option('--skip', 'skip frills like animations').option('--quiet', 'remove console logging').option('--auto', 'yes to all questions, alias of y').option('--no-i', 'prevent interactions / sub-process, good for scripting').option('--to-file <char>', 'redirect command output to a file').option('--no-extras', 'skip all extra / automatic command processing').option('--root <char>', 'root location to execute the command from')
 
   // options for webcomponent
   .option('--org <char>', 'organization for package.json').option('--author <char>', 'author for site / package.json').option('--writeHaxProperties', 'Write haxProperties for the element')
 
   // options for site
-  .option('--import-site <char>', 'URL of site to import').option('--import-structure <char>', `import method to use:\n\rpressbooksToSite\n\relmslnToSite\n\rhaxcmsToSite\n\rnotionToSite\n\rgitbookToSite\n\revolutionToSite\n\rhtmlToSite\n\rdocxToSite`).option('--node-op <char>', 'node operation to perform').option('--item-id <char>', 'node ID to operate on').option('--name <char>', 'name of the project').option('--domain <char>', 'published domain name').option('--title-scrape <char>', 'CSS Selector for `title` in resource').option('--content-scrape <char>', 'CSS Selector for `body` in resource').option('--items-import <char>', 'import items from a file / site').version(await HAXCMS.getHAXCMSVersion()).helpCommand(true);
+  .option('--import-site <char>', 'URL of site to import').option('--import-structure <char>', `import method to use:\n\rpressbooksToSite\n\relmslnToSite\n\rhaxcmsToSite\n\rnotionToSite\n\rgitbookToSite\n\revolutionToSite\n\rhtmlToSite\n\rdocxToSite`).option('--node-op <char>', 'node operation to perform').option('--item-id <char>', 'node ID to operate on').option('--name <char>', 'name of the project').option('--domain <char>', 'published domain name').option('--title-scrape <char>', 'CSS Selector for `title` in resource').option('--content-scrape <char>', 'CSS Selector for `body` in resource').option('--items-import <char>', 'import items from a file / site').option('--recipe <char>', 'path to recipe file').version(await HAXCMS.getHAXCMSVersion()).helpCommand(true);
 
   // default command which runs interactively
-  _commander.program.command('start').description('Interactive program to pick options').action(() => {
+  _commander.program.command('start').description('Select which hax sub-program to run').action(() => {
     commandRun = {
       command: 'start',
       arguments: {},
@@ -50,8 +51,7 @@ async function main() {
   (0, _site.siteActions)().forEach(action => {
     strActions += `${action.value} - ${action.label}` + "\n\r";
   });
-  let siteProg = _commander.program.command('site');
-  siteProg.argument('[action]', 'Actions to perform on site include:' + "\n\r" + strActions).action(action => {
+  let siteProg = _commander.program.command('site').description('create or administer a HAXsite').argument('[action]', 'Actions to perform on site include:' + "\n\r" + strActions).action(action => {
     commandRun = {
       command: 'site',
       arguments: {},
@@ -61,13 +61,12 @@ async function main() {
       commandRun.arguments.action = action;
       commandRun.options.skip = true;
     }
-  }).option('--path <char>', 'path the project should be created in').option('--import-site <char>', 'URL of site to import').option('--import-structure <char>', `import method to use:\n\rpressbooksToSite\n\relmslnToSite\n\rhaxcmsToSite\n\rnotionToSite\n\rgitbookToSite\n\revolutionToSite\n\rhtmlToSite\n\rdocxToSite`).option('--name <char>', 'name of the site (when creating a new one)').option('--domain <char>', 'published domain name').option('--node-op <char>', 'node operation to perform').option('--no-i', 'prevent interactions / sub-process, good for scripting').option('--title-scrape <char>', 'CSS Selector for `title` in resource').option('--content-scrape <char>', 'CSS Selector for `body` in resource').option('--to-file <char>', 'redirect command output to a file').option('--no-extras', 'skip all extra / automatic command processing').option('--item-import <char>', 'import items from a file / site').version(await HAXCMS.getHAXCMSVersion());
+  }).option('--v', 'Verbose output').option('--debug', 'Output for developers').option('--format <char>', 'Output format; json (default), yaml').option('--path <char>', 'where to perform operation').option('--npm-client <char>', 'npm client to use (must be installed) npm, yarn, pnpm', 'npm').option('--y', 'yes to all questions').option('--skip', 'skip frills like animations').option('--quiet', 'remove console logging').option('--auto', 'yes to all questions, alias of y').option('--no-i', 'prevent interactions / sub-process, good for scripting').option('--to-file <char>', 'redirect command output to a file').option('--no-extras', 'skip all extra / automatic command processing').option('--root <char>', 'root location to execute the command from').option('--import-site <char>', 'URL of site to import').option('--import-structure <char>', `import method to use:\n\rpressbooksToSite\n\relmslnToSite\n\rhaxcmsToSite\n\rnotionToSite\n\rgitbookToSite\n\revolutionToSite\n\rhtmlToSite\n\rdocxToSite`).option('--name <char>', 'name of the site (when creating a new one)').option('--domain <char>', 'published domain name').option('--node-op <char>', 'node operation to perform').option('--title-scrape <char>', 'CSS Selector for `title` in resource').option('--content-scrape <char>', 'CSS Selector for `body` in resource').option('--item-import <char>', 'import items from a file / site').option('--recipe <char>', 'path to recipe file').version(await HAXCMS.getHAXCMSVersion());
   let siteNodeOps = (0, _site.siteNodeOperations)();
   for (var i in siteNodeOps) {
     _commander.program.option(`--${(0, _utils.camelToDash)(siteNodeOps[i].value)} <char>`, `${siteNodeOps[i].label}`);
     siteProg.option(`--${(0, _utils.camelToDash)(siteNodeOps[i].value)} <char>`, `${siteNodeOps[i].label}`);
   }
-
   // webcomponent program
   _commander.program.command('webcomponent').description('Create Lit based web components, with HAX recommendations').argument('[name]', 'name of the project').action(name => {
     commandRun = {
@@ -80,15 +79,32 @@ async function main() {
       commandRun.arguments.name = name;
       commandRun.options.skip = true;
     }
-  }).option('--path <char>', 'path the project should be created in').option('--org <char>', 'organization for package.json').option('--author <char>', 'author for site / package.json').option('--writeHaxProperties', 'Write haxProperties for the element').option('--to-file <char>', 'redirect command output to a file').option('--no-extras', 'skip all extra / automatic command processing').option('--no-i', 'prevent interactions / sub-process, good for scripting').version(await HAXCMS.getHAXCMSVersion());
+  }).option('--path <char>', 'path the project should be created in').option('--org <char>', 'organization for package.json').option('--author <char>', 'author for site / package.json').option('--writeHaxProperties', 'Write haxProperties for the element').option('--to-file <char>', 'redirect command output to a file').option('--no-extras', 'skip all extra / automatic command processing').option('--no-i', 'prevent interactions / sub-process, good for scripting').option('--root <char>', 'root location to execute the command from').version(await HAXCMS.getHAXCMSVersion());
   // process program arguments
   _commander.program.parse();
   commandRun.options = {
     ...commandRun.options,
     ..._commander.program.opts()
   };
+  // this is a false positive bc of the no-extras flag. no-extras does not imply true if not there
+  // but that's how the CLI works. This then bombs things downstream. Its good to be false but NOT
+  // good to be true since we need an array of options
+  if (commandRun.options.extras === true) {
+    delete commandRun.options.extras;
+  }
+  // allow execution of the command from a different location
+  if (commandRun.options.root) {
+    process.chdir(commandRun.options.root);
+  }
+  // bridge to log so we can respect this setting
+  if (commandRun.options.quiet) {
+    process.haxquiet = true;
+    // don't output to the console any messages on this run since told to be silent
+    // logging still happens to log files
+    _logging.logger.remove(_logging.consoleTransport);
+  }
   if (commandRun.options.debug) {
-    (0, _statements.log)(commandRun);
+    (0, _logging.log)(commandRun, 'debug');
   }
   // auto and y assume same thing
   if (commandRun.options.y || commandRun.options.auto) {
@@ -101,15 +117,11 @@ async function main() {
     let value = await exec(`git config user.name`);
     author = value.stdout.trim();
   } catch (e) {
-    (0, _statements.log)('git user name not configured. Run the following to do this:');
-    (0, _statements.log)('git config --global user.name "namehere"');
-    (0, _statements.log)('git config --global user.email "email@here');
-  }
-  // bridge to log so we can respect this setting
-  if (commandRun.options.quiet) {
-    process.haxquiet = true;
+    (0, _logging.log)(`
+      git user name not configured. Run the following to do this:\n
+      git config --global user.name "namehere"\n
+      git config --global user.email "email@here`, 'debug');
   }
-  // only set path if not already set
   if (!commandRun.options.path && commandRun.options.skip) {
     commandRun.options.path = process.cwd();
   }
@@ -166,7 +178,7 @@ async function main() {
     }
   }
   if (commandRun.options.debug) {
-    (0, _statements.log)(packageData);
+    (0, _logging.log)(packageData, 'debug');
   }
   // CLI works within context of the site if one is detected, otherwise we can do other thingss
   if (await hax.systemStructureContext()) {
@@ -354,7 +366,7 @@ async function main() {
             if (results.type === "site" && !commandRun.options.theme) {
               // support having no theme but autoselecting
               if (commandRun.options.auto && commandRun.options.skip) {
-                commandRun.options.theme = themes[0];
+                commandRun.options.theme = themes[0].value;
               } else {
                 return p.select({
                   message: "Theme:",

package/dist/lib/logging.js

@@ -0,0 +1,60 @@
+"use strict";
+
+Object.defineProperty(exports, "__esModule", {
+  value: true
+});
+exports.commandString = commandString;
+exports.consoleTransport = void 0;
+exports.haxCliEnvOptions = haxCliEnvOptions;
+exports.log = log;
+exports.logger = exports.logFile = void 0;
+var _nodeOs = require("node:os");
+var path = _interopRequireWildcard(require("node:path"));
+var winston = _interopRequireWildcard(require("winston"));
+var _utils = require("./utils.js");
+function _getRequireWildcardCache(e) { if ("function" != typeof WeakMap) return null; var r = new WeakMap(), t = new WeakMap(); return (_getRequireWildcardCache = function (e) { return e ? t : r; })(e); }
+function _interopRequireWildcard(e, r) { if (!r && e && e.__esModule) return e; if (null === e || "object" != typeof e && "function" != typeof e) return { default: e }; var t = _getRequireWildcardCache(r); if (t && t.has(e)) return t.get(e); var n = { __proto__: null }, a = Object.defineProperty && Object.getOwnPropertyDescriptor; for (var u in e) if ("default" !== u && {}.hasOwnProperty.call(e, u)) { var i = a ? Object.getOwnPropertyDescriptor(e, u) : null; i && (i.get || i.set) ? Object.defineProperty(n, u, i) : n[u] = e[u]; } return n.default = e, t && t.set(e, n), n; }
+const logFileName = path.join((0, _nodeOs.homedir)(), '.haxtheweb', 'create.log');
+const consoleTransport = exports.consoleTransport = new winston.transports.Console({
+  format: winston.format.simple()
+});
+const logFile = exports.logFile = new winston.transports.File({
+  filename: logFileName,
+  level: 'info',
+  // so we don't store everything else
+  format: winston.format.combine(winston.format.timestamp({
+    format: 'YYYY-MM-DD HH:mm:ss'
+  }), winston.format.errors({
+    stack: true
+  }), winston.format.splat(), winston.format.json()),
+  maxsize: 100000,
+  maxFiles: 10,
+  tailable: true
+});
+const logger = exports.logger = winston.createLogger({
+  transports: [consoleTransport, logFile]
+});
+function haxCliEnvOptions() {
+  return ['skip', 'npmClient', 'i', 'extras', 'root', 'path', 'org', 'author', 'y', 'auto'];
+}
+
+// wrapper so we can silence all log messages at the same time
+function log(msg, level = 'info', extra = null) {
+  logger.log(level, msg, extra);
+}
+function commandString(commandRun) {
+  let comStr = `hax ${commandRun.command} ${commandRun.arguments.action}`;
+  for (const key of Object.keys(commandRun.options)) {
+    // ignore environment centric calls
+    if (!haxCliEnvOptions().includes(key)) {
+      if (key === true) {
+        comStr += ` --${(0, _utils.camelToDash)(key)}`;
+      } else if (key === false) {
+        comStr += ` --no-${(0, _utils.camelToDash)(key)}`;
+      } else {
+        comStr += ` --${(0, _utils.camelToDash)(key)} "${commandRun.options[key]}"`;
+      }
+    }
+  }
+  return comStr;
+}

package/dist/lib/programs/site.js

@@ -13,11 +13,14 @@ exports.siteProcess = siteProcess;
 exports.siteThemeList = siteThemeList;
 var _promises = require("node:timers/promises");
 var fs = _interopRequireWildcard(require("node:fs"));
+var path = _interopRequireWildcard(require("node:path"));
 var p = _interopRequireWildcard(require("@clack/prompts"));
 var _picocolors = _interopRequireDefault(require("picocolors"));
 var _jsYaml = require("js-yaml");
+var winston = _interopRequireWildcard(require("winston"));
 var _nodeHtmlParser = require("node-html-parser");
 var _statements = require("../statements.js");
+var _logging = require("../logging.js");
 var _microFrontendRegistry = require("../micro-frontend-registry.js");
 var haxcmsNodejsCli = _interopRequireWildcard(require("@haxtheweb/haxcms-nodejs/dist/cli.js"));
 var hax = _interopRequireWildcard(require("@haxtheweb/haxcms-nodejs"));
@@ -42,6 +45,10 @@ exec('surge --version', error => {
     sysSurge = false;
   }
 });
+const siteRecipeFile = 'create-cli.recipe';
+const siteLoggingName = 'cli';
+const logLevels = {};
+logLevels[siteLoggingName] = 0;
 
 // fake response class so we can capture the response from the headless route as opposed to print to console
 // this way we can handle as data or if use is requesting output format to change we can respond
@@ -113,13 +120,31 @@ function siteActions() {
   }, {
     value: 'site:surge',
     label: "Publish site to Surge.sh"
+  }, {
+    value: 'recipe:read',
+    label: "Read recipe file"
+  }, {
+    value: 'recipe:play',
+    label: "Play recipe file"
   }];
 }
 async function siteCommandDetected(commandRun) {
   var activeHaxsite = await hax.systemStructureContext();
+  const recipeFileName = path.join(process.cwd(), siteRecipeFile);
+  const recipeLogTransport = new winston.transports.File({
+    filename: recipeFileName
+  });
+  const recipe = winston.createLogger({
+    levels: logLevels,
+    level: siteLoggingName,
+    transports: [recipeLogTransport],
+    format: winston.format.simple()
+  });
+  let actionAssigned = false;
   // default to status unless already set so we don't issue a create in a create
   if (!commandRun.arguments.action) {
-    commandRun.arguments.action = 'status';
+    actionAssigned = true;
+    commandRun.arguments.action = 'site:status';
   }
   commandRun.command = "site";
   if (!commandRun.options.y && commandRun.options.i && !commandRun.options.quiet) {
@@ -169,7 +194,11 @@ async function siteCommandDetected(commandRun) {
         }
       });
     }
+    if (operation.action) {
+      p.intro(`hax site ${_picocolors.default.bold(operation.action)}`);
+    }
     switch (operation.action) {
+      case "site:status": // easy mistype
       case "site:stats":
         const date = new Date(activeHaxsite.manifest.metadata.site.updated * 1000);
         let siteItems = [];
@@ -211,9 +240,9 @@ async function siteCommandDetected(commandRun) {
           p.intro(`${_picocolors.default.bgBlue(_picocolors.default.white(` Last updated: ${siteStats.lastUpdated} `))}`);
           p.intro(`${_picocolors.default.bgBlue(_picocolors.default.white(` Tags used: ${JSON.stringify(siteStats.tagUsage, null, 2)} `))}`);
         } else if (commandRun.options.format === 'yaml') {
-          (0, _statements.log)((0, _jsYaml.dump)(siteStats));
+          (0, _logging.log)((0, _jsYaml.dump)(siteStats));
         } else {
-          (0, _statements.log)(siteStats);
+          (0, _logging.log)(siteStats);
         }
         // simple redirecting to file
         if (commandRun.options.toFile) {
@@ -246,9 +275,9 @@ async function siteCommandDetected(commandRun) {
           fs.writeFileSync(commandRun.options.toFile, contents);
         } else {
           if (commandRun.options.format === 'yaml') {
-            (0, _statements.log)((0, _jsYaml.dump)(siteitems));
+            (0, _logging.log)((0, _jsYaml.dump)(siteitems));
           } else {
-            (0, _statements.log)(siteitems);
+            (0, _logging.log)(siteitems);
           }
         }
         break;
@@ -313,10 +342,11 @@ async function siteCommandDetected(commandRun) {
             itemIdMap[josImport.items[i].id] = tmpAddedItem.id;
           }
           if (!commandRun.options.quiet) {
-            (0, _statements.log)(`${josImport.items.length} nodes imported`);
+            (0, _logging.log)(`${josImport.items.length} nodes imported`);
           }
+          recipe.log(siteLoggingName, (0, _logging.commandString)(commandRun));
         } else if (!commandRun.options.quiet) {
-          (0, _statements.log)('Must specify --item-import as path to valid item export file or URL', 'error');
+          (0, _logging.log)('Must specify --item-import as path to valid item export file or URL', 'error');
         }
         break;
       case "start":
@@ -327,9 +357,10 @@ async function siteCommandDetected(commandRun) {
           }
           await exec(`cd ${activeHaxsite.directory} && npx @haxtheweb/haxcms-nodejs`);
         } catch (e) {
-          (0, _statements.log)(e.stderr);
+          (0, _logging.log)(e.stderr);
         }
         break;
+      case "node:status": // easy mistype
       case "node:stats":
         try {
           if (!commandRun.options.itemId) {
@@ -360,9 +391,9 @@ async function siteCommandDetected(commandRun) {
               switch (commandRun.options.nodeOp) {
                 case 'details':
                   if (commandRun.options.format === 'yaml') {
-                    (0, _statements.log)((0, _jsYaml.dump)(page));
+                    (0, _logging.log)((0, _jsYaml.dump)(page));
                   } else {
-                    (0, _statements.log)(page);
+                    (0, _logging.log)(page);
                   }
                   // simple redirecting to file
                   if (commandRun.options.toFile) {
@@ -379,7 +410,7 @@ async function siteCommandDetected(commandRun) {
                   if (commandRun.options.toFile) {
                     fs.writeFileSync(commandRun.options.toFile, itemHTML);
                   } else {
-                    (0, _statements.log)(itemHTML);
+                    (0, _logging.log)(itemHTML);
                   }
                   break;
                 case 'schema':
@@ -402,9 +433,9 @@ async function siteCommandDetected(commandRun) {
                     }
                   } else {
                     if (commandRun.options.format === 'yaml') {
-                      (0, _statements.log)((0, _jsYaml.dump)(els));
+                      (0, _logging.log)((0, _jsYaml.dump)(els));
                     } else {
-                      (0, _statements.log)(els);
+                      (0, _logging.log)(els);
                     }
                   }
                   break;
@@ -416,15 +447,15 @@ async function siteCommandDetected(commandRun) {
                   if (commandRun.options.toFile) {
                     fs.writeFileSync(commandRun.options.toFile, resp.res.data.data);
                   } else {
-                    (0, _statements.log)(resp.res.data.data);
+                    (0, _logging.log)(resp.res.data.data);
                   }
                   break;
               }
             }
           }
         } catch (e) {
-          (0, _statements.log)(e.stderr);
-          (0, _statements.log)(e);
+          (0, _logging.log)(e.stderr);
+          (0, _logging.log)(e);
         }
         break;
       case "node:add":
@@ -495,14 +526,15 @@ async function siteCommandDetected(commandRun) {
             createNodeBody.node.contents = locationContent;
           }
           let resp = await haxcmsNodejsCli.cliBridge('createNode', createNodeBody);
+          recipe.log(siteLoggingName, (0, _logging.commandString)(commandRun));
           if (commandRun.options.v) {
-            (0, _statements.log)(resp.res.data);
+            (0, _logging.log)(resp.res.data, 'silly');
           }
           if (!commandRun.options.quiet) {
-            (0, _statements.log)(`"${createNodeBody.node.title}" added to site`);
+            (0, _logging.log)(`"${createNodeBody.node.title}" added to site`, 'info', createNodeBody.node);
           }
         } catch (e) {
-          (0, _statements.log)(e.stderr);
+          (0, _logging.log)(e.stderr);
         }
         break;
       case "node:edit":
@@ -627,8 +659,9 @@ async function siteCommandDetected(commandRun) {
                 }
                 // if we have content (meaning it's not blank) then try to write the page location                    
                 if (locationContent && (await page.writeLocation(locationContent))) {
+                  recipe.log(siteLoggingName, (0, _logging.commandString)(commandRun));
                   if (!commandRun.options.quiet) {
-                    (0, _statements.log)(`node:edit success updated page content: "${page.id}`);
+                    (0, _logging.log)(`node:edit success updated page content: "${page.id}`);
                   }
                 } else {
                   console.warn(`node:edit failure to write page content : ${page.id}`);
@@ -643,14 +676,15 @@ async function siteCommandDetected(commandRun) {
                   page[commandRun.options.nodeOp] = commandRun.options[commandRun.options.nodeOp];
                 }
                 let resp = await activeHaxsite.updateNode(page);
+                recipe.log(siteLoggingName, (0, _logging.commandString)(commandRun));
                 if (commandRun.options.v) {
-                  (0, _statements.log)(resp);
+                  (0, _logging.log)(resp, 'silly');
                 }
               }
             }
           }
         } catch (e) {
-          (0, _statements.log)(e.stderr);
+          (0, _logging.log)(e.stderr);
         }
         break;
       case "node:delete":
@@ -686,14 +720,15 @@ async function siteCommandDetected(commandRun) {
               if (resp.res.data === 500) {
                 console.warn(`node:delete failed "${commandRun.options.itemId} not found`);
               } else {
-                (0, _statements.log)(`"${commandRun.options.itemId}" deleted`);
+                recipe.log(siteLoggingName, (0, _logging.commandString)(commandRun));
+                (0, _logging.log)(`"${commandRun.options.itemId}" deleted`);
               }
             } else {
-              (0, _statements.log)(`Delete operation canceled`);
+              (0, _logging.log)(`Delete operation canceled`);
             }
           }
         } catch (e) {
-          (0, _statements.log)(e.stderr);
+          (0, _logging.log)(e.stderr);
         }
         break;
       case "site:sync":
@@ -701,7 +736,7 @@ async function siteCommandDetected(commandRun) {
         try {
           await exec(`cd ${activeHaxsite.directory} && git pull && git push`);
         } catch (e) {
-          (0, _statements.log)(e.stderr);
+          (0, _logging.log)(e.stderr);
         }
         break;
       case "site:theme":
@@ -721,10 +756,11 @@ async function siteCommandDetected(commandRun) {
             if (themes && commandRun.options.theme && themes[commandRun.options.theme]) {
               activeHaxsite.manifest.metadata.theme = themes[commandRun.options.theme];
               activeHaxsite.manifest.save(false);
+              recipe.log(siteLoggingName, (0, _logging.commandString)(commandRun));
             }
           }
         } catch (e) {
-          (0, _statements.log)(e.stderr);
+          (0, _logging.log)(e.stderr);
         }
         break;
       case "site:surge":
@@ -736,7 +772,7 @@ async function siteCommandDetected(commandRun) {
             s.start((0, _statements.merlinSays)('Installing Surge.sh globally so we can publish'));
             let execOutput = await exec(`npm install --global surge`);
             s.stop((0, _statements.merlinSays)('surge.sh installed globally'));
-            (0, _statements.log)(execOutput.stdout.trim());
+            (0, _logging.log)(execOutput.stdout.trim());
             sysSurge = true;
           }
           if (!commandRun.options.domain) {
@@ -753,10 +789,10 @@ async function siteCommandDetected(commandRun) {
             });
           }
           let execOutput = await exec(`cd ${activeHaxsite.directory} && surge . ${commandRun.options.domain}`);
-          (0, _statements.log)(execOutput.stdout.trim());
-          (0, _statements.log)(`Site published: https://${commandRun.options.domain}`);
+          (0, _logging.log)(execOutput.stdout.trim());
+          (0, _logging.log)(`Site published: https://${commandRun.options.domain}`);
         } catch (e) {
-          (0, _statements.log)(e.stderr);
+          (0, _logging.log)(e.stderr);
         }
         break;
       case "site:file-list":
@@ -766,9 +802,9 @@ async function siteCommandDetected(commandRun) {
           filename: commandRun.options.filename
         }, res);
         if (commandRun.options.format === 'yaml') {
-          (0, _statements.log)((0, _jsYaml.dump)(res.data));
+          (0, _logging.log)((0, _jsYaml.dump)(res.data));
         } else {
-          (0, _statements.log)(res.data);
+          (0, _logging.log)(res.data);
         }
         break;
       case "site:html":
@@ -811,9 +847,9 @@ async function siteCommandDetected(commandRun) {
             }
           } else {
             if (commandRun.options.format === 'yaml') {
-              (0, _statements.log)((0, _jsYaml.dump)(els));
+              (0, _logging.log)((0, _jsYaml.dump)(els));
             } else {
-              (0, _statements.log)(els);
+              (0, _logging.log)(els);
             }
           }
         } else {
@@ -829,19 +865,67 @@ async function siteCommandDetected(commandRun) {
             if (commandRun.options.toFile) {
               fs.writeFileSync(commandRun.options.toFile, resp.res.data.data);
               if (!commandRun.options.quiet) {
-                (0, _statements.log)(`${commandRun.options.toFile} written`);
+                (0, _logging.log)(`${commandRun.options.toFile} written`);
               }
             } else {
-              (0, _statements.log)(resp.res.data.data);
+              (0, _logging.log)(resp.res.data.data);
             }
           } else {
             if (commandRun.options.toFile) {
               fs.writeFileSync(commandRun.options.toFile, siteContent);
               if (!commandRun.options.quiet) {
-                (0, _statements.log)(`${commandRun.options.toFile} written`);
+                (0, _logging.log)(`${commandRun.options.toFile} written`);
               }
             } else {
-              (0, _statements.log)(siteContent);
+              (0, _logging.log)(siteContent);
+            }
+          }
+        }
+        break;
+      // @todo need to make these work..
+      case "recipe:read":
+        // just print the recipe out
+        if (fs.existsSync(path.join(process.cwd(), `${siteRecipeFile}`))) {
+          let recContents = await fs.readFileSync(path.join(process.cwd(), `${siteRecipeFile}`), 'utf8');
+          console.log(recContents);
+        }
+        break;
+      case "recipe:play":
+        // step through and run each recipe once fed a file location
+        // this allows for storing commands from a site and then replaying them with ease
+        if (!commandRun.options.recipe) {
+          commandRun.options.recipe = await p.text({
+            message: `Select recipe:`,
+            defaultValue: process.cwd(),
+            initialValue: process.cwd(),
+            validate: val => {
+              if (!val.endsWith('.recipe')) {
+                return 'HAX Recipe files must end in .recipe';
+              }
+            }
+          });
+        }
+        if (fs.existsSync(commandRun.options.recipe)) {
+          let recContents = await fs.readFileSync(commandRun.options.recipe, 'utf8');
+          // split into commands
+          let commandList = recContents.replaceAll('cli: ', '').split("\n");
+          // confirm each command or allow --y so that it auto applies
+          for (var i in commandList) {
+            // verify every command starts this way for safety
+            if (commandList[i].startsWith('hax site')) {
+              let confirmation;
+              if (commandRun.options.y) {
+                confirmation = true;
+              } else {
+                confirmation = await p.confirm({
+                  message: `Do you want to run ${commandList[i]}? (This cannot be undone)`,
+                  initialValue: true
+                });
+              }
+              // confirmed; let's run!
+              if (confirmation) {
+                await exec(`${commandList[i]} --y --no-i --auto --quiet`);
+              }
             }
           }
         }
@@ -852,7 +936,7 @@ async function siteCommandDetected(commandRun) {
         break;
     }
     // y or noi need to act like it ran and finish instead of looping options
-    if (commandRun.options.y || !commandRun.options.i) {
+    if (commandRun.options.y || !commandRun.options.i || !actionAssigned) {
       process.exit(0);
     }
     operation.action = null;
@@ -953,6 +1037,7 @@ async function openApiBroker(scope, call, body) {
 async function siteProcess(commandRun, project, port = '3000') {
   // auto select operations to perform if requested
   var s = p.spinner();
+  // if we have no extras, or they are empty then set for launch
   if (!project.extras) {
     project.extras = [];
     if (commandRun.options.i) {
@@ -1080,11 +1165,26 @@ async function siteProcess(commandRun, project, port = '3000') {
   await hax.RoutesMap.post.createSite({
     body: siteRequest
   }, res);
+  // path different for this one as it's on the fly produced
+  const recipeFileName = path.join(project.path, '/', project.name, `${siteRecipeFile}`);
+  const recipeLogTransport = new winston.transports.File({
+    filename: recipeFileName
+  });
+  const recipe = winston.createLogger({
+    levels: logLevels,
+    level: siteLoggingName,
+    transports: [recipeLogTransport],
+    format: winston.format.simple()
+  });
+  // matching the common object elsewhere tho different reference in this command since it creates from nothing
+  // capture this if use input on the fly
+  commandRun.options.theme = project.theme;
+  recipe.log(siteLoggingName, (0, _logging.commandString)(commandRun));
   if (commandRun.options.v) {
     if (commandRun.options.format === 'yaml') {
-      (0, _statements.log)((0, _jsYaml.dump)(res.data));
+      (0, _logging.log)((0, _jsYaml.dump)(res.data), 'silly');
     } else {
-      (0, _statements.log)(res.data);
+      (0, _logging.log)(res.data, 'silly');
     }
   }
   if (!commandRun.options.quiet) {
@@ -1098,7 +1198,7 @@ async function siteProcess(commandRun, project, port = '3000') {
   }
   // options for install, git and other extras
   // can't launch if we didn't install first so launch implies installation
-  if (project.extras.includes('launch')) {
+  if (project.extras && project.extras.includes && project.extras.includes('launch')) {
     let optionPath = `${project.path}/${project.name}`;
     let command = `npx @haxtheweb/haxcms-nodejs`;
     if (!commandRun.options.quiet) {

package/dist/lib/programs/webcomponent.js

@@ -13,6 +13,7 @@ var ejs = _interopRequireWildcard(require("ejs"));
 var p = _interopRequireWildcard(require("@clack/prompts"));
 var _picocolors = _interopRequireDefault(require("picocolors"));
 var _statements = require("../statements.js");
+var _logging = require("../logging.js");
 var _utils = require("../utils.js");
 var hax = _interopRequireWildcard(require("@haxtheweb/haxcms-nodejs"));
 var child_process = _interopRequireWildcard(require("child_process"));
@@ -150,7 +151,7 @@ async function webcomponentProcess(commandRun, project, port = "8000") {
   // values not set by user but used in templating
   project.className = (0, _utils.dashToCamel)(project.name);
   // option to build github repo link for the user
-  if (project.extras.includes('git')) {
+  if (project.extras && project.extras.includes('git')) {
     // @todo need to support git@ and https methods
     if (commandRun.options.auto) {
       project.gitRepo = `https://github.com/${project.author}/${project.name}.git`;
@@ -227,7 +228,7 @@ async function webcomponentProcess(commandRun, project, port = "8000") {
   }
   // options for install, git and other extras
   // can't launch if we didn't install first so launch implies installation
-  if (project.extras.includes('launch') || project.extras.includes('install')) {
+  if (project.extras && (project.extras.includes('launch') || project.extras.includes('install'))) {
     s.start((0, _statements.merlinSays)(`Installation magic (${commandRun.options.npmClient} install)`));
     try {
       // monorepos install from top but then still need to launch from local location
@@ -240,7 +241,7 @@ async function webcomponentProcess(commandRun, project, port = "8000") {
     s.stop((0, _statements.merlinSays)(`Everything is installed. It's go time`));
   }
   // autolaunch if default was selected
-  if (project.extras.includes('launch')) {
+  if (project.extras && project.extras.includes('launch')) {
     let optionPath = `${project.path}/${project.name}`;
     let command = `${commandRun.options.npmClient} start`;
     p.note(`${(0, _statements.merlinSays)(`I have summoned a sub-process daemon 👹`)}
@@ -331,7 +332,7 @@ async function webcomponentGenerateHAXSchema(commandRun, packageData) {
     });
     let wiring = new HAXWiring();
     if (commandRun.options.debug) {
-      (0, _statements.log)(ceFileData);
+      (0, _logging.log)(ceFileData, 'debug');
     }
     if (ceFileData) {
       let ce = JSON.parse(ceFileData);
@@ -387,10 +388,10 @@ async function webcomponentGenerateHAXSchema(commandRun, packageData) {
             }
           });
           if (commandRun.options.v) {
-            (0, _statements.log)(JSON.stringify(props, null, 2));
+            (0, _logging.log)(JSON.stringify(props, null, 2), 'silly');
           }
           fs.writeFileSync(`./lib/${declarations.tagName}.haxProperties.json`, JSON.stringify(props, null, 2));
-          (0, _statements.log)(`schema written to: ./lib/${declarations.tagName}.haxProperties.json`);
+          (0, _logging.log)(`schema written to: ./lib/${declarations.tagName}.haxProperties.json`);
         });
       });
     }

package/dist/lib/statements.js

@@ -5,7 +5,6 @@ Object.defineProperty(exports, "__esModule", {
 });
 exports.communityStatement = communityStatement;
 exports.haxIntro = haxIntro;
-exports.log = log;
 exports.merlinSays = merlinSays;
 var _art = require("./art.js");
 var p = _interopRequireWildcard(require("@clack/prompts"));
@@ -14,12 +13,6 @@ var _promises = require("node:timers/promises");
 function _interopRequireDefault(e) { return e && e.__esModule ? e : { default: e }; }
 function _getRequireWildcardCache(e) { if ("function" != typeof WeakMap) return null; var r = new WeakMap(), t = new WeakMap(); return (_getRequireWildcardCache = function (e) { return e ? t : r; })(e); }
 function _interopRequireWildcard(e, r) { if (!r && e && e.__esModule) return e; if (null === e || "object" != typeof e && "function" != typeof e) return { default: e }; var t = _getRequireWildcardCache(r); if (t && t.has(e)) return t.get(e); var n = { __proto__: null }, a = Object.defineProperty && Object.getOwnPropertyDescriptor; for (var u in e) if ("default" !== u && {}.hasOwnProperty.call(e, u)) { var i = a ? Object.getOwnPropertyDescriptor(e, u) : null; i && (i.get || i.set) ? Object.defineProperty(n, u, i) : n[u] = e[u]; } return n.default = e, t && t.set(e, n), n; }
-// wrapper so we can silence all log messages at the same time
-function log(msg, level = 'log') {
-  if (!process.haxquiet) {
-    console[level](msg);
-  }
-}
 async function haxIntro() {
   console.clear();
   await (0, _promises.setTimeout)(10);

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@haxtheweb/create",
-  "version": "9.0.22",
+  "version": "9.0.24",
   "publishConfig": {
     "access": "public"
   },
@@ -51,7 +51,8 @@
     "node-html-parser": "6.1.13",
     "ejs": "3.1.10",
     "js-yaml": "4.1.0",
-    "picocolors": "1.0.1"
+    "picocolors": "1.0.1",
+    "winston": "3.17.0"
   },
   "devDependencies": {
     "@babel/cli": "^7.24.6",