@cargo-ai/cli 1.0.92 → 1.0.94

package/README.md

@@ -152,23 +152,23 @@ cargo-ai orchestration workflow --help
 
 ### Domains and example commands
 
-| Domain                   | Description                                                       | Example commands                                                                                                              |
-| ------------------------ | ----------------------------------------------------------------- | ----------------------------------------------------------------------------------------------------------------------------- |
-| **orchestration**        | Workflows, plays, runs, batches, tools, templates                 | `cargo-ai orchestration workflow list`, `cargo-ai orchestration run list --workflow-uuid <uuid>`                              |
-| **workspaceManagement**  | Workspaces, users, tokens, roles, folders                         | `cargo-ai workspaceManagement workspaces list`, `cargo-ai workspaceManagement token list`                                     |
-| **storage**              | Datasets, models, relationships, runs, records                    | `cargo-ai storage dataset list`, `cargo-ai storage model list`                                                                |
-| **connection**           | Connectors and integrations                                       | `cargo-ai connection connector list`, `cargo-ai connection integration list`                                                  |
-| **billing**              | Usage and subscription                                            | `cargo-ai billing subscription get`, `cargo-ai billing usage get-metrics --payload '{"from":"2025-01-01","to":"2025-01-31"}'` |
-| **segmentation**         | Segments and changes                                              | `cargo-ai segmentation segment list`, `cargo-ai segmentation change list --payload '{}'`                                      |
-| **revenue-organization** | Allocations, capacities, members, territories                     | `cargo-ai revenue-organization member list`, `cargo-ai revenue-organization territory list`                                   |
-| **expression**           | Recipes and expression evaluation                                 | `cargo-ai expression recipe list`, `cargo-ai expression eval evaluate --payload '{}'`                                         |
-| **system-of-record**     | System of record, client, logs                                    | `cargo-ai system-of-record sor list`, `cargo-ai system-of-record log list --payload '{}'`                                     |
-| **user-management**      | Current user (no workspace context)                               | `cargo-ai user-management user get-current`                                                                                   |
-| **ai**                   | AI templates, agents, releases, chats, MCP, files                 | `cargo-ai ai template list`, `cargo-ai ai agent list`, `cargo-ai ai file list`                                                |
-| **context**              | Context repository, runtime sandbox, and knowledge graph          | `cargo-ai context repository get`, `cargo-ai context runtime browse --path <path>`, `cargo-ai context graph get`              |
-| **hosting**              | Cargo Hosting apps (Vite SPAs), workers, and deployments          | `cargo-ai hosting app list`, `cargo-ai hosting worker list`, `cargo-ai hosting deployment list --payload '{}'`                |
-| **mailboxManagement**    | Owned sending mailboxes, threads, events, suppressions, pricing   | `cargo-ai mailboxManagement mailbox list`, `cargo-ai mailboxManagement mailbox get-send-allowance <uuid>`                     |
-| **cdk**                  | Declarative IaC: define resources in code, deploy, generate types | `cargo-ai cdk init <dir>`, `cargo-ai cdk types`, `cargo-ai cdk plan`, `cargo-ai cdk deploy`                                   |
+| Domain                   | Description                                                       | Example commands                                                                                                                |
+| ------------------------ | ----------------------------------------------------------------- | ------------------------------------------------------------------------------------------------------------------------------- |
+| **orchestration**        | Workflows, plays, runs, batches, tools, templates                 | `cargo-ai orchestration workflow list`, `cargo-ai orchestration run list --workflow-uuid <uuid>`                                |
+| **workspaceManagement**  | Workspaces, users, tokens, roles, folders                         | `cargo-ai workspaceManagement workspaces list`, `cargo-ai workspaceManagement token list`                                       |
+| **storage**              | Datasets, models, relationships, runs, records                    | `cargo-ai storage dataset list`, `cargo-ai storage model list`                                                                  |
+| **connection**           | Connectors and integrations                                       | `cargo-ai connection connector list`, `cargo-ai connection integration list`                                                    |
+| **billing**              | Usage and subscription                                            | `cargo-ai billing subscription get`, `cargo-ai billing usage get-metrics --payload '{"from":"2025-01-01","to":"2025-01-31"}'`   |
+| **segmentation**         | Segments and changes                                              | `cargo-ai segmentation segment list`, `cargo-ai segmentation change list --payload '{}'`                                        |
+| **revenue-organization** | Allocations, capacities, members, territories                     | `cargo-ai revenue-organization member list`, `cargo-ai revenue-organization territory list`                                     |
+| **expression**           | Recipes and expression evaluation                                 | `cargo-ai expression recipe list`, `cargo-ai expression eval evaluate --payload '{}'`                                           |
+| **system-of-record**     | System of record, client, logs                                    | `cargo-ai system-of-record sor list`, `cargo-ai system-of-record log list --payload '{}'`                                       |
+| **user-management**      | Current user (no workspace context)                               | `cargo-ai user-management user get-current`                                                                                     |
+| **ai**                   | AI templates, agents, releases, chats, MCP, files                 | `cargo-ai ai template list`, `cargo-ai ai agent list`, `cargo-ai ai file list`                                                  |
+| **context**              | Context repository, runtime sandbox, and knowledge graph          | `cargo-ai context repository get`, `cargo-ai context runtime browse --path <path>`, `cargo-ai context graph get`                |
+| **hosting**              | Cargo Hosting apps (Vite SPAs), workers, and deployments          | `cargo-ai hosting app list`, `cargo-ai hosting worker list`, `cargo-ai hosting deployment list --payload '{}'`                  |
+| **mailboxManagement**    | Owned sending mailboxes, threads, events, suppressions, pricing   | `cargo-ai mailboxManagement mailbox list`, `cargo-ai mailboxManagement mailbox get-send-allowance <uuid>`                       |
+| **project**              | Declarative IaC: define resources in code, deploy, generate types | `cargo-ai project init <dir>`, `cargo-ai project types`, `cargo-ai project plan`, `cargo-ai project deploy` (`cdk` is an alias) |
 
 Commands that accept complex payloads use a `--payload <json>` option (e.g. `cargo-ai orchestration play create --payload '{"name":"My Play",...}'`). Use `--help` on any subcommand for options.
 

