turnzero 0.18.1 → 0.18.2-next.1

package/dist/turnzero-cloud.mjs

@@ -895,7 +895,7 @@ var variableReadSentence = (origin, standing) => {
 };
 var fileReadSentence = (origin) => `The credential this run read was this computer's token for ${origin}, from its credential file: where the platform no longer accepts it, run ${LOGIN_SUBCOMMAND}${originWordsOf(origin)} to authorize this computer again.`;
 var noTokenSentence = (origin, expiredAt) => expiredAt === null ? `No credential was read, so nothing was sent: ${MINTED_TOKEN_VARIABLE} is not set, and this computer's credential file holds no token for ${origin}.` : `No credential was read, so nothing was sent: ${MINTED_TOKEN_VARIABLE} is not set, and this computer's token for ${origin} in its credential file expired at ${expiredAt}.`;
-var VARIABLE_ROUTE_SENTENCES = `A tool connected by a minted token, or a job, cannot use ${MINT_TOKEN_ACTION}, which takes a sign-in alone. It sets ${MINTED_TOKEN_VARIABLE} from where its token is kept, never by writing the value in a line, and ${ORIGIN_VARIABLE} to the address that minted the token where that is not ${DEFAULT_COMMAND_ORIGIN}, then runs the line again. A tool sets ${MINTED_TOKEN_VARIABLE} for the deploy or check line alone and unsets it once that line ends.`;
+var VARIABLE_ROUTE_SENTENCES = `A tool connected by a minted token, or a job, sets ${MINTED_TOKEN_VARIABLE} from where its token is kept, never by writing the value in a line, and ${ORIGIN_VARIABLE} to the address that minted the token where that is not ${DEFAULT_COMMAND_ORIGIN}, then runs the line again. Such a tool cannot use ${MINT_TOKEN_ACTION}, which takes a sign-in alone. A tool sets ${MINTED_TOKEN_VARIABLE} for the deploy or check line alone and unsets it once that line ends.`;
 var LOGIN_ROUTE_OPENER = "A person logs this computer in once, in a terminal of their own, and its token then stays on this computer for 30 days:";
 var DEPLOY_FILES_ROUTE_SENTENCE = "A folder within the caps of your tool's deploy_files call deploys now through deploy_files, with no login.";
 var loginRouteLines = (io2, origin) => [LOGIN_ROUTE_OPENER, ...loginLinesFor(io2, origin), DEPLOY_FILES_ROUTE_SENTENCE];
@@ -3584,9 +3584,9 @@ var DEPLOY_ROW = Object.freeze({
   variables: [[DEPLOY_NO_WAIT_VARIABLE, "any value returns the command once the deploy has started, without waiting for it."]],
   note: [
     `A deploy is one line, which carries no credential: run the line your tool's deploy call answers, or ${DEPLOY_SUBCOMMAND} ${DEPLOY_OPTION.application} <application id>, from the application's folder. It reads no standard input. On an authorized computer it runs under this computer's token, which ${LOGIN_SUBCOMMAND} or ${AUTHORIZE_SUBCOMMAND} keeps in the credential file for each platform address, and sends it only to the address it is kept under: ${DEPLOY_OPTION.origin} where the line names one, else the address ${ORIGIN_VARIABLE} holds, else ${DEFAULT_COMMAND_ORIGIN}.`,
-    `On a computer with no token for that address, or one that has expired, it sends nothing, ends 3, and prints two routes, in this order. A tool connected by a minted token, or a job with no tool, such as a CI job's, cannot use ${MINT_TOKEN_ACTION}: it sets ${MINTED_TOKEN_VARIABLE} from where its token is kept, such as the job's secret store, never by writing the value in a line, and ${ORIGIN_VARIABLE} to the address that minted the token where that is not ${DEFAULT_COMMAND_ORIGIN}, then runs the deploy line again.`,
+    `On a computer with no token for that address, or one that has expired, it sends nothing, ends 3, and prints two routes, in this order. A tool connected by a minted token, or a job with no tool, such as a CI job's, sets ${MINTED_TOKEN_VARIABLE} from where its token is kept, such as the job's secret store, never by writing the value in a line. It sets ${ORIGIN_VARIABLE} to the address that minted the token where that is not ${DEFAULT_COMMAND_ORIGIN}, then runs the deploy line again. Such a tool cannot use ${MINT_TOKEN_ACTION}, which takes a sign-in alone.`,
     `Otherwise a person logs this computer in once with ${LOGIN_SUBCOMMAND}, in a terminal of their own, then runs the deploy line again; a folder within the caps of the tool's deploy_files call deploys now through deploy_files, with no login. The credential file is ${CREDENTIAL_FILE_WORDS}.`,
-    `A tool sets ${MINTED_TOKEN_VARIABLE} for the deploy or check line alone and unsets it once that line ends, since the command cannot unset a variable of the shell that started it. A job's token is minted for the application, with an expiry. The variable's token wins over the credential file: the command makes the preparing call under that token, and sends the token in no other request.`,
+    `A tool sets ${MINTED_TOKEN_VARIABLE} for the deploy or check line alone and unsets it once that line ends, since the command cannot unset a variable of the shell that started it. A value a job's environment already supplies stays as it stands. A job's token is minted for the application, with an expiry. The variable's token wins over the credential file: the command makes the preparing call under that token, and sends the token in no other request.`,
     `Under the variable, the command sends its token only to the address ${ORIGIN_VARIABLE} holds, or to ${DEFAULT_COMMAND_ORIGIN} where that variable is unset: under the token, ${DEPLOY_OPTION.origin} may name that address alone, and where the line names none the command addresses it. ${DEPLOY_OPTION.env} names the environment where a line names one, ${COMMAND_ENVIRONMENTS.join(" or ")}; where none is named, the platform chooses, and the command deploys to the environment the platform answers.`,
     `A progress read answered 502, 503, or 504, which is often temporary, is made again, at most three more times, and an upload answered 503 credential_lookup_busy, which wrote nothing, is made again after the wait it names, at most twice.`,
     `After its zip line, ${DEPLOY_SUBCOMMAND} prints the folder's top-level entries the zip holds on one line, at most ten and then the count of the rest, and ${HASH_SUBCOMMAND} ${HASH_OPTION.list} names every file; no such line prints for a .zip file.`,
@@ -4511,7 +4511,8 @@ var npmEntryOf = (io2, nodePath) => npmEntryCandidatesOf(io2.env, nodePath).find
     return false;
   }
 }) ?? null;
