@deepraxis/cli 0.1.1-dev.61eb886 → 0.1.1-dev.660f2cc

package/dist/praxis.js

@@ -26104,15 +26104,31 @@ var workflows = [
   { words: ["whoami"], usage: "whoami", summary: "Show the signed-in identity and credential storage location." },
   { words: ["org", "list"], usage: "org list", summary: "List organizations available to the login." },
   { words: ["org", "switch"], usage: "org switch <organization_id>", summary: "Switch the login organization." },
-  { words: ["app", "create"], usage: "app create <name> [--dir <path>] [--template <dir>] [--no-install]", summary: "Create an application project from the standard template and install its dependencies." },
-  { words: ["app", "deploy"], usage: "app deploy [--dir <path>] [--no-build]", summary: "Build the project, publish it, create declared secrets, run the health check and print the URL." },
-  { words: ["app", "rollback"], usage: "app rollback [--dir <path>] [--to <version_id>]", summary: "Deploy the previous version again (or --to a given version) and wait until it is active." },
+  { words: ["app", "create"], usage: "app create <name> [--dir <path>] [--template <dir>] [--no-install]", summary: "Create an application project from the standard template and install its dependencies.", example: "praxis app create my-app" },
+  { words: ["app", "deploy"], usage: "app deploy [--dir <path>] [--no-build]", summary: "Build the project, publish it, create declared secrets, run the health check and print the URL.", example: "praxis app deploy --dir ./my-app" },
+  { words: ["app", "rollback"], usage: "app rollback [--dir <path>] [--to <version_id>]", summary: "Deploy the previous version again (or --to a given version) and wait until it is active.", example: "praxis app rollback --to <version_id>" },
   { words: ["skill"], usage: "skill [--install <dir>]", summary: "Print the AI skill, or write <dir>/praxis-cli/SKILL.md." }
 ];
 var workflowNouns = [...new Set(workflows.filter((w) => w.words.length > 1).map((w) => w.words[0]))];
 function nounHelp(noun) {
   const mine = workflows.filter((w) => w.words[0] === noun);
-  return [...mine.map((w) => `praxis ${w.usage}`), "", "Examples:", `  praxis ${mine[0].usage}`].join(`
+  const width = Math.max(...mine.map((w) => w.usage.length));
+  return [...mine.map((w) => `  praxis ${w.usage.padEnd(width)}  ${w.summary}`), "", `Run \`praxis ${noun} <command> --help\` for a command's options.`, "", "Examples:", ...mine.map((w) => `  ${w.example ?? `praxis ${w.usage}`}`)].join(`
+`);
+}
+function workflowHelp(workflow, options) {
+  return [
+    `praxis ${workflow.usage}`,
+    workflow.summary,
+    "",
+    "Options:",
+    ...[...options, ...globalOptions].map((s) => `  ${describeOption(s)}`),
+    "  -h is an alias of --help",
+    "PRAXIS_ENV=develop|production (default: develop); no --env option.",
+    "",
+    "Examples:",
+    `  ${workflow.example ?? `praxis ${workflow.usage}`}`
+  ].join(`
 `);
 }
 
@@ -26854,6 +26870,17 @@ var templateTag = (env) => env === "develop" ? "dev" : "latest";
 function randomSecret(bytes = 32) {
   return Buffer.from(crypto.getRandomValues(new Uint8Array(bytes))).toString("base64url");
 }
+function decideBuildOutput(mode) {
+  return mode === "human" ? "stream" : "capture";
+}
+function tailLines(text, count3) {
+  return text.replace(/\s+$/, "").split(`
+`).slice(-count3).join(`
+`);
+}
+function nextSteps(dir, bunAvailable) {
+  return [`cd ${dir}`, bunAvailable ? "bun run dev" : "npm run dev", "praxis app deploy"];
+}
 
 // src/commands/app.ts
 var REGISTRY = "https://registry.npmjs.org/@deepraxis%2fapp-template";
@@ -26921,13 +26948,13 @@ async function appCreate(args, env, ports) {
     if (code !== 0)
       throw new PraxisError({ code: "INSTALL_FAILED", message: `${pm} install failed (exit ${code}); the project was created in ${dir}. Run it again there.` });
   }