package/build/commands/ask/slash.js

@@ -25,7 +25,7 @@ export function parseSlash(text) {
     if (trimmed.startsWith("/") === false) {
         return undefined;
     }
-    // A cookbook handoff launches Ask with `/cargo-cdk` then a multi-line brief.
+    // A cookbook handoff launches Ask with `/cargo-project` then a multi-line brief.
     // Chat commands are a single line (`/help`, `/exit`); anything with a
     // newline is prose for the model, including a skill command the harness
     // expands before the first turn.

package/build/commands/start/brief.js

@@ -171,7 +171,7 @@ export function formatStartNextSteps(facts) {
         "Next steps:",
         "  cargo-ai whoami                          # confirm the workspace",
         "  cargo-ai orchestration action list enrich  # find something to run",
-        "  cargo-ai cdk init                        # define this workspace in a repo",
+        "  cargo-ai project init                    # define this workspace in a repo",
         "  cargo-ai                                 # the command palette",
     ];
     if (facts.skillsInstalled === false) {

package/build/commands/start/index.d.ts

@@ -14,7 +14,7 @@ export type StartOptions = {
 };
 /** What the flow needs from the program it was registered on. */
 export type StartDeps = {
-    /** The script `cdk init` is re-run through — normally `process.argv[1]`. */
+    /** The script `project init` is re-run through — normally `process.argv[1]`. */
     binPath: string;
     /** Opens the command palette, part-way down the tree. */
     openPalette: (startPath: readonly string[]) => Promise<void>;

package/build/commands/start/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/commands/start/index.ts"],"names":[],"mappings":"AAgCA,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,WAAW,CAAC;AAGzC,OAAO,KAAK,EAAE,GAAG,EAAE,MAAM,cAAc,CAAC;AAcxC,OAAO,EAUL,KAAK,cAAc,EAGpB,MAAM,YAAY,CAAC;AAGpB,MAAM,MAAM,YAAY,GAAG;IACzB,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,KAAK,CAAC,EAAE,OAAO,CAAC;IAChB,aAAa,CAAC,EAAE,MAAM,CAAC;IACvB,aAAa,CAAC,EAAE,MAAM,CAAC;IACvB,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,GAAG,CAAC,EAAE,MAAM,CAAC;IACb,OAAO,CAAC,EAAE,MAAM,CAAC;CAClB,CAAC;AAEF,iEAAiE;AACjE,MAAM,MAAM,SAAS,GAAG;IACtB,4EAA4E;IAC5E,OAAO,EAAE,MAAM,CAAC;IAChB,yDAAyD;IACzD,WAAW,EAAE,CAAC,SAAS,EAAE,SAAS,MAAM,EAAE,KAAK,OAAO,CAAC,IAAI,CAAC,CAAC;CAC9D,CAAC;AAKF;;;;;;GAMG;AACH,wBAAgB,qBAAqB,CAAC,GAAG,EAAE,MAAM,GAAG,cAAc,CAiBjE;AAED,wBAAgB,oBAAoB,CAClC,OAAO,EAAE,OAAO,EAChB,MAAM,EAAE,MAAM,GAAG,EACjB,IAAI,EAAE,SAAS,GACd,IAAI,CAmDN;AAED,wBAAsB,QAAQ,CAC5B,MAAM,EAAE,MAAM,GAAG,EACjB,IAAI,EAAE,SAAS,EACf,IAAI,EAAE,YAAY,GACjB,OAAO,CAAC,IAAI,CAAC,CAmDf;AAqPD;;;;;;;;;;GAUG;AACH,wBAAgB,aAAa,CAAC,KAAK,EAAE,MAAM,EAAE,IAAI,EAAE,YAAY,GAAG,MAAM,CAkBvE"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/commands/start/index.ts"],"names":[],"mappings":"AAgCA,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,WAAW,CAAC;AAGzC,OAAO,KAAK,EAAE,GAAG,EAAE,MAAM,cAAc,CAAC;AAcxC,OAAO,EAUL,KAAK,cAAc,EAGpB,MAAM,YAAY,CAAC;AAGpB,MAAM,MAAM,YAAY,GAAG;IACzB,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,KAAK,CAAC,EAAE,OAAO,CAAC;IAChB,aAAa,CAAC,EAAE,MAAM,CAAC;IACvB,aAAa,CAAC,EAAE,MAAM,CAAC;IACvB,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,GAAG,CAAC,EAAE,MAAM,CAAC;IACb,OAAO,CAAC,EAAE,MAAM,CAAC;CAClB,CAAC;AAEF,iEAAiE;AACjE,MAAM,MAAM,SAAS,GAAG;IACtB,gFAAgF;IAChF,OAAO,EAAE,MAAM,CAAC;IAChB,yDAAyD;IACzD,WAAW,EAAE,CAAC,SAAS,EAAE,SAAS,MAAM,EAAE,KAAK,OAAO,CAAC,IAAI,CAAC,CAAC;CAC9D,CAAC;AAKF;;;;;;GAMG;AACH,wBAAgB,qBAAqB,CAAC,GAAG,EAAE,MAAM,GAAG,cAAc,CAiBjE;AAED,wBAAgB,oBAAoB,CAClC,OAAO,EAAE,OAAO,EAChB,MAAM,EAAE,MAAM,GAAG,EACjB,IAAI,EAAE,SAAS,GACd,IAAI,CAmDN;AAED,wBAAsB,QAAQ,CAC5B,MAAM,EAAE,MAAM,GAAG,EACjB,IAAI,EAAE,SAAS,EACf,IAAI,EAAE,YAAY,GACjB,OAAO,CAAC,IAAI,CAAC,CAmDf;AAqPD;;;;;;;;;;GAUG;AACH,wBAAgB,aAAa,CAAC,KAAK,EAAE,MAAM,EAAE,IAAI,EAAE,YAAY,GAAG,MAAM,CAkBvE"}

package/build/commands/start/index.js

@@ -7,7 +7,7 @@
 // down.
 //
 // Three steps and no more: sign in, land in a workspace, choose where to carry
-// on. Everything past that belongs to whatever you chose — `cdk init` asks its
+// on. Everything past that belongs to whatever you chose — `project init` asks its
 // own questions about a project, a coding agent asks its own about the work.
 // The flow writes nothing to disk except its own state.
 //
@@ -57,7 +57,7 @@ export function registerStartCommand(program, getApi, deps) {
         .option("--workspace-name <name>", "Workspace to use, created if it does not exist")
         .option("--workspace-uuid <uuid>", "Workspace to use")
         .option("--continue <where>", 'Where to continue: a coding agent ("claude", "cursor", "codex", "gemini"), "code" to set up a project, "cli" for the palette, "demo" for the guided tour, or "none"')
-        .option("--directory <path>", "Directory to scaffold into, for `--continue code`. Required when there is nobody to ask; supplying it also skips the project wizard, the way `cdk init <directory>` does")
+        .option("--directory <path>", "Directory to scaffold into, for `--continue code`. Required when there is nobody to ask; supplying it also skips the project wizard, the way `project init <directory>` does")
         .option("--icp <description>", "Who you sell to, used to brief the guided demo")
         .option("--base-url <url>", "Cargo API base URL")
         .addHelpText("after", `
@@ -83,7 +83,7 @@ export async function runStart(getApi, deps, opts) {
     // error, and finding it out after a browser sign-in is a poor way to learn.
     const supplied = opts.continue === undefined ? undefined : requireDestination(opts.continue);
     // Same reasoning, one step further. Scaffolding headless needs a directory,
-    // and `cdk init` cannot ask for one — so without this the run signs in,
+    // and `project init` cannot ask for one — so without this the run signs in,
     // saves its state, and *then* dies on a usage error from a child
     // process, having done everything except the thing it was asked to do.
     if (supplied !== undefined &&
@@ -166,7 +166,7 @@ async function go(destination, facts, deps, opts) {
     }
 }
 /**
- * The skill to load for a general agent handoff: `cargo-cdk` when inside a
+ * The skill to load for a general agent handoff: `cargo-project` when inside a
  * CDK project (the user is building infra as code), `cargo` (the router)
  * everywhere else.
  */
@@ -174,7 +174,7 @@ function agentSkill(project) {
     return project.kind === "none" ? ROUTER_SKILL : CDK_SKILL;
 }
 /**
- * Hand the whole project question to `cdk init`, which owns it: where the
+ * Hand the whole project question to `project init`, which owns it: where the
  * project goes, what it starts from, and the company questions worth asking
  * once there is a repo to write the answers into.
  *
@@ -188,12 +188,12 @@ function scaffoldProject(deps, opts) {
     // command line, which `--directory` is here to forward.
     const scaffold = spawnSync(process.execPath, [
         deps.binPath,
-        "cdk",
+        "project",
         "init",
         ...(opts.directory === undefined ? [] : [opts.directory]),
     ], { stdio: "inherit" });
     if (scaffold.error !== undefined) {
-        failWith(`Could not run \`cdk init\`: ${scaffold.error.message}`);
+        failWith(`Could not run \`project init\`: ${scaffold.error.message}`);
     }
     // The child has already said what went wrong on this terminal, so this
     // carries its code rather than adding a second message. A null status means

package/build/index.js

@@ -248,8 +248,13 @@ registerAiCommands(program, getApi);
 registerHostingCommands(program, getApi);
 registerMailboxManagementCommands(program, getApi);
 registerMcpCommand(program, getApi);
+// `cdk` is what this group was called for its first year, and it is still what
+// the npm package and the standalone bin are called. The alias keeps every
+// pasted command, script and older skill working; `project` is the name a
+// person who has never used the AWS CDK can guess.
 registerCdkCommands(program
-    .command("cdk")
+    .command("project")
+    .alias("cdk")
     .description("Define this workspace in a repo and deploy it (init/plan/deploy)"), getApi);
 // Bare `cargo-ai` in a terminal opens the palette instead of printing the help
 // wall: twenty command groups is a list to navigate, not one to read. Anything

package/build/paletteLayout.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"paletteLayout.d.ts","sourceRoot":"","sources":["../src/paletteLayout.ts"],"names":[],"mappings":"AAYA,OAAO,EAEL,KAAK,WAAW,EAChB,KAAK,aAAa,EAClB,KAAK,SAAS,EACf,MAAM,mBAAmB,CAAC;AA8E3B,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;IACnC;;;;OAIG;IACH,GAAG,EAAE,MAAM,CAAC;IACZ;;;OAGG;IACH,UAAU,CAAC,EAAE,OAAO,CAAC;CACtB,CAAC;AAEF,wBAAgB,kBAAkB,CAAC,KAAK,EAAE,kBAAkB,GAAG,aAAa,CAS3E;AAED;;;;;GAKG;AACH,wBAAgB,UAAU,CAAC,KAAK,EAAE,kBAAkB,GAAG,SAAS,EAAE,CA+DjE"}
+{"version":3,"file":"paletteLayout.d.ts","sourceRoot":"","sources":["../src/paletteLayout.ts"],"names":[],"mappings":"AAYA,OAAO,EAEL,KAAK,WAAW,EAChB,KAAK,aAAa,EAClB,KAAK,SAAS,EACf,MAAM,mBAAmB,CAAC;AA+E3B,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;IACnC;;;;OAIG;IACH,GAAG,EAAE,MAAM,CAAC;IACZ;;;OAGG;IACH,UAAU,CAAC,EAAE,OAAO,CAAC;CACtB,CAAC;AAEF,wBAAgB,kBAAkB,CAAC,KAAK,EAAE,kBAAkB,GAAG,aAAa,CAS3E;AAED;;;;;GAKG;AACH,wBAAgB,UAAU,CAAC,KAAK,EAAE,kBAAkB,GAAG,SAAS,EAAE,CA+DjE"}