-var npmStartOf = (viaShell = NPM_NEEDS_SHELL, entry = null, nodePath = process.execPath) => entry !== null ? { command: nodePath, args: [entry, "start"] } : viaShell ? { command: "npm start", args: [], shell: true } : { command: "npm", args: ["start"] };
+var npmStartOf = (viaShell = NPM_NEEDS_SHELL, entry = null, nodePath = process.execPath) => entry !== null ? { command: nodePath, args: [entry, ...START_ARGS] } : viaShell ? { command: ["npm", ...START_ARGS].join(" "), args: [], shell: true } : { command: "npm", args: START_ARGS };
+var START_ARGS = Object.freeze(["start", "--no-update-notifier"]);
 var npmRunOf = (words, viaShell = NPM_NEEDS_SHELL, entry = null, nodePath = process.execPath) => entry !== null ? { command: nodePath, args: [entry, ...words] } : viaShell ? { command: ["npm", ...words].join(" "), args: [], shell: true } : { command: "npm", args: words };
 var INTERRUPTED_ON_WINDOWS = 'The application has ended. cmd may ask "Terminate batch job (Y/N)?" next: either answer returns the prompt.';
 var afterInterruptLineOf = (ended, onWindows2 = NPM_NEEDS_SHELL) => onWindows2 && ended.interrupted === true ? INTERRUPTED_ON_WINDOWS : null;
@@ -5050,6 +5051,7 @@ var committedFilesOf = (copied, written) => {
   return `${files.slice(0, -1).join(", ")}${files.length > 2 ? "," : ""} and ${files[files.length - 1]}`;
 };
 var COPY_PACKAGES_CLAUSE = "copy the packages line into the application manifest's packages member at each submission; ";