+  const next_steps = nextSteps(dir, ports.has("bun"));
   ports.human(`Created ${dir}
 
 Next steps:
-  cd ${dir}
-  ${ports.has("bun") ? "bun run dev" : "npm run dev"}
-  praxis app deploy`);
-  ports.emit({ kind: "object", data: { dir, name, template_version: version } });
+${next_steps.map((step) => `  ${step}`).join(`
+`)}`);
+  ports.emit({ kind: "object", data: { dir, name, template_version: version, next_steps } });
 }
 function findProjectDir(dir, cwd) {
   if (dir) {
@@ -27003,12 +27030,21 @@ async function healthCheck2(url, path, ports, timeoutMs = 60000) {
     await ports.wait(2000);
   }
 }
+async function runBuild(pm, dir, ports) {
+  if (decideBuildOutput(ports.mode) === "stream")
+    return ports.spawn(pm, ["run", "build"], { cwd: dir });
+  const started = ports.now();
+  const { code, output } = await ports.spawnCapture(pm, ["run", "build"], { cwd: dir });
+  const text = code === 0 ? `build ok in ${Math.round((ports.now() - started) / 100) / 10}s` : tailLines(output, 60);
+  ports.emit({ kind: "message", channel: "stderr", text });
+  return code;
+}
 async function appDeploy(args, client2, ports) {
   const dir = findProjectDir(args.dir, ports.cwd);
   const project = loadProject(dir);
   if (args.build) {
     const pm = ports.has("bun") ? "bun" : "npm";
-    const code = await ports.spawn(pm, ["run", "build"], { cwd: dir });
+    const code = await runBuild(pm, dir, ports);
     if (code !== 0)
       throw new PraxisError({ code: "BUILD_FAILED", message: `${pm} run build failed (exit ${code})` });
   }
@@ -27224,6 +27260,21 @@ function plain(value) {
 ` || c === "\r" || c === "\t" ? " " : "");
 }
 