package/build/paletteLayout.js

@@ -18,10 +18,11 @@ const DEPLOY = " deploy";
 const BOOK_DEMO = " book-demo";
 /**
  * `start` runs most of these; the pinned row is the shortcut to one of them.
- * The exceptions are "Add" and "Deploy", which run `cdk add` and `cdk deploy`
- * directly: neither is a `start` destination, because neither needs the sign-in
- * step nor a choice of where to carry on — you are already in the project. Bare
- * `cdk add` asks connector vs cookbook, then shows that kind's list. "Book a
+ * The exceptions are "Add" and "Deploy", which run `project add` and `project
+ * deploy` directly: neither is a `start` destination, because neither needs the
+ * sign-in step nor a choice of where to carry on — you are already in the
+ * project. Bare `project add` asks connector vs cookbook, then shows that
+ * kind's list. "Book a
  * demo" is the other exception: it is only pinned on an unpaid plan, and runs
  * `book-demo` itself.
  */
@@ -78,7 +79,7 @@ const SECTIONS = [
     ],
     // The workspace as code sits on its own: it is the same resources again,
     // declared in a repo rather than run from here.
-    ["cdk"],
+    ["project"],
     ["doctor", "whoami", "login", "logout", "book-demo"],
 ];
 export function buildPaletteLayout(input) {
@@ -162,10 +163,10 @@ function cdkRows(root, cwd) {
             value: ADD,
             label: "Add",
             hint: "a connector or a cookbook into this project",
-            // `--dir` because `cdk add` refuses a directory with no package.json,
+            // `--dir` because `project 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", root],
+            argv: ["project", "add", "--dir", root],
         },
         {
             value: DEPLOY,
@@ -180,7 +181,7 @@ function cdkRows(root, cwd) {
                 : `${basename(root)}/ to your workspace`,
             // No `--yes`: `deploy` shows the plan and asks, which is the point of
             // reaching it from a menu.
-            argv: ["cdk", "deploy", "--dir", root],
+            argv: ["project", "deploy", "--dir", root],
         },
     ];
 }

