@cargo-ai/cli 1.0.72 → 1.0.73

package/build/index.js

@@ -1,6 +1,6 @@
 #!/usr/bin/env node
 import { createRequire } from "node:module";
-import { BRAND, canRunPalette, declareSources, fetchCreditsLeft, fetchWorkspaceName, formatWorkspaceSuffix, printSetupIssues, registerCommands as registerCdkCommands, runPalette, SessionExpiredError, } from "@cargo-ai/cdk/cli";
+import { availableCodingAgents, BRAND, canRunPalette, cdkProjectRoot, declareSources, fetchCreditsLeft, fetchWorkspaceName, formatWorkspaceSuffix, isInteractive, printSetupIssues, registerCommands as registerCdkCommands, runPalette, SessionExpiredError, } from "@cargo-ai/cdk/cli";
 import { Command } from "commander";
 import { AGENT_SKILLS_HINT } from "./agentSkills.js";
 import { createApi } from "./api.js";
@@ -20,12 +20,15 @@ import { registerOrchestrationCommands } from "./commands/orchestration/index.js
 import { registerRevenueOrganizationCommands } from "./commands/revenueOrganization/index.js";
 import { ExitCodes, failWith } from "./commands/runHandler.js";
 import { registerSegmentationCommands } from "./commands/segmentation/index.js";
+import { registerStartCommand, runStart } from "./commands/start/index.js";
+import { loadStartState, shouldRunStart } from "./commands/start/state.js";
 import { registerStorageCommands } from "./commands/storage/index.js";
 import { registerSystemOfRecordIntegrationCommands } from "./commands/systemOfRecordIntegration/index.js";
 import { registerUserManagementCommands } from "./commands/userManagement/index.js";
 import { registerVersionCommand } from "./commands/version.js";
 import { registerWorkspaceManagementCommands } from "./commands/workspaceManagement/index.js";
 import { getConfig } from "./config.js";
+import { buildPaletteLayout } from "./paletteLayout.js";
 import { collectSetupIssues, isSignedIn } from "./setupIssues.js";
 import { cachedLatestVersion, maybeRefreshUpdateCache, } from "./updateNotifier.js";
 const require = createRequire(import.meta.url);