+var KEEP_PACKAGES_CLAUSE = "the application manifest was written whole, so read it again before patching it, and carry its packages member over in any later rewrite; ";
 var installFailedSentence = (folder) => `npm install in ${folder} did not finish: the entry, its row, and the copy are written. Run npm install there again; running this line again takes the entry again whole.`;
 var LIBRARY_AFTER_OWN_ERROR = "the entry's folder, its manifest row, or the application's copy may stand in part, and running the line again replaces each whole";
 async function readTake(io2, options, userAgent, planOf, planeChecked = false) {
@@ -5183,7 +5185,7 @@ async function installTake(io2, root, plan, manifestText, application) {
   io2.print(`${packagesLineOf(packagesOf(manifestText))} ${packagesWhereOf(root, application)}`);
   if (!("written" in application) && application.unwritten === "write_failed") status = COMMAND_STATUS.failed;
   io2.print(
-    `next: commit ${committedFilesOf(plan !== null, "written" in application)}; ${"written" in application ? "" : COPY_PACKAGES_CLAUSE}and, where the project holds the registrar, pin the version in its instance file and run validate with kind library.`
+    `next: commit ${committedFilesOf(plan !== null, "written" in application)}; ${"written" in application ? KEEP_PACKAGES_CLAUSE : COPY_PACKAGES_CLAUSE}and, where the project holds the registrar, pin the version in its instance file and run validate with kind library.`
   );
   printAfterInterrupt(io2, afterInterrupt);
   return status;
@@ -5772,7 +5774,7 @@ var startUpgradeCheck = (io2, subcommand, named, running) => {
 };
 
 // src/turnzero_cloud_command/provision.ts
-import { basename as basename3 } from "node:path";
+import { basename as basename3, dirname as dirname5, join as join8 } from "node:path";
 var PROVISION_OPTIONS = Object.freeze([
   {
     name: PROVISION_OPTION.application,
@@ -5824,6 +5826,15 @@ var provisionOptionsOf = (call, cwd, stands = () => false) => {
   if (!environmentFileName(basename3(envFile))) return { refusal: envFileNameRefusalOf(stands(envFile)) };
   return { application, envFile, origin: origin.origin };
 };
+var APPLICATION_FOLDER_MARKS = Object.freeze(["package.json", "manifest.json"]);
+var outsideApplicationWarningOf = (folder) => `warning: ${folder} holds neither ${APPLICATION_FOLDER_MARKS[0]} nor ${APPLICATION_FOLDER_MARKS[1]}, so it may not be the application's folder, and the environment file was written there all the same. Where the application stands in another folder, move the file into that folder: a local run reads the environment file from the folder it runs in.`;
+var outsideApplicationFolder = (io2, envFile) => APPLICATION_FOLDER_MARKS.every((mark) => {
+  try {
+    return io2.stat(join8(dirname5(envFile), mark))?.folder !== false;
+  } catch {
+    return false;
+  }
+});
 var charactersOf = (value) => `<${value.length} characters>`;
 var transportText = (error) => {
   const oneLine2 = (text) => text.replace(/\s+/g, " ").trim();
@@ -6110,6 +6121,7 @@ async function remintAndWrite(io2, { application, envFile, origin }, userAgent,
     );
   }
   if (typeof platform.answer.detail === "string") io2.print(oneLine(platform.answer.detail));
+  if (outsideApplicationFolder(io2, envFile)) io2.print(outsideApplicationWarningOf(dirname5(envFile)));
   if (facts !== null && limitCarried !== null) {
     const cause = limitMember ? "the plan's database-connection-limit holds no usable quantity, which platform staff set with set_plan_quota" : "the platform that answered serves no such member yet";
     io2.print(
@@ -6146,7 +6158,7 @@ var PROVISION_ROW = Object.freeze({
 });
 
 // src/turnzero_cloud_command/scaffold.ts
-import { basename as basename4, dirname as dirname5, isAbsolute as isAbsolute5, join as join8, relative as relative5, resolve as resolve11 } from "node:path";
+import { basename as basename4, dirname as dirname6, isAbsolute as isAbsolute5, join as join9, relative as relative5, resolve as resolve11 } from "node:path";
 
 // src/turnzero_cloud_command/scaffold_template.ts
 var SCAFFOLD_TEMPLATE_FILES = Object.freeze({
@@ -7540,6 +7552,7 @@ var templatesDescribed = () => [
   `The template to write, one of ${andListed(SCAFFOLD_TEMPLATES)}, ${SCAFFOLD_DEFAULT_TEMPLATE} where absent.`,
   ...SCAFFOLD_TEMPLATES.map((template) => `The ${template} template is ${TEMPLATE_FACTS[template].is}.`)
 ].join(" ");
+var OTHER_TYPE_WAY_ON = "For a type outside these, name the nearest kind, then change the written migration and routes: the files are your service's own.";
 var SCAFFOLD_OPTIONS = Object.freeze([
   {
     name: SCAFFOLD_OPTION.template,
@@ -7563,7 +7576,7 @@ var SCAFFOLD_OPTIONS = Object.freeze([
     name: SCAFFOLD_OPTION.fields,
     value: "<list>",
     required: false,
-    description: `Under ${RESOURCE_TEMPLATES_NAMED}, the resource's columns: fields separated by commas, each a name, a colon, and a kind, such as "name:text,message:text", written between double quotes. A name is an ASCII lower-case letter, then ASCII lower-case letters, digits, and underscores, at most 30 characters. It is never a column the migration writes itself: ${perResourceTemplate((kept2) => kept2.columns)}. A kind is ${orListed(SCAFFOLD_FIELD_KINDS)}. Every column is required, and a list holds one to ${SCAFFOLD_FIELDS_MAX} fields. Where absent, the service keeps one text column, title. A template that keeps no resource refuses it.`
+    description: `Under ${RESOURCE_TEMPLATES_NAMED}, the resource's columns: fields separated by commas, each a name, a colon, and a kind, such as "name:text,message:text", written between double quotes. A name is an ASCII lower-case letter, then ASCII lower-case letters, digits, and underscores, at most 30 characters. It is never a column the migration writes itself: ${perResourceTemplate((kept2) => kept2.columns)}. A kind is ${orListed(SCAFFOLD_FIELD_KINDS)}. ${OTHER_TYPE_WAY_ON} Every column is required, and a list holds one to ${SCAFFOLD_FIELDS_MAX} fields. Where absent, the service keeps one text column, title. A template that keeps no resource refuses it.`
   },
   {
     name: SCAFFOLD_OPTION.path,
@@ -7645,8 +7658,9 @@ var FIELD_REFUSAL = Object.freeze({
   nameForm: `${SCAFFOLD_OPTION.fields} takes each field's name as an ASCII lower-case letter, then ASCII lower-case letters, digits, and underscores, at most 30 characters, such as due_date, and ${FIELD_KINDS_CLAUSE}. ${NOTHING_WRITTEN2}`,
   /** A name of SCAFFOLD_FIELD_RESERVED. */
   reservedName: reservedFieldRefusal(SCAFFOLD_FIELD_RESERVED),
-  /** A kind outside SCAFFOLD_FIELD_KINDS. */
-  kindUnknown: `${SCAFFOLD_OPTION.fields} takes each field's kind after its name and a colon, ${FIELD_KINDS_CLAUSE}, such as count:integer. ${NOTHING_WRITTEN2}`,
+  /** A kind outside SCAFFOLD_FIELD_KINDS, with the way on for another type
+   *  (#4572). */
+  kindUnknown: `${SCAFFOLD_OPTION.fields} takes each field's kind after its name and a colon, ${FIELD_KINDS_CLAUSE}, such as count:integer. ${OTHER_TYPE_WAY_ON} ${NOTHING_WRITTEN2}`,
   /** Two fields under one name. */
   duplicate: `${SCAFFOLD_OPTION.fields} takes each field's name once, and two fields of the list share a name, ${FIELD_KINDS_CLAUSE} after each: name each field once. ${NOTHING_WRITTEN2}`
 });
@@ -8047,18 +8061,18 @@ var ownStage = (io2, stage, files) => {
   const folders = new Set([...texts.keys()].flatMap((path) => path.split("/").slice(0, -1).map((_, index, segments) => segments.slice(0, index + 1).join("/"))));
   const own = (at, prefix) => (io2.listFolder(at) ?? []).every((name) => {
     const path = prefix === "" ? name : `${prefix}/${name}`;
-    const standing = io2.stat(join8(at, name));
+    const standing = io2.stat(join9(at, name));
     if (standing === null) return false;
-    if (standing.folder) return folders.has(path) && own(join8(at, name), path);
+    if (standing.folder) return folders.has(path) && own(join9(at, name), path);
     const text = texts.get(path);
-    return text !== void 0 && ownFile(io2, join8(at, name), standing.size, path, text);
+    return text !== void 0 && ownFile(io2, join9(at, name), standing.size, path, text);
   });
   return own(stage, "");
 };
-var danglingAt = (io2, folder, name) => io2.stat(join8(folder, name)) === null && (io2.listFolder(folder) ?? []).some((held) => held.toLowerCase() === name.toLowerCase() && io2.stat(join8(folder, held)) === null);
+var danglingAt = (io2, folder, name) => io2.stat(join9(folder, name)) === null && (io2.listFolder(folder) ?? []).some((held) => held.toLowerCase() === name.toLowerCase() && io2.stat(join9(folder, held)) === null);
 var standsAt = (io2, folder, name) => {
   try {
-    return io2.stat(join8(folder, name)) !== null || danglingAt(io2, folder, name);
+    return io2.stat(join9(folder, name)) !== null || danglingAt(io2, folder, name);
   } catch {
     return true;
   }
@@ -8081,16 +8095,16 @@ var applicationStandsLines = (template, takeLines) => {
 var STAGE_NOT_OWN = `Something that is not this run's own stands at ${STAGE_FOLDER} in the project's root, the name the scaffold writes under, an earlier run's files under another template or another resource name among it: move or remove ${STAGE_FOLDER}, then run the line again. ${NOTHING_WRITTEN2}`;
 var folderRefusalOf = (io2, options, files, takeLines) => {
   const { root } = options;
-  for (let at = root; ; at = dirname5(at)) {
+  for (let at = root; ; at = dirname6(at)) {
     const standing2 = io2.stat(at);
-    const what = standing2 !== null ? standing2.folder ? null : "a file" : danglingAt(io2, dirname5(at), basename4(at)) ? "a link whose target does not stand" : null;
+    const what = standing2 !== null ? standing2.folder ? null : "a file" : danglingAt(io2, dirname6(at), basename4(at)) ? "a link whose target does not stand" : null;
     if (what !== null) {
       return [`${options.named ? `${SCAFFOLD_OPTION.path} names ${what}, or a place under one` : `The folder the line runs in is ${what}, or stands under one`}, where the project's root stands or is made. ${NOTHING_WRITTEN2}`];
     }
-    if (standing2 !== null || dirname5(at) === at) break;
+    if (standing2 !== null || dirname6(at) === at) break;
   }
-  const app = join8(root, APPLICATION_FOLDER);
-  const stage = join8(root, STAGE_FOLDER);
+  const app = join9(root, APPLICATION_FOLDER);
+  const stage = join9(root, STAGE_FOLDER);
   const notOwn = STAGE_NOT_OWN;
   const standing = io2.stat(app);
   if (standing === null ? danglingAt(io2, root, APPLICATION_FOLDER) : !standing.folder) return [noFolderSentence(APPLICATION_FOLDER, "the scaffold writes the application")];
@@ -8198,8 +8212,8 @@ var nextStepLines = (origin, windows = LINES_IN_WINDOWS_FORM, left = NEITHER_LEF
 var writeTemplate = (io2, stage, app, files) => {
   io2.remove(stage);
   for (const [path, text] of files) {
-    const at = join8(stage, ...path.split("/"));
-    io2.makeFolder(dirname5(at));
+    const at = join9(stage, ...path.split("/"));
+    io2.makeFolder(dirname6(at));
     io2.writeFile(at, text);
   }
   const standing = io2.stat(app);
@@ -8211,7 +8225,7 @@ var writeTemplate = (io2, stage, app, files) => {
 };
 var writeRootSentence = (io2, root) => {
   try {
-    io2.writeNewFile(join8(root, TOOLS_FILE), `${ROOT_SENTENCE}
+    io2.writeNewFile(join9(root, TOOLS_FILE), `${ROOT_SENTENCE}
 `);
     return "written";
   } catch (error) {
@@ -8268,8 +8282,8 @@ async function scaffold(call, io2) {
   const { takes } = TEMPLATE_FACTS[template];
   const defaulted = call.named[SCAFFOLD_OPTION.template] === void 0;
   const files = writtenFilesOf(template, options.names, options.fields);
-  const app = join8(root, APPLICATION_FOLDER);
-  const stage = join8(root, STAGE_FOLDER);
+  const app = join9(root, APPLICATION_FOLDER);
+  const stage = join9(root, STAGE_FOLDER);
   const takeLines = takes.map((take) => machineLineOf(libraryTakeLineOf({ origin, entry: take.entry }), { windows: io2.windows ?? LINES_IN_WINDOWS_FORM, npx: ranThroughNpx(io2) }, origin));
   let reached = "checks";
   const stateNow = () => {
@@ -8298,7 +8312,7 @@ async function scaffold(call, io2) {
       held = found;
     } else {
       for (const take of takes) {
-        const copy = join8(app, "lib", take.entry);
+        const copy = join9(app, "lib", take.entry);
         const planOf = (library) => writesOver(library, copy) ? { refusal: LIBRARY_OVER_APPLICATION } : { application: app, copy, declared: null, declaredAt: null };
         const read2 = await readTake(io2, { entry: take.entry, root, named: options.named, origin }, agent.userAgent, planOf, checks.length > 0);
         if ("lines" in read2) return refuse(...read2.lines);

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "turnzero",
-  "version": "0.18.1",
+  "version": "0.18.2-next.1",
   "type": "module",
   "description": "The Turn Zero Cloud command, which an AI coding tool runs on your machine to deploy an application, store a secret, upload a file, download an export, take a library entry, write a local run's settings, start the application locally, and scaffold a new service from a template.",
   "license": "Apache-2.0",