package/build/utils/cdkState.js

@@ -101,7 +101,7 @@ export function resolveTokensFromState(value, file, subject) {
         failWith(`${subject} references ${String(deps.size)} deployed resource(s) ` +
             `(${[...deps].join(", ")}), but no cargo.state.json was found near ` +
             `${absPath} or the current directory. Deploy the resources first with ` +
-            "`cargo-ai cdk deploy`, or reference them by literal uuid " +
+            "`cargo-ai project deploy`, or reference them by literal uuid " +
             "(toolRef / agentRef / connectorRef).", { code: ExitCodes.NotFound });
     }
     // A project whose state lives in the workspace has a pointer here, not a
@@ -120,7 +120,7 @@ export function resolveTokensFromState(value, file, subject) {
         failWith(`${String(missing.length)} resource(s) referenced by ${subject} ` +
             `aren't in this project's deploy state yet: ${missing.join(", ")}. A test run ` +
             "resolves existing (already-deployed) resources from state — it won't " +
-            "create new ones. Deploy them first with `cargo-ai cdk deploy`, or " +
+            "create new ones. Deploy them first with `cargo-ai project deploy`, or " +
             "reference them by literal uuid (toolRef / agentRef / connectorRef).", { code: ExitCodes.NotFound });
     }
     return resolveTokens(value, outputs);