+// src/output/list-columns.ts
+function workerStatus(item) {
+  const row = record(item), status = record(row.praxis).status;
+  if (typeof status !== "string")
+    return item;
+  return { ...row, status };
+}
+var listProjections = {
+  "application.workers.list": workerStatus
+};
+function projectList(items, op) {
+  const project = op ? listProjections[op] : undefined;
+  return project ? items.map(project) : items;
+}
+
 // src/output/human.ts
 var count3 = (n, noun) => `${n} ${noun}${n === 1 ? "" : "s"}`;
 function identity(result, ctx) {
@@ -27292,7 +27343,7 @@ function table(items, ctx, paint) {
     const text = truncate(v, sizes[i]);
     let styled = header ? paint.dim(text) : text;
     if (!header && ["status", "state"].includes(columns[i])) {
-      const color = /^(running|active|ready|succeeded|completed|enabled)$/i.test(v) ? paint.green : /^(pending|queued|starting|creating|paused)$/i.test(v) ? paint.yellow : /^(failed|error|cancelled|expired|disabled)$/i.test(v) ? paint.red : (s) => s;
+      const color = /^(running|active|ready|succeeded|completed|enabled)$/i.test(v) ? paint.green : /^(pending|queued|starting|creating|paused)$/i.test(v) ? paint.yellow : /^(failed|error|cancelled|expired|disabled|deleted|purging|purged|suspended)$/i.test(v) ? paint.red : (s) => s;
       styled = color(text);
     }
     return styled + (i === row.length - 1 ? "" : " ".repeat(Math.max(0, sizes[i] - width(text))));
@@ -27352,7 +27403,7 @@ function renderHuman(result, ctx) {
 ` : "") };
     case "list":
       return {
-        stdout: result.items.length ? table(result.items, ctx, out) : out.dim(`No ${plain(resource)}${/(s|x|ch|sh)$/.test(resource) ? "es" : "s"}.`) + `
+        stdout: result.items.length ? table(projectList(result.items, result.op), ctx, out) : out.dim(`No ${plain(resource)}${/(s|x|ch|sh)$/.test(resource) ? "es" : "s"}.`) + `
 `,
         stderr: err.dim(`${result.total !== undefined ? `${result.items.length} of ${result.total} items` : count3(result.items.length, "item")}${result.nextCursor ? ` · next: ${ctx.nextCommand ?? "praxis --help"}` : ""}`) + `
 `
@@ -27424,8 +27475,8 @@ ${usage ? `usage: ${JSON.stringify(usage)}
       return { stdout, stderr };
     }
     case "list": {
-      const columns = columnsFor(result.items);
-      const lines = columns.length ? ["|" + columns.map(cell).join("|") + "|", "|" + columns.map(() => "---").join("|") + "|", ...result.items.map((item) => "|" + columns.map((key) => cell(timestamp(key, record(item)[key]) ?? scalar(record(item)[key]))).join("|") + "|")] : [];
+      const items = projectList(result.items, result.op), columns = columnsFor(items);
+      const lines = columns.length ? ["|" + columns.map(cell).join("|") + "|", "|" + columns.map(() => "---").join("|") + "|", ...items.map((item) => "|" + columns.map((key) => cell(timestamp(key, record(item)[key]) ?? scalar(record(item)[key]))).join("|") + "|")] : [];
       lines.push(result.total !== undefined ? `${result.items.length} of ${result.total} rows; more: \`${ctx.moreCommand ?? "praxis --help"}\`` : `${result.items.length} rows; ${result.nextCursor ? `more: \`${ctx.nextCommand ?? "praxis --help"}\`` : "end"}`);
       return { stdout: lines.join(`
 `) + `
@@ -27634,7 +27685,7 @@ function startProgress(ctx, write = (text) => writeOutput({ stderr: text })) {
 }
 
 // src/main.ts
-var version = "0.1.1-dev.61eb886";
+var version = "0.1.1-dev.660f2cc";
 var commands = commandTree(operations);
 var manual = [...workflows.map((w) => w.words), [API_WORD]];
 function route(argv) {
@@ -27705,13 +27756,21 @@ var defaults = {
     child.once("error", reject);
     child.once("close", (code) => resolve2(code ?? 1));
   }),
+  spawnCapture: (cmd, args, options) => new Promise((resolve2, reject) => {
+    const child = spawn2(cmd, args, { cwd: options.cwd, stdio: ["ignore", "pipe", "pipe"] });
+    const chunks = [];
+    child.stdout.on("data", (c) => chunks.push(c));
+    child.stderr.on("data", (c) => chunks.push(c));
+    child.once("error", reject);
+    child.once("close", (code) => resolve2({ code: code ?? 1, output: Buffer.concat(chunks).toString("utf8") }));
+  }),
   has: (bin) => spawnSync(process.platform === "win32" ? "where" : "which", [bin], { stdio: "ignore" }).status === 0,
   cwd: process.cwd()
 };
 var appOptions = {
-  "app create": [{ name: "dir", type: "string" }, { name: "template", type: "string" }, { name: "no-install", type: "boolean" }],
-  "app deploy": [{ name: "dir", type: "string" }, { name: "no-build", type: "boolean" }],
-  "app rollback": [{ name: "dir", type: "string" }, { name: "to", type: "string" }]
+  "app create": [{ name: "dir", type: "string", description: "Directory to create the project in (default: ./<name>)." }, { name: "template", type: "string", description: "Copy a local template directory instead of downloading the standard template." }, { name: "no-install", type: "boolean", description: "Skip installing dependencies." }],
+  "app deploy": [{ name: "dir", type: "string", description: "Project directory (default: the nearest parent containing praxis.jsonc)." }, { name: "no-build", type: "boolean", description: "Publish the existing dist/ output without building." }],
+  "app rollback": [{ name: "dir", type: "string", description: "Project directory (default: the nearest parent containing praxis.jsonc)." }, { name: "to", type: "string", description: "Version id to deploy (default: the previous version)." }]
 };
 async function main(argv, injected = {}) {
   const ports = { ...defaults, ...injected };
@@ -27780,6 +27839,11 @@ async function main(argv, injected = {}) {
 Print the AI skill or write <dir>/praxis-cli/SKILL.md.` });
       return 0;
     }
+    const workflow = workflows.find((w) => w.example && w.words.join(" ") === selected.words.join(" "));
+    if (flags.help && workflow) {
+      emit({ kind: "message", channel: "stdout", text: workflowHelp(workflow, appOptions[workflow.words.join(" ")] ?? []) });
+      return 0;
+    }
     if (flags.help) {
       emit({ kind: "message", channel: "stdout", text: selected.command ? help(commands, selected.words, selected.command) : `praxis ${selected.words.join(" ")}${selected.words[0] === "api" ? " <METHOD> <path> [--data JSON|@file|-]" : selected.words[1] === "switch" ? " <organization_id>" : ""}
 ${globalOptions.map((s) => "--" + s.name).join(" ")}
@@ -27906,7 +27970,7 @@ Examples:
         emit({ kind: "object", data: await auth.switchOrganization(parsed.positional[0]) });
         break;
       case "app create": {
-        const appPorts = { ...ports, emit, human: (text) => {
+        const appPorts = { ...ports, mode: ctx.mode, emit, human: (text) => {
           if (ctx.mode === "human")
             emit({ kind: "message", channel: "stdout", text });
         }, random: randomSecret };
@@ -27915,7 +27979,7 @@ Examples:
       }
       case "app deploy":
       case "app rollback": {
-        const appPorts = { ...ports, emit, human: () => {}, random: randomSecret };
+        const appPorts = { ...ports, mode: ctx.mode, emit, human: () => {}, random: randomSecret };
         const client2 = await auth.client(org);
         const dir = parsed.flags.dir?.[0];
         if (name === "app deploy")

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@deepraxis/cli",
-  "version": "0.1.1-dev.61eb886",
+  "version": "0.1.1-dev.660f2cc",
   "type": "module",
   "bin": {
     "praxis": "dist/praxis.js"