@@ -74,7 +77,15 @@ Run "cargo-ai <command> <subcommand> --help" for details on a subcommand.`);
 // Commands that are themselves the fix, or that already say all of this
 // better: the header would either duplicate their output or nag someone who is
 // mid-repair.
-const SETUP_HEADER_SKIP = ["login", "logout", "doctor", "version", "mcp"];
+const SETUP_HEADER_SKIP = [
+    "login",
+    "logout",
+    "start",
+    "onboard",
+    "doctor",
+    "version",
+    "mcp",
+];
 /**
  * Say what is wrong before the command runs rather than after it fails, and
  * name the fix. Every check behind this is a file read (see `setupIssues.ts`)
@@ -163,6 +174,11 @@ declareSources({
         { argv: ["segmentation", "segment", "list"], value: "uuid", label: "name" },
     ],
 });
+const binPath = process.argv[1] === undefined ? "cargo-ai" : process.argv[1];
+// First, so it is the first row of the palette: for someone signed in, this is
+// the shortest path to a briefed coding agent, and it was previously reachable
+// only by knowing the name of a command that sounds like a one-time thing.
+registerStartCommand(program, getApi, { binPath, openPalette });
 registerAuthCommands(program, getApi);
 registerVersionCommand(program, version);
 registerDoctorCommand(program, version);
@@ -190,17 +206,45 @@ registerCdkCommands(program
 // wall: twenty command groups is a list to navigate, not one to read. Anything
 // non-interactive (a pipe, CI, an agent) keeps the help it has always had.
 const bare = process.argv.slice(2).length === 0 && canRunPalette();
-const start = bare ? openPalette() : program.parseAsync();
-async function openPalette() {
+// ...except for someone who has never signed in, for whom that palette is
+// twenty groups that all exit 3. They get the entrance instead, once.
+const entrance = bare === true &&
+    shouldRunStart({
+        signedIn: isSignedIn(),
+        interactive: isInteractive(),
+        ranBefore: loadStartState() !== undefined,
+    });
+const start = bare === false
+    ? program.parseAsync()
+    : entrance === true
+        ? runStart(getApi, { binPath, openPalette }, {})
+        : openPalette();
+async function openPalette(startPath) {
     const [title, latestVersion] = await Promise.all([
         paletteTitle(),
         maybeRefreshUpdateCache(),
     ]);
+    // Probed once: this shells out to `which` per candidate agent, and nobody
+    // installs a coding agent from inside the palette.
+    const agents = availableCodingAgents();
+    const collectIssues = () => collectSetupIssues({ currentVersion: version, latestVersion });
+    // Re-read after each command: signing in or out from inside the palette
+    // changes both what the setup line says and which rows are worth pinning.
+    // The cwd is re-tested too — a command can create a project in it.
+    const rebuildLayout = () => buildPaletteLayout({
+        signedIn: isSignedIn(),
+        agents,
+        cdkProjectRoot: cdkProjectRoot(process.cwd()),
+    });
     await runPalette({
         program,
-        binPath: process.argv[1] === undefined ? "cargo-ai" : process.argv[1],
+        binPath,
+        startPath,
         title,
-        issues: collectSetupIssues({ currentVersion: version, latestVersion }),
+        issues: collectIssues(),
+        refreshIssues: collectIssues,
+        layout: rebuildLayout(),
+        refreshLayout: rebuildLayout,
     });
 }
 /**

package/build/paletteLayout.d.ts

@@ -0,0 +1,16 @@
+import type { CodingAgent, PaletteLayout, PinnedRow } from "@cargo-ai/cdk/cli";
+export type PaletteLayoutInput = {
+    signedIn: boolean;
+    agents: readonly CodingAgent[];
+    /** The CDK repo root the palette is standing in, or undefined when none. */
+    cdkProjectRoot: string | undefined;
+};
+export declare function buildPaletteLayout(input: PaletteLayoutInput): PaletteLayout;
+/**
+ * The rows above the rule. Signed out there is exactly one thing worth
+ * offering, and it is not a list of twenty command groups that all exit 3.
+ *
+ * Exported for tests; `buildPaletteLayout` is the only production caller.
+ */
+export declare function pinnedRows(input: PaletteLayoutInput): PinnedRow[];
+//# sourceMappingURL=paletteLayout.d.ts.map

package/build/paletteLayout.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"paletteLayout.d.ts","sourceRoot":"","sources":["../src/paletteLayout.ts"],"names":[],"mappings":"AAUA,OAAO,KAAK,EAAE,WAAW,EAAE,aAAa,EAAE,SAAS,EAAE,MAAM,mBAAmB,CAAC;AAsE/E,MAAM,MAAM,kBAAkB,GAAG;IAC/B,QAAQ,EAAE,OAAO,CAAC;IAClB,MAAM,EAAE,SAAS,WAAW,EAAE,CAAC;IAC/B,4EAA4E;IAC5E,cAAc,EAAE,MAAM,GAAG,SAAS,CAAC;CACpC,CAAC;AAEF,wBAAgB,kBAAkB,CAAC,KAAK,EAAE,kBAAkB,GAAG,aAAa,CAM3E;AAED;;;;;GAKG;AACH,wBAAgB,UAAU,CAAC,KAAK,EAAE,kBAAkB,GAAG,SAAS,EAAE,CA+CjE"}

package/build/paletteLayout.js

@@ -0,0 +1,131 @@
+// How the root menu is arranged: what is pinned above it, what it does not
+// draw, and the order of what is left.
+//
+// The palette derives its rows from commander's command tree, which knows
+// registration order and nothing else. That put `version` and `doctor` — twice
+// a year, both of them — above the whole product, and left the thing a person
+// most often wants, a coding agent briefed on their workspace, two screens
+// down behind `start`. This is the missing opinion, kept in one place and as
+// data, so it can be read and tested rather than inferred from a menu.
+/** Pinned row values. The leading space keeps them out of the command namespace. */
+const SIGN_IN = " sign-in";
+const DEMO = " demo";
+const CODE = " code";
+const ADD_COOKBOOK = " add-cookbook";
+/**
+ * `start` runs most of these; the pinned row is the shortcut to one of them.
+ * The exception is "Add a cookbook", which runs `cdk add` directly: it is not
+ * a `start` destination, because it needs neither the sign-in step nor a
+ * choice of where to carry on — you are already in the project.
+ */
+const ENTRANCE = "start";
+/**
+ * Root commands the menu does not draw. Each is still runnable, still in
+ * `--help`, and still reachable by name — they are simply not what somebody
+ * opening a menu is looking for.
+ *
+ * `start` is hidden because its destinations are pinned above: a row that
+ * opens a menu of rows already on screen is a detour. `version` is
+ * `--version`, and `doctor` reports it anyway.
+ */
+const HIDDEN = [ENTRANCE, "version"];
+/**
+ * The sections, in reading order: everything the workspace is made of, then
+ * the workspace as code on its own, then the machine you are sitting at —
+ * which ends beside `/exit`, since leaving and checking your setup are the
+ * same kind of errand. What people reach for most is not here at all; those
+ * are the pinned rows, above the first section.
+ *
+ * Anything a release adds and nobody lists here still appears, in tree order,
+ * in a final section — a new command is never invisible by omission. So a new
+ * command group belongs in whichever of these three it is part of, and needs
+ * no entry to be reachable.
+ */
+const SECTIONS = [
+    // Everything the workspace is: what you run, the data and connectors it runs
+    // on, the knowledge it reads, and the surfaces it exposes. One group, most
+    // used first — the divisions that used to be here were the CLI's own
+    // architecture showing through, which is not a distinction anybody browsing
+    // a menu is making.
+    [
+        "orchestration",
+        "storage",
+        "connection",
+        "segmentation",
+        "ai",
+        "context",
+        "content",
+        "hosting",
+        "mcp",
+        "mailboxManagement",
+        "workspaceManagement",
+        "billing",
+        "observability",
+        "revenue-organization",
+        "expression",
+        "user-management",
+        "system-of-record",
+    ],
+    // The workspace as code sits on its own: it is the same resources again,
+    // declared in a repo rather than run from here.
+    ["cdk"],
+    ["doctor", "whoami", "login", "logout"],
+];
+export function buildPaletteLayout(input) {
+    return {
+        pinned: pinnedRows(input),
+        hide: HIDDEN,
+        sections: SECTIONS,
+    };
+}
+/**
+ * The rows above the rule. Signed out there is exactly one thing worth
+ * offering, and it is not a list of twenty command groups that all exit 3.
+ *
+ * Exported for tests; `buildPaletteLayout` is the only production caller.
+ */
+export function pinnedRows(input) {
+    if (input.signedIn === false) {
+        return [
+            {
+                value: SIGN_IN,
+                label: "Sign in",
+                hint: "then pick where to carry on",
+                argv: [ENTRANCE],
+            },
+        ];
+    }
+    // Inside a CDK project, "Add a cookbook" is more useful than "Set up as
+    // code" — the project already exists. Outside, scaffold one.
+    const cdkRow = input.cdkProjectRoot !== undefined
+        ? {
+            value: ADD_COOKBOOK,
+            label: "Add a cookbook",
+            hint: "install a worked pipeline into this project",
+            // `--dir` because `cdk add` refuses a directory with no
+            // package.json, and the palette is as often open in `infra/` — where
+            // the scaffold's README sends people — as at the root.
+            argv: ["cdk", "add", "--dir", input.cdkProjectRoot],
+        }
+        : {
+            value: CODE,
+            label: "Set up as code",
+            hint: "scaffold a CDK project",
+            argv: [ENTRANCE, "--continue", "code"],
+        };
+    return [
+        ...input.agents.map((agent) => ({
+            value: ` agent:${agent.bin}`,
+            label: `Open ${agent.label}`,
+            hint: "briefed on this workspace",
+            argv: [ENTRANCE, "--continue", agent.bin],
+        })),
+        {
+            value: DEMO,
+            label: "Guided demo",
+            hint: "companies, then the people, for your ICP",
+            argv: [ENTRANCE, "--continue", "demo"],
+        },
+        cdkRow,
+    ];
+}

package/build/setupIssues.d.ts

@@ -1,8 +1,7 @@
-import type { SetupIssue } from "@cargo-ai/cdk/cli";
-export type SkillsPin = {
-    version: string;
-    path: string;
-};
+import type { SetupIssue, SkillsPin } from "@cargo-ai/cdk/cli";
+import { isSignedIn, readSkillsPin } from "@cargo-ai/cdk/cli";
+export type { SkillsPin };
+export { isSignedIn, readSkillsPin };
 export type SetupIssueInput = {
     currentVersion: string;
     /**
@@ -23,15 +22,4 @@ export type SetupIssueDeps = {
     readSkillsPin: () => SkillsPin | undefined;
 };
 export declare function collectSetupIssues(input: SetupIssueInput, deps?: SetupIssueDeps): SetupIssue[];
-/**
- * The CLI version the installed skills bundle was written against, from
- * whichever agent's skills directory holds one.
- */
-export declare function readSkillsPin(): SkillsPin | undefined;
-/**
- * Deliberately not `getConfig()`: that resolves the whole auth config and exits
- * the process on a workspace conflict, which a header printed before every
- * command must never do. Presence of a credential is all this line needs.
- */
-export declare function isSignedIn(): boolean;
 //# sourceMappingURL=setupIssues.d.ts.map

package/build/setupIssues.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"setupIssues.d.ts","sourceRoot":"","sources":["../src/setupIssues.ts"],"names":[],"mappings":"AAWA,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,mBAAmB,CAAC;AAWpD,MAAM,MAAM,SAAS,GAAG;IAAE,OAAO,EAAE,MAAM,CAAC;IAAC,IAAI,EAAE,MAAM,CAAA;CAAE,CAAC;AAE1D,MAAM,MAAM,eAAe,GAAG;IAC5B,cAAc,EAAE,MAAM,CAAC;IACvB;;;;;OAKG;IACH,aAAa,CAAC,EAAE,MAAM,CAAC;CACxB,CAAC;AAEF;;;;GAIG;AACH,MAAM,MAAM,cAAc,GAAG;IAC3B,UAAU,EAAE,MAAM,OAAO,CAAC;IAC1B,aAAa,EAAE,MAAM,SAAS,GAAG,SAAS,CAAC;CAC5C,CAAC;AAIF,wBAAgB,kBAAkB,CAChC,KAAK,EAAE,eAAe,EACtB,IAAI,GAAE,cAA4B,GACjC,UAAU,EAAE,CAyCd;AAED;;;GAGG;AACH,wBAAgB,aAAa,IAAI,SAAS,GAAG,SAAS,CAcrD;AAED;;;;GAIG;AACH,wBAAgB,UAAU,IAAI,OAAO,CAYpC"}
+{"version":3,"file":"setupIssues.d.ts","sourceRoot":"","sources":["../src/setupIssues.ts"],"names":[],"mappings":"AAOA,OAAO,KAAK,EAAE,UAAU,EAAE,SAAS,EAAE,MAAM,mBAAmB,CAAC;AAC/D,OAAO,EACL,UAAU,EACV,aAAa,EAEd,MAAM,mBAAmB,CAAC;AAM3B,YAAY,EAAE,SAAS,EAAE,CAAC;AAC1B,OAAO,EAAE,UAAU,EAAE,aAAa,EAAE,CAAC;AAErC,MAAM,MAAM,eAAe,GAAG;IAC5B,cAAc,EAAE,MAAM,CAAC;IACvB;;;;;OAKG;IACH,aAAa,CAAC,EAAE,MAAM,CAAC;CACxB,CAAC;AAEF;;;;GAIG;AACH,MAAM,MAAM,cAAc,GAAG;IAC3B,UAAU,EAAE,MAAM,OAAO,CAAC;IAC1B,aAAa,EAAE,MAAM,SAAS,GAAG,SAAS,CAAC;CAC5C,CAAC;AAIF,wBAAgB,kBAAkB,CAChC,KAAK,EAAE,eAAe,EACtB,IAAI,GAAE,cAA4B,GACjC,UAAU,EAAE,CAyCd"}

package/build/setupIssues.js

@@ -4,14 +4,10 @@
 // This runs before every command, so every check here is a small file read or
 // cheaper — no network. `cargo-ai doctor` is the same list with the online
 // checks added.
-import * as fs from "node:fs";
-import * as os from "node:os";
-import * as path from "node:path";
-import { loadCredentials } from "./credentials.js";
+import { isSignedIn, readSkillsPin, SKILLS_INSTALL_COMMAND, } from "@cargo-ai/cdk/cli";
 import { isOutdated, UPDATE_COMMAND } from "./version.js";
-const SEMVER_PATTERN = /^\d+\.\d+\.\d+$/;
-const SKILLS_UPDATE_COMMAND = "npx skills add getcargohq/cargo-skills";
 const LOGIN_COMMAND = "cargo-ai login --oauth";
+export { isSignedIn, readSkillsPin };
 const machineDeps = { isSignedIn, readSkillsPin };
 export function collectSetupIssues(input, deps = machineDeps) {
     const issues = [];
@@ -41,53 +37,8 @@ export function collectSetupIssues(input, deps = machineDeps) {
             label: `skills expect CLI ${pin.version}`,
             fix: isOutdated(input.currentVersion, pin.version) === true
                 ? UPDATE_COMMAND
-                : SKILLS_UPDATE_COMMAND,
+                : SKILLS_INSTALL_COMMAND,
         });
     }
     return issues;
 }
-/**
- * The CLI version the installed skills bundle was written against, from
- * whichever agent's skills directory holds one.
- */
-export function readSkillsPin() {
-    for (const candidate of skillsPinCandidates()) {
-        try {
-            const raw = fs.readFileSync(candidate, "utf8").trim();
-            if (SEMVER_PATTERN.test(raw)) {
-                return { version: raw, path: candidate };
-            }
-        }
-        catch {
-            // Missing or unreadable — try the next candidate.
-        }
-    }
-    return undefined;
-}
-/**
- * Deliberately not `getConfig()`: that resolves the whole auth config and exits
- * the process on a workspace conflict, which a header printed before every
- * command must never do. Presence of a credential is all this line needs.
- */
-export function isSignedIn() {
-    const token = process.env["CARGO_API_TOKEN"];
-    if (token !== undefined && token.trim() !== "") {
-        return true;
-    }
-    try {
-        return loadCredentials() !== undefined;
-    }
-    catch {
-        return false;
-    }
-}
-function skillsPinCandidates() {
-    const home = os.homedir();
-    const envDir = process.env["CARGO_SKILLS_DIR"];
-    const candidates = [];
-    if (envDir !== undefined && envDir.length > 0) {
-        candidates.push(path.join(envDir, "cargo", "cli-version"));
-    }
-    candidates.push(path.join(home, ".claude", "skills", "cargo", "cli-version"), path.join(home, ".claude", "plugins", "marketplaces", "cargo", "cargo", "cli-version"), path.join(home, ".openclaw", "skills", "cargo", "cli-version"));
-    return candidates;
-}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@cargo-ai/cli",
-  "version": "1.0.72",
+  "version": "1.0.73",
   "private": false,
   "license": "UNLICENSED",
   "homepage": "https://getcargo.ai",
@@ -64,9 +64,9 @@
     "format:check": "prettier --check ."
   },
   "dependencies": {
-    "@cargo-ai/api": "^1.0.69",
+    "@cargo-ai/api": "^1.0.70",
     "@cargo-ai/app-sdk": "^1.0.9",
-    "@cargo-ai/cdk": "^1.0.57",
+    "@cargo-ai/cdk": "^1.0.59",
     "@cargo-ai/types": "^1.0.66",
     "@cargo-ai/worker-sdk": "^1.0.17",
     "@modelcontextprotocol/sdk": "1.29.0",