package/build/utils/loadCompiledAgent.js

@@ -97,7 +97,7 @@ export async function loadCompiledAgent(file) {
     if (setUnsupported.length > 0) {
         failWith(`Agent "${handle.slug}" sets ${setUnsupported.join(", ")}, which a test ` +
             "message can't apply (they only take effect on a deployed release). " +
-            "Remove them for a test run, or deploy the agent with `cargo-ai cdk " +
+            "Remove them for a test run, or deploy the agent with `cargo-ai project " +
             "deploy` and chat against it by uuid.", { code: ExitCodes.InvalidUsage });
     }
     return compileAgent(node.spec);

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@cargo-ai/cli",
-  "version": "1.0.92",
+  "version": "1.0.94",
   "private": false,
   "license": "UNLICENSED",
   "homepage": "https://getcargo.ai",
@@ -69,8 +69,8 @@
     "@ai-sdk/harness-claude-code": "^1.0.99",
     "@cargo-ai/api": "^1.0.81",
     "@cargo-ai/app-sdk": "^1.0.10",
-    "@cargo-ai/cdk": "^1.0.78",
-    "@cargo-ai/types": "^1.0.77",
+    "@cargo-ai/cdk": "^1.0.80",
+    "@cargo-ai/types": "^1.0.78",
     "@cargo-ai/utils": "^1.0.30",
     "@cargo-ai/worker-sdk": "^1.0.17",
     "@modelcontextprotocol/sdk": "1.29.0",