@overaihq/cli 0.14.4 → 0.14.5

package/dist/index.js

@@ -27166,6 +27166,29 @@ import { hostname } from "os";
 
 // src/args.ts
 import { readFileSync as readFileSync2 } from "fs";
+var usageFor = (help, command2) => {
+  const out = [];
+  let inSection = false;
+  for (const line of help.split("\n")) {
+    const body = line.trimStart();
+    if (body.startsWith("overai "))
+      inSection = body === `overai ${command2}` || body.startsWith(`overai ${command2} `);
+    else if (line === body) inSection = false;
+    if (inSection) out.push(line);
+  }
+  return out.length === 0 ? "" : `${out.join("\n")}
+`;
+};
+var unknownFlags = (args, known, valueFlags = []) => {
+  const out = [];
+  for (let i = 0; i < args.length; i++) {
+    const arg = args[i];
+    if (arg == null || !arg.startsWith("-")) continue;
+    if (!known.includes(arg)) out.push(arg);
+    else if (valueFlags.includes(arg)) i++;
+  }
+  return out;
+};
 var flagValue = (args, ...names) => {
   for (const name2 of names) {
     const i = args.indexOf(name2);
@@ -34821,14 +34844,20 @@ var positionals = (args) => {
   }
   return out;
 };
+var pushMessage = (args) => {
+  const message = flagValue(args, "-m", "--message");
+  if (message == null || message.startsWith("-"))
+    throw new Error("Usage: overai push [filter] -m <message>. -m names the version this push creates.");
+  return message;
+};
 var runPush = async (args, clone) => {
   if (clone != null && args.includes("--deploy")) throw new Error("Recursive push cannot deploy.");
+  const message = pushMessage(args);
   const { root, manifest } = clone ?? openClone();
   let incomplete = false;
   const currentIds = clone == null ? null : new Set((await Promise.all(
     allAdapters.map((adapter) => adapter.fetchAll(manifest.workspaceId))
   )).flat().map((resource) => resource.id));
-  const message = flagValue(args, "-m", "--message") ?? "Pushed via overai CLI";
   const deploy = args.includes("--deploy");
   const force = args.includes("--force");
   const allowBreaking = args.includes("--allow-breaking");
@@ -36313,6 +36342,7 @@ var runDiff = async (args, clone) => {
 var runRecursiveSync = async (command2, args) => {
   if (command2 === "push" && args.includes("--deploy"))
     throw new Error("Recursive push saves versions only. Deploy from an individual workspace.");
+  if (command2 === "push") pushMessage(args);
   const origin = openClone();
   const local = /* @__PURE__ */ new Map([[origin.manifest.workspaceId, origin]]);
   const folders = [origin];
@@ -37896,13 +37926,44 @@ var withoutLeadingFlags = (argv) => {
   }
   return argv.slice(index);
 };
+var COMMAND_ALIASES = {
+  login: "signin",
+  logout: "signout",
+  ws: "workspace",
+  upgrade: "update"
+};
+var WRITE_COMMAND_FLAGS = /* @__PURE__ */ new Map([
+  ["pull", { flags: ["--recursive"] }],
+  [
+    "push",
+    {
+      flags: ["-m", "--message", "--deploy", "--force", "--allow-breaking", "--recursive"],
+      valueFlags: ["-m", "--message"]
+    }
+  ],
+  // --recursive stays listed for deploy and restore so the --recursive branch
+  // below can explain that they are single-workspace, instead of "unknown flag".
+  ["deploy", { flags: ["--all", "--allow-breaking", "--recursive"] }],
+  ["restore", { flags: ["--all", "--recursive"] }]
+]);
+var usageOrHelp = (command2) => usageFor(HELP, COMMAND_ALIASES[command2] ?? command2) || HELP;
 var run = async () => {
   const [command2, ...rest] = withoutLeadingFlags(process.argv.slice(2));
+  if (command2 != null && (rest.includes("--help") || rest.includes("-h"))) {
+    process.stdout.write(usageOrHelp(command2));
+    return;
+  }
   const misplaced = rest.find((arg) => LEADING_FLAGS.includes(arg));
   if (misplaced != null)
     throw new Error(
       `${misplaced} goes before the command: overai ${misplaced} <ref> ${command2 ?? "<command>"} ...`
     );
+  const writeFlags = command2 == null ? void 0 : WRITE_COMMAND_FLAGS.get(command2);
+  const unknown = writeFlags == null ? [] : unknownFlags(rest, writeFlags.flags, writeFlags.valueFlags);
+  if (unknown.length > 0)
+    throw new Error(
+      `Unknown flag ${unknown.join(", ")} for ${command2 ?? ""}. See: overai ${command2 ?? ""} --help`
+    );
   const orgFromFolder = command2 != null && !ORG_AGNOSTIC_COMMANDS.has(command2);
   if (orgFromFolder) pinOrgFromClone();
   if (requireExplicitOrg && command2 != null && !ORG_OPTIONAL_COMMANDS.has(command2) && orgScopeSource() === "saved default")
@@ -38059,8 +38120,10 @@ var run = async () => {
       process.stdout.write(`${cliVersion()}
 `);
       return;
-    case void 0:
     case "help":
+      process.stdout.write(rest[0] == null ? HELP : usageOrHelp(rest[0]));
+      return;
+    case void 0:
     case "--help":
     case "-h":
       process.stdout.write(HELP);

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@overaihq/cli",
-  "version": "0.14.4",
+  "version": "0.14.5",
   "description": "Create, edit, deploy, and run OverAI workspace resources from the command line",
   "type": "module",
   "homepage": "https://overai.com",